npm - @tacone/prosey - Versions diffs - 0.5.0 → 0.7.0 - Mend

@tacone/prosey 0.5.0 → 0.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (8) hide show

package/bin/prosey CHANGED Viewed

@@ -101600,46 +101600,6 @@ var lt = (r) => {
 };
 // src/config.ts
-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 --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).
-# Can also be set via PROSEY_HINTS env var (yes, no, 1, 0, true, false).
-hints = true
-[ai]
-# Default command for AI operations (summarize, transcribe).
-# Can be overridden per-section via the command key below.
-command = "opencode run"
-[summarize]
-# Prompt sent to the command via stdin.
-# Customize this to change how transcripts are summarized.
-prompt = """
-Write a comprehensive summary of the following transcription.
-"""
-# Command override for summarize. Uncomment to use a different command
-# than the one specified in [ai].
-# command = "opencode run"
-[transcribe]
-# Prompt sent to the command via stdin.
-# Customize this to change how transcripts are formatted as markdown.
-prompt = """
-Convert this transcript to clean, readable markdown.
-"""
-# Command override for transcribe. Uncomment to use a different command
-# than the one specified in [ai].
-# command = "opencode run"
-`;
 async function readDefaultConfig() {
   const paths = [
     join(dirname(fileURLToPath(import.meta.url)), "default-config.toml"),
@@ -101649,7 +101609,7 @@ async function readDefaultConfig() {
     if (existsSync(p2))
       return readFile(p2, "utf8");
   }
-  return FALLBACK_CONFIG_TOML;
+  throw new Error("default-config.toml not found");
 }
 function configDir() {
   const env = process.env.XDG_CONFIG_HOME;
@@ -103188,14 +103148,23 @@ var LOGO_DATA_URI = `data:image/svg+xml;charset=utf-8,${encodeURIComponent(LOGO_
 function escapeHtml(text) {
   return text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
 }
-async function generateHtml(markdown, title) {
+function watchMetaHtml(duration, wordCount, videoId) {
+  const h2 = Math.floor(duration / 3600);
+  const m3 = Math.round(duration % 3600 / 60);
+  const durStr = h2 > 0 ? `${h2} h ${m3} min` : `${m3} min`;
+  const readTime = Math.ceil(wordCount / 200);
+  const url = `https://youtube.com/watch?v=${videoId}`;
+  const separator = '<span style="opacity: 0.4">&nbsp;&nbsp;|&nbsp;&nbsp;</span>';
+  return `<a href="${url}" class="watch-link">${durStr} watch</a> ${separator} ${readTime} min read`;
+}
+async function generateHtml(markdown, title, watchMeta) {
   const [css, body] = await Promise.all([getPicoCss(), g2.parse(markdown)]);
   return `<!DOCTYPE html>
 <html lang="en">
 <head>
 <meta charset="UTF-8">
 <meta name="viewport" content="width=device-width, initial-scale=1.0">
-<title>${escapeHtml(title ?? "Prosey")}</title>
+<title>${title ? escapeHtml(title) + " - Prosey" : "Prosey"}</title>
 <script>(function(){var m=localStorage.getItem('prosey-theme'),t=m||'auto';if(t==='auto')t=window.matchMedia('(prefers-color-scheme:dark)').matches?'dark':'light';document.documentElement.setAttribute('data-theme',t);if(!m)localStorage.setItem('prosey-theme','auto')})();</script>
 <link rel="preconnect" href="https://fonts.googleapis.com">
 <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
@@ -103249,14 +103218,17 @@ blockquote:last-child { margin-bottom: 0; }
 #theme-btn:hover, #theme-btn:focus, #theme-btn:active { opacity: 1 !important; }
 img[alt="Prosey"] { filter: grayscale(100%); }
 img[alt="Prosey"]:hover, img[alt="Prosey"]:active, img[alt="Prosey"]:focus { filter: grayscale(0%); }
+.watch-link { color: inherit; text-decoration: none; }
+.watch-link:hover { text-decoration: underline; }
 </style>
 </head>
 <body>
-<div style="display:flex;justify-content:space-between;align-items:flex-start;padding:1rem 1rem 0">
-<img src="${LOGO_DATA_URI}" alt="Prosey" title="Prosey" style="vertical-align:top">
-<button id="theme-btn" type="button" style="background:none;border:none;cursor:pointer;padding:0;line-height:1;opacity:.5;filter:grayscale(100%);transition:all 0.3s">\uD83D\uDCA1</button>
+<div style="display:flex;align-items:center;justify-content:space-between;padding:1rem 1rem 0">
+<img src="${LOGO_DATA_URI}" alt="Prosey" title="Prosey" style="vertical-align:top;flex-shrink:0">
+<div style="flex:1;text-align:center;font-size:.85rem;color:var(--pico-muted-color)">${watchMeta ? watchMetaHtml(watchMeta.duration, watchMeta.wordCount, watchMeta.videoId) : ""}</div>
+<button id="theme-btn" type="button" style="background:none;border:none;cursor:pointer;padding:0;line-height:1;opacity:.5;filter:grayscale(100%);transition:all 0.3s;flex-shrink:0">\uD83D\uDCA1</button>
 </div>
-<main style="max-width:720px;margin:0 auto;padding:1rem">
+<main style="max-width:50em;margin:0 auto;padding:1rem">
 ${body}
 </main>
 <script>
@@ -103291,7 +103263,7 @@ function openInBrowser(htmlPath) {
 // package.json
 var package_default = {
   name: "@tacone/prosey",
-  version: "0.5.0",
+  version: "0.7.0",
   description: "Download YouTube video transcripts from the CLI",
   module: "src/index.ts",
   type: "module",
@@ -122284,10 +122256,12 @@ try {
     const dir2 = cacheDir(videoId, cacheOpts2);
     let segments2 = null;
     let summary = null;
+    let cachedInfo = null;
     startTimer();
     if (!noCache) {
       const cachedSegments = await readCache(dir2, "transcript.json");
       const cachedSummary = await readCache(dir2, "summary.md");
+      cachedInfo = await readCache(dir2, "info.json");
       if (cachedSegments && cachedSummary) {
         info("Transcript cached");
         debug("Cache hit:", dir2);
@@ -122299,23 +122273,92 @@ try {
     } else {
       debug("Cache skipped (--no-cache)");
     }
-    if (!segments2) {
-      info("Fetching transcript...");
-      segments2 = lang ? await fetchTranscript(videoId, { lang }) : await fetchTranscript(videoId);
-      info(`Transcript: ${segments2.length} segments`);
-      await writeCache(dir2, "transcript.json", JSON.stringify(segments2));
-      debug("Cache written: transcript.json");
-    }
     const prompt2 = resolveSummarizePrompt(config) ?? "";
     if (!prompt2) {
       console.error("Error: no prompt configured. Set a prompt in the [summarize] section of your config.");
       exitProcess(1);
     }
-    const transcriptText = toText(segments2, !noDecode);
+    let structuredContent;
+    let videoTitle;
+    let videoDuration = 0;
+    if (!segments2) {
+      info("Fetching transcript...");
+      const opts = lang ? { lang, videoDetails: true } : { videoDetails: true };
+      const result = await fetchTranscript(videoId, opts);
+      segments2 = result.segments;
+      videoDuration = result.videoDetails.lengthSeconds;
+      const infoJson = JSON.stringify({
+        title: result.videoDetails.title,
+        channel: result.videoDetails.author,
+        description: result.videoDetails.description,
+        duration: videoDuration
+      });
+      cachedInfo = infoJson;
+      const chapterValue = formatChaptersAsJson(extractChapters(result.videoDetails.description));
+      videoTitle = result.videoDetails.title;
+      const truncatedInfo = JSON.stringify({
+        title: result.videoDetails.title,
+        channel: result.videoDetails.author,
+        description: result.videoDetails.description.slice(0, 1000)
+      });
+      const transcriptText = toText(segments2, !noDecode);
+      structuredContent = `INFO:
+${truncatedInfo}
+TEXT:
+${transcriptText}`;
+      if (dryRun) {
+        await outputText(`${prompt2}
+${structuredContent}
+`);
+        exitProcess(0);
+      }
+      info(`Transcript: ${segments2.length} segments`);
+      await writeCache(dir2, "transcript.json", JSON.stringify(segments2));
+      await writeCache(dir2, "info.json", infoJson);
+      await writeCache(dir2, "chapters.json", chapterValue);
+      debug("Cache written: transcript.json, info.json, chapters.json");
+    } else {
+      let chapterValue;
+      if (!cachedInfo) {
+        debug("Cache missing info.json, re-fetching video details");
+        const fallbackOpts = lang ? { lang, videoDetails: true } : { videoDetails: true };
+        const fallbackResult = await fetchTranscript(videoId, fallbackOpts);
+        videoDuration = fallbackResult.videoDetails.lengthSeconds;
+        cachedInfo = JSON.stringify({
+          title: fallbackResult.videoDetails.title,
+          channel: fallbackResult.videoDetails.author,
+          description: fallbackResult.videoDetails.description,
+          duration: videoDuration
+        });
+        await writeCache(dir2, "info.json", cachedInfo);
+        chapterValue = formatChaptersAsJson(extractChapters(fallbackResult.videoDetails.description));
+        await writeCache(dir2, "chapters.json", chapterValue);
+        debug("Cache written: info.json, chapters.json");
+      } else {
+        const cachedChapters = await readCache(dir2, "chapters.json");
+        chapterValue = cachedChapters ?? "not available";
+      }
+      const transcriptText = toText(segments2, !noDecode);
+      const cachedInfoObj = JSON.parse(cachedInfo);
+      videoTitle = cachedInfoObj.title;
+      videoDuration = cachedInfoObj.duration ?? 0;
+      const truncatedInfo = JSON.stringify({
+        title: cachedInfoObj.title,
+        channel: cachedInfoObj.channel,
+        description: cachedInfoObj.description.slice(0, 1000)
+      });
+      structuredContent = `INFO:
+${truncatedInfo}
+TEXT:
+${transcriptText}`;
+    }
     if (dryRun) {
       await outputText(`${prompt2}
-${transcriptText}
+${structuredContent}
 `);
       exitProcess(0);
     }
@@ -122324,7 +122367,7 @@ ${transcriptText}
       summary = await summarize({
         prompt: prompt2,
         command: sumCmd,
-        transcript: transcriptText,
+        transcript: structuredContent,
         cwd: dir2
       });
       info("Summary ready");
@@ -122333,7 +122376,12 @@ ${transcriptText}
     }
     const formatted = noFormat ? summary : await formatMd(summary);
     if (format3 === "html") {
-      const htmlContent = await generateHtml(formatted);
+      const wordCount = summary.split(/\s+/).filter(Boolean).length;
+      const htmlContent = await generateHtml(formatted, videoTitle, {
+        videoId,
+        duration: videoDuration,
+        wordCount
+      });
       const htmlPath = join5(dir2, "summary.html");
       await writeFile3(htmlPath, htmlContent, "utf8");
       debug("HTML written:", htmlPath);
@@ -122364,6 +122412,8 @@ ${transcriptText}
     const dir2 = cacheDir(videoId, cacheOpts2);
     let segments2 = null;
     let md = null;
+    let videoTitle;
+    let videoDuration = 0;
     startTimer();
     let cachedInfo = null;
     if (!noCache) {
@@ -122391,12 +122441,15 @@ ${transcriptText}
       const opts = lang ? { lang, videoDetails: true } : { videoDetails: true };
       const result = await fetchTranscript(videoId, opts);
       segments2 = result.segments;
+      videoDuration = result.videoDetails.lengthSeconds;
       const infoJson = JSON.stringify({
         title: result.videoDetails.title,
         channel: result.videoDetails.author,
-        description: result.videoDetails.description
+        description: result.videoDetails.description,
+        duration: videoDuration
       });
       cachedInfo = infoJson;
+      videoTitle = result.videoDetails.title;
       const chapterValue = formatChaptersAsJson(extractChapters(result.videoDetails.description));
       const truncatedInfo = JSON.stringify({
         title: result.videoDetails.title,
@@ -122442,10 +122495,12 @@ ${structuredContent}
         debug("Cache missing info.json, re-fetching video details");
         const fallbackOpts = lang ? { lang, videoDetails: true } : { videoDetails: true };
         const fallbackResult = await fetchTranscript(videoId, fallbackOpts);
+        videoDuration = fallbackResult.videoDetails.lengthSeconds;
         cachedInfo = JSON.stringify({
           title: fallbackResult.videoDetails.title,
           channel: fallbackResult.videoDetails.author,
-          description: fallbackResult.videoDetails.description
+          description: fallbackResult.videoDetails.description,
+          duration: videoDuration
         });
         await writeCache(dir2, "info.json", cachedInfo);
         chapterValue = formatChaptersAsJson(extractChapters(fallbackResult.videoDetails.description));
@@ -122457,6 +122512,8 @@ ${structuredContent}
       }
       const transcriptText = toText(segments2, !noDecode);
       const cachedInfoObj = JSON.parse(cachedInfo);
+      videoTitle = cachedInfoObj.title;
+      videoDuration = cachedInfoObj.duration ?? 0;
       const truncatedInfo = JSON.stringify({
         title: cachedInfoObj.title,
         channel: cachedInfoObj.channel,
@@ -122485,7 +122542,12 @@ ${transcriptText}`;
     }
     const formatted = noFormat ? md : await formatMd(md);
     if (format3 === "html") {
-      const htmlContent = await generateHtml(formatted);
+      const wordCount = md.split(/\s+/).filter(Boolean).length;
+      const htmlContent = await generateHtml(formatted, videoTitle, {
+        videoId,
+        duration: videoDuration,
+        wordCount
+      });
       const htmlPath = join5(dir2, "transcript.html");
       await writeFile3(htmlPath, htmlContent, "utf8");
       debug("HTML written:", htmlPath);

package/package.json CHANGED Viewed

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

package/src/config.ts CHANGED Viewed

@@ -21,47 +21,6 @@ export interface ProseyConfig {
   };
 }
-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 --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).
-# Can also be set via PROSEY_HINTS env var (yes, no, 1, 0, true, false).
-hints = true
-[ai]
-# Default command for AI operations (summarize, transcribe).
-# Can be overridden per-section via the command key below.
-command = "opencode run"
-[summarize]
-# Prompt sent to the command via stdin.
-# Customize this to change how transcripts are summarized.
-prompt = """
-Write a comprehensive summary of the following transcription.
-"""
-# Command override for summarize. Uncomment to use a different command
-# than the one specified in [ai].
-# command = "opencode run"
-[transcribe]
-# Prompt sent to the command via stdin.
-# Customize this to change how transcripts are formatted as markdown.
-prompt = """
-Convert this transcript to clean, readable markdown.
-"""
-# Command override for transcribe. Uncomment to use a different command
-# than the one specified in [ai].
-# command = "opencode run"
-`;
 async function readDefaultConfig(): Promise<string> {
   const paths = [
     join(dirname(fileURLToPath(import.meta.url)), "default-config.toml"),
@@ -70,7 +29,7 @@ async function readDefaultConfig(): Promise<string> {
   for (const p of paths) {
     if (existsSync(p)) return readFile(p, "utf8");
   }
-  return FALLBACK_CONFIG_TOML;
+  throw new Error("default-config.toml not found");
 }
 function configDir(): string {

package/src/default-config.toml CHANGED Viewed

@@ -29,7 +29,24 @@ command = "OPENCODE_PERMISSION='{\"read\":\"allow\",\"write\":\"deny\",\"edit\":
 # Customize this to change how transcripts are summarized.
 prompt = """
-Write a comprehensive summary of the following transcription.
+Write a comprehensive summary of the following video transcription:
+Guidelines:
+- use the INFO section data to correct spellings in the text (e.g. Pi vs Pie)
+- use the INFO title value as the main title (h1 header)
+- use the TIMESTAMPS only to understand the structure, don't output time markers
+- content length: aim to be the same range as the original text or more.
+- section titles should be h2 headers
+- paragraph length soft-limit. 250 characters
+Content considerations:
+- findings should be presented in lists or table
+- flows should be presented in ordered lists
+- elaborations are better in prose
+- when content mixes types within a section, lead with prose and break out lists only for discrete items
+Only output the summary text without adding anything.
 """
 # Command override for summarize. Uncomment to use a different command

package/src/format.ts CHANGED Viewed

@@ -24,6 +24,13 @@ export function formatDuration(seconds: number): string {
   return `${m}:${String(s).padStart(2, "0")}`;
 }
+export function formatReadableDuration(seconds: number): string {
+  const h = Math.floor(seconds / 3600);
+  const m = Math.round((seconds % 3600) / 60);
+  if (h > 0) return `${h}h ${m}min`;
+  return `${m}min`;
+}
 export function decodeEntities(text: string): string {
   return text
     .replace(/&#(\d+);/g, (_, code) => String.fromCharCode(Number(code)))

package/src/html.test.ts CHANGED Viewed

@@ -5,7 +5,7 @@ describe("generateHtml", () => {
   test("wraps markdown in HTML with PicoCSS", async () => {
     const html = await generateHtml("# Hello\n\nWorld", "Test");
     expect(html).toStartWith("<!DOCTYPE html>");
-    expect(html).toContain("<title>Test</title>");
+    expect(html).toContain("<title>Test - Prosey</title>");
     expect(html).toContain("<style>");
     expect(html).toContain("--pico-");
     expect(html).toContain("<h1>Hello</h1>");

package/src/html.ts CHANGED Viewed

@@ -34,7 +34,21 @@ function escapeHtml(text: string): string {
     .replace(/"/g, "&quot;");
 }
-export async function generateHtml(markdown: string, title?: string): Promise<string> {
+function watchMetaHtml(duration: number, wordCount: number, videoId: string): string {
+  const h = Math.floor(duration / 3600);
+  const m = Math.round((duration % 3600) / 60);
+  const durStr = h > 0 ? `${h} h ${m} min` : `${m} min`;
+  const readTime = Math.ceil(wordCount / 200);
+  const url = `https://youtube.com/watch?v=${videoId}`;
+  const separator = '<span style="opacity: 0.4">&nbsp;&nbsp;|&nbsp;&nbsp;</span>';
+  return `<a href="${url}" class="watch-link">${durStr} watch</a> ${separator} ${readTime} min read`;
+}
+export async function generateHtml(
+  markdown: string,
+  title?: string,
+  watchMeta?: { videoId: string; duration: number; wordCount: number },
+): Promise<string> {
   const [css, body] = await Promise.all([getPicoCss(), marked.parse(markdown)]);
   return `<!DOCTYPE html>
@@ -42,7 +56,7 @@ export async function generateHtml(markdown: string, title?: string): Promise<st
 <head>
 <meta charset="UTF-8">
 <meta name="viewport" content="width=device-width, initial-scale=1.0">
-<title>${escapeHtml(title ?? "Prosey")}</title>
+<title>${title ? escapeHtml(title) + " - Prosey" : "Prosey"}</title>
 <script>(function(){var m=localStorage.getItem('prosey-theme'),t=m||'auto';if(t==='auto')t=window.matchMedia('(prefers-color-scheme:dark)').matches?'dark':'light';document.documentElement.setAttribute('data-theme',t);if(!m)localStorage.setItem('prosey-theme','auto')})();</script>
 <link rel="preconnect" href="https://fonts.googleapis.com">
 <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
@@ -96,14 +110,17 @@ blockquote:last-child { margin-bottom: 0; }
 #theme-btn:hover, #theme-btn:focus, #theme-btn:active { opacity: 1 !important; }
 img[alt="Prosey"] { filter: grayscale(100%); }
 img[alt="Prosey"]:hover, img[alt="Prosey"]:active, img[alt="Prosey"]:focus { filter: grayscale(0%); }
+.watch-link { color: inherit; text-decoration: none; }
+.watch-link:hover { text-decoration: underline; }
 </style>
 </head>
 <body>
-<div style="display:flex;justify-content:space-between;align-items:flex-start;padding:1rem 1rem 0">
-<img src="${LOGO_DATA_URI}" alt="Prosey" title="Prosey" style="vertical-align:top">
-<button id="theme-btn" type="button" style="background:none;border:none;cursor:pointer;padding:0;line-height:1;opacity:.5;filter:grayscale(100%);transition:all 0.3s">💡</button>
+<div style="display:flex;align-items:center;justify-content:space-between;padding:1rem 1rem 0">
+<img src="${LOGO_DATA_URI}" alt="Prosey" title="Prosey" style="vertical-align:top;flex-shrink:0">
+<div style="flex:1;text-align:center;font-size:.85rem;color:var(--pico-muted-color)">${watchMeta ? watchMetaHtml(watchMeta.duration, watchMeta.wordCount, watchMeta.videoId) : ""}</div>
+<button id="theme-btn" type="button" style="background:none;border:none;cursor:pointer;padding:0;line-height:1;opacity:.5;filter:grayscale(100%);transition:all 0.3s;flex-shrink:0">💡</button>
 </div>
-<main style="max-width:720px;margin:0 auto;padding:1rem">
+<main style="max-width:50em;margin:0 auto;padding:1rem">
 ${body}
 </main>
 <script>

package/src/index.ts CHANGED Viewed

@@ -443,12 +443,14 @@ try {
     const dir = cacheDir(videoId, cacheOpts);
     let segments: TranscriptSegment[] | null = null;
     let summary: string | null = null;
+    let cachedInfo: string | null = null;
     startTimer();
     if (!noCache) {
       const cachedSegments = await readCache(dir, "transcript.json");
       const cachedSummary = await readCache(dir, "summary.md");
+      cachedInfo = await readCache(dir, "info.json");
       if (cachedSegments && cachedSummary) {
         info("Transcript cached");
         debug("Cache hit:", dir);
@@ -461,14 +463,6 @@ try {
       debug("Cache skipped (--no-cache)");
     }
-    if (!segments) {
-      info("Fetching transcript...");
-      segments = lang ? await fetchTranscript(videoId, { lang }) : await fetchTranscript(videoId);
-      info(`Transcript: ${segments.length} segments`);
-      await writeCache(dir, "transcript.json", JSON.stringify(segments));
-      debug("Cache written: transcript.json");
-    }
     const prompt = resolveSummarizePrompt(config) ?? "";
     if (!prompt) {
       console.error(
@@ -476,10 +470,89 @@ try {
       );
       exitProcess(1);
     }
-    const transcriptText = toText(segments, !noDecode);
+    let structuredContent: string;
+    let videoTitle: string | undefined;
+    let videoDuration = 0;
+    if (!segments) {
+      info("Fetching transcript...");
+      const opts = lang ? { lang, videoDetails: true as const } : { videoDetails: true as const };
+      const result = (await fetchTranscript(videoId, opts)) as {
+        videoDetails: VideoDetails;
+        segments: TranscriptSegment[];
+      };
+      segments = result.segments;
+      videoDuration = result.videoDetails.lengthSeconds;
+      const infoJson = JSON.stringify({
+        title: result.videoDetails.title,
+        channel: result.videoDetails.author,
+        description: result.videoDetails.description,
+        duration: videoDuration,
+      });
+      cachedInfo = infoJson;
+      const chapterValue = formatChaptersAsJson(extractChapters(result.videoDetails.description));
+      videoTitle = result.videoDetails.title;
+      const truncatedInfo = JSON.stringify({
+        title: result.videoDetails.title,
+        channel: result.videoDetails.author,
+        description: result.videoDetails.description.slice(0, 1000),
+      });
+      const transcriptText = toText(segments, !noDecode);
+      structuredContent = `INFO:\n${truncatedInfo}\n\nTEXT:\n${transcriptText}`;
+      if (dryRun) {
+        await outputText(`${prompt}\n\n${structuredContent}\n`);
+        exitProcess(0);
+      }
+      info(`Transcript: ${segments.length} segments`);
+      await writeCache(dir, "transcript.json", JSON.stringify(segments));
+      await writeCache(dir, "info.json", infoJson);
+      await writeCache(dir, "chapters.json", chapterValue);
+      debug("Cache written: transcript.json, info.json, chapters.json");
+    } else {
+      let chapterValue: string;
+      if (!cachedInfo) {
+        debug("Cache missing info.json, re-fetching video details");
+        const fallbackOpts = lang
+          ? { lang, videoDetails: true as const }
+          : { videoDetails: true as const };
+        const fallbackResult = (await fetchTranscript(videoId, fallbackOpts)) as {
+          videoDetails: VideoDetails;
+          segments: TranscriptSegment[];
+        };
+        videoDuration = fallbackResult.videoDetails.lengthSeconds;
+        cachedInfo = JSON.stringify({
+          title: fallbackResult.videoDetails.title,
+          channel: fallbackResult.videoDetails.author,
+          description: fallbackResult.videoDetails.description,
+          duration: videoDuration,
+        });
+        await writeCache(dir, "info.json", cachedInfo);
+        chapterValue = formatChaptersAsJson(
+          extractChapters(fallbackResult.videoDetails.description),
+        );
+        await writeCache(dir, "chapters.json", chapterValue);
+        debug("Cache written: info.json, chapters.json");
+      } else {
+        const cachedChapters = await readCache(dir, "chapters.json");
+        chapterValue = cachedChapters ?? "not available";
+      }
+      const transcriptText = toText(segments, !noDecode);
+      const cachedInfoObj = JSON.parse(cachedInfo);
+      videoTitle = cachedInfoObj.title;
+      videoDuration = cachedInfoObj.duration ?? 0;
+      const truncatedInfo = JSON.stringify({
+        title: cachedInfoObj.title,
+        channel: cachedInfoObj.channel,
+        description: cachedInfoObj.description.slice(0, 1000),
+      });
+      structuredContent = `INFO:\n${truncatedInfo}\n\nTEXT:\n${transcriptText}`;
+    }
     if (dryRun) {
-      await outputText(`${prompt}\n\n${transcriptText}\n`);
+      await outputText(`${prompt}\n\n${structuredContent}\n`);
       exitProcess(0);
     }
@@ -488,7 +561,7 @@ try {
       summary = await summarize({
         prompt,
         command: sumCmd,
-        transcript: transcriptText,
+        transcript: structuredContent,
         cwd: dir,
       });
       info("Summary ready");
@@ -498,7 +571,12 @@ try {
     const formatted = noFormat ? summary : await formatMd(summary);
     if (format === "html") {
-      const htmlContent = await generateHtml(formatted);
+      const wordCount = summary!.split(/\s+/).filter(Boolean).length;
+      const htmlContent = await generateHtml(formatted, videoTitle, {
+        videoId,
+        duration: videoDuration,
+        wordCount,
+      });
       const htmlPath = join(dir, "summary.html");
       await writeFile(htmlPath, htmlContent, "utf8");
       debug("HTML written:", htmlPath);
@@ -532,6 +610,8 @@ try {
     const dir = cacheDir(videoId, cacheOpts);
     let segments: TranscriptSegment[] | null = null;
     let md: string | null = null;
+    let videoTitle: string | undefined;
+    let videoDuration = 0;
     startTimer();
@@ -569,12 +649,15 @@ try {
         segments: TranscriptSegment[];
       };
       segments = result.segments;
+      videoDuration = result.videoDetails.lengthSeconds;
       const infoJson = JSON.stringify({
         title: result.videoDetails.title,
         channel: result.videoDetails.author,
         description: result.videoDetails.description,
+        duration: videoDuration,
       });
       cachedInfo = infoJson;
+      videoTitle = result.videoDetails.title;
       const chapterValue = formatChaptersAsJson(extractChapters(result.videoDetails.description));
       const truncatedInfo = JSON.stringify({
         title: result.videoDetails.title,
@@ -618,10 +701,12 @@ try {
           videoDetails: VideoDetails;
           segments: TranscriptSegment[];
         };
+        videoDuration = fallbackResult.videoDetails.lengthSeconds;
         cachedInfo = JSON.stringify({
           title: fallbackResult.videoDetails.title,
           channel: fallbackResult.videoDetails.author,
           description: fallbackResult.videoDetails.description,
+          duration: videoDuration,
         });
         await writeCache(dir, "info.json", cachedInfo);
         chapterValue = formatChaptersAsJson(
@@ -635,6 +720,8 @@ try {
       }
       const transcriptText = toText(segments, !noDecode);
       const cachedInfoObj = JSON.parse(cachedInfo);
+      videoTitle = cachedInfoObj.title;
+      videoDuration = cachedInfoObj.duration ?? 0;
       const truncatedInfo = JSON.stringify({
         title: cachedInfoObj.title,
         channel: cachedInfoObj.channel,
@@ -658,7 +745,12 @@ try {
     const formatted = noFormat ? md : await formatMd(md);
     if (format === "html") {
-      const htmlContent = await generateHtml(formatted);
+      const wordCount = md!.split(/\s+/).filter(Boolean).length;
+      const htmlContent = await generateHtml(formatted, videoTitle, {
+        videoId,
+        duration: videoDuration,
+        wordCount,
+      });
       const htmlPath = join(dir, "transcript.html");
       await writeFile(htmlPath, htmlContent, "utf8");
       debug("HTML written:", htmlPath);