公开记录
软件健康报告模式 0.27.0 · 指标 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

Python自定义许可证★ 1,358 星标⑂ 292 复刻始于 2022年2月在 GitHub 上查看 ↗

thinh-vu/vnstock 的健康指数为 100 分中的 70 分,处于「良好」区间。 其得分最高的类别是Vitality(85/100),最低的是Security(50/100)。 最近一次更新在 3 天前。 近期的大部分工作由 1 位贡献者完成。

70
总分 / 100
良好

软件健康指数

指标归入加权类别,统一采用 1–100 量表。总体分先取类别加权平均;当公开证据触发高风险司法辖区政策时,评级会按政策调整,并设置 49(有风险)的上限。AI 就绪度不计入总体分。

70
优秀85-100堪称典范;基本满足所有检验标准
良好70-84健康;仅有轻微不足
中等50-69可接受,但存在明显不足;建议进行审查
存在风险30-49存在重大薄弱环节;采用时应保持审慎
危急1-29问题严重(项目被弃置、仅有单一维护者、缺乏基本工程规范)
活力社区与采用可持续性与治理工程质量安全AI 就绪度

评分画像

每条轴代表一个类别。形状比平均值更重要——健康的对象会填满整个图形,而“一峰一谷”式画像意味着某一维度的优势正掩盖另一维度的风险。

所有权

Thinh Vu个人账户
289 关注者26 个公开仓库始于 2018年5月Vnstock

该仓库由个人账户拥有。相较于组织支持的项目,单一所有者项目的延续性风险更高。

软件包生态系统

注册表软件包版本月下载量版本数最近发布标签
PyPIvnstock4.0.5-663 天前vnstockfinancevietnamstock-marketanalysisapi

按类别列示的指标

活力

项目是否仍有生命——是否仍在编写代码,是否仍在发布版本?

85优秀 · 占总体的 22%
评分方式
36/36推送新近度 — 最近一次推送于 3 天前
15.9/36提交节奏 — 52 周中有 23 周有提交
17.8/18提交量 — 最近一年 95 次提交
10/10OpenSSF Scorecard:Maintained — 11 commit(s) and 2 issue activity found in the last 90 days -- score normalized to 10
所用输入
commits_last_year95
human_commit_share1
days_since_last_push3
active_weeks_last_year23

发布纪律

92优秀
评分方式
27/27有发布版本 — 已发布 9 个发布版本
36/36发布时效 — 最近一次发布版本于 18 天前
19.8/27发布节奏 — 约每 59.2 天发布一次
0/10OpenSSF Scorecard:Signed-Releases — 无数据
所用输入
releases_count9
latest_release_tagv4.0.4
releases_from_tags
days_since_latest_release18
mean_days_between_releases59.2
已排除计分(无数据或不适用):OpenSSF Scorecard:Signed-Releases。 其余权重已重新归一化。

社区与采用

项目是否拥有用户、下载量与关注度,并具备欢迎贡献者参与的配置?

64中等 · 占总体的 18%
评分方式
50.8/60星标 — 1,358 个星标
20.5/25复刻 — 292 个复刻
9.6/15关注者 — 54 位关注者
所用输入
forks292
stars1,358
watchers54
growth_stateunverified
growth_factor_pct100
growth_unverified_reasonno_history

社区健康

44存在风险
评分方式
22.5/22.5README
16.9/22.5许可证 — 存在许可证文件,但不是可识别的许可证
0/18CONTRIBUTING 指南
0/13.5行为准则
0/7.2议题模板
0/6.3PR 模板
所用输入
has_readme
has_license
has_contributing
has_issue_template
has_code_of_conduct
has_pull_request_template

可持续性与治理

项目能否在其成员之外延续——巴士系数、响应能力、由谁支持,以及软件包的维护状况?

62中等 · 占总体的 24%
评分方式
9/54巴士系数 — 1 位贡献者贡献了半数提交
0.9/22.5提交分布 — 头号贡献者编写了 96% 的提交
13.5/13.5贡献者广度 — 12 位贡献者
3/10OpenSSF Scorecard:Contributors — project has 1 contributing companies or organizations -- score normalized to 3
所用输入
bus_factor1
contributors_sampled12
top_contributor_share0.961
评分方式
46.8/46.8议题解决 — 100% 的议题已关闭
28.6/38.3PR 接受 — 已裁定的 PR 中 68/91 已合并
0/15OpenSSF Scorecard:Code-Review — Found 1/30 approved changesets -- score normalized to 0
所用输入
merged_prs68
open_issues0
closed_issues132
issue_closed_ratio1
closed_unmerged_prs23
评分方式
10/30所有权背书 — 个人(用户)账户
0/20已验证域名 — 不适用于个人账户
17.7/25所有者影响力 — thinh-vu 有 289 位关注者
22.4/25既往记录 — 26 个公开仓库,账户约 8 年
所用输入
followers289
owner_typeUser
is_verified
owner_loginthinh-vu
public_repos26
account_age_days2,981
已排除计分(无数据或不适用):已验证域名。 其余权重已重新归一化。
评分方式
25/25已发布且可解析 — pypi 上有 1 个软件包
35/35发布时效 — 最近一次发布于 3 天前
20/20版本历史 — 66 个已发布版本
20/20未被弃用 — 活跃,未被弃用或撤回
所用输入
packagesvnstock
ecosystemspypi
any_deprecated
min_days_since_publish3

工程质量

基础的工程与文档实践是否到位?

84良好 · 占总体的 20%

工程实践

74良好
评分方式
24/24CI 工作流 — 5 个工作流
24/24存在测试
16/16Linter 配置 — .flake8
9.6/9.6Pre-commit 钩子
0/6.4.editorconfig
0/20OpenSSF Scorecard:CI-Tests — 0 out of 1 merged PRs checked by a CI test -- score normalized to 0
所用输入
has_ci
has_tests
has_editorconfig
has_linter_config
has_precommit_config

文档

100优秀
评分方式
30/30README
25/25文档目录
15/15文档 / 主页站点 — https://vnstocks.com
10/10仓库描述
10/10主题标签 — 6 个主题标签
10/10Wiki
所用输入
topicsstock-market, data-extraction, stock-screener, quantitative-finance, quantitative-analysis, quantitative-trading
has_wiki
homepagehttps://vnstocks.com
has_readme
has_docs_dir
has_description

安全

可见的安全与供应链实践是否稳固,且不存在未解决的高风险司法辖区暴露?

50中等 · 占总体的 16%

安全态势

37存在风险
评分方式
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.5许可证 — 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 — 无数据
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 — 无数据
0/7.5Token-Permissions — detected GitHub workflow tokens with excessive permissions
3.8/7.5Vulnerabilities — 5 existing vulnerabilities detected
所用输入
sourceopenssf_scorecard
checks_evaluated16
scorecard_versionv5.5.0
checks_inconclusive2
scorecard_aggregate3.7
已排除计分(无数据或不适用):packaging, signed_releases。 其余权重已重新归一化。
评分方式
35/35直接依赖不含已知公告 — 没有直接依赖携带已知公告
25/25间接依赖不含已知公告 — 没有间接依赖携带已知公告
0/40没有长期未处理的公告 — 没有公告带有发布日期
所用输入
sourceosv
advisories0
affected_packages0
assessed_packages38
unassessed_packages0
affected_by_severitynone
direct_affected_packages0
已排除计分(无数据或不适用):没有长期未处理的公告。 其余权重已重新归一化。 比对的是 pypi:vnstock@4.0.5 的运行时依赖闭包——安装已发布的软件包时真正被拉取进来的内容——共 38 个软件包。 未对可达性进行分析。

AI 就绪度

该仓库在多大程度上具备与 AI 编码代理协同开发与维护的条件?这是一枚独立的实验性徽章——权重为 0.0,因此单独呈现,不影响总体健康评分。

64中等 · 占总体的 0%
评分方式
45/45代理指令 — AGENTS.md
0/15机器可读文档(llms.txt)
39.5/40可读的提交历史 — 100 次人类提交中有 74 次说明了意图(结构化标题或解释性正文)
所用输入
has_llms_txt
legible_history_share0.74
agent_instruction_filesAGENTS.md
agent_instruction_max_bytes3,903
评分方式
18/18一条命令的引导启动 — Makefile
22/22自动化测试
11/11Lint / 格式化配置 — .flake8
0/11静态类型检查
10/10可复现环境 — devcontainer
0/10已体现的代理实践 — 最近 100 次提交中没有代理编写的提交
0/8自动化维护 — 未观察到自动依赖更新
0/10OpenSSF Scorecard:Pinned-Dependencies — dependency not pinned by hash detected -- score normalized to 0
所用输入
has_nix
has_tests
lockfiles
has_dockerfile
typed_language
bootstrap_filesMakefile
has_devcontainer
has_linter_config
typecheck_configs
agent_commit_share0
toolchain_manifests
dependency_bot_commit_share0
评分方式
0/45可类型检查的代码 — Python,未配置类型检查
55/55可控的文件大小 — 采样的 151 个源文件中有 0 个超过 60KB
所用输入
primary_languagePython
largest_source_bytes55,284
source_files_sampled151
oversized_source_files0

机器可读接口

40存在风险
评分方式
0/40API 模式(OpenAPI/GraphQL/proto)
0/20MCP 服务器
40/40可运行示例 — examples, notebooks
所用输入
example_dirsexamples, notebooks
has_mcp_signal
api_schema_files

关键数据

1,358GitHub 星标
12贡献者
95最近 12 个月提交数
3距最近推送天数
9发布版本数
1巴士系数(bus factor)
0开放议题
PyPI软件包生态系统数

数据采集警告

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

更多细节

Star 与 Fork 历史 0 ★ / 292 ⇿
0Star
292Fork
9发布

每颗 star 和每个 fork 的添加时间,来自 GitHub 并按天汇总。累计增长位于其构成来源——每日新增——的正上方,二者可相互对照:稳定的自然增长与短暂的突增形态截然不同。当这一差别可被衡量时,它会作为增长真实性予以报告。

05010015020025030029072022-082024-082026-07
主版本 0次版本 3修订 6

每个点涵盖 4 天。

OpenSSF Scorecard 3.7 / 10
3.7综合

来自开源项目 OpenSSF Scorecard 的独立、工具无关的安全评估。每项检查奖励的是安全实践本身,而非特定供应商的工具。Scorecard 无法判定的检查项标记为 不适用,并从安全评分中剔除(绝不按零分计)。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
不适用Packagingpackaging 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
不适用Signed-Releasesno releases found
0Token-Permissionsdetected GitHub workflow tokens with excessive permissions
5Vulnerabilities5 existing vulnerabilities detected
直接依赖 13
注册表软件包版本约束清单文件
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
全部依赖 25

来自 GitHub 依赖图的完整解析依赖集合:16 个直接依赖与 9 个间接(传递)软件包。仓库提交锁文件时,传递闭包才是完整的。

注册表软件包版本关系
PyPIbeautifulsoup4直接
PyPIimportlib-metadata直接
PyPIopenpyxl直接
PyPIopenpyxl3.1.2直接
PyPIpackaging直接
PyPIpandas直接
PyPIpsutil直接
PyPIpsutil6.0.0直接
PyPIpydantic直接
PyPIpytz直接
PyPIrequests直接
PyPIseaborn直接
PyPIseaborn0.13.2直接
PyPItenacity直接
PyPIvnai直接
PyPIvnstock-ezchart直接
PyPIbs40.0.2间接
PyPIcryptography42.0.5间接
PyPIfake-useragent1.5.1间接
PyPImkdocs-glightbox间接
PyPImkdocs-material间接
PyPImkdocs-rss-plugin间接
PyPIpytest间接
PyPIpytest-cov间接
PyPIsetuptools间接
依赖安全公告 0

安装 pypi:vnstock@4.0.5 会引入 38 个包(直接与传递):其中 0 个存在已知公告,0 个为直接依赖。

没有已知公告影响已评估的依赖。

公告表示依赖图中记录的版本落入某条公告的受影响范围。可达性未经分析,且依赖图包含开发与测试的版本固定——某项发现可能只涉及工具链而非交付的软件。

原始 JSON 报告 机器可读
{
  "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
}

评分是信号,而非担保。 评分反映的是 GitHub 上公开可见的实践——不是代码审计,也不是安全保证。

缺失数据将被剔除并重新归一化权重,绝不按零分计。方法论已版本化并公开:指标 v1.13.0、模式 v0.27.0—— 完整方法论 · 指标知识库.

单项结果在整体记录中的位置: 汇总统计PyPI.