@dikolab/kbdb 0.3.1 → 0.4.0

package/README.md

@@ -1,20 +1,28 @@
 # @dikolab/kbdb
 
-A file-based knowledge base database -- no server
-required.
+[![npm](https://img.shields.io/npm/v/@dikolab/kbdb)](https://www.npmjs.com/package/@dikolab/kbdb)
+[![JSR](https://jsr.io/badges/@dikolab/kbdb)](https://jsr.io/@dikolab/kbdb)
+[![License: ISC](https://img.shields.io/badge/license-ISC-blue.svg)](LICENSE)
+
+A file-based knowledge base database -- no external
+server to install.
 
 [GitLab](https://gitlab.com/tech-slaves/knowledge-base-db)
 | [NPM](https://www.npmjs.com/package/@dikolab/kbdb)
 | [JSR](https://jsr.io/@dikolab/kbdb)
-| [License: ISC](https://gitlab.com/tech-slaves/knowledge-base-db/-/blob/main/LICENSE)
+| [License: ISC](LICENSE)
+
+> **Status:** Beta -- actively developed. Core
+> features (search, recall, MCP) are stable and
+> tested.
 
 ---
 
 ## What is kbdb?
 
 **kbdb** stores your docs in a plain folder on
-disk and makes them searchable. No server to
-install. No cloud account. Import your Markdown
+disk and makes them searchable. No external server
+to install. No cloud account. Import your Markdown
 files, and kbdb indexes them automatically.
 Search returns ranked results instantly.
 
@@ -23,13 +31,19 @@ works as an [MCP](https://modelcontextprotocol.io/)
 server -- giving AI agents like Claude a searchable
 second brain that persists between sessions.
 
-**How search works:** kbdb uses keyword matching
-with stemming and synonym expansion (lexical
-search, not AI embeddings). This keeps it fast,
-offline, and deterministic. When an exact query
-returns nothing, it automatically retries with
-relaxed matching. Headings carry 2x ranking weight,
-so clear headings improve results.
+**How search works:** kbdb uses **keyword search** by
+default -- synonyms are expanded, terms are ranked
+by relevance, and headings carry 2× weight in
+scoring. When an exact query finds nothing, kbdb
+automatically loosens the match so you still get the
+best available results.
+
+Want smarter results? Use `--algo hybrid` to blend
+keyword matching with AI-powered similarity --
+finding results even when different words describe
+the same concept. Hybrid mode needs an embedding
+provider; without one, use the default keyword-only
+search for fast, offline matching.
 
 **Knowledge stays fresh:** Re-learn a file and kbdb
 replaces the old version automatically.
@@ -87,7 +101,7 @@ kbdb learn ./docs --db ./my-kb
 Point it at a folder of Markdown files. kbdb reads
 them, breaks them into sections, and builds a
 search index. Add `--tags design,v2` to tag
-sections for scoping, or `--replace` to supersede
+sections for scoping, or `--replace` to update
 existing sections from the same source.
 
 **3. Search**
@@ -96,11 +110,21 @@ existing sections from the same source.
 kbdb search "how does auth work" --db ./my-kb
 ```
 
-Results are ranked by relevance with confidence
-scores and snippets showing matched terms in
-context. Each result includes `matched_fields`
-(heading, body, code) and `created_at` timestamps.
-Use `--offset` to page through large result sets.
+Results are ranked by relevance with snippets
+showing where your terms matched. Use `--offset`
+to page through large result sets.
+
+To try hybrid search (keyword + AI similarity):
+
+```sh
+kbdb search "how does auth work" --algo hybrid \
+   --db ./my-kb
+```
+
+> **Tip:** `--db` is optional. If you're already
+> inside a directory with a `.kbdb` folder, just
+> omit it. You can also set `KBDB_DB_DIR` as an
+> environment variable.
 
 **4. Recall context**
 
@@ -117,112 +141,53 @@ referenced sections.
 
 ---
 
-## What Can It Do?
+## Knowledge Base
+
+Build, search, and maintain your knowledge store.
 
-- **Import** Markdown files and other documents,
-  with tags and source tracking
-- **Supersede** outdated sections automatically
-  when re-learning from the same source
-- **Search** with ranked results, confidence
-  scores, snippets, and paginated output
-- **Relaxed fallback** -- automatic OR retry when
-  exact AND queries return nothing
+- **Import** Markdown and plain text files with
+  tags and source tracking
+- **Smart updates** -- re-learning a file replaces
+  the old version instead of duplicating it
+- **Search** with three algorithms: keyword
+  (default), AI similarity, or hybrid (both)
+- **Auto-fallback** -- if your exact query finds
+  nothing, kbdb loosens the match automatically
 - **Recall** sections with progressive context --
   from a quick summary to full related content
-- **Export** the database as a portable snapshot
-- **Skills** -- store reusable prompt templates
-  with placeholder arguments
-- **Agents** -- create AI agent profiles that
-  combine a persona with skills
-- **Manage** documents, sections, and metadata
-- **Verify** database integrity, detect
-  contradictions, and clean up superseded data
+- **Export** -- snapshot your knowledge base for
+  backup
+- **Verify** database integrity and clean up
+  stale data
 - **Rebuild** indexes if anything goes wrong
 
-See the [CLI Reference](https://gitlab.com/tech-slaves/knowledge-base-db/-/blob/main/docs/details/cli.md)
-for the full command list and examples.
+See the
+[Knowledge Base Guide](docs/details/knowledge-base.md)
+for the full walkthrough, including export and backup.
 
 ---
 
-## Use It With AI Agents
-
-kbdb runs as an
-[MCP](https://modelcontextprotocol.io/) server
-with 20 tools, so AI agents can search your docs,
-recall context progressively, export snapshots,
-store reusable skills, and build agent profiles --
-a second brain that persists between sessions.
-
-### Claude Code (CLI)
-
-Create `.mcp.json` in your project root:
-
-```json
-{
-   "mcpServers": {
-      "kbdb": {
-         "command": "npx",
-         "args": [
-            "-y",
-            "@dikolab/kbdb",
-            "mcp",
-            "--db",
-            "/path/to/.kbdb"
-         ]
-      }
-   }
-}
-```
+## Agent Tooling
 
-### Claude for VS Code
-
-Create `.vscode/mcp.json` in your project:
-
-```json
-{
-   "servers": {
-      "kbdb": {
-         "command": "npx",
-         "args": [
-            "-y",
-            "@dikolab/kbdb",
-            "mcp",
-            "--db",
-            "${workspaceFolder}/.kbdb"
-         ]
-      }
-   }
-}
-```
-
-### Claude Desktop
-
-Add to your `claude_desktop_config.json`:
-
-```json
-{
-   "mcpServers": {
-      "kbdb": {
-         "command": "npx",
-         "args": [
-            "-y",
-            "@dikolab/kbdb",
-            "mcp",
-            "--db",
-            "/path/to/.kbdb"
-         ]
-      }
-   }
-}
-```
+Integrate kbdb with AI agents and custom tools.
 
-### Other AI Agents
+- **MCP server** with 20 tools -- search, recall,
+  learn, export, and more
+- **Skills** -- store reusable prompt templates
+  with fill-in-the-blank arguments
+- **Agents** -- create AI agent profiles that
+  combine a persona with skills
+- **Auto-capture** -- the MCP server can
+  proactively suggest knowledge to store from
+  your conversations
+- **Daemon resilience** -- configurable request
+  timeout and automatic retry with daemon respawn
+- **Worker daemon** lifecycle management --
+  stop and restart the background process
 
-Any MCP-compatible agent can connect. See the
-[MCP Server Guide](https://gitlab.com/tech-slaves/knowledge-base-db/-/blob/main/docs/details/mcp-server.md) for
-setup instructions, Deno variants, environment
-variable configuration, and the full list of
-available tools.
+See the
+[Agent Tooling Guide](docs/details/agent-tooling.md)
+for MCP setup, skills, agents, and the library API.
 
 ---
 
@@ -236,8 +201,10 @@ project:
 ```typescript
 import { createWorkerClient } from '@dikolab/kbdb';
 
+// Spawns a background worker if not already running
 const client = await createWorkerClient({
    contextPath: '/path/to/.kbdb',
+   requestTimeoutMs: 30_000,
 });
 
 const results = await client.search({
@@ -246,13 +213,16 @@ const results = await client.search({
    offset: 0,
 });
 
-// results = { items, total, offset, limit, has_more, relaxed }
 console.log(results.items);
 client.disconnect();
 ```
 
+Pass `contextPath` (the `.kbdb` directory itself)
+or `dbPath` (the parent directory -- kbdb discovers
+`.kbdb` inside it).
+
 See the
-[Library API Reference](https://gitlab.com/tech-slaves/knowledge-base-db/-/blob/main/docs/details/library-api.md)
+[Library API Reference](docs/details/library-api.md)
 for the full API.
 
 ### Development Setup
@@ -273,7 +243,12 @@ A Docker setup is included with all build tools
 HOST_UMASK=$(umask) docker compose run --rm dev bash
 ```
 
-See the [Makefile](https://gitlab.com/tech-slaves/knowledge-base-db/-/blob/main/Makefile) for all available
+Run `make benchmark` to measure search and rebuild
+latency at scale -- results are written to
+[docs/benchmark/benchmark.md](docs/benchmark/benchmark.md)
+automatically.
+
+See the [Makefile](Makefile) for all available
 build targets.
 
 ### Contributing
@@ -288,20 +263,27 @@ build targets.
 
 ## Documentation
 
-- [Detailed Guides](https://gitlab.com/tech-slaves/knowledge-base-db/-/tree/main/docs/details) -- CLI
-  reference, MCP setup, search internals, storage
-  format, library API
-- [Release Notes](https://gitlab.com/tech-slaves/knowledge-base-db/-/tree/main/docs/release-notes)
-- [Architecture Overview](https://gitlab.com/tech-slaves/knowledge-base-db/-/blob/main/docs/overview.md)
+- [Knowledge Base Guide](docs/details/knowledge-base.md)
+  -- importing, searching, recall, export
+- [Agent Tooling Guide](docs/details/agent-tooling.md)
+  -- MCP, skills, agents, library API
+- [CLI Reference](docs/details/cli.md) -- full command
+  list with examples
+- [MCP Server Guide](docs/details/mcp-server.md) --
+  setup, tools, environment config
+- [Search and Ranking](docs/details/search-and-ranking.md)
+  -- how search works under the hood
+- [Storage Architecture](docs/details/storage.md) --
+  file formats and directory layout
+- [Benchmark Results](docs/benchmark/benchmark.md)
+  -- search and rebuild latency at scale
+- [Release Notes](docs/release-notes/)
+- [Architecture Overview](docs/overview.md)
 
 ---
 
 ## License
 
-ISC License -- see [LICENSE](https://gitlab.com/tech-slaves/knowledge-base-db/-/blob/main/LICENSE) for details.
+ISC License -- see [LICENSE](LICENSE) for details.
 
 ---
-
-[GitLab](https://gitlab.com/tech-slaves/knowledge-base-db)
-| [NPM](https://www.npmjs.com/package/@dikolab/kbdb)
-| [JSR](https://jsr.io/@dikolab/kbdb)

package/dist/chunk-BJPSPNGX.mjs

@@ -0,0 +1,223 @@
+// src/shared/runtime/functions/detect-runtime.ts
+function detectRuntime() {
+  if (typeof globalThis !== "undefined" && "Deno" in globalThis) {
+    return "deno";
+  }
+  return "node";
+}
+
+// src/shared/runtime/functions/get-args.ts
+function getArgs() {
+  if (detectRuntime() === "deno") {
+    const g = globalThis;
+    const deno = g["Deno"];
+    return deno?.args ?? [];
+  }
+  return process.argv.slice(2);
+}
+
+// src/shared/dir-resolver/functions/resolve-base-dir.function.ts
+import { dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+function resolveScriptDir(entryUrl, entryDirname) {
+  if (entryDirname) return entryDirname;
+  if (entryUrl.startsWith("file:"))
+    return dirname(fileURLToPath(entryUrl));
+  return 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
+import { join } from "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 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/dir-resolver/functions/resolve-wasm-dir.function.ts
+function resolveWasmDir(scriptDir) {
+  return joinPath(scriptDir, "wasm");
+}
+
+// src/shared/worker-daemon/constants/daemon-defaults.constant.ts
+var DEFAULT_ITEM_LIMIT = 1e3;
+var DEFAULT_INDEX_LIMIT = 100;
+var DEFAULT_TIMEOUT_MS = 3e5;
+var DEFAULT_ITEM_TTL_MS = 6e4;
+var WORKER_TOML_FILENAME = "worker.toml";
+var DB_FORMAT_VERSION = 1;
+
+// src/shared/worker-daemon/functions/parse-embedding-section.function.ts
+function parseEmbeddingSection(entries) {
+  const provider = entries.get("provider");
+  if (!provider) {
+    return void 0;
+  }
+  const model = entries.get("model");
+  const endpoint = entries.get("endpoint");
+  const dimensionsRaw = entries.get("dimensions");
+  const dimensions = dimensionsRaw ? parseInt(dimensionsRaw, 10) || void 0 : void 0;
+  return {
+    provider,
+    ...model !== void 0 ? { model } : {},
+    ...endpoint !== void 0 ? { endpoint } : {},
+    ...dimensions !== void 0 ? { dimensions } : {}
+  };
+}
+
+// src/shared/auto-capture/constants/auto-capture-defaults.constant.ts
+var AUTO_CAPTURE_DEFAULTS = {
+  enabled: false,
+  triggerAfterToolCalls: 5,
+  minIntervalMs: 6e4,
+  maxCapturesPerSession: 10,
+  dryRun: false
+};
+
+// src/shared/worker-daemon/functions/parse-auto-capture-section.function.ts
+function parseAutoCaptureSection(entries) {
+  const enabled = entries.has("enabled") ? entries.get("enabled") === "true" : AUTO_CAPTURE_DEFAULTS.enabled;
+  const dryRun = entries.has("dry_run") ? entries.get("dry_run") === "true" : AUTO_CAPTURE_DEFAULTS.dryRun;
+  const triggerRaw = entries.get("trigger_after_tool_calls");
+  const triggerAfterToolCalls = triggerRaw ? parseInt(triggerRaw, 10) || AUTO_CAPTURE_DEFAULTS.triggerAfterToolCalls : AUTO_CAPTURE_DEFAULTS.triggerAfterToolCalls;
+  const intervalRaw = entries.get("min_interval_ms");
+  const minIntervalMs = intervalRaw ? parseInt(intervalRaw, 10) || AUTO_CAPTURE_DEFAULTS.minIntervalMs : AUTO_CAPTURE_DEFAULTS.minIntervalMs;
+  const capRaw = entries.get("max_captures_per_session");
+  const maxCapturesPerSession = capRaw ? parseInt(capRaw, 10) || AUTO_CAPTURE_DEFAULTS.maxCapturesPerSession : AUTO_CAPTURE_DEFAULTS.maxCapturesPerSession;
+  return {
+    enabled,
+    triggerAfterToolCalls,
+    minIntervalMs,
+    maxCapturesPerSession,
+    dryRun
+  };
+}
+
+// src/shared/worker-daemon/functions/parse-worker-toml.function.ts
+function applyRootKey(acc, key, value) {
+  switch (key) {
+    case "item_limit":
+      acc.itemLimit = parseInt(value, 10) || DEFAULT_ITEM_LIMIT;
+      break;
+    case "index_limit":
+      acc.indexLimit = parseInt(value, 10) || DEFAULT_INDEX_LIMIT;
+      break;
+    case "timeout_ms":
+      acc.timeoutMs = parseInt(value, 10) || DEFAULT_TIMEOUT_MS;
+      break;
+    case "item_ttl_ms":
+      acc.itemTtlMs = parseInt(value, 10) || DEFAULT_ITEM_TTL_MS;
+      break;
+    default:
+      break;
+  }
+}
+function parseWorkerToml(text, contextPath) {
+  let section = "";
+  const embeddingEntries = /* @__PURE__ */ new Map();
+  const autoCaptureEntries = /* @__PURE__ */ new Map();
+  const acc = {
+    itemLimit: DEFAULT_ITEM_LIMIT,
+    indexLimit: DEFAULT_INDEX_LIMIT,
+    timeoutMs: DEFAULT_TIMEOUT_MS,
+    itemTtlMs: DEFAULT_ITEM_TTL_MS
+  };
+  for (const line of text.split("\n")) {
+    const trimmed = line.trim();
+    if (trimmed === "[embedding]") {
+      section = "embedding";
+      continue;
+    }
+    if (trimmed === "[auto_capture]") {
+      section = "auto_capture";
+      continue;
+    }
+    if (trimmed.startsWith("[")) {
+      section = "";
+      continue;
+    }
+    if (trimmed.startsWith("#") || !trimmed.includes("=")) continue;
+    const eqIdx = trimmed.indexOf("=");
+    const key = trimmed.slice(0, eqIdx).trim();
+    const value = trimmed.slice(eqIdx + 1).trim();
+    if (section === "embedding") {
+      embeddingEntries.set(key, value);
+      continue;
+    }
+    if (section === "auto_capture") {
+      autoCaptureEntries.set(key, value);
+      continue;
+    }
+    applyRootKey(acc, key, value);
+  }
+  const embedding = parseEmbeddingSection(embeddingEntries);
+  const autoCapture = autoCaptureEntries.size > 0 ? parseAutoCaptureSection(autoCaptureEntries) : void 0;
+  return {
+    contextPath,
+    ...acc,
+    ...embedding !== void 0 ? { embedding } : {},
+    ...autoCapture !== void 0 ? { autoCapture } : {}
+  };
+}
+
+// src/shared/hash/functions/compute-sha256.ts
+async function computeSha256(input) {
+  const data = new TextEncoder().encode(input);
+  const hash = await crypto.subtle.digest("SHA-256", data);
+  const bytes = new Uint8Array(hash);
+  return Array.from(bytes).map((b) => b.toString(16).padStart(2, "0")).join("");
+}
+
+// src/shared/platform/functions/get-ipc-path.function.ts
+import { join as join2 } from "node:path";
+
+// src/shared/platform/functions/get-tmpdir.function.ts
+import { tmpdir } from "node:os";
+function getTmpdir() {
+  return tmpdir();
+}
+
+// src/shared/platform/functions/get-ipc-path.function.ts
+function getIpcPath(ctx) {
+  if (process.platform === "win32") {
+    return `\\\\.\\pipe\\kbdb-${ctx}`;
+  }
+  return join2(getTmpdir(), `kbdb-${ctx}.sock`);
+}
+
+export {
+  detectRuntime,
+  getArgs,
+  resolveBaseDir,
+  isRemoteUrl,
+  joinPath,
+  resolveWorkerScript,
+  resolveWasmDir,
+  computeSha256,
+  getIpcPath,
+  DEFAULT_ITEM_LIMIT,
+  DEFAULT_INDEX_LIMIT,
+  DEFAULT_TIMEOUT_MS,
+  DEFAULT_ITEM_TTL_MS,
+  WORKER_TOML_FILENAME,
+  DB_FORMAT_VERSION,
+  parseWorkerToml
+};
+//# sourceMappingURL=chunk-BJPSPNGX.mjs.map

package/dist/chunk-BJPSPNGX.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/shared/runtime/functions/detect-runtime.ts", "../src/shared/runtime/functions/get-args.ts", "../src/shared/dir-resolver/functions/resolve-base-dir.function.ts", "../src/shared/dir-resolver/functions/join-path.function.ts", "../src/shared/dir-resolver/functions/resolve-worker-script.function.ts", "../src/shared/dir-resolver/functions/resolve-wasm-dir.function.ts", "../src/shared/worker-daemon/constants/daemon-defaults.constant.ts", "../src/shared/worker-daemon/functions/parse-embedding-section.function.ts", "../src/shared/auto-capture/constants/auto-capture-defaults.constant.ts", "../src/shared/worker-daemon/functions/parse-auto-capture-section.function.ts", "../src/shared/worker-daemon/functions/parse-worker-toml.function.ts", "../src/shared/hash/functions/compute-sha256.ts", "../src/shared/platform/functions/get-ipc-path.function.ts", "../src/shared/platform/functions/get-tmpdir.function.ts"],
+  "sourcesContent": ["import type { Runtime } from '../typings/runtime.ts';\n\n/**\n * Detects the current JavaScript runtime environment.\n *\n * Returns `'deno'` when the global `Deno` object is present,\n * otherwise returns `'node'`.\n */\nexport function detectRuntime(): Runtime {\n   if (typeof globalThis !== 'undefined' && 'Deno' in globalThis) {\n      return 'deno';\n   }\n   return 'node';\n}\n", "import { detectRuntime } from './detect-runtime.ts';\n\n/**\n * Returns the command-line arguments for the current runtime.\n *\n * In Deno, reads `Deno.args`; in Node.js, slices `process.argv`\n * past the interpreter and script entries.\n */\nexport function getArgs(): string[] {\n   if (detectRuntime() === 'deno') {\n      const g = globalThis as Record<string, unknown>;\n      const deno = g['Deno'] as { args: string[] } | undefined;\n      return deno?.args ?? [];\n   }\n   return process.argv.slice(2);\n}\n", "import { dirname } from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nimport type { BaseDir } from '../typings/base-dir.interface.ts';\n\nexport function resolveScriptDir(\n   entryUrl: string,\n   entryDirname?: string,\n): string {\n   if (entryDirname) return entryDirname;\n   if (entryUrl.startsWith('file:'))\n      return dirname(fileURLToPath(entryUrl));\n   return dirname(entryUrl);\n}\n\nexport function resolveBaseDir(\n   entryUrl: string,\n   entryDirname?: string,\n): BaseDir {\n   const scriptDir =\n      typeof __dirname !== 'undefined'\n         ? __dirname\n         : resolveScriptDir(entryUrl, entryDirname);\n   return { scriptDir, cwd: process.cwd() };\n}\n", "import { join } from 'node:path';\n\nexport function isRemoteUrl(path: string): boolean {\n   return path.startsWith('http://') || path.startsWith('https://');\n}\n\nexport function joinPath(base: string, ...segments: string[]): string {\n   if (isRemoteUrl(base)) {\n      const trailing = base.endsWith('/') ? '' : '/';\n      return base + trailing + segments.join('/');\n   }\n   return join(base, ...segments);\n}\n", "import { joinPath } from './join-path.function.ts';\n\nimport type { Runtime } from '../../runtime/typings/runtime.ts';\n\nexport function resolveWorkerScript(\n   scriptDir: string,\n   runtime: Runtime,\n): string {\n   if (runtime === 'deno') {\n      return joinPath(scriptDir, 'worker.ts');\n   }\n   return joinPath(scriptDir, 'kbdb-worker.cjs');\n}\n", "import { joinPath } from './join-path.function.ts';\n\nexport function resolveWasmDir(scriptDir: string): string {\n   return joinPath(scriptDir, 'wasm');\n}\n", "/** Default maximum number of items held in daemon memory. */\nexport const DEFAULT_ITEM_LIMIT = 1000;\n\n/** Default maximum number of index entries held in daemon memory. */\nexport const DEFAULT_INDEX_LIMIT = 100;\n\n/**\n * Default idle timeout in milliseconds before the daemon shuts\n * down automatically (5 minutes).\n */\nexport const DEFAULT_TIMEOUT_MS = 300_000;\n\n/**\n * Default time-to-live in milliseconds for each cached item\n * (1 minute).\n */\nexport const DEFAULT_ITEM_TTL_MS = 60_000;\n\n/** Filename of the daemon configuration file inside `.kbdb/`. */\nexport const WORKER_TOML_FILENAME = 'worker.toml';\n\n/**\n * Database format version the daemon supports.\n *\n * Read from `catalog.toml` at startup. If the catalog version\n * differs, the daemon prints a structured error to stderr and\n * exits with code 1 before loading any WASM modules.\n */\nexport const DB_FORMAT_VERSION = 1;\n", "import type { EmbeddingConfig } from '../../embedding/typings/embedding-config.interface.ts';\n\n/**\n * Parses key-value pairs from a `[embedding]` TOML section into an\n * `EmbeddingConfig`.\n *\n * Recognises: `provider`, `model`, `endpoint`, `dimensions`.\n * Unknown keys are silently ignored. Returns `undefined` when the\n * `provider` key is absent from the supplied entries.\n *\n * @param entries - key-value pairs from inside the `[embedding]`\n *   section\n */\nexport function parseEmbeddingSection(\n   entries: ReadonlyMap<string, string>,\n): EmbeddingConfig | undefined {\n   const provider = entries.get('provider') as\n      | EmbeddingConfig['provider']\n      | undefined;\n\n   if (!provider) {\n      return undefined;\n   }\n\n   const model = entries.get('model');\n   const endpoint = entries.get('endpoint');\n   const dimensionsRaw = entries.get('dimensions');\n   const dimensions = dimensionsRaw\n      ? parseInt(dimensionsRaw, 10) || undefined\n      : undefined;\n\n   return {\n      provider,\n      ...(model !== undefined ? { model } : {}),\n      ...(endpoint !== undefined ? { endpoint } : {}),\n      ...(dimensions !== undefined ? { dimensions } : {}),\n   };\n}\n", "import type { AutoCaptureConfig } from '../typings/auto-capture-config.interface.ts';\n\n/**\n * Default configuration for the auto-capture feature.\n *\n * Auto-capture is disabled by default. Enable it in\n * `worker.toml` under `[auto_capture]`.\n */\nexport const AUTO_CAPTURE_DEFAULTS: AutoCaptureConfig = {\n   enabled: false,\n   triggerAfterToolCalls: 5,\n   minIntervalMs: 60_000,\n   maxCapturesPerSession: 10,\n   dryRun: false,\n};\n", "import type { AutoCaptureConfig } from '../../auto-capture/typings/auto-capture-config.interface.ts';\nimport { AUTO_CAPTURE_DEFAULTS } from '../../auto-capture/constants/auto-capture-defaults.constant.ts';\n\n/**\n * Parses key-value pairs from an `[auto_capture]` TOML section\n * into an `AutoCaptureConfig`.\n *\n * Recognised keys: `enabled`, `trigger_after_tool_calls`,\n * `min_interval_ms`, `max_captures_per_session`, `dry_run`.\n * Unknown keys are silently ignored. Falls back to\n * `AUTO_CAPTURE_DEFAULTS` for any absent key.\n *\n * @param entries - key-value pairs from inside the\n *   `[auto_capture]` section\n */\nexport function parseAutoCaptureSection(\n   entries: ReadonlyMap<string, string>,\n): AutoCaptureConfig {\n   const enabled = entries.has('enabled')\n      ? entries.get('enabled') === 'true'\n      : AUTO_CAPTURE_DEFAULTS.enabled;\n\n   const dryRun = entries.has('dry_run')\n      ? entries.get('dry_run') === 'true'\n      : AUTO_CAPTURE_DEFAULTS.dryRun;\n\n   const triggerRaw = entries.get('trigger_after_tool_calls');\n   const triggerAfterToolCalls = triggerRaw\n      ? parseInt(triggerRaw, 10) ||\n        AUTO_CAPTURE_DEFAULTS.triggerAfterToolCalls\n      : AUTO_CAPTURE_DEFAULTS.triggerAfterToolCalls;\n\n   const intervalRaw = entries.get('min_interval_ms');\n   const minIntervalMs = intervalRaw\n      ? parseInt(intervalRaw, 10) || AUTO_CAPTURE_DEFAULTS.minIntervalMs\n      : AUTO_CAPTURE_DEFAULTS.minIntervalMs;\n\n   const capRaw = entries.get('max_captures_per_session');\n   const maxCapturesPerSession = capRaw\n      ? parseInt(capRaw, 10) ||\n        AUTO_CAPTURE_DEFAULTS.maxCapturesPerSession\n      : AUTO_CAPTURE_DEFAULTS.maxCapturesPerSession;\n\n   return {\n      enabled,\n      triggerAfterToolCalls,\n      minIntervalMs,\n      maxCapturesPerSession,\n      dryRun,\n   };\n}\n", "import type { DaemonConfig } from '../typings/daemon-config.interface.ts';\nimport {\n   DEFAULT_ITEM_LIMIT,\n   DEFAULT_INDEX_LIMIT,\n   DEFAULT_TIMEOUT_MS,\n   DEFAULT_ITEM_TTL_MS,\n} from '../constants/daemon-defaults.constant.ts';\nimport { parseEmbeddingSection } from './parse-embedding-section.function.ts';\nimport { parseAutoCaptureSection } from './parse-auto-capture-section.function.ts';\n\ninterface RootAccum {\n   itemLimit: number;\n   indexLimit: number;\n   timeoutMs: number;\n   itemTtlMs: number;\n}\n\nfunction applyRootKey(\n   acc: RootAccum,\n   key: string,\n   value: string,\n): void {\n   switch (key) {\n      case 'item_limit':\n         acc.itemLimit = parseInt(value, 10) || DEFAULT_ITEM_LIMIT;\n         break;\n      case 'index_limit':\n         acc.indexLimit = parseInt(value, 10) || DEFAULT_INDEX_LIMIT;\n         break;\n      case 'timeout_ms':\n         acc.timeoutMs = parseInt(value, 10) || DEFAULT_TIMEOUT_MS;\n         break;\n      case 'item_ttl_ms':\n         acc.itemTtlMs = parseInt(value, 10) || DEFAULT_ITEM_TTL_MS;\n         break;\n      default:\n         break;\n   }\n}\n\n/**\n * Parses a `worker.toml` file body into a partial `DaemonConfig`.\n *\n * Handles `[embedding]` sub-sections and root key-value pairs.\n * Unknown keys are silently ignored.\n *\n * @param text - raw content of `worker.toml`\n * @param contextPath - daemon context directory path\n */\nexport function parseWorkerToml(\n   text: string,\n   contextPath: string,\n): DaemonConfig {\n   let section = '';\n   const embeddingEntries = new Map<string, string>();\n   const autoCaptureEntries = new Map<string, string>();\n   const acc: RootAccum = {\n      itemLimit: DEFAULT_ITEM_LIMIT,\n      indexLimit: DEFAULT_INDEX_LIMIT,\n      timeoutMs: DEFAULT_TIMEOUT_MS,\n      itemTtlMs: DEFAULT_ITEM_TTL_MS,\n   };\n\n   for (const line of text.split('\\n')) {\n      const trimmed = line.trim();\n      if (trimmed === '[embedding]') {\n         section = 'embedding';\n         continue;\n      }\n      if (trimmed === '[auto_capture]') {\n         section = 'auto_capture';\n         continue;\n      }\n      if (trimmed.startsWith('[')) {\n         section = '';\n         continue;\n      }\n      if (trimmed.startsWith('#') || !trimmed.includes('=')) continue;\n      const eqIdx = trimmed.indexOf('=');\n      const key = trimmed.slice(0, eqIdx).trim();\n      const value = trimmed.slice(eqIdx + 1).trim();\n      if (section === 'embedding') {\n         embeddingEntries.set(key, value);\n         continue;\n      }\n      if (section === 'auto_capture') {\n         autoCaptureEntries.set(key, value);\n         continue;\n      }\n      applyRootKey(acc, key, value);\n   }\n\n   const embedding = parseEmbeddingSection(embeddingEntries);\n   const autoCapture =\n      autoCaptureEntries.size > 0\n         ? parseAutoCaptureSection(autoCaptureEntries)\n         : undefined;\n   return {\n      contextPath,\n      ...acc,\n      ...(embedding !== undefined ? { embedding } : {}),\n      ...(autoCapture !== undefined ? { autoCapture } : {}),\n   };\n}\n", "/**\n * Computes the SHA-256 hash of a UTF-8 string.\n *\n * Uses the Web Crypto API (`crypto.subtle`), which is available\n * in both Deno and Node.js >= 20 without additional imports.\n *\n * @param input - the string to hash\n * @returns lowercase hex-encoded SHA-256 digest (64 characters)\n */\nexport async function computeSha256(input: string): Promise<string> {\n   const data = new TextEncoder().encode(input);\n   const hash = await crypto.subtle.digest('SHA-256', data);\n   const bytes = new Uint8Array(hash);\n   return Array.from(bytes)\n      .map((b) => b.toString(16).padStart(2, '0'))\n      .join('');\n}\n", "import { join } from 'node:path';\nimport { getTmpdir } from './get-tmpdir.function.ts';\n\n/**\n * Returns the platform-appropriate IPC socket path for a given\n * context identifier.\n *\n * On Windows, returns a named pipe path (`\\\\.\\pipe\\kbdb-<ctx>`).\n * On POSIX systems, returns a Unix domain socket path under the\n * system temp directory (`<tmpdir>/kbdb-<ctx>.sock`).\n *\n * @param ctx - unique context identifier embedded in the path\n */\nexport function getIpcPath(ctx: string): string {\n   if (process.platform === 'win32') {\n      return `\\\\\\\\.\\\\pipe\\\\kbdb-${ctx}`;\n   }\n   return join(getTmpdir(), `kbdb-${ctx}.sock`);\n}\n", "import { tmpdir } from 'node:os';\n\n/**\n * Returns the operating system's default temporary directory path.\n */\nexport function getTmpdir(): string {\n   return tmpdir();\n}\n"],
+  "mappings": "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",
+  "names": ["join", "join"]
+}