whale-igniter 1.1.0

package/dist/commands/add.js

@@ -0,0 +1,36 @@
+import { resolveTarget } from "../utils/paths.js";
+import { loadConfig, saveConfig } from "../utils/config.js";
+import { getPack, listPacks } from "../utils/registry.js";
+import { ui } from "../ui/index.js";
+export async function addCommand(packName) {
+    const target = resolveTarget();
+    const pack = getPack(packName);
+    if (!pack) {
+        console.log(ui.fail(`Unknown pack: "${packName}"`));
+        console.log(ui.muted("Available packs:"));
+        for (const p of listPacks()) {
+            console.log(`  ${ui.glyph.bullet} ${ui.code(p.name)} ${ui.muted(`(${p.kind})`)} — ${p.description}`);
+        }
+        process.exitCode = 1;
+        return;
+    }
+    const config = await loadConfig(target);
+    config.packs = config.packs ?? [];
+    if (config.packs.includes(packName)) {
+        console.log(ui.warn(`${packName} is already installed.`));
+        return;
+    }
+    config.packs.push(packName);
+    await saveConfig(target, config);
+    console.log(ui.ok(`${ui.code(packName)} added to ${ui.path("whale.config.json")}`));
+    console.log(`  ${ui.kv("kind", pack.kind, { keyWidth: 8 })}`);
+    console.log(`  ${ui.muted(pack.description)}`);
+    if (pack.kind === "generator") {
+        console.log();
+        console.log(ui.next(`whale docs    ${ui.muted("generate the " + packName + " report")}`));
+    }
+    else {
+        console.log();
+        console.log(ui.next(`whale validate    ${ui.muted("use " + packName)}`));
+    }
+}

package/dist/commands/adopt.js

@@ -0,0 +1,180 @@
+import path from "node:path";
+import fs from "fs-extra";
+import ora from "ora";
+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 { ui } from "../ui/index.js";
+const SCANNER_VERSION = "1.1.0";
+export async function adoptCommand(targetArg, options = {}) {
+    const target = resolveTarget(targetArg);
+    console.log();
+    console.log(ui.header("Whale Igniter", `adopt • ${path.relative(process.cwd(), target) || "."}`));
+    console.log();
+    await fs.ensureDir(path.join(target, "intelligence"));
+    // ---- Step 1: scan components ----------------------------------------------
+    const spin1 = ora({ text: "Scanning components", spinner: "dots" }).start();
+    const components = await scanComponents(target, options.pattern ? { pattern: options.pattern } : {});
+    spin1.succeed(`Found ${components.length} component candidate(s)`);
+    // ---- Step 2: aggregate Tailwind observations ------------------------------
+    const spin2 = ora({ text: "Aggregating Tailwind usage", spinner: "dots" }).start();
+    const allClassNameStrings = components.flatMap((c) => c.classNames);
+    const observations = aggregateTailwind(allClassNameStrings);
+    const tailwindConfig = await detectTailwindConfig(target);
+    const tailwindNote = tailwindConfig
+        ? ui.muted(` (detected ${tailwindConfig})`)
+        : ui.muted(" (no tailwind.config found)");
+    spin2.succeed(`Aggregated ${observations.length} class(es) from ${allClassNameStrings.length} attribute(s)` + tailwindNote);
+    // ---- Step 3: infer foundations --------------------------------------------
+    const spin3 = ora({ text: "Inferring foundations", spinner: "dots" }).start();
+    const foundations = inferFoundations(observations);
+    spin3.succeed("Foundations inferred");
+    // Foundations block — nicely structured key/value with confidence tags.
+    console.log();
+    console.log(ui.section("Foundations"));
+    const fLines = [];
+    fLines.push(ui.kv("grid", `${ui.code(foundations.grid.value + "px")} ${confidenceBadge(foundations.grid.confidence)}`, { keyWidth: 8 }));
+    fLines.push(ui.muted("    " + foundations.grid.evidence));
+    fLines.push(ui.kv("radii", `control ${ui.code((foundations.radii.control ?? "?") + "px")} / container ${ui.code((foundations.radii.container ?? "?") + "px")} ${confidenceBadge(foundations.radii.confidence)}`, { keyWidth: 8 }));
+    fLines.push(ui.muted("    " + foundations.radii.evidence));
+    fLines.push(ui.kv("colors", foundations.colors.evidence, { keyWidth: 8 }));
+    if (foundations.colors.palette.length > 0) {
+        const top = foundations.colors.palette
+            .slice(0, 5)
+            .map((p) => `${ui.code(p.token)} ${ui.muted("×" + p.count)}`)
+            .join("  ");
+        fLines.push(ui.muted("    top: ") + top);
+    }
+    console.log(ui.indent(fLines.join("\n")));
+    if (foundations.hints.length > 0) {
+        console.log();
+        console.log(ui.subsection("Hints"));
+        for (const h of foundations.hints) {
+            console.log(ui.indent(ui.warn(h)));
+        }
+    }
+    // ---- Step 4: build proposals ----------------------------------------------
+    const store = await loadProposals(target);
+    store.scannedAt = new Date().toISOString();
+    store.scannerVersion = SCANNER_VERSION;
+    let addedComponents = 0;
+    let updatedComponents = 0;
+    let preservedComponents = 0;
+    for (const c of components) {
+        const fp = fingerprintComponent(c.name, c.file);
+        const proposal = {
+            kind: "component",
+            fingerprint: fp,
+            status: "pending",
+            proposedAt: new Date().toISOString(),
+            payload: {
+                name: c.name,
+                description: undefined,
+                category: inferCategoryFromFile(c.file),
+                files: [c.file],
+                tokens: undefined,
+                variants: undefined,
+                states: undefined
+            },
+            evidence: {
+                file: c.file,
+                exportKind: c.exportKind,
+                declarationKind: c.declarationKind,
+                classNamesSampled: c.classNames.length,
+                jsxComposition: c.jsxIdentifiers.slice(0, 10)
+            }
+        };
+        const res = upsertProposal(store, proposal);
+        if (res.added)
+            addedComponents += 1;
+        else if (res.preserved)
+            preservedComponents += 1;
+        else
+            updatedComponents += 1;
+    }
+    const foundationsProposal = {
+        kind: "foundations",
+        fingerprint: fingerprintFoundations(),
+        status: "pending",
+        proposedAt: new Date().toISOString(),
+        payload: foundations
+    };
+    upsertProposal(store, foundationsProposal);
+    if (options.dryRun) {
+        console.log();
+        console.log(ui.warn("Dry run — no changes written."));
+        return;
+    }
+    await saveProposals(target, store);
+    // ---- Step 5: ensure whale.config.json exists with sensible defaults -------
+    const configPath = path.join(target, "whale.config.json");
+    if (!(await fs.pathExists(configPath))) {
+        const draftConfig = {
+            ...DEFAULT_CONFIG,
+            projectName: path.basename(target),
+            stack: "tailwind",
+            ignited: {
+                at: new Date().toISOString(),
+                mode: "minimal",
+                version: SCANNER_VERSION
+            }
+        };
+        await saveConfig(target, draftConfig);
+        console.log();
+        console.log(ui.note("Drafted whale.config.json (foundations populate on review)"));
+    }
+    else {
+        const existing = await loadConfig(target);
+        if (observations.length > 0 && existing.stack !== "tailwind") {
+            await saveConfig(target, { ...existing, stack: "tailwind" });
+            console.log();
+            console.log(ui.note("Updated stack to 'tailwind' in whale.config.json"));
+        }
+    }
+    // ---- Step 6: ensure other intelligence files exist ------------------------
+    for (const file of ["refinements.json", "decisions.json", "components.json"]) {
+        const p = path.join(target, "intelligence", file);
+        if (!(await fs.pathExists(p)))
+            await fs.writeJson(p, [], { spaces: 2 });
+    }
+    // ---- Summary --------------------------------------------------------------
+    console.log();
+    console.log(ui.section("Proposals"));
+    console.log(ui.indent(ui.summary([
+        { label: "new", value: addedComponents, tone: addedComponents > 0 ? "ok" : "muted" },
+        ...(updatedComponents > 0 ? [{ label: "updated", value: updatedComponents, tone: "muted" }] : []),
+        ...(preservedComponents > 0
+            ? [{ label: "preserved", value: preservedComponents, tone: "muted" }]
+            : [])
+    ])));
+    const pending = pendingProposals(store).length;
+    console.log();
+    console.log(ui.section("Next"));
+    console.log(ui.indent(`${ui.glyph.arrow} ${ui.code("whale adopt review")}  ${ui.muted(`accept or reject ${pending} pending`)}`));
+    console.log(ui.indent(`${ui.glyph.arrow} ${ui.code("whale adopt status")}  ${ui.muted("list without entering review")}`));
+    console.log();
+}
+function confidenceBadge(level) {
+    if (level === "high")
+        return ui.badges.success(level);
+    if (level === "medium")
+        return ui.badges.info(level);
+    return ui.badges.warning(level);
+}
+function inferCategoryFromFile(file) {
+    const lower = file.toLowerCase().replace(/\\/g, "/");
+    if (/\/forms?\//.test(lower) || /input|button|select|checkbox|radio|toggle/.test(lower))
+        return "form";
+    if (/\/nav|\/menu|\/header|\/sidebar|breadcrumb|tab\b/.test(lower))
+        return "navigation";
+    if (/modal|dialog|toast|alert|notification|popover|tooltip/.test(lower))
+        return "feedback";
+    if (/\/layout|\/grid|\/container|\/stack|\/cluster/.test(lower))
+        return "layout";
+    if (/card|panel|section|hero|cta/.test(lower))
+        return "surface";
+    return undefined;
+}

package/dist/commands/adoptReview.js

@@ -0,0 +1,267 @@
+import prompts from "prompts";
+import { resolveTarget } from "../utils/paths.js";
+import { loadProposals, saveProposals, pendingProposals } from "../utils/proposals.js";
+import { upsertComponent } from "../utils/components.js";
+import { loadConfig, saveConfig } from "../utils/config.js";
+import { generateWiki } from "../generators/wikiGenerator.js";
+import { ui } from "../ui/index.js";
+export async function adoptStatusCommand(targetArg) {
+    const target = resolveTarget(targetArg);
+    const store = await loadProposals(target);
+    if (!store.scannedAt) {
+        console.log();
+        console.log(ui.note("No scan run yet. Use `whale adopt` first."));
+        return;
+    }
+    const pending = pendingProposals(store);
+    const accepted = store.proposals.filter((p) => p.status === "accepted").length;
+    const rejected = store.proposals.filter((p) => p.status === "rejected").length;
+    console.log();
+    console.log(ui.header("Whale Igniter", "adopt status"));
+    console.log();
+    console.log(ui.muted(`Last scan: ${store.scannedAt}`));
+    console.log();
+    console.log(ui.summary([
+        { label: "pending", value: pending.length, tone: pending.length > 0 ? "warn" : "muted" },
+        { label: "accepted", value: accepted, tone: "ok" },
+        { label: "rejected", value: rejected, tone: rejected > 0 ? "muted" : "muted" }
+    ]));
+    if (pending.length === 0) {
+        console.log();
+        console.log(ui.ok("All proposals reviewed. Run `whale sync` to refresh AI context."));
+        return;
+    }
+    console.log();
+    console.log(ui.section("Pending"));
+    for (const p of pending.slice(0, 30)) {
+        if (p.kind === "component") {
+            const name = p.payload.name.padEnd(24);
+            console.log(ui.indent(`${ui.code(name)} ${ui.muted(p.evidence.file)}`));
+        }
+        else if (p.kind === "foundations") {
+            const f = p.payload;
+            console.log(ui.indent(`${ui.code("foundations".padEnd(24))} ${ui.muted(`grid=${f.grid.value}px radii=${f.radii.control}/${f.radii.container}px`)}`));
+        }
+        else if (p.kind === "decision") {
+            console.log(ui.indent(`${ui.code("decision".padEnd(24))} ${ui.muted(p.payload.title)}`));
+        }
+    }
+    if (pending.length > 30) {
+        console.log(ui.indent(ui.muted(`… and ${pending.length - 30} more`)));
+    }
+    console.log();
+    console.log(ui.next(`${ui.code("whale adopt review")}  ${ui.muted("walk through them")}`));
+    console.log();
+}
+export async function adoptReviewCommand(targetArg, options = {}) {
+    const target = resolveTarget(targetArg);
+    const store = await loadProposals(target);
+    if (!store.scannedAt) {
+        console.log();
+        console.log(ui.note("No scan run yet. Use `whale adopt` first."));
+        return;
+    }
+    let pending = pendingProposals(store);
+    if (options.category)
+        pending = pending.filter((p) => p.kind === options.category);
+    if (options.limit && options.limit > 0)
+        pending = pending.slice(0, options.limit);
+    if (pending.length === 0) {
+        console.log();
+        console.log(ui.ok("Nothing pending. All proposals have been reviewed."));
+        return;
+    }
+    // Review foundations first — it's the most consequential.
+    pending.sort((a, b) => (a.kind === "foundations" ? -1 : b.kind === "foundations" ? 1 : 0));
+    console.log();
+    console.log(ui.header("Whale Igniter", `adopt review • ${pending.length} pending`));
+    console.log();
+    console.log(ui.muted("Per item: accept, reject, edit, skip, quit."));
+    console.log();
+    let processed = 0;
+    let acceptedCount = 0;
+    let rejectedCount = 0;
+    let skippedCount = 0;
+    for (const proposal of pending) {
+        processed += 1;
+        console.log(ui.muted(`[${processed}/${pending.length}]`));
+        renderProposal(proposal);
+        const action = options.acceptAll ? "accept" : await promptAction();
+        if (action === "quit") {
+            console.log();
+            console.log(ui.note("Stopped. Progress saved."));
+            break;
+        }
+        if (action === "skip") {
+            skippedCount += 1;
+            console.log(ui.indent(ui.muted("skipped")));
+            console.log();
+            continue;
+        }
+        if (action === "reject") {
+            const reason = await prompts({ type: "text", name: "reason", message: "Reason (optional):" }, { onCancel: () => ({ reason: undefined }) });
+            proposal.status = "rejected";
+            proposal.reviewedAt = new Date().toISOString();
+            proposal.rejectionReason = reason.reason || undefined;
+            rejectedCount += 1;
+            console.log(ui.indent(ui.danger("rejected")));
+            console.log();
+            continue;
+        }
+        if (action === "edit") {
+            await editProposal(proposal);
+        }
+        await graduate(target, proposal);
+        proposal.status = "accepted";
+        proposal.reviewedAt = new Date().toISOString();
+        acceptedCount += 1;
+        console.log(ui.indent(ui.success("accepted")));
+        console.log();
+    }
+    await saveProposals(target, store);
+    if (acceptedCount > 0) {
+        console.log(ui.muted("Regenerating AI context..."));
+        await generateWiki(target);
+        console.log(ui.ok("CLAUDE.md and wiki updated"));
+    }
+    console.log();
+    console.log(ui.section("Summary"));
+    console.log(ui.indent(ui.summary([
+        { label: "accepted", value: acceptedCount, tone: acceptedCount > 0 ? "ok" : "muted" },
+        { label: "rejected", value: rejectedCount, tone: rejectedCount > 0 ? "muted" : "muted" },
+        ...(skippedCount > 0 ? [{ label: "skipped", value: skippedCount, tone: "warn" }] : [])
+    ])));
+    console.log();
+}
+function renderProposal(p) {
+    if (p.kind === "component") {
+        const c = p;
+        console.log(ui.section(`Component: ${ui.accent(c.payload.name)}`));
+        console.log(ui.indent([
+            ui.kv("file", ui.path(c.evidence.file), { keyWidth: 12 }),
+            ui.kv("export", `${c.evidence.exportKind} ${ui.muted("(" + c.evidence.declarationKind + ")")}`, {
+                keyWidth: 12
+            }),
+            ui.kv("category", c.payload.category ?? ui.muted("(heuristic miss)"), { keyWidth: 12 }),
+            ui.kv("classNames", `${c.evidence.classNamesSampled} attribute(s)`, { keyWidth: 12 }),
+            ...(c.evidence.jsxComposition.length > 0
+                ? [ui.kv("composes", c.evidence.jsxComposition.slice(0, 6).join(", "), { keyWidth: 12 })]
+                : [])
+        ].join("\n")));
+    }
+    else if (p.kind === "foundations") {
+        const f = p.payload;
+        console.log(ui.section("Foundations"));
+        console.log(ui.indent([
+            ui.kv("grid", `${ui.code(f.grid.value + "px")} ${confidenceBadge(f.grid.confidence)}`, { keyWidth: 8 }),
+            ui.muted("    " + f.grid.evidence),
+            ui.kv("radii", `control ${ui.code((f.radii.control ?? "?") + "px")} / container ${ui.code((f.radii.container ?? "?") + "px")} ${confidenceBadge(f.radii.confidence)}`, { keyWidth: 8 }),
+            ui.muted("    " + f.radii.evidence),
+            ui.kv("colors", `${f.colors.palette.length} token(s), ${f.colors.arbitraryCount} arbitrary value(s)`, {
+                keyWidth: 8
+            })
+        ].join("\n")));
+    }
+    else {
+        console.log(ui.section(`Decision: ${ui.accent(p.payload.title)}`));
+        console.log(ui.indent(ui.kv("category", p.payload.category, { keyWidth: 10 })));
+        console.log(ui.indent(ui.kv("decision", p.payload.decision, { keyWidth: 10 })));
+    }
+    console.log();
+}
+function confidenceBadge(level) {
+    if (level === "high")
+        return ui.badges.success(level);
+    if (level === "medium")
+        return ui.badges.info(level);
+    return ui.badges.warning(level);
+}
+async function promptAction() {
+    const { action } = await prompts({
+        type: "select",
+        name: "action",
+        message: "Action:",
+        choices: [
+            { title: "Accept", value: "accept" },
+            { title: "Reject", value: "reject" },
+            { title: "Edit then accept", value: "edit" },
+            { title: "Skip for now", value: "skip" },
+            { title: "Quit (save and exit)", value: "quit" }
+        ]
+    }, { onCancel: () => ({ action: "quit" }) });
+    return action ?? "quit";
+}
+async function editProposal(proposal) {
+    if (proposal.kind === "component") {
+        const c = proposal;
+        const answers = await prompts([
+            { type: "text", name: "name", message: "Name:", initial: c.payload.name },
+            { type: "text", name: "description", message: "Description:", initial: c.payload.description ?? "" },
+            { type: "text", name: "category", message: "Category:", initial: c.payload.category ?? "" },
+            {
+                type: "text",
+                name: "variants",
+                message: "Variants (comma-separated):",
+                initial: c.payload.variants?.join(",") ?? ""
+            },
+            {
+                type: "text",
+                name: "states",
+                message: "States (comma-separated):",
+                initial: c.payload.states?.join(",") ?? ""
+            }
+        ], { onCancel: () => ({}) });
+        const split = (s) => s ? s.split(",").map((x) => x.trim()).filter(Boolean) : undefined;
+        if (answers.name)
+            c.payload.name = answers.name;
+        c.payload.description = (answers.description || "").trim() || undefined;
+        c.payload.category = (answers.category || "").trim() || undefined;
+        c.payload.variants = split(answers.variants);
+        c.payload.states = split(answers.states);
+    }
+    else if (proposal.kind === "foundations") {
+        const f = proposal.payload;
+        const answers = await prompts([
+            { type: "number", name: "grid", message: "Grid (px):", initial: f.grid.value, min: 1, max: 32 },
+            {
+                type: "number",
+                name: "control",
+                message: "Control radius (px):",
+                initial: f.radii.control ?? 4,
+                min: 0,
+                max: 64
+            },
+            {
+                type: "number",
+                name: "container",
+                message: "Container radius (px):",
+                initial: f.radii.container ?? 8,
+                min: 0,
+                max: 64
+            }
+        ], { onCancel: () => ({}) });
+        if (typeof answers.grid === "number")
+            f.grid.value = answers.grid;
+        if (typeof answers.control === "number")
+            f.radii.control = answers.control;
+        if (typeof answers.container === "number")
+            f.radii.container = answers.container;
+    }
+}
+async function graduate(target, proposal) {
+    if (proposal.kind === "component") {
+        await upsertComponent(target, proposal.payload);
+    }
+    else if (proposal.kind === "foundations") {
+        const config = await loadConfig(target);
+        const f = proposal.payload;
+        config.foundations = {
+            grid: f.grid.value,
+            radius: {
+                control: f.radii.control ?? config.foundations?.radius?.control ?? 4,
+                container: f.radii.container ?? config.foundations?.radius?.container ?? 8
+            }
+        };
+        await saveConfig(target, config);
+    }
+}

package/dist/commands/component.js

@@ -0,0 +1,93 @@
+import prompts from "prompts";
+import { resolveTarget } from "../utils/paths.js";
+import { loadComponents, upsertComponent } from "../utils/components.js";
+import { generateWiki } from "../generators/wikiGenerator.js";
+import { ui } from "../ui/index.js";
+export async function componentAddCommand(name, options = {}) {
+    const target = resolveTarget();
+    if (!name) {
+        console.log(ui.fail("Component name is required."));
+        process.exitCode = 1;
+        return;
+    }
+    let description = options.description;
+    let category = options.category;
+    let variants = options.variants;
+    let states = options.states;
+    let files = options.files;
+    const noFlags = !description && !category && !variants && !states && !files;
+    if (noFlags) {
+        console.log(ui.header("Whale Igniter", `component add ${name}`));
+        console.log();
+        const answers = await prompts([
+            { type: "text", name: "description", message: "Description (optional):" },
+            {
+                type: "text",
+                name: "category",
+                message: "Category (form, navigation, feedback, layout, ...):"
+            },
+            {
+                type: "text",
+                name: "variants",
+                message: "Variants comma-separated (optional):"
+            },
+            {
+                type: "text",
+                name: "states",
+                message: "States comma-separated (hover, focus, disabled, ...):"
+            },
+            {
+                type: "text",
+                name: "files",
+                message: "Files comma-separated (optional):"
+            }
+        ], {
+            onCancel: () => {
+                console.log();
+                console.log(ui.warn("Cancelled."));
+                process.exit(130);
+            }
+        });
+        description = answers.description;
+        category = answers.category;
+        variants = answers.variants;
+        states = answers.states;
+        files = answers.files;
+    }
+    const split = (s) => s ? s.split(",").map((x) => x.trim()).filter(Boolean) : undefined;
+    const entry = await upsertComponent(target, {
+        name,
+        description: description?.trim() || undefined,
+        category: category?.trim() || undefined,
+        variants: split(variants),
+        states: split(states),
+        files: split(files)
+    });
+    console.log();
+    console.log(ui.ok(`Component registered: ${ui.code(entry.name)}`));
+    if (entry.category)
+        console.log(`  ${ui.kv("category", entry.category, { keyWidth: 8 })}`);
+    if (entry.variants?.length)
+        console.log(`  ${ui.kv("variants", entry.variants.join(", "), { keyWidth: 8 })}`);
+    if (options.sync !== false) {
+        await generateWiki(target);
+        console.log(ui.muted(`${ui.glyph.check} AI context updated`));
+    }
+}
+export async function componentListCommand() {
+    const target = resolveTarget();
+    const components = await loadComponents(target);
+    if (components.length === 0) {
+        console.log(ui.muted("No components registered yet."));
+        console.log(ui.muted("Run `whale component add <name>` to register one."));
+        return;
+    }
+    console.log(ui.section(`${components.length} component(s)`));
+    console.log();
+    for (const c of components) {
+        const head = ui.accent(c.name) + (c.category ? " " + ui.muted("— " + c.category) : "");
+        console.log(`  ${head}`);
+        if (c.description)
+            console.log(`    ${ui.muted(c.description)}`);
+    }
+}