pacta 0.0.5

A Python tool for enforcing and visualizing software architecture.

Architecture Insights, Governance & Versioned Design

PyPI • Docs • Issues

---

Warning: Experimental. Expect breaking changes until release 0.1.0

Pacta turns software architecture into versioned, queryable data — so teams can see, compare, and reason about architectural change over time, not just block violations.

pip install pacta

Supported languages:

• Python
• Java (coming soon)
• Go (coming soon)
• C# (coming soon)

Why?

Codebases rot. Architecture degrades through small changes no one tracks. Pacta turns architecture into something measurable, reviewable, and enforceable — catching drift early, not months later.

What it does

• Architecture snapshots — version your architecture like code
• History & trends — track how dependencies, coupling, and violations evolve over time
• Diffs — compare architectural states like Git commits
• Metrics & insights — nodes, edges, layers, instability, drift
• Rules & governance — express architectural intent and enforce it incrementally
• Baseline mode — govern change without being blocked by legacy debt

Think of Pacta like Git for architecture

Git	Pacta
git add	pacta snapshot save — capture an architectural snapshot
git commit --verify	pacta check — evaluate rules against a snapshot
git commit	pacta scan — snapshot + check in one step
git log	pacta history — timeline and trends of architectural states
git diff	pacta diff — compare two snapshots
branch protection	rules.pacta.yml — governance that prevents drift

See the Getting Started guide for a full walkthrough.

Docs

• CLI Reference
• Architecture Model
• Rules DSL

Roadmap (short)

• Open-source CLI and analysis engine
• Content-addressed snapshots with history tracking
• Trend analysis with chart export
• Architecture visualization (Mermaid, D2)
• Health metrics (drift score, instability)
• Future: Architecture Intelligence Layer:
  • Cross-repository insights
  • Historical trend analysis
  • Team-level governance and reporting

License

Apache-2.0. See LICENSE.