@steipete/summarize 0.9.0 → 0.11.0

package/CHANGELOG.md

@@ -1,5 +1,125 @@
 # Changelog
 
+## 0.11.0 - Unreleased
+
+### Highlights
+
+- Auto CLI fallback: new controls and persisted last-success provider state (`~/.summarize/cli-state.json`) for no-key/local-CLI workflows.
+- Transcription reliability: Groq Whisper is now the preferred cloud transcriber, with custom OpenAI-compatible Whisper endpoint overrides.
+- Input reliability: binary-safe stdin handling, local media support in `--extract`, and fixes for local-file hangs/PDF preprocessing on custom OpenAI base URLs.
+
+### Features
+
+- CLI: add Cursor Agent provider (`--cli agent`) for CLI-model execution.
+- CLI auto mode: add implicit auto CLI fallback controls (`cli.autoFallback`, `--auto-cli-fallback`) and provider priority controls (`cli.providers`, `--cli-priority`), with persisted provider success ordering.
+- Transcription: add Groq Whisper as preferred cloud provider (#71, thanks @n0an).
+- Transcription: support custom OpenAI-compatible Whisper endpoints via `OPENAI_WHISPER_BASE_URL` (with safe `OPENAI_BASE_URL` fallback) (#65, thanks @toanbot).
+- Config: support generic `env` defaults in `~/.summarize/config.json` (fallback for any env var), while keeping legacy `apiKeys` mapping for compatibility (#63, thanks @entropyy0).
+
+### Fixes
+
+- CLI local files: avoid hangs when stream usage never resolves and preprocess PDFs automatically for custom OpenAI-compatible `OPENAI_BASE_URL` endpoints (e.g. non-`api.openai.com`).
+- CLI stdin: support binary-safe piping/input temp files to prevent corruption on non-text stdin (#76).
+- Extract mode: allow `--extract` for local media files (#72).
+- Auto model/daemon fallback: skip model attempts when required API keys are missing and normalize env-key checks in daemon fallback (#67, #78).
+- Cache: for auto presets (`auto`/`free`/named auto), prefer preset-level winner cache entries so stale per-candidate cache hits don’t override newer better-model results.
+- Media: treat X broadcasts (`/i/broadcasts/...`) as transcript-first media and prefer URL mode.
+- YouTube: keep explicit `--youtube apify` working when HTML fetch fails, while preserving duration metadata parity (#64, thanks @entropyy0).
+- Transcription: stabilize Groq-first fallback flow (no duplicate Groq retries in file mode), improve terminal error reporting, and surface Groq setup in media guidance (#71, thanks @n0an).
+- Media detection: detect more direct media URL extensions including `.ogg`/`.opus` (#65, thanks @toanbot).
+- Slides: allow yt-dlp cookies-from-browser via `SUMMARIZE_YT_DLP_COOKIES_FROM_BROWSER` to avoid YouTube 403s.
+- Daemon install: resolve symlinked/global bin paths and Windows shims when locating the CLI for install (#57, #62, thanks @entropyy0).
+- Extraction: strip hidden HTML + invisible Unicode before summarization or extract output (#61).
+- CLI: honor `--lang` for YouTube transcript→Markdown conversion in `--markdown-mode llm` (#56, thanks @entropyy0).
+- LLM: map Anthropic bare model ids to versioned aliases (`claude-sonnet-4` → `claude-sonnet-4-0`) (#55, thanks @entropyy0).
+
+### Improvements
+
+- Tooling: remove Biome and standardize on `oxfmt` + type-aware `oxlint`; `pnpm check` now enforces `format:check` before lint/tests.
+- Dependencies: update workspace dependencies to latest (including `@mariozechner/pi-ai` and `oxlint-tsgolint`).
+
+## 0.10.0 - 2026-01-22
+
+### Highlights
+
+- Chrome Side Panel: **Chat mode** with metrics bar, message queue, and improved context (full transcript + summary metadata, jump-to-latest).
+- Media-aware summarization in the Side Panel: Page vs Video/Audio dropdown, automatic media preference on video sites, plus visible word count/duration.
+- Slides: **YouTube slide screenshots + OCR + transcript-aligned cards**, timestamped seek, and an OCR/Transcript toggle.
+- CLI: robust URL + media extraction with transcript-first workflows and cache-aware streaming.
+
+### Features
+
+- Chrome Side Panel chat: stream agent replies over SSE and restore chat history from daemon cache (#33, thanks @dougvk).
+- Media-aware summarization in the Side Panel: Page vs Video/Audio dropdown, automatic media preference on video sites, plus visible word count/duration.
+- Transcripts: `--timestamps` adds segment-level timings (`transcriptSegments` + `transcriptTimedText`) for YouTube, podcasts, and embedded captions.
+- Summaries: when transcript timestamps are available, prompts require timestamped bullet summaries; side panel auto-links `[mm:ss]` in summaries for media.
+- Chrome Side Panel chat: timestamped transcript context plus clickable `[mm:ss]` links that seek the current media.
+- Slides: extract slide screenshots + OCR for YouTube/direct video URLs in the CLI + extension (#41, thanks @philippb).
+- Slides: top-of-summary slide strip with expand/collapse full-width cards, timestamps, and click-to-seek.
+- Slides: slide descriptions without model calls (transcript windowing, OCR fallback) + OCR/Transcript toggle.
+- Slides: stream slide extraction status/progress and show a single header progress bar (no duplicate spinners).
+- CLI: transcribe local audio/video files with mtime-aware transcript cache invalidation (thanks @mvance!).
+- Browser extension: add Firefox sidebar build + multi-browser config (#31, thanks @vlnd0).
+- CLI: add Cursor Agent CLI provider (`cli/agent`, `--cli agent`).
+- Chrome automation: add artifacts tool + REPL helpers for persistent session files (notes/JSON/CSV) and downloads.
+- Chrome automation: expand navigate tool with list/switch tab support and return matching skills after navigation.
+
+### Fixes
+
+- Extract-only: remove implicit 8k cap; new `--max-extract-characters`/daemon `maxExtractCharacters` allow opt-in limits; resolves transcript truncation.
+- Media: route direct media URLs to the transcription pipeline and raise the local media limit to 2GB (#47, thanks @n0an).
+- Daemon (macOS): `daemon install` now falls back from `launchctl bootstrap gui/<uid>` to `user/<uid>` and resolves sudo/root uid targeting to avoid bootstrap `Input/output error` / `Domain does not support specified action` failures (#75).
+- Slides: allow yt-dlp cookies-from-browser via `SUMMARIZE_YT_DLP_COOKIES_FROM_BROWSER` to avoid YouTube 403s.
+- Chrome Side Panel chat: support JSON agent replies with explicit SSE/JSON negotiation to avoid “stream ended” errors.
+- Chrome Side Panel: scope streams/state per window so other windows don’t wipe active summaries.
+- Chrome Side Panel chat: keep auto-scroll pinned while streaming when you’re already at the bottom.
+- Chrome Side Panel chat: clear streaming placeholders on errors/aborts.
+- Chrome Side Panel: add inline error toast above chat composer; errors stay visible when scrolled.
+- Chrome Side Panel: clear/hide the inline error toast when no message is present to avoid empty red boxes.
+- Cache: include transcript timestamp requests in extract cache keys so timed summaries don’t reuse plain transcript content.
+- CLI: `--no-cache` now bypasses summary caching only; transcript/media caches still apply.
+- Media: treat X broadcasts (`/i/broadcasts/...`) as transcript-first media and prefer URL mode.
+- Daemon: avoid URL flow crashes when url-preference helpers are missing (ReferenceError guard).
+- YouTube: prefer English caption variants (`en-*`) when selecting caption tracks.
+- Prompts: ignore sponsor/ads segments in video and podcast summaries.
+- Prompts: enforce no-ads/no-skipped language and italicized standout excerpts (no quotation marks).
+- Slides: render Slide X/Y labels and parse slide markers more robustly in streaming output.
+- Slides: parse `Slide N/Total` labels and stabilize title/body extraction.
+- Slides: ensure slide summary segments start with a title line when missing.
+- Slides: detect headline-style first lines and render them as slide titles (no required `Title:` markers).
+- Slides: progress updates during yt-dlp downloads and OSC progress mirrors slide extraction.
+- Slides: reuse the media cache for downloaded videos (even with `--no-cache`).
+- Slides: clear slide progress line before the finish summary to avoid stray `Slides x/y` output.
+- CLI status line: ignore empty/ANSI-only spinner updates and duplicate texts to prevent flicker/blank status frames.
+- Automation: require userScripts (no isolated-world fallback), with improved guidance and in-panel permission notice.
+- CLI: clear OSC progress on SIGINT/SIGTERM to avoid stuck indicators.
+- CLI local files: avoid hangs when stream usage never resolves and preprocess PDFs automatically for custom OpenAI-compatible `OPENAI_BASE_URL` endpoints (e.g. non-`api.openai.com`).
+
+### Improvements
+
+- Tooling: remove Biome and standardize on `oxfmt` + type-aware `oxlint`; `pnpm check` now enforces `format:check` before lint/tests.
+- Transcription: add auto transcriber selection (default) with ONNX-first when configured + `summarize transcriber setup`.
+- Cache: add media download caching with TTL/size caps + optional verification, plus `--no-media-cache`.
+- CLI: add themed output (24-bit ANSI), `--theme`, and config/env defaults for a consistent color scheme.
+- CLI: show determinate transcription progress percent when duration is known.
+- CLI: show determinate OSC progress for transcription/download when totals are known.
+- CLI: keep OSC progress determinate when recent percent updates are available.
+- CLI: theme transcription progress lines and mirror part-based progress to OSC when duration is unknown.
+- CLI: theme tweet/extraction progress lines for consistent loading indicators.
+- CLI: theme file/slide spinner labels so all progress lines share the same styling.
+- CLI: simplify media download labels (avoid “media, video” duplication).
+- Slides: cap auto slide targets at 6 by default for long videos.
+- Slides: render headline-style first lines as slide titles above the slide marker.
+- Media: refactor routing helpers and size policy (#48, thanks @steipete).
+- Daemon: emit slides start/progress/done metadata in extended logging for easier debugging.
+- Prompts: allow straight quotes and encourage 1-2 short exact quotes when relevant.
+
+### Docs
+
+- README: 0.10.0 preview layout with clearer install flow, daemon rationale, and prominent Chrome Web Store link.
+- README/docs: add UI theme config + ONNX install hints.
+- README: document ONNX transcriber setup + auto selection.
+
 ## 0.9.0 - 2025-12-31
 
 ### Highlights
@@ -240,6 +360,7 @@
 - Add `--preprocess off|auto|always` and a `uvx markitdown` fallback for Markdown extraction and unsupported file attachments (when `--format md` is used).
 
 ## 0.3.0 - 2025-12-20
+
 ### Changes
 
 - Add yt-dlp audio transcription fallback for YouTube; prefer OpenAI Whisper with FAL fallback. Thanks @dougvk.

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 Peter Steinberger
+\g<1>2026 Peter Steinberger
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal