File size: 3,823 Bytes
e06cbf7
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
"""Deterministic inventory loader for ALLI Node Validation Lab.

Safely reads and parses `node_inventory_audit.json` without executing arbitrary package code.
Enforces strict schema validation through Pydantic contracts.
"""

from __future__ import annotations

import json
import os
from pathlib import Path
from typing import Any, Dict, List, Optional, Tuple

from ..schemas.models import (
    InventorySummaryCounts,
    NodeValidationContract,
)


def get_inventory_path(override_path: Optional[str] = None) -> Path:
    """Deterministically locate the canonical node_inventory_audit.json file."""
    if override_path:
        p = Path(override_path)
        if p.is_file():
            return p.resolve()
        raise FileNotFoundError(f"Specified inventory file not found: {override_path}")

    # Check environment variable
    env_path = os.environ.get("ALLI_NODE_INVENTORY_PATH")
    if env_path:
        p = Path(env_path)
        if p.is_file():
            return p.resolve()

    # Potential relative paths
    candidates = [
        # Relative to this loader file (node_validation_lab/fixtures/ -> alli_backend/)
        Path(__file__).resolve().parent.parent.parent / "node_inventory_audit.json",
        # Current working directory
        Path.cwd() / "node_inventory_audit.json",
        Path.cwd() / "alli_backend" / "node_inventory_audit.json",
        Path.cwd() / "alli_frontend" / "node_inventory_audit.json",
        # Monorepo root checks
        Path(__file__).resolve().parent.parent.parent.parent / "alli_backend" / "node_inventory_audit.json",
        Path(__file__).resolve().parent.parent.parent.parent / "alli_frontend" / "node_inventory_audit.json",
    ]

    for cand in candidates:
        if cand.is_file():
            return cand.resolve()

    raise FileNotFoundError(
        "Could not find 'node_inventory_audit.json' in standard workspace locations."
    )


def load_raw_inventory(path: Optional[str] = None) -> Dict[str, Any]:
    """Deterministically load raw JSON data without executing arbitrary code."""
    resolved_path = get_inventory_path(path)
    with open(resolved_path, "r", encoding="utf-8") as f:
        data = json.load(f)

    if not isinstance(data, dict):
        raise ValueError("Invalid inventory format: Root must be a JSON object.")

    if "audit_metadata" not in data or "inventory" not in data:
        raise ValueError(
            "Invalid inventory schema: Missing 'audit_metadata' or 'inventory' key."
        )

    if not isinstance(data["inventory"], list):
        raise ValueError("Invalid inventory schema: 'inventory' must be a list.")

    return data


def load_inventory_contracts(path: Optional[str] = None) -> List[NodeValidationContract]:
    """Parse and validate inventory items into Pydantic NodeValidationContract models."""
    data = load_raw_inventory(path)
    return [NodeValidationContract.model_validate(item) for item in data["inventory"]]


def load_inventory_summary(path: Optional[str] = None) -> InventorySummaryCounts:
    """Extract and validate summary counts from audit metadata."""
    data = load_raw_inventory(path)
    meta = data.get("audit_metadata", {})
    summary_counts = meta.get("summary_counts", {})
    return InventorySummaryCounts.model_validate(summary_counts)


def load_complete_inventory_bundle(
    path: Optional[str] = None,
) -> Tuple[Dict[str, Any], InventorySummaryCounts, List[NodeValidationContract]]:
    """Return raw audit inventory dict, validated summary counts, and typed contracts."""
    data = load_raw_inventory(path)
    meta = data.get("audit_metadata", {})
    summary = InventorySummaryCounts.model_validate(meta.get("summary_counts", {}))
    contracts = [NodeValidationContract.model_validate(item) for item in data["inventory"]]
    return data, summary, contracts