agent-pipeline 0.1.0 → 0.1.1

package/dist/core/handover-manager.js

@@ -0,0 +1,214 @@
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { InstructionLoader } from './instruction-loader.js';
+export class HandoverManager {
+    handoverDir;
+    pipelineName;
+    runId;
+    instructionLoader;
+    constructor(repoPath, pipelineName, runId, config) {
+        this.pipelineName = pipelineName;
+        this.runId = runId;
+        this.instructionLoader = new InstructionLoader(repoPath);
+        const runIdSuffix = runId.substring(0, 8);
+        if (config?.directory) {
+            const customBase = path.isAbsolute(config.directory)
+                ? config.directory
+                : path.join(repoPath, config.directory);
+            this.handoverDir = path.join(customBase, runIdSuffix);
+        }
+        else {
+            this.handoverDir = path.join(repoPath, '.agent-pipeline', 'runs', `${pipelineName}-${runIdSuffix}`);
+        }
+    }
+    getHandoverDir() {
+        return this.handoverDir;
+    }
+    async initialize() {
+        await fs.mkdir(this.handoverDir, { recursive: true });
+        await fs.mkdir(path.join(this.handoverDir, 'stages'), { recursive: true });
+        const runsDir = path.dirname(this.handoverDir);
+        const runsGitignore = path.join(runsDir, '.gitignore');
+        try {
+            await fs.access(runsGitignore);
+        }
+        catch {
+            await fs.writeFile(runsGitignore, '# Ignore all pipeline run artifacts\n*\n!.gitignore\n');
+        }
+        await fs.writeFile(path.join(this.handoverDir, 'HANDOVER.md'), this.buildInitialHandover());
+        await fs.writeFile(path.join(this.handoverDir, 'execution-log.md'), this.buildInitialLog());
+    }
+    async createStageDirectory(stageName) {
+        const stageDir = path.join(this.handoverDir, 'stages', stageName);
+        await fs.mkdir(stageDir, { recursive: true });
+        return stageDir;
+    }
+    async saveAgentOutput(stageName, output) {
+        const stageDir = await this.createStageDirectory(stageName);
+        await fs.writeFile(path.join(stageDir, 'output.md'), output);
+    }
+    async appendToLog(stageName, status, duration, summary) {
+        const timestamp = new Date().toISOString();
+        const logEntry = `
+---
+## [${timestamp}] Stage: ${stageName}
+**Status:** ${status} | **Duration:** ${duration.toFixed(1)}s
+**Summary:** ${summary}
+`;
+        const logPath = path.join(this.handoverDir, 'execution-log.md');
+        await fs.appendFile(logPath, logEntry);
+    }
+    async getPreviousStages() {
+        try {
+            const stagesDir = path.join(this.handoverDir, 'stages');
+            const entries = await fs.readdir(stagesDir, { withFileTypes: true });
+            return entries
+                .filter(e => e.isDirectory())
+                .map(e => e.name);
+        }
+        catch {
+            return [];
+        }
+    }
+    buildContextMessage(stageName, previousStages) {
+        const previousStagesSection = previousStages.length > 0
+            ? previousStages.map(s => `- \`${this.handoverDir}/stages/${s}/output.md\``).join('\n')
+            : '(none - this is the first stage)';
+        return `## Pipeline Handover Context
+
+**Handover Directory:** \`${this.handoverDir}\`
+
+### Required Reading
+Before starting your task, read these files to understand the current state:
+1. \`${this.handoverDir}/HANDOVER.md\` - Current pipeline state and context
+2. \`${this.handoverDir}/execution-log.md\` - Execution history
+
+### Previous Stage Outputs
+${previousStagesSection}
+
+### Your Output Requirements
+
+**output.md is a summary file only.** Keep it minimal and to the point.
+
+Save your summary to: \`${this.handoverDir}/stages/${stageName}/output.md\`
+
+\`\`\`markdown
+# Stage: ${stageName}
+
+## Summary
+{1-2 sentences max: what you accomplished}
+
+## Files Changed
+{list paths only, no descriptions}
+
+## Reference Files
+{list any additional files you saved to this stage directory}
+
+## Next Stage Context
+{1-2 bullet points only if critical context is needed}
+\`\`\`
+
+**Guidelines:**
+- output.md contains ONLY the requested summary—no detailed analysis, logs, or verbose explanations
+- For detailed output (analysis reports, data dumps, reference material), write separate files to \`${this.handoverDir}/stages/${stageName}/\` and reference them in output.md
+- Be ruthlessly concise—next stages can read your reference files if they need details
+
+The orchestrator will update HANDOVER.md and execution-log.md automatically.
+`;
+    }
+    async readStageOutput(stageName) {
+        const outputPath = path.join(this.handoverDir, 'stages', stageName, 'output.md');
+        try {
+            return await fs.readFile(outputPath, 'utf-8');
+        }
+        catch {
+            return `(No output found for stage: ${stageName})`;
+        }
+    }
+    async copyStageToHandover(stageName) {
+        const stageOutput = await this.readStageOutput(stageName);
+        const handoverContent = this.formatAsHandover(stageName, stageOutput);
+        await fs.writeFile(path.join(this.handoverDir, 'HANDOVER.md'), handoverContent);
+    }
+    async mergeParallelOutputs(stageNames) {
+        const outputs = await Promise.all(stageNames.map(async (name) => ({
+            name,
+            content: await this.readStageOutput(name)
+        })));
+        const mergedContent = this.formatMergedHandover(outputs);
+        await fs.writeFile(path.join(this.handoverDir, 'HANDOVER.md'), mergedContent);
+    }
+    formatAsHandover(stageName, stageOutput) {
+        return `# Pipeline Handover
+
+## Current Status
+- Stage: ${stageName}
+- Status: success
+- Timestamp: ${new Date().toISOString()}
+
+## Stage Output
+
+${stageOutput}
+`;
+    }
+    formatMergedHandover(outputs) {
+        const stageNames = outputs.map(o => o.name).join(', ');
+        const stageSections = outputs
+            .map(o => `### ${o.name}\n\n${o.content}`)
+            .join('\n\n---\n\n');
+        return `# Pipeline Handover
+
+## Current Status
+- Stages: ${stageNames} (parallel group completed)
+- Status: success
+- Timestamp: ${new Date().toISOString()}
+
+## Parallel Stage Outputs
+
+${stageSections}
+`;
+    }
+    async buildContextMessageAsync(stageName, previousStages, instructionPath) {
+        const previousStagesSection = previousStages.length > 0
+            ? previousStages.map(s => `- \`${this.handoverDir}/stages/${s}/output.md\``).join('\n')
+            : '(none - this is the first stage)';
+        const context = {
+            handoverDir: this.handoverDir,
+            stageName,
+            timestamp: new Date().toISOString(),
+            previousStagesSection
+        };
+        return this.instructionLoader.loadHandoverInstructions(instructionPath, context);
+    }
+    buildInitialHandover() {
+        return `# Pipeline Handover
+
+## Current Status
+- Stage: (none - pipeline starting)
+- Status: initializing
+- Timestamp: ${new Date().toISOString()}
+
+## Summary
+Pipeline "${this.pipelineName}" is starting. No stages have executed yet.
+
+## Key Outputs
+(none yet)
+
+## Files Created/Modified
+(none yet)
+
+## Notes for Next Stage
+This is the first stage. Read your task instructions carefully.
+`;
+    }
+    buildInitialLog() {
+        return `# Pipeline Execution Log
+
+**Pipeline:** ${this.pipelineName}
+**Run ID:** ${this.runId}
+**Started:** ${new Date().toISOString()}
+
+`;
+    }
+}
+//# sourceMappingURL=handover-manager.js.map

package/dist/core/handover-manager.js.map

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

package/dist/core/instruction-loader.d.ts

@@ -0,0 +1,23 @@
+export interface InstructionContext {
+    handoverDir?: string;
+    stageName?: string;
+    timestamp?: string;
+    previousStagesSection?: string;
+    pendingDir?: string;
+    currentIteration?: number;
+    maxIterations?: number;
+    pipelineName?: string;
+}
+export declare class InstructionLoader {
+    private repoPath;
+    private static readonly DEFAULT_HANDOVER_PATH;
+    private static readonly DEFAULT_LOOP_PATH;
+    constructor(repoPath: string);
+    loadHandoverInstructions(customPath?: string, context?: InstructionContext): Promise<string>;
+    loadLoopInstructions(customPath?: string, context?: InstructionContext): Promise<string>;
+    private loadTemplate;
+    private interpolate;
+    private getBuiltInHandoverTemplate;
+    private getBuiltInLoopTemplate;
+}
+//# sourceMappingURL=instruction-loader.d.ts.map

package/dist/core/instruction-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instruction-loader.d.ts","sourceRoot":"","sources":["../../src/core/instruction-loader.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,kBAAkB;IAEjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAG/B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAS;IAEzB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAA8C;IAC3F,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAA0C;gBAEvE,QAAQ,EAAE,MAAM;IAOtB,wBAAwB,CAC5B,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,MAAM,CAAC;IAYZ,oBAAoB,CACxB,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,MAAM,CAAC;YAeJ,YAAY;IA8B1B,OAAO,CAAC,WAAW;IAanB,OAAO,CAAC,0BAA0B;IA2ClC,OAAO,CAAC,sBAAsB;CAyB/B"}

package/dist/core/instruction-loader.js

@@ -0,0 +1,112 @@
+import * as fs from 'fs/promises';
+import * as path from 'path';
+export class InstructionLoader {
+    repoPath;
+    static DEFAULT_HANDOVER_PATH = '.agent-pipeline/instructions/handover.md';
+    static DEFAULT_LOOP_PATH = '.agent-pipeline/instructions/loop.md';
+    constructor(repoPath) {
+        this.repoPath = repoPath;
+    }
+    async loadHandoverInstructions(customPath, context) {
+        const content = await this.loadTemplate(customPath, InstructionLoader.DEFAULT_HANDOVER_PATH, this.getBuiltInHandoverTemplate());
+        return this.interpolate(content, context || {});
+    }
+    async loadLoopInstructions(customPath, context) {
+        const content = await this.loadTemplate(customPath, InstructionLoader.DEFAULT_LOOP_PATH, this.getBuiltInLoopTemplate());
+        return this.interpolate(content, context || {});
+    }
+    async loadTemplate(customPath, defaultPath, builtInTemplate) {
+        if (customPath) {
+            const fullPath = path.isAbsolute(customPath)
+                ? customPath
+                : path.join(this.repoPath, customPath);
+            try {
+                return await fs.readFile(fullPath, 'utf-8');
+            }
+            catch {
+                console.warn(`Custom instruction file not found: ${customPath}, falling back to default`);
+            }
+        }
+        const defaultFullPath = path.join(this.repoPath, defaultPath);
+        try {
+            return await fs.readFile(defaultFullPath, 'utf-8');
+        }
+        catch {
+            return builtInTemplate;
+        }
+    }
+    interpolate(template, context) {
+        return template.replace(/\{\{(\w+)\}\}/g, (match, key) => {
+            const value = context[key];
+            if (value === undefined || value === null) {
+                return match;
+            }
+            return String(value);
+        });
+    }
+    getBuiltInHandoverTemplate() {
+        return `## Pipeline Handover Context
+
+**Handover Directory:** \`{{handoverDir}}\` *(absolute path - use exactly as shown)*
+
+### Required Reading
+Before starting your task, read these files to understand the current state:
+1. \`{{handoverDir}}/HANDOVER.md\` - Current pipeline state and context
+2. \`{{handoverDir}}/execution-log.md\` - Execution history
+
+### Previous Stage Outputs
+{{previousStagesSection}}
+
+### Your Output Requirements
+When you complete your task, save your output to:
+\`{{handoverDir}}/stages/{{stageName}}/output.md\`
+
+> **Note:** This is an absolute path. You have permission to write here regardless of your current working directory.
+
+Use this format:
+\`\`\`markdown
+# Stage: {{stageName}}
+
+## Summary
+{1-2 sentences: what you accomplished}
+
+## Key Outputs
+{bullet points of important results}
+
+## Files Created/Modified
+{list files you changed}
+
+## Notes for Next Stage
+{context the next agent needs}
+\`\`\`
+
+The orchestrator will update HANDOVER.md and execution-log.md automatically.
+`;
+    }
+    getBuiltInLoopTemplate() {
+        return `## Pipeline Looping
+
+This pipeline is running in LOOP MODE. You are in the FINAL stage group.
+
+**When to Create a Next Pipeline:**
+Create a pipeline in the pending directory ONLY when:
+1. You discovered unexpected new work outside your current scope
+2. You have a task that explicitly calls for the next agent (like "Pass to the next agent")
+3. You are finishing a phase in a multi-phase plan and more phases remain
+   - Create a pipeline for the NEXT PHASE ONLY (not all remaining phases)
+
+**When NOT to Create a Next Pipeline:**
+- Your task is complete with no follow-up needed
+- The work is a simple fix that doesn't warrant a new pipeline
+- Subsequent work is better handled by a human
+
+**To queue the next pipeline:**
+- Write a valid pipeline YAML to: \`{{pendingDir}}\`
+- Automatically picked up after this pipeline completes
+- Reference: \`.agent-pipeline/pipelines/{{pipelineName}}.yml\`
+
+**Loop status:** Iteration {{currentIteration}}/{{maxIterations}}
+`;
+    }
+}
+//# sourceMappingURL=instruction-loader.js.map

package/dist/core/instruction-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instruction-loader.js","sourceRoot":"","sources":["../../src/core/instruction-loader.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAgB7B,MAAM,OAAO,iBAAiB;IACpB,QAAQ,CAAS;IAEjB,MAAM,CAAU,qBAAqB,GAAG,0CAA0C,CAAC;IACnF,MAAM,CAAU,iBAAiB,GAAG,sCAAsC,CAAC;IAEnF,YAAY,QAAgB;QAC1B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAKD,KAAK,CAAC,wBAAwB,CAC5B,UAAmB,EACnB,OAA4B;QAE5B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,YAAY,CACrC,UAAU,EACV,iBAAiB,CAAC,qBAAqB,EACvC,IAAI,CAAC,0BAA0B,EAAE,CAClC,CAAC;QACF,OAAO,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC;IAClD,CAAC;IAKD,KAAK,CAAC,oBAAoB,CACxB,UAAmB,EACnB,OAA4B;QAE5B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,YAAY,CACrC,UAAU,EACV,iBAAiB,CAAC,iBAAiB,EACnC,IAAI,CAAC,sBAAsB,EAAE,CAC9B,CAAC;QACF,OAAO,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC;IAClD,CAAC;IAQO,KAAK,CAAC,YAAY,CACxB,UAA8B,EAC9B,WAAmB,EACnB,eAAuB;QAGvB,IAAI,UAAU,EAAE,CAAC;YACf,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;gBAC1C,CAAC,CAAC,UAAU;gBACZ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;YACzC,IAAI,CAAC;gBACH,OAAO,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAC9C,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,CAAC,IAAI,CAAC,sCAAsC,UAAU,2BAA2B,CAAC,CAAC;YAC5F,CAAC;QACH,CAAC;QAGD,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;QAC9D,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,CAAC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;QACrD,CAAC;QAAC,MAAM,CAAC;YAEP,OAAO,eAAe,CAAC;QACzB,CAAC;IACH,CAAC;IAKO,WAAW,CAAC,QAAgB,EAAE,OAA2B;QAC/D,OAAO,QAAQ,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;YACvD,MAAM,KAAK,GAAG,OAAO,CAAC,GAA+B,CAAC,CAAC;YACvD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBAC1C,OAAO,KAAK,CAAC;YACf,CAAC;YACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC,CAAC,CAAC;IACL,CAAC;IAKO,0BAA0B;QAChC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoCV,CAAC;IACA,CAAC;IAKO,sBAAsB;QAC5B,OAAO;;;;;;;;;;;;;;;;;;;;;;CAsBV,CAAC;IACA,CAAC"}

package/dist/core/loop-state-manager.d.ts

@@ -1,8 +1,9 @@
+import { ResolvedLoopingConfig } from '../config/schema.js';
 export interface LoopSession {
     sessionId: string;
     startTime: string;
     endTime?: string;
-    status: 'running' | 'completed' | 'failed' | 'limit-reached';
+    status: 'running' | 'completed' | 'failed' | 'aborted' | 'limit-reached';
     maxIterations: number;
     totalIterations: number;
     iterations: IterationSummary[];
@@ -10,20 +11,24 @@ export interface LoopSession {
 export interface IterationSummary {
     iterationNumber: number;
     pipelineName: string;
-    runId: string;
-    status: 'completed' | 'failed';
-    duration: number;
-    triggeredNext: boolean;
+    runId?: string;
+    status: 'in-progress' | 'completed' | 'failed' | 'aborted';
+    duration?: number;
+    triggeredNext?: boolean;
 }
 export declare class LoopStateManager {
     private loopsDir;
     private sessions;
     constructor(repoPath: string);
-    startSession(maxIterations: number): LoopSession;
+    startSession(maxIterations: number): Promise<LoopSession>;
     appendIteration(sessionId: string, summary: IterationSummary): Promise<void>;
-    completeSession(sessionId: string, status: 'completed' | 'failed' | 'limit-reached'): Promise<void>;
+    updateIteration(sessionId: string, iterationNumber: number, updates: Partial<IterationSummary>): Promise<boolean>;
+    completeSession(sessionId: string, status: 'completed' | 'failed' | 'aborted' | 'limit-reached'): Promise<void>;
     loadSession(sessionId: string): Promise<LoopSession | null>;
     getAllSessions(): Promise<LoopSession[]>;
     private saveSession;
+    private getSessionForUpdate;
+    createSessionDirectories(sessionId: string, basePath: string): Promise<ResolvedLoopingConfig['directories']>;
+    getSessionQueueDir(sessionId: string, basePath: string): string;
 }
 //# sourceMappingURL=loop-state-manager.d.ts.map

package/dist/core/loop-state-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loop-state-manager.d.ts","sourceRoot":"","sources":["../../src/core/loop-state-manager.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,eAAe,CAAC;IAC7D,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,gBAAgB,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,gBAAgB;IAC/B,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,WAAW,GAAG,QAAQ,CAAC;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAuC;gBAE3C,QAAQ,EAAE,MAAM;IAO5B,YAAY,CAAC,aAAa,EAAE,MAAM,GAAG,WAAW;IAiB1C,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAe5E,eAAe,CACnB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,eAAe,GAC/C,OAAO,CAAC,IAAI,CAAC;IAgBV,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAc3D,cAAc,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;YA2BhC,WAAW;CAM1B"}
+{"version":3,"file":"loop-state-manager.d.ts","sourceRoot":"","sources":["../../src/core/loop-state-manager.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,GAAG,eAAe,CAAC;IACzE,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,gBAAgB,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,gBAAgB;IAC/B,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,aAAa,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAuC;gBAE3C,QAAQ,EAAE,MAAM;IAOtB,YAAY,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAkBzD,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB5E,eAAe,CACnB,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,MAAM,EACvB,OAAO,EAAE,OAAO,CAAC,gBAAgB,CAAC,GACjC,OAAO,CAAC,OAAO,CAAC;IAmBb,eAAe,CACnB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,SAAS,GAAG,eAAe,GAC3D,OAAO,CAAC,IAAI,CAAC;IAgBV,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAc3D,cAAc,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;YA2BhC,WAAW;YAOX,mBAAmB;IAqB3B,wBAAwB,CAC5B,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,qBAAqB,CAAC,aAAa,CAAC,CAAC;IA8BhD,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;CAGhE"}

package/dist/core/loop-state-manager.js

@@ -7,7 +7,7 @@ export class LoopStateManager {
     constructor(repoPath) {
         this.loopsDir = path.join(repoPath, '.agent-pipeline', 'state', 'loops');
     }
-    startSession(maxIterations) {
+    async startSession(maxIterations) {
         const session = {
             sessionId: randomUUID(),
             startTime: new Date().toISOString(),
@@ -17,10 +17,11 @@ export class LoopStateManager {
             iterations: []
         };
         this.sessions.set(session.sessionId, session);
+        await this.saveSession(session);
         return session;
     }
     async appendIteration(sessionId, summary) {
-        const session = this.sessions.get(sessionId);
+        const session = await this.getSessionForUpdate(sessionId);
         if (!session) {
             throw new Error(`Loop session not found: ${sessionId}`);
         }
@@ -28,8 +29,21 @@ export class LoopStateManager {
         session.totalIterations = session.iterations.length;
         await this.saveSession(session);
     }
+    async updateIteration(sessionId, iterationNumber, updates) {
+        const session = await this.getSessionForUpdate(sessionId);
+        if (!session) {
+            throw new Error(`Loop session not found: ${sessionId}`);
+        }
+        const index = session.iterations.findIndex((iteration) => iteration.iterationNumber === iterationNumber);
+        if (index === -1) {
+            return false;
+        }
+        session.iterations[index] = { ...session.iterations[index], ...updates };
+        await this.saveSession(session);
+        return true;
+    }
     async completeSession(sessionId, status) {
-        const session = this.sessions.get(sessionId);
+        const session = await this.getSessionForUpdate(sessionId);
         if (!session) {
             throw new Error(`Loop session not found: ${sessionId}`);
         }
@@ -74,5 +88,37 @@ export class LoopStateManager {
         const filePath = path.join(this.loopsDir, `${session.sessionId}.json`);
         await fs.writeFile(filePath, JSON.stringify(session, null, 2), 'utf-8');
     }
+    async getSessionForUpdate(sessionId) {
+        const cached = this.sessions.get(sessionId);
+        if (cached) {
+            return cached;
+        }
+        const loaded = await this.loadSession(sessionId);
+        if (loaded) {
+            this.sessions.set(sessionId, loaded);
+        }
+        return loaded;
+    }
+    async createSessionDirectories(sessionId, basePath) {
+        const sessionDir = path.join(basePath, '.agent-pipeline', 'loops', sessionId);
+        const dirs = {
+            pending: path.join(sessionDir, 'pending'),
+            running: path.join(sessionDir, 'running'),
+            finished: path.join(sessionDir, 'finished'),
+            failed: path.join(sessionDir, 'failed'),
+        };
+        await Promise.all(Object.values(dirs).map(d => fs.mkdir(d, { recursive: true })));
+        const gitignorePath = path.join(sessionDir, '.gitignore');
+        try {
+            await fs.access(gitignorePath);
+        }
+        catch {
+            await fs.writeFile(gitignorePath, '# Ignore loop queue contents\n*\n!.gitignore\n');
+        }
+        return dirs;
+    }
+    getSessionQueueDir(sessionId, basePath) {
+        return path.join(basePath, '.agent-pipeline', 'loops', sessionId);
+    }
 }
 //# sourceMappingURL=loop-state-manager.js.map

package/dist/core/loop-state-manager.js.map

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

package/dist/core/parallel-executor.d.ts

@@ -1,5 +1,6 @@
 import { AgentStageConfig, StageExecution, PipelineState } from '../config/schema.js';
 import { StageExecutor } from './stage-executor.js';
+import { PipelineAbortController } from './abort-controller.js';
 export interface ParallelExecutionResult {
     executions: StageExecution[];
     allSucceeded: boolean;
@@ -9,13 +10,21 @@ export interface ParallelExecutionResult {
 export declare class ParallelExecutor {
     private stageExecutor;
     private onStateChange?;
-    constructor(stageExecutor: StageExecutor, onStateChange?: ((state: PipelineState) => void) | undefined);
+    private abortController?;
+    constructor(stageExecutor: StageExecutor, onStateChange?: ((state: PipelineState) => void) | undefined, abortController?: PipelineAbortController | undefined);
     private emitStateChange;
+    private isAborted;
     private createFailedExecution;
     private createStageCallback;
     private buildExecutionResult;
-    executeParallelGroup(stages: AgentStageConfig[], pipelineState: PipelineState, onOutputUpdate?: (stageName: string, output: string) => void): Promise<ParallelExecutionResult>;
-    executeSequentialGroup(stages: AgentStageConfig[], pipelineState: PipelineState, onOutputUpdate?: (stageName: string, output: string) => void): Promise<ParallelExecutionResult>;
+    private addRunningStage;
+    private updateStageInState;
+    executeParallelGroup(stages: AgentStageConfig[], pipelineState: PipelineState, onOutputUpdate?: (stageName: string, output: string) => void, groupContext?: {
+        isFinalGroup: boolean;
+    }): Promise<ParallelExecutionResult>;
+    executeSequentialGroup(stages: AgentStageConfig[], pipelineState: PipelineState, onOutputUpdate?: (stageName: string, output: string) => void, groupContext?: {
+        isFinalGroup: boolean;
+    }): Promise<ParallelExecutionResult>;
     aggregateResults(result: ParallelExecutionResult): string;
 }
 //# sourceMappingURL=parallel-executor.d.ts.map

package/dist/core/parallel-executor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parallel-executor.d.ts","sourceRoot":"","sources":["../../src/core/parallel-executor.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACtF,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGpD,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,cAAc,EAAE,CAAC;IAC7B,YAAY,EAAE,OAAO,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,gBAAgB;IAEzB,OAAO,CAAC,aAAa;IACrB,OAAO,CAAC,aAAa,CAAC;gBADd,aAAa,EAAE,aAAa,EAC5B,aAAa,CAAC,GAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,aAAA;IAGxD,OAAO,CAAC,eAAe;IAMvB,OAAO,CAAC,qBAAqB;IAe7B,OAAO,CAAC,mBAAmB;IAS3B,OAAO,CAAC,oBAAoB;IAwBtB,oBAAoB,CACxB,MAAM,EAAE,gBAAgB,EAAE,EAC1B,aAAa,EAAE,aAAa,EAC5B,cAAc,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,GAC3D,OAAO,CAAC,uBAAuB,CAAC;IA8C7B,sBAAsB,CAC1B,MAAM,EAAE,gBAAgB,EAAE,EAC1B,aAAa,EAAE,aAAa,EAC5B,cAAc,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,GAC3D,OAAO,CAAC,uBAAuB,CAAC;IA4BnC,gBAAgB,CAAC,MAAM,EAAE,uBAAuB,GAAG,MAAM;CAO1D"}
+{"version":3,"file":"parallel-executor.d.ts","sourceRoot":"","sources":["../../src/core/parallel-executor.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACtF,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,uBAAuB,EAAsB,MAAM,uBAAuB,CAAC;AAEpF,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,cAAc,EAAE,CAAC;IAC7B,YAAY,EAAE,OAAO,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,gBAAgB;IAEzB,OAAO,CAAC,aAAa;IACrB,OAAO,CAAC,aAAa,CAAC;IACtB,OAAO,CAAC,eAAe,CAAC;gBAFhB,aAAa,EAAE,aAAa,EAC5B,aAAa,CAAC,GAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,aAAA,EAC9C,eAAe,CAAC,EAAE,uBAAuB,YAAA;IAGnD,OAAO,CAAC,eAAe;IASvB,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,qBAAqB;IAe7B,OAAO,CAAC,mBAAmB;IAS3B,OAAO,CAAC,oBAAoB;IAoB5B,OAAO,CAAC,eAAe;IAgBvB,OAAO,CAAC,kBAAkB;IAoBpB,oBAAoB,CACxB,MAAM,EAAE,gBAAgB,EAAE,EAC1B,aAAa,EAAE,aAAa,EAC5B,cAAc,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,EAC5D,YAAY,CAAC,EAAE;QAAE,YAAY,EAAE,OAAO,CAAA;KAAE,GACvC,OAAO,CAAC,uBAAuB,CAAC;IA2E7B,sBAAsB,CAC1B,MAAM,EAAE,gBAAgB,EAAE,EAC1B,aAAa,EAAE,aAAa,EAC5B,cAAc,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,EAC5D,YAAY,CAAC,EAAE;QAAE,YAAY,EAAE,OAAO,CAAA;KAAE,GACvC,OAAO,CAAC,uBAAuB,CAAC;IAyEnC,gBAAgB,CAAC,MAAM,EAAE,uBAAuB,GAAG,MAAM;CAO1D"}