{
  "schema": "累計類（cumulative）只能追加 history 增量，totals 由測試驗證＝各筆 history 增量加總；現況類（snapshot）每次更新直接覆寫為當下值。",
  "as_of": "2026-10-12",
  "since": "2026-05-30",
  "cumulative": {
    "official_scripts_distilled": {
      "label": "蒸餾期研讀的官方 XS 腳本",
      "unit": "支",
      "total": 6114,
      "note": "XScript_Preset 1366 支（五類）＋ XQStrategy 4748 支（選股）"
    },
    "lint_validation_script_runs": {
      "label": "lint 驗證掃描的腳本",
      "unit": "支·次",
      "total": 10125,
      "note": "真實語料重掃、突變注入測試、精選語料測試的累計掃描量"
    },
    "false_positives_eliminated": {
      "label": "在官方語料上消除的 lint 誤報",
      "unit": "個",
      "total": 3868,
      "note": "官方程式碼一定合法，其上的警示即誤報"
    },
    "benchmark_task_runs": {
      "label": "「載 skill vs 未載」評測任務",
      "unit": "次",
      "total": 16,
      "note": "8 個任務 × 2 輪，每次各跑載入與未載兩組"
    },
    "skill_generated_test_scripts": {
      "label": "依 skill 規範產生的測試腳本",
      "unit": "支",
      "total": 36,
      "note": "五類各 4 支，用來同時檢驗 skill 與 lint"
    },
    "xshelp_entries_verified": {
      "label": "逐條對照 xshelp 官方站的條目",
      "unit": "條",
      "total": 202,
      "note": "關鍵字大分類全量窮舉並逐頁核對"
    },
    "codex_review_rounds": {
      "label": "Codex 對抗式審查",
      "unit": "輪",
      "total": 30,
      "note": "自 2026-09-23 起記錄；此前未留紀錄，不估算"
    }
  },
  "history": [
    {
      "version": "v0.1.0–v0.5.0",
      "date": "2026-09-23",
      "summary": "開專案到 v0.5.0 的基準：蒸餾官方範例與 xshelp、建立 lint、兩輪評測、窮舉關鍵字與保留字（PR #1）",
      "deltas": {
        "official_scripts_distilled": 6114,
        "lint_validation_script_runs": 6114,
        "false_positives_eliminated": 54,
        "benchmark_task_runs": 16,
        "skill_generated_test_scripts": 0,
        "xshelp_entries_verified": 110,
        "codex_review_rounds": 7
      },
      "evidence": {
        "official_scripts_distilled": "skills/xs/references/script-types.md §0（Preset 1366 支依 {@type:} 分布）；commit d74d52f（以 sources/ 全 6114 支重掃）；sysjust-xq/XQStrategy clone 實數 4748 支",
        "lint_validation_script_runs": "commit d74d52f：KNOWN_TOKENS 重生後對 6114 支真實 .xs 重掃",
        "false_positives_eliminated": "commit d74d52f：誤判面 55 → 1",
        "benchmark_task_runs": "docs/index.html 評測報表：8 案例、38 條 assertion、2 輪",
        "xshelp_entries_verified": "skills/xs/references/language.md §9；CHANGELOG [0.5.0]",
        "codex_review_rounds": "PR #1 共 5 輪、v0.5.0 發版 2 輪（本 session 紀錄）"
      }
    },
    {
      "version": "v0.5.1",
      "date": "2026-09-24",
      "summary": "修正 lint 把宣告名稱誤報為未知函數（issue #2）並改為線性掃描；新增 AGENTS.md；以官方全量語料、突變注入與 50 支精選語料做高強度驗證",
      "deltas": {
        "official_scripts_distilled": 0,
        "lint_validation_script_runs": 3995,
        "false_positives_eliminated": 3814,
        "benchmark_task_runs": 0,
        "skill_generated_test_scripts": 20,
        "xshelp_entries_verified": 0,
        "codex_review_rounds": 5
      },
      "evidence": {
        "lint_validation_script_runs": "XScript_Preset 全量 1419 支 ＋ 檔尾突變注入 1419 支 ＋ 宣告初始值突變注入 1107 支（篩選條件：行首 var/vars/variable(s)/input(s) 宣告且名稱後直接接「(」的檔案；不含 array、group） ＋ 精選語料 50 支（30 官方 ＋ 20 skill 產生）",
        "false_positives_eliminated": "XScript_Preset（sysjust-xq，commit d15a415）全量 1419 支：誤報 3814 → 0，且無新增警示",
        "skill_generated_test_scripts": "subagent 依 skills/xs/ 規範撰寫，五類各 4 支",
        "codex_review_rounds": "AGENTS.md 2 輪、issue #2 修正 2 輪、v0.5.1 發版與統計頁 1 輪（本 session 紀錄；最後只改統計數字的 commit 不另送審，由 TestEffortStats 把關）"
      }
    },
    {
      "version": "v0.6.0",
      "date": "2026-09-24",
      "summary": "補齊 skill reference 缺口：Plot／OutputField 命名參數與多載、流程控制官方寫法、Rank 與參數 UI 宣告、型別語意，並依 xshelp 函數目錄補入 42 個漏收函數（新增 SDTFUNC 分類）；以 skill 重寫 15 支驗收腳本、範圍內類推歸零",
      "deltas": {
        "official_scripts_distilled": 0,
        "lint_validation_script_runs": 15,
        "false_positives_eliminated": 0,
        "benchmark_task_runs": 0,
        "skill_generated_test_scripts": 15,
        "xshelp_entries_verified": 44,
        "codex_review_rounds": 3
      },
      "evidence": {
        "lint_validation_script_runs": "Task 7 三輪驗收：7＋7＋1 支，由未看計畫的 fresh subagent 只依 skills/xs/ 撰寫，全數通過 xs_lint",
        "skill_generated_test_scripts": "Task 7 三輪驗收：7＋7＋1 支，由未看計畫的 fresh subagent 只依 skills/xs/ 撰寫，全數通過 xs_lint",
        "xshelp_entries_verified": "Plot、OutputField 兩條目＋42 個 xshelp 函數（含新分類 SDTFUNC）逐條以 rest 索引 API 取 desc/fulldesc 撰寫；與 v0.5.0 已計的 110 個關鍵字條目重複核對者不重複計",
        "codex_review_rounds": "檢查點 A 1 輪、發版檢查點 B 2 輪（本 session 紀錄；最後只改統計數字的 commit 不另送審，由 TestEffortStats 把關）"
      }
    },
    {
      "version": "v0.7.0",
      "date": "2026-09-24",
      "summary": "新增 xshelp 全站名稱索引（1621 個名稱）與本機鏡像腳本；F3 改走索引 API；lint 名單與索引一致性測試",
      "deltas": {
        "official_scripts_distilled": 0,
        "lint_validation_script_runs": 1,
        "false_positives_eliminated": 0,
        "benchmark_task_runs": 0,
        "skill_generated_test_scripts": 1,
        "xshelp_entries_verified": 0,
        "codex_review_rounds": 3
      },
      "evidence": {
        "lint_validation_script_runs": "Task 5 驗收腳本 filter.xs 通過 xs_lint",
        "skill_generated_test_scripts": "Task 5 由只讀 skill 的 fresh subagent 撰寫、使用只見於索引的欄位",
        "xshelp_entries_verified": "索引只收名稱，不算逐條內容核對，故不增加",
        "codex_review_rounds": "發版前最終審查 3 輪（抓到 fetch 未驗證回應、截斷資料可通過、測試寫暫存檔三個問題，均已修正）；最後只改統計數字的 commit 不另送審，由 TestEffortStats 把關"
      }
    },
    {
      "version": "v0.7.1",
      "date": "2026-10-12",
      "summary": "修正版：xshelp 名稱索引補收官方別名（1120 組別名對照），F3 改為依出現位置查找；依 xshelp 原文更正 StandardDev 樣本參數、xf_ 頻率、SetTotalBar 語意、資料欄位的可用腳本；鏡像腳本改以名稱＋分組防縮水並加 schema 與 round-trip 檢查",
      "deltas": {
        "official_scripts_distilled": 0,
        "lint_validation_script_runs": 0,
        "false_positives_eliminated": 0,
        "benchmark_task_runs": 0,
        "skill_generated_test_scripts": 0,
        "xshelp_entries_verified": 48,
        "codex_review_rounds": 12
      },
      "evidence": {
        "xshelp_entries_verified": "逐條對照 desc/fulldesc：StandardDev、VariancePS、SetTotalBar、SetBackBar、xf_* 14 條、xfMin_* 15 條、DateAdd、FormatDate、SummationIF、NthHighest、GetField、GetSymbolField、GetQuote、GetSymbolInfo、GetFieldDate、GetSymbolFieldDate、月營收年增率、漲跌幅（QPRICE、FOFTEN）、成交金額(元) QVOLUME、股本(億) FBASIC，共 48 條；均非先前版本已計的關鍵字條目或 v0.6.0 補收的 42 個函數",
        "codex_review_rounds": "Codex adversarial-review 實際完成 12 輪：第 1 輪誤把 --help 當審查焦點（未審本次 diff），其餘 11 輪逐輪修正；第 13 輪因 Codex 額度用完未執行，經使用者同意改由 fresh opus subagent 代審 2 輪（不計入本項）。最後只改統計數字的修改不另送審，由 TestEffortStats 把關"
      }
    }
  ],
  "snapshot": {
    "reference_docs": {
      "label": "reference 文件",
      "value": "11 份",
      "note": "5 份規範 ＋ 1 份 xshelp 名稱索引 ＋ 5 份範例（含 12 段精選 XS 程式碼）"
    },
    "xshelp_index": {
      "label": "xshelp 名稱索引",
      "value": "1621 個",
      "note": "10 大類 54 分組，另收 1120 組別名對照"
    },
    "system_functions": {
      "label": "收錄的 Preset 系統函數",
      "value": "224 個",
      "note": "依官方目錄分 14 類（system-functions.md）"
    },
    "builtin_categories": {
      "label": "xshelp 內建函數分類",
      "value": "9 類",
      "note": "builtin-functions.md（v0.6.0 起新增 SDTFUNC）"
    },
    "keywords": {
      "label": "關鍵字與保留字",
      "value": "110 個",
      "note": "含 4 個保留字 Bool / Int / Float / Double"
    },
    "screening_fields": {
      "label": "選股欄位",
      "value": "498+ 種",
      "note": "fields.md 所列中文欄位"
    },
    "known_tokens": {
      "label": "lint 內建已知 token",
      "value": "659 個",
      "note": "grammar ∪ Preset 系統函數 ∪ xshelp 內建函數 ∪ 可呼叫關鍵字，扣除保留字"
    },
    "lint_rules": {
      "label": "lint 檢查",
      "value": "結構 ＋ 未知呼叫",
      "note": "begin/end 與 if/then 配對；未知函數呼叫（豁免宣告名稱、保留字呼叫會警示）"
    },
    "unit_tests": {
      "label": "單元測試",
      "value": "140 個",
      "note": "v0.1.0 時為 17 個"
    },
    "commits": {
      "label": "commit",
      "value": "81 個",
      "note": "main 分支"
    },
    "releases": {
      "label": "版本",
      "value": "12 個",
      "note": "v0.1.0 至 v0.7.1 的 git tag"
    },
    "dev_days": {
      "label": "開發期間",
      "value": "135 天",
      "note": "2026-05-30 起"
    }
  }
}
