Align the OpenUP markdown set to the blank templates (process-data repo,
templates/openup/) per BUILD-CHECKLIST 7. Scenario step text unchanged;
the EA model needs no change (brief descriptions already live in the
model's UC/actor notes).
- vision.md: positioning tables, stakeholder summary, user environment,
needs-and-features table (R1/R2), other product requirements
- use-case-model.md: per-UC specification sections (brief description,
actor descriptions, named alternative/exception subsections with
numbered steps, post-conditions, special requirements)
- supplementary-specifications.md: category tables with priority and
use-case columns + reverse coverage matrix; IDs unchanged
- test/quality-check-procedure.md: migrated from Joplin (single content
home); stale open items marked resolved (WI-1/WI-2)
- analysis-design/sequences/: 12 PlantUML design sequences (lifelines =
analysis classes, messages = design elements; per the PlantUML layout
style guide) + PNG renders; embedded in Architecture Notebook 9.3
- Joplin consolidated: project content notes deleted (all live in
docs/game + docs/openup); Joplin keeps the status note only
Lossless XMI 2.1 export of the model root per BUILD-CHECKLIST 5.1 /
model README option 2. The COM path stays broken in this EA 15 build
(ExportPackageXMI typelib declares its filename parameter as Object -
no string marshals in, verified across PowerShell/JScript/VBScript and
arities 2-6; ExportProjectXML returns false silently); the manual UI
export is the documented fallback for this machine.
- analysis-design/architecture-notebook.md: Architecture Notebook work
product in the keyfob docx template structure (10 sections), grounded
in mapping / design note / supplementary specs; embeds the component
model and all 12 realization figures
- scripts/openup/export-diagram-images.ps1: read-only EA COM renderer
(EA-15 findings: image API on ProjectInterface, OpenDiagram before
export or blank stub, type 0 = PNG); renders reflect manual layouts
- renders: requirements/use-case-overview.png, analysis-design/
uc-01..12-realization.png + component-architecture.png; embedded as
figures in use-case-model.md and uc-realization-mapping.md
- BUILD-CHECKLIST 6.4 documents the exporter
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.
Per design-wi-2-architecture-cleanup.md §11.b/c: keyfob-station pipeline
studied (add-wi19-uc11.ps1, export-model-json.ps1). Platform gap: EA COM
pipeline is Windows-only; this session ran on Linux (no EABase.eapx found,
no pwsh) - .eapx skeleton NOT committed, documented in model/README.md
with the two path options. Landed:
- docs/openup/model/BUILD-CHECKLIST.md: full EA-session checklist
(packages, 3 actors, 12 UCs with scenarios, 13 associations, 12
realization packages / 36 elements) derived from use-case-model.md +
uc-realization-mapping.md
- docs/openup/model/README.md: platform note, status, drift rule
- docs/openup/model/exports/uc-realizations.json: generated from mapping
§2 via scripts/openup/markdown-to-json.py (tested locally)
- scripts/openup/build-model.ps1, export-model.ps1: adapted from keyfob
patterns, Windows-gated (human gate per design §11.d)
- scripts/openup/markdown-to-json.py: local markdown -> JSON transform
work-items.md (project-management/), design-wi-1-injectable-rng.md
(analysis-design/), test-report-wi-1-injectable-rng.md (test/) move into
the canonical OpenUP home per the 2026-10-03 decision reversal. Verbatim,
no content changes; project-top docs/ husk removed.
All OpenUP artifacts are versioned in skara-brae-common under docs/openup/
per the 2026-10-03 decision reversal in design-wi-2-architecture-cleanup.md
(supersedes the earlier in-server-docs decision). Verbatim move, no content
changes: analysis-design/, requirements/, test/ (6 files).
