aiden-runtime 4.6.0 → 4.7.0

package/dist/core/v4/ui/banner.js

@@ -0,0 +1,133 @@
+"use strict";
+/**
+ * Copyright (c) 2026 Shiva Deore (Taracod).
+ * Licensed under AGPL-3.0. See LICENSE for details.
+ *
+ * Aiden — local-first agent.
+ */
+/**
+ * core/v4/ui/banner.ts — ONB1 slice 2 (v4.7 onboarding rework).
+ *
+ * Auto-width banner block builder used by the disclaimer + success
+ * screens. Re-uses the existing ANSI-Shadow AIDEN ASCII art shipped
+ * in cli/v4/display.ts (constant `AIDEN_BANNER`) but composes it
+ * inside a centred panel with tagline, version, and credit lines —
+ * with no dependency on the skin engine.
+ *
+ * Layout @ ≥80 cols:
+ *
+ *     ╔══════════════════════════════════════════════════════════════╗
+ *     ║                                                              ║
+ *     ║                ▀▀▀█▀▀  ▀▀█ ▀▀█▀▀  ▄▄▄▄  ▄▄▄                  ║
+ *     ║                  █  █▄▄▄█    █  █    █    █                  ║
+ *     ║                  ...AIDEN ASCII (block style, brand orange)  ║
+ *     ║                                                              ║
+ *     ╚══════════════════════════════════════════════════════════════╝
+ *
+ *       Autonomous AI Engine · Local-first · v4.6.0
+ *
+ *       Built solo · By Taracod · White Lotus
+ *
+ * Narrow (<60 cols): collapses to a single-line title.
+ *
+ * Pure renderer — returns the composed string. Callers own the write.
+ * No stateful spinners / inquirer prompts here.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderBanner = renderBanner;
+exports.renderTitleLine = renderTitleLine;
+exports.bannerDiagnostic = bannerDiagnostic;
+const theme_1 = require("./theme");
+/**
+ * The block-style AIDEN ASCII. Copied from cli/v4/display.ts so this
+ * module has zero coupling to the skin-engine display surface. 6 rows,
+ * widest row = 36 cells.
+ */
+const AIDEN_ART = String.raw `
+█████╗  ██╗██████╗ ███████╗███╗   ██╗
+██╔══██╗██║██╔══██╗██╔════╝████╗  ██║
+███████║██║██║  ██║█████╗  ██╔██╗ ██║
+██╔══██║██║██║  ██║██╔══╝  ██║╚██╗██║
+██║  ██║██║██████╔╝███████╗██║ ╚████║
+╚═╝  ╚═╝╚═╝╚═════╝ ╚══════╝╚═╝  ╚═══╝
+`.trim().split('\n');
+const ART_WIDTH = 36;
+/** Pad `s` to length `n` with spaces on the right. ANSI-safe-ish — */
+/** assumes the caller has not yet wrapped colour codes around the    */
+/** padded segment.                                                   */
+function rpad(s, n) {
+    const len = s.length;
+    if (len >= n)
+        return s;
+    return s + ' '.repeat(n - len);
+}
+/** Centre `s` within width `w` (no colour codes in `s`). */
+function centre(s, w) {
+    if (s.length >= w)
+        return s;
+    const total = w - s.length;
+    const left = Math.floor(total / 2);
+    return ' '.repeat(left) + s + ' '.repeat(total - left);
+}
+/**
+ * Build the framed banner block as a single string with trailing
+ * newline. Truecolor → 256 → 16 / mono all handled by `theme.c.*`.
+ */
+function renderBanner(opts) {
+    const w = Math.max(40, Math.min(opts.width ?? (0, theme_1.termWidth)(), 80));
+    const narrow = w < 60;
+    const tagline = opts.tagline ?? 'Autonomous AI Engine';
+    const credits = opts.credits ?? 'Built solo · By Taracod · White Lotus';
+    const versionLine = `${tagline} · Local-first · v${opts.version}`;
+    // Narrow layout: single-line title + tagline + credits.
+    if (narrow) {
+        const out = [];
+        out.push('');
+        out.push(centre(theme_1.c.primary('A I D E N'), w));
+        out.push('');
+        out.push(centre(theme_1.c.muted(versionLine), w));
+        out.push(centre(theme_1.c.muted(credits), w));
+        out.push('');
+        return out.join('\n') + '\n';
+    }
+    // Wide layout: framed panel with ASCII art inside, taglines below.
+    const inner = w - 2;
+    const artPad = Math.max(0, Math.floor((inner - ART_WIDTH) / 2));
+    const framed = opts.framed !== false;
+    const horiz = '═'.repeat(inner);
+    const top = framed ? theme_1.c.rule(`╔${horiz}╗`) : '';
+    const bottom = framed ? theme_1.c.rule(`╚${horiz}╝`) : '';
+    const blank = framed
+        ? `${theme_1.c.rule('║')}${' '.repeat(inner)}${theme_1.c.rule('║')}`
+        : ' '.repeat(w);
+    const lines = [];
+    lines.push('');
+    if (framed)
+        lines.push(top);
+    lines.push(blank);
+    for (const row of AIDEN_ART) {
+        const padded = rpad(' '.repeat(artPad) + row, inner);
+        const coloured = theme_1.c.primary(padded);
+        lines.push(framed ? `${theme_1.c.rule('║')}${coloured}${theme_1.c.rule('║')}` : `  ${coloured}`);
+    }
+    lines.push(blank);
+    if (framed)
+        lines.push(bottom);
+    lines.push('');
+    lines.push('  ' + (0, theme_1.dim)(theme_1.c.muted(versionLine)));
+    lines.push('');
+    lines.push('  ' + (0, theme_1.dim)(theme_1.c.muted(credits)));
+    lines.push('');
+    return lines.join('\n') + '\n';
+}
+/**
+ * Single-line title for use inside slash-command hints / tour pages
+ * where the full banner would be too tall. Bright primary + version.
+ */
+function renderTitleLine(version) {
+    return `${theme_1.c.primary('AIDEN')} ${theme_1.c.muted(`v${version}`)}`;
+}
+/** Diagnostic — exposes detected depth for smoke tests. */
+function bannerDiagnostic() {
+    return { width: (0, theme_1.termWidth)(), depth: (0, theme_1.getColorDepth)() };
+}

package/dist/core/v4/ui/theme.js

@@ -0,0 +1,164 @@
+"use strict";
+/**
+ * Copyright (c) 2026 Shiva Deore (Taracod).
+ * Licensed under AGPL-3.0. See LICENSE for details.
+ *
+ * Aiden — local-first agent.
+ */
+/**
+ * core/v4/ui/theme.ts — ONB1 (v4.7 onboarding rework).
+ *
+ * Self-contained theme module for the redesigned first-run experience.
+ * Lives alongside, NOT instead of, the existing skin engine
+ * (cli/v4/skinEngine.ts). The skin engine drives the REPL / boot card
+ * / every post-onboarding surface; this theme drives only the
+ * onboarding screens (slices 1–10 of dispatch ONB1).
+ *
+ * Why a separate module:
+ *   - Onboarding palette is specified to a different muted/text spec
+ *     than the existing skin (e.g. cool-grey #71717A vs warm-tan
+ *     #B8A89A). Swapping the skin would re-paint every chat turn the
+ *     user sees afterwards, surprising the eye on the *second* boot.
+ *   - Onboarding is a single-shot surface — no per-user customisation,
+ *     no YAML loader, no `monochrome`/`light` variants needed beyond
+ *     graceful colour-depth degradation.
+ *
+ * Truecolor → 256 → 16 detection runs once at module load and is
+ * cached. Set `AIDEN_FORCE_COLOR_DEPTH=truecolor|256|16|none` to
+ * override (smoke tests rely on this).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SEP_LIGHT = exports.SEP_HEAVY = exports.dim = exports.italic = exports.bold = exports.c = exports.PALETTE = void 0;
+exports.getColorDepth = getColorDepth;
+exports.paint = paint;
+exports.separator = separator;
+exports.termWidth = termWidth;
+/**
+ * The 8-colour onboarding palette. Hex strings are the source of
+ * truth; the emit functions below convert per detected depth.
+ */
+exports.PALETTE = {
+    primary: '#FF6B35', // brand orange — Aiden hero
+    accent: '#FFB088', // light orange — highlights
+    success: '#4ADE80', // green checkmarks
+    warning: '#FBBF24', // amber warnings
+    error: '#EF4444', // red errors
+    text: '#F5F5F5', // bright white — headers/titles
+    muted: '#71717A', // dim grey — secondary text/hints
+    rule: '#27272A', // dark grey — separators
+};
+/** Parse a `#RRGGBB` hex string into [r,g,b]. */
+function hexToRgb(hex) {
+    const m = /^#?([0-9a-fA-F]{6})$/.exec(hex);
+    if (!m)
+        return [255, 255, 255];
+    const n = parseInt(m[1], 16);
+    return [(n >> 16) & 0xff, (n >> 8) & 0xff, n & 0xff];
+}
+/**
+ * Map a 24-bit RGB triple to the closest xterm-256 colour index.
+ * Uses the standard 6×6×6 cube + grey-ramp approximation.
+ */
+function rgbTo256(r, g, b) {
+    // Grey-ramp fast path: when r==g==b within 8, prefer the 24-step ramp.
+    if (Math.abs(r - g) < 8 && Math.abs(g - b) < 8) {
+        if (r < 8)
+            return 16;
+        if (r > 248)
+            return 231;
+        return Math.round(((r - 8) / 247) * 24) + 232;
+    }
+    const q = (v) => Math.round(v / 51);
+    return 16 + 36 * q(r) + 6 * q(g) + q(b);
+}
+/**
+ * Map a 24-bit RGB triple to a low-fidelity 16-colour ANSI code
+ * (30–37 / 90–97). Picks the closest of the 16 standard slots.
+ */
+function rgbTo16(r, g, b) {
+    const STD = [
+        [30, 0, 0, 0], [31, 205, 49, 49], [32, 13, 188, 121], [33, 229, 229, 16],
+        [34, 36, 114, 200], [35, 188, 63, 188], [36, 17, 168, 205], [37, 229, 229, 229],
+        [90, 102, 102, 102], [91, 241, 76, 76], [92, 35, 209, 139], [93, 245, 245, 67],
+        [94, 59, 142, 234], [95, 214, 112, 214], [96, 41, 184, 219], [97, 229, 229, 229],
+    ];
+    let best = STD[0];
+    let bestDist = Infinity;
+    for (const cand of STD) {
+        const [, cr, cg, cb] = cand;
+        const d = (r - cr) ** 2 + (g - cg) ** 2 + (b - cb) ** 2;
+        if (d < bestDist) {
+            bestDist = d;
+            best = cand;
+        }
+    }
+    return best[0];
+}
+/** Detect the terminal's effective colour depth. Cached at module load. */
+function detectColorDepth() {
+    const forced = process.env.AIDEN_FORCE_COLOR_DEPTH?.toLowerCase();
+    if (forced === 'truecolor' || forced === '256' || forced === '16' || forced === 'none') {
+        return forced;
+    }
+    if (process.env.NO_COLOR && process.env.NO_COLOR !== '')
+        return 'none';
+    if (!process.stdout.isTTY)
+        return 'none';
+    const ct = (process.env.COLORTERM ?? '').toLowerCase();
+    if (ct === 'truecolor' || ct === '24bit')
+        return 'truecolor';
+    const term = (process.env.TERM ?? '').toLowerCase();
+    if (term.includes('256'))
+        return '256';
+    if (term === 'dumb' || term === '')
+        return 'none';
+    return '16';
+}
+const COLOR_DEPTH = detectColorDepth();
+/** Public: report the depth (smoke tests + diagnostics). */
+function getColorDepth() { return COLOR_DEPTH; }
+/** Wrap `text` in the SGR sequence for `kind`, degrading per depth. */
+function paint(text, kind) {
+    if (COLOR_DEPTH === 'none')
+        return text;
+    const [r, g, b] = hexToRgb(exports.PALETTE[kind]);
+    if (COLOR_DEPTH === 'truecolor')
+        return `\x1b[38;2;${r};${g};${b}m${text}\x1b[39m`;
+    if (COLOR_DEPTH === '256')
+        return `\x1b[38;5;${rgbTo256(r, g, b)}m${text}\x1b[39m`;
+    return `\x1b[${rgbTo16(r, g, b)}m${text}\x1b[39m`;
+}
+/** Convenience helpers — one per palette key. */
+exports.c = {
+    primary: (s) => paint(s, 'primary'),
+    accent: (s) => paint(s, 'accent'),
+    success: (s) => paint(s, 'success'),
+    warning: (s) => paint(s, 'warning'),
+    error: (s) => paint(s, 'error'),
+    text: (s) => paint(s, 'text'),
+    muted: (s) => paint(s, 'muted'),
+    rule: (s) => paint(s, 'rule'),
+};
+/** SGR helpers for emphasis. Italic gracefully degrades when unsupported. */
+const bold = (s) => (COLOR_DEPTH === 'none' ? s : `\x1b[1m${s}\x1b[22m`);
+exports.bold = bold;
+const italic = (s) => (COLOR_DEPTH === 'none' ? s : `\x1b[3m${s}\x1b[23m`);
+exports.italic = italic;
+const dim = (s) => (COLOR_DEPTH === 'none' ? s : `\x1b[2m${s}\x1b[22m`);
+exports.dim = dim;
+/**
+ * Common ornaments — single source so onboarding screens share rhythm.
+ */
+exports.SEP_HEAVY = '━';
+exports.SEP_LIGHT = '─';
+/** Render a full-width separator in RULE colour, optionally heavy. */
+function separator(width, heavy = true) {
+    const w = Math.max(8, Math.min(width, 100));
+    const ch = heavy ? exports.SEP_HEAVY : exports.SEP_LIGHT;
+    return exports.c.rule(ch.repeat(w));
+}
+/** Effective terminal width clamped to a sane band. */
+function termWidth() {
+    const raw = process.stdout.columns ?? 80;
+    return Math.max(40, Math.min(raw, 100));
+}

package/dist/core/version.js

@@ -2,4 +2,4 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
 // AUTO-GENERATED by scripts/inject-version.js — do not edit by hand
-exports.VERSION = '4.6.0';
+exports.VERSION = '4.7.0';