popeye-cli 1.7.0 → 1.9.0

package/dist/cli/commands/review.js

@@ -0,0 +1,156 @@
+/**
+ * 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 path from 'node:path';
+import { printHeader, printSuccess, printError, printWarning, printInfo, printKeyValue, printSection, } from '../output.js';
+import { runAuditMode } from '../../workflow/audit-mode.js';
+// ---------------------------------------------------------------------------
+// Run audit (exported for testability + slash command reuse)
+// ---------------------------------------------------------------------------
+/**
+ * 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 async function runReview(projectDir, options = {}) {
+    printHeader('Project Audit / Review');
+    const auditOptions = {
+        projectDir,
+        depth: options.depth ?? 2,
+        runTests: true,
+        strict: options.strict ?? false,
+        format: options.format ?? 'both',
+        autoRecover: options.recover ?? true,
+        target: (options.target ?? 'all'),
+        onProgress: (stage, message) => {
+            printInfo(`[${stage}] ${message}`);
+        },
+    };
+    const result = await runAuditMode(auditOptions);
+    if (!result.success) {
+        printError(`Audit failed: ${result.error}`);
+        return result;
+    }
+    // Print summary
+    console.log();
+    printSection('Summary');
+    printKeyValue('Project', result.summary.projectName);
+    printKeyValue('Language', result.summary.language);
+    printKeyValue('Source files', result.summary.totalSourceFiles);
+    printKeyValue('Test files', result.summary.totalTestFiles);
+    printKeyValue('Lines of code', result.summary.totalLinesOfCode);
+    printKeyValue('Components', result.summary.componentCount);
+    // Print score
+    console.log();
+    printSection('Audit Score');
+    const score = result.audit.overallScore;
+    if (score >= 80) {
+        printSuccess(`Overall: ${score}/100`);
+    }
+    else if (score >= 60) {
+        printWarning(`Overall: ${score}/100`);
+    }
+    else {
+        printError(`Overall: ${score}/100`);
+    }
+    // Print finding counts
+    if (result.audit.criticalCount > 0) {
+        printError(`Critical: ${result.audit.criticalCount}`);
+    }
+    if (result.audit.majorCount > 0) {
+        printWarning(`Major: ${result.audit.majorCount}`);
+    }
+    if (result.audit.minorCount > 0) {
+        printInfo(`Minor: ${result.audit.minorCount}`);
+    }
+    if (result.audit.infoCount > 0) {
+        printInfo(`Info: ${result.audit.infoCount}`);
+    }
+    // Recommendation
+    console.log();
+    const rec = result.audit.recommendation;
+    if (rec === 'pass') {
+        printSuccess(`Recommendation: ${rec}`);
+    }
+    else if (rec === 'fix-and-recheck') {
+        printWarning(`Recommendation: ${rec}`);
+    }
+    else {
+        printError(`Recommendation: ${rec}`);
+    }
+    // Report paths
+    if (Object.keys(result.reportPaths).length > 0) {
+        console.log();
+        printSection('Reports');
+        if (result.reportPaths.auditMd) {
+            printInfo(`Markdown: ${result.reportPaths.auditMd}`);
+        }
+        if (result.reportPaths.auditJson) {
+            printInfo(`JSON: ${result.reportPaths.auditJson}`);
+        }
+        if (result.reportPaths.recoveryMd) {
+            printWarning(`Recovery plan: ${result.reportPaths.recoveryMd}`);
+        }
+    }
+    // Recovery info
+    if (result.recovery) {
+        console.log();
+        printSection('Recovery Plan');
+        printWarning(`${result.recovery.milestones.length} recovery milestone(s), estimated ${result.recovery.estimatedEffort}`);
+        if (auditOptions.autoRecover) {
+            printSuccess('Recovery milestones injected — run /resume to execute.');
+        }
+        else {
+            printInfo('Run without --no-recover to auto-inject recovery milestones.');
+        }
+    }
+    return result;
+}
+// ---------------------------------------------------------------------------
+// Commander command factory
+// ---------------------------------------------------------------------------
+/**
+ * Create the `popeye review` CLI command.
+ *
+ * @returns Commander command instance.
+ */
+export function createReviewCommand() {
+    const cmd = new Command('review')
+        .alias('audit')
+        .description('Run a post-build audit/review of the project')
+        .argument('[directory]', 'Project directory', '.')
+        .option('-d, --depth <level>', 'Audit depth: 1=shallow, 2=standard, 3=deep', '2')
+        .option('-s, --strict', 'Enable strict mode (higher standards)', false)
+        .option('-f, --format <type>', 'Output format: json, md, both', 'both')
+        .option('--no-recover', 'Skip auto-injection of recovery milestones')
+        .option('-t, --target <kind>', 'Audit target: all, frontend, backend, website', 'all')
+        .action(async (directory, opts) => {
+        const projectDir = path.resolve(directory);
+        try {
+            const result = await runReview(projectDir, {
+                depth: parseInt(opts.depth, 10),
+                strict: opts.strict,
+                format: opts.format,
+                recover: opts.recover,
+                target: opts.target,
+            });
+            if (!result.success) {
+                process.exit(1);
+            }
+        }
+        catch (err) {
+            printError(err instanceof Error ? err.message : 'Audit failed');
+            process.exit(1);
+        }
+    });
+    return cmd;
+}
+//# sourceMappingURL=review.js.map

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAiBpC,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AAOpC,eAAO,MAAM,OAAO,EAAE,MAA4B,CAAC;AAEnD;;GAEG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAuCvC;AAED;;GAEG;AACH,wBAAsB,MAAM,CAAC,IAAI,GAAE,MAAM,EAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CASzE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAoBpC,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AAOpC,eAAO,MAAM,OAAO,EAAE,MAA4B,CAAC;AAEnD;;GAEG;AACH,wBAAgB,aAAa,IAAI,OAAO,CA0CvC;AAED;;GAEG;AACH,wBAAsB,MAAM,CAAC,IAAI,GAAE,MAAM,EAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CASzE"}

package/dist/cli/index.js

@@ -4,7 +4,7 @@
  */
 import { Command } from 'commander';
 import { createRequire } from 'node:module';
-import { createAuthCommand, createCreateCommand, createStatusCommand, createValidateCommand, createSummaryCommand, createResumeCommand, createResetCommand, createCancelCommand, createConfigCommand, } from './commands/index.js';
+import { createAuthCommand, createCreateCommand, createStatusCommand, createValidateCommand, createSummaryCommand, createResumeCommand, createResetCommand, createCancelCommand, createConfigCommand, createDbCommand, createDoctorCommand, createReviewCommand, } from './commands/index.js';
 import { startInteractiveMode } from './interactive.js';
 import { printError } from './output.js';
 // Re-export
@@ -38,6 +38,9 @@ export function createProgram() {
     program.addCommand(createResetCommand());
     program.addCommand(createCancelCommand());
     program.addCommand(createConfigCommand());
+    program.addCommand(createDbCommand());
+    program.addCommand(createDoctorCommand());
+    program.addCommand(createReviewCommand());
     // Interactive mode command
     program
         .command('interactive')

package/dist/cli/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,YAAY;AACZ,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AAEpC;;GAEG;AACH,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,WAAW,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;AAClD,MAAM,CAAC,MAAM,OAAO,GAAW,WAAW,CAAC,OAAO,CAAC;AAEnD;;GAEG;AACH,MAAM,UAAU,aAAa;IAC3B,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAE9B,OAAO;SACJ,IAAI,CAAC,YAAY,CAAC;SAClB,WAAW,CAAC,6EAA6E,CAAC;SAC1F,OAAO,CAAC,OAAO,CAAC;SAChB,MAAM,CAAC,eAAe,EAAE,uBAAuB,CAAC;SAChD,MAAM,CAAC,YAAY,EAAE,wBAAwB,CAAC,CAAC;IAElD,eAAe;IACf,OAAO,CAAC,UAAU,CAAC,iBAAiB,EAAE,CAAC,CAAC;IACxC,OAAO,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAC1C,OAAO,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAC1C,OAAO,CAAC,UAAU,CAAC,qBAAqB,EAAE,CAAC,CAAC;IAC5C,OAAO,CAAC,UAAU,CAAC,oBAAoB,EAAE,CAAC,CAAC;IAC3C,OAAO,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAC1C,OAAO,CAAC,UAAU,CAAC,kBAAkB,EAAE,CAAC,CAAC;IACzC,OAAO,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAC1C,OAAO,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAE1C,2BAA2B;IAC3B,OAAO;SACJ,OAAO,CAAC,aAAa,CAAC;SACtB,KAAK,CAAC,GAAG,CAAC;SACV,WAAW,CAAC,wBAAwB,CAAC;SACrC,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,MAAM,oBAAoB,EAAE,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEL,iEAAiE;IACjE,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE;QACzC,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9B,+DAA+D;YAC/D,MAAM,oBAAoB,EAAE,CAAC;QAC/B,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,OAAiB,OAAO,CAAC,IAAI;IACxD,MAAM,OAAO,GAAG,aAAa,EAAE,CAAC;IAEhC,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,UAAU,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;QACrE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EACf,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,YAAY;AACZ,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AAEpC;;GAEG;AACH,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,WAAW,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;AAClD,MAAM,CAAC,MAAM,OAAO,GAAW,WAAW,CAAC,OAAO,CAAC;AAEnD;;GAEG;AACH,MAAM,UAAU,aAAa;IAC3B,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAE9B,OAAO;SACJ,IAAI,CAAC,YAAY,CAAC;SAClB,WAAW,CAAC,6EAA6E,CAAC;SAC1F,OAAO,CAAC,OAAO,CAAC;SAChB,MAAM,CAAC,eAAe,EAAE,uBAAuB,CAAC;SAChD,MAAM,CAAC,YAAY,EAAE,wBAAwB,CAAC,CAAC;IAElD,eAAe;IACf,OAAO,CAAC,UAAU,CAAC,iBAAiB,EAAE,CAAC,CAAC;IACxC,OAAO,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAC1C,OAAO,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAC1C,OAAO,CAAC,UAAU,CAAC,qBAAqB,EAAE,CAAC,CAAC;IAC5C,OAAO,CAAC,UAAU,CAAC,oBAAoB,EAAE,CAAC,CAAC;IAC3C,OAAO,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAC1C,OAAO,CAAC,UAAU,CAAC,kBAAkB,EAAE,CAAC,CAAC;IACzC,OAAO,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAC1C,OAAO,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAC1C,OAAO,CAAC,UAAU,CAAC,eAAe,EAAE,CAAC,CAAC;IACtC,OAAO,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAC1C,OAAO,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAE1C,2BAA2B;IAC3B,OAAO;SACJ,OAAO,CAAC,aAAa,CAAC;SACtB,KAAK,CAAC,GAAG,CAAC;SACV,WAAW,CAAC,wBAAwB,CAAC;SACrC,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,MAAM,oBAAoB,EAAE,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEL,iEAAiE;IACjE,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE;QACzC,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9B,+DAA+D;YAC/D,MAAM,oBAAoB,EAAE,CAAC;QAC/B,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,OAAiB,OAAO,CAAC,IAAI;IACxD,MAAM,OAAO,GAAG,aAAa,EAAE,CAAC;IAEhC,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,UAAU,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;QACrE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/cli/interactive.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interactive.d.ts","sourceRoot":"","sources":["../../src/cli/interactive.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA8tEH;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA2B7E;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA0BrF;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CA4EhE;AAiVD;;GAEG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC,CA4E1D"}
+{"version":3,"file":"interactive.d.ts","sourceRoot":"","sources":["../../src/cli/interactive.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAw4EH;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA2B7E;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA0BrF;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CA4EhE;AAiVD;;GAEG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC,CA4E1D"}

package/dist/cli/interactive.js

@@ -697,6 +697,9 @@ function showHelp() {
         ['/new <idea>', 'Force start a new project (skips existing check)'],
         ['/resume', 'Resume interrupted project'],
         ['/overview [fix]', 'Project review with analysis; fix to auto-discover docs'],
+        ['/db [action]', 'Database management (status/configure/apply)'],
+        ['/doctor', 'Run database and project readiness checks'],
+        ['/review', 'Run post-build audit/review with findings and recovery'],
         ['/clear', 'Clear screen'],
         ['/exit', 'Exit Popeye'],
     ];
@@ -838,6 +841,16 @@ async function handleInput(input, state) {
                     await handleNewProject(args.join(' '), state);
                 }
                 break;
+            case '/db':
+                await handleDbSlashCommand(state, args);
+                break;
+            case '/doctor':
+                await handleDoctorSlashCommand(state);
+                break;
+            case '/review':
+            case '/audit':
+                await handleReviewSlashCommand(state, args);
+                break;
             default:
                 printError(`Unknown command: ${cmd}`);
                 printInfo('Type /help for available commands');
@@ -872,6 +885,134 @@ async function handleStatus(state) {
     const summary = await getWorkflowSummary(state.projectDir);
     console.log(summary);
 }
+/**
+ * Handle /db slash command - database management
+ */
+async function handleDbSlashCommand(state, args) {
+    if (!state.projectDir) {
+        printError('No active project. Create or resume a project first.');
+        return;
+    }
+    const action = args[0] || 'status';
+    switch (action) {
+        case 'status': {
+            try {
+                const { loadProject } = await import('../state/index.js');
+                const { DEFAULT_DB_CONFIG } = await import('../types/database.js');
+                const projectState = await loadProject(state.projectDir);
+                const dbConfig = projectState.dbConfig || { ...DEFAULT_DB_CONFIG, designed: false };
+                console.log();
+                printInfo('Database Status:');
+                console.log(`  Designed:     ${dbConfig.designed ? 'Yes' : 'No'}`);
+                console.log(`  Status:       ${dbConfig.status}`);
+                console.log(`  Mode:         ${dbConfig.mode || 'not set'}`);
+                console.log(`  Vector:       ${dbConfig.vectorRequired ? 'Yes' : 'No'}`);
+                console.log(`  Migrations:   ${dbConfig.migrationsApplied}`);
+                if (dbConfig.lastError) {
+                    printError(`  Last Error:   ${dbConfig.lastError}`);
+                }
+                console.log();
+            }
+            catch (err) {
+                printError(err instanceof Error ? err.message : 'Failed to load project state');
+            }
+            break;
+        }
+        case 'configure': {
+            printInfo('Use "popeye db configure" from the CLI for interactive configuration.');
+            printInfo('Or set DATABASE_URL in apps/backend/.env manually.');
+            break;
+        }
+        case 'apply': {
+            printInfo('Use "popeye db apply" from the CLI to run the setup pipeline.');
+            break;
+        }
+        default:
+            printError(`Unknown db action: ${action}`);
+            printInfo('Usage: /db [status|configure|apply]');
+    }
+}
+/**
+ * Handle /doctor slash command - readiness checks
+ */
+async function handleDoctorSlashCommand(state) {
+    if (!state.projectDir) {
+        printError('No active project. Create or resume a project first.');
+        return;
+    }
+    try {
+        const { runDoctorChecks } = await import('./commands/doctor.js');
+        console.log();
+        printInfo('Running readiness checks...');
+        console.log();
+        const result = await runDoctorChecks(state.projectDir);
+        for (const check of result.checks) {
+            const label = check.passed ? '[PASS]' : check.severity === 'info' ? '[SKIP]' : '[FAIL]';
+            if (check.passed) {
+                printSuccess(`  ${label} ${check.name}: ${check.message}`);
+            }
+            else if (check.severity === 'info') {
+                printInfo(`  ${label} ${check.name}: ${check.message}`);
+            }
+            else if (check.severity === 'warning') {
+                printWarning(`  ${label} ${check.name}: ${check.message}`);
+            }
+            else {
+                printError(`  ${label} ${check.name}: ${check.message}`);
+            }
+        }
+        console.log();
+        if (result.healthy) {
+            printSuccess('All critical checks passed.');
+        }
+        else {
+            printWarning('Some critical checks failed. See above for details.');
+        }
+    }
+    catch (err) {
+        printError(err instanceof Error ? err.message : 'Doctor checks failed');
+    }
+}
+/**
+ * Handle /review or /audit slash command - post-build project audit
+ */
+async function handleReviewSlashCommand(state, args = []) {
+    if (!state.projectDir) {
+        printError('No active project. Create or resume a project first.');
+        return;
+    }
+    // Parse CLI-style flags from args
+    const options = {};
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if ((arg === '--depth' || arg === '-d') && args[i + 1]) {
+            options.depth = parseInt(args[++i], 10);
+        }
+        else if (arg === '--strict' || arg === '-s') {
+            options.strict = true;
+        }
+        else if ((arg === '--format' || arg === '-f') && args[i + 1]) {
+            options.format = args[++i];
+        }
+        else if (arg === '--no-recover') {
+            options.recover = false;
+        }
+        else if (arg === '--recover') {
+            options.recover = true;
+        }
+        else if ((arg === '--target' || arg === '-t') && args[i + 1]) {
+            options.target = args[++i];
+        }
+    }
+    try {
+        const { runReview } = await import('./commands/review.js');
+        console.log();
+        await runReview(state.projectDir, options);
+    }
+    catch (err) {
+        printError(err instanceof Error ? err.message : 'Audit failed');
+    }
+}
 /**
  * Handle /overview command - full project plan and milestone review
  */
@@ -1468,73 +1609,89 @@ async function handleResume(state, args) {
         printError('Authentication required. Run /auth first.');
         return;
     }
-    // Discover all projects (registered + scanned in current directory)
-    console.log();
-    printInfo('Scanning for projects...');
-    const { all: allProjects } = await discoverProjects(state.projectDir || process.cwd());
-    // If projects found, let user select one
-    if (allProjects.length > 0) {
-        console.log();
-        console.log(theme.primary.bold('  Found Projects:'));
-        console.log();
-        // Show project list with numbers
-        const displayProjects = allProjects.slice(0, 10); // Limit to 10
-        for (let i = 0; i < displayProjects.length; i++) {
-            const project = displayProjects[i];
-            const info = formatProjectForDisplay(project);
-            const statusColor = project.status === 'complete' ? theme.success :
-                project.status === 'failed' ? theme.error :
-                    project.status === 'in-progress' ? theme.warning : theme.dim;
-            console.log(`    ${theme.primary(`${i + 1}.`)} ${theme.secondary(info.name)}`);
-            console.log(`       ${statusColor(info.status)} ${theme.dim('|')} ${info.age}`);
-            console.log(`       ${theme.dim(info.path)}`);
-            if (project.idea) {
-                console.log(`       ${theme.dim(project.idea.slice(0, 60))}${project.idea.length > 60 ? '...' : ''}`);
+    // Reason: If there's already an active project with pending work (e.g., from /review recovery),
+    // skip project discovery and go straight to resuming.
+    if (state.projectDir) {
+        const activeStatus = await getWorkflowStatus(state.projectDir);
+        if (activeStatus.exists && activeStatus.state) {
+            const { phase, status: pStatus } = activeStatus.state;
+            const hasPendingWork = phase !== 'complete' || pStatus !== 'complete';
+            if (hasPendingWork) {
+                printInfo(`Resuming active project: ${activeStatus.state.name}`);
+                // Fall through to the resume logic below (skip discovery)
             }
-            console.log();
         }
-        if (allProjects.length > 10) {
-            console.log(theme.dim(`    ... and ${allProjects.length - 10} more projects`));
+    }
+    // Only discover projects if no active project with pending work
+    if (!state.projectDir || (await getWorkflowStatus(state.projectDir)).state?.phase === 'complete') {
+        // Discover all projects (registered + scanned in current directory)
+        console.log();
+        printInfo('Scanning for projects...');
+        const { all: allProjects } = await discoverProjects(state.projectDir || process.cwd());
+        // If projects found, let user select one
+        if (allProjects.length > 0) {
             console.log();
-        }
-        // Let user select
-        const selection = await promptSelection('Select a project to resume:', [
-            ...displayProjects.map((p, i) => ({
-                value: String(i),
-                label: `${p.name} (${formatProjectForDisplay(p).age})`,
-            })),
-            { value: 'scan', label: 'Scan for more projects...' },
-            { value: 'cancel', label: 'Cancel' },
-        ], '0');
-        if (selection === 'cancel') {
-            printInfo('Cancelled');
-            return;
-        }
-        if (selection === 'scan') {
-            // Scan deeper in current directory
-            printInfo('Scanning subdirectories...');
-            const { all: deepScan } = await discoverProjects(state.projectDir || process.cwd());
-            if (deepScan.length === allProjects.length) {
-                printWarning('No additional projects found');
+            console.log(theme.primary.bold('  Found Projects:'));
+            console.log();
+            // Show project list with numbers
+            const displayProjects = allProjects.slice(0, 10); // Limit to 10
+            for (let i = 0; i < displayProjects.length; i++) {
+                const project = displayProjects[i];
+                const info = formatProjectForDisplay(project);
+                const statusColor = project.status === 'complete' ? theme.success :
+                    project.status === 'failed' ? theme.error :
+                        project.status === 'in-progress' ? theme.warning : theme.dim;
+                console.log(`    ${theme.primary(`${i + 1}.`)} ${theme.secondary(info.name)}`);
+                console.log(`       ${statusColor(info.status)} ${theme.dim('|')} ${info.age}`);
+                console.log(`       ${theme.dim(info.path)}`);
+                if (project.idea) {
+                    console.log(`       ${theme.dim(project.idea.slice(0, 60))}${project.idea.length > 60 ? '...' : ''}`);
+                }
+                console.log();
             }
-            else {
-                printSuccess(`Found ${deepScan.length - allProjects.length} additional projects`);
+            if (allProjects.length > 10) {
+                console.log(theme.dim(`    ... and ${allProjects.length - 10} more projects`));
+                console.log();
             }
-            // Recursively call handleResume to show updated list
-            await handleResume(state, args);
-            return;
-        }
-        const selectedIndex = parseInt(selection, 10);
-        const selectedProject = displayProjects[selectedIndex];
-        if (!selectedProject) {
-            printError('Invalid selection');
-            return;
+            // Let user select
+            const selection = await promptSelection('Select a project to resume:', [
+                ...displayProjects.map((p, i) => ({
+                    value: String(i),
+                    label: `${p.name} (${formatProjectForDisplay(p).age})`,
+                })),
+                { value: 'scan', label: 'Scan for more projects...' },
+                { value: 'cancel', label: 'Cancel' },
+            ], '0');
+            if (selection === 'cancel') {
+                printInfo('Cancelled');
+                return;
+            }
+            if (selection === 'scan') {
+                // Scan deeper in current directory
+                printInfo('Scanning subdirectories...');
+                const { all: deepScan } = await discoverProjects(state.projectDir || process.cwd());
+                if (deepScan.length === allProjects.length) {
+                    printWarning('No additional projects found');
+                }
+                else {
+                    printSuccess(`Found ${deepScan.length - allProjects.length} additional projects`);
+                }
+                // Recursively call handleResume to show updated list
+                await handleResume(state, args);
+                return;
+            }
+            const selectedIndex = parseInt(selection, 10);
+            const selectedProject = displayProjects[selectedIndex];
+            if (!selectedProject) {
+                printError('Invalid selection');
+                return;
+            }
+            // Set the project directory and continue
+            state.projectDir = selectedProject.path;
+            console.log();
+            printInfo(`Selected: ${selectedProject.name}`);
         }
-        // Set the project directory and continue
-        state.projectDir = selectedProject.path;
-        console.log();
-        printInfo(`Selected: ${selectedProject.name}`);
-    }
+    } // end: project discovery block
     // Now check for formal project state at the selected/current directory
     if (!state.projectDir) {
         printError('No project directory set');