@gobing-ai/knowledge-kit 0.1.9 → 0.1.10

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

@@ -12312,6 +12312,107 @@ async function writeJsonFile(path, value, fs = createNodeFileSystem()) {
 }
 // ../../packages/kk-core/src/render-md.ts
 if (false) {}
+// ../../packages/kk-core/src/sentences.ts
+var CJK_TERMINATORS = new Set(["\u3002", "\uFF01", "\uFF1F"]);
+var LATIN_TERMINATORS = new Set([".", "!", "?"]);
+var ATTACHED_CLOSERS = new Set(["\u201D", "\u2019", "\u300D", "\u300F", "\uFF09", ")", '"', "'"]);
+var OPEN_PAIRS = {
+  "\u300C": "\u300D",
+  "\u300E": "\u300F",
+  "\u201C": "\u201D",
+  "\uFF08": "\uFF09",
+  "(": ")"
+};
+var CLOSE_PAIRS = {
+  "\u300D": "\u300C",
+  "\u300F": "\u300E",
+  "\u201D": "\u201C",
+  "\uFF09": "\uFF08",
+  ")": "("
+};
+function splitSentences(text, options = {}) {
+  if (!text || typeof text !== "string")
+    return [];
+  const results = [];
+  let sentenceStart = 0;
+  let stack = [];
+  let i = 0;
+  const isTerminator = (c) => CJK_TERMINATORS.has(c) || options.cjkOnly !== true && LATIN_TERMINATORS.has(c);
+  while (i < text.length) {
+    const ch = text[i];
+    if (isTerminator(ch)) {
+      let termEnd = i;
+      let hasCjkTerm = false;
+      let hasLatinTerm = false;
+      while (termEnd < text.length) {
+        const termChar = text[termEnd];
+        if (!termChar || !isTerminator(termChar)) {
+          break;
+        }
+        if (CJK_TERMINATORS.has(termChar))
+          hasCjkTerm = true;
+        if (LATIN_TERMINATORS.has(termChar))
+          hasLatinTerm = true;
+        termEnd++;
+      }
+      let closerEnd = termEnd;
+      const tempStack = [...stack];
+      while (closerEnd < text.length) {
+        const closer = text[closerEnd];
+        if (!closer || !ATTACHED_CLOSERS.has(closer)) {
+          break;
+        }
+        const top = tempStack[tempStack.length - 1];
+        if (top !== undefined && top === closer) {
+          tempStack.pop();
+        } else if (CLOSE_PAIRS[closer]) {
+          const idx = tempStack.lastIndexOf(closer);
+          if (idx >= 0)
+            tempStack.splice(idx, 1);
+        }
+        closerEnd++;
+      }
+      let isBoundary = false;
+      if (tempStack.length === 0) {
+        if (hasCjkTerm) {
+          isBoundary = true;
+        } else if (hasLatinTerm) {
+          const nextChar = text[closerEnd];
+          if (closerEnd === text.length || nextChar !== undefined && /\s/.test(nextChar)) {
+            isBoundary = true;
+          }
+        }
+      }
+      if (isBoundary) {
+        const sentence = text.slice(sentenceStart, closerEnd).trim();
+        if (sentence.length > 0) {
+          results.push(sentence);
+        }
+        sentenceStart = closerEnd;
+        stack = tempStack;
+        i = closerEnd;
+        continue;
+      }
+    }
+    const openMatch = OPEN_PAIRS[ch];
+    const closeMatch = CLOSE_PAIRS[ch];
+    if (openMatch) {
+      stack.push(openMatch);
+    } else if (closeMatch) {
+      const idx = stack.lastIndexOf(ch);
+      if (idx >= 0)
+        stack.splice(idx, 1);
+    }
+    i++;
+  }
+  if (sentenceStart < text.length) {
+    const tail = text.slice(sentenceStart).trim();
+    if (tail.length > 0) {
+      results.push(tail);
+    }
+  }
+  return results;
+}
 // ../../packages/publish-harness/src/index.ts
 class FakeTransportCore {
   callLogs = [];
@@ -12514,8 +12615,8 @@ class MicrofeedClient {
 }
 
 // ../../plugins/publishings/podcast-pub/src/seo.ts
-init_dist();
 import { readFileSync as readFileSync2 } from "fs";
+init_dist();
 function codePointLength(value) {
   return Array.from(value).length;
 }
@@ -12869,11 +12970,7 @@ function clauseFromTitle(title) {
   return cut.replace(/\s+/g, " ").trim();
 }
 function firstSentence(text) {
-  const trimmed = text.replace(/\s+/g, " ").trim();
-  if (trimmed.length === 0)
-    return "";
-  const parts = trimmed.split(/(?<=[\u3002\uFF01\uFF1F.!?])/);
-  return (parts[0] ?? trimmed).trim();
+  return splitSentences(text.replace(/\s+/g, " ").trim())[0] ?? "";
 }
 function planItemsFromMetadata(metadata) {
   const raw = podcastOf(metadata).planItems;
@@ -13869,7 +13966,7 @@ function itemBrief(d) {
   const meta = d.metadata ?? {};
   if (typeof meta.brief === "string" && meta.brief.trim().length > 0)
     return meta.brief.trim();
-  return (d.body ?? "").trim().split(/(?<=[\u3002\uFF01\uFF1F])\s*/).slice(0, 2).join("");
+  return splitSentences((d.body ?? "").trim(), { cjkOnly: true }).slice(0, 2).join("");
 }
 function renderShowNotesMarkdown(docs, opts, warnings) {
   const slugify = (t) => {
@@ -13937,7 +14034,7 @@ function renderShowNotesMarkdown(docs, opts, warnings) {
   } else {
     docs.forEach((d, i) => {
       const body = (d.body ?? "").trim();
-      const sentences = body.split(/(?<=[\u3002\uFF01\uFF1F])\s*/).slice(0, 2).join("");
+      const sentences = splitSentences(body, { cjkOnly: true }).slice(0, 2).join("");
       lines.push(`## ${i + 1}. ${d.title ?? `\u6761\u76EE ${i + 1}`}`, "", sentences, "", `[\u6765\u6E90\uFF1A${sourceLabel(d)}](${d.sourceUri ?? ""})`, "");
     });
     lines.push(`\u8BE6\u60C5\u89C1\u672C\u671F\u5B8C\u6574\u6587\u7AE0\uFF1A[ ${opts.title} ](${articleUrl})`, "");

package/plugins/publishings/podcast-pub/src/seo.ts

@@ -12,6 +12,7 @@
  */
 
 import { readFileSync } from 'node:fs';
+import { splitSentences } from '@gobing-ai/kk-core';
 import { echoError } from '@gobing-ai/ts-utils';
 
 /** Code-point length. Microfeed counts the same way for slugs and SEO limits. */
@@ -506,10 +507,7 @@ export function clauseFromTitle(title: string): string {
 }
 
 export function firstSentence(text: string): string {
-    const trimmed = text.replace(/\s+/g, ' ').trim();
-    if (trimmed.length === 0) return '';
-    const parts = trimmed.split(/(?<=[。！？.!?])/);
-    return (parts[0] ?? trimmed).trim();
+    return splitSentences(text.replace(/\s+/g, ' ').trim())[0] ?? '';
 }
 
 export function planItemsFromMetadata(metadata: Record<string, unknown> | undefined): PlanItem[] {

package/plugins/publishings/podcast-pub/src/show-notes.ts

@@ -11,7 +11,7 @@
  * input is escaped first, and only the tags this module emits reach the API.
  */
 
-import type { Doc } from '@gobing-ai/kk-core';
+import { type Doc, splitSentences } from '@gobing-ai/kk-core';
 import {
     type PlanItem,
     type PodcastSeoConfig,
@@ -311,9 +311,7 @@ export interface ShowNotesRenderOptions {
 function itemBrief(d: Doc): string {
     const meta = d.metadata ?? {};
     if (typeof meta.brief === 'string' && meta.brief.trim().length > 0) return meta.brief.trim();
-    return (d.body ?? '')
-        .trim()
-        .split(/(?<=[。！？])\s*/)
+    return splitSentences((d.body ?? '').trim(), { cjkOnly: true })
         .slice(0, 2)
         .join('');
 }
@@ -407,10 +405,7 @@ export function renderShowNotesMarkdown(docs: Doc[], opts: ShowNotesRenderOption
     } else {
         docs.forEach((d, i) => {
             const body = (d.body ?? '').trim();
-            const sentences = body
-                .split(/(?<=[。！？])\s*/)
-                .slice(0, 2)
-                .join('');
+            const sentences = splitSentences(body, { cjkOnly: true }).slice(0, 2).join('');
             lines.push(
                 `## ${i + 1}. ${d.title ?? `条目 ${i + 1}`}`,
                 '',

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

@@ -12254,6 +12254,10 @@ init_config();
 
 // ../../packages/kk-core/src/render-md.ts
 if (false) {}
+// ../../packages/kk-core/src/sentences.ts
+var CJK_TERMINATORS = new Set(["\u3002", "\uFF01", "\uFF1F"]);
+var LATIN_TERMINATORS = new Set([".", "!", "?"]);
+var ATTACHED_CLOSERS = new Set(["\u201D", "\u2019", "\u300D", "\u300F", "\uFF09", ")", '"', "'"]);
 // ../../packages/publish-harness/src/index.ts
 class FakeTransportCore {
   callLogs = [];

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

@@ -20163,6 +20163,10 @@ init_runtime_node_bun();
 
 // ../../packages/kk-core/src/render-md.ts
 if (false) {}
+// ../../packages/kk-core/src/sentences.ts
+var CJK_TERMINATORS = new Set(["\u3002", "\uFF01", "\uFF1F"]);
+var LATIN_TERMINATORS = new Set([".", "!", "?"]);
+var ATTACHED_CLOSERS = new Set(["\u201D", "\u2019", "\u300D", "\u300F", "\uFF09", ")", '"', "'"]);
 // ../../packages/publish-harness/src/index.ts
 import { homedir } from "os";
 import { join, resolve } from "path";

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

@@ -20163,6 +20163,10 @@ init_runtime_node_bun();
 
 // ../../packages/kk-core/src/render-md.ts
 if (false) {}
+// ../../packages/kk-core/src/sentences.ts
+var CJK_TERMINATORS = new Set(["\u3002", "\uFF01", "\uFF1F"]);
+var LATIN_TERMINATORS = new Set([".", "!", "?"]);
+var ATTACHED_CLOSERS = new Set(["\u201D", "\u2019", "\u300D", "\u300F", "\uFF09", ")", '"', "'"]);
 // ../../packages/publish-harness/src/index.ts
 import { homedir } from "os";
 import { join, resolve } from "path";

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

@@ -20163,6 +20163,10 @@ init_runtime_node_bun();
 
 // ../../packages/kk-core/src/render-md.ts
 if (false) {}
+// ../../packages/kk-core/src/sentences.ts
+var CJK_TERMINATORS = new Set(["\u3002", "\uFF01", "\uFF1F"]);
+var LATIN_TERMINATORS = new Set([".", "!", "?"]);
+var ATTACHED_CLOSERS = new Set(["\u201D", "\u2019", "\u300D", "\u300F", "\uFF09", ")", '"', "'"]);
 // ../../packages/publish-harness/src/index.ts
 import { homedir } from "os";
 import { join, resolve } from "path";

package/plugins/publishings/substack-pub/dist/profile-check.js

@@ -20972,6 +20972,10 @@ var PluginManifestSchema = PluginManifestSchemaBase.superRefine((manifest, ctx)
 });
 // ../../packages/kk-core/src/render-md.ts
 if (false) {}
+// ../../packages/kk-core/src/sentences.ts
+var CJK_TERMINATORS = new Set(["\u3002", "\uFF01", "\uFF1F"]);
+var LATIN_TERMINATORS = new Set([".", "!", "?"]);
+var ATTACHED_CLOSERS = new Set(["\u201D", "\u2019", "\u300D", "\u300F", "\uFF09", ")", '"', "'"]);
 // ../../plugins/publishings/substack-pub/src/index.ts
 var CHANNEL = "substack";
 var LOGIN_URL_RE = /(\/sign-in|substack\.com\/account\/login)/;

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

@@ -12345,6 +12345,10 @@ init_config();
 
 // ../../packages/kk-core/src/render-md.ts
 if (false) {}
+// ../../packages/kk-core/src/sentences.ts
+var CJK_TERMINATORS = new Set(["\u3002", "\uFF01", "\uFF1F"]);
+var LATIN_TERMINATORS = new Set([".", "!", "?"]);
+var ATTACHED_CLOSERS = new Set(["\u201D", "\u2019", "\u300D", "\u300F", "\uFF09", ")", '"', "'"]);
 // ../../plugins/publishings/surfdash-pub/src/index.ts
 init_dist();
 
@@ -12360,11 +12364,17 @@ function localeIndexPath(postPath, locale) {
     return;
   return `${postPath.slice(0, idx)}${sep}${locale}${sep}${postPath.slice(idx + marker.length)}`;
 }
+var SERIES_NAMES = {
+  zh: "\u6BCF\u65E5AI\u4E71\u7096",
+  en: "Daily AI Stew",
+  ja: "\u30C7\u30A4\u30EA\u30FCAI\u30B7\u30C1\u30E5\u30FC"
+};
 function crossLinkFor(locale, dateIso, showNotesUrl) {
+  const series = SERIES_NAMES[locale];
   const links = {
-    zh: `\uD83C\uDFA7 \u672C\u671F\u5DF2\u540C\u6B65\u5236\u4F5C\u4E3A\u64AD\u5BA2\u8282\u76EE\uFF0C[\u70B9\u51FB\u6536\u542C\u300A\u6BCF\u65E5AI\u4E71\u7096 \xB7 ${dateIso}\u300B](${showNotesUrl})\u3002`,
-    en: `\uD83C\uDFA7 This episode is also available as a podcast: [listen to \u6BCF\u65E5AI\u4E71\u7096 \xB7 ${dateIso}](${showNotesUrl}).`,
-    ja: `\uD83C\uDFA7 \u672C\u30A8\u30D4\u30BD\u30FC\u30C9\u306F\u30DD\u30C3\u30C9\u30AD\u30E3\u30B9\u30C8\u3067\u3082\u914D\u4FE1\u4E2D\uFF1A[\u6BCF\u65E5AI\u4E71\u7096 \xB7 ${dateIso} \u3092\u8074\u304F](${showNotesUrl})\u3002`
+    zh: `\uD83C\uDFA7 \u672C\u671F\u5DF2\u540C\u6B65\u5236\u4F5C\u4E3A\u64AD\u5BA2\u8282\u76EE\uFF0C[\u70B9\u51FB\u6536\u542C\u300A${series} \xB7 ${dateIso}\u300B](${showNotesUrl})\u3002`,
+    en: `\uD83C\uDFA7 This episode is also available as a podcast: [listen to ${series} \xB7 ${dateIso}](${showNotesUrl}).`,
+    ja: `\uD83C\uDFA7 \u672C\u30A8\u30D4\u30BD\u30FC\u30C9\u306F\u30DD\u30C3\u30C9\u30AD\u30E3\u30B9\u30C8\u3067\u3082\u914D\u4FE1\u4E2D\uFF1A[${series} \xB7 ${dateIso} \u3092\u8074\u304F](${showNotesUrl})\u3002`
   };
   return links[locale];
 }
@@ -12402,10 +12412,16 @@ async function patchPostFiles(request) {
     const end = frontmatterEnd(md);
     const fm = end < 0 ? md : md.slice(0, end);
     if (request.coverUrl !== "") {
+      if (!/^https:\/\//.test(request.coverUrl)) {
+        throw new Error(`coverUrl must be an absolute https:// URL, got: ${request.coverUrl}`);
+      }
       md = upsertFrontmatterKey(md, "image", request.coverUrl);
       md = upsertFrontmatterKey(md, "og_image", request.coverUrl);
       images[locale] = request.coverUrl;
-    } else if (!/^image:/m.test(fm) && await fs.exists(request.localCover)) {
+    } else if (!/^image:/m.test(fm)) {
+      if (!await fs.exists(request.localCover)) {
+        throw new Error(`${locale} post has no cover: coverUrl is empty, the frontmatter has no image key, and localCover does not exist (${request.localCover})`);
+      }
       const asset = join(dir, "assets", "cover.png");
       await fs.ensureDir(dirname2(asset));
       await fs.copy(request.localCover, asset);
@@ -12414,11 +12430,20 @@ async function patchPostFiles(request) {
       md = upsertFrontmatterKey(md, "og_image", "./assets/cover.png");
       images[locale] = "./assets/cover.png";
     }
-    if (request.showNotesUrl !== "" && !md.includes(request.showNotesUrl)) {
-      md = `${md.replace(/\s*$/, "")}
+    if (request.showNotesUrl !== "") {
+      const link = crossLinkFor(locale, request.dateIso, request.showNotesUrl);
+      const lines = md.split(`
+`);
+      const carriesUrl = lines.some((line) => line.includes(request.showNotesUrl));
+      if (!carriesUrl) {
+        md = `${md.replace(/\s*$/, "")}
 
-${crossLinkFor(locale, request.dateIso, request.showNotesUrl)}
+${link}
 `;
+      } else {
+        md = lines.map((line) => line.includes(request.showNotesUrl) && line.trimStart().startsWith("\uD83C\uDFA7") ? link : line).join(`
+`);
+      }
     }
     if (md !== before) {
       await fs.writeFile(indexMd, md);
@@ -12433,6 +12458,172 @@ ${crossLinkFor(locale, request.dateIso, request.showNotesUrl)}
   return { written, changed, absent, images, slug: basename(dirname2(request.postPath)) };
 }
 
+// ../../plugins/publishings/surfdash-pub/src/digest-check.ts
+var DIGEST_TAG = "sub-category:ai-daily";
+var PODCAST_INTROS = ["\u8FD9\u91CC\u662F\u7531Robin", "\u54B8\u8BDD\u54B8\u8BF4", "This is Robin", "Robin \u304C\u304A\u5C4A\u3051"];
+var SEO_TITLE_LIMIT = 60;
+var KEY_LINE = /^([A-Za-z_][A-Za-z0-9_-]*):(.*)$/;
+var escapeRe = (token) => token.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+function unquote(value) {
+  if (value.length >= 2 && value.startsWith('"') && value.endsWith('"')) {
+    try {
+      return JSON.parse(value);
+    } catch {
+      return value.slice(1, -1);
+    }
+  }
+  if (value.length >= 2 && value.startsWith("'") && value.endsWith("'")) {
+    return value.slice(1, -1).replaceAll("''", "'");
+  }
+  return value;
+}
+function parseFrontmatterScalars(markdown) {
+  const out = new Map;
+  const lines = markdown.split(/\r?\n/);
+  if (lines[0]?.trim() !== "---")
+    return out;
+  const end = lines.findIndex((line, i) => i > 0 && line.trim() === "---");
+  if (end < 0)
+    return out;
+  for (let i = 1;i < end; i++) {
+    const line = lines[i];
+    if (!line)
+      continue;
+    const match = line.match(KEY_LINE);
+    if (!match?.[1] || match[2] === undefined)
+      continue;
+    const key = match[1];
+    const value = match[2].trim();
+    if (value === ">-" || value === ">" || value === ">+" || value === "|-" || value === "|") {
+      const parts = [];
+      let j = i + 1;
+      while (j < end) {
+        const continuation = lines[j];
+        if (!continuation || !/^[ \t]+\S/.test(continuation))
+          break;
+        parts.push(continuation.trim());
+        j++;
+      }
+      out.set(key, parts.join(" "));
+      i = j - 1;
+      continue;
+    }
+    if (value === "") {
+      const items = [];
+      let j = i + 1;
+      while (j < end) {
+        const itemLine = lines[j];
+        if (!itemLine || !/^\s*-\s+/.test(itemLine))
+          break;
+        items.push(unquote(itemLine.replace(/^\s*-\s+/, "").trim()));
+        j++;
+      }
+      if (items.length > 0) {
+        out.set(key, items);
+        i = j - 1;
+      } else {
+        out.set(key, "");
+      }
+      continue;
+    }
+    if (value.startsWith("[") && value.endsWith("]")) {
+      out.set(key, value.slice(1, -1).split(",").map((item) => unquote(item.trim())).filter((item) => item !== ""));
+      continue;
+    }
+    out.set(key, unquote(value));
+  }
+  return out;
+}
+function scalar(frontmatter, key) {
+  const value = frontmatter.get(key);
+  if (value === undefined)
+    return;
+  return Array.isArray(value) ? value.join(" ") : value;
+}
+function endsAsSentence(text, locale) {
+  return locale === "en" ? /[.!?]["')\u201D\u2019]*$/u.test(text.trimEnd()) : /[\u3002\uFF01\uFF1F][\u300D\u300F\u201D\uFF09]*$/u.test(text.trimEnd());
+}
+function checkDigestFrontmatter(markdown, locale) {
+  const frontmatter = parseFrontmatterScalars(markdown);
+  const tags = frontmatter.get("tags");
+  const tagList = Array.isArray(tags) ? tags : typeof tags === "string" && tags !== "" ? [tags] : [];
+  if (!tagList.some((tag) => tag.includes(DIGEST_TAG)))
+    return [];
+  const problems = [];
+  const series = SERIES_NAMES[locale];
+  const titleSep = locale === "en" ? ": " : "\uFF1A";
+  const listSep = locale === "en" ? ", " : "\u3001";
+  const title = scalar(frontmatter, "title");
+  if (title === undefined || title === "") {
+    problems.push("title: missing");
+  } else {
+    const match = title.match(new RegExp(`^${escapeRe(series)} \xB7 (\\d{4}-\\d{2}-\\d{2})${escapeRe(titleSep)}(.+)$`));
+    if (!match) {
+      problems.push(`title: expected "<series> \xB7 YYYY-MM-DD${titleSep}<h1>${listSep}<h2>" for ${series}, got "${title}"`);
+    } else {
+      const rest = match[2] ?? "";
+      const heads = locale === "en" ? rest.split(", ") : rest.split("\u3001");
+      const seps = locale === "en" ? (rest.match(/, /g) ?? []).length : (rest.match(/\u3001/g) ?? []).length;
+      if (seps !== 1 || heads.some((head) => head.trim() === "")) {
+        problems.push(`title: expected exactly two non-empty headlines joined "${listSep}", got "${rest}"`);
+      }
+    }
+    const seoTitle = `${title} | Surfing`;
+    const seoLength = Array.from(seoTitle).length;
+    if (seoLength > SEO_TITLE_LIMIT) {
+      problems.push(`title: "${seoTitle}" is ${seoLength} code points (max ${SEO_TITLE_LIMIT})`);
+    }
+    if (title.includes("\u2026") || title.includes("..."))
+      problems.push('title: contains "\u2026" or "..."');
+  }
+  const description = scalar(frontmatter, "description");
+  const [min, max] = locale === "en" ? [120, 155] : [70, 100];
+  if (description === undefined || description === "") {
+    problems.push("description: missing");
+  } else {
+    const length = Array.from(description).length;
+    if (length < min || length > max) {
+      problems.push(`description: ${length} code points (expected ${min}\u2013${max} for ${locale})`);
+    }
+    if (!endsAsSentence(description, locale)) {
+      problems.push("description: does not end with sentence punctuation");
+    }
+    const lower = description.toLowerCase();
+    const intro = PODCAST_INTROS.find((candidate) => lower.startsWith(candidate.toLowerCase()));
+    if (intro)
+      problems.push(`description: starts with the podcast intro ("${intro}")`);
+    if (description.includes("\u2026") || description.includes("...")) {
+      problems.push('description: contains "\u2026" or "..."');
+    }
+  }
+  const points = frontmatter.get("key_points");
+  if (!Array.isArray(points) || points.length === 0) {
+    problems.push("key_points: missing");
+  } else {
+    const labelMax = locale === "en" ? 28 : 14;
+    points.forEach((point, index) => {
+      const sep = point.indexOf(" \u2014 ");
+      if (sep < 0) {
+        problems.push(`key_points[${index}]: missing " \u2014 " separator`);
+        return;
+      }
+      const label = point.slice(0, sep);
+      const text = point.slice(sep + 3);
+      const labelLength = Array.from(label).length;
+      if (labelLength === 0 || labelLength > labelMax) {
+        problems.push(`key_points[${index}]: label "${label}" is ${labelLength} code points (max ${labelMax})`);
+      }
+      if (!endsAsSentence(text, locale)) {
+        problems.push(`key_points[${index}]: text does not end with sentence punctuation`);
+      }
+      if (point.includes("\u2026") || point.includes("...")) {
+        problems.push(`key_points[${index}]: contains "\u2026" or "..."`);
+      }
+    });
+  }
+  return problems;
+}
+
 // ../../plugins/publishings/surfdash-pub/src/index.ts
 var TARGET = "surfdash";
 var OPERATIONS = ["publish", "scaffold-locale", "sync", "patch"];
@@ -12449,34 +12640,29 @@ function normalizeTag(raw) {
   }
   return slugify2(raw);
 }
-function mapContentToSurfingMarkdown(content, options = {}) {
-  let title = content.title;
-  if (!title) {
-    const match = content.body.match(/^#\s+(.+)$/m);
-    title = match?.[1] ? match[1].trim() : "Untitled Post";
-  }
-  let description;
-  if (typeof content.metadata?.description === "string") {
-    description = content.metadata.description;
-  } else {
-    const paragraphs = content.body.split(/\n\s*\n/).map((p) => p.replace(/^#+\s+.*$/, "").trim()).filter((p) => p.length > 0);
-    if (paragraphs.length > 0) {
-      description = paragraphs[0];
-    }
-  }
+function contentTags(content) {
   const rawTags = Array.isArray(content.metadata?.tags) ? [...content.metadata.tags] : Array.isArray(content.metadata?.keywords) ? [...content.metadata.keywords] : [];
   if (typeof content.metadata?.subCategory === "string" && content.metadata.subCategory.trim().length > 0) {
     const subRaw = content.metadata.subCategory.trim();
     rawTags.push(/^sub-category\s*:/i.test(subRaw) ? subRaw : `sub-category:${subRaw}`);
   }
-  const tags = [
+  return [
     ...new Set(rawTags.filter((t) => typeof t === "string" && t.trim().length > 0).map((t) => normalizeTag(t)))
   ].filter((tag) => tag.length > 0);
+}
+function mapContentToSurfingMarkdown(content, options = {}) {
+  let title = content.title;
+  if (!title) {
+    const match = content.body.match(/^#\s+(.+)$/m);
+    title = match?.[1] ? match[1].trim() : "Untitled Post";
+  }
+  const description = typeof content.metadata?.description === "string" && content.metadata.description.length > 0 ? content.metadata.description : "";
+  const tags = contentTags(content);
   const isoDate = options.publishDate ?? new Date().toISOString().slice(0, 10);
   const draft = typeof content.metadata?.published === "boolean" ? !content.metadata.published : false;
   const frontmatterObj = {
     title,
-    description: description ?? "",
+    description,
     tags,
     publishDate: isoDate,
     draft,
@@ -12489,6 +12675,9 @@ function mapContentToSurfingMarkdown(content, options = {}) {
 ${content.body.trim()}
 `;
 }
+function isDigestContent(content) {
+  return contentTags(content).some((tag) => tag.includes(DIGEST_TAG));
+}
 function fail(error) {
   return ResultSchema.parse({ ok: false, target: TARGET, error });
 }
@@ -12549,7 +12738,8 @@ async function spawnCli(cmd, cwd) {
   const proc = Bun.spawn(cmd, {
     cwd,
     stdout: "pipe",
-    stderr: "pipe"
+    stderr: "pipe",
+    env: process.env
   });
   const [exitCode, stdout, stderr] = await Promise.all([
     proc.exited,
@@ -12594,6 +12784,17 @@ function requireRefined(filePath) {
     return;
   return `surfdash refine step did not run for ${filePath} (no \`refined: true\`): the publishing pipeline is broken \u2014 the post would ship with generator-supplied SEO metadata`;
 }
+function digestCheckGate(filePath, locale) {
+  const problems = checkDigestFrontmatter(readFileSync2(filePath, "utf-8"), locale);
+  if (problems.length === 0)
+    return;
+  if (process.env.SURFDASH_DIGEST_CHECK === "warn") {
+    for (const problem of problems)
+      echoError(`digest check (warn): ${problem}`);
+    return;
+  }
+  return `digest frontmatter check failed: ${problems.join("; ")}`;
+}
 async function pushPostGit(surfdashRoot, relPostDir, message) {
   return commitPostPaths(surfdashRoot, [relPostDir], message);
 }
@@ -12770,6 +12971,12 @@ async function syncPost(options) {
     if (spawned.exitCode !== 0) {
       return fail(`publish-orchestrator sync failed (exit ${spawned.exitCode}): ${withEmdashTokenHint(cliErrorText(spawned))}`);
     }
+    const localeInPath = postPath.postPath.match(/[\\/]content[\\/]posts[\\/]articles[\\/](zh|en|ja)[\\/]/);
+    if (localeInPath) {
+      const digestProblem = digestCheckGate(postPath.postPath, localeInPath[1]);
+      if (digestProblem)
+        return fail(digestProblem);
+    }
     return ResultSchema.parse({
       ok: true,
       target: TARGET,
@@ -12874,12 +13081,18 @@ async function publishPost(payload) {
     return fail(`post path escapes ${articlesRoot}`);
   }
   const coverPath = payload.content.metadata?.coverImage;
-  if (typeof coverPath === "string" && existsSync2(coverPath) && !COVER_EXTS.has(extname(coverPath).toLowerCase())) {
+  if (typeof coverPath === "string" && !existsSync2(coverPath)) {
+    return fail(`metadata.coverImage not found: ${coverPath}`);
+  }
+  if (typeof coverPath === "string" && !COVER_EXTS.has(extname(coverPath).toLowerCase())) {
     return fail(`metadata.coverImage must be one of ${[...COVER_EXTS].join(", ")}`);
   }
+  if (isDigestContent(payload.content) && typeof coverPath !== "string") {
+    return fail("digest post has no cover image (metadata.coverImage)");
+  }
   await createNodeFileSystem().ensureDir(postDir);
   let imageFrontmatter;
-  if (typeof coverPath === "string" && existsSync2(coverPath)) {
+  if (typeof coverPath === "string") {
     const assetsDir = join2(postDir, "assets");
     await createNodeFileSystem().ensureDir(assetsDir);
     const coverName = `cover${extname(coverPath).toLowerCase()}`;
@@ -12900,6 +13113,9 @@ async function publishPost(payload) {
     const notRefined = requireRefined(filePath);
     if (notRefined)
       return fail(notRefined);
+    const digestProblem = digestCheckGate(filePath, locale);
+    if (digestProblem)
+      return fail(digestProblem);
     const refined = readRefinedSnapshot(filePath);
     const baseUrl = (process.env.SURFDASH_URL ?? "https://surfing.salty.vip").replace(/\/$/, "");
     const articleUrl = `${baseUrl}${locale === "en" ? "" : `/${locale}`}/posts/${slug}`;
@@ -12999,9 +13215,13 @@ if (import.meta.main) {
   process.exit(await main2());
 }
 export {
+  DIGEST_TAG,
   PostsurfingFileCliTransport,
   awaitArticleLive,
+  checkDigestFrontmatter,
   commitPostPaths,
+  contentTags,
+  digestCheckGate,
   fastForwardToOrigin,
   getPublishTransport,
   main2 as main,