@scira/cli 0.1.1 → 0.1.3

package/dist/ui/ink/lib/tool-result.js

@@ -8,7 +8,9 @@ export const DEFAULT_COLLAPSED_TOOLS = new Set([
     "readSkill",
     "bash",
     "runWorkspaceCommand",
+    "todo",
     "grepWorkspace",
+    "xSearch",
 ]);
 export function feedToolItemId(feedIndex, toolCallId) {
     return toolCallId ?? `feed-${feedIndex}`;
@@ -80,9 +82,15 @@ function searchHitToMarkdown(hit) {
 }
 function webSearchQueriesMarkdown(groups) {
     const queries = groups.map((g) => g.query?.trim()).filter((q) => Boolean(q));
-    if (queries.length === 0)
-        return "";
-    return `## Queries\n\n${queries.map((q, i) => `${i + 1}. ${q}`).join("\n")}`;
+    const errors = groups.map((g) => g.error?.trim()).filter((e) => Boolean(e));
+    const parts = [];
+    if (queries.length > 0) {
+        parts.push(`## Queries\n\n${queries.map((q, i) => `${i + 1}. ${q}`).join("\n")}`);
+    }
+    if (errors.length > 0) {
+        parts.push(`## Errors\n\n${errors.map((e, i) => `${i + 1}. ${e}`).join("\n")}`);
+    }
+    return parts.join("\n\n");
 }
 function webSearchSourcesMarkdown(hits) {
     if (hits.length === 0)
@@ -199,10 +207,57 @@ function formatGrep(result, width, theme) {
         return plainLines(row, width, { color: theme.textDim });
     });
 }
+function xPostToMarkdown(p) {
+    const label = p.handle ? `@${p.handle}` : p.url;
+    let line = `- [${label}](${p.url})`;
+    if (p.text) {
+        const snippet = p.text.replace(/\s+/gu, " ").trim();
+        if (snippet)
+            line += `\n  *${snippet}*`;
+    }
+    return line;
+}
+function xSearchPostsMarkdown(groups) {
+    const queries = groups.map((g) => g.query?.trim()).filter((q) => Boolean(q));
+    const errors = groups.map((g) => g.error?.trim()).filter((e) => Boolean(e));
+    const allPosts = groups.flatMap((g) => g.posts ?? []);
+    const dateRange = groups[0]?.dateRange;
+    const parts = [];
+    if (queries.length > 0) {
+        parts.push(`## Queries\n\n${queries.map((q, i) => `${i + 1}. ${q}`).join("\n")}`);
+    }
+    if (dateRange) {
+        parts.push(`*${dateRange}*`);
+    }
+    if (errors.length > 0) {
+        parts.push(`## Errors\n\n${errors.map((e, i) => `${i + 1}. ${e}`).join("\n")}`);
+    }
+    if (allPosts.length > 0) {
+        const postLines = allPosts.map(xPostToMarkdown).join("\n\n");
+        parts.push(`## Posts (${allPosts.length})\n\n${postLines}`);
+    }
+    return parts.join("\n\n");
+}
+function formatXSearch(result, width, theme) {
+    try {
+        const groups = JSON.parse(result);
+        if (!Array.isArray(groups))
+            return plainLines(result, width, { color: theme.textDim });
+        const md = xSearchPostsMarkdown(groups);
+        if (!md.trim())
+            return plainLines(result, width, { color: theme.textDim });
+        return markdownToSegLines(md, width, theme);
+    }
+    catch {
+        return plainLines(result, width, { color: theme.textDim });
+    }
+}
 function formatBody(name, result, width, theme) {
     switch (name) {
         case "webSearch":
             return formatWebSearch(result, width, theme);
+        case "xSearch":
+            return formatXSearch(result, width, theme);
         case "readUrl":
             return formatReadUrl(result, width, theme);
         case "listSkills":
@@ -262,6 +317,18 @@ export function formatToolResultPreview(name, inputSummary, result, status) {
         }
         catch { /* fall through */ }
     }
+    if (name === "xSearch") {
+        try {
+            const groups = JSON.parse(result);
+            if (Array.isArray(groups)) {
+                const queries = groups.map((g) => g.query?.trim()).filter(Boolean);
+                const total = groups.reduce((n, g) => n + (g.posts?.length ?? 0), 0);
+                const q = queries.length > 0 ? queries.slice(0, 2).join(" · ") + (queries.length > 2 ? ` +${queries.length - 2}` : "") : input;
+                return q ? `${q} · ${total} posts` : `${total} posts`;
+            }
+        }
+        catch { /* fall through */ }
+    }
     if (name === "readFile" || name === "readWorkspaceFile") {
         const lines = result.split("\n").length;
         return input ? `${input} · ${lines} lines` : `${lines} lines`;
@@ -280,12 +347,12 @@ export function formatToolResultLines(name, inputSummary, result, status, conten
     const width = Math.max(16, contentWidth);
     const lines = [];
     const input = inputSummary.replace(/\s+/gu, " ").trim();
-    const skipInput = name === "webSearch" && status === "done" && Boolean(result?.trim());
+    const skipInput = (name === "webSearch" || name === "xSearch") && status === "done" && Boolean(result?.trim());
     if (input && !skipInput) {
         if (name === "bash" || name === "runWorkspaceCommand") {
             lines.push([seg("$ ", { color: theme.accent }), seg(input, { color: theme.text })]);
         }
-        else if (name === "webSearch") {
+        else if (name === "webSearch" || name === "xSearch") {
             lines.push(...markdownToSegLines(webSearchRunningMarkdown(input), width, theme));
         }
         else if (name === "readUrl") {

package/dist/ui/ink/lib/utils.js

@@ -219,9 +219,15 @@ function toolOutputText(output) {
 }
 export function summarizeToolInput(name, input) {
     const obj = (input ?? {});
-    if (name === "bash" || name === "runWorkspaceCommand")
+    if (name === "bash" || name === "runBash" || name === "runWorkspaceCommand") {
+        const action = obj.action;
+        if (action && action !== "run")
+            return `${action}${obj.taskId ? ` ${obj.taskId}` : ""}`;
         return String(obj.command ?? "");
-    if (name === "webSearch") {
+    }
+    if (name === "todo")
+        return `${String(obj.action ?? "list")}${obj.id ? ` ${obj.id}` : ""}`;
+    if (name === "webSearch" || name === "xSearch") {
         const queries = Array.isArray(obj.queries) ? obj.queries : [];
         return queries.length > 0 ? queries.slice(0, 2).join(" · ") + (queries.length > 2 ? ` +${queries.length - 2}` : "") : String(obj.query ?? "");
     }
@@ -260,6 +266,25 @@ export function summarizeToolOutput(name, output) {
         }
         catch { /* fall through */ }
     }
+    if (name === "xSearch") {
+        try {
+            const parsed = JSON.parse(text);
+            if (Array.isArray(parsed)) {
+                const posts = parsed.flatMap((s) => s.posts ?? []);
+                const total = posts.length;
+                if (total === 0)
+                    return "no posts";
+                const handles = posts
+                    .map((p) => p.handle)
+                    .filter((h) => Boolean(h))
+                    .slice(0, 3)
+                    .map((h) => `@${h}`);
+                const head = `${total} post${total === 1 ? "" : "s"}`;
+                return handles.length > 0 ? `${head} · ${handles.join(", ")}` : head;
+            }
+        }
+        catch { /* fall through */ }
+    }
     if (name === "readUrl") {
         const titleMatch = text.match(/^#\s+(.+)/m);
         if (titleMatch?.[1])
@@ -284,12 +309,24 @@ export function summarizeToolOutput(name, output) {
     if (name === "writeFile" || name === "writeWorkspaceFile" || name === "editFile" || name === "editWorkspaceFile") {
         return oneLine(text, 120) || "ok";
     }
-    if (name === "bash" || name === "runWorkspaceCommand") {
+    if (name === "bash" || name === "runBash" || name === "runWorkspaceCommand") {
+        if (text.startsWith("Started background task"))
+            return oneLine(text, 120);
+        if (text.startsWith("No background tasks") || text.includes("[running]") || text.includes("[exited]")) {
+            return oneLine(text.split("\n")[0] ?? text, 120);
+        }
         const lines = text.split("\n").filter((l) => l.trim());
         if (lines.length === 0)
             return "done";
         return lines.slice(-3).map((l) => oneLine(l, 80)).join(" · ").slice(0, 200);
     }
+    if (name === "todo") {
+        const lines = text.split("\n").filter((l) => l.trim());
+        if (lines.length === 0)
+            return "no todos";
+        const active = lines.filter((l) => l.includes("[ ]") || l.includes("[~]")).length;
+        return `${lines.length} todo${lines.length === 1 ? "" : "s"}${active > 0 ? ` · ${active} open` : ""}`;
+    }
     if (name === "listWorkspaceDir") {
         const lines = text.split("\n").filter((l) => l.trim());
         const preview = lines.slice(0, 3).map((l) => oneLine(l, 40)).join(", ");

package/dist/ui/ink/theme-context.js

@@ -1,33 +1,36 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import React, { createContext, useContext, useMemo, useState } from "react";
-import { probeTerminalTheme } from "./terminal-probe.js";
-import { detectTerminalTheme, getTheme, getThemeFromResolved, watchAutoThemeChanges, } from "./theme.js";
-const ThemeCtx = createContext(getTheme("auto"));
-export function ThemeProvider({ config, stdin, stdout, children }) {
-    const [autoResolved, setAutoResolved] = useState(detectTerminalTheme);
-    const [probed, setProbed] = useState(undefined);
+import { detectTerminalTheme, getThemeFromResolved, resolveRenderingAppearance, watchAutoThemeChanges, } from "./theme.js";
+const initialTerminal = detectTerminalTheme();
+const ThemeCtx = createContext({
+    colors: getThemeFromResolved(initialTerminal),
+    terminalAppearance: initialTerminal,
+    renderingAppearance: initialTerminal,
+});
+export function ThemeProvider({ config, children }) {
+    const [terminalAppearance, setTerminalAppearance] = useState(detectTerminalTheme);
     React.useEffect(() => {
-        if (config.theme !== "auto") {
-            setProbed(undefined);
-            return;
-        }
-        const sync = () => {
-            void (async () => {
-                const live = stdin && stdout ? await probeTerminalTheme(stdin, stdout) : undefined;
-                setProbed((prev) => (prev === live ? prev : live));
-                const next = live ?? detectTerminalTheme();
-                setAutoResolved((prev) => (prev === next ? prev : next));
-            })();
+        return watchAutoThemeChanges(() => {
+            const next = detectTerminalTheme();
+            setTerminalAppearance((prev) => (prev === next ? prev : next));
+        });
+    }, []);
+    const value = useMemo(() => {
+        const renderingAppearance = resolveRenderingAppearance(config.theme, terminalAppearance);
+        return {
+            colors: getThemeFromResolved(renderingAppearance),
+            terminalAppearance,
+            renderingAppearance,
         };
-        return watchAutoThemeChanges(sync);
-    }, [config.theme, stdin, stdout]);
-    const colors = useMemo(() => {
-        if (config.theme !== "auto")
-            return getTheme(config.theme);
-        return getThemeFromResolved(probed ?? autoResolved);
-    }, [config.theme, autoResolved, probed]);
-    return _jsx(ThemeCtx.Provider, { value: colors, children: children });
+    }, [config.theme, terminalAppearance]);
+    return _jsx(ThemeCtx.Provider, { value: value, children: children });
 }
 export function useTheme() {
-    return useContext(ThemeCtx);
+    return useContext(ThemeCtx).colors;
+}
+export function useTerminalAppearance() {
+    return useContext(ThemeCtx).terminalAppearance;
+}
+export function useRenderingAppearance() {
+    return useContext(ThemeCtx).renderingAppearance;
 }

package/dist/ui/ink/theme.js

@@ -7,10 +7,10 @@ export const DARK_THEME = {
     accentDim: "#CFB59D",
     background: "",
     border: "#FFE0C2",
-    text: "white",
+    text: "ansi256(15)",
     textDim: "ansi256(245)",
-    textInverse: "black",
-    inputText: "#ffffff",
+    textInverse: "ansi256(0)",
+    inputText: "ansi256(15)",
     cursorBackground: "#FFE0C2",
     cursorForeground: "#000000",
     success: "green",
@@ -24,10 +24,10 @@ export const LIGHT_THEME = {
     accentDim: "#CFB59D",
     background: "",
     border: "#FFE0C2",
-    text: "black",
-    textDim: "gray",
-    textInverse: "white",
-    inputText: "#000000",
+    text: "ansi256(0)",
+    textDim: "ansi256(242)",
+    textInverse: "ansi256(15)",
+    inputText: "ansi256(0)",
     cursorBackground: "#CFB59D",
     cursorForeground: "#000000",
     success: "green",
@@ -62,7 +62,7 @@ function readColorFgbg() {
     return undefined;
 }
 function readTerminalProfile() {
-    const profile = process.env.TERM_PROFILE || process.env.ITERM_PROFILE || "";
+    const profile = process.env.TERM_PROFILE || process.env.ITERM_PROFILE || process.env.WARP_BOOTSTRAPPED || "";
     if (!profile)
         return undefined;
     if (/light|day|solar/i.test(profile))
@@ -71,6 +71,17 @@ function readTerminalProfile() {
         return "dark";
     return undefined;
 }
+/** Common standalone terminals that default to dark profiles when unset. */
+function readTermProgram() {
+    const program = (process.env.TERM_PROGRAM ?? "").toLowerCase();
+    if (!program)
+        return undefined;
+    if (/warp|ghostty|alacritty|kitty|hyper|wezterm|tabby/.test(program))
+        return "dark";
+    if (program === "apple_terminal")
+        return "dark";
+    return undefined;
+}
 function editorSettingsPaths() {
     const home = homedir();
     if (process.platform === "darwin") {
@@ -146,9 +157,25 @@ function readSystemAppearance() {
 export function detectTerminalTheme() {
     return readColorFgbg()
         ?? readTerminalProfile()
+        ?? readTermProgram()
         ?? readEditorColorTheme()
         ?? readSystemAppearance()
-        ?? "light";
+        ?? "dark";
+}
+/** Input foreground matched to terminal appearance. */
+export function inputForegroundForAppearance(appearance) {
+    return appearance === "dark" ? "ansi256(15)" : "ansi256(0)";
+}
+/**
+ * Pick colors for rendering. When a locked theme disagrees with the terminal
+ * background, follow the terminal so text stays readable.
+ */
+export function resolveRenderingAppearance(configTheme, terminalAppearance) {
+    if (configTheme === "auto")
+        return terminalAppearance;
+    if (configTheme !== terminalAppearance)
+        return terminalAppearance;
+    return configTheme;
 }
 export function getThemeFromResolved(resolved) {
     return resolved === "light" ? LIGHT_THEME : DARK_THEME;

package/dist/ui/ink/theme.test.js

@@ -1,5 +1,5 @@
 import { afterEach, describe, expect, it, vi } from "vitest";
-import { detectTerminalTheme, getTheme, watchAutoThemeChanges } from "./theme.js";
+import { detectTerminalTheme, getTheme, inputForegroundForAppearance, resolveRenderingAppearance, watchAutoThemeChanges, } from "./theme.js";
 const env = process.env;
 afterEach(() => {
     process.env = { ...env };
@@ -18,14 +18,41 @@ describe("detectTerminalTheme", () => {
     });
     it("resolves auto theme colors from detected appearance", () => {
         process.env.COLORFGBG = "0;15";
-        expect(getTheme("auto").text).toBe("black");
-        expect(getTheme("auto").inputText).toBe("#000000");
+        expect(getTheme("auto").text).toBe("ansi256(0)");
+        expect(getTheme("auto").inputText).toBe("ansi256(0)");
         expect(getTheme("auto").userBandBackground).toBe("#f0f0f0");
         process.env.COLORFGBG = "15;0";
-        expect(getTheme("auto").text).toBe("white");
-        expect(getTheme("auto").inputText).toBe("#ffffff");
+        expect(getTheme("auto").text).toBe("ansi256(15)");
+        expect(getTheme("auto").inputText).toBe("ansi256(15)");
         expect(getTheme("auto").userBandBackground).toBe("ansi256(238)");
     });
+    it("detects Warp and Apple Terminal as dark when unset", () => {
+        delete process.env.COLORFGBG;
+        delete process.env.TERM_PROFILE;
+        delete process.env.ITERM_PROFILE;
+        process.env.TERM_PROGRAM = "WarpTerminal";
+        expect(detectTerminalTheme()).toBe("dark");
+        process.env.TERM_PROGRAM = "Apple_Terminal";
+        expect(detectTerminalTheme()).toBe("dark");
+    });
+    it("defaults to dark when no signals are present", () => {
+        delete process.env.COLORFGBG;
+        delete process.env.TERM_PROFILE;
+        delete process.env.ITERM_PROFILE;
+        delete process.env.TERM_PROGRAM;
+        delete process.env.TERM_PROGRAM;
+        expect(detectTerminalTheme()).toBe("dark");
+    });
+    it("maps terminal appearance to ansi256 input foreground", () => {
+        expect(inputForegroundForAppearance("dark")).toBe("ansi256(15)");
+        expect(inputForegroundForAppearance("light")).toBe("ansi256(0)");
+    });
+    it("overrides a mismatched locked theme to match the terminal", () => {
+        expect(resolveRenderingAppearance("light", "dark")).toBe("dark");
+        expect(resolveRenderingAppearance("dark", "light")).toBe("light");
+        expect(resolveRenderingAppearance("dark", "dark")).toBe("dark");
+        expect(resolveRenderingAppearance("auto", "dark")).toBe("dark");
+    });
     it("watchAutoThemeChanges fires immediately and on interval", () => {
         vi.useFakeTimers();
         const onChange = vi.fn();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@scira/cli",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Scira — terminal-native AI research agent with grounded sources, verified claims, and local run storage.",
   "license": "MIT",
   "type": "module",
@@ -32,7 +32,9 @@
     "build": "tsc -p tsconfig.json",
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "prepublishOnly": "bun run build",
-    "dev": "tsx src/cli/index.ts",
+    "dev": "bun src/cli/index.ts",
+    "docs:dev": "bun run --cwd docs dev",
+    "docs:build": "NODE_ENV=production bun run --cwd docs build",
     "test": "vitest run",
     "test:watch": "vitest"
   },
@@ -45,20 +47,21 @@
     "@modelcontextprotocol/sdk": "^1.29.0",
     "@mozilla/readability": "^0.6.0",
     "ai": "^6.0.202",
-    "commander": "^15.0.0",
     "diff": "^9.0.0",
     "exa-js": "^2.13.0",
     "files-sdk": "^1.8.0",
     "ink": "^7.0.5",
     "jsdom": "^29.1.1",
-    "ora": "^9.4.0",
     "parallel-web": "^1.1.0",
+    "picospinner": "^3.0.0",
     "react": "^19.2.7",
-    "string-width": "8.2.1",
+    "react-tweet": "^3.3.1",
+    "sade": "^1.8.1",
     "workers-ai-provider": "^3.1.14",
     "zod": "^4.4.3"
   },
   "devDependencies": {
+    "bun-types": "^1.3.14",
     "@types/jsdom": "^28.0.3",
     "@types/node": "^25.9.3",
     "@types/react": "^19.2.17",
@@ -68,6 +71,6 @@
     "vitest": "^4.1.8"
   },
   "engines": {
-    "node": ">=20"
+    "bun": ">=1.2.0"
   }
 }