# suenot/codex-jev-router architecture

> Architecture diagram of the GitHub repository suenot/codex-jev-router, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/suenot/codex-jev-router
- Repository: https://github.com/suenot/codex-jev-router

## Overview

Codex Jev Router’s recommended workflow is an opt-in local MCP server that searches workspace files and returns bounded, cited excerpts; users can expand a selected reference for more context. The repository also retains legacy model-routing, batch-decision, and skill-suggestion workflows, which are separate from the recommended evidence tool. Edges reflect README statements or source-index references and sampled imports/calls; unsampled implementation details are not inferred.

Main entry points: [`src/router.mjs`](https://github.com/suenot/codex-jev-router/blob/main/src/router.mjs) (Model Router), [`src/decider.mjs`](https://github.com/suenot/codex-jev-router/blob/main/src/decider.mjs) (Decision Adapter), [`src/evidence.mjs`](https://github.com/suenot/codex-jev-router/blob/main/src/evidence.mjs) (Workspace Search), [`src/batch-decisions.mjs`](https://github.com/suenot/codex-jev-router/blob/main/src/batch-decisions.mjs) (Batch Decisions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_evidence["Evidence MCP"]
  node_mcp["Evidence MCP Tools<br/>[evidence-mcp.mjs]"]
  node_workspace["Workspace Search<br/>[evidence.mjs]"]
  node_excerpt["Selected Excerpts<br/>[evidence.mjs]"]
end

subgraph group_selection["Decision Selection"]
  node_selector["Decision Adapter<br/>[decider.mjs]"]
  node_backend["Backend Adapters"]
end

subgraph group_legacy["Legacy Routing"]
  node_routecli["Route Command<br/>[route.mjs]"]
  node_router["Model Router<br/>[router.mjs]"]
  node_privacy["Credential Guard<br/>[privacy.mjs]"]
  node_decisionlog[("Decision Log<br/>[log-decision.mjs]")]
  node_routebatch["Batch Route Command<br/>[route-batch.mjs]"]
  node_batchdecisions["Batch Decisions"]
  node_decisioncli["Batch Decision Command<br/>[decide-batch.mjs]"]
end

subgraph group_skills["Skill Suggestions"]
  node_skillhook["Prompt Hook"]
  node_skillsuggest["Skill Selector"]
end

node_codex(("Codex User"))
node_laya["Local Laya"]
node_skillfiles["Local Skills"]

node_codex -->|"uses tools"| node_mcp
node_mcp -->|"calls"| node_workspace
node_workspace -->|"returns references"| node_excerpt
node_codex -->|"requests expansion"| node_excerpt
node_workspace -.->|"optionally ranks"| node_laya
node_routecli -->|"calls"| node_router
node_router -->|"requests decisions"| node_selector
node_router -->|"checks credentials"| node_privacy
node_selector -->|"translates requests"| node_backend
node_routecli -->|"records decision"| node_decisionlog
node_routebatch -->|"routes batches"| node_router
node_routebatch -->|"records decisions"| node_decisionlog
node_decisioncli -->|"calls"| node_batchdecisions
node_batchdecisions -->|"requests decisions"| node_selector
node_batchdecisions -->|"checks credentials"| node_privacy
node_codex -->|"submits prompt"| node_skillhook
node_skillhook -->|"calls"| node_skillsuggest
node_skillsuggest -->|"loads metadata"| node_skillfiles
node_skillsuggest -->|"requests ranking"| node_selector

click node_mcp "https://github.com/suenot/codex-jev-router/blob/main/src/evidence-mcp.mjs"
click node_workspace "https://github.com/suenot/codex-jev-router/blob/main/src/evidence.mjs"
click node_excerpt "https://github.com/suenot/codex-jev-router/blob/main/src/evidence.mjs"
click node_selector "https://github.com/suenot/codex-jev-router/blob/main/src/decider.mjs"
click node_backend "https://github.com/suenot/codex-jev-router/blob/main/src/alternative-backends.mjs"
click node_routecli "https://github.com/suenot/codex-jev-router/blob/main/src/route.mjs"
click node_router "https://github.com/suenot/codex-jev-router/blob/main/src/router.mjs"
click node_privacy "https://github.com/suenot/codex-jev-router/blob/main/src/privacy.mjs"
click node_decisionlog "https://github.com/suenot/codex-jev-router/blob/main/src/log-decision.mjs"
click node_routebatch "https://github.com/suenot/codex-jev-router/blob/main/src/route-batch.mjs"
click node_batchdecisions "https://github.com/suenot/codex-jev-router/blob/main/src/batch-decisions.mjs"
click node_decisioncli "https://github.com/suenot/codex-jev-router/blob/main/src/decide-batch.mjs"
click node_skillhook "https://github.com/suenot/codex-jev-router/blob/main/src/skill-suggestion-hook.mjs"
click node_skillsuggest "https://github.com/suenot/codex-jev-router/blob/main/src/skill-suggestion.mjs"

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_mcp,node_workspace,node_excerpt,node_codex toneBlue
class node_selector,node_backend toneAmber
class node_routecli,node_router,node_privacy,node_decisionlog,node_routebatch,node_batchdecisions,node_decisioncli toneMint
class node_skillhook,node_skillsuggest toneRose
class node_laya,node_skillfiles toneIndigo
```

## Components

### Evidence MCP

- [Evidence MCP Tools](https://github.com/suenot/codex-jev-router/blob/main/src/evidence-mcp.mjs): `src/evidence-mcp.mjs`
- [Workspace Search](https://github.com/suenot/codex-jev-router/blob/main/src/evidence.mjs): `src/evidence.mjs`
- [Selected Excerpts](https://github.com/suenot/codex-jev-router/blob/main/src/evidence.mjs): `src/evidence.mjs`

### Decision Selection

- [Decision Adapter](https://github.com/suenot/codex-jev-router/blob/main/src/decider.mjs): `src/decider.mjs`
- [Backend Adapters](https://github.com/suenot/codex-jev-router/blob/main/src/alternative-backends.mjs): `src/alternative-backends.mjs`

### Legacy Routing

- [Route Command](https://github.com/suenot/codex-jev-router/blob/main/src/route.mjs): `src/route.mjs`
- [Model Router](https://github.com/suenot/codex-jev-router/blob/main/src/router.mjs): `src/router.mjs`
- [Credential Guard](https://github.com/suenot/codex-jev-router/blob/main/src/privacy.mjs): `src/privacy.mjs`
- [Decision Log](https://github.com/suenot/codex-jev-router/blob/main/src/log-decision.mjs): `src/log-decision.mjs`
- [Batch Route Command](https://github.com/suenot/codex-jev-router/blob/main/src/route-batch.mjs): `src/route-batch.mjs`
- [Batch Decisions](https://github.com/suenot/codex-jev-router/blob/main/src/batch-decisions.mjs): `src/batch-decisions.mjs`
- [Batch Decision Command](https://github.com/suenot/codex-jev-router/blob/main/src/decide-batch.mjs): `src/decide-batch.mjs`

### Skill Suggestions

- [Prompt Hook](https://github.com/suenot/codex-jev-router/blob/main/src/skill-suggestion-hook.mjs): `src/skill-suggestion-hook.mjs`
- [Skill Selector](https://github.com/suenot/codex-jev-router/blob/main/src/skill-suggestion.mjs): `src/skill-suggestion.mjs`

### Other components

- **Codex User**
- **Local Laya**
- **Local Skills**

## Connections

- Codex User → Evidence MCP Tools: uses tools (evidence: `README.md`)
- Evidence MCP Tools → Workspace Search: calls (evidence: `src/evidence-mcp.mjs`)
- Workspace Search → Selected Excerpts: returns references (evidence: `README.md`)
- Codex User → Selected Excerpts: requests expansion (evidence: `README.md`)
- Workspace Search → Local Laya: optionally ranks (evidence: `README.md`)
- Route Command → Model Router: calls (evidence: `src/route.mjs`)
- Model Router → Decision Adapter: requests decisions (evidence: `src/router.mjs`)
- Model Router → Credential Guard: checks credentials (evidence: `src/router.mjs`)
- Decision Adapter → Backend Adapters: translates requests (evidence: `src/decider.mjs`)
- Route Command → Decision Log: records decision (evidence: `src/route.mjs`)
- Batch Route Command → Model Router: routes batches (evidence: `src/route-batch.mjs`)
- Batch Route Command → Decision Log: records decisions (evidence: `src/route-batch.mjs`)
- Batch Decision Command → Batch Decisions: calls (evidence: `src/decide-batch.mjs`)
- Batch Decisions → Decision Adapter: requests decisions (evidence: `src/batch-decisions.mjs`)
- Batch Decisions → Credential Guard: checks credentials (evidence: `src/batch-decisions.mjs`)
- Codex User → Prompt Hook: submits prompt (evidence: `README.md`)
- Prompt Hook → Skill Selector: calls (evidence: `src/skill-suggestion-hook.mjs`)
- Skill Selector → Local Skills: loads metadata (evidence: `src/skill-suggestion.mjs`)
- Skill Selector → Decision Adapter: requests ranking (evidence: `src/skill-suggestion.mjs`)
