@dikolab/kbdb 0.5.0 → 0.6.0

package/package.json

@@ -1,6 +1,6 @@
 {
    "name": "@dikolab/kbdb",
-   "version": "0.5.0",
+   "version": "0.6.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"
@@ -14,7 +14,7 @@
       "wasm"
    ],
    "author": "Diko TechSlave <diko316@gmail.com>",
-   "license": "ISC",
+   "license": "AGPL-3.0-only",
    "repository": {
       "type": "git",
       "url": "git+https://gitlab.com/diko316/knowledge-base-db.git"
@@ -27,12 +27,9 @@
       "dist/**/*",
       "mod.ts",
       "LICENSE",
-      "README.md",
-      "docs/details/**/*.md",
-      "docs/goals/**",
-      "docs/modules/**/*.md",
-      "docs/release-notes/**/*.md",
-      "docs/overview.md"
+      "LICENSING.md",
+      "CLA.md",
+      "README.md"
    ],
    "type": "module",
    "main": "./dist/mod.cjs",
@@ -71,7 +68,10 @@
       "test": "vitest --run",
       "build": "node esbuild.config.js",
       "build:wasm": "cd engine && wasm-pack build crates/query-parser --target no-modules --out-dir ../../../src/wasm/query-parser && wasm-pack build crates/fs-database --target no-modules --out-dir ../../../src/wasm/fs-database && wasm-pack build crates/default-embedding --target no-modules --out-dir ../../../src/wasm/default-embedding && wasm-pack build crates/kb-worker --target no-modules --out-dir ../../../src/wasm/kb-worker",
-      "build:all": "npm run build:wasm && npm run build"
+      "build:all": "npm run build:wasm && npm run build",
+      "docs:dev": "vitepress dev docs",
+      "docs:build": "vitepress build docs",
+      "docs:preview": "vitepress preview docs"
    },
    "devDependencies": {
       "@eslint/js": "^9.36.0",
@@ -86,6 +86,7 @@
       "tslib": "^2.8.1",
       "typescript": "^5.9.3",
       "typescript-eslint": "^8.45.0",
+      "vitepress": "^1.6.4",
       "vitest": "^3.2.4"
    }
 }

package/dist/chunk-BJXEVALU.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/log/typings/log-level.type.ts", "../src/shared/log/functions/parse-log-level.function.ts", "../src/shared/log/constants/log-colors.constant.ts", "../src/shared/log/constants/log-icons.constant.ts", "../src/shared/log/constants/log-defaults.constant.ts", "../src/shared/log/functions/write-stderr.function.ts", "../src/shared/log/functions/log.function.ts", "../src/shared/log/functions/resolve-log-level.function.ts", "../src/shared/log/functions/configure-log.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", "/** Verbosity levels, ordered from most to least verbose. */\nexport enum LogLevel {\n   DEBUG = 0,\n   INFO = 1,\n   WARNING = 2,\n   ERROR = 3,\n}\n", "import { LogLevel } from '../typings/log-level.type.ts';\n\n/** Map from lowercase level name to LogLevel enum value. */\nconst LOG_LEVEL_MAP: Readonly<Record<string, LogLevel>> = {\n   debug: LogLevel.DEBUG,\n   info: LogLevel.INFO,\n   warning: LogLevel.WARNING,\n   error: LogLevel.ERROR,\n};\n\n/**\n * Parses a string into a `LogLevel` enum value.\n *\n * Matching is case-insensitive. Returns `LogLevel.WARNING` for\n * any unrecognized value, including empty strings.\n *\n * @param value - the raw string to parse (e.g. from a CLI flag)\n */\nexport function parseLogLevel(value: string): LogLevel {\n   return LOG_LEVEL_MAP[value.toLowerCase()] ?? LogLevel.WARNING;\n}\n", "import { LogLevel } from '../typings/log-level.type.ts';\n\n/** ANSI escape sequence that resets all text formatting. */\nexport const ANSI_RESET = '\\x1b[0m';\n\n/** ANSI foreground color code applied to each log level's output. */\nexport const LOG_COLORS: Record<LogLevel, string> = {\n   [LogLevel.DEBUG]: '\\x1b[37m',\n   [LogLevel.INFO]: '\\x1b[36m',\n   [LogLevel.WARNING]: '\\x1b[33m',\n   [LogLevel.ERROR]: '\\x1b[91m',\n};\n", "import { LogLevel } from '../typings/log-level.type.ts';\n\n/** Single-character icon used as visual prefix for each log level. */\nexport const LOG_ICONS: Record<LogLevel, string> = {\n   [LogLevel.DEBUG]: '\u25B8',\n   [LogLevel.INFO]: '\u2139',\n   [LogLevel.WARNING]: '\u26A0',\n   [LogLevel.ERROR]: '\u2716',\n};\n", "import { LogLevel } from '../typings/log-level.type.ts';\n\n/** Default log level used when no CLI flag or env var is set. */\nexport const DEFAULT_LOG_LEVEL = LogLevel.ERROR;\n", "/**\n * Writes a string to the process standard error stream.\n *\n * Works on both Node.js (via `process.stderr.write`) and Deno\n * (via `Deno.stderr.writeSync`). Silently does nothing when\n * neither runtime API is available.\n *\n * @param message - the string to write to stderr\n */\nexport function writeStderr(message: string): void {\n   const g = globalThis as Record<string, unknown>;\n   const proc = g['process'] as\n      | { stderr: { write: (s: string) => void } }\n      | undefined;\n   if (proc?.stderr) {\n      proc.stderr.write(message);\n      return;\n   }\n   const deno = g['Deno'] as\n      | { stderr: { writeSync: (b: Uint8Array) => void } }\n      | undefined;\n   deno?.stderr.writeSync(new TextEncoder().encode(message));\n}\n", "import {\n   ANSI_RESET,\n   LOG_COLORS,\n} from '../constants/log-colors.constant.ts';\nimport { LOG_ICONS } from '../constants/log-icons.constant.ts';\nimport { DEFAULT_LOG_LEVEL } from '../constants/log-defaults.constant.ts';\nimport { LogLevel } from '../typings/log-level.type.ts';\nimport { writeStderr } from './write-stderr.function.ts';\n\n/** A function that receives a formatted log line. */\ntype OutputFn = (message: string) => void;\n\nlet currentLevel: LogLevel = DEFAULT_LOG_LEVEL;\n\nconst outputs: Record<LogLevel, OutputFn> = {\n   [LogLevel.DEBUG]: writeStderr,\n   [LogLevel.INFO]: writeStderr,\n   [LogLevel.WARNING]: writeStderr,\n   [LogLevel.ERROR]: writeStderr,\n};\n\n/**\n * Sets the minimum log level. Messages below this level are\n * suppressed. Used internally by `configureLog`.\n */\nexport function setLogLevel(level: LogLevel): void {\n   currentLevel = level;\n}\n\n/**\n * Overrides the output function for a specific log level.\n * Used internally by `configureLog`.\n *\n * @param level - the log level whose output to replace\n * @param output - function that receives the formatted message\n */\nexport function setLogOutput(level: LogLevel, output: OutputFn): void {\n   outputs[level] = output;\n}\n\n/**\n * Writes a formatted, colorized log message to the configured\n * output for the given level. Messages below the current level\n * are silently discarded.\n *\n * Format: `\\x1b[COLORm ICON [LEVEL_NAME] message\\x1b[0m\\n`\n *\n * @param message - the text to log\n * @param level - severity level; defaults to `LogLevel.ERROR`\n */\nexport function log(\n   message: string,\n   level: LogLevel = LogLevel.ERROR,\n): void {\n   if (level < currentLevel) {\n      return;\n   }\n   const color = LOG_COLORS[level];\n   const icon = LOG_ICONS[level];\n   const name = LogLevel[level];\n   const line = `${color}${icon} [${name}] ${message}${ANSI_RESET}\\n`;\n   outputs[level](line);\n}\n", "import type { LogLevel } from '../typings/log-level.type.ts';\nimport { DEFAULT_LOG_LEVEL } from '../constants/log-defaults.constant.ts';\nimport { parseLogLevel } from './parse-log-level.function.ts';\n\n/**\n * Resolves the active log level from CLI flags or the environment.\n *\n * Priority order:\n * 1. `cliLevel` when provided (CLI flag takes highest priority)\n * 2. `KBDB_LOG_LEVEL` environment variable, parsed via `parseLogLevel`\n * 3. `DEFAULT_LOG_LEVEL` (`LogLevel.ERROR`) when neither is set\n *\n * @param cliLevel - explicit level passed from a CLI flag, if any\n */\nexport function resolveLogLevel(cliLevel?: LogLevel): LogLevel {\n   if (cliLevel !== undefined) {\n      return cliLevel;\n   }\n   const envValue = process.env['KBDB_LOG_LEVEL'];\n   if (envValue !== undefined) {\n      return parseLogLevel(envValue);\n   }\n   return DEFAULT_LOG_LEVEL;\n}\n", "import type { LogConfig } from '../typings/log-config.interface.ts';\nimport { LogLevel } from '../typings/log-level.type.ts';\nimport { setLogLevel, setLogOutput } from './log.function.ts';\n\n/**\n * Applies a log configuration, setting the active log level and\n * optionally overriding the output target for individual levels.\n *\n * Only levels listed in `config.outputs` are affected; all other\n * level outputs remain unchanged. Calling this function multiple\n * times is safe -- the last call's settings take effect.\n *\n * @param config - desired log level and optional per-level outputs\n */\nexport function configureLog(config: LogConfig): void {\n   setLogLevel(config.level);\n   if (config.outputs === undefined) {\n      return;\n   }\n   const levels: LogLevel[] = [\n      LogLevel.DEBUG,\n      LogLevel.INFO,\n      LogLevel.WARNING,\n      LogLevel.ERROR,\n   ];\n   for (const level of levels) {\n      const output = config.outputs[level];\n      if (output !== undefined) {\n         setLogOutput(level, output.write);\n      }\n   }\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": ["LogLevel", "join", "join"]
-}

package/dist/src/shared/cli/functions/resolve-raw-db-path.function.d.ts

@@ -1,10 +0,0 @@
-import type { CliOptions } from '../typings/cli-options.interface.ts';
-/**
- * Resolves the explicit database path from CLI
- * options or the `KBDB_DB_DIR` environment variable.
- *
- * Returns `undefined` when neither is set so that
- * `findDb` can fall back to upward directory
- * traversal from the current working directory.
- */
-export declare function resolveRawDbPath(options: Pick<CliOptions, 'dbPath'>): string | undefined;

package/docs/details/README.md

@@ -1,30 +0,0 @@
-# Detailed Documentation
-
-In-depth guides and reference for @dikolab/kbdb.
-
-## Guides
-
-- [Knowledge Base Guide](knowledge-base.md) --
-  Importing, searching, recall, sync & backup
-- [Agent Tooling Guide](agent-tooling.md) -- MCP,
-  skills, agents, library API, worker daemon
-- [CLI Reference](cli.md) -- Full command reference
-  with examples
-- [MCP Server Setup](mcp-server.md) -- Configure
-  kbdb as an AI agent plugin
-- [Library API](library-api.md) -- Use kbdb from
-  Node.js or Deno code
-
-## Technical Reference
-
-- [Search and Ranking](search-and-ranking.md) --
-  How search works under the hood
-- [Storage Architecture](storage.md) -- File formats,
-  directory layout, and design principles
-
-## See Also
-
-- [Architecture Overview](../overview.md)
-- [Design Goals](../goals/)
-- [Module Reference](../modules/)
-- [Release Notes](../release-notes/)

package/docs/details/agent-tooling.md

@@ -1,132 +0,0 @@
-# Agent Tooling Guide
-
-How to integrate kbdb with AI agents using the MCP
-server, skills, agent profiles, and the library API.
-
-## Overview
-
-kbdb runs as an
-[MCP](https://modelcontextprotocol.io/) server with
-20 tools, giving AI agents a searchable second brain
-that persists between sessions. Agents can search
-your knowledge base, recall context progressively,
-store reusable skills, and build agent profiles.
-
-## MCP Server Setup
-
-Add kbdb to your AI tool's MCP config. The setup is
-the same for Claude Code, VS Code, Cursor, and
-Claude Desktop -- just put the config in the right
-file for your tool.
-
-```json
-{
-   "mcpServers": {
-      "kbdb": {
-         "command": "npx",
-         "args": [
-            "-y", "@dikolab/kbdb",
-            "mcp", "--db", "/path/to/.kbdb"
-         ]
-      }
-   }
-}
-```
-
-**Deno users:** replace `npx` / `-y` /
-`@dikolab/kbdb` with `deno` / `run` / `-A` /
-`jsr:@dikolab/kbdb/cli`.
-
-Environment variables:
-
-| Variable | Description |
-|----------|-------------|
-| `KBDB_DB_DIR` | Database path (replaces `--db`) |
-| `KBDB_LOG_LEVEL` | `debug`, `info`, `warning`, `error` |
-| `KBDB_NON_INTERACTIVE` | Suppress prompts (`1` / `true`) |
-| `KBDB_DAEMON_TIMEOUT` | Request timeout in ms |
-| `KBDB_RETRY` | Max retries on timeout |
-
-See the [MCP Server Guide](mcp-server.md) for
-environment variable config, multiple knowledge
-bases, and the full 20-tool reference.
-
-## Skills
-
-Skills are reusable prompt templates with
-fill-in-the-blank arguments.
-
-```sh
-kbdb skill learn --name "code-review" \
-   --body "Review this code for: {{focus}}" \
-   --db ./my-kb
-```
-
-Skills are stored in the knowledge base and
-accessible to agents via MCP tools.
-
-## Agent Profiles
-
-Agent profiles combine a persona with a set of
-skills.
-
-```sh
-kbdb agent create --name "reviewer" \
-   --persona "You are a senior code reviewer." \
-   --skills "code-review,style-check" \
-   --db ./my-kb
-```
-
-## Auto-Capture
-
-The MCP server can proactively suggest knowledge
-to store from conversations. When enabled,
-auto-capture monitors tool call patterns and
-triggers capture suggestions based on configurable
-thresholds.
-
-## Library API
-
-Use kbdb programmatically in Node.js or Deno:
-
-```typescript
-import { createWorkerClient } from '@dikolab/kbdb';
-
-const client = await createWorkerClient({
-   contextPath: '/path/to/.kbdb',
-});
-
-const results = await client.search({
-   query: 'authentication',
-   limit: 10,
-});
-
-console.log(results.items);
-client.disconnect();
-```
-
-See the
-[Library API Reference](library-api.md)
-for the full API.
-
-## Worker Daemon
-
-kbdb runs a background worker daemon that handles
-indexing and search. The daemon auto-spawns on the
-first CLI or MCP command and stops when idle.
-
-```sh
-kbdb worker stop --db ./my-kb      # stop daemon
-kbdb worker restart --db ./my-kb   # restart daemon
-```
-
-The daemon writes a PID file and Unix socket under
-the system temp directory. After upgrading kbdb,
-restart the daemon to pick up the new version.
-
-## Deep Dives
-
-- [MCP Server Guide](mcp-server.md) -- full tool
-  list, environment config, multi-KB setup
-- [Library API Reference](library-api.md) --
-  programmatic access for custom integrations