openup: EA model built + enriched - baseline, associations, joint design package

Windows/EA session per BUILD-CHECKLIST 0-6 (the planned human-gate path,
executed on the EA machine). Baseline built from EABase.eapx via
build-model.ps1 and verified per checklist 4: 3 actors, 12 UCs with
scenarios, 13 associations, 0 include connectors, 7 SS requirements,
12 realization packages / 36 elements; UC-08 MSS (9 steps) and UC-11
learn spell level (3 steps) match use-case-model.md verbatim.

Script fixes (defects 1-3 of the session log): PS 5.1 hashtable parse
error; realization UC lookup now accepts short and full use-case names.

Enrichment after a manual layout pass - model changes are surgical from
now on, re-running build-model.ps1 is forbidden (checklist 6):
- add-analysis-associations.ps1: 24 analysis associations per mapping
  2a (boundary-controller-entity; UC-04 boundary-entity) rendered via
  DiagramLinks without touching manual layout; 4 uses-dependencies to
  DomainError (UC-05/06/08/12 error paths, model-level)
- add-design-package.ps1: Analysis-Design/Design - joint component
  model (skara-brae-client, sb-api, sb-auth, sb-db, sb-core, sb-shared,
  sb-common; 10 dependencies, rule inward). Joint-model decision
  recorded in mapping 1: one model for server+client+common; client-
  side UC realizations are a future work item.

Markdown sources updated first (drift rule): mapping 1 tree + 2a
interactions + 3 design component model; checklist 6. Exports
regenerated from the model: use-case-model.json new,
uc-realizations.json re-exported (useCase full names, notes merged,
crossCutting added; element content verified equal to the
markdown-to-json generator output).

Open: XMI backup - ExportPackageXMI fails via COM (DISP_E_TYPEMISMATCH,
PS 5.1 + cscript); manual EA UI export per model/README.md option 2.

docs/openup/model/BUILD-CHECKLIST.md

@@ -201,3 +201,42 @@ UC-07:3, UC-08:5, UC-09:2, UC-10:3, UC-11:3, UC-12:3 — total 36.
    content — it was generated from the mapping markdown).
 2. Save the model; commit `.eapx` + `exports/` + `scripts/openup/` together as one commit
    `openup: EA model WI-2 baseline` in **skara-brae-common**.
+
+---
+
+## 6. Enrichment (2026-10-03, after manual layout session) — SURGICAL only
+
+The user laid out diagrams by hand in EA after the WI-2 baseline build. From here on the
+model may only be touched by the two surgical scripts below — **never** re-run
+`build-model.ps1` (it deletes and rebuilds the Requirements / Analysis-Design packages and
+would destroy manual layout). Sources: `uc-realization-mapping.md` §2a (interactions) and
+§3 (design component model).
+
+### 6.1 Analysis associations — `scripts/openup/add-analysis-associations.ps1`
+
+- Inside each `UC-NN Realization` package: Association connectors per mapping §2a
+  (boundary→controller, controller→entity; UC-04 boundary→entity) — **24 associations**
+  (UC-01:2, UC-02:1, UC-03:3, UC-04:1, UC-05:2, UC-06:2, UC-07:2, UC-08:4, UC-09:1,
+  UC-10:2, UC-11:2, UC-12:2).
+- 4 Dependencies `«uses»` from TrainingService, EquipmentService, AdventureService,
+  ReviewBoard to `DomainError` (Architecture Overview) — the error paths of UC-05/06/08/12.
+- DiagramLinks added to each package's existing class diagram so the connectors render
+  WITHOUT touching any DiagramObject (manual layout preserved). Idempotent: existing
+  connectors are skipped.
+
+### 6.2 Design package — `scripts/openup/add-design-package.ps1`
+
+- Creates `Analysis-Design / Design` (rebuilds only this package — agent-owned, contains
+  no manual edits): 7 components (skara-brae-client, sb-api, sb-auth, sb-db, sb-core,
+  sb-shared, sb-common) with traceability notes, 10 Dependency connectors, one Component
+  diagram `Component Architecture` (layered layout, dependency rule inward).
+
+### 6.3 Verification
+
+1. 24 associations across realization packages (per-UC counts above); 4 `«uses»`
+   dependencies to DomainError; still 0 `«include»` connectors.
+2. `Design` package: 7 components, 10 dependencies, 1 diagram.
+3. Baseline intact: 3 actors, 12 use cases, 12 realization packages, 13 actor-UC
+   associations; Requirements tree untouched.
+4. Manual layout preserved: the scripts add no/modify no DiagramObjects in existing
+   diagrams (only the new `Design` diagram carries its own object layout).