# Session changelog 2026-07-24 -- Stage-5 bundle-render committee + Fork-1 ruling

Branch `dc-dc-stage4-phase3-maas-deploy`. Session resumed the DC1 Stage-5
bundle-rework blocker under a committee review (operator-requested). Status lives
ONLY in `docs/CURRENT-STATE.md` (GA-R1); this changelog is the review surface --
each item states what / why / revert. No cloud state was mutated this session.

## Item 1 -- Committee record (Track 2 bundle render)

**What:** new `docs/audit/committee-20260724-track2-bundle-render.md` -- a 4-lens
(Roosevelt-delta / HA-DR / operational-risk / Juju-MAAS-mechanism) read-only
committee review of the vr1-dc1 deploy-artifact render, with the adjudication and
open operator decisions. Advisory/audit record; adopts nothing (GA-R5).
**Why:** operator: "Deploy a committee to review Track 2 and provide
recommendations based on overall end project goals and decisions already
researched." Durable, citable authority (commissioning-committee precedent).
**Revert:** `git rm docs/audit/committee-20260724-track2-bundle-render.md`.

## Item 2 -- Capacity gate capture (Fork-1 option a)

**What:** new `docs/audit/stage5-controller-capacity-20260724.txt` -- captured
`scripts/dc-dc-whole-host-budget.py` runs: baseline built layout 3+2+4 x2 DC =
838/1024 GiB (82%, FIT); +controller (+8 GiB/+4 vCPU per-DC containment overhead)
= 854/1024 GiB (83%, FIT, 170 GiB headroom). Read-only calculator; nothing
queried live.
**Why:** GA-R1 -- the Fork-1 (a) capacity claim must be MEASURED, not inferred
(the signed doc's 790/77% is the OLD 8-node layout). Gate = PASS.
**Revert:** `git rm docs/audit/stage5-controller-capacity-20260724.txt`.

## Item 3 -- D-104 amendment (Fork-1 ruling: dedicated 10th controller VM)

**What:** appended a D-104 amendment (2026-07-24) in `docs/design-decisions.md`
recording the operator's GA-R5 ruling -- the per-DC Juju controller is a DEDICATED
10th node VM (distinct tag `juju-controller-vr1-dc1`, no role tag), separate from
the 9 Option C role nodes; additive (`for_each`-keyed); capacity gate PASS
(cites item 2); the 9-node D-121 layout is unchanged.
**Why:** Fork 1 was the blocking architectural decision; operator selected
"Dedicated 10th VM (Recommended)" over shrink-a-role and co-locate. Controller
placement is D-104's subject; recorded as its amendment (not a new D-number).
**Revert:** delete the "### D-104 -- AMENDMENT (2026-07-24)" block in
`docs/design-decisions.md` (git range-diff of this commit).

## Item 4 -- CURRENT-STATE Stage-4 bullet update (GA-R1 / C1)

**What:** rewrote the Stage-4 bullet's render sub-bullets: committee-adjudicated;
Fork 1 RULED (a) + capacity gate; Fork 2/3 as OPS committee-unanimous
recommendations (gated at execution); BUNDLEFIX-052 fixed; a corrected NEXT list.
Also corrected an earlier inaccurate characterization (dc-ha-scaleup is not "stale
ceph-osd 3" -- it deliberately excludes ceph-osd) and the "consumes 1 of 9"
arithmetic (now a dedicated 10th VM).
**Why:** GA-R1/C1 -- a status-changing commit updates CURRENT-STATE in the SAME
commit (repo-lint L10). Status authority stays single-sourced.
**Revert:** restore the prior Stage-4 bullet text (git range-diff of this commit).

## Item 5 -- BUNDLEFIX-052: ceph-rbd-mirror duplicate `bindings:`

**What:** removed an orphaned 4-space-indented `bindings:` block in `bundle.yaml`
(old line ~907) that `yaml.safe_load` take-last had absorbed into `ceph-rbd-mirror`,
clobbering its real `ceph-local`/`ceph-remote` (replication) + `nrpe-external-master`
bindings (D-108/D-052) and injecting a phantom `dashboard` binding (a charm with no
such endpoint) -> `juju deploy` validation reject.
**Why:** confirmed pre-existing latent defect (committee mechanism lens; verified
via `yaml.safe_load`). Fork-independent; fix now so the dc1 render starts clean.
**Validation:** `yaml.safe_load` confirms `ceph-rbd-mirror.bindings` restored to
`{'': metal-admin, ceph-local: replication, ceph-remote: replication,
nrpe-external-master: metal-internal}`; `provider-bundle-check.py bundle.yaml` PASS.
**Revert:** re-insert the orphan block after the vault-hacluster comment (not
advised -- it is the bug).

## Item 6 -- provider-bundle-check.py: overlay merge + per-DC VIP bands + placement invariants

**What:** extended `scripts/provider-bundle-check.py` with (a) `--overlay FILE`
(juju-like merge, so the checker validates the EFFECTIVE deploy input), (b) `--dc
vr1-dc0|vr1-dc1` selecting expected VIP bands (default dc0 = base bundle, so an
un-parameterized run is byte-identical to before), and (c) placement invariants that
activate ONLY on a role-separated bundle (machines tagged control/compute/storage)
and self-skip on the base/un-rendered bundle: no dangling `to:`; LXD containers on
control, ceph-osd on storage, nova-compute on compute; each num_units>=2 app spread
across that many DISTINCT machines (anti-affinity); ceph-osd == storage count,
nova-compute == compute count. Dropped the "controller-tag" idea (the controller is
the bootstrap machine, not a bundle machine -- verified at the MAAS-tagging step).
**Why:** the committee's non-negotiable "spine" -- the checker was placement-blind,
so any render could silently ship decorative HA. Makes the hand-render machine-checked;
also closes the committee's dc1-VIP-outside-the-check gap.
**Caveat (VERIFY-LIVE):** the checker's machines-block overlay merge MIRRORS juju's
documented behavior; the actual machines-retag-via-overlay is confirmed at
`juju deploy --dry-run` before deploy (no offline juju merger exists). Fallback if it
does not take: inline the dc1 tags into a rendered bundle.
**Validation:** harness `tests/provider-bundle-check/run-tests.sh` 15/15 (7 new
behavioral cases). Gauntlet ALL GREEN (78). repo-lint 0 fail.
**Revert:** `git checkout <this-commit>~ -- scripts/provider-bundle-check.py
tests/provider-bundle-check/run-tests.sh`.

## Item 7 -- vr1-dc1 bundle render (9-node role-separated) + retag overlay

**What:** rendered `bundle.yaml` from VR0's 4-node hyperconverged layout to VR1 dc1's
9-node role-separated one: machines block "8"-"11" (`tags=openstack`) -> "0"-"8" with
role+DC tags (block style -- flow `{...}` would split the comma-tag); every app `to:`
re-homed (mysql/ovn-central/ceph-mon -> control 0/1/2; nova-compute 3->2 on compute 3/4;
ceph-osd -> storage 5/6/7/8; the 14 scaled apps -> control placeholder that the overlay
spreads; utilities -> control); ovn-chassis MACs -> the 2 dc1 compute provider NICs.
Rendered `overlays/dc-ha-scaleup.yaml` tokens -> logical control ids 0/1/2 (now
DC-neutral) + updated its header + fixed the stale ceph-osd-3 comment. New
`overlays/vr1-dc1-machines.yaml` (per-DC retag; machines-overlay merge is VERIFY-LIVE at
`juju deploy --dry-run`).
**Why:** the committee-adjudicated render (Fork 2 = hand-render now); unblocks the dc1
Stage-5 deploy. Done as an asserted one-shot line-transform (preserves all D-NNN comments)
reviewed via git diff + the validator.
**Validation:** `provider-bundle-check.py bundle.yaml` (base standalone) PASS; the FULL dc1
deploy input (`--overlay vr1-dc1-machines --overlay vr1-dc1-vips --overlay dc-ha-scaleup
--dc vr1-dc1`) PASS; harness 15/15; gauntlet ALL GREEN (78); repo-lint 0-fail. The
validator CAUGHT a real render bug (YAML flow-comma dropping the role tag) -- exactly its
purpose.
**Revert:** `git checkout <this-commit>~ -- bundle.yaml overlays/dc-ha-scaleup.yaml` +
`git rm overlays/vr1-dc1-machines.yaml`.

## Item 8 -- provider-bundle-check ovn-chassis role-sep branch + expansion review record

**What:** (a) `provider-bundle-check.py` -- computes `role_sep` early; the ovn-chassis MAC
check now skips the VR0 openstack0-3 Pattern-A set on a role-separated bundle (verifies
present + well-formed instead), since dc chassis are the compute-node provider MACs.
(b) new `docs/audit/stage5-expansion-review-20260724.md` -- three read-only reviewer
verdicts (relations/bindings/cross-DC; config/pins; deploy-scripts), dispositioned
(handled / follow-up / VERIFY-LIVE / resolve-before-deploy / no-change).
**Why:** the operator-requested deployment-script expansion review; captures the
cross-connection/pinning/gate findings durably so the Chat design session (NetBox-deploy
coupling) reads them from the repo.
**Validation:** harness 15/15 (T9's role-sep fixture exercises the ovn role-sep branch);
gauntlet ALL GREEN (78).
**Revert:** `git checkout <this-commit>~ -- scripts/provider-bundle-check.py` +
`git rm docs/audit/stage5-expansion-review-20260724.md`.

## Next (not done this session; gated)

Commit+push this batch (GA-R5: rulings land before dependent work). Then, each
operator-gated: per-role MAAS tags; author + apply the 10th controller VM
(egress OPEN); render the 9-node `bundle.yaml` (re-home base placements, re-scope
tokens) + extend `provider-bundle-check.py` with placement assertions + wire
overlays + de-stale phase-4 Step 4; gated `juju bootstrap` (by controller tag,
egress OPEN) -> deploy. Deploy-time VERIFY-LIVE gates: vault-3-unit HA-on-MySQL,
hacluster cluster_count:3, dc1 VIPs, CRUSH failure-domain=host.