@ionivetech/mugiwara 0.5.5 → 0.6.1

package/scripts/mission-report.sh

@@ -1,74 +1,275 @@
 #!/usr/bin/env bash
-# scripts/mission-report.sh — generate human-readable mission report from state.json
-# Usage: mission-report.sh <mission>
+# scripts/mission-report.sh — generate aggregate mission report from state.json
+# + per-mission wave artifacts. Usage: mission-report.sh <mission>
+# Output: .mugiwara/reports/YYYY-MM-DD-<mission>.md — one-file summary of all waves.
+# Enriched: mission header, token budget (WARN/STOP flag), tasks (state or plan
+# doc fallback), gate/quality excerpt from 06-closure.md, evidence file list.
+# Every section degrades to n/a when state.json or results/ artifacts are absent.
 set -u
 
 MISSION="${1:-}"
 [ -z "$MISSION" ] && { echo "usage: mission-report.sh <mission>" >&2; exit 1; }
+case "$MISSION" in
+  *[!a-zA-Z0-9._-]*) echo "mission-report: invalid mission name \"$MISSION\" (allowlist: [a-zA-Z0-9._-])" >&2; exit 1 ;;
+esac
 
 MUGIWARA_DIR="${MUGIWARA_DIR:-.mugiwara}"
 STATE_FILE="$MUGIWARA_DIR/state.json"
 REPORT_DIR="$MUGIWARA_DIR/reports"
-REPORT_FILE="$REPORT_DIR/${MISSION}.md"
+RESULTS_DIR="$MUGIWARA_DIR/results/$MISSION"
+REVIEW_DIR="$MUGIWARA_DIR/review"
+ISSUES_DIR="$MUGIWARA_DIR/issues"
 
-[ -f "$STATE_FILE" ] || { echo "mission-report: $STATE_FILE not found" >&2; exit 1; }
-
-export STATE_FILE REPORT_DIR MISSION
+export STATE_FILE REPORT_DIR RESULTS_DIR REVIEW_DIR ISSUES_DIR MISSION
 node << 'NODE'
 const fs = require('fs');
 const path = require('path');
 
 const stateFile = process.env.STATE_FILE || ".mugiwara/state.json";
 const reportDir = process.env.REPORT_DIR || ".mugiwara/reports";
+const resultsDir = process.env.RESULTS_DIR || ".mugiwara/results/unknown";
+const reviewDir = process.env.REVIEW_DIR || ".mugiwara/review";
+const issuesDir = process.env.ISSUES_DIR || ".mugiwara/issues";
+const mugiDir = path.dirname(stateFile);
 const mission = process.env.MISSION || "unknown";
 
-if (!fs.existsSync(stateFile)) {
-  console.error("mission-report: " + stateFile + " not found");
-  process.exit(1);
+fs.mkdirSync(reportDir, { recursive: true });
+
+// state.json is optional — degrade gracefully, never hard-exit
+let s = null;
+if (fs.existsSync(stateFile)) {
+  try {
+    s = JSON.parse(fs.readFileSync(stateFile, 'utf8'));
+  } catch (e) {
+    console.error("mission-report: warning: " + stateFile + " unreadable — degraded report");
+  }
+} else {
+  console.error("mission-report: warning: " + stateFile + " not found — degraded report");
 }
 
-fs.mkdirSync(reportDir, { recursive: true });
-const s = JSON.parse(fs.readFileSync(stateFile, 'utf8'));
+const val = (obj, key, dflt) => {
+  if (!s || !obj) return dflt;
+  const v = obj[key];
+  return (v === undefined || v === null || v === "") ? dflt : v;
+};
 
-const reportFile = path.join(reportDir, mission + ".md");
 const now = new Date().toISOString().slice(0, 10);
-const lane = s.lane || "unknown";
-const mode = s.mode || "guided";
-const actor = s.actor || "unknown";
-const branch = s.branch || "unknown";
-const wave = s.wave || 0;
-const filesTouched = s.files_touched || 0;
-const locDelta = s.loc_delta || 0;
-const sensitive = s.sensitive_paths || [];
-const tasks = s.tasks || {};
-const blockers = s.blockers_open || 0;
-const healCycle = s.heal_cycle || 1;
-const tokens = s.tokens_est || 0;
-const budget = s.budget || 0;
-const evidence = s.evidence || [];
-const updated = s.updated_at || new Date().toISOString();
+const reportFile = path.join(reportDir, now + "-" + mission + ".md");
+const lane = val(s, 'lane', 'n/a');
+const laneReason = val(s, 'lane_reason', 'n/a');
+const mode = val(s, 'mode', 'n/a');
+const actor = val(s, 'actor', 'n/a');
+const branch = val(s, 'branch', 'n/a');
+const wave = val(s, 'wave', 'n/a');
+const filesTouched = val(s, 'files_touched', 0);
+const locDelta = val(s, 'loc_delta', 0);
+const sensitive = s ? (s.sensitive_paths || []) : [];
+const tasks = s ? (s.tasks || {}) : {};
+const blockers = val(s, 'blockers_open', 0);
+const healCycle = val(s, 'heal_cycle', 1);
+const tokens = Number(val(s, 'tokens_est', 0)) || 0;
+const tokensSource = val(s, 'tokens_source', 'n/a');
+const budget = Number(val(s, 'budget', 0)) || 0;
+const budgetStatus = val(s, 'budget_status', 'n/a');
+const evidence = s ? (s.evidence || []) : [];
+const updated = val(s, 'updated_at', now);
+
+// --- wave artifact scan: results/<mission>/NN-*.md with verdict sniffing ---
+const WAVE_LABEL = {
+  "01-execution": "Execute (Wave 3)",
+  "02-audit": "Checkpoint (Wave 4)",
+  "03-quality": "Quality (Wave 5)",
+  "04-gates": "Gates (Wave 6)",
+  "05-healing": "Healing (Wave 8)",
+  "06-closure": "Closure (Wave 9)",
+  "07-pr-verdict": "PR material",
+};
+
+const WAVE_FILES = new Set(Object.keys(WAVE_LABEL));
+
+function sniffVerdict(file) {
+  const text = fs.readFileSync(file, 'utf8');
+  const lines = text.split(/\r?\n/).filter(l => /pass|fail|✅|❌|verdict|go|no-go/i.test(l));
+  for (const l of lines) {
+    const m = l.match(/(NO-GO|GO|PASS|FAIL|✅|❌)/i);
+    if (m) return m[1].toUpperCase();
+  }
+  return "?";
+}
+
+const waveRows = [];
+if (fs.existsSync(resultsDir)) {
+  const files = fs.readdirSync(resultsDir).filter(f => f.endsWith('.md')).sort();
+  for (const f of files) {
+    const base = f.replace(/\.md$/, '');
+    if (!WAVE_FILES.has(base)) continue; // support files (todos.md, resume.md, eval.md, evidence logs) not in waves table
+    const label = WAVE_LABEL[base];
+    const verdict = sniffVerdict(path.join(resultsDir, f));
+    waveRows.push({ label, file: f, verdict });
+  }
+}
+
+// --- review + issues scan: aggregate findings count + open blockers ---
+let reviewFiles = [];
+let reviewFindings = 0;
+if (fs.existsSync(reviewDir)) {
+  reviewFiles = fs.readdirSync(reviewDir).filter(f => (f.startsWith(mission + "-") || f.startsWith(mission + "/")) && f.endsWith('.md'));
+  for (const f of reviewFiles) {
+    const text = fs.readFileSync(path.join(reviewDir, f), 'utf8');
+    reviewFindings += (text.match(/^\s*(?:#+\s*)?(?:🔴|🟠|🟡|⚪)(?:\s*\/\s*(?:🔴|🟠|🟡|⚪))?\s+.*/gm) || []).length;
+  }
+}
+
+let issueRows = [];
+if (fs.existsSync(issuesDir)) {
+  const issueFiles = fs.readdirSync(issuesDir).filter(f => (f.startsWith(mission + "-") || f.startsWith(mission + "/")) && f.endsWith('.md'));
+  for (const f of issueFiles) {
+    const text = fs.readFileSync(path.join(issuesDir, f), 'utf8');
+    for (const line of text.split(/\r?\n/)) {
+      if (line.trim().startsWith('|') && line.includes('|') && !line.includes('---')) {
+        const cells = line.split('|').map(c => c.trim()).filter(Boolean);
+        if (cells.length >= 5 && !/^wave$/i.test(cells[0])) issueRows.push(cells.join(" | "));
+      }
+    }
+  }
+}
+
+// --- tasks: state.json counts, plan-doc fallback (savepoint-style counting) ---
+function findPlan(mDir, m) {
+  const plansDir = path.join(mDir, 'plans');
+  if (!fs.existsSync(plansDir)) return null;
+  const direct = path.join(plansDir, m + '.md');
+  if (fs.existsSync(direct)) return direct;
+  const matches = fs.readdirSync(plansDir).filter(f => f.endsWith('-' + m + '.md'));
+  return matches.length ? path.join(plansDir, matches.sort()[0]) : null;
+}
+
+let tasksDone = tasks.done || 0;
+let tasksTotal = tasks.total || 0;
+let tasksSource = "state.json";
+if (tasksTotal === 0) {
+  const plan = findPlan(mugiDir, mission);
+  if (plan) {
+    const lines = fs.readFileSync(plan, 'utf8').split(/\r?\n/);
+    const done = lines.filter(l => l.includes('[x]')).length;
+    const total = done + lines.filter(l => l.includes('[ ]')).length;
+    if (total > 0) {
+      tasksDone = done;
+      tasksTotal = total;
+      tasksSource = "plan doc";
+    }
+  }
+}
+if (tasksDone === 0 && tasksTotal === 0) { tasksDone = 'n/a'; tasksTotal = 'n/a'; }
+
+// --- token budget flag: WARN/STOP line when status is not ok ---
+let budgetFlag = "";
+if (budgetStatus === "warn" || budgetStatus === "stop") {
+  const warnAt = Math.floor(budget * 3 / 2);
+  const stopAt = budget * 3;
+  if (budgetStatus === "stop") {
+    budgetFlag = "🛑 STOP: tokens " + tokens.toLocaleString() + " ≥ 3× budget " + budget.toLocaleString() + " (stop at " + stopAt.toLocaleString() + ") — halt; escalate to Luffy";
+  } else {
+    budgetFlag = "⚠ WARN: tokens " + tokens.toLocaleString() + " ≥ 1.5× budget " + budget.toLocaleString() + " (warn at " + warnAt.toLocaleString() + ") — checkpoint before continuing";
+  }
+}
+
+// --- gate/quality excerpt: headings + body from 06-closure.md, as-is ---
+function sectionExcerpt(file, heading) {
+  if (!fs.existsSync(file)) return null;
+  const lines = fs.readFileSync(file, 'utf8').split(/\r?\n/);
+  let collecting = false;
+  let content = 0;
+  const out = [];
+  for (const l of lines) {
+    if (/^##\s/.test(l)) {
+      if (collecting) break;
+      if (l.trim() === heading) { collecting = true; out.push(l); continue; }
+    } else if (collecting) {
+      if (l.trim()) {
+        out.push(l);
+        content++;
+        if (content >= 20) break; // cap excerpt
+      }
+    }
+  }
+  return collecting ? out : null;
+}
 
+const closureFile = path.join(resultsDir, "06-closure.md");
+const gateSec = sectionExcerpt(closureFile, "## Gate verdicts");
+const testsSec = sectionExcerpt(closureFile, "## Tests");
+
+// --- evidence file list: all .md artifacts in results/<mission>/ ---
+let evidenceFiles = [];
+if (fs.existsSync(resultsDir)) {
+  evidenceFiles = fs.readdirSync(resultsDir).filter(f => f.endsWith('.md')).sort();
+}
+
+// --- assemble report ---
 let report = "# Mission: " + mission + " . " + now + "\n\n";
-report += "**Lane** " + lane + " . **Mode** " + mode + " . **Actor** " + actor + " . **Branch** " + branch + "\n\n";
+
+report += "## Mission header\n\n| Field | Value |\n|-------|-------|\n";
+report += "| Mission | " + mission + " |\n";
+report += "| Branch | " + branch + " |\n";
+report += "| Lane | " + lane + " |\n";
+report += "| Lane reason | " + laneReason + " |\n";
+report += "| Mode | " + mode + " |\n";
+report += "| Wave | " + wave + " |\n";
+report += "| Actor | " + actor + " |\n\n";
+
+report += "## Token budget\n\n| Field | Value |\n|-------|-------|\n";
+report += "| Tokens (est) | " + tokens.toLocaleString() + " |\n";
+report += "| Tokens source | " + tokensSource + " |\n";
+report += "| Budget | " + budget.toLocaleString() + " |\n";
+report += "| Budget status | " + budgetStatus + " |\n";
+if (budgetFlag) report += "\n" + budgetFlag;
+report += "\n\n";
+
+report += "## Tasks\n\n| Field | Value |\n|-------|-------|\n";
+report += "| Done | " + tasksDone + " |\n";
+report += "| Total | " + tasksTotal + " |\n";
+report += "| Source | " + tasksSource + " |\n\n";
+
 report += "## What changed\n\n";
 report += filesTouched + " files, +" + locDelta + " LOC";
+if (sensitive.length) report += "\nSensitive paths: " + sensitive.join(", ");
+report += "\n\n";
 
-if (sensitive.length) {
-  report += "\nSensitive paths: " + sensitive.join(", ");
+report += "## Waves\n\n| Wave | Artifact | Verdict |\n|------|----------|---------|";
+if (waveRows.length) {
+  for (const r of waveRows) report += "\n| " + r.label + " | `" + r.file + "` | " + r.verdict + " |";
+} else {
+  report += "\n| (no wave artifacts found in `" + resultsDir + "`) | | |";
 }
+report += "\n\n";
 
-report += "\n\n## Gates\n\n| Gate | Verdict | Evidence |\n|------|---------|----------|";
-for (const e of evidence) {
-  report += "\n| \u2014 | PASS | " + e + " |";
-}
+report += "## Gate & quality\n\n";
+if (gateSec) report += gateSec.join("\n") + "\n";
+if (testsSec) report += (gateSec ? "\n" : "") + testsSec.join("\n") + "\n";
+if (!gateSec && !testsSec) report += "n/a\n";
+report += "\n";
+
+report += "## Evidence files\n\n";
+report += evidenceFiles.length ? evidenceFiles.map(f => "- " + f).join("\n") : "n/a";
+report += "\n\n";
 
-report += "\n\n## State\n\n| Field | Value |\n|-------|-------|\n";
+report += "## Review & blockers\n\n";
+report += "Review + security files: " + (reviewFiles.length ? reviewFiles.join(", ") : "none") + "\n";
+report += "Findings: " + reviewFindings + "\n";
+report += "Blocker ledger rows: " + issueRows.length + (issueRows.length ? "\n" + issueRows.map(r => "- " + r).join("\n") : "");
+report += "\n\n";
+
+report += "## State\n\n| Field | Value |\n|-------|-------|\n";
 report += "| Wave | " + wave + " |\n";
 report += "| Tasks | " + (tasks.done || 0) + "/" + (tasks.total || 0) + " done |\n";
 report += "| Blockers open | " + blockers + " |\n";
 report += "| Heal cycles | " + healCycle + " |\n";
 report += "| Tokens used | " + tokens.toLocaleString() + " / " + budget.toLocaleString() + " |\n\n";
-report += "## Updated\n\n" + updated + "\n";
+
+report += "## Evidence\n\n";
+report += evidence.length ? evidence.map(e => "- " + e).join("\n") : "n/a";
+report += "\n\n## Updated\n\n" + updated + "\n";
 
 fs.writeFileSync(reportFile, report);
 console.log("\u2713 mission report: " + reportFile);

package/scripts/onboard.ts

@@ -0,0 +1,292 @@
+#!/usr/bin/env bun
+// scripts/onboard.ts — Mugiwara onboarding wizard (10 fixed questions, no network)
+import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { createInterface } from "node:readline";
+
+const root = join(import.meta.dirname, "..");
+const mugiwaraDir = join(root, ".mugiwara");
+const configPath = join(mugiwaraDir, "config");
+const onboardPath = join(mugiwaraDir, "onboard.json");
+
+function ask(rl: import("node:readline").Interface, prompt: string): Promise<string> {
+  return new Promise((resolve) => {
+    rl.question(prompt, (answer) => resolve(answer.trim()));
+  });
+}
+
+async function confirm(rl: import("node:readline").Interface, prompt: string): Promise<boolean> {
+  const a = await ask(rl, prompt);
+  return a.toLowerCase() === "y" || a.toLowerCase() === "yes";
+}
+
+async function pick(
+  rl: import("node:readline").Interface,
+  prompt: string,
+  options: string[],
+): Promise<number> {
+  while (true) {
+    const a = await ask(rl, prompt);
+    const n = Number.parseInt(a, 10);
+    if (!Number.isNaN(n) && n >= 1 && n <= options.length) return n;
+    console.log(`  Enter a number 1–${options.length}`);
+  }
+}
+
+async function main() {
+  // --help / no-tty guard
+  if (process.argv.includes("--help") || process.argv.includes("-h")) {
+    console.log("Usage: bun scripts/onboard.ts");
+    console.log("Runs the Mugiwara onboarding wizard (10 fixed questions).");
+    console.log("Writes .mugiwara/config and .mugiwara/onboard.json.");
+    process.exit(0);
+  }
+
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+
+  try {
+    console.log("");
+    console.log("╔══════════════════════════════════════╗");
+    console.log("║   Mugiwara Onboarding Wizard         ║");
+    console.log("╚══════════════════════════════════════╝");
+    console.log("");
+
+    // Check for existing config
+    if (existsSync(configPath)) {
+      const redo = await confirm(
+        rl,
+        "Existing .mugiwara/config found. Re-onboard? (y/n): ",
+      );
+      if (!redo) {
+        console.log("Onboarding cancelled. Config preserved.");
+        process.exit(0);
+      }
+      console.log("");
+    }
+
+    const answers: Record<string, unknown> = {
+      started_at: new Date().toISOString(),
+    };
+
+    // ---- Phase 1: Project Context ----
+    console.log("── Phase 1: Project Context ──");
+    console.log("");
+
+    const q1 = await pick(rl, "Q1 — Project type:\n  [1] Web application\n  [2] Mobile application\n  [3] CLI tool\n  [4] Library/SDK\n  [5] Backend service / API\n  [6] Other\n  > ", [
+      "Web application",
+      "Mobile application",
+      "CLI tool",
+      "Library/SDK",
+      "Backend service / API",
+      "Other",
+    ]);
+    answers.project_type = q1;
+    console.log("");
+
+    const q2 = await pick(rl, "Q2 — Primary language:\n  [1] TypeScript\n  [2] JavaScript\n  [3] Python\n  [4] Go\n  [5] Rust\n  [6] Java\n  [7] Other\n  > ", [
+      "TypeScript",
+      "JavaScript",
+      "Python",
+      "Go",
+      "Rust",
+      "Java",
+      "Other",
+    ]);
+    answers.primary_language = q2;
+    console.log("");
+
+    const q3 = await pick(rl, "Q3 — Team size:\n  [1] Solo\n  [2] 2–5\n  [3] 6–15\n  [4] 16+\n  > ", [
+      "Solo",
+      "2–5",
+      "6–15",
+      "16+",
+    ]);
+    answers.team_size = q3;
+    console.log("");
+
+    const q4 = await pick(rl, "Q4 — Git workflow:\n  [1] Trunk-based (feature/{type}-{issue}-{slug})\n  [2] GitFlow (feature/{slug})\n  [3] GitHub Flow (feat/{slug})\n  [4] Other (feature/{slug})\n  > ", [
+      "trunk-based",
+      "gitflow",
+      "github-flow",
+      "other",
+    ]);
+    answers.git_workflow = q4;
+    console.log("");
+
+    const q5 = await pick(rl, "Q5 — CI/CD platform:\n  [1] GitHub Actions\n  [2] GitLab CI\n  [3] CircleCI\n  [4] Jenkins\n  [5] None / manual\n  [6] Other\n  > ", [
+      "GitHub Actions",
+      "GitLab CI",
+      "CircleCI",
+      "Jenkins",
+      "None / manual",
+      "Other",
+    ]);
+    answers.ci_cd = q5;
+    console.log("");
+
+    // ---- Phase 2: Mugiwara Preferences ----
+    console.log("── Phase 2: Mugiwara Preferences ──");
+    console.log("");
+
+    const q6 = await pick(rl, "Q6 — Autonomy mode:\n  [1] guided — ask before every wave transition\n  [2] semi — auto-advance through waves, pause on failures\n  [3] auto — full auto-pilot\n  > ", [
+      "guided",
+      "semi",
+      "auto",
+    ]);
+    answers.autonomy_mode = q6;
+    console.log("");
+
+    const q7 = await ask(rl, "Q7 — Agents to enable (comma-separated or 'all'):\n  Available: brainstorm, plan, execute, checkpoint, quality, gates, review, security, healing\n  Default: all\n  > ");
+    answers.enabled_agents = q7 || "all";
+    console.log("");
+
+    const q8a = await pick(rl, "Q8a — Code review depth:\n  [1] full — breaking-change map, five-axis review, ≤3 cycles\n  [2] standard — five-axis review, 1 cycle\n  [3] quick — diff-only, no caller-map\n  > ", [
+      "full",
+      "standard",
+      "quick",
+    ]);
+    answers.review_depth = q8a;
+    console.log("");
+
+    const q8b = await pick(rl, "Q8b — Quality check depth:\n  [1] full — format, lint, typecheck, test, build\n  [2] standard — lint, typecheck, test\n  [3] quick — test only\n  > ", [
+      "full",
+      "standard",
+      "quick",
+    ]);
+    answers.quality_depth = q8b;
+    console.log("");
+
+    console.log("Q9 — Test coverage threshold:");
+    const q9 = await pick(rl, "  [1] 90/80 — new code 90%, modified 80%\n  [2] 80/70 — new code 80%, modified 70%\n  [3] custom — enter your own values\n  [4] none — 0/0, no coverage enforcement\n  > ", [
+      "90/80",
+      "80/70",
+      "custom",
+      "none",
+    ]);
+    let coverageNew = 90;
+    let coverageModified = 80;
+    if (q9 === 1) {
+      coverageNew = 90;
+      coverageModified = 80;
+    } else if (q9 === 2) {
+      coverageNew = 80;
+      coverageModified = 70;
+    } else if (q9 === 3) {
+      const cNew = await ask(rl, "  Enter coverage threshold for new code (%): ");
+      const cMod = await ask(rl, "  Enter coverage threshold for modified code (%): ");
+      coverageNew = Number.parseInt(cNew, 10) || 0;
+      coverageModified = Number.parseInt(cMod, 10) || 0;
+    } else {
+      coverageNew = 0;
+      coverageModified = 0;
+    }
+    answers.coverage_threshold = q9;
+    answers.coverage_new = coverageNew;
+    answers.coverage_modified = coverageModified;
+    console.log("");
+
+    const q10 = await pick(rl, "Q10 — Commit style:\n  [1] Conventional Commits (feat:, fix:, chore:, docs:)\n  [2] Semantic (type(scope): message)\n  [3] Free-form\n  > ", [
+      "conventional",
+      "semantic",
+      "free-form",
+    ]);
+    answers.commit_style = q10;
+    answers.completed_at = new Date().toISOString();
+    console.log("");
+
+    // ---- Branch name format ----
+    const branchFormats: Record<number, string> = {
+      1: "feature/{type}-{issue}-{slug}",
+      2: "feature/{slug}",
+      3: "feat/{slug}",
+      4: "feature/{slug}",
+    };
+    const branch = branchFormats[q4] || "feature/{slug}";
+
+    // ---- Autonomy mode ----
+    const modes: Record<number, string> = { 1: "guided", 2: "semi", 3: "auto" };
+    const mode = modes[q6] || "semi";
+
+    // ---- Commit style ----
+    const commitStyles: Record<number, string> = { 1: "conventional", 2: "semantic", 3: "free-form" };
+    const commit = commitStyles[q10] || "conventional";
+
+    // ---- Review depth ----
+    const reviewDepths: Record<number, string> = { 1: "full", 2: "standard", 3: "quick" };
+    const reviewDepth = reviewDepths[q8a] || "standard";
+
+    // ---- Quality depth ----
+    const qualityDepths: Record<number, string> = { 1: "full", 2: "standard", 3: "quick" };
+    const qualityDepth = qualityDepths[q8b] || "standard";
+
+    // ---- Write config ----
+    if (!existsSync(mugiwaraDir)) mkdirSync(mugiwaraDir, { recursive: true });
+
+    const config = {
+      mode,
+      branch,
+      coverage_new: coverageNew,
+      coverage_modified: coverageModified,
+      commit,
+      review_depth: reviewDepth,
+      quality_depth: qualityDepth,
+      enabled_agents: answers.enabled_agents,
+    };
+
+    writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n");
+    writeFileSync(onboardPath, JSON.stringify(answers, null, 2) + "\n");
+
+    // ---- Summary ----
+    const qLabels: Record<string, Record<number, string>> = {
+      project_type: {
+        1: "Web application",
+        2: "Mobile application",
+        3: "CLI tool",
+        4: "Library/SDK",
+        5: "Backend service / API",
+        6: "Other",
+      },
+      primary_language: {
+        1: "TypeScript",
+        2: "JavaScript",
+        3: "Python",
+        4: "Go",
+        5: "Rust",
+        6: "Java",
+        7: "Other",
+      },
+      team_size: { 1: "Solo", 2: "2–5", 3: "6–15", 4: "16+" },
+      git_workflow: { 1: "Trunk-based", 2: "GitFlow", 3: "GitHub Flow", 4: "Other" },
+      ci_cd: { 1: "GitHub Actions", 2: "GitLab CI", 3: "CircleCI", 4: "Jenkins", 5: "None", 6: "Other" },
+      autonomy_mode: { 1: "guided", 2: "semi", 3: "auto" },
+      review_depth: { 1: "full", 2: "standard", 3: "quick" },
+      quality_depth: { 1: "full", 2: "standard", 3: "quick" },
+      coverage_threshold: { 1: "90/80", 2: "80/70", 3: "custom", 4: "none" },
+      commit_style: { 1: "Conventional", 2: "Semantic", 3: "Free-form" },
+    };
+
+    console.log("╔══════════════════════════════════════╗");
+    console.log("║   Onboarding Complete                ║");
+    console.log("╚══════════════════════════════════════╝");
+    console.log("");
+    console.log("  Project type:     ", qLabels.project_type[q1]);
+    console.log("  Primary language: ", qLabels.primary_language[q2]);
+    console.log("  Team size:        ", qLabels.team_size[q3]);
+    console.log("  Git workflow:     ", qLabels.git_workflow[q4]);
+    console.log("  CI/CD:            ", qLabels.ci_cd[q5]);
+    console.log("  Autonomy mode:    ", qLabels.autonomy_mode[q6]);
+    console.log("  Enabled agents:   ", answers.enabled_agents);
+    console.log("  Review depth:     ", qLabels.review_depth[q8a]);
+    console.log("  Quality depth:    ", qLabels.quality_depth[q8b]);
+    console.log("  Coverage:         ", q9 === 3 ? `${coverageNew}/${coverageModified}` : qLabels.coverage_threshold[q9]);
+    console.log("  Commit style:     ", qLabels.commit_style[q10]);
+    console.log("");
+    console.log(`  Config written:   ${configPath}`);
+    console.log(`  Audit trail:      ${onboardPath}`);
+    console.log("");
+  } finally {
+    rl.close();
+  }
+}
+
+main();