@gobing-ai/knowledge-kit 0.1.11 → 0.1.13

package/plugins/kk/publish-presets/daily-ai-voice-migration.json

@@ -0,0 +1,146 @@
+{
+    "schemaVersion": 1,
+    "name": "daily-ai-voice-migration",
+    "targets": [
+        {
+            "id": "surfdash.article",
+            "plugin": "surfdash-pub",
+            "operation": "post",
+            "variant": "article",
+            "tier": 0,
+            "window": "after-generate",
+            "mode": "draft",
+            "required": true
+        },
+        {
+            "id": "podcast.episode",
+            "plugin": "podcast-pub",
+            "operation": "episode",
+            "variant": "episode",
+            "tier": 0,
+            "window": "after-generate",
+            "mode": "draft",
+            "required": true
+        },
+        {
+            "id": "wechatmp.podcast",
+            "plugin": "wechatmp-pub",
+            "operation": "播客",
+            "variant": "episode",
+            "tier": 1,
+            "window": "after-generate",
+            "mode": "off"
+        },
+        {
+            "id": "xhs.podcast",
+            "plugin": "xhs-pub",
+            "operation": "发播客",
+            "variant": "episode",
+            "tier": 1,
+            "window": "after-generate",
+            "mode": "draft"
+        },
+        {
+            "id": "wechatmp.article",
+            "plugin": "wechatmp-pub",
+            "operation": "文章",
+            "variant": "article",
+            "tier": 2,
+            "window": "after-generate",
+            "mode": "draft",
+            "options": {
+                "collection": "每日AI资讯"
+            }
+        },
+        {
+            "id": "xhs.article",
+            "plugin": "xhs-pub",
+            "operation": "写长文",
+            "variant": "article",
+            "tier": 2,
+            "window": "after-generate",
+            "mode": "draft"
+        },
+        {
+            "id": "xhs.cards",
+            "plugin": "xhs-pub",
+            "operation": "上传图文",
+            "variant": "cards",
+            "tier": 3,
+            "window": "after-generate",
+            "mode": "off"
+        },
+        {
+            "id": "weibo.article",
+            "plugin": "weibo-pub",
+            "operation": "article",
+            "variant": "article",
+            "tier": 2,
+            "window": "cn-peak",
+            "mode": "draft"
+        },
+        {
+            "id": "x.article",
+            "plugin": "x-pub",
+            "operation": "article",
+            "variant": "article",
+            "tier": 2,
+            "window": "cn-peak",
+            "mode": "off"
+        },
+        {
+            "id": "x.post",
+            "plugin": "x-pub",
+            "operation": "post",
+            "variant": "social:x",
+            "tier": 3,
+            "window": "overseas-rss",
+            "mode": "dummy"
+        },
+        {
+            "id": "weibo.post",
+            "plugin": "weibo-pub",
+            "operation": "post",
+            "variant": "social:weibo",
+            "tier": 3,
+            "window": "overseas-rss",
+            "mode": "dummy"
+        },
+        {
+            "id": "threads.post",
+            "plugin": "threads-pub",
+            "operation": "post",
+            "variant": "social:threads",
+            "tier": 3,
+            "window": "overseas-rss",
+            "mode": "dummy"
+        },
+        {
+            "id": "linkedin.post",
+            "plugin": "linkedin-pub",
+            "operation": "post",
+            "variant": "social:linkedin",
+            "tier": 3,
+            "window": "overseas-rss",
+            "mode": "dummy"
+        },
+        {
+            "id": "shipinhao.cards",
+            "plugin": "shipinhao-pub",
+            "operation": "图文",
+            "variant": "cards",
+            "tier": 3,
+            "window": "overseas-rss",
+            "mode": "off"
+        },
+        {
+            "id": "threads.images",
+            "plugin": "threads-pub",
+            "operation": "post-images",
+            "variant": "cards",
+            "tier": 3,
+            "window": "overseas-rss",
+            "mode": "off"
+        }
+    ]
+}

package/plugins/kk/publish-presets/daily-ai-voice.json

@@ -26,7 +26,7 @@
             "variant": "episode",
             "tier": 1,
             "window": "after-generate",
-            "mode": "draft"
+            "mode": "off"
         },
         {
             "plugin": "xhs-pub",
@@ -53,7 +53,7 @@
             "variant": "article",
             "tier": 2,
             "window": "after-generate",
-            "mode": "dummy"
+            "mode": "draft"
         },
         {
             "plugin": "xhs-pub",
@@ -61,7 +61,7 @@
             "variant": "cards",
             "tier": 3,
             "window": "after-generate",
-            "mode": "off"
+            "mode": "draft"
         },
         {
             "plugin": "weibo-pub",
@@ -77,7 +77,7 @@
             "variant": "article",
             "tier": 2,
             "window": "cn-peak",
-            "mode": "draft"
+            "mode": "off"
         },
         {
             "plugin": "x-pub",
@@ -85,7 +85,7 @@
             "variant": "social:x",
             "tier": 3,
             "window": "overseas-rss",
-            "mode": "draft"
+            "mode": "dummy"
         },
         {
             "plugin": "weibo-pub",
@@ -93,7 +93,7 @@
             "variant": "social:weibo",
             "tier": 3,
             "window": "overseas-rss",
-            "mode": "draft"
+            "mode": "dummy"
         },
         {
             "plugin": "threads-pub",
@@ -101,7 +101,15 @@
             "variant": "social:threads",
             "tier": 3,
             "window": "overseas-rss",
-            "mode": "draft"
+            "mode": "dummy"
+        },
+        {
+            "plugin": "linkedin-pub",
+            "operation": "post",
+            "variant": "social:linkedin",
+            "tier": 3,
+            "window": "overseas-rss",
+            "mode": "dummy"
         },
         {
             "plugin": "shipinhao-pub",

package/plugins/kk/schedules/kk-collect.grok-bot.md.tmpl

@@ -0,0 +1,69 @@
+# kk-collect — Grok Bot cloud routine
+
+Rendered by `kk schedule render kk-collect --platform grok-bot --bot {{bot}} [--tz {{tz}}] [--cron {{cron}}]`;
+kk never creates the routine. **Operator action:** paste this definition into the Grok Bot's routine
+editor (https://docs.x.ai/grok-bot/skills-routines-and-automations) and create it there.
+
+The cloud boundary is ADR-044 (`docs/00_ADR.md`): `kk.db` never leaves the Mac — this routine runs
+store-free, browser-free work only, and pushes its output to the `kk-cloud-sync` branch for the Mac
+to import.
+
+## Owner Bot
+
+{{bot}}
+
+## Schedule
+
+`{{cron}}` in `{{tz}}` (the routine's schedule must match this expression and timezone).
+
+## Inputs
+
+- The Bot needs `kk` and `spur` (sp-bot-bootstrap) in its checkout, plus the three source plugins'
+  credentials (`aihot`, `last30days`, `horizon`) provided as Bot secrets.
+- Push access to the `kk-cloud-sync` branch (the Bot's GitHub connector).
+- The fan-in source list below is copied from `plugins/kk/workflows/kk-collect.yaml:116-121` —
+  update the rendered routine whenever that file's source list changes (drift hazard).
+
+## Steps
+
+1. `stamp="$(date -u +%Y%m%dT%H%MZ)"` (UTC, `YYYYMMDDTHHMMZ` — the kk-collect stamp format).
+2. `kk stage collect-prepare "$stamp" 10 "AI news" 6` — the store-free prefix: writes only
+   `.works/kk-collect/<stamp>` and `.spur/runs/kk-collect/*`, touching no database.
+3. Fan-in the three sources (no `kk store` — the output file IS the artifact):
+   ```bash
+   work_dir="$(cat .spur/runs/kk-collect/work-dir.txt)"
+   kk executor fan-in \
+     --source "aihot-ingest:${work_dir}/10-ingest/source.json" \
+     --source "last30days-ingest:${work_dir}/10-ingest/last30days.json" \
+     --source "horizon-ingest:${work_dir}/10-ingest/horizon.json" \
+     --source-timeout-override "horizon-ingest:2700000" \
+     --out "sync/kk-collect/$stamp.json"
+   ```
+4. Commit `sync/kk-collect/$stamp.json` and push it to the `kk-cloud-sync` branch.
+
+## Expected result
+
+`sync/kk-collect/<stamp>.json` on `kk-cloud-sync`, a blended `Doc[]` from the three sources, with
+`<stamp>` equal to the run's UTC minute stamp.
+
+## Approval boundary
+
+Collect only — the routine never runs `kk store`, `kk store label`, a generator or a publisher, and
+it never installs anything itself; creating the routine in the Grok Bot is an explicit operator
+action. Publishing stays Mac-local under ADR-022's live-publish consent gate.
+
+## Missing / stale (ADR-044)
+
+| Situation | Behavior |
+| --------- | -------- |
+| Inputs or credentials missing at run time | print `no-content: <reason>` and exit with no side effects — in particular, no empty artifact is committed |
+| Artifact older than 26 h when the Mac imports | the Mac's `kk store ingest` ignores it (logged) |
+| Same artifact seen again | imported at most once — idempotent by the `cloud-<stamp>` run id |
+
+## Mac import
+
+```bash
+git fetch origin kk-cloud-sync
+git show origin/kk-cloud-sync:sync/kk-collect/<stamp>.json > /tmp/kk-collect-cloud.json
+kk store ingest --run cloud-<stamp> --in /tmp/kk-collect-cloud.json
+```

package/plugins/kk/schedules/kk-daily-ai-voice3.cron.tmpl

@@ -0,0 +1,18 @@
+# kk-daily-ai-voice3 — shadow generation run (task 0334 R1/R6).
+#
+# 04:30 America/Los_Angeles, the same cadence as the voice2 daily run it shadows. The entry is
+# defined in the zone the machine already runs in, so it needs no DST adjustment.
+#
+# Shadow posture is baked into the launch: `auto_publish` stays false, so this entry only
+# prepares, researches and generates — it publishes NOTHING on its own. The nested publish3
+# window runs only when an operator launch flips `publish_window` away from `after-generate`
+# (rehearsal flags in docs/design/kk-daily-ai-voice3.md). The workspace namespace stays
+# kk-daily-ai-voice2 (voice3 prepares under it) until the operator's cutover changes it.
+#
+# Rendered by `kk schedule render kk-daily-ai-voice3 --platform cron --repo <checkout>`;
+# kk never edits the operator's crontab. MERGE, never replace:
+#
+#     crontab -l > /tmp/kk-voice3.cron 2>/dev/null || :
+#     kk schedule render kk-daily-ai-voice3 --platform cron --repo "$PWD" >> /tmp/kk-voice3.cron
+#     crontab /tmp/kk-voice3.cron
+30 4 * * * cd {{repo}} && mkdir -p .works/kk-daily-ai-voice3 && PATH="{{home}}/.bun/bin:/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin" TZ=America/Los_Angeles spur workflow run plugins/kk/workflows/kk-daily-ai-voice3.yaml --vars '{"auto_publish":"false"}' >> {{repo}}/.works/kk-daily-ai-voice3/generation.log 2>&1

package/plugins/kk/schedules/kk-daily-publish3-cn-peak.cron.tmpl

@@ -1,4 +1,4 @@
-# kk-daily-publish3-cn-peak — domestic live window (task 0323 R5).
+# kk-daily-publish3-cn-peak — domestic live window (tasks 0323 R5, 0334 R1-R3).
 #
 # Fires at 17:00 local because the audience window is 09:00 Asia/Shanghai and launchd/cron
 # intervals follow the MACHINE's zone; the first node (`publish-matrix-wait-until 09:00
@@ -6,7 +6,17 @@
 # so the entry never needs editing twice a year.
 #
 # `live_channels` is baked in: this installed line IS the operator's ADR-022 consent for a live
-# send. Nothing in the workflow or the preset can produce `live` on its own.
+# send. Nothing in the workflow or the preset can produce `live` on its own. The window is
+# consent-scoped to tokens with a cn-peak row (weibo-pub). Every live launch
+# stops at the `send-confirm` gate and waits for the operator's manual resume; the entry never
+# delivers unattended.
+#
+# The launch goes through plugins/kk/scripts/voice3-publish-window.ts (task 0334): a crontab
+# command ends at the first UNESCAPED percent sign, so inline `date +%F` shell silently truncates
+# the entry — the launcher owns the LA date math, resolves the GENERATION bundle from the
+# effective works root (never the publish3 output directory), refuses a missing/mismatched
+# bundle, validates the token list against the preset's cn-peak rows, and only then execs spur.
+# The rehearsal pins the shipped default preset; change it at cutover.
 #
 # Rendered by `kk schedule render kk-daily-publish3-cn-peak --platform cron --repo <checkout>`;
 # kk never edits the operator's crontab. MERGE, never replace:
@@ -15,6 +25,6 @@
 #     kk schedule render kk-daily-publish3-cn-peak --platform cron --repo "$PWD" >> /tmp/kk-cn-peak.cron
 #     crontab /tmp/kk-cn-peak.cron
 #
-# `run_date` is computed at tick time in America/Los_Angeles: a run that starts at 17:00 PDT is
-# still "today" for the day dir the 04:30 generation wrote.
-0 17 * * * cd {{repo}} && mkdir -p .works/kk-daily-publish3 && PATH="{{home}}/.bun/bin:/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin" TZ=America/Los_Angeles spur workflow run plugins/kk/workflows/kk-daily-publish3.yaml --vars "{\"work_dir\":\"{{repo}}/.works/kk-daily-publish3/$(TZ=America/Los_Angeles date +%Y%m%d)\",\"run_date\":\"$(TZ=America/Los_Angeles date +%F)\",\"window\":\"cn-peak\",\"live_channels\":\"wechatmp-pub,xhs-pub,weibo-pub,x-pub\"}" >> {{repo}}/.works/kk-daily-publish3/cn-peak.log 2>&1
+# `run_date` is computed at tick time in America/Los_Angeles by the launcher: a run that starts
+# at 17:00 PDT is still "today" for the day dir the 04:30 generation wrote.
+0 17 * * * cd {{repo}} && mkdir -p .works/kk-daily-publish3 && PATH="{{home}}/.bun/bin:/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin" TZ=America/Los_Angeles bun {{repo}}/plugins/kk/scripts/voice3-publish-window.ts --window cn-peak --preset daily-ai-voice --live-channels weibo-pub >> {{repo}}/.works/kk-daily-publish3/cn-peak.log 2>&1

package/plugins/kk/schedules/kk-daily-publish3-overseas.cron.tmpl

@@ -1,17 +1,22 @@
-# kk-daily-publish3-overseas — overseas window behind the podcast RSS gate (task 0323 R5).
+# kk-daily-publish3-overseas — overseas window behind the podcast RSS gate (tasks 0323 R5, 0334 R1-R2).
 #
 # 07:00 America/Los_Angeles, which needs no DST adjustment: the entry is defined in the zone the
 # machine already runs in. The gated date is the PREVIOUS day, because the observed episodes land
-# 13:43–15:22 PDT (after this tick) — `run_date` is therefore yesterday's date, not today's.
+# 13:43–15:22 PDT (after this tick) — the launcher derives yesterday's LA date for `run_date`.
 #
 # The gate decides whether anything publishes: a miss cancels the overseas targets and runs
-# `diagnose` + the tier-0-only repair. This line carries no `live_channels`; the overseas channels
+# `diagnose` + the tier-0-only repair. This line carries no live consent; the overseas channels
 # in the shipped preset are `draft`, so a live overseas post stays an operator launch.
 #
+# plugins/kk/scripts/voice3-publish-window.ts (task 0334) owns the date math because a crontab
+# command ends at the first UNESCAPED percent sign — the old inline `date -v-1d +%Y%m%d` shell
+# truncated silently. The launcher resolves the GENERATION bundle (voice2 namespace, effective
+# works root) and refuses a missing/mismatched bundle before any spur process starts.
+#
 # Rendered by `kk schedule render kk-daily-publish3-overseas --platform cron --repo <checkout>`;
 # kk never edits the operator's crontab. MERGE, never replace:
 #
 #     crontab -l > /tmp/kk-overseas.cron 2>/dev/null || :
 #     kk schedule render kk-daily-publish3-overseas --platform cron --repo "$PWD" >> /tmp/kk-overseas.cron
 #     crontab /tmp/kk-overseas.cron
-0 7 * * * cd {{repo}} && mkdir -p .works/kk-daily-publish3 && PATH="{{home}}/.bun/bin:/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin" TZ=America/Los_Angeles spur workflow run plugins/kk/workflows/kk-daily-publish3.yaml --vars "{\"work_dir\":\"{{repo}}/.works/kk-daily-publish3/$(TZ=America/Los_Angeles date -v-1d +%Y%m%d 2>/dev/null || TZ=America/Los_Angeles date -d yesterday +%Y%m%d)\",\"run_date\":\"$(TZ=America/Los_Angeles date -v-1d +%F 2>/dev/null || TZ=America/Los_Angeles date -d yesterday +%F)\",\"window\":\"overseas-rss\"}" >> {{repo}}/.works/kk-daily-publish3/overseas.log 2>&1
+0 7 * * * cd {{repo}} && mkdir -p .works/kk-daily-publish3 && PATH="{{home}}/.bun/bin:/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin" TZ=America/Los_Angeles bun {{repo}}/plugins/kk/scripts/voice3-publish-window.ts --window overseas-rss >> {{repo}}/.works/kk-daily-publish3/overseas.log 2>&1

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

@@ -16,6 +16,9 @@ const { values } = parseArgs({
         'retry-agent': { type: 'string', default: 'claude' },
         'required-channels': { type: 'string', default: 'wechat,locales,cms-resync' },
         'wechat-live': { type: 'boolean', default: false },
+        workflow: { type: 'string', default: 'kk-daily-ai-voice2' },
+        window: { type: 'string' },
+        'publish-preset': { type: 'string' },
     },
 });
 const timeoutMs = Number(values['timeout-ms']);
@@ -31,15 +34,28 @@ const workDir = join(resolve(values['works-dir'] ?? join(repo, '.works')), 'kk-d
 const receiptPath = resolve(values.receipt ?? join(workDir, 'schedule-receipt.json'));
 const startedAt = now.toISOString();
 mkdirSync(dirname(receiptPath), { recursive: true });
-const vars = {
-    publish_enabled: 'true',
-    skip_review: 'true',
-    agent: values.agent,
-    agent_retry: values['retry-agent'],
-    wechat_live: values['wechat-live'] === true ? 'true' : 'false',
-    work_dir: workDir,
-    run_date: stamp,
-};
+// voice3 shares the voice2 workspace (F08); only the vars and the publish seam differ.
+const isVoice3 = values.workflow === 'kk-daily-ai-voice3';
+const vars = isVoice3
+    ? {
+          auto_publish: 'true',
+          ...(values['publish-preset'] !== undefined ? { publish_preset: values['publish-preset'] } : {}),
+          ...(values.window ? { window: values.window } : {}),
+          skip_review: 'true',
+          agent: values.agent,
+          agent_retry: values['retry-agent'],
+          work_dir: workDir,
+          run_date: stamp,
+      }
+    : {
+          publish_enabled: 'true',
+          skip_review: 'true',
+          agent: values.agent,
+          agent_retry: values['retry-agent'],
+          wechat_live: values['wechat-live'] === true ? 'true' : 'false',
+          work_dir: workDir,
+          run_date: stamp,
+      };
 writeFileSync(receiptPath, JSON.stringify({ runId, startedAt, status: 'running', workDir }, null, 2));
 let interrupted = false;
 let timedOut = false;
@@ -51,7 +67,7 @@ const child = spawn(
         '--no-logo',
         'workflow',
         'run',
-        'plugins/kk/workflows/kk-daily-ai-voice2.yaml',
+        `plugins/kk/workflows/${values.workflow}.yaml`,
         '--run-id',
         runId,
         '--vars',
@@ -135,7 +151,9 @@ if (child.pid !== undefined && (timedOut || interrupted || exitCode !== 0)) {
     await Bun.sleep(100);
 }
 const workflowStatus = timedOut ? 'timed-out' : interrupted ? 'interrupted' : exitCode === 0 ? 'done' : 'failed';
-const primaryPublishStatus = readOptional(join(workDir, '31-publish', `${stamp}_17_publish_publish-status.txt`));
+const primaryPublishStatus = isVoice3
+    ? readOptional(join(workDir, '4-publish', 'publish-status.after-generate.txt'))
+    : readOptional(join(workDir, '31-publish', `${stamp}_17_publish_publish-status.txt`));
 const runSummary = readOptional(join(workDir, 'run-report.summary.txt'));
 const cleanup: { command: string; exitCode: number | null }[] = [];
 let reservationRecovery: { status: string; reason: string; released?: number } = {
@@ -168,21 +186,23 @@ if (workflowStatus !== 'done' || runSummary?.startsWith('no-content:')) {
             run?: { runId?: string; workflowName?: string; status?: string; startedAt?: string };
             events?: { kind?: string; node?: string; status?: string }[];
         };
-        const sendNodes = new Set([
-            'publish-surfdash',
-            'publish-podcast',
-            'xhs-publish',
-            'wechat-publish',
-            'translate-localize',
-            'translate',
-            'translate-retry',
-            'translate-sync',
-            'publish-classify',
-        ]);
+        const sendNodes = isVoice3
+            ? new Set(['publish', 'send', 'send-retry', 'repair', 'send-confirm'])
+            : new Set([
+                  'publish-surfdash',
+                  'publish-podcast',
+                  'xhs-publish',
+                  'wechat-publish',
+                  'translate-localize',
+                  'translate',
+                  'translate-retry',
+                  'translate-sync',
+                  'publish-classify',
+              ]);
         const validTrace =
             trace.status === 0 &&
             parsed.run?.runId === runId &&
-            parsed.run?.workflowName === 'kk-daily-ai-voice2' &&
+            parsed.run?.workflowName === values.workflow &&
             parsed.run?.status === (workflowStatus === 'done' ? 'done' : 'failed') &&
             Date.parse(parsed.run.startedAt ?? '') >= Date.parse(startedAt) - 1000 &&
             Date.parse(parsed.run.startedAt ?? '') <= Date.now() &&
@@ -227,7 +247,7 @@ if (workflowStatus !== 'done' || runSummary?.startsWith('no-content:')) {
         // potentially aired story. Keep the reservation and the original failure visible.
     }
 }
-const ledger = spawnSync('kk', ['ledger', 'sync', '--workflow', 'kk-daily-ai-voice2', '--work-dir', workDir], {
+const ledger = spawnSync('kk', ['ledger', 'sync', '--workflow', values.workflow, '--work-dir', workDir], {
     cwd: repo,
     encoding: 'utf-8',
     timeout: 20000,
@@ -244,33 +264,63 @@ const requiredChannels = values['required-channels']
     .split(',')
     .map((channel) => channel.trim())
     .filter(Boolean);
-let channelCompleteness: { channel: string; state: string; detail?: string }[] = [];
+let channelCompleteness: { channel: string; state: string; detail?: string; required?: boolean; dummy?: boolean }[] =
+    [];
 try {
-    const parsed = JSON.parse(
-        readOptional(join(workDir, '31-publish', `${stamp}_17_publish_completeness.json`)) ?? 'null',
-    ) as { rows?: unknown } | null;
-    if (Array.isArray(parsed?.rows)) {
-        channelCompleteness = parsed.rows.filter(
-            (row): row is { channel: string; state: string; detail?: string } =>
-                row !== null &&
-                typeof row === 'object' &&
-                typeof row.channel === 'string' &&
-                typeof row.state === 'string',
-        );
+    if (isVoice3) {
+        const outcome = JSON.parse(
+            readOptional(join(workDir, '4-publish', 'outcome.after-generate.json')) ?? 'null',
+        ) as { rows?: unknown } | null;
+        if (Array.isArray(outcome?.rows)) {
+            channelCompleteness = outcome.rows.flatMap(
+                (row): { channel: string; state: string; required: boolean; dummy: boolean }[] => {
+                    if (row === null || typeof row !== 'object') return [];
+                    const r = row as { id?: unknown; required?: unknown; dummy?: unknown; status?: unknown };
+                    if (typeof r.id !== 'string' || typeof r.status !== 'string') return [];
+                    return [
+                        {
+                            channel: r.id,
+                            state: r.status === 'succeeded' ? 'done' : r.status,
+                            required: r.required === true,
+                            dummy: r.dummy === true,
+                        },
+                    ];
+                },
+            );
+        }
+    } else {
+        const parsed = JSON.parse(
+            readOptional(join(workDir, '31-publish', `${stamp}_17_publish_completeness.json`)) ?? 'null',
+        ) as { rows?: unknown } | null;
+        if (Array.isArray(parsed?.rows)) {
+            channelCompleteness = parsed.rows.filter(
+                (row): row is { channel: string; state: string; detail?: string } =>
+                    row !== null &&
+                    typeof row === 'object' &&
+                    typeof row.channel === 'string' &&
+                    typeof row.state === 'string',
+            );
+        }
     }
 } catch {}
-const missingRequiredChannels = requiredChannels.filter((channel) => {
-    const rows = channelCompleteness.filter((row) => row.channel === channel);
-    return rows.length !== 1 || rows[0]?.state !== 'done';
-});
+const missingRequiredChannels = isVoice3
+    ? channelCompleteness
+          .filter((row) => row.required === true && row.dummy !== true)
+          .filter((row) => row.state !== 'done')
+          .map((row) => row.channel)
+    : requiredChannels.filter((channel) => {
+          const rows = channelCompleteness.filter((row) => row.channel === channel);
+          return rows.length !== 1 || rows[0]?.state !== 'done';
+      });
 // 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).
 const status =
     workflowStatus !== 'done'
         ? workflowStatus
         : runSummary?.startsWith('no-content:')
           ? 'no-content'
-          : primaryPublishStatus === 'full' && missingRequiredChannels.length === 0
+          : primaryPublishStatus === 'full' && !(!isVoice3 && missingRequiredChannels.length > 0)
             ? 'done'
             : 'incomplete';
 const receipt = {