[verified] feat: add semantic diagram lifecycle

SKILL.md

@@ -13,11 +13,12 @@ compatibility: Designed for Cline, Claude Code, GitHub Copilot, OpenAI Codex, an
 
 # Draw.io Diagram Skill
 
-This skill covers three capabilities:
+This skill covers four capability families:
 
 1. **Deterministic YAML generation** — validate v1/v2 semantic Diagram IR and build native multi-page `.drawio` XML with stable IDs, dependency-aware layout, and obstacle-aware routing
 2. **Direct XML generation** — create `.drawio` files (and optionally export to PNG/SVG/PDF) from a description or requirements
 3. **Diagram analysis** — run the `drawio-tools` CLI to analyse an existing `.drawio` file: inventory shapes and connectors, validate layout quality, detect overlaps/orphans, and recommend page sizes
+4. **Semantic lifecycle** — loss-aware Draw.io import, transactional stable-ID edits, linked views, semantic query/policy/what-if analysis, three-way synchronization, and self-contained offline story publishing
 
 **Reference files** (read these when using this skill):
 - [references/capabilities.md](./references/capabilities.md) — full list of capabilities and all CLI analysis actions an agent can execute
@@ -27,6 +28,7 @@ This skill covers three capabilities:
 - [references/negative-space-diagram.md](./references/negative-space-diagram.md) — rules for generating negative space companion diagrams from `page-negative-space-summary` output
 - [references/routing-best-practices.md](./references/routing-best-practices.md) — corridor planning, routing patterns, overlap verification, swimlane routing, validation workflow
 - [references/maintenance.md](./references/maintenance.md) — maintaining and rebuilding the skill itself
+- [references/semantic-lifecycle.md](./references/semantic-lifecycle.md) — import, edit, views, query, policy, what-if, sync, story, and doctor workflows
 
 ## Available scripts
 
@@ -48,6 +50,16 @@ task validate -- --file="/path/to/diagram.drawio"
 # Build a native .drawio file from a YAML Diagram IR
 task generate -- --file="/path/to/spec.yaml" --output="/path/to/diagram.drawio"
 
+# Import an editable Draw.io file to loss-aware semantic IR
+task import -- --file="/path/to/diagram.drawio" --output="/path/to/model.yaml"
+
+# Apply one atomic stable-ID edit batch
+task edit -- --file="/path/to/model.yaml" --spec="/path/to/edit-batch.yaml" --output="/path/to/edited.drawio"
+
+# Generate linked audience views or a self-contained offline story
+task views -- --file="/path/to/model.yaml" --views="executive,system,security" --output="/path/to/views.drawio"
+task story -- --file="/path/to/model.yaml" --output="/path/to/story.html"
+
 # Build TypeScript to dist/
 task build
 ```