@gobing-ai/knowledge-kit 0.0.16 → 0.0.18

package/plugins/kk/scripts/validate-voicescript.ts

@@ -118,6 +118,59 @@ function assertCrossfade(value: number | undefined): void {
     }
 }
 
+// ─── Content checks (task 0139 R3) ───────────────────────────────────────────
+// Deterministic spoken-copy gates. The workflow wires this validator at the end of the script
+// stage's fresh write and again in wrap-docs (which covers a HITL-edited YAML and the script cache
+// path), so a voicescript that reaches audio carries no title echo, no duplicated segment, no
+// research scaffolding and no colon-mangled URL. Every failure names the segment index and reason.
+
+/** Punctuation/space the translator drifts between a title and its body restatement. */
+const CONTENT_ECHO_NOISE_RE = /[，。、：:；;!！?？…\s「」『』【】]/g;
+/** Research scaffold labels the plan-translate stage must not emit as spoken copy. */
+const CONTENT_SCAFFOLD_LABEL_RE =
+    /^(?:\*\*)?[「『]?(?:背景|潜在影响|可做角度|为什么现在值得注意|社区讨论)[」』]?(?:\*\*)?(?:[：:，,]|\s|$)/;
+/** `标签，` metadata tails — the plan item's tag line spoken aloud. */
+const CONTENT_TAG_TAIL_RE = /标签[：:，,]/;
+/** `wss，//` / `https。//` — the translator replacing a URL colon with a Chinese comma. */
+const CONTENT_URL_MANGLE_RE = /[，。]\/\//;
+
+function assertSegmentContent(script: VoiceScript): void {
+    const seen = new Map<string, number>();
+    for (let idx = 0; idx < script.segments.length; idx++) {
+        const text = (script.segments[idx]?.text ?? '').trim();
+        if (text === '') continue;
+
+        const previous = seen.get(text);
+        if (previous !== undefined) {
+            throw new Error(`content check failed: segment ${idx} duplicates segment ${previous} verbatim`);
+        }
+        seen.set(text, idx);
+
+        // Title echo: the 【lead】 content reappearing immediately after the lead, punctuation-drift
+        // tolerant — the same comparison `stripLeadingTitleEcho` uses on the producer side.
+        const lead = text.match(/^[^【]*【([^】]{4,80})】[，。、\s]*/);
+        if (lead !== null) {
+            const bracketed = (lead[1] ?? '').replace(CONTENT_ECHO_NOISE_RE, '');
+            const rest = text.slice(lead[0].length).replace(CONTENT_ECHO_NOISE_RE, '');
+            if (bracketed.length >= 4 && rest.startsWith(bracketed)) {
+                throw new Error(
+                    `content check failed: segment ${idx} repeats its 【${lead[1]}】 title in the body text`,
+                );
+            }
+        }
+
+        if (CONTENT_SCAFFOLD_LABEL_RE.test(text)) {
+            throw new Error(`content check failed: segment ${idx} opens with a research scaffold label`);
+        }
+        if (CONTENT_TAG_TAIL_RE.test(text)) {
+            throw new Error(`content check failed: segment ${idx} carries a 标签 metadata tail`);
+        }
+        if (CONTENT_URL_MANGLE_RE.test(text)) {
+            throw new Error(`content check failed: segment ${idx} has a colon-mangled URL`);
+        }
+    }
+}
+
 function validateVoiceScript(script: VoiceScript): void {
     if (!script || typeof script !== 'object') {
         throw new Error('VoiceScript must be an object');
@@ -173,6 +226,8 @@ function validateVoiceScript(script: VoiceScript): void {
         assertEngine(segment.engine, `Segment at index ${idx}`);
         assertLanguage(segment.language, `Segment at index ${idx}`);
     }
+
+    assertSegmentContent(script);
 }
 
 function main(): void {

package/plugins/kk/skills/publish/SKILL.md

@@ -0,0 +1,80 @@
+---
+name: publish
+description: >-
+  Thin operator surface for leftover publish channels — "publish this draft to
+  Medium", "fan out to Qiita and Medium", "prepare a Juejin draft". Shells
+  `kk executor run` / `kk fanout` for file-cli and script channels; sequences
+  agent-default CMS channels as workflow `agent.run` steps. Does not own
+  transport.
+---
+
+# publish — leftover channel operator surface
+
+## Purpose
+
+Drive harvested `kind: publish` plugins after a draft exists. **The plugin owns
+transport and Result.** This skill selects the channel, confirms draft vs live,
+and shells `kk` — it does not call an LLM from inside a plugin process and does
+not add a `kk publish` noun.
+
+## Channels
+
+| Channel | Plugin | Transport | How this skill invokes it |
+| --- | --- | --- | --- |
+| medium | `medium-pub` | `file-cli` (token API) | `kk executor run medium-pub --in <content.json> --out <result.json>` |
+| wechatmp | `wechatmp-pub` | `file-cli` (`draft/add`) | `kk executor run wechatmp-pub` (default operation `draft`) |
+| x post | `x-pub` | `file-cli` (`POST /2/tweets`) | `kk executor run x-pub` (`options.operation` omitted / `post`) |
+| x article | `x-pub` | `browser` / `agent` | workflow `agent.run` — not `kk fanout` |
+| juejin | `juejin-pub` | `browser` / `agent` | workflow `agent.run` |
+| infoq | `infoq-pub` | `browser` / `agent` | workflow `agent.run` |
+| substack | `substack-pub` | `browser` / `agent` | workflow `agent.run` |
+| xhs | `xhs-pub` | `browser` / `agent` | workflow `agent.run` |
+
+Already-harvested file-cli channels (`qiita-pub`, `zenn-pub`, `surfdash-pub`,
+`emdash-pub`, `podcast-pub`) compose the same way.
+
+## Do not
+
+- Embed Playwright selectors or reimplement a transport here.
+- Spawn an LLM from `kk fanout` (ADR-007 R4). Agent-default channels are
+  sequential workflow `agent.run` steps — see
+  `plugins/kk/workflows/leftover-publish-fanout-example.yaml`.
+- Add a first-layer `kk publish` command.
+- Put secrets in `--in` JSON or `plugin.json`. Env only.
+
+## Confirmation
+
+Default Result is **draft / unpublished**. Live publish (`public`, WeChat
+`freepublish/submit`, CMS submit) requires an explicit operator confirmation
+in this skill before the plugin is invoked with a live status. Under
+`KK_NONINTERACTIVE=1`, proceed only when the `--in` payload already carries
+the confirmed live status; otherwise fail naming the switch.
+
+## Invocation
+
+```
+<channel> [--in <content.json>] [--out <result.json>] [--live]
+          [--fanout <channel>,<channel>]
+```
+
+1. Resolve `--in` Content (required).
+2. If `--fanout` lists two or more **file-cli or script** channels: run
+   `kk fanout --in <content.json> --targets <list> --out <aggregate.json>`.
+   Each target contributes one `targets[]` Result entry.
+3. If the channel's default driver is `agent`: do **not** call `kk fanout`.
+   Tell the operator (or the workflow) to run the page against
+   `~/.config/kk/browser-profiles/<channel>` then `kk executor run <plugin>`
+   so the plugin writes Result. The example workflow sequences that as
+   `agent.run`.
+4. Otherwise: `kk executor run <plugin> --in … --out …`.
+5. Report `--out` `ok`, `target`, `id`/`url`, and `error` verbatim on failure.
+
+## Env (plugin-owned; never echoed)
+
+| Plugin | Required |
+| --- | --- |
+| medium-pub | `MEDIUM_INTEGRATION_TOKEN` |
+| wechatmp-pub | `WECHAT_APP_ID`, `WECHAT_APP_SECRET` |
+| x-pub `post` | `X_API_KEY`, `X_API_SECRET`, `X_ACCESS_TOKEN`, `X_ACCESS_TOKEN_SECRET` |
+
+Missing env → plugin exit 1, `Result.ok false`, error names the variable.

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,6 +33,7 @@ vars:
   cover_enabled: "true"
   plan_max_items: "20"
   plan_translate_enabled: "true"
+  article_write_enabled: "true"
   plugins_path: ""
   last30days_topic: "AI news"
   horizon_hours: "24"
@@ -35,10 +41,12 @@ vars:
   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).
@@ -121,15 +129,33 @@ states:
         options:
           role: scribe
           agent: ${vars.agent}
+          # 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 — its metadata.docs (Doc[]) is the episode plan to translate. Do not edit candidates.json.
-            For every item with needsTranslation, translate "title" and "body" into natural, concise simplified Chinese.
-            Titles must read as a news event (subject + action + object), derived from the body — e.g. "OpenAI 发布 Sora 应用，集成 Sora 2 模型". Keep product/model/company names verbatim, preserve URLs inside the body, and use 「」 instead of raw ASCII double quotes inside Chinese text.
-            Keep every other field untouched (id, sourceUri, mediaType, metadata), keep technical terms in their original form where that is clearer, and produce no trailing commas or comments.
-            Output strictly valid JSON — a same-length, same-order array carrying the same ids — to ${vars.work_dir}/2-plan/${vars.run_date}_03_plan_plan.json.
+            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", "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:
@@ -203,7 +229,20 @@ states:
             bun "$st" 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;
+            OMNIVOICE_SPEED=1.06 bun "$st" 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:
@@ -213,7 +252,7 @@ states:
             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}"
+            bun "$st" 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"
@@ -293,8 +332,8 @@ states:
             [ -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}"
 
-  - 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)"
+  - 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:
@@ -304,10 +343,10 @@ states:
             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}"
+            bun "$st" daily-patch-surfdash "${vars.work_dir}" "${vars.run_date}" "${vars.surfdash_root}"
 
-  - 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"
+  - 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)"
     onEnter:
       - kind: shell
         options:
@@ -317,10 +356,10 @@ states:
             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}"
+            bun "$st" daily-publish-partial "${vars.work_dir}" "${vars.run_date}"
 
-  - 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)"
+  - 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:
@@ -330,32 +369,10 @@ states:
             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
-      - kind: file.read.into-var
-        options:
-          path: ${vars.work_dir}/3-publish/${vars.run_date}_20_translate-en_en-post-path.txt
-          var: surfdash_en_post_path
+            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-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)"
+  - 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:
@@ -365,29 +382,26 @@ states:
             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}"
+            bun "$st" 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}_22_translate-ja_ja-post-path.txt
+          path: ${vars.work_dir}/3-publish/${vars.run_date}_20_translate-localize_en-post-path.txt
+          var: surfdash_en_post_path
+      - kind: file.read.into-var
+        options:
+          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: >-
@@ -396,7 +410,7 @@ states:
             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}"
+            bun "$st" 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)"
@@ -442,17 +456,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
 
@@ -518,27 +556,30 @@ transitions:
     guard:
       kind: always
 
+  # 0140: intentionally NO `qc.passed` conjunct on these two edges (operator decision, ratified
+  # 2026-09-17, see the 0140 Q&A). The gate that used to sit here read
+  # `jq -r '.metadata.qc.passed // true' <generate content>` — and jq's `//` treats `false` as empty,
+  # so it printed "true" for a failing audit and the conjunct passed for every input. It never gated
+  # (trace `dogfood-daily-031816` fired quality-control → publish-prep with `passed:false` on disk),
+  # so removing it is behaviour-neutral. Policy: degradation-class audits (loudness dips,
+  # transcription fidelity) publish warn-only and surface in the run report's ## 音频 QC block;
+  # the credibility-damaging class (`repetition_detected`) is hard-failed upstream by 0139 R5a.
+  # Do not restore a `qc.passed` guard here without also fixing the `// false`-swallowing expression.
   - from: quality-control
     to: publish-prep
-    description: "publish enabled AND QC passed -> merge article + audio for the publish seam"
+    description: "publish enabled -> merge article + audio for the publish seam"
     guard:
       kind: shell
       options:
-        command: 'test "${vars.publish_enabled}" = "true" && test "$(jq -r ''.metadata.qc.passed // true'' "${vars.work_dir}/3-audio/${vars.run_date}_11_generate_content.json")" = "true"'
+        command: 'test "${vars.publish_enabled}" = "true"'
 
   - from: quality-control
     to: done
-    description: "publish disabled AND QC passed -> audio episode complete (no publish)"
+    description: "publish disabled -> audio episode complete (no publish)"
     guard:
       kind: shell
       options:
-        command: 'test "${vars.publish_enabled}" != "true" && test "$(jq -r ''.metadata.qc.passed // true'' "${vars.work_dir}/3-audio/${vars.run_date}_11_generate_content.json")" = "true"'
-
-  - from: quality-control
-    to: failed
-    description: "Audio QC failed -> pipeline failed"
-    guard:
-      kind: always
+        command: 'test "${vars.publish_enabled}" != "true"'
 
   - from: publish-prep
     to: publish-surfdash
@@ -565,12 +606,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
@@ -595,8 +640,8 @@ 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:
@@ -610,48 +655,8 @@ transitions:
       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
-
-  - 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