@gobing-ai/knowledge-kit 0.0.32 → 0.0.33

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

@@ -14671,7 +14671,7 @@ var init_zod = __esm(() => {
   init_external();
 });
 
-// ../../node_modules/.bun/@gobing-ai+ts-utils@0.5.15/node_modules/@gobing-ai/ts-utils/dist/errors.js
+// ../../node_modules/.bun/@gobing-ai+ts-utils@0.5.18/node_modules/@gobing-ai/ts-utils/dist/errors.js
 var ErrorCode;
 var init_errors3 = __esm(() => {
   ErrorCode = {
@@ -14682,7 +14682,7 @@ var init_errors3 = __esm(() => {
   };
 });
 
-// ../../node_modules/.bun/@gobing-ai+ts-utils@0.5.15/node_modules/@gobing-ai/ts-utils/dist/api-response.js
+// ../../node_modules/.bun/@gobing-ai+ts-utils@0.5.18/node_modules/@gobing-ai/ts-utils/dist/api-response.js
 var API_ERROR_CODES, ERROR_CODE_TO_HTTP, CLIENT_SAFE_CODES;
 var init_api_response = __esm(() => {
   init_errors3();
@@ -14705,10 +14705,10 @@ var init_api_response = __esm(() => {
   CLIENT_SAFE_CODES = new Set([ErrorCode.NotFound, ErrorCode.Validation, ErrorCode.Conflict]);
 });
 
-// ../../node_modules/.bun/@gobing-ai+ts-utils@0.5.15/node_modules/@gobing-ai/ts-utils/dist/cursor.js
+// ../../node_modules/.bun/@gobing-ai+ts-utils@0.5.18/node_modules/@gobing-ai/ts-utils/dist/cursor.js
 var init_cursor = () => {};
 
-// ../../node_modules/.bun/@gobing-ai+ts-utils@0.5.15/node_modules/@gobing-ai/ts-utils/dist/env.js
+// ../../node_modules/.bun/@gobing-ai+ts-utils@0.5.18/node_modules/@gobing-ai/ts-utils/dist/env.js
 function getEnvVar(name, fallback) {
   const raw = process.env[name];
   return raw === undefined ? fallback : raw;
@@ -14717,10 +14717,10 @@ function getEnvVars() {
   return process.env;
 }
 
-// ../../node_modules/.bun/@gobing-ai+ts-utils@0.5.15/node_modules/@gobing-ai/ts-utils/dist/event-severity.js
+// ../../node_modules/.bun/@gobing-ai+ts-utils@0.5.18/node_modules/@gobing-ai/ts-utils/dist/event-severity.js
 var init_event_severity = () => {};
 
-// ../../node_modules/.bun/@gobing-ai+ts-utils@0.5.15/node_modules/@gobing-ai/ts-utils/dist/object.js
+// ../../node_modules/.bun/@gobing-ai+ts-utils@0.5.18/node_modules/@gobing-ai/ts-utils/dist/object.js
 function isPlainObject2(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
@@ -14738,7 +14738,7 @@ function deepMerge(target, source) {
   return result;
 }
 
-// ../../node_modules/.bun/@gobing-ai+ts-utils@0.5.15/node_modules/@gobing-ai/ts-utils/dist/output.js
+// ../../node_modules/.bun/@gobing-ai+ts-utils@0.5.18/node_modules/@gobing-ai/ts-utils/dist/output.js
 function processStream(name) {
   const proc = globalThis.process;
   const stream = proc?.[name];
@@ -14756,7 +14756,7 @@ function echoError(message, target = defaultStderrTarget ?? processStream("stder
 }
 var defaultStderrTarget;
 
-// ../../node_modules/.bun/@gobing-ai+ts-utils@0.5.15/node_modules/@gobing-ai/ts-utils/dist/index.js
+// ../../node_modules/.bun/@gobing-ai+ts-utils@0.5.18/node_modules/@gobing-ai/ts-utils/dist/index.js
 var init_dist = __esm(() => {
   init_api_response();
   init_cursor();
@@ -21754,7 +21754,7 @@ var init_dist2 = __esm(() => {
   $visitAsync = visit.visitAsync;
 });
 
-// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.5.15/node_modules/@gobing-ai/ts-runtime/dist/config.js
+// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.5.18+ea28d47622d670ff/node_modules/@gobing-ai/ts-runtime/dist/config.js
 function getProcessEnv() {
   return getEnvVars();
 }
@@ -21832,7 +21832,7 @@ var init_config = __esm(() => {
   };
 });
 
-// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.5.15/node_modules/@gobing-ai/ts-runtime/dist/file-system-node.js
+// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.5.18+ea28d47622d670ff/node_modules/@gobing-ai/ts-runtime/dist/file-system-node.js
 import { appendFileSync, cpSync, createReadStream, createWriteStream, existsSync, mkdirSync, readdirSync, readFileSync, realpathSync, renameSync, rmSync, statSync, writeFileSync } from "fs";
 import { dirname, resolve as resolvePath } from "path";
 function createNodeFileSystem(root, paths) {
@@ -21919,7 +21919,7 @@ function findProjectRoot(startDir) {
 }
 var init_file_system_node = () => {};
 
-// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.5.15/node_modules/@gobing-ai/ts-runtime/dist/db-errors.js
+// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.5.18+ea28d47622d670ff/node_modules/@gobing-ai/ts-runtime/dist/db-errors.js
 var DbModuleNotInstalledError;
 var init_db_errors = __esm(() => {
   DbModuleNotInstalledError = class DbModuleNotInstalledError extends Error {
@@ -29130,7 +29130,7 @@ var init_execa = __esm(() => {
   } = getIpcExport());
 });
 
-// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.5.15/node_modules/@gobing-ai/ts-runtime/dist/process-group.js
+// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.5.18+ea28d47622d670ff/node_modules/@gobing-ai/ts-runtime/dist/process-group.js
 function resolveDeadline(optionTimeout, defaultTimeout) {
   if (optionTimeout === null)
     return null;
@@ -29222,7 +29222,7 @@ function ownProcessGroupLifecycle(ownership) {
 }
 var MAX_TIMEOUT_MS = 2147483647, DEFAULT_KILL_GRACE_MS = 5000, GROUP_POLL_INTERVAL_MS = 25, GROUP_KILL_PATIENCE_MS = 2000;
 
-// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.5.15/node_modules/@gobing-ai/ts-runtime/dist/process-executor.js
+// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.5.18+ea28d47622d670ff/node_modules/@gobing-ai/ts-runtime/dist/process-executor.js
 import { isatty } from "tty";
 function processEventSeverity(reason, exitCode) {
   if (reason === "error")
@@ -29594,7 +29594,7 @@ var init_process_executor = __esm(() => {
   init_config();
 });
 
-// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.5.15/node_modules/@gobing-ai/ts-runtime/dist/runtime-node-bun.js
+// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.5.18+ea28d47622d670ff/node_modules/@gobing-ai/ts-runtime/dist/runtime-node-bun.js
 function getNodeFileSystem() {
   if (!_nodeFileSystem)
     _nodeFileSystem = createNodeFileSystem();
@@ -29741,15 +29741,16 @@ var PluginManifestSchema = exports_external.looseObject({
   name: exports_external.string().min(1),
   kind: PluginKindSchema,
   entry: exports_external.string().min(1),
+  check: exports_external.string().min(1).optional(),
   version: exports_external.string().optional(),
   description: exports_external.string().optional(),
   operations: exports_external.record(exports_external.string(), PluginOperationSchema).optional()
 });
-// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.5.15/node_modules/@gobing-ai/ts-runtime/dist/index.js
+// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.5.18+ea28d47622d670ff/node_modules/@gobing-ai/ts-runtime/dist/index.js
 init_file_system_node();
 init_config();
 
-// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.5.15/node_modules/@gobing-ai/ts-runtime/dist/path.js
+// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.5.18+ea28d47622d670ff/node_modules/@gobing-ai/ts-runtime/dist/path.js
 function normalizeSeparators(path6) {
   return path6.replaceAll("\\", "/");
 }
@@ -29807,7 +29808,7 @@ function getProcessCwd() {
   return globalThis.process?.cwd?.() ?? "/";
 }
 
-// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.5.15/node_modules/@gobing-ai/ts-runtime/dist/index.js
+// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.5.18+ea28d47622d670ff/node_modules/@gobing-ai/ts-runtime/dist/index.js
 init_runtime_node_bun();
 
 // ../../packages/kk-core/src/render-md.ts
@@ -29920,7 +29921,10 @@ async function trySelectors(page, selectors, options = {}) {
   return { found: false, selector: null };
 }
 
-// ../../node_modules/.bun/@gobing-ai+ts-browser-automation@0.5.15+e28deaf1f2c5a2b1/node_modules/@gobing-ai/ts-browser-automation/dist/errors.js
+// ../../packages/publish-harness/src/browser.ts
+import { resolve as resolve2 } from "path";
+
+// ../../node_modules/.bun/@gobing-ai+ts-browser-automation@0.5.18+1f5782d4d327a230/node_modules/@gobing-ai/ts-browser-automation/dist/errors.js
 class BrowserAutomationError extends Error {
   constructor(message, options) {
     super(message, options);
@@ -29969,10 +29973,10 @@ class OperationAbortedError extends BrowserAutomationError {
     this.name = "OperationAbortedError";
   }
 }
-// ../../node_modules/.bun/@gobing-ai+ts-browser-automation@0.5.15+e28deaf1f2c5a2b1/node_modules/@gobing-ai/ts-browser-automation/dist/launcher.js
+// ../../node_modules/.bun/@gobing-ai+ts-browser-automation@0.5.18+1f5782d4d327a230/node_modules/@gobing-ai/ts-browser-automation/dist/launcher.js
 import { mkdir } from "fs/promises";
 
-// ../../node_modules/.bun/@gobing-ai+ts-browser-automation@0.5.15+e28deaf1f2c5a2b1/node_modules/@gobing-ai/ts-browser-automation/dist/profile-dir.js
+// ../../node_modules/.bun/@gobing-ai+ts-browser-automation@0.5.18+1f5782d4d327a230/node_modules/@gobing-ai/ts-browser-automation/dist/profile-dir.js
 function resolveProfileDir(profileDir) {
   if (profileDir.trim() === "") {
     throw new InvalidProfileDirError;
@@ -29984,7 +29988,7 @@ function resolveProfileDir(profileDir) {
   return resolved;
 }
 
-// ../../node_modules/.bun/@gobing-ai+ts-browser-automation@0.5.15+e28deaf1f2c5a2b1/node_modules/@gobing-ai/ts-browser-automation/dist/launcher.js
+// ../../node_modules/.bun/@gobing-ai+ts-browser-automation@0.5.18+1f5782d4d327a230/node_modules/@gobing-ai/ts-browser-automation/dist/launcher.js
 var PROFILE_DIR_MODE = 448;
 var BUSY_PROFILE_PATTERN = /singleton|already in use|in use by another/i;
 var CHROMIUM_MISSING_PATTERN = /playwright install|executable doesn't exist/i;
@@ -30035,7 +30039,7 @@ function createPersistentLauncher(options = {}) {
   };
 }
 
-// ../../node_modules/.bun/@gobing-ai+ts-browser-automation@0.5.15+e28deaf1f2c5a2b1/node_modules/@gobing-ai/ts-browser-automation/dist/operations.js
+// ../../node_modules/.bun/@gobing-ai+ts-browser-automation@0.5.18+1f5782d4d327a230/node_modules/@gobing-ai/ts-browser-automation/dist/operations.js
 var DEFAULT_TIMEOUT_MS = 30000;
 var POLL_INTERVAL_MS = 250;
 var defaultLauncher;
@@ -30044,12 +30048,6 @@ function getDefaultLauncher() {
     defaultLauncher = createPersistentLauncher();
   return defaultLauncher;
 }
-async function openPersistentBrowser(options) {
-  return (options.launcher ?? getDefaultLauncher()).launch({
-    profileDir: resolveProfileDir(options.profileDir),
-    headless: options.headless
-  });
-}
 async function withProfilePage(options, callback) {
   assertNotAborted(options.signal);
   if (options.isAuthenticated !== undefined)
@@ -30120,11 +30118,67 @@ async function pollPredicate(page, predicate, timeoutMs, signal) {
 function sleep(ms) {
   return new Promise((resolve2) => setTimeout(resolve2, ms));
 }
+// ../../packages/publish-harness/src/profile-dir.ts
+import { mkdir as mkdir2, stat } from "fs/promises";
+async function ensureProfileDir2(profileDir, headless) {
+  const existing = await stat(profileDir).catch(() => null);
+  if (existing) {
+    if (!existing.isDirectory())
+      throw new InvalidProfileDirError(`profileDir is not a directory: "${profileDir}".`);
+    return;
+  }
+  if (headless)
+    throw new BrowserProfileMissingError(profileDir);
+  await mkdir2(profileDir, { recursive: true, mode: 448 });
+}
+
 // ../../packages/publish-harness/src/browser.ts
 var DEFAULT_CHECK_TIMEOUT_MS = 30000;
 var DEFAULT_STEP_TIMEOUT_MS = 30000;
 var DEFAULT_POLL_MS = 500;
 var ATTACH_POLL_MS = 100;
+function createKkBrowserLauncher(loadPlaywright = () => import("playwright")) {
+  return {
+    async launch(request) {
+      if (request.profileDir.trim() === "")
+        throw new InvalidProfileDirError;
+      const profileDir = resolve2(request.profileDir);
+      await ensureProfileDir2(profileDir, request.headless);
+      let playwright;
+      try {
+        playwright = await loadPlaywright();
+      } catch (error51) {
+        throw new PlaywrightUnavailableError('The "playwright" dependency is not installed. Run `bunx playwright install chromium`.', { cause: error51 });
+      }
+      const channel = process.env.KK_BROWSER_CHANNEL?.trim() || "chromium";
+      let context2;
+      try {
+        context2 = await playwright.chromium.launchPersistentContext(profileDir, {
+          headless: request.headless,
+          channel,
+          args: ["--disable-blink-features=AutomationControlled"],
+          ignoreDefaultArgs: ["--enable-automation"]
+        });
+      } catch (error51) {
+        const message = errorMessage2(error51);
+        if (/singleton|already in use|in use by another/i.test(message)) {
+          throw new BrowserProfileBusyError(profileDir, error51);
+        }
+        if (/playwright install|executable doesn't exist/i.test(message)) {
+          throw new PlaywrightUnavailableError(`Browser channel '${channel}' is not installed. Run \`bunx playwright install chromium\` (or install Google Chrome for KK_BROWSER_CHANNEL=chrome).`, { cause: error51 });
+        }
+        throw error51;
+      }
+      await context2.addInitScript(() => {
+        Object.defineProperty(navigator, "webdriver", { get: () => {
+          return;
+        } });
+      });
+      return context2;
+    }
+  };
+}
+var kkBrowserLauncher = createKkBrowserLauncher();
 function resolveChannelProfileDir(channel, override) {
   const tiers = [override, process.env[`${channel.toUpperCase()}_PROFILE_DIR`], process.env.KK_BROWSER_PROFILE_DIR];
   const chosen = tiers.find((tier) => tier !== undefined && tier.trim().length > 0);
@@ -30132,7 +30186,7 @@ function resolveChannelProfileDir(channel, override) {
 }
 async function checkChannelSession(config3, opts) {
   const timeoutMs = opts.timeoutMs ?? DEFAULT_CHECK_TIMEOUT_MS;
-  const passes = opts.headedFallback === false ? [true] : [true, false];
+  const passes = opts.headedOnly ? [false] : opts.headedFallback === false ? [true] : [true, false];
   let lastDetail = `${config3.channel} readiness was never probed`;
   for (const headless of passes) {
     try {
@@ -30142,12 +30196,12 @@ async function checkChannelSession(config3, opts) {
         url: config3.homeUrl,
         isAuthenticated: config3.isAuthenticated,
         timeoutMs,
-        launcher: opts.launcher
+        launcher: opts.launcher ?? kkBrowserLauncher
       }, async () => true);
       return {
         status: "verified",
         profileDir: opts.profileDir,
-        detail: `authenticated ${config3.channel} session observed ${headless ? "headlessly" : "via headed fallback"} via profile ${opts.profileDir} (read-only)`
+        detail: `authenticated ${config3.channel} session observed ${headless ? "headlessly" : "via a headed pass"} via profile ${opts.profileDir} (read-only)`
       };
     } catch (error51) {
       if (error51 instanceof BrowserProfileMissingError) {
@@ -30168,7 +30222,7 @@ async function waitUntil(predicate, timeoutMs, pollMs = DEFAULT_POLL_MS) {
     if (await predicate()) {
       return true;
     }
-    await new Promise((resolve2) => setTimeout(resolve2, pollMs));
+    await new Promise((resolve3) => setTimeout(resolve3, pollMs));
   }
   return predicate();
 }
@@ -30320,14 +30374,14 @@ init_dist();
 
 // ../../plugins/publishings/xhs-pub/src/automation-guard.ts
 import { homedir as homedir2 } from "os";
-import { join as join2, resolve as resolve2 } from "path";
+import { join as join2, resolve as resolve3 } from "path";
 var fs = createNodeFileSystem();
 var CAP_WINDOW_MS = 2 * 60 * 60 * 1000;
 var AUTOMATION_STATE_ENV = "KK_XHS_AUTOMATION_STATE";
 function resolveAutomationStatePath(override) {
   const explicit = override ?? process.env[AUTOMATION_STATE_ENV];
   if (explicit !== undefined && explicit !== "")
-    return resolve2(explicit);
+    return resolve3(explicit);
   return join2(process.env.HOME ?? homedir2(), ".config", "kk", "xhs-automation.json");
 }
 function resetHint(path7) {
@@ -30594,7 +30648,7 @@ async function clickCreatorTab(page, label, opts = {}) {
   const timeoutMs = opts.timeoutMs ?? STEP_TIMEOUT_MS;
   const pollMs = opts.pollMs ?? POLL_MS;
   const onScreenCount = () => page.countOnScreen(CREATOR_TAB_BAR).catch(() => 0);
-  const mounted = await waitUntil2(() => onScreenCount().then((count2) => count2 >= CREATOR_TAB_COUNT), timeoutMs, pollMs);
+  const mounted = await waitUntil(() => onScreenCount().then((count2) => count2 >= CREATOR_TAB_COUNT), timeoutMs, pollMs);
   if (!mounted) {
     const observed = await onScreenCount();
     throw new Error(`mode entry: the console tab bar did not mount within ${timeoutMs}ms (${observed} of ${CREATOR_TAB_COUNT} on-screen '${CREATOR_TAB_BAR}' nodes) \u2014 every tab renders aria-hidden and off-viewport clones`);
@@ -30607,15 +30661,6 @@ async function clickCreatorTab(page, label, opts = {}) {
     throw new Error(`mode entry: no in-viewport '${label}' tab found (only aria-hidden or off-screen clones matched) \u2014 the mode was not entered`);
   }
 }
-async function waitUntil2(predicate, timeoutMs, pollMs = POLL_MS) {
-  const deadline = Date.now() + timeoutMs;
-  while (Date.now() < deadline) {
-    if (await predicate())
-      return true;
-    await new Promise((resolve3) => setTimeout(resolve3, pollMs));
-  }
-  return predicate();
-}
 function wrapPlaywrightPage(raw, shadow) {
   const pw = raw;
   const onScreen = async (selector) => {
@@ -30674,7 +30719,7 @@ async function findSelector(page, selectors, what, timeoutMs = STEP_TIMEOUT_MS)
     const found = await trySelectors(page, selectors);
     if (found.found && found.selector)
       return found.selector;
-    await new Promise((resolve3) => setTimeout(resolve3, POLL_MS));
+    await new Promise((resolve4) => setTimeout(resolve4, POLL_MS));
   }
   throw new Error(`${what}: no matching element observed`);
 }
@@ -30686,7 +30731,7 @@ async function findAttachedSelector(page, selectors, what, timeoutMs = STEP_TIME
       if (attached > 0)
         return selector;
     }
-    await new Promise((resolve3) => setTimeout(resolve3, POLL_MS));
+    await new Promise((resolve4) => setTimeout(resolve4, POLL_MS));
   }
   throw new Error(`${what}: no matching element observed`);
 }
@@ -30734,7 +30779,7 @@ function fail(error51) {
   return ResultSchema.parse({ ok: false, target: TARGET, error: error51 });
 }
 function sleep2(ms) {
-  return new Promise((resolve3) => setTimeout(resolve3, ms));
+  return new Promise((resolve4) => setTimeout(resolve4, ms));
 }
 function asPlaywrightPage(page) {
   return page;
@@ -30856,7 +30901,7 @@ async function typeNoteBody(deps, selectors, what) {
 }
 async function confirmThumbnails(deps, expected) {
   const selector = await findSelector(deps.page, NOTE_THUMBNAIL, "thumbnail wait", deps.stepTimeoutMs);
-  const matches = await waitUntil2(() => deps.page.locator(selector).count().then((count2) => count2 >= expected), deps.stepTimeoutMs);
+  const matches = await waitUntil(() => deps.page.locator(selector).count().then((count2) => count2 >= expected), deps.stepTimeoutMs);
   const observed = await deps.page.locator(selector).count();
   if (!matches || observed !== expected) {
     throw new Error(`thumbnail count: expected ${expected}, observed ${observed}`);
@@ -30896,13 +30941,13 @@ async function isPodcastModalOpen(page) {
 }
 async function leavePodcastModal(deps) {
   const closed = () => isPodcastModalOpen(deps.page).then((open) => !open);
-  if (await waitUntil2(closed, deps.stepTimeoutMs))
+  if (await waitUntil(closed, deps.stepTimeoutMs))
     return;
   if (deps.publishStatus === "public") {
     const advance = await clickLightControl(deps.page, PODCAST_MODAL_ADVANCE, deps.stepTimeoutMs, "podcast modal advance");
     if (!advance.ok)
       throw new Error(advance.error);
-    if (await waitUntil2(closed, deps.stepTimeoutMs))
+    if (await waitUntil(closed, deps.stepTimeoutMs))
       return;
   }
   throw new Error(`podcast modal: the \u53D1\u64AD\u5BA2 modal was still open ${deps.stepTimeoutMs}ms after the audio and cover were attached; the only recorded advance control is '${PODCAST_MODAL_ADVANCE[0]}' and a draft run does not click it (it is publish-adjacent)`);
@@ -30989,7 +31034,7 @@ async function publishNote(input, deps) {
   if (!submitted.ok)
     return fail(submitted.error);
   const urlBeforeSubmit = deps.page.url();
-  const confirmed = await waitUntil2(async () => {
+  const confirmed = await waitUntil(async () => {
     if (deps.page.url().includes(PUBLISHED_MARKER))
       return true;
     return await readScopedSignal(asPlaywrightPage(deps.page), PUBLISH_CONFIRM) !== null;
@@ -31034,7 +31079,7 @@ async function createShadowProbe(context2, page) {
 async function isXhsConsoleReady(page) {
   return trySelectors(page, AUTH_GATE).then((r) => r.found);
 }
-var defaultLauncher2 = openPersistentBrowser;
+var defaultLauncher2 = kkBrowserLauncher.launch;
 function makeDefaultOpenPage(launch = defaultLauncher2) {
   return async (profileDir) => {
     let context2;
@@ -31063,7 +31108,8 @@ async function checkXhsProfileSession(opts) {
   }, {
     profileDir: opts.profileDir,
     launcher: opts.launcher,
-    timeoutMs: opts.timeoutMs ?? PREFLIGHT_TIMEOUT_MS
+    timeoutMs: opts.timeoutMs ?? PREFLIGHT_TIMEOUT_MS,
+    headedOnly: opts.headedOnly === true
   });
 }
 
@@ -31126,7 +31172,7 @@ class XhsBrowserTransport {
     };
     try {
       await act("creator page goto", () => page.goto(PUBLISH_URL, { timeout: this.loginTimeoutMs }));
-      const gated = await waitUntil2(() => isXhsConsoleReady(page), this.loginTimeoutMs);
+      const gated = await waitUntil(() => isXhsConsoleReady(page), this.loginTimeoutMs);
       if (!gated) {
         return fail2(`login timeout after ${this.loginTimeoutMs}ms: no authenticated ${CHANNEL} creator console in ${profileDir}`);
       }

package/plugins/publishings/xhs-pub/plugin.json

@@ -2,6 +2,7 @@
     "name": "xhs-pub",
     "kind": "publish",
     "entry": "./dist/index.js",
+    "check": "./src/profile-check.ts",
     "version": "1.0.0",
     "description": "Publish plugin for Xiaohongshu (xhs): one creator console, four validated operations (上传图文 ≤18 images | 上传视频 | 写长文 | 发播客 audio+cover) saved as a draft via 暂存离开 or published live via 发布, over the Playwright script transport"
 }

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

@@ -10,10 +10,11 @@ import {
 import {
     checkChannelSession,
     createShadowFinder,
+    kkBrowserLauncher,
     resolveChannelProfileDir,
     type ShadowCdpSession,
 } from '@gobing-ai/publish-harness/browser';
-import { type BrowserLauncher, openPersistentBrowser } from '@gobing-ai/ts-browser-automation';
+import type { BrowserLauncher } from '@gobing-ai/ts-browser-automation';
 import { createNodeFileSystem } from '@gobing-ai/ts-runtime';
 import { echoError } from '@gobing-ai/ts-utils';
 import { type AutomationGuard, createAutomationGuard } from './automation-guard';
@@ -93,15 +94,15 @@ export async function isXhsConsoleReady(page: XhsPage): Promise<boolean> {
 }
 
 /**
- * Production launcher: the upstream typed persistent-context opener (0177). Named so the
+ * Production launcher: the harness kk launcher (0214; full-Chromium channel + stealth). Named so the
  * migration is provable offline — tests assert this binding, never launch a real browser.
  */
-export const defaultLauncher = openPersistentBrowser;
+export const defaultLauncher = kkBrowserLauncher.launch;
 
 /**
  * Build the default page opener. The launcher is injected so the seam (page wrapping, shadow
  * probe wiring, context close, launch-failure message) is testable without launching a browser;
- * production uses the upstream typed `openPersistentBrowser` (@gobing-ai/ts-browser-automation).
+ * production uses the harness `kkBrowserLauncher` (@gobing-ai/publish-harness/browser, 0214).
  */
 export function makeDefaultOpenPage(
     launch: (options: { profileDir: string; headless: boolean }) => Promise<unknown> = defaultLauncher,
@@ -147,6 +148,8 @@ export interface SessionCheckOptions {
     profileDir: string;
     timeoutMs?: number;
     launcher?: BrowserLauncher;
+    /** 0216: skip the headless pass and probe headed only (manual `check --headed`). */
+    headedOnly?: boolean;
 }
 
 /**
@@ -173,6 +176,7 @@ export async function checkXhsProfileSession(opts: SessionCheckOptions): Promise
             profileDir: opts.profileDir,
             launcher: opts.launcher,
             timeoutMs: opts.timeoutMs ?? PREFLIGHT_TIMEOUT_MS,
+            headedOnly: opts.headedOnly === true,
         },
     );
 }

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

@@ -1,4 +1,5 @@
 import { trySelectors } from '@gobing-ai/publish-harness';
+import { waitUntil } from '@gobing-ai/publish-harness/browser';
 
 /**
  * The console's page seam (ADR-029) and the helpers every xhs operation shares.
@@ -10,6 +11,9 @@ import { trySelectors } from '@gobing-ai/publish-harness';
  */
 
 export const POLL_MS = 500;
+
+// The shared poll (0184 R2); re-exported so flow/index keep importing it from here.
+export { waitUntil };
 export const STEP_TIMEOUT_MS = 30_000;
 
 /** The console's mode tab bar; it mounts late and renders every tab several times over. */
@@ -120,23 +124,6 @@ export async function clickCreatorTab(
     }
 }
 
-/**
- * Poll `predicate` every `pollMs` until the deadline, then evaluate it one final time. The trailing
- * call matters: the condition often becomes true exactly at the boundary.
- */
-export async function waitUntil(
-    predicate: () => Promise<boolean>,
-    timeoutMs: number,
-    pollMs = POLL_MS,
-): Promise<boolean> {
-    const deadline = Date.now() + timeoutMs;
-    while (Date.now() < deadline) {
-        if (await predicate()) return true;
-        await new Promise((resolve) => setTimeout(resolve, pollMs));
-    }
-    return predicate();
-}
-
 export function wrapPlaywrightPage(raw: unknown, shadow?: ShadowProbe): XhsPage {
     const pw = raw as {
         goto(url: string, options?: Record<string, unknown>): Promise<unknown>;

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

@@ -6,7 +6,8 @@
  *  - `login` recovers an absent/expired session headed via the upstream
  *    `loginWithProfile`, polled with the same XHS-owned readiness gate the publish
  *    flow uses;
- *  - `check` reopens the existing profile headless and reports the session as
+ *  - `check` reopens the existing profile (headless by default; `--headed` skips the headless
+ *    pass and probes headed only, 0216) and reports the session as
  *    `verified` or `refused` — a site refusal, expired session, or missing profile
  *    is an explicit failed readiness, never a success. The upstream launcher never
  *    creates a profile headless, so a check cannot fabricate a session from a
@@ -21,7 +22,7 @@
  * the full recipe lives in docs/design/xhs-image-cards.md.
  */
 import { parseArgs } from 'node:util';
-import { resolveChannelProfileDir } from '@gobing-ai/publish-harness/browser';
+import { kkBrowserLauncher, resolveChannelProfileDir } from '@gobing-ai/publish-harness/browser';
 import { type BrowserLauncher, loginWithProfile } from '@gobing-ai/ts-browser-automation';
 import { echo, echoError } from '@gobing-ai/ts-utils';
 import { type AutomationGuard, createAutomationGuard } from './automation-guard';
@@ -60,11 +61,20 @@ export async function loginProfile(opts: ProfileLoginOptions): Promise<void> {
         url: PUBLISH_URL,
         isAuthenticated: (page) => isXhsConsoleReady(wrapPlaywrightPage(page)),
         timeoutMs: opts.timeoutMs ?? LOGIN_TIMEOUT_MS,
-        launcher: opts.launcher,
+        launcher: opts.launcher ?? kkBrowserLauncher,
     });
 }
 
-/** `login|check [--profile <dir>] [--timeout <ms>]`; profile precedence matches the publish flow. */
+/** Exit 2 with the human usage on stderr and the ADR-032 `error` verdict as the last stdout line. */
+function usageError(message: string): number {
+    echoError(
+        `profile-check: ${message} — usage: profile-check.ts [login|check] [--profile <dir>] [--timeout <ms>] [--headed]`,
+    );
+    echo(JSON.stringify({ status: 'error', detail: message }));
+    return 2;
+}
+
+/** `login|check [--profile <dir>] [--timeout <ms>] [--headed]`; profile precedence matches the publish flow. */
 export async function main(
     argv: string[] = process.argv.slice(2),
     launcher?: BrowserLauncher,
@@ -73,13 +83,19 @@ export async function main(
     let command: string;
     let profileDir: string;
     let timeoutMs: number | undefined;
+    let headed = false;
     try {
         const { positionals, values } = parseArgs({
             args: argv,
             allowPositionals: true,
-            options: { profile: { type: 'string' }, timeout: { type: 'string' } },
+            options: {
+                profile: { type: 'string' },
+                timeout: { type: 'string' },
+                headed: { type: 'boolean' },
+            },
         });
         command = positionals[0] ?? 'check';
+        headed = values.headed === true;
         if (values.timeout !== undefined) {
             timeoutMs = Number(values.timeout);
             if (!Number.isFinite(timeoutMs) || timeoutMs < 0) {
@@ -88,10 +104,7 @@ export async function main(
         }
         profileDir = resolveChannelProfileDir(CHANNEL, values.profile);
     } catch (error) {
-        echoError(
-            `profile-check: ${error instanceof Error ? error.message : String(error)} — usage: profile-check.ts [login|check] [--profile <dir>] [--timeout <ms>]`,
-        );
-        return 1;
+        return usageError(error instanceof Error ? error.message : String(error));
     }
     if (command === 'login') {
         try {
@@ -104,21 +117,21 @@ export async function main(
         }
     }
     if (command !== 'check') {
-        echoError(
-            `profile-check: unknown command '${command}' — usage: profile-check.ts [login|check] [--profile <dir>] [--timeout <ms>]`,
-        );
-        return 1;
+        return usageError(`unknown command '${command}'`);
     }
     // ADR-025: a manual session check is a real console visit, so it draws on the shared 2h
     // automation budget rather than a separate one. `login` is deliberately uncapped above: it is
     // operator-interactive, so capping it would only block recovery from an expired session.
     const cap = guard.allow('check');
     if (!cap.allowed) {
-        echoError(`profile-check: ${cap.reason}`);
+        // The budget refusal is still a readiness verdict (0216 contract): emit the JSON line so
+        // `kk plugin check` reports a refusal with the operator hint instead of a malformed probe.
+        echo(JSON.stringify({ status: 'refused', profileDir, detail: `xhs readiness refused: ${cap.reason}` }));
+        echoError(cap.reason);
         return 1;
     }
     guard.record('check');
-    const outcome = await checkXhsProfileSession({ profileDir, timeoutMs, launcher });
+    const outcome = await checkXhsProfileSession({ profileDir, timeoutMs, launcher, headedOnly: headed });
     echo(JSON.stringify(outcome));
     if (outcome.status !== 'verified') {
         echoError(outcome.detail);