How ouzayr/utilities works
The tree contains several independent products rather than one integrated application; no README was provided to establish a single product or cross-project wiring. The graph focuses on the substantial projects represented in the tree and sampled source: code-cartographer, REFRAG, DailyPlanner, and sql-utility. Code Cartographer supports repository scanning and analysis views; REFRAG manages documents and answers retrieval-grounded queries; DailyPlanner manages dated tasks; sql-utility provides database inspection and checks. Links among unsampled subsystems are omitted where their callers could not be verified.
Main entry points: refrag_service.py Retrieval and refinement · routes.py Document and query API · AppDbContext.cs Analysis store · page.tsx Document screens
Components 25
Code Cartographer
- Analysis views
code-cartographer/apps/web/src/app/app.routes.ts - API endpoints
code-cartographer/apps/api/Endpoints - Analysis store
code-cartographer/apps/api/Db/AppDbContext.cs - .NET scanner
code-cartographer/apps/scanner-dotnet/SolutionScanner.cs - Angular scanner
code-cartographer/apps/scanner-angular/src/scanner.ts - Scan comparison
code-cartographer/apps/api/Diff/DiffEngine.cs - Dependency traversal
code-cartographer/apps/api/Flow/FlowEngine.cs
REFRAG
- Document screens
REFRAG/frontend/src/app/documents/page.tsx - Document and query API
REFRAG/backend/app/api/routes.py - Document service
REFRAG/backend/app/services/document_service.py - Retrieval and refinement
REFRAG/backend/app/services/refrag_service.py - Vector index
REFRAG/backend/app/services/chroma_service.py - Embeddings
REFRAG/backend/app/services/embedding_service.py - Language model client
REFRAG/backend/app/services/llm_service.py
DailyPlanner
- Task views
DailyPlanner/client/src/App.tsx - Task client store
DailyPlanner/client/src/lib/storage.ts - Task routes
DailyPlanner/server/routes.ts - Task persistence
DailyPlanner/server/storage.ts - Task database
DailyPlanner/server/db.ts
SQL Utility
- SQL API
sql-utility/apps/api/sqlutil/main.py - SQL endpoints
sql-utility/apps/api/sqlutil/routes - Schema checks
sql-utility/apps/api/sqlutil/checks/engine.py - Schema model
sql-utility/apps/api/sqlutil/introspect/schema_model.py
Other components
- Engineer
- Ollama
Connections 19
- Engineer → Analysis views: uses views
- Analysis store → Scan comparison: reads scans
- Analysis store → Dependency traversal: reads graph
- Engineer → Document screens: uses screens
- Document screens → Document and query API: requests data
- Document and query API → Document service: manages documents
- Document and query API → Retrieval and refinement: dispatches queries
- Retrieval and refinement → Vector index: retrieves documents
- Retrieval and refinement → Embeddings: encodes and scores
- Retrieval and refinement → Language model client: generates answers
- Language model client → Ollama: calls API
- Engineer → Task views: manages tasks
- Task views → Task client store: uses task store
- Task client store → Task routes: sends requests
- Task routes → Task persistence: persists tasks
- Task persistence → Task database: queries database
- Engineer → SQL API: inspects databases
- SQL API → SQL endpoints: mounts endpoints
- Schema checks → Schema model: checks schema