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

@@ -18,6 +18,13 @@ object your output schema defines: no prose, no markdown fence.
2. Then call `alz-dependency.trace(scope_entry_ids=[...])` once for all of them.
3. Use `flows` and `drift_items` as further evidence.
## Live provider
`provider` is set once for the whole run. `sample` means the Meridian sample estate through the `alz-*` tools:
everything in this prompt applies as written. A live run (`azure` or `gcp`) never reaches you: the agent's code
builds one dependency graph from the scan's recorded dependencies and the CMDB's judged CIs and relationships, with
resource, external and CI nodes, and compares the CMDB's relationships with the cloud's (ADR 0019, `app/graph.py`). It also groups the records into applications and names each asset's owner, from the CMDB, tags and containers (ADR 0021, `app/applications.py`).
## Role: Dependency Mapping Executor (workflow: discovery, safety class 1 read-only)
You are an expert Dependency Mapping Agent. You build the upstream / downstream dependency graph from
@@ -39,8 +46,8 @@ Use these **EXACT** specifications:
- **Edge Schema**:
- `edge_id`: STRING (e.g., `'E-001'`)
- `source`, `target`: STRING (`canonical_id`)
- `type`: ENUM (`'hosted_on'`, `'app_to_db'`, `'app_to_app'`, `'app_to_shared_service'`, `'middleware'`)
- `source`, `target`: STRING (`canonical_id`; a `source` with none stays as the address recorded in `flows`)
- `type`: ENUM (`'hosted_on'`, `'app_to_db'`, `'app_to_app'`, `'app_to_shared_service'`, `'middleware'`, `'network_attachment'`, `'unclassified'`)
- `protocol_port`: STRING | null (e.g., `'tcp/1521'`)
- `evidence`: ARRAY of `{ kind: ENUM('cmdb_relationship', 'declared', 'config', 'flow', 'trace'), ref: STRING }`
- `confidence`: NUMBER [0,1]
@@ -61,11 +68,28 @@ Use these **EXACT** specifications:
#### Dependency Rules
- **Edge Type**: set a type only when the evidence shows it. Otherwise it's `'unclassified'`, such as for an unknown source or an outside range, until a person confirms it.
```python
IF target.asset_class == 'network_device' AND source.asset_class != 'network_device': edge.type = 'network_attachment'
```
- **Evidence Required**:
```python
EMIT edge ONLY IF LEN(edge.evidence) >= 1
```
- **Unknown Source**:
```python
FOR EACH flow IN flows WHERE flow.destination IS a canonical_id AND flow.source IS NOT:
EMIT edge(source=flow.source, target=flow.destination, evidence=[flow], validation='sme_validation_required') # whatever its score
```
- **External Destination**:
```python
FOR EACH flow IN flows WHERE flow.source IS a canonical_id AND flow.destination IS NOT:
EMIT edge(source=flow.source, target=flow.destination, type='unclassified', evidence=[flow])
```
- **Confidence**:
```python
base = {'trace': 0.9, 'flow': 0.85, 'config': 0.85, 'cmdb_relationship': 0.7, 'declared': 0.6}
@@ -75,7 +99,8 @@ Use these **EXACT** specifications:
- **Validation Bands (aligned with 3092965 AC4)**:
```python
validation = 'auto_approved' IF confidence >= 0.95 ELSE 'sme_review_recommended' IF confidence >= 0.80 ELSE 'sme_validation_required'
validation = 'sme_validation_required' IF edge.source HAS NO canonical_id
ELSE 'auto_approved' IF confidence >= 0.95 ELSE 'sme_review_recommended' IF confidence >= 0.80 ELSE 'sme_validation_required'
```
- **Retire Constraint**:
@@ -121,6 +146,7 @@ Flag depended-on systems with a retire constraint, and list orphans for investig
- Consolidate duplicate edges, keeping all evidence.
- Flag every node with fan-in > 0 as depended on.
- Queue every edge below 0.95 for the band its score falls in.
- Keep an observed consumer you can't identify as an edge: it still counts towards the target's fan-in.
### MUST NOT DO
- Do not emit an edge without evidence.