swarm-code 0.1.0

package/dist/ui/summary.js

@@ -0,0 +1,113 @@
+/**
+ * End-of-session summary — shows a clean recap of what happened.
+ */
+import { getLogLevel, isJsonMode, logJson, logSeparator } from "./log.js";
+import { bold, dim, green, red, symbols, yellow } from "./theme.js";
+/** Render the end-of-session summary. */
+export function renderSummary(summary) {
+    if (isJsonMode()) {
+        logJson({
+            success: summary.completed,
+            elapsed_s: summary.elapsed,
+            iterations: summary.iterations,
+            sub_queries: summary.subQueries,
+            threads: {
+                total: summary.threads.length,
+                completed: summary.threads.filter((t) => t.status === "completed").length,
+                failed: summary.threads.filter((t) => t.status === "failed").length,
+                cancelled: summary.threads.filter((t) => t.status === "cancelled").length,
+            },
+            budget: {
+                spent_usd: summary.budget.totalSpentUsd,
+                limit_usd: summary.budget.sessionLimitUsd,
+                actual_cost_threads: summary.budget.actualCostThreads,
+                estimated_cost_threads: summary.budget.estimatedCostThreads,
+            },
+            tokens: summary.budget.totalTokens
+                ? {
+                    input: summary.budget.totalTokens.input,
+                    output: summary.budget.totalTokens.output,
+                    total: summary.budget.totalTokens.input + summary.budget.totalTokens.output,
+                }
+                : undefined,
+            cache: summary.cacheStats
+                ? {
+                    hits: summary.cacheStats.hits,
+                    misses: summary.cacheStats.misses,
+                    saved_ms: summary.cacheStats.totalSavedMs,
+                }
+                : undefined,
+            episodes: summary.episodeCount,
+            answer: summary.answer,
+        });
+        return;
+    }
+    if (getLogLevel() === "quiet")
+        return;
+    process.stderr.write("\n");
+    logSeparator();
+    // Overall status
+    const status = summary.completed ? green("completed") : yellow("incomplete");
+    const elapsed = `${summary.elapsed.toFixed(1)}s`;
+    process.stderr.write(`  ${bold(status)} in ${bold(elapsed)}`);
+    process.stderr.write(`  ${dim(symbols.dot)} ${summary.iterations} iterations`);
+    process.stderr.write(`  ${dim(symbols.dot)} ${summary.subQueries} sub-queries\n`);
+    // Thread breakdown
+    if (summary.threads.length > 0) {
+        const completed = summary.threads.filter((t) => t.status === "completed").length;
+        const failed = summary.threads.filter((t) => t.status === "failed").length;
+        const cancelled = summary.threads.filter((t) => t.status === "cancelled").length;
+        const parts = [];
+        if (completed > 0)
+            parts.push(green(`${completed} completed`));
+        if (failed > 0)
+            parts.push(red(`${failed} failed`));
+        if (cancelled > 0)
+            parts.push(yellow(`${cancelled} cancelled`));
+        process.stderr.write(`  ${dim("Threads")}  ${parts.join(dim(`  ${symbols.dot}  `))}\n`);
+        // Budget with actual vs estimated breakdown
+        const spent = summary.budget.totalSpentUsd;
+        const limit = summary.budget.sessionLimitUsd;
+        const pct = limit > 0 ? ((spent / limit) * 100).toFixed(0) : "0";
+        const budgetColor = spent > limit * 0.8 ? yellow : dim;
+        const costSource = summary.budget.actualCostThreads > 0
+            ? dim(` (${summary.budget.actualCostThreads} actual, ${summary.budget.estimatedCostThreads} estimated)`)
+            : dim(" (estimated)");
+        process.stderr.write(`  ${dim("Budget")}   ${budgetColor(`$${spent.toFixed(4)} / $${limit.toFixed(2)} (${pct}%)`)}${costSource}\n`);
+        // Token usage (if any real usage data)
+        const tokens = summary.budget.totalTokens;
+        if (tokens && (tokens.input > 0 || tokens.output > 0)) {
+            const totalK = ((tokens.input + tokens.output) / 1000).toFixed(1);
+            process.stderr.write(`  ${dim("Tokens")}   ${dim(`${tokens.input.toLocaleString()} in + ${tokens.output.toLocaleString()} out (${totalK}K total)`)}\n`);
+        }
+        // Cache stats
+        if (summary.cacheStats && (summary.cacheStats.hits > 0 || summary.cacheStats.size > 0)) {
+            const c = summary.cacheStats;
+            const saved = c.totalSavedMs > 0 ? `, saved ${(c.totalSavedMs / 1000).toFixed(1)}s` : "";
+            process.stderr.write(`  ${dim("Cache")}    ${dim(`${c.hits} hits, ${c.misses} misses${saved}`)}\n`);
+        }
+        // Episodic memory
+        if (summary.episodeCount !== undefined && summary.episodeCount > 0) {
+            process.stderr.write(`  ${dim("Memory")}   ${dim(`${summary.episodeCount} episodes`)}\n`);
+        }
+        // Per-thread detail table (if verbose or few threads)
+        if (summary.threads.length <= 10 || getLogLevel() === "verbose") {
+            process.stderr.write("\n");
+            for (const t of summary.threads) {
+                const icon = t.status === "completed"
+                    ? green(symbols.check)
+                    : t.status === "failed"
+                        ? red(symbols.cross)
+                        : yellow(symbols.dash);
+                const id = dim(t.id.slice(0, 8));
+                const dur = t.completedAt && t.startedAt ? dim(`${((t.completedAt - t.startedAt) / 1000).toFixed(1)}s`) : dim("--");
+                const task = t.config.task.length > 50 ? `${t.config.task.slice(0, 49)}\u2026` : t.config.task;
+                const files = t.result?.filesChanged.length ?? 0;
+                const fileStr = files > 0 ? dim(`${files} files`) : "";
+                process.stderr.write(`    ${icon} ${id}  ${dur}  ${fileStr}  ${dim(task)}\n`);
+            }
+        }
+    }
+    logSeparator();
+}
+//# sourceMappingURL=summary.js.map

package/dist/ui/theme.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Centralized color/formatting system with TTY detection.
+ *
+ * All terminal styling flows through this module. When output is piped
+ * (not a TTY), colors are automatically stripped.
+ */
+declare const isTTY: boolean;
+declare const stdoutTTY: boolean;
+/** Brand coral — spinner, accents (inspired by Claude Code's coral orange). */
+export declare const coral: (text: string) => string;
+/** Primary accent — headers, borders. */
+export declare const cyan: (text: string) => string;
+/** Success — completed operations. */
+export declare const green: (text: string) => string;
+/** Warning — non-fatal issues. */
+export declare const yellow: (text: string) => string;
+/** Error — failures. */
+export declare const red: (text: string) => string;
+/** Secondary info — timestamps, ids, hints. */
+export declare const dim: (text: string) => string;
+/** Emphasis. */
+export declare const bold: (text: string) => string;
+/** Subtle emphasis. */
+export declare const italic: (text: string) => string;
+/** De-emphasized text. */
+export declare const gray: (text: string) => string;
+/** Magenta — sub-queries, memory. */
+export declare const magenta: (text: string) => string;
+/** White — primary content. */
+export declare const white: (text: string) => string;
+export declare const heading: (text: string) => string;
+export declare const success: (text: string) => string;
+export declare const warn: (text: string) => string;
+export declare const error: (text: string) => string;
+export declare const info: (text: string) => string;
+export declare const hint: (text: string) => string;
+export declare const symbols: {
+    readonly check: "✔" | "[OK]";
+    readonly cross: "✘" | "[ERR]";
+    readonly warn: "⚠" | "[WARN]";
+    readonly info: "●" | "[*]";
+    readonly arrow: "▶" | ">";
+    readonly dot: "." | "·";
+    readonly dash: "-" | "─";
+    readonly vertLine: "│" | "|";
+    readonly topLeft: "╭" | "+";
+    readonly topRight: "+" | "╮";
+    readonly bottomLeft: "+" | "╰";
+    readonly bottomRight: "+" | "╯";
+    readonly horizontal: "-" | "─";
+    readonly spinner: string[];
+};
+/** Get terminal width, with a sensible fallback. */
+export declare function termWidth(): number;
+/** Draw a horizontal rule. */
+export declare function hr(char?: string): string;
+/** Right-pad a string to a given width. */
+export declare function pad(text: string, width: number): string;
+/** Strip ANSI escape codes from a string. */
+export declare function stripAnsi(text: string): string;
+/** Truncate a string to maxLen, adding ellipsis if needed. */
+export declare function truncate(text: string, maxLen: number): string;
+export { isTTY, stdoutTTY };

package/dist/ui/theme.js

@@ -0,0 +1,97 @@
+/**
+ * Centralized color/formatting system with TTY detection.
+ *
+ * All terminal styling flows through this module. When output is piped
+ * (not a TTY), colors are automatically stripped.
+ */
+const isTTY = process.stderr.isTTY ?? false;
+const stdoutTTY = process.stdout.isTTY ?? false;
+// ── ANSI helpers ────────────────────────────────────────────────────────────
+function ansi(code) {
+    if (!isTTY)
+        return (text) => text;
+    return (text) => `\x1b[${code}m${text}\x1b[0m`;
+}
+function ansiFg(r, g, b) {
+    if (!isTTY)
+        return (text) => text;
+    return (text) => `\x1b[38;2;${r};${g};${b}m${text}\x1b[0m`;
+}
+// ── Theme colors ────────────────────────────────────────────────────────────
+/** Brand coral — spinner, accents (inspired by Claude Code's coral orange). */
+export const coral = ansiFg(215, 119, 87);
+/** Primary accent — headers, borders. */
+export const cyan = ansi("36");
+/** Success — completed operations. */
+export const green = ansi("32");
+/** Warning — non-fatal issues. */
+export const yellow = ansi("33");
+/** Error — failures. */
+export const red = ansi("31");
+/** Secondary info — timestamps, ids, hints. */
+export const dim = ansi("2");
+/** Emphasis. */
+export const bold = ansi("1");
+/** Subtle emphasis. */
+export const italic = ansi("3");
+/** De-emphasized text. */
+export const gray = ansiFg(128, 128, 128);
+/** Magenta — sub-queries, memory. */
+export const magenta = ansi("35");
+/** White — primary content. */
+export const white = ansi("37");
+// ── Compound styles ─────────────────────────────────────────────────────────
+export const heading = (text) => bold(cyan(text));
+export const success = (text) => green(`${symbols.check} ${text}`);
+export const warn = (text) => yellow(`${symbols.warn} ${text}`);
+export const error = (text) => red(`${symbols.cross} ${text}`);
+export const info = (text) => cyan(`${symbols.info} ${text}`);
+export const hint = (text) => dim(`  ${text}`);
+// ── Symbols ─────────────────────────────────────────────────────────────────
+export const symbols = {
+    check: isTTY ? "\u2714" : "[OK]",
+    cross: isTTY ? "\u2718" : "[ERR]",
+    warn: isTTY ? "\u26A0" : "[WARN]",
+    info: isTTY ? "\u25CF" : "[*]",
+    arrow: isTTY ? "\u25B6" : ">",
+    dot: isTTY ? "\u00B7" : ".",
+    dash: isTTY ? "\u2500" : "-",
+    vertLine: isTTY ? "\u2502" : "|",
+    topLeft: isTTY ? "\u256D" : "+",
+    topRight: isTTY ? "\u256E" : "+",
+    bottomLeft: isTTY ? "\u2570" : "+",
+    bottomRight: isTTY ? "\u256F" : "+",
+    horizontal: isTTY ? "\u2500" : "-",
+    spinner: isTTY ? ["\u00B7", "\u2726", "\u2733", "\u2736", "\u273B", "\u273D"] : ["*"],
+};
+// ── Layout helpers ──────────────────────────────────────────────────────────
+/** Get terminal width, with a sensible fallback. */
+export function termWidth() {
+    return process.stderr.columns || 80;
+}
+/** Draw a horizontal rule. */
+export function hr(char) {
+    const c = char || symbols.horizontal;
+    return dim(c.repeat(Math.min(termWidth(), 60)));
+}
+/** Right-pad a string to a given width. */
+export function pad(text, width) {
+    const stripped = stripAnsi(text);
+    if (stripped.length >= width)
+        return text;
+    return text + " ".repeat(width - stripped.length);
+}
+/** Strip ANSI escape codes from a string. */
+export function stripAnsi(text) {
+    // eslint-disable-next-line no-control-regex
+    return text.replace(/\x1b\[[0-9;]*m/g, "");
+}
+/** Truncate a string to maxLen, adding ellipsis if needed. */
+export function truncate(text, maxLen) {
+    if (text.length <= maxLen)
+        return text;
+    return `${text.slice(0, maxLen - 1)}\u2026`;
+}
+// ── Exports ─────────────────────────────────────────────────────────────────
+export { isTTY, stdoutTTY };
+//# sourceMappingURL=theme.js.map

package/dist/viewer.d.ts

@@ -0,0 +1,12 @@
+#!/usr/bin/env tsx
+/**
+ * RLM Trajectory Viewer — interactive TUI for browsing saved trajectory JSON files.
+ *
+ * Navigate through iterations with arrow keys, view code, REPL output,
+ * sub-queries, and the final answer in a beautifully formatted display.
+ *
+ * Usage:
+ *   rlm viewer                              # pick from list
+ *   rlm viewer trajectories/file.json       # open specific file
+ */
+export {};