dotdotdot-cli 1.0.0

package/bin/dotdotdot.js

@@ -0,0 +1,170 @@
+#!/usr/bin/env node
+'use strict';
+
+// ─────────────────────────────────────────────────────────────────────────────
+// dotdotdot — plain English to terminal commands
+// ─────────────────────────────────────────────────────────────────────────────
+
+// ─── Global cleanup: restore terminal on any exit ───────────────────────────
+function cleanup() {
+  try {
+    if (process.stdin.isTTY && process.stdin.isRaw) process.stdin.setRawMode(false);
+    process.stdin.pause();
+    process.stdout.write('\x1b[?25h'); // restore cursor
+  } catch { /* ignore */ }
+}
+process.on('exit', cleanup);
+process.on('SIGINT', () => { cleanup(); process.exit(130); });
+process.on('SIGTERM', () => { cleanup(); process.exit(143); });
+
+const args = process.argv.slice(2);
+
+let userInput = '';
+let flags = {
+  task: false, help: false,
+  config: false, debug: false, version: false, usage: false,
+  resetTokens: false, clearSession: false,
+  provider: null,
+};
+
+for (let i = 0; i < args.length; i++) {
+  const a = args[i];
+  switch (a) {
+    case '-t': case '--task':    flags.task = true; break;
+    case '-p': case '--provider': if (args[i+1]) flags.provider = args[++i]; break;
+    case '-u': case '--usage':   flags.usage = true; break;
+    case '-c': case '--config':  flags.config = true; break;
+    case '-h': case '--help':    flags.help = true; break;
+    case '-d': case '--debug':   flags.debug = true; break;
+    case '-v': case '--version': flags.version = true; break;
+     case '--reset-usage':        flags.resetTokens = true; break;
+     case '--clear':              flags.clearSession = true; break;
+    default: if (!a.startsWith('-')) userInput += (userInput ? ' ' : '') + a; break;
+  }
+}
+
+(async () => {
+  try {
+    const pkg = require('../package.json');
+
+    if (flags.version) { console.log(pkg.version); process.exit(0); }
+    if (flags.resetTokens) {
+      require('../lib/tokens').resetUsage();
+      require('../lib/renderer').printSuccess('Token usage stats reset.');
+      process.exit(0);
+    }
+    if (flags.clearSession) {
+      require('../lib/session').clearSession();
+      require('../lib/renderer').printSuccess('Session cleared. Context will be fresh on next run.');
+      process.exit(0);
+    }
+    if (flags.usage) {
+      await require('../lib/tokens').printTokenStatsInteractive();
+      process.exit(0);
+    }
+    if (flags.help || !userInput.trim() && !flags.config) {
+      require('../lib/ui').printHelp(); process.exit(0);
+    }
+
+    const { loadConfig, resolveProvider, getAllProviderIds } = require('../lib/config');
+    const config = loadConfig();
+    if (flags.provider) {
+      const resolved = resolveProvider(flags.provider);
+      if (!resolved) {
+        require('../lib/renderer').printError(`Unknown provider "${flags.provider}". Use: ${getAllProviderIds().join(', ')}`);
+        process.exit(1);
+      }
+      config.provider = resolved;
+      const a = config.providers[resolved];
+      if (a) { config.apiKey = a.apiKey; config.model = a.model; config.apiUrl = a.apiUrl; }
+    }
+
+    if (flags.config) { await require('../lib/ui').printConfig(config); process.exit(0); }
+
+    if (!config.apiKey) {
+      const { printError } = require('../lib/renderer');
+      printError(`No API key for ${config.provider}. Run ${require('../lib/colors').cyan('... -c')}`);
+      process.exit(1);
+    }
+
+    // ─── Gather context ───────────────────────────────────────────────────
+    const { gatherContext } = require('../lib/context');
+    const { Spinner } = require('../lib/renderer');
+    const { detectMode, queryLLM } = require('../lib/llm');
+    const { setUserIntent } = require('../lib/session');
+    const { recordUsage } = require('../lib/tokens');
+
+    const t0 = Date.now();
+    const spin = new Spinner('...').start();
+    const context = await gatherContext();
+    const ctxMs = Date.now() - t0;
+
+    // ─── Detect mode ──────────────────────────────────────────────────────
+    const mode = flags.task ? 'task' : detectMode(userInput);
+
+    if (flags.debug) {
+      spin.succeed(`ctx ${ctxMs}ms | ${config.provider}/${config.model} | mode: ${mode}`);
+    }
+
+    // ─── Task mode ────────────────────────────────────────────────────────
+    if (mode === 'task') {
+      if (!flags.debug) spin.succeed('ready');
+      setUserIntent(userInput);
+      const { runTask } = require('../lib/planner');
+      await runTask(userInput, context, config, { debug: flags.debug });
+      return;
+    }
+
+    // ─── Quick mode ───────────────────────────────────────────────────────
+    spin.update('thinking...');
+    let result;
+    try {
+      result = await queryLLM(userInput, context, config, 'quick');
+    } catch (err) {
+      spin.fail(err.message);
+      if (flags.debug && err.debugLog) {
+        const { subtle } = require('../lib/renderer');
+        process.stderr.write(`  ${subtle('log: ' + err.debugLog)}\n`);
+      }
+      process.exit(1);
+    }
+
+    const totalMs = Date.now() - t0;
+
+    // Record token usage
+    const tokenUsage = result?._tokenUsage;
+    if (tokenUsage) {
+      recordUsage(tokenUsage, config.provider, config.model);
+    }
+
+    if (flags.debug) {
+      spin.succeed(`done ${totalMs}ms`);
+      if (result?._debugLog) {
+        const { subtle } = require('../lib/renderer');
+        process.stderr.write(`  ${subtle('log: ' + result._debugLog)}\n`);
+      }
+    } else {
+      spin.succeed('done');
+    }
+
+    if (!result?.command) {
+      require('../lib/renderer').printError('No command generated. Try rephrasing.');
+      process.exit(1);
+    }
+
+    setUserIntent(userInput);
+
+    if (config.autoExec) {
+      const { executeMode } = require('../lib/executor');
+      await executeMode(result, config);
+    } else {
+      const { interactiveMode } = require('../lib/executor');
+      await interactiveMode(result, config, context);
+    }
+
+  } catch (err) {
+    require('../lib/renderer').printError(err.message || 'Unexpected error');
+    if (flags.debug) console.error(err.stack);
+    process.exit(1);
+  }
+})();

package/lib/colors.js

@@ -0,0 +1,244 @@
+'use strict';
+
+// ─────────────────────────────────────────────────────────────────────────────
+// colors.js — Zero-dependency ANSI color & styling system
+// ─────────────────────────────────────────────────────────────────────────────
+
+const isColorSupported = (() => {
+  if (process.env.NO_COLOR) return false;
+  if (process.env.FORCE_COLOR) return true;
+  if (!process.stdout.isTTY) return false;
+  if (process.platform === 'win32') return true; // Windows 10+ supports ANSI
+  const term = process.env.TERM || '';
+  return term !== 'dumb';
+})();
+
+const wrap = (open, close) => {
+  if (!isColorSupported) return (s) => s;
+  return (s) => `\x1b[${open}m${s}\x1b[${close}m`;
+};
+
+const rgb = (r, g, b) => {
+  if (!isColorSupported) return (s) => s;
+  return (s) => `\x1b[38;2;${r};${g};${b}m${s}\x1b[39m`;
+};
+
+const bgRgb = (r, g, b) => {
+  if (!isColorSupported) return (s) => s;
+  return (s) => `\x1b[48;2;${r};${g};${b}m${s}\x1b[49m`;
+};
+
+const c256 = (n) => {
+  if (!isColorSupported) return (s) => s;
+  return (s) => `\x1b[38;5;${n}m${s}\x1b[39m`;
+};
+
+const bg256 = (n) => {
+  if (!isColorSupported) return (s) => s;
+  return (s) => `\x1b[48;5;${n}m${s}\x1b[49m`;
+};
+
+// ─── Core styles ─────────────────────────────────────────────────────────────
+
+const bold     = wrap(1, 22);
+const dim      = wrap(2, 22);
+const italic   = wrap(3, 23);
+const underline = wrap(4, 24);
+const inverse  = wrap(7, 27);
+const strikethrough = wrap(9, 29);
+
+// ─── Standard colors ─────────────────────────────────────────────────────────
+
+const black   = wrap(30, 39);
+const red     = wrap(31, 39);
+const green   = wrap(32, 39);
+const yellow  = wrap(33, 39);
+const blue    = wrap(34, 39);
+const magenta = wrap(35, 39);
+const cyan    = wrap(36, 39);
+const white   = wrap(37, 39);
+const gray    = wrap(90, 39);
+
+// ─── Bright colors ──────────────────────────────────────────────────────────
+
+const brightRed     = wrap(91, 39);
+const brightGreen   = wrap(92, 39);
+const brightYellow  = wrap(93, 39);
+const brightBlue    = wrap(94, 39);
+const brightMagenta = wrap(95, 39);
+const brightCyan    = wrap(96, 39);
+const brightWhite   = wrap(97, 39);
+
+// ─── Background colors ──────────────────────────────────────────────────────
+
+const bgBlack   = wrap(40, 49);
+const bgRed     = wrap(41, 49);
+const bgGreen   = wrap(42, 49);
+const bgYellow  = wrap(43, 49);
+const bgBlue    = wrap(44, 49);
+const bgMagenta = wrap(45, 49);
+const bgCyan    = wrap(46, 49);
+const bgWhite   = wrap(47, 49);
+
+// ─── Semantic colors (for the ... UI) ────────────────────────────────────────
+
+const themes = {
+  default: {
+    primary:    cyan,
+    secondary:  blue,
+    accent:     magenta,
+    success:    green,
+    warning:    yellow,
+    danger:     red,
+    info:       brightCyan,
+    muted:      dim,
+    highlight:  brightWhite,
+    command:    (s) => bold(brightWhite(s)),
+    step:       (s) => bold(cyan(s)),
+    stepNum:    (s) => bold(brightCyan(s)),
+    label:      (s) => bold(gray(s)),
+    value:      brightWhite,
+    separator:  (s) => gray(s),
+    box: {
+      border:   gray,
+      bg:       bg256(236),
+      title:    (s) => bold(cyan(s)),
+    },
+    spinner:    cyan,
+    prompt:     (s) => bold(cyan(s)),
+    selected:   (s) => bold(cyan(s)),
+    unselected: gray,
+  },
+  midnight: {
+    primary:    brightBlue,
+    secondary:  magenta,
+    accent:     brightMagenta,
+    success:    brightGreen,
+    warning:    brightYellow,
+    danger:     brightRed,
+    info:       brightCyan,
+    muted:      dim,
+    highlight:  brightWhite,
+    command:    (s) => bold(brightWhite(s)),
+    step:       (s) => bold(brightBlue(s)),
+    stepNum:    (s) => bold(brightMagenta(s)),
+    label:      (s) => bold(gray(s)),
+    value:      brightWhite,
+    separator:  (s) => gray(s),
+    box: {
+      border:   (s) => c256(60)(s),
+      bg:       bg256(234),
+      title:    (s) => bold(brightBlue(s)),
+    },
+    spinner:    brightMagenta,
+    prompt:     (s) => bold(brightBlue(s)),
+    selected:   (s) => bold(brightMagenta(s)),
+    unselected: gray,
+  },
+  minimal: {
+    primary:    white,
+    secondary:  gray,
+    accent:     white,
+    success:    green,
+    warning:    yellow,
+    danger:     red,
+    info:       white,
+    muted:      dim,
+    highlight:  bold,
+    command:    (s) => bold(s),
+    step:       (s) => bold(s),
+    stepNum:    (s) => bold(s),
+    label:      dim,
+    value:      (s) => s,
+    separator:  dim,
+    box: {
+      border:   dim,
+      bg:       (s) => s,
+      title:    bold,
+    },
+    spinner:    white,
+    prompt:     bold,
+    selected:   bold,
+    unselected: dim,
+  },
+};
+
+function getTheme(name) {
+  return themes[name] || themes.default;
+}
+
+// ─── Utility: strip ANSI ────────────────────────────────────────────────────
+
+function stripAnsi(s) {
+  // eslint-disable-next-line no-control-regex
+  return s.replace(/\x1b\[[0-9;]*m/g, '');
+}
+
+function visibleLength(s) {
+  return stripAnsi(s).length;
+}
+
+// ─── Symbols (with fallback for non-Unicode terminals) ──────────────────────
+
+const isUnicode = (() => {
+  const enc = (process.env.LANG || '').toLowerCase();
+  return process.platform === 'win32' || enc.includes('utf') || enc.includes('unicode');
+})();
+
+const symbols = {
+  dot:       isUnicode ? '\u2022' : '*',       // bullet
+  ellipsis:  isUnicode ? '\u2026' : '...',
+  arrow:     isUnicode ? '\u276F' : '>',        // ❯
+  arrowDown: isUnicode ? '\u25BC' : 'v',
+  arrowRight:isUnicode ? '\u25B6' : '>',
+  check:     isUnicode ? '\u2714' : '+',        // check mark
+  cross:     isUnicode ? '\u2718' : 'x',        // cross mark
+  warning:   isUnicode ? '\u26A0' : '!',        // warning sign
+  info:      isUnicode ? '\u2139' : 'i',        // info sign
+  star:      isUnicode ? '\u2605' : '*',
+  play:      isUnicode ? '\u25B6' : '>',
+  pause:     isUnicode ? '\u23F8' : '||',
+  gear:      isUnicode ? '\u2699' : '#',
+  lightning: isUnicode ? '\u26A1' : '!',
+  folder:    isUnicode ? '\uD83D\uDCC1' : '[D]',
+  file:      isUnicode ? '\uD83D\uDCC4' : '[F]',
+  lock:      isUnicode ? '\uD83D\uDD12' : '[L]',
+  rocket:    isUnicode ? '\uD83D\uDE80' : '=>',
+  // Box drawing
+  topLeft:    isUnicode ? '\u256D' : '+',
+  topRight:   isUnicode ? '\u256E' : '+',
+  bottomLeft: isUnicode ? '\u2570' : '+',
+  bottomRight:isUnicode ? '\u256F' : '+',
+  horizontal: isUnicode ? '\u2500' : '-',
+  vertical:   isUnicode ? '\u2502' : '|',
+  teeRight:   isUnicode ? '\u251C' : '|',
+  teeLeft:    isUnicode ? '\u2524' : '|',
+  // Spinner frames
+  spinnerFrames: isUnicode
+    ? ['\u280B','\u2819','\u2839','\u2838','\u283C','\u2834','\u2826','\u2827','\u2807','\u280F']
+    : ['-', '\\', '|', '/'],
+  // Step indicators
+  stepDone:    isUnicode ? '\u25C9' : '(x)',   // ◉
+  stepCurrent: isUnicode ? '\u25CB' : '( )',   // ○
+  stepPending: isUnicode ? '\u25CC' : '(.)',   // ◌
+  stepSkipped: isUnicode ? '\u25CB' : '(-)',
+};
+
+module.exports = {
+  // Core
+  isColorSupported,
+  wrap, rgb, bgRgb, c256, bg256,
+  // Styles
+  bold, dim, italic, underline, inverse, strikethrough,
+  // Colors
+  black, red, green, yellow, blue, magenta, cyan, white, gray,
+  brightRed, brightGreen, brightYellow, brightBlue, brightMagenta, brightCyan, brightWhite,
+  // Backgrounds
+  bgBlack, bgRed, bgGreen, bgYellow, bgBlue, bgMagenta, bgCyan, bgWhite,
+  // Theming
+  themes, getTheme,
+  // Utility
+  stripAnsi, visibleLength,
+  // Symbols
+  symbols,
+};

package/lib/config.js

@@ -0,0 +1,224 @@
+'use strict';
+
+// ─────────────────────────────────────────────────────────────────────────────
+// config.js — Configuration management with multi-provider support
+// ─────────────────────────────────────────────────────────────────────────────
+
+const fs   = require('fs');
+const path = require('path');
+const os   = require('os');
+
+const CONFIG_DIR  = path.join(os.homedir(), '.dotdotdot');
+const CONFIG_FILE = path.join(CONFIG_DIR, 'config.json');
+const CACHE_DIR   = path.join(CONFIG_DIR, 'cache');
+const DEBUG_DIR   = path.join(CONFIG_DIR, 'debug');
+const SESSION_DIR = path.join(CONFIG_DIR, 'sessions');
+
+// ─── Provider Defaults ──────────────────────────────────────────────────────
+
+const PROVIDERS = {
+  openrouter: {
+    name: 'OpenRouter',
+    apiUrl: 'https://openrouter.ai/api/v1/chat/completions',
+    model: 'google/gemma-4-26b-a4b-it',
+    envKeys: ['DOT_OPENROUTER_KEY'],
+    models: [
+      'google/gemma-4-26b-a4b-it',
+      'google/gemini-2.5-flash-preview:thinking',
+      'openai/gpt-4o-mini',
+      'anthropic/claude-3.5-haiku',
+      'meta-llama/llama-3.1-70b-instruct',
+      'google/gemini-2.0-flash-001',
+    ],
+  },
+  anthropic: {
+    name: 'Anthropic',
+    apiUrl: 'https://api.anthropic.com/v1/messages',
+    model: 'claude-haiku-4-5-20251001',
+    envKeys: ['DOT_ANTHROPIC_KEY'],
+    models: [
+      'claude-haiku-4-5-20251001',
+      'claude-sonnet-4-20250514',
+      'claude-3-5-haiku-20241022',
+    ],
+  },
+  openai: {
+    name: 'OpenAI',
+    apiUrl: 'https://api.openai.com/v1/chat/completions',
+    model: 'gpt-4o-mini',
+    envKeys: ['DOT_OPENAI_KEY'],
+    models: [
+      'gpt-4o-mini',
+      'gpt-4o',
+      'gpt-4-turbo',
+    ],
+  },
+  google: {
+    name: 'Google Gemini',
+    apiUrl: 'https://generativelanguage.googleapis.com/v1beta/models',
+    model: 'gemini-2.0-flash',
+    envKeys: ['DOT_GOOGLE_KEY'],
+    models: [
+      'gemini-2.0-flash',
+      'gemini-2.0-flash-lite',
+      'gemini-1.5-pro',
+    ],
+  },
+  custom: {
+    name: 'Custom',
+    apiUrl: '',
+    model: '',
+    envKeys: ['DOT_CUSTOM_KEY'],
+    models: [],
+  },
+};
+
+// ─── Ensure directories exist ────────────────────────────────────────────────
+
+function ensureDirs() {
+  for (const dir of [CONFIG_DIR, CACHE_DIR, DEBUG_DIR, SESSION_DIR]) {
+    if (!fs.existsSync(dir)) {
+      fs.mkdirSync(dir, { recursive: true });
+    }
+  }
+}
+
+// ─── Load config ────────────────────────────────────────────────────────────
+
+function loadConfig() {
+  ensureDirs();
+
+  let fileData = {};
+  try {
+    const raw = fs.readFileSync(CONFIG_FILE, 'utf8');
+    fileData = JSON.parse(raw);
+  } catch { /* no config file yet */ }
+
+  // Migrate old flat format
+  if (fileData.apiKey && !fileData.providers) {
+    fileData = {
+      provider: 'anthropic',
+      providers: {
+        anthropic: {
+          apiKey: fileData.apiKey,
+          model: fileData.model || PROVIDERS.anthropic.model,
+          apiUrl: fileData.apiUrl || PROVIDERS.anthropic.apiUrl,
+        },
+      },
+    };
+    _saveRaw(fileData);
+  }
+
+  // Build config
+  const config = {
+    provider:  fileData.provider || 'openrouter',
+    autoExec:  fileData.autoExec || false,
+    providers: {},
+    pricing:   fileData.pricing || {},
+  };
+
+  // Merge provider configs
+  for (const [id, defaults] of Object.entries(PROVIDERS)) {
+    const saved = (fileData.providers || {})[id] || {};
+    config.providers[id] = {
+      apiKey: saved.apiKey || '',
+      model:  saved.model  || defaults.model,
+      apiUrl: saved.apiUrl || defaults.apiUrl,
+    };
+  }
+
+  // Environment variable overrides
+  if (process.env.DOT_PROVIDER) {
+    config.provider = process.env.DOT_PROVIDER;
+  }
+
+  for (const [id, defaults] of Object.entries(PROVIDERS)) {
+    for (const envKey of defaults.envKeys) {
+      if (process.env[envKey]) {
+        config.providers[id].apiKey = process.env[envKey];
+        break;
+      }
+    }
+  }
+
+  if (process.env.DOT_MODEL) {
+    config.providers[config.provider].model = process.env.DOT_MODEL;
+  }
+
+  // Resolve active provider's values to top-level for convenience
+  const active = config.providers[config.provider] || {};
+  config.apiKey  = active.apiKey || '';
+  config.model   = active.model  || '';
+  config.apiUrl  = active.apiUrl || '';
+
+  return config;
+}
+
+// ─── Save config ────────────────────────────────────────────────────────────
+
+function saveConfig(config) {
+  ensureDirs();
+  const data = {
+    provider:  config.provider,
+    autoExec:  config.autoExec || false,
+    providers: {},
+    pricing:   config.pricing || {},
+  };
+  for (const [id, prov] of Object.entries(config.providers)) {
+    data.providers[id] = {
+      apiKey: prov.apiKey || '',
+      model:  prov.model  || '',
+      apiUrl: prov.apiUrl || '',
+    };
+  }
+  _saveRaw(data);
+}
+
+function _saveRaw(data) {
+  ensureDirs();
+  fs.writeFileSync(CONFIG_FILE, JSON.stringify(data, null, 2), { mode: 0o600 });
+}
+
+// ─── Utility ────────────────────────────────────────────────────────────────
+
+function maskKey(key) {
+  if (!key) return '(not set)';
+  if (key.length <= 8) return '****';
+  return key.slice(0, 4) + '...' + key.slice(-4);
+}
+
+function getProviderInfo(id) {
+  return PROVIDERS[id] || null;
+}
+
+function getAllProviderIds() {
+  return Object.keys(PROVIDERS);
+}
+
+// Resolve short names / aliases to provider id
+// e.g. "anthropic" "claude" "ant" → "anthropic"
+const ALIASES = {
+  or: 'openrouter', router: 'openrouter', openrouter: 'openrouter',
+  ant: 'anthropic', claude: 'anthropic', anthropic: 'anthropic',
+  oai: 'openai', gpt: 'openai', openai: 'openai',
+  gem: 'google', gemini: 'google', google: 'google',
+  custom: 'custom',
+};
+
+function resolveProvider(name) {
+  if (!name) return null;
+  const lower = name.toLowerCase().trim();
+  return ALIASES[lower] || (PROVIDERS[lower] ? lower : null);
+}
+
+module.exports = {
+  CONFIG_DIR, CONFIG_FILE, CACHE_DIR, DEBUG_DIR, SESSION_DIR,
+  PROVIDERS,
+  loadConfig,
+  saveConfig,
+  ensureDirs,
+  maskKey,
+  getProviderInfo,
+  getAllProviderIds,
+  resolveProvider,
+};