@aiready/visualizer

AIReady Spoke: Interactive graph visualization for AIReady analysis results.

Overview

This package provides tools to transform AIReady analysis results into interactive force-directed graph visualizations. It helps teams see architectural bottlenecks and context fragmentation visually.

🏛️ Architecture

                    🎯 USER
                      │
                      ▼
         🎛️  @aiready/cli (orchestrator)
          │     │     │     │     │     │     │     │     │     │
          ▼     ▼     ▼     ▼     ▼     ▼     ▼     ▼     ▼     ▼
        [PAT] [CTX] [CON] [AMP] [DEP] [DOC] [SIG] [AGT] [TST] [CTR]
          │     │     │     │     │     │     │     │     │     │
          └─────┴─────┴─────┴─────┴─────┴─────┴─────┴─────┴─────┴─────┘
                               │
                               ▼
                      🏢 @aiready/core

Legend:
  PAT = pattern-detect        CTX = context-analyzer
  CON = consistency           AMP = change-amplification
  DEP = deps-health           DOC = doc-drift
  SIG = ai-signal-clarity     AGT = agent-grounding
  TST = testability           CTR = contract-enforcement
  VIZ = @aiready/visualizer ★  (support package — renders analysis results, not a scorer)
  ★   = YOU ARE HERE

Features

• Graph Builder: Transforms analysis data into graph structures.
• Force-Directed Layout: Physics-based graph layout using d3-force.
• Node Details: Click nodes to see detailed metrics (LOC, token cost, etc.).
• Issue Overlay: Visualize detected issues directly on the dependency graph.

Installation

pnpm add @aiready/visualizer

Usage

aiready visualise

License

MIT