@dikolab/kbdb 0.5.0 → 0.6.1

package/dist/cli.cjs

@@ -2,8 +2,8 @@
 "use strict";
 
 // src/cli.ts
-var import_node_fs9 = require("node:fs");
-var import_node_path12 = require("node:path");
+var import_node_fs10 = require("node:fs");
+var import_node_path14 = require("node:path");
 
 // src/shared/runtime/functions/detect-runtime.ts
 function detectRuntime() {
@@ -23,44 +23,9 @@ function getArgs() {
   return process.argv.slice(2);
 }
 
-// src/shared/dir-resolver/functions/resolve-base-dir.function.ts
-var import_node_path = require("node:path");
-var import_node_url = require("node:url");
-function resolveScriptDir(entryUrl, entryDirname) {
-  if (entryDirname) return entryDirname;
-  if (entryUrl.startsWith("file:"))
-    return (0, import_node_path.dirname)((0, import_node_url.fileURLToPath)(entryUrl));
-  return (0, import_node_path.dirname)(entryUrl);
-}
-function resolveBaseDir(entryUrl, entryDirname) {
-  const scriptDir = typeof __dirname !== "undefined" ? __dirname : resolveScriptDir(entryUrl, entryDirname);
-  return { scriptDir, cwd: process.cwd() };
-}
-
-// src/shared/dir-resolver/functions/join-path.function.ts
-var import_node_path2 = require("node:path");
-function isRemoteUrl(path) {
-  return path.startsWith("http://") || path.startsWith("https://");
-}
-function joinPath(base, ...segments) {
-  if (isRemoteUrl(base)) {
-    const trailing = base.endsWith("/") ? "" : "/";
-    return base + trailing + segments.join("/");
-  }
-  return (0, import_node_path2.join)(base, ...segments);
-}
-
-// src/shared/dir-resolver/functions/resolve-worker-script.function.ts
-function resolveWorkerScript(scriptDir, runtime2) {
-  if (runtime2 === "deno") {
-    return joinPath(scriptDir, "worker.ts");
-  }
-  return joinPath(scriptDir, "kbdb-worker.cjs");
-}
-
 // src/shared/cli/constants/defaults.constant.ts
 var DEFAULT_LIMIT = 20;
-var DEFAULT_FORMAT = "json";
+var DEFAULT_FORMAT = "rec";
 var DEFAULT_MODE = "sections";
 var SUPPORTED_EXTENSIONS = [
   ".md",
@@ -192,6 +157,18 @@ function parseArgs(argv) {
       case "--replace":
         options.replace = true;
         break;
+      case "--level":
+      case "--weight": {
+        const raw = argv[++i];
+        const n = Number(raw);
+        if (!Number.isInteger(n) || n < 1 || n > 6) {
+          throw new Error(
+            `Invalid level "${raw}": must be integer 1-6`
+          );
+        }
+        options.level = n;
+        break;
+      }
       case "--depth":
       case "-d":
         options.depth = Math.min(
@@ -238,18 +215,8 @@ function parseArgs(argv) {
   return options;
 }
 
-// src/shared/cli/functions/format-output.function.ts
-function formatOutput(paged, format) {
-  switch (format) {
-    case "json":
-      return JSON.stringify(paged, null, 2);
-    case "text":
-      return formatText(paged);
-    case "mcp":
-      return formatMcp(paged);
-  }
-}
-function formatText(paged) {
+// src/shared/cli/functions/format-text-output.function.ts
+function formatTextOutput(paged) {
   if (paged.items.length === 0) return "No results found.";
   const start = paged.offset + 1;
   const end = paged.offset + paged.items.length;
@@ -269,7 +236,9 @@ Showing ${String(start)}-${String(end)} of ${String(paged.total)} results`;
 Use --offset ${String(end)} to see more` : "";
   return lines + footer + hint;
 }
-function formatMcp(paged) {
+
+// src/shared/cli/functions/format-mcp-output.function.ts
+function formatMcpOutput(paged) {
   const mcpItems = paged.items.map((r) => ({
     kbid: r.kbid,
     heading: r.heading,
@@ -298,6 +267,168 @@ function formatMcp(paged) {
   );
 }
 
+// src/shared/cli/functions/resolve-recfile-key.function.ts
+function resolveRecfileKey(obj, key) {
+  const parts = key.split(".");
+  let current = obj;
+  for (const part of parts) {
+    if (current == null || typeof current !== "object") {
+      return void 0;
+    }
+    current = current[part];
+  }
+  return current;
+}
+
+// src/shared/cli/functions/render-recfile-value.function.ts
+function renderRecfileValue(value) {
+  if (value === null || value === void 0) return null;
+  if (Array.isArray(value)) {
+    if (value.length === 0) return null;
+    return value.map(String).join(", ");
+  }
+  if (typeof value === "boolean") return value ? "true" : "false";
+  if (typeof value === "number") return String(value);
+  if (typeof value === "string") return value === "" ? null : value;
+  return JSON.stringify(value);
+}
+
+// src/shared/cli/functions/format-recfile-output.function.ts
+function formatRecfileOutput(data, fields) {
+  const records = Array.isArray(data) ? data : [data];
+  return records.map((record) => formatRecord(record, fields)).filter(Boolean).join("\n\n");
+}
+function formatRecord(record, fields) {
+  if (!record || typeof record !== "object") return "";
+  const lines = [];
+  for (const [field, key] of fields) {
+    const value = resolveRecfileKey(record, key);
+    const rendered = renderRecfileValue(value);
+    if (rendered === null) continue;
+    lines.push(formatField(field, rendered));
+  }
+  return lines.join("\n");
+}
+function formatField(field, value) {
+  const lines = value.split("\n");
+  if (lines.length === 1) return `${field}: ${lines[0]}`;
+  return [
+    `${field}: ${lines[0]}`,
+    ...lines.slice(1).map((line) => `+ ${line}`)
+  ].join("\n");
+}
+
+// src/shared/cli/constants/recfile-field-maps.constant.ts
+var SEARCH_FIELDS = [
+  ["kbid", "kbid"],
+  ["heading", "heading"],
+  ["score", "score"],
+  ["confidence", "confidence"],
+  ["type", "type"],
+  ["terms", "matched_terms"],
+  ["fields", "matched_fields"],
+  ["snippet", "snippet"],
+  ["level", "level"]
+];
+var LEARN_FIELDS = [
+  ["kbid", "kbid"],
+  ["path", "path"],
+  ["size", "size"],
+  ["skipped", "skipped"],
+  ["superseded", "superseded"],
+  ["warnings", "warnings"],
+  ["level", "level"]
+];
+var UNLEARN_FIELDS = [
+  ["removed", "removed"],
+  ["elapsed_ms", "elapsed_ms"]
+];
+var RECALL_FIELDS = [
+  ["kbid", "kbid"],
+  ["heading", "heading"],
+  ["type", "type"],
+  ["docids", "docids"],
+  ["content", "content"],
+  ["level", "level"]
+];
+var EXPORT_FIELDS = [
+  ["path", "path"],
+  ["sections", "sections_exported"],
+  ["documents", "documents_exported"],
+  ["elapsed_ms", "elapsed_ms"]
+];
+var IMPORT_FIELDS = [
+  ["sections", "sections_imported"],
+  ["documents", "documents_imported"],
+  ["rebuilt", "rebuilt"],
+  ["dry_run", "dry_run"],
+  ["elapsed_ms", "elapsed_ms"]
+];
+var STATUS_FIELDS = [
+  ["initialized", "initialized"],
+  ["path", "contextPath"],
+  ["content_cached", "cacheStats.contentCount"],
+  ["index_cached", "cacheStats.indexCount"]
+];
+var CHECK_FIELDS = [
+  ["ok", "ok"],
+  ["sections_checked", "sections_checked"],
+  ["documents_checked", "documents_checked"],
+  ["references_checked", "references_checked"],
+  ["elapsed_ms", "elapsed_ms"]
+];
+var GC_FIELDS = [
+  ["removed_sections", "removed_sections"],
+  ["removed_bytes", "removed_bytes"],
+  ["elapsed_ms", "elapsed_ms"]
+];
+var REBUILD_FIELDS = [
+  ["sections_reindexed", "sections_reindexed"],
+  ["terms_indexed", "terms_indexed"],
+  ["elapsed_ms", "elapsed_ms"]
+];
+
+// src/shared/cli/functions/format-output.function.ts
+function formatOutput(paged, format) {
+  switch (format) {
+    case "json":
+      return JSON.stringify(paged, null, 2);
+    case "text":
+      return formatTextOutput(paged);
+    case "rec":
+      return formatRecfileOutput(paged.items, SEARCH_FIELDS);
+    case "mcp":
+      return formatMcpOutput(paged);
+  }
+}
+
+// src/shared/cli/constants/recfile-command-field-map.constant.ts
+var RECFILE_COMMAND_FIELD_MAP = {
+  learn: LEARN_FIELDS,
+  unlearn: UNLEARN_FIELDS,
+  recall: RECALL_FIELDS,
+  export: EXPORT_FIELDS,
+  import: IMPORT_FIELDS,
+  status: STATUS_FIELDS,
+  check: CHECK_FIELDS,
+  gc: GC_FIELDS,
+  rebuild: REBUILD_FIELDS
+};
+
+// src/shared/cli/functions/format-command-output.function.ts
+function formatCommandOutput(data, format, command) {
+  switch (format) {
+    case "rec": {
+      const fields = RECFILE_COMMAND_FIELD_MAP[command];
+      return fields ? formatRecfileOutput(data, fields) : JSON.stringify(data, null, 2);
+    }
+    case "json":
+    case "text":
+    case "mcp":
+      return JSON.stringify(data, null, 2);
+  }
+}
+
 // src/shared/log/constants/log-colors.constant.ts
 var ANSI_RESET = "\x1B[0m";
 var LOG_COLORS = {
@@ -452,15 +583,64 @@ async function runRecall(client, options) {
 }
 
 // src/shared/cli/functions/run-export.function.ts
+var import_node_path = require("node:path");
 async function runExport(client, options) {
   log("running export", 0 /* DEBUG */);
-  const path = options.args[0];
+  const path = options.args.length > 0 ? (0, import_node_path.resolve)(process.cwd(), options.args[0]) : void 0;
   return client.export({ path });
 }
 
 // src/shared/cli/functions/run-learn.function.ts
+var import_node_fs2 = require("node:fs");
+
+// src/shared/cli/functions/collect-files.function.ts
 var import_node_fs = require("node:fs");
-var import_node_path3 = require("node:path");
+var import_node_path2 = require("node:path");
+function collectFiles(target) {
+  try {
+    const stat = (0, import_node_fs.statSync)(target);
+    if (stat.isFile()) {
+      return isSupportedFile(target) ? [target] : [];
+    }
+    if (stat.isDirectory()) {
+      return scanDirectory(target);
+    }
+  } catch {
+  }
+  return [];
+}
+function scanDirectory(dir) {
+  const files = [];
+  for (const entry of (0, import_node_fs.readdirSync)(dir)) {
+    if (entry.startsWith(".")) continue;
+    const full = (0, import_node_path2.join)(dir, entry);
+    try {
+      const stat = (0, import_node_fs.statSync)(full);
+      if (stat.isDirectory()) {
+        files.push(...scanDirectory(full));
+      } else if (isSupportedFile(full)) {
+        files.push(full);
+      }
+    } catch {
+    }
+  }
+  return files;
+}
+function isSupportedFile(path) {
+  if ((0, import_node_path2.basename)(path).startsWith(".")) return false;
+  const ext = (0, import_node_path2.extname)(path).toLowerCase();
+  return SUPPORTED_EXTENSIONS.includes(ext);
+}
+
+// src/shared/cli/functions/compute-directory-level.function.ts
+var MAX_LEVEL = 6;
+function computeDirectoryLevel(filePath, basePath) {
+  const relative = filePath.slice(basePath.length).replace(/^\//, "");
+  const depth = relative.split("/").length - 1;
+  return Math.min(depth + 1, MAX_LEVEL);
+}
+
+// src/shared/cli/functions/run-learn.function.ts
 async function runLearn(client, options, io) {
   log(
     "learning " + options.args.length.toString() + " targets",
@@ -481,14 +661,15 @@ async function runLearn(client, options, io) {
         description: options.description,
         docid: options.docid,
         tags: options.tags,
-        replace: options.replace
+        replace: options.replace,
+        level: options.level
       });
       results.push(mapAddSectionResult(result, "-", content.length));
       continue;
     }
     const files = collectFiles(target);
     for (const file of files) {
-      const content = (0, import_node_fs.readFileSync)(file, "utf-8");
+      const content = (0, import_node_fs2.readFileSync)(file, "utf-8");
       const result = await client.addSection({
         sectionType: "text",
         content,
@@ -497,7 +678,8 @@ async function runLearn(client, options, io) {
         docid: options.docid,
         tags: options.tags,
         replace: options.replace,
-        sourcePath: file
+        sourcePath: file,
+        level: options.level ?? computeDirectoryLevel(file, target)
       });
       results.push(
         mapAddSectionResult(result, file, content.length)
@@ -522,52 +704,17 @@ function mapAddSectionResult(result, path, size) {
   };
 }
 function readProcessStdin() {
-  return new Promise((resolve4) => {
+  return new Promise((resolve7) => {
     const chunks = [];
     process.stdin.on("data", (chunk) => {
       chunks.push(chunk);
     });
     process.stdin.on("end", () => {
-      resolve4(Buffer.concat(chunks).toString("utf-8"));
+      resolve7(Buffer.concat(chunks).toString("utf-8"));
     });
     process.stdin.resume();
   });
 }
-function collectFiles(target) {
-  try {
-    const stat = (0, import_node_fs.statSync)(target);
-    if (stat.isFile()) {
-      return isSupportedFile(target) ? [target] : [];
-    }
-    if (stat.isDirectory()) {
-      return scanDirectory(target);
-    }
-  } catch {
-  }
-  return [];
-}
-function scanDirectory(dir) {
-  const files = [];
-  for (const entry of (0, import_node_fs.readdirSync)(dir)) {
-    if (entry.startsWith(".")) continue;
-    const full = (0, import_node_path3.join)(dir, entry);
-    try {
-      const stat = (0, import_node_fs.statSync)(full);
-      if (stat.isDirectory()) {
-        files.push(...scanDirectory(full));
-      } else if (isSupportedFile(full)) {
-        files.push(full);
-      }
-    } catch {
-    }
-  }
-  return files;
-}
-function isSupportedFile(path) {
-  if ((0, import_node_path3.basename)(path).startsWith(".")) return false;
-  const ext = (0, import_node_path3.extname)(path).toLowerCase();
-  return SUPPORTED_EXTENSIONS.includes(ext);
-}
 
 // src/shared/cli/functions/run-unlearn.function.ts
 async function runUnlearn(client, options) {
@@ -627,33 +774,33 @@ async function runRebuild(client, _options) {
 }
 
 // src/shared/cli/functions/find-db.function.ts
-var import_node_fs2 = require("node:fs");
-var import_node_path4 = require("node:path");
+var import_node_fs3 = require("node:fs");
+var import_node_path3 = require("node:path");
 function findDb(dbPath) {
   if (dbPath) {
-    const target = (0, import_node_path4.join)((0, import_node_path4.resolve)(dbPath), ".kbdb");
-    return (0, import_node_fs2.existsSync)(target) ? target : null;
+    const target = (0, import_node_path3.join)((0, import_node_path3.resolve)(dbPath), ".kbdb");
+    return (0, import_node_fs3.existsSync)(target) ? target : null;
   }
   let current = process.cwd();
-  let parent = (0, import_node_path4.dirname)(current);
+  let parent = (0, import_node_path3.dirname)(current);
   while (parent !== current) {
-    const candidate2 = (0, import_node_path4.join)(current, ".kbdb");
-    if ((0, import_node_fs2.existsSync)(candidate2)) return candidate2;
+    const candidate2 = (0, import_node_path3.join)(current, ".kbdb");
+    if ((0, import_node_fs3.existsSync)(candidate2)) return candidate2;
     current = parent;
-    parent = (0, import_node_path4.dirname)(current);
+    parent = (0, import_node_path3.dirname)(current);
   }
-  const candidate = (0, import_node_path4.join)(current, ".kbdb");
-  return (0, import_node_fs2.existsSync)(candidate) ? candidate : null;
+  const candidate = (0, import_node_path3.join)(current, ".kbdb");
+  return (0, import_node_fs3.existsSync)(candidate) ? candidate : null;
 }
 
 // src/shared/cli/functions/run-init.function.ts
-var import_node_fs4 = require("node:fs");
-var import_node_path6 = require("node:path");
+var import_node_fs5 = require("node:fs");
+var import_node_path5 = require("node:path");
 
 // src/shared/cli/functions/install-default-skills.function.ts
 var import_node_crypto = require("node:crypto");
-var import_node_fs3 = require("node:fs");
-var import_node_path5 = require("node:path");
+var import_node_fs4 = require("node:fs");
+var import_node_path4 = require("node:path");
 var BASE32_ALPHABET = "ABCDEFGHIJKLMNOPQRSTUVWXYZ234567";
 function base32Encode(bytes) {
   let result = "";
@@ -714,19 +861,19 @@ function installSkill(sectionsDir, skill) {
   });
   const kbid = computeSectionKbid("text/markdown", content);
   const prefix = kbid.slice(0, 2);
-  const shardDir = (0, import_node_path5.join)(sectionsDir, prefix);
-  const filePath = (0, import_node_path5.join)(shardDir, `${kbid}.section`);
-  if ((0, import_node_fs3.existsSync)(filePath)) {
+  const shardDir = (0, import_node_path4.join)(sectionsDir, prefix);
+  const filePath = (0, import_node_path4.join)(shardDir, `${kbid}.section`);
+  if ((0, import_node_fs4.existsSync)(filePath)) {
     return;
   }
-  (0, import_node_fs3.mkdirSync)(shardDir, { recursive: true });
+  (0, import_node_fs4.mkdirSync)(shardDir, { recursive: true });
   const fileContent = serializeSkillSection(
     kbid,
     skill.name,
     skill.description,
     content
   );
-  (0, import_node_fs3.writeFileSync)(filePath, fileContent, "utf-8");
+  (0, import_node_fs4.writeFileSync)(filePath, fileContent, "utf-8");
 }
 var QUERY_GUIDANCE_BODY = 'This knowledge base uses lexical search (stemmed BM25F), not semantic/vector search. Follow these guidelines for effective retrieval:\n\n1. Issue MULTIPLE short keyword queries rather than one long natural-language question. Each query should target 2-3 specific terms.\n\n2. EXPAND SYNONYMS yourself. "login" will not match "sign-in" unless both terms appear in the content. Try alternative phrasings: search for "login", then "sign-in", then "authentication".\n\n3. USE BOOLEAN AND PHRASE SYNTAX:\n   - Exact phrases: "error handling"\n   - Boolean AND: auth AND token\n   - Boolean OR: cache OR redis\n   - Exclusion: auth -oauth\n\n4. LEAN ON HEADINGS. Headings carry 2x weight in ranking. Search for terms that are likely in section titles.\n\n5. STEMMING IS AUTOMATIC. "connections" matches "connect", "running" matches "run". You do not need to try inflected forms.\n\n6. USE RECALL AFTER SEARCH. After finding relevant sections with search, use recall with increasing depth (0-3) to progressively expand context: depth 0 = full content, depth 1 = parent documents + back-references, depth 2 = siblings + forward references, depth 3 = referenced sections.\n\n7. CODE IDENTIFIERS ARE SPLIT. camelCase and snake_case names are decomposed: getUserById becomes searchable as "get", "user", "by", "id".\n\n8. PAGINATION. Default limit is 20 results. Use offset for additional pages if total > limit.';
 var MEMORY_PROTOCOL_BODY = "Follow these guidelines to keep the knowledge base accurate and useful:\n\n1. STORE DURABLE FACTS: decisions, architecture choices, configuration values, corrections to prior knowledge, API contracts, and resolved incidents. These are the facts that matter weeks later.\n\n2. DO NOT STORE: transient conversation context, debugging output, ephemeral task state, raw log dumps, or information that changes every session. The brain should contain knowledge, not activity logs.\n\n3. SEARCH BEFORE STORING. Always search the knowledge base before adding new content. If a section already covers the topic, use learn with --replace to update it rather than creating a duplicate.\n\n4. USE --replace FOR CORRECTIONS. When a fact changes (e.g., rate limit updated from 100 to 200 req/min), re-learn the corrected content with --replace so the old version is superseded. Without --replace, both the old and new versions coexist with equal ranking.\n\n5. ATTACH TAGS for scoping. Use tags like project name, domain, or topic (e.g., --tags auth,api,v2) so queries can be filtered by scope later.\n\n6. PREFER RECENT RESULTS. When search returns multiple sections covering the same topic, prefer the one with the most recent created_at timestamp -- it is more likely to reflect the current state.\n\n7. USE RECALL AFTER SEARCH. After finding relevant sections, use recall with increasing depth (0-3) to expand context progressively before making decisions.\n\n8. INCLUDE HEADINGS. Always provide a descriptive title when storing content. Headings carry 2x ranking weight -- omitting them significantly reduces searchability.";
@@ -743,7 +890,7 @@ var DEFAULT_SKILLS = [
   }
 ];
 function installDefaultSkills(dbDir) {
-  const sectionsDir = (0, import_node_path5.join)(dbDir, "sections");
+  const sectionsDir = (0, import_node_path4.join)(dbDir, "sections");
   for (const skill of DEFAULT_SKILLS) {
     installSkill(sectionsDir, skill);
   }
@@ -767,22 +914,22 @@ var GITIGNORE = [
   ""
 ].join("\n");
 function createScaffold(dbDir) {
-  (0, import_node_fs4.mkdirSync)(dbDir, { recursive: true });
-  (0, import_node_fs4.mkdirSync)((0, import_node_path6.join)(dbDir, "sections"));
-  (0, import_node_fs4.mkdirSync)((0, import_node_path6.join)(dbDir, "documents"));
-  (0, import_node_fs4.writeFileSync)((0, import_node_path6.join)(dbDir, "catalog.toml"), CATALOG_TOML);
-  (0, import_node_fs4.writeFileSync)((0, import_node_path6.join)(dbDir, "corpus.bin"), "");
-  (0, import_node_fs4.writeFileSync)((0, import_node_path6.join)(dbDir, "inverted.idx"), "");
-  (0, import_node_fs4.writeFileSync)((0, import_node_path6.join)(dbDir, "positional.idx"), "");
-  (0, import_node_fs4.writeFileSync)((0, import_node_path6.join)(dbDir, "worker.toml"), WORKER_TOML);
-  (0, import_node_fs4.writeFileSync)((0, import_node_path6.join)(dbDir, ".gitignore"), GITIGNORE);
+  (0, import_node_fs5.mkdirSync)(dbDir, { recursive: true });
+  (0, import_node_fs5.mkdirSync)((0, import_node_path5.join)(dbDir, "sections"));
+  (0, import_node_fs5.mkdirSync)((0, import_node_path5.join)(dbDir, "documents"));
+  (0, import_node_fs5.writeFileSync)((0, import_node_path5.join)(dbDir, "catalog.toml"), CATALOG_TOML);
+  (0, import_node_fs5.writeFileSync)((0, import_node_path5.join)(dbDir, "corpus.bin"), "");
+  (0, import_node_fs5.writeFileSync)((0, import_node_path5.join)(dbDir, "inverted.idx"), "");
+  (0, import_node_fs5.writeFileSync)((0, import_node_path5.join)(dbDir, "positional.idx"), "");
+  (0, import_node_fs5.writeFileSync)((0, import_node_path5.join)(dbDir, "worker.toml"), WORKER_TOML);
+  (0, import_node_fs5.writeFileSync)((0, import_node_path5.join)(dbDir, ".gitignore"), GITIGNORE);
 }
 function runInit(options) {
   log("running init", 0 /* DEBUG */);
-  const basePath = options.dbPath ? (0, import_node_path6.resolve)(options.dbPath) : process.cwd();
-  const dbDir = (0, import_node_path6.join)(basePath, ".kbdb");
+  const basePath = options.dbPath ? (0, import_node_path5.resolve)(options.dbPath) : process.cwd();
+  const dbDir = (0, import_node_path5.join)(basePath, ".kbdb");
   try {
-    if ((0, import_node_fs4.existsSync)(dbDir)) {
+    if ((0, import_node_fs5.existsSync)(dbDir)) {
       return {
         ok: false,
         targetPath: dbDir,
@@ -816,14 +963,14 @@ async function promptUser(question, io) {
   return answer.trim();
 }
 function askReadline(question) {
-  return new Promise((resolve4) => {
+  return new Promise((resolve7) => {
     const rl = (0, import_node_readline.createInterface)({
       input: process.stdin,
       output: process.stdout
     });
     rl.question(question, (answer) => {
       rl.close();
-      resolve4(answer);
+      resolve7(answer);
     });
   });
 }
@@ -1153,6 +1300,7 @@ async function runAgentDelete(client, options) {
 }
 
 // src/shared/cli/functions/run-import.function.ts
+var import_node_path6 = require("node:path");
 async function runImport(client, options) {
   const from = options.from;
   if (!from) {
@@ -1161,11 +1309,24 @@ async function runImport(client, options) {
     throw new Error(msg);
   }
   return client.import({
-    from,
+    from: (0, import_node_path6.resolve)(process.cwd(), from),
     dryRun: options.dryRun === true
   });
 }
 
+// src/shared/cli/functions/hydrate-search-previews.function.ts
+async function hydrateSearchPreviews(client, paged) {
+  await Promise.all(
+    paged.items.map(async (result) => {
+      try {
+        const contentResult = await client.content([result.kbid]);
+        result.preview = contentResult.data;
+      } catch {
+      }
+    })
+  );
+}
+
 // src/shared/cli/functions/dispatch-command.function.ts
 async function dispatchCommand(client, options, io) {
   log("dispatching command: " + options.command, 0 /* DEBUG */);
@@ -1240,7 +1401,7 @@ async function handleLearn(client, options, io) {
   try {
     const results = await runLearn(client, options, io);
     return {
-      output: JSON.stringify(results, null, 2),
+      output: formatCommandOutput(results, options.format, "learn"),
       exitCode: 0
     };
   } catch (err) {
@@ -1254,7 +1415,11 @@ async function handleUnlearn(client, options) {
   try {
     const results = await runUnlearn(client, options);
     return {
-      output: JSON.stringify(results, null, 2),
+      output: formatCommandOutput(
+        results,
+        options.format,
+        "unlearn"
+      ),
       exitCode: 0
     };
   } catch (err) {
@@ -1291,7 +1456,7 @@ async function handleRecall(client, options) {
       };
     }
     return {
-      output: JSON.stringify(result, null, 2),
+      output: formatCommandOutput(result, options.format, "recall"),
       exitCode: 0
     };
   } catch (err) {
@@ -1305,7 +1470,7 @@ async function handleExport(client, options) {
   try {
     const result = await runExport(client, options);
     return {
-      output: JSON.stringify(result, null, 2),
+      output: formatCommandOutput(result, options.format, "export"),
       exitCode: 0
     };
   } catch (err) {
@@ -1319,7 +1484,7 @@ async function handleImport(client, options) {
   try {
     const result = await runImport(client, options);
     return {
-      output: JSON.stringify(result, null, 2),
+      output: formatCommandOutput(result, options.format, "import"),
       exitCode: 0
     };
   } catch (err) {
@@ -1332,6 +1497,9 @@ async function handleImport(client, options) {
 async function handleContent(client, options) {
   try {
     const result = await runContent(client, options);
+    if (options.format === "rec") {
+      return { output: result.data, exitCode: 0 };
+    }
     return {
       output: JSON.stringify(result, null, 2),
       exitCode: 0
@@ -1347,7 +1515,7 @@ async function handleCheck(client, options) {
   try {
     const result = await runCheck(client, options);
     return {
-      output: JSON.stringify(result, null, 2),
+      output: formatCommandOutput(result, options.format, "check"),
       exitCode: result.ok ? 0 : 1
     };
   } catch (err) {
@@ -1361,7 +1529,7 @@ async function handleGc(client, options) {
   try {
     const result = await runGc(client, options);
     return {
-      output: JSON.stringify(result, null, 2),
+      output: formatCommandOutput(result, options.format, "gc"),
       exitCode: 0
     };
   } catch (err) {
@@ -1375,7 +1543,7 @@ async function handleRebuild(client, options) {
   try {
     const result = await runRebuild(client, options);
     return {
-      output: JSON.stringify(result, null, 2),
+      output: formatCommandOutput(result, options.format, "rebuild"),
       exitCode: 0
     };
   } catch (err) {
@@ -1389,7 +1557,7 @@ async function handleStatus(client, options) {
   try {
     const result = await runStatus(client, options);
     return {
-      output: JSON.stringify(result, null, 2),
+      output: formatCommandOutput(result, options.format, "status"),
       exitCode: 0
     };
   } catch (err) {
@@ -1406,7 +1574,11 @@ async function handleDbMigrate(client, options) {
   try {
     const result = await runDbMigrate(client, options);
     return {
-      output: JSON.stringify(result, null, 2),
+      output: formatCommandOutput(
+        result,
+        options.format,
+        "db-migrate"
+      ),
       exitCode: 0
     };
   } catch (err) {
@@ -1416,20 +1588,9 @@ async function handleDbMigrate(client, options) {
     };
   }
 }
-async function hydrateSearchPreviews(client, paged) {
-  await Promise.all(
-    paged.items.map(async (result) => {
-      try {
-        const contentResult = await client.content([result.kbid]);
-        result.preview = contentResult.data;
-      } catch {
-      }
-    })
-  );
-}
 
 // src/shared/version/constants/version.constant.ts
-var VERSION = "0.5.0";
+var VERSION = "0.6.1";
 
 // src/shared/cli/functions/generate-help.function.ts
 var KNOWN_COMMANDS = /* @__PURE__ */ new Set([
@@ -1452,7 +1613,8 @@ var KNOWN_COMMANDS = /* @__PURE__ */ new Set([
 var GROUP_SUBCOMMANDS = {
   db: [
     ["init", "Initialise a new .kbdb directory"],
-    ["migrate", "Migrate database to current format"]
+    ["migrate", "Migrate database to current format"],
+    ["path", "Show resolved database path"]
   ],
   skill: [
     ["learn", "Create a new skill definition"],
@@ -1516,6 +1678,7 @@ Knowledge Base:
 Database:
    db init             Initialise a new .kbdb directory
    db migrate          Migrate database to current format
+   db path             Show resolved database path
 
 Maintenance:
    check               Verify knowledge base integrity
@@ -1812,6 +1975,30 @@ Output:
 Examples:
    kbdb db migrate
    kbdb db migrate --db /path/to/project
+`,
+  "db-path": `kbdb db path - Show resolved database path
+
+Usage: kbdb db path [options]
+
+Prints the absolute path of the .kbdb database
+that would be used by the current command
+context. Useful for debugging database
+resolution.
+
+Resolution order:
+   1. --db <path>       Explicit flag
+   2. cwd traversal     Walk up from cwd
+   3. KBDB_DB_DIR       Environment variable
+
+Options:
+   --db <path>         Path to .kbdb directory
+   --format json       Show full diagnostic
+   -h, --help          Show this help message
+
+Examples:
+   kbdb db path
+   kbdb db path --format json
+   kbdb db path --db /path/to/project
 `,
   "skill-learn": `kbdb skill learn - Create a new skill definition
 
@@ -1973,11 +2160,78 @@ function generateSubcommandHelp(command, subcommand) {
   return generateCommandHelp(command);
 }
 
+// src/shared/cli/functions/resolve-db-dir.function.ts
+function resolveDbDir(options, findDb2) {
+  if (options.dbPath) {
+    const flagResult = findDb2(options.dbPath);
+    return flagResult ? { path: flagResult, source: "flag" } : null;
+  }
+  if (!options.skipTraversal) {
+    const traversalResult = findDb2();
+    if (traversalResult) {
+      return { path: traversalResult, source: "traversal" };
+    }
+  }
+  const envDir = process.env["KBDB_DB_DIR"];
+  if (envDir) {
+    const envResult = findDb2(envDir);
+    if (envResult) {
+      return { path: envResult, source: "env" };
+    }
+  }
+  return null;
+}
+
+// src/shared/cli/functions/format-db-not-found.function.ts
+function formatDbNotFound(options) {
+  if (options.dbPath) {
+    return `error: no .kbdb database found at ${options.dbPath}`;
+  }
+  const envValue = process.env["KBDB_DB_DIR"] ?? "(not set)";
+  const lines = [
+    "error: no .kbdb database found",
+    "  --db:         (not set)"
+  ];
+  if (!options.skipTraversal) {
+    lines.push(`  cwd:          ${process.cwd()} (searched upward)`);
+  }
+  lines.push(`  KBDB_DB_DIR:  ${envValue}`);
+  if (!options.skipTraversal) {
+    lines.push('Run "kbdb db init" to create a database.');
+  }
+  return lines.join("\n");
+}
+
+// src/shared/cli/functions/run-db-path.function.ts
+function runDbPath(options, findDb2) {
+  const resolution = resolveDbDir({ dbPath: options.dbPath }, findDb2);
+  if (!resolution) {
+    return {
+      error: formatDbNotFound({ dbPath: options.dbPath }),
+      exitCode: 1
+    };
+  }
+  if (options.format === "json") {
+    const diagnostic = {
+      path: resolution.path,
+      source: resolution.source,
+      flag: options.dbPath ?? null,
+      cwd: process.cwd(),
+      env: process.env["KBDB_DB_DIR"] ?? null
+    };
+    return {
+      output: JSON.stringify(diagnostic, null, 2),
+      exitCode: 0
+    };
+  }
+  return { output: resolution.path, exitCode: 0 };
+}
+
 // src/shared/worker-client/classes/worker-client.class.ts
 var import_node_net = require("node:net");
 
 // src/shared/worker-client/functions/discover-daemon.function.ts
-var import_node_fs5 = require("node:fs");
+var import_node_fs6 = require("node:fs");
 var import_node_path7 = require("node:path");
 var import_node_os = require("node:os");
 
@@ -1995,14 +2249,14 @@ function isProcessAlive(pid) {
 function discoverDaemon(contextId) {
   log("discovering daemon for context: " + contextId, 0 /* DEBUG */);
   const pidPath = (0, import_node_path7.join)((0, import_node_os.tmpdir)(), `kbdb-${contextId}.pid`);
-  if (!(0, import_node_fs5.existsSync)(pidPath)) {
+  if (!(0, import_node_fs6.existsSync)(pidPath)) {
     log(
       "no daemon PID file found for context: " + contextId,
       0 /* DEBUG */
     );
     return null;
   }
-  const pidStr = (0, import_node_fs5.readFileSync)(pidPath, "utf-8").trim();
+  const pidStr = (0, import_node_fs6.readFileSync)(pidPath, "utf-8").trim();
   const pid = parseInt(pidStr, 10);
   if (isNaN(pid) || !isProcessAlive(pid)) {
     log(
@@ -2010,7 +2264,7 @@ function discoverDaemon(contextId) {
       0 /* DEBUG */
     );
     try {
-      (0, import_node_fs5.unlinkSync)(pidPath);
+      (0, import_node_fs6.unlinkSync)(pidPath);
     } catch {
     }
     return null;
@@ -2019,7 +2273,7 @@ function discoverDaemon(contextId) {
   const socketPath = (0, import_node_path7.join)((0, import_node_os.tmpdir)(), `kbdb-${contextId}.sock`);
   const crashPath = (0, import_node_path7.join)((0, import_node_os.tmpdir)(), `kbdb-${contextId}.crash`);
   try {
-    (0, import_node_fs5.unlinkSync)(crashPath);
+    (0, import_node_fs6.unlinkSync)(crashPath);
   } catch {
   }
   return { pid, socketPath };
@@ -2117,7 +2371,7 @@ var WorkerClient = class {
    * post-connect failure handlers.
    */
   async tryConnect() {
-    return new Promise((resolve4, reject) => {
+    return new Promise((resolve7, reject) => {
       const sock = (0, import_node_net.connect)(this.socketPath, () => {
         sock.removeListener("error", reject);
         sock.setKeepAlive(true, 3e4);
@@ -2138,7 +2392,7 @@ var WorkerClient = class {
           this.socket = null;
         });
         this.socket = sock;
-        resolve4();
+        resolve7();
       });
       sock.on("error", reject);
       sock.on("data", (chunk) => {
@@ -2466,8 +2720,8 @@ var WorkerClient = class {
       params: { ctx: this.contextId, ...params }
     };
     const timeoutMs = this.requestTimeoutMs;
-    return new Promise((resolve4, reject) => {
-      const call = { resolve: resolve4, reject };
+    return new Promise((resolve7, reject) => {
+      const call = { resolve: resolve7, reject };
       if (timeoutMs) {
         call.timer = setTimeout(() => {
           if (!this.pending.has(id)) return;
@@ -2536,18 +2790,13 @@ var WorkerClient = class {
   }
 };
 
-// src/shared/worker-client/functions/create-worker-client.function.ts
-var import_node_fs8 = require("node:fs");
-var import_node_path11 = require("node:path");
-var import_node_os4 = require("node:os");
-
 // src/shared/worker-client/functions/resolve-db-path.function.ts
-var import_node_fs6 = require("node:fs");
+var import_node_fs7 = require("node:fs");
 var import_node_path8 = require("node:path");
 function resolveDbPath(targetDir) {
   const base = targetDir ? (0, import_node_path8.resolve)(targetDir) : process.cwd();
   const dbPath = (0, import_node_path8.join)(base, ".kbdb");
-  if (!(0, import_node_fs6.existsSync)(dbPath)) {
+  if (!(0, import_node_fs7.existsSync)(dbPath)) {
     const msg = `database not found: ${dbPath}`;
     log(msg, 3 /* ERROR */);
     throw new Error(msg);
@@ -2571,16 +2820,35 @@ async function computeContextId(absolutePath) {
 
 // src/shared/worker-client/functions/spawn-daemon.function.ts
 var import_node_child_process = require("node:child_process");
-function spawnDaemon(contextPath, runtime2, workerScript2) {
-  if (!workerScript2) {
+
+// src/shared/worker-client/functions/build-deno-permissions.function.ts
+function buildDenoPermissions() {
+  return [
+    "--allow-read",
+    "--allow-write",
+    "--allow-env",
+    "--allow-run",
+    "--allow-sys"
+  ];
+}
+
+// src/shared/worker-client/functions/spawn-daemon.function.ts
+function spawnDaemon(contextPath, runtime, workerScript) {
+  if (!workerScript) {
     const msg = "workerScript must be provided (resolve at entry point)";
     log(msg, 3 /* ERROR */);
     throw new Error(msg);
   }
-  const execPath = runtime2 === "deno" ? "deno" : process.execPath;
+  const execPath = runtime === "deno" ? "deno" : process.execPath;
   const logLevelEnv = process.env["KBDB_LOG_LEVEL"];
   const logArgs = logLevelEnv ? ["--log-level", logLevelEnv] : [];
-  const args = runtime2 === "deno" ? ["run", "--allow-all", workerScript2, contextPath, ...logArgs] : [workerScript2, contextPath, ...logArgs];
+  const args = runtime === "deno" ? [
+    "run",
+    ...buildDenoPermissions(),
+    workerScript,
+    contextPath,
+    ...logArgs
+  ] : [workerScript, contextPath, ...logArgs];
   log(
     "spawning daemon: " + execPath + " " + args.join(" "),
     0 /* DEBUG */
@@ -2593,7 +2861,7 @@ function spawnDaemon(contextPath, runtime2, workerScript2) {
 }
 
 // src/shared/worker-client/functions/wait-for-daemon.function.ts
-var import_node_fs7 = require("node:fs");
+var import_node_fs8 = require("node:fs");
 var import_node_path9 = require("node:path");
 var import_node_os2 = require("node:os");
 var DEFAULT_TIMEOUT_MS = 1e4;
@@ -2604,7 +2872,7 @@ async function waitForDaemon(contextId, timeoutMs = DEFAULT_TIMEOUT_MS) {
   const start = Date.now();
   let iteration = 0;
   while (Date.now() - start < timeoutMs) {
-    if ((0, import_node_fs7.existsSync)(pidPath)) {
+    if ((0, import_node_fs8.existsSync)(pidPath)) {
       log("daemon PID file appeared", 0 /* DEBUG */);
       return true;
     }
@@ -2626,13 +2894,71 @@ async function waitForDaemon(contextId, timeoutMs = DEFAULT_TIMEOUT_MS) {
   return false;
 }
 
-// src/shared/platform/functions/get-ipc-path.function.ts
+// src/shared/worker-client/functions/read-crash-reason.function.ts
+var import_node_fs9 = require("node:fs");
 var import_node_path10 = require("node:path");
+var import_node_os3 = require("node:os");
+function readCrashReason(contextId) {
+  const crashPath = (0, import_node_path10.join)((0, import_node_os3.tmpdir)(), `kbdb-${contextId}.crash`);
+  if (!(0, import_node_fs9.existsSync)(crashPath)) {
+    return "daemon failed to start (no details available)";
+  }
+  try {
+    const raw = (0, import_node_fs9.readFileSync)(crashPath, "utf-8");
+    const crash = JSON.parse(raw);
+    (0, import_node_fs9.unlinkSync)(crashPath);
+    return crash.error ?? "unknown error (crash log empty)";
+  } catch {
+    return "daemon failed to start (crash log unreadable)";
+  }
+}
+
+// src/shared/worker-client/functions/resolve-spawn-script.function.ts
+var import_node_path12 = require("node:path");
+var import_node_url = require("node:url");
+
+// src/shared/dir-resolver/functions/join-path.function.ts
+var import_node_path11 = require("node:path");
+function isRemoteUrl(path) {
+  return path.startsWith("http://") || path.startsWith("https://");
+}
+function joinPath(base, ...segments) {
+  if (isRemoteUrl(base)) {
+    const trailing = base.endsWith("/") ? "" : "/";
+    return base + trailing + segments.join("/");
+  }
+  return (0, import_node_path11.join)(base, ...segments);
+}
+
+// src/shared/dir-resolver/functions/resolve-worker-script.function.ts
+function resolveWorkerScript(scriptDir, runtime) {
+  if (runtime === "deno") {
+    return joinPath(scriptDir, "worker.ts");
+  }
+  return joinPath(scriptDir, "kbdb-worker.cjs");
+}
+
+// src/shared/worker-client/functions/resolve-spawn-script.function.ts
+var import_meta = {};
+function resolveSpawnScript(runtime) {
+  return resolveWorkerScript(resolveScriptDir2(runtime), runtime);
+}
+function resolveScriptDir2(runtime) {
+  if (typeof __dirname !== "undefined") return __dirname;
+  const thisDir = (0, import_node_path12.dirname)((0, import_node_url.fileURLToPath)(import_meta.url));
+  if (runtime === "deno") {
+    return (0, import_node_path12.resolve)(thisDir, "..", "..", "..");
+  }
+  return thisDir;
+}
+
+// src/shared/platform/functions/get-ipc-path.function.ts
+var import_node_path13 = require("node:path");
 
 // src/shared/platform/functions/get-tmpdir.function.ts
-var import_node_os3 = require("node:os");
+var import_node_os4 = require("node:os");
 function getTmpdir() {
-  return (0, import_node_os3.tmpdir)();
+  return (0, import_node_os4.tmpdir)();
 }
 
 // src/shared/platform/functions/get-ipc-path.function.ts
@@ -2640,7 +2966,7 @@ function getIpcPath(ctx) {
   if (process.platform === "win32") {
     return `\\\\.\\pipe\\kbdb-${ctx}`;
   }
-  return (0, import_node_path10.join)(getTmpdir(), `kbdb-${ctx}.sock`);
+  return (0, import_node_path13.join)(getTmpdir(), `kbdb-${ctx}.sock`);
 }
 
 // src/shared/worker-client/functions/create-worker-client.function.ts
@@ -2656,9 +2982,10 @@ async function createWorkerClient(options) {
     log("no daemon found", 0 /* DEBUG */);
   }
   if (!daemon && options?.autoSpawn !== false) {
-    const runtime2 = detectRuntime();
+    const runtime = detectRuntime();
     log("auto-spawning daemon", 0 /* DEBUG */);
-    spawnDaemon(dbPath, runtime2, options?.workerScript);
+    const workerScript = resolveSpawnScript(runtime);
+    spawnDaemon(dbPath, runtime, workerScript);
     log("waiting for daemon after spawn", 0 /* DEBUG */);
     await waitForDaemon(contextId, options?.connectTimeoutMs);
     daemon = discoverDaemon(contextId);
@@ -2677,20 +3004,6 @@ async function createWorkerClient(options) {
   await client.connect();
   return client;
 }
-function readCrashReason(contextId) {
-  const crashPath = (0, import_node_path11.join)((0, import_node_os4.tmpdir)(), `kbdb-${contextId}.crash`);
-  if (!(0, import_node_fs8.existsSync)(crashPath)) {
-    return "daemon failed to start (no details available)";
-  }
-  try {
-    const raw = (0, import_node_fs8.readFileSync)(crashPath, "utf-8");
-    const crash = JSON.parse(raw);
-    (0, import_node_fs8.unlinkSync)(crashPath);
-    return crash.error ?? "unknown error (crash log empty)";
-  } catch {
-    return "daemon failed to start (crash log unreadable)";
-  }
-}
 
 // src/shared/cli/functions/run-worker-stop.function.ts
 async function runWorkerStop(dbDir) {
@@ -2754,11 +3067,6 @@ async function runWorkerRestart(dbDir) {
   };
 }
 
-// src/shared/cli/functions/resolve-raw-db-path.function.ts
-function resolveRawDbPath(options) {
-  return options.dbPath ?? process.env["KBDB_DB_DIR"];
-}
-
 // src/shared/worker-client/functions/retry-on-timeout.function.ts
 async function retryOnTimeout(createClient, operation, maxRetries) {
   let lastError = new Error("retryOnTimeout exhausted");
@@ -2859,9 +3167,6 @@ async function runCli(argv, deps2) {
   }
   const nonInteractive = options.nonInteractive || process.env["KBDB_NON_INTERACTIVE"] === "1" || process.env["KBDB_NON_INTERACTIVE"] === "true";
   const effectiveDeps = nonInteractive ? { ...deps2, isStdinTty: () => false } : deps2;
-  if (!options.formatExplicit) {
-    options.format = effectiveDeps.isStdoutTty() ? "text" : "json";
-  }
   if (options.command === "help" || !options.command) {
     const helpCommand = options.args[0];
     const helpSubcommand = options.args[1];
@@ -2877,6 +3182,9 @@ async function runCli(argv, deps2) {
   if (options.command === "init" || options.command === "db-init") {
     return handleInit(options, effectiveDeps);
   }
+  if (options.command === "db-path") {
+    return runDbPath(options, effectiveDeps.findDb);
+  }
   if (options.command === "mcp") {
     return handleMcp(options, effectiveDeps);
   }
@@ -2919,14 +3227,20 @@ function resolveRetryCount(options) {
   return options.retry ?? (parseInt(process.env["KBDB_RETRY"] ?? "", 10) || DEFAULT_RETRY_COUNT);
 }
 async function handleMcp(options, deps2) {
-  const explicitPath = resolveRawDbPath(options);
-  const dbDir = deps2.findDb(explicitPath);
-  if (!dbDir) {
+  const resolution = resolveDbDir(
+    { dbPath: options.dbPath, skipTraversal: true },
+    deps2.findDb
+  );
+  if (!resolution) {
     return {
-      error: "error: no .kbdb database found at " + (explicitPath ?? process.cwd()),
+      error: formatDbNotFound({
+        dbPath: options.dbPath,
+        skipTraversal: true
+      }),
       exitCode: 1
     };
   }
+  const dbDir = resolution.path;
   const timeoutMs = resolveTimeoutMs(options);
   const maxRetries = resolveRetryCount(options);
   let client;
@@ -2965,14 +3279,17 @@ async function handleMcp(options, deps2) {
   }
 }
 async function handleMigrate(options, deps2) {
-  const dbDir = deps2.findDb(options.dbPath);
-  if (!dbDir) {
-    const basePath = options.dbPath ?? process.cwd();
+  const resolution = resolveDbDir(
+    { dbPath: options.dbPath },
+    deps2.findDb
+  );
+  if (!resolution) {
     return {
-      error: `error: no .kbdb database found at ${basePath}`,
+      error: formatDbNotFound({ dbPath: options.dbPath }),
       exitCode: 1
     };
   }
+  const dbDir = resolution.path;
   let client;
   try {
     client = await deps2.createWorkerClient({
@@ -3010,13 +3327,18 @@ async function handleMigrate(options, deps2) {
   }
 }
 async function handleDataCommand(options, deps2) {
-  const explicitPath = resolveRawDbPath(options);
-  let dbDir = deps2.findDb(explicitPath);
+  const resolution = resolveDbDir(
+    { dbPath: options.dbPath },
+    deps2.findDb
+  );
+  let dbDir = resolution?.path ?? null;
   if (!dbDir) {
-    const basePath = explicitPath ?? process.cwd();
+    const basePath = options.dbPath ?? process.cwd();
     if (!deps2.isStdinTty()) {
       return {
-        error: `error: no .kbdb database found at ${basePath} -- run \`kbdb --init\` to create one`,
+        error: formatDbNotFound({
+          dbPath: options.dbPath
+        }),
         exitCode: 1
       };
     }
@@ -3064,14 +3386,17 @@ async function handleDataCommand(options, deps2) {
   }
 }
 async function handleWorkerLifecycle(options, deps2, action) {
-  const explicitPath = resolveRawDbPath(options);
-  const dbDir = deps2.findDb(explicitPath);
-  if (!dbDir) {
+  const resolution = resolveDbDir(
+    { dbPath: options.dbPath },
+    deps2.findDb
+  );
+  if (!resolution) {
     return {
-      error: "error: no .kbdb database found at " + (explicitPath ?? process.cwd()),
+      error: formatDbNotFound({ dbPath: options.dbPath }),
       exitCode: 1
     };
   }
+  const dbDir = resolution.path;
   return action(dbDir);
 }
 async function versionGate(client, dbDir) {
@@ -4651,7 +4976,7 @@ var McpServer = class {
     });
     log("MCP server listening on stdin", 0 /* DEBUG */);
     let pending = Promise.resolve();
-    await new Promise((resolve4) => {
+    await new Promise((resolve7) => {
       rl.on("line", (line) => {
         pending = pending.then(() => this.dispatchLine(line));
       });
@@ -4661,7 +4986,7 @@ var McpServer = class {
           this.autoCaptureController = null;
           this.client.disconnect();
           log("MCP stdin closed", 0 /* DEBUG */);
-          resolve4();
+          resolve7();
         });
       });
     });
@@ -4705,13 +5030,13 @@ var McpServer = class {
     const id = this.nextRequestId++;
     const request = { jsonrpc: "2.0", id, method, params };
     process.stdout.write(JSON.stringify(request) + "\n");
-    return new Promise((resolve4, reject) => {
+    return new Promise((resolve7, reject) => {
       const timer = setTimeout(() => {
         this.pendingRequests.delete(id);
         reject(new Error(`Request ${method} timed out`));
       }, 3e4);
       this.pendingRequests.set(id, {
-        resolve: resolve4,
+        resolve: resolve7,
         reject,
         timer
       });
@@ -5143,28 +5468,21 @@ function parseWorkerToml(text, contextPath) {
 }
 
 // src/cli.ts
-var import_meta = {};
-var runtime = detectRuntime();
-var baseDir = resolveBaseDir(import_meta.url, import_meta.dirname);
-var workerScript = resolveWorkerScript(baseDir.scriptDir, runtime);
 var deps = {
   isStdinTty,
   isStdoutTty: () => process.stdout.isTTY,
   promptUser,
-  createWorkerClient: (opts) => createWorkerClient({ ...opts, workerScript }),
+  createWorkerClient: (opts) => createWorkerClient(opts),
   findDb,
   runInit,
   startMcpServer: async (contextPath, clientFactory, maxRetries) => {
     log("starting MCP server", 1 /* INFO */);
-    const client = await createWorkerClient({
-      contextPath,
-      workerScript
-    });
+    const client = await createWorkerClient({ contextPath });
     try {
-      const tomlPath = (0, import_node_path12.join)(contextPath, "worker.toml");
+      const tomlPath = (0, import_node_path14.join)(contextPath, "worker.toml");
       let autoCaptureConfig;
       try {
-        const tomlText = (0, import_node_fs9.readFileSync)(tomlPath, "utf-8");
+        const tomlText = (0, import_node_fs10.readFileSync)(tomlPath, "utf-8");
         const daemonConfig = parseWorkerToml(tomlText, contextPath);
         autoCaptureConfig = daemonConfig.autoCapture;
       } catch {