Public record
Software health reportschema 0.27.0 · metrics 1.13.0 · 2026-07-28 03:13 UTC

thinh-vu / vnstock

A beginner-friendly yet powerful Python toolkit for financial analysis and automation — built to make modern investing accessible to everyone

PythonCustom license★ 1,358 stars⑂ 292 forkssince Feb 2022View on GitHub ↗

thinh-vu/vnstock holds a health index of 70 out of 100, placing it in the Good band. It scores highest on Vitality (85/100) and lowest on Security (50/100). It was last updated 3 days ago. A single contributor accounts for most of its recent work.

70
overall / 100
Good

Software 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.

70
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)
VitalityCommunity &AdoptionSustainability &GovernanceEngineeringQualitySecurityAI Readiness

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

Thinh VuPersonal account
289 followers26 public repossince May 2018Vnstock

This repository is owned by a personal account. A single-owner project carries more continuity risk than an organization-backed one.

Package ecosystems

RegistryPackageVersionDownloads / moVersionsLast publishTags
PyPIvnstock4.0.5-663 days agovnstockfinancevietnamstock-marketanalysisapi

Metrics by category

Vitality

Is the project alive — is code being written and are releases shipping?

85Excellent · 22% of overall
How it's scored
36/36Push recency — last push 3 days ago
15.9/36Commit cadence — 23/52 weeks with commits
17.8/18Commit volume — 95 commits in the last year
10/10OpenSSF Scorecard: Maintained — 11 commit(s) and 2 issue activity found in the last 90 days -- score normalized to 10
Inputs used
commits_last_year95
human_commit_share1
days_since_last_push3
active_weeks_last_year23
How it's scored
27/27Ships releases — 9 releases published
36/36Release recency — latest release 18 days ago
19.8/27Release cadence — a release every ~59.2 days
0/10OpenSSF Scorecard: Signed-Releases — no data
Inputs used
releases_count9
latest_release_tagv4.0.4
releases_from_tagsno
days_since_latest_release18
mean_days_between_releases59.2
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?

64Moderate · 18% of overall
How it's scored
50.8/60Stars — 1,358 stars
20.5/25Forks — 292 forks
9.6/15Watchers — 54 watchers
Inputs used
forks292
stars1,358
watchers54
growth_stateunverified
growth_factor_pct100
growth_unverified_reasonno_history
How it's scored
22.5/22.5README
16.9/22.5License — license file present, not a recognized license
0/18CONTRIBUTING guide
0/13.5Code of conduct
0/7.2Issue template
0/6.3PR template
Inputs used
has_readmeyes
has_licenseyes
has_contributingno
has_issue_templateno
has_code_of_conductno
has_pull_request_templateno

Sustainability & Governance

Will the project survive its people — bus factor, responsiveness, who backs it, and package upkeep?

62Moderate · 24% of overall
How it's scored
9/54Bus factor — 1 contributor(s) cover half of all commits
0.9/22.5Commit distribution — top contributor authored 96% of commits
13.5/13.5Contributor breadth — 12 contributors
3/10OpenSSF Scorecard: Contributors — project has 1 contributing companies or organizations -- score normalized to 3
Inputs used
bus_factor1
contributors_sampled12
top_contributor_share0.961
How it's scored
46.8/46.8Issue resolution — 100% of issues closed
28.6/38.3PR acceptance — 68/91 decided PRs merged
0/15OpenSSF Scorecard: Code-Review — Found 1/30 approved changesets -- score normalized to 0
Inputs used
merged_prs68
open_issues0
closed_issues132
issue_closed_ratio1
closed_unmerged_prs23
How it's scored
10/30Ownership backing — personal (user) account
0/20Verified domain — not applicable to user accounts
17.7/25Owner reach — 289 followers of thinh-vu
22.4/25Track record — 26 public repos, account ~8 yr old
Inputs used
followers289
owner_typeUser
is_verified
owner_loginthinh-vu
public_repos26
account_age_days2,981
Excluded from scoring (no data or not applicable): Verified domain. Remaining weights renormalized.
How it's scored
25/25Published & resolvable — 1 package(s) on pypi
35/35Publish recency — latest publish 3 days ago
20/20Version history — 66 published versions
20/20Not deprecated — active, not deprecated or yanked
Inputs used
packagesvnstock
ecosystemspypi
any_deprecatedno
min_days_since_publish3

Engineering Quality

Are baseline engineering and documentation practices in place?

84Good · 20% of overall
How it's scored
24/24CI workflows — 5 workflow(s)
24/24Tests present
16/16Linter config — .flake8
9.6/9.6Pre-commit hooks
0/6.4.editorconfig
0/20OpenSSF Scorecard: CI-Tests — 0 out of 1 merged PRs checked by a CI test -- score normalized to 0
Inputs used
has_ciyes
has_testsyes
has_editorconfigno
has_linter_configyes
has_precommit_configyes

Documentation

100Excellent
How it's scored
30/30README
25/25Documentation directory
15/15Documentation / homepage site — https://vnstocks.com
10/10Repository description
10/10Topics — 6 topics
10/10Wiki
Inputs used
topicsstock-market, data-extraction, stock-screener, quantitative-finance, quantitative-analysis, quantitative-trading
has_wikiyes
homepagehttps://vnstocks.com
has_readmeyes
has_docs_diryes
has_descriptionyes

Security

Are visible security and supply-chain practices strong, without unresolved high-risk jurisdiction exposure?

50Moderate · 16% of overall
How it's scored
7.5/7.5Binary-Artifacts — no binaries found in the repo
2.2/7.5Branch-Protection — branch protection is not maximal on development and all release branches
0/2.5CI-Tests — 0 out of 1 merged PRs checked by a CI test -- score normalized to 0
0/2.5CII-Best-Practices — no effort to earn an OpenSSF best practices badge detected
0/7.5Code-Review — Found 1/30 approved changesets -- score normalized to 0
0.8/2.5Contributors — project has 1 contributing companies or organizations -- score normalized to 3
10/10Dangerous-Workflow — no dangerous workflow patterns detected
0/7.5Dependency-Update-Tool — no update tool detected
0/5Fuzzing — project is not fuzzed
2.2/2.5License — license file detected
7.5/7.5Maintained — 11 commit(s) and 2 issue activity found in the last 90 days -- score normalized to 10
0/5Packaging — no data
0/5Pinned-Dependencies — dependency not pinned by hash detected -- score normalized to 0
0/5SAST — SAST tool is not run on all commits -- score normalized to 0
0/5Security-Policy — security policy file not detected
0/7.5Signed-Releases — no data
0/7.5Token-Permissions — detected GitHub workflow tokens with excessive permissions
3.8/7.5Vulnerabilities — 5 existing vulnerabilities detected
Inputs used
sourceopenssf_scorecard
checks_evaluated16
scorecard_versionv5.5.0
checks_inconclusive2
scorecard_aggregate3.7
Excluded from scoring (no data or not applicable): packaging, signed_releases. Remaining weights renormalized.
How it's scored
35/35Direct dependencies free of known advisories — no direct dependency carries a known advisory
25/25Indirect dependencies free of known advisories — no indirect dependency carries a known advisory
0/40No advisories left outstanding — no advisory carries a publication date
Inputs used
sourceosv
advisories0
affected_packages0
assessed_packages38
unassessed_packages0
affected_by_severitynone
direct_affected_packages0
Excluded from scoring (no data or not applicable): No advisories left outstanding. Remaining weights renormalized. Matched the pypi:vnstock@4.0.5 runtime dependency closure — what installing the published package pulls in — 38 packages. 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.

64Moderate · 0% of overall
How it's scored
45/45Agent instructions — AGENTS.md
0/15Machine-readable docs (llms.txt)
39.5/40Legible commit history — 74 of 100 human commits state their intent (structured subject or explanatory body)
Inputs used
has_llms_txtno
legible_history_share0.74
agent_instruction_filesAGENTS.md
agent_instruction_max_bytes3,903
How it's scored
18/18One-command bootstrap — Makefile
22/22Automated tests
11/11Lint / format config — .flake8
0/11Static type checking
10/10Reproducible environment — devcontainer
0/10Demonstrated agent practice — no agent-authored commits among the last 100
0/8Automated maintenance — no automated dependency updates observed
0/10OpenSSF Scorecard: Pinned-Dependencies — dependency not pinned by hash detected -- score normalized to 0
Inputs used
has_nixno
has_testsyes
lockfiles
has_dockerfileno
typed_languageno
bootstrap_filesMakefile
has_devcontaineryes
has_linter_configyes
typecheck_configs
agent_commit_share0
toolchain_manifests
dependency_bot_commit_share0
How it's scored
0/45Type-checkable code — Python without a type-check config
55/55Manageable file sizes — 0/151 source files over 60KB
Inputs used
primary_languagePython
largest_source_bytes55,284
source_files_sampled151
oversized_source_files0
How it's scored
0/40API schema (OpenAPI/GraphQL/proto)
0/20MCP server
40/40Runnable examples — examples, notebooks
Inputs used
example_dirsexamples, notebooks
has_mcp_signalno
api_schema_files

Key facts

1,358GitHub stars
12contributors
95commits, last 12 months
3days since last push
9releases
1bus factor
0open issues
PyPIpackage ecosystems

Data collection warnings

  • Star history unavailable: GitHub GraphQL error: Resource not accessible by personal access token

More detail

Star and fork history 0 ★ / 292 ⇿
0Stars
292Forks
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.

05010015020025030029072022-082024-082026-07
Major 0Minor 3Patch 6

Each point covers 4 days.

OpenSSF Scorecard 3.7 / 10
3.7aggregate

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).Scorecard v5.5.0 · 2026-07-28 03:13 UTC

10Binary-Artifactsno binaries found in the repo
3Branch-Protectionbranch protection is not maximal on development and all release branches
0CI-Tests0 out of 1 merged PRs checked by a CI test -- score normalized to 0
0CII-Best-Practicesno effort to earn an OpenSSF best practices badge detected
0Code-ReviewFound 1/30 approved changesets -- score normalized to 0
3Contributorsproject has 1 contributing companies or organizations -- score normalized to 3
10Dangerous-Workflowno dangerous workflow patterns detected
0Dependency-Update-Toolno update tool detected
0Fuzzingproject is not fuzzed
9Licenselicense file detected
10Maintained11 commit(s) and 2 issue activity found in the last 90 days -- score normalized to 10
n/aPackagingpackaging workflow not detected
0Pinned-Dependenciesdependency not pinned by hash detected -- score normalized to 0
0SASTSAST tool is not run on all commits -- score normalized to 0
0Security-Policysecurity policy file not detected
n/aSigned-Releasesno releases found
0Token-Permissionsdetected GitHub workflow tokens with excessive permissions
5Vulnerabilities5 existing vulnerabilities detected
Direct dependencies 13
RegistryPackageVersion constraintManifest
PyPIrequestspyproject.toml
PyPIbeautifulsoup4pyproject.toml
PyPIpandaspyproject.toml
PyPIseabornpyproject.toml
PyPIopenpyxlpyproject.toml
PyPIpydanticpyproject.toml
PyPIpsutilpyproject.toml
PyPIpackaging>=20.0pyproject.toml
PyPIimportlib-metadata>=1.0pyproject.toml
PyPItenacitypyproject.toml
PyPIvnai>=2.5.2pyproject.toml
PyPIvnstock_ezchart>=1.0.1pyproject.toml
PyPIpytzpyproject.toml
All dependencies 25

Full resolved dependency set from the GitHub dependency graph: 16 direct and 9 indirect (transitive) packages. The transitive closure is complete when the repository commits a lockfile.

RegistryPackageVersionRelation
PyPIbeautifulsoup4direct
PyPIimportlib-metadatadirect
PyPIopenpyxldirect
PyPIopenpyxl3.1.2direct
PyPIpackagingdirect
PyPIpandasdirect
PyPIpsutildirect
PyPIpsutil6.0.0direct
PyPIpydanticdirect
PyPIpytzdirect
PyPIrequestsdirect
PyPIseaborndirect
PyPIseaborn0.13.2direct
PyPItenacitydirect
PyPIvnaidirect
PyPIvnstock-ezchartdirect
PyPIbs40.0.2indirect
PyPIcryptography42.0.5indirect
PyPIfake-useragent1.5.1indirect
PyPImkdocs-glightboxindirect
PyPImkdocs-materialindirect
PyPImkdocs-rss-pluginindirect
PyPIpytestindirect
PyPIpytest-covindirect
PyPIsetuptoolsindirect
Dependency advisories 0

Installing pypi:vnstock@4.0.5 pulls in 38 packages, direct and transitive: 0 carry known advisories, of which 0 are direct dependencies.

No known advisories affect the assessed dependencies.

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": [
        "stock-market",
        "data-extraction",
        "stock-screener",
        "quantitative-finance",
        "quantitative-analysis",
        "quantitative-trading"
      ],
      "is_fork": false,
      "size_kb": 68018,
      "has_wiki": true,
      "homepage": "https://vnstocks.com",
      "languages": {
        "Python": 1109972,
        "Makefile": 1471
      },
      "pushed_at": "2026-07-24T10:59:32Z",
      "created_at": "2022-02-27T02:44:34Z",
      "owner_type": "User",
      "updated_at": "2026-07-27T19:26:00Z",
      "description": "A beginner-friendly yet powerful Python toolkit for financial analysis and automation — built to make modern investing accessible to everyone",
      "is_archived": false,
      "is_disabled": false,
      "license_spdx": null,
      "default_branch": "main",
      "license_spdx_raw": "NOASSERTION",
      "primary_language": "Python",
      "significant_languages": [
        "Python"
      ]
    },
    "owner": {
      "blog": "vnstocks.com",
      "name": "Thinh Vu",
      "type": "User",
      "login": "thinh-vu",
      "company": "Vnstock",
      "location": "Ho Chi Minh City, Vietnam",
      "followers": 289,
      "avatar_url": "https://avatars.githubusercontent.com/u/39723360?v=4",
      "created_at": "2018-05-29T06:57:44Z",
      "is_verified": null,
      "public_repos": 26,
      "account_age_days": 2981
    },
    "license": {
      "state": "custom",
      "spdx_id": null,
      "raw_spdx": "NOASSERTION",
      "file_present": true,
      "scorecard_found": true,
      "profile_has_license": true
    },
    "activity": {
      "releases": [
        {
          "tag": "v4.0.4",
          "kind": "patch",
          "published_at": "2026-07-09T23:31:08Z"
        },
        {
          "tag": "v4.0.2",
          "kind": "patch",
          "published_at": "2026-04-30T08:52:53Z"
        },
        {
          "tag": "v3.5.0",
          "kind": "minor",
          "published_at": "2026-03-11T15:12:59Z"
        },
        {
          "tag": "v3.4.0",
          "kind": "minor",
          "published_at": "2026-01-23T02:15:10Z"
        },
        {
          "tag": "v3.3.0",
          "kind": "minor",
          "published_at": "2025-11-11T17:43:50Z"
        },
        {
          "tag": "v3.2.7",
          "kind": "patch",
          "published_at": "2025-11-10T02:17:28Z"
        },
        {
          "tag": "v2.2.3",
          "kind": "patch",
          "published_at": "2025-03-27T17:42:17Z"
        },
        {
          "tag": "v3.2.2",
          "kind": "patch",
          "published_at": "2025-03-24T14:44:27Z"
        },
        {
          "tag": "v3.2.1",
          "kind": "patch",
          "published_at": "2025-03-23T13:32:23Z"
        }
      ],
      "recent_commits": [
        {
          "oid": "72e6a75016da96173fd7dd26f1011e14fb3dfbf7",
          "body": "…kground initialization",
          "is_bot": false,
          "headline": "feat: implement dynamic AI agent environment setup with automated bac…",
          "author_name": "thinh-vu",
          "author_login": "thinh-vu",
          "committed_at": "2026-07-24T10:59:27Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "859870379127f9dc10824bf0d17d603836adbdee",
          "body": null,
          "is_bot": false,
          "headline": "chore: remove changelog entry for automated JSON schema formatting",
          "author_name": "Thinh Vu",
          "author_login": "thinh-vu",
          "committed_at": "2026-07-23T03:11:34Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "8c2f4d7ec0da6044e01930c7907d860cb5b6879b",
          "body": "…nal skill loader, and enable integration test skips",
          "is_bot": false,
          "headline": "refactor: unify parameter handling for OHLCV methods, introduce inter…",
          "author_name": "Thinh Vu",
          "author_login": "thinh-vu",
          "committed_at": "2026-07-09T23:29:14Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "60d469c6bf180d09b6483e364f80a384198b59df",
          "body": "…n README.md",
          "is_bot": false,
          "headline": "docs: update installation instructions and repository documentation i…",
          "author_name": "Thinh Vu",
          "author_login": "thinh-vu",
          "committed_at": "2026-06-26T13:11:23Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "e411bb33cb98ac765fff9897b0b3af11dd5bc953",
          "body": "…shots, and improve data fetching robustness",
          "is_bot": false,
          "headline": "refactor: update developer guidelines, standardize documentation snap…",
          "author_name": "Thinh Vu",
          "author_login": "thinh-vu",
          "committed_at": "2026-06-26T13:07:20Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "5bf05e3e494b1d109750c143e964945ed7be3f7d",
          "body": null,
          "is_bot": false,
          "headline": "Merge branch 'main' of https://github.com/thinh-vu/vnstock",
          "author_name": "Thinh Vu",
          "author_login": "thinh-vu",
          "committed_at": "2026-05-16T02:29:16Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "c196bc599fd71471686df77334725dc42302b1f8",
          "body": "…e MSN data resolution logic",
          "is_bot": false,
          "headline": "feat: add bond market support, improve VCI symbol handling, and updat…",
          "author_name": "Thinh Vu",
          "author_login": "thinh-vu",
          "committed_at": "2026-05-16T02:29:05Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "c62449db8ed489466cbbe574ecbe9f15545d3a25",
          "body": "…on to interval across all market domains",
          "is_bot": false,
          "headline": "refactor: standardize historical data parameters by renaming resoluti…",
          "author_name": "thinh-vu",
          "author_login": "thinh-vu",
          "committed_at": "2026-05-13T00:23:02Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "d129a7f31739f8378b5741547f98264dd463ae9d",
          "body": null,
          "is_bot": false,
          "headline": "chore: remove tracked .DS_Store files and ignore them",
          "author_name": "thinh-vu",
          "author_login": "thinh-vu",
          "committed_at": "2026-05-02T10:19:44Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "2e38cbd583f1413b880f50c92b6b6b14642d1e32",
          "body": "…ipt for data validation",
          "is_bot": false,
          "headline": "feat: add comprehensive data schema snapshots and generate helper scr…",
          "author_name": "thinh-vu",
          "author_login": "thinh-vu",
          "committed_at": "2026-05-02T07:43:23Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "c4d2c3b4d81df0b54ad708b51ad2b3cb6f9b23af",
          "body": "…nded test coverage, and cleanup of legacy assets.",
          "is_bot": false,
          "headline": "refactor: overhaul codebase structure with unified UI framework, expa…",
          "author_name": "thinh-vu",
          "author_login": "thinh-vu",
          "committed_at": "2026-05-01T23:57:46Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "ad78af0a4b57fa5bd0f550e0f2958267049e1851",
          "body": "…ation logic in common module",
          "is_bot": false,
          "headline": "refactor: remove redundant UI info methods and centralize index valid…",
          "author_name": "thinh-vu",
          "author_login": "thinh-vu",
          "committed_at": "2026-04-28T21:14:58Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "2e1b6fdcb430c8f7c6bdfa7a76d6fd0e85a79c0f",
          "body": null,
          "is_bot": false,
          "headline": "chore: update Colab and Codespaces links in documentation notebooks",
          "author_name": "Thinh Vu",
          "author_login": "thinh-vu",
          "committed_at": "2026-04-28T11:10:59Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "12c6547e914091f376b21db32f8192bedead253d",
          "body": "…orator and enhance MSN historical data timezone handling",
          "is_bot": false,
          "headline": "refactor: standardize provider execution using optimize_execution dec…",
          "author_name": "Thinh Vu",
          "author_login": "thinh-vu",
          "committed_at": "2026-04-28T05:53:48Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "dc7eca00c12f5d3e5469dcafa47714a834025320",
          "body": "feat: implement modular domain-driven UI layer for market, reference, fundamental, and broker data services",
          "is_bot": false,
          "headline": "release: Vnstock 4.0",
          "author_name": "Thinh Vu",
          "author_login": "thinh-vu",
          "committed_at": "2026-04-28T00:46:36Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "3bf3519b9770daa38e2138f135109b8bb1843c72",
          "body": "… filtering, custom limits, and transposed output format",
          "is_bot": false,
          "headline": "refactor: update VCI financial report data fetching to support period…",
          "author_name": "thinh-vu",
          "author_login": "thinh-vu",
          "committed_at": "2026-04-27T01:26:44Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "d87da7be4c9612b6a272a5d74e87ed9e65e437d9",
          "body": "…y detection logic",
          "is_bot": false,
          "headline": "refactor: update VCI API endpoints to REST and improve sponsor librar…",
          "author_name": "thinh-vu",
          "author_login": "thinh-vu",
          "committed_at": "2026-04-26T15:40:30Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "fd510b94fc1342d41bc0ab7a7798f51b07cc7c29",
          "body": null,
          "is_bot": false,
          "headline": "chore: update project dependencies and metadata in pyproject.toml",
          "author_name": "thinh-vu",
          "author_login": "thinh-vu",
          "committed_at": "2026-04-05T20:14:31Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "b71b79b84a98f441eb979961c96bc76b023c3a8c",
          "body": null,
          "is_bot": false,
          "headline": "refactor: remove TCBS source support and update test parameters to KBS",
          "author_name": "thinh-vu",
          "author_login": "thinh-vu",
          "committed_at": "2026-04-05T20:06:04Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "cc12a093df9f6d5b90587efbc0583d5e4fe64d66",
          "body": "…introduce sponsor migration utilities",
          "is_bot": false,
          "headline": "refactor: align KBS price board schema, add AI agent guardrails, and …",
          "author_name": "thinh-vu",
          "author_login": "thinh-vu",
          "committed_at": "2026-04-05T19:38:27Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "db3609169d9ce8e8d0e8fbf59c4294c2b28ace8b",
          "body": "…oject.toml.",
          "is_bot": false,
          "headline": "refactor: rename market-events.py to market_events.py and update pypr…",
          "author_name": "Thinh Vu",
          "author_login": "thinh-vu",
          "committed_at": "2026-03-11T15:10:20Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "9d5bf9dca816e64e473276b353788ac5e61e4971",
          "body": null,
          "is_bot": false,
          "headline": "feat: Add market events module and enhance upgrade suggestion messages.",
          "author_name": "Thinh Vu",
          "author_login": "thinh-vu",
          "committed_at": "2026-03-08T15:16:02Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "c0ca6963761dddb027b019913da3bc115db289e3",
          "body": null,
          "is_bot": false,
          "headline": "chore: bump version to 3.4.3 in pyproject.toml",
          "author_name": "Thinh Vu",
          "author_login": "thinh-vu",
          "committed_at": "2026-03-07T01:01:33Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "5039406065c623e1042d37b9bedf68cad8d2a775",
          "body": "… commands",
          "is_bot": false,
          "headline": "feat: Enhance upgrade process with environment detection and tailored…",
          "author_name": "Thinh Vu",
          "author_login": "thinh-vu",
          "committed_at": "2026-03-07T01:01:14Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "e27b4c8964fa3fbee0ba93edef90c255def1ccc1",
          "body": null,
          "is_bot": false,
          "headline": "feat: Add market events utility module.",
          "author_name": "Thinh Vu",
          "author_login": "thinh-vu",
          "committed_at": "2026-03-06T22:30:39Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "100e84091ecb6ad5b6b7a828b657dabb118a9d65",
          "body": null,
          "is_bot": false,
          "headline": "Remove TCBS data provider and Screener API.",
          "author_name": "Thinh Vu",
          "author_login": "thinh-vu",
          "committed_at": "2026-03-05T16:18:01Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "1d33198eac5a92f2219fc5480e399e1b1491864e",
          "body": "…ng in data processing",
          "is_bot": false,
          "headline": "feat: add pandas compatibility utilities and enhance frequency handli…",
          "author_name": "Thinh Vu",
          "author_login": "thinh-vu",
          "committed_at": "2026-03-02T09:14:43Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "613e1ced572fdb4e1d51444714ad29cc8bb39dd7",
          "body": "… verification",
          "is_bot": false,
          "headline": "fix: update Python script execution method in CI workflow for API key…",
          "author_name": "Thinh Vu",
          "author_login": "thinh-vu",
          "committed_at": "2026-03-02T08:47:16Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "f02ac5bb9396396350ae855f765d07bf6e54d669",
          "body": "…ve linting and testing configurations",
          "is_bot": false,
          "headline": "feat: enhance CI workflows with API key setup and verification, impro…",
          "author_name": "Thinh Vu",
          "author_login": "thinh-vu",
          "committed_at": "2026-03-02T08:42:59Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "dd675bb32705ae088d6f21d0171ab8552b004215",
          "body": "* fix(deps): add pytz to project dependencies\n\n* chore: remove lockfile",
          "is_bot": false,
          "headline": "fix(deps): add pytz to project dependencies (#217)",
          "author_name": "Minh Dang Hoang",
          "author_login": "HMDank",
          "committed_at": "2026-02-27T15:40:04Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "4917ae00485ac26c544155b1b6d67fd00a8a87bb",
          "body": "…d Windows.",
          "is_bot": false,
          "headline": "docs: update agent guide file copying instructions for macOS/Linux an…",
          "author_name": "Thinh Vu",
          "author_login": "thinh-vu",
          "committed_at": "2026-02-02T04:37:34Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "88e69706449f316d38e01ce9de78447e3d5e7814",
          "body": "… lacks an exchange column.",
          "is_bot": false,
          "headline": "fix: Add fallback to fetch symbols by exchange if the initial listing…",
          "author_name": "thinh-vu",
          "author_login": "thinh-vu",
          "committed_at": "2026-02-01T08:27:16Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "9c6f21bfe2764d0cd3263cbb917e952919784e30",
          "body": null,
          "is_bot": false,
          "headline": "Merge branch 'main' of https://github.com/thinh-vu/vnstock",
          "author_name": "thinh-vu",
          "author_login": "thinh-vu",
          "committed_at": "2026-02-01T07:15:23Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "ac0cd77f4adf44df95c4445be67a6bf8f8bf7c08",
          "body": "…KBS field mappings, and update related API, utility, and test files.",
          "is_bot": false,
          "headline": "Refactor test documentation into a dedicated subdirectory, introduce …",
          "author_name": "thinh-vu",
          "author_login": "thinh-vu",
          "committed_at": "2026-02-01T04:02:13Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "25bdfd95935318d15de1e6bb652115f45bc3b863",
          "body": "…ex support, and refactor field normalization with built-in mappings.",
          "is_bot": false,
          "headline": "feat: Introduce derivative symbol conversion, enhance KBS and VCI ind…",
          "author_name": "Thinh Vu",
          "author_login": "thinh-vu",
          "committed_at": "2026-01-27T16:39:32Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "e334389ba1b9cbcfd69ffe402948e530b484508a",
          "body": "…ve redundant index methods",
          "is_bot": false,
          "headline": "refactor: update Listing class to enforce source requirement and remo…",
          "author_name": "Thinh Vu",
          "author_login": "thinh-vu",
          "committed_at": "2026-01-23T07:11:57Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "3b01b33a1ca794ebebdfce154f4a66535c967358",
          "body": "…and update Python version",
          "is_bot": false,
          "headline": "docs: enhance quickstart guide with Vnstock Agent Guide instructions …",
          "author_name": "thinh-vu",
          "author_login": "thinh-vu",
          "committed_at": "2026-01-22T17:51:11Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "ab8cbc84dfb72253c3384e04c5ef5fe3e5b39259",
          "body": "…file loading warnings",
          "is_bot": false,
          "headline": "refactor: update FieldHandler to use built-in KBS mappings and avoid …",
          "author_name": "thinh-vu",
          "author_login": "thinh-vu",
          "committed_at": "2026-01-22T16:56:16Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "b8be61a2edfb065adade13502c7bc8397911a969",
          "body": "…t.toml",
          "is_bot": false,
          "headline": "chore: update vnai dependency version from 2.3.0 to 2.3.9 in pyprojec…",
          "author_name": "thinh-vu",
          "author_login": "thinh-vu",
          "committed_at": "2026-01-22T16:00:33Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "e7f698dde131f0800a2353a5745de5e63891271e",
          "body": "… with 1,326 standardized field definitions\n\n- Replaced external JSON file loading with built-in dictionary containing comprehensive KBS financial field mappings\n- Added _load_builtin_mappings() method to initialize 1,326+ standardized field mappings internally\n- Included Vietnamese/English field names, snake_case conversions, and conflict resolution flags\n- Covers complete financial statement fields: income statement, balance sheet, cash flow statement",
          "is_bot": false,
          "headline": "refactor: convert KBSFieldMapper from file-based to built-in mappings…",
          "author_name": "Thinh Vu",
          "author_login": "thinh-vu",
          "committed_at": "2026-01-22T15:56:33Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "ed56f0716c6febccdf80d41a6ff4f235e3a8510e",
          "body": "…) method\n\n- Reordered df.attrs assignments to group interval/length before start/end dates\n- Removed count_back and get_all attributes from DataFrame metadata\n- Cleaned up inline comment for start attribute assignment",
          "is_bot": false,
          "headline": "refactor: reorganize DataFrame attributes order in KBS Quote.history(…",
          "author_name": "Thinh Vu",
          "author_login": "thinh-vu",
          "committed_at": "2026-01-22T13:30:07Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "73d506fb8968ae33e9d31bf5117e4dd050934971",
          "body": "…l workflows\n\n- Updated actions/upload-artifact from v3 to v4 in code-quality.yml (security report)\n- Updated actions/upload-artifact from v3 to v4 in coverage-report.yml (coverage artifacts)\n- Updated actions/upload-artifact from v3 to v4 in performance.yml (performance report)\n- Updated actions/upload-artifact from v3 to v4 in test.yml (distribution artifacts)",
          "is_bot": false,
          "headline": "chore: upgrade GitHub Actions upload-artifact from v3 to v4 across al…",
          "author_name": "Thinh Vu",
          "author_login": "thinh-vu",
          "committed_at": "2026-01-22T06:05:37Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "6ee781823183453f99bafe68ea2a5b9b73e02b8b",
          "body": "…ed TCBS comprehensive tests\n\n- Updated test coverage data (.coverage binary)\n- Added comprehensive CI/CD pipeline documentation in CHANGELOG (GitHub Actions, multi-platform testing, code quality checks)\n- Changed default source from VCI to KBS in integration and unit tests\n- Updated Vnstock.SUPPORTED_SOURCES to include KBS as first option\n- Removed 262-line test_tcbs_quote_comprehensive.py with legacy TCBS Quote tests\n- Removed 247",
          "is_bot": false,
          "headline": "chore: update test suite with KBS as default source and remove outdat…",
          "author_name": "Thinh Vu",
          "author_login": "thinh-vu",
          "committed_at": "2026-01-22T06:02:03Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "826ec6c101b616d4f989ec1df45b716114275c23",
          "body": "…k_ezchart fallback\n\n- Implemented automatic backend selection prioritizing vnstock_chart (professional) over vnstock_ezchart (fallback)\n- Added Chart class backend parameter for explicit charting library selection\n- Implemented vnstock_chart methods: line(), bar(), candle(), scatter(), boxplot(), heatmap()\n- Maintained vnstock_ezchart fallback support for all existing chart types\n- Added automatic chart rendering in Jupyter/IPython environments\n- Improve",
          "is_bot": false,
          "headline": "feat: add dual charting backend support with vnstock_chart and vnstoc…",
          "author_name": "Thinh Vu",
          "author_login": "thinh-vu",
          "committed_at": "2026-01-22T05:49:46Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "9098665ca7bf336755e3a66d798d9111f3782db8",
          "body": "…, advanced options, and helper functions for robust snake_case conversion.",
          "is_bot": false,
          "headline": "feat: Overhaul Vietnamese text normalization with a new character map…",
          "author_name": "Thinh Vu",
          "author_login": "thinh-vu",
          "committed_at": "2026-01-20T15:25:29Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "8c64c963f86b82734bca09812a5811a2b836efc7",
          "body": "- Added comprehensive AI-powered coding guide with step-by-step setup instructions\n- Documented support for 7 AI agents (Google Antigravity, Cursor, Windsurf, Claude Code, VS Code Copilot, Google Colab)\n- Added direct API key registration example with api_key parameter\n- Reorganized manual coding section under \"Traditional Usage\" heading\n- Fixed indentation for tier list items (Guest/Community/Sponsor) for better markdown rendering",
          "is_bot": false,
          "headline": "docs: add AI-powered vibe coding section and improve README formatting",
          "author_name": "thinh-vu",
          "author_login": "thinh-vu",
          "committed_at": "2026-01-17T17:10:01Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "b36b255598cabd24376b9b4db8488b7b2f94c074",
          "body": "- Added optional api_key parameter to register_user() function for programmatic registration\n- Implemented _register_api_key_directly() for non-interactive API key setup\n- Refactored interactive registration into separate _register_interactive() function\n- Added API key validation (minimum 10 characters) for direct registration\n- Display masked API key and tier information after successful direct registration\n- Added vnai module",
          "is_bot": false,
          "headline": "feat: add direct API key registration support with non-interactive mode",
          "author_name": "thinh-vu",
          "author_login": "thinh-vu",
          "committed_at": "2026-01-17T17:09:51Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "f1103e388cb53cf3dbabd6a759e023a9673c05a0",
          "body": null,
          "is_bot": false,
          "headline": "code optimized",
          "author_name": "thinh-vu",
          "author_login": "thinh-vu",
          "committed_at": "2026-01-17T08:29:39Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "bc65d94e88e8acf28e97d168da3c10c5d9bda755",
          "body": null,
          "is_bot": false,
          "headline": "code optimized",
          "author_name": "thinh-vu",
          "author_login": "thinh-vu",
          "committed_at": "2026-01-17T08:22:08Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "638a51b9b35c87dcd316cda107d425517d868558",
          "body": "- Changed registration URL from https://vnstocks.com/account to https://vnstocks.com/login in README\n- Updated Vietnamese and English documentation sections with new login endpoint\n- Modified quickstart notebook to reflect new registration URL\n- Updated auth.py registration instructions with corrected URL",
          "is_bot": false,
          "headline": "docs: update API key registration URL from /account to /login endpoint",
          "author_name": "Thinh Vu",
          "author_login": "thinh-vu",
          "committed_at": "2026-01-16T16:52:40Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "3a7ba9fae8838b2eb41e7da6440e8d3aaaa340f7",
          "body": "- Deleted 5_visualization_data_exploration_vnstock3.ipynb containing 2029 lines of legacy notebook content\n- Removed comprehensive examples covering data visualization and exploration techniques\n- Cleaned up outdated Colab and GitHub Codespaces references\n- Removed sample code demonstrating Quote.history, intraday data, and financial statement visualizations",
          "is_bot": false,
          "headline": "chore: remove outdated visualization and data exploration notebook",
          "author_name": "Thinh Vu",
          "author_login": "thinh-vu",
          "committed_at": "2026-01-16T16:03:44Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "ebd9a9e9bf22ac99c8a35893ebe0f3335026a258",
          "body": "- Added blank lines after blockquotes for better markdown rendering\n- Improved list item formatting with consistent spacing throughout document\n- Added comprehensive user authentication section documenting tier system (Guest/Community/Sponsor)\n- Updated code examples to use KBS as default data source and simplified parameters\n- Removed duplicate Company class import example\n- Fixed screener section to indicate TCBS API deprecation\n-",
          "is_bot": false,
          "headline": "docs: improve README formatting and add user authentication section",
          "author_name": "Thinh Vu",
          "author_login": "thinh-vu",
          "committed_at": "2026-01-16T15:57:07Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "5ae7960cf359172f2a3bdb1a4a593001cfb18078",
          "body": "… source migration\n\n- Added new section for 2026-01-16 release documenting KBS as default data source\n- Documented authentication utilities and lazy loading mechanism implementation\n- Listed removal of outdated Vietnam stock notebook and dev utilities\n- Updated Listing class default source change from VCI to KBS\n- Added tier and limits information display for API key registration\n- Fixed trailing newline in CHANGELOG.md",
          "is_bot": false,
          "headline": "chore: update CHANGELOG with version 3.4.0 release notes and KBS data…",
          "author_name": "Thinh Vu",
          "author_login": "thinh-vu",
          "committed_at": "2026-01-16T15:42:35Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "d75127de6628e05819a67e90d125afbe693796bb",
          "body": "- Deleted 1_vietnam_stock_vnstock3.ipynb containing 6497 lines of legacy notebook content\n- Removed outdated Colab and Deepnote references, Google Colab IP blocking warnings\n- Cleaned up comprehensive examples covering Listing, Quote, Company, Finance, and Trading modules\n- Updated .DS_Store binary file",
          "is_bot": false,
          "headline": "chore: remove outdated Vietnam stock notebook and update .DS_Store",
          "author_name": "Thinh Vu",
          "author_login": "thinh-vu",
          "committed_at": "2026-01-16T15:14:43Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "259e6660dfebbb05bfb90769e3280bdddd7a667e",
          "body": "…formation\n\n- Display masked API key (first 4 + last 4 chars with *** in middle) when checking existing registration\n- Show tier and limits information for registered users before prompting for key change\n- Simplify registration flow by removing unnecessary \"Press Enter\" step\n- Update registration success message to show masked key and tier details\n- Improve registration instructions with clearer formatting and emoji indicators\n-",
          "is_bot": false,
          "headline": "feat: enhance API key registration UX with masked display and tier in…",
          "author_name": "Thinh Vu",
          "author_login": "thinh-vu",
          "committed_at": "2026-01-16T12:42:18Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "d07d12cc0a4fd39109b9b6d8481dd24d4f3c6d66",
          "body": "…urce\n\n- Updated cell execution counts to reflect sequential notebook run\n- Refreshed listing data outputs showing different stock symbols and company names\n- Updated row counts from 1733 to 1565 for basic listing and 3210 to 1952 for all symbols\n- Modified column structure in all_symbols output to match KBS data format (removed product_grp_id and icb_code2, added id and en_organ_name)\n- Updated industry listing output to show new",
          "is_bot": false,
          "headline": "chore: update notebook execution outputs with latest data from KBS so…",
          "author_name": "Thinh Vu",
          "author_login": "thinh-vu",
          "committed_at": "2026-01-16T12:17:12Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "12431ee3a294b64bb8a3af5822a3cdbb8a9feacf",
          "body": "- Removed cleanup.py utility script and VCI finance mapping Excel file from dev directory\n- Updated Listing class to use KBS as default data source instead of VCI\n- Modified StockComponents to initialize listing with KBS source\n- Updated error message to include KBS in valid source options\n- Cleaned up notebook documentation removing outdated Deepnote reference and simplifying setup instructions\n- Updated notebook outputs to reflect",
          "is_bot": false,
          "headline": "chore: remove dev utilities and update data source configuration",
          "author_name": "Thinh Vu",
          "author_login": "thinh-vu",
          "committed_at": "2026-01-16T11:37:07Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "f398acd1498002e9c4840d2ba052d7f063321820",
          "body": "- Updated version from 3.3.2 to 3.4.0\n- Added KBS as new default data source, replacing VCI as primary source\n- Added authentication utilities for public uses with the Vnstock API key\n- Implemented lazy loading mechanism to prevent circular import deadlocks across multiple modules",
          "is_bot": false,
          "headline": "chore: bump version to 3.4.0 and add KBS data source support",
          "author_name": "Thinh Vu",
          "author_login": "thinh-vu",
          "committed_at": "2026-01-16T10:13:02Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "8b9e679475d64344ec4b090d8c56f1284ea225a5",
          "body": null,
          "is_bot": false,
          "headline": "Delete .DS_Store (#208)",
          "author_name": "Thinh Vu",
          "author_login": "thinh-vu",
          "committed_at": "2026-01-06T16:53:19Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "ae3e76405984c104cde0bfa0e91678b69a58072d",
          "body": "…files",
          "is_bot": false,
          "headline": "fix: add .DS_Store to .gitignore to prevent tracking of macOS system …",
          "author_name": "Thinh Vu",
          "author_login": "thinh-vu",
          "committed_at": "2026-01-06T16:52:15Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "973689ea3c2aa00aa958dcb356ff3a53ad7b1a07",
          "body": "- Added support for flexible lookback periods using 'length' parameter in Quote.history for both VCI and TCBS modules.\n- Introduced new utility functions in lookback.py for parsing lookback lengths and calculating start dates based on various criteria.\n- Updated history method to handle optional sta\n[…]\nng issues.\n- Refactored request handling in Quote and Trading classes to utilize centralized client.send_request for improved proxy management.\n- Updated CHANGELOG to reflect new features and changes.",
          "is_bot": false,
          "headline": "feat: Implement Smart Lookback feature in Quote.history",
          "author_name": "Thinh Vu",
          "author_login": "thinh-vu",
          "committed_at": "2026-01-06T16:46:36Z",
          "body_truncated": true,
          "is_coding_agent": false
        },
        {
          "oid": "c140d46bf6a47b3b7f270e9eb40a725a72f23b4d",
          "body": null,
          "is_bot": false,
          "headline": "Update pyproject.toml",
          "author_name": "Thinh Vu",
          "author_login": "thinh-vu",
          "committed_at": "2026-01-06T06:38:11Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "95b33df86a26942721e0a3acb89f2b082e715c78",
          "body": "Co-authored-by: kaestrl <kaestreldev@gmail.com>",
          "is_bot": false,
          "headline": "add VN30 derivative quarter pattern (#207)",
          "author_name": "Do Tuan Anh",
          "author_login": "anhtuan23",
          "committed_at": "2026-01-04T03:41:16Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "c95cdb2e147527002fd9b6351ab40d74948cc43f",
          "body": "… versions and improve version parsing",
          "is_bot": false,
          "headline": "fix: enhance update_notice function to check for subscription package…",
          "author_name": "Thinh Vu",
          "author_login": "thinh-vu",
          "committed_at": "2025-12-21T17:07:19Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "e4a30e5fc3ee9ac8394afa8ba912ecbc5a7b7de0",
          "body": null,
          "is_bot": false,
          "headline": "Update upgrade.py (#202)",
          "author_name": "Thinh Vu",
          "author_login": "thinh-vu",
          "committed_at": "2025-12-08T09:43:55Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "985116cd0085126ee25a7b7a911968408ef5fa85",
          "body": "…ion (#193)",
          "is_bot": false,
          "headline": "fix: add price_vs_sma200 column for multi-language dictionary extract…",
          "author_name": "Nguyễn Minh Đức",
          "author_login": "nguyenminhduc24396",
          "committed_at": "2025-11-14T03:07:50Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "7ed0f06ea2f9f7ad6a2e33071d0e1332326efbd8",
          "body": "…notebook",
          "is_bot": false,
          "headline": "fix: Remove outdated Google Colab setup instructions from quickstart …",
          "author_name": "thinh-vu",
          "author_login": "thinh-vu",
          "committed_at": "2025-11-12T00:44:22Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "0369c61b37bff2ce864ff4d1486b80651711ada2",
          "body": "…ironment configuration",
          "is_bot": false,
          "headline": "fix: Update Google Colab setup in quickstart notebook, streamline env…",
          "author_name": "thinh-vu",
          "author_login": "thinh-vu",
          "committed_at": "2025-11-12T00:33:53Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "4ff2813610ab4007f33cb5efee31173b1d55c884",
          "body": "…and improve proxy guide",
          "is_bot": false,
          "headline": "chore: Update CHANGELOG.md for version 3.3.0, enhance documentation, …",
          "author_name": "thinh-vu",
          "author_login": "thinh-vu",
          "committed_at": "2025-11-12T00:33:06Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "d410593f211a3f528e7e1db21fd105042b938789",
          "body": "…art notebook links",
          "is_bot": false,
          "headline": "fix: Update .gitignore to include .DS_Store files and enhance quickst…",
          "author_name": "thinh-vu",
          "author_login": "thinh-vu",
          "committed_at": "2025-11-11T18:01:41Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "97fab6a3cec94e26494f9a8da51e41501834a547",
          "body": null,
          "is_bot": false,
          "headline": "fix: Update Google Colab instructions and remove Deepnote references",
          "author_name": "thinh-vu",
          "author_login": "thinh-vu",
          "committed_at": "2025-11-11T17:51:02Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "b79ee4ba11ddfb8ead1b50db964f4f76b044f9c7",
          "body": "…VCI proxy demo script",
          "is_bot": false,
          "headline": "feat: Update Proxy Management Guide, enhance proxy handling, and add …",
          "author_name": "thinh-vu",
          "author_login": "thinh-vu",
          "committed_at": "2025-11-11T17:41:28Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "2c021e91d13e2157c7f99f0b4e97c0d49fd813a5",
          "body": "…modules\n\n- Implemented extensive unit and integration tests for VCI Company and Finance, covering various methods and parameters.\n- Created comprehensive tests for VCI Listing, ensuring functionality across all methods and parameters.\n- Developed unit tests for VCI Quote, validating data fetching a\n[…]\nith proxy support, including proxy management and configuration.\n- Introduced a ProxyManager class for fetching and managing proxies, with functionality for testing proxy connectivity and performance.",
          "is_bot": false,
          "headline": "Add comprehensive tests for VCI Company, Finance, Listing, and Quote …",
          "author_name": "thinh-vu",
          "author_login": "thinh-vu",
          "committed_at": "2025-11-11T17:22:48Z",
          "body_truncated": true,
          "is_coding_agent": false
        },
        {
          "oid": "aaa0872f6f3e77a01764e0f6815eab4213cf447e",
          "body": "…andardize interval formats\n\n- Updated FMPConfig and XNOConfig to raise errors when API keys are not found, providing clear instructions for setting environment variables.\n- Standardized interval formats across the codebase to use '1D', '1H', '1W', '1M' for daily, hourly, weekly, and monthly interva\n[…]\nAdjusted quote modules for MSN, TCBS, and VCI to utilize standardized interval formats and improve error handling.\n- Removed deprecated code and cleaned up unnecessary comments for better readability.",
          "is_bot": false,
          "headline": "Refactor FMP and XNO API key handling, improve error messages, and st…",
          "author_name": "Thinh Vu",
          "author_login": "thinh-vu",
          "committed_at": "2025-11-10T23:44:56Z",
          "body_truncated": true,
          "is_coding_agent": false
        },
        {
          "oid": "7bc8ec5eeda5c107995975d985306405ccbc512e",
          "body": null,
          "is_bot": false,
          "headline": "Implement feature X to enhance user experience and optimize performance",
          "author_name": "Thinh Vu",
          "author_login": "thinh-vu",
          "committed_at": "2025-11-08T17:18:43Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "96aebb2f9690883df65aa7b15a0de4b4c3375124",
          "body": "… modules in VCI and TCBS",
          "is_bot": false,
          "headline": "feat: Register providers for listing, company, financial, and trading…",
          "author_name": "Thinh Vu",
          "author_login": "thinh-vu",
          "committed_at": "2025-11-08T17:13:02Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "ca612b4d7461096b1bb6326c3110394247b2e133",
          "body": "… improve docstrings",
          "is_bot": false,
          "headline": "feat: Refactor DNSE Trade class to use BASE_URL for API endpoints and…",
          "author_name": "Thinh Vu",
          "author_login": "thinh-vu",
          "committed_at": "2025-11-08T17:00:43Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "b87bb1c5fab5b1e5db1438da0a17fdc8b1386e51",
          "body": "- Added ProviderRegistry class to manage data providers.\n- Implemented methods for registering, retrieving, and listing providers.\n- Included debug information and clear functionality for testing.\n- Supports multiple provider types and source names.",
          "is_bot": false,
          "headline": "feat: Implement Provider Registry System for vnstock",
          "author_name": "Thinh Vu",
          "author_login": "thinh-vu",
          "committed_at": "2025-11-08T16:37:05Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "22188dde6c50bb2509b49ad8bfaf1e4ce3612a67",
          "body": "…oạ mới\n\n---\nRefactor code structure for improved readability and maintainability",
          "is_bot": false,
          "headline": "Sửa lỗi quote cho khung thời gian nhỏ hơn 1D, bổ sung notebook minh h…",
          "author_name": "Thinh Vu",
          "author_login": "thinh-vu",
          "committed_at": "2025-11-08T14:55:16Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "b99a6ec1d3d01de199c1d7440cc1800cebfd855f",
          "body": "… module",
          "is_bot": false,
          "headline": "update dependencies and add standardized market constants and indices…",
          "author_name": "Thinh Vu",
          "author_login": "thinh-vu",
          "committed_at": "2025-11-08T14:00:02Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "468df38e589cadaefa20936fe861cbc85c4b147c",
          "body": null,
          "is_bot": false,
          "headline": "add vnstock_ezchart as a dependency in pyproject.toml",
          "author_name": "Thinh Vu",
          "author_login": "thinh-vu",
          "committed_at": "2025-11-08T09:41:23Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "2cbdc2ec03e5febe2666b3b3cdc08610db5ea621",
          "body": null,
          "is_bot": false,
          "headline": "remove vnai.setup() call to prevent circular import issues",
          "author_name": "Thinh Vu",
          "author_login": "thinh-vu",
          "committed_at": "2025-11-08T03:44:24Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "4a5159206025f5a46b8efd2a07279863127d83ad",
          "body": null,
          "is_bot": false,
          "headline": "cập nhật phiên bản vnstock, chuẩn hoá các hàm utils",
          "author_name": "Thinh Vu",
          "author_login": "thinh-vu",
          "committed_at": "2025-11-08T02:06:20Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "660c943fd70d7eb775b8fb52f539f129f22cbd41",
          "body": null,
          "is_bot": false,
          "headline": "sửa lỗi quote history tcbs",
          "author_name": "Thinh Vu",
          "author_login": "thinh-vu",
          "committed_at": "2025-10-25T21:46:09Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "c5260a160736917919f8dac5c8e8774f79484e5c",
          "body": null,
          "is_bot": false,
          "headline": "sửa lỗi xử lý dữ liệu api",
          "author_name": "Thinh Vu",
          "author_login": "thinh-vu",
          "committed_at": "2025-10-25T21:41:35Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "fa16d031eba132862af387b7b4460962a7f4821c",
          "body": null,
          "is_bot": false,
          "headline": "cập nhật sửa lỗi validation input cho interval",
          "author_name": "Thinh Vu",
          "author_login": "thinh-vu",
          "committed_at": "2025-10-25T21:10:40Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "b7a31624a996d031b3c185932807208837fb15d2",
          "body": null,
          "is_bot": false,
          "headline": "cập nhật requirements",
          "author_name": "Thinh Vu",
          "author_login": "thinh-vu",
          "committed_at": "2025-10-25T20:02:33Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "c724e5247436e4d0aba2a3c96c8408fd2bd274a5",
          "body": "… các api official",
          "is_bot": false,
          "headline": "cập nhật kiến trúc mới nhất cho vnstock 3.2.7 tích hợp fmp và xno như…",
          "author_name": "Thinh Vu",
          "author_login": "thinh-vu",
          "committed_at": "2025-10-25T20:01:17Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "be7ef46c1ca68a9cd0cef562d125cf0d235cd17e",
          "body": null,
          "is_bot": false,
          "headline": "Cập nhật readme, docs, context7",
          "author_name": "Thinh Vu",
          "author_login": "thinh-vu",
          "committed_at": "2025-10-22T00:49:42Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "81939cd08e167dd257a543935c98ff0b5ae94300",
          "body": null,
          "is_bot": false,
          "headline": "Bổ sung nguồn FMP & XNO - User cần lấy API KEY từ nguồn để sử dụng",
          "author_name": "Thinh Vu",
          "author_login": "thinh-vu",
          "committed_at": "2025-10-22T00:21:57Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "551d6d1a02bc25e39f5e809ee29f37ea1753c428",
          "body": null,
          "is_bot": false,
          "headline": "Fix directory deletion to handle read-only files",
          "author_name": "Thinh Vu",
          "author_login": "thinh-vu",
          "committed_at": "2025-09-17T06:01:37Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "12778bb537d7c7cc62aeb7fa5fcf42ac2a7eb98a",
          "body": null,
          "is_bot": false,
          "headline": "tinh chỉnh code & thêm bộ constant",
          "author_name": "thinh-vu",
          "author_login": "thinh-vu",
          "committed_at": "2025-09-06T01:51:28Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "9ba1725026017237dce2c2d6d50a2c11e4846f8e",
          "body": null,
          "is_bot": false,
          "headline": "cập nhật screenshot",
          "author_name": "thinh-vu",
          "author_login": "thinh-vu",
          "committed_at": "2025-08-03T17:10:16Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "30da6191fdbe370e8e7bbcddd60b432da2800977",
          "body": "…hiều platform thay thế colab",
          "is_bot": false,
          "headline": "sửa lỗi chức năng visualization, thêm badge mở notebook minh hoạ từ n…",
          "author_name": "thinh-vu",
          "author_login": "thinh-vu",
          "committed_at": "2025-08-03T17:08:19Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "f0f0751d1a3db0f1a13c5004cb35c820874861f8",
          "body": null,
          "is_bot": false,
          "headline": "changes updated to v3.2.7",
          "author_name": "thinh-vu",
          "author_login": "thinh-vu",
          "committed_at": "2025-08-03T16:19:00Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "b12314f46d80fe550a78c68046a88cabf69d8853",
          "body": null,
          "is_bot": false,
          "headline": "sửa lỗi import thư viện",
          "author_name": "thinh-vu",
          "author_login": "thinh-vu",
          "committed_at": "2025-07-26T14:20:26Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "bdc23e82e0d14ff723632dbb17e5d815e7f05103",
          "body": null,
          "is_bot": false,
          "headline": "cập nhật module & utils",
          "author_name": "Thinh Vu",
          "author_login": "thinh-vu",
          "committed_at": "2025-07-24T00:31:15Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "9bbb6b62e8789b2ea08b7ef3003a6af625444fb2",
          "body": "…port",
          "is_bot": false,
          "headline": "chore: migrate from setup.py to pyproject.toml and add ProxyConfig im…",
          "author_name": "thinh-vu",
          "author_login": "thinh-vu",
          "committed_at": "2025-07-15T13:36:56Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "0d8a585bd3a6bbef5e56a6070b2ccf81131f7c15",
          "body": "…tion and proxy list",
          "is_bot": false,
          "headline": "feat: improve HuggingFace proxy error message with Vietnamese transla…",
          "author_name": "thinh-vu",
          "author_login": "thinh-vu",
          "committed_at": "2025-07-15T13:30:18Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "e8fe10d48da1cdb0a61c00e79941f18b7be76bb6",
          "body": null,
          "is_bot": false,
          "headline": "feat: add proxy configuration support to VCI Quote class",
          "author_name": "thinh-vu",
          "author_login": "thinh-vu",
          "committed_at": "2025-07-15T13:27:22Z",
          "body_truncated": false,
          "is_coding_agent": false
        }
      ],
      "releases_count": 9,
      "commits_last_year": 95,
      "latest_release_at": "2026-07-09T23:31:08Z",
      "latest_release_tag": "v4.0.4",
      "releases_from_tags": false,
      "days_since_last_push": 3,
      "active_weeks_last_year": 23,
      "days_since_latest_release": 18,
      "mean_days_between_releases": 59.2
    },
    "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": [
        {
          "name": "vnstock",
          "exists": true,
          "license": null,
          "keywords": [
            "vnstock",
            "finance",
            "vietnam",
            "stock market",
            "analysis",
            "API",
            "Development Status :: 5 - Production/Stable",
            "Intended Audience :: Developers",
            "Intended Audience :: Education",
            "Intended Audience :: Financial and Insurance Industry",
            "License :: Other/Proprietary License",
            "Natural Language :: English",
            "Natural Language :: Vietnamese",
            "Operating System :: OS Independent",
            "Programming Language :: Python :: 3",
            "Programming Language :: Python :: 3.10",
            "Programming Language :: Python :: 3.11",
            "Programming Language :: Python :: 3.12",
            "Programming Language :: Python :: 3.13",
            "Programming Language :: Python :: 3.14",
            "Topic :: Office/Business :: Financial :: Investment",
            "Topic :: Software Development :: Libraries"
          ],
          "ecosystem": "pypi",
          "matches_repo": true,
          "registry_url": "https://pypi.org/project/vnstock/",
          "is_deprecated": false,
          "latest_version": "4.0.5",
          "repository_url": "https://github.com/thinh-vu/vnstock",
          "versions_count": 66,
          "total_downloads": null,
          "dependents_count": null,
          "deprecation_note": null,
          "maintainers_count": null,
          "monthly_downloads": null,
          "first_published_at": "2022-02-26T17:07:08.414648Z",
          "latest_published_at": "2026-07-24T10:58:04.064541Z",
          "latest_version_yanked": null,
          "days_since_latest_publish": 3
        }
      ]
    },
    "popularity": {
      "forks": 292,
      "stars": 1358,
      "watchers": 54,
      "fork_history": {
        "days": [
          {
            "date": "2022-08-30",
            "count": 1
          },
          {
            "date": "2022-09-06",
            "count": 1
          },
          {
            "date": "2022-10-06",
            "count": 1
          },
          {
            "date": "2022-10-18",
            "count": 1
          },
          {
            "date": "2022-11-23",
            "count": 1
          },
          {
            "date": "2022-11-30",
            "count": 1
          },
          {
            "date": "2022-12-15",
            "count": 1
          },
          {
            "date": "2022-12-25",
            "count": 1
          },
          {
            "date": "2023-01-17",
            "count": 1
          },
          {
            "date": "2023-01-20",
            "count": 1
          },
          {
            "date": "2023-01-23",
            "count": 1
          },
          {
            "date": "2023-01-29",
            "count": 1
          },
          {
            "date": "2023-02-01",
            "count": 1
          },
          {
            "date": "2023-02-03",
            "count": 1
          },
          {
            "date": "2023-02-17",
            "count": 1
          },
          {
            "date": "2023-03-05",
            "count": 1
          },
          {
            "date": "2023-03-08",
            "count": 1
          },
          {
            "date": "2023-03-09",
            "count": 1
          },
          {
            "date": "2023-03-18",
            "count": 1
          },
          {
            "date": "2023-04-01",
            "count": 1
          },
          {
            "date": "2023-04-02",
            "count": 1
          },
          {
            "date": "2023-04-06",
            "count": 1
          },
          {
            "date": "2023-04-09",
            "count": 2
          },
          {
            "date": "2023-04-19",
            "count": 1
          },
          {
            "date": "2023-04-30",
            "count": 1
          },
          {
            "date": "2023-05-07",
            "count": 1
          },
          {
            "date": "2023-05-10",
            "count": 1
          },
          {
            "date": "2023-05-17",
            "count": 1
          },
          {
            "date": "2023-05-18",
            "count": 1
          },
          {
            "date": "2023-05-21",
            "count": 1
          },
          {
            "date": "2023-05-26",
            "count": 1
          },
          {
            "date": "2023-05-29",
            "count": 2
          },
          {
            "date": "2023-05-31",
            "count": 1
          },
          {
            "date": "2023-06-14",
            "count": 1
          },
          {
            "date": "2023-06-19",
            "count": 1
          },
          {
            "date": "2023-06-22",
            "count": 1
          },
          {
            "date": "2023-06-27",
            "count": 1
          },
          {
            "date": "2023-06-28",
            "count": 1
          },
          {
            "date": "2023-06-30",
            "count": 2
          },
          {
            "date": "2023-07-03",
            "count": 1
          },
          {
            "date": "2023-07-05",
            "count": 1
          },
          {
            "date": "2023-07-17",
            "count": 2
          },
          {
            "date": "2023-07-18",
            "count": 1
          },
          {
            "date": "2023-07-24",
            "count": 1
          },
          {
            "date": "2023-07-26",
            "count": 2
          },
          {
            "date": "2023-07-27",
            "count": 1
          },
          {
            "date": "2023-07-28",
            "count": 1
          },
          {
            "date": "2023-08-09",
            "count": 1
          },
          {
            "date": "2023-08-14",
            "count": 1
          },
          {
            "date": "2023-08-20",
            "count": 1
          },
          {
            "date": "2023-08-22",
            "count": 1
          },
          {
            "date": "2023-08-25",
            "count": 1
          },
          {
            "date": "2023-08-27",
            "count": 1
          },
          {
            "date": "2023-09-26",
            "count": 1
          },
          {
            "date": "2023-09-27",
            "count": 1
          },
          {
            "date": "2023-10-01",
            "count": 1
          },
          {
            "date": "2023-10-03",
            "count": 2
          },
          {
            "date": "2023-10-12",
            "count": 1
          },
          {
            "date": "2023-10-15",
            "count": 2
          },
          {
            "date": "2023-10-21",
            "count": 1
          },
          {
            "date": "2023-10-29",
            "count": 2
          },
          {
            "date": "2023-11-03",
            "count": 1
          },
          {
            "date": "2023-11-07",
            "count": 1
          },
          {
            "date": "2023-11-10",
            "count": 1
          },
          {
            "date": "2023-11-11",
            "count": 1
          },
          {
            "date": "2023-12-02",
            "count": 1
          },
          {
            "date": "2023-12-07",
            "count": 1
          },
          {
            "date": "2023-12-21",
            "count": 1
          },
          {
            "date": "2023-12-22",
            "count": 1
          },
          {
            "date": "2023-12-26",
            "count": 1
          },
          {
            "date": "2023-12-27",
            "count": 1
          },
          {
            "date": "2023-12-29",
            "count": 1
          },
          {
            "date": "2024-01-02",
            "count": 1
          },
          {
            "date": "2024-01-09",
            "count": 1
          },
          {
            "date": "2024-01-18",
            "count": 1
          },
          {
            "date": "2024-01-28",
            "count": 1
          },
          {
            "date": "2024-01-30",
            "count": 1
          },
          {
            "date": "2024-02-05",
            "count": 1
          },
          {
            "date": "2024-02-15",
            "count": 1
          },
          {
            "date": "2024-02-18",
            "count": 1
          },
          {
            "date": "2024-02-20",
            "count": 1
          },
          {
            "date": "2024-02-21",
            "count": 1
          },
          {
            "date": "2024-02-22",
            "count": 1
          },
          {
            "date": "2024-02-25",
            "count": 1
          },
          {
            "date": "2024-03-04",
            "count": 1
          },
          {
            "date": "2024-03-16",
            "count": 1
          },
          {
            "date": "2024-03-20",
            "count": 1
          },
          {
            "date": "2024-03-30",
            "count": 1
          },
          {
            "date": "2024-04-08",
            "count": 1
          },
          {
            "date": "2024-04-16",
            "count": 1
          },
          {
            "date": "2024-05-17",
            "count": 1
          },
          {
            "date": "2024-05-25",
            "count": 1
          },
          {
            "date": "2024-05-26",
            "count": 1
          },
          {
            "date": "2024-05-31",
            "count": 1
          },
          {
            "date": "2024-06-06",
            "count": 1
          },
          {
            "date": "2024-06-07",
            "count": 1
          },
          {
            "date": "2024-06-10",
            "count": 1
          },
          {
            "date": "2024-06-19",
            "count": 1
          },
          {
            "date": "2024-06-29",
            "count": 1
          },
          {
            "date": "2024-07-05",
            "count": 1
          },
          {
            "date": "2024-07-09",
            "count": 1
          },
          {
            "date": "2024-07-21",
            "count": 1
          },
          {
            "date": "2024-07-28",
            "count": 1
          },
          {
            "date": "2024-08-08",
            "count": 1
          },
          {
            "date": "2024-08-21",
            "count": 1
          },
          {
            "date": "2024-09-01",
            "count": 1
          },
          {
            "date": "2024-09-12",
            "count": 1
          },
          {
            "date": "2024-09-15",
            "count": 1
          },
          {
            "date": "2024-09-23",
            "count": 2
          },
          {
            "date": "2024-10-03",
            "count": 1
          },
          {
            "date": "2024-10-10",
            "count": 1
          },
          {
            "date": "2024-10-17",
            "count": 1
          },
          {
            "date": "2024-10-21",
            "count": 1
          },
          {
            "date": "2024-11-01",
            "count": 2
          },
          {
            "date": "2024-11-06",
            "count": 1
          },
          {
            "date": "2024-11-12",
            "count": 1
          },
          {
            "date": "2024-11-13",
            "count": 1
          },
          {
            "date": "2024-11-16",
            "count": 1
          },
          {
            "date": "2024-11-25",
            "count": 1
          },
          {
            "date": "2024-12-17",
            "count": 1
          },
          {
            "date": "2025-01-02",
            "count": 1
          },
          {
            "date": "2025-01-12",
            "count": 1
          },
          {
            "date": "2025-01-24",
            "count": 1
          },
          {
            "date": "2025-01-25",
            "count": 2
          },
          {
            "date": "2025-02-04",
            "count": 1
          },
          {
            "date": "2025-02-19",
            "count": 1
          },
          {
            "date": "2025-02-22",
            "count": 1
          },
          {
            "date": "2025-02-24",
            "count": 2
          },
          {
            "date": "2025-02-25",
            "count": 1
          },
          {
            "date": "2025-03-02",
            "count": 1
          },
          {
            "date": "2025-03-09",
            "count": 1
          },
          {
            "date": "2025-03-10",
            "count": 1
          },
          {
            "date": "2025-03-12",
            "count": 1
          },
          {
            "date": "2025-03-14",
            "count": 1
          },
          {
            "date": "2025-03-21",
            "count": 3
          },
          {
            "date": "2025-03-22",
            "count": 1
          },
          {
            "date": "2025-03-25",
            "count": 1
          },
          {
            "date": "2025-03-27",
            "count": 1
          },
          {
            "date": "2025-03-28",
            "count": 1
          },
          {
            "date": "2025-04-05",
            "count": 1
          },
          {
            "date": "2025-04-10",
            "count": 1
          },
          {
            "date": "2025-04-15",
            "count": 1
          },
          {
            "date": "2025-04-16",
            "count": 1
          },
          {
            "date": "2025-04-24",
            "count": 1
          },
          {
            "date": "2025-04-26",
            "count": 1
          },
          {
            "date": "2025-05-07",
            "count": 2
          },
          {
            "date": "2025-05-10",
            "count": 1
          },
          {
            "date": "2025-05-11",
            "count": 1
          },
          {
            "date": "2025-05-23",
            "count": 1
          },
          {
            "date": "2025-05-28",
            "count": 1
          },
          {
            "date": "2025-06-05",
            "count": 1
          },
          {
            "date": "2025-06-06",
            "count": 3
          },
          {
            "date": "2025-06-08",
            "count": 1
          },
          {
            "date": "2025-06-18",
            "count": 1
          },
          {
            "date": "2025-07-04",
            "count": 2
          },
          {
            "date": "2025-07-15",
            "count": 1
          },
          {
            "date": "2025-07-16",
            "count": 1
          },
          {
            "date": "2025-07-18",
            "count": 1
          },
          {
            "date": "2025-07-23",
            "count": 1
          },
          {
            "date": "2025-07-24",
            "count": 1
          },
          {
            "date": "2025-07-26",
            "count": 1
          },
          {
            "date": "2025-07-27",
            "count": 1
          },
          {
            "date": "2025-08-06",
            "count": 1
          },
          {
            "date": "2025-08-08",
            "count": 1
          },
          {
            "date": "2025-08-15",
            "count": 1
          },
          {
            "date": "2025-08-17",
            "count": 1
          },
          {
            "date": "2025-08-18",
            "count": 1
          },
          {
            "date": "2025-08-26",
            "count": 2
          },
          {
            "date": "2025-08-31",
            "count": 1
          },
          {
            "date": "2025-09-04",
            "count": 2
          },
          {
            "date": "2025-09-14",
            "count": 1
          },
          {
            "date": "2025-09-24",
            "count": 1
          },
          {
            "date": "2025-09-25",
            "count": 1
          },
          {
            "date": "2025-10-06",
            "count": 2
          },
          {
            "date": "2025-10-11",
            "count": 1
          },
          {
            "date": "2025-10-12",
            "count": 1
          },
          {
            "date": "2025-10-14",
            "count": 1
          },
          {
            "date": "2025-10-15",
            "count": 1
          },
          {
            "date": "2025-10-19",
            "count": 1
          },
          {
            "date": "2025-10-21",
            "count": 1
          },
          {
            "date": "2025-10-24",
            "count": 1
          },
          {
            "date": "2025-10-27",
            "count": 1
          },
          {
            "date": "2025-10-29",
            "count": 1
          },
          {
            "date": "2025-11-02",
            "count": 1
          },
          {
            "date": "2025-11-04",
            "count": 2
          },
          {
            "date": "2025-11-08",
            "count": 1
          },
          {
            "date": "2025-11-19",
            "count": 1
          },
          {
            "date": "2025-11-24",
            "count": 1
          },
          {
            "date": "2025-12-12",
            "count": 1
          },
          {
            "date": "2025-12-15",
            "count": 2
          },
          {
            "date": "2025-12-21",
            "count": 1
          },
          {
            "date": "2025-12-23",
            "count": 1
          },
          {
            "date": "2025-12-30",
            "count": 1
          },
          {
            "date": "2025-12-31",
            "count": 2
          },
          {
            "date": "2026-01-03",
            "count": 1
          },
          {
            "date": "2026-01-06",
            "count": 1
          },
          {
            "date": "2026-01-11",
            "count": 1
          },
          {
            "date": "2026-01-17",
            "count": 1
          },
          {
            "date": "2026-01-22",
            "count": 1
          },
          {
            "date": "2026-01-24",
            "count": 1
          },
          {
            "date": "2026-01-29",
            "count": 1
          },
          {
            "date": "2026-02-07",
            "count": 1
          },
          {
            "date": "2026-02-08",
            "count": 1
          },
          {
            "date": "2026-02-25",
            "count": 1
          },
          {
            "date": "2026-02-26",
            "count": 1
          },
          {
            "date": "2026-02-28",
            "count": 1
          },
          {
            "date": "2026-03-03",
            "count": 1
          },
          {
            "date": "2026-03-06",
            "count": 1
          },
          {
            "date": "2026-03-11",
            "count": 3
          },
          {
            "date": "2026-03-12",
            "count": 1
          },
          {
            "date": "2026-03-13",
            "count": 1
          },
          {
            "date": "2026-03-18",
            "count": 2
          },
          {
            "date": "2026-03-23",
            "count": 1
          },
          {
            "date": "2026-03-29",
            "count": 2
          },
          {
            "date": "2026-03-31",
            "count": 1
          },
          {
            "date": "2026-04-01",
            "count": 1
          },
          {
            "date": "2026-04-02",
            "count": 5
          },
          {
            "date": "2026-04-03",
            "count": 2
          },
          {
            "date": "2026-04-08",
            "count": 1
          },
          {
            "date": "2026-04-10",
            "count": 1
          },
          {
            "date": "2026-04-13",
            "count": 2
          },
          {
            "date": "2026-04-14",
            "count": 1
          },
          {
            "date": "2026-04-15",
            "count": 1
          },
          {
            "date": "2026-04-17",
            "count": 1
          },
          {
            "date": "2026-04-20",
            "count": 1
          },
          {
            "date": "2026-04-21",
            "count": 2
          },
          {
            "date": "2026-04-22",
            "count": 2
          },
          {
            "date": "2026-04-23",
            "count": 1
          },
          {
            "date": "2026-04-26",
            "count": 1
          },
          {
            "date": "2026-04-27",
            "count": 1
          },
          {
            "date": "2026-04-29",
            "count": 3
          },
          {
            "date": "2026-04-30",
            "count": 1
          },
          {
            "date": "2026-05-08",
            "count": 1
          },
          {
            "date": "2026-05-09",
            "count": 1
          },
          {
            "date": "2026-05-11",
            "count": 1
          },
          {
            "date": "2026-05-14",
            "count": 1
          },
          {
            "date": "2026-05-17",
            "count": 1
          },
          {
            "date": "2026-05-19",
            "count": 1
          },
          {
            "date": "2026-05-21",
            "count": 1
          },
          {
            "date": "2026-05-24",
            "count": 1
          },
          {
            "date": "2026-05-27",
            "count": 1
          },
          {
            "date": "2026-05-29",
            "count": 1
          },
          {
            "date": "2026-06-03",
            "count": 1
          },
          {
            "date": "2026-06-06",
            "count": 1
          },
          {
            "date": "2026-06-08",
            "count": 1
          },
          {
            "date": "2026-06-13",
            "count": 1
          },
          {
            "date": "2026-06-24",
            "count": 2
          },
          {
            "date": "2026-06-27",
            "count": 1
          },
          {
            "date": "2026-07-09",
            "count": 1
          },
          {
            "date": "2026-07-17",
            "count": 1
          },
          {
            "date": "2026-07-23",
            "count": 1
          }
        ],
        "complete": true,
        "collected": 290,
        "total_forks": 292
      },
      "star_history": null,
      "open_issues_and_prs": 0
    },
    "ai_readiness": {
      "has_nix": false,
      "example_dirs": [
        "examples",
        "notebooks"
      ],
      "has_llms_txt": false,
      "has_dockerfile": false,
      "has_mcp_signal": false,
      "bootstrap_files": [
        "Makefile"
      ],
      "api_schema_files": [],
      "has_devcontainer": true,
      "typecheck_configs": [],
      "toolchain_manifests": [],
      "largest_source_bytes": 55284,
      "source_files_sampled": 151,
      "oversized_source_files": 0,
      "agent_instruction_files": [
        "AGENTS.md"
      ],
      "agent_instruction_max_bytes": 3903
    },
    "dependencies": {
      "manifests": [
        "pyproject.toml",
        "requirements.txt"
      ],
      "advisories": {
        "error": null,
        "scope": "published_package",
        "source": "osv",
        "findings": [],
        "collected": true,
        "malicious": [],
        "truncated": false,
        "by_severity": {},
        "advisory_count": 0,
        "affected_count": 0,
        "assessed_count": 38,
        "malicious_count": 0,
        "assessed_package": "pypi:vnstock@4.0.5",
        "unassessed_count": 0,
        "direct_affected_count": 0
      },
      "ecosystems": [
        "pypi"
      ],
      "dependencies": [
        {
          "name": "requests",
          "manifest": "pyproject.toml",
          "ecosystem": "pypi",
          "version_constraint": null
        },
        {
          "name": "beautifulsoup4",
          "manifest": "pyproject.toml",
          "ecosystem": "pypi",
          "version_constraint": null
        },
        {
          "name": "pandas",
          "manifest": "pyproject.toml",
          "ecosystem": "pypi",
          "version_constraint": null
        },
        {
          "name": "seaborn",
          "manifest": "pyproject.toml",
          "ecosystem": "pypi",
          "version_constraint": null
        },
        {
          "name": "openpyxl",
          "manifest": "pyproject.toml",
          "ecosystem": "pypi",
          "version_constraint": null
        },
        {
          "name": "pydantic",
          "manifest": "pyproject.toml",
          "ecosystem": "pypi",
          "version_constraint": null
        },
        {
          "name": "psutil",
          "manifest": "pyproject.toml",
          "ecosystem": "pypi",
          "version_constraint": null
        },
        {
          "name": "packaging",
          "manifest": "pyproject.toml",
          "ecosystem": "pypi",
          "version_constraint": ">=20.0"
        },
        {
          "name": "importlib-metadata",
          "manifest": "pyproject.toml",
          "ecosystem": "pypi",
          "version_constraint": ">=1.0"
        },
        {
          "name": "tenacity",
          "manifest": "pyproject.toml",
          "ecosystem": "pypi",
          "version_constraint": null
        },
        {
          "name": "vnai",
          "manifest": "pyproject.toml",
          "ecosystem": "pypi",
          "version_constraint": ">=2.5.2"
        },
        {
          "name": "vnstock_ezchart",
          "manifest": "pyproject.toml",
          "ecosystem": "pypi",
          "version_constraint": ">=1.0.1"
        },
        {
          "name": "pytz",
          "manifest": "pyproject.toml",
          "ecosystem": "pypi",
          "version_constraint": null
        }
      ],
      "all_dependencies": {
        "error": null,
        "source": "github-sbom",
        "packages": [
          {
            "name": "beautifulsoup4",
            "direct": true,
            "version": null,
            "ecosystem": "pypi"
          },
          {
            "name": "importlib-metadata",
            "direct": true,
            "version": null,
            "ecosystem": "pypi"
          },
          {
            "name": "openpyxl",
            "direct": true,
            "version": null,
            "ecosystem": "pypi"
          },
          {
            "name": "openpyxl",
            "direct": true,
            "version": "3.1.2",
            "ecosystem": "pypi"
          },
          {
            "name": "packaging",
            "direct": true,
            "version": null,
            "ecosystem": "pypi"
          },
          {
            "name": "pandas",
            "direct": true,
            "version": null,
            "ecosystem": "pypi"
          },
          {
            "name": "psutil",
            "direct": true,
            "version": null,
            "ecosystem": "pypi"
          },
          {
            "name": "psutil",
            "direct": true,
            "version": "6.0.0",
            "ecosystem": "pypi"
          },
          {
            "name": "pydantic",
            "direct": true,
            "version": null,
            "ecosystem": "pypi"
          },
          {
            "name": "pytz",
            "direct": true,
            "version": null,
            "ecosystem": "pypi"
          },
          {
            "name": "requests",
            "direct": true,
            "version": null,
            "ecosystem": "pypi"
          },
          {
            "name": "seaborn",
            "direct": true,
            "version": null,
            "ecosystem": "pypi"
          },
          {
            "name": "seaborn",
            "direct": true,
            "version": "0.13.2",
            "ecosystem": "pypi"
          },
          {
            "name": "tenacity",
            "direct": true,
            "version": null,
            "ecosystem": "pypi"
          },
          {
            "name": "vnai",
            "direct": true,
            "version": null,
            "ecosystem": "pypi"
          },
          {
            "name": "vnstock-ezchart",
            "direct": true,
            "version": null,
            "ecosystem": "pypi"
          },
          {
            "name": "bs4",
            "direct": false,
            "version": "0.0.2",
            "ecosystem": "pypi"
          },
          {
            "name": "cryptography",
            "direct": false,
            "version": "42.0.5",
            "ecosystem": "pypi"
          },
          {
            "name": "fake-useragent",
            "direct": false,
            "version": "1.5.1",
            "ecosystem": "pypi"
          },
          {
            "name": "mkdocs-glightbox",
            "direct": false,
            "version": null,
            "ecosystem": "pypi"
          },
          {
            "name": "mkdocs-material",
            "direct": false,
            "version": null,
            "ecosystem": "pypi"
          },
          {
            "name": "mkdocs-rss-plugin",
            "direct": false,
            "version": null,
            "ecosystem": "pypi"
          },
          {
            "name": "pytest",
            "direct": false,
            "version": null,
            "ecosystem": "pypi"
          },
          {
            "name": "pytest-cov",
            "direct": false,
            "version": null,
            "ecosystem": "pypi"
          },
          {
            "name": "setuptools",
            "direct": false,
            "version": null,
            "ecosystem": "pypi"
          }
        ],
        "collected": true,
        "truncated": false,
        "total_count": 25,
        "direct_count": 16,
        "indirect_count": 9
      }
    },
    "maintainership": {
      "issues": {
        "open_prs": 0,
        "merged_prs": 68,
        "open_issues": 0,
        "closed_ratio": 1,
        "closed_issues": 132,
        "closed_unmerged_prs": 23
      },
      "bus_factor": 1,
      "bot_contributors": 0,
      "top_contributors": [
        {
          "type": "User",
          "login": "thinh-vu",
          "commits": 448,
          "avatar_url": "https://avatars.githubusercontent.com/u/39723360?v=4"
        },
        {
          "type": "User",
          "login": "tinktink23",
          "commits": 5,
          "avatar_url": "https://avatars.githubusercontent.com/u/144011136?v=4"
        },
        {
          "type": "User",
          "login": "nguyenminhduc24396",
          "commits": 3,
          "avatar_url": "https://avatars.githubusercontent.com/u/39340764?v=4"
        },
        {
          "type": "User",
          "login": "nvh95",
          "commits": 2,
          "avatar_url": "https://avatars.githubusercontent.com/u/8603085?v=4"
        },
        {
          "type": "User",
          "login": "phuocnt3110",
          "commits": 1,
          "avatar_url": "https://avatars.githubusercontent.com/u/46475398?v=4"
        },
        {
          "type": "User",
          "login": "anhtuan23",
          "commits": 1,
          "avatar_url": "https://avatars.githubusercontent.com/u/7277399?v=4"
        },
        {
          "type": "User",
          "login": "hieutrtr",
          "commits": 1,
          "avatar_url": "https://avatars.githubusercontent.com/u/7941154?v=4"
        },
        {
          "type": "User",
          "login": "HMDank",
          "commits": 1,
          "avatar_url": "https://avatars.githubusercontent.com/u/109755535?v=4"
        },
        {
          "type": "User",
          "login": "andrey-jef",
          "commits": 1,
          "avatar_url": "https://avatars.githubusercontent.com/u/81280428?v=4"
        },
        {
          "type": "User",
          "login": "hungdoit",
          "commits": 1,
          "avatar_url": "https://avatars.githubusercontent.com/u/13359053?v=4"
        }
      ],
      "contributors_sampled": 12,
      "top_contributor_share": 0.961
    },
    "quality_signals": {
      "has_ci": true,
      "has_tests": true,
      "ci_workflows": [
        "code-quality.yml",
        "coverage-report.yml",
        "performance.yml",
        "test.yml",
        "verify-api-key.yml"
      ],
      "has_docs_dir": true,
      "linter_configs": [
        ".flake8"
      ],
      "has_editorconfig": false,
      "has_linter_config": true,
      "has_precommit_config": true
    },
    "security_signals": {
      "lockfiles": [],
      "scorecard": {
        "checks": [
          {
            "name": "Binary-Artifacts",
            "score": 10,
            "reason": "no binaries found in the repo",
            "documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#binary-artifacts"
          },
          {
            "name": "Branch-Protection",
            "score": 3,
            "reason": "branch protection is not maximal on development and all release branches",
            "documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#branch-protection"
          },
          {
            "name": "CI-Tests",
            "score": 0,
            "reason": "0 out of 1 merged PRs checked by a CI test -- score normalized to 0",
            "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/30 approved changesets -- score normalized to 0",
            "documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#code-review"
          },
          {
            "name": "Contributors",
            "score": 3,
            "reason": "project has 1 contributing companies or organizations -- score normalized to 3",
            "documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#contributors"
          },
          {
            "name": "Dangerous-Workflow",
            "score": 10,
            "reason": "no dangerous workflow patterns detected",
            "documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#dangerous-workflow"
          },
          {
            "name": "Dependency-Update-Tool",
            "score": 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": 9,
            "reason": "license file detected",
            "documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#license"
          },
          {
            "name": "Maintained",
            "score": 10,
            "reason": "11 commit(s) and 2 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": null,
            "reason": "packaging workflow not 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": 0,
            "reason": "detected GitHub workflow tokens with excessive permissions",
            "documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#token-permissions"
          },
          {
            "name": "Vulnerabilities",
            "score": 5,
            "reason": "5 existing vulnerabilities detected",
            "documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#vulnerabilities"
          }
        ],
        "commit": "72e6a75016da96173fd7dd26f1011e14fb3dfbf7",
        "ran_at": "2026-07-28T03:13:12Z",
        "aggregate_score": 3.7,
        "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-27T06:29:42Z",
      "oldest_open_prs": [],
      "last_merged_pr_at": "2026-02-27T15:40:05Z",
      "ci_last_conclusion": "SUCCESS",
      "oldest_open_issues": []
    }
  },
  "config": {
    "disabled_metrics": [],
    "disabled_categories": [],
    "disabled_components": {}
  },
  "source": {
    "url": "https://github.com/thinh-vu/vnstock",
    "host": "github.com",
    "name": "vnstock",
    "owner": "thinh-vu"
  },
  "metrics": {
    "overall": {
      "key": "overall",
      "band": "good",
      "name": "Overall health",
      "note": null,
      "notes": [],
      "value": 70,
      "inputs": {
        "security": 50,
        "vitality": 85,
        "community": 64,
        "governance": 62,
        "engineering": 84
      },
      "components": []
    },
    "categories": [
      {
        "key": "vitality",
        "band": "excellent",
        "name": "Vitality",
        "value": 85,
        "weight": 0.22,
        "metrics": [
          {
            "key": "development_activity",
            "band": "good",
            "name": "Development activity",
            "note": null,
            "notes": [],
            "value": 80,
            "inputs": {
              "commits_last_year": 95,
              "human_commit_share": 1,
              "days_since_last_push": 3,
              "active_weeks_last_year": 23
            },
            "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": "23/52 weeks with commits",
                "points": 15.9,
                "status": "partial",
                "details": [
                  {
                    "code": "commit_cadence_weeks",
                    "params": {
                      "weeks": 23
                    }
                  }
                ],
                "max_points": 36
              },
              {
                "key": "commit_volume",
                "name": "Commit volume",
                "detail": "95 commits in the last year",
                "points": 17.8,
                "status": "partial",
                "details": [
                  {
                    "code": "commits_last_year",
                    "params": {
                      "count": 95
                    }
                  }
                ],
                "max_points": 18
              },
              {
                "key": "openssf_scorecard_maintained",
                "name": "OpenSSF Scorecard: Maintained",
                "detail": "11 commit(s) and 2 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": 92,
            "inputs": {
              "releases_count": 9,
              "latest_release_tag": "v4.0.4",
              "releases_from_tags": false,
              "days_since_latest_release": 18,
              "mean_days_between_releases": 59.2
            },
            "components": [
              {
                "key": "ships_releases",
                "name": "Ships releases",
                "detail": "9 releases published",
                "points": 27,
                "status": "met",
                "details": [
                  {
                    "code": "releases_published",
                    "params": {
                      "count": 9
                    }
                  }
                ],
                "max_points": 27
              },
              {
                "key": "release_recency",
                "name": "Release recency",
                "detail": "latest release 18 days ago",
                "points": 36,
                "status": "met",
                "details": [
                  {
                    "code": "release_recency",
                    "params": {
                      "days": 18
                    }
                  }
                ],
                "max_points": 36
              },
              {
                "key": "release_cadence",
                "name": "Release cadence",
                "detail": "a release every ~59.2 days",
                "points": 19.8,
                "status": "partial",
                "details": [
                  {
                    "code": "release_cadence",
                    "params": {
                      "gap": 59.2
                    }
                  }
                ],
                "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": "moderate",
        "name": "Community & Adoption",
        "value": 64,
        "weight": 0.18,
        "metrics": [
          {
            "key": "popularity",
            "band": "good",
            "name": "Popularity & adoption",
            "note": null,
            "notes": [],
            "value": 81,
            "inputs": {
              "forks": 292,
              "stars": 1358,
              "watchers": 54,
              "growth_state": "unverified",
              "growth_factor_pct": 100,
              "growth_unverified_reason": "no_history"
            },
            "components": [
              {
                "key": "stars",
                "name": "Stars",
                "detail": "1,358 stars",
                "points": 50.8,
                "status": "partial",
                "details": [
                  {
                    "code": "stars",
                    "params": {
                      "count": 1358
                    }
                  }
                ],
                "max_points": 60
              },
              {
                "key": "forks",
                "name": "Forks",
                "detail": "292 forks",
                "points": 20.5,
                "status": "partial",
                "details": [
                  {
                    "code": "forks",
                    "params": {
                      "count": 292
                    }
                  }
                ],
                "max_points": 25
              },
              {
                "key": "watchers",
                "name": "Watchers",
                "detail": "54 watchers",
                "points": 9.6,
                "status": "partial",
                "details": [
                  {
                    "code": "watchers",
                    "params": {
                      "count": 54
                    }
                  }
                ],
                "max_points": 15
              }
            ]
          },
          {
            "key": "community_health",
            "band": "at_risk",
            "name": "Community health",
            "note": null,
            "notes": [],
            "value": 44,
            "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": "license file present, not a recognized license",
                "points": 16.9,
                "status": "partial",
                "details": [
                  {
                    "code": "license_custom",
                    "params": {}
                  }
                ],
                "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": "moderate",
        "name": "Sustainability & Governance",
        "value": 62,
        "weight": 0.24,
        "metrics": [
          {
            "key": "maintainer_resilience",
            "band": "critical",
            "name": "Maintainer resilience (bus factor)",
            "note": null,
            "notes": [],
            "value": 26,
            "inputs": {
              "bus_factor": 1,
              "contributors_sampled": 12,
              "top_contributor_share": 0.961
            },
            "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": 0.9,
                "status": "partial",
                "details": [
                  {
                    "code": "top_contributor_share",
                    "params": {
                      "share": 96
                    }
                  }
                ],
                "max_points": 22.5
              },
              {
                "key": "contributor_breadth",
                "name": "Contributor breadth",
                "detail": "12 contributors",
                "points": 13.5,
                "status": "met",
                "details": [
                  {
                    "code": "contributors_sampled",
                    "params": {
                      "count": 12
                    }
                  }
                ],
                "max_points": 13.5
              },
              {
                "key": "openssf_scorecard_contributors",
                "name": "OpenSSF Scorecard: Contributors",
                "detail": "project has 1 contributing companies or organizations -- score normalized to 3",
                "points": 3,
                "status": "partial",
                "details": [],
                "max_points": 10
              }
            ]
          },
          {
            "key": "responsiveness",
            "band": "good",
            "name": "Issue & PR responsiveness",
            "note": null,
            "notes": [],
            "value": 75,
            "inputs": {
              "merged_prs": 68,
              "open_issues": 0,
              "closed_issues": 132,
              "issue_closed_ratio": 1,
              "closed_unmerged_prs": 23
            },
            "components": [
              {
                "key": "issue_resolution",
                "name": "Issue resolution",
                "detail": "100% of issues closed",
                "points": 46.8,
                "status": "met",
                "details": [
                  {
                    "code": "issues_closed_share",
                    "params": {
                      "share": 100
                    }
                  }
                ],
                "max_points": 46.75
              },
              {
                "key": "pr_acceptance",
                "name": "PR acceptance",
                "detail": "68/91 decided PRs merged",
                "points": 28.6,
                "status": "partial",
                "details": [
                  {
                    "code": "decided_prs_merged",
                    "params": {
                      "merged": 68,
                      "decided": 91
                    }
                  }
                ],
                "max_points": 38.25
              },
              {
                "key": "openssf_scorecard_code_review",
                "name": "OpenSSF Scorecard: Code-Review",
                "detail": "Found 1/30 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": 63,
            "inputs": {
              "followers": 289,
              "owner_type": "User",
              "is_verified": null,
              "owner_login": "thinh-vu",
              "public_repos": 26,
              "account_age_days": 2981
            },
            "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": "289 followers of thinh-vu",
                "points": 17.7,
                "status": "partial",
                "details": [
                  {
                    "code": "owner_followers",
                    "params": {
                      "count": 289,
                      "login": "thinh-vu"
                    }
                  }
                ],
                "max_points": 25
              },
              {
                "key": "track_record",
                "name": "Track record",
                "detail": "26 public repos, account ~8 yr old",
                "points": 22.4,
                "status": "partial",
                "details": [
                  {
                    "code": "public_repos",
                    "params": {
                      "count": 26
                    }
                  },
                  {
                    "code": "account_age_years",
                    "params": {
                      "years": 8
                    }
                  }
                ],
                "max_points": 25
              }
            ]
          },
          {
            "key": "package_maintenance",
            "band": "excellent",
            "name": "Package maintenance",
            "note": null,
            "notes": [],
            "value": 100,
            "inputs": {
              "packages": [
                "vnstock"
              ],
              "ecosystems": "pypi",
              "any_deprecated": false,
              "min_days_since_publish": 3
            },
            "components": [
              {
                "key": "published_resolvable",
                "name": "Published & resolvable",
                "detail": "1 package(s) on pypi",
                "points": 25,
                "status": "met",
                "details": [
                  {
                    "code": "packages_published",
                    "params": {
                      "count": 1,
                      "ecosystems": "pypi"
                    }
                  }
                ],
                "max_points": 25
              },
              {
                "key": "publish_recency",
                "name": "Publish recency",
                "detail": "latest publish 3 days ago",
                "points": 35,
                "status": "met",
                "details": [
                  {
                    "code": "publish_recency",
                    "params": {
                      "days": 3
                    }
                  }
                ],
                "max_points": 35
              },
              {
                "key": "version_history",
                "name": "Version history",
                "detail": "66 published versions",
                "points": 20,
                "status": "met",
                "details": [
                  {
                    "code": "published_versions",
                    "params": {
                      "count": 66
                    }
                  }
                ],
                "max_points": 20
              },
              {
                "key": "not_deprecated",
                "name": "Not deprecated",
                "detail": "active, not deprecated or yanked",
                "points": 20,
                "status": "met",
                "details": [
                  {
                    "code": "package_not_deprecated",
                    "params": {}
                  }
                ],
                "max_points": 20
              }
            ]
          }
        ],
        "description": "Will the project survive its people — bus factor, responsiveness, who backs it, and package upkeep?"
      },
      {
        "key": "engineering",
        "band": "good",
        "name": "Engineering Quality",
        "value": 84,
        "weight": 0.2,
        "metrics": [
          {
            "key": "engineering_practices",
            "band": "good",
            "name": "Engineering practices",
            "note": null,
            "notes": [],
            "value": 74,
            "inputs": {
              "has_ci": true,
              "has_tests": true,
              "has_editorconfig": false,
              "has_linter_config": true,
              "has_precommit_config": true
            },
            "components": [
              {
                "key": "ci_workflows",
                "name": "CI workflows",
                "detail": "5 workflow(s)",
                "points": 24,
                "status": "met",
                "details": [
                  {
                    "code": "ci_workflows",
                    "params": {
                      "count": 5
                    }
                  }
                ],
                "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": ".flake8",
                "points": 16,
                "status": "met",
                "details": [
                  {
                    "code": "file_list",
                    "params": {
                      "files": ".flake8"
                    }
                  }
                ],
                "max_points": 16
              },
              {
                "key": "pre_commit_hooks",
                "name": "Pre-commit hooks",
                "detail": null,
                "points": 9.6,
                "status": "met",
                "details": [],
                "max_points": 9.6
              },
              {
                "key": "editorconfig",
                "name": ".editorconfig",
                "detail": null,
                "points": 0,
                "status": "missed",
                "details": [],
                "max_points": 6.4
              },
              {
                "key": "openssf_scorecard_ci_tests",
                "name": "OpenSSF Scorecard: CI-Tests",
                "detail": "0 out of 1 merged PRs checked by a CI test -- score normalized to 0",
                "points": 0,
                "status": "missed",
                "details": [],
                "max_points": 20
              }
            ]
          },
          {
            "key": "documentation",
            "band": "excellent",
            "name": "Documentation",
            "note": null,
            "notes": [],
            "value": 100,
            "inputs": {
              "topics": [
                "stock-market",
                "data-extraction",
                "stock-screener",
                "quantitative-finance",
                "quantitative-analysis",
                "quantitative-trading"
              ],
              "has_wiki": true,
              "homepage": "https://vnstocks.com",
              "has_readme": true,
              "has_docs_dir": true,
              "has_description": true
            },
            "components": [
              {
                "key": "readme",
                "name": "README",
                "detail": null,
                "points": 30,
                "status": "met",
                "details": [],
                "max_points": 30
              },
              {
                "key": "documentation_directory",
                "name": "Documentation directory",
                "detail": null,
                "points": 25,
                "status": "met",
                "details": [],
                "max_points": 25
              },
              {
                "key": "documentation_homepage_site",
                "name": "Documentation / homepage site",
                "detail": "https://vnstocks.com",
                "points": 15,
                "status": "met",
                "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": "6 topics",
                "points": 10,
                "status": "met",
                "details": [
                  {
                    "code": "topics_count",
                    "params": {
                      "count": 6
                    }
                  }
                ],
                "max_points": 10
              },
              {
                "key": "wiki",
                "name": "Wiki",
                "detail": null,
                "points": 10,
                "status": "met",
                "details": [],
                "max_points": 10
              }
            ]
          }
        ],
        "description": "Are baseline engineering and documentation practices in place?"
      },
      {
        "key": "security",
        "band": "moderate",
        "name": "Security",
        "value": 50,
        "weight": 0.16,
        "metrics": [
          {
            "key": "security_posture",
            "band": "at_risk",
            "name": "Security posture",
            "note": "Excluded from scoring (no data or not applicable): Packaging, Signed-Releases. Remaining weights renormalized.",
            "notes": [
              {
                "code": "excluded_no_data",
                "params": {
                  "components": [
                    "packaging",
                    "signed_releases"
                  ]
                }
              },
              {
                "code": "weights_renormalized",
                "params": {}
              }
            ],
            "value": 37,
            "inputs": {
              "source": "openssf_scorecard",
              "checks_evaluated": 16,
              "scorecard_version": "v5.5.0",
              "checks_inconclusive": 2,
              "scorecard_aggregate": 3.7
            },
            "components": [
              {
                "key": "binary_artifacts",
                "name": "Binary-Artifacts",
                "detail": "no binaries found in the repo",
                "points": 7.5,
                "status": "met",
                "details": [],
                "max_points": 7.5
              },
              {
                "key": "branch_protection",
                "name": "Branch-Protection",
                "detail": "branch protection is not maximal on development and all release branches",
                "points": 2.2,
                "status": "partial",
                "details": [],
                "max_points": 7.5
              },
              {
                "key": "ci_tests",
                "name": "CI-Tests",
                "detail": "0 out of 1 merged PRs checked by a CI test -- score normalized to 0",
                "points": 0,
                "status": "missed",
                "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/30 approved changesets -- score normalized to 0",
                "points": 0,
                "status": "missed",
                "details": [],
                "max_points": 7.5
              },
              {
                "key": "contributors",
                "name": "Contributors",
                "detail": "project has 1 contributing companies or organizations -- score normalized to 3",
                "points": 0.8,
                "status": "partial",
                "details": [],
                "max_points": 2.5
              },
              {
                "key": "dangerous_workflow",
                "name": "Dangerous-Workflow",
                "detail": "no dangerous workflow patterns detected",
                "points": 10,
                "status": "met",
                "details": [],
                "max_points": 10
              },
              {
                "key": "dependency_update_tool",
                "name": "Dependency-Update-Tool",
                "detail": "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.2,
                "status": "partial",
                "details": [],
                "max_points": 2.5
              },
              {
                "key": "maintained",
                "name": "Maintained",
                "detail": "11 commit(s) and 2 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 not detected",
                "points": 0,
                "status": "excluded",
                "details": [
                  {
                    "code": "no_data",
                    "params": {}
                  }
                ],
                "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": 0,
                "status": "missed",
                "details": [],
                "max_points": 7.5
              },
              {
                "key": "vulnerabilities",
                "name": "Vulnerabilities",
                "detail": "5 existing vulnerabilities detected",
                "points": 3.8,
                "status": "partial",
                "details": [],
                "max_points": 7.5
              }
            ]
          },
          {
            "key": "dependency_advisories",
            "band": "excellent",
            "name": "Dependency advisories",
            "note": "Excluded from scoring (no data or not applicable): No advisories left outstanding. Remaining weights renormalized. Matched the pypi:vnstock@4.0.5 runtime dependency closure — what installing the published package pulls in — 38 packages. Reachability is not analyzed.",
            "notes": [
              {
                "code": "excluded_no_data",
                "params": {
                  "components": [
                    "no_advisories_left_outstanding"
                  ]
                }
              },
              {
                "code": "weights_renormalized",
                "params": {}
              },
              {
                "code": "advisories_scope_published",
                "params": {
                  "package": "pypi:vnstock@4.0.5",
                  "assessed": 38
                }
              },
              {
                "code": "advisories_reachability",
                "params": {}
              }
            ],
            "value": 100,
            "inputs": {
              "source": "osv",
              "advisories": 0,
              "affected_packages": 0,
              "assessed_packages": 38,
              "unassessed_packages": 0,
              "affected_by_severity": "none",
              "direct_affected_packages": 0
            },
            "components": [
              {
                "key": "direct_dependencies_free_of_known_advisories",
                "name": "Direct dependencies free of known advisories",
                "detail": "no direct dependency carries a known advisory",
                "points": 35,
                "status": "met",
                "details": [
                  {
                    "code": "no_direct_advisories",
                    "params": {}
                  }
                ],
                "max_points": 35
              },
              {
                "key": "indirect_dependencies_free_of_known_advisories",
                "name": "Indirect dependencies free of known advisories",
                "detail": "no indirect dependency carries a known advisory",
                "points": 25,
                "status": "met",
                "details": [
                  {
                    "code": "no_indirect_advisories",
                    "params": {}
                  }
                ],
                "max_points": 25
              },
              {
                "key": "no_advisories_left_outstanding",
                "name": "No advisories left outstanding",
                "detail": "no advisory carries a publication date",
                "points": 0,
                "status": "excluded",
                "details": [
                  {
                    "code": "advisories_no_publication_date",
                    "params": {}
                  }
                ],
                "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": 38,
              "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": 8
            },
            "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": 64,
        "weight": 0,
        "metrics": [
          {
            "key": "ai_agent_context",
            "band": "good",
            "name": "Agent context & guidance",
            "note": null,
            "notes": [],
            "value": 84,
            "inputs": {
              "has_llms_txt": false,
              "legible_history_share": 0.74,
              "agent_instruction_files": [
                "AGENTS.md"
              ],
              "agent_instruction_max_bytes": 3903
            },
            "components": [
              {
                "key": "agent_instructions",
                "name": "Agent instructions",
                "detail": "AGENTS.md",
                "points": 45,
                "status": "met",
                "details": [
                  {
                    "code": "file_list",
                    "params": {
                      "files": "AGENTS.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": "74 of 100 human commits state their intent (structured subject or explanatory body)",
                "points": 39.5,
                "status": "partial",
                "details": [
                  {
                    "code": "legible_history",
                    "params": {
                      "legible": 74,
                      "sampled": 100
                    }
                  }
                ],
                "max_points": 40
              }
            ]
          },
          {
            "key": "ai_verify_loop",
            "band": "moderate",
            "name": "Verify loop (build / test / typecheck)",
            "note": null,
            "notes": [],
            "value": 61,
            "inputs": {
              "has_nix": false,
              "has_tests": true,
              "lockfiles": [],
              "has_dockerfile": false,
              "typed_language": false,
              "bootstrap_files": [
                "Makefile"
              ],
              "has_devcontainer": true,
              "has_linter_config": true,
              "typecheck_configs": [],
              "agent_commit_share": 0,
              "toolchain_manifests": [],
              "dependency_bot_commit_share": 0
            },
            "components": [
              {
                "key": "one_command_bootstrap",
                "name": "One-command bootstrap",
                "detail": "Makefile",
                "points": 18,
                "status": "met",
                "details": [
                  {
                    "code": "file_list",
                    "params": {
                      "files": "Makefile"
                    }
                  }
                ],
                "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": ".flake8",
                "points": 11,
                "status": "met",
                "details": [
                  {
                    "code": "file_list",
                    "params": {
                      "files": ".flake8"
                    }
                  }
                ],
                "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": "devcontainer",
                "points": 10,
                "status": "met",
                "details": [
                  {
                    "code": "file_list",
                    "params": {
                      "files": "devcontainer"
                    }
                  }
                ],
                "max_points": 10
              },
              {
                "key": "demonstrated_agent_practice",
                "name": "Demonstrated agent practice",
                "detail": "no agent-authored commits among the last 100",
                "points": 0,
                "status": "missed",
                "details": [
                  {
                    "code": "no_agent_authored_commits",
                    "params": {
                      "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": 55284,
              "source_files_sampled": 151,
              "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/151 source files over 60KB",
                "points": 55,
                "status": "met",
                "details": [
                  {
                    "code": "oversized_source_files",
                    "params": {
                      "kb": 60,
                      "sampled": 151,
                      "oversized": 0
                    }
                  }
                ],
                "max_points": 55
              }
            ]
          },
          {
            "key": "ai_interfaces",
            "band": "at_risk",
            "name": "Machine-readable interfaces",
            "note": null,
            "notes": [],
            "value": 40,
            "inputs": {
              "example_dirs": [
                "examples",
                "notebooks"
              ],
              "has_mcp_signal": false,
              "api_schema_files": []
            },
            "components": [
              {
                "key": "api_schema_openapi_graphql_proto",
                "name": "API schema (OpenAPI/GraphQL/proto)",
                "detail": null,
                "points": 0,
                "status": "missed",
                "details": [],
                "max_points": 40
              },
              {
                "key": "mcp_server",
                "name": "MCP server",
                "detail": null,
                "points": 0,
                "status": "missed",
                "details": [],
                "max_points": 20
              },
              {
                "key": "runnable_examples",
                "name": "Runnable examples",
                "detail": "examples, notebooks",
                "points": 40,
                "status": "met",
                "details": [
                  {
                    "code": "file_list",
                    "params": {
                      "files": "examples, notebooks"
                    }
                  }
                ],
                "max_points": 40
              }
            ]
          }
        ],
        "description": "How well is the repo equipped to be developed and maintained with AI coding agents? An independent, experimental badge — weight 0.0, so it is surfaced on its own and does not affect the overall health score."
      }
    ],
    "metrics_version": "1.13.0"
  },
  "warnings": [
    "Star history unavailable: GitHub GraphQL error: Resource not accessible by personal access token"
  ],
  "report_type": "repository",
  "generated_at": "2026-07-28T03:13:23.525355Z",
  "schema_version": "0.27.0",
  "badge_url": "https://raw.githubusercontent.com/inspect-software/badges/main/v1/t/thinh-vu/vnstock.svg",
  "full_name": "thinh-vu/vnstock",
  "license_state": "custom",
  "license_spdx": null
}

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 statisticsPyPI.