@mmerterden/multi-agent-pipeline 12.7.0 → 12.9.0

package/pipeline/scripts/smoke-progress-contract.sh

@@ -1,127 +0,0 @@
-#!/usr/bin/env bash
-# smoke-progress-contract.sh  -  enforce the progress-line contract across phase docs.
-#
-# Verifies:
-#   1. Contract doc exists at refs/progress-contract.md with the required sections.
-#   2. Line shape example is present in the doc (so downstream consumers have a
-#      canonical pattern to grep).
-#   3. progressVerbosity field exists in prefs.schema.json with enum {quiet, normal, verbose}.
-#   4. Adoption marker `<!-- progress-contract: applied -->` count across phase docs
-#      is reported (advisory in v5.0.0 development; will flip to blocking at
-#      v5.0.0 release once every phase has opted in).
-#   5. Phases that DO carry the marker actually emit at least one `→ <verb>` line
-#      or reference the contract explicitly.
-
-set -euo pipefail
-
-HERE="$(cd "$(dirname "$0")" && pwd)"
-ROOT="$(cd "$HERE/../.." && pwd)"
-CONTRACT="$ROOT/pipeline/multi-agent-refs/progress-contract.md"
-PREFS="$ROOT/pipeline/schemas/prefs.schema.json"
-PHASE_DIR="$ROOT/pipeline/multi-agent-refs/phases"
-
-# Flip to "true" to make missing adoption markers blocking. Today: advisory.
-BLOCKING_ADOPTION="${PROGRESS_CONTRACT_BLOCKING:-false}"
-
-PASS=0
-FAIL=0
-WARN=0
-pass() { PASS=$((PASS+1)); echo "  ✓ $1"; }
-fail() { FAIL=$((FAIL+1)); echo "  ✗ $1"; }
-warn() { WARN=$((WARN+1)); echo "  ⚠ $1"; }
-
-need() { command -v "$1" >/dev/null 2>&1 || { echo "error: $1 required" >&2; exit 127; }; }
-need jq
-need grep
-
-[ -f "$CONTRACT" ] || { echo "error: contract not found at $CONTRACT" >&2; exit 1; }
-[ -f "$PREFS" ] || { echo "error: prefs schema not found at $PREFS" >&2; exit 1; }
-[ -d "$PHASE_DIR" ] || { echo "error: phase docs dir not found at $PHASE_DIR" >&2; exit 1; }
-
-echo "→ 1. contract doc has required sections"
-for section in "## Line shape" "## When to emit" "## Verbosity" "## Telemetry" "## Phase adoption marker" "## Cross-CLI parity"; do
-  if grep -Fq "$section" "$CONTRACT"; then
-    pass "section present: $section"
-  else
-    fail "section missing: $section"
-  fi
-done
-
-echo ""
-echo "→ 2. canonical line-shape template present"
-# The doc should show: `    → <verb> <object>[ <target>]`
-if grep -qE '→ <verb> <object>' "$CONTRACT"; then
-  pass "canonical shape '→ <verb> <object>' present"
-else
-  fail "canonical shape missing"
-fi
-
-echo ""
-echo "→ 3. prefs schema declares progressVerbosity with correct enum"
-VERBOSITY_ENUM=$(jq -c '.properties.global.properties.progressVerbosity.enum' "$PREFS")
-if [ "$VERBOSITY_ENUM" = '["quiet","normal","verbose"]' ]; then
-  pass "progressVerbosity.enum = [quiet, normal, verbose]"
-else
-  fail "progressVerbosity.enum wrong: $VERBOSITY_ENUM"
-fi
-DEFAULT=$(jq -r '.properties.global.properties.progressVerbosity.default' "$PREFS")
-[ "$DEFAULT" = "normal" ] && pass "default = normal" || fail "default should be normal, got '$DEFAULT'"
-
-echo ""
-echo "→ 4. phase adoption marker inventory"
-TOTAL_PHASES=0
-ADOPTED=0
-MISSING=()
-for doc in "$PHASE_DIR"/phase-*.md; do
-  [ -f "$doc" ] || continue
-  TOTAL_PHASES=$((TOTAL_PHASES+1))
-  if grep -Fq "<!-- progress-contract: applied -->" "$doc"; then
-    ADOPTED=$((ADOPTED+1))
-  else
-    MISSING+=("$(basename "$doc")")
-  fi
-done
-echo "     phases scanned: $TOTAL_PHASES"
-echo "     adopted:        $ADOPTED"
-if [ "${#MISSING[@]}" -eq 0 ]; then
-  pass "all phases have the adoption marker"
-else
-  if [ "$BLOCKING_ADOPTION" = "true" ]; then
-    fail "missing adoption in ${#MISSING[@]} phases: ${MISSING[*]}"
-  else
-    warn "advisory  -  missing adoption in ${#MISSING[@]} phases: ${MISSING[*]}"
-  fi
-fi
-
-echo ""
-echo "→ 5. phases that DO adopt the marker actually emit progress lines"
-BROKEN_ADOPTIONS=()
-for doc in "$PHASE_DIR"/phase-*.md; do
-  [ -f "$doc" ] || continue
-  if grep -Fq "<!-- progress-contract: applied -->" "$doc"; then
-    # Must reference the contract OR show at least one sample `→ <verb>` line.
-    if grep -qE '→ (fetching|reading|running|writing|posting|waiting|dispatching|retrying|building|committing|checking) ' "$doc" \
-       || grep -Fq "refs/progress-contract.md" "$doc"; then
-      pass "$(basename "$doc") carries marker + shows progress usage"
-    else
-      fail "$(basename "$doc") has marker but no sample progress line or contract link"
-      BROKEN_ADOPTIONS+=("$(basename "$doc")")
-    fi
-  fi
-done
-if [ "$ADOPTED" -eq 0 ]; then
-  warn "no phases have adopted yet  -  this is expected until WS-4/5/6 land"
-fi
-
-echo ""
-echo "→ Live mirror cross-link (tracker coupling)"
-if grep -q "Live mirror to the phase tracker" "$CONTRACT" \
-   && grep -q "phase-tracker.sh now" "$CONTRACT"; then
-  pass "contract cross-links the tracker mirror rule"
-else
-  fail "contract missing the live-mirror cross-link to tracker-contract.md"
-fi
-
-echo ""
-echo "══ progress-contract smoke: $PASS passed, $WARN warnings, $FAIL failed ══"
-[ "$FAIL" -eq 0 ]

package/pipeline/scripts/smoke-prune-logs.sh

@@ -1,137 +0,0 @@
-#!/usr/bin/env bash
-# smoke-prune-logs.sh  -  prune-logs.sh removes per-task log dirs, honors the
-# project/task/age filters, is dry-run by default, NEVER deletes the audit
-# trail or metrics corpus (even under adversarial dir names), refuses unsafe
-# log roots, and spares active task dirs.
-#
-# Exit 0 = all pass, 1 = any failure.
-
-set -uo pipefail
-
-ROOT="$(cd "$(dirname "$0")/../.." && pwd)"
-PL="$ROOT/pipeline/scripts/prune-logs.sh"
-PASS=0
-FAIL=0
-pass() {
-  PASS=$((PASS + 1))
-  echo "  ✓ $1"
-}
-fail() {
-  FAIL=$((FAIL + 1))
-  echo "  ✗ $1"
-}
-[ -f "$PL" ] || {
-  echo "FAIL: prune-logs.sh missing" >&2
-  exit 1
-}
-
-LR="$(mktemp -d)"
-trap 'rm -rf "$LR"' EXIT
-
-seed() {
-  rm -rf "${LR:?}"/*
-  mkdir -p "$LR/my-ios-app/PROJ-1" "$LR/my-ios-app/PROJ-2" "$LR/other/PROJ-9"
-  echo '{}' >"$LR/my-ios-app/PROJ-1/agent-state.json"
-  echo '{}' >"$LR/my-ios-app/PROJ-2/tracker-state.json"
-  echo '{}' >"$LR/other/PROJ-9/agent-log.md"
-  echo 'audit' >"$LR/audit.jsonl"
-  echo 'metric' >"$LR/metrics.jsonl"
-  echo '5' >"$LR/my-ios-app/.counter"
-}
-
-echo "→ 1. dry-run lists task dirs and deletes nothing"
-seed
-out=$(PRUNE_LOG_ROOT="$LR" PRUNE_GRACE_MIN=0 bash "$PL" 2>&1)
-echo "$out" | grep -q "DRY-RUN" && pass "dry-run banner shown" || fail "dry-run banner missing"
-[ -f "$LR/my-ios-app/PROJ-1/agent-state.json" ] && pass "dry-run kept task dirs" || fail "dry-run deleted a task dir"
-echo "$out" | grep -qi "preserved" && pass "dry-run states audit/metrics are preserved" || fail "no preservation note"
-
-echo ""
-echo "→ 2. --yes deletes task dirs but preserves audit + metrics + .counter"
-seed
-PRUNE_LOG_ROOT="$LR" PRUNE_GRACE_MIN=0 bash "$PL" --yes >/dev/null 2>&1
-[ -f "$LR/audit.jsonl" ] && pass "audit.jsonl preserved" || fail "audit.jsonl was deleted"
-[ -f "$LR/metrics.jsonl" ] && pass "metrics.jsonl preserved" || fail "metrics.jsonl was deleted"
-[ -f "$LR/my-ios-app/.counter" ] && pass ".counter preserved" || fail ".counter was deleted"
-[ ! -e "$LR/my-ios-app/PROJ-1" ] && pass "task dir PROJ-1 removed" || fail "task dir PROJ-1 survived"
-[ ! -e "$LR/other/PROJ-9" ] && pass "task dir PROJ-9 removed" || fail "task dir PROJ-9 survived"
-
-echo ""
-echo "→ 3. --project scopes deletion to one project"
-seed
-PRUNE_LOG_ROOT="$LR" PRUNE_GRACE_MIN=0 bash "$PL" --project=my-ios-app --yes >/dev/null 2>&1
-[ ! -e "$LR/my-ios-app/PROJ-1" ] && pass "my-ios-app task removed" || fail "my-ios-app task survived"
-[ -f "$LR/other/PROJ-9/agent-log.md" ] && pass "other project untouched" || fail "other project was deleted"
-
-echo ""
-echo "→ 4. --task scopes deletion to one task dir"
-seed
-PRUNE_LOG_ROOT="$LR" PRUNE_GRACE_MIN=0 bash "$PL" --task=PROJ-1 --yes >/dev/null 2>&1
-[ ! -e "$LR/my-ios-app/PROJ-1" ] && pass "PROJ-1 removed" || fail "PROJ-1 survived"
-[ -f "$LR/my-ios-app/PROJ-2/tracker-state.json" ] && pass "PROJ-2 untouched" || fail "PROJ-2 was deleted"
-
-echo ""
-echo "→ 5. --older-than excludes fresh task dirs"
-seed
-out=$(PRUNE_LOG_ROOT="$LR" PRUNE_GRACE_MIN=0 bash "$PL" --older-than=1 2>&1)
-echo "$out" | grep -q "nothing" && pass "freshly-created dirs excluded by --older-than=1" || fail "--older-than did not exclude fresh dirs"
-
-echo ""
-echo "→ 6. usage errors + empty root"
-PRUNE_LOG_ROOT="$LR" bash "$PL" --bogus >/dev/null 2>&1
-[ "$?" = "2" ] && pass "unknown argument exits 2" || fail "unknown argument did not exit 2"
-PRUNE_LOG_ROOT="/nonexistent-$$-dir" bash "$PL" >/dev/null 2>&1
-[ "$?" = "0" ] && pass "missing log root exits 0 (no-op)" || fail "missing log root did not exit 0"
-
-echo ""
-echo "→ 7. adversarial dirs named like preserved files survive --yes"
-rm -rf "${LR:?}"/*
-mkdir -p "$LR/audit.jsonl" "$LR/proj/metrics.jsonl" "$LR/proj/metrics-summary.md" "$LR/proj/.counter" "$LR/proj/PROJ-5"
-echo '{}' >"$LR/audit.jsonl/agent-state.json"
-echo '{}' >"$LR/proj/metrics.jsonl/agent-log.md"
-echo '{}' >"$LR/proj/metrics-summary.md/tracker-state.json"
-echo '{}' >"$LR/proj/.counter/agent-state.json"
-echo '{}' >"$LR/proj/PROJ-5/agent-state.json"
-PRUNE_LOG_ROOT="$LR" PRUNE_GRACE_MIN=0 bash "$PL" --yes >/dev/null 2>&1
-[ -d "$LR/audit.jsonl" ] && pass "dir named audit.jsonl spared" || fail "dir named audit.jsonl deleted"
-[ -d "$LR/proj/metrics.jsonl" ] && pass "dir named metrics.jsonl spared" || fail "dir named metrics.jsonl deleted"
-[ -d "$LR/proj/metrics-summary.md" ] && pass "dir named metrics-summary.md spared" || fail "dir named metrics-summary.md deleted"
-[ -d "$LR/proj/.counter" ] && pass "dir named .counter spared" || fail "dir named .counter deleted"
-[ ! -e "$LR/proj/PROJ-5" ] && pass "normal task dir beside them still removed" || fail "normal task dir survived"
-
-echo ""
-echo "→ 8. unsafe log roots are refused (exit 2, dry-run only)"
-PRUNE_LOG_ROOT="$HOME" bash "$PL" >/dev/null 2>&1
-[ "$?" = "2" ] && pass "\$HOME as log root refused" || fail "\$HOME as log root not refused"
-GITROOT="$(mktemp -d)"
-mkdir -p "$GITROOT/.git"
-PRUNE_LOG_ROOT="$GITROOT" bash "$PL" --yes >/dev/null 2>&1
-rc=$?
-rm -rf "$GITROOT"
-[ "$rc" = "2" ] && pass "git work tree as log root refused" || fail "git work tree as log root not refused"
-
-echo ""
-echo "→ 9. default grace spares freshly-touched (active) task dirs"
-seed
-out=$(PRUNE_LOG_ROOT="$LR" bash "$PL" --yes 2>&1)
-rc=$?
-[ "$rc" = "0" ] && pass "grace run exits 0" || fail "grace run exited $rc"
-[ -f "$LR/my-ios-app/PROJ-1/agent-state.json" ] && pass "active task dir spared by default grace" || fail "default grace deleted an active task dir"
-echo "$out" | grep -qi "spared" && pass "output mentions spared active dirs" || fail "no spared-active note in output"
-PRUNE_LOG_ROOT="$LR" bash "$PL" --task=PROJ-1 --yes >/dev/null 2>&1
-[ ! -e "$LR/my-ios-app/PROJ-1" ] && pass "explicit --task bypasses the grace" || fail "--task did not bypass the grace"
-
-echo ""
-echo "→ 10. traversal-shaped --task/--project values are rejected"
-PRUNE_LOG_ROOT="$LR" bash "$PL" "--task=../evil" >/dev/null 2>&1
-[ "$?" = "2" ] && pass "--task=../evil exits 2" || fail "--task=../evil accepted"
-PRUNE_LOG_ROOT="$LR" bash "$PL" "--task=.counter" >/dev/null 2>&1
-[ "$?" = "2" ] && pass "--task=.counter (leading dot) exits 2" || fail "--task=.counter accepted"
-PRUNE_LOG_ROOT="$LR" bash "$PL" "--project=a/b" >/dev/null 2>&1
-[ "$?" = "2" ] && pass "--project=a/b exits 2" || fail "--project=a/b accepted"
-PRUNE_LOG_ROOT="$LR" bash "$PL" "--task=" >/dev/null 2>&1
-[ "$?" = "2" ] && pass "empty --task exits 2" || fail "empty --task accepted"
-
-echo ""
-echo "══ prune-logs smoke: $PASS passed, $FAIL failed ══"
-[ "$FAIL" -eq 0 ]

package/pipeline/scripts/smoke-purge.sh

@@ -1,138 +0,0 @@
-#!/usr/bin/env bash
-# smoke-purge.sh  -  purge.sh wipes .worktrees/ worktrees (registered and
-# orphaned), their local branches, and the project task counter; is dry-run
-# by default; preserves the main worktree, protected branches, and the
-# audit/metrics corpus; and never follows symlinks out of .worktrees/.
-#
-# Exit 0 = all pass, 1 = any failure.
-
-set -uo pipefail
-
-ROOT="$(cd "$(dirname "$0")/../.." && pwd)"
-PG="$ROOT/pipeline/scripts/purge.sh"
-PASS=0
-FAIL=0
-pass() {
-  PASS=$((PASS + 1))
-  echo "  ✓ $1"
-}
-fail() {
-  FAIL=$((FAIL + 1))
-  echo "  ✗ $1"
-}
-[ -f "$PG" ] || {
-  echo "FAIL: purge.sh missing" >&2
-  exit 1
-}
-
-SB="$(cd "$(mktemp -d)" && pwd -P)"
-trap 'rm -rf "$SB"' EXIT
-
-REPO="$SB/repo"
-LR="$SB/logs"
-VICTIM="$SB/victim"
-
-seed() {
-  rm -rf "$REPO" "$LR" "$VICTIM"
-  mkdir -p "$REPO" "$LR/repo" "$VICTIM"
-  echo keep >"$VICTIM/keep.txt"
-  git -C "$REPO" init -q -b main
-  git -C "$REPO" -c user.email=t@t.t -c user.name=t commit -q --allow-empty -m init
-  git -C "$REPO" worktree add -q -b feature/PROJ-1-x "$REPO/.worktrees/PROJ-1" >/dev/null 2>&1
-  git -C "$REPO" worktree add -q -b bugfix/PROJ-2-y "$REPO/.worktrees/PROJ-2" >/dev/null 2>&1
-  mkdir -p "$REPO/.worktrees/PROJ-9" # orphan: dir git no longer registers
-  echo '{}' >"$REPO/.worktrees/PROJ-9/agent-state.json"
-  ln -s "$VICTIM" "$REPO/.worktrees/evil-link" # symlink escape attempt
-  echo '7' >"$LR/repo/.counter"
-  echo audit >"$LR/audit.jsonl"
-  echo metric >"$LR/metrics.jsonl"
-}
-
-has_branch() {
-  git -C "$REPO" show-ref --verify -q "refs/heads/$1"
-}
-
-echo "→ 1. dry-run lists everything and deletes nothing"
-seed
-out=$(PURGE_LOG_ROOT="$LR" bash "$PG" --repo "$REPO" 2>&1)
-rc=$?
-[ "$rc" = "0" ] && pass "dry-run exits 0" || fail "dry-run exited $rc"
-echo "$out" | grep -q "DRY-RUN" && pass "dry-run banner shown" || fail "dry-run banner missing"
-echo "$out" | grep -q "PROJ-1" && pass "worktree PROJ-1 listed" || fail "worktree PROJ-1 not listed"
-echo "$out" | grep -q "feature/PROJ-1-x" && pass "branch listed" || fail "branch not listed"
-echo "$out" | grep -q ".counter" && pass "counter listed" || fail "counter not listed"
-[ -d "$REPO/.worktrees/PROJ-1" ] && pass "dry-run kept worktrees" || fail "dry-run deleted a worktree"
-[ -f "$LR/repo/.counter" ] && pass "dry-run kept the counter" || fail "dry-run deleted the counter"
-has_branch feature/PROJ-1-x && pass "dry-run kept branches" || fail "dry-run deleted a branch"
-
-echo ""
-echo "→ 2. --yes wipes worktrees + branches + counter, preserves the rest"
-seed
-PURGE_LOG_ROOT="$LR" bash "$PG" --repo "$REPO" --yes >/dev/null 2>&1
-rc=$?
-[ "$rc" = "0" ] && pass "--yes exits 0" || fail "--yes exited $rc"
-[ ! -e "$REPO/.worktrees/PROJ-1" ] && pass "registered worktree PROJ-1 removed" || fail "PROJ-1 survived"
-[ ! -e "$REPO/.worktrees/PROJ-2" ] && pass "registered worktree PROJ-2 removed" || fail "PROJ-2 survived"
-[ ! -e "$REPO/.worktrees/PROJ-9" ] && pass "orphan worktree dir removed" || fail "orphan PROJ-9 survived"
-! has_branch feature/PROJ-1-x && pass "branch feature/PROJ-1-x deleted" || fail "feature/PROJ-1-x survived"
-! has_branch bugfix/PROJ-2-y && pass "branch bugfix/PROJ-2-y deleted" || fail "bugfix/PROJ-2-y survived"
-has_branch main && pass "main branch preserved" || fail "main branch was deleted"
-git -C "$REPO" rev-parse --is-inside-work-tree >/dev/null 2>&1 && pass "main worktree still a git repo" || fail "main worktree destroyed"
-wt_count=$(git -C "$REPO" worktree list 2>/dev/null | wc -l | tr -d ' ')
-[ "$wt_count" = "1" ] && pass "only the main worktree remains registered" || fail "expected 1 registered worktree, got $wt_count"
-[ ! -e "$LR/repo/.counter" ] && pass "task counter removed" || fail "task counter survived"
-[ -f "$LR/audit.jsonl" ] && pass "audit.jsonl preserved" || fail "audit.jsonl was deleted"
-[ -f "$LR/metrics.jsonl" ] && pass "metrics.jsonl preserved" || fail "metrics.jsonl was deleted"
-[ -f "$VICTIM/keep.txt" ] && pass "symlink target outside repo untouched" || fail "symlink target was deleted"
-
-echo ""
-echo "→ 3. protected branch carried by a worktree survives, worktree still removed"
-seed
-git -C "$REPO" worktree add -q -b develop "$REPO/.worktrees/DEV-1" >/dev/null 2>&1
-PURGE_LOG_ROOT="$LR" bash "$PG" --repo "$REPO" --yes >/dev/null 2>&1
-[ ! -e "$REPO/.worktrees/DEV-1" ] && pass "develop worktree removed" || fail "develop worktree survived"
-has_branch develop && pass "develop branch preserved" || fail "develop branch was deleted"
-
-echo ""
-echo "→ 4. clean repo and non-repo are no-ops (exit 0)"
-CLEAN="$SB/clean"
-mkdir -p "$CLEAN"
-git -C "$CLEAN" init -q -b main
-out=$(PURGE_LOG_ROOT="$LR" bash "$PG" --repo "$CLEAN" 2>&1)
-rc=$?
-{ [ "$rc" = "0" ] && echo "$out" | grep -q "nothing to do"; } && pass "clean repo is a no-op" || fail "clean repo not a clean no-op (rc=$rc)"
-PLAIN="$SB/plain"
-mkdir -p "$PLAIN"
-out=$(bash "$PG" --repo "$PLAIN" 2>&1)
-rc=$?
-{ [ "$rc" = "0" ] && echo "$out" | grep -q "not a git work tree"; } && pass "non-repo dir is a no-op" || fail "non-repo dir not a clean no-op (rc=$rc)"
-
-echo ""
-echo "→ 5. usage errors exit 2"
-bash "$PG" --bogus >/dev/null 2>&1
-[ "$?" = "2" ] && pass "unknown argument exits 2" || fail "unknown argument did not exit 2"
-bash "$PG" --repo >/dev/null 2>&1
-[ "$?" = "2" ] && pass "--repo without a path exits 2" || fail "--repo without a path did not exit 2"
-
-echo ""
-echo "→ 6. --delete-remote without a remote warns but does not fail"
-seed
-out=$(PURGE_LOG_ROOT="$LR" bash "$PG" --repo "$REPO" --delete-remote 2>&1)
-echo "$out" | grep -q "remote branch origin/feature/PROJ-1-x" && pass "dry-run lists remote branch deletion" || fail "dry-run missing remote branch line"
-out=$(PURGE_LOG_ROOT="$LR" bash "$PG" --repo "$REPO" --delete-remote --yes 2>&1)
-rc=$?
-[ "$rc" = "0" ] && pass "--delete-remote --yes exits 0 without a remote" || fail "--delete-remote --yes exited $rc"
-echo "$out" | grep -qi "warning" && pass "missing remote surfaces a warning" || fail "no warning for missing remote"
-
-echo ""
-echo "→ 7. purge from inside a linked worktree still anchors on the main repo"
-seed
-out=$(PURGE_LOG_ROOT="$LR" bash "$PG" --repo "$REPO/.worktrees/PROJ-1" --yes 2>&1)
-rc=$?
-[ "$rc" = "0" ] && pass "run from linked worktree exits 0" || fail "run from linked worktree exited $rc"
-[ ! -e "$REPO/.worktrees/PROJ-1" ] && pass "worktrees removed when invoked from inside one" || fail "worktrees survived"
-git -C "$REPO" rev-parse --is-inside-work-tree >/dev/null 2>&1 && pass "main repo intact" || fail "main repo destroyed"
-
-echo ""
-echo "══ purge smoke: $PASS passed, $FAIL failed ══"
-[ "$FAIL" -eq 0 ]

package/pipeline/scripts/smoke-push-retry.sh

@@ -1,75 +0,0 @@
-#!/usr/bin/env bash
-# smoke-push-retry.sh  -  asserts the push-must-succeed policy is documented
-# correctly in Phase 6 and gated by settings.pushMustSucceed.
-
-set -uo pipefail
-
-PHASE6="$HOME/.claude/multi-agent-refs/phases/phase-6-commit.md"
-PREFS_SCHEMA="$HOME/.claude/schemas/prefs.schema.json"
-
-PASS=0; FAIL=0
-pass() { PASS=$((PASS+1)); echo "  ✓ $1"; }
-fail() { FAIL=$((FAIL+1)); echo "  ✗ $1"; }
-
-if [ ! -f "$PHASE6" ]; then
-  fail "phase-6-commit.md missing"; echo "══ aborted ══"; exit 2
-fi
-
-echo "→ 1. Push-must-succeed gate flag"
-grep -q "settings.pushMustSucceed" "$PHASE6" \
-  && pass "Phase 6 references settings.pushMustSucceed gate" \
-  || fail "settings.pushMustSucceed gate missing in Phase 6"
-[ -f "$PREFS_SCHEMA" ] && grep -q '"pushMustSucceed"' "$PREFS_SCHEMA" \
-  && pass "Schema declares settings.pushMustSucceed" \
-  || fail "Schema missing settings.pushMustSucceed"
-
-echo "→ 2. Retry budget"
-grep -q "settings.pushRetryMax" "$PHASE6" \
-  && pass "Phase 6 references settings.pushRetryMax" \
-  || fail "settings.pushRetryMax reference missing"
-[ -f "$PREFS_SCHEMA" ] && grep -q '"pushRetryMax"' "$PREFS_SCHEMA" \
-  && pass "Schema declares settings.pushRetryMax" \
-  || fail "Schema missing settings.pushRetryMax"
-grep -q "default 5\|default \`5\`" "$PHASE6" \
-  && pass "Default retry budget 5 documented" \
-  || fail "Default retry budget 5 missing"
-
-echo "→ 3. Rebase before push"
-grep -q "git -C \"\$WT_PATH\" fetch origin" "$PHASE6" \
-  && pass "Re-fetch origin before push" \
-  || fail "Re-fetch step missing"
-grep -q "git -C \"\$WT_PATH\" rebase" "$PHASE6" \
-  && pass "Rebase on advancing base" \
-  || fail "Rebase step missing"
-grep -q "rebase conflict: abort" "$PHASE6" \
-  && pass "Rebase-conflict aborts cleanly" \
-  || fail "Rebase-conflict abort missing"
-
-echo "→ 4. Back-off between attempts"
-grep -q "sleep" "$PHASE6" \
-  && pass "Back-off sleep between push attempts" \
-  || fail "Back-off sleep missing"
-grep -qE "back-off:\s*2,4,6,8" "$PHASE6" \
-  && pass "Documented back-off cadence (2,4,6,8s)" \
-  || fail "Back-off cadence not documented"
-
-echo "→ 5. Final-fail user prompt (4 options)"
-for opt in "Resolve conflict manually" "different base branch" "Skip this repo" "Pause Phase 6"; do
-  grep -q "$opt" "$PHASE6" \
-    && pass "Final-fail option present: $opt" \
-    || fail "Final-fail option missing: $opt"
-done
-
-echo "→ 6. Push status persistence"
-grep -q "state.projects\[i\].pushStatus" "$PHASE6" \
-  && pass "pushStatus persisted to state" \
-  || fail "pushStatus persistence missing"
-for v in '"pushed"' '"rebase-pushed"' '"skipped"' '"paused"'; do
-  grep -q "$v" "$PHASE6" \
-    && pass "pushStatus enum value: $v" \
-    || fail "pushStatus enum value missing: $v"
-done
-
-echo ""
-echo "══ push-retry smoke: $PASS passed, $FAIL failed ══"
-[ "$FAIL" -eq 0 ]