@runcore-sh/runcore 0.3.1 → 0.4.0

package/dist/middleware/error-handler.d.ts

@@ -0,0 +1,13 @@
+import type { ErrorHandler, NotFoundHandler } from "hono";
+export declare class ApiError extends Error {
+    readonly status: number;
+    readonly code: string;
+    constructor(status: number, message: string, code?: string);
+}
+export declare const errorHandler: ErrorHandler;
+export declare const notFoundHandler: NotFoundHandler;
+export declare function badRequest(message: string): never;
+export declare function unauthorized(message?: string): never;
+export declare function forbidden(message?: string): never;
+export declare function notFound(message?: string): never;
+//# sourceMappingURL=error-handler.d.ts.map

package/dist/middleware/error-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../src/middleware/error-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,MAAM,CAAC;AAO1D,qBAAa,QAAS,SAAQ,KAAK;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM;CAM3D;AAyBD,eAAO,MAAM,YAAY,EAAE,YA0B1B,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,eAO7B,CAAC;AAIF,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,CAEjD;AAED,wBAAgB,YAAY,CAAC,OAAO,SAA4B,GAAG,KAAK,CAEvE;AAED,wBAAgB,SAAS,CAAC,OAAO,SAAc,GAAG,KAAK,CAEtD;AAED,wBAAgB,QAAQ,CAAC,OAAO,SAAc,GAAG,KAAK,CAErD"}

package/dist/middleware/error-handler.js

@@ -0,0 +1,71 @@
+import { createLogger } from "../utils/logger.js";
+const log = createLogger("error-handler");
+// ── ApiError ─────────────────────────────────────────────────────────────────
+export class ApiError extends Error {
+    status;
+    code;
+    constructor(status, message, code) {
+        super(message);
+        this.name = "ApiError";
+        this.status = status;
+        this.code = code ?? statusToCode(status);
+    }
+}
+function statusToCode(status) {
+    switch (status) {
+        case 400: return "BAD_REQUEST";
+        case 401: return "AUTH_REQUIRED";
+        case 403: return "FORBIDDEN";
+        case 404: return "NOT_FOUND";
+        case 409: return "CONFLICT";
+        case 422: return "UNPROCESSABLE";
+        case 429: return "RATE_LIMITED";
+        default: return "INTERNAL_ERROR";
+    }
+}
+// ── Handlers ─────────────────────────────────────────────────────────────────
+export const errorHandler = (err, c) => {
+    if (err instanceof ApiError) {
+        log.warn(err.message, { status: err.status, code: err.code });
+        const body = {
+            error: err.message,
+            code: err.code,
+            status: err.status,
+        };
+        return c.json(body, err.status);
+    }
+    // Generic / unexpected error
+    const isProduction = process.env.NODE_ENV === "production";
+    const message = isProduction ? "Internal server error" : err.message;
+    log.error(err.message, {
+        stack: isProduction ? undefined : err.stack,
+    });
+    const body = {
+        error: message,
+        code: "INTERNAL_ERROR",
+        status: 500,
+    };
+    return c.json(body, 500);
+};
+export const notFoundHandler = (c) => {
+    const body = {
+        error: "Not found",
+        code: "NOT_FOUND",
+        status: 404,
+    };
+    return c.json(body, 404);
+};
+// ── Helper throwers ──────────────────────────────────────────────────────────
+export function badRequest(message) {
+    throw new ApiError(400, message, "BAD_REQUEST");
+}
+export function unauthorized(message = "Authentication required") {
+    throw new ApiError(401, message, "AUTH_REQUIRED");
+}
+export function forbidden(message = "Forbidden") {
+    throw new ApiError(403, message, "FORBIDDEN");
+}
+export function notFound(message = "Not found") {
+    throw new ApiError(404, message, "NOT_FOUND");
+}
+//# sourceMappingURL=error-handler.js.map

package/dist/middleware/error-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.js","sourceRoot":"","sources":["../../src/middleware/error-handler.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,MAAM,GAAG,GAAG,YAAY,CAAC,eAAe,CAAC,CAAC;AAE1C,gFAAgF;AAEhF,MAAM,OAAO,QAAS,SAAQ,KAAK;IACxB,MAAM,CAAS;IACf,IAAI,CAAS;IAEtB,YAAY,MAAc,EAAE,OAAe,EAAE,IAAa;QACxD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC;IAC3C,CAAC;CACF;AAED,SAAS,YAAY,CAAC,MAAc;IAClC,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,GAAG,CAAC,CAAC,OAAO,aAAa,CAAC;QAC/B,KAAK,GAAG,CAAC,CAAC,OAAO,eAAe,CAAC;QACjC,KAAK,GAAG,CAAC,CAAC,OAAO,WAAW,CAAC;QAC7B,KAAK,GAAG,CAAC,CAAC,OAAO,WAAW,CAAC;QAC7B,KAAK,GAAG,CAAC,CAAC,OAAO,UAAU,CAAC;QAC5B,KAAK,GAAG,CAAC,CAAC,OAAO,eAAe,CAAC;QACjC,KAAK,GAAG,CAAC,CAAC,OAAO,cAAc,CAAC;QAChC,OAAO,CAAC,CAAE,OAAO,gBAAgB,CAAC;IACpC,CAAC;AACH,CAAC;AAUD,gFAAgF;AAEhF,MAAM,CAAC,MAAM,YAAY,GAAiB,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;IACnD,IAAI,GAAG,YAAY,QAAQ,EAAE,CAAC;QAC5B,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;QAE9D,MAAM,IAAI,GAAsB;YAC9B,KAAK,EAAE,GAAG,CAAC,OAAO;YAClB,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,MAAM,EAAE,GAAG,CAAC,MAAM;SACnB,CAAC;QACF,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,MAAa,CAAC,CAAC;IACzC,CAAC;IAED,6BAA6B;IAC7B,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,CAAC;IAC3D,MAAM,OAAO,GAAG,YAAY,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC;IAErE,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE;QACrB,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK;KAC5C,CAAC,CAAC;IAEH,MAAM,IAAI,GAAsB;QAC9B,KAAK,EAAE,OAAO;QACd,IAAI,EAAE,gBAAgB;QACtB,MAAM,EAAE,GAAG;KACZ,CAAC;IACF,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;AAC3B,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAoB,CAAC,CAAC,EAAE,EAAE;IACpD,MAAM,IAAI,GAAsB;QAC9B,KAAK,EAAE,WAAW;QAClB,IAAI,EAAE,WAAW;QACjB,MAAM,EAAE,GAAG;KACZ,CAAC;IACF,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;AAC3B,CAAC,CAAC;AAEF,gFAAgF;AAEhF,MAAM,UAAU,UAAU,CAAC,OAAe;IACxC,MAAM,IAAI,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAO,GAAG,yBAAyB;IAC9D,MAAM,IAAI,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE,eAAe,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,OAAO,GAAG,WAAW;IAC7C,MAAM,IAAI,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,OAAO,GAAG,WAAW;IAC5C,MAAM,IAAI,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC;AAChD,CAAC"}

package/dist/notifications/channels/adapter.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Adapter that wraps legacy NotificationChannel (alert-based)
+ * into the SmartChannel interface (context-based).
+ *
+ * This allows existing email, SMS, and webhook channels to work
+ * with the smart notification engine without rewriting them.
+ */
+import type { NotificationChannel } from "../../health/alert-types.js";
+import type { NotificationContext, NotificationPriority, SmartChannel } from "../types.js";
+/**
+ * Wraps a legacy NotificationChannel as a SmartChannel.
+ *
+ * Usage:
+ * ```ts
+ * const legacyEmail = new EmailChannel(config);
+ * const smartEmail = new LegacyChannelAdapter(legacyEmail, "normal");
+ * engine.registerChannel(smartEmail);
+ * ```
+ */
+export declare class LegacyChannelAdapter implements SmartChannel {
+    private inner;
+    readonly name: string;
+    get enabled(): boolean;
+    readonly minPriority: NotificationPriority;
+    constructor(inner: NotificationChannel, minPriority?: NotificationPriority);
+    send(ctx: NotificationContext, priority: NotificationPriority): Promise<boolean>;
+}
+//# sourceMappingURL=adapter.d.ts.map

package/dist/notifications/channels/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/notifications/channels/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAS,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAC9E,OAAO,KAAK,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAwB3F;;;;;;;;;GASG;AACH,qBAAa,oBAAqB,YAAW,YAAY;IAQrD,OAAO,CAAC,KAAK;IAPf,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,IAAI,OAAO,IAAI,OAAO,CAErB;IACD,QAAQ,CAAC,WAAW,EAAE,oBAAoB,CAAC;gBAGjC,KAAK,EAAE,mBAAmB,EAClC,WAAW,GAAE,oBAA+B;IAMxC,IAAI,CAAC,GAAG,EAAE,mBAAmB,EAAE,QAAQ,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC;CAIvF"}

package/dist/notifications/channels/adapter.js

@@ -0,0 +1,55 @@
+/**
+ * Adapter that wraps legacy NotificationChannel (alert-based)
+ * into the SmartChannel interface (context-based).
+ *
+ * This allows existing email, SMS, and webhook channels to work
+ * with the smart notification engine without rewriting them.
+ */
+/** Map smart priority to alert severity for the legacy interface. */
+function priorityToSeverity(priority) {
+    return priority === "critical" || priority === "high" ? "critical" : "warning";
+}
+/** Build a minimal Alert from a NotificationContext for legacy channels. */
+function contextToAlert(ctx, priority) {
+    const severity = priorityToSeverity(priority);
+    return {
+        id: `smart-${ctx.source}-${Date.now()}`,
+        thresholdId: ctx.eventType,
+        checkName: ctx.source,
+        metric: ctx.eventType,
+        severity,
+        state: "firing",
+        value: 0,
+        threshold: 0,
+        message: ctx.payload["message"] ?? `[${ctx.source}] ${ctx.eventType}`,
+        firedAt: ctx.timestamp,
+    };
+}
+/**
+ * Wraps a legacy NotificationChannel as a SmartChannel.
+ *
+ * Usage:
+ * ```ts
+ * const legacyEmail = new EmailChannel(config);
+ * const smartEmail = new LegacyChannelAdapter(legacyEmail, "normal");
+ * engine.registerChannel(smartEmail);
+ * ```
+ */
+export class LegacyChannelAdapter {
+    inner;
+    name;
+    get enabled() {
+        return this.inner.enabled;
+    }
+    minPriority;
+    constructor(inner, minPriority = "normal") {
+        this.inner = inner;
+        this.name = inner.name;
+        this.minPriority = minPriority;
+    }
+    async send(ctx, priority) {
+        const alert = contextToAlert(ctx, priority);
+        return this.inner.send(alert);
+    }
+}
+//# sourceMappingURL=adapter.js.map

package/dist/notifications/channels/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../../src/notifications/channels/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,qEAAqE;AACrE,SAAS,kBAAkB,CAAC,QAA8B;IACxD,OAAO,QAAQ,KAAK,UAAU,IAAI,QAAQ,KAAK,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;AACjF,CAAC;AAED,4EAA4E;AAC5E,SAAS,cAAc,CAAC,GAAwB,EAAE,QAA8B;IAC9E,MAAM,QAAQ,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IAC9C,OAAO;QACL,EAAE,EAAE,SAAS,GAAG,CAAC,MAAM,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE;QACvC,WAAW,EAAE,GAAG,CAAC,SAAS;QAC1B,SAAS,EAAE,GAAG,CAAC,MAAM;QACrB,MAAM,EAAE,GAAG,CAAC,SAAS;QACrB,QAAQ;QACR,KAAK,EAAE,QAAQ;QACf,KAAK,EAAE,CAAC;QACR,SAAS,EAAE,CAAC;QACZ,OAAO,EAAG,GAAG,CAAC,OAAO,CAAC,SAAS,CAAY,IAAI,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,CAAC,SAAS,EAAE;QACjF,OAAO,EAAE,GAAG,CAAC,SAAS;KACvB,CAAC;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,OAAO,oBAAoB;IAQrB;IAPD,IAAI,CAAS;IACtB,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;IAC5B,CAAC;IACQ,WAAW,CAAuB;IAE3C,YACU,KAA0B,EAClC,cAAoC,QAAQ;QADpC,UAAK,GAAL,KAAK,CAAqB;QAGlC,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;QACvB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,GAAwB,EAAE,QAA8B;QACjE,MAAM,KAAK,GAAG,cAAc,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QAC5C,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;CACF"}

package/dist/notifications/channels/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Smart notification channel exports.
+ */
+export { LegacyChannelAdapter } from "./adapter.js";
+export { LogChannel } from "./log.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/notifications/channels/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/notifications/channels/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC"}

package/dist/notifications/channels/index.js

@@ -0,0 +1,6 @@
+/**
+ * Smart notification channel exports.
+ */
+export { LegacyChannelAdapter } from "./adapter.js";
+export { LogChannel } from "./log.js";
+//# sourceMappingURL=index.js.map

package/dist/notifications/channels/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/notifications/channels/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC"}

package/dist/notifications/channels/log.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Log channel — writes notifications to the structured logger.
+ *
+ * Useful as a default/fallback channel, for development, and for
+ * maintaining an audit trail of all dispatched notifications.
+ */
+import type { NotificationContext, NotificationPriority, SmartChannel } from "../types.js";
+export declare class LogChannel implements SmartChannel {
+    readonly name = "log";
+    enabled: boolean;
+    readonly minPriority: NotificationPriority;
+    constructor(minPriority?: NotificationPriority);
+    send(ctx: NotificationContext, priority: NotificationPriority): Promise<boolean>;
+}
+//# sourceMappingURL=log.d.ts.map

package/dist/notifications/channels/log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../../../src/notifications/channels/log.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAI3F,qBAAa,UAAW,YAAW,YAAY;IAC7C,QAAQ,CAAC,IAAI,SAAS;IACtB,OAAO,UAAQ;IACf,QAAQ,CAAC,WAAW,EAAE,oBAAoB,CAAC;gBAE/B,WAAW,GAAE,oBAA4B;IAI/C,IAAI,CAAC,GAAG,EAAE,mBAAmB,EAAE,QAAQ,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC;CAYvF"}

package/dist/notifications/channels/log.js

@@ -0,0 +1,29 @@
+/**
+ * Log channel — writes notifications to the structured logger.
+ *
+ * Useful as a default/fallback channel, for development, and for
+ * maintaining an audit trail of all dispatched notifications.
+ */
+import { createLogger } from "../../utils/logger.js";
+const logger = createLogger("notifications.log-channel");
+export class LogChannel {
+    name = "log";
+    enabled = true;
+    minPriority;
+    constructor(minPriority = "low") {
+        this.minPriority = minPriority;
+    }
+    async send(ctx, priority) {
+        logger.info("notification dispatched", {
+            priority,
+            source: ctx.source,
+            eventType: ctx.eventType,
+            gear: ctx.gear,
+            tags: ctx.tags,
+            actor: ctx.actor,
+            message: ctx.payload["message"],
+        });
+        return true;
+    }
+}
+//# sourceMappingURL=log.js.map

package/dist/notifications/channels/log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.js","sourceRoot":"","sources":["../../../src/notifications/channels/log.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAGrD,MAAM,MAAM,GAAG,YAAY,CAAC,2BAA2B,CAAC,CAAC;AAEzD,MAAM,OAAO,UAAU;IACZ,IAAI,GAAG,KAAK,CAAC;IACtB,OAAO,GAAG,IAAI,CAAC;IACN,WAAW,CAAuB;IAE3C,YAAY,cAAoC,KAAK;QACnD,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,GAAwB,EAAE,QAA8B;QACjE,MAAM,CAAC,IAAI,CAAC,yBAAyB,EAAE;YACrC,QAAQ;YACR,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,OAAO,EAAE,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC;SAChC,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/notifications/engine.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Smart notification engine.
+ *
+ * Evaluates notification rules against event context,
+ * resolves priority and channels, and dispatches through
+ * registered smart channels with cooldown tracking.
+ */
+import type { EvaluationResult, NotificationContext, NotificationPriority, NotificationRule, RuleCondition, SmartChannel } from "./types.js";
+/** Evaluate a single condition against a context. */
+export declare function evaluateCondition(ctx: NotificationContext, condition: RuleCondition): boolean;
+/** Check if all conditions of a rule match the context. */
+export declare function matchRule(ctx: NotificationContext, rule: NotificationRule): boolean;
+/** Derive a default priority from context when no rule overrides it. */
+export declare function derivePriority(ctx: NotificationContext): NotificationPriority;
+export declare class NotificationEngine {
+    private rules;
+    private channels;
+    /** Tracks last send time per cooldown key (ruleId:source). */
+    private cooldowns;
+    /** Add or replace a rule. */
+    addRule(rule: NotificationRule): void;
+    /** Remove a rule by id. */
+    removeRule(id: string): void;
+    /** Get all registered rules. */
+    getRules(): readonly NotificationRule[];
+    /** Register a smart channel. */
+    registerChannel(channel: SmartChannel): void;
+    /** Unregister a channel by name. */
+    unregisterChannel(name: string): void;
+    /** Evaluate all rules against a context and return the result. */
+    evaluate(ctx: NotificationContext): EvaluationResult;
+    /** Evaluate and dispatch a notification. Returns per-channel success map. */
+    dispatch(ctx: NotificationContext): Promise<Record<string, boolean>>;
+    /** Clear all cooldown state (useful for testing). */
+    clearCooldowns(): void;
+}
+//# sourceMappingURL=engine.d.ts.map

package/dist/notifications/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/notifications/engine.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EACV,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,EAChB,aAAa,EACb,YAAY,EACb,MAAM,YAAY,CAAC;AAkBpB,qDAAqD;AACrD,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,mBAAmB,EACxB,SAAS,EAAE,aAAa,GACvB,OAAO,CAuBT;AAED,2DAA2D;AAC3D,wBAAgB,SAAS,CACvB,GAAG,EAAE,mBAAmB,EACxB,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAGT;AAID,wEAAwE;AACxE,wBAAgB,cAAc,CAAC,GAAG,EAAE,mBAAmB,GAAG,oBAAoB,CAM7E;AAID,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,KAAK,CAA0B;IACvC,OAAO,CAAC,QAAQ,CAAmC;IACnD,8DAA8D;IAC9D,OAAO,CAAC,SAAS,CAA6B;IAE9C,6BAA6B;IAC7B,OAAO,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI;IAWrC,2BAA2B;IAC3B,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAI5B,gCAAgC;IAChC,QAAQ,IAAI,SAAS,gBAAgB,EAAE;IAIvC,gCAAgC;IAChC,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;IAI5C,oCAAoC;IACpC,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIrC,kEAAkE;IAClE,QAAQ,CAAC,GAAG,EAAE,mBAAmB,GAAG,gBAAgB;IAgDpD,6EAA6E;IACvE,QAAQ,CAAC,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAyD1E,qDAAqD;IACrD,cAAc,IAAI,IAAI;CAGvB"}

package/dist/notifications/engine.js

@@ -0,0 +1,198 @@
+/**
+ * Smart notification engine.
+ *
+ * Evaluates notification rules against event context,
+ * resolves priority and channels, and dispatches through
+ * registered smart channels with cooldown tracking.
+ */
+import { createLogger } from "../utils/logger.js";
+import { PRIORITY_ORDER } from "./types.js";
+const log = createLogger("notifications.engine");
+// ─── Condition evaluation ───────────────────────────────────────────────────
+/** Resolve a dot-separated field path from a NotificationContext. */
+function resolveField(ctx, field) {
+    const parts = field.split(".");
+    let current = ctx;
+    for (const part of parts) {
+        if (current == null || typeof current !== "object")
+            return undefined;
+        current = current[part];
+    }
+    return current;
+}
+/** Evaluate a single condition against a context. */
+export function evaluateCondition(ctx, condition) {
+    const actual = resolveField(ctx, condition.field);
+    switch (condition.operator) {
+        case "eq":
+            return actual === condition.value;
+        case "neq":
+            return actual !== condition.value;
+        case "in":
+            return Array.isArray(condition.value) && condition.value.includes(actual);
+        case "not_in":
+            return Array.isArray(condition.value) && !condition.value.includes(actual);
+        case "contains":
+            return Array.isArray(actual) && actual.includes(condition.value);
+        case "gt":
+            return typeof actual === "number" && typeof condition.value === "number" && actual > condition.value;
+        case "lt":
+            return typeof actual === "number" && typeof condition.value === "number" && actual < condition.value;
+        case "exists":
+            return condition.value ? actual !== undefined : actual === undefined;
+        default:
+            return false;
+    }
+}
+/** Check if all conditions of a rule match the context. */
+export function matchRule(ctx, rule) {
+    if (!rule.enabled)
+        return false;
+    return rule.conditions.every((c) => evaluateCondition(ctx, c));
+}
+// ─── Priority derivation ────────────────────────────────────────────────────
+/** Derive a default priority from context when no rule overrides it. */
+export function derivePriority(ctx) {
+    if (ctx.gear === "crisis")
+        return "critical";
+    if (ctx.tags.includes("critical"))
+        return "critical";
+    if (ctx.tags.includes("high"))
+        return "high";
+    if (ctx.tags.includes("low"))
+        return "low";
+    return "normal";
+}
+// ─── Engine ─────────────────────────────────────────────────────────────────
+export class NotificationEngine {
+    rules = [];
+    channels = new Map();
+    /** Tracks last send time per cooldown key (ruleId:source). */
+    cooldowns = new Map();
+    /** Add or replace a rule. */
+    addRule(rule) {
+        const idx = this.rules.findIndex((r) => r.id === rule.id);
+        if (idx >= 0) {
+            this.rules[idx] = rule;
+        }
+        else {
+            this.rules.push(rule);
+        }
+        // Keep sorted by weight descending so highest-weight rules evaluate first.
+        this.rules.sort((a, b) => b.weight - a.weight);
+    }
+    /** Remove a rule by id. */
+    removeRule(id) {
+        this.rules = this.rules.filter((r) => r.id !== id);
+    }
+    /** Get all registered rules. */
+    getRules() {
+        return this.rules;
+    }
+    /** Register a smart channel. */
+    registerChannel(channel) {
+        this.channels.set(channel.name, channel);
+    }
+    /** Unregister a channel by name. */
+    unregisterChannel(name) {
+        this.channels.delete(name);
+    }
+    /** Evaluate all rules against a context and return the result. */
+    evaluate(ctx) {
+        const matchedRules = [];
+        const now = Date.now();
+        for (const rule of this.rules) {
+            if (!matchRule(ctx, rule))
+                continue;
+            // Cooldown check
+            if (rule.action.cooldownSeconds) {
+                const key = `${rule.id}:${ctx.source}`;
+                const lastSent = this.cooldowns.get(key);
+                if (lastSent && now - lastSent < rule.action.cooldownSeconds * 1000) {
+                    log.debug("rule skipped by cooldown", { ruleId: rule.id, source: ctx.source });
+                    continue;
+                }
+            }
+            matchedRules.push(rule);
+            if (rule.terminal)
+                break;
+        }
+        // Resolve priority: highest from matched rules, falling back to context-derived
+        let priority = derivePriority(ctx);
+        for (const rule of matchedRules) {
+            if (rule.action.priority && PRIORITY_ORDER[rule.action.priority] > PRIORITY_ORDER[priority]) {
+                priority = rule.action.priority;
+            }
+        }
+        // Collect channels from matched rules (deduplicated)
+        const channelSet = new Set();
+        for (const rule of matchedRules) {
+            for (const ch of rule.action.channels) {
+                channelSet.add(ch);
+            }
+        }
+        const channels = [...channelSet];
+        return {
+            context: ctx,
+            matchedRules,
+            priority,
+            channels,
+            shouldDeliver: matchedRules.length > 0,
+        };
+    }
+    /** Evaluate and dispatch a notification. Returns per-channel success map. */
+    async dispatch(ctx) {
+        const result = this.evaluate(ctx);
+        const outcomes = {};
+        if (!result.shouldDeliver) {
+            log.debug("no rules matched, skipping dispatch", { source: ctx.source, eventType: ctx.eventType });
+            return outcomes;
+        }
+        log.info("dispatching notification", {
+            matchedRules: result.matchedRules.length,
+            priority: result.priority,
+            channels: result.channels,
+            eventType: ctx.eventType,
+        });
+        const now = Date.now();
+        // Update cooldowns for matched rules
+        for (const rule of result.matchedRules) {
+            if (rule.action.cooldownSeconds) {
+                this.cooldowns.set(`${rule.id}:${ctx.source}`, now);
+            }
+        }
+        // Dispatch to each resolved channel
+        const sends = result.channels.map(async (chName) => {
+            const channel = this.channels.get(chName);
+            if (!channel || !channel.enabled) {
+                log.warn("channel unavailable or disabled", { channel: chName });
+                outcomes[chName] = false;
+                return;
+            }
+            // Check channel's minimum priority
+            if (PRIORITY_ORDER[result.priority] < PRIORITY_ORDER[channel.minPriority]) {
+                log.debug("notification below channel min priority", {
+                    channel: chName,
+                    priority: result.priority,
+                    minPriority: channel.minPriority,
+                });
+                outcomes[chName] = false;
+                return;
+            }
+            try {
+                outcomes[chName] = await channel.send(ctx, result.priority);
+            }
+            catch (err) {
+                log.error("channel send failed", { channel: chName, error: String(err) });
+                outcomes[chName] = false;
+            }
+        });
+        await Promise.allSettled(sends);
+        return outcomes;
+    }
+    /** Clear all cooldown state (useful for testing). */
+    clearCooldowns() {
+        this.cooldowns.clear();
+    }
+}
+//# sourceMappingURL=engine.js.map

package/dist/notifications/engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../../src/notifications/engine.ts"],"names":[],"mappings":"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"}

package/dist/notifications/index.d.ts

@@ -1,8 +1,12 @@
 /**
- * Notification channels for the Core alerting system.
+ * Notification system — legacy alert channels + smart rule-based engine.
  *
- * Provides email, SMS, and webhook delivery channels plus a
- * dispatcher that routes alerts to the appropriate channels.
+ * Two layers:
+ * - Legacy: NotificationDispatcher broadcasts Alert objects to channels
+ * - Smart: NotificationEngine evaluates rules against context, routes to SmartChannels
+ *
+ * LegacyChannelAdapter bridges them — existing email/SMS/webhook channels
+ * work with both layers without rewriting.
  */
 export { NotificationDispatcher } from "./channel.js";
 export type { NotificationChannel } from "./channel.js";
@@ -13,4 +17,9 @@ export type { SmsChannelConfig } from "./sms.js";
 export { WebhookChannel } from "./webhook.js";
 export type { WebhookChannelConfig } from "./webhook.js";
 export { PhoneChannel } from "./phone.js";
+export { NotificationEngine, evaluateCondition, matchRule, derivePriority, } from "./engine.js";
+export type { NotificationPriority, NotificationContext, NotificationRule, RuleCondition, RuleAction, RuleMatch, EvaluationResult, SmartChannel, } from "./types.js";
+export { PRIORITY_ORDER } from "./types.js";
+export { LegacyChannelAdapter } from "./channels/adapter.js";
+export { LogChannel } from "./channels/log.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/notifications/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/notifications/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACtD,YAAY,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAExD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,YAAY,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,YAAY,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAEjD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,YAAY,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEzD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/notifications/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACtD,YAAY,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAGxD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,YAAY,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,YAAY,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAEjD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,YAAY,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEzD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG1C,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,SAAS,EACT,cAAc,GACf,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,oBAAoB,EACpB,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,EACb,UAAU,EACV,SAAS,EACT,gBAAgB,EAChB,YAAY,GACb,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAG5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/notifications/index.js

@@ -1,12 +1,24 @@
 /**
- * Notification channels for the Core alerting system.
+ * Notification system — legacy alert channels + smart rule-based engine.
  *
- * Provides email, SMS, and webhook delivery channels plus a
- * dispatcher that routes alerts to the appropriate channels.
+ * Two layers:
+ * - Legacy: NotificationDispatcher broadcasts Alert objects to channels
+ * - Smart: NotificationEngine evaluates rules against context, routes to SmartChannels
+ *
+ * LegacyChannelAdapter bridges them — existing email/SMS/webhook channels
+ * work with both layers without rewriting.
  */
+// ─── Legacy alert-based dispatch ─────────────────────────────────────────────
 export { NotificationDispatcher } from "./channel.js";
+// ─── Concrete channels (legacy interface) ────────────────────────────────────
 export { EmailChannel } from "./email.js";
 export { SmsChannel } from "./sms.js";
 export { WebhookChannel } from "./webhook.js";
 export { PhoneChannel } from "./phone.js";
+// ─── Smart rule-based engine ─────────────────────────────────────────────────
+export { NotificationEngine, evaluateCondition, matchRule, derivePriority, } from "./engine.js";
+export { PRIORITY_ORDER } from "./types.js";
+// ─── Smart channel adapters ──────────────────────────────────────────────────
+export { LegacyChannelAdapter } from "./channels/adapter.js";
+export { LogChannel } from "./channels/log.js";
 //# sourceMappingURL=index.js.map

package/dist/notifications/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/notifications/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAGtD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG1C,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAGtC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAG9C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/notifications/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,gFAAgF;AAChF,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAGtD,gFAAgF;AAChF,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG1C,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAGtC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAG9C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,gFAAgF;AAChF,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,SAAS,EACT,cAAc,GACf,MAAM,aAAa,CAAC;AAarB,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,gFAAgF;AAChF,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC"}