byaml — SOFE Architecture Graph v0.4 (BYaML v2)

BYaML v2 — relanzamiento graph-first bajo breakingthecloud (Apache-2.0). Un solo modelo (grafo) · serialización BYaML solo para interop · interfaces AI-native (MCP).

Paquete PyPI byaml con el Architecture Graph v0.4: models, validate, convert, dump/load. El grafo lo consume nan-graph como motor (traversal, blast radius, cost chain, SPOF).

Instalar

pip install byaml

Uso

from byaml import Graph, load, dump, validate, from_terraform, from_evaluation

# Validate
g = load("graph.byaml")
ok, issues = validate(g, schema="v0.4")

# Convert IaC → graph
g = from_terraform("tfplan.json", account="279624932954")

# Convert SOFE evaluation → graph
g = from_evaluation(findings, cost_map, eval_id="8f2a...")

CLI

byaml validate out.byaml
byaml convert --terraform tfplan.json -o graph.byaml
byaml dump --json graph.byaml

Modelo (graph-first)

• Nodes = recursos/servicios (id, type, layer, region, account, cost, findings, owner)
• Edges = relaciones tipadas (from, to, type, weight)
• Catalog = catalog.yaml (baseline ≥17 tipos desde SOFE collectors, expandible)
• Relationships = relationships.yaml (matriz from/to/type; fuera de matriz → WARNING)

Ver SPEC.md en breakingthecloud/byaml-spec.