@checkstack/healthcheck-common 0.10.0 → 0.11.0

package/CHANGELOG.md

@@ -1,5 +1,84 @@
 # @checkstack/healthcheck-common
 
+## 0.11.0
+
+### Minor Changes
+
+- 26d8bae: Distributed satellite health checks and Assignment IDE page
+
+  **Satellite System**
+
+  - New `satellite-backend`, `satellite-common`, `satellite-frontend`, and `satellite` agent packages for distributed health check execution
+  - WebSocket-based satellite connectivity with authentication, heartbeats, and live configuration push
+  - Satellite management UI with create dialog, status badges, and list page
+
+  **Live Configuration Updates**
+
+  - Added `assignmentChanged` hook to `healthcheck-backend` for cross-plugin communication
+  - `satellite-backend` subscribes to assignment changes and pushes config updates to connected satellites in real-time
+
+  **Assignment IDE Page**
+
+  - Replaced the 1028-line modal-based `SystemHealthCheckAssignment` component with a full-page IDE layout
+  - New modular components: `AssignmentTree`, `GeneralPanel`, `ThresholdsPanel`, `RetentionPanel`, `ExecutionPanel`
+  - Added unassign capability and sorted assignment lists for stable ordering
+
+  **Shared IDE Primitives**
+
+  - Extracted `IDETreeNode`, `IDETreeSection`, `IDEStatusBar`, `IDELayout` to `@checkstack/ui` for cross-plugin reuse
+  - Migrated existing health check IDE editor to use shared primitives
+
+  **Infrastructure**
+
+  - Added `Dockerfile.satellite` for containerized satellite deployment
+  - WebSocket route registry in `@checkstack/backend` and `@checkstack/backend-api`
+
+- 26d8bae: Source attribution and filtering for satellite health checks
+
+  **Source Attribution**
+
+  - Fixed satellite result attribution: runs from satellites now correctly display their source instead of defaulting to "Local"
+  - Added `sourceId` and `sourceLabel` to both public and detailed history API responses
+
+  **Source Filtering**
+
+  - Added `sourceFilter` parameter to `getHistory`, `getDetailedHistory`, and `getDetailedAggregatedHistory` RPC endpoints
+  - Source filter supports "local" (core-only), specific satellite UUID, or all sources
+  - Filter applies to all three aggregation tiers (raw, hourly, daily)
+
+  **Frontend**
+
+  - System detail accordion shows source filter buttons (All / Local / per-satellite) next to date range filter
+  - Filter applies to both charts and recent runs table
+  - Source column added to the recent runs table with Local/Remote badges
+  - Health check history detail page includes per-satellite source filter buttons
+
+## 0.10.1
+
+### Patch Changes
+
+- 3c34b07: Complete SLO Reliability Engine frontend and backend
+
+  **Frontend** — 7 new visualization components:
+
+  - `StreakCounter`: Fire-themed compliance streak counter with color-coded flame and best-streak trophy
+  - `AchievementBadge`: Emoji-labeled badges for 9 achievement types with hover tooltip
+  - `AttributionChart`: Horizontal stacked bar showing error budget split (self/upstream/remaining)
+  - `DowntimeTimeline`: Dot-and-line timeline with attribution badges and timestamps
+  - `SloTrendChart`: Pure SVG availability trend line chart from daily snapshots
+  - `MilestoneFeed`: Organization-wide milestone feed on the SLO overview sidebar
+  - `DependencyExclusionConfig`: Interactive upstream dependency picker for SLO editor
+
+  **Backend** — Weekly digest scheduled integration event:
+
+  - `weekly-digest.ts`: Cron job (Monday 09:00 UTC) emitting SLO performance summary
+  - Top/worst performers, breach counts, and streak data delivered via configured notification channels
+  - New `sloWeeklyDigest` hook registered as integration event
+
+- Updated dependencies [d1a2796]
+  - @checkstack/common@0.6.5
+  - @checkstack/signal-common@0.1.9
+
 ## 0.10.0
 
 ### Minor Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@checkstack/healthcheck-common",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "type": "module",
   "exports": {
     ".": {
@@ -8,13 +8,13 @@
     }
   },
   "dependencies": {
-    "@checkstack/common": "0.6.4",
-    "@checkstack/signal-common": "0.1.8",
+    "@checkstack/common": "0.6.5",
+    "@checkstack/signal-common": "0.1.9",
     "zod": "^4.2.1"
   },
   "devDependencies": {
     "typescript": "^5.7.2",
-    "@checkstack/tsconfig": "0.0.4",
+    "@checkstack/tsconfig": "0.0.5",
     "@checkstack/scripts": "0.1.2"
   },
   "scripts": {

package/src/routes.ts

@@ -7,6 +7,7 @@ export const healthcheckRoutes = createRoutes("healthcheck", {
   config: "/config",
   create: "/config/create",
   edit: "/config/:configId/edit",
+  assignments: "/assignments/:systemId",
   history: "/history",
   historyDetail: "/history/:systemId/:configurationId",
   historyRun: "/history/:systemId/:configurationId/:runId",

package/src/rpc-contract.ts

@@ -12,6 +12,7 @@ import {
   HealthCheckRunSchema,
   HealthCheckRunPublicSchema,
   HealthCheckStatusSchema,
+  HealthCheckRunResultSchema,
   StateThresholdsSchema,
   RetentionConfigSchema,
   AggregatedBucketBaseSchema,
@@ -148,6 +149,10 @@ export const healthCheckContract = {
           configurationName: z.string(),
           enabled: z.boolean(),
           stateThresholds: StateThresholdsSchema.optional(),
+          /** IDs of satellites assigned to execute this health check */
+          satelliteIds: z.array(z.string()).optional(),
+          /** Whether to also run this check locally on the core (default: true) */
+          includeLocal: z.boolean(),
         }),
       ),
     ),
@@ -228,6 +233,8 @@ export const healthCheckContract = {
         configurationId: z.string().optional(),
         startDate: z.date().optional(),
         endDate: z.date().optional(),
+        /** Filter by source: "local" = core only, satellite UUID = specific satellite, undefined = all */
+        sourceFilter: z.string().optional(),
         limit: z.number().optional().default(10),
         offset: z.number().optional().default(0),
         sortOrder: z.enum(["asc", "desc"]),
@@ -251,6 +258,8 @@ export const healthCheckContract = {
         configurationId: z.string().optional(),
         startDate: z.date().optional(),
         endDate: z.date().optional(),
+        /** Filter by source: "local" = core only, satellite UUID = specific satellite, undefined = all */
+        sourceFilter: z.string().optional(),
         limit: z.number().optional().default(10),
         offset: z.number().optional().default(0),
         sortOrder: z.enum(["asc", "desc"]),
@@ -309,6 +318,8 @@ export const healthCheckContract = {
         configurationId: z.string(),
         startDate: z.date(),
         endDate: z.date(),
+        /** Filter by source: "local" = core only, satellite UUID = specific satellite, undefined = all */
+        sourceFilter: z.string().optional(),
         /** Target number of data points (default: 500). Bucket interval is calculated as (endDate - startDate) / targetPoints */
         targetPoints: z.number().min(10).max(2000).default(500),
       }),
@@ -372,25 +383,66 @@ export const healthCheckContract = {
       }),
     ),
 
-  getAvailabilityStats: proc({
+  // ==========================================================================
+  // SERVICE INTERFACE (userType: "service" — backend-to-backend only)
+  // Used by satellite-backend to fetch assignments and submit results.
+  // ==========================================================================
+
+  getAssignmentsForSatellite: proc({
     operationType: "query",
-    userType: "public",
-    access: [healthCheckAccess.status],
+    userType: "service",
+    access: [],
+  })
+    .input(z.object({ satelliteId: z.string() }))
+    .output(
+      z.array(
+        z.object({
+          configId: z.string(),
+          systemId: z.string(),
+          strategyId: z.string(),
+          config: z.record(z.string(), z.unknown()),
+          collectors: z
+            .array(
+              z.object({
+                id: z.string(),
+                collectorId: z.string(),
+                config: z.record(z.string(), z.unknown()),
+                assertions: z
+                  .array(
+                    z.object({
+                      field: z.string(),
+                      jsonPath: z.string().optional(),
+                      operator: z.string(),
+                      value: z.unknown().optional(),
+                    }),
+                  )
+                  .optional(),
+              }),
+            )
+            .optional(),
+          intervalSeconds: z.number(),
+        }),
+      ),
+    ),
+
+  ingestSatelliteResult: proc({
+    operationType: "mutation",
+    userType: "service",
+    access: [],
   })
     .input(
       z.object({
+        configId: z.string(),
         systemId: z.string(),
-        configurationId: z.string(),
+        status: HealthCheckStatusSchema,
+        latencyMs: z.number().optional(),
+        result: HealthCheckRunResultSchema.optional(),
+        executedAt: z.string(),
+        sourceId: z.string(),
+        sourceLabel: z.string(),
       }),
     )
-    .output(
-      z.object({
-        availability31Days: z.number().nullable(),
-        availability365Days: z.number().nullable(),
-        totalRuns31Days: z.number(),
-        totalRuns365Days: z.number(),
-      }),
-    ),
+    .output(z.void()),
 };
 // Export contract type
 export type HealthCheckContract = typeof healthCheckContract;

package/src/schemas.ts

@@ -124,6 +124,25 @@ export const HealthCheckStatusSchema = z.enum([
 
 export type HealthCheckStatus = z.infer<typeof HealthCheckStatusSchema>;
 
+/**
+ * Canonical shape for a single health check run result.
+ * Both the local queue-executor and satellite agent MUST produce this shape
+ * to ensure the frontend (auto-charts, history detail) renders correctly.
+ */
+export const HealthCheckRunResultSchema = z.object({
+  status: HealthCheckStatusSchema,
+  latencyMs: z.number(),
+  message: z.string().optional(),
+  metadata: z.object({
+    connected: z.boolean(),
+    connectionTimeMs: z.number().optional(),
+    collectors: z.record(z.string(), z.unknown()).optional(),
+    error: z.string().optional(),
+  }),
+});
+
+export type HealthCheckRunResult = z.infer<typeof HealthCheckRunResultSchema>;
+
 // --- State Threshold Schemas ---
 
 /**
@@ -192,6 +211,10 @@ export const AssociateHealthCheckSchema = z.object({
   configurationId: z.string().uuid(),
   enabled: z.boolean().default(true),
   stateThresholds: StateThresholdsSchema.optional(),
+  /** IDs of satellites assigned to execute this health check */
+  satelliteIds: z.array(z.string()).optional(),
+  /** Whether to also run this check locally on the core instance (default: true) */
+  includeLocal: z.boolean().default(true),
 });
 
 export type AssociateHealthCheck = z.infer<typeof AssociateHealthCheckSchema>;
@@ -210,6 +233,10 @@ export const HealthCheckRunSchema = z.object({
   result: z.record(z.string(), z.unknown()),
   timestamp: z.date(),
   latencyMs: z.number().optional(),
+  /** Source ID for result attribution (null = local core, UUID = satellite) */
+  sourceId: z.string().optional(),
+  /** Human-readable source label (e.g. "Local" or "EU West (eu-west-1)") */
+  sourceLabel: z.string().optional(),
 });
 
 export type HealthCheckRun = z.infer<typeof HealthCheckRunSchema>;
@@ -246,6 +273,10 @@ export const HealthCheckRunPublicSchema = z.object({
   status: HealthCheckStatusSchema,
   timestamp: z.date(),
   latencyMs: z.number().optional(),
+  /** Source ID for result attribution (null = local core, UUID = satellite) */
+  sourceId: z.string().optional(),
+  /** Human-readable source label (e.g. "Local" or "EU West (eu-west-1)") */
+  sourceLabel: z.string().optional(),
 });
 
 export type HealthCheckRunPublic = z.infer<typeof HealthCheckRunPublicSchema>;