refinement of upcoming tracks

This commit is contained in:
2026-03-06 15:41:33 -05:00
parent 3ce6a2ec8a
commit fca40fd8da
24 changed files with 2388 additions and 391 deletions

View File

@@ -3,19 +3,34 @@
## Overview
Add UI controls to manually flag files for skeleton injection in discussions. Allow agent to request full file reads or specific def/class definitions on-demand.
## Architectural Constraints
- **Fast Generation**: Skeletons MUST generate in <500ms.
- **Non-Blocking**: Generation MUST NOT block UI.
## Current State Audit
### Already Implemented (DO NOT re-implement)
- **`file_cache.ASTParser.get_skeleton()`**: Returns Python skeleton
- **`mcp_client.py_get_skeleton()`**: MCP tool for skeleton generation
- **`aggregate.py`**: Builds file items context
### Gaps to Fill
- No UI to flag files for skeleton vs full
- No preview of skeleton before injection
- No on-demand definition lookup
## Functional Requirements
- **File Picker**: Browse and select files for skeleton injection.
- **Skeleton Preview**: Show generated skeleton before injection.
- **Manual Trigger**: Button to manually refresh skeleton.
- **Full Read Option**: Option to inject full file content instead.
- File picker UI in discussion panel
- Skeleton preview before injection
- Toggle: skeleton vs full file
- Uses existing `py_get_skeleton()` tool
## Key Integration Points
| File | Purpose |
|-----|---------|
| `src/gui_2.py` | File picker, injection UI |
| `src/mcp_client.py` | `py_get_skeleton()` |
| `src/file_cache.py` | `ASTParser` |
## Acceptance Criteria
- [ ] File picker UI functional.
- [ ] Skeleton preview displays.
- [ ] Manual refresh button works.
- [ ] Full read option available.
- [ ] Uses existing skeleton generation.
- [ ] File picker UI functional
- [ ] Skeleton preview displays
- [ ] Manual refresh button works
- [ ] Full read option available
- [ ] 1-space indentation