@aristanetworks/eos-mcp-server 0.6.1-beta

package/dist/inventory/internalTypes.d.ts

@@ -0,0 +1,17 @@
+import type { InventorySchemaKind, InventoryValidationError } from "./types.js";
+export type InventoryVars = Record<string, unknown>;
+export interface NormalizedInventory {
+    schemaKind: InventorySchemaKind;
+    globalVars: InventoryVars;
+    hosts: Map<string, InventoryVars>;
+    groups: Map<string, NormalizedGroup>;
+}
+export interface NormalizedGroup {
+    name: string;
+    vars: InventoryVars;
+    hosts: string[];
+    children: string[];
+}
+export interface ValidationContext {
+    errors: InventoryValidationError[];
+}

package/dist/inventory/internalTypes.js

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

package/dist/inventory/internalTypes.js.map

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

package/dist/inventory/internalUtils.d.ts

@@ -0,0 +1,10 @@
+import { isObject } from "../utils/value.js";
+import type { InventoryVars, ValidationContext } from "./internalTypes.js";
+export declare const SIMPLIFIED_ROOT_KEYS: Set<string>;
+export declare const SIMPLIFIED_GROUP_KEYS: Set<string>;
+export declare const CANONICAL_GROUP_KEYS: Set<string>;
+export declare function readVarsObject(value: unknown, context: ValidationContext, pathLabel: string): InventoryVars;
+export declare function readStringList(value: unknown, context: ValidationContext, pathLabel: string): string[];
+export declare function validateSafeName(name: string, kind: "host" | "group", context: ValidationContext, pathLabel: string): void;
+export { isObject };
+export declare function stableValueKey(value: unknown): string;

package/dist/inventory/internalUtils.js

@@ -0,0 +1,68 @@
+import { isObject } from "../utils/value.js";
+const SAFE_NAME_PATTERN = /^[A-Za-z0-9_.-]+$/;
+export const SIMPLIFIED_ROOT_KEYS = new Set(["version", "vars", "hosts", "groups"]);
+export const SIMPLIFIED_GROUP_KEYS = new Set(["vars", "hosts", "children"]);
+export const CANONICAL_GROUP_KEYS = new Set(["vars", "hosts", "children"]);
+export function readVarsObject(value, context, pathLabel) {
+    if (value === undefined) {
+        return {};
+    }
+    if (!isObject(value)) {
+        context.errors.push({
+            code: "inventory_vars_invalid",
+            message: `${pathLabel} must be a mapping/object`,
+            path: pathLabel
+        });
+        return {};
+    }
+    return { ...value };
+}
+export function readStringList(value, context, pathLabel) {
+    if (value === undefined) {
+        return [];
+    }
+    if (!Array.isArray(value)) {
+        context.errors.push({
+            code: "inventory_list_invalid",
+            message: `${pathLabel} must be a list/array of strings`,
+            path: pathLabel
+        });
+        return [];
+    }
+    const result = [];
+    for (const entry of value) {
+        if (typeof entry !== "string") {
+            context.errors.push({
+                code: "inventory_list_entry_invalid",
+                message: `${pathLabel} entries must be strings`,
+                path: pathLabel
+            });
+            continue;
+        }
+        result.push(entry);
+    }
+    return result;
+}
+export function validateSafeName(name, kind, context, pathLabel) {
+    if (!SAFE_NAME_PATTERN.test(name)) {
+        context.errors.push({
+            code: "inventory_name_invalid",
+            message: `Invalid ${kind} name ${JSON.stringify(name)}; expected pattern ${SAFE_NAME_PATTERN.source}`,
+            path: pathLabel
+        });
+    }
+}
+export { isObject };
+export function stableValueKey(value) {
+    if (Array.isArray(value)) {
+        return `[${value.map(stableValueKey).join(",")}]`;
+    }
+    if (isObject(value)) {
+        return `{${Object.keys(value)
+            .sort()
+            .map((key) => `${JSON.stringify(key)}:${stableValueKey(value[key])}`)
+            .join(",")}}`;
+    }
+    return JSON.stringify(value);
+}
+//# sourceMappingURL=internalUtils.js.map

package/dist/inventory/internalUtils.js.map

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

package/dist/inventory/listInventoryView.d.ts

@@ -0,0 +1,23 @@
+import type { InventoryModel } from "./types.js";
+export interface ListInventoryView {
+    hosts: Array<{
+        inventory_hostname: string;
+        resolved_endpoint: string;
+        eligible: boolean;
+        read_allowed: boolean;
+        ineligibility_reasons: string[];
+        group_memberships: string[];
+    }>;
+    groups: Array<{
+        name: string;
+        actionable: boolean;
+        eligible_host_count: number;
+        ineligible_host_count: number;
+        resolved_hosts: string[];
+        children: string[];
+    }>;
+}
+export interface BuildListInventoryViewOptions {
+    includeIneligible: boolean;
+}
+export declare function buildListInventoryView(model: InventoryModel, options: BuildListInventoryViewOptions): ListInventoryView;

package/dist/inventory/listInventoryView.js

@@ -0,0 +1,22 @@
+export function buildListInventoryView(model, options) {
+    const hosts = model.hosts
+        .filter((host) => options.includeIneligible || host.eligible)
+        .map((host) => ({
+        inventory_hostname: host.inventoryHostname,
+        resolved_endpoint: host.resolvedEndpoint,
+        eligible: host.eligible,
+        read_allowed: host.readAllowed,
+        ineligibility_reasons: [...host.ineligibilityReasons],
+        group_memberships: [...host.groupMemberships]
+    }));
+    const groups = model.groups.map((group) => ({
+        name: group.name,
+        actionable: group.actionable,
+        eligible_host_count: group.eligibleHostCount,
+        ineligible_host_count: group.ineligibleHostCount,
+        resolved_hosts: [...group.resolvedHosts],
+        children: [...group.children]
+    }));
+    return { hosts, groups };
+}
+//# sourceMappingURL=listInventoryView.js.map

package/dist/inventory/listInventoryView.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"listInventoryView.js","sourceRoot":"","sources":["../../src/inventory/listInventoryView.ts"],"names":[],"mappings":"AAyBA,MAAM,UAAU,sBAAsB,CACpC,KAAqB,EACrB,OAAsC;IAEtC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK;SACtB,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,iBAAiB,IAAI,IAAI,CAAC,QAAQ,CAAC;SAC5D,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACd,kBAAkB,EAAE,IAAI,CAAC,iBAAiB;QAC1C,iBAAiB,EAAE,IAAI,CAAC,gBAAgB;QACxC,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,YAAY,EAAE,IAAI,CAAC,WAAW;QAC9B,qBAAqB,EAAE,CAAC,GAAG,IAAI,CAAC,oBAAoB,CAAC;QACrD,iBAAiB,EAAE,CAAC,GAAG,IAAI,CAAC,gBAAgB,CAAC;KAC9C,CAAC,CAAC,CAAC;IAEN,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC1C,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,mBAAmB,EAAE,KAAK,CAAC,iBAAiB;QAC5C,qBAAqB,EAAE,KAAK,CAAC,mBAAmB;QAChD,cAAc,EAAE,CAAC,GAAG,KAAK,CAAC,aAAa,CAAC;QACxC,QAAQ,EAAE,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC;KAC9B,CAAC,CAAC,CAAC;IAEJ,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AAC3B,CAAC"}

package/dist/inventory/loadInventory.d.ts

@@ -0,0 +1,4 @@
+import type { InventoryModel, InventorySummary, InventoryValidationResult } from "./types.js";
+export declare function loadInventorySummary(inventoryPath: string): Promise<InventorySummary>;
+export declare function loadInventoryModel(inventoryPath: string): Promise<InventoryModel>;
+export declare function validateInventory(inventoryPath: string): Promise<InventoryValidationResult>;

package/dist/inventory/loadInventory.js

@@ -0,0 +1,87 @@
+import { AppError } from "../core/errors.js";
+import { buildInventoryModel } from "./buildModel.js";
+import { detectSchemaKind, normalizeInventory } from "./normalize.js";
+import { parseInventoryDocument } from "./parse.js";
+import { validateNormalizedInventory } from "./validateNormalized.js";
+import { validateKnownInventoryVarTypes } from "./varValidation.js";
+function buildParsedInventoryResult(result) {
+    return {
+        ...result,
+        notes: result.notes ?? []
+    };
+}
+function assertParsedInventorySuccess(result, value) {
+    if (result.errors.length > 0 || value === undefined) {
+        throw new AppError("inventory_validation_failed", result.errors.map((error) => error.message).join("; "));
+    }
+    return value;
+}
+export async function loadInventorySummary(inventoryPath) {
+    const result = await parseAndValidateInventory(inventoryPath);
+    return assertParsedInventorySuccess(result, result.summary);
+}
+export async function loadInventoryModel(inventoryPath) {
+    const result = await parseAndValidateInventory(inventoryPath);
+    return assertParsedInventorySuccess(result, result.model);
+}
+export async function validateInventory(inventoryPath) {
+    const result = await parseAndValidateInventory(inventoryPath);
+    return {
+        ok: result.errors.length === 0,
+        ...(result.schemaKind !== undefined ? { schemaKind: result.schemaKind } : {}),
+        ...(result.summary !== undefined ? { summary: result.summary } : {}),
+        errors: result.errors,
+        notes: result.notes
+    };
+}
+async function parseAndValidateInventory(inventoryPath) {
+    const parsedDocument = await parseInventoryDocument(inventoryPath);
+    if (parsedDocument.errors.length > 0 || parsedDocument.rootValue === undefined) {
+        return buildParsedInventoryResult({
+            errors: parsedDocument.errors
+        });
+    }
+    try {
+        const schemaKind = detectSchemaKind(parsedDocument.rootValue);
+        const context = { errors: [] };
+        const normalized = normalizeInventory(parsedDocument.rootValue, schemaKind, context);
+        if (!normalized) {
+            return buildParsedInventoryResult({
+                schemaKind,
+                errors: context.errors
+            });
+        }
+        validateNormalizedInventory(normalized, context);
+        validateKnownInventoryVarTypes(normalized, context);
+        if (context.errors.length > 0) {
+            return buildParsedInventoryResult({
+                schemaKind,
+                errors: context.errors
+            });
+        }
+        const model = buildInventoryModel(normalized, inventoryPath, context);
+        if (!model || context.errors.length > 0) {
+            return buildParsedInventoryResult({
+                schemaKind,
+                errors: context.errors
+            });
+        }
+        return buildParsedInventoryResult({
+            schemaKind,
+            summary: model.summary,
+            model,
+            errors: context.errors
+        });
+    }
+    catch (error) {
+        return buildParsedInventoryResult({
+            errors: [
+                {
+                    code: "inventory_validation_failed",
+                    message: error instanceof Error ? error.message : String(error)
+                }
+            ]
+        });
+    }
+}
+//# sourceMappingURL=loadInventory.js.map

package/dist/inventory/loadInventory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadInventory.js","sourceRoot":"","sources":["../../src/inventory/loadInventory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAEtD,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACtE,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAQpD,OAAO,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,EAAE,8BAA8B,EAAE,MAAM,oBAAoB,CAAC;AAUpE,SAAS,0BAA0B,CAAC,MAAmE;IACrG,OAAO;QACL,GAAG,MAAM;QACT,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,EAAE;KAC1B,CAAC;AACJ,CAAC;AAED,SAAS,4BAA4B,CACnC,MAA6B,EAC7B,KAAyB;IAEzB,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACpD,MAAM,IAAI,QAAQ,CAChB,6BAA6B,EAC7B,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CACvD,CAAC;IACJ,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,aAAqB;IAC9D,MAAM,MAAM,GAAG,MAAM,yBAAyB,CAAC,aAAa,CAAC,CAAC;IAC9D,OAAO,4BAA4B,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;AAC9D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,aAAqB;IAC5D,MAAM,MAAM,GAAG,MAAM,yBAAyB,CAAC,aAAa,CAAC,CAAC;IAC9D,OAAO,4BAA4B,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,aAAqB;IAC3D,MAAM,MAAM,GAAG,MAAM,yBAAyB,CAAC,aAAa,CAAC,CAAC;IAE9D,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC;QAC9B,GAAG,CAAC,MAAM,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7E,GAAG,CAAC,MAAM,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACpE,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,KAAK,EAAE,MAAM,CAAC,KAAK;KACpB,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,yBAAyB,CAAC,aAAqB;IAC5D,MAAM,cAAc,GAAG,MAAM,sBAAsB,CAAC,aAAa,CAAC,CAAC;IACnE,IAAI,cAAc,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,cAAc,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QAC/E,OAAO,0BAA0B,CAAC;YAChC,MAAM,EAAE,cAAc,CAAC,MAAM;SAC9B,CAAC,CAAC;IACL,CAAC;IAED,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,gBAAgB,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;QAC9D,MAAM,OAAO,GAAsB,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;QAClD,MAAM,UAAU,GAAG,kBAAkB,CAAC,cAAc,CAAC,SAAS,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;QAErF,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO,0BAA0B,CAAC;gBAChC,UAAU;gBACV,MAAM,EAAE,OAAO,CAAC,MAAM;aACvB,CAAC,CAAC;QACL,CAAC;QAED,2BAA2B,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QACjD,8BAA8B,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAEpD,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,OAAO,0BAA0B,CAAC;gBAChC,UAAU;gBACV,MAAM,EAAE,OAAO,CAAC,MAAM;aACvB,CAAC,CAAC;QACL,CAAC;QAED,MAAM,KAAK,GAAG,mBAAmB,CAAC,UAAU,EAAE,aAAa,EAAE,OAAO,CAAC,CAAC;QACtE,IAAI,CAAC,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxC,OAAO,0BAA0B,CAAC;gBAChC,UAAU;gBACV,MAAM,EAAE,OAAO,CAAC,MAAM;aACvB,CAAC,CAAC;QACL,CAAC;QAED,OAAO,0BAA0B,CAAC;YAChC,UAAU;YACV,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,KAAK;YACL,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,0BAA0B,CAAC;YAChC,MAAM,EAAE;gBACN;oBACE,IAAI,EAAE,6BAA6B;oBACnC,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;iBAChE;aACF;SACF,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}

package/dist/inventory/normalize.d.ts

@@ -0,0 +1,4 @@
+import type { InventorySchemaKind } from "./types.js";
+import type { NormalizedInventory, ValidationContext } from "./internalTypes.js";
+export declare function detectSchemaKind(value: unknown): InventorySchemaKind;
+export declare function normalizeInventory(value: unknown, schemaKind: InventorySchemaKind, context: ValidationContext): NormalizedInventory | null;

package/dist/inventory/normalize.js

@@ -0,0 +1,251 @@
+import { AppError } from "../core/errors.js";
+import { CANONICAL_GROUP_KEYS, SIMPLIFIED_GROUP_KEYS, SIMPLIFIED_ROOT_KEYS, isObject, readStringList, readVarsObject, validateSafeName } from "./internalUtils.js";
+export function detectSchemaKind(value) {
+    if (!isObject(value)) {
+        throw new AppError("inventory_invalid_root", "Inventory root must be a mapping/object");
+    }
+    if ("all" in value) {
+        return "canonical-ansible-yaml";
+    }
+    if ("hosts" in value || "groups" in value || "vars" in value || "version" in value) {
+        return "simplified-yaml";
+    }
+    throw new AppError("inventory_unsupported_schema", "Unsupported inventory schema: expected canonical all: root or simplified vars/hosts/groups root");
+}
+export function normalizeInventory(value, schemaKind, context) {
+    return schemaKind === "simplified-yaml"
+        ? normalizeSimplifiedInventory(value, context)
+        : normalizeCanonicalInventory(value, context);
+}
+function normalizeSimplifiedInventory(value, context) {
+    if (!isObject(value)) {
+        context.errors.push({
+            code: "inventory_root_invalid",
+            message: "Simplified inventory root must be a mapping/object"
+        });
+        return null;
+    }
+    for (const key of Object.keys(value)) {
+        if (!SIMPLIFIED_ROOT_KEYS.has(key)) {
+            context.errors.push({
+                code: "inventory_structural_key_invalid",
+                message: `Unsupported top-level key in simplified inventory: ${key}`,
+                path: key
+            });
+        }
+    }
+    if (value.version !== undefined && value.version !== 1) {
+        context.errors.push({
+            code: "inventory_version_invalid",
+            message: `Unsupported simplified inventory version: ${String(value.version)}`,
+            path: "version"
+        });
+    }
+    const globalVars = readVarsObject(value.vars, context, "vars");
+    const hosts = new Map();
+    const groups = new Map();
+    if (value.hosts !== undefined && !isObject(value.hosts)) {
+        context.errors.push({
+            code: "inventory_hosts_invalid",
+            message: "Simplified inventory hosts must be a mapping/object",
+            path: "hosts"
+        });
+    }
+    if (isObject(value.hosts)) {
+        for (const [hostName, hostValue] of Object.entries(value.hosts)) {
+            validateSafeName(hostName, "host", context, `hosts.${hostName}`);
+            if (!isObject(hostValue)) {
+                context.errors.push({
+                    code: "inventory_host_invalid",
+                    message: `Host ${hostName} must be a mapping/object of direct host vars`,
+                    path: `hosts.${hostName}`
+                });
+                continue;
+            }
+            hosts.set(hostName, { ...hostValue });
+        }
+    }
+    if (value.groups !== undefined && !isObject(value.groups)) {
+        context.errors.push({
+            code: "inventory_groups_invalid",
+            message: "Simplified inventory groups must be a mapping/object",
+            path: "groups"
+        });
+    }
+    if (isObject(value.groups)) {
+        for (const [groupName, groupValue] of Object.entries(value.groups)) {
+            validateSafeName(groupName, "group", context, `groups.${groupName}`);
+            if (groupName === "all") {
+                context.errors.push({
+                    code: "inventory_group_reserved",
+                    message: "Simplified inventory may not define groups.all; all is implicit/reserved",
+                    path: `groups.${groupName}`
+                });
+                continue;
+            }
+            if (hosts.has(groupName)) {
+                context.errors.push({
+                    code: "inventory_name_collision",
+                    message: `Host/group name collision: ${groupName}`,
+                    path: `groups.${groupName}`
+                });
+            }
+            if (!isObject(groupValue)) {
+                context.errors.push({
+                    code: "inventory_group_invalid",
+                    message: `Group ${groupName} must be a mapping/object`,
+                    path: `groups.${groupName}`
+                });
+                continue;
+            }
+            for (const key of Object.keys(groupValue)) {
+                if (!SIMPLIFIED_GROUP_KEYS.has(key)) {
+                    context.errors.push({
+                        code: "inventory_group_structural_key_invalid",
+                        message: `Unsupported key ${key} in simplified group ${groupName}`,
+                        path: `groups.${groupName}.${key}`
+                    });
+                }
+            }
+            groups.set(groupName, {
+                name: groupName,
+                vars: readVarsObject(groupValue.vars, context, `groups.${groupName}.vars`),
+                hosts: readStringList(groupValue.hosts, context, `groups.${groupName}.hosts`),
+                children: readStringList(groupValue.children, context, `groups.${groupName}.children`)
+            });
+        }
+    }
+    return {
+        schemaKind: "simplified-yaml",
+        globalVars,
+        hosts,
+        groups
+    };
+}
+function normalizeCanonicalInventory(value, context) {
+    if (!isObject(value) || !isObject(value.all)) {
+        context.errors.push({
+            code: "inventory_root_invalid",
+            message: "Canonical inventory must contain an all mapping/object",
+            path: "all"
+        });
+        return null;
+    }
+    for (const key of Object.keys(value)) {
+        if (key !== "all") {
+            context.errors.push({
+                code: "inventory_structural_key_invalid",
+                message: `Unsupported top-level key in canonical inventory: ${key}`,
+                path: key
+            });
+        }
+    }
+    const allNode = value.all;
+    const globalVars = readVarsObject(allNode.vars, context, "all.vars");
+    const hosts = new Map();
+    const groups = new Map();
+    walkCanonicalGroup("all", allNode, hosts, groups, context, true);
+    for (const hostName of hosts.keys()) {
+        if (groups.has(hostName)) {
+            context.errors.push({
+                code: "inventory_name_collision",
+                message: `Host/group name collision: ${hostName}`,
+                path: hostName
+            });
+        }
+    }
+    groups.delete("all");
+    return {
+        schemaKind: "canonical-ansible-yaml",
+        globalVars,
+        hosts,
+        groups
+    };
+}
+function walkCanonicalGroup(groupName, node, hosts, groups, context, isRoot = false) {
+    validateSafeName(groupName, "group", context, groupName);
+    for (const key of Object.keys(node)) {
+        if (!CANONICAL_GROUP_KEYS.has(key)) {
+            context.errors.push({
+                code: "inventory_group_structural_key_invalid",
+                message: `Unsupported key ${key} in canonical group ${groupName}`,
+                path: `${groupName}.${key}`
+            });
+        }
+    }
+    const vars = readVarsObject(node.vars, context, `${groupName}.vars`);
+    const hostNames = [];
+    const childGroups = [];
+    if (node.hosts !== undefined && !isObject(node.hosts)) {
+        context.errors.push({
+            code: "inventory_hosts_invalid",
+            message: `Canonical group ${groupName} hosts must be a mapping/object`,
+            path: `${groupName}.hosts`
+        });
+    }
+    if (isObject(node.hosts)) {
+        for (const [hostName, hostNode] of Object.entries(node.hosts)) {
+            validateSafeName(hostName, "host", context, `${groupName}.hosts.${hostName}`);
+            hostNames.push(hostName);
+            if (hostNode !== undefined && hostNode !== null && !isObject(hostNode)) {
+                context.errors.push({
+                    code: "inventory_host_invalid",
+                    message: `Canonical host ${hostName} must be a mapping/object`,
+                    path: `${groupName}.hosts.${hostName}`
+                });
+                continue;
+            }
+            if (!hosts.has(hostName)) {
+                hosts.set(hostName, isObject(hostNode) ? { ...hostNode } : {});
+            }
+            else if (isObject(hostNode) && Object.keys(hostNode).length > 0) {
+                context.errors.push({
+                    code: "inventory_host_duplicate_definition",
+                    message: `Canonical host ${hostName} is defined with vars in multiple locations`,
+                    path: `${groupName}.hosts.${hostName}`
+                });
+            }
+        }
+    }
+    if (node.children !== undefined && !isObject(node.children)) {
+        context.errors.push({
+            code: "inventory_children_invalid",
+            message: `Canonical group ${groupName} children must be a mapping/object`,
+            path: `${groupName}.children`
+        });
+    }
+    if (isObject(node.children)) {
+        for (const [childGroupName, childNode] of Object.entries(node.children)) {
+            validateSafeName(childGroupName, "group", context, `${groupName}.children.${childGroupName}`);
+            childGroups.push(childGroupName);
+            if (childNode === null || childNode === undefined) {
+                if (!groups.has(childGroupName)) {
+                    groups.set(childGroupName, { name: childGroupName, vars: {}, hosts: [], children: [] });
+                }
+                continue;
+            }
+            if (!isObject(childNode)) {
+                context.errors.push({
+                    code: "inventory_group_invalid",
+                    message: `Canonical child group ${childGroupName} must be a mapping/object`,
+                    path: `${groupName}.children.${childGroupName}`
+                });
+                continue;
+            }
+            walkCanonicalGroup(childGroupName, childNode, hosts, groups, context);
+        }
+    }
+    if (!isRoot) {
+        const existing = groups.get(groupName);
+        if (existing) {
+            const mergedHosts = [...new Set([...existing.hosts, ...hostNames])];
+            const mergedChildren = [...new Set([...existing.children, ...childGroups])];
+            const mergedVars = { ...existing.vars, ...vars };
+            groups.set(groupName, { name: groupName, vars: mergedVars, hosts: mergedHosts, children: mergedChildren });
+        }
+        else {
+            groups.set(groupName, { name: groupName, vars, hosts: hostNames, children: childGroups });
+        }
+    }
+}
+//# sourceMappingURL=normalize.js.map

package/dist/inventory/normalize.js.map

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

package/dist/inventory/parse.d.ts

@@ -0,0 +1,6 @@
+import type { InventoryValidationError } from "./types.js";
+export interface ParsedInventoryDocumentResult {
+    rootValue?: unknown;
+    errors: InventoryValidationError[];
+}
+export declare function parseInventoryDocument(inventoryPath: string): Promise<ParsedInventoryDocumentResult>;

package/dist/inventory/parse.js

@@ -0,0 +1,31 @@
+import fs from "node:fs/promises";
+import { parseDocument } from "yaml";
+export async function parseInventoryDocument(inventoryPath) {
+    try {
+        const text = await fs.readFile(inventoryPath, "utf8");
+        const doc = parseDocument(text, { uniqueKeys: true, merge: true, prettyErrors: true });
+        if (doc.errors.length > 0) {
+            return {
+                errors: doc.errors.map((error) => ({
+                    code: "inventory_yaml_invalid",
+                    message: `Invalid inventory YAML: ${error.message}`
+                }))
+            };
+        }
+        return {
+            rootValue: doc.toJS(),
+            errors: []
+        };
+    }
+    catch (error) {
+        return {
+            errors: [
+                {
+                    code: "inventory_validation_failed",
+                    message: error instanceof Error ? error.message : String(error)
+                }
+            ]
+        };
+    }
+}
+//# sourceMappingURL=parse.js.map

package/dist/inventory/parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../../src/inventory/parse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,MAAM,CAAC;AAQrC,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,aAAqB;IAChE,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;QACtD,MAAM,GAAG,GAAG,aAAa,CAAC,IAAI,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC;QAEvF,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1B,OAAO;gBACL,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;oBACjC,IAAI,EAAE,wBAAwB;oBAC9B,OAAO,EAAE,2BAA2B,KAAK,CAAC,OAAO,EAAE;iBACpD,CAAC,CAAC;aACJ,CAAC;QACJ,CAAC;QAED,OAAO;YACL,SAAS,EAAE,GAAG,CAAC,IAAI,EAAE;YACrB,MAAM,EAAE,EAAE;SACX,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,MAAM,EAAE;gBACN;oBACE,IAAI,EAAE,6BAA6B;oBACnC,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;iBAChE;aACF;SACF,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/inventory/policy.d.ts

@@ -0,0 +1,11 @@
+import type { InventoryValidationError } from "./types.js";
+export interface HostEligibilityEvaluation {
+    eligible: boolean;
+    ineligibilityReasons: string[];
+    errors: InventoryValidationError[];
+}
+export interface HostAccessEvaluation {
+    readAllowed: boolean;
+}
+export declare function evaluateHostEligibility(hostName: string, effectiveVars: Record<string, unknown>): HostEligibilityEvaluation;
+export declare function evaluateHostAccess(eligible: boolean, effectiveVars: Record<string, unknown>): HostAccessEvaluation;

package/dist/inventory/policy.js

@@ -0,0 +1,27 @@
+import { readBoolean, readString } from "../utils/value.js";
+export function evaluateHostEligibility(hostName, effectiveVars) {
+    const ansibleNetworkOs = readString(effectiveVars.ansible_network_os);
+    const mcpPlatform = readString(effectiveVars.mcp_platform);
+    const errors = [];
+    if (ansibleNetworkOs !== undefined &&
+        mcpPlatform !== undefined &&
+        ((ansibleNetworkOs === "eos") !== (mcpPlatform === "arista_eos"))) {
+        errors.push({
+            code: "inventory_platform_conflict",
+            message: `Host ${hostName} has conflicting platform declarations ansible_network_os=${ansibleNetworkOs} and mcp_platform=${mcpPlatform}`,
+            path: hostName
+        });
+    }
+    const eligible = ansibleNetworkOs === "eos" || mcpPlatform === "arista_eos";
+    return {
+        eligible,
+        ineligibilityReasons: eligible ? [] : ["host is not explicitly marked as EOS eligible"],
+        errors
+    };
+}
+export function evaluateHostAccess(eligible, effectiveVars) {
+    return {
+        readAllowed: eligible ? readBoolean(effectiveVars.mcp_read_allowed) ?? true : false
+    };
+}
+//# sourceMappingURL=policy.js.map

package/dist/inventory/policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.js","sourceRoot":"","sources":["../../src/inventory/policy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAa5D,MAAM,UAAU,uBAAuB,CACrC,QAAgB,EAChB,aAAsC;IAEtC,MAAM,gBAAgB,GAAG,UAAU,CAAC,aAAa,CAAC,kBAAkB,CAAC,CAAC;IACtE,MAAM,WAAW,GAAG,UAAU,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC;IAC3D,MAAM,MAAM,GAA+B,EAAE,CAAC;IAE9C,IACE,gBAAgB,KAAK,SAAS;QAC9B,WAAW,KAAK,SAAS;QACzB,CAAC,CAAC,gBAAgB,KAAK,KAAK,CAAC,KAAK,CAAC,WAAW,KAAK,YAAY,CAAC,CAAC,EACjE,CAAC;QACD,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,6BAA6B;YACnC,OAAO,EAAE,QAAQ,QAAQ,6DAA6D,gBAAgB,qBAAqB,WAAW,EAAE;YACxI,IAAI,EAAE,QAAQ;SACf,CAAC,CAAC;IACL,CAAC;IAED,MAAM,QAAQ,GAAG,gBAAgB,KAAK,KAAK,IAAI,WAAW,KAAK,YAAY,CAAC;IAE5E,OAAO;QACL,QAAQ;QACR,oBAAoB,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,+CAA+C,CAAC;QACvF,MAAM;KACP,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,QAAiB,EACjB,aAAsC;IAEtC,OAAO;QACL,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,aAAa,CAAC,gBAAgB,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK;KACpF,CAAC;AACJ,CAAC"}

package/dist/inventory/resolveTarget.d.ts

@@ -0,0 +1,14 @@
+import { AppError } from "../core/errors.js";
+import type { InventoryHostModel, InventoryModel } from "./types.js";
+export interface ResolveInventoryTargetOptions {
+    target: string;
+}
+export interface ResolvedInventoryTarget {
+    target: string;
+    targetType: "host" | "group";
+    resolvedHosts: InventoryHostModel[];
+}
+export declare class InventoryResolutionError extends AppError {
+    constructor(code: string, message: string);
+}
+export declare function resolveInventoryTarget(model: InventoryModel, options: ResolveInventoryTargetOptions): ResolvedInventoryTarget;