arch-audit

Enforce architectural boundaries by running automated checks that detect violations between core, domain, and composition-root layers. arch-audit applies eight predefined rules covering core-to-domain dependencies, service imports, page boundaries, and circular dependencies, then generates a comprehensive report identifying all violations.

Architecture audits check for eight types of violations: core importing from domain, unauthorized service imports, service boundary breaches, page boundary violations, model internal access, improper slice imports, saga imports, and circular dependencies across your codebase.

Run the audit scripts to detect violations and generate a report: execute run_all_checks.mjs to perform all eight architectural checks, then generate_report.mjs to compile results. The src/config directory is exempt as the composition root.

Yes, each architectural check has a dedicated script available. You can run specific checks for core-domain dependencies, service boundaries, pages, model internals, slice imports, sagas, or circular dependencies individually rather than running all checks together.

Each layer has distinct boundary rules: services enforce import restrictions and internal boundaries, pages prevent cross-page dependencies, and slices control inter-slice imports. Architecture audits validate all three separately to maintain proper feature isolation across your codebase.

No external dependencies are required. arch-audit runs deterministically through dedicated Node scripts without external packages, making it lightweight and immediately executable in any TypeScript project with a src/config composition root.