popeye-cli 1.8.0 → 1.9.0

package/README.md

@@ -26,7 +26,8 @@ Popeye is an autonomous software development agent that takes a simple project i
 9. **Scans** generated website files for placeholder fingerprints (TODO comments, lorem ipsum, default tiers) and reports quality warnings
 10. **Styles** the application with a professional design system and component library
 11. **Tests** the implementation and fixes issues automatically with Tester-driven fix plans
-12. **Delivers** a complete, working project with polished UI
+12. **Reviews** the completed project with a post-build audit that scores code quality, detects wiring issues, and generates recovery tasks
+13. **Delivers** a complete, working project with polished UI
 
 ## How It Works
 
@@ -435,6 +436,7 @@ Popeye provides real-time feedback:
   - How to run (development, tests, production)
   - Project structure overview
 - **Project Type Upgrade**: Upgrade projects in-place (e.g., python to fullstack, fullstack to all) with automatic file restructuring, scaffolding, and planning integration
+- **Post-Build Audit/Review**: Run `popeye review` to scan your completed project, score it across 8 categories, detect FE-BE wiring issues, and auto-generate recovery milestones for critical findings
 - **Flexible Model Switching**: Use any AI model name for OpenAI, Gemini, or Grok providers -- not limited to a predefined list
 
 ### Automatic UI/UX Design
@@ -895,6 +897,40 @@ popeye config set consensus.threshold 90
 popeye config reset
 ```
 
+### `popeye review` (alias: `audit`)
+
+Run a post-build audit/review of the project. Scans the codebase, produces a structured report with findings and scores, and optionally generates recovery milestones.
+
+```bash
+# Standard audit
+popeye review ./my-project
+
+# Deep audit with strict mode
+popeye review ./my-project --depth 3 --strict
+
+# JSON only, no auto-recovery
+popeye review ./my-project --format json --no-recover
+
+# Audit only the frontend component
+popeye review ./my-project --target frontend
+```
+
+**Options:**
+| Option | Description | Default |
+|--------|-------------|---------|
+| `-d, --depth <level>` | Audit depth: `1`=shallow, `2`=standard, `3`=deep | `2` |
+| `-s, --strict` | Enable strict mode (higher standards) | `false` |
+| `-f, --format <type>` | Output format: `json`, `md`, `both` | `both` |
+| `--no-recover` | Skip auto-injection of recovery milestones | Recovery on |
+| `-t, --target <kind>` | Audit target: `all`, `frontend`, `backend`, `website` | `all` |
+
+The audit runs three stages:
+1. **Scan** -- Deterministic filesystem scan (files, LOC, dependencies, FE-BE wiring matrix)
+2. **Analyze** -- AI-powered analysis producing scored findings across 8 categories
+3. **Recovery** -- Evidence-based recovery plan generation when critical/major findings exist
+
+Reports are written to `.popeye/popeye.audit.md`, `.popeye/popeye.audit.json`, and optionally `.popeye/popeye.recovery.md`/`.json`. Recovery milestones are injected into the project state and can be executed with `popeye resume`.
+
 ### Interactive Mode
 
 Launch an interactive REPL session:
@@ -922,6 +958,7 @@ popeye
 /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 with findings and recovery
 /info                      Show system info (Claude CLI status, API keys, etc.)
 /clear                     Clear screen
 /exit                      Exit interactive mode
@@ -1522,7 +1559,8 @@ src/
 │   ├── interactive.ts    # REPL mode (with /model, /upgrade, /overview, /db, /doctor commands)
 │   └── commands/         # Individual commands
 │       ├── db.ts         # Database management CLI (status/configure/apply)
-│       └── doctor.ts     # Readiness checks (8 checks for DB and project health)
+│       ├── doctor.ts     # Readiness checks (8 checks for DB and project health)
+│       └── review.ts     # Post-build audit/review CLI command
 ├── adapters/             # AI service adapters
 │   ├── claude.ts         # Claude Agent SDK (with rate limiting)
 │   ├── openai.ts         # OpenAI API (default reviewer, marketing persona for websites)
@@ -1590,12 +1628,18 @@ src/
 │   ├── project-verification.ts # Project quality checks
 │   ├── project-structure.ts    # Project directory scanner
 │   ├── remediation.ts    # Consensus-driven failure recovery
-│   └── auto-fix.ts       # Automatic error fixing (enhanced ENOENT tracking)
+│   ├── auto-fix.ts       # Automatic error fixing (enhanced ENOENT tracking)
+│   ├── audit-scanner.ts  # Deterministic project scanning (components, wiring, docs)
+│   ├── audit-analyzer.ts # AI-powered analysis with Serena-first search
+│   ├── audit-reporter.ts # Markdown + JSON report generation
+│   ├── audit-recovery.ts # Evidence-based recovery plan generation
+│   └── audit-mode.ts     # Audit orchestrator (scan -> analyze -> recover)
 └── types/                # TypeScript types
     ├── project.ts        # OutputLanguage, isWorkspace(), flexible OpenAIModelSchema
     ├── workflow.ts       # ProjectStateSchema (qaEnabled, dbConfig, qa* task fields)
     ├── consensus.ts      # GeminiModelSchema, GrokModelSchema, reviewerPersona, testPlanThreshold
     ├── tester.ts         # TestVerdict, TestPlanOutput, TestRunReview, TestFixPlan
+    ├── audit.ts          # Audit system schemas (findings, recovery, wiring, scores)
     ├── database.ts       # DbStatus, DbMode, DbConfig, DbSetupStep Zod schemas
     ├── database-runtime.ts # SetupStepResult, ReadinessCheck runtime schemas
     └── website-strategy.ts # WebsiteStrategyDocument, BrandAssetsContract, DesignTokens

package/cheatsheet.md

@@ -203,6 +203,34 @@ popeye-cli doctor ./my-project
 
 ---
 
+### `popeye-cli review [directory]` (alias: `audit`)
+
+Run a post-build audit/review of the project. Scans the codebase, produces a structured report with findings, and optionally generates recovery milestones.
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `-d, --depth <level>` | Audit depth: `1`=shallow, `2`=standard, `3`=deep | `2` |
+| `-s, --strict` | Enable strict mode (higher standards, stricter recovery triggers) | `false` |
+| `-f, --format <type>` | Output format: `json`, `md`, `both` | `both` |
+| `--no-recover` | Skip auto-injection of recovery milestones | Recovery enabled by default |
+| `-t, --target <kind>` | Audit target: `all`, `frontend`, `backend`, `website` | `all` |
+
+The audit runs three stages:
+1. **Scan** -- Deterministic filesystem scan (files, LOC, deps, wiring matrix)
+2. **Analyze** -- AI-powered analysis producing scored findings
+3. **Recovery** -- Evidence-based recovery plan generation (if critical/major findings exist)
+
+Reports are written to `.popeye/popeye.audit.md`, `.popeye/popeye.audit.json`, and optionally `.popeye/popeye.recovery.md`/`.json`.
+
+```bash
+popeye-cli review ./my-project
+popeye-cli review ./my-project --depth 3 --strict
+popeye-cli review ./my-project --format json --no-recover
+popeye-cli audit ./my-project --target frontend
+```
+
+---
+
 ## Interactive Mode Slash Commands
 
 Enter these commands during an interactive session (started via `popeye-cli interactive`).
@@ -287,6 +315,7 @@ Available upgrade paths depend on the current project type:
 | `/db configure` | Configure database (redirects to CLI) |
 | `/db apply` | Apply database setup (redirects to CLI) |
 | `/doctor` | Run all readiness checks inline |
+| `/review`, `/audit` | Run a post-build audit with findings and optional recovery |
 
 ### Session Control
 
@@ -402,6 +431,10 @@ popeye-cli db apply ./taskmaster
 # Resume after interruption
 popeye-cli resume ./taskmaster
 
+# Audit the project after build
+popeye-cli review ./taskmaster
+popeye-cli review ./taskmaster --depth 3 --strict
+
 # Reset and re-plan
 popeye-cli reset ./taskmaster --phase plan
 ```

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

@@ -9,4 +9,5 @@ export { createResumeCommand, createResetCommand, createCancelCommand } from './
 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;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC1C,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

@@ -9,4 +9,5 @@ export { createResumeCommand, createResetCommand, createCancelCommand } from './
 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;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC1C,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"}

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;AAmBpC,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,CAyCvC;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, createDbCommand, createDoctorCommand, } 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
@@ -40,6 +40,7 @@ export function createProgram() {
     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":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"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"}

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;AAo0EH;;;;;;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

@@ -699,6 +699,7 @@ function showHelp() {
         ['/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'],
     ];
@@ -846,6 +847,10 @@ async function handleInput(input, state) {
             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');
@@ -968,6 +973,46 @@ async function handleDoctorSlashCommand(state) {
         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
  */
@@ -1564,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');