@dikolab/kbdb 0.3.1 → 0.4.0

package/src/shared/cli/functions/error-to-message.function.ts

@@ -1,9 +0,0 @@
-/**
- * Converts an unknown thrown value to a human-readable message.
- *
- * @param err - the caught value
- * @returns the error message string
- */
-export function errorToMessage(err: unknown): string {
-   return err instanceof Error ? err.message : String(err);
-}

package/src/shared/cli/functions/find-db.function.ts

@@ -1,20 +0,0 @@
-import { existsSync } from 'node:fs';
-import { join, resolve } from 'node:path';
-
-/**
- * Resolves the absolute path to the `.kbdb` database directory
- * under the given base path (or the current working directory).
- *
- * Unlike `ensureDb`, this function is purely read-only: it never
- * creates the directory. Returns `null` when the `.kbdb` directory
- * does not exist.
- *
- * @param dbPath - optional path to the knowledge-base root directory
- * @returns absolute path to the `.kbdb` directory, or `null` when
- *   it does not exist
- */
-export function findDb(dbPath?: string): string | null {
-   const base = dbPath ? resolve(dbPath) : process.cwd();
-   const kbdbDir = join(base, '.kbdb');
-   return existsSync(kbdbDir) ? kbdbDir : null;
-}

package/src/shared/cli/functions/format-mcp-output.function.ts

@@ -1,41 +0,0 @@
-import type { PagedSearchDisplay } from '../typings/search-display.model.ts';
-
-/**
- * Formats a paged search result as a JSON string compatible
- * with the MCP (Model Context Protocol) `text` content block.
- *
- * @param paged - paginated search results to serialise
- * @returns MCP-compatible JSON string ready for stdout
- */
-export function formatMcpOutput(paged: PagedSearchDisplay): string {
-   const mcpItems = paged.items.map((r) => ({
-      kbid: r.kbid,
-      heading: r.heading,
-      type: r.type,
-      docids: r.docids,
-      snippet: r.snippet,
-      matched_terms: r.matched_terms,
-      matched_fields: r.matched_fields,
-      created_at: r.created_at,
-   }));
-   return JSON.stringify(
-      {
-         type: 'text',
-         text: paged.items
-            .map(
-               (r) =>
-                  `[${r.kbid}] ${r.heading ?? '(untitled)'}` +
-                  ` — ${r.snippet || r.preview}`,
-            )
-            .join('\n'),
-         items: mcpItems,
-         total: paged.total,
-         offset: paged.offset,
-         limit: paged.limit,
-         has_more: paged.has_more,
-         relaxed: paged.relaxed,
-      },
-      null,
-      2,
-   );
-}

package/src/shared/cli/functions/format-output.function.ts

@@ -1,95 +0,0 @@
-import type { OutputFormat } from '../typings/cli-options.interface.ts';
-import type { PagedSearchDisplay } from '../typings/search-display.model.ts';
-
-/**
- * Serialises a paged search result into the requested output
- * format string.
- *
- * - `'json'` -- pretty-printed JSON envelope
- * - `'text'` -- numbered human-readable list with paging footer
- * - `'mcp'` -- JSON envelope compatible with MCP protocol
- *
- * @param paged - paginated search results to format
- * @param format - target output format
- * @returns formatted string ready for stdout
- */
-export function formatOutput(
-   paged: PagedSearchDisplay,
-   format: OutputFormat,
-): string {
-   switch (format) {
-      case 'json':
-         return JSON.stringify(paged, null, 2);
-      case 'text':
-         return formatText(paged);
-      case 'mcp':
-         return formatMcp(paged);
-   }
-}
-
-function formatText(paged: PagedSearchDisplay): string {
-   if (paged.items.length === 0) return 'No results found.';
-   const start = paged.offset + 1;
-   const end = paged.offset + paged.items.length;
-
-   const lines = paged.items
-      .map((r, i) => {
-         const num = paged.offset + i + 1;
-         const heading = r.heading ?? '(untitled)';
-         const terms = r.matched_terms.join(', ');
-         const fields = r.matched_fields.join(', ');
-         const confidencePct = (r.confidence * 100).toFixed(0);
-         return (
-            `${String(num)}. [${r.kbid}] ${heading}` +
-            ` (score: ${r.score.toFixed(4)},` +
-            ` confidence: ${confidencePct}%)\n` +
-            `   ${r.snippet || r.preview || '(no snippet)'}\n` +
-            `   type: ${r.type}` +
-            `  terms: ${terms}` +
-            (fields ? `  fields: ${fields}` : '')
-         );
-      })
-      .join('\n\n');
-
-   const footer =
-      `\nShowing ${String(start)}-${String(end)}` +
-      ` of ${String(paged.total)} results`;
-   const hint = paged.has_more
-      ? `\nUse --offset ${String(end)} to see more`
-      : '';
-
-   return lines + footer + hint;
-}
-
-function formatMcp(paged: PagedSearchDisplay): string {
-   const mcpItems = paged.items.map((r) => ({
-      kbid: r.kbid,
-      heading: r.heading,
-      type: r.type,
-      docids: r.docids,
-      snippet: r.snippet,
-      matched_terms: r.matched_terms,
-      matched_fields: r.matched_fields,
-      created_at: r.created_at,
-   }));
-   return JSON.stringify(
-      {
-         type: 'text',
-         text: paged.items
-            .map(
-               (r) =>
-                  `[${r.kbid}] ${r.heading ?? '(untitled)'}` +
-                  ` — ${r.snippet || r.preview}`,
-            )
-            .join('\n'),
-         items: mcpItems,
-         total: paged.total,
-         offset: paged.offset,
-         limit: paged.limit,
-         has_more: paged.has_more,
-         relaxed: paged.relaxed,
-      },
-      null,
-      2,
-   );
-}

package/src/shared/cli/functions/format-text-output.function.ts

@@ -1,42 +0,0 @@
-import type { PagedSearchDisplay } from '../typings/search-display.model.ts';
-
-/**
- * Formats a paged search result as a numbered human-readable
- * text list with a paging footer and optional "more" hint.
- *
- * @param paged - paginated search results to render
- * @returns formatted string ready for stdout
- */
-export function formatTextOutput(paged: PagedSearchDisplay): string {
-   if (paged.items.length === 0) return 'No results found.';
-   const start = paged.offset + 1;
-   const end = paged.offset + paged.items.length;
-
-   const lines = paged.items
-      .map((r, i) => {
-         const num = paged.offset + i + 1;
-         const heading = r.heading ?? '(untitled)';
-         const terms = r.matched_terms.join(', ');
-         const fields = r.matched_fields.join(', ');
-         const confidencePct = (r.confidence * 100).toFixed(0);
-         return (
-            `${String(num)}. [${r.kbid}] ${heading}` +
-            ` (score: ${r.score.toFixed(4)},` +
-            ` confidence: ${confidencePct}%)\n` +
-            `   ${r.snippet || r.preview || '(no snippet)'}\n` +
-            `   type: ${r.type}` +
-            `  terms: ${terms}` +
-            (fields ? `  fields: ${fields}` : '')
-         );
-      })
-      .join('\n\n');
-
-   const footer =
-      `\nShowing ${String(start)}-${String(end)}` +
-      ` of ${String(paged.total)} results`;
-   const hint = paged.has_more
-      ? `\nUse --offset ${String(end)} to see more`
-      : '';
-
-   return lines + footer + hint;
-}

package/src/shared/cli/functions/generate-group-help.function.ts

@@ -1,41 +0,0 @@
-/** One-line description for each group command. */
-const GROUP_DESCRIPTIONS: Readonly<Record<string, string>> = {
-   db: 'Database management',
-   skill: 'Skill management',
-   agent: 'Agent management',
-};
-
-/**
- * Generates the level-2 help text for a group command.
- *
- * Lists all subcommands with their descriptions and
- * includes a footer pointing to per-subcommand help.
- *
- * @param group - the group command name (e.g. `'db'`, `'skill'`)
- * @param subs - ordered list of `[name, description]` pairs
- * @returns formatted help string for the group command
- */
-export function generateGroupHelp(
-   group: string,
-   subs: readonly (readonly [string, string])[],
-): string {
-   const subLines = subs
-      .map(([name, desc]) => `   ${name.padEnd(20)}${desc}`)
-      .join('\n');
-   const desc = GROUP_DESCRIPTIONS[group] ?? group;
-   return (
-      `kbdb ${group} - ${desc}\n` +
-      `\n` +
-      `Usage: kbdb ${group} <subcommand> [options]\n` +
-      `\n` +
-      `Subcommands:\n` +
-      `${subLines}\n` +
-      `\n` +
-      `Global Options:\n` +
-      `   --db <path>         Path to .kbdb directory\n` +
-      `   -h, --help          Show this help message\n` +
-      `\n` +
-      `Run "kbdb ${group} <subcommand> --help"` +
-      ` for details.\n`
-   );
-}