@gobing-ai/knowledge-kit 0.0.32 → 0.0.34

package/plugins/publishings/qiita-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/substack-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();
 }
@@ -30263,7 +30323,7 @@ var LIVE_URL_RE = /\/p\/[^/?#]+|\/publish\/posts\/published/;
 var PUBLICATION_URL_SOURCES = "SUBSTACK_PUBLICATION_URL (or --publication <url>)";
 function editorUrl(publicationUrl) {
   const base2 = publicationUrl.trim().replace(/\/$/, "").replace(/\/publish$/, "");
-  return `${base2}/publish/post/new`;
+  return `${base2}/publish/post`;
 }
 function resolvePublicationUrl(explicit) {
   const trimmed = (explicit ?? process.env.SUBSTACK_PUBLICATION_URL)?.trim() ?? "";
@@ -30305,6 +30365,18 @@ function errorMessage3(error51) {
 function needsLogin(error51) {
   return error51 instanceof LoginTimeoutError || error51 instanceof BrowserProfileMissingError;
 }
+var SUBSTACK_OPERATIONS = ["post"];
+function resolveOperation(options, content) {
+  const raw = options?.operation ?? content?.metadata?.operation;
+  if (raw === undefined)
+    return { operation: "post" };
+  if (typeof raw !== "string" || !SUBSTACK_OPERATIONS.includes(raw)) {
+    return {
+      error: `unsupported operation '${String(raw)}' for substack: expected one of ${SUBSTACK_OPERATIONS.join(", ")}`
+    };
+  }
+  return { operation: raw };
+}
 
 class SubstackBrowserTransport {
   kind = "browser";
@@ -30313,13 +30385,16 @@ class SubstackBrowserTransport {
   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) {
     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')`);
@@ -30482,6 +30557,7 @@ if (import.meta.main) {
 }
 export {
   resolvePublicationUrl,
+  resolveOperation,
   processPublishIO,
   main2 as main,
   isAuthenticated,
@@ -30489,6 +30565,7 @@ export {
   editorUrl,
   channelConfig,
   SubstackBrowserTransport,
+  SUBSTACK_OPERATIONS,
   SELECTORS,
   LOGIN_URL_RE,
   CHANNEL

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

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

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

@@ -12,6 +12,7 @@ import {
     type ChannelBrowserConfig,
     checkChannelSession,
     expectOutcome,
+    kkBrowserLauncher,
     markdownToHtml,
     pasteHtml,
     resolveChannelProfileDir,
@@ -36,7 +37,10 @@ export const LOGIN_URL_RE = /(\/sign-in|substack\.com\/account\/login)/;
 
 /**
  * Selectors seeded from the wt script (`substack-playwright.ts:84-136`); each list is tried in
- * order and the operator dogfood (0193) re-measures them. `send` is Substack's
+ * order. Measured live 2026-10-07 (0193): title `textarea[placeholder="Title"]` and body
+ * `.ProseMirror[contenteditable="true"]` both hit, harness paste verified; both subtitle
+ * candidates miss — the current editor UI has no subtitle field, so they are kept as
+ * last-known and only resolve when `metadata.subtitle` is set. `send` is Substack's
  * `Send to everyone now` — it emails every subscriber — so both live controls (E91-D5) are
  * reached only from the `public` branch, after the draft branch has already returned.
  */
@@ -64,15 +68,18 @@ const LIVE_URL_RE = /\/p\/[^/?#]+|\/publish\/posts\/published/;
 const PUBLICATION_URL_SOURCES = 'SUBSTACK_PUBLICATION_URL (or --publication <url>)';
 
 /**
- * The publication's new-post editor: `${base}/publish/post/new`, where the base is the
- * publication URL without its trailing `/` or `/publish` (seed `substack-playwright.ts:237-244`).
+ * The publication's post editor: `${base}/publish/post`, where the base is the publication URL
+ * without its trailing `/` or `/publish` (seed `substack-playwright.ts:237-244`). The legacy
+ * `/publish/post/new` route autosaves locally ("Saved") but never becomes a post entity, so the
+ * URL never rewrites to `/publish/post/<id>` and the draft signal never fires — measured live
+ * 2026-10-07 (0193 A/B: `new` no rewrite, bare route rewrote to `/publish/post/219348810`).
  */
 export function editorUrl(publicationUrl: string): string {
     const base = publicationUrl
         .trim()
         .replace(/\/$/, '')
         .replace(/\/publish$/, '');
-    return `${base}/publish/post/new`;
+    return `${base}/publish/post`;
 }
 
 /**
@@ -97,7 +104,7 @@ export function resolvePublicationUrl(explicit?: string): { url: string } | { er
         return { error: `substack publication URL must be https:, got '${trimmed}' — set ${PUBLICATION_URL_SOURCES}` };
     }
     // Nested editor paths are rejected (residual 0197): `…/publish/posts` used to pass validation
-    // and then be mangled by `editorUrl` (`…/publish/posts/publish/post/new`), so a misconfigured
+    // and then be mangled by `editorUrl` (`…/publish/posts/publish/post`), so a misconfigured
     // run reported an expired session instead of a configuration error. A trailing `/publish` is
     // accepted and stripped by `editorUrl` — that is the documented shape.
     const trimmedPath = parsed.pathname.replace(/\/+$/, '');
@@ -139,15 +146,37 @@ function needsLogin(error: unknown): boolean {
     return error instanceof LoginTimeoutError || error instanceof BrowserProfileMissingError;
 }
 
+/**
+ * Declared modes (ADR-029 dispatch; task 0205 R2): Substack’s console flow is the publication-scoped post draft. An unknown operation is refused by
+ * name before a profile is resolved or a browser opens.
+ */
+export const SUBSTACK_OPERATIONS = ['post'] as const;
+export type SubstackOperation = (typeof SUBSTACK_OPERATIONS)[number];
+
+/** Exit-early resolution of the requested operation; a default Content without one resolves to `post`. */
+export function resolveOperation(
+    options?: Record<string, unknown>,
+    content?: Content,
+): { operation: SubstackOperation; error?: undefined } | { operation?: undefined; error: string } {
+    const raw = options?.operation ?? content?.metadata?.operation;
+    if (raw === undefined) return { operation: 'post' };
+    if (typeof raw !== 'string' || !(SUBSTACK_OPERATIONS as readonly string[]).includes(raw)) {
+        return {
+            error: `unsupported operation '${String(raw)}' for substack: expected one of ${SUBSTACK_OPERATIONS.join(', ')}`,
+        };
+    }
+    return { operation: raw as SubstackOperation };
+}
+
 export class SubstackBrowserTransport 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;
     }
 
@@ -155,6 +184,8 @@ export class SubstackBrowserTransport implements PublishTransport {
         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')`);
@@ -290,7 +321,7 @@ export class SubstackBrowserTransport implements PublishTransport {
     }
 }
 
-/** Draft evidence is URL-only by design: Substack's autosave rewrites `/publish/post/new`. */
+/** Draft evidence is URL-only by design: Substack's autosave rewrites `/publish/post/<id>`. */
 async function probeDraft(page: Page): Promise<string | null> {
     const url = page.url();
     return DRAFT_URL_RE.test(url) ? url : null;

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

@@ -63,6 +63,8 @@ export async function main(argv: readonly string[] = Bun.argv.slice(2), deps: Pr
     const publication = resolvePublicationUrl(publicationUrl);
     if ('error' in publication) {
         stdout(`substack profile-check: ${publication.error} — ${USAGE}`);
+        // Last line is the ADR-032 verdict so `kk plugin check` can name the missing variable.
+        stdout(JSON.stringify({ status: 'error', detail: publication.error }));
         return 2;
     }
     const config: ChannelBrowserConfig = channelConfig(publication.url);

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

@@ -14665,7 +14665,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 = {
@@ -14676,7 +14676,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();
@@ -14699,13 +14699,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];
@@ -14723,7 +14723,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();
@@ -21721,7 +21721,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();
@@ -21745,7 +21745,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) {
@@ -22037,11 +22037,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();