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,35 @@
# Track Specification: Session Insights & Efficiency Scores (session_insights_20260306)
## Overview
Token usage over time, cost projections, session summary with efficiency scores. Visualize session_logger data.
Token usage over time, cost projections, session summary with efficiency scores.
## Architectural Constraints
- **Efficient Calculation**: Metrics MUST be calculated incrementally.
- **Real-Time**: Updates SHOULD reflect current session state.
## Current State Audit
### Already Implemented
- **`session_logger.py`**: Logs comms, tool calls, API hooks
- **`ai_client.get_comms_log()`**: Returns API interaction history
- **`cost_tracker.estimate_cost()`**: Cost calculation
### Gaps to Fill
- No token timeline visualization
- No cost projection
- No efficiency score calculation
## Functional Requirements
- **Token Timeline**: Graph of token usage over session.
- **Cost Projection**: Estimate remaining budget based on usage.
- **Efficiency Score**: Calculate tokens-per-useful-change ratio.
- **Session Summary**: Text summary of session metrics.
- Token usage graph over session
- Cost projection based on burn rate
- Efficiency score (tokens per useful change)
- Session summary text
## Key Integration Points
| File | Purpose |
|-----|---------|
| `src/session_logger.py` | Read session data |
| `src/gui_2.py` | Timeline rendering |
## Acceptance Criteria
- [ ] Token timeline renders.
- [ ] Cost projection accurate.
- [ ] Efficiency score calculated.
- [ ] Summary displays key metrics.
- [ ] Uses existing session_logger.
- [ ] Token timeline renders
- [ ] Cost projection calculated
- [ ] Efficiency score shown
- [ ] Summary displays key metrics
- [ ] 1-space indentation