arch-lint

Architecture linter for Rust projects and cross-language layer enforcement.

What it is

arch-lint catches the architectural mistake a PR review already caught once, every time it happens again. Declare layering, scope, and dependency rules in arch-lint.toml — no Rust code required — or write a custom Rule when TOML is not enough. Rules run inside cargo test via arch_lint::check!(), from the cargo arch-lint CLI, or embedded through the Session SDK. A dual engine covers Rust (syn) today and other languages (Tree-sitter, Kotlin first) for cross-language layering.

Install

CLI: cargo install --locked arch-lint-cli — installs both arch-lint and cargo-arch-lint (so cargo arch-lint ... works too).
cargo test route: cargo add --dev arch-lint, then add arch_lint::check!(); to a test file (see Quick Start below).
Prebuilt binaries / cargo binstall: not yet — tracked in #14.

Quick Start (30 seconds)

cargo add --dev arch-lint

// tests/architecture.rs
arch_lint::check!();  // expands to a #[test] function

cargo install --locked arch-lint-cli
cargo arch-lint init

This creates…

score = signal / reach signal = 0.25·commit_velocity // commits in last 90 days (cap 30) + 0.20·contributor_work // unique authors × velocity (cap 100) + 0.20·issue_resolution // closed ÷ total issues + 0.20·fork_ratio // forks ÷ stars (proxy for real usage) + 0.10·release_cadence // releases in 90 days (cap 3) + age_bonus // +0 to +0.30 after 6 months + homepage_bonus // +0.05 if homepage is set reach = log₁₀(stars + watchers + 10)█

health = 0.35·recency // days since last commit (90d decay) + 0.25·cadence // commit rhythm consistency + 0.20·issue_health // closed ÷ total issues + 0.20·pr_health // merged ÷ total PRs█

Healthy 80 – 100 active, responsive, regular releases Stable 60 – 79 maintained, steady, no alarms Quiet 40 – 59 slowing down — watch this one At Risk 0 – 39 going dark · candidate for rescue█

solo_builder one person holds > 80% of commits (last 180d) needs_contributors has open "help wanted" or "good first issue" labels hidden_gem < 100 stars · active in last 3 months · documented legacy_hero repo > 5 years old · committed this year fork_magnet forks/stars > 0.5 · used as template or dependency release_machine 5+ releases in the last 90 days under_pressure > 10 open issues · ≤ 2 contributors · health ≥ 60 community_watch watchers > stars · devs tracking before the public community_hub GitHub Discussions enabled · > 20 discussions funded maintainer has active funding channel█