miriad-viz 0.7.2 → 0.8.0

package/dist-cli/{from-pacing-chain-ZP4XGDJ7.js → from-pacing-chain-ENCSRNXM.js}

@@ -84,6 +84,22 @@ function generateTiming(script, pacing) {
       phase: line.phase
     };
   });
+  const validationErrors = [];
+  for (const line of timedLines) {
+    const expectedRange = totalProjectTime > 0 ? line.durationSec / totalProjectTime : 0;
+    const actualRange = line.progressEnd - line.progressStart;
+    if (Math.abs(actualRange - expectedRange) > 1e-3) {
+      validationErrors.push(
+        `"${line.id}": progress range ${actualRange.toFixed(4)} != expected ${expectedRange.toFixed(4)}`
+      );
+    }
+  }
+  if (validationErrors.length > 0) {
+    throw new Error(
+      `Timing validation failed (${validationErrors.length} clip${validationErrors.length > 1 ? "s" : ""}):
+${validationErrors.join("\n")}`
+    );
+  }
   return {
     version: 1,
     totalDurationSec,

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);
   }
@@ -1530,7 +1641,7 @@ async function main() {
       const port = typeof flags.port === "string" ? Number.parseInt(flags.port, 10) : void 0;
       if (flags["from-pacing"] === true) {
         const dataDir = resolve3(projectDir, progress.project.dataDir);
-        const { runFromPacingChain } = await import("./from-pacing-chain-ZP4XGDJ7.js");
+        const { runFromPacingChain } = await import("./from-pacing-chain-ENCSRNXM.js");
         console.log("\n\u{1F517} Running from-pacing chain: timing \u2192 transform \u2192 preview\n");
         const chainResult = runFromPacingChain(dataDir);
         if (!chainResult.success) {

package/dist-lib/viewer/exports.cjs

@@ -1883,40 +1883,6 @@ function Footer({
     (e) => {
       if (e.target instanceof HTMLInputElement || e.target instanceof HTMLTextAreaElement) return;
       switch (e.code) {
-        case "Space": {
-          e.preventDefault();
-          toggle();
-          break;
-        }
-        case "ArrowRight": {
-          e.preventDefault();
-          if (isAuto) {
-            onToggleMute?.();
-            lastManualSpeed.current = 1;
-            setSpeed(1);
-          } else {
-            const idx = MANUAL_SPEEDS.indexOf(speed);
-            if (idx < MANUAL_SPEEDS.length - 1) {
-              const next = MANUAL_SPEEDS[idx + 1];
-              lastManualSpeed.current = next;
-              setSpeed(next);
-            }
-          }
-          break;
-        }
-        case "ArrowLeft": {
-          e.preventDefault();
-          if (isAuto) break;
-          const idx = MANUAL_SPEEDS.indexOf(speed);
-          if (idx === 0 && hasTimingFile) {
-            onToggleMute?.();
-          } else if (idx > 0) {
-            const prev = MANUAL_SPEEDS[idx - 1];
-            lastManualSpeed.current = prev;
-            setSpeed(prev);
-          }
-          break;
-        }
         case "Home": {
           e.preventDefault();
           scrub(0);
@@ -1944,7 +1910,7 @@ function Footer({
         }
       }
     },
-    [toggle, speed, setSpeed, scrub, onToggleMute, onToggleDev, hasTimingFile, isAuto]
+    [scrub, setSpeed, onToggleMute, onToggleDev, hasTimingFile, isAuto]
   );
   react.useEffect(() => {
     window.addEventListener("keydown", handleKeyDown);
@@ -2737,6 +2703,41 @@ function usePlayback(durationSeconds = FALLBACK_DURATION, timingFile = null) {
     progressRef.current = clamped;
     setProgress(clamped);
   }, []);
+  react.useEffect(() => {
+    const SKIP_SECONDS = 5;
+    const handleKeyDown = (e) => {
+      if (e.target instanceof HTMLInputElement || e.target instanceof HTMLTextAreaElement) return;
+      if (e.key === " " || e.key === "Space") {
+        e.preventDefault();
+        if (playingRef.current) {
+          setPlaying(false);
+        } else {
+          if (progressRef.current >= 1) {
+            progressRef.current = 0;
+            setProgress(0);
+          }
+          lastTimeRef.current = null;
+          setPlaying(true);
+        }
+      } else if (e.key === "ArrowLeft") {
+        e.preventDefault();
+        const denominator = totalProjectTimeRef.current ?? durationSeconds;
+        const delta = SKIP_SECONDS / denominator;
+        const next = Math.max(0, progressRef.current - delta);
+        progressRef.current = next;
+        setProgress(next);
+      } else if (e.key === "ArrowRight") {
+        e.preventDefault();
+        const denominator = totalProjectTimeRef.current ?? durationSeconds;
+        const delta = SKIP_SECONDS / denominator;
+        const next = Math.min(1, progressRef.current + delta);
+        progressRef.current = next;
+        setProgress(next);
+      }
+    };
+    window.addEventListener("keydown", handleKeyDown);
+    return () => window.removeEventListener("keydown", handleKeyDown);
+  }, [durationSeconds]);
   return { progress, playing, speed, play, pause, toggle, setSpeed, scrub };
 }
 function parseViewportString(raw) {