stageflow 0.25.0 → 0.27.0

package/examples/route-wiring-smoke-test/rejected/12-reject-loop-replay-unsafe.pipeline.yaml

@@ -0,0 +1,55 @@
+id: route-demo-reject-loop-replay-unsafe
+stages:
+  - id: implement
+    entry: true
+    route:
+      - to: middle
+    system_prompt: Implement.
+    model: cursor/auto
+    io:
+      input:
+        schema:
+          type: object
+      output:
+        schema:
+          type: object
+  - id: middle
+    replay_safe: false
+    route:
+      - to: review
+    system_prompt: A stage on the replay route that is not safe to replay.
+    model: cursor/auto
+    io:
+      input:
+        schema:
+          type: object
+      output:
+        schema:
+          type: object
+  - id: review
+    route:
+      - to: submit
+      - type: loop
+        to: implement
+        max_replays: 1
+        on_max_replays: require_continue
+        replay_session: resume
+    system_prompt: Review.
+    model: cursor/auto
+    io:
+      input:
+        schema:
+          type: object
+      output:
+        schema:
+          type: object
+  - id: submit
+    system_prompt: Submit.
+    model: cursor/auto
+    io:
+      input:
+        schema:
+          type: object
+      output:
+        schema:
+          type: object

package/examples/route-wiring-smoke-test/rejected/13-reject-multiple-loop-entries.pipeline.yaml

@@ -0,0 +1,51 @@
+id: route-demo-reject-multi-loop-entries
+stages:
+  - id: implement
+    entry: true
+    route:
+      - to: middle
+    system_prompt: Implement.
+    model: cursor/auto
+    io:
+      input:
+        schema:
+          type: object
+      output:
+        schema:
+          type: object
+  - id: middle
+    route:
+      - to: review
+    system_prompt: Middle.
+    model: cursor/auto
+    io:
+      input:
+        schema:
+          type: object
+      output:
+        schema:
+          type: object
+# Two loop entries with DIFFERENT (both valid) targets -- so the rejection
+  # below is specifically "at most one loop entry", not a duplicate-target
+  # error from having two entries pointing at the same place.
+  - id: review
+    route:
+      - type: loop
+        to: implement
+        max_replays: 1
+        on_max_replays: require_continue
+        replay_session: resume
+      - type: loop
+        to: middle
+        max_replays: 2
+        on_max_replays: wait_for_human
+        replay_session: new_session
+    system_prompt: Review.
+    model: cursor/auto
+    io:
+      input:
+        schema:
+          type: object
+      output:
+        schema:
+          type: object

package/examples/route-wiring-smoke-test/rejected/14-reject-duplicate-stage-id.pipeline.yaml

@@ -0,0 +1,35 @@
+id: route-demo-reject-duplicate-stage-id
+stages:
+  - id: draft
+    entry: true
+    route:
+      - to: review
+    system_prompt: Draft.
+    model: cursor/auto
+    io:
+      input:
+        schema:
+          type: object
+      output:
+        schema:
+          type: object
+  - id: review
+    system_prompt: Review A.
+    model: cursor/auto
+    io:
+      input:
+        schema:
+          type: object
+      output:
+        schema:
+          type: object
+  - id: review
+    system_prompt: Review B -- duplicate id.
+    model: cursor/auto
+    io:
+      input:
+        schema:
+          type: object
+      output:
+        schema:
+          type: object

package/examples/route-wiring-smoke-test/rejected/15-reject-unknown-route-target.pipeline.yaml

@@ -0,0 +1,15 @@
+id: route-demo-reject-unknown-route-target
+stages:
+  - id: draft
+    entry: true
+    route:
+      - to: nonexistent-stage
+    system_prompt: Draft.
+    model: cursor/auto
+    io:
+      input:
+        schema:
+          type: object
+      output:
+        schema:
+          type: object

package/examples/route-wiring-smoke-test/rejected/16-reject-malformed-route-item.pipeline.yaml

@@ -0,0 +1,15 @@
+id: route-demo-reject-malformed-route-item
+stages:
+  - id: draft
+    entry: true
+    route:
+      - on: [succeeded]
+    system_prompt: Draft.
+    model: cursor/auto
+    io:
+      input:
+        schema:
+          type: object
+      output:
+        schema:
+          type: object

package/examples/route-wiring-smoke-test/rejected/17-reject-io-incompatible.pipeline.yaml

@@ -0,0 +1,33 @@
+id: route-demo-reject-io-incompatible
+stages:
+  - id: draft
+    entry: true
+    route:
+      - to: review
+    system_prompt: Draft.
+    model: cursor/auto
+    io:
+      input:
+        schema:
+          type: object
+      output:
+        schema:
+          type: object
+          required: [verdict]
+          properties:
+            verdict:
+              type: string
+  - id: review
+    system_prompt: Review.
+    model: cursor/auto
+    io:
+      input:
+        schema:
+          type: object
+          required: [title]
+          properties:
+            title:
+              type: string
+      output:
+        schema:
+          type: object

package/examples/route-wiring-smoke-test/rejected/18-reject-nested-io.pipeline.yaml

@@ -0,0 +1,51 @@
+id: route-demo-reject-nested-io
+stages:
+  - id: draft
+    entry: true
+    route:
+      - to: review
+    system_prompt: Draft.
+    model: cursor/auto
+    io:
+      input:
+        schema:
+          type: object
+      output:
+        schema:
+          type: object
+          required: [title, metadata]
+          properties:
+            title:
+              type: string
+            metadata:
+              type: object
+              required: [source]
+              properties:
+                source:
+                  type: string
+  - id: review
+    system_prompt: Review.
+    model: cursor/auto
+    io:
+      input:
+        schema:
+          type: object
+          required: [title, metadata]
+          properties:
+            title:
+              type: string
+            metadata:
+              type: object
+              required: [source, owner]
+              properties:
+                source:
+                  type: string
+                owner:
+                  type: object
+                  required: [email]
+                  properties:
+                    email:
+                      type: string
+      output:
+        schema:
+          type: object

package/examples/route-wiring-smoke-test/rejected/19-reject-array-item-io.pipeline.yaml

@@ -0,0 +1,55 @@
+id: route-demo-reject-array-item-io
+schemas:
+  finding-id:
+    type: object
+    required: [id]
+    properties:
+      id:
+        type: string
+  finding-full:
+    type: object
+    required: [id, severity]
+    properties:
+      id:
+        type: string
+      severity:
+        type: string
+        enum: [low, medium, high]
+stages:
+  - id: draft
+    entry: true
+    route:
+      - to: review
+    system_prompt: Draft.
+    model: cursor/auto
+    io:
+      input:
+        schema:
+          type: object
+      output:
+        schema:
+          type: object
+          required: [findings]
+          properties:
+            findings:
+              type: array
+              minItems: 1
+              items:
+                $ref: "#/schemas/finding-id"
+  - id: review
+    system_prompt: Review.
+    model: cursor/auto
+    io:
+      input:
+        schema:
+          type: object
+          required: [findings]
+          properties:
+            findings:
+              type: array
+              minItems: 1
+              items:
+                $ref: "#/schemas/finding-full"
+      output:
+        schema:
+          type: object

package/examples/route-wiring-smoke-test/rejected/20-reject-closed-io.pipeline.yaml

@@ -0,0 +1,36 @@
+id: route-demo-reject-closed-io
+stages:
+  - id: draft
+    entry: true
+    route:
+      - to: review
+    system_prompt: Draft.
+    model: cursor/auto
+    io:
+      input:
+        schema:
+          type: object
+      output:
+        schema:
+          type: object
+          required: [title]
+          properties:
+            title:
+              type: string
+            extra:
+              type: string
+  - id: review
+    system_prompt: Review.
+    model: cursor/auto
+    io:
+      input:
+        schema:
+          type: object
+          additionalProperties: false
+          required: [title]
+          properties:
+            title:
+              type: string
+      output:
+        schema:
+          type: object

package/examples/route-wiring-smoke-test/rejected/21-reject-ref-io.pipeline.yaml

@@ -0,0 +1,42 @@
+id: route-demo-reject-ref-io
+schemas:
+  produced:
+    type: object
+    required: [title]
+    properties:
+      title:
+        type: string
+  consumed:
+    type: object
+    required: [title, extra]
+    properties:
+      title:
+        type: string
+      extra:
+        type: string
+  empty:
+    type: object
+stages:
+  - id: draft
+    entry: true
+    route:
+      - to: review
+    system_prompt: Draft.
+    model: cursor/auto
+    io:
+      input:
+        schema:
+          $ref: "#/schemas/empty"
+      output:
+        schema:
+          $ref: "#/schemas/produced"
+  - id: review
+    system_prompt: Review.
+    model: cursor/auto
+    io:
+      input:
+        schema:
+          $ref: "#/schemas/consumed"
+      output:
+        schema:
+          $ref: "#/schemas/empty"

package/examples/route-wiring-smoke-test/rejected/22-reject-if-unknown-field.pipeline.yaml

@@ -0,0 +1,33 @@
+id: route-demo-reject-if-unknown-field
+stages:
+  - id: triage
+    entry: true
+    route:
+      - to: page
+        if:
+          field: unknown_field
+          op: eq
+          value: high
+    system_prompt: Triage.
+    model: cursor/auto
+    io:
+      input:
+        schema:
+          type: object
+      output:
+        schema:
+          type: object
+          required: [severity]
+          properties:
+            severity:
+              type: string
+  - id: page
+    system_prompt: Page.
+    model: cursor/auto
+    io:
+      input:
+        schema:
+          type: object
+      output:
+        schema:
+          type: object

package/examples/route-wiring-smoke-test/rejected/23-reject-if-optional-field.pipeline.yaml

@@ -0,0 +1,32 @@
+id: route-demo-reject-if-optional-field
+stages:
+  - id: triage
+    entry: true
+    route:
+      - to: page
+        if:
+          field: severity
+          op: eq
+          value: high
+    system_prompt: Triage.
+    model: cursor/auto
+    io:
+      input:
+        schema:
+          type: object
+      output:
+        schema:
+          type: object
+          properties:
+            severity:
+              type: string
+  - id: page
+    system_prompt: Page.
+    model: cursor/auto
+    io:
+      input:
+        schema:
+          type: object
+      output:
+        schema:
+          type: object

package/examples/route-wiring-smoke-test/rejected/24-reject-if-empty-all.pipeline.yaml

@@ -0,0 +1,31 @@
+id: route-demo-reject-if-empty-all
+stages:
+  - id: triage
+    entry: true
+    route:
+      - to: page
+        if:
+          all: []
+    system_prompt: Triage.
+    model: cursor/auto
+    io:
+      input:
+        schema:
+          type: object
+      output:
+        schema:
+          type: object
+          required: [severity]
+          properties:
+            severity:
+              type: string
+  - id: page
+    system_prompt: Page.
+    model: cursor/auto
+    io:
+      input:
+        schema:
+          type: object
+      output:
+        schema:
+          type: object

package/examples/route-wiring-smoke-test/rejected/25-reject-if-gt-on-string.pipeline.yaml

@@ -0,0 +1,33 @@
+id: route-demo-reject-if-gt-on-string
+stages:
+  - id: triage
+    entry: true
+    route:
+      - to: page
+        if:
+          field: severity
+          op: gt
+          value: 1
+    system_prompt: Triage.
+    model: cursor/auto
+    io:
+      input:
+        schema:
+          type: object
+      output:
+        schema:
+          type: object
+          required: [severity]
+          properties:
+            severity:
+              type: string
+  - id: page
+    system_prompt: Page.
+    model: cursor/auto
+    io:
+      input:
+        schema:
+          type: object
+      output:
+        schema:
+          type: object

package/examples/route-wiring-smoke-test/rejected/26-reject-if-optional-nested.pipeline.yaml

@@ -0,0 +1,36 @@
+id: route-demo-reject-if-optional-nested
+stages:
+  - id: triage
+    entry: true
+    route:
+      - to: page
+        if:
+          field: customer.tier
+          op: eq
+          value: gold
+    system_prompt: Triage.
+    model: cursor/auto
+    io:
+      input:
+        schema:
+          type: object
+      output:
+        schema:
+          type: object
+          required: [customer]
+          properties:
+            customer:
+              type: object
+              properties:
+                tier:
+                  type: string
+  - id: page
+    system_prompt: Page.
+    model: cursor/auto
+    io:
+      input:
+        schema:
+          type: object
+      output:
+        schema:
+          type: object

package/examples/route-wiring-smoke-test/rejected/27-reject-if-on-loop.pipeline.yaml

@@ -0,0 +1,63 @@
+id: route-demo-reject-if-on-loop
+stages:
+  - id: plan
+    entry: true
+    route:
+      - to: implement
+    system_prompt: Plan.
+    model: cursor/auto
+    io:
+      input:
+        schema:
+          type: object
+      output:
+        schema:
+          type: object
+  - id: implement
+    route:
+      - to: review
+    system_prompt: Implement.
+    model: cursor/auto
+    io:
+      input:
+        schema:
+          type: object
+      output:
+        schema:
+          type: object
+  - id: review
+    route:
+      - to: submit
+      - type: loop
+        to: implement
+        max_replays: 2
+        on_max_replays: require_continue
+        replay_session: resume
+        if:
+          field: verdict
+          op: eq
+          value: pass
+    system_prompt: Review.
+    model: cursor/auto
+    io:
+      input:
+        schema:
+          type: object
+      output:
+        schema:
+          type: object
+          required: [verdict]
+          properties:
+            verdict:
+              type: string
+  - id: submit
+    replay_safe: false
+    system_prompt: Submit.
+    model: cursor/auto
+    io:
+      input:
+        schema:
+          type: object
+      output:
+        schema:
+          type: object

package/examples/route-wiring-smoke-test/rejected/29-reject-if-on-failed.pipeline.yaml

@@ -0,0 +1,46 @@
+id: route-demo-reject-if-on-failed
+stages:
+  - id: run-tests
+    entry: true
+    route:
+      - to: ship
+        on: [succeeded]
+      - to: hotfix
+        on: [failed]
+        if:
+          field: severity
+          op: eq
+          value: high
+    system_prompt: Run tests.
+    model: cursor/auto
+    io:
+      input:
+        schema:
+          type: object
+      output:
+        schema:
+          type: object
+          required: [severity]
+          properties:
+            severity:
+              type: string
+  - id: ship
+    system_prompt: Ship.
+    model: cursor/auto
+    io:
+      input:
+        schema:
+          type: object
+      output:
+        schema:
+          type: object
+  - id: hotfix
+    system_prompt: Hotfix.
+    model: cursor/auto
+    io:
+      input:
+        schema:
+          type: object
+      output:
+        schema:
+          type: object

package/examples/route-wiring-smoke-test/smoke-test.task.yaml

@@ -0,0 +1,4 @@
+id: route-smoke-test
+goal: Do the minimal amount of work each stage asks for — one or two sentences is enough.
+context: Route wiring smoke test — the point is exercising pipeline wiring, not the content.
+constraints: Docs only; no implementation code. Keep every stage's output short.

package/examples/route-wiring-smoke-test/stages/branch-a.yaml

@@ -0,0 +1,12 @@
+id: branch-a
+system_prompt: |
+  Branch A -- an external stage file loaded via `uses:`. One sentence is enough.
+  Then emit a success envelope via emit_stage_envelope with status: success, a short summary, artifacts: [], and payload: {}.
+model: cursor/auto
+io:
+  input:
+    schema:
+      type: object
+  output:
+    schema:
+      type: object