@orc-brain/core 1.0.0

package/dist/workerManager.js

@@ -0,0 +1,280 @@
+/**
+ * Worker manager (§3). One worker = one Agent SDK `query()` call = one child
+ * Claude Code CLI subprocess (the TS SDK bundles the binary). Each worker gets
+ * exactly the scope's config — cwd, allowed/disallowed tools, permission mode,
+ * model, maxTurns, maxBudgetUsd — plus the safety layer's hooks + canUseTool,
+ * which are constructor-injected and cannot be omitted.
+ *
+ * The Orchestrator does its own fan-out with independent top-level sessions per
+ * task (Open Decision 4, accepted): per-task model/permission/cwd control,
+ * per-task `session_id` for pause/resume, and per-task cost attribution.
+ */
+import { query as sdkQuery } from "@anthropic-ai/claude-agent-sdk";
+import { ulid } from "ulid";
+import { buildSpawnEnv } from "./spawnEnv.js";
+/** Truncates a value to a short one-line summary for events. */
+function summarize(value, max = 120) {
+    const s = typeof value === "string" ? value : JSON.stringify(value);
+    const oneLine = (s ?? "").replace(/\s+/g, " ").trim();
+    return oneLine.length > max ? oneLine.slice(0, max) + "…" : oneLine;
+}
+/**
+ * Spawns and supervises workers. Constructed with a {@link SafetyLayer} that is
+ * a required argument — a worker cannot be built without one.
+ */
+export class WorkerManager {
+    safety;
+    bus;
+    store;
+    budget;
+    queryFn;
+    constructor(safety, bus, store, budget, queryFn) {
+        this.safety = safety;
+        this.bus = bus;
+        this.store = store;
+        this.budget = budget;
+        this.queryFn = queryFn ?? sdkQuery;
+    }
+    /** The safety layer gating all workers managed here. */
+    get safetyLayer() {
+        return this.safety;
+    }
+    /**
+     * Spawns one worker for a task. Builds the SDK options from the spec, attaches
+     * the safety layer's hooks + canUseTool, strips provider credentials from the
+     * child env, and streams messages onto the bus. Returns a handle immediately;
+     * `handle.done` resolves when the session ends.
+     */
+    spawn(spec) {
+        // Mode floor assertion (§8.3) — throws before any child is spawned.
+        this.safety.assertPermissionMode(spec.permission_mode);
+        const ctx = {
+            run_id: spec.run_id,
+            task_id: spec.task_id,
+            session_id: spec.resume_session_id ?? null,
+            environment: spec.environment,
+            cwd: spec.cwd,
+            path_allowlist: spec.path_allowlist,
+            path_denylist: spec.path_denylist,
+        };
+        const options = {
+            cwd: spec.cwd,
+            model: spec.model,
+            permissionMode: spec.permission_mode,
+            allowedTools: spec.allowed_tools,
+            disallowedTools: spec.disallowed_tools,
+            maxTurns: spec.max_turns,
+            maxBudgetUsd: spec.max_budget_usd,
+            includePartialMessages: true,
+            // Strip ANTHROPIC_API_KEY et al so billing stays on subscription (§2).
+            env: buildSpawnEnv(),
+            hooks: this.safety.buildHooks(ctx),
+            canUseTool: this.safety.buildCanUseTool(ctx),
+            ...(spec.resume_session_id ? { resume: spec.resume_session_id } : {}),
+        };
+        const subagentId = ulid();
+        const now = new Date().toISOString();
+        const record = {
+            id: subagentId,
+            created_at: now,
+            updated_at: now,
+            task_id: spec.task_id,
+            session_id: spec.resume_session_id ?? null,
+            model: spec.model,
+            pid: null,
+            state: "spawning",
+            started_at: now,
+            ended_at: null,
+            num_turns: 0,
+            cost_usd: 0,
+            last_tool_call: null,
+            transcript_path: null,
+        };
+        this.store.upsertSubagent(record);
+        const q = this.queryFn({ prompt: spec.prompt, options });
+        const state = { sessionId: spec.resume_session_id ?? null };
+        const done = this.drain(q, spec, ctx, record, state).catch((err) => {
+            const error = err instanceof Error ? err.message : String(err);
+            this.store.updateTask(spec.task_id, {
+                status: "failed",
+                error: { message: error },
+            });
+            record.state = "exited";
+            record.ended_at = new Date().toISOString();
+            this.store.upsertSubagent(record);
+            this.bus.publish({
+                type: "task.state",
+                run_id: spec.run_id,
+                payload: {
+                    task_id: spec.task_id,
+                    scope_id: "",
+                    status: "failed",
+                    error: { message: error },
+                },
+            });
+            return {
+                session_id: state.sessionId,
+                status: "failed",
+                cost_usd: 0,
+                num_turns: 0,
+                error,
+            };
+        });
+        return {
+            task_id: spec.task_id,
+            sessionId: () => state.sessionId,
+            interrupt: async () => {
+                record.state = "interrupting";
+                this.store.upsertSubagent(record);
+                await q.interrupt();
+            },
+            done,
+        };
+    }
+    /** Consumes the SDK message stream, projecting it onto the bus and store. */
+    async drain(q, spec, ctx, record, state) {
+        let result = {
+            session_id: state.sessionId,
+            status: "failed",
+            cost_usd: 0,
+            num_turns: 0,
+        };
+        this.store.updateTask(spec.task_id, { status: "running" });
+        this.bus.publish({
+            type: "task.state",
+            run_id: spec.run_id,
+            payload: {
+                task_id: spec.task_id,
+                scope_id: "",
+                status: "running",
+                model: spec.model,
+            },
+        });
+        for await (const message of q) {
+            switch (message.type) {
+                case "system": {
+                    if (message.subtype === "init") {
+                        state.sessionId = message.session_id;
+                        ctx.session_id = message.session_id;
+                        record.session_id = message.session_id;
+                        record.state = "running";
+                        this.store.upsertSubagent(record);
+                        this.store.updateTask(spec.task_id, {
+                            session_id: message.session_id,
+                        });
+                    }
+                    break;
+                }
+                case "assistant": {
+                    const blocks = (message.message?.content ?? []);
+                    for (const b of blocks) {
+                        const block = b;
+                        if (block.type === "tool_use") {
+                            record.last_tool_call = {
+                                name: block.name,
+                                input: summarize(block.input),
+                            };
+                            this.store.upsertSubagent(record);
+                            this.bus.publish({
+                                type: "tool.call",
+                                run_id: spec.run_id,
+                                payload: {
+                                    task_id: spec.task_id,
+                                    session_id: state.sessionId,
+                                    tool_name: block.name,
+                                    input_summary: summarize(block.input),
+                                },
+                            });
+                        }
+                        else if (block.type === "text" && block.text) {
+                            this.bus.publish({
+                                type: "text.delta",
+                                run_id: spec.run_id,
+                                payload: {
+                                    task_id: spec.task_id,
+                                    session_id: state.sessionId,
+                                    delta: block.text,
+                                },
+                            });
+                        }
+                    }
+                    break;
+                }
+                case "user": {
+                    const blocks = (message.message?.content ?? []);
+                    if (!Array.isArray(blocks))
+                        break;
+                    for (const b of blocks) {
+                        const block = b;
+                        if (block.type === "tool_result") {
+                            this.bus.publish({
+                                type: "tool.result",
+                                run_id: spec.run_id,
+                                payload: {
+                                    task_id: spec.task_id,
+                                    session_id: state.sessionId,
+                                    tool_name: "",
+                                    is_error: block.is_error ?? false,
+                                    summary: summarize(block.content),
+                                },
+                            });
+                        }
+                    }
+                    break;
+                }
+                case "result": {
+                    const isSuccess = message.subtype === "success";
+                    record.num_turns = message.num_turns;
+                    record.cost_usd = message.total_cost_usd;
+                    record.state = "exited";
+                    record.ended_at = new Date().toISOString();
+                    this.store.upsertSubagent(record);
+                    this.budget.recordResult({
+                        run_id: spec.run_id,
+                        task_id: spec.task_id,
+                        session_id: state.sessionId,
+                        model: spec.model,
+                        result: {
+                            total_cost_usd: message.total_cost_usd,
+                            num_turns: message.num_turns,
+                            usage: message.usage,
+                        },
+                    });
+                    const summary = isSuccess
+                        ? message.result
+                        : undefined;
+                    const error = isSuccess ? undefined : { subtype: message.subtype };
+                    result = {
+                        session_id: state.sessionId,
+                        status: isSuccess ? "done" : "failed",
+                        cost_usd: message.total_cost_usd,
+                        num_turns: message.num_turns,
+                        result_summary: summary,
+                        error,
+                    };
+                    this.store.updateTask(spec.task_id, {
+                        status: result.status,
+                        result_summary: summary ?? null,
+                        error: error ?? null,
+                        session_id: state.sessionId,
+                    });
+                    this.bus.publish({
+                        type: "task.state",
+                        run_id: spec.run_id,
+                        payload: {
+                            task_id: spec.task_id,
+                            scope_id: "",
+                            status: result.status,
+                            error,
+                        },
+                    });
+                    break;
+                }
+                default:
+                    break;
+            }
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=workerManager.js.map

package/dist/workerManager.js.map

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

package/dist/worktrees.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Git worktree lifecycle for scope isolation (spec 002 §R7–§R8, §R12).
+ * Projects in `worktree` mode run each scope's workers in a dedicated worktree
+ * on an `orc/<goal>/<scope>` branch forked from the run's base branch. On scope
+ * success the worktree is removed (after a safety-net commit if dirty) and the
+ * branch is kept for manual merge; on failure the worktree stays for debugging.
+ * Git subprocesses run with the stripped spawn env (§N1) — uniform with workers.
+ */
+/** Injectable git runner (tests exercise failure paths without a repo). */
+export type GitRunner = (args: string[], cwd: string) => string;
+/** Runs git synchronously with provider credentials stripped (§N1). */
+export declare const defaultGitRunner: GitRunner;
+/** Kebab-case slug for branch components (§R8): ≤ 40 chars, git-ref safe. */
+export declare function slugify(name: string, cap?: number): string;
+/** A created/attached scope worktree. */
+export interface ScopeWorktree {
+    path: string;
+    branch: string;
+}
+/** Manages scope worktrees under `<stateDir>/worktrees/<run>/<scope>` (§R8). */
+export declare class WorktreeManager {
+    private readonly stateDir;
+    private readonly git;
+    constructor(stateDir: string, git?: GitRunner);
+    /** Root directory holding all scope worktrees. */
+    worktreesRoot(): string;
+    /**
+     * Creates (or re-attaches after a crash) the worktree for a scope, on branch
+     * `orc/<goal-slug>/<scope-slug>` forked from `baseBranch` (§R8). Branch-name
+     * collisions (two scopes slugging identically) get a numeric suffix.
+     */
+    ensureScopeWorktree(input: {
+        repoRoot: string;
+        runId: string;
+        scopeId: string;
+        goalTitle: string;
+        scopeName: string;
+        baseBranch: string | null;
+    }): ScopeWorktree;
+    /**
+     * Releases a scope worktree on success (§R8): commits any leftover dirt as a
+     * safety net (uncommitted work must never be lost with the worktree), then
+     * removes the worktree. The branch is always kept.
+     */
+    releaseScopeWorktree(worktreePath: string, repoRoot: string, scopeName: string): void;
+    /**
+     * Attempts to merge a settled scope branch into the base branch (spec 002
+     * v2, opt-in per project). Deliberately conservative — it only merges when
+     * the checkout at `repoRoot` is ON the base branch and CLEAN, and a
+     * conflicted merge is aborted. In every skip/failure case the branch simply
+     * stays for manual merge, exactly like the default flow.
+     */
+    mergeScopeBranch(repoRoot: string, branch: string, baseBranch: string, scopeName: string): {
+        merged: boolean;
+        reason?: string;
+    };
+    /**
+     * Deletes `orc/*` branches already fully merged into `baseBranch`
+     * (`orc project gc --prune-merged`, spec 002 v2). `git branch -d` only —
+     * an unmerged branch can never be deleted here.
+     */
+    pruneMergedBranches(repoRoot: string, baseBranch: string): string[];
+    /**
+     * Worktree directories on disk that no live scope references (§R12) — the
+     * residue of crashes or kept-on-failure scopes whose runs are long gone.
+     */
+    listOrphans(livePaths: ReadonlySet<string>): string[];
+    /**
+     * Removes an orphaned worktree directory (§R12). Never deletes branches.
+     * Falls back to a plain directory removal when git no longer tracks it.
+     */
+    removeOrphan(path: string, repoRoot: string): void;
+}
+//# sourceMappingURL=worktrees.d.ts.map

package/dist/worktrees.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktrees.d.ts","sourceRoot":"","sources":["../src/worktrees.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,2EAA2E;AAC3E,MAAM,MAAM,SAAS,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;AAEhE,uEAAuE;AACvE,eAAO,MAAM,gBAAgB,EAAE,SAM3B,CAAC;AAEL,6EAA6E;AAC7E,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,SAAK,GAAG,MAAM,CAQtD;AAED,yCAAyC;AACzC,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,gFAAgF;AAChF,qBAAa,eAAe;IAExB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,GAAG;gBADH,QAAQ,EAAE,MAAM,EAChB,GAAG,GAAE,SAA4B;IAGpD,kDAAkD;IAClD,aAAa,IAAI,MAAM;IAIvB;;;;OAIG;IACH,mBAAmB,CAAC,KAAK,EAAE;QACzB,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;KAC3B,GAAG,aAAa;IAgCjB;;;;OAIG;IACH,oBAAoB,CAClB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAChB,IAAI;IAsBP;;;;;;OAMG;IACH,gBAAgB,CACd,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;IAwCvC;;;;OAIG;IACH,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE;IA2BnE;;;OAGG;IACH,WAAW,CAAC,SAAS,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE;IAerD;;;OAGG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;CAYnD"}

package/dist/worktrees.js

@@ -0,0 +1,210 @@
+/**
+ * Git worktree lifecycle for scope isolation (spec 002 §R7–§R8, §R12).
+ * Projects in `worktree` mode run each scope's workers in a dedicated worktree
+ * on an `orc/<goal>/<scope>` branch forked from the run's base branch. On scope
+ * success the worktree is removed (after a safety-net commit if dirty) and the
+ * branch is kept for manual merge; on failure the worktree stays for debugging.
+ * Git subprocesses run with the stripped spawn env (§N1) — uniform with workers.
+ */
+import { execFileSync } from "node:child_process";
+import { existsSync, mkdirSync, readdirSync, rmSync, statSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { buildSpawnEnv } from "./spawnEnv.js";
+/** Runs git synchronously with provider credentials stripped (§N1). */
+export const defaultGitRunner = (args, cwd) => execFileSync("git", args, {
+    cwd,
+    encoding: "utf8",
+    stdio: ["ignore", "pipe", "pipe"],
+    env: buildSpawnEnv(),
+});
+/** Kebab-case slug for branch components (§R8): ≤ 40 chars, git-ref safe. */
+export function slugify(name, cap = 40) {
+    const slug = name
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .slice(0, cap)
+        .replace(/-+$/, "");
+    return slug || "unnamed";
+}
+/** Manages scope worktrees under `<stateDir>/worktrees/<run>/<scope>` (§R8). */
+export class WorktreeManager {
+    stateDir;
+    git;
+    constructor(stateDir, git = defaultGitRunner) {
+        this.stateDir = stateDir;
+        this.git = git;
+    }
+    /** Root directory holding all scope worktrees. */
+    worktreesRoot() {
+        return join(this.stateDir, "worktrees");
+    }
+    /**
+     * Creates (or re-attaches after a crash) the worktree for a scope, on branch
+     * `orc/<goal-slug>/<scope-slug>` forked from `baseBranch` (§R8). Branch-name
+     * collisions (two scopes slugging identically) get a numeric suffix.
+     */
+    ensureScopeWorktree(input) {
+        const path = join(this.worktreesRoot(), input.runId, input.scopeId);
+        // Crash recovery: the worktree already exists — reuse it and its branch.
+        if (existsSync(join(path, ".git"))) {
+            const branch = this.git(["rev-parse", "--abbrev-ref", "HEAD"], path).trim();
+            return { path, branch };
+        }
+        mkdirSync(dirname(path), { recursive: true });
+        const base = `orc/${slugify(input.goalTitle)}/${slugify(input.scopeName)}`;
+        let lastError;
+        for (let attempt = 0; attempt < 10; attempt++) {
+            const branch = attempt === 0 ? base : `${base}-${attempt + 1}`;
+            const args = ["worktree", "add", path, "-b", branch];
+            if (input.baseBranch)
+                args.push(input.baseBranch);
+            try {
+                this.git(args, input.repoRoot);
+                return { path, branch };
+            }
+            catch (err) {
+                lastError = err;
+                // Only a branch-name collision is retried with a suffix.
+                if (!/already exists/i.test(String(err)))
+                    break;
+            }
+        }
+        throw new Error(`git worktree add failed for scope ${input.scopeId}: ${String(lastError)}`);
+    }
+    /**
+     * Releases a scope worktree on success (§R8): commits any leftover dirt as a
+     * safety net (uncommitted work must never be lost with the worktree), then
+     * removes the worktree. The branch is always kept.
+     */
+    releaseScopeWorktree(worktreePath, repoRoot, scopeName) {
+        if (!existsSync(worktreePath))
+            return;
+        const status = this.git(["status", "--porcelain"], worktreePath);
+        if (status.trim()) {
+            this.git(["add", "-A"], worktreePath);
+            // Explicit identity so the safety-net commit works without repo config.
+            this.git([
+                "-c",
+                "user.name=orc-brain",
+                "-c",
+                "user.email=orc@localhost",
+                "commit",
+                "-m",
+                `orc: auto-commit remaining changes for ${scopeName}`,
+            ], worktreePath);
+        }
+        this.git(["worktree", "remove", "--force", worktreePath], repoRoot);
+    }
+    /**
+     * Attempts to merge a settled scope branch into the base branch (spec 002
+     * v2, opt-in per project). Deliberately conservative — it only merges when
+     * the checkout at `repoRoot` is ON the base branch and CLEAN, and a
+     * conflicted merge is aborted. In every skip/failure case the branch simply
+     * stays for manual merge, exactly like the default flow.
+     */
+    mergeScopeBranch(repoRoot, branch, baseBranch, scopeName) {
+        const current = this.git(["rev-parse", "--abbrev-ref", "HEAD"], repoRoot).trim();
+        if (current !== baseBranch) {
+            return {
+                merged: false,
+                reason: `checkout is on '${current}', not base branch '${baseBranch}'`,
+            };
+        }
+        if (this.git(["status", "--porcelain"], repoRoot).trim()) {
+            return { merged: false, reason: "checkout has uncommitted changes" };
+        }
+        try {
+            this.git([
+                "-c",
+                "user.name=orc-brain",
+                "-c",
+                "user.email=orc@localhost",
+                "merge",
+                "--no-ff",
+                "-m",
+                `orc: merge ${branch} (scope ${scopeName})`,
+                branch,
+            ], repoRoot);
+            return { merged: true };
+        }
+        catch (err) {
+            try {
+                this.git(["merge", "--abort"], repoRoot);
+            }
+            catch {
+                // Nothing in progress to abort.
+            }
+            return { merged: false, reason: `merge failed: ${String(err)}` };
+        }
+    }
+    /**
+     * Deletes `orc/*` branches already fully merged into `baseBranch`
+     * (`orc project gc --prune-merged`, spec 002 v2). `git branch -d` only —
+     * an unmerged branch can never be deleted here.
+     */
+    pruneMergedBranches(repoRoot, baseBranch) {
+        const out = this.git([
+            "branch",
+            "--merged",
+            baseBranch,
+            "--list",
+            "orc/*",
+            "--format=%(refname:short)",
+        ], repoRoot);
+        const pruned = [];
+        for (const branch of out
+            .split("\n")
+            .map((b) => b.trim())
+            .filter(Boolean)) {
+            try {
+                this.git(["branch", "-d", branch], repoRoot);
+                pruned.push(branch);
+            }
+            catch {
+                // Checked out in a live worktree, etc. — leave it.
+            }
+        }
+        return pruned;
+    }
+    /**
+     * Worktree directories on disk that no live scope references (§R12) — the
+     * residue of crashes or kept-on-failure scopes whose runs are long gone.
+     */
+    listOrphans(livePaths) {
+        const root = this.worktreesRoot();
+        if (!existsSync(root))
+            return [];
+        const orphans = [];
+        for (const runDir of readdirSync(root)) {
+            const runPath = join(root, runDir);
+            if (!statSync(runPath).isDirectory())
+                continue;
+            for (const scopeDir of readdirSync(runPath)) {
+                const p = join(runPath, scopeDir);
+                if (!livePaths.has(p))
+                    orphans.push(p);
+            }
+        }
+        return orphans;
+    }
+    /**
+     * Removes an orphaned worktree directory (§R12). Never deletes branches.
+     * Falls back to a plain directory removal when git no longer tracks it.
+     */
+    removeOrphan(path, repoRoot) {
+        try {
+            this.git(["worktree", "remove", "--force", path], repoRoot);
+        }
+        catch {
+            rmSync(path, { recursive: true, force: true });
+        }
+        try {
+            this.git(["worktree", "prune"], repoRoot);
+        }
+        catch {
+            // Best-effort: the repo may be gone entirely.
+        }
+    }
+}
+//# sourceMappingURL=worktrees.js.map

package/dist/worktrees.js.map

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

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@orc-brain/core",
+  "version": "1.0.0",
+  "description": "Orchestration engine for orc-brain: planner, dispatch loop, safety layer, store.",
+  "type": "module",
+  "license": "MIT",
+  "author": "Paulo Lima",
+  "homepage": "https://github.com/anplabs/orc-brain#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/anplabs/orc-brain.git",
+    "directory": "packages/core"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "dependencies": {
+    "@anthropic-ai/claude-agent-sdk": "^0.3.201",
+    "better-sqlite3": "^12.11.1",
+    "shell-quote": "^1.9.0",
+    "ulid": "^3.0.2",
+    "@orc-brain/plugin-linear": "1.0.0",
+    "@orc-brain/shared": "1.0.0"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/node": "^22.10.7",
+    "@types/shell-quote": "^1.7.5"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "clean": "rm -rf dist"
+  }
+}