@loompad/cli 0.1.0

package/dist/core/search.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Searching a project: its code, and its conversations.
+ *
+ * The rail could find a file by name and nothing else, which is the least
+ * useful half of search — you almost always remember a line, not a filename.
+ * And the thread, which is where the actual reasoning of a project lives, was
+ * not searchable at all.
+ *
+ * ## Code: git grep, then a walk
+ *
+ * `git grep` is the right tool in a repo and it isn't close: it's fast, it
+ * already ignores .gitignore, and it never descends into node_modules. Outside
+ * a repo there's no index to lean on, so the fallback walks — with hard caps,
+ * because a search box that hangs the daemon on a home directory is worse than
+ * one that says "too many results".
+ *
+ * ## Chats: the event log
+ *
+ * Messages are events, so searching chats is scanning the log. No index: a
+ * project's log is thousands of rows, not millions, and a substring scan over
+ * that is microseconds. When that stops being true, this is the function to
+ * change, and it will be obvious.
+ */
+import type { EventStore } from "./eventlog.js";
+export interface CodeHit {
+    path: string;
+    line: number;
+    text: string;
+}
+export interface ChatHit {
+    chat: string;
+    eventId: number;
+    at: number;
+    kind: string;
+    agentId: string | null;
+    /** The matching text, trimmed around the hit. */
+    snippet: string;
+}
+/**
+ * Search file contents.
+ *
+ * Case-insensitive and fixed-string, not regex: the box is a search box, and
+ * someone typing `foo(bar)` means those characters. A regex there would turn a
+ * paren into a syntax error and blame them for it.
+ */
+export declare function searchCode(dir: string, query: string): Promise<{
+    hits: CodeHit[];
+    truncated: boolean;
+}>;
+/**
+ * Search the conversations.
+ *
+ * Every kind of event with text in it, not just your messages: an agent's
+ * reply, the tool it ran, the error it hit. What you remember about a project
+ * is rarely the sentence you typed — it's the answer you got.
+ */
+export declare function searchChats(log: Pick<EventStore, "list">, query: string, opts?: {
+    chat?: string;
+    limit?: number;
+}): {
+    hits: ChatHit[];
+    truncated: boolean;
+};

package/dist/core/search.js.map

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

package/dist/core/setup.d.ts

@@ -0,0 +1,70 @@
+/**
+ * What a new machine still needs — one answer, for the CLI and the app both.
+ *
+ * `loom doctor` and the onboarding screen ask the same question, so they share
+ * a source. The alternative is what this codebase already learned the hard way
+ * with agent kinds: two lists that agree until they don't, and a UI confidently
+ * telling you something the code stopped believing months ago.
+ *
+ * Everything here is per-platform because the answers genuinely differ — a
+ * Windows firewall prompt and a macOS notification permission are not the same
+ * item worded differently.
+ */
+export type Platform = "darwin" | "win32" | "linux";
+export declare function platform(): Platform;
+export interface AgentStatus {
+    kind: string;
+    label: string;
+    found: boolean;
+    /** How to get it, when it's missing. */
+    install: string;
+    /**
+     * Is it actually signed in?
+     *
+     * `null` when we couldn't tell in the time we were willing to wait — an
+     * honest "don't know", not a cheerful yes.
+     */
+    authed: boolean | null;
+    /** What the tool said, when it said no. */
+    authDetail?: string;
+    /** The command that fixes it. */
+    auth: string;
+}
+export interface BridgeStatus {
+    kind: string;
+    label: string;
+    port: number;
+    /** Something is answering the debugger. */
+    reachable: boolean;
+    /** ...and it has a chat we could actually type into. */
+    driveable: boolean;
+    /** Why not, in words worth showing a person. */
+    reason?: string;
+    /** How to start it with a debugger, on this OS. */
+    launch: string;
+}
+export interface PermissionItem {
+    title: string;
+    why: string;
+    how: string;
+    /** True when Loom deliberately does NOT want this, despite expectations. */
+    refused?: boolean;
+}
+export interface SetupReport {
+    platform: Platform;
+    node: {
+        version: string;
+        ok: boolean;
+        needed: string;
+    };
+    agents: AgentStatus[];
+    bridges: BridgeStatus[];
+    permissions: PermissionItem[];
+    /** Nothing to drive: the one state that makes Loom useless. */
+    ready: boolean;
+}
+/** Is this Node new enough for the event log to be real? */
+export declare function nodeOk(version?: string): boolean;
+export declare function setupReport(): Promise<SetupReport>;
+/** For the "and this is your machine" line in onboarding. */
+export declare function machineName(): string;

package/dist/core/setup.js

@@ -0,0 +1,250 @@
+/**
+ * What a new machine still needs — one answer, for the CLI and the app both.
+ *
+ * `loom doctor` and the onboarding screen ask the same question, so they share
+ * a source. The alternative is what this codebase already learned the hard way
+ * with agent kinds: two lists that agree until they don't, and a UI confidently
+ * telling you something the code stopped believing months ago.
+ *
+ * Everything here is per-platform because the answers genuinely differ — a
+ * Windows firewall prompt and a macOS notification permission are not the same
+ * item worded differently.
+ */
+import { execFile } from "node:child_process";
+import os from "node:os";
+import { GuiChatDriver } from "../adapters/bridges/gui-chat.js";
+import { codexBin } from "../adapters/codex.js";
+import { profileFor } from "../adapters/bridges/profiles.js";
+import { ADES, detectAdes } from "./ades.js";
+export function platform() {
+    return process.platform === "darwin" ? "darwin" : process.platform === "win32" ? "win32" : "linux";
+}
+const INSTALL = {
+    "claude-code": "npm i -g @anthropic-ai/claude-code",
+    codex: "install Codex.app, or npm i -g @openai/codex",
+    opencode: "curl -fsSL https://opencode.ai/install | bash",
+    "grok-code": "install the grok CLI from docs.x.ai",
+};
+const AUTH = {
+    "claude-code": "run `claude`, then /login",
+    codex: "codex login",
+    opencode: "opencode auth login",
+    "grok-code": "run `grok` once and sign in",
+};
+/**
+ * Ask each tool whether it's actually signed in.
+ *
+ * I claimed this was impossible earlier in the day — that installed and
+ * authenticated look identical from out here — and then watched a whole
+ * afternoon go into "claude is installed" while `claude` answered "Not logged
+ * in · Please run /login" to anyone who asked. It isn't impossible. It just
+ * needs asking the right question.
+ *
+ * Every probe here is free and offline-ish:
+ *   codex     — `login status` reports without touching a model
+ *   opencode  — `auth list` reads its own credentials file
+ *   claude    — a `-p` probe; when signed out it refuses in ~30ms having called
+ *               nothing. When signed IN it would cost a token or two, so it is
+ *               capped hard and a slow answer counts as "signed in": only the
+ *               instant refusal is diagnostic.
+ *   grok      — has no status command; unknown rather than guessed.
+ */
+async function probeAuth(kind) {
+    const run = (cmd, args, ms) => new Promise((resolve) => {
+        let done = false;
+        const child = execFile(cmd, args, { timeout: ms }, (_err, stdout, stderr) => {
+            if (done)
+                return;
+            done = true;
+            resolve({ code: 0, out: `${stdout}${stderr}` });
+        });
+        child.stdin?.end();
+        child.on("error", () => {
+            if (!done) {
+                done = true;
+                resolve({ code: null, out: "" });
+            }
+        });
+        setTimeout(() => {
+            if (!done) {
+                done = true;
+                try {
+                    child.kill("SIGKILL");
+                }
+                catch {
+                    /* gone */
+                }
+                resolve({ code: null, out: "" });
+            }
+        }, ms + 200).unref?.();
+    });
+    try {
+        if (kind === "codex") {
+            const bin = codexBin();
+            if (!bin)
+                return { authed: null };
+            const { out } = await run(bin, ["login", "status"], 6000);
+            if (/logged in/i.test(out))
+                return { authed: true };
+            if (/not logged in|no auth/i.test(out))
+                return { authed: false, detail: out.trim().slice(0, 60) };
+            return { authed: null };
+        }
+        if (kind === "opencode") {
+            const { out } = await run("opencode", ["auth", "list"], 8000);
+            // its list marks each stored credential with a bullet
+            return /●/.test(out) ? { authed: true } : { authed: null };
+        }
+        if (kind === "claude-code") {
+            // Signed out, this refuses instantly and for free. Signed in, it would
+            // start a real turn — so the timeout is the budget, and hitting it is a
+            // yes, not a maybe.
+            const { out } = await run("claude", ["-p", "hi", "--output-format", "json"], 6000);
+            if (/not logged in|please run \/login|invalid api key/i.test(out)) {
+                return { authed: false, detail: "the CLI says: Not logged in" };
+            }
+            return { authed: true };
+        }
+    }
+    catch {
+        /* fall through to unknown */
+    }
+    return { authed: null };
+}
+/**
+ * The permissions Loom actually needs, and the ones it pointedly doesn't.
+ *
+ * The refusals are listed on purpose. People expect a tool that drives other
+ * apps to demand Accessibility, and something that asks for it while claiming
+ * to be Loom is worth being suspicious of. Loom talks to a debugging port; it
+ * never pretends to be a mouse, so it never needs control of your machine.
+ */
+function permissionsFor(p) {
+    const shared = [
+        {
+            title: "Accessibility / Screen Recording / Automation",
+            why: "Loom drives GUI agents through their debug port, not by faking clicks",
+            how: "Not needed — don't grant it. If something asks for this in Loom's name, it isn't Loom.",
+            refused: true,
+        },
+    ];
+    if (p === "darwin") {
+        return [
+            {
+                title: "Notifications",
+                why: "so you hear when an agent needs you and you're in another window",
+                how: "Allowed on first ask · System Settings → Notifications → Loom",
+            },
+            {
+                title: "Opening an unsigned app",
+                why: "Loom.app isn't notarized yet, so Gatekeeper blocks a double-click",
+                how: "Right-click the app → Open, once. Double-clicking gives a dead end.",
+            },
+            {
+                title: "Local Network",
+                why: "your phone reaching the daemon over the LAN",
+                how: "Prompted on first connection · System Settings → Privacy & Security → Local Network",
+            },
+            {
+                title: "Run at login",
+                why: "the daemon survives closing the window, but not a reboot",
+                how: "System Settings → General → Login Items → + → Loom",
+            },
+            ...shared,
+        ];
+    }
+    if (p === "win32") {
+        return [
+            {
+                title: "Firewall — private networks",
+                why: "your phone reaching the daemon; without it the tailnet can't connect",
+                how: "Windows Defender prompts on first `loom up` — tick Private, leave Public off",
+            },
+            {
+                title: "SmartScreen",
+                why: "the installer isn't signed yet",
+                how: "More info → Run anyway",
+            },
+            {
+                title: "Notifications",
+                why: "so you hear when an agent needs you",
+                how: "Settings → System → Notifications → Loom",
+            },
+            {
+                title: "Run at login",
+                why: "the daemon survives closing the window, but not a reboot",
+                how: "Win+R → shell:startup → put a shortcut to Loom in there",
+            },
+            ...shared,
+        ];
+    }
+    return [
+        {
+            title: "Notifications",
+            why: "so you hear when an agent needs you",
+            how: "your desktop's notification settings — Loom uses libnotify",
+        },
+        {
+            title: "Run at login",
+            why: "the daemon survives closing the window, but not a reboot",
+            how: "a user systemd unit running `loom up`",
+        },
+        ...shared,
+    ];
+}
+/** Is this Node new enough for the event log to be real? */
+export function nodeOk(version = process.versions.node) {
+    const [major, minor] = version.split(".").map(Number);
+    return (major ?? 0) > 22 || ((major ?? 0) === 22 && (minor ?? 0) >= 5);
+}
+export async function setupReport() {
+    const p = platform();
+    const available = await detectAdes();
+    const agents = await Promise.all(ADES.filter((a) => a.tier === "adapter").map(async (a) => {
+        const found = Boolean(available[a.kind]);
+        const auth = found ? await probeAuth(a.kind) : { authed: null };
+        return {
+            kind: a.kind,
+            label: a.label,
+            found,
+            install: INSTALL[a.kind] ?? "",
+            authed: auth.authed,
+            ...(auth.detail ? { authDetail: auth.detail } : {}),
+            auth: AUTH[a.kind] ?? "",
+        };
+    }));
+    // Bridges are probed live: "installed" says nothing useful about an app whose
+    // debugger has to be asked for at launch.
+    const bridges = await Promise.all(ADES.filter((a) => a.tier === "bridge").map(async (a) => {
+        const profile = profileFor(a.kind);
+        const driver = new GuiChatDriver(profile.name, {}, a.kind);
+        const reachable = await driver.reachable().catch(() => false);
+        const drive = reachable ? await driver.driveable() : { ok: false, reason: undefined };
+        return {
+            kind: a.kind,
+            label: profile.name,
+            port: profile.defaultPort,
+            reachable,
+            driveable: drive.ok,
+            ...(drive.ok ? {} : { reason: drive.reason ?? "not running" }),
+            launch: profile.launch[p],
+        };
+    }));
+    return {
+        platform: p,
+        node: { version: process.versions.node, ok: nodeOk(), needed: "22.5" },
+        agents,
+        bridges,
+        permissions: permissionsFor(p),
+        // Ready means a turn can actually happen. An installed-but-signed-out
+        // roster is not ready, and saying it is was the exact shape of today's
+        // wasted afternoon. Unknown counts as ready — don't cry wolf over a probe
+        // that timed out.
+        ready: agents.some((a) => a.found && a.authed !== false),
+    };
+}
+/** For the "and this is your machine" line in onboarding. */
+export function machineName() {
+    return os.hostname().replace(/\.local$/, "");
+}
+//# sourceMappingURL=setup.js.map

package/dist/core/setup.js.map

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

package/dist/core/suggestions.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Suggested handoffs — routing stays manual (the user confirms every baton
+ * pass), but Loom watches the stream for natural boundaries and *offers*
+ * the next hop. This is the stepping stone toward auto-routing.
+ */
+import type { LoomEvent, ProjectConfig } from "../types.js";
+export interface Suggestion {
+    to: string;
+    reason: string;
+}
+/**
+ * Inspect a freshly appended event; return a handoff suggestion or null.
+ * Only message events from the current baton holder are considered.
+ */
+export declare function suggestHandoff(event: LoomEvent, cfg: ProjectConfig, holder: string | null): Suggestion | null;

package/dist/core/suggestions.js

@@ -0,0 +1,38 @@
+/**
+ * Suggested handoffs — routing stays manual (the user confirms every baton
+ * pass), but Loom watches the stream for natural boundaries and *offers*
+ * the next hop. This is the stepping stone toward auto-routing.
+ */
+const PLAN_DONE = /\b(plan(?:ning)?\s+(?:is\s+)?(?:complete|ready|done|final(?:ized)?)|ready\s+(?:for|to)\s+(?:implement|execution|execute|build)|implementation\s+plan\b.*\b(?:below|follows|ready))/i;
+const EXEC_DONE = /\b(implementation\s+(?:is\s+)?(?:complete|done|finished)|all\s+tests?\s+pass(?:ing)?|ready\s+for\s+review)\b/i;
+function firstWithRole(cfg, role, excludeId) {
+    return cfg.agents.find((a) => a.role === role && a.id !== excludeId);
+}
+/**
+ * Inspect a freshly appended event; return a handoff suggestion or null.
+ * Only message events from the current baton holder are considered.
+ */
+export function suggestHandoff(event, cfg, holder) {
+    if (event.kind !== "message" || !event.agentId)
+        return null;
+    if (holder && event.agentId !== holder)
+        return null;
+    const speaker = cfg.agents.find((a) => a.id === event.agentId);
+    if (!speaker)
+        return null;
+    const text = String(event.payload.text ?? "");
+    if (speaker.role === "planner" && PLAN_DONE.test(text)) {
+        const executor = firstWithRole(cfg, "executor", speaker.id);
+        if (executor) {
+            return { to: executor.id, reason: "plan looks complete — hand to the executor?" };
+        }
+    }
+    if (speaker.role === "executor" && EXEC_DONE.test(text)) {
+        const reviewer = firstWithRole(cfg, "reviewer", speaker.id) ?? firstWithRole(cfg, "planner", speaker.id);
+        if (reviewer) {
+            return { to: reviewer.id, reason: "execution looks done — hand back for review?" };
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=suggestions.js.map

package/dist/core/suggestions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggestions.js","sourceRoot":"","sources":["../../src/core/suggestions.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,SAAS,GACb,qLAAqL,CAAC;AACxL,MAAM,SAAS,GACb,+GAA+G,CAAC;AAElH,SAAS,aAAa,CAAC,GAAkB,EAAE,IAAe,EAAE,SAAkB;IAC5E,OAAO,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC;AACvE,CAAC;AAOD;;;GAGG;AACH,MAAM,UAAU,cAAc,CAC5B,KAAgB,EAChB,GAAkB,EAClB,MAAqB;IAErB,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC5D,IAAI,MAAM,IAAI,KAAK,CAAC,OAAO,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IAEpD,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,KAAK,CAAC,OAAO,CAAC,CAAC;IAC/D,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC1B,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IAE9C,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,IAAI,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACvD,MAAM,QAAQ,GAAG,aAAa,CAAC,GAAG,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;QAC5D,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO,EAAE,EAAE,EAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,6CAA6C,EAAE,CAAC;QACpF,CAAC;IACH,CAAC;IACD,IAAI,OAAO,CAAC,IAAI,KAAK,UAAU,IAAI,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACxD,MAAM,QAAQ,GACZ,aAAa,CAAC,GAAG,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,CAAC,IAAI,aAAa,CAAC,GAAG,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;QAC1F,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO,EAAE,EAAE,EAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,8CAA8C,EAAE,CAAC;QACrF,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/core/worktree.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Working-tree inspection — the data behind "what code changed, per prompt".
+ * Read-only git plumbing; every function degrades to empty results outside
+ * a git repo.
+ */
+export interface ChangedFile {
+    status: string;
+    path: string;
+}
+export declare function parsePorcelain(porcelain: string): ChangedFile[];
+export declare function porcelainStatus(dir: string): Promise<string>;
+export interface TurnDiff {
+    files: ChangedFile[];
+    added: number;
+    removed: number;
+    patch: string;
+    truncated: boolean;
+}
+/**
+ * Changes attributable to one turn: files whose porcelain line differs from
+ * the pre-turn snapshot, with a patch limited to those files.
+ */
+export declare function diffSinceSnapshot(dir: string, before: string): Promise<TurnDiff | null>;
+export interface WorkingTree {
+    git: boolean;
+    branch?: string;
+    files: ChangedFile[];
+    patch: string;
+    truncated: boolean;
+}
+/** The project's current uncommitted state, for the Changes/Working-tree views. */
+export declare function workingTree(dir: string): Promise<WorkingTree>;

package/dist/core/worktree.js

@@ -0,0 +1,83 @@
+/**
+ * Working-tree inspection — the data behind "what code changed, per prompt".
+ * Read-only git plumbing; every function degrades to empty results outside
+ * a git repo.
+ */
+import { execFile } from "node:child_process";
+const PATCH_EVENT_LIMIT = 12_000; // per-turn patch stored in the event log
+const PATCH_VIEW_LIMIT = 64_000; // full working-tree patch served to apps
+function git(args, cwd) {
+    return new Promise((resolve) => {
+        execFile("git", args, { cwd, maxBuffer: 8 * 1024 * 1024 }, (err, stdout) => resolve(err ? "" : stdout));
+    });
+}
+export function parsePorcelain(porcelain) {
+    return porcelain
+        .split("\n")
+        .filter(Boolean)
+        .map((line) => ({ status: line.slice(0, 2), path: line.slice(3).trim() }));
+}
+export async function porcelainStatus(dir) {
+    // -uall lists files inside untracked directories (not just "?? dir/").
+    return (await git(["status", "--porcelain", "-uall"], dir)).trimEnd();
+}
+/**
+ * Changes attributable to one turn: files whose porcelain line differs from
+ * the pre-turn snapshot, with a patch limited to those files.
+ */
+export async function diffSinceSnapshot(dir, before) {
+    const after = await porcelainStatus(dir);
+    const beforeSet = new Set(before.split("\n").filter(Boolean));
+    const changedLines = after.split("\n").filter((l) => l && !beforeSet.has(l));
+    if (!changedLines.length)
+        return null;
+    const files = parsePorcelain(changedLines.join("\n"));
+    const paths = files.map((f) => f.path);
+    let added = 0;
+    let removed = 0;
+    const numstat = await git(["diff", "HEAD", "--numstat", "--", ...paths], dir);
+    for (const line of numstat.split("\n")) {
+        const [a, r] = line.split("\t");
+        added += Number(a) || 0;
+        removed += Number(r) || 0;
+    }
+    let patch = await git(["diff", "HEAD", "--", ...paths], dir);
+    const untracked = files.filter((f) => f.status === "??").map((f) => f.path);
+    if (untracked.length) {
+        patch += (patch ? "\n" : "") + untracked.map((p) => `?? new file: ${p}`).join("\n");
+    }
+    const truncated = patch.length > PATCH_EVENT_LIMIT;
+    return {
+        files,
+        added,
+        removed,
+        patch: truncated ? patch.slice(0, PATCH_EVENT_LIMIT) + "\n… (truncated)" : patch,
+        truncated,
+    };
+}
+/** The project's current uncommitted state, for the Changes/Working-tree views. */
+export async function workingTree(dir) {
+    const inside = (await git(["rev-parse", "--is-inside-work-tree"], dir)).trim() === "true";
+    if (!inside)
+        return { git: false, files: [], patch: "", truncated: false };
+    const [branch, porcelain, rawPatch] = await Promise.all([
+        git(["rev-parse", "--abbrev-ref", "HEAD"], dir),
+        porcelainStatus(dir),
+        git(["diff", "HEAD"], dir),
+    ]);
+    const files = parsePorcelain(porcelain);
+    let patch = rawPatch;
+    const untracked = files.filter((f) => f.status === "??").map((f) => f.path);
+    if (untracked.length) {
+        patch += (patch ? "\n" : "") + untracked.map((p) => `?? new file: ${p}`).join("\n");
+    }
+    const truncated = patch.length > PATCH_VIEW_LIMIT;
+    return {
+        git: true,
+        branch: branch.trim(),
+        files,
+        patch: truncated ? patch.slice(0, PATCH_VIEW_LIMIT) + "\n… (truncated)" : patch,
+        truncated,
+    };
+}
+//# sourceMappingURL=worktree.js.map

package/dist/core/worktree.js.map

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

package/dist/daemon/app-page.d.ts

@@ -0,0 +1,32 @@
+/**
+ * The Loom web app — a single-file app served by the daemon at /app.
+ * Reachable over the tailnet, paired via the `loom pair` QR deep link
+ * (…/app#pair=<one-time-token>), installable to the Android home screen,
+ * and wrapped by the Electron shell on desktop.
+ *
+ * Served publicly (it's just a shell); every API call it makes carries the
+ * paired client's bearer token. No frameworks, no build step, no CDN.
+ *
+ * Design: the "quiet graphite" system adapted from Orca (github.com/stablyai/
+ * orca, MIT) — neutral monochrome chrome, hairline borders, Geist type, and
+ * color reserved for state: thread cyan = live, shuttle magenta = the baton.
+ * Desktop (>=900px) is the Orca workspace shell: projects/agents tree in the
+ * left sidebar, a tabbed center pane (Thread | Tasks | Brain | Board), a diff
+ * dock right of the chat, a 4-view right rail, a terminal dock, and a status
+ * bar. Mobile keeps the single-column thread. See docs/design-system.md.
+ */
+export declare const APP_MANIFEST: {
+    name: string;
+    short_name: string;
+    start_url: string;
+    display: string;
+    background_color: string;
+    theme_color: string;
+    icons: {
+        src: string;
+        sizes: string;
+        type: string;
+        purpose: string;
+    }[];
+};
+export declare const APP_HTML: string;