@luquimbo/bi-superpowers 3.1.1 → 4.1.0

package/bin/utils/projects.js

@@ -1,169 +0,0 @@
-/**
- * Projects Utility
- * =================
- *
- * Shared functions for working with bi-repo projects.
- * Extracted from add.js, pull.js, push.js to reduce duplication.
- *
- * @module utils/projects
- */
-
-const fs = require('fs');
-const path = require('path');
-
-/**
- * Get a specific project by name
- * @param {string} repoPath - Path to bi-repo
- * @param {string} projectName - Name of the project
- * @returns {Object|null} Project config with projectPath added, or null
- */
-function getProject(repoPath, projectName) {
-  const projectPath = path.join(repoPath, 'projects', projectName);
-  const configPath = path.join(projectPath, 'project.json');
-
-  if (!fs.existsSync(configPath)) {
-    return null;
-  }
-
-  try {
-    const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
-    return {
-      ...config,
-      projectPath,
-    };
-  } catch (e) {
-    // Invalid JSON in config file
-    if (process.env.DEBUG === 'true') {
-      console.error(`[DEBUG] Failed to parse project config: ${configPath}`);
-    }
-    return null;
-  }
-}
-
-/**
- * Get list of all projects in the repo
- * @param {string} repoPath - Path to bi-repo
- * @returns {Object[]} Array of project configs with projectPath added
- */
-function getAllProjects(repoPath) {
-  const projectsDir = path.join(repoPath, 'projects');
-
-  if (!fs.existsSync(projectsDir)) {
-    return [];
-  }
-
-  const projects = [];
-  const dirs = fs.readdirSync(projectsDir);
-
-  for (const dir of dirs) {
-    const projectPath = path.join(projectsDir, dir);
-
-    // Skip if not a directory
-    try {
-      if (!fs.statSync(projectPath).isDirectory()) {
-        continue;
-      }
-    } catch (e) {
-      continue;
-    }
-
-    const configPath = path.join(projectPath, 'project.json');
-
-    if (fs.existsSync(configPath)) {
-      try {
-        const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
-        projects.push({
-          ...config,
-          projectPath,
-        });
-      } catch (e) {
-        // Warn user about broken config so they can fix it
-        console.warn(`⚠ Config de proyecto inválido en ${configPath}: ${e.message}`);
-        if (process.env.DEBUG === 'true') {
-          console.error('[DEBUG] Full error:', e);
-        }
-      }
-    }
-  }
-
-  return projects;
-}
-
-/**
- * Detect current project based on working directory
- * @param {string} repoPath - Path to bi-repo
- * @returns {Object|null} Project config or null if not in a project folder
- */
-function detectCurrentProject(repoPath) {
-  const cwd = process.cwd();
-  const projectsBase = path.join(repoPath, 'projects');
-
-  // Check if we're inside a project folder
-  if (cwd.startsWith(projectsBase)) {
-    const relative = path.relative(projectsBase, cwd);
-    const projectName = relative.split(path.sep)[0];
-
-    if (projectName && projectName !== '..') {
-      return getProject(repoPath, projectName);
-    }
-  }
-
-  return null;
-}
-
-/**
- * List project names
- * @param {string} repoPath - Path to bi-repo
- * @returns {string[]} Array of project names
- */
-function listProjectNames(repoPath) {
-  return getAllProjects(repoPath).map((p) => p.name);
-}
-
-/**
- * Check if a project exists
- * @param {string} repoPath - Path to bi-repo
- * @param {string} projectName - Name of the project
- * @returns {boolean} True if project exists
- */
-function projectExists(repoPath, projectName) {
-  const projectPath = path.join(repoPath, 'projects', projectName);
-  const configPath = path.join(projectPath, 'project.json');
-  return fs.existsSync(configPath);
-}
-
-/**
- * Get project path
- * @param {string} repoPath - Path to bi-repo
- * @param {string} projectName - Name of the project
- * @returns {string} Path to project directory
- */
-function getProjectPath(repoPath, projectName) {
-  return path.join(repoPath, 'projects', projectName);
-}
-
-/**
- * Print available projects to console
- * @param {string} repoPath - Path to bi-repo
- * @param {string} prefix - Prefix for each line (default: '  - ')
- */
-function printAvailableProjects(repoPath, prefix = '  - ') {
-  const projects = getAllProjects(repoPath);
-  if (projects.length === 0) {
-    console.log(`${prefix}(no projects found)`);
-  } else {
-    projects.forEach((p) => {
-      console.log(`${prefix}${p.name}`);
-    });
-  }
-}
-
-module.exports = {
-  getProject,
-  getAllProjects,
-  detectCurrentProject,
-  listProjectNames,
-  projectExists,
-  getProjectPath,
-  printAvailableProjects,
-};

package/bin/utils/readline.js

@@ -1,206 +0,0 @@
-/**
- * Readline Utilities for BI Agent Superpowers
- * ============================================
- *
- * Shared readline functions for interactive CLI commands.
- * Consolidates duplicated code from setup.js, add.js, sync-source.js, sync-profile.js
- *
- * @module utils/readline
- */
-
-const readline = require('readline');
-
-/**
- * Create a readline interface for interactive prompts
- * @returns {readline.Interface} Readline interface
- */
-function createReadline() {
-  return readline.createInterface({
-    input: process.stdin,
-    output: process.stdout,
-  });
-}
-
-/**
- * Prompt the user for input
- * @param {readline.Interface} rl - Readline interface
- * @param {string} question - Question to ask
- * @returns {Promise<string>} User's answer (trimmed)
- */
-function prompt(rl, question) {
-  return new Promise((resolve) => {
-    rl.question(question, (answer) => {
-      resolve(answer.trim());
-    });
-  });
-}
-
-/**
- * Ask for yes/no confirmation
- * @param {readline.Interface} rl - Readline interface
- * @param {string} question - Question to ask (without y/n suffix)
- * @param {boolean} defaultValue - Default value if user just presses Enter
- * @returns {Promise<boolean>} True if confirmed, false otherwise
- */
-function confirm(rl, question, defaultValue = false) {
-  const suffix = defaultValue ? ' (S/n): ' : ' (s/N): ';
-  return new Promise((resolve) => {
-    rl.question(question + suffix, (answer) => {
-      const trimmed = answer.trim().toLowerCase();
-      if (trimmed === '') {
-        resolve(defaultValue);
-      } else {
-        resolve(trimmed === 's' || trimmed === 'y' || trimmed === 'si' || trimmed === 'yes');
-      }
-    });
-  });
-}
-
-/**
- * Ask user to select from a list of options
- * @param {readline.Interface} rl - Readline interface
- * @param {string} question - Question to ask
- * @param {string[]} options - Array of option strings
- * @param {number} defaultIndex - Default option index (0-based)
- * @returns {Promise<{index: number, value: string}>} Selected option
- */
-async function select(rl, question, options, defaultIndex = 0) {
-  console.log(`\n${question}\n`);
-
-  options.forEach((option, i) => {
-    const marker = i === defaultIndex ? '>' : ' ';
-    console.log(`  ${marker} ${i + 1}. ${option}`);
-  });
-
-  console.log('');
-
-  const answer = await prompt(rl, `Elige una opción (1-${options.length}) [${defaultIndex + 1}]: `);
-
-  if (answer === '') {
-    return { index: defaultIndex, value: options[defaultIndex] };
-  }
-
-  const num = parseInt(answer, 10);
-  if (isNaN(num) || num < 1 || num > options.length) {
-    console.log('Opción no válida, usando la predeterminada.');
-    return { index: defaultIndex, value: options[defaultIndex] };
-  }
-
-  return { index: num - 1, value: options[num - 1] };
-}
-
-/**
- * Ask user to select multiple options from a list
- * @param {readline.Interface} rl - Readline interface
- * @param {string} question - Question to ask
- * @param {Array<{label: string, value: any, selected?: boolean}>} options - Options with labels and values
- * @returns {Promise<any[]>} Array of selected values
- */
-async function multiSelect(rl, question, options) {
-  console.log(`\n${question}\n`);
-  console.log('  Instrucciones:');
-  console.log('  - Escribe números separados por comas (ej: 1,3,5)');
-  console.log('  - "a" para seleccionar todos');
-  console.log('  - "n" para deseleccionar todos');
-  console.log('  - Enter para confirmar selección actual\n');
-
-  // Show options with current selection
-  options.forEach((option, i) => {
-    const marker = option.selected ? '[x]' : '[ ]';
-    console.log(`  ${marker} ${i + 1}. ${option.label}`);
-  });
-
-  console.log('');
-
-  const answer = await prompt(rl, 'Selección: ');
-
-  if (answer.toLowerCase() === 'a') {
-    return options.map((o) => o.value);
-  }
-
-  if (answer.toLowerCase() === 'n' || answer === '') {
-    return options.filter((o) => o.selected).map((o) => o.value);
-  }
-
-  // Parse comma-separated numbers
-  const indices = answer
-    .split(',')
-    .map((s) => parseInt(s.trim(), 10) - 1)
-    .filter((n) => !isNaN(n) && n >= 0 && n < options.length);
-
-  return indices.map((i) => options[i].value);
-}
-
-/**
- * Show a spinner while executing an async operation
- * @param {string} message - Message to show
- * @param {Promise} promise - Promise to wait for
- * @returns {Promise} Result of the promise
- */
-async function withSpinner(message, promise) {
-  const frames = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
-  let i = 0;
-
-  const interval = setInterval(() => {
-    process.stdout.write(`\r${frames[i]} ${message}`);
-    i = (i + 1) % frames.length;
-  }, 80);
-
-  try {
-    const result = await promise;
-    clearInterval(interval);
-    process.stdout.write(`\r✓ ${message}\n`);
-    return result;
-  } catch (error) {
-    clearInterval(interval);
-    process.stdout.write(`\r✗ ${message}\n`);
-    throw error;
-  }
-}
-
-/**
- * Exit with error message
- * @param {string} message - Error message
- * @param {number} code - Exit code (default 1)
- */
-function exitWithError(message, code = 1) {
-  console.error(`\n✗ ${message}\n`);
-  process.exit(code);
-}
-
-/**
- * Show success message
- * @param {string} message - Success message
- */
-function showSuccess(message) {
-  console.log(`✓ ${message}`);
-}
-
-/**
- * Show warning message
- * @param {string} message - Warning message
- */
-function showWarning(message) {
-  console.log(`⚠ ${message}`);
-}
-
-/**
- * Show info message
- * @param {string} message - Info message
- */
-function showInfo(message) {
-  console.log(`ℹ ${message}`);
-}
-
-module.exports = {
-  createReadline,
-  prompt,
-  confirm,
-  select,
-  multiSelect,
-  withSpinner,
-  exitWithError,
-  showSuccess,
-  showWarning,
-  showInfo,
-};

package/bin/utils/readline.test.js

@@ -1,47 +0,0 @@
-/**
- * Tests for Readline Utilities
- * @module utils/readline.test
- */
-
-const { test, describe } = require('node:test');
-const assert = require('node:assert');
-
-const readline = require('./readline');
-
-describe('Readline Utilities', () => {
-  test('exports createReadline function', () => {
-    assert.strictEqual(typeof readline.createReadline, 'function');
-  });
-
-  test('exports prompt function', () => {
-    assert.strictEqual(typeof readline.prompt, 'function');
-  });
-
-  test('exports confirm function', () => {
-    assert.strictEqual(typeof readline.confirm, 'function');
-  });
-
-  test('exports select function', () => {
-    assert.strictEqual(typeof readline.select, 'function');
-  });
-
-  test('exports multiSelect function', () => {
-    assert.strictEqual(typeof readline.multiSelect, 'function');
-  });
-
-  test('exports exitWithError function', () => {
-    assert.strictEqual(typeof readline.exitWithError, 'function');
-  });
-
-  test('exports showSuccess function', () => {
-    assert.strictEqual(typeof readline.showSuccess, 'function');
-  });
-
-  test('exports showWarning function', () => {
-    assert.strictEqual(typeof readline.showWarning, 'function');
-  });
-
-  test('exports showInfo function', () => {
-    assert.strictEqual(typeof readline.showInfo, 'function');
-  });
-});

package/bin/utils/tui.test.js

@@ -1,127 +0,0 @@
-/**
- * Unit tests for the TUI (Terminal UI) utilities
- *
- * Run with: npm test
- */
-
-const { test, describe } = require('node:test');
-const assert = require('node:assert');
-
-// Import TUI module if available
-let tui;
-try {
-  tui = require('./tui');
-} catch (e) {
-  // TUI module may not be available in all environments
-  tui = null;
-}
-
-describe('TUI Utilities', () => {
-  test('truncate should limit string length', () => {
-    // Basic truncation logic
-    const truncate = (str, maxLen) => {
-      if (str.length <= maxLen) return str;
-      return str.substring(0, maxLen - 3) + '...';
-    };
-
-    const longText = 'This is a very long text that should be truncated';
-    const truncated = truncate(longText, 20);
-
-    assert.ok(truncated.length <= 20, 'Truncated text should not exceed max length');
-    assert.ok(truncated.endsWith('...'), 'Truncated text should end with ellipsis');
-  });
-
-  test('formatPath should handle library paths', () => {
-    // Basic path formatting logic
-    const formatPath = (filePath) => {
-      const libraryIndex = filePath.indexOf('library');
-      if (libraryIndex !== -1) {
-        return filePath.substring(libraryIndex);
-      }
-      return filePath;
-    };
-
-    const fullPath = '/Users/test/.bi-superpowers/library/snippets/dax/time-intelligence.md';
-    const formatted = formatPath(fullPath);
-
-    assert.ok(formatted.startsWith('library'), 'Should start with library');
-    assert.ok(!formatted.includes('/Users/'), 'Should not include user path');
-  });
-
-  test('icons object should have required icons', () => {
-    const requiredIcons = ['success', 'error', 'warning', 'info', 'bullet'];
-
-    // Mock icons object
-    const icons = {
-      success: '✓',
-      error: '✗',
-      warning: '⚠',
-      info: 'ℹ',
-      bullet: '•',
-      watch: '👁',
-    };
-
-    requiredIcons.forEach((icon) => {
-      assert.ok(icons[icon], `Should have ${icon} icon`);
-    });
-  });
-});
-
-describe('Table Formatting', () => {
-  test('table should have headers and rows', () => {
-    const headers = ['Metric', 'Count'];
-    const rows = [
-      ['Files checked', '10'],
-      ['Errors', '0'],
-      ['Warnings', '2'],
-    ];
-
-    assert.strictEqual(headers.length, 2, 'Should have 2 headers');
-    assert.strictEqual(rows.length, 3, 'Should have 3 rows');
-    assert.strictEqual(rows[0].length, headers.length, 'Rows should match header count');
-  });
-});
-
-describe('Color Functions', () => {
-  test('color names should be defined', () => {
-    const colorNames = ['primary', 'success', 'error', 'warning', 'info', 'muted', 'highlight'];
-
-    // Mock colors object
-    const colors = {
-      primary: (s) => s,
-      success: (s) => s,
-      error: (s) => s,
-      warning: (s) => s,
-      info: (s) => s,
-      muted: (s) => s,
-      highlight: (s) => s,
-    };
-
-    colorNames.forEach((color) => {
-      assert.ok(typeof colors[color] === 'function', `${color} should be a function`);
-    });
-  });
-
-  test('color functions should return strings', () => {
-    // Mock color function
-    const colorFn = (str) => `\x1b[32m${str}\x1b[0m`;
-    const result = colorFn('test');
-
-    assert.strictEqual(typeof result, 'string', 'Color function should return string');
-    assert.ok(result.includes('test'), 'Result should include original text');
-  });
-});
-
-describe('Diff Display', () => {
-  test('diff add should format additions', () => {
-    const formatAdd = (line) => `+ ${line}`;
-    const result = formatAdd('new line');
-    assert.ok(result.startsWith('+'), 'Addition should start with +');
-  });
-
-  test('diff remove should format deletions', () => {
-    const formatRemove = (line) => `- ${line}`;
-    const result = formatRemove('old line');
-    assert.ok(result.startsWith('-'), 'Deletion should start with -');
-  });
-});

package/docs/openrouter-free-models.md

@@ -1,92 +0,0 @@
-# Configure Claude Code with OpenRouter (Free Models)
-
-Use free AI models with Claude Code CLI and 1code.dev via OpenRouter.
-
-## Prerequisites
-
-- Node.js installed
-- Claude Code CLI installed (`npm install -g @anthropic-ai/claude-code`)
-- Free account at [openrouter.ai](https://openrouter.ai)
-
-## Step 1: Create OpenRouter API Key
-
-1. Go to [openrouter.ai](https://openrouter.ai) and create account (free)
-2. Go to [openrouter.ai/keys](https://openrouter.ai/keys)
-3. Click "Create Key"
-4. Copy the key (starts with `sk-or-v1-...`)
-
-## Step 2: Configure Environment Variables
-
-Add to the end of `~/.zshrc` (macOS/Linux) or your shell profile:
-
-```bash
-# OpenRouter + Claude Code
-export ANTHROPIC_BASE_URL="https://openrouter.ai/api"
-export ANTHROPIC_AUTH_TOKEN="sk-or-v1-YOUR-KEY-HERE"
-export ANTHROPIC_API_KEY=""
-```
-
-> **Important**: `ANTHROPIC_API_KEY` MUST be empty (`""`). If it doesn't exist, Claude Code will try to authenticate with Anthropic directly.
-
-Then reload the shell:
-
-```bash
-source ~/.zshrc
-```
-
-## Step 3: Sign Out of Anthropic (if needed)
-
-If you previously used Claude Code with an Anthropic account:
-
-```bash
-claude
-# inside the session:
-/logout
-```
-
-## Step 4: Verify Connection
-
-```bash
-claude
-# inside the session:
-/status
-```
-
-Should show that it's connected to OpenRouter.
-
-## Recommended Free Models for Coding
-
-| Model | OpenRouter ID | Context | Best For |
-|-------|---------------|---------|----------|
-| **Qwen3 Coder 480B** | `qwen/qwen3-coder-480b-a35b:free` | 262K | Best free model for agentic coding |
-| **DeepSeek R1** | `deepseek/deepseek-r1:free` | 164K | Complex reasoning, debugging |
-| **Devstral** | `mistralai/devstral-small:free` | 128K | Multi-file, agentic coding |
-| **Llama 3.3 70B** | `meta-llama/llama-3.3-70b-instruct:free` | 128K | General purpose, fast |
-
-To select a specific model, add to `~/.zshrc`:
-
-```bash
-export ANTHROPIC_MODEL="qwen/qwen3-coder-480b-a35b:free"
-```
-
-Or use the free automatic router:
-
-```bash
-export ANTHROPIC_MODEL="openrouter/free"
-```
-
-## Limitations
-
-- **Rate limits**: ~20 requests/min, ~200 requests/day on free models
-- **Tool use**: Not all free models support tool calling (needed for agents)
-- **Quality**: Inferior to Claude Opus/Sonnet for complex tasks
-- **Availability**: Free models may disappear without notice
-- **Not recommended for production**
-
-## Verification
-
-1. Open a new terminal (to load the variables)
-2. `echo $ANTHROPIC_BASE_URL` → should show `https://openrouter.ai/api`
-3. `claude` → should start without asking for Anthropic login
-4. `/status` → confirm connection to OpenRouter
-5. Ask a simple coding question to verify response