@pugi/cli 0.1.0-beta.98 → 1.0.0-alpha.1

package/dist/tui/repl-splash-art.js

@@ -1,64 +0,0 @@
-/**
- * ASCII pug mascot for the REPL boot splash .
- *
- * Hand-crafted at 9 rows × 20 columns to read as a pug at a single
- * glance — references the cyber-zoo hero glyph in
- * `apps/console-web/public/brand/hero-pug.png`: blocky pug face with
- * angular ear flaps on either side of the head, forehead crease,
- * angular cyan eyes (`◉`), smushed snout, undershot jaw, and a small
- * cyan circuit chip (`▐■▌`) on the lower-right cheek.
- *
- * Separation of art + cyan mask lets the unit test assert structure
- * (row count, line widths, mask shape, at-least-one cyan pixel per
- * eye row) without coupling to the Ink renderer. The renderer in
- * `repl-splash.tsx` splits each row into runs and colors the masked
- * columns cyan (#3DA9FC, brandbook §05).
- *
- * Convention:
- *  - PUG_MASCOT[i]           = one row of the silhouette
- *  - PUG_MASCOT_CYAN_MASK[i] = parallel boolean array, true => that
- *                               column renders cyan instead of gray
- *
- * Both arrays MUST stay the same length and each mask row MUST be the
- * same length as the corresponding art row. A unit test enforces this.
- */
-/* eslint-disable no-irregular-whitespace */
-export const PUG_MASCOT = [
-    '  ▄▀▀▀▄▄▄▀▀▀▄   ',
-    ' █▄▄      ▄▄█  ',
-    ' █ ▀▄▄▄▄▄▀ █  ',
-    ' █ ◉    ◉ █  ',
-    '  ▀▄ ▀█▀ ▄▀   ',
-    '    █▀▀▀▀▀█     ',
-    '    █▒▒▒▒▒█ ▐■▌ ',
-    '     ▀▄▄▄▀      ',
-    '       ▀        ',
-];
-/**
- * Cyan accents are derived from the source characters so the art file
- * stays the single source of truth. Two glyph classes get colored:
- *  - `◉`    -> the two cyan eyes on row 3
- *  - `▐■▌`  -> the cyan chip cluster on row 6 (right cheek)
- *
- * Everything else renders gray. The derivation runs at module load,
- * which keeps the mask trivially auditable from the source array.
- */
-export const PUG_MASCOT_CYAN_MASK = PUG_MASCOT.map((row) => {
-    const mask = new Array(row.length).fill(false);
-    for (let column = 0; column < row.length; column += 1) {
-        const ch = row.charAt(column);
-        if (ch === '◉' || ch === '▐' || ch === '■' || ch === '▌') {
-            mask[column] = true;
-        }
-    }
-    return mask;
-});
-/**
- * Pre-computed silhouette dimensions for layout math in the splash
- * component. The unit test asserts these stay inside the documented
- * envelope (≤22 chars wide, 9 ≤ rows ≤ 14) so a future edit can not
- * silently bloat the terminal real estate.
- */
-export const PUG_MASCOT_MAX_WIDTH = PUG_MASCOT.reduce((max, row) => Math.max(max, row.length), 0);
-export const PUG_MASCOT_HEIGHT = PUG_MASCOT.length;
-//# sourceMappingURL=repl-splash-art.js.map

package/dist/tui/repl-splash-mascot.js

@@ -1,154 +0,0 @@
-/**
- * Chafa-validated brand-pug ANSI loader .
- *
- * CEO dogfood (first pass, wave 5): the hand-crafted
- * 9-row ASCII pug in `repl-splash-art.ts` reads as "точно не похожа" —
- * too abstract to carry the brand at boot. This module loads a pre-baked
- * truecolor ANSI render of the canonical hero-pug PNG (cyber-zoo pug
- * face with cyan eyes + circuit + chip) so the splash matches the brand
- * glyph the operator already sees on pugi.io.
- *
- * CEO dogfood : the first chafa bake at 32x16 still
- * read as "monitor on stand", not pug — too few rows to resolve the
- * snout / eyes / wrinkles. The vertical resolution was the bottleneck:
- * 16 char rows ≈ 16 pixel rows with the block symbol set. The fresh
- * bake uses `vhalf` (vertical half blocks ▀ / ▄ with independent fg+bg
- * colours per cell) which doubles the vertical resolution per character
- * cell, at an 80x40 frame which is 2.5× the prior dimensions. End
- * result: ~80×80 effective pixel resolution — enough to read the
- * snout, eye sockets, ear lines, and the circuit board accent the
- * brand glyph carries. File grew from 8.8KB to ~40KB; ship budget
- * gates at 100KB so we stay well under cap.
- *
- * Generation (operator-side, one-shot):
- *  chafa --size 80x40 --symbols=vhalf --colors=full \
- *    apps/console-web/public/brand/hero-pug.png \
- *    > apps/pugi-cli/assets/pugi-mascot.ansi
- *
- * The output is committed verbatim to the repo and shipped inside the
- * `@pugi/cli` npm tarball under `assets/pugi-mascot.ansi` (the
- * `package.json` `files` allowlist explicitly opts in). Runtime does
- * NOT need `chafa` installed — we just read the file bytes and write
- * them to stdout. If the file is missing (degraded install, tarball
- * corruption, dev cwd drift), the splash falls back to the hand-crafted
- * `PUG_MASCOT` art so the boot never crashes.
- *
- * The pre-Ink write convention mirrors the the upstream tool Chrome plugin
- * splash pattern: raw bytes go to `process.stdout` BEFORE the Ink
- * render mount, so the terminal interprets the truecolor escapes
- * directly instead of Ink trying to layout-engine over them.
- */
-import { existsSync, readFileSync } from 'node:fs';
-import { dirname, resolve as resolvePath } from 'node:path';
-import { fileURLToPath } from 'node:url';
-/**
- * Resolve the on-disk path to `pugi-mascot.ansi` relative to the
- * compiled module. The CLI ships to `node_modules/@pugi/cli/dist/tui/`
- * so the asset lives at `node_modules/@pugi/cli/assets/pugi-mascot.ansi`
- * — two directory hops up from this file. In a local `pnpm dev`
- * checkout the structure is the same (`src/tui/` ⇒ `../../assets/`)
- * because tsx re-resolves the same relative tree.
- *
- * CEO P0 #2 — banner mascot bake. The prozr2 portrait is
- * the canonical brand-pug glyph from `apps/console-web/public/brand/
- * Pugi-prozr2.png`, baked к а 16x8 vhalf truecolor render. We prefer
- * the prozr2 bake when it ships alongside the CLI (small — ~900 bytes,
- * shaped for the compact welcome-banner left column) and fall back к
- * the legacy 40KB `pugi-mascot.ansi` (hero-pug 80x40) when prozr2 is
- * missing — preserves the splash-mascot install surface for any
- * tarball that predates the bake.
- */
-export function pugMascotAssetPath() {
-    const here = dirname(fileURLToPath(import.meta.url));
-    const prozr2 = resolvePath(here, '..', '..', 'assets', 'pugi-prozr2-mascot.ansi');
-    if (existsSync(prozr2))
-        return prozr2;
-    return resolvePath(here, '..', '..', 'assets', 'pugi-mascot.ansi');
-}
-/**
- * Read the chafa-baked ANSI render of the brand pug. Returns the raw
- * bytes verbatim (UTF-8 string) — the terminal interprets the truecolor
- * escapes directly. Returns null when the file is missing, unreadable,
- * or trivially empty so the caller can fall back to `PUG_MASCOT`.
- *
- * `chafa --colors=full` wraps the render with cursor-hide (`\e[?25l`)
- * on the head and cursor-show (`\e[?25h`) on the tail. We strip those
- * so the splash does not accidentally hide the cursor across the rest
- * of the REPL boot (Ink itself manages the cursor once it mounts).
- *
- * The asset is supply-chain controlled (committed in-repo, shipped in
- * the npm tarball) so an arbitrary attacker cannot inject escapes
- * today. The defence-in-depth strip below still drops categories of
- * escapes that the splash has no legitimate need to emit — OSC window
- * title sets, mouse-tracking enables, screen clears, cursor-position
- * reports — so a future swap of the asset (or a corrupt tarball) cannot
- * disrupt the terminal beyond the splash region. Truecolor (`CSI 38;2;
- * R;G;B m`), reset (`CSI 0 m`), and explicit forms of cursor / line
- * motion the render needs are left in.
- */
-export function loadPugMascotAnsi() {
-    const path = pugMascotAssetPath();
-    try {
-        if (!existsSync(path))
-            return null;
-        const raw = readFileSync(path, 'utf8');
-        if (!raw || raw.length === 0)
-            return null;
-        // 1. Drop OSC sequences. Two terminator forms:
-        //     ESC ] ... BEL         (0x1b 0x5d ... 0x07)
-        //     ESC ] ... ESC \       (0x1b 0x5d ... 0x1b 0x5c, the ST form)
-        //   A truecolor splash never needs OSC (those are for window title,
-        //   icon, clipboard, hyperlinks, color-palette change). Drop them
-        //   so a corrupted asset cannot rename the operator's terminal tab
-        //   or smuggle a hyperlink into the splash region.
-        // 2. Drop ALL CSI ? <numbers and semicolons> [lh] (DEC private-mode
-        //   set / reset). The legitimate chafa output for a splash is
-        //   truecolor SGR (`CSI 38;2;R;G;B m`) plus cursor-positioning —
-        //   no private-mode toggle ever appears там legitimately. A
-        //   permissive deny-all pattern covers every disruptive private
-        //   mode in one regex:
-        //     - cursor visibility (25)
-        //     - alt-screen buffer (47, 1047, 1048, 1049)
-        //     - mouse tracking    (1000, 1001, 1002, 1003, 1004, 1005, 1006, 1015)
-        //     - bracketed paste   (2004)
-        //     - focus reporting   (1004)
-        //     - multi-mode forms  (e.g. `CSI ? 47 ; 1049 h` — legal per
-        //       xterm ctlseqs but missed by the previous single-mode regex)
-        //     - any future private mode a corrupt asset might emit
-        //   Allowlisting the modes the splash needs is impossible because
-        //   the splash needs ZERO of them — chafa renders glyph-by-glyph,
-        //   not via private-mode toggles. A pure deny-all is strictly
-        //   safer than enumerating known-bad modes one-by-one.
-        // 3. Drop CSI 6 n (cursor-position report). Would inject a fake
-        //   CPR into the operator's stdin stream.
-        // 4. Drop CSI [23]J / CSI [23]K (full screen / line clear). A
-        //   chafa render uses cursor-positioning per row, not bulk
-        //   erases; bulk clears would wipe whatever the operator already
-        //   had on screen above the splash.
-        const stripped = raw
-            .replace(/\x1b\][^\x07\x1b]*(?:\x07|\x1b\\)/g, '')
-            .replace(/\x1b\[\?[0-9;]+[lh]/g, '')
-            .replace(/\x1b\[6n/g, '')
-            .replace(/\x1b\[[23]?[JK]/g, '');
-        if (stripped.trim().length === 0)
-            return null;
-        return stripped;
-    }
-    catch {
-        // Best-effort: any FS / decode error returns null so the splash
-        // falls back to the hand-crafted ASCII art. Never throws.
-        return null;
-    }
-}
-export function printPugMascotPreInk(sink) {
-    const ansi = loadPugMascotAnsi();
-    if (ansi === null)
-        return false;
-    // Trailing newline so the Ink header lands on a fresh row rather
-    // than smashing into the last pug row.
-    sink.write(ansi);
-    if (!ansi.endsWith('\n'))
-        sink.write('\n');
-    return true;
-}
-//# sourceMappingURL=repl-splash-mascot.js.map

package/dist/tui/repl-splash.js

@@ -1,117 +0,0 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-/**
- * REPL boot splash .
- *
- * Rendered on REPL first paint — before the conversation pane, before
- * any operator input lands. Mirrors the the upstream tool / Codex / Gemini
- * CLI boot-screen aesthetic while staying Pugi-brand-pure:
- *
- *  [PUG ASCII]  Pugi.io v0.1.0-alphaN
- *                Plan:     <plan>
- *                Model:    <model>
- *                Tenant:   <customerId>
- *                Workspace: <basename>
- *
- *  ─────────────────────────────────────
- *  Tips for getting started:
- *    1. Type a brief, the workforce dispatches
- *    2. /help for slash commands, /web <url> to pull a page
- *    3. /skills install <name> for Anthropic / OpenClaw skills
- *
- * The splash auto-dismisses on:
- *  - first operator keystroke (the REPL `<Repl />` host owns this and
- *    calls the `onInteract` callback we expose),
- *  - 10s idle timeout (built-in, configurable via `skipSplash`),
- *  - `--no-splash` CLI flag or PUGI_SKIP_SPLASH=1 env (host gates the
- *    mount entirely; we still respect the `skipSplash` prop as a belt
- *    so a stray render in a test environment produces nothing).
- *
- * Brand voice gate: every visible string here is reviewed against the
- * forbidden list (`journey / explore / delight / magical / friendly /
- * AI-powered / pug-tastic`). Power words used: `brief / dispatch /
- * ship / workforce / sentinel / skills`. No em-dashes; box-drawing
- * `─` is OK (matches existing REPL header conventions).
- */
-import { useEffect } from 'react';
-import { Box, Text } from 'ink';
-import { PUG_MASCOT, PUG_MASCOT_CYAN_MASK, PUG_MASCOT_MAX_WIDTH, } from './repl-splash-art.js';
-const DEFAULT_AUTO_DISMISS_MS = 10_000;
-const PLACEHOLDER = '—';
-export function ReplSplash(props) {
-    // Hooks MUST run unconditionally so the React reconciler can keep
-    // its hook order. We branch on `skipSplash` AFTER the effect
-    // declaration; the effect itself bails early when the splash is
-    // suppressed so no stray timer fires in the skip path.
-    useEffect(() => {
-        if (props.skipSplash)
-            return undefined;
-        const ms = props.autoDismissMs ?? DEFAULT_AUTO_DISMISS_MS;
-        const handle = setTimeout(() => {
-            props.onDismiss?.();
-        }, ms);
-        return () => clearTimeout(handle);
-        // Dependency on the onDismiss callback would re-arm the timer on
-        // every parent rerender; the host wraps it in useCallback so
-        // identity is stable for the splash's lifetime.
-    }, [props.autoDismissMs, props.onDismiss, props.skipSplash]);
-    // Belt for stray test renders: when the host already knows the
-    // operator opted out, we still want a render call to produce nothing
-    // visible. The host is the source of truth for mount-or-not; this is
-    // the no-op fallback.
-    if (props.skipSplash) {
-        return null;
-    }
-    // wave 5: when the host pre-printed the chafa-baked brand-pug
-    // ANSI render to stdout before Ink mounted, suppress the hand-crafted
-    // PUG_MASCOT column here so the operator does not see two stacked
-    // pugs. The header card still renders inline so wordmark + status
-    // rows stay attached to the splash flow.
-    const showHandCraftedMascot = props.mascotPrePrinted !== true;
-    return (_jsxs(Box, { flexDirection: "column", paddingX: 1, paddingY: 1, children: [_jsxs(Box, { flexDirection: "row", children: [showHandCraftedMascot ? _jsx(MascotColumn, {}) : null, _jsxs(Box, { flexDirection: "column", marginLeft: showHandCraftedMascot ? 2 : 0, marginTop: 1, children: [_jsxs(Box, { children: [_jsx(Text, { bold: true, children: "Pugi" }), _jsx(Text, { bold: true, color: "#3da9fc", children: ".io" }), _jsx(Text, { dimColor: true, children: ` v${props.cliVersion}` })] }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(HeaderRow, { label: "Plan", value: props.plan ?? PLACEHOLDER }), _jsx(HeaderRow, { label: "Model", value: props.model ?? PLACEHOLDER }), _jsx(HeaderRow, { label: "Tenant", value: props.tenant ?? PLACEHOLDER }), _jsx(HeaderRow, { label: "Workspace", value: props.workspaceLabel })] })] })] }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { dimColor: true, children: '─'.repeat(40) }) }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(Text, { dimColor: true, children: "Tips for getting started:" }), _jsx(TipRow, { index: 1, text: "Type a brief, the workforce dispatches" }), _jsx(TipRow, { index: 2, text: "/help for slash commands, /web <url> to pull a page" }), _jsx(TipRow, { index: 3, text: "/skills install <name> for Anthropic / OpenClaw skills" })] })] }));
-}
-/**
- * Renders the multi-line ASCII pug. Each row is split into colored
- * runs based on `PUG_MASCOT_CYAN_MASK` so the eyes + chip come out
- * cyan and the body stays gray. Pure render of the static art array;
- * no IO, no state.
- */
-function MascotColumn() {
-    return (_jsx(Box, { flexDirection: "column", minWidth: PUG_MASCOT_MAX_WIDTH, children: PUG_MASCOT.map((row, rowIndex) => (_jsx(MascotRow, { row: row, mask: PUG_MASCOT_CYAN_MASK[rowIndex] ?? [] }, rowIndex))) }));
-}
-function MascotRow({ row, mask, }) {
-    // Split the row into contiguous runs of same-color cells so we emit
-    // one <Text> per run instead of one per character. Keeps the Ink
-    // render tree shallow and the snapshot diff readable.
-    const runs = [];
-    let buffer = '';
-    let bufferCyan = false;
-    for (let column = 0; column < row.length; column += 1) {
-        const ch = row.charAt(column);
-        const cyan = mask[column] === true;
-        if (buffer.length === 0) {
-            buffer = ch;
-            bufferCyan = cyan;
-            continue;
-        }
-        if (cyan === bufferCyan) {
-            buffer += ch;
-        }
-        else {
-            runs.push({ text: buffer, cyan: bufferCyan });
-            buffer = ch;
-            bufferCyan = cyan;
-        }
-    }
-    if (buffer.length > 0) {
-        runs.push({ text: buffer, cyan: bufferCyan });
-    }
-    return (_jsx(Text, { children: runs.map((run, runIndex) => run.cyan ? (_jsx(Text, { color: "#3da9fc", children: run.text }, runIndex)) : (_jsx(Text, { color: "gray", children: run.text }, runIndex))) }));
-}
-function HeaderRow({ label, value }) {
-    const padded = `${label}:`.padEnd(11, ' ');
-    return (_jsxs(Text, { children: [_jsx(Text, { dimColor: true, children: padded }), _jsx(Text, { children: value })] }));
-}
-function TipRow({ index, text }) {
-    return (_jsxs(Text, { children: [_jsx(Text, { dimColor: true, children: ` ${index}. ` }), _jsx(Text, { children: text })] }));
-}
-//# sourceMappingURL=repl-splash.js.map