@mmerterden/multi-agent-pipeline 8.6.0

package/pipeline/scripts/smoke-pref-migration.sh

@@ -0,0 +1,224 @@
+#!/usr/bin/env bash
+# smoke-pref-migration.sh — exercises migrate-prefs.mjs against representative
+# v2.0.0 and pre-2.0.0 fixtures, asserts the output is v2.1.0-shaped.
+#
+# Fixtures are synthesized inline (no external files) to keep the test self-contained.
+# Run after any change to migrate-prefs.mjs or prefs.schema.json.
+
+set -uo pipefail
+
+HERE="$(cd "$(dirname "$0")" && pwd)"
+MIGRATE="$HERE/migrate-prefs.mjs"
+TMP="$(mktemp -d -t ma-smoke-migration-XXXX)"
+trap 'rm -rf "$TMP"' EXIT
+
+PASS=0
+FAIL=0
+pass() { PASS=$((PASS + 1)); echo "  ✓ $1"; }
+fail() { FAIL=$((FAIL + 1)); echo "  ✗ $1"; }
+
+if [ ! -f "$MIGRATE" ]; then
+  fail "migrate-prefs.mjs not found at $MIGRATE"
+  echo "══ pref-migration smoke: aborted ══"
+  exit 2
+fi
+
+# Helper: write fixture to $TMP/<name>.json, run migration, read back
+run_fixture() {
+  local name="$1"
+  local content="$2"
+  local file="$TMP/$name.json"
+  printf '%s' "$content" > "$file"
+  node "$MIGRATE" --file "$file" >/dev/null 2>&1
+  cat "$file"
+}
+
+assert_json_has() {
+  local name="$1"
+  local json="$2"
+  local path="$3"  # e.g. .schemaVersion or .global.identities
+  local expected="$4"
+  local actual
+  actual=$(echo "$json" | node -e "
+    const j = JSON.parse(require('fs').readFileSync(0, 'utf8'));
+    const p = '$path'.split('.').filter(Boolean);
+    let v = j; for (const k of p) v = v?.[k];
+    if (Array.isArray(v)) console.log('array:' + v.length);
+    else if (typeof v === 'object' && v !== null) console.log('object:' + Object.keys(v).length);
+    else console.log(String(v));
+  " 2>/dev/null)
+  if [ "$actual" = "$expected" ]; then
+    pass "$name: $path == $expected"
+  else
+    fail "$name: $path expected '$expected', got '$actual'"
+  fi
+}
+
+# ──────────────────────────────────────────────────────────────────────────
+echo "→ Fixture 1: v2.0.0 with gitIdentities (legacy)"
+F1=$(run_fixture "f1-v2.0.0-legacy" '{
+  "schemaVersion": "2.0.0",
+  "global": {
+    "gitIdentities": [{"name": "Test User", "email": "test@example.com"}],
+    "keychainMapping": {"jira": "user_Jira_Access_Token"}
+  },
+  "projects": {}
+}')
+assert_json_has "f1" "$F1" ".schemaVersion" "2.3.0"
+assert_json_has "f1" "$F1" ".global.identities" "array:1"
+assert_json_has "f1" "$F1" ".global.gitIdentities" "undefined"
+assert_json_has "f1" "$F1" ".global.settings" "object:8"
+assert_json_has "f1" "$F1" ".global.keychainMapping" "object:10"
+assert_json_has "f1" "$F1" ".global.platformIdentityRouting" "object:0"
+assert_json_has "f1" "$F1" ".global.recentGroups" "array:0"
+assert_json_has "f1" "$F1" ".global.recentAccounts" "array:0"
+assert_json_has "f1" "$F1" ".global.accounts" "array:0"
+
+echo ""
+echo "→ Fixture 2: no schemaVersion (pre-2.0.0 fossil)"
+F2=$(run_fixture "f2-no-version" '{
+  "global": {"gitIdentities": []},
+  "projects": {}
+}')
+assert_json_has "f2" "$F2" ".schemaVersion" "2.3.0"
+assert_json_has "f2" "$F2" ".global.identities" "array:0"
+
+echo ""
+echo "→ Fixture 3: v2.3.0 already (no-op)"
+F3_FILE="$TMP/f3-v2.3.0.json"
+cat > "$F3_FILE" <<'EOF'
+{
+  "schemaVersion": "2.3.0",
+  "global": {
+    "identities": [],
+    "keychainMapping": {
+      "jira": null, "bitbucket_token": null, "bitbucket_user": null,
+      "github": null, "confluence": null, "figma": null,
+      "figma_mcp": null, "fortify": null,
+      "firebase": null, "jenkins": null
+    },
+    "platformIdentityRouting": {},
+    "recentProjects": [],
+    "recentBranches": {},
+    "recentGroups": [],
+    "serviceStatus": {},
+    "settings": {
+      "branchTtlDays": 15, "pushRetryMax": 5, "buildRetryMax": 3,
+      "serviceStatusCacheSeconds": 300, "repoScanDays": 90,
+      "identityRoutingEnabled": false, "multiRepoEnabled": false,
+      "pushMustSucceed": true
+    },
+    "triageCrossCheck": {
+      "enabled": false, "samplePct": 10, "model": "sonnet", "blockOnDisagreement": false
+    },
+    "promptLanguage": "en",
+    "reportChannels": {"pr": true, "jira": true, "confluence": false, "wiki": false},
+    "reportContent": {"normalAnalysis": true, "technicalAnalysis": false, "testScenarios": true, "autoDiff": false, "manualNote": false},
+    "wikiScope": ["main", "ios", "screenshots", "index"],
+    "autopilotReportTimeoutSeconds": 1800,
+    "recentAccounts": [],
+    "accounts": []
+  },
+  "projects": {}
+}
+EOF
+# Hash before
+BEFORE=$(shasum -a 256 "$F3_FILE" | awk '{print $1}')
+node "$MIGRATE" --file "$F3_FILE" >/dev/null 2>&1
+AFTER=$(shasum -a 256 "$F3_FILE" | awk '{print $1}')
+if [ "$BEFORE" = "$AFTER" ]; then
+  pass "f3: idempotent (v2.3.0 unchanged by re-run)"
+else
+  fail "f3: v2.3.0 file mutated by re-run (hash changed)"
+fi
+
+echo ""
+echo "→ Fixture 4: obsolete fields pruned"
+F4=$(run_fixture "f4-obsolete" '{
+  "global": {
+    "defaultPriority": "Medium",
+    "defaultIssueType": "Story",
+    "gitIdentities": []
+  },
+  "projects": {}
+}')
+assert_json_has "f4" "$F4" ".global.defaultPriority" "undefined"
+assert_json_has "f4" "$F4" ".global.defaultIssueType" "undefined"
+
+echo ""
+echo "→ Fixture 5: keychainMapping values preserved"
+F5=$(run_fixture "f5-km-preserve" '{
+  "global": {
+    "gitIdentities": [],
+    "keychainMapping": {
+      "jira": "user_Jira_Access_Token",
+      "github": "user_Github_Access_Token"
+    }
+  },
+  "projects": {}
+}')
+# Parse and inspect specific keychain values
+JIRA_VAL=$(echo "$F5" | node -e "const j=JSON.parse(require('fs').readFileSync(0,'utf8')); console.log(j.global.keychainMapping.jira)")
+if [ "$JIRA_VAL" = "user_Jira_Access_Token" ]; then
+  pass "f5: existing keychainMapping.jira value preserved"
+else
+  fail "f5: keychainMapping.jira lost or changed: got '$JIRA_VAL'"
+fi
+
+echo ""
+echo "→ Fixture 6: v2.1.0 firebase_sa + firebase_project → firebase (consolidation)"
+F6=$(run_fixture "f6-firebase-consolidate" '{
+  "schemaVersion": "2.1.0",
+  "global": {
+    "identities": [{
+      "name": "corporate",
+      "email": "x@y.com",
+      "servicePatMap": {
+        "firebase_sa": "user_Firebase_Access_Json",
+        "firebase_project": "user_Firebase_Project_Id"
+      }
+    }],
+    "keychainMapping": {
+      "jira": null, "bitbucket_token": null, "bitbucket_user": null,
+      "github": null, "confluence": null, "figma_pat": "user_Figma_Access_Token",
+      "figma_user": "user_figma_email", "figma_mcp": null, "fortify": null,
+      "firebase_sa": "user_Firebase_Access_Json",
+      "firebase_project": "user_Firebase_Project_Id",
+      "jenkins": null
+    },
+    "platformIdentityRouting": {},
+    "recentProjects": [], "recentBranches": {}, "recentGroups": [],
+    "serviceStatus": {},
+    "settings": {
+      "branchTtlDays": 15, "pushRetryMax": 5, "buildRetryMax": 3,
+      "serviceStatusCacheSeconds": 300, "repoScanDays": 90,
+      "identityRoutingEnabled": false, "multiRepoEnabled": false,
+      "pushMustSucceed": true
+    }
+  },
+  "projects": {}
+}')
+# keychainMapping.firebase_sa must be gone, firebase_project must be gone, firebase must carry the old firebase_sa value
+FB_SA=$(echo "$F6" | node -e "const j=JSON.parse(require('fs').readFileSync(0,'utf8')); console.log(j.global.keychainMapping.firebase_sa === undefined ? 'absent' : 'present')")
+FB_PROJ=$(echo "$F6" | node -e "const j=JSON.parse(require('fs').readFileSync(0,'utf8')); console.log(j.global.keychainMapping.firebase_project === undefined ? 'absent' : 'present')")
+FB=$(echo "$F6" | node -e "const j=JSON.parse(require('fs').readFileSync(0,'utf8')); console.log(j.global.keychainMapping.firebase)")
+SPM_SA=$(echo "$F6" | node -e "const j=JSON.parse(require('fs').readFileSync(0,'utf8')); console.log(j.global.identities[0].servicePatMap.firebase_sa === undefined ? 'absent' : 'present')")
+SPM_PROJ=$(echo "$F6" | node -e "const j=JSON.parse(require('fs').readFileSync(0,'utf8')); console.log(j.global.identities[0].servicePatMap.firebase_project === undefined ? 'absent' : 'present')")
+SPM_FB=$(echo "$F6" | node -e "const j=JSON.parse(require('fs').readFileSync(0,'utf8')); console.log(j.global.identities[0].servicePatMap.firebase)")
+[ "$FB_SA" = "absent" ] && pass "f6: keychainMapping.firebase_sa removed" || fail "f6: keychainMapping.firebase_sa still present"
+[ "$FB_PROJ" = "absent" ] && pass "f6: keychainMapping.firebase_project removed" || fail "f6: keychainMapping.firebase_project still present"
+[ "$FB" = "user_Firebase_Access_Json" ] && pass "f6: keychainMapping.firebase carries old firebase_sa value" || fail "f6: keychainMapping.firebase wrong value: '$FB'"
+[ "$SPM_SA" = "absent" ] && pass "f6: servicePatMap.firebase_sa removed" || fail "f6: servicePatMap.firebase_sa still present"
+[ "$SPM_PROJ" = "absent" ] && pass "f6: servicePatMap.firebase_project removed" || fail "f6: servicePatMap.firebase_project still present"
+[ "$SPM_FB" = "user_Firebase_Access_Json" ] && pass "f6: servicePatMap.firebase carries old value" || fail "f6: servicePatMap.firebase wrong value: '$SPM_FB'"
+# figma consolidation: figma_pat → figma, figma_user removed
+FIG_PAT=$(echo "$F6" | node -e "const j=JSON.parse(require('fs').readFileSync(0,'utf8')); console.log(j.global.keychainMapping.figma_pat === undefined ? 'absent' : 'present')")
+FIG_USER=$(echo "$F6" | node -e "const j=JSON.parse(require('fs').readFileSync(0,'utf8')); console.log(j.global.keychainMapping.figma_user === undefined ? 'absent' : 'present')")
+FIG=$(echo "$F6" | node -e "const j=JSON.parse(require('fs').readFileSync(0,'utf8')); console.log(j.global.keychainMapping.figma)")
+[ "$FIG_PAT" = "absent" ] && pass "f6: keychainMapping.figma_pat removed" || fail "f6: keychainMapping.figma_pat still present"
+[ "$FIG_USER" = "absent" ] && pass "f6: keychainMapping.figma_user removed" || fail "f6: keychainMapping.figma_user still present"
+[ "$FIG" = "user_Figma_Access_Token" ] && pass "f6: keychainMapping.figma carries old figma_pat value" || fail "f6: keychainMapping.figma wrong value: '$FIG'"
+
+echo ""
+echo "══ pref-migration smoke: $PASS passed, $FAIL failed ══"
+[ "$FAIL" -eq 0 ]

package/pipeline/scripts/smoke-prefs-language.sh

@@ -0,0 +1,134 @@
+#!/usr/bin/env bash
+# smoke-prefs-language.sh — contract check for `/multi-agent language`.
+#
+# Does NOT touch the user's real $HOME/.claude/multi-agent-preferences.json.
+# Uses a throwaway tempfile + node shim that applies the documented write
+# rules (atomic rename, schema validation, enum check).
+#
+# Verifies:
+#   1. promptLanguage is part of the prefs schema and enum is {en, tr}.
+#   2. "en" and "tr" round-trip cleanly.
+#   3. Unknown values ("de", "xx") are rejected.
+#   4. Missing promptLanguage in prefs is valid (field is optional).
+#   5. Schema file is structurally valid.
+
+set -euo pipefail
+
+HERE="$(cd "$(dirname "$0")" && pwd)"
+ROOT="$(cd "$HERE/../.." && pwd)"
+SCHEMA="$ROOT/pipeline/schemas/prefs.schema.json"
+TMP="$(mktemp -d -t multi-agent-smoke-XXXX)"
+trap 'rm -rf "$TMP"' EXIT
+
+PASS=0
+FAIL=0
+pass() { PASS=$((PASS+1)); echo "  ✓ $1"; }
+fail() { FAIL=$((FAIL+1)); echo "  ✗ $1"; }
+
+need() { command -v "$1" >/dev/null 2>&1 || { echo "error: $1 is required" >&2; exit 127; }; }
+need node
+need jq
+
+[ -f "$SCHEMA" ] || { echo "error: schema not found at $SCHEMA" >&2; exit 1; }
+
+echo "→ schema declares promptLanguage with enum {en, tr}"
+ENUM_JSON=$(jq '.properties.global.properties.promptLanguage.enum' "$SCHEMA")
+if [ "$ENUM_JSON" = '[
+  "en",
+  "tr"
+]' ] || [ "$(echo "$ENUM_JSON" | jq -c '.')" = '["en","tr"]' ]; then
+  pass "promptLanguage.enum is exactly [en, tr]"
+else
+  fail "promptLanguage.enum unexpected: $ENUM_JSON"
+fi
+
+DEFAULT=$(jq -r '.properties.global.properties.promptLanguage.default' "$SCHEMA")
+if [ "$DEFAULT" = "en" ]; then
+  pass "default promptLanguage is 'en' (safe for open-source)"
+else
+  fail "default promptLanguage is '$DEFAULT' (expected 'en')"
+fi
+
+echo ""
+echo "→ prefs with promptLanguage=en round-trips"
+cat > "$TMP/prefs-en.json" <<'EOF'
+{
+  "schemaVersion": "2.0.0",
+  "global": {
+    "promptLanguage": "en"
+  },
+  "projects": {}
+}
+EOF
+node -e "
+  const s = JSON.parse(require('fs').readFileSync('$TMP/prefs-en.json','utf-8'));
+  if (s.global.promptLanguage !== 'en') process.exit(1);
+" && pass "en value parses" || fail "en value failed"
+
+echo ""
+echo "→ prefs with promptLanguage=tr round-trips"
+cat > "$TMP/prefs-tr.json" <<'EOF'
+{
+  "schemaVersion": "2.0.0",
+  "global": {
+    "promptLanguage": "tr"
+  },
+  "projects": {}
+}
+EOF
+node -e "
+  const s = JSON.parse(require('fs').readFileSync('$TMP/prefs-tr.json','utf-8'));
+  if (s.global.promptLanguage !== 'tr') process.exit(1);
+" && pass "tr value parses" || fail "tr value failed"
+
+echo ""
+echo "→ unknown language 'de' is not in enum"
+if ! echo "$ENUM_JSON" | jq -e '. | index("de")' >/dev/null 2>&1; then
+  pass "'de' correctly absent from enum"
+else
+  fail "'de' should not be in enum yet"
+fi
+
+echo ""
+echo "→ prefs without promptLanguage is valid (optional field)"
+cat > "$TMP/prefs-missing.json" <<'EOF'
+{
+  "schemaVersion": "2.0.0",
+  "global": {},
+  "projects": {}
+}
+EOF
+node -e "
+  const s = JSON.parse(require('fs').readFileSync('$TMP/prefs-missing.json','utf-8'));
+  if ('promptLanguage' in s.global) process.exit(1);
+" && pass "missing promptLanguage is tolerated" || fail "missing field check failed"
+
+echo ""
+echo "→ 5. triageCrossCheck schema is well-formed"
+TCC_DEFAULT=$(jq -r '.properties.global.properties.triageCrossCheck.properties.enabled.default' "$SCHEMA")
+[ "$TCC_DEFAULT" = "false" ] && pass "triageCrossCheck.enabled defaults to false (opt-in)" || fail "expected false, got $TCC_DEFAULT"
+TCC_PCT_DEFAULT=$(jq -r '.properties.global.properties.triageCrossCheck.properties.samplePct.default' "$SCHEMA")
+[ "$TCC_PCT_DEFAULT" = "10" ] && pass "samplePct defaults to 10" || fail "expected 10, got $TCC_PCT_DEFAULT"
+TCC_MODEL_ENUM=$(jq -c '.properties.global.properties.triageCrossCheck.properties.model.enum' "$SCHEMA")
+[ "$TCC_MODEL_ENUM" = '["sonnet"]' ] && pass "model enum locked to [sonnet]" || fail "expected [sonnet], got $TCC_MODEL_ENUM"
+TCC_PCT_MIN=$(jq -r '.properties.global.properties.triageCrossCheck.properties.samplePct.minimum' "$SCHEMA")
+TCC_PCT_MAX=$(jq -r '.properties.global.properties.triageCrossCheck.properties.samplePct.maximum' "$SCHEMA")
+[ "$TCC_PCT_MIN" = "1" ] && [ "$TCC_PCT_MAX" = "100" ] && pass "samplePct bounded [1,100]" || fail "samplePct bounds wrong"
+
+echo ""
+echo "→ setup.md documents Step 0 — Language Selection"
+SETUP_DOC="$ROOT/pipeline/commands/multi-agent/setup.md"
+if [ -f "$SETUP_DOC" ] && grep -q "^### Step 0 — Language Selection" "$SETUP_DOC"; then
+  pass "setup.md has Step 0 — Language Selection"
+else
+  fail "setup.md missing Step 0 — Language Selection heading"
+fi
+if [ -f "$SETUP_DOC" ] && grep -q "promptLanguage" "$SETUP_DOC"; then
+  pass "setup.md references promptLanguage"
+else
+  fail "setup.md never mentions promptLanguage"
+fi
+
+echo ""
+echo "══ prefs-language smoke: $PASS passed, $FAIL failed ══"
+[ "$FAIL" -eq 0 ]

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

@@ -0,0 +1,118 @@
+#!/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/commands/multi-agent/refs/progress-contract.md"
+PREFS="$ROOT/pipeline/schemas/prefs.schema.json"
+PHASE_DIR="$ROOT/pipeline/commands/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 "══ progress-contract smoke: $PASS passed, $WARN warnings, $FAIL failed ══"
+[ "$FAIL" -eq 0 ]

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

@@ -0,0 +1,75 @@
+#!/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/commands/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 ]