whale-igniter 1.2.3 → 1.3.0

package/README.md

@@ -1,5 +1,5 @@
 <p align="center">
-  <img src="https://cdn.jsdelivr.net/npm/whale-igniter@1.2.1/brand/lockup.svg" alt="Whale Igniter" width="640">
+  <img src="https://cdn.jsdelivr.net/npm/whale-igniter@1.3.0/brand/lockup.svg" alt="Whale Igniter" width="640">
 </p>
 
 <p align="center">
@@ -50,16 +50,33 @@ my-app/
 `intelligence/*.json` is the source of truth. Markdown files are rendered
 from it so agents always read current project state.
 
+## What's new in v1.3
+
+**UI references library** — curated, copy-paste component references ship with the tool. Run `whale references add forms` (or `--all`) to install them into your project. CLAUDE.md and MCP tools automatically expose the files to agents.
+
+**Cross-framework drift detection** — `whale insights drift spacing|color|radii` scans CSS, inline styles, Vue/Svelte style blocks and JSX props for values that don't match your foundations. Run `--review` to accept exceptions as refinements or flag them for refactor.
+
+**Human-language wizard** — `whale ignite --interactive` now asks plain-English questions (what are you building, which framework, team size) and maps answers to a sensible config automatically.
+
+**Template extraction** — wiki templates moved to `src/templates/` as composable render functions. CLAUDE.md is now structured as three clear sections: what the project is, what to read, and how to work here.
+
+**`whale changes --since <ref>`** — shows what changed in intelligence stores (decisions, components, refinements) since any git ref, ISO date, or `HEAD~1`.
+
 ## Core Commands
 
 | Command | Use it when you want to... |
 | --- | --- |
 | `whale ignite my-app` | Create a new Whale workspace |
+| `whale ignite my-app --interactive` | Wizard: project type, stack, team size, packs |
 | `whale adopt` | Scan an existing React/Tailwind project |
 | `whale remember` | Regenerate agent context and wiki |
 | `whale check` | Run validation and project insights |
 | `whale improve` | Ask Selene for improvement suggestions |
 | `whale explain` | Generate docs and AI-readable context |
+| `whale references add --all` | Install UI component reference library |
+| `whale insights drift spacing` | Find off-grid spacing across CSS and JSX |
+| `whale insights drift spacing --review` | Interactively accept or queue each drift issue |
+| `whale changes --since HEAD~5` | Show what changed in intelligence stores |
 | `whale team` | See active operating roles/packs |
 | `whale create component Hero` | Generate a typed React component |
 | `whale mcp config --client cursor` | Configure an MCP client |
@@ -126,6 +143,6 @@ Brand assets ship in `brand/` and are included in the npm package.
 - License: MIT
 
 <p align="center">
-  <img src="https://cdn.jsdelivr.net/npm/whale-igniter@1.2.1/brand/logo.svg" alt="" width="44"><br>
+  <img src="https://cdn.jsdelivr.net/npm/whale-igniter@1.3.0/brand/logo.svg" alt="" width="44"><br>
   <sub><b>Whale Igniter</b> · map the project before the agent moves</sub>
 </p>

package/dist/analyzer/insights.js

@@ -253,6 +253,145 @@ function analyzeGridDrift(config, observations) {
     return [];
 }
 // ---------------------------------------------------------------------------
+// Cross-framework drift analyzers (Block D)
+// ---------------------------------------------------------------------------
+const SPACING_PROPERTIES = new Set([
+    "padding", "padding-top", "padding-right", "padding-bottom", "padding-left",
+    "margin", "margin-top", "margin-right", "margin-bottom", "margin-left",
+    "gap", "column-gap", "row-gap"
+]);
+const COLOR_PROPERTIES = new Set(["color", "background-color", "border-color"]);
+const RADIUS_PROPERTIES = new Set([
+    "border-radius",
+    "border-top-left-radius", "border-top-right-radius",
+    "border-bottom-left-radius", "border-bottom-right-radius"
+]);
+function isRefinedSpacing(refinements) {
+    return refinements.some((r) => r.scope?.issueType === "spacing");
+}
+export function analyzeSpacingDrift(observations, config, refinements = []) {
+    if (isRefinedSpacing(refinements))
+        return [];
+    const grid = config.foundations?.grid ?? 8;
+    const drifting = observations.filter((o) => SPACING_PROPERTIES.has(o.property) &&
+        o.pxValue != null &&
+        o.pxValue !== 0 &&
+        o.pxValue % grid !== 0);
+    if (drifting.length === 0)
+        return [];
+    // Group by file
+    const byFile = new Map();
+    for (const obs of drifting) {
+        const key = obs.file;
+        if (!byFile.has(key))
+            byFile.set(key, []);
+        byFile.get(key).push(obs);
+    }
+    const insights = [];
+    for (const [file, items] of byFile) {
+        const severity = items.length >= 3 ? "warning" : "info";
+        const fileShort = file.split("/").slice(-2).join("/");
+        insights.push({
+            id: `drift.spacing.${Buffer.from(file).toString("base64").slice(0, 12)}`,
+            category: "tokens",
+            severity,
+            title: `${items.length} off-grid spacing value(s) in ${fileShort}`,
+            detail: `Grid is ${grid}px. Found values that are not multiples: ${[...new Set(items.map((o) => o.value))].slice(0, 5).join(", ")}.`,
+            evidence: items.slice(0, 5).map((o) => `${fileShort}:${o.line} — ${o.property}: ${o.value}`),
+            action: `Run \`whale insights drift spacing --review\` to accept as refinement or flag for refactor.`
+        });
+    }
+    return insights;
+}
+export function analyzeColorDrift(observations, _config, refinements = []) {
+    const colorObs = observations.filter((o) => COLOR_PROPERTIES.has(o.property) &&
+        !o.value.startsWith("var(") &&
+        /^#[0-9a-fA-F]{3,8}$/.test(o.value));
+    if (colorObs.length === 0)
+        return [];
+    // Derive reference palette: top-10 most frequent hex values
+    const freq = new Map();
+    for (const obs of colorObs) {
+        const hex = obs.value.toLowerCase();
+        freq.set(hex, (freq.get(hex) ?? 0) + 1);
+    }
+    const palette = new Set([...freq.entries()]
+        .sort((a, b) => b[1] - a[1])
+        .slice(0, 10)
+        .map(([hex]) => hex));
+    // Check refinements for color exceptions
+    const hasColorRefinement = refinements.some((r) => r.scope?.issueType === "hex");
+    if (hasColorRefinement)
+        return [];
+    // Drifting = hex that is NOT in the top-10 palette
+    const drifting = colorObs.filter((o) => !palette.has(o.value.toLowerCase()));
+    if (drifting.length === 0)
+        return [];
+    // Group by hue family (first 2 hex digits after #)
+    const byHue = new Map();
+    for (const obs of drifting) {
+        const hue = obs.value.slice(1, 3).toLowerCase();
+        if (!byHue.has(hue))
+            byHue.set(hue, []);
+        byHue.get(hue).push(obs);
+    }
+    const insights = [];
+    for (const [hue, items] of byHue) {
+        const severity = items.length >= 3 ? "warning" : "info";
+        const uniqueValues = [...new Set(items.map((o) => o.value))];
+        insights.push({
+            id: `drift.color.${hue}`,
+            category: "tokens",
+            severity,
+            title: `${items.length} color value(s) outside the project palette (hue ~#${hue})`,
+            detail: `Colors not in the top-10 palette: ${uniqueValues.slice(0, 4).join(", ")}.`,
+            evidence: items.slice(0, 5).map((o) => {
+                const short = o.file.split("/").slice(-2).join("/");
+                return `${short}:${o.line} — ${o.property}: ${o.value}`;
+            }),
+            action: `Run \`whale insights drift color --review\` to accept as refinement or flag for refactor.`
+        });
+    }
+    return insights;
+}
+export function analyzeRadiiDrift(observations, config, refinements = []) {
+    const hasRadiusRefinement = refinements.some((r) => r.scope?.issueType === "radius");
+    if (hasRadiusRefinement)
+        return [];
+    const control = config.foundations?.radius?.control ?? 2;
+    const container = config.foundations?.radius?.container ?? 4;
+    const drifting = observations.filter((o) => RADIUS_PROPERTIES.has(o.property) &&
+        o.pxValue != null &&
+        o.pxValue !== 0 &&
+        o.pxValue !== 9999 &&
+        o.pxValue !== control &&
+        o.pxValue !== container);
+    if (drifting.length === 0)
+        return [];
+    // Group by px value to show the spread
+    const byValue = new Map();
+    for (const obs of drifting) {
+        const key = obs.pxValue;
+        if (!byValue.has(key))
+            byValue.set(key, []);
+        byValue.get(key).push(obs);
+    }
+    const spread = [...byValue.keys()].sort((a, b) => a - b);
+    const severity = drifting.length >= 5 ? "warning" : "info";
+    return [{
+            id: "drift.radii",
+            category: "tokens",
+            severity,
+            title: `${drifting.length} border-radius value(s) outside foundations (${control}px / ${container}px)`,
+            detail: `Values found: ${spread.map((v) => `${v}px`).join(", ")}. Expected: ${control}px (controls) or ${container}px (containers).`,
+            evidence: drifting.slice(0, 5).map((o) => {
+                const short = o.file.split("/").slice(-2).join("/");
+                return `${short}:${o.line} — ${o.property}: ${o.value}`;
+            }),
+            action: `Run \`whale insights drift radii --review\` to accept as refinement or flag for refactor.`
+        }];
+}
+// ---------------------------------------------------------------------------
 // Main entry
 // ---------------------------------------------------------------------------
 export function analyze(input) {
@@ -264,6 +403,11 @@ export function analyze(input) {
     all.push(...analyzeTokenDrift(input.observations));
     all.push(...analyzeDecisionTension(input.decisions));
     all.push(...analyzeGridDrift(input.config, input.observations));
+    if (input.styleObservations) {
+        all.push(...analyzeSpacingDrift(input.styleObservations, input.config, input.refinements));
+        all.push(...analyzeColorDrift(input.styleObservations, input.config, input.refinements));
+        all.push(...analyzeRadiiDrift(input.styleObservations, input.config, input.refinements));
+    }
     // Sort by severity (critical > warning > info), then by category for stable output.
     const sevRank = { critical: 0, warning: 1, info: 2 };
     all.sort((a, b) => {

package/dist/commands/adopt.js

@@ -1,12 +1,14 @@
 import path from "node:path";
 import fs from "fs-extra";
 import ora from "ora";
+import prompts from "prompts";
 import { resolveTarget } from "../utils/paths.js";
 import { scanComponents } from "../scanner/componentScanner.js";
 import { aggregateTailwind, detectTailwindConfig } from "../scanner/tailwindScanner.js";
 import { inferFoundations } from "../scanner/foundationInferrer.js";
 import { loadProposals, saveProposals, upsertProposal, fingerprintComponent, fingerprintFoundations, pendingProposals } from "../utils/proposals.js";
 import { loadConfig, saveConfig, DEFAULT_CONFIG } from "../utils/config.js";
+import { getAiAvailability } from "../utils/aiAvailability.js";
 import { ui } from "../ui/index.js";
 const SCANNER_VERSION = "1.1.0";
 export async function adoptCommand(targetArg, options = {}) {
@@ -140,6 +142,24 @@ export async function adoptCommand(targetArg, options = {}) {
         if (!(await fs.pathExists(p)))
             await fs.writeJson(p, [], { spaces: 2 });
     }
+    // ---- Step 7: optional Selene enrichment -----------------------------------
+    const ai = await getAiAvailability(target);
+    if (ai.available) {
+        console.log();
+        const { doEnrich } = await prompts({
+            type: "confirm",
+            name: "doEnrich",
+            message: "Use Selene to add prose descriptions to the inferred foundations? (requires API key)",
+            initial: false
+        });
+        if (doEnrich) {
+            console.log(ui.note("Selene enrichment: run `whale selene describe` after review to add descriptions."));
+        }
+    }
+    else {
+        console.log();
+        console.log(ui.muted("AI features available with Claude Code, Codex, or an API key."));
+    }
     // ---- Summary --------------------------------------------------------------
     console.log();
     console.log(ui.section("Proposals"));

package/dist/commands/changes.js

@@ -0,0 +1,127 @@
+import { execSync } from "node:child_process";
+import { resolveTarget } from "../utils/paths.js";
+import { loadDecisions } from "../utils/decisions.js";
+import { loadComponents } from "../utils/components.js";
+import { loadRefinements } from "../utils/refinements.js";
+import { ui } from "../ui/index.js";
+const INTELLIGENCE_FILES = [
+    "intelligence/decisions.json",
+    "intelligence/components.json",
+    "intelligence/refinements.json",
+    "whale.config.json"
+];
+function gitDiffFiles(target, since) {
+    try {
+        const result = execSync(`git diff --name-only ${since} HEAD -- ${INTELLIGENCE_FILES.join(" ")}`, {
+            cwd: target,
+            encoding: "utf8"
+        });
+        return result.trim().split("\n").filter(Boolean);
+    }
+    catch {
+        return [];
+    }
+}
+function gitFileAtRef(target, ref, file) {
+    try {
+        const raw = execSync(`git show ${ref}:${file}`, { cwd: target, encoding: "utf8" });
+        return JSON.parse(raw);
+    }
+    catch {
+        return [];
+    }
+}
+export async function changesCommand(opts) {
+    const target = resolveTarget(opts.target);
+    const since = opts.since ?? "HEAD~1";
+    const changedFiles = gitDiffFiles(target, since);
+    if (changedFiles.length === 0) {
+        console.log(ui.note(`No intelligence store changes since ${since}`));
+        return;
+    }
+    console.log(ui.section(`Changes since ${since}`));
+    const summary = {
+        decisions: { added: [], removed: [], modified: [] },
+        components: { added: [], removed: [] },
+        refinements: { added: [], removed: [] },
+        configChanged: false
+    };
+    if (changedFiles.includes("whale.config.json")) {
+        summary.configChanged = true;
+    }
+    if (changedFiles.includes("intelligence/decisions.json")) {
+        const before = gitFileAtRef(target, since, "intelligence/decisions.json");
+        const after = await loadDecisions(target);
+        const beforeIds = new Map(before.map((d) => [d.id, d.title]));
+        const afterIds = new Map(after.map((d) => [d.id, d.title]));
+        for (const [id, title] of afterIds) {
+            if (!beforeIds.has(id))
+                summary.decisions.added.push(title);
+        }
+        for (const [id, title] of beforeIds) {
+            if (!afterIds.has(id))
+                summary.decisions.removed.push(title);
+            else if (afterIds.get(id) !== title)
+                summary.decisions.modified.push(title);
+        }
+    }
+    if (changedFiles.includes("intelligence/components.json")) {
+        const before = gitFileAtRef(target, since, "intelligence/components.json");
+        const after = await loadComponents(target);
+        const beforeNames = new Set(before.map((c) => c.name));
+        const afterNames = new Set(after.map((c) => c.name));
+        for (const name of afterNames) {
+            if (!beforeNames.has(name))
+                summary.components.added.push(name);
+        }
+        for (const name of beforeNames) {
+            if (!afterNames.has(name))
+                summary.components.removed.push(name);
+        }
+    }
+    if (changedFiles.includes("intelligence/refinements.json")) {
+        const before = gitFileAtRef(target, since, "intelligence/refinements.json");
+        const after = await loadRefinements(target);
+        const beforeIds = new Set(before.map((r) => r.id));
+        const afterIds = new Set(after.map((r) => r.id));
+        const beforeNotes = new Map(before.map((r) => [r.id, r.note]));
+        for (const r of after) {
+            if (!beforeIds.has(r.id))
+                summary.refinements.added.push(r.note);
+        }
+        for (const [id, note] of beforeNotes) {
+            if (!afterIds.has(id))
+                summary.refinements.removed.push(note);
+        }
+    }
+    // ---- Render ----------------------------------------------------------------
+    if (summary.configChanged) {
+        console.log(ui.note("whale.config.json changed"));
+    }
+    const { decisions: d } = summary;
+    if (d.added.length || d.removed.length || d.modified.length) {
+        console.log(ui.section("Decisions"));
+        for (const t of d.added)
+            console.log(ui.ok(`+ ${t}`));
+        for (const t of d.removed)
+            console.log(ui.fail(`- ${t}`));
+        for (const t of d.modified)
+            console.log(ui.warn(`~ ${t}`));
+    }
+    const { components: c } = summary;
+    if (c.added.length || c.removed.length) {
+        console.log(ui.section("Components"));
+        for (const n of c.added)
+            console.log(ui.ok(`+ ${n}`));
+        for (const n of c.removed)
+            console.log(ui.fail(`- ${n}`));
+    }
+    const { refinements: r } = summary;
+    if (r.added.length || r.removed.length) {
+        console.log(ui.section("Refinements"));
+        for (const n of r.added)
+            console.log(ui.ok(`+ ${n}`));
+        for (const n of r.removed)
+            console.log(ui.fail(`- ${n}`));
+    }
+}

package/dist/commands/ignite.js

@@ -5,6 +5,9 @@ import { loadConfig, saveConfig, DEFAULT_CONFIG } from "../utils/config.js";
 import { getPack, listPacks } from "../utils/registry.js";
 import { validateCss } from "../validators/cssValidator.js";
 import { generateWiki } from "../generators/wikiGenerator.js";
+import { appendDecision } from "../utils/decisions.js";
+import { getAiAvailability } from "../utils/aiAvailability.js";
+import { mapWizardAnswers, suggestUiCategories } from "../utils/wizardMapping.js";
 import { ui } from "../ui/index.js";
 import { PACKAGE_VERSION } from "../version.js";
 const OPINIONATED_PACKS = ["lighthouse", "forge", "scribe"];
@@ -20,8 +23,11 @@ export async function igniteCommand(projectName = "whale-project", options = {})
     console.log();
     // ---- Resolve config based on mode -----------------------------------------
     let config;
+    let projectIntentNote;
     if (mode === "interactive") {
-        config = await runWizard(projectName);
+        const result = await runWizard(projectName);
+        config = result.config;
+        projectIntentNote = result.projectIntentNote;
     }
     else if (mode === "minimal") {
         config = {
@@ -43,6 +49,16 @@ export async function igniteCommand(projectName = "whale-project", options = {})
     const target = await initCommand(projectName, { config, silent: true });
     const targetRel = path.relative(process.cwd(), target) || ".";
     console.log(ui.ok(`Workspace created at ${ui.path(targetRel)}`));
+    // ---- Step 1b: record free-text project intent as first decision ------------
+    if (projectIntentNote) {
+        await appendDecision(target, {
+            title: "Project intent",
+            category: "product",
+            context: "Captured at project creation via `whale ignite --interactive`.",
+            decision: projectIntentNote
+        });
+        console.log(ui.ok("Project intent recorded as first decision."));
+    }
     // ---- Step 2: confirm packs against registry -------------------------------
     console.log();
     console.log(ui.section("Packs"));
@@ -58,6 +74,9 @@ export async function igniteCommand(projectName = "whale-project", options = {})
         validPacks.push(name);
         packLines.push(`${ui.glyph.check} ${ui.code(name)} ${ui.muted(`(${pack.kind})`)} — ${pack.description}`);
     }
+    if (packLines.length === 0) {
+        packLines.push(ui.muted("(no packs selected)"));
+    }
     console.log(ui.indent(packLines.join("\n")));
     finalConfig.packs = validPacks;
     finalConfig.ignited = {
@@ -127,86 +146,133 @@ export async function igniteCommand(projectName = "whale-project", options = {})
     console.log();
 }
 // ---------------------------------------------------------------------------
-// Interactive wizard — unchanged logic, just uses ui for the header.
+// Interactive wizard — human-language questions, technical config is derived.
 // ---------------------------------------------------------------------------
 async function runWizard(defaultName) {
     console.log(ui.muted("Answer a few questions to shape your workspace. Ctrl+C to cancel."));
     console.log();
-    const allPacks = listPacks();
-    const answers = await prompts([
-        { type: "text", name: "projectName", message: "Project name:", initial: defaultName },
-        {
-            type: "select",
-            name: "projectType",
-            message: "Project type:",
-            choices: [
-                { title: "Landing page", value: "landing-page" },
-                { title: "Web app", value: "web-app" },
-                { title: "Component library", value: "component-library" },
-                { title: "Documentation site", value: "docs-site" },
-                { title: "Other", value: "other" }
-            ]
-        },
-        {
-            type: "select",
-            name: "stack",
-            message: "Styling stack:",
-            choices: [
-                { title: "Plain CSS", value: "css" },
-                { title: "Tailwind", value: "tailwind" },
-                { title: "SCSS / Sass", value: "scss" },
-                { title: "CSS-in-JS (styled-components, emotion, ...)", value: "css-in-js" }
-            ]
-        },
-        { type: "number", name: "grid", message: "Grid unit (px):", initial: 8, min: 1, max: 32 },
-        { type: "number", name: "radiusControl", message: "Radius for controls (buttons, inputs):", initial: 2, min: 0, max: 64 },
-        { type: "number", name: "radiusContainer", message: "Radius for containers (cards, modals):", initial: 4, min: 0, max: 64 },
-        {
-            type: "multiselect",
-            name: "packs",
-            message: "Packs to install:",
-            instructions: false,
-            hint: "space to toggle, enter to confirm",
-            choices: allPacks.map((p) => ({
-                title: `${p.name} (${p.kind})`,
-                description: p.description,
-                value: p.name,
-                selected: OPINIONATED_PACKS.includes(p.name)
-            }))
-        },
-        {
-            type: "multiselect",
-            name: "aiTargets",
-            message: "AI agents to generate context for:",
-            instructions: false,
-            hint: "space to toggle, enter to confirm",
-            choices: [
-                { title: "Claude (CLAUDE.md)", value: "claude", selected: true },
-                { title: "Codex / Generic agent (AGENTS.md)", value: "codex" },
-                { title: "Cursor (.cursorrules)", value: "cursor" },
-                { title: "GitHub Copilot (.github/copilot-instructions.md)", value: "copilot" }
-            ]
-        }
-    ], {
-        onCancel: () => {
-            console.log();
-            console.log(ui.warn("Ignite cancelled."));
-            process.exit(130);
+    const onCancel = () => {
+        console.log();
+        console.log(ui.warn("Ignite cancelled."));
+        process.exit(130);
+    };
+    // Q0: project name
+    const { projectName } = await prompts({ type: "text", name: "projectName", message: "Project name:", initial: defaultName }, { onCancel });
+    // Q1: what are you building?
+    const { projectType } = await prompts({
+        type: "select",
+        name: "projectType",
+        message: "What are you building?",
+        choices: [
+            { title: "Web app", value: "web-app" },
+            { title: "Marketing site", value: "marketing-site" },
+            { title: "Portfolio", value: "portfolio" },
+            { title: "Internal tool", value: "internal-tool" },
+            { title: "Prototype", value: "prototype" },
+            { title: "Something else", value: "other" }
+        ]
+    }, { onCancel });
+    let projectTypeOther;
+    if (projectType === "other") {
+        const { freeText } = await prompts({ type: "text", name: "freeText", message: "Describe it briefly:" }, { onCancel });
+        projectTypeOther = freeText;
+    }
+    // Q2: stack — choices reordered by what's most likely for this project type
+    const appFirstChoices = [
+        { title: "TypeScript + React", value: "react-ts" },
+        { title: "TypeScript + Vue", value: "vue-ts" },
+        { title: "TypeScript + Svelte", value: "svelte-ts" },
+        { title: "Plain HTML + CSS + JS", value: "html-css-js" },
+        { title: "Other", value: "other" }
+    ];
+    const staticFirstChoices = [
+        { title: "Plain HTML + CSS + JS", value: "html-css-js" },
+        { title: "TypeScript + React", value: "react-ts" },
+        { title: "TypeScript + Vue", value: "vue-ts" },
+        { title: "TypeScript + Svelte", value: "svelte-ts" },
+        { title: "Other", value: "other" }
+    ];
+    const stackChoices = projectType === "web-app" || projectType === "internal-tool"
+        ? appFirstChoices
+        : staticFirstChoices;
+    const { stack } = await prompts({
+        type: "select",
+        name: "stack",
+        message: "What language or framework?",
+        choices: stackChoices
+    }, { onCancel });
+    let stackOther;
+    if (stack === "other") {
+        const { freeText } = await prompts({ type: "text", name: "freeText", message: "Briefly describe it (we'll use plain CSS defaults):" }, { onCancel });
+        stackOther = freeText;
+    }
+    // Q3: team size
+    const { teamSize } = await prompts({
+        type: "select",
+        name: "teamSize",
+        message: "Who will work on this?",
+        choices: [
+            { title: "Just me", value: "solo" },
+            { title: "A small team (2–5 people)", value: "small" },
+            { title: "A larger team (6+)", value: "large" }
+        ]
+    }, { onCancel });
+    // Q4: UI references — only if AI is available
+    let uiCategories;
+    const ai = await getAiAvailability();
+    if (ai.available) {
+        const suggested = suggestUiCategories(projectType);
+        const { addRefs } = await prompts({
+            type: "confirm",
+            name: "addRefs",
+            message: "Add UI component references to this project?",
+            initial: true
+        }, { onCancel });
+        if (addRefs) {
+            const allCategories = ["forms", "navigation", "feedback", "surface", "layout", "data-display"];
+            const { selected } = await prompts({
+                type: "multiselect",
+                name: "selected",
+                message: "Which categories? (space to toggle, enter to confirm)",
+                instructions: false,
+                hint: "suggested for this project type are pre-selected",
+                choices: allCategories.map((cat) => ({
+                    title: cat,
+                    value: cat,
+                    selected: suggested.includes(cat)
+                }))
+            }, { onCancel });
+            uiCategories = selected ?? suggested;
         }
-    });
-    return {
-        ...DEFAULT_CONFIG,
-        projectName: answers.projectName,
-        projectType: answers.projectType,
-        stack: answers.stack,
-        packs: answers.packs && answers.packs.length > 0 ? answers.packs : OPINIONATED_PACKS,
-        aiTargets: answers.aiTargets && answers.aiTargets.length > 0 ? answers.aiTargets : ["claude"],
-        foundations: {
-            grid: answers.grid ?? 8,
-            radius: {
-                control: answers.radiusControl ?? 2,
-                container: answers.radiusContainer ?? 4
-            }
+        else {
+            uiCategories = [];
         }
+    }
+    // Q5: agent packs
+    const allPacks = listPacks();
+    const { agentPacks } = await prompts({
+        type: "multiselect",
+        name: "agentPacks",
+        message: "Which agent packs to install?",
+        instructions: false,
+        hint: "space to toggle, enter to confirm",
+        choices: allPacks.map((p) => ({
+            title: `${p.name} — ${p.description}`,
+            value: p.name,
+            selected: p.name === "selene"
+        }))
+    }, { onCancel });
+    // Map human answers to technical config
+    const wizardAnswers = {
+        projectType,
+        projectTypeOther,
+        stack,
+        stackOther,
+        teamSize,
+        uiCategories,
+        agentPacks
     };
+    const result = mapWizardAnswers(wizardAnswers);
+    result.config.projectName = projectName;
+    return result;
 }