yappr 0.1.0

package/dist/src/cli/tui.d.ts

@@ -0,0 +1,18 @@
+import { input as inputPrompt, password as passwordPrompt, select as selectPrompt } from "@inquirer/prompts";
+import { type Ora } from "ora";
+export declare const input: typeof inputPrompt;
+export declare const password: typeof passwordPrompt;
+export declare function select<Value>(cfg: Parameters<typeof selectPrompt<Value>>[0], ctx?: Parameters<typeof selectPrompt<Value>>[1]): Promise<Value>;
+export declare function confirm(message: string, defaultValue?: boolean): Promise<boolean>;
+export declare function uiWidth(): number;
+export declare function banner(title: string, subtitle: string): void;
+export declare function step(n: number, total: number, label: string): void;
+export declare function section(label: string): void;
+export declare function kv(key: string, value: string): void;
+export declare function printPanel(title: string, content: string[]): void;
+export declare function ok(msg: string): void;
+export declare function info(msg: string): void;
+export declare function warn(msg: string): void;
+export declare function fail(msg: string): void;
+export declare const themeText: (s: string) => string;
+export declare function spin<T>(label: string, fn: (spinner: Ora) => Promise<T>, doneLabel?: string): Promise<T>;

package/dist/src/cli/tui.js

@@ -0,0 +1,115 @@
+// Shared CLI chrome for the interactive commands (deploy, update): the logo banner,
+// section rules, ok/info/warn/fail lines, the spinner wrapper, and inquirer prompts
+// painted in the Base-blue palette. Keeping it here means deploy and update speak the
+// same visual language without each re-deriving it.
+import { input as inputPrompt, password as passwordPrompt, confirm as confirmPrompt, select as selectPrompt } from "@inquirer/prompts";
+import ora from "ora";
+import { dim, bold, green, yellow, red, accent, border, YAPPR_LOGO, kv as kvRow, fit, panel, sideBySide, centerRows, themeLine, } from "./ui.js";
+// Inquirer renders its own prompt line (prefix + message + answer) through its theme,
+// not our console.log — so without this it falls back to inquirer's default green "?"
+// and the terminal's own foreground, clashing with the Base-blue palette. Paint the
+// prefix/message/answer in the current palette so prompts match the rest of the chrome.
+const promptTheme = {
+    prefix: { idle: accent("?"), done: green("✔") },
+    style: {
+        message: (text) => themeLine(text),
+        answer: (text) => accent(text),
+        // dim() only adds the dim attribute (no color) → the "(Y/n)" hint would fall back
+        // to the terminal's own foreground (green). Layer dim over the palette color.
+        defaultAnswer: (text) => dim(accent(text)),
+        highlight: (text) => accent(text),
+    },
+};
+const withTheme = (cfg) => ({ ...cfg, theme: { ...promptTheme, ...(cfg.theme ?? {}) } });
+export const input = (cfg, ctx) => inputPrompt(withTheme(cfg), ctx);
+export const password = (cfg, ctx) => passwordPrompt(withTheme(cfg), ctx);
+const inquirerConfirm = (cfg, ctx) => confirmPrompt(withTheme(cfg), ctx);
+export function select(cfg, ctx) {
+    return selectPrompt(withTheme(cfg), ctx);
+}
+// `confirm` from inquirer, wrapped so Ctrl-C exits cleanly instead of throwing.
+export async function confirm(message, defaultValue = false) {
+    return inquirerConfirm({ message, default: defaultValue });
+}
+// Panel width for the deploy/update chrome — match the terminal, capped so the boxes
+// stay readable on very wide windows.
+export function uiWidth() {
+    return Math.max(48, Math.min((process.stdout.columns ?? 80) - 1, 78));
+}
+// Header: the bare logo art with the command title floating beside it, vertically
+// centred. `title` is the command (e.g. "Deploy", "Update").
+export function banner(title, subtitle) {
+    const logoW = 17; // raw logo art width (no box)
+    const h = YAPPR_LOGO.length;
+    const info = centerRows([
+        `${bold("YAPPR")} ${dim("—")} ${bold(title)}`,
+        dim(subtitle),
+    ], h).map((line) => `  ${line}`);
+    console.log("");
+    // fit() each logo row to a fixed width so the text column lines up exactly.
+    for (const row of sideBySide(YAPPR_LOGO.map((l) => "  " + fit(l, logoW)), logoW + 2, info, 0)) {
+        console.log(row);
+    }
+}
+// Numbered step header (deploy), styled like a dashboard panel title: bold caps in a
+// Base-blue rule with a "step n/total" counter.
+export function step(n, total, label) {
+    const name = label.toUpperCase();
+    const counter = `step ${n}/${total}`;
+    const fill = Math.max(2, uiWidth() - name.length - counter.length - 10);
+    console.log("");
+    console.log(`  ${border("──")} ${bold(name)} ${border("─".repeat(fill))} ${dim(counter)} ${border("──")}`);
+}
+// Section header (update): the same rule as step() but without a counter — for flows
+// that have phases rather than numbered steps.
+export function section(label) {
+    const name = label.toUpperCase();
+    const fill = Math.max(2, uiWidth() - name.length - 8);
+    console.log("");
+    console.log(`  ${border("──")} ${bold(name)} ${border("─".repeat(fill))} ${border("──")}`);
+}
+// Aligned dim-label key/value row (the shared kv style from the status dashboard).
+export function kv(key, value) {
+    console.log(`  ${kvRow(key, value)}`);
+}
+// Print a status-style bordered panel at the 2-space indent the flows use.
+export function printPanel(title, content) {
+    for (const line of panel(title, content, uiWidth() - 2))
+        console.log(`  ${line}`);
+}
+export function ok(msg) { console.log(`  ${green("✓")}  ${msg}`); }
+export function info(msg) { console.log(`     ${dim(msg)}`); }
+export function warn(msg) { console.log(`  ${yellow("⚠")}  ${yellow(msg)}`); }
+export function fail(msg) { console.log(`  ${red("✗")}  ${red(msg)}`); }
+// ora's clear() parks the cursor at the `indent` column, so a following console.log
+// would inherit those spaces. Reset to column 0 first so spinner result lines line up
+// exactly with ok()/fail() lines.
+function stopSpinner(spinner) {
+    spinner.stop();
+    if (process.stdout.isTTY)
+        process.stdout.cursorTo(0);
+}
+// ora draws its frame straight to the stream (not via our themed console.log), so its
+// label text would render in the terminal's own foreground (green). themeText paints
+// it in the palette; stripAnsi recovers the raw label for the static done line.
+const stripAnsi = (s) => s.replace(/\x1b\[[0-9;]*m/g, "");
+// Paint a (possibly already-colored) string in the palette — exported so callers can
+// re-theme a spinner's live `.text` mid-run (ora bypasses our themed console.log).
+export const themeText = (s) => themeLine(stripAnsi(s));
+// Run an async task behind a spinner, then resolve to a static line that uses the same
+// ✓/✗ glyphs and spacing as ok()/fail() so everything stays aligned.
+export async function spin(label, fn, doneLabel) {
+    const spinner = ora({ text: themeText(label), indent: 2 }).start();
+    try {
+        const result = await fn(spinner);
+        const text = stripAnsi(spinner.text);
+        stopSpinner(spinner);
+        ok(doneLabel ?? text);
+        return result;
+    }
+    catch (err) {
+        stopSpinner(spinner);
+        fail(label);
+        throw err;
+    }
+}

package/dist/src/cli/ui.d.ts

@@ -0,0 +1,30 @@
+export type ThemeName = "dark" | "light";
+export declare const themeName: () => ThemeName;
+export declare function setTheme(name: ThemeName): void;
+export declare function toggleTheme(): ThemeName;
+export declare const chartRgb: () => {
+    spent: string;
+    earn: string;
+    xapi: string;
+    inference: string;
+    compute: string;
+    x402: string;
+};
+export declare function detectTerminalTheme(timeoutMs?: number): Promise<ThemeName | null>;
+export declare const dim: (s: string) => string;
+export declare const bold: (s: string) => string;
+export declare const green: (s: string) => string;
+export declare const yellow: (s: string) => string;
+export declare const red: (s: string) => string;
+export declare const cyan: (s: string) => string;
+export declare const accent: (s: string) => string;
+export declare const border: (s: string) => string;
+export declare const themeLine: (l: string) => string;
+export declare function fit(s: string, width: number): string;
+export declare const kv: (label: string, value: string, pad?: number) => string;
+export declare function panel(title: string, content: string[], width: number): string[];
+export declare function sideBySide(a: string[], aw: number, b: string[], bw: number, gap?: number): string[];
+export declare const padRows: (lines: string[], n: number) => any[];
+export declare const centerRows: (lines: string[], n: number) => any[];
+export declare const YAPPR_ART: string[];
+export declare const YAPPR_LOGO: string[];

package/dist/src/cli/ui.js

@@ -0,0 +1,164 @@
+// Shared terminal styling + box/layout primitives for the CLI scripts (deploy,
+// status), so both speak the same visual language: dim-label kv rows and
+// rounded-border panels with the title in the top edge.
+import stringWidth from "string-width";
+import cliTruncate from "cli-truncate";
+const THEMES = {
+    dark: {
+        text: "143;191;255", green: "77;139;255", yellow: "102;163;255", red: "0;82;255",
+        cyan: "143;191;255", accent: "51;116;255", border: "0;82;255",
+        chart: { spent: "0;82;255", earn: "143;191;255", xapi: "143;191;255", inference: "77;139;255", compute: "38;99;255", x402: "170;120;255" },
+    },
+    light: {
+        text: "30;58;138", green: "0;82;255", yellow: "59;130;246", red: "30;64;175",
+        cyan: "37;99;235", accent: "29;78;216", border: "0;82;255",
+        chart: { spent: "30;58;138", earn: "59;130;246", xapi: "59;130;246", inference: "0;82;255", compute: "147;180;255", x402: "124;58;237" },
+    },
+};
+let _name = process.env.STATUS_THEME === "light" ? "light" : "dark";
+let _p = THEMES[_name];
+export const themeName = () => _name;
+export function setTheme(name) { _name = name; _p = THEMES[name]; }
+export function toggleTheme() { setTheme(_name === "dark" ? "light" : "dark"); return _name; }
+// Chart RGB triples for the current theme (charts need raw triples, not helpers,
+// for the half-block fg+bg cells).
+export const chartRgb = () => _p.chart;
+// COLORFGBG fallback ("15;0" = light fg on dark bg): last field is the bg's
+// 16-color index — 7/15 are light backgrounds. Set by rxvt/konsole/some iTerm.
+function themeFromColorFgBg() {
+    const parts = (process.env.COLORFGBG ?? "").split(";");
+    const bg = Number(parts[parts.length - 1]);
+    if (!Number.isFinite(bg) || parts.length < 2)
+        return null;
+    return bg === 7 || bg === 15 ? "light" : "dark";
+}
+// Ask the terminal for its background color (OSC 11 query; answered by iTerm2,
+// Terminal.app, kitty, alacritty, wezterm, …) and classify by luminance. Falls
+// back to COLORFGBG, then null (caller keeps the default) when the terminal
+// stays silent past the timeout. Briefly takes stdin raw to read the reply —
+// run BEFORE the dashboard's own key handling is attached.
+export function detectTerminalTheme(timeoutMs = 250) {
+    if (!process.stdout.isTTY || !process.stdin.isTTY)
+        return Promise.resolve(themeFromColorFgBg());
+    return new Promise((resolve) => {
+        const stdin = process.stdin;
+        let buf = "";
+        const done = (v) => {
+            clearTimeout(timer);
+            stdin.removeListener("data", onData);
+            try {
+                stdin.setRawMode(false);
+            }
+            catch { /* ignore */ }
+            stdin.pause();
+            resolve(v);
+        };
+        const onData = (d) => {
+            buf += d.toString("utf8");
+            // Reply: ESC ] 11 ; rgb:RRRR/GGGG/BBBB (components are 1-4 hex digits per
+            // channel; the leading 2 digits carry the top 8 bits we care about).
+            const m = buf.match(/\]11;rgb:([0-9a-f]+)\/([0-9a-f]+)\/([0-9a-f]+)/i);
+            if (!m)
+                return;
+            const [r, g, b] = [m[1], m[2], m[3]].map((s) => parseInt(s.padEnd(2, s).slice(0, 2), 16) / 255);
+            const luminance = 0.2126 * r + 0.7152 * g + 0.0722 * b;
+            done(luminance > 0.5 ? "light" : "dark");
+        };
+        const timer = setTimeout(() => done(themeFromColorFgBg()), timeoutMs);
+        try {
+            stdin.setRawMode(true);
+        }
+        catch {
+            done(themeFromColorFgBg());
+            return;
+        }
+        stdin.resume();
+        stdin.on("data", onData);
+        process.stdout.write("\x1b]11;?\x1b\\");
+    });
+}
+export const dim = (s) => `\x1b[2m${s}\x1b[0m`;
+export const bold = (s) => `\x1b[1m${s}\x1b[0m`;
+export const green = (s) => `\x1b[38;2;${_p.green}m${s}\x1b[0m`;
+export const yellow = (s) => `\x1b[38;2;${_p.yellow}m${s}\x1b[0m`;
+export const red = (s) => `\x1b[38;2;${_p.red}m${s}\x1b[0m`;
+export const cyan = (s) => `\x1b[38;2;${_p.cyan}m${s}\x1b[0m`;
+export const accent = (s) => `\x1b[38;2;${_p.accent}m${s}\x1b[0m`;
+export const border = (s) => `\x1b[38;2;${_p.border}m${s}\x1b[0m`; // box borders — Base blue (#0052FF)
+// Default color for otherwise-uncolored text. Without this, plain text renders
+// in the terminal theme's default foreground (green, white, whatever the user
+// has) — applying it at render time keeps the whole frame on-palette. Re-armed
+// after every reset so it acts as the baseline without overriding explicit colors.
+export const themeLine = (l) => {
+    const t = `\x1b[38;2;${_p.text}m`;
+    return t + l.replaceAll("\x1b[0m", "\x1b[0m" + t) + "\x1b[0m";
+};
+// ─── layout primitives (ANSI- and wide-char-aware via string-width) ────────────
+// Fit a (possibly colored) string to an exact display width: pad with spaces or
+// truncate with an ellipsis, preserving ANSI codes.
+export function fit(s, width) {
+    const w = stringWidth(s);
+    if (w === width)
+        return s;
+    if (w < width)
+        return s + " ".repeat(width - w);
+    return cliTruncate(s, width, { position: "end", truncationCharacter: "~" });
+}
+// A labelled value row, with the label dimmed and padded for column alignment.
+export const kv = (label, value, pad = 9) => dim(label.padEnd(pad)) + value;
+// Render a rounded-border panel of a fixed total width. Title sits in the top edge.
+export function panel(title, content, width) {
+    const inner = width - 4; // "│ " + content + " │"
+    const fillLen = Math.max(0, width - 5 - stringWidth(title)); // ╭ ─ " title " ─*fill ╮ (ANSI-aware)
+    const top = border("┌─") + bold(` ${title} `) + border("─".repeat(fillLen) + "┐");
+    const bottom = border("└" + "─".repeat(width - 2) + "┘");
+    const body = content.map((line) => border("│") + " " + fit(line, inner) + "\x1b[0m " + border("│"));
+    return [top, ...body, bottom];
+}
+// Lay two equal-or-fixed-width panels next to each other.
+export function sideBySide(a, aw, b, bw, gap = 1) {
+    const h = Math.max(a.length, b.length);
+    const rows = [];
+    for (let i = 0; i < h; i++) {
+        rows.push((a[i] ?? " ".repeat(aw)) + " ".repeat(gap) + (b[i] ?? " ".repeat(bw)));
+    }
+    return rows;
+}
+// Pad a content array with blank rows so stacked panels share one height.
+export const padRows = (lines, n) => (lines.length >= n ? lines : [...lines, ...Array(n - lines.length).fill("")]);
+// Like padRows, but split the padding above/below so shorter info panels sit
+// vertically centred next to the taller logo panel.
+export const centerRows = (lines, n) => {
+    if (lines.length >= n)
+        return lines;
+    const top = Math.floor((n - lines.length) / 2);
+    return [...Array(top).fill(""), ...lines, ...Array(n - lines.length - top).fill("")];
+};
+export const YAPPR_ART = [
+    "██╗   ██╗ █████╗ ██████╗ ██████╗ ██████╗ ",
+    "╚██╗ ██╔╝██╔══██╗██╔══██╗██╔══██╗██╔══██╗",
+    " ╚████╔╝ ███████║██████╔╝██████╔╝██████╔╝",
+    "  ╚██╔╝  ██╔══██║██╔═══╝ ██╔═══╝ ██╔══██╗",
+    "   ██║   ██║  ██║██║     ██║     ██║  ██║ ",
+    "   ╚═╝   ╚═╝  ╚═╝╚═╝     ╚═╝     ╚═╝  ╚═╝ ",
+];
+// Brand logo (quadrant art, 17x9 cells) from yappr-8.png — flat #0ff991 green face with
+// solid black eyes + mouth (cleaned at 2x then downsampled so the mouth is a solid
+// blob, no tongue). Transparent bg renders as spaces.
+const RAW_LOGO = [
+    "             \u001b[38;2;0;82;255m▟\u001b[0m\u001b[38;2;0;82;255m▘\u001b[0m\u001b[38;2;0;82;255m▗\u001b[0m\u001b[38;2;0;82;255m▄\u001b[0m",
+    "   \u001b[38;2;0;82;255m▄\u001b[0m\u001b[38;2;0;82;255m▟\u001b[0m\u001b[38;2;0;82;255m█\u001b[0m\u001b[38;2;0;82;255m█\u001b[0m\u001b[38;2;0;82;255m█\u001b[0m\u001b[38;2;0;82;255m█\u001b[0m\u001b[38;2;0;82;255m█\u001b[0m\u001b[38;2;0;82;255m█\u001b[0m\u001b[38;2;0;82;255m█\u001b[0m\u001b[38;2;0;82;255m▄\u001b[0m\u001b[38;2;0;82;255m▖\u001b[0m\u001b[38;2;0;82;255m▝\u001b[0m\u001b[38;2;0;82;255m▜\u001b[0m\u001b[38;2;0;82;255m▖\u001b[0m",
+    " \u001b[38;2;0;82;255m▄\u001b[0m\u001b[38;2;0;82;255m█\u001b[0m\u001b[38;2;0;82;255m█\u001b[0m\u001b[38;2;0;82;255m█\u001b[0m\u001b[38;2;0;82;255m█\u001b[0m\u001b[38;2;0;0;0;48;2;0;82;255m▗\u001b[0m\u001b[38;2;0;0;0;48;2;0;82;255m▖\u001b[0m\u001b[38;2;0;82;255m█\u001b[0m\u001b[38;2;0;82;255m█\u001b[0m\u001b[38;2;0;82;255m█\u001b[0m\u001b[38;2;0;0;0;48;2;0;82;255m▀\u001b[0m\u001b[38;2;0;82;255m█\u001b[0m\u001b[38;2;0;82;255m█\u001b[0m\u001b[38;2;0;82;255m▙\u001b[0m  ",
+    "\u001b[38;2;0;82;255m▟\u001b[0m\u001b[38;2;0;82;255m█\u001b[0m\u001b[38;2;0;82;255m█\u001b[0m\u001b[38;2;0;82;255m█\u001b[0m\u001b[38;2;0;82;255m█\u001b[0m\u001b[38;2;0;82;255m█\u001b[0m\u001b[38;2;0;82;255m█\u001b[0m\u001b[38;2;0;0;0;48;2;0;82;255m▟\u001b[0m\u001b[38;2;0;0;0m█\u001b[0m\u001b[38;2;0;0;0m█\u001b[0m\u001b[38;2;0;0;0m█\u001b[0m\u001b[38;2;0;0;0m█\u001b[0m\u001b[38;2;0;0;0;48;2;0;82;255m▙\u001b[0m\u001b[38;2;0;82;255m█\u001b[0m\u001b[38;2;0;82;255m█\u001b[0m\u001b[38;2;0;82;255m▙\u001b[0m ",
+    "\u001b[38;2;0;82;255m█\u001b[0m\u001b[38;2;0;82;255m█\u001b[0m\u001b[38;2;0;82;255m█\u001b[0m\u001b[38;2;0;82;255m█\u001b[0m\u001b[38;2;0;82;255m█\u001b[0m\u001b[38;2;0;82;255m█\u001b[0m\u001b[38;2;0;0;0;48;2;0;82;255m▟\u001b[0m\u001b[38;2;0;0;0m█\u001b[0m\u001b[38;2;0;0;0m█\u001b[0m\u001b[38;2;0;0;0m█\u001b[0m\u001b[38;2;0;0;0m█\u001b[0m\u001b[38;2;0;0;0m█\u001b[0m\u001b[38;2;0;0;0m█\u001b[0m\u001b[38;2;0;82;255m█\u001b[0m\u001b[38;2;0;82;255m█\u001b[0m\u001b[38;2;0;82;255m█\u001b[0m ",
+    "\u001b[38;2;0;82;255m▜\u001b[0m\u001b[38;2;0;82;255m█\u001b[0m\u001b[38;2;0;82;255m█\u001b[0m\u001b[38;2;0;82;255m█\u001b[0m\u001b[38;2;0;82;255m█\u001b[0m\u001b[38;2;0;82;255m█\u001b[0m\u001b[38;2;0;0;0;48;2;0;82;255m▜\u001b[0m\u001b[38;2;0;0;0m█\u001b[0m\u001b[38;2;0;0;0m█\u001b[0m\u001b[38;2;0;0;0m█\u001b[0m\u001b[38;2;0;0;0m█\u001b[0m\u001b[38;2;0;0;0m█\u001b[0m\u001b[38;2;0;0;0;48;2;0;82;255m▛\u001b[0m\u001b[38;2;0;82;255m█\u001b[0m\u001b[38;2;0;82;255m█\u001b[0m\u001b[38;2;0;82;255m▛\u001b[0m ",
+    " \u001b[38;2;0;82;255m▜\u001b[0m\u001b[38;2;0;82;255m█\u001b[0m\u001b[38;2;0;82;255m█\u001b[0m\u001b[38;2;0;82;255m█\u001b[0m\u001b[38;2;0;82;255m█\u001b[0m\u001b[38;2;0;82;255m█\u001b[0m\u001b[38;2;0;0;0;48;2;0;82;255m▀\u001b[0m\u001b[38;2;0;0;0m█\u001b[0m\u001b[38;2;0;0;0m█\u001b[0m\u001b[38;2;0;0;0m█\u001b[0m\u001b[38;2;0;0;0;48;2;0;82;255m▀\u001b[0m\u001b[38;2;0;82;255m█\u001b[0m\u001b[38;2;0;82;255m█\u001b[0m\u001b[38;2;0;82;255m▛\u001b[0m  ",
+    "  \u001b[38;2;0;82;255m▝\u001b[0m\u001b[38;2;0;82;255m▜\u001b[0m\u001b[38;2;0;82;255m█\u001b[0m\u001b[38;2;0;82;255m█\u001b[0m\u001b[38;2;0;82;255m█\u001b[0m\u001b[38;2;0;82;255m█\u001b[0m\u001b[38;2;0;82;255m█\u001b[0m\u001b[38;2;0;82;255m█\u001b[0m\u001b[38;2;0;82;255m█\u001b[0m\u001b[38;2;0;82;255m█\u001b[0m\u001b[38;2;0;82;255m▛\u001b[0m\u001b[38;2;0;82;255m▘\u001b[0m   ",
+    "     \u001b[38;2;0;82;255m▐\u001b[0m\u001b[38;2;0;82;255m█\u001b[0m\u001b[38;2;0;82;255m▀\u001b[0m\u001b[38;2;0;82;255m▀\u001b[0m\u001b[38;2;0;82;255m▀\u001b[0m       ",
+];
+// Full-block cells (fg-only `█`) only paint the font's em-box, so terminals with
+// extra line spacing show the terminal background between rows — invisible on a
+// dark background, white stripes on a light one. Cell BACKGROUNDS do fill the
+// whole line height, so solid cells render as a bg-painted space instead. Edge
+// quadrant glyphs keep their fg form (their empty half must stay transparent).
+export const YAPPR_LOGO = RAW_LOGO.map((l) => l.replaceAll(/\x1b\[38;2;(\d+;\d+;\d+)m█\x1b\[0m/g, "\x1b[48;2;$1m \x1b[0m"));

package/dist/src/cli/update.d.ts

@@ -0,0 +1 @@
+export declare function run(): Promise<void>;

package/dist/src/cli/update.js

@@ -0,0 +1,263 @@
+// `yappr update` — pull the latest engine + scaffolded skills/hooks/context into an
+// instance, then offer to redeploy. Two phases (a TUI like deploy, but no numbered
+// steps): (1) bump the package to yappr@latest, (2) reconcile the new config/ into the
+// user's ./config with the rules below. Run it from the instance dir.
+//
+// Reconcile rules, per shipped file (skill/hook/context):
+//   • the user hasn't touched it  → overwrite silently with the new version
+//   • the user edited it          → ask: keep mine / replace with new / show diff
+//   • brand-new file              → create it; if a same-name file already exists
+//                                    (the user made their own), ask before overwriting
+// "Untouched vs edited" is decided against config/.yappr-sync.json, the manifest init
+// writes (and this command rewrites). Instances with no manifest fall back to treating
+// every existing file as edited → ask, so we never silently clobber.
+import { resolve, join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import { existsSync } from "node:fs";
+import { readFile, writeFile, mkdir } from "node:fs/promises";
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+import { banner, section, spin, ok, info, warn, fail, kv, printPanel, select, confirm, } from "./tui.js";
+import { dim, bold, green, yellow, red, accent, setTheme, detectTerminalTheme, themeLine } from "./ui.js";
+import { relFiles, hashFile, loadManifest, saveManifest, } from "./config-sync.js";
+const execFileAsync = promisify(execFile);
+// This file is <pkg>/dist/src/cli/update.js (prod) or <pkg>/src/cli/update.ts (dev),
+// so the package root — and its shipped config/ template — is three levels up. After
+// the install phase replaces the package on disk, this same path holds the new config.
+const PKG_ROOT = resolve(dirname(fileURLToPath(import.meta.url)), "..", "..", "..");
+function parseFlags(argv) {
+    const has = (...names) => names.some((n) => argv.includes(n));
+    return {
+        configOnly: has("--config-only", "--no-install"),
+        yes: has("--yes", "-y"),
+        theirs: has("--theirs", "--force"),
+        ours: has("--ours", "--keep"),
+    };
+}
+// Which package manager runs the instance — pick by lockfile, default npm. Each is the
+// "install this exact dist-tag" form so `yappr@latest` lands.
+function installCmd(cwd) {
+    if (existsSync(join(cwd, "pnpm-lock.yaml")))
+        return { cmd: "pnpm", args: ["add", "yappr@latest"] };
+    if (existsSync(join(cwd, "yarn.lock")))
+        return { cmd: "yarn", args: ["add", "yappr@latest"] };
+    if (existsSync(join(cwd, "bun.lockb")))
+        return { cmd: "bun", args: ["add", "yappr@latest"] };
+    return { cmd: "npm", args: ["install", "yappr@latest"] };
+}
+// Print a coloured unified diff of the user's file vs the new one (best-effort: relies
+// on the system `diff`, which exits 1 when files differ — we read that as the diff).
+async function showDiff(userPath, pkgPath) {
+    try {
+        await execFileAsync("diff", ["-u", userPath, pkgPath]);
+        info("(no differences)");
+    }
+    catch (err) {
+        const out = typeof err?.stdout === "string" ? err.stdout : "";
+        if (!out) {
+            info("(diff unavailable)");
+            return;
+        }
+        for (const line of out.split("\n")) {
+            if (line.startsWith("+") && !line.startsWith("+++"))
+                console.log(`     ${green(line)}`);
+            else if (line.startsWith("-") && !line.startsWith("---"))
+                console.log(`     ${red(line)}`);
+            else if (line.startsWith("@@"))
+                console.log(`     ${accent(line)}`);
+            else
+                console.log(`     ${dim(line)}`);
+        }
+    }
+}
+// Resolve a conflict (user-edited or a name-clash on a new file): keep theirs, take
+// ours, or — interactively — let them choose (with an optional diff).
+async function resolveConflict(rel, userPath, pkgPath, flags) {
+    if (flags.theirs)
+        return "replace";
+    if (flags.ours || flags.yes || !process.stdout.isTTY)
+        return "keep"; // non-interactive default: never clobber edits
+    for (;;) {
+        const choice = await select({
+            message: `${accent(rel)} differs from the new version — what should I do?`,
+            choices: [
+                { name: "Keep my version", value: "keep" },
+                { name: "Replace with the new version", value: "replace" },
+                { name: "Show diff", value: "diff" },
+            ],
+        });
+        if (choice === "diff") {
+            await showDiff(userPath, pkgPath);
+            continue;
+        }
+        return choice;
+    }
+}
+async function reconcile(configDir, templateDir, flags) {
+    const counts = { create: 0, update: 0, overwrite: 0, keep: 0, current: 0 };
+    const shipped = await relFiles(templateDir);
+    const manifest = await loadManifest(configDir);
+    const next = {};
+    for (const rel of shipped) {
+        const userPath = join(configDir, rel);
+        const pkgPath = join(templateDir, rel);
+        const [userHash, newHash] = await Promise.all([hashFile(userPath), hashFile(pkgPath)]);
+        if (!newHash)
+            continue; // unreadable shipped file — skip defensively
+        const recorded = manifest[rel];
+        const write = async () => {
+            await mkdir(dirname(userPath), { recursive: true });
+            await writeFile(userPath, await readFile(pkgPath));
+            next[rel] = newHash;
+        };
+        if (userHash === null) {
+            // Not present in the instance → a brand-new file. Create it.
+            await write();
+            counts.create++;
+            ok(`added ${accent(rel)}`);
+        }
+        else if (userHash === newHash) {
+            // Already identical to the new version — nothing to do.
+            next[rel] = newHash;
+            counts.current++;
+        }
+        else if (recorded && userHash === recorded) {
+            // Untouched by the user since we last installed it, but the package changed →
+            // safe to fast-forward.
+            await write();
+            counts.update++;
+            ok(`updated ${accent(rel)}`);
+        }
+        else {
+            // Diverged: the user edited it, or it pre-existed untracked (their own file with
+            // the same name). Never clobber without consent.
+            const decision = await resolveConflict(rel, userPath, pkgPath, flags);
+            if (decision === "replace") {
+                await write();
+                counts.overwrite++;
+                ok(`replaced ${accent(rel)} ${dim("(your version backed out)")}`);
+            }
+            else {
+                next[rel] = recorded ?? userHash; // keep detecting against the same baseline
+                counts.keep++;
+                info(`kept your ${rel}`);
+            }
+        }
+    }
+    await saveManifest(configDir, next);
+    return counts;
+}
+async function main() {
+    const flags = parseFlags(process.argv.slice(2));
+    const cwd = process.cwd();
+    const configDir = join(cwd, "config");
+    if (process.stdout.isTTY)
+        process.stdout.write("\x1b[2J\x1b[3J\x1b[H");
+    if (!process.env.STATUS_THEME) {
+        const detected = await detectTerminalTheme().catch(() => null);
+        if (detected)
+            setTheme(detected);
+    }
+    // Paint every printed line in the palette's default text color (see deploy.ts /
+    // ui.themeLine): the chrome only colors specific glyphs and leaves message text
+    // uncolored, which otherwise falls back to the terminal's own foreground.
+    if (process.stdout.isTTY) {
+        for (const m of ["log", "error"]) {
+            const orig = console[m].bind(console);
+            console[m] = (...args) => orig(...args.map((a) => (typeof a === "string" ? themeLine(a) : a)));
+        }
+    }
+    banner("Update", "Pull the latest engine + skills into this instance");
+    if (!existsSync(configDir)) {
+        console.log("");
+        fail(`No ./config here — run \`yappr update\` from your instance directory (where you ran \`yappr init\`).`);
+        process.exitCode = 1;
+        return;
+    }
+    // ── Phase 1: bump the package ────────────────────────────────────────────────
+    // Only when yappr is actually an installed dependency of this instance (skip in dev
+    // / when running the engine in place, where there's nothing to install).
+    const installedHere = existsSync(join(cwd, "node_modules", "yappr"));
+    section("Package");
+    if (flags.configOnly) {
+        info("--config-only — skipping package update");
+    }
+    else if (!installedHere) {
+        warn("yappr isn't an installed dependency here — skipping package update (syncing config only)");
+    }
+    else {
+        const { cmd, args } = installCmd(cwd);
+        try {
+            await spin(`Updating engine — ${dim(`${cmd} ${args.join(" ")}`)}…`, () => execFileAsync(cmd, args, { cwd }), "Engine updated to yappr@latest");
+        }
+        catch (err) {
+            fail(`Package update failed: ${err instanceof Error ? err.message : String(err)}`);
+            if (!(await confirm("Continue and just reconcile config from the currently-installed version?", true))) {
+                process.exitCode = 1;
+                return;
+            }
+        }
+    }
+    // ── Phase 2: reconcile config ────────────────────────────────────────────────
+    const templateDir = join(PKG_ROOT, "config");
+    section("Config");
+    if (!existsSync(templateDir)) {
+        fail(`Installed package has no config/ template at ${templateDir}.`);
+        process.exitCode = 1;
+        return;
+    }
+    const c = await reconcile(configDir, templateDir, flags);
+    const touched = c.create + c.update + c.overwrite;
+    if (touched === 0 && c.keep === 0)
+        info("everything already up to date");
+    // ── Summary ──────────────────────────────────────────────────────────────────
+    console.log("");
+    printPanel("UPDATE SUMMARY", [
+        kvFmt("Added", c.create, green),
+        kvFmt("Updated", c.update, green),
+        kvFmt("Replaced", c.overwrite, yellow),
+        kvFmt("Kept yours", c.keep, dim),
+        kvFmt("Unchanged", c.current, dim),
+    ]);
+    // ── Next: redeploy ─────────────────────────────────────────────────────────────
+    section("Next");
+    if (touched === 0) {
+        info("No config changes — nothing to redeploy.");
+        return;
+    }
+    console.log(`  ${yellow("⚠")}  ${bold("Your live agent is still running the previous version.")}`);
+    info("These changes only take effect on the server after a redeploy.");
+    console.log("");
+    if (process.stdout.isTTY && await confirm("Redeploy now to apply the update?", true)) {
+        const { run } = await import("./deploy.js");
+        await run();
+    }
+    else {
+        kv("Redeploy", `${bold("npx yappr deploy")}   ${dim("— push these changes to your instance")}`);
+    }
+}
+// A right-aligned-ish count row for the summary panel, coloured by the formatter.
+function kvFmt(label, n, color) {
+    return `${dim(label.padEnd(11))}${color(String(n))}`;
+}
+export async function run() {
+    await main();
+}
+const isMain = (() => {
+    try {
+        return fileURLToPath(import.meta.url) === resolve(process.argv[1] ?? "");
+    }
+    catch {
+        return false;
+    }
+})();
+if (isMain) {
+    run().catch((err) => {
+        if (err?.name === "ExitPromptError") {
+            console.log("\n  Aborted.");
+            process.exit(0);
+        }
+        console.error(`\n  ✗  ${err?.message ?? err}`);
+        process.exit(1);
+    });
+}

package/dist/src/cli/x-login.d.ts

@@ -0,0 +1,6 @@
+export type XCredentials = {
+    authToken: string;
+    ct0: string;
+    username?: string;
+};
+export declare function connectXViaBrowser(): Promise<XCredentials>;