orchestrata_ultimate.verification
Reference › orchestrata_ultimate › verification
Verification Agent — Spec 035 (historical label: Spec 007b).
The Verification Agent (Spec 035, historically Spec 007b) is the part of Orchestrata that refuses to accept generated work on faith. It turns requirements into formal constraints, judges them mechanically with Prolog, steps the work through named checkpoints, validates proofs, reviews code deterministically, repairs common defects automatically, and escalates to a human when attempts run out. The orchestrator reaches it through its verification_gate. The curated narrative tells the story with diagrams; this page maps the modules.
The parts, by role:
- Vocabulary and settings: types and config.
- Requirements to constraints: requirements, with integrations for Intent Broker input and Redis state.
- Evaluation: constraints, checkpoints, proofs and the engine and feedback.
- Actors and messaging: agents, models, protocols, orchestration and session.
- Code review and repair: review (no LLM) and autofix.
- Boundary guards: edge_cases, impossibility and the escalation handler.
- Spec conformance, used project-wide: traceability (the
@tracesscanner and RTM), rtm_constraints, spec_completeness, implementation_scanner and _non_python_scan; the package root re-exports the spec-completeness and traceability API.
Control flows from a session through the engine: constraints are evaluated by Prolog, checkpoints advance or count attempts, and failures become feedback for the executor. There is no CLI. To start, read types, then the verification engine and constraints evaluator.
Curated narrative
The hand-written story of this package: orchestrata_ultimate.verification.
66 modules, 9,151 lines of code.
Subpackages
| Package | Modules | LOC |
|---|---|---|
agents |
4 | 323 |
autofix |
7 | 931 |
checkpoints |
4 | 275 |
config |
2 | 52 |
constraints |
3 | 274 |
edge_cases |
3 | 874 |
impossibility |
2 | 92 |
integrations |
3 | 194 |
models |
6 | 484 |
orchestration |
2 | 208 |
proofs |
2 | 146 |
protocols |
2 | 181 |
requirements |
4 | 422 |
review |
9 | 1,691 |
session |
2 | 169 |
verification |
3 | 205 |
Modules
| Module | Summary | LOC |
|---|---|---|
__init__ |
Verification Agent — Spec 035 (historical label: Spec 007b). | 34 |
_non_python_scan |
Non-Python evidence collection for :mod:implementation_scanner. |
380 |
escalation_handler |
Escalation handler — max attempts to human. | 74 |
implementation_scanner |
Scan a project's AST for evidence that spec requirements were implemented. | 733 |
rtm_constraints |
RTM integrity constraints — SPEC-033 REQ-033-C4, §9 B25. | 157 |
spec_completeness |
Spec completeness evaluation via Prolog. | 306 |
traceability |
Standalone traceability engine for spec verification. | 616 |
types |
Verification Agent type definitions. | 330 |