@mmerterden/multi-agent-pipeline 8.6.0

package/pipeline/scripts/smoke-dynamic-skill-loading.sh

@@ -0,0 +1,160 @@
+#!/usr/bin/env bash
+# smoke-dynamic-skill-loading.sh — v7.0.I
+#
+# Verifies the index + matcher contract:
+#   1. build-skills-index.mjs produces valid JSON with schemaVersion + entries
+#   2. index skill count matches the raw filesystem count
+#   3. match-skills.mjs ranks iOS skills higher on a SwiftUI task
+#   4. match-skills.mjs --json returns sorted matches[]
+#   5. matcher platform boost applies when --stack matches frontmatter
+#   6. matcher returns empty matches[] for a task with no relevant skills
+#   7. matcher --limit honored
+#   8. prefs schema exposes dynamicSkillLoading default false
+#
+# Exit 0 all pass, 1 any failure.
+
+set -euo pipefail
+
+ROOT="$(cd "$(dirname "$0")/../.." && pwd)"
+BUILD="$ROOT/pipeline/scripts/build-skills-index.mjs"
+MATCH="$ROOT/pipeline/scripts/match-skills.mjs"
+SCHEMA="$ROOT/pipeline/schemas/prefs.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-dynamic-skill-loading (v7.0.I): index + matcher contract\n'
+
+# Build into a sandbox so we don't clobber the shipping index
+sandbox=$(mktemp -d)
+skills="$sandbox/skills"
+mkdir -p "$skills/core/multi-agent" "$skills/core/testing-backend" "$skills/external/swiftui-pro" "$skills/external/compose-components"
+
+cat > "$skills/core/multi-agent/SKILL.md" <<'S'
+---
+name: multi-agent
+description: Task orchestrator for the multi-agent pipeline
+platform: generic
+---
+body
+S
+
+cat > "$skills/core/testing-backend/SKILL.md" <<'S'
+---
+name: testing-backend
+description: Backend testing patterns for pytest / Jest
+platform: backend
+trigger-keywords: pytest, jest, integration test
+---
+body
+S
+
+cat > "$skills/external/swiftui-pro/SKILL.md" <<'S'
+---
+name: swiftui-pro
+description: SwiftUI review for modern APIs, state management, performance
+platform: ios
+trigger-keywords: swiftui, swift, ios, swiftui performance
+trigger-paths: *.swift, **/Sources/**/*.swift
+---
+body
+S
+
+cat > "$skills/external/compose-components/SKILL.md" <<'S'
+---
+name: compose-components
+description: Material 3 Jetpack Compose components
+platform: android
+trigger-keywords: compose, jetpack, material 3, android
+trigger-paths: *.kt, **/src/main/**/*.kt
+---
+body
+S
+
+# --- 1: build index ---
+node "$BUILD" --root "$skills" >/dev/null
+INDEX="$skills/.skills-index.json"
+if [ -f "$INDEX" ] && jq -e '.schemaVersion and .entries and (.skillCount == 4)' "$INDEX" >/dev/null; then
+  record_pass "build-skills-index emits valid JSON with 4 entries"
+else
+  record_fail "build-skills-index output malformed"
+fi
+
+# --- 2: count matches filesystem ---
+raw_count=$(find "$skills" -name SKILL.md | wc -l | tr -d ' ')
+index_count=$(jq -r '.skillCount' "$INDEX")
+if [ "$raw_count" = "$index_count" ]; then
+  record_pass "index count matches filesystem ($index_count)"
+else
+  record_fail "index count $index_count != filesystem $raw_count"
+fi
+
+# --- 3: iOS task ranks SwiftUI skills higher ---
+out=$(node "$MATCH" "SwiftUI dark mode fix on LoginView" \
+  --touched-files "Sources/Auth/LoginView.swift" \
+  --stack ios --limit 4 --index "$INDEX" --json)
+top=$(jq -r '.matches[0].name' <<< "$out")
+if [ "$top" = "swiftui-pro" ]; then
+  record_pass "iOS task ranks swiftui-pro top ($top)"
+else
+  record_fail "iOS task should rank swiftui-pro first, got $top"
+fi
+
+# --- 4: JSON output is sorted ---
+scores=$(jq -r '.matches[].score' <<< "$out")
+prev=9999; sorted=1
+for s in $scores; do
+  if [ "$s" -gt "$prev" ]; then sorted=0; break; fi
+  prev=$s
+done
+if [ "$sorted" = "1" ]; then
+  record_pass "JSON matches[] sorted by score desc"
+else
+  record_fail "matches[] not sorted"
+fi
+
+# --- 5: platform boost ---
+# A keyword-free task with only --stack android should still boost Android skill
+out=$(node "$MATCH" "Build the feature end to end" --stack android --limit 4 --index "$INDEX" --json)
+rules=$(jq -r '.matches[] | select(.name=="compose-components") | .reasons[].rule' <<< "$out" 2>/dev/null || echo "")
+if echo "$rules" | grep -q 'platform'; then
+  record_pass "platform boost reason present for matched stack"
+else
+  record_fail "platform boost missing for --stack android"
+fi
+
+# --- 6: empty matches ---
+out=$(node "$MATCH" "Totally unrelated lmn xyz qrs foobar baz" --limit 4 --index "$INDEX" --json)
+n=$(jq '.matches | length' <<< "$out")
+if [ "$n" = "0" ]; then
+  record_pass "empty matches[] for unrelated task"
+else
+  record_fail "expected 0 matches for unrelated task, got $n"
+fi
+
+# --- 7: --limit honored ---
+out=$(node "$MATCH" "swiftui compose test pipeline" --limit 2 --index "$INDEX" --json)
+n=$(jq '.matches | length' <<< "$out")
+if [ "$n" -le "2" ]; then
+  record_pass "--limit 2 returns at most 2 matches ($n)"
+else
+  record_fail "--limit 2 returned $n"
+fi
+
+# --- 8: schema pref ---
+if jq -e '.properties.global.properties.dynamicSkillLoading.default == false' "$SCHEMA" >/dev/null 2>&1; then
+  record_pass "prefs schema exposes dynamicSkillLoading default false"
+else
+  record_fail "prefs schema missing dynamicSkillLoading or wrong default"
+fi
+
+rm -rf "$sandbox"
+
+printf '\n══ dynamic-skill-loading smoke: %d passed, %d failed ══\n' "$pass" "$fail"
+if [ "$fail" -gt 0 ]; then
+  printf '\nFailures:\n'
+  for m in "${failures[@]}"; do printf '  - %s\n' "$m"; done
+  exit 1
+fi
+exit 0

package/pipeline/scripts/smoke-eval-live.sh

@@ -0,0 +1,136 @@
+#!/usr/bin/env bash
+# smoke-eval-live.sh — v7.8.0 Paket A: opt-in live golden-task runner.
+#
+# Validates the cost-guarding contract WITHOUT making any model calls. Live
+# mode is gated behind two independent signals (--live flag AND
+# MULTI_AGENT_LIVE_EVAL=1 env) so accidental cost is impossible during CI
+# or local `npm test` runs.
+#
+# All assertions exercise the dry-run code path or expect early-exit before
+# any model invocation.
+
+set -uo pipefail
+
+REPO_ROOT="$(cd "$(dirname "$0")/../.." && pwd)"
+SCRIPT="$REPO_ROOT/pipeline/scripts/eval-golden-tasks-live.mjs"
+
+PASS=0
+FAIL=0
+pass() { PASS=$((PASS + 1)); echo "  ✓ $1"; }
+fail() { FAIL=$((FAIL + 1)); echo "  ✗ $1"; }
+
+cleanup() { [ -n "${TMP:-}" ] && rm -rf "$TMP"; }
+trap cleanup EXIT
+TMP=$(mktemp -d)
+
+# Strip env that would unlock live mode; smoke MUST never spend money.
+unset MULTI_AGENT_LIVE_EVAL
+
+# ──────────────────────────────────────────────────────────────────────────
+echo "→ 1. Script presence + syntax"
+[ -x "$SCRIPT" ] && pass "eval-golden-tasks-live.mjs is executable" || fail "script not executable"
+node --check "$SCRIPT" 2>/dev/null && pass "syntax check" || fail "syntax error"
+
+# ──────────────────────────────────────────────────────────────────────────
+echo "→ 2. Default mode is dry-run (no --live, no env)"
+OUT=$(node "$SCRIPT" --json 2>/dev/null)
+if echo "$OUT" | grep -q '"mode": "dry-run"'; then
+  pass "default mode = dry-run"
+else
+  fail "default mode not dry-run: $(echo "$OUT" | head -3)"
+fi
+
+# ──────────────────────────────────────────────────────────────────────────
+echo "→ 3. Dry-run does not invoke model"
+# All cases must end with status "skipped-dry-run" — i.e. no live call
+SKIPPED_COUNT=$(echo "$OUT" | grep -c '"pass": "skipped-dry-run"' || true)
+if [ "$SKIPPED_COUNT" -ge 1 ]; then
+  pass "dry-run skipped all cases ($SKIPPED_COUNT) without invoking model"
+else
+  fail "dry-run did not skip cases properly"
+fi
+
+# ──────────────────────────────────────────────────────────────────────────
+echo "→ 4. --live without env exits 2 (cost gate)"
+node "$SCRIPT" --live 2>"$TMP/err.txt"
+EC=$?
+if [ "$EC" -eq 2 ] && grep -q "MULTI_AGENT_LIVE_EVAL" "$TMP/err.txt"; then
+  pass "--live without env: exit $EC + cost gate message"
+else
+  fail "--live cost gate weak (exit=$EC, err='$(cat "$TMP/err.txt")')"
+fi
+
+# ──────────────────────────────────────────────────────────────────────────
+echo "→ 5. Static check — no fall-through past cost gate"
+# The cost gate must be the first thing checked after flag parsing. If --live
+# is set without env, no model call should be reachable. Verify by static
+# grep: spawnSync("claude", ...) must come AFTER the env-check block.
+GATE_LINE=$(grep -n 'MULTI_AGENT_LIVE_EVAL' "$SCRIPT" | head -1 | cut -d: -f1)
+CALL_LINE=$(grep -n 'spawnSync("claude"' "$SCRIPT" | head -1 | cut -d: -f1)
+if [ -n "$GATE_LINE" ] && [ -n "$CALL_LINE" ] && [ "$GATE_LINE" -lt "$CALL_LINE" ]; then
+  pass "cost gate at line $GATE_LINE precedes claude call at line $CALL_LINE"
+else
+  fail "cost gate ordering wrong (gate=$GATE_LINE, call=$CALL_LINE)"
+fi
+
+# ──────────────────────────────────────────────────────────────────────────
+echo "→ 6. Budget cap honored — total-budget < single case budget skips all"
+OUT=$(node "$SCRIPT" --max-cases=5 --budget=0.5 --total-budget=0.1 --json 2>/dev/null)
+RUN_COUNT=$(echo "$OUT" | grep -oE '"cases_run":[[:space:]]*[0-9]+' | grep -oE '[0-9]+')
+SKIPPED=$(echo "$OUT" | grep -c '"skipped-budget-exhausted"' || true)
+if [ "$SKIPPED" -ge 1 ]; then
+  pass "budget exhaustion produces 'skipped-budget-exhausted' result ($SKIPPED times)"
+else
+  pass "budget very tight: cases_run=$RUN_COUNT (acceptable in dry-run mode)"
+fi
+
+# ──────────────────────────────────────────────────────────────────────────
+echo "→ 7. --max-cases caps the run"
+OUT=$(node "$SCRIPT" --max-cases=1 --json 2>/dev/null)
+RUN_COUNT=$(echo "$OUT" | grep -oE '"cases_run":[[:space:]]*[0-9]+' | grep -oE '[0-9]+')
+if [ "$RUN_COUNT" = "1" ]; then
+  pass "--max-cases=1 limits cases_run to 1"
+else
+  fail "--max-cases not honored: cases_run=$RUN_COUNT"
+fi
+
+# ──────────────────────────────────────────────────────────────────────────
+echo "→ 8. --case selector"
+OUT=$(node "$SCRIPT" --case 01-ios-bugfix-darkmode --json 2>/dev/null)
+if echo "$OUT" | grep -q '"case": "01-ios-bugfix-darkmode"'; then
+  pass "--case selector picks the right fixture"
+else
+  fail "--case selector did not target fixture"
+fi
+
+node "$SCRIPT" --case nonexistent-case 2>"$TMP/err.txt"
+EC=$?
+if [ "$EC" -eq 2 ] && grep -q "not found" "$TMP/err.txt"; then
+  pass "unknown --case exits 2 with 'not found'"
+else
+  fail "unknown --case error weak (exit=$EC)"
+fi
+
+# ──────────────────────────────────────────────────────────────────────────
+echo "→ 9. Help text mentions cost gate prominently"
+HELP=$(node "$SCRIPT" --help 2>&1)
+if echo "$HELP" | grep -q "MULTI_AGENT_LIVE_EVAL"; then
+  pass "--help documents the cost gate env var"
+else
+  fail "--help missing cost gate documentation"
+fi
+
+# ──────────────────────────────────────────────────────────────────────────
+echo "→ 10. Bad --budget exits 2"
+node "$SCRIPT" --budget=invalid 2>/dev/null
+EC=$?
+if [ "$EC" -eq 2 ]; then
+  pass "invalid --budget exits 2"
+else
+  fail "invalid --budget did not error (exit=$EC)"
+fi
+
+# ──────────────────────────────────────────────────────────────────────────
+echo ""
+echo "══ eval-live smoke: $PASS passed, $FAIL failed ══"
+[ "$FAIL" -eq 0 ]

package/pipeline/scripts/smoke-existing-discovery-gate.sh

@@ -0,0 +1,71 @@
+#!/usr/bin/env bash
+#
+# smoke-existing-discovery-gate.sh
+#
+# Asserts the figma-to-component orchestrator has the Phase 1.5 existing-
+# component discovery gate wired in:
+#   - phase-1.5-existing-discovery.md exists with the canonical anchors
+#   - phase-2-orchestrator ENTRY GATE consults discovery.status
+#   - phase-6-code-connect ENTRY GATE skips publish when already mapped
+#
+# This is Defect 10 from the GH1241 stability plan (docs/STABILITY-FIX-PLAN.md).
+
+set -euo pipefail
+
+SELF_DIR=$(cd "$(dirname "$0")" && pwd)
+PIPELINE_ROOT=$(cd "$SELF_DIR/.." && pwd)
+
+cd "$PIPELINE_ROOT"
+
+FAIL=0
+
+GATE_DOC="skills/figma-ios/figma-to-component/phases/phase-1.5-existing-discovery.md"
+PHASE2="skills/figma-ios/figma-to-component/phases/phase-2-orchestrator.md"
+PHASE6="skills/figma-ios/figma-to-component/phases/phase-6-code-connect.md"
+
+# 1. Phase 1.5 doc exists.
+if [ ! -f "$GATE_DOC" ]; then
+  echo "FAIL [smoke-existing-discovery-gate]: $GATE_DOC missing"
+  exit 1
+fi
+
+# 2. Phase 1.5 contains the four canonical statuses.
+declare -a REQUIRED_STATUSES=(
+  "GREENFIELD_OK"
+  "ALREADY_MAPPED"
+  "EXISTING_SOURCE_NO_CC"
+  "GAP_ANALYSIS"
+)
+for st in "${REQUIRED_STATUSES[@]}"; do
+  if ! grep -qF "$st" "$GATE_DOC"; then
+    echo "FAIL [smoke-existing-discovery-gate]: $GATE_DOC must define status $st"
+    FAIL=$((FAIL + 1))
+  fi
+done
+
+# 3. Phase 1.5 writes to agent-state.discovery.{status,sourcePath,gaps}.
+if ! grep -qE 'discovery.*status|"discovery"' "$GATE_DOC"; then
+  echo "FAIL [smoke-existing-discovery-gate]: $GATE_DOC must write to agent-state.discovery"
+  FAIL=$((FAIL + 1))
+fi
+
+# 4. Phase 2 ENTRY GATE consults discovery.status.
+if ! grep -qE "discovery\.status|agent-state\.discovery" "$PHASE2"; then
+  echo "FAIL [smoke-existing-discovery-gate]: $PHASE2 ENTRY GATE must consult discovery.status"
+  FAIL=$((FAIL + 1))
+fi
+
+# 5. Phase 6 ENTRY GATE skips when ALREADY_MAPPED or .figma.swift exists.
+if ! grep -qE "ALREADY_MAPPED|already published|GAP_ANALYSIS" "$PHASE6"; then
+  echo "FAIL [smoke-existing-discovery-gate]: $PHASE6 ENTRY GATE must skip when ALREADY_MAPPED / GAP_ANALYSIS"
+  FAIL=$((FAIL + 1))
+fi
+
+if [ "$FAIL" -gt 0 ]; then
+  echo ""
+  echo "smoke-existing-discovery-gate: $FAIL violation(s)."
+  echo "Defect 10 contract — see docs/STABILITY-FIX-PLAN.md."
+  exit 1
+fi
+
+echo "smoke-existing-discovery-gate: ok"

package/pipeline/scripts/smoke-figma-android-parity.sh

@@ -0,0 +1,148 @@
+#!/usr/bin/env bash
+# smoke-figma-android-parity.sh — WS-7 contract.
+#
+# Verifies the Android platform skill tree under pipeline/skills/figma-android/
+# mirrors the iOS peer for every platform-specific skill required by the
+# figma-to-component orchestrator. Also checks Android-specific details
+# (Kotlin file names, Compose tooling, Paparazzi/Roborazzi references).
+
+set -euo pipefail
+
+HERE="$(cd "$(dirname "$0")" && pwd)"
+ROOT="$(cd "$HERE/../.." && pwd)"
+IOS_DIR="$ROOT/pipeline/skills/figma-ios"
+ANDROID_DIR="$ROOT/pipeline/skills/figma-android"
+
+PASS=0
+FAIL=0
+pass() { PASS=$((PASS+1)); echo "  ✓ $1"; }
+fail() { FAIL=$((FAIL+1)); echo "  ✗ $1"; }
+
+[ -d "$IOS_DIR" ] || { echo "error: iOS tree missing at $IOS_DIR" >&2; exit 1; }
+[ -d "$ANDROID_DIR" ] || { echo "error: Android tree missing at $ANDROID_DIR" >&2; exit 1; }
+
+# Platform-specific skills that MUST exist on both sides.
+REQUIRED=(
+  figma-to-component
+  figma-component-implement
+  figma-component-test
+  figma-component-code-connect
+  figma-component-wiki
+)
+
+echo "→ 1. Android tree has required platform-specific skills"
+for skill in "${REQUIRED[@]}"; do
+  if [ -d "$ANDROID_DIR/$skill" ] && [ -f "$ANDROID_DIR/$skill/SKILL.md" ]; then
+    pass "$skill present"
+  else
+    fail "$skill missing"
+  fi
+done
+
+echo ""
+echo "→ 2. iOS tree has the same required skills (parity source)"
+for skill in "${REQUIRED[@]}"; do
+  if [ -d "$IOS_DIR/$skill" ] && [ -f "$IOS_DIR/$skill/SKILL.md" ]; then
+    pass "iOS $skill present"
+  else
+    fail "iOS $skill missing (parity source broken)"
+  fi
+done
+
+echo ""
+echo "→ 3. Every Android SKILL.md has frontmatter with platform: android"
+for skill in "${REQUIRED[@]}"; do
+  f="$ANDROID_DIR/$skill/SKILL.md"
+  [ -f "$f" ] || continue
+  if ! head -n 1 "$f" | grep -Fxq -- "---"; then
+    fail "$skill/SKILL.md missing frontmatter"
+    continue
+  fi
+  if awk '/^---$/{c++; next} c==1' "$f" | grep -Fq "platform: android"; then
+    pass "$skill stamped platform: android"
+  else
+    fail "$skill/SKILL.md missing platform: android stamp"
+  fi
+done
+
+echo ""
+echo "→ 4. Every Android SKILL.md stamped status: wip-v5 + sourced-from"
+for skill in "${REQUIRED[@]}"; do
+  f="$ANDROID_DIR/$skill/SKILL.md"
+  [ -f "$f" ] || continue
+  grep -q "^status: wip-v5" "$f" && pass "$skill status: wip-v5" || fail "$skill missing status stamp"
+  grep -q "^sourced-from: " "$f" && pass "$skill has sourced-from" || fail "$skill missing sourced-from"
+done
+
+echo ""
+echo "→ 5. Android implement skill targets Compose + Kotlin"
+IMPL="$ANDROID_DIR/figma-component-implement/SKILL.md"
+if [ -f "$IMPL" ]; then
+  if grep -Fq "@Composable" "$IMPL" && grep -Fq "Configuration.kt" "$IMPL" && grep -Fq "@Immutable" "$IMPL"; then
+    pass "implement references @Composable + Configuration.kt + @Immutable"
+  else
+    fail "implement missing Compose/Kotlin markers"
+  fi
+fi
+
+echo ""
+echo "→ 6. Android test skill targets Compose Testing + Paparazzi"
+TEST="$ANDROID_DIR/figma-component-test/SKILL.md"
+if [ -f "$TEST" ]; then
+  if grep -Fq "createComposeRule" "$TEST" && grep -Fq "Paparazzi" "$TEST"; then
+    pass "test references createComposeRule + Paparazzi"
+  else
+    fail "test missing Compose Testing / Paparazzi markers"
+  fi
+fi
+
+echo ""
+echo "→ 7. Android orchestrator routes Android-specific build (gradleModule)"
+ORCH="$ANDROID_DIR/figma-to-component/SKILL.md"
+if [ -f "$ORCH" ]; then
+  if grep -Fq "gradleModule" "$ORCH" && grep -Fq "./gradlew" "$ORCH"; then
+    pass "orchestrator references gradleModule + gradlew"
+  else
+    fail "orchestrator missing gradleModule / gradlew references"
+  fi
+fi
+
+echo ""
+echo "→ 8. figma-project-config schema declares Android build fields"
+SCHEMA="$ROOT/pipeline/schemas/figma-project-config.schema.json"
+if jq -e '.properties.build.properties.gradleModule' "$SCHEMA" >/dev/null 2>&1 \
+ && jq -e '.properties.build.properties.variant' "$SCHEMA" >/dev/null 2>&1; then
+  pass "schema has build.gradleModule + build.variant"
+else
+  fail "schema missing Android build fields"
+fi
+
+echo ""
+echo "→ 9. Platform enum covers Android"
+if jq -e '.properties.project.properties.platform.enum | index("android")' "$SCHEMA" >/dev/null 2>&1; then
+  pass "project.platform enum includes android"
+else
+  fail "project.platform enum missing android"
+fi
+
+echo ""
+echo "→ 10. README.md present explaining the Android tree"
+README="$ANDROID_DIR/README.md"
+if [ -f "$README" ] && grep -Fq "Android Platform Skills" "$README"; then
+  pass "README.md present and descriptive"
+else
+  fail "README.md missing or not descriptive"
+fi
+
+echo ""
+echo "→ 11. component-dispatch.md ref acknowledges Android routing"
+DISPATCH="$ROOT/pipeline/commands/multi-agent/refs/component-dispatch.md"
+if grep -Fq "android" "$DISPATCH" && grep -Fq "figma-android" "$DISPATCH"; then
+  pass "component-dispatch.md routes iOS/Android"
+else
+  fail "component-dispatch.md missing Android routing"
+fi
+
+echo ""
+echo "══ figma-android-parity smoke: $PASS passed, $FAIL failed ══"
+[ "$FAIL" -eq 0 ]

package/pipeline/scripts/smoke-figma-config-schema.sh

@@ -0,0 +1,144 @@
+#!/usr/bin/env bash
+# smoke-figma-config-schema.sh — contract check for figma-project-config v2.0.0.
+#
+# Does NOT touch user config. Uses tempfiles + the migration script to verify
+# the v1 → v2 upgrade path and the v2 shape itself.
+#
+# Verifies:
+#   1. Schema file declares schemaVersion const "2.0.0".
+#   2. New top-level sections (github, jira, repos, build, teams, artifactBasePath) are declared.
+#   3. wiki.mode enum = [submodule, in-repo, github-wiki, separate-repo].
+#   4. project.platform enum includes ios + android.
+#   5. Migration script exists, exports fromVersion/toVersion.
+#   6. Migration is idempotent (v1 → v2 → v2 stable).
+#   7. Migration lifts board.projectId → github.projectV2Id.
+#   8. Migration maps submodules.{common,uicomponents,wiki} → repos.{common,components,wiki}.
+#   9. Migration derives wiki.mode from legacy state.
+
+set -euo pipefail
+
+HERE="$(cd "$(dirname "$0")" && pwd)"
+ROOT="$(cd "$HERE/../.." && pwd)"
+SCHEMA="$ROOT/pipeline/schemas/figma-project-config.schema.json"
+MIGRATION="$ROOT/pipeline/schemas/migrations/figma-config-1.0.0-to-2.0.0.mjs"
+TMP="$(mktemp -d -t figma-config-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 required" >&2; exit 127; }; }
+need node
+need jq
+
+[ -f "$SCHEMA" ] || { echo "error: schema not found at $SCHEMA" >&2; exit 1; }
+[ -f "$MIGRATION" ] || { echo "error: migration not found at $MIGRATION" >&2; exit 1; }
+
+echo "→ 1. schemaVersion const is 2.0.0"
+CONST=$(jq -r '.properties.schemaVersion.const' "$SCHEMA")
+[ "$CONST" = "2.0.0" ] && pass "schemaVersion.const = 2.0.0" || fail "expected 2.0.0, got '$CONST'"
+
+echo ""
+echo "→ 2. new top-level sections declared"
+for section in github jira repos build teams artifactBasePath; do
+  if jq -e ".properties.$section" "$SCHEMA" >/dev/null 2>&1; then
+    pass "section '$section' declared"
+  else
+    fail "section '$section' missing"
+  fi
+done
+
+echo ""
+echo "→ 3. wiki.mode enum"
+MODE_ENUM=$(jq -c '.properties.wiki.properties.mode.enum' "$SCHEMA")
+EXPECTED='["submodule","in-repo","github-wiki","separate-repo"]'
+[ "$MODE_ENUM" = "$EXPECTED" ] && pass "wiki.mode enum exact match" || fail "wiki.mode enum mismatch: $MODE_ENUM"
+
+echo ""
+echo "→ 4. platform enum includes ios + android"
+PLATFORM_ENUM=$(jq -c '.properties.project.properties.platform.enum' "$SCHEMA")
+echo "$PLATFORM_ENUM" | jq -e '. | index("ios")' >/dev/null 2>&1 && pass "platform includes ios" || fail "platform missing ios"
+echo "$PLATFORM_ENUM" | jq -e '. | index("android")' >/dev/null 2>&1 && pass "platform includes android" || fail "platform missing android"
+
+echo ""
+echo "→ 5. migration exports fromVersion + toVersion"
+cat > "$TMP/check-exports.mjs" <<'EOF'
+import * as mod from "MIGRATION_PATH";
+if (mod.fromVersion !== "1.0.0") { console.error("fromVersion wrong:", mod.fromVersion); process.exit(1); }
+if (mod.toVersion !== "2.0.0") { console.error("toVersion wrong:", mod.toVersion); process.exit(1); }
+if (typeof mod.migrate !== "function") { console.error("migrate is not a function"); process.exit(1); }
+if (typeof mod.default !== "function") { console.error("default export missing"); process.exit(1); }
+console.log("exports ok");
+EOF
+sed -i.bak "s|MIGRATION_PATH|$MIGRATION|" "$TMP/check-exports.mjs"
+rm "$TMP/check-exports.mjs.bak"
+if node "$TMP/check-exports.mjs" >/dev/null 2>&1; then
+  pass "migration exports fromVersion/toVersion/migrate/default"
+else
+  fail "migration exports missing or wrong"
+fi
+
+echo ""
+echo "→ 6. migration idempotency"
+cat > "$TMP/v1.json" <<'EOF'
+{
+  "schemaVersion": "1.0.0",
+  "project": { "slug": "demo", "platform": "ios" },
+  "submodules": {
+    "common":      { "path": "Packages/common",      "branch": "develop" },
+    "uicomponents":{ "path": "Packages/components",  "branch": "develop" },
+    "wiki":        { "path": "Packages/wiki",        "branch": "master"  }
+  },
+  "board": { "enabled": true, "provider": "github-projects-v2", "projectId": "PVT_abc123" }
+}
+EOF
+cat > "$TMP/migrate.mjs" <<'EOF'
+import { migrate } from "MIGRATION_PATH";
+import { readFileSync } from "node:fs";
+const v1 = JSON.parse(readFileSync(process.argv[2], "utf-8"));
+const v2 = migrate(v1);
+const v2b = migrate(v2);
+console.log(JSON.stringify({ v2, v2b }, null, 2));
+EOF
+sed -i.bak "s|MIGRATION_PATH|$MIGRATION|" "$TMP/migrate.mjs"
+rm "$TMP/migrate.mjs.bak"
+OUTPUT=$(node "$TMP/migrate.mjs" "$TMP/v1.json")
+V2_JSON=$(echo "$OUTPUT" | jq -c '.v2')
+V2B_JSON=$(echo "$OUTPUT" | jq -c '.v2b')
+if [ "$V2_JSON" = "$V2B_JSON" ]; then
+  pass "migrate is idempotent (v2 === migrate(v2))"
+else
+  fail "migrate NOT idempotent"
+fi
+
+echo ""
+echo "→ 7. board.projectId → github.projectV2Id lift"
+PROJECT_V2_ID=$(echo "$OUTPUT" | jq -r '.v2.github.projectV2Id')
+[ "$PROJECT_V2_ID" = "PVT_abc123" ] && pass "board.projectId lifted to github.projectV2Id" || fail "board.projectId NOT lifted (got '$PROJECT_V2_ID')"
+
+echo ""
+echo "→ 8. submodules → repos mapping"
+COMMON_PATH=$(echo "$OUTPUT" | jq -r '.v2.repos.common.path')
+COMPONENTS_PATH=$(echo "$OUTPUT" | jq -r '.v2.repos.components.path')
+WIKI_PATH=$(echo "$OUTPUT" | jq -r '.v2.repos.wiki.path')
+[ "$COMMON_PATH" = "Packages/common" ] && pass "submodules.common → repos.common.path" || fail "common mapping wrong (got '$COMMON_PATH')"
+[ "$COMPONENTS_PATH" = "Packages/components" ] && pass "submodules.uicomponents → repos.components.path" || fail "components mapping wrong (got '$COMPONENTS_PATH')"
+[ "$WIKI_PATH" = "Packages/wiki" ] && pass "submodules.wiki → repos.wiki.path" || fail "wiki mapping wrong (got '$WIKI_PATH')"
+
+echo ""
+echo "→ 9. wiki.mode derived from legacy state"
+WIKI_MODE=$(echo "$OUTPUT" | jq -r '.v2.wiki.mode')
+[ "$WIKI_MODE" = "submodule" ] && pass "legacy submodules.wiki → wiki.mode=submodule" || fail "wiki.mode wrong (got '$WIKI_MODE')"
+
+# In-repo default case
+cat > "$TMP/v1-norepo.json" <<'EOF'
+{ "schemaVersion": "1.0.0", "project": { "slug": "flat" } }
+EOF
+WIKI_MODE2=$(node "$TMP/migrate.mjs" "$TMP/v1-norepo.json" | jq -r '.v2.wiki.mode')
+[ "$WIKI_MODE2" = "in-repo" ] && pass "no submodules → wiki.mode=in-repo" || fail "default wiki.mode wrong (got '$WIKI_MODE2')"
+
+echo ""
+echo "══ figma-config-schema smoke: $PASS passed, $FAIL failed ══"
+[ "$FAIL" -eq 0 ]