[verified] feat: add semantic diagram lifecycle

references/maintenance.md

@@ -89,13 +89,20 @@ task build          # tsc → dist/
 src/
 ├── cli/
 │   └── commands.ts                      # parseArgs dispatcher → dynamic action imports
+├── authoring/
+│   └── ir-to-drawio.ts                  # deterministic IR v1/v2 serializer + preservation envelopes
+├── model/
+│   └── diagram-ir.ts                    # canonical types, normalization, runtime validation
 ├── services/
 │   ├── drawio-parser/
 │   │   ├── parser.ts                   # parseAllPages() / parseDiagram() — Shape, Edge, ParsedPage
 │   │   └── page-summary.ts            # buildPageSummary() — shared per-page serialisation helper
-│   └── hierarchy-builder/
-│       └── hierarchy-builder.ts        # buildHierarchy() — shared BFS depth map + containment tree
+│   ├── hierarchy-builder/
+│   │   └── hierarchy-builder.ts        # buildHierarchy() — shared BFS depth map + containment tree
+│   └── semantic-lifecycle/              # import, edit, views/query/policy/what-if, sync, story, atomic I/O
 └── actions/
+    ├── build|import|edit|views|query|test|what-if|sync|story|doctor/
+    │                                      # authoring and semantic lifecycle actions
     ├── summary/                         # all pages inventory
     ├── page-summary/                    # single page inventory (uses --page)
     ├── page-hierarchy/                  # containment tree from parentId
@@ -109,7 +116,7 @@ src/
     └── validate/                       # MANDATORY final gate — XML well-formedness + maxGraph compile + sanity check
 ```
 
-Each action exports `run(filePath: string, pageIndex?: number): Record<string, unknown>`.
+Each action exports `run(filePath, pageIndex?, outputPath?, options?): Record<string, unknown>`. Analysis actions may ignore lifecycle-only parameters. File-producing actions must require `--output` and use the shared atomic writer.
 
 ### Key modules
 
@@ -129,7 +136,9 @@ Each action exports `run(filePath: string, pageIndex?: number): Record<string, u
 
 **`src/cli/commands.ts`**  
 - `parseArgs` dispatcher → dynamic imports of action modules  
-- Supports `--file` / `-f`, `--action` / `-a`, `--page` / `-p` (0-based, default 0), `--help` / `-h`  
+- Common options: `--file` / `-f`, `--action` / `-a`, `--page` / `-p`, `--output` / `-o`, `--help` / `-h`
+- Lifecycle options: `--spec`, `--base`, `--strict`, `--prune`, `--dry-run`, `--fail`, `--views`, `--kind`, repeatable `--property`, `--from`, and `--to`
+- `doctor` is the only action that does not require `--file`
 - All output serialised to YAML on stdout; exit `0` success, `1` error
 
 ---
@@ -162,6 +171,7 @@ Actions follow `{object}-{action}` naming:
 
 ```typescript
 const ACTIONS: Record<string, () => Promise<ActionModule>> = {
+  "build":                      () => import("../actions/build/action.js"),
   "summary":                    () => import("../actions/summary/action.js"),
   "page-summary":               () => import("../actions/page-summary/action.js"),
   "page-hierarchy":             () => import("../actions/page-hierarchy/action.js"),
@@ -173,6 +183,16 @@ const ACTIONS: Record<string, () => Promise<ActionModule>> = {
   "page-recommendations":       () => import("../actions/page-recommendations/action.js"),
   "page-hierarchy-full":        () => import("../actions/page-hierarchy-full/action.js"),
   "page-negative-space-summary":() => import("../actions/page-negative-space-summary/action.js"),
-  "validate":                    () => import("../actions/validate/action.js"),
+  "validate":                   () => import("../actions/validate/action.js"),
+  "quality":                    () => import("../actions/quality/action.js"),
+  "import":                     () => import("../actions/import/action.js"),
+  "edit":                       () => import("../actions/edit/action.js"),
+  "views":                      () => import("../actions/views/action.js"),
+  "query":                      () => import("../actions/query/action.js"),
+  "test":                       () => import("../actions/test/action.js"),
+  "what-if":                    () => import("../actions/what-if/action.js"),
+  "sync":                       () => import("../actions/sync/action.js"),
+  "story":                      () => import("../actions/story/action.js"),
+  "doctor":                     () => import("../actions/doctor/action.js"),
 };
 ```