@steipete/summarize 0.12.0 → 0.13.0

package/docs/releasing.md

@@ -1,5 +1,5 @@
 ---
-summary: "Release checklist + Homebrew tap update."
+summary: "Release checklist + Homebrew/core verify step."
 ---
 
 # Releasing
@@ -8,22 +8,19 @@ summary: "Release checklist + Homebrew tap update."
 
 - Ship npm packages (core first, then CLI).
 - Tag + GitHub release.
-- Update Homebrew tap so `brew install steipete/tap/summarize` matches latest tag.
+- Verify the Homebrew/core formula so `brew install summarize` matches the latest tag.
 
 ## Checklist
 
-1. `scripts/release.sh all` (gates → build → verify → publish → smoke → tag → tap).
+1. `scripts/release.sh all` (gates → build → verify → publish → smoke → tag).
 2. Create GitHub release for the new tag (match version, attach notes/assets as needed).
-3. If you didn’t run `tap` in the script, update the Homebrew tap formula for `summarize`:
-   - Bump version to the new tag.
-   - Update tarball URL + SHA256 for the new release.
-4. Verify Homebrew install reflects the new version:
-   - `brew install steipete/tap/summarize`
+3. Verify the Homebrew/core formula reflects the new version:
+   - `brew install summarize`
    - `summarize --version` matches tag.
-   - Run a feature added in the release (e.g. `summarize daemon install` for v0.8.2).
-5. If anything fails, fix and re-cut the release (no partials).
+   - Run a feature added in the release (for example `summarize daemon install`).
+4. If anything fails, fix and re-cut the release (no partials).
 
 ## Common failure
 
-- NPM/GitHub release updated, tap not updated → users stuck on old version.
-  Fix: always do step 3–4 before announcing.
+- NPM/GitHub release updated, but Homebrew/core still serves the old version.
+  Fix: always do step 3 before announcing.

package/docs/site/docs/chrome-extension.html

@@ -54,7 +54,7 @@
           <ul>
             <li>
               <code>npm i -g @steipete/summarize</code> or
-              <code>brew install steipete/tap/summarize</code>
+              <code>brew install summarize</code>
             </li>
             <li>Build extension: <code>pnpm -C apps/chrome-extension build</code></li>
             <li>Load unpacked: <code>apps/chrome-extension/.output/chrome-mv3</code></li>

package/docs/transcript-provider-flow.md

@@ -19,8 +19,15 @@ Goal: keep provider entrypoints thin; keep provider policy explicit.
   Podcast orchestration only.
   Feed/Spotify/Apple/enclosure/`yt-dlp` chain.
 - `packages/core/src/content/transcript/providers/generic.ts`
+  Thin orchestration only.
   Embedded tracks first.
   Direct-media / X media fallback next.
+- `packages/core/src/content/transcript/providers/generic-embedded.ts`
+  Embedded media detection + caption-track parsing only.
+- `packages/core/src/content/transcript/providers/generic-direct-media.ts`
+  Direct-media yt-dlp/transcription fallback only.
+- `packages/core/src/content/transcript/providers/generic-twitter.ts`
+  X/Twitter cookies + yt-dlp orchestration only.
 
 ## Shared policy
 

package/docs/website.md

@@ -13,10 +13,11 @@ Use this for non-YouTube URLs.
 - Fetches the page HTML.
 - Extracts “article-ish” content and normalizes it into clean text.
 - If extraction looks blocked or too thin, it can retry via Firecrawl (Markdown).
+  - Firecrawl applies to non-YouTube URLs only; YouTube URLs use the `--youtube` transcript path instead.
 - If a page is effectively “video-only”, it may treat it as a video input (see `--video-mode`).
 - `--video-mode transcript` prefers embedded media transcripts on pages with audio/video (captions → yt-dlp/Whisper fallback).
 - With `--format md`, the CLI defaults to `--markdown-mode readability` (Readability article HTML as the Markdown input).
-  - Use `--firecrawl always` to try Firecrawl first.
+  - Use `--firecrawl always` to try Firecrawl first for non-YouTube URLs.
 - With `--format md`, `--markdown-mode auto|llm|readability` can also convert HTML → Markdown via an LLM using the configured `--model` (no provider fallback).
 - With `--format md`, `--markdown-mode auto` may fall back to `uvx markitdown` when available (disable with `--preprocess off`).
 - For podcast URLs (Apple Podcasts, RSS, Spotify episodes), it downloads the episode audio and transcribes via Whisper (prefers local `whisper.cpp` when installed + model available); progress shows “Downloading audio …” then “Transcribing …” (duration uses RSS hints or `ffprobe` when available).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@steipete/summarize",
-  "version": "0.12.0",
+  "version": "0.13.0",
   "description": "Link → clean text → summary.",
   "bin": {
     "summarize": "./dist/cli.js",
@@ -32,9 +32,9 @@
     }
   },
   "dependencies": {
-    "@mariozechner/pi-ai": "^0.57.1",
+    "@mariozechner/pi-ai": "^0.65.2",
     "commander": "^14.0.3",
-    "file-type": "^21.3.0",
+    "file-type": "^22.0.0",
     "gpt-tokenizer": "^3.4.0",
     "json5": "^2.2.3",
     "markdansi": "^0.2.1",
@@ -43,22 +43,22 @@
     "osc-progress": "^0.3.0",
     "tokentally": "^0.1.1",
     "tslog": "^4.10.2",
-    "@steipete/summarize-core": "0.12.0"
+    "@steipete/summarize-core": "0.13.0"
   },
   "devDependencies": {
-    "@fal-ai/client": "^1.9.4",
-    "@types/jsdom": "^28.0.0",
-    "@types/node": "^25.3.5",
+    "@fal-ai/client": "^1.9.5",
+    "@types/jsdom": "^28.0.1",
+    "@types/node": "^25.5.2",
     "@types/sanitize-html": "^2.16.1",
-    "@vitest/coverage-v8": "^4.0.18",
-    "esbuild": "^0.27.3",
-    "oxfmt": "0.36.0",
-    "oxlint": "^1.51.0",
-    "oxlint-tsgolint": "^0.16.0",
+    "@vitest/coverage-v8": "^4.1.2",
+    "esbuild": "^0.28.0",
+    "oxfmt": "0.44.0",
+    "oxlint": "^1.59.0",
+    "oxlint-tsgolint": "^0.20.0",
     "rimraf": "^6.1.3",
     "tsx": "^4.21.0",
-    "typescript": "^5.9.3",
-    "vitest": "^4.0.18"
+    "typescript": "^6.0.2",
+    "vitest": "^4.1.2"
   },
   "engines": {
     "node": ">=22"
@@ -71,6 +71,7 @@
     "build:lib": "tsc -p tsconfig.build.json",
     "check": "pnpm format:check && pnpm lint && pnpm test:coverage",
     "clean": "rimraf dist packages/core/dist",
+    "dev:cli": "pnpm -C packages/core build && tsx src/cli.ts",
     "docs:list": "tsx scripts/docs-list.ts",
     "format": "oxfmt --write",
     "format:check": "oxfmt --check",