@scira/cli 0.1.2 → 0.1.4

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

@@ -142,11 +142,73 @@ export function relativeTime(ms) {
         return `${weeks}w ago`;
     return new Date(ms).toLocaleDateString();
 }
-/** Wrap text in an OSC 8 terminal hyperlink (clickable in supported terminals). */
+function colorToAnsi(color) {
+    if (!color)
+        return [];
+    const hex = /^#([0-9a-f]{6})$/i.exec(color);
+    if (hex) {
+        const n = hex[1];
+        return [38, 2, parseInt(n.slice(0, 2), 16), parseInt(n.slice(2, 4), 16), parseInt(n.slice(4, 6), 16)];
+    }
+    const ansi256 = /^ansi256\((\d+)\)$/i.exec(color);
+    if (ansi256)
+        return [38, 5, parseInt(ansi256[1], 10)];
+    const named = {
+        red: 31, green: 32, yellow: 33, blue: 34, magenta: 35, cyan: 36,
+        gray: 90, white: 97, black: 30,
+    };
+    const code = named[color.toLowerCase()];
+    return code ? [code] : [];
+}
+/** OSC 8 link with inline ANSI styling — avoids Ink Text props breaking the escape sequence. */
+export function ansiHyperlink(text, url, style) {
+    const params = [];
+    if (style?.bold)
+        params.push(1);
+    if (style?.dim)
+        params.push(2);
+    if (style?.italic)
+        params.push(3);
+    if (style?.underline !== false)
+        params.push(4);
+    params.push(...colorToAnsi(style?.color));
+    const styled = params.length > 0 ? `\x1b[${params.join(";")}m${text}\x1b[0m` : text;
+    return `\x1b]8;;${url}\x1b\\${styled}\x1b]8;;\x1b\\`;
+}
 export function hyperlink(text, url) {
     if (!url)
         return text;
-    return `\x1b]8;;${url}\x1b\\${text}\x1b]8;;\x1b\\`;
+    return ansiHyperlink(text, url, { underline: true });
+}
+export function computeLineLinks(segs, prefixCols = 0) {
+    const links = [];
+    let col = prefixCols;
+    for (const s of segs) {
+        const w = displayWidth(s.text);
+        if (s.url && w > 0)
+            links.push({ start: col, end: col + w - 1, url: s.url });
+        col += w;
+    }
+    return links;
+}
+/** Match an SGR mouse column (1-based) against link regions from computeLineLinks. */
+export function linkAtMouseColumn(links, x) {
+    for (const l of links) {
+        if (x >= l.start + 1 && x <= l.end + 1)
+            return l.url;
+    }
+    return undefined;
+}
+/** Open a URL in the system browser. */
+export function openExternalUrl(url) {
+    return new Promise((res) => {
+        const cmd = process.platform === "darwin" ? "open" : process.platform === "win32" ? "cmd" : "xdg-open";
+        const args = process.platform === "win32" ? ["/c", "start", "", url] : [url];
+        const child = spawn(cmd, args, { stdio: "ignore", detached: true });
+        child.on("error", () => res(false));
+        child.on("close", (code) => res(code === 0));
+        child.unref();
+    });
 }
 /** True if the prompt clearly asks for full, report-grade research. */
 export function wantsFullResearch(prompt) {
@@ -219,9 +281,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 +328,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 +371,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/lib/utils.test.js

@@ -1,5 +1,22 @@
 import { describe, expect, it } from "vitest";
-import { summarizeToolInput, summarizeToolOutput } from "./utils.js";
+import { summarizeToolInput, summarizeToolOutput, ansiHyperlink, computeLineLinks, linkAtMouseColumn } from "./utils.js";
+describe("hyperlink helpers", () => {
+    it("wraps OSC 8 around styled link text", () => {
+        const out = ansiHyperlink("docs", "https://example.com", { color: "#FFE0C2", underline: true });
+        expect(out).toContain("\x1b]8;;https://example.com\x1b\\");
+        expect(out).toContain("docs");
+        expect(out).toContain("\x1b]8;;\x1b\\");
+    });
+    it("maps mouse column to link url", () => {
+        const links = computeLineLinks([
+            { text: "see " },
+            { text: "docs", url: "https://example.com" },
+        ], 2);
+        expect(links).toEqual([{ start: 6, end: 9, url: "https://example.com" }]);
+        expect(linkAtMouseColumn(links, 7)).toBe("https://example.com");
+        expect(linkAtMouseColumn(links, 3)).toBeUndefined();
+    });
+});
 describe("summarizeToolInput", () => {
     it("formats webSearch queries", () => {
         expect(summarizeToolInput("webSearch", { queries: ["a", "b", "c"] })).toBe("a · b +1");

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.2",
+  "version": "0.1.4",
   "description": "Scira — terminal-native AI research agent with grounded sources, verified claims, and local run storage.",
   "license": "MIT",
   "type": "module",
@@ -33,6 +33,8 @@
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "prepublishOnly": "bun run build",
     "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"
   },
@@ -49,16 +51,18 @@
     "exa-js": "^2.13.0",
     "files-sdk": "^1.8.0",
     "ink": "^7.0.5",
+    "ink-link": "^5.0.0",
     "jsdom": "^29.1.1",
     "parallel-web": "^1.1.0",
     "picospinner": "^3.0.0",
     "react": "^19.2.7",
+    "react-tweet": "^3.3.1",
     "sade": "^1.8.1",
     "workers-ai-provider": "^3.1.14",
     "zod": "^4.4.3"
   },
   "devDependencies": {
-    "bun-types": "^1.2.23",
+    "bun-types": "^1.3.14",
     "@types/jsdom": "^28.0.3",
     "@types/node": "^25.9.3",
     "@types/react": "^19.2.17",