@gobing-ai/knowledge-kit 0.0.23 → 0.0.25

package/plugins/generations/dailynews-gen/src/script-builder.ts

@@ -1,5 +1,6 @@
 import type { Doc } from '@gobing-ai/kk-core';
 import { z } from 'zod';
+import type { ScriptPlan } from './script-plan';
 
 export const EffectConfigSchema = z.object({
     type: z.string().min(1),
@@ -74,6 +75,8 @@ export interface ScriptBuilderOptions {
     emotion?: string;
     effectPreset?: string;
     speakers?: Record<string, VoiceSpeaker>;
+    /** LLM-authored spoken plan (F613). Substituted on the zh path only; en ignores it. */
+    scriptPlan?: ScriptPlan;
 }
 
 const ZH_DIGITS = ['零', '一', '二', '三', '四', '五', '六', '七', '八', '九', '十'];
@@ -353,6 +356,11 @@ export function buildNewsVoiceScript(docs: Doc[], options?: ScriptBuilderOptions
         hostName = hostName.charAt(0).toUpperCase() + hostName.slice(1);
     }
 
+    // F613: the plan owns the words on the zh path; en keeps templates (design: substitution is
+    // zh-only). Items are matched to docs by id and doc order wins; plan item order is ignored.
+    const scriptPlan = isZh ? options?.scriptPlan : undefined;
+    const planItems = new Map((scriptPlan?.items ?? []).map((item) => [item.id, item]));
+
     // 1. Opening segment: Conversational podcast hook + overview
     const countText = isZh ? `${formatChineseCount(docs.length)}条` : `${docs.length}`;
     const titlesSummary = docs
@@ -362,7 +370,11 @@ export function buildNewsVoiceScript(docs: Doc[], options?: ScriptBuilderOptions
         .join('、');
 
     const introText = isZh
-        ? `大家好，今天是${dateStr}，欢迎收听由${hostName}为您带来的今日AI科技漫谈。今天科技圈有几条非常有看点的大消息，我精选了${countText}最值得关注的重点动态来和大家聊一聊${titlesSummary ? `，包括${titlesSummary}` : ''}。话不多说，我们马上进入今天的正题。`
+        ? scriptPlan
+            ? // F613: fixed greeting stays builder-owned; the plan only fills the slot between
+              // greeting and first story (the template tail 从「今天科技圈有几条…正题。」 is replaced).
+              `大家好，今天是${dateStr}，欢迎收听由${hostName}为您带来的今日AI科技漫谈。${scriptPlan.intro}`
+            : `大家好，今天是${dateStr}，欢迎收听由${hostName}为您带来的今日AI科技漫谈。今天科技圈有几条非常有看点的大消息，我精选了${countText}最值得关注的重点动态来和大家聊一聊${titlesSummary ? `，包括${titlesSummary}` : ''}。话不多说，我们马上进入今天的正题。`
         : `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.`;
 
     segments.push({
@@ -380,22 +392,28 @@ export function buildNewsVoiceScript(docs: Doc[], options?: ScriptBuilderOptions
         // 【title】 is the only place the title is spoken for this item.
         const cleanBody = stripLeadingTitleEcho(stripTagMetadataLines((doc.body ?? '').trim()), cleanTitle);
 
-        // Conversational lead
-        const lead = isZh
-            ? idx === 0
-                ? `首先来聊聊大家非常关注的【${cleanTitle}】。`
+        // Conversational lead. F613: the plan lead is a bridge that keeps 【title】 spoken exactly
+        // once (0139 R1) and must not contain the title itself (style contract, R1).
+        const planItem = planItems.get(doc.id);
+        const lead = planItem
+            ? `${planItem.lead}【${cleanTitle}】。`
+            : isZh
+              ? idx === 0
+                  ? `首先来聊聊大家非常关注的【${cleanTitle}】。`
+                  : isLast
+                    ? `最后，来看看今天的最后一条资讯，【${cleanTitle}】。`
+                    : `接着我们把目光转向另一条重要进展，【${cleanTitle}】。`
+              : idx === 0
+                ? `First up today, let's look at ${cleanTitle}.`
                 : isLast
-                  ? `最后，来看看今天的最后一条资讯，【${cleanTitle}】。`
-                  : `接着我们把目光转向另一条重要进展，【${cleanTitle}】。`
-            : idx === 0
-              ? `First up today, let's look at ${cleanTitle}.`
-              : isLast
-                ? `And finally today, let's wrap up with ${cleanTitle}.`
-                : `Next, turning our attention to ${cleanTitle}.`;
+                  ? `And finally today, let's wrap up with ${cleanTitle}.`
+                  : `Next, turning our attention to ${cleanTitle}.`;
 
         const normalizedLead = normalizeBroadcastText(lead, isZh);
         const normalizedBody = cleanBody === '' ? '' : normalizeBroadcastText(cleanBody, isZh);
-        const insight = synthesizePersonalUnderstanding(cleanTitle, cleanBody, isZh, usedInsights);
+        // F613: the plan insight is grounded in this item and always spoken; the keyword-bucket
+        // synthesizer (and its uniqueness set) only runs on the template path.
+        const insight = planItem?.insight ?? synthesizePersonalUnderstanding(cleanTitle, cleanBody, isZh, usedInsights);
         const normalizedInsight = insight === null ? null : normalizeBroadcastText(insight, isZh);
 
         const factText = isZh ? `${normalizedLead}${normalizedBody}` : `${normalizedLead} ${normalizedBody}`;
@@ -420,9 +438,12 @@ export function buildNewsVoiceScript(docs: Doc[], options?: ScriptBuilderOptions
         }
     });
 
-    // 3. Outro segment: Warm, conversational wrap-up
+    // 3. Outro segment: Warm, conversational wrap-up. F613: the plan outro replaces the template
+    // wrap-up head; the fixed sign-off stays builder-owned.
     const outroText = isZh
-        ? `好了，以上就是今天AI科技漫谈的全部内容。不知道今天这几条消息有没有给您带来一些新的启发？感谢您的收听，我是${hostName}，祝您拥有充实高效的一天，我们下期节目不见不散！`
+        ? scriptPlan
+            ? `${scriptPlan.outro}感谢您的收听，我是${hostName}，祝您拥有充实高效的一天，我们下期节目不见不散！`
+            : `好了，以上就是今天AI科技漫谈的全部内容。不知道今天这几条消息有没有给您带来一些新的启发？感谢您的收听，我是${hostName}，祝您拥有充实高效的一天，我们下期节目不见不散！`
         : `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!`;
 
     segments.push({

package/plugins/generations/dailynews-gen/src/script-plan.ts

@@ -0,0 +1,142 @@
+import type { Doc } from '@gobing-ai/kk-core';
+import { z } from 'zod';
+
+/**
+ * LLM-authored spoken plan for one daily episode (F613). The plan owns words only; the builder
+ * keeps segment order, pacing tokens, fact chunking, and validation
+ * (`docs/design/daily-voice-script-plan.md` §3). `version` is pinned so a future shape change
+ * fails loud as `schema` instead of mis-substituting.
+ */
+export interface ScriptPlan {
+    version: 1;
+    intro: string;
+    outro: string;
+    items: { id: string; lead: string; insight: string }[];
+}
+
+/**
+ * Machine-readable part of the style sidecar `plugins/kk/scripts/daily-voice-style.zh.md` — the
+ * same fenced `json` block the script-write prompt reads, so prompt and validator share one source.
+ */
+export interface StyleContract {
+    caps: { intro: number; outro: number; lead: number; insight: number };
+    banned: string[];
+}
+
+/** One plan rejection: which item (`episode` for plan-level fields) broke which rule. */
+export interface ScriptPlanError {
+    itemId: string;
+    rule: string;
+}
+
+export type ScriptPlanValidation = { ok: true; plan: ScriptPlan } | { ok: false; errors: ScriptPlanError[] };
+
+/**
+ * Empty spoken text is a shape error (`schema`), not a cap/banned case: an empty intro or insight
+ * would normalize to a bare 「。」 segment, which no valid episode contains.
+ */
+const ScriptPlanItemSchema = z.object({
+    id: z.string().min(1),
+    lead: z.string().min(1),
+    insight: z.string().min(1),
+});
+
+const ScriptPlanSchema = z.object({
+    version: z.literal(1),
+    intro: z.string().min(1),
+    outro: z.string().min(1),
+    items: z.array(ScriptPlanItemSchema),
+});
+
+const StyleContractSchema = z.object({
+    caps: z.object({
+        intro: z.number().int().positive(),
+        outro: z.number().int().positive(),
+        lead: z.number().int().positive(),
+        insight: z.number().int().positive(),
+    }),
+    banned: z.array(z.string().min(1)),
+});
+
+const STYLE_JSON_FENCE_RE = /```json\s*([\s\S]*?)```/;
+
+/**
+ * Parse the style contract out of the sidecar markdown: the FIRST fenced `json` block. A missing
+ * or invalid block throws — the caller turns that into the `no-style` fallback rule (a plan must
+ * never run without its contract).
+ */
+export function parseStyleContract(markdown: string): StyleContract {
+    const match = markdown.match(STYLE_JSON_FENCE_RE);
+    if (!match?.[1]) {
+        throw new Error('style contract has no ```json fenced block');
+    }
+    let parsed: unknown;
+    try {
+        parsed = JSON.parse(match[1].trim());
+    } catch (err: unknown) {
+        throw new Error(
+            `style contract json block is not valid JSON: ${err instanceof Error ? err.message : String(err)}`,
+        );
+    }
+    return StyleContractSchema.parse(parsed);
+}
+
+/**
+ * Validate a plan against the docs and the style contract. Rules (task 0161 R2), accumulated —
+ * one warn line names every violation, so a rejected plan is diagnosable in one read:
+ *
+ * - `schema`: wrong shape or version (`itemId: episode`)
+ * - `unknown-id`: a plan item id that is not a doc
+ * - `missing-item`: a doc with no plan item
+ * - `cap:<field>`: a field over its cap (`intro`/`outro` report `itemId: episode`)
+ * - `banned:<phrase>`: a field containing a banned phrase
+ * - `duplicate-insight`: the same insight text on two items in one episode
+ *
+ * All-or-nothing by contract (Q&A): a partially valid plan is never partially applied.
+ */
+export function validateScriptPlan(plan: unknown, docs: Doc[], style: StyleContract): ScriptPlanValidation {
+    const parsed = ScriptPlanSchema.safeParse(plan);
+    if (!parsed.success) {
+        return { ok: false, errors: [{ itemId: 'episode', rule: 'schema' }] };
+    }
+    const valid = parsed.data;
+    const errors: ScriptPlanError[] = [];
+    const docIds = new Set(docs.map((doc) => doc.id));
+
+    for (const item of valid.items) {
+        if (!docIds.has(item.id)) errors.push({ itemId: item.id, rule: 'unknown-id' });
+    }
+    const plannedIds = new Set(valid.items.map((item) => item.id));
+    for (const doc of docs) {
+        if (!plannedIds.has(doc.id)) errors.push({ itemId: doc.id, rule: 'missing-item' });
+    }
+
+    if (valid.intro.length > style.caps.intro) errors.push({ itemId: 'episode', rule: 'cap:intro' });
+    if (valid.outro.length > style.caps.outro) errors.push({ itemId: 'episode', rule: 'cap:outro' });
+    for (const item of valid.items) {
+        if (item.lead.length > style.caps.lead) errors.push({ itemId: item.id, rule: 'cap:lead' });
+        if (item.insight.length > style.caps.insight) errors.push({ itemId: item.id, rule: 'cap:insight' });
+    }
+
+    const fields: { itemId: string; text: string }[] = [
+        { itemId: 'episode', text: valid.intro },
+        { itemId: 'episode', text: valid.outro },
+        ...valid.items.flatMap((item) => [
+            { itemId: item.id, text: item.lead },
+            { itemId: item.id, text: item.insight },
+        ]),
+    ];
+    for (const field of fields) {
+        for (const phrase of style.banned) {
+            if (field.text.includes(phrase)) errors.push({ itemId: field.itemId, rule: `banned:${phrase}` });
+        }
+    }
+
+    const seenInsights = new Set<string>();
+    for (const item of valid.items) {
+        if (seenInsights.has(item.insight)) errors.push({ itemId: item.id, rule: 'duplicate-insight' });
+        else seenInsights.add(item.insight);
+    }
+
+    return errors.length > 0 ? { ok: false, errors } : { ok: true, plan: valid };
+}

package/plugins/generations/episode-plan-gen/dist/index.js

@@ -14642,6 +14642,72 @@ var init_zod = __esm(() => {
   init_external();
 });
 
+// ../../node_modules/.bun/@gobing-ai+ts-utils@0.5.11/node_modules/@gobing-ai/ts-utils/dist/errors.js
+var ErrorCode;
+var init_errors3 = __esm(() => {
+  ErrorCode = {
+    NotFound: "NOT_FOUND",
+    Validation: "VALIDATION",
+    Conflict: "CONFLICT",
+    Internal: "INTERNAL"
+  };
+});
+
+// ../../node_modules/.bun/@gobing-ai+ts-utils@0.5.11/node_modules/@gobing-ai/ts-utils/dist/api-response.js
+var API_ERROR_CODES, ERROR_CODE_TO_HTTP, CLIENT_SAFE_CODES;
+var init_api_response = __esm(() => {
+  init_errors3();
+  API_ERROR_CODES = {
+    SUCCESS: 0,
+    NOT_FOUND: 404,
+    VALIDATION_ERROR: 422,
+    BAD_REQUEST: 400,
+    UNAUTHORIZED: 401,
+    FORBIDDEN: 403,
+    CONFLICT: 409,
+    INTERNAL_ERROR: 500
+  };
+  ERROR_CODE_TO_HTTP = {
+    [ErrorCode.NotFound]: API_ERROR_CODES.NOT_FOUND,
+    [ErrorCode.Validation]: API_ERROR_CODES.VALIDATION_ERROR,
+    [ErrorCode.Conflict]: API_ERROR_CODES.CONFLICT,
+    [ErrorCode.Internal]: API_ERROR_CODES.INTERNAL_ERROR
+  };
+  CLIENT_SAFE_CODES = new Set([ErrorCode.NotFound, ErrorCode.Validation, ErrorCode.Conflict]);
+});
+
+// ../../node_modules/.bun/@gobing-ai+ts-utils@0.5.11/node_modules/@gobing-ai/ts-utils/dist/cursor.js
+var init_cursor = () => {};
+
+// ../../node_modules/.bun/@gobing-ai+ts-utils@0.5.11/node_modules/@gobing-ai/ts-utils/dist/event-severity.js
+var init_event_severity = () => {};
+
+// ../../node_modules/.bun/@gobing-ai+ts-utils@0.5.11/node_modules/@gobing-ai/ts-utils/dist/output.js
+function processStream(name) {
+  const proc = globalThis.process;
+  const stream = proc?.[name];
+  if (stream === undefined) {
+    throw new Error(`No ${name} target available: set one via setDefaultOutputTargets or pass an explicit target`);
+  }
+  return stream;
+}
+function writeLine(message, target) {
+  target.write(`${message}
+`);
+}
+function echoError(message, target = defaultStderrTarget ?? processStream("stderr")) {
+  writeLine(message, target);
+}
+var defaultStderrTarget;
+
+// ../../node_modules/.bun/@gobing-ai+ts-utils@0.5.11/node_modules/@gobing-ai/ts-utils/dist/index.js
+var init_dist = __esm(() => {
+  init_api_response();
+  init_cursor();
+  init_errors3();
+  init_event_severity();
+});
+
 // ../../node_modules/.bun/yaml@2.9.0/node_modules/yaml/dist/nodes/identity.js
 var require_identity = __commonJS((exports) => {
   var ALIAS = Symbol.for("yaml.alias");
@@ -17546,15 +17612,15 @@ var require_timestamp = __commonJS((exports) => {
         throw new Error("!!timestamp expects a date, starting with yyyy-mm-dd");
       const [, year, month, day, hour, minute, second] = match.map(Number);
       const millisec = match[7] ? Number((match[7] + "00").substr(1, 3)) : 0;
-      let date5 = Date.UTC(year, month - 1, day, hour || 0, minute || 0, second || 0, millisec);
+      let date6 = Date.UTC(year, month - 1, day, hour || 0, minute || 0, second || 0, millisec);
       const tz = match[8];
       if (tz && tz !== "Z") {
         let d = parseSexagesimal(tz, false);
         if (Math.abs(d) < 30)
           d *= 60;
-        date5 -= 60000 * d;
+        date6 -= 60000 * d;
       }
-      return new Date(date5);
+      return new Date(date6);
     },
     stringify: ({ value }) => value?.toISOString().replace(/(T00:00:00)?\.000Z$/, "") ?? ""
   };
@@ -19414,7 +19480,7 @@ var require_composer = __commonJS((exports) => {
   var node_process = __require("process");
   var directives = require_directives();
   var Document = require_Document();
-  var errors3 = require_errors();
+  var errors4 = require_errors();
   var identity = require_identity();
   var composeDoc = require_compose_doc();
   var resolveEnd = require_resolve_end();
@@ -19465,9 +19531,9 @@ var require_composer = __commonJS((exports) => {
       this.onError = (source, code, message, warning) => {
         const pos = getErrorPos(source);
         if (warning)
-          this.warnings.push(new errors3.YAMLWarning(pos, code, message));
+          this.warnings.push(new errors4.YAMLWarning(pos, code, message));
         else
-          this.errors.push(new errors3.YAMLParseError(pos, code, message));
+          this.errors.push(new errors4.YAMLParseError(pos, code, message));
       };
       this.directives = new directives.Directives({ version: options.version || "1.2" });
       this.options = options;
@@ -19553,7 +19619,7 @@ ${cb}` : comment;
           break;
         case "error": {
           const msg = token.source ? `${token.message}: ${JSON.stringify(token.source)}` : token.message;
-          const error51 = new errors3.YAMLParseError(getErrorPos(token), "UNEXPECTED_TOKEN", msg);
+          const error51 = new errors4.YAMLParseError(getErrorPos(token), "UNEXPECTED_TOKEN", msg);
           if (this.atDirectives || !this.doc)
             this.errors.push(error51);
           else
@@ -19563,7 +19629,7 @@ ${cb}` : comment;
         case "doc-end": {
           if (!this.doc) {
             const msg = "Unexpected doc-end without preceding document";
-            this.errors.push(new errors3.YAMLParseError(getErrorPos(token), "UNEXPECTED_TOKEN", msg));
+            this.errors.push(new errors4.YAMLParseError(getErrorPos(token), "UNEXPECTED_TOKEN", msg));
             break;
           }
           this.doc.directives.docEnd = true;
@@ -19578,7 +19644,7 @@ ${end.comment}` : end.comment;
           break;
         }
         default:
-          this.errors.push(new errors3.YAMLParseError(getErrorPos(token), "UNEXPECTED_TOKEN", `Unsupported token ${token.type}`));
+          this.errors.push(new errors4.YAMLParseError(getErrorPos(token), "UNEXPECTED_TOKEN", `Unsupported token ${token.type}`));
       }
     }
     *end(forceDoc = false, endOffset = -1) {
@@ -19604,7 +19670,7 @@ ${end.comment}` : end.comment;
 var require_cst_scalar = __commonJS((exports) => {
   var resolveBlockScalar = require_resolve_block_scalar();
   var resolveFlowScalar = require_resolve_flow_scalar();
-  var errors3 = require_errors();
+  var errors4 = require_errors();
   var stringifyString = require_stringifyString();
   function resolveAsScalar(token, strict = true, onError) {
     if (token) {
@@ -19613,7 +19679,7 @@ var require_cst_scalar = __commonJS((exports) => {
         if (onError)
           onError(offset, code, message);
         else
-          throw new errors3.YAMLParseError([offset, offset + 1], code, message);
+          throw new errors4.YAMLParseError([offset, offset + 1], code, message);
       };
       switch (token.type) {
         case "scalar":
@@ -21493,7 +21559,7 @@ var require_parser = __commonJS((exports) => {
 var require_public_api = __commonJS((exports) => {
   var composer = require_composer();
   var Document = require_Document();
-  var errors3 = require_errors();
+  var errors4 = require_errors();
   var log = require_log();
   var identity = require_identity();
   var lineCounter = require_line_counter();
@@ -21510,8 +21576,8 @@ var require_public_api = __commonJS((exports) => {
     const docs = Array.from(composer$1.compose(parser$1.parse(source)));
     if (prettyErrors && lineCounter2)
       for (const doc2 of docs) {
-        doc2.errors.forEach(errors3.prettifyError(source, lineCounter2));
-        doc2.warnings.forEach(errors3.prettifyError(source, lineCounter2));
+        doc2.errors.forEach(errors4.prettifyError(source, lineCounter2));
+        doc2.warnings.forEach(errors4.prettifyError(source, lineCounter2));
       }
     if (docs.length > 0)
       return docs;
@@ -21526,13 +21592,13 @@ var require_public_api = __commonJS((exports) => {
       if (!doc2)
         doc2 = _doc;
       else if (doc2.options.logLevel !== "silent") {
-        doc2.errors.push(new errors3.YAMLParseError(_doc.range.slice(0, 2), "MULTIPLE_DOCS", "Source contains multiple documents; please use YAML.parseAllDocuments()"));
+        doc2.errors.push(new errors4.YAMLParseError(_doc.range.slice(0, 2), "MULTIPLE_DOCS", "Source contains multiple documents; please use YAML.parseAllDocuments()"));
         break;
       }
     }
     if (prettyErrors && lineCounter2) {
-      doc2.errors.forEach(errors3.prettifyError(source, lineCounter2));
-      doc2.warnings.forEach(errors3.prettifyError(source, lineCounter2));
+      doc2.errors.forEach(errors4.prettifyError(source, lineCounter2));
+      doc2.warnings.forEach(errors4.prettifyError(source, lineCounter2));
     }
     return doc2;
   }
@@ -21584,12 +21650,12 @@ var require_public_api = __commonJS((exports) => {
 });
 
 // ../../node_modules/.bun/yaml@2.9.0/node_modules/yaml/dist/index.js
-var composer, Document, Schema, errors3, Alias, identity, Pair, Scalar, YAMLMap, YAMLSeq, cst, lexer, lineCounter, parser, publicApi, visit, $Composer, $Document, $Schema, $YAMLError, $YAMLParseError, $YAMLWarning, $Alias, $isAlias, $isCollection, $isDocument, $isMap, $isNode, $isPair, $isScalar, $isSeq, $Pair, $Scalar, $YAMLMap, $YAMLSeq, $Lexer, $LineCounter, $Parser, $parse, $parseAllDocuments, $parseDocument, $stringify, $visit, $visitAsync;
-var init_dist = __esm(() => {
+var composer, Document, Schema, errors4, Alias, identity, Pair, Scalar, YAMLMap, YAMLSeq, cst, lexer, lineCounter, parser, publicApi, visit, $Composer, $Document, $Schema, $YAMLError, $YAMLParseError, $YAMLWarning, $Alias, $isAlias, $isCollection, $isDocument, $isMap, $isNode, $isPair, $isScalar, $isSeq, $Pair, $Scalar, $YAMLMap, $YAMLSeq, $Lexer, $LineCounter, $Parser, $parse, $parseAllDocuments, $parseDocument, $stringify, $visit, $visitAsync;
+var init_dist2 = __esm(() => {
   composer = require_composer();
   Document = require_Document();
   Schema = require_Schema();
-  errors3 = require_errors();
+  errors4 = require_errors();
   Alias = require_Alias();
   identity = require_identity();
   Pair = require_Pair();
@@ -21605,9 +21671,9 @@ var init_dist = __esm(() => {
   $Composer = composer.Composer;
   $Document = Document.Document;
   $Schema = Schema.Schema;
-  $YAMLError = errors3.YAMLError;
-  $YAMLParseError = errors3.YAMLParseError;
-  $YAMLWarning = errors3.YAMLWarning;
+  $YAMLError = errors4.YAMLError;
+  $YAMLParseError = errors4.YAMLParseError;
+  $YAMLWarning = errors4.YAMLWarning;
   $Alias = Alias.Alias;
   $isAlias = identity.isAlias;
   $isCollection = identity.isCollection;
@@ -21632,10 +21698,10 @@ var init_dist = __esm(() => {
   $visitAsync = visit.visitAsync;
 });
 
-// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.4.39/node_modules/@gobing-ai/ts-runtime/dist/config.js
+// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.5.11/node_modules/@gobing-ai/ts-runtime/dist/config.js
 var configSchema;
 var init_config = __esm(() => {
-  init_dist();
+  init_dist2();
   init_zod();
   configSchema = exports_external.object({
     app: exports_external.object({
@@ -21656,7 +21722,7 @@ var init_config = __esm(() => {
   });
 });
 
-// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.4.39/node_modules/@gobing-ai/ts-runtime/dist/file-system-node.js
+// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.5.11/node_modules/@gobing-ai/ts-runtime/dist/file-system-node.js
 import { appendFileSync, cpSync, createReadStream, createWriteStream, existsSync, mkdirSync, readdirSync, readFileSync, realpathSync, renameSync, rmSync, statSync, writeFileSync } from "fs";
 import { dirname, resolve as resolvePath } from "path";
 function createNodeFileSystem(root, paths) {
@@ -21834,14 +21900,14 @@ var PluginManifestSchema = exports_external.looseObject({
   description: exports_external.string().optional(),
   operations: exports_external.record(exports_external.string(), PluginOperationSchema).optional()
 });
-// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.4.39/node_modules/@gobing-ai/ts-runtime/dist/index.js
+// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.5.11/node_modules/@gobing-ai/ts-runtime/dist/index.js
 init_file_system_node();
 init_config();
 
-// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.4.39/node_modules/@gobing-ai/ts-runtime/dist/fs.js
+// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.5.11/node_modules/@gobing-ai/ts-runtime/dist/fs.js
 init_file_system_node();
 
-// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.4.39/node_modules/@gobing-ai/ts-runtime/dist/path.js
+// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.5.11/node_modules/@gobing-ai/ts-runtime/dist/path.js
 function normalizeSeparators(path) {
   return path.replaceAll("\\", "/");
 }
@@ -21875,7 +21941,7 @@ function dirnamePath(path) {
   return normalized.slice(0, index);
 }
 
-// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.4.39/node_modules/@gobing-ai/ts-runtime/dist/fs.js
+// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.5.11/node_modules/@gobing-ai/ts-runtime/dist/fs.js
 async function ensureDirForFile(path, fs = createNodeFileSystem()) {
   await fs.ensureDir(dirnamePath(path));
 }
@@ -21903,27 +21969,10 @@ function getProcessPid() {
 function uniqueToken() {
   return `${Date.now()}.${crypto.randomUUID()}`;
 }
-// ../../node_modules/.bun/@gobing-ai+ts-utils@0.4.67/node_modules/@gobing-ai/ts-utils/dist/output.js
-var defaultStderrTarget;
-function processStream(name) {
-  const proc = globalThis.process;
-  const stream = proc?.[name];
-  if (stream === undefined) {
-    throw new Error(`No ${name} target available: set one via setDefaultOutputTargets or pass an explicit target`);
-  }
-  return stream;
-}
-function writeLine(message, target) {
-  target.write(`${message}
-`);
-}
-function echoError(message, target = defaultStderrTarget ?? processStream("stderr")) {
-  writeLine(message, target);
-}
-
 // ../../packages/kk-core/src/render-md.ts
 if (false) {}
 // ../../plugins/generations/episode-plan-gen/src/index.ts
+init_dist();
 var SOURCE_BASE = {
   aihot: 30,
   rss: 12,
@@ -22046,9 +22095,9 @@ function docTimestamp(doc2) {
         return t;
     }
   }
-  const date5 = meta3.date;
-  if (typeof date5 === "string" && /^\d{4}-\d{2}-\d{2}/.test(date5.trim())) {
-    return Date.parse(date5.trim().slice(0, 10));
+  const date6 = meta3.date;
+  if (typeof date6 === "string" && /^\d{4}-\d{2}-\d{2}/.test(date6.trim())) {
+    return Date.parse(date6.trim().slice(0, 10));
   }
   return null;
 }
@@ -22318,7 +22367,7 @@ function sourceOf(doc2) {
   const meta3 = asRecord(doc2.metadata);
   return typeof meta3.source === "string" ? meta3.source : "unknown";
 }
-function renderPlanMarkdown(docs, date5) {
+function renderPlanMarkdown(docs, date6) {
   const items = docs.map((doc2, i) => {
     const meta3 = asRecord(doc2.metadata);
     const parts = [
@@ -22332,25 +22381,25 @@ function renderPlanMarkdown(docs, date5) {
   }).join(`
 
 `);
-  return `# \u6BCF\u65E5 AI \u64AD\u5BA2\u9009\u7A3F\u8BA1\u5212 \u2014 ${date5}
+  return `# \u6BCF\u65E5 AI \u64AD\u5BA2\u9009\u7A3F\u8BA1\u5212 \u2014 ${date6}
 
 \u672C\u671F\u5171 ${docs.length} \u6761\uFF08\u8BC4\u5206/\u53BB\u91CD/\u6807\u8BB0\u540E\u7CBE\u9009\uFF09\u3002
 
 ${items}
 `;
 }
-function docsToContent(docs, date5, audit) {
-  const planned = planEpisode(docs, { maxItems: maxItemsFromEnv(), date: date5, audit });
-  return planContent(planned, date5);
+function docsToContent(docs, date6, audit) {
+  const planned = planEpisode(docs, { maxItems: maxItemsFromEnv(), date: date6, audit });
+  return planContent(planned, date6);
 }
-function planContent(docs, date5) {
+function planContent(docs, date6) {
   return ContentSchema.parse({
-    title: `\u6BCF\u65E5 AI \u64AD\u5BA2\u9009\u7A3F\u8BA1\u5212 \u2014 ${date5}`,
-    body: renderPlanMarkdown(docs, date5),
+    title: `\u6BCF\u65E5 AI \u64AD\u5BA2\u9009\u7A3F\u8BA1\u5212 \u2014 ${date6}`,
+    body: renderPlanMarkdown(docs, date6),
     format: "markdown",
     metadata: {
       generator: "kk:episode-plan",
-      date: date5,
+      date: date6,
       doc_count: docs.length,
       docs
     }
@@ -22398,13 +22447,13 @@ function parseFilterCategories(raw) {
   }
   return entries;
 }
-function filterConfigFromEnv(env = process.env) {
+function filterConfigFromEnv(env2 = process.env) {
   return {
-    categories: parseFilterCategories(env.QC_CATEGORIES),
-    minQuality: parseFilterThreshold(env.QC_MIN_QUALITY, "QC_MIN_QUALITY", DEFAULT_FILTER_CONFIG.minQuality),
-    minImportance: parseFilterThreshold(env.QC_MIN_IMPORTANCE, "QC_MIN_IMPORTANCE", DEFAULT_FILTER_CONFIG.minImportance),
-    minUrgency: parseFilterThreshold(env.QC_MIN_URGENCY, "QC_MIN_URGENCY", DEFAULT_FILTER_CONFIG.minUrgency),
-    minImpact: parseFilterThreshold(env.QC_MIN_IMPACT, "QC_MIN_IMPACT", DEFAULT_FILTER_CONFIG.minImpact)
+    categories: parseFilterCategories(env2.QC_CATEGORIES),
+    minQuality: parseFilterThreshold(env2.QC_MIN_QUALITY, "QC_MIN_QUALITY", DEFAULT_FILTER_CONFIG.minQuality),
+    minImportance: parseFilterThreshold(env2.QC_MIN_IMPORTANCE, "QC_MIN_IMPORTANCE", DEFAULT_FILTER_CONFIG.minImportance),
+    minUrgency: parseFilterThreshold(env2.QC_MIN_URGENCY, "QC_MIN_URGENCY", DEFAULT_FILTER_CONFIG.minUrgency),
+    minImpact: parseFilterThreshold(env2.QC_MIN_IMPACT, "QC_MIN_IMPACT", DEFAULT_FILTER_CONFIG.minImpact)
   };
 }
 function requireAnnotation(doc2) {

package/plugins/generations/gemini-tts/README.md

@@ -65,6 +65,7 @@ rm -rf "$T"
 Stdout is the `voice_…` id. A non-zero exit prints the HTTP status and API message and does not
 print the key. Note on HTTP 500 / Voice mismatch errors:
 - Upstream `POST /v1beta/voices` can return HTTP 500 when server-side validation serializes an invalid argument or consent mismatch.
+- 2026-09-24: the zh pair that created the original voice (28 s zh source + 7 s zh consent) started returning HTTP 500 "Error translating server response to JSON" on both accounts. The en-pair path (below) succeeded first try — prefer it for renewals.
 - A Chinese source paired with an English consent fails with `Voice mismatch detected`.
 - Using a clean 10–30s English recording containing the verbatim consent statement as both `--source` and `--consent` succeeds reliably via the API, creating a stored voice that synthesizes both English and Chinese content.
 - Google AI Studio's interactive voice replication UI is also available as a manual fallback.
@@ -94,6 +95,29 @@ when you explicitly want a lite-specific id.
 Run the daily workflow with `--vars '{"vdriver":"gemini"}'`. The default `vdriver` remains
 `voicebox`.
 
+### Stable persona across segments (`GEMINI_TTS_STYLE`)
+
+Gemini re-interprets its short-clip custom voice per style annotation. A script that varies
+`emotion` per segment (intro warm, news clear, commentary thoughtful, …) therefore drifts the
+persona across segment boundaries — audible as voice-identity loss and mood swings (2026-09-24
+episode review). Set one style for the whole episode to pin the persona:
+
+```yaml
+GEMINI_TTS_STYLE: calm professional podcast host, steady pace, natural conversational tone
+```
+
+When set it replaces every segment's own instruct; per-segment instructions still apply when
+unset.
+
+### Daily quota (Tier 1: ~100 requests/day)
+
+`gemini-3.8-flash-tts` on a Tier 1 key allows ~100 requests/day (UTC reset — quota 429s quote
+a retry-in horizon into the next UTC midnight). A full episode (~31 segments + QC regens ≈
+35–45 calls) essentially spends the day's budget, and the daily workflow shares it with any
+tuning run. The client caps transient 429 backoff at 120s and fails loudly when `retry-after`
+exceeds that (it used to sleep out the ~19h horizon, which looked like a wedged run —
+2026-09-24). For style/voice tuning, synthesize 2–3 segments instead of the full episode.
+
 ## Renewal
 
 A stored voice lasts 1 year (200 stored voices per project, shared with prompted voices). Before