keating 0.3.6

package/dist/src/core/speech.js

@@ -0,0 +1,54 @@
+export const KEATING_VOICE_TOOL_NAME = "keating_voice";
+export const VOICE_TAGS = [
+    "explain",
+    "question",
+    "verify",
+    "redirect",
+    "encourage",
+    "pause",
+    "recap"
+];
+const DEFAULT_TAGS = ["explain"];
+const DEFAULT_PACE = "normal";
+const DEFAULT_AFFECT = "warm";
+function isVoiceTag(value) {
+    return VOICE_TAGS.includes(value);
+}
+function cleanText(value) {
+    return String(value ?? "").replace(/\s+/g, " ").trim();
+}
+export function normalizeVoiceUtterance(input, speech) {
+    const text = cleanText(input.text);
+    if (!text) {
+        throw new Error("keating_voice requires non-empty text.");
+    }
+    const tags = (input.tags ?? [])
+        .map(tag => cleanText(tag).toLowerCase())
+        .filter(isVoiceTag);
+    return {
+        text,
+        voice: cleanText(input.voice) || speech.defaultVoice,
+        tags: tags.length > 0 ? tags : DEFAULT_TAGS,
+        pace: input.pace ?? DEFAULT_PACE,
+        affect: input.affect ?? DEFAULT_AFFECT,
+        listenFor: input.listenFor ? cleanText(input.listenFor) : undefined
+    };
+}
+export function voiceTagLine(utterance) {
+    const attrs = [
+        `voice=${utterance.voice}`,
+        `tags=${utterance.tags.join(",")}`,
+        `pace=${utterance.pace}`,
+        `affect=${utterance.affect}`,
+        utterance.listenFor ? `listen_for=${utterance.listenFor}` : undefined
+    ].filter(Boolean);
+    return `[voice ${attrs.join(" ")}] ${utterance.text}`;
+}
+export function speechStrategySummary(speech) {
+    return [
+        `speech=${speech.enabled ? "enabled" : "disabled"}`,
+        `voice=${speech.defaultVoice}`,
+        `fast_model=${speech.fastModel ?? "unset"}`,
+        `steering_model=${speech.steeringModel ?? "default"}`
+    ].join("\n");
+}

package/dist/src/core/terminal.js

@@ -0,0 +1,117 @@
+import { shellCommandSections } from "./commands.js";
+export const RESET = "\x1b[0m";
+const BOLD = "\x1b[1m";
+const DIM = "\x1b[2m";
+function rgb(red, green, blue) {
+    return `\x1b[38;2;${red};${green};${blue}m`;
+}
+function bgRgb(red, green, blue) {
+    return `\x1b[48;2;${red};${green};${blue}m`;
+}
+// ─── Retro palette (true-color, matches web 1:1) ───────────────────────
+const PRIMARY = rgb(16, 185, 129); // #10b981 — web primary green
+const PRIMARY_BG = bgRgb(16, 185, 129) + rgb(244, 241, 234);
+const GREEN_LIGHT = rgb(52, 211, 153); // #34d399 — logo top
+const GREEN_DARK = rgb(5, 150, 105); // #059669 — logo bottom
+const TERRACOTTA = rgb(212, 74, 61); // #d44a3d — Nav version tag
+const PAPER = rgb(244, 241, 234); // #f4f1ea — background
+const PARCHMENT = rgb(216, 210, 196); // border-muted
+const SEPIA = rgb(160, 150, 136); // muted text
+const COAL = rgb(50, 50, 50); // dark borders
+const NEON = rgb(0, 255, 0); // #00ff00 — terminal glow
+const INK = rgb(26, 26, 26); // #1a1a1a — foreground
+function paint(text, ...codes) {
+    return `${codes.join("")}${text}${RESET}`;
+}
+export const keatingColor = {
+    primary: PRIMARY,
+    terracotta: TERRACOTTA,
+    paper: PAPER,
+    parchment: PARCHMENT,
+    sepia: SEPIA,
+    coal: COAL,
+    neon: NEON,
+    ink: INK,
+};
+export function printInfo(text) {
+    console.log(paint(`  ${text}`, SEPIA));
+}
+export function printSuccess(text) {
+    console.log(paint(`  ✓ ${text}`, PRIMARY, BOLD));
+}
+export function printWarning(text) {
+    console.log(paint(`  ⚠ ${text}`, rgb(255, 193, 7), BOLD));
+}
+export function printError(text) {
+    console.log(paint(`  ✗ ${text}`, rgb(220, 38, 38), BOLD));
+}
+export function printSection(title) {
+    console.log("");
+    console.log(paint(`◆ ${title}`, PRIMARY, BOLD));
+}
+export const KEATING_ASCII_LOGO = [
+    "██╗  ██╗███████╗ █████╗ ████████╗██╗███╗   ██╗ ██████╗ ",
+    "██║ ██╔╝██╔════╝██╔══██╗╚══██╔══╝██║████╗  ██║██╔════╝ ",
+    "█████╔╝ █████╗  ███████║   ██║   ██║██╔██╗ ██║██║  ███╗",
+    "██╔═██╗ ██╔══╝  ██╔══██║   ██║   ██║██║╚██╗██║██║   ██║",
+    "██║  ██╗███████╗██║  ██║   ██║   ██║██║ ╚████║╚██████╔╝",
+    "╚═╝  ╚═╝╚══════╝╚═╝  ╚═╝   ╚═╝   ╚═╝╚═╝  ╚═══╝ ╚═════╝ ",
+];
+export const KEATING_SUBTITLE_LINES = [
+    "THE HYPERTEACHER — Cognitive Empowerment",
+    '"That the powerful play goes on, and you may contribute a verse."',
+    "                                                          — Whitman",
+];
+export function printAsciiHeader(subtitleLines = []) {
+    console.log("");
+    // Render logo with progressive green gradient (top-center-heavy)
+    const logoColors = [GREEN_LIGHT, GREEN_LIGHT, PRIMARY, PRIMARY, GREEN_DARK, GREEN_DARK];
+    for (let index = 0; index < KEATING_ASCII_LOGO.length; index += 1) {
+        console.log(paint(`  ${KEATING_ASCII_LOGO[index]}`, logoColors[index], BOLD));
+    }
+    for (const line of subtitleLines) {
+        console.log(paint(`  ${line}`, SEPIA));
+    }
+    console.log("");
+}
+export function printPanel(title, subtitleLines = []) {
+    const inner = 53;
+    const border = "─".repeat(inner + 2);
+    const renderLine = (text, color, bolded = false) => {
+        const content = text.length > inner ? `${text.slice(0, inner - 3)}...` : text;
+        const codes = bolded ? `${color}${BOLD}` : color;
+        return `${COAL}${BOLD}│${RESET} ${codes}${content.padEnd(inner)}${RESET} ${COAL}${BOLD}│${RESET}`;
+    };
+    console.log("");
+    console.log(paint(`┌${border}┐`, COAL, BOLD));
+    console.log(renderLine(title, PRIMARY, true));
+    if (subtitleLines.length > 0) {
+        console.log(paint(`├${border}┤`, COAL, BOLD));
+        for (const line of subtitleLines) {
+            console.log(renderLine(line, PAPER));
+        }
+    }
+    console.log(paint(`└${border}┘`, COAL, BOLD));
+    console.log("");
+}
+export function printCommandSections(sections) {
+    for (const section of sections) {
+        printSection(section.title);
+        const maxUsage = Math.max(...section.commands.map(c => c.usage.length));
+        for (const cmd of section.commands) {
+            const padded = cmd.usage.padEnd(maxUsage + 2);
+            console.log(paint(`  ${padded}`, PRIMARY, BOLD) + paint(cmd.description, SEPIA));
+        }
+    }
+}
+export function printShellGreeting() {
+    printAsciiHeader([
+        paint("THE HYPERTEACHER — Cognitive Empowerment!", PARCHMENT, BOLD),
+        paint('"That the powerful play goes on, and you may contribute a verse."', SEPIA, DIM),
+        paint("                                                          — Whitman", SEPIA, DIM),
+    ]);
+    const sections = shellCommandSections();
+    printCommandSections(sections);
+    console.log(paint('\n  Type "/help" any time for usage hints.', SEPIA, DIM));
+    console.log("");
+}

package/dist/src/core/theme.js

@@ -0,0 +1,101 @@
+/**
+ * Keating CLI Theme — ANSI color constants that mirror the retro web palette.
+ *
+ * Uses 24-bit true-color (38;2;R;G;B) so the CLI matches the web hex values
+ * exactly on modern terminals. Falls back gracefully on 256-color terminals.
+ */
+import { extensionCommandSpecs, cliCommandSpecs } from "./commands.js";
+import { KEATING_ASCII_LOGO, KEATING_SUBTITLE_LINES } from "./terminal.js";
+// ─── True-color helpers ─────────────────────────────────────────────
+function fg(r, g, b) {
+    return `\x1b[38;2;${r};${g};${b}m`;
+}
+function bg(r, g, b) {
+    return `\x1b[48;2;${r};${g};${b}m`;
+}
+// ─── Retro palette (matches web/src/app.css & web/src/styles/retro.css) ─
+export const color = {
+    reset: "\x1b[0m",
+    bold: "\x1b[1m",
+    dim: "\x1b[2m",
+    italic: "\x1b[3m",
+    // Primary green — matches web --primary #10b981
+    primary: fg(16, 185, 129),
+    primaryBg: bg(16, 185, 129) + fg(244, 241, 234),
+    // Logo gradient (mirrors web ChatIntro gradient)
+    greenLight: fg(52, 211, 153), // #34d399
+    greenMid: fg(16, 185, 129), // #10b981
+    greenDark: fg(5, 150, 105), // #059669
+    // Retro terracotta — matches web Nav version tag #d44a3d
+    terracotta: fg(212, 74, 61),
+    terracottaBg: bg(212, 74, 61) + fg(244, 241, 234),
+    // Neon glow — terminal green for dark-mode feel
+    neon: fg(0, 255, 0), // #00ff00
+    // Warm paper neutrals (mirrors web --background #f4f1ea)
+    cream: fg(244, 241, 234),
+    parchment: fg(216, 210, 196), // softer than web muted, terminal-friendly
+    sepia: fg(160, 150, 136), // warm dim text
+    // Compatibility aliases (old 256-color names → new true-color)
+    sage: fg(16, 185, 129), // same as primary, kept for compat
+    gold: fg(16, 185, 129), // was 220 yellow, now primary green
+    // Deep darks
+    ink: fg(26, 26, 26),
+    coal: fg(50, 50, 50), // border/dark neutral
+    coalBg: bg(50, 50, 50),
+    // Semantic helpers (mirrors web intent)
+    ok: fg(16, 185, 129), // success → primary green
+    warn: fg(255, 193, 7), // amber warning
+    err: fg(220, 38, 38), // true red error
+    info: fg(100, 180, 255), // soft blue info
+};
+// Convenience helpers
+export function c(tag, text) {
+    return `${color[tag]}${text}${color.reset}`;
+}
+export function bold(tag, text) {
+    return `${color.bold}${color[tag]}${text}${color.reset}`;
+}
+/**
+ * The Keating shell ASCII greeting — shown once per session.
+ *
+ * Logo renders with a progressive green gradient (top-to-bottom) that mirrors
+ * the web ChatIntro CSS: #34d399 → #10b981 → #059669.
+ */
+export const KEATING_GREETING = (() => {
+    const logoColors = [
+        color.greenLight,
+        color.greenLight,
+        color.greenMid,
+        color.greenMid,
+        color.greenDark,
+        color.greenDark,
+    ];
+    const logo = KEATING_ASCII_LOGO.map((line, i) => `${logoColors[i] ?? color.greenMid}  ${line}${color.reset}`).join("\n");
+    const [title, ...quoteLines] = KEATING_SUBTITLE_LINES;
+    const subtitle = [
+        `${color.bold}${color.parchment}    ${title}${color.reset}`,
+        ...quoteLines.map(line => `${color.dim}${color.sepia}    ${line}${color.reset}`),
+    ].join("\n");
+    return `\n${logo}\n\n${subtitle}\n`;
+})();
+/**
+ * Command list formatted for the shell greeting (slash-prefixed).
+ */
+export function shellCommands() {
+    const cmds = extensionCommandSpecs
+        .filter(s => !s.cliOnly)
+        .map(s => [`/${s.name}${s.args ? ` ${s.args}` : ""}`, s.description]);
+    return formatCommandList(cmds);
+}
+/**
+ * Command list formatted for the CLI help output (no slash prefix).
+ */
+export function cliCommands() {
+    const cmds = cliCommandSpecs
+        .map(s => [`${s.name}${s.args ? ` ${s.args}` : ""}`, s.description]);
+    return formatCommandList(cmds);
+}
+function formatCommandList(cmds) {
+    const lines = cmds.map(([cmd, desc]) => `  ${color.bold}${color.primary}${cmd.padEnd(22)}${color.reset}  ${color.dim}${color.sepia}${desc}${color.reset}`);
+    return lines.join("\n");
+}