@checkstack/healthcheck-common 0.8.4 → 0.10.0

package/CHANGELOG.md

@@ -1,5 +1,53 @@
 # @checkstack/healthcheck-common
 
+## 0.10.0
+
+### Minor Changes
+
+- 54a5f80: ### Health Check Editor Redesign — IDE-Style Experience
+
+  Replaces the modal-based health check editor with a full-page, IDE-style experience:
+
+  - **Strategy Picker Page**: New `/config/create` page with categorized strategy discovery, search filtering, and grouped card grid layout
+  - **IDE Editor Page**: New `/config/:configId/edit` page with a split-view layout — explorer tree on the left, editor panel on the right
+  - **Strategy Categories**: Introduces `StrategyCategory` enum with 16 categories (Networking, Database, Infrastructure, etc.) — all 13 strategy plugins now declare their category
+  - **New RPC Endpoint**: Added `getConfiguration` (singular by ID) for efficient single-resource fetching on the edit page
+  - **Explorer Tree**: Left-hand navigation with General, Check Items (collectors), and Access Control sections, with real-time validation indicators
+  - **Validation Status Bar**: Bottom bar showing aggregated validation issues with clickable navigation
+  - **Unsaved Changes Guard**: Browser `beforeunload` protection when the form is dirty
+  - **Responsive Design**: Split-view on desktop, stacked layout on mobile
+  - **Deleted**: Legacy `HealthCheckEditor.tsx` modal component
+
+## 0.9.0
+
+### Minor Changes
+
+- 1f191cf: Add SYSTEM_STATUS_CHANGED signal and dependency-driven notification improvements
+
+  **healthcheck-common:**
+
+  - New `SYSTEM_STATUS_CHANGED` signal that fires only on system-level health status transitions (healthy ↔ degraded ↔ unhealthy), providing a low-noise alternative to `HEALTH_CHECK_RUN_COMPLETED` for coarse-grained reactivity
+
+  **healthcheck-backend:**
+
+  - Broadcast `SYSTEM_STATUS_CHANGED` signal at both status transition code paths in the queue executor
+
+  **healthcheck-frontend:**
+
+  - Switch `SystemHealthBadge` from `HEALTH_CHECK_RUN_COMPLETED` to `SYSTEM_STATUS_CHANGED` to reduce unnecessary refetch noise
+
+  **dashboard-frontend:**
+
+  - Switch `SystemBadgeDataProvider` from `HEALTH_CHECK_RUN_COMPLETED` to `SYSTEM_STATUS_CHANGED` for more efficient badge updates
+
+  **maintenance-frontend:**
+
+  - Clarify that notification suppression toggle also applies to downstream dependency-driven notifications
+
+  **incident-frontend:**
+
+  - Clarify that notification suppression toggle also applies to downstream dependency-driven notifications
+
 ## 0.8.4
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@checkstack/healthcheck-common",
-  "version": "0.8.4",
+  "version": "0.10.0",
   "type": "module",
   "exports": {
     ".": {
@@ -8,14 +8,14 @@
     }
   },
   "dependencies": {
-    "@checkstack/common": "0.6.3",
-    "@checkstack/signal-common": "0.1.7",
+    "@checkstack/common": "0.6.4",
+    "@checkstack/signal-common": "0.1.8",
     "zod": "^4.2.1"
   },
   "devDependencies": {
     "typescript": "^5.7.2",
-    "@checkstack/tsconfig": "0.0.3",
-    "@checkstack/scripts": "0.1.1"
+    "@checkstack/tsconfig": "0.0.4",
+    "@checkstack/scripts": "0.1.2"
   },
   "scripts": {
     "typecheck": "tsc --noEmit",

package/src/index.ts

@@ -1,16 +1,20 @@
 export * from "./access";
 export * from "./schemas";
 export * from "./zod-health-result";
+export * from "./strategy-category";
 
 // --- DTOs for API Responses ---
 
 /**
  * Represents a Health Check Strategy available in the system.
  */
+import type { StrategyCategory } from "./strategy-category";
+
 export interface HealthCheckStrategyDto {
   id: string;
   displayName: string;
   description?: string;
+  category: StrategyCategory;
   // schema is a JSON schema object derived from the Zod schema
   configSchema: Record<string, unknown>;
 }
@@ -61,3 +65,18 @@ export const HEALTH_CHECK_RUN_COMPLETED = createSignal(
     latencyMs: z.number().optional(),
   }),
 );
+
+/**
+ * Broadcast when a system's overall health status transitions.
+ * Only fires on actual status changes (e.g. healthy → degraded, unhealthy → healthy),
+ * NOT on every individual health check run. Use this for coarse-grained reactivity
+ * like dashboard badges and dependency map node statuses.
+ */
+export const SYSTEM_STATUS_CHANGED = createSignal(
+  "healthcheck.system.status-changed",
+  z.object({
+    systemId: z.string(),
+    previousStatus: z.enum(["healthy", "degraded", "unhealthy"]),
+    newStatus: z.enum(["healthy", "degraded", "unhealthy"]),
+  }),
+);

package/src/routes.ts

@@ -5,6 +5,8 @@ import { createRoutes } from "@checkstack/common";
  */
 export const healthcheckRoutes = createRoutes("healthcheck", {
   config: "/config",
+  create: "/config/create",
+  edit: "/config/:configId/edit",
   history: "/history",
   historyDetail: "/history/:systemId/:configurationId",
   historyRun: "/history/:systemId/:configurationId/:runId",

package/src/rpc-contract.ts

@@ -70,6 +70,14 @@ export const healthCheckContract = {
     z.object({ configurations: z.array(HealthCheckConfigurationSchema) }),
   ),
 
+  getConfiguration: proc({
+    operationType: "query",
+    userType: "authenticated",
+    access: [healthCheckAccess.configuration.read],
+  })
+    .input(z.object({ id: z.string() }))
+    .output(HealthCheckConfigurationSchema.optional()),
+
   createConfiguration: proc({
     operationType: "mutation",
     userType: "authenticated",

package/src/schemas.ts

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import { StrategyCategorySchema } from "./strategy-category";
 
 // --- API Request/Response Schemas (Zod) ---
 
@@ -6,6 +7,7 @@ export const HealthCheckStrategyDtoSchema = z.object({
   id: z.string(),
   displayName: z.string(),
   description: z.string().optional(),
+  category: StrategyCategorySchema,
   configSchema: z.record(z.string(), z.unknown()),
   /** JSON Schema for per-run result metadata (with chart annotations) */
   resultSchema: z.record(z.string(), z.unknown()).optional(),

package/src/strategy-category.ts

@@ -0,0 +1,106 @@
+import { z } from "zod";
+
+// =============================================================================
+// STRATEGY CATEGORIES
+// =============================================================================
+
+/**
+ * Predefined categories for health check strategies.
+ * Strategy plugins select from this enum at registration time.
+ */
+export const StrategyCategory = {
+  /** HTTP, DNS, TCP, Ping, UDP, SNMP, TLS */
+  NETWORKING: "networking",
+  /** Postgres, MySQL, Redis, MongoDB, ClickHouse */
+  DATABASE: "database",
+  /** SSH, Script, Hardware (CPU/Mem/Disk) */
+  INFRASTRUCTURE: "infrastructure",
+  /** Docker, Kubernetes, container health */
+  CONTAINERIZATION: "containerization",
+  /** S3, MinIO, NFS, backup verification */
+  STORAGE: "storage",
+  /** gRPC, GraphQL, WebSocket, SOAP */
+  APPLICATION: "application",
+  /** RabbitMQ, Kafka, MQTT, NATS, AMQP */
+  MESSAGING: "messaging",
+  /** SMTP, IMAP, POP3, deliverability */
+  EMAIL: "email",
+  /** AWS, Azure, GCP managed services */
+  CLOUD: "cloud",
+  /** Jenkins, GitLab, Jira, third-party APIs */
+  INTEGRATION: "integration",
+  /** LLM endpoints, model inference, GPU, API quotas */
+  AI: "ai",
+  /** TLS certificates, auth endpoints, OCSP, compliance */
+  SECURITY: "security",
+  /** MQTT devices, sensors, edge gateways */
+  IOT: "iot",
+  /** RCON, Source Query, game server protocols */
+  GAMING: "gaming",
+  /** Prometheus, metrics pipelines, log health */
+  OBSERVABILITY: "observability",
+  /** Catch-all for uncategorized strategies */
+  OTHER: "other",
+} as const;
+
+export type StrategyCategory =
+  (typeof StrategyCategory)[keyof typeof StrategyCategory];
+
+/**
+ * Zod schema for validating strategy categories.
+ */
+export const StrategyCategorySchema = z.enum([
+  StrategyCategory.NETWORKING,
+  StrategyCategory.DATABASE,
+  StrategyCategory.INFRASTRUCTURE,
+  StrategyCategory.CONTAINERIZATION,
+  StrategyCategory.STORAGE,
+  StrategyCategory.APPLICATION,
+  StrategyCategory.MESSAGING,
+  StrategyCategory.EMAIL,
+  StrategyCategory.CLOUD,
+  StrategyCategory.INTEGRATION,
+  StrategyCategory.AI,
+  StrategyCategory.SECURITY,
+  StrategyCategory.IOT,
+  StrategyCategory.GAMING,
+  StrategyCategory.OBSERVABILITY,
+  StrategyCategory.OTHER,
+]);
+
+// =============================================================================
+// CATEGORY DISPLAY METADATA
+// =============================================================================
+
+interface CategoryMeta {
+  /** Human-readable label for UI rendering */
+  label: string;
+  /** Sort order for UI grouping (lower = first) */
+  sortOrder: number;
+}
+
+/**
+ * Display metadata for each strategy category.
+ * Used by the Strategy Picker page for grouping and ordering.
+ */
+export const STRATEGY_CATEGORY_META: Record<StrategyCategory, CategoryMeta> = {
+  [StrategyCategory.NETWORKING]: { label: "Networking", sortOrder: 0 },
+  [StrategyCategory.DATABASE]: { label: "Databases", sortOrder: 1 },
+  [StrategyCategory.INFRASTRUCTURE]: { label: "Infrastructure", sortOrder: 2 },
+  [StrategyCategory.CONTAINERIZATION]: {
+    label: "Containerization",
+    sortOrder: 3,
+  },
+  [StrategyCategory.STORAGE]: { label: "Storage", sortOrder: 4 },
+  [StrategyCategory.APPLICATION]: { label: "Application", sortOrder: 5 },
+  [StrategyCategory.MESSAGING]: { label: "Messaging", sortOrder: 6 },
+  [StrategyCategory.EMAIL]: { label: "Email", sortOrder: 7 },
+  [StrategyCategory.CLOUD]: { label: "Cloud", sortOrder: 8 },
+  [StrategyCategory.INTEGRATION]: { label: "Integrations", sortOrder: 9 },
+  [StrategyCategory.AI]: { label: "AI & Machine Learning", sortOrder: 10 },
+  [StrategyCategory.SECURITY]: { label: "Security", sortOrder: 11 },
+  [StrategyCategory.IOT]: { label: "IoT", sortOrder: 12 },
+  [StrategyCategory.GAMING]: { label: "Gaming", sortOrder: 13 },
+  [StrategyCategory.OBSERVABILITY]: { label: "Observability", sortOrder: 14 },
+  [StrategyCategory.OTHER]: { label: "Other", sortOrder: 99 },
+};