ea 0.4.0 → 0.5.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b401faad5f11e5b2504e50cabd3ee86dd4939bd8639c4c046b3fd9963408a116
-  data.tar.gz: fe36564c5f8d52281a35e1fa49c7f1231a42f941b92e8e5895623e18d6f32ddf
+  metadata.gz: 8649c4d58ca59e1a753bf7b4c1400e14ac7026e1142e914a4025dfd09a2e5bb1
+  data.tar.gz: 170d39d2601ea16f0dd171c7ab51906b4bbe0baf5c973eaffdfc02df2e27ab59
 SHA512:
-  metadata.gz: 7cd10052a2b16998cab3bde33d0874f605e6d8f767adefc710c7080ced3a39d76e3e0fb262b3931483d19cbfc35ff9715928f0d7d5f4dda22d95be693b0455a8
-  data.tar.gz: 87d9150c1840ca118fe264b5b1cf2c01bf09ba5d7eb2c5f5cf5a3aedd3c27bc4a07ea86ac9e7d1636bd2ebf835b012c049bc535e76edbdf412b28152ae7e4b68
+  metadata.gz: f7bd4ceb020497b93a2c9c9e0c60d3aa57a0cbb664803f4609a7ec82b2129649496bca45000b2ec91ba1c07a9254b1382bce67411f9f35b5d41dcaebe22590ff
+  data.tar.gz: ed3b011237a1a76a85ac1af8315afcfd9250b97396fbbcefe15f0491adbe1a51a1944abd7ba9ec513b0011c2461c4ff3c7bb5be20dfa58156cc93e3698c39d44

data/CHANGELOG.md

@@ -1,5 +1,132 @@
+# Changelog
+
+All notable changes to the `ea` gem are documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
 ## [Unreleased]
 
-## [0.1.0] - 2026-05-23
+## [0.5.1] — 2026-08-03
+
+### Added
+- Stereotype decorator icons now render inside element bodies via the
+  new `Compartment::StereotypeIcon` module. Falls back to hardcoded
+  polygons for FeatureType/Type; uses MDG-provided ShapeScript when
+  available.
+- OCL constraint evaluation wired into `ea validate`. Invariants from
+  `t_objectconstraint` are parsed and evaluated against owning
+  objects' attribute values.
+- Image rendering infrastructure: `Document#emit_images` walks the
+  `:images` collection and inlines `EmfRenderer` output. Gracefully
+  skips when `emfsvg` returns nil (current state — upstream parser
+  can't decode EA's EMF variant yet).
+- Diff comparator detects `:modified` changes via `to_hash`
+  comparison (was: add/remove/rename only).
+- PlantUML export now emits package nesting, generalizations
+  (`<\|--`), and composition arrows (`o--`, `*--`).
+- JSON export uses a per-class projection schema (no more raw
+  `to_hash` dumping Lutaml::Model internals).
+- CHANGELOG.md with full release history.
+
+### Changed
+- `ea export xmi` now routes to the full `Ea::Transformers::QeaToXmi`
+  (142 KB Sparx XMI) instead of the toy hand-rolled generator. The
+  toy `Ea::Export::Xmi` namespace is deleted.
+
+### Fixed
+- Removed all `respond_to?` calls from lib code (5 sites) — replaced
+  with `is_a?` type checks per the typing rule.
+- Renamed `object_id` attribute to `ea_object_id` in 12 new QEA
+  models to avoid collision with Ruby's `Object#object_id`.
+- XSD Generator no longer hardcodes `spec/fixtures/` paths; the CLI
+  layer loads fixtures and passes parsed data.
+- Bumped `lycheeverse/lychee-action` v1 → v2 (dependabot alert).
+
+## [0.5.0] — 2026-08-03
+
+### Added — CLI commands (13 new)
+- `ea diff OLD NEW` — structural comparison of two QEA files
+  (`--format=html` produces a color-coded HTML report).
+- `ea render NAME FILE` — unified rendering (SVG/PNG/PDF via
+  rsvg-convert or ImageMagick).
+- `ea export SUB FILE` — exports: `xmi`, `json`, `json-schema`,
+  `plantuml`, `xsd`.
+- `ea mdg ACTION` — list registered MDG technologies, show
+  stereotype details, list all stereotypes.
+- `ea lint FILE` — model quality checks (naming convention,
+  orphan elements, duplicate names, cyclic generalizations,
+  missing stereotypes).
+- `ea query FILE` — filter elements via a chainable DSL
+  (by type, package, stereotype, name).
+- `ea info NAME FILE` — show details of a single element.
+
+### Added — Subsystems
+- `Ea::Sources::Qea::Xref` — parser for `t_xref.Description`
+  (stereotype applications, tagged-value specs, legend definitions).
+- `Ea::Mdg::StereotypeAliasRegistry` — canonicalizes variant
+  stereotype spellings via GMLStereotypes.xml.
+- `Ea::Export::Xsd::Generator` — GMLClassMapping-driven XSD
+  schema generation.
+- `Ea::Export::JsonSchema::Generator` — JSON Schema (draft
+  2020-12) export.
+- `Ea::Export::Json::Generator`, `Ea::Export::PlantUml::Generator`
+  — JSON and PlantUML exports.
+- `Ea::Image::EmfRenderer` — lazy emfsvg adapter for EMF→SVG.
+- `Ea::Render::ImageConverter` — SVG → PNG / PDF via system tools.
+- `Ea::Lint` — engine + 5 rules (OCP: new rule = new class).
+- `Ea::Ocl` — OCL invariant parser + evaluator (subset: exists,
+  forAll, matches, and/or/not, attribute access).
+- `Ea::Shapescript` — ShapeScript parser + renderer with
+  variables, arithmetic, conditionals, subshapes, labels.
+- `Ea::Svg::EaEmitter::Element::HeaderLinePipeline` — OCP-friendly
+  provider chain replacing the monolithic HeaderLines module.
+- `Ea::Svg::EaEmitter::Element::StereotypeIconRenderer` — emits
+  stereotype decorator icons inside element bodies.
+
+### Added — QEA table coverage (24 → 43 tables)
+- `t_image`, `t_glossary`, `t_lists`, `t_versions`, `t_phase`,
+  `t_authors`, `t_secrypt`, `t_palette`, `t_paletteitem`,
+  `t_implement`, `t_roleconstraint`, `t_objectproblems`,
+  `t_objectrisks`, `t_objecttests`, `t_objecteffort`,
+  `t_objectresource`, `t_objectscenarios`, `t_objectrequires`,
+  `t_objecttrx`.
+
+### Changed
+- `Ea::Svg::EaEmitter::Element::HeaderLines` is now a thin alias
+  to the new `HeaderLinePipeline` (OCP provider chain).
+- Per-label styling fields (`BLD`, `ITA`, `UND`, `CLR`, `ALN`,
+  `DIR`, `ROT`) parsed from `t_diagramlinks.Geometry`.
+- Six new PDATA flag accessors on `Ea::Diagram::DisplayConfig`:
+  `ShowEStereo`, `ShowSN`, `OpParams`, `UseAlias`, `SuppCN`,
+  `ShowCons`, `ScalePI`.
+- `TableReader#table_exists?` — DatabaseLoader skips missing
+  tables gracefully instead of raising.
+- `Ea::Export::Xmi` removed — `ea export xmi` now routes through
+  the established `Ea::Transformers::QeaToXmi` (full-fidelity
+  Sparx round-trip) instead of a toy generator.
+
+### Removed
+- `Ea::Codegen` — speculative. We don't know what EA's actual
+  codegen does, so building our own was wrong.
+- Plugin system TODO — not needed.
+- Liquid template integration TODO — `lutaml-model` already
+  supports liquid drops natively.
+
+### Fixed
+- Replaced all `respond_to?` calls in lib code with `is_a?`
+  type checks.
+- Renamed `object_id` attribute to `ea_object_id` in 12 new
+  QEA models to avoid collision with Ruby's `Object#object_id`.
+
+### Spec coverage
+- 1974 examples, 0 failures, 55 pending.
+
+## [0.4.0] — 2026-07-21
+
+Initial public release of the standalone parser (QEA + Sparx XMI),
+diagram SVG rendering, and UML bridge.
+
+## [0.1.0] — 2026-05-23
 
 - Initial release

data/Rakefile

@@ -2,6 +2,9 @@
 
 require "bundler/gem_tasks"
 require "rspec/core/rake_task"
+require "fileutils"
+
+Dir[File.expand_path("lib/tasks/*.rake", __dir__)].sort.each { |f| load f }
 
 RSpec::Core::RakeTask.new(:spec)
 

data/TODO.complete/01-t-xref-parsing.md

@@ -0,0 +1,91 @@
+# TODO.complete/01: Full t_xref parser
+
+## Status: open
+
+EA's `t_xref` table stores semi-structured metadata in a custom mini-language.
+We currently only consume the stereotype-application rows for classifier
+stereo labels. The full format is the richest single metadata source in QEA.
+
+## Format observed
+
+### Stereotype application
+
+```
+@STEREO;Name=FeatureType;FQName=GML::FeatureType;@ENDSTEREO;
+```
+
+Fields: `Name` (short), `FQName` (`tech::Stereo`).
+
+### Per-label / element styling block
+
+```
+@PROP=NAME@ENDPROP;CX=19:CY=18:OX=-42:OY=-2:HDN=0:BLD=0:ITA=0:UND=0:CLR=-1:ALN=1:DIR=0:ROT=0;
+```
+
+Fields (colon-separated key=value pairs after `@PROP=NAME@ENDPROP;`):
+
+| key | meaning |
+|---|---|
+| CX, CY | cell size for label box |
+| OX, OY | label offset from anchor |
+| HDN | hidden (0/1) |
+| BLD | bold (0/1) |
+| ITA | italic (0/1) |
+| UND | underline (0/1) |
+| CLR | font color (signed int; -1 = default) |
+| ALN | alignment (0=left, 1=center, 2=right) |
+| DIR | text direction |
+| ROT | rotation in degrees |
+
+### CustomProperties
+
+```
+@CUSTOM;Name=...;Value=...;Type=...;@ENDCUSTOM;
+```
+
+(Repeated; semicolon-separated list.)
+
+### diagram properties
+
+Type=`diagram properties`. Carries display options as a `;`-separated list.
+
+## Volume observed (plateau v5.1 QEA)
+
+| Type | Count |
+|---|---|
+| element property | 599 |
+| connectorSrcEnd property | 352 |
+| diagram properties | 181 |
+| attribute property | 68 |
+| connector property | 34 |
+| connectorDestEnd property | 12 |
+
+Total: ~1246 rows in one real-world QEA.
+
+## Plan
+
+1. Add `Ea::Sources::Qea::XrefParser` — pure module, no state, parses one
+   `Description` string into a structured `XrefRecord` (value object).
+2. Define `XrefRecord` and `XrefStyleBlock` value objects in
+   `lib/ea/sources/qea/xref/` (autoload from `xref.rb`).
+3. Wire into `DiagramBuilder` and `ClassifierBuilder`:
+   - element property → per-element label style
+   - connectorSrcEnd / connectorDestEnd → per-end label style
+   - diagram properties → PDATA overrides
+4. Apply `BLD/ITA/UND/CLR/ALN/DIR/ROT` to connector labels in
+   `lib/ea/svg/ea_emitter/label/`.
+
+## OCP / MECE
+
+- New namespace `Ea::Sources::Qea::Xref` with parser + value objects.
+- `XrefParser.parse(description)` returns typed records — no mutation.
+- Renderers consume records via `XrefStyleBlock` interface; no string
+  parsing in renderers.
+
+## Acceptance
+
+- Spec: parse a real `@STEREO;Name=FeatureType;FQName=GML::FeatureType;@ENDSTEREO;`
+  → `{ stereotype: "FeatureType", fqname: "GML::FeatureType" }`.
+- Spec: parse a `@PROP=...` block → all 12 fields populated correctly.
+- Spec: `Ea.parse(plateau_v5_1_qea).xref_records.size` matches `SELECT COUNT(*) FROM t_xref`.
+- Spec: applied BLD=1 on a connector label propagates to SVG output.

data/TODO.complete/02-per-label-geometry.md

@@ -0,0 +1,50 @@
+# TODO.complete/02: Per-label Geometry box parsing
+
+## Status: open
+
+EA's `t_diagramlinks.Geometry` field encodes per-label styling boxes:
+
+```
+SX=20;SY=-31;EX=44;EY=-31;EDGE=2;LLB=CX=24:CY=13:OX=-42:OY=-1:HDN=0:BLD=0:ITA=0:UND=0:CLR=-1:ALN=1:DIR=0:ROT=0;LLE=...
+```
+
+Each label slot (`LLB`, `LLT`, `RLB`, `RLT`, `LLE`, `MLE`, `MTL`, `SLE`, `STE`)
+carries its own font/style override. We currently parse position (SX/SY/EX/EY)
+and label boxes for geometry but **drop the styling fields**.
+
+## Plan
+
+1. Extend `Ea::Sources::Qea::DiagramStyleParser` (or a new sibling
+   `GeometryParser`) to parse the inner `key=value:key=value:...` block of
+   each label slot into a `LabelStyle` value object.
+2. Thread `LabelStyle` onto `DiagramConnector` end-labels (left/right,
+   source/dest, role/mult).
+3. Renderers consume `LabelStyle` via accessors; no string parsing in
+   `lib/ea/svg/`.
+
+## Value object shape
+
+```ruby
+LabelStyle = Struct.new(:hidden, :bold, :italic, :underline,
+                        :color, :alignment, :direction, :rotation,
+                        :offset_x, :offset_y, :cell_w, :cell_h, keyword_init: true)
+```
+
+## OCP / MECE
+
+- Parsing lives in one place (Geometry parser).
+- Value object carries typed fields.
+- Renderers consume via attribute readers.
+
+## Acceptance
+
+- Spec: parse `LLB=CX=24:CY=13:OX=-42:OY=-1:HDN=0:BLD=1:ITA=0:UND=0:CLR=-1:ALN=1:DIR=0:ROT=0;`
+  → `LabelStyle` with `bold=true, alignment=1, offset_x=-42`.
+- Spec: a connector whose LLB has `BLD=1` renders bold left-label text.
+- Spec: `LabelStyle#hidden?` suppresses label rendering entirely.
+
+## Dependencies
+
+- Requires TODO.complete/01 if the styling block is shared with t_xref.
+  (They share the same `CX=..:OY=..:HDN=..:` shape — extract a shared
+  `CellStyleParser`.)

data/TODO.complete/03-object-properties-constraints.md

@@ -0,0 +1,57 @@
+# TODO.complete/03: t_objectproperties + t_objectconstraint parsing
+
+## Status: open
+
+Two EA tables we currently ignore. Both carry modeling metadata that maps
+to UML2 concepts:
+
+| Table | UML2 concept | Example |
+|---|---|---|
+| t_objectproperties | applied stereotype property values | `targetNamespace=http://...`, `xsdDocument=test.xsd` |
+| t_objectconstraint | Constraint / invariant | OCL: `inv: self.string->exists(...)` |
+
+## Volume observed
+
+| QEA | t_objectproperties | t_objectconstraint |
+|---|---|---|
+| basic | 0 | 0 |
+| test | 44 | 1 |
+| plateau v5.1 | 1537 | 4 |
+
+## Plan
+
+1. Add `Ea::Model::ObjectProperty` (or reuse `TaggedValue`) — EA's
+   t_objectproperties is functionally identical to applied-stereotype
+   properties. Decide: model as tagged values OR as distinct entity?
+   - **Decision**: model as `TaggedValue` (already exists) since EA
+     semantically treats these as stereotype property applications. The
+     distinction is storage, not semantics.
+2. Add `Ea::Model::Constraint` (already exists per `lib/ea/model/constraint.rb`).
+3. Add `Ea::Qea::Models::EaObjectProperty` and `EaObjectConstraint` raw-row models.
+4. Wire into `DatabaseLoader` + `Database` collections.
+5. `ClassifierBuilder` attaches both to the classifier.
+6. Constraint rendering: a new compartment below operations showing
+   `{constraint_name}: OCL expression`.
+
+## Schema (from plateau v5.1)
+
+```sql
+-- t_objectproperties
+Property TEXT, Value TEXT, Notes TEXT, ea_guid TEXT, Object_ID INTEGER, ...
+
+-- t_objectconstraint
+Constraint TEXT, ConstraintType TEXT, OCL, Notes, ea_guid, Object_ID
+```
+
+## OCP / MECE
+
+- Raw-row model per table (MECE: each table = one model).
+- Transformation to UML concept lives in the bridge (ClassifierBuilder).
+- Constraint rendering is a new compartment module.
+
+## Acceptance
+
+- Spec: `Ea.parse(test_qea).classifiers.find(...).constraints.first.name == "pattern"`.
+- Spec: `Ea.parse(test_qea).classifiers.find(...).tagged_values` includes
+  `targetNamespace` property.
+- Spec: plateau v5.1 parses 1537 properties without error.

data/TODO.complete/04-operation-params.md

@@ -0,0 +1,37 @@
+# TODO.complete/04: t_operationparams parsing
+
+## Status: open
+
+`t_operationparams` stores the parameters of an operation (method).
+We parse `t_operation` but lose the parameter list.
+
+## Schema (basic.qea)
+
+```
+OperationID INTEGER, Name TEXT, Type TEXT, Default TEXT, Notes TEXT,
+Pos INTEGER, Const INTEGER, Style TEXT, Kind TEXT (in/out/inout/return),
+ea_guid TEXT, ...
+```
+
+## Volume
+
+- basic.qea: 12 rows
+- plateau v5.1: 0 (no operations)
+
+## Plan
+
+1. Add `Ea::Qea::Models::EaOperationParam` raw-row model.
+2. Add `Ea::Model::Parameter` (already exists per `lib/ea/model/parameter.rb`).
+3. Wire into `DatabaseLoader` and `OperationBuilder`.
+4. Operation rendering: append `(name: Type, name2: Type2)` to operation line.
+
+## OCP / MECE
+
+- One builder per table (OperationBuilder owns t_operation + t_operationparams).
+- Parameter rendering is owned by the operation compartment renderer.
+
+## Acceptance
+
+- Spec: parse basic.qea → operations on classes include parameter lists.
+- Spec: parameter `kind` distinguishes `in/out/inout/return`.
+- Spec: `Operation#parameters` returns ordered list (Pos-sorted).

data/TODO.complete/05-pdata-flag-matrix.md

@@ -0,0 +1,52 @@
+# TODO.complete/05: Complete PDATA/StyleEx flag matrix
+
+## Status: open
+
+EA's `t_diagram.PDATA` carries ~30 rendering flags as `Key=value;` pairs.
+We currently parse only ~4 (`HideAtts`, `HideOps`, `HideParents`, `HideProps`).
+
+## Full flag matrix
+
+| Flag | Meaning | Status |
+|---|---|---|
+| HideAtts | Hide attribute compartment | ✅ parsed |
+| HideOps | Hide operation compartment | ✅ parsed |
+| HideParents | Hide off-canvas parent ghosts | ✅ parsed |
+| HideProps | Hide properties | ✅ parsed |
+| HideStereo | Hide stereotype labels | parsed, partial |
+| HideEStereo | Hide extended stereotypes | not parsed |
+| ShowTags | Show tagged values on elements | not parsed |
+| ShowSN | Show sequence numbers | not parsed |
+| OpParams | Show operation parameter types | not parsed |
+| UseAlias | Display Alias instead of Name | not parsed |
+| SuppCN | Suppress connector names | not parsed |
+| ShowIcons | Show stereotype icons | parsed, icons deferred |
+| ScalePI | Scale page indicators | not parsed |
+| ShowCons | Show constraints | not parsed |
+| ShowParentWarn | Warn about hidden parents | not parsed |
+
+## Plan
+
+1. Create `Ea::Sources::Qea::PdataFlags` value object with all flags
+   as boolean accessors (default: EA defaults).
+2. `DiagramBuilder#build_one` parses PDATA once, threads the flags object
+   through `Diagram`.
+3. Renderers query `diagram.pdata_flags.show_tags?`, etc., via attribute
+   readers — no string parsing in renderer.
+4. Document EA defaults in the value object (ShowTags default = false,
+   UseAlias default = false, etc.).
+
+## OCP / MECE
+
+- Parsing in one place (PDATA parser).
+- Value object carries typed flags.
+- Renderers consume via boolean methods.
+- New flag = new accessor on the value object; no renderer changes for
+  existing flags.
+
+## Acceptance
+
+- Spec: `PdataFlags.parse("HideAtts=1;ShowTags=1;").show_tags? == true`.
+- Spec: `PdataFlags.parse("").use_alias? == false` (default).
+- Spec: UseAlias=1 in source → element header shows `alias` not `name`.
+- Spec: OpParams=0 → operation line shows `op()` not `op(name: Type)`.

data/TODO.complete/06-emf-image-rendering.md

@@ -0,0 +1,34 @@
+# TODO.complete/06: EMF→SVG conversion for t_image
+
+## Status: open
+
+EA's `t_image` table stores image blobs as Enhanced Metafile (EMF).
+We currently skip them entirely.
+
+The pure-Ruby `emfsvg` gem at `~/src/claricle/emfsvg/` consumes the
+`emf` gem's domain model and converts EMF records to SVG — no FFI,
+no libemf2svg. This is a perfect fit.
+
+## Plan
+
+1. Add `emfsvg` as an optional runtime dependency (`spec.add_dependency "emfsvg", "~> X"`).
+2. Add `Ea::Image::EmfRenderer` that wraps `emfsvg` to convert a t_image
+   BLOB to an SVG `<symbol>` definition.
+3. Render in `lib/ea/svg/ea_emitter/`: emit `<defs><symbol id="img-{id}">`
+   from EMF, then `<use href="#img-{id}"/>` at the placement rect.
+4. Cache converted images per render pass (one t_image → one symbol).
+5. Skip silently if `emfsvg` not available (graceful degradation).
+
+## OCP / MECE
+
+- Image rendering is its own namespace (`Ea::Image::`).
+- No dependency on lutaml-uml.
+- Lazy-loaded: only required when t_image rows exist.
+
+## Acceptance
+
+- Spec: `Ea.parse(plateau_v5_1_qea).images.size == 1`.
+- Spec: SVG output for plateau includes an `<image>` reference or inline
+  converted vector group.
+- Spec: when emfsvg is unavailable, render proceeds without the image
+  (no exception).

data/TODO.complete/07-auxiliary-tables.md

@@ -0,0 +1,47 @@
+# TODO.complete/07: Auxiliary QEA tables
+
+## Status: open
+
+EA has ~96 tables. We currently parse 24. Beyond the structural core
+(objects, connectors, diagrams, packages, operations, attributes, xref),
+several tables carry semantic value for the CLI replacement vision.
+
+## Tables worth adding
+
+| Table | Purpose | CLI value |
+|---|---|---|
+| t_glossary | Term definitions | Documentation |
+| t_version | Version control history | Audit |
+| t_phase | Project phases | PM integration |
+| t_lists | Enumeration lists | Validation |
+| t_secuser / t_secgroup | Permissions (locked QEA) | Access control |
+| t_secrypt | Encryption metadata | Security analysis |
+| t_authors | Authors | Audit |
+| t_clients | Client definitions | CRM-lite |
+| t_resources | Resource allocation | PM |
+| t_tasks | Tasks | PM |
+| t_issues | Issue tracking | Bug tracker |
+| t_risks | Risk register | PM |
+
+## Plan
+
+Add these incrementally as demand appears. Each follows the same pattern:
+
+1. Raw-row model in `lib/ea/qea/models/ea_{table}.rb` (autoload from `models.rb`).
+2. Wire into `config/qea_schema.yml`.
+3. Wire into `DatabaseLoader`.
+4. Expose via `Database#collections[:{table}]`.
+5. CLI exposes via `ea stats` and lookup methods.
+
+## Priority order
+
+1. **t_glossary** — simple key/value, useful for documentation.
+2. **t_version** — version history, useful for audit.
+3. **t_authors** — already partly referenced by other tables.
+
+The rest (PM/CRM/security) are low priority unless a user requests them.
+
+## Acceptance
+
+- Spec: each table has a raw-row model with COLUMN_MAP.
+- Spec: `ea stats FILE` includes the new table count.

data/TODO.complete/10-mdg-stereotype-registry.md

@@ -0,0 +1,40 @@
+# TODO.complete/10: MDG stereotype registry
+
+## Status: open
+
+We have 49 EA-bundled MDG/GML definition files in `spec/fixtures/mdg/`:
+
+- `ea_mdg/*.xml` (46 MDG technology XMLs: BPMN, ArchiMate, SysML, ...)
+- `ea_config/gml/GMLStereotypes.xml` (7 GML stereotypes with aliases)
+- `ea_config/gml/GMLClassMapping.xml` (UML→GML mapping rules)
+- `ea_config/gml/GMLNamespaces.xml` (15+ GML namespace declarations)
+
+The MDG loader is functional but doesn't expose these as a queryable
+registry.
+
+## Plan
+
+1. Extend `Ea::Mdg::Registry` (existing) to load all 49 files at startup.
+2. Add lookup methods:
+   - `Registry#stereotype_by_name(name)` → returns Stereotype with alias,
+     tagged value definitions, default color, applicable element types.
+   - `Registry#stereotypes_for_technology(tech_name)` → list.
+   - `Registry#tagged_value_defs(stereo_name)` → list of tagged value
+     definitions.
+3. Use this in rendering:
+   - Apply default stereotype color from MDG definition (closes some
+     colorization gaps).
+   - Validate applied stereotypes against MDG definitions.
+4. Expose via CLI (`ea mdg list`, `ea mdg show`).
+
+## OCP / MECE
+
+- Registry is the single source of truth.
+- New technology = new file in fixtures/ + Registry auto-discovers.
+- Renderers and validators query; they don't parse XML.
+
+## Acceptance
+
+- Spec: `Registry.stereotype_by_name("FeatureType")` returns non-nil.
+- Spec: registry covers ≥900 stereotypes after loading all 46 MDG files.
+- Spec: `ea mdg list` CLI lists technologies.

data/TODO.complete/11-gml-xsd-generation.md

@@ -0,0 +1,42 @@
+# TODO.complete/11: GML XSD schema generation
+
+## Status: open
+
+The `GMLClassMapping.xml` file defines how UML classes map to GML XML
+Schema constructs:
+
+```xml
+<Class name="FeatureType"
+       element="featureMember"
+       type="FeaturePropertyType"
+       propertyType="..."/>
+```
+
+With this, we can generate GML XSD schemas from QEA models — a
+high-value CLI feature that EA charges money for.
+
+## Plan
+
+1. Add `Ea::Export::Xsd::Generator` in `lib/ea/export/xsd/`.
+2. Use the `GMLClassMapping` to translate:
+   - Class with stereotype `FeatureType` → `<xs:element>` + `<xs:complexType>`.
+   - Property with type `FeatureType` → property type reference.
+   - Property of cardinality 0..n → `maxOccurs="unbounded"`.
+3. Use `GMLNamespaces.xml` to declare target namespaces.
+4. CLI: `ea export xsd model.qea --package core -o schema.xsd`.
+
+## OCP / MECE
+
+- Generator is a single class with a `call` method.
+- Mapping rules loaded once from XML.
+- Output is a Nokogiri::XML::Document, serialized to string.
+
+## Acceptance
+
+- Spec: generate XSD from test.qea TestSchema → matches expected root element.
+- Spec: FeatureType class generates `<xs:element>` + complex type.
+- Spec: property with targetNamespace picks up namespace from GMLNamespaces.
+
+## Dependencies
+
+- TODO.complete/10 (registry) for stereotype lookup.

data/TODO.complete/13-shapescript-interpreter.md

@@ -0,0 +1,28 @@
+# TODO.complete/13: Basic ShapeScript interpreter
+
+## Status: deferred
+
+EA's MDG technologies can define stereotype icons via ShapeScript — a
+domain-specific language for vector shapes (lines, polygons, ellipses).
+
+This is what closes the **polygon -4 parity gap** (TODO.diagrams/73): the
+small stereotype decorator icons EA renders inside element bodies.
+
+## Why deferred
+
+- Full ShapeScript interpreter is high effort (~1-2 weeks).
+- The gap is small (4 polygons across 188 diagrams).
+- EA's InternalTechnologies encryption blocks the easy path to reference
+  shape definitions (see TODO.diagrams/87).
+
+## When to revisit
+
+- Encryption is broken and we have plaintext shape definitions.
+- A user specifically requests stereotype decorator icon rendering.
+- A larger gap emerges that ShapeScript would close.
+
+## Partial path (lower effort)
+
+If we acquire plaintext shape definitions for a few high-value stereotypes
+(FeatureType, Type), we can hardcode their polygons without a full
+ShapeScript interpreter. This is a tactical compromise.