backpack-ontology 0.7.13 → 0.8.0

package/dist/cli/commands/completion.js

@@ -0,0 +1,159 @@
+// `bp completion <shell>` — print a shell completion script. The user
+// installs it into their shell config; we don't try to write to their
+// rc file. Supported: bash, zsh, fish.
+const COMMANDS = [
+    "help", "version", "doctor",
+    "login", "logout", "whoami",
+    "where", "use",
+    "ls", "cat", "show", "open", "search", "rm", "mv",
+    "graphs", "graph", "containers", "container", "kbs", "kb",
+    "init", "completion",
+];
+export async function runCompletion(args) {
+    const shell = args.positional[0];
+    if (!shell) {
+        process.stderr.write(`bp completion: shell required.\nusage: bp completion <bash|zsh|fish>\n`);
+        return 1;
+    }
+    switch (shell) {
+        case "bash":
+            process.stdout.write(bashScript() + "\n");
+            return 0;
+        case "zsh":
+            process.stdout.write(zshScript() + "\n");
+            return 0;
+        case "fish":
+            process.stdout.write(fishScript() + "\n");
+            return 0;
+        default:
+            process.stderr.write(`bp completion: unknown shell "${shell}". try bash, zsh, or fish.\n`);
+            return 1;
+    }
+}
+function bashScript() {
+    return `# bp bash completion. install with:
+#   bp completion bash > ~/.local/share/bash-completion/completions/bp
+# or source the output directly from your bashrc.
+
+_bp_local_backpacks() {
+  # Parse the JSON registry without requiring jq. The shape is
+  #   { "paths": ["/abs/path1", "/abs/path2"], ... }
+  # so we grep the array, split on quoted strings, and emit basenames.
+  local f="\${XDG_CONFIG_HOME:-\$HOME/.config}/backpack/backpacks.json"
+  [ -f "\$f" ] || return
+  local arr
+  arr=\$(tr -d '\\n' < "\$f" | grep -oE '"paths"[[:space:]]*:[[:space:]]*\\[[^]]*\\]')
+  echo "\$arr" | grep -oE '"[^"]+"' | sed 's/^"//; s/"$//' | while read -r p; do
+    [ -n "\$p" ] && echo "local:\$(basename "\$p")"
+  done
+}
+
+_bp_completions() {
+  local cur prev cmds
+  COMPREPLY=()
+  cur="\${COMP_WORDS[COMP_CWORD]}"
+  prev="\${COMP_WORDS[COMP_CWORD-1]}"
+  cmds="${COMMANDS.join(" ")}"
+  if [ "\$COMP_CWORD" -eq 1 ]; then
+    COMPREPLY=( \$(compgen -W "\$cmds" -- "\$cur") )
+    return 0
+  fi
+  case "\$prev" in
+    graphs|graph)
+      COMPREPLY=( \$(compgen -W "list get describe create delete rename apply edit move" -- "\$cur") )
+      return 0
+      ;;
+    kbs|kb)
+      COMPREPLY=( \$(compgen -W "list get create edit delete move" -- "\$cur") )
+      return 0
+      ;;
+    containers|container)
+      COMPREPLY=( \$(compgen -W "list create rename delete" -- "\$cur") )
+      return 0
+      ;;
+    completion)
+      COMPREPLY=( \$(compgen -W "bash zsh fish" -- "\$cur") )
+      return 0
+      ;;
+    use)
+      local backpacks
+      backpacks=\$(_bp_local_backpacks)
+      COMPREPLY=( \$(compgen -W "\$backpacks" -- "\$cur") )
+      return 0
+      ;;
+  esac
+}
+complete -F _bp_completions bp
+`;
+}
+function zshScript() {
+    return `# bp zsh completion. install with:
+#   bp completion zsh > "\${fpath[1]}/_bp"
+
+_bp_local_backpacks() {
+  local f="\${XDG_CONFIG_HOME:-\$HOME/.config}/backpack/backpacks.json"
+  [[ -f "\$f" ]] || return
+  local arr
+  arr="\$(tr -d '\\n' < "\$f" | grep -oE '"paths"[[:space:]]*:[[:space:]]*\\[[^]]*\\]')"
+  echo "\$arr" | grep -oE '"[^"]+"' | sed 's/^"//; s/"$//' | while read -r p; do
+    [[ -n "\$p" ]] && echo "local:\${p##*/}"
+  done
+}
+
+_bp() {
+  local -a commands
+  commands=(${COMMANDS.map((c) => `'${c}:bp ${c}'`).join(" ")})
+  if (( CURRENT == 2 )); then
+    _describe 'command' commands
+    return
+  fi
+  case "\${words[2]}" in
+    graphs|graph)
+      _values 'verb' list get describe create delete rename apply edit move
+      ;;
+    kbs|kb)
+      _values 'verb' list get create edit delete move
+      ;;
+    containers|container)
+      _values 'verb' list create rename delete
+      ;;
+    completion)
+      _values 'shell' bash zsh fish
+      ;;
+    use)
+      local -a contexts
+      contexts=("\${(@f)$(_bp_local_backpacks)}")
+      _describe 'context' contexts
+      ;;
+  esac
+}
+compdef _bp bp
+`;
+}
+function fishScript() {
+    return `# bp fish completion. install with:
+#   bp completion fish > ~/.config/fish/completions/bp.fish
+
+function __bp_local_backpacks
+  set -l f "$XDG_CONFIG_HOME"
+  test -z "$f"; and set f "$HOME/.config"
+  set f "$f/backpack/backpacks.json"
+  test -f "$f"; or return
+  set -l arr (tr -d '\\n' < "$f" | string match -r '"paths"\\s*:\\s*\\[[^]]*\\]')
+  test -z "$arr"; and return
+  echo $arr | string match -r -a '"[^"]+"' | string trim -c '"' | while read -l p
+    test -n "$p"; and echo "local:"(basename $p)
+  end
+end
+
+complete -c bp -f
+${COMMANDS.map((c) => `complete -c bp -n '__fish_use_subcommand' -a '${c}'`).join("\n")}
+
+complete -c bp -n '__fish_seen_subcommand_from graphs graph' -a 'list get describe create delete rename apply edit move'
+complete -c bp -n '__fish_seen_subcommand_from kbs kb' -a 'list get create edit delete move'
+complete -c bp -n '__fish_seen_subcommand_from containers container' -a 'list create rename delete'
+complete -c bp -n '__fish_seen_subcommand_from completion' -a 'bash zsh fish'
+complete -c bp -n '__fish_seen_subcommand_from use' -a '(__bp_local_backpacks)'
+`;
+}
+//# sourceMappingURL=completion.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"completion.js","sourceRoot":"","sources":["../../../src/cli/commands/completion.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,sEAAsE;AACtE,uCAAuC;AAIvC,MAAM,QAAQ,GAAG;IACf,MAAM,EAAE,SAAS,EAAE,QAAQ;IAC3B,OAAO,EAAE,QAAQ,EAAE,QAAQ;IAC3B,OAAO,EAAE,KAAK;IACd,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI;IACjD,QAAQ,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,KAAK,EAAE,IAAI;IACzD,MAAM,EAAE,YAAY;CACrB,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAgB;IAClD,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IACjC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,wEAAwE,CAAC,CAAC;QAC/F,OAAO,CAAC,CAAC;IACX,CAAC;IACD,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,MAAM;YACT,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC,CAAC;YAC1C,OAAO,CAAC,CAAC;QACX,KAAK,KAAK;YACR,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,GAAG,IAAI,CAAC,CAAC;YACzC,OAAO,CAAC,CAAC;QACX,KAAK,MAAM;YACT,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC,CAAC;YAC1C,OAAO,CAAC,CAAC;QACX;YACE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,iCAAiC,KAAK,8BAA8B,CAAC,CAAC;YAC3F,OAAO,CAAC,CAAC;IACb,CAAC;AACH,CAAC;AAED,SAAS,UAAU;IACjB,OAAO;;;;;;;;;;;;;;;;;;;;;;UAsBC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+B3B,CAAC;AACF,CAAC;AAED,SAAS,SAAS;IAChB,OAAO;;;;;;;;;;;;;;;cAeK,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;CA0B5D,CAAC;AACF,CAAC;AAED,SAAS,UAAU;IACjB,OAAO;;;;;;;;;;;;;;;;EAgBP,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,iDAAiD,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;;;CAOtF,CAAC;AACF,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"containers.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/containers.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAI1C,wBAAsB,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAyBrE"}

package/dist/cli/commands/containers.js

@@ -0,0 +1,30 @@
+// `bp containers <verb>` — canonical form. Read + cloud admin verbs.
+import { runLs } from "./ls.js";
+import { runContainerCreate, runContainerRename, runContainerDelete } from "./cloud-admin.js";
+export async function runContainers(args) {
+    const verb = args.positional[0];
+    if (!verb) {
+        process.stderr.write(`bp containers: verb required.\nusage: bp containers <list|create|rename|delete> [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: ["containers", ...sub.positional] });
+        case "create":
+        case "new":
+            return runContainerCreate(sub);
+        case "rename":
+        case "mv":
+            return runContainerRename(sub);
+        case "delete":
+        case "rm":
+        case "remove":
+            return runContainerDelete(sub);
+        default:
+            process.stderr.write(`bp containers: unknown verb "${verb}". try list, create, rename, or delete.\n`);
+            return 1;
+    }
+}
+//# sourceMappingURL=containers.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"containers.js","sourceRoot":"","sources":["../../../src/cli/commands/containers.ts"],"names":[],"mappings":"AAAA,qEAAqE;AAGrE,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAE9F,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAgB;IAClD,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAChC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,0FAA0F,CAAC,CAAC;QACjH,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,GAAG,GAAe,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;IACrG,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,MAAM,CAAC;QACZ,KAAK,IAAI;YACP,OAAO,KAAK,CAAC,EAAE,GAAG,GAAG,EAAE,UAAU,EAAE,CAAC,YAAY,EAAE,GAAG,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;QAC1E,KAAK,QAAQ,CAAC;QACd,KAAK,KAAK;YACR,OAAO,kBAAkB,CAAC,GAAG,CAAC,CAAC;QACjC,KAAK,QAAQ,CAAC;QACd,KAAK,IAAI;YACP,OAAO,kBAAkB,CAAC,GAAG,CAAC,CAAC;QACjC,KAAK,QAAQ,CAAC;QACd,KAAK,IAAI,CAAC;QACV,KAAK,QAAQ;YACX,OAAO,kBAAkB,CAAC,GAAG,CAAC,CAAC;QACjC;YACE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gCAAgC,IAAI,2CAA2C,CAAC,CAAC;YACtG,OAAO,CAAC,CAAC;IACb,CAAC;AACH,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/context.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAW1C,wBAAsB,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,CAehD;AAED,wBAAsB,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAsC9D"}

package/dist/cli/commands/context.js

@@ -0,0 +1,61 @@
+// `bp where`, `bp use <name>`. Operates on the CLI context state file.
+import { authStatus } from "../../ops/auth.js";
+import { getContext, setContext, listContexts, resolveContextName, describeContext, } from "../../ops/context.js";
+import { bold, dim, green, red, cyan } from "../colors.js";
+export async function runWhere() {
+    const ctx = await getContext();
+    const auth = await authStatus();
+    process.stdout.write(`context: ${bold(describeContext(ctx))}\n`);
+    if (ctx.source === "local" && ctx.backpackPath) {
+        process.stdout.write(dim(`  path: ${ctx.backpackPath}\n`));
+    }
+    else if (ctx.source === "cloud") {
+        process.stdout.write(dim(`  endpoint: ${auth.endpoint}\n`));
+    }
+    if (auth.authenticated) {
+        process.stdout.write(dim(`  identity: ${auth.email ?? "(unknown email)"}\n`));
+    }
+    else {
+        process.stdout.write(dim(`  identity: ${dim("not signed in")}\n`));
+    }
+    return 0;
+}
+export async function runUse(args) {
+    const target = args.positional[0];
+    if (!target) {
+        // Print the picker
+        const all = await listContexts();
+        if (all.length === 0) {
+            process.stdout.write(`${dim("no contexts available. register a local backpack or run")} ${bold("bp login")}\n`);
+            return 0;
+        }
+        const cur = describeContext(await getContext());
+        process.stdout.write(bold("available contexts:") + "\n");
+        for (const c of all) {
+            const marker = c.name === cur ? cyan("*") : " ";
+            process.stdout.write(`  ${marker} ${bold(c.name)}${c.detail ? dim("  " + c.detail) : ""}\n`);
+        }
+        process.stdout.write(dim("\nuse: bp use <name>\n"));
+        return 0;
+    }
+    const result = await resolveContextName(target);
+    if (!result.ctx) {
+        if ("ambiguous" in result && result.ambiguous && result.ambiguous.length > 0) {
+            process.stderr.write(`${red("✗")} ${bold(target)} is ambiguous — matches multiple contexts:\n`);
+            for (const name of result.ambiguous) {
+                process.stderr.write(`  - ${bold(name)}\n`);
+            }
+            process.stderr.write(dim(`pass the full name (e.g. \`bp use ${result.ambiguous[0]}\`).\n`));
+            return 1;
+        }
+        process.stderr.write(`${red("✗")} no context named ${bold(target)}\n`);
+        if ("suggestions" in result && result.suggestions && result.suggestions.length > 0) {
+            process.stderr.write(dim(`  did you mean: ${result.suggestions.join(", ")}?\n`));
+        }
+        return 1;
+    }
+    await setContext(result.ctx);
+    process.stdout.write(`${green("✓")} context → ${bold(result.ctx.name)}\n`);
+    return 0;
+}
+//# sourceMappingURL=context.js.map

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/doctor.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,UAAU,EAAY,MAAM,cAAc,CAAC;AAWpD,wBAAsB,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CA+DjE"}

package/dist/cli/commands/doctor.js

@@ -0,0 +1,74 @@
+// `bp doctor` — quick health check: token validity, endpoint reachability,
+// active context, version. Outputs a human checklist by default and JSON
+// when --json is passed.
+import { flagBool } from "../parser.js";
+import { resolveCloudToken, getRelayUrl, emailFromToken, assertSafeRelay } from "../../ops/auth.js";
+import { getContext, describeContext } from "../../ops/context.js";
+import { bold, green, red, yellow } from "../colors.js";
+export async function runDoctor(args) {
+    const checks = [];
+    // 1. Active context
+    try {
+        const ctx = await getContext();
+        checks.push({ name: "context", ok: true, detail: describeContext(ctx) });
+    }
+    catch (err) {
+        checks.push({ name: "context", ok: false, detail: err.message });
+    }
+    // 2. Token presence
+    const token = await resolveCloudToken();
+    if (token) {
+        const email = emailFromToken(token);
+        checks.push({ name: "auth", ok: true, detail: `signed in${email ? ` as ${email}` : ""}` });
+    }
+    else {
+        checks.push({ name: "auth", ok: false, detail: "not signed in (run `bp login`)" });
+    }
+    // 3. Cloud reachability — only when signed in. We hit /api/sync/backpacks
+    // because it requires auth (proves the token works) and returns a small
+    // payload regardless of how many graphs the user has.
+    if (token) {
+        try {
+            assertSafeRelay(getRelayUrl());
+            const res = await fetch(`${getRelayUrl()}/api/sync/backpacks`, {
+                headers: { Authorization: `Bearer ${token}` },
+            });
+            if (res.ok) {
+                checks.push({ name: "cloud", ok: true, detail: `${getRelayUrl()} reachable (HTTP ${res.status})` });
+            }
+            else if (res.status === 401) {
+                checks.push({ name: "cloud", ok: false, detail: `${getRelayUrl()} rejected token (HTTP 401) — re-run \`bp login\`` });
+            }
+            else {
+                checks.push({ name: "cloud", ok: false, detail: `${getRelayUrl()} (HTTP ${res.status})` });
+            }
+        }
+        catch (err) {
+            checks.push({ name: "cloud", ok: false, detail: `${getRelayUrl()} unreachable: ${err.message}` });
+        }
+    }
+    else {
+        checks.push({ name: "cloud", ok: true, detail: "skipped (not signed in)" });
+    }
+    // 4. Node version sanity
+    const major = parseInt(process.versions.node.split(".")[0], 10);
+    if (major >= 18) {
+        checks.push({ name: "node", ok: true, detail: process.versions.node });
+    }
+    else {
+        checks.push({ name: "node", ok: false, detail: `${process.versions.node} (need >= 18)` });
+    }
+    if (flagBool(args, "json")) {
+        process.stdout.write(JSON.stringify({ checks }, null, 2) + "\n");
+    }
+    else {
+        for (const c of checks) {
+            const mark = c.ok ? green("✓") : red("✗");
+            process.stdout.write(`${mark} ${bold(c.name.padEnd(8))} ${c.ok ? c.detail : yellow(c.detail)}\n`);
+        }
+        const failures = checks.filter((c) => !c.ok).length;
+        process.stdout.write("\n" + (failures === 0 ? green("everything looks good.") : red(`${failures} check${failures === 1 ? "" : "s"} failed.`)) + "\n");
+    }
+    return checks.every((c) => c.ok) ? 0 : 1;
+}
+//# sourceMappingURL=doctor.js.map

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"graphs.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/graphs.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAQ1C,wBAAsB,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAoDjE"}

package/dist/cli/commands/graphs.js

@@ -0,0 +1,68 @@
+// `bp graphs <verb>` — canonical (gh-style) form. Read-only verbs in
+// Step 2: list, get, describe. Mutating verbs (create, delete, rename,
+// apply, edit) land in Step 3.
+//
+// `bp graph <name>` (singular, no verb) is treated as `bp graph describe
+// <name>` — the natural-language thing the user typed almost always
+// means "show me this graph."
+import { runLs } from "./ls.js";
+import { runCat } from "./cat.js";
+import { runShow } from "./show.js";
+import { runCreate, runDelete, runRename, runApply, runEdit } from "./mutate.js";
+import { runMoveGraph } from "./cloud-admin.js";
+import { getGraphSummary } from "../../ops/graphs.js";
+export async function runGraphs(args) {
+    const verb = args.positional[0];
+    if (!verb) {
+        process.stderr.write(`bp graphs: verb required.\nusage: bp graphs <list|get|describe> [args]\n`);
+        return 1;
+    }
+    const sub = { positional: args.positional.slice(1), flags: args.flags, rest: args.rest };
+    switch (verb) {
+        case "list":
+        case "ls":
+            // Force resource = graphs
+            return runLs({ ...sub, positional: ["graphs", ...sub.positional] });
+        case "get":
+        case "cat":
+            return runCat(sub);
+        case "describe":
+        case "show":
+            return runShow(sub);
+        case "create":
+        case "new":
+            return runCreate(sub);
+        case "delete":
+        case "rm":
+        case "remove":
+            return runDelete(sub);
+        case "rename":
+        case "mv":
+            return runRename(sub);
+        case "apply":
+            return runApply(sub);
+        case "edit":
+            return runEdit(sub);
+        case "move":
+        case "mv-to":
+            return runMoveGraph(sub);
+        default: {
+            // Natural-language fallback: `bp graph delgate` → describe delgate.
+            // Only takes effect when there's no further positional arg (so we
+            // don't grab `bp graph foo bar` when `foo` was a typo'd verb).
+            const couldBeName = args.positional.length === 1 && verb && !verb.startsWith("-");
+            if (couldBeName) {
+                try {
+                    const summary = await getGraphSummary(verb);
+                    if (summary) {
+                        return runShow({ positional: [verb], flags: args.flags, rest: args.rest });
+                    }
+                }
+                catch { /* fall through to verb error */ }
+            }
+            process.stderr.write(`bp graphs: unknown verb "${verb}". try list, get, or describe.\n`);
+            return 1;
+        }
+    }
+}
+//# sourceMappingURL=graphs.js.map

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAW1C,wBAAsB,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAgD/D"}

package/dist/cli/commands/init.js

@@ -0,0 +1,56 @@
+// `bp init [path]` — create a new backpack root in the current
+// directory (or the given path), register it in the local backpack
+// registry, and switch the active CLI context to it.
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import { configDir } from "../../core/paths.js";
+import { setContext } from "../../ops/context.js";
+import { red, green, dim, bold, yellow } from "../colors.js";
+export async function runInit(args) {
+    const target = args.positional[0]
+        ? path.resolve(args.positional[0])
+        : process.cwd();
+    // Verify the target is a directory if it exists. Re-running init on
+    // an already-registered path is idempotent — it just bumps `active`.
+    try {
+        const stat = await fs.stat(target);
+        if (!stat.isDirectory()) {
+            process.stderr.write(`${red("✗")} ${target} is not a directory.\n`);
+            return 1;
+        }
+    }
+    catch {
+        // Doesn't exist; we'll create it below.
+    }
+    await fs.mkdir(target, { recursive: true });
+    // Read or initialize the registry. Layout:
+    //   { version: 2, paths: [...], active: "/some/path" }
+    const regPath = path.join(configDir(), "backpacks.json");
+    let reg;
+    try {
+        const raw = await fs.readFile(regPath, "utf8");
+        reg = JSON.parse(raw);
+        if (!Array.isArray(reg.paths))
+            reg.paths = [];
+    }
+    catch {
+        reg = { version: 2, paths: [] };
+    }
+    if (reg.paths.includes(target)) {
+        process.stdout.write(`${yellow("!")} ${dim(target)} is already registered.\n`);
+    }
+    else {
+        reg.paths.push(target);
+        process.stdout.write(`${green("✓")} registered ${bold(target)}\n`);
+    }
+    reg.active = target;
+    await fs.mkdir(path.dirname(regPath), { recursive: true });
+    await fs.writeFile(regPath, JSON.stringify(reg, null, 2), "utf8");
+    // Update CLI context state file too, so `bp ls` / `bp where` see the
+    // change without needing a separate `bp use`.
+    await setContext({ source: "local", backpackPath: target });
+    process.stdout.write(`${green("✓")} active context → ${bold("local:" + path.basename(target))}\n`);
+    process.stdout.write(dim("\n  ready. try: `bp ls` to see what's in this backpack (it'll be empty until you create graphs).\n"));
+    return 0;
+}
+//# sourceMappingURL=init.js.map

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"kbs.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/kbs.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,UAAU,EAAc,MAAM,cAAc,CAAC;AAQtD,wBAAsB,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CA8B9D"}