3 Commits

Include renames

Author	SHA1	Message	Date
mathiasandClaude Opus 4.8	cd461b95f8	feat(observability): instrument AI + HTTP paths, serve /metrics on a side port (ADR-030, #15) ... Wire the metrics package into the live paths and serve it: - summarizer: per-endpoint latency by model/outcome(success|error|parse_error)/fallback + slog. - youtube.FetchTranscript: latency by outcome (captions|none|rate_limited) + slog. - chat: answer latency by model + slog. - llm usage hook → token counts (prompt|completion) per model, wired in buildSummarizer/buildChat. - oidc callback: login counter. - cmdServe: wrap Router in metrics.HTTPMiddleware (request count + latency by bounded route pattern) and serve /metrics on TAPIR_METRICS_ADDR (default :9090), a SEPARATE port — never on the public app mux. BDD: observability.feature scenarios un-pended + mapped. TDD: summarizer wiring tested black-box via the /metrics scrape; metrics-not-on-public-mux asserted. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>	2026-06-12 08:49:51 +02:00
mathiasandClaude Opus 4.8	e9b5a3f3e7	feat(summarizer): resilient endpoint chain with local→cloud fallback (ADR-022) ... The first friendly-pilot live run produced zero summaries: koala/phi4-mini hit three silent failure modes — 8k context overflow on long transcripts (HTTP 400), intermittent malformed JSON (highlights as a bare string), and no fallback wired at all (summarizer.New(primary, nil)). Keep phi4-mini as the fast primary and add resilience around it: - Ordered endpoint chain (summarizer.NewChain): phi4-mini → koala/phi4-14b (local) → berget/mistral-small (worst-case external). All reached through the one LiteLLM gateway by alias. - A parse failure now advances the chain like a transport error — the old Primary→Fallback shape returned the parse error without trying anyone else. - Tolerant parse: highlights/takeaways coerce string→[]string, absorbing the common small-model quirk without spending a fallback round-trip. - Transcript truncation (TAPIR_MAX_TRANSCRIPT_CHARS=18000) prevents the overflow rather than recovering from it; validated to fit phi4-mini's 8k window. - Bounded completion budget (TAPIR_SUMMARY_MAX_TOKENS=1500) — the old 8192 budget itself contributed to the overflow. Local-first guarantee preserved by ordering: external endpoint is tried only after every local one fails. TAPIR_CLOUD_FALLBACK_MODEL="" disables it entirely for client/NDA deployments. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>	2026-06-10 08:36:16 +02:00
mathiasandClaude Opus 4.8	6da9d61e63	feat(adapters): add Summarizer backed by local-first llm routing ... Implement ports.Summarizer in internal/adapters/summarizer. It routes through a local Primary endpoint first and an optional BYO Fallback, owning the routing itself (not delegating to llm.Router) so it can record AIProvider, AIModel, and FallbackUsed on domain.Summary. Prompt asks for JSON {summary, highlights, takeaways}; the parser tolerates thinking-model fences/reasoning and rejects an empty summary. The summarizer is the single egress point for content toward an AI model, so it enforces the local-first guarantee from ai_routing.feature: with no BYO configured (nil fallback) there is no external endpoint, so content reaches the local stack and nowhere else. Tests assert all four scenarios via a fake client. Model alias is config (TAPIR_SUMMARIZER_MODEL, host/name) — not hardcoded; docs/homelab-integration.md notes it stays `confirm` and that thinking models need an explicit max_tokens or they return empty content. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>	2026-06-02 17:04:29 +02:00