popeye-cli 1.9.5 → 2.0.0

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

package/dist/pipeline/check-runner.js

@@ -0,0 +1,417 @@
+/**
+ * Check Runner — executes build/test/lint/typecheck commands
+ * and produces GateCheckResult artifacts.
+ *
+ * Safety: command sanitization, cwd enforcement, stream caps,
+ * configurable timeouts (P2-G).
+ */
+import { exec } from 'node:child_process';
+import { existsSync, readFileSync, readdirSync } from 'node:fs';
+import { join, extname } from 'node:path';
+// ─── Constants ───────────────────────────────────────────
+/** Default timeout per check type in milliseconds */
+const DEFAULT_TIMEOUTS = {
+    build: 20 * 60 * 1000, // 20 minutes
+    test: 10 * 60 * 1000, // 10 minutes
+    lint: 5 * 60 * 1000, // 5 minutes
+    typecheck: 5 * 60 * 1000, // 5 minutes
+    migration: 5 * 60 * 1000, // 5 minutes
+};
+/** Max stdout/stderr capture in bytes */
+const MAX_OUTPUT_SIZE = 1024 * 1024; // 1 MB
+/** Dangerous command patterns to reject */
+const DANGEROUS_PATTERNS = [
+    /rm\s+-rf\s+\//,
+    /sudo\s+/,
+    />\s*\/dev\//,
+    />\s*\/etc\//,
+    />\s*\/usr\//,
+    /;\s*rm\s/,
+    /&&\s*rm\s/,
+    /\|\s*sh$/,
+    /\|\s*bash$/,
+];
+/** Placeholder patterns for scanning */
+const PLACEHOLDER_PATTERNS = [
+    /\bTODO\b/i,
+    /\bFIXME\b/i,
+    /\bHACK\b/i,
+    /\bXXX\b/i,
+    /placeholder/i,
+    /\bmock\b(?!\.)/i, // 'mock' but not 'mock.'  (import paths)
+    /\btemp\b(?!late)/i, // 'temp' but not 'template'
+    /lorem ipsum/i,
+    /example\.com/i,
+];
+// ─── Command Sanitization ────────────────────────────────
+function sanitizeCommand(command) {
+    for (const pattern of DANGEROUS_PATTERNS) {
+        if (pattern.test(command)) {
+            return { safe: false, reason: `Matches dangerous pattern: ${pattern.source}` };
+        }
+    }
+    return { safe: true };
+}
+// ─── Check Execution ─────────────────────────────────────
+/** Execute a single check command */
+export async function runCheck(checkType, command, projectDir, timeoutOverride) {
+    const startTime = Date.now();
+    // Sanitize command
+    const { safe, reason } = sanitizeCommand(command);
+    if (!safe) {
+        return {
+            check_type: checkType,
+            status: 'fail',
+            command,
+            exit_code: -1,
+            stderr_summary: `Command rejected: ${reason}`,
+            duration_ms: 0,
+            timestamp: new Date().toISOString(),
+        };
+    }
+    const timeout = timeoutOverride ?? DEFAULT_TIMEOUTS[checkType] ?? 5 * 60 * 1000;
+    return new Promise((resolve) => {
+        const proc = exec(command, {
+            cwd: projectDir,
+            timeout,
+            maxBuffer: MAX_OUTPUT_SIZE,
+            env: {
+                ...process.env,
+                NODE_ENV: 'test',
+                CI: 'true',
+            },
+        }, (error, _stdout, stderr) => {
+            const duration = Date.now() - startTime;
+            const exitCode = error ? error.code ?? 1 : 0;
+            // Truncate output for summary
+            const stderrSummary = stderr
+                ? stderr.slice(0, 2000) + (stderr.length > 2000 ? '\n... (truncated)' : '')
+                : undefined;
+            resolve({
+                check_type: checkType,
+                status: exitCode === 0 ? 'pass' : 'fail',
+                command,
+                exit_code: typeof exitCode === 'number' ? exitCode : 1,
+                stdout_artifact: undefined, // Filled by storeCheckResults if needed
+                stderr_summary: stderrSummary,
+                duration_ms: duration,
+                timestamp: new Date().toISOString(),
+            });
+        });
+        // Safety: kill after timeout (backup for exec timeout)
+        setTimeout(() => {
+            try {
+                proc.kill('SIGTERM');
+            }
+            catch { /* already dead */ }
+        }, timeout + 5000);
+    });
+}
+/** Run all applicable checks based on resolved commands */
+export async function runAllChecks(resolvedCommands, projectDir) {
+    const results = [];
+    const checkMap = [
+        ['build', resolvedCommands.build],
+        ['test', resolvedCommands.test],
+        ['lint', resolvedCommands.lint],
+        ['typecheck', resolvedCommands.typecheck],
+        ['migration', resolvedCommands.migrations],
+    ];
+    for (const [checkType, command] of checkMap) {
+        if (!command) {
+            results.push({
+                check_type: checkType,
+                status: 'skip',
+                command: '',
+                exit_code: 0,
+                duration_ms: 0,
+                timestamp: new Date().toISOString(),
+            });
+            continue;
+        }
+        const result = await runCheck(checkType, command, projectDir);
+        results.push(result);
+    }
+    return results;
+}
+/** Store check results as artifacts */
+export function storeCheckResults(results, artifactManager, phase) {
+    const artifacts = [];
+    for (const result of results) {
+        if (result.status === 'skip')
+            continue;
+        // Only store meaningful output
+        const content = JSON.stringify(result, null, 2);
+        if (content.length > 100) {
+            const entry = artifactManager.createAndStoreJson(mapCheckTypeToArtifactType(result.check_type), result, phase);
+            artifacts.push(entry);
+        }
+    }
+    return artifacts;
+}
+function mapCheckTypeToArtifactType(checkType) {
+    switch (checkType) {
+        case 'build': return 'build_check';
+        case 'test': return 'test_check';
+        case 'lint': return 'lint_check';
+        case 'typecheck': return 'typecheck_check';
+        case 'placeholder_scan': return 'placeholder_scan';
+        default: return 'build_check';
+    }
+}
+// ─── Placeholder Scanner (P2-2) ──────────────────────────
+/** Scan project for placeholder/TODO/mock content */
+export function runPlaceholderScan(projectDir, allowlistPath) {
+    const startTime = Date.now();
+    const findings = [];
+    // Load allowlist if present
+    const allowlist = loadAllowlist(allowlistPath ?? join(projectDir, '.popeye-placeholder-allowlist'));
+    // Scan source directories
+    const scanDirs = ['src', 'app', 'pages', 'components', 'lib', 'server', 'api'];
+    for (const dir of scanDirs) {
+        const fullDir = join(projectDir, dir);
+        if (!existsSync(fullDir))
+            continue;
+        scanDirForPlaceholders(fullDir, projectDir, allowlist, findings);
+    }
+    const duration = Date.now() - startTime;
+    return {
+        check_type: 'placeholder_scan',
+        status: findings.length > 0 ? 'fail' : 'pass',
+        command: 'placeholder-scan',
+        exit_code: findings.length > 0 ? 1 : 0,
+        stderr_summary: findings.length > 0
+            ? `Found ${findings.length} placeholder(s):\n${findings.slice(0, 20).join('\n')}`
+            : undefined,
+        duration_ms: duration,
+        timestamp: new Date().toISOString(),
+    };
+}
+function scanDirForPlaceholders(dir, projectDir, allowlist, findings) {
+    const codeExts = new Set(['.ts', '.tsx', '.js', '.jsx', '.py', '.go', '.rs']);
+    try {
+        const entries = readdirSync(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (entry.name.startsWith('.') || entry.name === 'node_modules')
+                continue;
+            const fullPath = join(dir, entry.name);
+            if (entry.isDirectory()) {
+                scanDirForPlaceholders(fullPath, projectDir, allowlist, findings);
+            }
+            else if (codeExts.has(extname(entry.name))) {
+                const relativePath = fullPath.replace(projectDir + '/', '');
+                if (allowlist.has(relativePath))
+                    continue;
+                try {
+                    const content = readFileSync(fullPath, 'utf-8');
+                    const lines = content.split('\n');
+                    for (let i = 0; i < lines.length; i++) {
+                        for (const pattern of PLACEHOLDER_PATTERNS) {
+                            if (pattern.test(lines[i])) {
+                                findings.push(`${relativePath}:${i + 1}: ${lines[i].trim().slice(0, 80)}`);
+                                break; // One finding per line
+                            }
+                        }
+                    }
+                }
+                catch {
+                    // Skip unreadable files
+                }
+            }
+        }
+    }
+    catch {
+        // Skip unreadable directories
+    }
+}
+function loadAllowlist(path) {
+    if (!existsSync(path))
+        return new Set();
+    try {
+        const content = readFileSync(path, 'utf-8');
+        return new Set(content.split('\n').map((l) => l.trim()).filter((l) => l && !l.startsWith('#')));
+    }
+    catch {
+        return new Set();
+    }
+}
+// ─── Start Check (v1.1 Gap #5) ──────────────────────────
+/**
+ * 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 async function runStartCheck(startCommand, projectDir, options) {
+    const startTime = Date.now();
+    const timeout = options?.timeoutMs ?? 15000;
+    // Sanitize command
+    const { safe, reason } = sanitizeCommand(startCommand);
+    if (!safe) {
+        return {
+            check_type: 'start',
+            status: 'fail',
+            command: startCommand,
+            exit_code: -1,
+            stderr_summary: `Command rejected: ${reason}`,
+            duration_ms: 0,
+            timestamp: new Date().toISOString(),
+        };
+    }
+    return new Promise((resolve) => {
+        let stderr = '';
+        let resolved = false;
+        const proc = exec(startCommand, {
+            cwd: projectDir,
+            timeout: timeout + 5000,
+            maxBuffer: MAX_OUTPUT_SIZE,
+            env: { ...process.env, NODE_ENV: 'production' },
+        }, (error, _stdout, stderrOutput) => {
+            if (resolved)
+                return;
+            resolved = true;
+            const duration = Date.now() - startTime;
+            stderr = stderrOutput ?? '';
+            // Process exited — if it exited within timeout, it crashed
+            resolve({
+                check_type: 'start',
+                status: 'fail',
+                command: startCommand,
+                exit_code: error ? (typeof error.code === 'number'
+                    ? error.code
+                    : 1) : 0,
+                stderr_summary: stderr ? stderr.slice(0, 2000) : 'Process exited prematurely',
+                duration_ms: duration,
+                timestamp: new Date().toISOString(),
+            });
+        });
+        // If process survives for the timeout period, consider it passing
+        setTimeout(() => {
+            if (resolved)
+                return;
+            resolved = true;
+            // Kill the process
+            try {
+                proc.kill('SIGTERM');
+            }
+            catch { /* already dead */ }
+            const duration = Date.now() - startTime;
+            resolve({
+                check_type: 'start',
+                status: 'pass',
+                command: startCommand,
+                exit_code: 0,
+                stderr_summary: stderr ? stderr.slice(0, 500) : undefined,
+                duration_ms: duration,
+                timestamp: new Date().toISOString(),
+            });
+        }, timeout);
+    });
+}
+// ─── Env Check (v1.1 Gap #5) ────────────────────────────
+/**
+ * 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 function runEnvCheck(projectDir, _snapshot) {
+    const startTime = Date.now();
+    const examplePath = join(projectDir, '.env.example');
+    const envPath = join(projectDir, '.env');
+    const missingVars = [];
+    const emptyVars = [];
+    // If no .env.example, skip check
+    if (!existsSync(examplePath)) {
+        return {
+            check_type: 'env_check',
+            status: 'pass',
+            command: 'env-check',
+            exit_code: 0,
+            stderr_summary: 'No .env.example found — skipping env validation',
+            duration_ms: Date.now() - startTime,
+            timestamp: new Date().toISOString(),
+        };
+    }
+    // Parse .env.example for required var names
+    const exampleContent = readFileSync(examplePath, 'utf-8');
+    const requiredVars = parseEnvVarNames(exampleContent);
+    // Check .env exists
+    if (!existsSync(envPath)) {
+        return {
+            check_type: 'env_check',
+            status: 'fail',
+            command: 'env-check',
+            exit_code: 1,
+            stderr_summary: `.env file not found. Required vars from .env.example: ${requiredVars.join(', ')}`,
+            duration_ms: Date.now() - startTime,
+            timestamp: new Date().toISOString(),
+        };
+    }
+    // Parse .env and check all required vars are present and non-empty
+    const envContent = readFileSync(envPath, 'utf-8');
+    const envVars = parseEnvVarValues(envContent);
+    for (const varName of requiredVars) {
+        if (!(varName in envVars)) {
+            missingVars.push(varName);
+        }
+        else if (!envVars[varName]) {
+            emptyVars.push(varName);
+        }
+    }
+    const duration = Date.now() - startTime;
+    const hasFail = missingVars.length > 0;
+    const summaryParts = [];
+    if (missingVars.length > 0) {
+        summaryParts.push(`Missing vars: ${missingVars.join(', ')}`);
+    }
+    if (emptyVars.length > 0) {
+        summaryParts.push(`Empty vars (warning): ${emptyVars.join(', ')}`);
+    }
+    return {
+        check_type: 'env_check',
+        status: hasFail ? 'fail' : 'pass',
+        command: 'env-check',
+        exit_code: hasFail ? 1 : 0,
+        stderr_summary: summaryParts.length > 0 ? summaryParts.join('; ') : undefined,
+        duration_ms: duration,
+        timestamp: new Date().toISOString(),
+    };
+}
+/** Parse env var names from .env.example (lines like KEY=value or KEY=) */
+function parseEnvVarNames(content) {
+    return content
+        .split('\n')
+        .map((line) => line.trim())
+        .filter((line) => line && !line.startsWith('#'))
+        .map((line) => line.split('=')[0].trim())
+        .filter((name) => name.length > 0);
+}
+/** Parse env vars into key-value map from .env content */
+function parseEnvVarValues(content) {
+    const vars = {};
+    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();
+        const value = trimmed.slice(eqIndex + 1).trim().replace(/^["']|["']$/g, '');
+        vars[key] = value;
+    }
+    return vars;
+}
+//# sourceMappingURL=check-runner.js.map

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

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

package/dist/pipeline/command-resolver.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Command Resolver — detects project-type-specific build/test/lint/typecheck
+ * commands from a RepoSnapshot. Used by CheckRunner and ProductionGate.
+ */
+import type { RepoSnapshot, ResolvedCommands } from './types.js';
+export type ProjectType = 'node' | 'python' | 'mixed' | 'unknown';
+export declare function detectProjectType(snapshot: RepoSnapshot): ProjectType;
+export declare function resolveCommands(snapshot: RepoSnapshot, overrides?: Partial<ResolvedCommands>): ResolvedCommands;
+//# sourceMappingURL=command-resolver.d.ts.map

package/dist/pipeline/command-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-resolver.d.ts","sourceRoot":"","sources":["../../src/pipeline/command-resolver.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAIjE,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;AAElE,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,YAAY,GAAG,WAAW,CAUrE;AAID,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,YAAY,EACtB,SAAS,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GACpC,gBAAgB,CAqClB"}