@mmerterden/multi-agent-pipeline 12.6.0 → 12.8.0

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

@@ -1,73 +0,0 @@
-#!/usr/bin/env bash
-#
-# smoke-tracker-tokens-invocation.sh
-#
-# Asserts every LLM-heavy phase doc invokes `phase-tracker.sh tokens <N> <in> <out>`
-# 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.
-#
-# 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.
-
-set -euo pipefail
-
-SELF_DIR=$(cd "$(dirname "$0")" && pwd)
-PIPELINE_ROOT=$(cd "$SELF_DIR/.." && pwd)
-
-cd "$PIPELINE_ROOT"
-
-FAIL=0
-
-# Every phase doc that runs LLM calls MUST mention `phase-tracker.sh tokens`
-# at least once (either in a code fence or inline).
-declare -a LLM_PHASES=(
-  "multi-agent-refs/phases/phase-1-analysis.md:1"
-  "multi-agent-refs/phases/phase-2-planning.md:2"
-  "multi-agent-refs/phases/phase-3-dev.md:3"
-  "multi-agent-refs/phases/phase-4-review.md:4"
-)
-
-for entry in "${LLM_PHASES[@]}"; do
-  doc="${entry%:*}"
-  phase_id="${entry##*:}"
-  full="$doc"
-  if [ ! -f "$full" ]; then
-    echo "FAIL [smoke-tracker-tokens-invocation]: $doc missing"
-    FAIL=$((FAIL + 1))
-    continue
-  fi
-  if ! grep -qE "phase-tracker\.sh tokens" "$full"; then
-    echo "FAIL [smoke-tracker-tokens-invocation]: $doc must invoke 'phase-tracker.sh tokens $phase_id <in> <out>' after every LLM call"
-    FAIL=$((FAIL + 1))
-  fi
-done
-
-# tracker-contract.md is the canonical location for the tokens API. Make sure
-# it documents the invocation pattern with both args.
-CONTRACT="multi-agent-refs/tracker-contract.md"
-if [ ! -f "$CONTRACT" ]; then
-  echo "FAIL [smoke-tracker-tokens-invocation]: $CONTRACT missing"
-  FAIL=$((FAIL + 1))
-elif ! grep -qE "phase-tracker\.sh tokens .*<in>.*<out>|phase-tracker\.sh tokens .*<input.*<output" "$CONTRACT"; then
-  echo "FAIL [smoke-tracker-tokens-invocation]: $CONTRACT must document the tokens <N> <in> <out> signature"
-  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)."
-  echo "Defect 5: phase docs must invoke 'phase-tracker.sh tokens <N> <in> <out>' after every LLM call so the tracker render shows live cost."
-  exit 1
-fi
-
-echo "smoke-tracker-tokens-invocation: ok"

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

@@ -1,174 +0,0 @@
-#!/usr/bin/env bash
-# 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
-#   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
-#   6. path subcommand resolves to <slug>/triage-corpus.jsonl under HOME
-#   7. empty corpus query returns total=0 + exit 2
-#   8. validate-schemas accepts triage-corpus.schema.json
-#   9. phase-7-report.md ref doc declares the ingest call
-#  10. phase-4-review.md ref doc declares prior-art lookup
-#  11. prefs.schema.json exposes priorArtEnrichment toggle
-#
-# Uses HOME override so we never touch the user's real ~/.claude/memory.
-#
-# Exit 0 = all pass, 1 = any failure.
-
-set -uo pipefail
-
-ROOT="$(cd "$(dirname "$0")/../.." && pwd)"
-TM="$ROOT/pipeline/scripts/triage-memory.mjs"
-PHASE7="$ROOT/pipeline/multi-agent-refs/phases/phase-7-report.md"
-PHASE4="$ROOT/pipeline/multi-agent-refs/phases/phase-4-review.md"
-PREFS="$ROOT/pipeline/schemas/prefs.schema.json"
-SCHEMA="$ROOT/pipeline/schemas/triage-corpus.schema.json"
-
-pass=0
-fail=0
-failures=()
-record_pass() { pass=$((pass + 1)); printf '  \033[0;32mPASS\033[0m %s\n' "$1"; }
-record_fail() { fail=$((fail + 1)); failures+=("$1"); printf '  \033[0;31mFAIL\033[0m %s\n' "$1"; }
-
-printf '→ smoke-triage-memory (v8.3.0): semantic memory contract\n'
-
-[ -f "$SCHEMA" ] || { record_fail "schema missing: $SCHEMA"; exit 1; }
-
-TMP_HOME=$(mktemp -d)
-trap 'rm -rf "$TMP_HOME"' EXIT
-export HOME="$TMP_HOME"
-export MULTI_AGENT_REPO_SLUG="smoke-corpus"
-
-# Build a fixture triage JSON
-TRIAGE_FIXTURE="$TMP_HOME/triage.json"
-cat > "$TRIAGE_FIXTURE" <<'JSON'
-{
-  "accepted": [
-    {"severity":"blocking","file":"Auth/KeychainStore.swift","line":42,"issue":"Force-unwrap on optional token","fix":"Use guard let","reviewer":"opus"},
-    {"severity":"important","file":"Networking/ApiClient.swift","line":11,"issue":"Missing timeout configuration","fix":"Set request timeout","reviewer":"sonnet"}
-  ],
-  "deferred": [
-    {"finding":{"severity":"suggestion","file":"Views/SettingsView.swift","line":50,"issue":"Could extract subview","fix":"refactor"},"reason":"out of scope"}
-  ],
-  "rejected": [
-    {"finding":{"severity":"important","file":"Auth/KeychainStore.swift","line":99,"issue":"Use Sendable annotation","fix":"add Sendable"},"reason":"requires Swift 6 migration"}
-  ],
-  "approved": false
-}
-JSON
-
-# --- 1: first ingest writes rows ---
-out1=$(node "$TM" ingest --triage "$TRIAGE_FIXTURE" --task-id PROJ-100 --task-title "Auth refactor" --stack ios 2>/dev/null)
-ingested=$(echo "$out1" | jq -r '.ingested')
-if [ "$ingested" = "4" ]; then
-  record_pass "ingest writes 4 rows (2 accepted + 1 deferred + 1 rejected)"
-else
-  record_fail "ingest expected 4, got $ingested"
-fi
-
-# --- 2: idempotent re-ingest writes 0 rows ---
-out2=$(node "$TM" ingest --triage "$TRIAGE_FIXTURE" --task-id PROJ-100 --task-title "Auth refactor" --stack ios 2>/dev/null; echo "EC=$?")
-ingested2=$(echo "$out2" | grep -v EC= | jq -r '.ingested')
-ec2=$(echo "$out2" | grep "EC=" | sed 's/.*EC=//')
-if [ "$ingested2" = "0" ] && [ "$ec2" = "2" ]; then
-  record_pass "re-ingest is idempotent (0 rows + exit 2)"
-else
-  record_fail "re-ingest should write 0 rows + exit 2, got rows=$ingested2 ec=$ec2"
-fi
-
-# --- 3: stats counts ---
-stats=$(node "$TM" stats 2>/dev/null)
-acc=$(echo "$stats" | jq -r '.counts.accepted')
-def=$(echo "$stats" | jq -r '.counts.deferred')
-rej=$(echo "$stats" | jq -r '.counts.rejected')
-if [ "$acc" = "2" ] && [ "$def" = "1" ] && [ "$rej" = "1" ]; then
-  record_pass "stats reports accepted=2 deferred=1 rejected=1"
-else
-  record_fail "stats wrong: accepted=$acc deferred=$def rejected=$rej"
-fi
-
-# --- 4: query ranks by token overlap ---
-q1=$(node "$TM" query --issue "force unwrap optional" --top 2 2>/dev/null)
-top1=$(echo "$q1" | jq -r '.hits[0].file')
-top1_issue=$(echo "$q1" | jq -r '.hits[0].issue')
-if [[ "$top1" == *"KeychainStore.swift" ]] && [[ "$top1_issue" == *"Force-unwrap"* ]]; then
-  record_pass "query: 'force unwrap optional' top hit = KeychainStore force-unwrap finding"
-else
-  record_fail "query top hit wrong: $top1 / $top1_issue"
-fi
-
-# --- 5: file-glob filter ---
-q2=$(node "$TM" query --issue "timeout" --file-glob "Networking/*" 2>/dev/null)
-n2=$(echo "$q2" | jq -r '.hits | length')
-top2=$(echo "$q2" | jq -r '.hits[0].file' 2>/dev/null || echo "")
-if [ "$n2" = "1" ] && [[ "$top2" == "Networking/ApiClient.swift" ]]; then
-  record_pass "query: --file-glob narrows to Networking/* path"
-else
-  record_fail "file-glob narrow wrong: hits=$n2 top=$top2"
-fi
-
-# --- 6: path subcommand ---
-p=$(node "$TM" path 2>/dev/null)
-expected="$TMP_HOME/.claude/memory/multi-agent/smoke-corpus/triage-corpus.jsonl"
-if [ "$p" = "$expected" ]; then
-  record_pass "path resolves to <HOME>/.claude/memory/multi-agent/<slug>/triage-corpus.jsonl"
-else
-  record_fail "path wrong: $p (expected $expected)"
-fi
-
-# --- 7: empty-corpus query exits 2 with empty hits ---
-export MULTI_AGENT_REPO_SLUG="empty-corpus"
-set +e
-empty_out=$(node "$TM" query --issue "anything" 2>/dev/null)
-ec=$?
-set -e
-hits=$(echo "$empty_out" | jq -r '.hits | length')
-total=$(echo "$empty_out" | jq -r '.total')
-if [ "$ec" = "2" ] && [ "$hits" = "0" ] && [ "$total" = "0" ]; then
-  record_pass "empty-corpus query: exit 2, hits=[], total=0"
-else
-  record_fail "empty-corpus wrong: ec=$ec hits=$hits total=$total"
-fi
-export MULTI_AGENT_REPO_SLUG="smoke-corpus"
-
-# --- 8: schema present + valid JSON ---
-if jq -e '.title and .properties.classification' "$SCHEMA" >/dev/null 2>&1; then
-  record_pass "triage-corpus schema present and well-formed"
-else
-  record_fail "triage-corpus schema malformed"
-fi
-
-# --- 9: phase-7-report.md declares ingest ---
-if grep -q 'triage-memory.mjs' "$PHASE7"; then
-  record_pass "phase-7-report.md references triage-memory.mjs"
-else
-  record_fail "phase-7-report.md missing triage-memory.mjs reference"
-fi
-
-# --- 10: phase-4-review.md declares prior-art lookup ---
-if grep -qE 'prior.art|triage-memory' "$PHASE4"; then
-  record_pass "phase-4-review.md declares prior-art lookup"
-else
-  record_fail "phase-4-review.md missing prior-art lookup"
-fi
-
-# --- 11: prefs schema exposes priorArtEnrichment ---
-if jq -e '.properties.global.properties.priorArtEnrichment' "$PREFS" >/dev/null 2>&1; then
-  record_pass "prefs schema exposes priorArtEnrichment toggle"
-else
-  record_fail "prefs.schema.json missing global.priorArtEnrichment"
-fi
-
-# --- Summary ---
-total=$((pass + fail))
-printf '\n→ smoke-triage-memory: %d/%d passed\n' "$pass" "$total"
-if [ "$fail" -ne 0 ]; then
-  printf '\nFailures:\n'
-  for f in "${failures[@]}"; do printf '  - %s\n' "$f"; done
-  exit 1
-fi
-exit 0

package/pipeline/scripts/smoke-update-check.sh

@@ -1,135 +0,0 @@
-#!/usr/bin/env bash
-# smoke-update-check.sh
-#
-# Verifies the Phase 0 Step 0.6 advisory update-check contract:
-#   1. update-check.sh exists, parses (bash -n), and honors the advisory contract
-#      offline: exit 0 + empty stdout when the registry is unreachable
-#   2. Cached path: fresh cache short-circuits without a network call
-#   3. Newer latest -> "<local>|<latest>"; same or older latest -> silent
-#   4. prefs.schema.json exposes updateCheck.{enabled,ttlHours,autoUpdate}
-#      with the documented defaults (enabled=true, autoUpdate=false)
-#   5. phase-0-init.md documents Step 0.6 with the autopilot log-only rule
-#
-# Exit 0 = all pass, 1 = any failure.
-
-set -euo pipefail
-
-ROOT="$(cd "$(dirname "$0")/../.." && pwd)"
-SCRIPT="$ROOT/pipeline/scripts/update-check.sh"
-PREFS_SCHEMA="$ROOT/pipeline/schemas/prefs.schema.json"
-PHASE0_DOC="$ROOT/pipeline/multi-agent-refs/phases/phase-0-init.md"
-
-pass=0
-fail=0
-failures=()
-record_pass() { pass=$((pass + 1)); printf '  \033[0;32mPASS\033[0m %s\n' "$1"; }
-record_fail() { fail=$((fail + 1)); failures+=("$1"); printf '  \033[0;31mFAIL\033[0m %s\n' "$1"; }
-
-printf '→ smoke-update-check: Phase 0 Step 0.6 advisory contract\n'
-
-tmpdir=$(mktemp -d)
-trap 'rm -rf "$tmpdir"' EXIT
-CACHE="$tmpdir/update-check-cache"
-
-# 1. Script parses
-if bash -n "$SCRIPT" 2>/dev/null; then
-  record_pass "update-check.sh parses (bash -n)"
-else
-  record_fail "update-check.sh has syntax errors"
-fi
-
-now=$(date +%s)
-
-# 2. Fresh cache with newer latest -> reports, no network needed
-printf '%s|99.0.0\n' "$now" > "$CACHE"
-out=$(UPDATE_CHECK_CACHE="$CACHE" bash "$SCRIPT" --local 10.0.0 2>/dev/null); rc=$?
-if [ "$rc" -eq 0 ] && [ "$out" = "10.0.0|99.0.0" ]; then
-  record_pass "newer cached latest -> '<local>|<latest>' (exit 0)"
-else
-  record_fail "newer cached latest should print '10.0.0|99.0.0' (got '$out', rc=$rc)"
-fi
-
-# 3. Same version -> silent
-printf '%s|10.0.0\n' "$now" > "$CACHE"
-out=$(UPDATE_CHECK_CACHE="$CACHE" bash "$SCRIPT" --local 10.0.0 2>/dev/null); rc=$?
-if [ "$rc" -eq 0 ] && [ -z "$out" ]; then
-  record_pass "same version -> silent"
-else
-  record_fail "same version should be silent (got '$out', rc=$rc)"
-fi
-
-# 3b. Local ahead of registry (dev machine) -> silent
-printf '%s|10.0.0\n' "$now" > "$CACHE"
-out=$(UPDATE_CHECK_CACHE="$CACHE" bash "$SCRIPT" --local 10.1.0 2>/dev/null); rc=$?
-if [ "$rc" -eq 0 ] && [ -z "$out" ]; then
-  record_pass "local ahead of registry -> silent (no downgrade prompt)"
-else
-  record_fail "local-ahead should be silent (got '$out', rc=$rc)"
-fi
-
-# 3b2. No --local, no repo clone -> falls back to the install-time version
-# marker (npx-only installs have no clone to read a version from)
-marker_home="$tmpdir/marker-home"
-mkdir -p "$marker_home/.claude"
-printf '10.0.0\n' > "$marker_home/.claude/.pipeline-version"
-printf '%s|99.0.0\n' "$now" > "$CACHE"
-out=$(HOME="$marker_home" UPDATE_CHECK_CACHE="$CACHE" bash "$SCRIPT" 2>/dev/null); rc=$?
-if [ "$rc" -eq 0 ] && [ "$out" = "10.0.0|99.0.0" ]; then
-  record_pass "no clone -> .pipeline-version marker fallback works"
-else
-  record_fail "marker fallback should print '10.0.0|99.0.0' (got '$out', rc=$rc)"
-fi
-
-# 3c. Offline + stale cache -> silent exit 0 (advisory: never blocks)
-printf '0|10.0.0\n' > "$CACHE"
-out=$(UPDATE_CHECK_CACHE="$CACHE" http_proxy="http://127.0.0.1:1" https_proxy="http://127.0.0.1:1" \
-      bash "$SCRIPT" --local 10.0.0 2>/dev/null); rc=$?
-if [ "$rc" -eq 0 ] && [ -z "$out" ]; then
-  record_pass "offline + stale cache -> silent exit 0"
-else
-  record_fail "offline should be a silent no-op (got '$out', rc=$rc)"
-fi
-
-# 4. Prefs schema knobs + defaults
-for prop in enabled ttlHours autoUpdate; do
-  if jq -e ".properties.global.properties.updateCheck.properties.${prop}" "$PREFS_SCHEMA" >/dev/null 2>&1; then
-    record_pass "prefs schema exposes updateCheck.${prop}"
-  else
-    record_fail "prefs schema missing updateCheck.${prop}"
-  fi
-done
-if jq -e '.properties.global.properties.updateCheck.properties.enabled.default == true' "$PREFS_SCHEMA" >/dev/null 2>&1; then
-  record_pass "updateCheck.enabled defaults to true (notify-only, bounded cost)"
-else
-  record_fail "updateCheck.enabled must default to true"
-fi
-if jq -e '.properties.global.properties.updateCheck.properties.autoUpdate | has("default") and .default == false' "$PREFS_SCHEMA" >/dev/null 2>&1; then
-  record_pass "updateCheck.autoUpdate defaults to false (no silent self-modify)"
-else
-  record_fail "updateCheck.autoUpdate must default to false"
-fi
-
-# 5. Phase 0 doc wiring
-if grep -qF "Step 0.6 - Update check" "$PHASE0_DOC"; then
-  record_pass "phase-0-init.md documents Step 0.6"
-else
-  record_fail "phase-0-init.md missing Step 0.6"
-fi
-if grep -qF "update-check.sh" "$PHASE0_DOC"; then
-  record_pass "phase-0-init.md invokes update-check.sh"
-else
-  record_fail "phase-0-init.md must invoke update-check.sh"
-fi
-if grep -qF "log-only" "$PHASE0_DOC" && grep -qF "never ask (zero-interaction contract)" "$PHASE0_DOC"; then
-  record_pass "phase-0-init.md states the autopilot log-only rule"
-else
-  record_fail "phase-0-init.md must state autopilot never asks (log-only)"
-fi
-
-printf '\n══ update-check smoke: %d passed, %d failed ══\n' "$pass" "$fail"
-if [ "$fail" -gt 0 ]; then
-  printf '\nFailures:\n'
-  for msg in "${failures[@]}"; do printf '  - %s\n' "$msg"; done
-  exit 1
-fi
-exit 0

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

@@ -1,70 +0,0 @@
-#!/usr/bin/env bash
-# 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
-#     3. prefs.schema.json has hosts.fortify
-#     4. setup.md Step 3.5 prompts for fortify host (and skips firebase)
-#     5. Token Save Flow routing includes fortify
-
-set -u
-ROOT="$(cd "$(dirname "$0")/../.." && pwd)"
-PASS=0
-FAIL=0
-
-check() {
-  local label="$1" cmd="$2"
-  if eval "$cmd" > /dev/null 2>&1; then
-    printf "  ✓ %s\n" "$label"
-    PASS=$((PASS+1))
-  else
-    printf "  ✗ %s\n" "$label"
-    FAIL=$((FAIL+1))
-  fi
-}
-
-PHASE0="$ROOT/pipeline/multi-agent-refs/phases/phase-0-init.md"
-SETUP="$ROOT/pipeline/commands/multi-agent/setup/SKILL.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 "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'"
-
-echo
-echo "→ 2. state enrichment shapes specified"
-check "state.crashContext documented"            "grep -Fq 'state.crashContext' '$PHASE0'"
-check "state.fortifyFinding documented"          "grep -Fq 'state.fortifyFinding' '$PHASE0'"
-check "Phase 1 prepend mention for crash"        "grep -Fq 'Known Crash Context' '$PHASE0'"
-check "Phase 2 inject mention for fortify"       "grep -Fq 'Known Security Finding' '$PHASE0'"
-
-echo
-echo "→ 3. Progress contract line documented"
-check "URL context log line shape"               "grep -Fq 'URL deep fetch: crashlytics=' '$PHASE0'"
-
-echo
-echo "→ 4. prefs.schema.json has hosts.fortify"
-check "hosts.fortify field exists"               "grep -Fq '\"fortify\":' '$SCHEMA' && grep -Fq 'Fortify SSC host' '$SCHEMA'"
-check "FORTIFY_HOST placeholder referenced"      "grep -Fq '{FORTIFY_HOST}' '$SCHEMA'"
-
-echo
-echo "→ 5. Firebase description = 'Firebase JSON' (not 'SA JSON')"
-check "schema firebase (servicePatMap) renamed"  "! grep -F 'Firebase Service Account JSON' '$SCHEMA'"
-check "schema firebase (keychainMapping) renamed" "grep -c '\"Firebase JSON' '$SCHEMA' | grep -q '[2-9]'"
-
-echo
-echo "→ 6. setup.md Step 3.5 routes fortify (not firebase)"
-check "Step 3.5 lists fortify"                   "grep -Eq 'jira.*confluence.*bitbucket.*fortify|fortify.*host' '$SETUP'"
-check "firebase skip note in Step 3.5"           "grep -Fiq 'firebase is skipped' '$SETUP' || grep -Fiq 'Firebase tokens skip' '$SETUP'"
-check "Resulting shape has fortify host"         "grep -Fq '\"fortify\":' '$SETUP'"
-check "FORTIFY_HOST placeholder listed"          "grep -Fq '{FORTIFY_HOST}' '$SETUP'"
-
-echo
-echo "→ 7. Token Source Mapping shows 'Firebase JSON' label"
-check "setup.md Token Source Mapping renamed"    "grep -Fq 'Firebase JSON (base64)' '$SETUP'"
-check "multi-agent-setup SKILL.md renamed"       "grep -Fq 'Firebase JSON (base64)' '$ROOT/pipeline/skills/shared/core/multi-agent-setup/SKILL.md'"
-
-echo
-echo "══ url-enrichment smoke: $PASS passed, $FAIL failed ══"
-[ "$FAIL" -eq 0 ]

package/pipeline/scripts/smoke-validate-analysis-doc.sh

@@ -1,161 +0,0 @@
-#!/usr/bin/env bash
-# smoke-validate-analysis-doc.sh  -  contract for validate-analysis-doc.mjs,
-# the deterministic gate over an emitted /multi-agent:analysis document.
-
-set -uo pipefail
-
-SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
-V="$SCRIPT_DIR/validate-analysis-doc.mjs"
-
-PASS=0
-FAIL=0
-record_pass() { PASS=$((PASS + 1)); printf '  \342\234\223 %s\n' "$1"; }
-record_fail() { FAIL=$((FAIL + 1)); printf '  \342\234\227 %s\n' "$1"; }
-
-printf '\342\206\222 smoke-validate-analysis-doc: emitted-doc gate\n'
-
-tmp=$(mktemp -d "${TMPDIR:-/tmp}/vdoc.XXXXXX")
-trap 'rm -rf "$tmp"' EXIT
-
-# A well-formed Full-mode doc (neutral UserProfile domain, BR referenced downstream).
-cat > "$tmp/good.md" <<'MD'
----
-feature: UserProfile
-platform: ios
-language: tr
-mode: full
-template_version: v3
----
-## 1. Özet
-Profile screen.
-## 2. Hedefler ve Karşı Hedefler
-goals.
-## 4. Kullanıcı Hikayeleri
-### 4.4 İş Kuralları
-| BR-profile-01 | rule | source | Given/When/Then |
-## 9. API Kontratları
-api.
-## 13. Mimari Plan
-arch.
-## 14. Eklenecek Dosyalar
-files.
-## 15. Test Planı
-BR-profile-01 happy path.
-## 20. Riskler ve Açık Sorular
-risk.
-## 21. Referanslar
-refs.
-MD
-
-if node "$V" "$tmp/good.md" >/dev/null 2>&1; then
-  record_pass "well-formed Full doc passes (exit 0)"
-else
-  record_fail "well-formed doc should pass"
-fi
-
-# Lite doc without Section 15 must still pass (Locked 31 mode-aware).
-cat > "$tmp/lite.md" <<'MD'
----
-feature: UserProfile
-platform: ios
-language: en
-mode: lite
-template_version: v3
----
-## 1. Summary
-s
-## 2. Goals and Non-Goals
-g
-## 4. User Stories
-### 4.4 Business Rules
-| BR-profile-01 | rule | source | Given/When/Then |
-## 9. API Contracts
-a
-## 13. Architecture
-x
-## 14. Files to Add
-f
-## 20. Risks and Open Questions
-r
-## 21. References
-ref
-MD
-if node "$V" "$tmp/lite.md" >/dev/null 2>&1; then
-  record_pass "Lite doc (no Section 15) passes - mode-aware Locked 31"
-else
-  record_fail "Lite doc without Section 15 must pass"
-fi
-
-# Missing front-matter -> ERROR.
-printf '## 1. Summary\nno front matter\n' > "$tmp/nofm.md"
-node "$V" "$tmp/nofm.md" >/dev/null 2>&1
-[ "$?" -eq 1 ] && record_pass "missing front-matter fails (exit 1)" || record_fail "missing front-matter should fail"
-
-# Banned punctuation (em-dash) -> ERROR.
-cp "$tmp/good.md" "$tmp/emdash.md"
-printf 'A line with an em-dash \342\200\224 here.\n' >> "$tmp/emdash.md"
-# Capture first (pipefail + node's nonzero exit would poison a direct pipe).
-emdash_out=$(node "$V" "$tmp/emdash.md" 2>&1 || true)
-if printf '%s' "$emdash_out" | grep -q "em-dash"; then
-  record_pass "em-dash flagged (Locked 7)"
-else
-  record_fail "em-dash should be flagged"
-fi
-
-# Missing a never-omitted section (References) -> ERROR.
-grep -v "Referanslar\|References" "$tmp/good.md" > "$tmp/noref.md"
-node "$V" "$tmp/noref.md" >/dev/null 2>&1
-[ "$?" -eq 1 ] && record_pass "missing References section fails" || record_fail "missing References should fail"
-
-# Define-only BR under --strict -> fail (WARN promoted).
-cat > "$tmp/orphan.md" <<'MD'
----
-feature: UserProfile
-platform: ios
-language: en
-mode: full
-template_version: v3
----
-## 1. Summary
-s
-## 2. Goals
-g
-## 4. User Stories
-### 4.4 Business Rules
-| BR-profile-42 | rule | source | Given/When/Then |
-## 9. API Contracts
-a
-## 13. Architecture
-x
-## 14. Files to Add
-f
-## 15. Test Plan
-no BR reference here
-## 20. Risks
-r
-## 21. References
-ref
-MD
-node "$V" "$tmp/orphan.md" >/dev/null 2>&1
-[ "$?" -eq 0 ] && record_pass "define-only BR is WARN, not error (default)" || record_fail "orphan BR should not hard-fail by default"
-node "$V" "$tmp/orphan.md" --strict >/dev/null 2>&1
-[ "$?" -eq 1 ] && record_pass "define-only BR fails under --strict" || record_fail "orphan BR should fail under --strict"
-
-# ui_tests: true but no Section 15.6 -> ERROR.
-sed 's/^mode: full/mode: full\nui_tests: true\na11y_depth: basic/' "$tmp/good.md" > "$tmp/uimiss.md"
-node "$V" "$tmp/uimiss.md" >/dev/null 2>&1
-[ "$?" -eq 1 ] && record_pass "ui_tests:true without Section 15.6 fails" || record_fail "ui_tests:true must require 15.6"
-
-# ui_tests: true WITH a Section 15.6 heading -> passes.
-cp "$tmp/uimiss.md" "$tmp/uiok.md"
-printf '## 15.6 UI test senaryolari\nUI-profile-01 flow.\n' >> "$tmp/uiok.md"
-node "$V" "$tmp/uiok.md" >/dev/null 2>&1
-[ "$?" -eq 0 ] && record_pass "ui_tests:true with Section 15.6 passes" || record_fail "ui_tests:true + 15.6 should pass"
-
-# a11y_depth: full but no Section 16.2 walkthrough -> ERROR.
-sed 's/^mode: full/mode: full\nui_tests: false\na11y_depth: full/' "$tmp/good.md" > "$tmp/a11ymiss.md"
-node "$V" "$tmp/a11ymiss.md" >/dev/null 2>&1
-[ "$?" -eq 1 ] && record_pass "a11y_depth:full without Section 16.2 fails" || record_fail "a11y_depth:full must require 16.2"
-
-printf '\n\342\225\220\342\225\220 smoke-validate-analysis-doc: %d passed, %d failed \342\225\220\342\225\220\n' "$PASS" "$FAIL"
-[ "$FAIL" -eq 0 ]