@oxagen/cli 0.5.0 → 0.6.1

package/dist/commands/cost.js

@@ -0,0 +1,140 @@
+/**
+ * `oxagen cost` — make cost projection trivial.
+ *
+ * The rate card is baked into the CLI, so you never need a spreadsheet to answer
+ * "what would this run cost on model X?" or "which model is cheapest for this
+ * workload?". Modes:
+ *
+ *   oxagen cost --in 200000 --out 40000              project on every model, cheapest first
+ *   oxagen cost --in 200000 --out 40000 --model …    project on one model
+ *   oxagen cost --rates                              print the baked-in rate card
+ *   oxagen cost --session                            roll up what THIS project's turns
+ *                                                    actually cost, by model (proof)
+ *
+ * Add --json to any mode for machine-readable output.
+ */
+import { RATE_CARD, compareModels, formatUsd, projectCost, } from "../agent/rate-card.js";
+import { openTraceStore } from "../agent/trace-store.js";
+const out = (s) => void process.stdout.write(s + "\n");
+export async function handleCost(opts) {
+    if (opts.rates)
+        return printRates(opts.json ?? false);
+    if (opts.session)
+        return printSession(process.cwd(), opts.json ?? false);
+    return printProjection(opts);
+}
+/** Dump the baked-in rate card (USD per 1M tokens). */
+function printRates(json) {
+    if (json) {
+        out(JSON.stringify(RATE_CARD, null, 2));
+        return;
+    }
+    out("Rate card (USD per 1,000,000 tokens):");
+    out("");
+    out(`  ${"model".padEnd(16)}${"vendor".padEnd(12)}${"input".padStart(10)}${"output".padStart(10)}`);
+    for (const e of RATE_CARD) {
+        out(`  ${e.label.padEnd(16)}${e.vendor.padEnd(12)}` +
+            `${("$" + e.rate.inputPer1M).padStart(10)}${("$" + e.rate.outputPer1M).padStart(10)}`);
+    }
+}
+/** Project a token usage across one model or every model (cheapest first). */
+function printProjection(opts) {
+    const inputTokens = opts.in ?? 0;
+    const outputTokens = opts.out ?? 0;
+    if (inputTokens === 0 && outputTokens === 0) {
+        out("Provide token counts: oxagen cost --in <input> --out <output> [--model <slug>]");
+        out("Or: oxagen cost --rates   |   oxagen cost --session");
+        process.exitCode = 1;
+        return;
+    }
+    const usage = { inputTokens, outputTokens };
+    const rows = opts.model ? [projectCost(opts.model, usage)] : compareModels(usage);
+    if (opts.json) {
+        out(JSON.stringify(opts.model ? rows[0] : rows, null, 2));
+        return;
+    }
+    out(`Projected cost for ${inputTokens.toLocaleString()} in → ${outputTokens.toLocaleString()} out tokens:`);
+    out("");
+    out(`  ${"model".padEnd(18)}${"input".padStart(12)}${"output".padStart(12)}${"total".padStart(12)}`);
+    for (const r of rows) {
+        out(`  ${(r.label + (r.fallback ? " *" : "")).padEnd(18)}` +
+            `${formatUsd(r.inputCostUsd).padStart(12)}${formatUsd(r.outputCostUsd).padStart(12)}` +
+            `${formatUsd(r.totalUsd).padStart(12)}`);
+    }
+    if (!opts.model && rows.length > 1) {
+        const cheap = rows[0];
+        const dear = rows[rows.length - 1];
+        const factor = cheap.totalUsd > 0 ? (dear.totalUsd / cheap.totalUsd).toFixed(1) : "∞";
+        out("");
+        out(`  cheapest: ${cheap.label} (${formatUsd(cheap.totalUsd)}) — ${factor}× cheaper than ${dear.label}.`);
+    }
+    if (rows.some((r) => r.fallback))
+        out("\n  * no exact rate-card entry; priced at the fallback rate.");
+}
+/** Attribute a trace's spend to models — per-phase when available, else the executor. */
+function attribute(trace, byModel) {
+    const add = (model, inTok, outTok, cost, ms) => {
+        const m = byModel.get(model) ??
+            { model, inputTokens: 0, outputTokens: 0, costUsd: 0, durationMs: 0, turns: 0 };
+        m.inputTokens += inTok;
+        m.outputTokens += outTok;
+        m.costUsd += cost;
+        m.durationMs += ms;
+        byModel.set(model, m);
+    };
+    if (trace.phases?.length) {
+        for (const p of trace.phases) {
+            if (!p.model)
+                continue;
+            add(p.model, p.usage.inputTokens, p.usage.outputTokens, p.usage.costUsd, p.durationMs);
+        }
+    }
+    else {
+        add(trace.selectedModel, trace.usage.inputTokens, trace.usage.outputTokens, trace.usage.costUsd, trace.durationMs);
+    }
+}
+/** Roll up what this project's recorded turns actually cost, by model. */
+function printSession(cwd, json) {
+    const traces = openTraceStore(cwd).list();
+    const byModel = new Map();
+    let totalCost = 0;
+    let totalMs = 0;
+    let totalIn = 0;
+    let totalOut = 0;
+    for (const t of traces) {
+        attribute(t, byModel);
+        totalCost += t.usage.costUsd;
+        totalMs += t.durationMs;
+        totalIn += t.usage.inputTokens;
+        totalOut += t.usage.outputTokens;
+    }
+    // Count turns per model (by executor, the model that did the work).
+    for (const t of traces) {
+        const m = byModel.get(t.selectedModel);
+        if (m)
+            m.turns += 1;
+    }
+    const spend = [...byModel.values()].sort((a, b) => b.costUsd - a.costUsd);
+    if (json) {
+        out(JSON.stringify({ turns: traces.length, totalCostUsd: totalCost, totalDurationMs: totalMs, totalInputTokens: totalIn, totalOutputTokens: totalOut, byModel: spend }, null, 2));
+        return;
+    }
+    if (traces.length === 0) {
+        out("No turns recorded for this project yet. Run some prompts, then re-check.");
+        return;
+    }
+    out(`Session cost rollup — ${traces.length} turn(s) in ${cwd.split("/").pop()}:`);
+    out("");
+    out(`  ${"model".padEnd(20)}${"turns".padStart(7)}${"tokens".padStart(16)}${"cost".padStart(12)}${"time".padStart(10)}`);
+    for (const m of spend) {
+        const tok = `${m.inputTokens}→${m.outputTokens}`;
+        out(`  ${(m.model.split("/").pop() ?? m.model).padEnd(20)}${String(m.turns).padStart(7)}` +
+            `${tok.padStart(16)}${formatUsd(m.costUsd).padStart(12)}${(Math.round(m.durationMs / 100) / 10 + "s").padStart(10)}`);
+    }
+    out("");
+    const avgCost = traces.length ? totalCost / traces.length : 0;
+    const avgMs = traces.length ? totalMs / traces.length : 0;
+    out(`  total: ${formatUsd(totalCost)} · ${totalIn + totalOut} tok · ${(totalMs / 1000).toFixed(1)}s   ` +
+        `(avg ${formatUsd(avgCost)} · ${(avgMs / 1000).toFixed(1)}s per turn)`);
+}
+//# sourceMappingURL=cost.js.map

package/dist/commands/cost.js.map

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

package/dist/commands/env.d.ts

@@ -0,0 +1,19 @@
+export declare function handleEnvList(opts: {
+    json?: boolean;
+}): Promise<void>;
+export declare function handleEnvGet(idOrSlug: string, opts: {
+    json?: boolean;
+}): Promise<void>;
+export declare function handleEnvCreate(name: string, opts: {
+    slug?: string;
+    description?: string;
+}): Promise<void>;
+export declare function handleEnvUpdate(idOrSlug: string, opts: {
+    name?: string;
+    slug?: string;
+    description?: string;
+    active?: boolean;
+}): Promise<void>;
+export declare function handleEnvRemove(idOrSlug: string): Promise<void>;
+export declare function handleEnvSetDefault(idOrSlug: string): Promise<void>;
+//# sourceMappingURL=env.d.ts.map

package/dist/commands/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/commands/env.ts"],"names":[],"mappings":"AAoBA,wBAAsB,aAAa,CAAC,IAAI,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAgB3E;AAED,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAO5F;AAED,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5C,OAAO,CAAC,IAAI,CAAC,CAQf;AAED,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAC7E,OAAO,CAAC,IAAI,CAAC,CAUf;AAED,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAIrE;AAED,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMzE"}

package/dist/commands/env.js

@@ -0,0 +1,64 @@
+/** `oxagen env …` — manage workspace environments via the org-scoped API. */
+import { apiPost, printTable } from "../lib/api.js";
+import { resolveEnvironmentId } from "../lib/resolve.js";
+function slugify(name) {
+    return name
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+}
+export async function handleEnvList(opts) {
+    const { environments } = await apiPost("environment/list", {});
+    if (opts.json) {
+        process.stdout.write(JSON.stringify(environments, null, 2) + "\n");
+        return;
+    }
+    printTable(["NAME", "SLUG", "DEFAULT", "ACTIVE", "ID"], environments.map((e) => [
+        e.name,
+        e.slug,
+        e.isDefault ? "★" : "",
+        e.isActive ? "yes" : "no",
+        e.id,
+    ]));
+}
+export async function handleEnvGet(idOrSlug, opts) {
+    const environmentId = await resolveEnvironmentId(idOrSlug);
+    const { environment } = await apiPost("environment/get", {
+        environmentId,
+    });
+    process.stdout.write(JSON.stringify(environment, null, 2) + "\n");
+    void opts;
+}
+export async function handleEnvCreate(name, opts) {
+    const slug = opts.slug ?? slugify(name);
+    const { environment } = await apiPost("environment/create", {
+        name,
+        slug,
+        description: opts.description ?? null,
+    });
+    process.stdout.write(`✓ created environment ${environment.name} (${environment.slug}) ${environment.id}\n`);
+}
+export async function handleEnvUpdate(idOrSlug, opts) {
+    const environmentId = await resolveEnvironmentId(idOrSlug);
+    const { environment } = await apiPost("environment/update", {
+        environmentId,
+        name: opts.name,
+        slug: opts.slug,
+        description: opts.description,
+        isActive: opts.active,
+    });
+    process.stdout.write(`✓ updated environment ${environment.name} (${environment.slug})\n`);
+}
+export async function handleEnvRemove(idOrSlug) {
+    const environmentId = await resolveEnvironmentId(idOrSlug);
+    await apiPost("environment/delete", { environmentId });
+    process.stdout.write(`✓ removed environment ${idOrSlug}\n`);
+}
+export async function handleEnvSetDefault(idOrSlug) {
+    const environmentId = await resolveEnvironmentId(idOrSlug);
+    const { environment } = await apiPost("environment/set-default", {
+        environmentId,
+    });
+    process.stdout.write(`✓ default environment: ${environment.name} (${environment.slug})\n`);
+}
+//# sourceMappingURL=env.js.map

package/dist/commands/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../src/commands/env.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAWzD,SAAS,OAAO,CAAC,IAAY;IAC3B,OAAO,IAAI;SACR,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAwB;IAC1D,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,OAAO,CAAiC,kBAAkB,EAAE,EAAE,CAAC,CAAC;IAC/F,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;QACnE,OAAO;IACT,CAAC;IACD,UAAU,CACR,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,CAAC,EAC3C,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QACtB,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;QACtB,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI;QACzB,CAAC,CAAC,EAAE;KACL,CAAC,CACH,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,QAAgB,EAAE,IAAwB;IAC3E,MAAM,aAAa,GAAG,MAAM,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAC3D,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,OAAO,CAA8B,iBAAiB,EAAE;QACpF,aAAa;KACd,CAAC,CAAC;IACH,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAClE,KAAK,IAAI,CAAC;AACZ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,IAAY,EACZ,IAA6C;IAE7C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,OAAO,CAA8B,oBAAoB,EAAE;QACvF,IAAI;QACJ,IAAI;QACJ,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,IAAI;KACtC,CAAC,CAAC;IACH,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,yBAAyB,WAAW,CAAC,IAAI,KAAK,WAAW,CAAC,IAAI,KAAK,WAAW,CAAC,EAAE,IAAI,CAAC,CAAC;AAC9G,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,QAAgB,EAChB,IAA8E;IAE9E,MAAM,aAAa,GAAG,MAAM,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAC3D,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,OAAO,CAA8B,oBAAoB,EAAE;QACvF,aAAa;QACb,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,QAAQ,EAAE,IAAI,CAAC,MAAM;KACtB,CAAC,CAAC;IACH,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,yBAAyB,WAAW,CAAC,IAAI,KAAK,WAAW,CAAC,IAAI,KAAK,CAAC,CAAC;AAC5F,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,QAAgB;IACpD,MAAM,aAAa,GAAG,MAAM,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAC3D,MAAM,OAAO,CAAkB,oBAAoB,EAAE,EAAE,aAAa,EAAE,CAAC,CAAC;IACxE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,yBAAyB,QAAQ,IAAI,CAAC,CAAC;AAC9D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,QAAgB;IACxD,MAAM,aAAa,GAAG,MAAM,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAC3D,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,OAAO,CAA8B,yBAAyB,EAAE;QAC5F,aAAa;KACd,CAAC,CAAC;IACH,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,0BAA0B,WAAW,CAAC,IAAI,KAAK,WAAW,CAAC,IAAI,KAAK,CAAC,CAAC;AAC7F,CAAC"}

package/dist/commands/graph.pull.d.ts

@@ -0,0 +1,15 @@
+export interface GraphPullOptions {
+    full?: boolean;
+    labels?: string;
+    noSystem?: boolean;
+    json?: boolean;
+    /**
+     * @internal test seam: override the DuckDB path.
+     * Pass `":memory:"` in tests to avoid touching the filesystem.
+     */
+    _duckdbPath?: string;
+}
+/** Canonical DuckDB path for a given workspace slug. */
+export declare function graphStorePath(workspaceSlug: string): string;
+export declare function handleGraphPull(opts: GraphPullOptions): Promise<void>;
+//# sourceMappingURL=graph.pull.d.ts.map

package/dist/commands/graph.pull.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.pull.d.ts","sourceRoot":"","sources":["../../src/commands/graph.pull.ts"],"names":[],"mappings":"AAyBA,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAoCD,wDAAwD;AACxD,wBAAgB,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAE5D;AAeD,wBAAsB,eAAe,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CA0H3E"}

package/dist/commands/graph.pull.js

@@ -0,0 +1,137 @@
+/**
+ * `oxagen graph pull` — download an incremental snapshot of the workspace
+ * knowledge graph into a local DuckDB replica.
+ *
+ * The replica lives at `~/.config/oxagen/graph/<workspaceSlug>.duckdb`.  A
+ * sync cursor (high-watermark string + counts) is persisted after every pull so
+ * subsequent runs only fetch what changed.  Pass `--full` to ignore the cursor
+ * and re-pull everything.
+ *
+ * Pagination: the pull loop calls `graph/export` with `limit=500` + an
+ * incrementing `offset` until `hasMore` is false, then persists the cursor
+ * returned by the last page.
+ */
+import { mkdirSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import { apiPost } from "../lib/api.js";
+import { getOrgId, getWorkspaceId } from "../lib/config.js";
+import { createGraphStore } from "@oxagen/engram";
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+const PAGE_SIZE = 500;
+/** Canonical DuckDB path for a given workspace slug. */
+export function graphStorePath(workspaceSlug) {
+    return join(homedir(), ".config", "oxagen", "graph", `${workspaceSlug}.duckdb`);
+}
+function splitCsv(value) {
+    if (!value)
+        return undefined;
+    const parts = value
+        .split(",")
+        .map((s) => s.trim())
+        .filter(Boolean);
+    return parts.length > 0 ? parts : undefined;
+}
+// ---------------------------------------------------------------------------
+// Handler
+// ---------------------------------------------------------------------------
+export async function handleGraphPull(opts) {
+    const org = getOrgId();
+    const workspace = getWorkspaceId();
+    if (!org || !workspace) {
+        process.stderr.write("Missing org or workspace. Run `oxagen config` or set " +
+            "OXAGEN_ORG_ID / OXAGEN_WORKSPACE_ID.\n");
+        process.exitCode = 1;
+        return;
+    }
+    // Resolve DuckDB path — test seam allows ":memory:" to skip filesystem ops.
+    const duckdbPath = opts._duckdbPath ?? graphStorePath(workspace);
+    if (duckdbPath !== ":memory:") {
+        mkdirSync(dirname(duckdbPath), { recursive: true });
+    }
+    const store = createGraphStore({ duckdbPath });
+    try {
+        // Determine the starting cursor (skip if --full).
+        let updatedAfter;
+        if (!opts.full) {
+            const existing = await store.getCursor(org, workspace);
+            updatedAfter = existing?.cursor;
+        }
+        const labelArray = splitCsv(opts.labels);
+        const isSystem = opts.noSystem ? false : undefined;
+        // Pull loop: paginate until hasMore=false.
+        let offset = 0;
+        let totalNodes = 0;
+        let totalEdges = 0;
+        let newCursor;
+        while (true) {
+            const page = await apiPost("graph/export", {
+                updatedAfter,
+                labels: labelArray,
+                isSystem,
+                limit: PAGE_SIZE,
+                offset,
+            });
+            // Enrich remote nodes/edges with local org+workspace keys.
+            const nodes = page.nodes.map((n) => ({
+                id: n.id,
+                labels: n.labels,
+                displayName: n.displayName,
+                properties: n.properties,
+                sourceId: n.sourceId,
+                isSystem: n.isSystem ?? false,
+                updatedAt: n.updatedAt ?? new Date().toISOString(),
+                org,
+                workspace,
+            }));
+            const edges = page.edges.map((e) => ({
+                id: e.id,
+                sourceId: e.sourceId,
+                targetId: e.targetId,
+                type: e.type,
+                properties: e.properties,
+                inferred: e.inferred ?? false,
+                org,
+                workspace,
+            }));
+            await store.upsertNodes(nodes);
+            await store.upsertEdges(edges);
+            totalNodes += nodes.length;
+            totalEdges += edges.length;
+            if (page.cursor)
+                newCursor = page.cursor;
+            process.stderr.write(`  Pulled ${totalNodes} nodes, ${totalEdges} edges (offset=${offset})...\r`);
+            if (!page.hasMore)
+                break;
+            offset += PAGE_SIZE;
+        }
+        // Clear the progress line.
+        process.stderr.write("\n");
+        // Persist the cursor after a successful pull.
+        const finalStats = await store.stats(org, workspace);
+        const cursorToStore = newCursor ?? new Date().toISOString();
+        await store.setCursor(org, workspace, cursorToStore, finalStats.nodeCount, finalStats.edgeCount);
+        // Report summary.
+        const summary = {
+            pulled: { nodes: totalNodes, edges: totalEdges },
+            total: { nodes: finalStats.nodeCount, edges: finalStats.edgeCount },
+            cursor: cursorToStore,
+            path: duckdbPath,
+        };
+        if (opts.json) {
+            process.stdout.write(JSON.stringify(summary, null, 2) + "\n");
+        }
+        else {
+            process.stdout.write(`Pulled ${totalNodes} node(s) and ${totalEdges} edge(s) this run.\n` +
+                `Total in local store: ${finalStats.nodeCount} nodes, ${finalStats.edgeCount} edges.\n` +
+                `Cursor: ${cursorToStore}\n` +
+                `Path: ${duckdbPath}\n`);
+        }
+    }
+    finally {
+        await store.close();
+    }
+}
+//# sourceMappingURL=graph.pull.js.map

package/dist/commands/graph.pull.js.map

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

package/dist/commands/graph.search.d.ts

@@ -0,0 +1,10 @@
+export interface GraphSearchOptions {
+    query: string;
+    kinds?: string;
+    labels?: string;
+    limit?: string;
+    /** commander: `--system` => true, `--no-system` => false, omitted => undefined. */
+    system?: boolean;
+}
+export declare function handleGraphSearch(opts: GraphSearchOptions): Promise<void>;
+//# sourceMappingURL=graph.search.d.ts.map

package/dist/commands/graph.search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.search.d.ts","sourceRoot":"","sources":["../../src/commands/graph.search.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mFAAmF;IACnF,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAWD,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAa/E"}

package/dist/commands/graph.search.js

@@ -0,0 +1,25 @@
+/** `oxagen graph search …` — unified natural-language (vector) search across the
+ *  entire knowledge graph, via the org-scoped `/graph/search` API. */
+import { apiPost } from "../lib/api.js";
+function splitCsv(value) {
+    if (!value)
+        return undefined;
+    const parts = value
+        .split(",")
+        .map((s) => s.trim())
+        .filter(Boolean);
+    return parts.length > 0 ? parts : undefined;
+}
+export async function handleGraphSearch(opts) {
+    // --system => isSystem=true, --no-system => false, neither => undefined (both).
+    const isSystem = opts.system === true ? true : opts.system === false ? false : undefined;
+    const result = await apiPost("graph/search", {
+        query: opts.query,
+        kinds: splitCsv(opts.kinds),
+        labels: splitCsv(opts.labels),
+        limit: opts.limit ? parseInt(opts.limit, 10) : 10,
+        isSystem,
+    });
+    process.stdout.write(JSON.stringify(result, null, 2) + "\n");
+}
+//# sourceMappingURL=graph.search.js.map

package/dist/commands/graph.search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.search.js","sourceRoot":"","sources":["../../src/commands/graph.search.ts"],"names":[],"mappings":"AAAA;sEACsE;AACtE,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAWxC,SAAS,QAAQ,CAAC,KAAyB;IACzC,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,MAAM,KAAK,GAAG,KAAK;SAChB,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACpB,MAAM,CAAC,OAAO,CAAC,CAAC;IACnB,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AAC9C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAwB;IAC9D,gFAAgF;IAChF,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IAEzF,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,cAAc,EAAE;QAC3C,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC;QAC3B,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC;QAC7B,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE;QACjD,QAAQ;KACT,CAAC,CAAC;IAEH,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;AAC/D,CAAC"}

package/dist/commands/graph.status.d.ts

@@ -0,0 +1,10 @@
+export interface GraphStatusOptions {
+    json?: boolean;
+    /**
+     * @internal test seam: override the DuckDB path.
+     * Pass `":memory:"` in tests.
+     */
+    _duckdbPath?: string;
+}
+export declare function handleGraphStatus(opts: GraphStatusOptions): Promise<void>;
+//# sourceMappingURL=graph.status.d.ts.map

package/dist/commands/graph.status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.status.d.ts","sourceRoot":"","sources":["../../src/commands/graph.status.ts"],"names":[],"mappings":"AAgBA,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAMD,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,IAAI,CAAC,CAuEf"}

package/dist/commands/graph.status.js

@@ -0,0 +1,75 @@
+/**
+ * `oxagen graph status` — show the state of the local workspace-graph replica.
+ *
+ * Reports node/edge counts, the current sync cursor (high-watermark), when it
+ * was last synced, and the local DuckDB path.  If no pull has been run yet,
+ * says so clearly.
+ */
+import { existsSync } from "node:fs";
+import { getOrgId, getWorkspaceId } from "../lib/config.js";
+import { createGraphStore } from "@oxagen/engram";
+import { graphStorePath } from "./graph.pull.js";
+// ---------------------------------------------------------------------------
+// Handler
+// ---------------------------------------------------------------------------
+export async function handleGraphStatus(opts) {
+    const org = getOrgId();
+    const workspace = getWorkspaceId();
+    if (!org || !workspace) {
+        process.stderr.write("Missing org or workspace. Run `oxagen config` or set " +
+            "OXAGEN_ORG_ID / OXAGEN_WORKSPACE_ID.\n");
+        process.exitCode = 1;
+        return;
+    }
+    const duckdbPath = opts._duckdbPath ?? graphStorePath(workspace);
+    const pathIsMemory = duckdbPath === ":memory:";
+    // If the file hasn't been created yet, tell the user to run pull first.
+    if (!pathIsMemory && !existsSync(duckdbPath)) {
+        if (opts.json) {
+            process.stdout.write(JSON.stringify({
+                pulled: false,
+                path: duckdbPath,
+                org,
+                workspace,
+            }) + "\n");
+        }
+        else {
+            process.stdout.write(`No local graph copy found.\n` +
+                `Run \`oxagen graph pull\` to download the workspace graph.\n` +
+                `Expected path: ${duckdbPath}\n`);
+        }
+        return;
+    }
+    const store = createGraphStore({ duckdbPath });
+    try {
+        const stats = await store.stats(org, workspace);
+        if (opts.json) {
+            process.stdout.write(JSON.stringify({
+                pulled: true,
+                nodeCount: stats.nodeCount,
+                edgeCount: stats.edgeCount,
+                cursor: stats.cursor,
+                syncedAt: stats.syncedAt,
+                path: duckdbPath,
+                org,
+                workspace,
+            }) + "\n");
+        }
+        else {
+            const syncedAtStr = stats.syncedAt
+                ? new Date(stats.syncedAt).toISOString()
+                : "(never)";
+            process.stdout.write(`Nodes:       ${stats.nodeCount}\n` +
+                `Edges:       ${stats.edgeCount}\n` +
+                `Cursor:      ${stats.cursor ?? "(none)"}\n` +
+                `Last synced: ${syncedAtStr}\n` +
+                `Org:         ${org}\n` +
+                `Workspace:   ${workspace}\n` +
+                `Path:        ${duckdbPath}\n`);
+        }
+    }
+    finally {
+        await store.close();
+    }
+}
+//# sourceMappingURL=graph.status.js.map

package/dist/commands/graph.status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.status.js","sourceRoot":"","sources":["../../src/commands/graph.status.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAejD,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,IAAwB;IAExB,MAAM,GAAG,GAAG,QAAQ,EAAE,CAAC;IACvB,MAAM,SAAS,GAAG,cAAc,EAAE,CAAC;IAEnC,IAAI,CAAC,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QACvB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,uDAAuD;YACrD,wCAAwC,CAC3C,CAAC;QACF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO;IACT,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,IAAI,cAAc,CAAC,SAAS,CAAC,CAAC;IACjE,MAAM,YAAY,GAAG,UAAU,KAAK,UAAU,CAAC;IAE/C,wEAAwE;IACxE,IAAI,CAAC,YAAY,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC7C,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,IAAI,CAAC,SAAS,CAAC;gBACb,MAAM,EAAE,KAAK;gBACb,IAAI,EAAE,UAAU;gBAChB,GAAG;gBACH,SAAS;aACV,CAAC,GAAG,IAAI,CACV,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,8BAA8B;gBAC5B,8DAA8D;gBAC9D,kBAAkB,UAAU,IAAI,CACnC,CAAC;QACJ,CAAC;QACD,OAAO;IACT,CAAC;IAED,MAAM,KAAK,GAAG,gBAAgB,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC;IAC/C,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QAEhD,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,IAAI,CAAC,SAAS,CAAC;gBACb,MAAM,EAAE,IAAI;gBACZ,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,IAAI,EAAE,UAAU;gBAChB,GAAG;gBACH,SAAS;aACV,CAAC,GAAG,IAAI,CACV,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,MAAM,WAAW,GAAG,KAAK,CAAC,QAAQ;gBAChC,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE;gBACxC,CAAC,CAAC,SAAS,CAAC;YACd,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,gBAAgB,KAAK,CAAC,SAAS,IAAI;gBACjC,gBAAgB,KAAK,CAAC,SAAS,IAAI;gBACnC,gBAAgB,KAAK,CAAC,MAAM,IAAI,QAAQ,IAAI;gBAC5C,gBAAgB,WAAW,IAAI;gBAC/B,gBAAgB,GAAG,IAAI;gBACvB,gBAAgB,SAAS,IAAI;gBAC7B,gBAAgB,UAAU,IAAI,CACjC,CAAC;QACJ,CAAC;IACH,CAAC;YAAS,CAAC;QACT,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC;IACtB,CAAC;AACH,CAAC"}

package/dist/commands/mcp.add.d.ts

@@ -0,0 +1,13 @@
+/**
+ * `oxagen mcp add <name>` — Add an MCP server to the file-based configuration.
+ *
+ * Writes a server entry to the appropriate scope file:
+ *   --scope user    → ~/.config/oxagen/settings.json
+ *   --scope project → .oxagen/settings.json (default)
+ *   --scope local   → .oxagen/settings.local.json
+ *
+ * Validates against managed policy before writing.
+ */
+import { Command } from "commander";
+export declare const mcpAddCommand: Command;
+//# sourceMappingURL=mcp.add.d.ts.map

package/dist/commands/mcp.add.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.add.d.ts","sourceRoot":"","sources":["../../src/commands/mcp.add.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA8BpC,eAAO,MAAM,aAAa,SAuFtB,CAAC"}