@staff0rd/assist 0.620.0 → 0.621.1

package/dist/index.js

@@ -6,7 +6,7 @@ import { Command } from "commander";
 // package.json
 var package_default = {
   name: "@staff0rd/assist",
-  version: "0.620.0",
+  version: "0.621.1",
   type: "module",
   main: "dist/index.js",
   bin: {
@@ -32220,6 +32220,21 @@ function registerSync(program2) {
 // src/commands/transcript/clean.ts
 import { existsSync as existsSync71 } from "fs";
 
+// src/commands/transcript/convert/formatTimestamp.ts
+function pad(value, width) {
+  return String(value).padStart(width, "0");
+}
+function formatTimestamp2(ms) {
+  const totalSeconds = Math.floor(ms / 1e3);
+  const hours = Math.floor(totalSeconds / 3600);
+  const minutes = Math.floor(totalSeconds % 3600 / 60);
+  const seconds = totalSeconds % 60;
+  return `${pad(hours, 2)}:${pad(minutes, 2)}:${pad(seconds, 2)}.${pad(ms % 1e3, 3)}`;
+}
+function formatClock(ms) {
+  return formatTimestamp2(ms).slice(0, 8);
+}
+
 // src/commands/transcript/cleanText.ts
 function cleanText(text18) {
   const words = text18.split(/\s+/);
@@ -32408,7 +32423,7 @@ function cuesToChatMessages(cues) {
     if (lastMessage && lastMessage.speaker === speaker) {
       lastMessage.text += ` ${cue.text}`;
     } else {
-      messages.push({ speaker, text: cue.text });
+      messages.push({ speaker, text: cue.text, startMs: cue.startMs });
     }
   }
   return messages.map((msg) => ({
@@ -32416,30 +32431,20 @@ function cuesToChatMessages(cues) {
     text: cleanText(msg.text)
   }));
 }
-function formatChatLog(messages) {
-  return messages.map((msg) => `${msg.speaker}: ${msg.text}`).join("\n\n");
+function formatChatLog(messages, options2 = {}) {
+  return messages.map((msg) => {
+    const prefix2 = options2.timestamps ? `[${formatClock(msg.startMs)}] ` : "";
+    return `${prefix2}${msg.speaker}: ${msg.text}`;
+  }).join("\n\n");
 }
 
 // src/commands/transcript/convert/formatVtt.ts
-function pad(value, width) {
-  return String(value).padStart(width, "0");
-}
-function formatTimestamp2(ms) {
-  const totalSeconds = Math.floor(ms / 1e3);
-  const hours = Math.floor(totalSeconds / 3600);
-  const minutes = Math.floor(totalSeconds % 3600 / 60);
-  const seconds = totalSeconds % 60;
-  return `${pad(hours, 2)}:${pad(minutes, 2)}:${pad(seconds, 2)}.${pad(ms % 1e3, 3)}`;
-}
 function formatCue(cue) {
   const timing = `${formatTimestamp2(cue.startMs)} --> ${formatTimestamp2(cue.endMs)}`;
   const text18 = cue.speaker ? `<v ${cue.speaker}>${cue.text}` : cue.text;
   return `${timing}
 ${text18}`;
 }
-function formatClock(ms) {
-  return formatTimestamp2(ms).slice(0, 8);
-}
 function formatNoteBlock(lines2) {
   return lines2.length ? [lines2.map((line) => `NOTE ${line}`).join("\n")] : [];
 }
@@ -32471,8 +32476,8 @@ var FORMATS = ["md", "vtt"];
 function isCleanFormat(value) {
   return FORMATS.includes(value);
 }
-function serialise(cues, format) {
-  return format === "vtt" ? formatVtt(cues) : formatChatLog(cuesToChatMessages(cues));
+function serialise(cues, format, timestamps) {
+  return format === "vtt" ? formatVtt(cues) : formatChatLog(cuesToChatMessages(cues), { timestamps });
 }
 function clean(file, options2 = {}) {
   const format = options2.format ?? "md";
@@ -32482,6 +32487,13 @@ function clean(file, options2 = {}) {
     );
     process.exit(1);
   }
+  const timestamps = options2.timestamps ?? false;
+  if (timestamps && format !== "md") {
+    console.error(
+      `Error: --timestamps applies only to --format md (got: ${format})`
+    );
+    process.exit(1);
+  }
   if (!existsSync71(file)) {
     console.error(`Error: VTT file not found: ${file}`);
     process.exit(1);
@@ -32491,7 +32503,7 @@ function clean(file, options2 = {}) {
     console.error(`Error: no cues found in: ${file}`);
     process.exit(1);
   }
-  console.log(serialise(cues, format));
+  console.log(serialise(cues, format, timestamps));
 }
 
 // src/commands/transcript/shared.ts
@@ -32778,13 +32790,37 @@ function move(file, options2) {
   console.log(`Summary target:       ${summaryPath}`);
 }
 
+// src/commands/transcript/transcriptWorkflowHelp.ts
+function transcriptWorkflowHelp() {
+  return [
+    "",
+    "Collapsing several conversations into one transcript \u2014 read, select, merge:",
+    "",
+    "  1. Read   assist transcript clean ./a.vtt --format md --timestamps",
+    "            Each speaker turn is prefixed [hh:mm:ss], so the passages worth keeping",
+    "            can be cited as ranges. Repeat per source.",
+    "",
+    "  2. Select Write the ranges to keep, and a reason per dropped passage:",
+    '              { "keep": [{ "file": "a.vtt", "from": "00:14:22", "to": "00:19:40" }],',
+    '                "removed": ["private", "off-topic"] }',
+    "            from/to are matched against the source times printed in step 1.",
+    "",
+    "  3. Merge  assist transcript merge ./a.vtt ./b.vtt --select ./selection.json --out ./merged.vtt",
+    "            Cue times are rebased onto one continuous timeline; the sources, the",
+    "            removal count and each passage's original start survive as NOTE blocks."
+  ].join("\n");
+}
+
 // src/commands/registerTranscript.ts
 function registerTranscript(program2) {
-  const transcriptCommand = program2.command("transcript").description("Meeting transcript utilities");
+  const transcriptCommand = program2.command("transcript").description("Meeting transcript utilities").addHelpText("after", () => transcriptWorkflowHelp());
   configHelp(transcriptCommand, transcriptConfigHelp);
   transcriptCommand.command("configure").description("Configure transcript directories").action(configure);
   transcriptCommand.command("list").description("List raw .vtt filenames waiting in the pick-up directory").action(list4);
-  transcriptCommand.command("clean <path>").description("Clean any .vtt file and write the result to stdout").option("--format <md|vtt>", "output format", "md").action(clean);
+  transcriptCommand.command("clean <path>").description("Clean any .vtt file and write the result to stdout").option("--format <md|vtt>", "output format", "md").option(
+    "--timestamps",
+    "prefix each speaker turn with its start time (--format md only)"
+  ).action(clean);
   transcriptCommand.command("merge <path...>").description(
     "Collapse several .vtt files into one transcript with NOTE provenance"
   ).option("--out <path>", "write the merged transcript to this path").option(

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@staff0rd/assist",
-	"version": "0.620.0",
+	"version": "0.621.1",
 	"type": "module",
 	"main": "dist/index.js",
 	"bin": {