@blxzer/pactile 0.5.0 → 0.6.0-beta.2

package/dist/templates/pactile/modules/independent-check/contract.md

@@ -1,35 +1,35 @@
-# `independent-check`
-
-P29 表名：`independent-check`（不得改名）。层：on-demand。
-
-## 职责
-
-只读的独立语义第二遍。在 `verify-basic` 的 Evidence 之上，对 Full / 硬 Risk / Policy 要求再做一次「不是同一双手」的检查。默认只出 findings/verdict，**不改代码**。实现缺陷回 Execute；任何代码修改使旧 verdict 失效，必须重跑。assurance 必须诚实：`self-review`（同一 Agent 结构化第二遍）vs `true-independent`（独立 Worker 或人）。Policy 要 true-independent 而平台没有独立 Worker → 阻塞，不得假绿。
-
-## 触发/披露
-
-Lite 当没装。Rigor=Full，或 Policy/硬 Risk 要求时激活。未激活则 Prompt 无 Check Agent 教战，也不得把 `verify-basic` 的自查写成 independent。非 Full/非触发不进包。
-
-Agent 看见：
-
-1. 只读。发现实现问题 → 回 Execute，再 Verify，再 Check。
-2. 发现契约问题 → Return-to-Define，不是在 Check 里改 PRD 充数。
-3. 无可靠独立 Worker 时标签必须是 `self-review`。
-4. spawn `pactile-check` 仅当 `worker-orchestration` 同时激活且合同要求 worker；否则主会话做结构化第二遍并标 self-review。
-5. Full / Parent：缺 `touches`、或 `touches` 明显跨无关模块且无 `serial_reason` / `oversized_accepted` → 不合格。Lite 缺 `touches` 不因此不合格。`meta.pool_items` 多于一条时，PRD 须有 `## 池义务`（或 `## Pool obligations`）并点名每一条，否则不合格。调用 `common.pool_slice.evaluate_pool_slice`。这不是 `task.py create` 或 `start-execution --check` 硬挡，也不是 `pool.py validate` 因缺 `## 切片` 失败。
-
-用户看见：Full 收工前多一次「是否独立查过」的诚实标签。Lite 不出现本块。
-
-## 停止条件
-
-- 触发：Full 或 Policy。
-- 输出：verdict + findings；assurance 字段。
-- 停止：在 Check 中改代码还声称同一 verdict；Lite 强制本块；无 Worker 却写 true-independent。
-
-## 关掉必须消失
-
-不得声称 independent。Lite 与 `verify-basic` 不受影响。Full 若 Policy 要求 true-independent 则无法 Close（诚实阻塞）。
-
-## 不得带走
-
-AC→Evidence 最低面（`verify-basic`）；派工通道本身（`worker-orchestration`）；Execute 改代码（`execute-agent`）。
+# `independent-check`
+
+P29 表名：`independent-check`（不得改名）。层：on-demand。
+
+## 职责
+
+只读的独立语义第二遍。在 `verify-basic` 的 Evidence 之上，对 Full / 硬 Risk / Policy 要求再做一次「不是同一双手」的检查。默认只出 findings/verdict，**不改代码**。实现缺陷回 Execute；任何代码修改使旧 verdict 失效，必须重跑。assurance 必须诚实：`self-review`（同一 Agent 结构化第二遍）vs `true-independent`（独立 Worker 或人）。Policy 要 true-independent 而平台没有独立 Worker → 阻塞，不得假绿。
+
+## 触发/披露
+
+Lite 当没装。Rigor=Full，或 Policy/硬 Risk 要求时激活。未激活则 Prompt 无 Check Agent 教战，也不得把 `verify-basic` 的自查写成 independent。非 Full/非触发不进包。
+
+Agent 看见：
+
+1. 只读。发现实现问题 → 回 Execute，再 Verify，再 Check。
+2. 发现契约问题 → Return-to-Define，不是在 Check 里改 PRD 充数。
+3. 无可靠独立 Worker 时标签必须是 `self-review`。
+4. spawn `pactile-check` 仅当 `worker-orchestration` 同时激活且合同要求 worker；否则主会话做结构化第二遍并标 self-review。
+5. Full / Parent：缺 `touches`、或 `touches` 明显跨无关模块且无 `serial_reason` / `oversized_accepted` → 不合格。Lite 缺 `touches` 不因此不合格。这是 Check 的判定，不是 `pactile task create` 或 `start-execution --check` 的硬挡。
+
+用户看见：Full 收工前多一次「是否独立查过」的诚实标签。Lite 不出现本块。
+
+## 停止条件
+
+- 触发：Full 或 Policy。
+- 输出：verdict + findings；assurance 字段。
+- 停止：在 Check 中改代码还声称同一 verdict；Lite 强制本块；无 Worker 却写 true-independent。
+
+## 关掉必须消失
+
+不得声称 independent。Lite 与 `verify-basic` 不受影响。Full 若 Policy 要求 true-independent 则无法 Close（诚实阻塞）。
+
+## 不得带走
+
+AC→Evidence 最低面（`verify-basic`）；派工通道本身（`worker-orchestration`）；Execute 改代码（`execute-agent`）。

package/dist/templates/pactile/modules/index.json

@@ -1,133 +1,127 @@
-{
-  "schema_version": 1,
-  "source": "p29-module-table",
-  "baseline_intents": ["exact", "semantic", "structural", "external"],
-  "layers": {
-    "baseline": [
-      "intake-basic",
-      "define-basic",
-      "approval-personal",
-      "execute-agent",
-      "verify-basic",
-      "close-basic",
-      "context-progressive",
-      "observability-local"
-    ],
-    "on-demand": [
-      "candidate-pool",
-      "define-extended",
-      "independent-check",
-      "worker-orchestration",
-      "parent-child",
-      "debug-recovery",
-      "session-transfer",
-      "spec-learning",
-      "vcs-integration",
-      "personal-memory",
-      "retention-storage",
-      "retrieval-extended"
-    ]
-  },
-  "modules": [
-    {
-      "id": "intake-basic",
-      "layer": "baseline",
-      "contract": "intake-basic/contract.md"
-    },
-    {
-      "id": "define-basic",
-      "layer": "baseline",
-      "contract": "define-basic/contract.md"
-    },
-    {
-      "id": "approval-personal",
-      "layer": "baseline",
-      "contract": "approval-personal/contract.md"
-    },
-    {
-      "id": "execute-agent",
-      "layer": "baseline",
-      "contract": "execute-agent/contract.md"
-    },
-    {
-      "id": "verify-basic",
-      "layer": "baseline",
-      "contract": "verify-basic/contract.md"
-    },
-    {
-      "id": "close-basic",
-      "layer": "baseline",
-      "contract": "close-basic/contract.md"
-    },
-    {
-      "id": "context-progressive",
-      "layer": "baseline",
-      "contract": "context-progressive/contract.md"
-    },
-    {
-      "id": "observability-local",
-      "layer": "baseline",
-      "contract": "observability-local/contract.md"
-    },
-    {
-      "id": "candidate-pool",
-      "layer": "on-demand",
-      "contract": "candidate-pool/contract.md"
-    },
-    {
-      "id": "define-extended",
-      "layer": "on-demand",
-      "contract": "define-extended/contract.md"
-    },
-    {
-      "id": "independent-check",
-      "layer": "on-demand",
-      "contract": "independent-check/contract.md"
-    },
-    {
-      "id": "worker-orchestration",
-      "layer": "on-demand",
-      "contract": "worker-orchestration/contract.md"
-    },
-    {
-      "id": "parent-child",
-      "layer": "on-demand",
-      "contract": "parent-child/contract.md"
-    },
-    {
-      "id": "debug-recovery",
-      "layer": "on-demand",
-      "contract": "debug-recovery/contract.md"
-    },
-    {
-      "id": "session-transfer",
-      "layer": "on-demand",
-      "contract": "session-transfer/contract.md"
-    },
-    {
-      "id": "spec-learning",
-      "layer": "on-demand",
-      "contract": "spec-learning/contract.md"
-    },
-    {
-      "id": "vcs-integration",
-      "layer": "on-demand",
-      "contract": "vcs-integration/contract.md"
-    },
-    {
-      "id": "personal-memory",
-      "layer": "on-demand",
-      "contract": "personal-memory/contract.md"
-    },
-    {
-      "id": "retention-storage",
-      "layer": "on-demand",
-      "contract": "retention-storage/contract.md"
-    },
-    {
-      "id": "retrieval-extended",
-      "layer": "on-demand",
-      "contract": "retrieval-extended/contract.md"
-    }
-  ]
-}
+{
+  "schema_version": 1,
+  "source": "p29-module-table",
+  "baseline_intents": ["exact", "semantic", "structural", "external"],
+  "layers": {
+    "baseline": [
+      "intake-basic",
+      "define-basic",
+      "approval-personal",
+      "execute-agent",
+      "verify-basic",
+      "close-basic",
+      "context-progressive",
+      "observability-local"
+    ],
+    "on-demand": [
+      "define-extended",
+      "independent-check",
+      "worker-orchestration",
+      "parent-child",
+      "debug-recovery",
+      "session-transfer",
+      "spec-learning",
+      "vcs-integration",
+      "personal-memory",
+      "retention-storage",
+      "retrieval-extended"
+    ]
+  },
+  "modules": [
+    {
+      "id": "intake-basic",
+      "layer": "baseline",
+      "contract": "intake-basic/contract.md"
+    },
+    {
+      "id": "define-basic",
+      "layer": "baseline",
+      "contract": "define-basic/contract.md"
+    },
+    {
+      "id": "approval-personal",
+      "layer": "baseline",
+      "contract": "approval-personal/contract.md"
+    },
+    {
+      "id": "execute-agent",
+      "layer": "baseline",
+      "contract": "execute-agent/contract.md"
+    },
+    {
+      "id": "verify-basic",
+      "layer": "baseline",
+      "contract": "verify-basic/contract.md"
+    },
+    {
+      "id": "close-basic",
+      "layer": "baseline",
+      "contract": "close-basic/contract.md"
+    },
+    {
+      "id": "context-progressive",
+      "layer": "baseline",
+      "contract": "context-progressive/contract.md"
+    },
+    {
+      "id": "observability-local",
+      "layer": "baseline",
+      "contract": "observability-local/contract.md"
+    },
+    {
+      "id": "define-extended",
+      "layer": "on-demand",
+      "contract": "define-extended/contract.md"
+    },
+    {
+      "id": "independent-check",
+      "layer": "on-demand",
+      "contract": "independent-check/contract.md"
+    },
+    {
+      "id": "worker-orchestration",
+      "layer": "on-demand",
+      "contract": "worker-orchestration/contract.md"
+    },
+    {
+      "id": "parent-child",
+      "layer": "on-demand",
+      "contract": "parent-child/contract.md"
+    },
+    {
+      "id": "debug-recovery",
+      "layer": "on-demand",
+      "contract": "debug-recovery/contract.md"
+    },
+    {
+      "id": "session-transfer",
+      "layer": "on-demand",
+      "contract": "session-transfer/contract.md"
+    },
+    {
+      "id": "spec-learning",
+      "layer": "on-demand",
+      "contract": "spec-learning/contract.md"
+    },
+    {
+      "id": "vcs-integration",
+      "layer": "on-demand",
+      "contract": "vcs-integration/contract.md"
+    },
+    {
+      "id": "personal-memory",
+      "layer": "on-demand",
+      "contract": "personal-memory/contract.md"
+    },
+    {
+      "id": "retention-storage",
+      "layer": "on-demand",
+      "contract": "retention-storage/contract.md"
+    },
+    {
+      "id": "retrieval-extended",
+      "layer": "on-demand",
+      "contract": "retrieval-extended/contract.md"
+    }
+  ]
+}

package/dist/templates/pactile/modules/intake-basic/contract.md

@@ -1,34 +1,34 @@
-# `intake-basic`
-
-P29 表名：`intake-basic`（不得改名）。层：baseline。
-
-## 职责
-
-事件式入口。在无选中任务、或新请求可能产生工作时，判断：直接回答（无 Task）/ 澄清 / 进池意图 / 建议开 Task，并带上建议的 Rigor（Lite|Full）与 Topology（single|parent-child）。建议 Topology 时必须带「有无可隔离单位」（写集 / 交付物能否切开）。产出 Open Proposal 形状，不创建 Task。无 `[Triage:]` 行。任务内跟进不重跑 Intake（除非显式切换/退出/新独立交付物/契约冲突）。
-
-## 触发/披露
-
-Baseline 装着，但只在 Intake 事件进入 Prompt。有 `selected_task` 且无冲突时，本块不进包。
-
-触发：无选中任务 | 新请求与当前 Task 冲突 | 用户显式要新 Task。
-
-Agent 看见：入口判断规则、Risk 初判标签（可解释，非黑箱分）、禁止未同意就 `task.py create` 的提醒（门本身在 approval）。建议 Topology 时先问/判「有无可隔离单位」：能指出 ≥2 个可隔离写集 → 倾向多个可 Close 的 Full 或 Full 扇出，**不默认 Parent**；要统一集成权威才建议 parent-child；指不出 → 倾向 single，并预期真·单写集要写 `serial_reason`。用户要开始实现**已 accepted** 池条目时，Open Proposal 必须带切片清单（写到该条目 `## 切片`：短名、`touches`、Lite/Full/Parent、并行或 `serial_reason`），未 Open 不建目录。开过大 Task（关不了 / 证不了 / `touches` 跨无关模块）必须建议按池拆分规则再拆；用户可坚持，但要写范围风险 / `serial_reason`。会话内已可直接做的小改仍可不进池。看不见五档梯子印、看不见 Parent 集成教战。
-
-用户看见：闲聊被直接回答；要开 Task 时看到形状建议（Lite/Full × single/parent-child）以及有无可隔离单位，被问是否 Open；未成形想法可被建议进池。
-
-派生摘要可内用，不得要求每回合打印 `[Triage:]`。
-
-## 停止条件
-
-- 输入：Intake 事件（无选中任务 / 冲突 / 显式要新 Task）。
-- 出口：无 Task（直接答）/ 澄清（Task 前，只澄清到「有没有工作」）/ 进池意图 / Open Proposal（Rigor×Topology + 有无可隔离单位 + 若来自已 accepted 池条目则含 `## 切片` 提案 + 理由）。
-- 不得写 `prd.md`、不得 archive、不得改代码。
-- 不得未同意就 `task.py create`。
-
-## 关掉必须消失
-
-开 Task 判断、形状建议、进池意图。Kernel 仍在，但没有入口模块。
-
-## 不得带走
-
-Open/Execute 人批（`approval-personal`）；池目录物化（`candidate-pool`）；Grill/Design（`define-basic` / `define-extended`）；Decompose 建 Child（`parent-child`，Intake 只可建议 Topology=parent-child）。
+# `intake-basic`
+
+P29 表名：`intake-basic`（不得改名）。层：baseline。
+
+## 职责
+
+事件式入口。在无选中任务、或新请求可能产生工作时，判断：直接回答（无 Task）/ 澄清 / 建议开 Task，并带上建议的 Rigor（Lite|Full）与 Topology（single|parent-child）。建议 Topology 时必须带「有无可隔离单位」（写集 / 交付物能否切开）。产出 Open Proposal 形状，不创建 Task。无 `[Triage:]` 行。任务内跟进不重跑 Intake（除非显式切换/退出/新独立交付物/契约冲突）。
+
+## 触发/披露
+
+Baseline 装着，但只在 Intake 事件进入 Prompt。有 `selected_task` 且无冲突时，本块不进包。
+
+触发：无选中任务 | 新请求与当前 Task 冲突 | 用户显式要新 Task。
+
+Agent 看见：入口判断规则、Risk 初判标签（可解释，非黑箱分）、禁止未同意就 `pactile task create` 的提醒（门本身在 approval）。建议 Topology 时先问/判「有无可隔离单位」：能指出 ≥2 个可隔离写集 → 倾向多个可 Close 的 Full 或 Full 扇出，**不默认 Parent**；要统一集成权威才建议 parent-child；指不出 → 倾向 single，并预期真·单写集要写 `serial_reason`。开过大 Task（关不了 / 证不了 / `touches` 跨无关模块）必须建议拆成更小的 Task；用户可坚持，但要写范围风险 / `serial_reason`。会话内已可直接做的小改仍不必开 Task。看不见五档梯子印、看不见 Parent 集成教战。
+
+用户看见：闲聊被直接回答；要开 Task 时看到形状建议（Lite/Full × single/parent-child）以及有无可隔离单位，被问是否 Open。
+
+派生摘要可内用，不得要求每回合打印 `[Triage:]`。
+
+## 停止条件
+
+- 输入：Intake 事件（无选中任务 / 冲突 / 显式要新 Task）。
+- 出口：无 Task（直接答）/ 澄清（Task 前，只澄清到「有没有工作」）/ Open Proposal（Rigor×Topology + 有无可隔离单位 + 理由）。
+- 不得写 `prd.md`、不得 archive、不得改代码。
+- 不得未同意就 `pactile task create`。
+
+## 关掉必须消失
+
+开 Task 判断、形状建议。Kernel 仍在，但没有入口模块。
+
+## 不得带走
+
+Open/Execute 人批（`approval-personal`）；Grill/Design（`define-basic` / `define-extended`）；Decompose 建 Child（`parent-child`，Intake 只可建议 Topology=parent-child）。

package/dist/templates/pactile/modules/observability-local/contract.md

@@ -1,31 +1,31 @@
-# `observability-local`
-
-P29 表名：`observability-local`（不得改名）。层：baseline。
-
-## 职责
-
-本地、只读消费式的可观测性。记录生命周期耗时、门的通过/失败、Return-to-Define、AC 覆盖、上下文包大小/重复、人工打断、Verify 后返工原因。默认不外发、不进 Session 包、不以 Token 估算或 Agent 调用次数当质量。评价回到节奏是否可靠、上下文是否浪费、有没有假绿、返工是否集中（与 P26 四轴一致）。不控制生命周期，不写 Kernel 核心状态。
-
-## 触发/披露
-
-永远可以记（被动、后台）。**永远不**作为第 2 层模块短契约进入默认 Prompt。用户问健康/返工、或 Close 需要引用本地事实时，由 `context-progressive` 按第 4 层缺口再取片段。不是监控产品、不是常驻仪表盘。
-
-Agent 看见：默认看不见本块教战。不得把「记了多少事件」写成任务已完成。平台没有 Token/成本数据时标 `unavailable`，不得编数字。
-
-用户看见：按需。日常 Open→Close 不出现可观测性配置。外发遥测必须显式 opt-in（本需求默认不做外发）。
-
-渐进：需要时才披露片段，从不常驻。
-
-## 停止条件
-
-- 输入：Kernel 审计、Gate、Evidence、编译器包元数据（大小/层/模块列表）。
-- 输出：本地事实记录。零 Prompt 是成功标准，不是缺陷。
-- 停止：把本块灌进 SessionStart；用虚荣指标代替 Evidence；默默上传。
-
-## 关掉必须消失
-
-不再记账。Open→Close 仍必须能走完（本块不是生命周期必需槽，是 Baseline 里的横切记录器）。
-
-## 不得带走
-
-Gate 是否通过（Kernel）；Evidence 正文（`verify-basic`）；为了「像模块」而占常驻包。
+# `observability-local`
+
+P29 表名：`observability-local`（不得改名）。层：baseline。
+
+## 职责
+
+本地、只读消费式的可观测性。记录生命周期耗时、门的通过/失败、Return-to-Define、AC 覆盖、上下文包大小/重复、人工打断、Verify 后返工原因。默认不外发、不进 Session 包、不以 Token 估算或 Agent 调用次数当质量。评价回到节奏是否可靠、上下文是否浪费、有没有假绿、返工是否集中（与 P26 四轴一致）。不控制生命周期，不写 Kernel 核心状态。
+
+## 触发/披露
+
+永远可以记（被动、后台）。**永远不**作为第 2 层模块短契约进入默认 Prompt。用户问健康/返工、或 Close 需要引用本地事实时，由 `context-progressive` 按第 4 层缺口再取片段。不是监控产品、不是常驻仪表盘。
+
+Agent 看见：默认看不见本块教战。不得把「记了多少事件」写成任务已完成。平台没有 Token/成本数据时标 `unavailable`，不得编数字。
+
+用户看见：按需。日常 Open→Close 不出现可观测性配置。外发遥测必须显式 opt-in（本需求默认不做外发）。
+
+渐进：需要时才披露片段，从不常驻。
+
+## 停止条件
+
+- 输入：Kernel 审计、Gate、Evidence、编译器包元数据（大小/层/模块列表）。
+- 输出：本地事实记录。零 Prompt 是成功标准，不是缺陷。
+- 停止：把本块灌进 SessionStart；用虚荣指标代替 Evidence；默默上传。
+
+## 关掉必须消失
+
+不再记账。Open→Close 仍必须能走完（本块不是生命周期必需槽，是 Baseline 里的横切记录器）。
+
+## 不得带走
+
+Gate 是否通过（Kernel）；Evidence 正文（`verify-basic`）；为了「像模块」而占常驻包。

package/dist/templates/pactile/modules/parent-child/contract.md

@@ -1,45 +1,45 @@
-# `parent-child`
-
-P29 表名：`parent-child`（不得改名）。层：on-demand。
-
-## 职责
-
-拓扑模块。把「一件事拆成可独立验收的多交付物」变成单父树，并提供 **Integrate** 槽的行为（Kernel 仍写 Phase/依赖图；本块提供 Decompose、边界、集成权威与 `integration-handoff`）。Parent 握总需求、Child 边界、集成权、最终 Evidence；默认不直接写功能代码。Child 是独立 Task：自己的生命周期、自己的 Rigor。Decompose **只出提案**，用户确认后才建 Child。依赖图投影为 `task-map`（人读）；依赖管 readiness，不调度、不表达所有权。
-
-## 触发/披露
-
-未触发当没装。Single 的 Open→Close 全程不见本块、不见 Integrate 阶段名。触发（可审计）：
-
-1. Open Proposal 的 Topology 已批为 parent-child；或
-2. 已选中任务出现 ≥2 个可独立演示的交付物，建议拆分；或
-3. 用户明确要求拆 Parent/Child。
-
-**不是**触发：Rigor=Full；文件多、耗时长。个人默认只暴露 **一层**（Parent + 其 Child）；Kernel 允许更深嵌套，本 Profile 短契约不教孙任务 Decompose。
-
-非 Parent/非拆分窗口不进包。Child 会话只带该 Child 合同 + 与 Parent 的边界，不灌整棵树教战。
-
-Agent 看见：
-
-1. Decompose 产出：纵向切片边界、依赖、每 Child 的 Acceptance、冲突面、集成点。未获人确认不得 `create --parent` / 挂 Child。
-2. Child 不得 `integrate-child`，不得把自己标成 accepted / integrating / integrated / cancelled。Child 交付 = Verify 完成 + `integration-handoff`。只有 Parent 做 Integrate。
-3. Parent 未把每个结构性 Child 标成 integrated 或 cancelled，不得 Close（`close-basic` 已遵守此因果）。
-4. Parent 与 Child 各自 Lite/Full；Parent 常建议 Full，但不与 Full 绑定。拓扑叠加的是 task-map、Child Evidence、Integration Gate，不是自动 Independent Check。
-5. 并行声明（可并行组 / 合并点 / 冲突面）写在 task-map；HITL、Execute 门、Check、`integrate-child` 仍串行。默认 `merge_limit: 1`。串行执行须写 `serial_reason`。真正 spawn 工人仅当 `worker-orchestration` 同时激活；否则 Child 走 inline 或顺序会话。
-6. 跨树关系走 Kernel 依赖图（`requires` 硬前置 / advisory 提示）。默认 advisory；硬挡是 Policy/opt-in，不是本块调度器。
-
-用户看见：只有多交付物或主动要拆时才出现 Parent/Child 与 Integrate。Lite Single 看起来仍是一条直线。没有「拆了才算 Full」。
-
-## 停止条件
-
-- 触发与非触发；个人默认一层。
-- Decompose 提案形状；建 Child 必须先确认。Decompose 先提案，未确认不得建 Child。
-- 权威：Parent 独有 Integrate；Child 独有自身 Verify + handoff。
-- 停止：未激活仍讲 task-map / integrate-child；Child 自集成；把依赖当调度器；把 Parent 当 Full 的同义词；未确认就建 Child。
-
-## 关掉必须消失
-
-无 Decompose、无建 Child、无 task-map 教战、无 Integrate 阶段叙事、无集成权。Intake 仍可在 Open Proposal 里**建议** Topology=parent-child，但无处落地。Full Single 仍合法。
-
-## 不得带走
-
-Kernel 的 `topology` / `parent_id` / 合法 Integrate 边（Kernel 单写）；工人派工（`worker-orchestration`）；Git worktree 命令细节（`vcs-integration`，本块只要求 Child 可隔离交付）；跨窗 `/pactile-handoff`（`session-transfer`）；池条目（`candidate-pool`）。
+# `parent-child`
+
+P29 表名：`parent-child`（不得改名）。层：on-demand。
+
+## 职责
+
+拓扑模块。把「一件事拆成可独立验收的多交付物」变成单父树，并提供 **Integrate** 槽的行为（Kernel 仍写 Phase/依赖图；本块提供 Decompose、边界、集成权威与 `integration-handoff`）。Parent 握总需求、Child 边界、集成权、最终 Evidence；默认不直接写功能代码。Child 是独立 Task：自己的生命周期、自己的 Rigor。Decompose **只出提案**，用户确认后才建 Child。依赖图投影为 `task-map`（人读）；依赖管 readiness，不调度、不表达所有权。
+
+## 触发/披露
+
+未触发当没装。Single 的 Open→Close 全程不见本块、不见 Integrate 阶段名。触发（可审计）：
+
+1. Open Proposal 的 Topology 已批为 parent-child；或
+2. 已选中任务出现 ≥2 个可独立演示的交付物，建议拆分；或
+3. 用户明确要求拆 Parent/Child。
+
+**不是**触发：Rigor=Full；文件多、耗时长。个人默认只暴露 **一层**（Parent + 其 Child）；Kernel 允许更深嵌套，本 Profile 短契约不教孙任务 Decompose。
+
+非 Parent/非拆分窗口不进包。Child 会话只带该 Child 合同 + 与 Parent 的边界，不灌整棵树教战。
+
+Agent 看见：
+
+1. Decompose 产出：纵向切片边界、依赖、每 Child 的 Acceptance、冲突面、集成点。未获人确认不得 `create --parent` / 挂 Child。
+2. Child 不得 `integrate-child`，不得把自己标成 accepted / integrating / integrated / cancelled。Child 交付 = Verify 完成 + `integration-handoff`。只有 Parent 做 Integrate。
+3. Parent 未把每个结构性 Child 标成 integrated 或 cancelled，不得 Close（`close-basic` 已遵守此因果）。
+4. Parent 与 Child 各自 Lite/Full；Parent 常建议 Full，但不与 Full 绑定。拓扑叠加的是 task-map、Child Evidence、Integration Gate，不是自动 Independent Check。
+5. 并行声明（可并行组 / 合并点 / 冲突面）写在 task-map；HITL、Execute 门、Check、`integrate-child` 仍串行。默认 `merge_limit: 1`。串行执行须写 `serial_reason`。真正 spawn 工人仅当 `worker-orchestration` 同时激活；否则 Child 走 inline 或顺序会话。
+6. 跨树关系走 Kernel 依赖图（`requires` 硬前置 / advisory 提示）。默认 advisory；硬挡是 Policy/opt-in，不是本块调度器。
+
+用户看见：只有多交付物或主动要拆时才出现 Parent/Child 与 Integrate。Lite Single 看起来仍是一条直线。没有「拆了才算 Full」。
+
+## 停止条件
+
+- 触发与非触发；个人默认一层。
+- Decompose 提案形状；建 Child 必须先确认。Decompose 先提案，未确认不得建 Child。
+- 权威：Parent 独有 Integrate；Child 独有自身 Verify + handoff。
+- 停止：未激活仍讲 task-map / integrate-child；Child 自集成；把依赖当调度器；把 Parent 当 Full 的同义词；未确认就建 Child。
+
+## 关掉必须消失
+
+无 Decompose、无建 Child、无 task-map 教战、无 Integrate 阶段叙事、无集成权。Intake 仍可在 Open Proposal 里**建议** Topology=parent-child，但无处落地。Full Single 仍合法。
+
+## 不得带走
+
+Kernel 的 `topology` / `parent_id` / 合法 Integrate 边（Kernel 单写）；工人派工（`worker-orchestration`）；Git worktree 命令细节（`vcs-integration`，本块只要求 Child 可隔离交付）；跨窗 `/pactile-handoff`（`session-transfer`）。