Files
Jonathan Boniface 9e503885cc ALZ-F01 Discovery: package step, value scorecard, application grouping, cases
- New cp1-discovery-package-agent (ADR 0020): one package per reviewed run, every part
  hashed (sha256 over canonical JSON), with a manifest and a value scorecard.
- Applications grouped CMDB -> tag -> resource group with a judged model fallback (ADR 0021):
  CMDB 0.7.0 carries ownership, dependency mapping 0.6.0 groups, report 0.9.0 shows them.
- Critic 0.6.1 accepts the producers' enums; build_workflow.py refuses a consumer enum
  narrower than its producer's.
- Code hooks, sub-agents and tests for the inventory, CMDB, dependency, planner and critic
  agents; the report and Well-Architected review agents; ADRs 0012-0021.
- Workflow cases with value bars and run limits; run evaluation and usage collection scripts;
  the run context template and the field-by-field review for ADR 0016.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-05 22:13:25 +00:00

456 lines
10 KiB
JSON

{
"type": "object",
"properties": {
"graph_id": {
"type": "string"
},
"engagement_id": {
"type": "string"
},
"edges": {
"type": "array",
"items": {
"type": "object",
"properties": {
"edge_id": {
"type": "string"
},
"source": {
"type": "string"
},
"target": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"hosted_on",
"app_to_db",
"app_to_app",
"app_to_shared_service",
"middleware",
"network_attachment",
"unclassified",
"represents"
]
},
"protocol_port": {
"type": [
"string",
"null"
]
},
"evidence": {
"type": "array",
"items": {
"type": "object",
"properties": {
"kind": {
"type": "string",
"enum": [
"cmdb_relationship",
"declared",
"config",
"flow",
"trace",
"reconciliation"
]
},
"ref": {
"type": "string"
}
},
"required": [
"kind",
"ref"
]
}
},
"confidence": {
"type": "number",
"minimum": 0,
"maximum": 1
},
"validation": {
"type": "string",
"enum": [
"auto_approved",
"sme_review_recommended",
"sme_validation_required"
]
}
},
"required": [
"edge_id",
"source",
"target",
"type",
"protocol_port",
"evidence",
"confidence",
"validation"
]
}
},
"nodes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"canonical_id": {
"type": "string"
},
"fan_in": {
"type": "integer"
},
"fan_out": {
"type": "integer"
},
"depended_on": {
"type": "boolean"
},
"retire_constraint": {
"type": "string",
"enum": [
"none",
"cannot_retire_without_mitigation"
]
},
"id": {
"type": "string"
},
"kind": {
"type": "string",
"enum": [
"resource",
"external",
"ci"
],
"description": "resource: a scope entry; external: outside the scope root or not inventoried; ci: a CMDB CI (ADR 0019)."
},
"name": {
"type": [
"string",
"null"
]
},
"resource_id": {
"type": "string"
},
"type": {
"type": "string"
},
"container": {
"type": [
"string",
"null"
]
},
"reason": {
"type": "string",
"enum": [
"outside_scope_root",
"not_inventoried"
]
},
"referenced_by": {
"type": "array",
"items": {
"type": "string"
}
},
"ci_ref": {
"type": "string"
},
"ci_class": {
"type": [
"string",
"null"
]
},
"lifecycle": {
"type": [
"string",
"null"
]
},
"result": {
"type": [
"string",
"null"
]
},
"evidence_ref": {
"type": [
"string",
"null"
]
}
},
"required": [
"canonical_id",
"fan_in",
"fan_out",
"depended_on",
"retire_constraint"
]
}
},
"orphans": {
"type": "array",
"items": {
"type": "string"
}
},
"validation_queue": {
"type": "array",
"items": {
"type": "string"
}
},
"folded_dependencies": {
"type": "array",
"default": [],
"description": "Dependencies on a resource's own child components (a NIC, a disk): counted, not edges (ADR 0019).",
"items": {
"type": "object",
"properties": {
"source": {
"type": "string"
},
"target": {
"type": "string"
},
"type": {
"type": "string"
},
"rule": {
"type": "string"
},
"evidence_ref": {
"type": "string"
}
},
"required": [
"source",
"target",
"type",
"rule"
]
}
},
"dangling": {
"type": "array",
"default": [],
"items": {
"type": "object"
},
"description": "CMDB relationships with an end that matches no CI, from the CMDB step."
},
"graph_comparison": {
"type": "array",
"default": [],
"description": "CMDB relationships against the cloud's dependencies, walked over the one graph (ADR 0019).",
"items": {
"type": "object",
"properties": {
"result": {
"type": "string",
"enum": [
"confirmed",
"cmdb_only",
"discovered_only",
"not_comparable"
]
},
"cmdb_edge": {
"type": "string"
},
"cloud_edges": {
"type": "array",
"items": {
"type": "string"
}
},
"parent_ci": {
"type": [
"string",
"null"
]
},
"child_ci": {
"type": [
"string",
"null"
]
},
"source": {
"type": [
"string",
"null"
]
},
"target": {
"type": [
"string",
"null"
]
},
"source_resource": {
"type": [
"string",
"null"
]
},
"target_resource": {
"type": [
"string",
"null"
]
},
"reason": {
"type": "string"
}
},
"required": [
"result"
]
}
},
"note": {
"type": "string"
},
"applications": {
"type": "array",
"default": [],
"description": "A live run's applications, grouped in code: CMDB business service, then application tag (with tag aliases of CMDB applications), then container, then model-proposed and judged (ADR 0021).",
"items": {
"type": "object",
"required": [
"application_id",
"name",
"basis",
"members",
"review_required"
],
"properties": {
"application_id": {
"type": "string"
},
"name": {
"type": "string"
},
"basis": {
"type": "string",
"enum": [
"cmdb_business_service",
"tag",
"container",
"model"
]
},
"members": {
"type": "array",
"items": {
"type": "string"
},
"description": "canonical_id of each member record."
},
"owner": {
"type": [
"string",
"null"
]
},
"owners_disagree": {
"type": "boolean"
},
"business_service": {
"type": [
"string",
"null"
]
},
"evidence_refs": {
"type": "array",
"items": {
"type": "string"
}
},
"review_required": {
"type": "boolean"
},
"review_reasons": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
},
"asset_owners": {
"type": "array",
"default": [],
"description": "Each asset's owner, from its matched CMDB CI (owner, else support group) or an owner tag (ADR 0021).",
"items": {
"type": "object",
"required": [
"canonical_id",
"owner",
"source"
],
"properties": {
"canonical_id": {
"type": "string"
},
"owner": {
"type": "string"
},
"source": {
"type": "string",
"enum": [
"cmdb",
"tag"
]
},
"ci_ref": {
"type": [
"string",
"null"
]
},
"evidence_ref": {
"type": [
"string",
"null"
]
}
}
}
},
"ungrouped_assets": {
"type": "array",
"default": [],
"items": {
"type": "string"
},
"description": "canonical_id of each record no rule or judged proposal placed: a declared gap for Assessment."
},
"applications_note": {
"type": "string",
"default": "",
"description": "How the records were grouped, in one sentence."
}
},
"required": [
"graph_id",
"engagement_id",
"edges",
"nodes",
"orphans",
"validation_queue"
],
"title": "Dependency graph"
}