0.2.4 - Comet

What’s Changed [0.2.4] - 2026-05-21

Verification evidence enforcement: verify-pass transition now requires verification_report (file must exist) and branch_status: handled before allowing phase advance. Guard checks these as hard prerequisites
verification_report and branch_status fields in .comet.yaml: New state fields track verification report path and branch handling status
Verification evidence step in comet-verify (zh): New Step 4 requiring report file creation and branch status recording before guard apply
branch_status enum validation: comet-state.sh set validates branch_status as pending or handled
Guard verify checks: comet-guard.sh now checks verification_report exists and branch_status=handled during verify phase
Bats test CRLF fix: Shell tests strip \r from scripts before execution, fixing Windows compatibility
test:shell runner: Replaced direct bats call with node scripts/run-bats.js for cross-platform support

Hotfix root cause check reordered: Moved root cause elimination check before comet-verify loading (Step 3a → 3b split), preventing it from being skipped during verify flow
Hotfix header description simplified: Replaced ambiguous “not a separate parallel process” with direct “Quick bug fix workflow” for standalone invocation clarity
Removed non-action steps from comet-design: Deleted Step 3 (Dual Spec Division table) and Step 4 (Document Hierarchy) — pure reference material with no agent actions
Removed duplicate script location blocks: comet-open (Step 3) and comet-archive (Step 1) no longer repeat the full COMET_SEARCH_ROOTS find block when variables already cached
Removed duplicate 50% threshold in comet-build: Single mention in threshold determination table instead of table + bullet repetition
Generic error handling: Error table in comet main skill changed “Maven compile/test” → “Build/test” for language-agnostic wording
comet-state.sh usage help: Fixed check parameter order in help text (check <change-name> <phase>)

comet-state.sh init change directory resolution: cmd_init now resolves change_dir before checking if .comet.yaml already exists, fixing path resolution for nested directories
Guard deadlock on verify: verify-pass transition now resets verification_report and branch_status when rolling back via verify-fail, preventing stale evidence from allowing false transitions

+66 lines in comet-scripts.test.ts: New tests for verification evidence blocking, branch status validation, and guard verify with evidence
+12 lines in comet-state.bats: New tests for branch_status enum validation, CRLF stripping, and new field presence in init output