k0ntext 3.2.0 → 3.3.0

package/src/cli/repl/init/wizard.ts

@@ -0,0 +1,300 @@
+/**
+ * Init Wizard
+ *
+ * Interactive wizard for initializing k0ntext configuration
+ */
+
+import { input, confirm, select, checkbox } from '@inquirer/prompts';
+import chalk from 'chalk';
+import { ProjectType } from '../core/session.js';
+import { K0NTEXT_THEME } from '../tui/theme.js';
+
+/**
+ * Wizard configuration result
+ */
+export interface WizardConfig {
+  apiKey: string;
+  projectType: ProjectType;
+  aiTools: string[];
+  features: string[];
+  generateEmbeddings: boolean;
+}
+
+/**
+ * Project type options
+ */
+const PROJECT_TYPES: Array<{ value: ProjectType; name: string; description: string }> = [
+  { value: 'monorepo', name: 'Monorepo', description: 'Multiple packages/services in one repository' },
+  { value: 'webapp', name: 'Web Application', description: 'Frontend web application (React, Vue, etc.)' },
+  { value: 'api', name: 'API/Backend', description: 'Backend API service' },
+  { value: 'library', name: 'Library/Package', description: 'Reusable library or npm package' },
+  { value: 'cli', name: 'CLI Tool', description: 'Command-line interface tool' },
+  { value: 'unknown', name: 'Other', description: 'Other type of project' }
+];
+
+/**
+ * AI tool options
+ */
+const AI_TOOLS = [
+  { name: 'Claude Code', value: 'claude', description: 'Anthropic Claude with advanced reasoning' },
+  { name: 'GitHub Copilot', value: 'copilot', description: 'GitHub AI-powered code completion' },
+  { name: 'Cline', value: 'cline', description: 'Autonomous coding agent' },
+  { name: 'Cursor', value: 'cursor', description: 'AI code editor with integrated AI' },
+  { name: 'Windsurf', value: 'windsurf', description: 'AI-powered IDE with code understanding' },
+  { name: 'Aider', value: 'aider', description: 'AI pair programming in terminal' },
+  { name: 'Continue', value: 'continue', description: 'Open source AI autopilot' }
+];
+
+/**
+ * Feature options
+ */
+const FEATURES = [
+  { name: '📊 Statistics & Analytics', value: 'stats', description: 'Track code metrics and context usage' },
+  { name: '🔍 Semantic Search', value: 'search', description: 'AI-powered code search with embeddings' },
+  { name: '📝 Auto Documentation', value: 'docs', description: 'Generate documentation from code' },
+  { name: '🔄 Drift Detection', value: 'drift', description: 'Detect when docs are out of sync with code' },
+  { name: '🎯 Workflow Tracking', value: 'workflows', description: 'Track RPI workflows and tasks' },
+  { name: '🤖 MCP Integration', value: 'mcp', description: 'Model Context Protocol server' }
+];
+
+/**
+ * Init Wizard
+ */
+export class InitWizard {
+  private projectRoot: string;
+  private hasExistingKey: boolean;
+
+  constructor(projectRoot: string) {
+    this.projectRoot = projectRoot;
+    this.hasExistingKey = !!process.env.OPENROUTER_API_KEY;
+  }
+
+  /**
+   * Run the complete wizard
+   */
+  async run(): Promise<WizardConfig | null> {
+    this.showWelcome();
+
+    // Step 1: API Key
+    const apiKey = await this.stepApiKey();
+    if (!apiKey) {
+      console.log(K0NTEXT_THEME.warning('\n⚠ Initialization cancelled.'));
+      return null;
+    }
+
+    // Step 2: Project Type
+    const projectType = await this.stepProjectType();
+
+    // Step 3: AI Tools
+    const aiTools = await this.stepAITools();
+
+    // Step 4: Features
+    const features = await this.stepFeatures();
+
+    // Step 5: Embeddings
+    const generateEmbeddings = await this.stepEmbeddings();
+
+    // Show summary
+    const config: WizardConfig = {
+      apiKey,
+      projectType,
+      aiTools,
+      features,
+      generateEmbeddings
+    };
+
+    const confirmed = await this.showSummary(config);
+    if (!confirmed) {
+      console.log(K0NTEXT_THEME.warning('\n⚠ Initialization cancelled.'));
+      return null;
+    }
+
+    return config;
+  }
+
+  /**
+   * Show welcome message
+   */
+  private showWelcome(): void {
+    console.log('');
+    console.log(K0NTEXT_THEME.box(
+      'K0NTEXT INITIALIZATION',
+      `
+Welcome to K0ntext! This wizard will help you set up
+AI context engineering for your project.
+
+You'll be asked a few questions to configure K0ntext
+for your specific needs.
+      `.trim(),
+      'primary'
+    ));
+    console.log('');
+  }
+
+  /**
+   * Step 1: API Key
+   */
+  private async stepApiKey(): Promise<string | null> {
+    console.log('');
+    console.log(K0NTEXT_THEME.header('\n━━━ Step 1/5: OpenRouter API Key ━━━'));
+
+    if (this.hasExistingKey) {
+      console.log(K0NTEXT_THEME.success('\n✓ API key detected in OPENROUTER_API_KEY environment variable'));
+      const useExisting = await confirm({
+        message: 'Use existing API key?',
+        default: true
+      });
+
+      if (useExisting) {
+        return process.env.OPENROUTER_API_KEY!;
+      }
+    }
+
+    console.log('');
+    console.log(K0NTEXT_THEME.info('OpenRouter API key enables intelligent analysis and embeddings.'));
+    console.log(K0NTEXT_THEME.dim('Get your key at: https://openrouter.ai/keys'));
+
+    const apiKey = await input({
+      message: 'Enter your OpenRouter API key (or press Enter to skip):',
+      validate: (value: string) => {
+        if (!value) return true; // Allow skipping
+        if (value.startsWith('sk-or-v1-')) return true;
+        return 'Invalid API key format. Should start with "sk-or-v1-"';
+      }
+    });
+
+    if (!apiKey) {
+      const skipAnyway = await confirm({
+        message: 'Skip API key? You can add it later with "k0ntext config set apiKey"',
+        default: false
+      });
+
+      if (!skipAnyway) {
+        return null; // User wants to cancel
+      }
+    }
+
+    return apiKey || '';
+  }
+
+  /**
+   * Step 2: Project Type
+   */
+  private async stepProjectType(): Promise<ProjectType> {
+    console.log('');
+    console.log(K0NTEXT_THEME.header('\n━━━ Step 2/5: Project Type ━━━'));
+    console.log('');
+
+    const projectType = await select({
+      message: 'What type of project is this?',
+      choices: PROJECT_TYPES.map((t) => ({
+        name: `${t.name} - ${K0NTEXT_THEME.dim(t.description)}`,
+        value: t.value,
+        description: t.description
+      }))
+    });
+
+    return projectType as ProjectType;
+  }
+
+  /**
+   * Step 3: AI Tools
+   */
+  private async stepAITools(): Promise<string[]> {
+    console.log('');
+    console.log(K0NTEXT_THEME.header('\n━━━ Step 3/5: AI Tools ━━━'));
+    console.log('');
+    console.log(K0NTEXT_THEME.info('Select the AI coding assistants you want to configure:'));
+
+    const tools = await checkbox({
+      message: 'Select AI tools (use space to select, enter to continue):',
+      choices: AI_TOOLS.map((t) => ({
+        name: `${t.name} - ${K0NTEXT_THEME.dim(t.description)}`,
+        value: t.value,
+        checked: t.value === 'claude' // Default to Claude
+      }))
+    });
+
+    return tools.length > 0 ? tools : ['claude']; // Default to claude if none selected
+  }
+
+  /**
+   * Step 4: Features
+   */
+  private async stepFeatures(): Promise<string[]> {
+    console.log('');
+    console.log(K0NTEXT_THEME.header('\n━━━ Step 4/5: Features ━━━'));
+    console.log('');
+    console.log(K0NTEXT_THEME.info('Select the features you want to enable:'));
+
+    const features = await checkbox({
+      message: 'Select features (use space to select, enter to continue):',
+      choices: FEATURES.map((f) => ({
+        name: `${f.name} - ${K0NTEXT_THEME.dim(f.description)}`,
+        value: f.value,
+        checked: ['stats', 'search', 'mcp'].includes(f.value) // Default to core features
+      }))
+    });
+
+    return features.length > 0 ? features : ['stats', 'mcp'];
+  }
+
+  /**
+   * Step 5: Embeddings
+   */
+  private async stepEmbeddings(): Promise<boolean> {
+    console.log('');
+    console.log(K0NTEXT_THEME.header('\n━━━ Step 5/5: Embeddings ━━━'));
+    console.log('');
+    console.log(K0NTEXT_THEME.info('Generate semantic embeddings for AI-powered search?'));
+    console.log(K0NTEXT_THEME.dim('This will take a few minutes but greatly improves search quality.'));
+
+    const generate = await confirm({
+      message: 'Generate embeddings now?',
+      default: false
+    });
+
+    return generate;
+  }
+
+  /**
+   * Show summary and confirm
+   */
+  private async showSummary(config: WizardConfig): Promise<boolean> {
+    console.log('');
+    console.log(K0NTEXT_THEME.header('\n━━━ Configuration Summary ━━━'));
+    console.log('');
+
+    const typeInfo = PROJECT_TYPES.find(t => t.value === config.projectType);
+    console.log(`  ${K0NTEXT_THEME.primary('Project Type:')}  ${typeInfo?.name || config.projectType}`);
+    console.log(`  ${K0NTEXT_THEME.primary('API Key:')}        ${config.apiKey ? '✓ Configured' : '○ Skipped'}`);
+    console.log(`  ${K0NTEXT_THEME.primary('AI Tools:')}       ${config.aiTools.map(t => K0NTEXT_THEME.highlight(t)).join(', ')}`);
+    console.log(`  ${K0NTEXT_THEME.primary('Features:')}       ${config.features.map(f => {
+      const feat = FEATURES.find(ff => ff.value === f);
+      return feat?.name.split(' ')[0] || f;
+    }).join(', ')}`);
+    console.log(`  ${K0NTEXT_THEME.primary('Embeddings:')}     ${config.generateEmbeddings ? '✓ Yes' : '○ Later'}`);
+    console.log('');
+
+    return await confirm({
+      message: 'Initialize K0ntext with these settings?',
+      default: true
+    });
+  }
+
+  /**
+   * Show success message
+   */
+  showSuccess(config: WizardConfig): void {
+    console.log('');
+    console.log(K0NTEXT_THEME.success('\n✓ K0ntext initialized successfully!'));
+    console.log('');
+
+    console.log(K0NTEXT_THEME.header('Next Steps:'));
+    console.log(`  ${K0NTEXT_THEME.cyan('•')} Type ${K0NTEXT_THEME.highlight('stats')} to view database statistics`);
+    console.log(`  ${K0NTEXT_THEME.cyan('•')} Type ${K0NTEXT_THEME.highlight('index')} to index your codebase`);
+    console.log(`  ${K0NTEXT_THEME.cyan('•')} Type ${K0NTEXT_THEME.highlight('search <query>')} to search your code`);
+    console.log(`  ${K0NTEXT_THEME.cyan('•')} Type ${K0NTEXT_THEME.highlight('help')} for all available commands`);
+    console.log('');
+  }
+}

package/src/cli/repl/tui/theme.ts

@@ -0,0 +1,276 @@
+/**
+ * K0ntext Theme System
+ *
+ * Orange gradient with purple/pink/cyan accents for modern CLI experience
+ */
+
+import chalk from 'chalk';
+
+/**
+ * Terminal capabilities
+ */
+interface TerminalCapabilities {
+  isTTY: boolean;
+  supportsColor: boolean;
+  supports256: boolean;
+  supportsUnicode: boolean;
+}
+
+/**
+ * Chalk type aliases
+ */
+type ChalkColor = typeof chalk;
+
+/**
+ * K0ntext color theme
+ */
+export const K0NTEXT_THEME = {
+  // Orange gradient for primary elements
+  primary: chalk.hex('#F97316'),     // Orange-500
+  primaryLight: chalk.hex('#FB923C'), // Orange-400
+  primaryDark: chalk.hex('#EA580C'),  // Orange-600
+
+  // Purple accents for headers
+  header: chalk.hex('#8B5CF6'),       // Purple-500
+  headerLight: chalk.hex('#A78BFA'),  // Purple-400
+
+  // Pink for highlights
+  highlight: chalk.hex('#EC4899'),    // Pink-500
+  highlightLight: chalk.hex('#F472B6'), // Pink-400
+
+  // Cyan for status
+  status: chalk.hex('#06B6D4'),       // Cyan-500
+  statusLight: chalk.hex('#22D3EE'),  // Cyan-400
+  cyan: chalk.hex('#06B6D4'),         // Alias for cyan
+
+  // Semantic colors
+  success: chalk.green,
+  warning: chalk.yellow,
+  error: chalk.red,
+  info: chalk.blue,
+
+  // Neutrals
+  muted: chalk.gray,
+  dim: chalk.dim,
+
+  // Background colors
+  bgPrimary: chalk.bgHex('#F97316'),
+  bgHeader: chalk.bgHex('#8B5CF6'),
+  bgHighlight: chalk.bgHex('#EC4899'),
+  bgStatus: chalk.bgHex('#06B6D4'),
+
+  /**
+   * Detect terminal capabilities
+   */
+  detectCapabilities(): TerminalCapabilities {
+    const isTTY = process.stdout.isTTY;
+    const supportsColor = chalk.level > 0 && !process.env.NO_COLOR;
+    const supports256 = chalk.level >= 2;
+    const supportsUnicode = process.platform !== 'win32' ||
+      (process.env.TERM?.includes('xterm') || process.env.WT_SESSION);
+
+    return { isTTY: !!isTTY, supportsColor: !!supportsColor, supports256: !!supports256, supportsUnicode: !!supportsUnicode };
+  },
+
+  /**
+   * Get gradient string for logo/banner
+   */
+  gradientText(text: string): string {
+    const { supports256 } = this.detectCapabilities();
+
+    if (!supports256 || process.env.NO_COLOR) {
+      return this.primary(text);
+    }
+
+    // Create gradient effect using ANSI colors
+    const colors = ['#F97316', '#FBBF24', '#F472B6', '#8B5CF6', '#06B6D4'];
+    let result = '';
+    const chunkSize = Math.ceil(text.length / colors.length);
+
+    for (let i = 0; i < text.length; i++) {
+      const colorIndex = Math.floor(i / chunkSize) % colors.length;
+      const color = colors[colorIndex];
+      result += chalk.hex(color)(text[i]);
+    }
+
+    return result;
+  },
+
+  /**
+   * Get border characters based on terminal capabilities
+   */
+  getBorders() {
+    const { supportsUnicode } = this.detectCapabilities();
+
+    if (supportsUnicode) {
+      return {
+        topLeft: '╔',
+        topRight: '╗',
+        bottomLeft: '╚',
+        bottomRight: '╝',
+        horizontal: '═',
+        vertical: '║',
+        leftT: '╠',
+        rightT: '╣',
+        topT: '╦',
+        bottomT: '╩',
+        cross: '╬'
+      };
+    }
+
+    // ASCII fallback
+    return {
+      topLeft: '+',
+      topRight: '+',
+      bottomLeft: '+',
+      bottomRight: '+',
+      horizontal: '-',
+      vertical: '|',
+      leftT: '+',
+      rightT: '+',
+      topT: '+',
+      bottomT: '+',
+      cross: '+'
+    };
+  },
+
+  /**
+   * Create a styled box with text
+   */
+  box(title: string, content: string, borderColor = 'primary'): string {
+    const borders = this.getBorders();
+
+    // Get color function based on borderColor
+    let colorFn: ChalkColor;
+    switch (borderColor) {
+      case 'primary':
+        colorFn = this.primary;
+        break;
+      case 'header':
+        colorFn = this.header;
+        break;
+      case 'highlight':
+        colorFn = this.highlight;
+        break;
+      case 'status':
+        colorFn = this.status;
+        break;
+      case 'success':
+        colorFn = this.success;
+        break;
+      default:
+        colorFn = this.primary;
+    }
+
+    const lines = content.split('\n');
+    const maxLength = Math.max(title.length, ...lines.map(l => l.length));
+
+    let result = '';
+    result += colorFn(borders.topLeft + borders.horizontal.repeat(maxLength + 2) + borders.topRight) + '\n';
+    result += colorFn(borders.vertical) + ' ' + this.primary(title.padEnd(maxLength)) + ' ' + colorFn(borders.vertical) + '\n';
+    result += colorFn(borders.leftT + borders.horizontal.repeat(maxLength + 2) + borders.rightT) + '\n';
+
+    for (const line of lines) {
+      result += colorFn(borders.vertical) + ' ' + line.padEnd(maxLength) + ' ' + colorFn(borders.vertical) + '\n';
+    }
+
+    result += colorFn(borders.bottomLeft + borders.horizontal.repeat(maxLength + 2) + borders.bottomRight);
+
+    return result;
+  },
+
+  /**
+   * Create progress bar
+   */
+  progressBar(current: number, total: number, width = 20): string {
+    const percentage = Math.min(100, Math.max(0, (current / total) * 100));
+    const filled = Math.floor((percentage / 100) * width);
+    const empty = width - filled;
+
+    const filledBar = this.primary('█'.repeat(filled));
+    const emptyBar = this.dim('░'.repeat(empty));
+    const percentageText = ` ${Math.round(percentage)}%`;
+
+    return `${filledBar}${emptyBar}${percentageText}`;
+  },
+
+  /**
+   * Format file size with color
+   */
+  formatFileSize(bytes: number): string {
+    const units = ['B', 'KB', 'MB', 'GB'];
+    let size = bytes;
+    let unitIndex = 0;
+
+    while (size >= 1024 && unitIndex < units.length - 1) {
+      size /= 1024;
+      unitIndex++;
+    }
+
+    const rounded = Math.round(size * 10) / 10;
+    const colorFn = unitIndex < 2 ? this.success : this.warning;
+
+    return colorFn(`${rounded}${units[unitIndex]}`);
+  },
+
+  /**
+   * Format timestamp with color
+   */
+  formatTimestamp(date: Date): string {
+    const now = new Date();
+    const diff = now.getTime() - date.getTime();
+
+    const seconds = Math.floor(diff / 1000);
+    const minutes = Math.floor(seconds / 60);
+    const hours = Math.floor(minutes / 60);
+    const days = Math.floor(hours / 24);
+
+    if (seconds < 60) return this.success(`${seconds}s ago`);
+    if (minutes < 60) return this.status(`${minutes}m ago`);
+    if (hours < 24) return this.header(`${hours}h ago`);
+    return this.headerLight(`${days}d ago`);
+  }
+} as const;
+
+/**
+ * Terminal utility functions
+ */
+export const terminal = {
+  /**
+   * Clear screen
+   */
+  clear(): void {
+    console.clear();
+  },
+
+  /**
+   * Move cursor to position
+   */
+  moveTo(x: number, y: number): void {
+    process.stdout.write(`\x1b[${y};${x}H`);
+  },
+
+  /**
+   * Hide cursor
+   */
+  hideCursor(): void {
+    process.stdout.write('\x1b[?25l');
+  },
+
+  /**
+   * Show cursor
+   */
+  showCursor(): void {
+    process.stdout.write('\x1b[?25h');
+  },
+
+  /**
+   * Get terminal dimensions
+   */
+  getSize(): { width: number; height: number } {
+    return {
+      width: process.stdout.columns || 80,
+      height: process.stdout.rows || 24
+    };
+  }
+};