@haaaiawd/anws 1.2.5 → 2.0.0

package/templates/.agents/skills/nexus-mapper/references/output-schema.md

@@ -0,0 +1,298 @@
+# 输出 Schema 规范
+
+> **EMIT 阶段硬门控**：本文件由 `probe-protocol.md` 的 EMIT 阶段门控强制触发读取，
+> 写入任何 `.nexus-map/` 文件前必须完成本文阅读。
+> 本文 Schema 均基于实际运行输出校正，与脚本当前版本保持一致。
+
+---
+
+## raw/ast_nodes.json（extract_ast.py 产出）
+
+### 顶层结构
+```json
+{
+  "languages": ["cpp", "python"],
+  "stats": {
+    "total_files": 101,
+    "total_lines": 23184,
+    "parse_errors": 0,
+    "truncated": true,
+    "truncated_nodes": 298,
+    "supported_file_counts": {"python": 101},
+    "languages_with_structural_queries": ["python", "javascript", "typescript"],
+    "languages_with_custom_queries": ["gdscript"],
+    "module_only_file_counts": {"vue": 12},
+    "known_unsupported_file_counts": {"customdsl": 24},
+    "configured_but_unavailable_file_counts": {"templ": 6},
+    "custom_language_config_paths": ["/custom/path/to/language-config.json"]
+  },
+  "warnings": [
+    "custom language configuration loaded: /custom/path/to/language-config.json",
+    "some languages were parsed with module-only coverage because no structural query template is bundled: vue (12 files)",
+    "known unsupported languages present; downstream outputs must mark inferred sections explicitly: customdsl (24 files)",
+    "some configured languages were detected in source files but no parser could be loaded: templ (6 files)"
+  ],
+  "nodes": [...],
+  "edges": [...]
+}
+```
+
+### Module 节点
+```json
+{
+  "id": "src.nexus.application.weaving.treesitter_parser",
+  "type": "Module",
+  "label": "treesitter_parser",
+  "path": "src/nexus/application/weaving/treesitter_parser.py",
+  "lines": 320,
+  "lang": "python"
+}
+```
+
+### Class 节点
+```json
+{
+  "id": "src.nexus.application.weaving.treesitter_parser.TreeSitterParser",
+  "type": "Class",
+  "label": "TreeSitterParser",
+  "path": "src/nexus/application/weaving/treesitter_parser.py",
+  "parent": "src.nexus.application.weaving.treesitter_parser",
+  "start_line": 15,
+  "end_line": 287
+}
+```
+
+### Edge
+```json
+{
+  "source": "src.nexus.infrastructure",
+  "target": "src.nexus.infrastructure.db_client",
+  "type": "contains"
+}
+```
+
+**Edge 类型**：`contains`（模块→类，类→方法）/ `imports`（import 语句解析）
+
+### warnings 字段
+
+`warnings` 是可选数组，用来暴露不会导致 PROFILE 失败、但会影响下游可信度的降级信息，例如：
+- grammar 可加载，但当前仅有 Module 级覆盖
+- 已知但未支持的语言存在
+- AST 被截断
+- 部分解析器不可用
+
+### 覆盖分层字段
+
+| 字段                                     | 含义                                                              |
+| ---------------------------------------- | ----------------------------------------------------------------- |
+| `supported_file_counts`                  | 成功进入 AST 流程的文件数（含完整结构覆盖和 module-only 覆盖）    |
+| `languages_with_structural_queries`      | 当前 bundled query 模板覆盖到的语言                               |
+| `languages_with_custom_queries`          | 通过 `--add-query` 或 `--language-config` 新增或覆盖 query 的语言 |
+| `module_only_file_counts`                | grammar 可加载，但当前没有结构 query，只产出 Module 节点的语言    |
+| `known_unsupported_file_counts`          | 已知存在但完全未进入 AST 流程的语言                               |
+| `configured_but_unavailable_file_counts` | agent 明确要求支持该语言，但当前环境没有可用 parser               |
+| `custom_language_config_paths`           | 本次实际加载的显式语言配置文件路径；纯 CLI 模式下为空             |
+
+---
+
+## raw/git_stats.json（git_detective.py 产出）
+
+```json
+{
+  "analysis_period_days": 90,
+  "stats": {
+    "total_commits": 42,
+    "total_authors": 1
+  },
+  "hotspots": [
+    {"path": "src/nexus/tasks/analysis_tasks.py", "changes": 21, "risk": "high"}
+  ],
+  "coupling_pairs": [
+    {"file_a": "...", "file_b": "...", "co_changes": 5, "coupling_score": 0.71}
+  ]
+}
+```
+
+**risk 阈值**：`changes < 5` → `low` / `5–15` → `medium` / `> 15` → `high`
+
+---
+
+## 生成的 Markdown 文件头部
+
+`INDEX.md`、`arch/*.md`、`concepts/domains.md`、`hotspots/git_forensics.md` 的头部至少包含：
+
+```markdown
+> generated_by: nexus-mapper v2
+> verified_at: 2026-03-07
+> provenance: AST-backed except where explicitly marked inferred
+```
+
+如存在语言降级或人工推断，`provenance` 必须扩展说明：
+
+```markdown
+> provenance: AST-backed for Python; some custom DSL files were detected but not parsed by bundled AST tooling, so the affected dependency notes below are inferred from file tree and manual inspection.
+```
+
+---
+
+## concepts/concept_model.json — Schema V1
+
+Schema V1 的人类可读名称字段只有 `label`，不要额外引入 `title`；若出现 `title`，视为非规范字段，应删除。
+
+```json
+{
+  "$schema": "nexus-mapper/concept-model/v1",
+  "generated_at": "2026-03-05T15:00:00Z",
+  "repo_path": "/absolute/path/to/repo",
+  "generator": "nexus-mapper v2",
+  "nodes": [
+    {
+      "id": "nexus.ast-extractor",
+      "type": "System",
+      "label": "AST Extractor",
+      "responsibility": "使用 Tree-sitter 解析 Python 仓库，提取模块/类/函数节点及 import 关系，输出机器可读 JSON",
+      "implementation_status": "implemented",
+      "code_path": "src/nexus/application/weaving/",
+      "evidence_path": null,
+      "evidence_gap": null,
+      "tech_stack": ["tree-sitter", "python"],
+      "related_reqs": ["REQ-101"],
+      "complexity": "medium",
+      "hotspot": true
+    }
+  ],
+  "edges": [
+    {
+      "source": "nexus.ast-extractor",
+      "target": "nexus.task-dispatcher",
+      "type": "depends_on",
+      "description": "可选说明"
+    }
+  ],
+  "metadata": {
+    "total_files": 101,
+    "total_lines": 23184,
+    "languages": ["python"],
+    "git_commits_analyzed": 42,
+    "analysis_days": 90
+  }
+}
+```
+
+### 节点字段校验规则
+
+| 字段                    |   必需   | 触发 `[!ERROR]` 的情况                                                      |
+| ----------------------- | :------: | --------------------------------------------------------------------------- |
+| `id`                    |    是    | 全局重复；含大写字母或空格（必须为 kebab-case 小写）                        |
+| `type`                  |    是    | 不在枚举 `System / Domain / Module / Class / Function` 中                   |
+| `label`                 |    是    | 空字符串                                                                    |
+| `title`                 |    否    | Schema V1 不定义该字段；若写入，视为多余字段                                |
+| `responsibility`        |    是    | 空泛到无法验证；字数 < 10 或 > 120                                          |
+| `implementation_status` |    是    | 不在枚举 `implemented / planned / inferred` 中                              |
+| `code_path`             | 条件必需 | `implementation_status=implemented` 但为空；或路径在 repo 中不实际存在      |
+| `evidence_path`         | 条件必需 | `implementation_status=planned/inferred` 但为空；或路径在 repo 中不实际存在 |
+| `evidence_gap`          | 条件必需 | `implementation_status=planned/inferred` 但为空                             |
+
+### 节点状态表达规范
+
+**已实现节点**
+```json
+{
+  "implementation_status": "implemented",
+  "code_path": "src/server/",
+  "evidence_path": null,
+  "evidence_gap": null
+}
+```
+
+**计划中节点**
+```json
+{
+  "implementation_status": "planned",
+  "code_path": null,
+  "evidence_path": "docs/architecture.md",
+  "evidence_gap": "设计文档提到 Monarch/Executor，但仓库中未发现 src/agents/monarch/"
+}
+```
+
+**推断节点**
+```json
+{
+  "implementation_status": "inferred",
+  "code_path": null,
+  "evidence_path": "docs/architecture.md",
+  "evidence_gap": "仓库包含当前未支持的 DSL 文件；此边界来自文件树与人工阅读"
+}
+```
+
+---
+
+## query_graph.py 输出格式参考（stdout，非写入文件）
+
+### --file
+
+```
+=== <file_path> ===
+Module: <module_id> (<lines> lines, <lang>)
+
+Classes:
+  <ClassName> (L<start>-L<end>)
+    ├─ <method_name> (L<start>-L<end>)
+    └─ <method_name> (L<start>-L<end>)
+
+Top-level Functions:
+  <func_name> (L<start>-L<end>)
+
+Imports:
+  → <internal_module> (<path>)
+  → <external_package> (external)
+```
+
+### --who-imports
+
+```
+=== Who imports <module>? ===
+Imported by N module(s):
+  ← <module_id> (<path>)
+```
+
+### --impact
+
+```
+=== Impact radius: <file_path> ===
+
+Depends on (this file imports):
+  → <module_id> (<path>)
+
+Depended by (other files import this):
+  ← <module_id> (<path>)
+
+Impact summary: N upstream dependencies, M downstream dependents
+
+# 以下仅在传入 --git-stats 且该文件存在 hotspot/coupling 数据时输出
+Git risk: high (N changes in 90 days)
+Coupled files (co-change):
+  - <peer_path> (coupling: 0.XX, N co-changes)
+```
+
+### --hub-analysis
+
+```
+=== Hub Analysis ===
+
+Top fan-in (most imported by others):
+  1. <module_id> — imported by N module(s)  [<path>]
+
+Top fan-out (imports most others):
+  1. <module_id> — imports N internal module(s)  [<path>]
+```
+
+### --summary
+
+```
+=== Directory Summary ===
+
+<dir>/ (N modules, N classes, N functions, N lines)
+  Key classes: ClassA, ClassB, ...
+  Key imports from: <other_dir>, ...
+```

package/templates/.agents/skills/nexus-mapper/references/probe-protocol.md

@@ -0,0 +1,246 @@
+# PROBE 协议 — 各阶段详细步骤
+
+> 本文件是 SKILL.md 的执行蓝图，Skill 激活后**第一步**即读取本文件，一次性完整读取。
+> EMIT 前还需读 `references/output-schema.md`（Schema 太具体，单独放以节约激活时的 context）。
+> 非标准语言支持见 `references/language-customization.md`（按需，非门控）。
+
+---
+
+## P — PROFILE 阶段
+
+**前置验证**
+1. 确认 `$repo_path` 目录存在
+2. 检查 `$repo_path/.git` 是否存在
+   - 存在：执行 git 热点分析
+   - 不存在：记录 `git analysis skipped`，继续进行 AST 与文件树探测
+
+**执行步骤**
+
+```bash
+# 步骤 1: 运行 AST 提取器（同时生成过滤后的文件树）
+python $SKILL_DIR/scripts/extract_ast.py $repo_path [--max-nodes 500] \
+  --file-tree-out .nexus-map/raw/file_tree.txt \
+  > $repo_path/.nexus-map/raw/ast_nodes.json
+
+# 若仓库包含内置未覆盖的语言，通过命令行参数补充支持
+python $SKILL_DIR/scripts/extract_ast.py $repo_path [--max-nodes 500] \
+  --add-extension .templ=templ \
+  --add-query templ struct "(component_declaration name: (identifier) @class.name) @class.def" \
+  --file-tree-out .nexus-map/raw/file_tree.txt \
+  > $repo_path/.nexus-map/raw/ast_nodes.json
+
+# 或使用显式 JSON 配置文件（配置较复杂时，详见 references/language-customization.md）
+python $SKILL_DIR/scripts/extract_ast.py $repo_path [--max-nodes 500] \
+  --language-config /custom/path/to/language-config.json \
+  --file-tree-out .nexus-map/raw/file_tree.txt \
+  > $repo_path/.nexus-map/raw/ast_nodes.json
+
+# 步骤 2: 运行 git 热点分析（仅在存在 .git 时）
+python $SKILL_DIR/scripts/git_detective.py $repo_path --days 90 \
+  > $repo_path/.nexus-map/raw/git_stats.json
+```
+
+> `$SKILL_DIR` 为本 Skill 的安装路径（`.agent/skills/nexus-mapper` 或独立 repo 路径）。
+> `$repo_path` 为目标仓库的绝对路径。
+> `extract_ast.py --file-tree-out` 默认排除 `.git/`、`.nexus-map/`、`node_modules/`、`__pycache__/`、`.venv/`、`dist/`、`build/` 等噪音目录及文件。
+
+**完成检查（任一失败 → 停止，不进入 REASON）**
+- [ ] `raw/ast_nodes.json` 已写入（`nodes` 为空列表也属正常降级）
+- [ ] `raw/file_tree.txt` 非空
+- [ ] 若存在 git 历史：`raw/git_stats.json` 非空，包含 `hotspots` 字段
+- [ ] 若不存在 git 历史：已明确记录这是一次无 git 降级探测
+- [ ] 若 `ast_nodes.json.stats.known_unsupported_file_counts` 非空：已记录语言覆盖降级
+- [ ] 若 `ast_nodes.json.stats.module_only_file_counts` 非空：已记录哪些语言只有 Module 级覆盖
+- [ ] 若 `ast_nodes.json.stats.configured_but_unavailable_file_counts` 非空：已记录这部分视为未覆盖
+
+---
+
+## R — REASON 阶段
+
+**边界场景前置检查**（开始阅读项目文件前先过以下清单，命中任何一项需调整执行策略）
+
+| 场景                          | 识别方式                    | 处理                                                                                     |
+| ----------------------------- | --------------------------- | ---------------------------------------------------------------------------------------- |
+| 无 git 历史的新仓库           | `.git` 存在但只有 1 次提交  | 跳过 `git_detective.py`，输出中写明 `git analysis skipped: insufficient history`         |
+| 非 git 仓库                   | `.git` 不存在               | 跳过 `git_detective.py`，最终输出标注 `hotspots skipped: no git metadata`                |
+| 大型 Monorepo（>1000 文件）   | `stats.truncated=true`      | 告知用户使用 `--max-nodes 200`；`truncated=true` 是预期行为                              |
+| Git 历史过长（>3000 commits） | 分析慢 / git 数据过大       | 改用 `--days 30` 代替默认 90 天                                                          |
+| 无 README 的项目              | 根目录无 README             | 直接跳至 `pyproject.toml` / `package.json`；假说日志注明 evidence gap                    |
+| 带路线图/Sprint 状态的仓库    | README/TASKS 含时间敏感状态 | 允许摘要，必须附 `verified_at` 和源文档路径；禁止把无日期状态写成当前事实                |
+| 截断行为（truncated=true）    | `stats.truncated_nodes > 0` | Function 节点被丢弃，不会生成 `raw/functions.json`；可基于 Module/Class 节点产出完整产物 |
+
+> [!DEVIATION]
+> **已知实现偏差**：截断的 Function 节点被**直接丢弃**，**不会生成** `raw/functions.json`。
+> 如任何文档描述截断节点写入单独文件，均以本实际行为为准。
+
+**多语言覆盖分层**
+
+| 状态                   | 识别字段                                 | EMIT 要求                                                    |
+| ---------------------- | ---------------------------------------- | ------------------------------------------------------------ |
+| 完整结构覆盖           | `languages_with_structural_queries`      | 正常输出                                                     |
+| 仅 Module 级覆盖       | `module_only_file_counts`                | 不得描述为"完整 AST 覆盖"；细粒度结论需保守表述              |
+| 配置了但 parser 不可用 | `configured_but_unavailable_file_counts` | 视为未覆盖，不是 module-only；依赖结论只写 `inferred`        |
+| 完全未接入             | `known_unsupported_file_counts`          | `INDEX.md` 标注降级；相关区域加 `inferred/manual inspection` |
+
+**阅读策略（优先级从高到低）**
+1. `README.md` / `README.rst` — 项目总体描述
+2. `pyproject.toml` / `package.json` / `pom.xml` — 技术栈与依赖
+3. 主入口文件（`main.py`, `index.ts`, `Application.java`）
+4. `raw/file_tree.txt` — 目录结构感知
+5. `raw/git_stats.json` hotspots Top 5 — 最活跃文件（仅 git 数据可用时）
+6. 测试目录 — 建立静态测试面，不需要运行测试
+
+**执行要求**
+- 进行深度思考，逐步推演足够支撑结论的关键决策点，通常 3-5 个
+- 识别仓库的主要 System 级节点，通常 1-5 个；不要为凑数量把纯技术细节拆成独立系统
+- **[推荐]** 运行 hub-analysis 用扇入/扇出数据验证核心系统假说：
+  ```bash
+  python $SKILL_DIR/scripts/query_graph.py $repo_path/.nexus-map/raw/ast_nodes.json --hub-analysis
+  ```
+
+**记录格式**（工作记忆，不写文件）
+```
+[REASON LOG]
+- System A: 推断职责=X, implementation_status=implemented, code_path=Y （置信度: 高/中/低）
+- System B: 推断职责=X, implementation_status=planned, evidence_path=Y （置信度: 高/中/低）
+- Evidence gap: Z 目录归属缺少直接证据（将在 OBJECT 中质疑）
+```
+
+---
+
+## O — OBJECT 阶段
+
+**为什么需要质疑**：第一直觉建立的系统假说有三类典型偏差——目录名不等于职责、git 热点揭示真正的核心、import 方向揭示层次错误。三维度（下文）系统性覆盖这三类偏差。
+
+**质疑协议** — 提出足以挑战当前假设的最少一组高价值质疑，通常 1-3 个，每个附证据线索
+
+质疑点格式：
+```
+Q{N}: [具体的矛盾或可疑之处]
+证据线索: [在哪里发现的矛盾 — 文件路径/行号/git 数据]
+验证计划: [BENCHMARK 阶段如何验证]
+```
+
+不合格质疑（禁止提交）：
+```
+Q1: 我对系统结构的把握还不够扎实
+Q2: xxx 目录的职责暂时没有直接证据
+```
+问题不在措辞，而在于没有代码引证，也没有可执行的验证计划。
+
+合格示例：
+```
+Q1: git_stats 显示 tasks/analysis_tasks.py 变更 21 次（high risk），
+    但 REASON 认为编排入口是 evolution/detective_loop.py。
+    矛盾：若 detective_loop 是入口，analysis_tasks 为何热度更高？
+    证据线索: raw/git_stats.json hotspots[0]
+    验证计划: view tasks/analysis_tasks.py 的 class 定义 + import 树
+```
+
+**三维度质疑框架**（对应 Structure / Evolution / Dependency）
+
+| 维度       | 数据来源                                       | 高价值质疑模式                                                                             |
+| ---------- | ---------------------------------------------- | ------------------------------------------------------------------------------------------ |
+| Structure  | `raw/file_tree.txt`、ast edges(`contains`)     | 假设的"基础设施层"目录下出现业务命名文件；多个 System 文件都在同一 `utils/` 里（边界模糊） |
+| Evolution  | `raw/git_stats.json` hotspots + coupling_pairs | 热点榜首不在假设的"核心系统"内；coupling_score > 0.7 的文件对分属不同 System（边界划错）   |
+| Dependency | ast edges(`imports`)                           | 假设的底层 module import 了上层 module（循环依赖/分层错误）；import 方向与假设相反         |
+
+**质疑分级**
+
+| 级别     | 定义                                                     |       BENCHMARK 优先级        |
+| -------- | -------------------------------------------------------- | :---------------------------: |
+| Critical | 假设的系统边界完全错误，`code_path` 应指向完全不同的位置 | 立即验证，验证前不得进入 EMIT |
+| High     | 核心系统的 `code_path` 可能有误或遗漏了重要子目录        |        BENCHMARK 首批         |
+| Medium   | 子目录职责划分模糊，可能影响 `responsibility` 准确性     |       BENCHMARK 第二批        |
+
+> 如果证据只支持 Medium，就保持 Medium。至少有一条质疑必须真正可能改变系统边界、主入口或依赖方向。
+
+**三维度执行检查单**
+- [ ] Structure: file_tree.txt 是否有与假设系统无法匹配的文件/目录？
+- [ ] Structure: 是否有跨系统的 `utils/`/`common/` 目录存在模糊地带？
+- [ ] Evolution: git 数据可用时，热点前列是否支持"核心系统"的判断？
+- [ ] Evolution: coupling_pairs 中是否有跨假设系统边界的强耦合对（score > 0.5）？
+- [ ] Dependency: 是否有违反假设分层方向的 import 边（下层 imports 上层）？
+- [ ] Dependency: 是否有 System 的 imports 方向与假设的"依赖者-被依赖者"关系相反？
+
+---
+
+## B — BENCHMARK 阶段
+
+**对每个质疑点执行验证**
+1. 用 `grep_search` / `view_file` 查找具体证据
+2. **[推荐]** 用 `query_graph.py --impact` 查看目标文件的真实上下游依赖：
+   ```bash
+   python $SKILL_DIR/scripts/query_graph.py $repo_path/.nexus-map/raw/ast_nodes.json \
+     --impact <目标文件> --git-stats $repo_path/.nexus-map/raw/git_stats.json
+   ```
+3. 判断结果：
+   - 质疑成立 → 修正节点的 `code_path` 或 `responsibility`，在 LOG 中标记「修正」
+   - 质疑不成立 → 确认原假设，标记「验证通过」
+
+**全局节点校验（全部 System 节点逐一执行）**
+- [ ] `implemented` 节点的 `code_path` 在 repo 中实际存在
+- [ ] `planned/inferred` 节点不伪造 `code_path`，改用 `evidence_path + evidence_gap`
+- [ ] 每个 `planned/inferred` 节点的 `evidence_path` 在 repo 中实际存在
+- [ ] `responsibility` 表意清晰、具体；若证据不足，明确记录 evidence gap
+- [ ] 节点 `id` 全局唯一，kebab-case，全部小写
+
+> 发现关键系统完全识别错误 → 允许返回 REASON 重建模型，并重新执行 OBJECT。
+
+---
+
+## E — EMIT 阶段
+
+> [!IMPORTANT]
+> **阶段门控**：写入任何文件之前，必须先读：
+> `references/output-schema.md`
+> 未读取该文件即写入 → 产出的 JSON/Markdown 结构无法通过 Schema 校验，视为无效。
+
+**幂等性检查（写入前必做）**
+
+| 检查结果                             | 处理方式                                          |
+| ------------------------------------ | ------------------------------------------------- |
+| `.nexus-map/` 不存在                 | 直接继续                                          |
+| `.nexus-map/` 存在且 `INDEX.md` 有效 | 询问用户：「检测到已有分析结果，是否覆盖？[y/n]」 |
+| `.nexus-map/` 存在但文件不完整       | 「检测到未完成分析，将重新生成」，继续            |
+
+**[推荐] 写入前先获取结构摘要**
+```bash
+python $SKILL_DIR/scripts/query_graph.py $repo_path/.nexus-map/raw/ast_nodes.json --summary
+```
+
+**写入顺序（先写 `.tmp/`，全部成功后整体移动）**
+```
+1. .nexus-map/.tmp/concepts/concept_model.json   ← Schema V1
+2. .nexus-map/.tmp/INDEX.md                       ← L0 摘要, < 2000 tokens
+3. .nexus-map/.tmp/arch/systems.md                ← 各 System 边界
+4. .nexus-map/.tmp/arch/dependencies.md           ← Mermaid 依赖图
+5. .nexus-map/.tmp/arch/test_coverage.md          ← 静态测试面与证据缺口
+6. .nexus-map/.tmp/concepts/domains.md            ← Domain 概念说明
+7. .nexus-map/.tmp/hotspots/git_forensics.md      ← Git 热点摘要
+```
+
+全部写入成功 → 移动 `.tmp/` 内容到 `.nexus-map/` → 删除 `.tmp/`
+
+**INDEX.md 写入要求**
+- token 数 < 2000，超过就重写
+- 结论具体，不使用模糊词搪塞；证据不足时明确写 `evidence gap` 或 `unknown`
+- **必须包含 SKILL.md 守则4 定义的「操作指南」硬路由块**
+
+**每个 Markdown 文件的头部最少包含**
+```markdown
+> generated_by: nexus-mapper v2
+> verified_at: 2026-03-07
+> provenance: AST-backed except where explicitly marked inferred
+```
+
+**edges 合并协议（写入 concept_model.json 前执行）**
+1. 导入 `raw/ast_nodes.json` 中的 edges（`imports`/`contains`，机器层精确）
+2. 追加 BENCHMARK 阶段推断的语义边（`depends_on`/`calls`）
+3. 去重：`(source, target, type)` 三元组相同的边保留一条
+
+**完成校验**
+- [ ] `INDEX.md` 存在，结论具体且对证据缺口诚实，< 2000 tokens，包含硬路由块
+- [ ] `concept_model.json` 中 `implemented` 节点都有已验证 `code_path`
+- [ ] `arch/dependencies.md` 包含 >= 1 个 Mermaid 图
+- [ ] `arch/test_coverage.md` 说明了静态测试面，并明确未运行测试的证据缺口