公开记录中等
软件健康报告模式 0.26.0 · 指标 1.13.0 · 2026-07-22 03:25 UTC
lumduan / settfex
Fetch real-time and historical data from the Stock Exchange of Thailand (SET) and Thailand Futures Exchange (TFEX)
lumduan/settfex 的健康指数为 100 分中的 61 分，处于「中等」区间。 其得分最高的类别是Engineering Quality（85/100），最低的是Community & Adoption（43/100）。 最近一次更新在 1 天前。 近期的大部分工作由 1 位贡献者完成。
61
总分 / 100软件健康指数
指标归入加权类别，统一采用 1–100 量表。总体分先取类别加权平均；当公开证据触发高风险司法辖区政策时，评级会按政策调整，并设置 49（有风险）的上限。AI 就绪度不计入总体分。
61
优秀85-100堪称典范；基本满足所有检验标准
良好70-84健康；仅有轻微不足
中等50-69可接受，但存在明显不足；建议进行审查
存在风险30-49存在重大薄弱环节；采用时应保持审慎
危急1-29问题严重（项目被弃置、仅有单一维护者、缺乏基本工程规范）
评分画像
每条轴代表一个类别。形状比平均值更重要——健康的对象会填满整个图形，而“一峰一谷”式画像意味着某一维度的优势正掩盖另一维度的风险。
所有权
软件包生态系统
| 注册表 | 软件包 | 版本 | 月下载量 | 版本数 | 最近发布 | 标签 |
|---|---|---|---|---|---|---|
| PyPI | settfex | 0.14.0 | - | 16 | 1 天前 | apiasyncexchangefinancefuturesmarket-datasetstocktfexthai-stocksthailandtrading |
按类别列示的指标
活力
项目是否仍有生命——是否仍在编写代码，是否仍在发布版本？
76
开发活跃度
67中等
评分方式
| 36/36 | 推送新近度 — 最近一次推送于 1 天前 |
| 2.8/36 | 提交节奏 — 52 周中有 4 周有提交 |
| 18/18 | 提交量 — 最近一年 160 次提交 |
| 10/10 | OpenSSF Scorecard：Maintained — 30 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 10 |
所用输入
| commits_last_year | 160 |
| human_commit_share | 1 |
| days_since_last_push | 1 |
| active_weeks_last_year | 4 |
发布纪律
90优秀
评分方式
| 27/27 | 有发布版本 — 已发布 16 个发布版本 |
| 36/36 | 发布时效 — 最近一次发布版本于 1 天前 |
| 27/27 | 发布节奏 — 约每 3.5 天发布一次 |
| 0/10 | OpenSSF Scorecard：Signed-Releases — Project has not signed or included provenance with any releases. |
所用输入
| releases_count | 16 |
| latest_release_tag | v0.14.0 |
| releases_from_tags | 否 |
| days_since_latest_release | 1 |
| mean_days_between_releases | 3.5 |
社区与采用
项目是否拥有用户、下载量与关注度，并具备欢迎贡献者参与的配置？
43
流行度与采用
1危急
评分方式
| 0/60 | 星标 — 0 个星标 |
| 0/25 | 复刻 — 1 个复刻 |
| 0/15 | 关注者 — 0 位关注者 |
所用输入
| forks | 1 |
| stars | 0 |
| watchers | 0 |
| growth_state | unverified |
| growth_factor_pct | 100 |
| growth_unverified_reason | no_history |
社区健康
92优秀
评分方式
| 22.5/22.5 | README |
| 22.5/22.5 | 许可证 — 可识别的许可证（MIT） |
| 18/18 | CONTRIBUTING 指南 |
| 13.5/13.5 | 行为准则 |
| 0/7.2 | 议题模板 |
| 6.3/6.3 | PR 模板 |
所用输入
| has_readme | 是 |
| has_license | 是 |
| has_contributing | 是 |
| has_issue_template | 否 |
| has_code_of_conduct | 是 |
| has_pull_request_template | 是 |
可持续性与治理
项目能否在其成员之外延续——巴士系数、响应能力、由谁支持，以及软件包的维护状况？
51
维护者韧性（巴士系数）
13危急
评分方式
| 9/54 | 巴士系数 — 1 位贡献者贡献了半数提交 |
| 0/22.5 | 提交分布 — 头号贡献者编写了 100% 的提交 |
| 1.4/13.5 | 贡献者广度 — 1 位贡献者 |
| 3/10 | OpenSSF Scorecard：Contributors — project has 1 contributing companies or organizations -- score normalized to 3 |
所用输入
| bus_factor | 1 |
| contributors_sampled | 1 |
| top_contributor_share | 1 |
议题与 PR 响应能力
55中等
评分方式
| 0/46.8 | 议题解决 — 没有议题或无数据 |
| 29.1/38.3 | PR 接受 — 已裁定的 PR 中 57/75 已合并 |
| 0/15 | OpenSSF Scorecard：Code-Review — Found 0/13 approved changesets -- score normalized to 0 |
所用输入
| merged_prs | 57 |
| open_issues | 0 |
| closed_issues | 0 |
| issue_closed_ratio | — |
| closed_unmerged_prs | 18 |
已排除计分（无数据或不适用）：议题解决。 其余权重已重新归一化。
所有权与托管责任
53中等
评分方式
| 10/30 | 所有权背书 — 个人（用户）账户 |
| 0/20 | 已验证域名 — 不适用于个人账户 |
| 7.2/25 | 所有者影响力 — lumduan 有 9 位关注者 |
| 25/25 | 既往记录 — 72 个公开仓库，账户约 10 年 |
所用输入
| followers | 9 |
| owner_type | User |
| is_verified | — |
| owner_login | lumduan |
| public_repos | 72 |
| account_age_days | 3,919 |
已排除计分（无数据或不适用）：已验证域名。 其余权重已重新归一化。
软件包维护
100优秀
评分方式
| 25/25 | 已发布且可解析 — pypi 上有 1 个软件包 |
| 35/35 | 发布时效 — 最近一次发布于 1 天前 |
| 20/20 | 版本历史 — 16 个已发布版本 |
| 20/20 | 未被弃用 — 活跃，未被弃用或撤回 |
所用输入
| packages | settfex |
| ecosystems | pypi |
| any_deprecated | 否 |
| min_days_since_publish | 1 |
工程质量
基础的工程与文档实践是否到位？
85
工程实践
92优秀
评分方式
| 24/24 | CI 工作流 — 3 个工作流 |
| 24/24 | 存在测试 |
| 16/16 | Linter 配置 |
| 9.6/9.6 | Pre-commit 钩子 |
| 6.4/6.4 | .editorconfig |
| 12/20 | OpenSSF Scorecard：CI-Tests — 8 out of 13 merged PRs checked by a CI test -- score normalized to 6 |
所用输入
| has_ci | 是 |
| has_tests | 是 |
| has_editorconfig | 是 |
| has_linter_config | 是 |
| has_precommit_config | 是 |
文档
75良好
评分方式
| 30/30 | README |
| 25/25 | 文档目录 |
| 0/15 | 文档 / 主页站点 |
| 10/10 | 仓库描述 |
| 0/10 | 主题标签 |
| 10/10 | Wiki |
所用输入
| topics | — |
| has_wiki | 是 |
| homepage | — |
| has_readme | 是 |
| has_docs_dir | 是 |
| has_description | 是 |
安全
可见的安全与供应链实践是否稳固，且不存在未解决的高风险司法辖区暴露？
47
安全态势
47存在风险
评分方式
| 7.5/7.5 | Binary-Artifacts — no binaries found in the repo |
| 2.2/7.5 | Branch-Protection — branch protection is not maximal on development and all release branches |
| 1.5/2.5 | CI-Tests — 8 out of 13 merged PRs checked by a CI test -- score normalized to 6 |
| 0/2.5 | CII-Best-Practices — no effort to earn an OpenSSF best practices badge detected |
| 0/7.5 | Code-Review — Found 0/13 approved changesets -- score normalized to 0 |
| 0.8/2.5 | Contributors — project has 1 contributing companies or organizations -- score normalized to 3 |
| 10/10 | Dangerous-Workflow — no dangerous workflow patterns detected |
| 7.5/7.5 | Dependency-Update-Tool — update tool detected |
| 0/5 | Fuzzing — project is not fuzzed |
| 2.5/2.5 | 许可证 — license file detected |
| 7.5/7.5 | Maintained — 30 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 10 |
| 5/5 | Packaging — packaging workflow detected |
| 0/5 | Pinned-Dependencies — dependency not pinned by hash detected -- score normalized to 0 |
| 0/5 | SAST — SAST tool is not run on all commits -- score normalized to 0 |
| 5/5 | Security-Policy — security policy file detected |
| 0/7.5 | Signed-Releases — Project has not signed or included provenance with any releases. |
| 0/7.5 | Token-Permissions — detected GitHub workflow tokens with excessive permissions |
| 0/7.5 | Vulnerabilities — 75 existing vulnerabilities detected |
所用输入
| source | openssf_scorecard |
| checks_evaluated | 18 |
| scorecard_version | v5.5.0 |
| checks_inconclusive | 0 |
| scorecard_aggregate | 4.7 |
AI 就绪度
该仓库在多大程度上具备与 AI 编码代理协同开发与维护的条件？这是一枚独立的实验性徽章——权重为 0.0，因此单独呈现，不影响总体健康评分。
71
AI 代理上下文与指引
85优秀
评分方式
| 45/45 | 代理指令 — .github/instructions/core-architectrual-principles.instructions.md, .github/instructions/documentation-standards.instructions.md, .github/instructions/file-organization.instructions.md, .github/instructions/git-commit.instructions.md, .github/instructions/python-dependency-management.instructions.md, CLAUDE.md |
| 0/15 | 机器可读文档（llms.txt） |
| 40/40 | 可读的提交历史 — 100 次人类提交中有 99 次说明了意图（结构化标题或解释性正文） |
所用输入
| has_llms_txt | 否 |
| legible_history_share | 0.99 |
| agent_instruction_files | .github/instructions/core-architectrual-principles.instructions.md, .github/instructions/documentation-standards.instructions.md, .github/instructions/file-organization.instructions.md, .github/instructions/git-commit.instructions.md, .github/instructions/python-dependency-management.instructions.md, CLAUDE.md |
| agent_instruction_max_bytes | 20,891 |
评分方式
| 0/18 | 一条命令的引导启动 |
| 22/22 | 自动化测试 |
| 11/11 | Lint / 格式化配置 |
| 11/11 | 静态类型检查 — settfex/py.typed |
| 10/10 | 可复现环境 — lockfile |
| 10/10 | 已体现的代理实践 — 最近 100 次提交中有 59 次由代理编写或署名代理 |
| 5/8 | 自动化维护 — 已配置依赖自动化，但在抽样提交中未观察到 |
| 0/10 | OpenSSF Scorecard：Pinned-Dependencies — dependency not pinned by hash detected -- score normalized to 0 |
所用输入
| has_nix | 否 |
| has_tests | 是 |
| lockfiles | uv.lock |
| has_dockerfile | 否 |
| typed_language | 否 |
| bootstrap_files | — |
| has_devcontainer | 否 |
| has_linter_config | 是 |
| typecheck_configs | settfex/py.typed |
| agent_commit_share | 0.59 |
| toolchain_manifests | — |
| dependency_bot_commit_share | 0 |
面向模型的代码可读性
82良好
评分方式
| 27/45 | 可类型检查的代码 — Python，已配置类型检查（settfex/py.typed） |
| 55/55 | 可控的文件大小 — 采样的 100 个源文件中有 0 个超过 60KB |
所用输入
| primary_language | Python |
| largest_source_bytes | 47,064 |
| source_files_sampled | 100 |
| oversized_source_files | 0 |
机器可读接口
40存在风险
评分方式
| 0/40 | API 模式（OpenAPI/GraphQL/proto） |
| 0/20 | MCP 服务器 |
| 40/40 | 可运行示例 — examples, notebooks |
所用输入
| example_dirs | examples, notebooks |
| has_mcp_signal | 否 |
| api_schema_files | — |
关键数据
0GitHub 星标
1贡献者
160最近 12 个月提交数
1距最近推送天数
16发布版本数
1巴士系数（bus factor）
0开放议题
PyPI软件包生态系统数
数据采集警告
- GitHub dependency-graph SBOM unavailable (404); the dependency graph may be disabled for this repository
- deps.dev does not index pypi:settfex@0.14.0; advisories assessed against the repository dependency graph instead
更多细节
OpenSSF Scorecard 4.7 / 10
4.7综合
来自开源项目 OpenSSF Scorecard 的独立、工具无关的安全评估。每项检查奖励的是安全实践本身，而非特定供应商的工具。Scorecard 无法判定的检查项标记为 不适用，并从安全评分中剔除（绝不按零分计）。
| 10 | Binary-Artifacts | no binaries found in the repo |
| 3 | Branch-Protection | branch protection is not maximal on development and all release branches |
| 6 | CI-Tests | 8 out of 13 merged PRs checked by a CI test -- score normalized to 6 |
| 0 | CII-Best-Practices | no effort to earn an OpenSSF best practices badge detected |
| 0 | Code-Review | Found 0/13 approved changesets -- score normalized to 0 |
| 3 | Contributors | project has 1 contributing companies or organizations -- score normalized to 3 |
| 10 | Dangerous-Workflow | no dangerous workflow patterns detected |
| 10 | Dependency-Update-Tool | update tool detected |
| 0 | Fuzzing | project is not fuzzed |
| 10 | License | license file detected |
| 10 | Maintained | 30 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 10 |
| 10 | Packaging | packaging workflow detected |
| 0 | Pinned-Dependencies | dependency not pinned by hash detected -- score normalized to 0 |
| 0 | SAST | SAST tool is not run on all commits -- score normalized to 0 |
| 10 | Security-Policy | security policy file detected |
| 0 | Signed-Releases | Project has not signed or included provenance with any releases. |
| 0 | Token-Permissions | detected GitHub workflow tokens with excessive permissions |
| 0 | Vulnerabilities | 75 existing vulnerabilities detected |
直接依赖 4
| 注册表 | 软件包 | 版本约束 | 清单文件 |
|---|---|---|---|
| PyPI | curl-cffi | >=0.6.0 | pyproject.toml |
| PyPI | pydantic | >=2.0.0 | pyproject.toml |
| PyPI | loguru | >=0.7.0 | pyproject.toml |
| PyPI | diskcache | >=5.6.0 | pyproject.toml |
全部依赖 未采集
本报告未能采集到解析后的依赖集合：GitHub dependency-graph SBOM unavailable (404); the dependency graph may be disabled for this repository
原始 JSON 报告 机器可读
{
"data": {
"repo": {
"topics": [],
"is_fork": false,
"size_kb": 2092,
"has_wiki": true,
"homepage": null,
"languages": {
"Python": 788304
},
"pushed_at": "2026-07-20T19:17:01Z",
"created_at": "2025-10-01T07:20:10Z",
"owner_type": "User",
"updated_at": "2026-07-20T15:16:55Z",
"description": "Fetch real-time and historical data from the Stock Exchange of Thailand (SET) and Thailand Futures Exchange (TFEX)",
"is_archived": false,
"is_disabled": false,
"license_spdx": "MIT",
"default_branch": "main",
"license_spdx_raw": "MIT",
"primary_language": "Python",
"significant_languages": [
"Python"
]
},
"owner": {
"blog": "https://lumduan.github.io",
"name": "Sarat Sonsuk",
"type": "User",
"login": "lumduan",
"company": "Candythink",
"location": "Bangkok, Thailand",
"followers": 9,
"avatar_url": "https://avatars.githubusercontent.com/u/15356949?v=4",
"created_at": "2015-10-28T06:59:18Z",
"is_verified": null,
"public_repos": 72,
"account_age_days": 3919
},
"license": {
"state": "standard",
"spdx_id": "MIT",
"raw_spdx": "MIT",
"file_present": true,
"scorecard_found": true,
"profile_has_license": true
},
"activity": {
"releases": [
{
"tag": "v0.14.0",
"kind": "minor",
"published_at": "2026-07-20T15:14:50Z"
},
{
"tag": "v0.13.0",
"kind": "minor",
"published_at": "2026-07-20T14:19:57Z"
},
{
"tag": "v0.11.0",
"kind": "minor",
"published_at": "2026-07-19T23:28:52Z"
},
{
"tag": "v0.10.1",
"kind": "patch",
"published_at": "2026-07-18T16:06:41Z"
},
{
"tag": "v0.10.0",
"kind": "minor",
"published_at": "2026-07-17T08:08:12Z"
},
{
"tag": "v0.8.0",
"kind": "minor",
"published_at": "2026-07-16T08:06:12Z"
},
{
"tag": "v0.7.1",
"kind": "patch",
"published_at": "2026-06-21T02:46:01Z"
},
{
"tag": "v0.7.0",
"kind": "minor",
"published_at": "2026-06-21T02:22:17Z"
},
{
"tag": "v0.6.0",
"kind": "minor",
"published_at": "2026-06-19T07:44:11Z"
},
{
"tag": "v0.5.0",
"kind": "minor",
"published_at": "2026-06-19T07:17:36Z"
},
{
"tag": "v0.4.1",
"kind": "patch",
"published_at": "2026-06-19T06:28:23Z"
},
{
"tag": "v0.4.0",
"kind": "minor",
"published_at": "2026-06-19T06:01:15Z"
},
{
"tag": "v0.3.0",
"kind": "minor",
"published_at": "2026-06-17T14:32:39Z"
},
{
"tag": "v0.2.1",
"kind": "patch",
"published_at": "2026-06-17T07:57:32Z"
},
{
"tag": "v0.2.0",
"kind": "minor",
"published_at": "2026-06-09T14:07:50Z"
},
{
"tag": "v0.1.0",
"kind": "minor",
"published_at": "2025-10-06T02:50:44Z"
}
],
"recent_commits": [
{
"oid": "b8c5a0ba5937e70554fb5790c4b3e732fa3aa77e",
"body": "feat(sec): harden document downloads — timeout, concurrency, dedupe, memory (0.14.0)",
"is_bot": false,
"headline": "Merge pull request #75 from lumduan/feat/sec-download-hardening",
"author_name": "Sarat Sonsuk",
"author_login": "lumduan",
"committed_at": "2026-07-20T15:13:04Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "68c047bbadd23dc08ca3f9425e6b15fe04ef6902",
"body": "…memory (0.14.0)\n\nFixes large-file \"download all\" timeouts (curl 28) reported for Form 56-1/56-2\nOne Reports (15-25 MB), and two issues a live 18-year stress test surfaced.\n\n- Default per-file timeout 30s -> 180s (DEFAULT_DOWNLOAD_TIMEOUT); new `timeout=`\n param on download_sec_document(s)/Document\n[…]\nbytes held\n286 MB -> 0, no timeouts at defaults. Adds 9 tests (525 total); ruff + mypy clean;\ndoc tuning table + notebook updated.\n\nCo-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>",
"is_bot": false,
"headline": "feat(sec): harden document downloads — timeout, concurrency, dedupe, …",
"author_name": "batt",
"author_login": "lumduan",
"committed_at": "2026-07-20T15:10:07Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "276eedf4dcdc67d86bff3268b6bffafd18ed9609",
"body": "feat(sec): SecDocumentList — list available years + easy bulk download (0.13.0)",
"is_bot": false,
"headline": "Merge pull request #74 from lumduan/feat/sec-document-list-helpers",
"author_name": "Sarat Sonsuk",
"author_login": "lumduan",
"committed_at": "2026-07-20T13:36:36Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "00112f11709a2428672f292bd7012b4809be89f1",
"body": "…d (0.13.0)\n\nThe SEC listing calls (get_sec_documents, FinancialReportService.fetch_documents,\nSecCompany.list_documents) now return a SecDocumentList — a list[SecDocument]\nsubclass (backward compatible: it IS a list) with helpers that answer two common\nquestions:\n\n- \"which years are available?\" -> \n[…]\nttfex.services.sec and the top-level settfex namespace.\nAdds 10 tests (516 total), ruff + mypy clean, live-verified against CPALL.\n\nCo-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>",
"is_bot": false,
"headline": "feat(sec): SecDocumentList — list available years + easy bulk downloa…",
"author_name": "batt",
"author_login": "lumduan",
"committed_at": "2026-07-20T13:27:42Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "8eec311f3112e0e2922988729bf37f7d37d9dc94",
"body": "feat(sec): SEC IDISC document service — list & download raw disclosures (0.12.0)",
"is_bot": false,
"headline": "Merge pull request #73 from lumduan/feat/sec-idisc-document-service",
"author_name": "Sarat Sonsuk",
"author_login": "lumduan",
"committed_at": "2026-07-20T12:33:44Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "bfd0ddbba5627cd3e045edcd5b3df8ea69126d4a",
"body": "Satisfies the repo-wide `ruff format --check .` CI gate. Formats the new SEC\nservice files, their tests, and the two example notebooks. The 16_news.ipynb\nchange is a pre-existing formatting gap the whole-repo check flags — included\nhere so CI is green. No behavior change; 506 tests pass, mypy clean.\n\nCo-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>",
"is_bot": false,
"headline": "style: apply ruff format (SEC package, tests, notebooks)",
"author_name": "batt",
"author_login": "lumduan",
"committed_at": "2026-07-20T12:29:30Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "74c31f1bb6dddc51680ce96cbe9abea1cab806c0",
"body": "…osures (0.12.0)\n\nNew settfex.services.sec package targeting market.sec.or.th (Thai SEC IDISC),\nto list and download the RAW disclosure documents companies file — the original\nFINANCIAL_STATEMENTS.XLSX package, Form 56-1, Form 56-2, Key Financial Ratio,\nand MD&A — for any SET/mai-listed issuer.\n\nThr\n[…]\n doc,\nand reconciles CLAUDE.md / README.md / CHANGELOG. 506 tests pass, ruff + mypy\nclean, live-verified end-to-end against CPALL.\n\nCo-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>",
"is_bot": false,
"headline": "feat(sec): add SEC IDISC document service — list & download raw discl…",
"author_name": "batt",
"author_login": "lumduan",
"committed_at": "2026-07-20T12:26:05Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "4cf0395b8c3f2ff5c90f7436e7975dd7a6d69b12",
"body": "docs(news): document rolling 5-year history limit & historical queries",
"is_bot": false,
"headline": "Merge pull request #72 from lumduan/docs/news-doc-historical",
"author_name": "Sarat Sonsuk",
"author_login": "lumduan",
"committed_at": "2026-07-20T06:41:26Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "87210299c7dce6f9fc4af2e5ae46f76cc3a49934",
"body": "Updates docs/settfex/services/set/news.md to cover historical news and\nthe endpoint's rolling ~5-year (1826-day) history window:\n\n- gotchas callout bumped Two -> Three; adds #3 (1826-day limit, from_date\n is what's checked, over-old -> FetchError not InvalidDateError, no clipping,\n rolling boundar\n[…]\nteError (malformed, local) vs FetchError\n (too-old, HTTP 400)\n- fetch_news note + API Endpoint spec note the 1826-day lower bound\n\nCo-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>",
"is_bot": false,
"headline": "docs(news): document rolling 5-year history limit & historical queries",
"author_name": "batt",
"author_login": "lumduan",
"committed_at": "2026-07-20T06:41:06Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "2cb64eeb389629279c22b367f04917cdb5dcae8a",
"body": "docs(news): add historical-news notebook example (§11, rolling 5-year window)",
"is_bot": false,
"headline": "Merge pull request #71 from lumduan/docs/news-notebook-historical",
"author_name": "Sarat Sonsuk",
"author_login": "lumduan",
"committed_at": "2026-07-20T05:10:45Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "83f7611b757f6cfadb022e4b665e4d7bddab224b",
"body": "Adds Section 11 to examples/set/16_news.ipynb demonstrating historical\nnews queries and the rolling ~5-year (1826-day) history limit:\n\n- fetch a historical window ~1 year back (count + earliest/latest + headlines)\n- boundary demo: today-1826d is served, today-1827d raises FetchError (HTTP 400)\n\nBoth cells were run against the live API to confirm they work. No saved\noutputs (matches the notebook's convention).\n\nCo-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>",
"is_bot": false,
"headline": "docs(news): add historical-news notebook example (§11, 5-year window)",
"author_name": "batt",
"author_login": "lumduan",
"committed_at": "2026-07-20T05:02:03Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "e69119d5b7ae7bd2b192c710a725d334b2b83b5f",
"body": "docs(news): note rolling ~5-year (1826-day) news history limit",
"is_bot": false,
"headline": "Merge pull request #70 from lumduan/docs/news-history-5yr-gotcha",
"author_name": "Sarat Sonsuk",
"author_login": "lumduan",
"committed_at": "2026-07-20T04:51:38Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "e51f635436c1ae70a3607dde67518ab2c43a936d",
"body": "Live-probed 2026-07-20: /api/set/news/search serves only the trailing\n1826 days (= 5 calendar years incl. leap day). A from_date older than\ntoday-1826d is rejected with HTTP 400 (surfaced as FetchError, not\nInvalidDateError); the check is on the window start and does not clip to\nthe allowed range. Documented as a Known Gotcha.\n\nCo-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>",
"is_bot": false,
"headline": "docs(news): note rolling ~5-year (1826-day) news history limit",
"author_name": "batt",
"author_login": "lumduan",
"committed_at": "2026-07-20T04:50:47Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "3c8e878b02e31d98113b1c1b2e1f0bbe4f5d8c5e",
"body": "chore(gitignore): ignore local tmp/ scratch dir",
"is_bot": false,
"headline": "Merge pull request #69 from lumduan/chore/gitignore-tmp",
"author_name": "Sarat Sonsuk",
"author_login": "lumduan",
"committed_at": "2026-07-19T23:36:30Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "10db739608c6b1be7f00e126da39ca5989f96c94",
"body": "…d cookies/tokens)\n\ntmp/ was sitting untracked in git status; it holds local scratch such as HAR\ncaptures, which can embed session cookies/tokens and must never be committable.\n\nCo-Authored-By: Claude Fable 5 <noreply@anthropic.com>",
"is_bot": false,
"headline": "chore(gitignore): ignore local tmp/ scratch dir (HAR captures may hol…",
"author_name": "batt",
"author_login": "lumduan",
"committed_at": "2026-07-19T23:31:53Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "266729f715027ca30c4b16131ccd152d3edd7c0b",
"body": "feat(set): News service — company news/disclosures for all stocks (0.11.0)",
"is_bot": false,
"headline": "Merge pull request #68 from lumduan/feat/set-news-service",
"author_name": "Sarat Sonsuk",
"author_login": "lumduan",
"committed_at": "2026-07-19T23:27:12Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "6d29d7eae236dba309c5b2a75d6b90e494bed9ab",
"body": "… (0.11.0)\n\n- New settfex/services/set/news.py: get_news() / NewsService.fetch_news() /\n fetch_news_raw() over GET /api/set/news/search; filters: symbol,\n from_date/to_date (dd/MM/yyyy only — eager InvalidDateError on ISO strings),\n keyword, source_id (None = all sources; unverified values warned\n[…]\nng-price was missing — totals now 19 services / 19 notebooks)\n- Version 0.11.0 (pyproject.toml + settfex/__init__.py + uv.lock); CHANGELOG entry\n\nCo-Authored-By: Claude Fable 5 <noreply@anthropic.com>",
"is_bot": false,
"headline": "feat(set): add News service — company news/disclosures for all stocks…",
"author_name": "batt",
"author_login": "lumduan",
"committed_at": "2026-07-19T15:57:34Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "455b082a519986865743ed783559069afded6bee",
"body": "…t-date\n\nfix(set): tolerate null management startDate in company profile (0.10.1)",
"is_bot": false,
"headline": "Merge pull request #67 from lumduan/fix/profile-company-nullable-star…",
"author_name": "Sarat Sonsuk",
"author_login": "lumduan",
"committed_at": "2026-07-18T16:05:00Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "0ba6282ca9a8d3c9c73a3607b36bdc607f2d1fc7",
"body": "SET reports a vacant/undisclosed executive seat with \"startDate\": null and\nan empty name (e.g. VIBE's top finance-responsibility position), so\nfetch_company_profile() raised a pydantic ValidationError on such symbols.\nManagement.start_date is now datetime | None, matching the nullable-datetime\nconve\n[…]\nthe service's first test suite (mocked; fixture taken from the real\nVIBE payload), guards the docs example, records the gotcha, bumps to 0.10.1.\n\nCo-Authored-By: Claude Fable 5 <noreply@anthropic.com>",
"is_bot": false,
"headline": "fix(set): tolerate null management startDate in company profile (0.10.1)",
"author_name": "batt",
"author_login": "lumduan",
"committed_at": "2026-07-18T16:02:53Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "0d3aaa83f8d849d7f195cf9dc103b40e0bf8c18b",
"body": "chore(mypy): type-check tests/ for real errors instead of ignoring them",
"is_bot": false,
"headline": "Merge pull request #66 from lumduan/chore/type-tests-and-scripts",
"author_name": "Sarat Sonsuk",
"author_login": "lumduan",
"committed_at": "2026-07-17T14:12:52Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "33cbcc8d93ddc32fd4d2dd7bf42a219dc1ea36d6",
"body": "tests/ were `ignore_errors = true`, so mypy checked NOTHING in them — including real type\nbugs. Turn that off and instead relax only the annotation-boilerplate rules\n(disallow_untyped_defs / disallow_incomplete_defs / disallow_untyped_calls), so tests are\nchecked for genuine errors without requiring\n[…]\nored) scripts/; both are no-ops in CI.\n\n`uv run mypy .` now covers settfex/ + tests/ and passes clean (83 files on a CI checkout).\n\nCo-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>",
"is_bot": false,
"headline": "chore(mypy): type-check tests/ for real errors instead of ignoring them",
"author_name": "batt",
"author_login": "lumduan",
"committed_at": "2026-07-17T13:23:05Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "0bc3b5a4549b0ab6958552cf20d649f68a633b69",
"body": "docs: reference 0.10.0 typed exceptions + \"did you mean?\" suggestion",
"is_bot": false,
"headline": "Merge pull request #65 from lumduan/docs/typed-exceptions-0.10.0",
"author_name": "Sarat Sonsuk",
"author_login": "lumduan",
"committed_at": "2026-07-17T09:55:07Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "1064b331f87e1bb3f1c7cacc30c2f3aa9f30aa6e",
"body": "The docs pin no settfex version (unpinned install + dynamic PyPI badge + CHANGELOG pointer\nalready reflect 0.10.0), but the service docs still described the pre-0.9 generic Exception\nmodel. Update the user-facing error-handling docs to the current typed exceptions.\n\n- README: new \"Error Handling\" se\n[…]\ning the 0.10.0 network-free suggestion + suggest_symbol().\n\nVerified all doc-referenced symbols/attributes resolve against 0.10.0.\n\nCo-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>",
"is_bot": false,
"headline": "docs: reference 0.10.0 typed exceptions + \"did you mean?\" suggestion",
"author_name": "batt",
"author_login": "lumduan",
"committed_at": "2026-07-17T08:43:33Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "dd43a32f2ea709ecec5c0613f7e691d2fb97b055",
"body": "feat(exceptions): network-free \"did you mean?\" suggestion on SymbolNotFoundError (0.10.0)",
"is_bot": false,
"headline": "Merge pull request #64 from lumduan/feat/symbol-not-found-suggestion",
"author_name": "Sarat Sonsuk",
"author_login": "lumduan",
"committed_at": "2026-07-17T07:26:50Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "c5bebfc8a4441525ed6c0f4b75649af238608d54",
"body": "…tFoundError (0.10.0)\n\nA mistyped SET stock symbol now carries a .suggestion (closest known symbol via stdlib\ndifflib), appended to the error message and readable programmatically. Computed only from\nthe stock list already fetched this session (get_stock_list) — a 404 never triggers an extra\nfetch; \n[…]\n.\n\nBump 0.9.0 -> 0.10.0 (MINOR: new backward-compatible public API — .suggestion, suggest_symbol,\nraise_for_status suggest param).\n\nCo-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>",
"is_bot": false,
"headline": "feat(exceptions): network-free \"did you mean?\" suggestion on SymbolNo…",
"author_name": "batt",
"author_login": "lumduan",
"committed_at": "2026-07-17T07:10:57Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "b4a36106603fc9c62b2fad13efd15fcb41876525",
"body": "…lity\n\nDocs consistency + AI-agent consumability; typed exceptions + Literal typing (0.9.0)",
"is_bot": false,
"headline": "Merge pull request #63 from lumduan/docs/doc-consistency-ai-consumabi…",
"author_name": "Sarat Sonsuk",
"author_login": "lumduan",
"committed_at": "2026-07-17T06:34:26Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "e4fe2a864dcaa8fafd85f50aa6906c3cd87173ec",
"body": "…\"] typing (0.9.0)\n\nApplies the exception + Literal proposals catalogued (report-only) in 0.8.0, as\nnon-breaking runtime changes.\n\nExceptions (new settfex/exceptions.py, re-exported from top-level settfex):\n- FetchError(Exception) carrying status_code/symbol; SymbolNotFoundError(FetchError) for\n HT\n[…]\nfied: ruff / mypy . / pytest (384 passed) all green; uv build ships settfex/py.typed\nand settfex/exceptions.py in the 0.9.0 wheel.\n\nCo-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>",
"is_bot": false,
"headline": "feat(exceptions,typing): typed exception hierarchy + Literal[\"en\",\"th…",
"author_name": "batt",
"author_login": "lumduan",
"committed_at": "2026-07-17T05:34:06Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "fc945c8d79537e8a1971d900a3211b661c50e21a",
"body": "…ationale, drop dead MANIFEST.in\n\n- settfex/__init__.py: add a condensed 3-tier (get_*/fetch_*/fetch_*_raw) LLM\n tool-calling rationale to the package docstring, so 'import settfex; help(settfex)'\n conveys the mental model with no network access\n- earnings_call.py: add Args/Returns/Raises to the 5\n[…]\n the package itself is mypy-clean\n- uv.lock: sync the local settfex entry 0.7.1 -> 0.8.0 (lockfile drift from the\n 0.8.0 release)\n\nCo-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>",
"is_bot": false,
"headline": "docs(api): complete earnings-call wrapper docstrings, add LLM-tiers r…",
"author_name": "batt",
"author_login": "lumduan",
"committed_at": "2026-07-17T04:17:28Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "0bb38824cf5f6b2bf7a6b39ec52405f500318888",
"body": "CLAUDE.md:\n- Add step 6 to 'Adding a New Service' (root cause: update CLAUDE.md +\n CHANGELOG.md) so the Services Inventory / tree / changelog stop drifting\n- Replace the parallel 'Recent Change History' with a pointer to CHANGELOG.md\n (the canonical, complete history) — removes the duplicate sourc\n[…]\n canonical example\n (latest-price convenience + raw series)\n- Switch Contributing steps to uv (uv sync / uv run pytest|ruff|mypy)\n\nCo-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>",
"is_bot": false,
"headline": "docs: fix CLAUDE.md/README drift; collapse changelog to CHANGELOG.md",
"author_name": "batt",
"author_login": "lumduan",
"committed_at": "2026-07-17T04:11:11Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "a328e4151277650ad85b46adda95d9a1a3865471",
"body": "…ilerplate)\n\nThe file was 240 lines of boilerplate copy-pasted from a LINE API project\n(line_api/ references, LineMessagingClient examples, empty settfex sections,\na leftover Copilot <SYSTEM> prompt). Nothing in the repo referenced it.\nRemoving it eliminates a misleading, duplicate source of truth vs CLAUDE.md.\n\nCo-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>",
"is_bot": false,
"headline": "chore: remove stale copilot-instructions.md (unreferenced LINE-API bo…",
"author_name": "batt",
"author_login": "lumduan",
"committed_at": "2026-07-17T04:06:05Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "e4483b391bad957409b65d76cc0cc71996a80af6",
"body": "feat(set): Market Index services (SET50/SET100/sSET/SETESG/...) + stock-list index membership (0.8.0)",
"is_bot": false,
"headline": "Merge pull request #62 from lumduan/feat/market-index",
"author_name": "Sarat Sonsuk",
"author_login": "lumduan",
"committed_at": "2026-07-16T08:04:27Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "24a534cdf9d57ac97c55cb852e7fd03aabde2659",
"body": "CI's repo-wide `ruff format --check .` also formats notebooks; normalize\ninline-comment spacing in the generated cells (whitespace-only).\n\nCo-Authored-By: Claude Fable 5 <noreply@anthropic.com>",
"is_bot": false,
"headline": "style: ruff-format notebook 15_market_index",
"author_name": "batt",
"author_login": "lumduan",
"committed_at": "2026-07-16T08:01:38Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "64badd959c8db98eb5a909122ddd051f74f79f6a",
"body": "New settfex.services.set.index sub-package covering the SET index API:\n\n- Index directory (get_index_list): all 55 indices across INDEX/INDUSTRY/\n SECTOR levels, with filters and SET-vs-mai industry disambiguation\n (AGRO vs AGRO-m query symbols)\n- Index quotation (get_index_info / get_index_info_l\n[…]\nndex.ipynb (all cells verified\nagainst the live API), docs/settfex/services/set/index.md, README/CLAUDE.md\nupdates, version bump 0.7.1 -> 0.8.0.\n\nCo-Authored-By: Claude Fable 5 <noreply@anthropic.com>",
"is_bot": false,
"headline": "feat(set): market index services + stock-list index membership (0.8.0)",
"author_name": "batt",
"author_login": "lumduan",
"committed_at": "2026-07-16T07:57:56Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "ddd13cc2295c6b12151329f1a5a7fa2c1d37ecec",
"body": "fix(set): export latest_historical_trading top-level (release 0.7.1)",
"is_bot": false,
"headline": "Merge pull request #54 from lumduan/release/v0.7.1",
"author_name": "candythink",
"author_login": "lumduan",
"committed_at": "2026-06-21T02:44:36Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "ee10fb584f629c7817c42d5b5c99f467c3f8e2e1",
"body": "…(0.7.1)\n\nPatch release. The 0.7.0 wheel only exposed get_latest_historical_trading (and\nits models) from settfex.services.set.stock, so the documented top-level import\n`from settfex.services.set import get_latest_historical_trading` raised\nImportError for installed users. The fix (top-level export)\n[…]\n- Bump version to 0.7.1 (pyproject.toml + settfex/__init__.py), re-lock, CHANGELOG.\n- Refresh the stale notebook count in CLAUDE.md (13 -> 15).\n\nCo-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>",
"is_bot": false,
"headline": "fix(set): export latest_historical_trading from settfex.services.set …",
"author_name": "batt",
"author_login": "lumduan",
"committed_at": "2026-06-21T02:43:40Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "c2c479cffe7ad90e69bb0d3bdde84ca39d078103",
"body": "…rity\n\nfix(set): latest_historical_trading parity (fix broken README import + docs/tests/notebook)",
"is_bot": false,
"headline": "Merge pull request #53 from lumduan/feat/latest-historical-trading-pa…",
"author_name": "candythink",
"author_login": "lumduan",
"committed_at": "2026-06-21T02:38:30Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "ef2cbc1842d1111f9accb15a839b8c78c3607ac8",
"body": "… + add docs/tests/notebook\n\nThe latest_historical_trading service existed but was undocumented and its\nREADME example was broken twice over:\n- `from settfex.services.set import get_latest_historical_trading` raised\n ImportError (symbol was only exported from settfex.services.set.stock)\n- the snipp\n[…]\nding.py (100% on\n the module; fixture from a real CPALL response)\n- Add examples/set/14_latest_historical_trading.ipynb (+ README index entry)\n\nCo-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>",
"is_bot": false,
"headline": "fix(set): latest_historical_trading parity — fix broken README import…",
"author_name": "batt",
"author_login": "lumduan",
"committed_at": "2026-06-21T02:36:59Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "210cad2aefffd4c1cf3658df5a20262492052d8b",
"body": "docs(releasing): add the `uv lock` re-lock step after a version bump",
"is_bot": false,
"headline": "Merge pull request #52 from lumduan/docs/releasing-uv-lock-step",
"author_name": "candythink",
"author_login": "lumduan",
"committed_at": "2026-06-21T02:29:22Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "b8d4271df9cd1e6bbc6e532f20bca35065255573",
"body": "A version bump in pyproject.toml leaves uv.lock's workspace `settfex` entry\nstale, which fails the release CI gate's `uv sync --group dev --frozen`. Make\nthe re-lock an explicit checklist step so future releases don't trip on it.\n\nCo-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>",
"is_bot": false,
"headline": "docs(releasing): add the `uv lock` re-lock step after a version bump",
"author_name": "batt",
"author_login": "lumduan",
"committed_at": "2026-06-21T02:28:53Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "e9606b3aaac0c89975cd977649c170b065a266ef",
"body": "feat(set): latest traded price for chart quotation (0.7.0)",
"is_bot": false,
"headline": "Merge pull request #51 from lumduan/feat/chart-quotation-latest-price",
"author_name": "candythink",
"author_login": "lumduan",
"committed_at": "2026-06-21T02:20:35Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "3b3c07397b5497d2e44fad4e802087cbcb83bcc4",
"body": "Add a first-class \"latest traded price relative to now\" capability on top of\nthe existing SET chart-quotation service, excluding the null/no-trade buckets\nthe intraday feed pre-populates for the rest of the session:\n\n- get_latest_price(symbol, ...) -> Quotation | None (top-level convenience)\n- Chart\n[…]\nion script, docs, notebook (#13),\n README + CLAUDE.md inventory\n\nRelease 0.7.0: bump pyproject.toml + settfex/__init__.py, re-lock, CHANGELOG.\n\nCo-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>",
"is_bot": false,
"headline": "feat(set): latest traded price for chart quotation (0.7.0)",
"author_name": "batt",
"author_login": "lumduan",
"committed_at": "2026-06-21T02:19:21Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "b7e98c99fe9e09446cc7a8c6828f558639c7e4b1",
"body": "chore: track CLAUDE.md in the repo",
"is_bot": false,
"headline": "Merge pull request #50 from lumduan/chore/track-claude-md",
"author_name": "candythink",
"author_login": "lumduan",
"committed_at": "2026-06-19T07:51:59Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "cf67e997bacb06cab1fe24514a4f9f251f649c6f",
"body": "CLAUDE.md is the project's AI-assistant instructions (overview, architecture,\nservice inventory) and is genuinely shared project context, so version it instead\nof ignoring it. Removes only the CLAUDE.md ignore rule; .claude/ (local settings)\nand scripts/ (local helpers) stay ignored. Inventory reflects the earnings-call\nservices through 0.6.0.\n\nCo-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>",
"is_bot": false,
"headline": "chore: track CLAUDE.md in the repo",
"author_name": "batt",
"author_login": "lumduan",
"committed_at": "2026-06-19T07:51:32Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "0930e9dee139c07ea6f62408762137c2ec680295",
"body": "docs: YouTube rate-limit/IP-block caveat for transcripts",
"is_bot": false,
"headline": "Merge pull request #49 from lumduan/docs/transcript-youtube-caveat",
"author_name": "candythink",
"author_login": "lumduan",
"committed_at": "2026-06-19T07:49:29Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "6125a67046bc98c5e3f282009339d9599f88ebf2",
"body": "Transcript fetching is built for a filtered set (a company/quarter), not the full\n~9,520-video archive, and defaults to low concurrency (3). Blocked/missing\ntranscripts return None; pass proxies={\"http\":...,\"https\":...} if the host IP is\nblocked. (CLAUDE.md inventory was also refreshed locally — it is gitignored.)\n\nCo-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>",
"is_bot": false,
"headline": "docs(readme): note YouTube rate-limit/IP-block caveat for transcripts",
"author_name": "batt",
"author_login": "lumduan",
"committed_at": "2026-06-19T07:48:28Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "dd0fdd55be2bb10c642518c8e84998b500133b12",
"body": "…ripts\n\nfeat: Thai YouTube transcripts for earnings calls (release 0.6.0)",
"is_bot": false,
"headline": "Merge pull request #48 from lumduan/feat/earnings-call-youtube-transc…",
"author_name": "candythink",
"author_login": "lumduan",
"committed_at": "2026-06-19T07:42:39Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "fa63ecec7a724d084e2c02534f2240185564fd8a",
"body": "Each recorded OPPDAY earnings call is a Thai-language YouTube video; this adds\nfetching its transcript as a plain string for AI/LLM use, behind a new optional\n`transcript` extra (youtube-transcript-api), lazily imported.\n\n- settfex/utils/youtube_transcript.py: fetch_youtube_transcript(video_id,\n la\n[…]\nook/CHANGELOG.\n\nVerified live: a real OPPDAY video returns ~6.3k chars of Thai transcript;\nvideos without Thai captions return None gracefully.\n\nCo-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>",
"is_bot": false,
"headline": "feat(set): Thai YouTube transcripts for earnings calls (0.6.0)",
"author_name": "batt",
"author_login": "lumduan",
"committed_at": "2026-06-19T07:41:20Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "4b7741ead4f0450009f0e3db14ebe5428996e427",
"body": "…ogress\n\nfeat: concurrent fetch_all earnings calls + progress bar (release 0.5.0)",
"is_bot": false,
"headline": "Merge pull request #47 from lumduan/feat/earnings-call-fetch-speed-pr…",
"author_name": "candythink",
"author_login": "lumduan",
"committed_at": "2026-06-19T07:16:03Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "ca686574a78eee94f7b985a610e1e548550761a1",
"body": "Fetching the whole OPPDAY archive was slow: fetch_all_earnings_calls paginated\nsequentially with a 0.3s throttle between every page (~191 serial requests, ~150s\nfor all 9520 records). Now it learns the total from page 1 and fetches the rest\nconcurrently (bounded by max_concurrency, default 5), reass\n[…]\nted.\n- Version 0.5.0; tqdm added to the progress/examples extras + dev group; mypy\n override for tqdm. Docs/README/notebook/CHANGELOG updated.\n\nCo-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>",
"is_bot": false,
"headline": "feat(set): concurrent fetch_all_earnings_calls + progress bar (0.5.0)",
"author_name": "batt",
"author_login": "lumduan",
"committed_at": "2026-06-19T07:14:39Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "e63dd731863eea1730e9ba251be69fcade129d1f",
"body": "fix: tolerate null industry + add OPPDAY detail-by-id getter (release 0.4.1)",
"is_bot": false,
"headline": "Merge pull request #46 from lumduan/fix/earnings-call-null-industry",
"author_name": "candythink",
"author_login": "lumduan",
"committed_at": "2026-06-19T06:26:39Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "1d19c6329f59e7981a100272a2bb83b5db5e309e",
"body": "Patch release: tolerate `industry: null` in OPPDAY items (large page_size / deep\npages no longer raise), add get_earnings_call_detail(id), and harden the detail\nmodel's YouTube handling.\n\n- pyproject.toml + settfex/__init__.py: 0.4.0 -> 0.4.1\n- uv.lock: settfex pin -> 0.4.1\n- CHANGELOG.md: [0.4.1] section (Added + Fixed)\n\nCo-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>",
"is_bot": false,
"headline": "chore(release): 0.4.1",
"author_name": "batt",
"author_login": "lumduan",
"committed_at": "2026-06-19T06:25:23Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "e0caccde1610f0d25127bf1b46970d6e6b7b10ce",
"body": "- Add EarningsCallService.fetch_earnings_call_detail(id) and the top-level\n get_earnings_call_detail(id) convenience — fetch one OPPDAY presentation\n directly by its id (the number in a /vdo/{id} URL), without a list+enrich.\n- EarningsCallDetail: add image_path and derived youtube_video_id / youtu\n[…]\ny whitespace from video_link\n (a few legacy records, e.g. vdo/6319, embed a newline mid-URL).\n- Export get_earnings_call_detail; tests + docs.\n\nCo-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>",
"is_bot": false,
"headline": "feat(set): fetch OPPDAY detail by id + robust detail youtube",
"author_name": "batt",
"author_login": "lumduan",
"committed_at": "2026-06-19T06:25:17Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "263f010e3c26277114ad284595ddf365b9125749",
"body": "The OPPDAY list returns `industry: null` for a handful of newly-listed companies\n(e.g. ISTORE22), so fetching deeper pages or a large page_size raised a\nValidationError — `EarningsCallItem.industry` was a required string. Make it\n`str | None`.\n\nAlso corrects a wrong doc note: `page_size` is NOT capp\n[…]\ne request); the earlier \"rejected above ~100\" claim was actually this\nnull-industry validation error.\n\nRegression test added; full suite green.\n\nCo-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>",
"is_bot": false,
"headline": "fix(set): tolerate null industry in earnings-call items",
"author_name": "batt",
"author_login": "lumduan",
"committed_at": "2026-06-19T06:17:04Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "326f59a9a81a80303a0d53d3e441a26d86758f2f",
"body": "feat: SET Earnings Call (Opportunity Day) service + AsyncDataFetcher POST (release 0.4.0)",
"is_bot": false,
"headline": "Merge pull request #45 from lumduan/feature/set-earnings-call",
"author_name": "candythink",
"author_login": "lumduan",
"committed_at": "2026-06-19T05:59:18Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "d88b6e3a32fdef44202ae18e11d5f4d7c0a29e86",
"body": "Bump version to 0.4.0 for the Earnings Call (Opportunity Day) service and the\nAsyncDataFetcher POST support (both backward-compatible feature additions).\n\n- pyproject.toml + settfex/__init__.py: 0.3.0 -> 0.4.0 (kept in sync)\n- uv.lock: settfex pin -> 0.4.0\n- CHANGELOG.md: promote [Unreleased] -> [0.4.0] - 2026-06-19; add empty [Unreleased]\n- README.md: add a Changelog pointer section\n\nCo-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>",
"is_bot": false,
"headline": "chore(release): 0.4.0",
"author_name": "batt",
"author_login": "lumduan",
"committed_at": "2026-06-19T05:57:42Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "f70a556d48688a74b5f2ebd0134ee73434aa1253",
"body": "- docs/settfex/services/set/earnings_call.md (full service reference)\n- README: SET services entry + \"Get Earnings Call Calendar\" usage block\n- examples/set/12_earnings_call.ipynb (fetch -> DataFrame -> filter -> CSV)\n- CHANGELOG: Unreleased entry for the service and the AsyncDataFetcher POST\n\nCo-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>",
"is_bot": false,
"headline": "docs(set): document Earnings Call service + example notebook",
"author_name": "batt",
"author_login": "lumduan",
"committed_at": "2026-06-19T05:45:21Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "c87b08ccde1aea38631d4e655cc3a5b2a21e076d",
"body": "Fetch the SET \"Earnings Call (OPPDAY)\" calendar from the stateless\nopportunity-day backend (POST api.lcp.setgroup.or.th/api/v1/investor/search/archive)\nas typed Pydantic models plus an optional pandas DataFrame.\n\n- EarningsCallService: fetch_earnings_calls / _raw, bounded\n fetch_all_earnings_calls,\n[…]\ntail `period` (clock range,\n\"16:15 - 17:00\") surfaces separately as EarningsCallDetail.meeting_time.\n99% module test coverage; all HTTP mocked.\n\nCo-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>",
"is_bot": false,
"headline": "feat(set): add Earnings Call (Opportunity Day) calendar service",
"author_name": "batt",
"author_login": "lumduan",
"committed_at": "2026-06-19T05:45:14Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "f322626acc547534e6a14d62d5917a5353725325",
"body": "Add keyword-only `method=\"GET\"` (default) and `json_body` to fetch(),\nfetch_json(), and _make_request(). POST runs through the standalone\n(sessionless) path and the existing NaN-rejecting JSON decoder, so the\nhardening plus retry/rate-limit logic apply to POST too. GET stays the\ndefault, keeping eve\n[…]\nvia a persistent session is intentionally\nunsupported (raises NotImplementedError) — the cookieless opportunity-day\nAPI uses use_session=False.\n\nCo-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>",
"is_bot": false,
"headline": "feat(utils): add opt-in POST support to AsyncDataFetcher",
"author_name": "batt",
"author_login": "lumduan",
"committed_at": "2026-06-19T05:45:05Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "9d8a5e11bc40d68264d5af8ba317f2c4347009b8",
"body": "feat(tfex): underlying-price service + release 0.3.0",
"is_bot": false,
"headline": "Merge pull request #44 from lumduan/feat/tfex-underlying-price",
"author_name": "candythink",
"author_login": "lumduan",
"committed_at": "2026-06-17T14:23:45Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "baf0bb66a4c5f69155c3a33f1de0bd50fa299920",
"body": "Bumps version (pyproject.toml + settfex/__init__.py) and adds the CHANGELOG\n0.3.0 section for the new TFEX underlying-price service (get_underlying_price /\nTFEXUnderlyingPriceService / UnderlyingPrice → GET /api/set/tfex/series/{symbol}/\nunderlying-price; the SET50 index spot for SET50 options/futures).\n\nCo-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>",
"is_bot": false,
"headline": "chore(release): 0.3.0",
"author_name": "batt",
"author_login": "lumduan",
"committed_at": "2026-06-17T14:22:12Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "41a27e9c90b59d96f4f784c58aef014474005a19",
"body": "Add the two remaining \"Adding a New Service\" checklist items for the\nTFEX underlying-price service:\n\n- examples/tfex/03_underlying_price.ipynb — example notebook mirroring\n 02_trading_statistics.ipynb (intro/overview, basic fetch, field display,\n spot-vs-futures basis note, multi-series + pandas D\n[…]\n complete the checklist.\n\nService code/tests/constants/__init__ unchanged. Gate green:\nruff check + format, mypy --strict, pytest (158 passed).\n\nCo-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>",
"is_bot": false,
"headline": "docs(tfex): underlying-price verify script + example notebook",
"author_name": "batt",
"author_login": "lumduan",
"committed_at": "2026-06-17T14:18:27Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "950a618dc39e5c80bbfbc53318b0806db6161df3",
"body": "Add a TFEX underlying-price service mirroring the trading-statistics\nservice: fetches the underlying instrument price for a TFEX series\n(for SET50 index options/futures, that is the SET50 index).\n\n- constants: TFEX_UNDERLYING_PRICE_ENDPOINT\n (/api/set/tfex/series/{symbol}/underlying-price)\n- underl\n[…]\nn, nullable fields, missing-field\n ValidationError, raw non-dict guard, and NaN-rejection\n (ResponseParseError). New module at 100% coverage.\n\nCo-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>",
"is_bot": false,
"headline": "feat(tfex): add underlying-price service",
"author_name": "batt",
"author_login": "lumduan",
"committed_at": "2026-06-17T13:59:34Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "b697ed1bc75c9385628b8ab3f56ae84f229dc5bc",
"body": "fix(release): repair GitHub Release step (changelog notes via body_path)",
"is_bot": false,
"headline": "Merge pull request #43 from lumduan/fix/release-changelog-notes",
"author_name": "candythink",
"author_login": "lumduan",
"committed_at": "2026-06-17T08:02:53Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "c0cc14456c559aafcad5342fe0089866ed1d590b",
"body": "… step)\n\nThe github-release job failed at 'Extract changelog section' with\n'Invalid value. Matching delimiter not found CHANGELOG_EOF'. The notes were\nwritten with .strip() (no trailing newline), so piping the file into the\n$GITHUB_OUTPUT 'notes<<CHANGELOG_EOF' heredoc glued the closing delimiter on\n[…]\nase via body_path. Also write a trailing\nnewline for good measure. Verified: extraction yields the [x.y.z] body and the\nfile ends in a newline.\n\nCo-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>",
"is_bot": false,
"headline": "fix(release): write changelog notes via body_path (fix GitHub Release…",
"author_name": "batt",
"author_login": "lumduan",
"committed_at": "2026-06-17T07:59:31Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "8606b124f063059ebc59df011686d9a107d59f59",
"body": "docs(release): single tag-driven publish path (resolve dual-publish)",
"is_bot": false,
"headline": "Merge pull request #42 from lumduan/chore/single-release-path",
"author_name": "candythink",
"author_login": "lumduan",
"committed_at": "2026-06-17T07:41:16Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "6cf0542fb90dc78cfc2a8f786d60b4b5ea027443",
"body": "Resolves the dual-publish ambiguity (a maintainer's local twine uploader vs the\ntag-triggered release.yml). release.yml already publishes via OIDC Trusted Publisher\nwith skip-existing, so it is the one canonical, auditable PyPI path.\n\n- RELEASING.md: documents the single flow (bump -> CHANGELOG -> m\n[…]\ned) was realigned to\nonly validate + push the tag instead of running twine, so it now feeds the same single\npath rather than competing with it.\n\nCo-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>",
"is_bot": false,
"headline": "docs(release): document the single tag-driven publish path",
"author_name": "batt",
"author_login": "lumduan",
"committed_at": "2026-06-17T07:38:03Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "fc5d6f1dd851e42a38a196aab7389dfd468f7e35",
"body": "Hardening pass: financial-data robustness, concurrency fixes, and 0.2.1 release",
"is_bot": false,
"headline": "Merge pull request #31 from lumduan/claude-settfex-overhaul",
"author_name": "candythink",
"author_login": "lumduan",
"committed_at": "2026-06-17T07:23:40Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "9d181b44d073a5de2bf826add44b9b30c977078f",
"body": "Patch release: robustness + concurrency hardening, no public API changes.\nBumps version to 0.2.1 (also syncs settfex/__init__.py __version__, which was\nstale at 0.1.0) and adds the [0.2.1] CHANGELOG section.\n\nCo-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>",
"is_bot": false,
"headline": "chore(release): 0.2.1",
"author_name": "batt",
"author_login": "lumduan",
"committed_at": "2026-06-17T07:15:14Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "0a2c6a2e452b998ec5aea636d01c2105d06eec91",
"body": "Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>",
"is_bot": false,
"headline": "docs: add COMPREHENSIVE_AUDIT.md for the hardening pass",
"author_name": "batt",
"author_login": "lumduan",
"committed_at": "2026-06-17T07:04:55Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "79301e320b8b89b1d86cf5ce796a95b17b3d06ee",
"body": "- New TFEX test suites (previously 0% covered) verifying happy-path validation,\n ValidationError on missing required fields, and the ResponseParseError raised by\n the new non-dict shape guard that replaced 'assert isinstance(data, dict)'.\n- End-to-end NaN-rejection tests on the shareholder (single\n[…]\nel) and financial\n (list-model) services proving a NaN numeric field is rejected with symbol context\n instead of silently entering the model.\n\nCo-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>",
"is_bot": false,
"headline": "test: regression tests for malformed/NaN/partial API responses",
"author_name": "batt",
"author_login": "lumduan",
"committed_at": "2026-06-17T07:01:48Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "3514395b488f7713f5959132a7e05598c97da9f1",
"body": "…d cache init\n\nensure_initialized() was unguarded: under a concurrent cold start, every coroutine\npassed the 'not initialized' check before any finished warming up, firing one full\nwarmup round-trip each (demonstrated: 25 round-trips for 25 concurrent callers, which\nalso risks tripping bot detection\n[…]\nche() to asyncio.to_thread so cold cache init never blocks\nthe event loop. Added tests/utils/test_session_manager.py (concurrency + singleton).\n\nCo-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>",
"is_bot": false,
"headline": "fix(session): serialize warmup to prevent cold-start stampede; offloa…",
"author_name": "batt",
"author_login": "lumduan",
"committed_at": "2026-06-17T06:57:53Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "686b49dfdecc3aaca1f517b2a2c1bc93da9693c4",
"body": "The 11-entry default header dict was rebuilt as a literal on every fetch() call.\nMoved it to a module-level constant copied per request (dict(_DEFAULT_FETCH_HEADERS)),\nwhich keeps per-request mutation isolation while avoiding the literal rebuild.\nMicro-benchmarked at ~0.38us -> ~0.16us per call (negligible vs network I/O, but a\nzero-risk cleanup of a named hot-path allocation).\n\nCo-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>",
"is_bot": false,
"headline": "perf(data_fetcher): hoist static request headers to module constant",
"author_name": "batt",
"author_login": "lumduan",
"committed_at": "2026-06-17T06:57:46Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "77827802a0d5253ec4e3403bcf57ec9a0eee967c",
"body": "…helper\n\nAll 13 SET services (stock list + 11 stock services + financial) now decode via\nparsing.decode_json (rejects NaN/Infinity; symbol+endpoint context on bad JSON)\nand validate via validate_or_raise / validate_list_or_raise, which add per-item\nindex context and preserve the original ValidationE\n[…]\nThree over-specific JSONDecodeError test assertions updated to the new\ncontext-rich ResponseParseError (now also asserting the symbol appears).\n\nCo-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>",
"is_bot": false,
"headline": "fix(set): route all service parsing through hardened decode/validate …",
"author_name": "batt",
"author_login": "lumduan",
"committed_at": "2026-06-17T06:51:46Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "69de09b0a2255a30052830d6a224c53b24ae8c4d",
"body": "…uard\n\nBoth TFEX services now validate through parsing.validate_or_raise (context-rich\nerrors) and replace 'assert isinstance(data, dict)' -- which is stripped under\npython -O and yields a context-free AssertionError -- with an explicit\nResponseParseError carrying the series symbol/endpoint.\n\nCo-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>",
"is_bot": false,
"headline": "fix(tfex): validate via helper and replace unsafe assert with shape g…",
"author_name": "batt",
"author_login": "lumduan",
"committed_at": "2026-06-17T06:51:35Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "3de2b3c6a45b1bcf6fc2b4ab6ce035e206952532",
"body": "…ontext)\n\nfetch_json now routes through parsing.decode_json, so the shared JSON entry\npoint used by the TFEX services rejects NaN/Infinity literals (previously\naccepted silently) and raises ResponseParseError with the request URL in the\nmessage instead of a context-free JSONDecodeError. Tests updated to assert the\nnew context-rich error plus a NaN-rejection regression case.\n\nCo-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>",
"is_bot": false,
"headline": "fix(data_fetcher): decode JSON via hardened helper (reject NaN, add c…",
"author_name": "batt",
"author_login": "lumduan",
"committed_at": "2026-06-17T06:51:27Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "743c0871b440fa735f3eccb9a2d1f1f4ef036156",
"body": "New internal settfex/utils/parsing.py centralizes the decode -> validate step\nshared by every SET/TFEX service:\n\n- decode_json() rejects NaN/Infinity/-Infinity literals (default json.loads\n accepts them, letting a non-finite price/PE/margin flow silently into a\n model -- the main silent-corruption\n[…]\nr type for callers.\n\nBenchmarked: parse_constant adds ~0.5% (noise) on finite payloads;\nmodel_validate matches Model(**d). 18 unit tests added.\n\nCo-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>",
"is_bot": false,
"headline": "feat(utils): add context-rich JSON decode + validation helpers",
"author_name": "batt",
"author_login": "lumduan",
"committed_at": "2026-06-17T06:51:16Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "ea6e358a6811a4b8e13b2c740fd82288fc231bb2",
"body": "Standardized project tooling carried over from the Python project template:\npre-commit config, SECURITY/CONTRIBUTING/CODE_OF_CONDUCT docs, issue/PR\ntemplates, dependabot + security CI, .editorconfig, and ruff B/SIM rules +\ncoverage floor (--cov-fail-under=45) in pyproject. Includes cosmetic SIM\nternary refactors in session_manager/session_cache and a SIM117 nested-with\nfix in the data-fetcher tests.\n\nCo-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>",
"is_bot": false,
"headline": "chore: adopt Python project template tooling",
"author_name": "batt",
"author_login": "lumduan",
"committed_at": "2026-06-17T06:30:36Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "edcd685073c529847bcd87645ad95e80f9b8cc16",
"body": "🔧 fix: resolve all 23 mypy type errors for CI green",
"is_bot": false,
"headline": "Merge pull request #30 from lumduan/fix/mypy-type-errors",
"author_name": "candythink",
"author_login": "lumduan",
"committed_at": "2026-06-09T14:16:10Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "565c317ea708c92408887c53da7c562522c1be3b",
"body": "- Remove legacy cookie code (session_cookies, use_cookies, generate_incapsula_cookies)\n from profile_stock.py and list.py — SessionManager handles cookies automatically\n- Remove invalid cookies/use_random_cookies kwargs from fetch_json calls\n- Fix no-any-return errors in fetch_*_raw methods (6 file\n[…]\ned] for diskcache\n- Fix Any return types in session_cache.py (get, delete, is_expired)\n- Add missing type annotation for session_cache.__exit__\n\nCo-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>",
"is_bot": false,
"headline": "🔧 fix: resolve all 23 mypy errors for CI green",
"author_name": "lumduan",
"author_login": "lumduan",
"committed_at": "2026-06-09T14:15:45Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "da7e030c64c9420bf31034978f047b1caee15963",
"body": "🔧 fix: ruff lint and format for CI green",
"is_bot": false,
"headline": "Merge pull request #29 from lumduan/fix/ruff-lint-ci",
"author_name": "candythink",
"author_login": "lumduan",
"committed_at": "2026-06-09T14:10:14Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "7a14462656c1904d52deef0c2916fa9102d9520b",
"body": "- Auto-fix 298 ruff lint errors (import sorting, formatting)\n- Fix E501 line too long in source files\n- Add per-file-ignores for notebooks (E501, E402) and tests (E501)\n- Format all files with ruff format\n\nCo-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>",
"is_bot": false,
"headline": "🔧 chore: fix ruff lint and format issues for CI",
"author_name": "lumduan",
"author_login": "lumduan",
"committed_at": "2026-06-09T14:09:55Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "b89b651f3aa19aac7731155f406df1895e27491f",
"body": "🎉 release: v0.2.0 — Chart Quotation & Latest Historical Trading services",
"is_bot": false,
"headline": "Merge pull request #28 from lumduan/release/v0.2.0",
"author_name": "candythink",
"author_login": "lumduan",
"committed_at": "2026-06-09T14:06:23Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "bfc4edeb7c43877afd63bca603d04afd40700900",
"body": "- Add Chart Quotation Service (intraday/historical chart data, 9 periods)\n- Add Latest Historical Trading Service (OHLCV daily summary)\n- Add CI workflow (Ruff, mypy, pytest with coverage)\n- Add Release workflow (PyPI publish + GitHub release via tags)\n- Update CHANGELOG.md, README.md with new services\n- Bump version 0.1.0 → 0.2.0\n\nCo-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>",
"is_bot": false,
"headline": "🎉 release: v0.2.0 — Chart Quotation & Latest Historical Trading services",
"author_name": "lumduan",
"author_login": "lumduan",
"committed_at": "2026-06-09T14:05:48Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "c36cd96ebb7bd8931ae81bbabf4edf40261d2623",
"body": "…orical-trading",
"is_bot": false,
"headline": "Merge pull request #27 from ENSCS/feature/chart-quotation-latest-hist…",
"author_name": "candythink",
"author_login": "lumduan",
"committed_at": "2026-06-07T12:22:25Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "0faad6637895f14118858cc139cf8b5126e1525a",
"body": "- Add ChartQuotationService: fetches intraday/historical price chart data\n with support for periods (1D, 5D, 1M, 3M, 6M, 1Y, 3Y, 5Y, MAX)\n- Add LatestHistoricalTradingService: fetches latest trading day summary\n including OHLCV, P/E, P/BV, dividend yield, and market cap\n- Export new services from stock __init__.py\n- Add get_chart_quotation() and get_latest_historical_trading() to Stock class\n- Add new API endpoint constants\n\nCo-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>",
"is_bot": false,
"headline": "Add chart quotation and latest historical trading services",
"author_name": "Earn_CS",
"author_login": null,
"committed_at": "2026-06-07T12:16:22Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "1af3f75ee3ba5be6c18981a404c8223f60f4124b",
"body": "fix: update PyPI badge to use shields.io",
"is_bot": false,
"headline": "Merge pull request #26 from lumduan/fix/pypi-badge-shields",
"author_name": "candythink",
"author_login": "lumduan",
"committed_at": "2025-10-06T03:17:06Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "febb34b224ebc000e648833f4b8c41d239131836",
"body": "🎯 Purpose\n- Replace badge.fury.io with shields.io for PyPI version badge\n- Shields.io has better cache handling and updates faster\n\n📁 Changes\n• README.md: Updated PyPI badge URL from badge.fury.io to shields.io\n\n✅ Benefits\n- Badge will now show correct version (0.1.0)\n- More reliable badge service with better caching\n- Faster updates when new versions are released",
"is_bot": false,
"headline": "fix: update PyPI badge to use shields.io for better caching",
"author_name": "lumduan",
"author_login": "lumduan",
"committed_at": "2025-10-06T03:15:57Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "2de5565deb21d32dd12b5c92e029965f1bcf04e5",
"body": "Update learning path descriptions for clarity",
"is_bot": false,
"headline": "Merge pull request #24 from lumduan:update/readme",
"author_name": "candythink",
"author_login": "lumduan",
"committed_at": "2025-10-06T03:02:37Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "ca022d6e56e2906d81d40d64ffc63e4349786156",
"body": null,
"is_bot": false,
"headline": "📝 docs: Update learning path descriptions for clarity",
"author_name": "lumduan",
"author_login": "lumduan",
"committed_at": "2025-10-06T03:02:05Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "17f14846d8f273dee9ae8280b7f8adc3ee2985d0",
"body": "🎉 Prepare settfex for first public PyPI release (v0.1.0)",
"is_bot": false,
"headline": "Merge pull request #23 from lumduan/prepare-pypi-release",
"author_name": "candythink",
"author_login": "lumduan",
"committed_at": "2025-10-06T02:39:19Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "5b284a051fb0a9a6302ed233727d185c7f87cfa0",
"body": "This commit prepares settfex for its first public release on PyPI with\nproduction-ready configuration, documentation, and packaging.\n\n## Core Changes\n\n### Package Configuration\n- Update pyproject.toml with enhanced metadata for PyPI\n- Change development status from Alpha to Beta\n- Move pandas/matplo\n[…]\nthe package but does NOT publish to PyPI.\nSee RELEASE_CHECKLIST.md for publishing steps.\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>",
"is_bot": false,
"headline": "🎉 feat: Prepare settfex for first public PyPI release (v0.1.0)",
"author_name": "lumduan",
"author_login": "lumduan",
"committed_at": "2025-10-06T02:37:09Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "5bf89fecc471c691e7c3ba4fbc8ab57b58787957",
"body": "📓 Add comprehensive Jupyter notebook examples for all services",
"is_bot": false,
"headline": "Merge pull request #22 from lumduan/feature/jupyter-examples",
"author_name": "candythink",
"author_login": "lumduan",
"committed_at": "2025-10-05T15:02:43Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "d528b7cba4b0d542c06127845b57d70da718300e",
"body": "Updated project configuration with correct author and repository information:\n- Author: batt <b@candythink.com>\n- Repository: lumduan/settfex on GitHub\n- Updated all project URLs to point to correct GitHub repo\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>",
"is_bot": false,
"headline": "📝 docs: Update project metadata in pyproject.toml",
"author_name": "lumduan",
"author_login": "lumduan",
"committed_at": "2025-10-05T15:02:04Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "efe7f07ecc249838f010cfd23f4635724e5aec14",
"body": "Updated notebook outputs to reflect the fixed code:\n- 05_corporate_action.ipynb: Removed error output, added working results\n- 09_trading_statistics.ipynb: Updated with YTD period dashboard output\n\nThese are the final output updates for the previously fixed runtime errors.\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>",
"is_bot": false,
"headline": "🐛 fix: Update notebook outputs after timezone and period fixes",
"author_name": "lumduan",
"author_login": "lumduan",
"committed_at": "2025-10-05T15:00:54Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "94a01e7d698e6a66a48bb44df27226e275989f1d",
"body": "Fixed critical runtime errors in two notebooks:\n\n**05_corporate_action.ipynb:**\n- Fixed: TypeError when comparing tz-aware and tz-naive datetimes\n- Issue: xd_date from API has timezone (+07:00) but comparison datetime was naive\n- Solution: Remove timezone with .dt.tz_localize(None) before date arith\n[…]\norks without errors\n- Trading stats: Dashboard creates successfully with correct columns\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>",
"is_bot": false,
"headline": "🐛 fix: Fix timezone and period errors in notebooks",
"author_name": "lumduan",
"author_login": "lumduan",
"committed_at": "2025-10-05T14:20:38Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "0412bdffac0cc3f7098bd141fc5927f3c6c7c96d",
"body": "Fixed incorrect Pydantic model attribute names across 6 notebooks:\n\n**03_stock_profile.ipynb:**\n- Fixed: name_en/name_th → name (StockProfile has single name field)\n- Fixed: sector_code → sector, industry_code → industry\n- Fixed: par_value → par, foreign_limit → percent_foreign_limit\n- Fixed: foreig\n[…]\nase field names with camelCase aliases\n- Tested all fixes with live API calls - all pass\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>",
"is_bot": false,
"headline": "🐛 fix: Fix AttributeError issues in example notebooks",
"author_name": "lumduan",
"author_login": "lumduan",
"committed_at": "2025-10-05T14:04:23Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "3fa7764d6dc7baf576daaf1a30fce30223a67667",
"body": "Added 13 interactive Jupyter notebooks demonstrating all SET and TFEX services:\n\n**SET Examples (11 notebooks):**\n- Stock List: Portfolio universe construction and filtering\n- Highlight Data: Value screeners, dividend portfolios, risk metrics\n- Stock Profile: Listing details, IPO data, foreign limit\n[…]\nREADME.md with SET-specific guide\n- Added pandas and matplotlib as optional dependencies\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>",
"is_bot": false,
"headline": "📓 docs: Add comprehensive Jupyter notebook examples for all services",
"author_name": "lumduan",
"author_login": "lumduan",
"committed_at": "2025-10-05T10:43:11Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "68dd27277e322eba20e135020405104ae7042435",
"body": "🔧 chore: Remove CLAUDE.md from git tracking",
"is_bot": false,
"headline": "Merge pull request #21 from lumduan/chore/remove-claude-from-tracking",
"author_name": "candythink",
"author_login": "lumduan",
"committed_at": "2025-10-05T10:10:16Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "da062bd7fc596b071869e91a9638858c518377eb",
"body": "• CLAUDE.md is already in .gitignore but was previously tracked\n• Removed from git tracking to respect .gitignore rules\n• Local file remains intact for AI assistant context\n• Future changes to CLAUDE.md will not be tracked by git",
"is_bot": false,
"headline": "🔧 chore: Remove CLAUDE.md from git tracking",
"author_name": "lumduan",
"author_login": "lumduan",
"committed_at": "2025-10-05T10:08:46Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "1b5fe174bb29674d422f7c98403ba2e8f34ad7b2",
"body": "📝 docs: Update README.md with improved structure and clarity",
"is_bot": false,
"headline": "Merge pull request #20 from lumduan/update/readme",
"author_name": "candythink",
"author_login": "lumduan",
"committed_at": "2025-10-05T10:06:09Z",
"body_truncated": false,
"is_coding_agent": false
}
],
"releases_count": 16,
"commits_last_year": 160,
"latest_release_at": "2026-07-20T15:14:50Z",
"latest_release_tag": "v0.14.0",
"releases_from_tags": false,
"days_since_last_push": 1,
"active_weeks_last_year": 4,
"days_since_latest_release": 1,
"mean_days_between_releases": 3.5
},
"community": {
"has_readme": true,
"has_license": true,
"has_description": true,
"has_contributing": true,
"health_percentage": 100,
"has_issue_template": false,
"has_code_of_conduct": true,
"has_pull_request_template": true
},
"ecosystem": {
"packages": [
{
"name": "settfex",
"exists": true,
"license": "MIT",
"keywords": [
"api",
"async",
"exchange",
"finance",
"futures",
"market-data",
"set",
"stock",
"tfex",
"thai-stocks",
"thailand",
"trading",
"Development Status :: 4 - Beta",
"Intended Audience :: Developers",
"Intended Audience :: Financial and Insurance Industry",
"License :: OSI Approved :: MIT License",
"Operating System :: OS Independent",
"Programming Language :: Python :: 3",
"Programming Language :: Python :: 3 :: Only",
"Programming Language :: Python :: 3.11",
"Programming Language :: Python :: 3.12",
"Programming Language :: Python :: 3.13",
"Topic :: Office/Business :: Financial",
"Topic :: Office/Business :: Financial :: Investment",
"Topic :: Software Development :: Libraries :: Python Modules",
"Typing :: Typed"
],
"ecosystem": "pypi",
"matches_repo": true,
"registry_url": "https://pypi.org/project/settfex/",
"is_deprecated": false,
"latest_version": "0.14.0",
"repository_url": "https://github.com/lumduan/settfex",
"versions_count": 16,
"total_downloads": null,
"dependents_count": null,
"deprecation_note": null,
"maintainers_count": null,
"monthly_downloads": null,
"first_published_at": "2025-10-06T02:45:27.061500Z",
"latest_published_at": "2026-07-20T15:14:33.493510Z",
"latest_version_yanked": null,
"days_since_latest_publish": 1
}
]
},
"popularity": {
"forks": 1,
"stars": 0,
"watchers": 0,
"fork_history": {
"days": [
{
"date": "2026-06-07",
"count": 1
}
],
"complete": true,
"collected": 1,
"total_forks": 1
},
"star_history": {
"days": [],
"complete": true,
"collected": 0,
"total_stars": 0
},
"open_issues_and_prs": 5
},
"ai_readiness": {
"has_nix": false,
"example_dirs": [
"examples",
"notebooks"
],
"has_llms_txt": false,
"has_dockerfile": false,
"has_mcp_signal": false,
"bootstrap_files": [],
"api_schema_files": [],
"has_devcontainer": false,
"typecheck_configs": [
"settfex/py.typed"
],
"toolchain_manifests": [],
"largest_source_bytes": 47064,
"source_files_sampled": 100,
"oversized_source_files": 0,
"agent_instruction_files": [
".github/instructions/core-architectrual-principles.instructions.md",
".github/instructions/documentation-standards.instructions.md",
".github/instructions/file-organization.instructions.md",
".github/instructions/git-commit.instructions.md",
".github/instructions/python-dependency-management.instructions.md",
"CLAUDE.md"
],
"agent_instruction_max_bytes": 20891
},
"dependencies": {
"manifests": [
"pyproject.toml"
],
"advisories": {
"error": null,
"scope": null,
"source": null,
"findings": [],
"collected": false,
"malicious": [],
"truncated": false,
"by_severity": {},
"advisory_count": 0,
"affected_count": 0,
"assessed_count": 0,
"malicious_count": 0,
"assessed_package": null,
"unassessed_count": 0,
"direct_affected_count": 0
},
"ecosystems": [
"pypi"
],
"dependencies": [
{
"name": "curl-cffi",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": ">=0.6.0"
},
{
"name": "pydantic",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": ">=2.0.0"
},
{
"name": "loguru",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": ">=0.7.0"
},
{
"name": "diskcache",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": ">=5.6.0"
}
],
"all_dependencies": {
"error": "GitHub dependency-graph SBOM unavailable (404); the dependency graph may be disabled for this repository",
"source": null,
"packages": [],
"collected": false,
"truncated": false,
"total_count": null,
"direct_count": null,
"indirect_count": null
}
},
"maintainership": {
"issues": {
"open_prs": 5,
"merged_prs": 57,
"open_issues": 0,
"closed_ratio": null,
"closed_issues": 0,
"closed_unmerged_prs": 18
},
"bus_factor": 1,
"bot_contributors": 0,
"top_contributors": [
{
"type": "User",
"login": "lumduan",
"commits": 159,
"avatar_url": "https://avatars.githubusercontent.com/u/15356949?v=4"
}
],
"contributors_sampled": 1,
"top_contributor_share": 1
},
"quality_signals": {
"has_ci": true,
"has_tests": true,
"ci_workflows": [
"ci.yml",
"release.yml",
"security.yml"
],
"has_docs_dir": true,
"linter_configs": [],
"has_editorconfig": true,
"has_linter_config": true,
"has_precommit_config": true
},
"security_signals": {
"lockfiles": [
"uv.lock"
],
"scorecard": {
"checks": [
{
"name": "Binary-Artifacts",
"score": 10,
"reason": "no binaries found in the repo",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#binary-artifacts"
},
{
"name": "Branch-Protection",
"score": 3,
"reason": "branch protection is not maximal on development and all release branches",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#branch-protection"
},
{
"name": "CI-Tests",
"score": 6,
"reason": "8 out of 13 merged PRs checked by a CI test -- score normalized to 6",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#ci-tests"
},
{
"name": "CII-Best-Practices",
"score": 0,
"reason": "no effort to earn an OpenSSF best practices badge detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#cii-best-practices"
},
{
"name": "Code-Review",
"score": 0,
"reason": "Found 0/13 approved changesets -- score normalized to 0",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#code-review"
},
{
"name": "Contributors",
"score": 3,
"reason": "project has 1 contributing companies or organizations -- score normalized to 3",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#contributors"
},
{
"name": "Dangerous-Workflow",
"score": 10,
"reason": "no dangerous workflow patterns detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#dangerous-workflow"
},
{
"name": "Dependency-Update-Tool",
"score": 10,
"reason": "update tool detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#dependency-update-tool"
},
{
"name": "Fuzzing",
"score": 0,
"reason": "project is not fuzzed",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#fuzzing"
},
{
"name": "License",
"score": 10,
"reason": "license file detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#license"
},
{
"name": "Maintained",
"score": 10,
"reason": "30 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 10",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#maintained"
},
{
"name": "Packaging",
"score": 10,
"reason": "packaging workflow detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#packaging"
},
{
"name": "Pinned-Dependencies",
"score": 0,
"reason": "dependency not pinned by hash detected -- score normalized to 0",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#pinned-dependencies"
},
{
"name": "SAST",
"score": 0,
"reason": "SAST tool is not run on all commits -- score normalized to 0",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#sast"
},
{
"name": "Security-Policy",
"score": 10,
"reason": "security policy file detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#security-policy"
},
{
"name": "Signed-Releases",
"score": 0,
"reason": "Project has not signed or included provenance with any releases.",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#signed-releases"
},
{
"name": "Token-Permissions",
"score": 0,
"reason": "detected GitHub workflow tokens with excessive permissions",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#token-permissions"
},
{
"name": "Vulnerabilities",
"score": 0,
"reason": "75 existing vulnerabilities detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#vulnerabilities"
}
],
"commit": "b8c5a0ba5937e70554fb5790c4b3e732fa3aa77e",
"ran_at": "2026-07-22T03:24:54Z",
"aggregate_score": 4.7,
"scorecard_version": "v5.5.0"
},
"has_codeql_workflow": false,
"has_security_policy": true,
"has_dependabot_config": true
},
"contribution_flow": {
"collected": true,
"ci_last_run_at": "2026-07-20T19:15:49Z",
"oldest_open_prs": [
{
"number": 76,
"created_at": "2026-07-20T19:16:06Z",
"last_comment_at": "2026-07-20T19:16:06Z",
"last_comment_author": "dependabot"
},
{
"number": 77,
"created_at": "2026-07-20T19:16:16Z",
"last_comment_at": "2026-07-20T19:16:17Z",
"last_comment_author": "dependabot"
},
{
"number": 78,
"created_at": "2026-07-20T19:16:35Z",
"last_comment_at": "2026-07-20T19:16:35Z",
"last_comment_author": "dependabot"
},
{
"number": 79,
"created_at": "2026-07-20T19:16:52Z",
"last_comment_at": "2026-07-20T19:16:52Z",
"last_comment_author": "dependabot"
},
{
"number": 80,
"created_at": "2026-07-20T19:17:02Z",
"last_comment_at": "2026-07-20T19:17:02Z",
"last_comment_author": "dependabot"
}
],
"last_merged_pr_at": "2026-07-20T15:13:05Z",
"ci_last_conclusion": "SUCCESS",
"oldest_open_issues": []
}
},
"config": {
"disabled_metrics": [],
"disabled_categories": [],
"disabled_components": {}
},
"source": {
"url": "https://github.com/lumduan/settfex",
"host": "github.com",
"name": "settfex",
"owner": "lumduan"
},
"metrics": {
"overall": {
"key": "overall",
"band": "moderate",
"name": "Overall health",
"note": null,
"notes": [],
"value": 61,
"inputs": {
"security": 47,
"vitality": 76,
"community": 43,
"governance": 51,
"engineering": 85
},
"components": []
},
"categories": [
{
"key": "vitality",
"band": "good",
"name": "Vitality",
"value": 76,
"weight": 0.22,
"metrics": [
{
"key": "development_activity",
"band": "moderate",
"name": "Development activity",
"note": null,
"notes": [],
"value": 67,
"inputs": {
"commits_last_year": 160,
"human_commit_share": 1,
"days_since_last_push": 1,
"active_weeks_last_year": 4
},
"components": [
{
"key": "push_recency",
"name": "Push recency",
"detail": "last push 1 days ago",
"points": 36,
"status": "met",
"details": [
{
"code": "push_recency",
"params": {
"days": 1
}
}
],
"max_points": 36
},
{
"key": "commit_cadence",
"name": "Commit cadence",
"detail": "4/52 weeks with commits",
"points": 2.8,
"status": "partial",
"details": [
{
"code": "commit_cadence_weeks",
"params": {
"weeks": 4
}
}
],
"max_points": 36
},
{
"key": "commit_volume",
"name": "Commit volume",
"detail": "160 commits in the last year",
"points": 18,
"status": "met",
"details": [
{
"code": "commits_last_year",
"params": {
"count": 160
}
}
],
"max_points": 18
},
{
"key": "openssf_scorecard_maintained",
"name": "OpenSSF Scorecard: Maintained",
"detail": "30 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 10",
"points": 10,
"status": "met",
"details": [],
"max_points": 10
}
]
},
{
"key": "release_discipline",
"band": "excellent",
"name": "Release discipline",
"note": null,
"notes": [],
"value": 90,
"inputs": {
"releases_count": 16,
"latest_release_tag": "v0.14.0",
"releases_from_tags": false,
"days_since_latest_release": 1,
"mean_days_between_releases": 3.5
},
"components": [
{
"key": "ships_releases",
"name": "Ships releases",
"detail": "16 releases published",
"points": 27,
"status": "met",
"details": [
{
"code": "releases_published",
"params": {
"count": 16
}
}
],
"max_points": 27
},
{
"key": "release_recency",
"name": "Release recency",
"detail": "latest release 1 days ago",
"points": 36,
"status": "met",
"details": [
{
"code": "release_recency",
"params": {
"days": 1
}
}
],
"max_points": 36
},
{
"key": "release_cadence",
"name": "Release cadence",
"detail": "a release every ~3.5 days",
"points": 27,
"status": "met",
"details": [
{
"code": "release_cadence",
"params": {
"gap": 3.5
}
}
],
"max_points": 27
},
{
"key": "openssf_scorecard_signed_releases",
"name": "OpenSSF Scorecard: Signed-Releases",
"detail": "Project has not signed or included provenance with any releases.",
"points": 0,
"status": "missed",
"details": [],
"max_points": 10
}
]
},
{
"key": "abandonment",
"band": "excellent",
"name": "Abandonment",
"note": null,
"notes": [],
"value": 100,
"inputs": {
"cap": null,
"state": "maintained",
"guards": [],
"signals": [],
"red_flag": false,
"multiplier_pct": 100,
"declared_reason": null,
"unverified_reason": null,
"unanswered_open_prs": null,
"unanswered_open_issues": null,
"days_since_last_merged_pr": null,
"days_since_last_human_commit": 1,
"days_since_last_human_commit_is_floor": false
},
"components": [
{
"key": "project_is_still_maintained",
"name": "Project is still maintained",
"detail": "last human commit 1 days ago",
"points": 100,
"status": "met",
"details": [
{
"code": "abandonment_maintained",
"params": {
"days": 1
}
}
],
"max_points": 100
}
]
}
],
"description": "Is the project alive — is code being written and are releases shipping?"
},
{
"key": "community",
"band": "at_risk",
"name": "Community & Adoption",
"value": 43,
"weight": 0.18,
"metrics": [
{
"key": "popularity",
"band": "critical",
"name": "Popularity & adoption",
"note": null,
"notes": [],
"value": 1,
"inputs": {
"forks": 1,
"stars": 0,
"watchers": 0,
"growth_state": "unverified",
"growth_factor_pct": 100,
"growth_unverified_reason": "no_history"
},
"components": [
{
"key": "stars",
"name": "Stars",
"detail": "0 stars",
"points": 0,
"status": "missed",
"details": [
{
"code": "stars",
"params": {
"count": 0
}
}
],
"max_points": 60
},
{
"key": "forks",
"name": "Forks",
"detail": "1 forks",
"points": 0,
"status": "missed",
"details": [
{
"code": "forks",
"params": {
"count": 1
}
}
],
"max_points": 25
},
{
"key": "watchers",
"name": "Watchers",
"detail": "0 watchers",
"points": 0,
"status": "missed",
"details": [
{
"code": "watchers",
"params": {
"count": 0
}
}
],
"max_points": 15
}
]
},
{
"key": "community_health",
"band": "excellent",
"name": "Community health",
"note": null,
"notes": [],
"value": 92,
"inputs": {
"has_readme": true,
"has_license": true,
"has_contributing": true,
"has_issue_template": false,
"has_code_of_conduct": true,
"has_pull_request_template": true
},
"components": [
{
"key": "readme",
"name": "README",
"detail": null,
"points": 22.5,
"status": "met",
"details": [],
"max_points": 22.5
},
{
"key": "license",
"name": "License",
"detail": "recognized license (MIT)",
"points": 22.5,
"status": "met",
"details": [
{
"code": "license_standard",
"params": {}
},
{
"code": "license_spdx",
"params": {
"spdx": "MIT"
}
}
],
"max_points": 22.5
},
{
"key": "contributing_guide",
"name": "CONTRIBUTING guide",
"detail": null,
"points": 18,
"status": "met",
"details": [],
"max_points": 18
},
{
"key": "code_of_conduct",
"name": "Code of conduct",
"detail": null,
"points": 13.5,
"status": "met",
"details": [],
"max_points": 13.5
},
{
"key": "issue_template",
"name": "Issue template",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.2
},
{
"key": "pr_template",
"name": "PR template",
"detail": null,
"points": 6.3,
"status": "met",
"details": [],
"max_points": 6.3
}
]
}
],
"description": "Does the project have users, downloads, attention, and a welcoming setup for contributors?"
},
{
"key": "governance",
"band": "moderate",
"name": "Sustainability & Governance",
"value": 51,
"weight": 0.24,
"metrics": [
{
"key": "maintainer_resilience",
"band": "critical",
"name": "Maintainer resilience (bus factor)",
"note": null,
"notes": [],
"value": 13,
"inputs": {
"bus_factor": 1,
"contributors_sampled": 1,
"top_contributor_share": 1
},
"components": [
{
"key": "bus_factor",
"name": "Bus factor",
"detail": "1 contributor(s) cover half of all commits",
"points": 9,
"status": "partial",
"details": [
{
"code": "bus_factor",
"params": {
"count": 1
}
}
],
"max_points": 54
},
{
"key": "commit_distribution",
"name": "Commit distribution",
"detail": "top contributor authored 100% of commits",
"points": 0,
"status": "missed",
"details": [
{
"code": "top_contributor_share",
"params": {
"share": 100
}
}
],
"max_points": 22.5
},
{
"key": "contributor_breadth",
"name": "Contributor breadth",
"detail": "1 contributors",
"points": 1.4,
"status": "partial",
"details": [
{
"code": "contributors_sampled",
"params": {
"count": 1
}
}
],
"max_points": 13.5
},
{
"key": "openssf_scorecard_contributors",
"name": "OpenSSF Scorecard: Contributors",
"detail": "project has 1 contributing companies or organizations -- score normalized to 3",
"points": 3,
"status": "partial",
"details": [],
"max_points": 10
}
]
},
{
"key": "responsiveness",
"band": "moderate",
"name": "Issue & PR responsiveness",
"note": "Excluded from scoring (no data or not applicable): Issue resolution. Remaining weights renormalized.",
"notes": [
{
"code": "excluded_no_data",
"params": {
"components": [
"issue_resolution"
]
}
},
{
"code": "weights_renormalized",
"params": {}
}
],
"value": 55,
"inputs": {
"merged_prs": 57,
"open_issues": 0,
"closed_issues": 0,
"issue_closed_ratio": null,
"closed_unmerged_prs": 18
},
"components": [
{
"key": "issue_resolution",
"name": "Issue resolution",
"detail": "no issues or no data",
"points": 0,
"status": "excluded",
"details": [
{
"code": "no_issues_or_data",
"params": {}
}
],
"max_points": 46.75
},
{
"key": "pr_acceptance",
"name": "PR acceptance",
"detail": "57/75 decided PRs merged",
"points": 29.1,
"status": "partial",
"details": [
{
"code": "decided_prs_merged",
"params": {
"merged": 57,
"decided": 75
}
}
],
"max_points": 38.25
},
{
"key": "openssf_scorecard_code_review",
"name": "OpenSSF Scorecard: Code-Review",
"detail": "Found 0/13 approved changesets -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 15
}
]
},
{
"key": "stewardship",
"band": "moderate",
"name": "Ownership & stewardship",
"note": "Excluded from scoring (no data or not applicable): Verified domain. Remaining weights renormalized.",
"notes": [
{
"code": "excluded_no_data",
"params": {
"components": [
"verified_domain"
]
}
},
{
"code": "weights_renormalized",
"params": {}
}
],
"value": 53,
"inputs": {
"followers": 9,
"owner_type": "User",
"is_verified": null,
"owner_login": "lumduan",
"public_repos": 72,
"account_age_days": 3919
},
"components": [
{
"key": "ownership_backing",
"name": "Ownership backing",
"detail": "personal (user) account",
"points": 10,
"status": "partial",
"details": [
{
"code": "owner_personal",
"params": {}
}
],
"max_points": 30
},
{
"key": "verified_domain",
"name": "Verified domain",
"detail": "not applicable to user accounts",
"points": 0,
"status": "excluded",
"details": [
{
"code": "not_applicable_to_user_accounts",
"params": {}
}
],
"max_points": 20
},
{
"key": "owner_reach",
"name": "Owner reach",
"detail": "9 followers of lumduan",
"points": 7.2,
"status": "partial",
"details": [
{
"code": "owner_followers",
"params": {
"count": 9,
"login": "lumduan"
}
}
],
"max_points": 25
},
{
"key": "track_record",
"name": "Track record",
"detail": "72 public repos, account ~10 yr old",
"points": 25,
"status": "met",
"details": [
{
"code": "public_repos",
"params": {
"count": 72
}
},
{
"code": "account_age_years",
"params": {
"years": 10
}
}
],
"max_points": 25
}
]
},
{
"key": "package_maintenance",
"band": "excellent",
"name": "Package maintenance",
"note": null,
"notes": [],
"value": 100,
"inputs": {
"packages": [
"settfex"
],
"ecosystems": "pypi",
"any_deprecated": false,
"min_days_since_publish": 1
},
"components": [
{
"key": "published_resolvable",
"name": "Published & resolvable",
"detail": "1 package(s) on pypi",
"points": 25,
"status": "met",
"details": [
{
"code": "packages_published",
"params": {
"count": 1,
"ecosystems": "pypi"
}
}
],
"max_points": 25
},
{
"key": "publish_recency",
"name": "Publish recency",
"detail": "latest publish 1 days ago",
"points": 35,
"status": "met",
"details": [
{
"code": "publish_recency",
"params": {
"days": 1
}
}
],
"max_points": 35
},
{
"key": "version_history",
"name": "Version history",
"detail": "16 published versions",
"points": 20,
"status": "met",
"details": [
{
"code": "published_versions",
"params": {
"count": 16
}
}
],
"max_points": 20
},
{
"key": "not_deprecated",
"name": "Not deprecated",
"detail": "active, not deprecated or yanked",
"points": 20,
"status": "met",
"details": [
{
"code": "package_not_deprecated",
"params": {}
}
],
"max_points": 20
}
]
}
],
"description": "Will the project survive its people — bus factor, responsiveness, who backs it, and package upkeep?"
},
{
"key": "engineering",
"band": "excellent",
"name": "Engineering Quality",
"value": 85,
"weight": 0.2,
"metrics": [
{
"key": "engineering_practices",
"band": "excellent",
"name": "Engineering practices",
"note": null,
"notes": [],
"value": 92,
"inputs": {
"has_ci": true,
"has_tests": true,
"has_editorconfig": true,
"has_linter_config": true,
"has_precommit_config": true
},
"components": [
{
"key": "ci_workflows",
"name": "CI workflows",
"detail": "3 workflow(s)",
"points": 24,
"status": "met",
"details": [
{
"code": "ci_workflows",
"params": {
"count": 3
}
}
],
"max_points": 24
},
{
"key": "tests_present",
"name": "Tests present",
"detail": null,
"points": 24,
"status": "met",
"details": [],
"max_points": 24
},
{
"key": "linter_config",
"name": "Linter config",
"detail": null,
"points": 16,
"status": "met",
"details": [],
"max_points": 16
},
{
"key": "pre_commit_hooks",
"name": "Pre-commit hooks",
"detail": null,
"points": 9.6,
"status": "met",
"details": [],
"max_points": 9.6
},
{
"key": "editorconfig",
"name": ".editorconfig",
"detail": null,
"points": 6.4,
"status": "met",
"details": [],
"max_points": 6.4
},
{
"key": "openssf_scorecard_ci_tests",
"name": "OpenSSF Scorecard: CI-Tests",
"detail": "8 out of 13 merged PRs checked by a CI test -- score normalized to 6",
"points": 12,
"status": "partial",
"details": [],
"max_points": 20
}
]
},
{
"key": "documentation",
"band": "good",
"name": "Documentation",
"note": null,
"notes": [],
"value": 75,
"inputs": {
"topics": [],
"has_wiki": true,
"homepage": null,
"has_readme": true,
"has_docs_dir": true,
"has_description": true
},
"components": [
{
"key": "readme",
"name": "README",
"detail": null,
"points": 30,
"status": "met",
"details": [],
"max_points": 30
},
{
"key": "documentation_directory",
"name": "Documentation directory",
"detail": null,
"points": 25,
"status": "met",
"details": [],
"max_points": 25
},
{
"key": "documentation_homepage_site",
"name": "Documentation / homepage site",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 15
},
{
"key": "repository_description",
"name": "Repository description",
"detail": null,
"points": 10,
"status": "met",
"details": [],
"max_points": 10
},
{
"key": "topics",
"name": "Topics",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 10
},
{
"key": "wiki",
"name": "Wiki",
"detail": null,
"points": 10,
"status": "met",
"details": [],
"max_points": 10
}
]
}
],
"description": "Are baseline engineering and documentation practices in place?"
},
{
"key": "security",
"band": "at_risk",
"name": "Security",
"value": 47,
"weight": 0.16,
"metrics": [
{
"key": "security_posture",
"band": "at_risk",
"name": "Security posture",
"note": null,
"notes": [],
"value": 47,
"inputs": {
"source": "openssf_scorecard",
"checks_evaluated": 18,
"scorecard_version": "v5.5.0",
"checks_inconclusive": 0,
"scorecard_aggregate": 4.7
},
"components": [
{
"key": "binary_artifacts",
"name": "Binary-Artifacts",
"detail": "no binaries found in the repo",
"points": 7.5,
"status": "met",
"details": [],
"max_points": 7.5
},
{
"key": "branch_protection",
"name": "Branch-Protection",
"detail": "branch protection is not maximal on development and all release branches",
"points": 2.2,
"status": "partial",
"details": [],
"max_points": 7.5
},
{
"key": "ci_tests",
"name": "CI-Tests",
"detail": "8 out of 13 merged PRs checked by a CI test -- score normalized to 6",
"points": 1.5,
"status": "partial",
"details": [],
"max_points": 2.5
},
{
"key": "cii_best_practices",
"name": "CII-Best-Practices",
"detail": "no effort to earn an OpenSSF best practices badge detected",
"points": 0,
"status": "missed",
"details": [],
"max_points": 2.5
},
{
"key": "code_review",
"name": "Code-Review",
"detail": "Found 0/13 approved changesets -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.5
},
{
"key": "contributors",
"name": "Contributors",
"detail": "project has 1 contributing companies or organizations -- score normalized to 3",
"points": 0.8,
"status": "partial",
"details": [],
"max_points": 2.5
},
{
"key": "dangerous_workflow",
"name": "Dangerous-Workflow",
"detail": "no dangerous workflow patterns detected",
"points": 10,
"status": "met",
"details": [],
"max_points": 10
},
{
"key": "dependency_update_tool",
"name": "Dependency-Update-Tool",
"detail": "update tool detected",
"points": 7.5,
"status": "met",
"details": [],
"max_points": 7.5
},
{
"key": "fuzzing",
"name": "Fuzzing",
"detail": "project is not fuzzed",
"points": 0,
"status": "missed",
"details": [],
"max_points": 5
},
{
"key": "license",
"name": "License",
"detail": "license file detected",
"points": 2.5,
"status": "met",
"details": [],
"max_points": 2.5
},
{
"key": "maintained",
"name": "Maintained",
"detail": "30 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 10",
"points": 7.5,
"status": "met",
"details": [],
"max_points": 7.5
},
{
"key": "packaging",
"name": "Packaging",
"detail": "packaging workflow detected",
"points": 5,
"status": "met",
"details": [],
"max_points": 5
},
{
"key": "pinned_dependencies",
"name": "Pinned-Dependencies",
"detail": "dependency not pinned by hash detected -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 5
},
{
"key": "sast",
"name": "SAST",
"detail": "SAST tool is not run on all commits -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 5
},
{
"key": "security_policy",
"name": "Security-Policy",
"detail": "security policy file detected",
"points": 5,
"status": "met",
"details": [],
"max_points": 5
},
{
"key": "signed_releases",
"name": "Signed-Releases",
"detail": "Project has not signed or included provenance with any releases.",
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.5
},
{
"key": "token_permissions",
"name": "Token-Permissions",
"detail": "detected GitHub workflow tokens with excessive permissions",
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.5
},
{
"key": "vulnerabilities",
"name": "Vulnerabilities",
"detail": "75 existing vulnerabilities detected",
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.5
}
]
},
{
"key": "high_risk_jurisdiction_exposure",
"band": "excellent",
"name": "High-Risk Jurisdiction Exposure",
"note": "Only high-confidence self-published location evidence affects this multiplier. Ambiguous matches are review-only; country evidence is not proof of nationality, citizenship, legal registration, malicious intent, or sanctions status.",
"notes": [
{
"code": "jurisdiction_evidence_limits",
"params": {}
}
],
"value": 100,
"inputs": {
"meaning": "self-published location evidence; not nationality or citizenship",
"red_flag": false,
"exposures": [],
"policy_countries": [
"Russia",
"Iran",
"North Korea"
],
"review_only_matches": 0,
"assessed_self_published_locations": 2
},
"components": [
{
"key": "policy_exposure_multiplier",
"name": "Policy exposure multiplier",
"detail": "no confirmed policy-scope location match",
"points": 100,
"status": "met",
"details": [
{
"code": "jurisdiction_no_match",
"params": {}
}
],
"max_points": 100
}
]
}
],
"description": "Are visible security and supply-chain practices strong, with no malicious dependency and no unresolved high-risk jurisdiction exposure?"
},
{
"key": "ai_readiness",
"band": "good",
"name": "AI Readiness",
"value": 71,
"weight": 0,
"metrics": [
{
"key": "ai_agent_context",
"band": "excellent",
"name": "Agent context & guidance",
"note": null,
"notes": [],
"value": 85,
"inputs": {
"has_llms_txt": false,
"legible_history_share": 0.99,
"agent_instruction_files": [
".github/instructions/core-architectrual-principles.instructions.md",
".github/instructions/documentation-standards.instructions.md",
".github/instructions/file-organization.instructions.md",
".github/instructions/git-commit.instructions.md",
".github/instructions/python-dependency-management.instructions.md",
"CLAUDE.md"
],
"agent_instruction_max_bytes": 20891
},
"components": [
{
"key": "agent_instructions",
"name": "Agent instructions",
"detail": ".github/instructions/core-architectrual-principles.instructions.md, .github/instructions/documentation-standards.instructions.md, .github/instructions/file-organization.instructions.md, .github/instructions/git-commit.instructions.md, .github/instructions/python-dependency-management.instructions.md, CLAUDE.md",
"points": 45,
"status": "met",
"details": [
{
"code": "file_list",
"params": {
"files": ".github/instructions/core-architectrual-principles.instructions.md, .github/instructions/documentation-standards.instructions.md, .github/instructions/file-organization.instructions.md, .github/instructions/git-commit.instructions.md, .github/instructions/python-dependency-management.instructions.md, CLAUDE.md"
}
}
],
"max_points": 45
},
{
"key": "machine_readable_docs_llms_txt",
"name": "Machine-readable docs (llms.txt)",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 15
},
{
"key": "legible_commit_history",
"name": "Legible commit history",
"detail": "99 of 100 human commits state their intent (structured subject or explanatory body)",
"points": 40,
"status": "met",
"details": [
{
"code": "legible_history",
"params": {
"legible": 99,
"sampled": 100
}
}
],
"max_points": 40
}
]
},
{
"key": "ai_verify_loop",
"band": "moderate",
"name": "Verify loop (build / test / typecheck)",
"note": null,
"notes": [],
"value": 69,
"inputs": {
"has_nix": false,
"has_tests": true,
"lockfiles": [
"uv.lock"
],
"has_dockerfile": false,
"typed_language": false,
"bootstrap_files": [],
"has_devcontainer": false,
"has_linter_config": true,
"typecheck_configs": [
"settfex/py.typed"
],
"agent_commit_share": 0.59,
"toolchain_manifests": [],
"dependency_bot_commit_share": 0
},
"components": [
{
"key": "one_command_bootstrap",
"name": "One-command bootstrap",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 18
},
{
"key": "automated_tests",
"name": "Automated tests",
"detail": null,
"points": 22,
"status": "met",
"details": [],
"max_points": 22
},
{
"key": "lint_format_config",
"name": "Lint / format config",
"detail": null,
"points": 11,
"status": "met",
"details": [],
"max_points": 11
},
{
"key": "static_type_checking",
"name": "Static type checking",
"detail": "settfex/py.typed",
"points": 11,
"status": "met",
"details": [
{
"code": "file_list",
"params": {
"files": "settfex/py.typed"
}
}
],
"max_points": 11
},
{
"key": "reproducible_environment",
"name": "Reproducible environment",
"detail": "lockfile",
"points": 10,
"status": "met",
"details": [
{
"code": "file_list",
"params": {
"files": "lockfile"
}
}
],
"max_points": 10
},
{
"key": "demonstrated_agent_practice",
"name": "Demonstrated agent practice",
"detail": "59 of the last 100 commits agent-authored or agent-credited",
"points": 10,
"status": "met",
"details": [
{
"code": "agent_authored_commits",
"params": {
"count": 59,
"sampled": 100
}
}
],
"max_points": 10
},
{
"key": "automated_maintenance",
"name": "Automated maintenance",
"detail": "dependency automation configured, none observed in the sampled commits",
"points": 5,
"status": "partial",
"details": [
{
"code": "dependency_bot_config_only",
"params": {}
}
],
"max_points": 8
},
{
"key": "openssf_scorecard_pinned_dependencies",
"name": "OpenSSF Scorecard: Pinned-Dependencies",
"detail": "dependency not pinned by hash detected -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 10
}
]
},
{
"key": "ai_code_legibility",
"band": "good",
"name": "Code legibility for models",
"note": null,
"notes": [],
"value": 82,
"inputs": {
"primary_language": "Python",
"largest_source_bytes": 47064,
"source_files_sampled": 100,
"oversized_source_files": 0
},
"components": [
{
"key": "type_checkable_code",
"name": "Type-checkable code",
"detail": "Python with type-check config (settfex/py.typed)",
"points": 27,
"status": "partial",
"details": [
{
"code": "typecheck_config_language",
"params": {
"files": "settfex/py.typed",
"language": "Python"
}
}
],
"max_points": 45
},
{
"key": "manageable_file_sizes",
"name": "Manageable file sizes",
"detail": "0/100 source files over 60KB",
"points": 55,
"status": "met",
"details": [
{
"code": "oversized_source_files",
"params": {
"kb": 60,
"sampled": 100,
"oversized": 0
}
}
],
"max_points": 55
}
]
},
{
"key": "ai_interfaces",
"band": "at_risk",
"name": "Machine-readable interfaces",
"note": null,
"notes": [],
"value": 40,
"inputs": {
"example_dirs": [
"examples",
"notebooks"
],
"has_mcp_signal": false,
"api_schema_files": []
},
"components": [
{
"key": "api_schema_openapi_graphql_proto",
"name": "API schema (OpenAPI/GraphQL/proto)",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 40
},
{
"key": "mcp_server",
"name": "MCP server",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 20
},
{
"key": "runnable_examples",
"name": "Runnable examples",
"detail": "examples, notebooks",
"points": 40,
"status": "met",
"details": [
{
"code": "file_list",
"params": {
"files": "examples, notebooks"
}
}
],
"max_points": 40
}
]
}
],
"description": "How well is the repo equipped to be developed and maintained with AI coding agents? An independent, experimental badge — weight 0.0, so it is surfaced on its own and does not affect the overall health score."
}
],
"metrics_version": "1.13.0"
},
"warnings": [
"GitHub dependency-graph SBOM unavailable (404); the dependency graph may be disabled for this repository",
"deps.dev does not index pypi:settfex@0.14.0; advisories assessed against the repository dependency graph instead"
],
"report_type": "repository",
"generated_at": "2026-07-22T03:25:08.363191Z",
"schema_version": "0.26.0",
"badge_url": "https://raw.githubusercontent.com/inspect-software/badges/main/v1/l/lumduan/settfex.svg",
"full_name": "lumduan/settfex",
"license_state": "standard",
"license_spdx": "MIT"
}