Skip to content

Increment 5: Debug panel, UI overhaul, enriched book cards#13

Merged
amoghbanta merged 3 commits intomainfrom
increment-5-pipeline-ux
Feb 10, 2026
Merged

Increment 5: Debug panel, UI overhaul, enriched book cards#13
amoghbanta merged 3 commits intomainfrom
increment-5-pipeline-ux

Conversation

@amoghbanta
Copy link
Collaborator

Summary

  • Developer debug panel (Cmd+Shift+D): Bottom drawer on all book routes with 4 tabs — LLM Logs (live SSE + paginated history with status indicators and step tracker), Pipeline Stats (per-step token/cache/cost aggregation), Active Config (merged view), and Version History (entity inspection)
  • UI overhaul: Removed global header in favor of per-page breadcrumb navigation; redesigned home page with 30/70 vertical split (workflow guide left, vertical book list right); symmetric grid layouts and reduced padding across all pages
  • Enriched book cards: BookSummary now includes publisher and languageCode from pipeline metadata; home page cards show all available metadata with labeled icon rows
  • Code cleanup: Removed orphaned BookCard/BookList components, eliminated redundant type casts in debug panel, fixed .gitignore for apps/api/books/, fixed --destructive-foreground CSS variable
  • Documentation: Added layout guidelines to GUIDELINES.md; added decisions Add pipeline UX, config editor, debug panel, and book wizard #15 (breadcrumb nav) and Add integration test for full pipeline with LLM cache fixtures #16 (home page layout) to DECISIONS.md

New files

File Purpose
apps/api/src/routes/debug.ts 4 REST endpoints for debug data
apps/api/src/routes/debug.test.ts 13 tests covering all debug endpoints
apps/studio/src/components/debug/*.tsx 5 debug panel components
apps/studio/src/hooks/use-debug.ts TanStack Query hooks for debug data

Test plan

  • pnpm typecheck passes
  • pnpm test passes (236 tests, 27 files)
  • Manual: Open a book → Cmd+Shift+D → verify debug panel opens with all 4 tabs
  • Manual: Run pipeline → verify live LLM logs stream in with status dots and step tracker
  • Manual: Home page shows workflow guide (left) and book list (right) with full metadata
  • Manual: Breadcrumb navigation works on all pages
  • Manual: Delete button and dialog work correctly on home page

Debug panel (Cmd+Shift+D):
- Bottom drawer with 4 tabs: LLM Logs, Stats, Config, Versions
- Live SSE streaming of llm-log events during pipeline runs
- Step tracker showing pipeline progress with status indicators
- REST endpoints for paginated logs, aggregated stats, config view

UI overhaul:
- Remove global header, use per-page breadcrumb navigation
- Home page: 30/70 split with workflow guide + vertical book list
- Book cards show full metadata (title, authors, publisher, language)
- Fix destructive-foreground CSS variable (was invisible red-on-red)
- Symmetric grid layouts, reduced padding, no-scroll-where-possible

Backend:
- BookSummary enriched with publisher and languageCode fields
- Pipeline runner emits llm-log SSE events for live observability
- Debug routes: llm-logs, stats, config, versions

Cleanup:
- Delete orphaned BookCard.tsx and BookList.tsx (inlined in home page)
- Remove redundant type casts in debug panel components
- Fix .gitignore for apps/api/books/ directory
- Add layout guidelines to docs/GUIDELINES.md
- Document decisions: breadcrumb nav (#15), home layout (#16)
Integrates pipeline team changes (PR #12 llm-updates):
- Rate limiting, per-attempt LLM logging, single-arg appendLlmLog API
- Schema version mismatch detection (needsRebuild/rebuildReason)
- Image src rewriting, configurable timeouts, validation improvements

Conflict resolutions:
- book-service.ts: main's error handling + our publisher/languageCode fields
- pipeline-runner.ts: main's rateLimiter + single-arg API + our SSE llm-log emit
- BookCard.tsx: kept deleted (inlined in index.tsx BookRow)
- books.$label.index.tsx: our 2-column layout + main's needsRebuild UI
Remove redundant second progress bar (bg-primary/black) that was
rendering alongside the primary blue bar in StepIndicator. Consolidate
page count and percentage into the single progress bar's status text.
@amoghbanta amoghbanta merged commit fb23fb9 into main Feb 10, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant