ArcVision CLI

Architectural Governance and Invariant Detection Tool

ArcVision is a powerful 4-pass structural analysis engine designed to map, monitor, and enforce architectural integrity in modern codebases.

Key Features

• 4-Pass Structural Analysis: Deeply analyzes facts, semantics, structural roles, and signals.
• Invariant Detection: Automatically identifies architectural constraints and assertions.
• Change Impact Gating: Evaluates the blast radius and architectural risk of proposed code changes.
• Authority Ledger: Maintains a verifiable audit trail of architectural decisions and overrides.
• Dashboard Integration: Syncs architectural maps and health metrics to the ArcVision Dashboard.

Installation

npm install -g arcvision

Quick Start

1. Scan a repository

Generate a comprehensive architectural context and visualize your system structure.

arcvision scan .

2. Evaluate changes

Assess the impact of changes against established invariants.

arcvision evaluate . --simulate-changes src/critical-module.js

3. Record decisions

Manage architectural decisions through the Authority Ledger.

arcvision override --event-id <event-id> --reason "Intentional architectural shift" --owner "arch-lead"

Commands

• scan <directory>: Analyze repository and generate arcvision.context.json.
• evaluate <directory>: Run Authoritative Change Impact Gate (ACIG).
• diff <old> <new>: Compare two architectural snapshots.
• ledger: Manage and audit architectural overrides.
• link <token>: Connect your local environment to the ArcVision Dashboard.

Architectural Health Assessment

ArcVision computes an architectural health score based on:

• Invariant coverage
• Coupling degree
• Criticality signals
• Structural complexity

License

MIT