Skip to main content
ArcSight

← Homepage

Impact analysis example

What breaks when you change Keystone (packages/core)?

Real arc impact output on Keystone (packages/core) — same structure as the homepage demo. Know blast radius before you merge.

Project: Keystone (packages/core) · Score: 77.5/100 (Healthy architecture) · 179 modules · 536 edges

Engineering decision simulation

Validation procedure 01 · merge vs. hold before output

Before arc impact

You plan a change to a high fan-in module in Keystone (packages/core). Would you merge without knowing blast radius?

Typical answer: hold — need dependency context.

After arc impact

Structured output below: score, hotspots, corridors, and high-risk modules — same field schema as the homepage proof.

Decision: confirm hold, narrow change, or inspect paths first.

Published as part of the validation record. Run locally: arc impact <file-you-are-changing>

Architectural Risk Map

Where risk accumulates by control surface — drill down Surface → Substrate → Mechanism → Evidence.

See control surfaces →

Dependency evidence

Architecture visualization

Diagrams are generated from ArcSight analysis data. Dependency graph and risk map show key modules; subsystem view shows high-level structure.

Dependency graph
Dependency graph for this codebase
Subsystem architecture
Subsystem architecture for this codebase
Risk map
Risk map for this codebase

Architecture score & metrics

Score: 77.5/100 · Stability: 4/100 · Status: moderate_risk · Confidence: 100%

  • Dependency cycles: 41
  • Layer violations: 13
  • Duplicate authorities: 10

Modules to inspect

One row per module. Fan-in is direct dependents. Blast radius is downstream modules reachable from that file.

Fan-in, direct dependents
  • src/types93 dependents
  • src21 dependents
  • src/lib/core/initialise-lists20 dependents
  • src/lib/core/utils18 dependents
  • src/types/utils13 dependents
  • src/lib/core/graphql-errors11 dependents
  • src/lib/utils4 dependents
Blast radius, downstream modules
  • src/lib/core/utils144 modules
  • src/lib/core/graphql-errors144 modules
  • src/lib/utils144 modules
  • src/types143 modules
  • src143 modules
  • src/lib/core/initialise-lists143 modules
ModuleFan-inBlastRisk
src/lib/core/utils18144CRITICAL
src/lib/core/graphql-errors11144CRITICAL
src/lib/utils4144HIGH
src/types93143CRITICAL
src21143CRITICAL
src/lib/core/initialise-lists20143CRITICAL
src/types/utils13CRITICAL

Architectural gravity centers

  • src/lib/core/utils— concentrates too many responsibilities
  • src/lib/core/utils— shared utility hub
  • src/lib/core/utils— crosses a layer boundary
  • src/lib/core/graphql-errors— concentrates too many responsibilities
  • src/lib/core/graphql-errors— shared utility hub

CLI workflow

Scan → Fix → Finish → Watch. Nothing else required.

  • arc scanFind issues
  • arc fixApply fixes
  • arc finishResolve remaining
  • arc watchKeep clean

More commands (explain, impact, guard…) →

Key takeaways

  • •Structural scan reports dependency cycles — inspect impact paths before refactors that cross module boundaries.
  • •High fan-in modules are change-risk zones; run arc explain <path> before refactoring.
  • •Run the full workflow (analyze, hotspots, explain, impact, snapshot, drift) in your repo for deterministic architecture insights.

Run ArcSight on your repo

Install the CLI and run analyze, then hotspots and explain for the same workflow.

npm install -g arcsight
arc analyze
Install ArcSight →

This case study is generated from ArcSight analysis data. View short analysis. View all analyses