@gobing-ai/knowledge-kit 0.0.32 → 0.0.34

package/plugins/publishings/x-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();
@@ -29742,15 +29742,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("\\", "/");
 }
@@ -29808,7 +29809,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
@@ -29921,7 +29922,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);
@@ -29970,10 +29974,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;
@@ -29985,7 +29989,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;
@@ -30036,7 +30040,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;
@@ -30115,11 +30119,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);
@@ -30127,7 +30187,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 {
@@ -30137,12 +30197,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) {
@@ -30163,7 +30223,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();
 }
@@ -30275,9 +30335,13 @@ function oauth1Header(opts) {
   const header = Object.keys(params).sort().map((key) => `${percentEncode(key)}="${percentEncode(params[key] ?? "")}"`).join(", ");
   return `OAuth ${header}`;
 }
+var X_OPERATIONS = ["post", "article"];
 function resolveOperation(options, content) {
   const raw = options?.operation ?? content?.metadata?.operation ?? "post";
-  return raw === "article" ? "article" : "post";
+  if (typeof raw !== "string" || !X_OPERATIONS.includes(raw)) {
+    return { error: `unsupported operation '${String(raw)}' for x: expected one of ${X_OPERATIONS.join(", ")}` };
+  }
+  return { operation: raw };
 }
 
 class XPostApiTransport {
@@ -30361,7 +30425,8 @@ var ARTICLE_CONFIG = {
   channel: ARTICLE_CHANNEL,
   homeUrl: X_ARTICLES_URL,
   isAuthenticated: isArticleAuthenticated,
-  loginTimeoutMs: LOGIN_TIMEOUT_MS
+  loginTimeoutMs: LOGIN_TIMEOUT_MS,
+  checkHeadedOnly: true
 };
 function errorMessage3(error51) {
   return error51 instanceof Error ? error51.message : String(error51);
@@ -30395,7 +30460,7 @@ class XArticleBrowserTransport {
   stepTimeoutMs;
   constructor(driver = "script", deps = {}) {
     this.driver = driver;
-    this.launcher = deps.launcher;
+    this.launcher = deps.launcher ?? kkBrowserLauncher;
     this.stepTimeoutMs = deps.stepTimeoutMs ?? STEP_TIMEOUT_MS;
   }
   async publish(payload) {
@@ -30442,7 +30507,11 @@ class XArticleBrowserTransport {
       label: "write control"
     });
     await page.locator(writeSelector).first().click();
-    const titleSelector = await resolveSelector(page, ARTICLE_SELECTORS.title, {
+    const titleInput = ARTICLE_SELECTORS.title[0];
+    if (await page.locator(titleInput).first().count() === 0) {
+      await page.locator(ARTICLE_SELECTORS.title[1]).first().click({ timeout: this.stepTimeoutMs });
+    }
+    const titleSelector = await resolveSelector(page, [titleInput], {
       timeoutMs: this.stepTimeoutMs,
       label: "title input"
     });
@@ -30453,15 +30522,15 @@ class XArticleBrowserTransport {
     });
     await pasteHtml(page, bodySelector, markdownToHtml(content.body), { timeoutMs: this.stepTimeoutMs });
     if (coverPath !== undefined) {
-      const addPhotos = await trySelectors(page, ARTICLE_SELECTORS.addPhotos, { visible: false });
-      if (addPhotos.found && addPhotos.selector !== null) {
-        await page.locator(addPhotos.selector).first().click();
-      }
       const fileInputSelector = await resolveSelector(page, ARTICLE_SELECTORS.fileInput, {
         timeoutMs: this.stepTimeoutMs,
         label: "cover file input"
       });
       await uploadFile(page, fileInputSelector, coverPath, { timeoutMs: this.stepTimeoutMs });
+      await page.locator('[role="dialog"] button:has-text("Apply") >> visible=true').first().click({ timeout: this.stepTimeoutMs });
+      const attached = await expectOutcome(async () => await page.evaluate(coverAttachedScript()) === true ? "cover image rendered in composer" : null, { timeoutMs: this.stepTimeoutMs, label: "cover attachment" });
+      if (!attached.ok)
+        return fail(attached.error);
     }
     const draft = await expectOutcome(() => probeDraft(page), {
       timeoutMs: this.stepTimeoutMs,
@@ -30505,6 +30574,9 @@ async function probeDraft(page) {
   const url2 = page.url();
   return ARTICLE_EDIT_RE.test(url2) ? url2 : null;
 }
+function coverAttachedScript() {
+  return `[...document.querySelectorAll('img[src*="twimg"]')].some((img) => !/profile_images/.test(img.src ?? ''))`;
+}
 async function probeLive(page) {
   const url2 = page.url();
   return !ARTICLE_EDIT_RE.test(url2) && LIVE_URL_ID_RE.test(url2) ? url2 : null;
@@ -30536,7 +30608,12 @@ async function processPublishIO(inputPath, outputPath, transport) {
     await writePublishResult(outputPath, fail(message));
     throw new Error(message);
   }
-  const operation = resolveOperation(options, content);
+  const mode = resolveOperation(options, content);
+  if (mode.error !== undefined) {
+    await writePublishResult(outputPath, fail(mode.error));
+    throw new Error(mode.error);
+  }
+  const operation = mode.operation;
   const resolved = transport ?? getPublishTransport(operation);
   const result = ResultSchema.parse(await resolved.publish({ content, options }));
   await writePublishResult(outputPath, result);
@@ -30567,11 +30644,13 @@ if (import.meta.main) {
   process.exit(await main2());
 }
 export {
+  resolveOperation,
   processPublishIO,
   oauth1Header,
   main2 as main,
   isArticleAuthenticated,
   getPublishTransport,
+  X_OPERATIONS,
   X_ARTICLES_URL,
   XPostApiTransport,
   XArticleBrowserTransport,

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

@@ -2,6 +2,7 @@
     "name": "x-pub",
     "kind": "publish",
     "entry": "./dist/index.js",
+    "check": "./src/profile-check.ts",
     "version": "1.0.0",
     "description": "post via official tweets API; article via script browser transport (ts-browser-automation)"
 }

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

@@ -14,6 +14,7 @@ import {
     type ChannelBrowserConfig,
     checkChannelSession,
     expectOutcome,
+    kkBrowserLauncher,
     markdownToHtml,
     pasteHtml,
     resolveChannelProfileDir,
@@ -81,9 +82,23 @@ export function oauth1Header(opts: {
     return `OAuth ${header}`;
 }
 
-function resolveOperation(options?: Record<string, unknown>, content?: Content): 'post' | 'article' {
+/**
+ * Declared modes (ADR-029 dispatch): `post` (API v2 transport) and `article` (browser composer).
+ * An unknown operation is refused by name before any transport — and therefore before any
+ * browser — is resolved (task 0205 R2).
+ */
+export const X_OPERATIONS = ['post', 'article'] as const;
+export type XOperation = (typeof X_OPERATIONS)[number];
+
+export function resolveOperation(
+    options?: Record<string, unknown>,
+    content?: Content,
+): { operation: XOperation; error?: undefined } | { operation?: undefined; error: string } {
     const raw = options?.operation ?? content?.metadata?.operation ?? 'post';
-    return raw === 'article' ? 'article' : 'post';
+    if (typeof raw !== 'string' || !(X_OPERATIONS as readonly string[]).includes(raw)) {
+        return { error: `unsupported operation '${String(raw)}' for x: expected one of ${X_OPERATIONS.join(', ')}` };
+    }
+    return { operation: raw as XOperation };
 }
 
 export class XPostApiTransport implements PublishTransport {
@@ -156,8 +171,14 @@ export const LOGIN_URL_RE = /(\/i\/flow\/login|\/login)/;
 
 /**
  * Selectors seeded from the wt script (`x-article-playwright.ts:143-187`); each list is tried in
- * order and the operator dogfood (0194) re-measures them. The seed's `tweetButton`/`Tweet`
- * candidates are dropped: they belong to the tweet composer, and clicking one would post a tweet.
+ * order. Measured live 2026-10-07 (0194): `write` candidate 1 and body candidate 1 hit; the title
+ * is a two-step interaction — the `twitter-article-title` div is a collapsed display that mounts
+ * the real `textarea[placeholder="Add a title"]` on click (handled in `runArticleFlow`); the
+ * paste into the Draft.js container and the `/compose/articles/edit/<id>` signal were both
+ * verified. `addPhotos` (`button[aria-label*="Add photos" i]`, "Add photos or video") is present
+ * but is NOT clicked in the flow: opening the picker detaches the fileInput's handler and swallows
+ * the set file (see the cover leg in `runArticleFlow`). The seed's `tweetButton`/`Tweet` candidates are dropped: they belong to the tweet
+ * composer, and clicking one would post a tweet.
  */
 export const ARTICLE_SELECTORS = {
     write: ['[data-testid="empty_state_button_text"]', 'button:has-text("Write")', '[aria-label*="Write" i]'],
@@ -193,6 +214,11 @@ export const ARTICLE_CONFIG: ChannelBrowserConfig = {
     homeUrl: X_ARTICLES_URL,
     isAuthenticated: isArticleAuthenticated,
     loginTimeoutMs: LOGIN_TIMEOUT_MS,
+    // X login-walls headless article loads (measured 0216: the headless pass refuses even on a live
+    // profile), so the default headless-first + headed-fallback spends two deadlines per check and
+    // blows kk's 30s probe-kill (spawn SIGTERM → error instead of refused). One headed pass, like
+    // infoq's WAF, keeps the probe inside the budget.
+    checkHeadedOnly: true,
 };
 
 function errorMessage(error: unknown): string {
@@ -234,12 +260,12 @@ async function resolveCover(
 export class XArticleBrowserTransport implements PublishTransport {
     public readonly kind = 'browser';
     public readonly driver: BrowserDriver;
-    private readonly launcher?: BrowserLauncher;
+    private readonly launcher: BrowserLauncher;
     private readonly stepTimeoutMs: number;
 
     constructor(driver: BrowserDriver = 'script', deps: { launcher?: BrowserLauncher; stepTimeoutMs?: number } = {}) {
         this.driver = driver;
-        this.launcher = deps.launcher;
+        this.launcher = deps.launcher ?? kkBrowserLauncher;
         this.stepTimeoutMs = deps.stepTimeoutMs ?? STEP_TIMEOUT_MS;
     }
 
@@ -315,7 +341,15 @@ export class XArticleBrowserTransport implements PublishTransport {
         });
         await page.locator(writeSelector).first().click();
 
-        const titleSelector = await resolveSelector(page, ARTICLE_SELECTORS.title, {
+        // X collapses the title into a display div (`[data-testid="twitter-article-title"]`, text
+        // `(Needs title)`); the real `textarea[placeholder="Add a title"]` is only mounted after
+        // that div is clicked (measured live 2026-10-07, 0194). So: fill the textarea when it is
+        // already attached, otherwise click the display div and fill the textarea it mounts.
+        const titleInput = ARTICLE_SELECTORS.title[0];
+        if ((await page.locator(titleInput).first().count()) === 0) {
+            await page.locator(ARTICLE_SELECTORS.title[1]).first().click({ timeout: this.stepTimeoutMs });
+        }
+        const titleSelector = await resolveSelector(page, [titleInput], {
             timeoutMs: this.stepTimeoutMs,
             label: 'title input',
         });
@@ -333,17 +367,27 @@ export class XArticleBrowserTransport implements PublishTransport {
         await pasteHtml(page, bodySelector, markdownToHtml(content.body), { timeoutMs: this.stepTimeoutMs });
 
         if (coverPath !== undefined) {
-            // The photo picker is opened by a control when the composer renders it; the file input
-            // itself is routinely hidden behind it, so it is found by attachment (R2).
-            const addPhotos = await trySelectors(page, ARTICLE_SELECTORS.addPhotos, { visible: false });
-            if (addPhotos.found && addPhotos.selector !== null) {
-                await page.locator(addPhotos.selector).first().click();
-            }
+            // The base `fileInput` handles a set file directly: X itself opens an "Edit media" crop
+            // dialog, and the cover attaches only when that dialog is confirmed with Apply.
+            // Clicking the add-photos picker first detaches that handler — a file set while the
+            // picker is open uploads nothing (measured live 2026-10-07, 0194). So: set the file,
+            // click Apply, and require the cover image to render (E91-D6: observed outcome only).
             const fileInputSelector = await resolveSelector(page, ARTICLE_SELECTORS.fileInput, {
                 timeoutMs: this.stepTimeoutMs,
                 label: 'cover file input',
             });
             await uploadFile(page, fileInputSelector, coverPath, { timeoutMs: this.stepTimeoutMs });
+            // The crop dialog renders two identical "Edit media" layers; click the visible Apply.
+            await page
+                .locator('[role="dialog"] button:has-text("Apply") >> visible=true')
+                .first()
+                .click({ timeout: this.stepTimeoutMs });
+            const attached = await expectOutcome(
+                async () =>
+                    (await page.evaluate(coverAttachedScript())) === true ? 'cover image rendered in composer' : null,
+                { timeoutMs: this.stepTimeoutMs, label: 'cover attachment' },
+            );
+            if (!attached.ok) return fail(attached.error);
         }
 
         const draft = await expectOutcome(() => probeDraft(page), {
@@ -393,6 +437,11 @@ async function probeDraft(page: Page): Promise<string | null> {
     return ARTICLE_EDIT_RE.test(url) ? url : null;
 }
 
+/** DOM probe script: true once a non-avatar twimg image — the just-attached cover — is rendered. */
+function coverAttachedScript(): string {
+    return `[...document.querySelectorAll('img[src*="twimg"]')].some((img) => !/profile_images/.test(img.src ?? ''))`;
+}
+
 /** Live evidence is URL-only too: a published article URL that left the `/edit/` composer. */
 async function probeLive(page: Page): Promise<string | null> {
     const url = page.url();
@@ -431,7 +480,12 @@ export async function processPublishIO(
         await writePublishResult(outputPath, fail(message));
         throw new Error(message);
     }
-    const operation = resolveOperation(options, content);
+    const mode = resolveOperation(options, content);
+    if (mode.error !== undefined) {
+        await writePublishResult(outputPath, fail(mode.error));
+        throw new Error(mode.error);
+    }
+    const operation = mode.operation;
     const resolved = transport ?? getPublishTransport(operation);
     const result = ResultSchema.parse(await resolved.publish({ content, options }));
     await writePublishResult(outputPath, result);