popeye-cli 1.7.0 → 1.9.0

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"}

package/dist/cli/commands/doctor.js

@@ -0,0 +1,255 @@
+/**
+ * Doctor command
+ * Runs comprehensive readiness checks on database and project health
+ */
+import { Command } from 'commander';
+import path from 'node:path';
+import { promises as fsPromises } from 'node:fs';
+import { loadProject } from '../../state/index.js';
+import { DEFAULT_DB_CONFIG } from '../../types/database.js';
+import { readEnvFile, resolveBackendDir, } from '../../workflow/db-setup-runner.js';
+import { printHeader, printSuccess, printError, printWarning, printInfo, } from '../output.js';
+/**
+ * Run all readiness checks and return structured results
+ *
+ * @param projectDir - Project root directory
+ * @returns ReadinessResult with all check outcomes
+ */
+export async function runDoctorChecks(projectDir) {
+    const checks = [];
+    // Check 1: Project state exists
+    try {
+        await loadProject(projectDir);
+        checks.push({
+            name: 'Project State',
+            passed: true,
+            message: 'Project state loaded successfully',
+            severity: 'critical',
+        });
+    }
+    catch {
+        checks.push({
+            name: 'Project State',
+            passed: false,
+            message: 'No valid project state found at this directory',
+            severity: 'critical',
+        });
+        return { healthy: false, checks, timestamp: new Date().toISOString() };
+    }
+    const state = await loadProject(projectDir);
+    const dbConfig = state.dbConfig || { ...DEFAULT_DB_CONFIG, designed: false };
+    const backendDir = resolveBackendDir(projectDir);
+    // Check 2: DB layer generated
+    checks.push({
+        name: 'DB Layer Generated',
+        passed: dbConfig.designed === true,
+        message: dbConfig.designed
+            ? 'Database layer files are present'
+            : 'Database layer not generated (dbConfig.designed = false)',
+        severity: 'critical',
+    });
+    // Check 3: Docker compose includes postgres service
+    let composeHasPostgres = false;
+    try {
+        const composePath = path.join(projectDir, 'docker-compose.yml');
+        const composeContent = await fsPromises.readFile(composePath, 'utf-8');
+        composeHasPostgres = composeContent.includes('postgres:') && composeContent.includes('pg_isready');
+    }
+    catch {
+        // File doesn't exist
+    }
+    checks.push({
+        name: 'Docker Compose Postgres',
+        passed: composeHasPostgres,
+        message: composeHasPostgres
+            ? 'docker-compose.yml includes postgres service with healthcheck'
+            : 'docker-compose.yml missing or does not include postgres service',
+        severity: 'warning',
+    });
+    // Check 4: .env has DATABASE_URL (not placeholder)
+    const env = await readEnvFile(path.join(backendDir, '.env'));
+    const dbUrl = env['DATABASE_URL'] || '';
+    const hasRealDbUrl = dbUrl.length > 0 && !dbUrl.includes('sqlite');
+    checks.push({
+        name: 'DATABASE_URL Configured',
+        passed: hasRealDbUrl,
+        message: hasRealDbUrl
+            ? 'DATABASE_URL is set to a PostgreSQL connection string'
+            : 'DATABASE_URL is missing or still using SQLite placeholder',
+        severity: 'critical',
+    });
+    // Check 5: DB connection reachable (only if URL is set)
+    if (hasRealDbUrl) {
+        try {
+            const { exec } = await import('node:child_process');
+            const { promisify } = await import('node:util');
+            const execAsync = promisify(exec);
+            const cmd = `cd "${backendDir}" && python3 -c "
+import asyncio, asyncpg
+async def check():
+    conn = await asyncpg.connect('${dbUrl.replace(/'/g, "\\'")}')
+    await conn.execute('SELECT 1')
+    await conn.close()
+asyncio.run(check())
+"`;
+            await execAsync(cmd, { timeout: 10000 });
+            checks.push({
+                name: 'DB Connection',
+                passed: true,
+                message: 'Database is reachable',
+                severity: 'critical',
+            });
+        }
+        catch {
+            checks.push({
+                name: 'DB Connection',
+                passed: false,
+                message: 'Cannot connect to database - check DATABASE_URL and server status',
+                severity: 'critical',
+            });
+        }
+    }
+    else {
+        checks.push({
+            name: 'DB Connection',
+            passed: false,
+            message: 'Skipped - DATABASE_URL not configured',
+            severity: 'info',
+        });
+    }
+    // Check 6: pgvector extension available (only if connected)
+    if (hasRealDbUrl && checks.find((c) => c.name === 'DB Connection')?.passed) {
+        try {
+            const { exec } = await import('node:child_process');
+            const { promisify } = await import('node:util');
+            const execAsync = promisify(exec);
+            const cmd = `cd "${backendDir}" && python3 -c "
+import asyncio, asyncpg
+async def check():
+    conn = await asyncpg.connect('${dbUrl.replace(/'/g, "\\'")}')
+    row = await conn.fetchrow(\"SELECT extname FROM pg_extension WHERE extname = 'vector'\")
+    await conn.close()
+    if row is None:
+        raise Exception('pgvector extension not found')
+asyncio.run(check())
+"`;
+            await execAsync(cmd, { timeout: 10000 });
+            checks.push({
+                name: 'pgvector Extension',
+                passed: true,
+                message: 'pgvector extension is installed',
+                severity: 'warning',
+            });
+        }
+        catch {
+            checks.push({
+                name: 'pgvector Extension',
+                passed: false,
+                message: 'pgvector extension not available - vector features will be disabled',
+                severity: 'warning',
+            });
+        }
+    }
+    // Check 7: Migrations applied
+    if (hasRealDbUrl && checks.find((c) => c.name === 'DB Connection')?.passed) {
+        try {
+            const { exec } = await import('node:child_process');
+            const { promisify } = await import('node:util');
+            const execAsync = promisify(exec);
+            const cmd = `cd "${backendDir}" && python3 -c "
+import asyncio, asyncpg
+async def check():
+    conn = await asyncpg.connect('${dbUrl.replace(/'/g, "\\'")}')
+    row = await conn.fetchrow('SELECT version_num FROM alembic_version LIMIT 1')
+    await conn.close()
+    if row is None:
+        raise Exception('No migrations applied')
+asyncio.run(check())
+"`;
+            await execAsync(cmd, { timeout: 10000 });
+            checks.push({
+                name: 'Migrations Applied',
+                passed: true,
+                message: 'Alembic migrations have been applied',
+                severity: 'critical',
+            });
+        }
+        catch {
+            checks.push({
+                name: 'Migrations Applied',
+                passed: false,
+                message: 'No migrations applied - run "popeye db apply" or "alembic upgrade head"',
+                severity: 'critical',
+            });
+        }
+    }
+    // Check 8: /health/db endpoint (optional - only if server is running)
+    try {
+        const response = await fetch('http://localhost:8000/health/db', {
+            signal: AbortSignal.timeout(3000),
+        });
+        checks.push({
+            name: 'Health Endpoint',
+            passed: response.status === 200,
+            message: response.status === 200
+                ? '/health/db returns 200 OK'
+                : `/health/db returns ${response.status}`,
+            severity: 'info',
+        });
+    }
+    catch {
+        checks.push({
+            name: 'Health Endpoint',
+            passed: false,
+            message: 'Backend server not running (optional check)',
+            severity: 'info',
+        });
+    }
+    const healthy = checks
+        .filter((c) => c.severity === 'critical')
+        .every((c) => c.passed);
+    return {
+        healthy,
+        checks,
+        timestamp: new Date().toISOString(),
+    };
+}
+/**
+ * Create the doctor command
+ */
+export function createDoctorCommand() {
+    const doctor = new Command('doctor')
+        .description('Run comprehensive database and project readiness checks')
+        .argument('[directory]', 'Project directory', '.')
+        .action(async (directory) => {
+        const projectDir = path.resolve(directory);
+        printHeader('Popeye Doctor');
+        console.log();
+        const result = await runDoctorChecks(projectDir);
+        for (const check of result.checks) {
+            const statusLabel = check.passed ? '[PASS]' : check.severity === 'info' ? '[SKIP]' : '[FAIL]';
+            if (check.passed) {
+                printSuccess(`  ${statusLabel} ${check.name}: ${check.message}`);
+            }
+            else if (check.severity === 'info') {
+                printInfo(`  ${statusLabel} ${check.name}: ${check.message}`);
+            }
+            else if (check.severity === 'warning') {
+                printWarning(`  ${statusLabel} ${check.name}: ${check.message}`);
+            }
+            else {
+                printError(`  ${statusLabel} ${check.name}: ${check.message}`);
+            }
+        }
+        console.log();
+        if (result.healthy) {
+            printSuccess('All critical checks passed. Database is healthy.');
+        }
+        else {
+            printError('Some critical checks failed. Fix the issues above and re-run.');
+            process.exit(1);
+        }
+    });
+    return doctor;
+}
+//# sourceMappingURL=doctor.js.map

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

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

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

@@ -7,4 +7,7 @@ export { createCreateCommand } from './create.js';
 export { createStatusCommand, createValidateCommand, createSummaryCommand } from './status.js';
 export { createResumeCommand, createResetCommand, createCancelCommand } from './resume.js';
 export { createConfigCommand } from './config.js';
+export { createDbCommand } from './db.js';
+export { createDoctorCommand } from './doctor.js';
+export { createReviewCommand } from './review.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAC/F,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAC3F,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAC/F,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAC3F,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC"}

package/dist/cli/commands/index.js

@@ -7,4 +7,7 @@ export { createCreateCommand } from './create.js';
 export { createStatusCommand, createValidateCommand, createSummaryCommand } from './status.js';
 export { createResumeCommand, createResetCommand, createCancelCommand } from './resume.js';
 export { createConfigCommand } from './config.js';
+export { createDbCommand } from './db.js';
+export { createDoctorCommand } from './doctor.js';
+export { createReviewCommand } from './review.js';
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/commands/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAC/F,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAC3F,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/commands/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAC/F,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAC3F,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC"}

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

@@ -0,0 +1,31 @@
+/**
+ * CLI command: popeye review
+ *
+ * Runs a post-build audit/review of the project, producing a structured
+ * report with findings and optional recovery tasks.
+ *
+ * Pattern follows doctor.ts command factory.
+ */
+import { Command } from 'commander';
+import type { AuditModeResult } from '../../types/audit.js';
+/**
+ * Execute the audit and print results to the console.
+ *
+ * @param projectDir - Absolute path to the project directory.
+ * @param options - CLI options.
+ * @returns The audit result.
+ */
+export declare function runReview(projectDir: string, options?: {
+    depth?: number;
+    strict?: boolean;
+    format?: 'json' | 'md' | 'both';
+    recover?: boolean;
+    target?: string;
+}): Promise<AuditModeResult>;
+/**
+ * Create the `popeye review` CLI command.
+ *
+ * @returns Commander command instance.
+ */
+export declare function createReviewCommand(): Command;
+//# sourceMappingURL=review.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"review.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/review.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAYpC,OAAO,KAAK,EAAE,eAAe,EAAiB,MAAM,sBAAsB,CAAC;AAM3E;;;;;;GAMG;AACH,wBAAsB,SAAS,CAC7B,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE;IACP,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAAC;IAChC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACZ,GACL,OAAO,CAAC,eAAe,CAAC,CAoG1B;AAMD;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,CAgC7C"}