popeye-cli 1.10.0 → 2.0.0

package/dist/pipeline/artifact-validators.js

@@ -0,0 +1,173 @@
+/**
+ * Artifact Completeness Validators — deterministic structural checks.
+ * Runs BEFORE LLM review in consensus phases to catch obvious issues.
+ * Each validator checks for required sections, minimum content length,
+ * and structural integrity specific to its artifact type.
+ */
+// ─── Section Patterns ────────────────────────────────────
+/** Regex patterns for detecting markdown sections (case-insensitive) */
+function hasSection(content, patterns) {
+    return patterns.some((p) => p.test(content));
+}
+function findMissingSections(content, required) {
+    const missing = [];
+    for (const { name, patterns } of required) {
+        if (!hasSection(content, patterns)) {
+            missing.push(name);
+        }
+    }
+    return missing;
+}
+// ─── Per-Type Validators ─────────────────────────────────
+function validateMasterPlan(content) {
+    const errors = [];
+    const warnings = [];
+    if (content.length < 200) {
+        errors.push('Master plan is too short (min 200 characters)');
+    }
+    const missing = findMissingSections(content, [
+        { name: 'Goals/Objectives', patterns: [/#+\s*(goals?|objectives?)/i, /\bgoals?\b.*:/i] },
+        { name: 'Milestones', patterns: [/#+\s*milestones?/i, /\bmilestone\s+\d/i] },
+        { name: 'Success Criteria', patterns: [/#+\s*success\s+criteria/i, /\bsuccess\s+criteria\b/i, /#+\s*acceptance\s+criteria/i] },
+    ]);
+    for (const section of missing) {
+        errors.push(`Missing required section: ${section}`);
+    }
+    // Check for empty sections (heading followed by another heading or end)
+    const emptyHeadings = content.match(/^(#+\s+.+)\n(?=#+\s+|\s*$)/gm);
+    if (emptyHeadings && emptyHeadings.length > 2) {
+        warnings.push(`${emptyHeadings.length} potentially empty sections detected`);
+    }
+    return { valid: errors.length === 0, errors, warnings };
+}
+function validateArchitecture(content) {
+    const errors = [];
+    const warnings = [];
+    if (content.length < 200) {
+        errors.push('Architecture document is too short (min 200 characters)');
+    }
+    const missing = findMissingSections(content, [
+        { name: 'Components/Modules', patterns: [/#+\s*(components?|modules?|services?)/i, /\bcomponent\b/i] },
+        { name: 'Data Flow/Contracts', patterns: [/#+\s*(data\s+flow|contracts?|api|interfaces?)/i, /\bcontract\b/i, /\bdata\s+flow\b/i] },
+        { name: 'Tech Stack', patterns: [/#+\s*(tech\s+stack|technology|stack)/i, /\btech\s+stack\b/i] },
+    ]);
+    for (const section of missing) {
+        errors.push(`Missing required section: ${section}`);
+    }
+    // Must reference at least one file path
+    const hasFilePath = /(?:src\/|app\/|pages\/|lib\/|\.ts|\.js|\.py|\.go)/.test(content);
+    if (!hasFilePath) {
+        warnings.push('Architecture should reference at least one file path');
+    }
+    return { valid: errors.length === 0, errors, warnings };
+}
+function validateRolePlan(content) {
+    const errors = [];
+    const warnings = [];
+    if (content.length < 100) {
+        errors.push('Role plan is too short (min 100 characters)');
+    }
+    const missing = findMissingSections(content, [
+        { name: 'Tasks/Responsibilities', patterns: [/#+\s*(tasks?|responsibilities?|work\s+items?)/i, /\btask\b/i] },
+        { name: 'Dependencies', patterns: [/#+\s*(dependenc|prerequisites?|requires?)/i, /\bdepend/i] },
+        { name: 'Acceptance Criteria', patterns: [/#+\s*(acceptance|done\s+when|completion)/i, /\bacceptance\b/i, /\bdone\s+when\b/i] },
+    ]);
+    for (const section of missing) {
+        errors.push(`Missing required section: ${section}`);
+    }
+    // Should reference a role name
+    const rolePatterns = /\b(DISPATCHER|ARCHITECT|DB_EXPERT|BACKEND|FRONTEND|WEBSITE|QA_TESTER|REVIEWER|AUDITOR|JOURNALIST)\b/i;
+    if (!rolePatterns.test(content)) {
+        warnings.push('Role plan should reference the role name');
+    }
+    return { valid: errors.length === 0, errors, warnings };
+}
+function validateQaValidation(content) {
+    const errors = [];
+    const warnings = [];
+    const missing = findMissingSections(content, [
+        { name: 'Test Results', patterns: [/#+\s*(test\s+results?|results?)/i, /\btest\s+results?\b/i, /\bpass(?:ed|ing)?\b/i] },
+        { name: 'Coverage', patterns: [/#+\s*coverage/i, /\bcoverage\b/i, /\d+\s*%/] },
+    ]);
+    for (const section of missing) {
+        errors.push(`Missing required section: ${section}`);
+    }
+    // Should contain pass/fail counts
+    const hasPassFail = /\b\d+\s*(pass|fail|error|skip)/i.test(content);
+    if (!hasPassFail) {
+        warnings.push('QA validation should include pass/fail counts');
+    }
+    return { valid: errors.length === 0, errors, warnings };
+}
+function validateAuditReport(content) {
+    const errors = [];
+    const warnings = [];
+    // Try JSON parsing
+    try {
+        const parsed = JSON.parse(content);
+        if (!Array.isArray(parsed.findings)) {
+            errors.push('Audit report must have a "findings" array');
+        }
+        if (typeof parsed.overall_status !== 'string') {
+            errors.push('Audit report must have "overall_status"');
+        }
+        if (typeof parsed.system_risk_score !== 'number') {
+            errors.push('Audit report must have "system_risk_score"');
+        }
+    }
+    catch {
+        // Not JSON — check for markdown-style audit
+        if (!content.includes('findings') && !content.includes('finding')) {
+            errors.push('Audit report must contain findings');
+        }
+        if (!content.includes('status') && !content.includes('PASS') && !content.includes('FAIL')) {
+            errors.push('Audit report must contain overall status');
+        }
+        if (!content.includes('risk') && !content.includes('score')) {
+            warnings.push('Audit report should include risk score');
+        }
+    }
+    return { valid: errors.length === 0, errors, warnings };
+}
+// ─── Validator Registry ──────────────────────────────────
+const VALIDATORS = {
+    master_plan: validateMasterPlan,
+    architecture: validateArchitecture,
+    role_plan: validateRolePlan,
+    qa_validation: validateQaValidation,
+    audit_report: validateAuditReport,
+};
+// ─── Public API ──────────────────────────────────────────
+/**
+ * Validate artifact content completeness based on type-specific rules.
+ * Returns a ValidationResult with errors (blocking) and warnings (non-blocking).
+ *
+ * Args:
+ *   type: The artifact type to validate against.
+ *   content: The artifact content string.
+ *
+ * Returns:
+ *   ValidationResult with valid flag, errors, and warnings.
+ */
+export function validateArtifactCompleteness(type, content) {
+    const validator = VALIDATORS[type];
+    if (!validator) {
+        // No validator for this type — pass by default
+        return { valid: true, errors: [], warnings: [] };
+    }
+    if (!content || content.trim().length === 0) {
+        return {
+            valid: false,
+            errors: [`${type} artifact has empty content`],
+            warnings: [],
+        };
+    }
+    return validator(content);
+}
+/**
+ * Get all artifact types that have validators.
+ */
+export function getValidatableArtifactTypes() {
+    return Object.keys(VALIDATORS);
+}
+//# sourceMappingURL=artifact-validators.js.map

package/dist/pipeline/artifact-validators.js.map

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

package/dist/pipeline/change-request.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Change Request mechanism — structured change tracking for mid-pipeline modifications.
+ * CRs are created when drift is detected (REVIEW) or architectural issues found (AUDIT).
+ * Each CR routes to the appropriate consensus phase for approval.
+ */
+import type { PipelinePhase, PipelineRole, ArtifactRef, ChangeRequest } from './types.js';
+export interface BuildChangeRequestArgs {
+    originPhase: PipelinePhase;
+    requestedBy: PipelineRole;
+    changeType: ChangeRequest['change_type'];
+    description: string;
+    justification: string;
+    affectedArtifacts: ArtifactRef[];
+    affectedPhases: PipelinePhase[];
+    riskLevel: 'low' | 'medium' | 'high';
+}
+/**
+ * Build a change request with generated ID and timestamp.
+ *
+ * Args:
+ *   args: Change request parameters.
+ *
+ * Returns:
+ *   A fully formed ChangeRequest in 'proposed' status.
+ */
+export declare function buildChangeRequest(args: BuildChangeRequestArgs): ChangeRequest;
+/**
+ * Determine which consensus phase should review a change request.
+ *
+ * Args:
+ *   cr: The change request to route.
+ *
+ * Returns:
+ *   The pipeline phase that should handle the CR approval.
+ */
+export declare function routeChangeRequest(cr: ChangeRequest): PipelinePhase;
+/**
+ * Format a change request as markdown for inclusion in artifacts.
+ *
+ * Args:
+ *   cr: The change request to format.
+ *
+ * Returns:
+ *   Markdown-formatted string.
+ */
+export declare function formatChangeRequest(cr: ChangeRequest): string;
+//# sourceMappingURL=change-request.d.ts.map

package/dist/pipeline/change-request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"change-request.d.ts","sourceRoot":"","sources":["../../src/pipeline/change-request.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EACZ,WAAW,EACX,aAAa,EACd,MAAM,YAAY,CAAC;AAIpB,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,aAAa,CAAC;IAC3B,WAAW,EAAE,YAAY,CAAC;IAC1B,UAAU,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,WAAW,EAAE,CAAC;IACjC,cAAc,EAAE,aAAa,EAAE,CAAC;IAChC,SAAS,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;CACtC;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,sBAAsB,GAAG,aAAa,CAgB9E;AAaD;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,aAAa,GAAG,aAAa,CAEnE;AAID;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,aAAa,GAAG,MAAM,CA4B7D"}

package/dist/pipeline/change-request.js

@@ -0,0 +1,91 @@
+/**
+ * Change Request mechanism — structured change tracking for mid-pipeline modifications.
+ * CRs are created when drift is detected (REVIEW) or architectural issues found (AUDIT).
+ * Each CR routes to the appropriate consensus phase for approval.
+ */
+import { randomUUID } from 'node:crypto';
+/**
+ * Build a change request with generated ID and timestamp.
+ *
+ * Args:
+ *   args: Change request parameters.
+ *
+ * Returns:
+ *   A fully formed ChangeRequest in 'proposed' status.
+ */
+export function buildChangeRequest(args) {
+    return {
+        cr_id: `CR-${randomUUID().split('-')[0].toUpperCase()}`,
+        timestamp: new Date().toISOString(),
+        origin_phase: args.originPhase,
+        requested_by: args.requestedBy,
+        change_type: args.changeType,
+        description: args.description,
+        justification: args.justification,
+        impact_analysis: {
+            affected_artifacts: args.affectedArtifacts,
+            affected_phases: args.affectedPhases,
+            risk_level: args.riskLevel,
+        },
+        status: 'proposed',
+    };
+}
+// ─── CR Routing ──────────────────────────────────────────
+/** Maps change types to the consensus phase that must approve them */
+const CHANGE_TYPE_ROUTING = {
+    scope: 'CONSENSUS_MASTER_PLAN',
+    architecture: 'CONSENSUS_ARCHITECTURE',
+    dependency: 'CONSENSUS_ROLE_PLANS',
+    config: 'QA_VALIDATION',
+    requirement: 'CONSENSUS_MASTER_PLAN',
+};
+/**
+ * Determine which consensus phase should review a change request.
+ *
+ * Args:
+ *   cr: The change request to route.
+ *
+ * Returns:
+ *   The pipeline phase that should handle the CR approval.
+ */
+export function routeChangeRequest(cr) {
+    return CHANGE_TYPE_ROUTING[cr.change_type];
+}
+// ─── CR Formatting ───────────────────────────────────────
+/**
+ * Format a change request as markdown for inclusion in artifacts.
+ *
+ * Args:
+ *   cr: The change request to format.
+ *
+ * Returns:
+ *   Markdown-formatted string.
+ */
+export function formatChangeRequest(cr) {
+    const lines = [
+        `# Change Request ${cr.cr_id}`,
+        '',
+        `**Status:** ${cr.status}`,
+        `**Type:** ${cr.change_type}`,
+        `**Origin Phase:** ${cr.origin_phase}`,
+        `**Requested By:** ${cr.requested_by}`,
+        `**Risk Level:** ${cr.impact_analysis.risk_level}`,
+        `**Timestamp:** ${cr.timestamp}`,
+        '',
+        '## Description',
+        cr.description,
+        '',
+        '## Justification',
+        cr.justification,
+        '',
+        '## Impact Analysis',
+        `- Affected phases: ${cr.impact_analysis.affected_phases.join(', ')}`,
+        `- Affected artifacts: ${cr.impact_analysis.affected_artifacts.length}`,
+        `- Risk level: ${cr.impact_analysis.risk_level}`,
+    ];
+    if (cr.approval_artifact) {
+        lines.push('', `## Approval: ${cr.approval_artifact.artifact_id}`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=change-request.js.map

package/dist/pipeline/change-request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"change-request.js","sourceRoot":"","sources":["../../src/pipeline/change-request.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAsBzC;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAA4B;IAC7D,OAAO;QACL,KAAK,EAAE,MAAM,UAAU,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,EAAE;QACvD,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,YAAY,EAAE,IAAI,CAAC,WAAW;QAC9B,YAAY,EAAE,IAAI,CAAC,WAAW;QAC9B,WAAW,EAAE,IAAI,CAAC,UAAU;QAC5B,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,eAAe,EAAE;YACf,kBAAkB,EAAE,IAAI,CAAC,iBAAiB;YAC1C,eAAe,EAAE,IAAI,CAAC,cAAc;YACpC,UAAU,EAAE,IAAI,CAAC,SAAS;SAC3B;QACD,MAAM,EAAE,UAAU;KACnB,CAAC;AACJ,CAAC;AAED,4DAA4D;AAE5D,sEAAsE;AACtE,MAAM,mBAAmB,GAAwD;IAC/E,KAAK,EAAE,uBAAuB;IAC9B,YAAY,EAAE,wBAAwB;IACtC,UAAU,EAAE,sBAAsB;IAClC,MAAM,EAAE,eAAe;IACvB,WAAW,EAAE,uBAAuB;CACrC,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAAC,EAAiB;IAClD,OAAO,mBAAmB,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC;AAC7C,CAAC;AAED,4DAA4D;AAE5D;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CAAC,EAAiB;IACnD,MAAM,KAAK,GAAG;QACZ,oBAAoB,EAAE,CAAC,KAAK,EAAE;QAC9B,EAAE;QACF,eAAe,EAAE,CAAC,MAAM,EAAE;QAC1B,aAAa,EAAE,CAAC,WAAW,EAAE;QAC7B,qBAAqB,EAAE,CAAC,YAAY,EAAE;QACtC,qBAAqB,EAAE,CAAC,YAAY,EAAE;QACtC,mBAAmB,EAAE,CAAC,eAAe,CAAC,UAAU,EAAE;QAClD,kBAAkB,EAAE,CAAC,SAAS,EAAE;QAChC,EAAE;QACF,gBAAgB;QAChB,EAAE,CAAC,WAAW;QACd,EAAE;QACF,kBAAkB;QAClB,EAAE,CAAC,aAAa;QAChB,EAAE;QACF,oBAAoB;QACpB,sBAAsB,EAAE,CAAC,eAAe,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QACrE,yBAAyB,EAAE,CAAC,eAAe,CAAC,kBAAkB,CAAC,MAAM,EAAE;QACvE,iBAAiB,EAAE,CAAC,eAAe,CAAC,UAAU,EAAE;KACjD,CAAC;IAEF,IAAI,EAAE,CAAC,iBAAiB,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,gBAAgB,EAAE,CAAC,iBAAiB,CAAC,WAAW,EAAE,CAAC,CAAC;IACrE,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/pipeline/check-runner.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Check Runner — executes build/test/lint/typecheck commands
+ * and produces GateCheckResult artifacts.
+ *
+ * Safety: command sanitization, cwd enforcement, stream caps,
+ * configurable timeouts (P2-G).
+ */
+import type { GateCheckResult, GateCheckType, ResolvedCommands, RepoSnapshot, ArtifactEntry, PipelinePhase } from './types.js';
+import { ArtifactManager } from './artifact-manager.js';
+/** Execute a single check command */
+export declare function runCheck(checkType: GateCheckType, command: string, projectDir: string, timeoutOverride?: number): Promise<GateCheckResult>;
+/** Run all applicable checks based on resolved commands */
+export declare function runAllChecks(resolvedCommands: ResolvedCommands, projectDir: string): Promise<GateCheckResult[]>;
+/** Store check results as artifacts */
+export declare function storeCheckResults(results: GateCheckResult[], artifactManager: ArtifactManager, phase: PipelinePhase): ArtifactEntry[];
+/** Scan project for placeholder/TODO/mock content */
+export declare function runPlaceholderScan(projectDir: string, allowlistPath?: string): GateCheckResult;
+/**
+ * Attempt to start the application and verify it does not crash immediately.
+ * Optionally checks a health endpoint if a port is detected.
+ *
+ * Args:
+ *   startCommand: The command to start the app (e.g., "npm run start").
+ *   projectDir: Project root directory.
+ *   options: Optional port, health path, and timeout.
+ *
+ * Returns:
+ *   GateCheckResult with pass/fail status.
+ */
+export declare function runStartCheck(startCommand: string, projectDir: string, options?: {
+    port?: number;
+    healthPath?: string;
+    timeoutMs?: number;
+}): Promise<GateCheckResult>;
+/**
+ * Validate that required environment variables exist.
+ * Reads .env.example for required var names and checks .env has them set.
+ *
+ * Args:
+ *   projectDir: Project root directory.
+ *   _snapshot: Repo snapshot (for future use).
+ *
+ * Returns:
+ *   GateCheckResult with pass/fail status.
+ */
+export declare function runEnvCheck(projectDir: string, _snapshot?: RepoSnapshot): GateCheckResult;
+//# sourceMappingURL=check-runner.d.ts.map

package/dist/pipeline/check-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-runner.d.ts","sourceRoot":"","sources":["../../src/pipeline/check-runner.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,KAAK,EACV,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,aAAa,EACd,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAuDxD,qCAAqC;AACrC,wBAAsB,QAAQ,CAC5B,SAAS,EAAE,aAAa,EACxB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,eAAe,CAAC,EAAE,MAAM,GACvB,OAAO,CAAC,eAAe,CAAC,CAuD1B;AAED,2DAA2D;AAC3D,wBAAsB,YAAY,CAChC,gBAAgB,EAAE,gBAAgB,EAClC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,eAAe,EAAE,CAAC,CA4B5B;AAED,uCAAuC;AACvC,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,eAAe,EAAE,EAC1B,eAAe,EAAE,eAAe,EAChC,KAAK,EAAE,aAAa,GACnB,aAAa,EAAE,CAmBjB;AAiBD,qDAAqD;AACrD,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,EAClB,aAAa,CAAC,EAAE,MAAM,GACrB,eAAe,CA+BjB;AA2DD;;;;;;;;;;;GAWG;AACH,wBAAsB,aAAa,CACjC,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GACnE,OAAO,CAAC,eAAe,CAAC,CAoE1B;AAID;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CACzB,UAAU,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,YAAY,GACvB,eAAe,CAqEjB"}