@blxzer/pactile 0.5.0 → 0.6.0-beta.4

package/dist/templates/pactile/modules/personal-memory/contract.md

@@ -1,56 +1,56 @@
-# `personal-memory`
-
-P29 表名：`personal-memory`（不得改名）。层：on-demand。
-
-## 职责
-
-跨 Task 的可搜索个人记忆。默认 **Task-first**：续作先读当前/归档任务产物、Kernel 审计、Close 摘要。Journal 不是 Baseline，不常驻注入 Session 包。本块按需提供：检索「上次…」跨任务记忆；可选地在用户要记下时才 Capture 一条；**Close 收尾时由机器写入 Notes 索引投影**（非正文，详见「Close Notes 索引投影」）。安装不预建默认 Journal。Developer Identity（路径用的开发者 id）可以在安装时存在，但不等于本块已激活，也不进每回合 Prompt。
-
-### Close Notes 索引投影
-
-Close 边界按学习 disposition 写 Notes 索引投影（`note-projection`，见 `close-basic`）：**≤N token 的摘要 + 路径指针**（N 由 S2/P1 定，占位不填值），进 `context-progressive` **第 4 层检索**，**不常驻注入**（不进第 2 层常驻）。
-
-**投影 ≠ journal 正文**：
-
-| 轨 | 谁写 | 形态 | 供谁 |
-| --- | --- | --- | --- |
-| Notes 索引投影 | 机器（Close 自动） | ≤N token 摘要 + 路径指针 | 供检索 |
-| journal 正文 | Agent 主动 | 完整正文 | 供阅读 |
-
-二者不同轨。投影是机器在 Close 边界旁路写入的槽位，不要求 Agent 每次收工「写日记」，也不进常驻 Prompt；journal 仍是"首次 Capture 才物化"、"Journal 不是 Evidence"的既有语义，本条款只额外给了一把机器自动写的检索钥匙，不改变 journal 的物化与地位。
-
-## 触发/披露
-
-未触发当没装。日常 Open→Close 只靠任务目录。触发（可审计）：
-
-1. 用户问跨任务的「上次 / 我们是不是说过 / 搜 journal」；或
-2. 用户明确要记一条跨任务备忘。
-
-**不是**触发：有 `selected_task` 的普通续作（Continue / 任务产物即可）；SessionStart；Close 强制写 journal。
-
-问完/记下后从常驻包消失。
-
-Agent 看见：
-
-1. 有选中任务时，先读该任务产物。不得用 journal 代替 PRD/Evidence。
-2. 跨任务才搜记忆；命中以路径+短摘要进第 4 层，不把 journal 全文灌进第 2 层。
-3. 首次 Capture 才物化 `.pactile/workspace/<id>/journal-*.md`。未激活不得在 SessionStart 打印 journal 行数当教战。
-4. Journal 不是 Evidence、不是长期 spec、不是 session-transfer 过境文档。
-5. `init_developer` / `.developer` 若已存在，只用于路径；不因此加载本块正文。
-
-用户看见：只有主动回忆或要记下时才出现记忆搜索。没有常驻「日记必须写」的仪式。新安装可以没有 journal 文件。Notes 索引投影是机器在 Close 边界自动写的，用户只在需要时（如未来窗口检索）看到它，收工时不机械问「要不要写记忆」。
-
-## 停止条件
-
-- Task-first vs 跨任务搜索的分界。
-- 触发与非触发；首次 Capture 才物化。
-- Notes 索引投影：走第 4 层检索、不进第 2 层常驻；缺投影槽与缺 journal 都不挡 Close（Close 只留痕）。
-- 停止：SessionStart 注入 journal 正文或当方法论；把 Notes 投影当 journal 正文常驻注入；用 journal 或投影当 Close 完成条件；用记忆代替任务 SSOT；安装预建空 journal。
-
-## 关掉必须消失
-
-不注入 journal、不做跨 Task 记忆检索、不要求写日记。`.pactile/tasks/`、Continue、`selected_task` 仍在。Identity 文件可以留着当路径，不进 Prompt。
-
-## 不得带走
-
+# `personal-memory`
+
+P29 表名：`personal-memory`（不得改名）。层：on-demand。
+
+## 职责
+
+跨 Task 的可搜索个人记忆。默认 **Task-first**：续作先读当前/归档任务产物、Kernel 审计、Close 摘要。Journal 不是 Baseline，不常驻注入 Session 包。本块按需提供：检索「上次…」跨任务记忆；可选地在用户要记下时才 Capture 一条；**Close 收尾时由机器写入 Notes 索引投影**（非正文，详见「Close Notes 索引投影」）。安装不预建默认 Journal。Developer Identity（路径用的开发者 id）可以在安装时存在，但不等于本块已激活，也不进每回合 Prompt。
+
+### Close Notes 索引投影
+
+Close 边界按学习 disposition 写 Notes 索引投影（`note-projection`，见 `close-basic`）：**≤N token 的摘要 + 路径指针**（N 由 S2/P1 定，占位不填值），进 `context-progressive` **第 4 层检索**，**不常驻注入**（不进第 2 层常驻）。
+
+**投影 ≠ journal 正文**：
+
+| 轨 | 谁写 | 形态 | 供谁 |
+| --- | --- | --- | --- |
+| Notes 索引投影 | 机器（Close 自动） | ≤N token 摘要 + 路径指针 | 供检索 |
+| journal 正文 | Agent 主动 | 完整正文 | 供阅读 |
+
+二者不同轨。投影是机器在 Close 边界旁路写入的槽位，不要求 Agent 每次收工「写日记」，也不进常驻 Prompt；journal 仍是"首次 Capture 才物化"、"Journal 不是 Evidence"的既有语义，本条款只额外给了一把机器自动写的检索钥匙，不改变 journal 的物化与地位。
+
+## 触发/披露
+
+未触发当没装。日常 Open→Close 只靠任务目录。触发（可审计）：
+
+1. 用户问跨任务的「上次 / 我们是不是说过 / 搜 journal」；或
+2. 用户明确要记一条跨任务备忘。
+
+**不是**触发：有 `selected_task` 的普通续作（Continue / 任务产物即可）；SessionStart；Close 强制写 journal。
+
+问完/记下后从常驻包消失。
+
+Agent 看见：
+
+1. 有选中任务时，先读该任务产物。不得用 journal 代替 PRD/Evidence。
+2. 跨任务才搜记忆；命中以路径+短摘要进第 4 层，不把 journal 全文灌进第 2 层。
+3. 首次 Capture 才物化 `.pactile/workspace/<id>/journal-*.md`。未激活不得在 SessionStart 打印 journal 行数当教战。
+4. Journal 不是 Evidence、不是长期 spec、不是 session-transfer 过境文档。
+5. `init_developer` / `.developer` 若已存在，只用于路径；不因此加载本块正文。
+
+用户看见：只有主动回忆或要记下时才出现记忆搜索。没有常驻「日记必须写」的仪式。新安装可以没有 journal 文件。Notes 索引投影是机器在 Close 边界自动写的，用户只在需要时（如未来窗口检索）看到它，收工时不机械问「要不要写记忆」。
+
+## 停止条件
+
+- Task-first vs 跨任务搜索的分界。
+- 触发与非触发；首次 Capture 才物化。
+- Notes 索引投影：走第 4 层检索、不进第 2 层常驻；缺投影槽与缺 journal 都不挡 Close（Close 只留痕）。
+- 停止：SessionStart 注入 journal 正文或当方法论；把 Notes 投影当 journal 正文常驻注入；用 journal 或投影当 Close 完成条件；用记忆代替任务 SSOT；安装预建空 journal。
+
+## 关掉必须消失
+
+不注入 journal、不做跨 Task 记忆检索、不要求写日记。`.pactile/tasks/`、Continue、`selected_task` 仍在。Identity 文件可以留着当路径，不进 Prompt。
+
+## 不得带走
+
 任务产物与审计（Kernel / `close-basic`）；过境 handoff（`session-transfer`）；长期 spec（`spec-learning`）；编译器常驻包（`context-progressive`）；检索 pack（`retrieval-extended`）。

package/dist/templates/pactile/modules/retention-storage/contract.md

@@ -1,43 +1,43 @@
-# `retention-storage`
-
-P29 表名：`retention-storage`（不得改名）。层：on-demand。
-
-## 职责
-
-Closed Task 的**物理**处置：目录搬家（如 `archive/`）、压缩、保留期限、冷存储。不写业务 Outcome，不撤销 Close。Close 与 Archive 分离：`close-basic` 完成生命周期；本块可以在 Close **之后**跑。Retention 失败不得改 Outcome；只留下 Condition / 修复证据。本需求**不包含** Event Sourcing；更高级存储若将来出现，也只是 Policy 可选实现，不是完成条件。
-
-## 触发/披露
-
-维护者 / 磁盘策略。Agent 日常 Open→Execute→Verify **不看见**本块。触发（可审计）：
-
-1. Outcome 已写入之后的物理收纳；或
-2. 维护者明确要压缩/清理；或
-3. Policy 的保留期限到期。
-
-**不是**触发：把 `task.py archive` 当成 Close；Execute 当天；用搬家证明做完了。
-
-永远不进默认 Prompt 第 2 层（可与 `observability-local` 类似：零教战成功）。
-
-Agent 看见：
-
-1. 不得用「目录已在 archive/」宣称 completed。
-2. 不得在未 Close 时搬走活任务目录。
-3. 删除、覆盖原目录、不可逆压缩：先问（人 / Policy）。个人默认搬家不是静默删除。
-4. 搬家后若路径变了，通知 Kernel 更新投影；本块不写 Phase/Outcome。
-5. 不拥有 Git；不拥有 session temp handoff。
-
-用户看见：日常收工只关心 Outcome。磁盘策略、压缩、过期清理不出现在每回合。关掉本块时，Closed Task 可以留在原地。
-
-## 停止条件
-
-- Close 已完成才可物理处置。
-- 失败不回滚 Outcome。
-- 停止：物理搬家冒充 Close；未 Close 就 archive；静默删除用户工作；把 Event Sourcing 当成本需求验收。
-
-## 关掉必须消失
-
-不能把搬家当完成条件。Outcome 照写。活任务目录不被本块搬走。CLI 仍可有业务 Close，只是不移动文件。
-
-## 不得带走
-
-业务 Close / Outcome（`close-basic`）；Git commit（`vcs-integration`）；过境文档（`session-transfer`）；journal（`personal-memory`）。
+# `retention-storage`
+
+P29 表名：`retention-storage`（不得改名）。层：on-demand。
+
+## 职责
+
+Closed Task 的**物理**处置：目录搬家（如 `archive/`）、压缩、保留期限、冷存储。不写业务 Outcome，不撤销 Close。Close 与 Archive 分离：`close-basic` 完成生命周期；本块可以在 Close **之后**跑。Retention 失败不得改 Outcome；只留下 Condition / 修复证据。本需求**不包含** Event Sourcing；更高级存储若将来出现，也只是 Policy 可选实现，不是完成条件。
+
+## 触发/披露
+
+维护者 / 磁盘策略。Agent 日常 Open→Execute→Verify **不看见**本块。触发（可审计）：
+
+1. Outcome 已写入之后的物理收纳；或
+2. 维护者明确要压缩/清理；或
+3. Policy 的保留期限到期。
+
+**不是**触发：把 `pactile task archive` 当成 Close；Execute 当天；用搬家证明做完了。
+
+永远不进默认 Prompt 第 2 层（可与 `observability-local` 类似：零教战成功）。
+
+Agent 看见：
+
+1. 不得用「目录已在 archive/」宣称 completed。
+2. 不得在未 Close 时搬走活任务目录。
+3. 删除、覆盖原目录、不可逆压缩：先问（人 / Policy）。个人默认搬家不是静默删除。
+4. 搬家后若路径变了，通知 Kernel 更新投影；本块不写 Phase/Outcome。
+5. 不拥有 Git；不拥有 session temp handoff。
+
+用户看见：日常收工只关心 Outcome。磁盘策略、压缩、过期清理不出现在每回合。关掉本块时，Closed Task 可以留在原地。
+
+## 停止条件
+
+- Close 已完成才可物理处置。
+- 失败不回滚 Outcome。
+- 停止：物理搬家冒充 Close；未 Close 就 archive；静默删除用户工作；把 Event Sourcing 当成本需求验收。
+
+## 关掉必须消失
+
+不能把搬家当完成条件。Outcome 照写。活任务目录不被本块搬走。CLI 仍可有业务 Close，只是不移动文件。
+
+## 不得带走
+
+业务 Close / Outcome（`close-basic`）；Git commit（`vcs-integration`）；过境文档（`session-transfer`）；journal（`personal-memory`）。

package/dist/templates/pactile/modules/retrieval-extended/contract.md

@@ -1,77 +1,78 @@
-# `retrieval-extended`
-
-P29 表名：`retrieval-extended`（不得改名）。层：on-demand。
-
-## 职责
-
-对**已经收集到的**证据做评分、排序、retrieval pack、probe/matrix。它是检索质量层，不是搜索引擎，也不是薄路由。个人默认不把评测栈灌进每个 Task。后续检索优化的**产品落点**是本块内部 + Middleware Provider，不是再写一部上帝检索文档。
-
-## 触发/披露
-
-未触发当没装。Lite 日常 `rg` / 一次 cheap 外部查询看不见本块。触发（可审计）：
-
-1. 任务目录里已有 research / 多源证据，需要 ranking 或收口引用；或
-2. `define-extended` 深研结束，要打 pack 而不是再搜一轮；或
-3. 维护者跑 probe / 评测矩阵。
-
-**不是**触发：每个用户回合；第一次字面搜索；第一次外部知识探测；仓库装着 codegraph / fast-context。
-
-打分窗口结束，本块从常驻包消失。
-
-Agent 看见：
-
-1. 搜索 ≠ 打分。没有收集到的材料，不得空跑 pack 充 Evidence。
-2. 命中是候选，直到被仓库 / 测试 / 第二源证实。Pack 整理已有材料的质量与来源，不代替 `verify-basic` 的 AC 映射。
-3. 钩 `inject-retrieval-plan.py` / `research-end-retrieval-pack.py` 仅本块激活时订阅；后者还要有 research 产物。Cursor `additional_context` 经常到不了模型：通道失败时只记 assurance / 本地遥测，**不得**假装计划已进 Prompt。成功标准是该打分时打分，不是每回合强制注入计划。
-4. 四意图标签来自编译器；本块不把 Agent 工具名（Grep、@codebase、codegraph、WebSearch…）写进 Baseline。Optional Provider 只有 Profile 选了才由 Adapter 绑定。
-5. 需要外部知识而 Provider 未就绪：走 Middleware 降级（平台 Web ≠ 等价）。不需要外部知识的 Task 仍可 Close。本块不实现爬虫。
-
-用户看见：普通 Lite 不出现矩阵、pack、per-prompt 计划。没有常驻检索配置向导。维护者评测是另一条面。
-
-## 停止条件
-
-- 三层分界见下方 ABI 表。
-- 输入产物：`collected-evidence`（路径 + provider 标签 + 可选 freshness）。输出产物：`retrieval-pack`（排序、分数、provenance）；可选 `probe-report`（维护者）。
-- 停止：未激活仍灌检索教战或 stop 打分钩；把 pack 当 AC Evidence；把 smart-search 收进本块；每回合强制检索计划；通道失败却声称已注入。
-- 评分算法细节用指针，不在本块另写上帝文档。算法/ranking 特征/pack schema 版本属于本块内部，后续可改。
-
-## 关掉必须消失
-
-无 pack、无 per-prompt 检索计划、无 stop 打分钩。四意图路由仍在；smart-search 仍可按需。不需要外部知识的 Open→Close 仍成立。
-
-## 不得带走
-
-薄 router（`context-progressive`）；smart-search 本体与就绪（Middleware）；要不要研、写到哪（`define-extended`）；journal 搜索（`personal-memory`）；AC→Evidence（`verify-basic`）。
-
-## 检索三层 ABI
-
-冻结。后续优化检索时不得拆掉，否则会重新变成上帝文档。
-
-| 层 | Owner | 认什么 | 不认什么 |
-| --- | --- | --- | --- |
-| 意图 | `context-progressive` | `exact` / `semantic` / `structural` / `external` | 工具名、分数、pack、每回合计划 |
-| 提供 | Middleware | capability 就绪与降级；默认 `external-knowledge` → smart-search；Optional 的 codegraph / fast-context 经 Profile 选择 | PACTILE Kernel 发版锁步；平台 Web 冒充等价 |
-| 质量 | `retrieval-extended` | 对已收集证据打分、pack、probe | 自己去搜；自己当 Close Evidence |
-
-不新增第五个常驻检索意图，除非同时改编译器契约。
-
-## 后续不可改
-
-后续优化**可以**改（不必回头改本重构的生命周期）：
-
-- 本块内部的评分算法、ranking 特征、pack schema 版本。
-- 维护者 probe / 评测矩阵。
-- 新 Optional Provider：Manifest + Adapter 绑定到已有意图，不新增第五个常驻意图，除非同时改编译器契约。
-- 注入通道：Cursor 若将来能稳定送达检索计划，本块消费；不能则继续 telemetry，产品不假绿。
-- smart-search 独立发版、独立 CLI。
-
-后续优化**不可以**改（改了等于放弃模块化）：
-
-- 把旧 8 意图或工具名写回 Baseline 常驻 Prompt。
-- 把 smart-search 收进 Kernel / 本块 / `pactile update` 锁步。
-- 每个回合强制 pack 或强制 `beforeSubmitPrompt` 计划。
-- 用 pack 代替 `verify-basic`。
-- 把 `retrieval-daily-guide.md` 当 SessionStart SSOT。
-- 为了「检索好改」把三层重新合并进 `workflow.md`。
-
-现状债务（优化时面对；本需求不假装已修好）：`inject-retrieval-plan.py` 目前常是 telemetry；旧路由器仍带多于四意图的执行细节；搜索与 pack 在文档里仍易混用；codegraph / fast-context 曾被当成默认。完成态是所有权先分清，再在本块和 Provider 里演进算法。
+# `retrieval-extended`
+
+P29 表名：`retrieval-extended`（不得改名）。层：on-demand。
+
+## 职责
+
+对**已经收集到的**证据做评分、排序、retrieval pack、probe/matrix。它是检索质量层，不是搜索引擎，也不是薄路由。个人默认不把评测栈灌进每个 Task。后续检索优化的**产品落点**是本块内部 + Middleware Provider，不是再写一部上帝检索文档。
+
+## 触发/披露
+
+未触发当没装。Lite 日常 `rg` / 一次 cheap 外部查询看不见本块。触发（可审计）：
+
+1. 任务目录里已有 research / 多源证据，需要 ranking 或收口引用；或
+2. `define-extended` 深研结束，要打 pack 而不是再搜一轮；或
+3. 维护者跑 probe / 评测矩阵。
+
+**不是**触发：每个用户回合；第一次字面搜索；第一次外部知识探测；仓库装着 codegraph / fast-context。
+
+打分窗口结束，本块从常驻包消失。
+
+Agent 看见：
+
+1. 搜索 ≠ 打分。没有收集到的材料，不得空跑 pack 充 Evidence。
+2. 命中是候选，直到被仓库 / 测试 / 第二源证实。Pack 整理已有材料的质量与来源，不代替 `verify-basic` 的 AC 映射。
+3. 检索计划和 evidence pack 只在本块激活且有 research 产物时生成。桥接传递失败时只记 assurance / 本地遥测，**不得**假装计划已进 Prompt。成功标准是该打分时打分，不是每回合强制注入计划。
+4. 四意图标签来自编译器；本块不把 Agent 工具名（Grep、@codebase、codegraph、WebSearch…）写进 Baseline。Optional Provider 只有 Profile 选了才由 Adapter 绑定。
+5. 需要外部知识而 Provider 未就绪：走 Middleware 降级（平台 Web ≠ 等价）。不需要外部知识的 Task 仍可 Close。本块不实现爬虫。
+
+用户看见：普通 Lite 不出现矩阵、pack、per-prompt 计划。没有常驻检索配置向导。维护者评测是另一条面。
+
+## 停止条件
+
+- 三层分界见下方 ABI 表。
+- 输入产物：`collected-evidence`（路径 + provider 标签 + 可选 freshness）。输出产物：`retrieval-pack`（排序、分数、provenance）；可选 `probe-report`（维护者）。
+- Node 入口：`pactile context --mode retrieval-pack --input <collected-evidence.json> --max-items 8 --output {TASK}/research/retrieval-pack-latest.json --json`；输入 `items[]` 或 `collectedEvidence[]`，每项提供 `path`、`provider`。只处理已有材料；`--include-diagnostics` 才把失败/不可用项纳入 pack 正文。默认排除这些项，且 `closeEvidenceEligible=false`。
+- 停止：未激活仍灌检索教战或 stop 打分钩；把 pack 当 AC Evidence；把 smart-search 收进本块；每回合强制检索计划；通道失败却声称已注入。
+- 评分算法细节用指针，不在本块另写上帝文档。算法/ranking 特征/pack schema 版本属于本块内部，后续可改。
+
+## 关掉必须消失
+
+无 pack、无 per-prompt 检索计划、无 stop 打分钩。四意图路由仍在；smart-search 仍可按需。不需要外部知识的 Open→Close 仍成立。
+
+## 不得带走
+
+薄 router（`context-progressive`）；smart-search 本体与就绪（Middleware）；要不要研、写到哪（`define-extended`）；journal 搜索（`personal-memory`）；AC→Evidence（`verify-basic`）。
+
+## 检索三层 ABI
+
+冻结。后续优化检索时不得拆掉，否则会重新变成上帝文档。
+
+| 层 | Owner | 认什么 | 不认什么 |
+| --- | --- | --- | --- |
+| 意图 | `context-progressive` | `exact` / `semantic` / `structural` / `external` | 工具名、分数、pack、每回合计划 |
+| 提供 | Middleware | capability 就绪与降级；默认 `external-knowledge` → smart-search；Optional 的 codegraph / fast-context 经 Profile 选择 | PACTILE Kernel 发版锁步；平台 Web 冒充等价 |
+| 质量 | `retrieval-extended` | 对已收集证据打分、pack、probe | 自己去搜；自己当 Close Evidence |
+
+不新增第五个常驻检索意图，除非同时改编译器契约。
+
+## 后续不可改
+
+后续优化**可以**改（不必回头改本重构的生命周期）：
+
+- 本块内部的评分算法、ranking 特征、pack schema 版本。
+- 维护者 probe / 评测矩阵。
+- 新 Optional Provider：Manifest + Adapter 绑定到已有意图，不新增第五个常驻意图，除非同时改编译器契约。
+- 注入通道：仅在宿主已验证交付检索计划后消费；不能则记录未交付状态，产品不假绿。
+- smart-search 独立发版、独立 CLI。
+
+后续优化**不可以**改（改了等于放弃模块化）：
+
+- 把旧 8 意图或工具名写回 Baseline 常驻 Prompt。
+- 把 smart-search 收进 Kernel / 本块 / `pactile update` 锁步。
+- 每个回合强制 pack 或强制 `beforeSubmitPrompt` 计划。
+- 用 pack 代替 `verify-basic`。
+- 把 `retrieval-daily-guide.md` 当 SessionStart SSOT。
+- 为了「检索好改」把三层重新合并进 `workflow.md`。
+
+现状债务：Node 检索路由、证据打分与桥接仍需统一；搜索与 pack 在文档里仍易混用。完成态是所有权先分清，再在本块和 Provider 里演进算法。

package/dist/templates/pactile/modules/session-transfer/contract.md

@@ -1,41 +1,41 @@
-# `session-transfer`
-
-P29 表名：`session-transfer`（不得改名）。层：on-demand。
-
-## 职责
-
-把**还在飞的工作**搬到另一个会话 / 人 / 宿主 / 目录。产出一份一次性过境文档（默认写 OS temp，不进仓库、不当任务证据）。`/pactile-handoff` 是 Adapter 的平台入口；本块拥有正文契约（何时搬、写什么、不写什么）。与 Child 的 `integration-handoff`（任务目录里的集成证据）分 owner。不是 Continue，不是 Compact，不是派工包。
-
-## 触发/披露
-
-未触发当没装。日常 Open→Close、同窗继续，看不见本块。触发（可审计）：用户显式要搬走，或阶段边界判定「工作需要旅行」（换宿主、换目录/仓、交给同事、分叉旁路）。
-
-**不是**触发：同宿主同目录接着做（Continue / Compact）；派一个工人（`worker-orchestration`）；Child 向 Parent 交集成证据（`parent-child`）；Close 收尾。
-
-写完并交出路径后，本块教战从常驻包消失。
-
-Agent 看见：
-
-1. 先问清下一会话用途，按用途裁剪「为什么」，不整段复制会话。
-2. 写 temp 文件，回报**完整绝对路径**，并提醒 temp 易挥发。需要跨小时/跨宿主时，请用户立刻拷到耐久位置。
-3. 只引用磁盘路径（任务目录、spec、ADR、commit），不粘贴 PRD/diff 正文。密钥/token/PII → `<REDACTED>`。事实与未验证信念必须分开写。
-4. 不得写入 `.pactile/tasks/<dir>/handoff.md` 冒充集成证据；不得把过境文档当长期 spec。
-5. 不得用 shell 引号把全文塞给下一个 Agent（截断）。下一个 Agent 去读文件路径。
-6. 不自动 hook 交接；不在 Close 时强制写一份。
-
-用户看见：少数逃生舱之一。用时得到一条 temp 路径。同窗接着做只用 Continue，不出现本块。
-
-## 停止条件
-
-- 触发与非触发（五问里本块只占 Handoff）。
-- 产出位置（OS temp）与必须回报绝对路径。
-- 内容角色：Goal / Done / Blocked / Next / 按用途裁过的 whys / Facts vs beliefs / 指针。
-- 停止：与 `integration-handoff` 混用；同窗续做却写 handoff；把过境文档当任务证据或长期记忆；泄露密钥。
-
-## 关掉必须消失
-
-不能生成跨窗过境文档、Prompt 无搬运教战。Continue / Compact / 选中任务指针仍在。Parent 集成交接若 `parent-child` 开着仍在。
-
-## 不得带走
-
-`integration-handoff` 与集成权（`parent-child`）；Continue 与窗口标题（Adapter）；`selected_task`（Kernel）；工人派工包（`worker-orchestration`）；journal 跨 Task 记忆（`personal-memory`）；物理 archive（`retention-storage`）。
+# `session-transfer`
+
+P29 表名：`session-transfer`（不得改名）。层：on-demand。
+
+## 职责
+
+把**还在飞的工作**搬到另一个会话 / 人 / 宿主 / 目录。产出一份一次性过境文档（默认写 OS temp，不进仓库、不当任务证据）。`/pactile-handoff` 是 Adapter 的平台入口；本块拥有正文契约（何时搬、写什么、不写什么）。与 Child 的 `integration-handoff`（任务目录里的集成证据）分 owner。不是 Continue，不是 Compact，不是派工包。
+
+## 触发/披露
+
+未触发当没装。日常 Open→Close、同窗继续，看不见本块。触发（可审计）：用户显式要搬走，或阶段边界判定「工作需要旅行」（换宿主、换目录/仓、交给同事、分叉旁路）。
+
+**不是**触发：同宿主同目录接着做（Continue / Compact）；派一个工人（`worker-orchestration`）；Child 向 Parent 交集成证据（`parent-child`）；Close 收尾。
+
+写完并交出路径后，本块教战从常驻包消失。
+
+Agent 看见：
+
+1. 先问清下一会话用途，按用途裁剪「为什么」，不整段复制会话。
+2. 写 temp 文件，回报**完整绝对路径**，并提醒 temp 易挥发。需要跨小时/跨宿主时，请用户立刻拷到耐久位置。
+3. 只引用磁盘路径（任务目录、spec、ADR、commit），不粘贴 PRD/diff 正文。密钥/token/PII → `<REDACTED>`。事实与未验证信念必须分开写。
+4. 不得写入 `.pactile/tasks/<dir>/handoff.md` 冒充集成证据；不得把过境文档当长期 spec。
+5. 不得用 shell 引号把全文塞给下一个 Agent（截断）。下一个 Agent 去读文件路径。
+6. 不自动 hook 交接；不在 Close 时强制写一份。
+
+用户看见：少数逃生舱之一。用时得到一条 temp 路径。同窗接着做只用 Continue，不出现本块。
+
+## 停止条件
+
+- 触发与非触发（五问里本块只占 Handoff）。
+- 产出位置（OS temp）与必须回报绝对路径。
+- 内容角色：Goal / Done / Blocked / Next / 按用途裁过的 whys / Facts vs beliefs / 指针。
+- 停止：与 `integration-handoff` 混用；同窗续做却写 handoff；把过境文档当任务证据或长期记忆；泄露密钥。
+
+## 关掉必须消失
+
+不能生成跨窗过境文档、Prompt 无搬运教战。Continue / Compact / 选中任务指针仍在。Parent 集成交接若 `parent-child` 开着仍在。
+
+## 不得带走
+
+`integration-handoff` 与集成权（`parent-child`）；Continue 与窗口标题（Adapter）；`selected_task`（Kernel）；工人派工包（`worker-orchestration`）；journal 跨 Task 记忆（`personal-memory`）；物理 archive（`retention-storage`）。

package/dist/templates/pactile/modules/spec-learning/contract.md

@@ -1,50 +1,50 @@
-# `spec-learning`
-
-P29 表名：`spec-learning`（不得改名）。层：on-demand。
-
-## 职责
-
-Close 窗口里，把**可复用**的约定写进长期知识（`.pactile/spec/`、ADR、Policy）。先提案、人确认、再写盘。`pactile-update-spec` 是本块的内部技能，不是用户 slash。`close-basic` 只产出学习 disposition（update-spec / no-update / unsure）；本块只在 disposition 需要写盘时才动手。不在 Execute 中改长期 spec，不把任务 `prd.md` 当长期 spec。
-
-## 写盘动作会有机器记录（只记事实、不拦写盘）
-
-对 `.pactile/spec/`、`docs/adr/`、Policy 文件的写盘动作（Write/Edit），机器会留一条审计记录：**谁写的（actor）、写盘时间、目标文件、有没有经过确认（经/未经验证）**。该记录由 hook（`.cursor/hooks/spec-write-audit.py`）落盘到 `.pactile/.runtime/hooks/spec-write.log`，与 `kernel.json` 审计链同属 History 轨，只作审计档案、不常驻注入窗口。
-
-- **机器记录 ≠ 机器裁决**：机器只记"有没有确认记录"这个**事实**，不做"内容对错"判定。对错由人裁决。
-- **只记录、不拦写盘**：记录失败不阻塞写盘；不因"未经验证"而拒绝写盘。本 gate 是记录不是门禁，任何情况下不因缺确认记录而挡住写盘。
-
-## 触发/披露
-
-未触发当没装。Execute / Define / 日常修 bug 看不见本块。触发（可审计）：
-
-1. Close 且 disposition 为 update-spec，或 unsure 经一次追问变成 update-spec；或
-2. 强信号：公共契约/API/CLI 变了、同类错误反复、`debug-recovery` 的防再发要求入 spec、用户明确要沉淀。
-
-**不是**触发：例行 bugfix、一次性配置、已经写在任务产物里且没有跨任务价值。默认**不问**「每个功能都要更新 spec」。
-
-写完或明确 no-update 后，本块教战从包中消失。
-
-Agent 看见：
-
-1. 先写任务内提案（目标路径 + 要点），**未确认不得**改 `.pactile/spec/` / ADR / Policy。
-2. 确认后才写；在 Evidence 里留下 spec 路径。禁止 hook / check 静默改 spec。
-3. no-update 必须带一句理由。unsure 只追问一次，不得假装已经写过。
-4. 编码期读 spec 是 `context-progressive` + spec 文件，不是本块把全文灌进 Close 包。
-5. 第一次从仓库事实建项目 spec 骨架是 `define-extended`（spec-bootstrap），不是本块。技能作者流程不是本块。
-
-用户看见：收工时最多被问一次「这条要不要写进长期约定」。多数 Lite Close 直接 no-update。没有常驻「学习配置」。
-
-## 停止条件
-
-- 与 `close-basic` 的分工：disposition vs 写盘。
-- 提案 → 确认 → 写盘 → 证据路径。
-- 停止：Execute 中改 spec；静默写盘；把 `prd.md` 当长期 spec；无确认写 Policy；用本块代替 spec-bootstrap。
-- Lite Close 不因缺 spec 更新而阻塞（缺的是 disposition 记录，那是 `close-basic`）。
-
-## 关掉必须消失
-
-Close 不得改长期 spec。disposition 仍可记 no-update。任务内 PRD/AC 不受影响。编码仍可按已有 spec 文件进行。
-
-## 不得带走
-
-Close Outcome（`close-basic`）；Define 时 bootstrap spec（`define-extended`）；把 spec 编进 Session 包（`context-progressive`）；break-loop 分类（`debug-recovery`）；技能作者（Maintainer Overlay / `pactile-skill-creator`）；跨 Task journal（`personal-memory`）。
+# `spec-learning`
+
+P29 表名：`spec-learning`（不得改名）。层：on-demand。
+
+## 职责
+
+Close 窗口里，把**可复用**的约定写进长期知识（`.pactile/spec/`、ADR、Policy）。先提案、人确认、再写盘。`pactile-update-spec` 是本块的内部技能，不是用户 slash。`close-basic` 只产出学习 disposition（update-spec / no-update / unsure）；本块只在 disposition 需要写盘时才动手。不在 Execute 中改长期 spec，不把任务 `prd.md` 当长期 spec。
+
+## 写盘动作会有机器记录（只记事实、不拦写盘）
+
+对 `.pactile/spec/`、`docs/adr/`、Policy 文件的修改，在任务证据中记录**谁写的（actor）、写盘时间、目标文件、有没有经过确认（经/未经验证）**。自动写盘审计需由后续 Codex / Pi 桥接提供；当前不得声称已有自动 hook 记录。
+
+- **机器记录 ≠ 机器裁决**：机器只记"有没有确认记录"这个**事实**，不做"内容对错"判定。对错由人裁决。
+- **只记录、不拦写盘**：记录失败不阻塞写盘；不因"未经验证"而拒绝写盘。本 gate 是记录不是门禁，任何情况下不因缺确认记录而挡住写盘。
+
+## 触发/披露
+
+未触发当没装。Execute / Define / 日常修 bug 看不见本块。触发（可审计）：
+
+1. Close 且 disposition 为 update-spec，或 unsure 经一次追问变成 update-spec；或
+2. 强信号：公共契约/API/CLI 变了、同类错误反复、`debug-recovery` 的防再发要求入 spec、用户明确要沉淀。
+
+**不是**触发：例行 bugfix、一次性配置、已经写在任务产物里且没有跨任务价值。默认**不问**「每个功能都要更新 spec」。
+
+写完或明确 no-update 后，本块教战从包中消失。
+
+Agent 看见：
+
+1. 先写任务内提案（目标路径 + 要点），**未确认不得**改 `.pactile/spec/` / ADR / Policy。
+2. 确认后才写；在 Evidence 里留下 spec 路径。禁止 hook / check 静默改 spec。
+3. no-update 必须带一句理由。unsure 只追问一次，不得假装已经写过。
+4. 编码期读 spec 是 `context-progressive` + spec 文件，不是本块把全文灌进 Close 包。
+5. 第一次从仓库事实建项目 spec 骨架是 `define-extended`（spec-bootstrap），不是本块。技能作者流程不是本块。
+
+用户看见：收工时最多被问一次「这条要不要写进长期约定」。多数 Lite Close 直接 no-update。没有常驻「学习配置」。
+
+## 停止条件
+
+- 与 `close-basic` 的分工：disposition vs 写盘。
+- 提案 → 确认 → 写盘 → 证据路径。
+- 停止：Execute 中改 spec；静默写盘；把 `prd.md` 当长期 spec；无确认写 Policy；用本块代替 spec-bootstrap。
+- Lite Close 不因缺 spec 更新而阻塞（缺的是 disposition 记录，那是 `close-basic`）。
+
+## 关掉必须消失
+
+Close 不得改长期 spec。disposition 仍可记 no-update。任务内 PRD/AC 不受影响。编码仍可按已有 spec 文件进行。
+
+## 不得带走
+
+Close Outcome（`close-basic`）；Define 时 bootstrap spec（`define-extended`）；把 spec 编进 Session 包（`context-progressive`）；break-loop 分类（`debug-recovery`）；技能作者（Maintainer Overlay / `pactile-skill-creator`）；跨 Task journal（`personal-memory`）。