@documentation-robotics/cli 0.1.0

package/biome.json

@@ -0,0 +1,42 @@
+{
+  "$schema": "https://biomejs.dev/schemas/1.8.0/schema.json",
+  "vcs": {
+    "enabled": true,
+    "clientKind": "git",
+    "useIgnoreFile": true
+  },
+  "files": {
+    "ignoreUnknown": false,
+    "ignore": ["node_modules", "dist", ".bun"]
+  },
+  "linter": {
+    "enabled": true,
+    "rules": {
+      "recommended": true,
+      "suspicious": {
+        "noExplicitAny": "error",
+        "noArrayIndexKey": "warn"
+      },
+      "style": {
+        "noImplicitBoolean": "error",
+        "useConsistentVariableDeclarations": "error"
+      }
+    }
+  },
+  "formatter": {
+    "enabled": true,
+    "indentStyle": "space",
+    "indentSize": 2,
+    "lineWidth": 100,
+    "trailingComma": "es5"
+  },
+  "javascript": {
+    "formatter": {
+      "quoteStyle": "single",
+      "trailingCommas": "es5"
+    },
+    "parser": {
+      "unsafeParameterDecoratorsEnabled": true
+    }
+  }
+}

package/bunfig.toml

@@ -0,0 +1,3 @@
+[test]
+root = "."
+timeoutMs = 30000

package/dist/ai/claude-client.js

@@ -0,0 +1,71 @@
+import Anthropic from "@anthropic-ai/sdk";
+class ClaudeClient {
+  client;
+  conversationHistory = [];
+  constructor(apiKey) {
+    this.client = new Anthropic({ apiKey });
+  }
+  /**
+   * Send a chat message and stream the response
+   * @param userMessage The message from the user
+   * @param options Configuration options for the API call
+   * @returns An async iterable of response text chunks
+   */
+  async chat(userMessage, options = {}) {
+    this.conversationHistory.push({
+      role: "user",
+      content: userMessage
+    });
+    const messages = this.conversationHistory.map((msg) => ({
+      role: msg.role,
+      content: msg.content
+    })), params = {
+      model: options.model || "claude-sonnet-4-5-20250929",
+      max_tokens: options.maxTokens || 4096,
+      messages
+    };
+    options.systemPrompt && (params.system = options.systemPrompt), options.tools && options.tools.length > 0 && (params.tools = options.tools);
+    const stream = await this.client.messages.stream(params);
+    return this.streamResponse(stream);
+  }
+  /**
+   * Stream response from Claude API and accumulate to conversation history
+   * @param stream The stream from Claude API
+   * @returns An async iterable of text chunks
+   */
+  async *streamResponse(stream) {
+    let assistantMessage = "";
+    for await (const chunk of stream)
+      if (chunk.type === "content_block_delta" && chunk.delta.type === "text_delta") {
+        const text = chunk.delta.text || "";
+        assistantMessage += text, yield text;
+      }
+    this.conversationHistory.push({
+      role: "assistant",
+      content: assistantMessage
+    });
+  }
+  /**
+   * Clear conversation history
+   */
+  clearHistory() {
+    this.conversationHistory = [];
+  }
+  /**
+   * Get conversation history
+   * @returns Copy of conversation history
+   */
+  getHistory() {
+    return [...this.conversationHistory];
+  }
+  /**
+   * Get the number of messages in history
+   */
+  getHistoryLength() {
+    return this.conversationHistory.length;
+  }
+}
+export {
+  ClaudeClient
+};
+//# sourceMappingURL=claude-client.js.map

package/dist/ai/claude-client.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/ai/claude-client.ts"],
+  "sourcesContent": ["/**\n * Claude Client for Anthropic SDK Integration\n * Handles streaming message responses and conversation history management\n *\n * IMPORTANT: This is legacy SDK-based chat infrastructure maintained for programmatic usage.\n * The `dr chat` CLI command uses Claude Code CLI subprocess instead (see commands/chat.ts).\n * Use this class only for direct Anthropic SDK integration in other contexts.\n */\n\nimport Anthropic from '@anthropic-ai/sdk';\n\n/**\n * Chat message in conversation history\n */\nexport interface ChatMessage {\n  role: 'user' | 'assistant';\n  content: string;\n}\n\n/**\n * Claude client for managing conversations with the Anthropic API\n */\nexport class ClaudeClient {\n  private client: Anthropic;\n  private conversationHistory: ChatMessage[] = [];\n\n  constructor(apiKey: string) {\n    this.client = new Anthropic({ apiKey });\n  }\n\n  /**\n   * Send a chat message and stream the response\n   * @param userMessage The message from the user\n   * @param options Configuration options for the API call\n   * @returns An async iterable of response text chunks\n   */\n  async chat(\n    userMessage: string,\n    options: {\n      model?: string;\n      maxTokens?: number;\n      systemPrompt?: string;\n      tools?: any[];\n    } = {}\n  ): Promise<AsyncIterable<string>> {\n    // Add user message to history\n    this.conversationHistory.push({\n      role: 'user',\n      content: userMessage,\n    });\n\n    // Create API request parameters\n    const messages = this.conversationHistory.map((msg) => ({\n      role: msg.role,\n      content: msg.content,\n    }));\n\n    const params: any = {\n      model: options.model || 'claude-sonnet-4-5-20250929',\n      max_tokens: options.maxTokens || 4096,\n      messages,\n    };\n\n    if (options.systemPrompt) {\n      params.system = options.systemPrompt;\n    }\n\n    if (options.tools && options.tools.length > 0) {\n      params.tools = options.tools;\n    }\n\n    // Create the stream\n    const stream = await this.client.messages.stream(params);\n\n    // Return async iterable that accumulates and yields response text\n    return this.streamResponse(stream);\n  }\n\n  /**\n   * Stream response from Claude API and accumulate to conversation history\n   * @param stream The stream from Claude API\n   * @returns An async iterable of text chunks\n   */\n  private async *streamResponse(stream: any): AsyncIterable<string> {\n    let assistantMessage = '';\n\n    for await (const chunk of stream) {\n      if (chunk.type === 'content_block_delta' && chunk.delta.type === 'text_delta') {\n        const text = chunk.delta.text || '';\n        assistantMessage += text;\n        yield text;\n      }\n    }\n\n    // Add complete assistant message to history\n    this.conversationHistory.push({\n      role: 'assistant',\n      content: assistantMessage,\n    });\n  }\n\n  /**\n   * Clear conversation history\n   */\n  clearHistory(): void {\n    this.conversationHistory = [];\n  }\n\n  /**\n   * Get conversation history\n   * @returns Copy of conversation history\n   */\n  getHistory(): ChatMessage[] {\n    return [...this.conversationHistory];\n  }\n\n  /**\n   * Get the number of messages in history\n   */\n  getHistoryLength(): number {\n    return this.conversationHistory.length;\n  }\n}\n"],
+  "mappings": "AASA,OAAO,eAAe;AAahB,MAAO,aAAY;EACf;EACA,sBAAqC,CAAA;EAE7C,YAAY,QAAc;AACxB,SAAK,SAAS,IAAI,UAAU,EAAE,OAAM,CAAE;EACxC;;;;;;;EAQA,MAAM,KACJ,aACA,UAKI,CAAA,GAAE;AAGN,SAAK,oBAAoB,KAAK;MAC5B,MAAM;MACN,SAAS;KACV;AAGD,UAAM,WAAW,KAAK,oBAAoB,IAAI,CAAC,SAAS;MACtD,MAAM,IAAI;MACV,SAAS,IAAI;MACb,GAEI,SAAc;MAClB,OAAO,QAAQ,SAAS;MACxB,YAAY,QAAQ,aAAa;MACjC;;AAGF,IAAI,QAAQ,iBACV,OAAO,SAAS,QAAQ,eAGtB,QAAQ,SAAS,QAAQ,MAAM,SAAS,MAC1C,OAAO,QAAQ,QAAQ;AAIzB,UAAM,SAAS,MAAM,KAAK,OAAO,SAAS,OAAO,MAAM;AAGvD,WAAO,KAAK,eAAe,MAAM;EACnC;;;;;;EAOQ,OAAO,eAAe,QAAW;AACvC,QAAI,mBAAmB;AAEvB,qBAAiB,SAAS;AACxB,UAAI,MAAM,SAAS,yBAAyB,MAAM,MAAM,SAAS,cAAc;AAC7E,cAAM,OAAO,MAAM,MAAM,QAAQ;AACjC,4BAAoB,MACpB,MAAM;MACR;AAIF,SAAK,oBAAoB,KAAK;MAC5B,MAAM;MACN,SAAS;KACV;EACH;;;;EAKA,eAAY;AACV,SAAK,sBAAsB,CAAA;EAC7B;;;;;EAMA,aAAU;AACR,WAAO,CAAC,GAAG,KAAK,mBAAmB;EACrC;;;;EAKA,mBAAgB;AACd,WAAO,KAAK,oBAAoB;EAClC;;",
+  "names": []
+}

package/dist/ai/context-provider.js

@@ -0,0 +1,129 @@
+import { readFile } from "fs/promises";
+import { fileURLToPath } from "url";
+import { dirname, join } from "path";
+class ModelContextProvider {
+  model;
+  layerNameMap = {
+    motivation: "01",
+    business: "02",
+    security: "03",
+    application: "04",
+    technology: "05",
+    api: "06",
+    "data-model": "07",
+    "data-store": "08",
+    ux: "09",
+    navigation: "10",
+    apm: "11",
+    testing: "12"
+  };
+  constructor(model) {
+    this.model = model;
+  }
+  /**
+   * Generate markdown context about the current architecture model
+   * @returns Markdown string with model overview and element summaries
+   */
+  async generateContext() {
+    const context = [];
+    context.push(`# Current Architecture Model
+`), context.push(`**Name**: ${this.model.manifest.name}`), context.push(`**Version**: ${this.model.manifest.version}`), this.model.manifest.description && context.push(`**Description**: ${this.model.manifest.description}`), context.push(""), context.push(`## Layers Overview
+`);
+    const layerNames = this.model.getLayerNames(), layerDetails = [];
+    for (const layerName of layerNames) {
+      const layer = await this.model.getLayer(layerName);
+      if (layer) {
+        const elementCount = layer.listElements().length;
+        layerDetails.push(`- **${layerName}**: ${elementCount} elements`);
+      }
+    }
+    layerDetails.length > 0 ? context.push(layerDetails.join(`
+`)) : context.push("_No layers loaded_"), context.push(""), context.push(`## Element Summary
+`);
+    for (const layerName of layerNames) {
+      const layer = await this.model.getLayer(layerName);
+      if (!layer)
+        continue;
+      const elements = layer.listElements();
+      if (elements.length === 0)
+        continue;
+      context.push(`### ${layerName}
+`);
+      const displayElements = elements.slice(0, 10);
+      for (const element of displayElements) {
+        const desc = element.description ? ` - ${element.description}` : "";
+        context.push(`- \`${element.id}\` (${element.type}): ${element.name}${desc}`);
+      }
+      elements.length > 10 && context.push(`- ... and ${elements.length - 10} more elements`), context.push("");
+    }
+    return context.join(`
+`);
+  }
+  /**
+   * Generate markdown context about the testing layer specification
+   * @returns Markdown string with testing layer specification
+   */
+  async generateTestingLayerSpec() {
+    return this.generateLayerSpec("testing");
+  }
+  /**
+   * Generate markdown context about a specific layer specification
+   * @param layerName The layer name (e.g., 'motivation', 'business', 'api')
+   * @returns Markdown string with layer specification
+   */
+  async generateLayerSpec(layerName) {
+    try {
+      const specPath = this.getLayerSpecPath(layerName);
+      return await readFile(specPath, "utf-8");
+    } catch {
+      return `# ${layerName} Layer
+
+_Layer specification not found._`;
+    }
+  }
+  /**
+   * Get the file path for a layer specification
+   * @param layerName The layer name
+   * @returns The file path to the layer specification
+   */
+  getLayerSpecPath(layerName) {
+    const normalizedName = layerName.toLowerCase().replace(/\s+/g, "-"), layerNumber = this.layerNameMap[normalizedName];
+    if (!layerNumber)
+      throw new Error(`Unknown layer: ${layerName}`);
+    const __filename = fileURLToPath(import.meta.url), __dirname = dirname(__filename), specDir = join(__dirname, "../../spec/layers");
+    let fileName;
+    return normalizedName === "data-store" ? fileName = `${layerNumber}-datastore-layer.md` : normalizedName === "apm" ? fileName = `${layerNumber}-apm-observability-layer.md` : fileName = `${layerNumber}-${normalizedName}-layer.md`, join(specDir, fileName);
+  }
+  /**
+   * Get a list of all available layers
+   * @returns Array of layer names
+   */
+  getAvailableLayers() {
+    return Object.keys(this.layerNameMap);
+  }
+  /**
+   * Get element count for a specific layer
+   * @param layerName The layer name
+   * @returns The number of elements in the layer, or 0 if not loaded
+   */
+  async getLayerElementCount(layerName) {
+    const layer = await this.model.getLayer(layerName);
+    return layer ? layer.listElements().length : 0;
+  }
+  /**
+   * Get total element count across all layers
+   * @returns Total number of elements
+   */
+  async getTotalElementCount() {
+    let total = 0;
+    for (const layerName of this.model.getLayerNames()) {
+      const layer = await this.model.getLayer(layerName);
+      layer && (total += layer.listElements().length);
+    }
+    return total;
+  }
+}
+export {
+  ModelContextProvider
+};
+//# sourceMappingURL=context-provider.js.map

package/dist/ai/context-provider.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/ai/context-provider.ts"],
+  "sourcesContent": ["/**\n * Model Context Provider\n * Generates context about the architecture model for Claude to use\n *\n * NOTE: This provider is used for both Claude Code CLI subprocess (commands/chat.ts)\n * and legacy SDK-based chat (legacy use cases only). See claude-client.ts for details.\n */\n\nimport { Model } from '../core/model.js';\nimport { readFile } from 'fs/promises';\nimport { fileURLToPath } from 'url';\nimport { dirname, join } from 'path';\n\n/**\n * Provides context about the model for AI interactions\n */\nexport class ModelContextProvider {\n  private model: Model;\n  private layerNameMap: Record<string, string> = {\n    motivation: '01',\n    business: '02',\n    security: '03',\n    application: '04',\n    technology: '05',\n    api: '06',\n    'data-model': '07',\n    'data-store': '08',\n    ux: '09',\n    navigation: '10',\n    apm: '11',\n    testing: '12',\n  };\n\n  constructor(model: Model) {\n    this.model = model;\n  }\n\n  /**\n   * Generate markdown context about the current architecture model\n   * @returns Markdown string with model overview and element summaries\n   */\n  async generateContext(): Promise<string> {\n    const context: string[] = [];\n\n    context.push('# Current Architecture Model\\n');\n    context.push(`**Name**: ${this.model.manifest.name}`);\n    context.push(`**Version**: ${this.model.manifest.version}`);\n    if (this.model.manifest.description) {\n      context.push(`**Description**: ${this.model.manifest.description}`);\n    }\n    context.push('');\n\n    context.push('## Layers Overview\\n');\n\n    // Get all available layers\n    const layerNames = this.model.getLayerNames();\n    const layerDetails: string[] = [];\n\n    for (const layerName of layerNames) {\n      const layer = await this.model.getLayer(layerName);\n      if (layer) {\n        const elementCount = layer.listElements().length;\n        layerDetails.push(`- **${layerName}**: ${elementCount} elements`);\n      }\n    }\n\n    if (layerDetails.length > 0) {\n      context.push(layerDetails.join('\\n'));\n    } else {\n      context.push('_No layers loaded_');\n    }\n\n    context.push('');\n    context.push('## Element Summary\\n');\n\n    // Show elements per layer\n    for (const layerName of layerNames) {\n      const layer = await this.model.getLayer(layerName);\n      if (!layer) continue;\n\n      const elements = layer.listElements();\n      if (elements.length === 0) continue;\n\n      context.push(`### ${layerName}\\n`);\n\n      // Show up to 10 elements per layer\n      const displayElements = elements.slice(0, 10);\n      for (const element of displayElements) {\n        const desc = element.description ? ` - ${element.description}` : '';\n        context.push(`- \\`${element.id}\\` (${element.type}): ${element.name}${desc}`);\n      }\n\n      if (elements.length > 10) {\n        context.push(`- ... and ${elements.length - 10} more elements`);\n      }\n\n      context.push('');\n    }\n\n    return context.join('\\n');\n  }\n\n  /**\n   * Generate markdown context about the testing layer specification\n   * @returns Markdown string with testing layer specification\n   */\n  async generateTestingLayerSpec(): Promise<string> {\n    return this.generateLayerSpec('testing');\n  }\n\n  /**\n   * Generate markdown context about a specific layer specification\n   * @param layerName The layer name (e.g., 'motivation', 'business', 'api')\n   * @returns Markdown string with layer specification\n   */\n  async generateLayerSpec(layerName: string): Promise<string> {\n    try {\n      const specPath = this.getLayerSpecPath(layerName);\n      const content = await readFile(specPath, 'utf-8');\n      return content;\n    } catch (error) {\n      return `# ${layerName} Layer\\n\\n_Layer specification not found._`;\n    }\n  }\n\n  /**\n   * Get the file path for a layer specification\n   * @param layerName The layer name\n   * @returns The file path to the layer specification\n   */\n  private getLayerSpecPath(layerName: string): string {\n    const normalizedName = layerName.toLowerCase().replace(/\\s+/g, '-');\n    const layerNumber = this.layerNameMap[normalizedName];\n\n    if (!layerNumber) {\n      throw new Error(`Unknown layer: ${layerName}`);\n    }\n\n    // Get the path relative to this file, going up to cli, then to spec\n    const __filename = fileURLToPath(import.meta.url);\n    const __dirname = dirname(__filename);\n    const specDir = join(__dirname, '../../spec/layers');\n\n    // Handle special case for data-store which is called datastore in spec\n    let fileName: string;\n    if (normalizedName === 'data-store') {\n      fileName = `${layerNumber}-datastore-layer.md`;\n    } else if (normalizedName === 'apm') {\n      fileName = `${layerNumber}-apm-observability-layer.md`;\n    } else {\n      fileName = `${layerNumber}-${normalizedName}-layer.md`;\n    }\n\n    return join(specDir, fileName);\n  }\n\n  /**\n   * Get a list of all available layers\n   * @returns Array of layer names\n   */\n  getAvailableLayers(): string[] {\n    return Object.keys(this.layerNameMap);\n  }\n\n  /**\n   * Get element count for a specific layer\n   * @param layerName The layer name\n   * @returns The number of elements in the layer, or 0 if not loaded\n   */\n  async getLayerElementCount(layerName: string): Promise<number> {\n    const layer = await this.model.getLayer(layerName);\n    return layer ? layer.listElements().length : 0;\n  }\n\n  /**\n   * Get total element count across all layers\n   * @returns Total number of elements\n   */\n  async getTotalElementCount(): Promise<number> {\n    let total = 0;\n    for (const layerName of this.model.getLayerNames()) {\n      const layer = await this.model.getLayer(layerName);\n      if (layer) {\n        total += layer.listElements().length;\n      }\n    }\n    return total;\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/ai/tools.js

@@ -0,0 +1,231 @@
+import { DependencyTracker, TraceDirection } from "../core/dependency-tracker.js";
+import { ReferenceRegistry } from "../core/reference-registry.js";
+function getModelTools() {
+  return [
+    {
+      name: "dr_list",
+      description: "List elements in a specific layer of the architecture model",
+      input_schema: {
+        type: "object",
+        properties: {
+          layer: {
+            type: "string",
+            description: "Layer name (motivation, business, security, application, technology, api, data-model, data-store, ux, navigation, apm, testing)"
+          },
+          type: {
+            type: "string",
+            description: "Optional: filter by element type"
+          }
+        },
+        required: ["layer"]
+      }
+    },
+    {
+      name: "dr_find",
+      description: "Find a specific element by its ID in the architecture model",
+      input_schema: {
+        type: "object",
+        properties: {
+          id: {
+            type: "string",
+            description: "Element ID to find (format: {layer}-{type}-{kebab-case-name})"
+          }
+        },
+        required: ["id"]
+      }
+    },
+    {
+      name: "dr_search",
+      description: "Search for elements by name, description, or ID in the architecture model",
+      input_schema: {
+        type: "object",
+        properties: {
+          query: {
+            type: "string",
+            description: "Search query (searches names, descriptions, and IDs)"
+          },
+          layers: {
+            type: "array",
+            items: { type: "string" },
+            description: "Optional: limit search to specific layers"
+          }
+        },
+        required: ["query"]
+      }
+    },
+    {
+      name: "dr_trace",
+      description: "Trace dependencies for an element (what depends on it, what it depends on, or both)",
+      input_schema: {
+        type: "object",
+        properties: {
+          id: {
+            type: "string",
+            description: "Element ID to trace dependencies for"
+          },
+          direction: {
+            type: "string",
+            enum: ["up", "down", "both"],
+            description: "Dependency direction: up=dependents, down=dependencies, both=both (default: both)"
+          }
+        },
+        required: ["id"]
+      }
+    }
+  ];
+}
+async function executeModelTool(toolName, args, model) {
+  switch (toolName) {
+    case "dr_list":
+      return await executeDrList(args, model);
+    case "dr_find":
+      return await executeDrFind(args, model);
+    case "dr_search":
+      return await executeDrSearch(args, model);
+    case "dr_trace":
+      return await executeDrTrace(args, model);
+    default:
+      return { error: `Unknown tool: ${toolName}` };
+  }
+}
+async function executeDrList(args, model) {
+  const layerName = args.layer, filterType = args.type;
+  if (!layerName)
+    return { error: "layer parameter is required" };
+  try {
+    const layer = await model.getLayer(layerName);
+    if (!layer)
+      return {
+        error: `Layer '${layerName}' not found or not loaded`,
+        availableLayers: model.getLayerNames()
+      };
+    let elements = layer.listElements();
+    return filterType && (elements = elements.filter((e) => e.type === filterType)), {
+      layer: layerName,
+      elementCount: elements.length,
+      elements: elements.map((e) => ({
+        id: e.id,
+        type: e.type,
+        name: e.name,
+        description: e.description || ""
+      }))
+    };
+  } catch (error) {
+    return {
+      error: error instanceof Error ? error.message : String(error)
+    };
+  }
+}
+async function executeDrFind(args, model) {
+  const id = args.id;
+  if (!id)
+    return { error: "id parameter is required" };
+  try {
+    for (const layerName of model.getLayerNames()) {
+      const layer = await model.getLayer(layerName);
+      if (!layer)
+        continue;
+      const element = layer.getElement(id);
+      if (element)
+        return {
+          found: !0,
+          element: {
+            id: element.id,
+            type: element.type,
+            name: element.name,
+            description: element.description || "",
+            layer: layerName,
+            properties: element.properties || {}
+          }
+        };
+    }
+    return {
+      found: !1,
+      error: `Element with id '${id}' not found`
+    };
+  } catch (error) {
+    return {
+      error: error instanceof Error ? error.message : String(error)
+    };
+  }
+}
+async function executeDrSearch(args, model) {
+  const query = args.query?.toLowerCase(), layerFilter = args.layers || void 0;
+  if (!query)
+    return { error: "query parameter is required" };
+  try {
+    const results = [];
+    for (const layerName of model.getLayerNames()) {
+      if (layerFilter && !layerFilter.includes(layerName))
+        continue;
+      const layer = await model.getLayer(layerName);
+      if (!layer)
+        continue;
+      const elements = layer.listElements();
+      for (const element of elements) {
+        const idMatches = element.id.toLowerCase().includes(query), nameMatches = element.name.toLowerCase().includes(query), descMatches = element.description && element.description.toLowerCase().includes(query);
+        (idMatches || nameMatches || descMatches) && results.push({
+          id: element.id,
+          type: element.type,
+          name: element.name,
+          description: element.description || "",
+          layer: layerName,
+          matchReason: idMatches && nameMatches ? "id and name" : idMatches ? "id" : nameMatches ? "name" : "description"
+        });
+      }
+    }
+    return {
+      query,
+      resultCount: results.length,
+      results
+    };
+  } catch (error) {
+    return {
+      error: error instanceof Error ? error.message : String(error)
+    };
+  }
+}
+async function executeDrTrace(args, model) {
+  const id = args.id, direction = args.direction || "both";
+  if (!id)
+    return { error: "id parameter is required" };
+  if (!["up", "down", "both"].includes(direction))
+    return { error: "direction must be one of: up, down, both" };
+  try {
+    const registry = new ReferenceRegistry();
+    for (const layerName of model.getLayerNames()) {
+      const layer = await model.getLayer(layerName);
+      if (layer)
+        for (const element of layer.listElements())
+          registry.registerElement(element);
+    }
+    const tracker = new DependencyTracker(registry), result = {
+      id,
+      direction
+    };
+    if (direction === "down" || direction === "both")
+      try {
+        const dependencies = tracker.traceDependencies(id, TraceDirection.UP, null);
+        result.dependencies = dependencies, result.dependencyCount = dependencies.length;
+      } catch {
+        result.dependencies = [], result.dependencyCount = 0;
+      }
+    if (direction === "up" || direction === "both")
+      try {
+        const dependents = tracker.traceDependencies(id, TraceDirection.DOWN, null);
+        result.dependents = dependents, result.dependentCount = dependents.length;
+      } catch {
+        result.dependents = [], result.dependentCount = 0;
+      }
+    return result;
+  } catch (error) {
+    return {
+      error: error instanceof Error ? error.message : String(error)
+    };
+  }
+}
+export {
+  executeModelTool,
+  getModelTools
+};
+//# sourceMappingURL=tools.js.map

package/dist/ai/tools.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/ai/tools.ts"],
+  "sourcesContent": ["/**\n * Tool Definitions for Claude AI Integration\n * Defines tools for dr_list, dr_find, dr_search, and dr_trace\n *\n * NOTE: These tool definitions are used for legacy SDK-based chat only.\n * The `dr chat` command uses Claude Code CLI subprocess with Bash and Read tools instead.\n */\n\nimport { Model } from '../core/model.js';\nimport { DependencyTracker, TraceDirection } from '../core/dependency-tracker.js';\nimport { ReferenceRegistry } from '../core/reference-registry.js';\n\n/**\n * Get tool definitions for Claude to use with the model\n * @returns Array of tool definitions in Claude format\n */\nexport function getModelTools(): any[] {\n  return [\n    {\n      name: 'dr_list',\n      description: 'List elements in a specific layer of the architecture model',\n      input_schema: {\n        type: 'object',\n        properties: {\n          layer: {\n            type: 'string',\n            description:\n              'Layer name (motivation, business, security, application, technology, api, data-model, data-store, ux, navigation, apm, testing)',\n          },\n          type: {\n            type: 'string',\n            description: 'Optional: filter by element type',\n          },\n        },\n        required: ['layer'],\n      },\n    },\n    {\n      name: 'dr_find',\n      description: 'Find a specific element by its ID in the architecture model',\n      input_schema: {\n        type: 'object',\n        properties: {\n          id: {\n            type: 'string',\n            description: 'Element ID to find (format: {layer}-{type}-{kebab-case-name})',\n          },\n        },\n        required: ['id'],\n      },\n    },\n    {\n      name: 'dr_search',\n      description: 'Search for elements by name, description, or ID in the architecture model',\n      input_schema: {\n        type: 'object',\n        properties: {\n          query: {\n            type: 'string',\n            description: 'Search query (searches names, descriptions, and IDs)',\n          },\n          layers: {\n            type: 'array',\n            items: { type: 'string' },\n            description: 'Optional: limit search to specific layers',\n          },\n        },\n        required: ['query'],\n      },\n    },\n    {\n      name: 'dr_trace',\n      description:\n        'Trace dependencies for an element (what depends on it, what it depends on, or both)',\n      input_schema: {\n        type: 'object',\n        properties: {\n          id: {\n            type: 'string',\n            description: 'Element ID to trace dependencies for',\n          },\n          direction: {\n            type: 'string',\n            enum: ['up', 'down', 'both'],\n            description:\n              'Dependency direction: up=dependents, down=dependencies, both=both (default: both)',\n          },\n        },\n        required: ['id'],\n      },\n    },\n  ];\n}\n\n/**\n * Execute a tool and return the result\n * @param toolName Name of the tool to execute\n * @param args Tool arguments\n * @param model The architecture model\n * @returns Tool execution result as JSON\n */\nexport async function executeModelTool(\n  toolName: string,\n  args: Record<string, unknown>,\n  model: Model\n): Promise<any> {\n  switch (toolName) {\n    case 'dr_list':\n      return await executeDrList(args, model);\n\n    case 'dr_find':\n      return await executeDrFind(args, model);\n\n    case 'dr_search':\n      return await executeDrSearch(args, model);\n\n    case 'dr_trace':\n      return await executeDrTrace(args, model);\n\n    default:\n      return { error: `Unknown tool: ${toolName}` };\n  }\n}\n\n/**\n * Execute dr_list tool\n */\nasync function executeDrList(args: Record<string, unknown>, model: Model): Promise<any> {\n  const layerName = args.layer as string;\n  const filterType = args.type as string | undefined;\n\n  if (!layerName) {\n    return { error: 'layer parameter is required' };\n  }\n\n  try {\n    const layer = await model.getLayer(layerName);\n\n    if (!layer) {\n      return {\n        error: `Layer '${layerName}' not found or not loaded`,\n        availableLayers: model.getLayerNames(),\n      };\n    }\n\n    let elements = layer.listElements();\n\n    if (filterType) {\n      elements = elements.filter((e) => e.type === filterType);\n    }\n\n    return {\n      layer: layerName,\n      elementCount: elements.length,\n      elements: elements.map((e) => ({\n        id: e.id,\n        type: e.type,\n        name: e.name,\n        description: e.description || '',\n      })),\n    };\n  } catch (error) {\n    return {\n      error: error instanceof Error ? error.message : String(error),\n    };\n  }\n}\n\n/**\n * Execute dr_find tool\n */\nasync function executeDrFind(args: Record<string, unknown>, model: Model): Promise<any> {\n  const id = args.id as string;\n\n  if (!id) {\n    return { error: 'id parameter is required' };\n  }\n\n  try {\n    // Search through all layers for the element\n    for (const layerName of model.getLayerNames()) {\n      const layer = await model.getLayer(layerName);\n      if (!layer) continue;\n\n      const element = layer.getElement(id);\n      if (element) {\n        return {\n          found: true,\n          element: {\n            id: element.id,\n            type: element.type,\n            name: element.name,\n            description: element.description || '',\n            layer: layerName,\n            properties: element.properties || {},\n          },\n        };\n      }\n    }\n\n    return {\n      found: false,\n      error: `Element with id '${id}' not found`,\n    };\n  } catch (error) {\n    return {\n      error: error instanceof Error ? error.message : String(error),\n    };\n  }\n}\n\n/**\n * Execute dr_search tool\n */\nasync function executeDrSearch(args: Record<string, unknown>, model: Model): Promise<any> {\n  const query = (args.query as string)?.toLowerCase();\n  const layerFilter = (args.layers as string[]) || undefined;\n\n  if (!query) {\n    return { error: 'query parameter is required' };\n  }\n\n  try {\n    const results: any[] = [];\n\n    for (const layerName of model.getLayerNames()) {\n      // Skip if layer is in exclude list\n      if (layerFilter && !layerFilter.includes(layerName)) {\n        continue;\n      }\n\n      const layer = await model.getLayer(layerName);\n      if (!layer) continue;\n\n      const elements = layer.listElements();\n\n      for (const element of elements) {\n        const idMatches = element.id.toLowerCase().includes(query);\n        const nameMatches = element.name.toLowerCase().includes(query);\n        const descMatches =\n          element.description && element.description.toLowerCase().includes(query);\n\n        if (idMatches || nameMatches || descMatches) {\n          results.push({\n            id: element.id,\n            type: element.type,\n            name: element.name,\n            description: element.description || '',\n            layer: layerName,\n            matchReason:\n              idMatches && nameMatches\n                ? 'id and name'\n                : idMatches\n                  ? 'id'\n                  : nameMatches\n                    ? 'name'\n                    : 'description',\n          });\n        }\n      }\n    }\n\n    return {\n      query,\n      resultCount: results.length,\n      results,\n    };\n  } catch (error) {\n    return {\n      error: error instanceof Error ? error.message : String(error),\n    };\n  }\n}\n\n/**\n * Execute dr_trace tool\n */\nasync function executeDrTrace(args: Record<string, unknown>, model: Model): Promise<any> {\n  const id = args.id as string;\n  const direction = (args.direction as string) || 'both';\n\n  if (!id) {\n    return { error: 'id parameter is required' };\n  }\n\n  if (!['up', 'down', 'both'].includes(direction)) {\n    return { error: 'direction must be one of: up, down, both' };\n  }\n\n  try {\n    // Build registry by collecting all references from all loaded layers\n    const registry = new ReferenceRegistry();\n\n    for (const layerName of model.getLayerNames()) {\n      const layer = await model.getLayer(layerName);\n      if (!layer) continue;\n\n      for (const element of layer.listElements()) {\n        registry.registerElement(element);\n      }\n    }\n\n    // Create dependency tracker with registry\n    const tracker = new DependencyTracker(registry);\n\n    const result: any = {\n      id,\n      direction,\n    };\n\n    // Get dependencies (elements this one depends on)\n    if (direction === 'down' || direction === 'both') {\n      try {\n        const dependencies = tracker.traceDependencies(id, TraceDirection.UP, null);\n        result.dependencies = dependencies;\n        result.dependencyCount = dependencies.length;\n      } catch (e) {\n        result.dependencies = [];\n        result.dependencyCount = 0;\n      }\n    }\n\n    // Get dependents (elements that depend on this one)\n    if (direction === 'up' || direction === 'both') {\n      try {\n        const dependents = tracker.traceDependencies(id, TraceDirection.DOWN, null);\n        result.dependents = dependents;\n        result.dependentCount = dependents.length;\n      } catch (e) {\n        result.dependents = [];\n        result.dependentCount = 0;\n      }\n    }\n\n    return result;\n  } catch (error) {\n    return {\n      error: error instanceof Error ? error.message : String(error),\n    };\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}