@blxzer/pactile 0.5.0 → 0.6.0-beta.4

package/dist/templates/pactile/modules/vcs-integration/contract.md

@@ -1,46 +1,46 @@
-# `vcs-integration`
-
-P29 表名：`vcs-integration`（不得改名）。层：on-demand。
-
-## 职责
-
-Git（或其它已探测 VCS）上的真实操作：branch、worktree、commit、PR、push。它把「隔离 / 留下提交 / 开 PR」从 capability 落到命令。**不是** Kernel 前提，也不是 Close 的完成条件。人批仍走 `approval-personal` 的 Finalize（commit / 远程 / 不可逆）。工人默认不 commit（`worker-orchestration` 已锁）。
-
-## 触发/披露
-
-未触发当没装。仓库里有 `.git` **不够**进 Prompt。触发（可审计）：
-
-1. Finalize 窗口且用户要 commit / PR / push；或
-2. Policy / Close 合同要求 commit Evidence；或
-3. Parent/Worker 要求 isolation，需要 worktree；或
-4. 用户明确说提交、开分支、开 PR。
-
-**不是**触发：每次 Execute；无 Git 的 Lite Close；只改文件还不想留提交。
-
-Finalize/隔离窗口结束，Git 教战从常驻包消失。
-
-Agent 看见：
-
-1. 无 VCS → 本块不出现；生命周期仍可 Close；需要隔离则按 `worker-orchestration` 诚实降级，不得假装 worktree 已建。
-2. `git commit` ≠ Outcome completed。没 Finalize 授权不得 commit、不得 push、不得 `--force` 到默认分支。
-3. 远程、破坏性 Git、跳过 hook、改全局 git config：先问（Finalize / 用户明确）。不静默 push。
-4. worktree 细节（add/remove/路径）归本块；谁有权 integrate、哪个 Child 要隔离，归 `parent-child`。
-5. 个人默认不把「禁止在 main 上开发」写成 Kernel 规则；那是仓库/用户 overlay。若用户或 Policy 已有分支约定，本块遵守。
-6. 不提交密钥。PR 只在存在对应远程托管时做；没有 GitHub/远程 ≠ Close 失败。
-
-用户看见：要留提交或开 PR 时才出现 Git 步骤，并与 Finalize 并成一次确认。无 Git 的项目收工像普通 Close。日常改代码不灌 Git 教战。
-
-## 停止条件
-
-- 探测 ≠ 激活；激活条件见上。
-- 操作清单：branch / worktree / commit / PR / push 各自还要不要 Finalize。
-- 停止：无 Git 却挡 Close；把 commit 当 Close；工人代 commit；未授权 push；把窗口改名当本块。
-- 降级：无 VCS / 无远程 / 无 worktree 能力 → 记 assurance，生命周期继续（除非 Policy 硬要 commit Evidence）。
-
-## 关掉必须消失
-
-不能 commit/PR/worktree 教战。Open→Close 仍必须能走完。不得把缺 Git 写成 Kernel 坏了。物理搬家仍是 `retention-storage`。
-
-## 不得带走
-
-业务 Outcome（`close-basic`）；Finalize 人批（`approval-personal`）；Integrate 权威（`parent-child`）；isolation **要求**（执行合同 / `worker-orchestration`）；窗口标题（Adapter UX）；任务目录 archive（`retention-storage`）。
+# `vcs-integration`
+
+P29 表名：`vcs-integration`（不得改名）。层：on-demand。
+
+## 职责
+
+Git（或其它已探测 VCS）上的真实操作：branch、worktree、commit、PR、push。它把「隔离 / 留下提交 / 开 PR」从 capability 落到命令。**不是** Kernel 前提，也不是 Close 的完成条件。人批仍走 `approval-personal` 的 Finalize（commit / 远程 / 不可逆）。工人默认不 commit（`worker-orchestration` 已锁）。
+
+## 触发/披露
+
+未触发当没装。仓库里有 `.git` **不够**进 Prompt。触发（可审计）：
+
+1. Finalize 窗口且用户要 commit / PR / push；或
+2. Policy / Close 合同要求 commit Evidence；或
+3. Parent/Worker 要求 isolation，需要 worktree；或
+4. 用户明确说提交、开分支、开 PR。
+
+**不是**触发：每次 Execute；无 Git 的 Lite Close；只改文件还不想留提交。
+
+Finalize/隔离窗口结束，Git 教战从常驻包消失。
+
+Agent 看见：
+
+1. 无 VCS → 本块不出现；生命周期仍可 Close；需要隔离则按 `worker-orchestration` 诚实降级，不得假装 worktree 已建。
+2. `git commit` ≠ Outcome completed。没 Finalize 授权不得 commit、不得 push、不得 `--force` 到默认分支。
+3. 远程、破坏性 Git、跳过 hook、改全局 git config：先问（Finalize / 用户明确）。不静默 push。
+4. worktree 细节（add/remove/路径）归本块；谁有权 integrate、哪个 Child 要隔离，归 `parent-child`。
+5. 个人默认不把「禁止在 main 上开发」写成 Kernel 规则；那是仓库/用户 overlay。若用户或 Policy 已有分支约定，本块遵守。
+6. 不提交密钥。PR 只在存在对应远程托管时做；没有 GitHub/远程 ≠ Close 失败。
+
+用户看见：要留提交或开 PR 时才出现 Git 步骤，并与 Finalize 并成一次确认。无 Git 的项目收工像普通 Close。日常改代码不灌 Git 教战。
+
+## 停止条件
+
+- 探测 ≠ 激活；激活条件见上。
+- 操作清单：branch / worktree / commit / PR / push 各自还要不要 Finalize。
+- 停止：无 Git 却挡 Close；把 commit 当 Close；工人代 commit；未授权 push；把窗口改名当本块。
+- 降级：无 VCS / 无远程 / 无 worktree 能力 → 记 assurance，生命周期继续（除非 Policy 硬要 commit Evidence）。
+
+## 关掉必须消失
+
+不能 commit/PR/worktree 教战。Open→Close 仍必须能走完。不得把缺 Git 写成 Kernel 坏了。物理搬家仍是 `retention-storage`。
+
+## 不得带走
+
+业务 Outcome（`close-basic`）；Finalize 人批（`approval-personal`）；Integrate 权威（`parent-child`）；isolation **要求**（执行合同 / `worker-orchestration`）；窗口标题（Adapter UX）；任务目录 archive（`retention-storage`）。

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

@@ -1,38 +1,29 @@
-# `verify-basic`
-
-P29 表名：`verify-basic`（不得改名）。层：baseline。
-
-## 职责
-
-Verify 槽与 Evidence 角色。做确定性检查，并把每条 AC 映射到真实证据。Lite 也必须有真实 Evidence；占位、TBD、空勾选、假绿不得 Close。`verify.md` 是给人看的投影；机器账本是 `ac_evidence_ledger`（Kernel extras）。本块不负责独立第二遍语义 Check（那是 `independent-check`）。
-
-## 触发/披露
-
-Phase=Verify，或 Execute 刚结束正在收证据时加载。Intake / Define 不讲假绿、不灌 `verification-strength-guide`。Close 之后本块教战从常驻包拿掉，只留「证据是否已覆盖」。
-
-Agent 看见：
-
-1. 每条 AC 必须有可定位证据（测试输出、diff、命令结果、人工验收记录）；缺映射或指纹在定义/代码变更后过期 → 不得 Close。
-2. 实现缺陷 → 回 Execute 修，再验。不得在 Verify 里扩范围或改 AC 来「验过」。
-3. 契约/范围缺陷 → Return-to-Define，再走 Execute 门。
-4. 不得把 `self-review` 写成 `true-independent`；独立 Check 未激活则本块只做 Baseline Evidence。
-5. Adapter 可把卡住的运行时问题绑到 Cursor Debug；证据仍必须落回 Evidence 角色，Debug 不是本块。
-
-用户看见：阶段名 Verify。能否收工、哪条 AC 还没证据。Lite 不出现「独立审查员」叙事。
-
-渐进：非 Verify（及收证窗口）不加载本块教战。
-
-## 停止条件
-
-- 输入：Execute 已产生可验的工作结果；AC 列表来自已批 Definition。
-- 输出：AC→Evidence 覆盖；人读 `verify.md`；机器 ledger 更新。未覆盖 = Verify 未完成。
-- 停止：假绿；在 Verify 中改需求；宣称 Close 但 Evidence 槽空。
-- Lite / Full：本块对两者都强制真实 Evidence。Full 额外的 Independent Check 是另一模块。
-
-## 关掉必须消失
-
-不能 Close（缺 Evidence 必需槽）。不得用「看起来做过检查」代替映射。
-
-## 不得带走
-
-独立只读 Check（`independent-check`）；retrieval pack 打分（`retrieval-extended`）；如何写 AC（`define-basic`）；学习写回 spec（`spec-learning`）。
+# `verify-basic`
+
+P29 表名：`verify-basic`（不得改名）。层：baseline。
+
+## 职责
+
+检查已完成的 V2 Run，并针对该 Run 的准确候选快照 ID 和 fingerprint 记录独立 Review。每条已记录 AC 都要映射到可定位证据。Run 结果或面向人的 `verify.md` 本身不能满足 Kernel Review 门。
+
+每条 Review 都是绑定到一个候选的追加式判定。某候选的最新 Review 若为 `fail` 或 `needs-changes`，该候选不能 Close。之后可以重新检查同一候选并追加 Review；若实现已变化，必须新建 Run，并针对新候选重新 Review。Close 必须引用该候选的最新 Review。
+
+## 触发/披露
+
+Run 完成并产生候选快照后加载。按已记录的交付物和 AC 检查候选。Reviewer 必须与 Run 执行者和授权者都不同。为 Review 记录证据引用，并为每条 AC 记录证据。
+
+## 停止条件
+
+- 候选 ID 和 fingerprint 必须与选中的已完成 Run 完全一致。
+- 缺少 AC 证据、有未解决 blocker，或最新 Review 未通过，均表示验证未完成。
+- 同一候选的后续 Review 会取代更早判定；先前的 pass 不能绕过后续的 fail 或 needs-changes。
+- 候选变化时，不得把旧候选的 Review 用作新结果证据。
+- 不在验证中扩展交付物或改写 AC。契约有误时回到获授权的定义更新路径。
+
+## 关掉必须消失
+
+Review 和证据始终绑定其检查过的候选。不得依据未绑定的笔记或自我 Review 宣称可 Close。
+
+## 不得带走
+
+实现修改（`execute-agent`）；定义修改（`define-basic`）；交付层级证据和 Close（`close-basic`）；由其他模块激活的可选专项检查。

package/dist/templates/pactile/modules/worker-orchestration/contract.md

@@ -1,47 +1,47 @@
-# `worker-orchestration`
-
-P29 表名：`worker-orchestration`（不得改名）。层：on-demand。
-
-## 职责
-
-执行要求的**派工绑定**，不是生命周期槽，也不是调度器。当合同要求 worker / 隔离 / 并行时，把「谁去做」绑到 Adapter 能提供的类型化工人（implement / check / research）。Prefer 宿主原生并行（可见并行面 / 类型化工人 / 原生隔离）；PACTILE 只写契约与派工包，不造 Pactile 调度器、不跨平台把别的 IDE 当工人。主会话是唯一 dispatcher；工人不是 Kernel Phase。
-
-## 触发/披露
-
-未触发当没装。Lite 默认看不见 spawn 教战。触发（任一即可，且可审计）：
-
-1. 已声明可隔离组 **且** 派工窗口到来（Execute 已批的实现工人；Define 下独立 research 切片）；
-2. 已批 Execution Contract 写明 `execution_mode: worker`（或同等 isolation/parallel 要求）；
-3. 用户本回合明确要求派工 / 并行工人；
-4. `independent-check` 已激活且 Policy 要求 `true-independent`，平台又有独立 Worker；
-5. `define-extended` 已激活且研究合同要求独立 research worker。
-
-**不是**触发：Rigor=Full 本身；Topology=parent-child 本身（拓扑 ≠ 已派工）。已声明可隔离组且窗口到来时，不得以「Parent 默默顺序做完」代替激活；未声明可隔离组且已写 `serial_reason` 的真·单写集可 inline。
-
-派工窗口结束，spawn 教战从常驻包消失。
-
-Agent 看见：
-
-1. 三种角色，槽位仍归别人：implement → Execute（`execute-agent` 的非 inline 绑定）；check → 只读第二遍（服从 `independent-check`，工人默认不改代码）；research → Define 深研（服从 `define-extended`）。
-2. 每个工人 prompt 必须带显式 `.pactile/tasks/<dir>`，不依赖 dispatcher 的 `selected_task`。工人包 = 该任务路径 + 合同片段；不继承整份梯子。钩 `inject-subagent-context.py` 只在本块激活时订阅。
-3. 禁止套娃：implement / check / research 工人不得再 spawn 同类或彼此。只有主会话（或 Parent 主会话）派工。
-4. 工人不 `git commit`、不 Finalize、不 `integrate-child`、不改 Kernel 核心状态。
-5. 能并行则并行（P18 / P38），但 HITL / Execute 门 / Check / 集成仍串行。串行必须写 `serial_reason`（共享写集 / 门禁 / 依赖未满足 / 用户要求 / 冲突面无法隔离）。平台没有并行面 → 顺序派工或降回 inline，记 assurance，不得假装已隔离或已并行。
-6. 模型选择归 Adapter / 宿主；本块不写死模型 ID。无可靠宿主工人绑定 → 诚实降级，可走手动派工提示，不得假 spawn。
-
-用户看见：只有真正要派工时才出现工人/并行叙事。Lite 主会话改代码时看不到本块。没有「PACTILE 调度面板」。
-
-## 停止条件
-
-- 触发与非触发见上。
-- 三角色 ↔ 槽位 owner 对照；工人包形状（任务路径 + 合同片段）。
-- 停止：未激活仍 spawn；套娃；把 Check 工人当执行修补手（与已锁定的 `independent-check` 只读冲突）；把 Child 拓扑当成已经派工；无平台能力却写 true-independent / isolated / parallel；有可隔离组且窗口已到却全程 inline 且无 `serial_reason`。
-- 降级：无 Worker / 无隔离 / 无并行 → assurance + inline 或顺序；`execute-agent` 仍可用。
-
-## 关掉必须消失
-
-无 spawn 教战、无 subagent 注入钩、无并行工人说明书。Execute 只走 `execute-agent` inline。Check 最多 `self-review`。研究留在主会话。Parent 仍可存在，但只能顺序/inline，没有工人扇出。
-
-## 不得带走
-
-Execute 槽本身（`execute-agent`）；Check 语义与 assurance 标签（`independent-check`）；Decompose / 集成权威 / task-map（`parent-child`）；worktree 探测细节（`vcs-integration`，本块只要求 isolation capability）；宿主可见并行面是否存在（Adapter 探测）；跨窗人肉搬运（`session-transfer`）。
+# `worker-orchestration`
+
+P29 表名：`worker-orchestration`（不得改名）。层：on-demand。
+
+## 职责
+
+执行要求的**派工绑定**，不是生命周期槽，也不是通用调度器。当合同要求 worker / 隔离 / 并行时，把「谁去做」绑到可用的类型化工人（implement / check / research）。Parent 可用 Node 的 `pactile parallel run` 对已批 Child 做有上限的 Pi 批次派发；Codex 独立桌面任务仍走原生工具与回执。主会话是唯一集成 owner；工人不是 Kernel Phase。
+
+## 触发/披露
+
+未触发当没装。Lite 默认看不见 spawn 教战。触发（任一即可，且可审计）：
+
+1. 已声明可隔离组 **且** 派工窗口到来（Execute 已批的实现工人；Define 下独立 research 切片）；
+2. 已批 Execution Contract 写明 `execution_mode: worker`（或同等 isolation/parallel 要求）；
+3. 用户本回合明确要求派工 / 并行工人；
+4. `independent-check` 已激活且 Policy 要求 `true-independent`，平台又有独立 Worker；
+5. `define-extended` 已激活且研究合同要求独立 research worker。
+
+**不是**触发：Rigor=Full 本身；Topology=parent-child 本身（拓扑 ≠ 已派工）。已声明可隔离组且窗口到来时，不得以「Parent 默默顺序做完」代替激活；未声明可隔离组且已写 `serial_reason` 的真·单写集可 inline。
+
+派工窗口结束，spawn 教战从常驻包消失。
+
+Agent 看见：
+
+1. 三种角色，槽位仍归别人：implement → Execute（`execute-agent` 的非 inline 绑定）；check → 只读第二遍（服从 `independent-check`，工人默认不改代码）；research → Define 深研（服从 `define-extended`）。
+2. 每个 Pi Agent 工人 prompt 必须带显式 `.pactile/tasks/<dir>`，不依赖 dispatcher 的 `selected_task`。工人包 = 该任务路径 + 合同片段；不继承整份梯子。Pactile 的 Node 桥接按本块激活状态提供上下文。
+3. Codex 不派发 subagent，只用独立桌面任务通信。Pi 可按已授权职责在自己的写入范围内使用内部 subagent；内部派发不新增 Pactile Child，也不扩大批准范围。
+4. 工人不 `git commit`、不 Finalize、不 `integrate-child`、不改 Kernel 核心状态。
+5. 能并行则并行（P18 / P38），但 HITL / Execute 门 / Check / 集成仍串行。串行必须写 `serial_reason`（共享写集 / 门禁 / 依赖未满足 / 用户要求 / 冲突面无法隔离）。平台没有并行面 → 顺序派工或降回 inline，记 assurance，不得假装已隔离或已并行。
+6. 模型选择归 Adapter / 宿主；本块不写死模型 ID。无可靠宿主工人绑定 → 诚实降级，可走手动派工提示，不得假 spawn。
+
+用户看见：只有真正要派工时才出现工人/并行叙事。Lite 主会话改代码时看不到本块。Parent 的并行批次可用 `pactile parallel status` 读取耗时、等待、结果与集成状态。
+
+## 停止条件
+
+- 触发与非触发见上。
+- 三角色 ↔ 槽位 owner 对照；工人包形状（任务路径 + 合同片段）。
+- 停止：未激活仍派工；Codex 派发 subagent；Pi 内部派发越过批准范围；把 Check 工人当执行修补手（与已锁定的 `independent-check` 只读冲突）；把 Child 拓扑当成已经派工；无平台能力却写 true-independent / isolated / parallel；有可隔离组且窗口已到却全程 inline 且无 `serial_reason`。
+- 降级：无 Worker / 无隔离 / 无并行 → assurance + inline 或顺序；`execute-agent` 仍可用。
+
+## 关掉必须消失
+
+无 spawn 教战、无 subagent 注入钩、无并行工人说明书。Execute 只走 `execute-agent` inline。Check 最多 `self-review`。研究留在主会话。Parent 仍可存在，但只能顺序/inline，没有工人扇出。
+
+## 不得带走
+
+Execute 槽本身（`execute-agent`）；Check 语义与 assurance 标签（`independent-check`）；Decompose / 集成权威 / task-map（`parent-child`）；worktree 探测细节（`vcs-integration`，本块只要求 isolation capability）；宿主可见并行面是否存在（Adapter 探测）；跨窗人肉搬运（`session-transfer`）。

package/dist/templates/pactile/scripts/retrieval_probe_matrix_template.json

@@ -1,43 +1,43 @@
-{
-  "schemaVersion": 3,
-  "description": "Host-neutral Pactile retrieval resolver evidence matrix.",
-  "hostDiscoveryPerformed": false,
-  "probes": [
-    {
-      "intent": "exact",
-      "plannerKind": "local-exact",
-      "resolverStatus": "not-requested",
-      "minimumAssurance": "evidence-backed",
-      "evidenceRefs": [],
-      "corroboration": [],
-      "probedAt": null
-    },
-    {
-      "intent": "semantic",
-      "plannerKind": "provider-request",
-      "resolverStatus": null,
-      "minimumAssurance": "evidence-backed",
-      "evidenceRefs": [],
-      "corroboration": [],
-      "probedAt": null
-    },
-    {
-      "intent": "structural",
-      "plannerKind": "provider-request",
-      "resolverStatus": null,
-      "minimumAssurance": "evidence-backed",
-      "evidenceRefs": [],
-      "corroboration": [],
-      "probedAt": null
-    },
-    {
-      "intent": "external",
-      "plannerKind": "provider-request",
-      "resolverStatus": null,
-      "minimumAssurance": "evidence-backed",
-      "evidenceRefs": [],
-      "corroboration": [],
-      "probedAt": null
-    }
-  ]
-}
+{
+  "schemaVersion": 3,
+  "description": "Host-neutral Pactile retrieval resolver evidence matrix.",
+  "hostDiscoveryPerformed": false,
+  "probes": [
+    {
+      "intent": "exact",
+      "plannerKind": "local-exact",
+      "resolverStatus": "not-requested",
+      "minimumAssurance": "evidence-backed",
+      "evidenceRefs": [],
+      "corroboration": [],
+      "probedAt": null
+    },
+    {
+      "intent": "semantic",
+      "plannerKind": "provider-request",
+      "resolverStatus": null,
+      "minimumAssurance": "evidence-backed",
+      "evidenceRefs": [],
+      "corroboration": [],
+      "probedAt": null
+    },
+    {
+      "intent": "structural",
+      "plannerKind": "provider-request",
+      "resolverStatus": null,
+      "minimumAssurance": "evidence-backed",
+      "evidenceRefs": [],
+      "corroboration": [],
+      "probedAt": null
+    },
+    {
+      "intent": "external",
+      "plannerKind": "provider-request",
+      "resolverStatus": null,
+      "minimumAssurance": "evidence-backed",
+      "evidenceRefs": [],
+      "corroboration": [],
+      "probedAt": null
+    }
+  ]
+}

package/dist/templates/pactile/tasks/locale/en/default-prd.md

@@ -1,27 +1,27 @@
-# {title}
-
-## Goal
-
-{goal}
-
-## User Stories
-
-- [ ] (User-visible behaviors; enumerate as a long checkable list, not implementation steps)
-
-## Requirements
-
-- TBD
-
-## Acceptance Criteria
-
-- [ ] TBD
-
-## Implementation Decisions
-
-- (Recorded decisions; **do not write file paths** — paths go stale; keep them in design/implement)
-
-## Notes
-
-- Keep `prd.md` focused on requirements, constraints, and acceptance criteria.
-- Lightweight tasks can remain PRD-only.
-- For complex tasks, add `design.md` for technical design and `implement.md` for execution planning before `task.py start-execution --check`.
+# {title}
+
+## Goal
+
+{goal}
+
+## User Stories
+
+- [ ] (User-visible behaviors; enumerate as a long checkable list, not implementation steps)
+
+## Requirements
+
+- TBD
+
+## Acceptance Criteria
+
+- [ ] TBD
+
+## Implementation Decisions
+
+- (Recorded decisions; **do not write file paths** — paths go stale; keep them in design/implement)
+
+## Notes
+
+- Keep `prd.md` focused on requirements, constraints, and acceptance criteria.
+- Lightweight tasks can remain PRD-only.
+- For complex tasks, add `design.md` for technical design and `implement.md` for execution planning before `pactile task start-execution --check`.

package/dist/templates/pactile/tasks/locale/zh/default-prd.md

@@ -1,27 +1,27 @@
-# {title}
-
-## 目标
-
-{goal}
-
-## 用户故事
-
-- [ ] （用户可见行为；用极长可勾选列表穷举，不是实现步骤）
-
-## 需求
-
-- 待补充
-
-## 验收标准
-
-- [ ] 待补充
-
-## 实现决策
-
-- （已定决策；**不要写文件路径**——路径会过时，放 design/implement）
-
-## 备注
-
-- `prd.md` 聚焦需求、约束与验收标准。
-- 轻量任务可仅保留 PRD。
-- 复杂任务在 `task.py start-execution --check` 前补充 `design.md` 与 `implement.md`。
+# {title}
+
+## 目标
+
+{goal}
+
+## 用户故事
+
+- [ ] （用户可见行为；用极长可勾选列表穷举，不是实现步骤）
+
+## 需求
+
+- 待补充
+
+## 验收标准
+
+- [ ] 待补充
+
+## 实现决策
+
+- （已定决策；**不要写文件路径**——路径会过时，放 design/implement）
+
+## 备注
+
+- `prd.md` 聚焦需求、约束与验收标准。
+- 轻量任务可仅保留 PRD。
+- 复杂任务在 `pactile task start-execution --check` 前补充 `design.md` 与 `implement.md`。

package/dist/templates/pactile/tasks/templates/release-execution/design.md

@@ -1,61 +1,61 @@
-# Design — Release execution
-
-## Boundary
-
-This task **may** mutate remotes **only** after explicit user approval captured in `verify.md` (quote or paraphrase the approval request/response).
-
-## Release status model (this task)
-
-| Status | When to use |
-| --- | --- |
-| **published** | npm and/or git remote actions completed for the approved version |
-| **not published** | Execution aborted or only dry-run/preflight completed |
-| **blocked** | Preflight failed; do not publish until fixed |
-| **waived** | User approved proceeding despite a listed risk |
-| **deferred** | User postponed publish after readiness |
-
-Do not mark **ready to publish** here — that remains the readiness task outcome.
-
-## Approval gate (mandatory)
-
-Before any of the following, stop and obtain explicit user approval:
-
-- `node scripts/release.js …` (bundles bump, commit, tag, push)
-- `npm publish` / CI publish workflow dispatch
-- `git tag` / `git push` (including `--tags`)
-- GitHub **Create release** or promotion workflows
-
-Document in `verify.md`:
-
-```markdown
-## Publish approval evidence
-
-User explicitly approved: yes/no
-Approved version: …
-Approved dist-tag: …
-Approved remote actions: tag / push / npm publish / …
-```
-
-## Evidence contract (`verify.md`)
-
-1. **Readiness link** — path to readiness `handoff.md`.
-2. **Publish approval evidence** — as above.
-3. **Preflight results** — `check-versions`, `publish-plan`, `verify-packed-cli`.
-4. **Execution log** — commands run (redact tokens); pass/fail.
-5. **Post-publish smoke** — registry check, `pactile --version`, dogfood smoke commands.
-6. **Validation evidence** — tests run after publish if applicable.
-
-## Pactile CLI reference sequence (after approval)
-
-Typical human/CI sequence (do not automate without approval):
-
-```bash
-cd packages/cli
-node scripts/release-preflight.js check-versions
-node scripts/release-preflight.js publish-plan
-# After approval:
-pnpm --filter @blxzer/pactile release:beta   # or patch/minor/major per policy
-node scripts/release-preflight.js verify-npm --package all
-```
-
-`release.js` performs commit, tag, and push — treat it as a single approved bundle or decompose manually per policy.
+# Design — Release execution
+
+## Boundary
+
+This task **may** mutate remotes **only** after explicit user approval captured in `verify.md` (quote or paraphrase the approval request/response).
+
+## Release status model (this task)
+
+| Status | When to use |
+| --- | --- |
+| **published** | npm and/or git remote actions completed for the approved version |
+| **not published** | Execution aborted or only dry-run/preflight completed |
+| **blocked** | Preflight failed; do not publish until fixed |
+| **waived** | User approved proceeding despite a listed risk |
+| **deferred** | User postponed publish after readiness |
+
+Do not mark **ready to publish** here — that remains the readiness task outcome.
+
+## Approval gate (mandatory)
+
+Before any of the following, stop and obtain explicit user approval:
+
+- `pnpm release …` (bundles bump, commit, tag, push)
+- `npm publish` / CI publish workflow dispatch
+- `git tag` / `git push` (including `--tags`)
+- GitHub **Create release** or promotion workflows
+
+Document in `verify.md`:
+
+```markdown
+## Publish approval evidence
+
+User explicitly approved: yes/no
+Approved version: …
+Approved dist-tag: …
+Approved remote actions: tag / push / npm publish / …
+```
+
+## Evidence contract (`verify.md`)
+
+1. **Readiness link** — path to readiness `handoff.md`.
+2. **Publish approval evidence** — as above.
+3. **Preflight results** — `check-versions`, `publish-plan`, `verify-packed-cli`.
+4. **Execution log** — commands run (redact tokens); pass/fail.
+5. **Post-publish smoke** — registry check, `pactile --version`, dogfood smoke commands.
+6. **Validation evidence** — tests run after publish if applicable.
+
+## Pactile CLI reference sequence (after approval)
+
+Typical human/CI sequence (do not automate without approval):
+
+```bash
+cd packages/cli
+pnpm release:check
+pnpm release:plan
+# After approval:
+pnpm --filter @blxzer/pactile release:beta   # or patch/minor/major per policy
+pnpm --filter @blxzer/pactile exec tsx scripts/release-preflight.ts verify-npm --package cli
+```
+
+`pnpm release` performs commit, tag, and push — treat it as a single approved bundle or decompose manually per policy.

package/dist/templates/pactile/tasks/templates/release-execution/handoff-template.md

@@ -1,29 +1,29 @@
-# Handoff — Release execution — `{task-id}`
-
-## Published
-
-| Action | Evidence |
-| --- | --- |
-| Version bumped | `{yes/no}` — `{version}` |
-| Git tag | `{tag or none}` |
-| Git push | `{ref or none}` |
-| npm publish | `{package@version + dist-tag or none}` |
-| Post-publish smoke | `{summary}` |
-
-## Not published
-
-- `{Describe aborted or dry-run-only session}`
-
-## Ready to publish
-
-_Refer to readiness task:_ `{path to readiness handoff.md}`
-
-## Blockers
-
-| Blocker | Severity | Disposition | Notes |
-| --- | --- | --- | --- |
-| `{if any}` | | | |
-
-## Residual risks
-
+# Handoff — Release execution — `{task-id}`
+
+## Published
+
+| Action | Evidence |
+| --- | --- |
+| Version bumped | `{yes/no}` — `{version}` |
+| Git tag | `{tag or none}` |
+| Git push | `{ref or none}` |
+| npm publish | `{package@version + dist-tag or none}` |
+| Post-publish smoke | `{summary}` |
+
+## Not published
+
+- `{Describe aborted or dry-run-only session}`
+
+## Ready to publish
+
+_Refer to readiness task:_ `{path to readiness handoff.md}`
+
+## Blockers
+
+| Blocker | Severity | Disposition | Notes |
+| --- | --- | --- | --- |
+| `{if any}` | | | |
+
+## Residual risks
+
 - `{registry lag, global CLI hygiene, consumer dist-tag confusion, etc.}`