miriad-viz 0.9.1 → 0.9.3

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/chunk-K6N7F6GL.js

@@ -0,0 +1,189 @@
+// src/cli/guided/validate-curated-files.ts
+function validateTimelineEvents(data) {
+  const errors = [];
+  const warnings = [];
+  if (data === null || typeof data !== "object" || !Array.isArray(data.events)) {
+    errors.push("timeline-events.json: `events` must be an array");
+    return { errors, warnings };
+  }
+  const events = data.events;
+  const messageBeanEvents = events.filter((e) => {
+    if (e === null || typeof e !== "object") return false;
+    const type = e.type;
+    return type === "message" || type === "beam";
+  });
+  if (messageBeanEvents.length === 0) {
+    errors.push(
+      "0 message/beam events \u2014 no chat pills will render. Add events with type 'message' or 'beam', fields: { type, t, from, to }."
+    );
+  }
+  const missingT = events.filter((e) => {
+    if (e === null || typeof e !== "object") return true;
+    return !e.t;
+  });
+  if (missingT.length > 0) {
+    warnings.push(
+      `${missingT.length} event(s) missing 't' field (timestamp) \u2014 events without timestamps may not render correctly`
+    );
+  }
+  const messageBeanMissingFields = messageBeanEvents.filter((e) => {
+    const ev = e;
+    return !ev.from || !ev.to;
+  });
+  if (messageBeanMissingFields.length > 0) {
+    warnings.push(
+      `${messageBeanMissingFields.length} message/beam event(s) missing 'from' or 'to' field \u2014 chat pills need both fields to render correctly`
+    );
+  }
+  if (messageBeanEvents.length === 0 && events.length > 0) {
+    const milestoneEvents = events.filter((e) => {
+      if (e === null || typeof e !== "object") return false;
+      return e.type === "milestone";
+    });
+    if (milestoneEvents.length > 0) {
+      warnings.push(
+        "Only milestone events found. Milestones render as markers, NOT chat pills. Add message/beam events for chat pills."
+      );
+    }
+  }
+  return { errors, warnings };
+}
+function validateRetroPageData(data) {
+  const errors = [];
+  const warnings = [];
+  if (data === null || typeof data !== "object") {
+    errors.push("retro-page-data.json: `meta` is missing or not an object");
+    return { errors, warnings };
+  }
+  const d = data;
+  if (d.meta === null || d.meta === void 0 || typeof d.meta !== "object") {
+    errors.push("retro-page-data.json: `meta` is missing or not an object");
+    return { errors, warnings };
+  }
+  const meta = d.meta;
+  if (!meta.title) {
+    errors.push("meta.title is required");
+  }
+  if (!meta.subtitle) {
+    errors.push("meta.subtitle is required");
+  }
+  if (!meta.startDate) {
+    errors.push(
+      "meta.startDate is required \u2014 transform uses this to calculate the project time span"
+    );
+  }
+  if (!meta.endDate) {
+    errors.push(
+      "meta.endDate is required \u2014 transform uses this to calculate the project time span"
+    );
+  }
+  if (!d.teamAssembly || !Array.isArray(d.teamAssembly) || d.teamAssembly.length === 0) {
+    warnings.push("No team assembly entries");
+  } else {
+    const teamAssembly = d.teamAssembly;
+    for (let i = 0; i < teamAssembly.length; i++) {
+      const entry = teamAssembly[i];
+      if (entry === null || typeof entry !== "object") continue;
+      const e = entry;
+      if (!e.agent) {
+        errors.push(`teamAssembly[${i}] missing 'agent' field \u2014 use 'agent', not 'name'`);
+      }
+      if (!e.time) {
+        warnings.push(
+          `teamAssembly[${i}] missing 'time' field \u2014 agent join timestamp will be null`
+        );
+      }
+    }
+  }
+  if (!d.phases || !Array.isArray(d.phases) || d.phases.length === 0) {
+    warnings.push("No phases defined \u2014 timeline will have no phase labels");
+  } else {
+    const phases = d.phases;
+    for (let i = 0; i < phases.length; i++) {
+      const phase = phases[i];
+      if (phase === null || typeof phase !== "object") continue;
+      const p = phase;
+      if (!p.start || !p.end) {
+        warnings.push(`phases[${i}] missing start/end timestamps`);
+      }
+    }
+  }
+  if (!d.milestones || !Array.isArray(d.milestones) || d.milestones.length === 0) {
+    warnings.push("No milestones defined");
+  }
+  if (!d.trustArc || !Array.isArray(d.trustArc) || d.trustArc.length === 0) {
+    warnings.push("No trust arc data");
+  }
+  if (!d.editorialNarration || !Array.isArray(d.editorialNarration) || d.editorialNarration.length === 0) {
+    warnings.push("No editorial narration \u2014 generic phase-based narration will be used");
+  }
+  return { errors, warnings };
+}
+function validateRetroPageQuotes(data) {
+  const errors = [];
+  const warnings = [];
+  if (data === null || typeof data !== "object" || Array.isArray(data)) {
+    errors.push("retro-page-quotes.json: must be an object (not an array or primitive)");
+    return { errors, warnings };
+  }
+  const d = data;
+  const categories = ["good", "bad", "ugly"];
+  const foundCategories = categories.filter(
+    (cat) => Array.isArray(d[cat]) && d[cat].length > 0
+  );
+  if (foundCategories.length === 0) {
+    warnings.push("No quote categories found");
+    return { errors, warnings };
+  }
+  for (const cat of foundCategories) {
+    const entries = d[cat];
+    for (let i = 0; i < entries.length; i++) {
+      const entry = entries[i];
+      if (entry === null || typeof entry !== "object") continue;
+      const e = entry;
+      if (e.speaker !== void 0 && e.author === void 0) {
+        warnings.push(`quotes[${i}] uses 'speaker' \u2014 should be 'author'`);
+      }
+      if (!e.text) {
+        warnings.push(`quotes[${i}] missing 'text' field`);
+      }
+      if (!e.timestamp) {
+        warnings.push(`quotes[${i}] missing 'timestamp' field`);
+      }
+    }
+  }
+  return { errors, warnings };
+}
+function validateCuratedFiles(timelineEvents, retroPageData, retroPageQuotes) {
+  const errors = [];
+  const warnings = [];
+  if (timelineEvents === null) {
+    errors.push("timeline-events.json: could not be read or parsed");
+  } else {
+    const r = validateTimelineEvents(timelineEvents);
+    errors.push(...r.errors);
+    warnings.push(...r.warnings);
+  }
+  if (retroPageData === null) {
+    errors.push("retro-page-data.json: could not be read or parsed");
+  } else {
+    const r = validateRetroPageData(retroPageData);
+    errors.push(...r.errors);
+    warnings.push(...r.warnings);
+  }
+  if (retroPageQuotes === null) {
+    errors.push("retro-page-quotes.json: could not be read or parsed");
+  } else {
+    const r = validateRetroPageQuotes(retroPageQuotes);
+    errors.push(...r.errors);
+    warnings.push(...r.warnings);
+  }
+  return { errors, warnings };
+}
+
+export {
+  validateTimelineEvents,
+  validateRetroPageData,
+  validateRetroPageQuotes,
+  validateCuratedFiles
+};

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,
@@ -1544,7 +1544,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)) {
@@ -1579,6 +1583,7 @@ async function runNext(flags) {
     "audio-approved": flags["audio-approved"] === true || void 0,
     // v2 gate flags
     "script-approved": flags["script-approved"] === true || void 0,
+    "curate-approved": flags["curate-approved"] === true || void 0,
     "voices-approved": flags["voices-approved"] === true || void 0,
     "timing-approved": flags["timing-approved"] === true || void 0,
     "sound-approved": flags["sound-approved"] === true || void 0,
@@ -1597,6 +1602,34 @@ async function runNext(flags) {
     progress.project.dataDir,
     progress.project.outputDir
   );
+  if (flags["curate-approved"]) {
+    const { validateCuratedFiles } = await import("./validate-curated-files-ZLNFHBXT.js");
+    const curateDataDir = resolve3(projectDir, progress.project.dataDir);
+    const tryReadJSON = (filename) => {
+      try {
+        return JSON.parse(readFileSync2(resolve3(curateDataDir, filename), "utf-8"));
+      } catch {
+        return null;
+      }
+    };
+    const validation = validateCuratedFiles(
+      tryReadJSON("timeline-events.json"),
+      tryReadJSON("retro-page-data.json"),
+      tryReadJSON("retro-page-quotes.json")
+    );
+    if (validation.errors.length > 0) {
+      console.log("\n\u2717 Curation validation failed:\n");
+      for (const e of validation.errors) console.log(`  \u2717 ${e}`);
+      for (const w of validation.warnings) console.log(`  \u26A0 ${w}`);
+      console.log("\nFix the errors above and try again.");
+      process.exit(1);
+    }
+    if (validation.warnings.length > 0) {
+      console.log("\n\u26A0 Curation warnings:\n");
+      for (const w of validation.warnings) console.log(`  \u26A0 ${w}`);
+      console.log("");
+    }
+  }
   const result = computeNext(
     progress,
     existingFiles,
@@ -1614,8 +1647,9 @@ 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);
+        await syncStepOutputs(syncConfig, result.step, dataDir2, outputDir);
       } else {
         const progressPath = resolve3(projectDir, ".miriad-viz.json");
         if (existsSync3(progressPath)) {
@@ -1661,7 +1695,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,
@@ -1682,7 +1716,7 @@ async function main() {
     case "transform": {
       const { projectDir, progress } = requireProject();
       const { parseDuration } = await import("./parse-duration-NVLCEFAF.js");
-      const { runTransform } = await import("./transform-SCT5EYPV.js");
+      const { runTransform } = await import("./transform-L7OKE35T.js");
       const padding = {};
       if (typeof flags["pad-start"] === "string") {
         padding.padStartMs = parseDuration(flags["pad-start"]);
@@ -1710,19 +1744,19 @@ async function main() {
           console.log("");
           console.log(chainResult.previewTable);
         }
-        const { runTransform } = await import("./transform-SCT5EYPV.js");
+        const { runTransform } = await import("./transform-L7OKE35T.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-SCT5EYPV.js → transform-L7OKE35T.js}

@@ -1,3 +1,9 @@
+import {
+  TimingFileSchema
+} from "./chunk-SKRQW7PY.js";
+import {
+  validateCuratedFiles
+} from "./chunk-K6N7F6GL.js";
 import {
   buildArtifactData
 } from "./chunk-JITEBF25.js";
@@ -5,7 +11,7 @@ import {
   canSync,
   getBoardSyncConfig,
   syncStepOutputs
-} from "./chunk-UTFBENVA.js";
+} from "./chunk-7BH6QQNB.js";
 import {
   transformToRawData
 } from "./chunk-WP7ZSXBZ.js";
@@ -15,9 +21,6 @@ import {
   markInProgress,
   writeProgress
 } from "./chunk-GLABTDMO.js";
-import {
-  TimingFileSchema
-} from "./chunk-SKRQW7PY.js";
 
 // src/cli/guided/steps/transform.ts
 import { resolve as resolve2 } from "path";
@@ -659,6 +662,22 @@ function printDataInventory(summary, warnings) {
 }
 function runPipeline(dataDir, outDir, options) {
   const { sources, warnings } = loadSources(dataDir);
+  const curationValidation = validateCuratedFiles(
+    sources.timelineEvents,
+    sources.retroPageData,
+    sources.retroPageQuotes
+  );
+  if (curationValidation.errors.length > 0) {
+    console.warn("\n\u26A0 Curated file validation issues:\n");
+    for (const e of curationValidation.errors) console.warn(`  \u2717 ${e}`);
+    for (const w of curationValidation.warnings) console.warn(`  \u26A0 ${w}`);
+    console.warn("\n  Transform will continue, but output may be incomplete.");
+    console.warn("  Fix the issues above and re-run for best results.\n");
+  } else if (curationValidation.warnings.length > 0) {
+    console.warn("\n\u26A0 Curated file warnings:\n");
+    for (const w of curationValidation.warnings) console.warn(`  \u26A0 ${w}`);
+    console.warn("");
+  }
   const summary = validateSources(sources);
   printDataInventory(summary, warnings);
   const rawData = transformToRawData(sources);
@@ -747,7 +766,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-cli/validate-curated-files-ZLNFHBXT.js

@@ -0,0 +1,12 @@
+import {
+  validateCuratedFiles,
+  validateRetroPageData,
+  validateRetroPageQuotes,
+  validateTimelineEvents
+} from "./chunk-K6N7F6GL.js";
+export {
+  validateCuratedFiles,
+  validateRetroPageData,
+  validateRetroPageQuotes,
+  validateTimelineEvents
+};