hivemind-pipeline 0.1.0

package/dist/src/core/pipeline-loader.d.ts

@@ -0,0 +1,46 @@
+import type { Persona, StageName } from '../types.js';
+/**
+ * Definition of a single pipeline stage from `.swarm/pipeline.yaml`.
+ */
+export interface PipelineStageDefinition {
+    /** Unique stage name (used as key in state tracking) */
+    name: string;
+    /** Which persona runs this stage */
+    persona: Persona;
+    /** Expected output artifact filename (e.g. "REQUIREMENTS.md") */
+    artifact?: string;
+    /** Stage names that must complete before this stage starts */
+    dependsOn?: string[];
+    /** Whether this stage can run in parallel with other parallel-eligible stages */
+    parallel?: boolean;
+    /** Condition to check before running; stage is skipped if condition fails.
+     *  Format: "file-exists:FILENAME" */
+    condition?: string;
+    /** Custom prompt to pass to the agent (appended to the default stage prompt) */
+    prompt?: string;
+}
+/**
+ * Full pipeline definition loaded from YAML.
+ */
+export interface PipelineDefinition {
+    stages: PipelineStageDefinition[];
+}
+/**
+ * Map a custom stage name to the closest StageName for state tracking.
+ * Custom stages that don't match a known stage get mapped to 'evaluate' (the catch-all).
+ */
+export declare function stageNameForDefinition(def: PipelineStageDefinition): StageName;
+/**
+ * Load a custom pipeline definition from `.swarm/pipeline.yaml`.
+ * Returns null if the file does not exist.
+ */
+export declare function loadPipelineDefinition(swarmDir: string): PipelineDefinition | null;
+/**
+ * Return the standard 5-stage pipeline definition (analyze -> architect -> plan -> build -> test).
+ */
+export declare function getDefaultPipelineDefinition(): PipelineDefinition;
+/**
+ * Validate a pipeline definition. Returns an array of error messages (empty = valid).
+ */
+export declare function validateDefinition(def: PipelineDefinition): string[];
+//# sourceMappingURL=pipeline-loader.d.ts.map

package/dist/src/core/pipeline-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-loader.d.ts","sourceRoot":"","sources":["../../../src/core/pipeline-loader.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8DAA8D;IAC9D,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,iFAAiF;IACjF,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;yCACqC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gFAAgF;IAChF,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,uBAAuB,EAAE,CAAC;CACnC;AAOD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,uBAAuB,GAAG,SAAS,CAS9E;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI,CAyClF;AAED;;GAEG;AACH,wBAAgB,4BAA4B,IAAI,kBAAkB,CAiCjE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,kBAAkB,GAAG,MAAM,EAAE,CAsDpE"}

package/dist/src/core/pipeline-loader.js

@@ -0,0 +1,182 @@
+import { readFileSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { parse as parseYaml } from 'yaml';
+/** Valid persona values for validation */
+const VALID_PERSONAS = new Set([
+    'analyst', 'architect', 'lead', 'engineer', 'tester',
+]);
+/**
+ * Map a custom stage name to the closest StageName for state tracking.
+ * Custom stages that don't match a known stage get mapped to 'evaluate' (the catch-all).
+ */
+export function stageNameForDefinition(def) {
+    const personaStageMap = {
+        analyst: 'analyze',
+        architect: 'architect',
+        lead: 'plan',
+        engineer: 'build',
+        tester: 'test',
+    };
+    return personaStageMap[def.persona] ?? 'evaluate';
+}
+/**
+ * Load a custom pipeline definition from `.swarm/pipeline.yaml`.
+ * Returns null if the file does not exist.
+ */
+export function loadPipelineDefinition(swarmDir) {
+    const yamlPath = join(swarmDir, 'pipeline.yaml');
+    if (!existsSync(yamlPath)) {
+        return null;
+    }
+    const raw = readFileSync(yamlPath, 'utf-8');
+    const parsed = parseYaml(raw);
+    if (!parsed || typeof parsed !== 'object' || !Array.isArray(parsed.stages)) {
+        throw new Error(`Invalid pipeline.yaml: expected top-level "stages" array. Got: ${JSON.stringify(Object.keys(parsed ?? {}))}`);
+    }
+    const stages = parsed.stages.map((s, i) => {
+        if (!s.name || typeof s.name !== 'string') {
+            throw new Error(`pipeline.yaml: stage[${i}] missing required "name" field`);
+        }
+        if (!s.persona || typeof s.persona !== 'string') {
+            throw new Error(`pipeline.yaml: stage[${i}] ("${s.name}") missing required "persona" field`);
+        }
+        return {
+            name: s.name,
+            persona: s.persona,
+            artifact: s.artifact,
+            dependsOn: Array.isArray(s.dependsOn) ? s.dependsOn : undefined,
+            parallel: typeof s.parallel === 'boolean' ? s.parallel : undefined,
+            condition: typeof s.condition === 'string' ? s.condition : undefined,
+            prompt: typeof s.prompt === 'string' ? s.prompt : undefined,
+        };
+    });
+    const definition = { stages };
+    const errors = validateDefinition(definition);
+    if (errors.length > 0) {
+        throw new Error(`Invalid pipeline.yaml:\n  - ${errors.join('\n  - ')}`);
+    }
+    return definition;
+}
+/**
+ * Return the standard 5-stage pipeline definition (analyze -> architect -> plan -> build -> test).
+ */
+export function getDefaultPipelineDefinition() {
+    return {
+        stages: [
+            {
+                name: 'analyze',
+                persona: 'analyst',
+                artifact: 'REQUIREMENTS.md',
+            },
+            {
+                name: 'architect',
+                persona: 'architect',
+                artifact: 'SPEC.md',
+                dependsOn: ['analyze'],
+            },
+            {
+                name: 'plan',
+                persona: 'lead',
+                artifact: 'TASKS.md',
+                dependsOn: ['architect'],
+            },
+            {
+                name: 'build',
+                persona: 'engineer',
+                dependsOn: ['plan'],
+            },
+            {
+                name: 'test',
+                persona: 'tester',
+                artifact: 'TESTPLAN.md',
+                dependsOn: ['build'],
+            },
+        ],
+    };
+}
+/**
+ * Validate a pipeline definition. Returns an array of error messages (empty = valid).
+ */
+export function validateDefinition(def) {
+    const errors = [];
+    if (!def.stages || def.stages.length === 0) {
+        errors.push('Pipeline must have at least one stage');
+        return errors;
+    }
+    // Check for duplicate names
+    const names = new Set();
+    for (const stage of def.stages) {
+        if (names.has(stage.name)) {
+            errors.push(`Duplicate stage name: "${stage.name}"`);
+        }
+        names.add(stage.name);
+    }
+    // Validate each stage
+    for (const stage of def.stages) {
+        // Valid persona
+        if (!VALID_PERSONAS.has(stage.persona)) {
+            errors.push(`Stage "${stage.name}": invalid persona "${stage.persona}". ` +
+                `Must be one of: ${[...VALID_PERSONAS].join(', ')}`);
+        }
+        // dependsOn references exist
+        if (stage.dependsOn) {
+            for (const dep of stage.dependsOn) {
+                if (!names.has(dep)) {
+                    errors.push(`Stage "${stage.name}": depends on unknown stage "${dep}"`);
+                }
+            }
+        }
+        // Validate condition format
+        if (stage.condition) {
+            if (!stage.condition.startsWith('file-exists:')) {
+                errors.push(`Stage "${stage.name}": invalid condition "${stage.condition}". ` +
+                    `Supported formats: "file-exists:FILENAME"`);
+            }
+        }
+    }
+    // Check for circular dependencies
+    const circularError = detectCircularDeps(def.stages);
+    if (circularError) {
+        errors.push(circularError);
+    }
+    return errors;
+}
+/**
+ * Detect circular dependencies via topological sort.
+ * Returns an error string if a cycle is found, null otherwise.
+ */
+function detectCircularDeps(stages) {
+    const visited = new Set();
+    const visiting = new Set();
+    const stageMap = new Map();
+    for (const s of stages) {
+        stageMap.set(s.name, s);
+    }
+    function visit(name) {
+        if (visiting.has(name)) {
+            return `Circular dependency detected involving stage "${name}"`;
+        }
+        if (visited.has(name)) {
+            return null;
+        }
+        visiting.add(name);
+        const stage = stageMap.get(name);
+        if (stage?.dependsOn) {
+            for (const dep of stage.dependsOn) {
+                const err = visit(dep);
+                if (err)
+                    return err;
+            }
+        }
+        visiting.delete(name);
+        visited.add(name);
+        return null;
+    }
+    for (const s of stages) {
+        const err = visit(s.name);
+        if (err)
+            return err;
+    }
+    return null;
+}
+//# sourceMappingURL=pipeline-loader.js.map

package/dist/src/core/pipeline-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-loader.js","sourceRoot":"","sources":["../../../src/core/pipeline-loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AA+B1C,0CAA0C;AAC1C,MAAM,cAAc,GAAwB,IAAI,GAAG,CAAU;IAC3D,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ;CACrD,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,GAA4B;IACjE,MAAM,eAAe,GAA+B;QAClD,OAAO,EAAE,SAAS;QAClB,SAAS,EAAE,WAAW;QACtB,IAAI,EAAE,MAAM;QACZ,QAAQ,EAAE,OAAO;QACjB,MAAM,EAAE,MAAM;KACf,CAAC;IACF,OAAO,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,UAAU,CAAC;AACpD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,QAAgB;IACrD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC;IACjD,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,GAAG,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAA4B,CAAC;IAEzD,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3E,MAAM,IAAI,KAAK,CACb,kEAAkE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,EAAE,CAC9G,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAA+B,MAAM,CAAC,MAAoC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QAClG,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC1C,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,iCAAiC,CAAC,CAAC;QAC9E,CAAC;QACD,IAAI,CAAC,CAAC,CAAC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;YAChD,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,OAAO,CAAC,CAAC,IAAI,qCAAqC,CAAC,CAAC;QAC/F,CAAC;QACD,OAAO;YACL,IAAI,EAAE,CAAC,CAAC,IAAc;YACtB,OAAO,EAAE,CAAC,CAAC,OAAkB;YAC7B,QAAQ,EAAE,CAAC,CAAC,QAA8B;YAC1C,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC,SAAsB,CAAC,CAAC,CAAC,SAAS;YAC7E,QAAQ,EAAE,OAAO,CAAC,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;YAClE,SAAS,EAAE,OAAO,CAAC,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;YACpE,MAAM,EAAE,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;SAC5D,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,MAAM,UAAU,GAAuB,EAAE,MAAM,EAAE,CAAC;IAElD,MAAM,MAAM,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAC9C,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,+BAA+B,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC1E,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,4BAA4B;IAC1C,OAAO;QACL,MAAM,EAAE;YACN;gBACE,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,SAAS;gBAClB,QAAQ,EAAE,iBAAiB;aAC5B;YACD;gBACE,IAAI,EAAE,WAAW;gBACjB,OAAO,EAAE,WAAW;gBACpB,QAAQ,EAAE,SAAS;gBACnB,SAAS,EAAE,CAAC,SAAS,CAAC;aACvB;YACD;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE,MAAM;gBACf,QAAQ,EAAE,UAAU;gBACpB,SAAS,EAAE,CAAC,WAAW,CAAC;aACzB;YACD;gBACE,IAAI,EAAE,OAAO;gBACb,OAAO,EAAE,UAAU;gBACnB,SAAS,EAAE,CAAC,MAAM,CAAC;aACpB;YACD;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE,QAAQ;gBACjB,QAAQ,EAAE,aAAa;gBACvB,SAAS,EAAE,CAAC,OAAO,CAAC;aACrB;SACF;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAuB;IACxD,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,IAAI,CAAC,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3C,MAAM,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC;QACrD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,4BAA4B;IAC5B,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;QAC/B,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1B,MAAM,CAAC,IAAI,CAAC,0BAA0B,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC;QACvD,CAAC;QACD,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAED,sBAAsB;IACtB,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;QAC/B,gBAAgB;QAChB,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;YACvC,MAAM,CAAC,IAAI,CACT,UAAU,KAAK,CAAC,IAAI,uBAAuB,KAAK,CAAC,OAAO,KAAK;gBAC7D,mBAAmB,CAAC,GAAG,cAAc,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACpD,CAAC;QACJ,CAAC;QAED,6BAA6B;QAC7B,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;YACpB,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;gBAClC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;oBACpB,MAAM,CAAC,IAAI,CAAC,UAAU,KAAK,CAAC,IAAI,gCAAgC,GAAG,GAAG,CAAC,CAAC;gBAC1E,CAAC;YACH,CAAC;QACH,CAAC;QAED,4BAA4B;QAC5B,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;YACpB,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;gBAChD,MAAM,CAAC,IAAI,CACT,UAAU,KAAK,CAAC,IAAI,yBAAyB,KAAK,CAAC,SAAS,KAAK;oBACjE,2CAA2C,CAC5C,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,kCAAkC;IAClC,MAAM,aAAa,GAAG,kBAAkB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACrD,IAAI,aAAa,EAAE,CAAC;QAClB,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC7B,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,SAAS,kBAAkB,CAAC,MAAiC;IAC3D,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;IACnC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAmC,CAAC;IAE5D,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAC1B,CAAC;IAED,SAAS,KAAK,CAAC,IAAY;QACzB,IAAI,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACvB,OAAO,iDAAiD,IAAI,GAAG,CAAC;QAClE,CAAC;QACD,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACtB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACnB,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,KAAK,EAAE,SAAS,EAAE,CAAC;YACrB,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;gBAClC,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;gBACvB,IAAI,GAAG;oBAAE,OAAO,GAAG,CAAC;YACtB,CAAC;QACH,CAAC;QACD,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACtB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC1B,IAAI,GAAG;YAAE,OAAO,GAAG,CAAC;IACtB,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/src/core/pipeline.d.ts

@@ -0,0 +1,183 @@
+import { AgentManager } from './agent-manager.js';
+import { StateManager } from './state.js';
+import type { SwarmConfig, StageName, TechStack } from '../types.js';
+import type { PipelineDefinition } from './pipeline-loader.js';
+interface StageOpts {
+    stack?: TechStack;
+    interactive?: boolean;
+    figmaUrl?: string;
+    prompt?: string;
+    /** When true, skip all interactive pauses (for CI/automation/dashboard) */
+    headless?: boolean;
+}
+export declare class Pipeline {
+    private agentManager;
+    private state;
+    private config;
+    private budgetExceeded;
+    gitEnabled: boolean;
+    autoPR: boolean;
+    private webhooks;
+    private quality;
+    private guardrails;
+    private _codebaseContext;
+    private _conventionPrompt;
+    private _memoryContext;
+    private memoryStore;
+    constructor(agentManager: AgentManager, state: StateManager, config: SwarmConfig);
+    /**
+     * Get the working directory for the current pipeline.
+     * Uses worktree path if available, otherwise falls back to this.projectCwd.
+     */
+    get projectCwd(): string;
+    /** Scan and cache the codebase context for injecting into stage prompts. */
+    private getCodebaseContext;
+    /** Load and cache project conventions for injection into all agent system prompts. */
+    private getConventionPrompt;
+    /** Load and cache cross-run memory context for injection into agent prompts. */
+    private getMemoryContext;
+    /** Build the full appendSystemPrompt for an agent: enforcement rules + conventions + memory. */
+    private buildAppendSystemPrompt;
+    /** Get conventions + memory system prompt for engineers (no enforcement rules needed). */
+    private getEngineerConventions;
+    /**
+     * Wraps agentManager.waitForAgent to surface a clear budget error
+     * when agents are killed due to budget enforcement.
+     */
+    private waitForAgentWithBudgetCheck;
+    /** Resolve model for a persona — checks per-persona overrides, then falls back to default */
+    private modelFor;
+    private slugify;
+    private createFeatureBranch;
+    private autoCommitStage;
+    /**
+     * Attempt to auto-create a GitHub PR after a successful MayDay run.
+     * Failures are logged as warnings — they never crash the pipeline.
+     */
+    private attemptAutoCreatePR;
+    runAnalyze(featureRequest: string, opts?: StageOpts): Promise<void>;
+    runArchitect(opts?: StageOpts): Promise<void>;
+    runPlan(opts?: StageOpts): Promise<void>;
+    runBuild(opts?: {
+        parallel?: number;
+        taskId?: string;
+        stack?: TechStack;
+    }): Promise<void>;
+    runTest(opts?: {
+        parallel?: number;
+        stack?: TechStack;
+        figmaUrl?: string;
+        interactive?: boolean;
+    }): Promise<void>;
+    /** Build the Phase 1 tester prompt — framework-aware */
+    private buildTesterPrompt;
+    /** Build the Phase 2 runner prompt — framework-aware */
+    private buildRunnerPrompt;
+    runFull(featureRequest: string, opts?: StageOpts): Promise<void>;
+    /**
+     * Run a custom pipeline defined by a PipelineDefinition.
+     * Iterates through stages respecting dependsOn and condition fields.
+     */
+    runCustomPipeline(definition: PipelineDefinition, featureRequest: string, opts?: StageOpts & {
+        parallel?: number;
+    }): Promise<void>;
+    /**
+     * Run a stage with retry. On first failure: log, wait 5s, retry.
+     * On second failure: throw (caller decides whether to abort or skip).
+     */
+    /** Tracks failure reasons per stage so downstream stages can reference them */
+    private stageFailureContext;
+    /** Get failure context from a previous stage attempt (for backward context flow) */
+    getStageFailureContext(stage: StageName): string | undefined;
+    private runStageWithRetry;
+    /**
+     * Evaluate a stage condition. Returns true if the stage should be SKIPPED.
+     */
+    private evaluateCondition;
+    private printStageHeader;
+    /**
+     * Generate a concise context summary from an artifact file (~500 chars).
+     * Extracts key structural info depending on artifact type.
+     */
+    private generateContextSummary;
+    private finishStage;
+    /**
+     * Generate FAILURE-REPORT.md when MayDay fails, preserving what was attempted and what succeeded.
+     */
+    private generateFailureReport;
+    /**
+     * Validate that required artifacts exist when skipping stages via --from.
+     * Each stage depends on artifacts from prior stages.
+     */
+    private validateSkippedArtifacts;
+    /**
+     * Parse TASKS.md into execution groups. Supports two formats:
+     *
+     * 1. Spec-kit format (preferred): `- [ ] T001 [P] [US1] description — \`file.ts\``
+     *    Tasks with [P] marker are parallelizable. Phases become groups.
+     *
+     * 2. Legacy format: `## Phase N` / `### Parallel Group` headings with `- [ ] **FND-001** ...`
+     */
+    private parseTaskGroups;
+    /**
+     * Spec-kit format: phases are sequential gates, tasks with [P] run in parallel.
+     * Groups adjacent [P] tasks within each phase into parallel batches.
+     */
+    private parseSpecKitTasks;
+    /** Legacy format: ## Phase headings with ### Parallel Group sub-headings */
+    private parseLegacyTasks;
+    private buildPlaywrightContext;
+    runMayday(featureRequest: string, opts?: {
+        stack?: TechStack;
+        maxIterations?: number;
+        figmaUrl?: string;
+        parallel?: number;
+        model?: string;
+        maxFixBudgetUsd?: number | null;
+        fromStage?: StageName;
+        approvalRequired?: boolean;
+        /** When true, skip all interactive pauses (for CI/automation/dashboard) */
+        headless?: boolean;
+    }): Promise<void>;
+    resumeMayday(opts?: {
+        parallel?: number;
+        headless?: boolean;
+    }): Promise<void>;
+    private executeMaydayPipeline;
+    private maydayFixLoop;
+    /** Record a successful pipeline run to memory */
+    private recordSuccessMemory;
+    /** Record a failed pipeline run to memory */
+    private recordFailureMemory;
+    /** Group test failures by source file for targeted fixing (I1) */
+    private groupFailuresByFile;
+    /** Build a targeted fix prompt for a specific failure group */
+    private buildTargetedFixPrompt;
+    private buildFixPrompt;
+    private evaluateTestResults;
+    /** Parse structured test results JSON — auto-detects format (Playwright, Vitest, go test, pytest) */
+    private parseStructuredTestResults;
+    /** Parse Playwright JSON reporter output */
+    private parsePlaywrightJson;
+    /** Parse Vitest JSON reporter output */
+    private parseVitestJson;
+    /** Parse pytest-json-report output */
+    private parsePytestJson;
+    /** Parse go test -json NDJSON string */
+    private parseGoTestJson;
+    /** Parse go test -json NDJSON lines */
+    private parseGoTestJsonLines;
+    /** Regex-based fallback for parsing test output */
+    private parseTestOutputRegex;
+    private chunk;
+    /**
+     * Estimate cost for a pipeline run based on model and number of stages.
+     * Returns a { low, high } range in USD.
+     */
+    static estimateCost(stageCount: number, model: string): {
+        low: number;
+        high: number;
+    };
+}
+export {};
+//# sourceMappingURL=pipeline.d.ts.map

package/dist/src/core/pipeline.d.ts.map

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