@gobing-ai/knowledge-kit 0.0.13 → 0.0.14

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

@@ -21848,6 +21848,26 @@ var ResultSchema = exports_external.object({
   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"),
+  metadata: exports_external.looseObject({
+    generator: exports_external.literal("kk:omni-voice-gen"),
+    audioPath: exports_external.string(),
+    duration: exports_external.number(),
+    segments: exports_external.array(exports_external.looseObject({
+      generationId: exports_external.string(),
+      profile: exports_external.string(),
+      speaker: exports_external.string().optional(),
+      emotion: exports_external.string().optional(),
+      duration: exports_external.number(),
+      verifyRetries: exports_external.number(),
+      transcription: exports_external.string().optional(),
+      loudnessDip: exports_external.boolean().optional()
+    })),
+    mp3Path: exports_external.string().optional(),
+    qc: exports_external.record(exports_external.string(), exports_external.unknown()).optional()
+  })
+});
 
 // ../../packages/kk-core/src/kinds.ts
 var PLUGIN_KINDS = ["ingestion", "generator", "publish"];

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

@@ -21914,6 +21914,26 @@ var ResultSchema = exports_external.object({
   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"),
+  metadata: exports_external.looseObject({
+    generator: exports_external.literal("kk:omni-voice-gen"),
+    audioPath: exports_external.string(),
+    duration: exports_external.number(),
+    segments: exports_external.array(exports_external.looseObject({
+      generationId: exports_external.string(),
+      profile: exports_external.string(),
+      speaker: exports_external.string().optional(),
+      emotion: exports_external.string().optional(),
+      duration: exports_external.number(),
+      verifyRetries: exports_external.number(),
+      transcription: exports_external.string().optional(),
+      loudnessDip: exports_external.boolean().optional()
+    })),
+    mp3Path: exports_external.string().optional(),
+    qc: exports_external.record(exports_external.string(), exports_external.unknown()).optional()
+  })
+});
 
 // ../../packages/kk-core/src/kinds.ts
 var PLUGIN_KINDS = ["ingestion", "generator", "publish"];
@@ -22043,7 +22063,59 @@ async function spawnCli(cmd, cwd) {
   return { exitCode, stdout, stderr };
 }
 function cliErrorText(spawned) {
-  return spawned.stderr.trim() || spawned.stdout.trim() || "Unknown error";
+  return [spawned.stderr.trim(), spawned.stdout.trim()].filter((part) => part !== "").join(`
+`) || "Unknown error";
+}
+function withEmdashTokenHint(errText) {
+  return /INVALID_TOKEN|API error 401/.test(errText) ? `${errText} \u2014 hint: regenerate the EmDash token (surfing.salty.vip admin console) and update EMDASH_API_TOKEN in ~/.config/kk/config.yaml` : errText;
+}
+async function pushPostGit(surfdashRoot, relPostDir, message) {
+  const branch = await spawnCli(["git", "rev-parse", "--abbrev-ref", "HEAD"], surfdashRoot);
+  if (branch.exitCode !== 0)
+    return { ok: false, error: `surfdash git branch check failed: ${cliErrorText(branch)}` };
+  const branchName = branch.stdout.trim();
+  if (branchName !== "main") {
+    return {
+      ok: false,
+      error: `surfdash checkout is on '${branchName}', not 'main' \u2014 deploy.yml only builds main; refusing to push from a feature branch`
+    };
+  }
+  const add = await spawnCli(["git", "add", "--", relPostDir], surfdashRoot);
+  if (add.exitCode !== 0)
+    return { ok: false, error: `surfdash git add failed: ${cliErrorText(add)}` };
+  const staged = await spawnCli(["git", "diff", "--cached", "--quiet", "--", relPostDir], surfdashRoot);
+  if (staged.exitCode === 0) {
+    const unpushed = await spawnCli(["git", "diff", "--quiet", "origin/main..HEAD", "--", relPostDir], surfdashRoot);
+    if (unpushed.exitCode === 0) {
+      const hash3 = await spawnCli(["git", "rev-parse", "--short", "HEAD"], surfdashRoot);
+      return { ok: true, hash: hash3.stdout.trim() || "unknown" };
+    }
+  } else {
+    const commit = await spawnCli(["git", "commit", "-m", message, "--", relPostDir], surfdashRoot);
+    if (commit.exitCode !== 0)
+      return { ok: false, error: `surfdash git commit failed: ${cliErrorText(commit)}` };
+  }
+  const push = await spawnCli(["git", "push", "origin", "main"], surfdashRoot);
+  if (push.exitCode !== 0) {
+    return {
+      ok: false,
+      error: `surfdash git push failed (deploy.yml deploys on push to main): ${cliErrorText(push)}`
+    };
+  }
+  const hash2 = await spawnCli(["git", "rev-parse", "--short", "HEAD"], surfdashRoot);
+  return { ok: true, hash: hash2.stdout.trim() || "unknown" };
+}
+async function awaitArticleLive(url2, timeoutMs = 180000, intervalMs = 1e4) {
+  const deadline = Date.now() + timeoutMs;
+  while (Date.now() < deadline) {
+    try {
+      const resp = await fetch(url2, { redirect: "follow", signal: AbortSignal.timeout(5000) });
+      if (resp.ok)
+        return true;
+    } catch {}
+    await Bun.sleep(intervalMs);
+  }
+  return false;
 }
 async function scaffoldLocale(options) {
   const postPath = resolvePostPath(options);
@@ -22102,7 +22174,7 @@ async function syncPost(options) {
   try {
     const spawned = await spawnCli(["bun", "scripts/publish-orchestrator.ts", "sync", postPath.postPath], surfdashRoot);
     if (spawned.exitCode !== 0) {
-      return fail(`publish-orchestrator sync failed (exit ${spawned.exitCode}): ${cliErrorText(spawned)}`);
+      return fail(`publish-orchestrator sync failed (exit ${spawned.exitCode}): ${withEmdashTokenHint(cliErrorText(spawned))}`);
     }
     return ResultSchema.parse({
       ok: true,
@@ -22146,14 +22218,29 @@ async function publishPost(payload) {
     await createNodeFileSystem().writeFile(filePath, markdown);
     const spawned = await spawnCli([postsurfingBin, "publish", filePath], surfdashRoot);
     if (spawned.exitCode !== 0) {
-      return fail(`postsurfing CLI failed (exit ${spawned.exitCode}): ${cliErrorText(spawned)}`);
+      return fail(`postsurfing CLI failed (exit ${spawned.exitCode}): ${withEmdashTokenHint(cliErrorText(spawned))}`);
+    }
+    const articleUrl = `${(process.env.SURFDASH_URL ?? "https://surfing.salty.vip").replace(/\/$/, "")}/${locale}/posts/${slug}`;
+    if (process.env.SURFDASH_AUTO_PUSH === "0") {
+      return ResultSchema.parse({
+        ok: true,
+        target: TARGET,
+        url: articleUrl,
+        message: "Published via postsurfing CLI (auto-push disabled)",
+        metadata: { postPath: filePath }
+      });
     }
+    const relPostDir = join("content", "posts", "articles", locale, slug);
+    const pushed = await pushPostGit(surfdashRoot, relPostDir, `content: daily AI news ${dateStamp} (zh)`);
+    if (!pushed.ok)
+      return fail(pushed.error);
+    const live = await awaitArticleLive(articleUrl);
     return ResultSchema.parse({
       ok: true,
       target: TARGET,
-      url: `https://surfdash.local/${locale}/posts/${slug}`,
-      message: "Published successfully to Surfdash via postsurfing CLI",
-      metadata: { postPath: filePath }
+      url: articleUrl,
+      message: live ? "Published, committed, pushed, and live on the site" : "Published and pushed; URL not live within the verify window \u2014 check the surfdash deploy workflow",
+      metadata: { postPath: filePath, gitCommit: pushed.hash, live }
     });
   } catch (err) {
     return fail(`Postsurfing transport error: ${err instanceof Error ? err.message : String(err)}`);
@@ -22224,10 +22311,13 @@ if (import.meta.main) {
   process.exit(await main2());
 }
 export {
+  withEmdashTokenHint,
   slugify2 as slugify,
+  pushPostGit,
   processPublishIO,
   mapContentToSurfingMarkdown,
   main2 as main,
   getPublishTransport,
+  awaitArticleLive,
   PostsurfingFileCliTransport
 };

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

@@ -210,9 +210,85 @@ async function spawnCli(cmd: string[], cwd: string): Promise<CliSpawnResult> {
     return { exitCode, stdout, stderr };
 }
 
-/** Stderr-first error text for a failed CLI spawn (stderr may be empty → fall back to stdout). */
+/** Error text for a failed CLI spawn — both streams concatenated: postsurfing streams the
+ * failing stage's API error (e.g. 401 INVALID_TOKEN) on stdout while bun stacks land on stderr. */
 function cliErrorText(spawned: CliSpawnResult): string {
-    return spawned.stderr.trim() || spawned.stdout.trim() || 'Unknown error';
+    return [spawned.stderr.trim(), spawned.stdout.trim()].filter((part) => part !== '').join('\n') || 'Unknown error';
+}
+
+/** The EmDash CMS token in kk config expires periodically; map the API's 401 to the fix. */
+export function withEmdashTokenHint(errText: string): string {
+    return /INVALID_TOKEN|API error 401/.test(errText)
+        ? `${errText} — hint: regenerate the EmDash token (surfing.salty.vip admin console) and update EMDASH_API_TOKEN in ~/.config/kk/config.yaml`
+        : errText;
+}
+
+/** Outcome of {@link pushPostGit} — the union keeps fail-loud errors typed at the call site. */
+export type GitPushOutcome = { ok: true; hash: string } | { ok: false; error: string };
+
+/**
+ * Commits the published post path and pushes to the remote. Production deploys run
+ * from surfdash's `deploy.yml` on every push to `main` — the publishing FSM itself
+ * never touches git, so without this step the article 404s until a manual commit.
+ * Committing with a pathspec (`git commit -- <path>`) keeps unrelated staged files
+ * out of the publish commit. Fails loud on branch/commit/push errors.
+ */
+export async function pushPostGit(surfdashRoot: string, relPostDir: string, message: string): Promise<GitPushOutcome> {
+    const branch = await spawnCli(['git', 'rev-parse', '--abbrev-ref', 'HEAD'], surfdashRoot);
+    if (branch.exitCode !== 0) return { ok: false, error: `surfdash git branch check failed: ${cliErrorText(branch)}` };
+    const branchName = branch.stdout.trim();
+    if (branchName !== 'main') {
+        return {
+            ok: false,
+            error: `surfdash checkout is on '${branchName}', not 'main' — deploy.yml only builds main; refusing to push from a feature branch`,
+        };
+    }
+    const add = await spawnCli(['git', 'add', '--', relPostDir], surfdashRoot);
+    if (add.exitCode !== 0) return { ok: false, error: `surfdash git add failed: ${cliErrorText(add)}` };
+    // Idempotent retry: post content identical to HEAD stages nothing. Only push when
+    // origin lacks commits touching this post; a clean post means it's already live.
+    const staged = await spawnCli(['git', 'diff', '--cached', '--quiet', '--', relPostDir], surfdashRoot);
+    if (staged.exitCode === 0) {
+        const unpushed = await spawnCli(
+            ['git', 'diff', '--quiet', 'origin/main..HEAD', '--', relPostDir],
+            surfdashRoot,
+        );
+        if (unpushed.exitCode === 0) {
+            const hash = await spawnCli(['git', 'rev-parse', '--short', 'HEAD'], surfdashRoot);
+            return { ok: true, hash: hash.stdout.trim() || 'unknown' };
+        }
+    } else {
+        const commit = await spawnCli(['git', 'commit', '-m', message, '--', relPostDir], surfdashRoot);
+        if (commit.exitCode !== 0) return { ok: false, error: `surfdash git commit failed: ${cliErrorText(commit)}` };
+    }
+    const push = await spawnCli(['git', 'push', 'origin', 'main'], surfdashRoot);
+    if (push.exitCode !== 0) {
+        return {
+            ok: false,
+            error: `surfdash git push failed (deploy.yml deploys on push to main): ${cliErrorText(push)}`,
+        };
+    }
+    const hash = await spawnCli(['git', 'rev-parse', '--short', 'HEAD'], surfdashRoot);
+    return { ok: true, hash: hash.stdout.trim() || 'unknown' };
+}
+
+/**
+ * Polls the article URL until the CDN serves it (deploy.yml build latency). Push
+ * acceptance is the authoritative publish signal, so an unverified URL is reported
+ * in the result message rather than failing the publish.
+ */
+export async function awaitArticleLive(url: string, timeoutMs = 180_000, intervalMs = 10_000): Promise<boolean> {
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        try {
+            const resp = await fetch(url, { redirect: 'follow', signal: AbortSignal.timeout(5_000) });
+            if (resp.ok) return true;
+        } catch {
+            // network blips during CI deploy — keep polling until the deadline
+        }
+        await Bun.sleep(intervalMs);
+    }
+    return false;
 }
 
 /**
@@ -291,7 +367,9 @@ async function syncPost(options: SurfdashPubOptions): Promise<Result> {
             surfdashRoot,
         );
         if (spawned.exitCode !== 0) {
-            return fail(`publish-orchestrator sync failed (exit ${spawned.exitCode}): ${cliErrorText(spawned)}`);
+            return fail(
+                `publish-orchestrator sync failed (exit ${spawned.exitCode}): ${withEmdashTokenHint(cliErrorText(spawned))}`,
+            );
         }
         return ResultSchema.parse({
             ok: true,
@@ -352,17 +430,39 @@ async function publishPost(payload: PublishTransportPayload): Promise<Result> {
         const spawned = await spawnCli([postsurfingBin, 'publish', filePath], surfdashRoot);
 
         if (spawned.exitCode !== 0) {
-            return fail(`postsurfing CLI failed (exit ${spawned.exitCode}): ${cliErrorText(spawned)}`);
+            return fail(
+                `postsurfing CLI failed (exit ${spawned.exitCode}): ${withEmdashTokenHint(cliErrorText(spawned))}`,
+            );
+        }
+
+        // Deploy seam: commit + push the post so deploy.yml builds it, then wait for
+        // the live URL — downstream show-notes advertise a real page, not a 404.
+        // Tests (and offline runs) opt out via SURFDASH_AUTO_PUSH=0.
+        const articleUrl = `${(process.env.SURFDASH_URL ?? 'https://surfing.salty.vip').replace(/\/$/, '')}/${locale}/posts/${slug}`;
+        if (process.env.SURFDASH_AUTO_PUSH === '0') {
+            return ResultSchema.parse({
+                ok: true,
+                target: TARGET,
+                url: articleUrl,
+                message: 'Published via postsurfing CLI (auto-push disabled)',
+                // Absolute post path lets downstream steps (locale translation + CMS sync)
+                // derive the surfdash checkout root without extra configuration.
+                metadata: { postPath: filePath },
+            });
         }
+        const relPostDir = join('content', 'posts', 'articles', locale, slug);
+        const pushed = await pushPostGit(surfdashRoot, relPostDir, `content: daily AI news ${dateStamp} (zh)`);
+        if (!pushed.ok) return fail(pushed.error);
+        const live = await awaitArticleLive(articleUrl);
 
         return ResultSchema.parse({
             ok: true,
             target: TARGET,
-            url: `https://surfdash.local/${locale}/posts/${slug}`,
-            message: 'Published successfully to Surfdash via postsurfing CLI',
-            // Absolute post path lets downstream steps (locale translation + CMS sync)
-            // derive the surfdash checkout root without extra configuration.
-            metadata: { postPath: filePath },
+            url: articleUrl,
+            message: live
+                ? 'Published, committed, pushed, and live on the site'
+                : 'Published and pushed; URL not live within the verify window — check the surfdash deploy workflow',
+            metadata: { postPath: filePath, gitCommit: pushed.hash, live },
         });
     } catch (err: unknown) {
         return fail(`Postsurfing transport error: ${err instanceof Error ? err.message : String(err)}`);

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

@@ -21849,6 +21849,26 @@ var ResultSchema = exports_external.object({
   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"),
+  metadata: exports_external.looseObject({
+    generator: exports_external.literal("kk:omni-voice-gen"),
+    audioPath: exports_external.string(),
+    duration: exports_external.number(),
+    segments: exports_external.array(exports_external.looseObject({
+      generationId: exports_external.string(),
+      profile: exports_external.string(),
+      speaker: exports_external.string().optional(),
+      emotion: exports_external.string().optional(),
+      duration: exports_external.number(),
+      verifyRetries: exports_external.number(),
+      transcription: exports_external.string().optional(),
+      loudnessDip: exports_external.boolean().optional()
+    })),
+    mp3Path: exports_external.string().optional(),
+    qc: exports_external.record(exports_external.string(), exports_external.unknown()).optional()
+  })
+});
 
 // ../../packages/kk-core/src/kinds.ts
 var PLUGIN_KINDS = ["ingestion", "generator", "publish"];