whale-igniter 1.2.3 → 1.3.0

package/dist/commands/insights.js

@@ -1,16 +1,23 @@
 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 { loadConfig } from "../utils/config.js";
-import { loadRefinements } from "../utils/refinements.js";
+import { loadRefinements, appendRefinement } from "../utils/refinements.js";
 import { loadDecisions } from "../utils/decisions.js";
 import { loadComponents } from "../utils/components.js";
-import { analyze } from "../analyzer/insights.js";
+import { analyze, analyzeSpacingDrift, analyzeColorDrift, analyzeRadiiDrift } from "../analyzer/insights.js";
 import { collectReferencedFiles, normalizePath } from "../analyzer/imports.js";
 import { scanComponents } from "../scanner/componentScanner.js";
 import { aggregateTailwind } from "../scanner/tailwindScanner.js";
+import { extractFromCssFiles } from "../scanner/extractors/css.js";
+import { extractFromInlineStyles } from "../scanner/extractors/inline.js";
+import { extractFromStyleBlocks } from "../scanner/extractors/styleBlocks.js";
 import { ui } from "../ui/index.js";
+import { writeJsonFile } from "../utils/writeJson.js";
+import { getAiAvailability } from "../utils/aiAvailability.js";
+import { randomUUID } from "node:crypto";
 const SEVERITY_RANK = { info: 0, warning: 1, critical: 2 };
 export async function insightsCommand(targetArg, options = {}) {
     const target = resolveTarget(targetArg);
@@ -34,18 +41,28 @@ export async function insightsCommand(targetArg, options = {}) {
     spin.succeed(`Loaded ${refinements.length} refinement(s), ${decisions.length} decision(s), ${components.length} component(s)`);
     let referencedFiles;
     let observations;
+    let styleObservations;
     if (!options.skipScan) {
-        const spinScan = ora({ text: "Scanning source for imports and Tailwind usage", stream: process.stderr }).start();
+        const spinScan = ora({ text: "Scanning source files", stream: process.stderr }).start();
         try {
-            const [refs, scanned] = await Promise.all([collectReferencedFiles(target), scanComponents(target)]);
+            const [refs, scanned, cssObs, inlineObs, blockObs] = await Promise.all([
+                collectReferencedFiles(target),
+                scanComponents(target),
+                extractFromCssFiles(target),
+                extractFromInlineStyles(target),
+                extractFromStyleBlocks(target)
+            ]);
             referencedFiles = refs;
             const allClassStrings = scanned.flatMap((c) => c.classNames);
             observations = allClassStrings.length > 0 ? aggregateTailwind(allClassStrings) : undefined;
-            spinScan.succeed(`Scanned ${refs.size} import reference(s)` +
-                (observations ? ` and ${observations.length} class observation(s)` : ""));
+            styleObservations = [...cssObs, ...inlineObs, ...blockObs];
+            spinScan.succeed(`Scanned ${refs.size} import(s)` +
+                (observations ? `, ${observations.length} Tailwind class(es)` : "") +
+                `, ${styleObservations.length} style observation(s)`);
         }
         catch (err) {
-            spinScan.warn(`Scan failed: ${err?.message ?? err}. Continuing without orphan/drift insights.`);
+            const msg = err instanceof Error ? err.message : String(err);
+            spinScan.warn(`Scan failed: ${msg}. Continuing without drift insights.`);
         }
     }
     const normalisedComponents = referencedFiles
@@ -57,10 +74,130 @@ export async function insightsCommand(targetArg, options = {}) {
         decisions,
         components: normalisedComponents,
         observations,
-        referencedFiles
+        referencedFiles,
+        styleObservations
     });
-    return printOrEmit(insights, options);
+    printOrEmit(insights, options);
+    if (!options.json) {
+        const ai = await getAiAvailability(target);
+        if (ai.available && insights.length > 0) {
+            console.log(ui.note("AI-generated UX hints available. Run `whale selene suggest --focus all` to get them."));
+            console.log();
+        }
+        else if (!ai.available) {
+            console.log(ui.muted("AI features available with Claude Code, Codex, or an API key."));
+            console.log();
+        }
+    }
+}
+export async function insightsDriftReviewCommand(category, opts) {
+    const validCategories = ["spacing", "color", "radii"];
+    if (!validCategories.includes(category)) {
+        console.log(ui.fail(`Unknown drift category: ${category}. Valid: ${validCategories.join(", ")}`));
+        process.exitCode = 1;
+        return;
+    }
+    const cat = category;
+    const target = resolveTarget(opts.target);
+    console.log();
+    console.log(ui.header("Whale Igniter", `insights drift ${cat}`));
+    console.log();
+    const spin = ora({ text: "Scanning source files", stream: process.stderr }).start();
+    const [config, refinements, cssObs, inlineObs, blockObs] = await Promise.all([
+        loadConfig(target),
+        loadRefinements(target),
+        extractFromCssFiles(target),
+        extractFromInlineStyles(target),
+        extractFromStyleBlocks(target)
+    ]);
+    const styleObservations = [...cssObs, ...inlineObs, ...blockObs];
+    spin.succeed(`${styleObservations.length} style observation(s) found`);
+    const driftInsights = cat === "spacing"
+        ? analyzeSpacingDrift(styleObservations, config, refinements)
+        : cat === "color"
+            ? analyzeColorDrift(styleObservations, config, refinements)
+            : analyzeRadiiDrift(styleObservations, config, refinements);
+    if (driftInsights.length === 0) {
+        console.log(ui.ok(`No ${cat} drift found.`));
+        console.log();
+        return;
+    }
+    console.log(ui.section(`${cat} drift — ${driftInsights.length} insight(s)`));
+    console.log();
+    if (!opts.review) {
+        for (const ins of driftInsights) {
+            console.log(ui.indent(ui.emphasis(ins.title)));
+            console.log(ui.indent(ui.muted(ins.detail), 1));
+            if (ins.evidence) {
+                for (const e of ins.evidence.slice(0, 5)) {
+                    console.log(ui.indent(ui.dot(e), 2));
+                }
+            }
+            console.log();
+        }
+        console.log(ui.muted("Use --review to enter the interactive review loop."));
+        console.log();
+        return;
+    }
+    // Interactive review loop
+    const refactorQueuePath = path.join(target, "intelligence", "refactor-queue.json");
+    const refactorQueue = (await fs.pathExists(refactorQueuePath))
+        ? await fs.readJson(refactorQueuePath)
+        : [];
+    let reviewed = 0;
+    for (const ins of driftInsights) {
+        console.log(ui.section(ins.title));
+        console.log(ui.indent(ui.muted(ins.detail)));
+        if (ins.evidence) {
+            for (const e of ins.evidence)
+                console.log(ui.indent(ui.dot(e), 1));
+        }
+        console.log();
+        const { action } = await prompts({
+            type: "select",
+            name: "action",
+            message: "What would you like to do?",
+            choices: [
+                { title: "Accept as refinement (suppress this drift)", value: "refine" },
+                { title: "Flag for refactor (add to queue)", value: "queue" },
+                { title: "Skip", value: "skip" },
+                { title: "Quit review", value: "quit" }
+            ]
+        });
+        if (!action || action === "quit")
+            break;
+        if (action === "refine") {
+            await appendRefinement(target, {
+                id: randomUUID(),
+                timestamp: new Date().toISOString(),
+                note: ins.title,
+                scope: { issueType: cat }
+            });
+            console.log(ui.ok("Recorded as refinement."));
+        }
+        else if (action === "queue") {
+            refactorQueue.push({
+                id: randomUUID(),
+                insightId: ins.id,
+                title: ins.title,
+                evidence: ins.evidence ?? [],
+                addedAt: new Date().toISOString()
+            });
+            console.log(ui.ok("Added to refactor queue."));
+        }
+        reviewed++;
+        console.log();
+    }
+    if (refactorQueue.length > 0) {
+        await fs.ensureDir(path.join(target, "intelligence"));
+        await writeJsonFile(refactorQueuePath, refactorQueue);
+    }
+    console.log(ui.accent(`Reviewed ${reviewed} insight(s).`));
+    console.log();
 }
+// ---------------------------------------------------------------------------
+// Shared rendering
+// ---------------------------------------------------------------------------
 function printOrEmit(insights, options) {
     let filtered = insights;
     if (options.category)

package/dist/commands/references.js

@@ -0,0 +1,193 @@
+import path from "node:path";
+import fs from "fs-extra";
+import { resolveTarget } from "../utils/paths.js";
+import { loadConfig, saveConfig } from "../utils/config.js";
+import { generateWiki } from "../generators/wikiGenerator.js";
+import { ui } from "../ui/index.js";
+import prompts from "prompts";
+const VALID_CATEGORIES = ["forms", "navigation", "feedback", "surface", "layout", "data-display"];
+function shippedReferencesDir() {
+    // Resolve relative to this file's location: src/commands/ → root → ui-references/
+    const thisFile = new URL(import.meta.url).pathname;
+    return path.resolve(path.dirname(thisFile), "../../ui-references");
+}
+function projectReferencesDir(target) {
+    return path.join(target, "references");
+}
+// ---------------------------------------------------------------------------
+// `whale references list`
+// ---------------------------------------------------------------------------
+export async function referencesListCommand(targetArg) {
+    const target = resolveTarget(targetArg);
+    const config = await loadConfig(target);
+    const refDir = projectReferencesDir(target);
+    console.log();
+    console.log(ui.header("UI References", "list"));
+    console.log();
+    const configuredCategories = config.uiReferences ?? [];
+    const rows = [];
+    for (const cat of VALID_CATEGORIES) {
+        const filePath = path.join(refDir, `${cat}.md`);
+        const present = await fs.pathExists(filePath);
+        const configured = configuredCategories.includes(cat);
+        const status = present ? ui.ok("present") : ui.muted("not copied");
+        const flag = configured ? ui.glyph.check : " ";
+        rows.push([flag, ui.code(cat), status]);
+    }
+    const indexPath = path.join(refDir, "INDEX.md");
+    const indexPresent = await fs.pathExists(indexPath);
+    console.log(ui.section("Categories"));
+    for (const [flag, cat, status] of rows) {
+        console.log(`  ${flag} ${cat.padEnd(16)} ${status}`);
+    }
+    console.log();
+    console.log(ui.kv("references/INDEX.md", indexPresent ? ui.ok("present") : ui.muted("not copied")));
+    if (configuredCategories.length === 0 && !indexPresent) {
+        console.log();
+        console.log(ui.note("No references installed yet."));
+        console.log(ui.indent(ui.muted("Run `whale references add <category>` or `whale references add --all`.")));
+    }
+    console.log();
+}
+// ---------------------------------------------------------------------------
+// `whale references add [category | --all]`
+// ---------------------------------------------------------------------------
+export async function referencesAddCommand(category, opts) {
+    const target = resolveTarget(opts.target);
+    const shipped = shippedReferencesDir();
+    const refDir = projectReferencesDir(target);
+    console.log();
+    console.log(ui.header("UI References", opts.all ? "add --all" : `add ${category ?? ""}`));
+    console.log();
+    if (!opts.all && !category) {
+        console.log(ui.fail("Specify a category or use --all."));
+        console.log(ui.muted(`  Valid categories: ${VALID_CATEGORIES.join(", ")}`));
+        process.exitCode = 1;
+        return;
+    }
+    const categoriesToAdd = opts.all
+        ? [...VALID_CATEGORIES]
+        : [category];
+    // Validate
+    for (const cat of categoriesToAdd) {
+        if (!VALID_CATEGORIES.includes(cat)) {
+            console.log(ui.fail(`Unknown category: ${cat}`));
+            console.log(ui.muted(`  Valid: ${VALID_CATEGORIES.join(", ")}`));
+            process.exitCode = 1;
+            return;
+        }
+    }
+    await fs.ensureDir(refDir);
+    // Always copy INDEX.md
+    const shippedIndex = path.join(shipped, "INDEX.md");
+    const projectIndex = path.join(refDir, "INDEX.md");
+    if (!(await fs.pathExists(projectIndex))) {
+        await fs.copy(shippedIndex, projectIndex);
+        console.log(ui.ok(`Copied references/INDEX.md`));
+    }
+    const copied = [];
+    const skipped = [];
+    for (const cat of categoriesToAdd) {
+        const src = path.join(shipped, `${cat}.md`);
+        const dest = path.join(refDir, `${cat}.md`);
+        if (!(await fs.pathExists(src))) {
+            console.log(ui.warn(`Shipped file not found for category: ${cat}`));
+            continue;
+        }
+        if (await fs.pathExists(dest)) {
+            skipped.push(cat);
+            continue;
+        }
+        await fs.copy(src, dest);
+        copied.push(cat);
+        console.log(ui.ok(`Copied references/${cat}.md`));
+    }
+    if (skipped.length > 0) {
+        console.log();
+        console.log(ui.note(`Skipped (already present): ${skipped.join(", ")}. Run \`whale references update\` to refresh.`));
+    }
+    // Update whale.config.json
+    const config = await loadConfig(target);
+    const existing = new Set(config.uiReferences ?? []);
+    for (const cat of copied)
+        existing.add(cat);
+    config.uiReferences = Array.from(existing).sort();
+    await saveConfig(target, config);
+    // Regenerate CLAUDE.md to include the references section
+    if (copied.length > 0) {
+        await generateWiki(target);
+        console.log();
+        console.log(ui.ok("CLAUDE.md updated with references section."));
+    }
+    console.log();
+    console.log(ui.info(`AI tools can now read references/ — consult references/INDEX.md for navigation.`));
+    console.log();
+}
+// ---------------------------------------------------------------------------
+// `whale references update`
+// ---------------------------------------------------------------------------
+export async function referencesUpdateCommand(targetArg) {
+    const target = resolveTarget(targetArg);
+    const shipped = shippedReferencesDir();
+    const refDir = projectReferencesDir(target);
+    console.log();
+    console.log(ui.header("UI References", "update"));
+    console.log();
+    if (!(await fs.pathExists(refDir))) {
+        console.log(ui.warn("No references/ directory found in this project."));
+        console.log(ui.muted("  Run `whale references add <category>` first."));
+        return;
+    }
+    const config = await loadConfig(target);
+    const configuredCategories = config.uiReferences ?? [];
+    const allFilesToCheck = ["INDEX", ...configuredCategories.map((c) => c)];
+    for (const slug of allFilesToCheck) {
+        const filename = slug === "INDEX" ? "INDEX.md" : `${slug}.md`;
+        const src = path.join(shipped, filename);
+        const dest = path.join(refDir, filename);
+        if (!(await fs.pathExists(src)))
+            continue;
+        if (!(await fs.pathExists(dest))) {
+            await fs.copy(src, dest);
+            console.log(ui.ok(`Added ${filename} (was missing)`));
+            continue;
+        }
+        // Compare content — only prompt if modified
+        const [srcContent, destContent] = await Promise.all([
+            fs.readFile(src, "utf-8"),
+            fs.readFile(dest, "utf-8")
+        ]);
+        if (srcContent === destContent) {
+            console.log(`  ${ui.glyph.check} ${filename} is up to date`);
+            continue;
+        }
+        // File differs — prompt
+        const { action } = await prompts({
+            type: "select",
+            name: "action",
+            message: `references/${filename} has local modifications. What would you like to do?`,
+            choices: [
+                { title: "Keep my version", value: "keep" },
+                { title: "Overwrite with shipped version", value: "overwrite" },
+                { title: "Show diff summary", value: "diff" }
+            ]
+        });
+        if (action === "overwrite") {
+            await fs.copy(src, dest);
+            console.log(ui.ok(`Overwritten: references/${filename}`));
+        }
+        else if (action === "diff") {
+            const srcLines = srcContent.split("\n").length;
+            const destLines = destContent.split("\n").length;
+            console.log(ui.note(`Shipped: ${srcLines} lines. Your version: ${destLines} lines. ` +
+                `Use a diff tool to compare: diff references/${filename} <(whale references --shipped ${slug})`));
+            console.log(ui.muted("  Keeping your version."));
+        }
+        else {
+            console.log(ui.muted(`  Kept: references/${filename}`));
+        }
+    }
+    console.log();
+    console.log(ui.accent("References are up to date."));
+    console.log();
+}

package/dist/commands/sync.js

@@ -6,6 +6,7 @@ import { loadConfig } from "../utils/config.js";
 import { loadDecisions } from "../utils/decisions.js";
 import { loadComponents } from "../utils/components.js";
 import { loadRefinements } from "../utils/refinements.js";
+import { getAiAvailability } from "../utils/aiAvailability.js";
 import { ui } from "../ui/index.js";
 /**
  * `whale sync` regenerates everything an AI agent reads, from the
@@ -40,4 +41,11 @@ export async function syncCommand(targetArg) {
     console.log();
     console.log(ui.accent("AI agents will now see the latest project state."));
     console.log(ui.muted(`Targets configured: ${(config.aiTargets ?? []).join(", ") || "(none)"}`));
+    if (config.enrichWithAi) {
+        const ai = await getAiAvailability(target);
+        if (ai.available) {
+            console.log();
+            console.log(ui.note("Scribe enrichment enabled (config.enrichWithAi=true). Run `whale selene suggest` to enrich wiki prose."));
+        }
+    }
 }