@gobing-ai/knowledge-kit 0.1.9 → 0.1.10

package/.claude-plugin/marketplace.json

@@ -6,7 +6,7 @@
     },
     "plugins": [
         {
-            "version": "0.1.9",
+            "version": "0.1.10",
             "name": "kk",
             "source": "./plugins/kk",
             "description": "knowledge-kit — a set of toolkit for knowledge management"

package/dist/index.js

@@ -42385,6 +42385,10 @@ function getByName(result, name) {
 }
 // ../../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", ")", '"', "'"]);
 // src/invoke.ts
 init_dist();
 

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gobing-ai/knowledge-kit",
-    "version": "0.1.9",
+    "version": "0.1.10",
     "description": "An ingest → create → publish content pipeline CLI (Bun).",
     "repository": {
         "type": "git",

package/plugins/generations/content-gen/dist/index.js

@@ -12253,6 +12253,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/generations/content-gen/src/index.ts
 init_dist();
 

package/plugins/generations/core-facts-gen/dist/index.js

@@ -12319,6 +12319,10 @@ function uniqueToken() {
 }
 // ../../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/generations/core-facts-gen/src/index.ts
 init_dist();
 function sourceFileOf(entry) {

package/plugins/generations/daily-article-gen/dist/index.js

@@ -12319,6 +12319,10 @@ function uniqueToken() {
 }
 // ../../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/generations/daily-article-gen/src/index.ts
 init_dist();
 function sourceLabelOf(doc) {

package/plugins/generations/dailynews-gen/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", ")", '"', "'"]);
 // ../../plugins/generations/dailynews-gen/src/index.ts
 init_dist();
 

package/plugins/generations/episode-plan-gen/dist/index.js

@@ -12319,6 +12319,107 @@ function uniqueToken() {
 }
 // ../../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;
+}
 // ../../plugins/generations/episode-plan-gen/src/index.ts
 init_dist();
 var SOURCE_BASE = {
@@ -12731,7 +12832,7 @@ function planEpisode(docs, options) {
   return selected.map((r) => {
     const meta = asRecord(r.doc.metadata);
     const ascii = asciiRatio(r.doc.title ?? "");
-    const brief = (r.doc.body ?? "").trim().split(/(?<=[\u3002\uFF01\uFF1F])\s*/).slice(0, 2).join("");
+    const brief = splitSentences((r.doc.body ?? "").trim(), { cjkOnly: true }).slice(0, 2).join("");
     const published = docTimestamp(r.doc);
     return {
       ...r.doc,

package/plugins/generations/episode-plan-gen/src/index.ts

@@ -1,6 +1,6 @@
 import { dirname } from 'node:path';
 import { parseArgs } from 'node:util';
-import { type Content, ContentSchema, type Doc, DocListSchema } from '@gobing-ai/kk-core';
+import { type Content, ContentSchema, type Doc, DocListSchema, splitSentences } from '@gobing-ai/kk-core';
 import { atomicWriteJson, createNodeFileSystem, readJsonFile } from '@gobing-ai/ts-runtime';
 import { echoError } from '@gobing-ai/ts-utils';
 
@@ -597,9 +597,7 @@ export function planEpisode(docs: Doc[], options: PlanOptions): Doc[] {
         // Task 0118: 1–2-sentence briefing (first two 。！？-terminated sentences of the
         // cleaned body) + best-effort publish timestamp ride the plan metadata so the
         // podcast show-notes brief/timeline render stays deterministic, no LLM.
-        const brief = (r.doc.body ?? '')
-            .trim()
-            .split(/(?<=[。！？])\s*/)
+        const brief = splitSentences((r.doc.body ?? '').trim(), { cjkOnly: true })
             .slice(0, 2)
             .join('');
         const published = docTimestamp(r.doc);

package/plugins/generations/gemini-tts/dist/index.js

@@ -12257,6 +12257,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/generations/voice-gen/src/index.ts
 init_dist();
 

package/plugins/generations/image-gen/dist/index.js

@@ -12595,6 +12595,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/generations/image-gen/src/index.ts
 init_dist();
 

package/plugins/generations/news-report-gen/dist/index.js

@@ -12319,6 +12319,10 @@ function uniqueToken() {
 }
 // ../../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/generations/news-report-gen/src/index.ts
 init_dist();
 var QC_DIMENSIONS = ["quality", "importance", "urgency", "impact"];

package/plugins/generations/voice-gen/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", ")", '"', "'"]);
 // ../../plugins/generations/voice-gen/src/index.ts
 init_dist();
 

package/plugins/generations/voxcpm-tts/dist/index.js

@@ -12257,6 +12257,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/generations/voice-gen/src/index.ts
 init_dist();
 

package/plugins/ingestions/aihot-ingest/dist/index.js

@@ -12571,6 +12571,10 @@ function uniqueToken() {
 }
 // ../../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/ingestions/aihot-ingest/src/index.ts
 init_dist();
 init_zod();

package/plugins/ingestions/horizon-ingest/dist/index.js

@@ -12320,6 +12320,10 @@ function uniqueToken() {
 }
 // ../../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/ingestions/horizon-ingest/src/index.ts
 init_dist();
 init_zod();

package/plugins/ingestions/last30days-ingest/dist/index.js

@@ -11983,7 +11983,7 @@ var init_file_system_node = () => {};
 // ../../plugins/ingestions/last30days-ingest/src/index.ts
 import { createHash } from "crypto";
 import { homedir } from "os";
-import { dirname as dirname2, join } from "path";
+import { dirname as dirname2, join, resolve } from "path";
 import { parseArgs } from "util";
 
 // ../../packages/kk-core/src/content-limits.ts
@@ -12321,6 +12321,10 @@ function uniqueToken() {
 }
 // ../../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/ingestions/last30days-ingest/src/index.ts
 init_dist();
 init_zod();
@@ -12332,6 +12336,9 @@ var InputConfigSchema = object({
 });
 var defaultRunner = async (config, outputPath) => {
   const skillDir = process.env.LAST30DAYS_SKILL_DIR ?? join(homedir(), ".agents", "skills", "last30days");
+  if (!createNodeFileSystem().exists(skillDir)) {
+    throw new Error(`skill dir missing at ${skillDir} \u2014 restore the last30days skill checkout/symlink or set LAST30DAYS_SKILL_DIR`);
+  }
   const argv = [
     process.env.LAST30DAYS_PYTHON ?? "python3",
     join(skillDir, "scripts", "last30days.py"),
@@ -12391,7 +12398,8 @@ function mapResultsToDocs(agentJson, topic) {
 }
 async function processIngestionIO(options, config, runner = defaultRunner) {
   const fs = createNodeFileSystem();
-  const outDir = dirname2(options.out);
+  const out = resolve(options.out);
+  const outDir = dirname2(out);
   if (outDir && outDir !== ".")
     await fs.ensureDir(outDir);
   const capturePath = join(outDir || ".", ".last30days-agent.json");
@@ -12400,7 +12408,7 @@ async function processIngestionIO(options, config, runner = defaultRunner) {
     throw new Error(`last30days exited ${run.exitCode}: ${run.stderr.trim() || "no stderr"}`);
   }
   const docs = mapResultsToDocs(await readJsonFile(capturePath), config.topic);
-  await atomicWriteJson(options.out, docs, fs);
+  await atomicWriteJson(out, docs, fs);
   return { docs };
 }
 async function main2(runner) {

package/plugins/ingestions/last30days-ingest/src/index.ts

@@ -1,6 +1,6 @@
 import { createHash } from 'node:crypto';
 import { homedir } from 'node:os';
-import { dirname, join } from 'node:path';
+import { dirname, join, resolve } from 'node:path';
 import { parseArgs } from 'node:util';
 import { type Doc, DocListSchema } from '@gobing-ai/kk-core';
 import { atomicWriteJson, createNodeFileSystem, readJsonFile } from '@gobing-ai/ts-runtime';
@@ -36,6 +36,14 @@ export type RunLast30Days = (
 
 export const defaultRunner: RunLast30Days = async (config, outputPath) => {
     const skillDir = process.env.LAST30DAYS_SKILL_DIR ?? join(homedir(), '.agents', 'skills', 'last30days');
+    // The skill dir is the spawn cwd: when the ~/.agents/skills/last30days symlink dangles,
+    // Bun reports it as `ENOENT ... posix_spawn 'python3'` — pointing at the interpreter, not
+    // the dir (2026-10-20 incident lost 9h of diagnosis to that). Fail with the real problem.
+    if (!createNodeFileSystem().exists(skillDir)) {
+        throw new Error(
+            `skill dir missing at ${skillDir} — restore the last30days skill checkout/symlink or set LAST30DAYS_SKILL_DIR`,
+        );
+    }
     const argv = [
         process.env.LAST30DAYS_PYTHON ?? 'python3',
         join(skillDir, 'scripts', 'last30days.py'),
@@ -109,7 +117,10 @@ export async function processIngestionIO(
     runner: RunLast30Days = defaultRunner,
 ): Promise<{ docs: Doc[] }> {
     const fs = createNodeFileSystem();
-    const outDir = dirname(options.out);
+    // Relative --out would split cwd semantics: the engine writes its capture relative to the
+    // skill dir (its cwd) while we read it relative to ours. Pin everything to an absolute path.
+    const out = resolve(options.out);
+    const outDir = dirname(out);
     if (outDir && outDir !== '.') await fs.ensureDir(outDir);
     const capturePath = join(outDir || '.', '.last30days-agent.json');
     const run = await runner(config, capturePath);
@@ -117,7 +128,7 @@ export async function processIngestionIO(
         throw new Error(`last30days exited ${run.exitCode}: ${run.stderr.trim() || 'no stderr'}`);
     }
     const docs = mapResultsToDocs(await readJsonFile(capturePath), config.topic);
-    await atomicWriteJson(options.out, docs, fs);
+    await atomicWriteJson(out, docs, fs);
     return { docs };
 }
 

package/plugins/ingestions/web-search/dist/index.js

@@ -12275,6 +12275,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", ")", '"', "'"]);
 // ../../node_modules/.bun/@logtape+logtape@2.3.1/node_modules/@logtape/logtape/dist/context.js
 var categoryPrefixSymbol = Symbol.for("logtape.categoryPrefix");
 function getCategoryPrefix() {

package/plugins/kk/plugin.json

@@ -1,5 +1,5 @@
 {
     "name": "kk",
-    "version": "0.1.9",
+    "version": "0.1.10",
     "description": "knowledge-kit Claude Code plugin: skills, commands, subagents, hooks, and rules"
 }

package/plugins/kk/scripts/daily-stages.ts

@@ -114,6 +114,8 @@ import {
     type XhsCard,
     xhsPlan,
 } from './kk-workflow-stages.ts';
+import { splitSentences } from './sentences.ts';
+import { normalizeSeriesNames } from './series-names.ts';
 
 export function dailyQcContent(args: string[]): void {
     const [
@@ -1902,6 +1904,37 @@ function readFrontmatterScalar(filePath: string, key: string): string | undefine
     return value.length > 0 ? value : undefined;
 }
 
+/** The `key_points` item texts of a Surfing post's frontmatter; undefined when absent/unreadable. */
+export function readKeyPointItems(filePath: string): string[] | undefined {
+    if (!isFile(filePath)) return undefined;
+    let raw: string;
+    try {
+        raw = readFileSync(filePath, 'utf-8');
+    } catch {
+        return undefined;
+    }
+    const block = /^---\r?\n([\s\S]*?)\r?\n---/.exec(raw)?.[1];
+    if (!block) return undefined;
+    // Slice from `key_points` to the first top-level key (or block end), then take the item lines
+    // (`- `), so folded (`>-`) and quoted single-line items both read once.
+    const head = /^key_points:\n/m.exec(block);
+    if (!head) return undefined;
+    const body = block.slice(head.index + head[0].length);
+    const endMatch = /^\S/m.exec(body);
+    const list = endMatch ? body.slice(0, endMatch.index) : body;
+    // A quoted scalar's quotes are YAML syntax, not text — strip them so label lengths are real.
+    return list
+        .split('\n')
+        .filter((line) => /^[ \t]+- /.test(line))
+        .map((line) => line.replace(/^[ \t]+- /, '').trim())
+        .map((item) => item.replace(/^(["'])(.*)\1$/, '$2'));
+}
+
+/** Count `key_points` list items in a Surfing post's frontmatter; undefined when absent/unreadable. */
+export function countKeyPoints(filePath: string): number | undefined {
+    return readKeyPointItems(filePath)?.length;
+}
+
 function firstRefinedTitle(parsed: Record<string, unknown> | null): string {
     const targets = parsed?.targets;
     if (!Array.isArray(targets)) return '';
@@ -1940,7 +1973,7 @@ function planItemsForPodcast(workDir: string, runDate: string): Array<{ title: s
                 ? String((meta as Record<string, unknown>).brief).trim()
                 : '';
         const body = typeof record.body === 'string' ? record.body.trim() : '';
-        const brief = metaBrief || (body.split(/(?<=[。！？])\s*/)[0] ?? '').trim();
+        const brief = metaBrief || (splitSentences(body, { cjkOnly: true })[0] ?? '').trim();
         items.push(brief.length > 0 ? { title, brief } : { title });
     }
     return items;
@@ -3113,6 +3146,58 @@ export function dailyTranslateSync(args: string[]): void {
                 `translate-sync: 4th argument must be the zh marker file (${runDate}_20_translate-localize_zh-post-path.txt), not the post itself — '${zhPathFile}' holds ${zhPostPath.includes('\n') ? 'a multi-line document' : `'${zhPostPath}'`}`,
             );
         }
+        // The 2026-10-23 translate run published spliced en/ja description/key_points; the locale
+        // channel has no judge, so gate the structural minimum here before the CMS sync:
+        // a summary must exist and the key_points count must match the zh post (splices merge items).
+        // The same run also invented retired series names (毎日AIブレンド, "Daily AI Medley",
+        // zh-name listen links inside en/ja): normalizeSeriesNames rewrites the known bad set per
+        // locale deterministically (URLs untouched) and any leftover it cannot make safe fails the
+        // sync. The zh post rides the same sync, so it gets the same series-name pass.
+        const zhPoints = countKeyPoints(zhPostPath);
+        for (const locale of ['zh', 'en', 'ja'] as const) {
+            const sibling = locale === 'zh' ? zhPostPath : zhPostPath.replace('/zh/', `/${locale}/`);
+            if (!isFile(sibling)) continue;
+            const problems: string[] = [];
+            const raw = readFileSync(sibling, 'utf-8');
+            const { markdown, remaining } = normalizeSeriesNames(raw, locale);
+            if (markdown !== raw) sted('write', sibling, () => writeRaw(sibling, markdown));
+            if (remaining.length > 0) {
+                problems.push(`retired series names left after rewrite: ${remaining.join(' / ')}`);
+            }
+            if (locale !== 'zh') {
+                if (readFrontmatterScalar(sibling, 'description') === undefined) {
+                    problems.push('description missing/empty');
+                }
+                const points = countKeyPoints(sibling);
+                if (zhPoints !== undefined && points !== undefined && points !== zhPoints) {
+                    problems.push(`key_points count ${points} != zh ${zhPoints} (spliced or merged items)`);
+                }
+                // Label discipline (same 2026-10-23 audit): a key_points item is `Label — sentence`
+                // and the label is a short phrase — ≤14 chars for ja, ≤28 for en — never a
+                // sentence and never an ellipsis-truncated fragment.
+                const items = readKeyPointItems(sibling);
+                if (items !== undefined) {
+                    const cap = locale === 'en' ? 28 : 14;
+                    const overLimit = items.filter((item) => {
+                        const sep = item.indexOf(' — ');
+                        if (sep < 0) return false;
+                        const label = item.slice(0, sep);
+                        return label.includes('…') || Array.from(label).length > cap;
+                    });
+                    if (overLimit.length > 0) {
+                        problems.push(
+                            `key_points label over ${cap} chars or …-truncated: ${overLimit.length} of ${items.length} items`,
+                        );
+                    }
+                }
+            }
+            if (problems.length > 0) {
+                failWith(
+                    1,
+                    `translate-sync: ${locale} draft failed the pre-sync structural check (${problems.join('; ')}) — repair ${sibling} per the translate stage contract before syncing`,
+                );
+            }
+        }
         sted('write', sync, () =>
             writeJqText(sync, { body: '', options: { operation: 'sync', postPath: zhPostPath } }),
         );