Jayden/claude-code-2026-04-02

Archived

This repository has been archived on 2026-04-02. You can view files and clone it. You cannot open issues or pull requests or push a commit.

Files

Osman Mehmood 51fa1eeca5 add developer docs

2026-03-31 16:04:03 +05:00

2.6 KiB

Raw Blame History

State and data flow

!!! warning "Recovered proprietary source" For authoritative product behavior, use official Claude Code docs.

End-to-end message path (interactive)

Input — User text, slash commands, teammate notifications, or task items reach screens/REPL.tsx.
Queue — utils/queueProcessor.ts serializes or batches commands and calls executeInput.
Query — query.ts queryLoop streams the model, surfaces tool_use blocks, and applies permission checks using toolPermissionContext from app state.
Execution — services/tools/ (e.g. StreamingToolExecutor, toolExecution.ts) dispatches to modules under tools/* or MCP-backed tools.
Persistence — Transcript updates, session metadata, and compaction boundaries flow through utils/sessionStorage.ts, conversation recovery helpers, and related hooks.

State ownership

Concern	Typical modules
Global app state	`state/` (providers, stores such as `AppStateStore.ts`)
Context / stats	`context/`
Messages	`utils/messages.ts`, message types under `types/message` (and generated types)
Permissions	`utils/permissions/`, fields on tool permission context updated from CLI and REPL
File / edit history	Wired through process-user-input and tool hooks (see compaction and attribution utilities)

Simplified sequence (one turn)

sequenceDiagram
  participant UI as REPL_or_print
  participant Q as queryLoop
  participant API as services_api
  participant Exec as tool_executor
  participant Store as session_storage
  UI->>Q: user_or_control_messages
  Q->>API: stream_completion
  API-->>Q: assistant_tool_use
  Q->>Exec: run_tool
  Exec-->>Q: tool_result
  Q->>Store: persist_transcript_updates
  Q-->>UI: render_updates

Headless differences

In print/SDK paths: QueryEngine.ts builds a processUserInputContext with isNonInteractiveSession: true, streams SDK-style messages, and bridges permission prompts over structured I/O instead of Ink dialogs. The same underlying message and tool model is reused.

2.6 KiB Raw Blame History