Repository Overview: checkout

# Repository Overview: checkout

**Files:** 848 | **Lines:** 269991 | **Monorepo:** 3 packages | **Import cycles:** 4

## Project Summary


`checkout` is a multi-package json codebase of 848 files, split across 3 packages. Execution starts at `src_agent/main.py`, `src_api_gateway/main.py`, `src_audio_ws_ingress/__main__.py` and 7 other entry points.



## System map

The main parts of checkout and how they connect. 8 more parts are not shown.

```mermaid
flowchart TB
  subgraph tier_actor["Who uses it"]
    direction LR
    n_actor_user(["<b>User</b><br/></br><small>Uses the system</small>"]):::actor
  end
  subgraph tier_engine["Engine"]
    direction LR
    n_src_front_src_agentcommands["<b>agentCommands</b><br/></br><small>8 TypeScript files</small>"]:::engine
    n_src_front_src_ui["<b>ui</b><br/></br><small>8 TypeScript files</small>"]:::engine
    n_src_front_src_audio["<b>audio</b><br/></br><small>7 TypeScript files</small>"]:::engine
    n_src_front_src_webrtc["<b>webrtc</b><br/></br><small>5 TypeScript files</small>"]:::engine
    n_src_front_src_core["<b>core</b><br/></br><small>4 TypeScript files</small>"]:::engine
    n_src_front_src_types_ts["<b>types.ts</b><br/></br><small>1 TypeScript file</small>"]:::engine
  end
  n_src_front_src_agentcommands ==>|"imports"| n_src_front_src_types_ts
  n_src_front_src_audio -->|"imports"| n_src_front_src_ui
  n_src_front_src_core -->|"imports"| n_src_front_src_types_ts
  n_src_front_src_webrtc -->|"imports"| n_src_front_src_audio
  n_src_front_src_core -->|"imports"| n_src_front_src_ui
  n_src_front_src_ui -->|"imports"| n_src_front_src_types_ts
  click n_src_front_src_agentcommands "?page=module_page%3Asrc_front%2Fsrc%2FagentCommands" "Open the agentCommands page"
  click n_src_front_src_ui "?page=module_page%3Asrc_front" "Open the ui page"
  click n_src_front_src_audio "?page=module_page%3Asrc_front" "Open the audio page"
  click n_src_front_src_webrtc "?page=module_page%3Asrc_front" "Open the webrtc page"
  click n_src_front_src_core "?page=module_page%3Asrc_front" "Open the core page"
  click n_src_front_src_types_ts "?page=module_page%3Asrc_front" "Open the types.ts page"
  classDef actor stroke-dasharray:4 4
  classDef engine stroke-width:1px
```

## Packages

| Package | Path | Files | Languages |
|---|---|---|---|
| assistant-frontend | `src_front` | 100 | typescript, json, html |
| src_langgraph_rb | `src_langgraph_rb` | 47 | ruby |
| src_langgraph_rb_node | `src_langgraph_rb_node` | 47 | ruby |

## Primary Execution Flows

- `src_langgraph_rb_node/lib/src_langgraph_rb_node/runtime/dialog.rb::Dialog::run` (6 steps)

- `stack/release.rb::Release::run` (4 steps)

- `src_front/src/assistant/assistantApp.ts::AssistantApp::start` (6 steps)

- `src_langgraph_rb/lib/src_langgraph_rb/runtime/engine.rb::Engine::run` (5 steps)

- `src_llm/utils/base_service.py::BaseService::run` (4 steps)












## Codebase health signals
- **Hotspots:** 54 files are both high-churn and high-complexity
- **Stable core:** 0 files unchanged in 90+ days
- **Most changed (90d):** `src_agent/.version`, `.gitlab-ci.yml`, `src_agent/pydantic_agent.py`
- **Oldest file:** `README.md` (358 days)


---

*Built from the code's structure. It states what is there, not why it is that
way. The explanatory prose is a separate, model-written layer.*