How harsha-rvceian/devtrace works
DevTrace records software-development provenance: interactions, decisions, alternatives, evidence, commits, and code changes. The main workflow captures project activity, extracts proposed decisions from conversation text, leaves approval to a developer, stores supported links, and presents history in the dashboard. Git capture and project timelines are additional documented capabilities. The sampled files show the API, NLP entry point, database session, and frontend wiring; several domain routes and integrations are represented from the README and source index, so their internal call paths are not expanded.
Main entry points: main.py FastAPI Application · App.jsx Dashboard App · rule_engine.py Rule Engine · pipeline.py NLP Pipeline
Components 29
Capture and API
- FastAPI Application
app/main.py - Project API
app/api/routes/projects.py - Interaction API
app/api/routes/interactions.py - Git Collector
integrations/git/collector.py - Diff Parser
integrations/git/diff_parser.py - NLP API
app/api/routes/nlp.py - User Resolution
app/api/dependencies.py
Decision Extraction
- NLP Pipeline
nlp/pipeline.py - Rule Engine
nlp/rule_engine.py - Optional LLM Engine
nlp/llm_engine.py - Extraction Data
nlp/models.py - Decision Extraction
nlp/decision_extractor.py - Rationale Extraction
nlp/rationale_extractor.py - Alternative Extraction
nlp/alternative_extractor.py
Provenance Records
- Database Sessions
app/db/session.py - PostgreSQL
app/models/entities.py - Decision Records
app/services/decision_service.py - Alternative Records
app/services/alternative_service.py - Code Provenance
app/services/provenance_service.py - Project Timeline
app/services/timeline_service.py
Developer Dashboard
- Dashboard App
frontend/src/App.jsx - REST Client
frontend/src/api/client.js - Candidate Review
frontend/src/pages/CandidateStudio.jsx - Provenance View
frontend/src/pages/Provenance.jsx - Decision View
frontend/src/pages/Decisions.jsx - Timeline View
frontend/src/components/Timeline.jsx
Other components
- Developer
- AI Coding Tool
- Git Repository
Connections 33
- Developer → FastAPI Application: uses
README.md - AI Coding Tool → Interaction API: submits interaction
README.md - Git Repository → Git Collector: provides history
README.md - FastAPI Application → Project API: registers routes
app/main.py - FastAPI Application → Interaction API: registers routes
app/main.py - FastAPI Application → NLP API: registers routes
app/main.py - Project API → User Resolution: resolves user
app/api/routes/projects.py - Interaction API → NLP Pipeline: extracts candidates
app/api/routes/interactions.py - Git Collector → Diff Parser: parses diffs
integrations/git/collector.py - Git Collector → FastAPI Application: sends commit data
README.md - NLP API → NLP Pipeline: requests extraction
- NLP Pipeline → Rule Engine: runs rules
nlp/pipeline.py - NLP Pipeline → Optional LLM Engine: optionally runs LLM
nlp/pipeline.py - Rule Engine → Extraction Data: creates candidates
nlp/rule_engine.py - Optional LLM Engine → Extraction Data: validates candidates
nlp/llm_engine.py - Rule Engine → Decision Extraction: uses extraction
nlp/rule_engine.py - Rule Engine → Alternative Extraction: uses extraction
nlp/rule_engine.py - Rule Engine → Rationale Extraction: uses extraction
nlp/rule_engine.py - FastAPI Application → Database Sessions: opens sessions
- Database Sessions → PostgreSQL: connects to
app/db/session.py - FastAPI Application → PostgreSQL: stores provenance
README.md - FastAPI Application → Decision Records: coordinates decisions
- FastAPI Application → Alternative Records: coordinates alternatives
- FastAPI Application → Code Provenance: links code changes
- FastAPI Application → Project Timeline: builds timelines
- Developer → Dashboard App: reviews history
README.md - Dashboard App → REST Client: fetches dashboard data
frontend/src/App.jsx - Candidate Review → REST Client: submits candidates
frontend/src/pages/CandidateStudio.jsx - REST Client → FastAPI Application: calls REST API
frontend/src/api/client.js - Dashboard App → Candidate Review: shows review
frontend/src/App.jsx - Dashboard App → Provenance View: shows provenance
frontend/src/App.jsx - Dashboard App → Decision View: shows decisions
frontend/src/App.jsx - Dashboard App → Timeline View: shows timeline
frontend/src/App.jsx