@scoutflo/alert-correlation 0.1.0

package/dist/src/extractors/prometheusExtractor.js

@@ -0,0 +1,114 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.prometheusExtractor = void 0;
+exports.extractPrometheusCompatibleFacts = extractPrometheusCompatibleFacts;
+const normalizeAlertTime_1 = require("../time/normalizeAlertTime");
+const genericExtractor_1 = require("./genericExtractor");
+function firstAlert(raw) {
+    const alerts = (0, genericExtractor_1.getPath)(raw, ['alerts']);
+    return Array.isArray(alerts) ? alerts[0] : undefined;
+}
+function compactFacts(facts) {
+    return facts.filter((fact) => Boolean(fact));
+}
+function extractPrometheusCompatibleFacts(input, extractorName) {
+    const raw = input.raw;
+    const alert = firstAlert(raw);
+    const labels = [
+        ...(0, genericExtractor_1.factsFromRecord)((0, genericExtractor_1.getPath)(raw, ['commonLabels']), 'raw.commonLabels', 'label', 0.82),
+        ...(0, genericExtractor_1.factsFromRecord)((0, genericExtractor_1.getPath)(raw, ['labels']), 'raw.labels', 'label', 0.8),
+        ...(0, genericExtractor_1.factsFromRecord)((0, genericExtractor_1.getPath)(raw, ['metric']), 'raw.metric', 'label', 0.78),
+        ...(0, genericExtractor_1.factsFromTagCollection)((0, genericExtractor_1.getPath)(raw, ['tags']), 'raw.tags'),
+        ...(0, genericExtractor_1.factsFromRecord)((0, genericExtractor_1.getPath)(raw, ['rule', 'labels']), 'raw.rule.labels', 'label', 0.76),
+        ...(0, genericExtractor_1.factsFromRecord)((0, genericExtractor_1.getPath)(alert, ['labels']), 'raw.alerts[0].labels', 'label', 0.8),
+    ];
+    const textHints = [
+        ...(0, genericExtractor_1.factsFromRecord)((0, genericExtractor_1.getPath)(raw, ['annotations']), 'raw.annotations', 'annotation', 0.65),
+        ...(0, genericExtractor_1.factsFromRecord)((0, genericExtractor_1.getPath)(raw, ['commonAnnotations']), 'raw.commonAnnotations', 'annotation', 0.65),
+        ...(0, genericExtractor_1.factsFromRecord)((0, genericExtractor_1.getPath)(alert, ['annotations']), 'raw.alerts[0].annotations', 'annotation', 0.65),
+    ];
+    const alertNameFact = labels.find((fact) => fact.key === 'alertname');
+    const severityFact = labels.find((fact) => fact.key === 'severity');
+    const rawTimeHints = (0, genericExtractor_1.extractProviderTimeHints)(raw);
+    const alertTimeHints = (0, genericExtractor_1.extractProviderTimeHints)(alert);
+    return {
+        provider: input.alertRef.provider,
+        integrationId: input.alertRef.integrationId,
+        alertKey: input.alertRef.alertKey,
+        extractor: {
+            name: extractorName,
+            version: genericExtractor_1.EXTRACTOR_VERSION,
+        },
+        time: (0, normalizeAlertTime_1.normalizeAlertTime)(input.alertRef, {
+            startsAt: rawTimeHints.startsAt ?? alertTimeHints.startsAt,
+            firstSeen: rawTimeHints.firstSeen ?? alertTimeHints.firstSeen,
+            eventTimestamp: rawTimeHints.eventTimestamp ?? alertTimeHints.eventTimestamp,
+            endsAt: rawTimeHints.endsAt ?? alertTimeHints.endsAt,
+            lastSeen: rawTimeHints.lastSeen ?? alertTimeHints.lastSeen,
+        }),
+        labels,
+        identifiers: compactFacts([
+            (0, genericExtractor_1.makeFact)({
+                key: 'fingerprint',
+                value: (0, genericExtractor_1.firstPrimitive)(raw, [['fingerprint']]) ?? (0, genericExtractor_1.firstPrimitive)(alert, [['fingerprint']]),
+                sourcePath: (0, genericExtractor_1.firstPrimitive)(raw, [['fingerprint']])
+                    ? 'raw.fingerprint'
+                    : 'raw.alerts[0].fingerprint',
+                kind: 'provider_identity',
+                confidence: 0.9,
+            }),
+        ]),
+        resourceHints: compactFacts([
+            (0, genericExtractor_1.makeFact)({
+                key: 'pod',
+                value: labels.find((fact) => fact.key === 'pod')?.value,
+                sourcePath: 'facts.labels.pod',
+                kind: 'resource_hint',
+                confidence: 0.7,
+            }),
+            (0, genericExtractor_1.makeFact)({
+                key: 'instance',
+                value: labels.find((fact) => fact.key === 'instance')?.value,
+                sourcePath: 'facts.labels.instance',
+                kind: 'resource_hint',
+                confidence: 0.65,
+            }),
+        ]),
+        textHints,
+        ...(severityFact
+            ? {
+                severity: {
+                    ...severityFact,
+                    kind: 'label',
+                },
+            }
+            : {}),
+        ...(alertNameFact
+            ? {
+                title: {
+                    ...alertNameFact,
+                    key: 'title',
+                    sourcePath: alertNameFact.sourcePath,
+                    kind: 'text_derived',
+                },
+            }
+            : (0, genericExtractor_1.isRecord)(raw)
+                ? {
+                    title: (0, genericExtractor_1.makeFact)({
+                        key: 'title',
+                        value: (0, genericExtractor_1.primitiveToString)(raw.title) ?? input.summary?.title,
+                        sourcePath: (0, genericExtractor_1.primitiveToString)(raw.title) ? 'raw.title' : 'summary.title',
+                        kind: 'text_derived',
+                        confidence: 0.75,
+                    }),
+                }
+                : {}),
+    };
+}
+exports.prometheusExtractor = {
+    provider: 'prometheus',
+    name: 'prometheus-extractor',
+    version: genericExtractor_1.EXTRACTOR_VERSION,
+    extract: (input) => extractPrometheusCompatibleFacts(input, 'prometheus-extractor'),
+};
+//# sourceMappingURL=prometheusExtractor.js.map

package/dist/src/extractors/prometheusExtractor.js.map

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

package/dist/src/extractors/registry.d.ts

@@ -0,0 +1,4 @@
+import type { ProviderExtractor, ProviderExtractorInput } from './types';
+export declare function registerProviderExtractor(extractor: ProviderExtractor): void;
+export declare function getProviderExtractor(provider: string): ProviderExtractor;
+export declare function extractAlertFacts(input: ProviderExtractorInput): import("..").AlertCorrelationFacts;

package/dist/src/extractors/registry.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerProviderExtractor = registerProviderExtractor;
+exports.getProviderExtractor = getProviderExtractor;
+exports.extractAlertFacts = extractAlertFacts;
+const genericExtractor_1 = require("./genericExtractor");
+const prometheusExtractor_1 = require("./prometheusExtractor");
+const sentryExtractor_1 = require("./sentryExtractor");
+const victoriaMetricsExtractor_1 = require("./victoriaMetricsExtractor");
+const extractors = new Map();
+function registerProviderExtractor(extractor) {
+    extractors.set(extractor.provider.toLowerCase(), extractor);
+}
+function getProviderExtractor(provider) {
+    return extractors.get(provider.toLowerCase()) ?? genericExtractor_1.genericExtractor;
+}
+function extractAlertFacts(input) {
+    return getProviderExtractor(input.alertRef.provider).extract(input);
+}
+registerProviderExtractor(prometheusExtractor_1.prometheusExtractor);
+registerProviderExtractor(sentryExtractor_1.sentryExtractor);
+registerProviderExtractor(victoriaMetricsExtractor_1.victoriaMetricsExtractor);
+//# sourceMappingURL=registry.js.map

package/dist/src/extractors/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/extractors/registry.ts"],"names":[],"mappings":";;AAQA,8DAEC;AAED,oDAEC;AAED,8CAEC;AAlBD,yDAAsD;AACtD,+DAA4D;AAC5D,uDAAoD;AAEpD,yEAAsE;AAEtE,MAAM,UAAU,GAAG,IAAI,GAAG,EAA6B,CAAC;AAExD,SAAgB,yBAAyB,CAAC,SAA4B;IACpE,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,EAAE,SAAS,CAAC,CAAC;AAC9D,CAAC;AAED,SAAgB,oBAAoB,CAAC,QAAgB;IACnD,OAAO,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,IAAI,mCAAgB,CAAC;AACpE,CAAC;AAED,SAAgB,iBAAiB,CAAC,KAA6B;IAC7D,OAAO,oBAAoB,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AACtE,CAAC;AAED,yBAAyB,CAAC,yCAAmB,CAAC,CAAC;AAC/C,yBAAyB,CAAC,iCAAe,CAAC,CAAC;AAC3C,yBAAyB,CAAC,mDAAwB,CAAC,CAAC"}

package/dist/src/extractors/sentryExtractor.d.ts

@@ -0,0 +1,2 @@
+import type { ProviderExtractor } from './types';
+export declare const sentryExtractor: ProviderExtractor;

package/dist/src/extractors/sentryExtractor.js

@@ -0,0 +1,114 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sentryExtractor = void 0;
+const normalizeAlertTime_1 = require("../time/normalizeAlertTime");
+const genericExtractor_1 = require("./genericExtractor");
+function compactFacts(facts) {
+    return facts.filter((fact) => Boolean(fact));
+}
+exports.sentryExtractor = {
+    provider: 'sentry',
+    name: 'sentry-extractor',
+    version: genericExtractor_1.EXTRACTOR_VERSION,
+    extract: (input) => {
+        const labels = [
+            ...(0, genericExtractor_1.factsFromTagCollection)((0, genericExtractor_1.getPath)(input.raw, ['tags']), 'raw.tags'),
+            ...compactFacts([
+                (0, genericExtractor_1.makeFact)({
+                    key: 'level',
+                    value: (0, genericExtractor_1.firstPrimitive)(input.raw, [['level']]),
+                    sourcePath: 'raw.level',
+                    kind: 'label',
+                    confidence: 0.72,
+                }),
+            ]),
+        ];
+        const identifiers = compactFacts([
+            (0, genericExtractor_1.makeFact)({
+                key: 'projectSlug',
+                value: (0, genericExtractor_1.firstPrimitive)(input.raw, [['project', 'slug'], ['projectSlug']]),
+                sourcePath: 'raw.project.slug',
+                kind: 'provider_identity',
+                confidence: 0.9,
+            }),
+            (0, genericExtractor_1.makeFact)({
+                key: 'releasePackage',
+                value: (0, genericExtractor_1.firstPrimitive)(input.raw, [
+                    ['firstRelease', 'versionInfo', 'package'],
+                    ['release', 'versionInfo', 'package'],
+                ]),
+                sourcePath: 'raw.firstRelease.versionInfo.package',
+                kind: 'provider_identity',
+                confidence: 0.86,
+            }),
+            (0, genericExtractor_1.makeFact)({
+                key: 'serverName',
+                value: (0, genericExtractor_1.firstPrimitive)(input.raw, [['server_name'], ['serverName']]),
+                sourcePath: 'raw.server_name',
+                kind: 'provider_identity',
+                confidence: 0.75,
+            }),
+        ]);
+        const textHints = compactFacts([
+            (0, genericExtractor_1.makeFact)({
+                key: 'logger',
+                value: (0, genericExtractor_1.firstPrimitive)(input.raw, [['logger']]),
+                sourcePath: 'raw.logger',
+                kind: 'text_derived',
+                confidence: 0.58,
+            }),
+            (0, genericExtractor_1.makeFact)({
+                key: 'culprit',
+                value: (0, genericExtractor_1.firstPrimitive)(input.raw, [['culprit']]),
+                sourcePath: 'raw.culprit',
+                kind: 'text_derived',
+                confidence: 0.62,
+            }),
+            (0, genericExtractor_1.makeFact)({
+                key: 'filename',
+                value: (0, genericExtractor_1.firstPrimitive)(input.raw, [['metadata', 'filename']]),
+                sourcePath: 'raw.metadata.filename',
+                kind: 'resource_hint',
+                confidence: 0.6,
+            }),
+            (0, genericExtractor_1.makeFact)({
+                key: 'transaction',
+                value: (0, genericExtractor_1.firstPrimitive)(input.raw, [['transaction']]),
+                sourcePath: 'raw.transaction',
+                kind: 'resource_hint',
+                confidence: 0.68,
+            }),
+        ]);
+        const title = (0, genericExtractor_1.makeFact)({
+            key: 'title',
+            value: (0, genericExtractor_1.firstPrimitive)(input.raw, [['title'], ['metadata', 'title']]) ?? input.summary?.title,
+            sourcePath: (0, genericExtractor_1.firstPrimitive)(input.raw, [['title']]) ? 'raw.title' : 'summary.title',
+            kind: 'text_derived',
+            confidence: 0.82,
+        });
+        const severity = (0, genericExtractor_1.makeFact)({
+            key: 'severity',
+            value: (0, genericExtractor_1.firstPrimitive)(input.raw, [['level']]) ?? input.summary?.severity,
+            sourcePath: (0, genericExtractor_1.firstPrimitive)(input.raw, [['level']]) ? 'raw.level' : 'summary.severity',
+            kind: 'label',
+            confidence: 0.72,
+        });
+        return {
+            provider: input.alertRef.provider,
+            integrationId: input.alertRef.integrationId,
+            alertKey: input.alertRef.alertKey,
+            extractor: {
+                name: 'sentry-extractor',
+                version: genericExtractor_1.EXTRACTOR_VERSION,
+            },
+            time: (0, normalizeAlertTime_1.normalizeAlertTime)(input.alertRef, (0, genericExtractor_1.extractProviderTimeHints)(input.raw)),
+            labels,
+            identifiers,
+            resourceHints: textHints.filter((fact) => fact.kind === 'resource_hint'),
+            textHints,
+            ...(severity ? { severity } : {}),
+            ...(title ? { title } : {}),
+        };
+    },
+};
+//# sourceMappingURL=sentryExtractor.js.map

package/dist/src/extractors/sentryExtractor.js.map

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

package/dist/src/extractors/types.d.ts

@@ -0,0 +1,12 @@
+import type { AlertRef, AlertSummarySnapshot, AlertCorrelationFacts } from '../contracts';
+export interface ProviderExtractorInput {
+    alertRef: AlertRef;
+    raw: unknown;
+    summary?: AlertSummarySnapshot;
+}
+export interface ProviderExtractor {
+    provider: string;
+    name: string;
+    version: string;
+    extract(input: ProviderExtractorInput): AlertCorrelationFacts;
+}

package/dist/src/extractors/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/src/extractors/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/extractors/types.ts"],"names":[],"mappings":""}

package/dist/src/extractors/victoriaMetricsExtractor.d.ts

@@ -0,0 +1,2 @@
+import type { ProviderExtractor } from './types';
+export declare const victoriaMetricsExtractor: ProviderExtractor;

package/dist/src/extractors/victoriaMetricsExtractor.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.victoriaMetricsExtractor = void 0;
+const prometheusExtractor_1 = require("./prometheusExtractor");
+const genericExtractor_1 = require("./genericExtractor");
+exports.victoriaMetricsExtractor = {
+    provider: 'victoriametrics',
+    name: 'victoriametrics-extractor',
+    version: genericExtractor_1.EXTRACTOR_VERSION,
+    extract: (input) => (0, prometheusExtractor_1.extractPrometheusCompatibleFacts)(input, 'victoriametrics-extractor'),
+};
+//# sourceMappingURL=victoriaMetricsExtractor.js.map

package/dist/src/extractors/victoriaMetricsExtractor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"victoriaMetricsExtractor.js","sourceRoot":"","sources":["../../../src/extractors/victoriaMetricsExtractor.ts"],"names":[],"mappings":";;;AAAA,+DAAyE;AACzE,yDAAuD;AAG1C,QAAA,wBAAwB,GAAsB;IACzD,QAAQ,EAAE,iBAAiB;IAC3B,IAAI,EAAE,2BAA2B;IACjC,OAAO,EAAE,oCAAiB;IAC1B,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAA,sDAAgC,EAAC,KAAK,EAAE,2BAA2B,CAAC;CACzF,CAAC"}

package/dist/src/index.d.ts

@@ -0,0 +1,18 @@
+export declare const ALERT_CORRELATION_PACKAGE = "@scoutflo/alert-correlation";
+export * from './contracts/alertRef';
+export * from './contracts/facts';
+export * from './contracts/topology';
+export * from './contracts/decision';
+export * from './contracts/context';
+export * from './time/normalizeAlertTime';
+export * from './extractors/types';
+export * from './extractors/genericExtractor';
+export * from './extractors/prometheusExtractor';
+export * from './extractors/sentryExtractor';
+export * from './extractors/victoriaMetricsExtractor';
+export * from './extractors/registry';
+export * from './decision/reasonCodes';
+export * from './decision/decideTarget';
+export * from './matchers/types';
+export * from './matchers/providerRelationshipMatcher';
+export * from './resolveAlertCorrelation';

package/dist/src/index.js

@@ -0,0 +1,36 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ALERT_CORRELATION_PACKAGE = void 0;
+exports.ALERT_CORRELATION_PACKAGE = '@scoutflo/alert-correlation';
+__exportStar(require("./contracts/alertRef"), exports);
+__exportStar(require("./contracts/facts"), exports);
+__exportStar(require("./contracts/topology"), exports);
+__exportStar(require("./contracts/decision"), exports);
+__exportStar(require("./contracts/context"), exports);
+__exportStar(require("./time/normalizeAlertTime"), exports);
+__exportStar(require("./extractors/types"), exports);
+__exportStar(require("./extractors/genericExtractor"), exports);
+__exportStar(require("./extractors/prometheusExtractor"), exports);
+__exportStar(require("./extractors/sentryExtractor"), exports);
+__exportStar(require("./extractors/victoriaMetricsExtractor"), exports);
+__exportStar(require("./extractors/registry"), exports);
+__exportStar(require("./decision/reasonCodes"), exports);
+__exportStar(require("./decision/decideTarget"), exports);
+__exportStar(require("./matchers/types"), exports);
+__exportStar(require("./matchers/providerRelationshipMatcher"), exports);
+__exportStar(require("./resolveAlertCorrelation"), exports);
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAa,QAAA,yBAAyB,GAAG,6BAA6B,CAAC;AAEvE,uDAAqC;AACrC,oDAAkC;AAClC,uDAAqC;AACrC,uDAAqC;AACrC,sDAAoC;AACpC,4DAA0C;AAC1C,qDAAmC;AACnC,gEAA8C;AAC9C,mEAAiD;AACjD,+DAA6C;AAC7C,wEAAsD;AACtD,wDAAsC;AACtC,yDAAuC;AACvC,0DAAwC;AACxC,mDAAiC;AACjC,yEAAuD;AACvD,4DAA0C"}

package/dist/src/matchers/providerRelationshipMatcher.d.ts

@@ -0,0 +1,4 @@
+import type { AlertCorrelationFacts, CorrelationCandidate, TopologyCandidateInput } from '../contracts';
+export declare const PROVIDER_RELATIONSHIP_MATCHER_NAME = "provider-relationship-matcher";
+export declare const MATCHER_VERSION = "0.1.0";
+export declare function matchTopologyCandidates(facts: AlertCorrelationFacts, topology: TopologyCandidateInput): CorrelationCandidate[];

package/dist/src/matchers/providerRelationshipMatcher.js

@@ -0,0 +1,111 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MATCHER_VERSION = exports.PROVIDER_RELATIONSHIP_MATCHER_NAME = void 0;
+exports.matchTopologyCandidates = matchTopologyCandidates;
+const reasonCodes_1 = require("../decision/reasonCodes");
+exports.PROVIDER_RELATIONSHIP_MATCHER_NAME = 'provider-relationship-matcher';
+exports.MATCHER_VERSION = '0.1.0';
+const ATTRIBUTE_POLICIES = {
+    serviceLabel: { factKeys: ['service', 'microservice'] },
+    appLabel: { factKeys: ['app', 'app.kubernetes.io/name', 'k8s-app'] },
+    containerName: { factKeys: ['container', 'containerName', 'container_name'] },
+    jobLabel: { factKeys: ['job'] },
+    deploymentName: { factKeys: ['deployment', 'deploymentName', 'deployment_name'] },
+    alertnamePattern: { factKeys: ['alertname', 'title'], pattern: true },
+    serviceName: { factKeys: ['service', 'microservice', 'serviceName'] },
+    releasePackage: { factKeys: ['releasePackage'] },
+    project: { factKeys: ['project', 'projectSlug'] },
+    serverNamePattern: { factKeys: ['serverName', 'server_name', 'instance'], pattern: true },
+};
+function normalize(value) {
+    return value.trim().toLowerCase();
+}
+function isPrimitive(value) {
+    return typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean';
+}
+function allFacts(facts) {
+    return [
+        ...facts.labels,
+        ...facts.identifiers,
+        ...facts.resourceHints,
+        ...facts.textHints,
+        ...(facts.severity ? [facts.severity] : []),
+        ...(facts.title ? [facts.title] : []),
+    ];
+}
+function matchesPattern(pattern, value) {
+    try {
+        return new RegExp(pattern).test(value);
+    }
+    catch {
+        return normalize(pattern) === normalize(value);
+    }
+}
+function findTargetName(target, topology) {
+    if (target.type === 'service') {
+        return topology.services.find((service) => service.id === target.id)?.displayName
+            ?? topology.services.find((service) => service.id === target.id)?.name;
+    }
+    return topology.resources.find((resource) => resource.id === target.id)?.name;
+}
+function targetFromRelationship(relationship) {
+    return relationship.from.type === 'service' ? relationship.from : relationship.to;
+}
+function candidateKey(target) {
+    return `${target.type}:${target.id}`;
+}
+function matchTopologyCandidates(facts, topology) {
+    const factList = allFacts(facts);
+    const relationships = [
+        ...topology.monitoredByRelationships,
+        ...topology.deployedAsRelationships,
+    ];
+    const byTarget = new Map();
+    for (const relationship of relationships) {
+        const target = targetFromRelationship(relationship);
+        for (const [attributeName, attributeValue] of Object.entries(relationship.attributes ?? {})) {
+            const policy = ATTRIBUTE_POLICIES[attributeName];
+            if (!policy || !isPrimitive(attributeValue))
+                continue;
+            const expectedValue = String(attributeValue);
+            const matchingFact = factList.find((fact) => {
+                if (!policy.factKeys.includes(fact.key))
+                    return false;
+                return policy.pattern
+                    ? matchesPattern(expectedValue, fact.value)
+                    : normalize(expectedValue) === normalize(fact.value);
+            });
+            if (!matchingFact)
+                continue;
+            const score = policy.pattern ? 8 : 10;
+            const key = candidateKey(target);
+            const existing = byTarget.get(key);
+            const evidence = {
+                kind: 'relationship_attribute',
+                factKey: matchingFact.key,
+                factValue: matchingFact.value,
+                relationshipId: relationship.id,
+                reason: `${attributeName} ${policy.pattern ? 'pattern' : 'exact'} match`,
+            };
+            const reasonCode = policy.pattern
+                ? reasonCodes_1.REASON_CODES.RELATIONSHIP_PATTERN_MATCH
+                : reasonCodes_1.REASON_CODES.RELATIONSHIP_ATTRIBUTE_MATCH;
+            if (existing) {
+                existing.confidence = Math.min(10, Math.max(existing.confidence, score) + 1);
+                existing.evidence.push(evidence);
+                existing.reasonCodes = [...new Set([...existing.reasonCodes, reasonCode])];
+            }
+            else {
+                byTarget.set(key, {
+                    target,
+                    name: findTargetName(target, topology),
+                    confidence: score,
+                    evidence: [evidence],
+                    reasonCodes: [reasonCode],
+                });
+            }
+        }
+    }
+    return [...byTarget.values()].sort((left, right) => right.confidence - left.confidence);
+}
+//# sourceMappingURL=providerRelationshipMatcher.js.map

package/dist/src/matchers/providerRelationshipMatcher.js.map

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

package/dist/src/matchers/types.d.ts

@@ -0,0 +1,10 @@
+import type { AlertCorrelationFacts, CorrelationCandidate, TopologyCandidateInput } from '../contracts';
+export interface TopologyMatcherInput {
+    facts: AlertCorrelationFacts;
+    topology: TopologyCandidateInput;
+}
+export interface TopologyMatcher {
+    name: string;
+    version: string;
+    match(input: TopologyMatcherInput): CorrelationCandidate[];
+}

package/dist/src/matchers/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/src/matchers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/matchers/types.ts"],"names":[],"mappings":""}

package/dist/src/resolveAlertCorrelation.d.ts

@@ -0,0 +1,13 @@
+import type { AlertCorrelationDecision, AlertCorrelationFacts, AlertRef, AlertSummarySnapshot, CorrelationCandidate, TopologyCandidateInput } from './contracts';
+export interface ResolveAlertCorrelationInput {
+    alertRef: AlertRef;
+    rawAlert: unknown;
+    summary?: AlertSummarySnapshot;
+    topology: TopologyCandidateInput;
+}
+export interface ResolveAlertCorrelationResult {
+    facts: AlertCorrelationFacts;
+    candidates: CorrelationCandidate[];
+    decision: AlertCorrelationDecision;
+}
+export declare function resolveAlertCorrelation(input: ResolveAlertCorrelationInput): ResolveAlertCorrelationResult;

package/dist/src/resolveAlertCorrelation.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveAlertCorrelation = resolveAlertCorrelation;
+const decideTarget_1 = require("./decision/decideTarget");
+const registry_1 = require("./extractors/registry");
+const providerRelationshipMatcher_1 = require("./matchers/providerRelationshipMatcher");
+function resolveAlertCorrelation(input) {
+    const facts = (0, registry_1.extractAlertFacts)({
+        alertRef: input.alertRef,
+        raw: input.rawAlert,
+        summary: input.summary,
+    });
+    const candidates = (0, providerRelationshipMatcher_1.matchTopologyCandidates)(facts, input.topology);
+    const decision = (0, decideTarget_1.decideTarget)(candidates);
+    return { facts, candidates, decision };
+}
+//# sourceMappingURL=resolveAlertCorrelation.js.map

package/dist/src/resolveAlertCorrelation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveAlertCorrelation.js","sourceRoot":"","sources":["../../src/resolveAlertCorrelation.ts"],"names":[],"mappings":";;AAyBA,0DAYC;AA7BD,0DAAuD;AACvD,oDAA0D;AAC1D,wFAAiF;AAejF,SAAgB,uBAAuB,CACrC,KAAmC;IAEnC,MAAM,KAAK,GAAG,IAAA,4BAAiB,EAAC;QAC9B,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,GAAG,EAAE,KAAK,CAAC,QAAQ;QACnB,OAAO,EAAE,KAAK,CAAC,OAAO;KACvB,CAAC,CAAC;IACH,MAAM,UAAU,GAAG,IAAA,qDAAuB,EAAC,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IAClE,MAAM,QAAQ,GAAG,IAAA,2BAAY,EAAC,UAAU,CAAC,CAAC;IAE1C,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;AACzC,CAAC"}

package/dist/src/time/normalizeAlertTime.d.ts

@@ -0,0 +1,9 @@
+import type { AlertRef, AlertTimeWindow } from '../contracts';
+export interface ProviderTimeHints {
+    startsAt?: string;
+    firstSeen?: string;
+    eventTimestamp?: string;
+    endsAt?: string;
+    lastSeen?: string;
+}
+export declare function normalizeAlertTime(alertRef: AlertRef, hints: ProviderTimeHints): AlertTimeWindow;

package/dist/src/time/normalizeAlertTime.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeAlertTime = normalizeAlertTime;
+function firstValidIso(...values) {
+    return values.find((value) => {
+        if (!value)
+            return false;
+        const date = new Date(value);
+        return !Number.isNaN(date.getTime());
+    });
+}
+function normalizeAlertTime(alertRef, hints) {
+    const startsAt = firstValidIso(hints.startsAt, hints.firstSeen, hints.eventTimestamp, alertRef.timestamp) ??
+        alertRef.timestamp;
+    const endsAt = firstValidIso(hints.endsAt, hints.lastSeen);
+    return {
+        timestamp: alertRef.timestamp,
+        selectedAt: alertRef.selectedAt,
+        startsAt,
+        ...(endsAt ? { endsAt } : {}),
+        ...(hints.lastSeen ? { lastSeen: hints.lastSeen } : {}),
+        isOpenEnded: !endsAt,
+    };
+}
+//# sourceMappingURL=normalizeAlertTime.js.map

package/dist/src/time/normalizeAlertTime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeAlertTime.js","sourceRoot":"","sources":["../../../src/time/normalizeAlertTime.ts"],"names":[],"mappings":";;AAkBA,gDAkBC;AA1BD,SAAS,aAAa,CAAC,GAAG,MAAiC;IACzD,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE;QAC3B,IAAI,CAAC,KAAK;YAAE,OAAO,KAAK,CAAC;QACzB,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAgB,kBAAkB,CAChC,QAAkB,EAClB,KAAwB;IAExB,MAAM,QAAQ,GACZ,aAAa,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,cAAc,EAAE,QAAQ,CAAC,SAAS,CAAC;QACxF,QAAQ,CAAC,SAAS,CAAC;IAErB,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IAE3D,OAAO;QACL,SAAS,EAAE,QAAQ,CAAC,SAAS;QAC7B,UAAU,EAAE,QAAQ,CAAC,UAAU;QAC/B,QAAQ;QACR,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7B,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvD,WAAW,EAAE,CAAC,MAAM;KACrB,CAAC;AACJ,CAAC"}

package/dist/test/contracts.test.d.ts

@@ -0,0 +1 @@
+export {};