popeye-cli 1.6.0 → 1.8.0

package/cheatsheet.md

@@ -0,0 +1,407 @@
+# Popeye CLI Cheatsheet
+
+Quick reference for all Popeye CLI commands, interactive mode slash commands, and configuration options.
+
+---
+
+## CLI Commands
+
+### `popeye-cli create <idea>`
+
+Create a new project from a natural language description.
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `-n, --name <name>` | Project name | Auto-generated |
+| `-l, --language <lang>` | Output language (`python`, `typescript`, `fullstack`, `website`, `all`) | `python` |
+| `-m, --model <model>` | OpenAI model for consensus | `gpt-4o` |
+| `-o, --output <dir>` | Output directory | Current directory |
+| `--threshold <percent>` | Consensus threshold percentage | `95` |
+| `--max-iterations <n>` | Maximum consensus iterations | `5` |
+| `--skip-scaffold` | Skip initial project scaffolding | `false` |
+
+```bash
+popeye-cli create "todo app with user authentication" -l fullstack -n my-todo
+```
+
+---
+
+### `popeye-cli interactive` (alias: `i`)
+
+Start interactive mode for guided project creation and management. This is the default when running `popeye-cli` with no arguments.
+
+```bash
+popeye-cli interactive
+popeye-cli i
+```
+
+---
+
+### `popeye-cli status [directory]`
+
+Show current project status and progress.
+
+| Option | Description |
+|--------|-------------|
+| `-v, --verbose` | Show detailed status |
+| `--json` | Output as JSON |
+
+```bash
+popeye-cli status ./my-project --verbose
+```
+
+---
+
+### `popeye-cli validate [directory]`
+
+Validate that a project structure is complete and ready for execution.
+
+```bash
+popeye-cli validate ./my-project
+```
+
+---
+
+### `popeye-cli summary [directory]`
+
+Show a detailed project summary including plan, milestones, and current progress.
+
+```bash
+popeye-cli summary ./my-project
+```
+
+---
+
+### `popeye-cli resume [directory]`
+
+Resume an interrupted workflow from where it left off.
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--threshold <percent>` | Consensus threshold | `95` |
+| `--max-iterations <n>` | Max consensus iterations | `5` |
+| `--max-retries <n>` | Max task retries | `3` |
+
+```bash
+popeye-cli resume ./my-project
+```
+
+---
+
+### `popeye-cli reset [directory]`
+
+Reset a project to a specific phase, discarding progress beyond that point.
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `-p, --phase <phase>` | Phase to reset to (`plan`, `execution`) | `plan` |
+| `-f, --force` | Skip confirmation prompt | `false` |
+
+```bash
+popeye-cli reset ./my-project --phase plan --force
+```
+
+---
+
+### `popeye-cli cancel [directory]`
+
+Cancel and delete a project entirely.
+
+| Option | Description |
+|--------|-------------|
+| `-f, --force` | Skip confirmation prompt |
+
+```bash
+popeye-cli cancel ./my-project --force
+```
+
+---
+
+### `popeye-cli auth <subcommand>`
+
+Manage authentication for AI provider services.
+
+| Subcommand | Description |
+|------------|-------------|
+| `status` | Show authentication status for all services |
+| `login [service]` | Authenticate with a service (`claude`, `openai`, `gemini`, `grok`, `all`) |
+| `logout [service]` | Remove stored credentials for a service |
+| `claude` | Authenticate with Claude CLI |
+| `openai` | Authenticate with OpenAI API |
+| `gemini` | Authenticate with Gemini API |
+| `grok` | Authenticate with xAI Grok API |
+
+The `login`, `openai`, `gemini`, and `grok` subcommands accept `--api-key <key>` to provide a key directly.
+
+```bash
+popeye-cli auth status
+popeye-cli auth login openai --api-key sk-...
+popeye-cli auth logout all
+```
+
+---
+
+### `popeye-cli config <subcommand>`
+
+Manage CLI configuration settings.
+
+| Subcommand | Description |
+|------------|-------------|
+| `show` | Show current configuration (`--json` for JSON output) |
+| `defaults` | Show default configuration values (`--json` for JSON output) |
+| `get <key>` | Get a specific config value (e.g., `consensus.threshold`) |
+| `path` | Show the configuration file path |
+| `init` | Create a configuration file (`-f, --format <json\|yaml>`) |
+
+```bash
+popeye-cli config show --json
+popeye-cli config get consensus.threshold
+popeye-cli config init --format yaml
+```
+
+---
+
+### `popeye-cli db <subcommand>`
+
+Manage database configuration and setup for fullstack/all projects.
+
+| Subcommand | Description |
+|------------|-------------|
+| `status [directory]` | Show database configuration and lifecycle status |
+| `configure [directory]` | Configure database mode (local Docker or managed) and connection URL |
+| `apply [directory]` | Run the full setup pipeline: connectivity check, extensions, migrations, seed, readiness |
+
+The `apply` subcommand accepts `--skip-seed` to skip the seed step.
+
+```bash
+popeye-cli db status ./my-project
+popeye-cli db configure ./my-project
+popeye-cli db apply ./my-project --skip-seed
+```
+
+**Database lifecycle**: `unconfigured` -> `configured` -> `applying` -> `ready` (or `error`)
+
+---
+
+### `popeye-cli doctor [directory]`
+
+Run comprehensive project and database readiness checks.
+
+Checks performed:
+1. **Project State** -- Verifies `.popeye/` state directory exists
+2. **DB Layer** -- Confirms database layer was generated
+3. **Docker Compose** -- Checks PostgreSQL service is defined
+4. **DATABASE_URL** -- Validates the env var is configured
+5. **DB Reachability** -- Tests actual database connectivity
+6. **pgvector Extension** -- Checks if the vector extension is available
+7. **Migrations Applied** -- Queries `alembic_version` for migration status
+8. **Health Endpoint** -- Pings the backend `/health/db` endpoint
+
+```bash
+popeye-cli doctor ./my-project
+```
+
+---
+
+## Interactive Mode Slash Commands
+
+Enter these commands during an interactive session (started via `popeye-cli interactive`).
+
+### Help and Info
+
+| Command | Description |
+|---------|-------------|
+| `/help`, `/h`, `/?` | Show all available commands |
+| `/info`, `/check` | Show system info: Claude CLI status, API auth status, environment |
+
+### Project Creation and Management
+
+| Command | Description |
+|---------|-------------|
+| `/new <idea>` | Start a new project (skips existing project check) |
+| `/resume` | Resume an interrupted project with project discovery |
+| `/status` | Show current project status and progress |
+| `/overview [fix]` | Show full project plan and milestone review. Add `fix` to re-discover docs and auto-fix issues |
+
+```
+/new todo app with drag and drop
+/resume
+/overview fix
+```
+
+### Authentication
+
+| Command | Description |
+|---------|-------------|
+| `/auth` | Re-run the authentication flow for all AI services |
+
+### Configuration
+
+| Command | Description |
+|---------|-------------|
+| `/config` | Show full configuration summary |
+| `/config reviewer <provider>` | Set reviewer model (`openai`, `gemini`, `grok`) |
+| `/config arbitrator <provider\|off>` | Set arbitrator model or disable it |
+| `/config language <lang>` | Set project output language |
+| `/config model <provider> [model]` | Show or set AI model for a provider |
+
+### Language and Model Selection
+
+| Command | Description |
+|---------|-------------|
+| `/language <lang>`, `/lang`, `/l` | Set output language: `be`, `fe`, `fs`, `web`, `all` |
+| `/model` | Show current models for all providers |
+| `/model <provider>` | Show available models for a provider |
+| `/model <provider> <model>` | Set a specific model for a provider |
+
+```
+/lang fullstack
+/model openai gpt-4o-mini
+/model gemini gemini-2.0-flash
+/model grok grok-3
+```
+
+### Project Upgrade
+
+| Command | Description |
+|---------|-------------|
+| `/upgrade` | Show interactive upgrade menu |
+| `/upgrade <target>` | Upgrade project to a different type (`fullstack`, `website`, `all`, etc.) |
+
+Available upgrade paths depend on the current project type:
+- `python` -> `fullstack`, `all`
+- `typescript` -> `fullstack`, `all`
+- `fullstack` -> `all`
+- `website` -> `all`
+
+```
+/upgrade fullstack
+/upgrade all
+```
+
+### Database and Health
+
+| Command | Description |
+|---------|-------------|
+| `/db status` | Show database lifecycle status |
+| `/db configure` | Configure database (redirects to CLI) |
+| `/db apply` | Apply database setup (redirects to CLI) |
+| `/doctor` | Run all readiness checks inline |
+
+### Session Control
+
+| Command | Description |
+|---------|-------------|
+| `/clear`, `/cls` | Clear screen and redraw the UI |
+| `/exit`, `/quit`, `/q` | Exit Popeye CLI |
+
+### Default Behavior
+
+Typing anything without a `/` prefix treats the input as a project idea for creation or refinement.
+
+---
+
+## Language Aliases
+
+| Language | Aliases | What it generates |
+|----------|---------|-------------------|
+| `python` | `be`, `backend`, `py` | FastAPI backend API |
+| `typescript` | `fe`, `frontend`, `ts` | React + Vite frontend |
+| `fullstack` | `fs` | Monorepo: React frontend + FastAPI backend + PostgreSQL |
+| `website` | `web` | Next.js marketing/landing website |
+| `all` | -- | Complete stack: frontend + backend + website + shared packages |
+
+---
+
+## Available AI Models
+
+### OpenAI
+
+`gpt-4o`, `gpt-4o-mini`, `gpt-4-turbo`, `o1-preview`, `o1-mini` (custom models also accepted)
+
+### Gemini
+
+`gemini-2.0-flash`, `gemini-2.0-pro`, `gemini-1.5-flash`, `gemini-1.5-pro` (custom models also accepted)
+
+### Grok (xAI)
+
+`grok-3`, `grok-3-mini`, `grok-2` (custom models also accepted)
+
+---
+
+## Configuration Files
+
+Popeye looks for configuration in these files (in order):
+
+- `.popeyerc`
+- `.popeyerc.json`
+- `.popeyerc.yaml`
+- `popeye.config.js`
+
+### Config Sections
+
+| Section | Keys | Description |
+|---------|------|-------------|
+| `consensus` | `threshold`, `maxIterations`, `temperature`, `maxTokens` | Consensus engine settings |
+| `apis` | `openai.model`, `openai.timeout` | API provider settings |
+| `project` | `defaultLanguage`, `defaultName` | Project defaults |
+| `directories` | `output`, `state` | Directory paths |
+| `output` | `verbose`, `colors`, `progress` | Display settings |
+
+---
+
+## Database Lifecycle States
+
+```
+unconfigured ──> configured ──> applying ──> ready
+                     ^                        │
+                     │            error <──────┘
+                     │              │
+                     └──────────────┘
+```
+
+| State | Meaning |
+|-------|---------|
+| `unconfigured` | No `DATABASE_URL` set, DB layer not configured |
+| `configured` | URL set and DB reachable, migrations not yet applied |
+| `applying` | Setup pipeline is running (migrations, extensions, seed) |
+| `ready` | All checks passed, database is operational |
+| `error` | Setup failed, can retry from `configured` |
+
+---
+
+## Setup Pipeline Steps
+
+When you run `popeye-cli db apply`, the pipeline executes these steps in order:
+
+1. **check_connection** -- Verify database is reachable
+2. **ensure_extensions** -- Create required PostgreSQL extensions (pgvector)
+3. **apply_migrations** -- Run `alembic upgrade head`
+4. **seed_minimal** -- Execute seed script if present
+5. **readiness_tests** -- Verify database is fully operational
+6. **mark_ready** -- Transition status to `ready`
+
+---
+
+## Quick Examples
+
+```bash
+# Create a fullstack project
+popeye-cli create "task management app" -l fullstack -n taskmaster
+
+# Start interactive mode
+popeye-cli
+
+# Check project health
+popeye-cli doctor ./taskmaster
+
+# Set up the database
+popeye-cli db configure ./taskmaster
+popeye-cli db apply ./taskmaster
+
+# Resume after interruption
+popeye-cli resume ./taskmaster
+
+# Reset and re-plan
+popeye-cli reset ./taskmaster --phase plan
+```

package/dist/cli/commands/db.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Database CLI command
+ * Provides subcommands: status, configure, apply
+ */
+import { Command } from 'commander';
+/**
+ * Create the db command with subcommands
+ */
+export declare function createDbCommand(): Command;
+//# sourceMappingURL=db.d.ts.map

package/dist/cli/commands/db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/db.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA2PpC;;GAEG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAqBzC"}

package/dist/cli/commands/db.js

@@ -0,0 +1,240 @@
+/**
+ * Database CLI command
+ * Provides subcommands: status, configure, apply
+ */
+import { Command } from 'commander';
+import path from 'node:path';
+import { promises as fsPromises } from 'node:fs';
+import { createInterface } from 'node:readline';
+import { loadProject, updateState } from '../../state/index.js';
+import { DEFAULT_DB_CONFIG } from '../../types/database.js';
+import { transitionDbStatus } from '../../workflow/db-state-machine.js';
+import { runDbSetupPipeline, resolveBackendDir, } from '../../workflow/db-setup-runner.js';
+import { printHeader, printSection, printSuccess, printError, printWarning, printInfo, printKeyValue, startSpinner, succeedSpinner, failSpinner, } from '../output.js';
+/**
+ * Prompt the user for a line of input
+ */
+function promptLine(question) {
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    return new Promise((resolve) => {
+        rl.question(question, (answer) => {
+            rl.close();
+            resolve(answer.trim());
+        });
+    });
+}
+/**
+ * Display DB status from project state
+ */
+async function handleDbStatus(directory) {
+    const projectDir = path.resolve(directory);
+    try {
+        const state = await loadProject(projectDir);
+        const dbConfig = state.dbConfig || { ...DEFAULT_DB_CONFIG, designed: false };
+        printHeader('Database Status');
+        printKeyValue('Designed', dbConfig.designed ? 'Yes' : 'No');
+        printKeyValue('Status', dbConfig.status);
+        printKeyValue('Mode', dbConfig.mode || 'not set');
+        printKeyValue('Vector Required', dbConfig.vectorRequired ? 'Yes' : 'No');
+        printKeyValue('Migrations Applied', String(dbConfig.migrationsApplied));
+        if (dbConfig.lastError) {
+            printSection('Last Error');
+            printError(dbConfig.lastError);
+        }
+        if (dbConfig.readinessCheckedAt) {
+            printKeyValue('Last Readiness Check', dbConfig.readinessCheckedAt);
+        }
+        // Show next steps based on status
+        console.log();
+        switch (dbConfig.status) {
+            case 'unconfigured':
+                printInfo('Run "popeye db configure" to set up database connection.');
+                break;
+            case 'configured':
+                printInfo('Run "popeye db apply" to apply migrations and finalize setup.');
+                break;
+            case 'error':
+                printWarning('Database setup failed. Run "popeye db apply" to retry.');
+                break;
+            case 'ready':
+                printSuccess('Database is ready.');
+                break;
+            case 'applying':
+                printInfo('Database setup is in progress...');
+                break;
+        }
+    }
+    catch (error) {
+        printError(error instanceof Error ? error.message : 'Failed to load project');
+        process.exit(1);
+    }
+}
+/**
+ * Configure database mode and connection URL
+ */
+async function handleDbConfigure(directory) {
+    const projectDir = path.resolve(directory);
+    try {
+        const state = await loadProject(projectDir);
+        const dbConfig = state.dbConfig || { ...DEFAULT_DB_CONFIG };
+        printHeader('Database Configuration');
+        // Prompt for mode
+        console.log();
+        console.log('  Choose database mode:');
+        console.log('    1. local_docker  - PostgreSQL via Docker Compose (recommended for dev)');
+        console.log('    2. managed       - External managed database (Neon, Supabase, etc.)');
+        console.log();
+        const modeChoice = await promptLine('  Enter choice [1-2]: ');
+        let mode;
+        if (modeChoice === '2' || modeChoice === 'managed') {
+            mode = 'managed';
+        }
+        else {
+            mode = 'local_docker';
+        }
+        printKeyValue('Mode', mode);
+        // For managed mode, prompt for DATABASE_URL
+        if (mode === 'managed') {
+            const dbUrl = await promptLine('  Enter DATABASE_URL: ');
+            if (!dbUrl) {
+                printError('DATABASE_URL is required for managed mode.');
+                process.exit(1);
+            }
+            // Write DATABASE_URL to apps/backend/.env
+            const backendDir = resolveBackendDir(projectDir);
+            const envPath = path.join(backendDir, '.env');
+            let envContent = '';
+            try {
+                envContent = await fsPromises.readFile(envPath, 'utf-8');
+            }
+            catch {
+                // File doesn't exist yet
+            }
+            // Replace or add DATABASE_URL
+            if (envContent.includes('DATABASE_URL=')) {
+                envContent = envContent.replace(/DATABASE_URL=.*/, `DATABASE_URL=${dbUrl}`);
+            }
+            else {
+                envContent += `\nDATABASE_URL=${dbUrl}\n`;
+            }
+            await fsPromises.writeFile(envPath, envContent, 'utf-8');
+            printSuccess(`DATABASE_URL written to ${envPath}`);
+        }
+        else {
+            printInfo('Local Docker mode: PostgreSQL starts with "docker-compose up".');
+            printInfo('DATABASE_URL is set automatically in docker-compose.yml.');
+        }
+        // Update state: transition to configured
+        const newStatus = transitionDbStatus(dbConfig.status, 'configured');
+        await updateState(projectDir, {
+            dbConfig: {
+                ...dbConfig,
+                mode,
+                status: newStatus,
+            },
+        });
+        printSuccess('Database configured successfully.');
+        printInfo('Run "popeye db apply" to apply migrations.');
+    }
+    catch (error) {
+        printError(error instanceof Error ? error.message : 'Configuration failed');
+        process.exit(1);
+    }
+}
+/**
+ * Apply database setup (migrations, extensions, readiness)
+ */
+async function handleDbApply(directory, options) {
+    const projectDir = path.resolve(directory);
+    try {
+        const state = await loadProject(projectDir);
+        const dbConfig = state.dbConfig || { ...DEFAULT_DB_CONFIG };
+        printHeader('Database Setup');
+        // Transition to applying
+        let currentStatus = dbConfig.status;
+        if (currentStatus === 'unconfigured') {
+            printError('Database not configured. Run "popeye db configure" first.');
+            process.exit(1);
+        }
+        startSpinner('Running database setup pipeline...');
+        const result = await runDbSetupPipeline(projectDir, {
+            skipSeed: options.skipSeed,
+            onStep: (step, status, message) => {
+                if (status === 'start') {
+                    startSpinner(`[${step}] ${message}`);
+                }
+                else if (status === 'success') {
+                    succeedSpinner(`[${step}] ${message}`);
+                }
+                else {
+                    failSpinner(`[${step}] ${message}`);
+                }
+            },
+        });
+        // Print summary
+        console.log();
+        printSection('Setup Summary');
+        for (const step of result.steps) {
+            const icon = step.success ? '  [PASS]' : '  [FAIL]';
+            const duration = `(${step.durationMs}ms)`;
+            if (step.success) {
+                printSuccess(`${icon} ${step.step} ${duration}`);
+            }
+            else {
+                printError(`${icon} ${step.step} ${duration}`);
+                if (step.error) {
+                    printError(`         ${step.error}`);
+                }
+            }
+        }
+        printKeyValue('Total Duration', `${result.totalDurationMs}ms`);
+        // Update state with result
+        const newStatus = result.success ? 'ready' : 'error';
+        const now = new Date().toISOString();
+        await updateState(projectDir, {
+            dbConfig: {
+                ...dbConfig,
+                status: newStatus,
+                lastError: result.error,
+                readinessCheckedAt: result.success ? now : dbConfig.readinessCheckedAt,
+            },
+        });
+        if (result.success) {
+            console.log();
+            printSuccess('Database setup complete. Status: READY');
+        }
+        else {
+            console.log();
+            printError(`Database setup failed: ${result.error}`);
+            printInfo('Fix the issue and run "popeye db apply" to retry.');
+            process.exit(1);
+        }
+    }
+    catch (error) {
+        failSpinner('Setup failed');
+        printError(error instanceof Error ? error.message : 'Unknown error');
+        process.exit(1);
+    }
+}
+/**
+ * Create the db command with subcommands
+ */
+export function createDbCommand() {
+    const db = new Command('db')
+        .description('Database management commands');
+    db.command('status')
+        .description('Show database configuration status')
+        .argument('[directory]', 'Project directory', '.')
+        .action(handleDbStatus);
+    db.command('configure')
+        .description('Configure database mode and connection')
+        .argument('[directory]', 'Project directory', '.')
+        .action(handleDbConfigure);
+    db.command('apply')
+        .description('Apply database setup (migrations, extensions, readiness)')
+        .argument('[directory]', 'Project directory', '.')
+        .option('--skip-seed', 'Skip seed step')
+        .action(handleDbApply);
+    return db;
+}
+//# sourceMappingURL=db.js.map

package/dist/cli/commands/db.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.js","sourceRoot":"","sources":["../../../src/cli/commands/db.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/doctor.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Doctor command
+ * Runs comprehensive readiness checks on database and project health
+ */
+import { Command } from 'commander';
+import type { ReadinessResult } from '../../types/database-runtime.js';
+/**
+ * Run all readiness checks and return structured results
+ *
+ * @param projectDir - Project root directory
+ * @returns ReadinessResult with all check outcomes
+ */
+export declare function runDoctorChecks(projectDir: string): Promise<ReadinessResult>;
+/**
+ * Create the doctor command
+ */
+export declare function createDoctorCommand(): Command;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/cli/commands/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/doctor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,OAAO,KAAK,EAAkB,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAavF;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CA0MlF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,CAoC7C"}