@entelligentsia/forgecli 0.8.4 → 0.9.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@entelligentsia/forgecli",
-  "version": "0.8.4",
+  "version": "0.9.0",
   "description": "Forge SDLC ported onto @earendil-works/pi-coding-agent — production launcher with three bin aliases (forge/forgecli/4ge). Bundles a curated fork of pi-coding-agent vendored under earendil-works names.",
   "license": "MIT",
   "author": "Entelligentsia",
@@ -70,10 +70,11 @@
     "js-yaml"
   ],
   "dependencies": {
-    "@earendil-works/pi-coding-agent": "file:./vendor-pi/earendil-works-pi-coding-agent-0.75.1-forge.4.tgz",
     "@earendil-works/pi-agent-core": "file:./vendor-pi/earendil-works-pi-agent-core-0.75.1.tgz",
     "@earendil-works/pi-ai": "file:./vendor-pi/earendil-works-pi-ai-0.75.1.tgz",
+    "@earendil-works/pi-coding-agent": "0.75.1-forge.4",
     "@earendil-works/pi-tui": "file:./vendor-pi/earendil-works-pi-tui-0.75.1.tgz",
+    "ajv": "^8.20.0",
     "js-yaml": "^4.1.0",
     "typebox": "^1.1.24"
   },
@@ -89,5 +90,12 @@
   },
   "engines": {
     "node": ">=20.6.0"
-  }
+  },
+  "bundleDependencies": [
+    "@earendil-works/pi-coding-agent",
+    "@earendil-works/pi-agent-core",
+    "@earendil-works/pi-ai",
+    "@earendil-works/pi-tui",
+    "js-yaml"
+  ]
 }

package/dist/extensions/forgecli/review-command.d.ts

@@ -1,2 +0,0 @@
-import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
-export declare function registerReviewCommand(pi: ExtensionAPI, forgeRoot: string | null): void;

package/dist/extensions/forgecli/review-command.js

@@ -1,184 +0,0 @@
-import * as fs from "node:fs/promises";
-import * as fsSync from "node:fs";
-import * as path from "node:path";
-import { execFile } from "node:child_process";
-import { promisify } from "node:util";
-import { startReviewServer } from "./review-server.js";
-const execFileAsync = promisify(execFile);
-function resolveToolDir(forgeRoot) {
-    const nested = path.join(forgeRoot, "tools");
-    try {
-        if (fsSync.statSync(nested).isDirectory())
-            return nested;
-    }
-    catch {
-        // nested missing — fall through to flat
-    }
-    return forgeRoot;
-}
-async function runStoreCli(toolDir, argv, cwd) {
-    const toolPath = path.join(toolDir, "store-cli.cjs");
-    const result = await execFileAsync("node", [toolPath, ...argv], {
-        cwd,
-        encoding: "utf8",
-        timeout: 10_000,
-    });
-    return JSON.parse(result.stdout);
-}
-/**
- * Resolution cascade:
- *   1. @path   → use the path directly as artifact directory
- *   2. Task ID → store-query query --task <id>
- *   3. Bug ID  → store-query query --bug <id>
- *   4. Feature ID → store-query query --feature <id>
- *   5. Sprint ID → store-query query --sprint <id>
- *   6. NLP     → store-query nlp "<query>"
- */
-async function resolveArg(arg, toolDir, cwd, ctx) {
-    // ── 1. @path ──────────────────────────────────────────────────────────────
-    if (arg.startsWith("@")) {
-        const rawPath = arg.slice(1).trim();
-        const resolved = path.isAbsolute(rawPath) ? rawPath : path.join(cwd, rawPath);
-        return { dir: resolved };
-    }
-    const taskIdRe = /^([A-Z0-9]+-)?S\d+-T\d+$/i;
-    const sprintIdRe = /^([A-Z0-9]+-)?S\d+$/i;
-    const bugIdRe = /^([A-Z0-9]+-)?B\d+$/i;
-    const featureIdRe = /^([A-Z0-9]+-)?F\d+$/i;
-    // ── 2-5. Structured ID → store-query query flags ─────────────────────────
-    let structuredResult = null;
-    try {
-        if (taskIdRe.test(arg)) {
-            ctx.ui.setStatus("forge:review", `Looking up task ${arg}…`);
-            structuredResult = await runStoreCli(toolDir, ["query", "--task", arg], cwd);
-        }
-        else if (bugIdRe.test(arg)) {
-            ctx.ui.setStatus("forge:review", `Looking up bug ${arg}…`);
-            structuredResult = await runStoreCli(toolDir, ["query", "--bug", arg], cwd);
-        }
-        else if (featureIdRe.test(arg)) {
-            ctx.ui.setStatus("forge:review", `Looking up feature ${arg}…`);
-            structuredResult = await runStoreCli(toolDir, ["query", "--feature", arg], cwd);
-        }
-        else if (sprintIdRe.test(arg)) {
-            ctx.ui.setStatus("forge:review", `Looking up sprint ${arg}…`);
-            structuredResult = await runStoreCli(toolDir, ["query", "--sprint", arg], cwd);
-        }
-    }
-    catch {
-        // structured query failed — fall through to NLP
-    }
-    if (structuredResult?.results?.length > 0) {
-        return pickFromResults(structuredResult.results, arg, ctx);
-    }
-    // ── 6. NLP fallback ───────────────────────────────────────────────────────
-    ctx.ui.setStatus("forge:review", `Searching Forge store: "${arg}"…`);
-    const nlpResult = await runStoreCli(toolDir, ["nlp", arg], cwd);
-    const items = (nlpResult.results || []).filter((r) => ["task", "sprint", "bug", "feature"].includes(r.type));
-    if (items.length === 0) {
-        ctx.ui.setStatus("forge:review", undefined);
-        ctx.ui.notify(`No records found matching "${arg}"`, "warning");
-        return null;
-    }
-    return pickFromResults(items, arg, ctx);
-}
-async function pickFromResults(items, arg, ctx) {
-    if (items.length === 1) {
-        return { item: items[0] };
-    }
-    ctx.ui.setStatus("forge:review", undefined);
-    const options = items.map((t) => `${t.id} (${t.type}): ${t.title}`);
-    const selection = await ctx.ui.select(`Multiple records found for "${arg}". Select one:`, options);
-    if (!selection)
-        return null;
-    const selectedId = selection.split(" ")[0].trim();
-    return { item: items.find((t) => t.id === selectedId) };
-}
-export function registerReviewCommand(pi, forgeRoot) {
-    pi.registerCommand("forge:review", {
-        description: "Review a Forge artifact in the browser and provide inline feedback",
-        async handler(args, ctx) {
-            if (!forgeRoot) {
-                ctx.ui.notify("forge:review — no Forge project at cwd; run /forge:init to bootstrap", "warning");
-                return;
-            }
-            const arg = args.trim();
-            if (!arg) {
-                ctx.ui.notify("Usage: /forge:review <task-id|sprint-id|@path|natural language>\n" +
-                    "Examples: /forge:review S01-T01  |  /forge:review S01  |  " +
-                    "/forge:review @engineering/sprints/HELLO-S01/HELLO-S01-T01  |  " +
-                    "/forge:review the i18n task", "error");
-                return;
-            }
-            const toolDir = resolveToolDir(forgeRoot);
-            const resolved = await resolveArg(arg, toolDir, ctx.cwd, ctx).catch((err) => {
-                ctx.ui.setStatus("forge:review", undefined);
-                ctx.ui.notify(`Store query failed: ${err.message}`, "error");
-                return null;
-            });
-            if (!resolved)
-                return;
-            // Determine artifact directory and display label
-            let taskDir;
-            let label;
-            if ("dir" in resolved) {
-                taskDir = resolved.dir;
-                label = path.basename(taskDir);
-            }
-            else {
-                const item = resolved.item;
-                if (!item.fileRefs?.md) {
-                    ctx.ui.notify(`No markdown index found for ${item.id}`, "error");
-                    return;
-                }
-                taskDir = path.dirname(path.join(ctx.cwd, item.fileRefs.md));
-                label = `${item.id} — ${item.title}`;
-                ctx.ui.notify(`Resolved to ${item.type}: ${item.id} (${item.title})`, "info");
-            }
-            // List markdown files in artifact directory
-            let files;
-            try {
-                files = await fs.readdir(taskDir);
-            }
-            catch {
-                ctx.ui.notify(`No artifacts found at ${taskDir}`, "warning");
-                return;
-            }
-            const mdFiles = files.filter(f => f.endsWith(".md"));
-            if (mdFiles.length === 0) {
-                ctx.ui.notify(`No markdown artifacts found at ${taskDir}`, "info");
-                return;
-            }
-            const selectedFile = await ctx.ui.select(`Select artifact to review for ${label}:`, mdFiles);
-            if (!selectedFile)
-                return;
-            const artifactPath = path.join(taskDir, selectedFile);
-            ctx.ui.notify(`Starting local review server for ${selectedFile}…`, "info");
-            ctx.ui.setStatus("forge:review", "Waiting for browser review…");
-            try {
-                const feedback = await startReviewServer(artifactPath, `${label} — ${selectedFile}`);
-                ctx.ui.setStatus("forge:review", undefined);
-                if (feedback && feedback.length > 0) {
-                    ctx.ui.notify(`Received ${feedback.length} feedback item(s). Sending to Forge…`, "info");
-                    const itemType = "item" in resolved ? resolved.item.type : "artifact";
-                    const itemId = "item" in resolved ? resolved.item.id : label;
-                    let promptText = `I have reviewed the artifact \`${selectedFile}\` for ${itemType} ${itemId}. Here is my inline feedback:\n\n`;
-                    for (const fb of feedback) {
-                        promptText += `> **Text:** "${fb.selectedText}"\n`;
-                        promptText += `> **Feedback:** ${fb.comment}\n\n`;
-                    }
-                    promptText += `Please process this feedback and update the artifact accordingly.`;
-                    await pi.sendUserMessage(promptText);
-                }
-                else {
-                    ctx.ui.notify("Review completed with no feedback submitted.", "info");
-                }
-            }
-            catch (err) {
-                ctx.ui.setStatus("forge:review", undefined);
-                ctx.ui.notify(`forge:review error: ${err.message}`, "error");
-            }
-        },
-    });
-}
-//# sourceMappingURL=review-command.js.map

package/dist/extensions/forgecli/review-command.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"review-command.js","sourceRoot":"","sources":["../../../src/extensions/forgecli/review-command.ts"],"names":[],"mappings":"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"}

package/dist/forge-payload/.tools/banners.cjs

@@ -1,435 +0,0 @@
-'use strict';
-
-// Forge Banner Library
-// Reusable agent identity display for tools, hooks, and skills.
-//
-// Render modes:
-//   render(name)             — full ASCII art block + emoji + name + tagline
-//   badge(name)              — single line: emoji + bold name + dim tagline
-//   mark(name)               — emoji only (for use alongside 〇△× status marks)
-//   progressBar(n,total,opt) — unicode block bar with optional gradient + label
-//   subtitle(text, opts)     — dim italic line for under-banner taglines
-//   phaseHeader(...)         — convenience: badge + em-dash banner + progress bar
-//
-// Plain mode: ANSI escapes are stripped when any of these is true:
-//   - env FORGE_BANNERS_PLAIN is set to a non-empty value
-//   - env NO_COLOR is set to a non-empty value
-//   - process.stdout.isTTY === false
-//   - CLI flag --plain is passed
-//
-// Usage (module):
-//   const banners = require('./banners.cjs');
-//   console.log(banners.render('forge'));
-//   console.log(banners.progressBar(5, 12, { label: 'Templates', color: [255,208,122] }));
-//
-// Usage (CLI):
-//   node banners.cjs forge
-//   node banners.cjs --badge north
-//   node banners.cjs --mark tide
-//   node banners.cjs --gallery
-//   node banners.cjs --list
-//   node banners.cjs --plain forge
-//   node banners.cjs --subtitle "Forging your SDLC"
-//   node banners.cjs --progress 5 12 "Templates"
-//   node banners.cjs --phase 7 12 "Workflows" ember fast
-
-// ─── Plain-mode detection ─────────────────────────────────────────────────────
-// Resolved at call-time so tests can flip env vars dynamically.
-function isPlain() {
-  if (process.env.FORGE_BANNERS_PLAIN) return true;
-  if (process.env.NO_COLOR) return true;
-  if (process.stdout && process.stdout.isTTY === false) return true;
-  return false;
-}
-
-// Strip ANSI escape sequences (CSI). Conservative — matches \x1b[...m and friends.
-const ANSI_RE = /\x1b\[[0-9;]*[A-Za-z]/g;
-function stripAnsi(s) {
-  return String(s).replace(ANSI_RE, '');
-}
-
-// Soft override — set by `--plain` CLI flag to force plain mode for one run.
-let FORCE_PLAIN = false;
-
-// ─── ANSI helpers ─────────────────────────────────────────────────────────────
-const R = '\x1b[0m';
-const B = '\x1b[1m';
-const D = '\x1b[2m';
-const I = '\x1b[3m';
-const f = (r, g, b) => `\x1b[38;2;${r};${g};${b}m`;
-
-// ─── Mode tints ───────────────────────────────────────────────────────────────
-// Mode-aware accent colour for progress bars and subtitles. Used by phaseHeader.
-const MODE_TINTS = {
-  fast: [255, 208, 122],   // lantern yellow
-  full: [255, 138, 60],    // ember orange
-};
-
-// ─── Zen blue ─────────────────────────────────────────────────────────────────
-// System-wide horizontal-rule tint. Applied to em-dash separators in
-// phaseHeader, ruleLine, and ensure-ready.cjs --announce framing. Picked to
-// read calm and cool without competing with banner colours.
-const ZEN_BLUE = [100, 140, 200];
-
-// ─── Banner registry ───────────────────────────────────────────────────────────
-const BANNERS = {
-
-  ember: {
-    emoji:   '🔥',
-    tagline: 'heat · ignition · drive',
-    name:    'EMBER',
-    kanji:   '炎',
-    color:   [255, 170, 60],
-    art:     `  ${f(255,240,100)})  ${f(255,200,50)})  ${f(255,140,20)}(${f(230,80,10)}🔥${f(255,140,20)})  ${f(230,80,10)}~∿~  ${f(170,30,5)}≋≋≋`,
-  },
-
-  tide: {
-    emoji:   '🌊',
-    tagline: 'rhythm · pull · depth',
-    name:    'TIDE',
-    kanji:   '潮',
-    color:   [110, 200, 255],
-    art:     `  ${f(210,240,255)}∿  ${f(130,200,245)}≋≋≋  ${f(60,140,210)}≋≋≋  ${f(25,85,175)}▓▓▓  ${f(10,45,130)}▓▓▓`,
-  },
-
-  oracle: {
-    emoji:   '🌕',
-    tagline: 'sight · pattern · knowing',
-    name:    'ORACLE',
-    kanji:   '神託',
-    color:   [210, 160, 255],
-    art:     `  ${f(160,80,240)}· ◌  ${f(190,110,255)}◎  ${f(255,220,100)}◉  ${f(190,110,255)}◎  ${f(160,80,240)}◌ ·`,
-  },
-
-  rift: {
-    emoji:   '⚡',
-    tagline: 'edge · fracture · crossing',
-    name:    'RIFT',
-    kanji:   '裂',
-    color:   [100, 255, 240],
-    art:     `  ${f(0,240,230)}▓▒░  ${f(180,0,220)}╲ ${f(0,255,240)}⚡${f(180,0,220)} ╱  ${f(0,240,230)}░▒▓`,
-  },
-
-  bloom: {
-    emoji:   '🌸',
-    tagline: 'growth · opening · becoming',
-    name:    'BLOOM',
-    kanji:   '開花',
-    color:   [255, 160, 190],
-    art:     `  ${f(255,160,200)}✿ ✿  ${f(255,120,170)}✾  ${f(255,220,100)}✽  ${f(255,120,170)}✾  ${f(255,160,200)}✿ ✿`,
-  },
-
-  north: {
-    emoji:   '🧭',
-    tagline: 'direction · clarity · cold',
-    name:    'NORTH',
-    kanji:   '北',
-    color:   [190, 225, 255],
-    art:     `  ${f(200,230,255)}✦  ${f(150,195,240)}╱  ${f(100,160,230)}◈  ${f(150,195,240)}╲  ${f(200,230,255)}✦`,
-  },
-
-  lumen: {
-    emoji:   '✨',
-    tagline: 'light · warmth · clarity',
-    name:    'LUMEN',
-    kanji:   '光',
-    color:   [255, 245, 150],
-    art:     `  ${f(255,255,200)}✧  ${f(255,245,160)}──  ${f(255,255,255)}◉  ${f(255,245,160)}──  ${f(255,255,200)}✧`,
-  },
-
-  forge: {
-    emoji:   '🔨',
-    tagline: 'making · heat · craft',
-    name:    'FORGE',
-    kanji:   '鍛冶',
-    color:   [255, 160, 40],
-    art:     `  ${f(255,230,80)}✦  ${f(200,80,20)}▄${f(230,100,30)}▓▓▓▓▓${f(200,80,20)}▄  ${f(255,160,40)}≋ ≋ ≋`,
-  },
-
-  drift: {
-    emoji:   '🍃',
-    tagline: 'ease · letting go · flow',
-    name:    'DRIFT',
-    kanji:   '漂流',
-    color:   [150, 200, 165],
-    art:     `  ${f(160,200,170)}·  ${f(140,180,155)}·   ${f(120,165,140)}·  ${f(100,150,125)}·   ${f(80,135,110)}·`,
-  },
-
-  void: {
-    emoji:   '🌑',
-    tagline: 'depth · silence · potential',
-    name:    'VOID',
-    kanji:   '虚空',
-    color:   [130, 100, 200],
-    art:     `  ${f(30,20,60)}  ·  ${f(70,50,120)}◌  ${f(50,35,90)}·  `,
-  },
-
-  entelligentsia: {
-    emoji:   '🔗',
-    tagline: 'linked · intellect · becoming',
-    name:    'ENTELLIGENTSIA',
-    kanji:   '知性',
-    color:   [140, 200, 60],
-    art:     `  ${f(110,110,115)}╭──╯  ${f(140,200,60)}─╮ ╭─  ${f(110,110,115)}╰──╮`,
-  },
-
-};
-
-// ─── Render helpers ────────────────────────────────────────────────────────────
-
-/** Dim dot rule — use between banners in a gallery */
-function rule() {
-  return `  ${f(45,45,65)}${'·'.repeat(32)}${R}`;
-}
-
-/**
- * Full banner: ASCII art block + emoji + name + tagline.
- * @param {string} name  Banner key (case-insensitive).
- * @returns {string}
- */
-function render(name) {
-  const b = _get(name);
-  const [r, g, bl] = b.color;
-  const kanji = b.kanji ? `  ${D}${f(r,g,bl)}${b.kanji}${R}` : '';
-  const label = `  ${b.emoji}  ${B}${f(r,g,bl)}${b.name}${R}${kanji}   ${D}${f(r,g,bl)}${b.tagline}${R}`;
-  const out = '\n' + b.art + R + '\n' + label + '\n';
-  return _maybePlain(out);
-}
-
-/**
- * Badge: single line — emoji + bold name + dim tagline.
- * Fits inline in status output or skill headers.
- * @param {string} name
- * @returns {string}
- */
-function badge(name) {
-  const b = _get(name);
-  const [r, g, bl] = b.color;
-  const kanji = b.kanji ? `  ${D}${f(r,g,bl)}${b.kanji}${R}` : '';
-  return _maybePlain(`${b.emoji}  ${B}${f(r,g,bl)}${b.name}${R}${kanji}  ${D}${f(r,g,bl)}${b.tagline}${R}`);
-}
-
-/**
- * Mark: emoji only.
- * Use alongside 〇△× status marks for agent attribution.
- * @param {string} name
- * @returns {string}
- */
-function mark(name) {
-  return _get(name).emoji;
-}
-
-/**
- * Progress bar: unicode block bar with optional gradient tint and label.
- *   ▰▰▰▰▰▱▱▱▱▱▱▱  Phase 5/12 · Templates
- *
- * @param {number} n      Filled cells (clamped to [0, total])
- * @param {number} total  Total cells across the bar's logical range
- * @param {object} [opts]
- * @param {number} [opts.width=12]   Cells in the bar (independent of n/total)
- * @param {number[]} [opts.color]    [r,g,b] tint for filled segment
- * @param {string} [opts.label]      Trailing label after the bar
- * @param {string} [opts.fillGlyph='▰'] Override filled cell glyph
- * @param {string} [opts.emptyGlyph='▱'] Override empty cell glyph
- * @returns {string}
- */
-function progressBar(n, total, opts) {
-  const o = opts || {};
-  const width = Math.max(1, o.width || 12);
-  const fillGlyph = o.fillGlyph || '▰';
-  const emptyGlyph = o.emptyGlyph || '▱';
-  const safeTotal = Math.max(1, total || 1);
-  const safeN = Math.max(0, Math.min(n || 0, safeTotal));
-  const filledCells = Math.round((safeN / safeTotal) * width);
-  const emptyCells = width - filledCells;
-
-  let bar = '';
-  if (filledCells > 0) {
-    const tint = Array.isArray(o.color) ? f(o.color[0], o.color[1], o.color[2]) : '';
-    const reset = tint ? R : '';
-    bar += `${tint}${fillGlyph.repeat(filledCells)}${reset}`;
-  }
-  if (emptyCells > 0) {
-    bar += `${D}${emptyGlyph.repeat(emptyCells)}${R}`;
-  }
-
-  const counter = `  ${safeN}/${safeTotal}`;
-  const label = o.label ? `  ${D}·${R}  ${o.label}` : '';
-  return _maybePlain(bar + counter + label);
-}
-
-/**
- * Subtitle: dim italic line under a banner. Single line.
- *
- * @param {string} text
- * @param {object} [opts]
- * @param {number[]} [opts.color]   Optional tint
- * @returns {string}
- */
-function subtitle(text, opts) {
-  const o = opts || {};
-  const tint = Array.isArray(o.color) ? f(o.color[0], o.color[1], o.color[2]) : '';
-  return _maybePlain(`  ${D}${I}${tint}${text}${R}`);
-}
-
-/**
- * Em-dash rule line, tinted zen blue by default.
- *   ━━━ {text} ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
- *
- * Use as a horizontal section separator anywhere in the system. Calling
- * with no text produces a plain rule (just em-dashes, no label).
- *
- * @param {string} [text]   Optional label to embed in the rule
- * @param {object} [opts]
- * @param {number} [opts.width=65]   Total line width
- * @param {number[]} [opts.color]    [r,g,b] override tint; defaults to ZEN_BLUE
- * @returns {string}
- */
-function ruleLine(text, opts) {
-  const o = opts || {};
-  const width = o.width || 65;
-  const color = Array.isArray(o.color) ? o.color : ZEN_BLUE;
-  const tint = f(color[0], color[1], color[2]);
-
-  let line;
-  if (text && text.length > 0) {
-    const head = `━━━ ${text} `;
-    const padCount = Math.max(3, width - head.length);
-    line = head + '━'.repeat(padCount);
-  } else {
-    line = '━'.repeat(width);
-  }
-  return _maybePlain(`${tint}${line}${R}`);
-}
-
-/**
- * Phase header: multi-line — badge, em-dash banner, progress bar.
- * Concatenates with newlines so a single println prints all three.
- *
- * @param {number} n           Phase number (1-based)
- * @param {number} total       Total phases
- * @param {string} name        Phase display name
- * @param {string} bannerKey   Banner registry key (e.g. 'north', 'forge')
- * @param {object|string} [opts]
- *        Pass a string to use as the mode tint key ('fast' | 'full'),
- *        or an opts object with { mode, color, width }.
- * @returns {string}
- */
-function phaseHeader(n, total, name, bannerKey, opts) {
-  let o = {};
-  if (typeof opts === 'string') {
-    o = { mode: opts };
-  } else if (opts) {
-    o = opts;
-  }
-  const tint = o.color || (o.mode && MODE_TINTS[o.mode.toLowerCase()]) || null;
-
-  const bar = progressBar(n, total, {
-    width: o.width || 12,
-    color: tint,
-    label: name,
-  });
-
-  // Em-dash banner — match the existing format used across all forge commands,
-  // tinted zen blue for system-wide visual consistency on horizontal rules.
-  const emBanner = ruleLine(`Phase ${n}/${total} — ${name}`);
-
-  const lines = [
-    badge(bannerKey),
-    emBanner,
-    bar,
-  ];
-  return lines.join('\n');
-}
-
-/**
- * All available banner names.
- * @returns {string[]}
- */
-function list() {
-  return Object.keys(BANNERS);
-}
-
-/**
- * Full gallery of all banners separated by rules.
- * @returns {string}
- */
-function gallery() {
-  return list().map((name, i) => {
-    const sep = i > 0 ? '\n' + rule() + '\n' : '';
-    return sep + render(name);
-  }).join('');
-}
-
-// ─── Internal ──────────────────────────────────────────────────────────────────
-
-function _get(name) {
-  const b = BANNERS[name.toLowerCase()];
-  if (!b) {
-    throw new Error(`Unknown banner "${name}". Available: ${list().join(', ')}`);
-  }
-  return b;
-}
-
-function _maybePlain(s) {
-  return (FORCE_PLAIN || isPlain()) ? stripAnsi(s) : s;
-}
-
-// ─── CLI ───────────────────────────────────────────────────────────────────────
-// node banners.cjs [<name>] [--gallery] [--badge <name>] [--mark <name>] [--list]
-
-if (require.main === module) {
-  let args = process.argv.slice(2);
-
-  // --plain may appear anywhere; consume it first.
-  const plainIdx = args.indexOf('--plain');
-  if (plainIdx !== -1) {
-    FORCE_PLAIN = true;
-    args = args.slice(0, plainIdx).concat(args.slice(plainIdx + 1));
-  }
-
-  try {
-    if (!args.length || args[0] === '--gallery') {
-      process.stdout.write(gallery() + '\n');
-    } else if (args[0] === '--list') {
-      console.log(list().map(n => {
-        const b = BANNERS[n];
-        return `${b.emoji}  ${n.padEnd(8)} — ${b.tagline}`;
-      }).join('\n'));
-    } else if (args[0] === '--badge') {
-      console.log(badge(args[1] || ''));
-    } else if (args[0] === '--mark') {
-      console.log(mark(args[1] || ''));
-    } else if (args[0] === '--subtitle') {
-      console.log(subtitle(args.slice(1).join(' ')));
-    } else if (args[0] === '--progress') {
-      const n = Number(args[1]);
-      const total = Number(args[2]);
-      const label = args.slice(3).join(' ') || undefined;
-      console.log(progressBar(n, total, { label }));
-    } else if (args[0] === '--phase') {
-      const n = Number(args[1]);
-      const total = Number(args[2]);
-      const name = args[3] || '';
-      const bannerKey = args[4] || 'forge';
-      const mode = args[5];   // optional 'fast' | 'full'
-      console.log(phaseHeader(n, total, name, bannerKey, mode ? { mode } : undefined));
-    } else if (args[0] === '--rule') {
-      // --rule [text]   Zen-blue em-dash horizontal rule (with optional label)
-      const text = args.slice(1).join(' ') || undefined;
-      console.log(ruleLine(text));
-    } else {
-      process.stdout.write(render(args[0]) + '\n');
-    }
-  } catch (e) {
-    console.error(e.message);
-    process.exit(1);
-  }
-}
-
-// ─── Exports ───────────────────────────────────────────────────────────────────
-module.exports = {
-  render, badge, mark, list, gallery, rule, BANNERS,
-  progressBar, subtitle, phaseHeader, ruleLine,
-  isPlain, stripAnsi, MODE_TINTS, ZEN_BLUE,
-};