How naknakgeo/engineeringrag works
Engineering Intelligence OS is currently a Phase 0 foundation: local services, PostgreSQL-backed infrastructure, project-indexing and knowledge primitives, and observability. The principal visible workflow is a client calling the API, which routes requests to product capabilities; project sync can be queued and processed by a worker, while knowledge evidence follows a staged trust pipeline. The README describes broader retrieval, routing, policy, and workflow ambitions, but explicitly says Phase 1+ does not yet exist. Several connections below are limited to documented wiring or sampled imports; unsampled behavior is not inferred.
Main entry points: engine.py Engineering OS PostgreSQL · app.py HTTP API · service.py Project Service · container.py Runtime Container
Components 22
Service Entry Points
- HTTP API
apps/api/src/eios_api/app.py - API Routes
apps/api/src/eios_api/routes - MCP Server
apps/mcp_server/src/eios_mcp/server.py - Worker
apps/worker/src/eios_worker/worker.py
Project Intelligence
- Project Service
packages/project_intelligence/src/eios_project_intelligence/service.py - Project Indexer
packages/project_intelligence/src/eios_project_intelligence/indexer.py - Project Store
packages/project_intelligence/src/eios_project_intelligence/store.py - Language Parsers
packages/project_intelligence/src/eios_project_intelligence/parsers
Knowledge Pipeline
- Evidence Pipeline
packages/knowledge/src/eios_knowledge/pipeline.py - Knowledge Service
packages/knowledge/src/eios_knowledge/service.py - Knowledge Repositories
packages/knowledge/src/eios_knowledge - Evidence Blobs
packages/knowledge/src/eios_knowledge/blob_store.py
Jobs and Observability
- Job Queue
packages/jobs/src/eios_jobs/queue.py - Job Runner
packages/jobs/src/eios_jobs/runner.py - Run Recorder
packages/observability/src/eios_observability/recorder.py - Event and Run Store
packages/observability/src/eios_observability/postgres.py
Shared Foundation
- Runtime Container
packages/runtime/src/eios_runtime/container.py - Engineering OS PostgreSQL
packages/storage/src/eios_storage/engine.py - Runtime Settings
packages/core/src/eios_core/settings.py - Domain Contracts
packages/domain/src/eios_domain - Structured Logging
packages/core/src/eios_core/logging.py
Other components
- API Client
Connections 27
- API Client → HTTP API: sends requests
README.md - HTTP API → API Routes: registers routes
apps/api/src/eios_api/app.py - HTTP API → Runtime Container: builds runtime
apps/api/src/eios_api/app.py - HTTP API → Engineering OS PostgreSQL: builds engine
apps/api/src/eios_api/app.py - HTTP API → Runtime Settings: reads settings
apps/api/src/eios_api/app.py - MCP Server → Engineering OS PostgreSQL: uses storage
apps/mcp_server/src/eios_mcp/server.py - Worker → Job Runner: runs jobs
apps/worker/src/eios_worker/worker.py - Worker → Engineering OS PostgreSQL: builds engine
apps/worker/src/eios_worker/worker.py - Worker → Structured Logging: configures logs
apps/worker/src/eios_worker/worker.py - Runtime Container → Knowledge Service: wires knowledge
packages/runtime/src/eios_runtime/container.py - Runtime Container → Project Service: wires project intelligence
packages/runtime/src/eios_runtime/container.py - Runtime Container → Job Queue: wires jobs
packages/runtime/src/eios_runtime/container.py - API Routes → Project Store: accesses project data
apps/api/src/eios_api/routes/projects.py - Project Service → Project Indexer: syncs project
packages/project_intelligence/src/eios_project_intelligence/service.py - Project Service → Project Store: reads project data
packages/project_intelligence/src/eios_project_intelligence/service.py - Project Service → Job Queue: queues sync
packages/project_intelligence/src/eios_project_intelligence/service.py - Project Service → Run Recorder: records runs
packages/project_intelligence/src/eios_project_intelligence/service.py - Project Indexer → Language Parsers: parses source
- Evidence Pipeline → Evidence Blobs: stores evidence
packages/knowledge/src/eios_knowledge/pipeline.py - Evidence Pipeline → Knowledge Service: promotes findings
packages/knowledge/src/eios_knowledge/pipeline.py - Knowledge Service → Knowledge Repositories: persists knowledge
packages/knowledge/src/eios_knowledge/service.py - Knowledge Service → Domain Contracts: uses domain types
packages/knowledge/src/eios_knowledge/service.py - Job Runner → Job Queue: claims jobs
packages/jobs/src/eios_jobs/runner.py - Run Recorder → Event and Run Store: persists runs
packages/observability/src/eios_observability/recorder.py - Event and Run Store → Engineering OS PostgreSQL: stores events
packages/observability/src/eios_observability/postgres.py - Job Queue → Engineering OS PostgreSQL: stores jobs
packages/jobs/src/eios_jobs/queue.py - Runtime Settings → Engineering OS PostgreSQL: restricts database
packages/core/src/eios_core/settings.py