popeye-cli 1.10.0 → 2.1.0

package/dist/pipeline/phases/review.js

@@ -0,0 +1,127 @@
+/**
+ * REVIEW phase — verify implementation matches approved plans.
+ * Detects drift via snapshot diff (P1-E).
+ * v1.1: Creates Change Requests when drift is detected.
+ */
+import { successResult, failureResult } from './phase-context.js';
+import { generateRepoSnapshot, createSnapshotArtifact, diffSnapshots } from '../repo-snapshot.js';
+import { buildChangeRequest, formatChangeRequest, routeChangeRequest } from '../change-request.js';
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+export async function runReview(context) {
+    const { pipeline, artifactManager, projectDir } = context;
+    const artifacts = [];
+    const changeRequests = [];
+    try {
+        // 1. Generate fresh snapshot
+        const currentSnapshot = await generateRepoSnapshot(projectDir);
+        const snapshotEntry = createSnapshotArtifact(currentSnapshot, artifactManager, 'REVIEW');
+        artifacts.push(snapshotEntry);
+        pipeline.latestRepoSnapshot = artifactManager.toArtifactRef(snapshotEntry);
+        // 2. Find role-plan-approval snapshot for drift detection
+        const rolePlanSnapshots = pipeline.artifacts.filter((a) => a.type === 'repo_snapshot' && a.phase === 'CONSENSUS_ROLE_PLANS');
+        const baselineSnapshot = rolePlanSnapshots[rolePlanSnapshots.length - 1];
+        let driftReport = 'No baseline snapshot found for drift detection.';
+        let hasDrift = false;
+        if (baselineSnapshot) {
+            const baselinePath = join(projectDir, baselineSnapshot.path);
+            if (existsSync(baselinePath)) {
+                try {
+                    const baselineData = JSON.parse(readFileSync(baselinePath, 'utf-8'));
+                    const diff = diffSnapshots(baselineData, currentSnapshot);
+                    if (diff.has_changes) {
+                        hasDrift = true;
+                        driftReport = [
+                            '## Implementation Drift Detected',
+                            '',
+                            `Files delta: ${diff.files_delta > 0 ? '+' : ''}${diff.files_delta}`,
+                            `Lines delta: ${diff.lines_delta > 0 ? '+' : ''}${diff.lines_delta}`,
+                            diff.added_configs.length > 0 ? `Added configs: ${diff.added_configs.join(', ')}` : '',
+                            diff.removed_configs.length > 0 ? `Removed configs: ${diff.removed_configs.join(', ')}` : '',
+                            diff.changed_configs.length > 0 ? `Changed configs: ${diff.changed_configs.join(', ')}` : '',
+                        ].filter(Boolean).join('\n');
+                        // v1.1: Create change requests for detected drift
+                        if (diff.changed_configs.length > 0) {
+                            const cr = buildChangeRequest({
+                                originPhase: 'REVIEW',
+                                requestedBy: 'REVIEWER',
+                                changeType: 'config',
+                                description: `Config files changed during implementation: ${diff.changed_configs.join(', ')}`,
+                                justification: 'Detected by snapshot diff during review phase',
+                                affectedArtifacts: [artifactManager.toArtifactRef(snapshotEntry)],
+                                affectedPhases: ['IMPLEMENTATION', 'QA_VALIDATION'],
+                                riskLevel: diff.changed_configs.length > 3 ? 'high' : 'medium',
+                            });
+                            changeRequests.push(cr);
+                        }
+                        if (Math.abs(diff.lines_delta) > 1000) {
+                            const cr = buildChangeRequest({
+                                originPhase: 'REVIEW',
+                                requestedBy: 'REVIEWER',
+                                changeType: 'scope',
+                                description: `Significant scope drift detected: ${diff.lines_delta > 0 ? '+' : ''}${diff.lines_delta} lines`,
+                                justification: 'Large line delta suggests scope changes beyond approved plans',
+                                affectedArtifacts: [artifactManager.toArtifactRef(snapshotEntry)],
+                                affectedPhases: ['CONSENSUS_MASTER_PLAN', 'IMPLEMENTATION'],
+                                riskLevel: 'high',
+                            });
+                            changeRequests.push(cr);
+                        }
+                    }
+                    else {
+                        driftReport = 'No drift detected between approved plans and implementation.';
+                    }
+                }
+                catch {
+                    driftReport = 'Failed to parse baseline snapshot for drift detection.';
+                }
+            }
+        }
+        // 3. Store change requests as artifacts and register in pipeline state
+        for (const cr of changeRequests) {
+            const crEntry = artifactManager.createAndStoreText('change_request', formatChangeRequest(cr), 'REVIEW');
+            artifacts.push(crEntry);
+            // Register CR in pipeline state for orchestrator routing
+            if (!pipeline.pendingChangeRequests) {
+                pipeline.pendingChangeRequests = [];
+            }
+            pipeline.pendingChangeRequests.push({
+                cr_id: cr.cr_id,
+                change_type: cr.change_type,
+                target_phase: routeChangeRequest(cr),
+                status: 'proposed',
+            });
+        }
+        // 4. Create review decision artifact
+        const reviewDoc = [
+            '# Review Decision',
+            '',
+            `**Timestamp:** ${new Date().toISOString()}`,
+            `**Phase:** REVIEW`,
+            `**Drift Detected:** ${hasDrift ? 'Yes' : 'No'}`,
+            `**Change Requests:** ${changeRequests.length}`,
+            '',
+            '## Drift Analysis',
+            driftReport,
+            '',
+            changeRequests.length > 0 ? '## Change Requests\n' + changeRequests.map((cr) => `- ${cr.cr_id}: ${cr.description}`).join('\n') : '',
+            '',
+            '## Plan Alignment',
+            'Implementation reviewed against approved role plans.',
+            '',
+            '## Decision',
+            hasDrift && changeRequests.length > 0
+                ? 'Review flagged drift — change requests created for consensus review.'
+                : 'Review completed. See drift analysis above.',
+        ].join('\n');
+        const reviewEntry = artifactManager.createAndStoreText('review_decision', reviewDoc, 'REVIEW');
+        artifacts.push(reviewEntry);
+        pipeline.artifacts.push(...artifacts);
+        return successResult('REVIEW', artifacts, `Review complete. ${changeRequests.length} change requests.`);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : 'Unknown error';
+        return failureResult('REVIEW', 'Review failed', message);
+    }
+}
+//# sourceMappingURL=review.js.map

package/dist/pipeline/phases/review.js.map

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

package/dist/pipeline/phases/role-planning.d.ts

@@ -0,0 +1,7 @@
+/**
+ * ROLE_PLANNING phase — produce deterministic implementation plans by role.
+ * Runs per-role: DB, BE, FE, Website, QA. Creates role_plan artifacts.
+ */
+import type { PhaseContext, PhaseResult } from './phase-context.js';
+export declare function runRolePlanning(context: PhaseContext): Promise<PhaseResult>;
+//# sourceMappingURL=role-planning.d.ts.map

package/dist/pipeline/phases/role-planning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"role-planning.d.ts","sourceRoot":"","sources":["../../../src/pipeline/phases/role-planning.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAYpE,wBAAsB,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAsEjF"}

package/dist/pipeline/phases/role-planning.js

@@ -0,0 +1,75 @@
+/**
+ * ROLE_PLANNING phase — produce deterministic implementation plans by role.
+ * Runs per-role: DB, BE, FE, Website, QA. Creates role_plan artifacts.
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { successResult, failureResult } from './phase-context.js';
+/** Roles that produce implementation plans */
+const PLANNING_ROLES = [
+    'DB_EXPERT',
+    'BACKEND_PROGRAMMER',
+    'FRONTEND_PROGRAMMER',
+    'WEBSITE_PROGRAMMER',
+    'QA_TESTER',
+];
+export async function runRolePlanning(context) {
+    const { pipeline, artifactManager, skillLoader, projectDir } = context;
+    const artifacts = [];
+    try {
+        // Read architecture doc for context
+        const archArtifact = pipeline.artifacts.find((a) => a.type === 'architecture');
+        let architectureContent = '';
+        if (archArtifact) {
+            const fullPath = join(projectDir, archArtifact.path);
+            if (existsSync(fullPath)) {
+                architectureContent = readFileSync(fullPath, 'utf-8');
+            }
+        }
+        // Read master plan for context
+        const masterPlanArtifact = pipeline.artifacts.find((a) => a.type === 'master_plan');
+        let masterPlanContent = '';
+        if (masterPlanArtifact) {
+            const fullPath = join(projectDir, masterPlanArtifact.path);
+            if (existsSync(fullPath)) {
+                masterPlanContent = readFileSync(fullPath, 'utf-8');
+            }
+        }
+        const { executePrompt } = await import('../../adapters/claude.js');
+        // Generate plan for each role
+        for (const role of PLANNING_ROLES) {
+            // Skip website if not in active roles
+            if (role === 'WEBSITE_PROGRAMMER' && !pipeline.activeRoles.includes('WEBSITE_PROGRAMMER')) {
+                continue;
+            }
+            const skill = skillLoader.loadSkill(role);
+            const planPrompt = [
+                skill.systemPrompt,
+                '',
+                '## Master Plan',
+                masterPlanContent.slice(0, 5000),
+                '',
+                '## Architecture',
+                architectureContent.slice(0, 5000),
+                '',
+                '## Instructions',
+                `Create your ${role} implementation plan. Include:`,
+                '- Deterministic file-level outputs',
+                '- Specific tasks with acceptance criteria',
+                '- Dependencies on other roles',
+                '- Test requirements',
+            ].join('\n');
+            const planResult = await executePrompt(planPrompt);
+            const plan = planResult.response;
+            const entry = artifactManager.createAndStoreText('role_plan', `# ${role} Plan\n\n${plan}`, 'ROLE_PLANNING');
+            artifacts.push(entry);
+        }
+        pipeline.artifacts.push(...artifacts);
+        return successResult('ROLE_PLANNING', artifacts, `Created ${artifacts.length} role plans`);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : 'Unknown error';
+        return failureResult('ROLE_PLANNING', 'Role planning failed', message);
+    }
+}
+//# sourceMappingURL=role-planning.js.map

package/dist/pipeline/phases/role-planning.js.map

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

package/dist/pipeline/phases/stuck.d.ts

@@ -0,0 +1,7 @@
+/**
+ * STUCK phase — safety valve when max recovery iterations exceeded.
+ * Produces stuck report with last RCA, suspected paths, required human input.
+ */
+import type { PhaseContext, PhaseResult } from './phase-context.js';
+export declare function runStuck(context: PhaseContext): Promise<PhaseResult>;
+//# sourceMappingURL=stuck.d.ts.map

package/dist/pipeline/phases/stuck.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stuck.d.ts","sourceRoot":"","sources":["../../../src/pipeline/phases/stuck.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGpE,wBAAsB,QAAQ,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAqD1E"}

package/dist/pipeline/phases/stuck.js

@@ -0,0 +1,51 @@
+/**
+ * STUCK phase — safety valve when max recovery iterations exceeded.
+ * Produces stuck report with last RCA, suspected paths, required human input.
+ */
+import { successResult, failureResult } from './phase-context.js';
+export async function runStuck(context) {
+    const { pipeline, artifactManager } = context;
+    const artifacts = [];
+    try {
+        // Find last RCA
+        const lastRca = pipeline.artifacts
+            .filter((a) => a.type === 'rca_report')
+            .sort((a, b) => b.timestamp.localeCompare(a.timestamp))[0];
+        const stuckReport = [
+            '# Stuck Report',
+            '',
+            `**Timestamp:** ${new Date().toISOString()}`,
+            `**Recovery Iterations:** ${pipeline.recoveryCount} / ${pipeline.maxRecoveryIterations}`,
+            `**Failed Phase:** ${pipeline.failedPhase ?? 'unknown'}`,
+            '',
+            '## Last RCA',
+            lastRca ? `See: ${lastRca.path}` : 'No RCA available',
+            '',
+            '## Suspected Resolution Paths',
+            '1. Review the last RCA report for root cause details',
+            '2. Check the failing gate conditions and resolve blockers manually',
+            '3. Consider reverting to a known good state and re-running',
+            '',
+            '## Required Human Input',
+            '- Review failing gate conditions',
+            '- Determine if scope changes are needed',
+            '- Decide whether to restart pipeline from a specific phase',
+            '',
+            '## Artifacts That May Need Update',
+            ...pipeline.artifacts
+                .filter((a) => a.phase === pipeline.failedPhase)
+                .map((a) => `- ${a.type}: ${a.path}`),
+        ].join('\n');
+        const stuckEntry = artifactManager.createAndStoreText('stuck_report', stuckReport, 'STUCK');
+        artifacts.push(stuckEntry);
+        pipeline.artifacts.push(...artifacts);
+        // Update INDEX
+        artifactManager.updateIndex(pipeline.artifacts);
+        return successResult('STUCK', artifacts, 'Pipeline STUCK. Human intervention required.');
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : 'Unknown error';
+        return failureResult('STUCK', 'Stuck report generation failed', message);
+    }
+}
+//# sourceMappingURL=stuck.js.map

package/dist/pipeline/phases/stuck.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stuck.js","sourceRoot":"","sources":["../../../src/pipeline/phases/stuck.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAElE,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,OAAqB;IAClD,MAAM,EAAE,QAAQ,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC;IAC9C,MAAM,SAAS,GAAG,EAAE,CAAC;IAErB,IAAI,CAAC;QACH,gBAAgB;QAChB,MAAM,OAAO,GAAG,QAAQ,CAAC,SAAS;aAC/B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,YAAY,CAAC;aACtC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAE7D,MAAM,WAAW,GAAG;YAClB,gBAAgB;YAChB,EAAE;YACF,kBAAkB,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE;YAC5C,4BAA4B,QAAQ,CAAC,aAAa,MAAM,QAAQ,CAAC,qBAAqB,EAAE;YACxF,qBAAqB,QAAQ,CAAC,WAAW,IAAI,SAAS,EAAE;YACxD,EAAE;YACF,aAAa;YACb,OAAO,CAAC,CAAC,CAAC,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,kBAAkB;YACrD,EAAE;YACF,+BAA+B;YAC/B,sDAAsD;YACtD,oEAAoE;YACpE,4DAA4D;YAC5D,EAAE;YACF,yBAAyB;YACzB,kCAAkC;YAClC,yCAAyC;YACzC,4DAA4D;YAC5D,EAAE;YACF,mCAAmC;YACnC,GAAG,QAAQ,CAAC,SAAS;iBAClB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,QAAQ,CAAC,WAAW,CAAC;iBAC/C,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;SACxC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEb,MAAM,UAAU,GAAG,eAAe,CAAC,kBAAkB,CACnD,cAAc,EACd,WAAW,EACX,OAAO,CACR,CAAC;QACF,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAE3B,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC;QAEtC,eAAe;QACf,eAAe,CAAC,WAAW,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QAEhD,OAAO,aAAa,CAAC,OAAO,EAAE,SAAS,EAAE,8CAA8C,CAAC,CAAC;IAC3F,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;QACrE,OAAO,aAAa,CAAC,OAAO,EAAE,gCAAgC,EAAE,OAAO,CAAC,CAAC;IAC3E,CAAC;AACH,CAAC"}

package/dist/pipeline/repo-snapshot.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Repo Snapshot Generator — deterministic project state capture.
+ * Generated before every consensus gate for anti-hallucination.
+ * Supports caching via mtime for performance (P2-H).
+ */
+import type { RepoSnapshot } from './types.js';
+import type { ArtifactEntry } from './types.js';
+import { ArtifactManager } from './artifact-manager.js';
+import type { PipelinePhase } from './types.js';
+/** Generate a deterministic snapshot of the project */
+export declare function generateRepoSnapshot(projectDir: string): Promise<RepoSnapshot>;
+/** Store snapshot as an artifact */
+export declare function createSnapshotArtifact(snapshot: RepoSnapshot, artifactManager: ArtifactManager, phase: PipelinePhase): ArtifactEntry;
+/** Compare two snapshots to detect drift */
+export declare function diffSnapshots(before: RepoSnapshot, after: RepoSnapshot): SnapshotDiff;
+export interface SnapshotDiff {
+    added_configs: string[];
+    removed_configs: string[];
+    changed_configs: string[];
+    files_delta: number;
+    lines_delta: number;
+    has_changes: boolean;
+}
+//# sourceMappingURL=repo-snapshot.d.ts.map

package/dist/pipeline/repo-snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-snapshot.d.ts","sourceRoot":"","sources":["../../src/pipeline/repo-snapshot.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,KAAK,EACV,YAAY,EAGb,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAyDhD,uDAAuD;AACvD,wBAAsB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAoCpF;AAED,oCAAoC;AACpC,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,YAAY,EACtB,eAAe,EAAE,eAAe,EAChC,KAAK,EAAE,aAAa,GACnB,aAAa,CAEf;AAED,4CAA4C;AAC5C,wBAAgB,aAAa,CAC3B,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,YAAY,GAClB,YAAY,CAsBd;AAED,MAAM,WAAW,YAAY;IAC3B,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;CACtB"}