vera-chimeras

Purpose

Provide a workflow orchestration layer over vera-subagents.

Current implemented scope

• YAML-defined Chimera discovery
• validation and compilation of the current supported DSL subset
• foreground and background execution through the chimera tool
• agent, check, decision, parallel, done, and fail steps
• explicit transitions through next, on.success, on.failure, and decision.decide[*]
• bounded parallel fan-out through parallel with inline agent / check branches
• bounded retries and loop limits
• workspace artifact persistence under .chimera/runs/<runId>
• persisted resume from saved run artifacts through resumeRunId
• run status, cancellation, /chimeras, and TUI run details

Definition discovery

Chimera definitions are loaded from:

• ~/.pi/agent/chimeras/*.yaml
• nearest .pi/chimeras/*.yaml walking up from current cwd

Current DSL status

The exact supported surface is maintained in:

• SUPPORT-MATRIX.md — generated implementation-status reference
• DSL-manual.md — practical authoring guide for the current implementation

visable is optional and defaults to true. When set to false, Vera does not see the Chimera in its injected catalog and cannot call it through the chimera tool by name.

Registered tools

• chimera — run one named Chimera workflow in the foreground or background
• chimera_status — inspect queued, running, and recently completed Chimera runs in the current session
• chimera_cancel — cancel one background Chimera run or all active background Chimera runs

Registered commands / UI

• /chimeras — show a Vera-style detailed Chimera subsystem report
• /chimeras cancel <runId|all> — cancel one background Chimera run or all active background Chimera runs
• TUI session status entry chimeras — compact live indicator for current-session Chimera runs

User-facing references

• DSL-manual.md — practical DSL manual for authors, with current-support sections generated from the support matrix
• SUPPORT-MATRIX.md — generated implementation-status reference for the current DSL surface
• docs/README.md — guide to the design, schema, and roadmap documents kept inside the package
• examples/example-full-dsl-commented.yaml — hidden full-surface reference example covering the supported Chimera syntax with detailed comments

Internal verification assets

• fixtures/support-matrix.mjs — machine-readable feature matrix, DSL support inventory, and fixture set
• scripts/conformance.mjs — data-driven conformance runner built from that matrix
• scripts/smoke.mjs — package-level tool/runtime smoke coverage
• scripts/e2e.mjs — end-to-end runtime-flow coverage using read-only DeepSeek-backed test subagents and temporary test Chimeras
• scripts/render-support-matrix.mjs — generates SUPPORT-MATRIX.md and refreshes generated support sections inside DSL-manual.md

Verification

• npm run support-matrix
• npm run smoke
• npm run conformance
• npm run e2e

Loaded through agent/settings.json as ./packages/vera-chimeras.