@checkstack/slo-backend 0.4.6 → 0.5.0

package/CHANGELOG.md

@@ -1,5 +1,129 @@
 # @checkstack/slo-backend
 
+## 0.5.0
+
+### Minor Changes
+
+- 41c77f4: feat(automation): type enum-able trigger/artifact fields as enums for editor value autocompletion
+
+  The automation editor's staged completion offers concrete values after a
+  comparator (`{{ trigger.payload.severity == "high" }}`) only when the
+  field's JSON Schema carries an `enum`. Several trigger payload + artifact
+  schemas declared closed-set fields as loose `z.string()`, so no values
+  were suggested. Tightened them to the canonical enums that already
+  existed in each plugin's `-common` package (and matched the hook payload
+  types in lockstep so the trigger's `payloadSchema` and `hook` keep the
+  same `TPayload`):
+
+  - **incident** — trigger payloads: `severity` → `IncidentSeverityEnum`,
+    `status` / `statusChange` → `IncidentStatusEnum`.
+  - **healthcheck** — trigger payloads: `previousStatus` / `newStatus` /
+    `status` → `HealthCheckStatusSchema` (across systemDegraded,
+    systemHealthy, systemHealthChanged, checkFailed; plus checkCompleted's
+    hook type).
+  - **dependency** — trigger + artifact: `impactType` → `ImpactTypeSchema`;
+    impactPropagated `previousState` / `newState` → `DerivedStateSchema`.
+    Also deduped the inline `impactTypeSchema` action-config enum to reuse
+    the canonical `ImpactTypeSchema`.
+  - **maintenance** — trigger + artifact: `status` →
+    `MaintenanceStatusEnum`; deduped the inline `maintenanceStatusEnum`
+    (used by `add_update.statusChange`) to the canonical one.
+  - **slo** — `achievement.unlocked` trigger + hook: `achievement` →
+    `AchievementTypeSchema`.
+
+  Runtime behaviour is unchanged — these fields always carried valid enum
+  values (the underlying records are enum-constrained); only the schema
+  types were loose. The hook payload generics are now precise too, which
+  caught one stale test fixture asserting an invalid `impactType: "soft"`.
+
+  Fields that look enum-ish but are genuinely free-form were intentionally
+  left as `z.string()`: satellite `region` (user-entered), Jira issue
+  `status` (per-instance workflow name), notification `strategyQualifiedId`
+  / `errorMessage`, healthcheck collector `result`, and script
+  `stdout` / `stderr`.
+
+### Patch Changes
+
+- 41c77f4: feat(automation): one-time migration of webhook subscriptions + remove legacy integration backend
+
+  **BREAKING CHANGES** (platform is in BETA — no major bump):
+
+  - `IntegrationProvider` no longer carries `config` (subscription
+    config) or `deliver`. The interface now models a connection provider
+    only: connection schema + `getConnectionOptions` + `testConnection`.
+  - The legacy subscription / delivery-log / event endpoints
+    (`listSubscriptions`, `createSubscription`, `getDeliveryLogs`,
+    `listEventTypes`, …) are removed from `integrationContract`.
+  - `delivery-coordinator`, `hook-subscriber`, `event-registry`, and the
+    `integrationEventExtensionPoint` are deleted. Plugins that
+    previously called `integrationEvents.registerEvent(...)` now
+    register their hooks as automation triggers via
+    `automationTriggerExtensionPoint.registerTrigger(...)`.
+  - Frontend pages `IntegrationsPage` and `DeliveryLogsPage` are gone;
+    the integration plugin's only remaining UI is connection
+    management. Subscription management lives under `/automation/...`.
+  - `webhook_subscriptions` and `delivery_logs` tables stay in the
+    database for one release as a safety net (no code reads or writes
+    them), and will be dropped in a follow-up migration.
+
+  **New**:
+
+  - `jira.create_issue`, `teams.post_message`, `webex.post_message`,
+    `webhook.send`, `integration-script.run_shell`, and
+    `integration-script.run_script` actions registered against the
+    Automation Platform with matching `*.message`, `*.delivery`,
+    `shell.result`, and `script.result` artifact types. The script
+    plugin exposes **two** actions — `run_shell` runs bash via the
+    shared `ShellScriptRunner` (Monaco `shell` editor), `run_script`
+    runs an ESM module in a Bun subprocess via `EsmScriptRunner`
+    (Monaco `typescript` editor + `defineIntegration` helper) — to
+    preserve the legacy provider split. `jira.create_issue` keeps the
+    dynamic field-mapping dropdown (driven by
+    `JIRA_RESOLVERS.FIELD_OPTIONS`).
+  - One-time data migration runs on boot in
+    `automation-backend.afterPluginsReady`. It reads
+    `webhook_subscriptions` via a new service RPC
+    `IntegrationApi.listLegacySubscriptions`, translates each row into
+    a single-trigger / single-action automation (marked with
+    `managed_by = "migrated-subscription:<id>"`), and is idempotent
+    across restarts.
+  - Failed translations are recorded in a new
+    `automation_migration_failures` table and surfaced via
+    `AutomationApi.listMigrationFailures` /
+    `acknowledgeMigrationFailure` so admins can review and re-create
+    failed entries by hand.
+
+- Updated dependencies [e2d6f25]
+- Updated dependencies [41c77f4]
+- Updated dependencies [41c77f4]
+- Updated dependencies [e1a2077]
+- Updated dependencies [41c77f4]
+- Updated dependencies [41c77f4]
+- Updated dependencies [41c77f4]
+- Updated dependencies [41c77f4]
+- Updated dependencies [41c77f4]
+- Updated dependencies [41c77f4]
+- Updated dependencies [41c77f4]
+- Updated dependencies [6d52276]
+- Updated dependencies [6d52276]
+- Updated dependencies [35bc682]
+  - @checkstack/automation-backend@0.2.0
+  - @checkstack/healthcheck-backend@1.3.0
+  - @checkstack/catalog-backend@1.2.0
+  - @checkstack/common@0.12.0
+  - @checkstack/backend-api@0.18.0
+  - @checkstack/healthcheck-common@1.3.0
+  - @checkstack/catalog-common@2.2.3
+  - @checkstack/dependency-common@1.1.3
+  - @checkstack/slo-common@0.4.2
+  - @checkstack/command-backend@0.1.31
+  - @checkstack/gitops-backend@0.3.7
+  - @checkstack/gitops-common@0.4.2
+  - @checkstack/signal-common@0.2.5
+  - @checkstack/cache-api@0.3.6
+  - @checkstack/queue-api@0.3.6
+  - @checkstack/cache-utils@0.2.11
+
 ## 0.4.6
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@checkstack/slo-backend",
-  "version": "0.4.6",
+  "version": "0.5.0",
   "license": "Elastic-2.0",
   "type": "module",
   "main": "src/index.ts",
@@ -14,23 +14,22 @@
     "lint:code": "eslint . --max-warnings 0"
   },
   "dependencies": {
-    "@checkstack/backend-api": "0.17.0",
-    "@checkstack/cache-api": "0.3.4",
-    "@checkstack/cache-utils": "0.2.9",
+    "@checkstack/backend-api": "0.17.1",
+    "@checkstack/cache-api": "0.3.5",
+    "@checkstack/cache-utils": "0.2.10",
     "@checkstack/slo-common": "0.4.1",
-    "@checkstack/healthcheck-common": "1.1.2",
-    "@checkstack/healthcheck-backend": "1.1.4",
+    "@checkstack/healthcheck-common": "1.2.0",
+    "@checkstack/healthcheck-backend": "1.2.0",
     "@checkstack/dependency-common": "1.1.2",
     "@checkstack/catalog-common": "2.2.2",
-    "@checkstack/catalog-backend": "1.1.5",
-    "@checkstack/command-backend": "0.1.29",
+    "@checkstack/catalog-backend": "1.1.6",
+    "@checkstack/command-backend": "0.1.30",
     "@checkstack/signal-common": "0.2.4",
-    "@checkstack/integration-backend": "0.1.29",
-    "@checkstack/integration-common": "0.5.0",
-    "@checkstack/gitops-backend": "0.3.5",
+    "@checkstack/automation-backend": "0.1.0",
+    "@checkstack/gitops-backend": "0.3.6",
     "@checkstack/gitops-common": "0.4.1",
     "@checkstack/common": "0.11.0",
-    "@checkstack/queue-api": "0.3.4",
+    "@checkstack/queue-api": "0.3.5",
     "drizzle-orm": "^0.45.0",
     "zod": "^4.2.1",
     "@orpc/server": "^1.13.2"
@@ -38,7 +37,7 @@
   "devDependencies": {
     "@checkstack/drizzle-helper": "0.0.5",
     "@checkstack/scripts": "0.3.3",
-    "@checkstack/test-utils-backend": "0.1.29",
+    "@checkstack/test-utils-backend": "0.1.30",
     "@checkstack/tsconfig": "0.0.7",
     "@types/bun": "^1.0.0",
     "drizzle-kit": "^0.31.10",

package/src/hooks.ts

@@ -1,4 +1,5 @@
 import { createHook } from "@checkstack/backend-api";
+import type { AchievementType } from "@checkstack/slo-common";
 
 /**
  * SLO hooks for cross-plugin communication.
@@ -50,7 +51,7 @@ export const sloHooks = {
    */
   sloAchievementUnlocked: createHook<{
     systemId: string;
-    achievement: string;
+    achievement: AchievementType;
   }>("slo.achievement.unlocked"),
 
   /**

package/src/index.ts

@@ -7,9 +7,10 @@ import {
   pluginMetadata,
   sloContract,
   sloRoutes,
+  AchievementTypeSchema,
 } from "@checkstack/slo-common";
 import { createBackendPlugin, coreServices } from "@checkstack/backend-api";
-import { integrationEventExtensionPoint } from "@checkstack/integration-backend";
+import { automationTriggerExtensionPoint } from "@checkstack/automation-backend";
 import { SloService } from "./service";
 import { SloEngine } from "./slo-engine";
 import { createRouter } from "./router";
@@ -60,7 +61,7 @@ const sloStreakBrokenPayloadSchema = z.object({
 
 const sloAchievementUnlockedPayloadSchema = z.object({
   systemId: z.string(),
-  achievement: z.string(),
+  achievement: AchievementTypeSchema,
 });
 
 const sloWeeklyDigestPayloadSchema = z.object({
@@ -93,77 +94,88 @@ export default createBackendPlugin({
   register(env) {
     env.registerAccessRules(sloAccessRules);
 
-    // Register hooks as integration events
-    const integrationEvents = env.getExtensionPoint(
-      integrationEventExtensionPoint,
+    // Register hooks as automation triggers
+    const automationTriggers = env.getExtensionPoint(
+      automationTriggerExtensionPoint,
     );
 
-    integrationEvents.registerEvent(
+    automationTriggers.registerTrigger(
       {
-        hook: sloHooks.sloBudgetWarning,
+        id: "budget.warning",
         displayName: "SLO Budget Warning",
         description:
           "Fired when an SLO error budget consumption exceeds the warning threshold",
         category: "SLO",
         payloadSchema: sloBudgetWarningPayloadSchema,
+        hook: sloHooks.sloBudgetWarning,
+        contextKey: (p) => p.systemId,
       },
       pluginMetadata,
     );
 
-    integrationEvents.registerEvent(
+    automationTriggers.registerTrigger(
       {
-        hook: sloHooks.sloBudgetCritical,
+        id: "budget.critical",
         displayName: "SLO Budget Critical",
         description:
           "Fired when an SLO error budget consumption exceeds the critical threshold",
         category: "SLO",
         payloadSchema: sloBudgetCriticalPayloadSchema,
+        hook: sloHooks.sloBudgetCritical,
+        contextKey: (p) => p.systemId,
       },
       pluginMetadata,
     );
 
-    integrationEvents.registerEvent(
+    automationTriggers.registerTrigger(
       {
-        hook: sloHooks.sloBudgetExhausted,
+        id: "budget.exhausted",
         displayName: "SLO Budget Exhausted",
         description: "Fired when an SLO error budget is fully consumed",
         category: "SLO",
         payloadSchema: sloBudgetExhaustedPayloadSchema,
+        hook: sloHooks.sloBudgetExhausted,
+        contextKey: (p) => p.systemId,
       },
       pluginMetadata,
     );
 
-    integrationEvents.registerEvent(
+    automationTriggers.registerTrigger(
       {
-        hook: sloHooks.sloStreakBroken,
+        id: "streak.broken",
         displayName: "SLO Streak Broken",
         description: "Fired when a reliability streak is broken",
         category: "SLO",
         payloadSchema: sloStreakBrokenPayloadSchema,
+        hook: sloHooks.sloStreakBroken,
+        contextKey: (p) => p.systemId,
       },
       pluginMetadata,
     );
 
-    integrationEvents.registerEvent(
+    automationTriggers.registerTrigger(
       {
-        hook: sloHooks.sloAchievementUnlocked,
+        id: "achievement.unlocked",
         displayName: "SLO Achievement Unlocked",
         description:
           "Fired when a system unlocks a new reliability achievement",
         category: "SLO",
         payloadSchema: sloAchievementUnlockedPayloadSchema,
+        hook: sloHooks.sloAchievementUnlocked,
+        contextKey: (p) => p.systemId,
       },
       pluginMetadata,
     );
 
-    integrationEvents.registerEvent(
+    automationTriggers.registerTrigger(
       {
-        hook: sloHooks.sloWeeklyDigest,
+        id: "weekly.digest",
         displayName: "SLO Weekly Digest",
         description:
           "Weekly summary of SLO performance across all systems (Monday 09:00 UTC)",
         category: "SLO",
         payloadSchema: sloWeeklyDigestPayloadSchema,
+        hook: sloHooks.sloWeeklyDigest,
       },
       pluginMetadata,
     );

package/tsconfig.json

@@ -4,6 +4,9 @@
     "src"
   ],
   "references": [
+    {
+      "path": "../automation-backend"
+    },
     {
       "path": "../backend-api"
     },
@@ -43,12 +46,6 @@
     {
       "path": "../healthcheck-common"
     },
-    {
-      "path": "../integration-backend"
-    },
-    {
-      "path": "../integration-common"
-    },
     {
       "path": "../queue-api"
     },