@loompad/cli 0.1.0 → 1.1.1

package/dist/core/prompt-queue.js

@@ -0,0 +1,269 @@
+/**
+ * The prompt queue: what you've lined up for this project, run one at a time.
+ *
+ * You type while an agent is mid-turn, or while an orchestra goal is still
+ * running, and the prompt waits here instead of being refused or lost. Each
+ * item names who takes it — one agent, the orchestrator (a new goal), or the
+ * auto router — and nothing about it is final until it's sent: you can edit
+ * the text, change who it goes to, reorder it or drop it.
+ *
+ * This module is the data and its file; ProjectRuntime decides when the head
+ * of the queue may go (see ProjectRuntime.drainPromptQueue). The file lives in
+ * the project's .loom/ beside the log, so a queue survives a daemon restart —
+ * reloaded paused, because prompts you queued an hour ago shouldn't start
+ * running just because the daemon came back.
+ */
+import fs from "node:fs";
+import path from "node:path";
+/** A condition from the wire, checked. */
+export function parseCondition(raw) {
+    if (raw === undefined || raw === null || raw === "")
+        return undefined;
+    const c = raw;
+    if (c.kind === "at") {
+        const at = typeof c.at === "string" ? Date.parse(c.at) : Number(c.at);
+        if (!Number.isFinite(at))
+            throw new Error("that isn't a time I can read");
+        return { kind: "at", at };
+    }
+    if (c.kind === "landed" || c.kind === "checks-green") {
+        const runId = String(c.runId ?? "").trim();
+        if (!runId)
+            throw new Error(`a "${c.kind}" condition needs the goal it waits for`);
+        return { kind: c.kind, runId };
+    }
+    if (c.kind === "quiet") {
+        const ms = Number(c.ms);
+        if (!Number.isFinite(ms) || ms <= 0)
+            throw new Error("a quiet period needs a duration");
+        return { kind: "quiet", ms: Math.min(ms, 24 * 60 * 60_000) };
+    }
+    throw new Error(`unknown condition "${String(c.kind)}"`);
+}
+/** The condition in the words the queue shows. */
+export function describeCondition(c) {
+    if (c.kind === "at") {
+        const d = new Date(c.at);
+        return `waiting until ${d.toLocaleString()}`;
+    }
+    if (c.kind === "landed")
+        return `waiting for goal ${c.runId} to land`;
+    if (c.kind === "checks-green")
+        return `waiting for goal ${c.runId}'s checks to go green`;
+    return `waiting for ${Math.round(c.ms / 60_000)} quiet minute${c.ms >= 120_000 ? "s" : ""}`;
+}
+export const MAX_QUEUE = 100;
+export const MAX_QUEUE_TEXT = 100_000;
+/** A target from the wire: validated, so nothing downstream sees a shape it doesn't know. */
+export function parseTarget(raw) {
+    if (raw === undefined || raw === null || raw === "auto")
+        return { kind: "auto" };
+    if (raw === "orchestra")
+        return { kind: "orchestra" };
+    if (typeof raw === "string" && raw.trim())
+        return { kind: "agent", agentId: raw.trim() };
+    if (typeof raw !== "object")
+        throw new Error("target must be an agent id, \"orchestra\" or \"auto\"");
+    const t = raw;
+    if (t.kind === "auto")
+        return { kind: "auto" };
+    if (t.kind === "agent") {
+        if (typeof t.agentId !== "string" || !t.agentId.trim())
+            throw new Error("an agent target needs an agentId");
+        return { kind: "agent", agentId: t.agentId.trim() };
+    }
+    if (t.kind === "orchestra") {
+        const workers = Array.isArray(t.workers) ? t.workers.map(String).filter(Boolean) : undefined;
+        const maxParallel = Number(t.maxParallel);
+        return {
+            kind: "orchestra",
+            ...(typeof t.orchestrator === "string" && t.orchestrator ? { orchestrator: t.orchestrator } : {}),
+            ...(workers?.length ? { workers } : {}),
+            ...(Number.isFinite(maxParallel) && maxParallel > 0 ? { maxParallel: Math.floor(maxParallel) } : {}),
+            ...(Number.isFinite(Number(t.maxUsd)) && Number(t.maxUsd) > 0 ? { maxUsd: Number(t.maxUsd) } : {}),
+        };
+    }
+    throw new Error(`unknown target kind "${String(t.kind)}"`);
+}
+export class PromptQueue {
+    file;
+    onChange;
+    state = { items: [], paused: false };
+    seq = 0;
+    /** `file` null keeps it in memory (tests, projects with no .loom). */
+    constructor(file, onChange = () => { }) {
+        this.file = file;
+        this.onChange = onChange;
+        if (!file)
+            return;
+        try {
+            const raw = JSON.parse(fs.readFileSync(file, "utf8"));
+            const items = Array.isArray(raw.items) ? raw.items.filter(validItem) : [];
+            this.state = items.length
+                ? { items, paused: true, reason: "the daemon restarted — resume to run what's queued" }
+                : { items: [], paused: false };
+        }
+        catch {
+            // no file yet, or unreadable: an empty queue, not a crash
+        }
+    }
+    snapshot() {
+        return { items: this.state.items.map((i) => ({ ...i, target: { ...i.target }, ...(i.continuity ? { continuity: { ...i.continuity } } : {}) })), paused: this.state.paused, ...(this.state.reason ? { reason: this.state.reason } : {}) };
+    }
+    get paused() {
+        return this.state.paused;
+    }
+    get length() {
+        return this.state.items.length;
+    }
+    peek() {
+        return this.state.items[0];
+    }
+    add(input) {
+        this.assertCanAdd(input);
+        // Captured native requests are immutable evidence, including whitespace.
+        const text = input.continuity ? input.text : input.text.trim();
+        const item = {
+            id: `q${Date.now().toString(36)}${(this.seq++).toString(36)}`,
+            text,
+            target: input.target ?? { kind: "auto" },
+            chat: input.chat ?? "main",
+            ...(input.plan ? { plan: true } : {}),
+            ...(input.length ? { length: input.length } : {}),
+            source: input.source ?? "user",
+            ...(input.continuity ? { continuity: { ...input.continuity } } : {}),
+            at: Date.now(),
+            ...(input.when ? { when: input.when } : {}),
+        };
+        this.state.items.push(item);
+        this.changed();
+        return item;
+    }
+    assertCanAdd(input) {
+        if (!input.text.trim())
+            throw new Error("nothing to queue — the prompt is empty");
+        if (input.text.length > MAX_QUEUE_TEXT)
+            throw new Error(`a queued prompt is at most ${MAX_QUEUE_TEXT} characters`);
+        if (this.state.items.length >= MAX_QUEUE)
+            throw new Error(`the queue is full (${MAX_QUEUE} prompts)`);
+    }
+    edit(id, patch) {
+        const item = this.must(id);
+        if (patch.text !== undefined) {
+            const text = item.continuity ? patch.text : patch.text.trim();
+            if (!text.trim())
+                throw new Error("a queued prompt can't be empty — remove it instead");
+            if (text.length > MAX_QUEUE_TEXT)
+                throw new Error(`a queued prompt is at most ${MAX_QUEUE_TEXT} characters`);
+            item.text = text;
+        }
+        if (patch.target)
+            item.target = patch.target;
+        if (patch.plan !== undefined) {
+            if (patch.plan)
+                item.plan = true;
+            else
+                delete item.plan;
+        }
+        if (patch.when !== undefined) {
+            if (patch.when)
+                item.when = patch.when;
+            else
+                delete item.when; // null means "go as soon as you can"
+        }
+        item.editedAt = Date.now();
+        this.changed();
+        return item;
+    }
+    remove(id) {
+        const i = this.index(id);
+        this.state.items.splice(i, 1);
+        if (!this.state.items.length)
+            this.state = { items: [], paused: false };
+        this.changed();
+    }
+    /** Move an item to position `to` (0 = next to run), clamped to the queue. */
+    move(id, to) {
+        const from = this.index(id);
+        const [item] = this.state.items.splice(from, 1);
+        const dest = Math.max(0, Math.min(this.state.items.length, Math.floor(Number.isFinite(to) ? to : 0)));
+        this.state.items.splice(dest, 0, item);
+        this.changed();
+    }
+    clear() {
+        const n = this.state.items.length;
+        this.state = { items: [], paused: false };
+        this.changed();
+        return n;
+    }
+    setPaused(paused, reason) {
+        this.state.paused = paused;
+        if (paused && reason)
+            this.state.reason = reason;
+        else
+            delete this.state.reason;
+        this.changed();
+    }
+    /** Take the head to send it. */
+    shift() {
+        const item = this.state.items.shift();
+        if (item)
+            this.changed();
+        return item;
+    }
+    /** Put a head that couldn't go back where it was. */
+    unshift(item) {
+        this.state.items.unshift(item);
+        this.changed();
+    }
+    must(id) {
+        return this.state.items[this.index(id)];
+    }
+    index(id) {
+        const i = this.state.items.findIndex((x) => x.id === id);
+        if (i < 0)
+            throw new QueueItemGone(id);
+        return i;
+    }
+    changed() {
+        if (this.file) {
+            try {
+                fs.mkdirSync(path.dirname(this.file), { recursive: true });
+                const tmp = `${this.file}.${process.pid}.tmp`;
+                fs.writeFileSync(tmp, JSON.stringify({ items: this.state.items }, null, 2));
+                fs.renameSync(tmp, this.file);
+            }
+            catch {
+                // a queue that can't be saved still works for this session
+            }
+        }
+        this.onChange(this.snapshot());
+    }
+}
+/** The item was already sent or removed — the UI raced the queue. */
+export class QueueItemGone extends Error {
+    constructor(id) {
+        super(`queued prompt ${id} is gone — it was sent or removed`);
+    }
+}
+function validItem(x) {
+    if (!x || typeof x !== "object")
+        return false;
+    const i = x;
+    if (typeof i.id !== "string" || typeof i.text !== "string" || !i.text.trim() || i.text.length > MAX_QUEUE_TEXT)
+        return false;
+    if (i.continuity && (typeof i.continuity.requestId !== "string" || !i.continuity.requestId || i.continuity.requestId.length > 256 ||
+        !(i.continuity.model === null || (typeof i.continuity.model === "string" && i.continuity.model.length > 0 && i.continuity.model.length <= 256))))
+        return false;
+    try {
+        i.target = parseTarget(i.target);
+    }
+    catch {
+        return false;
+    }
+    i.chat = typeof i.chat === "string" && i.chat ? i.chat : "main";
+    i.source = i.source === "route" ? "route" : "user";
+    i.at = Number(i.at) || Date.now();
+    return true;
+}
+//# sourceMappingURL=prompt-queue.js.map

package/dist/core/prompt-queue.js.map

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

package/dist/core/prompts.d.ts

@@ -0,0 +1,53 @@
+/**
+ * The prompt manager — a clipboard manager for prompts.
+ *
+ * Two shelves, daemon-wide (a good prompt isn't a property of one project):
+ *
+ *  - **saved**: prompts you kept, titled, optionally pinned to the top, with a
+ *    use count so the ones you reach for float up;
+ *  - **recent**: every prompt you actually sent (chat turns, orchestra goals),
+ *    newest first, de-duplicated, capped — the history you didn't have to
+ *    remember to save.
+ *
+ * Stored in ~/.loom/prompts.json. Nothing leaves the machine.
+ */
+export interface SavedPrompt {
+    id: string;
+    title: string;
+    text: string;
+    pinned: boolean;
+    uses: number;
+    createdAt: number;
+    lastUsed?: number;
+}
+export interface RecentPrompt {
+    text: string;
+    at: number;
+    project?: string;
+    mode?: "chat" | "orchestrate" | "plan";
+}
+interface PromptStore {
+    saved: SavedPrompt[];
+    recent: RecentPrompt[];
+}
+/** Saved (pinned first, then most-used, then newest) and recent, optionally filtered. */
+export declare function listPrompts(q?: string): PromptStore;
+export declare function savePrompt(input: {
+    title?: string;
+    text: string;
+    pinned?: boolean;
+}): SavedPrompt;
+export declare function updatePrompt(id: string, patch: {
+    title?: string;
+    text?: string;
+    pinned?: boolean;
+    used?: boolean;
+}): SavedPrompt;
+export declare function deletePrompt(id: string): boolean;
+/** Remember a prompt that was actually sent. Duplicates move to the top. */
+export declare function recordRecent(text: string, meta?: {
+    project?: string;
+    mode?: RecentPrompt["mode"];
+}): void;
+export declare function clearRecent(): void;
+export {};

package/dist/core/prompts.js

@@ -0,0 +1,127 @@
+/**
+ * The prompt manager — a clipboard manager for prompts.
+ *
+ * Two shelves, daemon-wide (a good prompt isn't a property of one project):
+ *
+ *  - **saved**: prompts you kept, titled, optionally pinned to the top, with a
+ *    use count so the ones you reach for float up;
+ *  - **recent**: every prompt you actually sent (chat turns, orchestra goals),
+ *    newest first, de-duplicated, capped — the history you didn't have to
+ *    remember to save.
+ *
+ * Stored in ~/.loom/prompts.json. Nothing leaves the machine.
+ */
+import crypto from "node:crypto";
+import fs from "node:fs";
+import path from "node:path";
+import { loomHome } from "./registry.js";
+const RECENT_CAP = 200;
+const TEXT_CAP = 20_000;
+function file() {
+    return path.join(loomHome(), "prompts.json");
+}
+function read() {
+    try {
+        const s = JSON.parse(fs.readFileSync(file(), "utf8"));
+        return { saved: s.saved ?? [], recent: s.recent ?? [] };
+    }
+    catch {
+        return { saved: [], recent: [] };
+    }
+}
+function write(s) {
+    fs.mkdirSync(loomHome(), { recursive: true });
+    const f = file();
+    fs.writeFileSync(f + ".tmp", JSON.stringify(s, null, 2), { mode: 0o600 });
+    fs.renameSync(f + ".tmp", f);
+}
+function titleFrom(text) {
+    const line = text.trim().split("\n")[0] ?? "";
+    return line.length > 60 ? `${line.slice(0, 57)}…` : line || "Untitled prompt";
+}
+/** Saved (pinned first, then most-used, then newest) and recent, optionally filtered. */
+export function listPrompts(q = "") {
+    const s = read();
+    const needle = q.trim().toLowerCase();
+    const match = (t) => !needle || t.toLowerCase().includes(needle);
+    const saved = s.saved
+        .filter((p) => match(p.title) || match(p.text))
+        .sort((a, b) => Number(b.pinned) - Number(a.pinned) ||
+        b.uses - a.uses ||
+        (b.lastUsed ?? b.createdAt) - (a.lastUsed ?? a.createdAt));
+    const recent = s.recent.filter((r) => match(r.text));
+    return { saved, recent };
+}
+export function savePrompt(input) {
+    const text = String(input.text ?? "").trim().slice(0, TEXT_CAP);
+    if (!text)
+        throw new Error("a prompt needs text");
+    const s = read();
+    const existing = s.saved.find((p) => p.text === text);
+    if (existing) {
+        if (input.title?.trim())
+            existing.title = input.title.trim().slice(0, 80);
+        if (typeof input.pinned === "boolean")
+            existing.pinned = input.pinned;
+        write(s);
+        return existing;
+    }
+    const p = {
+        id: crypto.randomBytes(5).toString("hex"),
+        title: input.title?.trim().slice(0, 80) || titleFrom(text),
+        text,
+        pinned: Boolean(input.pinned),
+        uses: 0,
+        createdAt: Date.now(),
+    };
+    s.saved.push(p);
+    write(s);
+    return p;
+}
+export function updatePrompt(id, patch) {
+    const s = read();
+    const p = s.saved.find((x) => x.id === id);
+    if (!p)
+        throw new Error(`no saved prompt "${id}"`);
+    if (typeof patch.title === "string" && patch.title.trim())
+        p.title = patch.title.trim().slice(0, 80);
+    if (typeof patch.text === "string" && patch.text.trim())
+        p.text = patch.text.trim().slice(0, TEXT_CAP);
+    if (typeof patch.pinned === "boolean")
+        p.pinned = patch.pinned;
+    if (patch.used) {
+        p.uses++;
+        p.lastUsed = Date.now();
+    }
+    write(s);
+    return p;
+}
+export function deletePrompt(id) {
+    const s = read();
+    const before = s.saved.length;
+    s.saved = s.saved.filter((p) => p.id !== id);
+    if (s.saved.length === before)
+        return false;
+    write(s);
+    return true;
+}
+/** Remember a prompt that was actually sent. Duplicates move to the top. */
+export function recordRecent(text, meta = {}) {
+    const t = String(text ?? "").trim().slice(0, TEXT_CAP);
+    if (!t)
+        return;
+    try {
+        const s = read();
+        s.recent = [{ text: t, at: Date.now(), ...meta }, ...s.recent.filter((r) => r.text !== t)].slice(0, RECENT_CAP);
+        write(s);
+    }
+    catch {
+        /* history is a convenience — never fail a send over it */
+    }
+}
+export function clearRecent() {
+    const s = read();
+    s.recent = [];
+    write(s);
+}
+//# sourceMappingURL=prompts.js.map

package/dist/core/prompts.js.map

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

package/dist/core/proof.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Proof — is "done" true? (the "Proof Pack")
+ *
+ * Agents say "all tests pass" when three of fourteen ran, or when none did.
+ * Proof reads what an agent *claimed* at the end of a turn, what it actually
+ * *ran* during it (the shell tool calls and their exit codes, already in the
+ * log), and — the part no vendor does for itself — what happens when Loom runs
+ * the project's tests again in a clean checkout of the agent's changes. The
+ * verdict is one of:
+ *
+ *   verified      the re-run passes, and nothing the agent claimed contradicts it
+ *   contradicted  the re-run fails, or a claim doesn't match what happened
+ *                 (it said 14 pass and 11 did; it said tests pass and never ran any)
+ *   unverified    nothing to check against (no test command, no claims)
+ *
+ * This file is pure: claims, evidence, counts, the verdict. Running the tests
+ * in a clean worktree is the daemon's (daemon/proof.ts).
+ */
+import type { LoomEvent } from "../types.js";
+export type ClaimKind = "tests" | "build" | "lint" | "typecheck";
+export interface Claim {
+    kind: ClaimKind;
+    /** The sentence it came from, trimmed. */
+    text: string;
+    /** "12 tests pass", "all 30 passed": how many it said passed (and of how many). */
+    passed?: number;
+    total?: number;
+}
+export interface Counts {
+    passed: number;
+    failed: number;
+    skipped?: number;
+    total?: number;
+}
+/** A command the agent ran during the turn. */
+export interface Ran {
+    command: string;
+    kind: ClaimKind | "other";
+    exitCode: number | null;
+    ok: boolean;
+    counts?: Counts;
+    eventId: number;
+}
+export interface ClaimCheck extends Claim {
+    status: "supported" | "contradicted" | "unchecked";
+    why: string;
+}
+export interface Rerun {
+    command: string;
+    exitCode: number | null;
+    ok: boolean;
+    counts?: Counts;
+    ms: number;
+    /** The last lines of output. */
+    tail: string;
+    timedOut?: boolean;
+    /** Run in a clean checkout of the changes (false: not a git checkout, so in place). */
+    clean?: boolean;
+}
+export type Verdict = "verified" | "contradicted" | "unverified";
+export interface ProofResult {
+    verdict: Verdict;
+    /** One sentence for a notification, a badge's title, a PR body. */
+    headline: string;
+    claims: ClaimCheck[];
+    ran: Ran[];
+    rerun: Rerun | null;
+}
+/** What a turn's final message says is true. One claim per kind (the strongest sentence). */
+export declare function extractClaims(text: string): Claim[];
+export declare function commandKind(command: string): ClaimKind | "other";
+/**
+ * Pass/fail counts from a test runner's output: vitest, jest, mocha, node:test,
+ * pytest, go test, cargo test, rspec, phpunit. Null when it can't tell.
+ */
+export declare function parseCounts(output: string): Counts | null;
+/** The commands a turn ran, from its tool_call events. */
+export declare function evidenceFrom(events: LoomEvent[]): Ran[];
+/** The command that tests this project, from what it declares. Null when it declares nothing runnable. */
+export declare function detectTestCommand(dir: string): string | null;
+/** Weigh what was claimed against what ran and what the clean re-run showed. */
+export declare function judge(claims: Claim[], ran: Ran[], rerun: Rerun | null): ProofResult;