@tacone/prosey 0.2.4 → 0.2.6

package/README.md

@@ -180,7 +180,7 @@ Use `--reset-config` to restore the defaults at any time.
 ### `pager`
 
 Pager command for transcript and summary output. Defaults to `"auto"`, which
-detects the first available of: `bat -lmd` → `glow` → `mdcat -l -p` → `less`.
+detects the first available of: `bat -lmd --style plain` → `glow -p` → `mdcat -l -p` → `less`.
 Set to a custom command (e.g. `"less -R"`) to override. The `PROSEY_PAGER`
 environment variable takes precedence over this setting.
 

package/bin/prosey

@@ -94210,9 +94210,9 @@ function detectPager(cfgPager) {
   if (cfgPager !== undefined && cfgPager !== "" && cfgPager !== "auto")
     return cfgPager;
   if (hasCommand("bat"))
-    return "bat -lmd";
+    return "bat -lmd --style plain";
   if (hasCommand("glow"))
-    return "glow";
+    return "glow -p";
   if (hasCommand("mdcat"))
     return "mdcat -l -p";
   if (hasCommand("less"))
@@ -101603,7 +101603,7 @@ var FALLBACK_CONFIG_TOML = `# Default prosey configuration
 # Created automatically on first run. Edit as needed.
 
 # Pager command for transcript and summary output.
-# Defaults to "auto": bat -lmd → glow → mdcat -l -p → less
+# Defaults to "auto": bat -lmd --style plain → glow -p → mdcat -l -p → less
 # Set to a custom command (e.g. "less -R") to override.
 # Can also be set via the PROSEY_PAGER env var (takes precedence).
 pager = "auto"
@@ -101759,7 +101759,7 @@ async function writeCache(dir, filename, data) {
 // package.json
 var package_default = {
   name: "@tacone/prosey",
-  version: "0.2.4",
+  version: "0.2.6",
   description: "Download YouTube video transcripts from the CLI",
   module: "src/index.ts",
   type: "module",
@@ -101822,6 +101822,31 @@ var package_default = {
   }
 };
 
+// src/version-check.ts
+var TIMEOUT_MS = 3000;
+var registryUrl = `https://registry.npmjs.org/${package_default.name}/latest`;
+async function checkVersion() {
+  try {
+    const controller = new AbortController;
+    const timer2 = setTimeout(() => controller.abort(), TIMEOUT_MS);
+    const res = await fetch(registryUrl, { signal: controller.signal });
+    clearTimeout(timer2);
+    if (!res.ok) {
+      debug("Version check failed: HTTP", res.status);
+      return null;
+    }
+    const data = await res.json();
+    if (!data.version) {
+      debug("Version check: no version field in response");
+      return null;
+    }
+    return data.version;
+  } catch (err) {
+    debug("Version check error:", err instanceof Error ? err.message : String(err));
+    return null;
+  }
+}
+
 // node_modules/prettier/index.mjs
 import { createRequire as __prettierCreateRequire } from "module";
 import { fileURLToPath as __prettierFileUrlToPath } from "url";
@@ -120362,6 +120387,16 @@ var debugApis = {
 // src/index.ts
 var NAME2 = "prosey";
 var VERSION2 = package_default.version;
+var latestVersion = null;
+var versionCheck = checkVersion().then((v11) => {
+  latestVersion = v11;
+});
+function exitProcess(code) {
+  if (useHints && code === 0 && latestVersion && latestVersion !== VERSION2) {
+    hint(`\uD83D\uDCE6 New version available: ${latestVersion} — use npm/pnpm/bun -g i ${package_default.name} to upgrade`);
+  }
+  process.exit(code);
+}
 function help() {
   return `${NAME2} v${VERSION2}
 
@@ -120504,16 +120539,16 @@ var pagerCmd = null;
 var args = process.argv.slice(2);
 if (args.length === 0 || args.includes("--help")) {
   console.log(help());
-  process.exit(0);
+  exitProcess(0);
 }
 if (args.includes("--version")) {
   console.log(VERSION2);
-  process.exit(0);
+  exitProcess(0);
 }
 if (args.includes("--reset-config")) {
   const path15 = await resetConfig();
   console.log(`Config reset to defaults: ${path15}`);
-  process.exit(0);
+  exitProcess(0);
 }
 var config = await loadConfig().catch(() => ({}));
 var mode = "transcript";
@@ -120543,7 +120578,7 @@ for (let i = 0;i < args.length; i++) {
     lang = args[++i] ?? undefined;
     if (!lang) {
       console.error("Error: --lang requires a language code");
-      process.exit(1);
+      exitProcess(1);
     }
   } else if (arg === "--timestamps" || arg === "-t") {
     timestamps = true;
@@ -120553,7 +120588,7 @@ for (let i = 0;i < args.length; i++) {
     outputPath = args[++i] ?? undefined;
     if (!outputPath) {
       console.error("Error: -o/--output requires a file path");
-      process.exit(1);
+      exitProcess(1);
     }
   } else if (arg === "--json") {
     outputJson = true;
@@ -120583,7 +120618,7 @@ for (let i = 0;i < args.length; i++) {
     noDecode = true;
   } else if (arg.startsWith("-")) {
     console.error(`Unknown option: ${arg}`);
-    process.exit(1);
+    exitProcess(1);
   } else {
     videoId = arg;
   }
@@ -120600,17 +120635,17 @@ if (mode === "config") {
   } else {
     console.log(`Config file: ${path15}`);
   }
-  process.exit(0);
+  exitProcess(0);
 }
 if (!videoId) {
   console.error("Error: missing video URL or ID");
   console.log(help());
-  process.exit(1);
+  exitProcess(1);
 }
 var extracted = extractVideoId(videoId);
 if (!extracted) {
   console.error("Error: invalid YouTube video URL or ID");
-  process.exit(65);
+  exitProcess(65);
 }
 videoId = extracted;
 setLevel(logLevel);
@@ -120626,7 +120661,7 @@ debug("Pager:", pagerCmd ?? "none");
   }
 }
 if (useHints) {
-  const hasMarkdownPager = pagerCmd === "bat -lmd" || pagerCmd === "glow" || pagerCmd === "mdcat -l -p";
+  const hasMarkdownPager = pagerCmd === "bat -lmd --style plain" || pagerCmd === "glow -p" || pagerCmd === "mdcat -l -p";
   if (!hasMarkdownPager) {
     hint("Tip: install a markdown highlighter for better output (e.g. bat, glow, mdcat)");
   }
@@ -120636,6 +120671,7 @@ debug("Video ID:", videoId);
 debug("Mode:", mode);
 if (lang)
   debug("Language:", lang);
+await Promise.race([versionCheck, new Promise((r5) => setTimeout(r5, 1000))]);
 try {
   if (mode === "info") {
     const result = await fetchTranscript(videoId, { videoDetails: true, lang });
@@ -120644,12 +120680,12 @@ try {
     } else {
       printVideoInfo(result.videoDetails);
     }
-    process.exit(0);
+    exitProcess(0);
   }
   if (mode === "summarize") {
     if (!config.summarize?.command) {
       console.error("Error: [summarize] section with a command is required in config");
-      process.exit(1);
+      exitProcess(1);
     }
     const cacheOpts2 = { lang, mode: "summarize", noDecode };
     const dir2 = cacheDir(videoId, cacheOpts2);
@@ -120694,11 +120730,11 @@ try {
     const formatted = noFormat ? summary : await formatMd(summary);
     await outputText(formatted + `
 `);
-    process.exit(0);
+    exitProcess(0);
   } else if (listOnly) {
     const languages2 = await listLanguages(videoId);
     printLanguages(languages2);
-    process.exit(0);
+    exitProcess(0);
   }
   const decode = !noDecode;
   const cacheOpts = { lang, timestamps, json: outputJson, noDecode };
@@ -120752,8 +120788,9 @@ try {
 `;
     await outputText(output);
   }
+  exitProcess(0);
 } catch (err) {
   const message = err instanceof Error ? err.message : String(err);
   console.error(`Error: ${message}`);
-  process.exit(1);
+  exitProcess(1);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tacone/prosey",
-  "version": "0.2.4",
+  "version": "0.2.6",
   "description": "Download YouTube video transcripts from the CLI",
   "module": "src/index.ts",
   "type": "module",

package/src/config.ts

@@ -18,7 +18,7 @@ const FALLBACK_CONFIG_TOML = `# Default prosey configuration
 # Created automatically on first run. Edit as needed.
 
 # Pager command for transcript and summary output.
-# Defaults to "auto": bat -lmd → glow → mdcat -l -p → less
+# Defaults to "auto": bat -lmd --style plain → glow -p → mdcat -l -p → less
 # Set to a custom command (e.g. "less -R") to override.
 # Can also be set via the PROSEY_PAGER env var (takes precedence).
 pager = "auto"

package/src/default-config.toml

@@ -2,12 +2,12 @@
 # Created automatically on first run. Edit as needed.
 
 # Pager command for transcript and summary output.
-# Defaults to "auto": bat -lmd → glow → mdcat -l -p → less
+# Defaults to "auto": bat -lmd --style plain → glow -p → mdcat -l -p → less
 # Set to a custom command (e.g. "less -R") to override.
 # Can also be set via the PROSEY_PAGER env var (takes precedence).
 pager = "auto"
 
-# Show hints for missing tools (e.g. markdown highlighter).
+# Show hints when available
 # Can also be set via PROSEY_HINTS env var (yes, no, 1, 0, true, false).
 hints = true
 
@@ -21,19 +21,13 @@ Write a comprehensive summary of the following transcription.
 """
 
 # Command to execute with the prompt and transcript piped via stdin.
-# The transcript is appended to the prompt automatically.
+# The transcript will be appended to the prompt automatically.
 #
-# Available options:
+# Examples:
 #
-#   opencode run                    — full access (default)
-#   opencode run --permissions read  — read-only (view files, no edits)
+#   OPENCODE_PERMISSION='{"read":"allow","write":"deny","edit":"deny","bash":"deny","glob":"deny","grep":"deny","webfetch":\"deny\",\"task\":\"deny\",\"todowrite\":\"deny\",\"websearch\":\"deny","lsp":"deny"}' opencode run --pure
+#   claude --permission-mode plan --print  --read-only
+#   copilot -s --deny-all-tools --read-only
+#   codex --sandbox read-only --read-only
 #
-#   claude -p "" --print            — full access (--print for clean output)
-#   claude --permission-mode plan -p "" --print  — read-only (plan/read only)
-#
-#   copilot -sp ""                  — full access (-s = silent, -p = prompt)
-#   copilot -sp "" --deny-all-tools — read-only (no shell/write access)
-#
-#   codex --sandbox default -p ""   — full access
-#   codex --sandbox read-only -p "" — read-only
 command = "OPENCODE_PERMISSION='{\"read\":\"allow\",\"write\":\"deny\",\"edit\":\"deny\",\"bash\":\"deny\",\"glob\":\"deny\",\"grep\":\"deny\",\"webfetch\":\"deny\",\"task\":\"deny\",\"todowrite\":\"deny\",\"websearch\":\"deny\",\"lsp\":\"deny\"}' opencode run --pure"

package/src/index.ts

@@ -12,12 +12,27 @@ import { loadConfig, resetConfig, configPath } from "./config";
 import type { ProseyConfig } from "./config";
 import { summarize } from "./summarize";
 import { cacheDir, readCache, writeCache, extractVideoId } from "./cache";
+import { checkVersion } from "./version-check";
 import pkg from "../package.json";
 import prettier from "prettier";
 
 const NAME = "prosey";
 const VERSION = pkg.version;
 
+let latestVersion: string | null = null;
+const versionCheck = checkVersion().then((v) => {
+  latestVersion = v;
+});
+
+function exitProcess(code: number): never {
+  if (useHints && code === 0 && latestVersion && latestVersion !== VERSION) {
+    hint(
+      `📦 New version available: ${latestVersion} — use npm/pnpm/bun -g i ${pkg.name} to upgrade`,
+    );
+  }
+  process.exit(code);
+}
+
 function help(): string {
   return `${NAME} v${VERSION}
 
@@ -180,18 +195,18 @@ const args = process.argv.slice(2);
 
 if (args.length === 0 || args.includes("--help")) {
   console.log(help());
-  process.exit(0);
+  exitProcess(0);
 }
 
 if (args.includes("--version")) {
   console.log(VERSION);
-  process.exit(0);
+  exitProcess(0);
 }
 
 if (args.includes("--reset-config")) {
   const path = await resetConfig();
   console.log(`Config reset to defaults: ${path}`);
-  process.exit(0);
+  exitProcess(0);
 }
 
 const config: ProseyConfig = await loadConfig().catch(() => ({}) as ProseyConfig);
@@ -224,7 +239,7 @@ for (let i = 0; i < args.length; i++) {
     lang = args[++i] ?? undefined;
     if (!lang) {
       console.error("Error: --lang requires a language code");
-      process.exit(1);
+      exitProcess(1);
     }
   } else if (arg === "--timestamps" || arg === "-t") {
     timestamps = true;
@@ -234,7 +249,7 @@ for (let i = 0; i < args.length; i++) {
     outputPath = args[++i] ?? undefined;
     if (!outputPath) {
       console.error("Error: -o/--output requires a file path");
-      process.exit(1);
+      exitProcess(1);
     }
   } else if (arg === "--json") {
     outputJson = true;
@@ -264,7 +279,7 @@ for (let i = 0; i < args.length; i++) {
     noDecode = true;
   } else if (arg.startsWith("-")) {
     console.error(`Unknown option: ${arg}`);
-    process.exit(1);
+    exitProcess(1);
   } else {
     videoId = arg;
   }
@@ -282,23 +297,23 @@ if (mode === "config") {
   } else {
     console.log(`Config file: ${path}`);
   }
-  process.exit(0);
+  exitProcess(0);
 }
 
 if (!videoId) {
   console.error("Error: missing video URL or ID");
   console.log(help());
-  process.exit(1);
+  exitProcess(1);
 }
 
 const extracted = extractVideoId(videoId);
 
 if (!extracted) {
   console.error("Error: invalid YouTube video URL or ID");
-  process.exit(65);
+  exitProcess(65);
 }
 
-videoId = extracted;
+videoId = extracted!;
 
 setLevel(logLevel);
 resetTimer();
@@ -316,7 +331,7 @@ debug("Pager:", pagerCmd ?? "none");
 
 if (useHints) {
   const hasMarkdownPager =
-    pagerCmd === "bat -lmd" || pagerCmd === "glow" || pagerCmd === "mdcat -l -p";
+    pagerCmd === "bat -lmd --style plain" || pagerCmd === "glow -p" || pagerCmd === "mdcat -l -p";
   if (!hasMarkdownPager) {
     hint("Tip: install a markdown highlighter for better output (e.g. bat, glow, mdcat)");
   }
@@ -327,6 +342,9 @@ debug("Video ID:", videoId);
 debug("Mode:", mode);
 if (lang) debug("Language:", lang);
 
+// Give the version check a moment to complete
+await Promise.race([versionCheck, new Promise((r) => setTimeout(r, 1000))]);
+
 try {
   if (mode === "info") {
     const result = await fetchTranscript(videoId, { videoDetails: true, lang } as any);
@@ -335,13 +353,13 @@ try {
     } else {
       printVideoInfo(result.videoDetails);
     }
-    process.exit(0);
+    exitProcess(0);
   }
 
   if (mode === "summarize") {
     if (!config.summarize?.command) {
       console.error("Error: [summarize] section with a command is required in config");
-      process.exit(1);
+      exitProcess(1);
     }
 
     const cacheOpts = { lang, mode: "summarize", noDecode };
@@ -374,14 +392,14 @@ try {
       debug("Cache written: transcript.json");
     }
 
-    const prompt = config.summarize.prompt ?? "";
+    const prompt = config.summarize!.prompt ?? "";
     const transcriptText = toText(segments, !noDecode);
 
     if (!summary) {
       info(`Summarizing...`);
       summary = await summarize({
         prompt,
-        command: config.summarize.command,
+        command: config.summarize!.command!,
         transcript: transcriptText,
         cwd: dir,
       });
@@ -392,11 +410,11 @@ try {
 
     const formatted = noFormat ? summary : await formatMd(summary);
     await outputText(formatted + "\n");
-    process.exit(0);
+    exitProcess(0);
   } else if (listOnly) {
     const languages = await listLanguages(videoId);
     printLanguages(languages);
-    process.exit(0);
+    exitProcess(0);
   }
 
   const decode = !noDecode;
@@ -463,8 +481,9 @@ try {
 
     await outputText(output);
   }
+  exitProcess(0);
 } catch (err: unknown) {
   const message = err instanceof Error ? err.message : String(err);
   console.error(`Error: ${message}`);
-  process.exit(1);
+  exitProcess(1);
 }

package/src/pager.test.ts

@@ -58,7 +58,7 @@ describe("detectPager", () => {
     // In CI or minimal environments, no pagers may be installed
     // If a pager IS found, it should be one of the expected ones
     if (pager !== null) {
-      const known = ["bat -lmd", "glow", "mdcat -l -p", "less"];
+      const known = ["bat -lmd --style plain", "glow -p", "mdcat -l -p", "less"];
       expect(known).toContain(pager);
     }
   });

package/src/pager.ts

@@ -15,8 +15,8 @@ export function detectPager(cfgPager?: string): string | null {
 
   if (cfgPager !== undefined && cfgPager !== "" && cfgPager !== "auto") return cfgPager;
 
-  if (hasCommand("bat")) return "bat -lmd";
-  if (hasCommand("glow")) return "glow";
+  if (hasCommand("bat")) return "bat -lmd --style plain";
+  if (hasCommand("glow")) return "glow -p";
   if (hasCommand("mdcat")) return "mdcat -l -p";
   if (hasCommand("less")) return "less";
   return null;

package/src/version-check.ts

@@ -0,0 +1,32 @@
+import { debug } from "./debug";
+import pkg from "../package.json";
+
+const TIMEOUT_MS = 3000;
+
+const registryUrl = `https://registry.npmjs.org/${pkg.name}/latest`;
+
+export async function checkVersion(): Promise<string | null> {
+  try {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), TIMEOUT_MS);
+
+    const res = await fetch(registryUrl, { signal: controller.signal });
+    clearTimeout(timer);
+
+    if (!res.ok) {
+      debug("Version check failed: HTTP", res.status);
+      return null;
+    }
+
+    const data = (await res.json()) as { version?: string };
+    if (!data.version) {
+      debug("Version check: no version field in response");
+      return null;
+    }
+
+    return data.version;
+  } catch (err) {
+    debug("Version check error:", err instanceof Error ? err.message : String(err));
+    return null;
+  }
+}