@dikolab/kbdb 0.2.0 → 0.2.2

package/dist/mod.cjs

@@ -29,7 +29,7 @@ __export(mod_exports, {
 module.exports = __toCommonJS(mod_exports);
 
 // src/shared/version/constants/version.constant.ts
-var VERSION = "0.2.0";
+var VERSION = "0.2.2";
 
 // src/shared/worker-client/classes/worker-client.class.ts
 var import_node_net = require("node:net");

package/dist/mod.cjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../mod.ts", "../src/shared/version/constants/version.constant.ts", "../src/shared/worker-client/classes/worker-client.class.ts", "../src/shared/worker-client/functions/create-worker-client.function.ts", "../src/shared/worker-client/functions/resolve-db-path.function.ts", "../src/shared/hash/functions/compute-sha256.ts", "../src/shared/worker-client/functions/compute-context-id.function.ts", "../src/shared/worker-client/functions/discover-daemon.function.ts", "../src/shared/platform/functions/is-process-alive.function.ts", "../src/shared/worker-client/functions/spawn-daemon.function.ts", "../src/shared/worker-client/functions/wait-for-daemon.function.ts", "../src/shared/runtime/functions/detect-runtime.ts", "../src/shared/platform/functions/get-ipc-path.function.ts", "../src/shared/platform/functions/get-tmpdir.function.ts"],
-  "sourcesContent": ["export { version } from './src/shared/mod.ts';\n\nexport {\n   createWorkerClient,\n   WorkerClient,\n   resolveDbPath,\n   computeContextId,\n} from './src/shared/worker-client/index.ts';\n\nexport type {\n   WorkerClientOptions,\n   SearchParams,\n   SearchResult,\n   Section,\n   AddSectionParams,\n   StatusResult,\n} from './src/shared/worker-client/index.ts';\n", "/** Current package version, kept in sync with package.json. */\nexport const VERSION = '0.2.0';\n", "import { connect } from 'node:net';\nimport type { Socket } from 'node:net';\nimport type { SearchParams } from '../typings/search-params.model.ts';\nimport type { PagedSearchResult } from '../typings/search-result.model.ts';\nimport type {\n   AddSectionParams,\n   Section,\n} from '../typings/section.model.ts';\nimport type { StatusResult } from '../typings/status-result.model.ts';\nimport type { AddSectionResult } from '../typings/add-section-result.model.ts';\nimport type { RemoveSectionResult } from '../typings/remove-section-result.model.ts';\nimport type { ContentResult } from '../typings/content-result.model.ts';\nimport type { IntegrityCheckResult } from '../typings/integrity-check-result.model.ts';\nimport type { GcResult } from '../typings/gc-result.model.ts';\nimport type { RebuildResult } from '../typings/rebuild-result.model.ts';\nimport type { MigrateResult } from '../typings/migrate-result.model.ts';\nimport type { VersionStatus } from '../typings/version-status.model.ts';\nimport type { SectionRecord } from '../../wasm-codec/functions/decode-section-records.function.ts';\nimport type { DocumentManifest } from '../../wasm-codec/functions/decode-document-manifest.function.ts';\nimport type {\n   RecallParams,\n   RecallResult,\n} from '../typings/recall-result.model.ts';\n\n/** Pending JSON-RPC call awaiting a response from the daemon. */\ninterface PendingCall {\n   resolve: (v: unknown) => void;\n   reject: (e: Error) => void;\n}\n\n/** Shape of a JSON-RPC 2.0 error object from the daemon. */\ninterface JsonRpcError {\n   readonly code: number;\n   readonly message: string;\n}\n\n/** Shape of a JSON-RPC 2.0 response from the daemon. */\ninterface JsonRpcResponse {\n   readonly id: number;\n   readonly result?: unknown;\n   readonly error?: JsonRpcError;\n}\n\n/**\n * IPC client that communicates with the worker daemon over a Unix\n * domain socket (or Windows named pipe) using JSON-RPC 2.0 with\n * newline-delimited message framing.\n *\n * Call `connect()` before any other method and `disconnect()` when\n * done to release the underlying socket.\n */\nexport class WorkerClient {\n   /** Underlying socket; `null` when not connected. */\n   private socket: Socket | null = null;\n\n   /** Monotonically increasing request ID counter. */\n   private nextId = 1;\n\n   /** Map of outstanding request IDs to their resolve/reject pairs. */\n   private readonly pending = new Map<number, PendingCall>();\n\n   /** Partial line buffer for split TCP/IPC frames. */\n   private buffer = '';\n\n   /**\n    * @param socketPath - absolute path to the daemon's IPC socket\n    *   (or Windows named pipe path)\n    * @param contextId - 16-character context identifier sent as\n    *   `ctx` in every JSON-RPC request\n    */\n   constructor(\n      private readonly socketPath: string,\n      private readonly contextId: string,\n   ) {}\n\n   /**\n    * Establishes the IPC connection to the worker daemon.\n    *\n    * @throws {Error} if the connection cannot be established\n    */\n   async connect(): Promise<void> {\n      return new Promise<void>((resolve, reject) => {\n         this.socket = connect(this.socketPath, () => {\n            resolve();\n         });\n         this.socket.on('error', (err: Error) => {\n            reject(err);\n         });\n         this.socket.on('data', (chunk: Buffer) => {\n            this.handleData(chunk.toString());\n         });\n      });\n   }\n\n   /** Destroys the IPC socket and clears the connection state. */\n   disconnect(): void {\n      if (this.socket) {\n         this.socket.destroy();\n         this.socket = null;\n      }\n   }\n\n   /**\n    * Searches the knowledge base.\n    *\n    * @param params - query parameters including the search string\n    * @returns paginated search results with metadata\n    */\n   async search(params: SearchParams): Promise<PagedSearchResult> {\n      return this.call('search', params) as Promise<PagedSearchResult>;\n   }\n\n   /**\n    * Retrieves full content and context for one or more sections by\n    * their knowledge-base identifiers.\n    *\n    * @param params - section identifier(s) and optional expansion depth\n    * @returns a single `RecallResult` when `kbid` is provided without\n    *   `kbids`, or a `RecallResult[]` when `kbids` is provided\n    */\n   async recall(\n      params: RecallParams,\n   ): Promise<RecallResult | RecallResult[]> {\n      return this.call('recall', params) as Promise<\n         RecallResult | RecallResult[]\n      >;\n   }\n\n   /**\n    * Adds a new section to the knowledge base.\n    *\n    * @param params - section content and metadata\n    * @returns the result including the assigned knowledge-base\n    *   identifier and indexing statistics\n    */\n   async addSection(\n      params: AddSectionParams,\n   ): Promise<AddSectionResult> {\n      return this.call(\n         'addSection',\n         params,\n      ) as Promise<AddSectionResult>;\n   }\n\n   /**\n    * Replaces an existing section's content and metadata.\n    *\n    * @param kbid - identifier of the section to update\n    * @param params - new content and metadata\n    * @returns the knowledge-base identifier of the updated section\n    */\n   async updateSection(\n      kbid: string,\n      params: AddSectionParams,\n   ): Promise<string> {\n      return this.call('updateSection', {\n         kbid,\n         ...params,\n      }) as Promise<string>;\n   }\n\n   /**\n    * Removes a section from the knowledge base.\n    *\n    * @param kbid - identifier of the section to remove\n    * @returns removal result with `removed` flag and elapsed time\n    */\n   async removeSection(kbid: string): Promise<RemoveSectionResult> {\n      return this.call('removeSection', {\n         kbid,\n      }) as Promise<RemoveSectionResult>;\n   }\n\n   /**\n    * Retrieves multiple sections by their identifiers.\n    *\n    * @param kbids - list of knowledge-base identifiers to fetch\n    * @returns sections in the order their IDs were requested\n    */\n   async readSections(kbids: string[]): Promise<Section[]> {\n      return this.call('readSections', {\n         kbids,\n      }) as Promise<Section[]>;\n   }\n\n   /**\n    * Groups a set of sections under a named document.\n    *\n    * @param title - human-readable document title\n    * @param kbids - identifiers of the sections to group\n    * @param docType - application-level document type tag; omit or\n    *   pass an empty string for untagged documents\n    * @returns the assigned document identifier\n    */\n   async groupSections(\n      title: string,\n      kbids: string[],\n      docType?: string,\n   ): Promise<string> {\n      const result = (await this.call('groupSections', {\n         title,\n         kbids,\n         docType: docType ?? '',\n      })) as { docid: string } | string;\n      return typeof result === 'string' ? result : result.docid;\n   }\n\n   /**\n    * Removes the document grouping for the given document.\n    *\n    * The sections themselves are not deleted; only the grouping\n    * record is removed.\n    *\n    * @param docid - identifier of the document grouping to remove\n    */\n   async removeGrouping(docid: string): Promise<void> {\n      await this.call('removeGrouping', { docid });\n   }\n\n   /**\n    * Retrieves a full document record including its sections.\n    *\n    * @param docid - identifier of the document to retrieve\n    * @returns the document record as returned by the daemon\n    */\n   async retrieveDocument(docid: string): Promise<unknown> {\n      return this.call('retrieveDocument', { docid });\n   }\n\n   /**\n    * Composes a rendered Markdown document from one or more kbid\n    * or docid identifiers.\n    *\n    * @param ids - list of kbid or docid identifiers (may be mixed)\n    * @returns composed Markdown result with character count\n    */\n   async content(ids: string[]): Promise<ContentResult> {\n      return this.call('content', { ids }) as Promise<ContentResult>;\n   }\n\n   /**\n    * Runs an integrity check on the knowledge-base database.\n    *\n    * @returns a report of all issues found; `ok` is `true` when\n    *   no errors were detected\n    */\n   async integrityCheck(): Promise<IntegrityCheckResult> {\n      return this.call(\n         'integrityCheck',\n         {},\n      ) as Promise<IntegrityCheckResult>;\n   }\n\n   /**\n    * Removes unreferenced sections from the database.\n    *\n    * @returns a report of sections removed and bytes freed\n    */\n   async gc(): Promise<GcResult> {\n      return this.call('gc', {}) as Promise<GcResult>;\n   }\n\n   /**\n    * Reconstructs all index files from section files and document\n    * manifests on disk. Text and code sections are re-tokenized;\n    * image sections are skipped.\n    *\n    * @returns a report of sections and terms re-indexed\n    */\n   async rebuildIndexes(): Promise<RebuildResult> {\n      return this.call('rebuildIndexes', {}) as Promise<RebuildResult>;\n   }\n\n   /**\n    * Invalidates the in-memory cache entry for a single section.\n    *\n    * @param kbid - identifier of the section to evict from cache\n    */\n   async invalidate(kbid: string): Promise<void> {\n      await this.call('invalidate', { kbid });\n   }\n\n   /** Clears all entries from the daemon's in-memory cache. */\n   async invalidateAll(): Promise<void> {\n      await this.call('invalidateAll', {});\n   }\n\n   /**\n    * Retrieves diagnostic status information from the daemon.\n    *\n    * @returns current initialization state and cache statistics\n    */\n   async status(): Promise<StatusResult> {\n      return this.call('status', {}) as Promise<StatusResult>;\n   }\n\n   /**\n    * Returns database metadata and status from the daemon,\n    * including document count, section count, index size, and\n    * cache statistics.\n    *\n    * @returns database metadata from the daemon's cached state\n    */\n   async dbStatus(): Promise<StatusResult> {\n      return this.call('dbStatus', {}) as Promise<StatusResult>;\n   }\n\n   /**\n    * Initialises a new `.kbdb` database directory at the given path\n    * by sending an init request to the worker daemon.\n    *\n    * The daemon creates all required subdirectories and seed files via\n    * the `worker_init_directory` WASM export.\n    *\n    * @param targetPath - absolute path to the directory that will\n    *   contain the new `.kbdb` database\n    * @throws {Error} if the `.kbdb` directory already exists or the\n    *   daemon cannot create the layout\n    */\n   async initDirectory(targetPath: string): Promise<void> {\n      await this.call('initDirectory', { targetPath });\n   }\n\n   /**\n    * Runs all pending database migrations for the `.kbdb` directory\n    * at the given path.\n    *\n    * Delegates to the `worker_migrate` WASM export on the daemon.\n    * Each migration step updates `catalog.toml` on success, so\n    * retrying after a partial failure is safe.\n    *\n    * @param targetPath - absolute path to the `.kbdb` database root\n    * @returns migration report with old version, new version, and\n    *   number of migration steps applied\n    */\n   async migrateDatabase(targetPath: string): Promise<MigrateResult> {\n      return this.call('migrateDatabase', {\n         targetPath,\n      }) as Promise<MigrateResult>;\n   }\n\n   /**\n    * Checks the format version of the `.kbdb` database at the given\n    * path against the version required by the current WASM engine.\n    *\n    * This is a read-only operation: it reads `catalog.toml` and\n    * returns the compatibility status without making any changes.\n    *\n    * @param targetPath - absolute path to the `.kbdb` database root\n    * @returns version compatibility report\n    */\n   async checkVersion(targetPath: string): Promise<VersionStatus> {\n      return this.call('checkVersion', {\n         targetPath,\n      }) as Promise<VersionStatus>;\n   }\n\n   /**\n    * Retrieves all sections whose type name matches the given string.\n    *\n    * @param sectionType - the application-level type name to filter by\n    * @returns all section records with a matching type name\n    */\n   async listByType(sectionType: string): Promise<SectionRecord[]> {\n      return this.call('listByType', {\n         sectionType,\n      }) as Promise<SectionRecord[]>;\n   }\n\n   /**\n    * Retrieves all documents whose type name matches the given string.\n    *\n    * @param docType - the application-level document type to filter by\n    * @returns all document manifests with a matching type name\n    */\n   async listDocumentsByType(\n      docType: string,\n   ): Promise<DocumentManifest[]> {\n      return this.call('listDocumentsByType', {\n         docType,\n      }) as Promise<DocumentManifest[]>;\n   }\n\n   /**\n    * Sends a JSON-RPC 2.0 request and awaits the response.\n    *\n    * @param method - the RPC method name\n    * @param params - parameters to include in the request\n    * @throws {Error} if not connected\n    * @throws {Error} when the daemon returns an error response\n    */\n   private async call(\n      method: string,\n      params: unknown,\n   ): Promise<unknown> {\n      const socket = this.socket;\n      if (!socket) {\n         throw new Error('not connected');\n      }\n\n      const id = this.nextId++;\n      const request = {\n         jsonrpc: '2.0',\n         id,\n         method,\n         params: { ctx: this.contextId, ...(params as object) },\n      };\n\n      return new Promise<unknown>((resolve, reject) => {\n         this.pending.set(id, { resolve, reject });\n         socket.write(JSON.stringify(request) + '\\n');\n      });\n   }\n\n   /**\n    * Processes incoming data from the socket, splitting on newlines\n    * and dispatching complete JSON-RPC response objects.\n    *\n    * @param data - raw string chunk received from the socket\n    */\n   private handleData(data: string): void {\n      this.buffer += data;\n      const lines = this.buffer.split('\\n');\n      this.buffer = lines.pop() ?? '';\n\n      for (const line of lines) {\n         if (!line.trim()) continue;\n         try {\n            const response = JSON.parse(line) as JsonRpcResponse;\n            const pending = this.pending.get(response.id);\n            if (pending) {\n               this.pending.delete(response.id);\n               if (response.error) {\n                  const err = new Error(response.error.message);\n                  (err as unknown as Record<string, unknown>).code =\n                     response.error.code;\n                  pending.reject(err);\n               } else {\n                  pending.resolve(response.result);\n               }\n            }\n         } catch {\n            // Ignore unparseable lines\n         }\n      }\n   }\n}\n", "import { existsSync, readFileSync, unlinkSync } from 'node:fs';\nimport { join } from 'node:path';\nimport { tmpdir } from 'node:os';\nimport { WorkerClient } from '../classes/worker-client.class.ts';\nimport { resolveDbPath } from './resolve-db-path.function.ts';\nimport { computeContextId } from './compute-context-id.function.ts';\nimport { discoverDaemon } from './discover-daemon.function.ts';\nimport { spawnDaemon } from './spawn-daemon.function.ts';\nimport { waitForDaemon } from './wait-for-daemon.function.ts';\nimport { detectRuntime } from '../../runtime/functions/detect-runtime.ts';\nimport { getIpcPath } from '../../platform/functions/get-ipc-path.function.ts';\nimport type { WorkerClientOptions } from '../typings/worker-client-options.interface.ts';\n\n/**\n * Creates and connects a `WorkerClient` to the worker daemon.\n *\n * Resolves the context path, derives a stable context identifier,\n * and checks whether a daemon is already running. If no daemon is\n * found and `autoSpawn` is not `false`, a new daemon process is\n * spawned and the factory waits for its PID file to appear before\n * connecting.\n *\n * @param options - optional configuration for path resolution,\n *   auto-spawn behaviour, and connection timeout\n * @returns a connected `WorkerClient` ready to send requests\n * @throws {Error} if the `.kbdb` directory cannot be found\n * @throws {Error} if the socket connection cannot be established\n */\nexport async function createWorkerClient(\n   options?: WorkerClientOptions,\n): Promise<WorkerClient> {\n   const dbPath =\n      options?.contextPath ?? resolveDbPath(options?.dbPath);\n   const contextId = await computeContextId(dbPath);\n   const socketPath = getIpcPath(contextId);\n\n   let daemon = discoverDaemon(contextId);\n\n   if (!daemon && options?.autoSpawn !== false) {\n      const runtime = detectRuntime();\n      spawnDaemon(dbPath, runtime, options?.workerScript);\n      await waitForDaemon(contextId, options?.connectTimeoutMs);\n      daemon = discoverDaemon(contextId);\n   }\n\n   if (!daemon) {\n      throw new Error(\n         `kbdb worker daemon did not start: ${readCrashReason(contextId)}`,\n      );\n   }\n\n   const client = new WorkerClient(socketPath, contextId);\n   await client.connect();\n   return client;\n}\n\nfunction readCrashReason(contextId: string): string {\n   const crashPath = join(tmpdir(), `kbdb-${contextId}.crash`);\n   if (!existsSync(crashPath)) {\n      return 'daemon failed to start (no details available)';\n   }\n   try {\n      const raw = readFileSync(crashPath, 'utf-8');\n      const crash = JSON.parse(raw) as { error?: string };\n      unlinkSync(crashPath);\n      return crash.error ?? 'unknown error (crash log empty)';\n   } catch {\n      return 'daemon failed to start (crash log unreadable)';\n   }\n}\n", "import { existsSync } from 'node:fs';\nimport { join, resolve } from 'node:path';\n\n/**\n * Resolves the absolute path to the `.kbdb` database directory.\n *\n * Searches for a `.kbdb` sub-directory inside `targetDir`. When\n * `targetDir` is omitted, `process.cwd()` is used as the base.\n *\n * @param targetDir - directory to search in; defaults to cwd\n * @throws {Error} if no `.kbdb` directory exists at the resolved\n *   path\n */\nexport function resolveDbPath(targetDir?: string): string {\n   const base = targetDir ? resolve(targetDir) : process.cwd();\n   const dbPath = join(base, '.kbdb');\n   if (!existsSync(dbPath)) {\n      throw new Error(`database not found: ${dbPath}`);\n   }\n   return dbPath;\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 { computeSha256 } from '../../hash/functions/compute-sha256.ts';\n\n/**\n * Computes a short context identifier for an absolute path.\n *\n * Hashes the path with SHA-256 and returns the first 16 hex\n * characters. The result is stable for the same input and unique\n * enough to avoid accidental collisions across typical path sets.\n *\n * @param absolutePath - the absolute filesystem path to identify\n * @returns a 16-character lowercase hex string\n */\nexport async function computeContextId(\n   absolutePath: string,\n): Promise<string> {\n   const hash = await computeSha256(absolutePath);\n   return hash.slice(0, 16);\n}\n", "import { existsSync, readFileSync, unlinkSync } from 'node:fs';\nimport { join } from 'node:path';\nimport { tmpdir } from 'node:os';\nimport { isProcessAlive } from '../../platform/functions/is-process-alive.function.ts';\nimport type { DaemonInfo } from '../typings/daemon-info.model.ts';\n\nexport type { DaemonInfo };\n\n/**\n * Discovers a running worker daemon for the given context.\n *\n * Reads the PID file at `<tmpdir>/kbdb-<contextId>.pid`. If the\n * file exists and the process is alive, returns its PID and the\n * expected socket path. If the file is stale (process dead or PID\n * unparseable), removes the PID file and returns `null`.\n *\n * @param contextId - the 16-character context identifier\n * @returns daemon location info, or `null` if no live daemon found\n */\nexport function discoverDaemon(contextId: string): DaemonInfo | null {\n   const pidPath = join(tmpdir(), `kbdb-${contextId}.pid`);\n\n   if (!existsSync(pidPath)) return null;\n\n   const pidStr = readFileSync(pidPath, 'utf-8').trim();\n   const pid = parseInt(pidStr, 10);\n\n   if (isNaN(pid) || !isProcessAlive(pid)) {\n      try {\n         unlinkSync(pidPath);\n      } catch {\n         // Stale PID file removal is best-effort\n      }\n      return null;\n   }\n\n   const socketPath = join(tmpdir(), `kbdb-${contextId}.sock`);\n\n   const crashPath = join(tmpdir(), `kbdb-${contextId}.crash`);\n   try {\n      unlinkSync(crashPath);\n   } catch {\n      // stale crash file removal is best-effort\n   }\n\n   return { pid, socketPath };\n}\n", "/**\n * Checks whether a process with the given PID is alive.\n *\n * Sends signal `0` to the process, which performs a permission\n * check without sending an actual signal. Returns `true` if the\n * process exists and is reachable, `false` otherwise.\n *\n * @param pid - the process identifier to probe\n */\nexport function isProcessAlive(pid: number): boolean {\n   try {\n      process.kill(pid, 0);\n      return true;\n   } catch {\n      return false;\n   }\n}\n", "import { spawn } from 'node:child_process';\nimport type { Runtime } from '../../runtime/typings/runtime.ts';\n\n/**\n * Spawns a detached worker daemon process for the given context.\n *\n * @param contextPath - absolute path to the context directory the\n *   daemon should serve\n * @param runtime - the current JavaScript runtime environment\n * @param workerScript - absolute path to the worker daemon script,\n *   resolved at the entry point by `resolveWorkerScript`\n */\nexport function spawnDaemon(\n   contextPath: string,\n   runtime: Runtime,\n   workerScript?: string,\n): void {\n   if (!workerScript) {\n      throw new Error(\n         'workerScript must be provided' + ' (resolve at entry point)',\n      );\n   }\n   const execPath = runtime === 'deno' ? 'deno' : process.execPath;\n\n   const args =\n      runtime === 'deno'\n         ? ['run', '--allow-all', workerScript, contextPath]\n         : [workerScript, contextPath];\n\n   const child = spawn(execPath, args, {\n      detached: true,\n      stdio: 'ignore',\n   });\n   child.unref();\n}\n", "import { existsSync } from 'node:fs';\nimport { join } from 'node:path';\nimport { tmpdir } from 'node:os';\n\n/** Default maximum wait time for the daemon PID file to appear. */\nconst DEFAULT_TIMEOUT_MS = 10_000;\n\n/** Polling interval in milliseconds between existence checks. */\nconst POLL_INTERVAL_MS = 100;\n\n/**\n * Waits for the worker daemon's PID file to appear on disk.\n *\n * Polls every 100 ms until the PID file at\n * `<tmpdir>/kbdb-<contextId>.pid` exists or the timeout elapses.\n *\n * @param contextId - the 16-character context identifier\n * @param timeoutMs - maximum wait time in milliseconds; defaults\n *   to 10 000 ms\n * @returns `true` if the PID file appeared before the timeout,\n *   `false` otherwise\n */\nexport async function waitForDaemon(\n   contextId: string,\n   timeoutMs: number = DEFAULT_TIMEOUT_MS,\n): Promise<boolean> {\n   const pidPath = join(tmpdir(), `kbdb-${contextId}.pid`);\n   const start = Date.now();\n   while (Date.now() - start < timeoutMs) {\n      if (existsSync(pidPath)) return true;\n      await new Promise<void>((r) => setTimeout(r, POLL_INTERVAL_MS));\n   }\n   return false;\n}\n", "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 { 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"],
+  "sourcesContent": ["/**\n * @module\n *\n * File-based knowledge base database for AI agents.\n * Provides a programmatic API for indexing documents,\n * searching with ranked results, and recalling section\n * context at progressive depths.\n *\n * @example\n * ```ts\n * import { createWorkerClient } from '@dikolab/kbdb';\n *\n * const client = await createWorkerClient({\n *    contextPath: '/path/to/.kbdb',\n * });\n *\n * const results = await client.search({\n *    query: 'authentication',\n *    limit: 10,\n * });\n *\n * console.log(results.items);\n * client.disconnect();\n * ```\n */\n\nexport { version } from './src/shared/mod.ts';\n\nexport {\n   createWorkerClient,\n   WorkerClient,\n   resolveDbPath,\n   computeContextId,\n} from './src/shared/worker-client/index.ts';\n\nexport type {\n   WorkerClientOptions,\n   SearchParams,\n   SearchResult,\n   Section,\n   AddSectionParams,\n   StatusResult,\n} from './src/shared/worker-client/index.ts';\n", "/** Current package version, kept in sync with package.json. */\nexport const VERSION = '0.2.2';\n", "import { connect } from 'node:net';\nimport type { Socket } from 'node:net';\nimport type { SearchParams } from '../typings/search-params.model.ts';\nimport type { PagedSearchResult } from '../typings/search-result.model.ts';\nimport type {\n   AddSectionParams,\n   Section,\n} from '../typings/section.model.ts';\nimport type { StatusResult } from '../typings/status-result.model.ts';\nimport type { AddSectionResult } from '../typings/add-section-result.model.ts';\nimport type { RemoveSectionResult } from '../typings/remove-section-result.model.ts';\nimport type { ContentResult } from '../typings/content-result.model.ts';\nimport type { IntegrityCheckResult } from '../typings/integrity-check-result.model.ts';\nimport type { GcResult } from '../typings/gc-result.model.ts';\nimport type { RebuildResult } from '../typings/rebuild-result.model.ts';\nimport type { MigrateResult } from '../typings/migrate-result.model.ts';\nimport type { VersionStatus } from '../typings/version-status.model.ts';\nimport type { SectionRecord } from '../../wasm-codec/functions/decode-section-records.function.ts';\nimport type { DocumentManifest } from '../../wasm-codec/functions/decode-document-manifest.function.ts';\nimport type {\n   RecallParams,\n   RecallResult,\n} from '../typings/recall-result.model.ts';\n\n/** Pending JSON-RPC call awaiting a response from the daemon. */\ninterface PendingCall {\n   resolve: (v: unknown) => void;\n   reject: (e: Error) => void;\n}\n\n/** Shape of a JSON-RPC 2.0 error object from the daemon. */\ninterface JsonRpcError {\n   readonly code: number;\n   readonly message: string;\n}\n\n/** Shape of a JSON-RPC 2.0 response from the daemon. */\ninterface JsonRpcResponse {\n   readonly id: number;\n   readonly result?: unknown;\n   readonly error?: JsonRpcError;\n}\n\n/**\n * IPC client that communicates with the worker daemon over a Unix\n * domain socket (or Windows named pipe) using JSON-RPC 2.0 with\n * newline-delimited message framing.\n *\n * Call `connect()` before any other method and `disconnect()` when\n * done to release the underlying socket.\n */\nexport class WorkerClient {\n   /** Underlying socket; `null` when not connected. */\n   private socket: Socket | null = null;\n\n   /** Monotonically increasing request ID counter. */\n   private nextId = 1;\n\n   /** Map of outstanding request IDs to their resolve/reject pairs. */\n   private readonly pending = new Map<number, PendingCall>();\n\n   /** Partial line buffer for split TCP/IPC frames. */\n   private buffer = '';\n\n   /**\n    * @param socketPath - absolute path to the daemon's IPC socket\n    *   (or Windows named pipe path)\n    * @param contextId - 16-character context identifier sent as\n    *   `ctx` in every JSON-RPC request\n    */\n   constructor(\n      private readonly socketPath: string,\n      private readonly contextId: string,\n   ) {}\n\n   /**\n    * Establishes the IPC connection to the worker daemon.\n    *\n    * @throws {Error} if the connection cannot be established\n    */\n   async connect(): Promise<void> {\n      return new Promise<void>((resolve, reject) => {\n         this.socket = connect(this.socketPath, () => {\n            resolve();\n         });\n         this.socket.on('error', (err: Error) => {\n            reject(err);\n         });\n         this.socket.on('data', (chunk: Buffer) => {\n            this.handleData(chunk.toString());\n         });\n      });\n   }\n\n   /** Destroys the IPC socket and clears the connection state. */\n   disconnect(): void {\n      if (this.socket) {\n         this.socket.destroy();\n         this.socket = null;\n      }\n   }\n\n   /**\n    * Searches the knowledge base.\n    *\n    * @param params - query parameters including the search string\n    * @returns paginated search results with metadata\n    */\n   async search(params: SearchParams): Promise<PagedSearchResult> {\n      return this.call('search', params) as Promise<PagedSearchResult>;\n   }\n\n   /**\n    * Retrieves full content and context for one or more sections by\n    * their knowledge-base identifiers.\n    *\n    * @param params - section identifier(s) and optional expansion depth\n    * @returns a single `RecallResult` when `kbid` is provided without\n    *   `kbids`, or a `RecallResult[]` when `kbids` is provided\n    */\n   async recall(\n      params: RecallParams,\n   ): Promise<RecallResult | RecallResult[]> {\n      return this.call('recall', params) as Promise<\n         RecallResult | RecallResult[]\n      >;\n   }\n\n   /**\n    * Adds a new section to the knowledge base.\n    *\n    * @param params - section content and metadata\n    * @returns the result including the assigned knowledge-base\n    *   identifier and indexing statistics\n    */\n   async addSection(\n      params: AddSectionParams,\n   ): Promise<AddSectionResult> {\n      return this.call(\n         'addSection',\n         params,\n      ) as Promise<AddSectionResult>;\n   }\n\n   /**\n    * Replaces an existing section's content and metadata.\n    *\n    * @param kbid - identifier of the section to update\n    * @param params - new content and metadata\n    * @returns the knowledge-base identifier of the updated section\n    */\n   async updateSection(\n      kbid: string,\n      params: AddSectionParams,\n   ): Promise<string> {\n      return this.call('updateSection', {\n         kbid,\n         ...params,\n      }) as Promise<string>;\n   }\n\n   /**\n    * Removes a section from the knowledge base.\n    *\n    * @param kbid - identifier of the section to remove\n    * @returns removal result with `removed` flag and elapsed time\n    */\n   async removeSection(kbid: string): Promise<RemoveSectionResult> {\n      return this.call('removeSection', {\n         kbid,\n      }) as Promise<RemoveSectionResult>;\n   }\n\n   /**\n    * Retrieves multiple sections by their identifiers.\n    *\n    * @param kbids - list of knowledge-base identifiers to fetch\n    * @returns sections in the order their IDs were requested\n    */\n   async readSections(kbids: string[]): Promise<Section[]> {\n      return this.call('readSections', {\n         kbids,\n      }) as Promise<Section[]>;\n   }\n\n   /**\n    * Groups a set of sections under a named document.\n    *\n    * @param title - human-readable document title\n    * @param kbids - identifiers of the sections to group\n    * @param docType - application-level document type tag; omit or\n    *   pass an empty string for untagged documents\n    * @returns the assigned document identifier\n    */\n   async groupSections(\n      title: string,\n      kbids: string[],\n      docType?: string,\n   ): Promise<string> {\n      const result = (await this.call('groupSections', {\n         title,\n         kbids,\n         docType: docType ?? '',\n      })) as { docid: string } | string;\n      return typeof result === 'string' ? result : result.docid;\n   }\n\n   /**\n    * Removes the document grouping for the given document.\n    *\n    * The sections themselves are not deleted; only the grouping\n    * record is removed.\n    *\n    * @param docid - identifier of the document grouping to remove\n    */\n   async removeGrouping(docid: string): Promise<void> {\n      await this.call('removeGrouping', { docid });\n   }\n\n   /**\n    * Retrieves a full document record including its sections.\n    *\n    * @param docid - identifier of the document to retrieve\n    * @returns the document record as returned by the daemon\n    */\n   async retrieveDocument(docid: string): Promise<unknown> {\n      return this.call('retrieveDocument', { docid });\n   }\n\n   /**\n    * Composes a rendered Markdown document from one or more kbid\n    * or docid identifiers.\n    *\n    * @param ids - list of kbid or docid identifiers (may be mixed)\n    * @returns composed Markdown result with character count\n    */\n   async content(ids: string[]): Promise<ContentResult> {\n      return this.call('content', { ids }) as Promise<ContentResult>;\n   }\n\n   /**\n    * Runs an integrity check on the knowledge-base database.\n    *\n    * @returns a report of all issues found; `ok` is `true` when\n    *   no errors were detected\n    */\n   async integrityCheck(): Promise<IntegrityCheckResult> {\n      return this.call(\n         'integrityCheck',\n         {},\n      ) as Promise<IntegrityCheckResult>;\n   }\n\n   /**\n    * Removes unreferenced sections from the database.\n    *\n    * @returns a report of sections removed and bytes freed\n    */\n   async gc(): Promise<GcResult> {\n      return this.call('gc', {}) as Promise<GcResult>;\n   }\n\n   /**\n    * Reconstructs all index files from section files and document\n    * manifests on disk. Text and code sections are re-tokenized;\n    * image sections are skipped.\n    *\n    * @returns a report of sections and terms re-indexed\n    */\n   async rebuildIndexes(): Promise<RebuildResult> {\n      return this.call('rebuildIndexes', {}) as Promise<RebuildResult>;\n   }\n\n   /**\n    * Invalidates the in-memory cache entry for a single section.\n    *\n    * @param kbid - identifier of the section to evict from cache\n    */\n   async invalidate(kbid: string): Promise<void> {\n      await this.call('invalidate', { kbid });\n   }\n\n   /** Clears all entries from the daemon's in-memory cache. */\n   async invalidateAll(): Promise<void> {\n      await this.call('invalidateAll', {});\n   }\n\n   /**\n    * Retrieves diagnostic status information from the daemon.\n    *\n    * @returns current initialization state and cache statistics\n    */\n   async status(): Promise<StatusResult> {\n      return this.call('status', {}) as Promise<StatusResult>;\n   }\n\n   /**\n    * Returns database metadata and status from the daemon,\n    * including document count, section count, index size, and\n    * cache statistics.\n    *\n    * @returns database metadata from the daemon's cached state\n    */\n   async dbStatus(): Promise<StatusResult> {\n      return this.call('dbStatus', {}) as Promise<StatusResult>;\n   }\n\n   /**\n    * Initialises a new `.kbdb` database directory at the given path\n    * by sending an init request to the worker daemon.\n    *\n    * The daemon creates all required subdirectories and seed files via\n    * the `worker_init_directory` WASM export.\n    *\n    * @param targetPath - absolute path to the directory that will\n    *   contain the new `.kbdb` database\n    * @throws {Error} if the `.kbdb` directory already exists or the\n    *   daemon cannot create the layout\n    */\n   async initDirectory(targetPath: string): Promise<void> {\n      await this.call('initDirectory', { targetPath });\n   }\n\n   /**\n    * Runs all pending database migrations for the `.kbdb` directory\n    * at the given path.\n    *\n    * Delegates to the `worker_migrate` WASM export on the daemon.\n    * Each migration step updates `catalog.toml` on success, so\n    * retrying after a partial failure is safe.\n    *\n    * @param targetPath - absolute path to the `.kbdb` database root\n    * @returns migration report with old version, new version, and\n    *   number of migration steps applied\n    */\n   async migrateDatabase(targetPath: string): Promise<MigrateResult> {\n      return this.call('migrateDatabase', {\n         targetPath,\n      }) as Promise<MigrateResult>;\n   }\n\n   /**\n    * Checks the format version of the `.kbdb` database at the given\n    * path against the version required by the current WASM engine.\n    *\n    * This is a read-only operation: it reads `catalog.toml` and\n    * returns the compatibility status without making any changes.\n    *\n    * @param targetPath - absolute path to the `.kbdb` database root\n    * @returns version compatibility report\n    */\n   async checkVersion(targetPath: string): Promise<VersionStatus> {\n      return this.call('checkVersion', {\n         targetPath,\n      }) as Promise<VersionStatus>;\n   }\n\n   /**\n    * Retrieves all sections whose type name matches the given string.\n    *\n    * @param sectionType - the application-level type name to filter by\n    * @returns all section records with a matching type name\n    */\n   async listByType(sectionType: string): Promise<SectionRecord[]> {\n      return this.call('listByType', {\n         sectionType,\n      }) as Promise<SectionRecord[]>;\n   }\n\n   /**\n    * Retrieves all documents whose type name matches the given string.\n    *\n    * @param docType - the application-level document type to filter by\n    * @returns all document manifests with a matching type name\n    */\n   async listDocumentsByType(\n      docType: string,\n   ): Promise<DocumentManifest[]> {\n      return this.call('listDocumentsByType', {\n         docType,\n      }) as Promise<DocumentManifest[]>;\n   }\n\n   /**\n    * Sends a JSON-RPC 2.0 request and awaits the response.\n    *\n    * @param method - the RPC method name\n    * @param params - parameters to include in the request\n    * @throws {Error} if not connected\n    * @throws {Error} when the daemon returns an error response\n    */\n   private async call(\n      method: string,\n      params: unknown,\n   ): Promise<unknown> {\n      const socket = this.socket;\n      if (!socket) {\n         throw new Error('not connected');\n      }\n\n      const id = this.nextId++;\n      const request = {\n         jsonrpc: '2.0',\n         id,\n         method,\n         params: { ctx: this.contextId, ...(params as object) },\n      };\n\n      return new Promise<unknown>((resolve, reject) => {\n         this.pending.set(id, { resolve, reject });\n         socket.write(JSON.stringify(request) + '\\n');\n      });\n   }\n\n   /**\n    * Processes incoming data from the socket, splitting on newlines\n    * and dispatching complete JSON-RPC response objects.\n    *\n    * @param data - raw string chunk received from the socket\n    */\n   private handleData(data: string): void {\n      this.buffer += data;\n      const lines = this.buffer.split('\\n');\n      this.buffer = lines.pop() ?? '';\n\n      for (const line of lines) {\n         if (!line.trim()) continue;\n         try {\n            const response = JSON.parse(line) as JsonRpcResponse;\n            const pending = this.pending.get(response.id);\n            if (pending) {\n               this.pending.delete(response.id);\n               if (response.error) {\n                  const err = new Error(response.error.message);\n                  (err as unknown as Record<string, unknown>).code =\n                     response.error.code;\n                  pending.reject(err);\n               } else {\n                  pending.resolve(response.result);\n               }\n            }\n         } catch {\n            // Ignore unparseable lines\n         }\n      }\n   }\n}\n", "import { existsSync, readFileSync, unlinkSync } from 'node:fs';\nimport { join } from 'node:path';\nimport { tmpdir } from 'node:os';\nimport { WorkerClient } from '../classes/worker-client.class.ts';\nimport { resolveDbPath } from './resolve-db-path.function.ts';\nimport { computeContextId } from './compute-context-id.function.ts';\nimport { discoverDaemon } from './discover-daemon.function.ts';\nimport { spawnDaemon } from './spawn-daemon.function.ts';\nimport { waitForDaemon } from './wait-for-daemon.function.ts';\nimport { detectRuntime } from '../../runtime/functions/detect-runtime.ts';\nimport { getIpcPath } from '../../platform/functions/get-ipc-path.function.ts';\nimport type { WorkerClientOptions } from '../typings/worker-client-options.interface.ts';\n\n/**\n * Creates and connects a `WorkerClient` to the worker daemon.\n *\n * Resolves the context path, derives a stable context identifier,\n * and checks whether a daemon is already running. If no daemon is\n * found and `autoSpawn` is not `false`, a new daemon process is\n * spawned and the factory waits for its PID file to appear before\n * connecting.\n *\n * @param options - optional configuration for path resolution,\n *   auto-spawn behaviour, and connection timeout\n * @returns a connected `WorkerClient` ready to send requests\n * @throws {Error} if the `.kbdb` directory cannot be found\n * @throws {Error} if the socket connection cannot be established\n */\nexport async function createWorkerClient(\n   options?: WorkerClientOptions,\n): Promise<WorkerClient> {\n   const dbPath =\n      options?.contextPath ?? resolveDbPath(options?.dbPath);\n   const contextId = await computeContextId(dbPath);\n   const socketPath = getIpcPath(contextId);\n\n   let daemon = discoverDaemon(contextId);\n\n   if (!daemon && options?.autoSpawn !== false) {\n      const runtime = detectRuntime();\n      spawnDaemon(dbPath, runtime, options?.workerScript);\n      await waitForDaemon(contextId, options?.connectTimeoutMs);\n      daemon = discoverDaemon(contextId);\n   }\n\n   if (!daemon) {\n      throw new Error(\n         `kbdb worker daemon did not start: ${readCrashReason(contextId)}`,\n      );\n   }\n\n   const client = new WorkerClient(socketPath, contextId);\n   await client.connect();\n   return client;\n}\n\nfunction readCrashReason(contextId: string): string {\n   const crashPath = join(tmpdir(), `kbdb-${contextId}.crash`);\n   if (!existsSync(crashPath)) {\n      return 'daemon failed to start (no details available)';\n   }\n   try {\n      const raw = readFileSync(crashPath, 'utf-8');\n      const crash = JSON.parse(raw) as { error?: string };\n      unlinkSync(crashPath);\n      return crash.error ?? 'unknown error (crash log empty)';\n   } catch {\n      return 'daemon failed to start (crash log unreadable)';\n   }\n}\n", "import { existsSync } from 'node:fs';\nimport { join, resolve } from 'node:path';\n\n/**\n * Resolves the absolute path to the `.kbdb` database directory.\n *\n * Searches for a `.kbdb` sub-directory inside `targetDir`. When\n * `targetDir` is omitted, `process.cwd()` is used as the base.\n *\n * @param targetDir - directory to search in; defaults to cwd\n * @throws {Error} if no `.kbdb` directory exists at the resolved\n *   path\n */\nexport function resolveDbPath(targetDir?: string): string {\n   const base = targetDir ? resolve(targetDir) : process.cwd();\n   const dbPath = join(base, '.kbdb');\n   if (!existsSync(dbPath)) {\n      throw new Error(`database not found: ${dbPath}`);\n   }\n   return dbPath;\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 { computeSha256 } from '../../hash/functions/compute-sha256.ts';\n\n/**\n * Computes a short context identifier for an absolute path.\n *\n * Hashes the path with SHA-256 and returns the first 16 hex\n * characters. The result is stable for the same input and unique\n * enough to avoid accidental collisions across typical path sets.\n *\n * @param absolutePath - the absolute filesystem path to identify\n * @returns a 16-character lowercase hex string\n */\nexport async function computeContextId(\n   absolutePath: string,\n): Promise<string> {\n   const hash = await computeSha256(absolutePath);\n   return hash.slice(0, 16);\n}\n", "import { existsSync, readFileSync, unlinkSync } from 'node:fs';\nimport { join } from 'node:path';\nimport { tmpdir } from 'node:os';\nimport { isProcessAlive } from '../../platform/functions/is-process-alive.function.ts';\nimport type { DaemonInfo } from '../typings/daemon-info.model.ts';\n\nexport type { DaemonInfo };\n\n/**\n * Discovers a running worker daemon for the given context.\n *\n * Reads the PID file at `<tmpdir>/kbdb-<contextId>.pid`. If the\n * file exists and the process is alive, returns its PID and the\n * expected socket path. If the file is stale (process dead or PID\n * unparseable), removes the PID file and returns `null`.\n *\n * @param contextId - the 16-character context identifier\n * @returns daemon location info, or `null` if no live daemon found\n */\nexport function discoverDaemon(contextId: string): DaemonInfo | null {\n   const pidPath = join(tmpdir(), `kbdb-${contextId}.pid`);\n\n   if (!existsSync(pidPath)) return null;\n\n   const pidStr = readFileSync(pidPath, 'utf-8').trim();\n   const pid = parseInt(pidStr, 10);\n\n   if (isNaN(pid) || !isProcessAlive(pid)) {\n      try {\n         unlinkSync(pidPath);\n      } catch {\n         // Stale PID file removal is best-effort\n      }\n      return null;\n   }\n\n   const socketPath = join(tmpdir(), `kbdb-${contextId}.sock`);\n\n   const crashPath = join(tmpdir(), `kbdb-${contextId}.crash`);\n   try {\n      unlinkSync(crashPath);\n   } catch {\n      // stale crash file removal is best-effort\n   }\n\n   return { pid, socketPath };\n}\n", "/**\n * Checks whether a process with the given PID is alive.\n *\n * Sends signal `0` to the process, which performs a permission\n * check without sending an actual signal. Returns `true` if the\n * process exists and is reachable, `false` otherwise.\n *\n * @param pid - the process identifier to probe\n */\nexport function isProcessAlive(pid: number): boolean {\n   try {\n      process.kill(pid, 0);\n      return true;\n   } catch {\n      return false;\n   }\n}\n", "import { spawn } from 'node:child_process';\nimport type { Runtime } from '../../runtime/typings/runtime.ts';\n\n/**\n * Spawns a detached worker daemon process for the given context.\n *\n * @param contextPath - absolute path to the context directory the\n *   daemon should serve\n * @param runtime - the current JavaScript runtime environment\n * @param workerScript - absolute path to the worker daemon script,\n *   resolved at the entry point by `resolveWorkerScript`\n */\nexport function spawnDaemon(\n   contextPath: string,\n   runtime: Runtime,\n   workerScript?: string,\n): void {\n   if (!workerScript) {\n      throw new Error(\n         'workerScript must be provided' + ' (resolve at entry point)',\n      );\n   }\n   const execPath = runtime === 'deno' ? 'deno' : process.execPath;\n\n   const args =\n      runtime === 'deno'\n         ? ['run', '--allow-all', workerScript, contextPath]\n         : [workerScript, contextPath];\n\n   const child = spawn(execPath, args, {\n      detached: true,\n      stdio: 'ignore',\n   });\n   child.unref();\n}\n", "import { existsSync } from 'node:fs';\nimport { join } from 'node:path';\nimport { tmpdir } from 'node:os';\n\n/** Default maximum wait time for the daemon PID file to appear. */\nconst DEFAULT_TIMEOUT_MS = 10_000;\n\n/** Polling interval in milliseconds between existence checks. */\nconst POLL_INTERVAL_MS = 100;\n\n/**\n * Waits for the worker daemon's PID file to appear on disk.\n *\n * Polls every 100 ms until the PID file at\n * `<tmpdir>/kbdb-<contextId>.pid` exists or the timeout elapses.\n *\n * @param contextId - the 16-character context identifier\n * @param timeoutMs - maximum wait time in milliseconds; defaults\n *   to 10 000 ms\n * @returns `true` if the PID file appeared before the timeout,\n *   `false` otherwise\n */\nexport async function waitForDaemon(\n   contextId: string,\n   timeoutMs: number = DEFAULT_TIMEOUT_MS,\n): Promise<boolean> {\n   const pidPath = join(tmpdir(), `kbdb-${contextId}.pid`);\n   const start = Date.now();\n   while (Date.now() - start < timeoutMs) {\n      if (existsSync(pidPath)) return true;\n      await new Promise<void>((r) => setTimeout(r, POLL_INTERVAL_MS));\n   }\n   return false;\n}\n", "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 { 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": ["resolve", "import_node_fs", "import_node_path", "import_node_os", "import_node_fs", "import_node_path", "import_node_fs", "import_node_path", "import_node_os", "import_node_path", "import_node_os"]
 }

package/dist/mod.d.ts

@@ -1,3 +1,28 @@
+/**
+ * @module
+ *
+ * File-based knowledge base database for AI agents.
+ * Provides a programmatic API for indexing documents,
+ * searching with ranked results, and recalling section
+ * context at progressive depths.
+ *
+ * @example
+ * ```ts
+ * 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();
+ * ```
+ */
 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';

package/dist/mod.mjs

@@ -1,5 +1,5 @@
 // src/shared/version/constants/version.constant.ts
-var VERSION = "0.2.0";
+var VERSION = "0.2.2";
 
 // src/shared/worker-client/classes/worker-client.class.ts
 import { connect } from "node:net";

package/dist/mod.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/shared/version/constants/version.constant.ts", "../src/shared/worker-client/classes/worker-client.class.ts", "../src/shared/worker-client/functions/create-worker-client.function.ts", "../src/shared/worker-client/functions/resolve-db-path.function.ts", "../src/shared/hash/functions/compute-sha256.ts", "../src/shared/worker-client/functions/compute-context-id.function.ts", "../src/shared/worker-client/functions/discover-daemon.function.ts", "../src/shared/platform/functions/is-process-alive.function.ts", "../src/shared/worker-client/functions/spawn-daemon.function.ts", "../src/shared/worker-client/functions/wait-for-daemon.function.ts", "../src/shared/runtime/functions/detect-runtime.ts", "../src/shared/platform/functions/get-ipc-path.function.ts", "../src/shared/platform/functions/get-tmpdir.function.ts"],
-  "sourcesContent": ["/** Current package version, kept in sync with package.json. */\nexport const VERSION = '0.2.0';\n", "import { connect } from 'node:net';\nimport type { Socket } from 'node:net';\nimport type { SearchParams } from '../typings/search-params.model.ts';\nimport type { PagedSearchResult } from '../typings/search-result.model.ts';\nimport type {\n   AddSectionParams,\n   Section,\n} from '../typings/section.model.ts';\nimport type { StatusResult } from '../typings/status-result.model.ts';\nimport type { AddSectionResult } from '../typings/add-section-result.model.ts';\nimport type { RemoveSectionResult } from '../typings/remove-section-result.model.ts';\nimport type { ContentResult } from '../typings/content-result.model.ts';\nimport type { IntegrityCheckResult } from '../typings/integrity-check-result.model.ts';\nimport type { GcResult } from '../typings/gc-result.model.ts';\nimport type { RebuildResult } from '../typings/rebuild-result.model.ts';\nimport type { MigrateResult } from '../typings/migrate-result.model.ts';\nimport type { VersionStatus } from '../typings/version-status.model.ts';\nimport type { SectionRecord } from '../../wasm-codec/functions/decode-section-records.function.ts';\nimport type { DocumentManifest } from '../../wasm-codec/functions/decode-document-manifest.function.ts';\nimport type {\n   RecallParams,\n   RecallResult,\n} from '../typings/recall-result.model.ts';\n\n/** Pending JSON-RPC call awaiting a response from the daemon. */\ninterface PendingCall {\n   resolve: (v: unknown) => void;\n   reject: (e: Error) => void;\n}\n\n/** Shape of a JSON-RPC 2.0 error object from the daemon. */\ninterface JsonRpcError {\n   readonly code: number;\n   readonly message: string;\n}\n\n/** Shape of a JSON-RPC 2.0 response from the daemon. */\ninterface JsonRpcResponse {\n   readonly id: number;\n   readonly result?: unknown;\n   readonly error?: JsonRpcError;\n}\n\n/**\n * IPC client that communicates with the worker daemon over a Unix\n * domain socket (or Windows named pipe) using JSON-RPC 2.0 with\n * newline-delimited message framing.\n *\n * Call `connect()` before any other method and `disconnect()` when\n * done to release the underlying socket.\n */\nexport class WorkerClient {\n   /** Underlying socket; `null` when not connected. */\n   private socket: Socket | null = null;\n\n   /** Monotonically increasing request ID counter. */\n   private nextId = 1;\n\n   /** Map of outstanding request IDs to their resolve/reject pairs. */\n   private readonly pending = new Map<number, PendingCall>();\n\n   /** Partial line buffer for split TCP/IPC frames. */\n   private buffer = '';\n\n   /**\n    * @param socketPath - absolute path to the daemon's IPC socket\n    *   (or Windows named pipe path)\n    * @param contextId - 16-character context identifier sent as\n    *   `ctx` in every JSON-RPC request\n    */\n   constructor(\n      private readonly socketPath: string,\n      private readonly contextId: string,\n   ) {}\n\n   /**\n    * Establishes the IPC connection to the worker daemon.\n    *\n    * @throws {Error} if the connection cannot be established\n    */\n   async connect(): Promise<void> {\n      return new Promise<void>((resolve, reject) => {\n         this.socket = connect(this.socketPath, () => {\n            resolve();\n         });\n         this.socket.on('error', (err: Error) => {\n            reject(err);\n         });\n         this.socket.on('data', (chunk: Buffer) => {\n            this.handleData(chunk.toString());\n         });\n      });\n   }\n\n   /** Destroys the IPC socket and clears the connection state. */\n   disconnect(): void {\n      if (this.socket) {\n         this.socket.destroy();\n         this.socket = null;\n      }\n   }\n\n   /**\n    * Searches the knowledge base.\n    *\n    * @param params - query parameters including the search string\n    * @returns paginated search results with metadata\n    */\n   async search(params: SearchParams): Promise<PagedSearchResult> {\n      return this.call('search', params) as Promise<PagedSearchResult>;\n   }\n\n   /**\n    * Retrieves full content and context for one or more sections by\n    * their knowledge-base identifiers.\n    *\n    * @param params - section identifier(s) and optional expansion depth\n    * @returns a single `RecallResult` when `kbid` is provided without\n    *   `kbids`, or a `RecallResult[]` when `kbids` is provided\n    */\n   async recall(\n      params: RecallParams,\n   ): Promise<RecallResult | RecallResult[]> {\n      return this.call('recall', params) as Promise<\n         RecallResult | RecallResult[]\n      >;\n   }\n\n   /**\n    * Adds a new section to the knowledge base.\n    *\n    * @param params - section content and metadata\n    * @returns the result including the assigned knowledge-base\n    *   identifier and indexing statistics\n    */\n   async addSection(\n      params: AddSectionParams,\n   ): Promise<AddSectionResult> {\n      return this.call(\n         'addSection',\n         params,\n      ) as Promise<AddSectionResult>;\n   }\n\n   /**\n    * Replaces an existing section's content and metadata.\n    *\n    * @param kbid - identifier of the section to update\n    * @param params - new content and metadata\n    * @returns the knowledge-base identifier of the updated section\n    */\n   async updateSection(\n      kbid: string,\n      params: AddSectionParams,\n   ): Promise<string> {\n      return this.call('updateSection', {\n         kbid,\n         ...params,\n      }) as Promise<string>;\n   }\n\n   /**\n    * Removes a section from the knowledge base.\n    *\n    * @param kbid - identifier of the section to remove\n    * @returns removal result with `removed` flag and elapsed time\n    */\n   async removeSection(kbid: string): Promise<RemoveSectionResult> {\n      return this.call('removeSection', {\n         kbid,\n      }) as Promise<RemoveSectionResult>;\n   }\n\n   /**\n    * Retrieves multiple sections by their identifiers.\n    *\n    * @param kbids - list of knowledge-base identifiers to fetch\n    * @returns sections in the order their IDs were requested\n    */\n   async readSections(kbids: string[]): Promise<Section[]> {\n      return this.call('readSections', {\n         kbids,\n      }) as Promise<Section[]>;\n   }\n\n   /**\n    * Groups a set of sections under a named document.\n    *\n    * @param title - human-readable document title\n    * @param kbids - identifiers of the sections to group\n    * @param docType - application-level document type tag; omit or\n    *   pass an empty string for untagged documents\n    * @returns the assigned document identifier\n    */\n   async groupSections(\n      title: string,\n      kbids: string[],\n      docType?: string,\n   ): Promise<string> {\n      const result = (await this.call('groupSections', {\n         title,\n         kbids,\n         docType: docType ?? '',\n      })) as { docid: string } | string;\n      return typeof result === 'string' ? result : result.docid;\n   }\n\n   /**\n    * Removes the document grouping for the given document.\n    *\n    * The sections themselves are not deleted; only the grouping\n    * record is removed.\n    *\n    * @param docid - identifier of the document grouping to remove\n    */\n   async removeGrouping(docid: string): Promise<void> {\n      await this.call('removeGrouping', { docid });\n   }\n\n   /**\n    * Retrieves a full document record including its sections.\n    *\n    * @param docid - identifier of the document to retrieve\n    * @returns the document record as returned by the daemon\n    */\n   async retrieveDocument(docid: string): Promise<unknown> {\n      return this.call('retrieveDocument', { docid });\n   }\n\n   /**\n    * Composes a rendered Markdown document from one or more kbid\n    * or docid identifiers.\n    *\n    * @param ids - list of kbid or docid identifiers (may be mixed)\n    * @returns composed Markdown result with character count\n    */\n   async content(ids: string[]): Promise<ContentResult> {\n      return this.call('content', { ids }) as Promise<ContentResult>;\n   }\n\n   /**\n    * Runs an integrity check on the knowledge-base database.\n    *\n    * @returns a report of all issues found; `ok` is `true` when\n    *   no errors were detected\n    */\n   async integrityCheck(): Promise<IntegrityCheckResult> {\n      return this.call(\n         'integrityCheck',\n         {},\n      ) as Promise<IntegrityCheckResult>;\n   }\n\n   /**\n    * Removes unreferenced sections from the database.\n    *\n    * @returns a report of sections removed and bytes freed\n    */\n   async gc(): Promise<GcResult> {\n      return this.call('gc', {}) as Promise<GcResult>;\n   }\n\n   /**\n    * Reconstructs all index files from section files and document\n    * manifests on disk. Text and code sections are re-tokenized;\n    * image sections are skipped.\n    *\n    * @returns a report of sections and terms re-indexed\n    */\n   async rebuildIndexes(): Promise<RebuildResult> {\n      return this.call('rebuildIndexes', {}) as Promise<RebuildResult>;\n   }\n\n   /**\n    * Invalidates the in-memory cache entry for a single section.\n    *\n    * @param kbid - identifier of the section to evict from cache\n    */\n   async invalidate(kbid: string): Promise<void> {\n      await this.call('invalidate', { kbid });\n   }\n\n   /** Clears all entries from the daemon's in-memory cache. */\n   async invalidateAll(): Promise<void> {\n      await this.call('invalidateAll', {});\n   }\n\n   /**\n    * Retrieves diagnostic status information from the daemon.\n    *\n    * @returns current initialization state and cache statistics\n    */\n   async status(): Promise<StatusResult> {\n      return this.call('status', {}) as Promise<StatusResult>;\n   }\n\n   /**\n    * Returns database metadata and status from the daemon,\n    * including document count, section count, index size, and\n    * cache statistics.\n    *\n    * @returns database metadata from the daemon's cached state\n    */\n   async dbStatus(): Promise<StatusResult> {\n      return this.call('dbStatus', {}) as Promise<StatusResult>;\n   }\n\n   /**\n    * Initialises a new `.kbdb` database directory at the given path\n    * by sending an init request to the worker daemon.\n    *\n    * The daemon creates all required subdirectories and seed files via\n    * the `worker_init_directory` WASM export.\n    *\n    * @param targetPath - absolute path to the directory that will\n    *   contain the new `.kbdb` database\n    * @throws {Error} if the `.kbdb` directory already exists or the\n    *   daemon cannot create the layout\n    */\n   async initDirectory(targetPath: string): Promise<void> {\n      await this.call('initDirectory', { targetPath });\n   }\n\n   /**\n    * Runs all pending database migrations for the `.kbdb` directory\n    * at the given path.\n    *\n    * Delegates to the `worker_migrate` WASM export on the daemon.\n    * Each migration step updates `catalog.toml` on success, so\n    * retrying after a partial failure is safe.\n    *\n    * @param targetPath - absolute path to the `.kbdb` database root\n    * @returns migration report with old version, new version, and\n    *   number of migration steps applied\n    */\n   async migrateDatabase(targetPath: string): Promise<MigrateResult> {\n      return this.call('migrateDatabase', {\n         targetPath,\n      }) as Promise<MigrateResult>;\n   }\n\n   /**\n    * Checks the format version of the `.kbdb` database at the given\n    * path against the version required by the current WASM engine.\n    *\n    * This is a read-only operation: it reads `catalog.toml` and\n    * returns the compatibility status without making any changes.\n    *\n    * @param targetPath - absolute path to the `.kbdb` database root\n    * @returns version compatibility report\n    */\n   async checkVersion(targetPath: string): Promise<VersionStatus> {\n      return this.call('checkVersion', {\n         targetPath,\n      }) as Promise<VersionStatus>;\n   }\n\n   /**\n    * Retrieves all sections whose type name matches the given string.\n    *\n    * @param sectionType - the application-level type name to filter by\n    * @returns all section records with a matching type name\n    */\n   async listByType(sectionType: string): Promise<SectionRecord[]> {\n      return this.call('listByType', {\n         sectionType,\n      }) as Promise<SectionRecord[]>;\n   }\n\n   /**\n    * Retrieves all documents whose type name matches the given string.\n    *\n    * @param docType - the application-level document type to filter by\n    * @returns all document manifests with a matching type name\n    */\n   async listDocumentsByType(\n      docType: string,\n   ): Promise<DocumentManifest[]> {\n      return this.call('listDocumentsByType', {\n         docType,\n      }) as Promise<DocumentManifest[]>;\n   }\n\n   /**\n    * Sends a JSON-RPC 2.0 request and awaits the response.\n    *\n    * @param method - the RPC method name\n    * @param params - parameters to include in the request\n    * @throws {Error} if not connected\n    * @throws {Error} when the daemon returns an error response\n    */\n   private async call(\n      method: string,\n      params: unknown,\n   ): Promise<unknown> {\n      const socket = this.socket;\n      if (!socket) {\n         throw new Error('not connected');\n      }\n\n      const id = this.nextId++;\n      const request = {\n         jsonrpc: '2.0',\n         id,\n         method,\n         params: { ctx: this.contextId, ...(params as object) },\n      };\n\n      return new Promise<unknown>((resolve, reject) => {\n         this.pending.set(id, { resolve, reject });\n         socket.write(JSON.stringify(request) + '\\n');\n      });\n   }\n\n   /**\n    * Processes incoming data from the socket, splitting on newlines\n    * and dispatching complete JSON-RPC response objects.\n    *\n    * @param data - raw string chunk received from the socket\n    */\n   private handleData(data: string): void {\n      this.buffer += data;\n      const lines = this.buffer.split('\\n');\n      this.buffer = lines.pop() ?? '';\n\n      for (const line of lines) {\n         if (!line.trim()) continue;\n         try {\n            const response = JSON.parse(line) as JsonRpcResponse;\n            const pending = this.pending.get(response.id);\n            if (pending) {\n               this.pending.delete(response.id);\n               if (response.error) {\n                  const err = new Error(response.error.message);\n                  (err as unknown as Record<string, unknown>).code =\n                     response.error.code;\n                  pending.reject(err);\n               } else {\n                  pending.resolve(response.result);\n               }\n            }\n         } catch {\n            // Ignore unparseable lines\n         }\n      }\n   }\n}\n", "import { existsSync, readFileSync, unlinkSync } from 'node:fs';\nimport { join } from 'node:path';\nimport { tmpdir } from 'node:os';\nimport { WorkerClient } from '../classes/worker-client.class.ts';\nimport { resolveDbPath } from './resolve-db-path.function.ts';\nimport { computeContextId } from './compute-context-id.function.ts';\nimport { discoverDaemon } from './discover-daemon.function.ts';\nimport { spawnDaemon } from './spawn-daemon.function.ts';\nimport { waitForDaemon } from './wait-for-daemon.function.ts';\nimport { detectRuntime } from '../../runtime/functions/detect-runtime.ts';\nimport { getIpcPath } from '../../platform/functions/get-ipc-path.function.ts';\nimport type { WorkerClientOptions } from '../typings/worker-client-options.interface.ts';\n\n/**\n * Creates and connects a `WorkerClient` to the worker daemon.\n *\n * Resolves the context path, derives a stable context identifier,\n * and checks whether a daemon is already running. If no daemon is\n * found and `autoSpawn` is not `false`, a new daemon process is\n * spawned and the factory waits for its PID file to appear before\n * connecting.\n *\n * @param options - optional configuration for path resolution,\n *   auto-spawn behaviour, and connection timeout\n * @returns a connected `WorkerClient` ready to send requests\n * @throws {Error} if the `.kbdb` directory cannot be found\n * @throws {Error} if the socket connection cannot be established\n */\nexport async function createWorkerClient(\n   options?: WorkerClientOptions,\n): Promise<WorkerClient> {\n   const dbPath =\n      options?.contextPath ?? resolveDbPath(options?.dbPath);\n   const contextId = await computeContextId(dbPath);\n   const socketPath = getIpcPath(contextId);\n\n   let daemon = discoverDaemon(contextId);\n\n   if (!daemon && options?.autoSpawn !== false) {\n      const runtime = detectRuntime();\n      spawnDaemon(dbPath, runtime, options?.workerScript);\n      await waitForDaemon(contextId, options?.connectTimeoutMs);\n      daemon = discoverDaemon(contextId);\n   }\n\n   if (!daemon) {\n      throw new Error(\n         `kbdb worker daemon did not start: ${readCrashReason(contextId)}`,\n      );\n   }\n\n   const client = new WorkerClient(socketPath, contextId);\n   await client.connect();\n   return client;\n}\n\nfunction readCrashReason(contextId: string): string {\n   const crashPath = join(tmpdir(), `kbdb-${contextId}.crash`);\n   if (!existsSync(crashPath)) {\n      return 'daemon failed to start (no details available)';\n   }\n   try {\n      const raw = readFileSync(crashPath, 'utf-8');\n      const crash = JSON.parse(raw) as { error?: string };\n      unlinkSync(crashPath);\n      return crash.error ?? 'unknown error (crash log empty)';\n   } catch {\n      return 'daemon failed to start (crash log unreadable)';\n   }\n}\n", "import { existsSync } from 'node:fs';\nimport { join, resolve } from 'node:path';\n\n/**\n * Resolves the absolute path to the `.kbdb` database directory.\n *\n * Searches for a `.kbdb` sub-directory inside `targetDir`. When\n * `targetDir` is omitted, `process.cwd()` is used as the base.\n *\n * @param targetDir - directory to search in; defaults to cwd\n * @throws {Error} if no `.kbdb` directory exists at the resolved\n *   path\n */\nexport function resolveDbPath(targetDir?: string): string {\n   const base = targetDir ? resolve(targetDir) : process.cwd();\n   const dbPath = join(base, '.kbdb');\n   if (!existsSync(dbPath)) {\n      throw new Error(`database not found: ${dbPath}`);\n   }\n   return dbPath;\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 { computeSha256 } from '../../hash/functions/compute-sha256.ts';\n\n/**\n * Computes a short context identifier for an absolute path.\n *\n * Hashes the path with SHA-256 and returns the first 16 hex\n * characters. The result is stable for the same input and unique\n * enough to avoid accidental collisions across typical path sets.\n *\n * @param absolutePath - the absolute filesystem path to identify\n * @returns a 16-character lowercase hex string\n */\nexport async function computeContextId(\n   absolutePath: string,\n): Promise<string> {\n   const hash = await computeSha256(absolutePath);\n   return hash.slice(0, 16);\n}\n", "import { existsSync, readFileSync, unlinkSync } from 'node:fs';\nimport { join } from 'node:path';\nimport { tmpdir } from 'node:os';\nimport { isProcessAlive } from '../../platform/functions/is-process-alive.function.ts';\nimport type { DaemonInfo } from '../typings/daemon-info.model.ts';\n\nexport type { DaemonInfo };\n\n/**\n * Discovers a running worker daemon for the given context.\n *\n * Reads the PID file at `<tmpdir>/kbdb-<contextId>.pid`. If the\n * file exists and the process is alive, returns its PID and the\n * expected socket path. If the file is stale (process dead or PID\n * unparseable), removes the PID file and returns `null`.\n *\n * @param contextId - the 16-character context identifier\n * @returns daemon location info, or `null` if no live daemon found\n */\nexport function discoverDaemon(contextId: string): DaemonInfo | null {\n   const pidPath = join(tmpdir(), `kbdb-${contextId}.pid`);\n\n   if (!existsSync(pidPath)) return null;\n\n   const pidStr = readFileSync(pidPath, 'utf-8').trim();\n   const pid = parseInt(pidStr, 10);\n\n   if (isNaN(pid) || !isProcessAlive(pid)) {\n      try {\n         unlinkSync(pidPath);\n      } catch {\n         // Stale PID file removal is best-effort\n      }\n      return null;\n   }\n\n   const socketPath = join(tmpdir(), `kbdb-${contextId}.sock`);\n\n   const crashPath = join(tmpdir(), `kbdb-${contextId}.crash`);\n   try {\n      unlinkSync(crashPath);\n   } catch {\n      // stale crash file removal is best-effort\n   }\n\n   return { pid, socketPath };\n}\n", "/**\n * Checks whether a process with the given PID is alive.\n *\n * Sends signal `0` to the process, which performs a permission\n * check without sending an actual signal. Returns `true` if the\n * process exists and is reachable, `false` otherwise.\n *\n * @param pid - the process identifier to probe\n */\nexport function isProcessAlive(pid: number): boolean {\n   try {\n      process.kill(pid, 0);\n      return true;\n   } catch {\n      return false;\n   }\n}\n", "import { spawn } from 'node:child_process';\nimport type { Runtime } from '../../runtime/typings/runtime.ts';\n\n/**\n * Spawns a detached worker daemon process for the given context.\n *\n * @param contextPath - absolute path to the context directory the\n *   daemon should serve\n * @param runtime - the current JavaScript runtime environment\n * @param workerScript - absolute path to the worker daemon script,\n *   resolved at the entry point by `resolveWorkerScript`\n */\nexport function spawnDaemon(\n   contextPath: string,\n   runtime: Runtime,\n   workerScript?: string,\n): void {\n   if (!workerScript) {\n      throw new Error(\n         'workerScript must be provided' + ' (resolve at entry point)',\n      );\n   }\n   const execPath = runtime === 'deno' ? 'deno' : process.execPath;\n\n   const args =\n      runtime === 'deno'\n         ? ['run', '--allow-all', workerScript, contextPath]\n         : [workerScript, contextPath];\n\n   const child = spawn(execPath, args, {\n      detached: true,\n      stdio: 'ignore',\n   });\n   child.unref();\n}\n", "import { existsSync } from 'node:fs';\nimport { join } from 'node:path';\nimport { tmpdir } from 'node:os';\n\n/** Default maximum wait time for the daemon PID file to appear. */\nconst DEFAULT_TIMEOUT_MS = 10_000;\n\n/** Polling interval in milliseconds between existence checks. */\nconst POLL_INTERVAL_MS = 100;\n\n/**\n * Waits for the worker daemon's PID file to appear on disk.\n *\n * Polls every 100 ms until the PID file at\n * `<tmpdir>/kbdb-<contextId>.pid` exists or the timeout elapses.\n *\n * @param contextId - the 16-character context identifier\n * @param timeoutMs - maximum wait time in milliseconds; defaults\n *   to 10 000 ms\n * @returns `true` if the PID file appeared before the timeout,\n *   `false` otherwise\n */\nexport async function waitForDaemon(\n   contextId: string,\n   timeoutMs: number = DEFAULT_TIMEOUT_MS,\n): Promise<boolean> {\n   const pidPath = join(tmpdir(), `kbdb-${contextId}.pid`);\n   const start = Date.now();\n   while (Date.now() - start < timeoutMs) {\n      if (existsSync(pidPath)) return true;\n      await new Promise<void>((r) => setTimeout(r, POLL_INTERVAL_MS));\n   }\n   return false;\n}\n", "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 { 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"],
+  "sourcesContent": ["/** Current package version, kept in sync with package.json. */\nexport const VERSION = '0.2.2';\n", "import { connect } from 'node:net';\nimport type { Socket } from 'node:net';\nimport type { SearchParams } from '../typings/search-params.model.ts';\nimport type { PagedSearchResult } from '../typings/search-result.model.ts';\nimport type {\n   AddSectionParams,\n   Section,\n} from '../typings/section.model.ts';\nimport type { StatusResult } from '../typings/status-result.model.ts';\nimport type { AddSectionResult } from '../typings/add-section-result.model.ts';\nimport type { RemoveSectionResult } from '../typings/remove-section-result.model.ts';\nimport type { ContentResult } from '../typings/content-result.model.ts';\nimport type { IntegrityCheckResult } from '../typings/integrity-check-result.model.ts';\nimport type { GcResult } from '../typings/gc-result.model.ts';\nimport type { RebuildResult } from '../typings/rebuild-result.model.ts';\nimport type { MigrateResult } from '../typings/migrate-result.model.ts';\nimport type { VersionStatus } from '../typings/version-status.model.ts';\nimport type { SectionRecord } from '../../wasm-codec/functions/decode-section-records.function.ts';\nimport type { DocumentManifest } from '../../wasm-codec/functions/decode-document-manifest.function.ts';\nimport type {\n   RecallParams,\n   RecallResult,\n} from '../typings/recall-result.model.ts';\n\n/** Pending JSON-RPC call awaiting a response from the daemon. */\ninterface PendingCall {\n   resolve: (v: unknown) => void;\n   reject: (e: Error) => void;\n}\n\n/** Shape of a JSON-RPC 2.0 error object from the daemon. */\ninterface JsonRpcError {\n   readonly code: number;\n   readonly message: string;\n}\n\n/** Shape of a JSON-RPC 2.0 response from the daemon. */\ninterface JsonRpcResponse {\n   readonly id: number;\n   readonly result?: unknown;\n   readonly error?: JsonRpcError;\n}\n\n/**\n * IPC client that communicates with the worker daemon over a Unix\n * domain socket (or Windows named pipe) using JSON-RPC 2.0 with\n * newline-delimited message framing.\n *\n * Call `connect()` before any other method and `disconnect()` when\n * done to release the underlying socket.\n */\nexport class WorkerClient {\n   /** Underlying socket; `null` when not connected. */\n   private socket: Socket | null = null;\n\n   /** Monotonically increasing request ID counter. */\n   private nextId = 1;\n\n   /** Map of outstanding request IDs to their resolve/reject pairs. */\n   private readonly pending = new Map<number, PendingCall>();\n\n   /** Partial line buffer for split TCP/IPC frames. */\n   private buffer = '';\n\n   /**\n    * @param socketPath - absolute path to the daemon's IPC socket\n    *   (or Windows named pipe path)\n    * @param contextId - 16-character context identifier sent as\n    *   `ctx` in every JSON-RPC request\n    */\n   constructor(\n      private readonly socketPath: string,\n      private readonly contextId: string,\n   ) {}\n\n   /**\n    * Establishes the IPC connection to the worker daemon.\n    *\n    * @throws {Error} if the connection cannot be established\n    */\n   async connect(): Promise<void> {\n      return new Promise<void>((resolve, reject) => {\n         this.socket = connect(this.socketPath, () => {\n            resolve();\n         });\n         this.socket.on('error', (err: Error) => {\n            reject(err);\n         });\n         this.socket.on('data', (chunk: Buffer) => {\n            this.handleData(chunk.toString());\n         });\n      });\n   }\n\n   /** Destroys the IPC socket and clears the connection state. */\n   disconnect(): void {\n      if (this.socket) {\n         this.socket.destroy();\n         this.socket = null;\n      }\n   }\n\n   /**\n    * Searches the knowledge base.\n    *\n    * @param params - query parameters including the search string\n    * @returns paginated search results with metadata\n    */\n   async search(params: SearchParams): Promise<PagedSearchResult> {\n      return this.call('search', params) as Promise<PagedSearchResult>;\n   }\n\n   /**\n    * Retrieves full content and context for one or more sections by\n    * their knowledge-base identifiers.\n    *\n    * @param params - section identifier(s) and optional expansion depth\n    * @returns a single `RecallResult` when `kbid` is provided without\n    *   `kbids`, or a `RecallResult[]` when `kbids` is provided\n    */\n   async recall(\n      params: RecallParams,\n   ): Promise<RecallResult | RecallResult[]> {\n      return this.call('recall', params) as Promise<\n         RecallResult | RecallResult[]\n      >;\n   }\n\n   /**\n    * Adds a new section to the knowledge base.\n    *\n    * @param params - section content and metadata\n    * @returns the result including the assigned knowledge-base\n    *   identifier and indexing statistics\n    */\n   async addSection(\n      params: AddSectionParams,\n   ): Promise<AddSectionResult> {\n      return this.call(\n         'addSection',\n         params,\n      ) as Promise<AddSectionResult>;\n   }\n\n   /**\n    * Replaces an existing section's content and metadata.\n    *\n    * @param kbid - identifier of the section to update\n    * @param params - new content and metadata\n    * @returns the knowledge-base identifier of the updated section\n    */\n   async updateSection(\n      kbid: string,\n      params: AddSectionParams,\n   ): Promise<string> {\n      return this.call('updateSection', {\n         kbid,\n         ...params,\n      }) as Promise<string>;\n   }\n\n   /**\n    * Removes a section from the knowledge base.\n    *\n    * @param kbid - identifier of the section to remove\n    * @returns removal result with `removed` flag and elapsed time\n    */\n   async removeSection(kbid: string): Promise<RemoveSectionResult> {\n      return this.call('removeSection', {\n         kbid,\n      }) as Promise<RemoveSectionResult>;\n   }\n\n   /**\n    * Retrieves multiple sections by their identifiers.\n    *\n    * @param kbids - list of knowledge-base identifiers to fetch\n    * @returns sections in the order their IDs were requested\n    */\n   async readSections(kbids: string[]): Promise<Section[]> {\n      return this.call('readSections', {\n         kbids,\n      }) as Promise<Section[]>;\n   }\n\n   /**\n    * Groups a set of sections under a named document.\n    *\n    * @param title - human-readable document title\n    * @param kbids - identifiers of the sections to group\n    * @param docType - application-level document type tag; omit or\n    *   pass an empty string for untagged documents\n    * @returns the assigned document identifier\n    */\n   async groupSections(\n      title: string,\n      kbids: string[],\n      docType?: string,\n   ): Promise<string> {\n      const result = (await this.call('groupSections', {\n         title,\n         kbids,\n         docType: docType ?? '',\n      })) as { docid: string } | string;\n      return typeof result === 'string' ? result : result.docid;\n   }\n\n   /**\n    * Removes the document grouping for the given document.\n    *\n    * The sections themselves are not deleted; only the grouping\n    * record is removed.\n    *\n    * @param docid - identifier of the document grouping to remove\n    */\n   async removeGrouping(docid: string): Promise<void> {\n      await this.call('removeGrouping', { docid });\n   }\n\n   /**\n    * Retrieves a full document record including its sections.\n    *\n    * @param docid - identifier of the document to retrieve\n    * @returns the document record as returned by the daemon\n    */\n   async retrieveDocument(docid: string): Promise<unknown> {\n      return this.call('retrieveDocument', { docid });\n   }\n\n   /**\n    * Composes a rendered Markdown document from one or more kbid\n    * or docid identifiers.\n    *\n    * @param ids - list of kbid or docid identifiers (may be mixed)\n    * @returns composed Markdown result with character count\n    */\n   async content(ids: string[]): Promise<ContentResult> {\n      return this.call('content', { ids }) as Promise<ContentResult>;\n   }\n\n   /**\n    * Runs an integrity check on the knowledge-base database.\n    *\n    * @returns a report of all issues found; `ok` is `true` when\n    *   no errors were detected\n    */\n   async integrityCheck(): Promise<IntegrityCheckResult> {\n      return this.call(\n         'integrityCheck',\n         {},\n      ) as Promise<IntegrityCheckResult>;\n   }\n\n   /**\n    * Removes unreferenced sections from the database.\n    *\n    * @returns a report of sections removed and bytes freed\n    */\n   async gc(): Promise<GcResult> {\n      return this.call('gc', {}) as Promise<GcResult>;\n   }\n\n   /**\n    * Reconstructs all index files from section files and document\n    * manifests on disk. Text and code sections are re-tokenized;\n    * image sections are skipped.\n    *\n    * @returns a report of sections and terms re-indexed\n    */\n   async rebuildIndexes(): Promise<RebuildResult> {\n      return this.call('rebuildIndexes', {}) as Promise<RebuildResult>;\n   }\n\n   /**\n    * Invalidates the in-memory cache entry for a single section.\n    *\n    * @param kbid - identifier of the section to evict from cache\n    */\n   async invalidate(kbid: string): Promise<void> {\n      await this.call('invalidate', { kbid });\n   }\n\n   /** Clears all entries from the daemon's in-memory cache. */\n   async invalidateAll(): Promise<void> {\n      await this.call('invalidateAll', {});\n   }\n\n   /**\n    * Retrieves diagnostic status information from the daemon.\n    *\n    * @returns current initialization state and cache statistics\n    */\n   async status(): Promise<StatusResult> {\n      return this.call('status', {}) as Promise<StatusResult>;\n   }\n\n   /**\n    * Returns database metadata and status from the daemon,\n    * including document count, section count, index size, and\n    * cache statistics.\n    *\n    * @returns database metadata from the daemon's cached state\n    */\n   async dbStatus(): Promise<StatusResult> {\n      return this.call('dbStatus', {}) as Promise<StatusResult>;\n   }\n\n   /**\n    * Initialises a new `.kbdb` database directory at the given path\n    * by sending an init request to the worker daemon.\n    *\n    * The daemon creates all required subdirectories and seed files via\n    * the `worker_init_directory` WASM export.\n    *\n    * @param targetPath - absolute path to the directory that will\n    *   contain the new `.kbdb` database\n    * @throws {Error} if the `.kbdb` directory already exists or the\n    *   daemon cannot create the layout\n    */\n   async initDirectory(targetPath: string): Promise<void> {\n      await this.call('initDirectory', { targetPath });\n   }\n\n   /**\n    * Runs all pending database migrations for the `.kbdb` directory\n    * at the given path.\n    *\n    * Delegates to the `worker_migrate` WASM export on the daemon.\n    * Each migration step updates `catalog.toml` on success, so\n    * retrying after a partial failure is safe.\n    *\n    * @param targetPath - absolute path to the `.kbdb` database root\n    * @returns migration report with old version, new version, and\n    *   number of migration steps applied\n    */\n   async migrateDatabase(targetPath: string): Promise<MigrateResult> {\n      return this.call('migrateDatabase', {\n         targetPath,\n      }) as Promise<MigrateResult>;\n   }\n\n   /**\n    * Checks the format version of the `.kbdb` database at the given\n    * path against the version required by the current WASM engine.\n    *\n    * This is a read-only operation: it reads `catalog.toml` and\n    * returns the compatibility status without making any changes.\n    *\n    * @param targetPath - absolute path to the `.kbdb` database root\n    * @returns version compatibility report\n    */\n   async checkVersion(targetPath: string): Promise<VersionStatus> {\n      return this.call('checkVersion', {\n         targetPath,\n      }) as Promise<VersionStatus>;\n   }\n\n   /**\n    * Retrieves all sections whose type name matches the given string.\n    *\n    * @param sectionType - the application-level type name to filter by\n    * @returns all section records with a matching type name\n    */\n   async listByType(sectionType: string): Promise<SectionRecord[]> {\n      return this.call('listByType', {\n         sectionType,\n      }) as Promise<SectionRecord[]>;\n   }\n\n   /**\n    * Retrieves all documents whose type name matches the given string.\n    *\n    * @param docType - the application-level document type to filter by\n    * @returns all document manifests with a matching type name\n    */\n   async listDocumentsByType(\n      docType: string,\n   ): Promise<DocumentManifest[]> {\n      return this.call('listDocumentsByType', {\n         docType,\n      }) as Promise<DocumentManifest[]>;\n   }\n\n   /**\n    * Sends a JSON-RPC 2.0 request and awaits the response.\n    *\n    * @param method - the RPC method name\n    * @param params - parameters to include in the request\n    * @throws {Error} if not connected\n    * @throws {Error} when the daemon returns an error response\n    */\n   private async call(\n      method: string,\n      params: unknown,\n   ): Promise<unknown> {\n      const socket = this.socket;\n      if (!socket) {\n         throw new Error('not connected');\n      }\n\n      const id = this.nextId++;\n      const request = {\n         jsonrpc: '2.0',\n         id,\n         method,\n         params: { ctx: this.contextId, ...(params as object) },\n      };\n\n      return new Promise<unknown>((resolve, reject) => {\n         this.pending.set(id, { resolve, reject });\n         socket.write(JSON.stringify(request) + '\\n');\n      });\n   }\n\n   /**\n    * Processes incoming data from the socket, splitting on newlines\n    * and dispatching complete JSON-RPC response objects.\n    *\n    * @param data - raw string chunk received from the socket\n    */\n   private handleData(data: string): void {\n      this.buffer += data;\n      const lines = this.buffer.split('\\n');\n      this.buffer = lines.pop() ?? '';\n\n      for (const line of lines) {\n         if (!line.trim()) continue;\n         try {\n            const response = JSON.parse(line) as JsonRpcResponse;\n            const pending = this.pending.get(response.id);\n            if (pending) {\n               this.pending.delete(response.id);\n               if (response.error) {\n                  const err = new Error(response.error.message);\n                  (err as unknown as Record<string, unknown>).code =\n                     response.error.code;\n                  pending.reject(err);\n               } else {\n                  pending.resolve(response.result);\n               }\n            }\n         } catch {\n            // Ignore unparseable lines\n         }\n      }\n   }\n}\n", "import { existsSync, readFileSync, unlinkSync } from 'node:fs';\nimport { join } from 'node:path';\nimport { tmpdir } from 'node:os';\nimport { WorkerClient } from '../classes/worker-client.class.ts';\nimport { resolveDbPath } from './resolve-db-path.function.ts';\nimport { computeContextId } from './compute-context-id.function.ts';\nimport { discoverDaemon } from './discover-daemon.function.ts';\nimport { spawnDaemon } from './spawn-daemon.function.ts';\nimport { waitForDaemon } from './wait-for-daemon.function.ts';\nimport { detectRuntime } from '../../runtime/functions/detect-runtime.ts';\nimport { getIpcPath } from '../../platform/functions/get-ipc-path.function.ts';\nimport type { WorkerClientOptions } from '../typings/worker-client-options.interface.ts';\n\n/**\n * Creates and connects a `WorkerClient` to the worker daemon.\n *\n * Resolves the context path, derives a stable context identifier,\n * and checks whether a daemon is already running. If no daemon is\n * found and `autoSpawn` is not `false`, a new daemon process is\n * spawned and the factory waits for its PID file to appear before\n * connecting.\n *\n * @param options - optional configuration for path resolution,\n *   auto-spawn behaviour, and connection timeout\n * @returns a connected `WorkerClient` ready to send requests\n * @throws {Error} if the `.kbdb` directory cannot be found\n * @throws {Error} if the socket connection cannot be established\n */\nexport async function createWorkerClient(\n   options?: WorkerClientOptions,\n): Promise<WorkerClient> {\n   const dbPath =\n      options?.contextPath ?? resolveDbPath(options?.dbPath);\n   const contextId = await computeContextId(dbPath);\n   const socketPath = getIpcPath(contextId);\n\n   let daemon = discoverDaemon(contextId);\n\n   if (!daemon && options?.autoSpawn !== false) {\n      const runtime = detectRuntime();\n      spawnDaemon(dbPath, runtime, options?.workerScript);\n      await waitForDaemon(contextId, options?.connectTimeoutMs);\n      daemon = discoverDaemon(contextId);\n   }\n\n   if (!daemon) {\n      throw new Error(\n         `kbdb worker daemon did not start: ${readCrashReason(contextId)}`,\n      );\n   }\n\n   const client = new WorkerClient(socketPath, contextId);\n   await client.connect();\n   return client;\n}\n\nfunction readCrashReason(contextId: string): string {\n   const crashPath = join(tmpdir(), `kbdb-${contextId}.crash`);\n   if (!existsSync(crashPath)) {\n      return 'daemon failed to start (no details available)';\n   }\n   try {\n      const raw = readFileSync(crashPath, 'utf-8');\n      const crash = JSON.parse(raw) as { error?: string };\n      unlinkSync(crashPath);\n      return crash.error ?? 'unknown error (crash log empty)';\n   } catch {\n      return 'daemon failed to start (crash log unreadable)';\n   }\n}\n", "import { existsSync } from 'node:fs';\nimport { join, resolve } from 'node:path';\n\n/**\n * Resolves the absolute path to the `.kbdb` database directory.\n *\n * Searches for a `.kbdb` sub-directory inside `targetDir`. When\n * `targetDir` is omitted, `process.cwd()` is used as the base.\n *\n * @param targetDir - directory to search in; defaults to cwd\n * @throws {Error} if no `.kbdb` directory exists at the resolved\n *   path\n */\nexport function resolveDbPath(targetDir?: string): string {\n   const base = targetDir ? resolve(targetDir) : process.cwd();\n   const dbPath = join(base, '.kbdb');\n   if (!existsSync(dbPath)) {\n      throw new Error(`database not found: ${dbPath}`);\n   }\n   return dbPath;\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 { computeSha256 } from '../../hash/functions/compute-sha256.ts';\n\n/**\n * Computes a short context identifier for an absolute path.\n *\n * Hashes the path with SHA-256 and returns the first 16 hex\n * characters. The result is stable for the same input and unique\n * enough to avoid accidental collisions across typical path sets.\n *\n * @param absolutePath - the absolute filesystem path to identify\n * @returns a 16-character lowercase hex string\n */\nexport async function computeContextId(\n   absolutePath: string,\n): Promise<string> {\n   const hash = await computeSha256(absolutePath);\n   return hash.slice(0, 16);\n}\n", "import { existsSync, readFileSync, unlinkSync } from 'node:fs';\nimport { join } from 'node:path';\nimport { tmpdir } from 'node:os';\nimport { isProcessAlive } from '../../platform/functions/is-process-alive.function.ts';\nimport type { DaemonInfo } from '../typings/daemon-info.model.ts';\n\nexport type { DaemonInfo };\n\n/**\n * Discovers a running worker daemon for the given context.\n *\n * Reads the PID file at `<tmpdir>/kbdb-<contextId>.pid`. If the\n * file exists and the process is alive, returns its PID and the\n * expected socket path. If the file is stale (process dead or PID\n * unparseable), removes the PID file and returns `null`.\n *\n * @param contextId - the 16-character context identifier\n * @returns daemon location info, or `null` if no live daemon found\n */\nexport function discoverDaemon(contextId: string): DaemonInfo | null {\n   const pidPath = join(tmpdir(), `kbdb-${contextId}.pid`);\n\n   if (!existsSync(pidPath)) return null;\n\n   const pidStr = readFileSync(pidPath, 'utf-8').trim();\n   const pid = parseInt(pidStr, 10);\n\n   if (isNaN(pid) || !isProcessAlive(pid)) {\n      try {\n         unlinkSync(pidPath);\n      } catch {\n         // Stale PID file removal is best-effort\n      }\n      return null;\n   }\n\n   const socketPath = join(tmpdir(), `kbdb-${contextId}.sock`);\n\n   const crashPath = join(tmpdir(), `kbdb-${contextId}.crash`);\n   try {\n      unlinkSync(crashPath);\n   } catch {\n      // stale crash file removal is best-effort\n   }\n\n   return { pid, socketPath };\n}\n", "/**\n * Checks whether a process with the given PID is alive.\n *\n * Sends signal `0` to the process, which performs a permission\n * check without sending an actual signal. Returns `true` if the\n * process exists and is reachable, `false` otherwise.\n *\n * @param pid - the process identifier to probe\n */\nexport function isProcessAlive(pid: number): boolean {\n   try {\n      process.kill(pid, 0);\n      return true;\n   } catch {\n      return false;\n   }\n}\n", "import { spawn } from 'node:child_process';\nimport type { Runtime } from '../../runtime/typings/runtime.ts';\n\n/**\n * Spawns a detached worker daemon process for the given context.\n *\n * @param contextPath - absolute path to the context directory the\n *   daemon should serve\n * @param runtime - the current JavaScript runtime environment\n * @param workerScript - absolute path to the worker daemon script,\n *   resolved at the entry point by `resolveWorkerScript`\n */\nexport function spawnDaemon(\n   contextPath: string,\n   runtime: Runtime,\n   workerScript?: string,\n): void {\n   if (!workerScript) {\n      throw new Error(\n         'workerScript must be provided' + ' (resolve at entry point)',\n      );\n   }\n   const execPath = runtime === 'deno' ? 'deno' : process.execPath;\n\n   const args =\n      runtime === 'deno'\n         ? ['run', '--allow-all', workerScript, contextPath]\n         : [workerScript, contextPath];\n\n   const child = spawn(execPath, args, {\n      detached: true,\n      stdio: 'ignore',\n   });\n   child.unref();\n}\n", "import { existsSync } from 'node:fs';\nimport { join } from 'node:path';\nimport { tmpdir } from 'node:os';\n\n/** Default maximum wait time for the daemon PID file to appear. */\nconst DEFAULT_TIMEOUT_MS = 10_000;\n\n/** Polling interval in milliseconds between existence checks. */\nconst POLL_INTERVAL_MS = 100;\n\n/**\n * Waits for the worker daemon's PID file to appear on disk.\n *\n * Polls every 100 ms until the PID file at\n * `<tmpdir>/kbdb-<contextId>.pid` exists or the timeout elapses.\n *\n * @param contextId - the 16-character context identifier\n * @param timeoutMs - maximum wait time in milliseconds; defaults\n *   to 10 000 ms\n * @returns `true` if the PID file appeared before the timeout,\n *   `false` otherwise\n */\nexport async function waitForDaemon(\n   contextId: string,\n   timeoutMs: number = DEFAULT_TIMEOUT_MS,\n): Promise<boolean> {\n   const pidPath = join(tmpdir(), `kbdb-${contextId}.pid`);\n   const start = Date.now();\n   while (Date.now() - start < timeoutMs) {\n      if (existsSync(pidPath)) return true;\n      await new Promise<void>((r) => setTimeout(r, POLL_INTERVAL_MS));\n   }\n   return false;\n}\n", "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 { 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": ["resolve", "existsSync", "readFileSync", "unlinkSync", "join", "tmpdir", "existsSync", "join", "join", "existsSync", "existsSync", "join", "tmpdir", "join", "tmpdir", "join", "join", "tmpdir", "existsSync", "readFileSync", "unlinkSync"]
 }

package/dist/src/cli.d.ts

@@ -1 +1,9 @@
+/**
+ * @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.
+ */
 export {};

package/dist/src/shared/version/constants/version.constant.d.ts

@@ -1,2 +1,2 @@
 /** Current package version, kept in sync with package.json. */
-export declare const VERSION = "0.2.0";
+export declare const VERSION = "0.2.2";

package/dist/src/worker.d.ts

@@ -1 +1,8 @@
+/**
+ * @module
+ *
+ * Worker daemon executable for kbdb. Runs as a detached
+ * background process that loads WASM modules and serves
+ * JSON-RPC 2.0 requests over local IPC.
+ */
 export {};