@furongjun1999/dsh-memory 0.4.7 → 0.4.9

package/docs/discipline/harnesses.yaml

@@ -1,152 +1,226 @@
-# 工作纪律 · harness 适配矩阵
-#
-# 真源（唯一手写）：docs/工作纪律_认知图条目_v1.1.json
-# 本文件只声明「怎么把真源渲染成各端产物」，不承载纪律本体（与真源边界一致）。
-#
-# transport:
-#   file        —— 产物是一个独立文件；path 相对仓库根，或以 ~ 开头（用户目录）
-#   config-key  —— 产物写进某个 YAML 配置文件的指定键；用受管标记块原地修订，保留注释
-# variant:  full    —— 全文形态（含声明出口表 / 收尾流程 / 维护规则），供会话起始注入
-#           compact —— 精简形态（执行公约 + 路由表 + 声明），供「每轮都在」的系统提示槽位
-#           skill   —— SKILL.md 形态（YAML frontmatter + 纪律正文），供 Claude Code / Codex 插件的 skills/ 目录
-# enabled:  是否纳入 render --write 与 verify 的默认范围
-# memory:   该端 Agent 访问灵枢记忆的通路；仅声明事实，不参与渲染与校验。两种形态：
-#           ① MCP 客户端配置 —— 写客户端配置里的 server 名（如 mcp/mdcg）；
-#           ② 宿主内建桥   —— 插件直接 spawn 同一个 md_cg.mcp_server 为子进程，
-#                            再注册为宿主工具（DSH 侧 = lingshu_cg / lingshu_stg）。
-#           底层服务是同一个 python -m md_cg.mcp_server；差别只在"谁去连它"。
-#           未列该项的端表示通路未在本矩阵登记，不代表该端无通路。
-
-version: 1
-source: docs/工作纪律_认知图条目_v1.1.json
-
-targets:
-
-  dsh:
-    enabled: true
-    transport: config-key
-    path: '~/.dsh/profiles/web/cordis.patch.yml'
-    entry_id: system-prompt
-    key: personaPrefix
-    variant: compact
-    format: text
-    marker: lingshu:discipline
-    memory: plugin/lingshu_cg+lingshu_stg (插件内建桥，spawn md_cg.mcp_server；tools=core)
-    note: >-
-      DSH 系统提示 order=0（DEPLOYMENT_PERSONA_PREFIX），每轮注入；
-      严格 {{variable}} 插值 ⇒ 正文禁含裸 {{ 。
-    # 端差异与落地边界 → 注入 compact 模板的 %%PREAMBLE%%（模板保持通用，差异留在矩阵）
-    preamble: |-
-      【本端（DSH）与其它端的差异】
-      - 记忆通路：插件内建 lingshu_cg / lingshu_stg 两个基元（tools = core），即正文纪律中的 cg / stg——同一服务，勿因名字不同而猜测；其余能力经 cg(op=…) / stg(op=…) 分发，op 为必填参数（漏传会被参数签名推导兜底并标记 op_derived）。
-      - 注入时机：本段在系统提示 order=0（DEPLOYMENT_PERSONA_PREFIX），每轮都在；codebuddy / zcode 端是会话起始一次性注入全文。
-      - 自动记忆：本端有 session hook，默认自动转录用户消息（assistant / tool 默认关）。
-        故第 16 条在本端只补核心结论（内容／原因／位置／验证结论），不复述对话流水——否则与自动转录重复、稀释检索。
-        CodeBuddy 端无会话 hook，其自动记忆改由第 16 条显式归档驱动；两端落地方式不同，勿照搬。
-
-      【仓库结构与公开边界（第 9 / 14 条落地用）】
-      - 仓库按 harness 分目录：dsh/ · codebuddy/ · zcode/ · codex/；共享层（md_cg/ · docs/ · scripts/）在仓库根。
-      - 根目录 AGENTS.md 是本地私有件（.gitignore，含运维注记）；公开产物是 codebuddy/CODEBUDDY.md 与 zcode/AGENTS.md。
-      - 公开仓 = GitHub FuRongJun-1999/dsh-memory；私有运行时 = AEIS。含敏感／隐私内容只写 AEIS，不进公开仓。
-
-      【纪律本体的维护链路】
-      - 真源 docs/工作纪律_认知图条目_v1.1.json → scripts/render_discipline.py → 各端产物 → scripts/verify_discipline.py 守漂移。
-      - 改纪律 = 改真源 → 重渲染（--write）→ 过校验（漂移即非零退出）；禁止手改本段（下次渲染会覆盖）。
-
-  codebuddy:
-    enabled: true
-    transport: file
-    path: codebuddy/CODEBUDDY.md
-    variant: full
-    format: markdown
-    memory: mcp/mdcg (cg,stg)
-    note: >-
-      CodeBuddy 会话起始全文注入。**根目录 CODEBUDDY.md 优先于 AGENTS.md**——
-      本仓产物落 codebuddy/CODEBUDDY.md（不落根，避免屏蔽本地私有 AGENTS.md）；
-      外部用户复制该文件到自身项目根即生效（见 codebuddy/README.md）。
-
-  zcode:
-    enabled: true
-    transport: file
-    path: zcode/AGENTS.md
-    variant: full
-    format: markdown
-    preserve: true
-    note: >-
-      ZCode 读项目根 AGENTS.md。本仓产物落 zcode/AGENTS.md（不落根，避免与
-      CodeBuddy 的 CODEBUDDY.md 及本地 AGENTS.md 冲突）；复制到项目根生效。
-
-  codex:
-    enabled: true
-    transport: file
-    path: codex/AGENTS.md
-    variant: full
-    format: markdown
-    preserve: true
-    memory: mcp/mdcg (cg,stg)
-    note: >-
-      Codex CLI 读项目根 AGENTS.md（另支持 ~/.codex/AGENTS.md 全局）。
-      本仓产物落 codex/AGENTS.md（不落根，根 AGENTS.md 是本地私有件）；
-      复制到项目根即生效。MCP 通路模板见 codex/config.toml.example。
-
-  claude-code:
-    enabled: true
-    transport: file
-    path: claude/CLAUDE.md
-    variant: full
-    format: markdown
-    preserve: true
-    memory: mcp/mdcg (cg,stg)
-    note: >-
-      Claude Code（Anthropic）会话起始读取项目根 CLAUDE.md（另支持 ~/.claude/CLAUDE.md
-      全局、CLAUDE.local.md 私有附加）。本仓产物落 claude/CLAUDE.md（不落根——根 AGENTS.md
-      是本地私有件，且落根会与 CodeBuddy / Codex 端的根级注入并存造成重复）；
-      复制到项目根即生效。MCP 通路模板见 claude/mcp.json.example（项目级 .mcp.json）。
-    preamble: |-
-      【本端（Claude Code）与其它端的差异】
-      - 记忆通路：MCP server「mdcg」（项目级 .mcp.json 或 claude mcp add 配置，tools = kernel 面 cg/stg）；
-        其余能力经 cg(op=…) / stg(op=…) 分发。
-      - 注入时机：本段在会话起始一次性注入全文（CLAUDE.md）；DSH 端是每轮都在的 compact 系统提示。
-      - 自动记忆：本端无会话 hook 自动转录，记忆沉淀由第 16 条显式归档驱动（与 CodeBuddy / Codex 端同构）。
-
-  # —— 插件生态形态（新增）：纪律不再靠复制注入文件，而是随插件 skills/ 分发 ——
-  claude-code-plugin-skill:
-    enabled: true
-    transport: file
-    path: claude/lingshu-memory/skills/linglu-discipline/SKILL.md
-    variant: skill
-    format: markdown
-    memory: mcp/mdcg (cg,stg)
-    note: >-
-      Claude Code 插件形态（插件根 = claude/lingshu-memory/，经仓根 .claude-plugin/marketplace.json
-      分发：/plugin marketplace add FuRongJun-1999/dsh-memory → /plugin install）。
-      CLAUDE.md 不能随插件分发，纪律注入改由 skill 承载（Claude 按 frontmatter description 自动调用，
-      或 /lingshu-memory:linglu-discipline 显式调用）。
-    preamble: |-
-      【本 skill（Claude Code 插件形态）与其它端的差异】
-      - 记忆通路：MCP server「mdcg」（tools = kernel 面 cg/stg，其余能力经 op 分发）。插件不含大脑本体——
-        安装后须按插件 README 把 mcp.json.example 配置为项目 .mcp.json（PYTHONPATH 指向你本机的 dsh-memory 仓库）。
-      - 注入时机：Claude 按本 skill 的 description 在任务开始 / 命中触发词时自动调用；
-        也可用 /lingshu-memory:linglu-discipline 显式调用。其它端是会话起始一次性全文注入——
-        本 skill 形态下若本会话尚未加载过本 skill，应先加载再动手。
-      - 写入凭据：mdcg fail-closed，未配 MDCG_TOKEN 时只读 guest（读得到、写不进）；签发见插件 README。
-
-  codex-plugin-skill:
-    enabled: true
-    transport: file
-    path: codex/lingshu-memory/skills/linglu-discipline/SKILL.md
-    variant: skill
-    format: markdown
-    memory: mcp/mdcg (cg,stg)
-    note: >-
-      Codex 插件形态（插件根 = codex/lingshu-memory/，.codex-plugin/plugin.json，name 与文件夹一致；
-      经仓根 .agents/plugins/marketplace.json 分发：codex plugin marketplace add <本仓路径> → codex plugin add）。
-      与 codex/AGENTS.md 手工路线并存：AGENTS.md 是会话起始全文注入主通道，本 skill 是插件分发的等价形态。
-    preamble: |-
-      【本 skill（Codex 插件形态）与其它端的差异】
-      - 记忆通路：MCP server「mdcg」（tools = kernel 面 cg/stg，其余能力经 op 分发）。插件不含大脑本体——
-        安装后须按插件 README 把 config.toml.example 的 [mcp_servers.mdcg] 两段合并进 ~/.codex/config.toml
-        （PYTHONPATH 指向你本机的 dsh-memory 仓库）。
-      - 注入时机：Codex 按 skill 三级渐进加载（元数据常驻、正文触发时加载）；项目根 AGENTS.md 仍是
-        会话起始全文注入主通道，本 skill 与之同源、并存不冲突。
-      - 写入凭据：mdcg fail-closed，未配 MDCG_TOKEN 时只读 guest（读得到、写不进）；签发见插件 README。
+# 工作纪律 · harness 适配矩阵
+#
+# 真源（唯一手写）：docs/工作纪律_认知图条目_v1.1.json
+# 本文件只声明「怎么把真源渲染成各端产物」，不承载纪律本体（与真源边界一致）。
+#
+# transport:
+#   file        —— 产物是一个独立文件；path 相对仓库根，或以 ~ 开头（用户目录）
+#   config-key  —— 产物写进某个 YAML 配置文件的指定键；用受管标记块原地修订，保留注释
+# variant:  full    —— 全文形态（含声明出口表 / 收尾流程 / 维护规则），供会话起始注入
+#           compact —— 精简形态（执行公约 + 路由表 + 声明），供「每轮都在」的系统提示槽位
+#           skill   —— SKILL.md 形态（YAML frontmatter + 纪律正文），供 Claude Code / Codex 插件的 skills/ 目录
+# enabled:  是否纳入 render --write 与 verify 的默认范围
+# memory:   该端 Agent 访问灵枢记忆的通路；仅声明事实，不参与渲染与校验。三种形态：
+#           ① MCP 客户端配置 —— 写客户端配置里的 server 名（如 mcp/mdcg）；
+#           ② 宿主内建桥   —— 插件直接 spawn 同一个 md_cg.mcp_server 为子进程，
+#                            再注册为宿主工具（DSH 侧 = lingshu_cg / lingshu_stg）。
+#           ③ 蜂巢并发通路 —— hive = 另一个 MCP server（python -m hive.hive_mcp.mcp_server，
+#                            四工具 hive_spawn / hive_poll / hive_kill / hive_doctor），
+#                            提供多智能体并发 + 任务上下文管理（context_files 注入、预算交回、
+#                            进展卡 / handoff）。池与 serve 由 PYTHONPATH 指向的仓库内 hive/ 推导
+#                            ⇒ 多端指向同一仓库即**共享同一并发池**（「通用并发」的落地形态）；
+#                            要隔离可加 HIVE_JOBS_DIR / HIVE_CONFIG 指定独立池。
+#           底层服务是同一个 python -m md_cg.mcp_server；差别只在"谁去连它"。
+#           未列该项的端表示通路未在本矩阵登记，不代表该端无通路。
+# slot:     该产物在**宿主侧**占的注入位（对应下面 injection.slots 的键）。
+#           用途（Pi⑦⑤ 祖先链发现 + 防重复）：宿主从启动目录逐级上溯读同名件，故需按槽位
+#           发现「这条链上还并存哪些竞争件」；config-key 类产物无文件槽位，写 system-prompt-key。
+
+version: 1
+source: docs/工作纪律_认知图条目_v1.1.json
+
+# —— 注入面发现与防重复（Pi⑦⑤）——
+# 依据：宿主 agent 的注入件不是单点读取——它从启动目录逐级上溯读同名件（AGENTS.md /
+# CLAUDE.md / CODEBUDDY.md），故「产物落在哪」不等于「宿主只读到这一份」。本段把该事实
+# 声明为机械判据的输入，由 scripts/verify_discipline.py 裁决（判据见其 check_injection_matrix）：
+#   ① 同一物理文件被两个 target 写            → 后渲染者静默覆盖前者        → 硬失败
+#   ② 仓根出现会遮蔽本地私有件的槽位件         → 本地纪律注入在该宿主下失效   → 硬失败（§5 机械化的那条）
+#   ③ 同一条祖先链上并存同槽位件               → 宿主可能一并读到 / 按声明的
+#      择优顺序遮蔽                             → **发现面报告**（宿主侧事实，本仓不裁决，但不得假定不存在）
+injection:
+  version: 1
+  # 槽位 = 宿主侧的注入位；文件名列表 = **声明的宿主读取优先级**（首项优先，靠后者在同槽位被忽略）。
+  # 属「声明」而非「实测」：宿主行为一旦与此声明不符，应改本段而不是改判据。
+  slots:
+    codebuddy-session: [CODEBUDDY.md, AGENTS.md]
+    zcode-session: [AGENTS.md]
+    codex-session: [AGENTS.md]
+    claude-session: [CLAUDE.md]
+    plugin-skill: [SKILL.md]
+    # DSH 是配置键注入（personaPrefix），无文件级竞争面 —— 显式声明为空，不参与祖先链发现
+    system-prompt-key: []
+  # 仓根**允许**存在的槽位件：root AGENTS.md 是本地私有件（by design，见 codebuddy-local target）。
+  # 其余槽位件一旦出现在仓根，按 slots 声明顺序会遮蔽本地私有件 → 判硬失败。
+  root_allow: [AGENTS.md]
+  # 祖先链上溯终点：filesystem = 一路查到盘根（仓外命中只报告）；repo = 只查仓内。
+  chain_scope: filesystem
+
+targets:
+
+  dsh:
+    enabled: true
+    transport: config-key
+    slot: system-prompt-key
+    path: '~/.dsh/profiles/web/cordis.patch.yml'
+    entry_id: system-prompt
+    key: personaPrefix
+    variant: compact
+    format: text
+    marker: lingshu:discipline
+    memory: plugin/lingshu_cg+lingshu_stg (插件内建桥，spawn md_cg.mcp_server；tools=core)
+    # hive：本端未经 MCP 面接入——插件是内建桥形态（TS 侧 spawn + 工具注册），接蜂巢须在
+    # src/lib/ 新增 hive 客户端与四工具暴露，非「写一条配置」可解。当前兜底=CLI
+    # （hive.exe submit --spec <spec.json>）。详见 hive/README.md「各 harness 注册」。
+    memory_excluded: mcp/hive（形态差异：非原生 MCP 客户端，待插件 TS 侧接入）
+    note: >-
+      DSH 系统提示 order=0（DEPLOYMENT_PERSONA_PREFIX），每轮注入；
+      严格 {{variable}} 插值 ⇒ 正文禁含裸 {{ 。
+    # 端差异与落地边界 → 注入 compact 模板的 %%PREAMBLE%%（模板保持通用，差异留在矩阵）
+    preamble: |-
+      【本端（DSH）与其它端的差异】
+      - 记忆通路：插件内建 lingshu_cg / lingshu_stg 两个基元（tools = core），即正文纪律中的 cg / stg——同一服务，勿因名字不同而猜测；其余能力经 cg(op=…) / stg(op=…) 分发，op 为必填参数（漏传会被参数签名推导兜底并标记 op_derived）。
+      - 注入时机：本段在系统提示 order=0（DEPLOYMENT_PERSONA_PREFIX），每轮都在；codebuddy / zcode 端是会话起始一次性注入全文。
+      - 自动记忆：本端有 session hook，默认自动转录用户消息（assistant / tool 默认关）。
+        故第 16 条在本端只补核心结论（内容／原因／位置／验证结论），不复述对话流水——否则与自动转录重复、稀释检索。
+        CodeBuddy 端无会话 hook，其自动记忆改由第 16 条显式归档驱动；两端落地方式不同，勿照搬。
+
+      【仓库结构与公开边界（第 9 / 14 条落地用）】
+      - 仓库按 harness 分目录：dsh/ · codebuddy/ · zcode/ · codex/；共享层（md_cg/ · docs/ · scripts/）在仓库根。
+      - 根目录 AGENTS.md 是本地私有件（.gitignore，含运维注记）；公开产物是 codebuddy/CODEBUDDY.md 与 zcode/AGENTS.md。
+      - 公开仓 = GitHub FuRongJun-1999/dsh-memory；私有运行时 = AEIS。含敏感／隐私内容只写 AEIS，不进公开仓。
+
+      【纪律本体的维护链路】
+      - 真源 docs/工作纪律_认知图条目_v1.1.json → scripts/render_discipline.py → 各端产物 → scripts/verify_discipline.py 守漂移。
+      - 改纪律 = 改真源 → 重渲染（--write）→ 过校验（漂移即非零退出）；禁止手改本段（下次渲染会覆盖）。
+
+  codebuddy:
+    enabled: true
+    transport: file
+    slot: codebuddy-session
+    path: codebuddy/CODEBUDDY.md
+    variant: full
+    format: markdown
+    memory: mcp/mdcg (cg,stg) · mcp/hive (蜂巢并发：spawn/poll/kill/doctor)
+    note: >-
+      CodeBuddy 会话起始全文注入。**根目录 CODEBUDDY.md 优先于 AGENTS.md**——
+      本仓产物落 codebuddy/CODEBUDDY.md（不落根，避免屏蔽本地私有 AGENTS.md）；
+      外部用户复制该文件到自身项目根即生效（见 codebuddy/README.md）。
+
+  zcode:
+    enabled: true
+    transport: file
+    slot: zcode-session
+    path: zcode/AGENTS.md
+    variant: full
+    format: markdown
+    preserve: true
+    memory: mcp/mdcg (cg,stg) · mcp/hive (蜂巢并发：spawn/poll/kill/doctor)
+    note: >-
+      ZCode 读项目根 AGENTS.md。本仓产物落 zcode/AGENTS.md（不落根，避免与
+      CodeBuddy 的 CODEBUDDY.md 及本地 AGENTS.md 冲突）；复制到项目根生效。
+
+  codex:
+    enabled: true
+    transport: file
+    slot: codex-session
+    path: codex/AGENTS.md
+    variant: full
+    format: markdown
+    preserve: true
+    memory: mcp/mdcg (cg,stg) · mcp/hive (蜂巢并发：spawn/poll/kill/doctor)
+    note: >-
+      Codex CLI 读项目根 AGENTS.md（另支持 ~/.codex/AGENTS.md 全局）。
+      本仓产物落 codex/AGENTS.md（不落根，根 AGENTS.md 是本地私有件）；
+      复制到项目根即生效。MCP 通路模板见 codex/config.toml.example。
+
+  claude-code:
+    enabled: true
+    transport: file
+    slot: claude-session
+    path: claude/CLAUDE.md
+    variant: full
+    format: markdown
+    preserve: true
+    memory: mcp/mdcg (cg,stg) · mcp/hive (蜂巢并发：spawn/poll/kill/doctor)
+    note: >-
+      Claude Code（Anthropic）会话起始读取项目根 CLAUDE.md（另支持 ~/.claude/CLAUDE.md
+      全局、CLAUDE.local.md 私有附加）。本仓产物落 claude/CLAUDE.md（不落根——根 AGENTS.md
+      是本地私有件，且落根会与 CodeBuddy / Codex 端的根级注入并存造成重复）；
+      复制到项目根即生效。MCP 通路模板见 claude/mcp.json.example（项目级 .mcp.json）。
+    preamble: |-
+      【本端（Claude Code）与其它端的差异】
+      - 记忆通路：MCP server「mdcg」（项目级 .mcp.json 或 claude mcp add 配置，tools = kernel 面 cg/stg）；
+        其余能力经 cg(op=…) / stg(op=…) 分发。
+      - 注入时机：本段在会话起始一次性注入全文（CLAUDE.md）；DSH 端是每轮都在的 compact 系统提示。
+      - 自动记忆：本端无会话 hook 自动转录，记忆沉淀由第 16 条显式归档驱动（与 CodeBuddy / Codex 端同构）。
+
+  # —— 插件生态形态（新增）：纪律不再靠复制注入文件，而是随插件 skills/ 分发 ——
+  claude-code-plugin-skill:
+    enabled: true
+    transport: file
+    slot: plugin-skill
+    path: claude/lingshu-memory/skills/linglu-discipline/SKILL.md
+    variant: skill
+    format: markdown
+    memory: mcp/mdcg (cg,stg) · mcp/hive (蜂巢并发：spawn/poll/kill/doctor)
+    note: >-
+      Claude Code 插件形态（插件根 = claude/lingshu-memory/，经仓根 .claude-plugin/marketplace.json
+      分发：/plugin marketplace add FuRongJun-1999/dsh-memory → /plugin install）。
+      CLAUDE.md 不能随插件分发，纪律注入改由 skill 承载（Claude 按 frontmatter description 自动调用，
+      或 /lingshu-memory:linglu-discipline 显式调用）。
+    preamble: |-
+      【本 skill（Claude Code 插件形态）与其它端的差异】
+      - 记忆通路：MCP server「mdcg」（tools = kernel 面 cg/stg，其余能力经 op 分发）。插件不含大脑本体——
+        安装后须按插件 README 把 mcp.json.example 配置为项目 .mcp.json（PYTHONPATH 指向你本机的 dsh-memory 仓库）。
+      - 注入时机：Claude 按本 skill 的 description 在任务开始 / 命中触发词时自动调用；
+        也可用 /lingshu-memory:linglu-discipline 显式调用。其它端是会话起始一次性全文注入——
+        本 skill 形态下若本会话尚未加载过本 skill，应先加载再动手。
+      - 写入凭据：mdcg fail-closed，未配 MDCG_TOKEN 时只读 guest（读得到、写不进）；签发见插件 README。
+
+  codex-plugin-skill:
+    enabled: true
+    transport: file
+    slot: plugin-skill
+    path: codex/lingshu-memory/skills/linglu-discipline/SKILL.md
+    variant: skill
+    format: markdown
+    memory: mcp/mdcg (cg,stg) · mcp/hive (蜂巢并发：spawn/poll/kill/doctor)
+    note: >-
+      Codex 插件形态（插件根 = codex/lingshu-memory/，.codex-plugin/plugin.json，name 与文件夹一致；
+      经仓根 .agents/plugins/marketplace.json 分发：codex plugin marketplace add <本仓路径> → codex plugin add）。
+      与 codex/AGENTS.md 手工路线并存：AGENTS.md 是会话起始全文注入主通道，本 skill 是插件分发的等价形态。
+    preamble: |-
+      【本 skill（Codex 插件形态）与其它端的差异】
+      - 记忆通路：MCP server「mdcg」（tools = kernel 面 cg/stg，其余能力经 op 分发）。插件不含大脑本体——
+        安装后须按插件 README 把 config.toml.example 的 [mcp_servers.mdcg] 两段合并进 ~/.codex/config.toml
+        （PYTHONPATH 指向你本机的 dsh-memory 仓库）。
+      - 注入时机：Codex 按 skill 三级渐进加载（元数据常驻、正文触发时加载）；项目根 AGENTS.md 仍是
+        会话起始全文注入主通道，本 skill 与之同源、并存不冲突。
+      - 写入凭据：mdcg fail-closed，未配 MDCG_TOKEN 时只读 guest（读得到、写不进）；签发见插件 README。
+
+  # —— 本地私有注入件（.gitignore，不入公开仓）：只校验，不渲染 ——
+  # 它是「纪律本体 + 本地增强」的手工件（§1 设计者视角含本机路径、§0.6 工具规范、§5 运维注记），
+  # full 模板渲染会覆盖这些本地增强段，故 render: false（禁写盘）。
+  codebuddy-local:
+    enabled: true
+    render: false
+    transport: file
+    slot: codebuddy-session
+    path: AGENTS.md
+    variant: full
+    format: markdown
+    memory: mcp/mdcg (cg,stg) · mcp/hive (蜂巢并发：spawn/poll/kill/doctor)
+    note: >-
+      根目录 AGENTS.md = 本机 CodeBuddy 会话注入件（见本文件 dsh preamble「仓库结构与公开边界」）。
+      历史缺陷（20260916 漂移实例）：它是手工件、长期不在渲染/校验矩阵内，0.1 / 0.6 把 DSH 端
+      注册名写死为通用工具名并加「非 cg」的反向否决，本端 agent 因此对工具名产生疑惑——
+      与「手写行号必腐化」同构：无守卫的手工件必然漂移。
+      修法：纳入矩阵只做校验（render: false），守卫 ①声明出口逐字一致；②工具名随端标注
+      （件内每处 DSH 端基元名须与 MCP 端正名 mdcg 同行出现）；③编号完备（缺条即其声明缺失）。
+    # 形态说明（20260916 修订）：本件 §2 路由表原为分组表格；markdown 表格单元格须转义
+    # 半角 '|'，而真源 execution.how 含半角 '|'（第 2 / 8 条）——与「逐字嵌入」物理不相容，
+    # 故曾退让为 verify_fields advisory（差异全量打印、不判失败，不静默）。
+    # 现按使用者裁定改为**列表形态**（与渲染产物同源、逐字真源），摘要化差异归零：
+    # 撤下 verify_fields，本件回到**全字段 strict**（trigger / action / negative / declaration）。
+    # 同轮另一项：真源第 1 条 how 补「与既有实践」，与 content / response.direct 自洽——
+    # 原 how 缺该语、与真源自身矛盾，手工件反而是对的（属真源过时，非件漂移）。

package/docs/discipline/templates/full.md.tmpl

@@ -1,58 +1,61 @@
-# 工作纪律（%%VERSION%%）· %%COUNT%% 条
-
-> 本文件由 `scripts/render_discipline.py` 从真源
-> `docs/工作纪律_认知图条目_v1.1.json` 渲染生成，**请勿手改**；改真源后重跑渲染。
-> 真源指纹（SHA256 前16位）：%%SOURCE_SHA%%
-
-## 概述
-
-%%OVERVIEW%%
-
-## 执行公约
-
-| 约定 | 内容 |
-|---|---|
-| **0.1 会话起始先查记忆** | 动手前先调认知图入口——工具名随端：MCP 端 = server「mdcg」的 `cg`；DSH 端 = 内建基元 `lingshu_cg`（即下文所有 `cg(...)`，同一服务勿因名字不同而猜测）。**`op` 是必填参数（route/read/write/verify/review…），任何调用都显式传、勿省略**。先 `cg(op=route, intent=<任务意图>)`；命中纪律/知识则按其 `execution.how` 执行。**禁止跳过此步直接改代码或跑命令。** |
-| **0.2 命中即声明** | 命中纪律须在回复中输出该条 `response.direct` 原文（「按工作纪律第 N 条：…」）。**这是「已执行」的唯一可观测证据；未声明即视为未执行。** |
-| **0.3 产出即证据** | 「动作」栏要求的产出（判定单／检索结果／验证结论／归档节点 id）必须实际给出，缺失即未执行。 |
-| **0.4 违规即归档** | 发现自己违反任一条 → 第 4 条归因 + 第 16 条写入灵枢记忆。**隐瞒违规本身是更严重的违规。** |
-| **0.5 例外不外溢** | 某条的「不适用」只豁免该条，不豁免其它条。 |
-
-## 纪律路由表
-
-%%ROUTING_TABLE_FULL%%
-
-## 声明出口（`response.direct` 原文 · 未输出即未执行）
-
-%%DECLARATION_TABLE%%
-
-## 记忆接口速查（`cg` / `stg`）
-
-工具名随端：MCP 端 = server「mdcg」的 `cg` / `stg`；DSH 端 = 内建基元 `lingshu_cg` / `lingshu_stg`（与 `cg` / `stg` 同一服务，仅注册名不同）。**`op` 一律必填。**
-
-| op | 用途 | 常用参数 |
-|---|---|---|
-| `route` | 任务开始路由记忆（返回知识 + 建议能力，不执行） | `intent`（任务意图） |
-| `read` | 召回/检索/按 id 取（`session`=只取该会话归属的记忆，缺省不过滤） | `query` / `node_id` / `k` / `layer` / `budget_tokens` / `context` / `session` |
-| `write` | 写入（先按 content_kind 审核 + 冲突检测，ACCEPT 落盘 / DEFER 入审核队列 / REJECT 入负记忆）。**自动归属**：frontmatter 带 `writer`/`session`/`harness`（服务端身份，不可伪造） | `content` / `content_kind`（text/code/…）/ `node_id`（同 id 即改写）/ `layer` / `tags` / `importance` / `verification_basis` / `condition_space` / `gated` / `consistency` / `on_conflict`（reject\|defer\|record） |
-| `verify` | 对节点做证据验证（confirmed/weakened/falsified）——**非队列裁决** | `node_id` / `verdict` / `evidence` |
-| `review` | 审核队列：`action=list/rounds/records` 查看；传 `pid`+`decision`+`reason` 即裁决落盘（accept/reject/edit/merge，**需 can_admin**；本机未配置外部验证器时写入恒 DEFER 入队，靠此裁决落盘） | `action` / `pid` / `decision` / `reason` / `edits` / `merge_into` |
-| `recent` | 近期事件窗口 | `action`（add/list/clear）/ `limit` |
-| `forget` / `protect` | 软删除/恢复 / 写保护 | `node_id` |
-
-三条调用铁律：
-1. **`op` 必填**——漏传会触发参数签名推导兜底（返回标记 `op_derived: true`），复杂任务中也必须显式传，防静默执行错误意图。
-2. **返回 `moved_to: "review_queue"` / `verdict: DEFER/REJECT` 时不要重试**——这是校验闸门的正常行为（返回自带 `hint` 说明），重试同样结果；落盘须由设计者权限（can_admin）经 `op=review` 裁决（decision=accept/reject/edit/merge，本机工具：`python scripts/review_cli.py list`），agent 端无裁决权是设计（写入者不得自裁自决），转告使用者即可。
-3. `stg` 同理经 `op` 分发（`timeline` / `relation` / `anchors` 等）。
-
-## 收尾强制流程（任务完成时不可跳过）
-
-1. **验证**（第 5 条）：未验证不固化——回放／断言／回归通过才收尾。
-2. **归档**（第 16 条）：提炼关键修改（内容／原因／位置／验证结论四要素，禁写中间过程）→ 写入灵枢记忆。
-3. **自检**（第 4 条）：本次是否有违规？有 → 按条件层归因，并补不适用条件。
-
-## 本文件维护（防漂移）
-
-- 真源唯一：`docs/工作纪律_认知图条目_v1.1.json`。
-- 本文件是**渲染产物**，不是手抄投影；任何端的手改都会被 `scripts/verify_discipline.py` 判为漂移。
-- 改纪律 → 改真源 → `render_discipline.py --write` → `verify_discipline.py` 通过 → 提交。
+# 工作纪律（%%VERSION%%）· %%COUNT%% 条
+
+> 本文件由 `scripts/render_discipline.py` 从真源
+> `docs/工作纪律_认知图条目_v1.1.json` 渲染生成，**请勿手改**；改真源后重跑渲染。
+> 真源指纹（SHA256 前16位）：%%SOURCE_SHA%%
+
+## 概述
+
+%%OVERVIEW%%
+
+## 执行公约
+
+| 约定 | 内容 |
+|---|---|
+| **0.1 会话起始先查记忆** | 动手前先调认知图入口——工具名随端：MCP 端 = server「mdcg」的 `cg`；DSH 端 = 内建基元 `lingshu_cg`（即下文所有 `cg(...)`，同一服务勿因名字不同而猜测）。**`op` 是必填参数（route/read/write/verify/review…），任何调用都显式传、勿省略**。先 `cg(op=route, intent=<任务意图>)`；命中纪律/知识则按其 `execution.how` 执行。**禁止跳过此步直接改代码或跑命令。** |
+| **0.2 命中即声明** | 命中纪律须在回复中输出该条 `response.direct` 原文（「按工作纪律第 N 条：…」）。**这是「已执行」的唯一可观测证据；未声明即视为未执行。** |
+| **0.3 产出即证据** | 「动作」栏要求的产出（判定单／检索结果／验证结论／归档节点 id）必须实际给出，缺失即未执行。 |
+| **0.4 违规即归档** | 发现自己违反任一条 → 第 4 条归因 + 第 16 条写入灵枢记忆。**隐瞒违规本身是更严重的违规。** |
+| **0.5 例外不外溢** | 某条的「不适用」只豁免该条，不豁免其它条。 |
+
+## 纪律路由表
+
+%%ROUTING_TABLE_FULL%%
+
+## 声明出口（`response.direct` 原文 · 未输出即未执行）
+
+%%DECLARATION_TABLE%%
+
+## 记忆接口速查（`cg` / `stg`）
+
+工具名随端：MCP 端 = server「mdcg」的 `cg` / `stg`；DSH 端 = 内建基元 `lingshu_cg` / `lingshu_stg`（与 `cg` / `stg` 同一服务，仅注册名不同）。**`op` 一律必填。**
+
+| op | 用途 | 常用参数 |
+|---|---|---|
+| `route` | 任务开始路由记忆（返回知识 + 建议能力，不执行） | `intent`（任务意图） |
+| `read` | 召回/检索/按 id 取（`session`=只取该会话归属的记忆，缺省不过滤；`validity=true`=时效过滤（显式启用，缺省不过滤），**仅排除「已过期」，「未生效」一律保留**——两者语义相反） | `query` / `node_id` / `k` / `layer` / `budget_tokens` / `context` / `session` / `validity` |
+| `edges` | 三元组反查（**只读**）：按派生边任意端/谓词/时间反查「这条记忆从哪来 / 谁由它派生」（subject/predicate/object 即 child/relation/parent）；`expand_nodes=true` 附命中端点节点卡 | `child` / `parent` / `relation` / `batch` / `start_time` / `end_time` / `time_axis` / `ordering` / `offset` / `limit` / `aggregation` / `expand_nodes` |
+| `write` | 写入（先按 content_kind 审核 + 冲突检测，ACCEPT 落盘 / DEFER 入审核队列 / REJECT 入负记忆）。**自动归属**：frontmatter 带 `writer`/`session`/`harness`（服务端身份，不可伪造） | `content` / `content_kind`（text/code/…）/ `node_id`（同 id 即改写）/ `layer` / `tags` / `importance` / `verification_basis` / `condition_space` / `gated` / `consistency` / `on_conflict`（reject\|defer\|record） |
+| `verify` | 对节点做证据验证（confirmed/weakened/falsified）——**非队列裁决** | `node_id` / `verdict` / `evidence` |
+| `review` | 审核队列：`action=list/rounds/records/stats` 查看；传 `pid`+`decision`+`reason` 即裁决落盘（accept/reject/edit/merge/noop，**需 can_admin**；`noop`=已评估且判定不改动任何现有记忆，只留痕不入库、不进负记忆；本机未配置外部验证器时写入恒 DEFER 入队，靠此裁决落盘） | `action` / `pid` / `decision` / `reason` / `edits` / `merge_into` |
+| `task` | 结构层任务实体（工程台账，跨会话/上下文压缩后不遗忘）：`name` 即身份（同名即同任务，slug 归一），`action` = open/status/plan_add/get/list/find/session（缺省 list）；**迁 `done` 必须同时给 `result`**（缺一不收，拒收不落盘）；未提供的字段沿用旧值（结果不会被静默清空） | `name` / `action` / `plan`（分步计划，每轮覆盖） / `change`（计划变更，逐轮追加） / `result` / `task_status`（active\|blocked\|done\|dropped） / `goal` / `acceptance` / `boundary` / `condition` / `node_id` |
+| `recent` | 近期事件窗口 | `action`（add/list/clear）/ `limit` |
+| `forget` / `protect` | 软删除/恢复 / 写保护 | `node_id` |
+| `help` | 取回工具面上**被投影外置**的完整 op / 参数文档（工具面渐进披露：常驻提示只留一行职责，参数语义按需取；不带 `query` 则列出全部工具） | `query`（工具名或 op 名，如 `cg` / `write`）/ `limit` |
+
+三条调用铁律：
+1. **`op` 必填**——漏传会触发参数签名推导兜底（返回标记 `op_derived: true`），复杂任务中也必须显式传，防静默执行错误意图。
+2. **返回 `moved_to: "review_queue"` / `verdict: DEFER/REJECT` 时不要重试**——这是校验闸门的正常行为（返回自带 `hint` 说明），重试同样结果；落盘须由设计者权限（can_admin）经 `op=review` 裁决（decision=accept/reject/edit/merge/noop，本机工具：`python scripts/review_cli.py list`），agent 端无裁决权是设计（写入者不得自裁自决），转告使用者即可。
+3. `stg` 同理经 `op` 分发（`timeline` / `relation` / `anchors` 等）。
+
+## 收尾强制流程（任务完成时不可跳过）
+
+1. **验证**（第 5 条）：未验证不固化——回放／断言／回归通过才收尾。
+2. **归档**（第 16 条）：提炼关键修改（内容／原因／位置／验证结论四要素，禁写中间过程）→ 写入灵枢记忆。
+3. **自检**（第 4 条）：本次是否有违规？有 → 按条件层归因，并补不适用条件。
+
+## 本文件维护（防漂移）
+
+- 真源唯一：`docs/工作纪律_认知图条目_v1.1.json`。
+- 本文件是**渲染产物**，不是手抄投影；任何端的手改都会被 `scripts/verify_discipline.py` 判为漂移。
+- 改纪律 → 改真源 → `render_discipline.py --write` → `verify_discipline.py` 通过 → 提交。