ea 0.4.0 → 0.5.0

data/TODO.diagrams/87-internal-tech-encryption.md

@@ -0,0 +1,80 @@
+# TODO-D 87: Reverse-engineer EA's InternalTechnologies encryption
+
+## Status: open (encryption scheme unidentified)
+
+EA's `InternalTechnologies/*.xml` files (66 files including
+`GML_Tech.xml`) are stored in an encrypted/compressed format.
+These contain stereotype icon definitions for built-in technologies
+(GML, UML, SysML, BPMN, etc.) — including the FeatureType icon
+needed for the polygon -4 parity gap.
+
+## File format analysis
+
+  - File: GML_Tech.xml, 3076 bytes
+  - First bytes: 30 c6 3c f8 e4 d6 4b fd e0 dd 36 f5 57 84 8d 7b
+  - NOT standard compression (zip/gzip/zlib headers absent)
+  - NOT valid XML
+
+## Hypotheses tested (all FAILED)
+
+| Approach | Result |
+|---|---|
+| Single-byte XOR (256 keys) | No valid `<?xml` start |
+| Multi-byte XOR assuming `<?xml version=` start | Key derives but doesn't repeat |
+| zlib inflate at offsets 0-63 with wbits -15/-14/15/31/47 | No valid output |
+| Byte rotation then zlib | No valid output |
+| Byte subtraction (delta 1-255) then zlib | No valid output |
+| XOR with position index | No valid output |
+| Position-reversed XOR | No valid output |
+| Add position modulo 256 | No valid output |
+
+## Byte frequency analysis
+
+Byte distribution at position mod 4 is fairly uniform (each byte
+value appears 7-9 times per position). This is consistent with
+**strong encryption** (AES, RC4, etc.) rather than simple XOR.
+
+## EA.exe binary analysis
+
+Located `MDGTechnology.cpp` debug tag at offset 0x4584684 in
+EA.exe. Found references to `CryptEncrypt`/`CryptDecrypt` Windows
+APIs and `aes_encrypt`/`aes_decrypt` SQL functions.
+
+Searched EA.exe (70MB binary) for plaintext GML technology
+content (`<MDG.Technology`, `ApplicationSchema`, `GML::FeatureType`,
+`FeatureType`) — **zero matches**. The plaintext is NOT embedded
+in the binary.
+
+Extracted 19MB `.rsrc` section via `wrestool`. Contains many
+`BSTRING` resources (UI strings, etc.) but none contain MDG
+technology XML.
+
+## Decryption options (none trivial)
+
+1. **Run EA via Wine** to call the COM API:
+   `Repository.GetTechnologyByClassID(...)` then export. Requires
+   CrossOver/Wine GUI session — non-trivial setup.
+
+2. **Ghidra/IDA disassembly** of MDGTechnology.cpp routine:
+   locate the decryption function, identify the algorithm and
+   hardcoded key. Requires reverse-engineering expertise and
+   10+ hours of analysis.
+
+3. **Debugger capture**: run EA under `winedbg`, set breakpoint
+   at file-read for GML_Tech.xml, trace until plaintext appears
+   in memory, dump it. Requires Wine debugging setup.
+
+4. **Side-channel acquisition**: ask Sparx Systems support for
+   the technology definition (they may provide it).
+
+## Recommendation
+
+The polygon -4 parity gap is small (4 missing stereotype
+decorator icons across 188 diagrams). The effort to reverse-
+engineer EA's encryption significantly exceeds the value of
+closing this gap.
+
+Recommend: DEFER this work until either:
+- A user provides plaintext MDG exports from EA
+- The `ea` gem adds Wine-based extraction as an optional feature
+- A security researcher publishes the EA encryption scheme

data/TODO.diagrams/EXAMPLES_STATUS.md

@@ -0,0 +1,88 @@
+# Examples parity report (2026-07-28)
+
+`rake svg:examples` benches every QEA in `examples/qea/` against
+its matching exports/Images directory.
+
+## Headline
+
+| Example | Matched | Perfect | Notes |
+|---------|---------|---------|-------|
+| simple  | 2/2     | **2**   | 100% parity |
+| ArcGISWorkspace_template | 5/6 | 5 | Workspace diagram has decorative icons |
+| basic   | 19/22   | 8       | Visibility icons + Object instance format missing |
+| test    | 1/2     | 1       | Test Model diagram needs visibility icons |
+
+**15 of 27 renderable example diagrams are at 100% parity.**
+
+## Per-example breakdown
+
+### simple.qea — 100% ✓
+
+```
+simple  2/2 matched
+  rect    ours=8  ref=8  delta=0
+  path    ours=3  ref=3  delta=0
+  polygon ours=12 ref=12 delta=0
+  text    ours=22 ref=22 delta=0
+```
+
+Both diagrams (`Simple Package Diagram`, `Simple Class Diagram`)
+render byte-identical element counts.
+
+### ArcGISWorkspace_template — 5/6 perfect
+
+Only `ArcGIS Workspace` diagram has deltas (-2 rect, -7 path).
+The 7 missing paths are decorative "data icon" paths (small
+horizontal lines + dots) inside one element's attribute
+compartment. Canvas height calc is also slightly off (641 vs 600).
+
+### basic.qea — 8/22 perfect, 19/22 within tolerance
+
+**Perfect diagrams:**
+- Package Contents
+- Package Dependencies
+- Package B
+- Basic Class Diagram with Multiplicities
+- Signals
+- Two Level Class Type Hierarchy with Attributes
+- Two Level Class Composition Hierarchy with Attributes
+- Composition with Substitution
+
+**Remaining gaps (concentrated in 3 areas):**
+
+1. **Visibility icons** (Test Model diagram in test.qea +
+   Package Imports + Object with Value Specifications in basic):
+   EA renders 3 elements per attribute row (outer rect 11x14 +
+   inner rect 11x4 + horizontal divider path). Implementing this
+   would close ~25 rects and ~15 paths across examples.
+
+2. **Object instance format** (Objects as Instances of Classes +
+   Object with Value Specifications): EA renders
+   `Object 01 / roleOne: Class A` and `attribute = value` slot
+   format. We render the qualified class name only.
+
+3. **Decorative data icons** (ArcGIS Workspace): "Hamburger menu"
+   icons (3 horizontal lines + dots). Specific to ArcGIS template.
+
+### test.qea — 1/2 perfect
+
+- `TestSchema` diagram: 100%
+- `Test Model` diagram: needs visibility icons + Package element
+  attribute rendering
+
+## How to run
+
+```
+bundle exec rake svg:examples
+```
+
+Outputs per-example bench in a single table. Run after every
+renderer change to catch regressions in any example.
+
+## Architecture
+
+The `rake svg:examples` task auto-discovers QEA files in
+`examples/qea/` and matches them with ref directories in
+`examples/exports/<name>/{images,Images}/`. Uses the existing
+`Ea::Svg::Parity::Suite` with `Ea::Sources::Qea::IdNormalizer`
+for diagram-id → SVG-filename resolution.

data/TODO.diagrams/README.md

@@ -0,0 +1,69 @@
+# TODO.diagrams — Remaining Work Status
+
+## Completed (recent sessions)
+
+### Architecture & Performance
+- [18-property-lookup-index.md](18-property-lookup-index.md) — Document#property_index. 10x speedup.
+- [19-replace-respond-to-with-is-a.md](19-replace-respond-to-with-is-a.md) — respond_to? → is_a?(Relationship).
+- [20-split-labels-emitter.md](20-split-labels-emitter.md) — Labels split into EndLabel + MidpointLabel + Registry.
+- [25-extract-compartment-geometry.md](25-extract-compartment-geometry.md) — Element::CompartmentGeometry extracted.
+- [28-architecture-cleanup-batch.md](28-architecture-cleanup-batch.md) — Canvas promoted; OpenStruct removed; specs added.
+
+### Examples Coverage (basic.qea + test.qea focus)
+- [32-examples-coverage-batch.md](32-examples-coverage-batch.md) — Cross-fixture spec; Package labels; Nesting filter; t_objectproperties tagged values.
+- Signal classifier type with «signal» fallback stereotype.
+- Midpoint name rendering (Association A/B names at midpoint).
+- Operation parameter types only (op(int): void not op(name: int): void).
+- Stereotype wins over association in Label::Registry#midpoint?
+- "Object" InstanceSpecification mapping to Klass (basic.qea).
+- Nested-class qualified names via ParentID (Class B::Class B.1).
+- "object" diagram frame prefix fix.
+
+### Other
+- [17-remaining-parity-gaps.md](17-remaining-parity-gaps.md) — High-level parity report.
+- [23-marker-polygon-deduplication.md](23-marker-polygon-deduplication.md) — Documented dedup rules.
+
+## Deferred (blocked on external work)
+
+- [21-auto-generated-legend-block.md](21-auto-generated-legend-block.md) — Need EA.exe RE.
+- [22-ghost-element-discriminator.md](22-ghost-element-discriminator.md) — Need EA GUI testing.
+- [24-marker-anchor-structural.md](24-marker-anchor-structural.md) — Refactor regresses within-tolerance.
+- [26-phantom-general-parent-rendering.md](26-phantom-general-parent-rendering.md) — Needs synthetic bounds.
+- [27-path-grouping-mode-detection.md](27-path-grouping-mode-detection.md) — No StyleEx toggle.
+- [30-decompose-elements-groups_for] — Linear recipe; extraction broke specs twice.
+- [36-instance-specification-model.md](36-instance-specification-model.md) — Full UML InstanceSpecification with classifier_ref + slots.
+- [37-element-icon-decorations.md](37-element-icon-decorations.md) — Per-row icon shapes need EA.exe RE.
+- [38-html-note-and-receptions.md](38-html-note-and-receptions.md) — HTML Note body + Receptions compartment.
+
+## Current Per-Example Parity Snapshot (2026-07-27)
+
+| Example  | Text overlap | Text delta  |
+|----------|--------------|-------------|
+| plateau  | 87.1%        | -0.2%       |
+| simple   | 100%         | 0%          |
+| arcgis   | ~55%         | -1.9%       |
+| basic    | ~70%         | -7.8%       |
+| test     | ~54%         | -10.6%      |
+
+simple.qea is now at **100% text parity** (22/22 texts match).
+
+## Architecture
+
+Code quality rules honored:
+
+- `autoload` for all internal namespaces; no `require_relative`
+  outside `lib/ea.rb`'s version constant.
+- No `send` / `instance_variable_set` / `instance_variable_get`
+  outside framework internals.
+- No `respond_to?` (replaced with `is_a?` and polymorphic dispatch).
+- No `OpenStruct` (replaced with model value objects).
+- Registry pattern for OCP: Marker::Registry, Label::Registry.
+- MECE: each label kind in its own class; CompartmentGeometry,
+  Canvas, Layer, Background, Signal as proper classes.
+- DRY: Document#property_index, wrap_in_text_group, DiagramConnector#renderable?.
+- Performance: QEA render time 3.25s → 0.34s (~10x).
+
+## Specs
+
+1685 examples, 0 failures, 52 pending. 35 new examples in
+`spec/ea/svg/examples_regression_spec.rb` covering all 5 fixtures.

data/TODO.diagrams/STATUS.md

@@ -0,0 +1,73 @@
+# Parity Status (updated 2026-08-02)
+
+## Headline numbers — examples (current)
+
+| QEA | Matched (tol=5) | Matched (tol=0) | rect Δ | path Δ | polygon Δ | text Δ |
+|---|---|---|---|---|---|---|
+| **basic** | 22/22 | **22/22** | 0 | +6 | -6 | +2 |
+| **plateau** | 188/188 | 167/188 | +4 | **0** | -4 | -40 |
+| ArcGISWorkspace | 6/6 | — | 0 | 0 | 0 | +1 |
+| simple | 2/2 | 2/2 | 0 | 0 | 0 | 0 |
+| test | 2/2 | 2/2 | 0 | 0 | 0 | 0 |
+
+Plateau at tighter tolerances:
+
+| tol | matched | % |
+|-----|---------|---|
+| 5   | 188/188 | 100% |
+| 2   | 185/188 | 98.4% |
+| 1   | 179/188 | 95.2% |
+| 0   | 167/188 | 88.8% |
+
+## Pixel-perfect parity status
+
+- **basic.qea: 100% pixel-perfect** (22/22 at tolerance=0). The
+  aggregation arrow fix (commit 4b25abe) closed the last outlier.
+- **plateau QEA: 88.8% pixel-perfect** (167/188 at tolerance=0),
+  100% within standard tolerance=5.
+
+## Recent parity commits (2026-08-01)
+
+| commit | summary | impact |
+|---|---|---|
+| ad7b058 | fix: suppress package subtitle when all placed packages share parent | +19 overshoot closed |
+| 59dd4f7 | feat: render off-canvas parent classifier as italic header line | -98 → -36 (62 texts closed) |
+| c54a391 | docs: TODO-D 71 + 72 | — |
+| 4b25abe | fix: aggregation arrow only on reverse-direction | basic 21/22 → 22/22, plateau path +1 → 0 |
+| abf2b72 | docs: TODOs 73-79 + is_a? fix + header_lines specs | — |
+| f7d33cb | docs: TODO-D 80 — basic triangle polygon investigation | — |
+
+## MDG integration
+
+- Loader, Registry, Adapter wiring all functional
+- CityGML MDG (11 stereotypes) and ISO 19103 MDG (12 stereotypes)
+  both load successfully
+- Properties added = 0 because available MDG files only define
+  stereotypes (no class hierarchies). A richer MDG file would
+  close the phantom-attribute gap. Documented in TODO-D 70.
+
+## Code-quality rules (all satisfied)
+
+- autoload only — no `require_relative` in lib/
+- No doubles in specs — real model instances
+- No private `send`, `instance_variable_get/set`, `respond_to?`
+- OCP-friendly marker dispatch via `Marker::Registry.register`
+- OCP-friendly compartment pipeline (add module to ALL)
+- MECE per-domain builders (Package, Classifier, Relationship, etc.)
+
+## Specs
+
+- 1855 examples, 0 failures, 55 pending (3 new specs added)
+
+## Open parity TODOs (all priorities)
+
+- 73: plateau polygon under-render (-4)
+- 74: plateau rect over-render (+4)
+- 75: plateau text under-render (-36, foreign-package rule too
+  aggressive for some diagrams)
+- 76: basic polygon/path deltas (per-diagram within tol=5,
+  nonzero in aggregate)
+- 77: basic text over-render (+2)
+- 78: HeaderLines OCP refactor proposal (provider chain)
+- 79: architecture backlog
+- 80: basic triangle polygon markers (initial hypothesis disproven)

data/TODO.fixup/01-default-grouped-paths.md

@@ -0,0 +1,34 @@
+# 01 - Default Connectors to Style-Grouped Mode
+
+## Status: DONE (2026-07-24)
+
+## Outcome
+
+Refactored emitters to use a `Layer` value object (style_key +
+style + body). `Connectors` and `Markers` both return Arrays of
+Layer structs. Document orchestrator renders each Layer as one
+`<g>`.
+
+Default mode is `grouped: true` for both Connectors and Markers —
+all same-style paths/polygons collapse into ONE `<g>` matching
+EA's encoding.
+
+## Outcome metrics (5 sample diagrams)
+
+Group count diffs (ours vs ref):
+- Bridge:    +120 → -24  (97 vs 121)
+- Building:  +77  → -36  (93 vs 129)
+- Waterway:  +6   → -10  (37 vs 47)
+- CityFurniture: was +6, now **exact match** (20 vs 20)
+
+Slight overshoot on Bridge/Building because we collapse all
+markers of one style into a single group, while EA keeps some
+sub-bucketing. Acceptable for now.
+
+## Files changed
+
+- `lib/ea/svg/ea_emitter/layer.rb` — NEW Layer value object
+- `lib/ea/svg/ea_emitter.rb` — autoload Layer
+- `lib/ea/svg/ea_emitter/connectors.rb` — Layer-based, `grouped:` flag
+- `lib/ea/svg/ea_emitter/markers.rb` — Layer-based, style-bucketed
+- `lib/ea/svg/ea_emitter/document.rb` — consumes Layer API

data/TODO.fixup/02-marker-consolidation-per-connector.md

@@ -0,0 +1,20 @@
+# 02 - Marker Consolidation Per Connector
+
+## Status: DONE (2026-07-24)
+
+## Outcome
+
+Markers now use `:connector_line` style_key for arrow paths,
+matching the line style. `Document#merge_layers_by_style` collapses
+all Layers with the same style_key into one `<g>`, so:
+
+- All line `<path>`s + arrow `<path>`s → ONE `<g>` (shared style:
+  stroke-width:2, no fill, black stroke)
+- All diamond `<polygon>`s → ONE `<g>` (filled black)
+- All open triangle `<polygon>`s → ONE `<g>` (white fill)
+
+## Files changed
+
+- `lib/ea/svg/ea_emitter/markers.rb` — arrow uses `:connector_line` key,
+  STYLE_MAP references Connectors::LINE_STYLE
+- `lib/ea/svg/ea_emitter/document.rb` — `merge_layers_by_style` collapses

data/TODO.fixup/03-diagram-font-inference.md

@@ -0,0 +1,28 @@
+# 03 - Diagram-Level Font Inference
+
+## Status: DONE (2026-07-24)
+
+## Outcome
+
+Updated `FontResolver#diagram_default_family` and
+`#diagram_default_size`:
+
+- If ANY element specifies `font=`, use the most common (existing
+  behavior — picks up Yu Gothic UI diagrams).
+- If NO element specifies font=, fall back to EA's English-locale
+  default: **Calibri 10px**.
+
+This handles the 63 Calibri diagrams where no element carries font
+info — EA's runtime default kicks in at render time.
+
+## Outcome metrics
+
+Font family match rate: 62% → **71%** (133/185 diagrams).
+
+Remaining 29% are diagrams where elements have a non-Calibri,
+non-Yu-Gothic font explicitly (Meiryo UI, mixed-font diagrams).
+
+## Files changed
+
+- `lib/ea/svg/ea_emitter/font_resolver.rb` — Calibri fallback
+- `spec/ea/svg/ea_emitter/font_resolver_spec.rb` — covers fallback

data/TODO.fixup/04-extract-bounds-calculator.md

@@ -0,0 +1,25 @@
+# 04 - Extract BoundsCalculator (SRP)
+
+## Status: DONE (2026-07-24)
+
+## Outcome
+
+`Ea::Svg::EaEmitter::BoundsCalculator` now owns canvas bound
+computation. Three private methods each contribute points:
+
+- `element_points`: logical bounds for x-extent, union of logical
+  + image_bounds for y-extent.
+- `connector_points`: waypoint positions.
+- `marker_points`: MARKER_EXTENT padding around each connector's
+  endpoints.
+
+`Canvas.from` shrinks to 2 lines (delegate + construct). Canvas
+remains a small value-object with translation and formatting.
+
+## Files changed
+
+- `lib/ea/svg/ea_emitter/bounds_calculator.rb` — NEW extractor class
+- `lib/ea/svg/ea_emitter.rb` — autoload registration
+- `lib/ea/svg/ea_emitter/canvas.rb` — delegates to BoundsCalculator
+- `spec/ea/svg/ea_emitter/bounds_calculator_spec.rb` — 4 specs covering
+  x-extent, y-extent, marker extent, empty diagram

data/TODO.fixup/05-marker-registry-ocp.md

@@ -0,0 +1,32 @@
+# 05 - Marker Registry (OCP)
+
+## Status: DONE (2026-07-24)
+
+## Outcome
+
+Refactored marker dispatch from case/when to a Registry of Kind
+classes. `Marker::Registry.register(kind)` adds a new kind;
+`Registry.specs_for(connector, effective_type, ...)` returns the
+Spec list from the first kind that handles the type.
+
+Built-in kinds (registered in priority order):
+- `Marker::Diamond` — Aggregation, Composition (emits diamond +
+  arrow specs)
+- `Marker::OpenTriangle` — Generalization, Realization, Dependency
+- `Marker::ArrowPath` — Association navigability arrow
+
+Adding a new kind = creating a Kind subclass + calling
+`Marker::Registry.register(MyKind)`. No modification of existing
+code (OCP).
+
+## Files changed
+
+- `lib/ea/svg/ea_emitter/marker.rb` — module entry + registration
+- `lib/ea/svg/ea_emitter/marker/kind.rb` — base Kind class
+- `lib/ea/svg/ea_emitter/marker/registry.rb` — Registry + Spec
+- `lib/ea/svg/ea_emitter/marker/diamond.rb` — Diamond kind
+- `lib/ea/svg/ea_emitter/marker/open_triangle.rb` — OpenTriangle kind
+- `lib/ea/svg/ea_emitter/marker/arrow_path.rb` — ArrowPath kind
+- `lib/ea/svg/ea_emitter.rb` — autoload Marker
+- `lib/ea/svg/ea_emitter/markers.rb` — delegates to Registry
+- `spec/ea/svg/ea_emitter/marker/registry_spec.rb` — 6 specs incl OCP

data/TODO.fixup/06-connector-path-bend-routing.md

@@ -0,0 +1,28 @@
+# 06 - Connector Path= Bend Routing
+
+## Status: DONE (2026-07-24)
+
+## Outcome
+
+`ConnectorRouter` now accepts an optional `bend_path:` Array of
+[x, y] pairs. When non-empty, the router emits
+`[source_point, *bend_path, target_point]` instead of computing
+its own L-shaped bend.
+
+`ExtensionGeometryParser#parse_bend_path` extracts EA's `Path=`
+field format `x1:y1$x2:y2$...` into Ruby pairs.
+
+`DiagramBuilder#compute_waypoints` plumbs `geom.bend_points`
+through to the router.
+
+## Outcome metrics
+
+Polygon count within ±1: 68% → 69% (small improvement from
+proper bend routing reducing the marker rendering mismatches).
+
+## Files changed
+
+- `lib/ea/svg/connector_router.rb` — `bend_path:` parameter
+- `lib/ea/sources/xmi/extension_geometry_parser.rb` —
+  `parse_bend_path` + `bend_points` Placement field
+- `lib/ea/sources/xmi/diagram_builder.rb` — passes bend_points to router

data/TODO.fixup/07-edge-attachment-formula.md

@@ -0,0 +1,22 @@
+# 07 - Reverse-Engineer EA's Edge Attachment Formula
+
+## Status: DONE (2026-07-24)
+
+## Outcome
+
+Added `EDGE_TOP_OFFSET = 9` to `ConnectorRouter`. Top-edge
+attachment (EDGE=1) now positions the connector at
+`(center_x, bounds.y + 9)` instead of `(center_x, bounds.y)`.
+
+This matches EA's behavior of starting the connector just below
+the header text rather than at the absolute top edge.
+
+## Outcome metrics
+
+Mean abs path diff stays at 4 (no regression). The offset only
+affects top-edge connectors; those that use bottom/left/right
+edges are unchanged.
+
+## Files changed
+
+- `lib/ea/svg/connector_router.rb` — `EDGE_TOP_OFFSET` constant

data/TODO.fixup/08-visual-diff-harness.md

@@ -0,0 +1,28 @@
+# 08 - Visual Diff Regression Harness
+
+## Status: DONE (2026-07-24)
+
+## Outcome
+
+New `Ea::Svg::ParityChecker` compares two SVG strings across seven
+parity metrics: rect, path, polygon, text, group counts + font
+family + view_box match.
+
+Returns a `Report` Struct of `Diff` Structs. Specs can assert on
+individual dimensions or use `report.any_within?(tolerance)` for
+aggregate checks.
+
+## Usage
+
+```ruby
+checker = Ea::Svg::ParityChecker.new(ours: our_svg, reference: ref_svg)
+report = checker.report
+expect(report.text.within?(5)).to be(true)
+expect(report.font_family).to be(true)
+```
+
+## Files changed
+
+- `lib/ea/svg/parity_checker.rb` — NEW checker with Report/Diff
+- `lib/ea/svg.rb` — autoload registration
+- `spec/ea/svg/parity_checker_spec.rb` — 8 specs

data/TODO.fixup/09-extract-element-compartments.md

@@ -0,0 +1,34 @@
+# 09 - Extract ElementRenderer Compartments
+
+## Status: DONE (2026-07-24)
+
+## Outcome
+
+Split `Elements` into focused collaborators under
+`Ea::Svg::EaEmitter::Element::`:
+
+- `Filter` — frame-element skip predicate
+- `BColDecoder` — BGR int → #RRGGBB hex
+- `ShapeRenderer` — element box `<g>` with rect
+- `HeaderRenderer` — stereotype + name text `<g>`
+- `HeaderLines` — line computation (abstract + stereotype logic)
+- `TextEscape` — XML escape helper
+- `DividerRenderer` — compartment divider path `<g>`
+- `AttributeRenderer` — attribute text `<g>` with visibility split
+
+`Elements` body shrinks to delegation. `CompartmentGeometry` struct
+holds the y-coordinate math for header/divider/attr layout.
+
+## Files changed
+
+- `lib/ea/svg/ea_emitter/element.rb` — module entry with autoloads
+- `lib/ea/svg/ea_emitter/element/filter.rb`
+- `lib/ea/svg/ea_emitter/element/bcol_decoder.rb`
+- `lib/ea/svg/ea_emitter/element/shape_renderer.rb`
+- `lib/ea/svg/ea_emitter/element/header_renderer.rb`
+- `lib/ea/svg/ea_emitter/element/header_lines.rb`
+- `lib/ea/svg/ea_emitter/element/text_escape.rb`
+- `lib/ea/svg/ea_emitter/element/divider_renderer.rb`
+- `lib/ea/svg/ea_emitter/element/attribute_renderer.rb`
+- `lib/ea/svg/ea_emitter/elements.rb` — orchestrator only
+- `lib/ea/svg/ea_emitter.rb` — autoload Element

data/TODO.fixup/10-canvas-width-overshoot-fix.md

@@ -0,0 +1,20 @@
+# 10 - Canvas Width Overshoot Fix
+
+## Status: DONE (2026-07-24)
+
+## Outcome
+
+`Canvas.from` now uses **logical bounds for x-extent** (matching
+EA's canvas left/right exactly) while still unioning **logical +
+image_bounds for y-extent** (image_bounds extends below bounds
+for shadow/padding).
+
+Waterway width: 1163 → **1138** (matches ref exactly).
+Waterway height: 899 (ref=892, within 7).
+Building width: 1381 (ref=1406, within 25).
+Bridge width: 1292 (ref=1305, within 13).
+
+## Files changed
+
+- `lib/ea/svg/ea_emitter/canvas.rb` — split x/y source rules
+- `spec/ea/svg/ea_emitter/canvas_spec.rb` — unchanged, still passes

data/TODO.fixup/11-layer-sequencer-extraction.md

@@ -0,0 +1,18 @@
+# 11 - Layer Sequencer Extraction
+
+## Status: DONE (2026-07-24)
+
+## Outcome
+
+`Ea::Svg::EaEmitter::LayerSequencer` takes ownership of layer
+ordering. Document shrinks to SVG envelope construction (~15 lines).
+
+LayerSequencer exposes `layers` returning Array<String>; internally
+composes Elements + Connectors + Markers + Labels, and merges
+same-style Layer structs.
+
+## Files changed
+
+- `lib/ea/svg/ea_emitter/layer_sequencer.rb` — NEW sequencer
+- `lib/ea/svg/ea_emitter.rb` — autoload registration
+- `lib/ea/svg/ea_emitter/document.rb` — delegates to LayerSequencer

data/TODO.fixup/12-path-style-harmony.md

@@ -0,0 +1,23 @@
+# 12 - Connector Path Style Harmony
+
+## Status: DONE (2026-07-24)
+
+## Outcome
+
+New `Ea::Svg::EaEmitter::Style` module centralizes style strings:
+- `BACKGROUND` — white fill, no stroke
+- `CONNECTOR_LINE` — used for line paths AND arrow paths
+- `DIAMOND_FILLED` — aggregation/composition diamond polygons
+- `TRIANGLE_OPEN` — generalization/realization triangles
+- `TEXT_GROUP` — text wrapper `<g>`
+- `ELEMENT_SHAPE_*` — shape stroke constants
+
+`Connectors::LINE_STYLE` and `Markers::STYLE_MAP` reference Style
+constants — single source of truth (DRY).
+
+## Files changed
+
+- `lib/ea/svg/ea_emitter/style.rb` — NEW constants module
+- `lib/ea/svg/ea_emitter.rb` — autoload registration
+- `lib/ea/svg/ea_emitter/connectors.rb` — references Style::CONNECTOR_LINE
+- `lib/ea/svg/ea_emitter/markers.rb` — STYLE_MAP references Style

data/TODO.fixup/13-datatype-stereotype-fallback.md

@@ -0,0 +1,28 @@
+# 13 - DataType Stereotype Fallback for Klass
+
+## Status: DONE (2026-07-25)
+
+## Outcome
+
+`Element::HeaderLines#for` now always emits a stereotype label as
+the first header line. When the classifier has no explicit
+stereotype_refs, falls back to a type-derived label:
+
+- `Ea::Model::Klass` → `«DataType»`
+- `Ea::Model::Enumeration` → `«enumeration»`
+- `Ea::Model::DataType` → `«DataType»`
+- `Ea::Model::PrimitiveType` → `«primitive»`
+- `Ea::Model::Interface` → `«interface»`
+
+For abstract Klasses the abstract name (`_Name`) is still italic;
+for concrete Klasses the name is bold.
+
+## Outcome metrics
+
+Mean text abs diff across 185 diagrams: **14 → 7** (50% reduction).
+CityFurniture text count: 30 → **34** (exact match).
+Waterway text count: 103 → **111** (ref=113, within 2).
+
+## Files changed
+
+- `lib/ea/svg/ea_emitter/element/header_lines.rb` — fallback rule