arcvision 0.2.27 → 0.2.29

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arcvision",
-  "version": "0.2.27",
+  "version": "0.2.29",
   "description": "ArcVision CLI - Architectural Governance and Invariant Detection Tool",
   "main": "src/index.js",
   "bin": {
@@ -69,4 +69,4 @@
     "test": "tests"
   },
   "type": "commonjs"
-}
+}

package/src/arcvision_context/README.md

@@ -0,0 +1,103 @@
+# ArcVision System Context Artifact
+
+
+## What This Is [arcvision.context.json](./arcvision.context.json)
+
+This file is the **canonical structural context** of this codebase.
+It represents how the system actually works — not how it is described.
+
+It is generated directly from source code by ArcVision.
+
+## What This Replaces
+
+This artifact replaces:
+- Manual repository scanning
+- Tribal knowledge held by senior engineers
+- Re-explaining the system to new developers
+- Re-prompting LLMs with partial or incorrect context
+- Guessing blast radius of changes
+
+## When You Must Use This
+
+Use this artifact when:
+- Onboarding a new developer
+- Prompting an AI assistant about this codebase
+- Making architectural changes
+- Investigating unexpected behavior
+- Assessing risk before modifying core modules
+
+## What This Artifact Contains
+
+- Canonical module and dependency graph
+- Execution and data flow relationships
+- Structural roles (service, store, boundary, etc.)
+- Invariants inferred from the system
+- Impact metrics (blast radius, coupling)
+- Authority core identification
+- Hidden coupling detection
+- Architectural archetype classification
+- Analysis completeness metrics
+
+## Determinism & Trust
+
+- Generated from commit: 96ba04214b910ff8d341938065b71d9e8865a8c3
+- Generation timestamp: 2026-02-22T06:41:13.816Z
+- Tool version: 0.2.28
+- Deterministic: same input → same output
+- Explicit assumptions listed inside the artifact
+
+If this artifact conflicts with human memory, **trust the artifact**.
+
+## Structural Context Hubs
+
+The following files have the highest blast radius and represent critical structural hubs in the system:
+
+- **core/invariant-registry.ts**
+  - Blast Radius: 8 files (11.94% of codebase)
+  - Risk: Changes here may silently propagate across the system.
+
+- **core/invariant-hooks.js**
+  - Blast Radius: 3 files (4.48% of codebase)
+  - Risk: Acts as a coordination layer between components.
+
+- **core/pattern-matcher.js**
+  - Blast Radius: 3 files (4.48% of codebase)
+  - Risk: Modifications can cause widespread inconsistencies.
+
+
+
+## How to Use With AI
+
+When prompting AI tools, include this file as system context.
+Do not ask the AI to infer architecture without it.
+
+## When to Regenerate
+
+Regenerate this artifact when:
+- Core modules change
+- New services are added
+- Dependency structure shifts
+
+Run:
+
+```
+arcvision scan --upload
+```
+
+## Source of Truth
+
+This artifact is the **source of truth** for system structure.
+All explanations, decisions, and AI reasoning should reference it.
+
+Some execution script invocations are dynamically assembled at runtime and may not be statically traceable; such scripts are included 
+as execution boundaries without guaranteed call-site resolution
+
+## Architecture Intelligence Summary
+
+_Generated by ArcVision — derived from structural graph analysis._
+
+- **Most Central Module**: `core/scanner.js` (centrality score: 45.8)
+- **Coupling Hotspot**: invariant-integration-example.js + invariant-registry.ts + invariant-hooks.js
+- **Risk Score**: 2.0 / 10 [low]
+- **Most Fragile Module**: `invariant-registry.ts` — fragility score: 15
+- **Top Recommendation**: Add an abstraction boundary around "invariant-registry.ts" — 15 modules depend on it with no outbound isolation.

package/src/arcvision_context/architecture.authority.ledger.json

@@ -0,0 +1,6 @@
+{
+  "schema_version": "1.0",
+  "system_id": "src",
+  "created_at": "2026-02-21T13:00:38.568Z",
+  "ledger": []
+}