miriad-viz 0.7.3 → 0.8.0

package/dist-cli/index.js

@@ -216,18 +216,6 @@ function classifyIntensity(total) {
   if (total <= INTENSITY_THRESHOLDS.busy) return "busy";
   return "intense";
 }
-function getSuggestion(intensity) {
-  switch (intensity) {
-    case "quiet":
-      return "high gapVizSpeed (skip through quiet period)";
-    case "moderate":
-      return "default vizSpeed (normal pacing)";
-    case "busy":
-      return "low vizSpeed (let viewer see the activity)";
-    case "intense":
-      return "low vizSpeed (let viewer see the frenzy)";
-  }
-}
 function countInWindow(sortedTimestamps, start, end) {
   let count = 0;
   for (const t of sortedTimestamps) {
@@ -243,18 +231,23 @@ function computeEventDensity(input, lines, projectStart, projectEnd) {
   if (Number.isNaN(startMs) || Number.isNaN(endMs) || endMs <= startMs) {
     return [];
   }
-  const commitMs = input.commitDates.map((d) => new Date(d).getTime()).filter((t) => !Number.isNaN(t)).sort((a, b) => a - b);
-  const prMs = input.prMergeDates.map((d) => new Date(d).getTime()).filter((t) => !Number.isNaN(t)).sort((a, b) => a - b);
-  const msgMs = input.messageDates.map((d) => new Date(d).getTime()).filter((t) => !Number.isNaN(t)).sort((a, b) => a - b);
+  const toSortedMs = (dates) => dates.map((d) => new Date(d).getTime()).filter((t) => !Number.isNaN(t)).sort((a, b) => a - b);
+  const commitMs = toSortedMs(input.commitDates);
+  const prMs = toSortedMs(input.prMergeDates);
+  const msgMs = toSortedMs(input.messageDates);
+  const pillMs = toSortedMs(input.pillDates);
+  const fileMs = toSortedMs(input.fileDates);
   const totalDuration = endMs - startMs;
   const sliceDuration = totalDuration / lines.length;
   return lines.map((line, i) => {
-    const windowStart = startMs + i * sliceDuration;
-    const windowEnd = startMs + (i + 1) * sliceDuration;
-    const commits = countInWindow(commitMs, windowStart, windowEnd);
-    const prs = countInWindow(prMs, windowStart, windowEnd);
-    const messages = countInWindow(msgMs, windowStart, windowEnd);
-    const total = commits + prs + messages;
+    const wStart = startMs + i * sliceDuration;
+    const wEnd = startMs + (i + 1) * sliceDuration;
+    const commits = countInWindow(commitMs, wStart, wEnd);
+    const prs = countInWindow(prMs, wStart, wEnd);
+    const messages = countInWindow(msgMs, wStart, wEnd);
+    const pills = countInWindow(pillMs, wStart, wEnd);
+    const files = countInWindow(fileMs, wStart, wEnd);
+    const total = commits + prs + messages + pills + files;
     const intensity = classifyIntensity(total);
     return {
       lineId: line.id,
@@ -263,22 +256,23 @@ function computeEventDensity(input, lines, projectStart, projectEnd) {
       commits,
       prs,
       messages,
+      pills,
+      files,
       total,
       intensity,
-      suggestion: getSuggestion(intensity)
+      windowStart: new Date(wStart).toISOString(),
+      windowEnd: new Date(wEnd).toISOString()
     };
   });
 }
-function formatDensityReport(reports, projectStart, projectEnd) {
+function formatDensityReport(reports, projectStart, projectEnd, timingLines) {
   if (reports.length === 0) return [];
-  const lines = [];
   const startMs = new Date(projectStart).getTime();
   const endMs = new Date(projectEnd).getTime();
   const totalDuration = endMs - startMs;
-  const sliceDuration = totalDuration / reports.length;
-  lines.push("  \u{1F4CA} Event density (from extracted data):");
-  const formatTime = (ms) => {
-    const d = new Date(ms);
+  const lines = [];
+  const formatTime = (iso) => {
+    const d = new Date(iso);
     const months = [
       "Jan",
       "Feb",
@@ -295,22 +289,50 @@ function formatDensityReport(reports, projectStart, projectEnd) {
     ];
     return `${months[d.getUTCMonth()]} ${d.getUTCDate()} ${String(d.getUTCHours()).padStart(2, "0")}:${String(d.getUTCMinutes()).padStart(2, "0")}`;
   };
+  lines.push("  \u{1F4CA} Activity density per narration line:");
   lines.push(
-    `    Your script covers ${formatTime(startMs)} \u2192 ${formatTime(endMs)} (${Math.round(totalDuration / 36e5)}h)`
+    `    Your script covers ${formatTime(projectStart)} \u2192 ${formatTime(projectEnd)} (${Math.round(totalDuration / 36e5)}h)`
   );
   lines.push("");
-  for (let i = 0; i < reports.length; i++) {
-    const r = reports[i];
-    const windowStart = startMs + i * sliceDuration;
-    const windowEnd = startMs + (i + 1) * sliceDuration;
-    const intensityLabel = r.intensity === "intense" ? "INTENSE" : r.intensity;
-    lines.push(`    ${r.lineId} "${r.text}"`);
-    lines.push(
-      `      covers: ${formatTime(windowStart)}-${formatTime(windowEnd)} | ${r.prs} PRs, ${r.messages} messages (${intensityLabel})`
-    );
-    lines.push(`      \u2192 suggestion: ${r.suggestion}`);
-    lines.push("");
+  const timingMap = /* @__PURE__ */ new Map();
+  if (timingLines) {
+    for (const tl of timingLines) timingMap.set(tl.id, tl);
   }
+  const hasTiming = timingMap.size > 0;
+  const idW = Math.max(7, ...reports.map((r) => r.lineId.length));
+  const pad = (s, w) => s.padEnd(w);
+  const rpad = (s, w) => s.padStart(w);
+  let header = `    ${pad("Line ID", idW)}`;
+  if (hasTiming) header += ` | ${rpad("Dur", 6)} | ${rpad("Speed", 5)}`;
+  header += ` | ${rpad("Pills", 5)} | ${rpad("Msgs", 5)} | ${rpad("Cmts", 5)} | ${rpad("PRs", 4)} | ${rpad("Files", 5)} | Time Range`;
+  lines.push(header);
+  let sep = `    ${"\u2500".repeat(idW)}`;
+  if (hasTiming) sep += `\u2500\u253C${"\u2500".repeat(8)}\u2500\u253C${"\u2500".repeat(7)}`;
+  sep += `\u2500\u253C${"\u2500".repeat(7)}\u2500\u253C${"\u2500".repeat(7)}\u2500\u253C${"\u2500".repeat(7)}\u2500\u253C${"\u2500".repeat(6)}\u2500\u253C${"\u2500".repeat(7)}\u2500\u253C${"\u2500".repeat(20)}`;
+  lines.push(sep);
+  for (const r of reports) {
+    const tl = timingMap.get(r.lineId);
+    let row = `    ${pad(r.lineId, idW)}`;
+    if (hasTiming) {
+      const dur = tl ? `${tl.durationSec.toFixed(1)}s` : "\u2014";
+      const spd = tl ? `${tl.vizSpeed.toFixed(1)}x` : "\u2014";
+      row += ` | ${rpad(dur, 6)} | ${rpad(spd, 5)}`;
+    }
+    row += ` | ${rpad(String(r.pills), 5)} | ${rpad(String(r.messages), 5)} | ${rpad(String(r.commits), 5)} | ${rpad(String(r.prs), 4)} | ${rpad(String(r.files), 5)}`;
+    row += ` | ${formatTime(r.windowStart)}-${formatTime(r.windowEnd)}`;
+    lines.push(row);
+  }
+  lines.push("");
+  lines.push("  \u{1F4CA} Pacing guidance:");
+  lines.push("  - High pill count \u2192 lower vizSpeed so pills appear one-by-one like dialog");
+  lines.push("  - Zero activity \u2192 raise vizSpeed to skip dead time");
+  lines.push(
+    "  - Messages \u2260 pills: messages = raw activity density, pills = curated selections that actually render"
+  );
+  lines.push(
+    "  - Commits/PRs/Files are visual events too \u2014 a section can be busy even if chat is quiet"
+  );
+  lines.push("  - Goal: narration should match what the viewer shows on screen");
   return lines;
 }
 
@@ -329,14 +351,16 @@ function buildVizTimingPending(_progress) {
   output.push("  (once pacing.json exists, you'll get the iterate loop instructions)");
   return output;
 }
-function buildVizTimingInProgress(_progress, densityInput, scriptLines, projectStart, projectEnd) {
+function buildVizTimingInProgress(_progress, densityInput, scriptLines, projectStart, projectEnd, timingLines) {
   const output = [];
   output.push("", "\u23F1\uFE0F Viz Timing \u2014 Iterate Loop");
   if (densityInput && scriptLines && scriptLines.length > 0 && projectStart && projectEnd) {
     const reports = computeEventDensity(densityInput, scriptLines, projectStart, projectEnd);
     if (reports.length > 0) {
       output.push("");
-      output.push(...formatDensityReport(reports, projectStart, projectEnd));
+      output.push(
+        ...formatDensityReport(reports, projectStart, projectEnd, timingLines ?? void 0)
+      );
     }
   }
   output.push("");
@@ -458,7 +482,7 @@ function buildCommand(step, progress, flags) {
   }
   return parts.join(" ");
 }
-function computeNext(progress, existingFiles, logTails, flags = {}, dataSummary, env = {}) {
+function computeNext(progress, existingFiles, logTails, flags = {}, dataSummary, env = {}, densityData) {
   const fileSet = new Set(existingFiles);
   const step = getNextStep(progress);
   if (!step) {
@@ -845,7 +869,16 @@ function computeNext(progress, existingFiles, logTails, flags = {}, dataSummary,
       };
     }
     if (state.status === "in_progress") {
-      output.push(...buildVizTimingInProgress(progress, null, null, null, null));
+      output.push(
+        ...buildVizTimingInProgress(
+          progress,
+          densityData?.densityInput ?? null,
+          densityData?.scriptLines ?? null,
+          densityData?.projectStart ?? null,
+          densityData?.projectEnd ?? null,
+          densityData?.timingLines ?? null
+        )
+      );
       return { action: "waiting_for_edit", step, progress, output };
     }
     output.push(...buildVizTimingPending(progress));
@@ -1378,6 +1411,75 @@ function gatherDataSummary(projectDir, dataDir) {
   data.chatActivity = tryRead("chat-activity.json");
   return buildDataSummary(data);
 }
+function gatherDensityData(projectDir, dataDir) {
+  const tryRead = (filename) => {
+    const path = resolve3(projectDir, dataDir, filename);
+    if (!existsSync3(path)) return null;
+    try {
+      return JSON.parse(readFileSync2(path, "utf-8"));
+    } catch {
+      return null;
+    }
+  };
+  const script = tryRead("script.json");
+  if (!script?.lines || script.lines.length === 0) return null;
+  const vizData = tryRead("viz-data.json");
+  const messagesFull = tryRead("messages-full.json");
+  const timing = tryRead("timing.json");
+  const input = {
+    commitDates: [],
+    prMergeDates: [],
+    messageDates: [],
+    pillDates: [],
+    fileDates: []
+  };
+  if (vizData?.events) {
+    for (const evt of vizData.events) {
+      const iso = new Date(evt.timestamp).toISOString();
+      switch (evt.type) {
+        case "commit":
+          input.commitDates.push(iso);
+          break;
+        case "pr_created":
+        case "pr_merged":
+          input.prMergeDates.push(iso);
+          break;
+        case "message":
+          input.pillDates.push(iso);
+          break;
+        case "artifact":
+          input.fileDates.push(iso);
+          break;
+      }
+    }
+  }
+  if (Array.isArray(messagesFull)) {
+    for (const msg of messagesFull) {
+      if (msg.timestamp) input.messageDates.push(msg.timestamp);
+    }
+  }
+  let projectStart = null;
+  let projectEnd = null;
+  if (vizData?.timeRange) {
+    projectStart = new Date(vizData.timeRange.start).toISOString();
+    projectEnd = new Date(vizData.timeRange.end).toISOString();
+  }
+  let timingLines = null;
+  if (timing?.lines) {
+    timingLines = timing.lines.map((l) => ({
+      id: l.id,
+      durationSec: l.durationSec,
+      vizSpeed: l.vizSpeed
+    }));
+  }
+  return {
+    densityInput: input,
+    scriptLines: script.lines,
+    projectStart,
+    projectEnd,
+    timingLines
+  };
+}
 async function runNext(flags) {
   const { projectDir, progress } = requireProject();
   const dataDir = resolve3(projectDir, progress.project.dataDir);
@@ -1437,7 +1539,16 @@ async function runNext(flags) {
   const existingFiles = [...gatherExistingFiles(projectDir), ...gatherAudioFiles(projectDir)];
   const logTails = gatherLogTails(projectDir);
   const dataSummary = gatherDataSummary(projectDir, progress.project.dataDir);
-  const result = computeNext(progress, existingFiles, logTails, nextFlags, dataSummary, env);
+  const densityData = gatherDensityData(projectDir, progress.project.dataDir);
+  const result = computeNext(
+    progress,
+    existingFiles,
+    logTails,
+    nextFlags,
+    dataSummary,
+    env,
+    densityData
+  );
   for (const line of result.output) {
     console.log(line);
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "miriad-viz",
-  "version": "0.7.3",
+  "version": "0.8.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/snorrees/miriad-viz.git"