@gobing-ai/knowledge-kit 0.0.17 → 0.0.19

package/plugins/publishings/podcast-pub/dist/index.js

@@ -14642,72 +14642,6 @@ 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 echoError(message, target = defaultStderrTarget ?? processStream("stderr")) {
-  writeLine(message, target);
-}
-var 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");
@@ -17612,15 +17546,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 date6 = Date.UTC(year, month - 1, day, hour || 0, minute || 0, second || 0, millisec);
+      let date5 = 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;
-        date6 -= 60000 * d;
+        date5 -= 60000 * d;
       }
-      return new Date(date6);
+      return new Date(date5);
     },
     stringify: ({ value }) => value?.toISOString().replace(/(T00:00:00)?\.000Z$/, "") ?? ""
   };
@@ -19480,7 +19414,7 @@ var require_composer = __commonJS((exports) => {
   var node_process = __require("process");
   var directives = require_directives();
   var Document = require_Document();
-  var errors4 = require_errors();
+  var errors3 = require_errors();
   var identity = require_identity();
   var composeDoc = require_compose_doc();
   var resolveEnd = require_resolve_end();
@@ -19531,9 +19465,9 @@ var require_composer = __commonJS((exports) => {
       this.onError = (source, code, message, warning) => {
         const pos = getErrorPos(source);
         if (warning)
-          this.warnings.push(new errors4.YAMLWarning(pos, code, message));
+          this.warnings.push(new errors3.YAMLWarning(pos, code, message));
         else
-          this.errors.push(new errors4.YAMLParseError(pos, code, message));
+          this.errors.push(new errors3.YAMLParseError(pos, code, message));
       };
       this.directives = new directives.Directives({ version: options.version || "1.2" });
       this.options = options;
@@ -19619,7 +19553,7 @@ ${cb}` : comment;
           break;
         case "error": {
           const msg = token.source ? `${token.message}: ${JSON.stringify(token.source)}` : token.message;
-          const error51 = new errors4.YAMLParseError(getErrorPos(token), "UNEXPECTED_TOKEN", msg);
+          const error51 = new errors3.YAMLParseError(getErrorPos(token), "UNEXPECTED_TOKEN", msg);
           if (this.atDirectives || !this.doc)
             this.errors.push(error51);
           else
@@ -19629,7 +19563,7 @@ ${cb}` : comment;
         case "doc-end": {
           if (!this.doc) {
             const msg = "Unexpected doc-end without preceding document";
-            this.errors.push(new errors4.YAMLParseError(getErrorPos(token), "UNEXPECTED_TOKEN", msg));
+            this.errors.push(new errors3.YAMLParseError(getErrorPos(token), "UNEXPECTED_TOKEN", msg));
             break;
           }
           this.doc.directives.docEnd = true;
@@ -19644,7 +19578,7 @@ ${end.comment}` : end.comment;
           break;
         }
         default:
-          this.errors.push(new errors4.YAMLParseError(getErrorPos(token), "UNEXPECTED_TOKEN", `Unsupported token ${token.type}`));
+          this.errors.push(new errors3.YAMLParseError(getErrorPos(token), "UNEXPECTED_TOKEN", `Unsupported token ${token.type}`));
       }
     }
     *end(forceDoc = false, endOffset = -1) {
@@ -19670,7 +19604,7 @@ ${end.comment}` : end.comment;
 var require_cst_scalar = __commonJS((exports) => {
   var resolveBlockScalar = require_resolve_block_scalar();
   var resolveFlowScalar = require_resolve_flow_scalar();
-  var errors4 = require_errors();
+  var errors3 = require_errors();
   var stringifyString = require_stringifyString();
   function resolveAsScalar(token, strict = true, onError) {
     if (token) {
@@ -19679,7 +19613,7 @@ var require_cst_scalar = __commonJS((exports) => {
         if (onError)
           onError(offset, code, message);
         else
-          throw new errors4.YAMLParseError([offset, offset + 1], code, message);
+          throw new errors3.YAMLParseError([offset, offset + 1], code, message);
       };
       switch (token.type) {
         case "scalar":
@@ -21559,7 +21493,7 @@ var require_parser = __commonJS((exports) => {
 var require_public_api = __commonJS((exports) => {
   var composer = require_composer();
   var Document = require_Document();
-  var errors4 = require_errors();
+  var errors3 = require_errors();
   var log = require_log();
   var identity = require_identity();
   var lineCounter = require_line_counter();
@@ -21576,8 +21510,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(errors4.prettifyError(source, lineCounter2));
-        doc2.warnings.forEach(errors4.prettifyError(source, lineCounter2));
+        doc2.errors.forEach(errors3.prettifyError(source, lineCounter2));
+        doc2.warnings.forEach(errors3.prettifyError(source, lineCounter2));
       }
     if (docs.length > 0)
       return docs;
@@ -21592,13 +21526,13 @@ var require_public_api = __commonJS((exports) => {
       if (!doc2)
         doc2 = _doc;
       else if (doc2.options.logLevel !== "silent") {
-        doc2.errors.push(new errors4.YAMLParseError(_doc.range.slice(0, 2), "MULTIPLE_DOCS", "Source contains multiple documents; please use YAML.parseAllDocuments()"));
+        doc2.errors.push(new errors3.YAMLParseError(_doc.range.slice(0, 2), "MULTIPLE_DOCS", "Source contains multiple documents; please use YAML.parseAllDocuments()"));
         break;
       }
     }
     if (prettyErrors && lineCounter2) {
-      doc2.errors.forEach(errors4.prettifyError(source, lineCounter2));
-      doc2.warnings.forEach(errors4.prettifyError(source, lineCounter2));
+      doc2.errors.forEach(errors3.prettifyError(source, lineCounter2));
+      doc2.warnings.forEach(errors3.prettifyError(source, lineCounter2));
     }
     return doc2;
   }
@@ -21650,12 +21584,12 @@ var require_public_api = __commonJS((exports) => {
 });
 
 // ../../node_modules/.bun/yaml@2.9.0/node_modules/yaml/dist/index.js
-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(() => {
+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(() => {
   composer = require_composer();
   Document = require_Document();
   Schema = require_Schema();
-  errors4 = require_errors();
+  errors3 = require_errors();
   Alias = require_Alias();
   identity = require_identity();
   Pair = require_Pair();
@@ -21671,9 +21605,9 @@ var init_dist2 = __esm(() => {
   $Composer = composer.Composer;
   $Document = Document.Document;
   $Schema = Schema.Schema;
-  $YAMLError = errors4.YAMLError;
-  $YAMLParseError = errors4.YAMLParseError;
-  $YAMLWarning = errors4.YAMLWarning;
+  $YAMLError = errors3.YAMLError;
+  $YAMLParseError = errors3.YAMLParseError;
+  $YAMLWarning = errors3.YAMLWarning;
   $Alias = Alias.Alias;
   $isAlias = identity.isAlias;
   $isCollection = identity.isCollection;
@@ -21701,7 +21635,7 @@ var init_dist2 = __esm(() => {
 // ../../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_dist2();
+  init_dist();
   init_zod();
   configSchema = exports_external.object({
     app: exports_external.object({
@@ -21810,6 +21744,7 @@ function findProjectRoot(startDir) {
 var init_file_system_node = () => {};
 
 // ../../plugins/publishings/podcast-pub/src/index.ts
+import { readFileSync as readFileSync2 } from "fs";
 import { readFile } from "fs/promises";
 import { dirname as dirname2 } from "path";
 import { parseArgs } from "util";
@@ -21888,6 +21823,24 @@ var PluginManifestSchema = exports_external.object({
 init_file_system_node();
 init_config();
 
+// ../../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) {}
 // ../../packages/publish-harness/src/index.ts
@@ -21926,9 +21879,6 @@ class FakeFileCliTransport {
   }
 }
 
-// ../../plugins/publishings/podcast-pub/src/index.ts
-init_dist();
-
 // ../../plugins/publishings/podcast-pub/src/show-notes.ts
 function escapeHtml(value) {
   return value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;");
@@ -21945,8 +21895,80 @@ function renderInline(escaped) {
   }
   return (out + rest).replace(/\*\*([^*]+)\*\*/g, "<strong>$1</strong>");
 }
+function normalizeForMatch(text) {
+  return text.toLowerCase().replace(/[^\p{Script=Han}\p{L}\p{N}]+/gu, "");
+}
+function formatOffset(seconds) {
+  if (!Number.isFinite(seconds) || seconds < 0)
+    return "--:--";
+  const m = Math.floor(seconds / 60);
+  const s = Math.round(seconds % 60);
+  return s === 60 ? `${m + 1}:00` : `${m}:${String(s).padStart(2, "0")}`;
+}
+function computeAudioOffsets(docs, segments) {
+  const fallback = () => {
+    const chars = docs.map((d) => Math.max((d.body ?? "").trim().length, 1));
+    const total = chars.reduce((a, b) => a + b, 0);
+    const sumDuration = (segments ?? []).reduce((a, s) => a + (s.duration ?? 0), 0);
+    let acc = 0;
+    return chars.map((c) => {
+      const at = acc;
+      acc += c / total * sumDuration;
+      return at;
+    });
+  };
+  if (!segments || segments.length < 2)
+    return fallback();
+  const starts = [];
+  let elapsed = 0;
+  const marks = segments.map((s) => {
+    const at = elapsed;
+    elapsed += s.duration ?? 0;
+    return { at, text: normalizeForMatch(s.transcription ?? "") };
+  });
+  let cursor = 1;
+  for (const d of docs) {
+    const title = normalizeForMatch(d.title ?? "");
+    const needle = title.slice(0, 12);
+    const hit = needle.length >= 4 ? marks.findIndex((m, i) => i >= cursor && m.text.includes(needle)) : -1;
+    if (hit >= 0) {
+      starts.push(marks[hit]?.at ?? 0);
+      cursor = hit + 1;
+    } else {
+      starts.push(Number.NaN);
+    }
+  }
+  if (starts.some((v) => !Number.isFinite(v)))
+    return fallback();
+  return starts;
+}
+function renderTimelineHtml(docs, offsets, articleUrl) {
+  const rows = docs.map((d, i) => {
+    const title = escapeHtml(d.title ?? `\u6761\u76EE ${i + 1}`);
+    const brief = escapeHtml(itemBrief(d));
+    const at = formatOffset(offsets[i] ?? Number.NaN);
+    const link = d.sourceUri ? ` <a href="${escapeHtml(d.sourceUri)}" target="_blank" rel="noopener">\u6765\u6E90</a>` : "";
+    return `
+    <div class="kk-tl-row"><div class="kk-tl-t">${at}</div><div class="kk-tl-body"><div class="kk-tl-title">${i + 1}. ${title}${link}</div><p class="kk-tl-brief">${brief}</p></div></div>`;
+  }).join("");
+  return `<!--kk:timeline-->
+<style>
+.kk-tl{margin:1em 0}
+.kk-tl-row{display:flex;gap:12px;padding:10px 0;border-bottom:1px solid rgba(128,128,128,.25)}
+.kk-tl-t{flex:0 0 56px;font-variant-numeric:tabular-nums;font-weight:700;color:#0969da}
+.kk-tl-body{flex:1;min-width:0}
+.kk-tl-title{font-weight:600}
+.kk-tl-brief{margin:4px 0 0;color:#666;font-size:.95em}
+</style>
+<div class="kk-tl">${rows}
+</div>
+<p>\u5B8C\u6574\u56FE\u6587\u7248\uFF1A<a href="${escapeHtml(articleUrl)}" target="_blank" rel="noopener">${escapeHtml("\u672C\u671F\u5B8C\u6574\u6587\u7AE0")}</a></p>
+<!--/kk:timeline-->`;
+}
 function renderShowNotesHtml(markdown) {
   const blocks = [];
+  const timeline = [];
+  let inTimeline = false;
   let paragraph = [];
   const flush = () => {
     if (paragraph.length > 0) {
@@ -21957,6 +21979,19 @@ function renderShowNotesHtml(markdown) {
   for (const rawLine of markdown.split(`
 `)) {
     const line = rawLine.trim();
+    if (line === "<!--kk:timeline-->") {
+      flush();
+      inTimeline = true;
+      continue;
+    }
+    if (inTimeline) {
+      if (line === "<!--/kk:timeline-->") {
+        inTimeline = false;
+        continue;
+      }
+      timeline.push(rawLine);
+      continue;
+    }
     if (line.length === 0) {
       flush();
       continue;
@@ -21974,9 +22009,18 @@ function renderShowNotesHtml(markdown) {
     paragraph.push(line);
   }
   flush();
+  if (timeline.length > 0)
+    blocks.push(timeline.join(`
+`));
   return blocks.join(`
 `);
 }
+function itemBrief(d) {
+  const meta3 = d.metadata ?? {};
+  if (typeof meta3.brief === "string" && meta3.brief.trim().length > 0)
+    return meta3.brief.trim();
+  return (d.body ?? "").trim().split(/(?<=[\u3002\uFF01\uFF1F])\s*/).slice(0, 2).join("");
+}
 function renderShowNotesMarkdown(docs, opts) {
   const slugify2 = (t) => {
     const s = t.toLowerCase().replace(/[^\w\s-]/g, "").trim().replace(/[\s_]+/g, "-");
@@ -21998,33 +22042,18 @@ function renderShowNotesMarkdown(docs, opts) {
       return "\u6765\u6E90";
     }
   };
-  const itemBrief = (d) => {
-    const meta3 = d.metadata ?? {};
-    if (typeof meta3.brief === "string" && meta3.brief.trim().length > 0)
-      return meta3.brief.trim();
-    return (d.body ?? "").trim().split(/(?<=[\u3002\uFF01\uFF1F])\s*/).slice(0, 2).join("");
-  };
-  const itemTimestamp = (d) => {
-    const meta3 = d.metadata ?? {};
-    const raw = meta3.publishAt;
-    const t = typeof raw === "string" ? Date.parse(raw) : typeof raw === "number" ? raw : Number.NaN;
-    if (!Number.isFinite(t))
-      return "--:--";
-    const at = new Date(t);
-    return `${String(at.getHours()).padStart(2, "0")}:${String(at.getMinutes()).padStart(2, "0")}`;
-  };
+  const offsets = computeAudioOffsets(docs, opts.audioSegments);
   const lines = [`# ${opts.title}`, ""];
-  docs.forEach((d, i) => {
-    const body = (d.body ?? "").trim();
-    const sentences = body.split(/(?<=[\u3002\uFF01\uFF1F])\s*/).slice(0, 2).join("");
-    lines.push(`## ${i + 1}. ${d.title ?? `\u6761\u76EE ${i + 1}`}`, "");
-    if (briefMode) {
-      lines.push(`${itemTimestamp(d)} \xB7 ${itemBrief(d)}`, "", `[\u6765\u6E90\uFF1A${sourceLabel(d)}](${d.sourceUri ?? ""}) \xB7 [\u6587\u7AE0](${articleUrl})`, "");
-    } else {
-      lines.push(sentences, "", `[\u6765\u6E90\uFF1A${sourceLabel(d)}](${d.sourceUri ?? ""})`, "");
-    }
-  });
-  lines.push(`\u8BE6\u60C5\u89C1\u672C\u671F\u5B8C\u6574\u6587\u7AE0\uFF1A[ ${opts.title} ](${articleUrl})`, "");
+  if (briefMode) {
+    lines.push(renderTimelineHtml(docs, offsets, articleUrl), "");
+  } else {
+    docs.forEach((d, i) => {
+      const body = (d.body ?? "").trim();
+      const sentences = body.split(/(?<=[\u3002\uFF01\uFF1F])\s*/).slice(0, 2).join("");
+      lines.push(`## ${i + 1}. ${d.title ?? `\u6761\u76EE ${i + 1}`}`, "", sentences, "", `[\u6765\u6E90\uFF1A${sourceLabel(d)}](${d.sourceUri ?? ""})`, "");
+    });
+    lines.push(`\u8BE6\u60C5\u89C1\u672C\u671F\u5B8C\u6574\u6587\u7AE0\uFF1A[ ${opts.title} ](${articleUrl})`, "");
+  }
   return lines.join(`
 `);
 }
@@ -22255,6 +22284,14 @@ class MicrofeedClient {
 }
 
 // ../../plugins/publishings/podcast-pub/src/index.ts
+function publicItemUrl(item, itemId, client) {
+  const microfeed = item?._microfeed;
+  const webUrl = typeof microfeed?.web_url === "string" ? microfeed.web_url : "";
+  if (webUrl !== "")
+    return webUrl;
+  const feedUrl = typeof item?.url === "string" ? item.url : "";
+  return feedUrl !== "" ? feedUrl : client.itemUrl(itemId);
+}
 var TARGET = "podcast-pub";
 var OPERATIONS = ["publish", "show-notes", "list", "get", "update", "delete", "validate"];
 function resolveClient() {
@@ -22310,13 +22347,28 @@ function resolveShowNotesRenderOptions(options) {
   const briefModeRaw = options.briefMode ?? process.env.PODCAST_PUB_BRIEF_MODE;
   const briefMode = briefModeRaw === true || briefModeRaw === "true" || briefModeRaw === "1";
   const articlePostPath = resolveOptionString(options.articlePostPath, "PODCAST_PUB_ARTICLE_POST_PATH");
+  let audioSegments;
+  const audioContentPath = resolveOptionString(undefined, "PODCAST_PUB_AUDIO_CONTENT");
+  if (audioContentPath !== undefined) {
+    try {
+      const parsed = JSON.parse(readFileSync2(audioContentPath, "utf-8"));
+      const meta3 = parsed?.metadata;
+      if (Array.isArray(meta3?.segments)) {
+        audioSegments = meta3.segments.map((s) => ({
+          duration: typeof s.duration === "number" ? s.duration : undefined,
+          transcription: typeof s.transcription === "string" ? s.transcription : undefined
+        }));
+      }
+    } catch {}
+  }
   return {
     renderOptions: {
       title,
       runDate,
       ...articleBaseUrl !== undefined ? { articleBaseUrl } : {},
       ...briefMode ? { briefMode: true } : {},
-      ...articlePostPath !== undefined ? { articlePostPath } : {}
+      ...articlePostPath !== undefined ? { articlePostPath } : {},
+      ...audioSegments !== undefined ? { audioSegments } : {}
     }
   };
 }
@@ -22410,10 +22462,16 @@ async function publishEpisode(client, payload, options) {
       attachments: [audioAttachment(episode.audio, episode.audio.url, undefined, episode.durationSeconds)],
       ...episodeExtras(episode)
     }, idempotencyKey);
+    let hostedItem;
+    try {
+      hostedItem = (await client.getItem(itemId2)).items?.[0];
+    } catch {
+      hostedItem = undefined;
+    }
     return ResultSchema.parse({
       ok: true,
       target: TARGET,
-      url: client.itemUrl(itemId2),
+      url: publicItemUrl(hostedItem, itemId2, client),
       id: itemId2,
       message: "Published successfully to microfeed (hosted audio, single-call create)"
     });
@@ -22455,9 +22513,10 @@ async function publishEpisode(client, payload, options) {
   return ResultSchema.parse({
     ok: true,
     target: TARGET,
-    url: typeof item.url === "string" && item.url.length > 0 ? item.url : client.itemUrl(itemId),
+    url: publicItemUrl(item, itemId, client),
     id: itemId,
-    message: "Published successfully to microfeed (two-phase upload + publish)"
+    message: "Published successfully to microfeed (two-phase upload + publish)",
+    metadata: { itemId, imageUrl: imageUrl ?? null }
   });
 }
 
@@ -22643,6 +22702,7 @@ if (import.meta.main) {
   process.exit(await main2());
 }
 export {
+  publicItemUrl,
   processPublishIO,
   main2 as main,
   getPublishTransport,

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

@@ -1,3 +1,4 @@
+import { readFileSync } from 'node:fs';
 import { readFile } from 'node:fs/promises';
 import { dirname } from 'node:path';
 import { parseArgs } from 'node:util';
@@ -6,10 +7,23 @@ import { FakeFileCliTransport, type PublishTransport, type PublishTransportPaylo
 import { createNodeFileSystem } from '@gobing-ai/ts-runtime';
 import { echoError } from '@gobing-ai/ts-utils';
 import { type EpisodeMapping, mapContentToEpisode } from './map';
-import { MicrofeedClient, type MicrofeedItemInput, resolveTimeoutMs } from './microfeed-client';
+import { MicrofeedClient, type MicrofeedItem, type MicrofeedItemInput, resolveTimeoutMs } from './microfeed-client';
 import { renderShowNotesMarkdown, type ShowNotesRenderOptions } from './show-notes';
 
 /** Result target name for this plugin. */
+/**
+ * Canonical public page URL from a microfeed item: `_microfeed.web_url` (`/i/{slug}-{id}/` — the
+ * deployment's real page shape) wins, then the JSON Feed `url`, then the client's `/items/{id}`
+ * fallback (which 404s on some deployments but is the only shape derivable from the id alone).
+ */
+export function publicItemUrl(item: MicrofeedItem | undefined, itemId: string, client: MicrofeedClient): string {
+    const microfeed = item?._microfeed as Record<string, unknown> | undefined;
+    const webUrl = typeof microfeed?.web_url === 'string' ? microfeed.web_url : '';
+    if (webUrl !== '') return webUrl;
+    const feedUrl = typeof item?.url === 'string' ? item.url : '';
+    return feedUrl !== '' ? feedUrl : client.itemUrl(itemId);
+}
+
 const TARGET = 'podcast-pub';
 
 /** Management operations routed via `options.operation` (design D5). */
@@ -113,6 +127,24 @@ function resolveShowNotesRenderOptions(
     const briefModeRaw = options.briefMode ?? process.env.PODCAST_PUB_BRIEF_MODE;
     const briefMode = briefModeRaw === true || briefModeRaw === 'true' || briefModeRaw === '1';
     const articlePostPath = resolveOptionString(options.articlePostPath, 'PODCAST_PUB_ARTICLE_POST_PATH');
+    // Audio segment metadata for real timeline offsets: the generated episode content's
+    // `metadata.segments[]` (duration + ASR transcription). Absent ⇒ `--:--` offsets.
+    let audioSegments: ShowNotesRenderOptions['audioSegments'];
+    const audioContentPath = resolveOptionString(undefined, 'PODCAST_PUB_AUDIO_CONTENT');
+    if (audioContentPath !== undefined) {
+        try {
+            const parsed: unknown = JSON.parse(readFileSync(audioContentPath, 'utf-8'));
+            const meta = (parsed as { metadata?: unknown })?.metadata as Record<string, unknown> | undefined;
+            if (Array.isArray(meta?.segments)) {
+                audioSegments = (meta.segments as Array<Record<string, unknown>>).map((s) => ({
+                    duration: typeof s.duration === 'number' ? s.duration : undefined,
+                    transcription: typeof s.transcription === 'string' ? s.transcription : undefined,
+                }));
+            }
+        } catch {
+            // Timeline offsets degrade to proportional — never block show-notes on audio metadata.
+        }
+    }
     return {
         renderOptions: {
             title,
@@ -120,6 +152,7 @@ function resolveShowNotesRenderOptions(
             ...(articleBaseUrl !== undefined ? { articleBaseUrl } : {}),
             ...(briefMode ? { briefMode: true } : {}),
             ...(articlePostPath !== undefined ? { articlePostPath } : {}),
+            ...(audioSegments !== undefined ? { audioSegments } : {}),
         },
     };
 }
@@ -262,10 +295,18 @@ async function publishEpisode(
             },
             idempotencyKey,
         );
+        // Best-effort canonical-URL enrichment: the episode is already published, so a failed
+        // follow-up GET (or an unparsable response) falls back to publicItemUrl's own chain.
+        let hostedItem: MicrofeedItem | undefined;
+        try {
+            hostedItem = (await client.getItem(itemId)).items?.[0];
+        } catch {
+            hostedItem = undefined;
+        }
         return ResultSchema.parse({
             ok: true,
             target: TARGET,
-            url: client.itemUrl(itemId),
+            url: publicItemUrl(hostedItem, itemId, client),
             id: itemId,
             message: 'Published successfully to microfeed (hosted audio, single-call create)',
         });
@@ -319,9 +360,12 @@ async function publishEpisode(
     return ResultSchema.parse({
         ok: true,
         target: TARGET,
-        url: typeof item.url === 'string' && item.url.length > 0 ? item.url : client.itemUrl(itemId),
+        url: publicItemUrl(item, itemId, client),
         id: itemId,
         message: 'Published successfully to microfeed (two-phase upload + publish)',
+        // 20260917 review #6: downstream surfdash patch reuses the podcast-hosted cover URL
+        // (no re-upload); null when the episode carried no local cover.
+        metadata: { itemId, imageUrl: imageUrl ?? null },
     });
 }