popeye-cli 1.6.0 → 1.8.0

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,6 @@ 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';
 //# 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"}

package/dist/cli/commands/index.js

@@ -7,4 +7,6 @@ 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';
 //# 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"}

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

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, } from './commands/index.js';
 import { startInteractiveMode } from './interactive.js';
 import { printError } from './output.js';
 // Re-export
@@ -38,6 +38,8 @@ export function createProgram() {
     program.addCommand(createResetCommand());
     program.addCommand(createCancelCommand());
     program.addCommand(createConfigCommand());
+    program.addCommand(createDbCommand());
+    program.addCommand(createDoctorCommand());
     // 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":"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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;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;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"}

package/dist/cli/interactive.js

@@ -697,6 +697,8 @@ 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'],
         ['/clear', 'Clear screen'],
         ['/exit', 'Exit Popeye'],
     ];
@@ -838,6 +840,12 @@ async function handleInput(input, state) {
                     await handleNewProject(args.join(' '), state);
                 }
                 break;
+            case '/db':
+                await handleDbSlashCommand(state, args);
+                break;
+            case '/doctor':
+                await handleDoctorSlashCommand(state);
+                break;
             default:
                 printError(`Unknown command: ${cmd}`);
                 printInfo('Type /help for available commands');
@@ -872,6 +880,94 @@ 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 /overview command - full project plan and milestone review
  */