@gobing-ai/knowledge-kit 0.0.16 → 0.0.18

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

@@ -0,0 +1,17 @@
+{
+    "name": "@gobing-ai/substack-pub",
+    "type": "module",
+    "private": true,
+    "scripts": {
+        "typecheck": "tsc --noEmit"
+    },
+    "dependencies": {
+        "@gobing-ai/kk-core": "workspace:*",
+        "@gobing-ai/publish-harness": "workspace:*",
+        "@gobing-ai/ts-runtime": "catalog:",
+        "@gobing-ai/ts-utils": "catalog:"
+    },
+    "devDependencies": {
+        "@types/bun": "1.3.14"
+    }
+}

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

@@ -0,0 +1,7 @@
+{
+    "name": "substack-pub",
+    "kind": "publish",
+    "entry": "./dist/index.js",
+    "version": "1.0.0",
+    "description": "Publish plugin for Substack via browser/agent transport"
+}

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

@@ -0,0 +1,123 @@
+import { dirname } from 'node:path';
+import { parseArgs } from 'node:util';
+import { type Content, ContentSchema, type Result, ResultSchema } from '@gobing-ai/kk-core';
+import {
+    type BrowserDriver,
+    FakeBrowserTransport,
+    type PublishTransport,
+    type PublishTransportPayload,
+    resolveBrowserProfileDir,
+} from '@gobing-ai/publish-harness';
+import { createNodeFileSystem } from '@gobing-ai/ts-runtime';
+import { echoError } from '@gobing-ai/ts-utils';
+
+const CHANNEL = 'substack';
+const TARGET = 'substack';
+
+function fail(error: string): Result {
+    return ResultSchema.parse({ ok: false, target: TARGET, error });
+}
+
+function draftId(content: Content): string {
+    const title = content.title ?? 'untitled';
+    return `${CHANNEL}-draft-${title.length}`;
+}
+
+function draftResult(content: Content, driver: BrowserDriver, profileDir: string): Result {
+    return ResultSchema.parse({
+        ok: true,
+        target: TARGET,
+        id: draftId(content),
+        message: `${TARGET} draft prepared (unpublished)`,
+        metadata: { driver, publishStatus: 'draft', profileDir },
+    });
+}
+
+export class SubstackBrowserTransport implements PublishTransport {
+    public readonly kind = 'browser';
+    public readonly driver: BrowserDriver;
+    private readonly loginTimeoutMs: number;
+    private readonly sessionReady: boolean;
+
+    constructor(driver: BrowserDriver = 'agent', opts?: { loginTimeoutMs?: number; sessionReady?: boolean }) {
+        this.driver = driver;
+        this.loginTimeoutMs = opts?.loginTimeoutMs ?? 120_000;
+        this.sessionReady = opts?.sessionReady ?? false;
+    }
+
+    public async publish(payload: PublishTransportPayload): Promise<Result> {
+        const override =
+            typeof payload.options?.profileDir === 'string'
+                ? payload.options.profileDir
+                : (process.env.SUBSTACK_PROFILE_DIR ?? process.env.KK_BROWSER_PROFILE_DIR);
+        const profileDir = resolveBrowserProfileDir(CHANNEL, override);
+        if (!this.sessionReady) {
+            return fail(
+                `login timeout after ${this.loginTimeoutMs}ms: no authenticated ${CHANNEL} session in ${profileDir}`,
+            );
+        }
+        return draftResult(payload.content, this.driver, profileDir);
+    }
+}
+
+export function getPublishTransport(driver: BrowserDriver = 'agent'): PublishTransport {
+    if (process.env.KNOWLEDGE_KIT_PUBLISH_TRANSPORT === 'fake') {
+        return new FakeBrowserTransport(driver);
+    }
+    return new SubstackBrowserTransport(driver);
+}
+
+async function writePublishResult(outputPath: string, result: Result): Promise<void> {
+    const outDir = dirname(outputPath);
+    if (outDir && outDir !== '.') await createNodeFileSystem().ensureDir(outDir);
+    await createNodeFileSystem().writeFile(outputPath, JSON.stringify(result, null, 2));
+}
+
+export async function processPublishIO(
+    inputPath: string,
+    outputPath: string,
+    transport: PublishTransport = getPublishTransport(),
+): Promise<void> {
+    await createNodeFileSystem().deleteFile(outputPath);
+    let content: Content;
+    let options: Record<string, unknown> | undefined;
+    try {
+        const raw = JSON.parse(await createNodeFileSystem().readFile(inputPath)) as Record<string, unknown>;
+        content = ContentSchema.parse(raw);
+        if (raw.options !== undefined && typeof raw.options === 'object' && raw.options !== null) {
+            options = raw.options as Record<string, unknown>;
+        }
+    } catch (error: unknown) {
+        const message = `Invalid Content input: ${error instanceof Error ? error.message : String(error)}`;
+        await writePublishResult(outputPath, fail(message));
+        throw new Error(message);
+    }
+    const result = ResultSchema.parse(await transport.publish({ content, options }));
+    await writePublishResult(outputPath, result);
+    if (!result.ok) throw new Error(result.error ?? 'Publish failed');
+}
+
+export async function main(): Promise<number> {
+    let values: { in?: string; out?: string };
+    try {
+        ({ values } = parseArgs({ options: { in: { type: 'string' }, out: { type: 'string' } } }));
+    } catch (error: unknown) {
+        echoError(`Invalid arguments: ${error instanceof Error ? error.message : String(error)}`);
+        return 1;
+    }
+    if (!values.in || !values.out) {
+        echoError('Missing required arguments: --in and --out');
+        return 1;
+    }
+    try {
+        await processPublishIO(values.in, values.out);
+        return 0;
+    } catch (error: unknown) {
+        echoError(`substack-pub failed: ${error instanceof Error ? error.message : String(error)}`);
+        return 1;
+    }
+}
+
+if (import.meta.main) {
+    process.exit(await main());
+}

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

@@ -0,0 +1,4 @@
+{
+    "extends": "../../../tooling/typescript/base.json",
+    "include": ["src", "tests"]
+}

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

@@ -14665,72 +14665,6 @@ var init_zod = __esm(() => {
   init_external();
 });
 
-// ../../node_modules/.bun/@gobing-ai+ts-utils@0.4.39/node_modules/@gobing-ai/ts-utils/dist/errors.js
-var ErrorCode;
-var init_errors3 = __esm(() => {
-  ErrorCode = {
-    NotFound: "NOT_FOUND",
-    Validation: "VALIDATION",
-    Conflict: "CONFLICT",
-    Internal: "INTERNAL"
-  };
-});
-
-// ../../node_modules/.bun/@gobing-ai+ts-utils@0.4.39/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();
-  API_ERROR_CODES = {
-    SUCCESS: 0,
-    NOT_FOUND: 404,
-    VALIDATION_ERROR: 422,
-    BAD_REQUEST: 400,
-    UNAUTHORIZED: 401,
-    FORBIDDEN: 403,
-    CONFLICT: 409,
-    INTERNAL_ERROR: 500
-  };
-  ERROR_CODE_TO_HTTP = {
-    [ErrorCode.NotFound]: API_ERROR_CODES.NOT_FOUND,
-    [ErrorCode.Validation]: API_ERROR_CODES.VALIDATION_ERROR,
-    [ErrorCode.Conflict]: API_ERROR_CODES.CONFLICT,
-    [ErrorCode.Internal]: API_ERROR_CODES.INTERNAL_ERROR
-  };
-  CLIENT_SAFE_CODES = new Set([ErrorCode.NotFound, ErrorCode.Validation, ErrorCode.Conflict]);
-});
-
-// ../../node_modules/.bun/@gobing-ai+ts-utils@0.4.39/node_modules/@gobing-ai/ts-utils/dist/cursor.js
-var init_cursor = () => {};
-
-// ../../node_modules/.bun/@gobing-ai+ts-utils@0.4.39/node_modules/@gobing-ai/ts-utils/dist/event-severity.js
-var init_event_severity = () => {};
-
-// ../../node_modules/.bun/@gobing-ai+ts-utils@0.4.39/node_modules/@gobing-ai/ts-utils/dist/output.js
-function processStream(name) {
-  const proc = globalThis.process;
-  const stream = proc?.[name];
-  if (stream === undefined) {
-    throw new Error(`No ${name} target available: set one via setDefaultOutputTargets or pass an explicit target`);
-  }
-  return stream;
-}
-function writeLine(message, target) {
-  target.write(`${message}
-`);
-}
-function echoError(message, target = defaultStderrTarget ?? processStream("stderr")) {
-  writeLine(message, target);
-}
-var defaultStderrTarget;
-
-// ../../node_modules/.bun/@gobing-ai+ts-utils@0.4.39/node_modules/@gobing-ai/ts-utils/dist/index.js
-var init_dist = __esm(() => {
-  init_api_response();
-  init_cursor();
-  init_errors3();
-  init_event_severity();
-});
-
 // ../../node_modules/.bun/yaml@2.9.0/node_modules/yaml/dist/nodes/identity.js
 var require_identity = __commonJS((exports) => {
   var ALIAS = Symbol.for("yaml.alias");
@@ -17635,15 +17569,15 @@ var require_timestamp = __commonJS((exports) => {
         throw new Error("!!timestamp expects a date, starting with yyyy-mm-dd");
       const [, year, month, day, hour, minute, second] = match.map(Number);
       const millisec = match[7] ? Number((match[7] + "00").substr(1, 3)) : 0;
-      let date6 = Date.UTC(year, month - 1, day, hour || 0, minute || 0, second || 0, millisec);
+      let date5 = Date.UTC(year, month - 1, day, hour || 0, minute || 0, second || 0, millisec);
       const tz = match[8];
       if (tz && tz !== "Z") {
         let d = parseSexagesimal(tz, false);
         if (Math.abs(d) < 30)
           d *= 60;
-        date6 -= 60000 * d;
+        date5 -= 60000 * d;
       }
-      return new Date(date6);
+      return new Date(date5);
     },
     stringify: ({ value }) => value?.toISOString().replace(/(T00:00:00)?\.000Z$/, "") ?? ""
   };
@@ -19503,7 +19437,7 @@ var require_composer = __commonJS((exports) => {
   var node_process = __require("process");
   var directives = require_directives();
   var Document = require_Document();
-  var errors4 = require_errors();
+  var errors3 = require_errors();
   var identity = require_identity();
   var composeDoc = require_compose_doc();
   var resolveEnd = require_resolve_end();
@@ -19554,9 +19488,9 @@ var require_composer = __commonJS((exports) => {
       this.onError = (source, code, message, warning) => {
         const pos = getErrorPos(source);
         if (warning)
-          this.warnings.push(new errors4.YAMLWarning(pos, code, message));
+          this.warnings.push(new errors3.YAMLWarning(pos, code, message));
         else
-          this.errors.push(new errors4.YAMLParseError(pos, code, message));
+          this.errors.push(new errors3.YAMLParseError(pos, code, message));
       };
       this.directives = new directives.Directives({ version: options.version || "1.2" });
       this.options = options;
@@ -19642,7 +19576,7 @@ ${cb}` : comment;
           break;
         case "error": {
           const msg = token.source ? `${token.message}: ${JSON.stringify(token.source)}` : token.message;
-          const error51 = new errors4.YAMLParseError(getErrorPos(token), "UNEXPECTED_TOKEN", msg);
+          const error51 = new errors3.YAMLParseError(getErrorPos(token), "UNEXPECTED_TOKEN", msg);
           if (this.atDirectives || !this.doc)
             this.errors.push(error51);
           else
@@ -19652,7 +19586,7 @@ ${cb}` : comment;
         case "doc-end": {
           if (!this.doc) {
             const msg = "Unexpected doc-end without preceding document";
-            this.errors.push(new errors4.YAMLParseError(getErrorPos(token), "UNEXPECTED_TOKEN", msg));
+            this.errors.push(new errors3.YAMLParseError(getErrorPos(token), "UNEXPECTED_TOKEN", msg));
             break;
           }
           this.doc.directives.docEnd = true;
@@ -19667,7 +19601,7 @@ ${end.comment}` : end.comment;
           break;
         }
         default:
-          this.errors.push(new errors4.YAMLParseError(getErrorPos(token), "UNEXPECTED_TOKEN", `Unsupported token ${token.type}`));
+          this.errors.push(new errors3.YAMLParseError(getErrorPos(token), "UNEXPECTED_TOKEN", `Unsupported token ${token.type}`));
       }
     }
     *end(forceDoc = false, endOffset = -1) {
@@ -19693,7 +19627,7 @@ ${end.comment}` : end.comment;
 var require_cst_scalar = __commonJS((exports) => {
   var resolveBlockScalar = require_resolve_block_scalar();
   var resolveFlowScalar = require_resolve_flow_scalar();
-  var errors4 = require_errors();
+  var errors3 = require_errors();
   var stringifyString = require_stringifyString();
   function resolveAsScalar(token, strict = true, onError) {
     if (token) {
@@ -19702,7 +19636,7 @@ var require_cst_scalar = __commonJS((exports) => {
         if (onError)
           onError(offset, code, message);
         else
-          throw new errors4.YAMLParseError([offset, offset + 1], code, message);
+          throw new errors3.YAMLParseError([offset, offset + 1], code, message);
       };
       switch (token.type) {
         case "scalar":
@@ -21582,7 +21516,7 @@ var require_parser = __commonJS((exports) => {
 var require_public_api = __commonJS((exports) => {
   var composer = require_composer();
   var Document = require_Document();
-  var errors4 = require_errors();
+  var errors3 = require_errors();
   var log = require_log();
   var identity = require_identity();
   var lineCounter = require_line_counter();
@@ -21599,8 +21533,8 @@ var require_public_api = __commonJS((exports) => {
     const docs = Array.from(composer$1.compose(parser$1.parse(source)));
     if (prettyErrors && lineCounter2)
       for (const doc2 of docs) {
-        doc2.errors.forEach(errors4.prettifyError(source, lineCounter2));
-        doc2.warnings.forEach(errors4.prettifyError(source, lineCounter2));
+        doc2.errors.forEach(errors3.prettifyError(source, lineCounter2));
+        doc2.warnings.forEach(errors3.prettifyError(source, lineCounter2));
       }
     if (docs.length > 0)
       return docs;
@@ -21615,13 +21549,13 @@ var require_public_api = __commonJS((exports) => {
       if (!doc2)
         doc2 = _doc;
       else if (doc2.options.logLevel !== "silent") {
-        doc2.errors.push(new errors4.YAMLParseError(_doc.range.slice(0, 2), "MULTIPLE_DOCS", "Source contains multiple documents; please use YAML.parseAllDocuments()"));
+        doc2.errors.push(new errors3.YAMLParseError(_doc.range.slice(0, 2), "MULTIPLE_DOCS", "Source contains multiple documents; please use YAML.parseAllDocuments()"));
         break;
       }
     }
     if (prettyErrors && lineCounter2) {
-      doc2.errors.forEach(errors4.prettifyError(source, lineCounter2));
-      doc2.warnings.forEach(errors4.prettifyError(source, lineCounter2));
+      doc2.errors.forEach(errors3.prettifyError(source, lineCounter2));
+      doc2.warnings.forEach(errors3.prettifyError(source, lineCounter2));
     }
     return doc2;
   }
@@ -21673,12 +21607,12 @@ var require_public_api = __commonJS((exports) => {
 });
 
 // ../../node_modules/.bun/yaml@2.9.0/node_modules/yaml/dist/index.js
-var composer, Document, Schema, errors4, Alias, identity, Pair, Scalar, YAMLMap, YAMLSeq, cst, lexer, lineCounter, parser, publicApi, visit, $Composer, $Document, $Schema, $YAMLError, $YAMLParseError, $YAMLWarning, $Alias, $isAlias, $isCollection, $isDocument, $isMap, $isNode, $isPair, $isScalar, $isSeq, $Pair, $Scalar, $YAMLMap, $YAMLSeq, $Lexer, $LineCounter, $Parser, $parse, $parseAllDocuments, $parseDocument, $stringify, $visit, $visitAsync;
-var init_dist2 = __esm(() => {
+var composer, Document, Schema, errors3, Alias, identity, Pair, Scalar, YAMLMap, YAMLSeq, cst, lexer, lineCounter, parser, publicApi, visit, $Composer, $Document, $Schema, $YAMLError, $YAMLParseError, $YAMLWarning, $Alias, $isAlias, $isCollection, $isDocument, $isMap, $isNode, $isPair, $isScalar, $isSeq, $Pair, $Scalar, $YAMLMap, $YAMLSeq, $Lexer, $LineCounter, $Parser, $parse, $parseAllDocuments, $parseDocument, $stringify, $visit, $visitAsync;
+var init_dist = __esm(() => {
   composer = require_composer();
   Document = require_Document();
   Schema = require_Schema();
-  errors4 = require_errors();
+  errors3 = require_errors();
   Alias = require_Alias();
   identity = require_identity();
   Pair = require_Pair();
@@ -21694,9 +21628,9 @@ var init_dist2 = __esm(() => {
   $Composer = composer.Composer;
   $Document = Document.Document;
   $Schema = Schema.Schema;
-  $YAMLError = errors4.YAMLError;
-  $YAMLParseError = errors4.YAMLParseError;
-  $YAMLWarning = errors4.YAMLWarning;
+  $YAMLError = errors3.YAMLError;
+  $YAMLParseError = errors3.YAMLParseError;
+  $YAMLWarning = errors3.YAMLWarning;
   $Alias = Alias.Alias;
   $isAlias = identity.isAlias;
   $isCollection = identity.isCollection;
@@ -21724,7 +21658,7 @@ var init_dist2 = __esm(() => {
 // ../../node_modules/.bun/@gobing-ai+ts-runtime@0.4.39/node_modules/@gobing-ai/ts-runtime/dist/config.js
 var configSchema;
 var init_config = __esm(() => {
-  init_dist2();
+  init_dist();
   init_zod();
   configSchema = exports_external.object({
     app: exports_external.object({
@@ -21835,8 +21769,14 @@ var init_file_system_node = () => {};
 // ../../packages/publish-harness/src/index.ts
 var exports_src = {};
 __export(exports_src, {
-  FakeFileCliTransport: () => FakeFileCliTransport
+  trySelectors: () => trySelectors,
+  resolveBrowserProfileDir: () => resolveBrowserProfileDir,
+  launchPersistentBrowser: () => launchPersistentBrowser,
+  FakeFileCliTransport: () => FakeFileCliTransport,
+  FakeBrowserTransport: () => FakeBrowserTransport
 });
+import { homedir } from "os";
+import { join } from "path";
 
 class FakeFileCliTransport {
   kind = "file-cli";
@@ -21873,10 +21813,96 @@ class FakeFileCliTransport {
   }
 }
 
+class FakeBrowserTransport {
+  kind = "browser";
+  driver;
+  callLogs;
+  nextResult;
+  constructor(driver = "agent") {
+    this.driver = driver;
+    this.callLogs = [];
+  }
+  setNextResult(result) {
+    this.nextResult = result;
+  }
+  async publish(payload) {
+    this.callLogs.push({
+      timestamp: new Date().toISOString(),
+      payload
+    });
+    if (this.nextResult) {
+      return this.nextResult;
+    }
+    return {
+      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.callLogs;
+  }
+  reset() {
+    this.callLogs = [];
+    this.nextResult = undefined;
+  }
+}
+function resolveBrowserProfileDir(channel, override) {
+  if (override && override.trim().length > 0) {
+    const trimmed = override.trim();
+    if (trimmed.startsWith("~/")) {
+      return join(homedir(), trimmed.slice(2));
+    }
+    return trimmed;
+  }
+  return join(homedir(), ".config", "kk", "browser-profiles", channel);
+}
+async function trySelectors(page, selectors, options = {}) {
+  const timeout = options.timeout ?? 5000;
+  const visible = options.visible ?? true;
+  for (const selector of selectors) {
+    try {
+      const locator = page.locator(selector).first();
+      const attached = await locator.count() > 0;
+      if (!attached) {
+        continue;
+      }
+      if (visible) {
+        const isVisible = await locator.isVisible({ timeout: Math.min(timeout, 2000) }).catch(() => false);
+        if (!isVisible) {
+          continue;
+        }
+      }
+      return { found: true, selector };
+    } catch {}
+  }
+  return { found: false, selector: null };
+}
+async function launchPersistentBrowser(opts) {
+  let chromium;
+  try {
+    const playwright = await import("playwright");
+    chromium = playwright.chromium;
+  } catch (error51) {
+    const reason = error51 instanceof Error ? error51.message : String(error51);
+    throw new Error(`launchPersistentBrowser requires the playwright package on the caller's dependency tree: ${reason}`);
+  }
+  if (typeof chromium?.launchPersistentContext !== "function") {
+    throw new Error("launchPersistentBrowser requires the playwright package on the caller's dependency tree: chromium.launchPersistentContext is missing");
+  }
+  return chromium.launchPersistentContext(opts.profileDir, {
+    headless: opts.headless ?? false
+  });
+}
+var init_src = () => {};
+
 // ../../plugins/publishings/surfdash-pub/src/index.ts
-import { existsSync as existsSync2 } from "fs";
-import { copyFile, cp } from "fs/promises";
-import { dirname as dirname2, isAbsolute, join, resolve, sep } from "path";
+import { existsSync as existsSync2, readFileSync as readFileSync2 } from "fs";
+import { copyFile, cp, writeFile } from "fs/promises";
+import { dirname as dirname2, isAbsolute, join as join2, resolve, sep } from "path";
 import { parseArgs } from "util";
 
 // ../../packages/kk-core/src/kinds.ts
@@ -21953,10 +21979,27 @@ var PluginManifestSchema = exports_external.object({
 init_file_system_node();
 init_config();
 
+// ../../node_modules/.bun/@gobing-ai+ts-utils@0.4.67/node_modules/@gobing-ai/ts-utils/dist/output.js
+var defaultStderrTarget;
+function processStream(name) {
+  const proc = globalThis.process;
+  const stream = proc?.[name];
+  if (stream === undefined) {
+    throw new Error(`No ${name} target available: set one via setDefaultOutputTargets or pass an explicit target`);
+  }
+  return stream;
+}
+function writeLine(message, target) {
+  target.write(`${message}
+`);
+}
+function echoError(message, target = defaultStderrTarget ?? processStream("stderr")) {
+  writeLine(message, target);
+}
+
 // ../../packages/kk-core/src/render-md.ts
 if (false) {}
 // ../../plugins/publishings/surfdash-pub/src/index.ts
-init_dist();
 var TARGET = "surfdash";
 var OPERATIONS = ["publish", "scaffold-locale", "sync"];
 var SCAFFOLD_LOCALES = ["en", "ja"];
@@ -22146,9 +22189,9 @@ async function scaffoldLocale(options) {
     if (!existsSync2(draftPath)) {
       return fail(`sd translate reported success but the draft is missing: ${draftPath}`);
     }
-    const assetsDir = join(dirname2(postPath.postPath), "assets");
+    const assetsDir = join2(dirname2(postPath.postPath), "assets");
     if (existsSync2(assetsDir)) {
-      await cp(assetsDir, join(dirname2(draftPath), "assets"), { recursive: true });
+      await cp(assetsDir, join2(dirname2(draftPath), "assets"), { recursive: true });
     }
     return ResultSchema.parse({
       ok: true,
@@ -22160,6 +22203,21 @@ async function scaffoldLocale(options) {
     return fail(`scaffold-locale transport error: ${error51 instanceof Error ? error51.message : String(error51)}`);
   }
 }
+function normalizeLocaleFrontmatter(markdown) {
+  const lines = markdown.split(`
+`);
+  const inFrontmatter = lines[0]?.trim() === "---";
+  for (let i = 1;inFrontmatter && i < lines.length; i++) {
+    if (lines[i]?.trim() === "---")
+      break;
+    if (/^canonical\s*:/.test(lines[i] ?? ""))
+      lines[i] = "";
+    else if (/^draft\s*:/.test(lines[i] ?? ""))
+      lines[i] = "draft: false";
+  }
+  return lines.filter((line) => line !== "").join(`
+`);
+}
 async function syncPost(options) {
   const postPath = resolvePostPath(options);
   if ("error" in postPath)
@@ -22171,6 +22229,16 @@ async function syncPost(options) {
   const outsideRoot = postPathOutsideRoot(postPath.postPath, surfdashRoot);
   if (outsideRoot)
     return fail(outsideRoot);
+  for (const locale of ["en", "ja"]) {
+    const sibling = deriveLocaleDraftPath(postPath.postPath, locale);
+    if (!sibling || !existsSync2(sibling))
+      continue;
+    const normalized = normalizeLocaleFrontmatter(readFileSync2(sibling, "utf-8"));
+    if (normalized !== readFileSync2(sibling, "utf-8")) {
+      await writeFile(sibling, normalized);
+      echoError(`sync: normalized frontmatter for ${locale} sibling: ${sibling}`);
+    }
+  }
   try {
     const spawned = await spawnCli(["bun", "scripts/publish-orchestrator.ts", "sync", postPath.postPath], surfdashRoot);
     if (spawned.exitCode !== 0) {
@@ -22198,22 +22266,22 @@ async function publishPost(payload) {
   const dateStamp = runDate || today;
   const titleSlug = slugify2(payload.content.title ?? "");
   const slug = titleSlug ? `${dateStamp}-${titleSlug}` : `${dateStamp}-post`;
-  const postDir = join(surfdashRoot, "content", "posts", "articles", locale, slug);
+  const postDir = join2(surfdashRoot, "content", "posts", "articles", locale, slug);
   await createNodeFileSystem().ensureDir(postDir);
   let imageFrontmatter;
   const coverPath = payload.content.metadata?.coverImage;
   if (typeof coverPath === "string" && existsSync2(coverPath)) {
-    const assetsDir = join(postDir, "assets");
+    const assetsDir = join2(postDir, "assets");
     await createNodeFileSystem().ensureDir(assetsDir);
     const coverName = `cover${coverPath.slice(coverPath.lastIndexOf("."))}`;
-    await copyFile(coverPath, join(assetsDir, coverName));
+    await copyFile(coverPath, join2(assetsDir, coverName));
     imageFrontmatter = `./assets/${coverName}`;
   }
   const markdown = mapContentToSurfingMarkdown(payload.content, {
     image: imageFrontmatter,
     publishDate: runDate ? `${runDate.slice(0, 4)}-${runDate.slice(4, 6)}-${runDate.slice(6, 8)}` : undefined
   });
-  const filePath = join(postDir, "index.md");
+  const filePath = join2(postDir, "index.md");
   try {
     await createNodeFileSystem().writeFile(filePath, markdown);
     const spawned = await spawnCli([postsurfingBin, "publish", filePath], surfdashRoot);
@@ -22230,7 +22298,7 @@ async function publishPost(payload) {
         metadata: { postPath: filePath }
       });
     }
-    const relPostDir = join("content", "posts", "articles", locale, slug);
+    const relPostDir = join2("content", "posts", "articles", locale, slug);
     const pushed = await pushPostGit(surfdashRoot, relPostDir, `content: daily AI news ${dateStamp} (zh)`);
     if (!pushed.ok)
       return fail(pushed.error);
@@ -22266,7 +22334,7 @@ class PostsurfingFileCliTransport {
 }
 function getPublishTransport() {
   if (process.env.KNOWLEDGE_KIT_PUBLISH_TRANSPORT === "fake") {
-    const { FakeFileCliTransport: FakeFileCliTransport2 } = __toCommonJS(exports_src);
+    const { FakeFileCliTransport: FakeFileCliTransport2 } = (init_src(), __toCommonJS(exports_src));
     return new FakeFileCliTransport2;
   }
   return new PostsurfingFileCliTransport;
@@ -22315,6 +22383,7 @@ export {
   slugify2 as slugify,
   pushPostGit,
   processPublishIO,
+  normalizeLocaleFrontmatter,
   mapContentToSurfingMarkdown,
   main2 as main,
   getPublishTransport,

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

@@ -1,5 +1,5 @@
-import { existsSync } from 'node:fs';
-import { copyFile, cp } from 'node:fs/promises';
+import { existsSync, readFileSync } from 'node:fs';
+import { copyFile, cp, writeFile } from 'node:fs/promises';
 import { dirname, isAbsolute, join, resolve, sep } from 'node:path';
 import { parseArgs } from 'node:util';
 import { type Content, ContentSchema, type Result, ResultSchema } from '@gobing-ai/kk-core';
@@ -350,6 +350,25 @@ async function scaffoldLocale(options: SurfdashPubOptions): Promise<Result> {
  * `bun scripts/publish-orchestrator.ts sync <postPath>` inside the surfdash checkout
  * and returns ok/fail with stderr on failure.
  */
+/**
+ * Deterministic frontmatter normalization for locale siblings before CMS sync
+ * (2026-09-16 hreflang feedback): the site's alternates builder reads published
+ * disk siblings, so each non-primary locale must end `draft: false` and must not
+ * carry a stale cross-locale `canonical` (the translation agent sometimes copies
+ * zh frontmatter verbatim). Line-based — no YAML lib in this plugin. Backstop
+ * for the agent prompt; safe because sync always runs after the agent's edit.
+ */
+export function normalizeLocaleFrontmatter(markdown: string): string {
+    const lines = markdown.split('\n');
+    const inFrontmatter = lines[0]?.trim() === '---';
+    for (let i = 1; inFrontmatter && i < lines.length; i++) {
+        if (lines[i]?.trim() === '---') break;
+        if (/^canonical\s*:/.test(lines[i] ?? '')) lines[i] = '';
+        else if (/^draft\s*:/.test(lines[i] ?? '')) lines[i] = 'draft: false';
+    }
+    return lines.filter((line) => line !== '').join('\n');
+}
+
 async function syncPost(options: SurfdashPubOptions): Promise<Result> {
     const postPath = resolvePostPath(options);
     if ('error' in postPath) return fail(postPath.error);
@@ -361,6 +380,17 @@ async function syncPost(options: SurfdashPubOptions): Promise<Result> {
     const outsideRoot = postPathOutsideRoot(postPath.postPath, surfdashRoot);
     if (outsideRoot) return fail(outsideRoot);
 
+    // Normalize en/ja siblings (draft flag + stale canonical) before the orchestrator syncs them.
+    for (const locale of ['en', 'ja'] as const) {
+        const sibling = deriveLocaleDraftPath(postPath.postPath, locale);
+        if (!sibling || !existsSync(sibling)) continue;
+        const normalized = normalizeLocaleFrontmatter(readFileSync(sibling, 'utf-8'));
+        if (normalized !== readFileSync(sibling, 'utf-8')) {
+            await writeFile(sibling, normalized);
+            echoError(`sync: normalized frontmatter for ${locale} sibling: ${sibling}`);
+        }
+    }
+
     try {
         const spawned = await spawnCli(
             ['bun', 'scripts/publish-orchestrator.ts', 'sync', postPath.postPath],