@cyning/harness 0.3.0

package/docs/methodology/reviews/REVIEW_B9_agent_shell_parallel_v1_zh.md

@@ -0,0 +1,158 @@
+# 审核稿 · B9 方案：Agent-shell 并行实验（ExecutionShell 层）
+
+| 项 | 内容 |
+| --- | --- |
+| **状态** | `review_done` · **APPROVE_WITH_CHANGES** |
+| **版本** | v1.1 |
+| **日期** | 2026-06-15 |
+| **提交方** | 维护者 / 路线 Epic #9 |
+| **审核方** | 外部 Agent（只读 · 输出可行性结论） |
+| **关联 task** | [`task_cyning_harness_b9_agent_shell_v1.md`](../../../../docs/harness/tasks/active/task_cyning_harness_b9_agent_shell_v1.md) |
+| **Invoke Prompt** | [`../prompts/PROMPT_feasibility_review_b_evidence_v1_zh.md`](../prompts/PROMPT_feasibility_review_b_evidence_v1_zh.md) |
+
+---
+
+## 0. 请审核 Agent 回答什么
+
+**一句话**：在 **不替代 repo 嵌入（kimi-code-meta）** 的前提下，把 SDD 纪律放到 **Kimi Code Agent 层** 是否 **可行、有价值、且不破坏产品边界**？
+
+**须给出**：`APPROVE` / `APPROVE_WITH_CHANGES` / `REJECT` + 理由 · 不超过 1200 字。
+
+---
+
+## 1. 问题陈述
+
+| 观察 | 含义 |
+| --- | --- |
+| kimi-code-meta | **项目规则**：docs/harness、task、reviews · 深绑定 Inform/Verify |
+| 用户提议 | **Agent 规则**：改 Kimi Code 默认 policy · 非项目目录 |
+| 并行策略 | **#8 主链先跑** · #9 **核实期完成** · 不挡 Q3 push |
+
+---
+
+## 2. 方案摘要
+
+```text
+部署形态对比
+├── Repo-embedded（现有）   .cyning-harness + docs/harness + task
+├── Agent-shell（本方案）  ~/.kimi-code/ 或 fork 内 agent policy
+└── Hybrid（目标态）       shell 默认行为 + 打开仓读 repo 真值（repo 优先）
+```
+
+**实验范围（v1.1 · 审核后）**：
+
+- Kimi **个人 fork** 分支注入 Orchestrate 摘要（gate-stop、帽链顺序）
+- **3 scenario × 2 部署**（#8 **冻结后**同源 · repo-embedded vs shell-only）
+- Hybrid：**可选** 加分轮 · 非必做
+- **Week-1** 验证 H1（硬 gate vs 软提示）
+- **≤4h/周** · 核实期 v0.3–v0.4
+- 产出：1 页 findings · H1 失败则 **不做** v0.4 示例目录
+
+---
+
+## 3. 设计约束（审核时不得突破）
+
+| ID | 约束 |
+| --- | --- |
+| C1 | **不** PR agent 规则进 Moonshot upstream |
+| C2 | **不** 声称替代 repo 嵌入或 npx install |
+| C3 | P1：不做 Runtime · 不改 Tool Host |
+| C4 | 与 #8 指标 **同口径** · 部署面标注清楚 |
+| C5 | Epic CLOSE **不强制** 依赖 #9 |
+
+---
+
+## 4. 假设清单（请审核真伪）
+
+| # | 假设 | 若 false 的影响 |
+| --- | --- | --- |
+| H1 | Shell 层可 enforce **30 首行 gate-stop** | 方案退化为「软提示」 |
+| H2 | 无 repo 时 Inform/Verify **显著弱化** | 只能宣传 Orchestrate 演示 |
+| H3 | Hybrid「repo 优先」可在 Kimi 实现 | 否则双真值冲突 |
+| H4 | 对 Kimi 求职叙事 **加分** | 若 REJECT 可只做内部笔记 |
+| H5 | 3 scenario × **2** 部署 **一人可完成** | Hybrid 为加分轮 · 非 3×3 |
+
+---
+
+## 5. 与 kimi-code-meta / 产品本体关系
+
+| 维度 | kimi-code-meta | Agent-shell |
+| --- | --- | --- |
+| 真值位置 | BusinessRepository | ExecutionShell |
+| ICVO 覆盖 | 较完整 | Orchestrate 为主 |
+| D6 上游 PR | 过程轨隔离 | agent 实验 **更不宜** upstream |
+| 产品 preset | `kimi-code-meta` | 拟 `kimi-code-agent-shell`（proposal） |
+
+**本体引用**：`Task --executedIn--> ExecutionShell` · IDETrack 桥接 · 非第二 DisciplinePackage。
+
+---
+
+## 6. 风险与反模式
+
+| 风险 | 缓解 |
+| --- | --- |
+| 双真值（shell vs repo prompts 冲突） | Hybrid 规则：repo marker 存在则 **disable shell 覆盖** |
+| 被误解为 Kimi fork 竞品 | 文档写明 **个人实验分支** |
+| 分散 A1 人力 | **核实期**做 · weekly timebox |
+| Bench 误用 | 与 #8 共用 scenario · 只比 **合规率差异** |
+
+---
+
+## 7. 成功标准（方向通过）
+
+审核 **APPROVE** 当且仅当（可带修改项）：
+
+- [ ] Agent-shell **值得** v0.4 后保留为 **第二 DistributionChannel** 选项
+- [ ] **不**削弱「纪律包 = repo 嵌入」主叙事
+- [ ] 实验设计 **3 个月内一人可完成**
+- [ ] 与 Kimi Code SDK/配置 **技术路径清晰**（即使仅 fork 级）
+
+---
+
+## 8. 审核 Agent 输出模板
+
+```markdown
+## 结论
+APPROVE | APPROVE_WITH_CHANGES | REJECT
+
+## 可行性（1–5）
+## H1–H5 逐条判定
+## 与 #8 主链关系（应并行还是串行）
+## 必改项
+## 若 REJECT：建议替代方案（一句）
+```
+
+---
+
+## 10. 审核记录（2026-06-15）
+
+| 项 | 内容 |
+| --- | --- |
+| **结论** | **APPROVE_WITH_CHANGES** |
+| **可行性** | 3/5 |
+| **HG-B9-DIRECTION** | `approved_with_changes` |
+
+**H1–H5 判定摘要**：
+
+| 假设 | 判定 |
+| --- | --- |
+| H1 gate-stop | 部分真 · Week-1 验证 |
+| H2 无 repo 弱化 | **真** |
+| H3 Hybrid | 设计可行 · 待证 |
+| H4 求职加分 | 边际 |
+| H5 工作量 | **3×2** 可完成 |
+
+**必改项（已回写 task #9）**：3×2 矩阵 · ≤4h/周 · Week-1 H1 · 不进 upstream · findings 写「壳层不足回 repo」  
+
+**与 #8**：#8 scenario **冻结后**再开 #9 · Epic 不强制 #9 · **并行、弱依赖**  
+
+**叙事**：主路径 repo+npx · shell = 第二 DistributionChannel · **禁止**单独宣传「不必 embed」
+
+---
+
+## 9. 修订记录
+
+| 版本 | 日期 | 说明 |
+| --- | --- | --- |
+| v1.0 | 2026-06-15 | 提交外部审核 |
+| v1.1 | 2026-06-15 | 审核结论 · 3×2 · timebox · §10 记录 |

package/examples/demo_checkout/ACCEPTANCE.md

@@ -0,0 +1,80 @@
+# P0 金样 · 验收步骤（10→22→30）
+
+> 配合 [`task_demo_p0_golden_v1.md`](./task_demo_p0_golden_v1.md) · 在 **空 git 仓** 或 `examples/demo_checkout/_sandbox/` 执行。
+
+**最近一次跑通**：`_sandbox/` · 2026-06-15 · commit `8cd64ed`（签闸前）+ 30 交付 commit
+
+---
+
+## 前置
+
+- [x] 已 `install.sh --preset harness-only` · 2026-06-15
+- [x] 已 `harness-sync.sh apply` · 2026-06-15
+- [x] 金样 task 在 `docs/tasks/active/task_demo_p0_golden_v1.md`
+- [x] IDE Open **业务仓根**（`_sandbox`）
+
+---
+
+## 阶段 A · 10 需求帽
+
+- [x] `@` 金样 task + `docs/harness/prompts/10-requirements.md`
+- [x] task「背景与目标」「范围」已填（金样预填可微调）
+- [x] `HG-TASK-DRAFT` → `approved`（维护者 · 2026-06-15）
+- [x] commit task 变更
+
+---
+
+## 阶段 B · 22 审核帽（R1）
+
+- [x] `@` task + `docs/harness/prompts/22-task-audit.md`
+- [x] 产出 `docs/harness/reviews/task_demo_p0_golden_audit_R1_20260615.md`
+- [x] 22 **未** 附 30 Prompt（签前 · D2）
+- [x] `HG-AUDIT-R1` → `approved`（维护者 · 2026-06-15）
+- [x] commit review + task 表
+
+---
+
+## 阶段 C · gate-check
+
+```bash
+CYNING_HARNESS=/path/to/cyning-harness \
+  "$CYNING_HARNESS/wizard/gate-check.sh" --target . \
+  --task docs/tasks/active/task_demo_p0_golden_v1.md
+```
+
+- [x] **签前** exit 码 ≠ 0（exit 2 · HG pending）
+- [x] **签后** exit 码 0 · 输出「✅ 可 30」· 2026-06-15
+
+---
+
+## 阶段 D · 30 执行帽
+
+- [x] `@` task + `docs/harness/prompts/30-execute-code.md`
+- [x] gate-check 签后验证（D3 机械辅助）
+- [x] 创建 `src/p0-demo/hello.txt` 内容为 `harness-p0-ok`
+- [x] task「实现备忘」回填 · status → `in_progress`
+
+---
+
+## 阶段 E · 22 CLOSE（可选 · P0 完整闭环）
+
+- [ ] 22 终轮 · 产出 `*_audit_CLOSE_*.md` 或 R2
+- [ ] task status → `done`
+- [ ] `git mv` → `docs/tasks/done/`（按域 · 见 ONBOARDING §6）
+
+---
+
+## P0 通过标准（最小）
+
+满足 **A + B + C（签后）+ D** 即 P0 通过。  
+**2026-06-15**：`_sandbox` **最小通过 ✅**  
+**E** 为完整 SDD 闭环，可与 A2（40 帽）一并补全。
+
+---
+
+## 失败演练（可选 · v0.3+）
+
+| 场景 | 期望 |
+| --- | --- |
+| 未签 `HG-AUDIT-R1` 即 30 | 30 拒开工 · 输出 gate_stop 模板 |
+| `HG-AUDIT-R1` → rejected | task.status → draft · 退回 10 |

package/examples/demo_checkout/README.md

@@ -0,0 +1,41 @@
+# demo_checkout · P0 金样路径
+
+> **目标**：在空业务仓复现 **harness-only · 10→22→30** 最小 SDD 闭环（见 [`../../docs/methodology/execution/P0_V0.2_GAP.md`](../../docs/methodology/execution/P0_V0.2_GAP.md)）。
+
+---
+
+## 文件
+
+| 文件 | 用途 |
+| --- | --- |
+| [`task_demo_p0_golden_v1.md`](./task_demo_p0_golden_v1.md) | 金样 task · 复制到 `docs/tasks/active/` |
+| [`ACCEPTANCE.md`](./ACCEPTANCE.md) | 分阶段验收勾选 |
+| `reviews/` | （自行创建）22 产出落盘目录 |
+
+---
+
+## 快速跑通
+
+```bash
+export CYNING_HARNESS=/path/to/cyning-harness
+mkdir -p /tmp/harness-p0-demo && cd /tmp/harness-p0-demo && git init -q
+
+"$CYNING_HARNESS/wizard/install.sh" --target . --preset harness-only --ide cursor,agents
+cp "$CYNING_HARNESS/examples/demo_checkout/task_demo_p0_golden_v1.md" docs/tasks/active/
+"$CYNING_HARNESS/wizard/harness-sync.sh" apply --target .
+
+# 打开 IDE → 按 ACCEPTANCE.md 执行 10 → 22 → gate-check → 30
+```
+
+---
+
+## 与 A3 的关系
+
+- **P0**：本目录 + 本地 `/tmp` 演示  
+- **A3/v0.4**：脱敏后作为 public repo 对外 `examples/demo_checkout/` 正式金样  
+
+---
+
+## Kimi Code fork
+
+维护 Kimi Code 个人 fork 过程轨时，用 **`oss-fork-meta`** 或将来 **`kimi-code-meta`** preset（见本体 §3.3.1）· 本金样 **不** 绑定 Kimi 产品代码。

package/examples/demo_checkout/task_demo_p0_golden_v1.md

@@ -0,0 +1,101 @@
+# Task：P0 金样 · 验证 Harness 10→22→30 最小闭环
+
+> **状态**：`draft`  
+> **用途**：`examples/demo_checkout/` 演示仓 · **非** 业务功能  
+> **关联图谱**：无（docs-only 金样）  
+> **落盘**：复制到 `docs/tasks/active/` 后按 [`ACCEPTANCE.md`](./ACCEPTANCE.md) 执行
+
+---
+
+## Harness 元信息
+
+| 字段 | 值 |
+|------|-----|
+| **task_slug** | `demo_p0_golden` |
+| **test_strategy** | `not_applicable` |
+| **test_strategy_note** | 金样仅验证 SDD 链与 gate-check · 无产品代码测试 |
+| **code_quality_bar** | `not_applicable` |
+| **audit_profile** | `full` |
+| **git_branch** | `task/demo-p0-golden` |
+| **semi_auto** | `false` |
+
+### 人工闸
+
+| human_gate_id | status | blocks_hats | 说明 |
+|---------------|--------|-------------|------|
+| HG-TASK-DRAFT | pending | 22, 30 | 10 完成后维护者签 |
+| HG-AUDIT-R1 | pending | 30 | 22 R1 落盘后人签 · **P0 关键闸** |
+
+> **演示提示**：阶段 B 完成后将 `HG-AUDIT-R1` 改为 `approved` 再跑 gate-check。
+
+---
+
+## 背景与目标
+
+在空业务仓中证明 **cyning-harness harness-only** preset 可支撑：
+
+1. `install` + `harness-sync apply` 纪律层就绪  
+2. 10 → 22(R1) →（人签）→ 30 帽链可执行  
+3. `gate-check.sh` 机械拦截未签 30  
+
+完成态：业务仓存在 `src/p0-demo/hello.txt`，内容为 `harness-p0-ok`。
+
+---
+
+## 范围
+
+- [ ] 按 ACCEPTANCE 走通 10 / 22 / gate-check / 30  
+- [ ] 产出至少一份 `docs/harness/reviews/*_audit_R1_*.md`  
+- [ ] 创建 `src/p0-demo/hello.txt`
+
+## 非范围
+
+- 图谱 / wiki 五轨全量  
+- npx CLI · manifest（v0.3）  
+- 40-self-check 帽（A2）  
+- 上游 OSS PR  
+
+---
+
+## 失败路径
+
+| 触发条件 | 系统行为 | 可重试 | 用户可见 |
+|----------|----------|--------|----------|
+| `HG-AUDIT-R1` = pending 时 30 | Agent **拒开工** · gate-check exit 2 | 是 | `TEMPLATE_30_gate_stop` |
+| `HG-AUDIT-R1` = rejected | 强制退回 10 · status → draft | 是 | 须记录否决理由 |
+| sync 覆盖 task/reviews | **禁止**（S2） | — | plan 可见 diff |
+
+---
+
+## 验收标准
+
+- [ ] `gate-check.sh` 签前拒 30、签后放行  
+- [ ] `docs/harness/reviews/` 有 R1 审核落盘  
+- [ ] `src/p0-demo/hello.txt` 内容为 `harness-p0-ok`  
+- [ ] task 表 `HG-TASK-DRAFT` 与 `HG-AUDIT-R1` 均为 `approved`（30 后）
+
+---
+
+## 给执行帽的必读列表
+
+1. 本 task  
+2. `docs/harness/prompts/10-requirements.md` · `22-task-audit.md` · `30-execute-code.md`  
+3. [`examples/demo_checkout/ACCEPTANCE.md`](./ACCEPTANCE.md)  
+4. [`docs/methodology/product/DESIGN_ONTOLOGY_v1_zh.md`](../../docs/methodology/product/DESIGN_ONTOLOGY_v1_zh.md) §4（状态机 · 可选）
+
+---
+
+## 实现备忘（30 回填）
+
+| 项 | 状态 | 备注 |
+|----|------|------|
+| `src/p0-demo/hello.txt` | ⏳ | 30 创建 |
+| reviews R1 | ⏳ | 22 落盘 |
+
+---
+
+## 修订记录
+
+| 日期 | 说明 |
+|------|------|
+| 2026-06-15 | P0 金样初版 |

package/examples/oss-fork/README.md

@@ -0,0 +1,139 @@
+# examples/oss-fork（非产品默认 · 参考样例）
+
+> **不在** `bootstrap-oss-fork-meta.sh` 默认路径中。各 OSS 项目的图谱活真值应在 **该 fork 的 `cyning/meta` 分支** 或工作区试点文档中维护。
+
+---
+
+## 1. 双分支 + worktree（推荐 · v0.1.2）
+
+OSS 个人 fork 贡献上游时，**过程轨与产品 PR 分离**：
+
+```text
+upstream/main  ──►  本地 main（跟踪官方，保持干净）
+                      │
+                      └── feature/fix-*  ──► PR → 上游（仅产品 diff）
+
+cyning/meta    ──►  过程轨（task · invoke · _tech_graph · harness）
+                      └── 只 push 到你的 fork，不 PR 上游
+```
+
+**改码 Open Folder** 在 `feature/*`；**task / 图谱 / invoke** 在 `cyning/meta`。  
+不要在 `feature` 上 commit harness 文件；不要 `merge cyning/meta` → `main`。
+
+### worktree 示例
+
+```bash
+cd /path/to/your-fork
+git worktree add ../your-fork-meta cyning/meta
+```
+
+| 路径 | 分支 | 用途 |
+|------|------|------|
+| `your-fork/` | `feature/fix-*` 或 `main` | 改产品、开上游 PR |
+| `your-fork-meta/` | `cyning/meta` | task、签闸、invoke；Cursor `@` harness prompts |
+
+30 会话示例（Open 在产品仓）：
+
+```text
+@../your-fork-meta/docs/tasks/active/task_*.md
+@../your-fork-meta/docs/harness/prompts/30-execute-code.md
+@../your-fork-meta/docs/_tech_graph/01_struct.md   # 按需
+```
+
+---
+
+## 2. bootstrap 初始化
+
+```bash
+CYNING_HARNESS=/path/to/cyning-harness
+cd /path/to/your-fork
+git checkout -B cyning/meta   # 或已有 meta
+
+"$CYNING_HARNESS/wizard/bootstrap-oss-fork-meta.sh"
+
+# 可选：复用某次试点已填图谱快照
+"$CYNING_HARNESS/wizard/bootstrap-oss-fork-meta.sh" \
+  --stub-dir "$CYNING_HARNESS/examples/oss-fork/kimi-code"
+```
+
+生成：`docs/tasks/active/` + **`docs/tasks/done/`**、`docs/harness/`、`docs/_tech_graph/` 骨架。
+
+---
+
+## 3. 上游 Issue 选题（通用脚本）
+
+不依赖 Agent；在 **产品包** 目录执行：
+
+```bash
+"$CYNING_HARNESS/wizard/scan-upstream-issues.sh" --help
+
+# 示例 preset（MoonshotAI/kimi-code）
+"$CYNING_HARNESS/wizard/scan-upstream-issues.sh" --preset kimi-c2-candidate
+
+# 任意上游仓
+"$CYNING_HARNESS/wizard/scan-upstream-issues.sh" \
+  --repo OWNER/REPO --state open --label bug --check-pr --limit 20
+```
+
+预设定义：`wizard/profiles/issue-scan-presets.json`（`kimi-c2-candidate` · **`kimi-c3-candidate`** 等；可自行追加 preset）。
+
+---
+
+## 4. 目录
+
+| 子目录 | 说明 |
+|--------|------|
+| [`kimi-code/`](./kimi-code/) | Moonshot kimi-code 试点图谱 **快照**（2026-06-10）；非通用模板 |
+
+新项目默认：**不加 `--stub-dir`** → 仅 harness 通用 `graph/templates/` + 人工填 `01_struct`。
+
+活真值优先：fork 上 `cyning/meta` 的 `docs/_tech_graph/`（worktree `your-fork-meta`）。
+
+---
+
+## 5. 试点文档（工作区）
+
+工作区维护者扫描分级示例：  
+`Projects/docs/harness/guides/ISSUE_SCAN_kimi_code_open_c2_v1_zh.md` ·  
+`PILOT_kimi_code_fork_adoption_v1_zh.md`
+
+---
+
+## 6. 阶段 C3 工作流（v0.1.3 · 改码前纪律）
+
+选题 → task → 思考轮 → 图谱闸 → 30 改码 → 关账。与 PILOT §5.2 对齐。
+
+### 6.1 开 task
+
+```bash
+cp docs/tasks/TASK_TEMPLATE_upstream_pr_v1.md \
+  docs/tasks/active/task_fix_<issue>_<short>_v1.md
+```
+
+填 Harness 元信息 · `graph_delta` · `human_gate` 表。
+
+### 6.2 思考轮 + 强制回填（默认 R0 + R1–R5）
+
+invoke 内嵌 `docs/harness/FRAGMENT_rethink_backfill_task_v1_zh.md`：
+
+- 10 帽 task 草稿 **预置五槽思考轮** + **思考轮控制** 表（C1–C3 实证：≥4 轮实质思考后方案才稳）
+- Agent **必须**将结论写入 task **§4 回填区**；**可提前停**（填 reason + residual_risks）或 **增 R6+**
+- 未闭合 §4 → **22 退回 10** · `HG-AUDIT-R1` 不得签 · 30 拒开工
+
+### 6.3 图谱闸（触模块时）
+
+| 时点 | 动作 |
+|------|------|
+| **30 前** | `10_flow_*.md` skeleton commit（`graph_gate: skeleton_before_30`） |
+| **关账** | partial/final flow + `02_version` 增量 |
+
+`graph_delta=none` 须在 task 注明理由。
+
+### 6.4 PR 策略（可选 · 试点 C3 #580）
+
+| 模式 | 何时 |
+|------|------|
+| 常规 | 验证通过 → 开 upstream PR · `Fixes #issue` |
+| **暂缓 PR** | 等 maintainer / 撞车窗口 → 先 issue comment + 本地 `local_done`；到期再开 PR |
+
+过程轨（task / invoke / 图谱）**永不**进 upstream PR diff。

package/examples/oss-fork/kimi-code/00_main.ai.md

@@ -0,0 +1,23 @@
+```mermaid
+flowchart TD
+  %% version: 2026-06-10 · kimi-code monorepo · 须与 00_main.md 语义等价
+
+  U[[用户终端]] --"->"--> CLI[[kimi CLI / TUI]]
+  // → apps/kimi-code/src/main.ts
+
+  CLI --"->"--> SDK[[node-sdk]]
+  // → packages/node-sdk
+
+  SDK --"->"--> AC[[agent-core]]
+  // → packages/agent-core
+
+  AC --"->"--> KS[[kosong]]
+  AC --"->"--> KA[[kaos]]
+  AC --"::triggers"--> TOOLS[[skills / MCP / subagents]]
+
+  CLI --"::triggers"--> FLOW_CLI[[CLI 会话主循环]]
+  FLOW_CLI --"加载"--> FLOW_DOC[>10_flow_cli_session.md]
+
+  AC --"->"--> TELEM[[telemetry]]
+  AC --"->"--> AUTH[[oauth]]
+```

package/examples/oss-fork/kimi-code/00_main.md

@@ -0,0 +1,38 @@
+# 顶层流程总图（kimi-code · 人类友好版）
+
+> **版本**：2026-06-10 · 阶段 B bootstrap  
+> **双轨**：[`00_main.ai.md`](./00_main.ai.md) · 协议 [`99_mermaid_protocol.md`](./99_mermaid_protocol.md)
+
+## 主干（Happy Path · CLI Agent）
+
+```mermaid
+flowchart TD
+    U[用户终端] --> CLI[kimi CLI / TUI<br/>apps/kimi-code]
+    CLI --> SDK[@moonshot-ai/kimi-code-sdk<br/>packages/node-sdk]
+    SDK --> AC[agent-core<br/>Agent / Session / tools]
+    AC --> KS[kosong · LLM 调用]
+    AC --> KA[kaos · shell / 文件]
+    AC --> TOOLS[skills · MCP · subagents]
+
+    CLI --> FLOW_CLI[CLI 会话主循环]
+    FLOW_CLI --> FLOW_DOC[> 10_flow_cli_session.md]
+
+    AC --> TELEM[telemetry]
+    AC --> AUTH[oauth]
+```
+
+## 待补 flow 清单（分步增量 · 非 bootstrap 一次画完）
+
+| flow 文件 | 状态 | 建议阶段 | 说明 |
+|-----------|------|----------|------|
+| `10_flow_cli_session.md` | **骨架** | B-可选 / C | CLI 启动 → 会话 → 工具循环（见该文件占位） |
+| `10_flow_agent_turn.md` | 待补 | **阶段 C** | 单轮推理：prompt → tools → 响应 |
+| `10_flow_mcp_tool.md` | 待补 | C | MCP 配置与调用链 |
+| `10_flow_subagent.md` | 待补 | C | coder / explore / plan 子 agent |
+
+**分步规则**：改 `agent_core` 开 `10_flow_agent_turn`；改 MCP 开 `10_flow_mcp_tool`；每张 flow 随 **业务 task** 或 **图谱子 task** 增量维护。
+
+## 关联
+
+- 模块表：[`01_struct.md`](./01_struct.md)
+- 上游代码地图：[`AGENTS.md`](../../AGENTS.md)

package/examples/oss-fork/kimi-code/01_struct.md

@@ -0,0 +1,39 @@
+# 模块边界登记表（kimi-code monorepo · L0-b）
+
+> **试点**：个人 fork · `cyning/meta` · 不 PR 上游。  
+> **人签**：`HG-GRAPH-MODULES` approved 后，业务 task 方可 **30** 改码。  
+> **真值来源**：[`AGENTS.md`](../../AGENTS.md) Project Map（2026-06-10 起草）。
+
+## 模块表
+
+| module_id | 名称 | 路径 glob | 依赖方向（出边） | 备注 |
+|-----------|------|-----------|------------------|------|
+| `cli` | CLI / TUI 应用 | `apps/kimi-code/**` | → `node_sdk` | **禁止**直接依赖 `agent_core` |
+| `vis` | Session 可视化 | `apps/vis/**` | → `node_sdk`, `agent_core` | vis/server · vis/web |
+| `node_sdk` | 公开 TS SDK | `packages/node-sdk/**` | → `agent_core` | 对外 harness 入口 |
+| `agent_core` | Agent 引擎 | `packages/agent-core/**` | → `kosong`, `kaos`, `oauth`, `telemetry` | Session · tools · skills |
+| `kosong` | LLM / Provider 抽象 | `packages/kosong/**` | — | 被 `agent_core` 依赖 |
+| `kaos` | 执行环境 | `packages/kaos/**` | — | 文件 / 进程抽象 |
+| `oauth` | OAuth / 鉴权 | `packages/oauth/**` | — | |
+| `telemetry` | 客户端遥测 | `packages/telemetry/**` | — | |
+| `acp_adapter` | ACP 适配 | `packages/acp-adapter/**` | → `node_sdk` | IDE 集成 |
+| `migration_legacy` | 旧版迁移 | `packages/migration-legacy/**` | → `agent_core` | kimi-cli 迁移 |
+| `monorepo_root` | 构建 / CI / Nix | `build/**`, `scripts/**`, `flake.nix` | — | 与 `pnpm-workspace.yaml` 同步维护 |
+
+## 跨模块契约（摘要）
+
+| 契约 | 提供方 | 消费方 | 说明 |
+|------|--------|--------|------|
+| `@moonshot-ai/kimi-code-sdk` | `node_sdk` | `cli`, `acp_adapter` | CLI 须经 SDK 访问引擎 |
+| `Agent` / `Session` API | `agent_core` | `node_sdk` | 公开面由 SDK 封装 |
+
+## 人签记录
+
+| human_gate_id | status | 签核人 | 日期 | 说明 |
+|---------------|--------|--------|------|------|
+| HG-GRAPH-MODULES | pending | | | 维护者核对上表后改 approved |
+
+## 关联
+
+- [`00_main.md`](./00_main.md) · [`00_main.ai.md`](./00_main.ai.md)
+- 待补 flow：见 `00_main` §待补 flow 清单

package/examples/oss-fork/kimi-code/02_version.md

@@ -0,0 +1,6 @@
+# 图谱版本时间线
+
+| 日期 | 事件 |
+|------|------|
+| 2026-06-10 | 阶段 B bootstrap：`01_struct` + `00_main` + `10_flow_cli_session` 骨架 |
+| 2026-06-10 | 移除无用 `10_flow_MAIN*`（harness HTTP 模板） |

package/examples/oss-fork/kimi-code/10_flow_cli_session.md

@@ -0,0 +1,22 @@
+# Flow：CLI 会话主循环（骨架 · 待增量）
+
+> **状态**：`skeleton` — 阶段 B 占位；细节在 **阶段 C** 或首张触达 `apps/kimi-code` 的 task 中补全。  
+> **双轨**：待补 `10_flow_cli_session.ai.md`（与本文语义对齐后再建）。
+
+```mermaid
+flowchart TD
+    START[进程启动 main] --> PARSE[解析 argv / 配置]
+    PARSE --> TUI[TUI 或 ACP 模式]
+    TUI --> LOOP{用户输入 / 事件}
+    LOOP --> SDK_CALL[经 node-sdk 创建/恢复 Session]
+    SDK_CALL --> AGENT[agent-core 处理轮次]
+    AGENT --> TOOLS[工具 / 子 agent]
+    TOOLS --> LOOP
+    LOOP --> EXIT[退出 / 保存 checkpoint]
+```
+
+## 待补锚点（阶段 C）
+
+- [ ] `apps/kimi-code/src/main.ts` 入口
+- [ ] Session 创建与 resume 路径
+- [ ] 与 `packages/agent-core` 边界调用点

package/examples/oss-fork/kimi-code/README.md

@@ -0,0 +1,15 @@
+# kimi-code 图谱快照（参考 · 非默认）
+
+| 项 | 内容 |
+|----|------|
+| **性质** | 2026-06-10 试点填写快照；**非** cyning-harness 通用能力 |
+| **活真值** | fork `cyning/meta` 上 `docs/_tech_graph/` |
+| **工作区** | `Projects/docs/harness/guides/PILOT_kimi_code_fork_adoption_v1_zh.md` |
+
+仅在新 clone 想 **跳过重复填写** 时使用：
+
+```bash
+--stub-dir "$CYNING_HARNESS/examples/oss-fork/kimi-code"
+```
+
+上游 `AGENTS.md` 变更后须 **人工 diff** 后再用。