miriad-viz 0.9.2 → 0.9.4

package/dist-cli/{chunk-UTFBENVA.js → chunk-7BH6QQNB.js}

@@ -144,12 +144,15 @@ var STEP_FILE_MAP = {
   // render output is the final video — too large for board
 };
 var ALWAYS_SYNC = [".miriad-viz.json"];
-async function syncStepOutputs(config, step, dataDir) {
+var OUTPUT_DIR_STEPS = /* @__PURE__ */ new Set(["transform"]);
+async function syncStepOutputs(config, step, dataDir, outputDir) {
+  const stepDir = OUTPUT_DIR_STEPS.has(step) && outputDir ? outputDir : dataDir;
   const files = STEP_FILE_MAP[step] ?? [];
   const allFiles = [.../* @__PURE__ */ new Set([...files, ...ALWAYS_SYNC])];
   let synced = 0;
   for (const file of allFiles) {
-    const localPath = resolve(dataDir, file);
+    const dir = ALWAYS_SYNC.includes(file) ? dataDir : stepDir;
+    const localPath = resolve(dir, file);
     if (!existsSync(localPath)) continue;
     await syncTextFile(config, localPath, file);
     synced++;
@@ -169,7 +172,7 @@ async function syncStepOutputs(config, step, dataDir) {
     console.log(`  \u2601 Synced ${synced} file${synced > 1 ? "s" : ""} to board`);
   }
 }
-async function pullFromBoard(config, dataDir) {
+async function pullFromBoard(config, dataDir, outputDir) {
   const warnings = [];
   let pulled = 0;
   try {
@@ -226,7 +229,7 @@ async function pullFromBoard(config, dataDir) {
     if (existsSync(progressPath)) {
       try {
         const progress = JSON.parse(readFileSync(progressPath, "utf-8"));
-        const validationWarnings = validateProgressConsistency(progress, dataDir);
+        const validationWarnings = validateProgressConsistency(progress, dataDir, outputDir);
         warnings.push(...validationWarnings);
       } catch {
         warnings.push("Failed to parse .miriad-viz.json for consistency check");
@@ -248,7 +251,7 @@ var STEP_REQUIRED_FILES = {
   "sound-design": ["audio-manifest.json"],
   transform: ["viz-data.json"]
 };
-function validateProgressConsistency(progress, dataDir) {
+function validateProgressConsistency(progress, dataDir, outputDir) {
   const warnings = [];
   const steps = progress.steps;
   if (!steps) return warnings;
@@ -268,7 +271,8 @@ function validateProgressConsistency(progress, dataDir) {
       continue;
     }
     for (const file of requiredFiles) {
-      if (!existsSync(resolve(dataDir, file))) {
+      const checkDir = OUTPUT_DIR_STEPS.has(step) && outputDir ? outputDir : dataDir;
+      if (!existsSync(resolve(checkDir, file))) {
         warnings.push(`Step '${step}' marked complete but ${file} missing \u2014 resetting to pending`);
         state.status = "pending";
         break;

package/dist-cli/{extract-5JGICL3V.js → extract-6XRQDMNC.js}

@@ -12,7 +12,7 @@ import {
   canSync,
   getBoardSyncConfig,
   syncStepOutputs
-} from "./chunk-UTFBENVA.js";
+} from "./chunk-7BH6QQNB.js";
 import {
   markComplete,
   markError,

package/dist-cli/index.js

@@ -4,7 +4,7 @@ import {
   pullFromBoard,
   syncStepOutputs,
   syncTextFile
-} from "./chunk-UTFBENVA.js";
+} from "./chunk-7BH6QQNB.js";
 import {
   PROGRESS_FILENAME,
   STEPS,
@@ -525,6 +525,7 @@ function computeNext(progress, existingFiles, logTails, flags = {}, dataSummary,
       return {
         ...chainResult,
         action: "completed_and_chained",
+        completedSteps: ["script", ...chainResult.completedSteps ?? []],
         output: [...output, ...chainResult.output]
       };
     }
@@ -550,7 +551,7 @@ function computeNext(progress, existingFiles, logTails, flags = {}, dataSummary,
         output.push("  \u2502                                                         \u2502");
         output.push("  \u2502  When approved: npx miriad-viz next --script-approved   \u2502");
         output.push("  \u2570\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256F");
-        return { action: "creative_stop", step, progress, output };
+        return { action: "creative_stop", step, progress, output, completedSteps: [step] };
       }
       output.push("", "\u270F\uFE0F  Script writing in progress.");
       output.push("", "  Write your script to: data/script.json");
@@ -648,6 +649,7 @@ function computeNext(progress, existingFiles, logTails, flags = {}, dataSummary,
       return {
         ...chainResult,
         action: "completed_and_chained",
+        completedSteps: ["curate", ...chainResult.completedSteps ?? []],
         output: [...output, ...chainResult.output]
       };
     }
@@ -673,7 +675,7 @@ function computeNext(progress, existingFiles, logTails, flags = {}, dataSummary,
         output.push("  \u2502                                                         \u2502");
         output.push("  \u2502  When approved: npx miriad-viz next --curate-approved   \u2502");
         output.push("  \u2570\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256F");
-        return { action: "creative_stop", step, progress, output };
+        return { action: "creative_stop", step, progress, output, completedSteps: [step] };
       }
       const existing = CURATE_OUTPUT_FILES.filter((f) => fileSet.has(f));
       const missing = CURATE_OUTPUT_FILES.filter((f) => !fileSet.has(f));
@@ -738,6 +740,66 @@ function computeNext(progress, existingFiles, logTails, flags = {}, dataSummary,
     output.push("     - Add standout quotes with speaker, text, and timestamp");
     output.push("  5. Present to human and iterate");
     output.push("");
+    output.push("  \u2501\u2501\u2501 SCHEMA EXAMPLES (copy these as starting templates) \u2501\u2501\u2501");
+    output.push("");
+    output.push("  \u{1F4C4} timeline-events.json:");
+    output.push("  ```json");
+    output.push("  [");
+    output.push('    { "type": "message", "t": "2026-02-20T14:30:00Z", "from": "bob",');
+    output.push('      "to": "snorre", "content": "Chat pill label shown on screen" },');
+    output.push('    { "type": "beam", "t": "2026-02-20T15:00:00Z", "from": "lead",');
+    output.push('      "to": "bob", "content": "Task assignment beam" },');
+    output.push('    { "type": "milestone", "t": "2026-02-20T16:00:00Z",');
+    output.push('      "label": "PR #42 merged", "agent": "bob", "style": "achievement" }');
+    output.push("  ]");
+    output.push("  ```");
+    output.push(
+      '  \u26A0\uFE0F  type MUST be "message" or "beam" for chat pills. "milestone" renders differently.'
+    );
+    output.push("");
+    output.push("  \u{1F4C4} retro-page-data.json:");
+    output.push("  ```json");
+    output.push("  {");
+    output.push('    "meta": {');
+    output.push('      "title": "Project Name",');
+    output.push('      "subtitle": "A story of building something",');
+    output.push('      "startDate": "2026-02-20T00:00:00Z",');
+    output.push('      "endDate": "2026-02-21T00:00:00Z"');
+    output.push("    },");
+    output.push('    "teamAssembly": [');
+    output.push('      { "agent": "bob", "role": "Builder", "time": "2026-02-20T01:00:00Z" }');
+    output.push("    ],");
+    output.push('    "phases": [');
+    output.push('      { "id": "discovery", "label": "Discovery",');
+    output.push('        "startTime": "2026-02-20T00:00:00Z", "endTime": "2026-02-20T12:00:00Z" }');
+    output.push("    ],");
+    output.push('    "milestones": [');
+    output.push(
+      '      { "label": "First commit", "time": "2026-02-20T02:00:00Z", "phase": "discovery" }'
+    );
+    output.push("    ],");
+    output.push('    "narration": []');
+    output.push("  }");
+    output.push("  ```");
+    output.push(
+      "  \u26A0\uFE0F  meta.startDate and meta.endDate are REQUIRED. phases need startTime/endTime."
+    );
+    output.push('  \u26A0\uFE0F  teamAssembly uses "agent" (not "name") and must have "time".');
+    output.push("");
+    output.push("  \u{1F4C4} retro-page-quotes.json:");
+    output.push("  ```json");
+    output.push("  {");
+    output.push('    "good": [');
+    output.push(
+      '      { "text": "Quote text here", "author": "bob", "timestamp": "2026-02-20T14:30:00Z" }'
+    );
+    output.push("    ],");
+    output.push('    "bad": [],');
+    output.push('    "funny": []');
+    output.push("  }");
+    output.push("  ```");
+    output.push("  \u2501\u2501\u2501 END SCHEMA EXAMPLES \u2501\u2501\u2501");
+    output.push("");
     output.push("  \u2705 Curation checklist:");
     output.push("     \u25A1 Every narration line has at least one labeled event in its time range");
     output.push("     \u25A1 Milestone labels are short (< 60 chars) and make sense as chat pills");
@@ -770,6 +832,7 @@ function computeNext(progress, existingFiles, logTails, flags = {}, dataSummary,
       return {
         ...chainResult,
         action: "completed_and_chained",
+        completedSteps: ["voices", ...chainResult.completedSteps ?? []],
         output: [...output, ...chainResult.output]
       };
     }
@@ -799,6 +862,7 @@ function computeNext(progress, existingFiles, logTails, flags = {}, dataSummary,
       return {
         ...chainResult,
         action: "completed_and_chained",
+        completedSteps: ["voices", ...chainResult.completedSteps ?? []],
         output: [...output, ...chainResult.output]
       };
     }
@@ -906,6 +970,7 @@ function computeNext(progress, existingFiles, logTails, flags = {}, dataSummary,
       return {
         ...chainResult,
         action: "completed_and_chained",
+        completedSteps: ["viz-timing", ...chainResult.completedSteps ?? []],
         output: [...output, ...chainResult.output]
       };
     }
@@ -938,6 +1003,7 @@ function computeNext(progress, existingFiles, logTails, flags = {}, dataSummary,
       return {
         ...chainResult,
         action: "completed_and_chained",
+        completedSteps: ["sound-design", ...chainResult.completedSteps ?? []],
         output: [...output, ...chainResult.output]
       };
     }
@@ -977,7 +1043,7 @@ function computeNext(progress, existingFiles, logTails, flags = {}, dataSummary,
         output.push("");
         output.push("  \u26D4 CREATIVE STOP \u2014 Present results to the human and wait for approval.");
         output.push("  Only run `npx miriad-viz next` after human approves.");
-        return { action: "creative_stop", step, progress, output };
+        return { action: "creative_stop", step, progress, output, completedSteps: [step] };
       }
       output.push(
         "",
@@ -987,6 +1053,7 @@ function computeNext(progress, existingFiles, logTails, flags = {}, dataSummary,
       return {
         ...chainResult,
         action: "completed_and_chained",
+        completedSteps: [step, ...chainResult.completedSteps ?? []],
         output: [...output, ...chainResult.output]
       };
     }
@@ -1544,7 +1611,11 @@ async function runNext(flags) {
       const syncConfig = getBoardSyncConfig(progress.project.dataDir);
       if (syncConfig) {
         console.log("\n\u2601 Checking board for existing pipeline state...");
-        const { pulled, warnings } = await pullFromBoard(syncConfig, dataDir);
+        const { pulled, warnings } = await pullFromBoard(
+          syncConfig,
+          dataDir,
+          resolve3(projectDir, progress.project.outputDir)
+        );
         if (pulled > 0) {
           console.log(`  \u2713 Pulled ${pulled} file${pulled > 1 ? "s" : ""} from board`);
           if (existsSync3(progressPath)) {
@@ -1643,8 +1714,12 @@ async function runNext(flags) {
     const syncConfig = getBoardSyncConfig(result.progress.project.dataDir);
     if (syncConfig) {
       const dataDir2 = resolve3(projectDir, result.progress.project.dataDir);
+      const outputDir = resolve3(projectDir, result.progress.project.outputDir);
       if (result.step && (result.action === "completed_and_chained" || result.action === "creative_stop")) {
-        await syncStepOutputs(syncConfig, result.step, dataDir2);
+        const stepsToSync = result.completedSteps?.length ? result.completedSteps : [result.step];
+        for (const syncStep of new Set(stepsToSync)) {
+          await syncStepOutputs(syncConfig, syncStep, dataDir2, outputDir);
+        }
       } else {
         const progressPath = resolve3(projectDir, ".miriad-viz.json");
         if (existsSync3(progressPath)) {
@@ -1690,7 +1765,7 @@ async function main() {
     }
     case "extract": {
       const { projectDir, progress } = requireProject();
-      const { runExtract } = await import("./extract-5JGICL3V.js");
+      const { runExtract } = await import("./extract-6XRQDMNC.js");
       await runExtract({
         projectDir,
         progress,
@@ -1711,7 +1786,7 @@ async function main() {
     case "transform": {
       const { projectDir, progress } = requireProject();
       const { parseDuration } = await import("./parse-duration-NVLCEFAF.js");
-      const { runTransform } = await import("./transform-Z4LA7G44.js");
+      const { runTransform } = await import("./transform-3YUJZORK.js");
       const padding = {};
       if (typeof flags["pad-start"] === "string") {
         padding.padStartMs = parseDuration(flags["pad-start"]);
@@ -1739,19 +1814,19 @@ async function main() {
           console.log("");
           console.log(chainResult.previewTable);
         }
-        const { runTransform } = await import("./transform-Z4LA7G44.js");
+        const { runTransform } = await import("./transform-3YUJZORK.js");
         await runTransform({ projectDir, progress });
-        const { runPreview: runPreview2 } = await import("./preview-UUWVOX5Y.js");
+        const { runPreview: runPreview2 } = await import("./preview-7AGBBMPI.js");
         await runPreview2({ projectDir, progress, port, noOpen: flags["no-open"] === true });
         break;
       }
-      const { runPreview } = await import("./preview-UUWVOX5Y.js");
+      const { runPreview } = await import("./preview-7AGBBMPI.js");
       await runPreview({ projectDir, progress, port, noOpen: flags["no-open"] === true });
       break;
     }
     case "render": {
       const { projectDir, progress } = requireProject();
-      const { runRender } = await import("./render-T2UXDN25.js");
+      const { runRender } = await import("./render-LBIBW45Z.js");
       await runRender({ projectDir, progress, draft: flags.draft === true });
       break;
     }

package/dist-cli/{preview-UUWVOX5Y.js → preview-7AGBBMPI.js}

@@ -8,11 +8,10 @@ import {
 } from "./chunk-GLABTDMO.js";
 
 // src/cli/guided/steps/preview.ts
-import { execSync } from "child_process";
 import { copyFileSync, existsSync, mkdirSync, readdirSync } from "fs";
 import { resolve } from "path";
 function copyPreviewAssets(options) {
-  const { outputDir, audioDir, viewerDir } = options;
+  const { outputDir, dataDir, audioDir, viewerDir } = options;
   const viewerDataDir = resolve(viewerDir, "public", "data");
   const viewerAudioDir = resolve(viewerDir, "public", "audio");
   const result = {
@@ -26,10 +25,12 @@ function copyPreviewAssets(options) {
     copyFileSync(vizDataPath, resolve(viewerDataDir, "viz-data.json"));
     result.copiedVizData = true;
   }
-  const timingPath = resolve(outputDir, "timing.json");
-  if (existsSync(timingPath)) {
+  const timingOutputPath = resolve(outputDir, "timing.json");
+  const timingDataPath = resolve(dataDir, "timing.json");
+  const timingSource = existsSync(timingOutputPath) ? timingOutputPath : existsSync(timingDataPath) ? timingDataPath : null;
+  if (timingSource) {
     mkdirSync(viewerDataDir, { recursive: true });
-    copyFileSync(timingPath, resolve(viewerDataDir, "timing.json"));
+    copyFileSync(timingSource, resolve(viewerDataDir, "timing.json"));
     result.copiedTiming = true;
   }
   if (existsSync(audioDir)) {
@@ -74,7 +75,8 @@ async function runPreview(options) {
     }
   }
   const audioDir = resolve(projectDir, "audio");
-  const copyResult = copyPreviewAssets({ outputDir: outDir, audioDir, viewerDir });
+  const dataDir = resolve(projectDir, progress.project.dataDir);
+  const copyResult = copyPreviewAssets({ outputDir: outDir, dataDir, audioDir, viewerDir });
   if (copyResult.copiedVizData) {
     console.log("  \u2713 Copied viz-data.json to viewer/public/data/");
   }
@@ -84,26 +86,13 @@ async function runPreview(options) {
   if (copyResult.audioFileCount > 0) {
     console.log(`  \u2713 Copied ${copyResult.audioFileCount} audio file(s) to viewer/public/audio/`);
   }
-  const nodeModules = resolve(viewerDir, "node_modules");
-  if (!existsSync(nodeModules)) {
-    console.log("  Installing viewer dependencies...");
-    execSync("pnpm install", { cwd: viewerDir, stdio: "inherit" });
-    console.log("  \u2713 Dependencies installed");
-  }
-  const port = options.port || 5174;
   markComplete(progress, "preview");
   writeProgress(projectDir, progress);
-  console.log(`
-  Starting preview server on port ${port}...`);
-  console.log(`  Viewer:  http://localhost:${port}`);
-  console.log("\n  Press Ctrl+C to stop.\n");
-  try {
-    execSync(`npx vite --port ${port}${options.noOpen ? "" : " --open"}`, {
-      cwd: viewerDir,
-      stdio: "inherit"
-    });
-  } catch {
-  }
+  console.log("\n  To start the preview server:");
+  console.log(
+    "  cd viewer && pnpm install && nohup npx vite --host 0.0.0.0 --port 5174 > /tmp/vite.log 2>&1 &"
+  );
+  console.log("\n  Then get a tunnel URL to share with the human.");
 }
 export {
   copyPreviewAssets,

package/dist-cli/{render-T2UXDN25.js → render-LBIBW45Z.js}

@@ -2,7 +2,7 @@ import {
   canSync,
   getBoardSyncConfig,
   syncStepOutputs
-} from "./chunk-UTFBENVA.js";
+} from "./chunk-7BH6QQNB.js";
 import {
   markComplete,
   markError,

package/dist-cli/{transform-Z4LA7G44.js → transform-3YUJZORK.js}

@@ -11,7 +11,7 @@ import {
   canSync,
   getBoardSyncConfig,
   syncStepOutputs
-} from "./chunk-UTFBENVA.js";
+} from "./chunk-7BH6QQNB.js";
 import {
   transformToRawData
 } from "./chunk-WP7ZSXBZ.js";
@@ -52,12 +52,6 @@ function deriveTimeRange(rawData, curationData, options) {
     }
     for (const m of rawData.messages) timestamps.push(m.timestamp);
     for (const a of rawData.agents) timestamps.push(a.joinedAt);
-    for (const p of curationData.phases) {
-      timestamps.push(p.startTime);
-      timestamps.push(p.endTime);
-    }
-    for (const m of curationData.milestones) timestamps.push(m.timestamp);
-    for (const q of curationData.quotes) timestamps.push(q.timestamp);
     if (timestamps.length === 0) {
       throw new Error("processData: no timestamps found in data \u2014 cannot derive time range");
     }
@@ -477,11 +471,25 @@ function parseInformalTimestamp(timeStr, referenceYear) {
   return date.getTime();
 }
 function findPhaseForTimestamp(timestamp, phases) {
-  return phases.find((p) => {
+  if (phases.length === 0) return void 0;
+  const exact = phases.find((p) => {
     const start = new Date(p.start).getTime();
     const end = new Date(p.end).getTime();
     return timestamp >= start && timestamp <= end;
   });
+  if (exact) return exact;
+  let nearest;
+  let minDistance = Number.POSITIVE_INFINITY;
+  for (const p of phases) {
+    const start = new Date(p.start).getTime();
+    const end = new Date(p.end).getTime();
+    const distance = Math.min(Math.abs(timestamp - start), Math.abs(timestamp - end));
+    if (distance < minDistance) {
+      minDistance = distance;
+      nearest = p;
+    }
+  }
+  return nearest;
 }
 
 // src/cli/pipeline.ts
@@ -766,7 +774,7 @@ Output written to ${progress.project.outputDir}/:`);
     if (canSync()) {
       const syncConfig = getBoardSyncConfig(progress.project.dataDir);
       if (syncConfig) {
-        await syncStepOutputs(syncConfig, "transform", outDir);
+        await syncStepOutputs(syncConfig, "transform", dataDir, outDir);
       }
     }
     console.log("\n\u2713 Transform complete. Proceed to the preview step.");

package/dist-lib/{chunk-AQ5ZU7P2.cjs → chunk-DZYFC24M.cjs}

@@ -859,12 +859,6 @@ function deriveTimeRange(rawData, curationData, options) {
     }
     for (const m of rawData.messages) timestamps.push(m.timestamp);
     for (const a of rawData.agents) timestamps.push(a.joinedAt);
-    for (const p of curationData.phases) {
-      timestamps.push(p.startTime);
-      timestamps.push(p.endTime);
-    }
-    for (const m of curationData.milestones) timestamps.push(m.timestamp);
-    for (const q of curationData.quotes) timestamps.push(q.timestamp);
     if (timestamps.length === 0) {
       throw new Error("processData: no timestamps found in data \u2014 cannot derive time range");
     }
@@ -1498,5 +1492,5 @@ exports.computePRPeakRows = computePRPeakRows;
 exports.enrichVizData = enrichVizData;
 exports.getFrameState = getFrameState;
 exports.processData = processData;
-//# sourceMappingURL=chunk-AQ5ZU7P2.cjs.map
-//# sourceMappingURL=chunk-AQ5ZU7P2.cjs.map
+//# sourceMappingURL=chunk-DZYFC24M.cjs.map
+//# sourceMappingURL=chunk-DZYFC24M.cjs.map