@documentation-robotics/cli 0.1.0 → 0.1.7

package/dist/commands/delete.js

@@ -1,26 +1,140 @@
 import { confirm } from "@clack/prompts";
 import ansis from "ansis";
 import { Model } from "../core/model.js";
+import { MutationHandler } from "../core/mutation-handler.js";
+import { ReferenceRegistry } from "../core/reference-registry.js";
+import { DependencyTracker, TraceDirection } from "../core/dependency-tracker.js";
 import { findElementLayer } from "../utils/element-utils.js";
+import { CLIError, handleError, handleSuccess, ErrorCategory, ModelNotFoundError } from "../utils/errors.js";
 import { startSpan, endSpan } from "../telemetry/index.js";
+import { getErrorMessage } from "../utils/errors.js";
 const isTelemetryEnabled = !1;
 async function deleteCommand(id, options) {
   const span = isTelemetryEnabled ? startSpan("element.delete", {
     "element.id": id,
-    "element.force": !!options.force
+    "element.force": !!options.force,
+    "element.cascade": !!options.cascade,
+    "element.dryRun": !!options.dryRun
   }) : null;
   try {
-    const model = await Model.load(), layerName = await findElementLayer(model, id);
-    layerName || (console.error(ansis.red(`Error: Element ${id} not found`)), process.exit(1)), options.force || await confirm({
-      message: `Delete element ${ansis.bold(id)}? This cannot be undone.`,
-      initialValue: !1
-    }) || (console.log(ansis.dim("Cancelled")), process.exit(0));
-    const layer = await model.getLayer(layerName), beforeState = layer.getElement(id).toJSON();
-    layer.deleteElement(id) || (console.error(ansis.red(`Error: Failed to delete element ${id}`)), process.exit(1)), model.relationships.deleteForElement(id), await model.getActiveChangesetContext().trackChange("delete", id, layerName, beforeState, void 0), await model.saveLayer(layerName), model.relationships.isDirty() && await model.saveRelationships(), await model.saveManifest(), isTelemetryEnabled && span && span.setAttribute("layer.name", layerName), console.log(ansis.green(`\u2713 Deleted element ${ansis.bold(id)}`)), options.verbose && console.log(ansis.dim(`  Layer: ${layerName}`));
+    let model;
+    try {
+      model = await Model.load();
+    } catch (error) {
+      const message = getErrorMessage(error);
+      throw message.includes("No DR project") || message.includes("Model not found") ? new ModelNotFoundError() : error;
+    }
+    const layerName = await findElementLayer(model, id);
+    if (!layerName)
+      throw new CLIError(`Element ${id} not found`, ErrorCategory.USER, [
+        `Use "dr search ${id}" to find similar elements`,
+        'Use "dr list <layer>" to list all elements in a layer'
+      ]);
+    const element = (await model.getLayer(layerName)).getElement(id);
+    if (!element)
+      throw new CLIError(`Element ${id} not found`, ErrorCategory.USER, [
+        `Use "dr search ${id}" to find similar elements`,
+        'Use "dr list <layer>" to list all elements in a layer'
+      ]);
+    const registry = new ReferenceRegistry();
+    for (const layer2 of model.layers.values())
+      for (const element2 of layer2.listElements())
+        registry.registerElement(element2);
+    const tracker = new DependencyTracker(registry, model), dependents = tracker.traceDependencies(id, TraceDirection.DOWN, null);
+    if (console.log(""), console.log(ansis.bold(`Removing element: ${ansis.yellow(id)}`)), console.log(ansis.dim(`  Layer: ${layerName}`)), console.log(ansis.dim(`  Type: ${element.type || "unknown"}`)), element.name && console.log(ansis.dim(`  Name: ${element.name}`)), dependents.length > 0) {
+      console.log(""), console.log(ansis.yellow(`\u26A0 Warning: This element has ${dependents.length} dependent element(s):`));
+      const directDependents = tracker.traceDependencies(id, TraceDirection.DOWN, 1);
+      for (const dep of directDependents.slice(0, 5)) {
+        const depLayer = model.getElementById(dep)?.layer || "unknown";
+        console.log(ansis.dim(`  - ${dep} (${depLayer})`));
+      }
+      if (directDependents.length > 5 && console.log(ansis.dim(`  ... and ${directDependents.length - 5} more direct dependents`)), dependents.length > directDependents.length && console.log(ansis.dim(`  (${dependents.length - directDependents.length} transitive dependents not shown)`)), !options.cascade && !options.force) {
+        console.log(""), console.log(ansis.red("\u2717 Cannot remove element with dependencies.")), console.log(ansis.dim("Use --cascade to remove all dependent elements")), console.log(ansis.dim("or --force to skip dependency checks"));
+        const suggestions = [
+          "Use --dry-run with --cascade to preview what would be deleted",
+          'Review dependencies before deletion using "dr show <element>"',
+          "Use --cascade to automatically remove all dependent elements",
+          "Or use --force to remove only this element (dependencies will reference a non-existent element)"
+        ];
+        throw new CLIError("Element has dependencies", ErrorCategory.USER, suggestions, {
+          operation: "delete",
+          relatedElements: directDependents.slice(0, 10),
+          context: `Element ${id} has ${dependents.length} dependent elements`
+        });
+      }
+    }
+    const elementsToRemove = options.cascade ? [id, ...dependents] : [id];
+    if (options.dryRun) {
+      if (console.log(""), console.log(ansis.yellow("Dry run - not removing")), console.log(ansis.dim(`Would remove ${elementsToRemove.length} element(s)`)), options.cascade && dependents.length > 0) {
+        console.log(""), console.log(ansis.dim("Elements that would be removed:")), console.log(ansis.dim(`  - ${id} (target)`));
+        for (const dep of dependents.slice(0, 10))
+          console.log(ansis.dim(`  - ${dep} (dependent)`));
+        dependents.length > 10 && console.log(ansis.dim(`  ... and ${dependents.length - 10} more`));
+      }
+      return;
+    }
+    if (!options.force)
+      if (!(process.stdin.isTTY && process.stdout.isTTY))
+        console.log(ansis.dim("Non-interactive environment detected - proceeding without confirmation"));
+      else {
+        const message = options.cascade && dependents.length > 0 ? `Delete ${ansis.bold(id)} and ${ansis.bold(String(dependents.length))} dependent element(s)? This cannot be undone.` : `Delete element ${ansis.bold(id)}? This cannot be undone.`;
+        if (!await confirm({
+          message,
+          initialValue: !1
+        })) {
+          console.log(ansis.dim("Cancelled"));
+          return;
+        }
+      }
+    let deletedCount = 0;
+    try {
+      if (options.cascade && dependents.length > 0) {
+        const sortedDependents = [...dependents].reverse();
+        for (const depId of sortedDependents)
+          try {
+            const depLayerName = await findElementLayer(model, depId);
+            if (!depLayerName)
+              continue;
+            const depElement = (await model.getLayer(depLayerName)).getElement(depId);
+            await new MutationHandler(model, depId, depLayerName).executeDelete(depElement), deletedCount++, options.verbose && console.log(ansis.dim(`  Deleted dependent: ${depId}`));
+          } catch {
+            const suggestions = [
+              `${deletedCount} dependent element(s) were deleted before the error`,
+              'Check the model state with "dr validate" to identify any broken references',
+              'You may need to manually delete remaining elements or use "dr show" to inspect'
+            ];
+            throw new CLIError(`Failed to delete dependent element ${depId}`, ErrorCategory.SYSTEM, suggestions, {
+              operation: "delete (cascade)",
+              partialProgress: { completed: deletedCount, total: sortedDependents.length },
+              relatedElements: [id, ...sortedDependents.slice(0, 5)]
+            });
+          }
+      }
+    } catch (error) {
+      if (options.cascade && deletedCount > 0 && !(error instanceof CLIError)) {
+        const suggestions = [
+          `${deletedCount} dependent element(s) were successfully deleted`,
+          'Use "dr validate" to check for broken references',
+          "The target element was not deleted - you can retry the operation"
+        ];
+        throw new CLIError("Cascade deletion was partially completed but encountered an error", ErrorCategory.SYSTEM, suggestions, {
+          operation: "delete (cascade)",
+          partialProgress: { completed: deletedCount, total: dependents.length }
+        });
+      }
+      throw error;
+    }
+    const handler = new MutationHandler(model, id, layerName);
+    if (await handler.executeDelete(element), isTelemetryEnabled && span && (span.setAttribute("layer.name", layerName), span.setAttribute("element.dependents", dependents.length), span.setAttribute("element.totalDeleted", elementsToRemove.length)), handler.getBeforeState()) {
+      const activeChangeset = await handler.getStagingManager().getActive();
+      activeChangeset && activeChangeset.status === "staged" ? handleSuccess(`Staged deletion of element ${ansis.bold(id)} to ${ansis.bold(activeChangeset.name)}`, {
+        status: "staged",
+        changeset: activeChangeset.name
+      }) : (elementsToRemove.reduce((n, eid) => n + model.relationships.deleteForElement(eid), 0) > 0 && await model.saveRelationships(), console.log(""), console.log(ansis.green(`\u2713 Deleted element ${ansis.bold(id)}`)), options.cascade && dependents.length > 0 && console.log(ansis.green(`\u2713 Deleted ${dependents.length} dependent element(s)`)), options.verbose && (console.log(ansis.dim(`  Layer: ${layerName}`)), console.log(ansis.dim(`  Total elements deleted: ${elementsToRemove.length}`))));
+    } else
+      elementsToRemove.reduce((n, eid) => n + model.relationships.deleteForElement(eid), 0) > 0 && await model.saveRelationships(), console.log(""), console.log(ansis.green(`\u2713 Deleted element ${ansis.bold(id)}`)), options.cascade && dependents.length > 0 && console.log(ansis.green(`\u2713 Deleted ${dependents.length} dependent element(s)`)), options.verbose && (console.log(ansis.dim(`  Layer: ${layerName}`)), console.log(ansis.dim(`  Total elements deleted: ${elementsToRemove.length}`)));
   } catch (error) {
-    isTelemetryEnabled && span && (span.recordException(error), span.setStatus({ code: 2, message: error.message }));
-    const message = error instanceof Error ? error.message : String(error);
-    console.error(ansis.red(`Error: ${message}`)), process.exit(1);
+    isTelemetryEnabled && span && (span.recordException(error), span.setStatus({ code: 2, message: error.message })), handleError(error);
   } finally {
     isTelemetryEnabled && endSpan(span);
   }

package/dist/commands/delete.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/commands/delete.ts"],
-  "sourcesContent": ["/**\n * Delete an element\n */\n\nimport { confirm } from '@clack/prompts';\nimport ansis from 'ansis';\nimport { Model } from '../core/model.js';\nimport { findElementLayer } from '../utils/element-utils.js';\nimport { startSpan, endSpan } from '../telemetry/index.js';\n\ndeclare const TELEMETRY_ENABLED: boolean | undefined;\nconst isTelemetryEnabled = typeof TELEMETRY_ENABLED !== 'undefined' ? TELEMETRY_ENABLED : false;\n\nexport interface DeleteOptions {\n  force?: boolean;\n  verbose?: boolean;\n  debug?: boolean;\n}\n\nexport async function deleteCommand(id: string, options: DeleteOptions): Promise<void> {\n  const span = isTelemetryEnabled ? startSpan('element.delete', {\n    'element.id': id,\n    'element.force': !!options.force,\n  }) : null;\n\n  try {\n    // Load model\n    const model = await Model.load();\n\n    // Find element\n    const layerName = await findElementLayer(model, id);\n    if (!layerName) {\n      console.error(ansis.red(`Error: Element ${id} not found`));\n      process.exit(1);\n    }\n\n    // Confirm deletion unless --force\n    if (!options.force) {\n      const confirmed = await confirm({\n        message: `Delete element ${ansis.bold(id)}? This cannot be undone.`,\n        initialValue: false,\n      });\n\n      if (!confirmed) {\n        console.log(ansis.dim('Cancelled'));\n        process.exit(0);\n      }\n    }\n\n    const layer = (await model.getLayer(layerName))!;\n\n    // Capture element state for changeset tracking before deletion\n    const element = layer.getElement(id)!;\n    const beforeState = element.toJSON();\n\n    // Delete element\n    const deleted = layer.deleteElement(id);\n    if (!deleted) {\n      console.error(ansis.red(`Error: Failed to delete element ${id}`));\n      process.exit(1);\n    }\n\n    // Delete all relationships involving this element\n    model.relationships.deleteForElement(id);\n\n    // Track change in active changeset if present\n    const activeChangeset = model.getActiveChangesetContext();\n    await activeChangeset.trackChange(\n      'delete',\n      id,\n      layerName,\n      beforeState as unknown as Record<string, unknown>,\n      undefined\n    );\n\n    // Save layer and manifest\n    await model.saveLayer(layerName);\n\n    // Only save relationships if they were modified\n    if (model.relationships.isDirty()) {\n      await model.saveRelationships();\n    }\n\n    await model.saveManifest();\n\n    if (isTelemetryEnabled && span) {\n      (span as any).setAttribute('layer.name', layerName);\n    }\n\n    console.log(ansis.green(`\u2713 Deleted element ${ansis.bold(id)}`));\n    if (options.verbose) {\n      console.log(ansis.dim(`  Layer: ${layerName}`));\n    }\n  } catch (error) {\n    if (isTelemetryEnabled && span) {\n      (span as any).recordException(error as Error);\n      (span as any).setStatus({ code: 2, message: (error as Error).message });\n    }\n    const message = error instanceof Error ? error.message : String(error);\n    console.error(ansis.red(`Error: ${message}`));\n    process.exit(1);\n  } finally {\n    if (isTelemetryEnabled) {\n      endSpan(span);\n    }\n  }\n}\n"],
-  "mappings": "AAIA,SAAS,eAAe;AACxB,OAAO,WAAW;AAClB,SAAS,aAAa;AACtB,SAAS,wBAAwB;AACjC,SAAS,WAAW,eAAe;AAGnC,MAAM,qBAAgE;AAQtE,eAAsB,cAAc,IAAY,SAAsB;AACpE,QAAM,OAAO,qBAAqB,UAAU,kBAAkB;IAC5D,cAAc;IACd,iBAAiB,CAAC,CAAC,QAAQ;GAC5B,IAAI;AAEL,MAAI;AAEF,UAAM,QAAQ,MAAM,MAAM,KAAI,GAGxB,YAAY,MAAM,iBAAiB,OAAO,EAAE;AAClD,IAAK,cACH,QAAQ,MAAM,MAAM,IAAI,kBAAkB,EAAE,YAAY,CAAC,GACzD,QAAQ,KAAK,CAAC,IAIX,QAAQ,SACO,MAAM,QAAQ;MAC9B,SAAS,kBAAkB,MAAM,KAAK,EAAE,CAAC;MACzC,cAAc;KACf,MAGC,QAAQ,IAAI,MAAM,IAAI,WAAW,CAAC,GAClC,QAAQ,KAAK,CAAC;AAIlB,UAAM,QAAS,MAAM,MAAM,SAAS,SAAS,GAIvC,cADU,MAAM,WAAW,EAAE,EACP,OAAM;AAIlC,IADgB,MAAM,cAAc,EAAE,MAEpC,QAAQ,MAAM,MAAM,IAAI,mCAAmC,EAAE,EAAE,CAAC,GAChE,QAAQ,KAAK,CAAC,IAIhB,MAAM,cAAc,iBAAiB,EAAE,GAIvC,MADwB,MAAM,0BAAyB,EACjC,YACpB,UACA,IACA,WACA,aACA,MAAS,GAIX,MAAM,MAAM,UAAU,SAAS,GAG3B,MAAM,cAAc,QAAO,KAC7B,MAAM,MAAM,kBAAiB,GAG/B,MAAM,MAAM,aAAY,GAEpB,sBAAsB,QACvB,KAAa,aAAa,cAAc,SAAS,GAGpD,QAAQ,IAAI,MAAM,MAAM,0BAAqB,MAAM,KAAK,EAAE,CAAC,EAAE,CAAC,GAC1D,QAAQ,WACV,QAAQ,IAAI,MAAM,IAAI,YAAY,SAAS,EAAE,CAAC;EAElD,SAAS,OAAO;AACd,IAAI,sBAAsB,SACvB,KAAa,gBAAgB,KAAc,GAC3C,KAAa,UAAU,EAAE,MAAM,GAAG,SAAU,MAAgB,QAAO,CAAE;AAExE,UAAM,UAAU,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AACrE,YAAQ,MAAM,MAAM,IAAI,UAAU,OAAO,EAAE,CAAC,GAC5C,QAAQ,KAAK,CAAC;EAChB;AACE,IAAI,sBACF,QAAQ,IAAI;EAEhB;AACF;",
-  "names": []
+  "sourcesContent": ["/**\n * Delete an element\n */\n\nimport { confirm } from \"@clack/prompts\";\nimport ansis from \"ansis\";\nimport { Model } from \"../core/model.js\";\nimport { MutationHandler } from \"../core/mutation-handler.js\";\nimport { ReferenceRegistry } from \"../core/reference-registry.js\";\nimport { DependencyTracker, TraceDirection } from \"../core/dependency-tracker.js\";\nimport { findElementLayer } from \"../utils/element-utils.js\";\nimport { CLIError, handleError, handleSuccess, ErrorCategory, ModelNotFoundError } from \"../utils/errors.js\";\nimport { startSpan, endSpan } from \"../telemetry/index.js\";\nimport { getErrorMessage } from \"../utils/errors.js\";\n\ndeclare const TELEMETRY_ENABLED: boolean | undefined;\nconst isTelemetryEnabled = typeof TELEMETRY_ENABLED !== \"undefined\" ? TELEMETRY_ENABLED : false;\n\nexport interface DeleteOptions {\n  force?: boolean;\n  verbose?: boolean;\n  debug?: boolean;\n  cascade?: boolean;\n  dryRun?: boolean;\n}\n\nexport async function deleteCommand(id: string, options: DeleteOptions): Promise<void> {\n  const span = isTelemetryEnabled\n    ? startSpan(\"element.delete\", {\n        \"element.id\": id,\n        \"element.force\": !!options.force,\n        \"element.cascade\": !!options.cascade,\n        \"element.dryRun\": !!options.dryRun,\n      })\n    : null;\n\n  try {\n    // Load model (with error handling for missing models)\n    let model: Model;\n    try {\n      model = await Model.load();\n    } catch (error) {\n      const message = getErrorMessage(error);\n      if (message.includes(\"No DR project\") || message.includes(\"Model not found\")) {\n        throw new ModelNotFoundError();\n      }\n      throw error;\n    }\n\n    // Find element\n    const layerName = await findElementLayer(model, id);\n    if (!layerName) {\n      throw new CLIError(`Element ${id} not found`, ErrorCategory.USER, [\n        `Use \"dr search ${id}\" to find similar elements`,\n        'Use \"dr list <layer>\" to list all elements in a layer',\n      ]);\n    }\n\n    const layer = (await model.getLayer(layerName))!;\n    const element = layer.getElement(id);\n\n    if (!element) {\n      throw new CLIError(`Element ${id} not found`, ErrorCategory.USER, [\n        `Use \"dr search ${id}\" to find similar elements`,\n        'Use \"dr list <layer>\" to list all elements in a layer',\n      ]);\n    }\n\n    // Build reference registry to track dependencies\n    const registry = new ReferenceRegistry();\n    for (const layer of model.layers.values()) {\n      for (const element of layer.listElements()) {\n        registry.registerElement(element);\n      }\n    }\n\n    // Create dependency tracker\n    const tracker = new DependencyTracker(registry, model);\n\n    // Find all elements that depend on this element (would be orphaned)\n    const dependents = tracker.traceDependencies(id, TraceDirection.DOWN, null);\n\n    // Display element information\n    console.log(\"\");\n    console.log(ansis.bold(`Removing element: ${ansis.yellow(id)}`));\n    console.log(ansis.dim(`  Layer: ${layerName}`));\n    console.log(ansis.dim(`  Type: ${element.type || \"unknown\"}`));\n    if (element.name) {\n      console.log(ansis.dim(`  Name: ${element.name}`));\n    }\n\n    // Display dependencies if any exist\n    if (dependents.length > 0) {\n      console.log(\"\");\n      console.log(\n        ansis.yellow(`\u26A0 Warning: This element has ${dependents.length} dependent element(s):`)\n      );\n\n      const directDependents = tracker.traceDependencies(id, TraceDirection.DOWN, 1);\n\n      // Show direct dependents\n      for (const dep of directDependents.slice(0, 5)) {\n        const depElement = model.getElementById(dep);\n        const depLayer = depElement?.layer || \"unknown\";\n        console.log(ansis.dim(`  - ${dep} (${depLayer})`));\n      }\n\n      if (directDependents.length > 5) {\n        console.log(ansis.dim(`  ... and ${directDependents.length - 5} more direct dependents`));\n      }\n\n      if (dependents.length > directDependents.length) {\n        console.log(\n          ansis.dim(\n            `  (${dependents.length - directDependents.length} transitive dependents not shown)`\n          )\n        );\n      }\n\n      // Check if cascade or force is enabled\n      if (!options.cascade && !options.force) {\n        console.log(\"\");\n        console.log(ansis.red(\"\u2717 Cannot remove element with dependencies.\"));\n        console.log(ansis.dim(\"Use --cascade to remove all dependent elements\"));\n        console.log(ansis.dim(\"or --force to skip dependency checks\"));\n        const suggestions = [\n          `Use --dry-run with --cascade to preview what would be deleted`,\n          'Review dependencies before deletion using \"dr show <element>\"',\n          \"Use --cascade to automatically remove all dependent elements\",\n          \"Or use --force to remove only this element (dependencies will reference a non-existent element)\",\n        ];\n        throw new CLIError(\"Element has dependencies\", ErrorCategory.USER, suggestions, {\n          operation: \"delete\",\n          relatedElements: directDependents.slice(0, 10),\n          context: `Element ${id} has ${dependents.length} dependent elements`,\n        });\n      }\n    }\n\n    // Calculate total elements to remove\n    const elementsToRemove = options.cascade ? [id, ...dependents] : [id];\n\n    // Display dry-run summary\n    if (options.dryRun) {\n      console.log(\"\");\n      console.log(ansis.yellow(`Dry run - not removing`));\n      console.log(ansis.dim(`Would remove ${elementsToRemove.length} element(s)`));\n\n      if (options.cascade && dependents.length > 0) {\n        console.log(\"\");\n        console.log(ansis.dim(\"Elements that would be removed:\"));\n        console.log(ansis.dim(`  - ${id} (target)`));\n        for (const dep of dependents.slice(0, 10)) {\n          console.log(ansis.dim(`  - ${dep} (dependent)`));\n        }\n        if (dependents.length > 10) {\n          console.log(ansis.dim(`  ... and ${dependents.length - 10} more`));\n        }\n      }\n\n      return;\n    }\n\n    // Confirm deletion unless --force\n    if (!options.force) {\n      const isInteractive = process.stdin.isTTY && process.stdout.isTTY;\n      if (!isInteractive) {\n        console.log(ansis.dim(\"Non-interactive environment detected - proceeding without confirmation\"));\n      } else {\n        const message =\n          options.cascade && dependents.length > 0\n            ? `Delete ${ansis.bold(id)} and ${ansis.bold(String(dependents.length))} dependent element(s)? This cannot be undone.`\n            : `Delete element ${ansis.bold(id)}? This cannot be undone.`;\n\n        const confirmed = await confirm({\n          message,\n          initialValue: false,\n        });\n\n        if (!confirmed) {\n          console.log(ansis.dim(\"Cancelled\"));\n          return;\n        }\n      }\n    }\n\n    // Execute deletion with error recovery guidance\n    let deletedCount = 0;\n    try {\n      if (options.cascade && dependents.length > 0) {\n        // Delete dependents first (reverse dependency order to avoid orphaned references)\n        const sortedDependents = [...dependents].reverse();\n\n        for (const depId of sortedDependents) {\n          try {\n            const depLayerName = await findElementLayer(model, depId);\n            if (!depLayerName) continue;\n\n            const depLayer = (await model.getLayer(depLayerName))!;\n            const depElement = depLayer.getElement(depId)!;\n\n            const handler = new MutationHandler(model, depId, depLayerName);\n            await handler.executeDelete(depElement);\n            deletedCount++;\n\n            if (options.verbose) {\n              console.log(ansis.dim(`  Deleted dependent: ${depId}`));\n            }\n          } catch (depError) {\n            // Track partial progress for error recovery\n            const suggestions = [\n              `${deletedCount} dependent element(s) were deleted before the error`,\n              'Check the model state with \"dr validate\" to identify any broken references',\n              'You may need to manually delete remaining elements or use \"dr show\" to inspect',\n            ];\n            throw new CLIError(\n              `Failed to delete dependent element ${depId}`,\n              ErrorCategory.SYSTEM,\n              suggestions,\n              {\n                operation: \"delete (cascade)\",\n                partialProgress: { completed: deletedCount, total: sortedDependents.length },\n                relatedElements: [id, ...sortedDependents.slice(0, 5)],\n              }\n            );\n          }\n        }\n      }\n    } catch (error) {\n      // If we're in the middle of cascade deletion, provide recovery info\n      if (options.cascade && deletedCount > 0 && !(error instanceof CLIError)) {\n        const suggestions = [\n          `${deletedCount} dependent element(s) were successfully deleted`,\n          'Use \"dr validate\" to check for broken references',\n          \"The target element was not deleted - you can retry the operation\",\n        ];\n        throw new CLIError(\n          \"Cascade deletion was partially completed but encountered an error\",\n          ErrorCategory.SYSTEM,\n          suggestions,\n          {\n            operation: \"delete (cascade)\",\n            partialProgress: { completed: deletedCount, total: dependents.length },\n          }\n        );\n      }\n      throw error;\n    }\n\n    // Delete the target element\n    const handler = new MutationHandler(model, id, layerName);\n    await handler.executeDelete(element);\n\n    if (isTelemetryEnabled && span) {\n      (span as any).setAttribute(\"layer.name\", layerName);\n      (span as any).setAttribute(\"element.dependents\", dependents.length);\n      (span as any).setAttribute(\"element.totalDeleted\", elementsToRemove.length);\n    }\n\n    // Check if operation was staged or applied to base model\n    const beforeState = handler.getBeforeState();\n    if (beforeState) {\n      // Check if we went through staging path\n      const stagingManager = handler.getStagingManager();\n      const activeChangeset = await stagingManager.getActive();\n      if (activeChangeset && activeChangeset.status === \"staged\") {\n        // Staging path\n        handleSuccess(\n          `Staged deletion of element ${ansis.bold(id)} to ${ansis.bold(activeChangeset.name)}`,\n          {\n            status: \"staged\",\n            changeset: activeChangeset.name,\n          }\n        );\n      } else {\n        // Base model path: purge any stale relationships MutationHandler may have missed\n        const staleBase = elementsToRemove.reduce(\n          (n, eid) => n + model.relationships.deleteForElement(eid), 0\n        );\n        if (staleBase > 0) await model.saveRelationships();\n\n        console.log(\"\");\n        console.log(ansis.green(`\u2713 Deleted element ${ansis.bold(id)}`));\n\n        if (options.cascade && dependents.length > 0) {\n          console.log(ansis.green(`\u2713 Deleted ${dependents.length} dependent element(s)`));\n        }\n\n        if (options.verbose) {\n          console.log(ansis.dim(`  Layer: ${layerName}`));\n          console.log(ansis.dim(`  Total elements deleted: ${elementsToRemove.length}`));\n        }\n      }\n    } else {\n      // Fallback success message if before state is not available\n      // This should rarely occur, but ensures user always gets feedback\n      const staleFallback = elementsToRemove.reduce(\n        (n, eid) => n + model.relationships.deleteForElement(eid), 0\n      );\n      if (staleFallback > 0) await model.saveRelationships();\n\n      console.log(\"\");\n      console.log(ansis.green(`\u2713 Deleted element ${ansis.bold(id)}`));\n\n      if (options.cascade && dependents.length > 0) {\n        console.log(ansis.green(`\u2713 Deleted ${dependents.length} dependent element(s)`));\n      }\n\n      if (options.verbose) {\n        console.log(ansis.dim(`  Layer: ${layerName}`));\n        console.log(ansis.dim(`  Total elements deleted: ${elementsToRemove.length}`));\n      }\n    }\n  } catch (error) {\n    if (isTelemetryEnabled && span) {\n      (span as any).recordException(error as Error);\n      (span as any).setStatus({ code: 2, message: (error as Error).message });\n    }\n    handleError(error);\n  } finally {\n    if (isTelemetryEnabled) {\n      endSpan(span);\n    }\n  }\n}\n"],
+  "mappings": "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",
+  "names": ["layer", "element"]
 }

package/dist/commands/discover-logic.js

@@ -0,0 +1,44 @@
+import { MappingLoader } from "../analyzers/mapping-loader.js";
+async function performDiscover(registry, options = {}) {
+  const analyzerNames = await registry.getAnalyzerNames();
+  if (analyzerNames.length === 0)
+    throw new Error("No analyzers registered in the specification");
+  const analyzerOptions = [];
+  for (const name of analyzerNames)
+    try {
+      const backend = await registry.getAnalyzer(name);
+      if (!backend)
+        continue;
+      const detection = await backend.detect(), metadata = (await MappingLoader.load(name)).getAnalyzerMetadata();
+      analyzerOptions.push({
+        backend,
+        detection,
+        metadata
+      });
+    } catch (error) {
+      const errorMsg = error instanceof Error ? error.message : String(error);
+      console.error(`Failed to discover analyzer "${name}": ${errorMsg}`);
+    }
+  const installed = analyzerOptions.filter((a) => a.detection.installed), discoveryResult = {
+    found: analyzerOptions.map((a) => ({
+      name: a.backend.name,
+      display_name: a.backend.displayName,
+      description: a.metadata?.description || "",
+      homepage: a.metadata?.homepage || "",
+      installed: a.detection.installed
+    })),
+    installed_count: installed.length
+  };
+  let selectedAnalyzer, shouldWriteSession = !1;
+  return options.json ? !options.isTTY && installed.length > 0 && (selectedAnalyzer = installed[0].backend.name, shouldWriteSession = !0, discoveryResult.selected = selectedAnalyzer) : !options.isTTY && installed.length > 0 ? (selectedAnalyzer = installed[0].backend.name, shouldWriteSession = !0) : installed.length > 0 && options.isTTY && (shouldWriteSession = !1), {
+    discoveryResult,
+    installed,
+    analyzerOptions,
+    selectedAnalyzer,
+    shouldWriteSession
+  };
+}
+export {
+  performDiscover
+};
+//# sourceMappingURL=discover-logic.js.map

package/dist/commands/discover-logic.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/commands/discover-logic.ts"],
+  "sourcesContent": ["/**\n * Core discover logic - separated from CLI I/O for testability\n *\n * This module contains the business logic for analyzer discovery,\n * separated from CLI output and user interaction.\n */\n\nimport { AnalyzerRegistry } from \"../analyzers/registry.js\";\nimport { MappingLoader } from \"../analyzers/mapping-loader.js\";\nimport type { DiscoveryResult, AvailableAnalyzer } from \"../analyzers/types.js\";\n\nexport interface DiscoverOptions {\n  json?: boolean;\n  reselect?: boolean;\n  isTTY?: boolean;\n}\n\nexport interface DiscoverAnalyzerOption {\n  backend: any;\n  detection: any;\n  metadata: any;\n}\n\n/**\n * Core discover logic - discovers installed analyzers and determines what action to take\n *\n * Returns:\n * - discoveryResult: The JSON-serializable discovery result\n * - installed: Array of installed analyzers\n * - analyzerOptions: All discovered analyzers (installed and uninstalled)\n */\nexport async function performDiscover(\n  registry: AnalyzerRegistry,\n  options: DiscoverOptions = {}\n): Promise<{\n  discoveryResult: DiscoveryResult;\n  installed: DiscoverAnalyzerOption[];\n  analyzerOptions: DiscoverAnalyzerOption[];\n  selectedAnalyzer?: string;\n  shouldWriteSession: boolean;\n}> {\n  const analyzerNames = await registry.getAnalyzerNames();\n\n  if (analyzerNames.length === 0) {\n    throw new Error(\"No analyzers registered in the specification\");\n  }\n\n  // Get metadata for each analyzer\n  const analyzerOptions: DiscoverAnalyzerOption[] = [];\n  for (const name of analyzerNames) {\n    try {\n      const backend = await registry.getAnalyzer(name);\n      if (!backend) continue;\n\n      const detection = await backend.detect();\n      const mapper = await MappingLoader.load(name);\n      const metadata = mapper.getAnalyzerMetadata();\n\n      analyzerOptions.push({\n        backend,\n        detection,\n        metadata,\n      });\n    } catch (error) {\n      // Log error but continue discovering other analyzers\n      const errorMsg = error instanceof Error ? error.message : String(error);\n      console.error(`Failed to discover analyzer \"${name}\": ${errorMsg}`);\n    }\n  }\n\n  // Find installed analyzers\n  const installed = analyzerOptions.filter((a) => a.detection.installed);\n\n  // Build the discovery result (used for JSON output)\n  const found: AvailableAnalyzer[] = analyzerOptions.map((a) => ({\n    name: a.backend.name,\n    display_name: a.backend.displayName,\n    description: a.metadata?.description || \"\",\n    homepage: a.metadata?.homepage || \"\",\n    installed: a.detection.installed,\n  }));\n\n  const discoveryResult: DiscoveryResult = {\n    found,\n    installed_count: installed.length,\n  };\n\n  let selectedAnalyzer: string | undefined;\n  let shouldWriteSession = false;\n\n  // Determine session and selection behavior\n  if (options.json) {\n    // JSON mode: auto-select in non-TTY only if analyzers are installed\n    if (!options.isTTY && installed.length > 0) {\n      selectedAnalyzer = installed[0].backend.name;\n      shouldWriteSession = true;\n      discoveryResult.selected = selectedAnalyzer;\n    }\n    // TTY mode or no installed analyzers: don't set selected field\n  } else {\n    // Text mode: in non-TTY, auto-select only if analyzers are installed\n    if (!options.isTTY && installed.length > 0) {\n      selectedAnalyzer = installed[0].backend.name;\n      shouldWriteSession = true;\n    } else if (installed.length > 0 && options.isTTY) {\n      // TTY mode with installed analyzers: will prompt, session will be written after selection\n      shouldWriteSession = false; // CLI handler will write after prompt\n    }\n    // If no analyzers installed: don't select or write session\n  }\n\n  return {\n    discoveryResult,\n    installed,\n    analyzerOptions,\n    selectedAnalyzer,\n    shouldWriteSession,\n  };\n}\n"],
+  "mappings": "AAQA,SAAS,qBAAqB;AAuB9B,eAAsB,gBACpB,UACA,UAA2B,CAAA,GAAE;AAQ7B,QAAM,gBAAgB,MAAM,SAAS,iBAAgB;AAErD,MAAI,cAAc,WAAW;AAC3B,UAAM,IAAI,MAAM,8CAA8C;AAIhE,QAAM,kBAA4C,CAAA;AAClD,aAAW,QAAQ;AACjB,QAAI;AACF,YAAM,UAAU,MAAM,SAAS,YAAY,IAAI;AAC/C,UAAI,CAAC;AAAS;AAEd,YAAM,YAAY,MAAM,QAAQ,OAAM,GAEhC,YADS,MAAM,cAAc,KAAK,IAAI,GACpB,oBAAmB;AAE3C,sBAAgB,KAAK;QACnB;QACA;QACA;OACD;IACH,SAAS,OAAO;AAEd,YAAM,WAAW,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AACtE,cAAQ,MAAM,gCAAgC,IAAI,MAAM,QAAQ,EAAE;IACpE;AAIF,QAAM,YAAY,gBAAgB,OAAO,CAAC,MAAM,EAAE,UAAU,SAAS,GAW/D,kBAAmC;IACvC,OATiC,gBAAgB,IAAI,CAAC,OAAO;MAC7D,MAAM,EAAE,QAAQ;MAChB,cAAc,EAAE,QAAQ;MACxB,aAAa,EAAE,UAAU,eAAe;MACxC,UAAU,EAAE,UAAU,YAAY;MAClC,WAAW,EAAE,UAAU;MACvB;IAIA,iBAAiB,UAAU;;AAG7B,MAAI,kBACA,qBAAqB;AAGzB,SAAI,QAAQ,OAEN,CAAC,QAAQ,SAAS,UAAU,SAAS,MACvC,mBAAmB,UAAU,CAAC,EAAE,QAAQ,MACxC,qBAAqB,IACrB,gBAAgB,WAAW,oBAKzB,CAAC,QAAQ,SAAS,UAAU,SAAS,KACvC,mBAAmB,UAAU,CAAC,EAAE,QAAQ,MACxC,qBAAqB,MACZ,UAAU,SAAS,KAAK,QAAQ,UAEzC,qBAAqB,KAKlB;IACL;IACA;IACA;IACA;IACA;;AAEJ;",
+  "names": []
+}

package/dist/commands/docs.js

@@ -0,0 +1,87 @@
+import * as fs from "fs";
+import * as path from "path";
+import { execFileSync } from "child_process";
+import { fileExists, ensureDir } from "../utils/file-io.js";
+import { existsSync } from "fs";
+import { isValidLayer, getAllLayerIds } from "../generated/layer-registry.js";
+async function docsGenerateCommand(options) {
+  const projectRoot = process.cwd(), specDir = path.join(projectRoot, "spec");
+  if (!existsSync(specDir))
+    throw new Error(`Specification directory not found at ${specDir}. Are you in a Documentation Robotics project?`);
+  if (options.layer && !isValidLayer(options.layer))
+    throw new Error(`Invalid layer name: ${options.layer}. Must be one of: ${getAllLayerIds().join(", ")}`);
+  const outputDir = options.output ? path.resolve(options.output) : specDir;
+  if (!path.resolve(outputDir).startsWith(projectRoot))
+    throw new Error(`Output directory must be within project root. Requested: ${outputDir}, Project root: ${projectRoot}`);
+  await ensureDir(outputDir);
+  try {
+    const args = ["run", "scripts/generate-layer-docs.ts"];
+    options.layer && args.push("--layer", options.layer), outputDir !== specDir && args.push("--output", outputDir), console.log("\u{1F4DA} Generating documentation..."), execFileSync("bun", args, { cwd: projectRoot, stdio: "inherit" }), console.log(`
+\u2705 Documentation generation complete at: ${outputDir}`);
+  } catch (error) {
+    throw error instanceof Error ? new Error(`Documentation generation failed: ${error.message}`) : error;
+  }
+}
+async function docsValidateCommand(options) {
+  const projectRoot = process.cwd(), specDir = path.join(projectRoot, "spec"), layersDir = path.join(specDir, "layers");
+  if (!existsSync(specDir))
+    throw new Error(`Specification directory not found at ${specDir}. Are you in a Documentation Robotics project?`);
+  console.log("\u{1F50D} Validating documentation sync with schemas...");
+  const tempDir = path.join(projectRoot, ".tmp-doc-validation");
+  await ensureDir(tempDir);
+  try {
+    try {
+      execFileSync("bun", ["run", "scripts/generate-layer-docs.ts", "--output", tempDir], {
+        cwd: projectRoot,
+        stdio: "pipe"
+      });
+    } catch (error) {
+      const stderr = error.stderr?.toString() || error.message || String(error);
+      throw new Error(`Failed to generate documentation for validation: ${stderr}`);
+    }
+    const generatedFiles = fs.readdirSync(tempDir).filter((f) => f.endsWith(".md"));
+    let hasDiscrepancies = !1;
+    const discrepancies = [];
+    for (const file of generatedFiles) {
+      if (file === "INDEX.md")
+        continue;
+      const existingPath = path.join(layersDir, file), generatedPath = path.join(tempDir, file);
+      if (!await fileExists(existingPath)) {
+        discrepancies.push(`\u274C Missing file: ${file}`), hasDiscrepancies = !0;
+        continue;
+      }
+      const existingContent = fs.readFileSync(existingPath, "utf-8"), generatedContent = fs.readFileSync(generatedPath, "utf-8");
+      existingContent !== generatedContent && (discrepancies.push(`\u274C File out of sync: ${file} (generated content differs from existing)`), hasDiscrepancies = !0);
+    }
+    hasDiscrepancies ? (console.log(`
+\u274C Documentation is out of sync with schemas:
+`), discrepancies.forEach((d) => console.log(`  ${d}`)), console.log(`
+Run 'dr docs generate' to update documentation.`), options.strict && process.exit(1)) : console.log(`
+\u2705 Documentation is in sync with schemas!`);
+  } finally {
+    existsSync(tempDir) && fs.rmSync(tempDir, { recursive: !0 });
+  }
+}
+function docsCommands(program) {
+  const docsCommand = program.command("docs").description("Manage documentation generation and validation");
+  docsCommand.command("generate").description("Generate markdown documentation from schema definitions").option("--layer <layer>", "Generate specific layer (optional)").option("--output <dir>", "Output directory (defaults to spec/layers/)").addHelpText("after", `
+Examples:
+  $ dr docs generate                       # Generate all layer docs
+  $ dr docs generate --layer motivation    # Generate motivation layer only
+  $ dr docs generate --output ./docs/      # Output to custom directory
+
+Note: Requires spec/layers/*.layer.json and spec/schemas/nodes/**/*.node.schema.json files.
+The generation script reads these spec instances and creates markdown documentation.`).action(docsGenerateCommand), docsCommand.command("validate").description("Validate that documentation is in sync with schema definitions").option("--strict", "Exit with error code if documentation is out of sync").addHelpText("after", `
+Examples:
+  $ dr docs validate           # Check if docs are in sync
+  $ dr docs validate --strict  # Exit with error if out of sync (for CI)
+
+This command generates documentation from schemas and compares it with existing
+documentation to ensure they are in sync.`).action(docsValidateCommand);
+}
+export {
+  docsCommands,
+  docsGenerateCommand,
+  docsValidateCommand
+};
+//# sourceMappingURL=docs.js.map

package/dist/commands/docs.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/commands/docs.ts"],
+  "sourcesContent": ["/**\n * Documentation Generation Commands\n *\n * Implements schema-driven documentation generation:\n * - `dr docs generate` - Generate markdown documentation from spec instances\n * - `dr docs validate` - Validate that documentation is in sync with schemas\n */\n\nimport * as fs from \"fs\";\nimport * as path from \"path\";\nimport { execFileSync } from \"child_process\";\nimport { fileExists, ensureDir } from \"../utils/file-io.js\";\nimport { existsSync } from \"fs\";\nimport { isValidLayer, getAllLayerIds } from \"../generated/layer-registry.js\";\n\ninterface GenerateOptions {\n  output?: string;\n  layer?: string;\n}\n\ninterface ValidateOptions {\n  strict?: boolean;\n}\n\n/**\n * Generate documentation from schema definitions\n */\nexport async function docsGenerateCommand(options: GenerateOptions): Promise<void> {\n  const projectRoot = process.cwd();\n  const specDir = path.join(projectRoot, \"spec\");\n\n  // Validate spec directory exists\n  if (!existsSync(specDir)) {\n    throw new Error(\n      `Specification directory not found at ${specDir}. Are you in a Documentation Robotics project?`\n    );\n  }\n\n  // Validate layer name if provided\n  if (options.layer && !isValidLayer(options.layer)) {\n    throw new Error(\n      `Invalid layer name: ${options.layer}. ` +\n      `Must be one of: ${getAllLayerIds().join(\", \")}`\n    );\n  }\n\n  // Determine output directory\n  const outputDir = options.output ? path.resolve(options.output) : specDir;\n\n  // Validate output directory path to prevent path traversal\n  const resolvedOutputDir = path.resolve(outputDir);\n  if (!resolvedOutputDir.startsWith(projectRoot)) {\n    throw new Error(\n      `Output directory must be within project root. ` +\n      `Requested: ${outputDir}, Project root: ${projectRoot}`\n    );\n  }\n\n  // Ensure output directory exists\n  await ensureDir(outputDir);\n\n  try {\n    // Build command arguments safely without shell string concatenation\n    const args = [\"run\", \"scripts/generate-layer-docs.ts\"];\n\n    if (options.layer) {\n      args.push(\"--layer\", options.layer);\n    }\n\n    if (outputDir !== specDir) {\n      args.push(\"--output\", outputDir);\n    }\n\n    console.log(`\uD83D\uDCDA Generating documentation...`);\n    execFileSync(\"bun\", args, { cwd: projectRoot, stdio: \"inherit\" });\n    console.log(`\\n\u2705 Documentation generation complete at: ${outputDir}`);\n  } catch (error) {\n    if (error instanceof Error) {\n      throw new Error(`Documentation generation failed: ${error.message}`);\n    }\n    throw error;\n  }\n}\n\n/**\n * Validate that documentation is in sync with schemas\n */\nexport async function docsValidateCommand(options: ValidateOptions): Promise<void> {\n  const projectRoot = process.cwd();\n  const specDir = path.join(projectRoot, \"spec\");\n  const layersDir = path.join(specDir, \"layers\");\n\n  // Validate spec directory exists\n  if (!existsSync(specDir)) {\n    throw new Error(\n      `Specification directory not found at ${specDir}. Are you in a Documentation Robotics project?`\n    );\n  }\n\n  console.log(`\uD83D\uDD0D Validating documentation sync with schemas...`);\n\n  // Create temporary directory for generated docs\n  const tempDir = path.join(projectRoot, \".tmp-doc-validation\");\n  await ensureDir(tempDir);\n\n  try {\n    // Generate documentation to temp directory using safe argument passing\n    try {\n      execFileSync(\"bun\", [\"run\", \"scripts/generate-layer-docs.ts\", \"--output\", tempDir], {\n        cwd: projectRoot,\n        stdio: \"pipe\",\n      });\n    } catch (error) {\n      const stderr = (error as any).stderr?.toString() || (error as Error).message || String(error);\n      throw new Error(`Failed to generate documentation for validation: ${stderr}`);\n    }\n\n    // Compare generated docs with existing docs\n    const generatedFiles = fs.readdirSync(tempDir).filter((f) => f.endsWith(\".md\"));\n\n    let hasDiscrepancies = false;\n    const discrepancies: string[] = [];\n\n    // Check for missing files\n    for (const file of generatedFiles) {\n      if (file === \"INDEX.md\") continue; // Skip index file in validation\n\n      const existingPath = path.join(layersDir, file);\n      const generatedPath = path.join(tempDir, file);\n\n      if (!(await fileExists(existingPath))) {\n        discrepancies.push(`\u274C Missing file: ${file}`);\n        hasDiscrepancies = true;\n        continue;\n      }\n\n      // Compare content\n      const existingContent = fs.readFileSync(existingPath, \"utf-8\");\n      const generatedContent = fs.readFileSync(generatedPath, \"utf-8\");\n\n      if (existingContent !== generatedContent) {\n        discrepancies.push(\n          `\u274C File out of sync: ${file} (generated content differs from existing)`\n        );\n        hasDiscrepancies = true;\n      }\n    }\n\n    // Report results\n    if (hasDiscrepancies) {\n      console.log(`\\n\u274C Documentation is out of sync with schemas:\\n`);\n      discrepancies.forEach((d) => console.log(`  ${d}`));\n      console.log(`\\nRun 'dr docs generate' to update documentation.`);\n\n      if (options.strict) {\n        process.exit(1);\n      }\n    } else {\n      console.log(`\\n\u2705 Documentation is in sync with schemas!`);\n    }\n  } finally {\n    // Clean up temporary directory\n    if (existsSync(tempDir)) {\n      fs.rmSync(tempDir, { recursive: true });\n    }\n  }\n}\n\n/**\n * Register docs commands with Commander\n */\nexport function docsCommands(program: any): void {\n  const docsCommand = program\n    .command(\"docs\")\n    .description(\"Manage documentation generation and validation\");\n\n  docsCommand\n    .command(\"generate\")\n    .description(\"Generate markdown documentation from schema definitions\")\n    .option(\"--layer <layer>\", \"Generate specific layer (optional)\")\n    .option(\"--output <dir>\", \"Output directory (defaults to spec/layers/)\")\n    .addHelpText(\n      \"after\",\n      `\nExamples:\n  $ dr docs generate                       # Generate all layer docs\n  $ dr docs generate --layer motivation    # Generate motivation layer only\n  $ dr docs generate --output ./docs/      # Output to custom directory\n\nNote: Requires spec/layers/*.layer.json and spec/schemas/nodes/**/*.node.schema.json files.\nThe generation script reads these spec instances and creates markdown documentation.`\n    )\n    .action(docsGenerateCommand);\n\n  docsCommand\n    .command(\"validate\")\n    .description(\"Validate that documentation is in sync with schema definitions\")\n    .option(\"--strict\", \"Exit with error code if documentation is out of sync\")\n    .addHelpText(\n      \"after\",\n      `\nExamples:\n  $ dr docs validate           # Check if docs are in sync\n  $ dr docs validate --strict  # Exit with error if out of sync (for CI)\n\nThis command generates documentation from schemas and compares it with existing\ndocumentation to ensure they are in sync.`\n    )\n    .action(docsValidateCommand);\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/commands/element.js

@@ -1,26 +1,20 @@
 import { addCommand } from "./add.js";
-import { updateCommand } from "./update.js";
-import { deleteCommand } from "./delete.js";
-import { showCommand } from "./show.js";
 import { listCommand } from "./list.js";
+import { showCommand } from "./show.js";
+import { deleteCommand } from "./delete.js";
+import { updateCommand } from "./update.js";
 function elementCommands(program) {
-  program.command("add <layer> <type> <id>").description("Add an element to a layer").option("--name <name>", "Element name (defaults to ID)").option("--description <desc>", "Element description").option("--properties <json>", "Element properties as JSON object").addHelpText("after", `
-Examples:
-  $ dr element add business business-service customer-mgmt --name "Customer Management"
-  $ dr element add api endpoint create-customer --properties '{"method":"POST","path":"/customers"}'`).action(addCommand), program.command("update <id>").description("Update an element").option("--name <name>", "New element name").option("--description <desc>", "New description").option("--properties <json>", "Updated properties (JSON)").addHelpText("after", `
-Examples:
-  $ dr element update api-endpoint-create-customer --name "Create Customer (v2)"
-  $ dr element update business-service-order --description "Updated description"`).action(updateCommand), program.command("delete <id>").description("Delete an element").option("--force", "Skip confirmation prompt").addHelpText("after", `
-Examples:
-  $ dr element delete api-endpoint-old-endpoint
-  $ dr element delete api-endpoint-old-endpoint --force`).action(deleteCommand), program.command("show <id>").description("Display element details").addHelpText("after", `
-Examples:
-  $ dr element show api-endpoint-create-customer
-  $ dr element show business-service-order-mgmt`).action(showCommand), program.command("list <layer>").description("List elements in a layer").option("--type <type>", "Filter by element type").option("--json", "Output as JSON").addHelpText("after", `
-Examples:
-  $ dr element list api
-  $ dr element list business --type business-service
-  $ dr element list api --json`).action(listCommand);
+  program.command("add <layer> <type> <name>").description("Add an element to a layer").option("--name <name>", "Element display name (optional, defaults to provided name)").option("--description <description>", "Element description").option("--attributes <json>", "Element attributes as JSON (type-specific properties)").option("--source-file <path>", "Source file path").option("--source-symbol <symbol>", "Source symbol or line number").option("--source-provenance <provenance>", "Source provenance (manual or generated)").option("--source-repo-remote <remote>", "Source repository remote").option("--source-repo-commit <commit>", "Source repository commit hash").option("--verbose", "Show detailed output").option("--debug", "Enable debug output").action(async (layer, type, name, options) => {
+    await addCommand(layer, type, name, options);
+  }), program.command("list <layer>").description("List elements in a layer").option("--type <type>", "Filter by element type").option("--json", "Output as JSON").option("--verbose", "Show detailed output").option("--debug", "Enable debug output").action(async (layer, options) => {
+    await listCommand(layer, options);
+  }), program.command("show <id>").description("Display element details").option("--verbose", "Show detailed output").option("--debug", "Enable debug output").action(async (id, options) => {
+    await showCommand(id, options);
+  }), program.command("delete <id>").description("Delete an element").option("--force", "Skip confirmation prompt").option("--cascade", "Remove dependent elements automatically").option("--verbose", "Show detailed output").option("--debug", "Enable debug output").action(async (id, options) => {
+    await deleteCommand(id, options);
+  }), program.command("update <id>").description("Update an element").option("--name <name>", "New element name").option("--description <description>", "New description").option("--attributes <json>", "Element attributes as JSON (type-specific properties)").option("--source-file <path>", "Source file path").option("--source-symbol <symbol>", "Source symbol or line number").option("--source-provenance <provenance>", "Source provenance (manual or generated)").option("--source-repo-remote <remote>", "Source repository remote").option("--source-repo-commit <commit>", "Source repository commit hash").option("--clear-source-reference", "Remove source reference from element").option("--verbose", "Show detailed output").option("--debug", "Enable debug output").action(async (id, options) => {
+    await updateCommand(id, options);
+  });
 }
 export {
   elementCommands

package/dist/commands/element.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/commands/element.ts"],
-  "sourcesContent": ["/**\n * Element subcommands\n * Re-exports standalone commands as subcommands for consistency\n */\n\nimport { Command } from 'commander';\nimport { addCommand } from './add.js';\nimport { updateCommand } from './update.js';\nimport { deleteCommand } from './delete.js';\nimport { showCommand } from './show.js';\nimport { listCommand } from './list.js';\n\nexport function elementCommands(program: Command): void {\n  program\n    .command('add <layer> <type> <id>')\n    .description('Add an element to a layer')\n    .option('--name <name>', 'Element name (defaults to ID)')\n    .option('--description <desc>', 'Element description')\n    .option('--properties <json>', 'Element properties as JSON object')\n    .addHelpText(\n      'after',\n      `\nExamples:\n  $ dr element add business business-service customer-mgmt --name \"Customer Management\"\n  $ dr element add api endpoint create-customer --properties '{\"method\":\"POST\",\"path\":\"/customers\"}'`\n    )\n    .action(addCommand);\n\n  program\n    .command('update <id>')\n    .description('Update an element')\n    .option('--name <name>', 'New element name')\n    .option('--description <desc>', 'New description')\n    .option('--properties <json>', 'Updated properties (JSON)')\n    .addHelpText(\n      'after',\n      `\nExamples:\n  $ dr element update api-endpoint-create-customer --name \"Create Customer (v2)\"\n  $ dr element update business-service-order --description \"Updated description\"`\n    )\n    .action(updateCommand);\n\n  program\n    .command('delete <id>')\n    .description('Delete an element')\n    .option('--force', 'Skip confirmation prompt')\n    .addHelpText(\n      'after',\n      `\nExamples:\n  $ dr element delete api-endpoint-old-endpoint\n  $ dr element delete api-endpoint-old-endpoint --force`\n    )\n    .action(deleteCommand);\n\n  program\n    .command('show <id>')\n    .description('Display element details')\n    .addHelpText(\n      'after',\n      `\nExamples:\n  $ dr element show api-endpoint-create-customer\n  $ dr element show business-service-order-mgmt`\n    )\n    .action(showCommand);\n\n  program\n    .command('list <layer>')\n    .description('List elements in a layer')\n    .option('--type <type>', 'Filter by element type')\n    .option('--json', 'Output as JSON')\n    .addHelpText(\n      'after',\n      `\nExamples:\n  $ dr element list api\n  $ dr element list business --type business-service\n  $ dr element list api --json`\n    )\n    .action(listCommand);\n}\n"],
-  "mappings": "AAMA,SAAS,kBAAkB;AAC3B,SAAS,qBAAqB;AAC9B,SAAS,qBAAqB;AAC9B,SAAS,mBAAmB;AAC5B,SAAS,mBAAmB;AAEtB,SAAU,gBAAgB,SAAgB;AAC9C,UACG,QAAQ,yBAAyB,EACjC,YAAY,2BAA2B,EACvC,OAAO,iBAAiB,+BAA+B,EACvD,OAAO,wBAAwB,qBAAqB,EACpD,OAAO,uBAAuB,mCAAmC,EACjE,YACC,SACA;;;qGAG+F,EAEhG,OAAO,UAAU,GAEpB,QACG,QAAQ,aAAa,EACrB,YAAY,mBAAmB,EAC/B,OAAO,iBAAiB,kBAAkB,EAC1C,OAAO,wBAAwB,iBAAiB,EAChD,OAAO,uBAAuB,2BAA2B,EACzD,YACC,SACA;;;iFAG2E,EAE5E,OAAO,aAAa,GAEvB,QACG,QAAQ,aAAa,EACrB,YAAY,mBAAmB,EAC/B,OAAO,WAAW,0BAA0B,EAC5C,YACC,SACA;;;wDAGkD,EAEnD,OAAO,aAAa,GAEvB,QACG,QAAQ,WAAW,EACnB,YAAY,yBAAyB,EACrC,YACC,SACA;;;gDAG0C,EAE3C,OAAO,WAAW,GAErB,QACG,QAAQ,cAAc,EACtB,YAAY,0BAA0B,EACtC,OAAO,iBAAiB,wBAAwB,EAChD,OAAO,UAAU,gBAAgB,EACjC,YACC,SACA;;;;+BAIyB,EAE1B,OAAO,WAAW;AACvB;",
+  "sourcesContent": ["/**\n * Element subcommands for managing model elements\n * Provides an alternative way to access add, list, show, delete, and update commands\n * via an \"element\" subcommand group\n */\n\nimport { Command } from \"commander\";\nimport { addCommand } from \"./add.js\";\nimport { listCommand } from \"./list.js\";\nimport { showCommand } from \"./show.js\";\nimport { deleteCommand } from \"./delete.js\";\nimport { updateCommand } from \"./update.js\";\n\nexport function elementCommands(program: Command): void {\n  // element add <layer> <type> <name> [options]\n  program\n    .command(\"add <layer> <type> <name>\")\n    .description(\"Add an element to a layer\")\n    .option(\"--name <name>\", \"Element display name (optional, defaults to provided name)\")\n    .option(\"--description <description>\", \"Element description\")\n    .option(\"--attributes <json>\", \"Element attributes as JSON (type-specific properties)\")\n    .option(\"--source-file <path>\", \"Source file path\")\n    .option(\"--source-symbol <symbol>\", \"Source symbol or line number\")\n    .option(\"--source-provenance <provenance>\", \"Source provenance (manual or generated)\")\n    .option(\"--source-repo-remote <remote>\", \"Source repository remote\")\n    .option(\"--source-repo-commit <commit>\", \"Source repository commit hash\")\n    .option(\"--verbose\", \"Show detailed output\")\n    .option(\"--debug\", \"Enable debug output\")\n    .action(async (layer, type, name, options) => {\n      await addCommand(layer, type, name, options);\n    });\n\n  // element list <layer> [options]\n  program\n    .command(\"list <layer>\")\n    .description(\"List elements in a layer\")\n    .option(\"--type <type>\", \"Filter by element type\")\n    .option(\"--json\", \"Output as JSON\")\n    .option(\"--verbose\", \"Show detailed output\")\n    .option(\"--debug\", \"Enable debug output\")\n    .action(async (layer, options) => {\n      await listCommand(layer, options);\n    });\n\n  // element show <id> [options]\n  program\n    .command(\"show <id>\")\n    .description(\"Display element details\")\n    .option(\"--verbose\", \"Show detailed output\")\n    .option(\"--debug\", \"Enable debug output\")\n    .action(async (id, options) => {\n      await showCommand(id, options);\n    });\n\n  // element delete <id> [options]\n  program\n    .command(\"delete <id>\")\n    .description(\"Delete an element\")\n    .option(\"--force\", \"Skip confirmation prompt\")\n    .option(\"--cascade\", \"Remove dependent elements automatically\")\n    .option(\"--verbose\", \"Show detailed output\")\n    .option(\"--debug\", \"Enable debug output\")\n    .action(async (id, options) => {\n      await deleteCommand(id, options);\n    });\n\n  // element update <id> [options]\n  program\n    .command(\"update <id>\")\n    .description(\"Update an element\")\n    .option(\"--name <name>\", \"New element name\")\n    .option(\"--description <description>\", \"New description\")\n    .option(\"--attributes <json>\", \"Element attributes as JSON (type-specific properties)\")\n    .option(\"--source-file <path>\", \"Source file path\")\n    .option(\"--source-symbol <symbol>\", \"Source symbol or line number\")\n    .option(\"--source-provenance <provenance>\", \"Source provenance (manual or generated)\")\n    .option(\"--source-repo-remote <remote>\", \"Source repository remote\")\n    .option(\"--source-repo-commit <commit>\", \"Source repository commit hash\")\n    .option(\"--clear-source-reference\", \"Remove source reference from element\")\n    .option(\"--verbose\", \"Show detailed output\")\n    .option(\"--debug\", \"Enable debug output\")\n    .action(async (id, options) => {\n      await updateCommand(id, options);\n    });\n}\n"],
+  "mappings": "AAOA,SAAS,kBAAkB;AAC3B,SAAS,mBAAmB;AAC5B,SAAS,mBAAmB;AAC5B,SAAS,qBAAqB;AAC9B,SAAS,qBAAqB;AAExB,SAAU,gBAAgB,SAAgB;AAE9C,UACG,QAAQ,2BAA2B,EACnC,YAAY,2BAA2B,EACvC,OAAO,iBAAiB,4DAA4D,EACpF,OAAO,+BAA+B,qBAAqB,EAC3D,OAAO,uBAAuB,uDAAuD,EACrF,OAAO,wBAAwB,kBAAkB,EACjD,OAAO,4BAA4B,8BAA8B,EACjE,OAAO,oCAAoC,yCAAyC,EACpF,OAAO,iCAAiC,0BAA0B,EAClE,OAAO,iCAAiC,+BAA+B,EACvE,OAAO,aAAa,sBAAsB,EAC1C,OAAO,WAAW,qBAAqB,EACvC,OAAO,OAAO,OAAO,MAAM,MAAM,YAAW;AAC3C,UAAM,WAAW,OAAO,MAAM,MAAM,OAAO;EAC7C,CAAC,GAGH,QACG,QAAQ,cAAc,EACtB,YAAY,0BAA0B,EACtC,OAAO,iBAAiB,wBAAwB,EAChD,OAAO,UAAU,gBAAgB,EACjC,OAAO,aAAa,sBAAsB,EAC1C,OAAO,WAAW,qBAAqB,EACvC,OAAO,OAAO,OAAO,YAAW;AAC/B,UAAM,YAAY,OAAO,OAAO;EAClC,CAAC,GAGH,QACG,QAAQ,WAAW,EACnB,YAAY,yBAAyB,EACrC,OAAO,aAAa,sBAAsB,EAC1C,OAAO,WAAW,qBAAqB,EACvC,OAAO,OAAO,IAAI,YAAW;AAC5B,UAAM,YAAY,IAAI,OAAO;EAC/B,CAAC,GAGH,QACG,QAAQ,aAAa,EACrB,YAAY,mBAAmB,EAC/B,OAAO,WAAW,0BAA0B,EAC5C,OAAO,aAAa,yCAAyC,EAC7D,OAAO,aAAa,sBAAsB,EAC1C,OAAO,WAAW,qBAAqB,EACvC,OAAO,OAAO,IAAI,YAAW;AAC5B,UAAM,cAAc,IAAI,OAAO;EACjC,CAAC,GAGH,QACG,QAAQ,aAAa,EACrB,YAAY,mBAAmB,EAC/B,OAAO,iBAAiB,kBAAkB,EAC1C,OAAO,+BAA+B,iBAAiB,EACvD,OAAO,uBAAuB,uDAAuD,EACrF,OAAO,wBAAwB,kBAAkB,EACjD,OAAO,4BAA4B,8BAA8B,EACjE,OAAO,oCAAoC,yCAAyC,EACpF,OAAO,iCAAiC,0BAA0B,EAClE,OAAO,iCAAiC,+BAA+B,EACvE,OAAO,4BAA4B,sCAAsC,EACzE,OAAO,aAAa,sBAAsB,EAC1C,OAAO,WAAW,qBAAqB,EACvC,OAAO,OAAO,IAAI,YAAW;AAC5B,UAAM,cAAc,IAAI,OAAO;EACjC,CAAC;AACL;",
   "names": []
 }

package/dist/commands/export.js

@@ -1,9 +1,11 @@
 import ansis from "ansis";
 import { Model } from "../core/model.js";
-import { ExportManager, ArchiMateExporter, OpenAPIExporter, JsonSchemaExporter, PlantUMLExporter, GraphMLExporter, MarkdownExporter } from "../export/index.js";
+import { ExportManager, ArchiMateExporter, OpenAPIExporter, JsonSchemaExporter, PlantUMLExporter, GraphMLExporter, MarkdownExporter, MermaidMarkdownExporter } from "../export/index.js";
+import { Validator } from "../validators/validator.js";
 import { writeFile } from "../utils/file-io.js";
 import * as path from "path";
 import { startSpan, endSpan } from "../telemetry/index.js";
+import { getErrorMessage } from "../utils/errors.js";
 const isTelemetryEnabled = !1;
 async function exportCommand(options) {
   const span = isTelemetryEnabled ? startSpan("export.execute", {
@@ -34,8 +36,15 @@ async function exportCommand(options) {
     }), manager.register("markdown", new MarkdownExporter(), {
       description: "Markdown documentation",
       mimeType: "text/markdown"
+    }), manager.register("mermaid-markdown", new MermaidMarkdownExporter(), {
+      description: "Markdown with Mermaid diagrams and formatted tables",
+      mimeType: "text/markdown"
     });
     const format = options.format.toLowerCase();
+    if (["openapi", "archimate", "jsonschema", "json-schema"].includes(format)) {
+      const validationResult = await new Validator().validateModel(model);
+      validationResult.isValid() || (console.warn(ansis.yellow(`\u26A0 Warning: model has ${validationResult.errors.length} validation error(s). Export output may be incomplete or incorrect.`)), console.warn(ansis.dim('  Run "dr validate" for details.')));
+    }
     if (!manager.hasFormat(format)) {
       console.error(ansis.red(`Error: Unknown export format: ${format}`)), console.error(""), console.error("Available formats:");
       for (const info of manager.getAllFormats())
@@ -44,7 +53,8 @@ async function exportCommand(options) {
     }
     const result = await manager.export(model, format, {
       layers: options.layers,
-      outputPath: options.output
+      outputPath: options.output,
+      includeSources: options.includeSources
     });
     if (isTelemetryEnabled && span && span.setAttribute("export.result_size", result.length), options.output) {
       const outputPath = path.isAbsolute(options.output) ? options.output : path.join(process.cwd(), options.output);
@@ -53,7 +63,7 @@ async function exportCommand(options) {
       console.log(result);
   } catch (error) {
     isTelemetryEnabled && span && (span.recordException(error), span.setStatus({ code: 2, message: error.message }));
-    const message = error instanceof Error ? error.message : String(error);
+    const message = getErrorMessage(error);
     console.error(ansis.red(`Error: ${message}`)), process.exit(1);
   } finally {
     isTelemetryEnabled && endSpan(span);

package/dist/commands/export.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/commands/export.ts"],
-  "sourcesContent": ["/**\n * Export the architecture model to various formats\n */\n\nimport ansis from \"ansis\";\nimport { Model } from \"../core/model.js\";\nimport {\n  ExportManager,\n  ArchiMateExporter,\n  OpenAPIExporter,\n  JsonSchemaExporter,\n  PlantUMLExporter,\n  GraphMLExporter,\n  MarkdownExporter,\n} from \"../export/index.js\";\nimport { writeFile } from \"../utils/file-io.js\";\nimport * as path from \"path\";\nimport { startSpan, endSpan } from \"../telemetry/index.js\";\n\ndeclare const TELEMETRY_ENABLED: boolean | undefined;\nconst isTelemetryEnabled = typeof TELEMETRY_ENABLED !== 'undefined' ? TELEMETRY_ENABLED : false;\n\nexport interface ExportOptions {\n  format: string;\n  output?: string;\n  layers?: string[];\n  model?: string;\n}\n\nexport async function exportCommand(options: ExportOptions): Promise<void> {\n  const span = isTelemetryEnabled ? startSpan('export.execute', {\n    'export.format': options.format,\n    'export.layer_count': options.layers?.length || 0,\n    'export.has_output': !!options.output,\n  }) : null;\n\n  try {\n    // Load model\n    const model = await Model.load(options.model);\n\n    // Initialize ExportManager and register all exporters\n    const manager = new ExportManager();\n\n    manager.register(\"archimate\", new ArchiMateExporter(), {\n      description: \"ArchiMate 3.2 XML format\",\n      mimeType: \"application/xml\",\n    });\n\n    manager.register(\"openapi\", new OpenAPIExporter(), {\n      description: \"OpenAPI 3.0 specification\",\n      mimeType: \"application/json\",\n    });\n\n    manager.register(\"json-schema\", new JsonSchemaExporter(), {\n      description: \"JSON Schema Draft 7\",\n      mimeType: \"application/json\",\n    });\n\n    // Register alias for jsonschema (without hyphen)\n    manager.register(\"jsonschema\", new JsonSchemaExporter(), {\n      description: \"JSON Schema Draft 7\",\n      mimeType: \"application/json\",\n    });\n\n    manager.register(\"plantuml\", new PlantUMLExporter(), {\n      description: \"PlantUML diagram format\",\n      mimeType: \"text/plain\",\n    });\n\n    manager.register(\"graphml\", new GraphMLExporter(), {\n      description: \"GraphML graph format\",\n      mimeType: \"application/xml\",\n    });\n\n    manager.register(\"markdown\", new MarkdownExporter(), {\n      description: \"Markdown documentation\",\n      mimeType: \"text/markdown\",\n    });\n\n    // Validate format\n    const format = options.format.toLowerCase();\n    if (!manager.hasFormat(format)) {\n      console.error(\n        ansis.red(`Error: Unknown export format: ${format}`)\n      );\n      console.error(\"\");\n      console.error(\"Available formats:\");\n      for (const info of manager.getAllFormats()) {\n        console.error(\n          `  - ${ansis.cyan(info.format)}: ${info.description}`\n        );\n        console.error(\n          `    Supported layers: ${info.supportedLayers.join(\", \")}`\n        );\n      }\n      process.exit(1);\n    }\n\n\n    // Perform export\n    const result = await manager.export(model, format, {\n      layers: options.layers,\n      outputPath: options.output,\n    });\n\n    if (isTelemetryEnabled && span) {\n      (span as any).setAttribute('export.result_size', result.length);\n    }\n\n    if (options.output) {\n      // Write to file\n      // For relative paths, use current working directory instead of rootPath\n      // This allows tests to detect file creation in their working directory\n      const outputPath = path.isAbsolute(options.output)\n        ? options.output\n        : path.join(process.cwd(), options.output);\n\n      await writeFile(outputPath, result);\n\n      console.log(\n        ansis.green(`\u2713 Exported to ${ansis.cyan(outputPath)}`)\n      );\n    } else {\n      // Output to stdout\n      console.log(result);\n    }\n  } catch (error) {\n    if (isTelemetryEnabled && span) {\n      (span as any).recordException(error as Error);\n      (span as any).setStatus({ code: 2, message: (error as Error).message });\n    }\n    const message = error instanceof Error ? error.message : String(error);\n    console.error(ansis.red(`Error: ${message}`));\n    process.exit(1);\n  } finally {\n    if (isTelemetryEnabled) {\n      endSpan(span);\n    }\n  }\n}\n"],
-  "mappings": "AAIA,OAAO,WAAW;AAClB,SAAS,aAAa;AACtB,SACE,eACA,mBACA,iBACA,oBACA,kBACA,iBACA,wBACK;AACP,SAAS,iBAAiB;AAC1B,YAAY,UAAU;AACtB,SAAS,WAAW,eAAe;AAGnC,MAAM,qBAAgE;AAStE,eAAsB,cAAc,SAAsB;AACxD,QAAM,OAAO,qBAAqB,UAAU,kBAAkB;IAC5D,iBAAiB,QAAQ;IACzB,sBAAsB,QAAQ,QAAQ,UAAU;IAChD,qBAAqB,CAAC,CAAC,QAAQ;GAChC,IAAI;AAEL,MAAI;AAEF,UAAM,QAAQ,MAAM,MAAM,KAAK,QAAQ,KAAK,GAGtC,UAAU,IAAI,cAAa;AAEjC,YAAQ,SAAS,aAAa,IAAI,kBAAiB,GAAI;MACrD,aAAa;MACb,UAAU;KACX,GAED,QAAQ,SAAS,WAAW,IAAI,gBAAe,GAAI;MACjD,aAAa;MACb,UAAU;KACX,GAED,QAAQ,SAAS,eAAe,IAAI,mBAAkB,GAAI;MACxD,aAAa;MACb,UAAU;KACX,GAGD,QAAQ,SAAS,cAAc,IAAI,mBAAkB,GAAI;MACvD,aAAa;MACb,UAAU;KACX,GAED,QAAQ,SAAS,YAAY,IAAI,iBAAgB,GAAI;MACnD,aAAa;MACb,UAAU;KACX,GAED,QAAQ,SAAS,WAAW,IAAI,gBAAe,GAAI;MACjD,aAAa;MACb,UAAU;KACX,GAED,QAAQ,SAAS,YAAY,IAAI,iBAAgB,GAAI;MACnD,aAAa;MACb,UAAU;KACX;AAGD,UAAM,SAAS,QAAQ,OAAO,YAAW;AACzC,QAAI,CAAC,QAAQ,UAAU,MAAM,GAAG;AAC9B,cAAQ,MACN,MAAM,IAAI,iCAAiC,MAAM,EAAE,CAAC,GAEtD,QAAQ,MAAM,EAAE,GAChB,QAAQ,MAAM,oBAAoB;AAClC,iBAAW,QAAQ,QAAQ,cAAa;AACtC,gBAAQ,MACN,OAAO,MAAM,KAAK,KAAK,MAAM,CAAC,KAAK,KAAK,WAAW,EAAE,GAEvD,QAAQ,MACN,yBAAyB,KAAK,gBAAgB,KAAK,IAAI,CAAC,EAAE;AAG9D,cAAQ,KAAK,CAAC;IAChB;AAIA,UAAM,SAAS,MAAM,QAAQ,OAAO,OAAO,QAAQ;MACjD,QAAQ,QAAQ;MAChB,YAAY,QAAQ;KACrB;AAMD,QAJI,sBAAsB,QACvB,KAAa,aAAa,sBAAsB,OAAO,MAAM,GAG5D,QAAQ,QAAQ;AAIlB,YAAM,aAAa,KAAK,WAAW,QAAQ,MAAM,IAC7C,QAAQ,SACR,KAAK,KAAK,QAAQ,IAAG,GAAI,QAAQ,MAAM;AAE3C,YAAM,UAAU,YAAY,MAAM,GAElC,QAAQ,IACN,MAAM,MAAM,sBAAiB,MAAM,KAAK,UAAU,CAAC,EAAE,CAAC;IAE1D;AAEE,cAAQ,IAAI,MAAM;EAEtB,SAAS,OAAO;AACd,IAAI,sBAAsB,SACvB,KAAa,gBAAgB,KAAc,GAC3C,KAAa,UAAU,EAAE,MAAM,GAAG,SAAU,MAAgB,QAAO,CAAE;AAExE,UAAM,UAAU,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AACrE,YAAQ,MAAM,MAAM,IAAI,UAAU,OAAO,EAAE,CAAC,GAC5C,QAAQ,KAAK,CAAC;EAChB;AACE,IAAI,sBACF,QAAQ,IAAI;EAEhB;AACF;",
+  "sourcesContent": ["/**\n * Export the architecture model to various formats\n */\n\nimport ansis from \"ansis\";\nimport { Model } from \"../core/model.js\";\nimport {\n  ExportManager,\n  ArchiMateExporter,\n  OpenAPIExporter,\n  JsonSchemaExporter,\n  PlantUMLExporter,\n  GraphMLExporter,\n  MarkdownExporter,\n  MermaidMarkdownExporter,\n} from \"../export/index.js\";\nimport { Validator } from \"../validators/validator.js\";\nimport { writeFile } from \"../utils/file-io.js\";\nimport * as path from \"path\";\nimport { startSpan, endSpan } from \"../telemetry/index.js\";\nimport { getErrorMessage } from \"../utils/errors.js\";\n\ndeclare const TELEMETRY_ENABLED: boolean | undefined;\nconst isTelemetryEnabled = typeof TELEMETRY_ENABLED !== \"undefined\" ? TELEMETRY_ENABLED : false;\n\nexport interface ExportOptions {\n  format: string;\n  output?: string;\n  layers?: string[];\n  model?: string;\n  includeSources?: boolean;\n}\n\nexport async function exportCommand(options: ExportOptions): Promise<void> {\n  const span = isTelemetryEnabled\n    ? startSpan(\"export.execute\", {\n        \"export.format\": options.format,\n        \"export.layer_count\": options.layers?.length || 0,\n        \"export.has_output\": !!options.output,\n      })\n    : null;\n\n  try {\n    // Load model\n    const model = await Model.load(options.model);\n\n    // Initialize ExportManager and register all exporters\n    const manager = new ExportManager();\n\n    manager.register(\"archimate\", new ArchiMateExporter(), {\n      description: \"ArchiMate 3.2 XML format\",\n      mimeType: \"application/xml\",\n    });\n\n    manager.register(\"openapi\", new OpenAPIExporter(), {\n      description: \"OpenAPI 3.0 specification\",\n      mimeType: \"application/json\",\n    });\n\n    manager.register(\"json-schema\", new JsonSchemaExporter(), {\n      description: \"JSON Schema Draft 7\",\n      mimeType: \"application/json\",\n    });\n\n    // Register alias for jsonschema (without hyphen)\n    manager.register(\"jsonschema\", new JsonSchemaExporter(), {\n      description: \"JSON Schema Draft 7\",\n      mimeType: \"application/json\",\n    });\n\n    manager.register(\"plantuml\", new PlantUMLExporter(), {\n      description: \"PlantUML diagram format\",\n      mimeType: \"text/plain\",\n    });\n\n    manager.register(\"graphml\", new GraphMLExporter(), {\n      description: \"GraphML graph format\",\n      mimeType: \"application/xml\",\n    });\n\n    manager.register(\"markdown\", new MarkdownExporter(), {\n      description: \"Markdown documentation\",\n      mimeType: \"text/markdown\",\n    });\n\n    manager.register(\"mermaid-markdown\", new MermaidMarkdownExporter(), {\n      description: \"Markdown with Mermaid diagrams and formatted tables\",\n      mimeType: \"text/markdown\",\n    });\n\n    // Validate format\n    const format = options.format.toLowerCase();\n\n    // For semantic exporters, warn if the model has validation errors\n    const semanticFormats = [\"openapi\", \"archimate\", \"jsonschema\", \"json-schema\"];\n    if (semanticFormats.includes(format)) {\n      const validator = new Validator();\n      const validationResult = await validator.validateModel(model);\n      if (!validationResult.isValid()) {\n        console.warn(\n          ansis.yellow(\n            `\u26A0 Warning: model has ${validationResult.errors.length} validation error(s). Export output may be incomplete or incorrect.`\n          )\n        );\n        console.warn(ansis.dim('  Run \"dr validate\" for details.'));\n      }\n    }\n\n    if (!manager.hasFormat(format)) {\n      console.error(ansis.red(`Error: Unknown export format: ${format}`));\n      console.error(\"\");\n      console.error(\"Available formats:\");\n      for (const info of manager.getAllFormats()) {\n        console.error(`  - ${ansis.cyan(info.format)}: ${info.description}`);\n        console.error(`    Supported layers: ${info.supportedLayers.join(\", \")}`);\n      }\n      process.exit(1);\n    }\n\n    // Perform export\n    const result = await manager.export(model, format, {\n      layers: options.layers,\n      outputPath: options.output,\n      includeSources: options.includeSources,\n    });\n\n    if (isTelemetryEnabled && span) {\n      (span as any).setAttribute(\"export.result_size\", result.length);\n    }\n\n    if (options.output) {\n      // Write to file\n      // For relative paths, use current working directory instead of rootPath\n      // This allows tests to detect file creation in their working directory\n      const outputPath = path.isAbsolute(options.output)\n        ? options.output\n        : path.join(process.cwd(), options.output);\n\n      await writeFile(outputPath, result);\n\n      console.log(ansis.green(`\u2713 Exported to ${ansis.cyan(outputPath)}`));\n    } else {\n      // Output to stdout\n      console.log(result);\n    }\n  } catch (error) {\n    if (isTelemetryEnabled && span) {\n      (span as any).recordException(error as Error);\n      (span as any).setStatus({ code: 2, message: (error as Error).message });\n    }\n    const message = getErrorMessage(error);\n    console.error(ansis.red(`Error: ${message}`));\n    process.exit(1);\n  } finally {\n    if (isTelemetryEnabled) {\n      endSpan(span);\n    }\n  }\n}\n"],
+  "mappings": "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",
   "names": []
 }