cleargate 0.14.0 → 0.15.0

package/dist/templates/cleargate-planning/.cleargate/scripts/surface-whitelist.txt

@@ -1,27 +0,0 @@
-# surface-whitelist.txt — Files always admitted by the pre-commit surface gate
-# regardless of the active story's §3.1 declared surface.
-#
-# Format: one pattern per line. Supports bash glob patterns.
-#   *     matches any non-path-separator sequence
-#   **    matches any sequence (including path separators)
-# Lines starting with # are comments; blank lines are ignored.
-#
-# These patterns are matched against repo-root-relative staged file paths.
-
-# Build manifest (regenerated by npm run build)
-cleargate-planning/MANIFEST.json
-
-# Hook execution logs
-.cleargate/hook-log/*
-
-# Token ledger files (auto-generated by SubagentStop hook)
-.cleargate/sprint-runs/**/token-ledger.jsonl
-
-# Pending-task sentinel files (auto-generated by PreToolUse hook)
-.cleargate/sprint-runs/**/.pending-task-*.json
-
-# Sprint state files (auto-managed)
-.cleargate/sprint-runs/**/state.json
-
-# Gate check log (auto-generated)
-.cleargate/hook-log/gate-check.log

package/dist/templates/cleargate-planning/.cleargate/scripts/test/test_assert_story_files.sh

@@ -1,261 +0,0 @@
-#!/usr/bin/env bash
-# test_assert_story_files.sh — 4-scenario Gherkin test for STORY-014-02
-#
-# Tests:
-#   Scenario 1: v2 init refuses when stories are missing
-#   Scenario 2: v2 init succeeds when all stories exist
-#   Scenario 3: v1 init warns but does not block
-#   Scenario 4: assert_story_files standalone CLI
-#
-# Run: bash .cleargate/scripts/test/test_assert_story_files.sh
-# Requires Node 24+.
-#
-# Story IDs must use digit-only parts (STORY-\d+-\d+), e.g. STORY-099-01.
-
-set -euo pipefail
-
-SCRIPTS_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
-REPO_ROOT="$(cd "${SCRIPTS_DIR}/../.." && pwd)"
-
-PASS=0
-FAIL=0
-ERRORS=()
-
-assert_eq() {
-  local label="$1" expected="$2" actual="$3"
-  if [ "$expected" = "$actual" ]; then
-    echo "  PASS: $label"
-    PASS=$((PASS + 1))
-  else
-    echo "  FAIL: $label"
-    echo "        expected: $expected"
-    echo "        actual:   $actual"
-    FAIL=$((FAIL + 1))
-    ERRORS+=("$label")
-  fi
-}
-
-assert_contains() {
-  local label="$1" needle="$2" haystack="$3"
-  if echo "$haystack" | grep -qF "$needle"; then
-    echo "  PASS: $label"
-    PASS=$((PASS + 1))
-  else
-    echo "  FAIL: $label (needle not found)"
-    echo "        needle:   $needle"
-    echo "        haystack: $haystack"
-    FAIL=$((FAIL + 1))
-    ERRORS+=("$label")
-  fi
-}
-
-assert_not_exists() {
-  local label="$1" filepath="$2"
-  if [ ! -e "$filepath" ]; then
-    echo "  PASS: $label"
-    PASS=$((PASS + 1))
-  else
-    echo "  FAIL: $label (file exists but should not)"
-    echo "        path: $filepath"
-    FAIL=$((FAIL + 1))
-    ERRORS+=("$label")
-  fi
-}
-
-assert_exists() {
-  local label="$1" filepath="$2"
-  if [ -e "$filepath" ]; then
-    echo "  PASS: $label"
-    PASS=$((PASS + 1))
-  else
-    echo "  FAIL: $label (file does not exist)"
-    echo "        path: $filepath"
-    FAIL=$((FAIL + 1))
-    ERRORS+=("$label")
-  fi
-}
-
-# Create a minimal sprint file with given execution_mode
-# Story IDs must be STORY-\d+-\d+ (all numeric parts) for the regex to match.
-# Usage: make_sprint_file <dir> <sprint-id> <execution_mode> <story-id-1> [<story-id-2> ...]
-make_sprint_file() {
-  local dir="$1" sprint_id="$2" exec_mode="$3"
-  shift 3
-  local story_ids=("$@")
-
-  local sprint_file="${dir}/.cleargate/delivery/pending-sync/${sprint_id}_Test_Sprint.md"
-  mkdir -p "$(dirname "$sprint_file")"
-
-  {
-    echo "---"
-    echo "sprint_id: \"${sprint_id}\""
-    echo "execution_mode: \"${exec_mode}\""
-    echo "approved: true"
-    echo "---"
-    echo ""
-    echo "# ${sprint_id}: Test Sprint"
-    echo ""
-    echo "## 1. Consolidated Deliverables"
-    echo ""
-    echo "| Story | Complexity | Milestone |"
-    echo "|---|---|---|"
-    for sid in "${story_ids[@]}"; do
-      echo "| [\`${sid}\`](${sid}_Placeholder.md) Placeholder | L2 | M1 |"
-    done
-    echo ""
-    echo "## 2. Other Section"
-    echo ""
-    echo "Some content here."
-  } > "$sprint_file"
-
-  echo "$sprint_file"
-}
-
-# Create a minimal story file in pending-sync/
-make_story_file() {
-  local dir="$1" story_id="$2"
-  local pending_sync="${dir}/.cleargate/delivery/pending-sync"
-  mkdir -p "$pending_sync"
-  echo "# ${story_id}: Placeholder" > "${pending_sync}/${story_id}_Placeholder.md"
-}
-
-# ---------------------------------------------------------------------------
-echo ""
-echo "=== Scenario 1: v2 init refuses when stories are missing ==="
-# ---------------------------------------------------------------------------
-TMP1="$(mktemp -d)"
-trap 'rm -rf "$TMP1"' EXIT
-
-SPRINT_ID="SPRINT-099"
-make_sprint_file "$TMP1" "$SPRINT_ID" "v2" \
-  "STORY-099-01" "STORY-099-02" "STORY-099-03" > /dev/null
-
-# Only create STORY-099-01, leave 02 and 03 missing
-make_story_file "$TMP1" "STORY-099-01"
-
-STATE_JSON="${TMP1}/.cleargate/sprint-runs/${SPRINT_ID}/state.json"
-
-STDERR_OUT=""
-EXIT_CODE=0
-STDERR_OUT="$(CLEARGATE_REPO_ROOT="$TMP1" node "$SCRIPTS_DIR/init_sprint.mjs" \
-  "$SPRINT_ID" --stories "STORY-099-01,STORY-099-02,STORY-099-03" 2>&1 >/dev/null)" || EXIT_CODE=$?
-
-assert_eq "Sc1: exit code non-zero" "1" "$EXIT_CODE"
-assert_contains "Sc1: stderr mentions STORY-099-02" "STORY-099-02" "$STDERR_OUT"
-assert_contains "Sc1: stderr mentions STORY-099-03" "STORY-099-03" "$STDERR_OUT"
-assert_not_exists "Sc1: state.json NOT created" "$STATE_JSON"
-
-trap - EXIT
-rm -rf "$TMP1"
-
-# ---------------------------------------------------------------------------
-echo ""
-echo "=== Scenario 2: v2 init succeeds when all stories exist ==="
-# ---------------------------------------------------------------------------
-TMP2="$(mktemp -d)"
-trap 'rm -rf "$TMP2"' EXIT
-
-SPRINT_ID="SPRINT-098"
-make_sprint_file "$TMP2" "$SPRINT_ID" "v2" \
-  "STORY-098-01" "STORY-098-02" "STORY-098-03" > /dev/null
-
-make_story_file "$TMP2" "STORY-098-01"
-make_story_file "$TMP2" "STORY-098-02"
-make_story_file "$TMP2" "STORY-098-03"
-
-STATE_JSON="${TMP2}/.cleargate/sprint-runs/${SPRINT_ID}/state.json"
-
-EXIT_CODE=0
-CLEARGATE_REPO_ROOT="$TMP2" node "$SCRIPTS_DIR/init_sprint.mjs" \
-  "$SPRINT_ID" --stories "STORY-098-01,STORY-098-02,STORY-098-03" 2>/dev/null || EXIT_CODE=$?
-
-assert_eq "Sc2: exit code 0" "0" "$EXIT_CODE"
-assert_exists "Sc2: state.json created" "$STATE_JSON"
-
-# Verify execution_mode in state.json is v2
-if [ -f "$STATE_JSON" ]; then
-  EM="$(node -e "const s=JSON.parse(require('fs').readFileSync('$STATE_JSON','utf8')); console.log(s.execution_mode)")"
-  assert_eq "Sc2: state.json execution_mode=v2" "v2" "$EM"
-fi
-
-trap - EXIT
-rm -rf "$TMP2"
-
-# ---------------------------------------------------------------------------
-echo ""
-echo "=== Scenario 3: v1 init warns but does not block ==="
-# ---------------------------------------------------------------------------
-TMP3="$(mktemp -d)"
-trap 'rm -rf "$TMP3"' EXIT
-
-SPRINT_ID="SPRINT-097"
-make_sprint_file "$TMP3" "$SPRINT_ID" "v1" \
-  "STORY-097-01" "STORY-097-02" > /dev/null
-
-# Only create STORY-097-01, leave 02 missing
-make_story_file "$TMP3" "STORY-097-01"
-
-STATE_JSON="${TMP3}/.cleargate/sprint-runs/${SPRINT_ID}/state.json"
-
-EXIT_CODE=0
-STDERR_OUT="$(CLEARGATE_REPO_ROOT="$TMP3" node "$SCRIPTS_DIR/init_sprint.mjs" \
-  "$SPRINT_ID" --stories "STORY-097-01,STORY-097-02" 2>&1 >/dev/null)" || EXIT_CODE=$?
-
-assert_eq "Sc3: exit code 0 (v1 warns but continues)" "0" "$EXIT_CODE"
-assert_exists "Sc3: state.json created despite missing file" "$STATE_JSON"
-assert_contains "Sc3: stderr contains WARN" "WARN" "$STDERR_OUT"
-assert_contains "Sc3: stderr mentions STORY-097-02" "STORY-097-02" "$STDERR_OUT"
-
-trap - EXIT
-rm -rf "$TMP3"
-
-# ---------------------------------------------------------------------------
-echo ""
-echo "=== Scenario 4: assert_story_files standalone CLI ==="
-# ---------------------------------------------------------------------------
-TMP4="$(mktemp -d)"
-trap 'rm -rf "$TMP4"' EXIT
-
-SPRINT_ID="SPRINT-096"
-SPRINT_FILE="$(make_sprint_file "$TMP4" "$SPRINT_ID" "v2" \
-  "STORY-096-01" "STORY-096-02")"
-
-# Only create STORY-096-01, leave 02 missing
-make_story_file "$TMP4" "STORY-096-01"
-
-# Run standalone assert_story_files.mjs — should exit 1 with missing list
-STDERR_OUT=""
-EXIT_CODE=0
-STDERR_OUT="$(CLEARGATE_REPO_ROOT="$TMP4" node "$SCRIPTS_DIR/assert_story_files.mjs" \
-  "$SPRINT_FILE" 2>&1 >/dev/null)" || EXIT_CODE=$?
-
-assert_eq "Sc4: standalone exits non-zero when missing" "1" "$EXIT_CODE"
-assert_contains "Sc4: stderr lists STORY-096-02 as missing" "STORY-096-02" "$STDERR_OUT"
-
-# Now add the missing story file and re-run — should exit 0
-make_story_file "$TMP4" "STORY-096-02"
-
-EXIT_CODE=0
-STDOUT_OUT="$(CLEARGATE_REPO_ROOT="$TMP4" node "$SCRIPTS_DIR/assert_story_files.mjs" \
-  "$SPRINT_FILE" 2>/dev/null)" || EXIT_CODE=$?
-
-assert_eq "Sc4: standalone exits 0 when all present" "0" "$EXIT_CODE"
-assert_contains "Sc4: stdout confirms all present" "OK:" "$STDOUT_OUT"
-
-trap - EXIT
-rm -rf "$TMP4"
-
-# ---------------------------------------------------------------------------
-echo ""
-echo "=== Summary ==="
-echo "Passed: $PASS"
-echo "Failed: $FAIL"
-if [ ${#ERRORS[@]} -gt 0 ]; then
-  echo "Failing scenarios:"
-  for e in "${ERRORS[@]}"; do
-    echo "  - $e"
-  done
-  exit 1
-fi
-echo "All tests passed."
-exit 0

package/dist/templates/cleargate-planning/.cleargate/scripts/test/test_file_surface.sh

@@ -1,210 +0,0 @@
-#!/usr/bin/env bash
-# test_file_surface.sh — Gherkin-style tests for file_surface_diff.sh
-# Tests all 4 scenarios from STORY-014-01 §2.1
-#
-# Usage: bash .cleargate/scripts/test/test_file_surface.sh
-# Exit: 0 if all pass, 1 if any fail
-
-set -euo pipefail
-
-# Navigate up 3 levels: test/ -> scripts/ -> .cleargate/ -> repo-root/
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-REPO_ROOT="$(cd "${SCRIPT_DIR}/../../.." && pwd)"
-SCRIPT="${REPO_ROOT}/.cleargate/scripts/file_surface_diff.sh"
-PASS=0
-FAIL=0
-TOTAL=0
-
-pass() { echo "  PASS: $1"; PASS=$((PASS+1)); TOTAL=$((TOTAL+1)); }
-fail() { echo "  FAIL: $1 --- $2"; FAIL=$((FAIL+1)); TOTAL=$((TOTAL+1)); }
-
-echo "REPO_ROOT: ${REPO_ROOT}"
-echo "SCRIPT: ${SCRIPT}"
-if [[ ! -f "${SCRIPT}" ]]; then
-  echo "ERROR: file_surface_diff.sh not found at ${SCRIPT}"
-  exit 1
-fi
-
-# ============================================================================
-# Setup helpers
-# ============================================================================
-
-setup_git_repo() {
-  local dir="$1"
-  git init -q "${dir}"
-  git -C "${dir}" config user.email "test@test.com"
-  git -C "${dir}" config user.name "Test"
-  git -C "${dir}" commit -q --allow-empty -m "init"
-}
-
-create_story_file() {
-  local dir="$1"
-  shift
-  # remaining args are file paths to declare in §3.1
-  mkdir -p "${dir}/.cleargate/delivery/pending-sync"
-  local story="${dir}/.cleargate/delivery/pending-sync/STORY-014-01_Test.md"
-  {
-    echo "---"
-    echo "story_id: STORY-014-01"
-    echo "---"
-    echo ""
-    echo "# Test Story"
-    echo ""
-    echo "## 3. Implementation Guide"
-    echo ""
-    echo "### 3.1 Context & Files"
-    echo ""
-    echo "| Item | Value |"
-    echo "|---|---|"
-    for f in "$@"; do
-      echo "| New script | \`${f}\` |"
-    done
-    echo ""
-    echo "### 3.2 Technical Logic"
-    echo "test"
-  } > "${story}"
-}
-
-create_sprint_state() {
-  local dir="$1"
-  local mode="${2:-v2}"
-  mkdir -p "${dir}/.cleargate/sprint-runs/SPRINT-10"
-  echo "SPRINT-10" > "${dir}/.cleargate/sprint-runs/.active"
-  echo "{\"execution_mode\":\"${mode}\",\"stories\":{\"STORY-014-01\":{\"state\":\"In Progress\",\"updated_at\":\"2026-04-21T12:00:00Z\"}}}" > "${dir}/.cleargate/sprint-runs/SPRINT-10/state.json"
-}
-
-# ============================================================================
-# Scenario 1: Gate catches off-surface edit
-# ============================================================================
-
-echo ""
-echo "Scenario 1: Gate catches off-surface edit"
-
-TMPDIR1="$(mktemp -d)"
-setup_git_repo "${TMPDIR1}"
-create_story_file "${TMPDIR1}" "hello.mjs" "README.md"
-create_sprint_state "${TMPDIR1}" "v2"
-
-touch "${TMPDIR1}/hello.mjs" "${TMPDIR1}/README.md" "${TMPDIR1}/unrelated.txt"
-git -C "${TMPDIR1}" add hello.mjs README.md unrelated.txt
-
-EXIT_CODE=0
-STDERR_OUT="$(CLEARGATE_REPO_ROOT="${TMPDIR1}" bash "${SCRIPT}" 2>&1 >/dev/null)" || EXIT_CODE=$?
-
-if [[ "${EXIT_CODE}" -ne 0 ]]; then
-  pass "exit code is non-zero"
-else
-  fail "exit code is non-zero" "got exit 0"
-fi
-
-if echo "${STDERR_OUT}" | grep -q "unrelated.txt"; then
-  pass "stderr lists unrelated.txt as off-surface"
-else
-  fail "stderr lists unrelated.txt as off-surface" "stderr was: ${STDERR_OUT}"
-fi
-
-rm -rf "${TMPDIR1}"
-
-# ============================================================================
-# Scenario 2: Gate passes when staged files match surface
-# ============================================================================
-
-echo ""
-echo "Scenario 2: Gate passes when staged files match surface"
-
-TMPDIR2="$(mktemp -d)"
-setup_git_repo "${TMPDIR2}"
-create_story_file "${TMPDIR2}" "hello.mjs" "README.md"
-create_sprint_state "${TMPDIR2}" "v2"
-
-touch "${TMPDIR2}/hello.mjs" "${TMPDIR2}/README.md"
-git -C "${TMPDIR2}" add hello.mjs README.md
-
-EXIT_CODE=0
-CLEARGATE_REPO_ROOT="${TMPDIR2}" bash "${SCRIPT}" 2>/dev/null || EXIT_CODE=$?
-
-if [[ "${EXIT_CODE}" -eq 0 ]]; then
-  pass "exit code is 0"
-else
-  fail "exit code is 0" "got exit ${EXIT_CODE}"
-fi
-
-rm -rf "${TMPDIR2}"
-
-# ============================================================================
-# Scenario 3: Whitelist admits generated files
-# ============================================================================
-
-echo ""
-echo "Scenario 3: Whitelist admits generated files"
-
-TMPDIR3="$(mktemp -d)"
-setup_git_repo "${TMPDIR3}"
-create_story_file "${TMPDIR3}" "hello.mjs"
-create_sprint_state "${TMPDIR3}" "v2"
-
-mkdir -p "${TMPDIR3}/.cleargate/scripts"
-{
-  echo "cleargate-planning/MANIFEST.json"
-  echo ".cleargate/hook-log/*"
-} > "${TMPDIR3}/.cleargate/scripts/surface-whitelist.txt"
-
-touch "${TMPDIR3}/hello.mjs"
-mkdir -p "${TMPDIR3}/cleargate-planning"
-touch "${TMPDIR3}/cleargate-planning/MANIFEST.json"
-git -C "${TMPDIR3}" add hello.mjs cleargate-planning/MANIFEST.json
-
-EXIT_CODE=0
-CLEARGATE_REPO_ROOT="${TMPDIR3}" bash "${SCRIPT}" 2>/dev/null || EXIT_CODE=$?
-
-if [[ "${EXIT_CODE}" -eq 0 ]]; then
-  pass "MANIFEST.json not flagged (whitelisted)"
-else
-  fail "MANIFEST.json not flagged (whitelisted)" "got exit ${EXIT_CODE}"
-fi
-
-rm -rf "${TMPDIR3}"
-
-# ============================================================================
-# Scenario 4: v1 mode is advisory
-# ============================================================================
-
-echo ""
-echo "Scenario 4: v1 mode is advisory"
-
-TMPDIR4="$(mktemp -d)"
-setup_git_repo "${TMPDIR4}"
-create_story_file "${TMPDIR4}" "hello.mjs"
-create_sprint_state "${TMPDIR4}" "v1"
-
-touch "${TMPDIR4}/hello.mjs" "${TMPDIR4}/unrelated.txt"
-git -C "${TMPDIR4}" add hello.mjs unrelated.txt
-
-EXIT_CODE=0
-STDERR_OUT="$(CLEARGATE_REPO_ROOT="${TMPDIR4}" bash "${SCRIPT}" 2>&1 >/dev/null)" || EXIT_CODE=$?
-
-if [[ "${EXIT_CODE}" -eq 0 ]]; then
-  pass "v1 mode exits 0 (advisory)"
-else
-  fail "v1 mode exits 0" "got exit ${EXIT_CODE}"
-fi
-
-if echo "${STDERR_OUT}" | grep -qi "warning"; then
-  pass "v1 mode prints warning"
-else
-  fail "v1 mode prints warning" "stderr was: ${STDERR_OUT}"
-fi
-
-rm -rf "${TMPDIR4}"
-
-# ============================================================================
-# Summary
-# ============================================================================
-
-echo ""
-echo "Results: ${PASS}/${TOTAL} passed, ${FAIL} failed"
-
-if [[ "${FAIL}" -gt 0 ]]; then
-  exit 1
-fi
-exit 0

package/dist/templates/cleargate-planning/.cleargate/scripts/test/test_flashcard_gate.sh

@@ -1,190 +0,0 @@
-#!/usr/bin/env bash
-# test_flashcard_gate.sh — STORY-013-06: Immediate Flashcard Hard-Gate
-# Gherkin scenario: "Gate blocks next worktree creation until flashcards processed"
-#
-# Strategy: grep-based. Creates a synthetic dev-report fixture with
-# flashcards_flagged, simulates a mock worktree-creation step, and asserts
-# the gate contract documented in protocol §18 and the agent output-shape
-# blocks in developer.md + qa.md.
-#
-# Usage: bash .cleargate/scripts/test/test_flashcard_gate.sh
-# Exit: 0 if all assertions pass, 1 on first failure.
-
-set -euo pipefail
-
-REPO_ROOT="${CLEARGATE_REPO_ROOT:-$(cd "$(dirname "$0")/../../.." && pwd)}"
-PASS=0
-FAIL=0
-
-pass() { echo "PASS: $1"; PASS=$((PASS + 1)); }
-fail() { echo "FAIL: $1"; FAIL=$((FAIL + 1)); }
-
-# ---------------------------------------------------------------------------
-# Scenario: Gate blocks next worktree creation until flashcards processed
-# ---------------------------------------------------------------------------
-# §2.1 Gherkin from STORY-013-06:
-#   Given STORY-014-05 has just merged into sprint/S-XX
-#   And STORY-014-05-dev.md has flashcards_flagged: [...]
-#   When the orchestrator attempts to create .worktrees/STORY-014-06/
-#   Then the gate presents each flagged flashcard to the user for approval
-#   And upon approval each card is appended to .cleargate/FLASHCARD.md
-#   And only then does worktree creation proceed
-#
-# This script validates the contract (protocol §18 + output-shape fields)
-# that makes the scenario enforceable. The gate logic itself is orchestrator-
-# out-of-band (v1: informational; v2: mandatory). The test therefore checks:
-#   (a) developer.md output-shape contains flashcards_flagged field
-#   (b) qa.md output-shape contains flashcards_flagged field
-#   (c) protocol.md §18 exists with the correct heading
-#   (d) §18 specifies the approve/reject processing rule
-#   (e) §18 specifies the worktree creation gate
-#   (f) live vs mirror diff is empty for all three files
-
-DEV_MD="$REPO_ROOT/.claude/agents/developer.md"
-QA_MD="$REPO_ROOT/.claude/agents/qa.md"
-PROTOCOL_MD="$REPO_ROOT/.cleargate/knowledge/cleargate-protocol.md"
-
-PLANNING_DEV_MD="$REPO_ROOT/cleargate-planning/.claude/agents/developer.md"
-PLANNING_QA_MD="$REPO_ROOT/cleargate-planning/.claude/agents/qa.md"
-PLANNING_PROTOCOL_MD="$REPO_ROOT/cleargate-planning/.cleargate/knowledge/cleargate-protocol.md"
-
-# (a) developer.md has flashcards_flagged in output-shape block
-if grep -q "flashcards_flagged:" "$DEV_MD"; then
-  pass "developer.md output-shape contains flashcards_flagged field"
-else
-  fail "developer.md missing flashcards_flagged field in output-shape"
-fi
-
-# (b) qa.md has flashcards_flagged in output-shape block
-if grep -q "flashcards_flagged:" "$QA_MD"; then
-  pass "qa.md output-shape contains flashcards_flagged field"
-else
-  fail "qa.md missing flashcards_flagged field in output-shape"
-fi
-
-# (c) protocol.md §18 heading exists
-if grep -q "^## 18. Immediate Flashcard Gate (v2)" "$PROTOCOL_MD"; then
-  pass "protocol.md contains ## 18. Immediate Flashcard Gate (v2)"
-else
-  fail "protocol.md missing ## 18. Immediate Flashcard Gate (v2)"
-fi
-
-# (d) §18 specifies approve + reject processing
-if grep -q "Approve" "$PROTOCOL_MD" && grep -q "Reject" "$PROTOCOL_MD"; then
-  pass "protocol §18 documents Approve/Reject processing rule"
-else
-  fail "protocol §18 missing Approve/Reject processing rule"
-fi
-
-# (e) §18 specifies the worktree creation gate
-if grep -q "Worktree creation gate\|worktree creation gate\|MUST NOT.*worktree\|worktree.*MUST NOT" "$PROTOCOL_MD"; then
-  pass "protocol §18 documents worktree creation gate"
-else
-  fail "protocol §18 missing worktree creation gate rule"
-fi
-
-# (f) qa.md says QA list is additive to Developer's
-if grep -q "additive" "$QA_MD"; then
-  pass "qa.md notes that flashcards_flagged list is additive to Developer's"
-else
-  fail "qa.md missing note that flashcards_flagged is additive"
-fi
-
-# (g) developer.md references protocol §18
-if grep -q "protocol §18\|§18" "$DEV_MD"; then
-  pass "developer.md references protocol §18"
-else
-  fail "developer.md does not reference protocol §18"
-fi
-
-# (h) qa.md references protocol §18
-if grep -q "protocol §18\|§18" "$QA_MD"; then
-  pass "qa.md references protocol §18"
-else
-  fail "qa.md does not reference protocol §18"
-fi
-
-# (i) three-surface diff: live developer.md vs mirror
-if diff -q "$DEV_MD" "$PLANNING_DEV_MD" > /dev/null 2>&1; then
-  pass "developer.md live vs mirror diff is empty"
-else
-  fail "developer.md live vs mirror diff is NOT empty"
-fi
-
-# (j) three-surface diff: live qa.md vs mirror
-if diff -q "$QA_MD" "$PLANNING_QA_MD" > /dev/null 2>&1; then
-  pass "qa.md live vs mirror diff is empty"
-else
-  fail "qa.md live vs mirror diff is NOT empty"
-fi
-
-# (k) three-surface diff: live protocol.md vs mirror
-if diff -q "$PROTOCOL_MD" "$PLANNING_PROTOCOL_MD" > /dev/null 2>&1; then
-  pass "cleargate-protocol.md live vs mirror diff is empty"
-else
-  fail "cleargate-protocol.md live vs mirror diff is NOT empty"
-fi
-
-# (l) synthetic fixture: dev report with flashcards_flagged triggers gate
-# Simulate: write a temp dev report with flashcards_flagged, grep for it
-TMPDIR_FIXTURE="$(mktemp -d)"
-trap 'rm -rf "$TMPDIR_FIXTURE"' EXIT
-
-cat > "$TMPDIR_FIXTURE/STORY-014-05-dev.md" << 'FIXTURE'
-STORY: STORY-014-05
-STATUS: done
-COMMIT: abc1234
-TYPECHECK: pass
-TESTS: 5 passed, 0 failed
-FILES_CHANGED: src/foo.ts
-NOTES: all green
-flashcards_flagged:
-  - "2026-04-22 · #test-harness · vitest fake-timers conflict with worker.spawn"
-FIXTURE
-
-# Assert the fixture has the flashcard entry
-if grep -q "flashcards_flagged:" "$TMPDIR_FIXTURE/STORY-014-05-dev.md"; then
-  pass "synthetic dev-report fixture contains flashcards_flagged field"
-else
-  fail "synthetic dev-report fixture missing flashcards_flagged field"
-fi
-
-# Assert extraction of the flagged card matches the FLASHCARD.md format
-EXTRACTED=$(grep -A1 "flashcards_flagged:" "$TMPDIR_FIXTURE/STORY-014-05-dev.md" | tail -1 | sed 's/^[[:space:]]*- "//' | sed 's/"$//')
-if echo "$EXTRACTED" | grep -qE "^[0-9]{4}-[0-9]{2}-[0-9]{2} · #[a-z-]+ · .+"; then
-  pass "extracted flashcard matches YYYY-MM-DD · #tag · lesson format"
-else
-  fail "extracted flashcard does NOT match expected format: '$EXTRACTED'"
-fi
-
-# Mock worktree guard: confirm the gate would block by checking the field is non-empty
-FLAGGED_COUNT=$(grep -c "  - " "$TMPDIR_FIXTURE/STORY-014-05-dev.md" || true)
-if [ "$FLAGGED_COUNT" -gt 0 ]; then
-  pass "gate detects non-empty flashcards_flagged — worktree creation would be blocked"
-else
-  fail "gate failed to detect non-empty flashcards_flagged list"
-fi
-
-# Mock approval: append to a temp FLASHCARD.md and confirm it was written
-TEMP_FLASHCARD="$TMPDIR_FIXTURE/FLASHCARD.md"
-echo "# ClearGate Flashcards" > "$TEMP_FLASHCARD"
-echo "" >> "$TEMP_FLASHCARD"
-echo "$EXTRACTED" >> "$TEMP_FLASHCARD"
-
-if grep -q "vitest fake-timers conflict" "$TEMP_FLASHCARD"; then
-  pass "approved flashcard appended to FLASHCARD.md mock"
-else
-  fail "approved flashcard NOT found in FLASHCARD.md mock"
-fi
-
-# ---------------------------------------------------------------------------
-# Summary
-# ---------------------------------------------------------------------------
-TOTAL=$((PASS + FAIL))
-echo ""
-echo "Results: $PASS/$TOTAL passed"
-
-if [ "$FAIL" -gt 0 ]; then
-  exit 1
-fi
-exit 0