@gobing-ai/knowledge-kit 0.0.32 → 0.0.33

package/plugins/publishings/wechatmp-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();
@@ -29740,15 +29740,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("\\", "/");
 }
@@ -29806,7 +29807,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
@@ -29919,7 +29920,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);
@@ -29954,10 +29958,10 @@ class PlaywrightUnavailableError extends BrowserAutomationError {
     this.name = "PlaywrightUnavailableError";
   }
 }
-// ../../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;
@@ -29969,7 +29973,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;
@@ -30020,7 +30024,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 defaultLauncher;
 function getDefaultLauncher() {
   if (defaultLauncher === undefined)
@@ -30033,17 +30037,73 @@ async function openPersistentBrowser(options) {
     headless: options.headless
   });
 }
+// ../../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_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();
 async function waitUntil(predicate, timeoutMs, pollMs = DEFAULT_POLL_MS) {
   const deadline = Date.now() + timeoutMs;
   while (Date.now() < deadline) {
     if (await predicate()) {
       return true;
     }
-    await new Promise((resolve2) => setTimeout(resolve2, pollMs));
+    await new Promise((resolve3) => setTimeout(resolve3, pollMs));
   }
   return predicate();
 }
@@ -30121,6 +30181,9 @@ async function resolveSelector(page, selectors, opts = {}) {
   }
   return selector;
 }
+function errorMessage2(error51) {
+  return error51 instanceof Error ? error51.message : String(error51);
+}
 function pasteScript(selector, html) {
   const text = html.replace(/<[^>]*>/g, " ").replace(/\s+/g, " ").trim();
   return `(() => {
@@ -30736,7 +30799,7 @@ function fail(error51) {
   return ResultSchema.parse({ ok: false, target: TARGET, error: error51 });
 }
 function sleep(ms) {
-  return new Promise((resolve2) => setTimeout(resolve2, ms));
+  return new Promise((resolve3) => setTimeout(resolve3, ms));
 }
 function titleOf(content) {
   return (content.title ?? "").trim();
@@ -31218,22 +31281,42 @@ function isWechatLoggedIn(page) {
 function storageStatePath(profileDir) {
   return `${profileDir}/storage-state.json`;
 }
-async function checkWechatSession(profileDir) {
-  const { page, context: context2 } = await openWithState(profileDir, true);
+async function checkWechatSession(profileDir, opts = {}) {
+  const { page, context: context2 } = await openWithState(profileDir, opts.headless ?? true);
   try {
-    await pollLogin(page);
+    await pollLogin(page, opts.timeoutMs);
   } finally {
     await context2.close();
   }
 }
-async function pollLogin(page) {
-  const ready = await waitUntil(() => Promise.resolve(isConsoleReady(page)), CONSOLE_READY_TIMEOUT_MS, 1000);
+async function pollLogin(page, timeoutMs) {
+  const deadline = timeoutMs ?? CONSOLE_READY_TIMEOUT_MS;
+  const ready = await waitUntil(() => Promise.resolve(isConsoleReady(page)), deadline, 1000);
   if (ready)
     return;
-  throw new Error(`Authentication was not confirmed within ${CONSOLE_READY_TIMEOUT_MS}ms \u2014 the saved session state has ` + "likely expired: re-run `bun src/profile-check.ts login` to sign in again.");
+  throw new Error(`Authentication was not confirmed within ${deadline}ms \u2014 the saved session state has ` + "likely expired: re-run `bun src/profile-check.ts login` to sign in again.");
+}
+async function openWechatLogin(opts) {
+  const timeoutMs = opts.timeoutMs ?? 180000;
+  const context2 = await openPersistentBrowser({
+    profileDir: opts.profileDir,
+    headless: false,
+    launcher: kkBrowserLauncher
+  });
+  try {
+    const page = context2.pages()[0] ?? await context2.newPage();
+    await page.goto(CONSOLE_URL);
+    const ready = await waitUntil(() => Promise.resolve(page.url().includes(CONSOLE_HOME_FRAGMENT)), timeoutMs, 1000);
+    if (!ready)
+      throw new Error(`QR scan not completed within ${timeoutMs / 1000}s`);
+    await page.waitForTimeout(1e4);
+    await context2.storageState({ path: storageStatePath(opts.profileDir) });
+  } finally {
+    await context2.close();
+  }
 }
 async function openWithState(profileDir, headless) {
-  const context2 = await openPersistentBrowser({ profileDir, headless });
+  const context2 = await openPersistentBrowser({ profileDir, headless, launcher: kkBrowserLauncher });
   try {
     const stateFile = storageStatePath(profileDir);
     let state;
@@ -31390,6 +31473,7 @@ export {
   storageStatePath,
   runMode,
   processPublishIO,
+  openWechatLogin,
   markdownToWechatHtml,
   main2 as main,
   isWechatLoggedIn,

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

@@ -2,6 +2,7 @@
     "name": "wechatmp-pub",
     "kind": "publish",
     "entry": "./dist/index.js",
+    "check": "./src/profile-check.ts",
     "version": "1.0.0",
     "description": "Publish plugin for the WeChat MP console via ts-browser-automation: draft-box first (ADR-022), headed publish behind a session preflight"
 }

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

@@ -6,7 +6,7 @@ import {
     type PublishTransportPayload,
     resolveBrowserProfileDir,
 } from '@gobing-ai/publish-harness';
-import { waitUntil } from '@gobing-ai/publish-harness/browser';
+import { kkBrowserLauncher, waitUntil } from '@gobing-ai/publish-harness/browser';
 import { BrowserProfileMissingError, openPersistentBrowser } from '@gobing-ai/ts-browser-automation';
 import { createNodeFileSystem } from '@gobing-ai/ts-runtime';
 import { echoError } from '@gobing-ai/ts-utils';
@@ -74,28 +74,61 @@ export function storageStatePath(profileDir: string): string {
     return `${profileDir}/storage-state.json`;
 }
 
-/** Headless session preflight: throws (incl. BrowserProfileMissingError) when the profile cannot drive the console. */
-export async function checkWechatSession(profileDir: string): Promise<void> {
-    const { page, context } = await openWithState(profileDir, true);
+/** Headless session preflight: throws (incl. BrowserProfileMissingError) when the profile cannot drive the console.
+ * 0216: `headless: false` probes headed only and `timeoutMs` overrides the ready deadline. */
+export async function checkWechatSession(
+    profileDir: string,
+    opts: { headless?: boolean; timeoutMs?: number } = {},
+): Promise<void> {
+    const { page, context } = await openWithState(profileDir, opts.headless ?? true);
     try {
-        await pollLogin(page);
+        await pollLogin(page, opts.timeoutMs);
     } finally {
         await context.close();
     }
 }
 
-async function pollLogin(page: Page): Promise<void> {
-    const ready = await waitUntil(() => Promise.resolve(isConsoleReady(page)), CONSOLE_READY_TIMEOUT_MS, 1000);
+async function pollLogin(page: Page, timeoutMs?: number): Promise<void> {
+    const deadline = timeoutMs ?? CONSOLE_READY_TIMEOUT_MS;
+    const ready = await waitUntil(() => Promise.resolve(isConsoleReady(page)), deadline, 1000);
     if (ready) return;
     throw new Error(
-        `Authentication was not confirmed within ${CONSOLE_READY_TIMEOUT_MS}ms — the saved session state has ` +
+        `Authentication was not confirmed within ${deadline}ms — the saved session state has ` +
             'likely expired: re-run `bun src/profile-check.ts login` to sign in again.',
     );
 }
 
+/** Headed one-time login: open the console, wait for the QR scan to land on `/cgi-bin/home`, let
+ *  the console finish its post-auth Set-Cookies, then capture the durable storageState file —
+ *  mp.weixin.qq.com grant cookies do not survive a Chromium restart, so the saved state (not the
+ *  profile cookie store) is the session artifact the publish flow re-injects. Shared by the CLI
+ *  (`profile-check login`, 0216) so the publish flow and the probe use one login path. */
+export async function openWechatLogin(opts: { profileDir: string; timeoutMs?: number }): Promise<void> {
+    const timeoutMs = opts.timeoutMs ?? 180_000;
+    const context = await openPersistentBrowser({
+        profileDir: opts.profileDir,
+        headless: false,
+        launcher: kkBrowserLauncher,
+    });
+    try {
+        const page = context.pages()[0] ?? (await context.newPage());
+        await page.goto(CONSOLE_URL);
+        const ready = await waitUntil(
+            () => Promise.resolve(page.url().includes(CONSOLE_HOME_FRAGMENT)),
+            timeoutMs,
+            1000,
+        );
+        if (!ready) throw new Error(`QR scan not completed within ${timeoutMs / 1000}s`);
+        await page.waitForTimeout(10_000); // settle: let the console finish its post-auth Set-Cookies
+        await context.storageState({ path: storageStatePath(opts.profileDir) });
+    } finally {
+        await context.close();
+    }
+}
+
 /** Launch, inject the saved login cookies, and land on the console. Caller owns closing the context. */
 async function openWithState(profileDir: string, headless: boolean): Promise<{ page: Page; context: BrowserContext }> {
-    const context = await openPersistentBrowser({ profileDir, headless });
+    const context = await openPersistentBrowser({ profileDir, headless, launcher: kkBrowserLauncher });
     try {
         const stateFile = storageStatePath(profileDir);
         let state:

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

@@ -1,48 +1,92 @@
-import { resolveBrowserProfileDir } from '@gobing-ai/publish-harness';
-import { waitUntil } from '@gobing-ai/publish-harness/browser';
-import { openPersistentBrowser } from '@gobing-ai/ts-browser-automation';
-import { echo } from '@gobing-ai/ts-utils';
-import { checkWechatSession, storageStatePath } from './index';
+/**
+ * WeChat MP profile-session capability (0216, ADR-032 probe contract).
+ *
+ * `login` opens the console headed and resolves once the QR scan lands on `/cgi-bin/home`, then
+ * captures the durable `storageState` file — mp.weixin.qq.com grant cookies do not survive a
+ * Chromium restart, so the saved state (not the profile cookie store) is the session artifact.
+ * `check` reopens the profile with that state re-injected and reports `verified` or `refused`
+ * as the LAST line on stdout, one JSON object — `kk plugin check` parses it. Exit codes:
+ * 0 verified, 1 refused, 2 usage error. No cookie, token or storageState value is ever printed;
+ * the profile directory is the only detail that leaves the process.
+ */
+import { parseArgs } from 'node:util';
+import { resolveChannelProfileDir } from '@gobing-ai/publish-harness/browser';
+import { echo, echoError } from '@gobing-ai/ts-utils';
+import { CHANNEL, checkWechatSession, openWechatLogin } from './index';
 
-const CONSOLE_URL = 'https://mp.weixin.qq.com/';
+const USAGE = 'usage: wechatmp profile-check [login|check] [--profile <dir>] [--timeout <ms>] [--headed]';
 const LOGIN_TIMEOUT_MS = 180_000;
-const LOGGED_IN_FRAGMENT = '/cgi-bin/home';
 
-const profileDir = resolveBrowserProfileDir('wechatmp', process.env.WECHATMP_PROFILE_DIR);
-const verb = process.argv[2] ?? 'check';
+interface WechatVerdict {
+    status: 'verified' | 'refused';
+    profileDir: string;
+    detail: string;
+}
+
+export async function main(argv: string[] = process.argv.slice(2)): Promise<number> {
+    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' },
+                headed: { type: 'boolean' },
+            },
+        });
+        command = positionals[0] ?? 'check';
+        if (command !== 'login' && command !== 'check') {
+            throw new Error(`unknown command '${command}'`);
+        }
+        headed = values.headed === true;
+        if (values.timeout !== undefined) {
+            timeoutMs = Number(values.timeout);
+            if (!Number.isFinite(timeoutMs) || timeoutMs < 0) {
+                throw new Error(`--timeout must be a non-negative number of ms, got '${values.timeout}'`);
+            }
+        }
+        profileDir = resolveChannelProfileDir(CHANNEL, values.profile);
+    } catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        echoError(`wechatmp profile-check: ${message} — ${USAGE}`);
+        echo(JSON.stringify({ status: 'error', detail: message }));
+        return 2;
+    }
 
-try {
-    if (verb === 'login') {
-        echo(
-            `wechatmp login: opening the console in a headed browser — scan the QR once (timeout ${LOGIN_TIMEOUT_MS / 1000}s)`,
-        );
-        const context = await openPersistentBrowser({ profileDir, headless: false });
+    if (command === 'login') {
         try {
-            const page = context.pages()[0] ?? (await context.newPage());
-            await page.goto(CONSOLE_URL);
-            const ready = await waitUntil(
-                () => Promise.resolve(page.url().includes(LOGGED_IN_FRAGMENT)),
-                LOGIN_TIMEOUT_MS,
-                1000,
-            );
-            if (!ready) throw new Error(`QR scan not completed within ${LOGIN_TIMEOUT_MS / 1000}s`);
-            await page.waitForTimeout(10_000); // settle: let the console finish its post-auth Set-Cookies
-            // The Chromium profile store drops the grant cookies on restart even though they carry
-            // multi-day expiries — the durable session artifact is the captured storageState file,
-            // which the publish flow re-injects into every launch.
-            await context.storageState({ path: storageStatePath(profileDir) });
-            echo(`wechatmp login: session saved in ${storageStatePath(profileDir)}`);
-        } finally {
-            await context.close();
+            await openWechatLogin({ profileDir, timeoutMs: timeoutMs ?? LOGIN_TIMEOUT_MS });
+            echo(`wechatmp profile login verified: ${profileDir}`);
+            return 0;
+        } catch (error) {
+            echoError(`wechatmp profile login failed: ${error instanceof Error ? error.message : String(error)}`);
+            return 1;
         }
-    } else if (verb === 'check') {
-        await checkWechatSession(profileDir);
-        echo(`wechatmp session: OK (${profileDir})`);
-    } else {
-        echo('usage: bun src/profile-check.ts login|check');
-        process.exit(1);
     }
-} catch (error: unknown) {
-    echo(`wechatmp ${verb}: failed — ${error instanceof Error ? error.message : String(error)}`);
-    process.exit(1);
+
+    let verdict: WechatVerdict;
+    try {
+        await checkWechatSession(profileDir, { headless: !headed, timeoutMs });
+        verdict = {
+            status: 'verified',
+            profileDir,
+            detail: `authenticated wechatmp console session observed ${headed ? 'via a headed pass' : 'headlessly'} via profile ${profileDir} (read-only)`,
+        };
+    } catch (error) {
+        verdict = {
+            status: 'refused',
+            profileDir,
+            detail: `wechatmp readiness refused: ${error instanceof Error ? error.message : String(error)}`,
+        };
+    }
+    echo(JSON.stringify(verdict));
+    return verdict.status === 'verified' ? 0 : 1;
+}
+
+if (import.meta.main) {
+    process.exit(await main());
 }