vidpipe 1.3.14 → 1.3.15

package/dist/cli.js

@@ -538,6 +538,11 @@ function resolveConfig(cliOptions = {}) {
       process.env.SKIP_VISUAL_ENHANCEMENT,
       false
     ),
+    SKIP_INTRO_OUTRO: resolveBoolean(
+      cliOptions.introOutro === void 0 ? void 0 : !cliOptions.introOutro,
+      process.env.SKIP_INTRO_OUTRO,
+      false
+    ),
     LATE_API_KEY: resolveString(
       cliOptions.lateApiKey,
       process.env.LATE_API_KEY,
@@ -742,15 +747,16 @@ var init_types = __esm({
       { stage: "visual-enhancement" /* VisualEnhancement */, name: "Visual Enhancement", stageNumber: 4 },
       { stage: "captions" /* Captions */, name: "Captions", stageNumber: 5 },
       { stage: "caption-burn" /* CaptionBurn */, name: "Caption Burn", stageNumber: 6 },
-      { stage: "shorts" /* Shorts */, name: "Shorts", stageNumber: 7 },
-      { stage: "medium-clips" /* MediumClips */, name: "Medium Clips", stageNumber: 8 },
-      { stage: "chapters" /* Chapters */, name: "Chapters", stageNumber: 9 },
-      { stage: "summary" /* Summary */, name: "Summary", stageNumber: 10 },
-      { stage: "social-media" /* SocialMedia */, name: "Social Media", stageNumber: 11 },
-      { stage: "short-posts" /* ShortPosts */, name: "Short Posts", stageNumber: 12 },
-      { stage: "medium-clip-posts" /* MediumClipPosts */, name: "Medium Clip Posts", stageNumber: 13 },
-      { stage: "queue-build" /* QueueBuild */, name: "Queue Build", stageNumber: 14 },
-      { stage: "blog" /* Blog */, name: "Blog", stageNumber: 15 }
+      { stage: "intro-outro" /* IntroOutro */, name: "Intro/Outro", stageNumber: 7 },
+      { stage: "shorts" /* Shorts */, name: "Shorts", stageNumber: 8 },
+      { stage: "medium-clips" /* MediumClips */, name: "Medium Clips", stageNumber: 9 },
+      { stage: "chapters" /* Chapters */, name: "Chapters", stageNumber: 10 },
+      { stage: "summary" /* Summary */, name: "Summary", stageNumber: 11 },
+      { stage: "social-media" /* SocialMedia */, name: "Social Media", stageNumber: 12 },
+      { stage: "short-posts" /* ShortPosts */, name: "Short Posts", stageNumber: 13 },
+      { stage: "medium-clip-posts" /* MediumClipPosts */, name: "Medium Clip Posts", stageNumber: 14 },
+      { stage: "queue-build" /* QueueBuild */, name: "Queue Build", stageNumber: 15 },
+      { stage: "blog" /* Blog */, name: "Blog", stageNumber: 16 }
     ];
     TOTAL_STAGES = PIPELINE_STAGES.length;
     PLATFORM_CHAR_LIMITS = {
@@ -4682,7 +4688,7 @@ var init_session = __esm({
 import { spawn } from "child_process";
 import { existsSync as existsSync4 } from "fs";
 import { Socket } from "net";
-import { dirname as dirname3, join as join5 } from "path";
+import { dirname as dirname3, join as join6 } from "path";
 import { fileURLToPath as fileURLToPath3 } from "url";
 function isZodSchema(value) {
   return value != null && typeof value === "object" && "toJSONSchema" in value && typeof value.toJSONSchema === "function";
@@ -4703,7 +4709,7 @@ function getNodeExecPath() {
 function getBundledCliPath() {
   const sdkUrl = import.meta.resolve("@github/copilot/sdk");
   const sdkPath = fileURLToPath3(sdkUrl);
-  return join5(dirname3(dirname3(sdkPath)), "index.js");
+  return join6(dirname3(dirname3(sdkPath)), "index.js");
 }
 var import_node2, MIN_PROTOCOL_VERSION, CopilotClient;
 var init_client = __esm({
@@ -5868,7 +5874,7 @@ var init_dist = __esm({
 
 // src/L1-infra/ai/copilot.ts
 import { existsSync as existsSync5 } from "fs";
-import { join as join6, dirname as dirname4 } from "path";
+import { join as join7, dirname as dirname4 } from "path";
 import { createRequire as createRequire2 } from "module";
 function resolveCopilotCliPath() {
   const platform = process.platform;
@@ -5879,14 +5885,14 @@ function resolveCopilotCliPath() {
     const require_ = createRequire2(import.meta.url);
     const searchPaths = require_.resolve.paths(platformPkg) ?? [];
     for (const base of searchPaths) {
-      const candidate = join6(base, platformPkg, binaryName);
+      const candidate = join7(base, platformPkg, binaryName);
       if (existsSync5(candidate)) return candidate;
     }
   } catch {
   }
   let dir = dirname4(import.meta.dirname ?? __dirname);
   for (let i = 0; i < 10; i++) {
-    const candidate = join6(dir, "node_modules", platformPkg, binaryName);
+    const candidate = join7(dir, "node_modules", platformPkg, binaryName);
     if (existsSync5(candidate)) return candidate;
     const parent = dirname4(dir);
     if (parent === dir) break;
@@ -6795,7 +6801,7 @@ var init_githubClient = __esm({
             const response = await this.octokit.rest.issues.listForRepo({
               owner: this.owner,
               repo: this.repo,
-              state: "open",
+              state: options.state ?? "all",
               labels: options.labels && options.labels.length > 0 ? normalizeLabels(options.labels).join(",") : void 0,
               sort: void 0,
               direction: void 0,
@@ -8708,7 +8714,25 @@ async function rescheduleIdeaPosts(options) {
       fullBookedMap.delete(ms);
     }
   }
-  ideaPosts.sort((a, b) => a.metadata.createdAt.localeCompare(b.metadata.createdAt));
+  const { getIdea: getIdea2 } = await Promise.resolve().then(() => (init_ideaService(), ideaService_exports));
+  const ideaPublishByMap = /* @__PURE__ */ new Map();
+  for (const item of ideaPosts) {
+    const ideaId = item.metadata.ideaIds?.[0];
+    if (ideaId && !ideaPublishByMap.has(ideaId)) {
+      try {
+        const idea = await getIdea2(parseInt(ideaId, 10));
+        if (idea?.publishBy) ideaPublishByMap.set(ideaId, idea.publishBy);
+      } catch {
+      }
+    }
+  }
+  ideaPosts.sort((a, b) => {
+    const aId = a.metadata.ideaIds?.[0];
+    const bId = b.metadata.ideaIds?.[0];
+    const aDate = aId ? ideaPublishByMap.get(aId) ?? "9999" : "9999";
+    const bDate = bId ? ideaPublishByMap.get(bId) ?? "9999" : "9999";
+    return aDate.localeCompare(bDate);
+  });
   const lateClient = new LateApiClient();
   const result = { rescheduled: 0, unchanged: 0, failed: 0, details: [] };
   const nowMs = Date.now();
@@ -8758,7 +8782,18 @@ async function rescheduleIdeaPosts(options) {
         continue;
       }
       if (!dryRun) {
-        await lateClient.schedulePost(latePostId, newSlotDatetime);
+        try {
+          await lateClient.schedulePost(latePostId, newSlotDatetime);
+        } catch (scheduleErr) {
+          const errMsg = scheduleErr instanceof Error ? scheduleErr.message : String(scheduleErr);
+          if (errMsg.includes("Published posts can only have their recycling config updated")) {
+            logger_default.info(`Skipping ${label}: post already published on platform`);
+            result.details.push({ itemId: item.id, platform, latePostId, oldSlot, newSlot: null, error: "Already published \u2014 skipped" });
+            result.unchanged++;
+            continue;
+          }
+          throw scheduleErr;
+        }
         await updatePublishedItemSchedule2(item.id, newSlotDatetime);
       }
       ctx.bookedMap.set(newSlotMs, {
@@ -9323,6 +9358,17 @@ import { default as default3 } from "fluent-ffmpeg";
 // src/L1-infra/process/process.ts
 import { execFile as nodeExecFile, execSync as nodeExecSync, spawnSync as nodeSpawnSync } from "child_process";
 import { createRequire } from "module";
+function execCommand(cmd, args, opts) {
+  return new Promise((resolve3, reject) => {
+    nodeExecFile(cmd, args, { ...opts, encoding: "utf-8" }, (error, stdout, stderr) => {
+      if (error) {
+        reject(Object.assign(error, { stdout: String(stdout ?? ""), stderr: String(stderr ?? "") }));
+      } else {
+        resolve3({ stdout: String(stdout ?? ""), stderr: String(stderr ?? "") });
+      }
+    });
+  });
+}
 function execFileRaw(cmd, args, opts, callback) {
   nodeExecFile(cmd, args, { ...opts, encoding: "utf-8" }, (error, stdout, stderr) => {
     callback(error, String(stdout ?? ""), String(stderr ?? ""));
@@ -10617,6 +10663,376 @@ function transcodeToMp42(...args) {
   return transcodeToMp4(...args);
 }
 
+// src/L2-clients/ffmpeg/videoConcat.ts
+init_fileSystem();
+init_paths();
+init_configLogger();
+async function concatVideos(segments, output, opts = {}) {
+  if (segments.length === 0) {
+    throw new Error("concatVideos: no segments provided");
+  }
+  if (segments.length === 1) {
+    await ensureDirectory(dirname(output));
+    await execCommand(getFFmpegPath(), [
+      "-y",
+      "-i",
+      segments[0],
+      "-c",
+      "copy",
+      output
+    ], { maxBuffer: 50 * 1024 * 1024 });
+    return output;
+  }
+  const fadeDuration = opts.fadeDuration ?? 0;
+  if (fadeDuration > 0) {
+    return concatWithXfade(segments, output, fadeDuration);
+  }
+  return concatWithDemuxer(segments, output);
+}
+async function concatWithDemuxer(segments, output) {
+  await ensureDirectory(dirname(output));
+  const listContent = segments.map((s) => `file '${s.replace(/'/g, "'\\''")}'`).join("\n");
+  const listPath = output + ".concat-list.txt";
+  await writeTextFile(listPath, listContent);
+  logger_default.info(`Concat (demuxer): ${segments.length} segments \u2192 ${output}`);
+  await execCommand(getFFmpegPath(), [
+    "-y",
+    "-f",
+    "concat",
+    "-safe",
+    "0",
+    "-i",
+    listPath,
+    "-c",
+    "copy",
+    "-movflags",
+    "+faststart",
+    output
+  ], { maxBuffer: 50 * 1024 * 1024 });
+  return output;
+}
+async function concatWithXfade(segments, output, fadeDuration) {
+  await ensureDirectory(dirname(output));
+  logger_default.info(`Concat (xfade ${fadeDuration}s): ${segments.length} segments \u2192 ${output}`);
+  const durations = await Promise.all(segments.map((s) => getVideoDuration2(s)));
+  const inputs = segments.flatMap((s) => ["-i", s]);
+  const filterParts = [];
+  for (let i = 0; i < segments.length; i++) {
+    filterParts.push(`[${i}:v]fps=30,settb=AVTB,setpts=PTS-STARTPTS[vin${i}]`);
+    filterParts.push(`[${i}:a]aresample=async=1,asetpts=PTS-STARTPTS[ain${i}]`);
+  }
+  let prevLabel = "[vin0]";
+  let prevAudioLabel = "[ain0]";
+  let cumulativeOffset = 0;
+  for (let i = 1; i < segments.length; i++) {
+    const offset = cumulativeOffset + durations[i - 1] - fadeDuration;
+    const outLabel = i < segments.length - 1 ? `[v${i}]` : "[vout]";
+    const outAudioLabel = i < segments.length - 1 ? `[a${i}]` : "[aout]";
+    filterParts.push(
+      `${prevLabel}[vin${i}]xfade=transition=fade:duration=${fadeDuration}:offset=${offset.toFixed(3)}${outLabel}`
+    );
+    filterParts.push(
+      `${prevAudioLabel}[ain${i}]acrossfade=d=${fadeDuration}${outAudioLabel}`
+    );
+    prevLabel = outLabel;
+    prevAudioLabel = outAudioLabel;
+    cumulativeOffset = offset;
+  }
+  const filterComplex = filterParts.join(";");
+  await execCommand(getFFmpegPath(), [
+    "-y",
+    ...inputs,
+    "-filter_complex",
+    filterComplex,
+    "-map",
+    "[vout]",
+    "-map",
+    "[aout]",
+    "-c:v",
+    "libx264",
+    "-pix_fmt",
+    "yuv420p",
+    "-preset",
+    "ultrafast",
+    "-crf",
+    "23",
+    "-c:a",
+    "aac",
+    "-b:a",
+    "128k",
+    "-movflags",
+    "+faststart",
+    output
+  ], { maxBuffer: 50 * 1024 * 1024 });
+  return output;
+}
+async function normalizeForConcat(videoPath, referenceVideo, output) {
+  await ensureDirectory(dirname(output));
+  const refProps = await getVideoProperties(referenceVideo);
+  logger_default.info(`Normalizing ${videoPath} to match ${referenceVideo} (${refProps.width}x${refProps.height} ${refProps.fps}fps)`);
+  await execCommand(getFFmpegPath(), [
+    "-y",
+    "-i",
+    videoPath,
+    "-vf",
+    `scale=${refProps.width}:${refProps.height}:force_original_aspect_ratio=decrease,pad=${refProps.width}:${refProps.height}:(ow-iw)/2:(oh-ih)/2,fps=${refProps.fps}`,
+    "-c:v",
+    "libx264",
+    "-pix_fmt",
+    "yuv420p",
+    "-preset",
+    "ultrafast",
+    "-crf",
+    "23",
+    "-c:a",
+    "aac",
+    "-b:a",
+    "128k",
+    "-ar",
+    "48000",
+    "-ac",
+    "2",
+    "-movflags",
+    "+faststart",
+    output
+  ], { maxBuffer: 50 * 1024 * 1024 });
+  return output;
+}
+async function getVideoDuration2(videoPath) {
+  const { stdout } = await execCommand(getFFprobePath(), [
+    "-v",
+    "error",
+    "-show_entries",
+    "format=duration",
+    "-of",
+    "csv=p=0",
+    videoPath
+  ], { timeout: 1e4 });
+  const duration = parseFloat(stdout.trim());
+  if (!isFinite(duration) || duration <= 0) {
+    throw new Error(`Failed to get duration for ${videoPath}: ${stdout.trim()}`);
+  }
+  return duration;
+}
+async function getVideoProperties(videoPath) {
+  const { stdout } = await execCommand(getFFprobePath(), [
+    "-v",
+    "error",
+    "-select_streams",
+    "v:0",
+    "-show_entries",
+    "stream=width,height,r_frame_rate",
+    "-of",
+    "json",
+    videoPath
+  ], { timeout: 1e4 });
+  const data = JSON.parse(stdout);
+  const stream = data.streams?.[0];
+  if (!stream) throw new Error(`No video stream found in ${videoPath}`);
+  const fpsRaw = stream.r_frame_rate ?? "30/1";
+  const fpsParts = fpsRaw.split("/");
+  const fps = fpsParts.length === 2 ? Math.round(parseInt(fpsParts[0]) / parseInt(fpsParts[1])) : 30;
+  return {
+    width: stream.width,
+    height: stream.height,
+    fps: isFinite(fps) && fps > 0 ? fps : 30
+  };
+}
+
+// src/L3-services/introOutro/introOutroService.ts
+init_fileSystem();
+init_paths();
+init_environment();
+
+// src/L1-infra/config/brand.ts
+init_fileSystem();
+init_environment();
+init_configLogger();
+var defaultBrand = {
+  name: "Creator",
+  handle: "@creator",
+  tagline: "",
+  voice: {
+    tone: "professional, friendly",
+    personality: "A knowledgeable content creator.",
+    style: "Clear and concise."
+  },
+  advocacy: {
+    primary: [],
+    interests: [],
+    avoids: []
+  },
+  customVocabulary: [],
+  hashtags: {
+    always: [],
+    preferred: [],
+    platforms: {}
+  },
+  contentGuidelines: {
+    shortsFocus: "Highlight key moments and insights.",
+    blogFocus: "Educational and informative content.",
+    socialFocus: "Engaging and authentic posts."
+  }
+};
+var cachedBrand = null;
+function validateBrandConfig(brand) {
+  const requiredStrings = ["name", "handle", "tagline"];
+  for (const field of requiredStrings) {
+    if (!brand[field]) {
+      logger_default.warn(`brand.json: missing or empty field "${field}"`);
+    }
+  }
+  const requiredObjects = [
+    { key: "voice", subKeys: ["tone", "personality", "style"] },
+    { key: "advocacy", subKeys: ["primary", "interests"] },
+    { key: "hashtags", subKeys: ["always", "preferred"] },
+    { key: "contentGuidelines", subKeys: ["shortsFocus", "blogFocus", "socialFocus"] }
+  ];
+  for (const { key, subKeys } of requiredObjects) {
+    if (!brand[key]) {
+      logger_default.warn(`brand.json: missing section "${key}"`);
+    } else {
+      const section = brand[key];
+      for (const sub of subKeys) {
+        if (!section[sub] || Array.isArray(section[sub]) && section[sub].length === 0) {
+          logger_default.warn(`brand.json: missing or empty field "${key}.${sub}"`);
+        }
+      }
+    }
+  }
+  if (!brand.customVocabulary || brand.customVocabulary.length === 0) {
+    logger_default.warn('brand.json: "customVocabulary" is empty \u2014 Whisper prompt will be blank');
+  }
+}
+function getBrandConfig() {
+  if (cachedBrand) return cachedBrand;
+  const config2 = getConfig();
+  const brandPath = config2.BRAND_PATH;
+  if (!fileExistsSync(brandPath)) {
+    logger_default.warn("brand.json not found \u2014 using defaults");
+    cachedBrand = { ...defaultBrand };
+    return cachedBrand;
+  }
+  const raw = readTextFileSync(brandPath);
+  cachedBrand = JSON.parse(raw);
+  validateBrandConfig(cachedBrand);
+  logger_default.info(`Brand config loaded: ${cachedBrand.name}`);
+  return cachedBrand;
+}
+function getWhisperPrompt() {
+  const brand = getBrandConfig();
+  return brand.customVocabulary.join(", ");
+}
+function getIntroOutroConfig() {
+  const brand = getBrandConfig();
+  return brand.introOutro ?? { enabled: false, fadeDuration: 0 };
+}
+
+// src/L3-services/introOutro/introOutroService.ts
+init_configLogger();
+
+// src/L0-pure/introOutro/introOutroResolver.ts
+function resolveIntroOutroToggle(config2, videoType, platform) {
+  const globalDefault = { intro: config2.enabled, outro: config2.enabled };
+  const videoTypeRule = config2.rules?.[videoType];
+  const baseToggle = videoTypeRule ? { intro: videoTypeRule.intro, outro: videoTypeRule.outro } : globalDefault;
+  if (!platform || !config2.platformOverrides?.[platform]?.[videoType]) {
+    return baseToggle;
+  }
+  const platformRule = config2.platformOverrides[platform][videoType];
+  return {
+    intro: platformRule.intro ?? baseToggle.intro,
+    outro: platformRule.outro ?? baseToggle.outro
+  };
+}
+function resolveIntroPath(config2, platform, aspectRatio) {
+  if (!config2.intro) return null;
+  if (aspectRatio && config2.intro.aspectRatios?.[aspectRatio]) {
+    return config2.intro.aspectRatios[aspectRatio];
+  }
+  if (platform && config2.intro.platforms?.[platform]) {
+    return config2.intro.platforms[platform];
+  }
+  return config2.intro.default ?? null;
+}
+function resolveOutroPath(config2, platform, aspectRatio) {
+  if (!config2.outro) return null;
+  if (aspectRatio && config2.outro.aspectRatios?.[aspectRatio]) {
+    return config2.outro.aspectRatios[aspectRatio];
+  }
+  if (platform && config2.outro.platforms?.[platform]) {
+    return config2.outro.platforms[platform];
+  }
+  return config2.outro.default ?? null;
+}
+
+// src/L3-services/introOutro/introOutroService.ts
+async function applyIntroOutro(videoPath, videoType, outputPath, platform, aspectRatio) {
+  const envConfig = getConfig();
+  if (envConfig.SKIP_INTRO_OUTRO) {
+    logger_default.debug("Intro/outro skipped via SKIP_INTRO_OUTRO");
+    return videoPath;
+  }
+  const config2 = getIntroOutroConfig();
+  if (!config2.enabled) {
+    logger_default.debug("Intro/outro disabled in brand config");
+    return videoPath;
+  }
+  const toggle = resolveIntroOutroToggle(config2, videoType, platform);
+  if (!toggle.intro && !toggle.outro) {
+    logger_default.debug(`Intro/outro both disabled for ${videoType}${platform ? ` / ${platform}` : ""}`);
+    return videoPath;
+  }
+  const brandPath = envConfig.BRAND_PATH;
+  const brandDir = dirname(brandPath);
+  const introRelative = toggle.intro ? resolveIntroPath(config2, platform, aspectRatio) : null;
+  const outroRelative = toggle.outro ? resolveOutroPath(config2, platform, aspectRatio) : null;
+  const introPath = introRelative ? resolve(brandDir, introRelative) : null;
+  const outroPath = outroRelative ? resolve(brandDir, outroRelative) : null;
+  const introExists = introPath ? await fileExists(introPath) : false;
+  const outroExists = outroPath ? await fileExists(outroPath) : false;
+  if (introPath && !introExists) {
+    logger_default.warn(`Intro video not found: ${introPath} \u2014 skipping intro`);
+  }
+  if (outroPath && !outroExists) {
+    logger_default.warn(`Outro video not found: ${outroPath} \u2014 skipping outro`);
+  }
+  const validIntro = introPath && introExists ? introPath : null;
+  const validOutro = outroPath && outroExists ? outroPath : null;
+  if (!validIntro && !validOutro) {
+    logger_default.debug("No valid intro/outro files found \u2014 skipping");
+    return videoPath;
+  }
+  const videoDir = dirname(outputPath);
+  const segments = [];
+  const normalizedIntroPath = validIntro ? join(videoDir, ".intro-normalized.mp4") : null;
+  const normalizedOutroPath = validOutro ? join(videoDir, ".outro-normalized.mp4") : null;
+  try {
+    if (validIntro && normalizedIntroPath) {
+      await normalizeForConcat(validIntro, videoPath, normalizedIntroPath);
+      segments.push(normalizedIntroPath);
+    }
+    segments.push(videoPath);
+    if (validOutro && normalizedOutroPath) {
+      await normalizeForConcat(validOutro, videoPath, normalizedOutroPath);
+      segments.push(normalizedOutroPath);
+    }
+    logger_default.info(`Applying intro/outro (${validIntro ? "intro" : ""}${validIntro && validOutro ? "+" : ""}${validOutro ? "outro" : ""}) for ${videoType}${platform ? ` / ${platform}` : ""}: ${outputPath}`);
+    await concatVideos(segments, outputPath, { fadeDuration: config2.fadeDuration });
+    return outputPath;
+  } finally {
+    if (normalizedIntroPath) await removeFile(normalizedIntroPath).catch(() => {
+    });
+    if (normalizedOutroPath) await removeFile(normalizedOutroPath).catch(() => {
+    });
+  }
+}
+
+// src/L4-agents/videoServiceBridge.ts
+function applyIntroOutro2(videoPath, videoType, outputPath, platform, aspectRatio) {
+  return applyIntroOutro(videoPath, videoType, outputPath, platform, aspectRatio);
+}
+
 // src/L0-pure/captions/captionGenerator.ts
 function pad(n, width) {
   return String(n).padStart(width, "0");
@@ -11284,88 +11700,6 @@ init_ai();
 init_fileSystem();
 init_environment();
 init_configLogger();
-
-// src/L1-infra/config/brand.ts
-init_fileSystem();
-init_environment();
-init_configLogger();
-var defaultBrand = {
-  name: "Creator",
-  handle: "@creator",
-  tagline: "",
-  voice: {
-    tone: "professional, friendly",
-    personality: "A knowledgeable content creator.",
-    style: "Clear and concise."
-  },
-  advocacy: {
-    primary: [],
-    interests: [],
-    avoids: []
-  },
-  customVocabulary: [],
-  hashtags: {
-    always: [],
-    preferred: [],
-    platforms: {}
-  },
-  contentGuidelines: {
-    shortsFocus: "Highlight key moments and insights.",
-    blogFocus: "Educational and informative content.",
-    socialFocus: "Engaging and authentic posts."
-  }
-};
-var cachedBrand = null;
-function validateBrandConfig(brand) {
-  const requiredStrings = ["name", "handle", "tagline"];
-  for (const field of requiredStrings) {
-    if (!brand[field]) {
-      logger_default.warn(`brand.json: missing or empty field "${field}"`);
-    }
-  }
-  const requiredObjects = [
-    { key: "voice", subKeys: ["tone", "personality", "style"] },
-    { key: "advocacy", subKeys: ["primary", "interests"] },
-    { key: "hashtags", subKeys: ["always", "preferred"] },
-    { key: "contentGuidelines", subKeys: ["shortsFocus", "blogFocus", "socialFocus"] }
-  ];
-  for (const { key, subKeys } of requiredObjects) {
-    if (!brand[key]) {
-      logger_default.warn(`brand.json: missing section "${key}"`);
-    } else {
-      const section = brand[key];
-      for (const sub of subKeys) {
-        if (!section[sub] || Array.isArray(section[sub]) && section[sub].length === 0) {
-          logger_default.warn(`brand.json: missing or empty field "${key}.${sub}"`);
-        }
-      }
-    }
-  }
-  if (!brand.customVocabulary || brand.customVocabulary.length === 0) {
-    logger_default.warn('brand.json: "customVocabulary" is empty \u2014 Whisper prompt will be blank');
-  }
-}
-function getBrandConfig() {
-  if (cachedBrand) return cachedBrand;
-  const config2 = getConfig();
-  const brandPath = config2.BRAND_PATH;
-  if (!fileExistsSync(brandPath)) {
-    logger_default.warn("brand.json not found \u2014 using defaults");
-    cachedBrand = { ...defaultBrand };
-    return cachedBrand;
-  }
-  const raw = readTextFileSync(brandPath);
-  cachedBrand = JSON.parse(raw);
-  validateBrandConfig(cachedBrand);
-  logger_default.info(`Brand config loaded: ${cachedBrand.name}`);
-  return cachedBrand;
-}
-function getWhisperPrompt() {
-  const brand = getBrandConfig();
-  return brand.customVocabulary.join(", ");
-}
-
-// src/L2-clients/whisper/whisperClient.ts
 var MAX_FILE_SIZE_MB = 25;
 var WARN_FILE_SIZE_MB = 20;
 var MAX_RETRIES = 3;
@@ -12089,6 +12423,10 @@ var ShortVideoAsset = class extends VideoAsset {
   get videoPath() {
     return join(this.videoDir, "media.mp4");
   }
+  /** Path to the short with intro/outro applied */
+  get introOutroVideoPath() {
+    return join(this.videoDir, "media-intro-outro.mp4");
+  }
   /** Directory containing social posts for this short */
   get postsDir() {
     return join(this.videoDir, "posts");
@@ -12155,6 +12493,57 @@ var ShortVideoAsset = class extends VideoAsset {
     await extractCompositeClip2(parentVideo, this.clip.segments, this.videoPath);
     return this.videoPath;
   }
+  /**
+   * Apply intro/outro to the short clip.
+   * Uses brand config rules for 'shorts' video type.
+   *
+   * @returns Path to the intro/outro'd video, or the original path if skipped
+   */
+  async getIntroOutroVideo() {
+    if (await fileExists(this.introOutroVideoPath)) {
+      return this.introOutroVideoPath;
+    }
+    const candidates = [this.clip.captionedPath, this.clip.outputPath];
+    let clipPath;
+    for (const candidate of candidates) {
+      if (candidate && await fileExists(candidate)) {
+        clipPath = candidate;
+        break;
+      }
+    }
+    if (!clipPath) {
+      clipPath = await this.getResult();
+    }
+    return applyIntroOutro2(clipPath, "shorts", this.introOutroVideoPath);
+  }
+  /**
+   * Apply intro/outro to all platform variants of this short.
+   * Resolves the correct intro/outro file per aspect ratio, auto-cropping
+   * from the default file when no ratio-specific file is configured.
+   *
+   * @returns Map of platform to intro/outro'd variant path
+   */
+  async getIntroOutroVariants() {
+    const results = /* @__PURE__ */ new Map();
+    if (!this.clip.variants || this.clip.variants.length === 0) return results;
+    for (const variant of this.clip.variants) {
+      const outputPath = join(this.videoDir, `media-${variant.platform}-intro-outro.mp4`);
+      if (await fileExists(outputPath)) {
+        results.set(variant.platform, outputPath);
+        continue;
+      }
+      if (!await fileExists(variant.path)) continue;
+      const result = await applyIntroOutro2(
+        variant.path,
+        "shorts",
+        outputPath,
+        variant.platform,
+        variant.aspectRatio
+      );
+      results.set(variant.platform, result);
+    }
+    return results;
+  }
   // ── Transcript ───────────────────────────────────────────────────────────────
   /**
    * Get transcript filtered to this short's time range.
@@ -12224,6 +12613,10 @@ var MediumClipAsset = class extends VideoAsset {
   get videoPath() {
     return join(this.videoDir, "media.mp4");
   }
+  /** Path to the clip with intro/outro applied */
+  get introOutroVideoPath() {
+    return join(this.videoDir, "media-intro-outro.mp4");
+  }
   /**
    * Directory containing social media posts for this clip.
    */
@@ -12271,6 +12664,29 @@ var MediumClipAsset = class extends VideoAsset {
     await extractCompositeClip2(parentVideo, this.clip.segments, this.videoPath);
     return this.videoPath;
   }
+  /**
+   * Apply intro/outro to the medium clip.
+   * Uses brand config rules for 'medium-clips' video type.
+   *
+   * @returns Path to the intro/outro'd video, or the original path if skipped
+   */
+  async getIntroOutroVideo() {
+    if (await fileExists(this.introOutroVideoPath)) {
+      return this.introOutroVideoPath;
+    }
+    const candidates = [this.clip.captionedPath, this.clip.outputPath];
+    let clipPath;
+    for (const candidate of candidates) {
+      if (candidate && await fileExists(candidate)) {
+        clipPath = candidate;
+        break;
+      }
+    }
+    if (!clipPath) {
+      clipPath = await this.getResult();
+    }
+    return applyIntroOutro2(clipPath, "medium-clips", this.introOutroVideoPath);
+  }
 };
 
 // src/L5-assets/MainVideoAsset.ts
@@ -12513,7 +12929,7 @@ var SilenceRemovalAgent = class extends BaseAgent {
     return this.removals;
   }
 };
-async function getVideoDuration2(videoPath) {
+async function getVideoDuration3(videoPath) {
   try {
     const metadata = await ffprobe2(videoPath);
     return metadata.format.duration ?? 0;
@@ -12588,7 +13004,7 @@ async function removeDeadSilence(video, transcript, model) {
     logger_default.info("[SilenceRemoval] All removals exceeded 20% cap \u2014 skipping edit");
     return noEdit;
   }
-  const videoDuration = await getVideoDuration2(video.repoPath);
+  const videoDuration = await getVideoDuration3(video.repoPath);
   const sortedRemovals = [...removals].sort((a, b) => a.start - b.start);
   const keepSegments = [];
   let cursor = 0;
@@ -15394,6 +15810,10 @@ var MainVideoAsset = class _MainVideoAsset extends VideoAsset {
   get producedVideoPath() {
     return join(this.videoDir, `${this.slug}-produced.mp4`);
   }
+  /** Path to the video with intro/outro applied: videoDir/{slug}-intro-outro.mp4 */
+  get introOutroVideoPath() {
+    return join(this.videoDir, `${this.slug}-intro-outro.mp4`);
+  }
   /** Path to a produced video for a specific aspect ratio: videoDir/{slug}-produced-{ar}.mp4 */
   producedVideoPathFor(aspectRatio) {
     const arSuffix = aspectRatio.replace(":", "x");
@@ -15671,6 +16091,21 @@ var MainVideoAsset = class _MainVideoAsset extends VideoAsset {
     logger_default.info(`Captions burned into video: ${this.captionedVideoPath}`);
     return this.captionedVideoPath;
   }
+  /**
+   * Get the video with intro/outro applied.
+   * Concatenates intro (if configured) + captioned video + outro (if configured).
+   *
+   * @param opts - Options controlling generation
+   * @returns Path to the intro/outro video, or captioned video if skipped
+   */
+  async getIntroOutroVideo(opts) {
+    if (!opts?.force && await fileExists(this.introOutroVideoPath)) {
+      return this.introOutroVideoPath;
+    }
+    const captionedPath = await this.getCaptionedVideo(opts);
+    const result = await applyIntroOutro2(captionedPath, "main", this.introOutroVideoPath);
+    return result;
+  }
   /**
    * Get the fully produced video.
    * If not already generated, runs the ProducerAgent.
@@ -17841,16 +18276,53 @@ async function processVideo(videoPath, ideas) {
     } else {
       skipStage("caption-burn" /* CaptionBurn */, "SKIP_CAPTIONS");
     }
+    let introOutroVideoPath;
+    if (!cfg.SKIP_INTRO_OUTRO) {
+      introOutroVideoPath = await trackStage("intro-outro" /* IntroOutro */, () => asset.getIntroOutroVideo());
+    } else {
+      skipStage("intro-outro" /* IntroOutro */, "SKIP_INTRO_OUTRO");
+    }
     let shorts = [];
     if (!cfg.SKIP_SHORTS) {
-      const shortAssets = await trackStage("shorts" /* Shorts */, () => asset.getShorts()) ?? [];
+      const shortAssets = await trackStage("shorts" /* Shorts */, async () => {
+        const assets = await asset.getShorts();
+        if (!cfg.SKIP_INTRO_OUTRO) {
+          for (const shortAsset of assets) {
+            const introOutroPath = await shortAsset.getIntroOutroVideo();
+            if (introOutroPath !== shortAsset.clip.outputPath) {
+              shortAsset.clip.outputPath = introOutroPath;
+              shortAsset.clip.captionedPath = introOutroPath;
+            }
+            const variantResults = await shortAsset.getIntroOutroVariants();
+            if (shortAsset.clip.variants) {
+              for (const variant of shortAsset.clip.variants) {
+                const updated = variantResults.get(variant.platform);
+                if (updated) variant.path = updated;
+              }
+            }
+          }
+        }
+        return assets;
+      }) ?? [];
       shorts = shortAssets.map((s) => s.clip);
     } else {
       skipStage("shorts" /* Shorts */, "SKIP_SHORTS");
     }
     let mediumClips = [];
     if (!cfg.SKIP_MEDIUM_CLIPS) {
-      const mediumAssets = await trackStage("medium-clips" /* MediumClips */, () => asset.getMediumClips()) ?? [];
+      const mediumAssets = await trackStage("medium-clips" /* MediumClips */, async () => {
+        const assets = await asset.getMediumClips();
+        if (!cfg.SKIP_INTRO_OUTRO) {
+          for (const clipAsset of assets) {
+            const introOutroPath = await clipAsset.getIntroOutroVideo();
+            if (introOutroPath !== clipAsset.clip.outputPath) {
+              clipAsset.clip.outputPath = introOutroPath;
+              clipAsset.clip.captionedPath = introOutroPath;
+            }
+          }
+        }
+        return assets;
+      }) ?? [];
       mediumClips = mediumAssets.map((m) => m.clip);
     } else {
       skipStage("medium-clips" /* MediumClips */, "SKIP_MEDIUM_CLIPS");
@@ -17887,7 +18359,7 @@ async function processVideo(videoPath, ideas) {
       skipStage("medium-clip-posts" /* MediumClipPosts */, "SKIP_SOCIAL");
     }
     if (!cfg.SKIP_SOCIAL_PUBLISH && socialPosts.length > 0) {
-      await trackStage("queue-build" /* QueueBuild */, () => asset.buildQueue(shorts, mediumClips, socialPosts, captionedVideoPath));
+      await trackStage("queue-build" /* QueueBuild */, () => asset.buildQueue(shorts, mediumClips, socialPosts, introOutroVideoPath ?? captionedVideoPath));
     } else if (cfg.SKIP_SOCIAL_PUBLISH) {
       skipStage("queue-build" /* QueueBuild */, "SKIP_SOCIAL_PUBLISH");
     } else {
@@ -17923,6 +18395,7 @@ async function processVideo(videoPath, ideas) {
       enhancedVideoPath,
       captions: captions ? [captions.srt, captions.vtt, captions.ass] : void 0,
       captionedVideoPath,
+      introOutroVideoPath,
       summary,
       chapters,
       shorts,
@@ -19191,6 +19664,593 @@ async function runConfigure(subcommand, args = []) {
   }
 }
 
+// src/L7-app/commands/introOutro.ts
+init_fileSystem();
+init_environment();
+init_paths();
+init_configLogger();
+var PLATFORMS = ["tiktok", "youtube", "instagram", "linkedin", "x"];
+var VIDEO_TYPES = ["main", "shorts", "medium-clips"];
+var ASPECT_RATIOS = ["16:9", "9:16", "1:1", "4:5"];
+async function loadBrand() {
+  const config2 = getConfig();
+  const brandPath = config2.BRAND_PATH;
+  const brand = await readJsonFile(brandPath, {});
+  return { brand, brandPath };
+}
+async function saveBrand(brandPath, brand) {
+  await writeJsonFile(brandPath, brand);
+  logger_default.info(`brand.json updated: ${brandPath}`);
+}
+function getIntroOutro(brand) {
+  return brand.introOutro ?? {
+    enabled: false,
+    fadeDuration: 0,
+    intro: { default: "", platforms: {} },
+    outro: { default: "", platforms: {} },
+    rules: {
+      main: { intro: true, outro: true },
+      shorts: { intro: false, outro: true },
+      "medium-clips": { intro: true, outro: true }
+    },
+    platformOverrides: {}
+  };
+}
+function showConfig(cfg) {
+  console.log();
+  console.log("\u250C\u2500 Intro/Outro Configuration \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\u2510");
+  console.log(`\u2502  Enabled:        ${cfg.enabled ? "\u2705 Yes" : "\u274C No"}`);
+  console.log(`\u2502  Fade Duration:  ${cfg.fadeDuration}s`);
+  console.log("\u251C\u2500 Files \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\u2524");
+  console.log(`\u2502  Intro default:  ${cfg.intro?.default || "(not set)"}`);
+  if (cfg.intro?.platforms && Object.keys(cfg.intro.platforms).length > 0) {
+    for (const [p, path] of Object.entries(cfg.intro.platforms)) {
+      console.log(`\u2502    ${p.padEnd(12)}   ${path}`);
+    }
+  }
+  if (cfg.intro?.aspectRatios && Object.keys(cfg.intro.aspectRatios).length > 0) {
+    for (const [ratio, path] of Object.entries(cfg.intro.aspectRatios)) {
+      console.log(`\u2502    ${ratio.padEnd(12)}   ${path}`);
+    }
+  }
+  console.log(`\u2502  Outro default:  ${cfg.outro?.default || "(not set)"}`);
+  if (cfg.outro?.platforms && Object.keys(cfg.outro.platforms).length > 0) {
+    for (const [p, path] of Object.entries(cfg.outro.platforms)) {
+      console.log(`\u2502    ${p.padEnd(12)}   ${path}`);
+    }
+  }
+  if (cfg.outro?.aspectRatios && Object.keys(cfg.outro.aspectRatios).length > 0) {
+    for (const [ratio, path] of Object.entries(cfg.outro.aspectRatios)) {
+      console.log(`\u2502    ${ratio.padEnd(12)}   ${path}`);
+    }
+  }
+  console.log("\u251C\u2500 Rules \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\u2524");
+  for (const vt of VIDEO_TYPES) {
+    const rule = cfg.rules?.[vt];
+    if (rule) {
+      console.log(`\u2502  ${vt.padEnd(14)}  intro: ${rule.intro ? "\u2705" : "\u274C"}  outro: ${rule.outro ? "\u2705" : "\u274C"}`);
+    } else {
+      console.log(`\u2502  ${vt.padEnd(14)}  (uses global default)`);
+    }
+  }
+  if (cfg.platformOverrides && Object.keys(cfg.platformOverrides).length > 0) {
+    console.log("\u251C\u2500 Platform Overrides \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\u2524");
+    for (const [platform, videoTypes] of Object.entries(cfg.platformOverrides)) {
+      for (const [vt, toggle] of Object.entries(videoTypes)) {
+        const parts = [];
+        if (toggle.intro !== void 0) parts.push(`intro: ${toggle.intro ? "\u2705" : "\u274C"}`);
+        if (toggle.outro !== void 0) parts.push(`outro: ${toggle.outro ? "\u2705" : "\u274C"}`);
+        console.log(`\u2502  ${platform}/${vt}: ${parts.join("  ")}`);
+      }
+    }
+  }
+  console.log("\u2514\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\u2518");
+  console.log();
+}
+async function runWizard(brand, brandPath) {
+  const rl2 = createPromptInterface();
+  const cfg = getIntroOutro(brand);
+  const brandDir = dirname(brandPath);
+  try {
+    console.log();
+    console.log("\u{1F3AC} Intro/Outro Setup Wizard");
+    console.log("\u2500".repeat(50));
+    const enableAnswer = await rl2.question(`Enable intro/outro? (${cfg.enabled ? "Y/n" : "y/N"}): `);
+    if (enableAnswer.trim()) {
+      cfg.enabled = enableAnswer.trim().toLowerCase().startsWith("y");
+    }
+    const introDefault = cfg.intro?.default || "./assets/intro.mp4";
+    const introAnswer = await rl2.question(`Intro video path [${introDefault}]: `);
+    const introPath = introAnswer.trim() || introDefault;
+    cfg.intro = { ...cfg.intro, default: introPath };
+    const resolvedIntro = resolve(brandDir, introPath);
+    if (!await fileExists(resolvedIntro)) {
+      console.log(`  \u26A0\uFE0F  File not found: ${resolvedIntro}`);
+      console.log(`     (You can add it later \u2014 the path is saved)`);
+    } else {
+      console.log(`  \u2705 Found: ${resolvedIntro}`);
+    }
+    const outroDefault = cfg.outro?.default || "./assets/outro.mp4";
+    const outroAnswer = await rl2.question(`Outro video path [${outroDefault}]: `);
+    const outroPath = outroAnswer.trim() || outroDefault;
+    cfg.outro = { ...cfg.outro, default: outroPath };
+    const resolvedOutro = resolve(brandDir, outroPath);
+    if (!await fileExists(resolvedOutro)) {
+      console.log(`  \u26A0\uFE0F  File not found: ${resolvedOutro}`);
+      console.log(`     (You can add it later \u2014 the path is saved)`);
+    } else {
+      console.log(`  \u2705 Found: ${resolvedOutro}`);
+    }
+    const fadeDefault = cfg.fadeDuration ?? 0.5;
+    const fadeAnswer = await rl2.question(`Crossfade duration in seconds [${fadeDefault}]: `);
+    cfg.fadeDuration = fadeAnswer.trim() ? parseFloat(fadeAnswer.trim()) : fadeDefault;
+    if (!isFinite(cfg.fadeDuration) || cfg.fadeDuration < 0) {
+      console.log("  \u26A0\uFE0F  Invalid fade duration, using 0.5s");
+      cfg.fadeDuration = 0.5;
+    }
+    console.log();
+    console.log("Configure which video types get intro/outro:");
+    for (const vt of VIDEO_TYPES) {
+      const current = cfg.rules?.[vt] ?? { intro: true, outro: true };
+      const introAns = await rl2.question(`  ${vt} \u2014 include intro? (${current.intro ? "Y/n" : "y/N"}): `);
+      const outroAns = await rl2.question(`  ${vt} \u2014 include outro? (${current.outro ? "Y/n" : "y/N"}): `);
+      const introVal = introAns.trim() ? introAns.trim().toLowerCase().startsWith("y") : current.intro;
+      const outroVal = outroAns.trim() ? outroAns.trim().toLowerCase().startsWith("y") : current.outro;
+      if (!cfg.rules) cfg.rules = {};
+      cfg.rules[vt] = { intro: introVal, outro: outroVal };
+    }
+    const platformAnswer = await rl2.question("\nSet platform-specific intro/outro files? (y/N): ");
+    if (platformAnswer.trim().toLowerCase().startsWith("y")) {
+      for (const platform of PLATFORMS) {
+        const pIntro = await rl2.question(`  ${platform} intro path (empty = use default): `);
+        if (pIntro.trim()) {
+          if (!cfg.intro.platforms) cfg.intro.platforms = {};
+          cfg.intro.platforms[platform] = pIntro.trim();
+        }
+        const pOutro = await rl2.question(`  ${platform} outro path (empty = use default): `);
+        if (pOutro.trim()) {
+          if (!cfg.outro.platforms) cfg.outro.platforms = {};
+          cfg.outro.platforms[platform] = pOutro.trim();
+        }
+      }
+    }
+    const ratioAnswer = await rl2.question("\nSet aspect-ratio-specific intro/outro files? (y/N): ");
+    if (ratioAnswer.trim().toLowerCase().startsWith("y")) {
+      const nonDefaultRatios = ASPECT_RATIOS.filter((r) => r !== "16:9");
+      for (const ratio of nonDefaultRatios) {
+        const rIntro = await rl2.question(`  ${ratio} intro path (empty = use default): `);
+        if (rIntro.trim()) {
+          if (!cfg.intro.aspectRatios) cfg.intro.aspectRatios = {};
+          cfg.intro.aspectRatios[ratio] = rIntro.trim();
+        }
+        const rOutro = await rl2.question(`  ${ratio} outro path (empty = use default): `);
+        if (rOutro.trim()) {
+          if (!cfg.outro.aspectRatios) cfg.outro.aspectRatios = {};
+          cfg.outro.aspectRatios[ratio] = rOutro.trim();
+        }
+      }
+    }
+    brand.introOutro = cfg;
+    await saveBrand(brandPath, brand);
+    console.log();
+    console.log("\u2705 Intro/outro configuration saved!");
+    showConfig(cfg);
+  } finally {
+    rl2.close();
+  }
+}
+async function handleEnable(brand, brandPath) {
+  const cfg = getIntroOutro(brand);
+  cfg.enabled = true;
+  brand.introOutro = cfg;
+  await saveBrand(brandPath, brand);
+  console.log("\u2705 Intro/outro enabled");
+}
+async function handleDisable(brand, brandPath) {
+  const cfg = getIntroOutro(brand);
+  cfg.enabled = false;
+  brand.introOutro = cfg;
+  await saveBrand(brandPath, brand);
+  console.log("\u274C Intro/outro disabled");
+}
+async function handleSetIntro(brand, brandPath, args) {
+  if (args.length < 1) {
+    console.error("Usage: vidpipe intro-outro set-intro <path> [--platform <name>]");
+    process.exitCode = 1;
+    return;
+  }
+  const cfg = getIntroOutro(brand);
+  const platformIdx = args.indexOf("--platform");
+  if (platformIdx >= 0 && args[platformIdx + 1]) {
+    const platform = args[platformIdx + 1];
+    const filePath = args.filter((_, i) => i !== platformIdx && i !== platformIdx + 1)[0];
+    if (!cfg.intro) cfg.intro = { platforms: {} };
+    if (!cfg.intro.platforms) cfg.intro.platforms = {};
+    cfg.intro.platforms[platform] = filePath;
+    console.log(`\u2705 Intro for ${platform}: ${filePath}`);
+  } else {
+    if (!cfg.intro) cfg.intro = {};
+    cfg.intro.default = args[0];
+    console.log(`\u2705 Default intro: ${args[0]}`);
+  }
+  brand.introOutro = cfg;
+  await saveBrand(brandPath, brand);
+}
+async function handleSetOutro(brand, brandPath, args) {
+  if (args.length < 1) {
+    console.error("Usage: vidpipe intro-outro set-outro <path> [--platform <name>]");
+    process.exitCode = 1;
+    return;
+  }
+  const cfg = getIntroOutro(brand);
+  const platformIdx = args.indexOf("--platform");
+  if (platformIdx >= 0 && args[platformIdx + 1]) {
+    const platform = args[platformIdx + 1];
+    const filePath = args.filter((_, i) => i !== platformIdx && i !== platformIdx + 1)[0];
+    if (!cfg.outro) cfg.outro = { platforms: {} };
+    if (!cfg.outro.platforms) cfg.outro.platforms = {};
+    cfg.outro.platforms[platform] = filePath;
+    console.log(`\u2705 Outro for ${platform}: ${filePath}`);
+  } else {
+    if (!cfg.outro) cfg.outro = {};
+    cfg.outro.default = args[0];
+    console.log(`\u2705 Default outro: ${args[0]}`);
+  }
+  brand.introOutro = cfg;
+  await saveBrand(brandPath, brand);
+}
+async function handleSetIntroRatio(brand, brandPath, args) {
+  if (args.length < 2) {
+    console.error("Usage: vidpipe intro-outro set-intro-ratio <ratio> <path>");
+    console.error(`  ratio: ${ASPECT_RATIOS.join(", ")}`);
+    process.exitCode = 1;
+    return;
+  }
+  const ratio = args[0];
+  if (!ASPECT_RATIOS.includes(ratio)) {
+    console.error(`Unknown aspect ratio: ${ratio}. Must be one of: ${ASPECT_RATIOS.join(", ")}`);
+    process.exitCode = 1;
+    return;
+  }
+  const cfg = getIntroOutro(brand);
+  if (!cfg.intro) cfg.intro = {};
+  if (!cfg.intro.aspectRatios) cfg.intro.aspectRatios = {};
+  cfg.intro.aspectRatios[ratio] = args[1];
+  brand.introOutro = cfg;
+  await saveBrand(brandPath, brand);
+  console.log(`\u2705 Intro for ${ratio}: ${args[1]}`);
+}
+async function handleSetOutroRatio(brand, brandPath, args) {
+  if (args.length < 2) {
+    console.error("Usage: vidpipe intro-outro set-outro-ratio <ratio> <path>");
+    console.error(`  ratio: ${ASPECT_RATIOS.join(", ")}`);
+    process.exitCode = 1;
+    return;
+  }
+  const ratio = args[0];
+  if (!ASPECT_RATIOS.includes(ratio)) {
+    console.error(`Unknown aspect ratio: ${ratio}. Must be one of: ${ASPECT_RATIOS.join(", ")}`);
+    process.exitCode = 1;
+    return;
+  }
+  const cfg = getIntroOutro(brand);
+  if (!cfg.outro) cfg.outro = {};
+  if (!cfg.outro.aspectRatios) cfg.outro.aspectRatios = {};
+  cfg.outro.aspectRatios[ratio] = args[1];
+  brand.introOutro = cfg;
+  await saveBrand(brandPath, brand);
+  console.log(`\u2705 Outro for ${ratio}: ${args[1]}`);
+}
+async function handleSetFade(brand, brandPath, args) {
+  if (args.length < 1) {
+    console.error("Usage: vidpipe intro-outro set-fade <seconds>");
+    process.exitCode = 1;
+    return;
+  }
+  const duration = parseFloat(args[0]);
+  if (!isFinite(duration) || duration < 0) {
+    console.error("Fade duration must be a non-negative number");
+    process.exitCode = 1;
+    return;
+  }
+  const cfg = getIntroOutro(brand);
+  cfg.fadeDuration = duration;
+  brand.introOutro = cfg;
+  await saveBrand(brandPath, brand);
+  console.log(`\u2705 Fade duration: ${duration}s${duration === 0 ? " (hard cut)" : ""}`);
+}
+async function handleSetRule(brand, brandPath, args) {
+  if (args.length < 3) {
+    console.error("Usage: vidpipe intro-outro set-rule <video-type> <intro|outro|both> <on|off>");
+    console.error("  video-type: main, shorts, medium-clips");
+    console.error("  Example: vidpipe intro-outro set-rule shorts intro off");
+    process.exitCode = 1;
+    return;
+  }
+  const videoType = args[0];
+  if (!VIDEO_TYPES.includes(videoType)) {
+    console.error(`Unknown video type: ${args[0]}. Must be one of: ${VIDEO_TYPES.join(", ")}`);
+    process.exitCode = 1;
+    return;
+  }
+  const target = args[1];
+  const rawValue = args[2].toLowerCase();
+  if (!["on", "off", "true", "false"].includes(rawValue)) {
+    console.error(`Invalid value: ${args[2]}. Must be one of: on, off, true, false`);
+    process.exitCode = 1;
+    return;
+  }
+  const value = rawValue === "on" || rawValue === "true";
+  const cfg = getIntroOutro(brand);
+  if (!cfg.rules) cfg.rules = {};
+  const current = cfg.rules[videoType] ?? { intro: true, outro: true };
+  if (target === "intro") current.intro = value;
+  else if (target === "outro") current.outro = value;
+  else if (target === "both") {
+    current.intro = value;
+    current.outro = value;
+  } else {
+    console.error(`Unknown target: ${target}. Must be intro, outro, or both`);
+    process.exitCode = 1;
+    return;
+  }
+  cfg.rules[videoType] = current;
+  brand.introOutro = cfg;
+  await saveBrand(brandPath, brand);
+  console.log(`\u2705 ${videoType}: intro=${current.intro ? "on" : "off"}, outro=${current.outro ? "on" : "off"}`);
+}
+function printHelp() {
+  console.log(`
+Usage: vidpipe intro-outro [subcommand] [args...]
+
+Manage video intro and outro configuration in brand.json.
+
+Subcommands:
+  (none)           Interactive setup wizard
+  show             Display current intro/outro configuration
+  enable           Enable intro/outro processing
+  disable          Disable intro/outro processing
+  set-intro <path> [--platform <name>]   Set intro video file path
+  set-outro <path> [--platform <name>]   Set outro video file path
+  set-intro-ratio <ratio> <path>         Set aspect-ratio-specific intro file
+  set-outro-ratio <ratio> <path>         Set aspect-ratio-specific outro file
+  set-fade <seconds>                     Set crossfade duration (0 = hard cut)
+  set-rule <type> <intro|outro|both> <on|off>  Configure per-video-type rules
+    types: main, shorts, medium-clips
+    ratios: ${ASPECT_RATIOS.join(", ")}
+
+Examples:
+  vidpipe intro-outro                          # Interactive wizard
+  vidpipe intro-outro show                     # Show current config
+  vidpipe intro-outro enable                   # Turn on intro/outro
+  vidpipe intro-outro set-intro ./assets/intro-yt.mp4 --platform youtube
+  vidpipe intro-outro set-intro-ratio 9:16 ./assets/intro-portrait.mp4
+  vidpipe intro-outro set-outro-ratio 1:1 ./assets/outro-square.mp4
+  vidpipe intro-outro set-fade 1.0             # 1-second crossfade
+  vidpipe intro-outro set-rule shorts intro off
+`);
+}
+async function runIntroOutro(subcommand, args = []) {
+  const { brand, brandPath } = await loadBrand();
+  switch (subcommand) {
+    case void 0:
+      await runWizard(brand, brandPath);
+      break;
+    case "show":
+      showConfig(getIntroOutro(brand));
+      break;
+    case "enable":
+      await handleEnable(brand, brandPath);
+      break;
+    case "disable":
+      await handleDisable(brand, brandPath);
+      break;
+    case "set-intro":
+      await handleSetIntro(brand, brandPath, args);
+      break;
+    case "set-outro":
+      await handleSetOutro(brand, brandPath, args);
+      break;
+    case "set-intro-ratio":
+      await handleSetIntroRatio(brand, brandPath, args);
+      break;
+    case "set-outro-ratio":
+      await handleSetOutroRatio(brand, brandPath, args);
+      break;
+    case "set-fade":
+      await handleSetFade(brand, brandPath, args);
+      break;
+    case "set-rule":
+      await handleSetRule(brand, brandPath, args);
+      break;
+    case "help":
+    case "--help":
+      printHelp();
+      break;
+    default:
+      console.error(`Unknown subcommand: ${subcommand}`);
+      printHelp();
+      process.exitCode = 1;
+  }
+}
+
+// src/L7-app/commands/ideaUpdate.ts
+init_environment();
+init_ideaService();
+init_types();
+var VALID_PLATFORMS2 = new Set(Object.values(Platform));
+var VALID_STATUSES = /* @__PURE__ */ new Set(["draft", "ready", "recorded", "published"]);
+var VALID_URGENCIES = /* @__PURE__ */ new Map([
+  ["hot", 3],
+  // 3 days from now
+  ["urgent", 7],
+  // 7 days (= hot-trend)
+  ["soon", 14],
+  // 14 days (= timely)
+  ["flexible", 60]
+  // 60 days (= evergreen)
+]);
+function parsePlatforms2(raw) {
+  if (!raw) return void 0;
+  return raw.split(",").map((p) => p.trim().toLowerCase()).filter((p) => VALID_PLATFORMS2.has(p));
+}
+function parseCommaSeparated2(raw) {
+  if (!raw) return void 0;
+  return raw.split(",").map((s) => s.trim()).filter(Boolean);
+}
+function resolveUrgency(urgency) {
+  const days = VALID_URGENCIES.get(urgency.toLowerCase());
+  if (days === void 0) {
+    throw new Error(`Invalid urgency: ${urgency}. Must be one of: ${[...VALID_URGENCIES.keys()].join(", ")}`);
+  }
+  const date = /* @__PURE__ */ new Date();
+  date.setDate(date.getDate() + days);
+  return date.toISOString().split("T")[0];
+}
+async function runIdeaUpdate(issueNumber, options) {
+  initConfig();
+  const num = parseInt(issueNumber, 10);
+  if (!isFinite(num) || num <= 0) {
+    console.error(`Invalid issue number: ${issueNumber}`);
+    process.exitCode = 1;
+    return;
+  }
+  if (options.status && !VALID_STATUSES.has(options.status)) {
+    console.error(`Invalid status: ${options.status}. Must be one of: ${[...VALID_STATUSES].join(", ")}`);
+    process.exitCode = 1;
+    return;
+  }
+  let publishBy = options.publishBy;
+  if (options.urgency) {
+    try {
+      publishBy = resolveUrgency(options.urgency);
+    } catch (err) {
+      console.error(err.message);
+      process.exitCode = 1;
+      return;
+    }
+  }
+  const updates = {};
+  if (options.topic !== void 0) updates.topic = options.topic;
+  if (options.hook !== void 0) updates.hook = options.hook;
+  if (options.audience !== void 0) updates.audience = options.audience;
+  if (options.keyTakeaway !== void 0) updates.keyTakeaway = options.keyTakeaway;
+  if (options.trendContext !== void 0) updates.trendContext = options.trendContext;
+  if (options.status !== void 0) updates.status = options.status;
+  const platforms = parsePlatforms2(options.platforms);
+  if (platforms) updates.platforms = platforms;
+  const talkingPoints = parseCommaSeparated2(options.talkingPoints);
+  if (talkingPoints) updates.talkingPoints = talkingPoints;
+  const tags = parseCommaSeparated2(options.tags);
+  if (tags) updates.tags = tags;
+  if (publishBy) updates.publishBy = publishBy;
+  if (Object.keys(updates).length === 0) {
+    console.error("No updates specified. Use --topic, --status, --urgency, etc.");
+    process.exitCode = 1;
+    return;
+  }
+  try {
+    const idea = await updateIdea(num, updates);
+    console.log(`\u2705 Idea #${idea.issueNumber} updated: ${idea.topic}`);
+    console.log(`   Status: ${idea.status}`);
+    console.log(`   Publish by: ${idea.publishBy}`);
+    console.log(`   URL: ${idea.issueUrl}`);
+  } catch (err) {
+    console.error(`Failed to update idea #${num}: ${err.message}`);
+    process.exitCode = 1;
+  }
+}
+async function runIdeaGet(issueNumber) {
+  initConfig();
+  const num = parseInt(issueNumber, 10);
+  if (!isFinite(num) || num <= 0) {
+    console.error(`Invalid issue number: ${issueNumber}`);
+    process.exitCode = 1;
+    return;
+  }
+  try {
+    const idea = await getIdea(num);
+    if (!idea) {
+      console.error(`Idea #${num} not found`);
+      process.exitCode = 1;
+      return;
+    }
+    console.log(`
+\u{1F4CB} Idea #${idea.issueNumber}: ${idea.topic}`);
+    console.log(`   Status:       ${idea.status}`);
+    console.log(`   Hook:         ${idea.hook}`);
+    console.log(`   Audience:     ${idea.audience}`);
+    console.log(`   Key Takeaway: ${idea.keyTakeaway}`);
+    console.log(`   Platforms:    ${idea.platforms.join(", ")}`);
+    console.log(`   Tags:         ${idea.tags.join(", ") || "(none)"}`);
+    console.log(`   Publish by:   ${idea.publishBy}`);
+    if (idea.trendContext) console.log(`   Trend:        ${idea.trendContext}`);
+    if (idea.talkingPoints.length > 0) {
+      console.log(`   Talking Points:`);
+      for (const pt of idea.talkingPoints) {
+        console.log(`     \u2022 ${pt}`);
+      }
+    }
+    console.log(`   URL:          ${idea.issueUrl}`);
+    console.log();
+  } catch (err) {
+    console.error(`Failed to get idea #${num}: ${err.message}`);
+    process.exitCode = 1;
+  }
+}
+function printIdeaTable(ideas) {
+  console.log(`
+${"#".padEnd(6)} ${"Topic".padEnd(40)} ${"Status".padEnd(12)} ${"Publish By".padEnd(12)} ${"Platforms"}`);
+  console.log("\u2500".repeat(100));
+  for (const idea of ideas) {
+    console.log(
+      `${String(idea.issueNumber).padEnd(6)} ${idea.topic.substring(0, 38).padEnd(40)} ${idea.status.padEnd(12)} ${idea.publishBy.padEnd(12)} ${idea.platforms.join(", ")}`
+    );
+  }
+  console.log(`
+${ideas.length} idea(s) found`);
+}
+async function runIdeaSearch(query, options) {
+  initConfig();
+  try {
+    let ideas;
+    if (query) {
+      ideas = await searchIdeas(query);
+    } else {
+      ideas = await listIdeas({
+        status: options.status,
+        platform: options.platform,
+        tag: options.tag,
+        priority: options.priority
+      });
+    }
+    if (query && options.status) {
+      ideas = ideas.filter((i) => i.status === options.status);
+    }
+    if (ideas.length === 0) {
+      console.log("No ideas found.");
+      return;
+    }
+    if (options.format === "json") {
+      console.log(JSON.stringify(ideas.map((i) => ({
+        issueNumber: i.issueNumber,
+        topic: i.topic,
+        hook: i.hook,
+        status: i.status,
+        platforms: i.platforms,
+        publishBy: i.publishBy,
+        tags: i.tags,
+        issueUrl: i.issueUrl
+      })), null, 2));
+      return;
+    }
+    printIdeaTable(ideas);
+  } catch (err) {
+    console.error(`Failed to search ideas: ${err.message}`);
+    process.exitCode = 1;
+  }
+}
+
 // src/L1-infra/http/http.ts
 import { default as default8 } from "express";
 import { Router } from "express";
@@ -19840,11 +20900,36 @@ program.command("ideate").description("Generate AI-powered content ideas using t
   await runIdeate(opts);
   process.exit(0);
 });
+program.command("idea").description("Manage ideas \u2014 view, update, and search existing ideas").argument("<subcommand>", "Subcommand: get, update, search").argument("[arg]", "Issue number (get/update) or search query (search)").option("--topic <topic>", "Update the idea topic/title").option("--hook <hook>", "Update the attention-grabbing hook").option("--audience <audience>", "Update the target audience").option("--platforms <platforms>", "Target platforms (comma-separated)").option("--key-takeaway <takeaway>", "Update the core message").option("--talking-points <points>", "Update talking points (comma-separated)").option("--tags <tags>", "Filter/update tags (comma-separated)").option("--status <status>", "Filter/update status (draft|ready|recorded|published)").option("--publish-by <date>", "Update publish deadline (ISO 8601 date)").option("--urgency <level>", "Set urgency: hot (3d), urgent (7d), soon (14d), flexible (60d)").option("--trend-context <context>", "Update trend context").option("--priority <level>", "Filter by priority: hot-trend, timely, evergreen").option("--platform <platform>", "Filter by platform").option("--tag <tag>", "Filter by tag").option("--format <format>", "Output format: table (default) or json").action(async (subcommand, arg, opts) => {
+  initConfig();
+  if (subcommand === "update") {
+    if (!arg) {
+      console.error("Usage: vidpipe idea update <issue-number> [options]");
+      process.exitCode = 1;
+    } else await runIdeaUpdate(arg, opts);
+  } else if (subcommand === "get") {
+    if (!arg) {
+      console.error("Usage: vidpipe idea get <issue-number>");
+      process.exitCode = 1;
+    } else await runIdeaGet(arg);
+  } else if (subcommand === "search") {
+    await runIdeaSearch(arg, opts);
+  } else {
+    console.error(`Unknown subcommand: ${subcommand}. Use 'get', 'update', or 'search'`);
+    process.exitCode = 1;
+  }
+  process.exit(process.exitCode ?? 0);
+});
 program.command("configure [subcommand]").description("Manage global configuration \u2014 API keys, defaults, and preferences").argument("[args...]", "Arguments for the subcommand (e.g., key and value for set)").action(async (subcommand, args) => {
   await runConfigure(subcommand, args);
   process.exit(process.exitCode ?? 0);
 });
-var defaultCmd = program.command("process", { isDefault: true }).argument("[video-path]", "Path to a video file to process (implies --once)").option("--watch-dir <path>", "Folder to watch for new recordings (default: env WATCH_FOLDER)").option("--output-dir <path>", "Output directory for processed videos (default: ./recordings)").option("--openai-key <key>", "OpenAI API key (default: env OPENAI_API_KEY)").option("--exa-key <key>", "Exa AI API key for web search (default: env EXA_API_KEY)").option("--youtube-key <key>", "YouTube API key (default: env YOUTUBE_API_KEY)").option("--perplexity-key <key>", "Perplexity API key (default: env PERPLEXITY_API_KEY)").option("--once", "Process a single video and exit (no watching)").option("--brand <path>", "Path to brand.json config (default: ./brand.json)").option("--no-silence-removal", "Skip silence removal stage").option("--no-shorts", "Skip shorts generation").option("--no-medium-clips", "Skip medium clip generation").option("--no-social", "Skip social media post generation").option("--no-captions", "Skip caption generation/burning").option("--no-visual-enhancement", "Skip visual enhancement (AI image overlays)").option("--no-social-publish", "Skip social media publishing/queue-build stage").option("--late-api-key <key>", "Late API key (default: env LATE_API_KEY)").option("--late-profile-id <id>", "Late profile ID (default: env LATE_PROFILE_ID)").option("--ideas <ids>", "Comma-separated idea IDs to link to this video").option("-v, --verbose", "Verbose logging").option("--progress", "Emit structured JSON progress events to stderr").option("--doctor", "Check all prerequisites and exit").action(async (videoPath) => {
+program.command("intro-outro [subcommand]").description("Manage video intro and outro assets \u2014 paths, rules, and platform overrides").argument("[args...]", "Arguments for the subcommand").action(async (subcommand, args) => {
+  initConfig();
+  await runIntroOutro(subcommand, args);
+  process.exit(process.exitCode ?? 0);
+});
+var defaultCmd = program.command("process", { isDefault: true }).argument("[video-path]", "Path to a video file to process (implies --once)").option("--watch-dir <path>", "Folder to watch for new recordings (default: env WATCH_FOLDER)").option("--output-dir <path>", "Output directory for processed videos (default: ./recordings)").option("--openai-key <key>", "OpenAI API key (default: env OPENAI_API_KEY)").option("--exa-key <key>", "Exa AI API key for web search (default: env EXA_API_KEY)").option("--youtube-key <key>", "YouTube API key (default: env YOUTUBE_API_KEY)").option("--perplexity-key <key>", "Perplexity API key (default: env PERPLEXITY_API_KEY)").option("--once", "Process a single video and exit (no watching)").option("--brand <path>", "Path to brand.json config (default: ./brand.json)").option("--no-silence-removal", "Skip silence removal stage").option("--no-shorts", "Skip shorts generation").option("--no-medium-clips", "Skip medium clip generation").option("--no-social", "Skip social media post generation").option("--no-captions", "Skip caption generation/burning").option("--no-visual-enhancement", "Skip visual enhancement (AI image overlays)").option("--no-intro-outro", "Skip intro/outro concatenation").option("--no-social-publish", "Skip social media publishing/queue-build stage").option("--late-api-key <key>", "Late API key (default: env LATE_API_KEY)").option("--late-profile-id <id>", "Late profile ID (default: env LATE_PROFILE_ID)").option("--ideas <ids>", "Comma-separated idea IDs to link to this video").option("-v, --verbose", "Verbose logging").option("--progress", "Emit structured JSON progress events to stderr").option("--doctor", "Check all prerequisites and exit").action(async (videoPath) => {
   const opts = defaultCmd.opts();
   if (opts.doctor) {
     await runDoctor();
@@ -19866,6 +20951,7 @@ var defaultCmd = program.command("process", { isDefault: true }).argument("[vide
     social: opts.social,
     captions: opts.captions,
     visualEnhancement: opts.visualEnhancement,
+    introOutro: opts.introOutro,
     socialPublish: opts.socialPublish,
     lateApiKey: opts.lateApiKey,
     lateProfileId: opts.lateProfileId