How datomic/codeq works
Key Components to Include:
Core System Components
• Git Repository Interface
• Datomic Database
• Code Analysis Engine
• Import Pipeline
Main Architectural Flow
A. Input Layer:
• Git Repository (external)
• Git Shell Interface (for executing git commands)
B. Processing Layer:
• Import Pipeline (from src/datomic/codeq/core.clj)
• Code Analyzers (from src/datomic/codeq/analyzers/)
• Specifically highlight the Clojure Analyzer (analyzers/clj.clj)
C. Storage Layer:
• Datomic Free Database
D. Integration Points:
• Datomic Peer Connection
• REST Service Interface (optional component)
Design Guidelines:
• Git repo → Import Pipeline
• Import Pipeline → Analyzers
• Analyzers → Datomic Database
• Datomic Peer/REST → Database
Specific technical details
• Clojure implementation
• Datomic Free protocol
• REST service port (8080)
• Memory requirements (1g as mentioned in README)
Incremental nature of the import process
• How new commits are detected and processed
• Incremental analysis pipeline
Monitoring/output components
• Progress tracking
• Analysis status reporting
Configuration points
• Memory settings
• Database connection parameters
• File type analysis mappings
Level of Detail: