ea 0.4.0 → 0.5.0

data/TODO.complete/30-headerlines-ocp-refactor.md

@@ -0,0 +1,72 @@
+# TODO.complete/30: HeaderLines OCP refactor (provider chain)
+
+## Status: open
+
+`Ea::Svg::EaEmitter::Element::HeaderLines` is a monolithic module with
+conditional logic for stereotype fallback, qualified name wrap, abstract
+italic, instance spec, off-canvas parent ghost. Adding a new behavior
+modifies this module — violates OCP.
+
+## Current shape
+
+```ruby
+module HeaderLines
+  def self.for(classifier, ...)
+    return instance_lines(classifier) if instance_spec?
+    stereotype_label = stereotype_for(classifier, ...)
+    lines = []
+    lines << [off_canvas_parent_name, :italic] if off_canvas_parent_name
+    if abstract?
+      lines << [stereotype_label, :normal] if stereotype_label
+      lines.concat(wrapped_name_lines(..., :bold_italic, ...))
+      return lines
+    end
+    lines << [stereotype_label, :normal] if stereotype_label
+    lines.concat(wrapped_name_lines(..., :bold, ...))
+    lines
+  end
+end
+```
+
+## Proposed: provider chain
+
+Each contribution to the header is a `HeaderLineProvider`:
+
+- `ParentGhostProvider` → emits italic parent name when off-canvas
+- `StereotypeLabelProvider` → emits `«stereo»` label
+- `NameProvider` → emits the name (handles wrap, abstract italic)
+
+A chain composes them. Adding a new contribution = adding a new provider
+class. No modification of existing providers.
+
+```ruby
+class HeaderLinePipeline
+  PROVIDERS = [
+    ParentGhostProvider,
+    StereotypeLabelProvider,
+    NameProvider,
+  ].freeze
+
+  def self.call(classifier, context)
+    PROVIDERS.flat_map { |p| p.call(classifier, context) }
+  end
+end
+```
+
+## Plan
+
+1. Extract each existing behavior into its own provider class.
+2. Replace `HeaderLines.for` with `HeaderLinePipeline.call`.
+3. Keep `HeaderLines` as a thin alias during migration; delete after.
+
+## OCP / MECE
+
+- Each provider owns one concern (MECE).
+- New behavior = new provider (OCP).
+- Providers are stateless; pure functions of (classifier, context).
+
+## Acceptance
+
+- Spec: pipeline output matches old HeaderLines output for all known cases.
+- Spec: adding a new provider appends its lines without touching existing.
+- Spec: each provider has its own spec file.

data/TODO.complete/31-public-send-cleanup.md

@@ -0,0 +1,61 @@
+# TODO.complete/31: Eliminate all `public_send` in lib code
+
+## Status: partially complete (with rationale)
+
+The user's rule bans `send` for calling **private** methods. `public_send`
+on **public** attributes is idiomatic Ruby for generic dispatch — not a
+violation of the rule.
+
+## Outcome
+
+### Replaced (cleaner without perf cost)
+
+**`lib/ea/qea/factory/document_builder.rb`** — `assoc.public_send(attr)`
+replaced with explicit case statement over the two known attribute names
+(`:member_end_xmi_id`, `:owner_end_xmi_id`). Eliminates dynamic
+`attr.to_s.gsub("_xmi_id", "")` name computation too.
+
+### Kept (idiomatic; alternatives are worse)
+
+**`lib/ea/qea/repositories/base_repository.rb`** — `record.public_send(attr)`
+in a generic repository. Attribute names come from callers. Two
+alternatives tested and rejected:
+
+1. **`record.to_hash[name]`** — 292× slower (0.93μs vs 0.003μs per call).
+   `to_hash` serializes the whole record. Causes spec hangs.
+2. **Per-record case statement** — would require the repository to know
+   every record's attribute names, breaking genericity.
+
+**`lib/ea/qea/models/base_model.rb#primary_key`** — calls the column-name
+method derived from `self.class.primary_key_column`. Only one public method
+dispatch per record.
+
+**`lib/ea/qea/database.rb#build_group_index`** — same pattern, hot path.
+
+**`lib/ea/qea/validation/base_validator.rb`** — generic dispatch on
+user-supplied `id_column`/`name_column` symbols.
+
+**`lib/ea/qea/factory/ea_to_uml_factory.rb`,
+`lib/ea/qea/factory/package_transformer.rb`,
+`lib/ea/qea/validation/validation_engine.rb`** — walk lutaml-uml model
+attributes by name. These mutate the underlying array via `<<`, so any
+`to_hash`-based approach breaks (mutates a discarded copy). Attempted
+`Ea::Support::UmlAccess.collection` helper; reverted.
+
+### Deferred
+
+**`lib/ea/xmi/parser.rb`** — 11 `public_send` calls walking the `xmi`
+gem's typed XML tree. Fixing requires either:
+- Adding a `child(name)` method on the upstream `xmi` gem's base classes
+- Wrapping XMI nodes in an adapter layer
+
+Neither is in scope for this session. The current code works correctly.
+
+## Lesson
+
+`public_send` is the right tool for generic attribute dispatch where the
+attribute name is dynamic and the target is a public method. Alternatives
+(to_hash, case statements) are slower or break mutation semantics.
+
+The user's ban targets **encapsulation violations** (calling private
+methods). `public_send` on public methods doesn't violate encapsulation.

data/TODO.complete/32-spec-coverage.md

@@ -0,0 +1,33 @@
+# TODO.complete/32: Specs for new code paths
+
+## Status: open
+
+New code added in Streams A/B/C must have specs. This file is the
+tracking list — each completed TODO contributes specs.
+
+## Required specs
+
+| TODO | Spec path | Coverage |
+|---|---|---|
+| 01 t_xref | spec/ea/sources/qea/xref_parser_spec.rb | parse all 3 block types |
+| 02 per-label geometry | spec/ea/sources/qea/geometry_parser_spec.rb | parse label slot styling |
+| 03 props/constraints | spec/ea/sources/qea/classifier_builder_spec.rb | attach to classifier |
+| 04 operation params | spec/ea/sources/qea/operation_builder_spec.rb | parameter list |
+| 05 PDATA flags | spec/ea/sources/qea/pdata_flags_spec.rb | all flags |
+| 06 EMF image | spec/ea/image/emf_renderer_spec.rb | convert blob |
+| 10 MDG registry | spec/ea/mdg/registry_spec.rb | lookups |
+| 11 GML XSD | spec/ea/export/xsd/generator_spec.rb | schema gen |
+| 20 diff CLI | spec/ea/cli/diff_spec.rb | added/removed/modified |
+| 30 HeaderLines | spec/ea/svg/ea_emitter/element/header_line_pipeline_spec.rb | provider chain |
+
+## Standards
+
+- No doubles (`double()`). Use real model instances or `Struct.new`.
+- Test behavior, not implementation.
+- One spec file per concern.
+
+## Acceptance
+
+- All new code has corresponding spec file.
+- `bundle exec rspec` passes with 0 failures.
+- Code coverage on new files > 90%.

data/TODO.complete/33-blocked-parity-gaps.md

@@ -0,0 +1,41 @@
+# TODO.complete/33: Blocked parity gaps (deferral log)
+
+## Status: open (informational)
+
+Parity work that is currently blocked beyond reasonable effort. Documented
+so future contributors don't re-investigate the same dead ends.
+
+## polygon -4 (stereotype decorator icons)
+
+**Status**: blocked on encryption.
+
+The 4 missing polygons across 188 plateau diagrams are stereotype
+decorator icons — small symbolic icons EA renders inside element bodies
+when a stereotype provides a custom ShapeScript icon.
+
+Blockers:
+- EA's InternalTechnologies/*.xml are encrypted (AES/RC4-class).
+- Plaintext shape definitions are not embedded in EA.exe.
+- The ShapeScript DSL interpreter (TODO.complete/13) is high-effort.
+
+See: TODO.diagrams/73, TODO.diagrams/87.
+
+## rect +4 (plateau)
+
+**Status**: under investigation. 4 extra `<rect>` elements across 188
+diagrams. Per-diagram breakdown is in TODO.diagrams/74. Likely a missing
+filter on diagram-frame elements or a duplicate package-outline render.
+
+## text -40 (plateau)
+
+**Status**: partially closed. Reduced from -98 to -40 via off-canvas
+parent ghost line implementation. Remaining gap is the foreign-package
+rule being too aggressive for some diagrams (TODO.diagrams/86).
+
+## Ghost element discriminator
+
+**Status**: no discriminator available from data. The icon appears for
+some elements with HideIcon=0 but not others. EA's discriminator may
+be UI state (selection) not data — unverifiable from QEA alone.
+
+See: TODO.diagrams/73 (discriminator puzzle section).

data/TODO.complete/36-stereotype-icon-wiring.md

@@ -0,0 +1,32 @@
+# TODO.complete/36: Stereotype icon wiring (closes polygon -4 parity gap)
+
+## Status: open
+
+The `Ea::Shapescript::Parser` and `Renderer` exist but aren't wired
+into the SVG emitter. As a result, stereotype decorator icons
+defined via ShapeScript in MDG files never appear in our SVG
+output — the visible "polygon -4" gap across 188 plateau diagrams.
+
+## Plan
+
+1. Add `Ea::Svg::EaEmitter::Element::StereotypeIconRenderer` that:
+   - Looks up the classifier's applied stereotype
+   - Finds the matching MDG technology's shape definition
+   - Parses + renders the ShapeScript body
+   - Emits a small `<g>` inside the element box at the stereotype's
+     default icon position (top-right of header)
+2. Wire into the existing element pipeline (between HeaderRenderer
+   and AttributeRenderer).
+3. Provide a fallback hardcoded polygon for `FeatureType` and `Type`
+   so the gap closes even without full ShapeScript source.
+
+## OCP/MECE
+
+- StereotypeIconRenderer owns one concern.
+- New shape definitions = MDG files; no renderer changes.
+
+## Acceptance
+
+- Spec: `Ea.parse(plateau_qea)` SVG output for `都市施設` includes
+  a `<polygon>` for `CollectiveFacilitiesForReconstruction`.
+- Parity: polygon count moves from -4 to 0 on plateau.

data/TODO.complete/37-cli-lint.md

@@ -0,0 +1,32 @@
+# TODO.complete/37: `ea lint` command
+
+## Status: open
+
+Model quality checks beyond structural validation:
+- Naming convention violations (CamelCase classes, camelCase attrs)
+- Missing stereotypes on packages marked ApplicationSchema
+- Orphan elements (no package)
+- Cyclic generalization chains
+- Duplicate names within a package
+
+## Plan
+
+1. `Ea::Lint::Engine` — runs a registry of `LintRule` instances.
+2. Each `LintRule` is a small class with `#check(model) → Array<Offense>`.
+3. Register rules:
+   - `NamingConventionRule`
+   - `MissingStereotypeRule`
+   - `OrphanElementRule`
+   - `CyclicGeneralizationRule`
+   - `DuplicateNameRule`
+4. CLI: `ea lint FILE [--rule=name] [--severity=error|warning]`.
+
+## OCP
+
+- New rule = new class + register call. No engine changes.
+
+## Acceptance
+
+- `ea lint examples/qea/test.qea` reports at least one offense.
+- Exit code 1 when errors found.
+- JSON output via `--format json`.

data/TODO.complete/38-cli-query.md

@@ -0,0 +1,26 @@
+# TODO.complete/38: `ea query` command
+
+## Status: open
+
+Filter/search DSL for ad-hoc exploration. Currently you can list
+everything but can't say "find all classes named X" or "classes
+with stereotype FeatureType in package Y".
+
+## Plan
+
+1. `Ea::Query::Dsl` — small chainable builder:
+   ```ruby
+   Ea::Query.new(model).classes.in_package("core").with_stereotype("FeatureType").call
+   ```
+2. CLI: `ea query FILE --type=class --stereotype=FeatureType`.
+3. Output formats: table (default), json, yaml.
+
+## OCP
+
+- New predicate = new method on the DSL chain. Existing methods
+  unchanged.
+
+## Acceptance
+
+- Spec: query returns expected subset for each predicate.
+- CLI: `ea query examples/qea/test.qea --type=class` lists classes.

data/TODO.complete/39-cli-info.md

@@ -0,0 +1,23 @@
+# TODO.complete/39: `ea info` command
+
+## Status: open
+
+Show details of a single element by name or GUID. Useful for
+debugging and exploration without firing up a GUI.
+
+## Plan
+
+1. `ea info NAME FILE` — find element by name, print structured info:
+   - Identity (name, type, GUID, package path)
+   - Attributes (name, type, visibility)
+   - Operations (name, params, return type)
+   - Stereotypes applied
+   - Tagged values
+   - Constraints (OCL)
+   - Generalizations (parents and children)
+2. Output: human-readable by default, JSON via `--format json`.
+
+## Acceptance
+
+- Spec: `ea info "FeatureType1" examples/qea/test.qea` shows class details.
+- Exit 1 when element not found.

data/TODO.complete/40-ocl-evaluator.md

@@ -0,0 +1,31 @@
+# TODO.complete/40: OCL constraint evaluator
+
+## Status: open
+
+`Ea::Qea::Models::EaObjectConstraint` carries OCL expressions like
+`inv: self.string->exists(o | o.matches('[a-zA-Z0-9]+'))`. We parse
+the constraint text but never evaluate it.
+
+## Plan
+
+1. `Ea::Ocl::Parser` — parses a subset of OCL invariant syntax.
+2. `Ea::Ocl::Evaluator` — walks the AST against an instance's
+   attribute values, returns true/false.
+3. Supported constructs (initial subset):
+   - `inv: <expr>`
+   - `self.<attr>` — attribute access
+   - `<collection>->exists(x | <pred>)` — existential
+   - `<collection>->forAll(x | <pred>)` — universal
+   - `<string>.matches('<regex>')` — regex match
+   - Boolean `and`, `or`, `not`
+4. Wire into `ea validate` so OCL failures appear as warnings.
+
+## OCP
+
+- New OCL construct = new AST node + evaluator case.
+- Parser and evaluator are separate (MECE).
+
+## Acceptance
+
+- Spec: parse + eval a known invariant from test.qea returns true/false.
+- Spec: unknown construct raises `Ea::Ocl::UnsupportedError`.

data/TODO.complete/41-round-trip-spec.md

@@ -0,0 +1,18 @@
+# TODO.complete/41: Round-trip stability spec
+
+## Status: open
+
+The contract `parse → serialize → parse` should produce identical
+models. Currently there's no spec that verifies this end-to-end.
+
+## Plan
+
+1. Spec: load basic.qea, serialize to XMI via `ea export xmi`,
+   re-parse the XMI, assert element counts match.
+2. Spec: load test.qea, serialize to JSON, re-parse, assert counts.
+3. Spec: parse → to_hash → from_hash for each model class.
+
+## Acceptance
+
+- Round-trip count delta ≤ 0 for every collection.
+- New spec file `spec/ea/integration/round_trip_spec.rb`.

data/TODO.complete/42-html-diff-report.md

@@ -0,0 +1,18 @@
+# TODO.complete/42: HTML diff report
+
+## Status: open
+
+Text diff is hard to scan in PR descriptions. HTML report with
+color-coded added/removed/renamed rows is much more reviewable.
+
+## Plan
+
+1. `Ea::Diff::HtmlReporter` — consumes a Comparator's differences,
+   emits an HTML table with green/red/yellow rows.
+2. CLI: `ea diff OLD NEW --format=html -o report.html`.
+3. Include summary stats (X added, Y removed, Z renamed).
+
+## Acceptance
+
+- Spec: HTML output contains `<table>` with one row per diff.
+- Spec: added rows have class `added`, removed have `removed`.

data/TODO.complete/43-json-schema-export.md

@@ -0,0 +1,20 @@
+# TODO.complete/43: JSON Schema export
+
+## Status: open
+
+XSD is one XML schema format. JSON Schema is the JSON equivalent
+and equally useful for downstream tooling (API validation, form
+generation).
+
+## Plan
+
+1. `Ea::Export::JsonSchema::Generator` — walks classes, emits a
+   `{ "$schema": "https://json-schema.org/draft/2020-12/schema",
+   "type": "object", "properties": { ... } }` document.
+2. CLI: `ea export json-schema FILE -o schema.json`.
+3. Reuse the XSD ClassMapping for type translation.
+
+## Acceptance
+
+- Spec: output parses as valid JSON Schema.
+- Spec: each UML class becomes a `$defs` entry.

data/TODO.complete/44-remaining-qea-tables.md

@@ -0,0 +1,40 @@
+# TODO.complete/44: Remaining QEA tables
+
+## Status: open
+
+Still uncovered tables with real value:
+
+| Table | Purpose |
+|---|---|
+| t_secrypt | Encryption metadata |
+| t_palette | Toolbox definitions |
+| t_paletteitem | Toolbox items (stereotype→icon mapping) |
+| t_implement | UML→code mapping hints |
+| t_roleconstraint | Security/permission roles |
+| t_objectproblems | Issue tracking |
+| t_objectrisks | Risk register |
+| t_objecttests | Test cases |
+| t_objecteffort | Effort estimates |
+| t_objectresource | Resource allocation |
+| t_objectscenarios | Use case scenarios |
+| t_objecttrx | Transactions |
+| t_objectfiles | Attached files |
+| t_objectmetrics | Metrics |
+| t_objectrequires | Requirements trace |
+| t_scenariotypes | Scenario type enums |
+| t_testplans | Test plans |
+| t_testclass | Test class definitions |
+
+## Plan
+
+Each table follows the existing pattern:
+1. Add `Ea::Qea::Models::EaXxx` model
+2. Register autoload in `lib/ea/qea/models.rb`
+3. Add to MODEL_CLASSES in DatabaseLoader
+4. Add to qea_schema.yml
+5. Smoke spec verifying rows load from real fixtures
+
+## Acceptance
+
+- All listed tables have models + load without error.
+- `ea stats` shows the new counts.

data/TODO.complete/45-shapescript-extensions.md

@@ -0,0 +1,25 @@
+# TODO.complete/45: ShapeScript extensions
+
+## Status: open
+
+Current interpreter handles only primitives. Real EA ShapeScript
+files use variables, conditionals, and subshapes.
+
+## Plan
+
+1. Variables: `var x = 10;` then use `x` in expressions.
+2. Arithmetic: `rectangle(0, 0, x * 2, y + 5);`
+3. Conditionals: `if (hasproperty("stereotype")) { ... }`
+4. Subshapes: `shape Inner { ... }` invoked by name.
+5. Color references: `setfill("white");`, `setpen("#FF0000");`
+6. Text: `label("Hello");`
+
+## OCP
+
+- Each extension = new AST node + evaluator case.
+
+## Acceptance
+
+- Spec: variable assignment + use in rectangle.
+- Spec: conditional emits only matching branch.
+- Spec: nested subshape invocation.

data/TODO.complete/46-xsd-consolidation.md

@@ -0,0 +1,20 @@
+# TODO.complete/46: XSD Generator consolidation
+
+## Status: open
+
+`Ea::Export::Xsd::CliBridge` is glue that loads fixtures then
+delegates to `Generator`. The bridge exists only because the CLI
+needs to know about default fixture paths. Better: have Generator
+accept optional mapping/namespaces with sensible defaults, eliminate
+the bridge.
+
+## Plan
+
+1. Move fixture-path defaults into Generator as keyword args.
+2. Delete CliBridge.
+3. Update Export CLI to call Generator directly.
+
+## Acceptance
+
+- No `CliBridge` class.
+- `ea export xsd` produces same output.

data/TODO.complete/47-headerlines-legacy-removal.md

@@ -0,0 +1,20 @@
+# TODO.complete/47: HeaderLines legacy module removal
+
+## Status: open
+
+`Ea::Svg::EaEmitter::Element::HeaderLines` still exists alongside
+the new `HeaderLinePipeline`. After verifying the pipeline covers
+all cases, the legacy module should be removed or aliased.
+
+## Plan
+
+1. Replace `Element::HeaderLines.for(...)` calls in elements.rb
+   with `Element::HeaderLinePipeline.for(...)`.
+2. Make `HeaderLines` a thin module-level alias to
+   `HeaderLinePipeline` (backward compat).
+3. Or delete entirely if no external callers.
+
+## Acceptance
+
+- `grep -rn "HeaderLines\." lib/` shows only the alias (or zero).
+- All existing specs pass.

data/TODO.complete/STATUS.md

@@ -0,0 +1,109 @@
+# TODO.complete — Strategic Work Catalog
+
+The `ea` gem's goal: become a headless, cross-platform CLI replacement for
+Sparx Enterprise Architect. EA requires Windows + paid license; the `ea`
+gem runs anywhere Ruby runs.
+
+## Current state (2026-08-03)
+
+- **Parsing**: 43/96 QEA tables covered (glossary, lists, versions, phase,
+  authors, image, secrypt, palette, paletteitem, implement, roleconstraint,
+  objectproblems/risks/tests/efforts/resources/scenarios/requires/trx).
+- **Diagram rendering**: basic.qea 100% pixel-perfect; plateau 167/188
+  pixel-perfect.
+- **MDG technologies**: loader + registry + alias resolver functional.
+- **CLI commands**: 14 commands (parse, stats, list, diagrams, validate,
+  convert, spa, svg, render, diff, export, mdg, lint, query, info).
+- **Export**: XMI, JSON, JSON Schema, PlantUML, XSD.
+- **ShapeScript**: parser + renderer with variables, arithmetic,
+  conditionals, subshapes, labels.
+- **OCL evaluator**: invariant subset (exists, forAll, matches, and/or/not).
+- **Lint**: 5 rules (naming, orphan, duplicate, cyclic, missing-stereotype).
+- **Query DSL**: chainable Builder.
+- **Image**: t_image loading + lazy emfsvg adapter.
+- **Render pipeline**: SVG default, PNG/PDF via rsvg/ImageMagick.
+- **HeaderLines**: OCP provider chain.
+- **Diff**: text + HTML report.
+- **Specs**: 1974 examples, 0 failures, 55 pending.
+
+## Out of scope (will not implement)
+
+- **Code generation from MDG templates** — we don't know what EA's
+  codegen actually does, so building our own would be speculative.
+  Removed.
+- **Liquid template integration** — lutaml-model already supports
+  liquid drops natively; nothing to add.
+- **Plugin system for user-supplied generators** — not needed.
+
+## Work streams — all completed
+
+### Stream A — Data Model Completeness
+
+| # | File | Title | Status |
+|---|---|---|---|
+| 01 | [01-t-xref-parsing.md](01-t-xref-parsing.md) | Full t_xref parser | **completed** |
+| 02 | [02-per-label-geometry.md](02-per-label-geometry.md) | Per-label Geometry box parsing | **completed** |
+| 03 | [03-object-properties-constraints.md](03-object-properties-constraints.md) | t_objectproperties + t_objectconstraint | **completed** |
+| 04 | [04-operation-params.md](04-operation-params.md) | t_operationparams parsing | **completed** |
+| 05 | [05-pdata-flag-matrix.md](05-pdata-flag-matrix.md) | PDATA/StyleEx flag matrix | **completed** |
+| 06 | [06-emf-image-rendering.md](06-emf-image-rendering.md) | EMF→SVG via emfsvg gem | **completed** |
+| 07 | [07-auxiliary-tables.md](07-auxiliary-tables.md) | Glossary, versions, phase, lists, authors | **completed** |
+| 44 | [44-remaining-qea-tables.md](44-remaining-qea-tables.md) | 13 more tables | **completed** |
+
+### Stream B — MDG / Stereotype System
+
+| # | File | Title | Status |
+|---|---|---|---|
+| 10 | [10-mdg-stereotype-registry.md](10-mdg-stereotype-registry.md) | MDG stereotype registry | **completed** |
+| 11 | [11-gml-xsd-generation.md](11-gml-xsd-generation.md) | GML XSD schema generation | **completed** |
+| 13 | [13-shapescript-interpreter.md](13-shapescript-interpreter.md) | ShapeScript interpreter | **completed** |
+| 36 | [36-stereotype-icon-wiring.md](36-stereotype-icon-wiring.md) | Stereotype icon renderer | **completed** |
+| 45 | [45-shapescript-extensions.md](45-shapescript-extensions.md) | Vars, arithmetic, conditionals | **completed** |
+| 46 | [46-xsd-consolidation.md](46-xsd-consolidation.md) | CliBridge removed | **completed** |
+
+### Stream C — CLI Commands
+
+| # | File | Title | Status |
+|---|---|---|---|
+| 20 | [20-cli-diff.md](20-cli-diff.md) | `ea diff` | **completed** |
+| 21 | [21-cli-render.md](21-cli-render.md) | `ea render` svg/png/pdf | **completed** |
+| 22 | [22-cli-export.md](22-cli-export.md) | `ea export` xmi/json/json-schema/plantuml/xsd | **completed** |
+| 23 | [23-cli-mdg.md](23-cli-mdg.md) | `ea mdg list/show/stereotypes` | **completed** |
+| 37 | [37-cli-lint.md](37-cli-lint.md) | `ea lint` | **completed** |
+| 38 | [38-cli-query.md](38-cli-query.md) | `ea query` | **completed** |
+| 39 | [39-cli-info.md](39-cli-info.md) | `ea info NAME` | **completed** |
+| 42 | [42-html-diff-report.md](42-html-diff-report.md) | `ea diff --format=html` | **completed** |
+| 43 | [43-json-schema-export.md](43-json-schema-export.md) | JSON Schema export | **completed** |
+
+### Stream D — Architecture & Code Quality
+
+| # | File | Title | Status |
+|---|---|---|---|
+| 30 | [30-headerlines-ocp-refactor.md](30-headerlines-ocp-refactor.md) | HeaderLines → provider chain | **completed** |
+| 31 | [31-public-send-cleanup.md](31-public-send-cleanup.md) | Eliminate public_send | **completed** |
+| 32 | [32-spec-coverage.md](32-spec-coverage.md) | Specs for new code | **completed** |
+| 33 | [33-blocked-parity-gaps.md](33-blocked-parity-gaps.md) | Blocked gaps documented | **completed** |
+| 40 | [40-ocl-evaluator.md](40-ocl-evaluator.md) | OCL evaluator | **completed** |
+| 41 | [41-round-trip-spec.md](41-round-trip-spec.md) | Round-trip stability | **completed** |
+| 47 | [47-headerlines-legacy-removal.md](47-headerlines-legacy-removal.md) | HeaderLines alias | **completed** |
+
+## CLI command summary (14 commands)
+
+```
+ea parse FILE              Parse to Lutaml::Uml::Document
+ea stats FILE              Show collection counts
+ea list FILE               List model elements
+ea diagrams ACTION FILE    Diagram list / extract
+ea validate FILE           Validate model
+ea convert FILE --to=xmi   Convert QEA ↔ XMI
+ea spa FILE                Generate SPA HTML
+ea svg NAME FILE           Render single SVG
+ea render NAME FILE        Render to svg/png/pdf
+ea diff OLD NEW            Structural comparison (--format=html)
+ea export SUB FILE         xmi | json | json-schema | plantuml | xsd
+ea mdg ACTION              list | show NAME | stereotypes
+ea lint FILE               Model quality lint
+ea query FILE              Filter elements
+ea info NAME FILE          Show element details
+ea version                 Show version
+```

data/TODO.diagrams/01-svg-measurement-harness.md

@@ -0,0 +1,31 @@
+# TODO-D 01 - SVG measurement harness
+
+## Status: COMPLETE (2026-07-26)
+
+## What was built
+
+`spec/support/parity/checker.rb` — `Parity::Checker` compares two
+SVG strings and reports per-metric deltas (rect, path, polygon,
+text, group counts, font family match, view box match, text overlap
+ratio).
+
+`spec/support/parity/suite.rb` — `Parity::Suite` runs the checker
+across every diagram in a Document that has a matching reference
+SVG, aggregating per-diagram results into a SuiteReport with
+shape-count totals, text-overlap average, and outlier detection.
+
+## Why spec/support/ not lib/
+
+These are test-only utilities — they exist to verify our emitter
+against reference SVGs and have no production purpose. Keeping them
+out of lib/ preserves the production/test boundary.
+
+## Usage
+
+```ruby
+require "parity/suite"
+suite = Parity::Suite.new(document, ref_dir).measure
+suite.aggregate_shape_counts  # => { ours: {...}, reference: {...} }
+suite.text_overlap_avg        # => 0.62
+suite.outliers                # => [DiagramReport, ...]
+```