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

@@ -1,21 +1,33 @@
# Track Specification: On-Demand Definition Lookup (on_demand_def_lookup_20260306)
## Overview
Add ability for agent to request specific class/function definitions during discussion. User @mentions symbol for inline definition, or AI auto-fetches on unknown symbols.
Add ability for agent to request specific class/function definitions during discussion. Parse @symbol syntax to trigger lookup.
## Architectural Constraints
- **Fast Lookup**: Definition lookup MUST complete in <100ms.
- **Accurate Parsing**: Symbol parsing MUST handle edge cases.
## Current State Audit
### Already Implemented
- **`mcp_client.py_get_definition()`**: Returns full definition source
- **`outline_tool.py`**: Code outlining
### Gaps to Fill
- No @symbol parsing in discussion input
- No inline definition display
- No click-to-source navigation
## Functional Requirements
- **@Syntax**: Parse @symbol to trigger lookup.
- **Inline Display**: Show definition inline in discussion.
- **Auto-Fetch**: Option for AI to auto-fetch on unknown symbols.
- **Navigation**: Click definition to jump to source.
- Parse `@ClassName` or `@function_name` in input
- Display definition inline in discussion
- Click to jump to source file
- Uses existing `py_get_definition()` tool
## Key Integration Points
| File | Purpose |
|-----|---------|
| `src/gui_2.py` | Input parsing, definition display |
| `src/mcp_client.py` | `py_get_definition()` |
## Acceptance Criteria
- [ ] @symbol triggers lookup.
- [ ] Definition displays inline.
- [ ] Auto-fetch option works.
- [ ] Click navigation functional.
- [ ] Uses existing py_get_definition.
- [ ] @symbol triggers lookup
- [ ] Definition displays inline
- [ ] Click navigation functional
- [ ] 1-space indentation