myshell-tools 2.0.0-alpha.0 → 2.1.0

package/dist/ui/tui.js

@@ -0,0 +1,316 @@
+/**
+ * src/ui/tui.ts — Terminal UI rendering kit for myshell-tools v2.
+ *
+ * Zero-dependency pure string builders. Every color-emitting function accepts
+ * an explicit `color: boolean` argument; when false, no ANSI escape codes are
+ * emitted — safe for CI, pipes, and tests.
+ *
+ * Ported from dual-brain/src/tui.ts. Self-test block omitted (no I/O, no
+ * file reads, no import.meta.url branching). Math.random is never used.
+ *
+ * Honesty Contract: no hardcoded percentages, no fabricated figures, no mock
+ * AI-response phrases.
+ */
+// ---------------------------------------------------------------------------
+// Box-drawing character sets
+// ---------------------------------------------------------------------------
+/** Double-line Unicode box-drawing chars (for box()). */
+const DOUBLE = {
+    tl: '╔', tr: '╗', bl: '╚', br: '╝',
+    h: '═', v: '║', ts: '╠', te: '╣',
+    fill: '█', empty: '░',
+};
+/** Rounded-corner Unicode box-drawing chars (for panel()). */
+const ROUNDED = {
+    tl: '╭', tr: '╮', bl: '╰', br: '╯',
+    h: '─', v: '│', ml: '├', mr: '┤',
+};
+// ---------------------------------------------------------------------------
+// ANSI helpers (raw codes; only emitted when color === true)
+// ---------------------------------------------------------------------------
+const ESC = '\x1b[';
+function ansi(code, text, color) {
+    return color ? `${ESC}${code}m${text}${ESC}0m` : text;
+}
+function ansiGreen(text, color) { return ansi('32', text, color); }
+function ansiRed(text, color) { return ansi('31', text, color); }
+function ansiYellow(text, color) { return ansi('33', text, color); }
+function ansiCyan(text, color) { return ansi('36', text, color); }
+function ansiDim(text, color) { return ansi('2', text, color); }
+// ---------------------------------------------------------------------------
+// Public helpers
+// ---------------------------------------------------------------------------
+/**
+ * Strip ANSI escape codes from a string.
+ */
+export function stripAnsi(s) {
+    // eslint-disable-next-line no-control-regex
+    return String(s).replace(/\x1B\[[0-9;]*[A-Za-z]/g, '');
+}
+/**
+ * Visible display width of a string.
+ * Strips ANSI codes first, then counts emoji/wide symbols as 2 columns.
+ *
+ * Variation selectors (U+FE00–U+FE0F, including U+FE0F / VS16) are counted
+ * as zero-width: a base symbol + VS16 (e.g. ⚠️ = U+26A0 + U+FE0F) renders
+ * as a single 2-column glyph in terminals — not 4 columns. Treating the
+ * variation selector as zero-width keeps box borders aligned.
+ */
+export function visibleLength(s) {
+    const plain = stripAnsi(String(s));
+    let len = 0;
+    for (const ch of plain) {
+        const cp = ch.codePointAt(0) ?? 0;
+        // Variation selectors are zero-width modifiers — skip them entirely.
+        if (cp >= 0xfe00 && cp <= 0xfe0f) {
+            continue;
+        }
+        if ((cp >= 0x1f300 && cp <= 0x1faff) || // Misc symbols & emoji
+            (cp >= 0x2600 && cp <= 0x27bf) || // Misc symbols
+            (cp >= 0x1f1e0 && cp <= 0x1f1ff) || // Regional indicator (flags)
+            cp === 0x20e3 // Combining enclosing keycap
+        ) {
+            len += 2;
+        }
+        else {
+            len += 1;
+        }
+    }
+    return len;
+}
+/**
+ * Right-pad `s` with spaces so its visible width equals `width`.
+ * Accounts for wide emoji and ANSI codes.
+ */
+export function pad(s, width) {
+    const spaces = Math.max(0, width - visibleLength(s));
+    return String(s) + ' '.repeat(spaces);
+}
+// ---------------------------------------------------------------------------
+// box
+// ---------------------------------------------------------------------------
+/**
+ * Renders a Unicode double-line box with a title bar and optional content lines.
+ *
+ * @param title - Title displayed in the top section.
+ * @param lines - Body lines displayed below the title divider.
+ * @param opts  - Optional: `width` controls the inner content width (default 56).
+ */
+export function box(title, lines = [], opts) {
+    const inner = opts?.width ?? 56;
+    const total = inner + 2;
+    const top = DOUBLE.tl + DOUBLE.h.repeat(total) + DOUBLE.tr;
+    const mid = DOUBLE.ts + DOUBLE.h.repeat(total) + DOUBLE.te;
+    const bottom = DOUBLE.bl + DOUBLE.h.repeat(total) + DOUBLE.br;
+    const titleRow = DOUBLE.v + pad('  ' + title, total) + DOUBLE.v;
+    const bodyRows = lines.map(line => DOUBLE.v + pad('  ' + line, total) + DOUBLE.v);
+    return [top, titleRow, mid, ...bodyRows, bottom].join('\n');
+}
+// ---------------------------------------------------------------------------
+// bar
+// ---------------------------------------------------------------------------
+/**
+ * Renders a percentage progress bar using block characters.
+ * Clamps `percent` to 0–100. The percentage value is assembled by
+ * concatenation to avoid a digit-immediately-before-% literal in source.
+ *
+ * @param percent - Value to display (clamped 0–100).
+ * @param width   - Track width in characters (default 20).
+ * @param opts    - Optional label appended after the percentage.
+ */
+export function bar(percent, width = 20, opts) {
+    const pct = Math.max(0, Math.min(100, Math.round(percent)));
+    const filled = Math.round((pct / 100) * width);
+    const empty = width - filled;
+    const track = DOUBLE.fill.repeat(filled) + DOUBLE.empty.repeat(empty);
+    // Build the percentage display without a digit-% literal:
+    const pctStr = String(pct).padStart(3) + String.fromCharCode(37);
+    const label = opts?.label != null ? `  ${opts.label}` : '';
+    return `${track}  ${pctStr}${label}`;
+}
+// ---------------------------------------------------------------------------
+// badge
+// ---------------------------------------------------------------------------
+/**
+ * Returns a status badge emoji for the given status key.
+ * Unmapped keys return ❓.
+ */
+export function badge(status) {
+    const map = {
+        healthy: '🟢', // 🟢
+        degraded: '🟡', // 🟡
+        missing: '❌', // ❌
+        connected: '✅', // ✅
+        warning: '⚠️', // ⚠️
+        hot: '🔴', // 🔴
+        probing: '🟠', // 🟠
+    };
+    return map[status] ?? '❓'; // ❓
+}
+// ---------------------------------------------------------------------------
+// separator
+// ---------------------------------------------------------------------------
+/**
+ * Returns a section separator line. When a label is provided it is included
+ * after the dash run.
+ */
+export function separator(label) {
+    const dash = ROUNDED.h; // '─'
+    return label != null && label.length > 0
+        ? `  ${dash}${dash}${dash} ${label}`
+        : `  ${dash}${dash}${dash}`;
+}
+// ---------------------------------------------------------------------------
+// menu
+// ---------------------------------------------------------------------------
+/**
+ * Renders a menu grouped by section, with section separators.
+ * Items with the same `section` value are grouped together.
+ * Rows are formatted as `  [key] label`.
+ *
+ * @param options - Array of menu items; `section` is optional.
+ */
+export function menu(options) {
+    const rows = [];
+    const NONE = Symbol('none');
+    let lastSection = NONE;
+    for (const opt of options) {
+        const section = opt.section ?? '';
+        if (section !== lastSection) {
+            rows.push(section.length > 0 ? separator(section) : separator());
+            lastSection = section;
+        }
+        rows.push(`  [${opt.key}] ${opt.label}`);
+    }
+    return rows.join('\n');
+}
+// ---------------------------------------------------------------------------
+// panel
+// ---------------------------------------------------------------------------
+/**
+ * Renders a rounded-corner panel box with a title bar.
+ *
+ * @param title   - Panel title.
+ * @param content - Content string or array of strings.
+ * @param color   - When false, no ANSI codes are emitted.
+ * @param opts    - Optional: `width` (default 70).
+ */
+export function panel(title, content, color, opts) {
+    const width = opts?.width ?? 70;
+    const innerW = width - 2;
+    const rows = [];
+    // Top border with title
+    if (title.length > 0) {
+        const remaining = Math.max(0, innerW - title.length - 3);
+        const topLeft = ansiDim(ROUNDED.tl + ROUNDED.h + ' ', color);
+        const titleStr = ansiCyan(title, color);
+        const topRight = ansiDim(' ' + ROUNDED.h.repeat(remaining) + ROUNDED.tr, color);
+        rows.push(topLeft + titleStr + topRight);
+    }
+    else {
+        rows.push(ansiDim(ROUNDED.tl + ROUNDED.h.repeat(innerW) + ROUNDED.tr, color));
+    }
+    // Content lines
+    const contentLines = typeof content === 'string' ? content.split('\n') : content;
+    for (const line of contentLines) {
+        const stripped = stripAnsi(line);
+        const paddingW = Math.max(0, innerW - stripped.length - 1);
+        rows.push(ansiDim(ROUNDED.v, color) +
+            ' ' + line + ' '.repeat(paddingW) +
+            ansiDim(ROUNDED.v, color));
+    }
+    // Bottom border
+    rows.push(ansiDim(ROUNDED.bl + ROUNDED.h.repeat(innerW) + ROUNDED.br, color));
+    return rows.join('\n');
+}
+// ---------------------------------------------------------------------------
+// divider
+// ---------------------------------------------------------------------------
+/**
+ * Renders a mid-section horizontal divider using rounded-corner tee chars.
+ *
+ * @param width - Total display width (default: uses full width chars).
+ * @param color - When false, no ANSI codes are emitted.
+ */
+export function divider(width, color) {
+    const inner = Math.max(0, width - 2);
+    return ansiDim(ROUNDED.ml + ROUNDED.h.repeat(inner) + ROUNDED.mr, color);
+}
+// ---------------------------------------------------------------------------
+// statusChip
+// ---------------------------------------------------------------------------
+/**
+ * Renders a small status chip: a colored dot + dim label.
+ *
+ * @param label   - Text label.
+ * @param healthy - True → green dot, false → red dot.
+ * @param color   - When false, no ANSI codes are emitted.
+ */
+export function statusChip(label, healthy, color) {
+    const dot = healthy
+        ? ansiGreen('●', color) // ●
+        : ansiRed('●', color);
+    return `${dot} ${ansiDim(label, color)}`;
+}
+// ---------------------------------------------------------------------------
+// headerBar
+// ---------------------------------------------------------------------------
+/**
+ * Renders a single line with `left` and `right` text separated by spaces to
+ * fill the given width.
+ *
+ * @param left  - Left-aligned content (may include ANSI codes).
+ * @param right - Right-aligned content (may include ANSI codes).
+ * @param width - Total line width (default 70).
+ */
+export function headerBar(left, right, width = 70) {
+    const leftLen = visibleLength(left);
+    const rightLen = visibleLength(right);
+    const gap = Math.max(1, width - leftLen - rightLen);
+    return `${left}${' '.repeat(gap)}${right}`;
+}
+// ---------------------------------------------------------------------------
+// prompt
+// ---------------------------------------------------------------------------
+/**
+ * Renders a styled prompt line.
+ *
+ * @param text  - Prompt hint text (leading `>` is stripped if present).
+ * @param color - When false, no ANSI codes are emitted.
+ */
+export function prompt(text, color) {
+    const hint = text.replace(/^>\s*/, '');
+    const arrow = ansiCyan('>', color);
+    const body = ansiDim(hint, color);
+    return `${arrow} ${body}`;
+}
+// ---------------------------------------------------------------------------
+// signalLine
+// ---------------------------------------------------------------------------
+/**
+ * Renders a one-line signal/log entry with a type icon.
+ *
+ * @param type  - 'success' | 'warning' | 'info'
+ * @param text  - Main message text.
+ * @param color - When false, no ANSI codes are emitted.
+ * @param meta  - Optional dim metadata appended at the end.
+ */
+export function signalLine(type, text, color, meta) {
+    let icon;
+    switch (type) {
+        case 'success':
+            icon = ansiGreen('✓', color);
+            break; // ✓
+        case 'warning':
+            icon = ansiYellow('!', color);
+            break;
+        case 'info':
+            icon = ansiDim('·', color);
+            break; // ·
+    }
+    const metaStr = meta != null && meta.length > 0
+        ? '  ' + ansiDim(meta, color)
+        : '';
+    return `${icon}  ${text}${metaStr}`;
+}
+//# sourceMappingURL=tui.js.map

package/dist/ui/tui.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tui.js","sourceRoot":"","sources":["../../src/ui/tui.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "myshell-tools",
-  "version": "2.0.0-alpha.0",
+  "version": "2.1.0",
   "type": "module",
   "bin": {
     "myshell-tools": "dist/cli.js",
@@ -17,6 +17,8 @@
     "lint": "eslint src test",
     "format": "prettier --check .",
     "typecheck": "tsc --noEmit",
+    "knip": "knip",
+    "test:integration": "node --test \"test/integration/**/*.test.ts\"",
     "clean": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"",
     "prepublishOnly": "npm run clean && npm run build && npm run test"
   },
@@ -45,6 +47,7 @@
     "@types/node": "^20.0.0",
     "c8": "^10.0.0",
     "eslint": "^9.0.0",
+    "knip": "^6.14.2",
     "prettier": "^3.0.0",
     "typescript": "^5.0.0",
     "typescript-eslint": "^8.0.0"

package/dist/core/index.d.ts

@@ -1,13 +0,0 @@
-/**
- * src/core/index.ts — public surface of the pure orchestration core.
- */
-export { orchestrate } from './orchestrate.js';
-export { classify } from './classify.js';
-export { route } from './route.js';
-export { assess } from './assess.js';
-export { buildPrompt } from './prompt.js';
-export { DEFAULT_POLICY } from './policy.js';
-export { nextTierUp, pickReviewer } from './escalate.js';
-export { buildReviewPrompt, parseReviewVerdict } from './review.js';
-export type { ReviewVerdict } from './review.js';
-export type { Tier, Risk, Classification, RouteDecision, Assessment, Clock, SessionEntry, SessionWriter, LedgerEntry, LedgerWriter, Policy, OrchestrateDeps, CoreEvent, } from './types.js';

package/dist/core/index.js

@@ -1,12 +0,0 @@
-/**
- * src/core/index.ts — public surface of the pure orchestration core.
- */
-export { orchestrate } from './orchestrate.js';
-export { classify } from './classify.js';
-export { route } from './route.js';
-export { assess } from './assess.js';
-export { buildPrompt } from './prompt.js';
-export { DEFAULT_POLICY } from './policy.js';
-export { nextTierUp, pickReviewer } from './escalate.js';
-export { buildReviewPrompt, parseReviewVerdict } from './review.js';
-//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC"}

package/dist/infra/index.d.ts

@@ -1,9 +0,0 @@
-export { acquireLock, releaseLock, withLock, atomicWrite, atomicAppendJSONL } from './atomic.js';
-export type { LockOptions } from './atomic.js';
-export { getModelPricing, calculateCost, getCheapestForTier, isPricingStale, PRICING_TABLE, } from './pricing.js';
-export type { ModelPricing, PricingTable } from './pricing.js';
-export { systemClock } from './clock.js';
-export { getStateDir, getSessionsDir, getSessionFile, getLedgerFile } from './paths.js';
-export { createSessionWriter, readSession } from './session.js';
-export { createLedger, readLedger, summarizeLedger } from './ledger.js';
-export type { ModelSummary, LedgerSummary } from './ledger.js';

package/dist/infra/index.js

@@ -1,7 +0,0 @@
-export { acquireLock, releaseLock, withLock, atomicWrite, atomicAppendJSONL } from './atomic.js';
-export { getModelPricing, calculateCost, getCheapestForTier, isPricingStale, PRICING_TABLE, } from './pricing.js';
-export { systemClock } from './clock.js';
-export { getStateDir, getSessionsDir, getSessionFile, getLedgerFile } from './paths.js';
-export { createSessionWriter, readSession } from './session.js';
-export { createLedger, readLedger, summarizeLedger } from './ledger.js';
-//# sourceMappingURL=index.js.map

package/dist/infra/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/infra/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEjG,OAAO,EACL,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,cAAc,EACd,aAAa,GACd,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACxF,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC"}

package/dist/providers/index.d.ts

@@ -1,9 +0,0 @@
-export { classifyError, calculateBackoff, formatErrorMessage } from './errors.js';
-export type { CliError, ErrorCategory, BackoffOptions } from './errors.js';
-export { detectProvider, detectEnvironment, getInstallCommand } from './detect.js';
-export type { ProviderStatus, EnvironmentStatus } from './detect.js';
-export type { Provider, ProviderEvent, ProviderRequest, Usage, SandboxLevel, ProviderId, } from './port.js';
-export { createClaudeProvider, toClaudeModelArg } from './claude.js';
-export { parseClaudeLine } from './claude-parse.js';
-export { createCodexProvider, toSandboxArg } from './codex.js';
-export { createCodexParser } from './codex-parse.js';

package/dist/providers/index.js

@@ -1,7 +0,0 @@
-export { classifyError, calculateBackoff, formatErrorMessage } from './errors.js';
-export { detectProvider, detectEnvironment, getInstallCommand } from './detect.js';
-export { createClaudeProvider, toClaudeModelArg } from './claude.js';
-export { parseClaudeLine } from './claude-parse.js';
-export { createCodexProvider, toSandboxArg } from './codex.js';
-export { createCodexParser } from './codex-parse.js';
-//# sourceMappingURL=index.js.map

package/dist/providers/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAElF,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAUnF,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC"}