@documentation-robotics/cli 0.1.8 → 0.1.10

package/dist/import/archimate-importer.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/import/archimate-importer.ts"],
-  "sourcesContent": ["import type { Model } from \"../core/model.js\";\nimport type { Importer, ImportOptions, ImportResult } from \"./types.js\";\nimport type { Span } from \"@opentelemetry/api\";\nimport { isTelemetryEnabled, startSpan, endSpan } from \"../telemetry/index.js\";\nimport { getErrorMessage } from \"../utils/errors.js\";\nimport { DOMParser } from \"@xmldom/xmldom\";\n\n/**\n * ArchiMate XML Importer for layers 1, 2, 4, 5\n * Parses ArchiMate 3.2 XML and creates graph nodes/edges\n */\nexport class ArchiMateImporter implements Importer {\n  name = \"ArchiMate\";\n  supportedFormats = [\"xml\"];\n\n  async import(data: string, model: Model, _options: ImportOptions = {}): Promise<ImportResult> {\n    const span: Span | null = isTelemetryEnabled ? startSpan(\"import.format.archimate\") : null;\n    const result: ImportResult = {\n      success: false,\n      nodesAdded: 0,\n      edgesAdded: 0,\n      errorsCount: 0,\n      errors: [],\n    };\n\n    try {\n      // Validate merge strategy - only 'add' is supported\n      if (_options.mergeStrategy && _options.mergeStrategy !== 'add') {\n        result.errors.push({\n          message: `ArchiMate importer only supports 'add' merge strategy. Requested: '${_options.mergeStrategy}'.`\n        });\n        result.errorsCount++;\n        return result;\n      }\n\n      // Parse XML using @xmldom/xmldom (server-side DOM parser)\n      const parser = new DOMParser();\n      const xmlDoc = parser.parseFromString(data, \"application/xml\");\n\n      if (xmlDoc.getElementsByTagName(\"parsererror\").length > 0) {\n        result.errors.push({ message: \"Failed to parse XML: Invalid XML structure\" });\n        result.errorsCount++;\n        return result;\n      }\n\n      const modelElement = xmlDoc.documentElement;\n      if (modelElement.tagName !== \"model\") {\n        result.errors.push({ message: \"Root element must be 'model'\" });\n        result.errorsCount++;\n        return result;\n      }\n\n      // Parse elements\n      const elementsElement = modelElement.getElementsByTagName(\"elements\")[0];\n      if (!elementsElement) {\n        result.errors.push({ message: \"No elements section found\" });\n        result.errorsCount++;\n        return result;\n      }\n\n      const elementNodes = elementsElement.getElementsByTagName(\"element\");\n      const layerMap = new Map<string, string>(); // id -> layer mapping\n\n      for (let i = 0; i < elementNodes.length; i++) {\n        const elem = elementNodes[i];\n        const id = elem.getAttribute(\"identifier\");\n        const type = elem.getAttribute(\"xsi:type\") || \"Element\";\n        const nameElement = elem.getElementsByTagName(\"name\")[0];\n        const name = nameElement?.textContent || id || \"Unnamed\";\n        const docElement = elem.getElementsByTagName(\"documentation\")[0];\n        const description = docElement?.textContent || undefined;\n\n        if (!id) {\n          result.errors.push({ message: \"Element missing identifier attribute\" });\n          result.errorsCount++;\n          continue;\n        }\n\n        // Infer layer from ArchiMate type\n        const layer = this.inferLayerFromType(type);\n        if (!layer) {\n          result.errors.push({\n            message: `Unable to infer layer for ArchiMate type: ${type}`,\n            element: id,\n          });\n          result.errorsCount++;\n          continue;\n        }\n\n        // Extract properties\n        const properties: Record<string, unknown> = {};\n        const propsElement = elem.getElementsByTagName(\"properties\")[0];\n        if (propsElement) {\n          const propElements = propsElement.getElementsByTagName(\"property\");\n          for (let j = 0; j < propElements.length; j++) {\n            const prop = propElements[j];\n            const key = prop.getAttribute(\"key\");\n            const value = prop.getAttribute(\"value\");\n            if (key && value !== null) {\n              properties[key] = value;\n            }\n          }\n        }\n\n        // Create graph node\n        const graphNode = {\n          id,\n          layer,\n          type: this.mapArchiMateTypeToElementType(type, layer),\n          name,\n          description,\n          properties,\n        };\n\n        model.graph.addNode(graphNode);\n        layerMap.set(id, layer);\n        result.nodesAdded++;\n      }\n\n      // Parse relationships\n      const relationshipsElement = modelElement.getElementsByTagName(\"relationships\")[0];\n      if (relationshipsElement) {\n        const relElements = relationshipsElement.getElementsByTagName(\"relationship\");\n\n        for (let i = 0; i < relElements.length; i++) {\n          const rel = relElements[i];\n          const id = rel.getAttribute(\"identifier\");\n          const source = rel.getAttribute(\"source\");\n          const target = rel.getAttribute(\"target\");\n          const nameElement = rel.getElementsByTagName(\"name\")[0];\n          const predicate = nameElement?.textContent || \"Association\";\n\n          if (!id || !source || !target) {\n            result.errors.push({\n              message: \"Relationship missing required attributes (identifier, source, target)\",\n            });\n            result.errorsCount++;\n            continue;\n          }\n\n          // Verify both nodes exist\n          if (!model.graph.getNode(source) || !model.graph.getNode(target)) {\n            result.errors.push({\n              message: `Relationship references non-existent nodes: ${source} -> ${target}`,\n              element: id,\n            });\n            result.errorsCount++;\n            continue;\n          }\n\n          // Create graph edge\n          const graphEdge = {\n            id,\n            source,\n            destination: target,\n            predicate,\n            properties: {},\n          };\n\n          model.graph.addEdge(graphEdge);\n          result.edgesAdded++;\n        }\n      }\n\n      result.success = result.errorsCount === 0;\n\n      if (isTelemetryEnabled && span) {\n        span.setAttribute(\"import.nodesAdded\", result.nodesAdded);\n        span.setAttribute(\"import.edgesAdded\", result.edgesAdded);\n        span.setAttribute(\"import.errors\", result.errorsCount);\n        span.setStatus({ code: result.success ? 0 : 1 });\n      }\n\n      return result;\n    } catch (error) {\n      result.errors.push({\n        message: getErrorMessage(error),\n      });\n      result.errorsCount++;\n\n      if (isTelemetryEnabled && span) {\n        span.recordException(error as Error);\n        span.setStatus({ code: 2, message: String(error) });\n      }\n\n      return result;\n    } finally {\n      endSpan(span);\n    }\n  }\n\n  /**\n   * Infer layer from ArchiMate element type\n   */\n  private inferLayerFromType(archimateType: string): string | undefined {\n    // Motivation layer types\n    const motivationTypes = [\n      \"Stakeholder\",\n      \"Driver\",\n      \"Assessment\",\n      \"Goal\",\n      \"Outcome\",\n      \"Principle\",\n      \"Requirement\",\n      \"Constraint\",\n    ];\n    if (motivationTypes.includes(archimateType)) return \"motivation\";\n\n    // Business layer types\n    const businessTypes = [\n      \"BusinessActor\",\n      \"BusinessRole\",\n      \"BusinessCollaboration\",\n      \"BusinessInterface\",\n      \"BusinessProcess\",\n      \"BusinessFunction\",\n      \"BusinessInteraction\",\n      \"BusinessEvent\",\n      \"BusinessService\",\n      \"BusinessObject\",\n    ];\n    if (businessTypes.includes(archimateType)) return \"business\";\n\n    // Application layer types\n    const applicationTypes = [\n      \"ApplicationComponent\",\n      \"ApplicationCollaboration\",\n      \"ApplicationInterface\",\n      \"ApplicationFunction\",\n      \"ApplicationInteraction\",\n      \"ApplicationProcess\",\n      \"ApplicationEvent\",\n      \"ApplicationService\",\n      \"DataObject\",\n    ];\n    if (applicationTypes.includes(archimateType)) return \"application\";\n\n    // Technology layer types\n    const technologyTypes = [\n      \"Node\",\n      \"Device\",\n      \"SystemSoftware\",\n      \"TechnologyCollaboration\",\n      \"TechnologyInterface\",\n      \"Path\",\n      \"CommunicationNetwork\",\n      \"TechnologyFunction\",\n      \"TechnologyProcess\",\n      \"TechnologyInteraction\",\n      \"TechnologyEvent\",\n      \"TechnologyService\",\n      \"Artifact\",\n    ];\n    if (technologyTypes.includes(archimateType)) return \"technology\";\n\n    return undefined;\n  }\n\n  /**\n   * Map ArchiMate type to element type (lowercase format)\n   */\n  private mapArchiMateTypeToElementType(archimateType: string, _layer: string): string {\n    // Convert PascalCase to kebab-case\n    const kebabCase = archimateType\n      .replace(/([A-Z])/g, \"-$1\")\n      .toLowerCase()\n      .replace(/^-/, \"\");\n\n    return kebabCase;\n  }\n}\n"],
+  "sourcesContent": ["import type { Model } from \"../core/model.js\";\nimport type { Importer, ImportOptions, ImportResult } from \"./types.js\";\nimport type { Span } from \"@opentelemetry/api\";\nimport { isTelemetryEnabled, startSpan, endSpan } from \"../telemetry/index.js\";\nimport { getErrorMessage } from \"../utils/errors.js\";\nimport { DOMParser } from \"@xmldom/xmldom\";\n\n/**\n * ArchiMate XML Importer for layers 1, 2, 5, 6\n * Parses ArchiMate 3.2 XML and creates graph nodes/edges\n */\nexport class ArchiMateImporter implements Importer {\n  name = \"ArchiMate\";\n  supportedFormats = [\"xml\"];\n\n  async import(data: string, model: Model, _options: ImportOptions = {}): Promise<ImportResult> {\n    const span: Span | null = isTelemetryEnabled ? startSpan(\"import.format.archimate\") : null;\n    const result: ImportResult = {\n      success: false,\n      nodesAdded: 0,\n      edgesAdded: 0,\n      errorsCount: 0,\n      errors: [],\n    };\n\n    try {\n      // Validate merge strategy - only 'add' is supported\n      if (_options.mergeStrategy && _options.mergeStrategy !== 'add') {\n        result.errors.push({\n          message: `ArchiMate importer only supports 'add' merge strategy. Requested: '${_options.mergeStrategy}'.`\n        });\n        result.errorsCount++;\n        return result;\n      }\n\n      // Parse XML using @xmldom/xmldom (server-side DOM parser)\n      const parser = new DOMParser();\n      const xmlDoc = parser.parseFromString(data, \"application/xml\");\n\n      if (xmlDoc.getElementsByTagName(\"parsererror\").length > 0) {\n        result.errors.push({ message: \"Failed to parse XML: Invalid XML structure\" });\n        result.errorsCount++;\n        return result;\n      }\n\n      const modelElement = xmlDoc.documentElement;\n      if (modelElement.tagName !== \"model\") {\n        result.errors.push({ message: \"Root element must be 'model'\" });\n        result.errorsCount++;\n        return result;\n      }\n\n      // Parse elements\n      const elementsElement = modelElement.getElementsByTagName(\"elements\")[0];\n      if (!elementsElement) {\n        result.errors.push({ message: \"No elements section found\" });\n        result.errorsCount++;\n        return result;\n      }\n\n      const elementNodes = elementsElement.getElementsByTagName(\"element\");\n      const layerMap = new Map<string, string>(); // id -> layer mapping\n\n      for (let i = 0; i < elementNodes.length; i++) {\n        const elem = elementNodes[i];\n        const id = elem.getAttribute(\"identifier\");\n        const type = elem.getAttribute(\"xsi:type\") || \"Element\";\n        const nameElement = elem.getElementsByTagName(\"name\")[0];\n        const name = nameElement?.textContent || id || \"Unnamed\";\n        const docElement = elem.getElementsByTagName(\"documentation\")[0];\n        const description = docElement?.textContent || undefined;\n\n        if (!id) {\n          result.errors.push({ message: \"Element missing identifier attribute\" });\n          result.errorsCount++;\n          continue;\n        }\n\n        // Infer layer from ArchiMate type\n        const layer = this.inferLayerFromType(type);\n        if (!layer) {\n          result.errors.push({\n            message: `Unable to infer layer for ArchiMate type: ${type}`,\n            element: id,\n          });\n          result.errorsCount++;\n          continue;\n        }\n\n        // Extract properties\n        const properties: Record<string, unknown> = {};\n        const propsElement = elem.getElementsByTagName(\"properties\")[0];\n        if (propsElement) {\n          const propElements = propsElement.getElementsByTagName(\"property\");\n          for (let j = 0; j < propElements.length; j++) {\n            const prop = propElements[j];\n            const key = prop.getAttribute(\"key\");\n            const value = prop.getAttribute(\"value\");\n            if (key && value !== null) {\n              properties[key] = value;\n            }\n          }\n        }\n\n        // Create graph node\n        const graphNode = {\n          id,\n          layer,\n          type: this.mapArchiMateTypeToElementType(type, layer),\n          name,\n          description,\n          properties,\n        };\n\n        model.graph.addNode(graphNode);\n        layerMap.set(id, layer);\n        result.nodesAdded++;\n      }\n\n      // Parse relationships\n      const relationshipsElement = modelElement.getElementsByTagName(\"relationships\")[0];\n      if (relationshipsElement) {\n        const relElements = relationshipsElement.getElementsByTagName(\"relationship\");\n\n        for (let i = 0; i < relElements.length; i++) {\n          const rel = relElements[i];\n          const id = rel.getAttribute(\"identifier\");\n          const source = rel.getAttribute(\"source\");\n          const target = rel.getAttribute(\"target\");\n          const nameElement = rel.getElementsByTagName(\"name\")[0];\n          const predicate = nameElement?.textContent || \"Association\";\n\n          if (!id || !source || !target) {\n            result.errors.push({\n              message: \"Relationship missing required attributes (identifier, source, target)\",\n            });\n            result.errorsCount++;\n            continue;\n          }\n\n          // Verify both nodes exist\n          if (!model.graph.getNode(source) || !model.graph.getNode(target)) {\n            result.errors.push({\n              message: `Relationship references non-existent nodes: ${source} -> ${target}`,\n              element: id,\n            });\n            result.errorsCount++;\n            continue;\n          }\n\n          // Create graph edge\n          const graphEdge = {\n            id,\n            source,\n            destination: target,\n            predicate,\n            properties: {},\n          };\n\n          model.graph.addEdge(graphEdge);\n          result.edgesAdded++;\n        }\n      }\n\n      result.success = result.errorsCount === 0;\n\n      if (isTelemetryEnabled && span) {\n        span.setAttribute(\"import.nodesAdded\", result.nodesAdded);\n        span.setAttribute(\"import.edgesAdded\", result.edgesAdded);\n        span.setAttribute(\"import.errors\", result.errorsCount);\n        span.setStatus({ code: result.success ? 0 : 1 });\n      }\n\n      return result;\n    } catch (error) {\n      result.errors.push({\n        message: getErrorMessage(error),\n      });\n      result.errorsCount++;\n\n      if (isTelemetryEnabled && span) {\n        span.recordException(error as Error);\n        span.setStatus({ code: 2, message: String(error) });\n      }\n\n      return result;\n    } finally {\n      endSpan(span);\n    }\n  }\n\n  /**\n   * Infer layer from ArchiMate element type\n   */\n  private inferLayerFromType(archimateType: string): string | undefined {\n    // Motivation layer types\n    const motivationTypes = [\n      \"Stakeholder\",\n      \"Driver\",\n      \"Assessment\",\n      \"Goal\",\n      \"Outcome\",\n      \"Principle\",\n      \"Requirement\",\n      \"Constraint\",\n    ];\n    if (motivationTypes.includes(archimateType)) return \"motivation\";\n\n    // Business layer types\n    const businessTypes = [\n      \"BusinessActor\",\n      \"BusinessRole\",\n      \"BusinessCollaboration\",\n      \"BusinessInterface\",\n      \"BusinessProcess\",\n      \"BusinessFunction\",\n      \"BusinessInteraction\",\n      \"BusinessEvent\",\n      \"BusinessService\",\n      \"BusinessObject\",\n    ];\n    if (businessTypes.includes(archimateType)) return \"business\";\n\n    // Application layer types\n    const applicationTypes = [\n      \"ApplicationComponent\",\n      \"ApplicationCollaboration\",\n      \"ApplicationInterface\",\n      \"ApplicationFunction\",\n      \"ApplicationInteraction\",\n      \"ApplicationProcess\",\n      \"ApplicationEvent\",\n      \"ApplicationService\",\n      \"DataObject\",\n    ];\n    if (applicationTypes.includes(archimateType)) return \"application\";\n\n    // Technology layer types\n    const technologyTypes = [\n      \"Node\",\n      \"Device\",\n      \"SystemSoftware\",\n      \"TechnologyCollaboration\",\n      \"TechnologyInterface\",\n      \"Path\",\n      \"CommunicationNetwork\",\n      \"TechnologyFunction\",\n      \"TechnologyProcess\",\n      \"TechnologyInteraction\",\n      \"TechnologyEvent\",\n      \"TechnologyService\",\n      \"Artifact\",\n    ];\n    if (technologyTypes.includes(archimateType)) return \"technology\";\n\n    return undefined;\n  }\n\n  /**\n   * Map ArchiMate type to element type (lowercase format)\n   */\n  private mapArchiMateTypeToElementType(archimateType: string, _layer: string): string {\n    // Convert PascalCase to kebab-case\n    const kebabCase = archimateType\n      .replace(/([A-Z])/g, \"-$1\")\n      .toLowerCase()\n      .replace(/^-/, \"\");\n\n    return kebabCase;\n  }\n}\n"],
   "mappings": "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",
   "names": []
 }

package/dist/import/openapi-importer.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/import/openapi-importer.ts"],
-  "sourcesContent": ["import type { Model } from \"../core/model.js\";\nimport type { Importer, ImportOptions, ImportResult } from \"./types.js\";\nimport type { Span } from \"@opentelemetry/api\";\nimport { isTelemetryEnabled, startSpan, endSpan } from \"../telemetry/index.js\";\nimport { getErrorMessage } from \"../utils/errors.js\";\n\n/**\n * OpenAPI 3.0 Importer for layer 6 (API)\n * Parses OpenAPI JSON specifications and creates graph nodes/edges\n */\nexport class OpenAPIImporter implements Importer {\n  name = \"OpenAPI\";\n  supportedFormats = [\"json\"];\n\n  async import(data: string, model: Model, _options: ImportOptions = {}): Promise<ImportResult> {\n    const span: Span | null = isTelemetryEnabled ? startSpan(\"import.format.openapi\") : null;\n    const result: ImportResult = {\n      success: false,\n      nodesAdded: 0,\n      edgesAdded: 0,\n      errorsCount: 0,\n      errors: [],\n    };\n\n    try {\n      // Validate merge strategy - only 'add' is supported\n      if (_options.mergeStrategy && _options.mergeStrategy !== 'add') {\n        result.errors.push({\n          message: `OpenAPI importer only supports 'add' merge strategy. Requested: '${_options.mergeStrategy}'.`\n        });\n        result.errorsCount++;\n        return result;\n      }\n\n      // Parse JSON specification\n      let spec: any;\n      try {\n        spec = JSON.parse(data);\n      } catch (e) {\n        result.errors.push({\n          message: \"Failed to parse OpenAPI specification: Invalid JSON\",\n        });\n        result.errorsCount++;\n        return result;\n      }\n\n      if (!spec.openapi && !spec.swagger) {\n        result.errors.push({\n          message: \"Not a valid OpenAPI specification (missing openapi or swagger field)\",\n        });\n        result.errorsCount++;\n        return result;\n      }\n\n      // Create root document node with unique ID based on spec title\n      const titlePart = (spec.info?.title || \"api\")\n        .toLowerCase()\n        .replace(/[^a-z0-9]+/g, \"-\")\n        .replace(/^-|-$/g, \"\");\n      const docNodeId = `api.openapi-document.${titlePart}`;\n      const docNode = {\n        id: docNodeId,\n        layer: \"api\",\n        type: \"openapi-document\",\n        name: spec.info?.title || \"OpenAPI Document\",\n        description: spec.info?.description,\n        properties: {\n          version: spec.info?.version || \"1.0.0\",\n          servers: spec.servers || [],\n          info: spec.info || {},\n        },\n      };\n\n      model.graph.addNode(docNode);\n      result.nodesAdded++;\n\n      // Create endpoint nodes from paths\n      if (spec.paths) {\n        const pathEntries = Object.entries(spec.paths);\n        for (const [pathName, pathSpec] of pathEntries) {\n          const pathSpec_ = pathSpec as Record<string, any>;\n          const methods = Object.keys(pathSpec_).filter((k) =>\n            [\"get\", \"post\", \"put\", \"delete\", \"patch\", \"head\", \"options\"].includes(k)\n          );\n\n          for (const method of methods) {\n            const operation = pathSpec_[method];\n            const operationId =\n              operation.operationId || `${method}-${pathName}`.replace(/[^a-zA-Z0-9-]/g, \"-\");\n            const endpointId = `api.endpoint.${operationId}`;\n\n            // Create endpoint node\n            const endpointNode = {\n              id: endpointId,\n              layer: \"api\",\n              type: \"endpoint\",\n              name: operation.summary || `${method.toUpperCase()} ${pathName}`,\n              description: operation.description,\n              properties: {\n                method: method.toUpperCase(),\n                path: pathName,\n                tags: operation.tags || [],\n                parameters: operation.parameters || [],\n                requestBody: operation.requestBody,\n                responses: operation.responses || {},\n                security: operation.security,\n                deprecated: operation.deprecated || false,\n              },\n            };\n\n            model.graph.addNode(endpointNode);\n            result.nodesAdded++;\n\n            // Create edge from document to endpoint\n            const docEdge = {\n              id: `${docNodeId}-composes-${endpointId}`,\n              source: docNodeId,\n              destination: endpointId,\n              predicate: \"composes\",\n              properties: {},\n            };\n\n            model.graph.addEdge(docEdge);\n            result.edgesAdded++;\n          }\n        }\n      }\n\n      // Create schema nodes from components.schemas\n      if (spec.components?.schemas) {\n        const schemaEntries = Object.entries(spec.components.schemas);\n        for (const [schemaName, schemaSpec] of schemaEntries) {\n          const schemaId = `api.schema.${schemaName}`;\n\n          const schemaNode = {\n            id: schemaId,\n            layer: \"api\",\n            type: \"schema\",\n            name: schemaName,\n            description: (schemaSpec as Record<string, any>).description,\n            properties: {\n              schemaName,\n              schema: schemaSpec,\n            },\n          };\n\n          model.graph.addNode(schemaNode);\n          result.nodesAdded++;\n\n          // Create edge from document to schema\n          const schemaEdge = {\n            id: `${docNodeId}-contains-${schemaId}`,\n            source: docNodeId,\n            destination: schemaId,\n            predicate: \"contains\",\n            properties: {},\n          };\n\n          model.graph.addEdge(schemaEdge);\n          result.edgesAdded++;\n        }\n      }\n\n      // Create security scheme nodes from components.securitySchemes\n      if (spec.components?.securitySchemes) {\n        const schemeEntries = Object.entries(spec.components.securitySchemes);\n        for (const [schemeName, schemeSpec] of schemeEntries) {\n          const schemeId = `api.security-scheme.${schemeName}`;\n          const schemeSpec_ = schemeSpec as Record<string, any>;\n\n          const securityNode = {\n            id: schemeId,\n            layer: \"api\",\n            type: \"security-scheme\",\n            name: schemeName,\n            description: schemeSpec_.description,\n            properties: {\n              type: schemeSpec_.type,\n              scheme: schemeSpec_.scheme,\n              bearerFormat: schemeSpec_.bearerFormat,\n              flows: schemeSpec_.flows,\n              openIdConnectUrl: schemeSpec_.openIdConnectUrl,\n            },\n          };\n\n          model.graph.addNode(securityNode);\n          result.nodesAdded++;\n\n          // Create edge from document to security scheme\n          const secEdge = {\n            id: `${docNodeId}-uses-${schemeId}`,\n            source: docNodeId,\n            destination: schemeId,\n            predicate: \"uses\",\n            properties: {},\n          };\n\n          model.graph.addEdge(secEdge);\n          result.edgesAdded++;\n        }\n      }\n\n      result.success = result.errorsCount === 0;\n\n      if (isTelemetryEnabled && span) {\n        span.setAttribute(\"import.nodesAdded\", result.nodesAdded);\n        span.setAttribute(\"import.edgesAdded\", result.edgesAdded);\n        span.setAttribute(\"import.errors\", result.errorsCount);\n        span.setStatus({ code: result.success ? 0 : 1 });\n      }\n\n      return result;\n    } catch (error) {\n      result.errors.push({\n        message: getErrorMessage(error),\n      });\n      result.errorsCount++;\n\n      if (isTelemetryEnabled && span) {\n        span.recordException(error as Error);\n        span.setStatus({ code: 2, message: String(error) });\n      }\n\n      return result;\n    } finally {\n      endSpan(span);\n    }\n  }\n}\n"],
+  "sourcesContent": ["import type { Model } from \"../core/model.js\";\nimport type { Importer, ImportOptions, ImportResult } from \"./types.js\";\nimport type { Span } from \"@opentelemetry/api\";\nimport { isTelemetryEnabled, startSpan, endSpan } from \"../telemetry/index.js\";\nimport { getErrorMessage } from \"../utils/errors.js\";\n\n/**\n * OpenAPI 3.0 Importer for layer 7 (API)\n * Parses OpenAPI JSON specifications and creates graph nodes/edges\n */\nexport class OpenAPIImporter implements Importer {\n  name = \"OpenAPI\";\n  supportedFormats = [\"json\"];\n\n  async import(data: string, model: Model, _options: ImportOptions = {}): Promise<ImportResult> {\n    const span: Span | null = isTelemetryEnabled ? startSpan(\"import.format.openapi\") : null;\n    const result: ImportResult = {\n      success: false,\n      nodesAdded: 0,\n      edgesAdded: 0,\n      errorsCount: 0,\n      errors: [],\n    };\n\n    try {\n      // Validate merge strategy - only 'add' is supported\n      if (_options.mergeStrategy && _options.mergeStrategy !== 'add') {\n        result.errors.push({\n          message: `OpenAPI importer only supports 'add' merge strategy. Requested: '${_options.mergeStrategy}'.`\n        });\n        result.errorsCount++;\n        return result;\n      }\n\n      // Parse JSON specification\n      let spec: any;\n      try {\n        spec = JSON.parse(data);\n      } catch (e) {\n        result.errors.push({\n          message: \"Failed to parse OpenAPI specification: Invalid JSON\",\n        });\n        result.errorsCount++;\n        return result;\n      }\n\n      if (!spec.openapi && !spec.swagger) {\n        result.errors.push({\n          message: \"Not a valid OpenAPI specification (missing openapi or swagger field)\",\n        });\n        result.errorsCount++;\n        return result;\n      }\n\n      // Create root document node with unique ID based on spec title\n      const titlePart = (spec.info?.title || \"api\")\n        .toLowerCase()\n        .replace(/[^a-z0-9]+/g, \"-\")\n        .replace(/^-|-$/g, \"\");\n      const docNodeId = `api.openapi-document.${titlePart}`;\n      const docNode = {\n        id: docNodeId,\n        layer: \"api\",\n        type: \"openapi-document\",\n        name: spec.info?.title || \"OpenAPI Document\",\n        description: spec.info?.description,\n        properties: {\n          version: spec.info?.version || \"1.0.0\",\n          servers: spec.servers || [],\n          info: spec.info || {},\n        },\n      };\n\n      model.graph.addNode(docNode);\n      result.nodesAdded++;\n\n      // Create endpoint nodes from paths\n      if (spec.paths) {\n        const pathEntries = Object.entries(spec.paths);\n        for (const [pathName, pathSpec] of pathEntries) {\n          const pathSpec_ = pathSpec as Record<string, any>;\n          const methods = Object.keys(pathSpec_).filter((k) =>\n            [\"get\", \"post\", \"put\", \"delete\", \"patch\", \"head\", \"options\"].includes(k)\n          );\n\n          for (const method of methods) {\n            const operation = pathSpec_[method];\n            const operationId =\n              operation.operationId || `${method}-${pathName}`.replace(/[^a-zA-Z0-9-]/g, \"-\");\n            const endpointId = `api.endpoint.${operationId}`;\n\n            // Create endpoint node\n            const endpointNode = {\n              id: endpointId,\n              layer: \"api\",\n              type: \"endpoint\",\n              name: operation.summary || `${method.toUpperCase()} ${pathName}`,\n              description: operation.description,\n              properties: {\n                method: method.toUpperCase(),\n                path: pathName,\n                tags: operation.tags || [],\n                parameters: operation.parameters || [],\n                requestBody: operation.requestBody,\n                responses: operation.responses || {},\n                security: operation.security,\n                deprecated: operation.deprecated || false,\n              },\n            };\n\n            model.graph.addNode(endpointNode);\n            result.nodesAdded++;\n\n            // Create edge from document to endpoint\n            const docEdge = {\n              id: `${docNodeId}-composes-${endpointId}`,\n              source: docNodeId,\n              destination: endpointId,\n              predicate: \"composes\",\n              properties: {},\n            };\n\n            model.graph.addEdge(docEdge);\n            result.edgesAdded++;\n          }\n        }\n      }\n\n      // Create schema nodes from components.schemas\n      if (spec.components?.schemas) {\n        const schemaEntries = Object.entries(spec.components.schemas);\n        for (const [schemaName, schemaSpec] of schemaEntries) {\n          const schemaId = `api.schema.${schemaName}`;\n\n          const schemaNode = {\n            id: schemaId,\n            layer: \"api\",\n            type: \"schema\",\n            name: schemaName,\n            description: (schemaSpec as Record<string, any>).description,\n            properties: {\n              schemaName,\n              schema: schemaSpec,\n            },\n          };\n\n          model.graph.addNode(schemaNode);\n          result.nodesAdded++;\n\n          // Create edge from document to schema\n          const schemaEdge = {\n            id: `${docNodeId}-contains-${schemaId}`,\n            source: docNodeId,\n            destination: schemaId,\n            predicate: \"contains\",\n            properties: {},\n          };\n\n          model.graph.addEdge(schemaEdge);\n          result.edgesAdded++;\n        }\n      }\n\n      // Create security scheme nodes from components.securitySchemes\n      if (spec.components?.securitySchemes) {\n        const schemeEntries = Object.entries(spec.components.securitySchemes);\n        for (const [schemeName, schemeSpec] of schemeEntries) {\n          const schemeId = `api.security-scheme.${schemeName}`;\n          const schemeSpec_ = schemeSpec as Record<string, any>;\n\n          const securityNode = {\n            id: schemeId,\n            layer: \"api\",\n            type: \"security-scheme\",\n            name: schemeName,\n            description: schemeSpec_.description,\n            properties: {\n              type: schemeSpec_.type,\n              scheme: schemeSpec_.scheme,\n              bearerFormat: schemeSpec_.bearerFormat,\n              flows: schemeSpec_.flows,\n              openIdConnectUrl: schemeSpec_.openIdConnectUrl,\n            },\n          };\n\n          model.graph.addNode(securityNode);\n          result.nodesAdded++;\n\n          // Create edge from document to security scheme\n          const secEdge = {\n            id: `${docNodeId}-uses-${schemeId}`,\n            source: docNodeId,\n            destination: schemeId,\n            predicate: \"uses\",\n            properties: {},\n          };\n\n          model.graph.addEdge(secEdge);\n          result.edgesAdded++;\n        }\n      }\n\n      result.success = result.errorsCount === 0;\n\n      if (isTelemetryEnabled && span) {\n        span.setAttribute(\"import.nodesAdded\", result.nodesAdded);\n        span.setAttribute(\"import.edgesAdded\", result.edgesAdded);\n        span.setAttribute(\"import.errors\", result.errorsCount);\n        span.setStatus({ code: result.success ? 0 : 1 });\n      }\n\n      return result;\n    } catch (error) {\n      result.errors.push({\n        message: getErrorMessage(error),\n      });\n      result.errorsCount++;\n\n      if (isTelemetryEnabled && span) {\n        span.recordException(error as Error);\n        span.setStatus({ code: 2, message: String(error) });\n      }\n\n      return result;\n    } finally {\n      endSpan(span);\n    }\n  }\n}\n"],
   "mappings": "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",
   "names": []
 }

package/dist/integrations/claude_code/agents/dr-advisor.md

@@ -19,7 +19,7 @@ You are an expert advisor for **Documentation Robotics** end users, specializing
    - Best practices for naming, organization, and structure
 
 2. **Concept Explanation**: Provide clear explanations of:
-   - The 12-layer architecture and what each layer represents
+   - The 13-layer architecture and what each layer represents
    - Cross-layer relationship patterns (A, B, C, D)
    - Intra-layer relationship types (34 semantic predicates)
    - The purpose and benefits of changesets
@@ -99,7 +99,7 @@ You are an expert advisor for **Documentation Robotics** end users, specializing
 
 **Be Precise**: Use correct DR terminology
 
-- 12 layers, not "tiers" or "levels"
+- 13 layers, not "tiers" or "levels"
 - "Relationships" not "links" (post-v0.8.2)
 - Specific entity types (not generic terms)
 - Correct field names and formats
@@ -119,21 +119,22 @@ You are an expert advisor for **Documentation Robotics** end users, specializing
 
 ## Key Knowledge Areas
 
-### The 12-Layer Architecture
+### The 13-Layer Architecture
 
 ```
 01. Motivation     - Goals, principles, requirements, constraints (WHY)
 02. Business       - Capabilities, processes, services, actors (WHAT)
-03. Security       - Roles, policies, threats, controls (WHO/PROTECTION)
-04. Application    - Components, services, interfaces (HOW)
-05. Technology     - Platforms, frameworks, infrastructure (WITH)
-06. API            - OpenAPI 3.0.3 specifications (CONTRACTS)
-07. Data Model     - JSON Schema Draft 7 structures (STRUCTURE)
-08. Data Store      - SQL DDL persistence (STORAGE)
-09. UX             - Three-Tier UI architecture (EXPERIENCE)
-10. Navigation     - Multi-modal routing (FLOW)
-11. APM            - OpenTelemetry observability (MONITORING)
-12. Testing        - ISP coverage model (VERIFICATION)
+03. Product        - Personas, capabilities, features, workflows, milestones (PRODUCT)
+04. Security       - Roles, policies, threats, controls (WHO/PROTECTION)
+05. Application    - Components, services, interfaces (HOW)
+06. Technology     - Platforms, frameworks, infrastructure (WITH)
+07. API            - OpenAPI 3.0.3 specifications (CONTRACTS)
+08. Data Model     - JSON Schema Draft 7 structures (STRUCTURE)
+09. Data Store      - SQL DDL persistence (STORAGE)
+10. UX             - Three-Tier UI architecture (EXPERIENCE)
+11. Navigation     - Multi-modal routing (FLOW)
+12. APM            - OpenTelemetry observability (MONITORING)
+13. Testing        - ISP coverage model (VERIFICATION)
 ```
 
 ### Cross-Layer Relationship Patterns

package/dist/integrations/claude_code/agents/dr-extractor.md

@@ -1,6 +1,6 @@
 ---
 name: dr-extractor
-description: Specialized extraction agent for Documentation Robotics model creation from codebases. Analyzes source code to identify architectural elements across all 12 layers with mandatory source provenance tracking.
+description: Specialized extraction agent for Documentation Robotics model creation from codebases. Analyzes source code to identify architectural elements across all 13 layers with mandatory source provenance tracking.
 tools: Bash, Read, Glob, Grep
 ---
 
@@ -10,7 +10,7 @@ tools: Bash, Read, Glob, Grep
 
 You are the **DR Extractor** — a code analysis specialist focused exclusively on extracting architectural elements from codebases and creating Documentation Robotics model entries. You operate entirely through the `dr add` command line interface, never creating YAML or JSON directly.
 
-**Your sole responsibility**: Analyze source code, identify architectural elements (services, components, endpoints, data models, etc.) across all 12 DR layers, and add them to the model using `dr add` commands with complete source provenance.
+**Your sole responsibility**: Analyze source code, identify architectural elements (services, components, endpoints, data models, etc.) across all 13 DR layers, and add them to the model using `dr add` commands with complete source provenance.
 
 **Critical constraint**: Every element you create must include source file references, symbol mappings, and provenance type (extracted vs. inferred). This traceability is not optional — it enables drift detection, validation, and future synchronization between code and model.
 

package/dist/integrations/claude_code/commands/dr-info.md

@@ -12,7 +12,7 @@ Show an overview of the Documentation Robotics model: project metadata, layer na
 Displays:
 
 - Project name, version, spec version, author, description
-- List of all 12 layers with their element counts
+- List of all 13 layers with their element counts
 - With `--layer <name>`: detailed view of a single layer
 - With `--layer <name> --verbose`: per-type breakdown within that layer
 

package/dist/integrations/claude_code/commands/dr-init.md

@@ -12,7 +12,7 @@ Initialize a new Documentation Robotics architecture model in the current projec
 1. Checks if a DR model already exists in the current directory
 2. Prompts for project information (if not provided)
 3. Runs `dr init` to create the model structure
-4. Creates the 12-layer directory structure
+4. Creates the 13-layer directory structure
 5. Initializes manifest, config, and projection rules
 6. Installs Claude Code integration files (if not already present)
 7. Provides next steps and guidance
@@ -60,7 +60,7 @@ Otherwise, ask the user for:
    - No: Creates empty layer directories
 
 3. **Template** (optional, default: basic)
-   - basic: Standard 12-layer structure
+   - basic: Standard 13-layer structure
    - minimal: Essential layers only
    - full: Includes examples and documentation
 
@@ -79,7 +79,7 @@ Examples:
 dr init --name "My Project"
 
 # With description
-dr init --name "My Project" --description "12-layer federated architecture model"
+dr init --name "My Project" --description "13-layer federated architecture model"
 
 # With author
 dr init --name "My Project" --author "Team A"

package/dist/integrations/claude_code/commands/dr-map.md

@@ -18,7 +18,7 @@ Analyze an existing codebase and automatically generate a Documentation Robotics
 
 ## Two Modes: Recipe vs. Targeted
 
-**Recipe Mode** (default for new/empty models): Extracts all 12 layers in a prescribed bottom-up order with validation checkpoints between each layer. Best for building a complete model from scratch — ensures no layers are skipped and lower layers (infrastructure, data) are populated before higher layers (business, motivation) are inferred.
+**Recipe Mode** (default for new/empty models): Extracts all 13 layers in a prescribed bottom-up order with validation checkpoints between each layer. Best for building a complete model from scratch — ensures no layers are skipped and lower layers (infrastructure, data) are populated before higher layers (business, motivation) are inferred.
 
 **Targeted Mode** (default if `--layers` is specified or model has existing elements): Extracts specific layers without step-by-step checkpoints. Best for focused extraction or incremental additions to an existing model.
 
@@ -59,7 +59,7 @@ I see this is a new model with no existing elements.
 
 I can extract in two ways:
 
-1. Recipe Mode (recommended) — Walks through all 12 layers in the correct
+1. Recipe Mode (recommended) — Walks through all 13 layers in the correct
    architectural order, with checkpoints to review and validate each layer
    before proceeding. Takes longer but produces a complete, well-structured model.
 

package/dist/integrations/claude_code/commands/dr-model.md

@@ -1,5 +1,5 @@
 ---
-description: Use natural language to add, update, or query architecture model elements across all 12 layers
+description: Use natural language to add, update, or query architecture model elements across all 13 layers
 argument-hint: "<natural language request>"
 ---
 

package/dist/integrations/claude_code/commands/dr-relate.md

@@ -170,8 +170,15 @@ dr validate --orphans --output orphans.json
         "type": "api.operation",
         "status": "connectable",
         "reachablePredicates": ["realizes", "references"],
-        "reachableTargetTypes": ["application.applicationfunction", "application.applicationservice"],
-        "needsTypes": ["application.applicationfunction", "application.applicationservice", "business.businessprocess"]
+        "reachableTargetTypes": [
+          "application.applicationfunction",
+          "application.applicationservice"
+        ],
+        "needsTypes": [
+          "application.applicationfunction",
+          "application.applicationservice",
+          "business.businessprocess"
+        ]
       },
       {
         "id": "api.info.x",
@@ -189,7 +196,10 @@ dr validate --orphans --output orphans.json
         "status": "connectable",
         "reachablePredicates": ["serves", "accesses"],
         "reachableTargetTypes": ["application.applicationservice"],
-        "needsTypes": ["application.applicationservice", "data-store.collection"]
+        "needsTypes": [
+          "application.applicationservice",
+          "data-store.collection"
+        ]
       }
     ]
   }
@@ -252,7 +262,7 @@ Or per layer if a global list is unavailable:
 ```bash
 dr list motivation --json
 dr list business --json
-# ... repeat for all 12 layers
+# ... repeat for all 13 layers
 ```
 
 Build a table of populated layers — layers with at least 1 element:

package/dist/integrations/claude_code/docs/END_TO_END_WALKTHROUGH.md

@@ -110,7 +110,7 @@ dr init my-awesome-api
 **What was created:**
 
 - `documentation-robotics/model/manifest.yaml` — Project metadata
-- `documentation-robotics/model/{NN}_{layer-name}/` — Empty layer directories for all 12 layers (e.g., `01_motivation/`, `02_business/`, ..., `12_testing/`)
+- `documentation-robotics/model/{NN}_{layer-name}/` — Empty layer directories for all 13 layers (e.g., `01_motivation/`, `02_business/`, `03_product/`, ..., `13_testing/`)
 - `.dr/` — Local DR configuration directory
 
 (Use `--verbose` to see additional details about the model setup)
@@ -285,7 +285,7 @@ I see this is a new model with no existing elements.
 I can extract in two ways:
 
 1. Recipe Mode (recommended)
-   Walks through all 12 layers in the correct architectural order,
+   Walks through all 13 layers in the correct architectural order,
    with checkpoints to review and validate each layer before proceeding.
    Takes longer but produces a complete, well-structured model.
 
@@ -748,7 +748,7 @@ dr analyzer index             # Index the codebase (~2 minutes)
 /dr-map ./src --tech "Python FastAPI PostgreSQL"
 
 # At prompt: Select Recipe Mode
-# Work through all 12 layers, validating at each checkpoint
+# Work through all 13 layers, validating at each checkpoint
 # Take ~5-10 minutes to complete
 
 # Step 4: Verify alignment

package/dist/integrations/claude_code/docs/QUICK_START.md

@@ -175,7 +175,7 @@ dr analyzer index
 /dr-verify               # Answer prompts interactively
 ```
 
-**Pro tip:** Recipe Mode walks you through all 12 layers with checkpoints. Most thorough approach.
+**Pro tip:** Recipe Mode walks you through all 13 layers with checkpoints. Most thorough approach.
 
 ---
 

package/dist/integrations/claude_code/docs/README.md

@@ -72,7 +72,7 @@ The comprehensive manual walkthrough covering every step from fresh project thro
 ### Skills & Agents
 
 - **[dr-codebase-memory/SKILL.md](../skills/dr_codebase_memory/SKILL.md)** — Codebase memory and context management
-- Layer-specific skills (Layer 1-12)
+- Layer-specific skills (Layer 1-13)
 
 ---
 
@@ -160,7 +160,7 @@ integrations/claude_code/
 ├── skills/                      ← Specialized knowledge modules
 │   ├── dr_codebase_memory/
 │   ├── dr_01_motivation_layer/
-│   ├── ... (all 12 layers)
+│   ├── ... (all 13 layers)
 │   └── dr_engineering_guide/
 │
 └── agents/                      ← Specialized agents

package/dist/integrations/claude_code/skills/dr_01_motivation_layer/SKILL.md

@@ -27,7 +27,7 @@ version: 0.8.3
 
 ## Layer Overview
 
-The Motivation Layer is the **highest layer** in the 12-layer architecture and provides governance to all other layers. It describes:
+The Motivation Layer is the **highest layer** in the 13-layer architecture and provides governance to all other layers. It describes:
 
 - **WHY** - The reasons and drivers behind architectural decisions
 - **WHO** - Stakeholders with interests in the outcome
@@ -165,7 +165,7 @@ IS this a semantic definition, interpretation, or piece of knowledge attached to
 | **Layer 4 (Application)** | ApplicationService supports Goals, delivers Value, governed by Principles; ApplicationFunction fulfills Requirements              |
 | **Layer 5 (Technology)**  | TechnologyService supports Goals, governed by Principles; Node fulfills Requirements, constrained by Constraints                  |
 | **Layer 6 (API)**         | Operation supports Goals (x-supports-goals), fulfills Requirements, governed by Principles, constrained by Constraints            |
-| **Layer 7-12**            | All layers can reference Principles, Constraints, Requirements, Goals for governance and traceability                             |
+| **Layer 7-13**            | All layers can reference Principles, Constraints, Requirements, Goals for governance and traceability                             |
 
 **Design Pattern:** Lower layers "look up" to the Motivation layer to justify WHY they exist and WHAT value they deliver.