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>
This commit is contained in:
2026-11-05 22:13:25 +00:00
parent f659564208
commit 9e503885cc
211 changed files with 18170 additions and 158 deletions

View File

@@ -279,6 +279,48 @@
"source_ref"
]
}
},
"provider": {
"type": "string",
"enum": [
"sample",
"azure",
"gcp"
],
"default": "sample",
"description": "Which estate this run reads: `sample` (the Meridian sample estate, through the alz-* tools) or a live cloud, `azure` or `gcp`, through that cloud's discovery server. Set once for the whole workflow run."
},
"findings": {
"type": "array",
"items": {
"type": "object"
},
"default": [],
"description": "The scan's findings; each finding's dependencies become edges (ADR 0019)."
},
"cmdb_cis": {
"type": "array",
"items": {
"type": "object"
},
"default": [],
"description": "The CMDB step's judged CIs and their reconciliation results: the graph's ci nodes."
},
"cmdb_relationships": {
"type": "array",
"items": {
"type": "object"
},
"default": [],
"description": "The CMDB step's relationships between CIs, parent to child: the graph's ci -> ci edges."
},
"cmdb_dangling": {
"type": "array",
"items": {
"type": "object"
},
"default": [],
"description": "CMDB relationships with an end that matches no CI."
}
},
"required": [

View File

@@ -28,7 +28,10 @@
"app_to_db",
"app_to_app",
"app_to_shared_service",
"middleware"
"middleware",
"network_attachment",
"unclassified",
"represents"
]
},
"protocol_port": {
@@ -49,7 +52,8 @@
"declared",
"config",
"flow",
"trace"
"trace",
"reconciliation"
]
},
"ref": {
@@ -111,6 +115,76 @@
"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": [
@@ -133,6 +207,240 @@
"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": [