@dikolab/kbdb 0.3.1 → 0.4.0

package/docs/overview.md

@@ -27,6 +27,8 @@ to it as a tool.
   for Model Context Protocol servers
 - **Knowledge workers** -- a second brain your AI
   assistant can search across conversations
+- **Vibe coders** -- a searchable doc store for
+  your AI-assisted projects
 - **CLI-first developers** -- composable commands
   for managing knowledge from the terminal
 
@@ -34,15 +36,24 @@ to it as a tool.
 
 - **Import** Markdown files with automatic keyword
   extraction and indexing
-- **Search** with ranked results, snippets, and
-  paginated output
+- **Search** three ways: keyword (default),
+  hybrid, or AI similarity via `--algo`
+- **Auto-fallback** -- loosens your query when
+  exact matches return nothing
 - **Recall** sections with progressive context
   (depth 0--3)
+- **Smart updates** -- re-learning a file replaces
+  the old version, not duplicates it
+- **Near-duplicate detection** -- warns when
+  imported content closely matches existing data
 - **Skills** -- reusable prompt templates with
-  placeholder arguments
+  fill-in-the-blank arguments
 - **Agents** -- AI profiles combining a persona
   with skills
-- **Export** the database as a portable snapshot
+- **Auto-capture** -- MCP server proactively
+  suggests knowledge to store from conversations
+- **Export and sync** -- snapshot your knowledge
+  base for backup or sharing across machines
 - **Verify** database integrity and clean up stale
   data
 - **MCP server** with 20 tools, prompts, resources,
@@ -76,32 +87,31 @@ mode runs short-lived commands (`learn`, `search`,
 `recall`). MCP mode starts a long-lived server for
 AI agents over stdio.
 
-**Worker Client** -- TypeScript module that discovers
-or spawns the daemon and provides a typed async API.
+**Worker Client** -- Connects to the background
+daemon and gives your code a typed API.
 
 **Worker Daemon** -- Background process that loads
-WASM modules, caches data in memory, and serves
-JSON-RPC 2.0 requests over local IPC.
+the search engine, caches data in memory, and
+handles requests.
 
-**Rust/WASM Engine** -- Three WASM modules handle
-tokenization, indexing, ranking, and file I/O. Rust
-provides speed and memory safety; WASM runs on any
-runtime.
+**Search Engine** -- Compiled from Rust to
+WebAssembly for speed. Three modules handle
+tokenization, indexing, ranking, and file I/O.
 
-**File Database** -- Structured directory on disk.
+**File Database** -- Structured folder on disk.
 No server process. Portable, version-controllable,
 and human-readable.
 
 ### Technology Stack
 
-| Layer | Technology | Purpose |
-|-------|-----------|---------|
-| Runtime | Node.js, Deno | Runs CLI, MCP server, orchestration |
-| Language | TypeScript | CLI, MCP protocol, I/O |
-| Engine | Rust -> WebAssembly | Indexing, ranking, file operations |
+| Layer | Technology | What it does |
+|-------|-----------|--------------|
+| Runtime | Node.js, Deno | Runs the tools |
+| Language | TypeScript | CLI, MCP server, I/O |
+| Engine | Rust -> WebAssembly | Fast indexing and search |
 | Protocol | MCP | AI agent integration |
-| Distribution | NPM, JSR | Package delivery |
-| Storage | File database | Persistent, portable data |
+| Distribution | NPM, JSR | Install from either |
+| Storage | File database | Your data, in a folder |
 
 ## Design Principles
 
@@ -120,7 +130,9 @@ and human-readable.
 
 ## Design Documents
 
-Detailed specifications for each subsystem:
+Deeper docs for each part of the system. You don't
+need to read these to use kbdb -- they're here for
+contributors and anyone curious about internals.
 
 - **[Database](goals/database.md)** -- File storage
   engine, directory structure, section and document
@@ -128,6 +140,8 @@ Detailed specifications for each subsystem:
 - **[Query Parser](goals/query-parser.md)** --
   Tokenization, query parsing, keyword extraction,
   ranking
+- **[Hybrid Search](goals/hybrid-search.md)** --
+  Lexical + vector retrieval with score fusion
 - **[Document](goals/document.md)** -- Content format
   with markers and cross-references
 - **[Content Parser](goals/content-parser.md)** --
@@ -138,6 +152,10 @@ Detailed specifications for each subsystem:
   output formats
 - **[MCP](goals/mcp.md)** -- MCP server, tools,
   resources, agent wiring
+- **[Auto-Capture](goals/auto-capture.md)** --
+  Proactive knowledge capture via MCP sampling
+- **[Sync](goals/sync.md)** -- Cross-machine export
+  and import
 - **[Worker Daemon](goals/worker-daemon.md)** --
   Background daemon, WASM loading, caching, IPC
 - **[Worker Client](goals/worker-client.md)** --
@@ -155,16 +173,19 @@ with zero failures and zero skips.
 
 - 18 CLI commands across 6 groups
 - 20 MCP tools with prompts, resources, completions
+- Three search algorithms: lexical, vector, hybrid
 - Sequential MCP request processing
 - Worker daemon with fully implemented WASM host I/O
 - Paginated search with rich metadata
 - Progressive recall at depths 0--3
 - Bidirectional reference graph
 - Skills and agent document management
+- Auto-capture hooks via MCP sampling
+- Export/import sync primitives
 - esbuild bundling (ESM + CJS + .d.ts)
 - Docker build containers
 - npm and JSR packages with documentation
 
 ## Links
 
-- **Repository**: https://gitlab.com/tech-slaves-internal/knowledge-base-db
+- **Repository**: https://gitlab.com/tech-slaves/knowledge-base-db

package/docs/release-notes/0.3.1.md

@@ -55,6 +55,16 @@ tool (`auto-capture-review`).
   `list`, `approve`, or `reject`. This brings the
   MCP server to 20 tools.
 
+- **Hybrid search infrastructure** -- New `--algo`
+  flag (CLI) and `algo` parameter (MCP/IPC) with
+  values `lexical`, `vector`, `hybrid`. Embedding
+  module with pluggable provider interface, vector
+  index binary format (KBVX), cosine similarity,
+  and RRF score fusion. Defaults to `lexical`.
+  Concrete embedding providers are deferred -- a
+  `NullEmbeddingProvider` is used until one is
+  configured.
+
 ---
 
 ## Testing

package/docs/release-notes/0.3.2.md

@@ -0,0 +1,64 @@
+# 0.3.2
+
+*Patch release -- 2026-06-23*
+
+Documentation alignment, hybrid search highlight,
+and readability improvements for non-technical users.
+
+---
+
+## Documentation
+
+- **Internal doc links use relative paths** --
+  README.md links to CLI reference, MCP guide,
+  library API, Makefile, release notes, overview,
+  and LICENSE now use relative paths instead of
+  absolute GitLab URLs. External links (NPM, JSR,
+  GitLab homepage) remain absolute.
+
+- **Fixed repository URL in overview.md** --
+  Corrected `tech-slaves-internal` to `tech-slaves`.
+
+- **`--algo` added to CLI reference** -- Search
+  Options table now documents the `--algo` flag with
+  values `lexical`, `vector`, `hybrid` and a new
+  Search Algorithms subsection.
+
+- **Hybrid search section in search-and-ranking.md**
+  -- New section explains lexical, vector, and hybrid
+  algorithms with plain-language descriptions of
+  how each works and when to use it.
+
+- **Beginner summary in search-and-ranking.md** --
+  Three-sentence intro at the top so non-technical
+  readers know what the page covers without reading
+  the full technical deep-dive.
+
+- **Feature lists updated** -- README and overview
+  now include auto-capture, sync/export, and
+  near-duplicate detection. Design Documents section
+  in overview now links to hybrid search,
+  auto-capture, and sync goal docs.
+
+- **Readability pass** -- Simplified jargon across
+  README and overview. "RRF score fusion" becomes
+  "blends keyword matching with AI-powered
+  similarity". Technology stack table simplified.
+  MCP setup examples consolidated from three
+  nearly-identical blocks into one with platform
+  notes.
+
+- **"Vibe coders" added to audience list** in
+  overview.md.
+
+---
+
+## Upgrade
+
+```sh
+# Node.js
+npm install -g @dikolab/kbdb@0.3.2
+
+# Deno
+deno install -Agf jsr:@dikolab/kbdb/cli
+```

package/docs/release-notes/0.4.0.md

@@ -0,0 +1,80 @@
+# 0.4.0
+
+*Minor release -- 2026-06-25*
+
+Rust engine refactor, daemon reliability, publishing
+fixes, and documentation accuracy audit.
+
+---
+
+## Engine
+
+- **Rust engine refactor** -- extracted specs into
+  separate files, split large modules across all
+  four crates for readability and maintainability.
+
+## Daemon
+
+- **Reliability fixes** -- improved daemon startup,
+  error handling, and shutdown behaviour.
+- **UX improvements** -- clearer error messages and
+  exit codes from the worker daemon.
+
+## CLI
+
+- **Optional `--db`** -- the `--db` flag is now
+  optional. kbdb walks up from the current directory
+  to find `.kbdb`. Set `KBDB_DB_DIR` as an
+  alternative. Resolution order: `--db` flag >
+  `KBDB_DB_DIR` env var > upward traversal from cwd.
+- **Request timeout** -- per-request timeout via
+  `--timeout-ms` flag or `KBDB_DAEMON_TIMEOUT` env
+  var (default 30 000 ms).
+- **Automatic retry** -- on timeout, the CLI
+  respawns the daemon and retries. Configurable via
+  `--retry` flag or `KBDB_RETRY` env var (default 5).
+- **Breaking: `KBDB_DIR` renamed to `KBDB_DB_DIR`**
+  -- update MCP server configs and scripts that
+  reference the old variable name.
+
+## MCP Server
+
+- **Version reports package version** -- the MCP
+  `initialize` response now uses the `VERSION`
+  constant instead of a hardcoded `'0.1.0'` string.
+  Clients see the real server version.
+- **Retry on timeout** -- tool calls and resource
+  reads automatically retry with a fresh daemon
+  connection when the worker times out.
+
+## Packaging
+
+- **Trimmed npm package** -- removed raw TypeScript
+  source files from the npm tarball. Package dropped
+  from 908 files / 6.7 MB to 545 files / 4.5 MB.
+  JSR still includes sources as required.
+
+## Documentation
+
+- **README accuracy audit** -- removed overstated
+  claims about reStructuredText/AsciiDoc parsing
+  and sync feature. Added npm/JSR/license badges
+  and a beta status line.
+- **CLAUDE.md updated** -- corrected outdated
+  statement about the WASM-to-host bridge being
+  stubbed. The bridge is fully implemented and
+  tested.
+- **Docs alignment** -- knowledge-base guide updated
+  to match README on supported file formats.
+
+---
+
+## Upgrade
+
+```sh
+# Node.js
+npm install -g @dikolab/kbdb@0.4.0
+
+# Deno
+deno install -Agf jsr:@dikolab/kbdb/cli
+```

package/docs/release-notes/README.md

@@ -2,6 +2,8 @@
 
 ## Releases
 
+- [0.4.0](0.4.0.md) -- Engine refactor, daemon reliability, publishing fixes
+- [0.3.2](0.3.2.md) -- Docs alignment, hybrid search highlight, readability
 - [0.3.1](0.3.1.md) -- MCP reliability fixes, 20 tools, zero test skips
 - [0.3.0](0.3.0.md) -- Supersession, relaxed queries, export, tags, confidence
 - [0.2.0](0.2.0.md) -- Recall, paginated search, reference graph

package/mod.ts

@@ -24,20 +24,38 @@
  * ```
  */
 
+/** Semantic version string matching `package.json`. */
 export { version } from './src/shared/mod.ts';
 
-export {
-   createWorkerClient,
-   WorkerClient,
-   resolveDbPath,
-   computeContextId,
-} from './src/shared/worker-client/index.ts';
-
-export type {
-   WorkerClientOptions,
-   SearchParams,
-   SearchResult,
-   Section,
-   AddSectionParams,
-   StatusResult,
-} from './src/shared/worker-client/index.ts';
+/** Creates a connected worker client for the given database. */
+export { createWorkerClient } from './src/shared/worker-client/index.ts';
+
+/** Persistent client wrapping JSON-RPC calls to the daemon. */
+export { WorkerClient } from './src/shared/worker-client/index.ts';
+
+/** Resolves a parent directory to the `.kbdb` path inside it. */
+export { resolveDbPath } from './src/shared/worker-client/index.ts';
+
+/** Derives the 16-char hex context ID from an absolute path. */
+export { computeContextId } from './src/shared/worker-client/index.ts';
+
+/** Returns a cached client or creates a new one for the given path. */
+export { getOrCreateClient } from './src/shared/worker-client/index.ts';
+
+/** Options accepted by {@linkcode createWorkerClient}. */
+export type { WorkerClientOptions } from './src/shared/worker-client/index.ts';
+
+/** Parameters for a search query. */
+export type { SearchParams } from './src/shared/worker-client/index.ts';
+
+/** A single ranked result returned by search. */
+export type { SearchResult } from './src/shared/worker-client/index.ts';
+
+/** Raw section record stored on disk. */
+export type { Section } from './src/shared/worker-client/index.ts';
+
+/** Parameters for adding a new section. */
+export type { AddSectionParams } from './src/shared/worker-client/index.ts';
+
+/** Database status snapshot returned by `client.status()`. */
+export type { StatusResult } from './src/shared/worker-client/index.ts';

package/package.json

@@ -1,7 +1,7 @@
 {
    "name": "@dikolab/kbdb",
-   "version": "0.3.1",
-   "description": "CLI tool and MCP server for a file-based knowledge base database",
+   "version": "0.4.0",
+   "description": "CLI tool and MCP server for a file-based knowledge base database -- index documents, search with ranked results, and recall context for AI agents",
    "publishConfig": {
       "access": "public"
    },
@@ -17,13 +17,15 @@
    "license": "ISC",
    "repository": {
       "type": "git",
-      "url": "git@diko-gitlab:tech-slaves-internal/knowledge-base-db.git"
+      "url": "git+https://gitlab.com/tech-slaves/knowledge-base-db.git"
+   },
+   "homepage": "https://gitlab.com/tech-slaves/knowledge-base-db#readme",
+   "bugs": {
+      "url": "https://gitlab.com/tech-slaves/knowledge-base-db/-/issues"
    },
    "files": [
       "dist/**/*",
       "mod.ts",
-      "src/**/*",
-      "!src/**/*.spec.ts",
       "LICENSE",
       "README.md",
       "docs/details/**/*.md",
@@ -37,26 +39,25 @@
    "module": "./dist/mod.mjs",
    "types": "./dist/mod.d.ts",
    "bin": {
-      "kbdb": "./dist/cli.cjs",
-      "kbdb-worker": "./dist/kbdb-worker.cjs"
+      "kbdb": "./dist/cli.cjs"
    },
    "exports": {
       ".": {
-         "deno": "./mod.ts",
          "types": "./dist/mod.d.ts",
+         "deno": "./mod.ts",
          "import": "./dist/mod.mjs",
          "require": "./dist/mod.cjs",
          "default": "./dist/mod.mjs"
       },
       "./cli": {
+         "types": "./dist/cli.d.ts",
          "deno": "./src/cli.ts",
-         "types": "./dist/src/cli.d.ts",
          "import": "./dist/cli.mjs",
          "default": "./dist/cli.mjs"
       },
       "./worker": {
+         "types": "./dist/worker.d.ts",
          "deno": "./src/worker.ts",
-         "types": "./dist/src/worker.d.ts",
          "import": "./dist/worker.mjs",
          "default": "./dist/worker.mjs"
       }

package/dist/chunk-JG2UCKLI.mjs

@@ -1,95 +0,0 @@
-// 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/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
-};
-//# sourceMappingURL=chunk-JG2UCKLI.mjs.map

package/dist/chunk-JG2UCKLI.mjs.map

@@ -1,7 +0,0 @@
-{
-  "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/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", "/**\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": ";AAQO,SAAS,gBAAyB;AACtC,MAAI,OAAO,eAAe,eAAe,UAAU,YAAY;AAC5D,WAAO;AAAA,EACV;AACA,SAAO;AACV;;;ACLO,SAAS,UAAoB;AACjC,MAAI,cAAc,MAAM,QAAQ;AAC7B,UAAM,IAAI;AACV,UAAM,OAAO,EAAE,MAAM;AACrB,WAAO,MAAM,QAAQ,CAAC;AAAA,EACzB;AACA,SAAO,QAAQ,KAAK,MAAM,CAAC;AAC9B;;;ACfA,SAAS,eAAe;AACxB,SAAS,qBAAqB;AAIvB,SAAS,iBACb,UACA,cACO;AACP,MAAI,aAAc,QAAO;AACzB,MAAI,SAAS,WAAW,OAAO;AAC5B,WAAO,QAAQ,cAAc,QAAQ,CAAC;AACzC,SAAO,QAAQ,QAAQ;AAC1B;AAEO,SAAS,eACb,UACA,cACQ;AACR,QAAM,YACH,OAAO,cAAc,cAChB,YACA,iBAAiB,UAAU,YAAY;AAC/C,SAAO,EAAE,WAAW,KAAK,QAAQ,IAAI,EAAE;AAC1C;;;ACxBA,SAAS,YAAY;AAEd,SAAS,YAAY,MAAuB;AAChD,SAAO,KAAK,WAAW,SAAS,KAAK,KAAK,WAAW,UAAU;AAClE;AAEO,SAAS,SAAS,SAAiB,UAA4B;AACnE,MAAI,YAAY,IAAI,GAAG;AACpB,UAAM,WAAW,KAAK,SAAS,GAAG,IAAI,KAAK;AAC3C,WAAO,OAAO,WAAW,SAAS,KAAK,GAAG;AAAA,EAC7C;AACA,SAAO,KAAK,MAAM,GAAG,QAAQ;AAChC;;;ACRO,SAAS,oBACb,WACA,SACO;AACP,MAAI,YAAY,QAAQ;AACrB,WAAO,SAAS,WAAW,WAAW;AAAA,EACzC;AACA,SAAO,SAAS,WAAW,iBAAiB;AAC/C;;;ACVO,SAAS,eAAe,WAA2B;AACvD,SAAO,SAAS,WAAW,MAAM;AACpC;;;ACKA,eAAsB,cAAc,OAAgC;AACjE,QAAM,OAAO,IAAI,YAAY,EAAE,OAAO,KAAK;AAC3C,QAAM,OAAO,MAAM,OAAO,OAAO,OAAO,WAAW,IAAI;AACvD,QAAM,QAAQ,IAAI,WAAW,IAAI;AACjC,SAAO,MAAM,KAAK,KAAK,EACnB,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,SAAS,GAAG,GAAG,CAAC,EAC1C,KAAK,EAAE;AACd;;;AChBA,SAAS,QAAAA,aAAY;;;ACArB,SAAS,cAAc;AAKhB,SAAS,YAAoB;AACjC,SAAO,OAAO;AACjB;;;ADMO,SAAS,WAAW,KAAqB;AAC7C,MAAI,QAAQ,aAAa,SAAS;AAC/B,WAAO,qBAAqB,GAAG;AAAA,EAClC;AACA,SAAOC,MAAK,UAAU,GAAG,QAAQ,GAAG,OAAO;AAC9C;",
-  "names": ["join", "join"]
-}

package/src/cli.ts

@@ -1,71 +0,0 @@
-/**
- * @module
- *
- * CLI and MCP server executable for kbdb. Provides the
- * `kbdb` command with 18 subcommands for managing a
- * file-based knowledge base, and an MCP server mode
- * for AI agent integration.
- */
-
-import { getArgs, detectRuntime } from './shared/runtime/index.ts';
-import {
-   resolveBaseDir,
-   resolveWorkerScript,
-} from './shared/dir-resolver/index.ts';
-import {
-   runCli,
-   isStdinTty,
-   promptUser,
-   findDb,
-   runInit,
-} from './shared/cli/index.ts';
-import type { CliDeps } from './shared/cli/index.ts';
-import { createWorkerClient } from './shared/worker-client/index.ts';
-import { createMcpServer } from './shared/mcp/index.ts';
-
-const runtime = detectRuntime();
-const baseDir = resolveBaseDir(import.meta.url, import.meta.dirname);
-const workerScript = resolveWorkerScript(baseDir.scriptDir, runtime);
-
-const deps: CliDeps = {
-   isStdinTty,
-   promptUser,
-   createWorkerClient: (opts) =>
-      createWorkerClient({ ...opts, workerScript }),
-   findDb,
-   runInit,
-   startMcpServer: async (contextPath) => {
-      const client = await createWorkerClient({
-         contextPath,
-         workerScript,
-      });
-      try {
-         const server = createMcpServer(client);
-         await server.listen();
-      } finally {
-         client.disconnect();
-      }
-   },
-};
-
-async function main(): Promise<void> {
-   const result = await runCli(getArgs(), deps);
-   if (result.output) {
-      // eslint-disable-next-line no-console
-      console.log(result.output);
-   }
-   if (result.error) {
-      // eslint-disable-next-line no-console
-      console.error(result.error);
-   }
-   if (result.exitCode !== 0) {
-      process.exitCode = result.exitCode;
-   }
-}
-
-main().catch((err: unknown) => {
-   const msg = err instanceof Error ? err.message : String(err);
-   // eslint-disable-next-line no-console
-   console.error(`error: ${msg}`);
-   process.exitCode = 1;
-});

package/src/shared/auto-capture/classes/auto-capture-controller.class.ts

@@ -1,62 +0,0 @@
-import type { AutoCaptureConfig } from '../typings/auto-capture-config.interface.ts';
-import type { AutoCaptureState } from '../typings/auto-capture-state.interface.ts';
-import type { AutoCaptureTrigger } from '../typings/auto-capture-trigger.interface.ts';
-import { evaluateTrigger } from '../functions/evaluate-trigger.function.ts';
-
-/**
- * Controls the auto-capture lifecycle.
- *
- * Tracks tool call counts, evaluates trigger conditions, and
- * advances session state when a capture fires. Reset state on
- * disconnect or session end via `reset()`.
- */
-export class AutoCaptureController {
-   private toolCallsSinceLastCapture = 0;
-   private lastCaptureTimestamp = 0;
-   private totalCapturesThisSession = 0;
-   private readonly config: AutoCaptureConfig;
-
-   /** @param config - the auto-capture configuration to use */
-   constructor(config: AutoCaptureConfig) {
-      this.config = config;
-   }
-
-   /** Record one tool call for trigger counting. */
-   recordToolCall(): void {
-      this.toolCallsSinceLastCapture += 1;
-   }
-
-   /**
-    * Evaluates the current state against the trigger criteria.
-    *
-    * When the trigger fires, advances the session counters so the
-    * next evaluation respects rate limiting and the session cap.
-    *
-    * @returns the trigger decision with a human-readable reason
-    */
-   evaluate(): AutoCaptureTrigger {
-      const trigger = evaluateTrigger(this.config, this.state());
-      if (trigger.shouldCapture) {
-         this.totalCapturesThisSession += 1;
-         this.lastCaptureTimestamp = Date.now();
-         this.toolCallsSinceLastCapture = 0;
-      }
-      return trigger;
-   }
-
-   /** Reset all counters, e.g. on client disconnect. */
-   reset(): void {
-      this.toolCallsSinceLastCapture = 0;
-      this.lastCaptureTimestamp = 0;
-      this.totalCapturesThisSession = 0;
-   }
-
-   /** Returns a snapshot of the current controller state. */
-   state(): AutoCaptureState {
-      return {
-         toolCallsSinceLastCapture: this.toolCallsSinceLastCapture,
-         lastCaptureTimestamp: this.lastCaptureTimestamp,
-         totalCapturesThisSession: this.totalCapturesThisSession,
-      };
-   }
-}