@tacone/prosey 0.2.6 → 0.3.0

package/src/config-resolve.test.ts

@@ -0,0 +1,104 @@
+import { describe, expect, test } from "bun:test";
+import {
+  resolveSummarizeCmd,
+  resolveSummarizePrompt,
+  resolveTranscribeCmd,
+  resolveTranscribePrompt,
+} from "./config-resolve";
+import type { ProseyConfig } from "./config";
+
+describe("resolveSummarizeCmd", () => {
+  test("returns summarize.command when present", () => {
+    const config: ProseyConfig = {
+      summarize: { command: "my-sum-cmd", prompt: "x" },
+      ai: { command: "ai-cmd" },
+    };
+    expect(resolveSummarizeCmd(config)).toBe("my-sum-cmd");
+  });
+
+  test("falls back to ai.command when summarize.command is missing", () => {
+    const config: ProseyConfig = {
+      summarize: { prompt: "x" },
+      ai: { command: "ai-cmd" },
+    };
+    expect(resolveSummarizeCmd(config)).toBe("ai-cmd");
+  });
+
+  test("returns null when no command is configured", () => {
+    const config: ProseyConfig = {};
+    expect(resolveSummarizeCmd(config)).toBeNull();
+  });
+});
+
+describe("resolveTranscribeCmd", () => {
+  test("returns transcribe.command when present", () => {
+    const config: ProseyConfig = {
+      transcribe: { command: "my-transcribe-cmd", prompt: "x" },
+      ai: { command: "ai-cmd" },
+    };
+    expect(resolveTranscribeCmd(config)).toBe("my-transcribe-cmd");
+  });
+
+  test("falls back to ai.command when transcribe.command is missing", () => {
+    const config: ProseyConfig = {
+      ai: { command: "ai-cmd" },
+      transcribe: { prompt: "x" },
+    };
+    expect(resolveTranscribeCmd(config)).toBe("ai-cmd");
+  });
+
+  test("falls back to summarize.command when both transcribe and ai are missing", () => {
+    const config: ProseyConfig = {
+      summarize: { command: "old-sum-cmd", prompt: "x" },
+    };
+    expect(resolveTranscribeCmd(config)).toBe("old-sum-cmd");
+  });
+
+  test("returns null when no command is configured", () => {
+    const config: ProseyConfig = {};
+    expect(resolveTranscribeCmd(config)).toBeNull();
+  });
+});
+
+describe("resolveTranscribePrompt", () => {
+  test("returns transcribe.prompt when present", () => {
+    const config: ProseyConfig = {
+      transcribe: { prompt: "my-transcribe-prompt" },
+    };
+    expect(resolveTranscribePrompt(config)).toBe("my-transcribe-prompt");
+  });
+
+  test("falls back to summarize.prompt when transcribe.prompt is missing", () => {
+    const config: ProseyConfig = {
+      summarize: { prompt: "my-sum-prompt" },
+    };
+    expect(resolveTranscribePrompt(config)).toBe("my-sum-prompt");
+  });
+
+  test("returns null when neither transcribe nor summarize prompts exist", () => {
+    const config: ProseyConfig = {};
+    expect(resolveTranscribePrompt(config)).toBeNull();
+  });
+
+  test("transcribe.prompt takes precedence over summarize.prompt", () => {
+    const config: ProseyConfig = {
+      transcribe: { prompt: "trans-prompt" },
+      summarize: { prompt: "sum-prompt" },
+    };
+    expect(resolveTranscribePrompt(config)).toBe("trans-prompt");
+  });
+});
+
+describe("resolveSummarizePrompt", () => {
+  test("returns summarize.prompt when present", () => {
+    const config: ProseyConfig = {
+      summarize: { prompt: "my-sum-prompt" },
+    };
+    expect(resolveSummarizePrompt(config)).toBe("my-sum-prompt");
+  });
+
+  test("returns null when summarize.prompt is missing", () => {
+    const config: ProseyConfig = {};
+    expect(resolveSummarizePrompt(config)).toBeNull();
+  });
+});

package/src/config-resolve.ts

@@ -0,0 +1,17 @@
+import type { ProseyConfig } from "./config";
+
+export function resolveSummarizeCmd(config: ProseyConfig): string | null {
+  return config.summarize?.command ?? config.ai?.command ?? null;
+}
+
+export function resolveSummarizePrompt(config: ProseyConfig): string | null {
+  return config.summarize?.prompt ?? null;
+}
+
+export function resolveTranscribeCmd(config: ProseyConfig): string | null {
+  return config.transcribe?.command ?? config.ai?.command ?? config.summarize?.command ?? null;
+}
+
+export function resolveTranscribePrompt(config: ProseyConfig): string | null {
+  return config.transcribe?.prompt ?? config.summarize?.prompt ?? null;
+}

package/src/config.test.ts

@@ -53,7 +53,9 @@ describe("loadConfig", () => {
     expect(existsSync(tmpConfig)).toBe(true);
 
     const content = await readFile(tmpConfig, "utf8");
+    expect(content).toContain("[ai]");
     expect(content).toContain("[summarize]");
+    expect(content).toContain("[transcribe]");
     expect(content).toContain("command = ");
   });
 
@@ -63,7 +65,7 @@ describe("loadConfig", () => {
     await loadConfig();
     const config = await loadConfig();
     expect(config.summarize?.prompt).toBeString();
-    expect(config.summarize?.command).toBeString();
+    expect(config.ai?.command).toBeString();
   });
 
   test("handles invalid TOML gracefully", async () => {

package/src/config.ts

@@ -8,10 +8,17 @@ import { load } from "js-toml";
 export interface ProseyConfig {
   pager?: string;
   hints?: boolean;
+  ai?: {
+    command?: string;
+  };
   summarize?: {
     prompt?: string;
     command?: string;
   };
+  transcribe?: {
+    prompt?: string;
+    command?: string;
+  };
 }
 
 const FALLBACK_CONFIG_TOML = `# Default prosey configuration
@@ -27,6 +34,11 @@ pager = "auto"
 # 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.
@@ -34,23 +46,20 @@ prompt = """
 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.
-#
-# Available options:
-#
-#   opencode run                    — full access (default)
-#   opencode run --permissions read  — read-only (view files, no edits)
-#
-#   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 run"
+# 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> {

package/src/default-config.toml

@@ -11,6 +11,18 @@ pager = "auto"
 # 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.
+
+# Examples:
+#
+#   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
+#   copilot -s --deny-all-tools --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 --variant low"
+
 [summarize]
 
 # Prompt sent to the command via stdin.
@@ -20,14 +32,30 @@ prompt = """
 Write a comprehensive summary of the following transcription.
 """
 
-# Command to execute with the prompt and transcript piped via stdin.
-# The transcript will be appended to the prompt automatically.
-#
-# Examples:
-#
-#   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
-#
-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"
+# 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 = """
+Format the following text using markdown. Do not rephrase.
+
+- use headers
+- use the INFO section to correct spellings in the text (e.g. Pi vs Pie)
+- use the INFO Title field as the main title
+- use timestamps (if available) as second level headers (just text, no time value)
+- format the text appropriately adding paragraphs, blockquote where it applies
+- aim for max 3-5 sentences (or 350-400 chars) for paragraph on average
+- consider using bold for technical term/proper noun repeated multiple times
+- don't overthink
+
+Only output the formatted text without adding anything.
+"""
+
+# Command override for transcribe. Uncomment to use a different command
+# than the one specified in [ai].
+# command = "opencode run"

package/src/extract-chapters.test.ts

@@ -0,0 +1,229 @@
+import { describe, expect, test } from "bun:test";
+import { extractChapters, formatChaptersAsText, formatChaptersAsJson } from "./extract-chapters";
+
+describe("extractChapters", () => {
+  test("extracts chapters from standard format", () => {
+    const desc = `00:00 Intro
+01:00 Karpathy's Viral Tweet
+02:26 The Age of Meat Computers`;
+    const chapters = extractChapters(desc);
+    expect(chapters).toEqual([
+      { time: 0, title: "Intro" },
+      { time: 60, title: "Karpathy's Viral Tweet" },
+      { time: 146, title: "The Age of Meat Computers" },
+    ]);
+  });
+
+  test("handles single-digit minutes (M:SS)", () => {
+    const desc = `0:00 Intro
+1:30 First Topic`;
+    const chapters = extractChapters(desc);
+    expect(chapters).toEqual([
+      { time: 0, title: "Intro" },
+      { time: 90, title: "First Topic" },
+    ]);
+  });
+
+  test("handles hours (HH:MM:SS)", () => {
+    const desc = `00:00:00 Start
+01:30:00 Midway
+02:15:45 End`;
+    const chapters = extractChapters(desc);
+    expect(chapters).toEqual([
+      { time: 0, title: "Start" },
+      { time: 5400, title: "Midway" },
+      { time: 8145, title: "End" },
+    ]);
+  });
+
+  test("handles brackets [MM:SS]", () => {
+    const desc = `[00:00] Intro
+[01:00] Topic`;
+    const chapters = extractChapters(desc);
+    expect(chapters).toEqual([
+      { time: 0, title: "Intro" },
+      { time: 60, title: "Topic" },
+    ]);
+  });
+
+  test("handles parentheses (MM:SS)", () => {
+    const desc = `(00:00) Intro
+(01:00) Topic`;
+    const chapters = extractChapters(desc);
+    expect(chapters).toEqual([
+      { time: 0, title: "Intro" },
+      { time: 60, title: "Topic" },
+    ]);
+  });
+
+  test("handles dash separator", () => {
+    const desc = `00:00 - Intro
+01:00 - Topic`;
+    const chapters = extractChapters(desc);
+    expect(chapters).toEqual([
+      { time: 0, title: "Intro" },
+      { time: 60, title: "Topic" },
+    ]);
+  });
+
+  test("handles en-dash separator", () => {
+    const desc = `00:00 – Intro\n01:00 – Topic`;
+    const chapters = extractChapters(desc);
+    expect(chapters).toEqual([
+      { time: 0, title: "Intro" },
+      { time: 60, title: "Topic" },
+    ]);
+  });
+
+  test("handles em-dash separator", () => {
+    const desc = `00:00 — Intro\n01:00 — Topic`;
+    const chapters = extractChapters(desc);
+    expect(chapters).toEqual([
+      { time: 0, title: "Intro" },
+      { time: 60, title: "Topic" },
+    ]);
+  });
+
+  test("handles colon separator", () => {
+    const desc = `00:00: Intro\n01:00: Topic`;
+    const chapters = extractChapters(desc);
+    expect(chapters).toEqual([
+      { time: 0, title: "Intro" },
+      { time: 60, title: "Topic" },
+    ]);
+  });
+
+  test("handles dot separator", () => {
+    const desc = `00:00 . Intro\n01:00 . Topic`;
+    const chapters = extractChapters(desc);
+    expect(chapters).toEqual([
+      { time: 0, title: "Intro" },
+      { time: 60, title: "Topic" },
+    ]);
+  });
+
+  test("strips leading whitespace", () => {
+    const desc = `  00:00 Intro
+    01:00 Indented Topic`;
+    const chapters = extractChapters(desc);
+    expect(chapters).toEqual([
+      { time: 0, title: "Intro" },
+      { time: 60, title: "Indented Topic" },
+    ]);
+  });
+
+  test("sorts by time order even if input is out of order", () => {
+    const desc = `03:00 Last
+01:00 Middle
+00:00 First`;
+    const chapters = extractChapters(desc);
+    expect(chapters.map((c) => c.title)).toEqual(["First", "Middle", "Last"]);
+  });
+
+  test("deduplicates by time (keeps first)", () => {
+    const desc = `01:00 First
+01:00 Second
+02:00 Third`;
+    const chapters = extractChapters(desc);
+    expect(chapters).toEqual([
+      { time: 60, title: "First" },
+      { time: 120, title: "Third" },
+    ]);
+  });
+
+  test("skips malformed lines", () => {
+    const desc = `This is not a chapter
+00:00 Real Chapter
+Just some text without a timestamp
+01:30 Another Chapter`;
+    const chapters = extractChapters(desc);
+    expect(chapters).toEqual([
+      { time: 0, title: "Real Chapter" },
+      { time: 90, title: "Another Chapter" },
+    ]);
+  });
+
+  test("skips timestamp with no title", () => {
+    const desc = `00:00
+01:00 Title`;
+    const chapters = extractChapters(desc);
+    expect(chapters).toEqual([{ time: 60, title: "Title" }]);
+  });
+
+  test("returns empty array for empty description", () => {
+    expect(extractChapters("")).toEqual([]);
+  });
+
+  test("returns empty array for description with no timestamps", () => {
+    const desc = `Hello world
+This is a video description
+With no timestamps at all`;
+    expect(extractChapters(desc)).toEqual([]);
+  });
+
+  test("extracts the sample format from the user", () => {
+    const desc = `00:00 Intro
+01:00 Karpathy's Viral Tweet
+01:41 The Overnight 11% Breakthrough
+02:26 "The Age of Meat Computers Is Over"
+03:03 85,000 Stars & Shopify's Results
+04:07 Gary Tan & Applying It to Business
+04:53 Chamath's Content Engine Use Case
+05:32 How the System Works: The 3 Files
+06:27 The Self-Improvement Loop Explained
+07:42 701x Faster: 36,500 Experiments a Year
+08:24 The 3 Must-Have Rules
+10:11 The 3 Nice-to-Haves
+11:51 What You Can Point It At
+14:35 The One-Line Master Prompt
+15:06 Live Test 1: A Faster Website (800ms to 90ms)
+17:34 Live Test 2: Cold Email Subject Lines
+19:55 Live Test 3: Facebook Ads on Autopilot`;
+    const chapters = extractChapters(desc);
+    expect(chapters).toHaveLength(17);
+    expect(chapters[0]).toEqual({ time: 0, title: "Intro" });
+    expect(chapters[16]).toEqual({
+      time: 1195,
+      title: "Live Test 3: Facebook Ads on Autopilot",
+    });
+  });
+});
+
+describe("formatChaptersAsJson", () => {
+  test("formats chapters as key-value JSON", () => {
+    const chapters = [
+      { time: 0, title: "Intro" },
+      { time: 90, title: "Chapter 1" },
+    ];
+    const result = JSON.parse(formatChaptersAsJson(chapters));
+    expect(result).toEqual({ "00:00": "Intro", "01:30": "Chapter 1" });
+  });
+
+  test("formats chapters with hours", () => {
+    const chapters = [{ time: 3661, title: "After 1 Hour" }];
+    const result = JSON.parse(formatChaptersAsJson(chapters));
+    expect(result).toEqual({ "01:01:01": "After 1 Hour" });
+  });
+
+  test("returns not available for empty chapters", () => {
+    expect(formatChaptersAsJson([])).toBe("not available");
+  });
+});
+
+describe("formatChaptersAsText", () => {
+  test("formats chapters without hours", () => {
+    const chapters = [
+      { time: 0, title: "Intro" },
+      { time: 90, title: "Chapter 1" },
+    ];
+    expect(formatChaptersAsText(chapters)).toBe("00:00 Intro\n01:30 Chapter 1");
+  });
+
+  test("formats chapters with hours", () => {
+    const chapters = [
+      { time: 0, title: "Start" },
+      { time: 3661, title: "After 1 Hour" },
+    ];
+    expect(formatChaptersAsText(chapters)).toBe("00:00 Start\n01:01:01 After 1 Hour");
+  });
+});

package/src/extract-chapters.ts

@@ -0,0 +1,66 @@
+export interface Chapter {
+  time: number;
+  title: string;
+}
+
+const lineRegex =
+  /^\s*[\[\(]?(?:(?:(\d{1,2}):)?(\d{1,2}):(\d{2}))[\]\)]?(?:\s*[-–—:.]\s*|\s+)(.+)$/;
+
+export function extractChapters(description: string): Chapter[] {
+  const lines = description.split("\n");
+  const chapters: Chapter[] = [];
+
+  for (const line of lines) {
+    const match = line.match(lineRegex);
+    if (!match) continue;
+
+    const hours = match[1] ? parseInt(match[1], 10) : 0;
+    const minutes = parseInt(match[2]!, 10);
+    const seconds = parseInt(match[3]!, 10);
+    const title = match[4]!.trim();
+    if (!title) continue;
+
+    const time = hours * 3600 + minutes * 60 + seconds;
+    chapters.push({ time, title });
+  }
+
+  chapters.sort((a, b) => a.time - b.time);
+
+  const seen = new Set<number>();
+  return chapters.filter((c) => {
+    if (seen.has(c.time)) return false;
+    seen.add(c.time);
+    return true;
+  });
+}
+
+export function formatChaptersAsJson(chapters: Chapter[]): string {
+  if (chapters.length === 0) return "not available";
+  const obj: Record<string, string> = {};
+  for (const ch of chapters) {
+    const h = Math.floor(ch.time / 3600);
+    const m = Math.floor((ch.time % 3600) / 60);
+    const s = ch.time % 60;
+    const key =
+      h > 0
+        ? `${String(h).padStart(2, "0")}:${String(m).padStart(2, "0")}:${String(s).padStart(2, "0")}`
+        : `${String(m).padStart(2, "0")}:${String(s).padStart(2, "0")}`;
+    obj[key] = ch.title;
+  }
+  return JSON.stringify(obj);
+}
+
+export function formatChaptersAsText(chapters: Chapter[]): string {
+  return chapters
+    .map((c) => {
+      const h = Math.floor(c.time / 3600);
+      const m = Math.floor((c.time % 3600) / 60);
+      const s = c.time % 60;
+      const timeStr =
+        h > 0
+          ? `${String(h).padStart(2, "0")}:${String(m).padStart(2, "0")}:${String(s).padStart(2, "0")}`
+          : `${String(m).padStart(2, "0")}:${String(s).padStart(2, "0")}`;
+      return `${timeStr} ${c.title}`;
+    })
+    .join("\n");
+}

package/src/index.test.ts

@@ -0,0 +1,12 @@
+import { describe, test, expect } from "bun:test";
+import { $ } from "bun";
+import { join } from "node:path";
+
+const BIN = join(import.meta.dir, "..", "bin", "prosey");
+
+describe("dry-run", () => {
+  test("is listed in help text", async () => {
+    const { stdout } = await $`${BIN} --help`.quiet();
+    expect(stdout.toString()).toContain("--dry-run");
+  });
+});