cowork-flow 1.7.3 → 1.8.1

package/CHANGELOG.md

@@ -5,6 +5,23 @@
 ### Added
 
 
+## [1.8.1] - 2026-10-08
+
+### Added
+
+- **任务收养 `task next --run --adopt`（1.9.0 多执行者协作前置）**：为孤儿/滞留任务提供受支持的接管路径，替代手改 task.json meta。收养是独立动作（不与 review/complete/archive 链式同发）：把 `in_progress`/`review` 状态、由另一执行者占有的任务重绑到收养者（`executor`），把评审基线**重置**到收养时 HEAD（原值记入 `meta.previousBaseline`），保留状态并写审计字段 `meta.previousExecutor` / `meta.previousBaseline` / `meta.adoptedAt`，结果 code `LIFECYCLE-EXECUTOR-ADOPTED`。误用 fail-closed（`LIFECYCLE-ADOPT-001`）：planning/completed、无 executor、自我收养、process-fallback 身份、delegated 上下文、携带 create/plan 或批启动旗标全部拒绝且不改状态。start 路径"基线永不覆盖"不变量原样保留（既有测试零改动），收养是唯一经审计的显式重置路径；成功后 CLI 把会话绑定到该任务。契约见 `.cowork-flow/spec/contracts/task-adopt.md`。
+
+### Fixed
+
+- **`--allow-missing-evidence` 恢复独立解析**（1.8.0 遗留缺陷）：该旗标此前被误注册为 `--allow-unchecked` 的解析别名（同一 `add_argument`、dest 相同），造成两个后果——AC 证据豁免（`LIFECYCLE-AC-002` 的可豁免路径）从 CLI 不可达（`cmd_complete` 读取的属性 argparse 从不创建，恒为 False）；且传入 `--allow-missing-evidence` 会静默获得 spec-check 未检查豁免（语义错误、方向危险：本意只豁免 AC 证据，却放开了缺失/超时的 spec-check 命令）。现在两个旗标各自独立解析，parser 级与命令贯通级回归测试锁定（既有测试手工构造 Namespace 绕过 parser，正是此缺陷漏网原因）。
+
+## [1.8.0] - 2026-10-08
+
+### Added
+
+- **spec-check 采纳闭环（1.8.x 主线）**：让 spec-check 机制从"存在但沉默"变为可遵循。① 零声明可见性：仓库无生效声明时 `spec-check` 文本模式输出显式事实行 `spec-check: no checks declared (<N> spec files scanned)`（与"有声明且全过"可区分），`--json` 顶层新增 `specFiles`、summary 新增 `declarations`——"没挂声明"不再与"干净通过"同形（零声明保持退出码 0：不挂命令是合法状态，但必须被看见）。② 注入契约 `SPEC_CHECKS_V1`：`contract-registry.json` 新增第 10 条（digest 2 条 + readWhen 3 条），python/zcode/opencode 三线渲染在 digest 块输出 `- SPEC_CHECKS_V1: .cowork-flow/spec/contracts/spec-checks.md`。③ `spec-checks.md` 重排为使用者核心区（何时挂 / 语法含 UTF-8 无 BOM 注意点 / 三态与门禁含零声明语义 / 时机与输出 / 归属）+ 维护者附录（宿主能力矩阵 / delegated 缺口与补偿 / digest 注入 / 开放决策），零信息丢失由独立复核逐项清点确认。④ AI 挂命令职责三处一致：契约归属段、`task-review`（User specs 逐条问"可机检吗、已挂吗" + `user_spec_review` 列「条款 → 命令」清单）、`spec-sync`（同次维护挂/刷新声明）；质量纪律四条（干净树跑出 pass / 反例能报错 / `files` 限定 / 挂后跑 spec-check 确认解析）获测试锁（`test_review_contract.py` markers）。不新增硬门禁——放权语义：主会话 AI 主动挂声明，review 报告留痕。
+- **证据化完成（1.8.0 主线）**：任务完成从"流程走完"升级为"证据齐全"。decision-anchor 的验收标准（AC）成为机器可查询事实——`services/ac_evidence.py` 解析 `## 验收标准` 的勾选状态并读取任务目录 `evidence.jsonl`（追加式，`{ac, kind: test|command|manual, ref, note?, recordedAt, by}`）；完成动作新增两条稳定门禁 code：存在未勾选 AC 阻断（`LIFECYCLE-AC-001`）、已声明 AC 缺有效证据记录阻断（`LIFECYCLE-AC-002`），新旗标 `--allow-missing-evidence` 豁免后者并把 `meta.evidenceExempt`（含 `at` 与 `missing`）留在任务记录；decision-anchor 注入块在 `Acceptance:` 行后追加 `AC evidence: n/m`（缺失时附 `missing=` 列表），三线（Python / zcode shim / opencode 插件）逐字节同格式并由矩阵测试锁定；`run state --json` 与 MCP 事实视图新增 `evidenceCoverage`。无 AC 的存量任务零影响（兼容路径有测试锁定），契约见 `.cowork-flow/spec/contracts/evidence-completion.md`。
+
 ## [1.7.3] - 2026-10-06
 
 ### Fixed
@@ -289,7 +306,9 @@
 
 此版本未保留本地条目正文，详情见 [GitHub Release](https://github.com/fishlikewater/cowork-flow/releases/tag/v0.0.47)。
 
-[Unreleased]: https://github.com/fishlikewater/cowork-flow/compare/v1.7.3...HEAD
+[Unreleased]: https://github.com/fishlikewater/cowork-flow/compare/v1.8.1...HEAD
+[1.8.1]: https://github.com/fishlikewater/cowork-flow/compare/v1.8.0...v1.8.1
+[1.8.0]: https://github.com/fishlikewater/cowork-flow/compare/v1.7.3...v1.8.0
 [1.7.3]: https://github.com/fishlikewater/cowork-flow/compare/v1.7.2...v1.7.3
 [1.7.2]: https://github.com/fishlikewater/cowork-flow/compare/v1.7.1...v1.7.2
 [1.7.1]: https://github.com/fishlikewater/cowork-flow/compare/v1.7.0...v1.7.1

package/docs/direction.md

@@ -16,7 +16,11 @@
 | 本规划文档落库 | ✅ 完成 | 08-27-direction-doc | — |
 | 1.5→1.7 宿主广度 + 发布链（七宿主） | ✅ 完成 | CHANGELOG 1.5.0-1.7.2 | — |
 | 1.7.3 维护：ZCode shim .mjs + 项目根查找修复 | ✅ 完成 | 10-04-zcode-shim-mjs（d0716a9） | — |
-| 1.8.0 立项：证据化完成 | 🔄 立项完成，待启动 | 10-05-direction-1-8-0 / 10-05-evidence-completion | 在宿主会话启动主线任务 |
+| 1.8.0 立项：证据化完成 | ✅ 完成 | 10-05-direction-1-8-0 / 10-05-evidence-completion | — |
+| 1.8.0 主线实现：证据化完成 | ✅ 完成 | 10-05-evidence-completion（baa386d，CI test + windows-core 全绿）；已随 1.8.0 发布（cfe1ac1） | — |
+| 1.8.x 收尾：Skill 证据补课 + spec-check 采纳闭环 | ✅ 完成 | 10-06-skill-evidence-training（09937d0）、10-08 spec-check 闭环（08f9d9b） | — |
+| 1.9.0 前置：task adopt 命令 | ✅ 完成 | 10-06-task-adopt-command（e6e5132）：`--adopt` 重绑执行者 + 基线重置 + 审计；契约 task-adopt.md | 1.9.0 主线（多执行者协作）立项 |
+| 1.8.1 补丁：`--allow-missing-evidence` 解析修复 + adopt | 🔄 本次发布 | 10-08-fix-evidence-flag-parser（dc594a4）；tag v1.8.1 → CI 发布 npm | 确认 CI 全绿与 npm latest=1.8.1 |
 
 **当前结论**：方向路线图阶段 0-3 全部落地。项目当前形态：「多主机 Agent 协作的运行时上下文与协作事实层」——事实视图（CLI + MCP）、结构化注入、跨宿主一致性治理、执行者归属与证据位均已就绪并有测试锁定。后续演进见「不做什么」边界与观察期事项。
 
@@ -156,6 +160,14 @@
 
 5. **采用**：npm 周下载与激活项目数——1.8.0 之后用数字验证"深度路线"是否兑现。
 
+### 10.5 2026-10-06 增补：1.8.x 收尾与 1.9.0 排期
+
+- **1.8.0 主线已实现**（10-05-evidence-completion，baa386d）：AC 事实化、`evidence.jsonl`、完成门禁 `LIFECYCLE-AC-001/002`、三线注入覆盖行、`evidenceCoverage` 事实视图；主线任务自身以新门禁完成（四 AC 证据齐全，无豁免）。
+- **1.8.0 发布判据**：CI 双平台（已绿）+ 真实宿主冒烟（维护者：带 AC 任务在 ZCode/Qoder 实跑一轮，观察覆盖行与门禁体验）+ Skill 证据补课合入。
+- **1.9.0 主线候选：agent-teams 就绪**，按 10.3 排期；前置小任务 = **task adopt 命令**（孤儿任务收养：显式重绑执行者 + 陈旧基线降级 + 审计留痕）。需求证据：2026-10-06 归档两个滞留任务时，takeover 只重绑执行者，陈旧基线需手改 task.json meta 才能走降级归档——该操作目前无运行时命令承载。10.5 增补时立项（10-06-task-adopt-command），设计注意"基线永不覆盖"不变量与显式收养语义的边界。
+- **Skill 证据补课**（10-06-skill-evidence-training）：1.8.0 只改了运行时与契约，教 agent 写证据的目前只有门禁报错文案；task-review 等 Skill 正文需补 evidence.jsonl 约定。
+- **维持**：文档英文化待维护者拍板（与 AGENTS.md 文档语言约定冲突）；缓行清单不变。**观察项**：1.8.0 的机器可解析 AC 是与 Spec Kit / OpenSpec 互操作的第一块砖（spec 制品 ↔ decision-anchor 映射），符合"SDD 工具之下的状态层"定位，待 agent-teams 排期落定后议。
+
 ## 11. 修订记录
 
 - 2026-08-27：创建。基于三路只读探查（注入层/状态模型/治理层）+ 大模型趋势分析；用户拍板方案 A；落库任务 08-27-direction-doc。
@@ -165,3 +177,5 @@
 - 2026-08-29：阶段 3 完成并更新状态追踪——路线图阶段 0-3 全部落地。`run mcp-state` 无依赖 MCP stdio 只读服务（task_state / task_list）、`spec/contracts/fact-layer-access.md` 接入契约（只读保证 + 薄 adapter 立场）（a88474e）。观察期事项：AGNTCY 等跨 agent 协议收敛后按薄壳接入；MCP 写工具默认拒绝，提案须先重开 fact-layer-access 契约。
 - 2026-08-29：MCP 全局入口补充——npm CLI 新增 `cowork-flow mcp-state` 透传命令（cwd 向上定位项目运行时、stdio inherit、退出码透传），MCP 客户端全局注册一次即可服务所有项目，消除逐项目 `.mcp.json` 配置（9a1fa86）。
 - 2026-08-29：后续方向 P0-P3 执行完毕。**P0**：1.1.0 发布——dev→master 合并、CHANGELOG 1.1.0 段（含 1.0.0 载体错位注明）、tag v1.1.0 与 GitHub Release 创建；publish CI 首跑曝光 node:full 存量问题（dsh-hook 依赖 gitignored 运行时、Windows 无法 exec shebang 脚本、test runner IPC 崩溃）并全部修复——双平台门禁现已全绿。**发布确认：npm registry `cowork-flow@1.1.0` 已上线（dist-tag latest），AC-004 闭合，发版任务归档。** **P1**：`docs/mcp-client-setup.md`（codex/opencode/claude-code/zcode 真实注册格式）+ `test/mcp-client-matrix.test.js` 客户端等效启动验证。**P1'**：publish.yml 链路实测核对并写入 README 发布节。**P2**：flaky 组合复跑 5 轮未复现（记录为单次现象）；doctor 会话卫生无残留。**P3**：观察期边界维持——MCP 写工具默认拒绝，AGNTCY 等协议收敛后按薄壳接入。- 2026-10-05：2026-10 修订落库（任务 10-05-direction-1-8-0）。1.7.3 维护完成（10-04-zcode-shim-mjs，d0716a9：ZCode shim 改 .mjs、findWorkflowRoot off-by-one 修复）；1.8.0 主线定为**证据化完成**，主线任务 10-05-evidence-completion 立项（planning 就绪待启动）；候选 B（agent-teams 就绪）列为 1.9.0 候选主线；文档英文化列为待决项，待维护者拍板。方向文档自本次起恢复版本控制（087ef72 untrack 后首次入库）。
+- 2026-10-06：10.5 增补落库（任务 10-06-direction-post-1-8-0）。1.8.0 主线实现完成（10-05-evidence-completion，baa386d，CI 双平台全绿）；立项 10-06-skill-evidence-training（1.8.0 收尾）与 10-06-task-adopt-command（1.9.0 前置）；1.8.0 发布判据 = CI + 真实宿主冒烟 + Skill 补课。
+- 2026-10-08：1.8.0 已发布（cfe1ac1，tag v1.8.0，CI publish 全绿，npm latest=1.8.0）。发布后排查发现 `--allow-missing-evidence` 被误注册为 `--allow-unchecked` 解析别名的遗留缺陷（AC 证据豁免从 CLI 不可达 + 误授 spec-check 豁免），修复入库（10-08-fix-evidence-flag-parser，dc594a4，parser 级与命令贯通级回归测试锁定）。1.9.0 前置 task adopt 完成（10-06-task-adopt-command，e6e5132）：`task next --run --adopt` 独立动作——重绑执行者、评审基线重置到收养时 HEAD（审计保留原值）、状态不变、误用 fail-closed（`LIFECYCLE-ADOPT-001`）；契约 `spec/contracts/task-adopt.md`，含与 `--takeover` 的边界。本次发布 1.8.1 同时携带两项交付（CHANGELOG 分列 Added/Fixed）；1.9.0 主线（多执行者协作就绪）待立项。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cowork-flow",
-  "version": "1.7.3",
+  "version": "1.8.1",
   "description": "CLI for installing and maintaining cowork-flow collaboration templates.",
   "keywords": [
     "ai-agent",

package/presets/claude-code/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "cowork-flow",
-  "version": "1.7.3",
+  "version": "1.8.1",
   "description": "AI 协作工作流引擎：任务生命周期、子代理调度、门禁与状态注入。将 cowork-flow 的完整工作流带入 Claude Code。",
   "displayName": "Cowork Flow",
   "author": {

package/presets/codex/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "cowork-flow",
-  "version": "1.7.3",
+  "version": "1.8.1",
   "description": "AI 协作工作流引擎：任务生命周期、子代理调度、门禁与状态注入。将 cowork-flow 的完整工作流带入 Codex。",
   "author": {
     "name": "fishlikewater",

package/presets/kimi-code/.kimi-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "cowork-flow",
-  "version": "1.7.3",
+  "version": "1.8.1",
   "description": "AI 协作工作流引擎：任务生命周期、子代理调度、门禁与状态注入。将 cowork-flow 的完整工作流带入 Kimi Code。",
   "author": {
     "name": "fishlikewater",

package/presets/opencode/cowork-flow/plugin-core.js

@@ -574,8 +574,14 @@ function parseDecisionAnchor(text) {
     if (section === "目标") {
       if (line) goalLines.push(line)
     } else if (section === "验收标准") {
-      const match = raw.match(/^\s*-\s*\[[ xX]?\]\s*(AC-[A-Za-z0-9-]+)\s*[:：]\s*(.+?)\s*$/)
-      if (match) result.acceptanceCriteria.push({ id: match[1], text: match[2] })
+      const match = raw.match(/^\s*-\s*(?:\[([ xX])\]?\s*)?(AC-[A-Za-z0-9-]+)\s*[:：]\s*(.+?)\s*$/)
+      if (match) {
+        result.acceptanceCriteria.push({
+          id: match[2],
+          text: match[3],
+          checked: match[1] === 'x' || match[1] === 'X',
+        })
+      }
     } else if (section === "被拒方案") {
       const match = raw.match(/^\s*-\s*\*\*(.+?)\*\*/)
       if (match) result.rejectedOptions.push(match[1].trim())
@@ -836,6 +842,36 @@ function withStageFacts(block, root, taskPath, status, readonly = false) {
   return parts.length > 0 ? `${parts.join("\n\n")}\n\n${block}` : block
 }
 
+// Evidence coverage for the anchor block: one read of the task's
+// evidence.jsonl, tolerating noise exactly like the python line. Returns
+// null when the file is absent so the coverage line degrades silently.
+function readEvidenceCoverage(root, taskPath) {
+  let text = ''
+  try {
+    text = readFileSync(resolve(root, taskPath, 'evidence.jsonl'), 'utf8')
+  } catch {
+    return null
+  }
+  const covered = new Set()
+  for (const raw of text.split('\n')) {
+    const line = raw.trim()
+    if (!line) continue
+    let record
+    try {
+      record = JSON.parse(line)
+    } catch {
+      continue
+    }
+    if (!record || typeof record !== 'object' || Array.isArray(record)) continue
+    const ac = typeof record.ac === 'string' ? record.ac.trim() : ''
+    const ref = typeof record.ref === 'string' ? record.ref.trim() : ''
+    if (ac && ref && ['test', 'command', 'manual'].includes(record.kind)) {
+      covered.add(ac)
+    }
+  }
+  return covered
+}
+
 function decisionAnchorBlock(root, taskPath, status) {
   if (!taskPath) {
     return null
@@ -868,6 +904,17 @@ function decisionAnchorBlock(root, taskPath, status) {
     lines.push(
       `Acceptance: ${parsed.acceptanceCriteria.slice(0, 8).map((item) => `${item.id} ${item.text.slice(0, 80)}`).join("; ")}`
     )
+    const covered = readEvidenceCoverage(root, taskPath)
+    if (covered) {
+      const total = parsed.acceptanceCriteria.length
+      const missing = parsed.acceptanceCriteria
+        .map((item) => item.id)
+        .filter((id) => !covered.has(id))
+      const detail = missing.length
+        ? ` missing=${missing.slice(0, 5).join(',')}`
+        : ''
+      lines.push(`AC evidence: ${total - missing.length}/${total}${detail}`)
+    }
   }
   if (parsed.rejectedOptions.length > 0) {
     lines.push(`Rejected: ${parsed.rejectedOptions.slice(0, 6).join("; ")}`)
@@ -1073,5 +1120,6 @@ export {
   runEditSpecCheck,
   contractFingerprint,
   stableStringify,
-  stageContractBlock
+  stageContractBlock,
+  decisionAnchorBlock
 }

package/presets/qoder/.qoder-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "cowork-flow",
-  "version": "1.7.3",
+  "version": "1.8.1",
   "description": "AI 协作工作流引擎：任务生命周期、子代理调度、门禁与状态注入。将 cowork-flow 的完整工作流带入 Qoder。",
   "displayName": "Cowork Flow",
   "author": {

package/presets/zcode/.zcode-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "cowork-flow",
-  "version": "1.7.3",
+  "version": "1.8.1",
   "description": "AI 协作工作流引擎：任务生命周期、子代理调度、门禁与状态注入。将 cowork-flow 的完整工作流带入 ZCode。",
   "author": {
     "name": "fishlikewater",

package/template/.cowork-flow/.version

@@ -1 +1 @@
-1.7.3
+1.8.1

package/template/.cowork-flow/scripts/adapters/cli/spec_check.py

@@ -108,13 +108,22 @@ def _print_text_report(report: dict, *, verbose: bool) -> None:
         print(_parse_error_line(parse_errors))
         return
 
+    summary = report.get("summary", {})
+    if not parse_errors and summary.get("declarations") == 0:
+        # Zero declarations is a fact, not a pass: name it so a missing or
+        # silently ignored declaration block cannot look like a clean run.
+        print(
+            "spec-check: no checks declared "
+            f"({report.get('specFiles', 0)} spec files scanned)"
+        )
+        return
+
     from services.spec_check import normalized_one_line
 
     line = normalized_one_line(report)
     if line:
         print(line)
         return
-    summary = report.get("summary", {})
     print(
         "spec-check: {pass} passed, {violation} violations, "
         "{unchecked} unchecked".format(

package/template/.cowork-flow/scripts/adapters/cli/task.py

@@ -38,6 +38,7 @@ from adapters.cli.task_context_commands import (
 from adapters.cli.task_create_command import cmd_create, ensure_tasks_dir
 from adapters.cli import task_navigation
 from adapters.cli.task_lifecycle_commands import (
+    cmd_adopt,
     cmd_complete,
     cmd_current,
     cmd_finish,
@@ -152,6 +153,7 @@ def cmd_next(args: argparse.Namespace) -> int:
                 review=cmd_review,
                 complete=cmd_complete,
                 archive=cmd_archive,
+                adopt=cmd_adopt,
             ),
         )
     return task_navigation.cmd_next(args)

package/template/.cowork-flow/scripts/adapters/cli/task_lifecycle_commands.py

@@ -30,6 +30,7 @@ from runtime.session_state import (
     PROVENANCE_PROCESS_FALLBACK,
     clear_active_task,
     get_active_task,
+    set_active_task,
 )
 
 
@@ -284,6 +285,50 @@ def cmd_start(args: argparse.Namespace) -> int:
     return 0
 
 
+def cmd_adopt(args: argparse.Namespace) -> int:
+    """Adopt an active task from another executor."""
+    repo_root = get_repo_root()
+    execution_context = execution_context_from_namespace(args)
+    task_input = getattr(args, "dir", None)
+    if not task_input:
+        print(
+            colored("Error: task directory or name required", Colors.RED),
+            file=sys.stderr,
+        )
+        return 1
+
+    full_path = _resolve_start_task(task_input, repo_root)
+    if full_path is None:
+        return 1
+
+    service = TaskLifecycleService(repo_root)
+    result = service.adopt(
+        full_path,
+        executor=getattr(args, "executor", None),
+        execution_context=execution_context,
+    )
+    if not result.ok:
+        if result.code == "LIFECYCLE-ADOPT-001":
+            print(
+                colored("Error: task adoption blocked", Colors.RED),
+                file=sys.stderr,
+            )
+            for blocker in result.blockers:
+                print(f"  - {blocker}", file=sys.stderr)
+            return 1
+        if result.title:
+            return _report_lifecycle_preflight(result)
+        if result.repository_error is not None:
+            return _report_lifecycle_repository_error(result)
+        return 1
+
+    task_path = _display_task_path(repo_root, full_path)
+    set_active_task(repo_root, task_path)
+    print(colored(f"[OK] Task adopted: {task_path}", Colors.GREEN))
+    print(f"Next: ./.cowork-flow/run task next {task_path} --run")
+    return 0
+
+
 def cmd_review(args: argparse.Namespace) -> int:
     """Mark a task ready for check."""
     repo_root = get_repo_root()
@@ -336,6 +381,9 @@ def cmd_complete(args: argparse.Namespace) -> int:
         task_dir,
         execution_context=execution_context,
         allow_unchecked_specs=bool(getattr(args, "allow_unchecked", False)),
+        allow_missing_evidence=bool(
+            getattr(args, "allow_missing_evidence", False)
+        ),
     )
     if not result.ok:
         if result.code == "LIFECYCLE-TRANSITION-001":

package/template/.cowork-flow/scripts/adapters/cli/task_next_runner.py

@@ -18,6 +18,7 @@ from runtime.session_state import (
     get_active_task,
 )
 from services.plan_binding import PlanBindingError, bind_task_plan
+from services.task_lifecycle import ADOPTABLE_STATUSES
 
 
 LifecycleCommand = Callable[[argparse.Namespace], int]
@@ -30,6 +31,7 @@ class NextActionHandlers:
     review: LifecycleCommand
     complete: LifecycleCommand
     archive: LifecycleCommand
+    adopt: LifecycleCommand
 
 
 def namespace_with(args: argparse.Namespace, **overrides) -> argparse.Namespace:
@@ -270,7 +272,62 @@ def _run_plan_bind_action(args: argparse.Namespace, task_path: str) -> int:
     return 0
 
 
+def _run_adopt_action(
+    args: argparse.Namespace,
+    handlers: NextActionHandlers,
+) -> int:
+    """`--adopt` is its own action: it repairs ownership and the review
+    baseline without running any lifecycle transition."""
+    repo_root = get_repo_root()
+    if _create_input_names(args) or getattr(args, "from_plan", None):
+        print(
+            colored(
+                "Error: --adopt takes over an existing task; create/plan "
+                "inputs cannot run with it",
+                Colors.RED,
+            ),
+            file=sys.stderr,
+        )
+        return 1
+    if getattr(args, "auto", False) or getattr(args, "approved", False):
+        print(
+            colored(
+                "Error: --adopt does not run batch start; adopt first, then "
+                "re-run with --auto --approved",
+                Colors.RED,
+            ),
+            file=sys.stderr,
+        )
+        return 1
+    task_dir, task_path, _active_target = _next_target_for_run(args, repo_root)
+    if task_dir is None or task_path is None:
+        blockers = _fallback_binding_blockers(args, repo_root)
+        for blocker in blockers or ["no task target for --adopt; pass a task dir"]:
+            print(colored(f"Error: {blocker}", Colors.RED), file=sys.stderr)
+        return 1
+    if not task_dir.is_dir():
+        print(
+            colored(f"Error: task directory not found: {task_path}", Colors.RED),
+            file=sys.stderr,
+        )
+        return 1
+    status = task_navigation._status(repo_root, task_dir)
+    if status not in ADOPTABLE_STATUSES:
+        print(
+            colored(
+                "Error: --adopt only applies to an active task "
+                f"({'/'.join(ADOPTABLE_STATUSES)}); current status: {status}",
+                Colors.RED,
+            ),
+            file=sys.stderr,
+        )
+        return 1
+    return handlers.adopt(namespace_with(args, dir=task_path))
+
+
 def run_next_action(args: argparse.Namespace, handlers: NextActionHandlers) -> int:
+    if bool(getattr(args, "adopt", False)):
+        return _run_adopt_action(args, handlers)
     action, error_code = _validated_next_action(args)
     if action is None:
         return error_code

package/template/.cowork-flow/scripts/adapters/cli/task_parser.py

@@ -31,6 +31,8 @@ Action inputs for `next --run`:
   --parent <dir>        Optional parent task directory for create_task
   --from-plan <path>    Plan path for create_task or planning-phase rebind
   --auto --approved     Optional batch start flags for start_task
+  --adopt              Adopt an active task from another executor (rebind
+                       executor + reset review baseline; status unchanged)
   --commit             Optional archive auto-commit flag for archive_task
 
 Examples:
@@ -91,6 +93,13 @@ def _add_next_output_options(parser: argparse.ArgumentParser) -> None:
         help="With task completion: allow unchecked spec-check commands "
         "(missing/timeout) and record the exemption in task.json meta",
     )
+    parser.add_argument(
+        "--allow-missing-evidence",
+        dest="allow_missing_evidence",
+        action="store_true",
+        help="With task completion: allow checked acceptance criteria "
+        "without evidence and record the exemption in task.json meta",
+    )
     parser.add_argument(
         "--list",
         dest="list_tasks",
@@ -156,6 +165,12 @@ def _add_next_runtime_inputs(parser: argparse.ArgumentParser) -> None:
         action="store_true",
         help="Take the task over from its current executor on start_task",
     )
+    parser.add_argument(
+        "--adopt",
+        action="store_true",
+        help="Adopt an active task from another executor: rebind executor, "
+        "reset the review baseline to HEAD, keep status, record audit fields",
+    )
 
 
 def _add_next_command(subparsers: argparse._SubParsersAction) -> None:

package/template/.cowork-flow/scripts/adapters/host/workflow_state_hook.py

@@ -382,12 +382,33 @@ def _decision_anchor_block(
             for item in parsed["acceptanceCriteria"][:8]
         )
         lines.append(f"Acceptance: {items}")
+        coverage = _acceptance_evidence_coverage(root, task_path)
+        if coverage:
+            detail = ""
+            if coverage["missing"]:
+                detail = f" missing={','.join(coverage['missing'][:5])}"
+            lines.append(
+                f"AC evidence: {coverage['withEvidence']}/{coverage['total']}{detail}"
+            )
     if parsed["rejectedOptions"]:
         lines.append("Rejected: " + "; ".join(parsed["rejectedOptions"][:6]))
     lines.append("</decision-anchor>")
     return "\n".join(lines)
 
 
+def _acceptance_evidence_coverage(root: Path, task_path: str | None):
+    """AC evidence coverage facts for the anchor block; a supplementary fact
+    that degrades to absence on any failure instead of degrading injection."""
+    if not task_path:
+        return None
+    try:
+        from services.ac_evidence import coverage_summary
+
+        return coverage_summary(root / task_path)
+    except Exception:
+        return None
+
+
 def _stage_contract_block(
     root: Path, task_path: str | None, status: str
 ) -> str | None:

package/template/.cowork-flow/scripts/services/ac_evidence.py

@@ -0,0 +1,107 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""Acceptance-criteria evidence facts for task completion.
+
+Single read entry for the completion gate, the fact view, and injection:
+which AC ids the decision anchor declares, which are checked, and which
+have at least one evidence record in the task's evidence.jsonl. Judgment
+about whether a record really proves an AC stays with review; the machine
+only decides existence facts.
+"""
+
+from __future__ import annotations
+
+import json
+from pathlib import Path
+from typing import Any
+
+from services.fact_view import parse_decision_anchor
+
+EVIDENCE_FILE = "evidence.jsonl"
+EVIDENCE_KINDS = ("test", "command", "manual")
+
+
+def read_decision_anchor(task_dir: Path) -> str | None:
+    path = Path(task_dir) / "decision-anchor.md"
+    try:
+        text = path.read_text(encoding="utf-8")
+    except (OSError, UnicodeDecodeError):
+        return None
+    return text or None
+
+
+def load_acceptance_criteria(task_dir: Path) -> list[dict[str, Any]]:
+    """AC rows (id / text / checked) declared by the task's decision anchor.
+
+    Empty list when the anchor is missing or declares no AC rows — the
+    compatibility path that keeps pre-existing tasks exempt from the gate."""
+    text = read_decision_anchor(task_dir)
+    if not text:
+        return []
+    return list(parse_decision_anchor(text)["acceptanceCriteria"])
+
+
+def read_evidence(task_dir: Path) -> list[dict[str, Any]]:
+    """Valid evidence records appended by the implementer.
+
+    Bad lines and malformed records are skipped, never fatal: the gate
+    blocks on missing coverage, not on file noise."""
+    path = Path(task_dir) / EVIDENCE_FILE
+    try:
+        text = path.read_text(encoding="utf-8")
+    except (OSError, UnicodeDecodeError):
+        return []
+    records: list[dict[str, Any]] = []
+    for line in text.splitlines():
+        line = line.strip()
+        if not line:
+            continue
+        try:
+            record = json.loads(line)
+        except json.JSONDecodeError:
+            continue
+        if isinstance(record, dict) and _valid_record(record):
+            records.append(record)
+    return records
+
+
+def _valid_record(record: dict[str, Any]) -> bool:
+    ac = record.get("ac")
+    ref = record.get("ref")
+    kind = record.get("kind")
+    return (
+        isinstance(ac, str)
+        and bool(ac.strip())
+        and isinstance(ref, str)
+        and bool(ref.strip())
+        and kind in EVIDENCE_KINDS
+    )
+
+
+def evidence_coverage(
+    acceptance: list[dict[str, Any]],
+    evidence: list[dict[str, Any]],
+) -> dict[str, Any]:
+    """Coverage facts over declared AC ids: total, covered, missing ids."""
+    covered = {
+        record["ac"].strip()
+        for record in evidence
+    }
+    ids = [item["id"] for item in acceptance]
+    missing = [ac_id for ac_id in ids if ac_id not in covered]
+    return {
+        "total": len(ids),
+        "withEvidence": len(ids) - len(missing),
+        "missing": missing,
+    }
+
+
+def coverage_summary(task_dir: Path) -> dict[str, Any] | None:
+    """End-to-end coverage facts for one task.
+
+    None when the task declares no acceptance criteria — consumers treat
+    that as "gate not applicable" instead of a fake zero."""
+    acceptance = load_acceptance_criteria(task_dir)
+    if not acceptance:
+        return None
+    return evidence_coverage(acceptance, read_evidence(task_dir))

package/template/.cowork-flow/scripts/services/fact_view.py

@@ -23,7 +23,7 @@ VERIFY_COMMAND_MAX = 5
 SCOPE_BOUNDARY_TRUNCATE = 160
 ANCHOR_SECTIONS = ("目标", "验收标准", "被拒方案", "验证命令", "范围边界")
 ACCEPTANCE_RE = re.compile(
-    r"^\s*-\s*\[[ xX]?\]\s*(AC-[A-Za-z0-9-]+)\s*[:：]\s*(.+?)\s*$"
+    r"^\s*-\s*(?:\[([ xX])\]?\s*)?(AC-[A-Za-z0-9-]+)\s*[:：]\s*(.+?)\s*$"
 )
 REJECTED_RE = re.compile(r"^\s*-\s*\*\*(.+?)\*\*")
 _HEADING_RE = re.compile(r"^##\s*(.+?)\s*$")
@@ -53,7 +53,11 @@ def parse_decision_anchor(text: str) -> dict[str, Any]:
             match = ACCEPTANCE_RE.match(raw)
             if match:
                 acceptance.append(
-                    {"id": match.group(1), "text": match.group(2)}
+                    {
+                        "id": match.group(2),
+                        "text": match.group(3),
+                        "checked": match.group(1) in ("x", "X"),
+                    }
                 )
         elif section == "被拒方案":
             match = REJECTED_RE.match(raw)
@@ -488,6 +492,15 @@ def build_fact_view(repo_root: Path, task_dir: Path) -> dict[str, Any]:
     else:
         anchor = {"exists": False}
 
+    evidence_coverage: dict[str, Any] | None = None
+    if anchor.get("acceptanceCriteria"):
+        try:
+            from services.ac_evidence import coverage_summary
+
+            evidence_coverage = coverage_summary(task_dir)
+        except Exception:
+            evidence_coverage = None
+
     meta = task.get("meta") if isinstance(task, dict) else None
     plan_file = meta.get("planFile") if isinstance(meta, dict) else None
     plan: dict[str, Any] = {"bound": bool(plan_file)}
@@ -501,6 +514,7 @@ def build_fact_view(repo_root: Path, task_dir: Path) -> dict[str, Any]:
         "taskPath": rel_task,
         "task": task,
         "decisionAnchor": anchor,
+        "evidenceCoverage": evidence_coverage,
         "plan": plan,
         "whitelist": file_scope_whitelist(repo_root, task_dir),
         "sessions": _bound_sessions(repo_root, rel_task),