5 Commits

Include renames

Author	SHA1	Message	Date
mathias	0b04e487ad	docs: update card-state model — 'Summarize now' verb, no-captions state, five-state table	2026-06-06 22:42:37 +02:00
mathias	e472015c76	docs: replace evasion framing with honest onboarding-prioritisation rationale ... 'Try now' and the newest-first batch implement onboarding prioritisation: foreground (user-clicked 'Try now') summarises a chosen video on demand; background batch summarises newest-first; both honour the shared rate gate. Remove any prior framing that described 'Try now' as making traffic 'look organic to YouTube' or as rate-limit evasion — that was not the rationale and contradicts ADR-014's explicit account-safety constraint. Correct statement: rate limiting is respected, not evaded. TAPIR_FETCH_RATE and TAPIR_FETCH_BACKOFF are honest rate controls; they govern how fast Tapir fetches captions, not how the requests appear to YouTube. Architecture: add two-path model table (foreground/background, both through globalFetchGate) and newest-first batch ordering doc (three-phase RunOnce, before/after example). ui-spec: add 'Try now' row with correct rationale; add pipeline stats bar row; update Summarized-only filter row to mention sort-to-top.	2026-06-06 21:29:28 +02:00
mathias	252a4ebd9e	docs(architecture): add in-process scheduler sequence, rate gate description, auto_summarize default fix	2026-06-06 11:27:18 +02:00
mathiasandClaude Opus 4.8	1018dc0df9	docs(architecture): document the tapir serve web surface (ADR-011/012) ... The C4 view predated the web transport. Added a "Web surface" section with a component diagram and prose covering: tapir serve (HTMX+Templ over the unchanged store), oidc authenticate-only session, registration gate (users + user_identities), per-user YouTube web connect callback, account disconnect/delete (ADR-013 tapir-side only), immediate summarization via background goroutine + HTMX status poll, and auto/manual summarize mode (migration 006). Relabeled the L2 http node to tapir serve. Corrected the out-of-scope isolation bullet: RLS is live (ADR-012, migration 003), not deferred. ADR-003 stance preserved — the engine/ports/sinks core is untouched; the web is a new transport. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>	2026-06-03 22:18:23 +02:00
mathias	af38999ee2	docs: add C4 architecture + sequence diagrams (Mermaid) ... Context and container diagrams, sequence diagrams for the core summarize-new-video use case and the local-first/BYO AI routing fallback, and the Clean Architecture layering. Ports & adapters keep the engine provider- and sink-agnostic, making standalone-vs-homelab a wiring choice (ADR-003), not two codebases.	2026-06-02 10:31:37 +00:00