@gobing-ai/knowledge-kit 0.0.17 → 0.0.19

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

@@ -19,7 +19,12 @@ vars:
   limit: "10"
   language: "zh"
   voice_profile: "robin-news"
-  voice_generator: "omni-voice-gen"
+  # 20260917: voice driver switch — ominivoice (default, omni-voice-gen) | voicebox (voice-gen).
+  vdriver: "ominivoice"
+  # 20260917 review #7: 8s intro sting prepended to every daily output; empty = skip.
+  intro_music: ".works/kk-daily-ai-voice/AI每日资讯_8秒播客片头.mp3"
+  # 20260917 review #4/#6: surfdash checkout the patch stage commits to.
+  surfdash_root: "/Users/robin/xprojects/surfdash"
   title: ""
   cursor: ""
   state_file: ""
@@ -28,17 +33,23 @@ vars:
   cover_enabled: "true"
   plan_max_items: "20"
   plan_translate_enabled: "true"
+  article_write_enabled: "true"
   plugins_path: ""
+  # Projected by the publish state from 3-publish/<run_date>_17_publish_publish-status.txt;
+  # guards test this var instead of cat-ing the file (state at decision time).
+  publish_status: ""
   last30days_topic: "AI news"
   horizon_hours: "24"
   publish_enabled: "false"
   last30days_enabled: "false"
   run_date: ""
   agent: "inline"
-  surfdash_post_path: ""
   surfdash_en_post_path: ""
   surfdash_ja_post_path: ""
-  qc_categories: "ai-news,ai-industry"
+  # 20260917 funnel: allowlist widened to the whole AI taxonomy in lockstep with
+  # episode-plan-gen's DEFAULT_FILTER_CONFIG — genuine technical/research stories died on
+  # category:not-in-allowlist. `non-ai` stays excluded (that is the point of the gate).
+  qc_categories: "ai-news,ai-technical,ai-research,ai-industry"
   # 0098 dogfood calibration (r7, owner-approved 0099): quality 3→2, impact 2→1 — the shipped
   # defaults rejected 20/20 live candidates (strongest ai-news items died solely on impact:1<2).
   # These pins must move in lockstep with episode-plan-gen's DEFAULT_FILTER_CONFIG (env wins).
@@ -54,13 +65,18 @@ states:
     onEnter:
       - kind: shell
         options:
+          # run_date (dashed or digits; the job worker expands $(date +%F) before spur sees the
+          # JSON — var values reach non-shell steps verbatim) only names the workspace:
+          # daily-prepare composes the real dir as works_dir/kk-daily-ai-voice/<stamp> when
+          # work_dir is empty and always writes the effective work_dir to the cwd-relative
+          # anchor below. Shell actions cannot set vars, so the reads project it (then the
+          # digits-only stamp) into vars before any later state interpolates them.
           command: >-
-            kbin="$(command -v kk 2>/dev/null)";
-            pkg="$(dirname "$(dirname "$(realpath "$kbin" 2>/dev/null)")")";
-            st="$pkg/plugins/kk/scripts/kk-workflow-stages.ts";
-            [ -f "$st" ] || st="plugins/kk/scripts/kk-workflow-stages.ts";
-            [ -f "$st" ] || echo "kk-workflow-stages.ts not found at $st — install or refresh the kk package (bun link in a checkout)" >&2;
-            bun "$st" daily-prepare "${vars.work_dir}" "${vars.limit}" "${vars.cursor}" "${vars.state_file}" "${vars.last30days_enabled}" "${vars.last30days_topic}" "${vars.horizon_hours}"
+            kk stage daily-prepare "${vars.work_dir}" "${vars.limit}" "${vars.cursor}" "${vars.state_file}" "${vars.last30days_enabled}" "${vars.last30days_topic}" "${vars.horizon_hours}" "${vars.run_date}"
+      - kind: file.read.into-var
+        options:
+          path: .spur/runs/kk-daily-ai-voice/work-dir.txt
+          var: work_dir
       - kind: file.read.into-var
         options:
           path: ${vars.work_dir}/run-date.txt
@@ -81,12 +97,7 @@ states:
       - kind: shell
         options:
           command: >-
-            kbin="$(command -v kk 2>/dev/null)";
-            pkg="$(dirname "$(dirname "$(realpath "$kbin" 2>/dev/null)")")";
-            st="$pkg/plugins/kk/scripts/kk-workflow-stages.ts";
-            [ -f "$st" ] || st="plugins/kk/scripts/kk-workflow-stages.ts";
-            [ -f "$st" ] || echo "kk-workflow-stages.ts not found at $st — install or refresh the kk package (bun link in a checkout)" >&2;
-            bun "$st" daily-collect-facts "${vars.work_dir}" "${vars.run_date}" "${vars.plugins_path}"
+            kk stage daily-collect-facts "${vars.work_dir}" "${vars.run_date}" "${vars.plugins_path}"
 
   - id: plan
     description: "Score/dedup/select + annotate the blended Doc[] into the episode plan (episode-plan-gen; annotate rides inside planEpisode)"
@@ -94,12 +105,7 @@ states:
       - kind: shell
         options:
           command: >-
-            kbin="$(command -v kk 2>/dev/null)";
-            pkg="$(dirname "$(dirname "$(realpath "$kbin" 2>/dev/null)")")";
-            st="$pkg/plugins/kk/scripts/kk-workflow-stages.ts";
-            [ -f "$st" ] || st="plugins/kk/scripts/kk-workflow-stages.ts";
-            [ -f "$st" ] || echo "kk-workflow-stages.ts not found at $st — install or refresh the kk package (bun link in a checkout)" >&2;
-            bun "$st" daily-plan "${vars.work_dir}" "${vars.run_date}" "${vars.plugins_path}" "${vars.plan_max_items}"
+            kk stage daily-plan "${vars.work_dir}" "${vars.run_date}" "${vars.plugins_path}" "${vars.plan_max_items}"
 
   - id: quality-control-content
     description: "Content QC: filter the plan's annotated candidates by category allowlist + score thresholds (episode-plan-gen --mode filter); zero candidates route to done-no-content"
@@ -107,12 +113,7 @@ states:
       - kind: shell
         options:
           command: >-
-            kbin="$(command -v kk 2>/dev/null)";
-            pkg="$(dirname "$(dirname "$(realpath "$kbin" 2>/dev/null)")")";
-            st="$pkg/plugins/kk/scripts/kk-workflow-stages.ts";
-            [ -f "$st" ] || st="plugins/kk/scripts/kk-workflow-stages.ts";
-            [ -f "$st" ] || echo "kk-workflow-stages.ts not found at $st — install or refresh the kk package (bun link in a checkout)" >&2;
-            bun "$st" daily-qc-content "${vars.work_dir}" "${vars.run_date}" "${vars.plugins_path}" "${vars.qc_categories}" "${vars.qc_min_quality}" "${vars.qc_min_importance}" "${vars.qc_min_urgency}" "${vars.qc_min_impact}"
+            kk stage daily-qc-content "${vars.work_dir}" "${vars.run_date}" "${vars.plugins_path}" "${vars.qc_categories}" "${vars.qc_min_quality}" "${vars.qc_min_importance}" "${vars.qc_min_urgency}" "${vars.qc_min_impact}"
 
   - id: plan-translate
     description: "Translate needsTranslation plan items into the output plan.json via agent.run"
@@ -124,26 +125,37 @@ states:
           # ADR-115 error tier: keep this prompt <= 1000 chars (0133 R3; 0138 R4a adds the copy discipline).
           input: |
             Read ${vars.work_dir}/2-plan/${vars.run_date}_04_quality-control-content_candidates.json — metadata.docs (Doc[]) is the plan; don't edit it.
-            For items with needsTranslation, translate "title" and "body" into natural, concise simplified Chinese.
-            Titles read as a news event (subject + action + object) from the body — e.g. "OpenAI 发布 Sora 应用，集成 Sora 2 模型". Keep product/model/company names verbatim, preserve body URLs, use 「」 not ASCII double quotes.
+            For items with needsTranslation, translate "title", "body", and "metadata.brief" (when present) into natural simplified Chinese.
+            Titles read as a news event (subject + action + object) — e.g. "OpenAI 发布 Sora 应用，集成 Sora 2 模型". Keep product/model/company names verbatim, preserve body URLs, use 「」 not ASCII double quotes.
             Copy discipline: reader-facing news copy — no scaffold labels (「可做角度」「为什么现在值得注意」「社区讨论」「背景」「潜在影响」「影响」), no duplicated labels or hedging (「读者宜另行核实」「仍待验证」) — merge their substance into prose or drop.
             Keep other fields (id, sourceUri, mediaType, metadata), technical terms as-is; no trailing commas or comments.
             Output strictly valid JSON — a same-length, same-order array with the same ids — to ${vars.work_dir}/2-plan/${vars.run_date}_03_plan_plan.json.
           expectFile: ${vars.work_dir}/2-plan/${vars.run_date}_03_plan_plan.json
           allowAppend: false
 
+  - id: article-write
+    description: "Write the morning-news prose article from the translated plan via agent.run (3-format split: surfdash gets prose, not a news list)"
+    onEnter:
+      - kind: agent.run
+        options:
+          role: scribe
+          agent: ${vars.agent}
+          # ADR-115 error tier: keep this prompt <= 1000 chars (0133 R3).
+          input: |
+            Read ${vars.work_dir}/2-plan/${vars.run_date}_03_plan_plan.json — metadata.docs (Doc[]) is the translated plan; don't edit it.
+            Write a morning-news prose article in natural simplified Chinese: title line "# 每日 AI 资讯 — ${vars.run_date}", an intro paragraph (2–3 sentences), then one section per item (## numbered title, 2–4 sentences of flowing prose, source link [来源：<label>](<sourceUri>) inline), a closing paragraph tying items together.
+            Narrative register — smooth transitions between items, no list-like bulleting, no scaffold labels (「可做角度」「背景」「潜在影响」), no hedging (「读者宜另行核实」「仍待验证」). Keep facts/URLs from the plan verbatim; product/model names as-is; 「」 quotes.
+            Output the markdown to ${vars.work_dir}/2-article/${vars.run_date}_06_article-write_body.md.
+          expectFile: ${vars.work_dir}/2-article/${vars.run_date}_06_article-write_body.md
+          allowAppend: false
+
   - id: article
     description: "Generate the dated daily article from the episode plan (daily-article-gen template)"
     onEnter:
       - kind: shell
         options:
           command: >-
-            kbin="$(command -v kk 2>/dev/null)";
-            pkg="$(dirname "$(dirname "$(realpath "$kbin" 2>/dev/null)")")";
-            st="$pkg/plugins/kk/scripts/kk-workflow-stages.ts";
-            [ -f "$st" ] || st="plugins/kk/scripts/kk-workflow-stages.ts";
-            [ -f "$st" ] || echo "kk-workflow-stages.ts not found at $st — install or refresh the kk package (bun link in a checkout)" >&2;
-            bun "$st" daily-article "${vars.work_dir}" "${vars.run_date}" "${vars.plugins_path}"
+            kk stage daily-article "${vars.work_dir}" "${vars.run_date}" "${vars.plugins_path}"
 
   - id: cover
     description: "Generate the article cover image via the kk:image-authoring skill (agent.run)"
@@ -162,12 +174,7 @@ states:
       - kind: shell
         options:
           command: >-
-            kbin="$(command -v kk 2>/dev/null)";
-            pkg="$(dirname "$(dirname "$(realpath "$kbin" 2>/dev/null)")")";
-            st="$pkg/plugins/kk/scripts/kk-workflow-stages.ts";
-            [ -f "$st" ] || st="plugins/kk/scripts/kk-workflow-stages.ts";
-            [ -f "$st" ] || echo "kk-workflow-stages.ts not found at $st — install or refresh the kk package (bun link in a checkout)" >&2;
-            bun "$st" daily-cover-normalize "${vars.work_dir}" "${vars.run_date}"
+            kk stage daily-cover-normalize "${vars.work_dir}" "${vars.run_date}"
 
   - id: script
     description: "Compile the episode plan Doc[] into structured broadcast VoiceScript YAML Content"
@@ -175,12 +182,7 @@ states:
       - kind: shell
         options:
           command: >-
-            kbin="$(command -v kk 2>/dev/null)";
-            pkg="$(dirname "$(dirname "$(realpath "$kbin" 2>/dev/null)")")";
-            st="$pkg/plugins/kk/scripts/kk-workflow-stages.ts";
-            [ -f "$st" ] || st="plugins/kk/scripts/kk-workflow-stages.ts";
-            [ -f "$st" ] || echo "kk-workflow-stages.ts not found at $st — install or refresh the kk package (bun link in a checkout)" >&2;
-            bun "$st" daily-script "${vars.work_dir}" "${vars.run_date}" "${vars.plugins_path}" "${vars.language}" "${vars.title}" "${vars.voice_profile}"
+            kk stage daily-script "${vars.work_dir}" "${vars.run_date}" "${vars.plugins_path}" "${vars.language}" "${vars.title}" "${vars.voice_profile}"
 
   - id: review
     description: "Operator reviews the generated news script before speech synthesis"
@@ -197,25 +199,23 @@ states:
       - kind: shell
         options:
           command: >-
-            kbin="$(command -v kk 2>/dev/null)";
-            pkg="$(dirname "$(dirname "$(realpath "$kbin" 2>/dev/null)")")";
-            st="$pkg/plugins/kk/scripts/kk-workflow-stages.ts";
-            [ -f "$st" ] || st="plugins/kk/scripts/kk-workflow-stages.ts";
-            [ -f "$st" ] || echo "kk-workflow-stages.ts not found at $st — install or refresh the kk package (bun link in a checkout)" >&2;
-            bun "$st" daily-wrap-docs "${vars.work_dir}" "${vars.run_date}" "${vars.voice_profile}"
+            kk stage daily-wrap-docs "${vars.work_dir}" "${vars.run_date}" "${vars.voice_profile}"
 
   - id: generate
-    description: "Invoke voice generator plugin (voice_generator var) to generate audio"
+    description: "Invoke voice driver plugin (vdriver var: ominivoice -> omni-voice-gen, voicebox -> voice-gen) to generate audio"
     onEnter:
       - kind: shell
         options:
           command: >-
-            kbin="$(command -v kk 2>/dev/null)";
-            pkg="$(dirname "$(dirname "$(realpath "$kbin" 2>/dev/null)")")";
-            st="$pkg/plugins/kk/scripts/kk-workflow-stages.ts";
-            [ -f "$st" ] || st="plugins/kk/scripts/kk-workflow-stages.ts";
-            [ -f "$st" ] || echo "kk-workflow-stages.ts not found at $st — install or refresh the kk package (bun link in a checkout)" >&2;
-            bun "$st" daily-generate "${vars.work_dir}" "${vars.run_date}" "${vars.plugins_path}" "${vars.transcode_mp3}" "${vars.voice_generator}"
+            OMNIVOICE_SPEED=1.06 kk stage daily-generate "${vars.work_dir}" "${vars.run_date}" "${vars.plugins_path}" "${vars.transcode_mp3}" "${vars.vdriver}"
+
+  - id: intro-music
+    description: "Prepend the 8s intro sting (intro_music var; empty = skip) to the generated wav, update duration/audioPath"
+    onEnter:
+      - kind: shell
+        options:
+          command: >-
+            kk stage daily-intro "${vars.work_dir}" "${vars.run_date}" "${vars.intro_music}"
 
   - id: quality-control
     description: "Verify audio quality, speech rate, and silence/repetition QC metrics"
@@ -223,12 +223,7 @@ states:
       - kind: shell
         options:
           command: >-
-            kbin="$(command -v kk 2>/dev/null)";
-            pkg="$(dirname "$(dirname "$(realpath "$kbin" 2>/dev/null)")")";
-            st="$pkg/plugins/kk/scripts/kk-workflow-stages.ts";
-            [ -f "$st" ] || st="plugins/kk/scripts/kk-workflow-stages.ts";
-            [ -f "$st" ] || echo "kk-workflow-stages.ts not found at $st — install or refresh the kk package (bun link in a checkout)" >&2;
-            bun "$st" daily-quality-report "${vars.work_dir}" "${vars.run_date}"
+            kk stage daily-quality-report "${vars.work_dir}" "${vars.run_date}"
 
   - 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)"
@@ -236,12 +231,7 @@ states:
       - kind: shell
         options:
           command: >-
-            kbin="$(command -v kk 2>/dev/null)";
-            pkg="$(dirname "$(dirname "$(realpath "$kbin" 2>/dev/null)")")";
-            st="$pkg/plugins/kk/scripts/kk-workflow-stages.ts";
-            [ -f "$st" ] || st="plugins/kk/scripts/kk-workflow-stages.ts";
-            [ -f "$st" ] || echo "kk-workflow-stages.ts not found at $st — install or refresh the kk package (bun link in a checkout)" >&2;
-            bun "$st" daily-publish-prep "${vars.work_dir}" "${vars.run_date}"
+            kk stage daily-publish-prep "${vars.work_dir}" "${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)"
@@ -249,12 +239,7 @@ states:
       - kind: shell
         options:
           command: >-
-            kbin="$(command -v kk 2>/dev/null)";
-            pkg="$(dirname "$(dirname "$(realpath "$kbin" 2>/dev/null)")")";
-            st="$pkg/plugins/kk/scripts/kk-workflow-stages.ts";
-            [ -f "$st" ] || st="plugins/kk/scripts/kk-workflow-stages.ts";
-            [ -f "$st" ] || echo "kk-workflow-stages.ts not found at $st — install or refresh the kk package (bun link in a checkout)" >&2;
-            bun "$st" daily-publish-surfdash "${vars.work_dir}" "${vars.run_date}" "${vars.plugins_path}"
+            kk stage daily-publish-surfdash "${vars.work_dir}" "${vars.run_date}" "${vars.plugins_path}"
 
   - id: show-notes
     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)"
@@ -262,12 +247,7 @@ states:
       - kind: shell
         options:
           command: >-
-            kbin="$(command -v kk 2>/dev/null)";
-            pkg="$(dirname "$(dirname "$(realpath "$kbin" 2>/dev/null)")")";
-            st="$pkg/plugins/kk/scripts/kk-workflow-stages.ts";
-            [ -f "$st" ] || st="plugins/kk/scripts/kk-workflow-stages.ts";
-            [ -f "$st" ] || echo "kk-workflow-stages.ts not found at $st — install or refresh the kk package (bun link in a checkout)" >&2;
-            bun "$st" daily-show-notes "${vars.work_dir}" "${vars.run_date}" "${vars.plugins_path}" "${vars.title}"
+            kk stage daily-show-notes "${vars.work_dir}" "${vars.run_date}" "${vars.plugins_path}" "${vars.title}"
 
   - 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)"
@@ -275,12 +255,7 @@ states:
       - kind: shell
         options:
           command: >-
-            kbin="$(command -v kk 2>/dev/null)";
-            pkg="$(dirname "$(dirname "$(realpath "$kbin" 2>/dev/null)")")";
-            st="$pkg/plugins/kk/scripts/kk-workflow-stages.ts";
-            [ -f "$st" ] || st="plugins/kk/scripts/kk-workflow-stages.ts";
-            [ -f "$st" ] || echo "kk-workflow-stages.ts not found at $st — install or refresh the kk package (bun link in a checkout)" >&2;
-            bun "$st" daily-publish-podcast "${vars.work_dir}" "${vars.run_date}" "${vars.plugins_path}"
+            kk stage daily-publish-podcast "${vars.work_dir}" "${vars.run_date}" "${vars.plugins_path}"
 
   - id: publish
     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)"
@@ -288,12 +263,19 @@ states:
       - kind: shell
         options:
           command: >-
-            kbin="$(command -v kk 2>/dev/null)";
-            pkg="$(dirname "$(dirname "$(realpath "$kbin" 2>/dev/null)")")";
-            st="$pkg/plugins/kk/scripts/kk-workflow-stages.ts";
-            [ -f "$st" ] || st="plugins/kk/scripts/kk-workflow-stages.ts";
-            [ -f "$st" ] || echo "kk-workflow-stages.ts not found at $st — install or refresh the kk package (bun link in a checkout)" >&2;
-            bun "$st" daily-publish-classify "${vars.work_dir}" "${vars.run_date}"
+            kk stage daily-publish-classify "${vars.work_dir}" "${vars.run_date}"
+      - kind: file.read.into-var
+        options:
+          path: ${vars.work_dir}/3-publish/${vars.run_date}_17_publish_publish-status.txt
+          var: publish_status
+
+  - id: patch-surfdash
+    description: "20260917 #4/#6 — patch published surfdash posts: podcast cover URL into image/og_image frontmatter + podcast cross-link (zh/en/ja), commit+push"
+    onEnter:
+      - kind: shell
+        options:
+          command: >-
+            kk stage daily-patch-surfdash "${vars.work_dir}" "${vars.run_date}" "${vars.surfdash_root}"
 
   - 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 (task 0118: surfdash failure = no-URL fallback notes; podcast failure = its own partial)"
@@ -301,12 +283,7 @@ states:
       - kind: shell
         options:
           command: >-
-            kbin="$(command -v kk 2>/dev/null)";
-            pkg="$(dirname "$(dirname "$(realpath "$kbin" 2>/dev/null)")")";
-            st="$pkg/plugins/kk/scripts/kk-workflow-stages.ts";
-            [ -f "$st" ] || st="plugins/kk/scripts/kk-workflow-stages.ts";
-            [ -f "$st" ] || echo "kk-workflow-stages.ts not found at $st — install or refresh the kk package (bun link in a checkout)" >&2;
-            bun "$st" daily-publish-partial "${vars.work_dir}" "${vars.run_date}"
+            kk stage daily-publish-partial "${vars.work_dir}" "${vars.run_date}"
 
   - 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"
@@ -314,91 +291,38 @@ states:
       - kind: shell
         options:
           command: >-
-            kbin="$(command -v kk 2>/dev/null)";
-            pkg="$(dirname "$(dirname "$(realpath "$kbin" 2>/dev/null)")")";
-            st="$pkg/plugins/kk/scripts/kk-workflow-stages.ts";
-            [ -f "$st" ] || st="plugins/kk/scripts/kk-workflow-stages.ts";
-            [ -f "$st" ] || echo "kk-workflow-stages.ts not found at $st — install or refresh the kk package (bun link in a checkout)" >&2;
-            bun "$st" daily-run-report "${vars.work_dir}" "${vars.run_date}" "${vars.plugins_path}" "${vars.qc_min_quality}" "${vars.qc_min_importance}" "${vars.qc_min_urgency}" "${vars.qc_min_impact}"
-
-  - 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)"
+            kk stage daily-run-report "${vars.work_dir}" "${vars.run_date}" "${vars.plugins_path}" "${vars.qc_min_quality}" "${vars.qc_min_importance}" "${vars.qc_min_urgency}" "${vars.qc_min_impact}"
+
+  - id: translate
+    description: "Locales — surfdash-pub scaffolds en/ja drafts (deterministic, plugin-owned), agent translates both, sync into the surfdash CMS"
     onEnter:
       - kind: shell
         options:
           command: >-
-            kbin="$(command -v kk 2>/dev/null)";
-            pkg="$(dirname "$(dirname "$(realpath "$kbin" 2>/dev/null)")")";
-            st="$pkg/plugins/kk/scripts/kk-workflow-stages.ts";
-            [ -f "$st" ] || st="plugins/kk/scripts/kk-workflow-stages.ts";
-            [ -f "$st" ] || echo "kk-workflow-stages.ts not found at $st — install or refresh the kk package (bun link in a checkout)" >&2;
-            bun "$st" daily-translate-en "${vars.work_dir}" "${vars.run_date}" "${vars.plugins_path}"
-      - kind: file.read.into-var
-        options:
-          path: ${vars.work_dir}/3-publish/${vars.run_date}_20_translate-en_zh-post-path.txt
-          var: surfdash_post_path
+            kk stage daily-translate-localize "${vars.work_dir}" "${vars.run_date}" "${vars.plugins_path}"
       - kind: file.read.into-var
         options:
-          path: ${vars.work_dir}/3-publish/${vars.run_date}_20_translate-en_en-post-path.txt
+          path: ${vars.work_dir}/3-publish/${vars.run_date}_20_translate-localize_en-post-path.txt
           var: surfdash_en_post_path
-
-  - id: translate-en-agent
-    description: "Translate the en draft in place via agent.run"
-    onEnter:
-      - kind: agent.run
-        options:
-          role: scribe
-          agent: ${vars.agent}
-          input: |
-            Translate the English draft post at ${vars.surfdash_en_post_path} from Chinese to English.
-            Edit the file in place: translate the title in frontmatter and the whole markdown body to natural English. Keep frontmatter keys, dates, URLs, code, and the assets/ image reference untouched. Keep the draft: true flag.
-            Read the surfdash translator glossary if present at the surfdash checkout root under .agents/skills/surfdash-translator/glossary.md and apply its terminology.
-            Do not wait for operator confirmation. The file must end fully in English.
-          expectFile: ${vars.surfdash_en_post_path}
-
-  - id: translate-ja
-    description: "Scaffold ja draft from the zh article via surfdash-pub scaffold-locale (sed-derived path as cache pre-check; plugin's draftPath is authoritative once scaffolded)"
-    onEnter:
-      - kind: shell
-        options:
-          command: >-
-            kbin="$(command -v kk 2>/dev/null)";
-            pkg="$(dirname "$(dirname "$(realpath "$kbin" 2>/dev/null)")")";
-            st="$pkg/plugins/kk/scripts/kk-workflow-stages.ts";
-            [ -f "$st" ] || st="plugins/kk/scripts/kk-workflow-stages.ts";
-            [ -f "$st" ] || echo "kk-workflow-stages.ts not found at $st — install or refresh the kk package (bun link in a checkout)" >&2;
-            bun "$st" daily-translate-ja "${vars.work_dir}" "${vars.run_date}" "${vars.plugins_path}"
       - kind: file.read.into-var
         options:
-          path: ${vars.work_dir}/3-publish/${vars.run_date}_22_translate-ja_ja-post-path.txt
+          path: ${vars.work_dir}/3-publish/${vars.run_date}_20_translate-localize_ja-post-path.txt
           var: surfdash_ja_post_path
-
-  - id: translate-ja-agent
-    description: "Translate the ja draft in place via agent.run"
-    onEnter:
       - kind: agent.run
         options:
           role: scribe
           agent: ${vars.agent}
           input: |
-            Translate the Japanese draft post at ${vars.surfdash_ja_post_path} from Chinese to Japanese.
-            Edit the file in place: translate the title in frontmatter and the whole markdown body to natural Japanese. Keep frontmatter keys, dates, URLs, code, and the assets/ image reference untouched. Keep the draft: true flag.
-            Read the surfdash translator glossary if present at the surfdash checkout root under .agents/skills/surfdash-translator/glossary.md and apply its terminology.
-            Do not wait for operator confirmation. The file must end fully in Japanese.
-          expectFile: ${vars.surfdash_ja_post_path}
-
-  - id: translate-sync
-    description: "Sync the zh post and its en/ja locale variants into the surfdash CMS (surfdash-pub sync operation)"
-    onEnter:
+            Translate en/ja draft posts of the zh article — two independent files:
+            English draft: ${vars.surfdash_en_post_path}
+            Japanese draft: ${vars.surfdash_ja_post_path}
+            For each: if its path above is empty, skip that locale. Otherwise edit the file in place — translate the frontmatter title and the whole markdown body to natural English/Japanese respectively. Keep frontmatter keys, dates, URLs, code, and the assets/ image reference untouched. Set draft: false (the translated post publishes to the site) and remove any canonical: frontmatter line pointing at a different locale's URL.
+            Keep frontmatter valid YAML: double-quote any value containing ': '. Read the surfdash translator glossary if present at the surfdash checkout root under .agents/skills/surfdash-translator/glossary.md and apply its terminology.
+            Do not wait for operator confirmation. Each edited file must end fully in its target language.
       - kind: shell
         options:
           command: >-
-            kbin="$(command -v kk 2>/dev/null)";
-            pkg="$(dirname "$(dirname "$(realpath "$kbin" 2>/dev/null)")")";
-            st="$pkg/plugins/kk/scripts/kk-workflow-stages.ts";
-            [ -f "$st" ] || st="plugins/kk/scripts/kk-workflow-stages.ts";
-            [ -f "$st" ] || echo "kk-workflow-stages.ts not found at $st — install or refresh the kk package (bun link in a checkout)" >&2;
-            bun "$st" daily-translate-sync "${vars.work_dir}" "${vars.run_date}" "${vars.plugins_path}" "${vars.surfdash_post_path}"
+            kk stage daily-translate-sync "${vars.work_dir}" "${vars.run_date}" "${vars.plugins_path}" "${vars.work_dir}/3-publish/${vars.run_date}_20_translate-localize_zh-post-path.txt"
 
   - id: done
     description: "Terminal — Daily AI news pipeline completed (collect → QC'd plan → article/cover/script/voice → publish/locales)"
@@ -444,17 +368,41 @@ transitions:
       options:
         command: 'test "${vars.plan_translate_enabled}" = "true"'
 
+  - from: quality-control-content
+    to: article-write
+    description: "Candidates passed QC, plan-translate disabled, prose enabled -> straight to article-write"
+    guard:
+      kind: shell
+      options:
+        command: 'test "${vars.plan_translate_enabled}" != "true" && test "${vars.article_write_enabled}" = "true"'
+
   - from: quality-control-content
     to: article
-    description: "Candidates passed QC, plan-translate disabled -> straight to article"
+    description: "Prose disabled -> package the template article directly"
+    guard:
+      kind: shell
+      options:
+        command: 'test "${vars.article_write_enabled}" != "true"'
+
+  - from: plan-translate
+    to: article-write
+    description: "Plan translated and prose enabled -> write prose article from plan"
     guard:
       kind: shell
       options:
-        command: 'test "${vars.plan_translate_enabled}" != "true"'
+        command: 'test "${vars.article_write_enabled}" = "true"'
 
   - from: plan-translate
     to: article
-    description: "Plan translated -> generate article from plan"
+    description: "Plan translated, prose disabled -> package the template article"
+    guard:
+      kind: shell
+      options:
+        command: 'test "${vars.article_write_enabled}" != "true"'
+
+  - from: article-write
+    to: article
+    description: "Prose body written -> package article content"
     guard:
       kind: always
 
@@ -570,12 +518,16 @@ transitions:
       kind: always
 
   - from: publish
+    to: patch-surfdash
+    description: "Publish classified -> patch surfdash posts with cover + podcast cross-link"
+    guard:
+      kind: always
+
+  - from: patch-surfdash
     to: run-report
-    description: "Publish full (all targets published) -> assemble run report first"
+    description: "Posts patched -> assemble run report"
     guard:
-      kind: shell
-      options:
-        command: 'test "$(cat "${vars.work_dir}/3-publish/${vars.run_date}_17_publish_publish-status.txt")" = "full"'
+      kind: always
 
   - from: publish
     to: publish-partial
@@ -583,7 +535,7 @@ transitions:
     guard:
       kind: shell
       options:
-        command: 'test "$(cat "${vars.work_dir}/3-publish/${vars.run_date}_17_publish_publish-status.txt")" = "partial"'
+        command: 'test "${vars.publish_status}" = "partial"'
 
   - from: publish
     to: failed
@@ -591,7 +543,7 @@ transitions:
     guard:
       kind: shell
       options:
-        command: 'test "$(cat "${vars.work_dir}/3-publish/${vars.run_date}_17_publish_publish-status.txt")" = "none"'
+        command: 'test "${vars.publish_status}" = "none"'
 
   - from: publish-partial
     to: run-report
@@ -600,12 +552,12 @@ transitions:
       kind: always
 
   - from: run-report
-    to: translate-en
-    description: "Run report assembled after full publish -> scaffold + translate en locale"
+    to: translate
+    description: "Run report assembled after full publish -> scaffold + translate en/ja locales + sync"
     guard:
       kind: shell
       options:
-        command: 'test "$(cat "${vars.work_dir}/3-publish/${vars.run_date}_17_publish_publish-status.txt")" = "full"'
+        command: 'test "${vars.publish_status}" = "full"'
 
   - from: run-report
     to: done
@@ -613,50 +565,10 @@ transitions:
     guard:
       kind: shell
       options:
-        command: 'test "$(cat "${vars.work_dir}/3-publish/${vars.run_date}_17_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"
-    guard:
-      kind: shell
-      options:
-        command: 'test -n "${vars.surfdash_post_path}" && test -f "${vars.surfdash_en_post_path}"'
-
-  - from: translate-en
-    to: translate-ja
-    description: "no zh post path -> skip en locale"
-    guard:
-      kind: always
-
-  - from: translate-en-agent
-    to: translate-ja
-    description: "en draft translated -> scaffold ja locale"
-    guard:
-      kind: always
-
-  - from: translate-ja
-    to: translate-ja-agent
-    description: "zh post published and ja draft scaffolded -> agent translates ja draft in place"
-    guard:
-      kind: shell
-      options:
-        command: 'test -n "${vars.surfdash_post_path}" && test -f "${vars.surfdash_ja_post_path}"'
-
-  - from: translate-ja
-    to: translate-sync
-    description: "no zh post path -> skip ja locale"
-    guard:
-      kind: always
-
-  - from: translate-ja-agent
-    to: translate-sync
-    description: "ja draft translated -> sync all locales into the CMS"
-    guard:
-      kind: always
+        command: 'test "${vars.publish_status}" = "partial"'
 
-  - from: translate-sync
+  - from: translate
     to: done
-    description: "zh post + locales synced into surfdash CMS -> episode complete"
+    description: "zh post + en/ja locales scaffolded, translated, and synced into the surfdash CMS -> episode complete"
     guard:
       kind: always

package/plugins/kk/workflows/leftover-publish-fanout-example.yaml

@@ -0,0 +1,53 @@
+"$schema": "@gobing-ai/spur/schemas/state-machine-workflow.schema.json"
+kind: state-machine
+name: leftover-publish-fanout-example
+description: >-
+  Example: fan out two leftover file-cli channels (medium-pub, wechatmp-pub),
+  then sequence one agent-default CMS channel (juejin-pub) as agent.run.
+  kk fanout does not spawn an LLM.
+initialState: fanout-file-cli
+terminalStates:
+  - done
+  - failed
+failureStates:
+  - failed
+vars:
+  contentFile: ".spur/run/content.json"
+  fanoutFile: ".spur/run/fanout-result.json"
+  juejinFile: ".spur/run/juejin-result.json"
+  spurBin: "spur"
+states:
+  - id: fanout-file-cli
+    description: "kk fanout over leftover file-cli channels (medium + wechatmp draft)"
+    onEnter:
+      - kind: shell
+        options:
+          command: >-
+            kk fanout --in ${vars.contentFile}
+            --targets medium-pub,wechatmp-pub
+            --out ${vars.fanoutFile}
+  - id: agent-juejin
+    description: "Agent-default CMS channel — workflow agent.run, not kk fanout"
+    onEnter:
+      - kind: agent.run
+        options:
+          role: coder
+          input: |
+            Invoke the kk:publish skill for juejin.
+            Drive ~/.config/kk/browser-profiles/juejin as driver=agent.
+            Then `kk executor run juejin-pub --in ${vars.contentFile} --out ${vars.juejinFile}`.
+            Do not embed an LLM in the plugin process. Do not call kk fanout for this channel.
+          expectFile: ${vars.juejinFile}
+  - id: done
+    description: "Fan-out aggregate plus agent CMS Result written"
+  - id: failed
+    description: "A file-cli target or the agent CMS step failed loud"
+transitions:
+  - from: fanout-file-cli
+    to: agent-juejin
+    guard:
+      kind: always
+  - from: agent-juejin
+    to: done
+    guard:
+      kind: always