@gobing-ai/knowledge-kit 0.1.13 → 0.1.15

package/plugins/kk/scripts/daily-scheduled-run.ts

@@ -1,7 +1,7 @@
 #!/usr/bin/env bun
 /** Supervise one scheduled daily run and persist its terminal outcome even after a deadline. */
 import { spawn, spawnSync } from 'node:child_process';
-import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
 import { dirname, join, resolve } from 'node:path';
 import { parseArgs } from 'node:util';
 
@@ -17,8 +17,10 @@ const { values } = parseArgs({
         'required-channels': { type: 'string', default: 'wechat,locales,cms-resync' },
         'wechat-live': { type: 'boolean', default: false },
         workflow: { type: 'string', default: 'kk-daily-ai-voice2' },
+        'generate-only': { type: 'boolean', default: false },
         window: { type: 'string' },
         'publish-preset': { type: 'string' },
+        'publish-live-channels': { type: 'string' },
     },
 });
 const timeoutMs = Number(values['timeout-ms']);
@@ -33,13 +35,22 @@ const runId = values['run-id'] ?? `daily-ai-voice-${stamp}-${now.getTime()}`;
 const workDir = join(resolve(values['works-dir'] ?? join(repo, '.works')), 'kk-daily-ai-voice2', stamp);
 const receiptPath = resolve(values.receipt ?? join(workDir, 'schedule-receipt.json'));
 const startedAt = now.toISOString();
+mkdirSync(workDir, { recursive: true });
 mkdirSync(dirname(receiptPath), { recursive: true });
 // voice3 shares the voice2 workspace (F08); only the vars and the publish seam differ.
 const isVoice3 = values.workflow === 'kk-daily-ai-voice3';
+const generateOnly = values['generate-only'] === true;
+if (generateOnly && !isVoice3) {
+    console.error('daily-scheduled-run: --generate-only requires --workflow kk-daily-ai-voice3');
+    process.exit(2);
+}
 const vars = isVoice3
     ? {
-          auto_publish: 'true',
+          auto_publish: generateOnly ? 'false' : 'true',
           ...(values['publish-preset'] !== undefined ? { publish_preset: values['publish-preset'] } : {}),
+          ...(values['publish-live-channels'] !== undefined
+              ? { publish_live_channels: values['publish-live-channels'] }
+              : {}),
           ...(values.window ? { window: values.window } : {}),
           skip_review: 'true',
           agent: values.agent,
@@ -312,6 +323,37 @@ const missingRequiredChannels = isVoice3
           const rows = channelCompleteness.filter((row) => row.channel === channel);
           return rows.length !== 1 || rows[0]?.state !== 'done';
       });
+/** Generate-only receipts use the same fail-closed bundle admission as posting and validation. */
+function inspectGenerationOnly(): { status: string; reason: string } {
+    const inspector = join(repo, 'scripts/daily-ai-news.ts');
+    if (!existsSync(inspector)) return { status: 'incomplete', reason: `bundle inspector not found: ${inspector}` };
+    // The child is terminal, but our initial receipt still says running. Mark the inspection phase so
+    // the shared admission check does not mistake this supervisor for a concurrent active run.
+    writeFileSync(receiptPath, JSON.stringify({ runId, startedAt, status: 'inspecting', workDir }, null, 2));
+    const probe = spawnSync(process.execPath, [inspector, 'inspect', '--work-dir', workDir, '--run-date', stamp], {
+        cwd: repo,
+        encoding: 'utf-8',
+        timeout: 30000,
+        maxBuffer: 1024 * 1024,
+    });
+    try {
+        const parsed = JSON.parse(probe.stdout) as { status?: unknown; reason?: unknown };
+        if (typeof parsed.status === 'string') {
+            return {
+                status: probe.status === 0 && parsed.status === 'complete' ? 'complete' : 'incomplete',
+                reason: typeof parsed.reason === 'string' ? parsed.reason : `inspector exited ${probe.status ?? 1}`,
+            };
+        }
+    } catch {}
+    return {
+        status: 'incomplete',
+        reason: probe.stderr.trim() || probe.error?.message || `bundle inspector exited ${probe.status ?? 1}`,
+    };
+}
+const generationInspection =
+    generateOnly && workflowStatus === 'done' && !runSummary?.startsWith('no-content:')
+        ? inspectGenerationOnly()
+        : null;
 // A terminal green workflow can mean "no content" or failed delivery. Make that observable to
 // the scheduler instead of equating the workflow's process exit with a published edition.
 // A voice3 outcome classified 'full' already proves every non-dummy row succeeded (0326 R2).
@@ -320,14 +362,20 @@ const status =
         ? workflowStatus
         : runSummary?.startsWith('no-content:')
           ? 'no-content'
-          : primaryPublishStatus === 'full' && !(!isVoice3 && missingRequiredChannels.length > 0)
-            ? 'done'
-            : 'incomplete';
+          : generateOnly
+            ? generationInspection?.status === 'complete'
+                ? 'done'
+                : 'incomplete'
+            : primaryPublishStatus === 'full' && !(!isVoice3 && missingRequiredChannels.length > 0)
+              ? 'done'
+              : 'incomplete';
 const receipt = {
     runId,
     startedAt,
     completedAt: new Date().toISOString(),
     status,
+    generateOnly,
+    generationInspection,
     exitCode: timedOut ? 124 : interrupted ? 143 : exitCode !== 0 ? exitCode : status === 'done' ? 0 : 4,
     workDir,
     timeoutMs,

package/plugins/kk/scripts/daily-stages.ts

@@ -55,6 +55,7 @@ import { spawnSync } from 'node:child_process';
 import { createHash } from 'node:crypto';
 import {
     copyFileSync,
+    cpSync,
     existsSync,
     mkdirSync,
     readdirSync,
@@ -75,6 +76,7 @@ import {
     coverBrief,
     coverNormalizeBody,
     dedupPlanByTitle,
+    EDITORIAL_SKILL_DIR,
     expandHome,
     fail,
     failWith,
@@ -91,12 +93,10 @@ import {
     readJson,
     readTopicBoundary,
     requireJson,
-    requireSidecar,
-    resolveSidecar,
     resultPublishStatus,
     SAFETY_PLATFORM_DECISIONS,
     SAFETY_REVISE_COUNT,
-    STYLE_SIDECAR,
+    STYLE_CONTRACT,
     StageFailure,
     safetyDigest,
     safetyDraftPaths,
@@ -511,14 +511,24 @@ export function dailyArticle(args: string[]): void {
         // half-ran (or the json was pruned), and returning here starves every downstream stage
         // that reads content.json — publish-prep refuses to merge a draft it cannot read. Requiring
         // both artifacts makes the pair self-healing instead of permanently stuck.
-        if (isFile(articleMd) && isFile(articleContent)) {
+        // The prose body is the generator's INPUT: when it is newer than content.json the pair
+        // is stale (an operator or a retry edited the headings after the render), and serving it
+        // ships last round's body to surfdash. Re-derive instead of returning.
+        const proseBody = join(workDir, '22-article', `${runDate}_06_article-write_body.md`);
+        const proseStale =
+            isFile(proseBody) &&
+            isFile(articleContent) &&
+            statSync(proseBody).mtimeMs > statSync(articleContent).mtimeMs;
+        if (isFile(articleMd) && isFile(articleContent) && !proseStale) {
             console.log(`article cached: ${articleMd}`);
             return;
         }
+        if (proseStale) {
+            console.error(`article: stale pair — ${proseBody} is newer than ${articleContent}, re-deriving`);
+        }
         // Agent-written prose body (workflow `article-write` state) replaces the mechanical
         // per-item render when present — the 3-format split: surfdash gets an article,
         // not a news list (2026-09-16 feedback).
-        const proseBody = join(workDir, '22-article', `${runDate}_06_article-write_body.md`);
         kk(
             [
                 'executor',
@@ -3999,7 +4009,8 @@ export function dailyScript(args: string[]): void {
                 // cwd = the plugin package dir, so a relative workDir would silently miss the
                 // plan; a plan file absent at build time reports missing-plan (template fallback).
                 DAILYNEWS_SCRIPT_PLAN: resolve(join(workDir, '24-script', `${runDate}_08_script-write_plan.json`)),
-                DAILYNEWS_STYLE_FILE: resolve(resolveSidecar('', STYLE_SIDECAR)),
+                DAILYNEWS_STYLE_FILE: resolve(STYLE_CONTRACT),
+                DAILYNEWS_CURATE_EXCLUDED: resolve(join(workDir, '21-plan', `${runDate}_03_curate_excluded.json`)),
             },
         });
         const body = readJson(contentOut)?.body;
@@ -4021,25 +4032,478 @@ export function dailyScript(args: string[]): void {
 
 /** Task 0189 R10 artifacts of the content-safety verdict gate (24-script, step 09). */
 /**
- * F613 R1: snapshot the shipped style contract into the run's work dir. Spur workflows have no
- * workflow-dir var, so the script-write prompt reads this copy — and the snapshot freezes the
- * exact contract the run's plan was written against. Idempotent (an existing snapshot is kept);
- * a missing sidecar is a broken install, so `requireSidecar` fails loud.
+ * F613 R1 / ADR-045: snapshot the shipped kk:news-editorial skill into the run's work dir. Spur
+ * workflows have no workflow-dir var and kk skills are not installed for every executor, so the
+ * writer prompts read this copy by path — and the snapshot freezes the exact policy the run's plan
+ * was written against. `20-editorial/news-editorial/` holds SKILL.md + references; the
+ * `_08_script-write_style.md` copy of the style contract stays the run's audit record.
+ * Idempotent per artifact (an existing snapshot is kept); a missing skill is a broken install.
  */
 export function dailyScriptStyle(args: string[]): void {
     const [workDir = '', runDate = ''] = args;
+    if (!isFile(STYLE_CONTRACT)) {
+        failWith(
+            1,
+            `news-editorial skill not found — no ${STYLE_CONTRACT}; install or refresh the kk package (bun link in a checkout)`,
+        );
+    }
+    const skillSnapshot = join(workDir, '20-editorial', 'news-editorial');
+    if (isFile(join(skillSnapshot, 'SKILL.md'))) {
+        console.log(`editorial skill cached: ${skillSnapshot}`);
+    } else {
+        sted('cp', skillSnapshot, () => cpSync(EDITORIAL_SKILL_DIR, skillSnapshot, { recursive: true }));
+        console.log(`editorial skill snapshot: ${skillSnapshot}`);
+    }
     const snapshot = join(workDir, '24-script', `${runDate}_08_script-write_style.md`);
     if (isFile(snapshot)) {
         console.log(`script style cached: ${snapshot}`);
         return;
     }
-    const sidecar = requireSidecar('', STYLE_SIDECAR, 'daily-voice-style');
     const scriptDir = join(workDir, '24-script');
     sted('mkdir', scriptDir, () => mkdirSync(scriptDir, { recursive: true }));
-    sted('cp', snapshot, () => copyFileSync(sidecar, snapshot));
+    sted('cp', snapshot, () => copyFileSync(STYLE_CONTRACT, snapshot));
     console.log(`script style snapshot: ${snapshot}`);
 }
 
+/**
+ * 0345 R4: dry-run the dailynews-gen validator on the authored script plan so a rejected plan gets
+ * one targeted `script-write-fix` pass instead of silently shipping the template fallback. Writes
+ * `24-script/<date>_08_script-write_errors.json` ([{itemId, rule}]) when the plan is absent or
+ * rejected, and removes it when the plan is accepted. The trial build goes to a scratch path so the
+ * `script` stage's isFile cache is never primed by a check.
+ */
+export function dailyScriptCheck(args: string[]): void {
+    const [workDir = '', runDate = '', pluginsPath = ''] = args;
+    const planOut = join(workDir, '24-script', `${runDate}_08_script-write_plan.json`);
+    const errorsOut = join(workDir, '24-script', `${runDate}_08_script-write_errors.json`);
+    const writeErrors = (errors: unknown[]) => {
+        sted('write', errorsOut, () => writeJsonText(errorsOut, errors));
+        console.log(`script plan rejected (${errors.length} error(s)): ${errorsOut}`);
+    };
+    if (!isFile(planOut)) {
+        writeErrors([{ itemId: 'episode', rule: 'missing-plan' }]);
+        return;
+    }
+    const trialOut = join(workDir, '24-script', `.${runDate}_08_script-check_content.json`);
+    const planIn = join(workDir, '21-plan', `${runDate}_03_plan_plan.json`);
+    try {
+        kk(['executor', 'run', 'dailynews-gen', '--in', planIn, '--out', trialOut, ...pluginsArgs(pluginsPath)], {
+            env: {
+                DAILYNEWS_LANGUAGE: 'zh',
+                DAILYNEWS_DATE: runDate,
+                DAILYNEWS_SCRIPT_PLAN: resolve(planOut),
+                DAILYNEWS_STYLE_FILE: resolve(STYLE_CONTRACT),
+                DAILYNEWS_CURATE_EXCLUDED: resolve(join(workDir, '21-plan', `${runDate}_03_curate_excluded.json`)),
+            },
+        });
+        const metadata = readJson(trialOut)?.metadata;
+        const source = metadata?.scriptSource;
+        if (source !== 'plan' && source !== 'template') {
+            failWith(1, `script-check: ${trialOut} carries no scriptSource stamp`);
+        }
+        if (source === 'plan') {
+            if (isFile(errorsOut)) unlinkSync(errorsOut);
+            console.log('script plan accepted by the validator');
+            return;
+        }
+        writeErrors(Array.isArray(metadata.scriptPlanErrors) ? metadata.scriptPlanErrors : []);
+    } finally {
+        if (isFile(trialOut)) unlinkSync(trialOut);
+    }
+}
+
+/**
+ * 0345 R8: validate the `curate` agent output (`21-plan/<date>_03_plan_plan.json` +
+ * `21-plan/<date>_03_curate_excluded.json`) against the QC candidates
+ * (`21-plan/<date>_04_quality-control-content_candidates.json`). Unwraps a `Content` envelope and
+ * dedups near-duplicate titles in place before `write` reads the plan. Writes
+ * `21-plan/<date>_03_curate_errors.json` (`[{itemId, rule}]`) on failure and removes it on success.
+ * With `--final`, falls back to the untranslated candidates and `[]` exclusions on failure.
+ */
+export function dailyCurateCheck(args: string[]): void {
+    const [workDir = '', runDate = '', flag = ''] = args;
+    if (!workDir) fail('missing work_dir');
+    if (!runDate) fail('missing run_date');
+    const isFinal = flag === '--final';
+    const candidatesFile = join(workDir, '21-plan', `${runDate}_04_quality-control-content_candidates.json`);
+    const planFile = join(workDir, '21-plan', `${runDate}_03_plan_plan.json`);
+    const excludedFile = join(workDir, '21-plan', `${runDate}_03_curate_excluded.json`);
+    const errFile = join(workDir, '21-plan', `${runDate}_03_curate_errors.json`);
+
+    const candRaw = readJson(candidatesFile);
+    const candidateDocs: Record<string, unknown>[] = Array.isArray(candRaw)
+        ? (candRaw as Record<string, unknown>[])
+        : Array.isArray(metadataOf(candRaw).docs)
+          ? (metadataOf(candRaw).docs as Record<string, unknown>[])
+          : [];
+    const candidateIds = candidateDocs.map((doc) => (typeof doc?.id === 'string' ? doc.id.trim() : '')).filter(Boolean);
+    const candidateIdSet = new Set(candidateIds);
+
+    const handleErrors = (errors: { itemId: string; rule: string }[]): void => {
+        if (isFinal) {
+            const reason = errors.map((e) => `${e.itemId}:${e.rule}`).join(', ');
+            console.error(
+                `curate-check: final check failed (${reason}) — falling back to ${candidateDocs.length} untranslated candidate(s)`,
+            );
+            sted('write', planFile, () => writeJsonText(planFile, candidateDocs));
+            sted('write', excludedFile, () => writeJsonText(excludedFile, []));
+            if (isFile(errFile)) unlinkSync(errFile);
+            return;
+        }
+        sted('write', errFile, () => writeJsonText(errFile, errors));
+        console.log(`curate-check: rejected (${errors.length} error(s)): ${errFile}`);
+    };
+
+    if (!isFile(planFile)) {
+        handleErrors([{ itemId: 'episode', rule: 'missing-plan' }]);
+        return;
+    }
+
+    let planParsed: unknown;
+    try {
+        planParsed = JSON.parse(readFileSync(planFile, 'utf-8'));
+    } catch {
+        handleErrors([{ itemId: 'episode', rule: 'invalid-json' }]);
+        return;
+    }
+
+    let planDocs: Record<string, unknown>[];
+    if (Array.isArray(planParsed)) {
+        planDocs = planParsed as Record<string, unknown>[];
+    } else if (
+        planParsed !== null &&
+        typeof planParsed === 'object' &&
+        Array.isArray(metadataOf(planParsed as Record<string, unknown>).docs)
+    ) {
+        planDocs = metadataOf(planParsed as Record<string, unknown>).docs as Record<string, unknown>[];
+        sted('write', planFile, () => writeJsonText(planFile, planDocs));
+        console.log(`curate-check: unwrapped Content envelope (${planDocs.length} doc(s)) in ${planFile}`);
+    } else {
+        handleErrors([{ itemId: 'episode', rule: 'invalid-json' }]);
+        return;
+    }
+
+    for (const entry of planDocs) {
+        if (entry === null || typeof entry !== 'object' || typeof entry.id !== 'string' || entry.id.trim() === '') {
+            handleErrors([{ itemId: 'episode', rule: 'invalid-json' }]);
+            return;
+        }
+    }
+
+    const excludedItems: { id: string; reason: string }[] = [];
+    if (isFile(excludedFile)) {
+        let exParsed: unknown;
+        try {
+            exParsed = JSON.parse(readFileSync(excludedFile, 'utf-8'));
+        } catch {
+            handleErrors([{ itemId: 'episode', rule: 'invalid-json' }]);
+            return;
+        }
+        if (!Array.isArray(exParsed)) {
+            handleErrors([{ itemId: 'episode', rule: 'invalid-json' }]);
+            return;
+        }
+        for (const entry of exParsed) {
+            if (
+                entry === null ||
+                typeof entry !== 'object' ||
+                typeof (entry as { id?: unknown }).id !== 'string' ||
+                (entry as { id: string }).id.trim() === '' ||
+                typeof (entry as { reason?: unknown }).reason !== 'string' ||
+                (entry as { reason: string }).reason.trim() === ''
+            ) {
+                handleErrors([{ itemId: 'episode', rule: 'invalid-json' }]);
+                return;
+            }
+            excludedItems.push({
+                id: (entry as { id: string }).id.trim(),
+                reason: (entry as { reason: string }).reason.trim(),
+            });
+        }
+    }
+
+    const errors: { itemId: string; rule: string }[] = [];
+    if (planDocs.length === 0) {
+        errors.push({ itemId: 'episode', rule: 'empty-plan' });
+    }
+
+    const keptIds = new Set<string>();
+    for (const doc of planDocs) {
+        const id = (doc.id as string).trim();
+        keptIds.add(id);
+        if (candidateIdSet.size > 0 && !candidateIdSet.has(id)) {
+            errors.push({ itemId: id, rule: 'unknown-id' });
+        }
+    }
+
+    const excludedIds = new Set<string>();
+    for (const ex of excludedItems) {
+        excludedIds.add(ex.id);
+        if (candidateIdSet.size > 0 && !candidateIdSet.has(ex.id)) {
+            errors.push({ itemId: ex.id, rule: 'unknown-id' });
+        }
+        if (keptIds.has(ex.id)) {
+            errors.push({ itemId: ex.id, rule: 'conflict-id' });
+        }
+    }
+
+    for (const cid of candidateIds) {
+        if (!keptIds.has(cid) && !excludedIds.has(cid)) {
+            errors.push({ itemId: cid, rule: 'missing-item' });
+        }
+    }
+
+    if (errors.length > 0) {
+        handleErrors(errors);
+        return;
+    }
+
+    const { kept, dropped } = dedupPlanByTitle(planDocs);
+    if (dropped.length > 0) {
+        sted('write', planFile, () => writeJsonText(planFile, kept));
+        console.error(`curate-check: dropped ${dropped.length} near-duplicate plan item(s): ${dropped.join(', ')}`);
+        for (const droppedId of dropped) {
+            if (!excludedIds.has(droppedId)) {
+                excludedIds.add(droppedId);
+                excludedItems.push({ id: droppedId, reason: '标题近似重复自动去重' });
+            }
+        }
+        sted('write', excludedFile, () => writeJsonText(excludedFile, excludedItems));
+    } else if (!isFile(excludedFile)) {
+        sted('write', excludedFile, () => writeJsonText(excludedFile, excludedItems));
+    }
+
+    if (isFile(errFile)) unlinkSync(errFile);
+    console.log(`curate-check: accepted (${kept.length} kept, ${excludedItems.length} excluded)`);
+}
+
+function sourceLabelForDoc(doc: Record<string, unknown>, sourceUri: string): string {
+    const meta = metadataOf(doc);
+    if (typeof meta.source === 'string' && meta.source.trim() !== '') {
+        return meta.source.trim();
+    }
+    try {
+        return new URL(sourceUri).hostname.replace(/^www\./, '') || '原文';
+    } catch {
+        return '原文';
+    }
+}
+
+/** Fixed column opening line of the rendered article body: house copy, not editorial judgement (0345). */
+const EDITORIAL_ARTICLE_OPENING = '这里是由Robin为你带来的咸话咸说之每日AI乱炖。';
+
+/**
+ * 0345 R10: deterministically render the five sibling editorial artifacts from the master script
+ * plan (`24-script/<date>_08_script-write_plan.json`) and the curated plan
+ * (`21-plan/<date>_03_plan_plan.json`):
+ *  1. `22-article/<date>_06_article-write_body.md`
+ *  2. `23-cover/<date>_07_cover-brief.json`
+ *  3. `25-xhs/<date>_18_xhs_plan.json` (only when `cards_enabled === 'true'`)
+ *  4. `26-social/{x,threads}.md` (`social.short`)
+ *  5. `26-social/{weibo,linkedin}.md` (`social.long`)
+ * Missing master field -> skip that one artifact with a logged reason, write the others.
+ */
+export function dailyEditorialRender(args: string[]): void {
+    const [workDir = '', runDate = '', cardsEnabled = 'false', cardsRaw = '6'] = args;
+    if (!workDir) fail('missing work_dir');
+    if (!runDate) fail('missing run_date');
+    const cardsCount = Math.max(2, Number.parseInt(cardsRaw, 10) || 6);
+    const planFile = join(workDir, '21-plan', `${runDate}_03_plan_plan.json`);
+    const masterFile = join(workDir, '24-script', `${runDate}_08_script-write_plan.json`);
+
+    const master = readJson(masterFile);
+    if (master === null) {
+        console.log(`editorial-render: no master script plan at ${masterFile} — skipping all renders`);
+        return;
+    }
+
+    const planRaw = readJson(planFile);
+    const planDocs: Record<string, unknown>[] = Array.isArray(planRaw)
+        ? (planRaw as Record<string, unknown>[])
+        : Array.isArray(metadataOf(planRaw).docs)
+          ? (metadataOf(planRaw).docs as Record<string, unknown>[])
+          : [];
+    const docById = new Map<string, Record<string, unknown>>();
+    for (const doc of planDocs) {
+        if (typeof doc?.id === 'string' && doc.id.trim() !== '') {
+            docById.set(doc.id.trim(), doc);
+        }
+    }
+
+    const rawItems = Array.isArray(master.items) ? (master.items as Record<string, unknown>[]) : [];
+    const itemById = new Map<string, Record<string, unknown>>();
+    for (const item of rawItems) {
+        if (item !== null && typeof item === 'object' && typeof item.id === 'string' && item.id.trim() !== '') {
+            itemById.set(item.id.trim(), item);
+        }
+    }
+    const orderedIds =
+        planDocs.length > 0
+            ? planDocs
+                  .map((d) => (typeof d.id === 'string' ? d.id.trim() : ''))
+                  .filter((id) => id !== '' && itemById.has(id))
+            : [...itemById.keys()];
+
+    // 1. Article body: 22-article/<date>_06_article-write_body.md
+    const outro = typeof master.outro === 'string' ? master.outro.trim() : '';
+    const articleSections: string[] = [];
+    for (const id of orderedIds) {
+        const doc = docById.get(id);
+        const item = itemById.get(id);
+        const title = typeof doc?.title === 'string' ? doc.title.trim() : '';
+        const body = typeof doc?.body === 'string' ? doc.body.trim() : '';
+        const lead = typeof item?.lead === 'string' ? item.lead.trim() : '';
+        const insight = typeof item?.insight === 'string' ? item.insight.trim() : '';
+        if (!title || !body || !lead || !insight) continue;
+        const sourceUri = typeof doc?.sourceUri === 'string' ? doc.sourceUri.trim() : '';
+        const sourceLine = sourceUri ? `[来源：${sourceLabelForDoc(doc ?? {}, sourceUri)}](${sourceUri})` : '';
+        const parts = [`## ${title}`, lead, body, insight, ...(sourceLine ? [sourceLine] : [])];
+        articleSections.push(parts.join('\n\n'));
+    }
+    if (articleSections.length > 0 && outro !== '') {
+        const articleDir = join(workDir, '22-article');
+        sted('mkdir', articleDir, () => mkdirSync(articleDir, { recursive: true }));
+        const articleOut = join(articleDir, `${runDate}_06_article-write_body.md`);
+        const articleText = `${[EDITORIAL_ARTICLE_OPENING, ...articleSections, outro].join('\n\n')}\n`;
+        sted('write', articleOut, () => writeRaw(articleOut, articleText));
+        console.log(`editorial-render: wrote article body (${articleSections.length} item(s)): ${articleOut}`);
+    } else {
+        console.log('editorial-render: skipping article body (missing items/doc fields or outro)');
+    }
+
+    // 2. Cover brief: 23-cover/<date>_07_cover-brief.json
+    const coverSubject = typeof master.cover === 'string' ? master.cover.trim() : '';
+    if (coverSubject !== '') {
+        const coverDir = join(workDir, '23-cover');
+        sted('mkdir', coverDir, () => mkdirSync(coverDir, { recursive: true }));
+        const coverOut = join(coverDir, `${runDate}_07_cover-brief.json`);
+        sted('write', coverOut, () => writeJsonText(coverOut, { subject: coverSubject }));
+        console.log(`editorial-render: wrote cover brief: ${coverOut}`);
+    } else {
+        console.log('editorial-render: skipping cover brief (missing cover in script plan)');
+    }
+
+    // 3. XHS card plan: 25-xhs/<date>_18_xhs_plan.json (only when cards_enabled === 'true')
+    if (cardsEnabled === 'true') {
+        const cardsMeta =
+            master.cards !== null && typeof master.cards === 'object'
+                ? (master.cards as Record<string, unknown>)
+                : null;
+        const cardTitle = typeof cardsMeta?.title === 'string' ? cardsMeta.title.trim() : '';
+        const cardBody = typeof cardsMeta?.body === 'string' ? cardsMeta.body.trim() : '';
+        const contentItems = orderedIds
+            .map((id) => ({ id, item: itemById.get(id), doc: docById.get(id) }))
+            .filter(({ item }) => {
+                const c = item?.card as Record<string, unknown> | undefined;
+                return (
+                    c !== null &&
+                    typeof c === 'object' &&
+                    typeof c.copy === 'string' &&
+                    c.copy.trim() !== '' &&
+                    Array.isArray(c.points) &&
+                    c.points.length >= 1 &&
+                    typeof c.subject === 'string' &&
+                    c.subject.trim() !== ''
+                );
+            });
+        const maxContent = Math.max(1, cardsCount - 2);
+        const chosenContent = contentItems.slice(0, maxContent);
+        if (cardTitle !== '' && cardBody !== '' && chosenContent.length > 0) {
+            const firstSubject =
+                coverSubject ||
+                ((chosenContent[0]?.item?.card as { subject?: string } | undefined)?.subject ?? '').trim() ||
+                'Minimalist geometric light sculpture on a dark studio table';
+            const introText =
+                typeof master.intro === 'string' && master.intro.trim() !== '' ? master.intro.trim() : cardTitle;
+            const coverPoints = chosenContent
+                .slice(0, 4)
+                .map(({ item }) => ((item?.card as { copy?: string } | undefined)?.copy || '').trim())
+                .filter(Boolean);
+            const renderedCards: Record<string, unknown>[] = [
+                {
+                    role: 'cover',
+                    copy: cardTitle.slice(0, 12),
+                    points: coverPoints.length >= 2 ? coverPoints : [cardTitle, introText.slice(0, 36)],
+                    layout: 'hero',
+                    subject: firstSubject,
+                    sourcePoint: introText,
+                },
+                ...chosenContent.map(({ id, item, doc }) => {
+                    const card = item?.card as { copy: string; points: string[]; subject: string };
+                    const lead = typeof item?.lead === 'string' && item.lead.trim() !== '' ? item.lead.trim() : '';
+                    const docTitle = typeof doc?.title === 'string' && doc.title.trim() !== '' ? doc.title.trim() : id;
+                    return {
+                        role: 'content',
+                        copy: card.copy.trim(),
+                        points: card.points
+                            .map((p) => String(p).trim())
+                            .filter(Boolean)
+                            .slice(0, 4),
+                        layout: 'split',
+                        subject: card.subject.trim(),
+                        sourcePoint: lead || docTitle,
+                        itemId: id,
+                    };
+                }),
+            ];
+            // Pad content cards if chosenContent.length < maxContent so total length equals cardsCount
+            while (renderedCards.length < cardsCount - 1) {
+                const seed = renderedCards[renderedCards.length - 1] as Record<string, unknown>;
+                renderedCards.push({ ...seed });
+            }
+            const closingPoints = [outro || introText, cardTitle].filter(Boolean);
+            renderedCards.push({
+                role: 'closing',
+                copy: '本期小结',
+                points: closingPoints.length >= 2 ? closingPoints : [outro || cardTitle, '感谢关注每日AI乱炖'],
+                layout: 'summary',
+                subject: firstSubject,
+                sourcePoint: outro || introText,
+            });
+            const xhsDir = join(workDir, '25-xhs');
+            sted('mkdir', xhsDir, () => mkdirSync(xhsDir, { recursive: true }));
+            const xhsOut = join(xhsDir, `${runDate}_18_xhs_plan.json`);
+            sted('write', xhsOut, () =>
+                writeJsonText(xhsOut, {
+                    title: cardTitle,
+                    body: cardBody,
+                    cards: renderedCards,
+                }),
+            );
+            console.log(`editorial-render: wrote xhs card plan (${renderedCards.length} card(s)): ${xhsOut}`);
+        } else {
+            console.log('editorial-render: skipping xhs card plan (missing cards.title/body or items[].card)');
+        }
+    }
+
+    // 4 & 5. Social posts: 26-social/{x,threads}.md and 26-social/{weibo,linkedin}.md
+    const social =
+        master.social !== null && typeof master.social === 'object' ? (master.social as Record<string, unknown>) : null;
+    const socialShort = typeof social?.short === 'string' ? social.short.trim() : '';
+    const socialDir = join(workDir, '26-social');
+    if (socialShort !== '') {
+        sted('mkdir', socialDir, () => mkdirSync(socialDir, { recursive: true }));
+        for (const name of ['x.md', 'threads.md']) {
+            const out = join(socialDir, name);
+            sted('write', out, () => writeRaw(out, `${socialShort}\n`));
+        }
+        console.log('editorial-render: wrote 26-social/{x,threads}.md');
+    } else {
+        console.log('editorial-render: skipping social short posts (missing social.short in script plan)');
+    }
+    const socialLong = typeof social?.long === 'string' ? social.long.trim() : '';
+    if (socialLong !== '') {
+        sted('mkdir', socialDir, () => mkdirSync(socialDir, { recursive: true }));
+        for (const name of ['weibo.md', 'linkedin.md']) {
+            const out = join(socialDir, name);
+            sted('write', out, () => writeRaw(out, `${socialLong}\n`));
+        }
+        console.log('editorial-render: wrote 26-social/{weibo,linkedin}.md');
+    } else {
+        console.log('editorial-render: skipping social long posts (missing social.long in script plan)');
+    }
+}
+
 export function dailyShowNotes(args: string[]): void {
     const [workDir = '', runDate = '', pluginsPath = '', title = ''] = args;
     const article = join(workDir, '22-article', `${runDate}_06_article_content.json`);