How realabidhasnine/codemonk works
CodeMonk is a repository-understanding platform intended to turn source code into structural knowledge and developer-facing architectural answers. Its documented workflow is repository ingestion, AST and dependency extraction, asynchronous indexing into graph and vector stores, hybrid context retrieval, AI reasoning, and delivery through developer interfaces. The tree shows service skeletons and shared components; many pipeline capabilities are described in the README but their implementations were not sampled. Those links reflect documented architecture, not verified runtime wiring.
Main entry points: search-service Hybrid retrieval · api-gateway API gateway · repository-service Repository service · code-analysis-service AST parsing
Components 20
Code ingestion
- Repository service
services/repository-service - AST parsing
services/code-analysis-service - Structure extractor
services/code-analysis-service
Knowledge and retrieval
- Kafka event bus
- Knowledge graph
- Vector store
- Hybrid retrieval
services/search-service - Graph queries
libs/common-core/src/main/java/com/codemonk/common/service/GraphQueryService.java - Impact analysis
services/knowledge-service
AI and delivery
- AI reasoning
services/ai-service - API gateway
services/api-gateway
Platform services
- Configuration server
services/config-server - Service discovery
services/discovery-server - Shared API errors
libs/common-core/src/main/java/com/codemonk/common/exception/GlobalExceptionHandler.java - Documentation records
libs/common-core/src/main/java/com/codemonk/common/service/DocumentationEntity.java - Documentation repository
services/repository-service/src/main/java/com/codemonk/repository/service/DocumentationRepository.java
Other components
- Developer
- Git repository
- Code LLM
- CLI, IDE, web
Connections 17
- Developer → Git repository: selects code
- Git repository → Repository service: ingests source
- Repository service → AST parsing: supplies files
- AST parsing → Structure extractor: parses structure
- Structure extractor → Kafka event bus: publishes events
- Kafka event bus → Knowledge graph: indexes relations
- Kafka event bus → Vector store: indexes embeddings
- Knowledge graph → Hybrid retrieval: provides relations
- Vector store → Hybrid retrieval: provides matches
- Hybrid retrieval → AI reasoning: assembles context
- AI reasoning → Code LLM: reasons with
- Code LLM → API gateway: returns insights
- API gateway → CLI, IDE, web: serves answers
- Knowledge graph → Graph queries: queries graph
- Knowledge graph → Impact analysis: supports analysis
- Developer → API gateway: submits questions
- Documentation repository → Documentation records: persists records
services/repository-service/src/main/java/com/codemonk/repository/service/DocumentationRepository.java