@gobing-ai/knowledge-kit 0.0.13 → 0.0.14

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

@@ -19,6 +19,7 @@ vars:
   limit: "10"
   language: "zh"
   voice_profile: "robin-news"
+  voice_generator: "voice-gen"
   title: ""
   cursor: ""
   state_file: ""
@@ -54,6 +55,7 @@ states:
       - kind: shell
         options:
           command: >-
+            __STAMP_T0="$(date -u +%FT%TZ)"; trap '[ -n "${vars.work_dir}" ] && printf "{\"step\":\"prepare\",\"startedAt\":\"%s\",\"endedAt\":\"%s\"}\n" "$__STAMP_T0" "$(date -u +%FT%TZ)" >> "${vars.work_dir}/step-timing.json"' EXIT;
             test -n "${vars.work_dir}" || { echo "missing required variable: work_dir" >&2 && exit 1; };
             mkdir -p "${vars.work_dir}/1-ingest" "${vars.work_dir}/2-facts" "${vars.work_dir}/2-plan" "${vars.work_dir}/2-article" "${vars.work_dir}/2-cover" "${vars.work_dir}/2-script" "${vars.work_dir}/3-audio" "${vars.work_dir}/3-publish";
             date +%Y%m%d > "${vars.work_dir}/run-date.txt" &&
@@ -75,11 +77,13 @@ states:
           # fan-in 30m per-source default and making empty episodes stochastic — horizon gets a
           # 45m leash; aihot/last30days keep the default.
           command: >-
+            __STAMP_T0="$(date -u +%FT%TZ)"; trap '[ -n "${vars.work_dir}" ] && printf "{\"step\":\"collect\",\"startedAt\":\"%s\",\"endedAt\":\"%s\"}\n" "$__STAMP_T0" "$(date -u +%FT%TZ)" >> "${vars.work_dir}/step-timing.json"' EXIT;
             if [ -f "${vars.work_dir}/1-ingest/blended.json" ]; then echo "collect cached: ${vars.work_dir}/1-ingest/blended.json"; exit 0; fi;
             kk executor fan-in --source "aihot-ingest:${vars.work_dir}/1-ingest/source.json" --source "last30days-ingest:${vars.work_dir}/1-ingest/last30days.json" --source "horizon-ingest:${vars.work_dir}/1-ingest/horizon.json" --source-timeout-override "horizon-ingest:2700000" --out "${vars.work_dir}/1-ingest/blended.json"
       - kind: shell
         options:
           command: >-
+            __STAMP_T0="$(date -u +%FT%TZ)"; trap '[ -n "${vars.work_dir}" ] && printf "{\"step\":\"collect\",\"startedAt\":\"%s\",\"endedAt\":\"%s\"}\n" "$__STAMP_T0" "$(date -u +%FT%TZ)" >> "${vars.work_dir}/step-timing.json"' EXIT;
             set --;
             if [ -n "${vars.plugins_path}" ]; then set -- --plugins-path "${vars.plugins_path}"; fi;
             if [ -f "${vars.work_dir}/2-facts/content.json" ] && [ -f "${vars.work_dir}/2-facts/core-facts.md" ]; then echo "core facts cached: ${vars.work_dir}/2-facts/core-facts.md"; exit 0; fi;
@@ -92,6 +96,7 @@ states:
       - kind: shell
         options:
           command: >-
+            __STAMP_T0="$(date -u +%FT%TZ)"; trap '[ -n "${vars.work_dir}" ] && printf "{\"step\":\"plan\",\"startedAt\":\"%s\",\"endedAt\":\"%s\"}\n" "$__STAMP_T0" "$(date -u +%FT%TZ)" >> "${vars.work_dir}/step-timing.json"' EXIT;
             set --;
             if [ -n "${vars.plugins_path}" ]; then set -- --plugins-path "${vars.plugins_path}"; fi;
             PLAN_CONTENT="${vars.work_dir}/2-plan/content.json"; PLAN_DOCS="${vars.work_dir}/2-plan/plan.json";
@@ -106,6 +111,7 @@ states:
       - kind: shell
         options:
           command: >-
+            __STAMP_T0="$(date -u +%FT%TZ)"; trap '[ -n "${vars.work_dir}" ] && printf "{\"step\":\"quality-control-content\",\"startedAt\":\"%s\",\"endedAt\":\"%s\"}\n" "$__STAMP_T0" "$(date -u +%FT%TZ)" >> "${vars.work_dir}/step-timing.json"' EXIT;
             set --;
             if [ -n "${vars.plugins_path}" ]; then set -- --plugins-path "${vars.plugins_path}"; fi;
             if [ -f "${vars.work_dir}/2-plan/candidates.json" ]; then echo "candidates cached: ${vars.work_dir}/2-plan/candidates.json"; exit 0; fi;
@@ -136,23 +142,30 @@ states:
       - kind: shell
         options:
           command: >-
+            __STAMP_T0="$(date -u +%FT%TZ)"; trap '[ -n "${vars.work_dir}" ] && printf "{\"step\":\"article\",\"startedAt\":\"%s\",\"endedAt\":\"%s\"}\n" "$__STAMP_T0" "$(date -u +%FT%TZ)" >> "${vars.work_dir}/step-timing.json"' EXIT;
             set --;
             if [ -n "${vars.plugins_path}" ]; then set -- --plugins-path "${vars.plugins_path}"; fi;
             CONTENT_OUT="${vars.work_dir}/2-article/content-${vars.run_date}.json"; ARTICLE_MD="${vars.work_dir}/2-article/article-${vars.run_date}.md";
             if [ -f "$ARTICLE_MD" ]; then echo "article cached: $ARTICLE_MD"; else PLAN_IN="${vars.work_dir}/2-plan/plan.json"; PLAN_OK=1; bun -e 'try { JSON.parse(await Bun.file(process.argv[1]).text()); process.exit(0); } catch (e) { console.warn("article: plan.json invalid JSON — replacing with untranslated plan (downstream states read this file): " + e.message); const docs = JSON.parse(await Bun.file(process.argv[2]).text()).metadata?.docs; if (!Array.isArray(docs) || docs.length === 0) { console.error("article: candidates.json metadata.docs missing"); process.exit(2); } await Bun.write(process.argv[1], JSON.stringify(docs, null, 2)); process.exit(1); }' "$PLAN_IN" "${vars.work_dir}/2-plan/candidates.json"; case $? in 0|1) PLAN_OK=0;; esac; test "$PLAN_OK" -eq 0 || { echo "article: no usable plan input"; exit 1; }; ARTICLE_DATE="${vars.run_date}" kk executor run daily-article-gen --in "$PLAN_IN" --out "$CONTENT_OUT" "$@" && bun -e 'await Bun.write(process.argv[2], (await Bun.file(process.argv[1]).json()).body)' "$CONTENT_OUT" "$ARTICLE_MD"; fi
 
   - id: cover
-    description: "Generate the article cover image via the wt-image-cover skill (agent.run)"
+    description: "Generate the article cover image via the kk:image-authoring skill (agent.run)"
     onEnter:
       - kind: agent.run
         options:
           role: scribe
           agent: ${vars.agent}
           input: |
-            Invoke the wt-image-cover skill.
-            Generate a 21:9 cover image for the article at ${vars.work_dir}/2-article/article-${vars.run_date}.md and save it to ${vars.work_dir}/2-cover/cover-${vars.run_date}.png.
-            Use style "news". If no image-generation backend is available, a procedurally rendered cover (e.g. PIL: news palette, headline typography) is an acceptable, expected deliverable — not a fake; generate it and write the file. Do not wait for operator confirmation.
-          expectFile: ${vars.work_dir}/2-cover/cover-${vars.run_date}.png
+            Invoke the kk:image-authoring skill (generate operation).
+            This node is a non-interactive workflow step: run every image command with KK_NONINTERACTIVE=1 and KK_IMAGE_AUTO_CONFIRM=1 in the environment (this workflow approves the image spend via cover_enabled) — never prompt, never open a question.
+            Command: --format cover --content ${vars.work_dir}/2-article/article-${vars.run_date}.md --out ${vars.work_dir}/2-cover
+            Derive the cover template variables (title, subtitle, topics) from the article as the skill owns; style is the format's default — do not pass --style.
+            The plugin writes ${vars.work_dir}/2-cover/content.json plus the artifact ${vars.work_dir}/2-cover/content-cover-01.<ext>, where <ext> follows the elected provider's native output (payload honesty: minimax returns JPEG, google/ark return PNG). If generation fails, report the error verbatim and stop — no procedural fallback.
+            Run 20260911 context: only MINIMAX_API_KEY is credentialed (ARK out of token, google key unset), so the elected provider is minimax and the artifact lands as content-cover-01.jpg.
+          expectFile: ${vars.work_dir}/2-cover/content-cover-01.jpg
+      - kind: shell
+        options:
+          command: 'cd "${vars.work_dir}/2-cover" && src="content-cover-01.png"; test -f "$src" || src="content-cover-01.jpg"; test -f "$src" || { echo "cover normalize: no content-cover-01.{png,jpg} artifact" >&2; exit 1; }; case "$src" in *.jpg) command -v sips >/dev/null 2>&1 || { echo "cover normalize: sips not found; cannot transcode jpg -> png" >&2; exit 1; }; sips -s format png "$src" --out "cover-${vars.run_date}.png" >/dev/null;; *) mv "$src" "cover-${vars.run_date}.png";; esac; rm -f content-cover-01.jpg content-cover-01.png; echo "cover normalized: cover-${vars.run_date}.png"'
 
   - id: script
     description: "Compile the episode plan Doc[] into structured broadcast VoiceScript YAML Content"
@@ -160,6 +173,7 @@ states:
       - kind: shell
         options:
           command: >-
+            __STAMP_T0="$(date -u +%FT%TZ)"; trap '[ -n "${vars.work_dir}" ] && printf "{\"step\":\"script\",\"startedAt\":\"%s\",\"endedAt\":\"%s\"}\n" "$__STAMP_T0" "$(date -u +%FT%TZ)" >> "${vars.work_dir}/step-timing.json"' EXIT;
             set --;
             if [ -n "${vars.plugins_path}" ]; then set -- --plugins-path "${vars.plugins_path}"; fi;
             SCRIPT_CONTENT_OUT="${vars.work_dir}/2-script/content-${vars.run_date}.json"; VOICESCRIPT_YAML="${vars.work_dir}/2-script/voicescript-${vars.run_date}.yaml";
@@ -180,18 +194,20 @@ states:
       - kind: shell
         options:
           command: >-
+            __STAMP_T0="$(date -u +%FT%TZ)"; trap '[ -n "${vars.work_dir}" ] && printf "{\"step\":\"wrap-docs\",\"startedAt\":\"%s\",\"endedAt\":\"%s\"}\n" "$__STAMP_T0" "$(date -u +%FT%TZ)" >> "${vars.work_dir}/step-timing.json"' EXIT;
             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-news" } }; await Bun.write(process.argv[2], JSON.stringify([doc], null, 2))' "${vars.work_dir}/2-script/voicescript-${vars.run_date}.yaml" "${vars.work_dir}/3-audio/docs.json" "${vars.voice_profile}"
 
   - id: generate
-    description: "Invoke voice-gen generator plugin to generate audio"
+    description: "Invoke voice generator plugin (voice_generator var) to generate audio"
     onEnter:
       - kind: shell
         options:
           command: >-
+            __STAMP_T0="$(date -u +%FT%TZ)"; trap '[ -n "${vars.work_dir}" ] && printf "{\"step\":\"generate\",\"startedAt\":\"%s\",\"endedAt\":\"%s\"}\n" "$__STAMP_T0" "$(date -u +%FT%TZ)" >> "${vars.work_dir}/step-timing.json"' EXIT;
             set --;
             if [ -n "${vars.plugins_path}" ]; then set -- --plugins-path "${vars.plugins_path}"; fi;
             if [ -f "${vars.work_dir}/3-audio/content.json" ] && jq -e '.metadata.qc.passed == true' "${vars.work_dir}/3-audio/content.json" > /dev/null 2>&1; then echo "audio cached: ${vars.work_dir}/3-audio/content.json (QC passed)"; exit 0; 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" "$@"
+            VOICE_GEN_MP3="${vars.transcode_mp3}" kk executor run ${vars.voice_generator} --in "${vars.work_dir}/3-audio/docs.json" --out "${vars.work_dir}/3-audio/content.json" "$@"
 
   - id: quality-control
     description: "Verify audio quality, speech rate, and silence/repetition QC metrics"
@@ -199,63 +215,117 @@ states:
       - kind: shell
         options:
           command: >-
+            __STAMP_T0="$(date -u +%FT%TZ)"; trap '[ -n "${vars.work_dir}" ] && printf "{\"step\":\"quality-control\",\"startedAt\":\"%s\",\"endedAt\":\"%s\"}\n" "$__STAMP_T0" "$(date -u +%FT%TZ)" >> "${vars.work_dir}/step-timing.json"' EXIT;
             bun -e 'const content = JSON.parse(await Bun.file(process.argv[1]).text()); const qc = content.metadata?.qc; console.log("=== Voice Quality Control Report ==="); console.log("Overall Score: " + (qc ? qc.overallScore : 100) + "/100 | Passed: " + (qc ? qc.passed : true)); if (qc && qc.criticalIssues && qc.criticalIssues.length) { console.warn("QC Issues:\n" + qc.criticalIssues.map(function(i) { return "  - " + i; }).join("\n")); } else { console.log("All audio segments passed quality control checks cleanly."); }' "${vars.work_dir}/3-audio/content.json"
 
+  - id: publish-prep
+    description: "Merge article Content with audio (podcast assembly facts ride the content options channel for podcast-pub's absorbed assembly; runDate kept for surfdash slug)"
+    onEnter:
+      - kind: shell
+        options:
+          command: >-
+            __STAMP_T0="$(date -u +%FT%TZ)"; trap '[ -n "${vars.work_dir}" ] && printf "{\"step\":\"publish-prep\",\"startedAt\":\"%s\",\"endedAt\":\"%s\"}\n" "$__STAMP_T0" "$(date -u +%FT%TZ)" >> "${vars.work_dir}/step-timing.json"' EXIT;
+            bun -e 'const article = JSON.parse(await Bun.file(process.argv[1]).text()); const audio = JSON.parse(await Bun.file(process.argv[2]).text()); const audioMeta = audio.metadata ?? {}; const rawFile = audioMeta.mp3Path ?? audioMeta.audioPath; if (!rawFile) { console.error("publish-prep: voice content carries no mp3Path/audioPath"); process.exit(1); } const { resolve } = await import("node:path"); const { existsSync } = await import("node:fs"); const audioFile = resolve(rawFile); const coverPath = resolve(process.argv[4]); const merged = { ...article, metadata: { ...(article.metadata ?? {}), audioFile, runDate: process.argv[5] }, options: { audioFile, durationSec: audioMeta.duration, coverPath: existsSync(coverPath) ? coverPath : undefined } }; await Bun.write(process.argv[3], JSON.stringify(merged, null, 2))' "${vars.work_dir}/2-article/content-${vars.run_date}.json" "${vars.work_dir}/3-audio/content.json" "${vars.work_dir}/3-publish/content.json" "${vars.work_dir}/2-cover/cover-${vars.run_date}.png" "${vars.run_date}"
+
+  - id: publish-surfdash
+    description: "Publish the merged Content to surfdash (single target); result lands in result.json — surfdash publishes first so show-notes can link the article (task 0118 seam reorder)"
+    onEnter:
+      - kind: shell
+        options:
+          command: >-
+            __STAMP_T0="$(date -u +%FT%TZ)"; trap '[ -n "${vars.work_dir}" ] && printf "{\"step\":\"publish-surfdash\",\"startedAt\":\"%s\",\"endedAt\":\"%s\"}\n" "$__STAMP_T0" "$(date -u +%FT%TZ)" >> "${vars.work_dir}/step-timing.json"' EXIT;
+            set --;
+            if [ -n "${vars.plugins_path}" ]; then set -- --plugins-path "${vars.plugins_path}"; fi;
+            RESULT="${vars.work_dir}/3-publish/result-surfdash.json";
+            if jq -e '.targets[]? | select(.target == "surfdash-pub" and .ok == true and .status == "published")' "$RESULT" > /dev/null 2>&1; then echo "publish-surfdash cached: surfdash target ok in $RESULT"; exit 0; fi;
+            env -u SPUR_WORKFLOW_RUN_ACTIVE kk executor fan-out --content "${vars.work_dir}/3-publish/content.json" --target surfdash-pub --out "$RESULT" "$@" || true;
+            echo "publish-surfdash: surfdash target dispatched; classification happens after podcast publish"
+
   - id: show-notes
-    description: "Render uniform show notes from the episode plan (podcast-pub show-notes operation; PODCAST_PUB_TITLE carries the effective title vars.title || article.title)"
+    description: "Render timeline show notes from the episode plan (podcast-pub show-notes op, briefMode; article URL from the surfdash result postPath — surfdash failure degrades to legacy full-body layout)"
     onEnter:
       - kind: shell
         options:
           command: >-
+            __STAMP_T0="$(date -u +%FT%TZ)"; trap '[ -n "${vars.work_dir}" ] && printf "{\"step\":\"show-notes\",\"startedAt\":\"%s\",\"endedAt\":\"%s\"}\n" "$__STAMP_T0" "$(date -u +%FT%TZ)" >> "${vars.work_dir}/step-timing.json"' EXIT;
             set --;
             if [ -n "${vars.plugins_path}" ]; then set -- --plugins-path "${vars.plugins_path}"; fi;
             TITLE_ARG="${vars.title}";
             EFFECTIVE_TITLE="$(jq -r '.title // ""' "${vars.work_dir}/2-article/content-${vars.run_date}.json")";
             if [ -z "$TITLE_ARG" ]; then TITLE_ARG="$EFFECTIVE_TITLE"; fi;
-            PODCAST_PUB_TITLE="$TITLE_ARG" PODCAST_PUB_RUN_DATE="${vars.run_date}" kk executor run podcast-pub --in "${vars.work_dir}/2-plan/plan.json" --out "${vars.work_dir}/3-publish/show-notes.md" "$@"
+            RESULT="${vars.work_dir}/3-publish/result.json";
+            POST_PATH="$(jq -r '[(.targets // [])[] | select(.target == "surfdash-pub" and .ok == true) | .metadata.postPath // empty] | first // ""' "$RESULT" 2>/dev/null || true)";
+            PODCAST_PUB_TITLE="$TITLE_ARG" PODCAST_PUB_RUN_DATE="${vars.run_date}" PODCAST_PUB_BRIEF_MODE=true PODCAST_PUB_ARTICLE_POST_PATH="$POST_PATH" kk executor run podcast-pub --in "${vars.work_dir}/2-plan/plan.json" --out "${vars.work_dir}/3-publish/show-notes.md" "$@"
 
-  - id: publish-prep
-    description: "Merge article Content with audio (podcast assembly facts ride the content options channel for podcast-pub's absorbed assembly; runDate kept for surfdash slug)"
+  - id: publish-podcast
+    description: "Publish the episode to podcast-pub with the rendered show notes (metadata.showNotes carries the brief/timeline markdown; map.ts falls back to content.body when absent — task 0118 R3)"
     onEnter:
       - kind: shell
         options:
           command: >-
-            bun -e 'const article = JSON.parse(await Bun.file(process.argv[1]).text()); const audio = JSON.parse(await Bun.file(process.argv[2]).text()); const audioMeta = audio.metadata ?? {}; const rawFile = audioMeta.mp3Path ?? audioMeta.audioPath; if (!rawFile) { console.error("publish-prep: voice content carries no mp3Path/audioPath"); process.exit(1); } const { resolve } = await import("node:path"); const { existsSync } = await import("node:fs"); const audioFile = resolve(rawFile); const coverPath = resolve(process.argv[4]); const merged = { ...article, metadata: { ...(article.metadata ?? {}), audioFile, runDate: process.argv[5] }, options: { audioFile, durationSec: audioMeta.duration, coverPath: existsSync(coverPath) ? coverPath : undefined } }; await Bun.write(process.argv[3], JSON.stringify(merged, null, 2))' "${vars.work_dir}/2-article/content-${vars.run_date}.json" "${vars.work_dir}/3-audio/content.json" "${vars.work_dir}/3-publish/content.json" "${vars.work_dir}/2-cover/cover-${vars.run_date}.png" "${vars.run_date}"
+            __STAMP_T0="$(date -u +%FT%TZ)"; trap '[ -n "${vars.work_dir}" ] && printf "{\"step\":\"publish-podcast\",\"startedAt\":\"%s\",\"endedAt\":\"%s\"}\n" "$__STAMP_T0" "$(date -u +%FT%TZ)" >> "${vars.work_dir}/step-timing.json"' EXIT;
+            set --;
+            if [ -n "${vars.plugins_path}" ]; then set -- --plugins-path "${vars.plugins_path}"; fi;
+            RESULT="${vars.work_dir}/3-publish/result-podcast.json";
+            if jq -e '.targets[]? | select(.target == "podcast-pub" and .ok == true and .status == "published")' "$RESULT" > /dev/null 2>&1; then echo "publish-podcast cached: podcast target ok in $RESULT"; exit 0; fi;
+            bun -e 'const content = JSON.parse(await Bun.file(process.argv[1]).text()); const notes = await Bun.file(process.argv[2]).text(); content.metadata = { ...(content.metadata ?? {}), showNotes: notes }; await Bun.write(process.argv[1], JSON.stringify(content, null, 2))' "${vars.work_dir}/3-publish/content.json" "${vars.work_dir}/3-publish/show-notes.md" &&
+            env -u SPUR_WORKFLOW_RUN_ACTIVE kk executor fan-out --content "${vars.work_dir}/3-publish/content.json" --target podcast-pub --out "$RESULT" "$@" || true;
+            echo "publish-podcast: podcast target dispatched"
 
   - id: publish
-    description: "Fan out the merged Content to surfdash-pub and podcast-pub; classify the outcome full|partial|none into publish-status.txt (exit 0 in all three — routing is transition-owned)"
+    description: "Classify the sequenced surfdash → podcast outcomes full|partial|none into publish-status.txt (exit 0 in all three — routing is transition-owned; task 0118: per-target classification over the merged result.json)"
     onEnter:
       - kind: shell
         options:
           command: >-
-            set --;
-            if [ -n "${vars.plugins_path}" ]; then set -- --plugins-path "${vars.plugins_path}"; fi;
+            __STAMP_T0="$(date -u +%FT%TZ)"; trap '[ -n "${vars.work_dir}" ] && printf "{\"step\":\"publish\",\"startedAt\":\"%s\",\"endedAt\":\"%s\"}\n" "$__STAMP_T0" "$(date -u +%FT%TZ)" >> "${vars.work_dir}/step-timing.json"' EXIT;
             RESULT="${vars.work_dir}/3-publish/result.json"; STATUS_FILE="${vars.work_dir}/3-publish/publish-status.txt";
-            if jq -e '.ok == true and ([.targets[]? | select(.ok == true and .status == "published")] | length) == 2' "$RESULT" > /dev/null 2>&1; then echo "publish cached: $RESULT (2 targets ok)"; printf 'full' > "$STATUS_FILE"; exit 0; fi;
-            OK_COUNT=0; TOTAL=0; STATUS="none";
-            env -u SPUR_WORKFLOW_RUN_ACTIVE kk executor fan-out --content "${vars.work_dir}/3-publish/content.json" --target surfdash-pub --target podcast-pub --out "$RESULT" "$@" || true;
-            if [ -f "$RESULT" ]; then OK_COUNT="$(jq '[.targets[]? | select(.ok == true and .status == "published")] | length' "$RESULT")"; TOTAL="$(jq '[.targets[]?] | length' "$RESULT")"; if [ "$OK_COUNT" -gt 0 ] && [ "$OK_COUNT" -eq "$TOTAL" ]; then STATUS="full"; elif [ "$OK_COUNT" -gt 0 ]; then STATUS="partial"; fi; else echo "publish: fan-out wrote no result.json — routing to none" >&2; fi;
+            TARGETS="$(jq -s '[(.[0].targets // []), (.[1].targets // [])] | add' "${vars.work_dir}/3-publish/result-surfdash.json" "${vars.work_dir}/3-publish/result-podcast.json" 2>/dev/null || echo '[]')";
+            OK_COUNT="$(printf '%s' "$TARGETS" | jq '[.[]? | select(.ok == true and .status == "published")] | length')";
+            TOTAL="$(printf '%s' "$TARGETS" | jq 'length')";
+            if [ "$OK_COUNT" -gt 0 ] && [ "$OK_COUNT" -eq "$TOTAL" ]; then STATUS="full"; elif [ "$OK_COUNT" -gt 0 ]; then STATUS="partial"; else STATUS="none"; fi;
+            jq -n --argjson targets "$TARGETS" --argjson ok "$OK_COUNT" --argjson total "$TOTAL" '{ok: ($ok == $total and $total > 0), targets: $targets}' > "$RESULT";
             printf '%s' "$STATUS" > "$STATUS_FILE";
             echo "publish: status=$STATUS ($OK_COUNT/$TOTAL targets published); routing is transition-owned"
 
   - id: publish-partial
-    description: "Partial publish — at least one target published, at least one failed; echo warning, write a .spur/run marker, preserve result.json for --retry-from, continue to done"
+    description: "Partial publish — at least one target published, at least one failed; echo warning, write a .spur/run marker, preserve result.json for --retry-from, continue to done (task 0118: surfdash failure = no-URL fallback notes; podcast failure = its own partial)"
     onEnter:
       - kind: shell
         options:
           command: >-
+            __STAMP_T0="$(date -u +%FT%TZ)"; trap '[ -n "${vars.work_dir}" ] && printf "{\"step\":\"publish-partial\",\"startedAt\":\"%s\",\"endedAt\":\"%s\"}\n" "$__STAMP_T0" "$(date -u +%FT%TZ)" >> "${vars.work_dir}/step-timing.json"' EXIT;
             FAILED="$(jq -r '[.targets[]? | select(.ok != true or .status != "published") | .target] | join(",")' "${vars.work_dir}/3-publish/result.json")";
             if [ -z "$FAILED" ]; then FAILED="(unparsed)"; fi;
             echo "WARNING: partial publish — failed targets: $FAILED" >&2;
             mkdir -p .spur/run &&
             printf '%s partial publish: failed targets: %s (result.json preserved for kk executor fan-out --retry-from)\n' "${vars.run_date}" "$FAILED" > ".spur/run/publish-partial-${vars.run_date}.txt"
 
+  - id: run-report
+    description: "Assemble the per-run report (scores+aggregates+rejected counts+step timing) from existing artifacts — news-report-gen; output-only, never throws; 0117"
+    onEnter:
+      - kind: shell
+        options:
+          command: >-
+            __STAMP_T0="$(date -u +%FT%TZ)"; trap '[ -n "${vars.work_dir}" ] && printf "{\"step\":\"run-report\",\"startedAt\":\"%s\",\"endedAt\":\"%s\"}\n" "$__STAMP_T0" "$(date -u +%FT%TZ)" >> "${vars.work_dir}/step-timing.json"' EXIT;
+            REPORT_MD="${vars.work_dir}/run-report-${vars.run_date}.md";
+            if [ -f "$REPORT_MD" ]; then echo "run report cached: $REPORT_MD"; exit 0; fi;
+            CANDS="${vars.work_dir}/2-plan/episode-plan.json";
+            test -f "${vars.work_dir}/2-plan/candidates.json" || { echo "run-report: no candidates.json (run ended below plan step) — skip"; exit 0; };
+            jq '.metadata.docs // []' "${vars.work_dir}/2-plan/candidates.json" > "$CANDS";
+            set --;
+            if [ -n "${vars.plugins_path}" ]; then set -- --plugins-path "${vars.plugins_path}"; fi;
+            QC_MIN_QUALITY="${vars.qc_min_quality}" QC_MIN_IMPORTANCE="${vars.qc_min_importance}" QC_MIN_URGENCY="${vars.qc_min_urgency}" QC_MIN_IMPACT="${vars.qc_min_impact}" NEWS_REPORT_REJECTED_FILE="${vars.work_dir}/2-plan/candidates.rejected.json" NEWS_REPORT_TIMING_FILE="${vars.work_dir}/step-timing.json" NEWS_REPORT_DATE="${vars.run_date}" kk executor run news-report-gen --in "$CANDS" --out "${vars.work_dir}/run-report.json" "$@" &&
+            bun -e 'await Bun.write(process.argv[2], (await Bun.file(process.argv[1]).json()).body)' "${vars.work_dir}/run-report.json" "$REPORT_MD" &&
+            echo "run report written: $REPORT_MD"
+
   - id: translate-en
     description: "Scaffold en draft from the zh article via surfdash-pub scaffold-locale (postPath from publish result; done-no-content/none-publish runs carry no zh path and skip)"
     onEnter:
       - kind: shell
         options:
           command: >-
+            __STAMP_T0="$(date -u +%FT%TZ)"; trap '[ -n "${vars.work_dir}" ] && printf "{\"step\":\"translate-en\",\"startedAt\":\"%s\",\"endedAt\":\"%s\"}\n" "$__STAMP_T0" "$(date -u +%FT%TZ)" >> "${vars.work_dir}/step-timing.json"' EXIT;
             RESULT="${vars.work_dir}/3-publish/result.json";
             ZH="$(jq -r '[(.targets // [])[] | select(.target == "surfdash-pub" and .ok == true) | .metadata.postPath // empty] | first // ""' "$RESULT")";
             case "$ZH" in *index.md) ;; *) ZH="";; esac;
@@ -298,6 +368,7 @@ states:
       - kind: shell
         options:
           command: >-
+            __STAMP_T0="$(date -u +%FT%TZ)"; trap '[ -n "${vars.work_dir}" ] && printf "{\"step\":\"translate-ja\",\"startedAt\":\"%s\",\"endedAt\":\"%s\"}\n" "$__STAMP_T0" "$(date -u +%FT%TZ)" >> "${vars.work_dir}/step-timing.json"' EXIT;
             ZH="$(cat "${vars.work_dir}/3-publish/zh-post-path.txt" 2>/dev/null || printf '')";
             JA="$(printf '%s' "$ZH" | sed 's|/zh/|/ja/|')";
             printf '%s' "$JA" > "${vars.work_dir}/3-publish/ja-post-path.txt";
@@ -334,6 +405,7 @@ states:
       - kind: shell
         options:
           command: >-
+            __STAMP_T0="$(date -u +%FT%TZ)"; trap '[ -n "${vars.work_dir}" ] && printf "{\"step\":\"translate-sync\",\"startedAt\":\"%s\",\"endedAt\":\"%s\"}\n" "$__STAMP_T0" "$(date -u +%FT%TZ)" >> "${vars.work_dir}/step-timing.json"' EXIT;
             test -n "${vars.surfdash_post_path}" || { echo "no zh post path — skip translate-sync"; exit 0; };
             set --;
             if [ -n "${vars.plugins_path}" ]; then set -- --plugins-path "${vars.plugins_path}"; fi;
@@ -461,8 +533,8 @@ transitions:
       kind: always
 
   - from: quality-control
-    to: show-notes
-    description: "publish enabled AND QC passed -> render show notes, then publish"
+    to: publish-prep
+    description: "publish enabled AND QC passed -> merge article + audio for the publish seam"
     guard:
       kind: shell
       options:
@@ -482,21 +554,33 @@ transitions:
     guard:
       kind: always
 
+  - from: publish-prep
+    to: publish-surfdash
+    description: "Merged content ready -> surfdash publishes first (task 0118 seam reorder: article URLs must exist before show-notes render)"
+    guard:
+      kind: always
+
+  - from: publish-surfdash
+    to: show-notes
+    description: "Surfdash dispatched (ok or failed — failure degrades to no-URL notes) -> render timeline show notes"
+    guard:
+      kind: always
+
   - from: show-notes
-    to: publish-prep
-    description: "Show notes rendered -> merge article + audio for the publish seam"
+    to: publish-podcast
+    description: "Show notes rendered (briefMode timeline or legacy fallback) -> podcast publish carries them via metadata.showNotes"
     guard:
       kind: always
 
-  - from: publish-prep
+  - from: publish-podcast
     to: publish
-    description: "Merged content ready -> fan out to surfdash-pub + podcast-pub"
+    description: "Podcast dispatched -> classify the per-target outcomes full|partial|none"
     guard:
       kind: always
 
   - from: publish
-    to: translate-en
-    description: "Publish full (all targets published) -> scaffold + translate en locale"
+    to: run-report
+    description: "Publish full (all targets published) -> assemble run report first"
     guard:
       kind: shell
       options:
@@ -519,11 +603,27 @@ transitions:
         command: 'test "$(cat "${vars.work_dir}/3-publish/publish-status.txt")" = "none"'
 
   - from: publish-partial
-    to: done
-    description: "Partial publish recorded (warning + .spur/run marker) -> done; retry failed targets later via kk executor fan-out --retry-from"
+    to: run-report
+    description: "Partial publish recorded (warning + .spur/run marker) -> still assemble the run report"
     guard:
       kind: always
 
+  - from: run-report
+    to: translate-en
+    description: "Run report assembled after full publish -> scaffold + translate en locale"
+    guard:
+      kind: shell
+      options:
+        command: 'test "$(cat "${vars.work_dir}/3-publish/publish-status.txt")" = "full"'
+
+  - from: run-report
+    to: done
+    description: "Run report assembled after partial publish -> done; retry failed targets later via kk executor fan-out --retry-from"
+    guard:
+      kind: shell
+      options:
+        command: 'test "$(cat "${vars.work_dir}/3-publish/publish-status.txt")" = "partial"'
+
   - from: translate-en
     to: translate-en-agent
     description: "zh post published and en draft scaffolded -> agent translates en draft in place"

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

@@ -21848,6 +21848,26 @@ var ResultSchema = exports_external.object({
   metadata: exports_external.record(exports_external.string(), exports_external.unknown()).optional()
 });
 var DocListSchema = exports_external.array(DocSchema);
+var omniVoiceGenContentSchema = ContentSchema.extend({
+  format: exports_external.literal("audio"),
+  metadata: exports_external.looseObject({
+    generator: exports_external.literal("kk:omni-voice-gen"),
+    audioPath: exports_external.string(),
+    duration: exports_external.number(),
+    segments: exports_external.array(exports_external.looseObject({
+      generationId: exports_external.string(),
+      profile: exports_external.string(),
+      speaker: exports_external.string().optional(),
+      emotion: exports_external.string().optional(),
+      duration: exports_external.number(),
+      verifyRetries: exports_external.number(),
+      transcription: exports_external.string().optional(),
+      loudnessDip: exports_external.boolean().optional()
+    })),
+    mp3Path: exports_external.string().optional(),
+    qc: exports_external.record(exports_external.string(), exports_external.unknown()).optional()
+  })
+});
 
 // ../../packages/kk-core/src/kinds.ts
 var PLUGIN_KINDS = ["ingestion", "generator", "publish"];

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

@@ -21849,6 +21849,26 @@ var ResultSchema = exports_external.object({
   metadata: exports_external.record(exports_external.string(), exports_external.unknown()).optional()
 });
 var DocListSchema = exports_external.array(DocSchema);
+var omniVoiceGenContentSchema = ContentSchema.extend({
+  format: exports_external.literal("audio"),
+  metadata: exports_external.looseObject({
+    generator: exports_external.literal("kk:omni-voice-gen"),
+    audioPath: exports_external.string(),
+    duration: exports_external.number(),
+    segments: exports_external.array(exports_external.looseObject({
+      generationId: exports_external.string(),
+      profile: exports_external.string(),
+      speaker: exports_external.string().optional(),
+      emotion: exports_external.string().optional(),
+      duration: exports_external.number(),
+      verifyRetries: exports_external.number(),
+      transcription: exports_external.string().optional(),
+      loudnessDip: exports_external.boolean().optional()
+    })),
+    mp3Path: exports_external.string().optional(),
+    qc: exports_external.record(exports_external.string(), exports_external.unknown()).optional()
+  })
+});
 
 // ../../packages/kk-core/src/kinds.ts
 var PLUGIN_KINDS = ["ingestion", "generator", "publish"];
@@ -21962,7 +21982,12 @@ function renderShowNotesMarkdown(docs, opts) {
     const s = t.toLowerCase().replace(/[^\w\s-]/g, "").trim().replace(/[\s_]+/g, "-");
     return s.length > 0 ? s : "post";
   };
-  const articleUrl = `${opts.articleBaseUrl ?? "https://surfing.salty.vip"}/zh/posts/${opts.runDate}-${slugify2(opts.title)}`;
+  const baseUrl = opts.articleBaseUrl ?? "https://surfing.salty.vip";
+  const segments = opts.articlePostPath?.split(/[\\/]/).filter((s) => s.length > 0) ?? [];
+  const postSlug = segments.length >= 2 ? segments[segments.length - 2] ?? "" : "";
+  const postLocale = segments.find((s) => ["zh", "en", "ja"].includes(s)) ?? "zh";
+  const articleUrl = postSlug.length > 0 ? `${baseUrl}/${postLocale}/posts/${postSlug}` : `${baseUrl}/zh/posts/${opts.runDate}-${slugify2(opts.title)}`;
+  const briefMode = opts.briefMode === true && postSlug.length > 0;
   const sourceLabel = (d) => {
     const m = d.metadata ?? {};
     if (typeof m.sourceName === "string" && m.sourceName.trim())
@@ -21973,11 +21998,31 @@ 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 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}`}`, "", sentences, "", `[\u6765\u6E90\uFF1A${sourceLabel(d)}](${d.sourceUri ?? ""})`, "");
+    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})`, "");
   return lines.join(`
@@ -22262,8 +22307,17 @@ function resolveShowNotesRenderOptions(options) {
     return { error: 'options.runDate (or PODCAST_PUB_RUN_DATE) is required for the "show-notes" operation' };
   }
   const articleBaseUrl = resolveOptionString(options.articleBaseUrl, "PODCAST_PUB_ARTICLE_BASE_URL");
+  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");
   return {
-    renderOptions: { title, runDate, ...articleBaseUrl !== undefined ? { articleBaseUrl } : {} }
+    renderOptions: {
+      title,
+      runDate,
+      ...articleBaseUrl !== undefined ? { articleBaseUrl } : {},
+      ...briefMode ? { briefMode: true } : {},
+      ...articlePostPath !== undefined ? { articlePostPath } : {}
+    }
   };
 }
 function renderShowNotesFromOptions(options) {

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

@@ -28,6 +28,10 @@ interface PodcastPubOptions {
     title?: unknown;
     runDate?: unknown;
     articleBaseUrl?: unknown;
+    /** Brief/timeline render flag (task 0118). */
+    briefMode?: unknown;
+    /** Surfdash publish result `metadata.postPath` (briefMode URL source). */
+    articlePostPath?: unknown;
     /** Episode-assembly options for the `publish` op (absorb publish-prep's merge; additive). */
     audioFile?: unknown;
     coverPath?: unknown;
@@ -76,7 +80,10 @@ function resolveItemId(options: PodcastPubOptions): { itemId: string } | { error
 }
 
 /** Options the `show-notes` operation reads on the payload (a subset of {@link PodcastPubOptions}). */
-type ShowNotesOpOptions = Pick<PodcastPubOptions, 'docs' | 'title' | 'runDate' | 'articleBaseUrl'>;
+type ShowNotesOpOptions = Pick<
+    PodcastPubOptions,
+    'docs' | 'title' | 'runDate' | 'articleBaseUrl' | 'briefMode' | 'articlePostPath'
+>;
 
 /**
  * Option-then-env resolution for the show-notes render options: `kk executor run`
@@ -103,8 +110,17 @@ function resolveShowNotesRenderOptions(
         return { error: 'options.runDate (or PODCAST_PUB_RUN_DATE) is required for the "show-notes" operation' };
     }
     const articleBaseUrl = resolveOptionString(options.articleBaseUrl, 'PODCAST_PUB_ARTICLE_BASE_URL');
+    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');
     return {
-        renderOptions: { title, runDate, ...(articleBaseUrl !== undefined ? { articleBaseUrl } : {}) },
+        renderOptions: {
+            title,
+            runDate,
+            ...(articleBaseUrl !== undefined ? { articleBaseUrl } : {}),
+            ...(briefMode ? { briefMode: true } : {}),
+            ...(articlePostPath !== undefined ? { articlePostPath } : {}),
+        },
     };
 }
 

package/plugins/publishings/podcast-pub/src/show-notes.ts

@@ -82,6 +82,20 @@ export interface ShowNotesRenderOptions {
     runDate: string;
     /** Article base URL; defaults to the production site (surfing.salty.vip). */
     articleBaseUrl?: string;
+    /**
+     * Brief/timeline mode (task 0118): per-item 1–2-sentence briefing + `HH:MM`
+     * timestamp + per-item article link. When no surfdash article path is
+     * available the render degrades to the legacy full-body layout — never
+     * throws, never invents a URL.
+     */
+    briefMode?: boolean;
+    /**
+     * Absolute surfdash `metadata.postPath` from the publish result
+     * (`content/posts/articles/<locale>/<slug>/index.md`); the article URL is
+     * derived O(1) from its slug+locale — authoritative over the title/runDate
+     * slug construction, which stays the fallback.
+     */
+    articlePostPath?: string;
 }
 
 /**
@@ -101,7 +115,18 @@ export function renderShowNotesMarkdown(docs: Doc[], opts: ShowNotesRenderOption
             .replace(/[\s_]+/g, '-');
         return s.length > 0 ? s : 'post';
     };
-    const articleUrl = `${opts.articleBaseUrl ?? 'https://surfing.salty.vip'}/zh/posts/${opts.runDate}-${slugify(opts.title)}`;
+    const baseUrl = opts.articleBaseUrl ?? 'https://surfing.salty.vip';
+    // O(1) postPath derivation (task 0118): the published slug + locale come from
+    // the real path, not from re-slugging the title. Falls back to the legacy
+    // title/runDate construction when no postPath exists (surfdash failed).
+    const segments = opts.articlePostPath?.split(/[\\/]/).filter((s) => s.length > 0) ?? [];
+    const postSlug = segments.length >= 2 ? (segments[segments.length - 2] ?? '') : '';
+    const postLocale = segments.find((s) => ['zh', 'en', 'ja'].includes(s)) ?? 'zh';
+    const articleUrl =
+        postSlug.length > 0
+            ? `${baseUrl}/${postLocale}/posts/${postSlug}`
+            : `${baseUrl}/zh/posts/${opts.runDate}-${slugify(opts.title)}`;
+    const briefMode = opts.briefMode === true && postSlug.length > 0;
     const sourceLabel = (d: Doc): string => {
         const m = d.metadata ?? {};
         if (typeof m.sourceName === 'string' && m.sourceName.trim()) return m.sourceName.trim();
@@ -111,6 +136,23 @@ export function renderShowNotesMarkdown(docs: Doc[], opts: ShowNotesRenderOption
             return '来源';
         }
     };
+    const itemBrief = (d: Doc): string => {
+        const meta = d.metadata ?? {};
+        if (typeof meta.brief === 'string' && meta.brief.trim().length > 0) return meta.brief.trim();
+        return (d.body ?? '')
+            .trim()
+            .split(/(?<=[。！？])\s*/)
+            .slice(0, 2)
+            .join('');
+    };
+    const itemTimestamp = (d: Doc): string => {
+        const meta = d.metadata ?? {};
+        const raw = meta.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 lines: string[] = [`# ${opts.title}`, ''];
     docs.forEach((d, i) => {
         const body = (d.body ?? '').trim();
@@ -118,14 +160,19 @@ export function renderShowNotesMarkdown(docs: Doc[], opts: ShowNotesRenderOption
             .split(/(?<=[。！？])\s*/)
             .slice(0, 2)
             .join('');
-        lines.push(
-            `## ${i + 1}. ${d.title ?? `条目 ${i + 1}`}`,
-            '',
-            sentences,
-            '',
-            `[来源：${sourceLabel(d)}](${d.sourceUri ?? ''})`,
-            '',
-        );
+        lines.push(`## ${i + 1}. ${d.title ?? `条目 ${i + 1}`}`, '');
+        if (briefMode) {
+            // Timeline entry: HH:MM + 1–2-sentence briefing; the trailing link pair
+            // ends with the surfdash article URL (task 0118 R2.1–R2.4).
+            lines.push(
+                `${itemTimestamp(d)} · ${itemBrief(d)}`,
+                '',
+                `[来源：${sourceLabel(d)}](${d.sourceUri ?? ''}) · [文章](${articleUrl})`,
+                '',
+            );
+        } else {
+            lines.push(sentences, '', `[来源：${sourceLabel(d)}](${d.sourceUri ?? ''})`, '');
+        }
     });
     lines.push(`详情见本期完整文章：[ ${opts.title} ](${articleUrl})`, '');
     return lines.join('\n');