@checkstack/healthcheck-script-backend 0.3.9 → 0.3.10

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # @checkstack/healthcheck-script-backend
 
+## 0.3.10
+
+### Patch Changes
+
+- 8d1ef12: ## Downstream consumer bumps for the anomaly detection + cache system rollout
+
+  Packages on this branch were updated as part of the anomaly detection feature (schema annotations on result fields, plugin metadata for the modular cache system) but were not listed in the upstream changesets.
+
+  - **`@checkstack/healthcheck-common`** (minor) — new RPC contract additions and schema changes supporting per-field anomaly metadata.
+  - **`@checkstack/cache-memory-common`** (minor) — new package providing access rules + plugin metadata for the in-memory cache backend.
+  - **healthcheck plugins** (patch) — adopt the new `x-anomaly-*` schema annotations on their result fields so anomaly detection works automatically against their checks. No public API changes.
+  - **integration / notification / auth / queue / collector plugins** (patch) — minor internal updates as consumers of upstream API changes (cache plugin registry, schema additions). No public API changes.
+
+- Updated dependencies [8d1ef12]
+- Updated dependencies [8d1ef12]
+- Updated dependencies [8d1ef12]
+  - @checkstack/healthcheck-common@0.12.0
+  - @checkstack/common@0.7.0
+  - @checkstack/backend-api@0.13.0
+
 ## 0.3.9
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@checkstack/healthcheck-script-backend",
-  "version": "0.3.9",
+  "version": "0.3.10",
   "type": "module",
   "main": "src/index.ts",
   "checkstack": {
@@ -12,9 +12,9 @@
     "lint:code": "eslint . --max-warnings 0"
   },
   "dependencies": {
-    "@checkstack/backend-api": "0.11.1",
+    "@checkstack/backend-api": "0.12.0",
     "@checkstack/common": "0.6.5",
-    "@checkstack/healthcheck-common": "0.10.1"
+    "@checkstack/healthcheck-common": "0.11.0"
   },
   "devDependencies": {
     "@types/bun": "^1.0.0",

package/src/execute-collector.test.ts

@@ -10,7 +10,7 @@ describe("ExecuteCollector", () => {
       stderr?: string;
       timedOut?: boolean;
       error?: string;
-    } = {}
+    } = {},
   ): ScriptTransportClient => ({
     exec: mock(() =>
       Promise.resolve({
@@ -19,7 +19,7 @@ describe("ExecuteCollector", () => {
         stderr: response.stderr ?? "",
         timedOut: response.timedOut ?? false,
         error: response.error,
-      })
+      }),
     ),
   });
 

package/src/execute-collector.ts

@@ -52,27 +52,39 @@ const executeResultSchema = healthResultSchema({
   exitCode: healthResultNumber({
     "x-chart-type": "counter",
     "x-chart-label": "Exit Code",
+    "x-anomaly-enabled": true,
+    "x-anomaly-direction": "dominance",
   }),
   stdout: healthResultString({
     "x-chart-type": "text",
     "x-chart-label": "Standard Output",
+    "x-anomaly-enabled": false,
   }),
   stderr: healthResultString({
     "x-chart-type": "text",
     "x-chart-label": "Standard Error",
+    "x-anomaly-enabled": false,
   }),
   executionTimeMs: healthResultNumber({
     "x-chart-type": "line",
     "x-chart-label": "Execution Time",
     "x-chart-unit": "ms",
+    "x-anomaly-enabled": true,
+    "x-anomaly-direction": "lower-is-better",
+    "x-anomaly-sensitivity": 2,
+    "x-anomaly-confirmation-window": 3,
   }),
   success: healthResultBoolean({
     "x-chart-type": "boolean",
     "x-chart-label": "Success",
+    "x-anomaly-enabled": true,
+    "x-anomaly-direction": "dominance",
   }),
   timedOut: healthResultBoolean({
     "x-chart-type": "boolean",
     "x-chart-label": "Timed Out",
+    "x-anomaly-enabled": true,
+    "x-anomaly-direction": "dominance",
   }),
 });
 
@@ -84,11 +96,15 @@ const executeAggregatedFields = {
     "x-chart-type": "line",
     "x-chart-label": "Avg Execution Time",
     "x-chart-unit": "ms",
+    "x-anomaly-enabled": true,
+    "x-anomaly-direction": "lower-is-better",
   }),
   successRate: aggregatedRate({
     "x-chart-type": "gauge",
     "x-chart-label": "Success Rate",
     "x-chart-unit": "%",
+    "x-anomaly-enabled": true,
+    "x-anomaly-direction": "higher-is-better",
   }),
 };
 

package/src/inline-script-collector.ts

@@ -106,10 +106,14 @@ async function executeInlineScript({
     const worker = new Worker(workerUrl);
 
     const workerResult = await Promise.race([
-      new Promise<{ result?: unknown; error?: string; logs: string[] }>((resolve) => {
-        worker.addEventListener("message", (event: MessageEvent) => resolve(event.data));
-        worker.postMessage({ script, config: context.config });
-      }),
+      new Promise<{ result?: unknown; error?: string; logs: string[] }>(
+        (resolve) => {
+          worker.addEventListener("message", (event: MessageEvent) =>
+            resolve(event.data),
+          );
+          worker.postMessage({ script, config: context.config });
+        },
+      ),
       new Promise<never>((_, reject) =>
         setTimeout(() => reject(new Error("__TIMEOUT__")), timeoutMs),
       ),
@@ -153,8 +157,12 @@ async function executeInlineScript({
       return {
         result: {
           success: Boolean(resultObj.success ?? true),
-          message: typeof resultObj.message === "string" ? resultObj.message : undefined,
-          value: typeof resultObj.value === "number" ? resultObj.value : undefined,
+          message:
+            typeof resultObj.message === "string"
+              ? resultObj.message
+              : undefined,
+          value:
+            typeof resultObj.value === "number" ? resultObj.value : undefined,
         },
         timedOut: false,
       };
@@ -204,23 +212,34 @@ const inlineScriptResultSchema = healthResultSchema({
   success: healthResultBoolean({
     "x-chart-type": "boolean",
     "x-chart-label": "Success",
+    "x-anomaly-enabled": true,
+    "x-anomaly-direction": "dominance",
   }),
   message: healthResultString({
     "x-chart-type": "text",
     "x-chart-label": "Message",
+    "x-anomaly-enabled": false,
   }).optional(),
   value: healthResultNumber({
     "x-chart-type": "line",
     "x-chart-label": "Value",
+    "x-anomaly-enabled": true,
+    "x-anomaly-direction": "deviation",
   }).optional(),
   executionTimeMs: healthResultNumber({
     "x-chart-type": "line",
     "x-chart-label": "Execution Time",
     "x-chart-unit": "ms",
+    "x-anomaly-enabled": true,
+    "x-anomaly-direction": "lower-is-better",
+    "x-anomaly-sensitivity": 2,
+    "x-anomaly-confirmation-window": 3,
   }),
   timedOut: healthResultBoolean({
     "x-chart-type": "boolean",
     "x-chart-label": "Timed Out",
+    "x-anomaly-enabled": true,
+    "x-anomaly-direction": "dominance",
   }),
 });
 
@@ -232,11 +251,15 @@ const inlineScriptAggregatedFields = {
     "x-chart-type": "line",
     "x-chart-label": "Avg Execution Time",
     "x-chart-unit": "ms",
+    "x-anomaly-enabled": true,
+    "x-anomaly-direction": "lower-is-better",
   }),
   successRate: aggregatedRate({
     "x-chart-type": "gauge",
     "x-chart-label": "Success Rate",
     "x-chart-unit": "%",
+    "x-anomaly-enabled": true,
+    "x-anomaly-direction": "higher-is-better",
   }),
 };
 

package/src/strategy.test.ts

@@ -10,7 +10,7 @@ describe("ScriptHealthCheckStrategy", () => {
       stderr?: string;
       timedOut?: boolean;
       error?: Error;
-    } = {}
+    } = {},
   ): ScriptExecutor => ({
     execute: mock(() =>
       config.error
@@ -20,7 +20,7 @@ describe("ScriptHealthCheckStrategy", () => {
             stdout: config.stdout ?? "",
             stderr: config.stderr ?? "",
             timedOut: config.timedOut ?? false,
-          })
+          }),
     ),
   });
 
@@ -45,7 +45,7 @@ describe("ScriptHealthCheckStrategy", () => {
   describe("client.exec", () => {
     it("should return successful result for successful script execution", async () => {
       const strategy = new ScriptHealthCheckStrategy(
-        createMockExecutor({ exitCode: 0, stdout: "OK" })
+        createMockExecutor({ exitCode: 0, stdout: "OK" }),
       );
       const connectedClient = await strategy.createClient({ timeout: 5000 });
 
@@ -63,7 +63,7 @@ describe("ScriptHealthCheckStrategy", () => {
 
     it("should return non-zero exit code for failed script", async () => {
       const strategy = new ScriptHealthCheckStrategy(
-        createMockExecutor({ exitCode: 1, stderr: "Error" })
+        createMockExecutor({ exitCode: 1, stderr: "Error" }),
       );
       const connectedClient = await strategy.createClient({ timeout: 5000 });
 
@@ -80,7 +80,7 @@ describe("ScriptHealthCheckStrategy", () => {
 
     it("should indicate timeout for timed out script", async () => {
       const strategy = new ScriptHealthCheckStrategy(
-        createMockExecutor({ timedOut: true, exitCode: -1 })
+        createMockExecutor({ timedOut: true, exitCode: -1 }),
       );
       const connectedClient = await strategy.createClient({ timeout: 5000 });
 
@@ -97,7 +97,7 @@ describe("ScriptHealthCheckStrategy", () => {
 
     it("should return error for execution error", async () => {
       const strategy = new ScriptHealthCheckStrategy(
-        createMockExecutor({ error: new Error("Command not found") })
+        createMockExecutor({ error: new Error("Command not found") }),
       );
       const connectedClient = await strategy.createClient({ timeout: 5000 });
 
@@ -131,7 +131,7 @@ describe("ScriptHealthCheckStrategy", () => {
           args: ["--verbose", "--env=prod"],
           cwd: "/opt/scripts",
           env: { API_KEY: "secret" },
-        })
+        }),
       );
 
       connectedClient.close();

package/src/strategy.ts

@@ -58,27 +58,40 @@ const scriptResultSchema = healthResultSchema({
   executed: healthResultBoolean({
     "x-chart-type": "boolean",
     "x-chart-label": "Executed",
+    "x-anomaly-enabled": true,
+    "x-anomaly-direction": "dominance",
   }),
   executionTimeMs: healthResultNumber({
     "x-chart-type": "line",
     "x-chart-label": "Execution Time",
     "x-chart-unit": "ms",
+    "x-anomaly-enabled": true,
+    "x-anomaly-direction": "lower-is-better",
+    "x-anomaly-sensitivity": 2,
+    "x-anomaly-confirmation-window": 3,
   }),
   exitCode: healthResultNumber({
     "x-chart-type": "counter",
     "x-chart-label": "Exit Code",
+    "x-anomaly-enabled": true,
+    "x-anomaly-direction": "dominance",
   }).optional(),
   success: healthResultBoolean({
     "x-chart-type": "boolean",
     "x-chart-label": "Success",
+    "x-anomaly-enabled": true,
+    "x-anomaly-direction": "dominance",
   }),
   timedOut: healthResultBoolean({
     "x-chart-type": "boolean",
     "x-chart-label": "Timed Out",
+    "x-anomaly-enabled": true,
+    "x-anomaly-direction": "dominance",
   }),
   error: healthResultString({
     "x-chart-type": "status",
     "x-chart-label": "Error",
+    "x-anomaly-enabled": false,
   }).optional(),
 });
 
@@ -90,19 +103,27 @@ const scriptAggregatedFields = {
     "x-chart-type": "line",
     "x-chart-label": "Avg Execution Time",
     "x-chart-unit": "ms",
+    "x-anomaly-enabled": true,
+    "x-anomaly-direction": "lower-is-better",
   }),
   successRate: aggregatedRate({
     "x-chart-type": "gauge",
     "x-chart-label": "Success Rate",
     "x-chart-unit": "%",
+    "x-anomaly-enabled": true,
+    "x-anomaly-direction": "higher-is-better",
   }),
   errorCount: aggregatedCounter({
     "x-chart-type": "counter",
     "x-chart-label": "Errors",
+    "x-anomaly-enabled": true,
+    "x-anomaly-direction": "lower-is-better",
   }),
   timeoutCount: aggregatedCounter({
     "x-chart-type": "counter",
     "x-chart-label": "Timeouts",
+    "x-anomaly-enabled": true,
+    "x-anomaly-direction": "lower-is-better",
   }),
 };