@checkstack/healthcheck-common 0.9.0 → 0.10.1

package/CHANGELOG.md

@@ -1,5 +1,49 @@
 # @checkstack/healthcheck-common
 
+## 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
+
+- 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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@checkstack/healthcheck-common",
-  "version": "0.9.0",
+  "version": "0.10.1",
   "type": "module",
   "exports": {
     ".": {
@@ -14,7 +14,7 @@
   },
   "devDependencies": {
     "typescript": "^5.7.2",
-    "@checkstack/tsconfig": "0.0.4",
+    "@checkstack/tsconfig": "0.0.5",
     "@checkstack/scripts": "0.1.2"
   },
   "scripts": {

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>;
 }

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",
@@ -363,26 +371,6 @@ export const healthCheckContract = {
         ),
       }),
     ),
-
-  getAvailabilityStats: proc({
-    operationType: "query",
-    userType: "public",
-    access: [healthCheckAccess.status],
-  })
-    .input(
-      z.object({
-        systemId: z.string(),
-        configurationId: z.string(),
-      }),
-    )
-    .output(
-      z.object({
-        availability31Days: z.number().nullable(),
-        availability365Days: z.number().nullable(),
-        totalRuns31Days: z.number(),
-        totalRuns365Days: z.number(),
-      }),
-    ),
 };
 // Export contract type
 export type HealthCheckContract = typeof healthCheckContract;

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 },
+};