@x12i/memorix-insights 1.1.0

package/README.md

@@ -0,0 +1,40 @@
+# @x12i/memorix-insights
+
+Pluggable insight processors for Memorix. The platform runs processors generically by `processorId`; implementations may be local functions or HTTP APIs.
+
+## Concepts
+
+- **Stage**: a processor with `inputKind` and `outputKind` (e.g. `cidr` → `cidr-path-facts` → `insights`).
+- **Engine**: `runInsightProcessor` for one stage, `runInsightPipeline` for ordered stages.
+- **Custom processors**: register via `InsightProcessorRegistry`; CIDR network processors ship as builtins.
+
+## CIDR example
+
+```ts
+import {
+  createInsightProcessorRegistry,
+  runInsightPipeline,
+  builtinInsightProcessors,
+} from "@x12i/memorix-insights";
+
+const registry = createInsightProcessorRegistry(builtinInsightProcessors);
+
+const result = await runInsightPipeline(registry, {
+  input: "10.150.68.0/24",
+  stages: [
+    {
+      processorId: "network.cidr-topology-path-resolver",
+      sources: {
+        topologyDb: "memorix-knowledge",
+        topologyCollection: "topology-raw",
+      },
+    },
+    {
+      processorId: "network.cidr-zone-path-insights",
+      sources: { zonesCollection: "topology-zones-snapshots" },
+    },
+  ],
+});
+```
+
+Topology resolution (`network.cidr-topology-path-resolver`) emits structural facts only. Zone insight generation (`network.cidr-zone-path-insights`) applies zone flags and emits judgment insights.

package/dist/core/api-processor.d.ts

@@ -0,0 +1,12 @@
+import type { InsightProcessorDefinition } from "./types.js";
+export type ApiInsightProcessorConfig = {
+    url: string;
+    method?: "POST" | "PUT";
+    headers?: Record<string, string>;
+    timeoutMs?: number;
+};
+/**
+ * Wraps a remote HTTP insight processor behind the same platform contract as local functions.
+ */
+export declare function createApiInsightProcessorDefinition(processorId: string, inputKind: string, outputKind: string, apiConfig: ApiInsightProcessorConfig): InsightProcessorDefinition;
+//# sourceMappingURL=api-processor.d.ts.map

package/dist/core/api-processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-processor.d.ts","sourceRoot":"","sources":["../../src/core/api-processor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,0BAA0B,EAG3B,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,yBAAyB,GAAG;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;GAEG;AACH,wBAAgB,mCAAmC,CACjD,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,yBAAyB,GACnC,0BAA0B,CAiE5B"}

package/dist/core/api-processor.js

@@ -0,0 +1,65 @@
+/**
+ * Wraps a remote HTTP insight processor behind the same platform contract as local functions.
+ */
+export function createApiInsightProcessorDefinition(processorId, inputKind, outputKind, apiConfig) {
+    return {
+        processorId,
+        inputKind,
+        outputKind,
+        create(_context) {
+            return {
+                async process(input) {
+                    const controller = new AbortController();
+                    const timeout = setTimeout(() => controller.abort(), apiConfig.timeoutMs ?? 30_000);
+                    try {
+                        const response = await fetch(apiConfig.url, {
+                            method: apiConfig.method ?? "POST",
+                            headers: {
+                                "content-type": "application/json",
+                                ...apiConfig.headers,
+                            },
+                            body: JSON.stringify({
+                                processorId,
+                                input: input.input,
+                                config: input.config,
+                                sources: input.sources,
+                            }),
+                            signal: controller.signal,
+                        });
+                        if (!response.ok) {
+                            return {
+                                processorId,
+                                inputKind,
+                                outputKind,
+                                resolved: false,
+                                data: null,
+                                diagnostics: [
+                                    {
+                                        level: "error",
+                                        code: "API_PROCESSOR_FAILED",
+                                        message: `API processor ${processorId} returned HTTP ${response.status}`,
+                                    },
+                                ],
+                            };
+                        }
+                        const payload = (await response.json());
+                        return {
+                            processorId,
+                            inputKind,
+                            outputKind,
+                            resolved: payload.resolved !== false,
+                            data: payload.data ?? payload,
+                            diagnostics: Array.isArray(payload.diagnostics)
+                                ? payload.diagnostics
+                                : [],
+                        };
+                    }
+                    finally {
+                        clearTimeout(timeout);
+                    }
+                },
+            };
+        },
+    };
+}
+//# sourceMappingURL=api-processor.js.map

package/dist/core/api-processor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-processor.js","sourceRoot":"","sources":["../../src/core/api-processor.ts"],"names":[],"mappings":"AAcA;;GAEG;AACH,MAAM,UAAU,mCAAmC,CACjD,WAAmB,EACnB,SAAiB,EACjB,UAAkB,EAClB,SAAoC;IAEpC,OAAO;QACL,WAAW;QACX,SAAS;QACT,UAAU;QACV,MAAM,CAAC,QAAiC;YACtC,OAAO;gBACL,KAAK,CAAC,OAAO,CAAC,KAA4B;oBACxC,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;oBACzC,MAAM,OAAO,GAAG,UAAU,CACxB,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EACxB,SAAS,CAAC,SAAS,IAAI,MAAM,CAC9B,CAAC;oBAEF,IAAI,CAAC;wBACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;4BAC1C,MAAM,EAAE,SAAS,CAAC,MAAM,IAAI,MAAM;4BAClC,OAAO,EAAE;gCACP,cAAc,EAAE,kBAAkB;gCAClC,GAAG,SAAS,CAAC,OAAO;6BACrB;4BACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gCACnB,WAAW;gCACX,KAAK,EAAE,KAAK,CAAC,KAAK;gCAClB,MAAM,EAAE,KAAK,CAAC,MAAM;gCACpB,OAAO,EAAE,KAAK,CAAC,OAAO;6BACvB,CAAC;4BACF,MAAM,EAAE,UAAU,CAAC,MAAM;yBAC1B,CAAC,CAAC;wBAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;4BACjB,OAAO;gCACL,WAAW;gCACX,SAAS;gCACT,UAAU;gCACV,QAAQ,EAAE,KAAK;gCACf,IAAI,EAAE,IAAI;gCACV,WAAW,EAAE;oCACX;wCACE,KAAK,EAAE,OAAO;wCACd,IAAI,EAAE,sBAAsB;wCAC5B,OAAO,EAAE,iBAAiB,WAAW,kBAAkB,QAAQ,CAAC,MAAM,EAAE;qCACzE;iCACF;6BACF,CAAC;wBACJ,CAAC;wBAED,MAAM,OAAO,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAA4B,CAAC;wBACnE,OAAO;4BACL,WAAW;4BACX,SAAS;4BACT,UAAU;4BACV,QAAQ,EAAE,OAAO,CAAC,QAAQ,KAAK,KAAK;4BACpC,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,OAAO;4BAC7B,WAAW,EAAE,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC;gCAC7C,CAAC,CAAE,OAAO,CAAC,WAAqD;gCAChE,CAAC,CAAC,EAAE;yBACP,CAAC;oBACJ,CAAC;4BAAS,CAAC;wBACT,YAAY,CAAC,OAAO,CAAC,CAAC;oBACxB,CAAC;gBACH,CAAC;aACF,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/core/insight-engine.d.ts

@@ -0,0 +1,5 @@
+import type { InsightProcessorRegistry } from "./registry.js";
+import type { InsightProcessorResult, RunInsightPipelineOptions, RunInsightPipelineResult, RunInsightProcessorOptions } from "./types.js";
+export declare function runInsightProcessor(registry: InsightProcessorRegistry, options: RunInsightProcessorOptions): Promise<InsightProcessorResult>;
+export declare function runInsightPipeline(registry: InsightProcessorRegistry, options: RunInsightPipelineOptions): Promise<RunInsightPipelineResult>;
+//# sourceMappingURL=insight-engine.d.ts.map

package/dist/core/insight-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"insight-engine.d.ts","sourceRoot":"","sources":["../../src/core/insight-engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,KAAK,EAGV,sBAAsB,EACtB,yBAAyB,EACzB,wBAAwB,EACxB,0BAA0B,EAC3B,MAAM,YAAY,CAAC;AAsBpB,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,wBAAwB,EAClC,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,sBAAsB,CAAC,CAkBjC;AAED,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,wBAAwB,EAClC,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,wBAAwB,CAAC,CAgCnC"}

package/dist/core/insight-engine.js

@@ -0,0 +1,60 @@
+function validateStageChain(registry, stages) {
+    let expectedInputKind = null;
+    for (let i = 0; i < stages.length; i += 1) {
+        const stage = stages[i];
+        const definition = registry.get(stage.processorId);
+        if (!definition) {
+            throw new Error(`Unknown insight processor: ${stage.processorId}`);
+        }
+        if (expectedInputKind !== null && definition.inputKind !== expectedInputKind) {
+            throw new Error(`Stage ${i} (${stage.processorId}) expects inputKind ${definition.inputKind}, but previous stage produced ${expectedInputKind}`);
+        }
+        expectedInputKind = definition.outputKind;
+    }
+}
+export async function runInsightProcessor(registry, options) {
+    const definition = registry.get(options.processorId);
+    if (!definition) {
+        throw new Error(`Unknown insight processor: ${options.processorId}`);
+    }
+    const context = {
+        processorId: options.processorId,
+        stageIndex: 0,
+        loadSource: options.context?.loadSource,
+    };
+    const processor = registry.create(options.processorId, context);
+    return processor.process({
+        input: options.input,
+        config: options.config,
+        sources: options.sources,
+    });
+}
+export async function runInsightPipeline(registry, options) {
+    validateStageChain(registry, options.stages);
+    const stageResults = [];
+    const diagnostics = [];
+    let currentInput = options.input;
+    for (let stageIndex = 0; stageIndex < options.stages.length; stageIndex += 1) {
+        const stage = options.stages[stageIndex];
+        const context = {
+            processorId: stage.processorId,
+            stageIndex,
+            loadSource: options.context?.loadSource,
+        };
+        const processor = registry.create(stage.processorId, context);
+        const result = await processor.process({
+            input: currentInput,
+            config: stage.config,
+            sources: stage.sources,
+        });
+        stageResults.push(result);
+        diagnostics.push(...result.diagnostics);
+        currentInput = result.data;
+    }
+    return {
+        stages: stageResults,
+        final: stageResults.length > 0 ? stageResults[stageResults.length - 1] : null,
+        diagnostics,
+    };
+}
+//# sourceMappingURL=insight-engine.js.map

package/dist/core/insight-engine.js.map

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

package/dist/core/registry.d.ts

@@ -0,0 +1,12 @@
+import type { InsightProcessorDefinition } from "./types.js";
+export declare class InsightProcessorRegistry {
+    private readonly definitions;
+    register(definition: InsightProcessorDefinition): this;
+    registerMany(definitions: InsightProcessorDefinition[]): this;
+    has(processorId: string): boolean;
+    get(processorId: string): InsightProcessorDefinition | undefined;
+    listProcessorIds(): string[];
+    create(processorId: string, context: Parameters<InsightProcessorDefinition["create"]>[0]): import("./types.js").InsightProcessor;
+}
+export declare function createInsightProcessorRegistry(definitions?: InsightProcessorDefinition[]): InsightProcessorRegistry;
+//# sourceMappingURL=registry.d.ts.map

package/dist/core/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/core/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAE7D,qBAAa,wBAAwB;IACnC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAiD;IAE7E,QAAQ,CAAC,UAAU,EAAE,0BAA0B,GAAG,IAAI;IAQtD,YAAY,CAAC,WAAW,EAAE,0BAA0B,EAAE,GAAG,IAAI;IAO7D,GAAG,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAIjC,GAAG,CAAC,WAAW,EAAE,MAAM,GAAG,0BAA0B,GAAG,SAAS;IAIhE,gBAAgB,IAAI,MAAM,EAAE;IAI5B,MAAM,CACJ,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,UAAU,CAAC,0BAA0B,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;CAQ/D;AAED,wBAAgB,8BAA8B,CAC5C,WAAW,GAAE,0BAA0B,EAAO,GAC7C,wBAAwB,CAE1B"}

package/dist/core/registry.js

@@ -0,0 +1,36 @@
+export class InsightProcessorRegistry {
+    definitions = new Map();
+    register(definition) {
+        if (this.definitions.has(definition.processorId)) {
+            throw new Error(`Insight processor already registered: ${definition.processorId}`);
+        }
+        this.definitions.set(definition.processorId, definition);
+        return this;
+    }
+    registerMany(definitions) {
+        for (const definition of definitions) {
+            this.register(definition);
+        }
+        return this;
+    }
+    has(processorId) {
+        return this.definitions.has(processorId);
+    }
+    get(processorId) {
+        return this.definitions.get(processorId);
+    }
+    listProcessorIds() {
+        return [...this.definitions.keys()].sort();
+    }
+    create(processorId, context) {
+        const definition = this.definitions.get(processorId);
+        if (!definition) {
+            throw new Error(`Unknown insight processor: ${processorId}`);
+        }
+        return definition.create(context);
+    }
+}
+export function createInsightProcessorRegistry(definitions = []) {
+    return new InsightProcessorRegistry().registerMany(definitions);
+}
+//# sourceMappingURL=registry.js.map

package/dist/core/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/core/registry.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,wBAAwB;IAClB,WAAW,GAAG,IAAI,GAAG,EAAsC,CAAC;IAE7E,QAAQ,CAAC,UAAsC;QAC7C,IAAI,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YACjD,MAAM,IAAI,KAAK,CAAC,yCAAyC,UAAU,CAAC,WAAW,EAAE,CAAC,CAAC;QACrF,CAAC;QACD,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;QACzD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,YAAY,CAAC,WAAyC;QACpD,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;YACrC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QAC5B,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,GAAG,CAAC,WAAmB;QACrB,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAC3C,CAAC;IAED,GAAG,CAAC,WAAmB;QACrB,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAC3C,CAAC;IAED,gBAAgB;QACd,OAAO,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7C,CAAC;IAED,MAAM,CACJ,WAAmB,EACnB,OAA4D;QAE5D,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACrD,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,8BAA8B,WAAW,EAAE,CAAC,CAAC;QAC/D,CAAC;QACD,OAAO,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACpC,CAAC;CACF;AAED,MAAM,UAAU,8BAA8B,CAC5C,cAA4C,EAAE;IAE9C,OAAO,IAAI,wBAAwB,EAAE,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC;AAClE,CAAC"}

package/dist/core/types.d.ts

@@ -0,0 +1,65 @@
+export type JsonObject = Record<string, unknown>;
+export type InsightDiagnosticLevel = "info" | "warning" | "error";
+export type InsightDiagnostic = {
+    level: InsightDiagnosticLevel;
+    code: string;
+    message: string;
+    details?: Record<string, unknown>;
+};
+export type InsightProcessorContext = {
+    processorId: string;
+    stageIndex: number;
+    /** Load external source payloads (e.g. topology-raw collection document). */
+    loadSource?: (sourceKey: string, ref: InsightSourceRef) => Promise<unknown>;
+};
+export type InsightSourceRef = {
+    db?: string;
+    collection?: string;
+    recordId?: string;
+    path?: string;
+};
+export type InsightProcessorInput = {
+    input: unknown;
+    config?: Record<string, unknown>;
+    sources?: Record<string, unknown>;
+};
+export type InsightProcessorResult = {
+    processorId: string;
+    inputKind: string;
+    outputKind: string;
+    resolved: boolean;
+    data: unknown;
+    diagnostics: InsightDiagnostic[];
+};
+export type InsightProcessor = {
+    process(input: InsightProcessorInput): Promise<InsightProcessorResult>;
+};
+export type InsightProcessorDefinition = {
+    processorId: string;
+    inputKind: string;
+    outputKind: string;
+    create(context: InsightProcessorContext): InsightProcessor;
+};
+export type InsightPipelineStage = {
+    processorId: string;
+    config?: Record<string, unknown>;
+    sources?: Record<string, unknown>;
+};
+export type RunInsightProcessorOptions = {
+    processorId: string;
+    input: unknown;
+    config?: Record<string, unknown>;
+    sources?: Record<string, unknown>;
+    context?: Partial<InsightProcessorContext>;
+};
+export type RunInsightPipelineOptions = {
+    input: unknown;
+    stages: InsightPipelineStage[];
+    context?: Partial<InsightProcessorContext>;
+};
+export type RunInsightPipelineResult = {
+    stages: InsightProcessorResult[];
+    final: InsightProcessorResult | null;
+    diagnostics: InsightDiagnostic[];
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/core/types.d.ts.map

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

package/dist/core/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

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

package/dist/domain/network/cidr-topology-analyzer.d.ts

@@ -0,0 +1,36 @@
+export type CidrPathFacts = {
+    input: string;
+    resolved: boolean;
+    matchType: "exact" | "containing" | "none";
+    resolvedSegment?: string;
+    originZone?: string;
+    reachableZones: Array<{
+        zoneName: string;
+        hopCount: number;
+        destinationSegment: string;
+        path: string[];
+        steps: Array<{
+            from: string;
+            to: string;
+        }>;
+    }>;
+    unclassifiedReachable: string[];
+    reachableSegments: string[];
+};
+export type TopologySegment = {
+    id: string;
+    cidr?: string;
+    zone?: string;
+};
+export type TopologyGraph = {
+    segments: TopologySegment[];
+    edges: Array<{
+        from: string;
+        to: string;
+    }>;
+};
+export declare function normalizeCidrInput(value: unknown): string | null;
+export declare function segmentIdForCidr(cidr: string): string;
+export declare function parseTopologyGraph(raw: unknown): TopologyGraph | null;
+export declare function resolveCidrPathFacts(graph: TopologyGraph, cidrInput: string): CidrPathFacts;
+//# sourceMappingURL=cidr-topology-analyzer.d.ts.map

package/dist/domain/network/cidr-topology-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cidr-topology-analyzer.d.ts","sourceRoot":"","sources":["../../../src/domain/network/cidr-topology-analyzer.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,GAAG,YAAY,GAAG,MAAM,CAAC;IAC3C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,KAAK,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,IAAI,EAAE,MAAM,EAAE,CAAC;QACf,KAAK,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,EAAE,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAC5C,CAAC,CAAC;IACH,qBAAqB,EAAE,MAAM,EAAE,CAAC;IAChC,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC5C,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAIhE;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,aAAa,GAAG,IAAI,CAgCrE;AAgDD,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,aAAa,EACpB,SAAS,EAAE,MAAM,GAChB,aAAa,CAoFf"}

package/dist/domain/network/cidr-topology-analyzer.js

@@ -0,0 +1,172 @@
+import { parseCidr } from "@x12i/memorix-resolvers";
+export function normalizeCidrInput(value) {
+    if (typeof value !== "string")
+        return null;
+    const trimmed = value.trim();
+    return trimmed || null;
+}
+export function segmentIdForCidr(cidr) {
+    return `seg:${cidr}`;
+}
+export function parseTopologyGraph(raw) {
+    if (!raw || typeof raw !== "object")
+        return null;
+    const doc = raw;
+    const graph = (doc.graph ?? doc.data ?? doc);
+    const segmentsRaw = (graph.segments ?? graph.nodes ?? []);
+    const edgesRaw = (graph.edges ?? graph.links ?? []);
+    const segments = [];
+    for (const item of segmentsRaw) {
+        if (!item || typeof item !== "object")
+            continue;
+        const seg = item;
+        const id = String(seg.id ?? seg.segmentId ?? seg.key ?? "");
+        if (!id)
+            continue;
+        segments.push({
+            id,
+            cidr: typeof seg.cidr === "string" ? seg.cidr : undefined,
+            zone: typeof seg.zone === "string" ? seg.zone : typeof seg.zoneName === "string" ? seg.zoneName : undefined,
+        });
+    }
+    const edges = [];
+    for (const item of edgesRaw) {
+        if (!item || typeof item !== "object")
+            continue;
+        const edge = item;
+        const from = String(edge.from ?? edge.source ?? "");
+        const to = String(edge.to ?? edge.target ?? "");
+        if (from && to)
+            edges.push({ from, to });
+    }
+    if (segments.length === 0)
+        return null;
+    return { segments, edges };
+}
+function cidrContains(outer, inner) {
+    const outerRange = parseCidr(outer);
+    const innerRange = parseCidr(inner);
+    if (!outerRange || !innerRange)
+        return false;
+    return innerRange.network >= outerRange.network && innerRange.broadcast <= outerRange.broadcast;
+}
+function resolveSegmentForCidr(graph, cidr) {
+    const exact = graph.segments.find((s) => s.cidr === cidr);
+    if (exact)
+        return { segment: exact, matchType: "exact" };
+    let best = null;
+    let bestPrefix = -1;
+    for (const segment of graph.segments) {
+        if (!segment.cidr)
+            continue;
+        if (!cidrContains(segment.cidr, cidr))
+            continue;
+        const range = parseCidr(segment.cidr);
+        if (!range)
+            continue;
+        if (range.prefix > bestPrefix) {
+            bestPrefix = range.prefix;
+            best = segment;
+        }
+    }
+    if (best)
+        return { segment: best, matchType: "containing" };
+    return null;
+}
+function buildAdjacency(graph) {
+    const adj = new Map();
+    for (const segment of graph.segments) {
+        if (!adj.has(segment.id))
+            adj.set(segment.id, []);
+    }
+    for (const edge of graph.edges) {
+        const list = adj.get(edge.from) ?? [];
+        list.push(edge.to);
+        adj.set(edge.from, list);
+        const reverse = adj.get(edge.to) ?? [];
+        reverse.push(edge.from);
+        adj.set(edge.to, reverse);
+    }
+    return adj;
+}
+export function resolveCidrPathFacts(graph, cidrInput) {
+    const input = normalizeCidrInput(cidrInput);
+    if (!input) {
+        return {
+            input: String(cidrInput),
+            resolved: false,
+            matchType: "none",
+            reachableZones: [],
+            unclassifiedReachable: [],
+            reachableSegments: [],
+        };
+    }
+    const match = resolveSegmentForCidr(graph, input);
+    if (!match) {
+        return {
+            input,
+            resolved: false,
+            matchType: "none",
+            reachableZones: [],
+            unclassifiedReachable: [],
+            reachableSegments: [],
+        };
+    }
+    const originId = match.segment.id;
+    const originZone = match.segment.zone;
+    const adj = buildAdjacency(graph);
+    const visited = new Set([originId]);
+    const queue = [
+        { id: originId, path: [originId], hops: 0 },
+    ];
+    const reachableByZone = new Map();
+    while (queue.length > 0) {
+        const current = queue.shift();
+        for (const nextId of adj.get(current.id) ?? []) {
+            if (visited.has(nextId))
+                continue;
+            visited.add(nextId);
+            const nextPath = [...current.path, nextId];
+            const nextHops = current.hops + 1;
+            queue.push({ id: nextId, path: nextPath, hops: nextHops });
+            const segment = graph.segments.find((s) => s.id === nextId);
+            if (!segment?.zone)
+                continue;
+            const existing = reachableByZone.get(segment.zone);
+            if (!existing || nextHops < existing.hopCount) {
+                reachableByZone.set(segment.zone, {
+                    hopCount: nextHops,
+                    path: nextPath,
+                    destinationSegment: nextId,
+                });
+            }
+        }
+    }
+    const reachableZones = [...reachableByZone.entries()].map(([zoneName, info]) => ({
+        zoneName,
+        hopCount: info.hopCount,
+        destinationSegment: info.destinationSegment,
+        path: info.path,
+        steps: info.path.slice(1).map((id, index) => ({
+            from: info.path[index],
+            to: id,
+        })),
+    }));
+    const unclassifiedReachable = [...visited]
+        .filter((id) => {
+        const segment = graph.segments.find((s) => s.id === id);
+        return !segment?.zone;
+    })
+        .filter((id) => id !== originId);
+    return {
+        input,
+        resolved: true,
+        matchType: match.matchType,
+        resolvedSegment: originId,
+        originZone,
+        reachableZones,
+        unclassifiedReachable,
+        reachableSegments: [...visited],
+    };
+}
+//# sourceMappingURL=cidr-topology-analyzer.js.map

package/dist/domain/network/cidr-topology-analyzer.js.map

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

package/dist/domain/network/cidr-zone-insight-rules.d.ts

@@ -0,0 +1,26 @@
+import type { CidrPathFacts } from "./cidr-topology-analyzer.js";
+export type ZoneRegistryEntry = {
+    name: string;
+    isOutside?: boolean;
+    isInternal?: boolean;
+    isDmzOrPortal?: boolean;
+    isRemoteAccess?: boolean;
+    isPartnerLink?: boolean;
+};
+export type ZoneInsight = {
+    insight: string;
+    description: string;
+    reasoning: string;
+    supportingFacts: string[];
+};
+export type ZonePathInsightsResult = {
+    processorId: string;
+    inputKind: "cidr-path-facts";
+    input: CidrPathFacts;
+    resolved: boolean;
+    insights: ZoneInsight[];
+    paths: Record<string, unknown>;
+};
+export declare function parseZoneRegistry(raw: unknown): ZoneRegistryEntry[];
+export declare function generateZonePathInsights(facts: CidrPathFacts, zones: ZoneRegistryEntry[]): ZonePathInsightsResult;
+//# sourceMappingURL=cidr-zone-insight-rules.d.ts.map

package/dist/domain/network/cidr-zone-insight-rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cidr-zone-insight-rules.d.ts","sourceRoot":"","sources":["../../../src/domain/network/cidr-zone-insight-rules.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAEjE,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,iBAAiB,CAAC;IAC7B,KAAK,EAAE,aAAa,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,iBAAiB,EAAE,CAwBnE;AAED,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,aAAa,EACpB,KAAK,EAAE,iBAAiB,EAAE,GACzB,sBAAsB,CAmExB"}

package/dist/domain/network/cidr-zone-insight-rules.js

@@ -0,0 +1,90 @@
+export function parseZoneRegistry(raw) {
+    if (!raw)
+        return [];
+    const list = Array.isArray(raw)
+        ? raw
+        : Array.isArray(raw.zones)
+            ? raw.zones
+            : [];
+    const zones = [];
+    for (const item of list) {
+        if (!item || typeof item !== "object")
+            continue;
+        const zone = item;
+        const name = typeof zone.name === "string" ? zone.name : typeof zone.zoneName === "string" ? zone.zoneName : null;
+        if (!name)
+            continue;
+        zones.push({
+            name,
+            isOutside: zone.isOutside === true,
+            isInternal: zone.isInternal === true,
+            isDmzOrPortal: zone.isDmzOrPortal === true,
+            isRemoteAccess: zone.isRemoteAccess === true,
+            isPartnerLink: zone.isPartnerLink === true,
+        });
+    }
+    return zones;
+}
+export function generateZonePathInsights(facts, zones) {
+    const insights = [];
+    const zoneByName = new Map(zones.map((z) => [z.name, z]));
+    if (!facts.resolved) {
+        return {
+            processorId: "network.cidr-zone-path-insights",
+            inputKind: "cidr-path-facts",
+            input: facts,
+            resolved: false,
+            insights,
+            paths: {},
+        };
+    }
+    for (const reachable of facts.reachableZones) {
+        const zone = zoneByName.get(reachable.zoneName);
+        if (!zone)
+            continue;
+        if (zone.isOutside) {
+            insights.push({
+                insight: "INTERNET_EGRESS_AVAILABLE",
+                description: "This network has a routable path to the public network.",
+                reasoning: "The structural path reaches a zone flagged isOutside=true.",
+                supportingFacts: [`reachable zone "${reachable.zoneName}" has isOutside=true`],
+            });
+        }
+        if (zone.isDmzOrPortal) {
+            insights.push({
+                insight: "DMZ_REACHABLE",
+                description: "This network has a routable path to a DMZ or portal zone.",
+                reasoning: "The structural path reaches a zone flagged isDmzOrPortal=true.",
+                supportingFacts: [`reachable zone "${reachable.zoneName}" has isDmzOrPortal=true`],
+            });
+        }
+        if (zone.isRemoteAccess) {
+            insights.push({
+                insight: "REMOTE_ACCESS_ADJACENT",
+                description: "This network is adjacent to a remote-access zone.",
+                reasoning: "The structural path reaches a zone flagged isRemoteAccess=true.",
+                supportingFacts: [`reachable zone "${reachable.zoneName}" has isRemoteAccess=true`],
+            });
+        }
+    }
+    const originZone = facts.originZone ? zoneByName.get(facts.originZone) : undefined;
+    if (originZone?.isInternal) {
+        insights.push({
+            insight: "INTERNAL_ORIGIN",
+            description: "This network originates in an internal zone.",
+            reasoning: "The resolved segment origin zone is flagged isInternal=true.",
+            supportingFacts: [`origin zone "${facts.originZone}" has isInternal=true`],
+        });
+    }
+    return {
+        processorId: "network.cidr-zone-path-insights",
+        inputKind: "cidr-path-facts",
+        input: facts,
+        resolved: true,
+        insights,
+        paths: {
+            reachableZones: facts.reachableZones,
+        },
+    };
+}
+//# sourceMappingURL=cidr-zone-insight-rules.js.map

package/dist/domain/network/cidr-zone-insight-rules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cidr-zone-insight-rules.js","sourceRoot":"","sources":["../../../src/domain/network/cidr-zone-insight-rules.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export type { JsonObject, InsightDiagnostic, InsightDiagnosticLevel, InsightProcessor, InsightProcessorContext, InsightProcessorDefinition, InsightProcessorInput, InsightProcessorResult, InsightPipelineStage, InsightSourceRef, RunInsightPipelineOptions, RunInsightPipelineResult, RunInsightProcessorOptions, } from "./core/types.js";
+export { InsightProcessorRegistry, createInsightProcessorRegistry } from "./core/registry.js";
+export { runInsightProcessor, runInsightPipeline } from "./core/insight-engine.js";
+export { createApiInsightProcessorDefinition, type ApiInsightProcessorConfig, } from "./core/api-processor.js";
+export { builtinInsightProcessors } from "./processors/builtins.js";
+export { cidrTopologyPathResolverDefinition, cidrZonePathInsightProcessorDefinition, } from "./processors/builtins.js";
+export type { CidrPathFacts, TopologyGraph, TopologySegment } from "./domain/network/cidr-topology-analyzer.js";
+export { normalizeCidrInput, parseTopologyGraph, resolveCidrPathFacts, segmentIdForCidr, } from "./domain/network/cidr-topology-analyzer.js";
+export type { ZoneInsight, ZonePathInsightsResult, ZoneRegistryEntry, } from "./domain/network/cidr-zone-insight-rules.js";
+export { generateZonePathInsights, parseZoneRegistry } from "./domain/network/cidr-zone-insight-rules.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,UAAU,EACV,iBAAiB,EACjB,sBAAsB,EACtB,gBAAgB,EAChB,uBAAuB,EACvB,0BAA0B,EAC1B,qBAAqB,EACrB,sBAAsB,EACtB,oBAAoB,EACpB,gBAAgB,EAChB,yBAAyB,EACzB,wBAAwB,EACxB,0BAA0B,GAC3B,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,wBAAwB,EAAE,8BAA8B,EAAE,MAAM,oBAAoB,CAAC;AAC9F,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnF,OAAO,EACL,mCAAmC,EACnC,KAAK,yBAAyB,GAC/B,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EACL,kCAAkC,EAClC,sCAAsC,GACvC,MAAM,0BAA0B,CAAC;AAElC,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,4CAA4C,CAAC;AAChH,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,4CAA4C,CAAC;AAEpD,YAAY,EACV,WAAW,EACX,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,6CAA6C,CAAC;AACrD,OAAO,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,MAAM,6CAA6C,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+export { InsightProcessorRegistry, createInsightProcessorRegistry } from "./core/registry.js";
+export { runInsightProcessor, runInsightPipeline } from "./core/insight-engine.js";
+export { createApiInsightProcessorDefinition, } from "./core/api-processor.js";
+export { builtinInsightProcessors } from "./processors/builtins.js";
+export { cidrTopologyPathResolverDefinition, cidrZonePathInsightProcessorDefinition, } from "./processors/builtins.js";
+export { normalizeCidrInput, parseTopologyGraph, resolveCidrPathFacts, segmentIdForCidr, } from "./domain/network/cidr-topology-analyzer.js";
+export { generateZonePathInsights, parseZoneRegistry } from "./domain/network/cidr-zone-insight-rules.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,wBAAwB,EAAE,8BAA8B,EAAE,MAAM,oBAAoB,CAAC;AAC9F,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnF,OAAO,EACL,mCAAmC,GAEpC,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EACL,kCAAkC,EAClC,sCAAsC,GACvC,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,4CAA4C,CAAC;AAOpD,OAAO,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,MAAM,6CAA6C,CAAC"}

package/dist/processors/builtins.d.ts

@@ -0,0 +1,6 @@
+import type { InsightProcessorDefinition } from "../core/types.js";
+import { cidrTopologyPathResolverDefinition } from "./network/cidr-topology-path-resolver.js";
+import { cidrZonePathInsightProcessorDefinition } from "./network/cidr-zone-path-insight-processor.js";
+export declare const builtinInsightProcessors: InsightProcessorDefinition[];
+export { cidrTopologyPathResolverDefinition, cidrZonePathInsightProcessorDefinition, };
+//# sourceMappingURL=builtins.d.ts.map

package/dist/processors/builtins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtins.d.ts","sourceRoot":"","sources":["../../src/processors/builtins.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,EAAE,kCAAkC,EAAE,MAAM,0CAA0C,CAAC;AAC9F,OAAO,EAAE,sCAAsC,EAAE,MAAM,+CAA+C,CAAC;AAEvG,eAAO,MAAM,wBAAwB,EAAE,0BAA0B,EAGhE,CAAC;AAEF,OAAO,EACL,kCAAkC,EAClC,sCAAsC,GACvC,CAAC"}

package/dist/processors/builtins.js

@@ -0,0 +1,8 @@
+import { cidrTopologyPathResolverDefinition } from "./network/cidr-topology-path-resolver.js";
+import { cidrZonePathInsightProcessorDefinition } from "./network/cidr-zone-path-insight-processor.js";
+export const builtinInsightProcessors = [
+    cidrTopologyPathResolverDefinition,
+    cidrZonePathInsightProcessorDefinition,
+];
+export { cidrTopologyPathResolverDefinition, cidrZonePathInsightProcessorDefinition, };
+//# sourceMappingURL=builtins.js.map

package/dist/processors/builtins.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtins.js","sourceRoot":"","sources":["../../src/processors/builtins.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kCAAkC,EAAE,MAAM,0CAA0C,CAAC;AAC9F,OAAO,EAAE,sCAAsC,EAAE,MAAM,+CAA+C,CAAC;AAEvG,MAAM,CAAC,MAAM,wBAAwB,GAAiC;IACpE,kCAAkC;IAClC,sCAAsC;CACvC,CAAC;AAEF,OAAO,EACL,kCAAkC,EAClC,sCAAsC,GACvC,CAAC"}

package/dist/processors/network/cidr-topology-path-resolver.d.ts

@@ -0,0 +1,3 @@
+import type { InsightProcessorDefinition } from "../../core/types.js";
+export declare const cidrTopologyPathResolverDefinition: InsightProcessorDefinition;
+//# sourceMappingURL=cidr-topology-path-resolver.d.ts.map

package/dist/processors/network/cidr-topology-path-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cidr-topology-path-resolver.d.ts","sourceRoot":"","sources":["../../../src/processors/network/cidr-topology-path-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAiD,MAAM,qBAAqB,CAAC;AA4BrH,eAAO,MAAM,kCAAkC,EAAE,0BA4DhD,CAAC"}

package/dist/processors/network/cidr-topology-path-resolver.js

@@ -0,0 +1,76 @@
+import { parseTopologyGraph, resolveCidrPathFacts, } from "../../domain/network/cidr-topology-analyzer.js";
+const PROCESSOR_ID = "network.cidr-topology-path-resolver";
+const TOPOLOGY_SOURCE_KEY = "topology";
+async function loadTopology(input, loadSource) {
+    const sources = input.sources ?? {};
+    if (sources.topology && typeof sources.topology === "object") {
+        return sources.topology;
+    }
+    if (loadSource) {
+        const ref = {
+            db: typeof sources.topologyDb === "string" ? sources.topologyDb : "memorix-knowledge",
+            collection: typeof sources.topologyCollection === "string" ? sources.topologyCollection : "topology-raw",
+        };
+        return loadSource(TOPOLOGY_SOURCE_KEY, ref);
+    }
+    return null;
+}
+export const cidrTopologyPathResolverDefinition = {
+    processorId: PROCESSOR_ID,
+    inputKind: "cidr",
+    outputKind: "cidr-path-facts",
+    create(context) {
+        return {
+            async process(input) {
+                const cidr = typeof input.input === "string"
+                    ? input.input
+                    : typeof input.input?.cidr === "string"
+                        ? String(input.input.cidr)
+                        : String(input.input ?? "");
+                const topologyRaw = await loadTopology(input, context.loadSource);
+                const graph = parseTopologyGraph(topologyRaw);
+                if (!graph) {
+                    return {
+                        processorId: PROCESSOR_ID,
+                        inputKind: "cidr",
+                        outputKind: "cidr-path-facts",
+                        resolved: false,
+                        data: {
+                            input: cidr,
+                            resolved: false,
+                            matchType: "none",
+                            reachableZones: [],
+                            unclassifiedReachable: [],
+                            reachableSegments: [],
+                        },
+                        diagnostics: [
+                            {
+                                level: "error",
+                                code: "TOPOLOGY_NOT_LOADED",
+                                message: "Topology graph could not be loaded from topology-raw source.",
+                            },
+                        ],
+                    };
+                }
+                const facts = resolveCidrPathFacts(graph, cidr);
+                return {
+                    processorId: PROCESSOR_ID,
+                    inputKind: "cidr",
+                    outputKind: "cidr-path-facts",
+                    resolved: facts.resolved,
+                    data: facts,
+                    diagnostics: facts.resolved
+                        ? []
+                        : [
+                            {
+                                level: "warning",
+                                code: "CIDR_NOT_RESOLVED",
+                                message: `CIDR ${cidr} did not resolve to a topology segment.`,
+                            },
+                        ],
+                };
+            },
+        };
+    },
+};
+//# sourceMappingURL=cidr-topology-path-resolver.js.map

package/dist/processors/network/cidr-topology-path-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cidr-topology-path-resolver.js","sourceRoot":"","sources":["../../../src/processors/network/cidr-topology-path-resolver.ts"],"names":[],"mappings":"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"}

package/dist/processors/network/cidr-zone-path-insight-processor.d.ts

@@ -0,0 +1,3 @@
+import type { InsightProcessorDefinition } from "../../core/types.js";
+export declare const cidrZonePathInsightProcessorDefinition: InsightProcessorDefinition;
+//# sourceMappingURL=cidr-zone-path-insight-processor.d.ts.map

package/dist/processors/network/cidr-zone-path-insight-processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cidr-zone-path-insight-processor.d.ts","sourceRoot":"","sources":["../../../src/processors/network/cidr-zone-path-insight-processor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAiD,MAAM,qBAAqB,CAAC;AA0BrH,eAAO,MAAM,sCAAsC,EAAE,0BAuBpD,CAAC"}

package/dist/processors/network/cidr-zone-path-insight-processor.js

@@ -0,0 +1,40 @@
+import { generateZonePathInsights, parseZoneRegistry, } from "../../domain/network/cidr-zone-insight-rules.js";
+const PROCESSOR_ID = "network.cidr-zone-path-insights";
+const ZONES_SOURCE_KEY = "zones";
+async function loadZones(input, loadSource) {
+    const sources = input.sources ?? {};
+    if (sources.zones)
+        return sources.zones;
+    if (loadSource) {
+        const ref = {
+            db: typeof sources.zonesDb === "string" ? sources.zonesDb : undefined,
+            collection: typeof sources.zonesCollection === "string" ? sources.zonesCollection : "topology-zones-snapshots",
+        };
+        return loadSource(ZONES_SOURCE_KEY, ref);
+    }
+    return [];
+}
+export const cidrZonePathInsightProcessorDefinition = {
+    processorId: PROCESSOR_ID,
+    inputKind: "cidr-path-facts",
+    outputKind: "insights",
+    create(context) {
+        return {
+            async process(input) {
+                const facts = input.input;
+                const zonesRaw = await loadZones(input, context.loadSource);
+                const zones = parseZoneRegistry(zonesRaw);
+                const result = generateZonePathInsights(facts, zones);
+                return {
+                    processorId: PROCESSOR_ID,
+                    inputKind: "cidr-path-facts",
+                    outputKind: "insights",
+                    resolved: result.resolved,
+                    data: result,
+                    diagnostics: [],
+                };
+            },
+        };
+    },
+};
+//# sourceMappingURL=cidr-zone-path-insight-processor.js.map

package/dist/processors/network/cidr-zone-path-insight-processor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cidr-zone-path-insight-processor.js","sourceRoot":"","sources":["../../../src/processors/network/cidr-zone-path-insight-processor.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,wBAAwB,EACxB,iBAAiB,GAClB,MAAM,iDAAiD,CAAC;AAEzD,MAAM,YAAY,GAAG,iCAAiC,CAAC;AACvD,MAAM,gBAAgB,GAAG,OAAO,CAAC;AAEjC,KAAK,UAAU,SAAS,CACtB,KAA4B,EAC5B,UAA+F;IAE/F,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC;IACpC,IAAI,OAAO,CAAC,KAAK;QAAE,OAAO,OAAO,CAAC,KAAK,CAAC;IACxC,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,GAAG,GAAG;YACV,EAAE,EAAE,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;YACrE,UAAU,EAAE,OAAO,OAAO,CAAC,eAAe,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,0BAA0B;SAC/G,CAAC;QACF,OAAO,UAAU,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,CAAC,MAAM,sCAAsC,GAA+B;IAChF,WAAW,EAAE,YAAY;IACzB,SAAS,EAAE,iBAAiB;IAC5B,UAAU,EAAE,UAAU;IACtB,MAAM,CAAC,OAAO;QACZ,OAAO;YACL,KAAK,CAAC,OAAO,CAAC,KAA4B;gBACxC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAsB,CAAC;gBAC3C,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;gBAC5D,MAAM,KAAK,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;gBAC1C,MAAM,MAAM,GAAG,wBAAwB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;gBAEtD,OAAO;oBACL,WAAW,EAAE,YAAY;oBACzB,SAAS,EAAE,iBAAiB;oBAC5B,UAAU,EAAE,UAAU;oBACtB,QAAQ,EAAE,MAAM,CAAC,QAAQ;oBACzB,IAAI,EAAE,MAAM;oBACZ,WAAW,EAAE,EAAE;iBAChB,CAAC;YACJ,CAAC;SACF,CAAC;IACJ,CAAC;CACF,CAAC"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@x12i/memorix-insights",
+  "version": "1.1.0",
+  "description": "Pluggable insight processors for Memorix — staged fact resolution and judgment generation",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "prebuild": "rm -rf dist",
+    "build": "tsc -p tsconfig.build.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepack": "npm run build"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@x12i/memorix-resolvers": "^1.2.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.14.0",
+    "typescript": "^5.6.0",
+    "vitest": "^2.1.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+ssh://git@github.com/x12i/memorix-mono-repo.git",
+    "directory": "memorix-insights"
+  },
+  "keywords": [
+    "memorix",
+    "insights",
+    "enrichment"
+  ],
+  "license": "exellix-license"
+}