popeye-cli 1.6.0 → 1.8.0

package/dist/workflow/db-setup-runner.js

@@ -0,0 +1,336 @@
+/**
+ * Database setup pipeline runner
+ * Executes sequential steps to configure, migrate, and verify a database
+ */
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { exec } from 'node:child_process';
+import { promisify } from 'node:util';
+import { transitionDbStatus } from './db-state-machine.js';
+const execAsync = promisify(exec);
+/**
+ * Read and parse a .env file for key=value pairs
+ *
+ * @param envPath - Path to .env file
+ * @returns Map of environment variable key-value pairs
+ */
+export async function readEnvFile(envPath) {
+    const result = {};
+    try {
+        const content = await fs.readFile(envPath, 'utf-8');
+        for (const line of content.split('\n')) {
+            const trimmed = line.trim();
+            if (!trimmed || trimmed.startsWith('#'))
+                continue;
+            const eqIndex = trimmed.indexOf('=');
+            if (eqIndex === -1)
+                continue;
+            const key = trimmed.slice(0, eqIndex).trim();
+            let value = trimmed.slice(eqIndex + 1).trim();
+            // Strip surrounding quotes
+            if ((value.startsWith('"') && value.endsWith('"')) ||
+                (value.startsWith("'") && value.endsWith("'"))) {
+                value = value.slice(1, -1);
+            }
+            result[key] = value;
+        }
+    }
+    catch {
+        // File doesn't exist or isn't readable
+    }
+    return result;
+}
+/**
+ * Scan migration files for prerequisite extension comments
+ * Looks for lines like: # popeye:requires_extension=vector
+ *
+ * @param migrationsDir - Path to migrations/versions/ directory
+ * @returns Array of required extension names
+ */
+export async function parseMigrationPrereqs(migrationsDir) {
+    const extensions = [];
+    const versionsDir = path.join(migrationsDir, 'versions');
+    try {
+        const files = await fs.readdir(versionsDir);
+        for (const file of files) {
+            if (!file.endsWith('.py'))
+                continue;
+            const content = await fs.readFile(path.join(versionsDir, file), 'utf-8');
+            const matches = content.matchAll(/# popeye:requires_extension=(\w+)/g);
+            for (const match of matches) {
+                if (!extensions.includes(match[1])) {
+                    extensions.push(match[1]);
+                }
+            }
+        }
+    }
+    catch {
+        // Directory doesn't exist or isn't readable
+    }
+    return extensions;
+}
+/**
+ * Derive the snake_case package name from the project state
+ *
+ * @param projectDir - Project root directory
+ * @returns Python package name
+ */
+export async function getPackageName(projectDir) {
+    try {
+        const statePath = path.join(projectDir, '.popeye', 'state.json');
+        const content = await fs.readFile(statePath, 'utf-8');
+        const state = JSON.parse(content);
+        const name = state.name || 'project';
+        return name.toLowerCase().replace(/-/g, '_').replace(/[^a-z0-9_]/g, '');
+    }
+    catch {
+        return 'backend';
+    }
+}
+/**
+ * Resolve the backend directory path
+ *
+ * @param projectDir - Project root directory
+ * @returns Absolute path to apps/backend
+ */
+export function resolveBackendDir(projectDir) {
+    return path.join(projectDir, 'apps', 'backend');
+}
+/**
+ * Execute a single pipeline step and track timing
+ */
+async function executeStep(step, fn, options) {
+    options?.onStep?.(step, 'start', `Starting ${step}...`);
+    const start = Date.now();
+    try {
+        const message = await fn();
+        const durationMs = Date.now() - start;
+        options?.onStep?.(step, 'success', message);
+        return { step, success: true, message, durationMs };
+    }
+    catch (err) {
+        const durationMs = Date.now() - start;
+        const error = err instanceof Error ? err.message : String(err);
+        options?.onStep?.(step, 'fail', error);
+        return { step, success: false, message: `Step failed: ${step}`, durationMs, error };
+    }
+}
+/**
+ * Step 1: Check database connection
+ */
+async function checkConnection(backendDir) {
+    const env = await readEnvFile(path.join(backendDir, '.env'));
+    const dbUrl = env['DATABASE_URL'] || '';
+    if (!dbUrl) {
+        throw new Error('DATABASE_URL not found in apps/backend/.env. ' +
+            'Run "popeye db configure" to set it up.');
+    }
+    // Test connectivity using Python asyncpg
+    const cmd = `cd "${backendDir}" && python3 -c "
+import asyncio, asyncpg, os
+async def check():
+    conn = await asyncpg.connect('${dbUrl.replace(/'/g, "\\'")}')
+    await conn.execute('SELECT 1')
+    await conn.close()
+asyncio.run(check())
+"`;
+    try {
+        await execAsync(cmd, { timeout: 15000 });
+        return 'Database connection verified successfully';
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        throw new Error(`Database connection failed: ${msg}`);
+    }
+}
+/**
+ * Step 2: Ensure required extensions
+ */
+async function ensureExtensions(backendDir) {
+    const migrationsDir = path.join(backendDir, 'migrations');
+    const extensions = await parseMigrationPrereqs(migrationsDir);
+    if (extensions.length === 0) {
+        return 'No prerequisite extensions required';
+    }
+    const env = await readEnvFile(path.join(backendDir, '.env'));
+    const dbUrl = env['DATABASE_URL'] || '';
+    for (const ext of extensions) {
+        const cmd = `cd "${backendDir}" && python3 -c "
+import asyncio, asyncpg
+async def ensure():
+    conn = await asyncpg.connect('${dbUrl.replace(/'/g, "\\'")}')
+    await conn.execute('CREATE EXTENSION IF NOT EXISTS ${ext}')
+    await conn.close()
+asyncio.run(ensure())
+"`;
+        try {
+            await execAsync(cmd, { timeout: 15000 });
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            throw new Error(`Failed to create extension '${ext}': ${msg}`);
+        }
+    }
+    return `Extensions verified: ${extensions.join(', ')}`;
+}
+/**
+ * Step 3: Apply Alembic migrations
+ */
+async function applyMigrations(backendDir) {
+    const cmd = `cd "${backendDir}" && alembic upgrade head 2>&1`;
+    try {
+        const { stdout } = await execAsync(cmd, { timeout: 60000 });
+        // Count applied migrations from output
+        const appliedMatches = stdout.match(/Running upgrade/g);
+        const count = appliedMatches ? appliedMatches.length : 0;
+        return count > 0
+            ? `Applied ${count} migration(s) successfully`
+            : 'All migrations already up to date';
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        throw new Error(`Migration failed: ${msg}`);
+    }
+}
+/**
+ * Step 4: Run seed script (if exists)
+ */
+async function seedMinimal(backendDir) {
+    const seedPaths = [
+        path.join(backendDir, 'scripts', 'seed.py'),
+        path.join(backendDir, 'seed.py'),
+    ];
+    let seedPath = null;
+    for (const p of seedPaths) {
+        try {
+            await fs.access(p);
+            seedPath = p;
+            break;
+        }
+        catch {
+            // Try next
+        }
+    }
+    if (!seedPath) {
+        return 'No seed script found (skipped)';
+    }
+    const cmd = `cd "${backendDir}" && python3 "${seedPath}" 2>&1`;
+    try {
+        await execAsync(cmd, { timeout: 30000 });
+        return 'Seed script executed successfully';
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        throw new Error(`Seed script failed: ${msg}`);
+    }
+}
+/**
+ * Step 5: Run readiness tests
+ */
+async function runReadinessTests(backendDir) {
+    const env = await readEnvFile(path.join(backendDir, '.env'));
+    const dbUrl = env['DATABASE_URL'] || '';
+    const cmd = `cd "${backendDir}" && python3 -c "
+import asyncio, asyncpg
+async def check():
+    conn = await asyncpg.connect('${dbUrl.replace(/'/g, "\\'")}')
+    # Verify connectivity
+    await conn.execute('SELECT 1')
+    # Verify alembic_version table exists and has a version
+    row = await conn.fetchrow('SELECT version_num FROM alembic_version LIMIT 1')
+    if row is None:
+        raise Exception('No migration version found in alembic_version table')
+    await conn.close()
+    return row['version_num']
+asyncio.run(check())
+"`;
+    try {
+        await execAsync(cmd, { timeout: 15000 });
+        return 'Readiness tests passed: connectivity and migration version verified';
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        throw new Error(`Readiness tests failed: ${msg}`);
+    }
+}
+/**
+ * Run the complete database setup pipeline
+ *
+ * Steps execute sequentially. Pipeline stops on first failure.
+ *
+ * @param projectDir - Project root directory
+ * @param options - Pipeline options
+ * @returns Full pipeline result
+ */
+export async function runDbSetupPipeline(projectDir, options = {}) {
+    const backendDir = resolveBackendDir(projectDir);
+    const steps = [];
+    const pipelineStart = Date.now();
+    // Step 1: Check connection
+    const connResult = await executeStep('check_connection', () => checkConnection(backendDir), options);
+    steps.push(connResult);
+    if (!connResult.success) {
+        return buildResult(steps, pipelineStart, 'error');
+    }
+    // Step 2: Ensure extensions
+    const extResult = await executeStep('ensure_extensions', () => ensureExtensions(backendDir), options);
+    steps.push(extResult);
+    if (!extResult.success) {
+        return buildResult(steps, pipelineStart, 'error');
+    }
+    // Step 3: Apply migrations
+    const migResult = await executeStep('apply_migrations', () => applyMigrations(backendDir), options);
+    steps.push(migResult);
+    if (!migResult.success) {
+        return buildResult(steps, pipelineStart, 'error');
+    }
+    // Step 4: Seed (optional)
+    if (!options.skipSeed) {
+        const seedResult = await executeStep('seed_minimal', () => seedMinimal(backendDir), options);
+        steps.push(seedResult);
+        if (!seedResult.success) {
+            return buildResult(steps, pipelineStart, 'error');
+        }
+    }
+    // Step 5: Readiness tests
+    const readyResult = await executeStep('readiness_tests', () => runReadinessTests(backendDir), options);
+    steps.push(readyResult);
+    if (!readyResult.success) {
+        return buildResult(steps, pipelineStart, 'error');
+    }
+    // Step 6: Mark ready (always succeeds if we got here)
+    const markResult = await executeStep('mark_ready', async () => {
+        return 'Database marked as ready';
+    }, options);
+    steps.push(markResult);
+    return buildResult(steps, pipelineStart, 'ready');
+}
+/**
+ * Build a SetupResult from accumulated steps
+ */
+function buildResult(steps, pipelineStart, finalStatus) {
+    const totalDurationMs = Date.now() - pipelineStart;
+    const success = finalStatus === 'ready';
+    const failedStep = steps.find((s) => !s.success);
+    return {
+        success,
+        steps,
+        totalDurationMs,
+        finalStatus,
+        error: failedStep?.error,
+    };
+}
+/**
+ * Compute the new DB status after a pipeline run and validate the transition
+ *
+ * @param currentStatus - Current DB status from state
+ * @param pipelineResult - Result of the pipeline run
+ * @returns New DB status after validated transition
+ */
+export function computePostPipelineStatus(currentStatus, pipelineResult) {
+    // Transition to 'applying' first
+    const applying = transitionDbStatus(currentStatus, 'applying');
+    // Then transition to final status
+    return transitionDbStatus(applying, pipelineResult.finalStatus);
+}
+//# sourceMappingURL=db-setup-runner.js.map

package/dist/workflow/db-setup-runner.js.map

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

package/dist/workflow/db-state-machine.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Database lifecycle state machine
+ * Enforces valid transitions between DB status states
+ */
+import type { DbStatus } from '../types/database.js';
+/**
+ * Check if a transition from current to target is valid
+ *
+ * @param current - Current DB status
+ * @param target - Target DB status
+ * @returns True if the transition is allowed
+ */
+export declare function canTransition(current: DbStatus, target: DbStatus): boolean;
+/**
+ * Validate and execute a state transition
+ *
+ * @param current - Current DB status
+ * @param target - Desired target status
+ * @returns The new status
+ * @throws Error if the transition is invalid
+ */
+export declare function transitionDbStatus(current: DbStatus, target: DbStatus): DbStatus;
+/**
+ * Get the list of valid next states from the current status
+ *
+ * @param current - Current DB status
+ * @returns Array of valid target states
+ */
+export declare function getAvailableTransitions(current: DbStatus): DbStatus[];
+//# sourceMappingURL=db-state-machine.d.ts.map

package/dist/workflow/db-state-machine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db-state-machine.d.ts","sourceRoot":"","sources":["../../src/workflow/db-state-machine.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAcrD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,GAAG,OAAO,CAG1E;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAQhF;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,QAAQ,GAAG,QAAQ,EAAE,CAErE"}

package/dist/workflow/db-state-machine.js

@@ -0,0 +1,51 @@
+/**
+ * Database lifecycle state machine
+ * Enforces valid transitions between DB status states
+ */
+/**
+ * Valid state transitions map
+ * Each key maps to an array of valid target states
+ */
+const VALID_TRANSITIONS = {
+    unconfigured: ['configured'],
+    configured: ['applying', 'unconfigured'],
+    applying: ['ready', 'error'],
+    ready: ['configured', 'unconfigured'],
+    error: ['configured', 'unconfigured'],
+};
+/**
+ * Check if a transition from current to target is valid
+ *
+ * @param current - Current DB status
+ * @param target - Target DB status
+ * @returns True if the transition is allowed
+ */
+export function canTransition(current, target) {
+    const allowed = VALID_TRANSITIONS[current];
+    return allowed !== undefined && allowed.includes(target);
+}
+/**
+ * Validate and execute a state transition
+ *
+ * @param current - Current DB status
+ * @param target - Desired target status
+ * @returns The new status
+ * @throws Error if the transition is invalid
+ */
+export function transitionDbStatus(current, target) {
+    if (!canTransition(current, target)) {
+        throw new Error(`Invalid DB status transition: '${current}' -> '${target}'. ` +
+            `Allowed transitions from '${current}': [${getAvailableTransitions(current).join(', ')}]`);
+    }
+    return target;
+}
+/**
+ * Get the list of valid next states from the current status
+ *
+ * @param current - Current DB status
+ * @returns Array of valid target states
+ */
+export function getAvailableTransitions(current) {
+    return VALID_TRANSITIONS[current] || [];
+}
+//# sourceMappingURL=db-state-machine.js.map

package/dist/workflow/db-state-machine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"db-state-machine.js","sourceRoot":"","sources":["../../src/workflow/db-state-machine.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;;GAGG;AACH,MAAM,iBAAiB,GAAiC;IACtD,YAAY,EAAE,CAAC,YAAY,CAAC;IAC5B,UAAU,EAAE,CAAC,UAAU,EAAE,cAAc,CAAC;IACxC,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC;IAC5B,KAAK,EAAE,CAAC,YAAY,EAAE,cAAc,CAAC;IACrC,KAAK,EAAE,CAAC,YAAY,EAAE,cAAc,CAAC;CACtC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,OAAiB,EAAE,MAAgB;IAC/D,MAAM,OAAO,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAC3C,OAAO,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AAC3D,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAiB,EAAE,MAAgB;IACpE,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CACb,kCAAkC,OAAO,SAAS,MAAM,KAAK;YAC7D,6BAA6B,OAAO,OAAO,uBAAuB,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAC1F,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAAiB;IACvD,OAAO,iBAAiB,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;AAC1C,CAAC"}

package/dist/workflow/execution-mode.js

@@ -696,10 +696,10 @@ ${task.name}
 ## Description
 ${task.description || task.name}
 
-${task.testPlan ? `## Test Requirements\n${task.testPlan}\n` : ''}
+${task.qaTestPlanText ? `## QA Test Plan\nImplement tests according to this approved test plan:\n${task.qaTestPlanText}\n` : ''}
 
 Please implement this task completely. After implementing:
-1. Create appropriate tests if needed
+1. Implement tests as specified in the QA Test Plan above
 2. Ensure code follows best practices
 3. Document any complex logic
 `.trim();