@mmerterden/multi-agent-pipeline 8.6.1 → 10.0.6

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

@@ -1,11 +1,11 @@
 #!/usr/bin/env bash
-# smoke-tracker-contract.sh — v7.9.1
+# smoke-tracker-contract.sh  -  v7.9.1
 #
 # Validates that every mode dispatch file (dev.md, dev-local.md, autopilot.md,
 # etc.) carries the mandatory phase-tracker.sh invocation contract.
 #
 # Without this, agent prompts can fall through to TaskCreate/TaskList UI which
-# does NOT track elapsed time or token counts — users see only static
+# does NOT track elapsed time or token counts  -  users see only static
 # checkboxes with no progress info. The 2026-04-27 regression that prompted
 # this smoke: 8 mode dispatch files shipped through v7.6 → v7.9 with zero
 # tracker references; agent went straight to Claude Code's plan UI.
@@ -17,7 +17,7 @@
 #   3. The shared contract file exists and documents the invocation pattern
 #
 # What this does NOT enforce:
-#   - Runtime — that the agent actually invokes the tracker. That's a contract
+#   - Runtime  -  that the agent actually invokes the tracker. That's a contract
 #     test the orchestrator carries; this smoke catches the prompt-side gap.
 
 set -uo pipefail
@@ -40,7 +40,7 @@ MODE_FILES=(
 )
 
 # Minimum tracker references per file (init + at least one of the verbs).
-# Set conservatively — the section template emits 6 references; bump if
+# Set conservatively  -  the section template emits 6 references; bump if
 # template is shortened in future.
 MIN_REFS=4
 
@@ -54,7 +54,7 @@ echo "→ 1. Tracker contract reference file exists"
 if [ -f "$CONTRACT_FILE" ]; then
   pass "refs/tracker-contract.md present"
 else
-  fail "refs/tracker-contract.md missing — mode files have nowhere to link to"
+  fail "refs/tracker-contract.md missing  -  mode files have nowhere to link to"
 fi
 
 # ──────────────────────────────────────────────────────────────────────────
@@ -98,7 +98,7 @@ for mode_file in "${MODE_FILES[@]}"; do
 done
 
 # ──────────────────────────────────────────────────────────────────────────
-echo "→ 5. Anti-pattern guard — mode files warn against TaskCreate fallback"
+echo "→ 5. Anti-pattern guard  -  mode files warn against TaskCreate fallback"
 for mode_file in "${MODE_FILES[@]}"; do
   full="$CMDS_DIR/$mode_file"
   [ -f "$full" ] || continue

package/pipeline/scripts/smoke-tracker-tokens-invocation.sh

@@ -6,7 +6,7 @@
 # at least once, so the per-phase + cumulative token counter in the tracker's
 # render output stays accurate for every run. Without this gate, phase docs
 # tend to drop the token call as they get edited and the user loses cost
-# visibility — exactly Defect 5 from the GH1241 review.
+# visibility  -  exactly Defect 5 from the GH1241 review.
 #
 # Phase 3 (Dev) and Phase 4 (Review) are the LLM-intensive ones. Phase 1+2
 # also do LLM work. Phase 0/5/6/7 are mostly orchestration.
@@ -55,6 +55,14 @@ elif ! grep -qE "phase-tracker\.sh tokens .*<in>.*<out>|phase-tracker\.sh tokens
   FAIL=$((FAIL + 1))
 fi
 
+# v9.10.2: the contract must also mandate the per-phase completion narration
+# line - the TaskList widget shows duration only, so without the chat line the
+# user never sees live per-phase tokens.
+if ! grep -q "per-phase token narration on completion" "$CONTRACT"; then
+  echo "FAIL [smoke-tracker-tokens-invocation]: $CONTRACT must mandate the per-phase token narration line on completion"
+  FAIL=$((FAIL + 1))
+fi
+
 if [ "$FAIL" -gt 0 ]; then
   echo ""
   echo "smoke-tracker-tokens-invocation: $FAIL violation(s)."

package/pipeline/scripts/smoke-triage-memory.sh

@@ -1,10 +1,10 @@
 #!/usr/bin/env bash
-# smoke-triage-memory.sh — v8.3.0
+# smoke-triage-memory.sh  -  v8.3.0
 #
 # Verifies the triage-memory persistence layer:
 #   1. ingest writes JSONL rows for accepted/deferred/rejected and tags
 #      task_id, classification, severity, file, issue, reason
-#   2. ingest is idempotent — re-running with the same input writes 0 rows
+#   2. ingest is idempotent  -  re-running with the same input writes 0 rows
 #   3. stats reports correct row counts grouped by classification
 #   4. query ranks rows by token overlap, returns top-N hits
 #   5. query --file-glob filters by path

package/pipeline/scripts/smoke-url-enrichment.sh

@@ -1,5 +1,5 @@
 #!/usr/bin/env bash
-# Smoke: Phase 0 Step 1b URL enrichment — Crashlytics + Fortify
+# Smoke: Phase 0 Step 1b URL enrichment  -  Crashlytics + Fortify
 #   Verifies that:
 #     1. phase-0-init.md documents Step 1b with both URL patterns
 #     2. state.crashContext and state.fortifyFinding shapes are specified
@@ -28,7 +28,7 @@ SETUP="$ROOT/pipeline/commands/multi-agent/setup.md"
 SCHEMA="$ROOT/pipeline/schemas/prefs.schema.json"
 
 echo "→ 1. phase-0-init.md documents Step 1b URL Enrichment"
-check "Step 1b section present"                  "grep -Fq 'Step 1b — URL Enrichment' '$PHASE0'"
+check "Step 1b section present"                  "grep -Fq 'Step 1b  -  URL Enrichment' '$PHASE0'"
 check "Crashlytics pattern block present"        "grep -Fq 'console.firebase.google.com' '$PHASE0'"
 check "Fortify pattern block present"            "grep -Eq 'hosts\.fortify.*ssc/html|ssc/html.*version' '$PHASE0'"
 

package/pipeline/scripts/smoke-validator-contradiction.sh

@@ -1,5 +1,5 @@
 #!/usr/bin/env bash
-# smoke-validator-contradiction.sh — verify bidirectional approved↔blocking auto-correction.
+# smoke-validator-contradiction.sh  -  verify bidirectional approved↔blocking auto-correction.
 # Tests both directions of the triage validator's contradiction detection.
 
 set -uo pipefail

package/pipeline/scripts/smoke-validator-gates.sh

@@ -0,0 +1,164 @@
+#!/usr/bin/env bash
+# smoke-validator-gates.sh  -  v9.11.0
+#
+# Validates that the orchestrator phase docs wire the structured-output
+# validators (validate-analysis / validate-planning / validate-reviewer /
+# validate-triage) as deterministic gates, not just npm-test fixtures.
+#
+# Without this, a malformed analysis spec, plan, reviewer verdict, or triage
+# verdict flows downstream unchecked  -  the validators existed but only ran
+# in `npm test`, never in the live pipeline.
+#
+# What this enforces:
+#   1. Each validator accepts a FILE argument (the gate invocation form) and
+#      exits 0 on a valid artifact / 1 on a malformed one.
+#   2. phase-1-analysis.md gates the analysis object via validate-analysis.mjs.
+#   3. phase-2-planning.md gates the plan object via validate-planning.mjs.
+#   4. phase-4-review.md gates reviewer outputs via validate-reviewer.mjs AND
+#      the triage verdict via validate-triage.mjs.
+#   5. Every gate block documents the failure protocol: emit stderr, ONE
+#      self-correction rework, re-run, then HALT with a recovery hint.
+#
+# What this does NOT enforce:
+#   - Runtime  -  that the agent actually invokes the gate. This smoke catches
+#     the prompt-side gap, same as smoke-tracker-contract.sh.
+
+set -euo pipefail
+
+REPO_ROOT="$(cd "$(dirname "$0")/../.." && pwd)"
+SCRIPTS_DIR="$REPO_ROOT/pipeline/scripts"
+PHASES_DIR="$REPO_ROOT/pipeline/commands/multi-agent/refs/phases"
+
+PASS=0
+FAIL=0
+pass() { PASS=$((PASS + 1)); echo "  ✓ $1"; }
+fail() { FAIL=$((FAIL + 1)); echo "  ✗ $1"; }
+
+command -v node >/dev/null 2>&1 || { echo "error: node required" >&2; exit 127; }
+
+TMP="$(mktemp -d)"
+trap 'rm -rf "$TMP"' EXIT
+
+# ──────────────────────────────────────────────────────────────────────────
+echo "→ 1. Validators exist and accept a file argument (gate invocation form)"
+
+printf '%s' '{"stack":{"primary":"ios"},"touchedAreas":[{"path":"Sources/App/Login.swift","why":"target of the change"}],"risks":[],"summary":"Valid analysis fixture used by the validator-gates smoke."}' > "$TMP/analysis.json"
+printf '%s' '{"approved":true,"tasks":[{"id":"T1","title":"Add validator gate","type":"code","files":["Sources/App/Login.swift"]}]}' > "$TMP/plan.json"
+printf '%s' '{"findings":[],"approved":true}' > "$TMP/reviewer.json"
+printf '%s' '{"accepted":[],"deferred":[],"rejected":[],"approved":true}' > "$TMP/triage.json"
+
+declare -a CHECKS=(
+  "validate-analysis.mjs|$TMP/analysis.json"
+  "validate-planning.mjs|$TMP/plan.json"
+  "validate-reviewer.mjs|$TMP/reviewer.json"
+  "validate-triage.mjs|$TMP/triage.json"
+)
+for entry in "${CHECKS[@]}"; do
+  validator="${entry%%|*}"
+  fixture="${entry##*|}"
+  if [ ! -f "$SCRIPTS_DIR/$validator" ]; then
+    fail "$validator missing under pipeline/scripts/"
+    continue
+  fi
+  if node "$SCRIPTS_DIR/$validator" "$fixture" >/dev/null 2>&1; then
+    pass "$validator accepts a file argument (exit 0 on valid fixture)"
+  else
+    fail "$validator rejected a valid fixture via file argument"
+  fi
+done
+
+rc=0
+printf '%s' '{}' > "$TMP/malformed.json"
+node "$SCRIPTS_DIR/validate-analysis.mjs" "$TMP/malformed.json" >/dev/null 2>&1 || rc=$?
+if [ "$rc" -eq 1 ]; then
+  pass "validate-analysis.mjs fails CLOSED on a malformed file (exit 1)"
+else
+  fail "validate-analysis.mjs malformed-file exit wrong (got $rc, expected 1)"
+fi
+
+# ──────────────────────────────────────────────────────────────────────────
+echo "→ 2. Phase docs carry the file-based gate invocation marker"
+
+declare -a GATES=(
+  "phase-1-analysis.md|validate-analysis.mjs \"\$ANALYSIS_FILE\""
+  "phase-2-planning.md|validate-planning.mjs \"\$PLAN_FILE\""
+  "phase-4-review.md|validate-reviewer.mjs \"\$REVIEWER_FILE\""
+  "phase-4-review.md|validate-triage.mjs \"\$TRIAGE_FILE\""
+)
+for entry in "${GATES[@]}"; do
+  doc="${entry%%|*}"
+  marker="${entry##*|}"
+  if [ ! -f "$PHASES_DIR/$doc" ]; then
+    fail "$doc missing"
+    continue
+  fi
+  if grep -qF "$marker" "$PHASES_DIR/$doc"; then
+    pass "$doc invokes $marker"
+  else
+    fail "$doc missing gate invocation marker: $marker"
+  fi
+done
+
+# ──────────────────────────────────────────────────────────────────────────
+echo "→ 3. Gate invocations use the installed-scripts path (\$HOME/.claude/scripts)"
+
+declare -a INSTALLED=(
+  "phase-1-analysis.md|validate-analysis.mjs"
+  "phase-2-planning.md|validate-planning.mjs"
+  "phase-4-review.md|validate-reviewer.mjs"
+  "phase-4-review.md|validate-triage.mjs"
+)
+for entry in "${INSTALLED[@]}"; do
+  doc="${entry%%|*}"
+  validator="${entry##*|}"
+  if grep -qF "\$HOME/.claude/scripts/$validator" "$PHASES_DIR/$doc" 2>/dev/null; then
+    pass "$doc invokes \$HOME/.claude/scripts/$validator"
+  else
+    fail "$doc missing \$HOME/.claude/scripts/$validator invocation"
+  fi
+done
+
+# ──────────────────────────────────────────────────────────────────────────
+echo "→ 4. Every gate block documents the failure protocol (rework once, then halt)"
+
+declare -a PROTOCOL_DOCS=(
+  "phase-1-analysis.md"
+  "phase-2-planning.md"
+  "phase-4-review.md"
+)
+for doc in "${PROTOCOL_DOCS[@]}"; do
+  full="$PHASES_DIR/$doc"
+  [ -f "$full" ] || { fail "$doc missing"; continue; }
+  if grep -qi "ONE self-correction rework" "$full"; then
+    pass "$doc documents the single self-correction rework"
+  else
+    fail "$doc missing the self-correction rework step"
+  fi
+  if grep -q "HALT the phase" "$full"; then
+    pass "$doc halts the phase on second validator failure"
+  else
+    fail "$doc missing the halt-on-second-failure rule"
+  fi
+done
+
+# Recovery hints name the validator and the schema to inspect.
+declare -a HINTS=(
+  "phase-1-analysis.md|failed validate-analysis.mjs twice"
+  "phase-2-planning.md|failed validate-planning.mjs twice"
+  "phase-4-review.md|failed validate-reviewer.mjs twice"
+  "phase-4-review.md|failed validate-triage.mjs twice"
+)
+for entry in "${HINTS[@]}"; do
+  doc="${entry%%|*}"
+  hint="${entry##*|}"
+  if grep -qF "$hint" "$PHASES_DIR/$doc" 2>/dev/null; then
+    pass "$doc carries recovery hint: $hint"
+  else
+    fail "$doc missing recovery hint: $hint"
+  fi
+done
+
+# ──────────────────────────────────────────────────────────────────────────
+echo ""
+echo "══ validator-gates smoke: $PASS passed, $FAIL failed ══"
+[ "$FAIL" -eq 0 ]

package/pipeline/scripts/smoke-vercel-deploy-redact.sh

@@ -1,12 +1,12 @@
 #!/usr/bin/env bash
 #
-# smoke-vercel-deploy-redact.sh — verify pipeline/lib/vercel-deploy.sh
+# smoke-vercel-deploy-redact.sh  -  verify pipeline/lib/vercel-deploy.sh
 # scrubs every known token-leak shape from CLI output.
 #
 # Background: v7.9.1 production deploy failed with the Vercel CLI
-# printing `vercel deploy --token=vcp_…` in the retry hint. The token leaked
+# printing `vercel deploy --token=vcp_...` in the retry hint. The token leaked
 # into the conversation transcript and required rotation. v8.0.0 added
-# vercel-deploy.sh as the safe wrapper. This smoke is the regression gate —
+# vercel-deploy.sh as the safe wrapper. This smoke is the regression gate  - 
 # any future change to the redact filter must keep these patterns covered.
 #
 # Patterns under test:
@@ -38,24 +38,24 @@ assert_redacts() {
   local out
   out=$(printf '%s' "$input" | bash "$WRAPPER" redact)
   if echo "$out" | grep -qE "$must_not_contain"; then
-    fail "$label — leak survived: $(echo "$out" | grep -oE "$must_not_contain" | head -1)"
+    fail "$label  -  leak survived: $(echo "$out" | grep -oE "$must_not_contain" | head -1)"
   else
     pass "$label"
   fi
 }
 
-# --- Pattern 1: --token=vcp_… (original v7.9.1 leak) ---
-assert_redacts "--token=vcp_… argv form scrubbed" \
+# --- Pattern 1: --token=vcp_... (original v7.9.1 leak) ---
+assert_redacts "--token=vcp_... argv form scrubbed" \
   'Run `vercel deploy --token=vcp_AbCdEf123456789abcdef --prod` to retry' \
   'vcp_AbCdEf123456789abcdef'
 
-# --- Pattern 2: --token <space> vcp_… ---
+# --- Pattern 2: --token <space> vcp_... ---
 assert_redacts "--token <space> argv form scrubbed" \
   'next.command: vercel deploy --token vcp_QwertyUiopASDFghj1234' \
   'vcp_QwertyUiopASDFghj1234'
 
-# --- Pattern 3: bare vcp_… token mention ---
-assert_redacts "bare vcp_… token mention scrubbed" \
+# --- Pattern 3: bare vcp_... token mention ---
+assert_redacts "bare vcp_... token mention scrubbed" \
   'Authentication failed for token vcp_BareLeak987654321xyz on retry.' \
   'vcp_BareLeak987654321xyz'
 
@@ -82,7 +82,7 @@ assert_redacts "multi-line CLI failure dump scrubbed" \
 
 # --- Negative: non-token text passes through unchanged ---
 echo ""
-echo "→ Negative cases — non-token text MUST pass through verbatim"
+echo "→ Negative cases  -  non-token text MUST pass through verbatim"
 sample='Deployment URL: https://example.vercel.app/page (200 OK)'
 roundtrip=$(printf '%s' "$sample" | bash "$WRAPPER" redact)
 if [ "$roundtrip" = "$sample" ]; then
@@ -93,7 +93,7 @@ fi
 
 # --- Wrapper guard: refuses --token argv ---
 echo ""
-echo "→ Wrapper guard — refuses to deploy with --token argv"
+echo "→ Wrapper guard  -  refuses to deploy with --token argv"
 guard_out=$(VERCEL_TOKEN=vcp_GuardCheck111 bash "$WRAPPER" deploy --token=vcp_BadArg 2>&1 || true)
 if echo "$guard_out" | grep -q "refused to deploy with --token argv"; then
   pass "wrapper rejects --token argv with explicit error"

package/pipeline/scripts/smoke-wiki-integration.sh

@@ -1,5 +1,5 @@
 #!/usr/bin/env bash
-# smoke-wiki-integration.sh — v5.7+ wiki channel adapter contract.
+# smoke-wiki-integration.sh  -  v5.7+ wiki channel adapter contract.
 #
 # Verifies:
 #   1. prefs.schema.json declares global.wikiScope (array of enum) + reportChannels.wiki (boolean).
@@ -37,7 +37,7 @@ for f in "$PREFS" "$FIGMA_SCHEMA" "$CHANNELS" "$WIKI_REF" "$PHASE7" "$MODES" "$W
   [ -f "$f" ] || { echo "error: missing $f" >&2; exit 1; }
 done
 
-# Combined surface — channels.md + wiki-capture.md + phase-7-report.md + modes.md. Any may carry assertion.
+# Combined surface  -  channels.md + wiki-capture.md + phase-7-report.md + modes.md. Any may carry assertion.
 WIKI_SURFACE="$(mktemp)"
 trap 'rm -f "$WIKI_SURFACE"' EXIT
 cat "$CHANNELS" "$WIKI_REF" "$PHASE7" "$MODES" > "$WIKI_SURFACE"

package/pipeline/scripts/smoke-work-summary.sh

@@ -1,5 +1,5 @@
 #!/usr/bin/env bash
-# smoke-work-summary.sh — v7.1.0
+# smoke-work-summary.sh  -  v7.1.0
 #
 # Verifies the Phase 7 Work Summary renderer contract:
 #   1. Missing state + no flags → exit 2 (caller should skip section)
@@ -39,7 +39,7 @@ else
 fi
 popd >/dev/null; rm -rf "$tmp"
 
-# --- 2–5: full fixture ---
+# --- 2-5: full fixture ---
 tmp=$(mktemp -d); pushd "$tmp" >/dev/null
 mkdir -p .worktrees/PROJ-2001
 cat > .worktrees/PROJ-2001/agent-state.json <<'JSON'
@@ -81,7 +81,7 @@ else
   record_fail "done tasks not marked ✅ (output: $(echo "$out" | head -20))"
 fi
 
-# deferred is not "done" — should get ⏳
+# deferred is not "done"  -  should get ⏳
 if grep -qE '⏳ T3' <<< "$out"; then
   record_pass "scope marks non-done tasks with ⏳"
 else

package/pipeline/scripts/smoke-worktree-path-convention.sh

@@ -11,7 +11,7 @@
 # This is a static-analysis lint, not a runtime probe. It greps the pipeline
 # source for forbidden worktree paths in shell scripts, markdown contracts,
 # and orchestrator command files. A behavioural check (live `git worktree list`)
-# is out of scope — that would require a real run.
+# is out of scope  -  that would require a real run.
 
 set -euo pipefail
 
@@ -25,8 +25,8 @@ FAIL=0
 # Forbidden patterns: any worktree path that lives under $HOME directly,
 # or uses repo-name--taskId style outside a project root.
 declare -a FORBIDDEN=(
-  '\$HOME/\.worktrees'                      # $HOME/.worktrees/foo — wrong (must be under projectRoot)
-  '~/\.worktrees'                            # ~/.worktrees/foo — same
+  '\$HOME/\.worktrees'                      # $HOME/.worktrees/foo  -  wrong (must be under projectRoot)
+  '~/\.worktrees'                            # ~/.worktrees/foo  -  same
   '\$HOME/[a-zA-Z0-9_-]+--[a-zA-Z0-9_-]+'   # $HOME/repo--taskid pattern
   '~/[a-zA-Z0-9_-]+--[a-zA-Z0-9_-]+'        # ~/repo--taskid pattern
   'git worktree add.*\$HOME/[^.]'           # `git worktree add $HOME/something`
@@ -45,7 +45,7 @@ TARGETS=(
   "skills/shared/core/multi-agent/SKILL.md"
 )
 
-# Allowlist file paths — reference docs that mention the wrong pattern only
+# Allowlist file paths  -  reference docs that mention the wrong pattern only
 # to teach the rule are tagged with `# allow: worktree-bad-example` annotation
 # on the offending line.
 for pattern in "${FORBIDDEN[@]}"; do

package/pipeline/scripts/smoke-write-state.sh

@@ -1,5 +1,5 @@
 #!/usr/bin/env bash
-# smoke-write-state.sh — verify write-state.mjs atomic write + merge + lock behavior.
+# smoke-write-state.sh  -  verify write-state.mjs atomic write + merge + lock behavior.
 
 set -uo pipefail
 
@@ -78,7 +78,7 @@ else
   fail "missing path did not exit 3"
 fi
 
-# 8. Atomic — no .tmp leftover after success
+# 8. Atomic  -  no .tmp leftover after success
 if ls "$TMPDIR"/.state.json.*.tmp 2>/dev/null | head -1 | grep -q .; then
   fail "leftover .tmp file after success"
 else

package/pipeline/scripts/stack-swap.sh

@@ -1,5 +1,5 @@
 #!/bin/bash
-# stack-swap.sh — Auto-detect project stack and swap skills
+# stack-swap.sh  -  Auto-detect project stack and swap skills
 # Called by SessionStart hook
 # Default: iOS. Swaps Android/backend in only when detected.
 
@@ -105,11 +105,11 @@ fi
 # Auto-detect mode (SessionStart hook)
 CWD=$(pwd)
 
-# If cwd is $HOME, skip detection — keep default (iOS)
+# If cwd is $HOME, skip detection  -  keep default (iOS)
 if [ "$CWD" = "$HOME" ]; then
   activate_stack "$IOS_PATTERNS"
   ACTIVE=$(ls "$SKILLS" 2>/dev/null | wc -l | tr -d ' ')
-  echo "{\"systemMessage\": \"Stack: iOS — default ($ACTIVE skills active)\"}"
+  echo "{\"systemMessage\": \"Stack: iOS  -  default ($ACTIVE skills active)\"}"
   exit 0
 fi
 

package/pipeline/scripts/sync-adapters.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 /**
- * sync-adapters.mjs — wire the orphaned per-project adapter installers
- * (cursor / copilot-chat / future windsurf / cline) into the sync flow.
+ * sync-adapters.mjs  -  wire the orphaned per-project adapter installers
+ * (cursor / copilot-chat) into the sync flow.
  *
  * Three call shapes:
  *
@@ -11,7 +11,7 @@
  *   2. All projects registered in prefs.global.projectsTouched[]:
  *      node sync-adapters.mjs --all
  *
- *   3. Doctor — show what would happen, no writes:
+ *   3. Doctor  -  show what would happen, no writes:
  *      node sync-adapters.mjs --doctor
  *
  * Discovery contract:
@@ -19,8 +19,8 @@
  *   - --all reads prefs.global.projectsTouched[] (LRU). Skips entries
  *     whose path no longer exists.
  *   - For each target, the script inspects the per-project marker files
- *     (.cursor/, .cursorrules, .copilot/, .windsurfrules, .clinerules)
- *     and only runs the matching adapter if the marker is present —
+ *     (.cursor/, .cursorrules, .copilot/, .github/copilot-instructions.md)
+ *     and only runs the matching adapter if the marker is present  -
  *     a project that never set up Cursor won't get .cursor/rules/ filled
  *     in by sync. This mirrors Step 2b's "setup-then-sync" contract.
  *
@@ -59,7 +59,7 @@ for (const a of argv) {
 }
 
 if (!args.target && !args.all && !args.doctor) {
-  // Default to current dir — most common case (sync running from the
+  // Default to current dir  -  most common case (sync running from the
   // pipeline repo itself).
   args.target = ".";
 }
@@ -67,7 +67,9 @@ if (!args.target && !args.all && !args.doctor) {
 // --- helpers ---------------------------------------------------------------
 
 function loadPrefs() {
-  const p = join(process.env.HOME, ".claude", "multi-agent-preferences.json");
+  const home = process.env.HOME || process.env.USERPROFILE;
+  if (!home) return { global: { projectsTouched: [] } };
+  const p = join(home, ".claude", "multi-agent-preferences.json");
   if (!existsSync(p)) return { global: { projectsTouched: [] } };
   try {
     return JSON.parse(readFileSync(p, "utf-8"));
@@ -80,6 +82,7 @@ function detectAdapters(target) {
   const out = [];
   if (existsSync(join(target, ".cursor")) || existsSync(join(target, ".cursorrules"))) out.push("cursor");
   if (existsSync(join(target, ".copilot")) || existsSync(join(target, ".github/copilot-instructions.md"))) out.push("copilot-chat");
+  if (existsSync(join(target, ".agent")) || existsSync(join(target, "AGENTS.md"))) out.push("antigravity");
   return out;
 }
 
@@ -109,10 +112,10 @@ async function syncTarget(target) {
   // the maintainer is the canonical cursor consumer.
   const isPipelineRepo =
     existsSync(join(absTarget, "pipeline")) && existsSync(join(absTarget, ".git"));
-  let adapters = detectAdapters(absTarget);
+  const adapters = detectAdapters(absTarget);
   if (isPipelineRepo && !adapters.includes("cursor")) adapters.push("cursor");
   if (adapters.length === 0) {
-    console.log(`  [skip] ${absTarget} — no adapter markers (.cursor/.cursorrules/.copilot)`);
+    console.log(`  [skip] ${absTarget}  -  no adapter markers (.cursor/.cursorrules/.copilot)`);
     return true;
   }
   console.log(`→ ${absTarget}`);
@@ -140,7 +143,7 @@ if (args.all || args.doctor) {
   }
   if (targets.length === 0) {
     console.log(
-      "sync-adapters: prefs.global.projectsTouched is empty — run multi-agent:setup in a project first",
+      "sync-adapters: prefs.global.projectsTouched is empty  -  run multi-agent:setup in a project first",
     );
   }
 }
@@ -152,5 +155,29 @@ for (const t of targets) {
   if (await syncTarget(t)) ok++;
   else failed++;
 }
+
+// Codex CLI is a GLOBAL-config tool (prompts + MCP under ~/.codex, no per-project
+// prompt dir), so it is synced once - not per target. Run it when Codex is
+// present on this machine.
+const codexHome = (() => {
+  const home = process.env.HOME || process.env.USERPROFILE;
+  return home ? join(home, ".codex") : null;
+})();
+if (codexHome && existsSync(codexHome)) {
+  if (args.doctor) {
+    console.log("→ ~/.codex (global)\n  [doctor] would run codex adapter (global)");
+  } else {
+    console.log("→ ~/.codex (global)");
+    try {
+      const mod = await import(join(PIPELINE_ROOT, "adapters", "codex.mjs"));
+      mod.install({ pipelineSrc: PIPELINE_ROOT, platformFilter: args.platform });
+      ok++;
+    } catch (e) {
+      console.error(`  [error] codex: ${e.message}`);
+      failed++;
+    }
+  }
+}
+
 console.log(`sync-adapters: ${ok} ok · ${failed} failed`);
 process.exit(failed > 0 ? 1 : 0);

package/pipeline/scripts/sync-parity-check.sh

@@ -1,5 +1,5 @@
 #!/usr/bin/env bash
-# sync-parity-check.sh — detect drift between two pipeline mirror trees.
+# sync-parity-check.sh  -  detect drift between two pipeline mirror trees.
 #
 # Use case: after editing the pipeline locally (e.g. ~/.claude/commands/multi-agent/),
 # verify that the open-source repo (~/multi-agent-pipeline/pipeline/) and the
@@ -9,7 +9,7 @@
 # Why this exists:
 #   The sync-instructions skill is the official "copy from A to B" tool, but
 #   nothing currently catches drift if the user forgets to run it. This script
-#   is the watchdog — run it before committing or as part of a pre-push hook.
+#   is the watchdog  -  run it before committing or as part of a pre-push hook.
 #
 # Usage:
 #   sync-parity-check.sh <left-dir> <right-dir> [--ignore <regex>]...
@@ -28,9 +28,9 @@
 #     --ignore '/help\.md$'
 #
 # Exit codes:
-#   0 — perfect parity (or only ignored files differ)
-#   1 — drift detected (lists differing + missing-from-each-side)
-#   2 — usage error
+#   0  -  perfect parity (or only ignored files differ)
+#   1  -  drift detected (lists differing + missing-from-each-side)
+#   2  -  usage error
 
 set -uo pipefail
 
@@ -103,7 +103,7 @@ while IFS= read -r f; do
   DRIFT=1
 done <<< "$ONLY_RIGHT"
 
-# Files present on both sides — content compare.
+# Files present on both sides  -  content compare.
 while IFS= read -r f; do
   [ -z "$f" ] && continue
   rel="${f#./}"