@gobing-ai/knowledge-kit 0.0.32 → 0.0.34

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.21/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.21/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.21/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.21/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.21/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.21/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.21/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.21/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.21+44edd5c4d6372504/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.21+44edd5c4d6372504/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.21+44edd5c4d6372504/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.21+44edd5c4d6372504/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.21+44edd5c4d6372504/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.21+44edd5c4d6372504/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.21+44edd5c4d6372504/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.21+44edd5c4d6372504/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.21+44edd5c4d6372504/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.21+b6949ba92ac553f0/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.21+b6949ba92ac553f0/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.21+b6949ba92ac553f0/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.21+b6949ba92ac553f0/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.21+b6949ba92ac553f0/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,16 +30941,16 @@ 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)`);
+  throw new Error(`podcast modal: the \u53D1\u64AD\u5BA2 modal was still open ${deps.stepTimeoutMs}ms after the audio and cover were attached; its post-attach save path has never been measured (task 0236 R3 \u2014 the attended walk is still pending) and the only recorded advance control is '${PODCAST_MODAL_ADVANCE[0]}', which a draft run does not click (it is publish-adjacent)`);
 }
 async function composePodcast(input, deps) {
   await enterMode(deps, input.operation);
@@ -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;
@@ -31027,6 +31072,38 @@ var AUTH_GATE = ["div.creator-tab", "text=\u4E0A\u4F20\u56FE\u6587"];
 function fail2(error51) {
   return ResultSchema.parse({ ok: false, target: TARGET, error: error51 });
 }
+async function planVisit(primary, content) {
+  const raw = content.metadata?.followUps;
+  if (raw === undefined)
+    return { plan: { primary, followUps: [] } };
+  if (!Array.isArray(raw)) {
+    return {
+      error: `followUps validation: Content.metadata.followUps must be an array of Content objects, got ${typeof raw}`
+    };
+  }
+  const followUps = [];
+  for (const [index, entry] of raw.entries()) {
+    const label = `followUps[${index}]`;
+    const parsed = ContentSchema.safeParse(entry);
+    if (!parsed.success) {
+      followUps.push({ operation: label, error: `${label} is not a Content object` });
+      continue;
+    }
+    const operation = typeof parsed.data.metadata?.operation === "string" ? parsed.data.metadata.operation : label;
+    const requested = resolveXhsOperation(undefined, parsed.data);
+    if (requested.error !== undefined) {
+      followUps.push({ operation, error: requested.error });
+      continue;
+    }
+    const validation = await validateModeInput(requested.operation, parsed.data);
+    if (validation.error !== undefined) {
+      followUps.push({ operation, error: validation.error });
+      continue;
+    }
+    followUps.push({ content: parsed.data, operation: requested.operation, input: validation.input });
+  }
+  return { plan: { primary, followUps } };
+}
 async function createShadowProbe(context2, page) {
   const find = await createShadowFinder(context2, page);
   return find === undefined ? undefined : { findControl: (labels) => find(labels) };
@@ -31034,7 +31111,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 +31140,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
   });
 }
 
@@ -31099,9 +31177,12 @@ class XhsBrowserTransport {
     if (validation.error !== undefined)
       return fail2(validation.error);
     const input = validation.input;
+    const visited = await planVisit({ content: payload.content, input }, payload.content);
+    if (visited.error !== undefined)
+      return fail2(visited.error);
+    const visit2 = visited.plan;
     const override = typeof payload.options?.profileDir === "string" ? payload.options.profileDir : undefined;
     const profileDir = resolveChannelProfileDir(CHANNEL, override);
-    const publishStatus = payload.content.metadata?.publishStatus === "public" ? "public" : "draft";
     const cap = this.automation.allow("publish");
     if (!cap.allowed)
       return fail2(`automation cap: ${cap.reason}`);
@@ -31117,6 +31198,21 @@ class XhsBrowserTransport {
       return fail2(error51 instanceof Error ? error51.message : String(error51));
     }
     const { page, close } = opened;
+    try {
+      const primary = await this.runStep(visit2.primary.input, visit2.primary.content, page, profileDir);
+      if (!primary.ok || visit2.followUps.length === 0)
+        return primary;
+      const followUps = [];
+      for (const followUp of visit2.followUps) {
+        const step = "error" in followUp ? fail2(`follow-up (${followUp.operation}): ${followUp.error}`) : await this.runStep(followUp.input, followUp.content, page, profileDir);
+        followUps.push(ResultSchema.parse({ ...step, metadata: { operation: followUp.operation, ...step.metadata } }));
+      }
+      return ResultSchema.parse({ ...primary, metadata: { ...primary.metadata, followUps } });
+    } finally {
+      await close();
+    }
+  }
+  async runStep(input, content, page, profileDir) {
     const act = async (what, fn) => {
       try {
         return await fn();
@@ -31126,14 +31222,15 @@ 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}`);
       }
+      const publishStatus = content.metadata?.publishStatus === "public" ? "public" : "draft";
       const draftBaseline = publishStatus === "draft" ? await readDraftBaseline(page) : { count: null, stamps: [] };
       return await runMode(input, {
         page,
-        content: payload.content,
+        content,
         publishStatus,
         profileDir,
         driver: this.driver,
@@ -31144,8 +31241,6 @@ class XhsBrowserTransport {
       });
     } catch (error51) {
       return fail2(error51 instanceof Error ? error51.message : String(error51));
-    } finally {
-      await close();
     }
   }
 }

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/flow.ts

@@ -403,8 +403,14 @@ async function isPodcastModalOpen(page: XhsPage): Promise<boolean> {
 
 /**
  * Leave the 发播客 modal. The recorded advance control is `去发布`, which is publish-adjacent, so a
- * draft run never clicks it: it waits for the platform to move on by itself and fails loud naming
- * the control it refused to click. Only an explicit `publishStatus: 'public'` may click it.
+draft run never clicks it: it waits for the platform to move on by itself and fails loud naming the
+control it refused to click. Only an explicit `publishStatus: 'public'` may click it.
+ *
+ * 0236 R3 (deferred, operator decision 2026-10-09): whether the modal offers a save path OTHER than
+ * `去发布` once both files are attached was never measured (`.spur/run/discovery/` holds only the
+ * modal open), and an attended walk under ADR-025 is what would measure it. So no draft-save selector
+ * is invented here: the run stops before the publish-adjacent control and says so, which is the
+ * failure the 0236 result carries (a `ok:false` entry that never fails the visit).
  */
 async function leavePodcastModal(deps: ModeRunDeps): Promise<void> {
     const closed = () => isPodcastModalOpen(deps.page).then((open) => !open);
@@ -420,7 +426,7 @@ async function leavePodcastModal(deps: ModeRunDeps): Promise<void> {
         if (await waitUntil(closed, deps.stepTimeoutMs)) return;
     }
     throw new Error(
-        `podcast modal: the 发播客 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)`,
+        `podcast modal: the 发播客 modal was still open ${deps.stepTimeoutMs}ms after the audio and cover were attached; its post-attach save path has never been measured (task 0236 R3 — the attended walk is still pending) and the only recorded advance control is '${PODCAST_MODAL_ADVANCE[0]}', which a draft run does not click (it is publish-adjacent)`,
     );
 }