@gobing-ai/knowledge-kit 0.0.32 → 0.0.34

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

@@ -14642,7 +14642,7 @@ var init_zod = __esm(() => {
   init_external();
 });
 
-// ../../node_modules/.bun/@gobing-ai+ts-utils@0.5.15/node_modules/@gobing-ai/ts-utils/dist/errors.js
+// ../../node_modules/.bun/@gobing-ai+ts-utils@0.5.21/node_modules/@gobing-ai/ts-utils/dist/errors.js
 var ErrorCode;
 var init_errors3 = __esm(() => {
   ErrorCode = {
@@ -14653,7 +14653,7 @@ var init_errors3 = __esm(() => {
   };
 });
 
-// ../../node_modules/.bun/@gobing-ai+ts-utils@0.5.15/node_modules/@gobing-ai/ts-utils/dist/api-response.js
+// ../../node_modules/.bun/@gobing-ai+ts-utils@0.5.21/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();
@@ -14676,13 +14676,13 @@ var init_api_response = __esm(() => {
   CLIENT_SAFE_CODES = new Set([ErrorCode.NotFound, ErrorCode.Validation, ErrorCode.Conflict]);
 });
 
-// ../../node_modules/.bun/@gobing-ai+ts-utils@0.5.15/node_modules/@gobing-ai/ts-utils/dist/cursor.js
+// ../../node_modules/.bun/@gobing-ai+ts-utils@0.5.21/node_modules/@gobing-ai/ts-utils/dist/cursor.js
 var init_cursor = () => {};
 
-// ../../node_modules/.bun/@gobing-ai+ts-utils@0.5.15/node_modules/@gobing-ai/ts-utils/dist/event-severity.js
+// ../../node_modules/.bun/@gobing-ai+ts-utils@0.5.21/node_modules/@gobing-ai/ts-utils/dist/event-severity.js
 var init_event_severity = () => {};
 
-// ../../node_modules/.bun/@gobing-ai+ts-utils@0.5.15/node_modules/@gobing-ai/ts-utils/dist/output.js
+// ../../node_modules/.bun/@gobing-ai+ts-utils@0.5.21/node_modules/@gobing-ai/ts-utils/dist/output.js
 function processStream(name) {
   const proc = globalThis.process;
   const stream = proc?.[name];
@@ -14700,7 +14700,7 @@ function echoError(message, target = defaultStderrTarget ?? processStream("stder
 }
 var defaultStderrTarget;
 
-// ../../node_modules/.bun/@gobing-ai+ts-utils@0.5.15/node_modules/@gobing-ai/ts-utils/dist/index.js
+// ../../node_modules/.bun/@gobing-ai+ts-utils@0.5.21/node_modules/@gobing-ai/ts-utils/dist/index.js
 var init_dist = __esm(() => {
   init_api_response();
   init_cursor();
@@ -21698,7 +21698,7 @@ var init_dist2 = __esm(() => {
   $visitAsync = visit.visitAsync;
 });
 
-// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.5.15/node_modules/@gobing-ai/ts-runtime/dist/config.js
+// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.5.21+44edd5c4d6372504/node_modules/@gobing-ai/ts-runtime/dist/config.js
 var configSchema;
 var init_config = __esm(() => {
   init_dist2();
@@ -21722,7 +21722,7 @@ var init_config = __esm(() => {
   });
 });
 
-// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.5.15/node_modules/@gobing-ai/ts-runtime/dist/file-system-node.js
+// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.5.21+44edd5c4d6372504/node_modules/@gobing-ai/ts-runtime/dist/file-system-node.js
 import { appendFileSync, cpSync, createReadStream, createWriteStream, existsSync, mkdirSync, readdirSync, readFileSync, realpathSync, renameSync, rmSync, statSync, writeFileSync } from "fs";
 import { dirname, resolve as resolvePath } from "path";
 function createNodeFileSystem(root, paths) {
@@ -21896,18 +21896,19 @@ var PluginManifestSchema = exports_external.looseObject({
   name: exports_external.string().min(1),
   kind: PluginKindSchema,
   entry: exports_external.string().min(1),
+  check: exports_external.string().min(1).optional(),
   version: exports_external.string().optional(),
   description: exports_external.string().optional(),
   operations: exports_external.record(exports_external.string(), PluginOperationSchema).optional()
 });
-// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.5.15/node_modules/@gobing-ai/ts-runtime/dist/index.js
+// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.5.21+44edd5c4d6372504/node_modules/@gobing-ai/ts-runtime/dist/index.js
 init_file_system_node();
 init_config();
 
-// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.5.15/node_modules/@gobing-ai/ts-runtime/dist/fs.js
+// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.5.21+44edd5c4d6372504/node_modules/@gobing-ai/ts-runtime/dist/fs.js
 init_file_system_node();
 
-// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.5.15/node_modules/@gobing-ai/ts-runtime/dist/path.js
+// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.5.21+44edd5c4d6372504/node_modules/@gobing-ai/ts-runtime/dist/path.js
 function normalizeSeparators(path) {
   return path.replaceAll("\\", "/");
 }
@@ -21941,7 +21942,7 @@ function dirnamePath(path) {
   return normalized.slice(0, index);
 }
 
-// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.5.15/node_modules/@gobing-ai/ts-runtime/dist/fs.js
+// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.5.21+44edd5c4d6372504/node_modules/@gobing-ai/ts-runtime/dist/fs.js
 async function ensureDirForFile(path, fs = createNodeFileSystem()) {
   await fs.ensureDir(dirnamePath(path));
 }
@@ -22243,6 +22244,24 @@ function scoreDimensions(doc2, planDate) {
   const impact = max > 1000 ? 5 : max > 100 ? 4 : max > 10 ? 3 : max > 1 ? 2 : 1;
   return { quality, importance, urgency, impact };
 }
+function needsModelLabel(doc2) {
+  return classifyCategory(doc2) === "non-ai" && hasAiSignal(doc2);
+}
+function hasAiSignal(doc2) {
+  const meta3 = asRecord(doc2.metadata);
+  const tags = Array.isArray(meta3.tags) ? meta3.tags.filter((t) => typeof t === "string") : [];
+  for (const tag of tags) {
+    const hit = TAG_CATEGORY[tag.toLowerCase()];
+    if (hit !== undefined && hit !== "non-ai")
+      return true;
+  }
+  const source = typeof meta3.source === "string" ? meta3.source : "";
+  if (AI_DEFAULT_SOURCES.has(source))
+    return true;
+  const title = (doc2.title ?? "").toLowerCase();
+  const bodyHead = (doc2.body ?? "").slice(0, 200).toLowerCase();
+  return CATEGORY_KEYWORDS.some((row) => row.words.some((w) => matchesKeyword(title, w) || matchesKeyword(bodyHead, w)));
+}
 function planScore(doc2) {
   const meta3 = asRecord(doc2.metadata);
   const source = typeof meta3.source === "string" ? meta3.source : "";
@@ -22572,7 +22591,29 @@ async function atomicWrite(path2, value) {
   await atomicWriteJson(path2, value, fs);
 }
 async function processGeneratorIO(inputPath, outputPath, mode = "plan") {
-  return mode === "filter" ? processFilterIO(inputPath, outputPath) : processPlanIO(inputPath, outputPath);
+  if (mode === "filter")
+    return processFilterIO(inputPath, outputPath);
+  if (mode === "label")
+    return processLabelIO(inputPath, outputPath);
+  return processPlanIO(inputPath, outputPath);
+}
+function labelDocs(docs, planDate) {
+  return docs.map((doc2) => ({
+    ...doc2,
+    metadata: {
+      ...asRecord(doc2.metadata),
+      category: classifyCategory(doc2),
+      scores: scoreDimensions(doc2, planDate),
+      needs_model: needsModelLabel(doc2)
+    }
+  }));
+}
+async function processLabelIO(inputPath, outputPath) {
+  const docs = DocListSchema.parse(await readJsonFile(inputPath));
+  const planDate = resolvePlanDate();
+  const content = planContent(labelDocs(docs, planDate), planDate);
+  await atomicWrite(outputPath, content);
+  return content;
 }
 async function processPlanIO(inputPath, outputPath) {
   const docs = DocListSchema.parse(await readJsonFile(inputPath));
@@ -22610,8 +22651,8 @@ async function main2() {
     return 1;
   }
   const mode = values.mode ?? process.env.EPISODE_PLAN_MODE ?? "plan";
-  if (mode !== "plan" && mode !== "filter") {
-    echoError(`episode-plan-gen failed: unknown mode '${mode}' (from --mode flag or EPISODE_PLAN_MODE env; valid: plan, filter)`);
+  if (mode !== "plan" && mode !== "filter" && mode !== "label") {
+    echoError(`episode-plan-gen failed: unknown mode '${mode}' (from --mode flag or EPISODE_PLAN_MODE env; valid: plan, filter, label)`);
     return 1;
   }
   try {
@@ -22635,7 +22676,9 @@ export {
   planEpisode,
   planAuditOutPath,
   normalizeUrl,
+  needsModelLabel,
   main2 as main,
+  labelDocs,
   filterConfigFromEnv,
   filterAnnotated,
   docsToContent,

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

@@ -19,7 +19,10 @@ import { echoError } from '@gobing-ai/ts-utils';
  * out — survivors to `--out`, rejection audit to `<out>.rejected.json`; env
  * `QC_CATEGORIES` (default 'ai-news,ai-industry'),
  * `QC_MIN_QUALITY/IMPORTANCE/URGENCY/IMPACT` (defaults 2/3/2/1 — 0099 recalibration);
- * invalid values exit 1 (fail loud, no clamping).
+ * invalid values exit 1 (fail loud, no clamping). `--mode label` (0209) is the
+ * labelling contract for `kk store label`: every input doc annotated
+ * (`metadata.category`, `metadata.scores`, `metadata.needs_model`), no cap, dedup or
+ * filter, written to `--out` with no audit sidecar.
  */
 
 /** Tunable scoring knobs (kept here so the shape is greppable, not config-filed). */
@@ -415,6 +418,41 @@ export function scoreDimensions(doc: Doc, planDate: string): DimensionScores {
     return { quality, importance, urgency, impact };
 }
 
+/**
+ * Does the keyword heuristic want a model second opinion on this doc?
+ *
+ * True exactly when the deterministic scan proves an AI signal (an AI-mapped tag, a
+ * curated AI source, or an AI keyword in the title/body head) but
+ * {@link classifyCategory} still files the doc `non-ai` — a deny rule (non-AI tag, junk
+ * phrase, non-AI source) outvoted the signal. Everything else is either confidently
+ * categorized or confidently non-AI, so `kk store label` keeps its heuristic rows and
+ * spends no model call (0209 R5).
+ */
+export function needsModelLabel(doc: Doc): boolean {
+    return classifyCategory(doc) === 'non-ai' && hasAiSignal(doc);
+}
+
+/**
+ * Any AI-side signal matches — the mirror of `classifyCategory`'s positive proof, so the
+ * two never disagree about what counts as evidence. `CATEGORY_KEYWORDS` holds AI
+ * categories only; the tag map and the curated-source set are filtered to non-`non-ai`.
+ */
+function hasAiSignal(doc: Doc): boolean {
+    const meta = asRecord(doc.metadata);
+    const tags = Array.isArray(meta.tags) ? meta.tags.filter((t): t is string => typeof t === 'string') : [];
+    for (const tag of tags) {
+        const hit = TAG_CATEGORY[tag.toLowerCase()];
+        if (hit !== undefined && hit !== 'non-ai') return true;
+    }
+    const source = typeof meta.source === 'string' ? meta.source : '';
+    if (AI_DEFAULT_SOURCES.has(source)) return true;
+    const title = (doc.title ?? '').toLowerCase();
+    const bodyHead = (doc.body ?? '').slice(0, 200).toLowerCase();
+    return CATEGORY_KEYWORDS.some((row) =>
+        row.words.some((w) => matchesKeyword(title, w) || matchesKeyword(bodyHead, w)),
+    );
+}
+
 /** Composite 0..100-ish score; ordering matters more than absolute value. */
 export function planScore(doc: Doc): number {
     const meta = asRecord(doc.metadata);
@@ -638,8 +676,8 @@ function resolvePlanDate(): string {
 // kept/rejected split out (ADR-019 D3: QC is a visible, threshold-driven node).
 // ---------------------------------------------------------------------------
 
-/** Run modes: `plan` (default — the gated selection pipeline, unchanged) or `filter` (the QC gate). */
-export type GeneratorMode = 'plan' | 'filter';
+/** Run modes: `plan` (default — the gated selection pipeline, unchanged), `filter` (the QC gate) or `label` (annotation only, 0209). */
+export type GeneratorMode = 'plan' | 'filter' | 'label';
 
 /** The closed MECE taxonomy (the values `classifyCategory` emits) — filter allowlists validate against it. */
 const MECE_CATEGORIES: readonly Category[] = ['ai-news', 'ai-technical', 'ai-research', 'ai-industry', 'non-ai'];
@@ -862,7 +900,39 @@ export async function processGeneratorIO(
     outputPath: string,
     mode: GeneratorMode = 'plan',
 ): Promise<Content> {
-    return mode === 'filter' ? processFilterIO(inputPath, outputPath) : processPlanIO(inputPath, outputPath);
+    if (mode === 'filter') return processFilterIO(inputPath, outputPath);
+    if (mode === 'label') return processLabelIO(inputPath, outputPath);
+    return processPlanIO(inputPath, outputPath);
+}
+
+/**
+ * Label mode (0209 R3): annotate EVERY input doc — `metadata.category` and
+ * `metadata.scores` exactly as `planEpisode` writes them, plus `metadata.needs_model`
+ * ({@link needsModelLabel}) — with no cap, dedup, category gate or top-N selection.
+ *
+ * `kk store label` reads `metadata.docs` back and writes one `labels` row per decision,
+ * so this array IS the labelling contract; `planContent` is reused only as the Content
+ * wrapper (no audit sidecar — nothing was selected or rejected).
+ */
+export function labelDocs(docs: Doc[], planDate: string): Doc[] {
+    return docs.map((doc) => ({
+        ...doc,
+        metadata: {
+            ...asRecord(doc.metadata),
+            category: classifyCategory(doc),
+            scores: scoreDimensions(doc, planDate),
+            needs_model: needsModelLabel(doc),
+        },
+    }));
+}
+
+/** Label mode (0209): every input doc annotated, input order preserved → Content at `--out`. */
+async function processLabelIO(inputPath: string, outputPath: string): Promise<Content> {
+    const docs = DocListSchema.parse(await readJsonFile(inputPath));
+    const planDate = resolvePlanDate();
+    const content = planContent(labelDocs(docs, planDate), planDate);
+    await atomicWrite(outputPath, content);
+    return content;
 }
 
 /** Plan mode (default, behavior unchanged): blended `Doc[]` → gated/annotated plan Content + `<out>.audit.json` selection trail. */
@@ -915,9 +985,9 @@ export async function main(): Promise<number> {
     // The env rung exists because `kk executor run` spawns plugin entries with --in/--out only
     // (ADR-006, apps/cli/src/invoke.ts) and cannot forward extra CLI args.
     const mode = values.mode ?? process.env.EPISODE_PLAN_MODE ?? 'plan';
-    if (mode !== 'plan' && mode !== 'filter') {
+    if (mode !== 'plan' && mode !== 'filter' && mode !== 'label') {
         echoError(
-            `episode-plan-gen failed: unknown mode '${mode}' (from --mode flag or EPISODE_PLAN_MODE env; valid: plan, filter)`,
+            `episode-plan-gen failed: unknown mode '${mode}' (from --mode flag or EPISODE_PLAN_MODE env; valid: plan, filter, label)`,
         );
         return 1;
     }

package/plugins/generations/gemini-tts/README.md

@@ -123,3 +123,14 @@ exceeds that (it used to sleep out the ~19h horizon, which looked like a wedged
 A stored voice lasts 1 year (200 stored voices per project, shared with prompted voices). Before
 `expire_time`, repeat export → create → replace the id in the operator map. Delete the scratch
 clips when the new id is wired. Do not commit the wavs or the voice id.
+
+> **2026-10-07 observed:** that 1-year figure did not hold — the 2026-09-24 voice
+> (`voice_e6zevk798ecg`) started returning HTTP 404 "The voice was not found or the caller does not
+> have access/permission to access it" on 10-06/10-07, 13 days after creation (built-in voices kept
+> working, so key/model/request shape were fine). Treat a mid-life 404 as **voice death, not a bug**:
+> re-create via the en-pair path above (zh pair still 500s on 2026-10-07), swap the id in the
+> operator map, and smoke-test one zh segment before the next daily run. Symptom in the daily log:
+> `kk stage daily-generate` exit 1 with the 404 on segment 1 of ~23 queued.
+>
+> Renewal log: 2026-09-24 created → 2026-10-07 re-created (en pair, `voice_gl10j67aaj7j`). Consider
+> a weekly one-segment probe if this recurs; no automated probe today.

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

@@ -17,7 +17,7 @@ var __export = (target, all) => {
 var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
 var __require = import.meta.require;
 
-// ../../node_modules/.bun/@gobing-ai+ts-utils@0.5.15/node_modules/@gobing-ai/ts-utils/dist/errors.js
+// ../../node_modules/.bun/@gobing-ai+ts-utils@0.5.21/node_modules/@gobing-ai/ts-utils/dist/errors.js
 var ErrorCode;
 var init_errors = __esm(() => {
   ErrorCode = {
@@ -28,7 +28,7 @@ var init_errors = __esm(() => {
   };
 });
 
-// ../../node_modules/.bun/@gobing-ai+ts-utils@0.5.15/node_modules/@gobing-ai/ts-utils/dist/api-response.js
+// ../../node_modules/.bun/@gobing-ai+ts-utils@0.5.21/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_errors();
@@ -51,13 +51,13 @@ var init_api_response = __esm(() => {
   CLIENT_SAFE_CODES = new Set([ErrorCode.NotFound, ErrorCode.Validation, ErrorCode.Conflict]);
 });
 
-// ../../node_modules/.bun/@gobing-ai+ts-utils@0.5.15/node_modules/@gobing-ai/ts-utils/dist/cursor.js
+// ../../node_modules/.bun/@gobing-ai+ts-utils@0.5.21/node_modules/@gobing-ai/ts-utils/dist/cursor.js
 var init_cursor = () => {};
 
-// ../../node_modules/.bun/@gobing-ai+ts-utils@0.5.15/node_modules/@gobing-ai/ts-utils/dist/event-severity.js
+// ../../node_modules/.bun/@gobing-ai+ts-utils@0.5.21/node_modules/@gobing-ai/ts-utils/dist/event-severity.js
 var init_event_severity = () => {};
 
-// ../../node_modules/.bun/@gobing-ai+ts-utils@0.5.15/node_modules/@gobing-ai/ts-utils/dist/output.js
+// ../../node_modules/.bun/@gobing-ai+ts-utils@0.5.21/node_modules/@gobing-ai/ts-utils/dist/output.js
 function processStream(name) {
   const proc = globalThis.process;
   const stream = proc?.[name];
@@ -75,7 +75,7 @@ function echoError(message, target = defaultStderrTarget ?? processStream("stder
 }
 var defaultStderrTarget;
 
-// ../../node_modules/.bun/@gobing-ai+ts-utils@0.5.15/node_modules/@gobing-ai/ts-utils/dist/index.js
+// ../../node_modules/.bun/@gobing-ai+ts-utils@0.5.21/node_modules/@gobing-ai/ts-utils/dist/index.js
 var init_dist = __esm(() => {
   init_api_response();
   init_cursor();
@@ -21698,7 +21698,7 @@ var init_dist2 = __esm(() => {
   $visitAsync = visit.visitAsync;
 });
 
-// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.5.15/node_modules/@gobing-ai/ts-runtime/dist/config.js
+// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.5.21+44edd5c4d6372504/node_modules/@gobing-ai/ts-runtime/dist/config.js
 var configSchema;
 var init_config = __esm(() => {
   init_dist2();
@@ -21722,7 +21722,7 @@ var init_config = __esm(() => {
   });
 });
 
-// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.5.15/node_modules/@gobing-ai/ts-runtime/dist/file-system-node.js
+// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.5.21+44edd5c4d6372504/node_modules/@gobing-ai/ts-runtime/dist/file-system-node.js
 import { appendFileSync, cpSync, createReadStream, createWriteStream, existsSync, mkdirSync, readdirSync, readFileSync, realpathSync, renameSync, rmSync, statSync, writeFileSync } from "fs";
 import { dirname, resolve as resolvePath } from "path";
 function createNodeFileSystem(root, paths) {
@@ -21899,11 +21899,12 @@ var PluginManifestSchema = exports_external.looseObject({
   name: exports_external.string().min(1),
   kind: PluginKindSchema,
   entry: exports_external.string().min(1),
+  check: exports_external.string().min(1).optional(),
   version: exports_external.string().optional(),
   description: exports_external.string().optional(),
   operations: exports_external.record(exports_external.string(), PluginOperationSchema).optional()
 });
-// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.5.15/node_modules/@gobing-ai/ts-runtime/dist/index.js
+// ../../node_modules/.bun/@gobing-ai+ts-runtime@0.5.21+44edd5c4d6372504/node_modules/@gobing-ai/ts-runtime/dist/index.js
 init_file_system_node();
 init_config();