orchestrata_ultimate.verification.review
Reference › orchestrata_ultimate › verification › review
Deterministic code review checks -- no LLM needed.
The review package is the deterministic, no-LLM code reviewer of the verification subsystem. It runs numbered AST and text checks over a workspace's Python files and reports issues as tuples of check id, file and description. Several checks mirror rules that Orchestrata also enforces as commit gates, and the check modules link the matching pages under gates.
The parts: engine is the driver, choosing which checks run on source and test files. The four check modules group the checks by theme: checks_correctness (imports, completeness, entry point, dependencies), checks_structure (length, arguments, placeholders, error handling, nesting, god objects, stubs), checks_quality (type hints, mutable defaults, docstrings, line length) and checks_safety (security, environment access, mocks, TODOs, lint, test isolation). helpers provides parsing utilities, issue_triage sorts and caps issue strings by severity, and types defines the Issue alias.
Data flows from run_deterministic_review(workspace, files) into per-file checks and back as a flat issue list. The package __init__ re-exports the entry point. Start reading at the engine.
9 modules, 1,691 lines of code.
Modules
| Module | Summary | LOC |
|---|---|---|
__init__ |
Deterministic code review checks -- no LLM needed. | 31 |
checks_correctness |
Correctness checks: imports, file completeness, entry points, deps. | 196 |
checks_quality |
Quality checks: type hints, mutable defaults, docstrings, line length. | 207 |
checks_safety |
Safety checks: security, TODO comments, mocks, lint. | 365 |
checks_structure |
Structure checks: function length, args, placeholders, error handling. | 448 |
engine |
Review engine: orchestrates all deterministic checks. | 219 |
helpers |
Helper functions for deterministic code review checks. | 171 |
issue_triage |
Issue triage: sort and cap review issues by severity. | 50 |
types |
Type aliases for the deterministic review module. | 4 |