cowork-flow 0.0.34 → 0.0.36

package/template/.zcode/scaffold/.cowork-flow/run.cmd

@@ -0,0 +1,111 @@
+@echo off
+rem cowork-flow run launcher (ZCode plugin edition)
+rem Delegates to the plugin cache runtime — no local scripts/ required.
+setlocal EnableExtensions
+
+set "MIN_PYTHON_LABEL=Python 3.9+"
+set "VERSION_CHECK=import sys; raise SystemExit(0 if sys.version_info >= (3, 9) else 1)"
+
+set "VERSION_FILE=%~dp0.version"
+set "VERSION="
+for /f "usebackq delims=" %%A in ("%VERSION_FILE%") do set "VERSION=%%A"
+
+if "%VERSION%"=="" (
+  echo Error: cannot determine cowork-flow version (.version missing) >&2
+  exit /b 127
+)
+
+set "ZCODE_BASE=%ZCODE_HOME%"
+if "%ZCODE_BASE%"=="" set "ZCODE_BASE=%USERPROFILE%\.zcode"
+
+set "RUNNER=%ZCODE_BASE%\cli\plugins\cache\zcode-plugins-official\cowork-flow\%VERSION%\hooks\runtime\scripts\run.py"
+
+if not exist "%RUNNER%" (
+  echo Error: cowork-flow plugin runtime not found at: >&2
+  echo   %RUNNER% >&2
+  echo Install the ZCode plugin or run 'cowork-flow init' for standalone. >&2
+  exit /b 127
+)
+
+rem --- Python interpreter discovery ----------------------------------------
+set "SELECTED_PYTHON="
+set "SELECTED_PYTHON_ARG="
+
+call :select_python
+if errorlevel 1 exit /b %ERRORLEVEL%
+
+if not "%SELECTED_PYTHON_ARG%"=="" (
+  "%SELECTED_PYTHON%" "%SELECTED_PYTHON_ARG%" "%RUNNER%" %*
+) else (
+  "%SELECTED_PYTHON%" "%RUNNER%" %*
+)
+exit /b %ERRORLEVEL%
+
+:candidate_is_valid
+set "CANDIDATE_CMD=%~1"
+set "CANDIDATE_ARG=%~2"
+
+where "%CANDIDATE_CMD%" >nul 2>nul
+if errorlevel 1 (
+  if not exist "%CANDIDATE_CMD%" exit /b 1
+)
+
+if not "%CANDIDATE_ARG%"=="" (
+  "%CANDIDATE_CMD%" "%CANDIDATE_ARG%" -c "%VERSION_CHECK%" >nul 2>nul
+) else (
+  "%CANDIDATE_CMD%" -c "%VERSION_CHECK%" >nul 2>nul
+)
+exit /b %ERRORLEVEL%
+
+:select_explicit_python
+set "ENV_NAME=%~1"
+set "ENV_VALUE=%~2"
+
+call :candidate_is_valid "%ENV_VALUE%" ""
+if not errorlevel 1 (
+  set "SELECTED_PYTHON=%ENV_VALUE%"
+  set "SELECTED_PYTHON_ARG="
+  exit /b 0
+)
+
+echo Error: %ENV_NAME% does not point to a usable %MIN_PYTHON_LABEL% interpreter: %ENV_VALUE% 1>&2
+echo Set %ENV_NAME% to an executable Python 3.9+ interpreter path. 1>&2
+exit /b 127
+
+:select_python
+set "SELECTED_PYTHON="
+set "SELECTED_PYTHON_ARG="
+
+if not "%COWORK_FLOW_PYTHON%"=="" (
+  call :select_explicit_python "COWORK_FLOW_PYTHON" "%COWORK_FLOW_PYTHON%"
+  exit /b %ERRORLEVEL%
+)
+
+if not "%PYTHON%"=="" (
+  call :select_explicit_python "PYTHON" "%PYTHON%"
+  exit /b %ERRORLEVEL%
+)
+
+call :candidate_is_valid "python3" ""
+if not errorlevel 1 (
+  set "SELECTED_PYTHON=python3"
+  exit /b 0
+)
+
+call :candidate_is_valid "python" ""
+if not errorlevel 1 (
+  set "SELECTED_PYTHON=python"
+  exit /b 0
+)
+
+call :candidate_is_valid "py" "-3"
+if not errorlevel 1 (
+  set "SELECTED_PYTHON=py"
+  set "SELECTED_PYTHON_ARG=-3"
+  exit /b 0
+)
+
+echo Error: %MIN_PYTHON_LABEL% is required, but no usable interpreter was found. 1>&2
+echo Tried: COWORK_FLOW_PYTHON, PYTHON, python3, python, py -3. 1>&2
+echo Set COWORK_FLOW_PYTHON=C:\Path\To\python.exe and retry. 1>&2
+exit /b 127

package/template/.zcode/scaffold/.cowork-flow/spec/runtime/rules.json

@@ -61,18 +61,6 @@
       "source_excerpt": "L2（结构性）",
       "enforcement": "validate_rules"
     },
-    {
-      "id": "R-WF-006",
-      "type": "phase_gate",
-      "severity": "warn",
-      "scope": "implement",
-      "condition": "实现前必须有失败测试（行为变化场景）",
-      "message": "Implementation without failing test for behavior change",
-      "fix_hint": "先编写失败测试，再实现功能，确保测试在实现后通过",
-      "source_file": ".cowork-flow/workflow.md",
-      "source_excerpt": "先写能失败的测试",
-      "enforcement": "tdd_evidence"
-    },
     {
       "id": "R-WF-007",
       "type": "phase_gate",
@@ -86,63 +74,39 @@
       "enforcement": "validate_rules"
     },
     {
-      "id": "R-AG-001",
-      "type": "forbidden_action",
+      "id": "R-WF-008",
+      "type": "phase_gate",
       "severity": "block",
-      "scope": "all",
-      "condition": "子代理不派发其他代理",
-      "message": "Subagent attempted to dispatch another agent",
-      "fix_hint": "子代理是叶子执行者，不能派发、等待、列出或取消其他代理",
-      "source_file": "AGENTS.md",
-      "source_excerpt": "cowork-* 固定代理是叶子执行者",
-      "enforcement": "host_contract"
+      "scope": "task_start",
+      "condition": "任务必须有 decision-anchor.md 且包含目标和验收标准章节",
+      "message": "Drift prevention: decision-anchor.md is missing or incomplete",
+      "fix_hint": "创建 <task-dir>/decision-anchor.md，至少包含 ## 目标和 ## 验收标准",
+      "source_file": ".cowork-flow/spec/contracts/decision-anchor.md",
+      "source_excerpt": "每个任务必须有决策锚点",
+      "enforcement": "validate_rules"
     },
     {
       "id": "R-AG-002",
       "type": "forbidden_action",
       "severity": "block",
-      "scope": "all",
-      "condition": "子代理不修改规格文件",
+      "scope": "implement",
+      "condition": "不修改规格文件",
       "message": "Subagent attempted to modify spec files",
       "fix_hint": "规格文件只能由主会话修改，子代理应专注于实现任务",
-      "source_file": "AGENTS.md",
+      "source_file": ".cowork-flow/spec/contracts/subagent-dispatch.md",
       "source_excerpt": "cowork-* 固定代理是叶子执行者",
       "enforcement": "validate_implementation"
     },
-    {
-      "id": "R-AG-003",
-      "type": "forbidden_action",
-      "severity": "block",
-      "scope": "all",
-      "condition": "子代理不操作 Git",
-      "message": "Subagent attempted to operate Git",
-      "fix_hint": "Git 操作只能由主会话执行，子代理应专注于代码实现",
-      "source_file": "AGENTS.md",
-      "source_excerpt": "cowork-* 固定代理是叶子执行者",
-      "enforcement": "host_contract"
-    },
-    {
-      "id": "R-AG-004",
-      "type": "forbidden_action",
-      "severity": "block",
-      "scope": "all",
-      "condition": "子代理不提交/归档",
-      "message": "Subagent attempted to commit or archive",
-      "fix_hint": "提交和归档只能由主会话执行，子代理应专注于代码实现",
-      "source_file": "AGENTS.md",
-      "source_excerpt": "cowork-* 固定代理是叶子执行者",
-      "enforcement": "host_contract"
-    },
     {
       "id": "R-AG-005",
       "type": "forbidden_action",
       "severity": "block",
       "scope": "implement",
-      "condition": "不添加未要求的功能",
-      "message": "Unrequested feature introduced",
-      "fix_hint": "只实现 PRD 中明确要求的功能，不添加额外功能",
-      "source_file": "AGENTS.md",
-      "source_excerpt": "不添加未要求的功能",
+      "condition": "不修改 implement.jsonl 允许范围外的文件",
+      "message": "Modified file not in implement.jsonl allowed list",
+      "fix_hint": "通过 ./.cowork-flow/run task add-context <dir> implement <path> <reason> 登记所有需要修改的文件",
+      "source_file": ".cowork-flow/spec/contracts/decision-anchor.md",
+      "source_excerpt": "implement.jsonl 是任务的权威文件白名单",
       "enforcement": "validate_implementation"
     },
     {
@@ -156,78 +120,6 @@
       "source_file": "AGENTS.md",
       "source_excerpt": "不为一次性代码做抽象",
       "enforcement": "validate_implementation"
-    },
-    {
-      "id": "R-AG-007",
-      "type": "forbidden_action",
-      "severity": "block",
-      "scope": "implement",
-      "condition": "不顺手重构无关模块",
-      "message": "Unrelated module refactored during implementation",
-      "fix_hint": "只修改与当前任务直接相关的代码，不扩大改动范围",
-      "source_file": "AGENTS.md",
-      "source_excerpt": "不顺手重构无关模块",
-      "enforcement": "host_contract"
-    },
-    {
-      "id": "R-WF-008",
-      "type": "phase_gate",
-      "severity": "warn",
-      "scope": "task_start",
-      "condition": "L2 任务的关键决策应有 doubt-review 记录",
-      "message": "Missing doubt-review for L2 non-trivial decision",
-      "fix_hint": "在 <task>/doubt-review.md 中为每个非平凡决策完成 5-step doubt cycle",
-      "source_file": ".cowork-flow/spec/contracts/subagent-dispatch.md",
-      "source_excerpt": "doubt-review is a mandatory sub-step of before-dev gate for L2",
-      "enforcement": "validate_rules"
-    },
-    {
-      "id": "R-WF-009",
-      "type": "phase_gate",
-      "severity": "warn",
-      "scope": "check",
-      "condition": "Bug fix must have regression test that fails without the fix",
-      "message": "Bug fix lacks regression test or modifies existing test to pass",
-      "fix_hint": "Record red-green evidence in tdd.jsonl; test must fail without the fix and pass with the fix",
-      "source_file": ".cowork-flow/workflow.md",
-      "source_excerpt": "先写能失败的测试",
-      "enforcement": "tdd_evidence"
-    },
-    {
-      "id": "R-WF-010",
-      "type": "phase_gate",
-      "severity": "block",
-      "scope": "all",
-      "condition": "Batch mode requires explicit user approval before starting",
-      "message": "Batch mode started without explicit user approval",
-      "fix_hint": "用户必须在 writing-plans 结束时明确说 'approved' + 'auto' 才能进入批模式",
-      "source_file": ".cowork-flow/workflow.md",
-      "source_excerpt": "用户是流程的最终决策者",
-      "enforcement": "host_contract"
-    },
-    {
-      "id": "R-AG-008",
-      "type": "forbidden_action",
-      "severity": "warn",
-      "scope": "check",
-      "condition": "Simplification must preserve observable behavior",
-      "message": "Simplification appears to change observable behavior",
-      "fix_hint": "简化不应改变测试结果。如果测试需要修改才能通过，行为已变——还原或重写测试",
-      "source_file": ".cowork-flow/workflow.md",
-      "source_excerpt": "外科手术式改动: 只改必须改的",
-      "enforcement": "metadata_only"
-    },
-    {
-      "id": "R-WF-011",
-      "type": "phase_gate",
-      "severity": "warn",
-      "scope": "all",
-      "condition": "Archive should happen before final commit to avoid committing unreviewed code",
-      "message": "Uncommitted changes detected. Archive the task first, then commit the archived result.",
-      "fix_hint": "Run './.cowork-flow/run task archive <name>' first. Then commit the archive result.",
-      "source_file": ".cowork-flow/workflow.md",
-      "source_excerpt": "归档后再提交",
-      "enforcement": "validate_rules"
     }
   ]
 }

package/template/.zcode/scaffold/.cowork-flow/spec/schemas/rules.schema.json

@@ -67,8 +67,8 @@
           },
           "enforcement": {
             "type": "string",
-            "enum": ["validate_rules", "validate_implementation", "tdd_evidence", "host_contract", "metadata_only"],
-            "description": "Runtime or contract surface responsible for enforcing or carrying this rule"
+            "enum": ["validate_rules", "validate_implementation"],
+            "description": "Runtime surface responsible for enforcing this rule. Must have a corresponding validator module."
           }
         },
         "additionalProperties": false

package/template/skills/check/SKILL.md

@@ -20,7 +20,7 @@ Use this after implementation and before `finish-work`.
 
 ## Steps
 
-1. Read active task PRD, plan, and `check.jsonl`.
+1. Read active task decision-anchor.md, plan, and `check.jsonl`.
 2. Review `git diff --name-only` and `git diff`.
 3. Check contracts across caller/callee, command output, persisted state, templates, and docs.
 4. Verify spec compliance:
@@ -31,7 +31,7 @@ Use this after implementation and before `finish-work`.
 6. Review test intent: reject shallow tests that do not fail for meaningful behavior breaks.
 7. Run focused tests that would fail if the changed behavior broke.
 8. Run broader validation when the change touches shared runtime, templates, packaging, or public workflow.
-9. Report `test_intent_review` with the key tests that defend PRD acceptance behavior.
+9. Report `test_intent_review` with the key tests that defend decision-anchor.md acceptance behavior.
 10. Report spec compliance: for each spec/ file checked, state pass/fail with evidence from the diff.
 
 ## Report

package/template/skills/game-design/SKILL.md

@@ -29,7 +29,7 @@ The following guidelines live in `.cowork-flow/spec/game/` and should be read be
 ## Usage
 
 1. Read the relevant spec/game/ guide(s) first.
-2. Read the task PRD and implement.jsonl context.
+2. Read the task decision-anchor.md and implement.jsonl context.
 3. Proceed with implementation through `cowork-implement` or directly (depending on scope).
 
 ## When NOT to use

package/template/skills/start/SKILL.md

@@ -19,7 +19,7 @@ child must run the explicit shim bind before formal work.
 2. Read `.cowork-flow/workflow.md`.
 3. Read `.cowork-flow/config.yaml` for Codex dispatch hints and lifecycle hooks.
 4. Run `.cowork-flow/run resume` or `.\.cowork-flow\run.cmd resume` on Windows.
-5. Read the active task PRD and JSONL indexes only when a task is active.
+5. Read the active task decision-anchor.md and JSONL indexes only when a task is active.
 6. Read relevant `.cowork-flow/spec/*/index.md` files before code changes.
 
 Report active task, workflow state, blockers, and the next phase.
@@ -32,7 +32,7 @@ state is loaded, apply the requirement clarification gate from
 `.cowork-flow/workflow.md`, then route to the next workflow phase; clear
 multi-step implementation uses `writing-plans` before fixed-agent dispatch.
 
-New requirements that are unclear, boundary-unclear, multi-approach, behavior-changing, or missing acceptance criteria use `brainstorming` before PRD, planning, or fixed-agent dispatch. Small repository changes proceed directly only when the goal, scope boundary, and acceptance criteria are already clear.
+New requirements that are unclear, boundary-unclear, multi-approach, behavior-changing, or missing acceptance criteria use `brainstorming` before writing decision-anchor.md, planning, or fixed-agent dispatch. Small repository changes proceed directly only when the goal, scope boundary, and acceptance criteria are already clear.
 
 - Question-only work: answer directly.
 - Small repository change with clear goal/scope/acceptance: classify by `.cowork-flow/workflow.md`, create/start a task if required, then proceed.

package/template/skills/tdd/SKILL.md

@@ -9,7 +9,7 @@ Use this before editing behavior-changing code.
 
 ## Red-Green-Refactor
 
-1. Map the task PRD acceptance criteria to stable IDs such as `AC-001`.
+1. Map the task decision-anchor.md acceptance criteria to stable IDs such as `AC-001`.
 2. Write the smallest meaningful failing test first.
 3. Run the red command and confirm it fails because the target behavior is missing or wrong.
 4. Implement the smallest change that makes the behavior pass.
@@ -38,7 +38,7 @@ Record TDD proof in `<task>/tdd.jsonl`. Each evidence line is one JSON object:
 }
 ```
 
-Every evidence record must map to a PRD `acceptanceId`. The red failure must be about the target behavior, not syntax, import, environment, fixture, or setup failure.
+Every evidence record must map to a decision-anchor.md `acceptanceId`. The red failure must be about the target behavior, not syntax, import, environment, fixture, or setup failure.
 
 `testName` must resolve to the exact behavior test in `testFile`. Use one of:
 `test_method`, `ClassName.test_method`, or `module.ClassName.test_method`.

package/template/skills/writing-plans/SKILL.md

@@ -13,7 +13,7 @@ Before writing a plan, confirm the request has an executable scope, acceptance c
 
 Read:
 
-- Active task PRD.
+- Active task decision-anchor.md.
 - Relevant change spec/design files.
 - Relevant `.cowork-flow/spec/` indexes and target specs.
 - Files that define the contracts being changed.
@@ -64,7 +64,7 @@ Start with:
 - Include a failing test before implementation when behavior can be tested.
 - Do not add shallow tests just to satisfy process. Avoid tests that only assert existence, mirror implementation details, count mocks without behavior, or snapshot empty structure.
 - For complex problems, test depth first: cover invariants, cross-layer contracts, state transitions, error boundaries, and real regression paths before narrow unit cases.
-- Map each behavior-changing test to a stable PRD acceptance ID and note where `tdd.jsonl` will record the red-green evidence.
+- Map each behavior-changing test to a stable decision-anchor.md acceptance ID and note where `tdd.jsonl` will record the red-green evidence.
 - Avoid placeholders such as TODO, TBD, "handle edge cases", or "write tests".
 - Keep root/template parity explicit when both copies exist.
 
@@ -74,7 +74,7 @@ Start with:
 |---|---|
 | "这个 task 太小了，可以合并" | task 粒度由 acceptance criteria 决定，不由行数决定。AC 不可拆分时应合并，否则独立。 |
 | "先写个粗 plan，实现时再细化" | 粗 plan = 实现时没有约束。没有约束的实现 = 范围蔓延或返工。 |
-| "跳过 plan 直接开始反正有了 PRD" | PRD 定义"做什么"，plan 定义"怎么做和按什么顺序做"。缺少 plan 的任务在 midway 发现依赖错误时返工成本翻倍。 |
+| "跳过 plan 直接开始反正有了 decision-anchor" | decision-anchor.md 定义"做什么"，plan 定义"怎么做和按什么顺序做"。缺少 plan 的任务在 midway 发现依赖错误时返工成本翻倍。 |
 | "这个 task 不需要 verify 命令" | 没有 verify = 没有完成信号。每个 task 必须有可运行的验证命令。 |
 
 ## Plan Approval Gate
@@ -110,7 +110,7 @@ Execution strategy guide:
 
 Before handoff:
 
-1. Confirm every PRD acceptance criterion maps to a plan step.
+1. Confirm every decision-anchor.md acceptance criterion maps to a plan step.
 2. Search the plan for placeholders.
 3. Check names, paths, command syntax, and expected outputs.
 4. Record remaining risks or blockers.

package/template/.zcode/hooks/runtime/run

@@ -1,58 +0,0 @@
-#!/bin/sh
-# cowork-flow run launcher (ZCode plugin edition)
-# Runs commands using the plugin's bundled Python runtime.
-set -u
-
-MIN_PYTHON_LABEL="Python 3.9+"
-VERSION_CHECK='import sys; raise SystemExit(0 if sys.version_info >= (3, 9) else 1)'
-WORKFLOW_DIR=$(CDPATH= cd "$(dirname "$0")" && pwd) || exit 1
-
-# Plugin cache runtime (resolved relative to this script)
-# Path: hooks/runtime/run -> hooks/runtime/scripts/run.py
-RUNTIME_SCRIPTS="$WORKFLOW_DIR/scripts"
-
-if [ ! -d "$RUNTIME_SCRIPTS" ]; then
-  echo "Error: cowork-flow runtime not found. Expected at: $RUNTIME_SCRIPTS" >&2
-  exit 127
-fi
-
-RUNNER_SCRIPT="$RUNTIME_SCRIPTS/run.py"
-if [ ! -f "$RUNNER_SCRIPT" ]; then
-  echo "Error: run.py not found in runtime: $RUNTIME_SCRIPTS" >&2
-  exit 127
-fi
-
-candidate_is_valid() {
-  command -v "$1" >/dev/null 2>&1 || return 1
-  "$1" -c "$VERSION_CHECK" >/dev/null 2>&1
-}
-
-select_python() {
-  if candidate_is_valid "python3"; then
-    SELECTED_PYTHON=python3
-    return 0
-  fi
-  if candidate_is_valid "python"; then
-    SELECTED_PYTHON=python
-    return 0
-  fi
-  if candidate_is_valid "py"; then
-    SELECTED_PYTHON=py
-    SELECTED_PYTHON_ARG=-3
-    return 0
-  fi
-  echo "Error: $MIN_PYTHON_LABEL required but not found." >&2
-  exit 127
-}
-
-select_python
-
-SELECTED_PYTHON_ARG=${SELECTED_PYTHON_ARG:-}
-
-if [ -n "$SELECTED_PYTHON_ARG" ]; then
-  export PYTHONPATH="$RUNTIME_SCRIPTS${PYTHONPATH:+:$PYTHONPATH}"
-  exec "$SELECTED_PYTHON" "$SELECTED_PYTHON_ARG" "$RUNNER_SCRIPT" "$@"
-fi
-
-export PYTHONPATH="$RUNTIME_SCRIPTS${PYTHONPATH:+:$PYTHONPATH}"
-exec "$SELECTED_PYTHON" "$RUNNER_SCRIPT" "$@"

package/template/.zcode/hooks/runtime/run.cmd

@@ -1,37 +0,0 @@
-@echo off
-setlocal EnableExtensions
-
-set "MIN_PYTHON_LABEL=Python 3.9+"
-set "VERSION_CHECK=import sys; raise SystemExit(0 if sys.version_info >= (3, 9) else 1)"
-set "WORKFLOW_DIR=%~dp0"
-
-set "RUNTIME_SCRIPTS=%WORKFLOW_DIR%scripts"
-
-if not exist "%RUNTIME_SCRIPTS%\run.py" (
-  echo Error: cowork-flow runtime not found. >&2
-  exit /b 127
-)
-
-where python3 >nul 2>nul
-if not errorlevel 1 (
-  set "PYTHONPATH=%RUNTIME_SCRIPTS%;%PYTHONPATH%"
-  python3 "%RUNTIME_SCRIPTS%\run.py" %*
-  exit /b %ERRORLEVEL%
-)
-
-where python >nul 2>nul
-if not errorlevel 1 (
-  set "PYTHONPATH=%RUNTIME_SCRIPTS%;%PYTHONPATH%"
-  python "%RUNTIME_SCRIPTS%\run.py" %*
-  exit /b %ERRORLEVEL%
-)
-
-where py >nul 2>nul
-if not errorlevel 1 (
-  set "PYTHONPATH=%RUNTIME_SCRIPTS%;%PYTHONPATH%"
-  py -3 "%RUNTIME_SCRIPTS%\run.py" %*
-  exit /b %ERRORLEVEL%
-)
-
-echo Error: %MIN_PYTHON_LABEL% required but not found. >&2
-exit /b 127

package/template/.zcode/hooks/runtime/scripts/commands/__init__.py

@@ -1 +0,0 @@
-"""Command entrypoints for cowork-flow."""

package/template/.zcode/hooks/runtime/scripts/commands/_bootstrap.py

@@ -1,10 +0,0 @@
-"""Allow command scripts to import the sibling common package when run directly."""
-
-from __future__ import annotations
-
-import sys
-from pathlib import Path
-
-SCRIPTS_DIR = Path(__file__).resolve().parents[1]
-if str(SCRIPTS_DIR) not in sys.path:
-    sys.path.insert(0, str(SCRIPTS_DIR))