@house365/comate 0.10.2 → 1.0.2-next.0

package/skills/comate/tests/comate.bats

@@ -1,1019 +0,0 @@
-#!/usr/bin/env bats
-# comate state-machine + library tests.
-# Run with: bats skills/comate/tests/comate.bats
-# (or: bash skills/comate/tests/run.sh  — plain-bash fallback, no bats needed)
-
-setup() {
-  COMATE_ROOT="$(cd "$BATS_TEST_DIRNAME/../.." && pwd)"
-  COMATE="$COMATE_ROOT/comate/scripts/comate.sh"
-  [ -f "$COMATE" ] || COMATE="$BATS_TEST_DIRNAME/../scripts/comate.sh"
-  export COMATE_SKIP_BUILD=1
-  WORK="$(mktemp -d)"
-  cd "$WORK"
-  git init -q
-  git config user.email t@t.t
-  git config user.name t
-  git commit -q --allow-empty -m init
-  mkdir -p openspec/changes
-}
-
-teardown() {
-  cd /
-  rm -rf "$WORK"
-}
-
-comate() { bash "$COMATE" "$@"; }
-
-seed_open() {
-  comate state demo init full >/dev/null
-  local d="openspec/changes/demo"
-  printf '# proposal\n' > "$d/proposal.md"
-  printf '# design\n' > "$d/design.md"
-  printf -- '- [ ] t1\n' > "$d/tasks.md"
-}
-
-# --- init / get / set ---
-
-@test "init writes canonical field order with schema_version" {
-  comate state demo init full
-  run comate state demo get schema_version
-  [ "$status" -eq 0 ]
-  [ "$output" = "1" ]
-  run comate state demo get phase
-  [ "$output" = "open" ]
-}
-
-@test "init full leaves build decisions null" {
-  comate state demo init full
-  [ "$(comate state demo get build_mode)" = "null" ]
-  [ "$(comate state demo get tdd_mode)" = "null" ]
-  [ "$(comate state demo get isolation)" = "null" ]
-}
-
-@test "init fix prefills preset defaults" {
-  comate state demo init fix
-  [ "$(comate state demo get build_mode)" = "direct" ]
-  [ "$(comate state demo get tdd_mode)" = "direct" ]
-  [ "$(comate state demo get isolation)" = "branch" ]
-  [ "$(comate state demo get verify_mode)" = "light" ]
-}
-
-@test "init records base_ref and base_branch" {
-  comate state demo init full
-  run comate state demo get base_ref
-  [ "$output" != "null" ]
-  run comate state demo get base_branch
-  [ "$output" != "null" ]
-}
-
-@test "init twice fails with usage error" {
-  comate state demo init full
-  run comate state demo init full
-  [ "$status" -eq 2 ]
-}
-
-@test "set rejects unknown field" {
-  comate state demo init full
-  run comate state demo set bogus_field x
-  [ "$status" -eq 2 ]
-}
-
-@test "set rejects bad enum value" {
-  comate state demo init full
-  run comate state demo set phase nonsense
-  [ "$status" -eq 2 ]
-}
-
-@test "set rejects bad tdd_mode value" {
-  comate state demo init full
-  run comate state demo set tdd_mode maybe
-  [ "$status" -eq 2 ]
-}
-
-@test "set is idempotent and keeps single key" {
-  comate state demo init full
-  comate state demo set verify_mode light >/dev/null
-  comate state demo set verify_mode full >/dev/null
-  local count
-  count=$(grep -c '^verify_mode:' "openspec/changes/demo/.comate.yaml")
-  [ "$count" -eq 1 ]
-  [ "$(comate state demo get verify_mode)" = "full" ]
-}
-
-# --- input validation ---
-
-@test "path traversal in change name rejected" {
-  run comate state "../evil" get phase
-  [ "$status" -eq 2 ]
-}
-
-@test "get on missing yaml returns corrupt code" {
-  run comate state nope get phase
-  [ "$status" -eq 4 ]
-}
-
-# --- flat yaml validation ---
-
-@test "validate passes on clean init" {
-  comate state demo init full
-  run comate state demo validate
-  [ "$status" -eq 0 ]
-}
-
-@test "validate rejects nested yaml with corrupt code" {
-  comate state demo init full
-  printf 'nested:\n  child: 1\n' >> "openspec/changes/demo/.comate.yaml"
-  run comate state demo validate
-  [ "$status" -eq 4 ]
-}
-
-@test "validate rejects list items" {
-  comate state demo init full
-  printf -- '- item\n' >> "openspec/changes/demo/.comate.yaml"
-  run comate state demo validate
-  [ "$status" -eq 4 ]
-}
-
-# --- state machine transitions ---
-
-@test "transition rejects wrong-phase event" {
-  comate state demo init full
-  run comate state demo transition design-complete
-  [ "$status" -eq 1 ]
-}
-
-@test "open-complete routes full to design" {
-  seed_open
-  comate state demo set phase_step open.review-confirmed >/dev/null
-  comate state demo transition open-complete
-  [ "$(comate state demo get phase)" = "design" ]
-  [ "$(comate state demo get phase_step)" = "null" ]
-}
-
-@test "open-complete routes fix to build" {
-  comate state demo init fix
-  comate state demo transition open-complete
-  [ "$(comate state demo get phase)" = "build" ]
-}
-
-@test "build-complete blocked without isolation" {
-  comate state demo init fix
-  comate state demo transition open-complete
-  comate state demo set isolation null >/dev/null
-  run comate state demo transition build-complete
-  [ "$status" -eq 1 ]
-}
-
-@test "full direct build blocked without override" {
-  comate state demo init full
-  comate state demo set isolation branch >/dev/null
-  comate state demo set build_mode direct >/dev/null
-  comate state demo set tdd_mode direct >/dev/null
-  # force phase to build to isolate the decision check
-  comate state demo set phase build >/dev/null
-  run comate state demo transition build-complete
-  [ "$status" -eq 1 ]
-}
-
-@test "build-complete blocked without tdd_mode" {
-  comate state demo init full
-  comate state demo set isolation branch >/dev/null
-  comate state demo set build_mode executing-plans >/dev/null
-  comate state demo set phase build >/dev/null
-  run comate state demo transition build-complete
-  [ "$status" -eq 1 ]
-  [[ "$output" == *"tdd_mode"* ]]
-}
-
-@test "build-complete accepts tdd_mode tdd" {
-  comate state demo init full
-  comate state demo set isolation branch >/dev/null
-  comate state demo set build_mode executing-plans >/dev/null
-  comate state demo set tdd_mode tdd >/dev/null
-  comate state demo set phase build >/dev/null
-  run comate state demo transition build-complete
-  [ "$status" -eq 0 ]
-  [ "$(comate state demo get phase)" = "verify" ]
-}
-
-@test "verify-pass blocked without report" {
-  comate state demo init full
-  comate state demo set phase verify >/dev/null
-  run comate state demo transition verify-pass
-  [ "$status" -eq 1 ]
-}
-
-@test "fix-upgrade resets preset decisions and enters design" {
-  comate state demo init fix
-  comate state demo transition open-complete
-  comate state demo set phase_step build.options-confirmed >/dev/null
-  comate state demo transition fix-upgrade
-  [ "$(comate state demo get workflow)" = "full" ]
-  [ "$(comate state demo get phase)" = "design" ]
-  [ "$(comate state demo get build_mode)" = "null" ]
-  [ "$(comate state demo get tdd_mode)" = "null" ]
-  [ "$(comate state demo get isolation)" = "null" ]
-  [ "$(comate state demo get phase_step)" = "null" ]
-}
-
-@test "discarded branch cannot pass verification" {
-  comate state demo init full
-  comate state demo set phase verify >/dev/null
-  printf '# pass\n' > report.md
-  comate state demo set verification_report report.md >/dev/null
-  comate state demo set branch_status discarded >/dev/null
-  run comate state demo transition verify-pass
-  [ "$status" -eq 1 ]
-  [ "$(comate state demo get phase)" = "verify" ]
-}
-
-@test "verify-fail returns to build without a failure routing loop" {
-  comate state demo init full
-  comate state demo set phase verify >/dev/null
-  comate state demo set verify_result fail >/dev/null
-  comate state demo transition verify-fail
-  [ "$(comate state demo get phase)" = "build" ]
-  [ "$(comate state demo get verify_result)" = "pending" ]
-  [ "$(comate state demo get verification_report)" = "null" ]
-}
-
-@test "verify-fail keeps build authoritative when tasks remain checked" {
-  comate state demo init full
-  printf '%s\n' '# Tasks' '- [x] already implemented' > openspec/changes/demo/tasks.md
-  comate state demo set phase verify >/dev/null
-  comate state demo set verify_result fail >/dev/null
-  comate state demo transition verify-fail
-  [ "$(comate state demo get phase)" = "build" ]
-  [ "$(comate state demo get verify_result)" = "pending" ]
-  # The router must use the persisted phase; task completion is not a phase.
-  [ "$(comate state demo get phase)" != "verify" ]
-}
-
-@test "recover reports phase-local progress" {
-  comate state demo init full
-  comate state demo set phase_step open.review-awaiting >/dev/null
-  run comate state demo recover open
-  [ "$status" -eq 0 ]
-  [[ "$output" == *"Phase step: open.review-awaiting"* ]]
-}
-
-@test "status exposes awaiting decisions" {
-  comate state demo init full
-  comate state demo set phase_step open.review-awaiting >/dev/null
-  run comate status
-  [ "$status" -eq 0 ]
-  [[ "$output" == *"step: open.review-awaiting"* ]]
-}
-
-# --- guard open ---
-
-@test "guard open passes with full artifacts and applies" {
-  seed_open
-  printf -- '- [x] t1\n' > "openspec/changes/demo/tasks.md"
-  run comate guard demo open --apply
-  [ "$status" -eq 0 ]
-  [ "$(comate state demo get phase)" = "design" ]
-}
-
-@test "fix guards continuously advance open to build to verify" {
-  comate state demo init fix
-  local d="openspec/changes/demo"
-  printf '# p\n' > "$d/proposal.md"
-  printf '# d\n' > "$d/design.md"
-  printf -- '- [x] t1\n' > "$d/tasks.md"
-
-  comate guard demo open --apply >/dev/null 2>&1
-  [ "$(comate state demo get phase)" = "build" ]
-
-  comate handoff demo build --write >/dev/null 2>&1
-  comate guard demo build --apply >/dev/null 2>&1
-  [ "$(comate state demo get phase)" = "verify" ]
-}
-
-@test "guard open json emits block false" {
-  seed_open
-  run comate guard demo open --json
-  [ "$status" -eq 0 ]
-  [[ "$output" == *'"block":false'* ]]
-}
-
-# --- handoff design + hash drift ---
-
-@test "design handoff writes context and hash" {
-  seed_open
-  comate guard demo open --apply >/dev/null 2>&1
-  comate handoff demo design --write
-  run comate state demo get handoff_hash
-  [[ "$output" =~ ^[a-f0-9]{64}$ ]]
-}
-
-@test "design guard blocks on handoff hash drift" {
-  seed_open
-  comate guard demo open --apply >/dev/null 2>&1
-  comate handoff demo design --write >/dev/null 2>&1
-  printf 'edited after handoff\n' >> "openspec/changes/demo/proposal.md"
-  run comate guard demo design --json
-  [ "$status" -eq 1 ]
-  [[ "$output" == *'"block":true'* ]]
-}
-
-# --- build->verify drift ---
-
-@test "verify guard blocks when tasks change after build handoff" {
-  comate state demo init fix
-  local d="openspec/changes/demo"
-  printf '# p\n' > "$d/proposal.md"; printf '# d\n' > "$d/design.md"; printf -- '- [x] t1\n' > "$d/tasks.md"
-  comate guard demo open --apply >/dev/null 2>&1
-  comate handoff demo build --write >/dev/null 2>&1
-  comate guard demo build --apply >/dev/null 2>&1
-  printf 'rep\n' > "$d/rep.md"
-  comate state demo set verification_report "$d/rep.md" >/dev/null
-  comate state demo set branch_status handled >/dev/null
-  # tamper tasks after build exit
-  printf -- '- [x] t1\n- [x] sneaked\n' > "$d/tasks.md"
-  run comate guard demo verify --json
-  [ "$status" -eq 1 ]
-  [[ "$output" == *'impl_hash'*'fail'* ]] || [[ "$output" == *'"block":true'* ]]
-}
-
-# --- line-ending stability ---
-
-@test "impl_hash ignores text line-ending changes" {
-  comate state demo init fix
-  local d="openspec/changes/demo"
-  printf '# p\n' > "$d/proposal.md"
-  printf '# d\n' > "$d/design.md"
-  printf '# plan\n' > "$d/plan.md"
-  printf -- '- [x] t1\n' > "$d/tasks.md"
-  comate state demo set plan "$d/plan.md" >/dev/null
-  comate guard demo open --apply >/dev/null 2>&1
-  comate handoff demo build --write >/dev/null 2>&1
-  comate guard demo build --apply >/dev/null 2>&1
-
-  printf '# plan\r\n' > "$d/plan.md"
-  printf -- '- [x] t1\r\n' > "$d/tasks.md"
-  printf 'verification\n' > "$d/verification.md"
-  comate state demo set verification_report "$d/verification.md" >/dev/null
-  comate state demo set branch_status handled >/dev/null
-  run comate guard demo verify --json
-  [ "$status" -eq 0 ]
-  [[ "$output" == *'impl_hash matches current plan+tasks'*'pass'* ]]
-}
-
-# --- archive ---
-
-@test "archive delegates spec merge to openspec instead of copying delta over main" {
-  comate state demo init full
-  local d="openspec/changes/demo"
-  printf '# p\n' > "$d/proposal.md"
-  printf '# d\n' > "$d/design.md"
-  printf -- '- [x] t1\n' > "$d/tasks.md"
-  mkdir -p "$d/specs/cap" openspec/specs/cap bin
-  printf '# Main Spec\n\n## Requirements\n\n### Requirement: Existing\n' > openspec/specs/cap/spec.md
-  printf '## ADDED Requirements\n\n### Requirement: Delta Only\n' > "$d/specs/cap/spec.md"
-
-  cat > bin/openspec <<'SH'
-#!/bin/bash
-set -e
-[ "$1" = "archive" ] || exit 2
-name="$2"
-mkdir -p openspec/changes/archive
-mv "openspec/changes/$name" "openspec/changes/archive/$(date +%Y-%m-%d)-$name"
-SH
-  chmod +x bin/openspec
-  export PATH="$PWD/bin:$PATH"
-
-  comate state demo set phase archive >/dev/null
-  comate state demo set verify_result pass >/dev/null
-  run comate archive demo
-  [ "$status" -eq 0 ]
-  [[ "$(cat openspec/specs/cap/spec.md)" == *"Requirement: Existing"* ]]
-  [[ "$(cat openspec/specs/cap/spec.md)" != *"Delta Only"* ]]
-  [ "$(comate state "$(date +%Y-%m-%d)-demo" get archived)" = "true" ]
-}
-
-@test "archive repoints .comate.yaml self-pointers to archive path" {
-  comate state demo init full
-  local d="openspec/changes/demo"
-  printf '# p\n' > "$d/proposal.md"; printf '# d\n' > "$d/design.md"; printf -- '- [x] t1\n' > "$d/tasks.md"
-  mkdir -p docs/knowledge-base/cb bin
-  printf '# source\n' > docs/knowledge-base/cb/source.md
-  comate sources demo track docs/knowledge-base/cb/source.md >/dev/null 2>&1
-  cat > bin/openspec <<'SH'
-#!/bin/bash
-set -e
-[ "$1" = "archive" ] || exit 2
-mkdir -p openspec/changes/archive
-mv "openspec/changes/$2" "openspec/changes/archive/$(date +%Y-%m-%d)-$2"
-SH
-  chmod +x bin/openspec
-  export PATH="$PWD/bin:$PATH"
-  comate state demo set phase archive >/dev/null
-  comate state demo set verify_result pass >/dev/null
-  run comate archive demo
-  [ "$status" -eq 0 ]
-  local an="$(date +%Y-%m-%d)-demo"
-  [ "$(comate state "$an" get source_manifest)" = "openspec/changes/archive/$an/.comate/sources.manifest" ]
-  run comate sources "$an" check
-  [ "$status" -eq 0 ]
-}
-
-@test "archive rewrites design doc body references to archive path" {
-  comate state demo init full
-  local d="openspec/changes/demo"
-  printf '# p\n' > "$d/proposal.md"; printf '# d\n' > "$d/design.md"; printf -- '- [x] t1\n' > "$d/tasks.md"
-  mkdir -p docs/superpowers/specs bin
-  printf -- '---\ncomate_change: demo\nrole: technical-design\ncanonical_spec: openspec\n---\nref: openspec/changes/demo/specs/cap/spec.md\n' > docs/superpowers/specs/dd.md
-  comate state demo set design_doc docs/superpowers/specs/dd.md >/dev/null
-  cat > bin/openspec <<'SH'
-#!/bin/bash
-set -e
-[ "$1" = "archive" ] || exit 2
-mkdir -p openspec/changes/archive
-mv "openspec/changes/$2" "openspec/changes/archive/$(date +%Y-%m-%d)-$2"
-SH
-  chmod +x bin/openspec
-  export PATH="$PWD/bin:$PATH"
-  comate state demo set phase archive >/dev/null
-  comate state demo set verify_result pass >/dev/null
-  run comate archive demo
-  [ "$status" -eq 0 ]
-  local an="$(date +%Y-%m-%d)-demo"
-  [[ "$(cat docs/superpowers/specs/dd.md)" == *"openspec/changes/archive/$an/specs/cap/spec.md"* ]]
-  [[ "$(cat docs/superpowers/specs/dd.md)" == *"comate_change: demo"* ]]
-  [[ "$(cat docs/superpowers/specs/dd.md)" == *"archived-with: $an"* ]]
-}
-
-# --- scale ---
-
-@test "scale sets verify_mode full when many tasks" {
-  comate state demo init full
-  local d="openspec/changes/demo"
-  printf -- '- [ ] a\n- [ ] b\n- [ ] c\n- [ ] d\n' > "$d/tasks.md"
-  comate state demo scale
-  [ "$(comate state demo get verify_mode)" = "full" ]
-}
-
-@test "scale sets verify_mode light when few tasks" {
-  comate state demo init full
-  printf -- '- [ ] a\n' > "openspec/changes/demo/tasks.md"
-  comate state demo scale
-  [ "$(comate state demo get verify_mode)" = "light" ]
-}
-
-# --- source tracking ---
-
-@test "init defaults source_kind conversation with null manifest" {
-  comate state demo init full
-  [ "$(comate state demo get source_kind)" = "conversation" ]
-  [ "$(comate state demo get source_manifest)" = "null" ]
-}
-
-@test "sources check on conversation source is a no-op pass" {
-  comate state demo init full
-  run comate sources demo check
-  [ "$status" -eq 0 ]
-}
-
-@test "sources track records kb file and flips source_kind to file" {
-  comate state demo init full
-  mkdir -p docs/knowledge-base/cb
-  printf '# source\n' > docs/knowledge-base/cb/source.md
-  run comate sources demo track docs/knowledge-base/cb/source.md --note "main entry"
-  [ "$status" -eq 0 ]
-  [ "$(comate state demo get source_kind)" = "file" ]
-  [ "$(comate state demo get source_manifest)" = "openspec/changes/demo/.comate/sources.manifest" ]
-  run comate sources demo list
-  [[ "$output" == *"path:docs/knowledge-base/cb/source.md"* ]]
-  [[ "$output" == *"note:main entry"* ]]
-}
-
-@test "sources track rejects file outside knowledge-base" {
-  comate state demo init full
-  printf 'x\n' > docs/outside.md
-  run comate sources demo track docs/outside.md
-  [ "$(comate state demo get source_kind)" = "conversation" ]
-  [ "$(comate state demo get source_manifest)" = "null" ]
-}
-
-@test "sources check detects drift after file edited" {
-  comate state demo init full
-  mkdir -p docs/knowledge-base/cb
-  printf '# source\n' > docs/knowledge-base/cb/source.md
-  comate sources demo track docs/knowledge-base/cb/source.md >/dev/null 2>&1
-  printf 'edited\n' >> docs/knowledge-base/cb/source.md
-  run comate sources demo check
-  [ "$status" -eq 1 ]
-  [[ "$output" == *"drifted"* ]]
-}
-
-@test "sources find reverse-looks-up a tracked file" {
-  comate state demo init full
-  mkdir -p docs/knowledge-base/cb
-  printf '# source\n' > docs/knowledge-base/cb/source.md
-  comate sources demo track docs/knowledge-base/cb/source.md >/dev/null 2>&1
-  run comate sources find docs/knowledge-base/cb/source.md
-  [ "$status" -eq 0 ]
-  [[ "$output" == *"demo"* ]]
-}
-
-@test "build guard blocks when tracked source drifts" {
-  comate state demo init fix
-  local d="openspec/changes/demo"
-  printf '# p\n' > "$d/proposal.md"; printf '# d\n' > "$d/design.md"; printf -- '- [x] t1\n' > "$d/tasks.md"
-  mkdir -p docs/knowledge-base/cb
-  printf '# source\n' > docs/knowledge-base/cb/source.md
-  comate sources demo track docs/knowledge-base/cb/source.md >/dev/null 2>&1
-  comate guard demo open --apply >/dev/null 2>&1
-  comate handoff demo build --write >/dev/null 2>&1
-  printf 'edited\n' >> docs/knowledge-base/cb/source.md
-  run comate guard demo build --json
-  [ "$status" -eq 1 ]
-  [[ "$output" == *'"block":true'* ]]
-}
-
-# --- doctor + usage ---
-
-@test "doctor exits 0 when core tools present" {
-  run comate doctor
-  [ "$status" -eq 0 ]
-}
-
-@test "doctor recognizes Claude Code skills-cli Superpowers layout" {
-  local fake_home="$WORK/fake-home"
-  mkdir -p "$fake_home/.claude/skills/using-superpowers"
-  printf '# using-superpowers\n' > "$fake_home/.claude/skills/using-superpowers/SKILL.md"
-  run env HOME="$fake_home" bash "$COMATE" doctor
-  [ "$status" -eq 0 ]
-  [[ "$output" == *"Superpowers skills found"* ]]
-  [[ "$output" != *"Superpowers skills not found"* ]]
-}
-
-@test "dependency archived requires an archived=true record" {
-  comate state dep init full
-  run comate dependency dep archived
-  [ "$status" -eq 1 ]
-  comate state dep set phase archive >/dev/null
-  comate state dep transition archived >/dev/null
-  mkdir -p openspec/changes/archive
-  mv openspec/changes/dep openspec/changes/archive/2026-08-20-dep
-  run comate dependency dep archived
-  [ "$status" -eq 0 ]
-}
-
-@test "top-level usage error returns code 2" {
-  run comate frobnicate
-  [ "$status" -eq 2 ]
-}
-
-# --- gate ---
-
-seed_prd() {
-  mkdir -p docs/knowledge-base/requirements/test
-  printf '# PRD-001\n功能清单:登录、登出\n' > \
-    docs/knowledge-base/requirements/test/PRD-001-demo.md
-  echo "docs/knowledge-base/requirements/test/PRD-001-demo.md"
-}
-
-seed_gate_skeleton() {
-  local prd="$1" change="$2" d="openspec/changes/$2"
-  mkdir -p "$d"
-  printf 'schema: specs-driven\n' > "$d/.openspec.yaml"
-  printf '# proposal\n' > "$d/proposal.md"
-  printf '# design\n' > "$d/design.md"
-  printf -- '- [ ] task\n' > "$d/tasks.md"
-  comate state "$change" init full >/dev/null
-  comate sources "$change" track "$prd" >/dev/null
-}
-
-@test "gate review creates gate.yaml next to PRD" {
-  local prd; prd=$(seed_prd)
-  run comate gate "$prd" review
-  [ "$status" -eq 0 ]
-  [ -f "docs/knowledge-base/requirements/test/PRD-001.gate.yaml" ]
-}
-
-@test "gate rejects PRD filenames outside the naming convention" {
-  mkdir -p docs/knowledge-base/requirements/test
-  printf '# PRD\n' > docs/knowledge-base/requirements/test/PRD-1.md
-  run comate gate docs/knowledge-base/requirements/test/PRD-1.md review
-  [ "$status" -eq 2 ]
-  [[ "$output" == *"PRD-NNN-title.md"* ]]
-}
-
-@test "gate names key off PRD-NNN stem, dropping title" {
-  local prd; prd=$(seed_prd)
-  run comate gate "$prd" review
-  [ "$status" -eq 0 ]
-  # gate.yaml and review report drop the -demo title, key off PRD-001
-  [ -f "docs/knowledge-base/requirements/test/PRD-001.gate.yaml" ]
-  [ ! -f "docs/knowledge-base/requirements/test/PRD-001-demo.gate.yaml" ]
-  [[ "$output" == *"PRD-001-REVIEW.md"* ]]
-  grep -q "review_report: docs/knowledge-base/requirements/test/PRD-001-REVIEW.md" \
-    "docs/knowledge-base/requirements/test/PRD-001.gate.yaml"
-}
-
-@test "gate review writes reviewing status and pins prd_hash" {
-  local prd; prd=$(seed_prd)
-  comate gate "$prd" review >/dev/null
-  local gate="docs/knowledge-base/requirements/test/PRD-001.gate.yaml"
-  run comate gate "$prd" status
-  [ "$status" -eq 0 ]
-  [[ "$output" == *"reviewing"* ]]
-  local hash; hash=$(grep '^prd_hash:' "$gate" | awk '{print $2}')
-  [ -n "$hash" ]
-  [ "$hash" != "null" ]
-}
-
-@test "gate check blocks when status is reviewing" {
-  local prd; prd=$(seed_prd)
-  comate gate "$prd" review >/dev/null
-  run comate gate "$prd" check
-  [ "$status" -eq 1 ]
-  [[ "$output" == *"BLOCK"* ]]
-}
-
-@test "gate pass blocked when blocking_open not zero" {
-  local prd; prd=$(seed_prd)
-  comate gate "$prd" review >/dev/null
-  comate gate "$prd" set score 80 >/dev/null
-  run comate gate "$prd" pass
-  [ "$status" -eq 1 ]
-  [[ "$output" == *"blocking_open"* ]]
-}
-
-@test "gate pass blocked when review report missing" {
-  local prd; prd=$(seed_prd)
-  comate gate "$prd" review >/dev/null
-  comate gate "$prd" set score 90 >/dev/null
-  comate gate "$prd" set blocking_open 0 >/dev/null
-  comate gate "$prd" set changes_map "demo:功能项1" >/dev/null
-  run comate gate "$prd" pass
-  [ "$status" -eq 1 ]
-  [[ "$output" == *"report"* ]]
-}
-
-@test "gate pass blocks without a confirmed changes map" {
-  local prd; prd=$(seed_prd)
-  comate gate "$prd" review >/dev/null
-  comate gate "$prd" set score 90 >/dev/null
-  comate gate "$prd" set blocking_open 0 >/dev/null
-  printf '# report\n' > "docs/knowledge-base/requirements/test/PRD-001-REVIEW.md"
-  run comate gate "$prd" pass
-  [ "$status" -eq 1 ]
-  [[ "$output" == *"changes_map"* ]]
-}
-
-@test "gate rejects changes_map entries without a function mapping" {
-  local prd; prd=$(seed_prd)
-  comate gate "$prd" review >/dev/null
-  run comate gate "$prd" set changes_map "login-flow"
-  [ "$status" -eq 2 ]
-  [[ "$output" == *"malformed changes_map"* ]]
-}
-
-@test "gate rejects duplicate change names in changes_map" {
-  local prd; prd=$(seed_prd)
-  comate gate "$prd" review >/dev/null
-  run comate gate "$prd" set changes_map "login-flow:功能项1;login-flow:功能项2"
-  [ "$status" -eq 2 ]
-  [[ "$output" == *"duplicate change"* ]]
-}
-
-@test "gate rejects an empty middle entry in changes_map" {
-  local prd; prd=$(seed_prd)
-  comate gate "$prd" review >/dev/null
-  run comate gate "$prd" set changes_map "login-flow:功能项1;;logout-flow:功能项2"
-  [ "$status" -eq 2 ]
-  [[ "$output" == *"empty entry"* ]]
-}
-
-@test "gate rejects a trailing empty entry in changes_map" {
-  local prd; prd=$(seed_prd)
-  comate gate "$prd" review >/dev/null
-  run comate gate "$prd" set changes_map "login-flow:功能项1;"
-  [ "$status" -eq 2 ]
-  [[ "$output" == *"empty entry"* ]]
-}
-
-@test "gate rejects an empty function mapping" {
-  local prd; prd=$(seed_prd)
-  comate gate "$prd" review >/dev/null
-  run comate gate "$prd" set changes_map "login-flow:"
-  [ "$status" -eq 2 ]
-  [[ "$output" == *"empty function mapping"* ]]
-}
-
-@test "gate rejects an all-whitespace function mapping" {
-  local prd; prd=$(seed_prd)
-  comate gate "$prd" review >/dev/null
-  run comate gate "$prd" set changes_map "login-flow:   "
-  [ "$status" -eq 2 ]
-  [[ "$output" == *"empty function mapping"* ]]
-}
-
-@test "gate keeps a passed changes_map immutable except for idempotent writes" {
-  local prd; prd=$(seed_prd)
-  comate gate "$prd" review >/dev/null
-  comate gate "$prd" set score 90 >/dev/null
-  comate gate "$prd" set blocking_open 0 >/dev/null
-  comate gate "$prd" set changes_map "a:功能项1;b:功能项2;c:功能项3;d:功能项4" >/dev/null
-  printf '# 报告\n' > "docs/knowledge-base/requirements/test/PRD-001-REVIEW.md"
-  comate gate "$prd" pass >/dev/null
-  run comate gate "$prd" set changes_map "a:功能项1;b:功能项2;c:功能项3;d:功能项4"
-  [ "$status" -eq 0 ]
-  run comate gate "$prd" set changes_map "a:功能项1"
-  [ "$status" -eq 1 ]
-  [[ "$output" == *"immutable after gate pass"* ]]
-  run comate gate "$prd" fanout-status --json
-  [[ "$output" == *'"expected":4'* ]]
-}
-
-@test "gate pass --tbd requires unresolved blockers" {
-  local prd; prd=$(seed_prd)
-  comate gate "$prd" review >/dev/null
-  comate gate "$prd" set score 90 >/dev/null
-  comate gate "$prd" set blocking_open 0 >/dev/null
-  comate gate "$prd" set changes_map "demo:功能项1" >/dev/null
-  printf '# report\n' > "docs/knowledge-base/requirements/test/PRD-001-REVIEW.md"
-  run comate gate "$prd" pass --tbd
-  [ "$status" -eq 1 ]
-  [[ "$output" == *"requires at least one"* ]]
-}
-
-@test "gate pass succeeds and check passes after report written" {
-  local prd; prd=$(seed_prd)
-  comate gate "$prd" review >/dev/null
-  comate gate "$prd" set score 90 >/dev/null
-  comate gate "$prd" set blocking_open 0 >/dev/null
-  comate gate "$prd" set changes_map "demo:功能项1" >/dev/null
-  printf '# 评审报告\n' > \
-    "docs/knowledge-base/requirements/test/PRD-001-REVIEW.md"
-  run comate gate "$prd" pass
-  [ "$status" -eq 0 ]
-  run comate gate "$prd" check
-  [ "$status" -eq 0 ]
-}
-
-@test "gate pass --tbd sets passed-with-tbd" {
-  local prd; prd=$(seed_prd)
-  comate gate "$prd" review >/dev/null
-  comate gate "$prd" set score 65 >/dev/null
-  comate gate "$prd" set blocking_open 2 >/dev/null
-  comate gate "$prd" set changes_map "demo:功能项1" >/dev/null
-  printf '# 评审报告\n' > \
-    "docs/knowledge-base/requirements/test/PRD-001-REVIEW.md"
-  run comate gate "$prd" pass --tbd
-  [ "$status" -eq 0 ]
-  run comate gate "$prd" status
-  [[ "$output" == *"passed-with-tbd"* ]]
-}
-
-@test "gate check blocks after PRD modified post-pass (stale)" {
-  local prd; prd=$(seed_prd)
-  comate gate "$prd" review >/dev/null
-  comate gate "$prd" set score 90 >/dev/null
-  comate gate "$prd" set blocking_open 0 >/dev/null
-  comate gate "$prd" set changes_map "demo:功能项1" >/dev/null
-  printf '# 评审报告\n' > \
-    "docs/knowledge-base/requirements/test/PRD-001-REVIEW.md"
-  comate gate "$prd" pass >/dev/null
-  # mutate PRD after passing
-  printf '\n额外内容\n' >> "$prd"
-  run comate gate "$prd" check
-  [ "$status" -eq 1 ]
-  [[ "$output" == *"stale"* ]] || [[ "$output" == *"hash mismatch"* ]]
-}
-
-@test "gate status reports stale on hash drift without mutating file" {
-  local prd; prd=$(seed_prd)
-  comate gate "$prd" review >/dev/null
-  comate gate "$prd" set score 90 >/dev/null
-  comate gate "$prd" set blocking_open 0 >/dev/null
-  comate gate "$prd" set changes_map "demo:功能项1" >/dev/null
-  printf '# 评审报告\n' > \
-    "docs/knowledge-base/requirements/test/PRD-001-REVIEW.md"
-  comate gate "$prd" pass >/dev/null
-  printf '\n改动\n' >> "$prd"
-  run comate gate "$prd" status
-  [ "$status" -eq 0 ]
-  [[ "$output" == *"stale"* ]]
-  # gate.yaml should still say passed (status is computed, not written by status cmd)
-  local gate="docs/knowledge-base/requirements/test/PRD-001.gate.yaml"
-  local stored; stored=$(grep '^gate_status:' "$gate" | awk '{print $2}')
-  [ "$stored" = "passed" ]
-}
-
-@test "gate spawned records change name in spawned_changes" {
-  local prd; prd=$(seed_prd)
-  comate gate "$prd" review >/dev/null
-  comate gate "$prd" set score 90 >/dev/null
-  comate gate "$prd" set blocking_open 0 >/dev/null
-  comate gate "$prd" set changes_map "login-flow:功能项1" >/dev/null
-  printf '# 报告\n' > \
-    "docs/knowledge-base/requirements/test/PRD-001-REVIEW.md"
-  comate gate "$prd" pass >/dev/null
-  seed_gate_skeleton "$prd" login-flow
-  run comate gate "$prd" spawned login-flow
-  [ "$status" -eq 0 ]
-  local gate="docs/knowledge-base/requirements/test/PRD-001.gate.yaml"
-  local sc; sc=$(grep '^spawned_changes:' "$gate" | sed 's/spawned_changes: //')
-  [[ "$sc" == *"login-flow"* ]]
-}
-
-@test "gate spawned appends second change comma-joined" {
-  local prd; prd=$(seed_prd)
-  comate gate "$prd" review >/dev/null
-  comate gate "$prd" set score 90 >/dev/null
-  comate gate "$prd" set blocking_open 0 >/dev/null
-  comate gate "$prd" set changes_map "login-flow:功能项1;logout-flow:功能项2" >/dev/null
-  printf '# 报告\n' > \
-    "docs/knowledge-base/requirements/test/PRD-001-REVIEW.md"
-  comate gate "$prd" pass >/dev/null
-  seed_gate_skeleton "$prd" login-flow
-  seed_gate_skeleton "$prd" logout-flow
-  comate gate "$prd" spawned login-flow >/dev/null
-  comate gate "$prd" spawned logout-flow >/dev/null
-  local gate="docs/knowledge-base/requirements/test/PRD-001.gate.yaml"
-  local sc; sc=$(grep '^spawned_changes:' "$gate" | sed 's/spawned_changes: //')
-  [[ "$sc" == *"login-flow"* ]]
-  [[ "$sc" == *"logout-flow"* ]]
-}
-
-@test "gate spawned remains idempotent after an already recorded change leaves the active directory" {
-  local prd; prd=$(seed_prd)
-  comate gate "$prd" review >/dev/null
-  comate gate "$prd" set score 90 >/dev/null
-  comate gate "$prd" set blocking_open 0 >/dev/null
-  comate gate "$prd" set changes_map "login-flow:功能项1" >/dev/null
-  printf '# 报告\n' > "docs/knowledge-base/requirements/test/PRD-001-REVIEW.md"
-  comate gate "$prd" pass >/dev/null
-  seed_gate_skeleton "$prd" login-flow
-  comate gate "$prd" spawned login-flow >/dev/null
-  mkdir -p openspec/changes/archive
-  mv openspec/changes/login-flow openspec/changes/archive/2026-08-28-login-flow
-  run comate gate "$prd" spawned login-flow
-  [ "$status" -eq 0 ]
-  [[ "$output" == *"already recorded"* ]]
-}
-
-@test "gate fanout status reports missing changes instead of treating one of four as complete" {
-  local prd; prd=$(seed_prd)
-  comate gate "$prd" review >/dev/null
-  comate gate "$prd" set score 90 >/dev/null
-  comate gate "$prd" set blocking_open 0 >/dev/null
-  comate gate "$prd" set changes_map "login-flow:功能项1;logout-flow:功能项2;ops:功能项3;report:功能项4" >/dev/null
-  printf '# 报告\n' > "docs/knowledge-base/requirements/test/PRD-001-REVIEW.md"
-  comate gate "$prd" pass >/dev/null
-  seed_gate_skeleton "$prd" login-flow
-  comate gate "$prd" spawned login-flow >/dev/null
-  run comate gate "$prd" fanout-status --json
-  [ "$status" -eq 0 ]
-  [[ "$output" == *'"expected":4'* ]]
-  [[ "$output" == *'"spawned":1'* ]]
-  [[ "$output" == *'"complete":false'* ]]
-  [[ "$output" == *'logout-flow'* ]]
-}
-
-@test "gate spawned rejects a change outside the confirmed map" {
-  local prd; prd=$(seed_prd)
-  comate gate "$prd" review >/dev/null
-  comate gate "$prd" set score 90 >/dev/null
-  comate gate "$prd" set blocking_open 0 >/dev/null
-  comate gate "$prd" set changes_map "login-flow:功能项1" >/dev/null
-  printf '# 报告\n' > "docs/knowledge-base/requirements/test/PRD-001-REVIEW.md"
-  comate gate "$prd" pass >/dev/null
-  seed_gate_skeleton "$prd" other-flow
-  run comate gate "$prd" spawned other-flow
-  [ "$status" -eq 1 ]
-  [[ "$output" == *"not present in changes_map"* ]]
-}
-
-@test "gate fanout status becomes complete only after every mapped change is spawned" {
-  local prd; prd=$(seed_prd)
-  comate gate "$prd" review >/dev/null
-  comate gate "$prd" set score 90 >/dev/null
-  comate gate "$prd" set blocking_open 0 >/dev/null
-  comate gate "$prd" set changes_map "login-flow:功能项1;logout-flow:功能项2" >/dev/null
-  printf '# 报告\n' > "docs/knowledge-base/requirements/test/PRD-001-REVIEW.md"
-  comate gate "$prd" pass >/dev/null
-  seed_gate_skeleton "$prd" login-flow
-  seed_gate_skeleton "$prd" logout-flow
-  comate gate "$prd" spawned login-flow >/dev/null
-  comate gate "$prd" spawned logout-flow >/dev/null
-  run comate gate "$prd" fanout-status
-  [ "$status" -eq 0 ]
-  [[ "$output" == *"complete=true"* ]]
-  [[ "$output" == *"missing=none"* ]]
-}
-
-@test "gate spawned rejects an incomplete change skeleton" {
-  local prd; prd=$(seed_prd)
-  comate gate "$prd" review >/dev/null
-  comate gate "$prd" set score 90 >/dev/null
-  comate gate "$prd" set blocking_open 0 >/dev/null
-  comate gate "$prd" set changes_map "login-flow:功能项1" >/dev/null
-  printf '# 报告\n' > "docs/knowledge-base/requirements/test/PRD-001-REVIEW.md"
-  comate gate "$prd" pass >/dev/null
-  mkdir -p openspec/changes/login-flow
-  run comate gate "$prd" spawned login-flow
-  [ "$status" -eq 1 ]
-  [[ "$output" == *"skeleton incomplete"* ]]
-}
-
-@test "gate spawned blocks a new registration after the PRD becomes stale" {
-  local prd; prd=$(seed_prd)
-  comate gate "$prd" review >/dev/null
-  comate gate "$prd" set score 90 >/dev/null
-  comate gate "$prd" set blocking_open 0 >/dev/null
-  comate gate "$prd" set changes_map "login-flow:功能项1" >/dev/null
-  printf '# 报告\n' > "docs/knowledge-base/requirements/test/PRD-001-REVIEW.md"
-  comate gate "$prd" pass >/dev/null
-  seed_gate_skeleton "$prd" login-flow
-  printf '\nchanged\n' >> "$prd"
-  run comate gate "$prd" spawned login-flow
-  [ "$status" -eq 1 ]
-  [[ "$output" == *"hash mismatch"* ]]
-}
-
-@test "gate spawned accepts a normalized PRD path recorded in the source manifest" {
-  local prd; prd=$(seed_prd)
-  prd="./$prd"
-  comate gate "$prd" review >/dev/null
-  comate gate "$prd" set score 90 >/dev/null
-  comate gate "$prd" set blocking_open 0 >/dev/null
-  comate gate "$prd" set changes_map "login-flow:功能项1" >/dev/null
-  printf '# 报告\n' > "docs/knowledge-base/requirements/test/PRD-001-REVIEW.md"
-  comate gate "$prd" pass >/dev/null
-  seed_gate_skeleton "$prd" login-flow
-  run comate gate "$prd" spawned login-flow
-  [ "$status" -eq 0 ]
-}
-
-@test "gate spawned rejects a truncated PRD source record without sha256" {
-  local prd; prd=$(seed_prd)
-  comate gate "$prd" review >/dev/null
-  comate gate "$prd" set score 90 >/dev/null
-  comate gate "$prd" set blocking_open 0 >/dev/null
-  comate gate "$prd" set changes_map "login-flow:功能项1" >/dev/null
-  printf '# 报告\n' > "docs/knowledge-base/requirements/test/PRD-001-REVIEW.md"
-  comate gate "$prd" pass >/dev/null
-  seed_gate_skeleton "$prd" login-flow
-  printf 'path:%s\n' "$prd" > openspec/changes/login-flow/.comate/sources.manifest
-  run comate gate "$prd" spawned login-flow
-  [ "$status" -eq 1 ]
-  [[ "$output" == *"complete path/sha256 record"* ]]
-}
-
-@test "gate status returns none when gate does not exist" {
-  mkdir -p docs/knowledge-base/requirements/test
-  run comate gate "docs/knowledge-base/requirements/test/PRD-001-demo.md" status
-  [ "$status" -eq 0 ]
-  [[ "$output" == *"none"* ]]
-}
-
-@test "gate unknown subcommand returns usage error" {
-  local prd; prd=$(seed_prd)
-  run comate gate "$prd" frobnicate
-  [ "$status" -eq 2 ]
-}
-
-@test "gate review re-opens reviewing when PRD changes after pass" {
-  local prd; prd=$(seed_prd)
-  comate gate "$prd" review >/dev/null
-  comate gate "$prd" set score 90 >/dev/null
-  comate gate "$prd" set blocking_open 0 >/dev/null
-  comate gate "$prd" set changes_map "demo:功能项1" >/dev/null
-  printf '# 报告\n' > \
-    "docs/knowledge-base/requirements/test/PRD-001-REVIEW.md"
-  comate gate "$prd" pass >/dev/null
-  printf '\n改动\n' >> "$prd"
-  # re-run review after PRD change — should reset to reviewing
-  run comate gate "$prd" review
-  [ "$status" -eq 0 ]
-  run comate gate "$prd" status
-  [[ "$output" == *"reviewing"* ]]
-}
-
-@test "gate set rejects unknown field" {
-  local prd; prd=$(seed_prd)
-  comate gate "$prd" review >/dev/null
-  run comate gate "$prd" set nonexistent_field foo
-  [ "$status" -eq 2 ]
-}
-
-@test "gate set rejects invalid gate_status value" {
-  local prd; prd=$(seed_prd)
-  comate gate "$prd" review >/dev/null
-  run comate gate "$prd" set gate_status flying
-  [ "$status" -eq 2 ]
-}
-
-@test "gate status --json emits json with status field" {
-  local prd; prd=$(seed_prd)
-  comate gate "$prd" review >/dev/null
-  run comate gate "$prd" status --json
-  [ "$status" -eq 0 ]
-  [[ "$output" == *'"status"'* ]]
-  [[ "$output" == *'"reviewing"'* ]]
-}