@checkstack/healthcheck-jenkins-backend 0.3.10 → 0.3.11

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # @checkstack/healthcheck-jenkins-backend
 
+## 0.3.11
+
+### 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.10
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@checkstack/healthcheck-jenkins-backend",
-  "version": "0.3.10",
+  "version": "0.3.11",
   "type": "module",
   "main": "src/index.ts",
   "checkstack": {
@@ -13,9 +13,9 @@
     "test": "bun test"
   },
   "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/collectors/build-history.test.ts

@@ -9,7 +9,7 @@ describe("BuildHistoryCollector", () => {
   const collector = new BuildHistoryCollector();
 
   const createMockClient = (
-    response: JenkinsResponse
+    response: JenkinsResponse,
   ): JenkinsTransportClient => ({
     exec: async () => response,
   });
@@ -99,7 +99,7 @@ describe("BuildHistoryCollector", () => {
     ];
 
     let aggregated = collector.mergeResult(undefined, runs[0]);
-      aggregated = collector.mergeResult(aggregated, runs[1]);
+    aggregated = collector.mergeResult(aggregated, runs[1]);
 
     expect(aggregated.avgSuccessRate.avg).toBe(70);
     expect(aggregated.avgBuildDuration.avg).toBe(70000);

package/src/collectors/build-history.ts

@@ -41,50 +41,70 @@ const buildHistoryResultSchema = z.object({
   totalBuilds: healthResultNumber({
     "x-chart-type": "counter",
     "x-chart-label": "Total Builds",
+    "x-anomaly-enabled": true,
+    "x-anomaly-direction": "deviation",
   }),
   successCount: healthResultNumber({
     "x-chart-type": "counter",
     "x-chart-label": "Successful",
+    "x-anomaly-enabled": true,
+    "x-anomaly-direction": "higher-is-better",
   }),
   failureCount: healthResultNumber({
     "x-chart-type": "counter",
     "x-chart-label": "Failed",
+    "x-anomaly-enabled": true,
+    "x-anomaly-direction": "lower-is-better",
   }),
   unstableCount: healthResultNumber({
     "x-chart-type": "counter",
     "x-chart-label": "Unstable",
+    "x-anomaly-enabled": true,
+    "x-anomaly-direction": "lower-is-better",
   }),
   abortedCount: healthResultNumber({
     "x-chart-type": "counter",
     "x-chart-label": "Aborted",
+    "x-anomaly-enabled": true,
+    "x-anomaly-direction": "lower-is-better",
   }),
   successRate: healthResultNumber({
     "x-chart-type": "gauge",
     "x-chart-label": "Success Rate",
     "x-chart-unit": "%",
+    "x-anomaly-enabled": true,
+    "x-anomaly-direction": "higher-is-better",
   }),
   avgDurationMs: healthResultNumber({
     "x-chart-type": "line",
     "x-chart-label": "Avg Duration",
     "x-chart-unit": "ms",
+    "x-anomaly-enabled": true,
+    "x-anomaly-direction": "lower-is-better",
   }),
   minDurationMs: healthResultNumber({
     "x-chart-type": "line",
     "x-chart-label": "Min Duration",
     "x-chart-unit": "ms",
+    "x-anomaly-enabled": true,
+    "x-anomaly-direction": "lower-is-better",
   }),
   maxDurationMs: healthResultNumber({
     "x-chart-type": "line",
     "x-chart-label": "Max Duration",
     "x-chart-unit": "ms",
+    "x-anomaly-enabled": true,
+    "x-anomaly-direction": "lower-is-better",
   }),
   lastSuccessBuildNumber: healthResultNumber({
     "x-chart-type": "counter",
     "x-chart-label": "Last Success #",
+    "x-anomaly-enabled": false,
   }).optional(),
   lastFailureBuildNumber: healthResultNumber({
     "x-chart-type": "counter",
     "x-chart-label": "Last Failure #",
+    "x-anomaly-enabled": false,
   }).optional(),
 });
 
@@ -96,11 +116,15 @@ const buildHistoryAggregatedFields = {
     "x-chart-type": "gauge",
     "x-chart-label": "Avg Success Rate",
     "x-chart-unit": "%",
+    "x-anomaly-enabled": true,
+    "x-anomaly-direction": "higher-is-better",
   }),
   avgBuildDuration: aggregatedAverage({
     "x-chart-type": "line",
     "x-chart-label": "Avg Build Duration",
     "x-chart-unit": "ms",
+    "x-anomaly-enabled": true,
+    "x-anomaly-direction": "lower-is-better",
   }),
 };
 

package/src/collectors/job-status.test.ts

@@ -70,7 +70,8 @@ describe("JobStatusCollector", () => {
       pluginId: "healthcheck-jenkins",
     });
 
-    expect(result.error).toBe("Last build: FAILURE");
+    // Failed builds are reported in result metrics, not as collector errors
+    expect(result.error).toBeUndefined();
     expect(result.result.lastBuildResult).toBe("FAILURE");
   });
 

package/src/collectors/job-status.ts

@@ -44,40 +44,52 @@ const jobStatusResultSchema = z.object({
   jobName: healthResultString({
     "x-chart-type": "text",
     "x-chart-label": "Job Name",
+    "x-anomaly-enabled": false,
   }),
   buildable: healthResultBoolean({
     "x-chart-type": "boolean",
     "x-chart-label": "Buildable",
+    "x-anomaly-enabled": true,
+    "x-anomaly-direction": "dominance",
   }),
   lastBuildNumber: healthResultNumber({
     "x-chart-type": "counter",
     "x-chart-label": "Last Build #",
+    "x-anomaly-enabled": false,
   }).optional(),
   lastBuildResult: healthResultString({
     "x-chart-type": "text",
     "x-chart-label": "Last Build Result",
+    "x-anomaly-enabled": false,
   }).optional(),
   lastBuildDurationMs: healthResultNumber({
     "x-chart-type": "line",
     "x-chart-label": "Build Duration",
     "x-chart-unit": "ms",
+    "x-anomaly-enabled": true,
+    "x-anomaly-direction": "lower-is-better",
   }).optional(),
   lastBuildTimestamp: healthResultNumber({
     "x-chart-type": "counter",
     "x-chart-label": "Last Build Time",
+    "x-anomaly-enabled": false,
   }).optional(),
   timeSinceLastBuildMs: healthResultNumber({
     "x-chart-type": "line",
     "x-chart-label": "Time Since Last Build",
     "x-chart-unit": "ms",
+    "x-anomaly-enabled": false,
   }).optional(),
   inQueue: healthResultBoolean({
     "x-chart-type": "boolean",
     "x-chart-label": "In Queue",
+    "x-anomaly-enabled": true,
+    "x-anomaly-direction": "dominance",
   }),
   color: healthResultString({
     "x-chart-type": "text",
     "x-chart-label": "Status Color",
+    "x-anomaly-enabled": false,
   }),
 });
 
@@ -89,16 +101,22 @@ const jobStatusAggregatedFields = {
     "x-chart-type": "line",
     "x-chart-label": "Avg Build Duration",
     "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",
   }),
   buildableRate: aggregatedRate({
     "x-chart-type": "gauge",
     "x-chart-label": "Enabled Rate",
     "x-chart-unit": "%",
+    "x-anomaly-enabled": true,
+    "x-anomaly-direction": "higher-is-better",
   }),
 };
 

package/src/collectors/node-health.test.ts

@@ -107,7 +107,9 @@ describe("NodeHealthCollector", () => {
 
     expect(result.result.offlineNodes).toBe(1);
     expect(result.result.nodeOffline).toBe(true);
-    expect(result.error).toContain("Connection lost");
+    expect(result.result.nodeOfflineReason).toBe("Connection lost");
+    // Offline status is reported in result metrics, not as an error
+    expect(result.error).toBeUndefined();
   });
 
   it("should aggregate correctly", () => {
@@ -141,7 +143,7 @@ describe("NodeHealthCollector", () => {
     ];
 
     let aggregated = collector.mergeResult(undefined, runs[0]);
-      aggregated = collector.mergeResult(aggregated, runs[1]);
+    aggregated = collector.mergeResult(aggregated, runs[1]);
 
     expect(aggregated.avgOnlineNodes.avg).toBe(4);
     expect(aggregated.avgUtilization.avg).toBe(60);

package/src/collectors/node-health.ts

@@ -40,44 +40,62 @@ const nodeHealthResultSchema = z.object({
   totalNodes: healthResultNumber({
     "x-chart-type": "counter",
     "x-chart-label": "Total Nodes",
+    "x-anomaly-enabled": true,
+    "x-anomaly-direction": "deviation",
   }),
   onlineNodes: healthResultNumber({
     "x-chart-type": "counter",
     "x-chart-label": "Online Nodes",
+    "x-anomaly-enabled": true,
+    "x-anomaly-direction": "higher-is-better",
   }),
   offlineNodes: healthResultNumber({
     "x-chart-type": "counter",
     "x-chart-label": "Offline Nodes",
+    "x-anomaly-enabled": true,
+    "x-anomaly-direction": "lower-is-better",
   }),
   busyExecutors: healthResultNumber({
     "x-chart-type": "counter",
     "x-chart-label": "Busy Executors",
+    "x-anomaly-enabled": true,
+    "x-anomaly-direction": "deviation",
   }),
   idleExecutors: healthResultNumber({
     "x-chart-type": "counter",
     "x-chart-label": "Idle Executors",
+    "x-anomaly-enabled": true,
+    "x-anomaly-direction": "deviation",
   }),
   totalExecutors: healthResultNumber({
     "x-chart-type": "counter",
     "x-chart-label": "Total Executors",
+    "x-anomaly-enabled": true,
+    "x-anomaly-direction": "deviation",
   }),
   executorUtilization: healthResultNumber({
     "x-chart-type": "gauge",
     "x-chart-label": "Executor Utilization",
     "x-chart-unit": "%",
+    "x-anomaly-enabled": true,
+    "x-anomaly-direction": "lower-is-better",
   }),
   // For single node mode
   nodeDisplayName: healthResultString({
     "x-chart-type": "text",
     "x-chart-label": "Node Name",
+    "x-anomaly-enabled": false,
   }).optional(),
   nodeOffline: healthResultBoolean({
     "x-chart-type": "boolean",
     "x-chart-label": "Node Offline",
+    "x-anomaly-enabled": true,
+    "x-anomaly-direction": "dominance",
   }).optional(),
   nodeOfflineReason: healthResultString({
     "x-chart-type": "text",
     "x-chart-label": "Offline Reason",
+    "x-anomaly-enabled": false,
   }).optional(),
 });
 
@@ -88,15 +106,21 @@ const nodeHealthAggregatedFields = {
   avgOnlineNodes: aggregatedAverage({
     "x-chart-type": "line",
     "x-chart-label": "Avg Online Nodes",
+    "x-anomaly-enabled": true,
+    "x-anomaly-direction": "higher-is-better",
   }),
   avgUtilization: aggregatedAverage({
     "x-chart-type": "gauge",
     "x-chart-label": "Avg Utilization",
     "x-chart-unit": "%",
+    "x-anomaly-enabled": true,
+    "x-anomaly-direction": "lower-is-better",
   }),
   minOnlineNodes: aggregatedMinMax({
     "x-chart-type": "line",
     "x-chart-label": "Min Online Nodes",
+    "x-anomaly-enabled": true,
+    "x-anomaly-direction": "higher-is-better",
   }),
 };
 

package/src/collectors/queue-info.test.ts

@@ -9,7 +9,7 @@ describe("QueueInfoCollector", () => {
   const collector = new QueueInfoCollector();
 
   const createMockClient = (
-    response: JenkinsResponse
+    response: JenkinsResponse,
   ): JenkinsTransportClient => ({
     exec: async () => response,
   });
@@ -56,8 +56,8 @@ describe("QueueInfoCollector", () => {
     expect(result.result.buildableCount).toBe(2);
     expect(result.result.stuckCount).toBe(1);
     expect(result.result.oldestWaitingMs).toBeGreaterThanOrEqual(30000);
-    // Error should be set because stuck > 0
-    expect(result.error).toContain("stuck");
+    // Non-critical status (stuck items) is reported in result metrics, not as an error
+    expect(result.error).toBeUndefined();
   });
 
   it("should report no error for empty queue", async () => {
@@ -105,7 +105,7 @@ describe("QueueInfoCollector", () => {
     ];
 
     let aggregated = collector.mergeResult(undefined, runs[0]);
-      aggregated = collector.mergeResult(aggregated, runs[1]);
+    aggregated = collector.mergeResult(aggregated, runs[1]);
 
     expect(aggregated.avgQueueLength.avg).toBe(4);
     expect(aggregated.maxQueueLength.max).toBe(5);

package/src/collectors/queue-info.ts

@@ -31,28 +31,42 @@ const queueInfoResultSchema = z.object({
   queueLength: healthResultNumber({
     "x-chart-type": "counter",
     "x-chart-label": "Queue Length",
+    "x-anomaly-enabled": true,
+    "x-anomaly-direction": "lower-is-better",
+    "x-anomaly-sensitivity": 2,
+    "x-anomaly-confirmation-window": 4,
   }),
   blockedCount: healthResultNumber({
     "x-chart-type": "counter",
     "x-chart-label": "Blocked Items",
+    "x-anomaly-enabled": true,
+    "x-anomaly-direction": "lower-is-better",
   }),
   buildableCount: healthResultNumber({
     "x-chart-type": "counter",
     "x-chart-label": "Buildable Items",
+    "x-anomaly-enabled": true,
+    "x-anomaly-direction": "deviation",
   }),
   stuckCount: healthResultNumber({
     "x-chart-type": "counter",
     "x-chart-label": "Stuck Items",
+    "x-anomaly-enabled": true,
+    "x-anomaly-direction": "lower-is-better",
   }),
   oldestWaitingMs: healthResultNumber({
     "x-chart-type": "line",
     "x-chart-label": "Oldest Wait Time",
     "x-chart-unit": "ms",
+    "x-anomaly-enabled": true,
+    "x-anomaly-direction": "lower-is-better",
   }),
   avgWaitingMs: healthResultNumber({
     "x-chart-type": "line",
     "x-chart-label": "Avg Wait Time",
     "x-chart-unit": "ms",
+    "x-anomaly-enabled": true,
+    "x-anomaly-direction": "lower-is-better",
   }),
 });
 
@@ -63,15 +77,21 @@ const queueInfoAggregatedFields = {
   avgQueueLength: aggregatedAverage({
     "x-chart-type": "line",
     "x-chart-label": "Avg Queue Length",
+    "x-anomaly-enabled": true,
+    "x-anomaly-direction": "lower-is-better",
   }),
   maxQueueLength: aggregatedMinMax({
     "x-chart-type": "line",
     "x-chart-label": "Max Queue Length",
+    "x-anomaly-enabled": true,
+    "x-anomaly-direction": "lower-is-better",
   }),
   avgWaitTime: aggregatedAverage({
     "x-chart-type": "line",
     "x-chart-label": "Avg Wait Time",
     "x-chart-unit": "ms",
+    "x-anomaly-enabled": true,
+    "x-anomaly-direction": "lower-is-better",
   }),
 };
 

package/src/collectors/server-info.ts

@@ -32,27 +32,36 @@ const serverInfoResultSchema = z.object({
   jenkinsVersion: healthResultString({
     "x-chart-type": "text",
     "x-chart-label": "Jenkins Version",
+    "x-anomaly-enabled": false,
   }),
   mode: healthResultString({
     "x-chart-type": "text",
     "x-chart-label": "Server Mode",
+    "x-anomaly-enabled": false,
   }),
   numExecutors: healthResultNumber({
     "x-chart-type": "counter",
     "x-chart-label": "Executors",
+    "x-anomaly-enabled": true,
+    "x-anomaly-direction": "deviation",
   }),
   usableWorkers: healthResultNumber({
     "x-chart-type": "counter",
     "x-chart-label": "Usable Workers",
+    "x-anomaly-enabled": true,
+    "x-anomaly-direction": "deviation",
   }),
   totalJobs: healthResultNumber({
     "x-chart-type": "counter",
     "x-chart-label": "Total Jobs",
+    "x-anomaly-enabled": true,
+    "x-anomaly-direction": "deviation",
   }),
   uptime: healthResultNumber({
     "x-chart-type": "line",
     "x-chart-label": "Uptime",
     "x-chart-unit": "hours",
+    "x-anomaly-enabled": false,
   }).optional(),
 });
 
@@ -63,10 +72,14 @@ const serverInfoAggregatedFields = {
   avgExecutors: aggregatedAverage({
     "x-chart-type": "line",
     "x-chart-label": "Avg Executors",
+    "x-anomaly-enabled": true,
+    "x-anomaly-direction": "deviation",
   }),
   avgTotalJobs: aggregatedAverage({
     "x-chart-type": "line",
     "x-chart-label": "Avg Jobs",
+    "x-anomaly-enabled": true,
+    "x-anomaly-direction": "deviation",
   }),
 };
 

package/src/index.ts

@@ -33,7 +33,7 @@ export default createBackendPlugin({
         collectorRegistry.register(new NodeHealthCollector());
 
         logger.info(
-          "✅ Jenkins health check registered (strategy + 5 collectors)"
+          "✅ Jenkins health check registered (strategy + 5 collectors)",
         );
       },
     });

package/src/strategy.ts

@@ -57,15 +57,22 @@ const jenkinsResultSchema = healthResultSchema({
   connected: healthResultBoolean({
     "x-chart-type": "boolean",
     "x-chart-label": "Connected",
+    "x-anomaly-enabled": true,
+    "x-anomaly-direction": "dominance",
   }),
   responseTimeMs: healthResultNumber({
     "x-chart-type": "line",
     "x-chart-label": "Response Time",
     "x-chart-unit": "ms",
+    "x-anomaly-enabled": true,
+    "x-anomaly-direction": "lower-is-better",
+    "x-anomaly-sensitivity": 2,
+    "x-anomaly-confirmation-window": 3,
   }).optional(),
   error: healthResultString({
     "x-chart-type": "status",
     "x-chart-label": "Error",
+    "x-anomaly-enabled": false,
   }).optional(),
 });
 
@@ -77,15 +84,21 @@ const jenkinsAggregatedFields = {
     "x-chart-type": "gauge",
     "x-chart-label": "Success Rate",
     "x-chart-unit": "%",
+    "x-anomaly-enabled": true,
+    "x-anomaly-direction": "higher-is-better",
   }),
   avgResponseTimeMs: aggregatedAverage({
     "x-chart-type": "line",
     "x-chart-label": "Avg Response Time",
     "x-chart-unit": "ms",
+    "x-anomaly-enabled": true,
+    "x-anomaly-direction": "lower-is-better",
   }),
   errorCount: aggregatedCounter({
     "x-chart-type": "counter",
     "x-chart-label": "Errors",
+    "x-anomaly-enabled": true,
+    "x-anomaly-direction": "lower-is-better",
   }),
 };
 
@@ -188,8 +201,7 @@ export class JenkinsHealthCheckStrategy implements HealthCheckStrategy<
         } catch (error) {
           clearTimeout(timeoutId);
 
-          const errorMessage =
-            extractErrorMessage(error);
+          const errorMessage = extractErrorMessage(error);
           return {
             statusCode: 0,
             data: undefined,