test-codebase-integrity

Validate LangGraph routing and imports by running a ten-test integration suite that checks agents, forecasting, coordination, and data models, returning a GO/NO-GO decision with remediation steps. This pre-merge validation catches import errors and verifies state machine coherence before syncing code.

A codebase integrity go/no-go check is an automated validation process that runs integration tests to surface import errors, graph routing issues, and dataclass instantiation problems. It returns a clear decision and actionable auto-suggestions to ensure code health before merging or rebasing.

You can filter integration tests to specific modules including agents, forecasting, coordination, and data_models. This targeted debugging capability allows you to isolate and validate individual components of the LangGraph state machine instead of running the full suite every time.

Get machine-readable diagnostics by enabling the optional JSON output format during the integration test run. This provides structured diagnostic data detailing import failures and routing issues, making it suitable for automated CI checks and pipeline processing.

Codebase integrity validation requires numpy as its only dependency to execute the test suite. The environment must have numpy installed to run the diagnostic scripts that evaluate LangGraph graph routing and data model interactions.

LangGraph state machine failures after a branch rebase often stem from broken imports or incoherent graph routing. Running an integration test suite identifies these specific dataclass instantiation and routing issues, providing diagnostic auto-suggestions to fix them before merging.