@gobing-ai/knowledge-kit 0.1.8 → 0.1.9

package/package.json

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

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

@@ -12328,8 +12328,10 @@ var InputConfigSchema = object({
   config: string2().trim().min(1).optional(),
   hours: number2().int().min(1).optional(),
   languages: array(string2().trim().min(1)).optional(),
-  horizon_dir: string2().trim().min(1).optional()
+  horizon_dir: string2().trim().min(1).optional(),
+  stale_fallback_ms: number2().int().min(0).optional()
 });
+var DEFAULT_STALE_FALLBACK_MS = 26 * 3600000;
 var defaultRunner = async (config, horizonDir) => {
   const argv = [process.env.HORIZON_UV ?? "uv", "run", "horizon"];
   if (config.hours !== undefined)
@@ -12447,6 +12449,27 @@ async function processIngestionIO(options, config, runner = defaultRunner, now =
       continue;
     docs.push(...digestToDocs(await fs.readFile(file), match[1], match[2]));
   }
+  if (docs.length === 0) {
+    const fallbackMs = config.stale_fallback_ms ?? DEFAULT_STALE_FALLBACK_MS;
+    let newest = null;
+    for (const entry of entries) {
+      const match = entry.match(digestRe);
+      if (!match?.[1] || !match?.[2] || !langs.has(match[2]))
+        continue;
+      const stat = await fs.stat(join(summariesDir, entry));
+      if (!stat)
+        continue;
+      if (!newest || stat.mtimeMs > newest.mtimeMs)
+        newest = { entry, mtimeMs: stat.mtimeMs };
+    }
+    if (newest && runStartedAt - newest.mtimeMs <= fallbackMs) {
+      const match = newest.entry.match(digestRe);
+      if (match?.[1] && match?.[2]) {
+        echoError(`horizon-ingest: no fresh digest this run \u2014 falling back to ${newest.entry} (${Math.round((runStartedAt - newest.mtimeMs) / 3600000)}h old)`);
+        docs.push(...digestToDocs(await fs.readFile(join(summariesDir, newest.entry)), match[1], match[2]));
+      }
+    }
+  }
   if (docs.length === 0) {
     echoError(`horizon-ingest: no fresh digest in ${summariesDir} (languages: ${[...langs].join(", ")}) \u2014 emitting []`);
   }

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

@@ -19,8 +19,18 @@ const InputConfigSchema = z.object({
     hours: z.number().int().min(1).optional(),
     languages: z.array(z.string().trim().min(1)).optional(),
     horizon_dir: z.string().trim().min(1).optional(),
+    /**
+     * When this tick's run writes no digest (Horizon exits 0 on an empty 6h
+     * window), fall back to the newest digest at most this many ms old instead
+     * of emitting []. Doc ids are date-keyed and stable, so repeats dedupe
+     * downstream (2026-10-23: Oct 21 contributed zero docs — every tick hit an
+     * empty window).
+     */
+    stale_fallback_ms: z.number().int().min(0).optional(),
 });
 
+const DEFAULT_STALE_FALLBACK_MS = 26 * 3_600_000;
+
 export interface HorizonRunResult {
     exitCode: number;
     stderr: string;
@@ -166,6 +176,30 @@ export async function processIngestionIO(
         if (!stat || stat.mtimeMs < runStartedAt - 1000) continue; // stale file from an earlier run
         docs.push(...digestToDocs(await fs.readFile(file), match[1], match[2]));
     }
+    if (docs.length === 0) {
+        // This tick wrote no digest (empty fetch window exits 0). Reuse the newest
+        // digest while it is young enough to still matter for a daily podcast.
+        const fallbackMs = config.stale_fallback_ms ?? DEFAULT_STALE_FALLBACK_MS;
+        let newest: { entry: string; mtimeMs: number } | null = null;
+        for (const entry of entries) {
+            const match = entry.match(digestRe);
+            if (!match?.[1] || !match?.[2] || !langs.has(match[2])) continue;
+            const stat = await fs.stat(join(summariesDir, entry));
+            if (!stat) continue;
+            if (!newest || stat.mtimeMs > newest.mtimeMs) newest = { entry, mtimeMs: stat.mtimeMs };
+        }
+        if (newest && runStartedAt - newest.mtimeMs <= fallbackMs) {
+            const match = newest.entry.match(digestRe);
+            if (match?.[1] && match?.[2]) {
+                echoError(
+                    `horizon-ingest: no fresh digest this run — falling back to ${newest.entry} (${Math.round(
+                        (runStartedAt - newest.mtimeMs) / 3_600_000,
+                    )}h old)`,
+                );
+                docs.push(...digestToDocs(await fs.readFile(join(summariesDir, newest.entry)), match[1], match[2]));
+            }
+        }
+    }
     if (docs.length === 0) {
         echoError(
             `horizon-ingest: no fresh digest in ${summariesDir} (languages: ${[...langs].join(', ')}) — emitting []`,

package/plugins/kk/config.example.yaml

@@ -9,6 +9,14 @@ defaults:
   maxResults: 8
   fixture: false
 
+# Per-workflow settings. `publish_preset` names the publish preset that owns the daily channel
+# matrix (files live in `plugins/kk/publish-presets/`, overridable per project under
+# `.kk/publish-presets/`). The preset decides WHICH channels publish; `live` is never in a preset
+# file — it is a launch var (`live_channels`) or an installed schedule entry (ADR-022).
+workflows:
+  kk-daily-ai-voice3:
+    publish_preset: "daily-ai-voice"
+
 # Plugin credentials — paste values between the quotes.
 # Path: plugins/<collection>/<name>/env — each entry is injected into that plugin's
 # process environment at exec time. A real environment variable always wins

package/plugins/kk/plugin.json

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

package/plugins/kk/publish-presets/daily-ai-voice.json

@@ -0,0 +1,123 @@
+{
+    "schemaVersion": 1,
+    "name": "daily-ai-voice",
+    "targets": [
+        {
+            "plugin": "surfdash-pub",
+            "operation": "post",
+            "variant": "article",
+            "tier": 0,
+            "window": "after-generate",
+            "mode": "draft",
+            "required": true
+        },
+        {
+            "plugin": "podcast-pub",
+            "operation": "episode",
+            "variant": "episode",
+            "tier": 0,
+            "window": "after-generate",
+            "mode": "draft",
+            "required": true
+        },
+        {
+            "plugin": "wechatmp-pub",
+            "operation": "播客",
+            "variant": "episode",
+            "tier": 1,
+            "window": "after-generate",
+            "mode": "draft"
+        },
+        {
+            "plugin": "xhs-pub",
+            "operation": "发播客",
+            "variant": "episode",
+            "tier": 1,
+            "window": "after-generate",
+            "mode": "draft"
+        },
+        {
+            "plugin": "wechatmp-pub",
+            "operation": "文章",
+            "variant": "article",
+            "tier": 2,
+            "window": "after-generate",
+            "mode": "draft",
+            "options": {
+                "collection": "每日AI资讯"
+            }
+        },
+        {
+            "plugin": "xhs-pub",
+            "operation": "写长文",
+            "variant": "article",
+            "tier": 2,
+            "window": "after-generate",
+            "mode": "dummy"
+        },
+        {
+            "plugin": "xhs-pub",
+            "operation": "上传图文",
+            "variant": "cards",
+            "tier": 3,
+            "window": "after-generate",
+            "mode": "off"
+        },
+        {
+            "plugin": "weibo-pub",
+            "operation": "article",
+            "variant": "article",
+            "tier": 2,
+            "window": "cn-peak",
+            "mode": "draft"
+        },
+        {
+            "plugin": "x-pub",
+            "operation": "article",
+            "variant": "article",
+            "tier": 2,
+            "window": "cn-peak",
+            "mode": "draft"
+        },
+        {
+            "plugin": "x-pub",
+            "operation": "post",
+            "variant": "social:x",
+            "tier": 3,
+            "window": "overseas-rss",
+            "mode": "draft"
+        },
+        {
+            "plugin": "weibo-pub",
+            "operation": "post",
+            "variant": "social:weibo",
+            "tier": 3,
+            "window": "overseas-rss",
+            "mode": "draft"
+        },
+        {
+            "plugin": "threads-pub",
+            "operation": "post",
+            "variant": "social:threads",
+            "tier": 3,
+            "window": "overseas-rss",
+            "mode": "draft"
+        },
+        {
+            "plugin": "shipinhao-pub",
+            "operation": "图文",
+            "variant": "cards",
+            "tier": 3,
+            "window": "overseas-rss",
+            "mode": "off"
+        },
+        {
+            "plugin": "threads-pub",
+            "operation": "post-images",
+            "variant": "cards",
+            "tier": 3,
+            "window": "overseas-rss",
+            "mode": "off"
+        }
+    ]
+}

package/plugins/kk/schedules/kk-daily-publish3-cn-peak.cron.tmpl

@@ -0,0 +1,20 @@
+# kk-daily-publish3-cn-peak — domestic live window (task 0323 R5).
+#
+# Fires at 17:00 local because the audience window is 09:00 Asia/Shanghai and launchd/cron
+# intervals follow the MACHINE's zone; the first node (`publish-matrix-wait-until 09:00
+# Asia/Shanghai`) sleeps the remainder, which is 1 h from 17:00 PDT and 0 h after the DST flip —
+# so the entry never needs editing twice a year.
+#
+# `live_channels` is baked in: this installed line IS the operator's ADR-022 consent for a live
+# send. Nothing in the workflow or the preset can produce `live` on its own.
+#
+# Rendered by `kk schedule render kk-daily-publish3-cn-peak --platform cron --repo <checkout>`;
+# kk never edits the operator's crontab. MERGE, never replace:
+#
+#     crontab -l > /tmp/kk-cn-peak.cron 2>/dev/null || :
+#     kk schedule render kk-daily-publish3-cn-peak --platform cron --repo "$PWD" >> /tmp/kk-cn-peak.cron
+#     crontab /tmp/kk-cn-peak.cron
+#
+# `run_date` is computed at tick time in America/Los_Angeles: a run that starts at 17:00 PDT is
+# still "today" for the day dir the 04:30 generation wrote.
+0 17 * * * cd {{repo}} && mkdir -p .works/kk-daily-publish3 && PATH="{{home}}/.bun/bin:/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin" TZ=America/Los_Angeles spur workflow run plugins/kk/workflows/kk-daily-publish3.yaml --vars "{\"work_dir\":\"{{repo}}/.works/kk-daily-publish3/$(TZ=America/Los_Angeles date +%Y%m%d)\",\"run_date\":\"$(TZ=America/Los_Angeles date +%F)\",\"window\":\"cn-peak\",\"live_channels\":\"wechatmp-pub,xhs-pub,weibo-pub,x-pub\"}" >> {{repo}}/.works/kk-daily-publish3/cn-peak.log 2>&1

package/plugins/kk/schedules/kk-daily-publish3-overseas.cron.tmpl

@@ -0,0 +1,17 @@
+# kk-daily-publish3-overseas — overseas window behind the podcast RSS gate (task 0323 R5).
+#
+# 07:00 America/Los_Angeles, which needs no DST adjustment: the entry is defined in the zone the
+# machine already runs in. The gated date is the PREVIOUS day, because the observed episodes land
+# 13:43–15:22 PDT (after this tick) — `run_date` is therefore yesterday's date, not today's.
+#
+# The gate decides whether anything publishes: a miss cancels the overseas targets and runs
+# `diagnose` + the tier-0-only repair. This line carries no `live_channels`; the overseas channels
+# in the shipped preset are `draft`, so a live overseas post stays an operator launch.
+#
+# Rendered by `kk schedule render kk-daily-publish3-overseas --platform cron --repo <checkout>`;
+# kk never edits the operator's crontab. MERGE, never replace:
+#
+#     crontab -l > /tmp/kk-overseas.cron 2>/dev/null || :
+#     kk schedule render kk-daily-publish3-overseas --platform cron --repo "$PWD" >> /tmp/kk-overseas.cron
+#     crontab /tmp/kk-overseas.cron
+0 7 * * * cd {{repo}} && mkdir -p .works/kk-daily-publish3 && PATH="{{home}}/.bun/bin:/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin" TZ=America/Los_Angeles spur workflow run plugins/kk/workflows/kk-daily-publish3.yaml --vars "{\"work_dir\":\"{{repo}}/.works/kk-daily-publish3/$(TZ=America/Los_Angeles date -v-1d +%Y%m%d 2>/dev/null || TZ=America/Los_Angeles date -d yesterday +%Y%m%d)\",\"run_date\":\"$(TZ=America/Los_Angeles date -v-1d +%F 2>/dev/null || TZ=America/Los_Angeles date -d yesterday +%F)\",\"window\":\"overseas-rss\"}" >> {{repo}}/.works/kk-daily-publish3/overseas.log 2>&1