Public recordModerate
Software health reportschema 0.27.0 · metrics 1.13.0 · 2026-07-24 06:33 UTC
twjackysu / TWSEMCPServer
台灣證交所OpenAPI 的 MCP Server 同時整合部分即時報價和櫃檯買賣中心TPEx OpenAPI, 臺灣期貨交易所TAIFEX OpenAPI
twjackysu/TWSEMCPServer holds a health index of 59 out of 100, placing it in the Moderate band. It scores highest on Vitality (89/100) and lowest on Security (46/100). It was last updated 3 days ago. A single contributor accounts for most of its recent work.
59
overall / 100Software health index
Metrics are grouped into weighted categories on one standardized 1–100 scale. Overall starts as their weighted mean; when public evidence triggers the High-Risk Jurisdiction Policy, the rating is adjusted and receives an At risk ceiling of 49. AI Readiness sits outside the overall score.
59
Excellent85-100Exemplary; meets essentially all checked criteria
Good70-84Healthy; minor gaps
Moderate50-69Acceptable with notable gaps; review recommended
At risk30-49Significant weaknesses; adoption warrants caution
Critical1-29Severe problems (abandoned, single-maintainer, no hygiene)
Score profile
Each axis is a category. The shape matters more than the average — a healthy subject fills the whole shape, while a spike-and-crater profile means strength in one dimension is masking risk in another.
Ownership
Jacky SuPersonal account
13 followers32 public repossince Jun 2017
This repository is owned by a personal account. A single-owner project carries more continuity risk than an organization-backed one.
Metrics by category
Vitality
Is the project alive — is code being written and are releases shipping?
89
Development activity
81Good
How it's scored
| 36/36 | Push recency — last push 3 days ago |
| 16.6/36 | Commit cadence — 24/52 weeks with commits |
| 18/18 | Commit volume — 155 commits in the last year |
| 10/10 | OpenSSF Scorecard: Maintained — 30 commit(s) and 3 issue activity found in the last 90 days -- score normalized to 10 |
Inputs used
| commits_last_year | 155 |
| human_commit_share | 1 |
| days_since_last_push | 3 |
| active_weeks_last_year | 24 |
Release discipline
100Excellent
How it's scored
| 27/27 | Ships releases — 13 releases published |
| 36/36 | Release recency — latest release 4 days ago |
| 27/27 | Release cadence — a release every ~9.3 days |
| 0/10 | OpenSSF Scorecard: Signed-Releases — no data |
Inputs used
| releases_count | 13 |
| latest_release_tag | v1.8.0 |
| releases_from_tags | no |
| days_since_latest_release | 4 |
| mean_days_between_releases | 9.3 |
Excluded from scoring (no data or not applicable): OpenSSF Scorecard: Signed-Releases. Remaining weights renormalized.
Community & Adoption
Does the project have users, downloads, attention, and a welcoming setup for contributors?
48
Popularity & adoption
47At risk
How it's scored
| 34.4/60 | Stars — 133 stars |
| 13/25 | Forks — 37 forks |
| 0/15 | Watchers — 0 watchers |
Inputs used
| forks | 37 |
| stars | 133 |
| watchers | 0 |
| growth_state | unverified |
| growth_factor_pct | 100 |
| growth_unverified_reason | no_history |
Community health
50Moderate
How it's scored
| 22.5/22.5 | README |
| 22.5/22.5 | License — recognized license (MIT) |
| 0/18 | CONTRIBUTING guide |
| 0/13.5 | Code of conduct |
| 0/7.2 | Issue template |
| 0/6.3 | PR template |
Inputs used
| has_readme | yes |
| has_license | yes |
| has_contributing | no |
| has_issue_template | no |
| has_code_of_conduct | no |
| has_pull_request_template | no |
Sustainability & Governance
Will the project survive its people — bus factor, responsiveness, who backs it, and package upkeep?
47
Maintainer resilience (bus factor)
15Critical
How it's scored
| 9/54 | Bus factor — 1 contributor(s) cover half of all commits |
| 1/22.5 | Commit distribution — top contributor authored 96% of commits |
| 5.4/13.5 | Contributor breadth — 4 contributors |
| 0/10 | OpenSSF Scorecard: Contributors — project has 0 contributing companies or organizations -- score normalized to 0 |
Inputs used
| bus_factor | 1 |
| contributors_sampled | 4 |
| top_contributor_share | 0.957 |
How it's scored
| 44.5/46.8 | Issue resolution — 95% of issues closed |
| 36.3/38.3 | PR acceptance — 37/39 decided PRs merged |
| 0/15 | OpenSSF Scorecard: Code-Review — Found 1/13 approved changesets -- score normalized to 0 |
Inputs used
| merged_prs | 37 |
| open_issues | 1 |
| closed_issues | 20 |
| issue_closed_ratio | 0.952 |
| closed_unmerged_prs | 2 |
Ownership & stewardship
52Moderate
How it's scored
| 10/30 | Ownership backing — personal (user) account |
| 0/20 | Verified domain — not applicable to user accounts |
| 8.2/25 | Owner reach — 13 followers of twjackysu |
| 23.1/25 | Track record — 32 public repos, account ~9 yr old |
Inputs used
| followers | 13 |
| owner_type | User |
| is_verified | — |
| owner_login | twjackysu |
| public_repos | 32 |
| account_age_days | 3,318 |
Excluded from scoring (no data or not applicable): Verified domain. Remaining weights renormalized.
Engineering Quality
Are baseline engineering and documentation practices in place?
61
Engineering practices
68Moderate
How it's scored
| 24/24 | CI workflows — 2 workflow(s) |
| 24/24 | Tests present |
| 0/16 | Linter config |
| 0/9.6 | Pre-commit hooks |
| 0/6.4 | .editorconfig |
| 20/20 | OpenSSF Scorecard: CI-Tests — 13 out of 13 merged PRs checked by a CI test -- score normalized to 10 |
Inputs used
| has_ci | yes |
| has_tests | yes |
| has_editorconfig | no |
| has_linter_config | no |
| has_precommit_config | no |
Documentation
50Moderate
How it's scored
| 30/30 | README |
| 0/25 | Documentation directory |
| 0/15 | Documentation / homepage site |
| 10/10 | Repository description |
| 10/10 | Topics — 5 topics |
| 0/10 | Wiki |
Inputs used
| topics | analysis, mcp, mcp-server, questions-and-answers, trading |
| has_wiki | no |
| homepage | — |
| has_readme | yes |
| has_docs_dir | no |
| has_description | yes |
Security
Are visible security and supply-chain practices strong, without unresolved high-risk jurisdiction exposure?
46
Security posture
46At risk
How it's scored
| 7.5/7.5 | Binary-Artifacts — no binaries found in the repo |
| 0/7.5 | Branch-Protection — no data |
| 2.5/2.5 | CI-Tests — 13 out of 13 merged PRs checked by a CI test -- score normalized to 10 |
| 0/2.5 | CII-Best-Practices — no effort to earn an OpenSSF best practices badge detected |
| 0/7.5 | Code-Review — Found 1/13 approved changesets -- score normalized to 0 |
| 0/2.5 | Contributors — project has 0 contributing companies or organizations -- score normalized to 0 |
| 10/10 | Dangerous-Workflow — no dangerous workflow patterns detected |
| 0/7.5 | Dependency-Update-Tool — no update tool detected |
| 0/5 | Fuzzing — project is not fuzzed |
| 2.5/2.5 | License — license file detected |
| 7.5/7.5 | Maintained — 30 commit(s) and 3 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 |
| 0/5 | Security-Policy — security policy file not detected |
| 0/7.5 | Signed-Releases — no data |
| 6.8/7.5 | Token-Permissions — detected GitHub workflow tokens with excessive permissions |
| 0/7.5 | Vulnerabilities — 47 existing vulnerabilities detected |
Inputs used
| source | openssf_scorecard |
| checks_evaluated | 16 |
| scorecard_version | v5.5.0 |
| checks_inconclusive | 2 |
| scorecard_aggregate | 4.6 |
Excluded from scoring (no data or not applicable): branch_protection, signed_releases. Remaining weights renormalized.
Dependency advisories
45At risk
How it's scored
| 5.3/35 | Direct dependencies free of known advisories — 3 affected: fastmcp 2.12.3 (critical 10.0), mcp 1.27.0 (high 7.6), requests 2.32.4 (moderate 5.5) |
| 0/25 | Indirect dependencies free of known advisories — transitive set not separable from development and test dependencies in this scope |
| 28.8/40 | No advisories left outstanding — 2 advisory-carrying package(s) unaddressed past 90 days; oldest published 267 days ago |
Inputs used
| source | osv |
| advisories | 87 |
| affected_packages | 15 |
| assessed_packages | 76 |
| unassessed_packages | 5 |
| affected_by_severity | critical 2, high 7, moderate 5, low 1 |
| direct_affected_packages | 3 |
Excluded from scoring (no data or not applicable): Indirect dependencies free of known advisories. Remaining weights renormalized. Matched 76 resolved dependencies against OSV. 5 could not be assessed — no resolved version, an unsupported ecosystem, or beyond the reported package list. This repository publishes no package the index resolves, so the repository dependency graph was assessed instead. That graph mixes development and test pins with shipped dependencies, so only the declared runtime dependencies are scored; transitive findings are reported as context and excluded from the score. Reachability is not analyzed.
AI Readiness
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.
54
Agent context & guidance
85Excellent
How it's scored
| 45/45 | Agent instructions — CLAUDE.md |
| 0/15 | Machine-readable docs (llms.txt) |
| 40/40 | Legible commit history — 97 of 100 human commits state their intent (structured subject or explanatory body) |
Inputs used
| has_llms_txt | no |
| legible_history_share | 0.97 |
| agent_instruction_files | CLAUDE.md |
| agent_instruction_max_bytes | 12,651 |
How it's scored
| 0/18 | One-command bootstrap |
| 22/22 | Automated tests |
| 0/11 | Lint / format config |
| 0/11 | Static type checking |
| 10/10 | Reproducible environment — Dockerfile, lockfile |
| 10/10 | Demonstrated agent practice — 7 of the last 100 commits agent-authored or agent-credited |
| 0/8 | Automated maintenance — no automated dependency updates observed |
| 0/10 | OpenSSF Scorecard: Pinned-Dependencies — dependency not pinned by hash detected -- score normalized to 0 |
Inputs used
| has_nix | no |
| has_tests | yes |
| lockfiles | uv.lock |
| has_dockerfile | yes |
| typed_language | no |
| bootstrap_files | — |
| has_devcontainer | no |
| has_linter_config | no |
| typecheck_configs | — |
| agent_commit_share | 0.07 |
| toolchain_manifests | — |
| dependency_bot_commit_share | 0 |
Code legibility for models
55Moderate
How it's scored
| 0/45 | Type-checkable code — Python without a type-check config |
| 55/55 | Manageable file sizes — 0/103 source files over 60KB |
Inputs used
| primary_language | Python |
| largest_source_bytes | 20,862 |
| source_files_sampled | 103 |
| oversized_source_files | 0 |
Machine-readable interfaces
20Critical
How it's scored
| 0/40 | API schema (OpenAPI/GraphQL/proto) |
| 20/20 | MCP server |
| 0/40 | Runnable examples |
Inputs used
| example_dirs | — |
| has_mcp_signal | yes |
| api_schema_files | — |
Key facts
133GitHub stars
4contributors
155commits, last 12 months
3days since last push
13releases
1bus factor
1open issues
PyPIpackage ecosystems
Data collection warnings
- Star history unavailable: GitHub GraphQL error: Resource not accessible by personal access token
- Could not fetch pypi package 'twstockmcpserver' from its registry
More detail
Star and fork history 0 ★ / 37 ⇿
0Stars
37Forks
9Releases
When each star and fork was added, collected from GitHub and bucketed by day. Cumulative growth sits directly above the daily additions it is made of, so the two read against each other: steady organic accretion looks nothing like an abrupt, short-lived burst. Where that difference is measurable, it is reported as growth authenticity.
Major 1Minor 4Patch 4
OpenSSF Scorecard 4.6 / 10
4.6aggregate
Independent, tool-agnostic security assessment from the open-source OpenSSF Scorecard. Each check rewards a security practice, not a specific vendor's tool. Checks Scorecard could not determine are marked n/a and excluded from the security score (never counted as zero).
| 10 | Binary-Artifacts | no binaries found in the repo |
| n/a | Branch-Protection | internal error: error during branchesHandler.setup: internal error: some github tokens can't read classic branch protection rules: https://github.com/ossf/scorecard-action/blob/main/docs/authentication/fine-grained-auth-token.md |
| 10 | CI-Tests | 13 out of 13 merged PRs checked by a CI test -- score normalized to 10 |
| 0 | CII-Best-Practices | no effort to earn an OpenSSF best practices badge detected |
| 0 | Code-Review | Found 1/13 approved changesets -- score normalized to 0 |
| 0 | Contributors | project has 0 contributing companies or organizations -- score normalized to 0 |
| 10 | Dangerous-Workflow | no dangerous workflow patterns detected |
| 0 | Dependency-Update-Tool | no update tool detected |
| 0 | Fuzzing | project is not fuzzed |
| 10 | License | license file detected |
| 10 | Maintained | 30 commit(s) and 3 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 |
| 0 | Security-Policy | security policy file not detected |
| n/a | Signed-Releases | no releases found |
| 9 | Token-Permissions | detected GitHub workflow tokens with excessive permissions |
| 0 | Vulnerabilities | 47 existing vulnerabilities detected |
Direct dependencies 4
| Registry | Package | Version constraint | Manifest |
|---|---|---|---|
| PyPI | fastmcp | ==2.12.3 | pyproject.toml |
| PyPI | httpx | >=0.28.1 | pyproject.toml |
| PyPI | mcp | >=1.9.3 | pyproject.toml |
| PyPI | requests | >=2.32.4 | pyproject.toml |
All dependencies 81
Full resolved dependency set from the GitHub dependency graph: 5 direct and 76 indirect (transitive) packages. The transitive closure is complete when the repository commits a lockfile.
| Registry | Package | Version | Relation |
|---|---|---|---|
| PyPI | fastmcp | 2.12.3 | direct |
| PyPI | httpx | 0.28.1 | direct |
| PyPI | mcp | — | direct |
| PyPI | mcp | 1.27.0 | direct |
| PyPI | requests | 2.32.4 | direct |
| PyPI | annotated-types | 0.7.0 | indirect |
| PyPI | anyio | 4.9.0 | indirect |
| PyPI | attrs | 25.3.0 | indirect |
| PyPI | authlib | 1.7.0 | indirect |
| PyPI | certifi | 2025.7.14 | indirect |
| PyPI | cffi | 1.17.1 | indirect |
| PyPI | charset-normalizer | 3.4.2 | indirect |
| PyPI | click | 8.2.2 | indirect |
| PyPI | colorama | 0.4.6 | indirect |
| PyPI | coverage | 7.11.0 | indirect |
| PyPI | cryptography | 45.0.5 | indirect |
| PyPI | cyclopts | 4.11.0 | indirect |
| PyPI | dnspython | 2.7.0 | indirect |
| PyPI | docstring-parser | 0.17.0 | indirect |
| PyPI | docutils | 0.22 | indirect |
| PyPI | email-validator | 2.2.0 | indirect |
| PyPI | exceptiongroup | 1.3.0 | indirect |
| PyPI | h11 | 0.16.0 | indirect |
| PyPI | httpcore | 1.0.9 | indirect |
| PyPI | httpx-sse | 0.4.1 | indirect |
| PyPI | idna | 3.10 | indirect |
| PyPI | iniconfig | 2.1.0 | indirect |
| PyPI | isodate | 0.7.2 | indirect |
| PyPI | joserfc | 1.6.4 | indirect |
| PyPI | jsonschema | 4.25.0 | indirect |
| PyPI | jsonschema-path | 0.4.5 | indirect |
| PyPI | jsonschema-specifications | 2025.4.1 | indirect |
| PyPI | lazy-object-proxy | 1.12.0 | indirect |
| PyPI | markdown-it-py | 3.0.0 | indirect |
| PyPI | markupsafe | 3.0.3 | indirect |
| PyPI | mdurl | 0.1.2 | indirect |
| PyPI | more-itertools | 10.7.0 | indirect |
| PyPI | openapi-core | 0.23.1 | indirect |
| PyPI | openapi-pydantic | 0.5.1 | indirect |
| PyPI | openapi-schema-validator | 0.8.1 | indirect |
| PyPI | openapi-spec-validator | 0.8.5 | indirect |
| PyPI | packaging | 25.0 | indirect |
| PyPI | pathable | 0.5.0 | indirect |
| PyPI | pluggy | 1.6.0 | indirect |
| PyPI | pycparser | 2.22 | indirect |
| PyPI | pydantic | 2.11.7 | indirect |
| PyPI | pydantic-core | 2.33.2 | indirect |
| PyPI | pydantic-settings | 2.10.1 | indirect |
| PyPI | pygments | 2.19.2 | indirect |
| PyPI | pyjwt | 2.12.1 | indirect |
| PyPI | pyperclip | 1.9.0 | indirect |
| PyPI | pytest | — | indirect |
| PyPI | pytest | 8.4.2 | indirect |
| PyPI | pytest-asyncio | — | indirect |
| PyPI | pytest-asyncio | 1.2.0 | indirect |
| PyPI | pytest-cov | — | indirect |
| PyPI | pytest-cov | 7.0.0 | indirect |
| PyPI | pytest-mock | — | indirect |
| PyPI | pytest-mock | 3.15.1 | indirect |
| PyPI | pytest-rerunfailures | 16.2 | indirect |
| PyPI | python-dotenv | 1.1.1 | indirect |
| PyPI | python-multipart | 0.0.20 | indirect |
| PyPI | pywin32 | 311 | indirect |
| PyPI | pyyaml | 6.0.2 | indirect |
| PyPI | referencing | 0.37.0 | indirect |
| PyPI | rfc3339-validator | 0.1.4 | indirect |
| PyPI | rich | 14.1.0 | indirect |
| PyPI | rich-rst | 1.3.1 | indirect |
| PyPI | rpds-py | 0.26.0 | indirect |
| PyPI | shellingham | 1.5.4 | indirect |
| PyPI | six | 1.17.0 | indirect |
| PyPI | sniffio | 1.3.1 | indirect |
| PyPI | sse-starlette | 3.0.2 | indirect |
| PyPI | starlette | 0.47.2 | indirect |
| PyPI | twstockmcpserver | 0.1.0 | indirect |
| PyPI | typer | 0.16.0 | indirect |
| PyPI | typing-extensions | 4.15.0 | indirect |
| PyPI | typing-inspection | 0.4.1 | indirect |
| PyPI | urllib3 | 2.5.0 | indirect |
| PyPI | uvicorn | 0.35.0 | indirect |
| PyPI | werkzeug | 3.1.8 | indirect |
Dependency advisories 15
This repository publishes no package the index resolves, so its own dependency graph was assessed — 76 packages, which also include development and test pins that never ship: 15 carry known advisories, of which 3 are direct. 5 could not be assessed — no resolved version, an unsupported ecosystem, or beyond the reported package list.
| Package | Version | Relation | Severity | Advisories | Fixed in |
|---|---|---|---|---|---|
| fastmcp | 2.12.3 | direct | critical | 14 | 3.2.0 |
| cryptography | 45.0.5 | indirect | critical | 7 | 48.0.1 |
| mcp | 1.27.0 | direct | high | 6 | 1.28.1 |
| click | 8.2.2 | indirect | high | 1 | 8.3.3 |
| joserfc | 1.6.4 | indirect | high | 4 | 1.6.8 |
| pyjwt | 2.12.1 | indirect | high | 9 | 2.13.0 |
| python-multipart | 0.0.20 | indirect | high | 14 | 0.0.31 |
| starlette | 0.47.2 | indirect | high | 12 | 1.3.1 |
| urllib3 | 2.5.0 | indirect | high | 8 | 2.7.0 |
| requests | 2.32.4 | direct | moderate | 2 | 2.33.0 |
| authlib | 1.7.0 | indirect | moderate | 2 | 1.7.1 |
| idna | 3.10 | indirect | moderate | 2 | 3.15 |
| pytest | 8.4.2 | indirect | moderate | 2 | 9.0.3 |
| python-dotenv | 1.1.1 | indirect | moderate | 2 | 1.2.2 |
| pygments | 2.19.2 | indirect | low | 2 | 2.20.0 |
An advisory means the version recorded in the dependency graph falls inside an advisory’s affected range. Reachability is not analysed, and the graph includes development and test pins — a finding may concern tooling rather than shipped software.
Raw JSON report machine-readable
{
"data": {
"repo": {
"topics": [
"analysis",
"mcp",
"mcp-server",
"questions-and-answers",
"trading"
],
"is_fork": false,
"size_kb": 47154,
"has_wiki": false,
"homepage": null,
"languages": {
"Python": 393856,
"Dockerfile": 795
},
"pushed_at": "2026-07-21T00:35:32Z",
"created_at": "2025-06-09T16:24:03Z",
"owner_type": "User",
"updated_at": "2026-07-23T07:46:27Z",
"description": "台灣證交所OpenAPI 的 MCP Server 同時整合部分即時報價和櫃檯買賣中心TPEx OpenAPI, 臺灣期貨交易所TAIFEX OpenAPI",
"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://jackyai.azurewebsites.net",
"name": "Jacky Su",
"type": "User",
"login": "twjackysu",
"company": null,
"location": "Taiwan",
"followers": 13,
"avatar_url": "https://avatars.githubusercontent.com/u/29649008?v=4",
"created_at": "2017-06-23T05:38:41Z",
"is_verified": null,
"public_repos": 32,
"account_age_days": 3318
},
"license": {
"state": "standard",
"spdx_id": "MIT",
"raw_spdx": "MIT",
"file_present": true,
"scorecard_found": true,
"profile_has_license": true
},
"activity": {
"releases": [
{
"tag": "v1.8.0",
"kind": "minor",
"published_at": "2026-07-19T12:18:13Z"
},
{
"tag": "v1.7.0",
"kind": "minor",
"published_at": "2026-07-18T06:47:59Z"
},
{
"tag": "v1.6.0",
"kind": "minor",
"published_at": "2026-07-18T06:12:39Z"
},
{
"tag": "v1.5.0",
"kind": "minor",
"published_at": "2026-07-17T23:52:51Z"
},
{
"tag": "v1.4.0",
"kind": "minor",
"published_at": "2026-06-28T02:37:04Z"
},
{
"tag": "v1.3.0",
"kind": "minor",
"published_at": "2026-05-22T11:48:13Z"
},
{
"tag": "v1.2.2",
"kind": "patch",
"published_at": "2026-05-21T16:05:16Z"
},
{
"tag": "v1.2.1",
"kind": "patch",
"published_at": "2026-05-20T16:29:39Z"
},
{
"tag": "v1.2.0",
"kind": "minor",
"published_at": "2026-05-07T12:16:25Z"
},
{
"tag": "v1.1.0",
"kind": "minor",
"published_at": "2026-04-26T10:58:18Z"
},
{
"tag": "v1.0.2",
"kind": "patch",
"published_at": "2026-04-12T11:16:58Z"
},
{
"tag": "v1.0.1",
"kind": "patch",
"published_at": "2026-04-12T03:41:30Z"
},
{
"tag": "v1.0.0",
"kind": "major",
"published_at": "2026-04-12T03:32:11Z"
}
],
"recent_commits": [
{
"oid": "f23059db3fa25e7b28fbe13489faa244d3fed51f",
"body": "…ng-and-missing-import\n\nfix: restore missing 'import requests' and handle ChunkedEncodingError in fetch_or_skip",
"is_bot": false,
"headline": "Merge pull request #60 from twjackysu/fix/test-helpers-chunked-encodi…",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-07-21T00:35:32Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "dba2fd8082acaa3a7abe6656f09e75fdd12ae978",
"body": "…r in fetch_or_skip\n\nTwo independent test failures from the latest full-suite run:\n\n1. tests/e2e/test_taifex_new_api.py::TestLargeTradersOIFuturesAPI errored\n with NameError: name 'requests' is not defined. #38 removed this\n file's top-level `import requests` (its own _fetch() no longer needed\n \n[…]\nipped.\n\nVerified all three branches (empty-body skip, non-empty-body raise,\nChunkedEncodingError skip) with mocked TWSEAPIClient.fetch_json calls.\nRan the full e2e suite: 66 passed, 0 failures/errors.",
"is_bot": false,
"headline": "fix: restore missing 'import requests' and handle ChunkedEncodingErro…",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-07-21T00:32:38Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "554b5120422738a2178b1adb549f3dbfa40f9a2c",
"body": "Use shared upstream skip helper for TAIFEX E2E tests",
"is_bot": false,
"headline": "Merge pull request #38 from ebbsanchez/codex/taifex-e2e-fetch-or-skip",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-07-19T12:32:46Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "1033570388c419de7f0069362a4e30b659ea2219",
"body": "feat: add TAIFEX Tier 2 historical-data tools (3 new tools)",
"is_bot": false,
"headline": "Merge pull request #57 from twjackysu/feat/taifex-tier2-history-tools",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-07-18T07:35:31Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "7e5b58a024722f7998c6ac1315691f5878c8d932",
"body": null,
"is_bot": false,
"headline": "Merge branch 'main' into feat/taifex-tier2-history-tools",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-07-18T07:35:09Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "9ddf9fa06084a6e5936367af8eed027b6c7fd5ff",
"body": "feat: add TWSE Tier 2 historical-data tools (5 new tools)",
"is_bot": false,
"headline": "Merge pull request #56 from twjackysu/feat/twse-tier2-history-tools",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-07-18T07:34:23Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "10d4fc109a3666d27e20069edc692f60021bb147",
"body": "NEW_TOOLS_PLAN.md Tier 2, TAIFEX half (#11-#13), completing Tier 2\nalongside #56's TWSE half.\n\nNew tools:\n- get_institutional_total_history — 三大法人期貨+選擇權合計總表history\n (totalTableDateDown). openapi.taifex.com.tw's get_institutional_general\n only returns the latest day; this has no span cap observed u\n[…]\ning\ncolumn order/shape. Updated CLAUDE.md/AGENTS.md/README (both languages)\ntool counts (TAIFEX website-download tools: 6 -> 9) and marked all of\nNEW_TOOLS_PLAN.md's Tier 1 + Tier 2 progress complete.",
"is_bot": false,
"headline": "feat: add TAIFEX Tier 2 historical-data tools (3 new tools)",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-07-18T07:05:33Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "75757638f2d6d96f3e0c32630d005b365926f72e",
"body": "NEW_TOOLS_PLAN.md Tier 2, TWSE half (#10, #14, #15 — #15 split into two\ntools since balance and same-day trades are different questions).\n\nNew tools:\n- get_stock_monthly_history / get_stock_yearly_history — per-stock\n monthly (FMSRFK) and yearly (FMNPTK) turnover summaries. FMNPTK uses\n a `tables`\n[…]\nrepo's \"legacy exchangeReport\" test\nconvention. Updated CLAUDE.md/AGENTS.md/README (both languages) tool\ncounts (11 -> 16 for TWSE Web API) and checked off Tier 1 in\nNEW_TOOLS_PLAN.md's progress list.",
"is_bot": false,
"headline": "feat: add TWSE Tier 2 historical-data tools (5 new tools)",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-07-18T06:58:51Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "9438dcaf18aac436ce2b76f8af739e441aaad52c",
"body": "docs: add plan for TWSE/TAIFEX historical-data tool gaps",
"is_bot": false,
"headline": "Merge pull request #52 from twjackysu/docs/add-new-tools-plan",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-07-18T06:48:28Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "079900505d8653156e0b250897ab538fb21994d9",
"body": "…v-fallback\n\nfix: tolerate CSV response from OpenInterestOfLargeTradersFutures",
"is_bot": false,
"headline": "Merge pull request #55 from twjackysu/fix/large-traders-futures-oi-cs…",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-07-18T06:46:43Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "08ffc75b3459c7e4a203487d84c4f450147eb48e",
"body": "As of 2026-07, openapi.taifex.com.tw's OpenInterestOfLargeTradersFutures\nendpoint started returning CSV instead of its documented JSON — confirmed\ngenuine upstream regression via direct curl with an explicit\nAccept: application/json header (no difference), and confirmed isolated\nto this one endpoint\n[…]\nred the same fallback in the test file's fixture so\ntest_hardcoded_fields_exist keeps validating the fields the tool\nactually depends on regardless of which format the API happens to be\nserving today.",
"is_bot": false,
"headline": "fix: tolerate CSV response from OpenInterestOfLargeTradersFutures",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-07-18T06:43:17Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "a436df2593eced1d7641cbc85b29d0d976abb12c",
"body": "feat: add TAIFEX Tier 1 historical-data tools (4 new tools)",
"is_bot": false,
"headline": "Merge pull request #54 from twjackysu/feat/taifex-tier1-history-tools",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-07-18T06:38:45Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "7ce154be4c941236aa9cf2ccca0965320b98b4db",
"body": "NEW_TOOLS_PLAN.md Tier 1 (TAIFEX half, completing #53's TWSE half). All\n4 hit www.taifex.com.tw/cht/3/*Down HTML-form download endpoints, which\naccept arbitrary date ranges unlike their openapi.taifex.com.tw\ncounterparts (latest-day-only, verified in #49).\n\nNew tools:\n- get_put_call_ratio_history — \n[…]\ny::TestLargeTradersOIFuturesAPI. Confirmed\nvia direct curl with the correct Accept header — genuine upstream\nchange, not caused by anything in this PR. Not fixed here; flagging for\nseparate follow-up.",
"is_bot": false,
"headline": "feat: add TAIFEX Tier 1 historical-data tools (4 new tools)",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-07-18T06:27:18Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "c8fffcf5780951caef574ec5abd60349da692f73",
"body": "feat: add TWSE Tier 1 historical-data tools (5 new tools)",
"is_bot": false,
"headline": "Merge pull request #53 from twjackysu/feat/twse-tier1-history-tools",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-07-18T06:11:25Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "2c31ce649cd5cd9374e45343540e153b35d5b97a",
"body": null,
"is_bot": false,
"headline": "docs: update TWSE Web API tool count (6 -> 11) for Tier 1 tools",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-07-18T06:09:51Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "37c80ef82c9a27c0f85ac94905b70790d3df056c",
"body": "Every sibling tool in this batch (get_foreign_holdings_history,\nget_market_valuation_by_date) supports filtering by exact stock_no in\naddition to name substring match. This one was missing it by oversight.",
"is_bot": false,
"headline": "fix: add missing stock_no filter to get_all_stocks_daily_close",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-07-18T06:07:56Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "7ae7faf2ee5852d28d1c0d0ac9aba578bd5439aa",
"body": "…istory\n\nweek/month were never actually tested before this shipped in the same PR.\nLive-checked: BFI82U doesn't accept a single dayDate+type combo for all\nthree — each period uses a different param name and date encoding\n(dayDate=YYYYMMDD for day, weekDate + a specific Friday-anchored week-start\nval\n[…]\nentirely rather than half-implementing the other\ntwo encodings — the tool now only does what it verifiably does: query the\nmarket-level institutional buy/sell amounts for a single arbitrary past\ndate.",
"is_bot": false,
"headline": "fix: drop broken period param from get_market_institutional_amounts_h…",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-07-18T06:05:52Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "bad633f18a072e6863d1f9546432436253101584",
"body": "NEW_TOOLS_PLAN.md Tier 1 (TWSE half). All 5 hit www.twse.com.tw/rwd/*\nlegacy endpoints, which — unlike their openapi.twse.com.tw counterparts —\naccept an arbitrary past date/month rather than only a rolling recent\nwindow. Verified this distinction live for the two cases where an\nexisting similar-sou\n[…]\nse.\n\nAdded tests/e2e/test_history_tier1_api.py asserting the row shapes each\ntool accesses by index, per the repo's \"legacy exchangeReport\" test\nconvention. Updated CLAUDE.md's tools/history/ listing.",
"is_bot": false,
"headline": "feat: add TWSE Tier 1 historical-data tools (5 new tools)",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-07-18T05:56:03Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "20f2c75ac968fda816eccd51719c61eb231e676b",
"body": "Catalogs endpoints on www.twse.com.tw and www.taifex.com.tw that expose\nreal historical data but aren't yet wrapped as tools — every entry was\nverified live with requests, not guessed from docs. Tiered by value;\nTier 1 (9 tools) implemented next.",
"is_bot": false,
"headline": "docs: add plan for TWSE/TAIFEX historical-data tool gaps",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-07-18T05:48:10Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "d59c7cc814226456735e9da48200692ba30cb13b",
"body": "…link-bug\n\nfix: wrap bare www.taifex.com.tw domain in code span to prevent autolink breakage",
"is_bot": false,
"headline": "Merge pull request #51 from twjackysu/fix/readme-fullwidth-paren-auto…",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-07-18T00:04:31Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "de667f8015317a23bfd5a00596e95c2b0e57b6d9",
"body": "…ink breakage\n\nGitHub's markdown autolinker doesn't treat full-width （） as URL boundary\ndelimiters (only ASCII parens), so a bare \"www.taifex.com.tw\" wrapped in\nfull-width （） in README.md got autolinked together with the rest of the\nsentence into one giant broken link. Wrapped the domain in backticks in\nboth README.md and README_en-us.md (the latter used half-width parens so\nwasn't broken, but backticks are more robust either way).",
"is_bot": false,
"headline": "fix: wrap bare www.taifex.com.tw domain in code span to prevent autol…",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-07-18T00:03:40Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "f597093934c8a43dd8f8e4ba0eb295d124a180d3",
"body": "…istory-tools\n\ndocs: document TAIFEX historical tools and new prompts in README",
"is_bot": false,
"headline": "Merge pull request #50 from twjackysu/docs/update-readme-for-taifex-h…",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-07-17T23:50:34Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "2002e19002444f3ab792dad3fdf2d01fb54833f7",
"body": null,
"is_bot": false,
"headline": "docs: add TAIFEX website download source to CLAUDE.md overview",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-07-17T23:49:17Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "d716add5d699bb315a9c5d648f117cd9e90f615d",
"body": "- Add a data-source table row for the 2 new www.taifex.com.tw history\n tools (futures daily OHLC, 三大法人 futures position history),\n distinct from the existing TAIFEX OpenAPI row since openapi.taifex.com.tw\n has no historical query support at all.\n- Add an \"Advanced Features\" section covering the 4\n[…]\ntaifex_derivatives, institutional_flow, company_fundamental_healthcheck,\n pre_trade_risk_scan) that had no mention anywhere in the README.\n\nBoth README.md and README_en-us.md updated to stay in sync.",
"is_bot": false,
"headline": "docs: document TAIFEX historical tools and new prompts in README",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-07-17T23:48:18Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "06286889e29d3a2eb4e5a442e9dbd0ae3b3cc776",
"body": "feat: add TAIFEX futures/institutional historical data tools",
"is_bot": false,
"headline": "Merge pull request #49 from twjackysu/feat/taifex-historical-data-tools",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-07-17T23:44:55Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "2e89a8edaeffcb56e662f0c5354b7605c766a458",
"body": "…tools\n\nparse_yyyymmdd() and the DateTime-error/CSV-parsing logic were copy-pasted\nacross futures_daily_history.py and institutional_futures_history.py.\nMoved both into futures_daily_history.py and imported them from\ninstitutional_futures_history.py, matching the existing TAIFEX_HEADERS\npattern (def\n[…]\nintroducing a new register_tools-less helper file.\n\nNo behavior change — re-verified both tools live through the FastMCP\ntool manager and reran tests/e2e/test_taifex_history_api.py after the\nrefactor.",
"is_bot": false,
"headline": "refactor: dedupe Big5 CSV parsing between the two new TAIFEX history …",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-07-17T23:43:28Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "c4733d77665631712efd936f29009e495ec271fa",
"body": "openapi.taifex.com.tw has no historical query support at all — verified\nby testing every date-bearing field/param name against all 135 of its\nendpoints; the only two OHLC-bearing endpoints (DailyMarketReportFut/Opt,\nalready wrapped by get_daily_futures_market_report/get_daily_options_market_report)\n\n[…]\nother client method assumes.\n\nAdded tests/e2e/test_taifex_history_api.py asserting the CSV column\norder these tools access by index, per the \"Adding New Tools\" convention\nfor non-TWSE-OpenAPI sources.",
"is_bot": false,
"headline": "feat: add TAIFEX futures/institutional historical data tools",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-07-17T23:38:37Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "1076f0c53dbdbc9278aef9d9026de4e7dc6502a4",
"body": "docs: update Prefect Horizon URLs",
"is_bot": false,
"headline": "Merge pull request #47 from twjackysu/fix/update-prefect-horizon-urls",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-07-14T13:20:17Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "db65d70fa3a531b51c18b1b13faac5353b9e6ade",
"body": null,
"is_bot": false,
"headline": "docs: update Prefect Horizon URLs to horizon.prefect.io",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-07-14T13:19:33Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "d6d678a4b8809e01aee6fa0faf252b7a7ddc98d3",
"body": "…age-note\n\ndocs: restore hosted MCP option with usage limit and Prefect Horizon attribution",
"is_bot": false,
"headline": "Merge pull request #46 from twjackysu/docs/restore-hosted-mcp-with-us…",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-07-14T06:43:45Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "ca6584ad04ee7b97f68c9c19f828edd2dd2a974d",
"body": null,
"is_bot": false,
"headline": "docs: mention Prefect Horizon paid plan as a commercial-use option",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-07-14T05:49:49Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "69c7fcd491dc5a45a9106f89c6bf7cd8c0aba003",
"body": "The specific \"500 calls/month\" figure was outdated. Updated to describe\na general fair-use limit instead, and reworded the hosting note to\ncredit Prefect Horizon as powering the project.",
"is_bot": false,
"headline": "docs: correct hosted-MCP usage note",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-07-14T05:46:26Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "0418e874ef7590e26702f760d3063456410bac6b",
"body": "…attribution\n\nRe-adds the remote (streamable_http) MCP config block that was removed in #36,\nnow framed as one option among self-hosting rather than the default. Adds an\nexplicit note that the free tier is capped at 500 tool calls/month from end of\nAugust 2026, points commercial/high-volume users to\n[…]\n Horizon paid plan, and thanks Prefect Horizon for hosting the\nproject for free during the beta.\n\nEndpoint verified reachable (GET returns 405, expected for an MCP POST-only\nstreamable_http endpoint).",
"is_bot": false,
"headline": "docs: restore hosted MCP option with usage limit and Prefect Horizon …",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-07-14T05:33:45Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "86c2362459466fec3cccb08381c94f0aeaa53d11",
"body": "feat: add 4 new prompt templates (TAIFEX, institutional flow, fundamentals, risk scan)",
"is_bot": false,
"headline": "Merge pull request #44 from twjackysu/feat/add-4-prompt-templates",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-07-09T08:43:10Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "a0c4569a0740090ba3cefff49a611dc7bdc3238c",
"body": "… fundamentals, risk\n\nThe existing 5 prompts (trend, foreign investment, dividend, hotspot,\nscreening) leave several tool categories with zero prompt guidance:\n- 16 TAIFEX futures/options tools (tools/taifex/) had no prompt at all\n- 三大法人 (institutional investor) flow tools were scattered across\n ot\n[…]\nr by name, OTC lists filter by\n stock_no — kept distinct per each tool's actual signature)\n\nRegistered all 4 in server.py via @mcp.prompt, updated the prompt\ncount in CLAUDE.md/AGENTS.md from 5 to 9.",
"is_bot": false,
"headline": "feat: add 4 new prompt templates covering TAIFEX, institutional flow,…",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-07-09T08:33:52Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "a8bc1c1bd04eca0001e73b07f54ffc02ea6f3d70",
"body": "docs: localize prompt templates, remove fabricated example data",
"is_bot": false,
"headline": "Merge pull request #43 from twjackysu/docs/localize-fix-prompt-templates",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-07-09T08:16:34Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "f40ac79b3033082d030df0832900619e7ccef6ab",
"body": "perf: cache OpenAPI list responses in TWSEAPIClient",
"is_bot": false,
"headline": "Merge pull request #42 from twjackysu/perf/cache-openapi-list-responses",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-07-09T08:15:52Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "5ee03a8bcc42fd770af9bc1a6874cc6784ce686a",
"body": "All 5 prompt templates were English-only despite Chinese tool output\nand a Taiwanese audience, and mixed real tool-usage guidance with\n\"example output\" sections containing concrete invented numbers (e.g.\nforeign_investment_analysis_prompt hardcoded \"TSMC (2330): 78%\nforeign holding, near investment \n[…]\n output-format sections using bracketed placeholders instead of\n invented figures\n- twse_stock_trend_prompt's forced \"bullish/bearish\" conclusion\n changed to allow neutral/insufficient-data outcomes",
"is_bot": false,
"headline": "docs: localize prompt templates, remove fabricated example data",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-07-09T08:09:33Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "563cf106fa3162955d5f588cbafea4bf0e98662c",
"body": "fetch_company_data() re-downloads the entire endpoint (often 1000+\nrows) and filters client-side for every single-company lookup. A\nprompt that chains several company tools (profile, dividend, revenue,\netc.) re-fetches the same full list once per tool within seconds.\n\nAdd a short-TTL in-memory cache\n[…]\n Safe\nfor OpenAPI data (company/governance/financial lists update at most\ndaily); does not touch fetch_json (MIS realtime, legacy exchangeReport,\nTPEx, TAIFEX) which callers already handle separately.",
"is_bot": false,
"headline": "perf: cache OpenAPI list responses in TWSEAPIClient",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-07-09T08:06:25Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "a027e815fde8369da1b9369d2e1ec06ff08643b0",
"body": "docs: remove stale handle_empty_response references",
"is_bot": false,
"headline": "Merge pull request #41 from twjackysu/docs/fix-stale-decorator-refs",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-07-09T08:05:25Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "0a50dd0aa2e9ea54c9eb7f6ececf480950e2fe60",
"body": "The decorator was removed from utils/decorators.py in a prior\nrefactor, but CLAUDE.md still instructed contributors to use it.\nPoint to the actual pattern (explicit empty check + MSG_NO_DATA).",
"is_bot": false,
"headline": "docs: remove stale handle_empty_response references",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-07-09T08:04:13Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "8e2453395f2e717f1122898f653ddce5a45dfbb7",
"body": null,
"is_bot": false,
"headline": "Use shared upstream skip helper for TAIFEX E2E tests",
"author_name": "clancy",
"author_login": "clancyclaw",
"committed_at": "2026-07-03T19:05:29Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "9a272c265ac7ee17af5aac218e4bc64a0574461a",
"body": "docs: remove hosted MCP URL, add discontinuation notice",
"is_bot": false,
"headline": "Merge pull request #36 from twjackysu/docs/remove-hosted-mcp-url",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-07-03T02:50:17Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "e668016e922ca601cc42f63565578339216cea7a",
"body": null,
"is_bot": false,
"headline": "docs: soften hosted-service notice to no-longer-recommended",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-07-03T02:37:06Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "b8e533dba68dd7d2a8dc5139f72f550d76910306",
"body": "Horizon (third-party hosting platform) is capping free usage to\n500 tool calls/month from end of August 2026. This project is\nnon-profit open-source, so the hosted remote MCP option is\ndiscontinued in favor of Docker/local install.",
"is_bot": false,
"headline": "docs: remove hosted MCP URL, add discontinuation notice",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-07-03T02:29:45Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "26880a1125ec29ce56f0ca6939c97e46b71cc385",
"body": null,
"is_bot": false,
"headline": "fix: remove Glama",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-06-28T03:26:02Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "63139c920b34deb857a420b6d9dab058bc407639",
"body": null,
"is_bot": false,
"headline": "fix: fix api test",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-06-28T03:18:15Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "0bfe0225fd6855aa52187fa9fc8b092e47390da1",
"body": null,
"is_bot": false,
"headline": "fix: update README.md",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-06-28T02:57:26Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "c0499c29dc68dc85e32a9cc6809000f9cabf5e59",
"body": "feat(otc): expand TPEx coverage from 3 to 10 tools",
"is_bot": false,
"headline": "Merge pull request #35 from twjackysu/feat/tpex-expand-otc-tools",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-06-28T02:31:06Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "7c8dcfb89e8fedaefeab0a3c1da138d2e6b12ff0",
"body": "Add 7 new OTC tools from tpex.org.tw/openapi:\n- get_otc_margin_balance: 上櫃融資融券餘額\n- get_otc_warning_stocks: 上櫃注意股\n- get_otc_disposal_stocks: 上櫃處置股\n- get_otc_exright: 今日除權息\n- get_otc_odd_lot: 零股行情\n- get_otc_index: 櫃買指數\n- get_otc_institutional_summary: 三大法人彙總\n\nAdd tests/helpers.py with fetch_or_skip() \n[…]\nndpoint\nremoved = real breakage). Update existing 3 OTC test classes to use it.\nRemove redundant test_api_returns_data_with_filter_key tests.\n\nCo-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>",
"is_bot": false,
"headline": "feat(otc): expand TPEx coverage from 3 to 10 tools",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-06-27T17:14:59Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "aae5d46e710dcbe4782a560acb6a88f3b4fffd04",
"body": "refactor: Phase 4 — api_client dedup, fix shadowing, unify limit default, extract truncate",
"is_bot": false,
"headline": "Merge pull request #27 from twjackysu/refactor/phase-4-polish",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-06-06T02:48:47Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "3dd36e8adbc1e67767f8ae91f02adf0ff4440098",
"body": "…mit default, extract truncate\n\n- api_client: extract _throttle() + _request() shared helpers; fetch_data\n and fetch_json now delegate to _request instead of duplicating rate-limit\n + GET + timestamp logic (Template Method / DRY)\n- formatters: fix format_list_response inner function shadowing the\n\n[…]\nding/market.py: stays at 395 lines (just below 400 threshold), no split\n\nVerified byte-for-byte: 0 changed / 154 tools vs live TWSE/TPEx API.\n\nCo-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>",
"is_bot": false,
"headline": "refactor(phase-4): polish — dedup api_client, fix shadowing, unify li…",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-06-06T02:26:36Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "7d6b83e4190163c01341eeccaf2b525742c3b07e",
"body": "refactor: Phase 3 — table-drive list tools via create_list_tool factory",
"is_bot": false,
"headline": "Merge pull request #26 from twjackysu/refactor/phase-3-list-tool-factory",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-06-06T02:15:24Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "2f88143ccd0b7b20f85cd046773fb9992247bb4d",
"body": "Collapse the ubiquitous \"fetch list → optional name filter → paginate\"\nboilerplate into a single factory (Factory + Strategy): per-tool rendering\nis supplied as a formatter strategy, everything else declared in a table.\n\n- Add create_list_tool factory in utils/tool_factory.py\n- trading/market.py: 17\n[…]\nept explicit.\n\nVerified byte-for-byte: all 154 tool outputs identical pre/post refactor\nagainst the live TWSE/TPEx API (0 changed / 154 tools).\n\nCo-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>",
"is_bot": false,
"headline": "refactor(phase-3): table-drive list tools via create_list_tool factory",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-06-06T02:11:56Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "af90f6f5b16d783ed73d9a7803d831394af4b8a6",
"body": "refactor: Phase 0–2 — dead code removal, unified error handling, table-driven tools",
"is_bot": false,
"headline": "Merge pull request #25 from twjackysu/refactor/phase-0-remove-dead-code",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-06-06T01:50:17Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "dc6f71b332872f5baa1761ab88e986608914cb3e",
"body": "…r handling\n\nReplace 22 boilerplate fetch_company_data + format_properties tools with\nmodule-level data tables and create_company_tool factory loop:\n\n- basic_info.py: 17 simple tools → SIMPLE_BASIC_INFO_TOOLS table (623→503 lines)\n- financials.py: 5 simple tools → SIMPLE_FINANCIAL_TOOLS table\n- tool\n[…]\ns\n\nAlso clean up basic_info.py: remove dead defaultdict import, simplify\ndeficient-list comprehension, inline single-field formatter lambdas.\n\nCo-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>",
"is_bot": false,
"headline": "refactor(phase-2): table-drive simple company tools, fix factory erro…",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-06-05T14:36:11Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "021381c943ac6f90757bcb297e4a5f57b8472407",
"body": "Replace 37 inline try/except blocks across 9 tool modules with the\n@handle_api_errors() decorator. Error message (MSG_QUERY_FAILED) is\nidentical; decorator additionally logs with context via logger.error().\n\n- tools/company/basic_info.py (12 tools)\n- tools/company/esg.py (3 tools)\n- tools/c\n[…]\n (5 tools)\n- tools/trading/dividend_schedule.py (1 tool)\n- tools/trading/etf.py (1 tool)\n- tools/trading/warrants.py (4 tools)\n\nCo-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>",
"is_bot": false,
"headline": "refactor(phase-1): replace manual try/except with @handle_api_errors",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-06-05T14:25:26Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "78f8d97ed7904987d378bc226b067282e74f10f6",
"body": "- Delete stray debug/CI artifacts: check_registration.py, pr_body.json\n- Delete models/ layer (MarketInfo, BrokerInfo, RealTimeStats never used)\n- Remove handle_empty_response decorator (zero call sites)\n- Remove dead data_type param from handle_api_errors; clean 54 call sites\n- Remove dead constants MSG_QUERY_FAILED_WITH_CODE, MSG_MORE_RECORDS\n- Clean unused imports in formatters.py and utils/__init__.py\n\nCo-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>",
"is_bot": false,
"headline": "refactor(phase-0): remove dead code and unify decorator signature",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-06-05T14:08:46Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "c5ce36b25a30778ba9cdef01010d1bee99e02e40",
"body": "All tools that return list data now accept limit (default 50) and\noffset parameters for pagination. Tools with name/company fields\nalso accept a name keyword filter. format_list_response updated\nto support offset and show range info in headers.\n\nCo-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>",
"is_bot": false,
"headline": "feat: add limit/offset/name pagination to all list tools",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-05-22T11:47:00Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "6e2fd7920eaa6b90253bfe839052a60db21c9465",
"body": null,
"is_bot": false,
"headline": "fix: fix schema changes",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-05-21T15:48:16Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "e11dbac9033c4554a02d92c31590750a4b6abbbf",
"body": "Root cause: TWSE updated their live API but not their swagger.json — a real schema drift.\n\nChanges made:\n\nstaticFiles/swagger_decoded.json: Updated the local schema snapshot to match the live API:\nt187ap46_L_12: Added 公司名稱 field after 公司代號\nt187ap46_L_8: Split one combined field (with a comma in the \n[…]\nnitions.py: Swapped preference to use the local file first — TWSE's swagger.json frequently lags behind their actual API, which would keep producing false positives if we relied on it as the baseline.",
"is_bot": false,
"headline": "fix: fix API schema changes",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-05-20T16:27:33Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "3faa16b2ddd325d048f9fb267f8a8afae21b6410",
"body": null,
"is_bot": false,
"headline": "test: add pytest-rerunfailures",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-05-13T13:44:13Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "89d0ab163040ac23a7df6ce0113368ede102ca63",
"body": null,
"is_bot": false,
"headline": "fix: change to scope=\"class\" for tests",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-05-13T12:58:24Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "b18b494512d909bf64e7da45558d0d56c8d848a4",
"body": null,
"is_bot": false,
"headline": "chore: update README.md, CLAUDE.md",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-05-07T12:22:30Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "68483150219f1fe5e84fec3617077c91b12d2926",
"body": "…investors\n\n[Bot Refactor] feat: add TWSE listed stocks three major institutional investors tools",
"is_bot": false,
"headline": "Merge pull request #21 from twjackysu/feat/twse-listed-institutional-…",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-05-07T12:09:21Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "e8d96699aa21959b4186aee2356abbffc267cc9d",
"body": null,
"is_bot": false,
"headline": "fix: fix error",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-05-07T12:08:29Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "19d9038aa8be5c4937945ffcd98713a531332c0e",
"body": "Add two MCP tools for querying TWSE listed stocks (上市) 三大法人\n(foreign investors, investment trusts, dealers) daily net buy/sell data\nvia the TWSE T86 API endpoint.\n\nTools added:\n- get_twse_institutional_investors_summary(date): Returns top 30 stocks\n by absolute institutional net buy/sell for a give\n[…]\nrift detection: validates all 19 field names and indices\n- Data integrity: ensures data is non-empty and parseable\n- Stock filter: verifies row[0] is stock code and key indices are correct\n\nCloses #20",
"is_bot": false,
"headline": "feat: add TWSE listed stocks three major institutional investors tools",
"author_name": "jacky-openclaw",
"author_login": "trend-jacky-su",
"committed_at": "2026-05-06T16:31:49Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "28baeddb0fb804f7335b052a47602718c6f441fb",
"body": null,
"is_bot": false,
"headline": "chore: update README.md",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-04-26T12:33:28Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "41dba124b4bd376c2f905a6245ea867c915c56e5",
"body": null,
"is_bot": false,
"headline": "fix: fix docker image issue",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-04-26T12:19:59Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "35b5e3b8ff2870bc09e3a5e2959d07c497989126",
"body": null,
"is_bot": false,
"headline": "fix: add taifex test to workflow",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-04-26T11:54:35Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "fea30706697fda1824197b2a57b77f0c00083f83",
"body": null,
"is_bot": false,
"headline": "chore: update README.md, CLAUDE.md",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-04-26T11:01:14Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "3023216511bdaf63c523b9e14965266b6d708a56",
"body": "get_institutional_traders_by_futures、get_institutional_traders_by_options、get_institutional_traders_calls_puts\nget_options_delta（需指定 contract_month，避免 7845 筆爆量）、get_options_oi_change\nget_index_futures_margin、get_stock_futures_margin（可用股票代號或期貨代碼查詢）\nget_annual_trading_volume、get_monthly_trading_statistics",
"is_bot": false,
"headline": "feat: add 9 tools",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-04-26T10:55:39Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "305dbb31c116e3d5c80628c0d9d7e6034b09ce84",
"body": "tools/taifex/daily_market_report.py — get_daily_futures_market_report(contract) / get_daily_options_market_report(contract, call_put, limit)\ntools/taifex/large_traders_oi.py — get_large_traders_futures_oi(contract) / get_large_traders_options_oi(contract, call_put)\ntools/taifex/institutional_general.py — get_institutional_general()",
"is_bot": false,
"headline": "feat: add 5 tools",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-04-26T10:46:22Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "97a9b79af41bd77a149852a864690cc064c521f4",
"body": null,
"is_bot": false,
"headline": "fix: fix some code issue, change all description to Chinese",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-04-12T11:15:36Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "57a2280b3bcc6c6961d24b33318e5c8df471773f",
"body": null,
"is_bot": false,
"headline": "fix: add extra info to get_realtime_quote",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-04-12T03:40:18Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "8767e9d71e6a55001be06d8bfa1dddd1b9d801fb",
"body": null,
"is_bot": false,
"headline": "chore: update README.md, CLAUDE.md",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-04-12T03:18:30Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "b063c865eebb6b670475b8e224bc9acde3f56373",
"body": "…et_otc_valuation, get_futures_institutional, get_put_call_ratio tools",
"is_bot": false,
"headline": "feat: add get_realtime_quote, get_otc_daily, get_otc_institutional, g…",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-04-12T03:17:55Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "8920ff0432f27d9bdbb1daa482e1c63e39074f4d",
"body": "…_valuation_by_date, get_margin_balance tools",
"is_bot": false,
"headline": "fix: add get_stock_history, get_stock_monthly_avg_history, get_market…",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-04-12T02:49:03Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "3acf60bda359218923d76dd6fce9efb290ba4b74",
"body": null,
"is_bot": false,
"headline": "fix: remove some API tests",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-03-28T04:19:14Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "f6c240f6f17ec5a4b4d1ba7b544607e678970753",
"body": null,
"is_bot": false,
"headline": "fix: fix schema change",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-03-28T03:38:22Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "21a0f0ab26cb86e4c1a7d7c6d12e91e68f73bfd9",
"body": null,
"is_bot": false,
"headline": "fix: fix api tests",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-02-08T16:26:52Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "fa9c9c2c167ddb4be510f2f4f31049592b6a91d0",
"body": null,
"is_bot": false,
"headline": "fix: get_valuation_ratios_by_date",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-02-06T03:44:31Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "8f1772fb070a278cf6db250b3db7b1c21cac239e",
"body": null,
"is_bot": false,
"headline": "fix: fix get_after_hours_trading",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-02-06T03:44:24Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "365d257861b129ef158841ad60b5729ee6f312aa",
"body": "… tools",
"is_bot": false,
"headline": "refactor(di): complete phase 5 dependency injection for all remaining…",
"author_name": "JackyIQ",
"author_login": null,
"committed_at": "2026-02-06T03:19:54Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "b892d593811439aaccb1f99afad2acefef84d690",
"body": "…ection",
"is_bot": false,
"headline": "refactor(di): update tool factory and esg tools to use dependency inj…",
"author_name": "JackyIQ",
"author_login": null,
"committed_at": "2026-02-06T03:13:27Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "5bcbb28a76ff8676e14a8cf5e0f2c2a3aa89ff16",
"body": "…iting",
"is_bot": false,
"headline": "fix: explicitly set function name for dynamic tools to prevent overwr…",
"author_name": "JackyIQ",
"author_login": null,
"committed_at": "2026-02-06T02:56:35Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "531bccf53bcb1aaa5897e8807c3b2859202750d7",
"body": null,
"is_bot": false,
"headline": "fix: add logging to tool factory to debug dynamic tool registration",
"author_name": "JackyIQ",
"author_login": null,
"committed_at": "2026-02-06T02:54:47Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "a8503409dd250299087ed0ebc025bb1013906ec2",
"body": null,
"is_bot": false,
"headline": "fix: use absolute path for tool discovery and add more logging",
"author_name": "JackyIQ",
"author_login": null,
"committed_at": "2026-02-06T02:45:43Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "5729bc00762ad701d9422b6743e4f02d2469a30c",
"body": null,
"is_bot": false,
"headline": "fix: add detailed logging for tool registration failures",
"author_name": "JackyIQ",
"author_login": null,
"committed_at": "2026-02-06T02:36:11Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "c5f2e6eeba355634d09b263b63e5813b5070b5df",
"body": null,
"is_bot": false,
"headline": "fix(di): standardize tool registration signature across all modules",
"author_name": "JackyIQ",
"author_login": null,
"committed_at": "2026-02-06T02:28:28Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "00698e614f8f1b0a69249ed36ea794cd2bab63eb",
"body": null,
"is_bot": false,
"headline": "refactor: implement dependency injection pattern",
"author_name": "JackyIQ",
"author_login": null,
"committed_at": "2026-02-06T02:14:08Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "d33113c0e5fc36815bb4b8cc47f3a822dae3e667",
"body": "refactor: Convert TWSEAPIClient to instance-based pattern (Phase 2)",
"is_bot": false,
"headline": "Merge pull request #13 from twjackysu/refactor/instance-based-client",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-02-06T02:10:54Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "19b341f9bfc8fb741eaf77d6f4dc9e7c22df0255",
"body": null,
"is_bot": false,
"headline": "refactor: convert TWSEAPIClient to instance-based pattern",
"author_name": "JackyIQ",
"author_login": null,
"committed_at": "2026-02-06T02:04:09Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "5c0d3a2f23c222243c705ace8b34f37a7bf8933b",
"body": "Removed push and pull_request triggers from workflow.",
"is_bot": false,
"headline": "Update api-tests.yml to remove push triggers",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-02-06T01:52:55Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "63f1d6a38e4e06276f2971bf9d35b75954a0f185",
"body": "refactor: Introduce Pydantic models for type safety (Phase 1)",
"is_bot": false,
"headline": "Merge pull request #12 from twjackysu/refactor/introduce-pydantic-models",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-02-06T01:51:15Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "a6da8cab733c90a456348dd197c52062f880ea4b",
"body": null,
"is_bot": false,
"headline": "feat: add pydantic models for market and stats data",
"author_name": "JackyIQ",
"author_login": null,
"committed_at": "2026-02-06T01:36:51Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "e3cae686ff9736ea5e38878423257d4c2d84283e",
"body": "…ve-magic-numbers\n\nrefactor: Extract constants to eliminate magic numbers and duplicate strings",
"is_bot": false,
"headline": "Merge pull request #11 from twjackysu/refactor/extract-constants-remo…",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-02-01T14:27:46Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "d68bea5d7cc7de91f271125f5981a788f2b4ad50",
"body": null,
"is_bot": false,
"headline": "fix: fix schema checking",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-02-01T14:15:42Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "d991630ef26025f4cb188b3a6da0d238350ce32c",
"body": null,
"is_bot": false,
"headline": "fix: fix some tools",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-02-01T13:52:07Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "5291af5586b622d5b1cdb8fcd5d7176ca90660e0",
"body": "- Replace manual import/register pattern with automatic module discovery\n- Use importlib and pkgutil to scan tools package recursively\n- Automatically find and call register_tools() in all tool modules\n- Reduce tools/__init__.py from 49 lines to 30 lines\n- Benefits:\n * No need to manually update __\n[…]\ntes 17 manual imports and 17 manual function calls\n * Self-maintaining: new modules are auto-discovered\n * Graceful error handling for failed registrations\n * Type hints added for FastMCP parameter",
"is_bot": false,
"headline": "refactor: automate tool registration with module discovery",
"author_name": "Jacky Su",
"author_login": "twjackysu",
"committed_at": "2026-02-01T10:36:09Z",
"body_truncated": true,
"is_coding_agent": false
}
],
"releases_count": 13,
"commits_last_year": 155,
"latest_release_at": "2026-07-19T12:18:13Z",
"latest_release_tag": "v1.8.0",
"releases_from_tags": false,
"days_since_last_push": 3,
"active_weeks_last_year": 24,
"days_since_latest_release": 4,
"mean_days_between_releases": 9.3
},
"community": {
"has_readme": true,
"has_license": true,
"has_description": true,
"has_contributing": false,
"health_percentage": 42,
"has_issue_template": false,
"has_code_of_conduct": false,
"has_pull_request_template": false
},
"ecosystem": {
"packages": []
},
"popularity": {
"forks": 37,
"stars": 133,
"watchers": 0,
"fork_history": {
"days": [
{
"date": "2025-07-19",
"count": 1
},
{
"date": "2025-08-10",
"count": 1
},
{
"date": "2025-09-12",
"count": 1
},
{
"date": "2025-09-16",
"count": 1
},
{
"date": "2025-10-05",
"count": 1
},
{
"date": "2025-10-20",
"count": 1
},
{
"date": "2025-10-23",
"count": 1
},
{
"date": "2025-11-07",
"count": 1
},
{
"date": "2025-12-17",
"count": 1
},
{
"date": "2025-12-27",
"count": 1
},
{
"date": "2025-12-29",
"count": 1
},
{
"date": "2026-01-11",
"count": 1
},
{
"date": "2026-01-15",
"count": 1
},
{
"date": "2026-01-21",
"count": 1
},
{
"date": "2026-01-22",
"count": 1
},
{
"date": "2026-01-29",
"count": 1
},
{
"date": "2026-02-10",
"count": 1
},
{
"date": "2026-02-17",
"count": 1
},
{
"date": "2026-03-03",
"count": 1
},
{
"date": "2026-03-23",
"count": 1
},
{
"date": "2026-04-04",
"count": 1
},
{
"date": "2026-04-08",
"count": 1
},
{
"date": "2026-04-19",
"count": 1
},
{
"date": "2026-04-21",
"count": 1
},
{
"date": "2026-04-23",
"count": 1
},
{
"date": "2026-04-24",
"count": 2
},
{
"date": "2026-04-29",
"count": 1
},
{
"date": "2026-05-02",
"count": 1
},
{
"date": "2026-05-12",
"count": 1
},
{
"date": "2026-05-21",
"count": 1
},
{
"date": "2026-05-28",
"count": 1
},
{
"date": "2026-06-05",
"count": 1
},
{
"date": "2026-06-26",
"count": 1
},
{
"date": "2026-07-01",
"count": 1
},
{
"date": "2026-07-03",
"count": 1
},
{
"date": "2026-07-14",
"count": 1
}
],
"complete": true,
"collected": 37,
"total_forks": 37
},
"star_history": null,
"open_issues_and_prs": 1
},
"ai_readiness": {
"has_nix": false,
"example_dirs": [],
"has_llms_txt": false,
"has_dockerfile": true,
"has_mcp_signal": true,
"bootstrap_files": [],
"api_schema_files": [],
"has_devcontainer": false,
"typecheck_configs": [],
"toolchain_manifests": [],
"largest_source_bytes": 20862,
"source_files_sampled": 103,
"oversized_source_files": 0,
"agent_instruction_files": [
"CLAUDE.md"
],
"agent_instruction_max_bytes": 12651
},
"dependencies": {
"manifests": [
"pyproject.toml",
"requirements-dev.txt",
"requirements.txt"
],
"advisories": {
"error": null,
"scope": "repository_graph",
"source": "osv",
"findings": [
{
"name": "fastmcp",
"direct": true,
"version": "2.12.3",
"severity": "critical",
"ecosystem": "pypi",
"cvss_score": 10,
"advisory_ids": [
"GHSA-5h2m-4q8j-pqpj",
"GHSA-c2jp-c369-7pvx",
"GHSA-m8x7-r2rg-vh5g",
"GHSA-mxxr-jv3v-6pgc",
"GHSA-rcfx-77hg-w2wv",
"GHSA-rj5c-58rq-j5g5",
"GHSA-rww4-4w9c-7733",
"GHSA-vv7q-7jx5-f767",
"PYSEC-2026-1364",
"PYSEC-2026-1365"
],
"fixed_version": "3.2.0",
"advisory_count": 14,
"oldest_advisory_days": 267
},
{
"name": "cryptography",
"direct": false,
"version": "45.0.5",
"severity": "critical",
"ecosystem": "pypi",
"cvss_score": 9.8,
"advisory_ids": [
"GHSA-537c-gmf6-5ccf",
"GHSA-m959-cc7f-wv43",
"GHSA-p423-j2cm-9vmq",
"GHSA-r6ph-v2qm-q3c2",
"PYSEC-2026-2141",
"PYSEC-2026-35",
"PYSEC-2026-36"
],
"fixed_version": "48.0.1",
"advisory_count": 7,
"oldest_advisory_days": 163
},
{
"name": "mcp",
"direct": true,
"version": "1.27.0",
"severity": "high",
"ecosystem": "pypi",
"cvss_score": 7.6,
"advisory_ids": [
"GHSA-hvrp-rf83-w775",
"GHSA-jpw9-pfvf-9f58",
"GHSA-vj7q-gjh5-988w",
"PYSEC-2026-3481",
"PYSEC-2026-3482",
"PYSEC-2026-3483"
],
"fixed_version": "1.28.1",
"advisory_count": 6,
"oldest_advisory_days": 7
},
{
"name": "click",
"direct": false,
"version": "8.2.2",
"severity": "high",
"ecosystem": "pypi",
"cvss_score": 7.2,
"advisory_ids": [
"PYSEC-2026-2132"
],
"fixed_version": "8.3.3",
"advisory_count": 1,
"oldest_advisory_days": 84
},
{
"name": "joserfc",
"direct": false,
"version": "1.6.4",
"severity": "high",
"ecosystem": "pypi",
"cvss_score": 7.5,
"advisory_ids": [
"GHSA-gg9x-qcx2-xmrh",
"GHSA-wphv-vfrh-23q5",
"PYSEC-2026-2528",
"PYSEC-2026-2530"
],
"fixed_version": "1.6.8",
"advisory_count": 4,
"oldest_advisory_days": 27
},
{
"name": "pyjwt",
"direct": false,
"version": "2.12.1",
"severity": "high",
"ecosystem": "pypi",
"cvss_score": 7.4,
"advisory_ids": [
"GHSA-993g-76c3-p5m4",
"GHSA-fhv5-28vv-h8m8",
"GHSA-jq35-7prp-9v3f",
"GHSA-w7vc-732c-9m39",
"GHSA-xgmm-8j9v-c9wx",
"PYSEC-2026-175",
"PYSEC-2026-177",
"PYSEC-2026-178",
"PYSEC-2026-179"
],
"fixed_version": "2.13.0",
"advisory_count": 9,
"oldest_advisory_days": 56
},
{
"name": "python-multipart",
"direct": false,
"version": "0.0.20",
"severity": "high",
"ecosystem": "pypi",
"cvss_score": 8.6,
"advisory_ids": [
"GHSA-5rvq-cxj2-64vf",
"GHSA-6jv3-5f52-599m",
"GHSA-mj87-hwqh-73pj",
"GHSA-pp6c-gr5w-3c5g",
"GHSA-v9pg-7xvm-68hf",
"GHSA-vffw-93wf-4j4q",
"GHSA-wp53-j4wj-2cfg",
"PYSEC-2026-1852",
"PYSEC-2026-3036",
"PYSEC-2026-3037"
],
"fixed_version": "0.0.31",
"advisory_count": 14,
"oldest_advisory_days": 178
},
{
"name": "starlette",
"direct": false,
"version": "0.47.2",
"severity": "high",
"ecosystem": "pypi",
"cvss_score": 7.5,
"advisory_ids": [
"GHSA-7f5h-v6xp-fcq8",
"GHSA-82w8-qh3p-5jfq",
"GHSA-86qp-5c8j-p5mr",
"GHSA-jp82-jpqv-5vv3",
"GHSA-wqp7-x3pw-xc5r",
"GHSA-x746-7m8f-x49c",
"PYSEC-2026-161",
"PYSEC-2026-1942",
"PYSEC-2026-2280",
"PYSEC-2026-2281"
],
"fixed_version": "1.3.1",
"advisory_count": 12,
"oldest_advisory_days": 268
},
{
"name": "urllib3",
"direct": false,
"version": "2.5.0",
"severity": "high",
"ecosystem": "pypi",
"cvss_score": 7.5,
"advisory_ids": [
"GHSA-2xpw-w6gg-jr37",
"GHSA-38jv-5279-wg99",
"GHSA-gm62-xv2j-4w53",
"GHSA-qccp-gfcp-xxvc",
"PYSEC-2026-141",
"PYSEC-2026-1994",
"PYSEC-2026-1996",
"PYSEC-2026-1998"
],
"fixed_version": "2.7.0",
"advisory_count": 8,
"oldest_advisory_days": 230
},
{
"name": "requests",
"direct": true,
"version": "2.32.4",
"severity": "moderate",
"ecosystem": "pypi",
"cvss_score": 5.5,
"advisory_ids": [
"GHSA-gc5v-m9x4-r6x2",
"PYSEC-2026-2275"
],
"fixed_version": "2.33.0",
"advisory_count": 2,
"oldest_advisory_days": 120
},
{
"name": "authlib",
"direct": false,
"version": "1.7.0",
"severity": "moderate",
"ecosystem": "pypi",
"cvss_score": 6.1,
"advisory_ids": [
"GHSA-r95x-qfjj-fjj2",
"GHSA-w8p2-r796-3vmq"
],
"fixed_version": "1.7.1",
"advisory_count": 2,
"oldest_advisory_days": 72
},
{
"name": "idna",
"direct": false,
"version": "3.10",
"severity": "moderate",
"ecosystem": "pypi",
"cvss_score": 5.3,
"advisory_ids": [
"GHSA-65pc-fj4g-8rjx",
"PYSEC-2026-215"
],
"fixed_version": "3.15",
"advisory_count": 2,
"oldest_advisory_days": 65
},
{
"name": "pytest",
"direct": false,
"version": "8.4.2",
"severity": "moderate",
"ecosystem": "pypi",
"cvss_score": 6.8,
"advisory_ids": [
"GHSA-6w46-j5rx-g56g",
"PYSEC-2026-1845"
],
"fixed_version": "9.0.3",
"advisory_count": 2,
"oldest_advisory_days": 183
},
{
"name": "python-dotenv",
"direct": false,
"version": "1.1.1",
"severity": "moderate",
"ecosystem": "pypi",
"cvss_score": 6.6,
"advisory_ids": [
"GHSA-mf9w-mj56-hr94",
"PYSEC-2026-2270"
],
"fixed_version": "1.2.2",
"advisory_count": 2,
"oldest_advisory_days": 94
},
{
"name": "pygments",
"direct": false,
"version": "2.19.2",
"severity": "low",
"ecosystem": "pypi",
"cvss_score": 3.3,
"advisory_ids": [
"GHSA-5239-wwwm-4pmq",
"PYSEC-2026-2987"
],
"fixed_version": "2.20.0",
"advisory_count": 2,
"oldest_advisory_days": 124
}
],
"collected": true,
"malicious": [],
"truncated": false,
"by_severity": {
"low": 1,
"high": 7,
"critical": 2,
"moderate": 5
},
"advisory_count": 87,
"affected_count": 15,
"assessed_count": 76,
"malicious_count": 0,
"assessed_package": null,
"unassessed_count": 5,
"direct_affected_count": 3
},
"ecosystems": [
"pypi"
],
"dependencies": [
{
"name": "fastmcp",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": "==2.12.3"
},
{
"name": "httpx",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": ">=0.28.1"
},
{
"name": "mcp",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": ">=1.9.3"
},
{
"name": "requests",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": ">=2.32.4"
}
],
"all_dependencies": {
"error": null,
"source": "github-sbom",
"packages": [
{
"name": "fastmcp",
"direct": true,
"version": "2.12.3",
"ecosystem": "pypi"
},
{
"name": "httpx",
"direct": true,
"version": "0.28.1",
"ecosystem": "pypi"
},
{
"name": "mcp",
"direct": true,
"version": null,
"ecosystem": "pypi"
},
{
"name": "mcp",
"direct": true,
"version": "1.27.0",
"ecosystem": "pypi"
},
{
"name": "requests",
"direct": true,
"version": "2.32.4",
"ecosystem": "pypi"
},
{
"name": "annotated-types",
"direct": false,
"version": "0.7.0",
"ecosystem": "pypi"
},
{
"name": "anyio",
"direct": false,
"version": "4.9.0",
"ecosystem": "pypi"
},
{
"name": "attrs",
"direct": false,
"version": "25.3.0",
"ecosystem": "pypi"
},
{
"name": "authlib",
"direct": false,
"version": "1.7.0",
"ecosystem": "pypi"
},
{
"name": "certifi",
"direct": false,
"version": "2025.7.14",
"ecosystem": "pypi"
},
{
"name": "cffi",
"direct": false,
"version": "1.17.1",
"ecosystem": "pypi"
},
{
"name": "charset-normalizer",
"direct": false,
"version": "3.4.2",
"ecosystem": "pypi"
},
{
"name": "click",
"direct": false,
"version": "8.2.2",
"ecosystem": "pypi"
},
{
"name": "colorama",
"direct": false,
"version": "0.4.6",
"ecosystem": "pypi"
},
{
"name": "coverage",
"direct": false,
"version": "7.11.0",
"ecosystem": "pypi"
},
{
"name": "cryptography",
"direct": false,
"version": "45.0.5",
"ecosystem": "pypi"
},
{
"name": "cyclopts",
"direct": false,
"version": "4.11.0",
"ecosystem": "pypi"
},
{
"name": "dnspython",
"direct": false,
"version": "2.7.0",
"ecosystem": "pypi"
},
{
"name": "docstring-parser",
"direct": false,
"version": "0.17.0",
"ecosystem": "pypi"
},
{
"name": "docutils",
"direct": false,
"version": "0.22",
"ecosystem": "pypi"
},
{
"name": "email-validator",
"direct": false,
"version": "2.2.0",
"ecosystem": "pypi"
},
{
"name": "exceptiongroup",
"direct": false,
"version": "1.3.0",
"ecosystem": "pypi"
},
{
"name": "h11",
"direct": false,
"version": "0.16.0",
"ecosystem": "pypi"
},
{
"name": "httpcore",
"direct": false,
"version": "1.0.9",
"ecosystem": "pypi"
},
{
"name": "httpx-sse",
"direct": false,
"version": "0.4.1",
"ecosystem": "pypi"
},
{
"name": "idna",
"direct": false,
"version": "3.10",
"ecosystem": "pypi"
},
{
"name": "iniconfig",
"direct": false,
"version": "2.1.0",
"ecosystem": "pypi"
},
{
"name": "isodate",
"direct": false,
"version": "0.7.2",
"ecosystem": "pypi"
},
{
"name": "joserfc",
"direct": false,
"version": "1.6.4",
"ecosystem": "pypi"
},
{
"name": "jsonschema",
"direct": false,
"version": "4.25.0",
"ecosystem": "pypi"
},
{
"name": "jsonschema-path",
"direct": false,
"version": "0.4.5",
"ecosystem": "pypi"
},
{
"name": "jsonschema-specifications",
"direct": false,
"version": "2025.4.1",
"ecosystem": "pypi"
},
{
"name": "lazy-object-proxy",
"direct": false,
"version": "1.12.0",
"ecosystem": "pypi"
},
{
"name": "markdown-it-py",
"direct": false,
"version": "3.0.0",
"ecosystem": "pypi"
},
{
"name": "markupsafe",
"direct": false,
"version": "3.0.3",
"ecosystem": "pypi"
},
{
"name": "mdurl",
"direct": false,
"version": "0.1.2",
"ecosystem": "pypi"
},
{
"name": "more-itertools",
"direct": false,
"version": "10.7.0",
"ecosystem": "pypi"
},
{
"name": "openapi-core",
"direct": false,
"version": "0.23.1",
"ecosystem": "pypi"
},
{
"name": "openapi-pydantic",
"direct": false,
"version": "0.5.1",
"ecosystem": "pypi"
},
{
"name": "openapi-schema-validator",
"direct": false,
"version": "0.8.1",
"ecosystem": "pypi"
},
{
"name": "openapi-spec-validator",
"direct": false,
"version": "0.8.5",
"ecosystem": "pypi"
},
{
"name": "packaging",
"direct": false,
"version": "25.0",
"ecosystem": "pypi"
},
{
"name": "pathable",
"direct": false,
"version": "0.5.0",
"ecosystem": "pypi"
},
{
"name": "pluggy",
"direct": false,
"version": "1.6.0",
"ecosystem": "pypi"
},
{
"name": "pycparser",
"direct": false,
"version": "2.22",
"ecosystem": "pypi"
},
{
"name": "pydantic",
"direct": false,
"version": "2.11.7",
"ecosystem": "pypi"
},
{
"name": "pydantic-core",
"direct": false,
"version": "2.33.2",
"ecosystem": "pypi"
},
{
"name": "pydantic-settings",
"direct": false,
"version": "2.10.1",
"ecosystem": "pypi"
},
{
"name": "pygments",
"direct": false,
"version": "2.19.2",
"ecosystem": "pypi"
},
{
"name": "pyjwt",
"direct": false,
"version": "2.12.1",
"ecosystem": "pypi"
},
{
"name": "pyperclip",
"direct": false,
"version": "1.9.0",
"ecosystem": "pypi"
},
{
"name": "pytest",
"direct": false,
"version": null,
"ecosystem": "pypi"
},
{
"name": "pytest",
"direct": false,
"version": "8.4.2",
"ecosystem": "pypi"
},
{
"name": "pytest-asyncio",
"direct": false,
"version": null,
"ecosystem": "pypi"
},
{
"name": "pytest-asyncio",
"direct": false,
"version": "1.2.0",
"ecosystem": "pypi"
},
{
"name": "pytest-cov",
"direct": false,
"version": null,
"ecosystem": "pypi"
},
{
"name": "pytest-cov",
"direct": false,
"version": "7.0.0",
"ecosystem": "pypi"
},
{
"name": "pytest-mock",
"direct": false,
"version": null,
"ecosystem": "pypi"
},
{
"name": "pytest-mock",
"direct": false,
"version": "3.15.1",
"ecosystem": "pypi"
},
{
"name": "pytest-rerunfailures",
"direct": false,
"version": "16.2",
"ecosystem": "pypi"
},
{
"name": "python-dotenv",
"direct": false,
"version": "1.1.1",
"ecosystem": "pypi"
},
{
"name": "python-multipart",
"direct": false,
"version": "0.0.20",
"ecosystem": "pypi"
},
{
"name": "pywin32",
"direct": false,
"version": "311",
"ecosystem": "pypi"
},
{
"name": "pyyaml",
"direct": false,
"version": "6.0.2",
"ecosystem": "pypi"
},
{
"name": "referencing",
"direct": false,
"version": "0.37.0",
"ecosystem": "pypi"
},
{
"name": "rfc3339-validator",
"direct": false,
"version": "0.1.4",
"ecosystem": "pypi"
},
{
"name": "rich",
"direct": false,
"version": "14.1.0",
"ecosystem": "pypi"
},
{
"name": "rich-rst",
"direct": false,
"version": "1.3.1",
"ecosystem": "pypi"
},
{
"name": "rpds-py",
"direct": false,
"version": "0.26.0",
"ecosystem": "pypi"
},
{
"name": "shellingham",
"direct": false,
"version": "1.5.4",
"ecosystem": "pypi"
},
{
"name": "six",
"direct": false,
"version": "1.17.0",
"ecosystem": "pypi"
},
{
"name": "sniffio",
"direct": false,
"version": "1.3.1",
"ecosystem": "pypi"
},
{
"name": "sse-starlette",
"direct": false,
"version": "3.0.2",
"ecosystem": "pypi"
},
{
"name": "starlette",
"direct": false,
"version": "0.47.2",
"ecosystem": "pypi"
},
{
"name": "twstockmcpserver",
"direct": false,
"version": "0.1.0",
"ecosystem": "pypi"
},
{
"name": "typer",
"direct": false,
"version": "0.16.0",
"ecosystem": "pypi"
},
{
"name": "typing-extensions",
"direct": false,
"version": "4.15.0",
"ecosystem": "pypi"
},
{
"name": "typing-inspection",
"direct": false,
"version": "0.4.1",
"ecosystem": "pypi"
},
{
"name": "urllib3",
"direct": false,
"version": "2.5.0",
"ecosystem": "pypi"
},
{
"name": "uvicorn",
"direct": false,
"version": "0.35.0",
"ecosystem": "pypi"
},
{
"name": "werkzeug",
"direct": false,
"version": "3.1.8",
"ecosystem": "pypi"
}
],
"collected": true,
"truncated": false,
"total_count": 81,
"direct_count": 5,
"indirect_count": 76
}
},
"maintainership": {
"issues": {
"open_prs": 0,
"merged_prs": 37,
"open_issues": 1,
"closed_ratio": 0.952,
"closed_issues": 20,
"closed_unmerged_prs": 2
},
"bus_factor": 1,
"bot_contributors": 0,
"top_contributors": [
{
"type": "User",
"login": "twjackysu",
"commits": 157,
"avatar_url": "https://avatars.githubusercontent.com/u/29649008?v=4"
},
{
"type": "User",
"login": "William-W-Chen",
"commits": 3,
"avatar_url": "https://avatars.githubusercontent.com/u/180166308?v=4"
},
{
"type": "User",
"login": "trend-jacky-su",
"commits": 3,
"avatar_url": "https://avatars.githubusercontent.com/u/129255673?v=4"
},
{
"type": "User",
"login": "clancyclaw",
"commits": 1,
"avatar_url": "https://avatars.githubusercontent.com/u/261641398?v=4"
}
],
"contributors_sampled": 4,
"top_contributor_share": 0.957
},
"quality_signals": {
"has_ci": true,
"has_tests": true,
"ci_workflows": [
"api-tests.yml",
"ghcr-publish.yaml"
],
"has_docs_dir": false,
"linter_configs": [],
"has_editorconfig": false,
"has_linter_config": false,
"has_precommit_config": false
},
"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": null,
"reason": "internal error: error during branchesHandler.setup: internal error: some github tokens can't read classic branch protection rules: https://github.com/ossf/scorecard-action/blob/main/docs/authentication/fine-grained-auth-token.md",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#branch-protection"
},
{
"name": "CI-Tests",
"score": 10,
"reason": "13 out of 13 merged PRs checked by a CI test -- score normalized to 10",
"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 1/13 approved changesets -- score normalized to 0",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#code-review"
},
{
"name": "Contributors",
"score": 0,
"reason": "project has 0 contributing companies or organizations -- score normalized to 0",
"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": 0,
"reason": "no 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 3 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": 0,
"reason": "security policy file not detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#security-policy"
},
{
"name": "Signed-Releases",
"score": null,
"reason": "no releases found",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#signed-releases"
},
{
"name": "Token-Permissions",
"score": 9,
"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": "47 existing vulnerabilities detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#vulnerabilities"
}
],
"commit": "f23059db3fa25e7b28fbe13489faa244d3fed51f",
"ran_at": "2026-07-24T06:32:56Z",
"aggregate_score": 4.6,
"scorecard_version": "v5.5.0"
},
"has_codeql_workflow": false,
"has_security_policy": false,
"has_dependabot_config": false
},
"contribution_flow": {
"collected": true,
"ci_last_run_at": "2026-07-24T04:17:44Z",
"oldest_open_prs": [],
"last_merged_pr_at": "2026-07-21T00:35:33Z",
"ci_last_conclusion": "SUCCESS",
"oldest_open_issues": [
{
"number": 23,
"created_at": "2026-05-26T05:11:25Z",
"last_comment_at": null,
"last_comment_author": null
}
]
}
},
"config": {
"disabled_metrics": [],
"disabled_categories": [],
"disabled_components": {}
},
"source": {
"url": "https://github.com/twjackysu/TWSEMCPServer",
"host": "github.com",
"name": "TWSEMCPServer",
"owner": "twjackysu"
},
"metrics": {
"overall": {
"key": "overall",
"band": "moderate",
"name": "Overall health",
"note": null,
"notes": [],
"value": 59,
"inputs": {
"security": 46,
"vitality": 89,
"community": 48,
"governance": 47,
"engineering": 61
},
"components": []
},
"categories": [
{
"key": "vitality",
"band": "excellent",
"name": "Vitality",
"value": 89,
"weight": 0.22,
"metrics": [
{
"key": "development_activity",
"band": "good",
"name": "Development activity",
"note": null,
"notes": [],
"value": 81,
"inputs": {
"commits_last_year": 155,
"human_commit_share": 1,
"days_since_last_push": 3,
"active_weeks_last_year": 24
},
"components": [
{
"key": "push_recency",
"name": "Push recency",
"detail": "last push 3 days ago",
"points": 36,
"status": "met",
"details": [
{
"code": "push_recency",
"params": {
"days": 3
}
}
],
"max_points": 36
},
{
"key": "commit_cadence",
"name": "Commit cadence",
"detail": "24/52 weeks with commits",
"points": 16.6,
"status": "partial",
"details": [
{
"code": "commit_cadence_weeks",
"params": {
"weeks": 24
}
}
],
"max_points": 36
},
{
"key": "commit_volume",
"name": "Commit volume",
"detail": "155 commits in the last year",
"points": 18,
"status": "met",
"details": [
{
"code": "commits_last_year",
"params": {
"count": 155
}
}
],
"max_points": 18
},
{
"key": "openssf_scorecard_maintained",
"name": "OpenSSF Scorecard: Maintained",
"detail": "30 commit(s) and 3 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": "Excluded from scoring (no data or not applicable): OpenSSF Scorecard: Signed-Releases. Remaining weights renormalized.",
"notes": [
{
"code": "excluded_no_data",
"params": {
"components": [
"openssf_scorecard_signed_releases"
]
}
},
{
"code": "weights_renormalized",
"params": {}
}
],
"value": 100,
"inputs": {
"releases_count": 13,
"latest_release_tag": "v1.8.0",
"releases_from_tags": false,
"days_since_latest_release": 4,
"mean_days_between_releases": 9.3
},
"components": [
{
"key": "ships_releases",
"name": "Ships releases",
"detail": "13 releases published",
"points": 27,
"status": "met",
"details": [
{
"code": "releases_published",
"params": {
"count": 13
}
}
],
"max_points": 27
},
{
"key": "release_recency",
"name": "Release recency",
"detail": "latest release 4 days ago",
"points": 36,
"status": "met",
"details": [
{
"code": "release_recency",
"params": {
"days": 4
}
}
],
"max_points": 36
},
{
"key": "release_cadence",
"name": "Release cadence",
"detail": "a release every ~9.3 days",
"points": 27,
"status": "met",
"details": [
{
"code": "release_cadence",
"params": {
"gap": 9.3
}
}
],
"max_points": 27
},
{
"key": "openssf_scorecard_signed_releases",
"name": "OpenSSF Scorecard: Signed-Releases",
"detail": "no releases found",
"points": 0,
"status": "excluded",
"details": [
{
"code": "no_data",
"params": {}
}
],
"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": 3,
"days_since_last_human_commit_is_floor": false
},
"components": [
{
"key": "project_is_still_maintained",
"name": "Project is still maintained",
"detail": "last human commit 3 days ago",
"points": 100,
"status": "met",
"details": [
{
"code": "abandonment_maintained",
"params": {
"days": 3
}
}
],
"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": 48,
"weight": 0.18,
"metrics": [
{
"key": "popularity",
"band": "at_risk",
"name": "Popularity & adoption",
"note": null,
"notes": [],
"value": 47,
"inputs": {
"forks": 37,
"stars": 133,
"watchers": 0,
"growth_state": "unverified",
"growth_factor_pct": 100,
"growth_unverified_reason": "no_history"
},
"components": [
{
"key": "stars",
"name": "Stars",
"detail": "133 stars",
"points": 34.4,
"status": "partial",
"details": [
{
"code": "stars",
"params": {
"count": 133
}
}
],
"max_points": 60
},
{
"key": "forks",
"name": "Forks",
"detail": "37 forks",
"points": 13,
"status": "partial",
"details": [
{
"code": "forks",
"params": {
"count": 37
}
}
],
"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": "moderate",
"name": "Community health",
"note": null,
"notes": [],
"value": 50,
"inputs": {
"has_readme": true,
"has_license": true,
"has_contributing": false,
"has_issue_template": false,
"has_code_of_conduct": false,
"has_pull_request_template": false
},
"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": 0,
"status": "missed",
"details": [],
"max_points": 18
},
{
"key": "code_of_conduct",
"name": "Code of conduct",
"detail": null,
"points": 0,
"status": "missed",
"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": 0,
"status": "missed",
"details": [],
"max_points": 6.3
}
]
}
],
"description": "Does the project have users, downloads, attention, and a welcoming setup for contributors?"
},
{
"key": "governance",
"band": "at_risk",
"name": "Sustainability & Governance",
"value": 47,
"weight": 0.24,
"metrics": [
{
"key": "maintainer_resilience",
"band": "critical",
"name": "Maintainer resilience (bus factor)",
"note": null,
"notes": [],
"value": 15,
"inputs": {
"bus_factor": 1,
"contributors_sampled": 4,
"top_contributor_share": 0.957
},
"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 96% of commits",
"points": 1,
"status": "partial",
"details": [
{
"code": "top_contributor_share",
"params": {
"share": 96
}
}
],
"max_points": 22.5
},
{
"key": "contributor_breadth",
"name": "Contributor breadth",
"detail": "4 contributors",
"points": 5.4,
"status": "partial",
"details": [
{
"code": "contributors_sampled",
"params": {
"count": 4
}
}
],
"max_points": 13.5
},
{
"key": "openssf_scorecard_contributors",
"name": "OpenSSF Scorecard: Contributors",
"detail": "project has 0 contributing companies or organizations -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 10
}
]
},
{
"key": "responsiveness",
"band": "good",
"name": "Issue & PR responsiveness",
"note": null,
"notes": [],
"value": 81,
"inputs": {
"merged_prs": 37,
"open_issues": 1,
"closed_issues": 20,
"issue_closed_ratio": 0.952,
"closed_unmerged_prs": 2
},
"components": [
{
"key": "issue_resolution",
"name": "Issue resolution",
"detail": "95% of issues closed",
"points": 44.5,
"status": "partial",
"details": [
{
"code": "issues_closed_share",
"params": {
"share": 95
}
}
],
"max_points": 46.75
},
{
"key": "pr_acceptance",
"name": "PR acceptance",
"detail": "37/39 decided PRs merged",
"points": 36.3,
"status": "partial",
"details": [
{
"code": "decided_prs_merged",
"params": {
"merged": 37,
"decided": 39
}
}
],
"max_points": 38.25
},
{
"key": "openssf_scorecard_code_review",
"name": "OpenSSF Scorecard: Code-Review",
"detail": "Found 1/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": 52,
"inputs": {
"followers": 13,
"owner_type": "User",
"is_verified": null,
"owner_login": "twjackysu",
"public_repos": 32,
"account_age_days": 3318
},
"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": "13 followers of twjackysu",
"points": 8.2,
"status": "partial",
"details": [
{
"code": "owner_followers",
"params": {
"count": 13,
"login": "twjackysu"
}
}
],
"max_points": 25
},
{
"key": "track_record",
"name": "Track record",
"detail": "32 public repos, account ~9 yr old",
"points": 23.1,
"status": "partial",
"details": [
{
"code": "public_repos",
"params": {
"count": 32
}
},
{
"code": "account_age_years",
"params": {
"years": 9
}
}
],
"max_points": 25
}
]
}
],
"description": "Will the project survive its people — bus factor, responsiveness, who backs it, and package upkeep?"
},
{
"key": "engineering",
"band": "moderate",
"name": "Engineering Quality",
"value": 61,
"weight": 0.2,
"metrics": [
{
"key": "engineering_practices",
"band": "moderate",
"name": "Engineering practices",
"note": null,
"notes": [],
"value": 68,
"inputs": {
"has_ci": true,
"has_tests": true,
"has_editorconfig": false,
"has_linter_config": false,
"has_precommit_config": false
},
"components": [
{
"key": "ci_workflows",
"name": "CI workflows",
"detail": "2 workflow(s)",
"points": 24,
"status": "met",
"details": [
{
"code": "ci_workflows",
"params": {
"count": 2
}
}
],
"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": 0,
"status": "missed",
"details": [],
"max_points": 16
},
{
"key": "pre_commit_hooks",
"name": "Pre-commit hooks",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 9.6
},
{
"key": "editorconfig",
"name": ".editorconfig",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 6.4
},
{
"key": "openssf_scorecard_ci_tests",
"name": "OpenSSF Scorecard: CI-Tests",
"detail": "13 out of 13 merged PRs checked by a CI test -- score normalized to 10",
"points": 20,
"status": "met",
"details": [],
"max_points": 20
}
]
},
{
"key": "documentation",
"band": "moderate",
"name": "Documentation",
"note": null,
"notes": [],
"value": 50,
"inputs": {
"topics": [
"analysis",
"mcp",
"mcp-server",
"questions-and-answers",
"trading"
],
"has_wiki": false,
"homepage": null,
"has_readme": true,
"has_docs_dir": false,
"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": 0,
"status": "missed",
"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": "5 topics",
"points": 10,
"status": "met",
"details": [
{
"code": "topics_count",
"params": {
"count": 5
}
}
],
"max_points": 10
},
{
"key": "wiki",
"name": "Wiki",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 10
}
]
}
],
"description": "Are baseline engineering and documentation practices in place?"
},
{
"key": "security",
"band": "at_risk",
"name": "Security",
"value": 46,
"weight": 0.16,
"metrics": [
{
"key": "security_posture",
"band": "at_risk",
"name": "Security posture",
"note": "Excluded from scoring (no data or not applicable): Branch-Protection, Signed-Releases. Remaining weights renormalized.",
"notes": [
{
"code": "excluded_no_data",
"params": {
"components": [
"branch_protection",
"signed_releases"
]
}
},
{
"code": "weights_renormalized",
"params": {}
}
],
"value": 46,
"inputs": {
"source": "openssf_scorecard",
"checks_evaluated": 16,
"scorecard_version": "v5.5.0",
"checks_inconclusive": 2,
"scorecard_aggregate": 4.6
},
"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": "internal error: error during branchesHandler.setup: internal error: some github tokens can't read classic branch protection rules: https://github.com/ossf/scorecard-action/blob/main/docs/authentication/fine-grained-auth-token.md",
"points": 0,
"status": "excluded",
"details": [
{
"code": "no_data",
"params": {}
}
],
"max_points": 7.5
},
{
"key": "ci_tests",
"name": "CI-Tests",
"detail": "13 out of 13 merged PRs checked by a CI test -- score normalized to 10",
"points": 2.5,
"status": "met",
"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 1/13 approved changesets -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.5
},
{
"key": "contributors",
"name": "Contributors",
"detail": "project has 0 contributing companies or organizations -- score normalized to 0",
"points": 0,
"status": "missed",
"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": "no update tool detected",
"points": 0,
"status": "missed",
"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 3 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 not detected",
"points": 0,
"status": "missed",
"details": [],
"max_points": 5
},
{
"key": "signed_releases",
"name": "Signed-Releases",
"detail": "no releases found",
"points": 0,
"status": "excluded",
"details": [
{
"code": "no_data",
"params": {}
}
],
"max_points": 7.5
},
{
"key": "token_permissions",
"name": "Token-Permissions",
"detail": "detected GitHub workflow tokens with excessive permissions",
"points": 6.8,
"status": "partial",
"details": [],
"max_points": 7.5
},
{
"key": "vulnerabilities",
"name": "Vulnerabilities",
"detail": "47 existing vulnerabilities detected",
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.5
}
]
},
{
"key": "dependency_advisories",
"band": "at_risk",
"name": "Dependency advisories",
"note": "Excluded from scoring (no data or not applicable): Indirect dependencies free of known advisories. Remaining weights renormalized. Matched 76 resolved dependencies against OSV; 5 could not be assessed (no resolved version, an unsupported ecosystem, or beyond the reported package list). This repository publishes no package the index resolves, so the repository dependency graph was assessed instead. That graph mixes development and test pins with shipped dependencies, so only the declared runtime dependencies are scored; transitive findings are reported as context and excluded from the score. Reachability is not analyzed.",
"notes": [
{
"code": "excluded_no_data",
"params": {
"components": [
"indirect_dependencies_free_of_known_advisories"
]
}
},
{
"code": "weights_renormalized",
"params": {}
},
{
"code": "advisories_scope_repository",
"params": {
"assessed": 76
}
},
{
"code": "advisories_unassessed",
"params": {
"count": 5
}
},
{
"code": "advisories_repo_graph_caveat",
"params": {}
},
{
"code": "advisories_reachability",
"params": {}
}
],
"value": 45,
"inputs": {
"source": "osv",
"advisories": 87,
"affected_packages": 15,
"assessed_packages": 76,
"unassessed_packages": 5,
"affected_by_severity": "critical 2, high 7, moderate 5, low 1",
"direct_affected_packages": 3
},
"components": [
{
"key": "direct_dependencies_free_of_known_advisories",
"name": "Direct dependencies free of known advisories",
"detail": "3 affected: fastmcp 2.12.3 (critical 10.0), mcp 1.27.0 (high 7.6), requests 2.32.4 (moderate 5.5)",
"points": 5.3,
"status": "partial",
"details": [
{
"code": "advisories_affected",
"params": {
"count": 3,
"packages": "fastmcp 2.12.3 (critical 10.0), mcp 1.27.0 (high 7.6), requests 2.32.4 (moderate 5.5)"
}
}
],
"max_points": 35
},
{
"key": "indirect_dependencies_free_of_known_advisories",
"name": "Indirect dependencies free of known advisories",
"detail": "transitive set not separable from development and test dependencies in this scope",
"points": 0,
"status": "excluded",
"details": [
{
"code": "advisories_scope_not_separable",
"params": {}
}
],
"max_points": 25
},
{
"key": "no_advisories_left_outstanding",
"name": "No advisories left outstanding",
"detail": "2 advisory-carrying package(s) unaddressed past 90 days; oldest published 267 days ago",
"points": 28.8,
"status": "partial",
"details": [
{
"code": "advisories_stale",
"params": {
"days": 90,
"count": 2,
"oldest": 267
}
}
],
"max_points": 40
}
]
},
{
"key": "malicious_dependencies",
"band": "excellent",
"name": "Malicious dependencies",
"note": null,
"notes": [],
"value": 100,
"inputs": {
"source": "osv",
"meaning": "reported as a malicious package by the OpenSSF corpus; the remedy is removal or moving off the compromised name, never an upgrade of the same artifact. Versions the registry has since pulled are listed but not scored",
"packages": [],
"red_flag": false,
"assessed_packages": 76,
"malicious_packages": 0,
"direct_malicious_packages": 0,
"withdrawn_malicious_packages": 0,
"installable_malicious_packages": 0
},
"components": [
{
"key": "no_dependency_reported_as_a_malicious_package",
"name": "No dependency reported as a malicious package",
"detail": "no dependency is reported as a malicious package",
"points": 100,
"status": "met",
"details": [
{
"code": "no_malicious_dependencies",
"params": {}
}
],
"max_points": 100
}
]
},
{
"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": "moderate",
"name": "AI Readiness",
"value": 54,
"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.97,
"agent_instruction_files": [
"CLAUDE.md"
],
"agent_instruction_max_bytes": 12651
},
"components": [
{
"key": "agent_instructions",
"name": "Agent instructions",
"detail": "CLAUDE.md",
"points": 45,
"status": "met",
"details": [
{
"code": "file_list",
"params": {
"files": "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": "97 of 100 human commits state their intent (structured subject or explanatory body)",
"points": 40,
"status": "met",
"details": [
{
"code": "legible_history",
"params": {
"legible": 97,
"sampled": 100
}
}
],
"max_points": 40
}
]
},
{
"key": "ai_verify_loop",
"band": "at_risk",
"name": "Verify loop (build / test / typecheck)",
"note": null,
"notes": [],
"value": 42,
"inputs": {
"has_nix": false,
"has_tests": true,
"lockfiles": [
"uv.lock"
],
"has_dockerfile": true,
"typed_language": false,
"bootstrap_files": [],
"has_devcontainer": false,
"has_linter_config": false,
"typecheck_configs": [],
"agent_commit_share": 0.07,
"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": 0,
"status": "missed",
"details": [],
"max_points": 11
},
{
"key": "static_type_checking",
"name": "Static type checking",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 11
},
{
"key": "reproducible_environment",
"name": "Reproducible environment",
"detail": "Dockerfile, lockfile",
"points": 10,
"status": "met",
"details": [
{
"code": "file_list",
"params": {
"files": "Dockerfile, lockfile"
}
}
],
"max_points": 10
},
{
"key": "demonstrated_agent_practice",
"name": "Demonstrated agent practice",
"detail": "7 of the last 100 commits agent-authored or agent-credited",
"points": 10,
"status": "met",
"details": [
{
"code": "agent_authored_commits",
"params": {
"count": 7,
"sampled": 100
}
}
],
"max_points": 10
},
{
"key": "automated_maintenance",
"name": "Automated maintenance",
"detail": "no automated dependency updates observed",
"points": 0,
"status": "missed",
"details": [
{
"code": "no_dependency_automation",
"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": "moderate",
"name": "Code legibility for models",
"note": null,
"notes": [],
"value": 55,
"inputs": {
"primary_language": "Python",
"largest_source_bytes": 20862,
"source_files_sampled": 103,
"oversized_source_files": 0
},
"components": [
{
"key": "type_checkable_code",
"name": "Type-checkable code",
"detail": "Python without a type-check config",
"points": 0,
"status": "missed",
"details": [
{
"code": "no_typecheck_config_language",
"params": {
"language": "Python"
}
}
],
"max_points": 45
},
{
"key": "manageable_file_sizes",
"name": "Manageable file sizes",
"detail": "0/103 source files over 60KB",
"points": 55,
"status": "met",
"details": [
{
"code": "oversized_source_files",
"params": {
"kb": 60,
"sampled": 103,
"oversized": 0
}
}
],
"max_points": 55
}
]
},
{
"key": "ai_interfaces",
"band": "critical",
"name": "Machine-readable interfaces",
"note": null,
"notes": [],
"value": 20,
"inputs": {
"example_dirs": [],
"has_mcp_signal": true,
"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": 20,
"status": "met",
"details": [],
"max_points": 20
},
{
"key": "runnable_examples",
"name": "Runnable examples",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"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": [
"Star history unavailable: GitHub GraphQL error: Resource not accessible by personal access token",
"Could not fetch pypi package 'twstockmcpserver' from its registry"
],
"report_type": "repository",
"generated_at": "2026-07-24T06:33:17.668883Z",
"schema_version": "0.27.0",
"badge_url": "https://raw.githubusercontent.com/inspect-software/badges/main/v1/t/twjackysu/TWSEMCPServer.svg",
"full_name": "twjackysu/TWSEMCPServer",
"license_state": "standard",
"license_spdx": "MIT"
}Scores are signals, not warranties. They reflect publicly visible practices on GitHub — not a code audit, and not a security guarantee.
Missing data is excluded and weights renormalized, never scored as zero. Methodology is versioned and open: metrics v1.13.0, schema v0.27.0 — full methodology · metrics wiki.
How one result sits in the wider record: aggregate statistics.