@gobing-ai/knowledge-kit 0.0.19 → 0.0.22

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

@@ -21782,6 +21782,22 @@ var ResultSchema = exports_external.object({
   error: exports_external.string().optional(),
   metadata: exports_external.record(exports_external.string(), exports_external.unknown()).optional()
 });
+var TargetOutcomeSchema = exports_external.object({
+  target: exports_external.string(),
+  ok: exports_external.boolean(),
+  status: exports_external.enum(["published", "failed", "skipped"]),
+  url: exports_external.string().optional(),
+  id: exports_external.string().optional(),
+  error: exports_external.string().optional(),
+  durationMs: exports_external.number().optional(),
+  metadata: exports_external.record(exports_external.string(), exports_external.unknown()).optional()
+});
+var AggregateResultSchema = exports_external.object({
+  ok: exports_external.boolean(),
+  summary: exports_external.object({ total: exports_external.number(), succeeded: exports_external.number(), failed: exports_external.number(), skipped: exports_external.number() }),
+  targets: exports_external.array(TargetOutcomeSchema),
+  metadata: exports_external.record(exports_external.string(), exports_external.unknown()).optional()
+});
 var DocListSchema = exports_external.array(DocSchema);
 var omniVoiceGenContentSchema = ContentSchema.extend({
   format: exports_external.literal("audio"),
@@ -21810,14 +21826,15 @@ var PluginKindSchema = exports_external.enum(PLUGIN_KINDS);
 // ../../packages/kk-core/src/manifest.ts
 init_zod();
 var OperationIOSchema = exports_external.enum(["doc-list", "markdown"]);
-var PluginManifestSchema = exports_external.object({
+var PluginOperationSchema = exports_external.object({ input: OperationIOSchema, output: OperationIOSchema });
+var PluginManifestSchema = exports_external.looseObject({
   name: exports_external.string().min(1),
   kind: PluginKindSchema,
   entry: exports_external.string().min(1),
   version: exports_external.string().optional(),
   description: exports_external.string().optional(),
-  operations: exports_external.record(exports_external.string(), exports_external.object({ input: OperationIOSchema, output: OperationIOSchema })).optional()
-}).passthrough();
+  operations: exports_external.record(exports_external.string(), PluginOperationSchema).optional()
+});
 // ../../node_modules/.bun/@gobing-ai+ts-runtime@0.4.39/node_modules/@gobing-ai/ts-runtime/dist/index.js
 init_file_system_node();
 init_config();
@@ -21843,42 +21860,81 @@ function echoError(message, target = defaultStderrTarget ?? processStream("stder
 // ../../packages/kk-core/src/render-md.ts
 if (false) {}
 // ../../packages/publish-harness/src/index.ts
-class FakeFileCliTransport {
-  kind = "file-cli";
-  callLogs;
+class FakeTransportCore {
+  callLogs = [];
   nextResult;
-  constructor() {
-    this.callLogs = [];
-  }
   setNextResult(result) {
     this.nextResult = result;
   }
-  async publish(payload) {
+  async publish(payload, defaultResult) {
     this.callLogs.push({
       timestamp: new Date().toISOString(),
       payload
     });
-    if (this.nextResult) {
-      return this.nextResult;
-    }
-    return {
+    return this.nextResult ?? defaultResult;
+  }
+  getCallLogs() {
+    return this.callLogs;
+  }
+  reset() {
+    this.callLogs = [];
+    this.nextResult = undefined;
+  }
+}
+
+class FakeFileCliTransport {
+  kind = "file-cli";
+  core = new FakeTransportCore;
+  setNextResult(result) {
+    this.core.setNextResult(result);
+  }
+  async publish(payload) {
+    return this.core.publish(payload, {
       ok: true,
       target: "fake-file-cli",
       url: "https://example.com/published-post",
       id: "fake-id-123",
       message: "Published offline via FakeFileCliTransport"
-    };
+    });
   }
   getCallLogs() {
-    return this.callLogs;
+    return this.core.getCallLogs();
   }
   reset() {
-    this.callLogs = [];
-    this.nextResult = undefined;
+    this.core.reset();
+  }
+}
+
+class FakeBrowserTransport {
+  kind = "browser";
+  driver;
+  core = new FakeTransportCore;
+  constructor(driver = "agent") {
+    this.driver = driver;
+  }
+  setNextResult(result) {
+    this.core.setNextResult(result);
+  }
+  async publish(payload) {
+    return this.core.publish(payload, {
+      ok: true,
+      target: "fake-browser",
+      url: "https://example.com/browser-draft",
+      id: "fake-browser-id-123",
+      message: "Published offline via FakeBrowserTransport",
+      metadata: { driver: this.driver }
+    });
+  }
+  getCallLogs() {
+    return this.core.getCallLogs();
+  }
+  reset() {
+    this.core.reset();
   }
 }
 
 // ../../plugins/publishings/zenn-pub/src/index.ts
+var ZENN_CLI_VERSION = "0.5.4";
 function slugify2(str) {
   return str.toLowerCase().replace(/[^\w\s-]/g, "").trim().replace(/[\s_]+/g, "-");
 }
@@ -21969,9 +22025,22 @@ class ZennCliFileCliTransport {
       });
     }
     const repoPath = repo.startsWith("~") ? join(homedir(), repo.slice(2)) : repo;
+    const zennUsername = process.env.ZENN_USERNAME?.trim();
     try {
       await createNodeFileSystem().ensureDir(repoPath);
-      const cliArgs = ["--yes", "zenn", "new:article", "--slug", slug, "--title", title, "--type", type];
+      const cliArgs = [
+        "--yes",
+        "--package",
+        `zenn-cli@${ZENN_CLI_VERSION}`,
+        "zenn",
+        "new:article",
+        "--slug",
+        slug,
+        "--title",
+        title,
+        "--type",
+        type
+      ];
       if (emoji3) {
         cliArgs.push("--emoji", emoji3);
       }
@@ -21988,13 +22057,15 @@ class ZennCliFileCliTransport {
       const articlePath = join(articleDir, `${slug}.md`);
       await createNodeFileSystem().writeFile(articlePath, markdown);
       if (published) {
+        const articleRel = `articles/${slug}.md`;
         const gitSteps = [
-          ["add", `articles/${slug}.md`],
-          ["commit", "-m", `Add article: ${title}`],
-          ["push"]
+          ["rev-parse", "--abbrev-ref", "HEAD"],
+          ["add", "--", articleRel],
+          ["commit", "-m", `Add article: ${title}`, "--", articleRel],
+          ["push", "origin", "main"]
         ];
         for (const gitArgs of gitSteps) {
-          const [code, , stderr] = await this.runCli("git", gitArgs, repoPath);
+          const [code, stdout, stderr] = await this.runCli("git", gitArgs, repoPath);
           if (code !== 0) {
             return ResultSchema.parse({
               ok: false,
@@ -22002,14 +22073,21 @@ class ZennCliFileCliTransport {
               error: `git ${gitArgs.join(" ")} failed (exit ${code}): ${stderr.trim() || "Unknown error"}`
             });
           }
+          if (gitArgs[0] === "rev-parse" && stdout.trim() !== "main") {
+            return ResultSchema.parse({
+              ok: false,
+              target: "zenn",
+              error: `Zenn repo is on branch '${stdout.trim()}', not 'main' \u2014 Zenn deploys from main; refusing to commit`
+            });
+          }
         }
       }
       return ResultSchema.parse({
         ok: true,
         target: "zenn",
-        url: `https://zenn.dev/articles/${slug}`,
+        url: zennUsername ? `https://zenn.dev/${zennUsername}/articles/${slug}` : undefined,
         id: slug,
-        message: published ? "Published to Zenn via Zenn CLI (article committed and pushed to GitHub)" : "Zenn draft article created (published: false; commit and push to deploy)"
+        message: `${published ? "Published to Zenn via Zenn CLI (article committed and pushed to GitHub)" : "Zenn draft article created (published: false; commit and push to deploy)"}${zennUsername ? "" : " (set ZENN_USERNAME to report the article URL)"}`
       });
     } catch (err) {
       return ResultSchema.parse({

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

@@ -6,6 +6,14 @@ import { FakeFileCliTransport, type PublishTransport, type PublishTransportPaylo
 import { createNodeFileSystem } from '@gobing-ai/ts-runtime';
 import { echoError } from '@gobing-ai/ts-utils';
 
+/**
+ * Pinned `zenn-cli` version. `npx <name>` resolves the npm package *named* `<name>`, and the
+ * package `zenn` was unpublished on 2021-04-20 — so `npx zenn` fails (or worse, runs whatever a
+ * future republisher ships, with `--yes` suppressing the prompt). `--package` names the real
+ * package explicitly.
+ */
+const ZENN_CLI_VERSION = '0.5.4';
+
 /**
  * Converts a string into a lowercase hyphenated tag (slug) per the publish spec tags convention.
  */
@@ -161,11 +169,26 @@ export class ZennCliFileCliTransport implements PublishTransport {
             });
         }
         const repoPath = repo.startsWith('~') ? join(homedir(), repo.slice(2)) : repo;
+        // Zenn article URLs are `https://zenn.dev/<user>/articles/<slug>`; without the username the
+        // path is wrong (it 404s), so omit `url` rather than report a broken link.
+        const zennUsername = process.env.ZENN_USERNAME?.trim();
 
         try {
             await createNodeFileSystem().ensureDir(repoPath);
 
-            const cliArgs = ['--yes', 'zenn', 'new:article', '--slug', slug, '--title', title, '--type', type];
+            const cliArgs = [
+                '--yes',
+                '--package',
+                `zenn-cli@${ZENN_CLI_VERSION}`,
+                'zenn',
+                'new:article',
+                '--slug',
+                slug,
+                '--title',
+                title,
+                '--type',
+                type,
+            ];
             if (emoji) {
                 cliArgs.push('--emoji', emoji);
             }
@@ -184,13 +207,15 @@ export class ZennCliFileCliTransport implements PublishTransport {
             await createNodeFileSystem().writeFile(articlePath, markdown);
 
             if (published) {
+                const articleRel = `articles/${slug}.md`;
                 const gitSteps: string[][] = [
-                    ['add', `articles/${slug}.md`],
-                    ['commit', '-m', `Add article: ${title}`],
-                    ['push'],
+                    ['rev-parse', '--abbrev-ref', 'HEAD'],
+                    ['add', '--', articleRel],
+                    ['commit', '-m', `Add article: ${title}`, '--', articleRel],
+                    ['push', 'origin', 'main'],
                 ];
                 for (const gitArgs of gitSteps) {
-                    const [code, , stderr] = await this.runCli('git', gitArgs, repoPath);
+                    const [code, stdout, stderr] = await this.runCli('git', gitArgs, repoPath);
                     if (code !== 0) {
                         return ResultSchema.parse({
                             ok: false,
@@ -198,17 +223,26 @@ export class ZennCliFileCliTransport implements PublishTransport {
                             error: `git ${gitArgs.join(' ')} failed (exit ${code}): ${stderr.trim() || 'Unknown error'}`,
                         });
                     }
+                    if (gitArgs[0] === 'rev-parse' && stdout.trim() !== 'main') {
+                        return ResultSchema.parse({
+                            ok: false,
+                            target: 'zenn',
+                            error: `Zenn repo is on branch '${stdout.trim()}', not 'main' — Zenn deploys from main; refusing to commit`,
+                        });
+                    }
                 }
             }
 
             return ResultSchema.parse({
                 ok: true,
                 target: 'zenn',
-                url: `https://zenn.dev/articles/${slug}`,
+                url: zennUsername ? `https://zenn.dev/${zennUsername}/articles/${slug}` : undefined,
                 id: slug,
-                message: published
-                    ? 'Published to Zenn via Zenn CLI (article committed and pushed to GitHub)'
-                    : 'Zenn draft article created (published: false; commit and push to deploy)',
+                message: `${
+                    published
+                        ? 'Published to Zenn via Zenn CLI (article committed and pushed to GitHub)'
+                        : 'Zenn draft article created (published: false; commit and push to deploy)'
+                }${zennUsername ? '' : ' (set ZENN_USERNAME to report the article URL)'}`,
             });
         } catch (err: unknown) {
             return ResultSchema.parse({