@luquimbo/bi-superpowers 3.1.1 → 3.2.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/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

package/library/examples/README.md

@@ -1,151 +0,0 @@
-# Examples
-
-Complete, end-to-end examples demonstrating BI Agent Superpowers patterns in real-world scenarios.
-
----
-
-## Available Examples
-
-| Example | Description | Components |
-|---------|-------------|------------|
-| [retail-analytics](./retail-analytics/) | Complete retail sales analytics solution | Star schema, 50+ DAX measures, data model |
-| [finance-reporting](./finance-reporting/) | P&L, Balance Sheet, variance analysis | Multi-statement model, 60+ financial measures |
-| [hr-analytics](./hr-analytics/) | Headcount, turnover, diversity metrics | Employee snapshots, 40+ HR measures |
-| [udf-library](./udf-library/) | DAX User Defined Functions library | 50+ reusable UDFs, typed parameters |
-
----
-
-## Learning Path (Recommended Order)
-
-New to Power BI? Follow this progression to build your skills:
-
-### Level 1: Foundations
-1. **[retail-analytics](./retail-analytics/)** - Start here!
-   - Learn star schema basics (facts + dimensions)
-   - Understand fundamental DAX patterns (SUM, CALCULATE, time intelligence)
-   - Build your first KPI dashboard
-
-### Level 2: Intermediate
-2. **[hr-analytics](./hr-analytics/)** - Expand your skills
-   - Work with snapshot data (point-in-time analysis)
-   - Learn turnover and retention calculations
-   - Understand Row-Level Security (RLS) basics
-
-### Level 3: Advanced
-3. **[finance-reporting](./finance-reporting/)** - Master complex scenarios
-   - Handle multi-statement financial models
-   - Work with hierarchical account structures
-   - Build variance analysis (Actual vs Budget)
-
-### Level 4: Expert
-4. **[udf-library](./udf-library/)** - Cutting-edge DAX
-   - Create reusable User Defined Functions (preview feature)
-   - Build a personal library of typed functions
-   - Master advanced DAX patterns
-
----
-
-## What Each Example Includes
-
-### Documentation
-- **README.md** - Overview, business requirements, implementation guide
-- **data-model.md** - Complete table definitions, relationships, sample data
-
-### Code
-- **measures.dax** - Complete DAX measure library, organized by category
-
-### Styling
-- Use themes from `library/themes/power-bi/` for consistent formatting
-
----
-
-## Using Examples
-
-### 1. Understand the Scenario
-
-Read the README.md to understand:
-- Business requirements and stakeholders
-- Key questions the solution answers
-- Recommended visualizations
-
-### 2. Adapt the Data Model
-
-Use data-model.md as a template:
-- Match columns to your source data
-- Adjust data types as needed
-- Add/remove columns for your scenario
-
-### 3. Copy Relevant Measures
-
-From measures.dax:
-- Start with base measures (Revenue, Cost, Profit)
-- Add time intelligence as needed
-- Customize rankings and percentages
-
-### 4. Apply a Theme
-
-1. Choose a theme from `library/themes/power-bi/`
-2. View > Themes > Browse for themes
-3. Select the JSON file
-
----
-
-## Example Structure
-
-```
-library/examples/
-├── README.md                    # This file
-│
-├── retail-analytics/            # Retail sales analytics
-│   ├── README.md                # Overview and guide
-│   ├── data-model.md            # Table definitions
-│   └── measures.dax             # 50+ DAX measures
-│
-├── finance-reporting/           # Financial statements
-│   ├── README.md                # P&L, Balance Sheet guide
-│   ├── data-model.md            # Account structure, scenarios
-│   └── measures.dax             # 60+ financial measures
-│
-├── hr-analytics/                # HR workforce analytics
-│   ├── README.md                # Headcount, turnover guide
-│   ├── data-model.md            # Employee snapshot model
-│   └── measures.dax             # 40+ HR measures
-│
-└── udf-library/                 # DAX User Defined Functions
-    ├── README.md                # UDF usage guide and catalog
-    └── functions.dax            # 50+ reusable typed functions
-```
-
----
-
-## Upcoming Examples
-
-- **marketing-dashboard** - Campaign performance, funnel analysis
-- **supply-chain** - Inventory, fulfillment, vendor performance
-- **project-management** - Resource allocation, timeline tracking
-
----
-
-## Contributing Examples
-
-Want to add an example? Include:
-
-1. **README.md** with:
-   - Business scenario description
-   - Stakeholder requirements
-   - Data model diagram
-   - Visualization recommendations
-   - Implementation checklist
-
-2. **data-model.md** with:
-   - All table definitions
-   - Column specifications
-   - Relationship diagram
-   - Sample data
-
-3. **measures.dax** with:
-   - Organized by category
-   - Comments explaining each measure
-   - Naming conventions followed
-
-See [CONTRIBUTING.md](../../CONTRIBUTING.md) for submission guidelines.