npm - @studio-foundation/engine - Versions diffs - 0.3.0-beta.1 - Mend

@studio-foundation/engine 0.3.0-beta.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (90) hide show

package/ARCHITECTURE.md +57 -0
package/LICENSE +663 -0
package/README.md +118 -0
package/package.json +47 -0
package/src/__tests__/__fixtures__/script-stage/contracts/book-context.contract.yaml +4 -0
package/src/__tests__/engine.conditions-group.test.ts +244 -0
package/src/__tests__/engine.conditions.test.ts +186 -0
package/src/__tests__/engine.resume.test.ts +108 -0
package/src/__tests__/engine.script-stage.test.ts +125 -0
package/src/db/client.ts +5 -0
package/src/engine.context-event.test.ts +175 -0
package/src/engine.ts +491 -0
package/src/events.ts +167 -0
package/src/index.ts +64 -0
package/src/pipeline/agent-loader.test.ts +151 -0
package/src/pipeline/agent-loader.ts +39 -0
package/src/pipeline/condition-evaluator.test.ts +129 -0
package/src/pipeline/condition-evaluator.ts +121 -0
package/src/pipeline/context-pack-loader.ts +63 -0
package/src/pipeline/context-propagation.test.ts +237 -0
package/src/pipeline/context-propagation.ts +235 -0
package/src/pipeline/contract-loader.ts +41 -0
package/src/pipeline/group-orchestrator.ts +483 -0
package/src/pipeline/hook-executor.test.ts +121 -0
package/src/pipeline/hook-executor.ts +87 -0
package/src/pipeline/invariants-loader.test.ts +51 -0
package/src/pipeline/invariants-loader.ts +14 -0
package/src/pipeline/loader.test.ts +128 -0
package/src/pipeline/loader.ts +149 -0
package/src/pipeline/output-validator.test.ts +100 -0
package/src/pipeline/output-validator.ts +40 -0
package/src/pipeline/post-validator.ts +124 -0
package/src/pipeline/skill-loader.test.ts +44 -0
package/src/pipeline/skill-loader.ts +32 -0
package/src/pipeline/stage-executor.ts +654 -0
package/src/pipeline/stage-resolver.ts +8 -0
package/src/pipeline/startup-executor.test.ts +37 -0
package/src/pipeline/startup-executor.ts +32 -0
package/src/pipeline/types.ts +42 -0
package/src/repo-resolver.ts +61 -0
package/src/spawners/direct-engine-spawner.ts +26 -0
package/src/state/run-store.test.ts +157 -0
package/src/state/run-store.ts +362 -0
package/src/state/state-machine.ts +35 -0
package/src/state/status-derivation.ts +36 -0
package/tests/context-pack-loader.test.ts +113 -0
package/tests/context-propagation.test.ts +267 -0
package/tests/direct-engine-spawner.test.ts +102 -0
package/tests/e2e/feature-v5.test.ts +57 -0
package/tests/events.test.ts +56 -0
package/tests/fixtures/agents/test-agent.agent.yaml +5 -0
package/tests/fixtures/contracts/code-gen.contract.yaml +6 -0
package/tests/fixtures/contracts/qa-gate.contract.yaml +15 -0
package/tests/fixtures/contracts/test-contract.contract.yaml +6 -0
package/tests/fixtures/pipelines/group-test.pipeline.yaml +40 -0
package/tests/fixtures/pipelines/simple.pipeline.yaml +15 -0
package/tests/fixtures/pipelines/two-stage.pipeline.yaml +24 -0
package/tests/fixtures/software/pipelines/feature-builder.pipeline.yaml +75 -0
package/tests/fixtures/test-project/agents/test-agent.agent.yaml +5 -0
package/tests/fixtures/test-project/contracts/basic-result.contract.yaml +6 -0
package/tests/fixtures/test-project/contracts/code-gen.contract.yaml +6 -0
package/tests/fixtures/test-project/contracts/maximum-only.contract.yaml +8 -0
package/tests/fixtures/test-project/contracts/qa-gate.contract.yaml +15 -0
package/tests/fixtures/test-project/contracts/strict-result.contract.yaml +7 -0
package/tests/fixtures/test-project/contracts/test-contract.contract.yaml +6 -0
package/tests/fixtures/test-project/pipelines/group-simple.pipeline.yaml +26 -0
package/tests/fixtures/test-project/pipelines/group-test.pipeline.yaml +40 -0
package/tests/fixtures/test-project/pipelines/hook-output-template.pipeline.yaml +19 -0
package/tests/fixtures/test-project/pipelines/hook-reject-on-failure.pipeline.yaml +19 -0
package/tests/fixtures/test-project/pipelines/maximum-only.pipeline.yaml +15 -0
package/tests/fixtures/test-project/pipelines/parallel-collect-all-test.pipeline.yaml +39 -0
package/tests/fixtures/test-project/pipelines/parallel-context-isolation-test.pipeline.yaml +38 -0
package/tests/fixtures/test-project/pipelines/parallel-fail-test.pipeline.yaml +39 -0
package/tests/fixtures/test-project/pipelines/parallel-test.pipeline.yaml +39 -0
package/tests/fixtures/test-project/pipelines/parallel-then-sequential-test.pipeline.yaml +38 -0
package/tests/fixtures/test-project/pipelines/simple.pipeline.yaml +15 -0
package/tests/fixtures/test-project/pipelines/two-stage.pipeline.yaml +24 -0
package/tests/fixtures/test-project/pipelines/with-startup.pipeline.yaml +19 -0
package/tests/loader.test.ts +385 -0
package/tests/post-validator.test.ts +297 -0
package/tests/repo-resolver.test.ts +102 -0
package/tests/run-store.test.ts +143 -0
package/tests/state-machine.test.ts +110 -0
package/tests/unit/context-propagation.test.ts +45 -0
package/tests/unit/engine.test.ts +770 -0
package/tests/unit/group-loop.test.ts +389 -0
package/tests/unit/group-parallel.test.ts +423 -0
package/tests/unit/state/status-derivation.test.ts +88 -0
package/tsconfig.json +24 -0
package/vitest.config.ts +14 -0

package/tests/fixtures/test-project/contracts/code-gen.contract.yaml ADDED Viewed

@@ -0,0 +1,6 @@
+name: code-gen
+version: 1
+schema:
+  required_fields:
+    - files_changed

package/tests/fixtures/test-project/contracts/maximum-only.contract.yaml ADDED Viewed

@@ -0,0 +1,8 @@
+name: maximum-only
+version: 1
+schema:
+  required_fields:
+    - summary
+tool_calls:
+  maximum: 2

package/tests/fixtures/test-project/contracts/qa-gate.contract.yaml ADDED Viewed

@@ -0,0 +1,15 @@
+name: qa-gate
+version: 1
+schema:
+  required_fields:
+    - status
+    - issues
+post_validation:
+  rejection_detection:
+    field: status
+    approved_values:
+      - approved
+      - pass
+    details_field: issues
+    summary_field: summary

package/tests/fixtures/test-project/contracts/strict-result.contract.yaml ADDED Viewed

@@ -0,0 +1,7 @@
+name: strict-result
+version: 1
+schema:
+  required_fields:
+    - result
+    - must_exist

package/tests/fixtures/test-project/contracts/test-contract.contract.yaml ADDED Viewed

@@ -0,0 +1,6 @@
+name: test-contract
+version: 1
+schema:
+  required_fields:
+    - summary

package/tests/fixtures/test-project/pipelines/group-simple.pipeline.yaml ADDED Viewed

@@ -0,0 +1,26 @@
+name: group-simple
+description: Pipeline with a simple group for cancellation testing
+version: 1
+stages:
+  - group: review-loop
+    max_iterations: 2
+    stages:
+      - name: review-stage-1
+        kind: analysis
+        agent: test-agent
+        ralph:
+          max_attempts: 1
+          retry_strategy: none
+        context:
+          include:
+            - input
+      - name: review-stage-2
+        kind: analysis
+        agent: test-agent
+        ralph:
+          max_attempts: 1
+          retry_strategy: none
+        context:
+          include:
+            - input

package/tests/fixtures/test-project/pipelines/group-test.pipeline.yaml ADDED Viewed

@@ -0,0 +1,40 @@
+name: group-test
+description: Test pipeline with a feedback loop group
+version: 2
+stages:
+  - name: analysis
+    kind: analysis
+    agent: test-agent
+    ralph:
+      max_attempts: 1
+      retry_strategy: none
+    context:
+      include:
+        - input
+  - group: impl-review
+    max_iterations: 3
+    stages:
+      - name: code-gen
+        kind: code_generation
+        agent: test-agent
+        contract: code-gen
+        ralph:
+          max_attempts: 1
+          retry_strategy: none
+        context:
+          include:
+            - input
+            - all_stage_outputs
+            - group_feedback
+      - name: qa-review
+        kind: qa
+        agent: test-agent
+        contract: qa-gate
+        ralph:
+          max_attempts: 1
+          retry_strategy: none
+        context:
+          include:
+            - input
+            - all_stage_outputs

package/tests/fixtures/test-project/pipelines/hook-output-template.pipeline.yaml ADDED Viewed

@@ -0,0 +1,19 @@
+name: hook-output-template
+description: Pipeline that verifies on_stage_complete hook receives stage output as template context
+version: 1
+stages:
+  - name: analysis
+    kind: analysis
+    agent: test-agent
+    contract: test-contract
+    hooks:
+      on_stage_complete:
+        - command: "sh -c 'echo {{output.files_changed}} | grep -qx file.ts'"
+          on_failure: reject
+    ralph:
+      max_attempts: 1
+      retry_strategy: none
+    context:
+      include:
+        - input

package/tests/fixtures/test-project/pipelines/hook-reject-on-failure.pipeline.yaml ADDED Viewed

@@ -0,0 +1,19 @@
+name: hook-reject-on-failure
+description: Pipeline where on_stage_complete hook fails and rejects the stage
+version: 1
+stages:
+  - name: analysis
+    kind: analysis
+    agent: test-agent
+    contract: test-contract
+    hooks:
+      on_stage_complete:
+        - command: "sh -c 'echo hook-error-output >&2; exit 1'"
+          on_failure: reject
+    ralph:
+      max_attempts: 1
+      retry_strategy: none
+    context:
+      include:
+        - input

package/tests/fixtures/test-project/pipelines/maximum-only.pipeline.yaml ADDED Viewed

@@ -0,0 +1,15 @@
+name: maximum-only
+description: Pipeline with a contract that only sets maximum tool_calls
+version: 1
+stages:
+  - name: analysis
+    kind: analysis
+    agent: test-agent
+    contract: maximum-only
+    ralph:
+      max_attempts: 1
+      retry_strategy: none
+    context:
+      include:
+        - input

package/tests/fixtures/test-project/pipelines/parallel-collect-all-test.pipeline.yaml ADDED Viewed

@@ -0,0 +1,39 @@
+name: parallel-collect-all-test
+description: Test pipeline with collect-all parallel group
+version: 1
+stages:
+  - group: parallel-work
+    mode: parallel
+    on_failure: collect-all
+    stages:
+      - name: stage-a
+        kind: analysis
+        agent: test-agent
+        contract: basic-result
+        ralph:
+          max_attempts: 1
+          retry_strategy: none
+        context:
+          include:
+            - input
+      - name: stage-b
+        kind: analysis
+        agent: test-agent
+        contract: strict-result
+        ralph:
+          max_attempts: 1
+          retry_strategy: none
+        context:
+          include:
+            - input
+      - name: stage-c
+        kind: analysis
+        agent: test-agent
+        contract: basic-result
+        ralph:
+          max_attempts: 1
+          retry_strategy: none
+        context:
+          include:
+            - input

package/tests/fixtures/test-project/pipelines/parallel-context-isolation-test.pipeline.yaml ADDED Viewed

@@ -0,0 +1,38 @@
+name: parallel-context-isolation-test
+description: context isolation test
+version: 1
+stages:
+  - name: pre-stage
+    kind: analysis
+    agent: test-agent
+    contract: basic-result
+    ralph:
+      max_attempts: 1
+      retry_strategy: none
+    context:
+      include:
+        - input
+  - group: parallel-work
+    mode: parallel
+    stages:
+      - name: stage-a
+        kind: analysis
+        agent: test-agent
+        contract: basic-result
+        ralph:
+          max_attempts: 1
+          retry_strategy: none
+        context:
+          include:
+            - all_stage_outputs
+      - name: stage-b
+        kind: analysis
+        agent: test-agent
+        contract: basic-result
+        ralph:
+          max_attempts: 1
+          retry_strategy: none
+        context:
+          include:
+            - all_stage_outputs

package/tests/fixtures/test-project/pipelines/parallel-fail-test.pipeline.yaml ADDED Viewed

@@ -0,0 +1,39 @@
+name: parallel-fail-test
+description: Test pipeline with a failing stage in parallel group
+version: 1
+stages:
+  - group: parallel-work
+    mode: parallel
+    on_failure: fail-fast
+    stages:
+      - name: stage-a
+        kind: analysis
+        agent: test-agent
+        contract: basic-result
+        ralph:
+          max_attempts: 1
+          retry_strategy: none
+        context:
+          include:
+            - input
+      - name: stage-b
+        kind: analysis
+        agent: test-agent
+        contract: strict-result
+        ralph:
+          max_attempts: 1
+          retry_strategy: none
+        context:
+          include:
+            - input
+      - name: stage-c
+        kind: analysis
+        agent: test-agent
+        contract: basic-result
+        ralph:
+          max_attempts: 1
+          retry_strategy: none
+        context:
+          include:
+            - input

package/tests/fixtures/test-project/pipelines/parallel-test.pipeline.yaml ADDED Viewed

@@ -0,0 +1,39 @@
+name: parallel-test
+description: Test pipeline with parallel group
+version: 1
+stages:
+  - group: parallel-work
+    mode: parallel
+    max_iterations: 1
+    stages:
+      - name: stage-a
+        kind: analysis
+        agent: test-agent
+        contract: basic-result
+        ralph:
+          max_attempts: 1
+          retry_strategy: none
+        context:
+          include:
+            - input
+      - name: stage-b
+        kind: analysis
+        agent: test-agent
+        contract: basic-result
+        ralph:
+          max_attempts: 1
+          retry_strategy: none
+        context:
+          include:
+            - input
+      - name: stage-c
+        kind: analysis
+        agent: test-agent
+        contract: basic-result
+        ralph:
+          max_attempts: 1
+          retry_strategy: none
+        context:
+          include:
+            - input

package/tests/fixtures/test-project/pipelines/parallel-then-sequential-test.pipeline.yaml ADDED Viewed

@@ -0,0 +1,38 @@
+name: parallel-then-sequential-test
+description: Test pipeline with parallel group followed by sequential stage
+version: 1
+stages:
+  - group: parallel-work
+    mode: parallel
+    stages:
+      - name: stage-a
+        kind: analysis
+        agent: test-agent
+        contract: basic-result
+        ralph:
+          max_attempts: 1
+          retry_strategy: none
+        context:
+          include:
+            - input
+      - name: stage-b
+        kind: analysis
+        agent: test-agent
+        contract: basic-result
+        ralph:
+          max_attempts: 1
+          retry_strategy: none
+        context:
+          include:
+            - input
+  - name: merge-results
+    kind: merge
+    agent: test-agent
+    contract: basic-result
+    ralph:
+      max_attempts: 1
+      retry_strategy: none
+    context:
+      include:
+        - all_stage_outputs

package/tests/fixtures/test-project/pipelines/simple.pipeline.yaml ADDED Viewed

@@ -0,0 +1,15 @@
+name: simple
+description: Simple test pipeline
+version: 1
+stages:
+  - name: analysis
+    kind: analysis
+    agent: test-agent
+    contract: test-contract
+    ralph:
+      max_attempts: 2
+      retry_strategy: none
+    context:
+      include:
+        - input

package/tests/fixtures/test-project/pipelines/two-stage.pipeline.yaml ADDED Viewed

@@ -0,0 +1,24 @@
+name: two-stage
+description: Two stage pipeline
+version: 1
+stages:
+  - name: stage-1
+    kind: analysis
+    agent: test-agent
+    ralph:
+      max_attempts: 1
+      retry_strategy: none
+    context:
+      include:
+        - input
+  - name: stage-2
+    kind: planning
+    agent: test-agent
+    ralph:
+      max_attempts: 1
+      retry_strategy: none
+    context:
+      include:
+        - input
+        - previous_stage_output

package/tests/fixtures/test-project/pipelines/with-startup.pipeline.yaml ADDED Viewed

@@ -0,0 +1,19 @@
+name: with-startup
+description: Pipeline that exercises on_pipeline_start context injection
+version: 1
+on_pipeline_start:
+  - command: "echo git-status-output"
+    inject_as: git_status
+stages:
+  - name: analysis
+    kind: analysis
+    agent: test-agent
+    contract: test-contract
+    ralph:
+      max_attempts: 1
+      retry_strategy: none
+    context:
+      include:
+        - input
+        - pipeline_start_context