@bli-cockpit/telemetry-core 0.1.33 → 0.1.34

package/dist/collector-heartbeat.d.ts

@@ -105,6 +105,7 @@ export declare const CollectorHeartbeatSchema: z.ZodObject<{
         hook_timeouts_24h: z.ZodOptional<z.ZodNumber>;
         hook_printed_24h: z.ZodOptional<z.ZodNumber>;
         hook_failed_24h: z.ZodOptional<z.ZodNumber>;
+        hook_skipped_trivial_24h: z.ZodOptional<z.ZodNumber>;
         hook_stats_reason: z.ZodOptional<z.ZodString>;
         hook_performance: z.ZodOptional<z.ZodObject<{
             schema_version: z.ZodLiteral<"memory-hook-performance.v1">;

package/dist/memory-hook-stats.d.ts

@@ -45,6 +45,7 @@ export declare const MemoryHookCountsSchema: z.ZodObject<{
     timeouts: z.ZodNumber;
     failed: z.ZodNumber;
     skipped: z.ZodNumber;
+    skipped_trivial: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strict>;
 export type MemoryHookCounts = z.infer<typeof MemoryHookCountsSchema>;
 /** `YYYY-MM-DDTHH` in UTC — the bucket key, and the reason the window is exact. */
@@ -62,6 +63,7 @@ export declare const MemoryHookStatsFileSchema: z.ZodObject<{
         timeouts: z.ZodNumber;
         failed: z.ZodNumber;
         skipped: z.ZodNumber;
+        skipped_trivial: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strict>>>;
 }, z.core.$strict>;
 export type MemoryHookStatsFile = z.infer<typeof MemoryHookStatsFileSchema>;
@@ -74,6 +76,8 @@ export interface MemoryHookWindow {
     printed: number;
     timeouts: number;
     failed: number;
+    /** Trivial prompts the hook declined to search for (BLI-3881). A subset of skips. */
+    skippedTrivial: number;
     /** Buckets that were inside the window and had something in them. */
     hours: number;
 }

package/dist/memory-hook-stats.js

@@ -46,6 +46,23 @@ export const MemoryHookCountsSchema = z
     timeouts: z.number().int().min(0),
     failed: z.number().int().min(0),
     skipped: z.number().int().min(0),
+    /**
+     * BLI-3881 — the SUBSET of `skipped` the hook declined to search for.
+     *
+     * "ok", "continue", "y", a slash command: a turn whose whole text carries
+     * no subject to recall against. Searching one spends a person's whole
+     * budget on a query that can only return noise, so the hook returns early
+     * and this counts how often — because a hook that stops doing something
+     * and says nothing is indistinguishable from a hook that broke.
+     *
+     * OPTIONAL, and it must stay optional: a file written by a memory-mcp
+     * older than this ticket has no such key, and `MemoryHookCountsSchema` is
+     * strict, so a required field would make every existing machine's history
+     * `hook_stats_unrecognised_shape` overnight. It is counted BESIDE
+     * `skipped`, never instead of it, so `runs = printed + empty + timeouts +
+     * failed + skipped` still holds.
+     */
+    skipped_trivial: z.number().int().min(0).optional(),
 })
     .strict();
 /** `YYYY-MM-DDTHH` in UTC — the bucket key, and the reason the window is exact. */
@@ -69,7 +86,7 @@ export function memoryHookHourBucket(at) {
     return at.toISOString().slice(0, 13);
 }
 export function emptyMemoryHookCounts() {
-    return { runs: 0, printed: 0, empty: 0, timeouts: 0, failed: 0, skipped: 0 };
+    return { runs: 0, printed: 0, empty: 0, timeouts: 0, failed: 0, skipped: 0, skipped_trivial: 0 };
 }
 /**
  * Sum one event's buckets over the last `hours` hours, ending at `now`.
@@ -83,7 +100,14 @@ export function summariseMemoryHookWindow(file, event, options) {
     const hours = options.hours ?? 24;
     const earliest = memoryHookHourBucket(new Date(options.now.getTime() - (hours - 1) * 3_600_000));
     const latest = memoryHookHourBucket(options.now);
-    const total = { runs: 0, printed: 0, timeouts: 0, failed: 0, hours: 0 };
+    const total = {
+        runs: 0,
+        printed: 0,
+        timeouts: 0,
+        failed: 0,
+        skippedTrivial: 0,
+        hours: 0,
+    };
     for (const [bucket, events] of Object.entries(file.buckets)) {
         // Lexical order is chronological for this key, which is the only reason a
         // string comparison is allowed to stand in for a date one here.
@@ -96,6 +120,9 @@ export function summariseMemoryHookWindow(file, event, options) {
         total.printed += counts.printed;
         total.timeouts += counts.timeouts;
         total.failed += counts.failed;
+        // Absent means an older writer never counted one, which sums as zero and
+        // is honest: that machine genuinely skipped none, because it could not.
+        total.skippedTrivial += counts.skipped_trivial ?? 0;
         total.hours += 1;
     }
     return total;

package/dist/memory-install-receipt.d.ts

@@ -113,6 +113,7 @@ export declare const MemoryInstallReceiptSchema: z.ZodObject<{
     hook_timeouts_24h: z.ZodOptional<z.ZodNumber>;
     hook_printed_24h: z.ZodOptional<z.ZodNumber>;
     hook_failed_24h: z.ZodOptional<z.ZodNumber>;
+    hook_skipped_trivial_24h: z.ZodOptional<z.ZodNumber>;
     hook_stats_reason: z.ZodOptional<z.ZodString>;
     hook_performance: z.ZodOptional<z.ZodObject<{
         schema_version: z.ZodLiteral<"memory-hook-performance.v1">;

package/dist/memory-install-receipt.js

@@ -132,6 +132,15 @@ export const MemoryInstallReceiptSchema = z
     hook_timeouts_24h: z.number().int().min(0).optional(),
     hook_printed_24h: z.number().int().min(0).optional(),
     hook_failed_24h: z.number().int().min(0).optional(),
+    /**
+     * BLI-3881: runs the hook DECLINED to search for — "ok", "continue", a
+     * slash command. It is a subset of the skips inside `hook_runs_24h`, and
+     * it exists because a hook that quietly stops searching looks exactly like
+     * a hook that broke. Optional like the four above: absent means the
+     * machine is on a memory-mcp older than the rule, never that it skipped
+     * none.
+     */
+    hook_skipped_trivial_24h: z.number().int().min(0).optional(),
     /** Named when the counts are absent because the file could not be read. */
     hook_stats_reason: ReasonLabelSchema.optional(),
     /** Observed ordinary invocations, not legacy floors or a full host trace. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bli-cockpit/telemetry-core",
-  "version": "0.1.33",
+  "version": "0.1.34",
   "private": false,
   "type": "module",
   "main": "./dist/index.js",