ea 0.3.1 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cf343d41c80cffbd277dd67bf172d0c947ddae898f51dacc1a2fffc3af871b0a
-  data.tar.gz: b554c52026c03c0a431e31140f840fedd495fae447b738c4d9fda4fae30c9eda
+  metadata.gz: 8c142ecf3b26459ada42952c881aa731dcda0f6aefa3a3b5507d0b658999db8d
+  data.tar.gz: 7e900c8b88055d3c9a74665b6bd87e07a204e8b6e0a8189dd7c924e8e28a7df5
 SHA512:
-  metadata.gz: bdec06da4470d865e75c52cbe8c5bec83ae4f242b223e98b436e5c244e8dcf8fd3c9a03bfe3f1ef3eedd9d2443fa52c21544755e8ff9cb3c5e698ee0a4b685f3
-  data.tar.gz: 5db5b284986bd79b3c1165f491d95cb6a5b9cd88d0bcdcab116e77abd92ebd84b267c8f3614850fa669d544085eca6eba52a6eea45c992e42439aa0b38803194
+  metadata.gz: 480005aecd4ed656acc9f1a1cfc67e189e833a8fc3212e07d9f2c63a85b5bc6d4969f7f0465b599f897e08169b872dacc543e9fab065b096822c979a671f3f04
+  data.tar.gz: 5240505439d4a2a3961da92831f26bda016de14e894cae1c28c9e3d10edd7b6b4c111262681164a099489030dd5aa7ca15b252fa4a787ce4fdddd297899a34b4

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.

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

@@ -0,0 +1,46 @@
+# TODO.complete/20: `ea diff` CLI command
+
+## Status: open
+
+Structural diff between two QEA files (or QEA vs XMI). Useful for:
+
+- Detecting model drift between revisions
+- Comparing XMI export round-trip against source QEA
+- Auditing changes between team check-ins
+
+## Plan
+
+1. New command `Ea::Cli::Command::Diff` in `lib/ea/cli/command/diff.rb`.
+2. Loads both files via `Ea.parse`.
+3. Produces a structural diff:
+   - Added / removed / modified packages, classifiers, attributes, operations, connectors.
+4. Output formats: text (default), JSON (`--format json`).
+5. Exit code: 0 if identical, 1 if differences found.
+
+## API
+
+```ruby
+Ea::Diff.new(model_a, model_b).call
+# => Ea::Diff::Result with added/removed/modified collections
+```
+
+## CLI
+
+```
+ea diff old.qea new.qea                    # text diff
+ea diff old.qea new.qea --format json      # JSON output
+ea diff old.qea new.qea --filter classes   # only class changes
+```
+
+## OCP / MECE
+
+- `Ea::Diff::Comparator` base class with subclasses per entity type.
+- New entity type = new comparator subclass, registered in `ComparatorRegistry`.
+- Diff result is a value object; rendering is separate.
+
+## Acceptance
+
+- Spec: identical models → exit 0, empty diff.
+- Spec: model with one added class → diff includes the class in `added`.
+- Spec: renamed attribute → diff shows `modified` with old/new names.
+- Spec: JSON output parses back to a structured diff.

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

@@ -0,0 +1,26 @@
+# TODO.complete/21: `ea render` unified rendering command
+
+## Status: open
+
+Consolidate the existing `svg` command into a more general `render`
+command that supports multiple output formats.
+
+## Plan
+
+```
+ea render model.qea --all --format svg     # all diagrams as SVG (current default)
+ea render model.qea --diagram "indoor"     # specific diagram
+ea render model.qea --format png           # PNG via rsvg/headless (future)
+ea render model.qea --format pdf           # multipage PDF (future)
+```
+
+## Migration
+
+- `ea svg ...` remains as alias for `ea render --format svg`.
+- New `--format` flag selects output.
+- PNG/PDF are future; only `svg` implemented now.
+
+## Acceptance
+
+- Spec: `ea render model.qea --all` produces SVG for every diagram.
+- Spec: `--format svg` and `ea svg` produce identical output.

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

@@ -0,0 +1,29 @@
+# TODO.complete/22: `ea export` command
+
+## Status: open
+
+Single command for all model exports.
+
+## Plan
+
+```
+ea export xmi model.qea -o model.xmi        # XMI export (current `convert`)
+ea export json model.qea                    # JSON model
+ea export plantuml model.qea --package core # PlantUML for docs
+ea export xsd model.qea --stereo FeatureType  # XSD (depends on TODO.complete/11)
+```
+
+## Migration
+
+- `ea convert` becomes alias for `ea export xmi`.
+- New subcommands: `json`, `plantuml`, `xsd`.
+
+## OCP / MECE
+
+- One exporter per format, registered in `ExportRegistry`.
+- New format = new exporter class.
+
+## Acceptance
+
+- Spec: `ea export xmi` round-trips a model (parse → export → re-parse).
+- Spec: `ea export json` produces valid JSON with all top-level entities.

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

@@ -0,0 +1,23 @@
+# TODO.complete/23: `ea mdg` command
+
+## Status: open
+
+Expose the MDG technology registry via CLI.
+
+## Plan
+
+```
+ea mdg list                       # list registered technologies
+ea mdg show FeatureType           # stereotype details + tagged values
+ea mdg show --tech GML            # all stereotypes in GML technology
+ea mdg import custom.mdg.xml      # register custom technology
+```
+
+## Dependencies
+
+- TODO.complete/10 (MDG registry).
+
+## Acceptance
+
+- Spec: `ea mdg list` includes CityGML and ISO 19103.
+- Spec: `ea mdg show FeatureType` returns stereotype definition.