Skip to main content
Give a recipe its brief, workspace, expected files, test command and engine seats. It returns a job for run from @obversa/runtime.

Install

Install the engine plugins whose seats you want to use. Node.js 22.12 or later is required.

Choose a recipe

Every configuration includes TeamInput: brief, workspace, files and test. The TestCommand record names a command, its args and an optional timeoutMs. A ReviewerSeat names a reviewer, its seat and an optional review scope. The TeamSeat contract belongs to @obversa/api. Complete runnable files are in examples/teams/writer-reviewer-pair.ts, examples/teams/threshold-panel.ts and examples/teams/feature-delivery.ts.

Write your own stages

Use workflow, stage, person and briefFromFile from @obversa/runtime when you want to declare your own roles and stages. The runtime package page contains the complete example and field reference. These builders are not exports of @obversa/builtin-workflows.

Review decisions

outcomeFromAgentText reads a reviewer’s JSON decision and turns it into a pass or findings for the named target. INVALID_TEAM_DECISION identifies an invalid decision. Both are re-exported from @obversa/runtime/workflow-support.

Offline example

This complete file runs the writer, a real Node check and the reviewer offline. The scripted engines write and inspect one temporary file. The example checks the outcome and removes its workspace. examples/builtin-workflows.ts, in full:

Source

packages/builtin-workflows in the repository. The package uses the runtime to execute jobs and API contracts to describe engine seats.