@gobing-ai/knowledge-kit 0.0.28 → 0.0.30

package/.claude-plugin/marketplace.json

@@ -6,7 +6,7 @@
     },
     "plugins": [
         {
-            "version": "0.0.28",
+            "version": "0.0.30",
             "name": "kk",
             "source": "./plugins/kk",
             "description": "knowledge-kit — a set of toolkit for knowledge management"

package/dist/index.js

@@ -26530,6 +26530,11 @@ function killSubtree(pid) {
   } catch {}
 }
 async function killProcessTree(pid) {
+  if (process.platform !== "win32") {
+    try {
+      process.kill(-pid, "SIGKILL");
+    } catch {}
+  }
   const sweep = () => {
     for (const child of listChildren(pid)) {
       killSubtree(child);
@@ -26549,7 +26554,8 @@ async function spawnPluginEntryAsync(opts) {
     cwd: opts.cwd,
     env: pluginEntryEnv(opts),
     stdout: "pipe",
-    stderr: "pipe"
+    stderr: "pipe",
+    detached: process.platform !== "win32"
   });
   if (opts.timeoutMs !== undefined) {
     timer = setTimeout(() => {
@@ -27021,41 +27027,70 @@ function aggregate(entries) {
   }
   return { ok: summary.failed === 0, summary, targets: entries };
 }
-async function fanout(content, targets, dispatch) {
-  const entries = [];
-  for (const target of targets) {
-    const started = Date.now();
-    let entry;
-    try {
-      const result = await dispatch(target);
-      const durationMs = Date.now() - started;
-      entry = result.ok ? {
-        target,
-        ok: true,
-        status: "published",
-        ...result.url !== undefined ? { url: result.url } : {},
-        ...result.id !== undefined ? { id: result.id } : {},
-        ...result.metadata !== undefined ? { metadata: result.metadata } : {},
-        durationMs
-      } : {
-        target,
-        ok: false,
-        status: "failed",
-        error: result.error ?? result.message ?? "publish failed",
-        durationMs
-      };
-    } catch (err) {
-      entry = {
-        target,
-        ok: false,
-        status: "failed",
-        error: err instanceof Error ? err.message : String(err),
-        durationMs: Date.now() - started
-      };
-    }
-    entries.push(entry);
+async function dispatchOne(target, dispatch, timeoutMs) {
+  const started = Date.now();
+  try {
+    const result = timeoutMs === undefined ? await dispatch(target) : await withTimeout(dispatch(target), timeoutMs, target);
+    const durationMs = Date.now() - started;
+    return result.ok ? {
+      target,
+      ok: true,
+      status: "published",
+      ...result.url !== undefined ? { url: result.url } : {},
+      ...result.id !== undefined ? { id: result.id } : {},
+      ...result.metadata !== undefined ? { metadata: result.metadata } : {},
+      durationMs
+    } : {
+      target,
+      ok: false,
+      status: "failed",
+      error: result.error ?? result.message ?? "publish failed",
+      durationMs
+    };
+  } catch (err) {
+    return {
+      target,
+      ok: false,
+      status: "failed",
+      error: err instanceof Error ? err.message : String(err),
+      durationMs: Date.now() - started
+    };
   }
-  return aggregate(entries);
+}
+function withTimeout(promise2, timeoutMs, target) {
+  let timer;
+  const budget = new Promise((_resolve, reject) => {
+    timer = setTimeout(() => reject(new Error(`target '${target}' exceeded its ${timeoutMs}ms budget`)), timeoutMs);
+  });
+  return Promise.race([promise2, budget]).finally(() => clearTimeout(timer));
+}
+async function fanout(content, targets, dispatch, options = {}) {
+  const outcomes = new Map;
+  const runOne = async (target) => {
+    outcomes.set(target, await dispatchOne(target, dispatch, options.timeoutMs));
+  };
+  if (options.mode === "serial") {
+    for (const target of targets)
+      await runOne(target);
+  } else {
+    const serial = new Set(options.serialTargets ?? []);
+    const parallel = targets.filter((target) => !serial.has(target));
+    const solo = targets.filter((target) => serial.has(target));
+    const jobs = options.jobs !== undefined && options.jobs > 0 ? options.jobs : parallel.length;
+    let cursor2 = 0;
+    const worker = async () => {
+      while (cursor2 < parallel.length) {
+        const target = parallel[cursor2++];
+        if (target === undefined)
+          return;
+        await runOne(target);
+      }
+    };
+    await Promise.all(Array.from({ length: Math.max(1, Math.min(jobs, parallel.length)) }, worker));
+    for (const target of solo)
+      await runOne(target);
+  }
+  return aggregate(targets.map((target) => outcomes.get(target)).filter((entry) => entry !== undefined));
 }
 async function readContent(fs2, path3) {
   if (!await fs2.exists(path3)) {
@@ -27139,10 +27174,14 @@ async function readAggregateResult(fs2, path3) {
 function parseArgs2(argv) {
   const targets = [];
   const pluginsPath = [];
+  const serialTargets = [];
   let contentPath;
   let outPath;
   let retryFromPath;
   let pluginsRoot;
+  let serial = false;
+  let jobs;
+  let targetTimeoutMs;
   for (let i = 0;i < argv.length; i++) {
     const arg = argv[i];
     if (arg === "--content") {
@@ -27193,6 +27232,34 @@ function parseArgs2(argv) {
         throw new Error("--plugins-path requires a directory path");
       }
       pluginsPath.push(value);
+    } else if (arg === "--serial") {
+      serial = true;
+    } else if (arg === "--jobs") {
+      const value = argv[++i];
+      if (value === undefined) {
+        throw new Error("--jobs requires a positive integer");
+      }
+      const parsed = Number(value);
+      if (!Number.isInteger(parsed) || parsed < 1) {
+        throw new Error(`--jobs requires a positive integer, got '${value}'`);
+      }
+      jobs = parsed;
+    } else if (arg === "--serial-target") {
+      const value = argv[++i];
+      if (value === undefined) {
+        throw new Error("--serial-target requires a plugin name");
+      }
+      serialTargets.push(value);
+    } else if (arg === "--target-timeout") {
+      const value = argv[++i];
+      if (value === undefined) {
+        throw new Error("--target-timeout requires milliseconds");
+      }
+      const parsed = Number(value);
+      if (!Number.isInteger(parsed) || parsed < 1) {
+        throw new Error(`--target-timeout requires a positive integer in milliseconds, got '${value}'`);
+      }
+      targetTimeoutMs = parsed;
     } else {
       throw new Error(`Unknown argument: ${arg}`);
     }
@@ -27212,7 +27279,11 @@ function parseArgs2(argv) {
     outPath,
     ...retryFromPath !== undefined ? { retryFromPath } : {},
     ...pluginsRoot !== undefined ? { pluginsRoot } : {},
-    ...pluginsPath.length > 0 ? { pluginsPath } : {}
+    ...pluginsPath.length > 0 ? { pluginsPath } : {},
+    ...serial ? { serial } : {},
+    ...jobs !== undefined ? { jobs } : {},
+    ...serialTargets.length > 0 ? { serialTargets } : {},
+    ...targetTimeoutMs !== undefined ? { targetTimeoutMs } : {}
   };
 }
 async function pluginDispatch(target, contentPath, discovery) {
@@ -27315,7 +27386,12 @@ async function runFanout(argv, deps = {}) {
   if (deps.dispatch === undefined && !validateTargets(targets, discovery)) {
     return EXIT_INPUT2;
   }
-  const fresh = await fanout(content, targets, dispatch);
+  const fresh = await fanout(content, targets, dispatch, {
+    ...opts.serial === true ? { mode: "serial" } : {},
+    ...opts.jobs !== undefined ? { jobs: opts.jobs } : {},
+    ...opts.serialTargets !== undefined ? { serialTargets: opts.serialTargets } : {},
+    ...opts.targetTimeoutMs !== undefined ? { timeoutMs: opts.targetTimeoutMs } : {}
+  });
   const result = prior !== undefined ? aggregate([...skipped, ...retainedFailed, ...fresh.targets]) : fresh;
   try {
     await fs2.writeFile(resolve4(opts.outPath), `${JSON.stringify(result, null, 2)}
@@ -27399,7 +27475,7 @@ function withFaninOptions(cmd) {
   return cmd.option("--in <path>", "Input Doc[] JSON file (repeatable)", collectRepeatable, []).option("--source <plugin>:<file>", "Ingestion source to spawn concurrently: plugin name and its input file (repeatable)", collectRepeatable, []).option("--source-timeout <ms>", "Per-source timeout in milliseconds (default 1800000)").option("--source-timeout-override <plugin>:<ms>", "Per-source timeout override for one named --source plugin, e.g. horizon-ingest:2700000 (repeatable; wins over --source-timeout/default)", collectRepeatable, []).requiredOption("--out <path>", "Output merged Doc[] JSON file path").option("--plugins-root <dir>", "Exclusive root containing plugins (isolation/tests only)").option("--plugins-path <dir>", "Extra plugin root to union with defaults (repeatable)", collectRepeatable, []);
 }
 function withFanoutOptions(cmd) {
-  return cmd.requiredOption("--content <path>", "Source ContentSchema JSON file path").option("--target <plugin>", "Target publish plugin name (repeatable)", collectRepeatable, []).requiredOption("--out <path>", "Aggregate Result JSON file path").option("--retry-from <path>", "Prior Result JSON file to retry only previously failed targets").option("--plugins-root <dir>", "Exclusive root containing plugins (isolation/tests only)").option("--plugins-path <dir>", "Extra plugin root to union with defaults (repeatable)", collectRepeatable, []);
+  return cmd.requiredOption("--content <path>", "Source ContentSchema JSON file path").option("--target <plugin>", "Target publish plugin name (repeatable)", collectRepeatable, []).requiredOption("--out <path>", "Aggregate Result JSON file path").option("--retry-from <path>", "Prior Result JSON file to retry only previously failed targets").option("--serial", "Dispatch the parallel batch one target at a time (pre-2026-10-03 behaviour)").option("--jobs <n>", "Concurrent-start bound for the parallel batch (default: every target at once)").option("--serial-target <plugin>", "Target kept out of the parallel batch and run alone afterwards, e.g. a headed browser channel or a shared checkout (repeatable)", collectRepeatable, []).option("--target-timeout <ms>", "Per-target wall-clock budget; an overrun is recorded failed and siblings continue").option("--plugins-root <dir>", "Exclusive root containing plugins (isolation/tests only)").option("--plugins-path <dir>", "Extra plugin root to union with defaults (repeatable)", collectRepeatable, []);
 }
 function registerExecutorCommand(program2) {
   const executor = program2.command("executor").description("Run knowledge-kit plugin steps (invoke, fan-in, fan-out)");

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gobing-ai/knowledge-kit",
-    "version": "0.0.28",
+    "version": "0.0.30",
     "description": "An ingest → create → publish content pipeline CLI (Bun).",
     "repository": {
         "type": "git",

package/plugins/generations/daily-article-gen/dist/index.js

@@ -22035,13 +22035,17 @@ ${metaLine ? `${metaLine}
 
 ` : ""}${stripScaffold(doc2.body ?? "").trim()}`;
 }
+function episodeTitle(date6) {
+  return `AI \u4E71\u7096 \xB7 ${date6}`;
+}
 function renderDailyArticle(docs, date6) {
   const items = docs.map(renderDoc).join(`
 
 `);
-  return `# \u6BCF\u65E5 AI \u8D44\u8BAF \u2014 ${date6}
+  const intro = docs.length > 0 ? `\u300CAI \u4E71\u7096\u300D\u662F\u300C\u54B8\u8BDD\u54B8\u8BF4\u300D\u7684 AI \u6280\u672F\u5206\u4EAB\u680F\u76EE\uFF1A\u5DE5\u5177\u3001\u8BBA\u6587\u4E0E\u5B9E\u8DF5\u968F\u804A\u3002\u672C\u671F\u5171 ${docs.length} \u6761\u5185\u5BB9\uFF0C\u5747\u9644\u53EF\u70B9\u51FB\u6765\u6E90\u94FE\u63A5\u3002` : "\u300CAI \u4E71\u7096\u300D\u662F\u300C\u54B8\u8BDD\u54B8\u8BF4\u300D\u7684 AI \u6280\u672F\u5206\u4EAB\u680F\u76EE\uFF1A\u5DE5\u5177\u3001\u8BBA\u6587\u4E0E\u5B9E\u8DF5\u968F\u804A\u3002\u672C\u671F\u6CA1\u6709\u8DB3\u591F\u624E\u5B9E\u7684\u53EF\u804A\u5185\u5BB9\u3002";
+  return `# ${episodeTitle(date6)}
 
-\u672C\u671F\u5171 ${docs.length} \u6761\u65B0\u95FB\uFF0C\u5747\u9644\u53EF\u70B9\u51FB\u6765\u6E90\u94FE\u63A5\u3002
+${intro}
 
 ${items}
 `;
@@ -22054,10 +22058,42 @@ function tagsFor(docs) {
   });
   return [AI_NEWS_TAG, ...existing.filter((t) => t !== AI_NEWS_TAG)];
 }
+var LEADING_H1_RE = /^#(?!#)\s*[^\n]+\n+/.source;
+var NOTE_EXCLUDED_RE = /\u672A\u5199\u5165[\uFF1A:](.*)/g;
+var HEX_ID_RE = /(?:[a-zA-Z0-9_-]+:)?[0-9a-f]{16}/g;
+function excludedIdsFromNote(body) {
+  const ids = new Set;
+  if (!body)
+    return ids;
+  for (const note of body.matchAll(NOTE_EXCLUDED_RE)) {
+    for (const id of (note[1] ?? "").matchAll(HEX_ID_RE)) {
+      ids.add(id[0]);
+      const colon = id[0].indexOf(":");
+      if (colon !== -1)
+        ids.add(id[0].slice(colon + 1));
+    }
+  }
+  return ids;
+}
 function docsToContent(docs, date6, bodyOverride) {
+  const title = episodeTitle(date6);
+  let body = renderDailyArticle(docs, date6);
+  if (bodyOverride) {
+    const stripped = stripScaffold(bodyOverride.trim()).trim().replace(new RegExp(LEADING_H1_RE), "");
+    body = `# ${title}
+
+${stripped}
+`;
+  }
+  body = `${body.trimEnd()}
+
+---
+
+*\u6587\u5B57\u7531 AI \u8F85\u52A9\u6574\u7406\uFF0C\u97F3\u9891\u4E3A AI \u5408\u6210\u914D\u97F3\u3002*
+`;
   return ContentSchema.parse({
-    title: `\u6BCF\u65E5 AI \u8D44\u8BAF \u2014 ${date6}`,
-    body: bodyOverride ? stripScaffold(bodyOverride).trim() : renderDailyArticle(docs, date6),
+    title,
+    body,
     format: "markdown",
     references: docs.filter((d) => d.sourceUri).map((d) => ({ url: d.sourceUri, title: d.title, cite: d.id })),
     metadata: { generator: "kk:daily-article", date: date6, doc_count: docs.length, tags: tagsFor(docs) }
@@ -22074,7 +22110,9 @@ async function processGeneratorIO(inputPath, outputPath) {
     if (bodyOverride.trim() === "")
       bodyOverride = undefined;
   }
-  const content = docsToContent(docs, date6, bodyOverride);
+  const excluded = excludedIdsFromNote(bodyOverride);
+  const kept = excluded.size === 0 ? docs : docs.filter((d) => !excluded.has(d.id) && !(d.id.includes(":") && excluded.has(d.id.slice(d.id.indexOf(":") + 1))));
+  const content = docsToContent(kept, date6, bodyOverride);
   const fs = createNodeFileSystem();
   const outDir = dirname2(outputPath);
   if (outDir && outDir !== ".")
@@ -22110,5 +22148,7 @@ export {
   renderDailyArticle,
   processGeneratorIO,
   main2 as main,
+  excludedIdsFromNote,
+  episodeTitle,
   docsToContent
 };

package/plugins/generations/daily-article-gen/src/index.ts

@@ -102,10 +102,25 @@ function renderDoc(doc: Doc, index: number): string {
     return `## ${index + 1}. ${heading}\n\n${metaLine ? `${metaLine}\n\n` : ''}${stripScaffold(doc.body ?? '').trim()}`;
 }
 
+/**
+ * Episode title for the 「AI 乱炖」 column: fixed `AI 乱炖 · YYYY-MM-DD` (2026-10-02 operator
+ * simplification, superseding the 0189 R1/R4 `AI 乱炖｜<lead item> · date` pattern). The date
+ * alone identifies the episode; the day's stories live in the show notes, cards and post body.
+ * Pure function so the agent-written and template article paths, ID3, RSS and show notes all
+ * derive one identical title.
+ */
+export function episodeTitle(date: string): string {
+    return `AI 乱炖 · ${date}`;
+}
+
 /** Render the article markdown for a merged Doc[] (pure — exported for tests). */
 export function renderDailyArticle(docs: Doc[], date: string): string {
     const items = docs.map(renderDoc).join('\n\n');
-    return `# 每日 AI 资讯 — ${date}\n\n本期共 ${docs.length} 条新闻，均附可点击来源链接。\n\n${items}\n`;
+    const intro =
+        docs.length > 0
+            ? `「AI 乱炖」是「咸话咸说」的 AI 技术分享栏目：工具、论文与实践随聊。本期共 ${docs.length} 条内容，均附可点击来源链接。`
+            : '「AI 乱炖」是「咸话咸说」的 AI 技术分享栏目：工具、论文与实践随聊。本期没有足够扎实的可聊内容。';
+    return `# ${episodeTitle(date)}\n\n${intro}\n\n${items}\n`;
 }
 
 /** Single-source daily tag: stamped on every Content this generator emits (task 0119). */
@@ -120,11 +135,43 @@ function tagsFor(docs: Doc[]): string[] {
     return [AI_NEWS_TAG, ...existing.filter((t) => t !== AI_NEWS_TAG)];
 }
 
+/** A leading H1 line — agent bodies used to carry their own title; the canonical title is computed (task 0189 R4). */
+const LEADING_H1_RE = /^#(?!#)\s*[^\n]+\n+/.source;
+
+/** ids the article-write note marks as dropped on the topic boundary, e.g. 「…未写入：<id>（原因）、<id>（原因）」. */
+const NOTE_EXCLUDED_RE = /未写入[：:](.*)/g;
+const HEX_ID_RE = /(?:[a-zA-Z0-9_-]+:)?[0-9a-f]{16}/g;
+
+/** Parse the boundary-note ids out of an article body so references/metadata never cite excluded docs (judge finding 2026-10-02). */
+export function excludedIdsFromNote(body: string | undefined): Set<string> {
+    const ids = new Set<string>();
+    if (!body) return ids;
+    for (const note of body.matchAll(NOTE_EXCLUDED_RE)) {
+        for (const id of (note[1] ?? '').matchAll(HEX_ID_RE)) {
+            ids.add(id[0]);
+            const colon = id[0].indexOf(':');
+            if (colon !== -1) ids.add(id[0].slice(colon + 1));
+        }
+    }
+    return ids;
+}
+
 /** Build the article Content from a merged Doc[]; `bodyOverride` replaces the mechanical render (agent-written prose), still scaffold-stripped as a safety net. */
 export function docsToContent(docs: Doc[], date: string, bodyOverride?: string): Content {
+    const title = episodeTitle(date);
+    let body = renderDailyArticle(docs, date);
+    if (bodyOverride) {
+        // The canonical episode title is computed from the lead item; a leading H1 the agent may
+        // still have written is replaced (not duplicated) so body and metadata agree on every path.
+        const stripped = stripScaffold(bodyOverride.trim()).trim().replace(new RegExp(LEADING_H1_RE), '');
+        body = `# ${title}\n\n${stripped}\n`;
+    }
+    // Task 0189 R1: the AI-production note rides on every article path (mechanical and agent
+    // prose). Podcast show notes are rendered separately by podcast-pub and do not inherit it.
+    body = `${body.trimEnd()}\n\n---\n\n*文字由 AI 辅助整理，音频为 AI 合成配音。*\n`;
     return ContentSchema.parse({
-        title: `每日 AI 资讯 — ${date}`,
-        body: bodyOverride ? stripScaffold(bodyOverride).trim() : renderDailyArticle(docs, date),
+        title,
+        body,
         format: 'markdown',
         references: docs.filter((d) => d.sourceUri).map((d) => ({ url: d.sourceUri, title: d.title, cite: d.id })),
         metadata: { generator: 'kk:daily-article', date, doc_count: docs.length, tags: tagsFor(docs) },
@@ -143,7 +190,15 @@ export async function processGeneratorIO(inputPath: string, outputPath: string):
         bodyOverride = await Bun.file(bodyFile).text();
         if (bodyOverride.trim() === '') bodyOverride = undefined;
     }
-    const content = docsToContent(docs, date, bodyOverride);
+    const excluded = excludedIdsFromNote(bodyOverride);
+    const kept =
+        excluded.size === 0
+            ? docs
+            : docs.filter(
+                  (d) =>
+                      !excluded.has(d.id) && !(d.id.includes(':') && excluded.has(d.id.slice(d.id.indexOf(':') + 1))),
+              );
+    const content = docsToContent(kept, date, bodyOverride);
     const fs = createNodeFileSystem();
     const outDir = dirname(outputPath);
     if (outDir && outDir !== '.') await fs.ensureDir(outDir);

package/plugins/generations/dailynews-gen/dist/index.js

@@ -22116,10 +22116,10 @@ function buildNewsVoiceScript(docs, options) {
   const broadcastDate = options?.date ?? new Date;
   const dateStr = formatBroadcastDate(broadcastDate, language);
   if (docs.length === 0) {
-    const title2 = options?.title || (isZh ? "\u4ECA\u65E5AI\u79D1\u6280\u6F2B\u8C08\uFF08\u6682\u65E0\u66F4\u65B0\uFF09" : "AI Daily Briefing (No Updates)");
+    const title2 = options?.title || (isZh ? "AI \u4E71\u7096\uFF08\u6682\u65E0\u66F4\u65B0\uFF09" : "AI \u4E71\u7096 (No Updates)");
     const segments2 = isZh ? [
       {
-        text: `\u5927\u5BB6\u597D\uFF0C\u4ECA\u5929\u662F${dateStr}\u3002\u6B22\u8FCE\u6536\u542C\u7531${voiceProfile}\u4E3A\u60A8\u5E26\u6765\u7684\u4ECA\u65E5AI\u79D1\u6280\u6F2B\u8C08\u3002\u4ECA\u5929\u79D1\u6280\u5708\u6682\u65E0\u6700\u65B0\u7684\u7CBE\u9009\u52A8\u6001\u3002`,
+        text: `\u5927\u5BB6\u597D\uFF0C\u4ECA\u5929\u662F${dateStr}\u3002\u6B22\u8FCE\u6536\u542C\u300C\u54B8\u8BDD\u54B8\u8BF4\u300D\u7684\u300CAI \u4E71\u7096\u300D\u680F\u76EE\uFF0C\u6211\u662F${voiceProfile}\u3002\u4ECA\u5929\u6CA1\u6709\u8DB3\u591F\u624E\u5B9E\u7684\u53EF\u804A\u5185\u5BB9\u3002`,
         gap_ms: 400,
         emotion: "calm"
       },
@@ -22130,7 +22130,7 @@ function buildNewsVoiceScript(docs, options) {
       }
     ] : [
       {
-        text: `Hello and welcome. Today is ${dateStr}. This is ${voiceProfile} with your AI Daily Briefing. There are no new featured stories today.`,
+        text: `Hello and welcome. Today is ${dateStr}. This is ${voiceProfile} with AI \u4E71\u7096, our chat about AI tools, papers, and hands-on practice. There is nothing solid enough to share today.`,
         gap_ms: 400,
         emotion: "calm"
       },
@@ -22151,7 +22151,7 @@ function buildNewsVoiceScript(docs, options) {
       segments: segments2
     });
   }
-  const title = options?.title || (isZh ? `\u4ECA\u65E5AI\u79D1\u6280\u6F2B\u8C08\uFF08\u5171${docs.length}\u6761\uFF09` : `AI Daily Briefing (${docs.length} stories)`);
+  const title = options?.title || (isZh ? `AI \u4E71\u7096\uFF08\u5171${docs.length}\u6761\uFF09` : `AI \u4E71\u7096 (${docs.length} stories)`);
   const segments = [];
   let hostName = options?.speakers?.host?.name || voiceProfile.replace(/[-_]?(news|voice|bot|profile)$/i, "") || voiceProfile;
   if (hostName.length > 0) {
@@ -22161,7 +22161,7 @@ function buildNewsVoiceScript(docs, options) {
   const planItems = new Map((scriptPlan?.items ?? []).map((item) => [item.id, item]));
   const countText = isZh ? `${formatChineseCount(docs.length)}\u6761` : `${docs.length}`;
   const titlesSummary = docs.slice(0, 3).map((d) => (d.title ?? "").trim()).filter(Boolean).join("\u3001");
-  const introText = isZh ? scriptPlan ? `\u5927\u5BB6\u597D\uFF0C\u4ECA\u5929\u662F${dateStr}\uFF0C\u6B22\u8FCE\u6536\u542C\u7531${hostName}\u4E3A\u60A8\u5E26\u6765\u7684\u4ECA\u65E5AI\u79D1\u6280\u6F2B\u8C08\u3002${scriptPlan.intro}` : `\u5927\u5BB6\u597D\uFF0C\u4ECA\u5929\u662F${dateStr}\uFF0C\u6B22\u8FCE\u6536\u542C\u7531${hostName}\u4E3A\u60A8\u5E26\u6765\u7684\u4ECA\u65E5AI\u79D1\u6280\u6F2B\u8C08\u3002\u4ECA\u5929\u79D1\u6280\u5708\u6709\u51E0\u6761\u975E\u5E38\u6709\u770B\u70B9\u7684\u5927\u6D88\u606F\uFF0C\u6211\u7CBE\u9009\u4E86${countText}\u6700\u503C\u5F97\u5173\u6CE8\u7684\u91CD\u70B9\u52A8\u6001\u6765\u548C\u5927\u5BB6\u804A\u4E00\u804A${titlesSummary ? `\uFF0C\u5305\u62EC${titlesSummary}` : ""}\u3002\u8BDD\u4E0D\u591A\u8BF4\uFF0C\u6211\u4EEC\u9A6C\u4E0A\u8FDB\u5165\u4ECA\u5929\u7684\u6B63\u9898\u3002` : `Hello and welcome. Today is ${dateStr}. This is ${hostName} with your AI Daily Briefing. In today's episode, we have ${countText} fascinating stories from the AI world. Let's dive straight in.`;
+  const introText = isZh ? scriptPlan ? `\u5927\u5BB6\u597D\uFF0C\u4ECA\u5929\u662F${dateStr}\uFF0C\u6B22\u8FCE\u6536\u542C\u300C\u54B8\u8BDD\u54B8\u8BF4\u300D\u7684\u300CAI \u4E71\u7096\u300D\u680F\u76EE\uFF0C\u6211\u662F${hostName}\u3002${scriptPlan.intro}` : `\u5927\u5BB6\u597D\uFF0C\u4ECA\u5929\u662F${dateStr}\uFF0C\u6B22\u8FCE\u6536\u542C\u300C\u54B8\u8BDD\u54B8\u8BF4\u300D\u7684\u300CAI \u4E71\u7096\u300D\u680F\u76EE\uFF0C\u6211\u662F${hostName}\u3002\u4ECA\u5929\u6211\u4ECE AI \u5DE5\u5177\u3001\u8BBA\u6587\u548C\u5B9E\u8DF5\u4E2D\u6574\u7406\u4E86${countText}\u503C\u5F97\u804A\u7684\u5185\u5BB9${titlesSummary ? `\uFF0C\u5305\u62EC${titlesSummary}` : ""}\uFF0C\u54B1\u4EEC\u4E00\u6761\u6761\u6765\u804A\u3002` : `Hello and welcome. Today is ${dateStr}. This is ${hostName} with AI \u4E71\u7096, where we talk about AI tools, papers, and hands-on practice. In today's episode, we have ${countText} stories. Let's dive straight in.`;
   segments.push({
     text: normalizeBroadcastText(introText, isZh),
     gap_ms: 700,
@@ -22196,7 +22196,7 @@ function buildNewsVoiceScript(docs, options) {
       });
     }
   });
-  const outroText = isZh ? scriptPlan ? `${scriptPlan.outro}\u611F\u8C22\u60A8\u7684\u6536\u542C\uFF0C\u6211\u662F${hostName}\uFF0C\u795D\u60A8\u62E5\u6709\u5145\u5B9E\u9AD8\u6548\u7684\u4E00\u5929\uFF0C\u6211\u4EEC\u4E0B\u671F\u8282\u76EE\u4E0D\u89C1\u4E0D\u6563\uFF01` : `\u597D\u4E86\uFF0C\u4EE5\u4E0A\u5C31\u662F\u4ECA\u5929AI\u79D1\u6280\u6F2B\u8C08\u7684\u5168\u90E8\u5185\u5BB9\u3002\u4E0D\u77E5\u9053\u4ECA\u5929\u8FD9\u51E0\u6761\u6D88\u606F\u6709\u6CA1\u6709\u7ED9\u60A8\u5E26\u6765\u4E00\u4E9B\u65B0\u7684\u542F\u53D1\uFF1F\u611F\u8C22\u60A8\u7684\u6536\u542C\uFF0C\u6211\u662F${hostName}\uFF0C\u795D\u60A8\u62E5\u6709\u5145\u5B9E\u9AD8\u6548\u7684\u4E00\u5929\uFF0C\u6211\u4EEC\u4E0B\u671F\u8282\u76EE\u4E0D\u89C1\u4E0D\u6563\uFF01` : `That wraps up today's AI Daily Briefing. I hope today's highlights gave you some useful takeaways. Thank you for listening. This is ${hostName}, wishing you a productive and wonderful day. Until next time!`;
+  const outroText = isZh ? scriptPlan ? `${scriptPlan.outro}\u672C\u671F\u97F3\u9891\u4E3A AI \u5408\u6210\u914D\u97F3\u3002\u611F\u8C22\u60A8\u7684\u6536\u542C\uFF0C\u6211\u662F${hostName}\uFF0C\u795D\u60A8\u62E5\u6709\u5145\u5B9E\u9AD8\u6548\u7684\u4E00\u5929\uFF0C\u6211\u4EEC\u4E0B\u671F\u8282\u76EE\u4E0D\u89C1\u4E0D\u6563\uFF01` : `\u597D\u4E86\uFF0C\u672C\u671FAI\u4E71\u7096\u5C31\u804A\u5230\u8FD9\u91CC\u3002\u5E0C\u671B\u4ECA\u5929\u8FD9\u4E9B\u5DE5\u5177\u3001\u8BBA\u6587\u548C\u5B9E\u8DF5\u7684\u7ECF\u9A8C\u5BF9\u60A8\u6709\u542F\u53D1\u3002\u672C\u671F\u97F3\u9891\u4E3A AI \u5408\u6210\u914D\u97F3\u3002\u611F\u8C22\u60A8\u7684\u6536\u542C\uFF0C\u6211\u662F${hostName}\uFF0C\u795D\u60A8\u62E5\u6709\u5145\u5B9E\u9AD8\u6548\u7684\u4E00\u5929\uFF0C\u6211\u4EEC\u4E0B\u671F\u8282\u76EE\u4E0D\u89C1\u4E0D\u6563\uFF01` : `That wraps up this episode of AI \u4E71\u7096. I hope today's takeaways were useful. The audio in this episode is AI-synthesized. Thank you for listening. This is ${hostName}, wishing you a productive and wonderful day. Until next time!`;
   segments.push({
     text: normalizeBroadcastText(outroText, isZh),
     gap_ms: 300,
@@ -22344,11 +22344,16 @@ var ScriptPlanItemSchema = exports_external.object({
   lead: exports_external.string().min(1),
   insight: exports_external.string().min(1)
 });
+var ScriptPlanExclusionSchema = exports_external.object({
+  id: exports_external.string().min(1),
+  reason: exports_external.string().min(1)
+});
 var ScriptPlanSchema = exports_external.object({
   version: exports_external.literal(1),
   intro: exports_external.string().min(1),
   outro: exports_external.string().min(1),
-  items: exports_external.array(ScriptPlanItemSchema)
+  items: exports_external.array(ScriptPlanItemSchema),
+  excluded: exports_external.array(ScriptPlanExclusionSchema).optional()
 });
 var StyleContractSchema = exports_external.object({
   caps: exports_external.object({
@@ -22386,8 +22391,15 @@ function validateScriptPlan(plan, docs, style) {
       errors5.push({ itemId: item.id, rule: "unknown-id" });
   }
   const plannedIds = new Set(valid.items.map((item) => item.id));
+  const excludedIds = new Set((valid.excluded ?? []).map((ex) => ex.id));
+  for (const ex of valid.excluded ?? []) {
+    if (!docIds.has(ex.id))
+      errors5.push({ itemId: ex.id, rule: "unknown-id" });
+    if (plannedIds.has(ex.id))
+      errors5.push({ itemId: ex.id, rule: "conflict-id" });
+  }
   for (const doc2 of docs) {
-    if (!plannedIds.has(doc2.id))
+    if (!plannedIds.has(doc2.id) && !excludedIds.has(doc2.id))
       errors5.push({ itemId: doc2.id, rule: "missing-item" });
   }
   if (valid.intro.length > style.caps.intro)
@@ -22456,6 +22468,24 @@ async function resolveScriptPlan(fs, docs) {
   }
   return { scriptPlan: validated.plan, scriptSource: "plan", scriptPlanErrors: [] };
 }
+function broadcastDateFromEnv(raw) {
+  if (!raw)
+    return;
+  const match = raw.match(/^(\d{4})-?(\d{2})-?(\d{2})$/);
+  if (match === null) {
+    echoError(`dailynews-gen: ignoring malformed DAILYNEWS_DATE "${raw}" (expected YYYYMMDD or YYYY-MM-DD)`);
+    return;
+  }
+  const year = Number(match[1]);
+  const month = Number(match[2]) - 1;
+  const day = Number(match[3]);
+  const date6 = new Date(year, month, day);
+  if (date6.getFullYear() !== year || date6.getMonth() !== month || date6.getDate() !== day) {
+    echoError(`dailynews-gen: ignoring out-of-range DAILYNEWS_DATE "${raw}"`);
+    return;
+  }
+  return date6;
+}
 async function processGeneratorIO(inputPath, outputPath, options) {
   const fs = createNodeFileSystem();
   let docs;
@@ -22475,7 +22505,13 @@ async function processGeneratorIO(inputPath, outputPath, options) {
   }
   const isZh = (options?.language || "zh").toLowerCase() === "zh";
   const planOutcome = isZh ? await resolveScriptPlan(fs, docs) : { scriptSource: "template", scriptPlanErrors: [] };
-  const script = buildNewsVoiceScript(docs, { ...options, scriptPlan: planOutcome.scriptPlan });
+  const excludedIds = new Set(planOutcome.scriptPlan?.excluded?.map((ex) => ex.id) ?? []);
+  if (excludedIds.size > 0) {
+    echoError(`dailynews-gen: topic boundary excludes ${excludedIds.size} doc(s): ${[...excludedIds].join(", ")}`);
+    docs = docs.filter((doc2) => !excludedIds.has(doc2.id));
+  }
+  const date6 = options?.date ?? broadcastDateFromEnv(process.env.DAILYNEWS_DATE);
+  const script = buildNewsVoiceScript(docs, { ...options, date: date6, scriptPlan: planOutcome.scriptPlan });
   const yamlBody = formatVoiceScriptToYaml(script);
   const content = {
     title: script.title,
@@ -22556,6 +22592,7 @@ export {
   formatChineseCount,
   formatBroadcastDate,
   buildNewsVoiceScript,
+  broadcastDateFromEnv,
   VoiceSpeakerSchema,
   VoiceScriptSegmentSchema,
   VoiceScriptSchema,

package/plugins/generations/dailynews-gen/src/index.ts

@@ -66,6 +66,32 @@ async function resolveScriptPlan(fs: FileSystem, docs: Doc[]): Promise<ScriptPla
     return { scriptPlan: validated.plan, scriptSource: 'plan', scriptPlanErrors: [] };
 }
 
+/**
+ * `DAILYNEWS_DATE` (YYYYMMDD or `YYYY-MM-DD`) → a local-midnight Date. Task 0189: the broadcast
+ * greeting must carry the episode's run date, not the render date — a 9/29 episode rebuilt on 9/30
+ * must not greet "今天是9月30日". Parsed as local calendar parts, never UTC (`new Date('2026-09-29')`
+ * is UTC midnight and renders the previous day west of UTC). Absent → undefined; garbled or
+ * out-of-range (the Date constructor rolls over, e.g. month 13) → undefined with a warn so a
+ * caller bug surfaces instead of silently broadcasting the wrong day.
+ */
+export function broadcastDateFromEnv(raw: string | undefined): Date | undefined {
+    if (!raw) return undefined;
+    const match = raw.match(/^(\d{4})-?(\d{2})-?(\d{2})$/);
+    if (match === null) {
+        echoError(`dailynews-gen: ignoring malformed DAILYNEWS_DATE "${raw}" (expected YYYYMMDD or YYYY-MM-DD)`);
+        return undefined;
+    }
+    const year = Number(match[1]);
+    const month = Number(match[2]) - 1;
+    const day = Number(match[3]);
+    const date = new Date(year, month, day);
+    if (date.getFullYear() !== year || date.getMonth() !== month || date.getDate() !== day) {
+        echoError(`dailynews-gen: ignoring out-of-range DAILYNEWS_DATE "${raw}"`);
+        return undefined;
+    }
+    return date;
+}
+
 export async function processGeneratorIO(
     inputPath: string,
     outputPath: string,
@@ -101,7 +127,16 @@ export async function processGeneratorIO(
     const planOutcome = isZh
         ? await resolveScriptPlan(fs, docs)
         : { scriptSource: 'template' as const, scriptPlanErrors: [] as ScriptPlanError[] };
-    const script = buildNewsVoiceScript(docs, { ...options, scriptPlan: planOutcome.scriptPlan });
+    // Topic boundary (task 0189): docs the plan declares excluded are not spoken, not counted,
+    // and not referenced — title, storyCount, and references must match what is actually said.
+    const excludedIds = new Set(planOutcome.scriptPlan?.excluded?.map((ex) => ex.id) ?? []);
+    if (excludedIds.size > 0) {
+        echoError(`dailynews-gen: topic boundary excludes ${excludedIds.size} doc(s): ${[...excludedIds].join(', ')}`);
+        docs = docs.filter((doc) => !excludedIds.has(doc.id));
+    }
+    // Explicit option wins; else DAILYNEWS_DATE (workflow backfill/retry); else the builder's now.
+    const date = options?.date ?? broadcastDateFromEnv(process.env.DAILYNEWS_DATE);
+    const script = buildNewsVoiceScript(docs, { ...options, date, scriptPlan: planOutcome.scriptPlan });
     const yamlBody = formatVoiceScriptToYaml(script);
 
     const content: Content = {