@cspeach/cli 0.6.0

package/dist/ui/footer.js

@@ -0,0 +1,103 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import React, { useState, useEffect, useCallback } from 'react';
+import { Box, Text, useInput } from 'ink';
+import TextInput from 'ink-text-input';
+import Fuse from 'fuse.js';
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+const HISTORY_FILE = path.join(os.homedir(), '.cspeach', 'history');
+function loadHistory() {
+    try {
+        return fs.readFileSync(HISTORY_FILE, 'utf8').split('\n').filter(Boolean);
+    }
+    catch {
+        return [];
+    }
+}
+function appendHistory(line, history) {
+    // Skip consecutive duplicates (matches bash HISTCONTROL=ignoredups).
+    if (history[history.length - 1] === line)
+        return;
+    fs.mkdirSync(path.dirname(HISTORY_FILE), { recursive: true });
+    fs.appendFileSync(HISTORY_FILE, line + '\n');
+    history.push(line);
+}
+const PEACH = '#FFCBA4';
+export function Footer({ onSubmit, onSlashTrigger, onHistoryTrigger, onValueChange, paletteResult }) {
+    const [value, setValue] = useState('');
+    const [history] = useState(loadHistory);
+    const [histIdx, setHistIdx] = useState(-1);
+    const [fuzzyMode, setFuzzyMode] = useState(false);
+    const [fuzzyQuery, setFuzzyQuery] = useState('');
+    const [fuzzyResults, setFuzzyResults] = useState([]);
+    const fuse = React.useMemo(() => new Fuse(history, { threshold: 0.4 }), [history]);
+    // Mirror state into parent when it cares (e.g. App's ? key-binding gate).
+    useEffect(() => { onValueChange?.(value); }, [value, onValueChange]);
+    // If the parent pushes a palette result, pre-fill our input.
+    useEffect(() => {
+        if (paletteResult && paletteResult.length > 0)
+            setValue(paletteResult);
+    }, [paletteResult]);
+    useEffect(() => {
+        if (fuzzyMode) {
+            setFuzzyResults(fuse.search(fuzzyQuery).slice(0, 8).map((r) => r.item));
+        }
+    }, [fuzzyQuery, fuzzyMode, fuse]);
+    useInput((input, key) => {
+        if (key.ctrl && input === 'r') {
+            onHistoryTrigger();
+            setFuzzyMode(true);
+            setFuzzyQuery('');
+            return;
+        }
+        if (fuzzyMode) {
+            if (key.escape) {
+                setFuzzyMode(false);
+                return;
+            }
+            if (key.return && fuzzyResults[0]) {
+                // TODO (v0.4): cursor-aware selection for Ctrl+R palette.
+                // Current implementation always selects the top result, matching
+                // bash/zsh default reverse-i-search behaviour — users who want a
+                // different result re-type to refine the query.
+                setValue(fuzzyResults[0]);
+                setFuzzyMode(false);
+                return;
+            }
+            return;
+        }
+        if (key.upArrow) {
+            const next = Math.min(histIdx + 1, history.length - 1);
+            setHistIdx(next);
+            setValue(history[history.length - 1 - next] ?? '');
+            return;
+        }
+        if (key.downArrow) {
+            const next = Math.max(histIdx - 1, -1);
+            setHistIdx(next);
+            setValue(next === -1 ? '' : history[history.length - 1 - next] ?? '');
+            return;
+        }
+    });
+    const handleSubmit = useCallback((line) => {
+        if (!line.trim())
+            return;
+        appendHistory(line.trim(), history);
+        setHistIdx(-1);
+        setValue('');
+        if (line.trim() === '/') {
+            onSlashTrigger();
+            return;
+        }
+        if (line.trim() === '/history') {
+            onHistoryTrigger();
+            return;
+        }
+        onSubmit(line.trim());
+    }, [onSubmit, onSlashTrigger, onHistoryTrigger, history]);
+    if (fuzzyMode) {
+        return (_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: "cyan", paddingX: 1, children: [_jsx(Text, { bold: true, color: "cyan", children: "History search (Ctrl+R)" }), _jsx(TextInput, { value: fuzzyQuery, onChange: setFuzzyQuery, placeholder: "type to search..." }), fuzzyResults.map((r, i) => _jsx(Text, { dimColor: i > 0, children: r }, i)), _jsx(Text, { dimColor: true, children: "Esc: cancel  Enter: select" })] }));
+    }
+    return (_jsxs(Box, { borderStyle: "single", borderColor: "gray", paddingX: 1, children: [_jsx(Text, { bold: true, color: PEACH, children: "CSPeach \u203A " }), _jsx(TextInput, { value: value, onChange: setValue, onSubmit: handleSubmit })] }));
+}

package/dist/ui/header.js

@@ -0,0 +1,17 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text } from 'ink';
+import { useSapState } from './sap-state-store.js';
+const PEACH = '#FFCBA4';
+export function Header({ writeMode } = {}) {
+    const { system } = useSapState();
+    const isAdvisory = writeMode === 'advisory-only';
+    const modeLabel = isAdvisory
+        ? 'ADVISORY (writes proposed, never executed)'
+        : writeMode === 'approval-gated'
+            ? 'approval-gated'
+            : writeMode === 'auto'
+                ? 'auto'
+                : undefined;
+    const modeColor = isAdvisory ? 'yellow' : 'green';
+    return (_jsxs(Box, { borderStyle: "single", borderColor: "gray", paddingX: 1, children: [_jsx(Text, { bold: true, color: PEACH, children: "CSPeach v0.3" }), _jsx(Text, { children: " " }), modeLabel && (_jsxs(_Fragment, { children: [_jsx(Text, { color: "gray", children: "  write: " }), _jsx(Text, { color: modeColor, bold: isAdvisory, children: modeLabel })] })), _jsx(Box, { flexGrow: 1 }), _jsx(Text, { color: "cyan", children: system })] }));
+}

package/dist/ui/ink-classifier-route.js

@@ -0,0 +1,19 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+import { useEffect } from 'react';
+import { Box, Text, useInput } from 'ink';
+/**
+ * Medium-confidence banner rendered inside the Ink frame. Auto-settles to
+ * the classifier's top pick after 800ms, unless the user presses Tab — in
+ * which case we open the CommandPalette with alternates.
+ */
+export function InkClassifierRoute({ skill, confidence, onSettle, onOpenPalette }) {
+    useEffect(() => {
+        const t = setTimeout(onSettle, 800);
+        return () => clearTimeout(t);
+    }, [onSettle]);
+    useInput((_input, key) => {
+        if (key.tab)
+            onOpenPalette();
+    });
+    return (_jsx(Box, { children: _jsxs(Text, { dimColor: true, children: ["\\u2504 Suggest /", skill, " (confidence ", Math.round(confidence * 100), "%) \\u2014 Tab to pick"] }) }));
+}

package/dist/ui/login-banner.js

@@ -0,0 +1,72 @@
+/**
+ * Format the login banner shown at REPL startup. Decision 8: verbose
+ * with budget + warning. Yellow warning fires when:
+ *   - token usage ≥ 80% of input OR output cap (managed-capped trials only)
+ *   - trial expiry < 24 hours away
+ *   - trial already expired
+ */
+const MS_PER_HOUR = 3600 * 1000;
+const MS_PER_DAY = 24 * MS_PER_HOUR;
+export function formatLoginBanner(profile) {
+    // Non-trial path.
+    if (profile.trial_mode === null) {
+        return {
+            line: `Signed in as ${profile.email} (${profile.plan})`,
+            warningLine: null,
+        };
+    }
+    // Trial — figure out time left.
+    const now = Date.now();
+    const ends = profile.trial_ends_at ? new Date(profile.trial_ends_at).getTime() : now;
+    const msLeft = ends - now;
+    let timeFragment;
+    let isExpired = false;
+    if (msLeft <= 0) {
+        timeFragment = 'EXPIRED';
+        isExpired = true;
+    }
+    else if (msLeft < MS_PER_DAY) {
+        const hours = Math.max(1, Math.floor(msLeft / MS_PER_HOUR));
+        timeFragment = `${hours} hour${hours === 1 ? '' : 's'} left`;
+    }
+    else {
+        const days = Math.floor(msLeft / MS_PER_DAY);
+        timeFragment = `${days} day${days === 1 ? '' : 's'} left`;
+    }
+    if (profile.trial_mode === 'byok') {
+        return {
+            line: `Signed in as ${profile.email} — BYOK trial — ${timeFragment}`,
+            warningLine: isExpired
+                ? `⚠  Your trial has expired. Visit cspeach.dev/upgrade.`
+                : (msLeft < MS_PER_DAY ? `⚠  Trial expires soon — ${timeFragment}.` : null),
+        };
+    }
+    // managed-capped
+    const usedInput = profile.usage_input_tokens;
+    const capInput = profile.trial_token_cap_input ?? 0;
+    const inputPct = capInput > 0 ? Math.round((usedInput / capInput) * 100) : 0;
+    const tokenFragment = capInput > 0
+        ? ` — ${formatTokens(usedInput)}/${formatTokens(capInput)} tokens (${inputPct}%)`
+        : '';
+    const line = `Signed in as ${profile.email} — trial (managed) — ${timeFragment}${tokenFragment}`;
+    let warning = null;
+    if (isExpired) {
+        warning = `⚠  Your trial has expired. Visit cspeach.dev/upgrade.`;
+    }
+    else if (inputPct >= 80) {
+        warning = `⚠  Trial token budget at ${inputPct}% — upgrade or switch to BYOK before hitting the cap.`;
+    }
+    else if (msLeft < MS_PER_DAY) {
+        warning = `⚠  Trial expires in ${timeFragment} — upgrade at cspeach.dev/upgrade.`;
+    }
+    return { line, warningLine: warning };
+}
+// Always render with a `k` suffix so the banner column width stays stable.
+// Sub-1k values that aren't zero render as `<1k` rather than the raw number.
+function formatTokens(n) {
+    if (n === 0)
+        return '0k';
+    if (n < 1000)
+        return `<1k`;
+    return `${Math.round(n / 1000)}k`;
+}

package/dist/ui/rich-error-box.js

@@ -0,0 +1,9 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text } from 'ink';
+function severityColor(s) {
+    return s === 'error' ? 'red' : s === 'warning' ? 'yellow' : 'blue';
+}
+export function RichErrorBox({ code, message, hint, severity = 'error' }) {
+    const color = severityColor(severity);
+    return (_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: color, paddingX: 2, paddingY: 1, children: [_jsx(Text, { bold: true, color: color, children: code }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { children: message }) }), hint && (_jsx(Box, { marginTop: 1, children: _jsx(Text, { dimColor: true, children: hint }) }))] }));
+}

package/dist/ui/sap-state-store.js

@@ -0,0 +1,65 @@
+import React, { createContext, useContext } from 'react';
+const DEFAULT_STATE = {
+    system: '', user: '', transport: null, locksHeld: [],
+    tokenUsageToday: 0, dollarSpendToday: 0, dollarCap: 10, recentTurns: [],
+};
+/**
+ * Rate limiter: calls `fn` at most once every `minIntervalMs`. Trailing-only:
+ * the first call in a quiet window fires immediately, subsequent calls within
+ * the window coalesce into a single trailing call at the window boundary.
+ *
+ * NOTE: A naive setTimeout(fn, 200) with leading + trailing yields ~10Hz for
+ * back-to-back updates (leading fire at t=0, trailing at t=200, leading again
+ * at t=400...). This implementation guarantees at most one call per window →
+ * true 5Hz max.
+ */
+function createRateLimiter(minIntervalMs) {
+    let lastFire = 0;
+    let pending = null;
+    let timer = null;
+    return (fn) => {
+        pending = fn;
+        const now = Date.now();
+        const elapsed = now - lastFire;
+        if (elapsed >= minIntervalMs) {
+            lastFire = now;
+            pending();
+            pending = null;
+        }
+        else if (!timer) {
+            timer = setTimeout(() => {
+                timer = null;
+                if (pending) {
+                    lastFire = Date.now();
+                    pending();
+                    pending = null;
+                }
+            }, minIntervalMs - elapsed);
+        }
+    };
+}
+const sidebarUpdate = createRateLimiter(200); // 5Hz max
+export class SapStateStore {
+    state = { ...DEFAULT_STATE };
+    listeners = new Set();
+    subscribe(fn) {
+        this.listeners.add(fn);
+        return () => { this.listeners.delete(fn); };
+    }
+    update(partial) {
+        this.state = { ...this.state, ...partial };
+        sidebarUpdate(() => {
+            const snap = this.state;
+            this.listeners.forEach((fn) => fn(snap));
+        });
+    }
+    get() { return this.state; }
+}
+export const globalStore = new SapStateStore();
+export const SapStateContext = createContext(globalStore);
+export function useSapState() {
+    const store = useContext(SapStateContext);
+    const [state, setState] = React.useState(store.get());
+    React.useEffect(() => store.subscribe(setState), [store]);
+    return state;
+}

package/dist/ui/session-timeline.js

@@ -0,0 +1,31 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text, useInput } from 'ink';
+// v1.1: add 'skipped' (approval rejection logs) and 'rolled_back' (snapshot restore).
+// Both need session-schema bump (schema_version 2) — deferred.
+const MUTATING_TOOLS = new Set([
+    'sap_set_source', 'sap_update_method', 'sap_delete_object', 'sap_activate',
+    'sap_create_object', 'sap_transport_release', 'sap_message_maintain',
+    'sap_number_range_intervals', 'sap_service_binding_publish',
+]);
+export function toTimelineEntry(call) {
+    // args shape depends on the tool; extract defensively.
+    const args = (call.args ?? {});
+    const objectName = typeof args['name'] === 'string' ? args['name'] : '-';
+    const objectType = typeof args['type'] === 'string' ? args['type'] : '-';
+    return {
+        timestamp: call.completed_at,
+        toolName: call.tool,
+        objectName,
+        objectType,
+        durationMs: call.duration_ms,
+        isError: call.is_error,
+    };
+}
+export function SessionTimeline({ entries, onClose }) {
+    const writes = entries.filter((e) => MUTATING_TOOLS.has(e.toolName));
+    useInput((input, key) => {
+        if (key.escape || input === 'q')
+            onClose();
+    });
+    return (_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: "cyan", paddingX: 2, paddingY: 1, width: 72, children: [_jsx(Text, { bold: true, color: "cyan", children: "Write history \\u2014 Esc to close" }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [writes.length === 0 && _jsx(Text, { dimColor: true, children: "(no writes this session)" }), writes.map((e, i) => (_jsxs(Box, { children: [_jsxs(Text, { dimColor: true, children: [e.timestamp, "  "] }), _jsx(Text, { color: e.isError ? 'red' : 'green', children: e.isError ? '\u25CF failed ' : '\u25CF applied' }), _jsxs(Text, { children: ["  ", e.toolName.padEnd(20)] }), _jsxs(Text, { color: "yellow", children: ["  ", e.objectName] }), _jsxs(Text, { dimColor: true, children: [" (", e.objectType, ")  ", e.durationMs, "ms"] })] }, i)))] })] }));
+}

package/dist/ui/sidebar.js

@@ -0,0 +1,10 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text } from 'ink';
+import { useSapState } from './sap-state-store.js';
+export function Sidebar() {
+    const s = useSapState();
+    const spendColor = s.dollarSpendToday > s.dollarCap * 0.9 ? 'red'
+        : s.dollarSpendToday > s.dollarCap * 0.7 ? 'yellow' : 'green';
+    return (_jsxs(Box, { flexDirection: "column", borderStyle: "single", borderColor: "gray", paddingX: 1, width: 30, children: [_jsx(Text, { bold: true, color: "cyan", children: s.system || 'no system' }), _jsxs(Text, { color: "gray", children: ["user: ", _jsx(Text, { color: "white", children: s.user || '—' })] }), _jsxs(Text, { color: "gray", children: ["transport: ", _jsx(Text, { color: "yellow", children: s.transport ?? 'none' })] }), _jsxs(Text, { color: "gray", children: ["locks: ", s.locksHeld.length === 0 ? _jsx(Text, { dimColor: true, children: "(none)" })
+                        : s.locksHeld.map((l, i) => _jsxs(Text, { color: "red", children: [l, " "] }, i))] }), _jsx(Box, { marginTop: 1, children: _jsxs(Text, { color: spendColor, children: [s.tokenUsageToday.toLocaleString(), " tok / $", s.dollarSpendToday.toFixed(2), " of $", s.dollarCap] }) }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(Text, { dimColor: true, children: "\u2500 recent turns \u2500" }), s.recentTurns.slice(-5).reverse().map((t, i) => (_jsxs(Text, { dimColor: true, children: [t.time, " ", t.command.slice(0, 20)] }, i))), s.recentTurns.length === 0 && _jsx(Text, { dimColor: true, children: "(no turns yet)" })] })] }));
+}

package/dist/ui/skill-picker.js

@@ -0,0 +1,50 @@
+import { select } from '@inquirer/prompts';
+/**
+ * Sentinel value returned when the user cancels the picker (Esc / Ctrl+C or
+ * selects the "↩ cancel" entry). Callers re-prompt rather than dispatching.
+ */
+export const PICK_CANCELLED = Symbol('PICK_CANCELLED');
+/**
+ * Arrow-key picker for the top-3 classifier candidates. Returns the chosen
+ * skill name. Each choice shows the skill, a trimmed reasoning line, and
+ * the confidence percentage.
+ *
+ * Cancel routes:
+ *   - Selecting the "↩ cancel" item returns PICK_CANCELLED
+ *   - Pressing Ctrl+C inquirer raises ExitPromptError → we catch and treat as cancel
+ *     (without Ctrl+C'ing the whole process)
+ */
+export async function pickSkill(result) {
+    const candidates = [result.skill, ...result.alternates].slice(0, 3);
+    const reasoning = (result.reasoning ?? '').slice(0, 60);
+    const confidencePct = Math.round(result.confidence * 100);
+    const choices = candidates.map((skill, idx) => {
+        // Top-1 carries the reasoning + confidence; alternates are simple names.
+        if (idx === 0) {
+            const suffix = reasoning
+                ? ` — ${reasoning} (${confidencePct}%)`
+                : ` (${confidencePct}%)`;
+            return { name: `/${skill}${suffix}`, value: skill };
+        }
+        return { name: `/${skill}`, value: skill };
+    });
+    // Cancel entry — user can arrow-down past the candidates and pick this to
+    // go back to the REPL prompt and retype the request.
+    choices.push({ name: '↩ cancel (go back to prompt)', value: '__cancel__' });
+    try {
+        const chosen = await select({
+            message: 'Pick a skill — or ↩ to cancel:',
+            choices,
+        });
+        if (chosen === '__cancel__')
+            return PICK_CANCELLED;
+        return chosen;
+    }
+    catch (err) {
+        // inquirer throws ExitPromptError on Ctrl+C. Treat as cancel, not a crash.
+        const name = err?.name;
+        if (name === 'ExitPromptError')
+            return PICK_CANCELLED;
+        throw err;
+    }
+}

package/dist/ui/status-row.js

@@ -0,0 +1,12 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text } from 'ink';
+/**
+ * Single-line status row shown inside the Ink frame (above Footer).
+ * Mirrors the non-Ink chalk-based `printStatusFooter` in renderer/status-footer.ts
+ * so users see the same fields in both modes.
+ */
+export function StatusRow({ data }) {
+    if (!data)
+        return _jsx(Box, {});
+    return (_jsx(Box, { children: _jsxs(Text, { dimColor: true, children: [data.sessionId, "  SAP: ", data.sapAlias, "  skill: ", data.skill, "  tokens: ", data.tokens, "  elapsed: ", data.elapsedMs, "ms"] }) }));
+}

package/dist/ui/widget-control.js

@@ -0,0 +1,4 @@
+// A longer sentinel than `\x00WIDGET:` to reduce risk of collision with
+// LLM-emitted payloads. A single `\x00` is too short — malicious or accidental
+// `\x00` bytes in model output would render arbitrary widgets.
+export const WIDGET_CONTROL = '\x00CSPEACH-WIDGET-V3\x00';

package/dist/ui/widgets/bar-chart.js

@@ -0,0 +1,15 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text } from 'ink';
+const VALID_COLORS = ['red', 'yellow', 'cyan', 'green', 'blue', 'magenta', 'white', 'gray'];
+function toInkColor(c) {
+    return VALID_COLORS.includes(c) ? c : 'white';
+}
+export function BarChart({ data }) {
+    const max = Math.max(...data.map((d) => d.value), 1);
+    const barWidth = 30;
+    return (_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: "cyan", paddingX: 1, children: [_jsx(Text, { bold: true, color: "cyan", children: "Distribution" }), data.map((item) => {
+                const filled = Math.round((item.value / max) * barWidth);
+                const bar = '\u2588'.repeat(filled) + '\u2591'.repeat(barWidth - filled);
+                return (_jsxs(Box, { children: [_jsxs(Text, { children: [item.label.padEnd(28), " "] }), _jsx(Text, { color: toInkColor(item.color), children: bar }), _jsxs(Text, { children: [" ", item.value] })] }, item.label));
+            })] }));
+}

package/dist/ui/widgets/coaching-picker.js

@@ -0,0 +1,41 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+import { useState } from 'react';
+import { Box, Text, useInput } from 'ink';
+import { PICK_CANCELLED } from '../skill-picker.js';
+const PEACH = '#FFCBA4';
+/**
+ * Ink-mode coaching picker rendered as an overlay inside <App>. The parent
+ * (App) mounts this component only when coachingPending !== null, so the
+ * component's useInput being always-active is safe — it can only fire
+ * while the overlay is visible.
+ *
+ * Cursor starts at 0 when params.preSelect (coach mode — Enter accepts top-1)
+ * and at -1 when false (picker mode — user must arrow-key to their choice).
+ */
+export function CoachingPicker({ params, onResolve }) {
+    const [cursor, setCursor] = useState(params.preSelect ? 0 : -1);
+    useInput((_input, key) => {
+        if (key.escape) {
+            onResolve(PICK_CANCELLED);
+            return;
+        }
+        if (key.upArrow) {
+            setCursor((c) => Math.max(-1, c - 1));
+            return;
+        }
+        if (key.downArrow) {
+            setCursor((c) => Math.min(params.options.length - 1, c + 1));
+            return;
+        }
+        if (key.return) {
+            if (cursor < 0) {
+                onResolve(PICK_CANCELLED);
+                return;
+            }
+            const chosen = params.options[cursor];
+            if (chosen)
+                onResolve(chosen.skill);
+        }
+    }, { isActive: true });
+    return (_jsxs(Box, { borderStyle: "round", borderColor: PEACH, flexDirection: "column", padding: 1, children: [_jsxs(Text, { bold: true, children: ["I'm not sure which skill fits for: \"", params.prompt.slice(0, 50), params.prompt.length > 50 ? '...' : '', "\"."] }), _jsx(Text, { bold: true, children: "Pick one:" }), params.options.map((opt, i) => (_jsxs(Box, { borderStyle: i === cursor ? 'round' : 'single', borderColor: i === cursor ? PEACH : 'gray', flexDirection: "column", marginTop: 1, children: [_jsxs(Text, { bold: true, children: ["/", opt.skill, " \u00B7 ", Math.round(opt.confidence * 100), "%"] }), _jsxs(Text, { dimColor: true, children: ["Does: ", opt.whatItDoes] }), _jsxs(Text, { dimColor: true, children: ["Pick if: ", opt.whenToPick] })] }, opt.skill))), _jsx(Text, { dimColor: true, children: "\u2191/\u2193 navigate \u00B7 Enter select \u00B7 Esc cancel" })] }));
+}

package/dist/ui/widgets/component-registry.js

@@ -0,0 +1,12 @@
+import { DepGraph } from './dep-graph.js';
+import { BarChart } from './bar-chart.js';
+import { StackFrames } from './stack-frames.js';
+import { DiffViewer } from './diff-viewer.js';
+import { QuestionCard } from './question-card.js';
+export const WIDGET_COMPONENTS = {
+    'dep-graph': DepGraph,
+    'bar-chart': BarChart,
+    'stack-frames': StackFrames,
+    'diff-viewer': DiffViewer,
+    question: QuestionCard,
+};

package/dist/ui/widgets/dep-graph.js

@@ -0,0 +1,9 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+import { Box, Text } from 'ink';
+export function DepGraph({ data }) {
+    return (_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: "cyan", paddingX: 1, children: [_jsxs(Text, { bold: true, color: "cyan", children: ["Dependencies \u2014 ", data.root] }), data.children.map((c, i) => {
+                const isLast = i === data.children.length - 1;
+                const prefix = isLast ? '└─' : '├─';
+                return (_jsxs(Box, { children: [_jsxs(Text, { color: "gray", children: [prefix, " "] }), _jsx(Text, { color: "yellow", children: c.name }), _jsxs(Text, { color: "gray", children: [" (", c.type, ") "] }), _jsx(Text, { dimColor: true, children: c.relation })] }, c.name));
+            })] }));
+}

package/dist/ui/widgets/diff-viewer.js

@@ -0,0 +1,11 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text } from 'ink';
+export function DiffViewer({ data }) {
+    const lines = data.unified.split('\n');
+    return (_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: "gray", paddingX: 1, children: [_jsx(Text, { bold: true, color: "gray", children: "Diff" }), lines.map((line, idx) => {
+                const color = line.startsWith('+') ? 'green' :
+                    line.startsWith('-') ? 'red' :
+                        line.startsWith('@@') ? 'cyan' : 'gray';
+                return (_jsx(Text, { color: color, bold: line.startsWith('@@'), children: line }, idx));
+            })] }));
+}

package/dist/ui/widgets/question-card.js

@@ -0,0 +1,11 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+import { Box, Text } from 'ink';
+/**
+ * Ink-mode rendering of cspeach-widget:question. Uses a double-border box
+ * so it's visually distinct from the single-border tool-widget. No
+ * interactive answer collection at this scope — user reads the question
+ * and types their answer as the next REPL prompt.
+ */
+export function QuestionCard({ data }) {
+    return (_jsxs(Box, { borderStyle: "double", borderColor: "cyan", flexDirection: "column", padding: 1, marginTop: 1, children: [_jsxs(Text, { bold: true, children: ["Question: ", data.id] }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { children: data.question }) }), data.context ? (_jsx(Box, { marginTop: 1, children: _jsxs(Text, { dimColor: true, children: ["Context: ", data.context] }) })) : null, (data.kind === 'choice' || data.kind === 'multi') && data.choices ? (_jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(Text, { bold: true, children: data.kind === 'choice' ? 'Pick one:' : 'Pick any (comma-separate):' }), data.choices.map((c, i) => (_jsxs(Text, { children: ["[", i + 1, "] ", c.label] }, c.value)))] })) : null] }));
+}

package/dist/ui/widgets/stack-frames.js

@@ -0,0 +1,5 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text } from 'ink';
+export function StackFrames({ data }) {
+    return (_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: "red", paddingX: 1, children: [_jsx(Text, { bold: true, color: "red", children: "Stack Frames" }), data.map((f) => (_jsxs(Box, { flexDirection: "column", marginTop: f.frame === 0 ? 0 : 1, children: [_jsx(Box, { children: _jsxs(Text, { color: f.type === 'error' ? 'red' : 'gray', children: ['#' + String(f.frame).padStart(2, '0'), " ", f.program, ":", f.line] }) }), _jsx(Box, { marginLeft: 5, children: _jsx(Text, { color: f.type === 'error' ? 'white' : 'gray', dimColor: f.type === 'context', children: f.code }) })] }, f.frame)))] }));
+}

package/dist/upgrade-check.js

@@ -0,0 +1,28 @@
+import chalk from 'chalk';
+import { loadConfig } from './config/loader.js';
+function compareVersions(a, b) {
+    const pa = a.split('.').map(Number);
+    const pb = b.split('.').map(Number);
+    for (let i = 0; i < 3; i++) {
+        const na = pa[i] ?? 0;
+        const nb = pb[i] ?? 0;
+        if (na !== nb)
+            return na - nb;
+    }
+    return 0;
+}
+export async function checkForUpgrade() {
+    const cfg = await loadConfig();
+    try {
+        const r = await fetch(`${cfg.proxy_url}/v1/skills/abap-radar`, { method: 'HEAD', signal: AbortSignal.timeout(3000) });
+        const minCli = r.headers.get('x-skill-min-cli-version');
+        const current = process.env.npm_package_version ?? '0.5.0';
+        if (minCli && compareVersions(current, minCli) < 0) {
+            console.log(chalk.yellow.bold(`\n⚠  Your cspeach (${current}) is older than the minimum required (${minCli}).`));
+            console.log(chalk.yellow(`   Run:  cspeach --upgrade\n`));
+        }
+    }
+    catch {
+        // Offline or proxy down — don't block startup.
+    }
+}

package/dist/upgrade.js

@@ -0,0 +1,13 @@
+import { spawn } from 'node:child_process';
+import { confirm } from '@inquirer/prompts';
+import chalk from 'chalk';
+export async function runUpgrade() {
+    console.log(chalk.cyan('Upgrading cspeach to latest via npm…'));
+    const yes = await confirm({ message: 'Run `npm i -g cspeach@latest`?', default: true });
+    if (!yes)
+        return 0;
+    return new Promise((resolve) => {
+        const proc = spawn('npm', ['i', '-g', 'cspeach@latest'], { stdio: 'inherit', shell: true });
+        proc.on('exit', (code) => resolve(code ?? 1));
+    });
+}

package/package.json

@@ -0,0 +1,83 @@
+{
+  "name": "@cspeach/cli",
+  "version": "0.6.0",
+  "description": "CSPeach — AI-assisted ABAP development CLI. Direct SAP access, 33 skills, safety gates.",
+  "keywords": [
+    "abap",
+    "sap",
+    "ai",
+    "cli",
+    "ai-assisted-development",
+    "s4hana",
+    "abap-development",
+    "claude",
+    "anthropic"
+  ],
+  "homepage": "https://cspeach.dev",
+  "bugs": {
+    "email": "laeeq@cremencing.com"
+  },
+  "author": "Laeeq Siddique (Cremencing Solutions)",
+  "license": "SEE LICENSE IN LICENSE",
+  "private": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "bin": {
+    "cspeach": "dist/index.js"
+  },
+  "scripts": {
+    "dev": "tsx src/index.ts",
+    "prebuild": "tsx scripts/prebuild.ts",
+    "build": "tsc && node scripts/make-bin-executable.js",
+    "install:global": "tsx scripts/install-global.ts",
+    "pretest": "tsx scripts/sync-signing-key.ts || node -e \"console.warn('WARN: sync-signing-key skipped — using stub')\"",
+    "start": "node dist/index.js",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "adt:smoke": "tsx scripts/adt-smoke.ts",
+    "smoke:all": "pnpm zcspeach:smoke && pnpm adt:smoke",
+    "zcspeach:smoke": "tsx scripts/zcspeach-smoke.ts",
+    "prepare": "husky"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.90.0",
+    "@cspeach/sap-client": "^0.1.0",
+    "@iarna/toml": "^2.2.5",
+    "@inkjs/ui": "^2.0.0",
+    "@inquirer/prompts": "^7.0.0",
+    "@noble/ed25519": "2.1.0",
+    "@noble/hashes": "1.4.0",
+    "chalk": "^5.3.0",
+    "cli-highlight": "^2.1.11",
+    "cli-table3": "^0.6.5",
+    "clipboardy": "^5.3.1",
+    "diff": "^9.0.0",
+    "fuse.js": "^7.0.0",
+    "ink": "^5.0.0",
+    "ink-text-input": "^6.0.0",
+    "jose": "^5.9.0",
+    "keytar": "^7.9.0",
+    "marked": "^11.2.0",
+    "marked-terminal": "^6.2.0",
+    "node-machine-id": "^1.1.12",
+    "openai": "4.67.3",
+    "react": "^18.3.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/diff": "^7.0.2",
+    "@types/node": "^20.17.0",
+    "@types/react": "^18.3.0",
+    "husky": "^9.1.7",
+    "ink-testing-library": "^4.0.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.0",
+    "vitest": "^2.1.0"
+  }
+}