@gobing-ai/knowledge-kit 0.1.1 → 0.1.2

package/.claude-plugin/marketplace.json

@@ -6,7 +6,7 @@
     },
     "plugins": [
         {
-            "version": "0.1.1",
+            "version": "0.1.2",
             "name": "kk",
             "source": "./plugins/kk",
             "description": "knowledge-kit — a set of toolkit for knowledge management"

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gobing-ai/knowledge-kit",
-    "version": "0.1.1",
+    "version": "0.1.2",
     "description": "An ingest → create → publish content pipeline CLI (Bun).",
     "repository": {
         "type": "git",

package/plugins/generations/news-report-gen/dist/index.js

@@ -12395,6 +12395,27 @@ function minimumsFromEnv() {
   }
   return out;
 }
+async function readPublishCompleteness(path) {
+  if (!path || path.trim() === "")
+    return null;
+  try {
+    const parsed = JSON.parse(await Bun.file(path).text());
+    const rows = parsed?.rows;
+    if (!Array.isArray(rows) || rows.length === 0)
+      return null;
+    const missing = parsed.missing;
+    return {
+      rows: rows.filter((row) => row !== null && typeof row === "object").map((row) => ({
+        channel: typeof row.channel === "string" ? row.channel : "?",
+        state: typeof row.state === "string" ? row.state : "?",
+        detail: typeof row.detail === "string" ? row.detail : ""
+      })),
+      missing: Array.isArray(missing) ? missing.filter((name) => typeof name === "string") : []
+    };
+  } catch {
+    return null;
+  }
+}
 async function readQcSummary(path) {
   if (!path || path.trim() === "")
     return null;
@@ -12561,6 +12582,19 @@ function renderReportMarkdown(docs, date, options = {}) {
       lines.push(`| ${issue.type} | ${issue.count} |`);
     lines.push("");
   }
+  const completeness = options.completeness ?? null;
+  if (completeness !== null) {
+    lines.push("## \u53D1\u5E03\u5B8C\u6574\u6027", "");
+    lines.push("| \u901A\u9053 | \u72B6\u6001 | \u8BF4\u660E |", "| --- | --- | --- |");
+    for (const row of completeness.rows) {
+      const detail = row.detail.replace(/\|/g, "\\|").replace(/\s+/g, " ").slice(0, 200);
+      lines.push(`| ${row.channel} | ${row.state} | ${detail || "\u2014"} |`);
+    }
+    lines.push("");
+    if (completeness.missing.length > 0) {
+      lines.push(`**\u672A\u5B8C\u6210\u901A\u9053**: ${completeness.missing.join(", ")} \u2014 \u8BE6\u7EC6\u539F\u56E0\u89C1\u4E0A\u8868\uFF0C\u91CD\u8DD1\u5BF9\u5E94 stage \u53EF\u8865\u53D1\uFF08'kk stage daily-publish-<channel> \u2026'\uFF09\u3002`, "");
+    }
+  }
   const timing = options.timing ?? [];
   if (timing.length > 0) {
     lines.push("## \u6B65\u8017\u65F6", "");
@@ -12653,7 +12687,16 @@ async function processGeneratorIO(inputPath, outputPath) {
   const scriptSource = await readScriptSource(process.env.NEWS_REPORT_SCRIPT_FILE);
   const planAudit = await readPlanAudit(process.env.NEWS_REPORT_PLAN_AUDIT_FILE);
   const blended = await readBlendedCorpus(process.env.NEWS_REPORT_BLENDED_FILE);
-  const content = docsToContent(docs, dateFromEnv(), { rejected, timing, qc, scriptSource, planAudit, blended });
+  const completeness = await readPublishCompleteness(process.env.NEWS_REPORT_COMPLETENESS_FILE);
+  const content = docsToContent(docs, dateFromEnv(), {
+    rejected,
+    timing,
+    qc,
+    scriptSource,
+    planAudit,
+    blended,
+    completeness
+  });
   const fs = createNodeFileSystem();
   const outDir = dirname2(outputPath);
   if (outDir && outDir !== ".")
@@ -12692,6 +12735,7 @@ export {
   processGeneratorIO,
   readBlendedCorpus,
   readPlanAudit,
+  readPublishCompleteness,
   readQcSummary,
   readRejectedAudit,
   readScriptSource,

package/plugins/generations/news-report-gen/src/index.ts

@@ -27,6 +27,9 @@ import { echoError } from '@gobing-ai/ts-utils';
  * - `NEWS_REPORT_SCRIPT_FILE` — the script stage's Content path
  *   (`24-script/<date>_08_script_content.json`, F613 R5); absent or metadata-less -> the
  *   脚本来源 line is omitted, never throw.
+ * - `NEWS_REPORT_COMPLETENESS_FILE` — the publish tail's channel ledger
+ *   (`31-publish/<date>_17_publish_completeness.json`, written by
+ *   `kk stage daily-publish-completeness`); absent -> the 发布完整性 section is omitted, never throw.
  * - `NEWS_REPORT_TIMING_FILE` — `<work_dir>/step-timing.json` JSONL of
  *   {step, startedAt, endedAt} appended by the workflow shell steps; missing
  *   or unreadable -> the timing section is omitted, never throw.
@@ -152,6 +155,49 @@ interface RejectedAudit {
     reasons: string[];
 }
 
+/** One independent publish channel's terminal state, as the publish tail recorded it. */
+export interface PublishCompletenessRow {
+    channel: string;
+    state: string;
+    detail: string;
+}
+
+export interface PublishCompleteness {
+    rows: PublishCompletenessRow[];
+    /** Channels that did not reach `done` — the ones the operator has to act on. */
+    missing: string[];
+}
+
+/**
+ * Read the publish tail's completeness ledger (`kk stage daily-publish-completeness`).
+ *
+ * Best-effort by contract like every other report input: absent, unreadable, malformed, or
+ * row-less -> `null` and the section is omitted. The ledger is the only place the independent
+ * channels (xhs, wechat, locales, cms-resync) surface — they never enter `publish_status` — so
+ * 20261016 a run that drafted nothing to WeChat/XHS reported only its scoring and QC.
+ */
+export async function readPublishCompleteness(path: string | undefined): Promise<PublishCompleteness | null> {
+    if (!path || path.trim() === '') return null;
+    try {
+        const parsed: unknown = JSON.parse(await Bun.file(path).text());
+        const rows = (parsed as { rows?: unknown } | null)?.rows;
+        if (!Array.isArray(rows) || rows.length === 0) return null;
+        const missing = (parsed as { missing?: unknown }).missing;
+        return {
+            rows: rows
+                .filter((row): row is Record<string, unknown> => row !== null && typeof row === 'object')
+                .map((row) => ({
+                    channel: typeof row.channel === 'string' ? row.channel : '?',
+                    state: typeof row.state === 'string' ? row.state : '?',
+                    detail: typeof row.detail === 'string' ? row.detail : '',
+                })),
+            missing: Array.isArray(missing) ? missing.filter((name): name is string => typeof name === 'string') : [],
+        };
+    } catch {
+        return null;
+    }
+}
+
 /** Generate-stage audio QC summary rendered into the run report (task 0139 R5b). */
 export interface QcSummary {
     passed: boolean;
@@ -278,6 +324,7 @@ export function renderReportMarkdown(
         scriptSource?: ScriptSource | null;
         planAudit?: PlanAuditRow[] | null;
         blended?: BlendedDoc[] | null;
+        completeness?: PublishCompleteness | null;
     } = {},
 ): string {
     const lines: string[] = [`# 每日 AI 语音运行报告 — ${date}`, ''];
@@ -376,6 +423,26 @@ export function renderReportMarkdown(
         lines.push('');
     }
 
+    const completeness = options.completeness ?? null;
+    if (completeness !== null) {
+        // 20261016: the independent channels (xhs, wechat, locales, cms-resync) are non-blocking and
+        // never enter `publish_status`, so a run that drafted nothing to WeChat/XHS still reported
+        // `full`. Surface each channel's state here instead of leaving it to a separate JSON.
+        lines.push('## 发布完整性', '');
+        lines.push('| 通道 | 状态 | 说明 |', '| --- | --- | --- |');
+        for (const row of completeness.rows) {
+            const detail = row.detail.replace(/\|/g, '\\|').replace(/\s+/g, ' ').slice(0, 200);
+            lines.push(`| ${row.channel} | ${row.state} | ${detail || '—'} |`);
+        }
+        lines.push('');
+        if (completeness.missing.length > 0) {
+            lines.push(
+                `**未完成通道**: ${completeness.missing.join(', ')} — 详细原因见上表，重跑对应 stage 可补发（'kk stage daily-publish-<channel> …'）。`,
+                '',
+            );
+        }
+    }
+
     const timing = options.timing ?? [];
     if (timing.length > 0) {
         lines.push('## 步耗时', '');
@@ -498,6 +565,7 @@ export function docsToContent(
         scriptSource?: ScriptSource | null;
         planAudit?: PlanAuditRow[] | null;
         blended?: BlendedDoc[] | null;
+        completeness?: PublishCompleteness | null;
     },
 ): Content {
     return ContentSchema.parse({
@@ -522,7 +590,16 @@ export async function processGeneratorIO(inputPath: string, outputPath: string):
     const scriptSource = await readScriptSource(process.env.NEWS_REPORT_SCRIPT_FILE);
     const planAudit = await readPlanAudit(process.env.NEWS_REPORT_PLAN_AUDIT_FILE);
     const blended = await readBlendedCorpus(process.env.NEWS_REPORT_BLENDED_FILE);
-    const content = docsToContent(docs, dateFromEnv(), { rejected, timing, qc, scriptSource, planAudit, blended });
+    const completeness = await readPublishCompleteness(process.env.NEWS_REPORT_COMPLETENESS_FILE);
+    const content = docsToContent(docs, dateFromEnv(), {
+        rejected,
+        timing,
+        qc,
+        scriptSource,
+        planAudit,
+        blended,
+        completeness,
+    });
     const fs = createNodeFileSystem();
     const outDir = dirname(outputPath);
     if (outDir && outDir !== '.') await fs.ensureDir(outDir);

package/plugins/kk/plugin.json

@@ -1,5 +1,5 @@
 {
     "name": "kk",
-    "version": "0.1.1",
+    "version": "0.1.2",
     "description": "knowledge-kit Claude Code plugin: skills, commands, subagents, hooks, and rules"
 }

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

@@ -1509,6 +1509,14 @@ function dailyRunReport(args: string[]): void {
                 NEWS_REPORT_BLENDED_FILE: join(absWorkDir, '10-ingest', `${runDate}_02_collect_blended.json`),
                 // F613 R5: the script stage's Content, read best-effort (absent -> 脚本来源 omitted).
                 NEWS_REPORT_SCRIPT_FILE: join(absWorkDir, '24-script', `${runDate}_08_script_content.json`),
+                // 20261016: the independent publish channels (xhs/wechat/locales/cms-resync) never
+                // enter publish_status, so the report is where an empty draft box becomes visible.
+                // Written by the `daily-publish-completeness` stage that precedes this one.
+                NEWS_REPORT_COMPLETENESS_FILE: join(
+                    absWorkDir,
+                    '31-publish',
+                    `${runDate}_17_publish_completeness.json`,
+                ),
                 NEWS_REPORT_DATE: runDate,
             },
         });

package/plugins/publishings/wechatmp-pub/dist/profile-check.js

@@ -20828,6 +20828,8 @@ if (false) {}
 // ../../plugins/publishings/wechatmp-pub/src/profile-check.ts
 var USAGE = "usage: wechatmp profile-check [login|check|open] [--profile <dir>] [--url <url>] [--timeout <ms>] [--headed]";
 var LOGIN_TIMEOUT_MS = 180000;
+var PROFILE_OVERHEAD_MS = 8000;
+var MIN_READINESS_MS = 1000;
 async function main2(argv = process.argv.slice(2)) {
   let command;
   let profileDir;
@@ -20898,7 +20900,10 @@ async function main2(argv = process.argv.slice(2)) {
   }
   let verdict;
   try {
-    await checkWechatSession(profileDir, { headless: !headed, timeoutMs });
+    await checkWechatSession(profileDir, {
+      headless: !headed,
+      timeoutMs: timeoutMs === undefined ? undefined : Math.max(MIN_READINESS_MS, timeoutMs - PROFILE_OVERHEAD_MS)
+    });
     verdict = {
       status: "verified",
       profileDir,

package/plugins/publishings/wechatmp-pub/src/profile-check.ts

@@ -19,6 +19,16 @@ import { CHANNEL, CONSOLE_URL, checkWechatSession, openWechatLogin, openWechatSe
 const USAGE =
     'usage: wechatmp profile-check [login|check|open] [--profile <dir>] [--url <url>] [--timeout <ms>] [--headed]';
 const LOGIN_TIMEOUT_MS = 180_000;
+/**
+ * The one browser open, console navigation and context close a `check` performs around its readiness
+ * poll (headless ~3-4s, headed ~5-8s). `--timeout` is the WHOLE probe budget — kk SIGKILLs the process
+ * at that instant — so the poll must not spend all of it: a dead session then dies mid-report and
+ * surfaces as `probe exit 1 (malformed probe output)` instead of `refused` (observed 2026-10-16, where
+ * the 30s poll plus overhead overran `kk plugin check`'s 30s default).
+ */
+const PROFILE_OVERHEAD_MS = 8_000;
+/** Floor for the readiness poll, so a tiny `--timeout` still probes the console instead of refusing blind. */
+const MIN_READINESS_MS = 1_000;
 
 interface WechatVerdict {
     status: 'verified' | 'refused';
@@ -106,7 +116,11 @@ export async function main(argv: string[] = process.argv.slice(2)): Promise<numb
 
     let verdict: WechatVerdict;
     try {
-        await checkWechatSession(profileDir, { headless: !headed, timeoutMs });
+        await checkWechatSession(profileDir, {
+            headless: !headed,
+            timeoutMs:
+                timeoutMs === undefined ? undefined : Math.max(MIN_READINESS_MS, timeoutMs - PROFILE_OVERHEAD_MS),
+        });
         verdict = {
             status: 'verified',
             profileDir,

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

@@ -21269,6 +21269,10 @@ async function validateModeInput(operation, content) {
 }
 
 // ../../plugins/publishings/xhs-pub/src/page.ts
+var TRANSIENT_NAVIGATION = /net::ERR_(?:TIMED_OUT|CONNECTION_(?:RESET|CLOSED|TIMED_OUT|ABORTED|REFUSED|FAILED)|NETWORK_(?:CHANGED|IO_SUSPENDED)|EMPTY_RESPONSE|ADDRESS_UNREACHABLE|NAME_NOT_RESOLVED)/;
+function isTransientNavigationError(error) {
+  return TRANSIENT_NAVIGATION.test(error instanceof Error ? error.message : String(error));
+}
 var POLL_MS = 500;
 var STEP_TIMEOUT_MS = 30000;
 var CREATOR_TAB_BAR = "div.creator-tab";
@@ -21314,7 +21318,16 @@ function wrapPlaywrightPage(raw, shadow) {
     return found;
   };
   return {
-    goto: (url, options) => pw.goto(url, options),
+    goto: async (url, options) => {
+      const navigate = () => pw.goto(url, { waitUntil: "domcontentloaded", ...options });
+      try {
+        await navigate();
+      } catch (error) {
+        if (!isTransientNavigationError(error))
+          throw error;
+        await navigate();
+      }
+    },
     locator: (selector) => ({
       count: () => pw.locator(selector).count(),
       first: () => {

package/plugins/publishings/xhs-pub/dist/profile-check.js

@@ -20947,6 +20947,10 @@ if (false) {}
 var PUBLISH_URL = "https://creator.xiaohongshu.com/publish/publish";
 
 // ../../plugins/publishings/xhs-pub/src/page.ts
+var TRANSIENT_NAVIGATION = /net::ERR_(?:TIMED_OUT|CONNECTION_(?:RESET|CLOSED|TIMED_OUT|ABORTED|REFUSED|FAILED)|NETWORK_(?:CHANGED|IO_SUSPENDED)|EMPTY_RESPONSE|ADDRESS_UNREACHABLE|NAME_NOT_RESOLVED)/;
+function isTransientNavigationError(error) {
+  return TRANSIENT_NAVIGATION.test(error instanceof Error ? error.message : String(error));
+}
 function wrapPlaywrightPage(raw, shadow) {
   const pw = raw;
   const onScreen = async (selector) => {
@@ -20968,7 +20972,16 @@ function wrapPlaywrightPage(raw, shadow) {
     return found;
   };
   return {
-    goto: (url, options) => pw.goto(url, options),
+    goto: async (url, options) => {
+      const navigate = () => pw.goto(url, { waitUntil: "domcontentloaded", ...options });
+      try {
+        await navigate();
+      } catch (error) {
+        if (!isTransientNavigationError(error))
+          throw error;
+        await navigate();
+      }
+    },
     locator: (selector) => ({
       count: () => pw.locator(selector).count(),
       first: () => {

package/plugins/publishings/xhs-pub/src/page.ts

@@ -10,6 +10,19 @@ import { waitUntil } from '@gobing-ai/publish-harness/browser';
  * Playwright page is part of this seam, never reached around it.
  */
 
+/**
+ * Connect faults this origin produces intermittently (2026-10-16: `net::ERR_TIMED_OUT` at the
+ * publish page; 2026-10-13: the preflight's `Timeout 30000ms exceeded — waiting until "load"`).
+ * One retry absorbs the flake; a second failure is reported as it is, so a real outage still fails.
+ */
+const TRANSIENT_NAVIGATION =
+    /net::ERR_(?:TIMED_OUT|CONNECTION_(?:RESET|CLOSED|TIMED_OUT|ABORTED|REFUSED|FAILED)|NETWORK_(?:CHANGED|IO_SUSPENDED)|EMPTY_RESPONSE|ADDRESS_UNREACHABLE|NAME_NOT_RESOLVED)/;
+
+/** Whether a navigation failed for a reason a single retry can plausibly clear. */
+function isTransientNavigationError(error: unknown): boolean {
+    return TRANSIENT_NAVIGATION.test(error instanceof Error ? error.message : String(error));
+}
+
 export const POLL_MS = 500;
 
 // The shared poll (0184 R2); re-exported so flow/index keep importing it from here.
@@ -169,7 +182,18 @@ export function wrapPlaywrightPage(raw: unknown, shadow?: ShadowProbe): XhsPage
     };
 
     return {
-        goto: (url, options) => pw.goto(url, options) as Promise<void>,
+        // `domcontentloaded`, never Playwright's `load` default: the console keeps long-lived
+        // subresources open, so a `load` wait turns a healthy visit into a timeout (2026-10-13
+        // preflight). Pinned here once, the way wechatmp-pub/src/page.ts already pins it.
+        goto: async (url, options) => {
+            const navigate = (): Promise<unknown> => pw.goto(url, { waitUntil: 'domcontentloaded', ...options });
+            try {
+                await navigate();
+            } catch (error) {
+                if (!isTransientNavigationError(error)) throw error;
+                await navigate();
+            }
+        },
         locator: (selector) => ({
             count: () => pw.locator(selector).count(),
             first: () => {