@operor/cli 0.1.0

package/src/config.ts

@@ -0,0 +1,127 @@
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+
+const ENV_PATH = resolve(process.cwd(), '.env');
+
+export interface AppConfig {
+  // LLM
+  LLM_PROVIDER?: string;
+  LLM_API_KEY?: string;
+  LLM_MODEL?: string;
+  LLM_BASE_URL?: string;
+  // Channel
+  CHANNEL?: string;
+  // Telegram
+  TELEGRAM_BOT_TOKEN?: string;
+  // Skills
+  SKILLS_ENABLED?: string;
+  // WATI
+  WATI_API_TOKEN?: string;
+  WATI_TENANT_ID?: string;
+  WATI_WEBHOOK_PORT?: string;
+  // Memory
+  MEMORY_TYPE?: string;
+  MEMORY_DB_PATH?: string;
+  // Intent
+  INTENT_CLASSIFIER?: string;
+  // Knowledge Base
+  KB_ENABLED?: string;
+  KB_DB_PATH?: string;
+  KB_EMBEDDING_PROVIDER?: string;
+  KB_EMBEDDING_MODEL?: string;
+  KB_EMBEDDING_API_KEY?: string;
+  KB_RENDER_JS?: string;
+  KB_CHUNK_SIZE?: string;
+  KB_CHUNK_OVERLAP?: string;
+  // Training Mode
+  TRAINING_MODE_ENABLED?: string;
+  TRAINING_MODE_WHITELIST?: string;
+  // Training Copilot
+  COPILOT_ENABLED?: string;
+  COPILOT_DB_PATH?: string;
+  COPILOT_TRACKING_THRESHOLD?: string;
+  COPILOT_CLUSTER_THRESHOLD?: string;
+  COPILOT_DIGEST_INTERVAL?: string;
+  COPILOT_DIGEST_MAX_ITEMS?: string;
+  COPILOT_AUTO_SUGGEST?: string;
+  // Analytics
+  ANALYTICS_ENABLED?: string;
+  ANALYTICS_DB_PATH?: string;
+  ANALYTICS_DIGEST_ENABLED?: string;
+  ANALYTICS_DIGEST_SCHEDULE?: string;
+  ANALYTICS_DIGEST_TIME?: string;
+  [key: string]: string | undefined;
+}
+
+export function configExists(): boolean {
+  return existsSync(ENV_PATH);
+}
+
+export function readConfig(): AppConfig {
+  if (!existsSync(ENV_PATH)) return {};
+  const content = readFileSync(ENV_PATH, 'utf-8');
+  const config: AppConfig = {};
+  for (const line of content.split('\n')) {
+    const trimmed = line.trim();
+    if (!trimmed || trimmed.startsWith('#')) continue;
+    const eqIndex = trimmed.indexOf('=');
+    if (eqIndex === -1) continue;
+    const key = trimmed.slice(0, eqIndex).trim();
+    const value = trimmed.slice(eqIndex + 1).trim();
+    config[key] = value;
+  }
+  return config;
+}
+
+export function writeConfig(config: AppConfig): void {
+  const lines: string[] = [
+    '# Operor Configuration',
+    '# Generated by operor setup',
+    '',
+  ];
+
+  const sections: { header: string; keys: string[] }[] = [
+    { header: 'LLM', keys: ['LLM_PROVIDER', 'LLM_API_KEY', 'LLM_MODEL', 'LLM_BASE_URL'] },
+    { header: 'Channel', keys: ['CHANNEL'] },
+    { header: 'Telegram', keys: ['TELEGRAM_BOT_TOKEN'] },
+    { header: 'Skills', keys: ['SKILLS_ENABLED'] },
+    { header: 'WATI', keys: ['WATI_API_TOKEN', 'WATI_TENANT_ID', 'WATI_WEBHOOK_PORT'] },
+    { header: 'Memory', keys: ['MEMORY_TYPE', 'MEMORY_DB_PATH'] },
+    { header: 'Intent', keys: ['INTENT_CLASSIFIER'] },
+    { header: 'Knowledge Base', keys: ['KB_ENABLED', 'KB_DB_PATH', 'KB_EMBEDDING_PROVIDER', 'KB_EMBEDDING_MODEL', 'KB_EMBEDDING_API_KEY', 'KB_RENDER_JS', 'KB_CHUNK_SIZE', 'KB_CHUNK_OVERLAP'] },
+    { header: 'Training Mode', keys: ['TRAINING_MODE_ENABLED', 'TRAINING_MODE_WHITELIST'] },
+    { header: 'Training Copilot', keys: ['COPILOT_ENABLED', 'COPILOT_DB_PATH', 'COPILOT_TRACKING_THRESHOLD', 'COPILOT_CLUSTER_THRESHOLD', 'COPILOT_DIGEST_INTERVAL', 'COPILOT_DIGEST_MAX_ITEMS', 'COPILOT_AUTO_SUGGEST'] },
+    { header: 'Analytics', keys: ['ANALYTICS_ENABLED', 'ANALYTICS_DB_PATH', 'ANALYTICS_DIGEST_ENABLED', 'ANALYTICS_DIGEST_SCHEDULE', 'ANALYTICS_DIGEST_TIME'] },
+  ];
+
+  const knownKeys = new Set<string>();
+  for (const section of sections) {
+    const sectionLines: string[] = [];
+    for (const key of section.keys) {
+      knownKeys.add(key);
+      if (config[key]) {
+        sectionLines.push(`${key}=${config[key]}`);
+      }
+    }
+    if (sectionLines.length > 0) {
+      lines.push(`# ${section.header}`);
+      lines.push(...sectionLines);
+      lines.push('');
+    }
+  }
+
+  // Preserve any extra keys not covered by known sections
+  const extraLines: string[] = [];
+  for (const [key, value] of Object.entries(config)) {
+    if (value && !knownKeys.has(key)) {
+      extraLines.push(`${key}=${value}`);
+    }
+  }
+  if (extraLines.length > 0) {
+    lines.push('# Other');
+    lines.push(...extraLines);
+    lines.push('');
+  }
+
+  writeFileSync(ENV_PATH, lines.join('\n'));
+}

package/src/index.ts

@@ -0,0 +1,190 @@
+import './log-timestamps.js';
+import { Command } from 'commander';
+import { configExists } from './config.js';
+import { runSetup, runQuickSetup } from './setup.js';
+import { startOperor } from './start.js';
+
+const program = new Command();
+
+program
+  .name('operor')
+  .description('Operor - AI Agent Operating System')
+  .version('0.1.0');
+
+program
+  .command('setup')
+  .description('Run the interactive setup wizard')
+  .option('--quick', 'Quick setup with sensible defaults (3 questions)')
+  .action(async (opts) => {
+    if (opts.quick) {
+      await runQuickSetup();
+    } else {
+      await runSetup();
+    }
+    await startOperor();
+  });
+
+program
+  .command('start')
+  .description('Start Operor with existing configuration')
+  .action(async () => {
+    if (!configExists()) {
+      console.error('No configuration found. Run "operor setup" first.');
+      process.exit(1);
+    }
+    await startOperor();
+  });
+
+program
+  .command('status')
+  .description('Show Operor configuration status')
+  .action(async () => {
+    const { runStatus } = await import('./commands/status.js');
+    await runStatus();
+  });
+
+program
+  .command('doctor')
+  .description('Validate Operor configuration and test connections')
+  .action(async () => {
+    const { runDoctor } = await import('./commands/doctor.js');
+    await runDoctor();
+  });
+
+program
+  .command('test')
+  .description('Run Operor test scenarios')
+  .option('--csv <path>', 'Load test cases from a CSV file')
+  .option('--tag <tag>', 'Filter test cases by tag')
+  .option('--report <path>', 'Save JSON results to file')
+  .option('--real', 'Use real skills instead of mocks')
+  .option('--allow-writes', 'Allow write operations with real skills')
+  .option('--dry-run', 'Real reads, mock writes')
+  .action(async (opts) => {
+    const { runTest } = await import('./commands/test.js');
+    await runTest(opts);
+  });
+
+program
+  .command('test-suite <file>')
+  .description('Run a test suite from a CSV or JSON file')
+  .option('--strategy <type>', 'Evaluation strategy: exact, contains, semantic', 'contains')
+  .option('--timeout <ms>', 'Per-test timeout in milliseconds', parseInt)
+  .option('--parallel', 'Run tests in parallel')
+  .option('--verbose', 'Show detailed output for failed tests')
+  .option('--json', 'Output results as JSON')
+  .option('--real', 'Use real skills instead of mocks')
+  .option('--allow-writes', 'Allow write operations with real skills')
+  .option('--dry-run', 'Real reads, mock writes')
+  .option('--llm', 'Use LLM-based agent processing instead of pattern matcher')
+  .action(async (file, opts) => {
+    const { runTestSuite } = await import('./commands/test-suite.js');
+    await runTestSuite(file, opts);
+  });
+
+program
+  .command('converse [scenario]')
+  .description('Run multi-turn conversation test scenarios')
+  .option('--file <path>', 'Load scenarios from a JSON file')
+  .option('--turns <n>', 'Override max turns per scenario', parseInt)
+  .option('--persona <style>', 'Override persona (polite|frustrated|confused|terse|verbose)')
+  .option('--verbose', 'Show full conversation transcripts')
+  .option('--json', 'Output results as JSON')
+  .option('--real', 'Use real skills instead of mocks')
+  .option('--allow-writes', 'Allow write operations with real skills')
+  .option('--dry-run', 'Real reads, mock writes')
+  .action(async (scenario, opts) => {
+    const { runConverse } = await import('./commands/converse.js');
+    await runConverse({ scenario, ...opts });
+  });
+
+program
+  .command('simulate')
+  .description('Run pre-deployment simulation (test suites + conversation scenarios)')
+  .option('--tests <files...>', 'CSV/JSON test suite files to include')
+  .option('--scenarios <names...>', 'Scenario names to run (or "all" for built-in)')
+  .option('--conversations <n>', 'Number of conversations to run (default: 10)', parseInt)
+  .option('--strategy <type>', 'Evaluation strategy: exact, similarity, llm_judge', 'similarity')
+  .option('--real', 'Use real skills instead of mocks')
+  .option('--allow-writes', 'Allow write operations with real skills')
+  .option('--dry-run', 'Real reads, mock writes')
+  .option('--timeout <ms>', 'Per-test timeout in milliseconds', parseInt)
+  .option('--parallel', 'Run tests in parallel')
+  .option('--json', 'Output full report as JSON')
+  .option('--report <file>', 'Save detailed JSON report to file')
+  .action(async (opts) => {
+    const { runSimulate } = await import('./commands/simulate.js');
+    await runSimulate({ ...opts, output: opts.report });
+  });
+
+// Knowledge Base commands
+import { registerKBCommand } from './commands/kb.js';
+registerKBCommand(program);
+
+// Analytics commands
+import { registerAnalyticsCommand } from './commands/analytics.js';
+registerAnalyticsCommand(program);
+
+// History commands
+import { registerHistoryCommand } from './commands/history.js';
+registerHistoryCommand(program);
+
+// Chat command
+import { registerChatCommand } from './commands/chat.js';
+registerChatCommand(program);
+
+// Init command
+import { registerInitCommand } from './commands/init.js';
+registerInitCommand(program);
+
+program
+  .command('reset')
+  .description('Delete all data (KB, memory, analytics, copilot, skills, auth) to start fresh')
+  .option('--yes', 'Skip confirmation prompt')
+  .option('--keep-config', 'Keep .env and mcp.json, only delete databases')
+  .action(async (opts) => {
+    const { runReset } = await import('./commands/reset.js');
+    await runReset(opts);
+  });
+
+program
+  .command('vibe [action]')
+  .description('AI-powered agent copilot for creating and customizing agents')
+  .option('--agent <name>', 'Target a specific agent')
+  .action(async (action, opts) => {
+    const { runVibe } = await import('./commands/vibe.js');
+    await runVibe({ action, agent: opts.agent });
+  });
+
+const configCmd = program.command('config').description('View and modify configuration');
+configCmd
+  .command('show')
+  .description('Show current config')
+  .action(async () => {
+    const { showConfig } = await import('./commands/config.js');
+    showConfig();
+  });
+configCmd
+  .command('set <key> <value>')
+  .description('Set a config value')
+  .action(async (k, v) => {
+    const { setConfigValue } = await import('./commands/config.js');
+    setConfigValue(k, v);
+  });
+configCmd
+  .command('unset <key>')
+  .description('Remove a config value')
+  .action(async (k) => {
+    const { unsetConfigValue } = await import('./commands/config.js');
+    unsetConfigValue(k);
+  });
+
+// Default action: setup if no config, otherwise start
+program.action(async () => {
+  if (!configExists()) {
+    await runSetup();
+  }
+  await startOperor();
+});
+
+program.parse();

package/src/log-timestamps.ts

@@ -0,0 +1,26 @@
+/**
+ * Global console override that prepends timestamps to all log output.
+ * Format: [YYYY-MM-DD HH:mm:ss.SSS] — similar to NLog/structured logging.
+ *
+ * Import this file once at the entry point (index.ts) for automatic timestamps.
+ */
+
+const originalLog = console.log;
+const originalWarn = console.warn;
+const originalError = console.error;
+
+function timestamp(): string {
+  const now = new Date();
+  const y = now.getFullYear();
+  const mo = String(now.getMonth() + 1).padStart(2, '0');
+  const d = String(now.getDate()).padStart(2, '0');
+  const h = String(now.getHours()).padStart(2, '0');
+  const mi = String(now.getMinutes()).padStart(2, '0');
+  const s = String(now.getSeconds()).padStart(2, '0');
+  const ms = String(now.getMilliseconds()).padStart(3, '0');
+  return `[${y}-${mo}-${d} ${h}:${mi}:${s}.${ms}]`;
+}
+
+console.log = (...args: any[]) => originalLog(timestamp(), ...args);
+console.warn = (...args: any[]) => originalWarn(timestamp(), ...args);
+console.error = (...args: any[]) => originalError(timestamp(), ...args);