docs: add TODO.md and FINDINGS.md for fleet delegation

Co-Authored-By: Virgil <virgil@lethean.io>
This commit is contained in:
Virgil 2026-02-19 21:36:16 +00:00 committed by Snider
parent 474b0861e1
commit d29a76a443
2 changed files with 51 additions and 0 deletions

21
FINDINGS.md Normal file
View file

@ -0,0 +1,21 @@
# FINDINGS.md -- go-session
## 2026-02-19: Split from core/go (Virgil)
### Origin
Extracted from `forge.lthn.ai/core/go` `pkg/session/` on 19 Feb 2026.
### Architecture
- Parses Claude Code JSONL transcripts into an `Event` array
- Each event has type, timestamp, content, and optional tool metadata
- Supported tool types: Bash, Read, Edit, Write, Grep, Glob, Task
### Dependencies
- Zero external dependencies -- standard library only (`encoding/json`, `bufio`, `os`)
### Tests
- Test coverage for JSONL parsing and event type detection

30
TODO.md Normal file
View file

@ -0,0 +1,30 @@
# TODO.md -- go-session
## Phase 1: Parser Robustness
- [ ] Handle truncated JSONL (incomplete final line, missing closing brace)
- [ ] Handle very large sessions (streaming parse, avoid loading entire file into memory)
- [ ] Handle non-standard tool formats (custom MCP tools, unknown tool names)
- [ ] Add graceful error recovery -- skip malformed lines, log warnings
## Phase 2: Analytics
- [ ] Session duration stats (start time, end time, wall clock, active time)
- [ ] Tool usage frequency (count per tool type, percentage breakdown)
- [ ] Error rate tracking (failed tool calls, retries, panics)
- [ ] Token usage estimation from assistant message lengths
## Phase 3: Timeline UI
- [ ] Feed parsed events into go-html for visual session timeline
- [ ] Colour-code events by type (tool call, assistant message, user message)
- [ ] Add collapsible detail panels for long tool outputs
- [ ] Export timeline as standalone HTML file
---
## Workflow
1. Virgil in core/go writes tasks here after research
2. This repo's dedicated session picks up tasks in phase order
3. Mark `[x]` when done, note commit hash