@laitszkin/apollo-toolkit 4.0.11 → 4.1.0

package/resources/project-architecture/atlas/atlas.index.yaml

@@ -1,7 +1,11 @@
 meta:
-  title: Project architecture
-  summary: ''
-  updatedAt: '2026-05-29T13:27:30.595Z'
+  title: Project architecture  (+ codegraph integration overlay)
+  summary: >
+    完整 C4 架構圖：eval 評測系統 (8 features) + codegraph 程式碼分析 (1 feature, 3 submodules)。
+    外部 actor: Judge Model API, GitHub Actions CI, Developer, Skill Files,
+    @colbymchenry/codegraph (npm), @laitszkin/tool-registry, @laitszkin/tui。
+    Eval 管線包含完整資料流: CLI → Executor → Scorer → Reporter → CI Gate。
+  updatedAt: '2026-06-03T13:18:57.448Z'
 actors:
   - id: judge-model-api
     label: Judge Model API
@@ -11,7 +15,14 @@ actors:
     label: Developer
   - id: skill-files
     label: Skill Files (SKILL.md, scripts/, references/, assets/)
+  - id: codegraph-npm
+    label: '@colbymchenry/codegraph npm package'
+  - id: tool-registry
+    label: Tool Registry (@laitszkin/tool-registry)
+  - id: tui-lib
+    label: TUI Library (@laitszkin/tui)
 features:
+  - codegraph
   - eval-optimizer
   - eval-cli
   - eval-ci-gate
@@ -21,24 +32,77 @@ features:
   - eval-scorer
   - eval-reporter
 edges:
-  - id: e-101
+  - id: cg-e-001
     from:
-      feature: eval-cli
+      feature: codegraph
+      submodule: cg-lifecycle
     to:
-      feature: eval-optimizer
+      feature: codegraph
+      submodule: cg-discovery
+    kind: data-row
+    label: survey/list-apis 依賴已索引的資料庫
+  - id: cg-e-002
+    from:
+      feature: codegraph
+      submodule: cg-discovery
+    to:
+      feature: codegraph
+      submodule: cg-validation
+    kind: data-row
+    label: verify 使用 discovery 的搜尋能力
+  - id: cg-e-003
+    from:
+      feature: codegraph
+      submodule: cg-lifecycle
+    to:
+      feature: eval-cli
     kind: call
-    label: trigger optimization after scoring
-  - id: e-102
+    label: codegraph init --index 與 eval-cli 共用 CLI 工具基礎架構
+  - id: eval-cli-exec
     from:
       feature: eval-cli
+      submodule: cli-handler
+    to:
+      feature: eval-executor
+      submodule: trace-recorder
+    kind: call
+    label: evalHandler 觸發 runSingleTest
+  - id: eval-exec-iso
+    from:
+      feature: eval-executor
+      submodule: trace-recorder
     to:
       feature: eval-isolation
+      submodule: tool-dispatcher
     kind: call
-    label: setup tool mock + context isolation
-  - id: e-103
+    label: 執行隔離環境中的工具調用
+  - id: eval-exec-scorer
     from:
-      feature: eval-ci-gate
+      feature: eval-executor
+      submodule: trace-recorder
+    to:
+      feature: eval-scorer
+      submodule: judge-prompt-builder
+    kind: data-row
+    label: trace events 送入評分
+  - id: eval-scorer-reporter
+    from:
+      feature: eval-scorer
+    to:
+      feature: eval-reporter
+    kind: data-row
+    label: ScoreResult 送入報告組合
+  - id: eval-exec-optimizer
+    from:
+      feature: eval-executor
     to:
+      feature: eval-optimizer
+    kind: data-row
+    label: 執行結果觸發優化
+  - id: eval-cli-ci
+    from:
       feature: eval-cli
+    to:
+      feature: eval-ci-gate
     kind: call
-    label: invoke apltk eval --mode standard
+    label: CI 模式下觸發 PR 回報

package/resources/project-architecture/atlas/features/codegraph.yaml

@@ -0,0 +1,95 @@
+slug: codegraph
+title: CodeGraph Integration
+story: >
+  Provide LLM agents with deterministic code structure data through apltk CLI. Replaces manual
+  grep/Read discovery with tree-sitter parsed knowledge graph queries.
+dependsOn:
+  - eval-cli
+submodules:
+  - slug: cg-lifecycle
+    kind: service
+    role: Manage CodeGraph index lifecycle — init, sync, status, search
+    functions:
+      - name: init
+        in: 'projectRoot: string'
+        out: CodeGraph instance
+        side: io
+        purpose: Initialize .codegraph/ directory and optionally run full index
+      - name: sync
+        in: 'projectRoot: string'
+        out: SyncResult
+        side: io
+        purpose: Incremental update of existing index
+      - name: status
+        in: 'projectRoot: string'
+        out: GraphStats
+        side: pure
+        purpose: Query index statistics
+      - name: search
+        in: 'query: string'
+        out: SearchResult[]
+        side: pure
+        purpose: Full-text symbol search via FTS5
+    variables: []
+    dataflow: []
+    errors: []
+  - slug: cg-discovery
+    kind: service
+    role: Explore and survey code structure — explore, survey, list-apis
+    functions:
+      - name: explore
+        in: 'query: string'
+        out: Context (source grouped by file + relationship map)
+        side: pure
+        purpose: Get full context for symbols matching a query
+      - name: survey
+        in: 'dirPath: string'
+        out: SurveyReport (submodule suggestions + edge suggestions)
+        side: pure
+        purpose: Survey a directory and produce atlas-compatible structure report
+      - name: listApis
+        in: 'featureSlug: string'
+        out: APIDirectory (public functions + params + callers)
+        side: pure
+        purpose: List public API surface of a feature area
+    variables: []
+    dataflow: []
+    errors: []
+  - slug: cg-validation
+    kind: service
+    role: Verify architecture proposals and batch-apply atlas mutations
+    functions:
+      - name: verify
+        in: 'specOverlayPath: string'
+        out: VerifyReport (passed/failed items)
+        side: pure
+        purpose: Validate that spec overlay references match actual code
+      - name: applyBatch
+        in: 'proposalYaml: string'
+        out: ApplyResult
+        side: io
+        purpose: Execute multiple atlas mutations from a single YAML file
+      - name: generateTemplate
+        in: 'specMdPath: string'
+        out: proposalYaml path
+        side: io
+        purpose: Generate empty proposal skeleton from SPEC.md
+    variables: []
+    dataflow: []
+    errors: []
+edges:
+  - id: cg-fe-001
+    from: cg-lifecycle
+    to: cg-discovery
+    kind: data-row
+    label: survey/list-apis 依賴已索引的資料庫
+  - id: cg-fe-002
+    from: cg-discovery
+    to: cg-validation
+    kind: data-row
+    label: verify 使用 discovery 的搜尋能力
+  - id: cg-fe-003
+    from: cg-validation
+    to: cg-lifecycle
+    kind: data-row
+    label: apply 非索引操作，不需 lifecycle — 但 template 可搭配 list-apis

package/resources/project-architecture/atlas/features/eval-ci-gate.yaml

@@ -6,7 +6,12 @@ submodules:
   - slug: workflow-trigger
     kind: service
     role: GitHub Actions workflow on PR skill file change
-    functions: []
+    functions:
+      - name: detectSkillChanges
+        in: prFiles
+        out: string[]
+        side: pure
+        purpose: 檢測 PR 中技能檔案變更
     variables: []
     dataflow: []
     errors: []

package/resources/project-architecture/atlas/features/eval-cli.yaml

@@ -6,7 +6,22 @@ submodules:
   - slug: cli-handler
     kind: service
     role: ToolDefinition註冊、參數解析、流程編排
-    functions: []
+    functions:
+      - name: evalHandler
+        in: argv, context
+        out: exitCode
+        side: pure
+        purpose: CLI 入口：解析參數、調度評測流程
+      - name: parseArgs
+        in: argv
+        out: ParsedArgs
+        side: pure
+        purpose: 解析 CLI 參數與模式選擇
+      - name: tool
+        in: ToolDefinition
+        out: void
+        side: pure
+        purpose: 向 tool-registry 註冊 eval 命令
     variables: []
     dataflow: []
     errors: []

package/resources/project-architecture/atlas/features/eval-executor.yaml

@@ -6,14 +6,24 @@ submodules:
   - slug: trace-recorder
     kind: service
     role: 多輪tool-use loop軌跡記錄：tool_call/tool_result事件序列、JSONL行號標記、.done完成標記
-    functions: []
+    functions:
+      - name: runSingleTest
+        in: question, skillDir
+        out: TraceEvent[]
+        side: pure
+        purpose: 執行單一技能測試，記錄 tool call 軌跡
     variables: []
     dataflow: []
     errors: []
   - slug: exec-api-client
     kind: api
     role: Exec Model HTTP client with retry
-    functions: []
+    functions:
+      - name: withRetry
+        in: fn, options
+        out: Result
+        side: io
+        purpose: HTTP client with retry for exec model
     variables: []
     dataflow: []
     errors: []

package/resources/project-architecture/atlas/features/eval-isolation.yaml

@@ -6,7 +6,12 @@ submodules:
   - slug: tool-dispatcher
     kind: service
     role: 工具調用攔截系統：讀取工具在workspace內真實執行、寫入工具模擬回傳、路徑穿越防護
-    functions: []
+    functions:
+      - name: buildSystemPrompt
+        in: question
+        out: string
+        side: pure
+        purpose: 建立隔離環境的 system prompt
     variables: []
     dataflow: []
     errors: []

package/resources/project-architecture/atlas/features/eval-optimizer.yaml

@@ -6,14 +6,29 @@ submodules:
   - slug: issue-extractor
     kind: service
     role: 從score.json提取問題、分類統計
-    functions: []
+    functions:
+      - name: extractIssues
+        in: scores
+        out: RawIssue[]
+        side: pure
+        purpose: 從 score.json 提取問題與分類統計
+      - name: generateOptimizationPlan
+        in: issues
+        out: OptimizationPlan
+        side: pure
+        purpose: 從去重後問題生成 FIND/REPLACE 優化 diff
     variables: []
     dataflow: []
     errors: []
   - slug: dedup-engine
     kind: service
     role: Jaccard+Judge語意去重
-    functions: []
+    functions:
+      - name: deduplicateIssues
+        in: issues
+        out: DedupedIssue[]
+        side: pure
+        purpose: Jaccard+Judge 語意去重
     variables: []
     dataflow: []
     errors: []

package/resources/project-architecture/atlas/features/eval-question.yaml

@@ -6,14 +6,24 @@ submodules:
   - slug: question-loader
     kind: service
     role: 題目載入與JSON Schema驗證
-    functions: []
+    functions:
+      - name: loadQuestions
+        in: specDir
+        out: Question[]
+        side: pure
+        purpose: 載入題目並進行 JSON Schema 驗證
     variables: []
     dataflow: []
     errors: []
   - slug: variant-generator
     kind: service
     role: LLM變體生成，保留評分標準
-    functions: []
+    functions:
+      - name: generateVariants
+        in: questions, count
+        out: Question[]
+        side: io
+        purpose: LLM 變體生成，保留評分標準
     variables: []
     dataflow: []
     errors: []

package/resources/project-architecture/atlas/features/eval-reporter.yaml

@@ -6,7 +6,12 @@ submodules:
   - slug: report-composer
     kind: service
     role: Markdown報告組合與渲染
-    functions: []
+    functions:
+      - name: generateReport
+        in: scores
+        out: string
+        side: pure
+        purpose: 彙總評分結果產出結構化 Markdown 報告
     variables: []
     dataflow: []
     errors: []

package/resources/project-architecture/atlas/features/eval-scorer.yaml

@@ -6,14 +6,24 @@ submodules:
   - slug: judge-prompt-builder
     kind: service
     role: 評分提示詞構建：trace事件摘要含JSONL行號(L{N})引用、三維度評分指示
-    functions: []
+    functions:
+      - name: buildJudgePrompt
+        in: trace, scoreCriteria
+        out: string
+        side: pure
+        purpose: 將 trace 事件摘要轉為評分提示詞
     variables: []
     dataflow: []
     errors: []
   - slug: judge-api-client
     kind: api
     role: Judge Model HTTP client with parse fallback
-    functions: []
+    functions:
+      - name: callJudgeModel
+        in: prompt, options
+        out: ScoreResult
+        side: io
+        purpose: 呼叫 Judge Model API 進行評分
     variables: []
     dataflow: []
     errors: []

package/resources/project-architecture/features/codegraph/cg-discovery.html

@@ -0,0 +1,47 @@
+<!DOCTYPE html>
+<html lang="en" data-atlas-page="submodule">
+<head>
+  <meta charset="utf-8">
+  <title>CodeGraph Integration · cg-discovery</title>
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <meta name="color-scheme" content="dark">
+  <link rel="preconnect" href="https://fonts.googleapis.com">
+  <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+  <link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Fraunces:ital,opsz,wght@0,9..144,300..600;1,9..144,300..500&family=Geist:wght@300..700&family=JetBrains+Mono:wght@400..600&display=swap">
+  <link rel="stylesheet" href="../../assets/architecture.css">
+</head>
+<body>
+  <header class="submodule-header">
+    <nav class="submodule-breadcrumb"><a href="../../index.html">← Atlas</a> · <a href="index.html">← CodeGraph Integration</a></nav>
+    <h1>cg-discovery <small class="submodule-kind">Service</small></h1>
+    <p class="submodule-role">Explore and survey code structure — explore, survey, list-apis</p>
+    
+  </header>
+  <main class="submodule-main">
+    <section aria-label="Function I/O">
+      <h2>Function I/O</h2>
+      <table class="sub-table">
+        <thead><tr><th scope="col">Name</th><th scope="col">In</th><th scope="col">Out</th><th scope="col">Side</th><th scope="col">Purpose</th></tr></thead>
+        <tbody>
+          <tr><td>explore</td><td>query: string</td><td>Context (source grouped by file + relationship map)</td><td>pure</td><td>Get full context for symbols matching a query</td></tr>
+          <tr><td>survey</td><td>dirPath: string</td><td>SurveyReport (submodule suggestions + edge suggestions)</td><td>pure</td><td>Survey a directory and produce atlas-compatible structure report</td></tr>
+          <tr><td>listApis</td><td>featureSlug: string</td><td>APIDirectory (public functions + params + callers)</td><td>pure</td><td>List public API surface of a feature area</td></tr>
+        </tbody>
+      </table>
+    </section>
+    <section aria-label="Variables">
+      <h2>Variables</h2>
+      <p class="sub-section__empty">No variables recorded.</p>
+    </section>
+    <section aria-label="Internal data flow">
+      <h2>Internal data flow</h2>
+      <p class="sub-dataflow__empty">No internal dataflow steps recorded.</p>
+    </section>
+    <section aria-label="Errors">
+      <h2>Errors</h2>
+      <p class="sub-section__empty">No errors recorded.</p>
+    </section>
+  </main>
+  <script src="../../assets/viewer.client.js" defer></script>
+</body>
+</html>

package/resources/project-architecture/features/codegraph/cg-lifecycle.html

@@ -0,0 +1,48 @@
+<!DOCTYPE html>
+<html lang="en" data-atlas-page="submodule">
+<head>
+  <meta charset="utf-8">
+  <title>CodeGraph Integration · cg-lifecycle</title>
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <meta name="color-scheme" content="dark">
+  <link rel="preconnect" href="https://fonts.googleapis.com">
+  <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+  <link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Fraunces:ital,opsz,wght@0,9..144,300..600;1,9..144,300..500&family=Geist:wght@300..700&family=JetBrains+Mono:wght@400..600&display=swap">
+  <link rel="stylesheet" href="../../assets/architecture.css">
+</head>
+<body>
+  <header class="submodule-header">
+    <nav class="submodule-breadcrumb"><a href="../../index.html">← Atlas</a> · <a href="index.html">← CodeGraph Integration</a></nav>
+    <h1>cg-lifecycle <small class="submodule-kind">Service</small></h1>
+    <p class="submodule-role">Manage CodeGraph index lifecycle — init, sync, status, search</p>
+    
+  </header>
+  <main class="submodule-main">
+    <section aria-label="Function I/O">
+      <h2>Function I/O</h2>
+      <table class="sub-table">
+        <thead><tr><th scope="col">Name</th><th scope="col">In</th><th scope="col">Out</th><th scope="col">Side</th><th scope="col">Purpose</th></tr></thead>
+        <tbody>
+          <tr><td>init</td><td>projectRoot: string</td><td>CodeGraph instance</td><td>io</td><td>Initialize .codegraph/ directory and optionally run full index</td></tr>
+          <tr><td>sync</td><td>projectRoot: string</td><td>SyncResult</td><td>io</td><td>Incremental update of existing index</td></tr>
+          <tr><td>status</td><td>projectRoot: string</td><td>GraphStats</td><td>pure</td><td>Query index statistics</td></tr>
+          <tr><td>search</td><td>query: string</td><td>SearchResult[]</td><td>pure</td><td>Full-text symbol search via FTS5</td></tr>
+        </tbody>
+      </table>
+    </section>
+    <section aria-label="Variables">
+      <h2>Variables</h2>
+      <p class="sub-section__empty">No variables recorded.</p>
+    </section>
+    <section aria-label="Internal data flow">
+      <h2>Internal data flow</h2>
+      <p class="sub-dataflow__empty">No internal dataflow steps recorded.</p>
+    </section>
+    <section aria-label="Errors">
+      <h2>Errors</h2>
+      <p class="sub-section__empty">No errors recorded.</p>
+    </section>
+  </main>
+  <script src="../../assets/viewer.client.js" defer></script>
+</body>
+</html>

package/resources/project-architecture/features/codegraph/cg-validation.html

@@ -0,0 +1,47 @@
+<!DOCTYPE html>
+<html lang="en" data-atlas-page="submodule">
+<head>
+  <meta charset="utf-8">
+  <title>CodeGraph Integration · cg-validation</title>
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <meta name="color-scheme" content="dark">
+  <link rel="preconnect" href="https://fonts.googleapis.com">
+  <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+  <link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Fraunces:ital,opsz,wght@0,9..144,300..600;1,9..144,300..500&family=Geist:wght@300..700&family=JetBrains+Mono:wght@400..600&display=swap">
+  <link rel="stylesheet" href="../../assets/architecture.css">
+</head>
+<body>
+  <header class="submodule-header">
+    <nav class="submodule-breadcrumb"><a href="../../index.html">← Atlas</a> · <a href="index.html">← CodeGraph Integration</a></nav>
+    <h1>cg-validation <small class="submodule-kind">Service</small></h1>
+    <p class="submodule-role">Verify architecture proposals and batch-apply atlas mutations</p>
+    
+  </header>
+  <main class="submodule-main">
+    <section aria-label="Function I/O">
+      <h2>Function I/O</h2>
+      <table class="sub-table">
+        <thead><tr><th scope="col">Name</th><th scope="col">In</th><th scope="col">Out</th><th scope="col">Side</th><th scope="col">Purpose</th></tr></thead>
+        <tbody>
+          <tr><td>verify</td><td>specOverlayPath: string</td><td>VerifyReport (passed/failed items)</td><td>pure</td><td>Validate that spec overlay references match actual code</td></tr>
+          <tr><td>applyBatch</td><td>proposalYaml: string</td><td>ApplyResult</td><td>io</td><td>Execute multiple atlas mutations from a single YAML file</td></tr>
+          <tr><td>generateTemplate</td><td>specMdPath: string</td><td>proposalYaml path</td><td>io</td><td>Generate empty proposal skeleton from SPEC.md</td></tr>
+        </tbody>
+      </table>
+    </section>
+    <section aria-label="Variables">
+      <h2>Variables</h2>
+      <p class="sub-section__empty">No variables recorded.</p>
+    </section>
+    <section aria-label="Internal data flow">
+      <h2>Internal data flow</h2>
+      <p class="sub-dataflow__empty">No internal dataflow steps recorded.</p>
+    </section>
+    <section aria-label="Errors">
+      <h2>Errors</h2>
+      <p class="sub-section__empty">No errors recorded.</p>
+    </section>
+  </main>
+  <script src="../../assets/viewer.client.js" defer></script>
+</body>
+</html>

package/resources/project-architecture/features/codegraph/index.html

@@ -0,0 +1,58 @@
+<!DOCTYPE html>
+<html lang="en" data-atlas-page="feature">
+<head>
+  <meta charset="utf-8">
+  <title>CodeGraph Integration</title>
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <meta name="color-scheme" content="dark">
+  <link rel="preconnect" href="https://fonts.googleapis.com">
+  <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+  <link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Fraunces:ital,opsz,wght@0,9..144,300..600;1,9..144,300..500&family=Geist:wght@300..700&family=JetBrains+Mono:wght@400..600&display=swap">
+  <link rel="stylesheet" href="../../assets/architecture.css">
+</head>
+<body>
+  <header class="feature-header">
+    <nav class="feature-breadcrumb"><a href="../../index.html">← Atlas</a></nav>
+    <h1>CodeGraph Integration</h1>
+    <p class="feature-depends">Depends on: <a href="../eval-cli/index.html">eval-cli</a></p>
+  </header>
+  <main class="feature-main">
+    <section class="feature-story"><p>Provide LLM agents with deterministic code structure data through apltk CLI. Replaces manual grep/Read discovery with tree-sitter parsed knowledge graph queries.
+</p></section>
+    <section class="feature-submodules" aria-label="Submodules">
+      <h2>Submodules</h2>
+      <ul class="submodule-nav">
+      <li class="submodule-card">
+        <a class="submodule-card__link" href="cg-lifecycle.html">
+          <span class="submodule-card__name">cg-lifecycle</span>
+          <span class="submodule-card__kind">Service</span>
+        </a>
+        <p class="submodule-card__role">Manage CodeGraph index lifecycle — init, sync, status, search</p>
+      </li>
+      <li class="submodule-card">
+        <a class="submodule-card__link" href="cg-discovery.html">
+          <span class="submodule-card__name">cg-discovery</span>
+          <span class="submodule-card__kind">Service</span>
+        </a>
+        <p class="submodule-card__role">Explore and survey code structure — explore, survey, list-apis</p>
+      </li>
+      <li class="submodule-card">
+        <a class="submodule-card__link" href="cg-validation.html">
+          <span class="submodule-card__name">cg-validation</span>
+          <span class="submodule-card__kind">Service</span>
+        </a>
+        <p class="submodule-card__role">Verify architecture proposals and batch-apply atlas mutations</p>
+      </li>
+      </ul>
+    </section>
+    <section class="feature-edges" aria-label="Intra-feature edges">
+      <h2>Intra-feature edges</h2>
+      <ul class="feature-edges__list">
+        <li class="feature-edges__item feature-edges__item--data-row"><span class="feature-edges__endpoints">cg-lifecycle → cg-discovery</span><span class="feature-edges__kind">data-row</span><span class="feature-edges__label">survey/list-apis 依賴已索引的資料庫</span></li>
+        <li class="feature-edges__item feature-edges__item--data-row"><span class="feature-edges__endpoints">cg-discovery → cg-validation</span><span class="feature-edges__kind">data-row</span><span class="feature-edges__label">verify 使用 discovery 的搜尋能力</span></li>
+        <li class="feature-edges__item feature-edges__item--data-row"><span class="feature-edges__endpoints">cg-validation → cg-lifecycle</span><span class="feature-edges__kind">data-row</span><span class="feature-edges__label">apply 非索引操作，不需 lifecycle — 但 template 可搭配 list-apis</span></li>
+      </ul>
+    </section>
+  </main>
+</body>
+</html>

package/resources/project-architecture/features/eval-ci-gate/workflow-trigger.html

@@ -20,7 +20,12 @@
   <main class="submodule-main">
     <section aria-label="Function I/O">
       <h2>Function I/O</h2>
-      <p class="sub-section__empty">No functions recorded.</p>
+      <table class="sub-table">
+        <thead><tr><th scope="col">Name</th><th scope="col">In</th><th scope="col">Out</th><th scope="col">Side</th><th scope="col">Purpose</th></tr></thead>
+        <tbody>
+          <tr><td>detectSkillChanges</td><td>prFiles</td><td>string[]</td><td>pure</td><td>檢測 PR 中技能檔案變更</td></tr>
+        </tbody>
+      </table>
     </section>
     <section aria-label="Variables">
       <h2>Variables</h2>

package/resources/project-architecture/features/eval-cli/cli-handler.html

@@ -20,7 +20,14 @@
   <main class="submodule-main">
     <section aria-label="Function I/O">
       <h2>Function I/O</h2>
-      <p class="sub-section__empty">No functions recorded.</p>
+      <table class="sub-table">
+        <thead><tr><th scope="col">Name</th><th scope="col">In</th><th scope="col">Out</th><th scope="col">Side</th><th scope="col">Purpose</th></tr></thead>
+        <tbody>
+          <tr><td>evalHandler</td><td>argv, context</td><td>exitCode</td><td>pure</td><td>CLI 入口：解析參數、調度評測流程</td></tr>
+          <tr><td>parseArgs</td><td>argv</td><td>ParsedArgs</td><td>pure</td><td>解析 CLI 參數與模式選擇</td></tr>
+          <tr><td>tool</td><td>ToolDefinition</td><td>void</td><td>pure</td><td>向 tool-registry 註冊 eval 命令</td></tr>
+        </tbody>
+      </table>
     </section>
     <section aria-label="Variables">
       <h2>Variables</h2>

package/resources/project-architecture/features/eval-executor/exec-api-client.html

@@ -20,7 +20,12 @@
   <main class="submodule-main">
     <section aria-label="Function I/O">
       <h2>Function I/O</h2>
-      <p class="sub-section__empty">No functions recorded.</p>
+      <table class="sub-table">
+        <thead><tr><th scope="col">Name</th><th scope="col">In</th><th scope="col">Out</th><th scope="col">Side</th><th scope="col">Purpose</th></tr></thead>
+        <tbody>
+          <tr><td>withRetry</td><td>fn, options</td><td>Result</td><td>io</td><td>HTTP client with retry for exec model</td></tr>
+        </tbody>
+      </table>
     </section>
     <section aria-label="Variables">
       <h2>Variables</h2>