Back to all features
orchestration · node: test #1

Testing Pipeline Nodes

A Test node is a first-class node you drop into the chain. It carries an assertion the run must satisfy to continue — so you see the whole verification contract before a model touches a single line of code.

Planning assert before run · gates the chain
what it is

An assertion, wired in as a node.

Most agents "test" after the model has written and run code — you find out it was wrong once the damage is done. DISPATCH inverts that. A Test node carries a plain-language instruction the upstream models read, and an assertion the run must satisfy to continue. Four fields:

instruction

Plain-language intent the upstream models read as part of their brief — "auth must reject an expired token". They plan toward it.

assertion

A concrete check on any output — exit_code == 0, contains("401"), schema.valid, or a graded rubric. Pass or fail, nothing fuzzy.

target

Which upstream node it inspects — the output of Create, the diff from Apply, the plan from Plan.

gate

On fail it can block, loop back to the producing node, or branch to repair — like any control edge.

how it works

Place, instruct, gate.

Output flows in, a verdict flows out — like any node, except its job is to assert, not generate.

01

Drop it in the chain

Place NODE: TEST #1 after any node you want verified — between Create and Apply, or after a Merge. It wires top-to-bottom like the rest.

02

Instruct the models

Write the test intent in plain language. Upstream Plan and Create nodes read it as part of their brief and build toward passing it — testable-by-design.

03

Gate the downstream

At run time the node evaluates its assertion. Pass → control flows on. Fail → it blocks, loops back, or branches to a repair node. Deploy never sees unverified work.

interactive · the chain in motion

Run the chain. Watch the test gate it.

Toggle whether Create produced passing output, then press Run. The gate either lets Deploy through, or loops back to repair — Deploy never sees unverified work.

execution chain idle
Initialisertrigger
Planreads test #1
Createdraft
TEST #1exit_code == 0
Deploygated
awaiting run
// press Run chain — TEST #1 will assert before Deploy executes
Back to all features