How gitbyjay25/hackvilla-uk04 works
Nexarch reconstructs production architecture from SDK-captured runtime spans, analyzes the resulting dependency graph, and presents issues and alternative workflows for comparison. The primary path runs from application instrumentation through telemetry ingestion and analysis to dashboard or MCP access. The README documents SDK observation, graph reconstruction, issue detection, workflow alternatives, and comparative analysis; sampled code confirms ingestion, streaming, reasoning, and MCP entry points. Several service and dashboard implementations are unsampled, so their internal wiring is not inferred here.
Main entry points: pipeline.py Streaming pipeline · main.py FastAPI application · ingest.py Telemetry ingestion · langgraph_pipeline.py Workflow reasoning
Components 21
Runtime observation
- SDK tracing
nexarch-sdk/nexarch/tracing/span.py - Library hooks
nexarch-sdk/nexarch/instrumentation - HTTP exporter
nexarch-sdk/nexarch/exporters/http.py
Ingestion and streaming
- FastAPI application
Server/main.py - Telemetry ingestion
Server/api/ingest.py - Span persistence
Server/services/ingest_service.py - Platform database
Server/db/models.py - Streaming pipeline
Server/streaming/pipeline.py - Graph transforms
Server/streaming/transforms/graph_builder.py - Live updates
Server/streaming/websocket.py
Architecture intelligence
- Workflow reasoning
Server/reasoning/langgraph_pipeline.py - Issue rules
Server/reasoning/rules.py - Graph analysis
Server/reasoning/graph_analysis.py - Workflow generation
Server/services/workflow_generator.py - Project analytics
Server/services/project_analytics_service.py
Product interfaces
- Web dashboard
frontend/src/app/dashboard/page.js - Frontend API client
frontend/src/lib/api-client.js
External access
- MCP server
Server/mcp_server/server.py - Architecture tools
Server/mcp_server/tools.py
Other components
- Instrumented application
- Team member
Connections 16
- Instrumented application → Library hooks: runs with
- Library hooks → SDK tracing: captures spans
- SDK tracing → HTTP exporter: exports telemetry
- HTTP exporter → Telemetry ingestion: posts spans
- FastAPI application → Telemetry ingestion: registers routes
- Telemetry ingestion → Span persistence: stores spans
- Span persistence → Platform database: writes spans
- FastAPI application → Streaming pipeline: starts pipeline
- Streaming pipeline → Graph transforms: builds graph tables
- Streaming pipeline → Live updates: pushes updates
- Workflow reasoning → Issue rules: detects issues
- Workflow reasoning → Graph analysis: analyzes graph
- Team member → Web dashboard: views insights
- Web dashboard → Frontend API client: requests data
- Frontend API client → FastAPI application: calls endpoints
- MCP server → Architecture tools: dispatches tools