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

Dependency diagram

Package dependency diagram orchestrata_ultimate.verification.review