popeye-cli 1.10.0 → 2.1.0

package/dist/pipeline/consensus/consensus-runner.js

@@ -0,0 +1,212 @@
+/**
+ * Consensus Runner — adapter layer between structured packets
+ * and existing consensus machinery.
+ *
+ * Two modes (P1-D):
+ * 1. Independent Review (DEFAULT): N reviewers review simultaneously,
+ *    no reviewer sees other reviewers' output.
+ * 2. Iterative Consensus (optional): for recovery plan iteration.
+ */
+import { createHash } from 'node:crypto';
+import { buildConsensusPacket } from '../packets/consensus-packet-builder.js';
+// Re-use existing consensus infrastructure
+import { iterateUntilConsensus } from '../../workflow/consensus.js';
+const DEFAULT_PROVIDERS = [
+    { provider: 'openai', model: 'gpt-4.1', temperature: 0.3 },
+    { provider: 'gemini', model: 'gemini-2.5-flash', temperature: 0.3 },
+];
+// ─── Consensus Runner ────────────────────────────────────
+export class ConsensusRunner {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    /** Run structured consensus on a plan packet */
+    async runStructuredConsensus(planPacket, gateDefinition) {
+        const rules = {
+            threshold: gateDefinition.consensusThreshold ?? this.config.threshold,
+            quorum: this.config.quorum,
+            min_reviewers: gateDefinition.minReviewers ?? this.config.minReviewers,
+        };
+        let votes;
+        if (this.config.mode === 'independent') {
+            votes = await this.runIndependentReview(planPacket);
+        }
+        else {
+            votes = await this.runIterativeReview(planPacket);
+        }
+        // Build consensus packet from votes
+        const packet = buildConsensusPacket({
+            planPacketRef: {
+                artifact_id: planPacket.metadata.packet_id,
+                path: '',
+                sha256: '',
+                version: planPacket.metadata.version,
+                type: 'consensus',
+            },
+            votes,
+            rules,
+        });
+        return packet;
+    }
+    /** Independent review: spawn N reviewers, each reviews independently */
+    async runIndependentReview(planPacket) {
+        const providers = this.config.reviewerProviders ?? DEFAULT_PROVIDERS;
+        const numReviewers = Math.max(this.config.minReviewers, providers.length);
+        // Build the review prompt from the plan packet
+        const prompt = buildReviewPrompt(planPacket);
+        const promptHash = createHash('sha256').update(prompt).digest('hex');
+        // Spawn reviewers in parallel
+        const reviewPromises = [];
+        for (let i = 0; i < numReviewers; i++) {
+            const provider = providers[i % providers.length];
+            reviewPromises.push(this.spawnSingleReviewer(prompt, promptHash, provider, `reviewer-${provider.provider}-${i}`));
+        }
+        return Promise.all(reviewPromises);
+    }
+    /** Iterative review: wraps existing iterateUntilConsensus */
+    async runIterativeReview(planPacket) {
+        const prompt = buildReviewPrompt(planPacket);
+        try {
+            const result = await iterateUntilConsensus(prompt, `Phase: ${planPacket.metadata.phase}`, {
+                projectDir: this.config.projectDir,
+                config: this.config.consensusConfig,
+            });
+            // Convert legacy result to ReviewerVote format
+            const vote = {
+                reviewer_id: 'iterative-reviewer',
+                provider: 'openai',
+                model: this.config.consensusConfig?.openaiModel ?? 'gpt-4.1',
+                temperature: this.config.consensusConfig?.temperature ?? 0.3,
+                prompt_hash: createHash('sha256').update(prompt).digest('hex'),
+                vote: result.approved ? 'APPROVE' : 'REJECT',
+                confidence: result.finalScore ?? 0.5,
+                blocking_issues: result.finalConcerns ?? [],
+                suggestions: result.finalRecommendations ?? [],
+                evidence_refs: [],
+            };
+            return [vote];
+        }
+        catch {
+            return [{
+                    reviewer_id: 'iterative-reviewer-error',
+                    provider: 'openai',
+                    model: 'unknown',
+                    temperature: 0,
+                    prompt_hash: '',
+                    vote: 'REJECT',
+                    confidence: 0,
+                    blocking_issues: ['Iterative consensus failed'],
+                    suggestions: [],
+                    evidence_refs: [],
+                }];
+        }
+    }
+    /** Spawn a single independent reviewer */
+    async spawnSingleReviewer(prompt, promptHash, provider, reviewerId) {
+        try {
+            const result = await this.callProviderForReview(prompt, provider);
+            return {
+                reviewer_id: reviewerId,
+                provider: provider.provider,
+                model: provider.model,
+                temperature: provider.temperature,
+                prompt_hash: promptHash,
+                vote: result.approved ? 'APPROVE' : 'REJECT',
+                confidence: result.confidence,
+                blocking_issues: result.blockingIssues,
+                suggestions: result.suggestions,
+                evidence_refs: [],
+            };
+        }
+        catch {
+            return {
+                reviewer_id: reviewerId,
+                provider: provider.provider,
+                model: provider.model,
+                temperature: provider.temperature,
+                prompt_hash: promptHash,
+                vote: 'REJECT',
+                confidence: 0,
+                blocking_issues: [`Review failed for ${provider.provider}`],
+                suggestions: [],
+                evidence_refs: [],
+            };
+        }
+    }
+    /** Call the appropriate provider adapter for a review */
+    async callProviderForReview(prompt, provider) {
+        switch (provider.provider) {
+            case 'openai': {
+                const { requestConsensus } = await import('../../adapters/openai.js');
+                const result = await requestConsensus(prompt, '', {
+                    openaiModel: provider.model,
+                    temperature: provider.temperature,
+                });
+                return parseConsensusResult(result);
+            }
+            case 'gemini': {
+                const { requestConsensus } = await import('../../adapters/gemini.js');
+                const result = await requestConsensus(prompt, '', {
+                    model: provider.model,
+                    temperature: provider.temperature,
+                });
+                return parseConsensusResult(result);
+            }
+            case 'grok': {
+                const { requestConsensus } = await import('../../adapters/grok.js');
+                const result = await requestConsensus(prompt, '', {
+                    model: provider.model,
+                    temperature: provider.temperature,
+                });
+                return parseConsensusResult(result);
+            }
+            default:
+                throw new Error(`Unknown provider: ${provider.provider}`);
+        }
+    }
+}
+function parseConsensusResult(result) {
+    return {
+        approved: result.approved,
+        confidence: result.score / 100, // score is 0-100, confidence is 0-1
+        blockingIssues: result.concerns ?? [],
+        suggestions: result.recommendations ?? [],
+    };
+}
+// ─── Prompt Builder ──────────────────────────────────────
+export function buildReviewPrompt(planPacket) {
+    const lines = [
+        `# Independent Plan Review`,
+        ``,
+        `## Phase: ${planPacket.metadata.phase}`,
+        `## Submitted by: ${planPacket.metadata.submitted_by}`,
+        `## Version: ${planPacket.metadata.version}`,
+        ``,
+        `## Acceptance Criteria`,
+        ...planPacket.acceptance_criteria.map((c) => `- ${c}`),
+        ``,
+        `## Constraints`,
+        ...planPacket.constraints.map((c) => `- [${c.type}] ${c.description}`),
+        ``,
+    ];
+    if (planPacket.open_questions?.length) {
+        lines.push(`## Open Questions`);
+        lines.push(...planPacket.open_questions.map((q) => `- ${q}`));
+        lines.push('');
+    }
+    lines.push(`## Review Instructions`, ``, `You are an independent reviewer. Evaluate this plan for:`, `1. Completeness — are all required artifacts defined?`, `2. Consistency — do acceptance criteria match constraints?`, `3. Feasibility — can this be implemented as described?`, `4. Constitution compliance — does it follow governance rules?`, ``, `Respond with:`, `- APPROVE, REJECT, or CONDITIONAL`, `- Confidence score (0-1)`, `- Blocking issues (if any)`, `- Suggestions for improvement`);
+    return lines.join('\n');
+}
+// ─── Factory ─────────────────────────────────────────────
+export function createConsensusRunner(projectDir, consensusConfig) {
+    return new ConsensusRunner({
+        mode: 'independent',
+        minReviewers: 2,
+        threshold: 0.95,
+        quorum: 2,
+        projectDir,
+        consensusConfig,
+    });
+}
+//# sourceMappingURL=consensus-runner.js.map

package/dist/pipeline/consensus/consensus-runner.js.map

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

package/dist/pipeline/constitution.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Constitution management — artifact creation, hashing, and verification.
+ * The constitution (skills/POPEYE_CONSTITUTION.md) is the immutable governance
+ * document for the pipeline. This module ensures it is tracked as an artifact
+ * and its integrity is verified at every gate.
+ */
+import type { ArtifactEntry, PipelineState } from './types.js';
+import type { ArtifactManager } from './artifact-manager.js';
+/**
+ * Compute SHA-256 hash of constitution file content.
+ *
+ * Args:
+ *   projectDir: Root project directory containing skills/ folder.
+ *
+ * Returns:
+ *   Hex-encoded SHA-256 hash, or empty string if file not found.
+ */
+export declare function computeConstitutionHash(projectDir: string): string;
+/**
+ * Create a constitution artifact from the skills/POPEYE_CONSTITUTION.md file.
+ *
+ * Args:
+ *   projectDir: Root project directory.
+ *   artifactManager: The artifact manager instance.
+ *
+ * Returns:
+ *   The created ArtifactEntry, or null if constitution file not found.
+ */
+export declare function createConstitutionArtifact(projectDir: string, artifactManager: ArtifactManager): ArtifactEntry | null;
+/**
+ * Verify the constitution file has not been modified since pipeline start.
+ * Compares current file hash against the hash stored in pipeline state.
+ *
+ * Args:
+ *   pipeline: Current pipeline state (contains constitutionHash).
+ *   projectDir: Root project directory.
+ *
+ * Returns:
+ *   Object with valid=true if hash matches, or valid=false with reason.
+ */
+export declare function verifyConstitution(pipeline: PipelineState, projectDir: string): {
+    valid: boolean;
+    reason?: string;
+};
+//# sourceMappingURL=constitution.d.ts.map

package/dist/pipeline/constitution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constitution.d.ts","sourceRoot":"","sources":["../../src/pipeline/constitution.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAS7D;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAQlE;AAID;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,eAAe,GAC/B,aAAa,GAAG,IAAI,CAYtB;AAID;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,aAAa,EACvB,UAAU,EAAE,MAAM,GACjB;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAuBrC"}

package/dist/pipeline/constitution.js

@@ -0,0 +1,82 @@
+/**
+ * Constitution management — artifact creation, hashing, and verification.
+ * The constitution (skills/POPEYE_CONSTITUTION.md) is the immutable governance
+ * document for the pipeline. This module ensures it is tracked as an artifact
+ * and its integrity is verified at every gate.
+ */
+import { createHash } from 'node:crypto';
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+// ─── Constants ───────────────────────────────────────────
+const CONSTITUTION_FILENAME = 'POPEYE_CONSTITUTION.md';
+const SKILLS_DIR = 'skills';
+// ─── Hash Computation ────────────────────────────────────
+/**
+ * Compute SHA-256 hash of constitution file content.
+ *
+ * Args:
+ *   projectDir: Root project directory containing skills/ folder.
+ *
+ * Returns:
+ *   Hex-encoded SHA-256 hash, or empty string if file not found.
+ */
+export function computeConstitutionHash(projectDir) {
+    const constitutionPath = join(projectDir, SKILLS_DIR, CONSTITUTION_FILENAME);
+    if (!existsSync(constitutionPath)) {
+        return '';
+    }
+    const content = readFileSync(constitutionPath, 'utf-8');
+    return createHash('sha256').update(content, 'utf-8').digest('hex');
+}
+// ─── Artifact Creation ───────────────────────────────────
+/**
+ * Create a constitution artifact from the skills/POPEYE_CONSTITUTION.md file.
+ *
+ * Args:
+ *   projectDir: Root project directory.
+ *   artifactManager: The artifact manager instance.
+ *
+ * Returns:
+ *   The created ArtifactEntry, or null if constitution file not found.
+ */
+export function createConstitutionArtifact(projectDir, artifactManager) {
+    const constitutionPath = join(projectDir, SKILLS_DIR, CONSTITUTION_FILENAME);
+    if (!existsSync(constitutionPath)) {
+        return null;
+    }
+    const content = readFileSync(constitutionPath, 'utf-8');
+    return artifactManager.createAndStoreText('constitution', content, 'INTAKE');
+}
+// ─── Verification ────────────────────────────────────────
+/**
+ * Verify the constitution file has not been modified since pipeline start.
+ * Compares current file hash against the hash stored in pipeline state.
+ *
+ * Args:
+ *   pipeline: Current pipeline state (contains constitutionHash).
+ *   projectDir: Root project directory.
+ *
+ * Returns:
+ *   Object with valid=true if hash matches, or valid=false with reason.
+ */
+export function verifyConstitution(pipeline, projectDir) {
+    // If no hash stored yet (pre-INTAKE), skip verification
+    if (!pipeline.constitutionHash) {
+        return { valid: true };
+    }
+    const currentHash = computeConstitutionHash(projectDir);
+    if (!currentHash) {
+        return {
+            valid: false,
+            reason: 'Constitution file not found — may have been deleted',
+        };
+    }
+    if (currentHash !== pipeline.constitutionHash) {
+        return {
+            valid: false,
+            reason: 'Constitution has been modified since pipeline start',
+        };
+    }
+    return { valid: true };
+}
+//# sourceMappingURL=constitution.js.map

package/dist/pipeline/constitution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constitution.js","sourceRoot":"","sources":["../../src/pipeline/constitution.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAKjC,4DAA4D;AAE5D,MAAM,qBAAqB,GAAG,wBAAwB,CAAC;AACvD,MAAM,UAAU,GAAG,QAAQ,CAAC;AAE5B,4DAA4D;AAE5D;;;;;;;;GAQG;AACH,MAAM,UAAU,uBAAuB,CAAC,UAAkB;IACxD,MAAM,gBAAgB,GAAG,IAAI,CAAC,UAAU,EAAE,UAAU,EAAE,qBAAqB,CAAC,CAAC;IAC7E,IAAI,CAAC,UAAU,CAAC,gBAAgB,CAAC,EAAE,CAAC;QAClC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,OAAO,GAAG,YAAY,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;IACxD,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACrE,CAAC;AAED,4DAA4D;AAE5D;;;;;;;;;GASG;AACH,MAAM,UAAU,0BAA0B,CACxC,UAAkB,EAClB,eAAgC;IAEhC,MAAM,gBAAgB,GAAG,IAAI,CAAC,UAAU,EAAE,UAAU,EAAE,qBAAqB,CAAC,CAAC;IAC7E,IAAI,CAAC,UAAU,CAAC,gBAAgB,CAAC,EAAE,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,OAAO,GAAG,YAAY,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;IACxD,OAAO,eAAe,CAAC,kBAAkB,CACvC,cAAc,EACd,OAAO,EACP,QAAQ,CACT,CAAC;AACJ,CAAC;AAED,4DAA4D;AAE5D;;;;;;;;;;GAUG;AACH,MAAM,UAAU,kBAAkB,CAChC,QAAuB,EACvB,UAAkB;IAElB,wDAAwD;IACxD,IAAI,CAAC,QAAQ,CAAC,gBAAgB,EAAE,CAAC;QAC/B,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACzB,CAAC;IAED,MAAM,WAAW,GAAG,uBAAuB,CAAC,UAAU,CAAC,CAAC;IAExD,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,MAAM,EAAE,qDAAqD;SAC9D,CAAC;IACJ,CAAC;IAED,IAAI,WAAW,KAAK,QAAQ,CAAC,gBAAgB,EAAE,CAAC;QAC9C,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,MAAM,EAAE,qDAAqD;SAC9D,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AACzB,CAAC"}

package/dist/pipeline/gate-engine.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Gate Engine — pure deterministic state machine for the pipeline.
+ * No side effects. Reads artifacts and check results, never executes anything.
+ * All 14 phases with specific required artifacts and checks per phase.
+ */
+import type { PipelinePhase, PipelineState, ArtifactType, GateCheckType } from './types.js';
+export interface GateDefinition {
+    phase: PipelinePhase;
+    requiredArtifacts: ArtifactType[];
+    requiredChecks: GateCheckType[];
+    consensusThreshold?: number;
+    minReviewers?: number;
+    allowedTransitions: PipelinePhase[];
+    failTransition: PipelinePhase;
+}
+export interface GateResult {
+    phase: PipelinePhase;
+    pass: boolean;
+    score?: number;
+    blockers: string[];
+    missingArtifacts: ArtifactType[];
+    failedChecks: GateCheckType[];
+    consensusScore?: number;
+    timestamp: string;
+}
+export declare class GateEngine {
+    /** Get gate definition for a specific phase */
+    getGateDefinition(phase: PipelinePhase): GateDefinition;
+    /**
+     * Evaluate whether a phase's gate passes.
+     *
+     * Args:
+     *   phase: The phase to evaluate.
+     *   pipeline: Current pipeline state.
+     *   options: Optional checks like constitution verification.
+     */
+    evaluateGate(phase: PipelinePhase, pipeline: PipelineState, options?: {
+        constitutionValid?: boolean;
+        constitutionReason?: string;
+    }): GateResult;
+    /** Get the next phase after a successful gate */
+    getNextPhase(current: PipelinePhase, _gateResult: GateResult): PipelinePhase;
+    /** Check if a transition between two phases is allowed */
+    canTransition(from: PipelinePhase, to: PipelinePhase, pipeline: PipelineState): {
+        allowed: boolean;
+        blockers: string[];
+    };
+    /** Get the ordered phase sequence */
+    getPhaseSequence(): PipelinePhase[];
+    /** Get phase index in the sequence (for progress tracking) */
+    getPhaseIndex(phase: PipelinePhase): number;
+}
+/** Factory function */
+export declare function createGateEngine(): GateEngine;
+//# sourceMappingURL=gate-engine.d.ts.map

package/dist/pipeline/gate-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gate-engine.d.ts","sourceRoot":"","sources":["../../src/pipeline/gate-engine.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,aAAa,EACb,YAAY,EAEZ,aAAa,EACd,MAAM,YAAY,CAAC;AAIpB,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,aAAa,CAAC;IACrB,iBAAiB,EAAE,YAAY,EAAE,CAAC;IAClC,cAAc,EAAE,aAAa,EAAE,CAAC;IAChC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,aAAa,EAAE,CAAC;IACpC,cAAc,EAAE,aAAa,CAAC;CAC/B;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,aAAa,CAAC;IACrB,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,gBAAgB,EAAE,YAAY,EAAE,CAAC;IACjC,YAAY,EAAE,aAAa,EAAE,CAAC;IAC9B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB;AAsID,qBAAa,UAAU;IACrB,+CAA+C;IAC/C,iBAAiB,CAAC,KAAK,EAAE,aAAa,GAAG,cAAc;IAIvD;;;;;;;OAOG;IACH,YAAY,CACV,KAAK,EAAE,aAAa,EACpB,QAAQ,EAAE,aAAa,EACvB,OAAO,CAAC,EAAE;QAAE,iBAAiB,CAAC,EAAE,OAAO,CAAC;QAAC,kBAAkB,CAAC,EAAE,MAAM,CAAA;KAAE,GACrE,UAAU;IA0Eb,iDAAiD;IACjD,YAAY,CACV,OAAO,EAAE,aAAa,EACtB,WAAW,EAAE,UAAU,GACtB,aAAa;IAQhB,0DAA0D;IAC1D,aAAa,CACX,IAAI,EAAE,aAAa,EACnB,EAAE,EAAE,aAAa,EACjB,QAAQ,EAAE,aAAa,GACtB;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE;IAoB3C,qCAAqC;IACrC,gBAAgB,IAAI,aAAa,EAAE;IAInC,8DAA8D;IAC9D,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM;CAG5C;AAED,uBAAuB;AACvB,wBAAgB,gBAAgB,IAAI,UAAU,CAE7C"}