bluera-knowledge 0.14.0 → 0.14.2

package/src/defaults/repos.ts

@@ -1,67 +0,0 @@
-/**
- * Default repositories for quick setup.
- * These are Anthropic/Claude-related repositories that provide
- * useful knowledge for Claude Code development.
- */
-
-export interface DefaultRepo {
-  /** Git URL for cloning */
-  url: string;
-  /** Friendly name for the store */
-  name: string;
-  /** Description of what this repo contains */
-  description: string;
-  /** Tags for categorization */
-  tags: string[];
-}
-
-export const DEFAULT_REPOS: readonly DefaultRepo[] = [
-  {
-    url: 'git@github.com:ericbuess/claude-code-docs.git',
-    name: 'claude-code-docs',
-    description: 'Claude Code documentation',
-    tags: ['claude', 'docs', 'claude-code'],
-  },
-  {
-    url: 'git@github.com:anthropics/claude-code.git',
-    name: 'claude-code',
-    description: 'Claude Code CLI tool source',
-    tags: ['claude', 'cli', 'anthropic'],
-  },
-  {
-    url: 'git@github.com:anthropics/claude-agent-sdk-python.git',
-    name: 'claude-agent-sdk-python',
-    description: 'Claude Agent SDK for Python',
-    tags: ['claude', 'sdk', 'python', 'agents'],
-  },
-  {
-    url: 'git@github.com:anthropics/skills.git',
-    name: 'claude-skills',
-    description: 'Claude skills and capabilities',
-    tags: ['claude', 'skills'],
-  },
-  {
-    url: 'git@github.com:anthropics/claude-quickstarts.git',
-    name: 'claude-quickstarts',
-    description: 'Claude quickstart examples and tutorials',
-    tags: ['claude', 'examples', 'tutorials'],
-  },
-  {
-    url: 'git@github.com:anthropics/claude-plugins-official.git',
-    name: 'claude-plugins',
-    description: 'Official Claude plugins',
-    tags: ['claude', 'plugins'],
-  },
-  {
-    url: 'git@github.com:anthropics/claude-agent-sdk-typescript.git',
-    name: 'claude-agent-sdk-typescript',
-    description: 'Claude Agent SDK for TypeScript',
-    tags: ['claude', 'sdk', 'typescript', 'agents'],
-  },
-  {
-    url: 'git@github.com:anthropics/claude-agent-sdk-demos.git',
-    name: 'claude-agent-sdk-demos',
-    description: 'Claude Agent SDK demo applications',
-    tags: ['claude', 'sdk', 'demos', 'examples'],
-  },
-];

package/src/index.ts

@@ -1,124 +0,0 @@
-#!/usr/bin/env node
-
-import { homedir } from 'node:os';
-import { join } from 'node:path';
-import { Command } from 'commander';
-import { AdapterRegistry } from './analysis/adapter-registry.js';
-import { ZilAdapter } from './analysis/zil/index.js';
-import { createCrawlCommand } from './cli/commands/crawl.js';
-import { createIndexCommand } from './cli/commands/index-cmd.js';
-import { createMCPCommand } from './cli/commands/mcp.js';
-import {
-  createAddRepoCommand,
-  createAddFolderCommand,
-  createStoresCommand,
-  createSuggestCommand,
-} from './cli/commands/plugin-api.js';
-import { createSearchCommand } from './cli/commands/search.js';
-import { createServeCommand } from './cli/commands/serve.js';
-import { createSetupCommand } from './cli/commands/setup.js';
-import { createStoreCommand } from './cli/commands/store.js';
-import { createSyncCommand } from './cli/commands/sync.js';
-import { createProgram, getGlobalOptions } from './cli/program.js';
-
-// Register built-in language adapters
-const registry = AdapterRegistry.getInstance();
-registry.register(new ZilAdapter());
-
-// Default paths
-const DEFAULT_DATA_DIR = join(homedir(), '.bluera', 'bluera-knowledge', 'data');
-const DEFAULT_CONFIG = join(homedir(), '.bluera', 'bluera-knowledge', 'config.json');
-const DEFAULT_REPOS_DIR = join(homedir(), '.bluera', 'bluera-knowledge', 'repos');
-
-/**
- * Format a command and its subcommands recursively for comprehensive help output.
- */
-function formatCommandHelp(cmd: Command, indent: string = ''): string[] {
-  const lines: string[] = [];
-  const name = cmd.name();
-  const desc = cmd.description();
-  const args = cmd.registeredArguments
-    .map((a) => {
-      const req = a.required;
-      return req ? `<${a.name()}>` : `[${a.name()}]`;
-    })
-    .join(' ');
-
-  // Command header with arguments
-  lines.push(`${indent}${name}${args ? ` ${args}` : ''}`);
-  if (desc) {
-    lines.push(`${indent}  ${desc}`);
-  }
-
-  // Options (skip -h, --help which is auto-added)
-  const options = cmd.options.filter((o) => o.flags !== '-h, --help');
-  for (const opt of options) {
-    lines.push(`${indent}  ${opt.flags.padEnd(28)} ${opt.description}`);
-  }
-
-  // Subcommands (recursive)
-  const subcommands = cmd.commands.filter((c) => c.name() !== 'help');
-  for (const sub of subcommands) {
-    lines.push('');
-    lines.push(...formatCommandHelp(sub, `${indent}  `));
-  }
-
-  return lines;
-}
-
-/**
- * Print comprehensive help showing all commands, subcommands, and options.
- */
-function printFullHelp(program: Command): void {
-  console.log('bluera-knowledge - CLI tool for managing knowledge stores with semantic search\n');
-
-  // Active paths
-  console.log('Paths:');
-  console.log(`  data        ${DEFAULT_DATA_DIR}`);
-  console.log(`  config      ${DEFAULT_CONFIG}`);
-  console.log(`  repos       ${DEFAULT_REPOS_DIR}`);
-
-  // Global options
-  console.log('\nGlobal options:');
-  const globalOpts = program.options.filter(
-    (o) => o.flags !== '-h, --help' && o.flags !== '-V, --version'
-  );
-  for (const opt of globalOpts) {
-    console.log(`  ${opt.flags.padEnd(28)} ${opt.description}`);
-  }
-
-  console.log('\nCommands:\n');
-
-  // All commands except help
-  const commands = program.commands.filter((c) => c.name() !== 'help');
-  for (const cmd of commands) {
-    console.log(formatCommandHelp(cmd).join('\n'));
-    console.log('');
-  }
-}
-
-const program = createProgram();
-
-// Plugin API commands (simple interface)
-program.addCommand(createAddRepoCommand(() => getGlobalOptions(program)));
-program.addCommand(createAddFolderCommand(() => getGlobalOptions(program)));
-program.addCommand(createStoresCommand(() => getGlobalOptions(program)));
-program.addCommand(createSuggestCommand(() => getGlobalOptions(program)));
-
-// Advanced CLI commands
-program.addCommand(createStoreCommand(() => getGlobalOptions(program)));
-program.addCommand(createSearchCommand(() => getGlobalOptions(program)));
-program.addCommand(createIndexCommand(() => getGlobalOptions(program)));
-program.addCommand(createServeCommand(() => getGlobalOptions(program)));
-program.addCommand(createCrawlCommand(() => getGlobalOptions(program)));
-program.addCommand(createSetupCommand(() => getGlobalOptions(program)));
-program.addCommand(createSyncCommand(() => getGlobalOptions(program)));
-program.addCommand(createMCPCommand(() => getGlobalOptions(program)));
-
-// Show comprehensive help when no arguments provided
-if (process.argv.length <= 2) {
-  printFullHelp(program);
-  process.exit(0);
-}
-
-program.parse();

package/src/logging/index.ts

@@ -1,25 +0,0 @@
-/**
- * Logging module - pino-based file logging with auto-rotation
- *
- * @example
- * import { createLogger, summarizePayload } from './logging/index.js';
- *
- * const logger = createLogger('my-module');
- * logger.info({ data }, 'Something happened');
- *
- * // For large payloads:
- * logger.info({
- *   ...summarizePayload(html, 'raw-html', url),
- * }, 'Fetched HTML');
- */
-
-export {
-  createLogger,
-  shutdownLogger,
-  getCurrentLogLevel,
-  isLevelEnabled,
-  getLogDirectory,
-  type LogLevel,
-} from './logger.js';
-
-export { summarizePayload, truncateForLog, type PayloadSummary } from './payload.js';

package/src/logging/logger.test.ts

@@ -1,75 +0,0 @@
-import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
-import { getCurrentLogLevel, isLevelEnabled, getLogDirectory } from './logger.js';
-
-describe('logger', () => {
-  const originalEnv = process.env['LOG_LEVEL'];
-
-  beforeEach(() => {
-    delete process.env['LOG_LEVEL'];
-  });
-
-  afterEach(() => {
-    if (originalEnv !== undefined) {
-      process.env['LOG_LEVEL'] = originalEnv;
-    } else {
-      delete process.env['LOG_LEVEL'];
-    }
-  });
-
-  describe('getCurrentLogLevel', () => {
-    it('returns info as default level', () => {
-      expect(getCurrentLogLevel()).toBe('info');
-    });
-
-    it('returns level from environment variable', () => {
-      process.env['LOG_LEVEL'] = 'debug';
-      expect(getCurrentLogLevel()).toBe('debug');
-    });
-
-    it('handles lowercase environment variable', () => {
-      process.env['LOG_LEVEL'] = 'WARN';
-      expect(getCurrentLogLevel()).toBe('warn');
-    });
-
-    it('treats empty string as default', () => {
-      process.env['LOG_LEVEL'] = '';
-      expect(getCurrentLogLevel()).toBe('info');
-    });
-
-    it('throws on invalid log level', () => {
-      process.env['LOG_LEVEL'] = 'invalid';
-      expect(() => getCurrentLogLevel()).toThrow('Invalid LOG_LEVEL: "invalid"');
-    });
-  });
-
-  describe('isLevelEnabled', () => {
-    it('returns true when check level is at or above current level', () => {
-      process.env['LOG_LEVEL'] = 'info';
-      expect(isLevelEnabled('info')).toBe(true);
-      expect(isLevelEnabled('warn')).toBe(true);
-      expect(isLevelEnabled('error')).toBe(true);
-    });
-
-    it('returns false when check level is below current level', () => {
-      process.env['LOG_LEVEL'] = 'warn';
-      expect(isLevelEnabled('debug')).toBe(false);
-      expect(isLevelEnabled('info')).toBe(false);
-    });
-
-    it('enables all levels when set to trace', () => {
-      process.env['LOG_LEVEL'] = 'trace';
-      expect(isLevelEnabled('trace')).toBe(true);
-      expect(isLevelEnabled('debug')).toBe(true);
-      expect(isLevelEnabled('info')).toBe(true);
-    });
-  });
-
-  describe('getLogDirectory', () => {
-    it('returns path under home directory', () => {
-      const logDir = getLogDirectory();
-      expect(logDir).toContain('.bluera');
-      expect(logDir).toContain('bluera-knowledge');
-      expect(logDir).toContain('logs');
-    });
-  });
-});

package/src/logging/logger.ts

@@ -1,145 +0,0 @@
-/**
- * Core logger factory using pino with file-based rolling logs
- *
- * Features:
- * - File-only output (no console pollution for Claude Code)
- * - Size-based rotation (10MB, keeps 5 files)
- * - LOG_LEVEL env var control (trace/debug/info/warn/error/fatal)
- * - Child loggers per module for context
- */
-
-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';
-
-const VALID_LEVELS: readonly LogLevel[] = ['trace', 'debug', 'info', 'warn', 'error', 'fatal'];
-const VALID_LEVELS_SET: ReadonlySet<string> = new Set(VALID_LEVELS);
-
-/** Default log directory under user home */
-function getLogDir(): string {
-  return join(homedir(), '.bluera', 'bluera-knowledge', 'logs');
-}
-
-/** Resolve and create log directory - fails fast if cannot create */
-function ensureLogDir(): string {
-  const logDir = getLogDir();
-  if (!existsSync(logDir)) {
-    mkdirSync(logDir, { recursive: true });
-  }
-  return logDir;
-}
-
-/** Check if a string is a valid log level */
-function isValidLogLevel(level: string): level is LogLevel {
-  return VALID_LEVELS_SET.has(level);
-}
-
-/** Get log level from environment - fails fast on invalid value */
-function getLogLevel(): LogLevel {
-  const level = process.env['LOG_LEVEL']?.toLowerCase();
-
-  if (level === undefined || level === '') {
-    return 'info';
-  }
-
-  if (!isValidLogLevel(level)) {
-    throw new Error(`Invalid LOG_LEVEL: "${level}". Valid values: ${VALID_LEVELS.join(', ')}`);
-  }
-
-  return level;
-}
-
-/** Root logger instance - lazily initialized */
-let rootLogger: Logger | null = null;
-
-/** Initialize the root logger with pino-roll transport */
-function initializeLogger(): Logger {
-  if (rootLogger !== null) {
-    return rootLogger;
-  }
-
-  const logDir = ensureLogDir();
-  const logFile = join(logDir, 'app.log');
-  const level = getLogLevel();
-
-  const options: LoggerOptions = {
-    level,
-    timestamp: pino.stdTimeFunctions.isoTime,
-    formatters: {
-      level: (label) => ({ level: label }),
-    },
-    transport: {
-      target: 'pino-roll',
-      options: {
-        file: logFile,
-        size: '10m', // 10MB rotation
-        limit: { count: 5 }, // Keep 5 rotated files
-        mkdir: true,
-      },
-    },
-  };
-
-  rootLogger = pino(options);
-  return rootLogger;
-}
-
-/**
- * Create a named child logger for a specific module
- *
- * @param module - Module name (e.g., 'crawler', 'mcp-server', 'search-service')
- * @returns Logger instance with module context
- *
- * @example
- * const logger = createLogger('crawler');
- * logger.info({ url }, 'Fetching page');
- */
-export function createLogger(module: string): Logger {
-  const root = initializeLogger();
-  return root.child({ module });
-}
-
-/**
- * Get the current log level
- */
-export function getCurrentLogLevel(): LogLevel {
-  return getLogLevel();
-}
-
-/**
- * Check if a specific log level is enabled
- */
-export function isLevelEnabled(level: LogLevel): boolean {
-  const currentLevel = getLogLevel();
-  const currentIndex = VALID_LEVELS.indexOf(currentLevel);
-  const checkIndex = VALID_LEVELS.indexOf(level);
-  return checkIndex >= currentIndex;
-}
-
-/**
- * Get the log directory path
- */
-export function getLogDirectory(): string {
-  return getLogDir();
-}
-
-/**
- * Flush and shutdown the logger - call before process exit
- */
-export function shutdownLogger(): Promise<void> {
-  return new Promise((resolve) => {
-    if (rootLogger !== null) {
-      rootLogger.flush();
-      // Give time for async transport to flush
-      setTimeout(() => {
-        rootLogger = null;
-        resolve();
-      }, 100);
-    } else {
-      resolve();
-    }
-  });
-}

package/src/logging/payload.test.ts

@@ -1,152 +0,0 @@
-import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
-import { mkdtempSync, rmSync, existsSync, readdirSync, readFileSync } from 'node:fs';
-import { join } from 'node:path';
-import { tmpdir } from 'node:os';
-
-// Mock logger module before importing payload
-vi.mock('./logger.js', () => ({
-  getLogDirectory: vi.fn(),
-  isLevelEnabled: vi.fn(),
-}));
-
-import { summarizePayload, truncateForLog } from './payload.js';
-import { getLogDirectory, isLevelEnabled } from './logger.js';
-
-const mockGetLogDirectory = getLogDirectory as ReturnType<typeof vi.fn>;
-const mockIsLevelEnabled = isLevelEnabled as ReturnType<typeof vi.fn>;
-
-describe('payload utilities', () => {
-  let tempDir: string;
-
-  beforeEach(() => {
-    tempDir = mkdtempSync(join(tmpdir(), 'payload-test-'));
-    mockGetLogDirectory.mockReturnValue(tempDir);
-    mockIsLevelEnabled.mockReturnValue(false);
-  });
-
-  afterEach(() => {
-    rmSync(tempDir, { recursive: true, force: true });
-    vi.clearAllMocks();
-  });
-
-  describe('truncateForLog', () => {
-    it('returns content unchanged when under max length', () => {
-      const content = 'short content';
-      expect(truncateForLog(content, 500)).toBe(content);
-    });
-
-    it('truncates content when over max length', () => {
-      const content = 'a'.repeat(600);
-      const result = truncateForLog(content, 500);
-      expect(result.length).toBe(500 + '... [truncated]'.length);
-      expect(result).toContain('... [truncated]');
-    });
-
-    it('uses default max length of 500', () => {
-      const content = 'a'.repeat(600);
-      const result = truncateForLog(content);
-      expect(result.startsWith('a'.repeat(500))).toBe(true);
-      expect(result).toContain('... [truncated]');
-    });
-
-    it('handles exact max length content', () => {
-      const content = 'a'.repeat(500);
-      expect(truncateForLog(content, 500)).toBe(content);
-    });
-  });
-
-  describe('summarizePayload', () => {
-    it('returns summary with preview, size, and hash', () => {
-      const content = 'test content for summarization';
-      const result = summarizePayload(content, 'test-type', 'test-id');
-
-      expect(result.preview).toBe(content);
-      expect(result.sizeBytes).toBe(Buffer.byteLength(content, 'utf8'));
-      expect(result.hash).toMatch(/^[a-f0-9]{12}$/);
-      expect(result.payloadFile).toBeUndefined();
-    });
-
-    it('truncates preview for large content', () => {
-      const content = 'x'.repeat(1000);
-      const result = summarizePayload(content, 'large', 'large-id');
-
-      expect(result.preview).toContain('... [truncated]');
-      expect(result.preview.length).toBeLessThan(content.length);
-    });
-
-    it('does not dump payload when dumpFull is false', () => {
-      const content = 'x'.repeat(20000); // Above threshold
-      const result = summarizePayload(content, 'type', 'id', false);
-
-      expect(result.payloadFile).toBeUndefined();
-      const payloadDir = join(tempDir, 'payload');
-      expect(existsSync(payloadDir)).toBe(false);
-    });
-
-    it('dumps payload to file when dumpFull is true and above threshold', () => {
-      const content = 'x'.repeat(20000); // Above 10KB threshold
-      const result = summarizePayload(content, 'dump-type', 'dump-id', true);
-
-      expect(result.payloadFile).toBeDefined();
-      expect(result.payloadFile).toContain('dump-type');
-      expect(result.payloadFile).toContain(result.hash);
-
-      const payloadDir = join(tempDir, 'payload');
-      expect(existsSync(payloadDir)).toBe(true);
-
-      const files = readdirSync(payloadDir);
-      expect(files.length).toBe(1);
-      expect(files[0]).toBe(result.payloadFile);
-
-      const fileContent = JSON.parse(readFileSync(join(payloadDir, files[0]), 'utf8'));
-      expect(fileContent.type).toBe('dump-type');
-      expect(fileContent.identifier).toBe('dump-id');
-      expect(fileContent.content).toBe(content);
-      expect(fileContent.sizeBytes).toBe(result.sizeBytes);
-    });
-
-    it('does not dump payload below threshold even with dumpFull true', () => {
-      const content = 'small content'; // Below 10KB threshold
-      const result = summarizePayload(content, 'small-type', 'small-id', true);
-
-      expect(result.payloadFile).toBeUndefined();
-    });
-
-    it('creates payload directory if it does not exist', () => {
-      const content = 'y'.repeat(20000);
-      const payloadDir = join(tempDir, 'payload');
-      expect(existsSync(payloadDir)).toBe(false);
-
-      summarizePayload(content, 'create-dir', 'create-id', true);
-
-      expect(existsSync(payloadDir)).toBe(true);
-    });
-
-    it('sanitizes identifier for filename', () => {
-      const content = 'z'.repeat(20000);
-      const result = summarizePayload(content, 'type', 'https://example.com/path?query=1', true);
-
-      expect(result.payloadFile).toBeDefined();
-      expect(result.payloadFile).not.toContain('://');
-      expect(result.payloadFile).not.toContain('?');
-    });
-
-    it('uses trace level check for dumpFull default', () => {
-      mockIsLevelEnabled.mockReturnValue(true);
-      const content = 'a'.repeat(20000);
-
-      const result = summarizePayload(content, 'trace-type', 'trace-id');
-
-      expect(mockIsLevelEnabled).toHaveBeenCalledWith('trace');
-      expect(result.payloadFile).toBeDefined();
-    });
-
-    it('generates consistent hash for same content', () => {
-      const content = 'consistent content';
-      const result1 = summarizePayload(content, 'type1', 'id1');
-      const result2 = summarizePayload(content, 'type2', 'id2');
-
-      expect(result1.hash).toBe(result2.hash);
-    });
-  });
-});