backpack-ontology 0.7.13 → 0.8.0

package/dist/cli/output.js

@@ -0,0 +1,224 @@
+// Output formatters for CLI commands. Five formats: human (default),
+// json, yaml, names (one per line), wide (every column).
+//
+// Contract: `--json` / `--yaml` are the *stable* outputs scripts can
+// rely on. The default human view is allowed to evolve. Scripts should
+// either pipe to jq or consume `--names`.
+import { dim, bold, gray, visibleWidth } from "./colors.js";
+/** Emit a list using the chosen format to stdout. */
+export function emitList(opts, choice) {
+    const { rows, cols, pluralLabel, nameKey, empty } = opts;
+    switch (choice.format) {
+        case "json":
+            process.stdout.write(JSON.stringify({ [pluralLabel]: rows }, null, 2) + "\n");
+            return;
+        case "yaml":
+            process.stdout.write(toYaml({ [pluralLabel]: rows }) + "\n");
+            return;
+        case "names": {
+            const getName = nameKey ?? ((r) => stripAnsi(cols[0].get(r)));
+            for (const r of rows)
+                process.stdout.write(getName(r) + "\n");
+            return;
+        }
+        case "wide":
+            process.stdout.write(renderTable(rows, cols, true) + "\n");
+            return;
+        case "human":
+        default:
+            if (rows.length === 0 && empty) {
+                process.stdout.write(dim(empty) + "\n");
+                return;
+            }
+            process.stdout.write(renderTable(rows, cols, false) + "\n");
+            return;
+    }
+}
+/** Emit a single record as JSON/YAML, or formatted human text. */
+export function emitOne(value, choice) {
+    switch (choice.format) {
+        case "json":
+        case "wide":
+        case "human":
+            // For one-record output, default to JSON when the user asked for any
+            // structured format. The dedicated `bp show` command renders human.
+            if (choice.format === "human") {
+                process.stdout.write(humanizeOne(value) + "\n");
+            }
+            else {
+                process.stdout.write(JSON.stringify(value, null, 2) + "\n");
+            }
+            return;
+        case "yaml":
+            process.stdout.write(toYaml(value) + "\n");
+            return;
+        case "names":
+            if (value && typeof value === "object" && "name" in value) {
+                process.stdout.write(String(value.name) + "\n");
+            }
+            return;
+    }
+}
+/** Render a table. Columns auto-size to terminal width; long values are
+ * truncated with an ellipsis. Falls back to single-column mode on very
+ * narrow terminals. */
+function renderTable(rows, cols, wide) {
+    const visible = cols.filter((c) => wide || !c.wide);
+    if (visible.length === 0)
+        return "";
+    const termWidth = process.stdout.columns ?? 100;
+    // Compute max content width per column. Numeric columns ignore `max`
+    // because truncating "12345" to "1234…" changes the meaning of the
+    // value silently; grow the column instead.
+    const widths = visible.map((c) => {
+        const headerW = visibleWidth(c.header);
+        const maxRow = rows.reduce((m, r) => Math.max(m, visibleWidth(c.get(r))), 0);
+        const desired = Math.max(headerW, maxRow);
+        if (c.numeric)
+            return desired;
+        return c.max ? Math.min(desired, c.max) : desired;
+    });
+    // Shrink to fit terminal: subtract 2 chars per gap as separators
+    const totalGap = (visible.length - 1) * 2;
+    const totalContent = widths.reduce((a, b) => a + b, 0);
+    if (totalContent + totalGap > termWidth - 2) {
+        // Trim from the longest column repeatedly until we fit
+        let budget = termWidth - 2 - totalGap;
+        if (budget < visible.length * 6) {
+            // Terminal is too narrow for a real table — single-column mode
+            return rows.map((r) => visible.map((c, i) => `${dim(visible[i].header)}: ${c.get(r)}`).join("\n")).join("\n\n");
+        }
+        while (widths.reduce((a, b) => a + b, 0) > budget) {
+            const idx = widths.indexOf(Math.max(...widths));
+            widths[idx]--;
+            if (widths[idx] < 4)
+                break;
+        }
+    }
+    const lines = [];
+    lines.push(visible.map((c, i) => padRight(bold(c.header), widths[i])).join("  "));
+    for (const r of rows) {
+        lines.push(visible.map((c, i) => {
+            let cell = c.get(r);
+            const w = widths[i];
+            if (visibleWidth(cell) > w)
+                cell = truncate(cell, w);
+            cell = padRight(cell, w);
+            return c.dim ? dim(cell) : cell;
+        }).join("  "));
+    }
+    return lines.join("\n");
+}
+function humanizeOne(value) {
+    if (value === null || value === undefined)
+        return dim("(empty)");
+    if (typeof value !== "object")
+        return String(value);
+    const lines = [];
+    for (const [k, v] of Object.entries(value)) {
+        if (v === undefined)
+            continue;
+        const formatted = typeof v === "object" && v !== null
+            ? JSON.stringify(v, null, 2).split("\n").map((l, i) => i === 0 ? l : "  " + l).join("\n")
+            : String(v);
+        lines.push(`${gray(k + ":")} ${formatted}`);
+    }
+    return lines.join("\n");
+}
+function padRight(s, width) {
+    const w = visibleWidth(s);
+    if (w >= width)
+        return s;
+    return s + " ".repeat(width - w);
+}
+function truncate(s, width) {
+    if (visibleWidth(s) <= width)
+        return s;
+    // Strip ANSI for truncation, then preserve plain content
+    const plain = stripAnsi(s);
+    if (plain.length <= width)
+        return s;
+    return plain.slice(0, Math.max(0, width - 1)) + "…";
+}
+function stripAnsi(s) {
+    // eslint-disable-next-line no-control-regex
+    return s.replace(/\x1b\[[0-9;]*m/g, "");
+}
+/** Minimal YAML serializer for our shapes (objects, arrays, primitives).
+ * Doesn't try to be a full YAML 1.2 implementation — sufficient for
+ * structured Backpack data. */
+function toYaml(v, indent = 0) {
+    const pad = "  ".repeat(indent);
+    if (v === null || v === undefined)
+        return "null";
+    if (typeof v === "string")
+        return yamlScalar(v);
+    if (typeof v === "number" || typeof v === "boolean")
+        return String(v);
+    if (Array.isArray(v)) {
+        if (v.length === 0)
+            return "[]";
+        return v.map((item) => {
+            if (item !== null && typeof item === "object") {
+                const inner = toYaml(item, indent + 1);
+                // For object items, first line is `- key: value`, rest indented
+                const lines = inner.split("\n");
+                const firstNonEmpty = lines.findIndex((l) => l.trim().length > 0);
+                if (firstNonEmpty === -1)
+                    return `${pad}- {}`;
+                const first = lines[firstNonEmpty].replace(/^\s+/, "");
+                const rest = lines.slice(firstNonEmpty + 1).join("\n");
+                return rest ? `${pad}- ${first}\n${rest}` : `${pad}- ${first}`;
+            }
+            return `${pad}- ${toYaml(item, indent + 1)}`;
+        }).join("\n");
+    }
+    if (typeof v === "object") {
+        const entries = Object.entries(v).filter(([, val]) => val !== undefined);
+        if (entries.length === 0)
+            return "{}";
+        return entries.map(([k, val]) => {
+            if (val !== null && typeof val === "object") {
+                const inner = toYaml(val, indent + 1);
+                if (Array.isArray(val) && val.length === 0)
+                    return `${pad}${k}: []`;
+                if (!Array.isArray(val) && Object.keys(val).length === 0)
+                    return `${pad}${k}: {}`;
+                return `${pad}${k}:\n${inner}`;
+            }
+            return `${pad}${k}: ${toYaml(val, indent + 1)}`;
+        }).join("\n");
+    }
+    return String(v);
+}
+function yamlScalar(s) {
+    // Quote if any of these are true:
+    //   - empty string
+    //   - contains YAML structural chars or block indicators
+    //   - leading/trailing whitespace, leading dash/question mark
+    //   - looks like a YAML keyword (true/false/null/yes/no) or a number
+    //   - contains control characters (newlines, tabs, etc.)
+    // JSON.stringify gives us a valid YAML 1.2 double-quoted scalar — it
+    // escapes \n, \t, etc. exactly the way YAML expects.
+    // eslint-disable-next-line no-control-regex
+    const hasControl = /[\x00-\x1f]/.test(s);
+    if (hasControl ||
+        s === "" ||
+        /[:#\[\]{},&*!|>'"%@`]|^\s|\s$|^-|^\?|^(null|true|false|yes|no)$|^-?\d/.test(s)) {
+        return JSON.stringify(s);
+    }
+    return s;
+}
+/** Resolve --json/--yaml/--names/--wide flags to a single OutputFormat. */
+export function resolveFormat(flags) {
+    if (flags.json)
+        return "json";
+    if (flags.yaml)
+        return "yaml";
+    if (flags.names)
+        return "names";
+    if (flags.wide)
+        return "wide";
+    return "human";
+}
+//# sourceMappingURL=output.js.map

package/dist/cli/output.js.map

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

package/dist/cli/parser.d.ts

@@ -0,0 +1,16 @@
+export interface ParsedArgs {
+    positional: string[];
+    flags: Record<string, string | boolean>;
+    /** Raw tokens captured after `--`, never interpreted as flags. */
+    rest: string[];
+}
+/**
+ * Parse argv (without the leading [node, scriptPath] pair). Doesn't know
+ * about commands — produces a generic positional/flag split. Boolean
+ * flags are inferred from KNOWN_BOOL_FLAGS so `bp ls --json --names`
+ * doesn't accidentally consume `--names` as `json`'s value.
+ */
+export declare function parseArgs(argv: string[]): ParsedArgs;
+export declare function flagBool(args: ParsedArgs, ...keys: string[]): boolean;
+export declare function flagString(args: ParsedArgs, ...keys: string[]): string | undefined;
+//# sourceMappingURL=parser.d.ts.map

package/dist/cli/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/cli/parser.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC;IACxC,kEAAkE;IAClE,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAOD;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAgFpD;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAQrE;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,CAOlF"}

package/dist/cli/parser.js

@@ -0,0 +1,131 @@
+// Hand-rolled argv parser. Zero deps. Designed for the gh/wrangler grammar
+// (verb + noun + name + flags) plus Unix-style shortcuts (`bp ls`, `bp cat
+// foo`). The parser is intentionally permissive — commands validate their
+// own positional + flag shape.
+//
+// Conventions:
+//   --flag                 boolean true
+//   --flag=value           explicit value
+//   --flag value           value is the next token (only if next isn't a flag)
+//   --no-flag              boolean false (sets `flag` to false)
+//   -f                     short alias (commands map their own)
+//   --                     stop parsing flags; everything after is positional
+const KNOWN_BOOL_FLAGS = new Set([
+    "json", "yaml", "names", "wide", "watch", "all", "help", "h", "H",
+    "verbose", "v", "V", "quiet", "q", "yes", "y", "force", "no-color", "version",
+]);
+/**
+ * Parse argv (without the leading [node, scriptPath] pair). Doesn't know
+ * about commands — produces a generic positional/flag split. Boolean
+ * flags are inferred from KNOWN_BOOL_FLAGS so `bp ls --json --names`
+ * doesn't accidentally consume `--names` as `json`'s value.
+ */
+export function parseArgs(argv) {
+    const positional = [];
+    const flags = {};
+    const rest = [];
+    let i = 0;
+    while (i < argv.length) {
+        const tok = argv[i];
+        if (tok === "--") {
+            rest.push(...argv.slice(i + 1));
+            break;
+        }
+        if (tok.startsWith("--")) {
+            const eq = tok.indexOf("=");
+            let key;
+            let value;
+            if (eq !== -1) {
+                key = tok.slice(2, eq);
+                value = tok.slice(eq + 1);
+                if (key === "") {
+                    // `--=foo` is malformed; ignore so we don't pollute flags{}
+                    i++;
+                    continue;
+                }
+            }
+            else {
+                key = tok.slice(2);
+                if (key === "") {
+                    // pure `--` with content past it is already handled above; bare
+                    // `--` reaching here means a stray double-dash — skip it
+                    i++;
+                    continue;
+                }
+                if (key.startsWith("no-")) {
+                    flags[key.slice(3)] = false;
+                    i++;
+                    continue;
+                }
+                if (key.startsWith("-")) {
+                    // `---foo` or weirder. Drop the extra dashes and treat as
+                    // a normal flag rather than producing a flag named `-foo`.
+                    key = key.replace(/^-+/, "");
+                    if (key === "") {
+                        i++;
+                        continue;
+                    }
+                }
+                const next = argv[i + 1];
+                if (KNOWN_BOOL_FLAGS.has(key) || next === undefined || next.startsWith("-")) {
+                    value = true;
+                }
+                else {
+                    value = next;
+                    i++;
+                }
+            }
+            flags[key] = value;
+        }
+        else if (tok.startsWith("-") && tok.length > 1) {
+            // Short flag(s). Each char is its own flag. The last char may take a
+            // value (`-n value`); the rest are booleans (`-vh` = `-v -h`).
+            const chars = tok.slice(1);
+            for (let j = 0; j < chars.length; j++) {
+                const k = chars[j];
+                const isLast = j === chars.length - 1;
+                if (isLast) {
+                    const next = argv[i + 1];
+                    if (KNOWN_BOOL_FLAGS.has(k) || next === undefined || next.startsWith("-")) {
+                        flags[k] = true;
+                    }
+                    else {
+                        flags[k] = next;
+                        i++;
+                    }
+                }
+                else {
+                    flags[k] = true;
+                }
+            }
+        }
+        else {
+            positional.push(tok);
+        }
+        i++;
+    }
+    return { positional, flags, rest };
+}
+export function flagBool(args, ...keys) {
+    for (const k of keys) {
+        const v = args.flags[k];
+        if (v === true)
+            return true;
+        if (v === "true" || v === "1")
+            return true;
+        if (v === false || v === "false" || v === "0")
+            return false;
+    }
+    return false;
+}
+export function flagString(args, ...keys) {
+    for (const k of keys) {
+        const v = args.flags[k];
+        if (typeof v === "string")
+            return v;
+        if (v === true)
+            return undefined; // boolean true means "flag present without value"
+    }
+    return undefined;
+}
+//# sourceMappingURL=parser.js.map

package/dist/cli/parser.js.map

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

package/dist/cli/router.d.ts

@@ -0,0 +1,2 @@
+export declare function run(rawArgv: string[]): Promise<number>;
+//# sourceMappingURL=router.d.ts.map

package/dist/cli/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/cli/router.ts"],"names":[],"mappings":"AA8DA,wBAAsB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAyD5D"}

package/dist/cli/router.js

@@ -0,0 +1,147 @@
+// Top-level CLI dispatch. Maps the first positional token to a command
+// handler. Each handler receives the already-parsed args and returns an
+// exit code (0 ok, non-zero failure). The bin entry calls run() and
+// uses the return value as the process exit code.
+import { parseArgs, flagBool } from "./parser.js";
+import { setColorEnabled } from "./colors.js";
+import { printHint, printFullHelp } from "./help.js";
+import { runVersion } from "./commands/version.js";
+import { runDoctor } from "./commands/doctor.js";
+import { runLogin, runLogout, runWhoami } from "./commands/auth.js";
+import { runWhere, runUse } from "./commands/context.js";
+import { runLs } from "./commands/ls.js";
+import { runCat } from "./commands/cat.js";
+import { runShow } from "./commands/show.js";
+import { runOpen } from "./commands/open.js";
+import { runSearch } from "./commands/search.js";
+import { runGraphs } from "./commands/graphs.js";
+import { runContainers } from "./commands/containers.js";
+import { runKbs } from "./commands/kbs.js";
+import { runDelete, runRename } from "./commands/mutate.js";
+import { runInit } from "./commands/init.js";
+import { runCompletion } from "./commands/completion.js";
+const COMMANDS = {
+    // Top-level
+    help: async () => { printFullHelp(); return 0; },
+    version: async () => runVersion(),
+    doctor: runDoctor,
+    // Auth
+    login: runLogin,
+    logout: runLogout,
+    whoami: runWhoami,
+    // Context
+    where: runWhere,
+    use: runUse,
+    // Read-only daily-driver shortcuts (Unix muscle memory)
+    ls: runLs,
+    cat: runCat,
+    show: runShow,
+    open: runOpen,
+    search: runSearch,
+    // Mutating shortcuts
+    rm: runDelete,
+    mv: runRename,
+    // Project init + shell integration
+    init: runInit,
+    completion: runCompletion,
+    // Canonical gh-style verbs
+    graphs: runGraphs, graph: runGraphs,
+    containers: runContainers, container: runContainers,
+    kbs: runKbs, kb: runKbs,
+};
+export async function run(rawArgv) {
+    const args = parseArgs(rawArgv);
+    // Honor --no-color globally before any handler emits output. The
+    // parser converts --no-color into `color: false`, so check that.
+    if (args.flags.color === false)
+        setColorEnabled(false);
+    // No args: show the hint card
+    if (args.positional.length === 0 && Object.keys(args.flags).length === 0) {
+        printHint();
+        return 0;
+    }
+    // --version / -V short-circuits
+    if (flagBool(args, "version", "V") && args.positional.length === 0) {
+        return runVersion();
+    }
+    // --help / -h with no command
+    if (flagBool(args, "help", "h") && args.positional.length === 0) {
+        printFullHelp();
+        return 0;
+    }
+    const cmd = args.positional[0];
+    const handler = COMMANDS[cmd];
+    if (!handler) {
+        process.stderr.write(`bp: unknown command "${cmd}"\n`);
+        const suggestion = closestCommand(cmd, Object.keys(COMMANDS));
+        if (suggestion) {
+            process.stderr.write(`  did you mean \`bp ${suggestion}\`?\n`);
+        }
+        process.stderr.write(`run \`bp help\` for the full list of commands\n`);
+        return 1;
+    }
+    // Strip the command token so handlers see clean positional args
+    const handlerArgs = {
+        positional: args.positional.slice(1),
+        flags: args.flags,
+        rest: args.rest,
+    };
+    try {
+        const result = await handler(handlerArgs);
+        // Defensive: a handler that forgets to `return` would otherwise let
+        // process.exit(undefined) be a silent zero. Force a non-zero exit so
+        // the bug is loud.
+        if (typeof result !== "number") {
+            process.stderr.write(`bp: command "${cmd}" returned ${typeof result} (expected number) — treating as failure\n`);
+            return 1;
+        }
+        return result;
+    }
+    catch (err) {
+        process.stderr.write(`bp: ${err.message}\n`);
+        return 1;
+    }
+}
+/** Cheap edit-distance-style match. Picks the closest command name to
+ * the user's typo, but only returns it if the match is "close enough"
+ * (avoids suggesting `version` for a totally unrelated typo). */
+function closestCommand(typed, options) {
+    if (!typed)
+        return null;
+    let best = null;
+    for (const name of options) {
+        const d = levenshtein(typed.toLowerCase(), name.toLowerCase());
+        const score = name.length - d; // higher is better; perfect match = name.length
+        if (!best || score > best.score)
+            best = { name, score };
+    }
+    if (!best)
+        return null;
+    // Require the suggestion be at least 60% similar to the typed string.
+    const ratio = (best.score + typed.length) / (2 * typed.length);
+    return ratio >= 0.6 ? best.name : null;
+}
+function levenshtein(a, b) {
+    if (a === b)
+        return 0;
+    const al = a.length, bl = b.length;
+    if (al === 0)
+        return bl;
+    if (bl === 0)
+        return al;
+    const prev = new Array(bl + 1);
+    const curr = new Array(bl + 1);
+    for (let j = 0; j <= bl; j++)
+        prev[j] = j;
+    for (let i = 1; i <= al; i++) {
+        curr[0] = i;
+        for (let j = 1; j <= bl; j++) {
+            const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+            curr[j] = Math.min(curr[j - 1] + 1, prev[j] + 1, prev[j - 1] + cost);
+        }
+        for (let j = 0; j <= bl; j++)
+            prev[j] = curr[j];
+    }
+    return prev[bl];
+}
+//# sourceMappingURL=router.js.map

package/dist/cli/router.js.map

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

package/dist/cli/util/confirm.d.ts

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

package/dist/cli/util/confirm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"confirm.d.ts","sourceRoot":"","sources":["../../../src/cli/util/confirm.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,UAAU,EAAY,MAAM,cAAc,CAAC;AAGpD,wBAAsB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,CAgChF"}

package/dist/cli/util/confirm.js

@@ -0,0 +1,48 @@
+// Shared confirmation prompt. Used by every destructive verb so we
+// don't end up with two slightly-different implementations that drift.
+//
+// Behavior:
+//   * `--yes` / `-y` short-circuits to true.
+//   * In a TTY, the prompt is printed to stderr (so stdout pipes don't
+//     swallow it) and the user's typed answer is parsed.
+//   * In non-TTY without `--yes`, refuse — destructive ops shouldn't
+//     proceed unattended without an explicit affirmative.
+//   * EOF (Ctrl-D) before newline resolves to whatever's been typed —
+//     no infinite hang.
+import { flagBool } from "../parser.js";
+import { yellow } from "../colors.js";
+export async function confirm(prompt, args) {
+    if (flagBool(args, "yes", "y"))
+        return true;
+    if (!process.stdin.isTTY) {
+        process.stderr.write(`${yellow("!")} stdin is not a TTY — pass --yes to confirm in non-interactive contexts.\n`);
+        return false;
+    }
+    process.stderr.write(prompt);
+    const answer = await new Promise((resolve) => {
+        let buf = "";
+        process.stdin.setEncoding("utf8");
+        const onData = (chunk) => {
+            buf += chunk;
+            const nl = buf.indexOf("\n");
+            if (nl !== -1) {
+                cleanup();
+                resolve(buf.slice(0, nl).trim());
+            }
+        };
+        const onEnd = () => {
+            cleanup();
+            resolve(buf.trim());
+        };
+        const cleanup = () => {
+            process.stdin.removeListener("data", onData);
+            process.stdin.removeListener("end", onEnd);
+            process.stdin.pause();
+        };
+        process.stdin.on("data", onData);
+        process.stdin.on("end", onEnd);
+        process.stdin.resume();
+    });
+    return /^y(es)?$/i.test(answer);
+}
+//# sourceMappingURL=confirm.js.map

package/dist/cli/util/confirm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"confirm.js","sourceRoot":"","sources":["../../../src/cli/util/confirm.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,uEAAuE;AACvE,EAAE;AACF,YAAY;AACZ,6CAA6C;AAC7C,uEAAuE;AACvE,yDAAyD;AACzD,qEAAqE;AACrE,0DAA0D;AAC1D,sEAAsE;AACtE,wBAAwB;AAExB,OAAO,EAAc,QAAQ,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,MAAc,EAAE,IAAgB;IAC5D,IAAI,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5C,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACzB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,4EAA4E,CAAC,CAAC;QACjH,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC7B,MAAM,MAAM,GAAW,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QACnD,IAAI,GAAG,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAClC,MAAM,MAAM,GAAG,CAAC,KAAa,EAAE,EAAE;YAC/B,GAAG,IAAI,KAAK,CAAC;YACb,MAAM,EAAE,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAC7B,IAAI,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC;gBACd,OAAO,EAAE,CAAC;gBACV,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YACnC,CAAC;QACH,CAAC,CAAC;QACF,MAAM,KAAK,GAAG,GAAG,EAAE;YACjB,OAAO,EAAE,CAAC;YACV,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;QACtB,CAAC,CAAC;QACF,MAAM,OAAO,GAAG,GAAG,EAAE;YACnB,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAC7C,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;YAC3C,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACxB,CAAC,CAAC;QACF,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACjC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAC/B,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;IACzB,CAAC,CAAC,CAAC;IACH,OAAO,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAClC,CAAC"}

package/dist/core/backpack.d.ts

@@ -92,6 +92,14 @@ export declare class Backpack {
     loadOntology(name: string): Promise<LearningGraphData>;
     createOntology(name: string, description: string): Promise<LearningGraphMetadata>;
     deleteOntology(name: string): Promise<void>;
+    /**
+     * Replace the contents of an existing graph with `data`. Preserves the
+     * graph's directory (branches, snapshots, snippets, lock) — the storage
+     * layer diffs the new data against current state and appends events.
+     * Does NOT create the graph if missing — callers should check existence
+     * first or use `createOntologyFromData`.
+     */
+    saveOntologyData(name: string, data: LearningGraphData): Promise<void>;
     /**
      * Create a new ontology from a full LearningGraphData payload, preserving
      * node and edge IDs. Used by remote graph import (where we want the local