@documentation-robotics/cli 0.1.0 → 0.1.5

package/dist/cli.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { Command } from "commander";
+import { Command, CommanderError } from "commander";
 import { setGlobalOptions } from "./utils/globals.js";
 import { initCommand } from "./commands/init.js";
 import { addCommand } from "./commands/add.js";
@@ -10,77 +10,104 @@ import { listCommand } from "./commands/list.js";
 import { searchCommand } from "./commands/search.js";
 import { validateCommand } from "./commands/validate.js";
 import { infoCommand } from "./commands/info.js";
-import { elementCommands } from "./commands/element.js";
 import { relationshipCommands } from "./commands/relationship.js";
+import { elementCommands } from "./commands/element.js";
+import { schemaCommands } from "./commands/schema.js";
+import { catalogCommands } from "./commands/catalog.js";
+import { docsCommands } from "./commands/docs.js";
 import { traceCommand } from "./commands/trace.js";
-import { projectCommand, projectAllCommand } from "./commands/project.js";
 import { exportCommand } from "./commands/export.js";
+import { importCommand } from "./commands/import.js";
 import { chatCommand } from "./commands/chat.js";
 import { upgradeCommand } from "./commands/upgrade.js";
 import { conformanceCommand } from "./commands/conformance.js";
 import { changesetCommands } from "./commands/changeset.js";
+import { claudeCommands } from "./commands/claude.js";
+import { copilotCommands } from "./commands/copilot.js";
+import { analyzerCommands } from "./commands/analyzer.js";
 import { versionCommand } from "./commands/version.js";
+import { statsCommand } from "./commands/stats.js";
+import { reportCommand } from "./commands/report.js";
+import { reportsCommands } from "./commands/reports.js";
+import { auditCommand } from "./commands/audit.js";
+import { auditDiffCommand } from "./commands/audit-diff.js";
+import { auditSnapshotsCommand } from "./commands/audit-snapshots.js";
 import { initTelemetry, startActiveSpan, shutdownTelemetry } from "./telemetry/index.js";
 import { installConsoleInterceptor } from "./telemetry/console-interceptor.js";
-import { readJSON, fileExists } from "./utils/file-io.js";
-const isTelemetryEnabled = !1;
-async function getCliVersion() {
-  const possiblePaths = [
-    `${process.cwd()}/package.json`,
-    `${import.meta.url.replace("file://", "").split("/src/")[0]}/package.json`
-  ];
-  for (const path of possiblePaths)
-    if (await fileExists(path))
-      try {
-        return (await readJSON(path)).version;
-      } catch {
-        continue;
-      }
-  return "0.1.0";
-}
-const cliVersion = await getCliVersion(), program = new Command();
-if (process.argv.includes("--version") || process.argv.includes("-V")) {
-  const { versionCommand: versionCommand2 } = await import("./commands/version.js");
-  await versionCommand2(), process.exit(0);
+import { getErrorMessage } from "./utils/errors.js";
+const isTelemetryEnabled = !1, CONSOLE_LOGGING_COMMANDS = /* @__PURE__ */ new Set(["chat", "validate", "import", "export"]);
+async function extractExitCode(error) {
+  const { CLIError } = await import("./utils/errors.js");
+  if (error instanceof CLIError || error instanceof CommanderError)
+    return error.exitCode;
+  if (error && typeof error == "object" && "exitCode" in error) {
+    const errorObj = error;
+    if (typeof errorObj.exitCode == "number" && (errorObj.name === "CLIError" || errorObj.message))
+      return process.argv.includes("--debug") && console.warn("[DEBUG] Using duck-typed error object as fallback - this may indicate a module loading issue"), errorObj.exitCode;
+  }
+  return 1;
 }
-program.name("dr").description("Documentation Robotics CLI - Architecture Model Management").option("-v, --verbose", "Enable verbose output").option("--debug", "Enable debug mode").hook("preAction", async (thisCommand) => {
+const cliVersion = "0.1.5", program = new Command();
+(process.argv.includes("--version") || process.argv.includes("-V")) && (process.argv = ["node", "dr", "version"]), program.name("dr").description("Documentation Robotics CLI - Architecture Model Management").option("-v, --verbose", "Enable verbose output").option("--debug", "Enable debug mode").exitOverride().showSuggestionAfterError().hook("preAction", async (thisCommand) => {
   const options = thisCommand.opts();
   setGlobalOptions({
     verbose: options.verbose,
     debug: options.debug
   });
-}), program.command("init").description("Initialize a new architecture model").option("--name <name>", "Model name").option("--author <author>", "Model author").option("--description <desc>", "Model description").addHelpText("after", `
+}), program.command("init [name]").description("Initialize a new architecture model").option("--name <name>", "Model name (overrides positional argument)").option("--author <author>", "Model author").option("--description <desc>", "Model description").addHelpText("after", `
 Examples:
   $ dr init
-  $ dr init --name "Enterprise Architecture" --author "Team A"
-  $ dr init --description "12-layer federated model"`).action(initCommand), program.command("add <layer> <type> <id>").description("Add an element to a layer").option("--name <name>", "Element name (defaults to ID)").option("--description <desc>", "Element description").option("--properties <json>", "Element properties as JSON object").addHelpText("after", `
+  $ dr init claudetoreum
+  $ dr init "Enterprise Architecture" --author "Team A"
+  $ dr init --name "My Project" --description "12-layer federated model"`).action((name, options) => initCommand({ ...options, name: options.name || name })), program.command("add <layer> <type> <name>").description("Add an element to a layer").option("--name <name>", "Element display name (defaults to the name argument)").option("--description <desc>", "Element description").option("--attributes <json>", "Element type-specific attributes as JSON object").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").addHelpText("after", `
 Examples:
-  $ dr add business business-service customer-mgmt --name "Customer Management"
-  $ dr add api endpoint create-customer --properties '{"method":"POST","path":"/customers"}'
-  $ dr add application component customer-api --description "REST API for customer operations"`).action(addCommand), program.command("update <id>").description("Update an element").option("--name <name>", "New element name").option("--description <desc>", "New description").option("--properties <json>", "Updated properties (JSON)").addHelpText("after", `
+  $ dr add business service "Customer Management"
+  $ dr add api operation "Create Customer" --attributes '{"operationId":"createCustomer","summary":"Create a customer","tags":"customers"}'
+  $ 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(addCommand), program.command("update <id>").description("Update an element").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").addHelpText("after", `
+Note: Changes are written immediately to model files.
+To track changes for review, activate a changeset first:
+  $ dr changeset activate my-changeset
+
 Examples:
   $ dr update api-endpoint-create-customer --name "Create Customer (v2)"
-  $ dr update business-service-order --description "Updated description"`).action(updateCommand), program.command("delete <id>").description("Delete an element").option("--force", "Skip confirmation prompt").addHelpText("after", `
+  $ dr update business-service-order --description "Updated description"
+  $ dr update application-applicationfunction-process-orders --type applicationservice
+  $ dr update security-policy-auth --source-file "src/auth/policy.ts" --source-provenance "extracted"`).action(updateCommand), program.command("delete <id>").description("Delete an element").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").addHelpText("after", `
 Examples:
   $ dr delete api-endpoint-old-endpoint
-  $ dr delete api-endpoint-old-endpoint --force`).action(deleteCommand), program.command("show <id>").description("Display element details").option("--model <path>", "Path to model root (contains model/manifest.yaml)").addHelpText("after", `
+  $ dr delete api-endpoint-old-endpoint --force
+  $ dr delete api-endpoint-old-endpoint --cascade
+  $ dr delete api-endpoint-old-endpoint --dry-run
+  $ dr delete api-endpoint-old-endpoint --cascade --dry-run`).action(deleteCommand), program.command("show <id>").description("Display element details").option("--model <path>", "Path to model root (contains model/manifest.yaml)").addHelpText("after", `
 Examples:
   $ dr show api-endpoint-create-customer
-  $ dr show business-service-order-mgmt`).action((id, options) => showCommand(id, options)), program.command("list <layer>").description("List elements in a layer").option("--type <type>", "Filter by element type").option("--json", "Output as JSON").option("--model <path>", "Path to model root (contains model/manifest.yaml)").addHelpText("after", `
+  $ dr show business-service-order-mgmt`).action((id, options) => showCommand(id, options)), program.command("list [layer]").description("List elements in a layer (or all layers if omitted)").option("--type <type>", "Filter by element type").option("--json", "Output as JSON").option("--model <path>", "Path to model root (contains model/manifest.yaml)").addHelpText("after", `
 Examples:
+  $ dr list
   $ dr list api
-  $ dr list business --type business-service
-  $ dr list api --json`).action(listCommand), program.command("search <query>").description("Search for elements by name or ID").option("--layer <layer>", "Limit search to specific layer").option("--type <type>", "Filter by element type").option("--json", "Output as JSON").addHelpText("after", `
+  $ dr list business --type businessservice
+  $ dr list api --json
+  $ dr list --json`).action(listCommand), program.command("search <query>").description("Search for elements by name or ID").option("--layer <layer>", "Limit search to specific layer").option("--type <type>", "Filter by element type").option("--source-file <path>", "Find elements referencing a source file (takes precedence over pattern matching)").option("--json", "Output as JSON").addHelpText("after", `
 Examples:
   $ dr search customer
   $ dr search "order processing" --layer business
-  $ dr search create-* --type endpoint`).action(searchCommand), program.command("validate").description("Validate the architecture model").option("--layers <layers...>", "Specific layers to validate").option("--strict", "Treat warnings as errors").option("--model <path>", "Path to model root (contains model/manifest.yaml)").option("--all", "Run all validations (default behavior)").option("--markdown", "Validate markdown structure").option("--schemas", "Validate JSON schemas").option("--schema", "Validate JSON schemas (alias for --schemas)").option("--relationships", "Validate relationships").option("--structure", "Validate documentation structure").option("--naming", "Validate naming conventions").option("--references", "Validate cross-layer references").addHelpText("after", `
+  $ dr search create-* --type endpoint
+  $ dr search "" --source-file src/api/customer.ts`).action(searchCommand), program.command("validate").description("Validate the architecture model").option("--layers <layers...>", "Specific layers to validate").option("--strict", "Treat warnings as errors").option("--verbose", "Show detailed validation output with relationship breakdown").option("--quiet", "Show minimal output").option("--output <path>", "Export validation report to file (JSON or Markdown)").option("--model <path>", "Path to model root (contains model/manifest.yaml)").option("--orphans", "Show only orphaned elements grouped by layer with relationship suggestions").option("--all", "Run all validations (default behavior)").option("--markdown", "Validate markdown structure").option("--schemas", "Validate JSON schemas").option("--schema", "Validate JSON schemas (alias for --schemas)").option("--relationships", "Validate relationships").option("--structure", "Validate documentation structure").option("--naming", "Validate naming conventions").option("--references", "Validate cross-layer references").addHelpText("after", `
 Examples:
   $ dr validate
   $ dr validate --all --strict
+  $ dr validate --verbose
+  $ dr validate --quiet
+  $ dr validate --output report.json
+  $ dr validate --output report.md
   $ dr validate --schemas
   $ dr validate --relationships
-  $ dr validate --layers business api`).action(validateCommand), program.command("export <format>").description("Export the architecture model to various formats").option("--output <path>", "Output file path (default: print to stdout)").option("--layers <layers...>", "Specific layers to export").option("--model <path>", "Path to model root directory or manifest.yaml file").addHelpText("after", `
+  $ dr validate --layers business api
+  $ dr validate --orphans
+  $ dr validate --orphans --output orphans.json`).action(validateCommand), program.command("export <format>").description("Export the architecture model to various formats").option("--output <path>", "Output file path (default: print to stdout)").option("--layers <layers...>", "Specific layers to export").option("--model <path>", "Path to model root directory or manifest.yaml file").option("--include-sources", "Include source file paths in PlantUML diagrams as notes").addHelpText("after", `
 Supported formats:
   archimate    Export to ArchiMate XML (layers 1, 2, 4, 5)
   openapi      Export to OpenAPI 3.0 specification (layer 6)
@@ -92,21 +119,107 @@ Supported formats:
 Examples:
   $ dr export archimate --output model.xml
   $ dr export openapi --layers api
+  $ dr export plantuml --include-sources --output diagram.puml
   $ dr export markdown --output docs/architecture.md`).action(async (format, options) => {
   await exportCommand({
     format,
     output: options.output,
     layers: options.layers,
-    model: options.model
+    model: options.model,
+    includeSources: options.includeSources
+  });
+}), program.command("import <format>").description("Import architecture model from various formats").option("--input <path>", "Input file path (required)", void 0).option("--model <path>", "Path to model root directory or manifest.yaml file").option("--merge-strategy <strategy>", "How to handle existing elements: add, update, skip (default: add)").addHelpText("after", `
+Supported formats:
+  archimate    Import from ArchiMate XML (layers 1, 2, 4, 5)
+  openapi      Import from OpenAPI 3.0 specification (layer 6)
+
+Examples:
+  $ dr import archimate --input model.xml
+  $ dr import openapi --input api.json --merge-strategy add
+  $ dr import archimate --input model.xml --model ./myproject`).action(async (format, options) => {
+  options.input || (console.error("Error: --input path is required"), process.exit(1)), await importCommand({
+    format,
+    input: options.input,
+    model: options.model,
+    mergeStrategy: options.mergeStrategy
   });
-}), program.command("info").description("Show model information").option("--layer <layer>", "Show specific layer details").addHelpText("after", `
+}), program.command("info").description("Show model information").option("--layer <layer>", "Show specific layer details").option("--verbose", "Show detailed breakdown by element type").addHelpText("after", `
 Examples:
   $ dr info
-  $ dr info --layer business`).action(infoCommand);
-const elementGroup = program.command("element").description("Element operations");
-elementCommands(elementGroup);
+  $ dr info --layer business
+  $ dr info --layer api --verbose`).action(infoCommand), program.command("stats").description("Display model statistics and health metrics").option("--model <path>", "Path to the model directory").option("--format <format>", "Output format: text (default), json, markdown, compact").option("--output <path>", "Output file path (auto-detects format from extension)").option("--compact", "Show compact one-line summary").option("--verbose", "Show detailed information").addHelpText("after", `
+Output formats:
+  text       Full formatted statistics (default)
+  json       JSON output for automation
+  markdown   Markdown report format
+  compact    Single-line summary
+
+Examples:
+  $ dr stats                           # Show full statistics
+  $ dr stats --compact                 # Show one-line summary
+  $ dr stats --format json             # Output as JSON
+  $ dr stats --output stats.md         # Save as markdown file
+  $ dr stats --output stats.json       # Save as JSON file
+  $ dr stats --verbose                 # Show detailed information`).action((options) => statsCommand(options)), program.command("report").description("Generate comprehensive architecture reports").option("--model <path>", "Path to the model directory").option("--type <type>", "Report type: comprehensive (default), statistics, relationships, data-model, quality").option("--format <format>", "Output format: text (default), json, markdown").option("--output <path>", "Output file path (auto-detects format from extension)").option("--verbose", "Show detailed information").option("--include-data-model", "Include data model analysis (default: true)").option("--include-quality", "Include quality metrics (default: true)").addHelpText("after", `
+Report types:
+  comprehensive  Full report with statistics, relationships, and data model (default)
+  statistics     Statistics and quality metrics
+  relationships  Relationship analysis and classification
+  data-model     Layer 7 data model analysis
+  quality        Quality metrics and recommendations
+
+Output formats:
+  text       Full formatted report (default)
+  json       JSON output for automation
+  markdown   Markdown report format
+
+Examples:
+  $ dr report                                      # Show comprehensive report
+  $ dr report --type relationships                 # Show relationship analysis
+  $ dr report --format json                        # Output as JSON
+  $ dr report --output report.md                   # Save as markdown file
+  $ dr report --type data-model --output dm.md     # Data model report as markdown
+  $ dr report --verbose                            # Show detailed information`).action((options) => reportCommand(options));
+const reportsGroup = program.command("reports").description("Manage architecture layer reports");
+reportsCommands(reportsGroup), program.command("audit [layer]").description("Analyze relationship coverage, gaps, duplicates, and balance").option("--type <type>", "Audit type: relationships (default), nodes, all").option("--format <format>", "Output format: text (default), json, markdown").option("--output <path>", "Output file path (auto-detects format from extension)").option("--verbose", "Show detailed analysis").option("--save-snapshot", "Save audit report as snapshot for differential analysis").addHelpText("after", `
+Audit types:
+  relationships  Relationship coverage, gaps, duplicates, balance (default)
+  nodes          Node type usage distribution across model layers
+  all            Both relationship and node audits
+
+Output formats:
+  text       Full formatted audit report (default)
+  json       JSON output for automation
+  markdown   Markdown audit report format
+
+Examples:
+  $ dr audit                           # Full relationship audit of all layers
+  $ dr audit security                  # Audit security layer only
+  $ dr audit --type nodes              # Node type distribution audit
+  $ dr audit --type all                # Combined relationship + node audit
+  $ dr audit --format json             # Output as JSON
+  $ dr audit --output audit.md         # Save as markdown file
+  $ dr audit --verbose                 # Show detailed analysis
+  $ dr audit --save-snapshot           # Save snapshot for later comparison
+  $ dr audit api --output api-audit.json  # API layer audit as JSON`).action((layer, options) => auditCommand({ ...options, layer, verbose: options.verbose ?? program.opts().verbose })), program.command("audit:diff").description("Compare before/after audit snapshots").option("--before <id>", "Before snapshot ID or timestamp").option("--after <id>", "After snapshot ID or timestamp").option("--format <format>", "Output format: text (default), json, markdown").option("--output <path>", "Output file path").option("--verbose", "Show detailed comparison").addHelpText("after", `
+Examples:
+  $ dr audit:diff                                  # Compare latest two snapshots
+  $ dr audit:diff --before 20260220-100000 --after 20260220-150000
+  $ dr audit:diff --format markdown --output diff.md
+  $ dr audit:diff --verbose                        # Show detailed changes`).action((options) => auditDiffCommand(options)), program.command("audit:snapshots <action>").description("Manage audit snapshots (list, delete, clear)").option("--id <id>", "Snapshot ID (for delete action)").addHelpText("after", `
+Actions:
+  list     List all available snapshots
+  delete   Delete a specific snapshot (requires --id)
+  clear    Delete all snapshots
+
+Examples:
+  $ dr audit:snapshots list
+  $ dr audit:snapshots delete --id 20260220-100000
+  $ dr audit:snapshots clear`).action((action, options) => auditSnapshotsCommand({ ...options, action }));
 const relationshipGroup = program.command("relationship").description("Relationship operations");
-relationshipCommands(relationshipGroup), program.command("trace <elementId>").description("Trace dependencies for an element").option("--direction <dir>", "Trace direction: up (dependencies), down (dependents), both (default)").option("--depth <num>", "Maximum traversal depth").option("--metrics", "Show graph and element metrics").option("--model <path>", "Path to model root (contains model/manifest.yaml)").addHelpText("after", `
+relationshipCommands(relationshipGroup);
+const elementGroup = program.command("element").description("Element operations");
+elementCommands(elementGroup), schemaCommands(program), catalogCommands(program), docsCommands(program), program.command("trace <elementId>").description("Trace dependencies for an element").option("--direction <dir>", "Trace direction: up (dependencies), down (dependents), both (default)").option("--depth <num>", "Maximum traversal depth").option("--metrics", "Show graph and element metrics").option("--model <path>", "Path to model root (contains model/manifest.yaml)").addHelpText("after", `
 Examples:
   $ dr trace api-endpoint-create-customer
   $ dr trace business-service-order --direction down --metrics
@@ -117,35 +230,23 @@ Examples:
     showMetrics: options.metrics,
     model: options.model
   });
-}), program.command("project <elementId> <targetLayers>").description("Project an element to other layers using projection rules").option("--rule <name>", "Specific projection rule to use").option("--dry-run", "Show what would be created without saving").option("--force", "Overwrite existing elements").option("--model <path>", "Path to model directory").addHelpText("after", `
-Examples:
-  $ dr project application.service.api-service "api,data-model"
-  $ dr project business.process.order-fulfillment application --dry-run
-  $ dr project api.endpoint.create-order data-model --rule api-to-data`).action(async (elementId, targetLayers, options) => {
-  await projectCommand(elementId, targetLayers, {
-    rule: options.rule,
-    dryRun: options.dryRun,
-    force: options.force,
-    model: options.model
-  });
-}), program.command("project-all").description("Project all applicable elements based on rules").option("--from <layer>", "Source layer filter").option("--to <layer>", "Target layer filter").option("--dry-run", "Show what would be created without saving").option("--model <path>", "Path to model directory").addHelpText("after", `
-Examples:
-  $ dr project-all --from application --to api
-  $ dr project-all --to data-model --dry-run
-  $ dr project-all`).action(async (options) => {
-  await projectAllCommand({
-    from: options.from,
-    to: options.to,
-    dryRun: options.dryRun,
-    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)").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("--viewer-path <path>", "Path to custom viewer build (e.g., ./dist/embedded/dr-viewer-bundle)").addHelpText("after", `
 Examples:
   $ dr visualize
   $ dr visualize --port 3000
   $ dr visualize --no-browser
   $ dr visualize --no-auth
-  $ dr visualize --token my-secret-token`).action(async (options) => {
+  $ dr visualize --token my-secret-token
+  $ dr visualize --with-danger
+  $ dr visualize --viewer-path ./dist/embedded/dr-viewer-bundle
+
+The --with-danger flag enables dangerous mode for chat functionality:
+  - Claude Code: --dangerously-skip-permissions
+  - GitHub Copilot: --allow-all-tools
+
+The --viewer-path option allows loading a local build of the web UI:
+  - Point to a directory containing index.html and supporting files
+  - Useful for developing custom viewers or using bundled distributions`).action(async (options) => {
   const { visualizeCommand } = await import("./commands/visualize.js");
   await visualizeCommand({
     port: options.port,
@@ -153,25 +254,45 @@ Examples:
     // Commander sets 'browser' to false when --no-browser is used
     noAuth: options.auth === !1,
     // Commander sets 'auth' to false when --no-auth is used
-    token: options.token
+    token: options.token,
+    withDanger: options.withDanger,
+    viewerPath: options.viewerPath
   });
-}), program.command("chat").description("Interactive chat with Claude about the architecture model").addHelpText("after", `
+}), program.command("chat [client] [withDanger]").description("Interactive chat with AI about the architecture model").addHelpText("after", `
+Arguments:
+  client      Optional AI client to use: "claude-code" or "github-copilot"
+  withDanger  Enable dangerous mode: "with-danger"
+
 Examples:
-  $ dr chat
+  $ dr chat                           # Auto-detect or use saved preference
+  $ dr chat claude-code               # Use Claude Code, save as preference
+  $ dr chat github-copilot            # Use GitHub Copilot, save as preference
+  $ dr chat with-danger               # Auto-detect with dangerous mode
+  $ dr chat claude-code with-danger   # Use Claude Code with dangerous mode
+  $ dr chat github-copilot with-danger # Use GitHub Copilot with dangerous mode
+
+Dangerous mode enables:
+  - Claude Code: --dangerously-skip-permissions
+  - GitHub Copilot: --allow-all-tools
 
-This launches an interactive chat interface where you can ask Claude questions
-about your architecture model. Requires Claude Code CLI to be installed and authenticated.`).action(async () => {
-  await chatCommand();
+This launches an interactive chat interface where you can ask AI questions
+about your architecture model. Supports Claude Code CLI and GitHub Copilot CLI.
+
+Install instructions:
+  - Claude Code: https://claude.ai
+  - GitHub Copilot: gh extension install github/gh-copilot`).action(async (client, withDangerArg) => {
+  let selectedClient, withDanger = !1;
+  client === "with-danger" ? (withDanger = !0, selectedClient = void 0) : (withDangerArg === "with-danger" && (withDanger = !0), selectedClient = client), await chatCommand(selectedClient, withDanger);
 }), program.command("version").description("Show CLI and embedded spec version information").addHelpText("after", `
 Examples:
   $ dr version`).action(async () => {
   await versionCommand();
-}), program.command("upgrade").description("Upgrade spec reference and migrate model to latest versions").option("-y, --yes", "Automatically upgrade without prompting").option("--dry-run", "Show what would be upgraded without making changes").option("--force", "Skip validation during migration").addHelpText("after", `
+}), program.command("upgrade").description("Upgrade spec reference and migrate model to latest versions").option("-y, --yes", "Automatically upgrade without prompting").option("--dry-run", "Show what would be upgraded without making changes").option("--force", "Force all upgrades regardless of current versions; skips migration validation").addHelpText("after", `
 Examples:
   $ dr upgrade              # Scan, show plan, and prompt for upgrades
   $ dr upgrade --dry-run    # Preview available upgrades
   $ dr upgrade --yes        # Upgrade without prompting
-  $ dr upgrade --force      # Skip validation during migration`).action(async (options) => {
+  $ dr upgrade --force      # Force all upgrades, ignoring version checks`).action(async (options) => {
   await upgradeCommand({
     yes: options.yes,
     dryRun: options.dryRun,
@@ -186,39 +307,49 @@ Examples:
   await conformanceCommand({
     layers: options.layers,
     json: options.json,
-    verbose: options.verbose
+    verbose: options.verbose ?? program.opts().verbose
   });
-}), changesetCommands(program), (async () => {
+}), changesetCommands(program), claudeCommands(program), copilotCommands(program), analyzerCommands(program), (async () => {
+  let exitCode = 0;
   try {
     if (isTelemetryEnabled) {
-      await initTelemetry(), await installConsoleInterceptor();
-      const commandName = process.argv[2] || "unknown", args = process.argv.slice(3).join(" ");
+      await initTelemetry();
+      const commandName = process.argv[2] || "unknown";
+      CONSOLE_LOGGING_COMMANDS.has(commandName) && await installConsoleInterceptor();
+      const args = process.argv.slice(3).join(" ");
       await startActiveSpan("cli.execute", async (span) => {
-        span.setAttributes({
-          "cli.command": commandName,
-          "cli.args": args,
-          "cli.cwd": process.cwd(),
-          "cli.version": cliVersion
-        });
         try {
           await program.parseAsync(process.argv), span.setStatus({ code: 0 });
         } catch (error) {
-          throw span.recordException(error), span.setStatus({
+          error instanceof CommanderError ? error.exitCode === 0 ? span.setStatus({ code: 0 }) : (span.recordException(error), span.setStatus({
+            code: 2,
+            // SpanStatusCode.ERROR
+            message: error.message
+          })) : (span.recordException(error), span.setStatus({
             code: 2,
             // SpanStatusCode.ERROR
-            message: error instanceof Error ? error.message : String(error)
-          }), error;
+            message: getErrorMessage(error)
+          }));
+          const { CLIError } = await import("./utils/errors.js");
+          error instanceof CommanderError || (error instanceof CLIError ? console.error(error.format()) : error instanceof Error ? console.error(error.message) : console.error(String(error))), exitCode = await extractExitCode(error);
         }
       }, {
         "cli.command": commandName,
         "cli.args": args,
         "cli.cwd": process.cwd(),
         "cli.version": cliVersion
-      }), await shutdownTelemetry();
+      }), await shutdownTelemetry(), process.exit(exitCode);
     } else
-      await program.parseAsync(process.argv);
-  } catch (error) {
-    throw error;
+      try {
+        await program.parseAsync(process.argv);
+      } catch (error) {
+        const { CLIError } = await import("./utils/errors.js");
+        error instanceof CommanderError || (error instanceof CLIError ? console.error(error.format()) : error instanceof Error ? console.error(error.message) : console.error(String(error)));
+        const exitCodeFromError = await extractExitCode(error);
+        process.exit(exitCodeFromError);
+      }
+  } catch {
+    isTelemetryEnabled || process.exit(1), await shutdownTelemetry(), process.exit(1);
   }
 })();
 //# sourceMappingURL=cli.js.map