@nomad-e/bluma-cli 0.1.83 → 0.2.1

package/README.md

@@ -11,7 +11,7 @@
 
 > **Credit:** BluMa was conceived and architected by **Alex Fonseca**.
 
-**Current Version:** 0.1.74
+**Current Version:** 0.1.84
 
 ---
 
@@ -42,7 +42,7 @@ BluMa operates as a **conversational agent** in the terminal, combining:
 - **Rich UI Layer**: React/Ink 5 components for interactive prompts, live overlays, and real-time feedback
 - **Agent Layer**: LLM orchestration via FactorRouter with tool invocation and context management
 - **Runtime Layer**: Task tracking, plugin system, hooks, diagnostics, session management, and coordinator mode
-- **Tool Layer**: 45+ native tools + MCP SDK integration for external tools
+- **Tool Layer**: 50+ native tools + MCP SDK integration for external tools
 
 The agent maintains persistent conversation history, workspace snapshots, and coding memory across sessions.
 
@@ -63,22 +63,24 @@ The agent maintains persistent conversation history, workspace snapshots, and co
 - **Hook Registry**: Event-driven lifecycle tracking (tool calls, decisions, state changes)
 - **Task Store**: Persistent task management with PLANNING → EXECUTION → VERIFICATION flow
 - **Session Registry**: Multi-session support with process health monitoring
+- **Thread System**: Multi-thread conversation management with isolated contexts
 - **Diagnostics**: Real-time system snapshot (tasks, hooks, plugins, sessions)
 - **Tool Execution Policy**: Intelligent decisions based on sandbox mode and safety
 
 ### Tools & Skills
-- **45+ Native Tools**: File operations, search, shell commands, web fetch, agent coordination, task management, MCP resources, cron scheduling, LSP queries, notebook editing
+- **50+ Native Tools**: File operations, search, shell commands, web fetch, agent coordination, task management, MCP resources, cron scheduling, LSP queries, notebook editing, REPL execution
 - **Coordinator Mode**: Orchestrator playbook for delegating work to background workers
 - **MCP Integration**: Model Context Protocol SDK for external tool servers
 - **Skills System**: Pluggable knowledge modules (git, PDF, Excel, etc.)
-- **Agent Coordination**: Spawn/wait/list subagents for parallel work
+- **Agent Coordination**: Spawn/wait/list subagents for parallel work with bidirectional mailbox system
 
 ### UI Components
-- **Slash Commands**: 20+ built-in commands (`/help`, `/model`, `/tasks`, `/plugins`, etc.)
+- **Slash Commands**: 30+ built-in commands (`/help`, `/model`, `/tasks`, `/plugins`, `/threads`, etc.)
 - **Live Overlays**: Working timers, progress indicators, streaming text
 - **Diff Previews**: Side-by-side code comparisons before edits
 - **Tool Result Cards**: Structured display of tool outputs
 - **Session Panels**: Real-time monitoring with log streaming
+- **Thread Management**: Multi-thread conversation UI with thread switching
 
 ---
 
@@ -153,6 +155,7 @@ npm start
 > run npm test in the background
 > /tasks to see active tasks
 > /model to switch LLM model
+> /threads to manage conversation threads
 ```
 
 ---
@@ -187,7 +190,8 @@ npm start
 ├── coding_memory.json     # Persistent coding notes
 ├── artifacts/             # Saved plans and documents
 ├── plugins/               # Global plugins
-└── sessions/              # Session history
+├── sessions/              # Session history
+└── threads/               # Thread storage
 ```
 
 ---
@@ -198,15 +202,19 @@ npm start
 ┌─────────────────────────────────────────────────────────────┐
 │                         UI Layer                            │
 │  ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────────┐   │
-│  │   App    │ │ Input    │ │ Slash    │ │  ToolResult  │   │
-│  │  (Ink)   │ │ Prompt   │ │ Commands │ │   Display    │   │
+│  │  Bluma   │ │  Input   │ │  Slash   │ │  ToolResult  │   │
+│  │ Session  │ │  Prompt  │ │ Commands │ │   Display    │   │
+│  │  (Ink)   │ │          │ │          │ │              │   │
 │  └────┬─────┘ └────┬─────┘ └────┬─────┘ └──────┬───────┘   │
-└───────┼────────────┼────────────┼──────────────┼───────────┘
-        │            │            │              │
-        └────────────┴────────────┴──────────────┘
-                         │
-┌────────────────────────┼────────────────────────────────────┐
-│                   Agent Layer                               │
+│       │            │            │              │            │
+│  ┌────┴────────────┴────────────┴──────────────┴─────┐     │
+│  │              BlumaShell / BlumaViewport            │     │
+│  │         BlumaTranscript / BlumaBottomDock          │     │
+│  └────────────────────────────────────────────────────┘     │
+└─────────────────────────────────────────────────────────────┘
+                              │
+┌─────────────────────────────┼────────────────────────────────┐
+│                   Agent Layer                              │
 │  ┌──────────────┐  ┌──────────┐  ┌──────────────────────┐  │
 │  │    Agent     │  │  BluMa   │  │   RouteManager       │  │
 │  │  Orchestrator│  │  Core    │  │   (FactorRouter)     │  │
@@ -216,10 +224,13 @@ npm start
 │  │ ToolInvoker  │  │  LLM    │  │   PromptBuilder      │  │
 │  │              │  │ Client  │  │   + ContextManager   │  │
 │  └──────────────┘  └─────────┘  └──────────────────────┘  │
+│  ┌──────────────────────────────────────────────────────┐  │
+│  │              Thread Manager / Thread Store           │  │
+│  └──────────────────────────────────────────────────────┘  │
 └─────────────────────────────────────────────────────────────┘
-                         │
-┌────────────────────────┼────────────────────────────────────┐
-│                   Runtime Layer                             │
+                              │
+┌─────────────────────────────┼────────────────────────────────┐
+│                   Runtime Layer                            │
 │  ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────────┐   │
 │  │TaskStore │ │HookReg.  │ │PluginReg.│ │SessionReg.   │   │
 │  │          │ │          │ │          │ │              │   │
@@ -232,18 +243,23 @@ npm start
 │  │Feature   │ │Plan Mode │ │Tool Auto │ │Tool Permission│  │
 │  │Flags     │ │Session   │ │Approve   │ │Classifier    │   │
 │  └──────────┘ └──────────┘ └──────────┘ └──────────────┘   │
+│  ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────────┐   │
+│  │Mailbox   │ │Worker    │ │Permission│ │Thread        │   │
+│  │Registry  │ │Context   │ │Rules     │ │Manager       │   │
+│  └──────────┘ └──────────┘ └──────────┘ └──────────────┘   │
 └─────────────────────────────────────────────────────────────┘
-                         │
-┌────────────────────────┼────────────────────────────────────┐
-│                    Tools Layer                              │
+                              │
+┌─────────────────────────────┼────────────────────────────────┐
+│                    Tools Layer                             │
 │  ┌──────────────────────────────────────────────────────┐  │
-│  │              Native Tools (45+)                      │  │
+│  │              Native Tools (50+)                      │  │
 │  │  edit_tool, file_write, shell_command, grep_search,  │  │
 │  │  spawn_agent, wait_agent, list_agents,               │  │
+│  │  send_message, list_mailbox_messages, signal_mailbox,│  │
 │  │  todo, task_boundary, task_create, task_list,        │  │
 │  │  task_get, task_update, task_stop,                   │  │
 │  │  coding_memory, search_web, web_fetch, load_skill,   │  │
-│  │  message, ask_user_question,                         │  │
+│  │  message, ask_user_question, repl,                   │  │
 │  │  list_mcp_resources, read_mcp_resource,              │  │
 │  │  cron_create, cron_list, cron_delete,                │  │
 │  │  lsp_query, notebook_edit,                           │  │
@@ -260,7 +276,7 @@ npm start
 
 ## Native Tools
 
-BluMa includes **45+ built-in tools** organized by category:
+BluMa includes **50+ built-in tools** organized by category:
 
 ### File Operations
 | Tool | Description |
@@ -292,7 +308,7 @@ BluMa includes **45+ built-in tools** organized by category:
 | `send_message` | Send follow-up to running worker (continue without re-spawn) |
 | `list_mailbox_messages` | Read messages from workers (progress, permission requests) |
 | `signal_mailbox` | Send ack/nack/progress signals to workers |
-| `poll_mailbox` | Poll mailbox for new messages (legacy polling mode) |
+| `poll_mailbox` | Poll mailbox for new messages |
 
 ### Task & Project Management
 | Tool | Description |
@@ -304,8 +320,17 @@ BluMa includes **45+ built-in tools** organized by category:
 | `task_get` | Get one task by id |
 | `task_update` | Update task fields |
 | `task_stop` | Cancel a task |
-| `create_artifact` | Save documents under `<workspace>/.bluma/artifacts/<session>/` (see `task_boundary` → `artifacts_dir`) |
-| `read_artifact` | Read artifacts from the current session directory under `.bluma/artifacts/` |
+| `task_output` | Read task output in real-time |
+| `create_artifact` | Save documents under `<workspace>/.bluma/artifacts/<session>/` |
+| `read_artifact` | Read artifacts from the current session directory |
+
+### Thread Management (v0.1.84+)
+| Tool | Description |
+|------|-------------|
+| `thread_create` | Create new conversation thread |
+| `thread_list` | List all threads |
+| `thread_switch` | Switch to different thread |
+| `thread_archive` | Archive a thread |
 
 ### Knowledge & Research
 | Tool | Description |
@@ -339,7 +364,6 @@ BluMa includes **45+ built-in tools** organized by category:
 |------|-------------|
 | `lsp_query` | LSP go-to-definition or references (TS/JS) |
 | `repl` | Interactive code execution (Python, Node, Bash) |
-| `task_output` | Read task output in real-time |
 
 ### Specialized
 | Tool | Description |
@@ -363,6 +387,29 @@ BluMa includes **45+ built-in tools** organized by category:
 
 ## Current Features
 
+### Thread System (v0.1.84+)
+**Multi-thread conversation management** for isolated contexts:
+
+```typescript
+// Create a new thread
+thread_create({
+  name: "Feature Implementation",
+  context: "Working on authentication module"
+})
+
+// List all threads
+thread_list()
+
+// Switch between threads
+thread_switch({ threadId: "thread-123" })
+```
+
+**Key Benefits:**
+- **Isolated contexts** - Each thread maintains separate conversation history
+- **Parallel work** - Work on multiple features simultaneously
+- **Context preservation** - Switch without losing previous context
+- **Thread-specific memory** - Coding memories scoped to threads
+
 ### Mailbox System (Bidirectional Communication)
 **Push-based communication** between coordinator and workers using EventEmitter:
 
@@ -619,6 +666,18 @@ task_boundary({
 });
 ```
 
+### Thread Manager (v0.1.84+)
+
+Manage multiple conversation threads:
+
+```typescript
+// Thread operations
+thread_create({ name: "Feature A" })
+thread_list()
+thread_switch({ threadId: "..." })
+thread_archive({ threadId: "..." })
+```
+
 ### Hook Registry
 
 Event-driven lifecycle tracking:
@@ -659,6 +718,7 @@ Real-time system snapshot:
 > /diagnostics hooks     # Hook registry status
 > /diagnostics plugins   # Plugin registry status
 > /diagnostics sessions  # Active sessions
+> /diagnostics threads   # Thread overview
 ```
 
 ### Runtime Files
@@ -669,6 +729,7 @@ Real-time system snapshot:
 | `~/.bluma/hooks.json` | Hook registry state |
 | `~/.bluma/sessions/` | Session history and logs |
 | `~/.bluma/plugins/` | Global plugin storage |
+| `~/.bluma/threads/` | Thread storage |
 
 ### Tool Execution Policy
 
@@ -705,6 +766,14 @@ Built-in terminal commands (type `/` to see all):
 | `/compact` | Manually compact conversation context |
 | `/export` | Export conversation as markdown |
 
+### Threads (v0.1.84+)
+| Command | Description |
+|---------|-------------|
+| `/threads` | List all conversation threads |
+| `/thread [id]` | Switch to thread or show current |
+| `/thread new [name]` | Create new thread |
+| `/thread archive [id]` | Archive a thread |
+
 ### Agent
 | Command | Description |
 |---------|-------------|
@@ -750,6 +819,7 @@ Built-in terminal commands (type `/` to see all):
 |----------|-------------|
 | `Ctrl+V / Cmd+V` | Paste from clipboard: image → cache `~/.cache/bluma/clipboard`; text; or file path as image |
 | `Ctrl+Shift+I` | Same as Ctrl+V (paste image, text, or file path) |
+| `Ctrl+O` | Expand truncated previews in tool results |
 
 ---
 
@@ -759,6 +829,8 @@ Built-in terminal commands (type `/` to see all):
 
 ```bash
 npm run build        # Production build
+npm run build:native # Build native modules
+npm run build:all    # Build native + main
 npm start           # Build + run
 ```
 
@@ -769,6 +841,15 @@ npm run lint        # Check code style
 npm run lint:fix    # Auto-fix issues
 ```
 
+### Test
+
+```bash
+npm test            # Run all tests
+npm run test:watch  # Watch mode
+npm run test:parallel        # Parallel test execution
+npm run test:parallel:fast   # Fast parallel with 8 workers
+```
+
 ### Project Structure
 
 ```
@@ -787,7 +868,7 @@ src/
 │   │   │   └── types/
 │   │   │       └── errors.ts           # Error type definitions
 │   │   ├── config/
-│   │   │   ├── native_tools.json       # Tool definitions (45+)
+│   │   │   ├── native_tools.json       # Tool definitions (50+)
 │   │   │   ├── skills/                 # Bundled skills
 │   │   │   │   ├── git-commit/
 │   │   │   │   ├── git-pr/
@@ -797,10 +878,6 @@ src/
 │   │   │   │   └── xlsx/
 │   │   │   │       └── scripts/
 │   │   │   │           └── office/     # Office document handling
-│   │   │   │               ├── pack.py
-│   │   │   │               ├── unpack.py
-│   │   │   │               ├── validate.py
-│   │   │   │               └── soffice.py
 │   │   ├── core/                       # LLM, context, prompts
 │   │   │   ├── context-api/            # Context management
 │   │   │   │   ├── context_manager.ts  # Token-aware context
@@ -820,13 +897,18 @@ src/
 │   │   │   │   ├── system_prompt_sections.ts
 │   │   │   │   ├── system_reminders.ts
 │   │   │   │   └── tool_guidance.ts
+│   │   │   ├── thread/                 # Thread management (v0.1.84+)
+│   │   │   │   ├── index.ts
+│   │   │   │   ├── thread_manager.ts
+│   │   │   │   ├── thread_store.ts
+│   │   │   │   └── types.ts
 │   │   │   └── context_viz.ts          # Context visualization
 │   │   ├── docs/
 │   │   │   └── TOOL_PARITY.md          # Tool parity documentation
 │   │   ├── feedback/
 │   │   │   └── feedback_system.ts      # Smart feedback system
 │   │   │   └── feedback_scoring.ts     # User feedback scoring
-│   │   ├── runtime/                    # Orchestration layer (v0.1.41+)
+│   │   ├── runtime/                    # Orchestration layer
 │   │   │   ├── diagnostics.ts          # System snapshots
 │   │   │   ├── feature_flags.ts        # Feature gates
 │   │   │   ├── hook_registry.ts        # Event-driven hooks
@@ -867,7 +949,7 @@ src/
 │   │   │   │   └── mcp_client.ts       # MCP SDK client
 │   │   │   ├── shared/
 │   │   │   │   └── token_utils.ts      # Token utilities
-│   │   │   └── natives/                # 45+ native tool implementations
+│   │   │   └── natives/                # 50+ native tool implementations
 │   │   │       ├── agent_coordination.ts
 │   │   │       ├── ask_user_question.ts
 │   │   │       ├── async_command.ts
@@ -879,6 +961,7 @@ src/
 │   │   │       ├── file_write.ts
 │   │   │       ├── find_by_name.ts
 │   │   │       ├── grep_search.ts
+│   │   │       ├── list_mailbox_messages.ts
 │   │   │       ├── load_skill.ts
 │   │   │       ├── ls.ts
 │   │   │       ├── lsp_query.ts
@@ -886,11 +969,16 @@ src/
 │   │   │       ├── message.ts
 │   │   │       ├── notebook_edit.ts
 │   │   │       ├── plan_mode_tools.ts
+│   │   │       ├── poll_mailbox.ts
 │   │   │       ├── readLines.ts
+│   │   │       ├── repl.ts
 │   │   │       ├── search_web.ts
+│   │   │       ├── send_message.ts
 │   │   │       ├── session_cron.ts
 │   │   │       ├── shell_command.ts
+│   │   │       ├── signal_mailbox.ts
 │   │   │       ├── task_boundary.ts
+│   │   │       ├── task_output.ts
 │   │   │       ├── task_tools.ts
 │   │   │       ├── todo.ts
 │   │   │       ├── view_file_outline.ts
@@ -905,29 +993,38 @@ src/
 │   │       └── user_message_images.ts
 │   └── ui/
 │       ├── App.tsx                     # Main UI component
+│       ├── BlumaSession.tsx            # Session component (v0.1.84+)
 │       ├── Asci/
 │       │   └── AsciiArt.ts
-│       ├── components/                 # 25+ UI components
+│       ├── components/                 # 35+ UI components
 │       │   ├── AnimatedBorder.tsx
 │       │   ├── AskUserQuestionPrompt.tsx
 │       │   ├── AssistantMessageDisplay.tsx
+│       │   ├── BlumaBottomDock.tsx     # Bottom dock (v0.1.84+)
+│       │   ├── BlumaShell.tsx          # Shell container (v0.1.84+)
+│       │   ├── BlumaTranscript.tsx     # Message transcript (v0.1.84+)
+│       │   ├── BlumaViewport.tsx       # Viewport container (v0.1.84+)
+│       │   ├── BlumaWorkersOverlay.tsx # Workers overlay (v0.1.84+)
 │       │   ├── CollapsibleResult.tsx
 │       │   ├── ConfirmationPrompt.tsx  # Permission confirmation dialog
+│       │   ├── CtrlOToExpand.tsx       # Ctrl+O expansion (v0.1.84+)
 │       │   ├── EditToolDiffPanel.tsx   # Diff preview for edits
 │       │   ├── ErrorMessage.tsx
 │       │   ├── ExpandedPreviewBlock.tsx
+│       │   ├── FilePathLink.tsx        # File path links (v0.1.84+)
+│       │   ├── HighlightedCode.tsx     # Syntax highlighting (v0.1.84+)
 │       │   ├── InputPrompt.tsx         # User input
 │       │   ├── InteractiveMenu.tsx     # Interactive menu component
 │       │   ├── MarkdownRenderer.tsx
 │       │   ├── ProgressBar.tsx
 │       │   ├── ReasoningDisplay.tsx    # LLM reasoning
-│   │   │   ├── SessionInfoConnectingMCP.tsx
 │       │   ├── SessionStats.tsx
 │       │   ├── SimpleDiff.tsx
 │       │   ├── SlashCommands.tsx       # 30+ commands
-│       │   ├── StatusNotification.tsx
 │       │   ├── StartupUpdateGate.tsx   # Update check gate
+│       │   ├── StatusNotification.tsx
 │       │   ├── StreamingText.tsx       # Live text output
+│       │   ├── TaskDisplay.tsx
 │       │   ├── TodoPlanDisplay.tsx     # Task visualization
 │       │   ├── ToolCallDisplay.tsx
 │       │   ├── ToolInvocationBlock.tsx
@@ -939,33 +1036,35 @@ src/
 │       │   ├── WorkerStatusList.tsx    # Active workers list
 │       │   ├── WorkerTranscript.tsx    # Worker conversation transcript
 │       │   ├── WorkingTimer.tsx        # Work duration timer
+│       │   ├── WorkingShimmerText.tsx  # Shimmer text effect
 │       │   ├── streamingTextFlush.ts
-│       │   └── toolCallRenderers.tsx
+│       │   ├── toolCallRenderers.tsx
+│       │   └── slash-commands/         # Slash command renderers
+│       │       ├── SessionLivePanel.tsx
+│       │       ├── SlashCommands.types.ts
+│       │       ├── commandHelpers.tsx
+│       │       ├── constants.ts
+│       │       └── renderers/
+│       │           ├── index.ts
+│       │           ├── configRenderers.tsx
+│       │           ├── infoRenderers.tsx
+│       │           ├── permissionRenderers.tsx
+│       │           ├── pluginRenderers.tsx
+│       │           ├── sessionRenderers.tsx
+│       │           ├── staticRenderers.tsx
+│       │           ├── taskRenderers.tsx
+│       │           └── threadRenderers.tsx  # Thread renderers (v0.1.84+)
 │       ├── constants/
 │       │   ├── historyLayout.ts        # History layout constants
 │       │   ├── inputPaste.ts           # Input paste constants
-│       │   └── toolUiPreview.ts        # Tool UI preview constants
+│       │   ├── toolUiPreview.ts        # Tool UI preview constants
 │       │   └── toolUiSymbols.ts        # Tool UI symbols
 │       ├── hooks/
 │       │   ├── useAtCompletion.ts      # Completion hook
+│       │   ├── useBlumaSessionRuntime.tsx  # Session runtime hook (v0.1.84+)
 │       │   └── useWorkerProgress.ts    # Worker progress hook
 │       ├── prompts/
 │       │   └── initCommandPrompt.ts    # Init command prompt
-│       ├── slash-commands/
-│       │   ├── SlashCommands.types.ts  # Type definitions
-│       │   ├── commandHelpers.tsx      # Command helpers
-│       │   ├── constants.ts            # Slash command constants
-│       │   ├── SessionLivePanel.tsx    # Session live panel
-│       │   ├── streamingTextFlush.ts   # Streaming text flush
-│       │   └── renderers/
-│       │       ├── index.ts
-│       │       ├── configRenderers.tsx
-│       │       ├── infoRenderers.tsx
-│       │       ├── permissionRenderers.tsx
-│       │       ├── pluginRenderers.tsx
-│       │       ├── sessionRenderers.tsx
-│       │       ├── staticRenderers.tsx
-│       │       └── taskRenderers.tsx
 │       ├── theme/
 │       │   ├── blumaTerminal.ts
 │       │   ├── themes.ts               # Theme definitions
@@ -984,7 +1083,10 @@ src/
 │           ├── toolActionLabels.ts     # Tool action labels
 │           ├── toolDisplayLabels.ts    # Tool display labels
 │           ├── toolInvocationPairing.ts
-│           └── useSimpleInputBuffer.ts
+│           ├── toolResultStatusStore.ts
+│           ├── update_message.ts
+│           ├── useSimpleInputBuffer.ts
+│           └── vim_engine.ts           # Vim mode engine
 ├── main.ts                             # Entry point
 └── types/
     └── semver-functions.d.ts
@@ -997,12 +1099,14 @@ src/
 ```bash
 npm test            # Run all tests
 npm run test:watch  # Watch mode
+npm run test:parallel        # Parallel execution
+npm run test:parallel:fast   # Fast mode with 8 workers
 ```
 
 ### Test Structure
 
 ```
-tests/                    # 35+ test files (flat structure)
+tests/                    # 40+ test files
 ├── agent_*.spec.ts       # Agent routing, overlays, coordination
 ├── edit_tool.spec.ts     # File editing operations
 ├── file_write.spec.ts    # File write operations
@@ -1026,6 +1130,8 @@ tests/                    # 35+ test files (flat structure)
 ├── ui_*.spec.ts(x)       # UI component tests
 ├── llm_stream_partial.spec.ts # LLM streaming partial handling
 ├── llm_errors.spec.ts    # LLM error handling
+├── context_manager_sanitize.spec.ts # Context sanitization
+├── coordinator-worker-mailbox.integration.spec.ts # Mailbox system
 ├── jest-resolver.cjs     # Jest resolver configuration
 └── ...                   # Additional integration and unit tests
 ```
@@ -1067,16 +1173,20 @@ Apache 2.0 — see [LICENSE](LICENSE) for details.
 - **Author & Architect**: Alex Fonseca (conceived and architected BluMa)
 - **npm Package**: [@nomad-e/bluma-cli](https://www.npmjs.com/package/@nomad-e/bluma-cli)
 
-### Runtime Modules (v0.1.41+)
+### Runtime Modules
 
 BluMa's runtime layer provides enterprise-grade orchestration:
 
 | Module | Purpose | Key Features |
 |--------|---------|--------------|
 | `task_store.ts` | Task lifecycle | PLANNING → EXECUTION → VERIFICATION phases, persistence |
+| `thread_manager.ts` | Thread management | Multi-thread conversations, context isolation |
 | `hook_registry.ts` | Event system | Tool calls, decisions, state changes |
 | `plugin_registry.ts` | Plugin system | Load from `.bluma/plugins/`, lifecycle management |
 | `session_registry.ts` | Multi-session | Process health monitoring, session isolation |
+| `mailbox_registry.ts` | Communication | Bidirectional coordinator-worker messaging |
+| `worker_context.ts` | Worker isolation | AsyncLocalStorage-based context |
+| `permission_rules.ts` | Permissions | Granular allow/deny rules |
 | `sandbox_policy.ts` | Safety | Safe vs dangerous tool classification |
 | `tool_execution_policy.ts` | Execution rules | Auto-approve, confirm, block decisions |
 | `diagnostics.ts` | System snapshots | Tasks, hooks, plugins, sessions overview |
@@ -1096,6 +1206,12 @@ Key UI components that power the rich terminal experience:
 
 | Component | Purpose |
 |-----------|---------|
+| `BlumaSession.tsx` | Main session component with event handling |
+| `BlumaShell.tsx` | Shell container for layout |
+| `BlumaViewport.tsx` | Viewport container for responsive layout |
+| `BlumaTranscript.tsx` | Message transcript display |
+| `BlumaBottomDock.tsx` | Bottom dock for status and controls |
+| `BlumaWorkersOverlay.tsx` | Overlay for worker status |
 | `EditToolDiffPanel.tsx` | Side-by-side diff previews before edits |
 | `ToolResultCard.tsx` | Structured tool output display |
 | `SlashCommands.tsx` | Command palette and help |
@@ -1109,6 +1225,10 @@ Key UI components that power the rich terminal experience:
 | `AskUserQuestionPrompt.tsx` | Multiple-choice question UI |
 | `ToolInvocationBlock.tsx` | Tool call visualization |
 | `AssistantMessageDisplay.tsx` | Assistant message formatting |
+| `CtrlOToExpand.tsx` | Ctrl+O expansion for previews |
+| `FilePathLink.tsx` | Clickable file path links |
+| `HighlightedCode.tsx` | Syntax highlighted code blocks |
+| `WorkingShimmerText.tsx` | Shimmer text effect for loading states |
 
 ---