whale-igniter 1.4.0 → 1.5.2

package/dist/templates/decisions.js

@@ -1,12 +1,21 @@
-const MAX_DETAIL = 500;
-function truncate(text) {
-    return text.length > MAX_DETAIL ? text.slice(0, MAX_DETAIL) + "…" : text;
+const MAX_SUMMARY = 120;
+function summarize(d) {
+    const text = (d.context ?? d.decision).replace(/\s+/g, " ").trim();
+    const oneLine = text.length > MAX_SUMMARY ? text.slice(0, MAX_SUMMARY) + "…" : text;
+    return oneLine.replace(/\|/g, "\\|");
+}
+function linkFor(d) {
+    // Wiki lives in llm-wiki/; decisions live in intelligence/decisions/.
+    if (!d.sourcePath)
+        return d.title;
+    return `[${d.title}](../${d.sourcePath})`;
 }
 export function renderDecisions(decisions) {
     const lines = [
         "# Decision Log",
         "",
-        "Architectural, product and tooling decisions, most recent first.",
+        "Compact index of architectural, product and tooling decisions, most recent first.",
+        "Open the linked file for full Context / Decision / Consequences.",
         ""
     ];
     if (decisions.length === 0) {
@@ -14,20 +23,12 @@ export function renderDecisions(decisions) {
     }
     else {
         const sorted = [...decisions].sort((a, b) => b.timestamp.localeCompare(a.timestamp));
+        lines.push("| ID | Decision | Category | Status | Summary |");
+        lines.push("| --- | --- | --- | --- | --- |");
         for (const d of sorted) {
-            lines.push(`## ${d.title}`);
-            lines.push("");
-            lines.push(`_${d.timestamp.slice(0, 10)} · ${d.category} · ${d.status}_`);
-            lines.push("");
-            if (d.context) {
-                lines.push("**Context**", "", truncate(d.context), "");
-            }
-            lines.push("**Decision**", "", truncate(d.decision));
-            if (d.consequences) {
-                lines.push("", "**Consequences**", "", truncate(d.consequences));
-            }
-            lines.push("", "---", "");
+            lines.push(`| ${d.id} | ${linkFor(d)} | ${d.category} | ${d.status} | ${summarize(d)} |`);
         }
+        lines.push("");
     }
     lines.push("_Generated by Whale Igniter._");
     return lines.join("\n");

package/dist/ui/splash.js

@@ -13,6 +13,13 @@ import { capabilities } from "./capabilities.js";
 import { accent, muted, emphasis } from "./atoms.js";
 import { PACKAGE_VERSION } from "../version.js";
 const TAGLINE = "map the project before the agent moves";
+const BLOCK = [
+    ` _|          _|  _|    _|    _|_|    _|        _|_|_|_|  `,
+    ` _|          _|  _|    _|  _|    _|  _|        _|        `,
+    ` _|    _|    _|  _|_|_|_|  _|_|_|_|  _|        _|_|_|    `,
+    `   _|  _|  _|    _|    _|  _|    _|  _|        _|        `,
+    `     _|  _|      _|    _|  _|    _|  _|_|_|_|  _|_|_|_|  `,
+].join("\n");
 export function splash() {
     const { color, unicode } = capabilities();
     const isPlain = !unicode;
@@ -20,17 +27,15 @@ export function splash() {
     if (isPlain) {
         return `WHALE IGNITER v${PACKAGE_VERSION} — ${TAGLINE}`;
     }
-    // Tier 1 & 2 — unicode layout (color applied via atom functions when available)
-    const whale = "◆ ～";
-    const wordmarkWhale = color ? accent("WHALE") : "WHALE";
     const wordmarkIgniter = color ? emphasis("IGNITER") : "IGNITER";
     const version = color ? muted(`v${PACKAGE_VERSION}`) : `v${PACKAGE_VERSION}`;
     const tag = color ? muted(TAGLINE) : TAGLINE;
-    const rule = "─".repeat(36);
+    const title = color ? accent(BLOCK) : BLOCK;
+    const rule = "─".repeat(50);
     return [
-        `${whale}`,
-        `${wordmarkWhale} ${wordmarkIgniter}  ${version}`,
+        title,
+        `${wordmarkIgniter}  ·  ${version}`,
         tag,
-        rule
+        rule,
     ].join("\n");
 }

package/dist/utils/decisions.js

@@ -1,9 +1,60 @@
 import path from "node:path";
 import fs from "fs-extra";
-import { randomUUID } from "node:crypto";
-const STORE = "intelligence/decisions.json";
-export async function loadDecisions(target) {
-    const file = path.join(target, STORE);
+import matter from "gray-matter";
+const DIR = "intelligence/decisions";
+const LEGACY_STORE = "intelligence/decisions.json";
+function slugify(title) {
+    return title
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .slice(0, 60);
+}
+function section(body, heading) {
+    const re = new RegExp(`^##\\s+${heading}\\s*$([\\s\\S]*?)(?=^##\\s+|(?![\\s\\S]))`, "im");
+    const match = body.match(re);
+    const text = match?.[1]?.trim();
+    return text && text.length > 0 ? text : undefined;
+}
+function parseFile(raw) {
+    const { data, content } = matter(raw);
+    const decision = section(content, "Decision");
+    if (!data.id || !data.title || !decision)
+        return null;
+    return {
+        id: String(data.id),
+        timestamp: String(data.createdAt ?? data.timestamp ?? ""),
+        title: String(data.title),
+        category: (data.category ?? "architecture"),
+        context: section(content, "Context"),
+        decision,
+        consequences: section(content, "Consequences"),
+        status: (data.status ?? "active"),
+        supersedes: data.supersedes ? String(data.supersedes) : undefined
+    };
+}
+function serialize(d) {
+    const fm = matter.stringify([
+        "## Context",
+        d.context ?? "",
+        "",
+        "## Decision",
+        d.decision,
+        "",
+        "## Consequences",
+        d.consequences ?? ""
+    ].join("\n"), {
+        id: d.id,
+        title: d.title,
+        category: d.category,
+        status: d.status,
+        createdAt: d.timestamp,
+        supersedes: d.supersedes ?? null
+    });
+    return fm;
+}
+async function loadLegacy(target) {
+    const file = path.join(target, LEGACY_STORE);
     if (!(await fs.pathExists(file)))
         return [];
     try {
@@ -13,20 +64,49 @@ export async function loadDecisions(target) {
         return [];
     }
 }
-export async function saveDecisions(target, decisions) {
-    const file = path.join(target, STORE);
-    await fs.ensureDir(path.dirname(file));
-    await fs.writeJson(file, decisions, { spaces: 2 });
+export async function loadDecisions(target) {
+    const dir = path.join(target, DIR);
+    const fromFiles = [];
+    if (await fs.pathExists(dir)) {
+        const entries = (await fs.readdir(dir)).filter((f) => f.endsWith(".md")).sort();
+        for (const entry of entries) {
+            const raw = await fs.readFile(path.join(dir, entry), "utf8");
+            const parsed = parseFile(raw);
+            if (parsed) {
+                parsed.sourcePath = `${DIR}/${entry}`;
+                fromFiles.push(parsed);
+            }
+        }
+    }
+    // Dual read: surface legacy JSON entries that haven't been migrated yet.
+    const legacy = await loadLegacy(target);
+    const seen = new Set(fromFiles.map((d) => d.id));
+    for (const d of legacy) {
+        if (!seen.has(d.id))
+            fromFiles.push(d);
+    }
+    return fromFiles;
+}
+function nextId(existing) {
+    let max = 0;
+    for (const d of existing) {
+        const m = /^ADR-(\d+)$/.exec(d.id);
+        if (m)
+            max = Math.max(max, Number(m[1]));
+    }
+    return `ADR-${String(max + 1).padStart(4, "0")}`;
 }
 export async function appendDecision(target, input) {
-    const decisions = await loadDecisions(target);
+    const existing = await loadDecisions(target);
     const decision = {
-        id: randomUUID(),
-        timestamp: new Date().toISOString(),
+        id: nextId(existing),
+        timestamp: new Date().toISOString().slice(0, 10),
         status: "active",
         ...input
     };
-    decisions.push(decision);
-    await saveDecisions(target, decisions);
+    const dir = path.join(target, DIR);
+    await fs.ensureDir(dir);
+    const file = path.join(dir, `${decision.id}-${slugify(decision.title)}.md`);
+    await fs.writeFile(file, serialize(decision));
     return decision;
 }

package/dist/utils/refinements.js

@@ -1,9 +1,49 @@
 import path from "node:path";
 import fs from "fs-extra";
-const STORE_FILENAME = "refinements.json";
-const STORE_DIR = "intelligence";
-export async function loadRefinements(target) {
-    const file = path.join(target, STORE_DIR, STORE_FILENAME);
+import matter from "gray-matter";
+const DIR = "intelligence/refinements";
+const LEGACY_STORE = "intelligence/refinements.json";
+function slugify(text) {
+    return text
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .slice(0, 60);
+}
+function parseFile(raw) {
+    const { data, content } = matter(raw);
+    const note = content.trim();
+    if (!data.id || !note)
+        return null;
+    const scope = {};
+    if (data.issueType)
+        scope.issueType = String(data.issueType);
+    if (data.selector)
+        scope.selector = String(data.selector);
+    if (data.file)
+        scope.file = String(data.file);
+    return {
+        id: String(data.id),
+        timestamp: String(data.createdAt ?? data.timestamp ?? ""),
+        note,
+        scope: Object.keys(scope).length > 0 ? scope : undefined
+    };
+}
+function serialize(r) {
+    const fm = {
+        id: r.id,
+        createdAt: r.timestamp
+    };
+    if (r.scope?.issueType)
+        fm.issueType = r.scope.issueType;
+    if (r.scope?.selector)
+        fm.selector = r.scope.selector;
+    if (r.scope?.file)
+        fm.file = r.scope.file;
+    return matter.stringify(r.note, fm);
+}
+async function loadLegacy(target) {
+    const file = path.join(target, LEGACY_STORE);
     if (!(await fs.pathExists(file)))
         return [];
     try {
@@ -13,16 +53,49 @@ export async function loadRefinements(target) {
         return [];
     }
 }
-export async function saveRefinements(target, refinements) {
-    const dir = path.join(target, STORE_DIR);
-    await fs.ensureDir(dir);
-    const file = path.join(dir, STORE_FILENAME);
-    await fs.writeJson(file, refinements, { spaces: 2 });
+export async function loadRefinements(target) {
+    const dir = path.join(target, DIR);
+    const fromFiles = [];
+    if (await fs.pathExists(dir)) {
+        const entries = (await fs.readdir(dir)).filter((f) => f.endsWith(".md")).sort();
+        for (const entry of entries) {
+            const raw = await fs.readFile(path.join(dir, entry), "utf8");
+            const parsed = parseFile(raw);
+            if (parsed)
+                fromFiles.push({ ...parsed, sourcePath: `${DIR}/${entry}` });
+        }
+    }
+    // Dual read: surface legacy JSON entries that haven't been migrated yet.
+    const legacy = await loadLegacy(target);
+    const seen = new Set(fromFiles.map((r) => r.id));
+    for (const r of legacy) {
+        if (!seen.has(r.id))
+            fromFiles.push(r);
+    }
+    return fromFiles;
 }
-export async function appendRefinement(target, refinement) {
-    const current = await loadRefinements(target);
-    current.push(refinement);
-    await saveRefinements(target, current);
+function nextId(existing) {
+    let max = 0;
+    for (const r of existing) {
+        const m = /^REF-(\d+)$/.exec(r.id);
+        if (m)
+            max = Math.max(max, Number(m[1]));
+    }
+    return `REF-${String(max + 1).padStart(4, "0")}`;
+}
+export async function appendRefinement(target, input) {
+    const existing = await loadRefinements(target);
+    const refinement = {
+        id: nextId(existing),
+        timestamp: new Date().toISOString().slice(0, 10),
+        note: input.note,
+        scope: input.scope
+    };
+    const dir = path.join(target, DIR);
+    await fs.ensureDir(dir);
+    const file = path.join(dir, `${refinement.id}-${slugify(refinement.note)}.md`);
+    await fs.writeFile(file, serialize(refinement));
+    return refinement;
 }
 // Lightweight natural-language extractor. Recognises hints like:
 //   "Button radius should remain 2px for controls" -> issueType: radius-consistency

package/dist/version.js

@@ -1 +1 @@
-export const PACKAGE_VERSION = "1.4.0";
+export const PACKAGE_VERSION = "1.5.2";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "whale-igniter",
-  "version": "1.4.0",
+  "version": "1.5.2",
   "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",
@@ -21,6 +21,7 @@
   "scripts": {
     "dev": "tsx src/index.ts",
     "build": "tsc",
+    "postbuild": "node -e \"require('node:fs').chmodSync('dist/index.js', 0o755)\"",
     "start": "node dist/index.js",
     "test": "tsx tests/run.ts && tsx tests/mcp-smoke.ts && tsx tests/extractors.ts && tsx tests/driftAnalyzers.ts",
     "prepublishOnly": "npm run build && npm test"
@@ -64,7 +65,8 @@
     "chalk": "^5.3.0",
     "commander": "^12.1.0",
     "fs-extra": "^11.2.0",
-    "glob": "^10.4.5",
+    "glob": "^13.0.6",
+    "gray-matter": "^4.0.3",
     "ora": "^8.1.0",
     "postcss": "^8.4.47",
     "prompts": "^2.4.2",