@dikolab/kbdb 0.3.2 → 0.4.0

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.2",
-   "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,
-      };
-   }
-}

package/src/shared/auto-capture/constants/auto-capture-defaults.constant.ts

@@ -1,15 +0,0 @@
-import type { AutoCaptureConfig } from '../typings/auto-capture-config.interface.ts';
-
-/**
- * Default configuration for the auto-capture feature.
- *
- * Auto-capture is disabled by default. Enable it in
- * `worker.toml` under `[auto_capture]`.
- */
-export const AUTO_CAPTURE_DEFAULTS: AutoCaptureConfig = {
-   enabled: false,
-   triggerAfterToolCalls: 5,
-   minIntervalMs: 60_000,
-   maxCapturesPerSession: 10,
-   dryRun: false,
-};

package/src/shared/auto-capture/functions/build-capture-prompt.function.ts

@@ -1,27 +0,0 @@
-/**
- * Builds the MCP sampling prompt for knowledge extraction.
- *
- * Instructs the host LLM to identify durable factual knowledge
- * from the recent conversation context, filter out ephemeral or
- * task-specific information, and format the result for storage
- * following memory-protocol criteria.
- *
- * @param recentContext - the conversation excerpt to analyse
- */
-export function buildCapturePrompt(recentContext: string): string {
-   return (
-      'Review the following conversation context and identify' +
-      ' factual knowledge worth storing in the knowledge base.\n\n' +
-      'Rules:\n' +
-      '- Include durable facts, decisions, preferences, and' +
-      ' corrections that would be useful in future sessions.\n' +
-      '- Exclude ephemeral, task-specific, or temporary information' +
-      ' that has no lasting value.\n' +
-      '- Format each piece of extracted knowledge as a concise' +
-      ' statement suitable for direct storage.\n' +
-      '- If no durable knowledge is found, respond with an empty' +
-      ' list.\n\n' +
-      'Conversation context:\n' +
-      recentContext
-   );
-}

package/src/shared/auto-capture/functions/evaluate-trigger.function.ts

@@ -1,50 +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';
-
-/**
- * Evaluates whether auto-capture should fire given the current
- * configuration and runtime state.
- *
- * Checks (in order): feature flag, session cap, rate limit,
- * and tool-call count threshold. Returns the first failing
- * condition as the reason.
- */
-export function evaluateTrigger(
-   config: AutoCaptureConfig,
-   state: AutoCaptureState,
-): AutoCaptureTrigger {
-   if (!config.enabled) {
-      return {
-         shouldCapture: false,
-         reason: 'auto-capture is disabled',
-      };
-   }
-
-   if (state.totalCapturesThisSession >= config.maxCapturesPerSession) {
-      return {
-         shouldCapture: false,
-         reason: 'session capture limit reached',
-      };
-   }
-
-   const elapsed = state.lastCaptureTimestamp
-      ? Date.now() - state.lastCaptureTimestamp
-      : Infinity;
-
-   if (elapsed < config.minIntervalMs) {
-      return {
-         shouldCapture: false,
-         reason: 'within minimum interval',
-      };
-   }
-
-   if (state.toolCallsSinceLastCapture < config.triggerAfterToolCalls) {
-      return {
-         shouldCapture: false,
-         reason: 'tool call threshold not yet reached',
-      };
-   }
-
-   return { shouldCapture: true, reason: 'trigger threshold met' };
-}

package/src/shared/auto-capture/index.ts

@@ -1,7 +0,0 @@
-export { AutoCaptureController } from './classes/auto-capture-controller.class.ts';
-export { AUTO_CAPTURE_DEFAULTS } from './constants/auto-capture-defaults.constant.ts';
-export { evaluateTrigger } from './functions/evaluate-trigger.function.ts';
-export { buildCapturePrompt } from './functions/build-capture-prompt.function.ts';
-export type { AutoCaptureConfig } from './typings/auto-capture-config.interface.ts';
-export type { AutoCaptureTrigger } from './typings/auto-capture-trigger.interface.ts';
-export type { AutoCaptureState } from './typings/auto-capture-state.interface.ts';

package/src/shared/auto-capture/typings/auto-capture-config.interface.ts

@@ -1,13 +0,0 @@
-/** Configuration for auto-capture behavior. */
-export interface AutoCaptureConfig {
-   /** Enable or disable auto-capture. */
-   readonly enabled: boolean;
-   /** Trigger a capture after this many tool calls. */
-   readonly triggerAfterToolCalls: number;
-   /** Minimum time in milliseconds between captures. */
-   readonly minIntervalMs: number;
-   /** Maximum number of captures allowed per session. */
-   readonly maxCapturesPerSession: number;
-   /** Log without writing when true. */
-   readonly dryRun: boolean;
-}

package/src/shared/auto-capture/typings/auto-capture-state.interface.ts

@@ -1,13 +0,0 @@
-/** Runtime state tracked by the auto-capture controller. */
-export interface AutoCaptureState {
-   /** Tool calls recorded since the last successful capture. */
-   readonly toolCallsSinceLastCapture: number;
-   /**
-    * Unix epoch milliseconds of the most recent capture.
-    *
-    * Zero when no capture has occurred this session.
-    */
-   readonly lastCaptureTimestamp: number;
-   /** Total captures completed during the current session. */
-   readonly totalCapturesThisSession: number;
-}

package/src/shared/auto-capture/typings/auto-capture-trigger.interface.ts

@@ -1,7 +0,0 @@
-/** Result of evaluating whether auto-capture should fire. */
-export interface AutoCaptureTrigger {
-   /** Whether a capture should be triggered. */
-   readonly shouldCapture: boolean;
-   /** Human-readable reason for the decision. */
-   readonly reason: string;
-}

package/src/shared/cli/constants/defaults.constant.ts

@@ -1,19 +0,0 @@
-/** Default maximum number of search results returned per query. */
-export const DEFAULT_LIMIT = 20;
-
-/** Default output format when `--format` is not specified. */
-export const DEFAULT_FORMAT = 'json' as const;
-
-/** Default search mode when `--mode` is not specified. */
-export const DEFAULT_MODE = 'sections' as const;
-
-/**
- * File extensions recognised as importable documents by the learn
- * command. Extensions are lowercase and include the leading dot.
- */
-export const SUPPORTED_EXTENSIONS = [
-   '.md',
-   '.txt',
-   '.rst',
-   '.adoc',
-] as const;

package/src/shared/cli/constants/global-help.constant.ts

@@ -1,73 +0,0 @@
-import { VERSION } from '../../version/index.ts';
-
-/**
- * Top-level help text displayed when no command is given or when
- * `--help` is passed without a command name.
- *
- * Lists all available commands grouped by category and describes
- * global options.
- */
-export const GLOBAL_HELP =
-   `kbdb v${VERSION} - File-based knowledge base` +
-   ` database for AI agents\n` +
-   `\n` +
-   `Usage: kbdb [options]\n` +
-   `       kbdb <command> [options] ...[parameters]\n` +
-   `       kbdb <command> <subcommand> [options]` +
-   ` ...[params]\n` +
-   `\n` +
-   `Knowledge Base:\n` +
-   `   learn               Import content from` +
-   ` files/stdin\n` +
-   `   unlearn             Remove sections by kbid\n` +
-   `   search              Query the knowledge base\n` +
-   `   recall              Retrieve section context` +
-   ` by kbid\n` +
-   `   content             Compose rendered content` +
-   ` from ids\n` +
-   `\n` +
-   `Database:\n` +
-   `   db init             Initialise a new .kbdb` +
-   ` directory\n` +
-   `   db migrate          Migrate database to current` +
-   ` format\n` +
-   `\n` +
-   `Maintenance:\n` +
-   `   check               Verify knowledge base` +
-   ` integrity\n` +
-   `   gc                  Garbage collect unreferenced\n` +
-   `                       sections\n` +
-   `   rebuild             Reconstruct all index` +
-   ` files\n` +
-   `   status              Show database status\n` +
-   `   export              Snapshot database for` +
-   ` backup\n` +
-   `\n` +
-   `Skills:\n` +
-   `   skill learn         Create a new skill` +
-   ` definition\n` +
-   `   skill list          List all skills\n` +
-   `   skill get           Retrieve a skill by name` +
-   ` or kbid\n` +
-   `   skill delete        Remove a skill\n` +
-   `\n` +
-   `Agents:\n` +
-   `   agent create        Create an agent with skill` +
-   ` refs\n` +
-   `   agent list          List all agents\n` +
-   `   agent get           Retrieve an agent by docid\n` +
-   `   agent delete        Remove an agent\n` +
-   `\n` +
-   `Server:\n` +
-   `   mcp                 Start MCP server mode` +
-   ` (stdio)\n` +
-   `\n` +
-   `Global Options:\n` +
-   `   -h, --help          Show this help message\n` +
-   `   -v, --version       Show version information\n` +
-   `   --db <path>         Path to .kbdb directory\n` +
-   `   --format <fmt>      Output format` +
-   ` (json|text|mcp)\n` +
-   `\n` +
-   `Run "kbdb <command> --help" for detailed` +
-   ` information.\n`;

package/src/shared/cli/constants/help-text.constant.ts

@@ -1,4 +0,0 @@
-import { generateHelp } from '../functions/generate-help.function.ts';
-
-/** Global help text for the kbdb CLI. */
-export const HELP_TEXT = generateHelp();