066-tldr: knowledge outline with synopses

[ahoward]

Summary

brane tldr — show a structured outline of everything brane knows, organized by topic with one-line synopses. The "table of contents" for your knowledge graph.

Why

brane status shows counts. brane graph summary shows type breakdowns. Neither tells you what brane knows in human terms. tldr fills that gap — a quick glance at accumulated knowledge without querying.

What

CLI

brane tldr                     # full outline
brane tldr --focus "auth"      # focused on a topic
brane tldr --json              # structured output

Output

## Authentication & Authorization
- AuthService handles JWT token lifecycle (15min expiry, refresh rotation)
- Rate limiting on login: sliding window, 5 req/min per IP
- UserDB stores credentials with bcrypt hashing

## Data Layer
- PostgreSQL primary, Redis cache
- User table has unique index on email
- Connection pooling via pgbouncer

## Recent Learnings
- Discovered auth/rate-limit coupling during staging debug (2026-03-27)
- Payment service is single point of failure for refunds (2026-03-26)

3 topics, 8 concepts, 5 edges, 4 episodes

Flow

1. Load graph summary + recent episodes
2. LLM organizes into topical outline with one-line synopses
3. Appends stats footer

MCP Tool

tldr: { focus?: string }

Depends On

• 059-digest: consume URLs, files, directories, stdin into knowledge graph #82 (059-digest) or existing data — works with any populated graph

Acceptance

• Generates human-readable topic outline
• Focus mode narrows to a topic area
• Includes recent episodes/learnings
• Stats footer
• MCP tool exposed
• Spike test passes