@gobing-ai/knowledge-kit 0.0.32 → 0.0.34

package/plugins/publishings/juejin-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;
@@ -30114,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);
@@ -30126,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 {
@@ -30136,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) {
@@ -30162,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();
 }
@@ -30289,6 +30349,7 @@ var SELECTORS = {
 };
 var STEP_TIMEOUT_MS = 30000;
 var LOGIN_TIMEOUT_MS = 180000;
+var CHECK_TIMEOUT_MS = 60000;
 var AUTOSAVE_TIMEOUT_MS = 5000;
 var SAVE_KEY = process.platform === "darwin" ? "Meta+s" : "Control+s";
 var LOGIN_INSTRUCTION = "bun plugins/publishings/juejin-pub/src/profile-check.ts login";
@@ -30302,7 +30363,8 @@ var CONFIG = {
   channel: CHANNEL,
   homeUrl: EDITOR_URL,
   isAuthenticated,
-  loginTimeoutMs: LOGIN_TIMEOUT_MS
+  loginTimeoutMs: LOGIN_TIMEOUT_MS,
+  checkHeadedOnly: true
 };
 function fail(error51) {
   return ResultSchema.parse({ ok: false, target: TARGET, error: error51 });
@@ -30328,21 +30390,38 @@ function liveInputs(content) {
 async function readToast(page, texts) {
   return readScopedSignal(page, texts);
 }
+var JUEJIN_OPERATIONS = ["draft"];
+function resolveOperation(options, content) {
+  const raw = options?.operation ?? content?.metadata?.operation;
+  if (raw === undefined)
+    return { operation: "draft" };
+  if (typeof raw !== "string" || !JUEJIN_OPERATIONS.includes(raw)) {
+    return {
+      error: `unsupported operation '${String(raw)}' for juejin: expected one of ${JUEJIN_OPERATIONS.join(", ")}`
+    };
+  }
+  return { operation: raw };
+}
 
 class JuejinBrowserTransport {
   kind = "browser";
   driver;
   launcher;
   stepTimeoutMs;
+  checkTimeoutMs;
   constructor(driver = "script", deps = {}) {
     this.driver = driver;
-    this.launcher = deps.launcher;
+    this.launcher = deps.launcher ?? kkBrowserLauncher;
     this.stepTimeoutMs = deps.stepTimeoutMs ?? STEP_TIMEOUT_MS;
+    this.checkTimeoutMs = deps.checkTimeoutMs ?? CHECK_TIMEOUT_MS;
   }
   async publish(payload) {
     if (this.driver !== "script") {
       return fail(`unsupported driver '${this.driver}' for ${TARGET}`);
     }
+    const mode = resolveOperation(payload.options, payload.content);
+    if (mode.error !== undefined)
+      return fail(mode.error);
     const requested = payload.content.metadata?.publishStatus;
     if (requested !== undefined && requested !== "draft" && requested !== "public") {
       return fail(`unknown publishStatus '${String(requested)}' (expected absent, 'draft' or 'public')`);
@@ -30359,8 +30438,8 @@ class JuejinBrowserTransport {
     const session = await checkChannelSession(CONFIG, {
       profileDir,
       launcher: this.launcher,
-      headedFallback: false,
-      timeoutMs: this.stepTimeoutMs
+      headedOnly: true,
+      timeoutMs: this.checkTimeoutMs
     });
     if (session.status !== "verified") {
       return fail(`${CHANNEL} session preflight refused: ${session.detail} \u2014 run: ${LOGIN_INSTRUCTION}`);
@@ -30537,6 +30616,7 @@ if (import.meta.main) {
   process.exit(await main2());
 }
 export {
+  resolveOperation,
   processPublishIO,
   main2 as main,
   isAuthenticated,
@@ -30544,6 +30624,7 @@ export {
   SELECTORS,
   LOGIN_URL_RE,
   JuejinBrowserTransport,
+  JUEJIN_OPERATIONS,
   EDITOR_URL,
   CONFIG,
   CHANNEL

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

@@ -2,6 +2,7 @@
     "name": "juejin-pub",
     "kind": "publish",
     "entry": "./dist/index.js",
+    "check": "./src/profile-check.ts",
     "version": "1.0.0",
     "description": "Publish plugin for Juejin (juejin.cn): article drafts through the bytemd editor via script browser transport (ts-browser-automation)"
 }

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

@@ -13,6 +13,7 @@ import {
     checkChannelSession,
     expectOutcome,
     fillCodeMirror,
+    kkBrowserLauncher,
     readScopedSignal,
     resolveChannelProfileDir,
     resolveSelector,
@@ -53,6 +54,10 @@ export const SELECTORS = {
 
 const STEP_TIMEOUT_MS = 30_000;
 const LOGIN_TIMEOUT_MS = 180_000;
+/** Preflight budget (0192): the headless editor pass is non-deterministic — it verified in 2.9 s
+ * for the CLI check but the identical readiness predicate burned 30 s in the publish preflight —
+ * so the preflight runs headed only with the measured hydration headroom (mirrors infoq 0191). */
+const CHECK_TIMEOUT_MS = 60_000;
 /** Juejin autosaves the draft on input: the design's window before the one manual save key press. */
 const AUTOSAVE_TIMEOUT_MS = 5_000;
 const SAVE_KEY = process.platform === 'darwin' ? 'Meta+s' : 'Control+s';
@@ -78,6 +83,9 @@ export const CONFIG: ChannelBrowserConfig = {
     homeUrl: EDITOR_URL,
     isAuthenticated,
     loginTimeoutMs: LOGIN_TIMEOUT_MS,
+    // The headless editor readiness is flaky (verified 2.9 s once, burned 30 s the next pass), so
+    // the profile-check CLI checks headed only instead of betting on a headless editor load.
+    checkHeadedOnly: true,
 };
 
 /** Validated live-run inputs: the publish popup cannot confirm without both (R4). */
@@ -141,22 +149,51 @@ async function readToast(page: Page, texts: readonly string[]): Promise<string |
     return readScopedSignal(page, texts);
 }
 
+/**
+ * Declared modes (ADR-029 dispatch; task 0205 R2): Juejin's console flow is the CodeMirror markdown draft; publish tiers come from `publishStatus`, not modes. An unknown operation is refused by
+ * name before a profile is resolved or a browser opens.
+ */
+export const JUEJIN_OPERATIONS = ['draft'] as const;
+export type JuejinOperation = (typeof JUEJIN_OPERATIONS)[number];
+
+/** Exit-early resolution of the requested operation; a default Content without one resolves to `draft`. */
+export function resolveOperation(
+    options?: Record<string, unknown>,
+    content?: Content,
+): { operation: JuejinOperation; error?: undefined } | { operation?: undefined; error: string } {
+    const raw = options?.operation ?? content?.metadata?.operation;
+    if (raw === undefined) return { operation: 'draft' };
+    if (typeof raw !== 'string' || !(JUEJIN_OPERATIONS as readonly string[]).includes(raw)) {
+        return {
+            error: `unsupported operation '${String(raw)}' for juejin: expected one of ${JUEJIN_OPERATIONS.join(', ')}`,
+        };
+    }
+    return { operation: raw as JuejinOperation };
+}
+
 export class JuejinBrowserTransport implements PublishTransport {
     public readonly kind = 'browser';
     public readonly driver: BrowserDriver;
-    private readonly launcher?: BrowserLauncher;
+    private readonly launcher: BrowserLauncher;
     private readonly stepTimeoutMs: number;
+    private readonly checkTimeoutMs: number;
 
-    constructor(driver: BrowserDriver = 'script', deps: { launcher?: BrowserLauncher; stepTimeoutMs?: number } = {}) {
+    constructor(
+        driver: BrowserDriver = 'script',
+        deps: { launcher?: BrowserLauncher; stepTimeoutMs?: number; checkTimeoutMs?: number } = {},
+    ) {
         this.driver = driver;
-        this.launcher = deps.launcher;
+        this.launcher = deps.launcher ?? kkBrowserLauncher;
         this.stepTimeoutMs = deps.stepTimeoutMs ?? STEP_TIMEOUT_MS;
+        this.checkTimeoutMs = deps.checkTimeoutMs ?? CHECK_TIMEOUT_MS;
     }
 
     public async publish(payload: PublishTransportPayload): Promise<Result> {
         if (this.driver !== 'script') {
             return fail(`unsupported driver '${this.driver}' for ${TARGET}`);
         }
+        const mode = resolveOperation(payload.options, payload.content);
+        if (mode.error !== undefined) return fail(mode.error);
         const requested = payload.content.metadata?.publishStatus;
         if (requested !== undefined && requested !== 'draft' && requested !== 'public') {
             return fail(`unknown publishStatus '${String(requested)}' (expected absent, 'draft' or 'public')`);
@@ -171,13 +208,16 @@ export class JuejinBrowserTransport implements PublishTransport {
         const override = typeof payload.options?.profileDir === 'string' ? payload.options.profileDir : undefined;
         const profileDir = resolveChannelProfileDir(CHANNEL, override);
 
-        // ADR-025 preflight: an unauthenticated or absent profile must never produce a headed
-        // visit, so the read-only headless check runs first and a refusal stays a fast refusal.
+        // ADR-025 preflight: an unauthenticated or absent profile must never reach the editor
+        // flow, so the session check runs first and a refusal stays a fast refusal. Juejin's
+        // headless editor readiness is non-deterministic (0192: CLI check verified in 2.9 s, the
+        // same predicate refused after 30 s in this preflight), so — like infoq (0191) — the
+        // check runs headed only; a missing/expired profile still refuses before any flow.
         const session = await checkChannelSession(CONFIG, {
             profileDir,
             launcher: this.launcher,
-            headedFallback: false,
-            timeoutMs: this.stepTimeoutMs,
+            headedOnly: true,
+            timeoutMs: this.checkTimeoutMs,
         });
         if (session.status !== 'verified') {
             return fail(`${CHANNEL} session preflight refused: ${session.detail} — run: ${LOGIN_INSTRUCTION}`);
@@ -191,8 +231,8 @@ export class JuejinBrowserTransport implements PublishTransport {
                     profileDir,
                     url: EDITOR_URL,
                     isAuthenticated,
-                    // Headed by default (sites bot-wall headless loads); the headless preflight
-                    // above is the unattended pass, `options.headless === true` the opt-in.
+                    // Headed by default (sites bot-wall headless loads; the preflight above is headed-only
+                    // since 0192), `options.headless === true` the opt-in.
                     headless: payload.options?.headless === true,
                     launcher: this.launcher,
                     // The session is already preflight-verified, so the post-goto confirmation is

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

@@ -14642,7 +14642,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 = {
@@ -14653,7 +14653,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();
@@ -14676,13 +14676,13 @@ 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/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/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];
@@ -14700,7 +14700,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();
@@ -21698,7 +21698,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
 var configSchema;
 var init_config = __esm(() => {
   init_dist2();
@@ -21722,7 +21722,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) {
@@ -21896,11 +21896,12 @@ 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();
 

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

@@ -14642,7 +14642,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 = {
@@ -14653,7 +14653,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();
@@ -14676,13 +14676,13 @@ 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/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/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];
@@ -14700,7 +14700,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();
@@ -21698,7 +21698,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
 var configSchema;
 var init_config = __esm(() => {
   init_dist2();
@@ -21722,7 +21722,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) {
@@ -21898,11 +21898,12 @@ 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();