bluera-knowledge 0.9.32 → 0.9.34

package/src/logging/index.ts

@@ -22,8 +22,4 @@ export {
   type LogLevel,
 } from './logger.js';
 
-export {
-  summarizePayload,
-  truncateForLog,
-  type PayloadSummary,
-} from './payload.js';
+export { summarizePayload, truncateForLog, type PayloadSummary } from './payload.js';

package/src/logging/logger.ts

@@ -8,10 +8,10 @@
  * - Child loggers per module for context
  */
 
-import pino, { type Logger, type LoggerOptions } from 'pino';
-import { homedir } from 'node:os';
 import { mkdirSync, existsSync } from 'node:fs';
+import { homedir } from 'node:os';
 import { join } from 'node:path';
+import pino, { type Logger, type LoggerOptions } from 'pino';
 
 /** Valid log levels */
 export type LogLevel = 'trace' | 'debug' | 'info' | 'warn' | 'error' | 'fatal';
@@ -47,9 +47,7 @@ function getLogLevel(): LogLevel {
   }
 
   if (!isValidLogLevel(level)) {
-    throw new Error(
-      `Invalid LOG_LEVEL: "${level}". Valid values: ${VALID_LEVELS.join(', ')}`
-    );
+    throw new Error(`Invalid LOG_LEVEL: "${level}". Valid values: ${VALID_LEVELS.join(', ')}`);
   }
 
   return level;

package/src/logging/payload.test.ts

@@ -6,7 +6,7 @@ import { tmpdir } from 'node:os';
 // Mock logger module before importing payload
 vi.mock('./logger.js', () => ({
   getLogDirectory: vi.fn(),
-  isLevelEnabled: vi.fn()
+  isLevelEnabled: vi.fn(),
 }));
 
 import { summarizePayload, truncateForLog } from './payload.js';

package/src/logging/payload.ts

@@ -6,9 +6,9 @@
  * - Optionally dumping full content to separate files at trace level
  */
 
+import { createHash } from 'node:crypto';
 import { writeFileSync, mkdirSync, existsSync } from 'node:fs';
 import { join } from 'node:path';
-import { createHash } from 'node:crypto';
 import { getLogDirectory, isLevelEnabled } from './logger.js';
 
 /** Maximum characters for log preview */
@@ -40,9 +40,7 @@ function getPayloadDir(): string {
 
 /** Generate a safe filename from an identifier */
 function safeFilename(identifier: string): string {
-  return identifier
-    .replace(/[^a-zA-Z0-9-]/g, '_')
-    .substring(0, 50);
+  return identifier.replace(/[^a-zA-Z0-9-]/g, '_').substring(0, 50);
 }
 
 /**
@@ -117,5 +115,5 @@ export function truncateForLog(content: string, maxLength: number = MAX_PREVIEW_
   if (content.length <= maxLength) {
     return content;
   }
-  return content.substring(0, maxLength) + '... [truncated]';
+  return `${content.substring(0, maxLength)}... [truncated]`;
 }

package/src/mcp/commands/index.ts

@@ -5,10 +5,10 @@
  * Import this module to ensure all commands are available.
  */
 
-import { commandRegistry } from './registry.js';
-import { storeCommands } from './store.commands.js';
 import { jobCommands } from './job.commands.js';
 import { metaCommands } from './meta.commands.js';
+import { commandRegistry } from './registry.js';
+import { storeCommands } from './store.commands.js';
 
 // Register all commands
 commandRegistry.registerAll(storeCommands);

package/src/mcp/commands/job.commands.ts

@@ -1,15 +1,7 @@
 import { z } from 'zod';
+import { handleCheckJobStatus, handleListJobs, handleCancelJob } from '../handlers/job.handler.js';
 import type { CommandDefinition } from './registry.js';
-import type {
-  CheckJobStatusArgs,
-  ListJobsArgs,
-  CancelJobArgs
-} from '../schemas/index.js';
-import {
-  handleCheckJobStatus,
-  handleListJobs,
-  handleCancelJob
-} from '../handlers/job.handler.js';
+import type { CheckJobStatusArgs, ListJobsArgs, CancelJobArgs } from '../schemas/index.js';
 
 /**
  * Job management commands for the execute meta-tool
@@ -28,27 +20,29 @@ export const jobCommands: CommandDefinition[] = [
     description: 'List all background jobs',
     argsSchema: z.object({
       activeOnly: z.boolean().optional().describe('Only show active jobs'),
-      status: z.enum(['pending', 'running', 'completed', 'failed', 'cancelled'])
+      status: z
+        .enum(['pending', 'running', 'completed', 'failed', 'cancelled'])
         .optional()
-        .describe('Filter by job status')
+        .describe('Filter by job status'),
     }),
-    handler: (args, context) => handleListJobs(args as unknown as ListJobsArgs, context)
+    handler: (args, context) => handleListJobs(args as unknown as ListJobsArgs, context),
   },
   {
     name: 'job:status',
     description: 'Check the status of a specific background job',
     argsSchema: z.object({
-      jobId: z.string().min(1).describe('Job ID to check')
+      jobId: z.string().min(1).describe('Job ID to check'),
     }),
-    handler: (args, context) => handleCheckJobStatus(args as unknown as CheckJobStatusArgs, context)
+    handler: (args, context) =>
+      handleCheckJobStatus(args as unknown as CheckJobStatusArgs, context),
   },
   {
     name: 'job:cancel',
     description: 'Cancel a running or pending background job',
     argsSchema: z.object({
-      jobId: z.string().min(1).describe('Job ID to cancel')
+      jobId: z.string().min(1).describe('Job ID to cancel'),
     }),
-    handler: (args, context) => handleCancelJob(args as unknown as CancelJobArgs, context)
-  }
+    handler: (args, context) => handleCancelJob(args as unknown as CancelJobArgs, context),
+  },
 ];
 /* eslint-enable @typescript-eslint/consistent-type-assertions */

package/src/mcp/commands/meta.commands.ts

@@ -1,7 +1,7 @@
 import { z } from 'zod';
+import { commandRegistry, generateHelp } from './registry.js';
 import type { CommandDefinition } from './registry.js';
 import type { ToolResponse } from '../types.js';
-import { commandRegistry, generateHelp } from './registry.js';
 
 /**
  * Meta commands for introspection and help
@@ -15,26 +15,26 @@ export const metaCommands: CommandDefinition[] = [
     description: 'List all available commands',
     handler: (): Promise<ToolResponse> => {
       const commands = commandRegistry.all();
-      const commandList = commands.map(cmd => ({
+      const commandList = commands.map((cmd) => ({
         name: cmd.name,
-        description: cmd.description
+        description: cmd.description,
       }));
 
       return Promise.resolve({
         content: [
           {
             type: 'text' as const,
-            text: JSON.stringify({ commands: commandList }, null, 2)
-          }
-        ]
+            text: JSON.stringify({ commands: commandList }, null, 2),
+          },
+        ],
       });
-    }
+    },
   },
   {
     name: 'help',
     description: 'Show help for a specific command or list all commands',
     argsSchema: z.object({
-      command: z.string().optional().describe('Command name to get help for')
+      command: z.string().optional().describe('Command name to get help for'),
     }),
     handler: (args: Record<string, unknown>): Promise<ToolResponse> => {
       // eslint-disable-next-line @typescript-eslint/consistent-type-assertions
@@ -45,10 +45,10 @@ export const metaCommands: CommandDefinition[] = [
         content: [
           {
             type: 'text' as const,
-            text: helpText
-          }
-        ]
+            text: helpText,
+          },
+        ],
       });
-    }
-  }
+    },
+  },
 ];

package/src/mcp/commands/registry.ts

@@ -121,9 +121,10 @@ export async function executeCommand(
 
   // Validate args if schema provided (Zod parse returns unknown, safe to cast after validation)
   /* eslint-disable @typescript-eslint/consistent-type-assertions */
-  const validatedArgs: Record<string, unknown> = command.argsSchema !== undefined
-    ? (command.argsSchema.parse(args) as Record<string, unknown>)
-    : args;
+  const validatedArgs: Record<string, unknown> =
+    command.argsSchema !== undefined
+      ? (command.argsSchema.parse(args) as Record<string, unknown>)
+      : args;
   /* eslint-enable @typescript-eslint/consistent-type-assertions */
 
   return command.handler(validatedArgs, context);
@@ -139,11 +140,7 @@ export function generateHelp(commandName?: string): string {
       throw new Error(`Unknown command: ${commandName}`);
     }
 
-    const lines = [
-      `Command: ${command.name}`,
-      `Description: ${command.description}`,
-      ''
-    ];
+    const lines = [`Command: ${command.name}`, `Description: ${command.description}`, ''];
 
     if (command.argsSchema !== undefined) {
       lines.push('Arguments:');

package/src/mcp/commands/store.commands.ts

@@ -1,19 +1,19 @@
 import { z } from 'zod';
+import {
+  handleListStores,
+  handleGetStoreInfo,
+  handleCreateStore,
+  handleIndexStore,
+  handleDeleteStore,
+} from '../handlers/store.handler.js';
 import type { CommandDefinition } from './registry.js';
 import type {
   ListStoresArgs,
   GetStoreInfoArgs,
   CreateStoreArgs,
   IndexStoreArgs,
-  DeleteStoreArgs
+  DeleteStoreArgs,
 } from '../schemas/index.js';
-import {
-  handleListStores,
-  handleGetStoreInfo,
-  handleCreateStore,
-  handleIndexStore,
-  handleDeleteStore
-} from '../handlers/store.handler.js';
 
 /**
  * Store management commands for the execute meta-tool
@@ -31,17 +31,17 @@ export const storeCommands: CommandDefinition[] = [
     name: 'stores',
     description: 'List all indexed knowledge stores',
     argsSchema: z.object({
-      type: z.enum(['file', 'repo', 'web']).optional().describe('Filter by store type')
+      type: z.enum(['file', 'repo', 'web']).optional().describe('Filter by store type'),
     }),
-    handler: (args, context) => handleListStores(args as unknown as ListStoresArgs, context)
+    handler: (args, context) => handleListStores(args as unknown as ListStoresArgs, context),
   },
   {
     name: 'store:info',
     description: 'Get detailed information about a specific store',
     argsSchema: z.object({
-      store: z.string().min(1).describe('Store name or ID')
+      store: z.string().min(1).describe('Store name or ID'),
     }),
-    handler: (args, context) => handleGetStoreInfo(args as unknown as GetStoreInfoArgs, context)
+    handler: (args, context) => handleGetStoreInfo(args as unknown as GetStoreInfoArgs, context),
   },
   {
     name: 'store:create',
@@ -51,25 +51,25 @@ export const storeCommands: CommandDefinition[] = [
       type: z.enum(['file', 'repo']).describe('Store type'),
       source: z.string().min(1).describe('Git URL or local path'),
       branch: z.string().optional().describe('Git branch (for repo type)'),
-      description: z.string().optional().describe('Store description')
+      description: z.string().optional().describe('Store description'),
     }),
-    handler: (args, context) => handleCreateStore(args as unknown as CreateStoreArgs, context)
+    handler: (args, context) => handleCreateStore(args as unknown as CreateStoreArgs, context),
   },
   {
     name: 'store:index',
     description: 'Re-index a knowledge store to update search data',
     argsSchema: z.object({
-      store: z.string().min(1).describe('Store name or ID')
+      store: z.string().min(1).describe('Store name or ID'),
     }),
-    handler: (args, context) => handleIndexStore(args as unknown as IndexStoreArgs, context)
+    handler: (args, context) => handleIndexStore(args as unknown as IndexStoreArgs, context),
   },
   {
     name: 'store:delete',
     description: 'Delete a knowledge store and all associated data',
     argsSchema: z.object({
-      store: z.string().min(1).describe('Store name or ID')
+      store: z.string().min(1).describe('Store name or ID'),
     }),
-    handler: (args, context) => handleDeleteStore(args as unknown as DeleteStoreArgs, context)
-  }
+    handler: (args, context) => handleDeleteStore(args as unknown as DeleteStoreArgs, context),
+  },
 ];
 /* eslint-enable @typescript-eslint/consistent-type-assertions */

package/src/mcp/handlers/execute.handler.test.ts

@@ -19,13 +19,13 @@ describe('execute.handler', () => {
           list: async () => [],
           getByIdOrName: async () => undefined,
           create: async () => ({ success: false, error: { message: 'Not implemented in test' } }),
-          delete: async () => ({ success: false, error: { message: 'Not implemented in test' } })
+          delete: async () => ({ success: false, error: { message: 'Not implemented in test' } }),
         },
         lance: {
-          deleteStore: async () => {}
-        }
+          deleteStore: async () => {},
+        },
       } as unknown as HandlerContext['services'],
-      options: { dataDir: tempDir }
+      options: { dataDir: tempDir },
     };
   });
 
@@ -88,7 +88,7 @@ describe('execute.handler', () => {
     it('should handle "store:info" command', async () => {
       const args: ExecuteArgs = {
         command: 'store:info',
-        args: { store: 'nonexistent' }
+        args: { store: 'nonexistent' },
       };
 
       // Should throw since store doesn't exist
@@ -113,12 +113,12 @@ describe('execute.handler', () => {
       const job = jobService.createJob({
         type: 'index',
         details: { storeId: 'test-store' },
-        message: 'Testing...'
+        message: 'Testing...',
       });
 
       const args: ExecuteArgs = {
         command: 'job:status',
-        args: { jobId: job.id }
+        args: { jobId: job.id },
       };
       const result = await handleExecute(args, mockContext);
 
@@ -134,12 +134,12 @@ describe('execute.handler', () => {
       const job = jobService.createJob({
         type: 'index',
         details: { storeId: 'test-store' },
-        message: 'Testing...'
+        message: 'Testing...',
       });
 
       const args: ExecuteArgs = {
         command: 'job:cancel',
-        args: { jobId: job.id }
+        args: { jobId: job.id },
       };
       const result = await handleExecute(args, mockContext);
 
@@ -168,7 +168,7 @@ describe('execute.handler', () => {
     it('should throw for help on unknown command', async () => {
       const args: ExecuteArgs = {
         command: 'help',
-        args: { command: 'nonexistent' }
+        args: { command: 'nonexistent' },
       };
 
       await expect(handleExecute(args, mockContext)).rejects.toThrow(

package/src/mcp/handlers/execute.handler.ts

@@ -1,9 +1,8 @@
-import type { ToolHandler, ToolResponse } from '../types.js';
-import type { ExecuteArgs } from '../schemas/index.js';
-import { ExecuteArgsSchema } from '../schemas/index.js';
-// Import commands module to register all commands
-import '../commands/index.js';
+// Import commands module - side effect registers all commands, then use executeCommand
 import { executeCommand } from '../commands/index.js';
+import { ExecuteArgsSchema } from '../schemas/index.js';
+import type { ExecuteArgs } from '../schemas/index.js';
+import type { ToolHandler, ToolResponse } from '../types.js';
 
 /**
  * Handle execute requests

package/src/mcp/handlers/index.ts

@@ -1,13 +1,7 @@
 import { z } from 'zod';
+import { handleSearch, handleGetFullContext } from './search.handler.js';
+import { SearchArgsSchema, GetFullContextArgsSchema } from '../schemas/index.js';
 import type { ToolHandler } from '../types.js';
-import {
-  SearchArgsSchema,
-  GetFullContextArgsSchema
-} from '../schemas/index.js';
-import {
-  handleSearch,
-  handleGetFullContext
-} from './search.handler.js';
 
 /**
  * Tool definition with schema and handler
@@ -16,7 +10,7 @@ export interface ToolDefinition {
   name: string;
   description: string;
   schema: z.ZodType;
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any -- heterogeneous tool registry requires any; schema provides runtime type safety via Zod validation
   handler: ToolHandler<any>;
 }
 
@@ -30,14 +24,16 @@ export interface ToolDefinition {
 export const tools: ToolDefinition[] = [
   {
     name: 'search',
-    description: 'Search all indexed knowledge stores with pattern detection and AI-optimized results. Returns structured code units with progressive context layers.',
+    description:
+      'Search all indexed knowledge stores with pattern detection and AI-optimized results. Returns structured code units with progressive context layers.',
     schema: SearchArgsSchema,
-    handler: handleSearch
+    handler: handleSearch,
   },
   {
     name: 'get_full_context',
-    description: 'Get complete code and context for a specific search result by ID. Use this after search to get full implementation details.',
+    description:
+      'Get complete code and context for a specific search result by ID. Use this after search to get full implementation details.',
     schema: GetFullContextArgsSchema,
-    handler: handleGetFullContext
-  }
+    handler: handleGetFullContext,
+  },
 ];

package/src/mcp/handlers/job.handler.test.ts

@@ -15,7 +15,7 @@ describe('job.handler', () => {
     tempDir = mkdtempSync(join(tmpdir(), 'job-handler-test-'));
     mockContext = {
       services: {} as any,
-      options: { dataDir: tempDir }
+      options: { dataDir: tempDir },
     };
   });
 
@@ -29,7 +29,7 @@ describe('job.handler', () => {
       const job = jobService.createJob({
         type: 'index',
         details: { storeId: 'test-store' },
-        message: 'Indexing...'
+        message: 'Indexing...',
       });
 
       const args: CheckJobStatusArgs = { jobId: job.id };
@@ -71,12 +71,12 @@ describe('job.handler', () => {
       jobService.createJob({
         type: 'index',
         details: { storeId: 'store1' },
-        message: 'Indexing store1'
+        message: 'Indexing store1',
       });
       jobService.createJob({
         type: 'clone',
         details: { url: 'https://example.com' },
-        message: 'Cloning repo'
+        message: 'Cloning repo',
       });
 
       const args: ListJobsArgs = {};
@@ -92,12 +92,12 @@ describe('job.handler', () => {
       const job1 = jobService.createJob({
         type: 'index',
         details: { storeId: 'store1' },
-        message: 'Indexing'
+        message: 'Indexing',
       });
       jobService.createJob({
         type: 'clone',
         details: { url: 'https://example.com' },
-        message: 'Cloning'
+        message: 'Cloning',
       });
 
       // Update job1 status
@@ -116,12 +116,12 @@ describe('job.handler', () => {
       const job1 = jobService.createJob({
         type: 'index',
         details: { storeId: 'store1' },
-        message: 'Indexing'
+        message: 'Indexing',
       });
       jobService.createJob({
         type: 'clone',
         details: { url: 'https://example.com' },
-        message: 'Cloning'
+        message: 'Cloning',
       });
 
       jobService.updateJob(job1.id, { status: 'completed' });
@@ -141,7 +141,7 @@ describe('job.handler', () => {
       const job = jobService.createJob({
         type: 'index',
         details: { storeId: 'test-store' },
-        message: 'Indexing...'
+        message: 'Indexing...',
       });
 
       const args: CancelJobArgs = { jobId: job.id };
@@ -170,7 +170,7 @@ describe('job.handler', () => {
       const job = jobService.createJob({
         type: 'index',
         details: { storeId: 'test-store' },
-        message: 'Indexing...'
+        message: 'Indexing...',
       });
 
       jobService.updateJob(job.id, { status: 'completed' });

package/src/mcp/handlers/job.handler.ts

@@ -1,15 +1,11 @@
-import type { ToolHandler, ToolResponse } from '../types.js';
-import type {
-  CheckJobStatusArgs,
-  ListJobsArgs,
-  CancelJobArgs
-} from '../schemas/index.js';
+import { JobService } from '../../services/job.service.js';
 import {
   CheckJobStatusArgsSchema,
   ListJobsArgsSchema,
-  CancelJobArgsSchema
+  CancelJobArgsSchema,
 } from '../schemas/index.js';
-import { JobService } from '../../services/job.service.js';
+import type { CheckJobStatusArgs, ListJobsArgs, CancelJobArgs } from '../schemas/index.js';
+import type { ToolHandler, ToolResponse } from '../types.js';
 
 /**
  * Handle check_job_status requests
@@ -36,9 +32,9 @@ export const handleCheckJobStatus: ToolHandler<CheckJobStatusArgs> = (
     content: [
       {
         type: 'text',
-        text: JSON.stringify(job, null, 2)
-      }
-    ]
+        text: JSON.stringify(job, null, 2),
+      },
+    ],
   });
 };
 
@@ -47,10 +43,7 @@ export const handleCheckJobStatus: ToolHandler<CheckJobStatusArgs> = (
  *
  * Lists all jobs with optional filtering by status or active status.
  */
-export const handleListJobs: ToolHandler<ListJobsArgs> = (
-  args,
-  context
-): Promise<ToolResponse> => {
+export const handleListJobs: ToolHandler<ListJobsArgs> = (args, context): Promise<ToolResponse> => {
   // Validate arguments with Zod
   const validated = ListJobsArgsSchema.parse(args);
 
@@ -71,9 +64,9 @@ export const handleListJobs: ToolHandler<ListJobsArgs> = (
     content: [
       {
         type: 'text',
-        text: JSON.stringify({ jobs }, null, 2)
-      }
-    ]
+        text: JSON.stringify({ jobs }, null, 2),
+      },
+    ],
   });
 };
 
@@ -105,12 +98,16 @@ export const handleCancelJob: ToolHandler<CancelJobArgs> = (
     content: [
       {
         type: 'text',
-        text: JSON.stringify({
-          success: true,
-          job,
-          message: 'Job cancelled successfully'
-        }, null, 2)
-      }
-    ]
+        text: JSON.stringify(
+          {
+            success: true,
+            job,
+            message: 'Job cancelled successfully',
+          },
+          null,
+          2
+        ),
+      },
+    ],
   });
 };