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

package/dist/state/run-store.test.js

@@ -0,0 +1,130 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { SQLiteRunStore, PgRunStore } from './run-store.js';
+function makeRun(overrides) {
+    return {
+        id: 'run-1',
+        pipeline_name: 'test-pipeline',
+        status: 'running',
+        started_at: '2026-01-01T00:00:00.000Z',
+        stages: [],
+        ...overrides,
+    };
+}
+describe('SQLiteRunStore', () => {
+    describe('saveLogPath / getLogPath', () => {
+        it('returns null when no log path has been set', () => {
+            const store = new SQLiteRunStore(':memory:');
+            store.savePipelineRun(makeRun());
+            expect(store.getLogPath('run-1')).toBeNull();
+        });
+        it('returns the log path after saveLogPath', () => {
+            const store = new SQLiteRunStore(':memory:');
+            store.savePipelineRun(makeRun());
+            store.saveLogPath('run-1', '/tmp/run-1.jsonl');
+            expect(store.getLogPath('run-1')).toBe('/tmp/run-1.jsonl');
+        });
+        it('preserves log_path when savePipelineRun is called again after saveLogPath', () => {
+            // Regression for STU-150: savePipelineRun used INSERT OR REPLACE which clobbers log_path
+            const store = new SQLiteRunStore(':memory:');
+            store.savePipelineRun(makeRun());
+            store.saveLogPath('run-1', '/tmp/run-1.jsonl');
+            // Simulate engine completing the run (this triggered the bug)
+            store.savePipelineRun(makeRun({ status: 'success', completed_at: '2026-01-01T00:01:00.000Z' }));
+            expect(store.getLogPath('run-1')).toBe('/tmp/run-1.jsonl');
+        });
+        it('returns null for unknown run id', () => {
+            const store = new SQLiteRunStore(':memory:');
+            expect(store.getLogPath('does-not-exist')).toBeNull();
+        });
+    });
+    describe('parent_run_id', () => {
+        it('persists and retrieves parent_run_id', () => {
+            const run = {
+                id: 'child-123',
+                pipeline_name: 'child-pipe',
+                status: 'success',
+                started_at: new Date().toISOString(),
+                stages: [],
+                parent_run_id: 'parent-456',
+            };
+            const store = new SQLiteRunStore(':memory:');
+            store.savePipelineRun(run);
+            const retrieved = store.getPipelineRun('child-123');
+            expect(retrieved?.parent_run_id).toBe('parent-456');
+        });
+    });
+});
+const TEST_PG_URL = process.env.TEST_DATABASE_URL;
+describe.skipIf(!TEST_PG_URL)('PgRunStore', () => {
+    let store;
+    beforeEach(async () => {
+        store = new PgRunStore(TEST_PG_URL);
+        await store.dangerouslyTruncateForTests();
+    });
+    afterEach(async () => {
+        await store.close();
+    });
+    it('saves and retrieves a pipeline run', async () => {
+        const run = makePgRun('pg-run-1');
+        await store.savePipelineRun(run);
+        const found = await store.getPipelineRun('pg-run-1');
+        expect(found).toMatchObject({ id: 'pg-run-1', status: 'success' });
+    });
+    it('returns null for unknown id', async () => {
+        const found = await store.getPipelineRun('doesnt-exist');
+        expect(found).toBeNull();
+    });
+    it('updates an existing run (upsert)', async () => {
+        const run = makePgRun('pg-run-2');
+        await store.savePipelineRun(run);
+        await store.savePipelineRun({ ...run, status: 'failed' });
+        const found = await store.getPipelineRun('pg-run-2');
+        expect(found?.status).toBe('failed');
+    });
+    it('lists runs with status filter', async () => {
+        await store.savePipelineRun(makePgRun('pg-1', 'success'));
+        await store.savePipelineRun(makePgRun('pg-2', 'failed'));
+        const successes = await store.listPipelineRuns({ status: 'success' });
+        expect(successes).toHaveLength(1);
+        expect(successes[0].id).toBe('pg-1');
+    });
+    it('lists runs with limit', async () => {
+        for (let i = 0; i < 5; i++) {
+            await store.savePipelineRun(makePgRun(`pg-limit-${i}`));
+        }
+        const runs = await store.listPipelineRuns({ limit: 3 });
+        expect(runs).toHaveLength(3);
+    });
+    it('getLatestRun returns most recent', async () => {
+        await store.savePipelineRun(makePgRun('pg-old', 'success', '2024-01-01T00:00:00Z'));
+        await store.savePipelineRun(makePgRun('pg-new', 'success', '2024-06-01T00:00:00Z'));
+        const latest = await store.getLatestRun();
+        expect(latest?.id).toBe('pg-new');
+    });
+    it('getLatestRun filters by pipeline name', async () => {
+        await store.savePipelineRun(makePgRun('pg-a', 'success', undefined, 'pipeline-a'));
+        await store.savePipelineRun(makePgRun('pg-b', 'success', undefined, 'pipeline-b'));
+        const latest = await store.getLatestRun('pipeline-a');
+        expect(latest?.id).toBe('pg-a');
+    });
+    it('saves and retrieves log path', async () => {
+        await store.savePipelineRun(makePgRun('pg-log-1'));
+        await store.saveLogPath('pg-log-1', '/tmp/test.jsonl');
+        const path = await store.getLogPath('pg-log-1');
+        expect(path).toBe('/tmp/test.jsonl');
+    });
+    it('returns null log path for unknown run', async () => {
+        const path = await store.getLogPath('no-such-run');
+        expect(path).toBeNull();
+    });
+});
+function makePgRun(id, status = 'success', startedAt = new Date().toISOString(), pipelineName = 'test-pipeline') {
+    return {
+        id,
+        pipeline_name: pipelineName,
+        status,
+        started_at: startedAt,
+        stages: [],
+    };
+}
+//# sourceMappingURL=run-store.test.js.map

package/dist/state/run-store.test.js.map

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

package/dist/state/state-machine.d.ts

@@ -0,0 +1,6 @@
+export type StageLifecycleState = 'pending' | 'running' | 'success' | 'failed' | 'skipped' | 'rejected' | 'cancelled';
+type StageEvent = 'start' | 'succeed' | 'fail' | 'skip' | 'reject' | 'cancel';
+export declare function isValidTransition(from: StageLifecycleState, to: StageLifecycleState): boolean;
+export declare function transition(current: StageLifecycleState, event: StageEvent): StageLifecycleState;
+export {};
+//# sourceMappingURL=state-machine.d.ts.map

package/dist/state/state-machine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-machine.d.ts","sourceRoot":"","sources":["../../src/state/state-machine.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,WAAW,CAAC;AAEtH,KAAK,UAAU,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAW9E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,mBAAmB,EAAE,EAAE,EAAE,mBAAmB,GAAG,OAAO,CAO7F;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,mBAAmB,EAAE,KAAK,EAAE,UAAU,GAAG,mBAAmB,CAS/F"}

package/dist/state/state-machine.js

@@ -0,0 +1,27 @@
+// Stage lifecycle state machine
+// Keeps it simple: linear transitions, no DAG
+const VALID_TRANSITIONS = {
+    'pending:start': 'running',
+    'running:succeed': 'success',
+    'running:fail': 'failed',
+    'pending:skip': 'skipped',
+    'running:reject': 'rejected',
+    'running:cancel': 'cancelled',
+};
+export function isValidTransition(from, to) {
+    for (const [key, target] of Object.entries(VALID_TRANSITIONS)) {
+        if (key.startsWith(`${from}:`) && target === to) {
+            return true;
+        }
+    }
+    return false;
+}
+export function transition(current, event) {
+    const key = `${current}:${event}`;
+    const next = VALID_TRANSITIONS[key];
+    if (!next) {
+        throw new Error(`Invalid state transition: ${current} + ${event}`);
+    }
+    return next;
+}
+//# sourceMappingURL=state-machine.js.map

package/dist/state/state-machine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-machine.js","sourceRoot":"","sources":["../../src/state/state-machine.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,8CAA8C;AAM9C,MAAM,iBAAiB,GAAwC;IAC7D,eAAe,EAAE,SAAS;IAC1B,iBAAiB,EAAE,SAAS;IAC5B,cAAc,EAAE,QAAQ;IACxB,cAAc,EAAE,SAAS;IACzB,gBAAgB,EAAE,UAAU;IAC5B,gBAAgB,EAAE,WAAW;CAC9B,CAAC;AAEF,MAAM,UAAU,iBAAiB,CAAC,IAAyB,EAAE,EAAuB;IAClF,KAAK,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,iBAAiB,CAAC,EAAE,CAAC;QAC9D,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,MAAM,KAAK,EAAE,EAAE,CAAC;YAChD,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,OAA4B,EAAE,KAAiB;IACxE,MAAM,GAAG,GAAG,GAAG,OAAO,IAAI,KAAK,EAAE,CAAC;IAClC,MAAM,IAAI,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;IAEpC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,6BAA6B,OAAO,MAAM,KAAK,EAAE,CAAC,CAAC;IACrE,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/state/status-derivation.d.ts

@@ -0,0 +1,12 @@
+import type { RalphResult } from '@studio-foundation/ralph';
+import type { StageStatus } from '@studio-foundation/contracts';
+/**
+ * Derives stage status from ralph result.
+ *
+ * Rules (simple and exhaustive):
+ * - ralph 'success' → stage 'success'
+ * - ralph 'exhausted' → stage 'failed'
+ * - anything else → error (should never happen)
+ */
+export declare function deriveStageStatus(ralphResult: RalphResult<unknown>): StageStatus;
+//# sourceMappingURL=status-derivation.d.ts.map

package/dist/state/status-derivation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-derivation.d.ts","sourceRoot":"","sources":["../../src/state/status-derivation.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAEhE;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,WAAW,CAehF"}

package/dist/state/status-derivation.js

@@ -0,0 +1,30 @@
+// Derive stage status from ralph result
+// THIS IS THE CRITICAL FUNCTION
+//
+// In v7, each stage = 1 ralph call = 1 task.
+// This function maps ralph's result directly to stage status.
+//
+// This was the #1 bug in v6: stage status didn't match task status.
+// v7 fix: SIMPLE, DETERMINISTIC, NO MAGIC.
+/**
+ * Derives stage status from ralph result.
+ *
+ * Rules (simple and exhaustive):
+ * - ralph 'success' → stage 'success'
+ * - ralph 'exhausted' → stage 'failed'
+ * - anything else → error (should never happen)
+ */
+export function deriveStageStatus(ralphResult) {
+    if (ralphResult.status === 'success') {
+        return 'success';
+    }
+    if (ralphResult.status === 'exhausted') {
+        return 'failed';
+    }
+    if (ralphResult.status === 'cancelled') {
+        return 'cancelled';
+    }
+    // Should never reach here if RalphResult types are exhaustive
+    throw new Error(`Unknown ralph status: ${JSON.stringify(ralphResult)}`);
+}
+//# sourceMappingURL=status-derivation.js.map

package/dist/state/status-derivation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-derivation.js","sourceRoot":"","sources":["../../src/state/status-derivation.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,gCAAgC;AAChC,EAAE;AACF,6CAA6C;AAC7C,8DAA8D;AAC9D,EAAE;AACF,oEAAoE;AACpE,2CAA2C;AAK3C;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAAC,WAAiC;IACjE,IAAI,WAAW,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QACrC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,WAAW,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;QACvC,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,IAAI,WAAW,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;QACvC,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,8DAA8D;IAC9D,MAAM,IAAI,KAAK,CAAC,yBAAyB,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;AAC1E,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@studio-foundation/engine",
-  "version": "0.3.0-beta.1",
+  "version": "0.3.0-beta.5",
   "description": "Pipeline orchestration engine for Studio v7",
   "type": "module",
   "main": "./dist/index.js",
@@ -11,6 +11,9 @@
       "types": "./dist/index.d.ts"
     }
   },
+  "files": [
+    "dist"
+  ],
   "keywords": [
     "studio",
     "engine",
@@ -23,9 +26,9 @@
     "better-sqlite3": "^9.0.0",
     "js-yaml": "^4.1.0",
     "pg": "^8.19.0",
-    "@studio-foundation/contracts": "0.3.0-beta.1",
-    "@studio-foundation/ralph": "0.3.0-beta.1",
-    "@studio-foundation/runner": "0.3.0-beta.1"
+    "@studio-foundation/contracts": "0.3.0-beta.5",
+    "@studio-foundation/ralph": "0.3.0-beta.5",
+    "@studio-foundation/runner": "0.3.0-beta.5"
   },
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.8",

package/ARCHITECTURE.md

@@ -1,57 +0,0 @@
-# @studio-foundation/engine
-
-Orchestrateur de pipelines. Le cerveau de Studio.
-
-## Concept
-
-Charge une pipeline YAML → exécute les stages en séquence (ou en groups avec feedback loops) → pour chaque stage : hooks + `ralph(runAgent, validator)` → persiste les runs → émet des events.
-
-## Règles
-
-- **Domain-agnostic.** Pas de référence à "code", "file", "git", "QA" dans le source. `StageKind = string`.
-- `deriveStageStatus()` dans `state/status-derivation.ts` est LA fonction critique — mapping déterministe ralph result → stage status
-- La DB est configurable : `SQLiteRunStore` | `PgRunStore` | `InMemoryRunStore` (union `AnyRunStore`)
-- Le engine ne construit pas de prompts — c'est runner
-- Le engine ne sait pas ce qu'est `repo_manager-write_file` — c'est runner
-- Dépend de `@studio-foundation/contracts`, `@studio-foundation/ralph`, `@studio-foundation/runner`, `@studio-foundation/anonymizer`
-
-## Fichiers clés
-
-- `engine.ts` — `PipelineEngine` (classe principale), `EngineConfig`, `RunInput`
-- `events.ts` — `EngineEvents`, `PipelineEventEmitter`
-- `state/status-derivation.ts` — `deriveStageStatus()` ← CRITIQUE
-- `state/run-store.ts` — `AnyRunStore`, `InMemoryRunStore`
-- `pipeline/loader.ts` — charge YAML → `PipelineDefinition`
-- `pipeline/agent-loader.ts` — charge agent YAML + injecte skills
-- `pipeline/contract-loader.ts` — charge contract YAML
-- `pipeline/context-propagation.ts` — `createInitialContext`, `addStageOutput`, `getContextForStage`
-- `pipeline/context-pack-loader.ts` — charge les context packs
-- `pipeline/hook-executor.ts` — `runStageHook()`, `runToolHook()` (4 points de hook)
-- `pipeline/startup-executor.ts` — `executeStartupCommands()` pour `on_pipeline_start`
-- `pipeline/post-validator.ts` — `postValidate()` (rejection detection)
-- `pipeline/skill-loader.ts` — charge les `.skill.md` files
-- `db/client.ts` — SQLite client (pour WebhookStore, IntegrationStore côté api)
-- `spawners/direct-engine-spawner.ts` — `DirectEngineSpawner` implémente `RunSpawner`
-
-## Groups (feedback loops)
-
-Un group contient plusieurs stages qui itèrent ensemble. Si le dernier stage rejette (via `post_validation.rejection_detection`), le group redémarre depuis le début avec le feedback accumulé. `max_iterations` cap.
-
-## Hooks lifecycle
-
-4 points déterministes : `on_stage_start`, `on_stage_complete`, `pre_tool_use`, `post_tool_use`.
-`on_failure: warn | reject | fail`. Les hooks `pre_tool_use` avec reject bloquent le tool call.
-
-## État machine
-
-```
-pending → running → success
-                  → failed     (ralph exhausted, ou hook on_failure: fail)
-                  → rejected   (post_validation, ou hook on_failure: reject)
-                  → skipped
-                  → cancelled  (AbortSignal)
-```
-
-## Dépendances
-
-`@studio-foundation/contracts`, `@studio-foundation/ralph`, `@studio-foundation/runner`, `@studio-foundation/anonymizer`

package/src/__tests__/__fixtures__/script-stage/contracts/book-context.contract.yaml

@@ -1,4 +0,0 @@
-name: book-context
-version: 1
-schema:
-  required_fields: []

package/src/__tests__/engine.conditions-group.test.ts

@@ -1,244 +0,0 @@
-import { describe, it, expect, vi, beforeEach } from 'vitest';
-import { resolve } from 'node:path';
-import { PipelineEngine } from '../engine.js';
-import type { PipelineDefinition } from '@studio-foundation/contracts';
-
-vi.mock('@studio-foundation/runner', async (importOriginal) => {
-  const actual = await importOriginal<typeof import('@studio-foundation/runner')>();
-  return {
-    ...actual,
-    runScript: vi.fn(),
-  };
-});
-
-import { runScript } from '@studio-foundation/runner';
-
-const FIXTURES_DIR = resolve(__dirname, '__fixtures__/script-stage');
-
-function makeEngine() {
-  return new PipelineEngine({
-    configsDir: FIXTURES_DIR,
-    providerRegistry: {} as any,
-  });
-}
-
-describe('engine — conditions inside sequential groups', () => {
-  beforeEach(() => {
-    vi.clearAllMocks();
-  });
-
-  it('skips a conditional stage inside a sequential group', async () => {
-    vi.mocked(runScript).mockResolvedValue({
-      output: { done: true },
-      tool_calls: [],
-      tool_calls_count: 0,
-      duration_ms: 10,
-    });
-
-    const pipeline: PipelineDefinition = {
-      name: 'test-group-conditions',
-      description: 'test',
-      version: 1,
-      stages: [
-        {
-          group: 'processing',
-          max_iterations: 1,
-          stages: [
-            {
-              name: 'always-runs',
-              executor: 'script',
-              script: 'scripts/run.py',
-              runtime: 'shell',
-            },
-            {
-              name: 'conditional-in-group',
-              executor: 'script',
-              script: 'scripts/optional.py',
-              runtime: 'shell',
-              condition: 'input.optional >= 1',
-            },
-          ],
-        },
-      ],
-    };
-
-    const engine = makeEngine();
-    const result = await engine.run({
-      pipelineDef: pipeline,
-      input: { optional: 0 },
-    });
-
-    expect(result.status).toBe('success');
-    expect(result.stages[0]?.status).toBe('success');
-    expect(result.stages[1]?.status).toBe('skipped');
-    expect(vi.mocked(runScript)).toHaveBeenCalledTimes(1);
-  });
-
-  it('marks group as skipped when all stages in sequential group are skipped', async () => {
-    vi.mocked(runScript).mockResolvedValue({
-      output: { done: true },
-      tool_calls: [],
-      tool_calls_count: 0,
-      duration_ms: 10,
-    });
-
-    // A stage after the group should still run
-    const pipeline: PipelineDefinition = {
-      name: 'test-all-skipped-group',
-      description: 'test',
-      version: 1,
-      stages: [
-        {
-          group: 'optional-processing',
-          max_iterations: 1,
-          stages: [
-            {
-              name: 'optional-a',
-              executor: 'script',
-              script: 'scripts/a.py',
-              runtime: 'shell',
-              condition: 'input.run_optional >= 1',
-            },
-            {
-              name: 'optional-b',
-              executor: 'script',
-              script: 'scripts/b.py',
-              runtime: 'shell',
-              condition: 'input.run_optional >= 1',
-            },
-          ],
-        },
-        {
-          name: 'post-group-stage',
-          executor: 'script',
-          script: 'scripts/final.py',
-          runtime: 'shell',
-        },
-      ],
-    };
-
-    const engine = makeEngine();
-    const result = await engine.run({
-      pipelineDef: pipeline,
-      input: { run_optional: 0 },
-    });
-
-    expect(result.status).toBe('success');
-    // Both group stages skipped
-    expect(result.stages[0]?.status).toBe('skipped');
-    expect(result.stages[1]?.status).toBe('skipped');
-    // Post-group stage ran
-    expect(result.stages[2]?.status).toBe('success');
-    expect(vi.mocked(runScript)).toHaveBeenCalledTimes(1);  // only post-group-stage
-  });
-});
-
-describe('engine — conditions inside parallel groups', () => {
-  beforeEach(() => {
-    vi.clearAllMocks();
-  });
-
-  it('marks parallel group as skipped when all stages are skipped', async () => {
-    vi.mocked(runScript).mockResolvedValue({
-      output: { done: true },
-      tool_calls: [],
-      tool_calls_count: 0,
-      duration_ms: 10,
-    });
-
-    const pipeline: PipelineDefinition = {
-      name: 'test-parallel-all-skipped',
-      description: 'test',
-      version: 1,
-      stages: [
-        {
-          group: 'optional-parallel',
-          max_iterations: 1,
-          mode: 'parallel',
-          stages: [
-            {
-              name: 'parallel-a',
-              executor: 'script',
-              script: 'scripts/a.py',
-              runtime: 'shell',
-              condition: 'input.enabled >= 1',
-            },
-            {
-              name: 'parallel-b',
-              executor: 'script',
-              script: 'scripts/b.py',
-              runtime: 'shell',
-              condition: 'input.enabled >= 1',
-            },
-          ],
-        },
-        {
-          name: 'post-group',
-          executor: 'script',
-          script: 'scripts/final.py',
-          runtime: 'shell',
-        },
-      ],
-    };
-
-    const engine = makeEngine();
-    const result = await engine.run({
-      pipelineDef: pipeline,
-      input: { enabled: 0 },
-    });
-
-    expect(result.status).toBe('success');
-    expect(result.stages[0]?.status).toBe('skipped');
-    expect(result.stages[1]?.status).toBe('skipped');
-    expect(result.stages[2]?.status).toBe('success');
-    expect(vi.mocked(runScript)).toHaveBeenCalledTimes(1);  // only post-group
-  });
-
-  it('runs parallel group normally when at least one stage is not skipped', async () => {
-    vi.mocked(runScript).mockResolvedValue({
-      output: { done: true },
-      tool_calls: [],
-      tool_calls_count: 0,
-      duration_ms: 10,
-    });
-
-    const pipeline: PipelineDefinition = {
-      name: 'test-parallel-partial-skip',
-      description: 'test',
-      version: 1,
-      stages: [
-        {
-          group: 'mixed-parallel',
-          max_iterations: 1,
-          mode: 'parallel',
-          stages: [
-            {
-              name: 'always-runs',
-              executor: 'script',
-              script: 'scripts/a.py',
-              runtime: 'shell',
-            },
-            {
-              name: 'conditional',
-              executor: 'script',
-              script: 'scripts/b.py',
-              runtime: 'shell',
-              condition: 'input.enabled >= 1',
-            },
-          ],
-        },
-      ],
-    };
-
-    const engine = makeEngine();
-    const result = await engine.run({
-      pipelineDef: pipeline,
-      input: { enabled: 0 },
-    });
-
-    expect(result.status).toBe('success');
-    expect(result.stages[0]?.status).toBe('success');
-    expect(result.stages[1]?.status).toBe('skipped');
-    expect(vi.mocked(runScript)).toHaveBeenCalledTimes(1);  // only always-runs
-  });
-});