How joseph-k-iype/arch-scan works
Archiscan scans Git repositories into versioned, evidence-backed architecture snapshots, which users browse, compare, export, correct, and attest in a React dashboard. The principal backend workflow acquires Git objects, extracts and resolves facts, optionally investigates bounded claims with an LLM, then publishes a snapshot. The graph also preserves documented agent/trace, webhook, MCP, and human-review capabilities. Relationships are limited to excerpted calls, SOURCE INDEX references, or README statements; some capability implementations were not sampled, so their links cite documentation rather than implying inspected internals.
Main entry points: scanner.py Scan orchestration · app.py REST API · llm.py LLM investigation · App.tsx Workspace dashboard
Components 24
Scan pipeline
- Git acquisition
backend/git.py - Scan orchestration
backend/scanner.py
Architecture facts
- Static extraction
backend/extract.py - Pattern catalog
backend/catalog.py - Logical analysis
backend/architecture_analysis.py - LLM investigation
backend/llm.py
Platform services
- Extraction artifacts
backend/storage.py - Versioned fact store
backend/models.py - REST API
backend/app.py - Graph and snapshot queries
backend/services.py - Identity and access
backend/auth.py - Review operations
backend/app.py
Dashboard
- Workspace dashboard
src/App.tsx - API client
src/api.ts - Architecture explorer
src/components/ArchitectureExplorer.tsx - Graph rendering
src/components/ArchitectureGraph.tsx
Integrations
- Claude adapter
backend/claude_investigator.py - GitHub webhooks
backend/app.py - MCP server
backend/mcp_server.py - LLM gateway
backend/gateway.py - Agent observations
backend/app.py
Other components
- Repository reviewer
- Git hosting
- OpenAI-compatible endpoint
Connections 27
- Repository reviewer → Workspace dashboard: uses
README.md - Workspace dashboard → API client: requests data
src/App.tsx - Workspace dashboard → Architecture explorer: opens explorer
src/App.tsx - Architecture explorer → API client: loads graph
src/components/ArchitectureExplorer.tsx - Architecture explorer → Graph rendering: renders diagram
- API client → REST API: calls REST
README.md - REST API → Identity and access: authorizes requests
backend/app.py - REST API → Scan orchestration: starts scans
backend/app.py - Scan orchestration → Git acquisition: acquires commit
backend/scanner.py - Git hosting → Git acquisition: supplies objects
README.md - Scan orchestration → Static extraction: extracts blobs
backend/scanner.py - Scan orchestration → Extraction artifacts: caches artifacts
backend/scanner.py - Static extraction → Pattern catalog: recognizes patterns
README.md - Scan orchestration → LLM investigation: investigates claims
backend/scanner.py - Scan orchestration → Logical analysis: builds logical layers
backend/scanner.py - LLM investigation → Claude adapter: delegates optionally
backend/llm.py - LLM investigation → OpenAI-compatible endpoint: judges claims
README.md - Scan orchestration → Versioned fact store: publishes snapshot
README.md - REST API → Graph and snapshot queries: queries graph
backend/app.py - Graph and snapshot queries → Versioned fact store: reads facts
backend/services.py - REST API → Review operations: supports review
README.md - Repository reviewer → Review operations: corrects and attests
README.md - REST API → GitHub webhooks: receives pushes
README.md - GitHub webhooks → Scan orchestration: triggers scans
README.md - Repository reviewer → MCP server: uses authenticated tools
README.md - LLM gateway → OpenAI-compatible endpoint: forwards requests
README.md - REST API → Agent observations: imports observations
README.md