# manohareldhandi/model-worklog architecture

> Architecture diagram of the GitHub repository manohareldhandi/model-worklog, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/manohareldhandi/model-worklog
- Repository: https://github.com/manohareldhandi/model-worklog

## Overview

Model Logger captures privacy-conscious traces from instrumented agent workflows, stores them in a local supervisor, and exposes them through VS Code, the CLI, and APIs. The primary path is SDK instrumentation and delivery, collector ingestion and persistence, then trace review or captured-log queries. The repository also includes session-based Codex/Copilot supervision and an SDK RAG layer for searching and answering questions about captured activity. Some implementation details are unsampled; edges below rely on the excerpts or README documentation, and optional integrations are dashed.

Main entry points: [`packages/adapter-sdk/src/rag/engine.ts`](https://github.com/manohareldhandi/model-worklog/blob/main/packages/adapter-sdk/src/rag/engine.ts) (SDK RAG), [`apps/local-supervisor/src/traces/runtime.ts`](https://github.com/manohareldhandi/model-worklog/blob/main/apps/local-supervisor/src/traces/runtime.ts) (Trace runtime), [`apps/local-supervisor/src/traces/http.ts`](https://github.com/manohareldhandi/model-worklog/blob/main/apps/local-supervisor/src/traces/http.ts) (HTTP collector), [`apps/local-supervisor/src/traces/infrastructure/database.ts`](https://github.com/manohareldhandi/model-worklog/blob/main/apps/local-supervisor/src/traces/infrastructure/database.ts) (Trace storage)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_sdk["Tracing SDK"]
  node_sdk_capture["Trace capture<br/>[processor.ts]"]
  node_sdk_delivery["Trace delivery<br/>[exporter.ts]"]
  node_vendor_adapters["Vendor adapters<br/>[vendorAdapters.ts]"]
  node_local_api["Local API client<br/>[index.ts]"]
end

subgraph group_collector["Local supervisor"]
  node_collector_http["HTTP collector<br/>[http.ts]"]
  node_otlp["OTLP ingestion<br/>[transport.ts]"]
  node_trace_runtime["Trace runtime<br/>[runtime.ts]"]
  node_trace_storage[("Trace storage<br/>[database.ts]")]
  node_privacy["Privacy controls<br/>[privacy.ts]"]
  node_supervisor["Supervisor service<br/>[service.ts]"]
  node_codex_relay["Codex relay<br/>[codexRelay.ts]"]
  node_copilot_relay["Copilot relay<br/>[copilotRelay.ts]"]
end

subgraph group_retrieval["Log retrieval"]
  node_query_api["Log query API<br/>[logQuery.ts]"]
  node_query_planner["Query planning<br/>[queryPlanner.ts]"]
  node_query_repository["Evidence search"]
  node_sdk_rag["SDK RAG<br/>[engine.ts]"]
  node_rag_chunking["RAG chunking<br/>[chunking.ts]"]
  node_rag_embedding["Embeddings<br/>[embedding.ts]"]
  node_answer_provider["Answer provider<br/>[answerer.ts]"]
end

subgraph group_clients["User interfaces"]
  node_vscode["VS Code traces<br/>[traceController.ts]"]
  node_cli["CLI<br/>[cli.ts]"]
end

subgraph group_schema["Shared event model"]
  node_event_schema["Trace schemas<br/>[trace.ts]"]
  node_activity_projection["Activity projection<br/>[activityLog.ts]"]
end

node_developer(("Agent developer"))
node_agent["Instrumented agent"]
node_user(("Log reviewer"))
node_chroma[("Chroma vector store")]
node_model_provider["Answer model"]

node_developer -->|"instruments"| node_agent
node_agent -->|"emits spans"| node_sdk_capture
node_sdk_capture -.->|"delivers traces"| node_sdk_delivery
node_vendor_adapters -.->|"instruments vendors"| node_sdk_capture
node_sdk_delivery -->|"sends traces"| node_collector_http
node_collector_http -->|"routes trace requests"| node_trace_runtime
node_trace_runtime -.->|"persists traces"| node_trace_storage
node_trace_runtime -.->|"applies privacy"| node_privacy
node_otlp -->|"accepts OTLP"| node_trace_runtime
node_trace_storage -.->|"stores spans"| node_event_schema
node_event_schema -->|"projects activity"| node_activity_projection
node_user -->|"reviews traces"| node_vscode
node_vscode -->|"reads trace pages"| node_trace_storage
node_user -->|"uses commands"| node_cli
node_cli -.->|"queries local API"| node_collector_http
node_local_api -->|"requests traces"| node_collector_http
node_user -->|"asks captured logs"| node_query_api
node_query_api -->|"plans retrieval"| node_query_planner
node_query_api -.->|"retrieves evidence"| node_query_repository
node_query_repository -->|"searches spans"| node_trace_storage
node_sdk_rag -->|"chunks spans"| node_rag_chunking
node_sdk_rag -.->|"embeds content"| node_rag_embedding
node_sdk_rag -.->|"searches vectors"| node_chroma
node_sdk_rag -->|"generates cited answers"| node_answer_provider
node_answer_provider -.->|"requests generation"| node_model_provider
node_supervisor -->|"dispatches Codex"| node_codex_relay
node_supervisor -->|"dispatches Copilot"| node_copilot_relay

click node_sdk_capture "https://github.com/manohareldhandi/model-worklog/blob/main/packages/adapter-sdk/src/tracing/processor.ts"
click node_sdk_delivery "https://github.com/manohareldhandi/model-worklog/blob/main/packages/adapter-sdk/src/tracing/exporter.ts"
click node_vendor_adapters "https://github.com/manohareldhandi/model-worklog/blob/main/packages/adapter-sdk/src/vendorAdapters.ts"
click node_collector_http "https://github.com/manohareldhandi/model-worklog/blob/main/apps/local-supervisor/src/traces/http.ts"
click node_otlp "https://github.com/manohareldhandi/model-worklog/blob/main/apps/local-supervisor/src/traces/otlp/transport.ts"
click node_trace_runtime "https://github.com/manohareldhandi/model-worklog/blob/main/apps/local-supervisor/src/traces/runtime.ts"
click node_trace_storage "https://github.com/manohareldhandi/model-worklog/blob/main/apps/local-supervisor/src/traces/infrastructure/database.ts"
click node_privacy "https://github.com/manohareldhandi/model-worklog/blob/main/apps/local-supervisor/src/traces/domain/privacy.ts"
click node_event_schema "https://github.com/manohareldhandi/model-worklog/blob/main/packages/event-schema/src/trace.ts"
click node_activity_projection "https://github.com/manohareldhandi/model-worklog/blob/main/packages/event-schema/src/activityLog.ts"
click node_query_api "https://github.com/manohareldhandi/model-worklog/blob/main/apps/local-supervisor/src/traces/application/logQuery.ts"
click node_query_planner "https://github.com/manohareldhandi/model-worklog/blob/main/apps/local-supervisor/src/traces/domain/queryPlanner.ts"
click node_query_repository "https://github.com/manohareldhandi/model-worklog/blob/main/apps/local-supervisor/src/traces/infrastructure/logQueryRepository.ts"
click node_sdk_rag "https://github.com/manohareldhandi/model-worklog/blob/main/packages/adapter-sdk/src/rag/engine.ts"
click node_rag_chunking "https://github.com/manohareldhandi/model-worklog/blob/main/packages/adapter-sdk/src/rag/chunking.ts"
click node_rag_embedding "https://github.com/manohareldhandi/model-worklog/blob/main/packages/adapter-sdk/src/rag/embedding.ts"
click node_answer_provider "https://github.com/manohareldhandi/model-worklog/blob/main/packages/adapter-sdk/src/rag/answerer.ts"
click node_supervisor "https://github.com/manohareldhandi/model-worklog/blob/main/apps/local-supervisor/src/service.ts"
click node_codex_relay "https://github.com/manohareldhandi/model-worklog/blob/main/apps/local-supervisor/src/codexRelay.ts"
click node_copilot_relay "https://github.com/manohareldhandi/model-worklog/blob/main/apps/local-supervisor/src/copilotRelay.ts"
click node_vscode "https://github.com/manohareldhandi/model-worklog/blob/main/apps/vscode-extension/src/traceController.ts"
click node_cli "https://github.com/manohareldhandi/model-worklog/blob/main/apps/cli/src/cli.ts"
click node_local_api "https://github.com/manohareldhandi/model-worklog/blob/main/packages/adapter-sdk/src/index.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_sdk_capture,node_sdk_delivery,node_vendor_adapters,node_local_api,node_user toneBlue
class node_collector_http,node_otlp,node_trace_runtime,node_trace_storage,node_privacy,node_supervisor,node_codex_relay,node_copilot_relay,node_chroma toneAmber
class node_query_api,node_query_planner,node_query_repository,node_sdk_rag,node_rag_chunking,node_rag_embedding,node_answer_provider toneMint
class node_vscode,node_cli toneRose
class node_event_schema,node_activity_projection,node_developer,node_agent,node_model_provider toneIndigo
```

## Components

### Tracing SDK

- [Trace capture](https://github.com/manohareldhandi/model-worklog/blob/main/packages/adapter-sdk/src/tracing/processor.ts): `packages/adapter-sdk/src/tracing/processor.ts`
- [Trace delivery](https://github.com/manohareldhandi/model-worklog/blob/main/packages/adapter-sdk/src/tracing/exporter.ts): `packages/adapter-sdk/src/tracing/exporter.ts`
- [Vendor adapters](https://github.com/manohareldhandi/model-worklog/blob/main/packages/adapter-sdk/src/vendorAdapters.ts): `packages/adapter-sdk/src/vendorAdapters.ts`
- [Local API client](https://github.com/manohareldhandi/model-worklog/blob/main/packages/adapter-sdk/src/index.ts): `packages/adapter-sdk/src/index.ts`

### Local supervisor

- [HTTP collector](https://github.com/manohareldhandi/model-worklog/blob/main/apps/local-supervisor/src/traces/http.ts): `apps/local-supervisor/src/traces/http.ts`
- [OTLP ingestion](https://github.com/manohareldhandi/model-worklog/blob/main/apps/local-supervisor/src/traces/otlp/transport.ts): `apps/local-supervisor/src/traces/otlp/transport.ts`
- [Trace runtime](https://github.com/manohareldhandi/model-worklog/blob/main/apps/local-supervisor/src/traces/runtime.ts): `apps/local-supervisor/src/traces/runtime.ts`
- [Trace storage](https://github.com/manohareldhandi/model-worklog/blob/main/apps/local-supervisor/src/traces/infrastructure/database.ts): `apps/local-supervisor/src/traces/infrastructure/database.ts`
- [Privacy controls](https://github.com/manohareldhandi/model-worklog/blob/main/apps/local-supervisor/src/traces/domain/privacy.ts): `apps/local-supervisor/src/traces/domain/privacy.ts`
- [Supervisor service](https://github.com/manohareldhandi/model-worklog/blob/main/apps/local-supervisor/src/service.ts): `apps/local-supervisor/src/service.ts`
- [Codex relay](https://github.com/manohareldhandi/model-worklog/blob/main/apps/local-supervisor/src/codexRelay.ts): `apps/local-supervisor/src/codexRelay.ts`
- [Copilot relay](https://github.com/manohareldhandi/model-worklog/blob/main/apps/local-supervisor/src/copilotRelay.ts): `apps/local-supervisor/src/copilotRelay.ts`

### Log retrieval

- [Log query API](https://github.com/manohareldhandi/model-worklog/blob/main/apps/local-supervisor/src/traces/application/logQuery.ts): `apps/local-supervisor/src/traces/application/logQuery.ts`
- [Query planning](https://github.com/manohareldhandi/model-worklog/blob/main/apps/local-supervisor/src/traces/domain/queryPlanner.ts): `apps/local-supervisor/src/traces/domain/queryPlanner.ts`
- [Evidence search](https://github.com/manohareldhandi/model-worklog/blob/main/apps/local-supervisor/src/traces/infrastructure/logQueryRepository.ts): `apps/local-supervisor/src/traces/infrastructure/logQueryRepository.ts`
- [SDK RAG](https://github.com/manohareldhandi/model-worklog/blob/main/packages/adapter-sdk/src/rag/engine.ts): `packages/adapter-sdk/src/rag/engine.ts`
- [RAG chunking](https://github.com/manohareldhandi/model-worklog/blob/main/packages/adapter-sdk/src/rag/chunking.ts): `packages/adapter-sdk/src/rag/chunking.ts`
- [Embeddings](https://github.com/manohareldhandi/model-worklog/blob/main/packages/adapter-sdk/src/rag/embedding.ts): `packages/adapter-sdk/src/rag/embedding.ts`
- [Answer provider](https://github.com/manohareldhandi/model-worklog/blob/main/packages/adapter-sdk/src/rag/answerer.ts): `packages/adapter-sdk/src/rag/answerer.ts`

### User interfaces

- [VS Code traces](https://github.com/manohareldhandi/model-worklog/blob/main/apps/vscode-extension/src/traceController.ts): `apps/vscode-extension/src/traceController.ts`
- [CLI](https://github.com/manohareldhandi/model-worklog/blob/main/apps/cli/src/cli.ts): `apps/cli/src/cli.ts`

### Shared event model

- [Trace schemas](https://github.com/manohareldhandi/model-worklog/blob/main/packages/event-schema/src/trace.ts): `packages/event-schema/src/trace.ts`
- [Activity projection](https://github.com/manohareldhandi/model-worklog/blob/main/packages/event-schema/src/activityLog.ts): `packages/event-schema/src/activityLog.ts`

### Other components

- **Agent developer**
- **Instrumented agent**
- **Log reviewer**
- **Chroma vector store**
- **Answer model**

## Connections

- Agent developer → Instrumented agent: instruments (evidence: `README.md`)
- Instrumented agent → Trace capture: emits spans (evidence: `README.md`)
- Trace capture → Trace delivery: delivers traces
- Vendor adapters → Trace capture: instruments vendors
- Trace delivery → HTTP collector: sends traces (evidence: `README.md`)
- HTTP collector → Trace runtime: routes trace requests (evidence: `apps/local-supervisor/src/server.ts`)
- Trace runtime → Trace storage: persists traces
- Trace runtime → Privacy controls: applies privacy
- OTLP ingestion → Trace runtime: accepts OTLP (evidence: `README.md`)
- Trace storage → Trace schemas: stores spans
- Trace schemas → Activity projection: projects activity (evidence: `packages/event-schema/src/activityLog.ts`)
- Log reviewer → VS Code traces: reviews traces (evidence: `README.md`)
- VS Code traces → Trace storage: reads trace pages (evidence: `README.md`)
- Log reviewer → CLI: uses commands (evidence: `README.md`)
- CLI → HTTP collector: queries local API
- Local API client → HTTP collector: requests traces (evidence: `packages/adapter-sdk/src/index.ts`)
- Log reviewer → Log query API: asks captured logs (evidence: `README.md`)
- Log query API → Query planning: plans retrieval (evidence: `apps/local-supervisor/src/traces/application/logQuery.ts`)
- Log query API → Evidence search: retrieves evidence
- Evidence search → Trace storage: searches spans (evidence: `apps/local-supervisor/src/traces/infrastructure/logQueryRepository.ts`)
- SDK RAG → RAG chunking: chunks spans (evidence: `packages/adapter-sdk/src/rag/engine.ts`)
- SDK RAG → Embeddings: embeds content
- SDK RAG → Chroma vector store: searches vectors (evidence: `README.md`)
- SDK RAG → Answer provider: generates cited answers (evidence: `packages/adapter-sdk/src/rag/engine.ts`)
- Answer provider → Answer model: requests generation
- Supervisor service → Codex relay: dispatches Codex (evidence: `apps/local-supervisor/src/service.ts`)
- Supervisor service → Copilot relay: dispatches Copilot (evidence: `apps/local-supervisor/src/service.ts`)
