@newrelic/preflight 0.0.1-pre.1 → 1.0.0

package/dist/alerts/local-alert-rule.d.ts

@@ -0,0 +1,439 @@
+import { z } from 'zod';
+declare const costWindowRuleSchema: z.ZodObject<{
+    type: z.ZodLiteral<"cost.window">;
+    windowSeconds: z.ZodNumber;
+    costPeriod: z.ZodDefault<z.ZodEnum<{
+        week: "week";
+        session: "session";
+        today: "today";
+    }>>;
+    id: z.ZodString;
+    name: z.ZodString;
+    severity: z.ZodEnum<{
+        info: "info";
+        warning: "warning";
+        critical: "critical";
+    }>;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    threshold: z.ZodNumber;
+    operator: z.ZodDefault<z.ZodEnum<{
+        above: "above";
+        below: "below";
+        above_or_equals: "above_or_equals";
+        below_or_equals: "below_or_equals";
+    }>>;
+    deduplicateSeconds: z.ZodDefault<z.ZodNumber>;
+    description: z.ZodOptional<z.ZodString>;
+    channels: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+        banner: "banner";
+        os: "os";
+    }>>>;
+}, z.core.$strip>;
+declare const efficiencyBelowRuleSchema: z.ZodObject<{
+    operator: z.ZodDefault<z.ZodDefault<z.ZodEnum<{
+        above: "above";
+        below: "below";
+        above_or_equals: "above_or_equals";
+        below_or_equals: "below_or_equals";
+    }>>>;
+    type: z.ZodLiteral<"efficiency.below">;
+    windowSeconds: z.ZodNumber;
+    id: z.ZodString;
+    name: z.ZodString;
+    severity: z.ZodEnum<{
+        info: "info";
+        warning: "warning";
+        critical: "critical";
+    }>;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    threshold: z.ZodNumber;
+    deduplicateSeconds: z.ZodDefault<z.ZodNumber>;
+    description: z.ZodOptional<z.ZodString>;
+    channels: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+        banner: "banner";
+        os: "os";
+    }>>>;
+}, z.core.$strip>;
+declare const antiPatternCountRuleSchema: z.ZodObject<{
+    type: z.ZodLiteral<"antipattern.count">;
+    windowSeconds: z.ZodNumber;
+    patternType: z.ZodOptional<z.ZodEnum<{
+        thrashing: "thrashing";
+        re_reading: "re_reading";
+        stuck_loop: "stuck_loop";
+        blind_editing: "blind_editing";
+        over_delegation: "over_delegation";
+    }>>;
+    id: z.ZodString;
+    name: z.ZodString;
+    severity: z.ZodEnum<{
+        info: "info";
+        warning: "warning";
+        critical: "critical";
+    }>;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    threshold: z.ZodNumber;
+    operator: z.ZodDefault<z.ZodEnum<{
+        above: "above";
+        below: "below";
+        above_or_equals: "above_or_equals";
+        below_or_equals: "below_or_equals";
+    }>>;
+    deduplicateSeconds: z.ZodDefault<z.ZodNumber>;
+    description: z.ZodOptional<z.ZodString>;
+    channels: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+        banner: "banner";
+        os: "os";
+    }>>>;
+}, z.core.$strip>;
+declare const latencyPercentileRuleSchema: z.ZodObject<{
+    type: z.ZodLiteral<"latency.percentile">;
+    percentile: z.ZodUnion<readonly [z.ZodLiteral<50>, z.ZodLiteral<95>, z.ZodLiteral<99>]>;
+    tool: z.ZodOptional<z.ZodString>;
+    id: z.ZodString;
+    name: z.ZodString;
+    severity: z.ZodEnum<{
+        info: "info";
+        warning: "warning";
+        critical: "critical";
+    }>;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    threshold: z.ZodNumber;
+    operator: z.ZodDefault<z.ZodEnum<{
+        above: "above";
+        below: "below";
+        above_or_equals: "above_or_equals";
+        below_or_equals: "below_or_equals";
+    }>>;
+    deduplicateSeconds: z.ZodDefault<z.ZodNumber>;
+    description: z.ZodOptional<z.ZodString>;
+    channels: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+        banner: "banner";
+        os: "os";
+    }>>>;
+}, z.core.$strip>;
+declare const budgetSessionRuleSchema: z.ZodObject<{
+    type: z.ZodLiteral<"budget.session">;
+    id: z.ZodString;
+    name: z.ZodString;
+    severity: z.ZodEnum<{
+        info: "info";
+        warning: "warning";
+        critical: "critical";
+    }>;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    threshold: z.ZodNumber;
+    operator: z.ZodDefault<z.ZodEnum<{
+        above: "above";
+        below: "below";
+        above_or_equals: "above_or_equals";
+        below_or_equals: "below_or_equals";
+    }>>;
+    deduplicateSeconds: z.ZodDefault<z.ZodNumber>;
+    description: z.ZodOptional<z.ZodString>;
+    channels: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+        banner: "banner";
+        os: "os";
+    }>>>;
+}, z.core.$strip>;
+declare const budgetDailyRuleSchema: z.ZodObject<{
+    type: z.ZodLiteral<"budget.daily">;
+    id: z.ZodString;
+    name: z.ZodString;
+    severity: z.ZodEnum<{
+        info: "info";
+        warning: "warning";
+        critical: "critical";
+    }>;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    threshold: z.ZodNumber;
+    operator: z.ZodDefault<z.ZodEnum<{
+        above: "above";
+        below: "below";
+        above_or_equals: "above_or_equals";
+        below_or_equals: "below_or_equals";
+    }>>;
+    deduplicateSeconds: z.ZodDefault<z.ZodNumber>;
+    description: z.ZodOptional<z.ZodString>;
+    channels: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+        banner: "banner";
+        os: "os";
+    }>>>;
+}, z.core.$strip>;
+declare const budgetWeeklyRuleSchema: z.ZodObject<{
+    type: z.ZodLiteral<"budget.weekly">;
+    id: z.ZodString;
+    name: z.ZodString;
+    severity: z.ZodEnum<{
+        info: "info";
+        warning: "warning";
+        critical: "critical";
+    }>;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    threshold: z.ZodNumber;
+    operator: z.ZodDefault<z.ZodEnum<{
+        above: "above";
+        below: "below";
+        above_or_equals: "above_or_equals";
+        below_or_equals: "below_or_equals";
+    }>>;
+    deduplicateSeconds: z.ZodDefault<z.ZodNumber>;
+    description: z.ZodOptional<z.ZodString>;
+    channels: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+        banner: "banner";
+        os: "os";
+    }>>>;
+}, z.core.$strip>;
+declare const toolFailureRuleSchema: z.ZodObject<{
+    type: z.ZodLiteral<"tool.failure">;
+    windowSeconds: z.ZodNumber;
+    tool: z.ZodString;
+    id: z.ZodString;
+    name: z.ZodString;
+    severity: z.ZodEnum<{
+        info: "info";
+        warning: "warning";
+        critical: "critical";
+    }>;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    threshold: z.ZodNumber;
+    operator: z.ZodDefault<z.ZodEnum<{
+        above: "above";
+        below: "below";
+        above_or_equals: "above_or_equals";
+        below_or_equals: "below_or_equals";
+    }>>;
+    deduplicateSeconds: z.ZodDefault<z.ZodNumber>;
+    description: z.ZodOptional<z.ZodString>;
+    channels: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+        banner: "banner";
+        os: "os";
+    }>>>;
+}, z.core.$strip>;
+export declare const localAlertRuleSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"cost.window">;
+    windowSeconds: z.ZodNumber;
+    costPeriod: z.ZodDefault<z.ZodEnum<{
+        week: "week";
+        session: "session";
+        today: "today";
+    }>>;
+    id: z.ZodString;
+    name: z.ZodString;
+    severity: z.ZodEnum<{
+        info: "info";
+        warning: "warning";
+        critical: "critical";
+    }>;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    threshold: z.ZodNumber;
+    operator: z.ZodDefault<z.ZodEnum<{
+        above: "above";
+        below: "below";
+        above_or_equals: "above_or_equals";
+        below_or_equals: "below_or_equals";
+    }>>;
+    deduplicateSeconds: z.ZodDefault<z.ZodNumber>;
+    description: z.ZodOptional<z.ZodString>;
+    channels: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+        banner: "banner";
+        os: "os";
+    }>>>;
+}, z.core.$strip>, z.ZodObject<{
+    operator: z.ZodDefault<z.ZodDefault<z.ZodEnum<{
+        above: "above";
+        below: "below";
+        above_or_equals: "above_or_equals";
+        below_or_equals: "below_or_equals";
+    }>>>;
+    type: z.ZodLiteral<"efficiency.below">;
+    windowSeconds: z.ZodNumber;
+    id: z.ZodString;
+    name: z.ZodString;
+    severity: z.ZodEnum<{
+        info: "info";
+        warning: "warning";
+        critical: "critical";
+    }>;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    threshold: z.ZodNumber;
+    deduplicateSeconds: z.ZodDefault<z.ZodNumber>;
+    description: z.ZodOptional<z.ZodString>;
+    channels: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+        banner: "banner";
+        os: "os";
+    }>>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"antipattern.count">;
+    windowSeconds: z.ZodNumber;
+    patternType: z.ZodOptional<z.ZodEnum<{
+        thrashing: "thrashing";
+        re_reading: "re_reading";
+        stuck_loop: "stuck_loop";
+        blind_editing: "blind_editing";
+        over_delegation: "over_delegation";
+    }>>;
+    id: z.ZodString;
+    name: z.ZodString;
+    severity: z.ZodEnum<{
+        info: "info";
+        warning: "warning";
+        critical: "critical";
+    }>;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    threshold: z.ZodNumber;
+    operator: z.ZodDefault<z.ZodEnum<{
+        above: "above";
+        below: "below";
+        above_or_equals: "above_or_equals";
+        below_or_equals: "below_or_equals";
+    }>>;
+    deduplicateSeconds: z.ZodDefault<z.ZodNumber>;
+    description: z.ZodOptional<z.ZodString>;
+    channels: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+        banner: "banner";
+        os: "os";
+    }>>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"latency.percentile">;
+    percentile: z.ZodUnion<readonly [z.ZodLiteral<50>, z.ZodLiteral<95>, z.ZodLiteral<99>]>;
+    tool: z.ZodOptional<z.ZodString>;
+    id: z.ZodString;
+    name: z.ZodString;
+    severity: z.ZodEnum<{
+        info: "info";
+        warning: "warning";
+        critical: "critical";
+    }>;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    threshold: z.ZodNumber;
+    operator: z.ZodDefault<z.ZodEnum<{
+        above: "above";
+        below: "below";
+        above_or_equals: "above_or_equals";
+        below_or_equals: "below_or_equals";
+    }>>;
+    deduplicateSeconds: z.ZodDefault<z.ZodNumber>;
+    description: z.ZodOptional<z.ZodString>;
+    channels: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+        banner: "banner";
+        os: "os";
+    }>>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"budget.session">;
+    id: z.ZodString;
+    name: z.ZodString;
+    severity: z.ZodEnum<{
+        info: "info";
+        warning: "warning";
+        critical: "critical";
+    }>;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    threshold: z.ZodNumber;
+    operator: z.ZodDefault<z.ZodEnum<{
+        above: "above";
+        below: "below";
+        above_or_equals: "above_or_equals";
+        below_or_equals: "below_or_equals";
+    }>>;
+    deduplicateSeconds: z.ZodDefault<z.ZodNumber>;
+    description: z.ZodOptional<z.ZodString>;
+    channels: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+        banner: "banner";
+        os: "os";
+    }>>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"budget.daily">;
+    id: z.ZodString;
+    name: z.ZodString;
+    severity: z.ZodEnum<{
+        info: "info";
+        warning: "warning";
+        critical: "critical";
+    }>;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    threshold: z.ZodNumber;
+    operator: z.ZodDefault<z.ZodEnum<{
+        above: "above";
+        below: "below";
+        above_or_equals: "above_or_equals";
+        below_or_equals: "below_or_equals";
+    }>>;
+    deduplicateSeconds: z.ZodDefault<z.ZodNumber>;
+    description: z.ZodOptional<z.ZodString>;
+    channels: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+        banner: "banner";
+        os: "os";
+    }>>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"budget.weekly">;
+    id: z.ZodString;
+    name: z.ZodString;
+    severity: z.ZodEnum<{
+        info: "info";
+        warning: "warning";
+        critical: "critical";
+    }>;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    threshold: z.ZodNumber;
+    operator: z.ZodDefault<z.ZodEnum<{
+        above: "above";
+        below: "below";
+        above_or_equals: "above_or_equals";
+        below_or_equals: "below_or_equals";
+    }>>;
+    deduplicateSeconds: z.ZodDefault<z.ZodNumber>;
+    description: z.ZodOptional<z.ZodString>;
+    channels: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+        banner: "banner";
+        os: "os";
+    }>>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"tool.failure">;
+    windowSeconds: z.ZodNumber;
+    tool: z.ZodString;
+    id: z.ZodString;
+    name: z.ZodString;
+    severity: z.ZodEnum<{
+        info: "info";
+        warning: "warning";
+        critical: "critical";
+    }>;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    threshold: z.ZodNumber;
+    operator: z.ZodDefault<z.ZodEnum<{
+        above: "above";
+        below: "below";
+        above_or_equals: "above_or_equals";
+        below_or_equals: "below_or_equals";
+    }>>;
+    deduplicateSeconds: z.ZodDefault<z.ZodNumber>;
+    description: z.ZodOptional<z.ZodString>;
+    channels: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+        banner: "banner";
+        os: "os";
+    }>>>;
+}, z.core.$strip>], "type">;
+export type LocalAlertRule = z.infer<typeof localAlertRuleSchema>;
+export type CostWindowRule = z.infer<typeof costWindowRuleSchema>;
+export type EfficiencyBelowRule = z.infer<typeof efficiencyBelowRuleSchema>;
+export type AntiPatternCountRule = z.infer<typeof antiPatternCountRuleSchema>;
+export type LatencyPercentileRule = z.infer<typeof latencyPercentileRuleSchema>;
+export type BudgetSessionRule = z.infer<typeof budgetSessionRuleSchema>;
+export type BudgetDailyRule = z.infer<typeof budgetDailyRuleSchema>;
+export type BudgetWeeklyRule = z.infer<typeof budgetWeeklyRuleSchema>;
+export type ToolFailureRule = z.infer<typeof toolFailureRuleSchema>;
+export type LocalAlertRuleType = LocalAlertRule['type'];
+export type AlertSeverity = LocalAlertRule['severity'];
+export type AlertOperator = LocalAlertRule['operator'];
+export type AlertChannel = 'banner' | 'os';
+export interface ParsedRules {
+    readonly valid: LocalAlertRule[];
+    readonly invalid: Array<{
+        input: unknown;
+        error: string;
+    }>;
+}
+export declare function parseLocalAlertRules(input: unknown): ParsedRules;
+export {};
+//# sourceMappingURL=local-alert-rule.d.ts.map

package/dist/alerts/local-alert-rule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-alert-rule.d.ts","sourceRoot":"","sources":["../../src/alerts/local-alert-rule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA6DxB,QAAA,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAKxB,CAAC;AAEH,QAAA,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;iBAO7B,CAAC;AAEH,QAAA,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAK9B,CAAC;AAEH,QAAA,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;iBAK/B,CAAC;AAEH,QAAA,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;iBAG3B,CAAC;AAEH,QAAA,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;iBAGzB,CAAC;AAEH,QAAA,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;iBAG1B,CAAC;AAEH,QAAA,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;iBAKzB,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BAS/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC5E,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC9E,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAChF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACxE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,MAAM,MAAM,kBAAkB,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;AAExD,MAAM,MAAM,aAAa,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;AACvD,MAAM,MAAM,aAAa,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;AACvD,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,IAAI,CAAC;AAM3C,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,cAAc,EAAE,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC5D;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAwChE"}

package/dist/alerts/local-alert-rule.js

@@ -0,0 +1,139 @@
+import { z } from 'zod';
+import { createLogger } from '../shared/index.js';
+const logger = createLogger('local-alert-rule');
+// ---------------------------------------------------------------------------
+// Shared field schemas
+// ---------------------------------------------------------------------------
+const ID_REGEX = /^[a-z0-9_-]+$/i;
+const idSchema = z
+    .string()
+    .min(1)
+    .max(128)
+    .regex(ID_REGEX, 'id must contain only letters, digits, underscore, hyphen');
+const severitySchema = z.enum(['info', 'warning', 'critical']);
+const operatorSchema = z
+    .enum(['above', 'below', 'above_or_equals', 'below_or_equals'])
+    .default('above');
+const channelsSchema = z.array(z.enum(['banner', 'os'])).default(['banner']);
+const baseShape = {
+    id: idSchema,
+    name: z.string().min(1),
+    severity: severitySchema,
+    enabled: z.boolean().default(true),
+    threshold: z.number().finite(),
+    operator: operatorSchema,
+    deduplicateSeconds: z.number().min(0).default(300),
+    description: z.string().optional(),
+    channels: channelsSchema,
+};
+const windowSecondsSchema = z.number().min(5);
+const antiPatternTypeSchema = z.enum([
+    'thrashing',
+    're_reading',
+    'stuck_loop',
+    'blind_editing',
+    'over_delegation',
+]);
+const percentileSchema = z.union([z.literal(50), z.literal(95), z.literal(99)]);
+// Default to 'session' because the snapshot collector only populates
+// sessionUsd — today/week always read 0 and any rule asking for those
+// periods silently never fires. parseLocalAlertRules logs a warning when
+// today/week is configured so users editing rules.json don't get a silent
+// no-op..
+const costPeriodSchema = z.enum(['session', 'today', 'week']).default('session');
+// ---------------------------------------------------------------------------
+// Rule-type schemas
+// ---------------------------------------------------------------------------
+const costWindowRuleSchema = z.object({
+    ...baseShape,
+    type: z.literal('cost.window'),
+    windowSeconds: windowSecondsSchema,
+    costPeriod: costPeriodSchema,
+});
+const efficiencyBelowRuleSchema = z.object({
+    ...baseShape,
+    // Override operator default: efficiency.below should fire when score is
+    // below the threshold, not above it (which is the baseShape default).
+    operator: operatorSchema.default('below'),
+    type: z.literal('efficiency.below'),
+    windowSeconds: windowSecondsSchema,
+});
+const antiPatternCountRuleSchema = z.object({
+    ...baseShape,
+    type: z.literal('antipattern.count'),
+    windowSeconds: windowSecondsSchema,
+    patternType: antiPatternTypeSchema.optional(),
+});
+const latencyPercentileRuleSchema = z.object({
+    ...baseShape,
+    type: z.literal('latency.percentile'),
+    percentile: percentileSchema,
+    tool: z.string().optional(),
+});
+const budgetSessionRuleSchema = z.object({
+    ...baseShape,
+    type: z.literal('budget.session'),
+});
+const budgetDailyRuleSchema = z.object({
+    ...baseShape,
+    type: z.literal('budget.daily'),
+});
+const budgetWeeklyRuleSchema = z.object({
+    ...baseShape,
+    type: z.literal('budget.weekly'),
+});
+const toolFailureRuleSchema = z.object({
+    ...baseShape,
+    type: z.literal('tool.failure'),
+    windowSeconds: windowSecondsSchema,
+    tool: z.string().min(1),
+});
+export const localAlertRuleSchema = z.discriminatedUnion('type', [
+    costWindowRuleSchema,
+    efficiencyBelowRuleSchema,
+    antiPatternCountRuleSchema,
+    latencyPercentileRuleSchema,
+    budgetSessionRuleSchema,
+    budgetDailyRuleSchema,
+    budgetWeeklyRuleSchema,
+    toolFailureRuleSchema,
+]);
+export function parseLocalAlertRules(input) {
+    const valid = [];
+    const invalid = [];
+    const items = Array.isArray(input) ? input : [input];
+    for (const item of items) {
+        const result = localAlertRuleSchema.safeParse(item);
+        if (result.success) {
+            valid.push(result.data);
+        }
+        else {
+            const error = result.error.issues
+                .map((i) => `${i.path.join('.') || '<root>'}: ${i.message}`)
+                .join('; ');
+            invalid.push({ input: item, error });
+            logger.warn('Skipping invalid alert rule', { error });
+        }
+    }
+    // two rules with the same `id` both pass schema validation, but
+    // LocalAlertEngine keys per-rule state by id (`Map<string, RuleState>`),
+    // so the second rule shadows the first's state — A is firing, B's
+    // condition becomes true, B silently won't fire because it sees
+    // status='firing' in the shared state. Detect duplicates here, keep
+    // the first occurrence, log the rest, and surface them as `invalid`
+    // so the rules-fixture test can pin the behaviour.
+    const seen = new Set();
+    const dedupedValid = [];
+    for (const rule of valid) {
+        if (seen.has(rule.id)) {
+            const error = `duplicate rule id '${rule.id}' — keeping first occurrence`;
+            logger.warn('Skipping duplicate alert rule id', { id: rule.id });
+            invalid.push({ input: rule, error });
+            continue;
+        }
+        seen.add(rule.id);
+        dedupedValid.push(rule);
+    }
+    return { valid: dedupedValid, invalid };
+}
+//# sourceMappingURL=local-alert-rule.js.map

package/dist/alerts/local-alert-rule.js.map

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

package/dist/alerts/os-notifier.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Minimal logger surface — accepts the shared logger or an injected mock.
+ */
+interface NotifierLogger {
+    warn(msg: string, meta?: object): void;
+}
+/**
+ * Subset of `child_process.execFile` we need: pass `(file, args, callback)`.
+ * Using a typed alias keeps the public surface small and lets tests inject a
+ * jest mock without pulling in the full overloaded signature.
+ */
+export type ExecFileFn = (file: string, args: readonly string[], callback: (err: NodeJS.ErrnoException | null, stdout: string, stderr: string) => void) => unknown;
+export interface OsNotifierOptions {
+    readonly platform?: NodeJS.Platform;
+    readonly exec?: ExecFileFn;
+    readonly logger?: NotifierLogger;
+}
+export interface NotifyInput {
+    readonly title: string;
+    readonly body: string;
+}
+/**
+ * Fire OS-level notifications via the native channel for the current
+ * platform. All errors are caught and surfaced through the injected logger;
+ * `notify()` never rejects.
+ */
+export declare class OsNotifier {
+    private readonly platform;
+    private readonly exec;
+    private readonly log;
+    constructor(opts?: OsNotifierOptions);
+    notify(input: NotifyInput): Promise<void>;
+    private notifyDarwin;
+    private notifyLinux;
+    private notifyWin32;
+    private run;
+}
+export {};
+//# sourceMappingURL=os-notifier.d.ts.map

package/dist/alerts/os-notifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"os-notifier.d.ts","sourceRoot":"","sources":["../../src/alerts/os-notifier.ts"],"names":[],"mappings":"AAUA;;GAEG;AACH,UAAU,cAAc;IACtB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACxC;AAED;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,CACvB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,cAAc,GAAG,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,KAClF,OAAO,CAAC;AAEb,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IACpC,QAAQ,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,cAAc,CAAC;CAClC;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AA+BD;;;;GAIG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkB;IAC3C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;IAClC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAiB;gBAEzB,IAAI,GAAE,iBAAsB;IAMlC,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAyC/C,OAAO,CAAC,YAAY;YAQN,WAAW;YAsBX,WAAW;IAuCzB,OAAO,CAAC,GAAG;CAuBZ"}