@studio-foundation/engine 0.3.0-beta.1 → 0.3.0-beta.5

package/dist/pipeline/contract-loader.js

@@ -0,0 +1,30 @@
+// Load output contracts from YAML files
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import * as yaml from 'js-yaml';
+export async function loadContract(name, contractsDir) {
+    const path = join(contractsDir, `${name}.contract.yaml`);
+    let content;
+    try {
+        content = await readFile(path, 'utf-8');
+    }
+    catch (err) {
+        throw new Error(`Failed to load contract '${name}' at ${path}: ${err.message}`);
+    }
+    return parseContractYaml(content, path);
+}
+export function parseContractYaml(yamlContent, sourcePath) {
+    const parsed = yaml.load(yamlContent);
+    const context = sourcePath ? ` (from ${sourcePath})` : '';
+    if (!parsed || typeof parsed !== 'object') {
+        throw new Error(`Invalid contract YAML: expected an object${context}`);
+    }
+    if (!parsed.name || typeof parsed.name !== 'string') {
+        throw new Error(`Contract missing required field 'name'${context}`);
+    }
+    if (parsed.version === undefined) {
+        throw new Error(`Contract missing required field 'version'${context}`);
+    }
+    return parsed;
+}
+//# sourceMappingURL=contract-loader.js.map

package/dist/pipeline/contract-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-loader.js","sourceRoot":"","sources":["../../src/pipeline/contract-loader.ts"],"names":[],"mappings":"AAAA,wCAAwC;AAExC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,KAAK,IAAI,MAAM,SAAS,CAAC;AAGhC,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,IAAY,EACZ,YAAoB;IAEpB,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,EAAE,GAAG,IAAI,gBAAgB,CAAC,CAAC;IAEzD,IAAI,OAAe,CAAC;IACpB,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,4BAA4B,IAAI,QAAQ,IAAI,KAAM,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;IAC7F,CAAC;IAED,OAAO,iBAAiB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,WAAmB,EAAE,UAAmB;IACxE,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,CAA4B,CAAC;IACjE,MAAM,OAAO,GAAG,UAAU,CAAC,CAAC,CAAC,UAAU,UAAU,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAE1D,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CAAC,4CAA4C,OAAO,EAAE,CAAC,CAAC;IACzE,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QACpD,MAAM,IAAI,KAAK,CAAC,yCAAyC,OAAO,EAAE,CAAC,CAAC;IACtE,CAAC;IAED,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,4CAA4C,OAAO,EAAE,CAAC,CAAC;IACzE,CAAC;IAED,OAAO,MAAmC,CAAC;AAC7C,CAAC"}

package/dist/pipeline/group-orchestrator.d.ts

@@ -0,0 +1,19 @@
+import type { StageGroup } from '@studio-foundation/contracts';
+import { type PipelineContext } from './context-propagation.js';
+import type { EngineEvents, PipelineEventEmitter } from '../events.js';
+import type { ToolRegistry, AnonymizationMiddleware } from '@studio-foundation/runner';
+import type { StageExecutor } from './stage-executor.js';
+import type { GroupResult, ProjectPaths } from './types.js';
+export interface GroupOrchestratorConfig {
+    events?: EngineEvents;
+    emitter: PipelineEventEmitter;
+    stageExecutor: StageExecutor;
+}
+export declare class GroupOrchestrator {
+    private config;
+    constructor(config: GroupOrchestratorConfig);
+    run(group: StageGroup, context: PipelineContext, stageOffset: number, totalStages: number, userInput: string | Record<string, unknown>, paths: ProjectPaths, toolRegistry: ToolRegistry | undefined, runMiddleware?: AnonymizationMiddleware | null, runId?: string, signal?: AbortSignal, skipSet?: Set<string>, originalRunId?: string): Promise<GroupResult>;
+    private runParallel;
+    private runSequential;
+}
+//# sourceMappingURL=group-orchestrator.d.ts.map

package/dist/pipeline/group-orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-orchestrator.d.ts","sourceRoot":"","sources":["../../src/pipeline/group-orchestrator.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAyB,MAAM,8BAA8B,CAAC;AACtF,OAAO,EAIL,KAAK,eAAe,EACrB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACvE,OAAO,KAAK,EAAE,YAAY,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACvF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAe,MAAM,YAAY,CAAC;AAEzE,MAAM,WAAW,uBAAuB;IACtC,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,OAAO,EAAE,oBAAoB,CAAC;IAC9B,aAAa,EAAE,aAAa,CAAC;CAC9B;AAED,qBAAa,iBAAiB;IAChB,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,uBAAuB;IAE7C,GAAG,CACP,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,eAAe,EACxB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC3C,KAAK,EAAE,YAAY,EACnB,YAAY,EAAE,YAAY,GAAG,SAAS,EACtC,aAAa,CAAC,EAAE,uBAAuB,GAAG,IAAI,EAC9C,KAAK,CAAC,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,WAAW,EACpB,OAAO,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,EACrB,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,WAAW,CAAC;YAOT,WAAW;YAoJX,aAAa;CAiS5B"}

package/dist/pipeline/group-orchestrator.js

@@ -0,0 +1,376 @@
+// GroupOrchestrator — extracted from PipelineEngine.runGroup/runGroupParallel/runGroupSequential()
+// Handles group-level orchestration: parallel and sequential iteration with feedback loops.
+import { randomUUID } from 'node:crypto';
+import { addStageOutput, addStageToolResults, setGroupFeedback, } from './context-propagation.js';
+export class GroupOrchestrator {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    async run(group, context, stageOffset, totalStages, userInput, paths, toolRegistry, runMiddleware, runId, signal, skipSet, originalRunId) {
+        if (group.mode === 'parallel') {
+            return this.runParallel(group, context, stageOffset, totalStages, userInput, paths, toolRegistry, runMiddleware, runId, signal);
+        }
+        return this.runSequential(group, context, stageOffset, totalStages, userInput, paths, toolRegistry, runMiddleware, runId, signal, skipSet, originalRunId);
+    }
+    async runParallel(group, context, stageOffset, totalStages, userInput, paths, toolRegistry, runMiddleware, runId, signal) {
+        let totalTokensDelta = 0;
+        let totalToolCallsDelta = 0;
+        this.config.events?.onGroupStart?.({
+            group_name: group.group,
+            max_iterations: group.max_iterations,
+            parallel: true,
+        });
+        this.config.emitter.emit({
+            type: 'group_start',
+            groupName: group.group,
+            maxIterations: group.max_iterations,
+        });
+        // Parallel groups run exactly one iteration
+        this.config.events?.onGroupIteration?.({
+            group_name: group.group,
+            iteration: 1,
+            max_iterations: group.max_iterations,
+        });
+        this.config.emitter.emit({
+            type: 'group_iteration',
+            groupName: group.group,
+            iteration: 1,
+            maxIterations: group.max_iterations,
+        });
+        if (signal?.aborted) {
+            this.config.events?.onGroupComplete?.({ group_name: group.group, iterations: 1, status: 'cancelled' });
+            this.config.emitter.emit({ type: 'group_complete', groupName: group.group, iterations: 1, status: 'cancelled' });
+            return { status: 'cancelled', stageRuns: [], stagesExecuted: group.stages.length, context, totalTokensDelta, totalToolCallsDelta };
+        }
+        // All parallel stages read the same pre-group context snapshot.
+        // previousStageName = the last stage before this group.
+        let previousStageName;
+        for (const [name] of context.stageOutputs) {
+            previousStageName = name;
+        }
+        // fail-fast: create a shared AbortController to cancel siblings on first failure
+        const groupAbort = (group.on_failure ?? 'fail-fast') === 'fail-fast'
+            ? new AbortController()
+            : null;
+        if (groupAbort && signal) {
+            signal.addEventListener('abort', () => groupAbort.abort(), { once: true });
+        }
+        const stageSignal = groupAbort?.signal ?? signal;
+        // Launch all stages concurrently
+        const settled = await Promise.allSettled(group.stages.map(async (stage, i) => {
+            const result = await this.config.stageExecutor.execute(stage, context, previousStageName, userInput, stageOffset + i, totalStages, paths, toolRegistry, runMiddleware, runId, stageSignal);
+            // fail-fast: abort remaining stages on first non-success
+            if (groupAbort && result.status !== 'success') {
+                groupAbort.abort();
+            }
+            return { stageName: stage.name, result };
+        }));
+        // Build result map keyed by stage name
+        const resultMap = new Map();
+        for (const s of settled) {
+            if (s.status === 'fulfilled') {
+                resultMap.set(s.value.stageName, s.value.result);
+            }
+        }
+        // Collect stage runs in definition order (deterministic output ordering)
+        const allStageRuns = [];
+        for (const stage of group.stages) {
+            const result = resultMap.get(stage.name);
+            if (result)
+                allStageRuns.push(result.stageRun);
+        }
+        // After building resultMap, accumulate token/tool call totals
+        for (const [, result] of resultMap) {
+            totalTokensDelta += result.tokensDelta ?? 0;
+            totalToolCallsDelta += result.toolCallsDelta ?? 0;
+        }
+        // Derive group status: cancelled > failed > success
+        // rejected treated as failed in parallel mode (no feedback loop)
+        let groupStatus = 'success';
+        for (const stage of group.stages) {
+            const result = resultMap.get(stage.name);
+            if (!result) {
+                groupStatus = 'failed';
+                continue;
+            }
+            if (result.status === 'cancelled' && groupStatus === 'success')
+                groupStatus = 'cancelled';
+            if (result.status === 'failed' || result.status === 'rejected')
+                groupStatus = 'failed';
+        }
+        // If every stage was skipped, the group is skipped (not success)
+        const allSkipped = group.stages.every((s) => resultMap.get(s.name)?.status === 'skipped');
+        if (allSkipped)
+            groupStatus = 'skipped';
+        // Merge successful outputs into context in definition order (regardless of group status)
+        // This preserves observability for collect-all partial failures
+        for (const stage of group.stages) {
+            const result = resultMap.get(stage.name);
+            if (!result || result.status !== 'success')
+                continue;
+            if (result.lastAgentOutput !== undefined) {
+                addStageOutput(context, stage.name, result.lastAgentOutput);
+            }
+            if (result.toolCalls?.length) {
+                addStageToolResults(context, stage.name, result.toolCalls);
+            }
+        }
+        this.config.events?.onGroupComplete?.({ group_name: group.group, iterations: 1, status: groupStatus });
+        this.config.emitter.emit({ type: 'group_complete', groupName: group.group, iterations: 1, status: groupStatus });
+        return {
+            status: groupStatus,
+            stageRuns: allStageRuns,
+            stagesExecuted: group.stages.length,
+            context,
+            totalTokensDelta,
+            totalToolCallsDelta,
+        };
+    }
+    async runSequential(group, context, stageOffset, totalStages, userInput, paths, toolRegistry, runMiddleware, runId, signal, skipSet, originalRunId) {
+        const allStageRuns = [];
+        let iteration = 0;
+        let totalTokensDelta = 0;
+        let totalToolCallsDelta = 0;
+        this.config.events?.onGroupStart?.({
+            group_name: group.group,
+            max_iterations: group.max_iterations,
+        });
+        this.config.emitter.emit({
+            type: 'group_start',
+            groupName: group.group,
+            maxIterations: group.max_iterations,
+        });
+        while (iteration < group.max_iterations) {
+            // Check cancellation before group iteration
+            if (signal?.aborted) {
+                this.config.events?.onGroupComplete?.({
+                    group_name: group.group,
+                    iterations: iteration,
+                    status: 'cancelled',
+                });
+                this.config.emitter.emit({
+                    type: 'group_complete',
+                    groupName: group.group,
+                    iterations: iteration,
+                    status: 'cancelled',
+                });
+                return {
+                    status: 'cancelled',
+                    stageRuns: allStageRuns,
+                    stagesExecuted: group.stages.length,
+                    context,
+                    totalTokensDelta,
+                    totalToolCallsDelta,
+                };
+            }
+            iteration++;
+            this.config.events?.onGroupIteration?.({
+                group_name: group.group,
+                iteration,
+                max_iterations: group.max_iterations,
+            });
+            this.config.emitter.emit({
+                type: 'group_iteration',
+                groupName: group.group,
+                iteration,
+                maxIterations: group.max_iterations,
+            });
+            let groupSucceeded = true;
+            let anyStageExecuted = false;
+            let previousStageName;
+            // Find the last stage name before this group in the pipeline context
+            for (const [name] of context.stageOutputs) {
+                previousStageName = name;
+            }
+            for (let i = 0; i < group.stages.length; i++) {
+                if (signal?.aborted)
+                    break;
+                const stage = group.stages[i];
+                const stageNumber = stageOffset + i;
+                // On iteration 1 only, skip stages before resumeFromStage
+                if (iteration === 1 && skipSet?.has(stage.name)) {
+                    const skippedReason = originalRunId
+                        ? `resumed from run ${originalRunId}`
+                        : 'resumed from prior run';
+                    const skippedRun = {
+                        id: randomUUID(),
+                        stage_name: stage.name,
+                        status: 'skipped',
+                        started_at: new Date().toISOString(),
+                        completed_at: new Date().toISOString(),
+                        tasks: [],
+                        skipped_reason: skippedReason,
+                    };
+                    this.config.events?.onStageComplete?.({
+                        stage_name: stage.name,
+                        stage_index: stageNumber,
+                        total_stages: totalStages,
+                        status: 'skipped',
+                        attempts: 0,
+                        duration_ms: 0,
+                        skipped_reason: skippedReason,
+                    });
+                    allStageRuns.push(skippedRun);
+                    previousStageName = stage.name;
+                    continue;
+                }
+                const result = await this.config.stageExecutor.execute(stage, context, previousStageName, userInput, stageNumber, totalStages, paths, toolRegistry, runMiddleware, runId, signal);
+                allStageRuns.push(result.stageRun);
+                totalTokensDelta += result.tokensDelta ?? 0;
+                totalToolCallsDelta += result.toolCallsDelta ?? 0;
+                if (result.status !== 'skipped')
+                    anyStageExecuted = true;
+                // Cancelled → stop group
+                if (result.status === 'cancelled') {
+                    this.config.events?.onGroupComplete?.({
+                        group_name: group.group,
+                        iterations: iteration,
+                        status: 'cancelled',
+                    });
+                    this.config.emitter.emit({
+                        type: 'group_complete',
+                        groupName: group.group,
+                        iterations: iteration,
+                        status: 'cancelled',
+                    });
+                    return {
+                        status: 'cancelled',
+                        stageRuns: allStageRuns,
+                        stagesExecuted: group.stages.length,
+                        context,
+                        totalTokensDelta,
+                        totalToolCallsDelta,
+                    };
+                }
+                // Technical failure → stop everything
+                if (result.status === 'failed') {
+                    this.config.events?.onGroupComplete?.({
+                        group_name: group.group,
+                        iterations: iteration,
+                        status: 'failed',
+                    });
+                    this.config.emitter.emit({
+                        type: 'group_complete',
+                        groupName: group.group,
+                        iterations: iteration,
+                        status: 'failed',
+                    });
+                    return {
+                        status: 'failed',
+                        stageRuns: allStageRuns,
+                        stagesExecuted: group.stages.length,
+                        context,
+                        totalTokensDelta,
+                        totalToolCallsDelta,
+                    };
+                }
+                // Propagate output to context (will be cleared if we loop)
+                if (result.lastAgentOutput !== undefined) {
+                    addStageOutput(context, stage.name, result.lastAgentOutput);
+                }
+                if (result.toolCalls && result.toolCalls.length > 0) {
+                    addStageToolResults(context, stage.name, result.toolCalls);
+                }
+                previousStageName = stage.name;
+                // Last stage rejected → feedback loop
+                const isLastStage = i === group.stages.length - 1;
+                if (result.status === 'rejected' && isLastStage) {
+                    groupSucceeded = false;
+                    if (iteration < group.max_iterations) {
+                        // Clear group stage outputs and tool results for next iteration
+                        for (const gs of group.stages) {
+                            context.stageOutputs.delete(gs.name);
+                            context.stageToolResults.delete(gs.name);
+                        }
+                        // Set feedback for next iteration
+                        setGroupFeedback(context, {
+                            iteration,
+                            max_iterations: group.max_iterations,
+                            rejection_reason: result.postValidation?.rejection_reason || 'Rejected',
+                            rejection_details: result.postValidation?.rejection_details,
+                        });
+                        this.config.events?.onGroupFeedback?.({
+                            group_name: group.group,
+                            iteration,
+                            rejection_reason: result.postValidation?.rejection_reason || 'Rejected',
+                            rejection_details: result.postValidation?.rejection_details || [],
+                        });
+                        this.config.emitter.emit({
+                            type: 'group_feedback',
+                            groupName: group.group,
+                            iteration,
+                            rejectionReason: result.postValidation?.rejection_reason || 'Rejected',
+                        });
+                    }
+                    break; // Exit inner stage loop, retry group
+                }
+                // Non-gate stage rejected → stop
+                if (result.status === 'rejected') {
+                    this.config.events?.onGroupComplete?.({
+                        group_name: group.group,
+                        iterations: iteration,
+                        status: 'rejected',
+                    });
+                    this.config.emitter.emit({
+                        type: 'group_complete',
+                        groupName: group.group,
+                        iterations: iteration,
+                        status: 'rejected',
+                    });
+                    return {
+                        status: 'rejected',
+                        stageRuns: allStageRuns,
+                        stagesExecuted: group.stages.length,
+                        context,
+                        totalTokensDelta,
+                        totalToolCallsDelta,
+                    };
+                }
+            }
+            if (groupSucceeded) {
+                const groupStatus = anyStageExecuted ? 'success' : 'skipped';
+                this.config.events?.onGroupComplete?.({
+                    group_name: group.group,
+                    iterations: iteration,
+                    status: groupStatus,
+                });
+                this.config.emitter.emit({
+                    type: 'group_complete',
+                    groupName: group.group,
+                    iterations: iteration,
+                    status: groupStatus,
+                });
+                return {
+                    status: groupStatus,
+                    stageRuns: allStageRuns,
+                    stagesExecuted: group.stages.length,
+                    context,
+                    totalTokensDelta,
+                    totalToolCallsDelta,
+                };
+            }
+        }
+        // Max iterations exhausted
+        this.config.events?.onGroupComplete?.({
+            group_name: group.group,
+            iterations: iteration,
+            status: 'rejected',
+        });
+        this.config.emitter.emit({
+            type: 'group_complete',
+            groupName: group.group,
+            iterations: iteration,
+            status: 'rejected',
+        });
+        return {
+            status: 'rejected',
+            stageRuns: allStageRuns,
+            stagesExecuted: group.stages.length,
+            context,
+            totalTokensDelta,
+            totalToolCallsDelta,
+        };
+    }
+}
+//# sourceMappingURL=group-orchestrator.js.map

package/dist/pipeline/group-orchestrator.js.map

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

package/dist/pipeline/hook-executor.d.ts

@@ -0,0 +1,28 @@
+import type { StageHookDef, ToolHookDef } from '@studio-foundation/contracts';
+export interface HookResult {
+    success: boolean;
+    stdout: string;
+    stderr: string;
+}
+/**
+ * Renders {{tool.argName}} and {{output.field}} placeholders.
+ * Arrays in outputContext are space-joined for CLI argument passing.
+ * Unknown keys → empty string.
+ *
+ * Note: values are substituted verbatim into the command string.
+ * Hook commands are authored by pipeline owners (trusted), not end users.
+ * Do not use with untrusted input sources.
+ */
+export declare function renderHookCommand(command: string, toolArgs: Record<string, unknown>, outputContext?: Record<string, unknown>): string;
+/**
+ * Run a stage-level hook command (on_stage_start, on_stage_complete).
+ * outputContext provides {{output.<field>}} substitution values.
+ * on_stage_start hooks omit outputContext (no output available before the stage runs).
+ */
+export declare function runStageHook(hook: StageHookDef, cwd: string, outputContext?: Record<string, unknown>): Promise<HookResult>;
+/**
+ * Run a tool-level hook command (pre_tool_use, post_tool_use).
+ * The command may reference tool arguments via {{tool.argName}}.
+ */
+export declare function runToolHook(hook: ToolHookDef, toolArgs: Record<string, unknown>, cwd: string): Promise<HookResult>;
+//# sourceMappingURL=hook-executor.d.ts.map

package/dist/pipeline/hook-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-executor.d.ts","sourceRoot":"","sources":["../../src/pipeline/hook-executor.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAK9E,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,aAAa,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAC1C,MAAM,CAYR;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,YAAY,EAClB,GAAG,EAAE,MAAM,EACX,aAAa,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAC1C,OAAO,CAAC,UAAU,CAAC,CAGrB;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,WAAW,EACjB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,UAAU,CAAC,CAGrB"}

package/dist/pipeline/hook-executor.js

@@ -0,0 +1,63 @@
+// Hook executor — runs shell commands at lifecycle points within a stage
+// Mirrors startup-executor.ts but with on_failure semantics and tool arg templates
+import { exec } from 'node:child_process';
+import { promisify } from 'node:util';
+const execAsync = promisify(exec);
+const HOOK_TIMEOUT_MS = 30_000;
+/**
+ * Renders {{tool.argName}} and {{output.field}} placeholders.
+ * Arrays in outputContext are space-joined for CLI argument passing.
+ * Unknown keys → empty string.
+ *
+ * Note: values are substituted verbatim into the command string.
+ * Hook commands are authored by pipeline owners (trusted), not end users.
+ * Do not use with untrusted input sources.
+ */
+export function renderHookCommand(command, toolArgs, outputContext = {}) {
+    return command
+        .replace(/\{\{tool\.(\w+)\}\}/g, (_, key) => (toolArgs[key] !== undefined ? String(toolArgs[key]) : ''))
+        .replace(/\{\{output\.(\w+)\}\}/g, (_, key) => {
+        const val = outputContext[key];
+        if (val === undefined)
+            return '';
+        if (Array.isArray(val))
+            return val.join(' ');
+        return String(val);
+    });
+}
+/**
+ * Run a stage-level hook command (on_stage_start, on_stage_complete).
+ * outputContext provides {{output.<field>}} substitution values.
+ * on_stage_start hooks omit outputContext (no output available before the stage runs).
+ */
+export async function runStageHook(hook, cwd, outputContext = {}) {
+    const command = renderHookCommand(hook.command, {}, outputContext);
+    return execHook(command, cwd);
+}
+/**
+ * Run a tool-level hook command (pre_tool_use, post_tool_use).
+ * The command may reference tool arguments via {{tool.argName}}.
+ */
+export async function runToolHook(hook, toolArgs, cwd) {
+    const command = renderHookCommand(hook.command, toolArgs);
+    return execHook(command, cwd);
+}
+async function execHook(command, cwd) {
+    try {
+        const { stdout, stderr } = await execAsync(command, {
+            cwd,
+            timeout: HOOK_TIMEOUT_MS,
+            maxBuffer: 1024 * 1024 * 10,
+        });
+        return { success: true, stdout: stdout.trim(), stderr: stderr.trim() };
+    }
+    catch (err) {
+        const e = err;
+        return {
+            success: false,
+            stdout: e.stdout?.trim() ?? '',
+            stderr: e.stderr?.trim() ?? String(err),
+        };
+    }
+}
+//# sourceMappingURL=hook-executor.js.map

package/dist/pipeline/hook-executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-executor.js","sourceRoot":"","sources":["../../src/pipeline/hook-executor.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,mFAAmF;AAEnF,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAGtC,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;AAClC,MAAM,eAAe,GAAG,MAAM,CAAC;AAQ/B;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAAe,EACf,QAAiC,EACjC,gBAAyC,EAAE;IAE3C,OAAO,OAAO;SACX,OAAO,CACN,sBAAsB,EACtB,CAAC,CAAC,EAAE,GAAW,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAC/E;SACA,OAAO,CAAC,wBAAwB,EAAE,CAAC,CAAC,EAAE,GAAW,EAAE,EAAE;QACpD,MAAM,GAAG,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,GAAG,KAAK,SAAS;YAAE,OAAO,EAAE,CAAC;QACjC,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;YAAE,OAAO,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC7C,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC,CAAC,CAAC;AACP,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,IAAkB,EAClB,GAAW,EACX,gBAAyC,EAAE;IAE3C,MAAM,OAAO,GAAG,iBAAiB,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,EAAE,aAAa,CAAC,CAAC;IACnE,OAAO,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;AAChC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,IAAiB,EACjB,QAAiC,EACjC,GAAW;IAEX,MAAM,OAAO,GAAG,iBAAiB,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC1D,OAAO,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;AAChC,CAAC;AAED,KAAK,UAAU,QAAQ,CAAC,OAAe,EAAE,GAAW;IAClD,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,OAAO,EAAE;YAClD,GAAG;YACH,OAAO,EAAE,eAAe;YACxB,SAAS,EAAE,IAAI,GAAG,IAAI,GAAG,EAAE;SAC5B,CAAC,CAAC;QACH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;IACzE,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,MAAM,CAAC,GAAG,GAA2C,CAAC;QACtD,OAAO;YACL,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE;YAC9B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,MAAM,CAAC,GAAG,CAAC;SACxC,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/pipeline/hook-executor.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=hook-executor.test.d.ts.map

package/dist/pipeline/hook-executor.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-executor.test.d.ts","sourceRoot":"","sources":["../../src/pipeline/hook-executor.test.ts"],"names":[],"mappings":""}

package/dist/pipeline/hook-executor.test.js

@@ -0,0 +1,71 @@
+import { describe, it, expect } from 'vitest';
+import { renderHookCommand, runStageHook, runToolHook } from './hook-executor.js';
+describe('renderHookCommand', () => {
+    it('substitutes {{tool.argName}} with tool argument value', () => {
+        const result = renderHookCommand('npx prettier --write {{tool.path}}', { path: '/tmp/foo.ts' });
+        expect(result).toBe('npx prettier --write /tmp/foo.ts');
+    });
+    it('returns empty string for missing tool argument', () => {
+        const result = renderHookCommand('do something {{tool.missing}}', {});
+        expect(result).toBe('do something ');
+    });
+    it('substitutes multiple occurrences of the same placeholder', () => {
+        const result = renderHookCommand('cp {{tool.src}} {{tool.dst}}', { src: 'a.ts', dst: 'b.ts' });
+        expect(result).toBe('cp a.ts b.ts');
+    });
+    it('leaves non-tool placeholders unchanged', () => {
+        const result = renderHookCommand('echo {{other}}', { other: 'x' });
+        // {{other}} is not a {{tool.*}} pattern — left as-is
+        expect(result).toBe('echo {{other}}');
+    });
+    it('substitutes {{output.field}} with value from outputContext', () => {
+        const result = renderHookCommand('npx eslint {{output.files_changed}}', {}, { files_changed: 'src/foo.ts' });
+        expect(result).toBe('npx eslint src/foo.ts');
+    });
+    it('space-joins array values from outputContext', () => {
+        const result = renderHookCommand('npx eslint {{output.files_changed}}', {}, { files_changed: ['src/foo.ts', 'src/bar.ts'] });
+        expect(result).toBe('npx eslint src/foo.ts src/bar.ts');
+    });
+    it('returns empty string for missing output field', () => {
+        const result = renderHookCommand('npx eslint {{output.missing}}', {}, {});
+        expect(result).toBe('npx eslint ');
+    });
+    it('handles mixed {{tool.*}} and {{output.*}} in same command', () => {
+        const result = renderHookCommand('run {{tool.script}} on {{output.files_changed}}', { script: 'check.sh' }, { files_changed: 'src/foo.ts' });
+        expect(result).toBe('run check.sh on src/foo.ts');
+    });
+    it('leaves {{tool.*}} unchanged when outputContext not provided', () => {
+        const result = renderHookCommand('echo {{tool.path}}', { path: 'x.ts' });
+        expect(result).toBe('echo x.ts');
+    });
+});
+describe('runStageHook', () => {
+    it('returns success with stdout when command exits 0', async () => {
+        const result = await runStageHook({ command: 'echo hello', on_failure: 'warn' }, '/tmp');
+        expect(result.success).toBe(true);
+        expect(result.stdout).toBe('hello');
+        expect(result.stderr).toBe('');
+    });
+    it('returns failure with stderr when command exits non-zero', async () => {
+        const result = await runStageHook({ command: 'sh -c "echo boom >&2; exit 1"', on_failure: 'warn' }, '/tmp');
+        expect(result.success).toBe(false);
+        expect(result.stderr).toContain('boom');
+    });
+    it('resolves {{output.files_changed}} from outputContext in command', async () => {
+        const result = await runStageHook({ command: 'echo {{output.files_changed}}', on_failure: 'warn' }, '/tmp', { files_changed: ['src/foo.ts', 'src/bar.ts'] });
+        expect(result.success).toBe(true);
+        expect(result.stdout).toBe('src/foo.ts src/bar.ts');
+    });
+});
+describe('runToolHook', () => {
+    it('renders template and executes command', async () => {
+        const result = await runToolHook({ matcher: 'repo_manager-write_file', command: 'echo {{tool.path}}', on_failure: 'warn' }, { path: '/tmp/test.ts' }, '/tmp');
+        expect(result.success).toBe(true);
+        expect(result.stdout).toBe('/tmp/test.ts');
+    });
+    it('returns failure when rendered command exits non-zero', async () => {
+        const result = await runToolHook({ matcher: 'any-tool', command: 'exit 1', on_failure: 'warn' }, {}, '/tmp');
+        expect(result.success).toBe(false);
+    });
+});
+//# sourceMappingURL=hook-executor.test.js.map