@documentation-robotics/cli 0.1.13 → 0.3.0

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

@@ -36,14 +36,14 @@ const LAYER_TEMPLATES = [
       {
         sourcePattern: "role",
         destinationPattern: "process",
-        predicate: "performs",
-        description: "Roles perform processes"
+        predicate: "assigned-to",
+        description: "Roles are assigned to the processes they perform"
       },
       {
-        sourcePattern: "service",
-        destinationPattern: "process",
+        sourcePattern: "process",
+        destinationPattern: "service",
         predicate: "realizes",
-        description: "Services realize processes"
+        description: "Processes realize services"
       }
     ]
   },
@@ -53,15 +53,15 @@ const LAYER_TEMPLATES = [
     patterns: [
       {
         sourcePattern: "feature",
-        destinationPattern: "capability",
+        destinationPattern: "softwarecapability",
         predicate: "realizes",
-        description: "Features realize capabilities"
+        description: "Features realize software capabilities"
       },
       {
-        sourcePattern: "capability",
+        sourcePattern: "softwarecapability",
         destinationPattern: "milestone",
         predicate: "scheduled-for",
-        description: "Capabilities are scheduled for milestones"
+        description: "Software capabilities are scheduled for milestones"
       },
       {
         sourcePattern: "feature",
@@ -96,8 +96,8 @@ const LAYER_TEMPLATES = [
       {
         sourcePattern: "role",
         destinationPattern: "permission",
-        predicate: "authorizes",
-        description: "Roles authorize permissions"
+        predicate: "aggregates",
+        description: "Roles aggregate the permissions they grant"
       },
       {
         sourcePattern: "policy",
@@ -148,10 +148,10 @@ const LAYER_TEMPLATES = [
         description: "Artifacts realize components"
       },
       {
-        sourcePattern: "infrastructure",
-        destinationPattern: "node",
-        predicate: "hosts",
-        description: "Infrastructure hosts nodes"
+        sourcePattern: "node",
+        destinationPattern: "systemsoftware",
+        predicate: "composes",
+        description: "Nodes compose the system software they run"
       }
     ]
   },
@@ -160,46 +160,46 @@ const LAYER_TEMPLATES = [
     standard: "OpenAPI 3.0",
     patterns: [
       {
-        sourcePattern: "operation",
-        destinationPattern: "schema",
-        predicate: "references",
-        description: "Operations reference schemas"
+        sourcePattern: "pathitem",
+        destinationPattern: "operation",
+        predicate: "composes",
+        description: "Path items compose their operations"
       },
       {
-        sourcePattern: "securityscheme",
-        destinationPattern: "operation",
-        predicate: "serves",
-        description: "Security schemes serve operations"
+        sourcePattern: "operation",
+        destinationPattern: "responses",
+        predicate: "composes",
+        description: "Operations compose their responses map"
       },
       {
-        sourcePattern: "response",
+        sourcePattern: "mediatype",
         destinationPattern: "schema",
-        predicate: "returns",
-        description: "Responses return schemas"
+        predicate: "references",
+        description: "Media types reference their schema by $ref"
       }
     ]
   },
   {
     layer: "ux",
-    standard: "React/Component",
+    standard: "HTML 5.3 / component libraries",
     patterns: [
       {
-        sourcePattern: "component",
-        destinationPattern: "component",
-        predicate: "renders",
-        description: "Components render other components"
+        sourcePattern: "view",
+        destinationPattern: "componentinstance",
+        predicate: "composes",
+        description: "Views compose the component instances placed in them"
       },
       {
-        sourcePattern: "component",
-        destinationPattern: "entity",
-        predicate: "binds-to",
-        description: "Components bind to entities"
+        sourcePattern: "componentinstance",
+        destinationPattern: "librarycomponent",
+        predicate: "realizes",
+        description: "Instances realize the library component they place"
       },
       {
-        sourcePattern: "form",
-        destinationPattern: "schema",
-        predicate: "validates",
-        description: "Forms validate against schemas"
+        sourcePattern: "view",
+        destinationPattern: "dataconfig",
+        predicate: "binds-to",
+        description: "Views bind to their data configuration"
       }
     ]
   },
@@ -301,25 +301,25 @@ const LAYER_TEMPLATES = [
   },
   {
     layer: "testing",
-    standard: "Testing best practices",
+    standard: "IEEE 829-2008 test documentation",
     patterns: [
       {
-        sourcePattern: "testcase",
-        destinationPattern: "requirement",
-        predicate: "verifies",
-        description: "Test cases verify requirements"
+        sourcePattern: "testcasesketch",
+        destinationPattern: "coveragerequirement",
+        predicate: "validates",
+        description: "Test case sketches validate the coverage requirement they exercise"
       },
       {
-        sourcePattern: "testdata",
-        destinationPattern: "testcase",
-        predicate: "supports",
-        description: "Test data supports test cases"
+        sourcePattern: "testcoveragetarget",
+        destinationPattern: "coveragerequirement",
+        predicate: "composes",
+        description: "Coverage targets compose their coverage requirements"
       },
       {
-        sourcePattern: "testsuite",
-        destinationPattern: "testcase",
-        predicate: "contains",
-        description: "Test suites contain test cases"
+        sourcePattern: "testcoveragemodel",
+        destinationPattern: "testcoveragetarget",
+        predicate: "composes",
+        description: "Coverage models compose their coverage targets"
       }
     ]
   }

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

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 import { Command, CommanderError } from "commander";
 import { setGlobalOptions } from "./utils/globals.js";
+import { installAnsiSuppressor } from "./utils/ansi-suppressor.js";
 import { initCommand } from "./commands/init.js";
 import { addCommand } from "./commands/add.js";
 import { updateCommand } from "./commands/update.js";
@@ -22,6 +23,7 @@ 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 { farmCommands } from "./commands/farm.js";
 import { claudeCommands } from "./commands/claude.js";
 import { copilotCommands } from "./commands/copilot.js";
 import { analyzerCommands } from "./commands/analyzer.js";
@@ -35,11 +37,13 @@ import { auditSnapshotsCommand } from "./commands/audit-snapshots.js";
 import { repairAttributeCollisionCommand } from "./commands/repair.js";
 import { initTelemetry, startActiveSpan, shutdownTelemetry } from "./telemetry/index.js";
 import { installConsoleInterceptor } from "./telemetry/console-interceptor.js";
-import { getErrorMessage } from "./utils/errors.js";
+import { getErrorMessage, CLIError } from "./utils/errors.js";
+import { getCliVersion } from "./utils/spec-version.js";
 const isTelemetryEnabled = !1, CONSOLE_LOGGING_COMMANDS = /* @__PURE__ */ new Set(["chat", "validate", "import", "export"]);
+process.stdout.isTTY || (process.env.FORCE_COLOR = "0", process.env.NO_COLOR = "1"), installAnsiSuppressor();
 async function extractExitCode(error) {
-  const { CLIError } = await import("./utils/errors.js");
-  if (error instanceof CLIError || error instanceof CommanderError)
+  const { CLIError: CLIError2 } = await import("./utils/errors.js");
+  if (error instanceof CLIError2 || error instanceof CommanderError)
     return error.exitCode;
   if (error && typeof error == "object" && "exitCode" in error) {
     const errorObj = error;
@@ -48,26 +52,28 @@ async function extractExitCode(error) {
   }
   return 1;
 }
-const cliVersion = "0.1.13", 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 cliVersion = getCliVersion(), 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").option("--json", "Output as JSON (supported on mutating and query commands)").option("--codebase-path <path>", "Override codebase root path (default: resolved from manifest or project root)").exitOverride().showSuggestionAfterError().hook("preAction", async (thisCommand) => {
   const options = thisCommand.opts();
   setGlobalOptions({
     verbose: options.verbose,
-    debug: options.debug
+    debug: options.debug,
+    json: options.json,
+    codebasePath: options.codebasePath
   });
 }), 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 claudetoreum
   $ dr init "Enterprise Architecture" --author "Team A"
-  $ dr init --name "My Project" --description "13-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", `
+  $ dr init --name "My Project" --description "13-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("--model <path>", "Path to model root (contains model/manifest.yaml)").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").option("--verbose", "Show detailed output (can also use global -v flag)").addHelpText("after", `
 Examples:
   $ 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: 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").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
@@ -76,13 +82,14 @@ 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 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", `
+  $ 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
   $ 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", `
+  $ dr delete api-endpoint-old-endpoint --cascade --dry-run`).action((id, options) => deleteCommand(id, { ...options, verbose: options.verbose ?? program.opts().verbose })), 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 (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", `
@@ -91,12 +98,12 @@ Examples:
   $ dr list api
   $ 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", `
+  $ dr list --json`).action((layer, options) => listCommand(layer, { ...options, json: options.json ?? program.opts().json })), 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
-  $ 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", `
+  $ dr search "" --source-file src/api/customer.ts`).action((query, options) => searchCommand(query, { ...options, json: options.json ?? program.opts().json })), 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").option("--scope <scope>", "Validation scope: 'local' (default) or 'composed' for cross-model validation").option("--model-path <mapping...>", "Override filesystem path for external model (format: model-name=/path/to/project-root, can be repeated)").addHelpText("after", `
 Examples:
   $ dr validate
   $ dr validate --all --strict
@@ -108,7 +115,11 @@ Examples:
   $ dr validate --relationships
   $ 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", `
+  $ dr validate --orphans --output orphans.json
+  $ dr validate --scope composed --model-path auth-service=/path/to/auth-service-repo
+  $ dr validate --scope composed --model-path auth-service=/path/to/auth-service-repo --model-path payment-service=/path/to/payment-repo
+
+Note: When using --model-path, pass the project root (where documentation-robotics/model/ is located).`).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, 5, 6)
   openapi      Export to OpenAPI 3.0 specification (layer 7)
@@ -233,9 +244,9 @@ Examples:
   $ dr repair:attribute-collision --apply             # Restore every recoverable value
   $ dr repair:attribute-collision --format json --output report.json`).action((options) => repairAttributeCollisionCommand(options));
 const relationshipGroup = program.command("relationship").description("Relationship operations");
-relationshipCommands(relationshipGroup);
+relationshipCommands(relationshipGroup, program);
 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", `
+elementCommands(elementGroup, program), 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
@@ -246,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
@@ -254,11 +265,25 @@ 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
 
-The --with-danger flag enables dangerous mode for chat functionality:
-  - Claude Code: --dangerously-skip-permissions
-  - GitHub Copilot: --allow-all-tools
+Default mode (read-safe permissions) enables:
+  - Running 'dr' CLI commands to query the architecture model
+  - Reading the codebase
+  - Reading the documentation-robotics/ model folder
+  - Reading the .dr/ configuration folder
+
+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)
+  - GitHub Copilot: --allow-all-tools (full tool access)
 
 The --viewer-path option allows loading a local build of the web UI:
   - Point to a directory containing index.html and supporting files
@@ -272,8 +297,61 @@ 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", `
+Examples:
+
+Stdio transport (default):
+  $ dr mcp
+
+HTTP transport:
+  $ dr mcp --transport http                    # HTTP on localhost:3100
+  $ dr mcp --transport http --port 8200        # HTTP on custom port
+  $ dr mcp --transport http --host 0.0.0.0 --port 3100  # Listen on all interfaces
+
+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:
+
+  {
+    "command": "dr",
+    "args": ["mcp"],
+    "env": { "DR_MCP_API_KEY": "<your-api-key>" }
+  }
+
+HTTP Configuration:
+For HTTP transport, include the API key as a Bearer token in the Authorization header:
+
+  {
+    "url": "http://localhost:3100/mcp",
+    "headers": {
+      "Authorization": "Bearer <your-api-key>"
+    }
+  }
+
+Use --regenerate-key to rotate the key (e.g. after a suspected leak) without
+manually deleting the stored key file or config.`).action(async (options) => {
+  const { mcpCommand } = await import("./commands/mcp.js"), transport = options.transport.toLowerCase();
+  if (transport !== "stdio" && transport !== "http")
+    throw new CLIError(`Invalid transport: ${transport}. Allowed values: stdio, http`, 1);
+  const port = parseInt(options.port, 10);
+  if (!Number.isFinite(port) || port < 1 || port > 65535)
+    throw new CLIError(`Invalid port: ${options.port}. Must be a number between 1 and 65535`, 1);
+  await mcpCommand({
+    regenerateKey: options.regenerateKey,
+    transport,
+    port,
+    host: options.host
+  });
 }), 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"
@@ -287,9 +365,15 @@ Examples:
   $ 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
+Default mode (read-safe permissions) enables:
+  - Running 'dr' CLI commands to query the architecture model
+  - Reading the codebase
+  - Reading the documentation-robotics/ model folder
+  - Reading the .dr/ configuration folder
+
+Dangerous mode (--with-danger) enables unrestricted access:
+  - Claude Code: --dangerously-skip-permissions (full tool access)
+  - GitHub Copilot: --allow-all-tools (full tool access)
 
 This launches an interactive chat interface where you can ask AI questions
 about your architecture model. Supports Claude Code CLI and GitHub Copilot CLI.
@@ -322,10 +406,10 @@ Examples:
   $ dr conformance --verbose`).action(async (options) => {
   await conformanceCommand({
     layers: options.layers,
-    json: options.json,
+    json: options.json ?? program.opts().json,
     verbose: options.verbose ?? program.opts().verbose
   });
-}), changesetCommands(program), claudeCommands(program), copilotCommands(program), analyzerCommands(program), (async () => {
+}), changesetCommands(program), farmCommands(program), claudeCommands(program), copilotCommands(program), analyzerCommands(program), (async () => {
   let exitCode = 0;
   try {
     if (isTelemetryEnabled) {
@@ -346,8 +430,8 @@ Examples:
             // SpanStatusCode.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);
+          const { CLIError: CLIError2 } = await import("./utils/errors.js"), { isJson } = await import("./utils/globals.js");
+          error instanceof CommanderError || (error instanceof CLIError2 ? isJson() || console.error(error.format()) : error instanceof Error ? console.error(error.message) : console.error(String(error))), exitCode = await extractExitCode(error);
         }
       }, {
         "cli.command": commandName,
@@ -359,8 +443,8 @@ Examples:
       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 { CLIError: CLIError2 } = await import("./utils/errors.js"), { isJson } = await import("./utils/globals.js");
+        error instanceof CommanderError || (error instanceof CLIError2 ? isJson() || console.error(error.format()) : error instanceof Error ? console.error(error.message) : console.error(String(error)));
         const exitCodeFromError = await extractExitCode(error);
         process.exit(exitCodeFromError);
       }