backpack-ontology 0.7.13 → 0.8.0

package/dist/cli/commands/kbs.js

@@ -0,0 +1,258 @@
+// `bp kbs <verb>` — canonical form. Read-only in Step 2 (list, get).
+import * as fs from "node:fs/promises";
+import * as os from "node:os";
+import * as path from "node:path";
+import { spawn } from "node:child_process";
+import { flagString } from "../parser.js";
+import { runLs } from "./ls.js";
+import { resolveFormat, emitOne } from "../output.js";
+import { getKB, saveKB, deleteKB } from "../../ops/kb.js";
+import { runMoveKB } from "./cloud-admin.js";
+import { confirm } from "../util/confirm.js";
+import { red, green, dim, bold, yellow } from "../colors.js";
+export async function runKbs(args) {
+    const verb = args.positional[0];
+    if (!verb) {
+        process.stderr.write(`bp kbs: verb required.\nusage: bp kbs <list|get> [args]\n`);
+        return 1;
+    }
+    const sub = { positional: args.positional.slice(1), flags: args.flags, rest: args.rest };
+    switch (verb) {
+        case "list":
+        case "ls":
+            return runLs({ ...sub, positional: ["kbs", ...sub.positional] });
+        case "get":
+        case "cat":
+            return runKbGet(sub);
+        case "create":
+        case "new":
+            return runKbCreate(sub);
+        case "delete":
+        case "rm":
+        case "remove":
+            return runKbDelete(sub);
+        case "edit":
+            return runKbEdit(sub);
+        case "move":
+        case "mv-to":
+            return runMoveKB(sub);
+        default:
+            process.stderr.write(`bp kbs: unknown verb "${verb}". try list, get, create, edit, delete, or move.\n`);
+            return 1;
+    }
+}
+async function runKbCreate(args) {
+    const file = flagString(args, "f", "file", "from-file");
+    const titleArg = flagString(args, "title", "t");
+    const contentArg = flagString(args, "content");
+    const collection = flagString(args, "collection", "c");
+    const tagsRaw = flagString(args, "tags");
+    const tags = tagsRaw ? tagsRaw.split(",").map((t) => t.trim()).filter(Boolean) : undefined;
+    const sourceRaw = flagString(args, "from-graphs");
+    const sourceGraphs = sourceRaw ? sourceRaw.split(",").map((s) => s.trim()).filter(Boolean) : undefined;
+    if (file && contentArg !== undefined) {
+        process.stderr.write(`bp kbs create: pass either -f <file> or --content, not both.\n`);
+        return 1;
+    }
+    let title;
+    let content;
+    if (file) {
+        const raw = await fs.readFile(file, "utf8").catch((err) => {
+            process.stderr.write(`${red("✗")} could not read ${file}: ${err.message}\n`);
+            return null;
+        });
+        if (raw === null)
+            return 1;
+        // Strip leading YAML front-matter if present. DocumentStore re-prepends
+        // its own front-matter on save; without this strip the file ends up
+        // with two `---` blocks and the user's metadata silently lost.
+        const stripped = stripLeadingFrontmatter(raw);
+        content = stripped.content;
+        // Honor the file's `title:` if the CLI didn't override.
+        title = titleArg ?? stripped.frontmatter.title ?? path.basename(file, path.extname(file));
+    }
+    else {
+        if (!titleArg) {
+            process.stderr.write(`bp kbs create: pass either -f <file> or --title <title> --content <text>.\n`);
+            return 1;
+        }
+        title = titleArg;
+        if (contentArg === undefined) {
+            process.stderr.write(`bp kbs create: --content is required when not using -f <file>.\n`);
+            return 1;
+        }
+        content = contentArg;
+    }
+    try {
+        const { id, created } = await saveKB({ title, content, tags, sourceGraphs, collection });
+        process.stdout.write(`${green("✓")} ${created ? "created" : "updated"} ${bold(title)} ${dim(`(${id})`)}\n`);
+        return 0;
+    }
+    catch (err) {
+        process.stderr.write(`${red("✗")} ${err.message}\n`);
+        return 1;
+    }
+}
+/** Pull leading YAML front-matter off a file body. Tolerant — only
+ * recognizes the literal `---\n…\n---\n` shape; anything else is
+ * returned as-is. Does NOT parse arbitrary YAML — we only care about
+ * a few common keys (title, tags) and treat the rest as opaque. */
+function stripLeadingFrontmatter(raw) {
+    if (!raw.startsWith("---"))
+        return { content: raw, frontmatter: {} };
+    const endMatch = raw.match(/^---\n([\s\S]*?)\n---\n?/);
+    if (!endMatch)
+        return { content: raw, frontmatter: {} };
+    const block = endMatch[1];
+    const rest = raw.slice(endMatch[0].length);
+    const fm = {};
+    for (const line of block.split("\n")) {
+        const m = line.match(/^([a-zA-Z0-9_-]+)\s*:\s*(.*)$/);
+        if (!m)
+            continue;
+        const k = m[1];
+        const v = m[2].trim();
+        if (k === "title") {
+            fm.title = v.replace(/^["']|["']$/g, "");
+        }
+        else if (k === "tags") {
+            // Accept "tags: a, b, c" or "tags: [a, b]" — best-effort.
+            const cleaned = v.replace(/^\[|\]$/g, "");
+            fm.tags = cleaned.split(",").map((t) => t.trim().replace(/^["']|["']$/g, "")).filter(Boolean);
+        }
+    }
+    return { content: rest, frontmatter: fm };
+}
+async function runKbDelete(args) {
+    const id = args.positional[0];
+    if (!id) {
+        process.stderr.write(`bp kbs delete: doc id required.\nusage: bp kbs delete <id> [-y]\n`);
+        return 1;
+    }
+    let existing;
+    try {
+        existing = await getKB(id);
+    }
+    catch (err) {
+        process.stderr.write(`${red("✗")} ${err.message}\n`);
+        return 1;
+    }
+    if (!existing) {
+        process.stderr.write(`${red("✗")} kb doc "${id}" not found in the current scope.\n`);
+        return 1;
+    }
+    const ok = await confirm(`delete ${bold(existing.title)} (${id})? [y/N] `, args);
+    if (!ok) {
+        process.stderr.write(dim("aborted.\n"));
+        return 0;
+    }
+    try {
+        await deleteKB(id);
+        process.stdout.write(`${green("✓")} deleted ${bold(existing.title)}\n`);
+        return 0;
+    }
+    catch (err) {
+        process.stderr.write(`${red("✗")} ${err.message}\n`);
+        return 1;
+    }
+}
+async function runKbEdit(args) {
+    const id = args.positional[0];
+    if (!id) {
+        process.stderr.write(`bp kbs edit: doc id required.\n`);
+        return 1;
+    }
+    let doc;
+    try {
+        doc = await getKB(id);
+    }
+    catch (err) {
+        process.stderr.write(`${red("✗")} ${err.message}\n`);
+        return 1;
+    }
+    if (!doc) {
+        process.stderr.write(`${red("✗")} kb doc "${id}" not found.\n`);
+        return 1;
+    }
+    const editorCmd = process.env.EDITOR || process.env.VISUAL || (process.platform === "win32" ? "notepad" : "vi");
+    const tokens = editorCmd.trim().split(/\s+/).filter(Boolean);
+    const editor = tokens[0];
+    const editorArgs = tokens.slice(1);
+    const userTmpDir = path.join(os.tmpdir(), `bp-${process.getuid?.() ?? "u"}`);
+    await fs.mkdir(userTmpDir, { recursive: true });
+    const tmpFile = path.join(userTmpDir, `kb-edit-${process.pid}-${Date.now()}.md`);
+    const original = doc.content;
+    await fs.writeFile(tmpFile, original, { mode: 0o600 });
+    let cleanedUp = false;
+    let interrupted = false;
+    const cleanup = async () => {
+        if (cleanedUp)
+            return;
+        cleanedUp = true;
+        await fs.unlink(tmpFile).catch(() => { });
+    };
+    const onSig = () => {
+        interrupted = true;
+        process.exitCode = 130;
+    };
+    process.once("SIGINT", onSig);
+    process.once("SIGTERM", onSig);
+    try {
+        const exitCode = await new Promise((resolve, reject) => {
+            const child = spawn(editor, [...editorArgs, tmpFile], { stdio: "inherit" });
+            child.on("error", reject);
+            child.on("exit", (code) => resolve(code ?? 0));
+        });
+        if (interrupted)
+            return 130;
+        if (exitCode !== 0) {
+            process.stderr.write(`${yellow("!")} editor exited ${exitCode} — changes discarded.\n`);
+            return 1;
+        }
+        const updated = await fs.readFile(tmpFile, "utf8");
+        if (updated === original) {
+            process.stdout.write(dim("no changes.\n"));
+            return 0;
+        }
+        await saveKB({ id, title: doc.title, content: updated, tags: doc.tags, sourceGraphs: doc.sourceGraphs, collection: doc.collection });
+        process.stdout.write(`${green("✓")} updated ${bold(doc.title)}\n`);
+        return 0;
+    }
+    catch (err) {
+        process.stderr.write(`${red("✗")} ${err.message}\n`);
+        return 1;
+    }
+    finally {
+        process.removeListener("SIGINT", onSig);
+        process.removeListener("SIGTERM", onSig);
+        await cleanup();
+    }
+}
+async function runKbGet(args) {
+    const id = args.positional[0];
+    if (!id) {
+        process.stderr.write(`bp kbs get: doc id required.\n`);
+        return 1;
+    }
+    try {
+        const doc = await getKB(id);
+        if (!doc) {
+            process.stderr.write(`${red("✗")} kb doc "${id}" not found in the current scope.\n`);
+            return 1;
+        }
+        const fmt = resolveFormat(args.flags);
+        if (fmt === "human") {
+            // Print just the content for piping; metadata via --json
+            process.stdout.write(doc.content + (doc.content.endsWith("\n") ? "" : "\n"));
+        }
+        else {
+            emitOne(doc, { format: fmt });
+        }
+        return 0;
+    }
+    catch (err) {
+        process.stderr.write(`${red("✗")} ${err.message}\n`);
+        return 1;
+    }
+}
+//# sourceMappingURL=kbs.js.map

package/dist/cli/commands/kbs.js.map

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

package/dist/cli/commands/ls.d.ts

@@ -0,0 +1,3 @@
+import { ParsedArgs } from "../parser.js";
+export declare function runLs(args: ParsedArgs): Promise<number>;
+//# sourceMappingURL=ls.d.ts.map

package/dist/cli/commands/ls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ls.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/ls.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAe1C,wBAAsB,KAAK,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAmF7D"}

package/dist/cli/commands/ls.js

@@ -0,0 +1,90 @@
+// `bp ls [resource]` — the daily-driver list command. Defaults to graphs.
+// `bp ls graphs|kbs|containers` selects a different resource. Plural and
+// singular both accepted (`graphs`/`graph`, `kbs`/`kb`, `containers`/`container`).
+import { resolveFormat, emitList } from "../output.js";
+import { dim, red, yellow } from "../colors.js";
+import { listGraphs } from "../../ops/graphs.js";
+import { listContainers } from "../../ops/containers.js";
+import { listKB } from "../../ops/kb.js";
+import { describeContext, getContext } from "../../ops/context.js";
+import { resolveCloudToken } from "../../ops/auth.js";
+const RESOURCE_ALIASES = {
+    graphs: "graphs", graph: "graphs", g: "graphs",
+    containers: "containers", container: "containers", c: "containers", buckets: "containers",
+    kbs: "kbs", kb: "kbs", docs: "kbs", doc: "kbs",
+};
+export async function runLs(args) {
+    const target = args.positional[0] ?? "graphs";
+    const resource = RESOURCE_ALIASES[target.toLowerCase()];
+    if (!resource) {
+        process.stderr.write(`bp ls: unknown resource "${target}". try graphs, containers, or kbs.\n`);
+        return 1;
+    }
+    const fmt = { format: resolveFormat(args.flags) };
+    // For cloud listings, do an upfront auth check so the user gets a
+    // clear "not signed in" message rather than a generic fetch failure.
+    // Returns the same exit code as every other auth-failure path (1) —
+    // the entire CLI uses 0/1 like kubectl, not the kludge of a third
+    // code that scripts would have to special-case for one command.
+    const ctx = await getContext();
+    const needsCloud = ctx.source === "cloud" || resource === "containers";
+    if (needsCloud) {
+        const token = await resolveCloudToken();
+        if (!token) {
+            process.stderr.write(`${yellow("!")} not signed in. run \`bp login\` first to list ${resource}.\n`);
+            return 1;
+        }
+    }
+    try {
+        if (resource === "graphs") {
+            const rows = await listGraphs();
+            emitList({
+                rows,
+                pluralLabel: "graphs",
+                empty: `no graphs in ${describeContext(await getContext())}.`,
+                cols: [
+                    { header: "NAME", get: (r) => r.name, max: 40 },
+                    { header: "NODES", get: (r) => String(r.nodeCount), numeric: true },
+                    { header: "EDGES", get: (r) => String(r.edgeCount), numeric: true },
+                    { header: "FLAGS", get: (r) => r.encrypted ? yellow("encrypted") : "", wide: true },
+                    { header: "DESCRIPTION", get: (r) => r.description ?? "", dim: true, max: 60, wide: true },
+                ],
+            }, fmt);
+            return 0;
+        }
+        if (resource === "containers") {
+            const rows = await listContainers();
+            emitList({
+                rows,
+                pluralLabel: "containers",
+                empty: dim("no cloud containers (sign in and try again)."),
+                cols: [
+                    { header: "NAME", get: (r) => r.name, max: 32 },
+                    { header: "ORIGIN", get: (r) => r.origin_kind === "local" ? `device${r.origin_device_name ? ` · ${r.origin_device_name}` : ""}` : "cloud" },
+                    { header: "ID", get: (r) => r.id, dim: true, wide: true },
+                    { header: "TAGS", get: (r) => (r.tags ?? []).join(",") || "", dim: true, wide: true },
+                ],
+            }, fmt);
+            return 0;
+        }
+        // kbs
+        const rows = await listKB();
+        emitList({
+            rows,
+            pluralLabel: "kbs",
+            empty: dim("no KB documents in the current scope."),
+            cols: [
+                { header: "ID", get: (r) => r.id, max: 40 },
+                { header: "TITLE", get: (r) => r.title, max: 50 },
+                { header: "TAGS", get: (r) => r.tags.join(","), dim: true, wide: true },
+                { header: "GRAPHS", get: (r) => r.sourceGraphs.join(","), dim: true, wide: true },
+            ],
+        }, fmt);
+        return 0;
+    }
+    catch (err) {
+        process.stderr.write(`${red("✗")} ${err.message}\n`);
+        return 1;
+    }
+}
+//# sourceMappingURL=ls.js.map

package/dist/cli/commands/ls.js.map

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

package/dist/cli/commands/mutate.d.ts

@@ -0,0 +1,7 @@
+import { ParsedArgs } from "../parser.js";
+export declare function runCreate(args: ParsedArgs): Promise<number>;
+export declare function runDelete(args: ParsedArgs): Promise<number>;
+export declare function runRename(args: ParsedArgs): Promise<number>;
+export declare function runApply(args: ParsedArgs): Promise<number>;
+export declare function runEdit(args: ParsedArgs): Promise<number>;
+//# sourceMappingURL=mutate.d.ts.map

package/dist/cli/commands/mutate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutate.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/mutate.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,UAAU,EAAc,MAAM,cAAc,CAAC;AAatD,wBAAsB,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAqCjE;AAED,wBAAsB,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAgCjE;AAED,wBAAsB,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAkBjE;AAED,wBAAsB,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAoChE;AAED,wBAAsB,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CA8F/D"}

package/dist/cli/commands/mutate.js

@@ -0,0 +1,268 @@
+// Mutating verbs: create, delete, rename, apply, edit. Shared by both
+// the canonical (`bp graphs <verb>`) and shortcut (`bp rm`, `bp mv`)
+// command surfaces.
+import * as fs from "node:fs/promises";
+import * as os from "node:os";
+import * as path from "node:path";
+import { spawn } from "node:child_process";
+import { flagString } from "../parser.js";
+import { createGraph, deleteGraph, renameGraph, applyGraph, getGraph, getGraphSummary, } from "../../ops/graphs.js";
+import { red, yellow, green, dim, bold } from "../colors.js";
+import { confirm } from "../util/confirm.js";
+export async function runCreate(args) {
+    const name = args.positional[0];
+    if (!name) {
+        process.stderr.write(`bp graphs create: name required.\nusage: bp graphs create <name> [--description=...] [--from-file=path.json]\n`);
+        return 1;
+    }
+    const fromFile = flagString(args, "from-file", "f");
+    const description = flagString(args, "description", "d") ?? "";
+    try {
+        // Reject if a graph by this name already exists. `create` is not an
+        // upsert — `bp graphs apply -f file` is the upsert verb. Without
+        // this check, --from-file could silently overwrite an existing graph.
+        const existing = await getGraphSummary(name).catch(() => null);
+        if (existing) {
+            process.stderr.write(`${red("✗")} graph "${name}" already exists. use \`bp graphs apply\` to overwrite.\n`);
+            return 1;
+        }
+        if (fromFile) {
+            const raw = await fs.readFile(fromFile, "utf8");
+            const data = JSON.parse(raw);
+            // Reject mismatch between the requested name and the file's metadata
+            // unless the file's metadata is missing (legitimate template case).
+            if (data.metadata?.name && data.metadata.name !== name) {
+                process.stderr.write(`${red("✗")} file's metadata.name is "${data.metadata.name}" but the create target is "${name}". rename in the file or call \`bp graphs apply\` instead.\n`);
+                return 1;
+            }
+            await applyGraph(name, data);
+            process.stdout.write(`${green("✓")} created ${bold(name)} from ${dim(fromFile)}\n`);
+        }
+        else {
+            await createGraph(name, { description });
+            process.stdout.write(`${green("✓")} created ${bold(name)}\n`);
+        }
+        return 0;
+    }
+    catch (err) {
+        process.stderr.write(`${red("✗")} ${err.message}\n`);
+        return 1;
+    }
+}
+export async function runDelete(args) {
+    const name = args.positional[0];
+    if (!name) {
+        process.stderr.write(`bp graphs delete: name required.\nusage: bp graphs delete <name> [-y]\n`);
+        return 1;
+    }
+    // Existence check first so we don't prompt for nothing.
+    let summary;
+    try {
+        summary = await getGraphSummary(name);
+    }
+    catch (err) {
+        process.stderr.write(`${red("✗")} ${err.message}\n`);
+        return 1;
+    }
+    if (!summary) {
+        process.stderr.write(`${red("✗")} graph "${name}" not found in the current scope.\n`);
+        return 1;
+    }
+    const ok = await confirm(`delete ${bold(name)} (${summary.nodeCount} nodes, ${summary.edgeCount} edges)? [y/N] `, args);
+    if (!ok) {
+        // User-cancelled — exit 0. Scripts wrapping `bp rm` with `set -e`
+        // shouldn't treat a deliberate "no" as a failure.
+        process.stdout.write(dim("aborted.\n"));
+        return 0;
+    }
+    try {
+        await deleteGraph(name);
+        process.stdout.write(`${green("✓")} deleted ${bold(name)}\n`);
+        return 0;
+    }
+    catch (err) {
+        process.stderr.write(`${red("✗")} ${err.message}\n`);
+        return 1;
+    }
+}
+export async function runRename(args) {
+    const [oldName, newName] = args.positional;
+    if (!oldName || !newName) {
+        process.stderr.write(`bp graphs rename: old + new names required.\nusage: bp graphs rename <old> <new>\n`);
+        return 1;
+    }
+    if (oldName === newName) {
+        process.stderr.write(`bp graphs rename: old and new names are the same.\n`);
+        return 1;
+    }
+    try {
+        await renameGraph(oldName, newName);
+        process.stdout.write(`${green("✓")} ${bold(oldName)} → ${bold(newName)}\n`);
+        return 0;
+    }
+    catch (err) {
+        process.stderr.write(`${red("✗")} ${err.message}\n`);
+        return 1;
+    }
+}
+export async function runApply(args) {
+    const file = flagString(args, "f", "file", "from-file");
+    if (!file) {
+        process.stderr.write(`bp graphs apply: -f <file> required.\nusage: bp graphs apply -f <file.json>\n`);
+        return 1;
+    }
+    let data;
+    try {
+        const raw = await fs.readFile(file, "utf8");
+        data = JSON.parse(raw);
+    }
+    catch (err) {
+        process.stderr.write(`${red("✗")} could not read ${file}: ${err.message}\n`);
+        return 1;
+    }
+    const explicit = args.positional[0];
+    const fileName = data.metadata?.name;
+    // If both are present and disagree, refuse: silently using the
+    // command-line name would rewrite the file's identity inside the graph
+    // store and confuse anyone tracking provenance.
+    if (explicit && fileName && explicit !== fileName) {
+        process.stderr.write(`${red("✗")} name mismatch: argument is "${explicit}" but file's metadata.name is "${fileName}". pick one or fix the file.\n`);
+        return 1;
+    }
+    const name = explicit ?? fileName;
+    if (!name) {
+        process.stderr.write(`bp graphs apply: graph name not in file metadata; pass it as the first positional arg.\n`);
+        return 1;
+    }
+    try {
+        const { created } = await applyGraph(name, data);
+        process.stdout.write(`${green("✓")} ${created ? "created" : "applied"} ${bold(name)} (${data.nodes?.length ?? 0} nodes, ${data.edges?.length ?? 0} edges)\n`);
+        return 0;
+    }
+    catch (err) {
+        process.stderr.write(`${red("✗")} ${err.message}\n`);
+        return 1;
+    }
+}
+export async function runEdit(args) {
+    const name = args.positional[0];
+    if (!name) {
+        process.stderr.write(`bp graphs edit: name required.\nusage: bp graphs edit <name>\n`);
+        return 1;
+    }
+    let result;
+    try {
+        result = await getGraph(name);
+    }
+    catch (err) {
+        process.stderr.write(`${red("✗")} ${err.message}\n`);
+        return 1;
+    }
+    if (result.kind === "missing") {
+        process.stderr.write(`${red("✗")} graph "${name}" not found in the current scope.\n`);
+        return 1;
+    }
+    if (result.kind === "encrypted") {
+        process.stderr.write(`${yellow("!")} graph "${name}" is encrypted — cannot edit from the CLI.\n`);
+        return 1;
+    }
+    // Resolve $EDITOR. Common values like `code --wait` are
+    // command-and-args, not a single binary path; split on whitespace
+    // (good enough — anything more exotic the user can wrap in a script).
+    const editorCmd = process.env.EDITOR || process.env.VISUAL || (process.platform === "win32" ? "notepad" : "vi");
+    const editorTokens = editorCmd.trim().split(/\s+/).filter(Boolean);
+    const editor = editorTokens[0];
+    const editorArgs = editorTokens.slice(1);
+    // Per-user tmpdir + 0600 mode so a SIGKILL-orphaned file doesn't leak
+    // graph contents to other users on shared machines.
+    const userTmpDir = path.join(os.tmpdir(), `bp-${process.getuid?.() ?? "u"}`);
+    await fs.mkdir(userTmpDir, { recursive: true });
+    const tmpFile = path.join(userTmpDir, `edit-${process.pid}-${Date.now()}.json`);
+    const original = JSON.stringify(result.data, null, 2);
+    await fs.writeFile(tmpFile, original, { mode: 0o600 });
+    // Make a best-effort cleanup on SIGINT so a Ctrl-C mid-edit doesn't
+    // strand the tmp file. Pulled into a flag so the finally clause and
+    // the signal handler don't double-unlink.
+    let cleanedUp = false;
+    let interrupted = false;
+    const cleanup = async () => {
+        if (cleanedUp)
+            return;
+        cleanedUp = true;
+        await fs.unlink(tmpFile).catch(() => { });
+    };
+    const onSig = () => {
+        interrupted = true;
+        process.exitCode = 130;
+    };
+    process.once("SIGINT", onSig);
+    process.once("SIGTERM", onSig);
+    try {
+        const exitCode = await new Promise((resolve, reject) => {
+            const child = spawn(editor, [...editorArgs, tmpFile], { stdio: "inherit" });
+            child.on("error", reject);
+            child.on("exit", (code) => resolve(code ?? 0));
+        });
+        if (interrupted)
+            return 130;
+        if (exitCode !== 0) {
+            process.stderr.write(`${yellow("!")} editor exited ${exitCode} — changes discarded.\n`);
+            return 1;
+        }
+        const updated = await fs.readFile(tmpFile, "utf8");
+        let parsed;
+        try {
+            parsed = JSON.parse(updated);
+        }
+        catch (err) {
+            process.stderr.write(`${red("✗")} edited file is not valid JSON: ${err.message}\n`);
+            process.stderr.write(dim(`  preserved at ${tmpFile}\n`));
+            cleanedUp = true; // skip cleanup so the user can recover
+            return 1;
+        }
+        // Structural diff so vim's trailing-newline doesn't trigger a false
+        // dirty (which would otherwise burn an event-source write for a
+        // semantic no-op).
+        const beforeKey = canonicalKey(result.data);
+        const afterKey = canonicalKey(parsed);
+        if (beforeKey === afterKey) {
+            process.stdout.write(dim("no changes.\n"));
+            return 0;
+        }
+        await applyGraph(name, parsed);
+        process.stdout.write(`${green("✓")} updated ${bold(name)}\n`);
+        return 0;
+    }
+    catch (err) {
+        process.stderr.write(`${red("✗")} ${err.message}\n`);
+        return 1;
+    }
+    finally {
+        process.removeListener("SIGINT", onSig);
+        process.removeListener("SIGTERM", onSig);
+        await cleanup();
+    }
+}
+/** Canonical-form key used to detect semantic changes between two
+ * graph payloads. Stable property ordering, drop volatile metadata. */
+function canonicalKey(data) {
+    const stripped = {
+        metadata: {
+            name: data.metadata?.name,
+            description: data.metadata?.description,
+            tags: [...(data.metadata?.tags ?? [])].sort(),
+        },
+        nodes: data.nodes,
+        edges: data.edges,
+    };
+    return stableStringify(stripped);
+}
+function stableStringify(v) {
+    if (v === null || typeof v !== "object")
+        return JSON.stringify(v);
+    if (Array.isArray(v))
+        return "[" + v.map(stableStringify).join(",") + "]";
+    const keys = Object.keys(v).sort();
+    return "{" + keys.map((k) => JSON.stringify(k) + ":" + stableStringify(v[k])).join(",") + "}";
+}
+//# sourceMappingURL=mutate.js.map