@gobing-ai/knowledge-kit 0.0.33 → 0.0.35

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

@@ -2,7 +2,7 @@
     "name": "xhs-pub",
     "kind": "publish",
     "entry": "./dist/index.js",
-    "check": "./src/profile-check.ts",
+    "check": "./dist/profile-check.js",
     "version": "1.0.0",
     "description": "Publish plugin for Xiaohongshu (xhs): one creator console, four validated operations (上传图文 ≤18 images | 上传视频 | 写长文 | 发播客 audio+cover) saved as a draft via 暂存离开 or published live via 发布, over the Playwright script transport"
 }

package/plugins/publishings/xhs-pub/src/flow.ts

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

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

@@ -73,6 +73,71 @@ function fail(error: string): Result {
     return ResultSchema.parse({ ok: false, target: TARGET, error });
 }
 
+/** One operation of a visit: its own Content and the mode input validated before any browser work. */
+interface VisitOperation {
+    content: Content;
+    input: ModeInput;
+}
+
+/**
+ * A follow-up operation of a visit: planned, or refused with the reason it never reached the console.
+ * A refused follow-up is reported as its own failed Result entry — it can never fail the note the
+ * visit was opened for (ADR-025 amendment 2026-10-09).
+ */
+type VisitFollowUp = { content: Content; operation: string; input: ModeInput } | { operation: string; error: string };
+
+interface VisitPlan {
+    /** The requested operation, resolved and validated exactly as before task 0236. */
+    primary: VisitOperation;
+    /** The primary Content's `metadata.followUps`, in declared order. */
+    followUps: VisitFollowUp[];
+}
+
+/**
+ * Plan a visit (ADR-025 amendment 2026-10-09, task 0236 option A): the requested operation plus the
+ * follow-ups the caller attached to the primary Content's `metadata.followUps`. One headed visit may
+ * compose several notes under ONE cap entry — the cap still counts visits, not notes.
+ *
+ * The primary is planned as it always was: an unplannable primary is a `fail` and no browser opens.
+ * A follow-up that cannot be planned (not a Content, an undeclared operation, a missing or unreadable
+ * artifact) is refused here, before any console work, and reported as its own entry instead. A
+ * `metadata.followUps` that is not an array is a caller error, so it fails loud before any browser.
+ */
+async function planVisit(
+    primary: VisitOperation,
+    content: Content,
+): Promise<{ plan: VisitPlan; error?: undefined } | { plan?: undefined; error: string }> {
+    const raw = content.metadata?.followUps;
+    if (raw === undefined) return { plan: { primary, followUps: [] } };
+    if (!Array.isArray(raw)) {
+        return {
+            error: `followUps validation: Content.metadata.followUps must be an array of Content objects, got ${typeof raw}`,
+        };
+    }
+    const followUps: VisitFollowUp[] = [];
+    for (const [index, entry] of raw.entries()) {
+        const label = `followUps[${index}]`;
+        const parsed = ContentSchema.safeParse(entry);
+        if (!parsed.success) {
+            followUps.push({ operation: label, error: `${label} is not a Content object` });
+            continue;
+        }
+        const operation = typeof parsed.data.metadata?.operation === 'string' ? parsed.data.metadata.operation : label;
+        const requested = resolveXhsOperation(undefined, parsed.data);
+        if (requested.error !== undefined) {
+            followUps.push({ operation, error: requested.error });
+            continue;
+        }
+        const validation = await validateModeInput(requested.operation, parsed.data);
+        if (validation.error !== undefined) {
+            followUps.push({ operation, error: validation.error });
+            continue;
+        }
+        followUps.push({ content: parsed.data, operation: requested.operation, input: validation.input });
+    }
+    return { plan: { primary, followUps } };
+}
+
 /** CDP is Chromium-only; when unavailable the submit step fails loud instead of guessing. */
 export async function createShadowProbe(
     context: { newCDPSession?(page: unknown): Promise<ShadowCdpSession> },
@@ -239,13 +304,20 @@ export class XhsBrowserTransport implements PublishTransport {
         if (validation.error !== undefined) return fail(validation.error);
         const input: ModeInput = validation.input;
 
+        // ADR-025 amendment (2026-10-09, task 0236 option A): one visit may compose more than one
+        // note. The follow-ups ride the primary Content's `metadata.followUps` and are planned here,
+        // with the primary, before any browser work.
+        const visited = await planVisit({ content: payload.content, input }, payload.content);
+        if (visited.error !== undefined) return fail(visited.error);
+        const visit = visited.plan;
+
         const override = typeof payload.options?.profileDir === 'string' ? payload.options.profileDir : undefined;
         const profileDir = resolveChannelProfileDir(CHANNEL, override);
-        const publishStatus = payload.content.metadata?.publishStatus === 'public' ? 'public' : 'draft';
 
         // ADR-025 automation guard — both gates run before any browser opens.
         // 1. Frequency cap: the operator's platform warning makes a repeated console visit an
-        //    account-level risk, not merely a failed run.
+        //    account-level risk, not merely a failed run. The cap counts VISITS: one allow/record
+        //    per visit covers every note the visit composes.
         const cap = this.automation.allow('publish');
         if (!cap.allowed) return fail(`automation cap: ${cap.reason}`);
         // 2. Headless session preflight: an unauthenticated profile must never produce a headed
@@ -266,6 +338,41 @@ export class XhsBrowserTransport implements PublishTransport {
             return fail(error instanceof Error ? error.message : String(error));
         }
         const { page, close } = opened;
+        try {
+            // The visit's own Result is the primary operation's: a failed primary ends the visit, as
+            // it always did, and only a primary that stood reports its follow-ups.
+            const primary = await this.runStep(visit.primary.input, visit.primary.content, page, profileDir);
+            if (!primary.ok || visit.followUps.length === 0) return primary;
+            // One Result entry per operation, in declared order; a refused and a failed follow-up
+            // are the same kind of entry, and neither can fail the note the visit was opened for.
+            const followUps: Result[] = [];
+            for (const followUp of visit.followUps) {
+                const step =
+                    'error' in followUp
+                        ? fail(`follow-up (${followUp.operation}): ${followUp.error}`)
+                        : await this.runStep(followUp.input, followUp.content, page, profileDir);
+                // Every entry names the operation it was planned under — a failed or refused one too,
+                // so the caller can tell which note fell; the step's own metadata wins.
+                followUps.push(
+                    ResultSchema.parse({ ...step, metadata: { operation: followUp.operation, ...step.metadata } }),
+                );
+            }
+            return ResultSchema.parse({ ...primary, metadata: { ...primary.metadata, followUps } });
+        } finally {
+            await close();
+        }
+    }
+
+    /**
+     * Run one operation of the visit in the page the visit already opened. Every step enters the
+     * console from its landing view: the primary needs the login gate and the pre-entry draft
+     * baseline, and a follow-up needs both again — the previous note's editor replaces the header,
+     * and the baseline must be read before THIS note's mode is entered.
+     *
+     * A step never throws: its failure is that operation's own `ok:false` Result, which is what keeps
+     * a failed follow-up from failing the visit (ADR-025 amendment 2026-10-09).
+     */
+    private async runStep(input: ModeInput, content: Content, page: XhsPage, profileDir: string): Promise<Result> {
         const act = async <T>(what: string, fn: () => Promise<T>): Promise<T> => {
             try {
                 return await fn();
@@ -283,6 +390,7 @@ export class XhsBrowserTransport implements PublishTransport {
                 );
             }
 
+            const publishStatus = content.metadata?.publishStatus === 'public' ? 'public' : 'draft';
             // The draft counter and any save timestamps exist only on the landing view, so the
             // baseline is captured before the mode is entered (the editor replaces the header).
             const draftBaseline =
@@ -290,7 +398,7 @@ export class XhsBrowserTransport implements PublishTransport {
 
             return await runMode(input, {
                 page,
-                content: payload.content,
+                content,
                 publishStatus,
                 profileDir,
                 driver: this.driver,
@@ -301,8 +409,6 @@ export class XhsBrowserTransport implements PublishTransport {
             });
         } catch (error) {
             return fail(error instanceof Error ? error.message : String(error));
-        } finally {
-            await close();
         }
     }
 }

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

@@ -14642,7 +14642,7 @@ var init_zod = __esm(() => {
   init_external();
 });
 
-// ../../node_modules/.bun/@gobing-ai+ts-utils@0.5.18/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.18/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.18/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.18/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.18/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.18/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.18+ea28d47622d670ff/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.18+ea28d47622d670ff/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) {
@@ -21902,7 +21902,7 @@ var PluginManifestSchema = exports_external.looseObject({
   description: exports_external.string().optional(),
   operations: exports_external.record(exports_external.string(), PluginOperationSchema).optional()
 });
-// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.5.18+ea28d47622d670ff/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/generations/omni-voice-gen/dist/omni-voice-gen-prr8skpb.

@@ -1,2 +0,0 @@
-#!/usr/bin/env bash
-exec uv run --project "$(cd "$(dirname "$0")/.." && pwd)" python -m omni_voice_gen "$@"

package/plugins/generations/omni-voice-gen/dist/omni-voice-gen.js

@@ -1,6 +0,0 @@
-// @bun
-// ../../plugins/generations/omni-voice-gen/bin/omni-voice-gen
-var omni_voice_gen_default = "./omni-voice-gen-prr8skpb.";
-export {
-  omni_voice_gen_default as default
-};