84 lines
3.5 KiB
Markdown
84 lines
3.5 KiB
Markdown
# Sprint 37 Plan: In-Editor Agent Chat Panel
|
||
|
||
## Context
|
||
|
||
Sprint 37 builds the "full window in the editor" agent UX — the plug-and-play
|
||
experience for non-technical users. Agent chat embedded directly in the ImGui
|
||
editor with live tool call visualization, mutation preview, and accept/reject
|
||
controls. No terminal required.
|
||
|
||
Primary goals:
|
||
1. Embedded chat panel with message history and streaming responses
|
||
2. Live tool call visualization and AST mutation preview
|
||
3. Human-in-the-loop accept/reject for every agent mutation
|
||
4. Context auto-injection and session persistence
|
||
|
||
---
|
||
|
||
## Phase 37a: Chat Window Core (Steps 624–628)
|
||
|
||
### Step 624: Agent Chat Panel model (12 tests)
|
||
New panel: message history (scrollable), text input (multi-line), send button.
|
||
Messages: role (user/assistant/tool), content, timestamp. State lives in
|
||
AgentChatState sub-struct. Renders via ImGui but shares no state with EditorState
|
||
globals.
|
||
|
||
### Step 625: Tool call visualization (12 tests)
|
||
When Claude calls a Whetstone tool, render it inline in the chat as a collapsible
|
||
block: `[TOOL: whetstone_mutate] ▶ setProperty fn1.name → "newName"`. Show
|
||
input/output JSON. Lets user see exactly what the agent is doing.
|
||
|
||
### Step 626: AST mutation preview (12 tests)
|
||
Before applying any agent-requested mutation: show a side-by-side diff of the
|
||
generated code before vs after. User sees the change before it's committed.
|
||
Requires generating code from both old and new AST.
|
||
|
||
### Step 627: Inline accept/reject controls (12 tests)
|
||
Under each mutation preview: [Accept] [Reject] [Modify]. Accept applies the
|
||
mutation. Reject discards it and posts "rejected: <reason>" back to the agent.
|
||
Modify opens the mutation in an editable JSON view. Human-in-the-loop at every
|
||
agent action.
|
||
|
||
### Step 628: Phase 37a Integration (8 tests)
|
||
Full chat flow: user types spec → agent calls whetstone_generate_code → mutation
|
||
preview shown → user accepts → AST updated → code view refreshes.
|
||
|
||
---
|
||
|
||
## Phase 37b: Context + Persistence (Steps 629–633)
|
||
|
||
### Step 629: Project context auto-injection (12 tests)
|
||
On chat start, auto-inject a context block into the system prompt: active file
|
||
name, language, AST node count, open annotations count, workspace path. The agent
|
||
starts every conversation knowing where it is.
|
||
|
||
### Step 630: Chat session persistence (12 tests)
|
||
Save/restore chat sessions per project file. Format: JSON alongside .whetstone.json.
|
||
Sessions indexed by timestamp. Reload on next open. User can continue a previous
|
||
conversation without losing context.
|
||
|
||
### Step 631: Background task slots (parallel agent work) (12 tests)
|
||
Run up to N agent tasks in parallel (N from project config). Each slot has its
|
||
own chat thread. Slots shown as tabs in the chat panel. Lets user kick off
|
||
"generate the test suite" while also asking "explain this function."
|
||
|
||
### Step 632: Agent task status overlay (12 tests)
|
||
Status bar item: `[Agent: 2 running, 1 pending]`. Click to open task panel.
|
||
Each task shows: description, elapsed time, tool calls made, current step.
|
||
Cancel button per task.
|
||
|
||
### Step 633: Sprint 37 Integration + Summary (8 tests)
|
||
Demo scenario: open hivemind project → chat panel opens → paste BS-S1-01 task
|
||
description → agent generates drone/nexus code → user accepts mutations →
|
||
code panel shows generated Rust/C++ → chat session saved.
|
||
|
||
---
|
||
|
||
## Step & Test Summary
|
||
|
||
| Phase | Steps | Tests | Theme |
|
||
|-------|-------|-------|-------|
|
||
| 37a | 624–628 | 56 | Chat window core + mutation preview |
|
||
| 37b | 629–633 | 56 | Context injection + session persistence |
|
||
| **Total** | **624–633** | **~112** | 10 steps |
|