whale-igniter 1.2.2 → 1.3.0

package/dist/templates/project.js

@@ -0,0 +1,82 @@
+export function renderProject(config, errors, warnings, refinementCount, decisionCount) {
+    return `# Project Context
+
+- **Project name:** ${config.projectName ?? "(unset)"}
+- **Project type:** ${config.projectType ?? "unspecified"}
+- **Stack:** ${config.stack ?? "css"}
+- **AI targets:** ${(config.aiTargets ?? []).join(", ") || "(none)"}
+- **Active packs:** ${(config.packs ?? []).join(", ") || "(none)"}
+- **Ignited:** ${config.ignited?.at ?? "(not yet)"} (${config.ignited?.mode ?? "—"})
+
+## Current status
+
+- Validation errors: ${errors}
+- Validation warnings: ${warnings}
+- Decisions logged: ${decisionCount}
+- Active refinements: ${refinementCount}
+
+_Generated by Whale Igniter._
+`;
+}
+export function renderWikiReadme(_config) {
+    return `# LLM Wiki
+
+This directory is generated by Whale Igniter. It contains a human-and-AI
+readable view of the project's operational context.
+
+**Do not edit these files directly** — they are regenerated from
+\`intelligence/*.json\` and \`whale.config.json\` whenever you run
+\`whale sync\`.
+
+## Files
+
+- \`PROJECT.md\` — high-level project facts
+- \`FOUNDATIONS.md\` — grid, radius, tokens
+- \`CONVENTIONS.md\` — active conventions and refinements
+- \`DECISIONS.md\` — decision log
+- \`COMPONENTS.md\` — component catalog
+- \`WORKFLOWS.md\` — recommended usage flow
+
+## For AI agents
+
+The canonical entry point for AI agents is \`/CLAUDE.md\` at the project root.
+This wiki is the detailed view — start with the root file, drill in here.
+
+_Generated by Whale Igniter._
+`;
+}
+export function renderWorkflows(_config) {
+    return `# Workflows
+
+## Daily flow
+
+\`\`\`
+whale validate                  # see what's drifting
+whale refine "<note>"           # accept an intentional exception
+whale decision                  # record a non-obvious choice
+whale component add <name>      # register a new component
+whale sync                      # regenerate AI context
+\`\`\`
+
+## When to use what
+
+| You want to...                                | Command                       |
+| --------------------------------------------- | ----------------------------- |
+| See what's broken                             | \`whale validate\`            |
+| Accept an exception ("we use radius 0 here")  | \`whale refine "..."\`        |
+| Log an architecture/product choice            | \`whale decision\`            |
+| Track a new component                         | \`whale component add\`       |
+| Refresh AI context after manual edits         | \`whale sync\`                |
+| Produce human reports                         | \`whale docs\`                |
+| Review style drift interactively              | \`whale insights drift <cat>\`|
+
+## Recommended cadence
+
+- **Per change:** run \`validate\` before commit.
+- **Per significant choice:** record a \`decision\` or \`refinement\`.
+- **Per session:** run \`sync\` before handing off to an AI agent.
+- **Per sprint:** review \`whale insights drift spacing\` for accumulated drift.
+
+_Generated by Whale Igniter._
+`;
+}

package/dist/utils/aiAvailability.js

@@ -0,0 +1,25 @@
+import { loadConfig } from "./config.js";
+import { resolveTarget } from "./paths.js";
+export async function getAiAvailability(target) {
+    if (process.env.ANTHROPIC_API_KEY) {
+        return { available: true, source: "env-anthropic" };
+    }
+    if (process.env.OPENAI_API_KEY) {
+        return { available: true, source: "env-openai" };
+    }
+    try {
+        const ws = resolveTarget(target);
+        const config = await loadConfig(ws);
+        const provider = config.selene?.provider;
+        if (provider === "anthropic" && process.env.ANTHROPIC_API_KEY) {
+            return { available: true, source: "config" };
+        }
+        if (provider === "openai" && process.env.OPENAI_API_KEY) {
+            return { available: true, source: "config" };
+        }
+    }
+    catch {
+        // config unreadable — no AI
+    }
+    return { available: false, source: "none" };
+}

package/dist/utils/wizardMapping.js

@@ -0,0 +1,54 @@
+const PROJECT_TYPE_MAP = {
+    "web-app": "web-app",
+    "marketing-site": "landing-page",
+    "portfolio": "landing-page",
+    "internal-tool": "web-app",
+    "prototype": "web-app",
+    "other": "other"
+};
+const STACK_MAP = {
+    "react-ts": "tailwind",
+    "vue-ts": "css",
+    "svelte-ts": "css",
+    "html-css-js": "css",
+    "other": "css"
+};
+const AI_TARGETS_MAP = {
+    solo: ["claude"],
+    small: ["claude", "codex"],
+    large: ["claude", "codex", "cursor"]
+};
+export function suggestUiCategories(projectType) {
+    const map = {
+        "web-app": ["forms", "navigation", "feedback"],
+        "marketing-site": ["surface", "layout"],
+        "portfolio": ["surface", "layout"],
+        "internal-tool": ["forms", "navigation", "feedback", "data-display"],
+        "prototype": ["forms", "feedback"],
+        "other": ["forms"]
+    };
+    return map[projectType] ?? ["forms"];
+}
+export function mapWizardAnswers(answers) {
+    const projectType = PROJECT_TYPE_MAP[answers.projectType];
+    const stack = STACK_MAP[answers.stack];
+    const aiTargets = AI_TARGETS_MAP[answers.teamSize];
+    const packs = answers.agentPacks && answers.agentPacks.length > 0
+        ? answers.agentPacks
+        : ["selene"];
+    const uiReferences = answers.uiCategories ?? [];
+    const config = {
+        projectType,
+        stack,
+        aiTargets: aiTargets,
+        packs,
+        uiReferences,
+        foundations: { grid: 8, radius: { control: 2, container: 4 } },
+        branding: { tone: "enterprise-minimal", accent: "cyan" },
+        intelligence: { trackPreferences: true, trackRefinements: true, decisionLogging: true }
+    };
+    const projectIntentNote = answers.projectType === "other" && answers.projectTypeOther
+        ? answers.projectTypeOther
+        : undefined;
+    return { config, projectIntentNote };
+}

package/dist/version.js

@@ -1 +1 @@
-export const PACKAGE_VERSION = "1.2.2";
+export const PACKAGE_VERSION = "1.3.0";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "whale-igniter",
-  "version": "1.2.2",
+  "version": "1.3.0",
   "description": "CLI-first operational intelligence. Bootstraps and adopts AI-readable project context so agents like Claude Code, Codex and Cursor understand your design system from the first commit. Includes an MCP server, a file watcher, deterministic insights, and an opt-in AI bridge (Selene).",
   "type": "module",
   "main": "./dist/index.js",
@@ -18,7 +18,7 @@
     "dev": "tsx src/index.ts",
     "build": "tsc",
     "start": "node dist/index.js",
-    "test": "tsx tests/run.ts && tsx tests/mcp-smoke.ts",
+    "test": "tsx tests/run.ts && tsx tests/mcp-smoke.ts && tsx tests/extractors.ts && tsx tests/driftAnalyzers.ts",
     "prepublishOnly": "npm run build && npm test"
   },
   "engines": {