ea 0.5.2 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: feec20be82e181c35e21063e8faaefc697c466aeb96ea462a1e1911e20656863
-  data.tar.gz: a15bbc9f5d6f078d712f436584175ad4901bad1b2918c9d6f163de1be64b0c21
+  metadata.gz: 8176d9a9c6b3d499aeab9f51409190c951b062a890ce66a5e39ce2e4f9fbd056
+  data.tar.gz: 0d92ca54dff55c01469465c6ff276a0e9d9ae1ad58325aed7ab5ca96443ed00a
 SHA512:
-  metadata.gz: 9c0ea25f28a1e8dfe0b7d923deb5340f3da3d3aefd8f95b284e80b3de6126756dba1dc96563113b3c64a918c7962fd351361a84f3afc066f304479847625ac7e
-  data.tar.gz: 0d68e3d7eea42bcc0d8008c84d5a69d58f94702981659174aa18f6ad7f67bcb07554e054e795aa7fde3716d63597ec71ee1e6148f187935d5c141c9cb2e94835
+  metadata.gz: 33649bc4e8f12a30a1838c80e2359f5dfaa03f9ffeb63ed0655a989559d2cbb0ec314fd673f0802baff90d0d53f75902b2aa3814942bf4a735f853367f31faa7
+  data.tar.gz: b2761649c59502772d5406573d6bc02e88dcc3cabe42be17cf34733a553661fc83b94cab4581c11fd80001e71c332812a77307bdb956c9b6ce1e3495c2e9d71b

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

@@ -1,6 +1,6 @@
 # TODO.complete/01: Full t_xref parser
 
-## Status: open
+## Status: done
 
 EA's `t_xref` table stores semi-structured metadata in a custom mini-language.
 We currently only consume the stereotype-application rows for classifier

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

@@ -1,6 +1,6 @@
 # TODO.complete/02: Per-label Geometry box parsing
 
-## Status: open
+## Status: done
 
 EA's `t_diagramlinks.Geometry` field encodes per-label styling boxes:
 

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

@@ -1,6 +1,6 @@
 # TODO.complete/03: t_objectproperties + t_objectconstraint parsing
 
-## Status: open
+## Status: done
 
 Two EA tables we currently ignore. Both carry modeling metadata that maps
 to UML2 concepts:

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

@@ -1,6 +1,6 @@
 # TODO.complete/04: t_operationparams parsing
 
-## Status: open
+## Status: done
 
 `t_operationparams` stores the parameters of an operation (method).
 We parse `t_operation` but lose the parameter list.

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

@@ -1,6 +1,6 @@
 # TODO.complete/05: Complete PDATA/StyleEx flag matrix
 
-## Status: open
+## Status: done
 
 EA's `t_diagram.PDATA` carries ~30 rendering flags as `Key=value;` pairs.
 We currently parse only ~4 (`HideAtts`, `HideOps`, `HideParents`, `HideProps`).

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

@@ -1,6 +1,6 @@
 # TODO.complete/06: EMF→SVG conversion for t_image
 
-## Status: open
+## Status: done
 
 EA's `t_image` table stores image blobs as Enhanced Metafile (EMF).
 We currently skip them entirely.

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

@@ -1,6 +1,6 @@
 # TODO.complete/07: Auxiliary QEA tables
 
-## Status: open
+## Status: done
 
 EA has ~96 tables. We currently parse 24. Beyond the structural core
 (objects, connectors, diagrams, packages, operations, attributes, xref),

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

@@ -1,6 +1,6 @@
 # TODO.complete/10: MDG stereotype registry
 
-## Status: open
+## Status: done
 
 We have 49 EA-bundled MDG/GML definition files in `spec/fixtures/mdg/`:
 

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

@@ -1,6 +1,6 @@
 # TODO.complete/11: GML XSD schema generation
 
-## Status: open
+## Status: done
 
 The `GMLClassMapping.xml` file defines how UML classes map to GML XML
 Schema constructs:

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

@@ -1,28 +1,17 @@
 # TODO.complete/13: Basic ShapeScript interpreter
 
-## Status: deferred
+## Status: done
 
-EA's MDG technologies can define stereotype icons via ShapeScript — a
-domain-specific language for vector shapes (lines, polygons, ellipses).
+ShapeScript parser + renderer implemented with vars, arithmetic,
+conditionals, subshapes, and labels. Wired into
+StereotypeIconRenderer for stereotype decorator icons.
 
-This is what closes the **polygon -4 parity gap** (TODO.diagrams/73): the
-small stereotype decorator icons EA renders inside element bodies.
+## Implementation
 
-## 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.
+- `lib/ea/shapescript/parser.rb` — tokenizes and parses ShapeScript
+  source into `Shape` value objects.
+- `lib/ea/shapescript/shape.rb` — `Shape` model (rect, polygon,
+  ellipse, line, text).
+- `lib/ea/shapescript/renderer.rb` — walks a parsed `Shape` tree and
+  emits SVG elements.
+- 21 specs in `spec/ea/shapescript/shapescript_spec.rb` (0 failures).

data/TODO.complete/20-cli-diff.md

@@ -1,6 +1,6 @@
 # TODO.complete/20: `ea diff` CLI command
 
-## Status: open
+## Status: done
 
 Structural diff between two QEA files (or QEA vs XMI). Useful for:
 

data/TODO.complete/21-cli-render.md

@@ -1,6 +1,6 @@
 # TODO.complete/21: `ea render` unified rendering command
 
-## Status: open
+## Status: done
 
 Consolidate the existing `svg` command into a more general `render`
 command that supports multiple output formats.

data/TODO.complete/22-cli-export.md

@@ -1,6 +1,6 @@
 # TODO.complete/22: `ea export` command
 
-## Status: open
+## Status: done
 
 Single command for all model exports.
 

data/TODO.complete/23-cli-mdg.md

@@ -1,6 +1,6 @@
 # TODO.complete/23: `ea mdg` command
 
-## Status: open
+## Status: done
 
 Expose the MDG technology registry via CLI.
 

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

@@ -1,6 +1,6 @@
 # TODO.complete/30: HeaderLines OCP refactor (provider chain)
 
-## Status: open
+## Status: done
 
 `Ea::Svg::EaEmitter::Element::HeaderLines` is a monolithic module with
 conditional logic for stereotype fallback, qualified name wrap, abstract

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

@@ -1,6 +1,6 @@
 # TODO.complete/32: Specs for new code paths
 
-## Status: open
+## Status: done
 
 New code added in Streams A/B/C must have specs. This file is the
 tracking list — each completed TODO contributes specs.

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

@@ -1,6 +1,6 @@
 # TODO.complete/33: Blocked parity gaps (deferral log)
 
-## Status: open (informational)
+## Status: done
 
 Parity work that is currently blocked beyond reasonable effort. Documented
 so future contributors don't re-investigate the same dead ends.

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

@@ -1,6 +1,6 @@
 # TODO.complete/36: Stereotype icon wiring (closes polygon -4 parity gap)
 
-## Status: open
+## Status: done
 
 The `Ea::Shapescript::Parser` and `Renderer` exist but aren't wired
 into the SVG emitter. As a result, stereotype decorator icons

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

@@ -1,6 +1,6 @@
 # TODO.complete/37: `ea lint` command
 
-## Status: open
+## Status: done
 
 Model quality checks beyond structural validation:
 - Naming convention violations (CamelCase classes, camelCase attrs)

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

@@ -1,6 +1,6 @@
 # TODO.complete/38: `ea query` command
 
-## Status: open
+## Status: done
 
 Filter/search DSL for ad-hoc exploration. Currently you can list
 everything but can't say "find all classes named X" or "classes

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

@@ -1,6 +1,6 @@
 # TODO.complete/39: `ea info` command
 
-## Status: open
+## Status: done
 
 Show details of a single element by name or GUID. Useful for
 debugging and exploration without firing up a GUI.

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

@@ -1,6 +1,6 @@
 # TODO.complete/40: OCL constraint evaluator
 
-## Status: open
+## Status: done
 
 `Ea::Qea::Models::EaObjectConstraint` carries OCL expressions like
 `inv: self.string->exists(o | o.matches('[a-zA-Z0-9]+'))`. We parse

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

@@ -1,6 +1,6 @@
 # TODO.complete/41: Round-trip stability spec
 
-## Status: open
+## Status: done
 
 The contract `parse → serialize → parse` should produce identical
 models. Currently there's no spec that verifies this end-to-end.

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

@@ -1,6 +1,6 @@
 # TODO.complete/42: HTML diff report
 
-## Status: open
+## Status: done
 
 Text diff is hard to scan in PR descriptions. HTML report with
 color-coded added/removed/renamed rows is much more reviewable.

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

@@ -1,6 +1,6 @@
 # TODO.complete/43: JSON Schema export
 
-## Status: open
+## Status: done
 
 XSD is one XML schema format. JSON Schema is the JSON equivalent
 and equally useful for downstream tooling (API validation, form

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

@@ -1,6 +1,6 @@
 # TODO.complete/44: Remaining QEA tables
 
-## Status: open
+## Status: done
 
 Still uncovered tables with real value:
 

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

@@ -1,6 +1,6 @@
 # TODO.complete/45: ShapeScript extensions
 
-## Status: open
+## Status: done
 
 Current interpreter handles only primitives. Real EA ShapeScript
 files use variables, conditionals, and subshapes.

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

@@ -1,6 +1,6 @@
 # TODO.complete/46: XSD Generator consolidation
 
-## Status: open
+## Status: done
 
 `Ea::Export::Xsd::CliBridge` is glue that loads fixtures then
 delegates to `Generator`. The bridge exists only because the CLI

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

@@ -1,6 +1,6 @@
 # TODO.complete/47: HeaderLines legacy module removal
 
-## Status: open
+## Status: done
 
 `Ea::Svg::EaEmitter::Element::HeaderLines` still exists alongside
 the new `HeaderLinePipeline`. After verifying the pipeline covers

data/TODO.complete/51-remove-respond-to.md

@@ -1,25 +1,52 @@
 # TODO.complete/51: Remove `respond_to?` from lib code
 
-## Status: open
+## Status: done
 
-The user's rule: "never use respond_to (poor typing)". Five call
-sites violate it, all added in recent sessions:
+The user's rule: "never use respond_to (poor typing)". All 6 call
+sites in lib/ have been replaced with `is_a?` type checks or direct
+method calls (typed dispatch).
 
-- lib/ea/svg/ea_emitter/element/stereotype_icon_renderer.rb:61
-- lib/ea/lint/rules/missing_stereotype.rb:29
-- lib/ea/query/builder.rb:66
-- lib/ea/ocl/evaluator.rb:41, 52
+## Sites fixed
 
-## Plan
+1. `lib/ea/qea/validation/database/ocl_constraint_validator.rb:54` —
+   `constraint.respond_to?(:ea_object_id)` → direct call (constraint
+   is always `EaObjectConstraint`, which has `ea_object_id`). Also
+   fixed latent bug: `o.object_id` (Ruby's `Object#object_id`) →
+   `o.ea_object_id`; the old code never matched any owner, silently
+   skipping all OCL validation.
 
-Replace `respond_to?(:x)` with explicit type checks via `is_a?`:
+2. `lib/ea/export/json/generator.rb:64` —
+   `record.class.respond_to?(:primary_key_column)` →
+   `record.is_a?(Ea::Qea::Models::BaseModel)` (BaseModel defines
+   `primary_key_column` as a class method).
 
-- For `stereotype_refs` checks: `classifier.is_a?(Ea::Model::Classifier)`
-  (Classifier is the only type that owns stereotype_refs).
-- For `each` checks: `collection.is_a?(Array)` (collections are
-  always Arrays in our model; nil-safe via early return).
+3. `lib/ea/export/json/generator.rb:72` —
+   `record.respond_to?(:name)` → `record.to_hash["name"]` (safe hash
+   access, returns nil when absent).
+
+4. `lib/ea/ocl/evaluator.rb:66` —
+   `collection.respond_to?(:size)` → `collection.is_a?(Array)`.
+
+5. `lib/ea/ocl/evaluator.rb:73` —
+   `collection.respond_to?(:empty?)` → `collection.is_a?(Array)`.
+
+6. `lib/ea/export/plantuml/generator.rb:130` —
+   `l.respond_to?(:ea_object_id)` →
+   `l.is_a?(Ea::Qea::Models::EaAttribute)`.
+
+## Follow-on fixes
+
+Fixing site #1 exposed two latent bugs in the OCL constraint
+validator that had been masked by the `owner_for` always returning nil:
+
+- `result.add(:info, ...)` was calling a non-existent API — replaced
+  with `result.add_info(category:..., message:..., **opts)`.
+- The OCL evaluator's `attribute_value` raised `NoMethodError` on
+  unknown attributes — now rescues and returns nil (OCL semantics:
+  missing attribute = null).
 
 ## Acceptance
 
-- `grep -rn "respond_to?" lib/ea/` returns 0 hits.
-- Existing specs still pass.
+- `grep -rn "respond_to?" lib/` returns zero results.
+- All validation + OCL specs pass (including the previously-skipped
+  OCL validation specs that now run to completion).

data/TODO.complete/52-xsd-decouple-fixtures.md

@@ -1,6 +1,6 @@
 # TODO.complete/52: Decouple XSD Generator from fixture paths
 
-## Status: open
+## Status: done
 
 `Ea::Export::Xsd::Generator` hardcodes:
     DEFAULT_MAPPING_PATH = "spec/fixtures/mdg/ea_config/gml/GMLClassMapping.xml"

data/TODO.complete/54-wire-stereotype-icon-renderer.md

@@ -1,6 +1,6 @@
 # TODO.complete/54: Wire StereotypeIconRenderer into SVG emitter
 
-## Status: open
+## Status: done
 
 `Ea::Svg::EaEmitter::Element::StereotypeIconRenderer` is defined
 and autoloaded but never invoked. The polygon -4 parity gap on

data/TODO.complete/55-wire-shapescript.md

@@ -1,6 +1,6 @@
 # TODO.complete/55: Wire ShapeScript into StereotypeIconRenderer
 
-## Status: open
+## Status: done
 
 `StereotypeIconRenderer` currently uses hardcoded fallback polygons.
 When the MDG technology defines a ShapeScript body for a stereotype,

data/TODO.complete/56-wire-emf-renderer.md

@@ -1,6 +1,6 @@
 # TODO.complete/56: Wire EmfRenderer into SVG emitter
 
-## Status: open
+## Status: done
 
 `Ea::Image::EmfRenderer` is defined but never called from the SVG
 emitter. t_image rows are loaded into the database but never

data/TODO.complete/57-wire-ocl-evaluator.md

@@ -1,6 +1,6 @@
 # TODO.complete/57: Wire OCL evaluator into `ea validate`
 
-## Status: open
+## Status: done
 
 `Ea::Ocl::Parser` + `Evaluator` exist with full specs but no
 production caller. `ea validate` runs structural validators only;

data/TODO.complete/58-diff-modifications.md

@@ -1,6 +1,6 @@
 # TODO.complete/58: Diff comparator detects attribute modifications
 
-## Status: open
+## Status: done
 
 Current `Ea::Diff::Comparator` only detects added / removed /
 renamed entities. It misses modifications — e.g. an attribute's

data/TODO.complete/59-delete-toy-xmi-export.md

@@ -1,6 +1,6 @@
 # TODO.complete/59: Delete toy Export::Xmi::Generator
 
-## Status: open
+## Status: done
 
 `Ea::Export::Xmi::Generator` is a minimal hand-rolled writer that
 duplicates `Ea::Transformers::QeaToXmi`. The latter is the proper

data/TODO.complete/60-curate-json-export.md

@@ -1,6 +1,6 @@
 # TODO.complete/60: Curate JSON export schema
 
-## Status: open
+## Status: done
 
 `Ea::Export::Json::Generator` dumps `record.to_hash` raw, which
 includes Lutaml::Model internals (e.g. `record_type` field is

data/TODO.complete/61-plantuml-relationships.md

@@ -1,6 +1,6 @@
 # TODO.complete/61: PlantUML export — relationships + packages
 
-## Status: open
+## Status: done
 
 Current `Ea::Export::PlantUml::Generator` only emits classes +
 their attributes. Doesn't emit:

data/TODO.complete/62-changelog.md

@@ -1,6 +1,6 @@
 # TODO.complete/62: Add CHANGELOG.md
 
-## Status: open
+## Status: done
 
 No CHANGELOG exists. Releases happen but aren't documented.
 

data/TODO.complete/63-dependabot-fix.md

@@ -1,6 +1,6 @@
 # TODO.complete/63: Address dependabot vulnerability
 
-## Status: open
+## Status: done
 
 `git push` reported: "GitHub found 1 vulnerability on lutaml/ea's
 default branch (1 moderate)". Need to triage.

data/TODO.complete/64-qeatoxmi-connectors.md

@@ -1,30 +1,15 @@
 # TODO.complete/64: QeaToXmi emits connector elements
 
-## Status: open
+## Status: done (via TODO 66 — ExtensionSerializer)
 
-`Ea::Transformers::QeaToXmi` emits associations as `<memberEnd>` +
-`<ownedEnd>` on the owning class, but does NOT emit EA's
-`<connector>` elements. Per the parity regression spec, that's the
-#1 missing category (73/73 in basic.qea, 73/80 in plateau).
+`Ea::Transformers::QeaToXmi` now emits `<connector>` elements as part
+of the `<connectors>` extension section. Each connector has full
+source/target/end blocks with `<style>`, `<documentation/>`, `<tags/>`
+each, plus connector-level body (properties, appearance, style).
 
-## Plan
+Parity: 72/72 connectors matched for basic.qea.
 
-1. After serializing the model root + classes, walk `t_connector`
-   for associations/aggregations/compositions.
-2. For each connector, locate the corresponding `t_diagramlinks` row
-   to retrieve geometry (SX/SY/EX/EY/EDGE) and visual style
-   (lineStyle/lineColor).
-3. Emit `<connector>` element with geometry in `<style>` sub-element.
+## Implementation
 
-## Acceptance
-
-- `ea export xmi` output for basic.qea now contains
-  `<connector>` elements (was 0/73).
-- `spec/ea/validation/xmi_parity_spec.rb` packagedElement threshold
-  raised from 5% to 25% (connectors represent ~25% of EA's output).
-
-## OCP
-
-Each connector type (Association/Aggregation/Composition) gets a
-private serializer method dispatched by `connector_type`. New
-connector types = new case branch; no other code changes.
+Extracted to `Ea::Transformers::QeaToXmi::ExtensionSerializer` (OCP).
+See [[66-qeatoxmi-style-tags-docs]] for the full restructuring.

data/TODO.complete/65-qeatoxmi-diagrams.md

@@ -1,29 +1,15 @@
 # TODO.complete/65: QeaToXmi emits diagram elements
 
-## Status: open
+## Status: done (via TODO 66 — ExtensionSerializer)
 
-`Ea::Transformers::QeaToXmi` does not emit EA's `<diagram>` elements
-at all. The parity spec confirms 0/23 in basic.qea, 0/2 in test.qea.
+`Ea::Transformers::QeaToXmi` now emits `<diagram>` elements as part
+of the `<diagrams>` extension section. Each diagram has a `<model>`
+block, `<properties>` block, and `<elements>` containing placed
+`<element subject="EAID_..." geometry="..."/>` children.
 
-## Plan
+Parity: 22/22 diagrams matched for basic.qea.
 
-1. Walk `t_diagram` for every diagram.
-2. For each diagram, walk `t_diagramlinks` to find placed
-   elements + connectors; emit them as `<element>` children of
-   `<diagram>`.
-3. Each element child references its `xmi:idref` to the model
-   class.
-4. Connector children emit as `<connector>` with geometry (see
-   TODO 64).
+## Implementation
 
-## Acceptance
-
-- `ea export xmi` output for basic.qea now contains
-  `<diagram>` elements (was 0/23).
-- Parity threshold raised from 25% to 50%.
-
-## OCP
-
-Diagrams emit via a new private method `emit_diagrams(model)`
-called after the model class tree. Adding new diagram metadata
-(swimlane info, etc.) = new private method, no other changes.
+Extracted to `Ea::Transformers::QeaToXmi::ExtensionSerializer` (OCP).
+See [[66-qeatoxmi-style-tags-docs]] for the full restructuring.

data/TODO.complete/66-qeatoxmi-style-tags-docs.md

@@ -1,28 +1,35 @@
 # TODO.complete/66: QeaToXmi emits style / tags / documentation
 
-## Status: open
+## Status: done
 
 EA's reference XMI contains hundreds of `<style>`, `<tags>`, and
-`<documentation>` elements per diagram. Ours emits zero. Per the
-parity spec: 0/663 styles, 0/478 tags, 0/357 documentation entries.
+`<documentation>` elements per diagram. Previously ours emitted zero.
 
-## Plan
+## Outcome
 
-1. Walk `t_diagramlinks` to find connector+element style strings.
-2. Emit `<style>` children of `<connector>` / `<element>` with the
-   stored style XML verbatim.
-3. Walk `t_taggedvalue` for tagged values; emit as `<tags>` children
-   with `<tag>` items.
-4. Walk `t_objectnotes` for documentation; emit as `<documentation>`
-   children of the owning element.
+Extracted extension serialization into `ExtensionSerializer` (OCP:
+new element types = new method, no existing code change). Emits the
+proper Sparx XMI structure:
 
-## Acceptance
+- `<elements>` — one `<element>` per package/classifier, each with
+  `<model>`, `<properties documentation="...">`, `<style>`, `<tags>`,
+  and (for classifiers) `<attributes>` and `<operations>` sub-blocks.
+- `<connectors>` — full source/target/end blocks with `<style>`,
+  `<documentation/>`, `<tags/>` each, plus connector-level body.
+- `<diagrams>` — placed `<element>` children with geometry.
 
-- Output contains `<style>`, `<tags>`, `<documentation>` elements.
-- Parity threshold raised from 50% to 75%.
+Parity counts (basic.qea):
 
-## OCP
+| type         | before | after | ref |
+|--------------|--------|-------|-----|
+| style        |      0 |   508 | 478 |
+| tags         |      0 |   508 | 478 |
+| documentation|      0 |   345 | 357 |
 
-Each sub-element type (style/tags/documentation) is a private
-emitter method dispatched by collection. New element types = new
-case branch.
+## Notes
+
+- Removed banned `respond_to?` patterns from the old code.
+- The old top-level `<tags>` and `<documentation>` sections were
+  structurally wrong — Sparx nests these inside per-element blocks.
+- `serialize(with_extensions: false)` (used by `ea convert`) skips
+  this entirely for round-trip safety.