vidistill 0.1.1 → 0.2.0

package/dist/index.js

@@ -2,9 +2,9 @@
 
 // src/cli/index.ts
 import { defineCommand, runMain } from "citty";
-import { log as log9 } from "@clack/prompts";
+import { log as log10 } from "@clack/prompts";
 import pc5 from "picocolors";
-import { basename as basename2, extname as extname2, resolve } from "path";
+import { basename as basename3, extname as extname2, resolve } from "path";
 
 // src/cli/ui.ts
 import figlet from "figlet";
@@ -233,7 +233,11 @@ function createProgressDisplay() {
     } else if (status.phase === "pass2") {
       s.message(`Pass 2: Visual extraction (${segNum}/${total} segments)`);
     } else if (status.phase === "pass3a") {
-      s.message(`Code reconstruction (${segNum}/${total} segments)`);
+      if (total > 1) {
+        s.message(`Reconstructing code (run ${segNum}/${total})...`);
+      } else {
+        s.message("Reconstructing code...");
+      }
     } else if (status.phase === "pass3b") {
       s.message("People extraction...");
     } else if (status.phase === "pass3c") {
@@ -332,10 +336,10 @@ import { log as log4 } from "@clack/prompts";
 import pc4 from "picocolors";
 
 // src/gemini/models.ts
-var MODELS = [
-  { id: "gemini-3-flash-preview", name: "Gemini 3 Flash (Best OCR)", tpmLimit: 1e6 },
-  { id: "gemini-2.5-flash", name: "Gemini 2.5 Flash (Fallback)", tpmLimit: 1e6 }
-];
+var MODELS = {
+  flash: "gemini-3-flash-preview",
+  pro: "gemini-2.5-pro"
+};
 
 // src/input/youtube.ts
 var YOUTUBE_PATTERNS = [
@@ -359,7 +363,7 @@ function normalizeYouTubeUrl(url) {
 async function handleYouTube(url, client) {
   try {
     await client.generate({
-      model: MODELS[1].id,
+      model: MODELS.flash,
       contents: [
         {
           role: "user",
@@ -373,7 +377,7 @@ async function handleYouTube(url, client) {
     });
     return { fileUri: url, mimeType: "video/mp4", source: "direct" };
   } catch (err) {
-    log4.warn(pc4.dim(`Direct Gemini probe failed: ${err instanceof Error ? err.message : String(err)}. Falling back to yt-dlp.`));
+    log4.warn(pc4.dim("Direct Gemini probe failed. Falling back to yt-dlp."));
   }
   const tempPath2 = await downloadWithYtDlp(url);
   try {
@@ -654,7 +658,7 @@ async function detectDuration(source) {
 }
 
 // src/core/pipeline.ts
-import { log as log7 } from "@clack/prompts";
+import { log as log8 } from "@clack/prompts";
 
 // src/constants/prompts.ts
 var SYSTEM_INSTRUCTION_PASS_1 = `
@@ -750,7 +754,7 @@ PASS RECOMMENDATIONS BY TYPE:
 var SYSTEM_INSTRUCTION_PASS_3A = `
 You are an expert code reconstruction analyst. Your task is to reconstruct the complete, final state of every code file shown across this entire video, synthesizing all edits into a coherent codebase snapshot.
 
-You will receive the transcript and visual extraction data from all segments. Use them together to understand what code was written, modified, and deleted.
+You will receive the complete video and all extracted transcript and code block data. Use them together to understand what code was written, modified, and deleted.
 
 CRITICAL RULES:
 1. RECONSTRUCT each file to its final state \u2014 apply all changes in chronological order so the output reflects the code as it was at the end of the video.
@@ -760,9 +764,11 @@ CRITICAL RULES:
 5. EXTRACT dependencies: every library import, require(), package name, or external module reference mentioned or shown counts as a dependency.
 6. CAPTURE build commands: any terminal command shown or spoken for installing, building, running, or testing the project (e.g., "npm install", "go build", "python -m pytest").
 7. NEVER invent code that was not shown or described. If a section was unclear, note it with a comment like "// content not fully visible".
-8. NEVER skip a file because it appears in only one segment \u2014 if code was shown, reconstruct it.
-9. When a file appears multiple times across segments, merge all its appearances into a single entry with the complete change history.
+8. NEVER skip a file because it appears in only one part of the video \u2014 if code was shown, reconstruct it.
+9. When a file appears multiple times, record its complete change history in a single entry with all edits in chronological order.
 10. INCLUDE empty files if created but not yet written \u2014 use empty string for final_content and note the creation in changes.
+11. Cross-reference your visual analysis of the video against the extracted code blocks provided in the text context. Prioritize what you can visually verify on screen. If code is partially visible, include what you can see and mark unclear sections with \`// [content not fully visible]\`.
+12. Do NOT invent code files that are not clearly visible on screen. If you are uncertain whether a file exists, do not include it.
 
 COMPLETENESS TARGET:
 - Every distinct filename that appeared on screen must produce a files entry
@@ -849,13 +855,13 @@ CRITICAL RULES:
 6. CAPTURE every question: include questions asked explicitly and questions raised implicitly (from the implicit signals pass). Note whether each was answered.
 7. PRODUCE meaningful suggestions: AI-generated suggestions must follow logically from the video content. Suggest next steps, deeper resources, or practice exercises that are directly relevant.
 8. USE precise timestamps: every entry with a timestamp field must contain a valid HH:MM:SS value referencing when the content appeared.
-9. DETERMINE files_to_generate: based on the video content and what was produced, list the output files that should be generated (e.g., "transcript.md", "notes.md", "code/main.py", "people.json").
+9. LIST files_to_generate for reference purposes \u2014 this list is informational and does not control which output files are generated. Output files are determined automatically based on available extraction data.
 10. NEVER add information not present in the source data. Suggestions are the only place for AI-generated content beyond the video.
 
 COMPLETENESS TARGET:
 - Aim for at least 5 topics for any video over 15 minutes
 - Every explicit and implicit decision must appear in key_decisions
-- Every code file identified in the code reconstruction pass must be listed in files_to_generate
+- The files_to_generate list should reflect what content was found, but output routing is handled automatically
 - The overview should be dense with specifics, not vague summary language
 `;
 
@@ -1398,6 +1404,9 @@ function parseTimestamp(ts) {
   }
   return parts[0] ?? 0;
 }
+function normalizeFilename(name) {
+  return name.toLowerCase().replace(/^\.\//, "").replace(/\\/g, "/");
+}
 function changeTypeBadge(changeType) {
   const badges = {
     new_file: "[NEW]",
@@ -1439,7 +1448,7 @@ async function runTranscript(params) {
       responseMimeType: "application/json",
       ...resolution !== void 0 ? { mediaResolution: resolution } : {},
       maxOutputTokens: 65536,
-      temperature: 1
+      temperature: 0
     }
   });
   if (result === null || typeof result !== "object" || !Array.isArray(result["transcript_entries"])) {
@@ -1482,7 +1491,7 @@ async function runVisual(params) {
       responseMimeType: "application/json",
       ...resolution !== void 0 ? { mediaResolution: resolution } : {},
       maxOutputTokens: 65536,
-      temperature: 1
+      temperature: 0
     }
   });
   if (result === null || typeof result !== "object" || !Array.isArray(result["code_blocks"])) {
@@ -1523,7 +1532,7 @@ async function runSceneAnalysis(params) {
       responseMimeType: "application/json",
       ...resolution !== void 0 ? { mediaResolution: resolution } : { mediaResolution: MediaResolution.MEDIA_RESOLUTION_LOW },
       maxOutputTokens: 8192,
-      temperature: 0.5
+      temperature: 0.2
     }
   });
   if (result === null || typeof result !== "object" || typeof result["type"] !== "string") {
@@ -1537,31 +1546,73 @@ async function runSceneAnalysis(params) {
 }
 
 // src/passes/code.ts
+var MAX_CONTEXT_CHARS = 2e5;
+var LONG_VIDEO_THRESHOLD_SECONDS = 3600;
+function compileContext(duration, pass1Results, pass2Results) {
+  const isLongVideo = duration > LONG_VIDEO_THRESHOLD_SECONDS;
+  const segmentIndicesToInclude = isLongVideo ? new Set(
+    pass2Results.map((r, i) => r != null && r.code_blocks.length > 0 ? i : -1).filter((i) => i !== -1)
+  ) : null;
+  const transcriptLines = ["TRANSCRIPT (all segments):"];
+  for (let i = 0; i < pass1Results.length; i++) {
+    const p1 = pass1Results[i] ?? null;
+    const p2 = pass2Results[i] ?? null;
+    if (isLongVideo && segmentIndicesToInclude !== null && !segmentIndicesToInclude.has(i)) {
+      continue;
+    }
+    let header;
+    if (p1 != null && p1.time_range) {
+      header = `=== Segment ${i + 1} (${p1.time_range}) ===`;
+    } else if (p2 != null && p2.time_range) {
+      header = `=== Segment ${i + 1} (${p2.time_range}) ===`;
+    } else {
+      header = `=== Segment ${i + 1} ===`;
+    }
+    transcriptLines.push(header);
+    if (p1 != null) {
+      for (const entry of p1.transcript_entries) {
+        transcriptLines.push(`[${entry.timestamp}] ${entry.speaker}: ${entry.text}`);
+      }
+    } else {
+      transcriptLines.push("[No transcript available]");
+    }
+  }
+  const codeLines = ["CODE BLOCKS EXTRACTED (all segments):"];
+  for (let i = 0; i < pass2Results.length; i++) {
+    const p2 = pass2Results[i] ?? null;
+    if (p2 == null || p2.code_blocks.length === 0) continue;
+    const p1 = pass1Results[i] ?? null;
+    let header;
+    if (p2.time_range) {
+      header = `=== Segment ${i + 1} (${p2.time_range}) ===`;
+    } else if (p1 != null && p1.time_range) {
+      header = `=== Segment ${i + 1} (${p1.time_range}) ===`;
+    } else {
+      header = `=== Segment ${i + 1} ===`;
+    }
+    codeLines.push(header);
+    for (const block of p2.code_blocks) {
+      codeLines.push(`[${block.timestamp}] ${block.language}:
+${block.content}`);
+    }
+  }
+  let contextText = [transcriptLines.join("\n"), "", codeLines.join("\n")].join("\n");
+  if (isLongVideo && contextText.length > MAX_CONTEXT_CHARS) {
+    const lastNewline = contextText.lastIndexOf("\n", MAX_CONTEXT_CHARS);
+    contextText = contextText.slice(0, lastNewline > 0 ? lastNewline : MAX_CONTEXT_CHARS);
+  }
+  return contextText;
+}
 async function runCodeReconstruction(params) {
-  const { client, fileUri, mimeType, segment, model, resolution, pass1Result, pass2Result } = params;
-  const transcriptText = pass1Result != null ? pass1Result.transcript_entries.map((t) => `[${t.timestamp}] ${t.speaker}: ${t.text}`).join("\n") : "[No transcript available for this segment]";
-  const codeBlocksText = pass2Result != null && pass2Result.code_blocks.length > 0 ? pass2Result.code_blocks.map((b) => `[${b.timestamp}] ${b.filename} (${b.language}):
-${b.content}`).join("\n\n") : "[No code blocks available for this segment]";
-  const contextText = [
-    "TRANSCRIPT FROM THIS SEGMENT:",
-    transcriptText,
-    "",
-    "CODE BLOCKS FROM THIS SEGMENT:",
-    codeBlocksText
-  ].join("\n");
+  const { client, fileUri, mimeType, duration, model, resolution, pass1Results, pass2Results } = params;
+  const contextText = compileContext(duration, pass1Results, pass2Results);
   const contents = [
     {
       role: "user",
       parts: [
+        { fileData: { fileUri, mimeType } },
         {
-          fileData: { fileUri, mimeType },
-          videoMetadata: {
-            startOffset: `${segment.startTime}s`,
-            endOffset: `${segment.endTime}s`
-          }
-        },
-        {
-          text: `Process segment #${segment.index + 1}. Analyze from ${formatTime(segment.startTime)} to ${formatTime(segment.endTime)}.
+          text: `Analyze the entire video (${formatTime(duration)} total).
 
 ${contextText}`
         }
@@ -1577,7 +1628,7 @@ ${contextText}`
       responseMimeType: "application/json",
       ...resolution !== void 0 ? { mediaResolution: resolution } : {},
       maxOutputTokens: 65536,
-      temperature: 1
+      temperature: 0
     }
   });
   if (result === null || typeof result !== "object" || !Array.isArray(result["files"]) || !Array.isArray(result["dependencies_mentioned"]) || !Array.isArray(result["build_commands"])) {
@@ -1612,7 +1663,7 @@ ${transcriptText}`;
       responseSchema: SCHEMA_PASS_3B,
       responseMimeType: "application/json",
       maxOutputTokens: 65536,
-      temperature: 1
+      temperature: 0
     }
   });
   if (result === null || typeof result !== "object" || !Array.isArray(result["participants"]) || !Array.isArray(result["relationships"])) {
@@ -1662,7 +1713,7 @@ ${contextText}`
       responseMimeType: "application/json",
       ...resolution !== void 0 ? { mediaResolution: resolution } : {},
       maxOutputTokens: 65536,
-      temperature: 1
+      temperature: 0
     }
   });
   if (result === null || typeof result !== "object" || !Array.isArray(result["messages"]) || !Array.isArray(result["links"])) {
@@ -1711,7 +1762,7 @@ ${contextText}`
       responseMimeType: "application/json",
       ...resolution !== void 0 ? { mediaResolution: resolution } : {},
       maxOutputTokens: 65536,
-      temperature: 1
+      temperature: 0.1
     }
   });
   if (result === null || typeof result !== "object" || !Array.isArray(result["emotional_shifts"]) || !Array.isArray(result["questions_implicit"]) || !Array.isArray(result["decisions_implicit"]) || !Array.isArray(result["tasks_assigned"]) || !Array.isArray(result["emphasis_patterns"])) {
@@ -1721,13 +1772,12 @@ ${contextText}`
 }
 
 // src/passes/synthesis.ts
-function compileContext(params) {
-  const { segmentResults, videoProfile, peopleExtraction, context } = params;
+function compileContext2(params) {
+  const { segmentResults, videoProfile, peopleExtraction, codeReconstruction, context } = params;
   const segmentSections = segmentResults.map((seg, idx) => {
     const segNum = idx + 1;
     const pass1 = seg.pass1;
     const pass2 = seg.pass2;
-    const pass3a = seg.pass3a;
     const pass3c = seg.pass3c;
     const pass3d = seg.pass3d;
     const timeRange = pass1?.time_range ?? pass2?.time_range ?? `segment ${segNum}`;
@@ -1760,14 +1810,6 @@ function compileContext(params) {
       lines.push("[No visual notes]");
     }
     lines.push("");
-    if (pass3a != null) {
-      lines.push("--- Code Reconstruction ---");
-      for (const f of pass3a.files) {
-        lines.push(`File: ${f.filename} (${f.language})`);
-        lines.push(`Final content: ${f.final_content}`);
-      }
-      lines.push("");
-    }
     if (pass3c != null) {
       lines.push("--- Chat Messages ---");
       if (pass3c.messages.length > 0) {
@@ -1799,6 +1841,15 @@ function compileContext(params) {
     "=== VIDEO PROFILE ===",
     `Type: ${videoProfile.type} | Complexity: ${videoProfile.complexity} | Speakers: ${videoProfile.speakers.count}`
   ];
+  const codeLines = [];
+  if (codeReconstruction != null) {
+    codeLines.push("=== CODE RECONSTRUCTION ===");
+    codeLines.push("--- Code Reconstruction ---");
+    for (const f of codeReconstruction.files) {
+      codeLines.push(`File: ${f.filename} (${f.language})`);
+      codeLines.push(`Final content: ${f.final_content}`);
+    }
+  }
   const peopleLines = ["=== PEOPLE ==="];
   if (peopleExtraction != null && peopleExtraction.participants.length > 0) {
     for (const p of peopleExtraction.participants) {
@@ -1809,16 +1860,18 @@ function compileContext(params) {
     peopleLines.push("[No people data]");
   }
   const contextLines = ["=== USER CONTEXT ===", context != null && context.length > 0 ? context : "[No user context provided]"];
-  return [
+  const sections = [
     ...segmentSections,
     profileLines.join("\n"),
+    ...codeLines.length > 0 ? [codeLines.join("\n")] : [],
     peopleLines.join("\n"),
     contextLines.join("\n")
-  ].join("\n\n");
+  ];
+  return sections.join("\n\n");
 }
 async function runSynthesis(params) {
   const { client, model } = params;
-  const compiledContext = compileContext(params);
+  const compiledContext = compileContext2(params);
   const contents = [
     {
       role: "user",
@@ -1833,7 +1886,7 @@ async function runSynthesis(params) {
       responseSchema: SCHEMA_SYNTHESIS,
       responseMimeType: "application/json",
       maxOutputTokens: 65536,
-      temperature: 1
+      temperature: 0.1
     }
   });
   if (result === null || typeof result !== "object" || typeof result["overview"] !== "string" || !Array.isArray(result["files_to_generate"]) || !Array.isArray(result["key_decisions"]) || !Array.isArray(result["key_concepts"]) || !Array.isArray(result["action_items"]) || !Array.isArray(result["questions_raised"]) || !Array.isArray(result["suggestions"]) || !Array.isArray(result["topics"])) {
@@ -1937,6 +1990,258 @@ function createSegmentPlan(durationSeconds, options) {
   return { segments, resolution: resolutionOverride ?? computedResolution };
 }
 
+// src/core/consensus.ts
+import { log as log7 } from "@clack/prompts";
+function tokenize(content) {
+  const tokens = content.match(/[\p{L}\p{N}_]+/gu) ?? [];
+  return new Set(tokens);
+}
+function tokenOverlap(a, b) {
+  const setA = tokenize(a);
+  const setB = tokenize(b);
+  let count = 0;
+  for (const t of setA) {
+    if (setB.has(t)) count++;
+  }
+  return count;
+}
+function selectBestContent(normalizedName, candidates, pass2Results) {
+  const referenceContent = [];
+  for (const p2 of pass2Results) {
+    if (p2 == null) continue;
+    for (const block of p2.code_blocks) {
+      if (normalizeFilename(block.filename) === normalizedName) {
+        referenceContent.push(block.content);
+      }
+    }
+  }
+  const referenceText = referenceContent.join("\n");
+  let bestFile = candidates[0];
+  let bestScore = -1;
+  for (const candidate of candidates) {
+    let score;
+    if (referenceText.length === 0) {
+      score = candidate.final_content.length;
+    } else {
+      score = tokenOverlap(candidate.final_content, referenceText);
+    }
+    if (score > bestScore || score === bestScore && candidate.final_content.length > bestFile.final_content.length) {
+      bestScore = score;
+      bestFile = candidate;
+    }
+  }
+  return bestFile;
+}
+function mergeChanges(allChanges) {
+  const seen = /* @__PURE__ */ new Set();
+  const merged = [];
+  for (const changes of allChanges) {
+    for (const change of changes) {
+      const key = `${change.timestamp}|${change.change_type}`;
+      if (!seen.has(key)) {
+        seen.add(key);
+        merged.push(change);
+      }
+    }
+  }
+  return merged;
+}
+function unionDedup(arrays) {
+  const seen = /* @__PURE__ */ new Set();
+  const result = [];
+  for (const arr of arrays) {
+    for (const item of arr) {
+      if (!seen.has(item)) {
+        seen.add(item);
+        result.push(item);
+      }
+    }
+  }
+  return result;
+}
+async function runCodeConsensus(params) {
+  const { config, runFn, pass2Results, onProgress } = params;
+  const { runs, minAgreement } = config;
+  const successfulRuns = [];
+  for (let i = 0; i < runs; i++) {
+    try {
+      const result = await runFn();
+      successfulRuns.push(result);
+    } catch (e) {
+      const msg = e instanceof Error ? e.message : String(e);
+      log7.warn(`consensus run ${i + 1}/${runs} failed: ${msg}`);
+    }
+    onProgress?.(i + 1, runs);
+  }
+  const runsCompleted = successfulRuns.length;
+  if (runsCompleted === 0) {
+    return {
+      confirmed: [],
+      rejected: [],
+      runsCompleted: 0,
+      runsAttempted: runs,
+      mergedDependencies: [],
+      mergedBuildCommands: []
+    };
+  }
+  if (runs === 1 && runsCompleted === 1) {
+    const only = successfulRuns[0];
+    return {
+      confirmed: only.files,
+      rejected: [],
+      runsCompleted: 1,
+      runsAttempted: 1,
+      mergedDependencies: [...new Set(only.dependencies_mentioned)],
+      mergedBuildCommands: [...new Set(only.build_commands)]
+    };
+  }
+  const voteMap = /* @__PURE__ */ new Map();
+  for (const run of successfulRuns) {
+    if (run.files.length === 0) continue;
+    const seenInRun = /* @__PURE__ */ new Set();
+    for (const file of run.files) {
+      const normalized = normalizeFilename(file.filename);
+      if (seenInRun.has(normalized)) continue;
+      seenInRun.add(normalized);
+      const entry = voteMap.get(normalized);
+      if (entry == null) {
+        voteMap.set(normalized, { count: 1, originals: [file] });
+      } else {
+        entry.count++;
+        entry.originals.push(file);
+      }
+    }
+  }
+  const confirmed = [];
+  const rejected = [];
+  for (const [normalizedName, { count, originals }] of voteMap.entries()) {
+    if (count >= minAgreement) {
+      const bestBase = selectBestContent(normalizedName, originals, pass2Results);
+      const mergedChanges = mergeChanges(originals.map((f) => f.changes));
+      confirmed.push({
+        filename: bestBase.filename,
+        language: bestBase.language,
+        final_content: bestBase.final_content,
+        changes: mergedChanges
+      });
+    } else {
+      rejected.push(originals[0].filename);
+    }
+  }
+  const mergedDependencies = unionDedup(successfulRuns.map((r) => r.dependencies_mentioned));
+  const mergedBuildCommands = unionDedup(successfulRuns.map((r) => r.build_commands));
+  return {
+    confirmed,
+    rejected,
+    runsCompleted,
+    runsAttempted: runs,
+    mergedDependencies,
+    mergedBuildCommands
+  };
+}
+
+// src/core/validator.ts
+var VALID_FILENAME_CHARS = /^[a-zA-Z0-9._\-\/]+$/;
+var PLACEHOLDER_PATTERNS = /* @__PURE__ */ new Set(["// TODO", "// empty file", "# TODO", "/* TODO */"]);
+function basename2(filename) {
+  const normalized = normalizeFilename(filename);
+  const parts = normalized.split("/");
+  return parts[parts.length - 1] ?? normalized;
+}
+function collectPass2Filenames(pass2Results) {
+  const normalized = /* @__PURE__ */ new Set();
+  const basenames = /* @__PURE__ */ new Set();
+  for (const p2 of pass2Results) {
+    if (p2 == null) continue;
+    for (const block of p2.code_blocks) {
+      const norm = normalizeFilename(block.filename);
+      normalized.add(norm);
+      basenames.add(basename2(block.filename));
+    }
+  }
+  return { normalized, basenames };
+}
+function checkGate1(file) {
+  if (!file.filename || file.filename.trim() === "") {
+    return "empty filename";
+  }
+  if (!file.final_content || file.final_content.trim() === "") {
+    return "empty content";
+  }
+  if (!file.language || file.language.trim() === "") {
+    return "empty language";
+  }
+  if (file.changes.length === 0) {
+    return "no changes recorded";
+  }
+  return null;
+}
+function checkGate2(filename) {
+  if (filename.includes("../")) {
+    return "path traversal";
+  }
+  if (filename.startsWith("/")) {
+    return "absolute path";
+  }
+  if (!VALID_FILENAME_CHARS.test(filename)) {
+    return "invalid characters";
+  }
+  return null;
+}
+function checkGate3Ungrounded(filename, pass2Normalized, pass2Basenames) {
+  const norm = normalizeFilename(filename);
+  const base = basename2(filename);
+  if (pass2Normalized.has(norm) || pass2Basenames.has(base)) {
+    return false;
+  }
+  return true;
+}
+function checkGate5(file) {
+  if (PLACEHOLDER_PATTERNS.has(file.final_content.trim())) {
+    return "placeholder content";
+  }
+  if (file.final_content.length <= 20) {
+    return "trivially short content";
+  }
+  return null;
+}
+function validateCodeReconstruction(params) {
+  const { consensusResult, pass2Results } = params;
+  const confirmed = [];
+  const uncertain = [];
+  const rejected = [];
+  const warnings = [];
+  const { normalized: pass2Normalized, basenames: pass2Basenames } = collectPass2Filenames(pass2Results);
+  for (const file of consensusResult.confirmed) {
+    const gate1Failure = checkGate1(file);
+    if (gate1Failure != null) {
+      warnings.push({ gate: 1, filename: file.filename, message: gate1Failure });
+      rejected.push(file);
+      continue;
+    }
+    const gate2Failure = checkGate2(file.filename);
+    if (gate2Failure != null) {
+      warnings.push({ gate: 2, filename: file.filename, message: gate2Failure });
+      rejected.push(file);
+      continue;
+    }
+    const gate5Failure = checkGate5(file);
+    if (gate5Failure != null) {
+      warnings.push({ gate: 5, filename: file.filename, message: gate5Failure });
+      rejected.push(file);
+      continue;
+    }
+    const isUngrounded = checkGate3Ungrounded(file.filename, pass2Normalized, pass2Basenames);
+    if (isUngrounded) {
+      warnings.push({ gate: 3, filename: file.filename, message: "ungrounded" });
+      uncertain.push(file);
+      continue;
+    }
+    confirmed.push(file);
+  }
+  return { confirmed, uncertain, rejected, warnings };
+}
+
 // src/core/pipeline.ts
 var RETRY_DELAYS_MS = [2e3, 4e3, 8e3];
 async function withRetry(fn, label) {
@@ -1988,7 +2293,7 @@ async function runPipeline(config) {
     "pass0"
   );
   if (pass0Attempt.error !== null) {
-    log7.warn(pass0Attempt.error);
+    log8.warn(pass0Attempt.error);
     errors.push(pass0Attempt.error);
     videoProfile = DEFAULT_PROFILE;
   } else {
@@ -1996,8 +2301,8 @@ async function runPipeline(config) {
   }
   strategy = determineStrategy(videoProfile);
   onProgress?.({ phase: "pass0", segment: 0, totalSegments: 1, status: "done" });
-  log7.info(`Video type: ${videoProfile.type}`);
-  log7.info(`Strategy: ${strategy.passes.join(" \u2192 ")}`);
+  log8.info(`Video type: ${videoProfile.type}`);
+  log8.info(`Strategy: ${strategy.passes.join(" \u2192 ")}`);
   const plan = createSegmentPlan(duration, {
     segmentMinutes: strategy.segmentMinutes,
     resolution: strategy.resolution
@@ -2008,7 +2313,6 @@ async function runPipeline(config) {
   const n = segments.length;
   let pass1RanOnce = false;
   let pass2RanOnce = false;
-  let pass3aRanOnce = false;
   let pass3cRanOnce = false;
   let pass3dRanOnce = false;
   let wasInterrupted = false;
@@ -2027,7 +2331,7 @@ async function runPipeline(config) {
       `segment ${i} pass1`
     );
     if (pass1Attempt.error !== null) {
-      log7.warn(pass1Attempt.error);
+      log8.warn(pass1Attempt.error);
       errors.push(pass1Attempt.error);
     } else {
       pass1 = pass1Attempt.result;
@@ -2052,42 +2356,13 @@ async function runPipeline(config) {
       `segment ${i} pass2`
     );
     if (pass2Attempt.error !== null) {
-      log7.warn(pass2Attempt.error);
+      log8.warn(pass2Attempt.error);
       errors.push(pass2Attempt.error);
     } else {
       pass2 = pass2Attempt.result;
       pass2RanOnce = true;
     }
     onProgress?.({ phase: "pass2", segment: i, totalSegments: n, status: "done" });
-    let pass3a;
-    if (strategy.passes.includes("code")) {
-      onProgress?.({ phase: "pass3a", segment: i, totalSegments: n, status: "running" });
-      const pass3aAttempt = await withRetry(
-        () => rateLimiter.execute(
-          () => runCodeReconstruction({
-            client,
-            fileUri,
-            mimeType,
-            segment,
-            model: MODELS[0].id,
-            resolution,
-            pass1Result: pass1 ?? void 0,
-            pass2Result: pass2 ?? void 0
-          }),
-          { onWait }
-        ),
-        `segment ${i} pass3a`
-      );
-      if (pass3aAttempt.error !== null) {
-        log7.warn(pass3aAttempt.error);
-        errors.push(pass3aAttempt.error);
-        pass3a = null;
-      } else {
-        pass3a = pass3aAttempt.result;
-        pass3aRanOnce = true;
-      }
-      onProgress?.({ phase: "pass3a", segment: i, totalSegments: n, status: "done" });
-    }
     let pass3c;
     if (strategy.passes.includes("chat")) {
       onProgress?.({ phase: "pass3c", segment: i, totalSegments: n, status: "running" });
@@ -2098,7 +2373,7 @@ async function runPipeline(config) {
             fileUri,
             mimeType,
             segment,
-            model: MODELS[1].id,
+            model: MODELS.flash,
             resolution,
             pass2Result: pass2 ?? void 0
           }),
@@ -2107,7 +2382,7 @@ async function runPipeline(config) {
         `segment ${i} pass3c`
       );
       if (pass3cAttempt.error !== null) {
-        log7.warn(pass3cAttempt.error);
+        log8.warn(pass3cAttempt.error);
         errors.push(pass3cAttempt.error);
         pass3c = null;
       } else {
@@ -2126,7 +2401,7 @@ async function runPipeline(config) {
             fileUri,
             mimeType,
             segment,
-            model: MODELS[0].id,
+            model: MODELS.flash,
             resolution,
             pass1Result: pass1 ?? void 0,
             pass2Result: pass2 ?? void 0
@@ -2136,7 +2411,7 @@ async function runPipeline(config) {
         `segment ${i} pass3d`
       );
       if (pass3dAttempt.error !== null) {
-        log7.warn(pass3dAttempt.error);
+        log8.warn(pass3dAttempt.error);
         errors.push(pass3dAttempt.error);
         pass3d = null;
       } else {
@@ -2145,14 +2420,14 @@ async function runPipeline(config) {
       }
       onProgress?.({ phase: "pass3d", segment: i, totalSegments: n, status: "done" });
     }
-    results.push({ index: segment.index, pass1, pass2, pass3a, pass3c, pass3d });
+    results.push({ index: segment.index, pass1, pass2, pass3c, pass3d });
   }
   if (pass1RanOnce) passesRun.push("pass1");
   if (pass2RanOnce) passesRun.push("pass2");
-  if (pass3aRanOnce) passesRun.push("pass3a");
   if (pass3cRanOnce) passesRun.push("pass3c");
   if (pass3dRanOnce) passesRun.push("pass3d");
   if (wasInterrupted) {
+    if (strategy.passes.includes("code")) interruptedPasses.push("pass3a");
     if (strategy.passes.includes("people")) interruptedPasses.push("pass3b");
     if (strategy.passes.includes("synthesis")) interruptedPasses.push("synthesis");
     return {
@@ -2163,20 +2438,23 @@ async function runPipeline(config) {
       strategy,
       synthesisResult: void 0,
       peopleExtraction: null,
+      codeReconstruction: null,
+      uncertainCodeFiles: void 0,
       interrupted: interruptedPasses
     };
   }
+  const pass1Results = results.map((r) => r.pass1);
+  const pass2Results = results.map((r) => r.pass2);
   let peopleExtraction = null;
   if (strategy.passes.includes("people")) {
     onProgress?.({ phase: "pass3b", segment: 0, totalSegments: 1, status: "running" });
-    const pass1Results = results.map((r) => r.pass1);
     const pass3bAttempt = await withRetry(
       () => rateLimiter.execute(
         () => runPeopleExtraction({
           client,
           fileUri,
           mimeType,
-          model: MODELS[0].id,
+          model: MODELS.flash,
           pass1Results
         }),
         { onWait }
@@ -2184,7 +2462,7 @@ async function runPipeline(config) {
       "pass3b"
     );
     if (pass3bAttempt.error !== null) {
-      log7.warn(pass3bAttempt.error);
+      log8.warn(pass3bAttempt.error);
       errors.push(pass3bAttempt.error);
     } else {
       peopleExtraction = pass3bAttempt.result;
@@ -2192,6 +2470,53 @@ async function runPipeline(config) {
     onProgress?.({ phase: "pass3b", segment: 0, totalSegments: 1, status: "done" });
     if (peopleExtraction !== null) passesRun.push("pass3b");
   }
+  let codeReconstruction = null;
+  let uncertainCodeFiles;
+  if (strategy.passes.includes("code")) {
+    const consensusConfig = { runs: 3, minAgreement: 2 };
+    const consensusResult = await runCodeConsensus({
+      config: consensusConfig,
+      runFn: () => rateLimiter.execute(
+        () => runCodeReconstruction({
+          client,
+          fileUri,
+          mimeType,
+          duration,
+          model: MODELS.pro,
+          resolution,
+          pass1Results,
+          pass2Results
+        }),
+        { onWait }
+      ),
+      pass2Results,
+      onProgress: (run, total) => {
+        onProgress?.({ phase: "pass3a", segment: run - 1, totalSegments: total, status: "running" });
+      }
+    });
+    onProgress?.({ phase: "pass3a", segment: consensusConfig.runs - 1, totalSegments: consensusConfig.runs, status: "done" });
+    if (consensusResult.runsCompleted === 0) {
+      const errMsg = "pass3a: all consensus runs failed";
+      log8.warn(errMsg);
+      errors.push(errMsg);
+    } else {
+      const validationResult = validateCodeReconstruction({
+        consensusResult,
+        pass2Results
+      });
+      const allFiles = [...validationResult.confirmed, ...validationResult.uncertain];
+      if (allFiles.length > 0) {
+        codeReconstruction = {
+          files: allFiles,
+          dependencies_mentioned: consensusResult.mergedDependencies,
+          build_commands: consensusResult.mergedBuildCommands
+        };
+        uncertainCodeFiles = validationResult.uncertain.map((f) => f.filename);
+      }
+      log8.info(`Code: ${validationResult.confirmed.length} confirmed, ${validationResult.uncertain.length} uncertain, ${validationResult.rejected.length} rejected`);
+    }
+    if (codeReconstruction !== null) passesRun.push("pass3a");
+  }
   let synthesisResult;
   if (strategy.passes.includes("synthesis")) {
     onProgress?.({ phase: "synthesis", segment: 0, totalSegments: 1, status: "running" });
@@ -2199,10 +2524,11 @@ async function runPipeline(config) {
       () => rateLimiter.execute(
         () => runSynthesis({
           client,
-          model: MODELS[1].id,
+          model: MODELS.pro,
           segmentResults: results,
           videoProfile,
           peopleExtraction,
+          codeReconstruction,
           context: config.context
         }),
         { onWait }
@@ -2210,7 +2536,7 @@ async function runPipeline(config) {
       "synthesis"
     );
     if (synthAttempt.error !== null) {
-      log7.warn(synthAttempt.error);
+      log8.warn(synthAttempt.error);
       errors.push(synthAttempt.error);
     } else {
       synthesisResult = synthAttempt.result ?? void 0;
@@ -2226,6 +2552,8 @@ async function runPipeline(config) {
     strategy,
     synthesisResult,
     peopleExtraction,
+    codeReconstruction,
+    uncertainCodeFiles,
     interrupted: void 0
   };
 }
@@ -2480,13 +2808,13 @@ function renderChangeRow(change) {
 }
 function buildTimeline(allFiles) {
   if (allFiles.length === 0) {
-    return "# Code Timeline\n\n_No code files reconstructed._";
+    return "# Code Timeline\n\nNo code files could be reliably reconstructed.";
   }
   const lines = ["# Code Timeline", ""];
   const annotated = [];
-  for (const { file, segmentIndex } of allFiles) {
+  for (const file of allFiles) {
     for (const change of file.changes) {
-      annotated.push({ timestamp: change.timestamp, file, change, segmentIndex });
+      annotated.push({ timestamp: change.timestamp, file, change });
     }
   }
   annotated.sort((a, b) => parseTimestamp(a.timestamp) - parseTimestamp(b.timestamp));
@@ -2501,7 +2829,7 @@ function buildTimeline(allFiles) {
     lines.push("");
   }
   const seenFiles = /* @__PURE__ */ new Set();
-  for (const { file } of allFiles) {
+  for (const file of allFiles) {
     if (seenFiles.has(file.filename)) continue;
     seenFiles.add(file.filename);
     lines.push(`## ${file.filename}`);
@@ -2521,20 +2849,20 @@ function buildTimeline(allFiles) {
   return lines.join("\n");
 }
 function writeCodeFiles(params) {
-  const { pipelineResult } = params;
-  const { segments } = pipelineResult;
+  const { pipelineResult, uncertainFiles } = params;
+  const { codeReconstruction } = pipelineResult;
   const allFiles = [];
-  const latestByFilename = /* @__PURE__ */ new Map();
-  for (const seg of segments) {
-    if (seg.pass3a == null) continue;
-    for (const file of seg.pass3a.files) {
-      allFiles.push({ file, segmentIndex: seg.index });
-      latestByFilename.set(file.filename, { file, segmentIndex: seg.index });
-    }
-  }
   const files = /* @__PURE__ */ new Map();
-  for (const [filename, { file }] of latestByFilename) {
-    files.set(filename, file.final_content);
+  if (codeReconstruction != null) {
+    for (const file of codeReconstruction.files) {
+      allFiles.push(file);
+      let content = file.final_content;
+      if (uncertainFiles?.has(file.filename)) {
+        content = `// [note: this file passed consensus but could not be cross-referenced against visual observations \u2014 content may be approximate]
+${content}`;
+      }
+      files.set(file.filename, content);
+    }
   }
   const timeline = buildTimeline(allFiles);
   return { files, timeline };
@@ -2981,7 +3309,7 @@ function writeMetadata(params) {
 }
 function writeRawOutput(pipelineResult) {
   const files = /* @__PURE__ */ new Map();
-  const { segments, videoProfile, peopleExtraction, synthesisResult } = pipelineResult;
+  const { segments, videoProfile, peopleExtraction, synthesisResult, codeReconstruction } = pipelineResult;
   if (videoProfile != null) {
     files.set("pass0-scene.json", JSON.stringify(videoProfile, null, 2));
   }
@@ -2993,9 +3321,6 @@ function writeRawOutput(pipelineResult) {
     if (seg.pass2 != null) {
       files.set(`pass2-seg${n}.json`, JSON.stringify(seg.pass2, null, 2));
     }
-    if (seg.pass3a != null) {
-      files.set(`pass3a-seg${n}.json`, JSON.stringify(seg.pass3a, null, 2));
-    }
     if (seg.pass3c != null) {
       files.set(`pass3c-seg${n}.json`, JSON.stringify(seg.pass3c, null, 2));
     }
@@ -3003,6 +3328,9 @@ function writeRawOutput(pipelineResult) {
       files.set(`pass3d-seg${n}.json`, JSON.stringify(seg.pass3d, null, 2));
     }
   }
+  if (codeReconstruction != null) {
+    files.set("pass3a.json", JSON.stringify(codeReconstruction, null, 2));
+  }
   if (peopleExtraction != null) {
     files.set("pass3b-people.json", JSON.stringify(peopleExtraction, null, 2));
   }
@@ -3020,42 +3348,22 @@ function resolveFilesToGenerate(params) {
   const { pipelineResult } = params;
   const { synthesisResult, segments, peopleExtraction } = pipelineResult;
   const optional = /* @__PURE__ */ new Set();
-  if (synthesisResult != null) {
-    const knownOutputFiles = /* @__PURE__ */ new Set([
-      "transcript.md",
-      "combined.md",
-      "notes.md",
-      "people.md",
-      "chat.md",
-      "links.md",
-      "action-items.md",
-      "insights.md",
-      "code/"
-    ]);
-    for (const f of synthesisResult.files_to_generate) {
-      if (knownOutputFiles.has(f)) {
-        optional.add(f);
-      } else {
-        optional.add("code/");
-      }
-    }
-  } else {
-    const hasPass2 = segments.some((s) => s.pass2 != null);
-    const hasPass3a = segments.some((s) => s.pass3a != null);
-    const hasPass3c = segments.some((s) => s.pass3c != null);
-    const hasPass3d = segments.some((s) => s.pass3d != null);
-    if (hasPass2) optional.add("combined.md");
-    if (hasPass3a) optional.add("code/");
-    if (hasPass3c) {
-      optional.add("chat.md");
-      optional.add("links.md");
-    }
-    if (hasPass3d) {
-      optional.add("action-items.md");
-      optional.add("insights.md");
-    }
-    if (peopleExtraction != null) optional.add("people.md");
-  }
+  const hasPass2 = segments.some((s) => s.pass2 != null);
+  const hasPass3a = pipelineResult.codeReconstruction != null;
+  const hasPass3c = segments.some((s) => s.pass3c != null);
+  const hasPass3d = segments.some((s) => s.pass3d != null);
+  if (hasPass2) optional.add("combined.md");
+  if (hasPass3a) optional.add("code/");
+  if (hasPass3c) {
+    optional.add("chat.md");
+    optional.add("links.md");
+  }
+  if (hasPass3d) {
+    optional.add("action-items.md");
+    optional.add("insights.md");
+  }
+  if (synthesisResult != null) optional.add("notes.md");
+  if (peopleExtraction != null) optional.add("people.md");
   return optional;
 }
 async function generateOutput(params) {
@@ -3091,7 +3399,8 @@ async function generateOutput(params) {
   }
   if (filesToGenerate.has("code/")) {
     try {
-      const { files, timeline } = writeCodeFiles({ pipelineResult });
+      const uncertainSet = new Set(pipelineResult.uncertainCodeFiles ?? []);
+      const { files, timeline } = writeCodeFiles({ pipelineResult, uncertainFiles: uncertainSet });
       for (const [filename, content] of files) {
         try {
           await writeOutputFile(`code/${filename}`, content);
@@ -3212,7 +3521,7 @@ async function generateOutput(params) {
 }
 
 // src/core/shutdown.ts
-import { log as log8 } from "@clack/prompts";
+import { log as log9 } from "@clack/prompts";
 function createShutdownHandler(params) {
   const { client, uploadedFileNames } = params;
   let shuttingDown = false;
@@ -3223,7 +3532,7 @@ function createShutdownHandler(params) {
       return;
     }
     shuttingDown = true;
-    log8.warn("Interrupted. Saving partial results...");
+    log9.warn("Interrupted. Saving partial results...");
     const forceExitHandler = () => {
       process.exit(1);
     };
@@ -3323,12 +3632,12 @@ var main = defineCommand({
         if (result.uploadedFileName != null) {
           uploadedFileNames = [result.uploadedFileName];
         }
-        videoTitle = basename2(resolved.value, extname2(resolved.value));
+        videoTitle = basename3(resolved.value, extname2(resolved.value));
       }
       const mins = Math.floor(duration / 60);
       const secs = Math.round(duration % 60);
-      log9.info(`Duration: ${pc5.cyan(`${mins}m ${secs}s`)} (${Math.round(duration)}s)`);
-      const model = MODELS[0].id;
+      log10.info(`Duration: ${pc5.cyan(`${mins}m ${secs}s`)} (${Math.round(duration)}s)`);
+      const model = MODELS.flash;
       const outputDir = resolve(args.output);
       const slug = slugify(videoTitle);
       const finalOutputDir = `${outputDir}/${slug}`;
@@ -3370,18 +3679,19 @@ var main = defineCommand({
         processingTimeMs: elapsedMs
       });
       const fileCount = outputResult.filesGenerated.length;
-      log9.success(
+      log10.success(
         `Output: ${pc5.cyan(finalOutputDir + "/")} \u2014 ${pc5.cyan(String(fileCount))} files generated ${pc5.dim("(guide.md for overview)")}`
       );
       if (outputResult.errors.length > 0) {
-        log9.warn(`Output errors: ${pc5.yellow(String(outputResult.errors.length))}`);
+        log10.warn(`Output errors: ${pc5.yellow(String(outputResult.errors.length))}`);
         for (const err of outputResult.errors) {
-          log9.warn(pc5.dim(`  ${err}`));
+          log10.warn(pc5.dim(`  ${err}`));
         }
       }
     } catch (err) {
-      const message = err instanceof Error ? err.message : String(err);
-      log9.error(pc5.red(message));
+      const raw = err instanceof Error ? err.message : String(err);
+      const message = raw.split("\n")[0].slice(0, 200);
+      log10.error(pc5.red(message));
       process.exit(1);
     }
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vidistill",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "Video intelligence distiller — extract structured notes, transcripts, and insights from any video using Gemini",
   "type": "module",
   "license": "MIT",