@sanity/ailf 2.6.0 → 2.7.0

package/dist/cli.js

@@ -147,6 +147,8 @@ import { createAgentReportCommand } from "./commands/agent-report.js";
 program.addCommand(createAgentReportCommand().helpGroup(CommandGroup.AnalysisReports));
 import { createWeeklyDigestCommand } from "./commands/weekly-digest.js";
 program.addCommand(createWeeklyDigestCommand().helpGroup(CommandGroup.AnalysisReports));
+import { createCheckStalenessCommand } from "./commands/check-staleness.js";
+program.addCommand(createCheckStalenessCommand().helpGroup(CommandGroup.AnalysisReports));
 // ── Grader Reliability ────────────────────────────────────────────────
 import { createGraderCommand } from "./commands/grader/index.js";
 program.addCommand(createGraderCommand().helpGroup(CommandGroup.GraderReliability));

package/dist/commands/check-staleness.d.ts

@@ -0,0 +1,14 @@
+/**
+ * check-staleness command — verifies recent evaluation reports exist.
+ *
+ * Exits 0 when the most recent report in the Sanity Content Lake is within
+ * the max-age window, 1 otherwise (including "no reports at all"). Emits a
+ * single JSON line on stdout summarizing the decision so CI can pipe it
+ * directly into an alert payload.
+ *
+ * Used by the scheduled staleness workflow to detect silent pipeline
+ * failures — cases where scheduled evaluations stop producing reports but
+ * no workflow run fails loudly enough to be noticed.
+ */
+import { Command } from "commander";
+export declare function createCheckStalenessCommand(): Command;

package/dist/commands/check-staleness.js

@@ -0,0 +1,74 @@
+/**
+ * check-staleness command — verifies recent evaluation reports exist.
+ *
+ * Exits 0 when the most recent report in the Sanity Content Lake is within
+ * the max-age window, 1 otherwise (including "no reports at all"). Emits a
+ * single JSON line on stdout summarizing the decision so CI can pipe it
+ * directly into an alert payload.
+ *
+ * Used by the scheduled staleness workflow to detect silent pipeline
+ * failures — cases where scheduled evaluations stop producing reports but
+ * no workflow run fails loudly enough to be noticed.
+ */
+import { Command } from "commander";
+export function createCheckStalenessCommand() {
+    return new Command("check-staleness")
+        .description("Exit 1 if no evaluation report has been produced within the max-age window")
+        .option("--max-age <days>", "Max age in days before reports are considered stale", (v) => Number.parseInt(v, 10), 3)
+        .action(async (opts) => {
+        const { getSanityClient } = await import("../sanity/client.js");
+        // Resolve report-store credentials with the same precedence as
+        // weekly-digest.ts and composition-root.ts — AILF_REPORT_* wins over
+        // the evaluated-source SANITY_* defaults so the staleness probe tracks
+        // the actual report dataset even when it diverges from the eval source.
+        const client = getSanityClient({
+            dataset: process.env.AILF_REPORT_DATASET,
+            projectId: process.env.AILF_REPORT_PROJECT_ID,
+            token: process.env.AILF_REPORT_SANITY_API_TOKEN ??
+                process.env.SANITY_API_TOKEN,
+        });
+        const maxAgeDays = opts.maxAge;
+        // Bound the GROQ sort with a `completedAt > $floor` filter. Beyond
+        // ~10,000 reports the unbounded `order(completedAt desc)[0]` scan
+        // becomes a noticeable cost; a floor proportional to the max-age
+        // window keeps the scan cheap regardless of corpus size. The factor
+        // of 10× max-age gives plenty of headroom — if the last report
+        // predates the floor, the absence of any result still yields the
+        // correct "stale" verdict.
+        const floorDays = Math.max(maxAgeDays * 10, 30);
+        const floor = new Date(Date.now() - floorDays * 24 * 60 * 60 * 1000).toISOString();
+        const QUERY = `*[_type == "ailf.report" && completedAt > $floor] | order(completedAt desc)[0]{
+        "reportId": reportId,
+        "completedAt": completedAt,
+        "tag": tag
+      }`;
+        const latest = await client.fetch(QUERY, { floor });
+        // Use `process.exitCode` + `return` rather than `process.exit()` so
+        // stdout flushes cleanly when the caller captures via `$(...)` — a
+        // hard exit can drop buffered output on piped captures. Matches the
+        // pattern used by agent-report.ts, capture-list.ts, etc.
+        if (!latest || !latest.completedAt) {
+            console.log(JSON.stringify({
+                floorDays,
+                maxAgeDays,
+                reason: "no-reports",
+                stale: true,
+            }));
+            process.exitCode = 1;
+            return;
+        }
+        const ageMs = Date.now() - new Date(latest.completedAt).getTime();
+        const ageDays = Number((ageMs / (24 * 60 * 60 * 1000)).toFixed(2));
+        const stale = ageDays > maxAgeDays;
+        console.log(JSON.stringify({
+            ageDays,
+            floorDays,
+            latestCompletedAt: latest.completedAt,
+            latestReportId: latest.reportId,
+            latestTag: latest.tag,
+            maxAgeDays,
+            stale,
+        }));
+        process.exitCode = stale ? 1 : 0;
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sanity/ailf",
-  "version": "2.6.0",
+  "version": "2.7.0",
   "private": false,
   "publishConfig": {
     "access": "public"