@documentation-robotics/cli 0.2.0 → 0.4.0

package/dist/audit/relationships/analysis/layer-templates.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/audit/relationships/analysis/layer-templates.ts"],
-  "sourcesContent": ["/**\n * Layer-specific relationship templates for gap analysis and standard alignment\n */\n\nexport interface LayerTemplate {\n  layer: string;\n  standard: string;\n  patterns: Array<{\n    sourcePattern: string;\n    destinationPattern: string;\n    predicate: string;\n    description: string;\n  }>;\n}\n\nexport const LAYER_TEMPLATES: LayerTemplate[] = [\n  {\n    layer: \"motivation\",\n    standard: \"ArchiMate 3.2\",\n    patterns: [\n      {\n        sourcePattern: \"goal\",\n        destinationPattern: \"principle\",\n        predicate: \"supports\",\n        description: \"Goals support principles\",\n      },\n      {\n        sourcePattern: \"requirement\",\n        destinationPattern: \"goal\",\n        predicate: \"realizes\",\n        description: \"Requirements realize goals\",\n      },\n      {\n        sourcePattern: \"constraint\",\n        destinationPattern: \"requirement\",\n        predicate: \"restricts\",\n        description: \"Constraints restrict requirements\",\n      },\n    ],\n  },\n  {\n    layer: \"business\",\n    standard: \"ArchiMate 3.2\",\n    patterns: [\n      {\n        sourcePattern: \"process\",\n        destinationPattern: \"process\",\n        predicate: \"triggers\",\n        description: \"Processes trigger other processes\",\n      },\n      {\n        sourcePattern: \"role\",\n        destinationPattern: \"process\",\n        predicate: \"performs\",\n        description: \"Roles perform processes\",\n      },\n      {\n        sourcePattern: \"service\",\n        destinationPattern: \"process\",\n        predicate: \"realizes\",\n        description: \"Services realize processes\",\n      },\n    ],\n  },\n  {\n    layer: \"product\",\n    standard: \"Product Management Practice\",\n    patterns: [\n      {\n        sourcePattern: \"feature\",\n        destinationPattern: \"capability\",\n        predicate: \"realizes\",\n        description: \"Features realize capabilities\",\n      },\n      {\n        sourcePattern: \"capability\",\n        destinationPattern: \"milestone\",\n        predicate: \"scheduled-for\",\n        description: \"Capabilities are scheduled for milestones\",\n      },\n      {\n        sourcePattern: \"feature\",\n        destinationPattern: \"milestone\",\n        predicate: \"scheduled-for\",\n        description: \"Features are scheduled for milestones\",\n      },\n      {\n        sourcePattern: \"feature\",\n        destinationPattern: \"feature\",\n        predicate: \"depends-on\",\n        description: \"Features depend on other features\",\n      },\n      {\n        sourcePattern: \"userworkflow\",\n        destinationPattern: \"feature\",\n        predicate: \"composes\",\n        description: \"User workflows compose features\",\n      },\n    ],\n  },\n  {\n    layer: \"security\",\n    standard: \"NIST SP 800-53\",\n    patterns: [\n      {\n        sourcePattern: \"countermeasure\",\n        destinationPattern: \"threat\",\n        predicate: \"mitigates\",\n        description: \"Countermeasures mitigate threats\",\n      },\n      {\n        sourcePattern: \"role\",\n        destinationPattern: \"permission\",\n        predicate: \"authorizes\",\n        description: \"Roles authorize permissions\",\n      },\n      {\n        sourcePattern: \"policy\",\n        destinationPattern: \"countermeasure\",\n        predicate: \"mandates\",\n        description: \"Policies mandate countermeasures\",\n      },\n    ],\n  },\n  {\n    layer: \"application\",\n    standard: \"ArchiMate 3.2\",\n    patterns: [\n      {\n        sourcePattern: \"component\",\n        destinationPattern: \"service\",\n        predicate: \"realizes\",\n        description: \"Components realize services\",\n      },\n      {\n        sourcePattern: \"component\",\n        destinationPattern: \"component\",\n        predicate: \"uses\",\n        description: \"Components use other components\",\n      },\n      {\n        sourcePattern: \"interface\",\n        destinationPattern: \"service\",\n        predicate: \"serves\",\n        description: \"Interfaces serve services\",\n      },\n    ],\n  },\n  {\n    layer: \"technology\",\n    standard: \"ArchiMate 3.2\",\n    patterns: [\n      {\n        sourcePattern: \"node\",\n        destinationPattern: \"device\",\n        predicate: \"composes\",\n        description: \"Nodes compose devices\",\n      },\n      {\n        sourcePattern: \"artifact\",\n        destinationPattern: \"component\",\n        predicate: \"realizes\",\n        description: \"Artifacts realize components\",\n      },\n      {\n        sourcePattern: \"infrastructure\",\n        destinationPattern: \"node\",\n        predicate: \"hosts\",\n        description: \"Infrastructure hosts nodes\",\n      },\n    ],\n  },\n  {\n    layer: \"api\",\n    standard: \"OpenAPI 3.0\",\n    patterns: [\n      {\n        sourcePattern: \"operation\",\n        destinationPattern: \"schema\",\n        predicate: \"references\",\n        description: \"Operations reference schemas\",\n      },\n      {\n        sourcePattern: \"securityscheme\",\n        destinationPattern: \"operation\",\n        predicate: \"serves\",\n        description: \"Security schemes serve operations\",\n      },\n      {\n        sourcePattern: \"response\",\n        destinationPattern: \"schema\",\n        predicate: \"returns\",\n        description: \"Responses return schemas\",\n      },\n    ],\n  },\n  {\n    layer: \"ux\",\n    standard: \"React/Component\",\n    patterns: [\n      {\n        sourcePattern: \"component\",\n        destinationPattern: \"component\",\n        predicate: \"renders\",\n        description: \"Components render other components\",\n      },\n      {\n        sourcePattern: \"component\",\n        destinationPattern: \"entity\",\n        predicate: \"binds-to\",\n        description: \"Components bind to entities\",\n      },\n      {\n        sourcePattern: \"form\",\n        destinationPattern: \"schema\",\n        predicate: \"validates\",\n        description: \"Forms validate against schemas\",\n      },\n    ],\n  },\n  {\n    layer: \"navigation\",\n    standard: \"Router patterns\",\n    patterns: [\n      {\n        sourcePattern: \"route\",\n        destinationPattern: \"screen\",\n        predicate: \"navigates-to\",\n        description: \"Routes navigate to screens\",\n      },\n      {\n        sourcePattern: \"menuitem\",\n        destinationPattern: \"route\",\n        predicate: \"references\",\n        description: \"Menu items reference routes\",\n      },\n      {\n        sourcePattern: \"link\",\n        destinationPattern: \"route\",\n        predicate: \"targets\",\n        description: \"Links target routes\",\n      },\n    ],\n  },\n  {\n    layer: \"data-model\",\n    standard: \"JSON Schema Draft 7\",\n    patterns: [\n      {\n        sourcePattern: \"entity\",\n        destinationPattern: \"entity\",\n        predicate: \"references\",\n        description: \"Entities reference other entities\",\n      },\n      {\n        sourcePattern: \"entity\",\n        destinationPattern: \"property\",\n        predicate: \"has\",\n        description: \"Entities have properties\",\n      },\n      {\n        sourcePattern: \"property\",\n        destinationPattern: \"entity\",\n        predicate: \"references\",\n        description: \"Properties reference entities\",\n      },\n    ],\n  },\n  {\n    layer: \"data-store\",\n    standard: \"Database schema patterns\",\n    patterns: [\n      {\n        sourcePattern: \"table\",\n        destinationPattern: \"table\",\n        predicate: \"references\",\n        description: \"Tables reference other tables via foreign keys\",\n      },\n      {\n        sourcePattern: \"index\",\n        destinationPattern: \"table\",\n        predicate: \"indexes\",\n        description: \"Indexes apply to tables\",\n      },\n      {\n        sourcePattern: \"view\",\n        destinationPattern: \"table\",\n        predicate: \"derives-from\",\n        description: \"Views derive from tables\",\n      },\n    ],\n  },\n  {\n    layer: \"apm\",\n    standard: \"OpenTelemetry\",\n    patterns: [\n      {\n        sourcePattern: \"trace\",\n        destinationPattern: \"service\",\n        predicate: \"monitors\",\n        description: \"Traces monitor services\",\n      },\n      {\n        sourcePattern: \"metric\",\n        destinationPattern: \"component\",\n        predicate: \"measures\",\n        description: \"Metrics measure components\",\n      },\n      {\n        sourcePattern: \"alert\",\n        destinationPattern: \"metric\",\n        predicate: \"triggers-on\",\n        description: \"Alerts trigger on metrics\",\n      },\n    ],\n  },\n  {\n    layer: \"testing\",\n    standard: \"Testing best practices\",\n    patterns: [\n      {\n        sourcePattern: \"testcase\",\n        destinationPattern: \"requirement\",\n        predicate: \"verifies\",\n        description: \"Test cases verify requirements\",\n      },\n      {\n        sourcePattern: \"testdata\",\n        destinationPattern: \"testcase\",\n        predicate: \"supports\",\n        description: \"Test data supports test cases\",\n      },\n      {\n        sourcePattern: \"testsuite\",\n        destinationPattern: \"testcase\",\n        predicate: \"contains\",\n        description: \"Test suites contain test cases\",\n      },\n    ],\n  },\n];\n"],
+  "sourcesContent": ["/**\n * Layer-specific relationship templates for gap analysis and standard alignment\n */\n\nexport interface LayerTemplate {\n  layer: string;\n  standard: string;\n  patterns: Array<{\n    sourcePattern: string;\n    destinationPattern: string;\n    predicate: string;\n    description: string;\n  }>;\n}\n\nexport const LAYER_TEMPLATES: LayerTemplate[] = [\n  {\n    layer: \"motivation\",\n    standard: \"ArchiMate 3.2\",\n    patterns: [\n      {\n        sourcePattern: \"goal\",\n        destinationPattern: \"principle\",\n        predicate: \"supports\",\n        description: \"Goals support principles\",\n      },\n      {\n        sourcePattern: \"requirement\",\n        destinationPattern: \"goal\",\n        predicate: \"realizes\",\n        description: \"Requirements realize goals\",\n      },\n      {\n        sourcePattern: \"constraint\",\n        destinationPattern: \"requirement\",\n        predicate: \"restricts\",\n        description: \"Constraints restrict requirements\",\n      },\n    ],\n  },\n  {\n    layer: \"business\",\n    standard: \"ArchiMate 3.2\",\n    patterns: [\n      {\n        sourcePattern: \"process\",\n        destinationPattern: \"process\",\n        predicate: \"triggers\",\n        description: \"Processes trigger other processes\",\n      },\n      {\n        sourcePattern: \"role\",\n        destinationPattern: \"process\",\n        predicate: \"assigned-to\",\n        description: \"Roles are assigned to the processes they perform\",\n      },\n      {\n        sourcePattern: \"process\",\n        destinationPattern: \"service\",\n        predicate: \"realizes\",\n        description: \"Processes realize services\",\n      },\n    ],\n  },\n  {\n    layer: \"product\",\n    standard: \"Product Management Practice\",\n    patterns: [\n      {\n        sourcePattern: \"feature\",\n        destinationPattern: \"softwarecapability\",\n        predicate: \"realizes\",\n        description: \"Features realize software capabilities\",\n      },\n      {\n        sourcePattern: \"softwarecapability\",\n        destinationPattern: \"milestone\",\n        predicate: \"scheduled-for\",\n        description: \"Software capabilities are scheduled for milestones\",\n      },\n      {\n        sourcePattern: \"feature\",\n        destinationPattern: \"milestone\",\n        predicate: \"scheduled-for\",\n        description: \"Features are scheduled for milestones\",\n      },\n      {\n        sourcePattern: \"feature\",\n        destinationPattern: \"feature\",\n        predicate: \"depends-on\",\n        description: \"Features depend on other features\",\n      },\n      {\n        sourcePattern: \"userworkflow\",\n        destinationPattern: \"feature\",\n        predicate: \"composes\",\n        description: \"User workflows compose features\",\n      },\n    ],\n  },\n  {\n    layer: \"security\",\n    standard: \"NIST SP 800-53\",\n    patterns: [\n      {\n        sourcePattern: \"countermeasure\",\n        destinationPattern: \"threat\",\n        predicate: \"mitigates\",\n        description: \"Countermeasures mitigate threats\",\n      },\n      {\n        sourcePattern: \"role\",\n        destinationPattern: \"permission\",\n        predicate: \"aggregates\",\n        description: \"Roles aggregate the permissions they grant\",\n      },\n      {\n        sourcePattern: \"policy\",\n        destinationPattern: \"countermeasure\",\n        predicate: \"mandates\",\n        description: \"Policies mandate countermeasures\",\n      },\n    ],\n  },\n  {\n    layer: \"application\",\n    standard: \"ArchiMate 3.2\",\n    patterns: [\n      {\n        sourcePattern: \"component\",\n        destinationPattern: \"service\",\n        predicate: \"realizes\",\n        description: \"Components realize services\",\n      },\n      {\n        sourcePattern: \"component\",\n        destinationPattern: \"component\",\n        predicate: \"uses\",\n        description: \"Components use other components\",\n      },\n      {\n        sourcePattern: \"interface\",\n        destinationPattern: \"service\",\n        predicate: \"serves\",\n        description: \"Interfaces serve services\",\n      },\n    ],\n  },\n  {\n    layer: \"technology\",\n    standard: \"ArchiMate 3.2\",\n    patterns: [\n      {\n        sourcePattern: \"node\",\n        destinationPattern: \"device\",\n        predicate: \"composes\",\n        description: \"Nodes compose devices\",\n      },\n      {\n        sourcePattern: \"artifact\",\n        destinationPattern: \"component\",\n        predicate: \"realizes\",\n        description: \"Artifacts realize components\",\n      },\n      {\n        sourcePattern: \"node\",\n        destinationPattern: \"systemsoftware\",\n        predicate: \"composes\",\n        description: \"Nodes compose the system software they run\",\n      },\n    ],\n  },\n  {\n    layer: \"api\",\n    standard: \"OpenAPI 3.0\",\n    patterns: [\n      {\n        sourcePattern: \"pathitem\",\n        destinationPattern: \"operation\",\n        predicate: \"composes\",\n        description: \"Path items compose their operations\",\n      },\n      {\n        sourcePattern: \"operation\",\n        destinationPattern: \"responses\",\n        predicate: \"composes\",\n        description: \"Operations compose their responses map\",\n      },\n      {\n        sourcePattern: \"mediatype\",\n        destinationPattern: \"schema\",\n        predicate: \"references\",\n        description: \"Media types reference their schema by $ref\",\n      },\n    ],\n  },\n  {\n    layer: \"ux\",\n    standard: \"HTML 5.3 / component libraries\",\n    patterns: [\n      {\n        sourcePattern: \"view\",\n        destinationPattern: \"componentinstance\",\n        predicate: \"composes\",\n        description: \"Views compose the component instances placed in them\",\n      },\n      {\n        sourcePattern: \"componentinstance\",\n        destinationPattern: \"librarycomponent\",\n        predicate: \"realizes\",\n        description: \"Instances realize the library component they place\",\n      },\n      {\n        sourcePattern: \"view\",\n        destinationPattern: \"dataconfig\",\n        predicate: \"binds-to\",\n        description: \"Views bind to their data configuration\",\n      },\n    ],\n  },\n  {\n    layer: \"navigation\",\n    standard: \"Router patterns\",\n    patterns: [\n      {\n        sourcePattern: \"route\",\n        destinationPattern: \"screen\",\n        predicate: \"navigates-to\",\n        description: \"Routes navigate to screens\",\n      },\n      {\n        sourcePattern: \"menuitem\",\n        destinationPattern: \"route\",\n        predicate: \"references\",\n        description: \"Menu items reference routes\",\n      },\n      {\n        sourcePattern: \"link\",\n        destinationPattern: \"route\",\n        predicate: \"targets\",\n        description: \"Links target routes\",\n      },\n    ],\n  },\n  {\n    layer: \"data-model\",\n    standard: \"JSON Schema Draft 7\",\n    patterns: [\n      {\n        sourcePattern: \"entity\",\n        destinationPattern: \"entity\",\n        predicate: \"references\",\n        description: \"Entities reference other entities\",\n      },\n      {\n        sourcePattern: \"entity\",\n        destinationPattern: \"property\",\n        predicate: \"has\",\n        description: \"Entities have properties\",\n      },\n      {\n        sourcePattern: \"property\",\n        destinationPattern: \"entity\",\n        predicate: \"references\",\n        description: \"Properties reference entities\",\n      },\n    ],\n  },\n  {\n    layer: \"data-store\",\n    standard: \"Database schema patterns\",\n    patterns: [\n      {\n        sourcePattern: \"table\",\n        destinationPattern: \"table\",\n        predicate: \"references\",\n        description: \"Tables reference other tables via foreign keys\",\n      },\n      {\n        sourcePattern: \"index\",\n        destinationPattern: \"table\",\n        predicate: \"indexes\",\n        description: \"Indexes apply to tables\",\n      },\n      {\n        sourcePattern: \"view\",\n        destinationPattern: \"table\",\n        predicate: \"derives-from\",\n        description: \"Views derive from tables\",\n      },\n    ],\n  },\n  {\n    layer: \"apm\",\n    standard: \"OpenTelemetry\",\n    patterns: [\n      {\n        sourcePattern: \"trace\",\n        destinationPattern: \"service\",\n        predicate: \"monitors\",\n        description: \"Traces monitor services\",\n      },\n      {\n        sourcePattern: \"metric\",\n        destinationPattern: \"component\",\n        predicate: \"measures\",\n        description: \"Metrics measure components\",\n      },\n      {\n        sourcePattern: \"alert\",\n        destinationPattern: \"metric\",\n        predicate: \"triggers-on\",\n        description: \"Alerts trigger on metrics\",\n      },\n    ],\n  },\n  {\n    layer: \"testing\",\n    standard: \"IEEE 829-2008 test documentation\",\n    patterns: [\n      {\n        sourcePattern: \"testcasesketch\",\n        destinationPattern: \"coveragerequirement\",\n        predicate: \"validates\",\n        description: \"Test case sketches validate the coverage requirement they exercise\",\n      },\n      {\n        sourcePattern: \"testcoveragetarget\",\n        destinationPattern: \"coveragerequirement\",\n        predicate: \"composes\",\n        description: \"Coverage targets compose their coverage requirements\",\n      },\n      {\n        sourcePattern: \"testcoveragemodel\",\n        destinationPattern: \"testcoveragetarget\",\n        predicate: \"composes\",\n        description: \"Coverage models compose their coverage targets\",\n      },\n    ],\n  },\n];\n"],
   "mappings": "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",
   "names": []
 }

package/dist/cli.js

@@ -73,7 +73,7 @@ Examples:
   $ dr add application component "Customer API" --description "REST API for customer operations"
   $ dr add security policy "Auth Validator" --source-file "src/auth/validator.ts" --source-symbol "validateToken" --source-provenance "extracted"
 
-Note: Element IDs are generated automatically in format {layer}.{type}.{kebab-name}`).action((layer, type, name, options) => addCommand(layer, type, name, { ...options, verbose: options.verbose ?? program.opts().verbose })), program.command("update <id>").description("Update an element").option("--model <path>", "Path to model root (contains model/manifest.yaml)").option("--name <name>", "New element name").option("--description <desc>", "New description").option("--type <new-type>", "Change element type (must be valid for the element's layer; incompatible attributes must be cleaned up manually)").option("--attributes <json>", "Updated type-specific attributes (JSON)").option("--source-file <path>", "Source file path (relative from repository root)").option("--source-symbol <name>", "Symbol name (class, function, variable) in source file").option("--source-provenance <type>", "Provenance type: extracted, manual, inferred, generated").option("--source-repo-remote <url>", "Git remote URL for repository context").option("--source-repo-commit <sha>", "Git commit SHA (40 hex characters) for repository context").option("--clear-source-reference", "Remove source reference from element").option("--verbose", "Show detailed output (can also use global -v flag)").addHelpText("after", `
+Note: Element IDs are generated automatically in format {layer}.{type}.{kebab-name}`).action((layer, type, name, options) => addCommand(layer, type, name, { ...options, verbose: options.verbose ?? program.opts().verbose })), program.command("update <id>").description("Update an element").option("--model <path>", "Path to model root (contains model/manifest.yaml)").option("--name <name>", "New element name").option("--description <desc>", "New description").option("--type <new-type>", "Change element type (must be valid for the element's layer; incompatible attributes must be cleaned up manually)").option("--attributes <json>", "Updated type-specific attributes (JSON)").option("--attribute-patch <json>", "Merge these attributes into the current ones (JSON object; null removes a key). Cannot be combined with --attributes").option("--source-file <path>", "Source file path (relative from repository root)").option("--source-symbol <name>", "Symbol name (class, function, variable) in source file. Without --source-file, added to the element's one source file, keeping its provenance").option("--source-provenance <type>", "Provenance type: extracted, manual, inferred, generated").option("--source-repo-remote <url>", "Git remote URL for repository context").option("--source-repo-commit <sha>", "Git commit SHA (40 hex characters) for repository context").option("--clear-source-reference", "Remove source reference from element").option("--verbose", "Show detailed output (can also use global -v flag)").addHelpText("after", `
 Note: Changes are written immediately to model files.
 To track changes for review, activate a changeset first:
   $ dr changeset activate my-changeset
@@ -82,6 +82,7 @@ Examples:
   $ dr update api-endpoint-create-customer --name "Create Customer (v2)"
   $ dr update business-service-order --description "Updated description"
   $ dr update application-applicationfunction-process-orders --type applicationservice
+  $ dr update api.operation.create-customer --attribute-patch '{"summary":"Create a customer (v2)"}'
   $ dr update security-policy-auth --source-file "src/auth/policy.ts" --source-provenance "extracted"`).action((id, options) => updateCommand(id, { ...options, verbose: options.verbose ?? program.opts().verbose })), program.command("delete <id>").description("Delete an element").option("--model <path>", "Path to model root (contains model/manifest.yaml)").option("--force", "Skip dependency checks (confirmation is also skipped in non-TTY environments)").option("--cascade", "Remove dependent elements automatically").option("--dry-run", "Show what would be removed without actually removing").option("--verbose", "Show detailed output (can also use global -v flag)").addHelpText("after", `
 Examples:
   $ dr delete api-endpoint-old-endpoint
@@ -256,7 +257,7 @@ Examples:
     showMetrics: options.metrics,
     model: options.model
   });
-}), program.command("visualize").description("Launch visualization server with WebSocket support").option("--port <num>", "Server port (default: 8080)").option("--no-browser", "Do not auto-open browser").option("--no-auth", "Disable authentication (enabled by default)").option("--token <token>", "Custom auth token (auto-generated by default)").option("--with-danger", "Enable dangerous mode for chat (skip permissions)").option("--viewer-path <path>", "Path to custom viewer build (e.g., ./dist/embedded/dr-viewer-bundle)").addHelpText("after", `
+}), program.command("visualize").description("Launch visualization server with WebSocket support").option("--port <num>", "Server port (default: 8080)").option("--no-browser", "Do not auto-open browser").option("--no-auth", "Disable authentication (enabled by default)").option("--token <token>", "Custom auth token (auto-generated by default)").option("--with-danger", "Enable dangerous mode for chat (skip permissions)").option("--with-changesets", "Let chat stage model changes in a changeset (no commit, apply or delete)").option("--viewer-path <path>", "Path to custom viewer build (e.g., ./dist/embedded/dr-viewer-bundle)").addHelpText("after", `
 Examples:
   $ dr visualize
   $ dr visualize --port 3000
@@ -264,6 +265,7 @@ Examples:
   $ dr visualize --no-auth
   $ dr visualize --token my-secret-token
   $ dr visualize --with-danger
+  $ dr visualize --with-changesets
   $ dr visualize --viewer-path ./dist/embedded/dr-viewer-bundle
 
 Default mode (read-safe permissions) enables:
@@ -271,6 +273,15 @@ Default mode (read-safe permissions) enables:
   - Reading the codebase
   - Reading the documentation-robotics/ model folder
   - Reading the .dr/ configuration folder
+  - One 'dr' command per shell call: a call that adds pipes, &&, ; or
+    redirects needs approval nobody can give in the chat, so it is denied
+
+Changeset mode (--with-changesets, Claude Code) adds to the read-safe mode:
+  - Creating, activating and inspecting changesets
+  - Staging new elements, element updates and new relationships (dr add,
+    dr update, dr relationship add) in the active changeset
+  - Never committing, applying, reverting or deleting: those stay with you.
+    Writes outside an active changeset are refused.
 
 Dangerous mode (--with-danger) enables unrestricted access:
   - Claude Code: --dangerously-skip-permissions (full tool access)
@@ -288,6 +299,7 @@ The --viewer-path option allows loading a local build of the web UI:
     // Commander sets 'auth' to false when --no-auth is used
     token: options.token,
     withDanger: options.withDanger,
+    withChangesets: options.withChangesets,
     viewerPath: options.viewerPath
   });
 }), program.command("mcp").description("Start MCP server for AI assistant integration").option("--regenerate-key", "Generate a new MCP API key, overwrite it at the configured storage path, and print it (does not start the server)").option("--transport <type>", "Transport type: stdio or http (default: stdio)", "stdio").option("--port <number>", "Port for HTTP transport (default: 3100, only meaningful with --transport http)", "3100").option("--host <address>", "Host address for HTTP transport (default: 127.0.0.1, only meaningful with --transport http)", "127.0.0.1").addHelpText("after", `
@@ -304,22 +316,22 @@ HTTP transport:
 Key management:
   $ dr mcp --regenerate-key                    # Generate new API key
 
-Initial Setup:
-On first launch, generates an API key and asks where to store it (interactive
-sessions only; non-interactive launches default to ~/.dr-mcp-key). The key is
-printed to stderr on every launch and must be supplied via environment variable.
-
 Stdio Configuration:
-For stdio transport, supply the key via environment variable:
+No API key: the client starts the server as your own user. In Claude Code, install the
+dr plugin (claude plugin install dr@documentation-robotics); other clients use:
 
   {
     "command": "dr",
-    "args": ["mcp"],
-    "env": { "DR_MCP_API_KEY": "<your-api-key>" }
+    "args": ["mcp"]
   }
 
+The server serves the project the client has open (its MCP roots); DR_MCP_ROOT_PATH
+pins it to one model instead.
+
 HTTP Configuration:
-For HTTP transport, include the API key as a Bearer token in the Authorization header:
+HTTP clients authenticate with an API key, generated on first launch (stored at
+~/.dr-mcp-key unless you choose a path interactively) and printed to stderr on every
+launch. Include it as a Bearer token in the Authorization header:
 
   {
     "url": "http://localhost:3100/mcp",

package/dist/cli.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/cli.ts"],
-  "sourcesContent": ["#!/usr/bin/env node\n\n/**\n * Documentation Robotics CLI - Bun Implementation\n * Entry point for the command-line interface\n *\n * Instrumented with OpenTelemetry to create root spans for command execution.\n * Telemetry is controlled by the TELEMETRY_ENABLED build-time constant.\n */\n\nimport { Command, CommanderError } from \"commander\";\nimport { setGlobalOptions } from \"./utils/globals.js\";\nimport { installAnsiSuppressor } from \"./utils/ansi-suppressor.js\";\nimport { initCommand } from \"./commands/init.js\";\nimport { addCommand } from \"./commands/add.js\";\nimport { updateCommand } from \"./commands/update.js\";\nimport { deleteCommand } from \"./commands/delete.js\";\nimport { showCommand } from \"./commands/show.js\";\nimport { listCommand } from \"./commands/list.js\";\nimport { searchCommand } from \"./commands/search.js\";\nimport { validateCommand } from \"./commands/validate.js\";\nimport { infoCommand } from \"./commands/info.js\";\nimport { relationshipCommands } from \"./commands/relationship.js\";\nimport { elementCommands } from \"./commands/element.js\";\nimport { schemaCommands } from \"./commands/schema.js\";\nimport { catalogCommands } from \"./commands/catalog.js\";\nimport { docsCommands } from \"./commands/docs.js\";\nimport { traceCommand } from \"./commands/trace.js\";\nimport { exportCommand } from \"./commands/export.js\";\nimport { importCommand } from \"./commands/import.js\";\nimport { chatCommand } from \"./commands/chat.js\";\nimport { upgradeCommand } from \"./commands/upgrade.js\";\nimport { conformanceCommand } from \"./commands/conformance.js\";\nimport { changesetCommands } from \"./commands/changeset.js\";\nimport { farmCommands } from \"./commands/farm.js\";\nimport { claudeCommands } from \"./commands/claude.js\";\nimport { copilotCommands } from \"./commands/copilot.js\";\nimport { analyzerCommands } from \"./commands/analyzer.js\";\nimport { versionCommand } from \"./commands/version.js\";\nimport { statsCommand } from \"./commands/stats.js\";\nimport { reportCommand } from \"./commands/report.js\";\nimport { reportsCommands } from \"./commands/reports.js\";\nimport { auditCommand } from \"./commands/audit.js\";\nimport { auditDiffCommand } from \"./commands/audit-diff.js\";\nimport { auditSnapshotsCommand } from \"./commands/audit-snapshots.js\";\nimport { repairAttributeCollisionCommand } from \"./commands/repair.js\";\nimport { initTelemetry, startActiveSpan, shutdownTelemetry } from \"./telemetry/index.js\";\nimport { installConsoleInterceptor } from \"./telemetry/console-interceptor.js\";\nimport { getErrorMessage, CLIError } from \"./utils/errors.js\";\nimport { getCliVersion } from \"./utils/spec-version.js\";\n\n// Declare TELEMETRY_ENABLED as a build-time constant (substituted by esbuild)\n// Provide runtime fallback when not running through esbuild\ndeclare const TELEMETRY_ENABLED: boolean;\nconst isTelemetryEnabled = typeof TELEMETRY_ENABLED !== \"undefined\" ? TELEMETRY_ENABLED : false;\n\n// Commands that require console interceptor for telemetry logging\nconst CONSOLE_LOGGING_COMMANDS = new Set(['chat', 'validate', 'import', 'export']);\n\n// Suppress ANSI color output on non-TTY stdout\nif (!process.stdout.isTTY) {\n  process.env.FORCE_COLOR = \"0\";\n  process.env.NO_COLOR = \"1\";\n}\n\n// Install the ANSI suppressor to strip color codes from console output when not on TTY\ninstallAnsiSuppressor();\n\n/**\n * Extract exit code from an error object.\n * Handles CLIError instances and duck-typed objects with exitCode property.\n */\nasync function extractExitCode(error: unknown): Promise<number> {\n  const { CLIError } = await import(\"./utils/errors.js\");\n\n  if (error instanceof CLIError) {\n    return error.exitCode;\n  }\n\n  // Commander's own errors (--help, unknown commands, etc.) carry exitCode as\n  // expected control flow \u2014 handle them directly without duck-typing.\n  if (error instanceof CommanderError) {\n    return error.exitCode;\n  }\n\n  // Fallback for duck-typing (handles bundling/module issues)\n  if (error && typeof error === \"object\" && \"exitCode\" in error) {\n    const errorObj = error as any;\n    if (typeof errorObj.exitCode === \"number\") {\n      // Validate this looks like a CLIError before accepting\n      if (errorObj.name === \"CLIError\" || errorObj.message) {\n        if (process.argv.includes(\"--debug\")) {\n          console.warn(\n            \"[DEBUG] Using duck-typed error object as fallback - this may indicate a module loading issue\"\n          );\n        }\n        return errorObj.exitCode;\n      }\n    }\n  }\n\n  return 1;\n}\n\nconst cliVersion = getCliVersion();\n\nconst program = new Command();\n\n// Handle --version and -V flags by redirecting to version command\n// This ensures they go through the telemetry wrapper\nif (process.argv.includes(\"--version\") || process.argv.includes(\"-V\")) {\n  process.argv = [\"node\", \"dr\", \"version\"];\n}\n\nprogram\n  .name(\"dr\")\n  .description(\"Documentation Robotics CLI - Architecture Model Management\")\n  .option(\"-v, --verbose\", \"Enable verbose output\")\n  .option(\"--debug\", \"Enable debug mode\")\n  .option(\"--json\", \"Output as JSON (supported on mutating and query commands)\")\n  .option(\"--codebase-path <path>\", \"Override codebase root path (default: resolved from manifest or project root)\")\n  .exitOverride() // Prevent Commander from calling process.exit() - we handle exit ourselves\n  .showSuggestionAfterError() // \"Did you mean X?\" on unknown commands/options\n  .hook(\"preAction\", async (thisCommand) => {\n    // Set up global state (verbose/debug/json flags)\n    const options = thisCommand.opts();\n    setGlobalOptions({\n      verbose: options.verbose as boolean | undefined,\n      debug: options.debug as boolean | undefined,\n      json: options.json as boolean | undefined,\n      codebasePath: options.codebasePath as string | undefined,\n    });\n  });\n\n// Model commands\nprogram\n  .command(\"init [name]\")\n  .description(\"Initialize a new architecture model\")\n  .option(\"--name <name>\", \"Model name (overrides positional argument)\")\n  .option(\"--author <author>\", \"Model author\")\n  .option(\"--description <desc>\", \"Model description\")\n  .addHelpText(\n    \"after\",\n    `\nExamples:\n  $ dr init\n  $ dr init claudetoreum\n  $ dr init \"Enterprise Architecture\" --author \"Team A\"\n  $ dr init --name \"My Project\" --description \"13-layer federated model\"`\n  )\n  .action((name, options) => initCommand({ ...options, name: options.name || name }));\n\nprogram\n  .command(\"add <layer> <type> <name>\")\n  .description(\"Add an element to a layer\")\n  .option(\"--model <path>\", \"Path to model root (contains model/manifest.yaml)\")\n  .option(\"--name <name>\", \"Element display name (defaults to the name argument)\")\n  .option(\"--description <desc>\", \"Element description\")\n  .option(\"--attributes <json>\", \"Element type-specific attributes as JSON object\")\n  .option(\"--source-file <path>\", \"Source file path (relative from repository root)\")\n  .option(\"--source-symbol <name>\", \"Symbol name (class, function, variable) in source file\")\n  .option(\"--source-provenance <type>\", \"Provenance type: extracted, manual, inferred, generated\")\n  .option(\"--source-repo-remote <url>\", \"Git remote URL for repository context\")\n  .option(\"--source-repo-commit <sha>\", \"Git commit SHA (40 hex characters) for repository context\")\n  .option(\"--verbose\", \"Show detailed output (can also use global -v flag)\")\n  .addHelpText(\n    \"after\",\n    `\nExamples:\n  $ dr add business service \"Customer Management\"\n  $ dr add api operation \"Create Customer\" --attributes '{\"operationId\":\"createCustomer\",\"summary\":\"Create a customer\",\"tags\":\"customers\"}'\n  $ dr add application component \"Customer API\" --description \"REST API for customer operations\"\n  $ dr add security policy \"Auth Validator\" --source-file \"src/auth/validator.ts\" --source-symbol \"validateToken\" --source-provenance \"extracted\"\n\nNote: Element IDs are generated automatically in format {layer}.{type}.{kebab-name}`\n  )\n  .action((layer, type, name, options) =>\n    addCommand(layer, type, name, { ...options, verbose: options.verbose ?? program.opts().verbose }));\n\nprogram\n  .command(\"update <id>\")\n  .description(\"Update an element\")\n  .option(\"--model <path>\", \"Path to model root (contains model/manifest.yaml)\")\n  .option(\"--name <name>\", \"New element name\")\n  .option(\"--description <desc>\", \"New description\")\n  .option(\"--type <new-type>\", \"Change element type (must be valid for the element's layer; incompatible attributes must be cleaned up manually)\")\n  .option(\"--attributes <json>\", \"Updated type-specific attributes (JSON)\")\n  .option(\"--source-file <path>\", \"Source file path (relative from repository root)\")\n  .option(\"--source-symbol <name>\", \"Symbol name (class, function, variable) in source file\")\n  .option(\"--source-provenance <type>\", \"Provenance type: extracted, manual, inferred, generated\")\n  .option(\"--source-repo-remote <url>\", \"Git remote URL for repository context\")\n  .option(\"--source-repo-commit <sha>\", \"Git commit SHA (40 hex characters) for repository context\")\n  .option(\"--clear-source-reference\", \"Remove source reference from element\")\n  .option(\"--verbose\", \"Show detailed output (can also use global -v flag)\")\n  .addHelpText(\n    \"after\",\n    `\nNote: Changes are written immediately to model files.\nTo track changes for review, activate a changeset first:\n  $ dr changeset activate my-changeset\n\nExamples:\n  $ dr update api-endpoint-create-customer --name \"Create Customer (v2)\"\n  $ dr update business-service-order --description \"Updated description\"\n  $ dr update application-applicationfunction-process-orders --type applicationservice\n  $ dr update security-policy-auth --source-file \"src/auth/policy.ts\" --source-provenance \"extracted\"`\n  )\n  .action((id, options) =>\n    updateCommand(id, { ...options, verbose: options.verbose ?? program.opts().verbose }));\n\nprogram\n  .command(\"delete <id>\")\n  .description(\"Delete an element\")\n  .option(\"--model <path>\", \"Path to model root (contains model/manifest.yaml)\")\n  .option(\"--force\", \"Skip dependency checks (confirmation is also skipped in non-TTY environments)\")\n  .option(\"--cascade\", \"Remove dependent elements automatically\")\n  .option(\"--dry-run\", \"Show what would be removed without actually removing\")\n  .option(\"--verbose\", \"Show detailed output (can also use global -v flag)\")\n  .addHelpText(\n    \"after\",\n    `\nExamples:\n  $ dr delete api-endpoint-old-endpoint\n  $ dr delete api-endpoint-old-endpoint --force\n  $ dr delete api-endpoint-old-endpoint --cascade\n  $ dr delete api-endpoint-old-endpoint --dry-run\n  $ dr delete api-endpoint-old-endpoint --cascade --dry-run`\n  )\n  .action((id, options) =>\n    deleteCommand(id, { ...options, verbose: options.verbose ?? program.opts().verbose }));\n\nprogram\n  .command(\"show <id>\")\n  .description(\"Display element details\")\n  .option(\"--model <path>\", \"Path to model root (contains model/manifest.yaml)\")\n  .addHelpText(\n    \"after\",\n    `\nExamples:\n  $ dr show api-endpoint-create-customer\n  $ dr show business-service-order-mgmt`\n  )\n  .action((id, options) => showCommand(id, options));\n\nprogram\n  .command(\"list [layer]\")\n  .description(\"List elements in a layer (or all layers if omitted)\")\n  .option(\"--type <type>\", \"Filter by element type\")\n  .option(\"--json\", \"Output as JSON\")\n  .option(\"--model <path>\", \"Path to model root (contains model/manifest.yaml)\")\n  .addHelpText(\n    \"after\",\n    `\nExamples:\n  $ dr list\n  $ dr list api\n  $ dr list business --type businessservice\n  $ dr list api --json\n  $ dr list --json`\n  )\n  .action((layer, options) => {\n    return listCommand(layer, { ...options, json: options.json ?? program.opts().json });\n  });\n\nprogram\n  .command(\"search <query>\")\n  .description(\"Search for elements by name or ID\")\n  .option(\"--layer <layer>\", \"Limit search to specific layer\")\n  .option(\"--type <type>\", \"Filter by element type\")\n  .option(\n    \"--source-file <path>\",\n    \"Find elements referencing a source file (takes precedence over pattern matching)\"\n  )\n  .option(\"--json\", \"Output as JSON\")\n  .addHelpText(\n    \"after\",\n    `\nExamples:\n  $ dr search customer\n  $ dr search \"order processing\" --layer business\n  $ dr search create-* --type endpoint\n  $ dr search \"\" --source-file src/api/customer.ts`\n  )\n  .action((query, options) => {\n    return searchCommand(query, { ...options, json: options.json ?? program.opts().json });\n  });\n\nprogram\n  .command(\"validate\")\n  .description(\"Validate the architecture model\")\n  .option(\"--layers <layers...>\", \"Specific layers to validate\")\n  .option(\"--strict\", \"Treat warnings as errors\")\n  .option(\"--verbose\", \"Show detailed validation output with relationship breakdown\")\n  .option(\"--quiet\", \"Show minimal output\")\n  .option(\"--output <path>\", \"Export validation report to file (JSON or Markdown)\")\n  .option(\"--model <path>\", \"Path to model root (contains model/manifest.yaml)\")\n  .option(\"--orphans\", \"Show only orphaned elements grouped by layer with relationship suggestions\")\n  .option(\"--all\", \"Run all validations (default behavior)\")\n  .option(\"--markdown\", \"Validate markdown structure\")\n  .option(\"--schemas\", \"Validate JSON schemas\")\n  .option(\"--schema\", \"Validate JSON schemas (alias for --schemas)\")\n  .option(\"--relationships\", \"Validate relationships\")\n  .option(\"--structure\", \"Validate documentation structure\")\n  .option(\"--naming\", \"Validate naming conventions\")\n  .option(\"--references\", \"Validate cross-layer references\")\n  .option(\"--scope <scope>\", \"Validation scope: 'local' (default) or 'composed' for cross-model validation\")\n  .option(\"--model-path <mapping...>\", \"Override filesystem path for external model (format: model-name=/path/to/project-root, can be repeated)\")\n  .addHelpText(\n    \"after\",\n    `\nExamples:\n  $ dr validate\n  $ dr validate --all --strict\n  $ dr validate --verbose\n  $ dr validate --quiet\n  $ dr validate --output report.json\n  $ dr validate --output report.md\n  $ dr validate --schemas\n  $ dr validate --relationships\n  $ dr validate --layers business api\n  $ dr validate --orphans\n  $ dr validate --orphans --output orphans.json\n  $ dr validate --scope composed --model-path auth-service=/path/to/auth-service-repo\n  $ dr validate --scope composed --model-path auth-service=/path/to/auth-service-repo --model-path payment-service=/path/to/payment-repo\n\nNote: When using --model-path, pass the project root (where documentation-robotics/model/ is located).`\n  )\n  .action(validateCommand);\n\nprogram\n  .command(\"export <format>\")\n  .description(\"Export the architecture model to various formats\")\n  .option(\"--output <path>\", \"Output file path (default: print to stdout)\")\n  .option(\"--layers <layers...>\", \"Specific layers to export\")\n  .option(\"--model <path>\", \"Path to model root directory or manifest.yaml file\")\n  .option(\"--include-sources\", \"Include source file paths in PlantUML diagrams as notes\")\n  .addHelpText(\n    \"after\",\n    `\nSupported formats:\n  archimate    Export to ArchiMate XML (layers 1, 2, 5, 6)\n  openapi      Export to OpenAPI 3.0 specification (layer 7)\n  jsonschema   Export to JSON Schema (layer 8)\n  plantuml     Export to PlantUML diagram\n  graphml      Export to GraphML (graph visualization)\n  markdown     Export to Markdown documentation\n\nExamples:\n  $ dr export archimate --output model.xml\n  $ dr export openapi --layers api\n  $ dr export plantuml --include-sources --output diagram.puml\n  $ dr export markdown --output docs/architecture.md`\n  )\n  .action(async (format, options) => {\n    await exportCommand({\n      format,\n      output: options.output,\n      layers: options.layers,\n      model: options.model,\n      includeSources: options.includeSources,\n    });\n  });\n\nprogram\n  .command(\"import <format>\")\n  .description(\"Import architecture model from various formats\")\n  .option(\"--input <path>\", \"Input file path (required)\", undefined)\n  .option(\"--model <path>\", \"Path to model root directory or manifest.yaml file\")\n  .option(\n    \"--merge-strategy <strategy>\",\n    \"How to handle existing elements: add, update, skip (default: add)\"\n  )\n  .addHelpText(\n    \"after\",\n    `\nSupported formats:\n  archimate    Import from ArchiMate XML (layers 1, 2, 5, 6)\n  openapi      Import from OpenAPI 3.0 specification (layer 7)\n\nExamples:\n  $ dr import archimate --input model.xml\n  $ dr import openapi --input api.json --merge-strategy add\n  $ dr import archimate --input model.xml --model ./myproject`\n  )\n  .action(async (format, options) => {\n    if (!options.input) {\n      console.error(\"Error: --input path is required\");\n      process.exit(1);\n    }\n    await importCommand({\n      format,\n      input: options.input,\n      model: options.model,\n      mergeStrategy: options.mergeStrategy as \"add\" | \"update\" | \"skip\" | undefined,\n    });\n  });\n\nprogram\n  .command(\"info\")\n  .description(\"Show model information\")\n  .option(\"--layer <layer>\", \"Show specific layer details\")\n  .option(\"--verbose\", \"Show detailed breakdown by element type\")\n  .addHelpText(\n    \"after\",\n    `\nExamples:\n  $ dr info\n  $ dr info --layer business\n  $ dr info --layer api --verbose`\n  )\n  .action(infoCommand);\n\nprogram\n  .command(\"stats\")\n  .description(\"Display model statistics and health metrics\")\n  .option(\"--model <path>\", \"Path to the model directory\")\n  .option(\"--format <format>\", \"Output format: text (default), json, markdown, compact\")\n  .option(\"--output <path>\", \"Output file path (auto-detects format from extension)\")\n  .option(\"--compact\", \"Show compact one-line summary\")\n  .option(\"--verbose\", \"Show detailed information\")\n  .addHelpText(\n    \"after\",\n    `\nOutput formats:\n  text       Full formatted statistics (default)\n  json       JSON output for automation\n  markdown   Markdown report format\n  compact    Single-line summary\n\nExamples:\n  $ dr stats                           # Show full statistics\n  $ dr stats --compact                 # Show one-line summary\n  $ dr stats --format json             # Output as JSON\n  $ dr stats --output stats.md         # Save as markdown file\n  $ dr stats --output stats.json       # Save as JSON file\n  $ dr stats --verbose                 # Show detailed information`\n  )\n  .action((options) => statsCommand(options));\n\nprogram\n  .command(\"report\")\n  .description(\"Generate comprehensive architecture reports\")\n  .option(\"--model <path>\", \"Path to the model directory\")\n  .option(\"--type <type>\", \"Report type: comprehensive (default), statistics, relationships, data-model, quality\")\n  .option(\"--format <format>\", \"Output format: text (default), json, markdown\")\n  .option(\"--output <path>\", \"Output file path (auto-detects format from extension)\")\n  .option(\"--verbose\", \"Show detailed information\")\n  .option(\"--include-data-model\", \"Include data model analysis (default: true)\")\n  .option(\"--include-quality\", \"Include quality metrics (default: true)\")\n  .addHelpText(\n    \"after\",\n    `\nReport types:\n  comprehensive  Full report with statistics, relationships, and data model (default)\n  statistics     Statistics and quality metrics\n  relationships  Relationship analysis and classification\n  data-model     Layer 8 data model analysis\n  quality        Quality metrics and recommendations\n\nOutput formats:\n  text       Full formatted report (default)\n  json       JSON output for automation\n  markdown   Markdown report format\n\nExamples:\n  $ dr report                                      # Show comprehensive report\n  $ dr report --type relationships                 # Show relationship analysis\n  $ dr report --format json                        # Output as JSON\n  $ dr report --output report.md                   # Save as markdown file\n  $ dr report --type data-model --output dm.md     # Data model report as markdown\n  $ dr report --verbose                            # Show detailed information`\n  )\n  .action((options) => reportCommand(options));\n\n// Reports subcommands (managed layer report files)\nconst reportsGroup = program.command(\"reports\").description(\"Manage architecture layer reports\");\nreportsCommands(reportsGroup);\n\n// Audit command - Relationship analysis\nprogram\n  .command(\"audit [layer]\")\n  .description(\"Analyze relationship coverage, gaps, duplicates, and balance\")\n  .option(\"--type <type>\", \"Audit type: relationships (default), nodes, all\")\n  .option(\"--format <format>\", \"Output format: text (default), json, markdown\")\n  .option(\"--output <path>\", \"Output file path (auto-detects format from extension)\")\n  .option(\"--verbose\", \"Show detailed analysis\")\n  .option(\"--save-snapshot\", \"Save audit report as snapshot for differential analysis\")\n  .addHelpText(\n    \"after\",\n    `\nAudit types:\n  relationships  Relationship coverage, gaps, duplicates, balance (default)\n  nodes          Node type usage distribution across model layers\n  all            Both relationship and node audits\n\nOutput formats:\n  text       Full formatted audit report (default)\n  json       JSON output for automation\n  markdown   Markdown audit report format\n\nExamples:\n  $ dr audit                           # Full relationship audit of all layers\n  $ dr audit security                  # Audit security layer only\n  $ dr audit --type nodes              # Node type distribution audit\n  $ dr audit --type all                # Combined relationship + node audit\n  $ dr audit --format json             # Output as JSON\n  $ dr audit --output audit.md         # Save as markdown file\n  $ dr audit --verbose                 # Show detailed analysis\n  $ dr audit --save-snapshot           # Save snapshot for later comparison\n  $ dr audit api --output api-audit.json  # API layer audit as JSON`\n  )\n  .action((layer, options) =>\n    auditCommand({ ...options, layer, verbose: options.verbose ?? program.opts().verbose }));\n\n// Audit diff command - Compare snapshots\nprogram\n  .command(\"audit:diff\")\n  .description(\"Compare before/after audit snapshots\")\n  .option(\"--before <id>\", \"Before snapshot ID or timestamp\")\n  .option(\"--after <id>\", \"After snapshot ID or timestamp\")\n  .option(\"--format <format>\", \"Output format: text (default), json, markdown\")\n  .option(\"--output <path>\", \"Output file path\")\n  .option(\"--verbose\", \"Show detailed comparison\")\n  .addHelpText(\n    \"after\",\n    `\nExamples:\n  $ dr audit:diff                                  # Compare latest two snapshots\n  $ dr audit:diff --before 20260220-100000 --after 20260220-150000\n  $ dr audit:diff --format markdown --output diff.md\n  $ dr audit:diff --verbose                        # Show detailed changes`\n  )\n  .action((options) => auditDiffCommand(options));\n\n// Audit snapshots command - Manage snapshots\nprogram\n  .command(\"audit:snapshots <action>\")\n  .description(\"Manage audit snapshots (list, delete, clear)\")\n  .option(\"--id <id>\", \"Snapshot ID (for delete action)\")\n  .addHelpText(\n    \"after\",\n    `\nActions:\n  list     List all available snapshots\n  delete   Delete a specific snapshot (requires --id)\n  clear    Delete all snapshots\n\nExamples:\n  $ dr audit:snapshots list\n  $ dr audit:snapshots delete --id 20260220-100000\n  $ dr audit:snapshots clear`\n  )\n  .action((action, options) => auditSnapshotsCommand({ ...options, action }));\n\n// Repair command - Detect and recover data lost to fixed data-integrity bugs\nprogram\n  .command(\"repair:attribute-collision\")\n  .description(\n    'Find and best-effort-recover model data lost to a fixed bug where saveLayer() stripped \"source\"/\"x-source-reference\" attributes from every element, even when a node type\\'s schema declared one as a real (sometimes required) attribute'\n  )\n  .option(\"--apply\", \"Restore recoverable values found in changeset history (default: report only)\")\n  .option(\"--format <format>\", \"Output format: text (default), json\")\n  .option(\"--output <path>\", \"Write the report to a file instead of stdout\")\n  .addHelpText(\n    \"after\",\n    `\nThis repairs damage from a fixed bug in Model.saveLayer(): a hardcoded, type-blind \"internal\nfields\" blocklist unconditionally stripped any attribute literally named \"source\" or\n\"x-source-reference\" from every element's attributes before writing YAML, regardless of whether\nthe element's own schema declared it as a real domain attribute. 41 of 191 node schemas across 8\nlayers do (3 mark it required, meaning affected elements fail validation today).\n\nRecovery is best-effort: values can only be restored if they still exist in changeset history\n(committing a changeset does not delete it). Elements with no recoverable value are always\nreported, never fabricated \u2014 you'll need to re-supply those manually with\n\"dr update <id> --attributes '{...}'\".\n\nExamples:\n  $ dr repair:attribute-collision                    # Report only \u2014 no changes made\n  $ dr repair:attribute-collision --apply             # Restore every recoverable value\n  $ dr repair:attribute-collision --format json --output report.json`\n  )\n  .action((options) => repairAttributeCollisionCommand(options));\n\n// Relationship subcommands\nconst relationshipGroup = program.command(\"relationship\").description(\"Relationship operations\");\nrelationshipCommands(relationshipGroup, program);\n\n// Element subcommands\nconst elementGroup = program.command(\"element\").description(\"Element operations\");\nelementCommands(elementGroup, program);\n\n// Schema introspection subcommands\nschemaCommands(program);\n\n// Catalog subcommands (modern relationship catalog)\ncatalogCommands(program);\n\n// Documentation subcommands (schema-driven generation)\ndocsCommands(program);\n\n// Dependency analysis commands\nprogram\n  .command(\"trace <elementId>\")\n  .description(\"Trace dependencies for an element\")\n  .option(\n    \"--direction <dir>\",\n    \"Trace direction: up (dependencies), down (dependents), both (default)\"\n  )\n  .option(\"--depth <num>\", \"Maximum traversal depth\")\n  .option(\"--metrics\", \"Show graph and element metrics\")\n  .option(\"--model <path>\", \"Path to model root (contains model/manifest.yaml)\")\n  .addHelpText(\n    \"after\",\n    `\nExamples:\n  $ dr trace api-endpoint-create-customer\n  $ dr trace business-service-order --direction down --metrics\n  $ dr trace application-component-api --depth 3`\n  )\n  .action(async (elementId, options) => {\n    await traceCommand(elementId, {\n      direction: options.direction as \"up\" | \"down\" | \"both\" | undefined,\n      depth: options.depth ? parseInt(options.depth) : undefined,\n      showMetrics: options.metrics,\n      model: options.model,\n    });\n  });\n\nprogram\n  .command(\"visualize\")\n  .description(\"Launch visualization server with WebSocket support\")\n  .option(\"--port <num>\", \"Server port (default: 8080)\")\n  .option(\"--no-browser\", \"Do not auto-open browser\")\n  .option(\"--no-auth\", \"Disable authentication (enabled by default)\")\n  .option(\"--token <token>\", \"Custom auth token (auto-generated by default)\")\n  .option(\"--with-danger\", \"Enable dangerous mode for chat (skip permissions)\")\n  .option(\n    \"--viewer-path <path>\",\n    \"Path to custom viewer build (e.g., ./dist/embedded/dr-viewer-bundle)\"\n  )\n  .addHelpText(\n    \"after\",\n    `\nExamples:\n  $ dr visualize\n  $ dr visualize --port 3000\n  $ dr visualize --no-browser\n  $ dr visualize --no-auth\n  $ dr visualize --token my-secret-token\n  $ dr visualize --with-danger\n  $ dr visualize --viewer-path ./dist/embedded/dr-viewer-bundle\n\nDefault mode (read-safe permissions) enables:\n  - Running 'dr' CLI commands to query the architecture model\n  - Reading the codebase\n  - Reading the documentation-robotics/ model folder\n  - Reading the .dr/ configuration folder\n\nDangerous mode (--with-danger) enables unrestricted access:\n  - Claude Code: --dangerously-skip-permissions (full tool access)\n  - GitHub Copilot: --allow-all-tools (full tool access)\n\nThe --viewer-path option allows loading a local build of the web UI:\n  - Point to a directory containing index.html and supporting files\n  - Useful for developing custom viewers or using bundled distributions`\n  )\n  .action(async (options) => {\n    const { visualizeCommand } = await import(\"./commands/visualize.js\");\n    await visualizeCommand({\n      port: options.port,\n      noBrowser: options.browser === false, // Commander sets 'browser' to false when --no-browser is used\n      noAuth: options.auth === false, // Commander sets 'auth' to false when --no-auth is used\n      token: options.token,\n      withDanger: options.withDanger,\n      viewerPath: options.viewerPath,\n    });\n  });\n\nprogram\n  .command(\"mcp\")\n  .description(\"Start MCP server for AI assistant integration\")\n  .option(\n    \"--regenerate-key\",\n    \"Generate a new MCP API key, overwrite it at the configured storage path, and print it (does not start the server)\"\n  )\n  .option(\n    \"--transport <type>\",\n    \"Transport type: stdio or http (default: stdio)\",\n    \"stdio\"\n  )\n  .option(\n    \"--port <number>\",\n    \"Port for HTTP transport (default: 3100, only meaningful with --transport http)\",\n    \"3100\"\n  )\n  .option(\n    \"--host <address>\",\n    \"Host address for HTTP transport (default: 127.0.0.1, only meaningful with --transport http)\",\n    \"127.0.0.1\"\n  )\n  .addHelpText(\n    \"after\",\n    `\nExamples:\n\nStdio transport (default):\n  $ dr mcp\n\nHTTP transport:\n  $ dr mcp --transport http                    # HTTP on localhost:3100\n  $ dr mcp --transport http --port 8200        # HTTP on custom port\n  $ dr mcp --transport http --host 0.0.0.0 --port 3100  # Listen on all interfaces\n\nKey management:\n  $ dr mcp --regenerate-key                    # Generate new API key\n\nInitial Setup:\nOn first launch, generates an API key and asks where to store it (interactive\nsessions only; non-interactive launches default to ~/.dr-mcp-key). The key is\nprinted to stderr on every launch and must be supplied via environment variable.\n\nStdio Configuration:\nFor stdio transport, supply the key via environment variable:\n\n  {\n    \"command\": \"dr\",\n    \"args\": [\"mcp\"],\n    \"env\": { \"DR_MCP_API_KEY\": \"<your-api-key>\" }\n  }\n\nHTTP Configuration:\nFor HTTP transport, include the API key as a Bearer token in the Authorization header:\n\n  {\n    \"url\": \"http://localhost:3100/mcp\",\n    \"headers\": {\n      \"Authorization\": \"Bearer <your-api-key>\"\n    }\n  }\n\nUse --regenerate-key to rotate the key (e.g. after a suspected leak) without\nmanually deleting the stored key file or config.`\n  )\n  .action(async (options) => {\n    const { mcpCommand } = await import(\"./commands/mcp.js\");\n    const transport = (options.transport as string).toLowerCase();\n    if (transport !== \"stdio\" && transport !== \"http\") {\n      throw new CLIError(`Invalid transport: ${transport}. Allowed values: stdio, http`, 1);\n    }\n    const port = parseInt(options.port as string, 10);\n    if (!Number.isFinite(port) || port < 1 || port > 65535) {\n      throw new CLIError(`Invalid port: ${options.port}. Must be a number between 1 and 65535`, 1);\n    }\n    await mcpCommand({\n      regenerateKey: options.regenerateKey,\n      transport: transport as \"stdio\" | \"http\",\n      port,\n      host: options.host as string,\n    });\n  });\n\n// AI Integration command\nprogram\n  .command(\"chat [client] [withDanger]\")\n  .description(\"Interactive chat with AI about the architecture model\")\n  .addHelpText(\n    \"after\",\n    `\nArguments:\n  client      Optional AI client to use: \"claude-code\" or \"github-copilot\"\n  withDanger  Enable dangerous mode: \"with-danger\"\n\nExamples:\n  $ dr chat                           # Auto-detect or use saved preference\n  $ dr chat claude-code               # Use Claude Code, save as preference\n  $ dr chat github-copilot            # Use GitHub Copilot, save as preference\n  $ dr chat with-danger               # Auto-detect with dangerous mode\n  $ dr chat claude-code with-danger   # Use Claude Code with dangerous mode\n  $ dr chat github-copilot with-danger # Use GitHub Copilot with dangerous mode\n\nDefault mode (read-safe permissions) enables:\n  - Running 'dr' CLI commands to query the architecture model\n  - Reading the codebase\n  - Reading the documentation-robotics/ model folder\n  - Reading the .dr/ configuration folder\n\nDangerous mode (--with-danger) enables unrestricted access:\n  - Claude Code: --dangerously-skip-permissions (full tool access)\n  - GitHub Copilot: --allow-all-tools (full tool access)\n\nThis launches an interactive chat interface where you can ask AI questions\nabout your architecture model. Supports Claude Code CLI and GitHub Copilot CLI.\n\nInstall instructions:\n  - Claude Code: https://claude.ai\n  - GitHub Copilot: gh extension install github/gh-copilot`\n  )\n  .action(async (client?: string, withDangerArg?: string) => {\n    // Parse arguments - handle both \"with-danger\" as first or second arg\n    let selectedClient: string | undefined;\n    let withDanger = false;\n\n    if (client === \"with-danger\") {\n      // Format: dr chat with-danger\n      withDanger = true;\n      selectedClient = undefined;\n    } else if (withDangerArg === \"with-danger\") {\n      // Format: dr chat <client> with-danger\n      withDanger = true;\n      selectedClient = client;\n    } else {\n      // Format: dr chat <client>\n      selectedClient = client;\n    }\n\n    await chatCommand(selectedClient, withDanger);\n  });\n\n// Advanced commands\nprogram\n  .command(\"version\")\n  .description(\"Show CLI and embedded spec version information\")\n  .addHelpText(\n    \"after\",\n    `\nExamples:\n  $ dr version`\n  )\n  .action(async () => {\n    await versionCommand();\n  });\n\nprogram\n  .command(\"upgrade\")\n  .description(\"Upgrade spec reference and migrate model to latest versions\")\n  .option(\"-y, --yes\", \"Automatically upgrade without prompting\")\n  .option(\"--dry-run\", \"Show what would be upgraded without making changes\")\n  .option(\"--force\", \"Force all upgrades regardless of current versions; skips migration validation\")\n  .addHelpText(\n    \"after\",\n    `\nExamples:\n  $ dr upgrade              # Scan, show plan, and prompt for upgrades\n  $ dr upgrade --dry-run    # Preview available upgrades\n  $ dr upgrade --yes        # Upgrade without prompting\n  $ dr upgrade --force      # Force all upgrades, ignoring version checks`\n  )\n  .action(async (options) => {\n    await upgradeCommand({\n      yes: options.yes,\n      dryRun: options.dryRun,\n      force: options.force,\n    });\n  });\n\nprogram\n  .command(\"conformance\")\n  .description(\"Check model conformance to layer specifications\")\n  .option(\"--layers <layers...>\", \"Specific layers to check\")\n  .option(\"--json\", \"Output as JSON\")\n  .option(\"--verbose\", \"Verbose output\")\n  .addHelpText(\n    \"after\",\n    `\nExamples:\n  $ dr conformance\n  $ dr conformance --layers business api application\n  $ dr conformance --json\n  $ dr conformance --verbose`\n  )\n  .action(async (options) => {\n    await conformanceCommand({\n      layers: options.layers,\n      json: options.json ?? program.opts().json,\n      verbose: options.verbose ?? program.opts().verbose,\n    });\n  });\n\n// Changeset subcommands\nchangesetCommands(program);\n\n// Farm subcommands\nfarmCommands(program);\n\n// Claude Code integration subcommands\nclaudeCommands(program);\n\n// GitHub Copilot integration subcommands\ncopilotCommands(program);\n\n// Analyzer integration subcommands\nanalyzerCommands(program);\n\n// Execute CLI with proper telemetry span wrapping\n// This creates a root span that all child spans will be linked to\n(async () => {\n  let exitCode = 0;\n  try {\n    if (isTelemetryEnabled) {\n      // Initialize telemetry before execution\n      await initTelemetry();\n\n      // Only install console interceptor for commands that need it\n      const commandName = process.argv[2] || \"unknown\";\n      if (CONSOLE_LOGGING_COMMANDS.has(commandName)) {\n        await installConsoleInterceptor();\n      }\n\n      const args = process.argv.slice(3).join(\" \");\n\n      // Wrap entire CLI execution in active span for proper context propagation\n      await startActiveSpan(\n        \"cli.execute\",\n        async (span) => {\n          // Attributes already set via options parameter - no duplicate setAttributes needed\n          try {\n            // Execute command - all child spans will now link to this root span\n            await program.parseAsync(process.argv);\n\n            // Set success status\n            span.setStatus({ code: 0 }); // SpanStatusCode.OK\n          } catch (error) {\n            // Record exception and set error status\n            // CommanderError with exitCode 0 is help text / unknown subcommand shown \u2014 not a real error\n            if (error instanceof CommanderError) {\n              if (error.exitCode === 0) {\n                span.setStatus({ code: 0 }); // SpanStatusCode.OK\n              } else {\n                span.recordException(error as Error);\n                span.setStatus({\n                  code: 2, // SpanStatusCode.ERROR\n                  message: error.message,\n                });\n              }\n            } else {\n              span.recordException(error as Error);\n              span.setStatus({\n                code: 2, // SpanStatusCode.ERROR\n                message: getErrorMessage(error),\n              });\n            }\n\n            // Print error message for CLIError instances\n            // Skip CommanderError \u2014 Commander already printed its own output (e.g. help text, unknown command)\n            const { CLIError } = await import(\"./utils/errors.js\");\n            const { isJson } = await import(\"./utils/globals.js\");\n            if (error instanceof CommanderError) {\n              // Commander handled its own output; nothing to print\n            } else if (error instanceof CLIError) {\n              // In JSON mode, handleError already output structured JSON; skip text formatting\n              if (!isJson()) {\n                console.error(error.format());\n              }\n            } else if (error instanceof Error) {\n              console.error(error.message);\n            } else {\n              console.error(String(error));\n            }\n\n            // Extract exit code from CLIError if available\n            exitCode = await extractExitCode(error);\n            // Don't throw - let telemetry shutdown complete\n          }\n        },\n        {\n          \"cli.command\": commandName,\n          \"cli.args\": args,\n          \"cli.cwd\": process.cwd(),\n          \"cli.version\": cliVersion,\n        }\n      );\n\n      // Shutdown telemetry after execution completes\n      await shutdownTelemetry();\n\n      // Exit with exit code (keepAlive disabled in exporters prevents hanging)\n      process.exit(exitCode);\n    } else {\n      // No telemetry - just parse normally with error handling\n      try {\n        await program.parseAsync(process.argv);\n      } catch (error) {\n        // Extract exit code from CLIError if available\n        // Skip CommanderError \u2014 Commander already printed its own output (e.g. help text, unknown command)\n        const { CLIError } = await import(\"./utils/errors.js\");\n        const { isJson } = await import(\"./utils/globals.js\");\n        if (error instanceof CommanderError) {\n          // Commander handled its own output; nothing to print\n        } else if (error instanceof CLIError) {\n          // In JSON mode, handleError already output structured JSON; skip text formatting\n          if (!isJson()) {\n            console.error(error.format());\n          }\n        } else {\n          // Unexpected exceptions need to be printed\n          if (error instanceof Error) {\n            console.error(error.message);\n          } else {\n            console.error(String(error));\n          }\n        }\n        const exitCodeFromError = await extractExitCode(error);\n        process.exit(exitCodeFromError);\n      }\n    }\n  } catch (error) {\n    // Error during telemetry init or shutdown\n    if (!isTelemetryEnabled) {\n      // No telemetry - exit immediately with error\n      process.exit(1);\n    }\n    // Telemetry enabled - try to shutdown before exit\n    await shutdownTelemetry();\n    process.exit(1);\n  }\n})();\n"],
-  "mappings": "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",
+  "sourcesContent": ["#!/usr/bin/env node\n\n/**\n * Documentation Robotics CLI - Bun Implementation\n * Entry point for the command-line interface\n *\n * Instrumented with OpenTelemetry to create root spans for command execution.\n * Telemetry is controlled by the TELEMETRY_ENABLED build-time constant.\n */\n\nimport { Command, CommanderError } from \"commander\";\nimport { setGlobalOptions } from \"./utils/globals.js\";\nimport { installAnsiSuppressor } from \"./utils/ansi-suppressor.js\";\nimport { initCommand } from \"./commands/init.js\";\nimport { addCommand } from \"./commands/add.js\";\nimport { updateCommand } from \"./commands/update.js\";\nimport { deleteCommand } from \"./commands/delete.js\";\nimport { showCommand } from \"./commands/show.js\";\nimport { listCommand } from \"./commands/list.js\";\nimport { searchCommand } from \"./commands/search.js\";\nimport { validateCommand } from \"./commands/validate.js\";\nimport { infoCommand } from \"./commands/info.js\";\nimport { relationshipCommands } from \"./commands/relationship.js\";\nimport { elementCommands } from \"./commands/element.js\";\nimport { schemaCommands } from \"./commands/schema.js\";\nimport { catalogCommands } from \"./commands/catalog.js\";\nimport { docsCommands } from \"./commands/docs.js\";\nimport { traceCommand } from \"./commands/trace.js\";\nimport { exportCommand } from \"./commands/export.js\";\nimport { importCommand } from \"./commands/import.js\";\nimport { chatCommand } from \"./commands/chat.js\";\nimport { upgradeCommand } from \"./commands/upgrade.js\";\nimport { conformanceCommand } from \"./commands/conformance.js\";\nimport { changesetCommands } from \"./commands/changeset.js\";\nimport { farmCommands } from \"./commands/farm.js\";\nimport { claudeCommands } from \"./commands/claude.js\";\nimport { copilotCommands } from \"./commands/copilot.js\";\nimport { analyzerCommands } from \"./commands/analyzer.js\";\nimport { versionCommand } from \"./commands/version.js\";\nimport { statsCommand } from \"./commands/stats.js\";\nimport { reportCommand } from \"./commands/report.js\";\nimport { reportsCommands } from \"./commands/reports.js\";\nimport { auditCommand } from \"./commands/audit.js\";\nimport { auditDiffCommand } from \"./commands/audit-diff.js\";\nimport { auditSnapshotsCommand } from \"./commands/audit-snapshots.js\";\nimport { repairAttributeCollisionCommand } from \"./commands/repair.js\";\nimport { initTelemetry, startActiveSpan, shutdownTelemetry } from \"./telemetry/index.js\";\nimport { installConsoleInterceptor } from \"./telemetry/console-interceptor.js\";\nimport { getErrorMessage, CLIError } from \"./utils/errors.js\";\nimport { getCliVersion } from \"./utils/spec-version.js\";\n\n// Declare TELEMETRY_ENABLED as a build-time constant (substituted by esbuild)\n// Provide runtime fallback when not running through esbuild\ndeclare const TELEMETRY_ENABLED: boolean;\nconst isTelemetryEnabled = typeof TELEMETRY_ENABLED !== \"undefined\" ? TELEMETRY_ENABLED : false;\n\n// Commands that require console interceptor for telemetry logging\nconst CONSOLE_LOGGING_COMMANDS = new Set(['chat', 'validate', 'import', 'export']);\n\n// Suppress ANSI color output on non-TTY stdout\nif (!process.stdout.isTTY) {\n  process.env.FORCE_COLOR = \"0\";\n  process.env.NO_COLOR = \"1\";\n}\n\n// Install the ANSI suppressor to strip color codes from console output when not on TTY\ninstallAnsiSuppressor();\n\n/**\n * Extract exit code from an error object.\n * Handles CLIError instances and duck-typed objects with exitCode property.\n */\nasync function extractExitCode(error: unknown): Promise<number> {\n  const { CLIError } = await import(\"./utils/errors.js\");\n\n  if (error instanceof CLIError) {\n    return error.exitCode;\n  }\n\n  // Commander's own errors (--help, unknown commands, etc.) carry exitCode as\n  // expected control flow \u2014 handle them directly without duck-typing.\n  if (error instanceof CommanderError) {\n    return error.exitCode;\n  }\n\n  // Fallback for duck-typing (handles bundling/module issues)\n  if (error && typeof error === \"object\" && \"exitCode\" in error) {\n    const errorObj = error as any;\n    if (typeof errorObj.exitCode === \"number\") {\n      // Validate this looks like a CLIError before accepting\n      if (errorObj.name === \"CLIError\" || errorObj.message) {\n        if (process.argv.includes(\"--debug\")) {\n          console.warn(\n            \"[DEBUG] Using duck-typed error object as fallback - this may indicate a module loading issue\"\n          );\n        }\n        return errorObj.exitCode;\n      }\n    }\n  }\n\n  return 1;\n}\n\nconst cliVersion = getCliVersion();\n\nconst program = new Command();\n\n// Handle --version and -V flags by redirecting to version command\n// This ensures they go through the telemetry wrapper\nif (process.argv.includes(\"--version\") || process.argv.includes(\"-V\")) {\n  process.argv = [\"node\", \"dr\", \"version\"];\n}\n\nprogram\n  .name(\"dr\")\n  .description(\"Documentation Robotics CLI - Architecture Model Management\")\n  .option(\"-v, --verbose\", \"Enable verbose output\")\n  .option(\"--debug\", \"Enable debug mode\")\n  .option(\"--json\", \"Output as JSON (supported on mutating and query commands)\")\n  .option(\"--codebase-path <path>\", \"Override codebase root path (default: resolved from manifest or project root)\")\n  .exitOverride() // Prevent Commander from calling process.exit() - we handle exit ourselves\n  .showSuggestionAfterError() // \"Did you mean X?\" on unknown commands/options\n  .hook(\"preAction\", async (thisCommand) => {\n    // Set up global state (verbose/debug/json flags)\n    const options = thisCommand.opts();\n    setGlobalOptions({\n      verbose: options.verbose as boolean | undefined,\n      debug: options.debug as boolean | undefined,\n      json: options.json as boolean | undefined,\n      codebasePath: options.codebasePath as string | undefined,\n    });\n  });\n\n// Model commands\nprogram\n  .command(\"init [name]\")\n  .description(\"Initialize a new architecture model\")\n  .option(\"--name <name>\", \"Model name (overrides positional argument)\")\n  .option(\"--author <author>\", \"Model author\")\n  .option(\"--description <desc>\", \"Model description\")\n  .addHelpText(\n    \"after\",\n    `\nExamples:\n  $ dr init\n  $ dr init claudetoreum\n  $ dr init \"Enterprise Architecture\" --author \"Team A\"\n  $ dr init --name \"My Project\" --description \"13-layer federated model\"`\n  )\n  .action((name, options) => initCommand({ ...options, name: options.name || name }));\n\nprogram\n  .command(\"add <layer> <type> <name>\")\n  .description(\"Add an element to a layer\")\n  .option(\"--model <path>\", \"Path to model root (contains model/manifest.yaml)\")\n  .option(\"--name <name>\", \"Element display name (defaults to the name argument)\")\n  .option(\"--description <desc>\", \"Element description\")\n  .option(\"--attributes <json>\", \"Element type-specific attributes as JSON object\")\n  .option(\"--source-file <path>\", \"Source file path (relative from repository root)\")\n  .option(\"--source-symbol <name>\", \"Symbol name (class, function, variable) in source file\")\n  .option(\"--source-provenance <type>\", \"Provenance type: extracted, manual, inferred, generated\")\n  .option(\"--source-repo-remote <url>\", \"Git remote URL for repository context\")\n  .option(\"--source-repo-commit <sha>\", \"Git commit SHA (40 hex characters) for repository context\")\n  .option(\"--verbose\", \"Show detailed output (can also use global -v flag)\")\n  .addHelpText(\n    \"after\",\n    `\nExamples:\n  $ dr add business service \"Customer Management\"\n  $ dr add api operation \"Create Customer\" --attributes '{\"operationId\":\"createCustomer\",\"summary\":\"Create a customer\",\"tags\":\"customers\"}'\n  $ dr add application component \"Customer API\" --description \"REST API for customer operations\"\n  $ dr add security policy \"Auth Validator\" --source-file \"src/auth/validator.ts\" --source-symbol \"validateToken\" --source-provenance \"extracted\"\n\nNote: Element IDs are generated automatically in format {layer}.{type}.{kebab-name}`\n  )\n  .action((layer, type, name, options) =>\n    addCommand(layer, type, name, { ...options, verbose: options.verbose ?? program.opts().verbose }));\n\nprogram\n  .command(\"update <id>\")\n  .description(\"Update an element\")\n  .option(\"--model <path>\", \"Path to model root (contains model/manifest.yaml)\")\n  .option(\"--name <name>\", \"New element name\")\n  .option(\"--description <desc>\", \"New description\")\n  .option(\"--type <new-type>\", \"Change element type (must be valid for the element's layer; incompatible attributes must be cleaned up manually)\")\n  .option(\"--attributes <json>\", \"Updated type-specific attributes (JSON)\")\n  .option(\"--attribute-patch <json>\", \"Merge these attributes into the current ones (JSON object; null removes a key). Cannot be combined with --attributes\")\n  .option(\"--source-file <path>\", \"Source file path (relative from repository root)\")\n  .option(\"--source-symbol <name>\", \"Symbol name (class, function, variable) in source file. Without --source-file, added to the element's one source file, keeping its provenance\")\n  .option(\"--source-provenance <type>\", \"Provenance type: extracted, manual, inferred, generated\")\n  .option(\"--source-repo-remote <url>\", \"Git remote URL for repository context\")\n  .option(\"--source-repo-commit <sha>\", \"Git commit SHA (40 hex characters) for repository context\")\n  .option(\"--clear-source-reference\", \"Remove source reference from element\")\n  .option(\"--verbose\", \"Show detailed output (can also use global -v flag)\")\n  .addHelpText(\n    \"after\",\n    `\nNote: Changes are written immediately to model files.\nTo track changes for review, activate a changeset first:\n  $ dr changeset activate my-changeset\n\nExamples:\n  $ dr update api-endpoint-create-customer --name \"Create Customer (v2)\"\n  $ dr update business-service-order --description \"Updated description\"\n  $ dr update application-applicationfunction-process-orders --type applicationservice\n  $ dr update api.operation.create-customer --attribute-patch '{\"summary\":\"Create a customer (v2)\"}'\n  $ dr update security-policy-auth --source-file \"src/auth/policy.ts\" --source-provenance \"extracted\"`\n  )\n  .action((id, options) =>\n    updateCommand(id, { ...options, verbose: options.verbose ?? program.opts().verbose }));\n\nprogram\n  .command(\"delete <id>\")\n  .description(\"Delete an element\")\n  .option(\"--model <path>\", \"Path to model root (contains model/manifest.yaml)\")\n  .option(\"--force\", \"Skip dependency checks (confirmation is also skipped in non-TTY environments)\")\n  .option(\"--cascade\", \"Remove dependent elements automatically\")\n  .option(\"--dry-run\", \"Show what would be removed without actually removing\")\n  .option(\"--verbose\", \"Show detailed output (can also use global -v flag)\")\n  .addHelpText(\n    \"after\",\n    `\nExamples:\n  $ dr delete api-endpoint-old-endpoint\n  $ dr delete api-endpoint-old-endpoint --force\n  $ dr delete api-endpoint-old-endpoint --cascade\n  $ dr delete api-endpoint-old-endpoint --dry-run\n  $ dr delete api-endpoint-old-endpoint --cascade --dry-run`\n  )\n  .action((id, options) =>\n    deleteCommand(id, { ...options, verbose: options.verbose ?? program.opts().verbose }));\n\nprogram\n  .command(\"show <id>\")\n  .description(\"Display element details\")\n  .option(\"--model <path>\", \"Path to model root (contains model/manifest.yaml)\")\n  .addHelpText(\n    \"after\",\n    `\nExamples:\n  $ dr show api-endpoint-create-customer\n  $ dr show business-service-order-mgmt`\n  )\n  .action((id, options) => showCommand(id, options));\n\nprogram\n  .command(\"list [layer]\")\n  .description(\"List elements in a layer (or all layers if omitted)\")\n  .option(\"--type <type>\", \"Filter by element type\")\n  .option(\"--json\", \"Output as JSON\")\n  .option(\"--model <path>\", \"Path to model root (contains model/manifest.yaml)\")\n  .addHelpText(\n    \"after\",\n    `\nExamples:\n  $ dr list\n  $ dr list api\n  $ dr list business --type businessservice\n  $ dr list api --json\n  $ dr list --json`\n  )\n  .action((layer, options) => {\n    return listCommand(layer, { ...options, json: options.json ?? program.opts().json });\n  });\n\nprogram\n  .command(\"search <query>\")\n  .description(\"Search for elements by name or ID\")\n  .option(\"--layer <layer>\", \"Limit search to specific layer\")\n  .option(\"--type <type>\", \"Filter by element type\")\n  .option(\n    \"--source-file <path>\",\n    \"Find elements referencing a source file (takes precedence over pattern matching)\"\n  )\n  .option(\"--json\", \"Output as JSON\")\n  .addHelpText(\n    \"after\",\n    `\nExamples:\n  $ dr search customer\n  $ dr search \"order processing\" --layer business\n  $ dr search create-* --type endpoint\n  $ dr search \"\" --source-file src/api/customer.ts`\n  )\n  .action((query, options) => {\n    return searchCommand(query, { ...options, json: options.json ?? program.opts().json });\n  });\n\nprogram\n  .command(\"validate\")\n  .description(\"Validate the architecture model\")\n  .option(\"--layers <layers...>\", \"Specific layers to validate\")\n  .option(\"--strict\", \"Treat warnings as errors\")\n  .option(\"--verbose\", \"Show detailed validation output with relationship breakdown\")\n  .option(\"--quiet\", \"Show minimal output\")\n  .option(\"--output <path>\", \"Export validation report to file (JSON or Markdown)\")\n  .option(\"--model <path>\", \"Path to model root (contains model/manifest.yaml)\")\n  .option(\"--orphans\", \"Show only orphaned elements grouped by layer with relationship suggestions\")\n  .option(\"--all\", \"Run all validations (default behavior)\")\n  .option(\"--markdown\", \"Validate markdown structure\")\n  .option(\"--schemas\", \"Validate JSON schemas\")\n  .option(\"--schema\", \"Validate JSON schemas (alias for --schemas)\")\n  .option(\"--relationships\", \"Validate relationships\")\n  .option(\"--structure\", \"Validate documentation structure\")\n  .option(\"--naming\", \"Validate naming conventions\")\n  .option(\"--references\", \"Validate cross-layer references\")\n  .option(\"--scope <scope>\", \"Validation scope: 'local' (default) or 'composed' for cross-model validation\")\n  .option(\"--model-path <mapping...>\", \"Override filesystem path for external model (format: model-name=/path/to/project-root, can be repeated)\")\n  .addHelpText(\n    \"after\",\n    `\nExamples:\n  $ dr validate\n  $ dr validate --all --strict\n  $ dr validate --verbose\n  $ dr validate --quiet\n  $ dr validate --output report.json\n  $ dr validate --output report.md\n  $ dr validate --schemas\n  $ dr validate --relationships\n  $ dr validate --layers business api\n  $ dr validate --orphans\n  $ dr validate --orphans --output orphans.json\n  $ dr validate --scope composed --model-path auth-service=/path/to/auth-service-repo\n  $ dr validate --scope composed --model-path auth-service=/path/to/auth-service-repo --model-path payment-service=/path/to/payment-repo\n\nNote: When using --model-path, pass the project root (where documentation-robotics/model/ is located).`\n  )\n  .action(validateCommand);\n\nprogram\n  .command(\"export <format>\")\n  .description(\"Export the architecture model to various formats\")\n  .option(\"--output <path>\", \"Output file path (default: print to stdout)\")\n  .option(\"--layers <layers...>\", \"Specific layers to export\")\n  .option(\"--model <path>\", \"Path to model root directory or manifest.yaml file\")\n  .option(\"--include-sources\", \"Include source file paths in PlantUML diagrams as notes\")\n  .addHelpText(\n    \"after\",\n    `\nSupported formats:\n  archimate    Export to ArchiMate XML (layers 1, 2, 5, 6)\n  openapi      Export to OpenAPI 3.0 specification (layer 7)\n  jsonschema   Export to JSON Schema (layer 8)\n  plantuml     Export to PlantUML diagram\n  graphml      Export to GraphML (graph visualization)\n  markdown     Export to Markdown documentation\n\nExamples:\n  $ dr export archimate --output model.xml\n  $ dr export openapi --layers api\n  $ dr export plantuml --include-sources --output diagram.puml\n  $ dr export markdown --output docs/architecture.md`\n  )\n  .action(async (format, options) => {\n    await exportCommand({\n      format,\n      output: options.output,\n      layers: options.layers,\n      model: options.model,\n      includeSources: options.includeSources,\n    });\n  });\n\nprogram\n  .command(\"import <format>\")\n  .description(\"Import architecture model from various formats\")\n  .option(\"--input <path>\", \"Input file path (required)\", undefined)\n  .option(\"--model <path>\", \"Path to model root directory or manifest.yaml file\")\n  .option(\n    \"--merge-strategy <strategy>\",\n    \"How to handle existing elements: add, update, skip (default: add)\"\n  )\n  .addHelpText(\n    \"after\",\n    `\nSupported formats:\n  archimate    Import from ArchiMate XML (layers 1, 2, 5, 6)\n  openapi      Import from OpenAPI 3.0 specification (layer 7)\n\nExamples:\n  $ dr import archimate --input model.xml\n  $ dr import openapi --input api.json --merge-strategy add\n  $ dr import archimate --input model.xml --model ./myproject`\n  )\n  .action(async (format, options) => {\n    if (!options.input) {\n      console.error(\"Error: --input path is required\");\n      process.exit(1);\n    }\n    await importCommand({\n      format,\n      input: options.input,\n      model: options.model,\n      mergeStrategy: options.mergeStrategy as \"add\" | \"update\" | \"skip\" | undefined,\n    });\n  });\n\nprogram\n  .command(\"info\")\n  .description(\"Show model information\")\n  .option(\"--layer <layer>\", \"Show specific layer details\")\n  .option(\"--verbose\", \"Show detailed breakdown by element type\")\n  .addHelpText(\n    \"after\",\n    `\nExamples:\n  $ dr info\n  $ dr info --layer business\n  $ dr info --layer api --verbose`\n  )\n  .action(infoCommand);\n\nprogram\n  .command(\"stats\")\n  .description(\"Display model statistics and health metrics\")\n  .option(\"--model <path>\", \"Path to the model directory\")\n  .option(\"--format <format>\", \"Output format: text (default), json, markdown, compact\")\n  .option(\"--output <path>\", \"Output file path (auto-detects format from extension)\")\n  .option(\"--compact\", \"Show compact one-line summary\")\n  .option(\"--verbose\", \"Show detailed information\")\n  .addHelpText(\n    \"after\",\n    `\nOutput formats:\n  text       Full formatted statistics (default)\n  json       JSON output for automation\n  markdown   Markdown report format\n  compact    Single-line summary\n\nExamples:\n  $ dr stats                           # Show full statistics\n  $ dr stats --compact                 # Show one-line summary\n  $ dr stats --format json             # Output as JSON\n  $ dr stats --output stats.md         # Save as markdown file\n  $ dr stats --output stats.json       # Save as JSON file\n  $ dr stats --verbose                 # Show detailed information`\n  )\n  .action((options) => statsCommand(options));\n\nprogram\n  .command(\"report\")\n  .description(\"Generate comprehensive architecture reports\")\n  .option(\"--model <path>\", \"Path to the model directory\")\n  .option(\"--type <type>\", \"Report type: comprehensive (default), statistics, relationships, data-model, quality\")\n  .option(\"--format <format>\", \"Output format: text (default), json, markdown\")\n  .option(\"--output <path>\", \"Output file path (auto-detects format from extension)\")\n  .option(\"--verbose\", \"Show detailed information\")\n  .option(\"--include-data-model\", \"Include data model analysis (default: true)\")\n  .option(\"--include-quality\", \"Include quality metrics (default: true)\")\n  .addHelpText(\n    \"after\",\n    `\nReport types:\n  comprehensive  Full report with statistics, relationships, and data model (default)\n  statistics     Statistics and quality metrics\n  relationships  Relationship analysis and classification\n  data-model     Layer 8 data model analysis\n  quality        Quality metrics and recommendations\n\nOutput formats:\n  text       Full formatted report (default)\n  json       JSON output for automation\n  markdown   Markdown report format\n\nExamples:\n  $ dr report                                      # Show comprehensive report\n  $ dr report --type relationships                 # Show relationship analysis\n  $ dr report --format json                        # Output as JSON\n  $ dr report --output report.md                   # Save as markdown file\n  $ dr report --type data-model --output dm.md     # Data model report as markdown\n  $ dr report --verbose                            # Show detailed information`\n  )\n  .action((options) => reportCommand(options));\n\n// Reports subcommands (managed layer report files)\nconst reportsGroup = program.command(\"reports\").description(\"Manage architecture layer reports\");\nreportsCommands(reportsGroup);\n\n// Audit command - Relationship analysis\nprogram\n  .command(\"audit [layer]\")\n  .description(\"Analyze relationship coverage, gaps, duplicates, and balance\")\n  .option(\"--type <type>\", \"Audit type: relationships (default), nodes, all\")\n  .option(\"--format <format>\", \"Output format: text (default), json, markdown\")\n  .option(\"--output <path>\", \"Output file path (auto-detects format from extension)\")\n  .option(\"--verbose\", \"Show detailed analysis\")\n  .option(\"--save-snapshot\", \"Save audit report as snapshot for differential analysis\")\n  .addHelpText(\n    \"after\",\n    `\nAudit types:\n  relationships  Relationship coverage, gaps, duplicates, balance (default)\n  nodes          Node type usage distribution across model layers\n  all            Both relationship and node audits\n\nOutput formats:\n  text       Full formatted audit report (default)\n  json       JSON output for automation\n  markdown   Markdown audit report format\n\nExamples:\n  $ dr audit                           # Full relationship audit of all layers\n  $ dr audit security                  # Audit security layer only\n  $ dr audit --type nodes              # Node type distribution audit\n  $ dr audit --type all                # Combined relationship + node audit\n  $ dr audit --format json             # Output as JSON\n  $ dr audit --output audit.md         # Save as markdown file\n  $ dr audit --verbose                 # Show detailed analysis\n  $ dr audit --save-snapshot           # Save snapshot for later comparison\n  $ dr audit api --output api-audit.json  # API layer audit as JSON`\n  )\n  .action((layer, options) =>\n    auditCommand({ ...options, layer, verbose: options.verbose ?? program.opts().verbose }));\n\n// Audit diff command - Compare snapshots\nprogram\n  .command(\"audit:diff\")\n  .description(\"Compare before/after audit snapshots\")\n  .option(\"--before <id>\", \"Before snapshot ID or timestamp\")\n  .option(\"--after <id>\", \"After snapshot ID or timestamp\")\n  .option(\"--format <format>\", \"Output format: text (default), json, markdown\")\n  .option(\"--output <path>\", \"Output file path\")\n  .option(\"--verbose\", \"Show detailed comparison\")\n  .addHelpText(\n    \"after\",\n    `\nExamples:\n  $ dr audit:diff                                  # Compare latest two snapshots\n  $ dr audit:diff --before 20260220-100000 --after 20260220-150000\n  $ dr audit:diff --format markdown --output diff.md\n  $ dr audit:diff --verbose                        # Show detailed changes`\n  )\n  .action((options) => auditDiffCommand(options));\n\n// Audit snapshots command - Manage snapshots\nprogram\n  .command(\"audit:snapshots <action>\")\n  .description(\"Manage audit snapshots (list, delete, clear)\")\n  .option(\"--id <id>\", \"Snapshot ID (for delete action)\")\n  .addHelpText(\n    \"after\",\n    `\nActions:\n  list     List all available snapshots\n  delete   Delete a specific snapshot (requires --id)\n  clear    Delete all snapshots\n\nExamples:\n  $ dr audit:snapshots list\n  $ dr audit:snapshots delete --id 20260220-100000\n  $ dr audit:snapshots clear`\n  )\n  .action((action, options) => auditSnapshotsCommand({ ...options, action }));\n\n// Repair command - Detect and recover data lost to fixed data-integrity bugs\nprogram\n  .command(\"repair:attribute-collision\")\n  .description(\n    'Find and best-effort-recover model data lost to a fixed bug where saveLayer() stripped \"source\"/\"x-source-reference\" attributes from every element, even when a node type\\'s schema declared one as a real (sometimes required) attribute'\n  )\n  .option(\"--apply\", \"Restore recoverable values found in changeset history (default: report only)\")\n  .option(\"--format <format>\", \"Output format: text (default), json\")\n  .option(\"--output <path>\", \"Write the report to a file instead of stdout\")\n  .addHelpText(\n    \"after\",\n    `\nThis repairs damage from a fixed bug in Model.saveLayer(): a hardcoded, type-blind \"internal\nfields\" blocklist unconditionally stripped any attribute literally named \"source\" or\n\"x-source-reference\" from every element's attributes before writing YAML, regardless of whether\nthe element's own schema declared it as a real domain attribute. 41 of 191 node schemas across 8\nlayers do (3 mark it required, meaning affected elements fail validation today).\n\nRecovery is best-effort: values can only be restored if they still exist in changeset history\n(committing a changeset does not delete it). Elements with no recoverable value are always\nreported, never fabricated \u2014 you'll need to re-supply those manually with\n\"dr update <id> --attributes '{...}'\".\n\nExamples:\n  $ dr repair:attribute-collision                    # Report only \u2014 no changes made\n  $ dr repair:attribute-collision --apply             # Restore every recoverable value\n  $ dr repair:attribute-collision --format json --output report.json`\n  )\n  .action((options) => repairAttributeCollisionCommand(options));\n\n// Relationship subcommands\nconst relationshipGroup = program.command(\"relationship\").description(\"Relationship operations\");\nrelationshipCommands(relationshipGroup, program);\n\n// Element subcommands\nconst elementGroup = program.command(\"element\").description(\"Element operations\");\nelementCommands(elementGroup, program);\n\n// Schema introspection subcommands\nschemaCommands(program);\n\n// Catalog subcommands (modern relationship catalog)\ncatalogCommands(program);\n\n// Documentation subcommands (schema-driven generation)\ndocsCommands(program);\n\n// Dependency analysis commands\nprogram\n  .command(\"trace <elementId>\")\n  .description(\"Trace dependencies for an element\")\n  .option(\n    \"--direction <dir>\",\n    \"Trace direction: up (dependencies), down (dependents), both (default)\"\n  )\n  .option(\"--depth <num>\", \"Maximum traversal depth\")\n  .option(\"--metrics\", \"Show graph and element metrics\")\n  .option(\"--model <path>\", \"Path to model root (contains model/manifest.yaml)\")\n  .addHelpText(\n    \"after\",\n    `\nExamples:\n  $ dr trace api-endpoint-create-customer\n  $ dr trace business-service-order --direction down --metrics\n  $ dr trace application-component-api --depth 3`\n  )\n  .action(async (elementId, options) => {\n    await traceCommand(elementId, {\n      direction: options.direction as \"up\" | \"down\" | \"both\" | undefined,\n      depth: options.depth ? parseInt(options.depth) : undefined,\n      showMetrics: options.metrics,\n      model: options.model,\n    });\n  });\n\nprogram\n  .command(\"visualize\")\n  .description(\"Launch visualization server with WebSocket support\")\n  .option(\"--port <num>\", \"Server port (default: 8080)\")\n  .option(\"--no-browser\", \"Do not auto-open browser\")\n  .option(\"--no-auth\", \"Disable authentication (enabled by default)\")\n  .option(\"--token <token>\", \"Custom auth token (auto-generated by default)\")\n  .option(\"--with-danger\", \"Enable dangerous mode for chat (skip permissions)\")\n  .option(\n    \"--with-changesets\",\n    \"Let chat stage model changes in a changeset (no commit, apply or delete)\"\n  )\n  .option(\n    \"--viewer-path <path>\",\n    \"Path to custom viewer build (e.g., ./dist/embedded/dr-viewer-bundle)\"\n  )\n  .addHelpText(\n    \"after\",\n    `\nExamples:\n  $ dr visualize\n  $ dr visualize --port 3000\n  $ dr visualize --no-browser\n  $ dr visualize --no-auth\n  $ dr visualize --token my-secret-token\n  $ dr visualize --with-danger\n  $ dr visualize --with-changesets\n  $ dr visualize --viewer-path ./dist/embedded/dr-viewer-bundle\n\nDefault mode (read-safe permissions) enables:\n  - Running 'dr' CLI commands to query the architecture model\n  - Reading the codebase\n  - Reading the documentation-robotics/ model folder\n  - Reading the .dr/ configuration folder\n  - One 'dr' command per shell call: a call that adds pipes, &&, ; or\n    redirects needs approval nobody can give in the chat, so it is denied\n\nChangeset mode (--with-changesets, Claude Code) adds to the read-safe mode:\n  - Creating, activating and inspecting changesets\n  - Staging new elements, element updates and new relationships (dr add,\n    dr update, dr relationship add) in the active changeset\n  - Never committing, applying, reverting or deleting: those stay with you.\n    Writes outside an active changeset are refused.\n\nDangerous mode (--with-danger) enables unrestricted access:\n  - Claude Code: --dangerously-skip-permissions (full tool access)\n  - GitHub Copilot: --allow-all-tools (full tool access)\n\nThe --viewer-path option allows loading a local build of the web UI:\n  - Point to a directory containing index.html and supporting files\n  - Useful for developing custom viewers or using bundled distributions`\n  )\n  .action(async (options) => {\n    const { visualizeCommand } = await import(\"./commands/visualize.js\");\n    await visualizeCommand({\n      port: options.port,\n      noBrowser: options.browser === false, // Commander sets 'browser' to false when --no-browser is used\n      noAuth: options.auth === false, // Commander sets 'auth' to false when --no-auth is used\n      token: options.token,\n      withDanger: options.withDanger,\n      withChangesets: options.withChangesets,\n      viewerPath: options.viewerPath,\n    });\n  });\n\nprogram\n  .command(\"mcp\")\n  .description(\"Start MCP server for AI assistant integration\")\n  .option(\n    \"--regenerate-key\",\n    \"Generate a new MCP API key, overwrite it at the configured storage path, and print it (does not start the server)\"\n  )\n  .option(\n    \"--transport <type>\",\n    \"Transport type: stdio or http (default: stdio)\",\n    \"stdio\"\n  )\n  .option(\n    \"--port <number>\",\n    \"Port for HTTP transport (default: 3100, only meaningful with --transport http)\",\n    \"3100\"\n  )\n  .option(\n    \"--host <address>\",\n    \"Host address for HTTP transport (default: 127.0.0.1, only meaningful with --transport http)\",\n    \"127.0.0.1\"\n  )\n  .addHelpText(\n    \"after\",\n    `\nExamples:\n\nStdio transport (default):\n  $ dr mcp\n\nHTTP transport:\n  $ dr mcp --transport http                    # HTTP on localhost:3100\n  $ dr mcp --transport http --port 8200        # HTTP on custom port\n  $ dr mcp --transport http --host 0.0.0.0 --port 3100  # Listen on all interfaces\n\nKey management:\n  $ dr mcp --regenerate-key                    # Generate new API key\n\nStdio Configuration:\nNo API key: the client starts the server as your own user. In Claude Code, install the\ndr plugin (claude plugin install dr@documentation-robotics); other clients use:\n\n  {\n    \"command\": \"dr\",\n    \"args\": [\"mcp\"]\n  }\n\nThe server serves the project the client has open (its MCP roots); DR_MCP_ROOT_PATH\npins it to one model instead.\n\nHTTP Configuration:\nHTTP clients authenticate with an API key, generated on first launch (stored at\n~/.dr-mcp-key unless you choose a path interactively) and printed to stderr on every\nlaunch. Include it as a Bearer token in the Authorization header:\n\n  {\n    \"url\": \"http://localhost:3100/mcp\",\n    \"headers\": {\n      \"Authorization\": \"Bearer <your-api-key>\"\n    }\n  }\n\nUse --regenerate-key to rotate the key (e.g. after a suspected leak) without\nmanually deleting the stored key file or config.`\n  )\n  .action(async (options) => {\n    const { mcpCommand } = await import(\"./commands/mcp.js\");\n    const transport = (options.transport as string).toLowerCase();\n    if (transport !== \"stdio\" && transport !== \"http\") {\n      throw new CLIError(`Invalid transport: ${transport}. Allowed values: stdio, http`, 1);\n    }\n    const port = parseInt(options.port as string, 10);\n    if (!Number.isFinite(port) || port < 1 || port > 65535) {\n      throw new CLIError(`Invalid port: ${options.port}. Must be a number between 1 and 65535`, 1);\n    }\n    await mcpCommand({\n      regenerateKey: options.regenerateKey,\n      transport: transport as \"stdio\" | \"http\",\n      port,\n      host: options.host as string,\n    });\n  });\n\n// AI Integration command\nprogram\n  .command(\"chat [client] [withDanger]\")\n  .description(\"Interactive chat with AI about the architecture model\")\n  .addHelpText(\n    \"after\",\n    `\nArguments:\n  client      Optional AI client to use: \"claude-code\" or \"github-copilot\"\n  withDanger  Enable dangerous mode: \"with-danger\"\n\nExamples:\n  $ dr chat                           # Auto-detect or use saved preference\n  $ dr chat claude-code               # Use Claude Code, save as preference\n  $ dr chat github-copilot            # Use GitHub Copilot, save as preference\n  $ dr chat with-danger               # Auto-detect with dangerous mode\n  $ dr chat claude-code with-danger   # Use Claude Code with dangerous mode\n  $ dr chat github-copilot with-danger # Use GitHub Copilot with dangerous mode\n\nDefault mode (read-safe permissions) enables:\n  - Running 'dr' CLI commands to query the architecture model\n  - Reading the codebase\n  - Reading the documentation-robotics/ model folder\n  - Reading the .dr/ configuration folder\n\nDangerous mode (--with-danger) enables unrestricted access:\n  - Claude Code: --dangerously-skip-permissions (full tool access)\n  - GitHub Copilot: --allow-all-tools (full tool access)\n\nThis launches an interactive chat interface where you can ask AI questions\nabout your architecture model. Supports Claude Code CLI and GitHub Copilot CLI.\n\nInstall instructions:\n  - Claude Code: https://claude.ai\n  - GitHub Copilot: gh extension install github/gh-copilot`\n  )\n  .action(async (client?: string, withDangerArg?: string) => {\n    // Parse arguments - handle both \"with-danger\" as first or second arg\n    let selectedClient: string | undefined;\n    let withDanger = false;\n\n    if (client === \"with-danger\") {\n      // Format: dr chat with-danger\n      withDanger = true;\n      selectedClient = undefined;\n    } else if (withDangerArg === \"with-danger\") {\n      // Format: dr chat <client> with-danger\n      withDanger = true;\n      selectedClient = client;\n    } else {\n      // Format: dr chat <client>\n      selectedClient = client;\n    }\n\n    await chatCommand(selectedClient, withDanger);\n  });\n\n// Advanced commands\nprogram\n  .command(\"version\")\n  .description(\"Show CLI and embedded spec version information\")\n  .addHelpText(\n    \"after\",\n    `\nExamples:\n  $ dr version`\n  )\n  .action(async () => {\n    await versionCommand();\n  });\n\nprogram\n  .command(\"upgrade\")\n  .description(\"Upgrade spec reference and migrate model to latest versions\")\n  .option(\"-y, --yes\", \"Automatically upgrade without prompting\")\n  .option(\"--dry-run\", \"Show what would be upgraded without making changes\")\n  .option(\"--force\", \"Force all upgrades regardless of current versions; skips migration validation\")\n  .addHelpText(\n    \"after\",\n    `\nExamples:\n  $ dr upgrade              # Scan, show plan, and prompt for upgrades\n  $ dr upgrade --dry-run    # Preview available upgrades\n  $ dr upgrade --yes        # Upgrade without prompting\n  $ dr upgrade --force      # Force all upgrades, ignoring version checks`\n  )\n  .action(async (options) => {\n    await upgradeCommand({\n      yes: options.yes,\n      dryRun: options.dryRun,\n      force: options.force,\n    });\n  });\n\nprogram\n  .command(\"conformance\")\n  .description(\"Check model conformance to layer specifications\")\n  .option(\"--layers <layers...>\", \"Specific layers to check\")\n  .option(\"--json\", \"Output as JSON\")\n  .option(\"--verbose\", \"Verbose output\")\n  .addHelpText(\n    \"after\",\n    `\nExamples:\n  $ dr conformance\n  $ dr conformance --layers business api application\n  $ dr conformance --json\n  $ dr conformance --verbose`\n  )\n  .action(async (options) => {\n    await conformanceCommand({\n      layers: options.layers,\n      json: options.json ?? program.opts().json,\n      verbose: options.verbose ?? program.opts().verbose,\n    });\n  });\n\n// Changeset subcommands\nchangesetCommands(program);\n\n// Farm subcommands\nfarmCommands(program);\n\n// Claude Code integration subcommands\nclaudeCommands(program);\n\n// GitHub Copilot integration subcommands\ncopilotCommands(program);\n\n// Analyzer integration subcommands\nanalyzerCommands(program);\n\n// Execute CLI with proper telemetry span wrapping\n// This creates a root span that all child spans will be linked to\n(async () => {\n  let exitCode = 0;\n  try {\n    if (isTelemetryEnabled) {\n      // Initialize telemetry before execution\n      await initTelemetry();\n\n      // Only install console interceptor for commands that need it\n      const commandName = process.argv[2] || \"unknown\";\n      if (CONSOLE_LOGGING_COMMANDS.has(commandName)) {\n        await installConsoleInterceptor();\n      }\n\n      const args = process.argv.slice(3).join(\" \");\n\n      // Wrap entire CLI execution in active span for proper context propagation\n      await startActiveSpan(\n        \"cli.execute\",\n        async (span) => {\n          // Attributes already set via options parameter - no duplicate setAttributes needed\n          try {\n            // Execute command - all child spans will now link to this root span\n            await program.parseAsync(process.argv);\n\n            // Set success status\n            span.setStatus({ code: 0 }); // SpanStatusCode.OK\n          } catch (error) {\n            // Record exception and set error status\n            // CommanderError with exitCode 0 is help text / unknown subcommand shown \u2014 not a real error\n            if (error instanceof CommanderError) {\n              if (error.exitCode === 0) {\n                span.setStatus({ code: 0 }); // SpanStatusCode.OK\n              } else {\n                span.recordException(error as Error);\n                span.setStatus({\n                  code: 2, // SpanStatusCode.ERROR\n                  message: error.message,\n                });\n              }\n            } else {\n              span.recordException(error as Error);\n              span.setStatus({\n                code: 2, // SpanStatusCode.ERROR\n                message: getErrorMessage(error),\n              });\n            }\n\n            // Print error message for CLIError instances\n            // Skip CommanderError \u2014 Commander already printed its own output (e.g. help text, unknown command)\n            const { CLIError } = await import(\"./utils/errors.js\");\n            const { isJson } = await import(\"./utils/globals.js\");\n            if (error instanceof CommanderError) {\n              // Commander handled its own output; nothing to print\n            } else if (error instanceof CLIError) {\n              // In JSON mode, handleError already output structured JSON; skip text formatting\n              if (!isJson()) {\n                console.error(error.format());\n              }\n            } else if (error instanceof Error) {\n              console.error(error.message);\n            } else {\n              console.error(String(error));\n            }\n\n            // Extract exit code from CLIError if available\n            exitCode = await extractExitCode(error);\n            // Don't throw - let telemetry shutdown complete\n          }\n        },\n        {\n          \"cli.command\": commandName,\n          \"cli.args\": args,\n          \"cli.cwd\": process.cwd(),\n          \"cli.version\": cliVersion,\n        }\n      );\n\n      // Shutdown telemetry after execution completes\n      await shutdownTelemetry();\n\n      // Exit with exit code (keepAlive disabled in exporters prevents hanging)\n      process.exit(exitCode);\n    } else {\n      // No telemetry - just parse normally with error handling\n      try {\n        await program.parseAsync(process.argv);\n      } catch (error) {\n        // Extract exit code from CLIError if available\n        // Skip CommanderError \u2014 Commander already printed its own output (e.g. help text, unknown command)\n        const { CLIError } = await import(\"./utils/errors.js\");\n        const { isJson } = await import(\"./utils/globals.js\");\n        if (error instanceof CommanderError) {\n          // Commander handled its own output; nothing to print\n        } else if (error instanceof CLIError) {\n          // In JSON mode, handleError already output structured JSON; skip text formatting\n          if (!isJson()) {\n            console.error(error.format());\n          }\n        } else {\n          // Unexpected exceptions need to be printed\n          if (error instanceof Error) {\n            console.error(error.message);\n          } else {\n            console.error(String(error));\n          }\n        }\n        const exitCodeFromError = await extractExitCode(error);\n        process.exit(exitCodeFromError);\n      }\n    }\n  } catch (error) {\n    // Error during telemetry init or shutdown\n    if (!isTelemetryEnabled) {\n      // No telemetry - exit immediately with error\n      process.exit(1);\n    }\n    // Telemetry enabled - try to shutdown before exit\n    await shutdownTelemetry();\n    process.exit(1);\n  }\n})();\n"],
+  "mappings": "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",
   "names": ["CLIError"]
 }

package/dist/coding-agents/default-permissions.js

@@ -27,7 +27,33 @@ const PERMISSIONS_DEFINITION = [
   }
 ], DEFAULT_READ_SAFE_PERMISSIONS = Object.freeze(PERMISSIONS_DEFINITION.map((p) => Object.freeze({ ...p })));
 function formatForClaudeCode() {
-  return DEFAULT_READ_SAFE_PERMISSIONS.map((p) => p.scope ? `${p.name}(${p.scope})` : p.name).join(",");
+  return DEFAULT_READ_SAFE_PERMISSIONS.flatMap((p) => p.scope ? p.name === "Bash" ? bashCommands(p.scope).map((command) => `Bash(${command}:*)`) : [`${p.name}(${p.scope})`] : [p.name]).join(",");
+}
+const CHANGESET_WRITE_COMMANDS = Object.freeze([
+  "dr changeset create",
+  "dr changeset activate",
+  "dr changeset deactivate",
+  "dr changeset status",
+  "dr changeset list",
+  "dr changeset show",
+  "dr changeset staged",
+  "dr changeset stage",
+  "dr changeset unstage",
+  "dr changeset preview",
+  "dr changeset diff",
+  "dr add",
+  "dr update",
+  "dr relationship add",
+  "dr relationship list",
+  "dr relationship show",
+  "dr schema"
+]);
+import { CHANGESET_ONLY_ENV } from "../core/changeset-only-guard.js";
+function formatForClaudeCodeWithChangesets() {
+  return [formatForClaudeCode(), ...CHANGESET_WRITE_COMMANDS.map((command) => `Bash(${command}:*)`)].join(",");
+}
+function bashCommands(scope) {
+  return scope.split("|").map((command) => command.trim()).filter((command) => command.length > 0);
 }
 function formatForCopilot() {
   return formatForClaudeCode();
@@ -112,9 +138,13 @@ function applyCopilotPermissions(cmd, variant, copilotCommand, withDanger, onTel
 }
 validateReadSafeConstraints();
 export {
+  CHANGESET_ONLY_ENV,
+  CHANGESET_WRITE_COMMANDS,
   DEFAULT_READ_SAFE_PERMISSIONS,
   applyCopilotPermissions,
+  bashCommands,
   formatForClaudeCode,
+  formatForClaudeCodeWithChangesets,
   formatForCopilot,
   validatePermissions,
   validateReadSafeConstraints