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

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

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

package/dist/pipeline/invariants-loader.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Load `.studio/invariants.md` from the project directory.
+ * Returns content if the file exists, undefined otherwise (non-fatal).
+ */
+export declare function loadInvariantsFile(projectDir: string): Promise<string | undefined>;
+//# sourceMappingURL=invariants-loader.d.ts.map

package/dist/pipeline/invariants-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invariants-loader.d.ts","sourceRoot":"","sources":["../../src/pipeline/invariants-loader.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAMxF"}

package/dist/pipeline/invariants-loader.js

@@ -0,0 +1,15 @@
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+/**
+ * Load `.studio/invariants.md` from the project directory.
+ * Returns content if the file exists, undefined otherwise (non-fatal).
+ */
+export async function loadInvariantsFile(projectDir) {
+    try {
+        return await readFile(join(projectDir, 'invariants.md'), 'utf-8');
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=invariants-loader.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"invariants-loader.js","sourceRoot":"","sources":["../../src/pipeline/invariants-loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,UAAkB;IACzD,IAAI,CAAC;QACH,OAAO,MAAM,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,eAAe,CAAC,EAAE,OAAO,CAAC,CAAC;IACpE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

package/dist/pipeline/invariants-loader.test.d.ts

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

package/dist/pipeline/invariants-loader.test.d.ts.map

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

package/dist/pipeline/invariants-loader.test.js

@@ -0,0 +1,39 @@
+import { describe, it, expect, beforeAll, afterAll } from 'vitest';
+import { mkdir, writeFile, rm } from 'node:fs/promises';
+import { join } from 'node:path';
+import { loadInvariantsFile } from './invariants-loader.js';
+const TMP = join('/tmp', '.studio-invariants-loader-test-' + Date.now());
+const INVARIANTS_PATH = join(TMP, 'invariants.md');
+describe('loadInvariantsFile', () => {
+    beforeAll(async () => {
+        await mkdir(TMP, { recursive: true });
+        await writeFile(INVARIANTS_PATH, '# Domain Invariants\n\nNever reproduce verbatim passages.');
+    });
+    afterAll(async () => {
+        await rm(TMP, { recursive: true, force: true });
+    });
+    it('returns file content when invariants.md exists', async () => {
+        const content = await loadInvariantsFile(TMP);
+        expect(content).toBe('# Domain Invariants\n\nNever reproduce verbatim passages.');
+    });
+    it('returns undefined when invariants.md does not exist', async () => {
+        const content = await loadInvariantsFile('/tmp/no-such-studio-dir-xyz');
+        expect(content).toBeUndefined();
+    });
+});
+describe('invariants content is suitable for system_prompt injection', () => {
+    it('non-empty content can be concatenated into a system_prompt string', async () => {
+        const dir = join('/tmp', '.studio-invariants-integration-' + Date.now());
+        await mkdir(dir, { recursive: true });
+        await writeFile(join(dir, 'invariants.md'), '## Invariants\n\n- Never hallucinate entity names\n- Cite sources');
+        const content = await loadInvariantsFile(dir);
+        expect(content).toBeDefined();
+        expect(typeof content).toBe('string');
+        expect(content.length).toBeGreaterThan(0);
+        const systemPrompt = `You are an agent.\n\n---\n\n## Project Invariants\n\n${content}`;
+        expect(systemPrompt).toContain('Never hallucinate entity names');
+        expect(systemPrompt).toContain('## Project Invariants');
+        await rm(dir, { recursive: true, force: true });
+    });
+});
+//# sourceMappingURL=invariants-loader.test.js.map

package/dist/pipeline/invariants-loader.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invariants-loader.test.js","sourceRoot":"","sources":["../../src/pipeline/invariants-loader.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AACnE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAE5D,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,iCAAiC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;AACzE,MAAM,eAAe,GAAG,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;AAEnD,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAClC,SAAS,CAAC,KAAK,IAAI,EAAE;QACnB,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACtC,MAAM,SAAS,CAAC,eAAe,EAAE,2DAA2D,CAAC,CAAC;IAChG,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,KAAK,IAAI,EAAE;QAClB,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gDAAgD,EAAE,KAAK,IAAI,EAAE;QAC9D,MAAM,OAAO,GAAG,MAAM,kBAAkB,CAAC,GAAG,CAAC,CAAC;QAC9C,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,2DAA2D,CAAC,CAAC;IACpF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,KAAK,IAAI,EAAE;QACnE,MAAM,OAAO,GAAG,MAAM,kBAAkB,CAAC,6BAA6B,CAAC,CAAC;QACxE,MAAM,CAAC,OAAO,CAAC,CAAC,aAAa,EAAE,CAAC;IAClC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,4DAA4D,EAAE,GAAG,EAAE;IAC1E,EAAE,CAAC,mEAAmE,EAAE,KAAK,IAAI,EAAE;QACjF,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,iCAAiC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QACzE,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACtC,MAAM,SAAS,CACb,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,EAC1B,mEAAmE,CACpE,CAAC;QAEF,MAAM,OAAO,GAAG,MAAM,kBAAkB,CAAC,GAAG,CAAC,CAAC;QAE9C,MAAM,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;QAC9B,MAAM,CAAC,OAAO,OAAO,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACtC,MAAM,CAAC,OAAQ,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;QAE3C,MAAM,YAAY,GAAG,wDAAwD,OAAO,EAAE,CAAC;QACvF,MAAM,CAAC,YAAY,CAAC,CAAC,SAAS,CAAC,gCAAgC,CAAC,CAAC;QACjE,MAAM,CAAC,YAAY,CAAC,CAAC,SAAS,CAAC,uBAAuB,CAAC,CAAC;QAExD,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/pipeline/loader.d.ts

@@ -0,0 +1,5 @@
+import type { PipelineDefinition } from '@studio-foundation/contracts';
+export declare function loadPipeline(path: string): Promise<PipelineDefinition>;
+export declare function loadPipelineByName(name: string, pipelinesDir: string): Promise<PipelineDefinition>;
+export declare function parsePipelineYaml(yamlContent: string, sourcePath?: string): PipelineDefinition;
+//# sourceMappingURL=loader.d.ts.map

package/dist/pipeline/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/pipeline/loader.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,kBAAkB,EAA0E,MAAM,8BAA8B,CAAC;AAE/I,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAS5E;AAED,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,kBAAkB,CAAC,CAG7B;AAED,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,kBAAkB,CA8E9F"}

package/dist/pipeline/loader.js

@@ -0,0 +1,132 @@
+// Load pipeline definitions from YAML files
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import * as yaml from 'js-yaml';
+export async function loadPipeline(path) {
+    let content;
+    try {
+        content = await readFile(path, 'utf-8');
+    }
+    catch (err) {
+        throw new Error(`Failed to load pipeline at ${path}: ${err.message}`);
+    }
+    return parsePipelineYaml(content, path);
+}
+export async function loadPipelineByName(name, pipelinesDir) {
+    const path = join(pipelinesDir, `${name}.pipeline.yaml`);
+    return loadPipeline(path);
+}
+export function parsePipelineYaml(yamlContent, sourcePath) {
+    const parsed = yaml.load(yamlContent);
+    const context = sourcePath ? ` (from ${sourcePath})` : '';
+    if (!parsed || typeof parsed !== 'object') {
+        throw new Error(`Invalid pipeline YAML: expected an object${context}`);
+    }
+    if (!parsed.name || typeof parsed.name !== 'string') {
+        throw new Error(`Pipeline missing required field 'name'${context}`);
+    }
+    if (!Array.isArray(parsed.stages)) {
+        throw new Error(`Pipeline missing required field 'stages'${context}`);
+    }
+    if (parsed.stages.length === 0) {
+        throw new Error(`Pipeline must have at least one stage${context}`);
+    }
+    const stages = [];
+    for (const entry of parsed.stages) {
+        if (entry.group) {
+            // Group entry
+            if (!Array.isArray(entry.stages) || entry.stages.length < 2) {
+                throw new Error(`Group '${entry.group}' must have at least 2 stages${context}`);
+            }
+            for (const s of entry.stages) {
+                validateStageFields(s, context);
+            }
+            const mode = entry.mode === 'parallel' ? 'parallel' : undefined;
+            let maxIterations = entry.max_iterations ?? 3;
+            if (mode === 'parallel' && maxIterations > 1) {
+                console.warn(`[studio] parallel group '${entry.group}' has max_iterations > 1 — iterations are ignored in parallel mode, using 1`);
+                maxIterations = 1;
+            }
+            stages.push({
+                group: entry.group,
+                max_iterations: maxIterations,
+                ...(mode ? { mode } : {}),
+                ...(entry.on_failure ? { on_failure: entry.on_failure } : {}),
+                stages: entry.stages.map((s) => ({ ...s, hooks: parseStageHooks(s) })),
+            });
+        }
+        else {
+            // Simple stage
+            validateStageFields(entry, context);
+            stages.push({ ...entry, hooks: parseStageHooks(entry) });
+        }
+    }
+    // Parse on_pipeline_start commands
+    let on_pipeline_start;
+    if (Array.isArray(parsed.on_pipeline_start)) {
+        on_pipeline_start = [];
+        for (const cmd of parsed.on_pipeline_start) {
+            if (!cmd.command || typeof cmd.command !== 'string') {
+                throw new Error(`on_pipeline_start entry missing 'command'${context}`);
+            }
+            if (!cmd.inject_as || typeof cmd.inject_as !== 'string') {
+                throw new Error(`on_pipeline_start entry missing 'inject_as'${context}`);
+            }
+            on_pipeline_start.push({ command: cmd.command, inject_as: cmd.inject_as });
+        }
+        if (on_pipeline_start.length === 0) {
+            on_pipeline_start = undefined;
+        }
+    }
+    return {
+        ...parsed,
+        stages,
+        on_pipeline_start,
+    };
+}
+function parseStageHooks(entry) {
+    if (!entry.hooks || typeof entry.hooks !== 'object')
+        return undefined;
+    const h = entry.hooks;
+    const result = {};
+    if (Array.isArray(h.on_stage_start)) {
+        result.on_stage_start = h.on_stage_start.map((hk) => ({
+            command: String(hk.command ?? ''),
+            on_failure: hk.on_failure ?? 'warn',
+        }));
+    }
+    if (Array.isArray(h.on_stage_complete)) {
+        result.on_stage_complete = h.on_stage_complete.map((hk) => ({
+            command: String(hk.command ?? ''),
+            on_failure: hk.on_failure ?? 'warn',
+        }));
+    }
+    if (Array.isArray(h.pre_tool_use)) {
+        result.pre_tool_use = h.pre_tool_use.map((hk) => ({
+            matcher: String(hk.matcher ?? ''),
+            command: String(hk.command ?? ''),
+            on_failure: hk.on_failure ?? 'warn',
+        }));
+    }
+    if (Array.isArray(h.post_tool_use)) {
+        result.post_tool_use = h.post_tool_use.map((hk) => ({
+            matcher: String(hk.matcher ?? ''),
+            command: String(hk.command ?? ''),
+            on_failure: hk.on_failure ?? 'warn',
+        }));
+    }
+    const hasAny = result.on_stage_start || result.on_stage_complete
+        || result.pre_tool_use || result.post_tool_use;
+    return hasAny ? result : undefined;
+}
+function validateStageFields(stage, context) {
+    if (!stage.name)
+        throw new Error(`Stage missing 'name'${context}`);
+    if (!stage.kind && !stage.executor)
+        throw new Error(`Stage '${stage.name}' missing 'kind'${context}`);
+    if (!stage.agent && stage.executor !== 'script')
+        throw new Error(`Stage '${stage.name}' missing 'agent'${context}`);
+    if (stage.executor === 'script' && !stage.script)
+        throw new Error(`Stage '${stage.name}' missing 'script' (required when executor: 'script')${context}`);
+}
+//# sourceMappingURL=loader.js.map

package/dist/pipeline/loader.js.map

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

package/dist/pipeline/loader.test.d.ts

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

package/dist/pipeline/loader.test.d.ts.map

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

package/dist/pipeline/loader.test.js

@@ -0,0 +1,120 @@
+import { describe, it, expect } from 'vitest';
+import { parsePipelineYaml } from './loader.js';
+const MINIMAL_STAGE = `
+  - name: analyze
+    kind: analysis
+    agent: analyst
+`;
+describe('parsePipelineYaml — on_pipeline_start', () => {
+    it('parses on_pipeline_start commands', () => {
+        const yaml = `
+name: test-pipeline
+description: test
+version: 1
+on_pipeline_start:
+  - command: "git status --short"
+    inject_as: git_status
+  - command: "git log --oneline -5"
+    inject_as: recent_commits
+stages:
+${MINIMAL_STAGE}
+`;
+        const result = parsePipelineYaml(yaml);
+        expect(result.on_pipeline_start).toEqual([
+            { command: 'git status --short', inject_as: 'git_status' },
+            { command: 'git log --oneline -5', inject_as: 'recent_commits' },
+        ]);
+    });
+    it('returns undefined on_pipeline_start when absent', () => {
+        const yaml = `
+name: test-pipeline
+description: test
+version: 1
+stages:
+${MINIMAL_STAGE}
+`;
+        const result = parsePipelineYaml(yaml);
+        expect(result.on_pipeline_start).toBeUndefined();
+    });
+    it('throws when on_pipeline_start entry is missing command', () => {
+        const yaml = `
+name: test-pipeline
+description: test
+version: 1
+on_pipeline_start:
+  - inject_as: git_status
+stages:
+${MINIMAL_STAGE}
+`;
+        expect(() => parsePipelineYaml(yaml)).toThrow("on_pipeline_start entry missing 'command'");
+    });
+    it('throws when on_pipeline_start entry is missing inject_as', () => {
+        const yaml = `
+name: test-pipeline
+description: test
+version: 1
+on_pipeline_start:
+  - command: "git status"
+stages:
+${MINIMAL_STAGE}
+`;
+        expect(() => parsePipelineYaml(yaml)).toThrow("on_pipeline_start entry missing 'inject_as'");
+    });
+});
+const PIPELINE_WITH_HOOKS = `
+name: test-pipeline
+description: test
+version: 1
+stages:
+  - name: code-gen
+    kind: code
+    agent: coder
+    hooks:
+      on_stage_start:
+        - command: "git stash"
+          on_failure: warn
+      on_stage_complete:
+        - command: "npx tsc --noEmit"
+          on_failure: reject
+      pre_tool_use:
+        - matcher: "repo_manager-write_file"
+          command: "echo pre {{tool.path}}"
+          on_failure: warn
+      post_tool_use:
+        - matcher: "repo_manager-write_file"
+          command: "npx prettier --write {{tool.path}}"
+          on_failure: warn
+`;
+describe('parsePipelineYaml — stage hooks', () => {
+    it('parses all four hook types from a stage', () => {
+        const result = parsePipelineYaml(PIPELINE_WITH_HOOKS);
+        const stage = result.stages[0];
+        expect(stage.hooks?.on_stage_start).toEqual([
+            { command: 'git stash', on_failure: 'warn' },
+        ]);
+        expect(stage.hooks?.on_stage_complete).toEqual([
+            { command: 'npx tsc --noEmit', on_failure: 'reject' },
+        ]);
+        expect(stage.hooks?.pre_tool_use).toEqual([
+            { matcher: 'repo_manager-write_file', command: 'echo pre {{tool.path}}', on_failure: 'warn' },
+        ]);
+        expect(stage.hooks?.post_tool_use).toEqual([
+            { matcher: 'repo_manager-write_file', command: 'npx prettier --write {{tool.path}}', on_failure: 'warn' },
+        ]);
+    });
+    it('returns undefined hooks when stage has no hooks', () => {
+        const yaml = `
+name: test-pipeline
+description: test
+version: 1
+stages:
+  - name: analyze
+    kind: analysis
+    agent: analyst
+`;
+        const result = parsePipelineYaml(yaml);
+        const stage = result.stages[0];
+        expect(stage.hooks).toBeUndefined();
+    });
+});
+//# sourceMappingURL=loader.test.js.map

package/dist/pipeline/loader.test.js.map

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

package/dist/pipeline/output-validator.d.ts

@@ -0,0 +1,10 @@
+import type { OutputContract, ToolCall } from '@studio-foundation/contracts';
+import { type PostValidationResult } from './post-validator.js';
+export interface OutputValidationResult {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+    post_validation: PostValidationResult;
+}
+export declare function validateOutput(contract: OutputContract, output: unknown, toolCalls?: ToolCall[]): OutputValidationResult;
+//# sourceMappingURL=output-validator.d.ts.map

package/dist/pipeline/output-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-validator.d.ts","sourceRoot":"","sources":["../../src/pipeline/output-validator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAQ7E,OAAO,EAAgB,KAAK,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAE9E,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,eAAe,EAAE,oBAAoB,CAAC;CACvC;AAED,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,OAAO,EACf,SAAS,GAAE,QAAQ,EAAO,GACzB,sBAAsB,CAkBxB"}

package/dist/pipeline/output-validator.js

@@ -0,0 +1,20 @@
+import { validateSchema, validateToolCalls, validateRequiredTools, validateCountedTools, validateToolGroups, } from '@studio-foundation/ralph';
+import { postValidate } from './post-validator.js';
+export function validateOutput(contract, output, toolCalls = []) {
+    const results = [
+        validateSchema(output, contract),
+        validateToolCalls(toolCalls, contract.tool_calls),
+        validateRequiredTools(toolCalls, contract.tool_calls),
+        validateCountedTools(toolCalls, contract.tool_calls),
+        validateToolGroups(toolCalls, contract.tool_calls),
+    ];
+    const errors = results.flatMap(r => r.errors);
+    const warnings = results.flatMap(r => r.warnings);
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings,
+        post_validation: postValidate(output, contract),
+    };
+}
+//# sourceMappingURL=output-validator.js.map

package/dist/pipeline/output-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-validator.js","sourceRoot":"","sources":["../../src/pipeline/output-validator.ts"],"names":[],"mappings":"AACA,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,YAAY,EAA6B,MAAM,qBAAqB,CAAC;AAS9E,MAAM,UAAU,cAAc,CAC5B,QAAwB,EACxB,MAAe,EACf,YAAwB,EAAE;IAE1B,MAAM,OAAO,GAAG;QACd,cAAc,CAAC,MAAM,EAAE,QAAQ,CAAC;QAChC,iBAAiB,CAAC,SAAS,EAAE,QAAQ,CAAC,UAAU,CAAC;QACjD,qBAAqB,CAAC,SAAS,EAAE,QAAQ,CAAC,UAAU,CAAC;QACrD,oBAAoB,CAAC,SAAS,EAAE,QAAQ,CAAC,UAAU,CAAC;QACpD,kBAAkB,CAAC,SAAS,EAAE,QAAQ,CAAC,UAAU,CAAC;KACnD,CAAC;IAEF,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IAC9C,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IAElD,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;QAC1B,MAAM;QACN,QAAQ;QACR,eAAe,EAAE,YAAY,CAAC,MAAM,EAAE,QAAQ,CAAC;KAChD,CAAC;AACJ,CAAC"}

package/dist/pipeline/output-validator.test.d.ts

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

package/dist/pipeline/output-validator.test.d.ts.map

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

package/dist/pipeline/output-validator.test.js

@@ -0,0 +1,77 @@
+import { describe, it, expect } from 'vitest';
+import { validateOutput } from './output-validator.js';
+const schemaOnlyContract = {
+    name: 'test-schema',
+    version: 1,
+    schema: { required_fields: ['summary', 'files_changed'] },
+};
+const toolCallContract = {
+    name: 'test-tool-calls',
+    version: 1,
+    schema: { required_fields: ['summary'] },
+    tool_calls: { minimum: 1, required_tools: ['repo_manager-write_file'] },
+};
+const postValidationContract = {
+    name: 'test-post-validation',
+    version: 1,
+    schema: { required_fields: ['status'] },
+    post_validation: {
+        rejection_detection: {
+            field: 'status',
+            approved_values: ['approved'],
+            rejected_values: ['rejected'],
+        },
+    },
+};
+describe('validateOutput', () => {
+    describe('schema validation', () => {
+        it('returns valid: true when all required fields are present', () => {
+            const result = validateOutput(schemaOnlyContract, { summary: 'ok', files_changed: ['a.ts'] });
+            expect(result.valid).toBe(true);
+            expect(result.errors).toEqual([]);
+        });
+        it('returns valid: false with error when required field is missing', () => {
+            const result = validateOutput(schemaOnlyContract, { summary: 'ok' });
+            expect(result.valid).toBe(false);
+            expect(result.errors).toContain('Missing required field: files_changed');
+        });
+        it('returns valid: false when output is not an object', () => {
+            const result = validateOutput(schemaOnlyContract, 'not an object');
+            expect(result.valid).toBe(false);
+        });
+    });
+    describe('tool_calls validation', () => {
+        it('returns valid: false when minimum not met (empty tool_calls)', () => {
+            const result = validateOutput(toolCallContract, { summary: 'ok' }, []);
+            expect(result.valid).toBe(false);
+            expect(result.errors.some(e => e.includes('at least 1 successful tool call'))).toBe(true);
+        });
+        it('returns valid: false when required tool was not called', () => {
+            const result = validateOutput(toolCallContract, { summary: 'ok' }, [{ id: 'call-1', name: 'shell-run_command', arguments: {}, result: 'ok' }]);
+            expect(result.valid).toBe(false);
+            expect(result.errors.some(e => e.includes('repo_manager-write_file'))).toBe(true);
+        });
+        it('returns valid: true when required tool was called successfully', () => {
+            const result = validateOutput(toolCallContract, { summary: 'ok' }, [{ id: 'call-2', name: 'repo_manager-write_file', arguments: { path: 'a.ts' }, result: 'ok' }]);
+            expect(result.valid).toBe(true);
+            expect(result.errors).toEqual([]);
+        });
+    });
+    describe('post_validation', () => {
+        it('accepted: true when approved value present', () => {
+            const result = validateOutput(postValidationContract, { status: 'approved' });
+            expect(result.valid).toBe(true);
+        });
+        it('accepted: false with rejection_reason when rejected value present', () => {
+            const result = validateOutput(postValidationContract, { status: 'rejected' });
+            expect(result.post_validation.accepted).toBe(false);
+            expect(result.post_validation.rejection_reason).toBeTruthy();
+        });
+        it('post_validation runs independently of schema validity', () => {
+            const result = validateOutput({ ...postValidationContract, schema: { required_fields: ['summary', 'status'] } }, { status: 'rejected' });
+            expect(result.valid).toBe(false);
+            expect(result.post_validation.accepted).toBe(false);
+        });
+    });
+});
+//# sourceMappingURL=output-validator.test.js.map

package/dist/pipeline/output-validator.test.js.map

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

package/dist/pipeline/post-validator.d.ts

@@ -0,0 +1,8 @@
+import type { OutputContract } from '@studio-foundation/contracts';
+export interface PostValidationResult {
+    accepted: boolean;
+    rejection_reason?: string;
+    rejection_details?: string[];
+}
+export declare function postValidate(output: unknown, contract: OutputContract): PostValidationResult;
+//# sourceMappingURL=post-validator.d.ts.map

package/dist/pipeline/post-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"post-validator.d.ts","sourceRoot":"","sources":["../../src/pipeline/post-validator.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAEnE,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,OAAO,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC9B;AAED,wBAAgB,YAAY,CAC1B,MAAM,EAAE,OAAO,EACf,QAAQ,EAAE,cAAc,GACvB,oBAAoB,CAwGtB"}

package/dist/pipeline/post-validator.js

@@ -0,0 +1,103 @@
+// Post-validation sémantique
+//
+// Vérifie le CONTENU de l'output après que ralph a validé le FORMAT.
+// Utilisé pour les stages avec une gate d'approbation — l'agent peut
+// retourner un JSON valide qui dit quand même "non".
+//
+// Configuré dans le contract YAML via la section "post_validation".
+export function postValidate(output, contract) {
+    // No post_validation config → everything is accepted
+    if (!contract.post_validation?.rejection_detection) {
+        return { accepted: true };
+    }
+    const { field, approved_values, rejected_values, details_field, summary_field, reject_if_non_empty } = contract.post_validation.rejection_detection;
+    if (!field) {
+        return { accepted: true };
+    }
+    // Extract field value from output
+    if (!output || typeof output !== 'object') {
+        return { accepted: true };
+    }
+    const o = output;
+    const actualValue = o[field];
+    if (typeof actualValue !== 'string') {
+        return { accepted: true };
+    }
+    // Check reject_if_non_empty before approved_values — a non-empty field always rejects
+    if (reject_if_non_empty) {
+        const fieldValue = o[reject_if_non_empty];
+        if (Array.isArray(fieldValue) && fieldValue.length > 0) {
+            const details = fieldValue
+                .map(item => {
+                if (typeof item === 'string')
+                    return item;
+                if (typeof item !== 'object' || item === null)
+                    return undefined;
+                const obj = item;
+                const text = obj.description ?? obj.issue ?? obj.message ?? obj.text ?? obj.error;
+                if (typeof text === 'string' && text.length > 0)
+                    return text;
+                return Object.values(obj).find((v) => typeof v === 'string' && v.length > 0);
+            })
+                .filter((d) => typeof d === 'string');
+            const summary = summary_field && typeof o[summary_field] === 'string'
+                ? o[summary_field]
+                : undefined;
+            return {
+                accepted: false,
+                rejection_reason: `Rejected: ${reject_if_non_empty} is non-empty (${fieldValue.length} items)${summary ? `. ${summary}` : ''}`,
+                rejection_details: details.length > 0 ? details : undefined,
+            };
+        }
+    }
+    // Check approved values (if specified)
+    if (approved_values?.length && approved_values.includes(actualValue)) {
+        return { accepted: true };
+    }
+    // Check rejected values (if specified)
+    if (rejected_values?.length && !rejected_values.includes(actualValue)) {
+        // Value is not in rejected list and no approved list matched → accept
+        if (!approved_values?.length) {
+            return { accepted: true };
+        }
+    }
+    // If we have approved_values and the value isn't in them → rejected
+    // If we have rejected_values and the value is in them → rejected
+    // Extract details from configured field
+    const details = [];
+    if (details_field) {
+        const detailsValue = o[details_field];
+        if (typeof detailsValue === 'string' && detailsValue.length > 0) {
+            details.push(detailsValue);
+        }
+        else if (Array.isArray(detailsValue)) {
+            for (const item of detailsValue) {
+                if (typeof item === 'string') {
+                    details.push(item);
+                }
+                else if (typeof item === 'object' && item !== null) {
+                    const obj = item;
+                    const text = obj.description ?? obj.issue ?? obj.message ?? obj.text ?? obj.error;
+                    if (typeof text === 'string' && text.length > 0) {
+                        details.push(text);
+                    }
+                    else {
+                        const firstStr = Object.values(obj).find((v) => typeof v === 'string' && v.length > 0);
+                        if (firstStr !== undefined)
+                            details.push(firstStr);
+                    }
+                }
+            }
+        }
+    }
+    // Extract summary from configured field
+    const summary = summary_field && typeof o[summary_field] === 'string'
+        ? o[summary_field]
+        : undefined;
+    return {
+        accepted: false,
+        rejection_reason: `Rejected: ${field} = "${actualValue}" (expected: ${(approved_values ?? []).join(' or ')})${summary ? `. ${summary}` : ''}`,
+        rejection_details: details.length > 0 ? details : undefined,
+    };
+}
+//# sourceMappingURL=post-validator.js.map