@gobing-ai/knowledge-kit 0.0.8 → 0.0.9

package/dist/index.js

@@ -14643,6 +14643,75 @@ var init_zod = __esm(() => {
   init_external();
 });
 
+// ../../node_modules/.bun/@gobing-ai+ts-utils@0.4.39/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.4.39/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.4.39/node_modules/@gobing-ai/ts-utils/dist/cursor.js
+var init_cursor = () => {};
+
+// ../../node_modules/.bun/@gobing-ai+ts-utils@0.4.39/node_modules/@gobing-ai/ts-utils/dist/event-severity.js
+var init_event_severity = () => {};
+
+// ../../node_modules/.bun/@gobing-ai+ts-utils@0.4.39/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 echo(message, target = defaultStdoutTarget ?? processStream("stdout")) {
+  writeLine(message, target);
+}
+function echoError(message, target = defaultStderrTarget ?? processStream("stderr")) {
+  writeLine(message, target);
+}
+var defaultStdoutTarget, defaultStderrTarget;
+
+// ../../node_modules/.bun/@gobing-ai+ts-utils@0.4.39/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");
@@ -17547,15 +17616,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$/, "") ?? ""
   };
@@ -19415,7 +19484,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();
@@ -19466,9 +19535,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;
@@ -19554,7 +19623,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
@@ -19564,7 +19633,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;
@@ -19579,7 +19648,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) {
@@ -19605,7 +19674,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) {
@@ -19614,7 +19683,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":
@@ -21494,7 +21563,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();
@@ -21511,8 +21580,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;
@@ -21527,13 +21596,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;
   }
@@ -21585,12 +21654,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();
@@ -21606,9 +21675,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;
@@ -21633,10 +21702,10 @@ var init_dist = __esm(() => {
   $visitAsync = visit.visitAsync;
 });
 
-// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.4.38/node_modules/@gobing-ai/ts-runtime/dist/config.js
+// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.4.39/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({
@@ -21657,7 +21726,7 @@ var init_config = __esm(() => {
   });
 });
 
-// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.4.38/node_modules/@gobing-ai/ts-runtime/dist/file-system-node.js
+// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.4.39/node_modules/@gobing-ai/ts-runtime/dist/file-system-node.js
 import { appendFileSync, cpSync, createReadStream, createWriteStream, existsSync as existsSync2, mkdirSync, readdirSync as readdirSync2, readFileSync as readFileSync2, realpathSync as realpathSync2, renameSync, rmSync, statSync as statSync2, writeFileSync } from "fs";
 import { dirname as dirname2, resolve as resolvePath } from "path";
 function createNodeFileSystem(root, paths) {
@@ -23869,7 +23938,7 @@ var ConfigError = class extends Error {
   }
 };
 
-// ../../node_modules/.bun/@gobing-ai+ts-infra@0.4.35+233bb20824711254/node_modules/@gobing-ai/ts-infra/dist/logger.js
+// ../../node_modules/.bun/@gobing-ai+ts-infra@0.4.39+6ae14a6e2b3a5898/node_modules/@gobing-ai/ts-infra/dist/logger.js
 var ROOT_CATEGORY = "app";
 function toLogTapeLevel(level) {
   return level === "warn" ? "warning" : level;
@@ -26288,35 +26357,14 @@ function isDirectory(path2) {
 function getByName(result, name) {
   return result.plugins.find((p) => p.name === name);
 }
-// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.4.38/node_modules/@gobing-ai/ts-runtime/dist/index.js
+// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.4.39/node_modules/@gobing-ai/ts-runtime/dist/index.js
 init_file_system_node();
 init_config();
 
 // ../../packages/kk-core/src/render-md.ts
 if (false) {}
-// ../../node_modules/.bun/@gobing-ai+ts-utils@0.4.35/node_modules/@gobing-ai/ts-utils/dist/output.js
-var defaultStdoutTarget;
-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 echo(message, target = defaultStdoutTarget ?? processStream("stdout")) {
-  writeLine(message, target);
-}
-function echoError(message, target = defaultStderrTarget ?? processStream("stderr")) {
-  writeLine(message, target);
-}
-
 // src/fanin.ts
+init_dist();
 var EXIT_USAGE = 2;
 var EXIT_INPUT = 1;
 function mergeDocLists(inputs, sources) {
@@ -26439,11 +26487,13 @@ async function runFanin(argv) {
 // src/fanout.ts
 import { tmpdir } from "os";
 import { isAbsolute as isAbsolute2, join as join3, resolve as resolve4 } from "path";
+init_dist();
 
 // src/invoke.ts
 import { existsSync as existsSync3, readFileSync as readFileSync3 } from "fs";
 import { homedir as homedir2 } from "os";
 import { isAbsolute, join as join2, resolve as resolve3 } from "path";
+init_dist();
 function resolveKkConfigPath() {
   return process.env.KK_CONFIG || join2(homedir2(), ".config/kk/config.yaml");
 }
@@ -27009,8 +27059,10 @@ function registerExecutorCommand(program2) {
 // src/commands/plugin.ts
 import { existsSync as existsSync4 } from "fs";
 import { resolve as resolve5 } from "path";
+init_dist();
 
 // src/output.ts
+init_dist();
 function withoutFinalLineEnding(message) {
   return message.replace(/\r?\n$/, "");
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gobing-ai/knowledge-kit",
-    "version": "0.0.8",
+    "version": "0.0.9",
     "description": "An ingest → create → publish content pipeline CLI (Bun).",
     "repository": {
         "type": "git",
@@ -28,9 +28,9 @@
         "typecheck": "tsc --noEmit"
     },
     "dependencies": {
-        "@gobing-ai/ts-infra": "catalog:",
-        "@gobing-ai/ts-runtime": "catalog:",
-        "@gobing-ai/ts-utils": "catalog:",
+        "@gobing-ai/ts-infra": "^0.4.39",
+        "@gobing-ai/ts-runtime": "^0.4.39",
+        "@gobing-ai/ts-utils": "^0.4.39",
         "commander": "15.0.0"
     },
     "devDependencies": {

package/plugins/generations/dailynews-gen/package.json

@@ -0,0 +1,17 @@
+{
+    "name": "@gobing-ai/dailynews-gen",
+    "type": "module",
+    "private": true,
+    "scripts": {
+        "typecheck": "tsc --noEmit"
+    },
+    "dependencies": {
+        "@gobing-ai/kk-core": "workspace:*",
+        "@gobing-ai/ts-runtime": "catalog:",
+        "@gobing-ai/ts-utils": "catalog:",
+        "zod": "4.4.3"
+    },
+    "devDependencies": {
+        "@types/bun": "1.3.14"
+    }
+}

package/plugins/generations/dailynews-gen/plugin.json

@@ -0,0 +1,7 @@
+{
+    "name": "dailynews-gen",
+    "kind": "generator",
+    "entry": "./src/index.ts",
+    "version": "1.0.0",
+    "description": "Generates structured spoken broadcast VoiceScript YAML Content from AI news Doc[]"
+}

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

@@ -0,0 +1,111 @@
+import { dirname } from 'node:path';
+import { parseArgs } from 'node:util';
+import { type Content, ContentSchema, type Doc, DocListSchema } from '@gobing-ai/kk-core';
+import { createNodeFileSystem } from '@gobing-ai/ts-runtime';
+import { echoError } from '@gobing-ai/ts-utils';
+import { buildNewsVoiceScript, type ScriptBuilderOptions } from './script-builder';
+
+export * from './script-builder';
+
+export interface GeneratorOptions extends ScriptBuilderOptions {
+    in: string;
+    out: string;
+}
+
+export async function processGeneratorIO(
+    inputPath: string,
+    outputPath: string,
+    options?: ScriptBuilderOptions,
+): Promise<Content> {
+    const fs = createNodeFileSystem();
+
+    let docs: Doc[];
+    try {
+        const rawInput = await fs.readFile(inputPath);
+        docs = DocListSchema.parse(JSON.parse(rawInput));
+    } catch (err: unknown) {
+        throw new Error(`Invalid DocList input: ${err instanceof Error ? err.message : String(err)}`);
+    }
+
+    const script = buildNewsVoiceScript(docs, options);
+    const yamlBody = Bun.YAML.stringify(script);
+
+    const content: Content = {
+        title: script.title,
+        body: yamlBody,
+        format: 'markdown',
+        references: docs
+            .filter((d) => d.sourceUri)
+            .map((d) => ({
+                title: d.title,
+                url: d.sourceUri,
+            })),
+        metadata: {
+            generator: 'kk:dailynews-gen',
+            language: script.language,
+            voiceProfile: script.default_profile,
+            storyCount: docs.length,
+            stories: docs.map((d) => ({
+                id: d.id,
+                title: d.title,
+                sourceUri: d.sourceUri,
+            })),
+        },
+    };
+
+    const validatedContent = ContentSchema.parse(content);
+
+    const outDir = dirname(outputPath);
+    if (outDir && outDir !== '.') {
+        await fs.ensureDir(outDir);
+    }
+    await fs.writeFile(outputPath, JSON.stringify(validatedContent, null, 2));
+
+    return validatedContent;
+}
+
+export async function main(): Promise<number> {
+    let values: {
+        in?: string;
+        out?: string;
+        language?: string;
+        title?: string;
+        'voice-profile'?: string;
+    };
+
+    try {
+        ({ values } = parseArgs({
+            options: {
+                in: { type: 'string' },
+                out: { type: 'string' },
+                language: { type: 'string' },
+                title: { type: 'string' },
+                'voice-profile': { type: 'string' },
+            },
+        }));
+    } catch (err: unknown) {
+        echoError(`dailynews-gen failed: ${err instanceof Error ? err.message : String(err)}`);
+        return 1;
+    }
+
+    if (!values.in || !values.out) {
+        echoError('dailynews-gen failed: Missing required arguments: --in and --out');
+        return 1;
+    }
+
+    try {
+        await processGeneratorIO(values.in, values.out, {
+            language: values.language || process.env.DAILYNEWS_LANGUAGE,
+            title: values.title || process.env.DAILYNEWS_TITLE,
+            voiceProfile: values['voice-profile'] || process.env.VOICEBOX_DEFAULT_PROFILE,
+        });
+        return 0;
+    } catch (err: unknown) {
+        echoError(`dailynews-gen failed: ${err instanceof Error ? err.message : String(err)}`);
+        return 1;
+    }
+}
+
+if (import.meta.main) {
+    process.exit(await main());
+}

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

@@ -0,0 +1,121 @@
+import type { Doc } from '@gobing-ai/kk-core';
+import { z } from 'zod';
+
+export const VoiceScriptSchema = z.object({
+    title: z.string().min(1),
+    language: z.enum(['zh', 'en']),
+    default_profile: z.string().min(1).optional(),
+    segments: z
+        .array(
+            z.object({
+                text: z.string().min(1),
+                gap_ms: z.number().int().nonnegative().optional(),
+                instruct: z.string().min(1).optional(),
+            }),
+        )
+        .min(1),
+});
+
+export interface VoiceScriptSegment {
+    text: string;
+    gap_ms?: number;
+    instruct?: string;
+}
+
+export interface VoiceScript {
+    title: string;
+    language: string;
+    default_profile?: string;
+    segments: VoiceScriptSegment[];
+}
+
+export interface ScriptBuilderOptions {
+    language?: string;
+    voiceProfile?: string;
+    title?: string;
+}
+
+export function buildNewsVoiceScript(docs: Doc[], options?: ScriptBuilderOptions): VoiceScript {
+    const language = z.enum(['zh', 'en']).parse((options?.language || 'zh').toLowerCase());
+    const isZh = language === 'zh';
+    const voiceProfile = options?.voiceProfile || process.env.VOICEBOX_DEFAULT_PROFILE || 'Robin';
+
+    if (docs.length === 0) {
+        const title = options?.title || (isZh ? '今日AI快讯（暂无更新）' : 'AI Daily Briefing (No Updates)');
+        const segments: VoiceScriptSegment[] = isZh
+            ? [
+                  {
+                      text: '大家好，欢迎收听今日AI快讯。今天暂无最新的精选新闻动态。',
+                      gap_ms: 400,
+                  },
+                  {
+                      text: '感谢收听，我们下期再见。',
+                      gap_ms: 200,
+                  },
+              ]
+            : [
+                  {
+                      text: 'Hello and welcome to your AI Daily Briefing. There are no new featured stories today.',
+                      gap_ms: 400,
+                  },
+                  {
+                      text: 'Thank you for listening, and have a great day.',
+                      gap_ms: 200,
+                  },
+              ];
+
+        return VoiceScriptSchema.parse({
+            title,
+            language,
+            default_profile: voiceProfile,
+            segments,
+        });
+    }
+
+    const title =
+        options?.title || (isZh ? `今日AI快讯（共${docs.length}条）` : `AI Daily Briefing (${docs.length} stories)`);
+    const segments: VoiceScriptSegment[] = [];
+
+    // 1. Intro segment
+    const introText = isZh
+        ? `大家好，欢迎收听今日AI快讯。今天为您精选了 ${docs.length} 条重点动态，让我们快速浏览：`
+        : `Hello and welcome to your AI Daily Briefing. Here are ${docs.length} top stories for today:`;
+
+    segments.push({
+        text: introText,
+        gap_ms: 600,
+    });
+
+    // 2. Story segments
+    docs.forEach((doc, idx) => {
+        const storyIndex = idx + 1;
+        const cleanTitle = (doc.title ?? '').trim();
+        const cleanBody = (doc.body ?? '').trim();
+
+        const storyText = isZh
+            ? `第 ${storyIndex} 条动态：${cleanTitle}。${cleanBody}`
+            : `Story number ${storyIndex}: ${cleanTitle}. ${cleanBody}`;
+
+        segments.push({
+            text: storyText,
+            gap_ms: 500,
+        });
+    });
+
+    // 3. Outro segment
+    const outroText = isZh
+        ? '以上就是今天AI快讯的全部精选内容。感谢您的收听，祝您拥有高效的一天。'
+        : 'That concludes our AI Daily Briefing for today. Thanks for listening, and have a productive day.';
+
+    segments.push({
+        text: outroText,
+        gap_ms: 300,
+    });
+
+    return VoiceScriptSchema.parse({
+        title,
+        language,
+        default_profile: voiceProfile,
+        segments,
+    });
+}

package/plugins/generations/dailynews-gen/tsconfig.json

@@ -0,0 +1,4 @@
+{
+    "extends": "../../../tooling/typescript/base.json",
+    "include": ["src", "tests"]
+}

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

@@ -4,6 +4,7 @@ import { type Content, ContentSchema, type Doc, DocListSchema } from '@gobing-ai
 import { createNodeFileSystem } from '@gobing-ai/ts-runtime';
 import { echoError } from '@gobing-ai/ts-utils';
 import { concatWavs } from './concat';
+import { isMp3Requested, type Mp3Transcoder, transcodeWavToMp3 } from './mp3';
 import { createVoiceboxClient, type VoiceboxClient, type VoiceboxGenerateBody } from './voicebox-client';
 import {
     mergeVoiceScripts,
@@ -18,6 +19,7 @@ import {
 } from './voicescript';
 
 export * from './concat';
+export * from './mp3';
 export * from './voicebox-client';
 export * from './voicescript';
 
@@ -35,15 +37,19 @@ export async function processGeneratorIO(
     inputPath: string,
     outputPath: string,
     clientOverride?: VoiceboxClient,
+    transcodeMp3?: Mp3Transcoder,
 ): Promise<void> {
     const fs = createNodeFileSystem();
     const outDir = dirname(outputPath);
     const outStem = basename(outputPath, extname(outputPath));
     const audioPath = resolve(join(outDir, `${outStem}.wav`));
+    const mp3Path = resolve(join(outDir, `${outStem}.mp3`));
+    const wantMp3 = isMp3Requested();
 
-    // Delete existing output and sibling WAV at start
+    // Delete existing output and sibling audio at start
     await fs.deleteFile(outputPath);
     await fs.deleteFile(audioPath);
+    await fs.deleteFile(mp3Path);
 
     let docs: Doc[];
     try {
@@ -163,18 +169,26 @@ export async function processGeneratorIO(
         await fs.ensureDir(outDir);
         await Bun.write(audioPath, concatenatedWav);
 
+        const metadata: Record<string, unknown> = {
+            generator: 'kk:voice-gen',
+            audioPath,
+            duration: totalDuration,
+            segments: segmentMetadata,
+        };
+
+        if (wantMp3) {
+            const transcode = transcodeMp3 ?? transcodeWavToMp3;
+            await transcode(audioPath, mp3Path);
+            metadata.mp3Path = mp3Path;
+        }
+
         // 6. Build Content
         const content: Content = {
             title: combinedScript.title || docs[0]?.title || 'Generated voice',
             body: Bun.YAML.stringify(combinedScript),
             format: 'audio',
             references: [],
-            metadata: {
-                generator: 'kk:voice-gen',
-                audioPath,
-                duration: totalDuration,
-                segments: segmentMetadata,
-            },
+            metadata,
         };
 
         const validatedContent = ContentSchema.parse(content);
@@ -182,6 +196,7 @@ export async function processGeneratorIO(
     } catch (err: unknown) {
         await fs.deleteFile(outputPath);
         await fs.deleteFile(audioPath);
+        await fs.deleteFile(mp3Path);
         throw err;
     }
 }

package/plugins/generations/voice-gen/src/mp3.ts

@@ -0,0 +1,65 @@
+import { createNodeFileSystem } from '@gobing-ai/ts-runtime';
+
+const MP3_TRUTHY = new Set(['1', 'true', 'yes', 'on']);
+
+/** True when the operator asked for a sibling MP3 (`VOICE_GEN_MP3=true|1|yes|on`). */
+export function isMp3Requested(env: NodeJS.ProcessEnv = process.env): boolean {
+    const raw = env.VOICE_GEN_MP3;
+    if (raw === undefined || raw === '') {
+        return false;
+    }
+    return MP3_TRUTHY.has(raw.trim().toLowerCase());
+}
+
+/** WAV → MP3. Injected in tests so CI does not need ffmpeg. */
+export type Mp3Transcoder = (wavPath: string, mp3Path: string) => Promise<void>;
+
+/**
+ * Convert a workspace WAV to MP3 with ffmpeg + libmp3lame (VBR `-qscale:a 2`).
+ * Fail-loud if ffmpeg is missing, exits non-zero, or writes no file.
+ */
+export async function transcodeWavToMp3(wavPath: string, mp3Path: string, ffmpegBin = 'ffmpeg'): Promise<void> {
+    const fs = createNodeFileSystem();
+    if (!(await fs.exists(wavPath))) {
+        throw new Error(`ffmpeg mp3 transcode failed: WAV input not found: ${wavPath}`);
+    }
+
+    let proc: ReturnType<typeof Bun.spawnSync>;
+    try {
+        proc = Bun.spawnSync(
+            [
+                ffmpegBin,
+                '-y',
+                '-hide_banner',
+                '-loglevel',
+                'error',
+                '-i',
+                wavPath,
+                '-codec:a',
+                'libmp3lame',
+                '-qscale:a',
+                '2',
+                mp3Path,
+            ],
+            { stdout: 'pipe', stderr: 'pipe' },
+        );
+    } catch (err: unknown) {
+        throw new Error(
+            `ffmpeg is required for MP3 output (VOICE_GEN_MP3=true) but was not found on PATH (${err instanceof Error ? err.message : String(err)})`,
+        );
+    }
+
+    if (proc.exitCode !== 0) {
+        const detail = (proc.stderr?.toString() ?? '').trim() || (proc.stdout?.toString() ?? '').trim();
+        if (proc.exitCode === null || /not found|ENOENT/i.test(detail)) {
+            throw new Error(
+                `ffmpeg is required for MP3 output (VOICE_GEN_MP3=true) but was not found on PATH${detail ? `: ${detail}` : ''}`,
+            );
+        }
+        throw new Error(`ffmpeg mp3 transcode failed (exit ${proc.exitCode}): ${detail || 'no stderr'}`);
+    }
+
+    if (!(await fs.exists(mp3Path))) {
+        throw new Error(`ffmpeg mp3 transcode produced no file: ${mp3Path}`);
+    }
+}

package/plugins/ingestions/aihot-ingest/package.json

@@ -0,0 +1,17 @@
+{
+    "name": "@gobing-ai/aihot-ingest",
+    "type": "module",
+    "private": true,
+    "scripts": {
+        "typecheck": "tsc --noEmit"
+    },
+    "dependencies": {
+        "@gobing-ai/kk-core": "workspace:*",
+        "@gobing-ai/ts-runtime": "catalog:",
+        "@gobing-ai/ts-utils": "catalog:",
+        "zod": "4.4.3"
+    },
+    "devDependencies": {
+        "@types/bun": "1.3.14"
+    }
+}

package/plugins/ingestions/aihot-ingest/plugin.json

@@ -0,0 +1,7 @@
+{
+    "name": "aihot-ingest",
+    "kind": "ingestion",
+    "entry": "./src/index.ts",
+    "version": "1.0.0",
+    "description": "Ingests curated AI news items from aihot.virxact.com into Doc[]"
+}

package/plugins/ingestions/aihot-ingest/src/client.ts

@@ -0,0 +1,185 @@
+import { echoError } from '@gobing-ai/ts-utils';
+import { z } from 'zod';
+
+export const AIHOT_BASE_URL = 'https://aihot.virxact.com';
+export const DEFAULT_AIHOT_USER_AGENT = 'aihot-ingest/1.0.0';
+
+export const AihotItemSchema = z.object({
+    id: z.string(),
+    title: z.string(),
+    originalTitle: z.string().nullable(),
+    summary: z.string().nullable(),
+    source: z.object({ name: z.string() }),
+    links: z.object({
+        aihot: z.url(),
+        original: z.url(),
+    }),
+    publishedAt: z.iso.datetime().nullable(),
+    discoveredAt: z.iso.datetime(),
+    category: z.string().nullable(),
+    score: z.number().min(0).max(100).nullable(),
+    selected: z.boolean(),
+    reason: z.string().nullable().optional(),
+    attribution: z
+        .object({
+            name: z.string(),
+            url: z.url(),
+        })
+        .optional(),
+});
+
+export type AihotItem = z.infer<typeof AihotItemSchema>;
+
+export const AihotSnapshotResponseSchema = z.object({
+    schemaVersion: z.literal(1),
+    asOf: z.iso.datetime(),
+    fields: z.literal('default'),
+    cursor: z.string(),
+    count: z.number().int().nonnegative(),
+    hasMore: z.boolean(),
+    nextPage: z.string().nullable(),
+    items: z.array(AihotItemSchema),
+});
+
+export type AihotSnapshotResponse = z.infer<typeof AihotSnapshotResponseSchema>;
+
+const AihotSnapshotEnvelopeSchema = AihotSnapshotResponseSchema.extend({
+    items: z.array(z.unknown()),
+});
+
+export const AihotChangeSchema = z.discriminatedUnion('op', [
+    z.object({
+        op: z.literal('upsert'),
+        item: AihotItemSchema,
+        changedAt: z.iso.datetime(),
+    }),
+    z.object({
+        op: z.literal('remove'),
+        id: z.string(),
+        changedAt: z.iso.datetime(),
+    }),
+]);
+
+export const AihotChangesResponseSchema = z.object({
+    schemaVersion: z.literal(1),
+    fields: z.literal('default'),
+    cursor: z.string(),
+    count: z.number().int().nonnegative(),
+    hasMore: z.boolean(),
+    changes: z.array(AihotChangeSchema),
+});
+
+export type AihotChangesResponse = z.infer<typeof AihotChangesResponseSchema>;
+
+const AihotChangesEnvelopeSchema = AihotChangesResponseSchema.extend({
+    changes: z.array(z.unknown()),
+});
+
+export type FetchLike = (url: string | URL | Request, init?: RequestInit) => Promise<Response>;
+
+export interface AihotDeps {
+    fetch: FetchLike;
+    baseUrl?: string;
+    userAgent?: string;
+    warn?: (message: string) => void;
+}
+
+export interface FetchSnapshotOptions {
+    limit?: number;
+    page?: string;
+}
+
+export interface FetchChangesOptions {
+    cursor: string;
+    limit?: number;
+}
+
+export class AihotClient {
+    private readonly fetch: FetchLike;
+    private readonly baseUrl: string;
+    private readonly userAgent: string;
+    private readonly warn: (message: string) => void;
+
+    constructor(deps?: Partial<AihotDeps>) {
+        this.fetch = deps?.fetch ?? globalThis.fetch;
+        this.baseUrl = (deps?.baseUrl ?? AIHOT_BASE_URL).replace(/\/+$/, '');
+        this.userAgent = deps?.userAgent ?? DEFAULT_AIHOT_USER_AGENT;
+        this.warn = deps?.warn ?? echoError;
+    }
+
+    public async fetchSnapshot(options?: FetchSnapshotOptions): Promise<AihotSnapshotResponse> {
+        const url = new URL(`${this.baseUrl}/api/v1/selected/snapshot`);
+        if (options?.limit !== undefined) {
+            url.searchParams.set('limit', String(options.limit));
+        }
+        if (options?.page) {
+            url.searchParams.set('page', options.page);
+        }
+        url.searchParams.set('fields', 'default');
+
+        const res = await this.fetch(url.toString(), {
+            method: 'GET',
+            headers: {
+                Accept: 'application/json',
+                'User-Agent': this.userAgent,
+            },
+        });
+
+        if (!res.ok) {
+            const errBody = (await res.text()).slice(0, 1000);
+            throw new Error(
+                `aihot snapshot request failed (HTTP ${res.status} ${res.statusText}): ${errBody || 'Unknown error'}`,
+            );
+        }
+
+        const response = AihotSnapshotEnvelopeSchema.parse(await res.json());
+        return {
+            ...response,
+            items: this.parseRecords(response.items, AihotItemSchema, 'snapshot item'),
+        };
+    }
+
+    public async fetchChanges(options: FetchChangesOptions): Promise<AihotChangesResponse> {
+        const url = new URL(`${this.baseUrl}/api/v1/selected/changes`);
+        url.searchParams.set('cursor', options.cursor);
+        if (options.limit !== undefined) {
+            url.searchParams.set('limit', String(options.limit));
+        }
+
+        const res = await this.fetch(url.toString(), {
+            method: 'GET',
+            headers: {
+                Accept: 'application/json',
+                'User-Agent': this.userAgent,
+            },
+        });
+
+        if (!res.ok) {
+            const errBody = (await res.text()).slice(0, 1000);
+            throw new Error(
+                `aihot changes request failed (HTTP ${res.status} ${res.statusText}): ${errBody || 'Unknown error'}`,
+            );
+        }
+
+        const response = AihotChangesEnvelopeSchema.parse(await res.json());
+        return {
+            ...response,
+            changes: this.parseRecords(response.changes, AihotChangeSchema, 'change record'),
+        };
+    }
+
+    private parseRecords<T>(records: unknown[], schema: z.ZodType<T>, label: string): T[] {
+        return records.flatMap((record, index) => {
+            const result = schema.safeParse(record);
+            if (result.success) return [result.data];
+
+            const details = result.error.issues.map((issue) => `${issue.path.join('.') || '<root>'}: ${issue.message}`);
+            this.warn(`aihot: skipping invalid ${label} at index ${index} (${details.join('; ')})`);
+            return [];
+        });
+    }
+}
+
+export function createAihotClient(deps?: Partial<AihotDeps>): AihotClient {
+    return new AihotClient(deps);
+}

package/plugins/ingestions/aihot-ingest/src/index.ts

@@ -0,0 +1,137 @@
+import { dirname } from 'node:path';
+import { parseArgs } from 'node:util';
+import { type Doc, DocListSchema } from '@gobing-ai/kk-core';
+import { atomicWriteJson, createNodeFileSystem, readJsonFile } from '@gobing-ai/ts-runtime';
+import { echoError } from '@gobing-ai/ts-utils';
+import { z } from 'zod';
+import { type AihotDeps, createAihotClient } from './client';
+import { mapAihotItemsToDocs } from './mapper';
+
+export * from './client';
+export * from './mapper';
+
+export interface IngestionOptions {
+    out: string;
+    limit?: number;
+    cursor?: string;
+    stateFile?: string;
+}
+
+export interface IngestionResult {
+    docs: Doc[];
+    cursor: string;
+    asOf?: string;
+}
+
+const IngestionInputSchema = z.object({
+    limit: z.number().int().min(1).max(100).optional(),
+    cursor: z.string().trim().min(1).optional(),
+    stateFile: z.string().trim().min(1).optional(),
+});
+
+const CursorStateSchema = z.object({ cursor: z.string().trim().min(1) });
+
+function parseLimit(value: string): number {
+    return z.coerce.number().int().min(1).max(100).parse(value);
+}
+
+export async function processIngestionIO(
+    options: IngestionOptions,
+    depsOverride?: Partial<AihotDeps>,
+): Promise<IngestionResult> {
+    const fs = createNodeFileSystem();
+    const client = createAihotClient(depsOverride);
+
+    let effectiveCursor = options.cursor?.trim();
+    if (!effectiveCursor && options.stateFile && (await fs.exists(options.stateFile))) {
+        effectiveCursor = CursorStateSchema.parse(await readJsonFile(options.stateFile, fs)).cursor;
+    }
+
+    let items: import('./client').AihotItem[];
+    let cursor: string;
+    let asOf: string | undefined;
+
+    if (effectiveCursor) {
+        const changes = await client.fetchChanges({
+            cursor: effectiveCursor,
+            limit: options.limit,
+        });
+        items = changes.changes.flatMap((change) => (change.op === 'upsert' ? [change.item] : []));
+        cursor = changes.cursor;
+    } else {
+        const snapshot = await client.fetchSnapshot({
+            limit: options.limit,
+        });
+        items = snapshot.items;
+        cursor = snapshot.cursor;
+        asOf = snapshot.asOf;
+    }
+
+    const docs = DocListSchema.parse(mapAihotItemsToDocs(items));
+
+    const outDir = dirname(options.out);
+    if (outDir && outDir !== '.') {
+        await fs.ensureDir(outDir);
+    }
+    await atomicWriteJson(options.out, docs, fs);
+
+    if (options.stateFile) {
+        const stateDir = dirname(options.stateFile);
+        if (stateDir && stateDir !== '.') {
+            await fs.ensureDir(stateDir);
+        }
+        const statePayload = {
+            cursor,
+            asOf,
+            lastSyncAt: new Date().toISOString(),
+            itemCount: docs.length,
+        };
+        await atomicWriteJson(options.stateFile, statePayload, fs);
+    }
+
+    return { docs, cursor, asOf };
+}
+
+export async function main(depsOverride?: Partial<AihotDeps>): Promise<number> {
+    let values: { in?: string; out?: string; limit?: string; cursor?: string; 'state-file'?: string };
+    try {
+        ({ values } = parseArgs({
+            options: {
+                in: { type: 'string' },
+                out: { type: 'string' },
+                limit: { type: 'string' },
+                cursor: { type: 'string' },
+                'state-file': { type: 'string' },
+            },
+        }));
+    } catch (err: unknown) {
+        echoError(`aihot-ingest failed: ${err instanceof Error ? err.message : String(err)}`);
+        return 1;
+    }
+
+    if (!values.out) {
+        echoError('aihot-ingest failed: Missing required argument: --out');
+        return 1;
+    }
+
+    try {
+        const input = values.in ? IngestionInputSchema.parse(await readJsonFile(values.in)) : {};
+        await processIngestionIO(
+            {
+                out: values.out,
+                limit: values.limit ? parseLimit(values.limit) : (input.limit ?? 10),
+                cursor: values.cursor ?? input.cursor,
+                stateFile: values['state-file'] ?? input.stateFile,
+            },
+            depsOverride,
+        );
+        return 0;
+    } catch (err: unknown) {
+        echoError(`aihot-ingest failed: ${err instanceof Error ? err.message : String(err)}`);
+        return 1;
+    }
+}
+
+if (import.meta.main) {
+    process.exit(await main());
+}

package/plugins/ingestions/aihot-ingest/src/mapper.ts

@@ -0,0 +1,42 @@
+import { createHash } from 'node:crypto';
+import type { Doc } from '@gobing-ai/kk-core';
+import type { AihotItem } from './client';
+
+export function computeDocId(seed: string): string {
+    return createHash('sha256').update(seed).digest('hex').slice(0, 16);
+}
+
+export function mapAihotItemToDoc(item: AihotItem): Doc {
+    const rawId = item.id.trim();
+    const canonicalSource = item.links.original || item.links.aihot || item.title || 'untitled';
+    const id = rawId.length > 0 ? rawId : computeDocId(canonicalSource);
+
+    const sourceUri = item.links?.original || item.links?.aihot || `https://aihot.virxact.com/items/${id}`;
+    const title = item.title.trim() || 'Untitled AI News';
+    const body = `${item.summary?.trim() || item.title.trim()}\n`;
+
+    const metadata: Record<string, unknown> = {
+        sourceName: item.source.name,
+        publishedAt: item.publishedAt,
+        discoveredAt: item.discoveredAt,
+        category: item.category ?? undefined,
+        score: item.score ?? undefined,
+        aihotUrl: item.links.aihot,
+        originalUrl: item.links.original,
+        attribution: item.attribution,
+        reason: item.reason ?? undefined,
+    };
+
+    return {
+        id,
+        title,
+        sourceUri,
+        body,
+        mediaType: 'text/markdown',
+        metadata,
+    };
+}
+
+export function mapAihotItemsToDocs(items: AihotItem[]): Doc[] {
+    return items.map(mapAihotItemToDoc);
+}

package/plugins/ingestions/aihot-ingest/tsconfig.json

@@ -0,0 +1,4 @@
+{
+    "extends": "../../../tooling/typescript/base.json",
+    "include": ["src", "tests"]
+}

package/plugins/ingestions/web-search/src/index.ts

@@ -356,7 +356,7 @@ export function parseInput(raw: string): InInput {
     return { topic: input.topic, maxResults, fixture: input.fixture === true };
 }
 
-export async function main(): Promise<number> {
+export async function main(depsOverride?: Partial<SearchDeps>): Promise<number> {
     const fs = createNodeFileSystem();
     const { values } = parseArgs({
         options: {
@@ -385,6 +385,7 @@ export async function main(): Promise<number> {
                 fetch: globalThis.fetch,
                 env: process.env,
                 now: () => new Date(),
+                ...depsOverride,
             };
             // Bun.which with an explicit PATH — without the option it can ignore runtime
             // process.env.PATH changes (observed on Bun 1.3.14).

package/plugins/kk/workflows/kk-daily-ai-voice.yaml

@@ -0,0 +1,144 @@
+---
+"$schema": "@gobing-ai/spur/schemas/state-machine-workflow.schema.json"
+name: kk-daily-ai-voice
+kind: state-machine
+description: >-
+  Daily AI news broadcast pipeline orchestrating aihot-ingest, dailynews-gen, and voice-gen
+initialState: prepare
+terminalStates:
+  - done
+  - failed
+failureStates:
+  - failed
+
+vars:
+  work_dir: ""
+  limit: "10"
+  language: "zh"
+  voice_profile: "Robin"
+  title: ""
+  cursor: ""
+  state_file: ""
+  skip_review: "false"
+  transcode_mp3: "false"
+  plugins_path: ""
+  __hitlAnswer: ""
+
+states:
+  - id: prepare
+    description: "Create workspace subdirectories and validate parameters"
+    onEnter:
+      - kind: shell
+        options:
+          command: >-
+            test -n "${vars.work_dir}" || { echo "missing required variable: work_dir" >&2 && exit 1; };
+            mkdir -p "${vars.work_dir}" "${vars.work_dir}/1-ingest" "${vars.work_dir}/2-script" "${vars.work_dir}/3-audio";
+            bun -e 'await Bun.write(process.argv[1], JSON.stringify({ limit: Number(process.argv[2]), cursor: process.argv[3] || undefined, stateFile: process.argv[4] || undefined }, null, 2))' "${vars.work_dir}/1-ingest/source.json" "${vars.limit}" "${vars.cursor}" "${vars.state_file}"
+
+  - id: fetch
+    description: "Ingest latest curated AI news from aihot.virxact.com"
+    onEnter:
+      - kind: shell
+        options:
+          command: >-
+            set --;
+            if [ -n "${vars.plugins_path}" ]; then set -- --plugins-path "${vars.plugins_path}"; fi;
+            kk executor run aihot-ingest --in "${vars.work_dir}/1-ingest/source.json" --out "${vars.work_dir}/1-ingest/docs.json" "$@"
+
+  - id: script
+    description: "Compile news Doc[] into structured broadcast VoiceScript YAML Content"
+    onEnter:
+      - kind: shell
+        options:
+          command: >-
+            set --;
+            if [ -n "${vars.plugins_path}" ]; then set -- --plugins-path "${vars.plugins_path}"; fi;
+            DAILYNEWS_LANGUAGE="${vars.language}" DAILYNEWS_TITLE="${vars.title}" VOICEBOX_DEFAULT_PROFILE="${vars.voice_profile}" kk executor run dailynews-gen --in "${vars.work_dir}/1-ingest/docs.json" --out "${vars.work_dir}/2-script/content.json" "$@" &&
+            bun -e 'await Bun.write(process.argv[2], (await Bun.file(process.argv[1]).json()).body)' "${vars.work_dir}/2-script/content.json" "${vars.work_dir}/2-script/voicescript.yaml"
+
+  - id: review
+    description: "Operator reviews the generated news script before speech synthesis"
+    pause: true
+    onEnter:
+      - kind: hitl.confirm
+        options:
+          prompt: "Review daily AI news VoiceScript at ${vars.work_dir}/2-script/voicescript.yaml. Proceed to voice generation?"
+          var: __hitlAnswer
+
+  - id: wrap-docs
+    description: "Wrap VoiceScript into Doc[] input for voice-gen"
+    onEnter:
+      - kind: shell
+        options:
+          command: >-
+            bun -e 'const scriptUrl = new URL(process.argv[1], "file://" + process.cwd() + "/"); const scriptPath = decodeURIComponent(scriptUrl.pathname); const doc = { id: new Bun.CryptoHasher("sha256").update(scriptUrl.href).digest("hex").slice(0, 16), title: "Daily AI News VoiceScript", sourceUri: scriptUrl.href, body: await Bun.file(scriptPath).text(), mediaType: "application/yaml", metadata: { voiceProfile: process.argv[3] || process.env.VOICEBOX_DEFAULT_PROFILE || "Robin" } }; await Bun.write(process.argv[2], JSON.stringify([doc], null, 2))' "${vars.work_dir}/2-script/voicescript.yaml" "${vars.work_dir}/3-audio/docs.json" "${vars.voice_profile}"
+
+  - id: generate
+    description: "Invoke voice-gen generator plugin to generate audio"
+    onEnter:
+      - kind: shell
+        options:
+          command: >-
+            set --;
+            if [ -n "${vars.plugins_path}" ]; then set -- --plugins-path "${vars.plugins_path}"; fi;
+            VOICE_GEN_MP3="${vars.transcode_mp3}" kk executor run voice-gen --in "${vars.work_dir}/3-audio/docs.json" --out "${vars.work_dir}/3-audio/content.json" "$@"
+
+  - id: done
+    description: "Terminal — Daily AI news voice broadcast generated successfully"
+  - id: failed
+    description: "Terminal — Pipeline failed"
+
+transitions:
+  - from: prepare
+    to: fetch
+    description: "Workspace prepared -> fetch news items"
+    guard:
+      kind: always
+
+  - from: fetch
+    to: script
+    description: "News ingested -> build broadcast script"
+    guard:
+      kind: always
+
+  - from: script
+    to: wrap-docs
+    description: "skip_review enabled -> bypass HITL review"
+    guard:
+      kind: shell
+      options:
+        command: 'test "${vars.skip_review}" = "true"'
+
+  - from: script
+    to: review
+    description: "skip_review disabled -> pause for operator review"
+    guard:
+      kind: always
+
+  - from: review
+    to: wrap-docs
+    description: "VoiceScript approved -> wrap for audio generation"
+    guard:
+      kind: shell
+      options:
+        command: 'test "${vars.__hitlAnswer}" = "yes"'
+
+  - from: review
+    to: failed
+    description: "VoiceScript rejected -> abort"
+    guard:
+      kind: shell
+      options:
+        command: 'test "${vars.__hitlAnswer}" = "no"'
+
+  - from: wrap-docs
+    to: generate
+    description: "Doc[] wrapped -> synthesize audio"
+    guard:
+      kind: always
+
+  - from: generate
+    to: done
+    description: "Audio generated successfully -> complete"
+    guard:
+      kind: always

package/plugins/publishings/surfdash-pub/src/index.ts

@@ -87,7 +87,7 @@ export class PostsurfingFileCliTransport implements PublishTransport {
 
     public async publish(payload: PublishTransportPayload): Promise<Result> {
         const markdown = mapContentToSurfingMarkdown(payload.content);
-        const tempDir = join(process.cwd(), '.tmp-surfdash');
+        const tempDir = join(process.cwd(), '.spur', 'run', '.tmp-surfdash');
         await createNodeFileSystem().ensureDir(tempDir);
 
         const titleSlug = slugify(payload.content.title ?? 'post');