@aristanetworks/eos-mcp-server 0.6.1-beta

package/dist/eapi/transport.js

@@ -0,0 +1,143 @@
+import fs from "node:fs/promises";
+import https from "node:https";
+import { AppError } from "../core/errors.js";
+export class FetchEapiTransport {
+    fetchFn;
+    constructor(fetchFn) {
+        this.fetchFn = fetchFn;
+    }
+    async postJson(connection, requestJson, signal) {
+        return this.fetchFn(connection.baseUrl, {
+            method: "POST",
+            headers: {
+                Authorization: buildBasicAuthHeader(connection),
+                "Content-Type": "application/json"
+            },
+            body: requestJson,
+            signal
+        });
+    }
+}
+export class NodeHttpsEapiTransport {
+    caCache = new Map();
+    async postJson(connection, requestJson, signal) {
+        const url = new URL(connection.baseUrl);
+        const ca = connection.caFile ? await this.readCaFile(connection.caFile) : undefined;
+        return new Promise((resolve, reject) => {
+            let settled = false;
+            let abortListenerAttached = false;
+            const cleanupAbortListener = () => {
+                if (abortListenerAttached) {
+                    signal.removeEventListener("abort", abortRequest);
+                    abortListenerAttached = false;
+                }
+            };
+            const rejectOnce = (error) => {
+                if (settled) {
+                    return;
+                }
+                settled = true;
+                cleanupAbortListener();
+                reject(error);
+            };
+            const resolveOnce = (response) => {
+                if (settled) {
+                    return;
+                }
+                settled = true;
+                cleanupAbortListener();
+                resolve(response);
+            };
+            const abortRequest = () => {
+                request.destroy(buildAbortError(signal.reason, connection));
+            };
+            const request = https.request(url, {
+                method: "POST",
+                rejectUnauthorized: connection.validateCerts,
+                ...(ca !== undefined ? { ca } : {}),
+                headers: {
+                    Authorization: buildBasicAuthHeader(connection),
+                    "Content-Type": "application/json",
+                    "Content-Length": Buffer.byteLength(requestJson)
+                }
+            }, (response) => {
+                const chunks = [];
+                let responseSizeBytes = 0;
+                response.on("data", (chunk) => {
+                    const buffer = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+                    responseSizeBytes += buffer.length;
+                    if (connection.maxResponseSizeBytes !== undefined &&
+                        responseSizeBytes > connection.maxResponseSizeBytes) {
+                        const error = new AppError("response_size_exceeded", `EOS eAPI HTTP response size exceeded maxResponseSizeBytes ${connection.maxResponseSizeBytes}`, {
+                            responseSizeBytes,
+                            maxResponseSizeBytes: connection.maxResponseSizeBytes,
+                            inventoryHostname: connection.inventoryHostname
+                        });
+                        rejectOnce(error);
+                        request.destroy(error);
+                        return;
+                    }
+                    chunks.push(buffer);
+                });
+                response.on("end", () => {
+                    if (settled) {
+                        return;
+                    }
+                    const text = Buffer.concat(chunks).toString("utf8");
+                    resolveOnce({
+                        ok: response.statusCode !== undefined && response.statusCode >= 200 && response.statusCode < 300,
+                        status: response.statusCode ?? 0,
+                        json: async () => JSON.parse(text),
+                        text: async () => text
+                    });
+                });
+            });
+            request.on("error", (error) => {
+                rejectOnce(error);
+            });
+            if (signal.aborted) {
+                abortRequest();
+                return;
+            }
+            else {
+                signal.addEventListener("abort", abortRequest, { once: true });
+                abortListenerAttached = true;
+            }
+            request.write(requestJson);
+            request.end();
+        });
+    }
+    async readCaFile(caFile) {
+        const existing = this.caCache.get(caFile);
+        if (existing) {
+            return existing;
+        }
+        const pending = fs.readFile(caFile, "utf8");
+        this.caCache.set(caFile, pending);
+        try {
+            return await pending;
+        }
+        catch (error) {
+            this.caCache.delete(caFile);
+            throw error;
+        }
+    }
+}
+function buildBasicAuthHeader(connection) {
+    return `Basic ${Buffer.from(`${connection.username}:${connection.password}`).toString("base64")}`;
+}
+function buildAbortError(reason, connection) {
+    if (reason instanceof AppError) {
+        return reason;
+    }
+    if (reason instanceof DOMException && reason.name === "TimeoutError") {
+        return new AppError("eapi_request_timeout", `EOS eAPI request for host ${connection.inventoryHostname} exceeded timeoutMs ${connection.timeoutMs}`, {
+            inventoryHostname: connection.inventoryHostname,
+            timeoutMs: connection.timeoutMs
+        });
+    }
+    return new AppError("eapi_request_aborted", `EOS eAPI request for host ${connection.inventoryHostname} was aborted`, {
+        inventoryHostname: connection.inventoryHostname
+    });
+}
+//# sourceMappingURL=transport.js.map

package/dist/eapi/transport.js.map

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

package/dist/eapi/types.d.ts

@@ -0,0 +1,49 @@
+export type EapiOutputFormat = "json" | "text";
+export type EapiOutputMode = EapiOutputFormat | "auto";
+export type EapiVersion = 1 | "latest";
+export interface EapiConnectionConfig {
+    inventoryHostname: string;
+    endpointHost: string;
+    baseUrl: string;
+    username: string;
+    password: string;
+    validateCerts: boolean;
+    caFile?: string;
+    timeoutMs: number;
+    eapiVersion: EapiVersion;
+    maxResponseSizeBytes?: number;
+}
+export interface EapiCommandOptions {
+    enable?: boolean;
+    signal?: AbortSignal;
+}
+export interface RunShowCommandOptions extends EapiCommandOptions {
+    includeRawEntries?: boolean;
+}
+export interface EosCommandResult {
+    command: string;
+    output_format: EapiOutputFormat;
+    output: unknown;
+    raw_entry?: unknown;
+}
+export interface EosCommandRunner {
+    runShowCommands(connection: EapiConnectionConfig, commands: string[], outputMode: EapiOutputMode, options?: RunShowCommandOptions): Promise<EosCommandResult[]>;
+}
+export declare function hasEapiResultArray(payload: unknown): payload is {
+    result: unknown[];
+};
+export interface EapiRunCmdsResponse {
+    result: unknown[];
+    raw: unknown;
+}
+export declare function parseEapiRunCmdsResponse(payload: unknown, expectedResultCount?: number): EapiRunCmdsResponse;
+export interface EapiJsonRpcRequest {
+    jsonrpc: "2.0";
+    method: "runCmds";
+    params: {
+        version: EapiVersion;
+        cmds: string[];
+        format: EapiOutputFormat;
+    };
+    id: string;
+}

package/dist/eapi/types.js

@@ -0,0 +1,15 @@
+import { AppError } from "../core/errors.js";
+import { isObject } from "../utils/value.js";
+export function hasEapiResultArray(payload) {
+    return isObject(payload) && "result" in payload && Array.isArray(payload.result);
+}
+export function parseEapiRunCmdsResponse(payload, expectedResultCount) {
+    if (!hasEapiResultArray(payload)) {
+        throw new AppError("eapi_payload_invalid", "Unexpected eAPI payload structure: missing result array");
+    }
+    if (expectedResultCount !== undefined && payload.result.length !== expectedResultCount) {
+        throw new AppError("eapi_payload_invalid", `Unexpected eAPI payload structure: expected ${expectedResultCount} result entries but received ${payload.result.length}`);
+    }
+    return { result: payload.result, raw: payload };
+}
+//# sourceMappingURL=types.js.map

package/dist/eapi/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/eapi/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AA4C7C,MAAM,UAAU,kBAAkB,CAAC,OAAgB;IACjD,OAAO,QAAQ,CAAC,OAAO,CAAC,IAAI,QAAQ,IAAI,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;AACnF,CAAC;AAOD,MAAM,UAAU,wBAAwB,CAAC,OAAgB,EAAE,mBAA4B;IACrF,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,QAAQ,CAAC,sBAAsB,EAAE,yDAAyD,CAAC,CAAC;IACxG,CAAC;IAED,IAAI,mBAAmB,KAAK,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,KAAK,mBAAmB,EAAE,CAAC;QACvF,MAAM,IAAI,QAAQ,CAChB,sBAAsB,EACtB,+CAA+C,mBAAmB,gCAAgC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,CAC1H,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC;AAClD,CAAC"}

package/dist/facts/getFacts.d.ts

@@ -0,0 +1,33 @@
+import type { ResolvedServerConfig } from "../config/schema.js";
+import type { EosCommandResult } from "../eapi/types.js";
+import type { EosDeviceReader } from "../connection/eosDeviceReader.js";
+import type { InventoryModel } from "../inventory/types.js";
+import { type DeviceResultSummary } from "../operations/readExecution.js";
+export interface GetFactsOptions {
+    target: string;
+    include_raw: boolean;
+}
+export interface GetFactsResult {
+    target: string;
+    target_type: "host" | "group";
+    resolved_devices: string[];
+    summary: DeviceResultSummary;
+    results: Array<{
+        inventory_hostname: string;
+        resolved_endpoint: string;
+        status: "success" | "failed";
+        facts?: {
+            inventory_hostname: string;
+            device_hostname?: string;
+            model?: string;
+            serial_number?: string;
+            eos_version?: string;
+            uptime?: number;
+            system_mac?: string;
+        };
+        command_results?: EosCommandResult[];
+        error_code?: string;
+        message?: string;
+    }>;
+}
+export declare function getFacts(model: InventoryModel, config: ResolvedServerConfig, options: GetFactsOptions, reader: EosDeviceReader): Promise<GetFactsResult>;

package/dist/facts/getFacts.js

@@ -0,0 +1,50 @@
+import { AppError } from "../core/errors.js";
+import { buildReadDeviceFailure, buildReadDeviceSuccess, buildReadOperationResultEnvelope, executeReadOperation } from "../operations/readExecution.js";
+import { readNumber, readString } from "../utils/value.js";
+export async function getFacts(model, config, options, reader) {
+    const operation = await executeReadOperation(model, config, {
+        target: options.target,
+        operationName: "eos_get_facts",
+        run: async (host, signal) => {
+            const commandResults = await reader.runShowCommands(host, ["show version"], "json", {
+                signal,
+                includeRawEntries: options.include_raw
+            });
+            const versionPayload = extractPrimaryPayload(commandResults);
+            const factDeviceHostname = readString(versionPayload.hostname);
+            const factModel = readString(versionPayload.modelName);
+            const factSerialNumber = readString(versionPayload.serialNumber);
+            const factEosVersion = readString(versionPayload.version);
+            const factUptime = readNumber(versionPayload.uptime);
+            const factSystemMac = readString(versionPayload.systemMacAddress);
+            return buildReadDeviceSuccess(host, {
+                facts: {
+                    inventory_hostname: host.inventoryHostname,
+                    ...(factDeviceHostname !== undefined ? { device_hostname: factDeviceHostname } : {}),
+                    ...(factModel !== undefined ? { model: factModel } : {}),
+                    ...(factSerialNumber !== undefined ? { serial_number: factSerialNumber } : {}),
+                    ...(factEosVersion !== undefined ? { eos_version: factEosVersion } : {}),
+                    ...(factUptime !== undefined ? { uptime: factUptime } : {}),
+                    ...(factSystemMac !== undefined ? { system_mac: factSystemMac } : {})
+                },
+                ...(options.include_raw ? { command_results: commandResults } : {})
+            });
+        },
+        onError: (host, error) => buildReadDeviceFailure(host, "facts_collection_failed", error)
+    });
+    return buildReadOperationResultEnvelope(options.target, operation, {
+        responseSizeLimit: {
+            config,
+            operationName: "eos_get_facts",
+            narrowingGuidance: "Reduce the number of target devices or set include_raw to false to omit raw per-command eAPI entries."
+        }
+    });
+}
+function extractPrimaryPayload(commandResults) {
+    const first = commandResults[0]?.output;
+    if (typeof first === "object" && first !== null) {
+        return first;
+    }
+    throw new AppError("facts_payload_invalid", "Unexpected show version payload structure");
+}
+//# sourceMappingURL=getFacts.js.map

package/dist/facts/getFacts.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,66 @@
+#!/usr/bin/env node
+import { randomUUID } from "node:crypto";
+import { AppError, toErrorMessage } from "./core/errors.js";
+import { parseCliArgs, printHelp, printVersion } from "./cli.js";
+import { runProbe } from "./commands/probe.js";
+import { runValidateInventory } from "./commands/validateInventory.js";
+import { printServerInfo } from "./commands/printServerInfo.js";
+import { loadServerConfig } from "./config/loadConfig.js";
+import { validateStartupConnections } from "./connection/validateStartupConnections.js";
+import { loadInventoryModel } from "./inventory/loadInventory.js";
+import { startMcpServer } from "./mcp/createServer.js";
+async function main() {
+    const cli = parseCliArgs(process.argv.slice(2));
+    if (cli.version) {
+        printVersion();
+        return;
+    }
+    if (cli.help) {
+        printHelp(cli);
+        return;
+    }
+    const config = await loadServerConfig(cli);
+    switch (cli.command) {
+        case "validate-inventory": {
+            const exitCode = await runValidateInventory(config, {
+                asJson: cli.json ?? false,
+                inventoryOnly: cli.inventoryOnly ?? false
+            });
+            process.exitCode = exitCode;
+            return;
+        }
+        case "print-server-info": {
+            const inventoryModel = config.inventoryPath ? await loadInventoryModel(config.inventoryPath) : undefined;
+            const runtimeContext = {
+                instanceId: randomUUID(),
+                startedAt: new Date().toISOString(),
+                config,
+                ...(inventoryModel !== undefined ? { inventorySummary: inventoryModel.summary } : {})
+            };
+            printServerInfo(runtimeContext, cli.json ?? false);
+            return;
+        }
+        case "probe": {
+            if (!cli.target) {
+                throw new AppError("cli_missing_target", "probe requires a target via --target");
+            }
+            const exitCode = await runProbe(config, cli.target, cli.json ?? false);
+            process.exitCode = exitCode;
+            return;
+        }
+        case "serve": {
+            if (!config.inventoryPath) {
+                throw new AppError("cli_missing_inventory", "serve requires an inventory path via --inventory or config file");
+            }
+            const inventoryModel = await loadInventoryModel(config.inventoryPath);
+            validateStartupConnections(config, inventoryModel);
+            await startMcpServer(config, inventoryModel);
+            return;
+        }
+    }
+}
+main().catch((error) => {
+    console.error(toErrorMessage(error));
+    process.exitCode = 1;
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/inventory/buildModel.d.ts

@@ -0,0 +1,3 @@
+import type { InventoryModel } from "./types.js";
+import type { NormalizedInventory, ValidationContext } from "./internalTypes.js";
+export declare function buildInventoryModel(inventory: NormalizedInventory, inventoryPath: string, context: ValidationContext): InventoryModel | null;

package/dist/inventory/buildModel.js

@@ -0,0 +1,79 @@
+import path from "node:path";
+import { evaluateHostAccess, evaluateHostEligibility } from "./policy.js";
+import { resolveEffectiveHostVars } from "./effectiveVars.js";
+import { buildDirectMemberships, buildGroupDepths, buildParentGroupMap, collectLineageGroups, resolveGroupHosts } from "./graph.js";
+export function buildInventoryModel(inventory, inventoryPath, context) {
+    const parentGroups = buildParentGroupMap(inventory);
+    const groupDepths = buildGroupDepths(inventory, parentGroups);
+    const directMemberships = buildDirectMemberships(inventory);
+    const hostModels = new Map();
+    for (const [hostName, hostVars] of inventory.hosts.entries()) {
+        const lineageGroups = collectLineageGroups(hostName, parentGroups, directMemberships);
+        const effectiveVars = resolveEffectiveHostVars(hostName, hostVars, inventory, lineageGroups, groupDepths, context);
+        const eligibility = evaluateHostEligibility(hostName, effectiveVars);
+        context.errors.push(...eligibility.errors);
+        const access = evaluateHostAccess(eligibility.eligible, effectiveVars);
+        const resolvedEndpoint = typeof effectiveVars.ansible_host === "string" ? effectiveVars.ansible_host : hostName;
+        hostModels.set(hostName, {
+            inventoryHostname: hostName,
+            resolvedEndpoint,
+            effectiveVars,
+            eligible: eligibility.eligible,
+            readAllowed: access.readAllowed,
+            ineligibilityReasons: eligibility.ineligibilityReasons,
+            groupMemberships: [...lineageGroups].sort()
+        });
+    }
+    if (context.errors.length > 0) {
+        return null;
+    }
+    const groupResolutionMemo = new Map();
+    const groupModels = new Map();
+    for (const [groupName, group] of inventory.groups.entries()) {
+        const resolvedHosts = resolveGroupHosts(groupName, inventory, groupResolutionMemo);
+        const eligibleHostCount = resolvedHosts.filter((hostName) => hostModels.get(hostName)?.eligible === true).length;
+        const ineligibleHostCount = resolvedHosts.length - eligibleHostCount;
+        groupModels.set(groupName, {
+            name: groupName,
+            hosts: [...group.hosts].sort(),
+            children: [...group.children].sort(),
+            resolvedHosts,
+            eligibleHostCount,
+            ineligibleHostCount,
+            actionable: eligibleHostCount > 0
+        });
+    }
+    const allResolvedHosts = [...inventory.hosts.keys()].sort();
+    const allEligibleHostCount = allResolvedHosts.filter((hostName) => hostModels.get(hostName)?.eligible === true).length;
+    groupModels.set("all", {
+        name: "all",
+        hosts: [],
+        children: [...inventory.groups.keys()].sort(),
+        resolvedHosts: allResolvedHosts,
+        eligibleHostCount: allEligibleHostCount,
+        ineligibleHostCount: allResolvedHosts.length - allEligibleHostCount,
+        actionable: allEligibleHostCount > 0
+    });
+    const hosts = [...hostModels.values()].sort((left, right) => left.inventoryHostname.localeCompare(right.inventoryHostname));
+    const groups = [...groupModels.values()].sort((left, right) => left.name.localeCompare(right.name));
+    const summary = {
+        path: inventoryPath,
+        basename: path.basename(inventoryPath),
+        schemaKind: inventory.schemaKind,
+        totalHostCount: hosts.length,
+        totalGroupCount: groups.length,
+        eosEligibleHostCount: hosts.filter((host) => host.eligible).length,
+        readAllowedHostCount: hosts.filter((host) => host.readAllowed).length
+    };
+    return {
+        path: inventoryPath,
+        basename: path.basename(inventoryPath),
+        schemaKind: inventory.schemaKind,
+        summary,
+        hosts,
+        groups,
+        hostMap: new Map(hosts.map((host) => [host.inventoryHostname, host])),
+        groupMap: new Map(groups.map((group) => [group.name, group]))
+    };
+}
+//# sourceMappingURL=buildModel.js.map

package/dist/inventory/buildModel.js.map

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

package/dist/inventory/effectiveVars.d.ts

@@ -0,0 +1,2 @@
+import type { InventoryVars, NormalizedInventory, ValidationContext } from "./internalTypes.js";
+export declare function resolveEffectiveHostVars(hostName: string, hostVars: InventoryVars, inventory: NormalizedInventory, lineageGroups: Set<string>, groupDepths: Map<string, number>, context: ValidationContext): InventoryVars;

package/dist/inventory/effectiveVars.js

@@ -0,0 +1,52 @@
+import { stableValueKey } from "./internalUtils.js";
+export function resolveEffectiveHostVars(hostName, hostVars, inventory, lineageGroups, groupDepths, context) {
+    const effectiveVars = { ...inventory.globalVars };
+    const groupedValues = new Map();
+    for (const groupName of lineageGroups) {
+        const group = inventory.groups.get(groupName);
+        if (!group) {
+            continue;
+        }
+        const depth = groupDepths.get(groupName) ?? 1;
+        for (const [key, value] of Object.entries(group.vars)) {
+            const byDepth = groupedValues.get(key) ?? new Map();
+            const valuesAtDepth = byDepth.get(depth) ?? new Set();
+            valuesAtDepth.add(stableValueKey(value));
+            byDepth.set(depth, valuesAtDepth);
+            groupedValues.set(key, byDepth);
+        }
+    }
+    for (const [key, byDepth] of groupedValues.entries()) {
+        for (const [depth, valuesAtDepth] of byDepth.entries()) {
+            if (valuesAtDepth.size > 1) {
+                context.errors.push({
+                    code: "inventory_same_level_conflict",
+                    message: `Host ${hostName} inherits conflicting values for ${key} at group depth ${depth}`,
+                    path: hostName
+                });
+            }
+        }
+        const winningDepth = Math.max(...byDepth.keys());
+        const groupValue = findGroupValueAtDepth(key, winningDepth, lineageGroups, inventory, groupDepths);
+        if (groupValue !== undefined) {
+            effectiveVars[key] = groupValue;
+        }
+    }
+    for (const [key, value] of Object.entries(hostVars)) {
+        effectiveVars[key] = value;
+    }
+    return effectiveVars;
+}
+function findGroupValueAtDepth(key, depth, lineageGroups, inventory, groupDepths) {
+    for (const groupName of lineageGroups) {
+        if ((groupDepths.get(groupName) ?? 1) !== depth) {
+            continue;
+        }
+        const group = inventory.groups.get(groupName);
+        if (group && key in group.vars) {
+            return group.vars[key];
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=effectiveVars.js.map

package/dist/inventory/effectiveVars.js.map

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

package/dist/inventory/graph.d.ts

@@ -0,0 +1,6 @@
+import type { NormalizedInventory } from "./internalTypes.js";
+export declare function resolveGroupHosts(groupName: string, inventory: NormalizedInventory, memo: Map<string, string[]>): string[];
+export declare function collectLineageGroups(hostName: string, parentGroups: Map<string, Set<string>>, directMemberships: Map<string, Set<string>>): Set<string>;
+export declare function buildParentGroupMap(inventory: NormalizedInventory): Map<string, Set<string>>;
+export declare function buildGroupDepths(inventory: NormalizedInventory, parentGroups: Map<string, Set<string>>): Map<string, number>;
+export declare function buildDirectMemberships(inventory: NormalizedInventory): Map<string, Set<string>>;

package/dist/inventory/graph.js

@@ -0,0 +1,81 @@
+export function resolveGroupHosts(groupName, inventory, memo) {
+    const existing = memo.get(groupName);
+    if (existing) {
+        return existing;
+    }
+    const group = inventory.groups.get(groupName);
+    if (!group) {
+        return [];
+    }
+    const hostNames = new Set(group.hosts);
+    for (const child of group.children) {
+        for (const childHost of resolveGroupHosts(child, inventory, memo)) {
+            hostNames.add(childHost);
+        }
+    }
+    const resolved = [...hostNames].sort();
+    memo.set(groupName, resolved);
+    return resolved;
+}
+export function collectLineageGroups(hostName, parentGroups, directMemberships) {
+    const result = new Set();
+    const stack = [...(directMemberships.get(hostName) ?? [])];
+    while (stack.length > 0) {
+        const groupName = stack.pop();
+        if (!groupName || result.has(groupName)) {
+            continue;
+        }
+        result.add(groupName);
+        for (const parent of parentGroups.get(groupName) ?? []) {
+            stack.push(parent);
+        }
+    }
+    return result;
+}
+export function buildParentGroupMap(inventory) {
+    const parentGroups = new Map();
+    for (const groupName of inventory.groups.keys()) {
+        parentGroups.set(groupName, new Set());
+    }
+    for (const [groupName, group] of inventory.groups.entries()) {
+        for (const child of group.children) {
+            const parents = parentGroups.get(child) ?? new Set();
+            parents.add(groupName);
+            parentGroups.set(child, parents);
+        }
+    }
+    return parentGroups;
+}
+export function buildGroupDepths(inventory, parentGroups) {
+    const memo = new Map();
+    const getDepth = (groupName) => {
+        const cached = memo.get(groupName);
+        if (cached !== undefined) {
+            return cached;
+        }
+        const parents = parentGroups.get(groupName) ?? new Set();
+        if (parents.size === 0) {
+            memo.set(groupName, 1);
+            return 1;
+        }
+        const depth = Math.max(...[...parents].map(getDepth)) + 1;
+        memo.set(groupName, depth);
+        return depth;
+    };
+    for (const groupName of inventory.groups.keys()) {
+        getDepth(groupName);
+    }
+    return memo;
+}
+export function buildDirectMemberships(inventory) {
+    const memberships = new Map();
+    for (const [groupName, group] of inventory.groups.entries()) {
+        for (const hostName of group.hosts) {
+            const hostMemberships = memberships.get(hostName) ?? new Set();
+            hostMemberships.add(groupName);
+            memberships.set(hostName, hostMemberships);
+        }
+    }
+    return memberships;
+}
+//# sourceMappingURL=graph.js.map

package/dist/inventory/graph.js.map

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