@documentation-robotics/cli 0.1.0 → 0.1.5

package/dist/commands/schema.js

@@ -0,0 +1,135 @@
+import ansis from "ansis";
+import { CLIError, ErrorCategory, handleError } from "../utils/errors.js";
+import { getAllLayerIds, getLayerById } from "../generated/layer-registry.js";
+import { getNodeType, getNodeTypesForLayer, isValidSpecNodeId } from "../generated/node-types.js";
+import { getValidRelationships } from "../generated/relationship-index.js";
+async function schemaLayersCommand() {
+  try {
+    console.log(ansis.bold(`
+Architecture Layers:
+`));
+    for (const layerId of getAllLayerIds()) {
+      const layer = getLayerById(layerId);
+      if (!layer)
+        continue;
+      const nodeTypes = getNodeTypesForLayer(layerId);
+      console.log(ansis.cyan(`${layer.number}. ${layer.name}`) + ansis.gray(` (${layerId})`)), console.log(`   ${layer.description}`), console.log(`   Node types: ${ansis.yellow(nodeTypes.length.toString())}`), layer.inspiredBy && console.log(`   Standard: ${layer.inspiredBy.standard} ${layer.inspiredBy.version}`), console.log();
+    }
+  } catch (error) {
+    handleError(error);
+  }
+}
+async function schemaTypesCommand(layerId) {
+  try {
+    const layer = getLayerById(layerId);
+    if (!layer) {
+      const validLayers = getAllLayerIds().join(", ");
+      throw new CLIError(`Unknown layer: ${layerId}`, ErrorCategory.USER, [`Valid layers: ${validLayers}`]);
+    }
+    const nodeTypes = getNodeTypesForLayer(layerId);
+    console.log(ansis.bold(`
+Node Types for ${layer.name}:
+`));
+    for (const nodeType of nodeTypes)
+      console.log(ansis.cyan(`  ${nodeType.type}`) + ansis.gray(` (${nodeType.specNodeId})`)), console.log(`    ${nodeType.title}`), nodeType.requiredAttributes && nodeType.requiredAttributes.length > 0 && console.log(`    Required: ${ansis.yellow(nodeType.requiredAttributes.join(", "))}`), nodeType.optionalAttributes && nodeType.optionalAttributes.length > 0 && console.log(`    Optional: ${ansis.gray(nodeType.optionalAttributes.join(", "))}`), console.log();
+  } catch (error) {
+    handleError(error);
+  }
+}
+async function schemaNodeCommand(specNodeId) {
+  try {
+    if (!isValidSpecNodeId(specNodeId))
+      throw new CLIError(`Invalid spec node ID format: ${specNodeId}`, ErrorCategory.USER, ["Expected format: {layer}.{type} (e.g., motivation.goal, api.endpoint)"]);
+    const nodeType = getNodeType(specNodeId);
+    if (!nodeType)
+      throw new CLIError(`Unknown node type: ${specNodeId}`, ErrorCategory.USER, ["Use `dr schema types <layer>` to list valid types"]);
+    if (console.log(ansis.bold(`
+${nodeType.title}
+`)), console.log(`Spec Node ID: ${ansis.cyan(nodeType.specNodeId)}`), console.log(`Layer: ${nodeType.layer}`), console.log(`Type: ${nodeType.type}`), console.log(), nodeType.requiredAttributes && nodeType.requiredAttributes.length > 0) {
+      console.log(ansis.yellow("Required Attributes:"));
+      for (const attr of nodeType.requiredAttributes) {
+        const constraint = nodeType.attributeConstraints?.[attr];
+        console.log(`  - ${attr}: ${formatAttributeConstraint(constraint)}`);
+      }
+      console.log();
+    }
+    if (nodeType.optionalAttributes && nodeType.optionalAttributes.length > 0) {
+      console.log(ansis.gray("Optional Attributes:"));
+      for (const attr of nodeType.optionalAttributes) {
+        const constraint = nodeType.attributeConstraints?.[attr];
+        console.log(`  - ${attr}: ${formatAttributeConstraint(constraint)}`);
+      }
+      console.log();
+    }
+  } catch (error) {
+    handleError(error);
+  }
+}
+async function schemaRelationshipCommand(sourceType, predicate) {
+  try {
+    if (!isValidSpecNodeId(sourceType)) {
+      const hints = ["Expected format: {layer}.{type} (e.g., motivation.goal, api.endpoint)"], matches = [];
+      for (const layerId of getAllLayerIds())
+        for (const nodeType of getNodeTypesForLayer(layerId))
+          nodeType.type === sourceType.toLowerCase() && matches.push(nodeType.specNodeId);
+      throw matches.length === 1 ? hints.push(`Did you mean: ${matches[0]}?`) : matches.length > 1 && hints.push(`Did you mean one of: ${matches.join(", ")}?`), new CLIError(`Invalid spec node ID format: ${sourceType}`, ErrorCategory.USER, hints);
+    }
+    const relationships = predicate ? getValidRelationships(sourceType, predicate) : getValidRelationships(sourceType);
+    if (relationships.length === 0) {
+      const msg = predicate ? `No relationships found for ${sourceType} --[${predicate}]-->` : `No relationships found for ${sourceType}`;
+      console.log(msg);
+      return;
+    }
+    console.log(ansis.bold(`
+Valid Relationships for ${sourceType}:
+`));
+    const byPredicate = /* @__PURE__ */ new Map();
+    for (const rel of relationships) {
+      byPredicate.has(rel.predicate) || byPredicate.set(rel.predicate, []);
+      const predicateRels = byPredicate.get(rel.predicate);
+      predicateRels && predicateRels.push(rel);
+    }
+    for (const [pred, rels] of byPredicate) {
+      console.log(ansis.cyan(`  --[${pred}]-->`));
+      for (const rel of rels) {
+        const strength = formatStrength(rel.strength), cardinality = ansis.gray(`(${rel.cardinality})`);
+        console.log(`    ${rel.destinationSpecNodeId} ${strength} ${cardinality}`);
+      }
+      console.log();
+    }
+  } catch (error) {
+    handleError(error);
+  }
+}
+function formatAttributeConstraint(constraint) {
+  if (!constraint)
+    return "any";
+  if (typeof constraint == "string")
+    return constraint;
+  const c = constraint;
+  if (c.type) {
+    let result = String(c.type);
+    return c.enum && Array.isArray(c.enum) && (result += ` [${c.enum.join(" | ")}]`), c.pattern && (result += ` (pattern: ${c.pattern})`), result;
+  }
+  return "object";
+}
+function formatStrength(strength) {
+  return {
+    critical: (s) => ansis.red(s),
+    high: (s) => ansis.yellow(s),
+    medium: (s) => ansis.blue(s),
+    low: (s) => ansis.gray(s)
+  }[strength]?.(strength) || strength;
+}
+function schemaCommands(program) {
+  const schemaCmd = program.command("schema").description("Inspect schema metadata (layers, types, relationships)");
+  schemaCmd.command("layers").description("List all layers with node type counts").action(schemaLayersCommand), schemaCmd.command("types <layer>").description("List valid node types for a layer").action(schemaTypesCommand), schemaCmd.command("node <spec_node_id>").description("Show detailed schema for a node type").action(schemaNodeCommand), schemaCmd.command("relationship <source_type> [predicate]").description("Show valid relationships for a node type").action(schemaRelationshipCommand);
+}
+export {
+  schemaCommands,
+  schemaLayersCommand,
+  schemaNodeCommand,
+  schemaRelationshipCommand,
+  schemaTypesCommand
+};
+//# sourceMappingURL=schema.js.map

package/dist/commands/schema.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/commands/schema.ts"],
+  "sourcesContent": ["/**\n * Schema introspection commands for viewing layer and type metadata\n * Provides detailed schema information directly from generated registries\n */\n\nimport ansis from \"ansis\";\nimport { CLIError, ErrorCategory, handleError } from \"../utils/errors.js\";\nimport {\n  getAllLayerIds,\n  getLayerById,\n} from \"../generated/layer-registry.js\";\nimport {\n  getNodeType,\n  getNodeTypesForLayer,\n  isValidSpecNodeId,\n} from \"../generated/node-types.js\";\nimport {\n  getValidRelationships,\n  type RelationshipSpec,\n} from \"../generated/relationship-index.js\";\nimport { Command } from \"commander\";\n\n/**\n * dr schema layers - List all layers with node type counts\n */\nexport async function schemaLayersCommand(): Promise<void> {\n  try {\n    console.log(ansis.bold(\"\\nArchitecture Layers:\\n\"));\n\n    for (const layerId of getAllLayerIds()) {\n      const layer = getLayerById(layerId);\n      if (!layer) continue;\n\n      const nodeTypes = getNodeTypesForLayer(layerId);\n\n      console.log(\n        ansis.cyan(`${layer.number}. ${layer.name}`) +\n          ansis.gray(` (${layerId})`)\n      );\n      console.log(`   ${layer.description}`);\n      console.log(\n        `   Node types: ${ansis.yellow(nodeTypes.length.toString())}`\n      );\n\n      if (layer.inspiredBy) {\n        console.log(\n          `   Standard: ${layer.inspiredBy.standard} ${layer.inspiredBy.version}`\n        );\n      }\n\n      console.log();\n    }\n  } catch (error) {\n    handleError(error);\n  }\n}\n\n/**\n * dr schema types <layer> - List valid types for a layer\n */\nexport async function schemaTypesCommand(layerId: string): Promise<void> {\n  try {\n    const layer = getLayerById(layerId);\n\n    if (!layer) {\n      const validLayers = getAllLayerIds().join(\", \");\n      throw new CLIError(\n        `Unknown layer: ${layerId}`,\n        ErrorCategory.USER,\n        [`Valid layers: ${validLayers}`]\n      );\n    }\n\n    const nodeTypes = getNodeTypesForLayer(layerId);\n\n    console.log(ansis.bold(`\\nNode Types for ${layer.name}:\\n`));\n\n    for (const nodeType of nodeTypes) {\n      console.log(\n        ansis.cyan(`  ${nodeType.type}`) +\n          ansis.gray(` (${nodeType.specNodeId})`)\n      );\n      console.log(`    ${nodeType.title}`);\n\n      if (\n        nodeType.requiredAttributes &&\n        nodeType.requiredAttributes.length > 0\n      ) {\n        console.log(\n          `    Required: ${ansis.yellow(nodeType.requiredAttributes.join(\", \"))}`\n        );\n      }\n\n      if (\n        nodeType.optionalAttributes &&\n        nodeType.optionalAttributes.length > 0\n      ) {\n        console.log(\n          `    Optional: ${ansis.gray(nodeType.optionalAttributes.join(\", \"))}`\n        );\n      }\n\n      console.log();\n    }\n  } catch (error) {\n    handleError(error);\n  }\n}\n\n/**\n * dr schema node <spec_node_id> - Show node schema details\n */\nexport async function schemaNodeCommand(specNodeId: string): Promise<void> {\n  try {\n    if (!isValidSpecNodeId(specNodeId)) {\n      throw new CLIError(\n        `Invalid spec node ID format: ${specNodeId}`,\n        ErrorCategory.USER,\n        [\"Expected format: {layer}.{type} (e.g., motivation.goal, api.endpoint)\"]\n      );\n    }\n\n    const nodeType = getNodeType(specNodeId);\n\n    if (!nodeType) {\n      throw new CLIError(\n        `Unknown node type: ${specNodeId}`,\n        ErrorCategory.USER,\n        [\"Use `dr schema types <layer>` to list valid types\"]\n      );\n    }\n\n    console.log(ansis.bold(`\\n${nodeType.title}\\n`));\n    console.log(`Spec Node ID: ${ansis.cyan(nodeType.specNodeId)}`);\n    console.log(`Layer: ${nodeType.layer}`);\n    console.log(`Type: ${nodeType.type}`);\n    console.log();\n\n    if (\n      nodeType.requiredAttributes &&\n      nodeType.requiredAttributes.length > 0\n    ) {\n      console.log(ansis.yellow(\"Required Attributes:\"));\n      for (const attr of nodeType.requiredAttributes) {\n        const constraint = nodeType.attributeConstraints?.[attr];\n        console.log(`  - ${attr}: ${formatAttributeConstraint(constraint)}`);\n      }\n      console.log();\n    }\n\n    if (\n      nodeType.optionalAttributes &&\n      nodeType.optionalAttributes.length > 0\n    ) {\n      console.log(ansis.gray(\"Optional Attributes:\"));\n      for (const attr of nodeType.optionalAttributes) {\n        const constraint = nodeType.attributeConstraints?.[attr];\n        console.log(`  - ${attr}: ${formatAttributeConstraint(constraint)}`);\n      }\n      console.log();\n    }\n  } catch (error) {\n    handleError(error);\n  }\n}\n\n/**\n * dr schema relationship <source_type> [predicate] - Show valid relationships\n */\nexport async function schemaRelationshipCommand(\n  sourceType: string,\n  predicate?: string\n): Promise<void> {\n  try {\n    if (!isValidSpecNodeId(sourceType)) {\n      const hints = [\"Expected format: {layer}.{type} (e.g., motivation.goal, api.endpoint)\"];\n\n      const matches: string[] = [];\n      for (const layerId of getAllLayerIds()) {\n        for (const nodeType of getNodeTypesForLayer(layerId)) {\n          if (nodeType.type === sourceType.toLowerCase()) {\n            matches.push(nodeType.specNodeId);\n          }\n        }\n      }\n      if (matches.length === 1) {\n        hints.push(`Did you mean: ${matches[0]}?`);\n      } else if (matches.length > 1) {\n        hints.push(`Did you mean one of: ${matches.join(\", \")}?`);\n      }\n\n      throw new CLIError(\n        `Invalid spec node ID format: ${sourceType}`,\n        ErrorCategory.USER,\n        hints\n      );\n    }\n\n    const relationships = predicate\n      ? getValidRelationships(sourceType, predicate)\n      : getValidRelationships(sourceType);\n\n    if (relationships.length === 0) {\n      const msg = predicate\n        ? `No relationships found for ${sourceType} --[${predicate}]-->`\n        : `No relationships found for ${sourceType}`;\n      console.log(msg);\n      return;\n    }\n\n    console.log(\n      ansis.bold(`\\nValid Relationships for ${sourceType}:\\n`)\n    );\n\n    // Group by predicate\n    const byPredicate = new Map<string, RelationshipSpec[]>();\n    for (const rel of relationships) {\n      if (!byPredicate.has(rel.predicate)) {\n        byPredicate.set(rel.predicate, []);\n      }\n      const predicateRels = byPredicate.get(rel.predicate);\n      if (predicateRels) {\n        predicateRels.push(rel);\n      }\n    }\n\n    for (const [pred, rels] of byPredicate) {\n      console.log(ansis.cyan(`  --[${pred}]-->`));\n\n      for (const rel of rels) {\n        const strength = formatStrength(rel.strength);\n        const cardinality = ansis.gray(`(${rel.cardinality})`);\n        console.log(\n          `    ${rel.destinationSpecNodeId} ${strength} ${cardinality}`\n        );\n      }\n\n      console.log();\n    }\n  } catch (error) {\n    handleError(error);\n  }\n}\n\n/**\n * Represents a constraint on an attribute\n */\ninterface AttributeConstraint {\n  type?: string;\n  enum?: unknown[];\n  pattern?: string;\n  [key: string]: unknown;\n}\n\n/**\n * Format attribute constraint for display\n */\nfunction formatAttributeConstraint(constraint: unknown): string {\n  if (!constraint) return \"any\";\n\n  if (typeof constraint === \"string\") {\n    return constraint;\n  }\n\n  const c = constraint as AttributeConstraint;\n\n  if (c.type) {\n    let result = String(c.type);\n\n    if (c.enum && Array.isArray(c.enum)) {\n      result += ` [${c.enum.join(\" | \")}]`;\n    }\n\n    if (c.pattern) {\n      result += ` (pattern: ${c.pattern})`;\n    }\n\n    return result;\n  }\n\n  return \"object\";\n}\n\n/**\n * Format relationship strength with color\n */\nfunction formatStrength(strength: string): string {\n  const colors: Record<string, (s: string) => string> = {\n    critical: (s: string) => ansis.red(s),\n    high: (s: string) => ansis.yellow(s),\n    medium: (s: string) => ansis.blue(s),\n    low: (s: string) => ansis.gray(s),\n  };\n\n  return colors[strength]?.(strength) || strength;\n}\n\n/**\n * Register schema commands with commander\n */\nexport function schemaCommands(program: Command): void {\n  const schemaCmd = program\n    .command(\"schema\")\n    .description(\"Inspect schema metadata (layers, types, relationships)\");\n\n  schemaCmd\n    .command(\"layers\")\n    .description(\"List all layers with node type counts\")\n    .action(schemaLayersCommand);\n\n  schemaCmd\n    .command(\"types <layer>\")\n    .description(\"List valid node types for a layer\")\n    .action(schemaTypesCommand);\n\n  schemaCmd\n    .command(\"node <spec_node_id>\")\n    .description(\"Show detailed schema for a node type\")\n    .action(schemaNodeCommand);\n\n  schemaCmd\n    .command(\"relationship <source_type> [predicate]\")\n    .description(\"Show valid relationships for a node type\")\n    .action(schemaRelationshipCommand);\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/commands/search.js

@@ -1,8 +1,22 @@
 import ansis from "ansis";
 import { Model } from "../core/model.js";
+import { getActiveSpan } from "../telemetry/index.js";
+import { getErrorMessage } from "../utils/errors.js";
+import { TABLE_COLUMN_WIDTHS, TABLE_SEPARATOR } from "../utils/table-formatting.js";
+function normalizePath(path) {
+  return path.replace(/^\.\//, "").replace(/\\/g, "/");
+}
+function matchesSourceFile(element, sourceFilePath) {
+  const sourceRef = element.getSourceReference();
+  if (!sourceRef)
+    return !1;
+  const normalizedQuery = normalizePath(sourceFilePath);
+  return (sourceRef.locations ?? []).some((loc) => normalizePath(loc.file) === normalizedQuery);
+}
 async function searchCommand(query, options) {
+  const span = getActiveSpan();
   try {
-    const model = await Model.load(), results = [], queryLower = query.toLowerCase();
+    const model = await Model.load(), results = [], queryLower = query.toLowerCase(), isSourceFileSearch = !!options.sourceFile;
     for (const layerName of model.getLayerNames()) {
       if (options.layer && layerName !== options.layer)
         continue;
@@ -11,34 +25,48 @@ async function searchCommand(query, options) {
         for (const element of layerObj.listElements()) {
           if (options.type && element.type !== options.type)
             continue;
-          const idMatch = element.id.toLowerCase().includes(queryLower), nameMatch = element.name.toLowerCase().includes(queryLower);
-          (idMatch || nameMatch) && results.push({
+          if (isSourceFileSearch) {
+            if (!matchesSourceFile(element, options.sourceFile))
+              continue;
+          } else {
+            const idMatch = (element.path || element.id).toLowerCase().includes(queryLower), nameMatch = element.name.toLowerCase().includes(queryLower);
+            if (!idMatch && !nameMatch)
+              continue;
+          }
+          let sourceFile, sourceSymbol;
+          const sourceRef = element.getSourceReference();
+          sourceRef && sourceRef.locations && sourceRef.locations.length > 0 && (sourceFile = sourceRef.locations[0].file, sourceSymbol = sourceRef.locations[0].symbol), results.push({
             layer: layerName,
-            id: element.id,
+            id: element.path || element.id,
             type: element.type,
             name: element.name,
-            description: element.description
+            description: element.description,
+            sourceFile,
+            sourceSymbol
           });
         }
     }
-    if (options.json) {
+    if (span?.setAttribute("search.resultCount", results.length), options.json) {
       console.log(JSON.stringify(results, null, 2));
       return;
     }
     if (results.length === 0) {
-      console.log(ansis.yellow(`No elements matching "${query}"`));
+      console.log(isSourceFileSearch ? ansis.yellow(`No elements found referencing source file: ${options.sourceFile}`) : ansis.yellow(`No elements matching "${query}"`));
       return;
     }
-    console.log(""), console.log(ansis.bold(`Found ${results.length} element(s) matching "${query}":`)), console.log(ansis.dim("\u2500".repeat(80)));
-    const layerWidth = 12, idWidth = 28, typeWidth = 12, nameWidth = 28;
-    console.log(`${ansis.cyan("LAYER".padEnd(layerWidth))} ${ansis.cyan("ID".padEnd(idWidth))} ${ansis.cyan("TYPE".padEnd(typeWidth))} ${ansis.cyan("NAME")}`), console.log(ansis.dim("\u2500".repeat(80)));
+    console.log(""), console.log(isSourceFileSearch ? ansis.bold(`Found ${results.length} element(s) referencing ${options.sourceFile}:`) : ansis.bold(`Found ${results.length} element(s) matching "${query}":`)), console.log(ansis.dim(TABLE_SEPARATOR));
+    const layerWidth = TABLE_COLUMN_WIDTHS.SEARCH_LAYER_WIDTH, idWidth = TABLE_COLUMN_WIDTHS.SEARCH_ID_WIDTH, typeWidth = TABLE_COLUMN_WIDTHS.SEARCH_TYPE_WIDTH, nameWidth = TABLE_COLUMN_WIDTHS.SEARCH_NAME_WIDTH;
+    console.log(`${ansis.cyan("LAYER".padEnd(layerWidth))} ${ansis.cyan("ID".padEnd(idWidth))} ${ansis.cyan("TYPE".padEnd(typeWidth))} ${ansis.cyan("NAME")}`), console.log(ansis.dim(TABLE_SEPARATOR));
     for (const result of results) {
       const layer = result.layer.substring(0, layerWidth - 1).padEnd(layerWidth), id = result.id.substring(0, idWidth - 1).padEnd(idWidth), type = result.type.substring(0, typeWidth - 1).padEnd(typeWidth), name = result.name.substring(0, nameWidth);
-      console.log(`${ansis.blue(layer)} ${id} ${type} ${name}`), options.verbose && result.description && console.log(ansis.dim(`  \u2514\u2500 ${result.description}`));
+      if (console.log(`${ansis.blue(layer)} ${id} ${type} ${name}`), (options.verbose || isSourceFileSearch) && (result.description && console.log(ansis.dim(`  \u2514\u2500 Description: ${result.description}`)), result.sourceFile)) {
+        const symbol = result.sourceSymbol ? ` | Symbol: ${result.sourceSymbol}` : "";
+        console.log(ansis.dim(`  \u2514\u2500 Source: ${result.sourceFile}${symbol}`));
+      }
     }
     console.log(ansis.dim("\u2500".repeat(80))), console.log("");
   } catch (error) {
-    const message = error instanceof Error ? error.message : String(error);
+    const message = getErrorMessage(error);
     console.error(ansis.red(`Error: ${message}`)), process.exit(1);
   }
 }

package/dist/commands/search.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/commands/search.ts"],
-  "sourcesContent": ["/**\n * Search for elements across the model\n */\n\nimport ansis from 'ansis';\nimport { Model } from '../core/model.js';\n\nexport interface SearchOptions {\n  layer?: string;\n  type?: string;\n  json?: boolean;\n  verbose?: boolean;\n  debug?: boolean;\n}\n\nexport async function searchCommand(query: string, options: SearchOptions): Promise<void> {\n  try {\n    // Load model\n    const model = await Model.load();\n\n    // Collect all matching elements\n    const results: Array<{\n      layer: string;\n      id: string;\n      type: string;\n      name: string;\n      description?: string;\n    }> = [];\n\n    const queryLower = query.toLowerCase();\n\n    for (const layerName of model.getLayerNames()) {\n      // Skip if layer filter specified and doesn't match\n      if (options.layer && layerName !== options.layer) {\n        continue;\n      }\n\n      const layerObj = await model.getLayer(layerName);\n      if (!layerObj) continue;\n\n      for (const element of layerObj.listElements()) {\n        // Apply filters\n        if (options.type && element.type !== options.type) {\n          continue;\n        }\n\n        // Match query against id and name\n        const idMatch = element.id.toLowerCase().includes(queryLower);\n        const nameMatch = element.name.toLowerCase().includes(queryLower);\n\n        if (idMatch || nameMatch) {\n          results.push({\n            layer: layerName,\n            id: element.id,\n            type: element.type,\n            name: element.name,\n            description: element.description,\n          });\n        }\n      }\n    }\n\n    // Output as JSON if requested\n    if (options.json) {\n      console.log(JSON.stringify(results, null, 2));\n      return;\n    }\n\n    // Display results\n    if (results.length === 0) {\n      console.log(ansis.yellow(`No elements matching \"${query}\"`));\n      return;\n    }\n\n    console.log('');\n    console.log(ansis.bold(`Found ${results.length} element(s) matching \"${query}\":`));\n    console.log(ansis.dim('\u2500'.repeat(80)));\n\n    // Print header\n    const layerWidth = 12;\n    const idWidth = 28;\n    const typeWidth = 12;\n    const nameWidth = 28;\n\n    console.log(\n      `${ansis.cyan('LAYER'.padEnd(layerWidth))} ${ansis.cyan('ID'.padEnd(idWidth))} ${ansis.cyan('TYPE'.padEnd(typeWidth))} ${ansis.cyan('NAME')}`\n    );\n    console.log(ansis.dim('\u2500'.repeat(80)));\n\n    // Print rows\n    for (const result of results) {\n      const layer = result.layer.substring(0, layerWidth - 1).padEnd(layerWidth);\n      const id = result.id.substring(0, idWidth - 1).padEnd(idWidth);\n      const type = result.type.substring(0, typeWidth - 1).padEnd(typeWidth);\n      const name = result.name.substring(0, nameWidth);\n\n      console.log(`${ansis.blue(layer)} ${id} ${type} ${name}`);\n\n      if (options.verbose && result.description) {\n        console.log(ansis.dim(`  \u2514\u2500 ${result.description}`));\n      }\n    }\n\n    console.log(ansis.dim('\u2500'.repeat(80)));\n    console.log('');\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    console.error(ansis.red(`Error: ${message}`));\n    process.exit(1);\n  }\n}\n"],
-  "mappings": "AAIA,OAAO,WAAW;AAClB,SAAS,aAAa;AAUtB,eAAsB,cAAc,OAAe,SAAsB;AACvE,MAAI;AAEF,UAAM,QAAQ,MAAM,MAAM,KAAI,GAGxB,UAMD,CAAA,GAEC,aAAa,MAAM,YAAW;AAEpC,eAAW,aAAa,MAAM,cAAa,GAAI;AAE7C,UAAI,QAAQ,SAAS,cAAc,QAAQ;AACzC;AAGF,YAAM,WAAW,MAAM,MAAM,SAAS,SAAS;AAC/C,UAAK;AAEL,mBAAW,WAAW,SAAS,aAAY,GAAI;AAE7C,cAAI,QAAQ,QAAQ,QAAQ,SAAS,QAAQ;AAC3C;AAIF,gBAAM,UAAU,QAAQ,GAAG,YAAW,EAAG,SAAS,UAAU,GACtD,YAAY,QAAQ,KAAK,YAAW,EAAG,SAAS,UAAU;AAEhE,WAAI,WAAW,cACb,QAAQ,KAAK;YACX,OAAO;YACP,IAAI,QAAQ;YACZ,MAAM,QAAQ;YACd,MAAM,QAAQ;YACd,aAAa,QAAQ;WACtB;QAEL;IACF;AAGA,QAAI,QAAQ,MAAM;AAChB,cAAQ,IAAI,KAAK,UAAU,SAAS,MAAM,CAAC,CAAC;AAC5C;IACF;AAGA,QAAI,QAAQ,WAAW,GAAG;AACxB,cAAQ,IAAI,MAAM,OAAO,yBAAyB,KAAK,GAAG,CAAC;AAC3D;IACF;AAEA,YAAQ,IAAI,EAAE,GACd,QAAQ,IAAI,MAAM,KAAK,SAAS,QAAQ,MAAM,yBAAyB,KAAK,IAAI,CAAC,GACjF,QAAQ,IAAI,MAAM,IAAI,SAAI,OAAO,EAAE,CAAC,CAAC;AAGrC,UAAM,aAAa,IACb,UAAU,IACV,YAAY,IACZ,YAAY;AAElB,YAAQ,IACN,GAAG,MAAM,KAAK,QAAQ,OAAO,UAAU,CAAC,CAAC,IAAI,MAAM,KAAK,KAAK,OAAO,OAAO,CAAC,CAAC,IAAI,MAAM,KAAK,OAAO,OAAO,SAAS,CAAC,CAAC,IAAI,MAAM,KAAK,MAAM,CAAC,EAAE,GAE/I,QAAQ,IAAI,MAAM,IAAI,SAAI,OAAO,EAAE,CAAC,CAAC;AAGrC,eAAW,UAAU,SAAS;AAC5B,YAAM,QAAQ,OAAO,MAAM,UAAU,GAAG,aAAa,CAAC,EAAE,OAAO,UAAU,GACnE,KAAK,OAAO,GAAG,UAAU,GAAG,UAAU,CAAC,EAAE,OAAO,OAAO,GACvD,OAAO,OAAO,KAAK,UAAU,GAAG,YAAY,CAAC,EAAE,OAAO,SAAS,GAC/D,OAAO,OAAO,KAAK,UAAU,GAAG,SAAS;AAE/C,cAAQ,IAAI,GAAG,MAAM,KAAK,KAAK,CAAC,IAAI,EAAE,IAAI,IAAI,IAAI,IAAI,EAAE,GAEpD,QAAQ,WAAW,OAAO,eAC5B,QAAQ,IAAI,MAAM,IAAI,kBAAQ,OAAO,WAAW,EAAE,CAAC;IAEvD;AAEA,YAAQ,IAAI,MAAM,IAAI,SAAI,OAAO,EAAE,CAAC,CAAC,GACrC,QAAQ,IAAI,EAAE;EAChB,SAAS,OAAO;AACd,UAAM,UAAU,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AACrE,YAAQ,MAAM,MAAM,IAAI,UAAU,OAAO,EAAE,CAAC,GAC5C,QAAQ,KAAK,CAAC;EAChB;AACF;",
+  "sourcesContent": ["/**\n * Search for elements across the model\n */\n\nimport ansis from \"ansis\";\nimport { Model } from \"../core/model.js\";\nimport type { Element } from \"../core/element.js\";\nimport { getActiveSpan } from \"../telemetry/index.js\";\nimport { getErrorMessage } from \"../utils/errors.js\";\nimport { TABLE_COLUMN_WIDTHS, TABLE_SEPARATOR } from \"../utils/table-formatting.js\";\n\nexport interface SearchOptions {\n  layer?: string;\n  type?: string;\n  sourceFile?: string;\n  json?: boolean;\n  verbose?: boolean;\n  debug?: boolean;\n}\n\n/**\n * Normalize a file path for comparison\n * - Removes leading ./\n * - Converts backslashes to forward slashes\n */\nfunction normalizePath(path: string): string {\n  return path.replace(/^\\.\\//, \"\").replace(/\\\\/g, \"/\");\n}\n\n/**\n * Check if an element matches the source file query\n */\nfunction matchesSourceFile(element: Element, sourceFilePath: string): boolean {\n  const sourceRef = element.getSourceReference();\n  if (!sourceRef) {\n    return false;\n  }\n\n  const normalizedQuery = normalizePath(sourceFilePath);\n\n  // Check if any location matches the queried file\n  return (sourceRef.locations ?? []).some((loc) => {\n    const normalizedLoc = normalizePath(loc.file);\n    return normalizedLoc === normalizedQuery;\n  });\n}\n\nexport async function searchCommand(query: string, options: SearchOptions): Promise<void> {\n  const span = getActiveSpan();\n\n  try {\n    // Load model\n    const model = await Model.load();\n\n    // Collect all matching elements with source reference info\n    const results: Array<{\n      layer: string;\n      id: string;\n      type: string;\n      name: string;\n      description?: string;\n      sourceFile?: string;\n      sourceSymbol?: string;\n    }> = [];\n\n    const queryLower = query.toLowerCase();\n    const isSourceFileSearch = !!options.sourceFile;\n\n    for (const layerName of model.getLayerNames()) {\n      // Skip if layer filter specified and doesn't match\n      if (options.layer && layerName !== options.layer) {\n        continue;\n      }\n\n      const layerObj = await model.getLayer(layerName);\n      if (!layerObj) continue;\n\n      for (const element of layerObj.listElements()) {\n        // Apply type filter\n        if (options.type && element.type !== options.type) {\n          continue;\n        }\n\n        // If source file search, use different matching logic\n        if (isSourceFileSearch) {\n          if (!matchesSourceFile(element, options.sourceFile!)) {\n            continue;\n          }\n        } else {\n          // Match query against path/id and name\n          const displayId = element.path || element.id;\n          const idMatch = displayId.toLowerCase().includes(queryLower);\n          const nameMatch = element.name.toLowerCase().includes(queryLower);\n\n          if (!idMatch && !nameMatch) {\n            continue;\n          }\n        }\n\n        // Extract source reference info if present\n        let sourceFile: string | undefined;\n        let sourceSymbol: string | undefined;\n        const sourceRef = element.getSourceReference();\n        if (sourceRef && sourceRef.locations && sourceRef.locations.length > 0) {\n          sourceFile = sourceRef.locations[0].file;\n          sourceSymbol = sourceRef.locations[0].symbol;\n        }\n\n        results.push({\n          layer: layerName,\n          id: element.path || element.id,\n          type: element.type,\n          name: element.name,\n          description: element.description,\n          sourceFile,\n          sourceSymbol,\n        });\n      }\n    }\n\n    span?.setAttribute(\"search.resultCount\", results.length);\n\n    // Output as JSON if requested\n    if (options.json) {\n      console.log(JSON.stringify(results, null, 2));\n      return;\n    }\n\n    // Display results\n    if (results.length === 0) {\n      if (isSourceFileSearch) {\n        console.log(\n          ansis.yellow(`No elements found referencing source file: ${options.sourceFile}`)\n        );\n      } else {\n        console.log(ansis.yellow(`No elements matching \"${query}\"`));\n      }\n      return;\n    }\n\n    console.log(\"\");\n    if (isSourceFileSearch) {\n      console.log(\n        ansis.bold(`Found ${results.length} element(s) referencing ${options.sourceFile}:`)\n      );\n    } else {\n      console.log(ansis.bold(`Found ${results.length} element(s) matching \"${query}\":`));\n    }\n    console.log(ansis.dim(TABLE_SEPARATOR));\n\n    // Print header\n    const layerWidth = TABLE_COLUMN_WIDTHS.SEARCH_LAYER_WIDTH;\n    const idWidth = TABLE_COLUMN_WIDTHS.SEARCH_ID_WIDTH;\n    const typeWidth = TABLE_COLUMN_WIDTHS.SEARCH_TYPE_WIDTH;\n    const nameWidth = TABLE_COLUMN_WIDTHS.SEARCH_NAME_WIDTH;\n\n    console.log(\n      `${ansis.cyan(\"LAYER\".padEnd(layerWidth))} ${ansis.cyan(\"ID\".padEnd(idWidth))} ${ansis.cyan(\"TYPE\".padEnd(typeWidth))} ${ansis.cyan(\"NAME\")}`\n    );\n    console.log(ansis.dim(TABLE_SEPARATOR));\n\n    // Print rows\n    for (const result of results) {\n      const layer = result.layer.substring(0, layerWidth - 1).padEnd(layerWidth);\n      const id = result.id.substring(0, idWidth - 1).padEnd(idWidth);\n      const type = result.type.substring(0, typeWidth - 1).padEnd(typeWidth);\n      const name = result.name.substring(0, nameWidth);\n\n      console.log(`${ansis.blue(layer)} ${id} ${type} ${name}`);\n\n      // Show description and source info in verbose mode or for source file searches\n      if (options.verbose || isSourceFileSearch) {\n        if (result.description) {\n          console.log(ansis.dim(`  \u2514\u2500 Description: ${result.description}`));\n        }\n        if (result.sourceFile) {\n          const symbol = result.sourceSymbol ? ` | Symbol: ${result.sourceSymbol}` : \"\";\n          console.log(ansis.dim(`  \u2514\u2500 Source: ${result.sourceFile}${symbol}`));\n        }\n      }\n    }\n\n    console.log(ansis.dim(\"\u2500\".repeat(80)));\n    console.log(\"\");\n  } catch (error) {\n    const message = getErrorMessage(error);\n    console.error(ansis.red(`Error: ${message}`));\n    process.exit(1);\n  }\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/commands/show.js

@@ -1,36 +1,67 @@
 import ansis from "ansis";
 import { Model } from "../core/model.js";
 import { findElementLayer } from "../utils/element-utils.js";
+import { CLIError, ErrorCategory, handleError } from "../utils/errors.js";
+import { isTelemetryEnabled, startActiveSpan } from "../telemetry/index.js";
+import { getErrorMessage } from "../utils/errors.js";
 async function showCommand(id, options = {}) {
-  try {
-    const model = await Model.load(options.model), layerName = await findElementLayer(model, id);
-    layerName || (console.error(ansis.red(`Error: Element ${id} not found`)), process.exit(1));
-    const element = (await model.getLayer(layerName)).getElement(id);
-    if (console.log(""), console.log(ansis.bold(`${ansis.blue("Element:")} ${id}`)), console.log(ansis.dim("\u2500".repeat(60))), console.log(`${ansis.gray("Layer:")}       ${layerName}`), console.log(`${ansis.gray("Type:")}        ${element.type}`), console.log(`${ansis.gray("Name:")}        ${element.name}`), element.description && console.log(`${ansis.gray("Description:")} ${element.description}`), Object.keys(element.properties).length > 0) {
-      console.log(""), console.log(ansis.bold("Properties:"));
-      for (const [key, value] of Object.entries(element.properties)) {
-        const displayValue = typeof value == "string" ? value : JSON.stringify(value, null, 2);
-        console.log(`  ${ansis.cyan(key)}: ${displayValue}`);
-      }
-    }
-    if (element.references && element.references.length > 0) {
-      console.log(""), console.log(ansis.bold("References:"));
-      for (const ref of element.references)
-        console.log(`  \u2192 ${ansis.yellow(ref.target)} (${ref.type})`), ref.description && console.log(`    ${ansis.dim(ref.description)}`);
-    }
-    if (element.relationships && element.relationships.length > 0) {
-      console.log(""), console.log(ansis.bold("Relationships:"));
-      for (const rel of element.relationships)
-        if (console.log(`  ${ansis.magenta(rel.predicate)}: ${rel.target}`), rel.properties) {
-          const propStr = Object.entries(rel.properties).map(([k, v]) => `${k}=${v}`).join(", ");
-          console.log(`    ${ansis.dim(propStr)}`);
+  const inferredLayer = id.includes(".") ? id.split(".")[0] : void 0;
+  await startActiveSpan("show.execute", async (span) => {
+    try {
+      const model = await Model.load(options.model, inferredLayer ? { layers: [inferredLayer] } : {}), layerName = await findElementLayer(model, id);
+      if (!layerName)
+        throw isTelemetryEnabled && span.setAttribute("show.found", !1), new CLIError(`Element ${id} not found`, ErrorCategory.USER, [
+          `Use "dr search ${id}" to find similar elements`,
+          'Use "dr list <layer>" to list all elements in a layer'
+        ]);
+      const layer = await model.getLayer(layerName);
+      if (!layer)
+        throw new CLIError(`Layer ${layerName} not found`, ErrorCategory.USER, [
+          'Use "dr schema layers" to list all available layers'
+        ]);
+      const element = layer.getElement(id);
+      if (!element)
+        throw new CLIError(`Element ${id} not found`, ErrorCategory.USER, [
+          `Use "dr search ${id}" to find similar elements`,
+          'Use "dr list <layer>" to list all elements in a layer'
+        ]);
+      const elementId = element.path || element.id, { outgoing, incoming } = model.relationships.getForElement(elementId), hasRelationships = outgoing.length > 0 || incoming.length > 0;
+      if (isTelemetryEnabled && (span.setAttribute("show.found", !0), span.setAttribute("show.layer", layerName), span.setAttribute("show.type", element.type), span.setAttribute("show.hasReferences", element.references && element.references.length > 0), span.setAttribute("show.hasRelationships", hasRelationships), span.setAttribute("show.outgoingRelationships", outgoing.length), span.setAttribute("show.incomingRelationships", incoming.length)), console.log(""), console.log(ansis.bold(`${ansis.blue("Element:")} ${id}`)), console.log(ansis.dim("\u2500".repeat(60))), console.log(`${ansis.gray("Layer:")}       ${layerName}`), console.log(`${ansis.gray("Type:")}        ${element.type}`), console.log(`${ansis.gray("Name:")}        ${element.name}`), element.description && console.log(`${ansis.gray("Description:")} ${element.description}`), Object.keys(element.attributes).length > 0) {
+        console.log(""), console.log(ansis.bold("Properties:"));
+        for (const [key, value] of Object.entries(element.attributes)) {
+          const displayValue = typeof value == "string" ? value : JSON.stringify(value, null, 2);
+          console.log(`  ${ansis.cyan(key)}: ${displayValue}`);
         }
+      }
+      if (element.references && element.references.length > 0) {
+        console.log(""), console.log(ansis.bold("References:"));
+        for (const ref of element.references)
+          console.log(`  \u2192 ${ansis.yellow(ref.target)} (${ref.type})`), ref.description && console.log(`    ${ansis.dim(ref.description)}`);
+      }
+      if (outgoing.length > 0) {
+        console.log(""), console.log(ansis.bold("Relationships (outgoing):"));
+        for (const rel of outgoing)
+          if (console.log(`  ${ansis.magenta(rel.predicate)} \u2192 ${rel.target}`), rel.properties && Object.keys(rel.properties).length > 0) {
+            const propStr = Object.entries(rel.properties).map(([k, v]) => `${k}=${v}`).join(", ");
+            console.log(`    ${ansis.dim(propStr)}`);
+          }
+      }
+      if (incoming.length > 0) {
+        console.log(""), console.log(ansis.bold("Relationships (incoming):"));
+        for (const rel of incoming)
+          console.log(`  ${ansis.magenta(rel.predicate)} \u2190 ${rel.source}`);
+      }
+      const sourceRef = element.getSourceReference();
+      sourceRef && (console.log(""), console.log(ansis.bold("Source Code Location:")), console.log(`  ${ansis.gray("Provenance:")} ${sourceRef.provenance}`), (sourceRef.locations ?? []).forEach((loc, idx) => {
+        console.log(`  ${ansis.gray("Location " + (idx + 1) + ":")}`), console.log(`    File: ${ansis.cyan(loc.file)}`), loc.symbol && console.log(`    Symbol: ${ansis.cyan(loc.symbol)}`);
+      }), sourceRef.repository && (console.log(`  ${ansis.gray("Repository Context:")}`), sourceRef.repository.url && console.log(`    Remote: ${ansis.cyan(sourceRef.repository.url)}`), sourceRef.repository.commit && console.log(`    Commit: ${ansis.cyan(sourceRef.repository.commit)}`))), console.log(""), isTelemetryEnabled && span.setStatus({ code: 0 });
+    } catch (error) {
+      isTelemetryEnabled && (span.recordException(error), span.setStatus({
+        code: 2,
+        message: getErrorMessage(error)
+      })), handleError(error);
     }
-    console.log("");
-  } catch (error) {
-    const message = error instanceof Error ? error.message : String(error);
-    console.error(ansis.red(`Error: ${message}`)), process.exit(1);
-  }
+  }, { "show.elementId": id });
 }
 export {
   showCommand

package/dist/commands/show.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/commands/show.ts"],
-  "sourcesContent": ["/**\n * Show detailed information about an element\n */\n\nimport ansis from 'ansis';\nimport { Model } from '../core/model.js';\nimport { findElementLayer } from '../utils/element-utils.js';\n\nexport async function showCommand(id: string, options: { model?: string } = {}): Promise<void> {\n  try {\n    // Load model (optionally from specified path)\n    const model = await Model.load(options.model);\n\n    // Find element\n    const layerName = await findElementLayer(model, id);\n    if (!layerName) {\n      console.error(ansis.red(`Error: Element ${id} not found`));\n      process.exit(1);\n    }\n\n    const layer = (await model.getLayer(layerName))!;\n    const element = layer.getElement(id)!;\n\n    // Display element information\n    console.log('');\n    console.log(ansis.bold(`${ansis.blue('Element:')} ${id}`));\n    console.log(ansis.dim('\u2500'.repeat(60)));\n    console.log(`${ansis.gray('Layer:')}       ${layerName}`);\n    console.log(`${ansis.gray('Type:')}        ${element.type}`);\n    console.log(`${ansis.gray('Name:')}        ${element.name}`);\n\n    if (element.description) {\n      console.log(`${ansis.gray('Description:')} ${element.description}`);\n    }\n\n    // Display properties\n    if (Object.keys(element.properties).length > 0) {\n      console.log('');\n      console.log(ansis.bold('Properties:'));\n      for (const [key, value] of Object.entries(element.properties)) {\n        const displayValue =\n          typeof value === 'string' ? value : JSON.stringify(value, null, 2);\n        console.log(`  ${ansis.cyan(key)}: ${displayValue}`);\n      }\n    }\n\n    // Display references\n    if (element.references && element.references.length > 0) {\n      console.log('');\n      console.log(ansis.bold('References:'));\n      for (const ref of element.references) {\n        console.log(`  \u2192 ${ansis.yellow(ref.target)} (${ref.type})`);\n        if (ref.description) {\n          console.log(`    ${ansis.dim(ref.description)}`);\n        }\n      }\n    }\n\n    // Display relationships\n    if (element.relationships && element.relationships.length > 0) {\n      console.log('');\n      console.log(ansis.bold('Relationships:'));\n      for (const rel of element.relationships) {\n        console.log(`  ${ansis.magenta(rel.predicate)}: ${rel.target}`);\n        if (rel.properties) {\n          const propStr = Object.entries(rel.properties)\n            .map(([k, v]) => `${k}=${v}`)\n            .join(', ');\n          console.log(`    ${ansis.dim(propStr)}`);\n        }\n      }\n    }\n\n    console.log('');\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    console.error(ansis.red(`Error: ${message}`));\n    process.exit(1);\n  }\n}\n"],
-  "mappings": "AAIA,OAAO,WAAW;AAClB,SAAS,aAAa;AACtB,SAAS,wBAAwB;AAEjC,eAAsB,YAAY,IAAY,UAA8B,CAAA,GAAE;AAC5E,MAAI;AAEF,UAAM,QAAQ,MAAM,MAAM,KAAK,QAAQ,KAAK,GAGtC,YAAY,MAAM,iBAAiB,OAAO,EAAE;AAClD,IAAK,cACH,QAAQ,MAAM,MAAM,IAAI,kBAAkB,EAAE,YAAY,CAAC,GACzD,QAAQ,KAAK,CAAC;AAIhB,UAAM,WADS,MAAM,MAAM,SAAS,SAAS,GACvB,WAAW,EAAE;AAenC,QAZA,QAAQ,IAAI,EAAE,GACd,QAAQ,IAAI,MAAM,KAAK,GAAG,MAAM,KAAK,UAAU,CAAC,IAAI,EAAE,EAAE,CAAC,GACzD,QAAQ,IAAI,MAAM,IAAI,SAAI,OAAO,EAAE,CAAC,CAAC,GACrC,QAAQ,IAAI,GAAG,MAAM,KAAK,QAAQ,CAAC,UAAU,SAAS,EAAE,GACxD,QAAQ,IAAI,GAAG,MAAM,KAAK,OAAO,CAAC,WAAW,QAAQ,IAAI,EAAE,GAC3D,QAAQ,IAAI,GAAG,MAAM,KAAK,OAAO,CAAC,WAAW,QAAQ,IAAI,EAAE,GAEvD,QAAQ,eACV,QAAQ,IAAI,GAAG,MAAM,KAAK,cAAc,CAAC,IAAI,QAAQ,WAAW,EAAE,GAIhE,OAAO,KAAK,QAAQ,UAAU,EAAE,SAAS,GAAG;AAC9C,cAAQ,IAAI,EAAE,GACd,QAAQ,IAAI,MAAM,KAAK,aAAa,CAAC;AACrC,iBAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,QAAQ,UAAU,GAAG;AAC7D,cAAM,eACJ,OAAO,SAAU,WAAW,QAAQ,KAAK,UAAU,OAAO,MAAM,CAAC;AACnE,gBAAQ,IAAI,KAAK,MAAM,KAAK,GAAG,CAAC,KAAK,YAAY,EAAE;MACrD;IACF;AAGA,QAAI,QAAQ,cAAc,QAAQ,WAAW,SAAS,GAAG;AACvD,cAAQ,IAAI,EAAE,GACd,QAAQ,IAAI,MAAM,KAAK,aAAa,CAAC;AACrC,iBAAW,OAAO,QAAQ;AACxB,gBAAQ,IAAI,YAAO,MAAM,OAAO,IAAI,MAAM,CAAC,KAAK,IAAI,IAAI,GAAG,GACvD,IAAI,eACN,QAAQ,IAAI,OAAO,MAAM,IAAI,IAAI,WAAW,CAAC,EAAE;IAGrD;AAGA,QAAI,QAAQ,iBAAiB,QAAQ,cAAc,SAAS,GAAG;AAC7D,cAAQ,IAAI,EAAE,GACd,QAAQ,IAAI,MAAM,KAAK,gBAAgB,CAAC;AACxC,iBAAW,OAAO,QAAQ;AAExB,YADA,QAAQ,IAAI,KAAK,MAAM,QAAQ,IAAI,SAAS,CAAC,KAAK,IAAI,MAAM,EAAE,GAC1D,IAAI,YAAY;AAClB,gBAAM,UAAU,OAAO,QAAQ,IAAI,UAAU,EAC1C,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,EAAE,EAC3B,KAAK,IAAI;AACZ,kBAAQ,IAAI,OAAO,MAAM,IAAI,OAAO,CAAC,EAAE;QACzC;IAEJ;AAEA,YAAQ,IAAI,EAAE;EAChB,SAAS,OAAO;AACd,UAAM,UAAU,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AACrE,YAAQ,MAAM,MAAM,IAAI,UAAU,OAAO,EAAE,CAAC,GAC5C,QAAQ,KAAK,CAAC;EAChB;AACF;",
+  "sourcesContent": ["/**\n * Show detailed information about an element\n */\n\nimport ansis from \"ansis\";\nimport { Model } from \"../core/model.js\";\nimport { findElementLayer } from \"../utils/element-utils.js\";\nimport { CLIError, ErrorCategory, handleError } from \"../utils/errors.js\";\nimport { isTelemetryEnabled, startActiveSpan } from \"../telemetry/index.js\";\nimport { getErrorMessage } from \"../utils/errors.js\";\n\nexport async function showCommand(id: string, options: { model?: string } = {}): Promise<void> {\n  // Infer the layer from the element ID prefix (e.g. \"api.operation.foo\" \u2192 load only \"api\" layer)\n  // Falls back to loading all layers if the ID doesn't contain a layer prefix.\n  const inferredLayer = id.includes(\".\") ? id.split(\".\")[0] : undefined;\n\n  await startActiveSpan(\n    \"show.execute\",\n    async (span) => {\n      try {\n        // Load only the inferred layer when possible (performance: avoids loading all 12 layers)\n        const model = await Model.load(\n          options.model,\n          inferredLayer ? { layers: [inferredLayer] } : {}\n        );\n\n        // Find element\n        const layerName = await findElementLayer(model, id);\n        if (!layerName) {\n          if (isTelemetryEnabled) {\n            (span as any).setAttribute(\"show.found\", false);\n          }\n          throw new CLIError(`Element ${id} not found`, ErrorCategory.USER, [\n            `Use \"dr search ${id}\" to find similar elements`,\n            'Use \"dr list <layer>\" to list all elements in a layer',\n          ]);\n        }\n\n        const layer = await model.getLayer(layerName);\n        if (!layer) {\n          throw new CLIError(`Layer ${layerName} not found`, ErrorCategory.USER, [\n            'Use \"dr schema layers\" to list all available layers',\n          ]);\n        }\n\n        const element = layer.getElement(id);\n        if (!element) {\n          throw new CLIError(`Element ${id} not found`, ErrorCategory.USER, [\n            `Use \"dr search ${id}\" to find similar elements`,\n            'Use \"dr list <layer>\" to list all elements in a layer',\n          ]);\n        }\n\n        // Query relationships from the central store (element.relationships is always empty\n        // for modern elements since relationships moved to relationships.yaml)\n        const elementId = element.path || element.id;\n        const { outgoing, incoming } = model.relationships.getForElement(elementId);\n        const hasRelationships = outgoing.length > 0 || incoming.length > 0;\n\n        if (isTelemetryEnabled) {\n          (span as any).setAttribute(\"show.found\", true);\n          (span as any).setAttribute(\"show.layer\", layerName);\n          (span as any).setAttribute(\"show.type\", element.type);\n          (span as any).setAttribute(\n            \"show.hasReferences\",\n            element.references && element.references.length > 0\n          );\n          (span as any).setAttribute(\"show.hasRelationships\", hasRelationships);\n          (span as any).setAttribute(\"show.outgoingRelationships\", outgoing.length);\n          (span as any).setAttribute(\"show.incomingRelationships\", incoming.length);\n        }\n\n        // Display element information\n        console.log(\"\");\n        console.log(ansis.bold(`${ansis.blue(\"Element:\")} ${id}`));\n        console.log(ansis.dim(\"\u2500\".repeat(60)));\n        console.log(`${ansis.gray(\"Layer:\")}       ${layerName}`);\n        console.log(`${ansis.gray(\"Type:\")}        ${element.type}`);\n        console.log(`${ansis.gray(\"Name:\")}        ${element.name}`);\n\n        if (element.description) {\n          console.log(`${ansis.gray(\"Description:\")} ${element.description}`);\n        }\n\n        // Display properties (attributes)\n        if (Object.keys(element.attributes).length > 0) {\n          console.log(\"\");\n          console.log(ansis.bold(\"Properties:\"));\n          for (const [key, value] of Object.entries(element.attributes)) {\n            const displayValue = typeof value === \"string\" ? value : JSON.stringify(value, null, 2);\n            console.log(`  ${ansis.cyan(key)}: ${displayValue}`);\n          }\n        }\n\n        // Display references (inline, legacy format)\n        if (element.references && element.references.length > 0) {\n          console.log(\"\");\n          console.log(ansis.bold(\"References:\"));\n          for (const ref of element.references) {\n            console.log(`  \u2192 ${ansis.yellow(ref.target)} (${ref.type})`);\n            if (ref.description) {\n              console.log(`    ${ansis.dim(ref.description)}`);\n            }\n          }\n        }\n\n        // Display relationships from the central relationships store\n        if (outgoing.length > 0) {\n          console.log(\"\");\n          console.log(ansis.bold(\"Relationships (outgoing):\"));\n          for (const rel of outgoing) {\n            console.log(`  ${ansis.magenta(rel.predicate)} \u2192 ${rel.target}`);\n            if (rel.properties && Object.keys(rel.properties).length > 0) {\n              const propStr = Object.entries(rel.properties)\n                .map(([k, v]) => `${k}=${v}`)\n                .join(\", \");\n              console.log(`    ${ansis.dim(propStr)}`);\n            }\n          }\n        }\n\n        if (incoming.length > 0) {\n          console.log(\"\");\n          console.log(ansis.bold(\"Relationships (incoming):\"));\n          for (const rel of incoming) {\n            console.log(`  ${ansis.magenta(rel.predicate)} \u2190 ${rel.source}`);\n          }\n        }\n\n        // Display source code location if present\n        const sourceRef = element.getSourceReference();\n        if (sourceRef) {\n          console.log(\"\");\n          console.log(ansis.bold(\"Source Code Location:\"));\n          console.log(`  ${ansis.gray(\"Provenance:\")} ${sourceRef.provenance}`);\n\n          (sourceRef.locations ?? []).forEach((loc, idx) => {\n            console.log(`  ${ansis.gray(\"Location \" + (idx + 1) + \":\")}`);\n            console.log(`    File: ${ansis.cyan(loc.file)}`);\n            if (loc.symbol) {\n              console.log(`    Symbol: ${ansis.cyan(loc.symbol)}`);\n            }\n          });\n\n          if (sourceRef.repository) {\n            console.log(`  ${ansis.gray(\"Repository Context:\")}`);\n            if (sourceRef.repository.url) {\n              console.log(`    Remote: ${ansis.cyan(sourceRef.repository.url)}`);\n            }\n            if (sourceRef.repository.commit) {\n              console.log(`    Commit: ${ansis.cyan(sourceRef.repository.commit)}`);\n            }\n          }\n        }\n\n        console.log(\"\");\n\n        if (isTelemetryEnabled) {\n          (span as any).setStatus({ code: 0 });\n        }\n      } catch (error) {\n        if (isTelemetryEnabled) {\n          (span as any).recordException(error as Error);\n          (span as any).setStatus({\n            code: 2,\n            message: getErrorMessage(error),\n          });\n        }\n        handleError(error);\n      }\n    },\n    { \"show.elementId\": id }\n  );\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/commands/stats.js

@@ -0,0 +1,35 @@
+import ansis from "ansis";
+import { writeFile, ensureDir } from "../utils/file-io.js";
+import { Model } from "../core/model.js";
+import { StatsCollector } from "../core/stats-collector.js";
+import { formatStats } from "../export/stats-formatters.js";
+import path from "path";
+import { getErrorMessage } from "../utils/errors.js";
+async function statsCommand(options) {
+  try {
+    const model = await Model.load(options.model), stats = await new StatsCollector(model).collect();
+    let format = options.format || "text";
+    if (options.output) {
+      const ext = path.extname(options.output).toLowerCase();
+      ext === ".json" ? format = "json" : ext === ".md" && (format = "markdown");
+    }
+    options.compact && (format = "compact");
+    const output = formatStats(stats, {
+      format,
+      compact: options.compact,
+      verbose: options.verbose
+    });
+    if (options.output) {
+      const outputPath = path.resolve(process.cwd(), options.output), outputDir = path.dirname(outputPath);
+      await ensureDir(outputDir), await writeFile(outputPath, output), console.log(ansis.green(`\u2713 Statistics written to ${options.output}`));
+    } else
+      console.log(output);
+  } catch (error) {
+    const message = getErrorMessage(error);
+    console.error(ansis.red(`Error: ${message}`)), process.exit(1);
+  }
+}
+export {
+  statsCommand
+};
+//# sourceMappingURL=stats.js.map

package/dist/commands/stats.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/commands/stats.ts"],
+  "sourcesContent": ["/**\n * Display statistics about the architecture model\n */\n\nimport ansis from \"ansis\";\nimport { writeFile, ensureDir } from \"../utils/file-io.js\";\nimport { Model } from \"../core/model.js\";\nimport { StatsCollector } from \"../core/stats-collector.js\";\nimport { formatStats, StatsFormat } from \"../export/stats-formatters.js\";\nimport path from \"path\";\nimport { getErrorMessage } from \"../utils/errors.js\";\n\nexport interface StatsOptions {\n  format?: StatsFormat;\n  output?: string;\n  compact?: boolean;\n  verbose?: boolean;\n  model?: string;\n  debug?: boolean;\n}\n\n/**\n * Run the stats command\n */\nexport async function statsCommand(options: StatsOptions): Promise<void> {\n  try {\n    // Load model\n    const model = await Model.load(options.model);\n\n    // Collect statistics\n    const collector = new StatsCollector(model);\n    const stats = await collector.collect();\n\n    // Determine output format\n    let format: StatsFormat = options.format || \"text\";\n\n    // Auto-detect format from output file extension\n    if (options.output) {\n      const ext = path.extname(options.output).toLowerCase();\n      if (ext === \".json\") {\n        format = \"json\";\n      } else if (ext === \".md\") {\n        format = \"markdown\";\n      }\n    }\n\n    // Use compact format if requested\n    if (options.compact) {\n      format = \"compact\";\n    }\n\n    // Format output\n    const output = formatStats(stats, {\n      format,\n      compact: options.compact,\n      verbose: options.verbose,\n    });\n\n    // Write to file or stdout\n    if (options.output) {\n      const outputPath = path.resolve(process.cwd(), options.output);\n      const outputDir = path.dirname(outputPath);\n\n      // Ensure output directory exists\n      await ensureDir(outputDir);\n\n      // Write file\n      await writeFile(outputPath, output);\n\n      console.log(ansis.green(`\u2713 Statistics written to ${options.output}`));\n    } else {\n      // Print to stdout\n      console.log(output);\n    }\n  } catch (error) {\n    const message = getErrorMessage(error);\n    console.error(ansis.red(`Error: ${message}`));\n    process.exit(1);\n  }\n}\n"],
+  "mappings": "AAIA,OAAO,WAAW;AAClB,SAAS,WAAW,iBAAiB;AACrC,SAAS,aAAa;AACtB,SAAS,sBAAsB;AAC/B,SAAS,mBAAgC;AACzC,OAAO,UAAU;AACjB,SAAS,uBAAuB;AAchC,eAAsB,aAAa,SAAqB;AACtD,MAAI;AAEF,UAAM,QAAQ,MAAM,MAAM,KAAK,QAAQ,KAAK,GAItC,QAAQ,MADI,IAAI,eAAe,KAAK,EACZ,QAAO;AAGrC,QAAI,SAAsB,QAAQ,UAAU;AAG5C,QAAI,QAAQ,QAAQ;AAClB,YAAM,MAAM,KAAK,QAAQ,QAAQ,MAAM,EAAE,YAAW;AACpD,MAAI,QAAQ,UACV,SAAS,SACA,QAAQ,UACjB,SAAS;IAEb;AAGA,IAAI,QAAQ,YACV,SAAS;AAIX,UAAM,SAAS,YAAY,OAAO;MAChC;MACA,SAAS,QAAQ;MACjB,SAAS,QAAQ;KAClB;AAGD,QAAI,QAAQ,QAAQ;AAClB,YAAM,aAAa,KAAK,QAAQ,QAAQ,IAAG,GAAI,QAAQ,MAAM,GACvD,YAAY,KAAK,QAAQ,UAAU;AAGzC,YAAM,UAAU,SAAS,GAGzB,MAAM,UAAU,YAAY,MAAM,GAElC,QAAQ,IAAI,MAAM,MAAM,gCAA2B,QAAQ,MAAM,EAAE,CAAC;IACtE;AAEE,cAAQ,IAAI,MAAM;EAEtB,SAAS,OAAO;AACd,UAAM,UAAU,gBAAgB,KAAK;AACrC,YAAQ,MAAM,MAAM,IAAI,UAAU,OAAO,EAAE,CAAC,GAC5C,QAAQ,KAAK,CAAC;EAChB;AACF;",
+  "names": []
+}

package/dist/commands/trace.js

@@ -3,18 +3,34 @@ import { Model } from "../core/model.js";
 import { ReferenceRegistry } from "../core/reference-registry.js";
 import { DependencyTracker, TraceDirection } from "../core/dependency-tracker.js";
 import { findElementLayer } from "../utils/element-utils.js";
+import { isTelemetryEnabled, startSpan, endSpan } from "../telemetry/index.js";
+import { CLIError } from "../utils/errors.js";
+import { getErrorMessage } from "../utils/errors.js";
 async function traceCommand(elementId, options = {}) {
+  const direction = options.direction || "both", span = isTelemetryEnabled ? startSpan("trace.execute", {
+    "trace.elementId": elementId,
+    "trace.direction": direction,
+    "trace.hasDepthLimit": options.depth !== void 0,
+    "trace.depth": options.depth
+  }) : null;
   try {
-    const model = await Model.load(options.model);
-    await findElementLayer(model, elementId) || (console.error(ansis.red(`Error: Element ${elementId} not found`)), process.exit(1));
+    const model = await Model.load(options.model), layerName = await findElementLayer(model, elementId);
+    if (!layerName)
+      throw isTelemetryEnabled && span && span.setAttribute("trace.found", !1), new CLIError(`Element ${elementId} not found`, 1);
+    isTelemetryEnabled && span && (span.setAttribute("trace.found", !0), span.setAttribute("trace.layer", layerName));
     const registry = new ReferenceRegistry();
     for (const layer of model.layers.values())
       for (const element of layer.listElements())
         registry.registerElement(element);
-    const tracker = new DependencyTracker(registry), direction = options.direction || "both";
+    const graph = registry.getDependencyGraph();
+    for (const rel of model.relationships.getAll())
+      graph.hasNode(rel.source) || graph.addNode(rel.source), graph.hasNode(rel.target) || graph.addNode(rel.target), graph.hasEdge(rel.source, rel.target) || graph.addEdge(rel.source, rel.target, { type: rel.predicate });
+    const tracker = new DependencyTracker(graph, model);
     if (console.log(""), console.log(ansis.bold(`${ansis.blue("Dependency Trace:")} ${ansis.yellow(elementId)}`)), console.log(ansis.dim("\u2500".repeat(80))), direction === "up" || direction === "both") {
       const transitiveDependents = tracker.traceDependencies(elementId, TraceDirection.DOWN, null), directDependents = tracker.traceDependencies(elementId, TraceDirection.DOWN, 1);
-      if (console.log(""), console.log(ansis.cyan(`Dependents (${directDependents.length} direct, ${transitiveDependents.length} transitive):`)), directDependents.length === 0)
+      isTelemetryEnabled && span && (span.setAttribute("trace.directDependents", directDependents.length), span.setAttribute("trace.transitiveDependents", transitiveDependents.length));
+      const transitiveOnlyDependents = transitiveDependents.filter((d) => !directDependents.includes(d));
+      if (console.log(""), console.log(ansis.cyan(`Dependents (${directDependents.length} direct, ${transitiveOnlyDependents.length} transitive):`)), directDependents.length === 0)
         console.log(ansis.dim("  (none)"));
       else {
         console.log(ansis.gray("  Direct:"));
@@ -22,17 +38,18 @@ async function traceCommand(elementId, options = {}) {
           console.log(`    ${ansis.yellow("\u2190")} ${ansis.green(dep)}`);
         directDependents.length > 10 && console.log(ansis.dim(`    ... and ${directDependents.length - 10} more`));
       }
-      if (transitiveDependents.length > 0 && directDependents.length > 0) {
+      if (transitiveOnlyDependents.length > 0) {
         console.log(ansis.gray("  Transitive:"));
-        const transitiveOnly = transitiveDependents.filter((d) => !directDependents.includes(d));
-        for (const dep of transitiveOnly.slice(0, 10))
+        for (const dep of transitiveOnlyDependents.slice(0, 10))
           console.log(`    ${ansis.yellow("\u2196")} ${ansis.dim(dep)}`);
-        transitiveOnly.length > 10 && console.log(ansis.dim(`    ... and ${transitiveOnly.length - 10} more`));
+        transitiveOnlyDependents.length > 10 && console.log(ansis.dim(`    ... and ${transitiveOnlyDependents.length - 10} more`));
       }
     }
     if (direction === "down" || direction === "both") {
       const transitiveDependencies = tracker.traceDependencies(elementId, TraceDirection.UP, null), directDependencies = tracker.traceDependencies(elementId, TraceDirection.UP, 1);
-      if (console.log(""), console.log(ansis.cyan(`Dependencies (${directDependencies.length} direct, ${transitiveDependencies.length} transitive):`)), directDependencies.length === 0)
+      isTelemetryEnabled && span && (span.setAttribute("trace.directDependencies", directDependencies.length), span.setAttribute("trace.transitiveDependencies", transitiveDependencies.length));
+      const transitiveOnlyDependencies = transitiveDependencies.filter((d) => !directDependencies.includes(d));
+      if (console.log(""), console.log(ansis.cyan(`Dependencies (${directDependencies.length} direct, ${transitiveOnlyDependencies.length} transitive):`)), directDependencies.length === 0)
         console.log(ansis.dim("  (none)"));
       else {
         console.log(ansis.gray("  Direct:"));
@@ -40,18 +57,24 @@ async function traceCommand(elementId, options = {}) {
           console.log(`    ${ansis.yellow("\u2192")} ${ansis.green(dep)}`);
         directDependencies.length > 10 && console.log(ansis.dim(`    ... and ${directDependencies.length - 10} more`));
       }
-      if (transitiveDependencies.length > 0 && directDependencies.length > 0) {
+      if (transitiveOnlyDependencies.length > 0) {
         console.log(ansis.gray("  Transitive:"));
-        const transitiveOnly = transitiveDependencies.filter((d) => !directDependencies.includes(d));
-        for (const dep of transitiveOnly.slice(0, 10))
+        for (const dep of transitiveOnlyDependencies.slice(0, 10))
           console.log(`    ${ansis.yellow("\u2198")} ${ansis.dim(dep)}`);
-        transitiveOnly.length > 10 && console.log(ansis.dim(`    ... and ${transitiveOnly.length - 10} more`));
+        transitiveOnlyDependencies.length > 10 && console.log(ansis.dim(`    ... and ${transitiveOnlyDependencies.length - 10} more`));
       }
     }
-    console.log("");
+    console.log(""), isTelemetryEnabled && span && span.setStatus({ code: 0 });
   } catch (error) {
-    const message = error instanceof Error ? error.message : String(error);
-    console.error(ansis.red(`Error: ${message}`)), process.exit(1);
+    if (isTelemetryEnabled && span && (span.recordException(error), span.setStatus({
+      code: 2,
+      message: getErrorMessage(error)
+    })), error instanceof CLIError)
+      throw error;
+    const message = getErrorMessage(error);
+    throw new CLIError(message, 1);
+  } finally {
+    endSpan(span);
   }
 }
 export {