E2E Test Plan — Bausteinsicht CLI

1

Basic Workflow

6

~2/6

init/validate incidentally exercised as setup in nearly every test, but double-init, read-only dir, init --format json, and the "Already in sync" message have no dedicated assertion

2

Validate

25

25/25

Closed by #519 (validate_edge_cases_test.go) — confirmed the validate --format json two-stream quirk: the {"valid":false,…​} report is on stdout, while a separate generic {"error":"validation failed","code":1} envelope from the shared ExecuteRoot path lands on stderr

3

Forward Sync

23

~5/23

sync_roundtrip_test.go/conflict_resolution_test.go cover the core cycle; long IDs/labels, self-referencing relationships, re-parenting, and the xmllint well-formedness checks (3.23) are untested

4

Reverse Sync + Conflicts

22

~10/22

Conflict resolution itself is well covered (TestConflictResolution); JSONC comment preservation (4.16-4.18, jsonc_comment_preservation_test.go) and HTML entity/tag handling in labels (4.4-4.7, label_html_handling_test.go) closed by #519

5

Views / Wildcards / Scope / Lifting

28

28/28

Closed by #519 (views_wildcards_lifting_test.go) — wildcard/exclude/scope resolution and connector lifting verified against real sync output, not just internal/model/resolve_test.go

6

CLI Add Commands

30

~9/30

Basic add-element/relationship flows are exercised as setup; JSONC comment preservation after add (6.25-6.30, jsonc_comment_preservation_test.go) closed by #519; other ID/label validation edge cases still untested

7

Watch Mode

10

~1/10

TestWatchMode covers model-change detection only (7.1); despite an earlier version of this row claiming otherwise, no test in e2e/*.go exercises --mermaid/--mermaid-output (7.9-7.10) — drawio-change detection, debounce, invalid-model recovery, --model flag semantics, and clean SIGINT exit are also untested

8

Export (PNG/SVG)

12

~2/12

Only the draw.io-not-found error path (8.9, added this session) is deterministic; the rest depend on a real draw.io CLI + headless display and mostly skip in CI

8b

Export-Diagram

10

~9/10

Well covered after this session’s work (plantuml/mermaid/structurizr/dot/d2/html); only the --format json unknown-format error (8b.4) unverified

8c

Export-Table

6

~5/6

Well covered after this session’s work

8d

Export-Sequence

4

~3/4

Covered by sequence_diagram_test.go; the "no dynamicViews" case (8d.4) unverified

9

Draw.io File Integrity

5

5/5

Closed by #519 (drawio_file_integrity_test.go); writing 9.3 found and fixed a real non-determinism bug in mergeStyles (#520)

10

Security / Injection Testing

9

9/9

Closed by #519 (security_injection_test.go) — XML/attribute injection, CDATA, NUL bytes, 100K-char strings, path traversal via --parent, shell-metacharacter IDs, JSON injection

11

CLI Flag Interactions

9

9/9

Closed by #519 (cli_flag_interactions_test.go) — --verbose across validate/sync/export, --model/--template wrong-type handling, --format json + --verbose stream separation, unknown flags, --help

12

Sync State Edge Cases

6

6/6

Closed by #519 (sync_state_edge_cases_test.go); found the 12.5 "Expected" was stale (see doc correction below)

13

Model File Edge Cases

7

7/7

Closed by #519 (model_file_edge_cases_test.go) — BOM, line endings, tabs, minified JSON, 100-element performance budget

14

Template Handling

6

6/6

Closed by #519 (template_handling_test.go) — custom --template styles actually applied, empty/invalid/missing template handling, `init’s own template creation and collision check

15

Error Output Formatting

8

8/8

Closed by #519 (error_output_format_test.go) — the {"error":"…​","code":N} JSON error contract verified stderr-only and consistent across commands, plus exit-code conventions

16

Analysis & Inspection

15

~11/15

Well covered after this session’s work (stale, status, health, graph, find, show)

17

Evolution & Snapshots

9

~6/9

snapshot/diff/changelog covered; restore-over-existing-output and delete-snapshot edge cases unverified

18

Model Tooling & Import

16

~11/16

Well covered after this session’s work (schema, structurizr/likec4/xmi import, workspace); generate-template/layout invalid-input cases unverified

19

Interactive, Overlay & ADR

7

~6/7

Well covered after this session’s work (repl, overlay, adr); REPL exit-confirmation prompt (19.2) unverified

20

Language Server (LSP)

6

0/6

Brand new section (this session) — bausteinsicht-lsp is a separate binary the e2e/ suite never builds

1.1

Init in fresh dir

bausteinsicht init

4 files created (architecture.jsonc, template.drawio, architecture.drawio, .bausteinsicht-sync)

1.2

Double init

Run init twice in same dir

Error: file already exists

1.3

Init in read-only dir

chmod 555 dir && init

Permission denied error

1.4

Validate after init

bausteinsicht validate

"Model is valid."

1.5

Sync after init

bausteinsicht sync

"Already in sync. No changes."

1.6

Init --format json

bausteinsicht init --format json

Valid JSON with "success": true

2.1

Empty JSON {}

echo '{}' > model.jsonc

Warning or error (no spec/model)

2.2

Spec without model

Only specification key

Valid

2.3

Model without spec

Only model key

Error: unknown kind

2.4

Unknown element kind

kind "microservice" not in spec

Error

2.5

Rel where from doesn’t exist

"from": "nonexistent"

Error

2.6

Rel where to doesn’t exist

"to": "ghost"

Error

2.7

Empty relationships []

Valid

2.8

Empty views {}

Valid

2.9

--format json for errors

{"valid":false,"errors":[…​]}

2.10

--format json for valid model

{"valid":true,"errors":[]}

2.11

Non-existent model file

--model /nonexistent

File not found error

2.12

Model path is directory

--model /tmp

"is a directory" error

2.13

View scope referencing non-existent element

Error

2.14

View include referencing non-existent element

"include": ["bogus"]

Warning or error (not silently ignored)

2.15

View exclude referencing non-existent element

"exclude": ["bogus"]

Warning or error

2.16

Duplicate IDs at different nesting levels

api top-level + parent.api

Valid (different paths)

2.17

Unknown relationship kind

"kind": "foobar" not in spec

Error

2.18

Empty string element ID ""

"": {…​}

Error

2.19

Whitespace-only element ID " "

" ": {…​}

Error

2.20

null root JSON

File is just null

Error

2.21

--format xml (invalid format)

Error: unknown format

2.22

--format JSON (uppercase)

JSON output (case-insensitive) or clear error

2.23

Malformed JSON

Clear parse error

2.24

500 elements stress test

<1s, valid

2.25

Deep nesting (6 levels)

Valid

3.1

Add element, sync

Add to model + view include, sync

Element in drawio with correct style

3.2

Add 2 elements simultaneously

Both appear

3.3

Long ID (120 chars)

Accepted, synced

3.4

Remove ALL elements, sync

All pages cleaned

3.5

Add element back after removal

Fresh creation

3.6

Add relationship, sync

Connector rendered

3.7

Remove source element of relationship

Element + connector removed

3.8

Long relationship label (500 chars)

No truncation

3.9

Multiple rels between same pair

A→B "uses" + A→B "sends"

Both connectors rendered

3.10

Bidirectional relationships

A→B + B→A

Both render

3.11

Self-referencing relationship

A→A

Connector created

3.12

3 levels of nesting, sync

system→container→component

All levels correct

3.13

Delete middle nesting level

Re-parenting works

3.14

Move element between parents

Old removed, new created

3.15

Sync 5x without changes

All "Already in sync"

3.16

Incremental add/remove across syncs

Correct state

3.17

No duplicates after 5 cycles

Exactly 1 instance

3.18

Delete drawio file, then sync

Recreate or clear error

3.19

Corrupt drawio file, then sync

Random text in drawio

Error, model untouched

3.20

Delete sync state, then sync

No duplicates

3.21

Element in all 3 views

Appears on all pages

3.22

Remove element from one view

Only removed from that page

3.23

10 add+sync cycles: XML well-formedness

xmllint after each

Valid XML

4.1

Change label in drawio, sync

Edit <object> label attribute

Model title updated

4.2

Change description (tooltip)

Model description updated

4.3

Change technology

Model technology updated

4.4

HTML entities in label

& < >

Properly decoded in model

4.5

Bold HTML tags in label

<b>text</b>

Tags stripped

4.6

Line breaks in label

<br>

Handled gracefully

4.7

Empty string label

Set label=""

Warning or reject (not silent)

4.8

Conflict: same field both sides

Model wins + warning

4.9

Different fields changed

Title in model, desc in drawio

Both applied

4.10

Multiple fields in drawio only

All updated in model

4.11

Delete element from drawio

Removed from model + rels

4.12

Delete connector from drawio

Relationship removed

4.13

Delete element with relationships

Element + all rels removed

4.14

Change connector label

Label updated in model

4.15

Change connector source/target

Old rel removed, new created

4.16

// comments preserved

Count before = count after

4.17

/* */ block comments preserved

Preserved after sync

4.18

Trailing commas preserved

Maintained

4.19

3 rapid consecutive syncs

Idempotent after first

4.20

Multiple elements changed simultaneously

All updated

4.21

No double WARNING prefix

Conflict message starts with "Conflict detected" (not "WARNING: WARNING:")

4.22

View references cleaned on element delete

Removed from include/exclude

5.1

Exact match

["webshop"]

Only webshop

5.2

Single wildcard

["webshop.*"]

Direct children

5.3

Double wildcard

["webshop.**"]

All descendants

5.4

Bare *

["*"]

All top-level

5.5

Bare **

["**"]

Everything

5.6

Nested wildcard

["webshop.frontend.*"]

cart + catalog

5.7

Explicit list

["a", "b"]

Exactly those two

5.8

Mixed wildcard + explicit

["webshop.*", "external"]

Combined

5.9

Exclude single element

Include *, exclude one

Element removed

5.10

Exclude nested wildcard

Include *, exclude prefix.

Correct

5.11

Exclude descendants

Include prefix., exclude prefix.child.

Children excluded, not parent

5.12

Scope with valid element

"scope": "webshop"

Boundary box

5.13

Scope with non-existent element

Blocking validation error ("does not resolve to an existing element"), sync exits 1 — not a soft warning; see #176

5.14

Scope with empty include

Only boundary

5.15

Direct + lifted relationships

Direct has priority

5.16

Lifted to parent

Label preserved

5.17

Direct deep relationship

Correct connector

5.18

Transitive chain

No transitive lifting

5.19

Two views with overlapping elements

Both pages have element

5.20

Remove view from model, sync

Page removed from drawio

5.21

Rename view key

Old page removed, new added

5.22

Empty include []

Empty page

5.23

Nonexistent element in include, as a wildcard pattern (e.g. ["nonexistent.*"])

Empty page — note: a literal nonexistent ID (no *) is instead a blocking validation error, same as 5.13/5.26/5.27

5.24

Include = exclude (cancel out)

Empty page

5.25

Duplicate entries in include

["x", "x"]

Deduplicated

5.26

Trailing dot "webshop."

Blocking validation error ("element does not exist") — not a silent empty page; the #176 fix ("typos like 'customer.' silently remove elements from draw.io") turned this into a hard error

5.27

Just dots "…​"

Blocking validation error ("element does not exist"), same #176 protection

5.28

3 views, add element to all

Element on all 3 pages

6.1

Basic add element

add element --id test --kind system --title "Test"

Success

6.2

Duplicate ID

Same ID twice

Error

6.3

Empty ID ""

Rejected

6.4

ID with space "a b"

Rejected

6.5

Dotted ID "a.b" at top level

Rejected

6.6

Empty title ""

Rejected

6.7

Unknown kind

Error with valid kinds listed

6.8

Valid parent

--parent onlineshop

Success

6.9

Invalid parent

--parent nonexistent

Error

6.10

Numeric-starting ID 123

Rejected

6.11

camelCase / UPPER / single-char IDs

Accepted

6.12

No flags at all

add element

Missing required flags error

6.13

All optional flags

--description "…​" --technology "…​"

All stored in model

6.14

--format json for element

Valid JSON with id, kind, title, technology, description

6.15

Basic add relationship

add relationship --from a --to b --label "x"

Success

6.16

Self-referencing relationship

--from a --to a

Accepted

6.17

Non-existent from/to

Error

6.18

Empty label

--label ""

Accepted

6.19

Very long label (1000 chars)

Accepted

6.20

Special chars in label

& < > " '

Escaped correctly

6.21

Duplicate relationship

Same from+to twice

Rejected with error

6.22

--format json for relationship

Valid JSON

6.23

Dot notation nested elements

--from parent.child

Works

6.24

Unknown relationship kind

Rejected

6.25

// comments preserved after add

Count before/after

Same

6.26

/* */ block comments preserved

Preserved

6.27

Trailing commas preserved

Maintained

6.28

Mixed comments after add

All preserved

6.29

Two sequential adds

Both elements + comments intact

6.30

Add relationship preserves comments

No comment loss

7.1

Detects model changes

Start watch, modify model, wait 3s

Sync triggered

7.2

Detects drawio changes

Start watch, modify drawio XML, wait 3s

Reverse sync triggered

7.3

Debounce (5 rapid saves)

5 writes within 500ms

Single sync

7.4

Recovery from invalid model

Write invalid JSON, wait, restore valid

Error then recovery

7.5

--model flag

watch --model architecture.jsonc

Works same as default

7.6

Non-existent model

watch --model nonexistent.jsonc

Immediate error

7.7

Clean exit on SIGINT

kill -INT

"Stopped watching." (exit 0)

7.8

File delete + recreate

Delete model, recreate, modify

Watch continues detecting changes

7.9

--mermaid flag

watch --mermaid, modify model, wait 3s

architecture.md (default --mermaid-output) created/updated with Mermaid diagrams alongside the regular drawio sync

7.10

--mermaid-output custom path

watch --mermaid --mermaid-output docs/diagrams.md

Mermaid markdown written to the custom path, not the default

8.1

Export all views as PNG

bausteinsicht export --image-format png

One PNG per view page

8.2

Export all views as SVG

bausteinsicht export --image-format svg

One SVG per view page

8.3

Export single view

export --view context

Only one file for context view

8.4

Export non-existent view

export --view nonexistent

Error: view not found

8.5

Export to custom output dir

export --output ./images/

Files created in ./images/

8.6

Export to non-existent dir

export --output /nonexistent/path/

Dir created or clear error

8.7

Export --format json

export --format json

JSON output listing exported files

8.8

Export with --embed-diagram

export --embed-diagram --image-format png

PNG contains embedded draw.io XML

8.9

Export without draw.io CLI

export --drawio-path /nonexistent

Clear error: draw.io CLI not found

8.10

Export after init (no custom elements)

Init, export

Exports default diagram

8.11

Export after multiple syncs

Add elements, sync 3x, export

Exported image matches current state

8.12

Output filename convention

Export all views

Files named {base}-{viewID}.{ext} (e.g., architecture-context.png)

8b.1

Export view as C4-PlantUML

export-diagram --view context --diagram-format plantuml

C4-PlantUML text on stdout

8b.2

Export view as Mermaid

export-diagram --view context --diagram-format mermaid

Mermaid C4 text on stdout

8b.3

--format json honored

export-diagram --view context --format json

JSON wrapper, not plain text (regression #241)

8b.4

Unknown diagram format

export-diagram --view context --diagram-format bogus

Error: unknown diagram format

8b.5

Non-existent view

export-diagram --view nope

Error: view not found

8b.6

Structurizr workspace export

export-diagram --diagram-format structurizr

Single workspace.dsl; rejects --view (exit 1)

8b.7

Export as Graphviz DOT

export-diagram --view context --diagram-format dot --output out/

architecture-context.dot with valid DOT syntax

8b.8

Export as D2

export-diagram --view context --diagram-format d2 --output out/

architecture-context.d2 with valid D2 syntax

8b.9

Export as interactive HTML

export-diagram --diagram-format html --output out/

One .html file per view (multi-view branch); --view context produces exactly one file (single-view branch, a different code path)

8b.10

--format json for dot/d2/html

export-diagram --diagram-format dot --format json

JSON wrapper with "format":"dot", same as 8b.3 but for the dot/d2/html code path (handleNewFormats), which has its own separate JSON branch

8c.1

Export as AsciiDoc table

export-table --view context

AsciiDoc table on stdout

8c.2

Export as Markdown table

export-table --view context --table-format md

Markdown table on stdout

8c.3

--format json honored

export-table --view context --format json

JSON output, not plain text (regression #239)

8c.4

Non-existent view

export-table --view nope

Error: view not found

8c.5

Combined across views

export-table --combined

All elements across views, deduplicated

8c.6

All views, not combined

export-table (no --view, no --combined)

Single file all-views-elements.<ext> with one titled section per view — a third code path (FormatAllViews) distinct from both 8c.1 (single view) and 8c.5 (deduplicated combined)

8d.1

Export dynamic view as PlantUML

export-sequence --view login-flow

PlantUML sequence on stdout

8d.2

Export as Mermaid

export-sequence --view login-flow --diagram-format mermaid

Mermaid sequence on stdout

8d.3

Unknown dynamic view

export-sequence --view nope

Error: dynamic view not found

8d.4

Model without dynamicViews

export-sequence on a model with no dynamic views

"No dynamic views defined in model." on stderr, exit 0

9.1

XML well-formedness after 10 cycles

Add element + sync x10, xmllint each

Valid XML every time

9.2

No orphaned connectors

Add rels, remove middle element, sync

No dangling edges

9.3

Style consistency

5 elements same kind

Identical styles

9.4

Page structure (base cells)

After 10 cycles

Exactly one mxCell 0 and 1 per page

9.5

mxGraphModel attributes

After 10 cycles

dx, dy, grid, etc. preserved

10.1

XML injection via title

<script>alert('xss')</script>

Escaped, XML well-formed

10.2

XML injection via description

"><evil attr="injected

No attribute injection

10.3

XML injection via rel label

</mxCell><mxCell evil="true"/>

No injected elements

10.4

CDATA injection

]]>…​</description><evil>

XML integrity maintained

10.5

Unicode null bytes in title

\x00 in title

Handled gracefully

10.6

Very long string (100K chars)

No crash

10.7

Path traversal via --parent

../../etc/passwd

"not found" error

10.8

Shell injection via element ID

$(whoami), whoami

Rejected by ID regex

10.9

JSON injection in model

", "evil": "true in title

Literal string value

11.1

--verbose with validate

validate --verbose

More detail than non-verbose

11.2

--verbose with sync

sync --verbose

More detail

11.3

--verbose with export

export --verbose

More detail

11.4

--model pointing to .drawio

validate --model x.drawio

Clear parse error

11.5

--template pointing to .jsonc

sync --template x.jsonc

Error (not silent fallback)

11.6

--format json + --verbose

Valid JSON (verbose doesn’t break JSON structure)

11.7

Both model+template non-existent

Clear error

11.8

--help on all subcommands

init, sync, validate, watch, add element, add relationship, export

Help text, exit 0

11.9

Unknown flag --bogus

sync --bogus

Error: unknown flag

12.1

Corrupt sync state

{{{invalid

Clear parse error

12.2

Extra/stale entries

Fake elements in sync state

Cleaned up gracefully

12.3

Missing entries

Remove some from sync state

No duplicates created

12.4

Empty sync state {}

No duplicates, rebuilds state

12.5

Empty file (0 bytes)

Treated the same as a missing file (empty state, no error) — internal/sync/state.go:60-65 explicitly handles "e.g. truncated write"; not a "Clear error" as originally stated here

12.6

JSON array instead of object

[]

Clear type error

13.1

UTF-8 BOM

\xEF\xBB\xBF prefix

Stripped or clear error mentioning BOM

13.2

Windows line endings \r\n

Works

13.3

Mixed line endings

Works

13.4

Tab indentation

Works

13.5

No trailing newline

Works

13.6

Minified (single-line) JSON

Works

13.7

100 elements performance

<1s for validate + sync

14.1

Custom template via --template

sync --template custom.drawio

Styles from custom template used

14.2

Template without required styles

Empty template

Clear error or default styles

14.3

Template is not valid draw.io XML

Random text

Clear parse error

14.4

Template path doesn’t exist

--template /nonexistent.drawio

File not found error

14.5

Init creates template.drawio

init

template.drawio contains valid draw.io XML with element styles

14.6

Init blocked by existing template

Pre-create template.drawio, then init

Error: file already exists

15.1

Error as JSON (validate)

validate --model /nonexistent --format json 2>&1

{"error":"…​","code":N} on stderr

15.2

Error as JSON (sync)

sync --model /nonexistent --format json 2>&1

{"error":"…​","code":N} on stderr

15.3

Error as JSON (add element)

add element --format json --kind invalid …​ 2>&1

{"error":"…​","code":N} on stderr

15.4

Error as JSON (export)

export --format json --drawio-path /nonexistent 2>&1

{"error":"…​","code":N} on stderr

15.5

Error as text (default)

validate --model /nonexistent 2>&1

Plain text error on stderr

15.6

Error exit codes

Various error commands

exit code 1 for user errors, 2 for system errors

15.7

Success JSON output consistency

init --format json, sync --format json, etc.

All valid JSON, parseable by jq

15.8

No mixed stdout/stderr

Error command with --format json

JSON error on stderr only, no text on stdout

16.1

Lint passes a clean model

lint on a model with no constraints violated

Exit 0, no violations

16.2

Lint reports a violation

lint on a model breaking a defined constraint

Exit 1, violation listed with constraint ID

16.3

Health score

health --model architecture.jsonc

Completeness/conformance/complexity score

16.4

Health requires --model

health with no --model

Error (health does not auto-detect — deviates from the global convention)

16.5

Graph analysis

graph --model architecture.jsonc

Cycles and dependency depth reported (centrality only with --centrality); graph requires --model (exit 2 if missing)

16.6

Graph --format json

graph --model architecture.jsonc --format json

Machine-readable graph metrics

16.7

Stale with threshold

stale --days 90

Elements older than 90 days without status/ADR flagged

16.8

Stale outside git

stale outside a git repo, no lastModified

Graceful: nothing flagged

16.9

Stale --format json

stale --format json

JSON with staleElements array, id/lastModified/risk/etc. per entry

16.10

Stale --mark-drawio

Sync a stale element into drawio, stale --mark-drawio

Risk-color fill applied to the stale element’s mxCell; original fill/stroke preserved in data-original-fill/data-original-stroke-color for reversal; "Marked N stale elements" on stderr

16.11

Stale --unmark-drawio

After 16.10, stale --unmark-drawio

Original fill/stroke restored, marker attributes removed (idempotent — a second --unmark-drawio is a no-op)

16.12

Status grouping

status --model architecture.jsonc

Elements grouped/sorted by lifecycle status (status reads --model directly and does not auto-detect)

16.13

Find full-text

find api

Matching elements/relationships/views

16.14

Show element details

show webshop.api

All fields of the element

16.15

Show non-existent element

show nope

Error: element not found

17.1

Save snapshot

snapshot save --message "before refactor"

Snapshot written to .bausteinsicht-snapshots/ with an auto-generated timestamp ID (save takes no id, only --message)

17.2

List snapshots

snapshot list

Saved snapshots listed with their timestamp IDs

17.3

Diff snapshots

snapshot diff <id1> <id2> (IDs from snapshot list)

Element/relationship changes between snapshots

17.4

Restore snapshot

snapshot restore <id> restored.jsonc (output path is positional, not a flag)

Model restored to snapshot state

17.5

Restore over existing output

snapshot restore <id> existing.jsonc onto an existing file

Exit 2: output exists (use --force)

17.6

Delete snapshot

snapshot delete <id>

Snapshot removed

17.7

Diff as-is vs to-be

diff on a model with asIs/toBe

Differences reported

17.8

Diff without sections

diff on a model lacking asIs/toBe

Error: model does not contain asIs and toBe sections

17.9

Changelog

changelog in a git repo

Architecture changelog between versions (git-based)

18.1

Import Structurizr DSL

import model.dsl --from structurizr

architecture.jsonc generated

18.2

Import LikeC4

import model.c4 --from likec4

architecture.jsonc generated

18.3

Import unknown format

import x --from bogus

Exit 1: unknown format

18.4

Import over existing output

import model.dsl --from structurizr (output exists)

Exit 2 unless --force; --dry-run skips the check

18.5

Generate template

generate-template --style c4

architecture-template.drawio with one styled shape per kind

18.6

Generate template invalid style

generate-template --style bogus

Error: invalid style

18.7

Layout

layout --rank-dir LR

Element positions written back to the draw.io file

18.8

Schema generate

schema generate

Schema written to schemas/bausteinsicht.schema.json

18.9

Schema in sync with types

schema generate then git diff

No diff (committed schema matches Go types)

18.10

Workspace validate

workspace validate workspace.json

JSON workspace config validated

18.11

Workspace merge

workspace merge workspace.json merged.jsonc

Combined model written

18.12

Import XMI (EA export)

import model.xmi --from xmi

architecture.jsonc generated; UML types mapped to Bausteinsicht kinds via built-in defaults (e.g. uml:Component → component); result imports and syncs cleanly

18.13

Import XMI with --kind-map

import model.xmi --from xmi --kind-map Component=service,Class=entity

Overridden kinds applied instead of the built-in defaults; overridden kinds are registered in specification.elements so the model still validates/syncs

18.14

Import XMI with EA stereotype

XMI element carrying an xmi:Extension/stereotype tag (e.g. microservice)

Stereotype wins over the UML type mapping and any --kind-map override for that element

18.15

Import XMI, Windows-1252 encoded

XMI file with a windows-1252 (not UTF-8) encoding declaration and non-ASCII bytes

Correctly transcoded to UTF-8 in the resulting model — no mangled characters

18.16

Import XMI path traversal in !include

XMI/DSL referencing ../../etc/passwd-style paths

Rejected with a path-traversal warning; import continues without the escaping file

19.1

REPL add + save

repl, then add/save/exit

Model updated; validated before save

19.2

REPL exit with unsaved changes

repl, edit, exit

Confirmation prompt before quitting

19.3

Overlay list metrics

overlay list metrics.json

Available metrics listed

19.4

Overlay apply

overlay apply metrics.json --model architecture.jsonc

Heatmap overlaid; output next to the model

19.5

Overlay with no model

overlay apply metrics.json with no --model

Error loading model (overlay reads --model and does not auto-detect, so the empty default path fails to load)

19.6

ADR list

adr list

Linked ADRs listed

19.7

ADR show / filter

adr show ADR-001, adr list --element webshop.api

ADR details / ADRs for that element

20.1

initialize handshake

Send an initialize request, then initialized notification

Valid InitializeResult response; server does not exit

20.2

textDocument/didOpen triggers diagnostics

Open a .jsonc document with a validation error (e.g. unknown kind)

A textDocument/publishDiagnostics notification is sent listing the error

20.3

textDocument/didChange re-validates

Open a valid document, then send a change introducing an error

New publishDiagnostics notification reflects the updated error state (and clears previous diagnostics when fixed)

20.4

textDocument/didSave re-validates

Save-triggered validation path, distinct from didChange

Diagnostics consistent with on-disk content

20.5

shutdown + exit

Send shutdown request, then exit notification

Process exits cleanly (exit 0), no diagnostics sent after shutdown

20.6

-debug flag

Start with -debug, malformed request

Debug logging appears on stderr (silently discarded to /dev/null without the flag, per main.go)

2026-03-01

1+2

73

18 (#107-#124)

e2e-test-report-2026-03-01.adoc

2026-03-02

3

221

12 (#140-#151)

e2e-test-report-2026-03-02.adoc

2026-03-02

4

147

5 (#165-#169)

e2e-test-report-2026-03-02-round4.adoc

2026-03-02

5

204

4 (#175-#178)

e2e-test-report-2026-03-02-round5.adoc

2026-03-02

6

211

7 (#183-#189)

e2e-test-report-2026-03-02-round6.adoc

2026-03-05

7

215

6 (#236-#241)

e2e-test-report-2026-03-05.adoc

2026-07-03

8 (automated)

116 newly automated (279 total tracked)

1 (#520)

e2e-test-report-2026-07-03.adoc