@documentation-robotics/cli 0.1.0 → 0.1.7

package/dist/core/report-data-model.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/core/report-data-model.ts"],
+  "sourcesContent": ["/**\n * ReportDataModel - Unified reporting interface for architecture models\n *\n * Combines statistics collection, relationship classification, and data model analysis\n * to provide comprehensive insights into architecture model structure, quality, and completeness.\n */\n\nimport { Model } from \"./model.js\";\nimport { StatsCollector, ModelStats } from \"./stats-collector.js\";\nimport { RelationshipCatalog, RelationshipType, type Directionality } from \"./relationship-catalog.js\";\nimport { getLayerOrder } from \"./layers.js\";\nimport type { Relationship } from \"../types/index.js\";\n\n/**\n * Relationship with semantic classification metadata\n */\nexport interface ClassifiedRelationship {\n  id: string;\n  source: string; // Element ID\n  target: string; // Element ID\n  predicate: string;\n\n  // Classification\n  category: string; // e.g., \"structural\", \"behavioral\", \"dependency\"\n  archimateAlignment: string | null;\n\n  // Semantic properties\n  directionality: Directionality;\n  transitivity: boolean;\n  symmetry: boolean;\n  reflexivity?: boolean;\n\n  // Analysis\n  sourceLayer: string;\n  targetLayer: string;\n  isCrossLayer: boolean;\n  isSpecCompliant: boolean;\n}\n\n/**\n * Data model entity (Layer 7 specific)\n */\nexport interface DataModelEntity {\n  id: string;\n  name: string;\n  layer: string;\n  attributes: string[];\n  relatedEntities: string[];\n  isReferenced: boolean; // Referenced from other layers\n}\n\n/**\n * Data model layer specific insights\n *\n * Coverage metrics are percentages (0-100) representing data model completeness:\n * - entityCoverage: Percentage of entities referenced from higher layers\n * - attributeCoverage: Percentage of attributes populated across entities\n */\nexport interface DataModelInsights {\n  entityCount: number;\n  attributeCount: number;\n  relationshipCount: number;\n  entities: DataModelEntity[];\n\n  // Coverage metrics\n  entityCoverage: number;\n  attributeCoverage: number;\n\n  // Complexity\n  avgAttributesPerEntity: number;\n  maxAttributesPerEntity: number;\n  avgRelationshipsPerEntity: number;\n\n  // Quality\n  referencedEntities: number; // Entities referenced from higher layers\n  orphanedEntities: string[];\n}\n\n/**\n * Relationship analysis results\n */\nexport interface RelationshipAnalysis {\n  totalRelationships: number;\n  classified: ClassifiedRelationship[];\n  byCategory: Record<string, number>;\n  byPredicate: Record<string, number>;\n  crossLayerCount: number;\n  intraLayerCount: number;\n  circularDependencies: CircularPath[];\n}\n\n/**\n * Circular dependency detection result\n */\nexport interface CircularPath {\n  elements: string[];\n  predicates: string[];\n  pathLength: number;\n}\n\n/**\n * Quality metrics for the model\n *\n * Percentages (0-100) represent quality metrics:\n * - Coverage metrics (elementCoverage, relationshipCoverage, documentationCoverage, archimateCompliance, specCompliance, semanticConsistency):\n *   Express completeness or compliance as percentages\n * - Composition metrics (crossLayerReferenceHealth):\n *   Descriptive ratio of cross-layer to total relationships (not a quality indicator)\n * - Structural metrics (orphanedElements, circularDependencies):\n *   Count of problematic elements\n * - Compliance metrics (layerComplianceScore):\n *   Percentage of relationships following higher\u2192lower layer rule\n */\nexport interface QualityMetrics {\n  // Coverage\n  elementCoverage: number;\n  relationshipCoverage: number;\n  documentationCoverage: number;\n  layerCoverage: number;\n\n  // Structural quality\n  orphanedElements: number;\n  circularDependencies: number;\n\n  // Semantic quality\n  archimateCompliance: number;\n  specCompliance: number;\n  semanticConsistency: number;\n\n  // Layering quality\n  crossLayerReferenceHealth: number;\n  layerComplianceScore: number;\n}\n\n/**\n * Complete report containing statistics, relationships, data model insights, and quality metrics\n */\nexport interface ReportData {\n  timestamp: string;\n  statistics: ModelStats;\n  relationships: RelationshipAnalysis;\n  dataModel: DataModelInsights;\n  quality: QualityMetrics;\n}\n\n/**\n * Factory function to create a ClassifiedRelationship with enforced invariants\n *\n * Ensures that `isCrossLayer` correctly reflects whether sourceLayer !== targetLayer.\n * This prevents accidental bugs where the invariant could be violated.\n */\nexport function createClassifiedRelationship(\n  rel: Omit<ClassifiedRelationship, \"isCrossLayer\" | \"sourceLayer\" | \"targetLayer\">,\n  sourceLayer: string,\n  targetLayer: string\n): ClassifiedRelationship {\n  return {\n    ...rel,\n    sourceLayer,\n    targetLayer,\n    isCrossLayer: sourceLayer !== targetLayer,\n  };\n}\n\n/**\n * ReportDataModel class - Unified reporting interface\n */\nexport class ReportDataModel {\n  private model: Model;\n  private statsCollector: StatsCollector;\n  private relationshipCatalog: RelationshipCatalog;\n\n  private cachedStats: ModelStats | null = null;\n  private cachedRelationships: RelationshipAnalysis | null = null;\n  private cachedDataModel: DataModelInsights | null = null;\n  private cachedQuality: QualityMetrics | null = null;\n  private cachedReport: ReportData | null = null;\n\n  private relationshipTypeMap: Map<string, RelationshipType> = new Map();\n  private catalogLoaded = false;\n\n  constructor(model: Model) {\n    this.model = model;\n    this.statsCollector = new StatsCollector(model);\n    this.relationshipCatalog = new RelationshipCatalog();\n  }\n\n  /**\n   * Load the relationship catalog and build relationship type map\n   */\n  async loadCatalog(): Promise<void> {\n    if (this.catalogLoaded) return;\n\n    await this.relationshipCatalog.load();\n    const types = this.relationshipCatalog.getAllTypes();\n\n    for (const type of types) {\n      this.relationshipTypeMap.set(type.predicate, type);\n    }\n\n    this.catalogLoaded = true;\n  }\n\n  /**\n   * Collect all report data (statistics, relationships, data model, quality metrics)\n   */\n  async collect(): Promise<ReportData> {\n    if (this.cachedReport) {\n      return this.cachedReport;\n    }\n\n    try {\n      await this.loadCatalog();\n\n      const statistics = await this.getStatistics();\n      const relationships = await this.getRelationshipAnalysis();\n      const dataModel = await this.getDataModelInsights();\n      const quality = await this.getQualityMetrics();\n\n      this.cachedReport = {\n        timestamp: new Date().toISOString(),\n        statistics,\n        relationships,\n        dataModel,\n        quality,\n      };\n\n      return this.cachedReport;\n    } catch (error) {\n      throw new Error(\n        `Failed to collect report data: ${error instanceof Error ? error.message : String(error)}`,\n        { cause: error }\n      );\n    }\n  }\n\n  /**\n   * Get model statistics\n   */\n  async getStatistics(): Promise<ModelStats> {\n    if (this.cachedStats) {\n      return this.cachedStats;\n    }\n\n    this.cachedStats = await this.statsCollector.collect();\n    return this.cachedStats;\n  }\n\n  /**\n   * Get relationship analysis with classification\n   */\n  async getRelationshipAnalysis(): Promise<RelationshipAnalysis> {\n    if (this.cachedRelationships) {\n      return this.cachedRelationships;\n    }\n\n    await this.loadCatalog();\n\n    const allRelationships = this.model.relationships.getAll();\n    const classified: ClassifiedRelationship[] = [];\n    const byCategory: Record<string, number> = {};\n    const byPredicate: Record<string, number> = {};\n\n    let crossLayerCount = 0;\n    let intraLayerCount = 0;\n\n    for (let i = 0; i < allRelationships.length; i++) {\n      const rel = allRelationships[i];\n      const relationshipId = `${rel.source}\u2192${rel.predicate}\u2192${rel.target}`;\n      const classifiedRel = this.classifyRelationship(rel, relationshipId);\n      classified.push(classifiedRel);\n\n      // Count by category\n      if (!byCategory[classifiedRel.category]) {\n        byCategory[classifiedRel.category] = 0;\n      }\n      byCategory[classifiedRel.category]++;\n\n      // Count by predicate\n      if (!byPredicate[rel.predicate]) {\n        byPredicate[rel.predicate] = 0;\n      }\n      byPredicate[rel.predicate]++;\n\n      // Count cross vs intra-layer\n      if (classifiedRel.isCrossLayer) {\n        crossLayerCount++;\n      } else {\n        intraLayerCount++;\n      }\n    }\n\n    const circularDependencies = this.detectCircularDependencies(classified);\n\n    this.cachedRelationships = {\n      totalRelationships: allRelationships.length,\n      classified,\n      byCategory,\n      byPredicate,\n      crossLayerCount,\n      intraLayerCount,\n      circularDependencies,\n    };\n\n    return this.cachedRelationships;\n  }\n\n  /**\n   * Get relationships filtered by category\n   */\n  async getRelationshipsByCategory(category: string): Promise<ClassifiedRelationship[]> {\n    const analysis = await this.getRelationshipAnalysis();\n    return analysis.classified.filter((rel) => rel.category === category);\n  }\n\n  /**\n   * Get data model layer (Layer 7) specific insights\n   */\n  async getDataModelInsights(): Promise<DataModelInsights> {\n    if (this.cachedDataModel) {\n      return this.cachedDataModel;\n    }\n\n    const dataModelLayer = await this.model.getLayer(\"data-model\");\n    const entities: DataModelEntity[] = [];\n    let attributeCount = 0;\n\n    if (dataModelLayer) {\n      const elements = dataModelLayer.listElements();\n\n      // Get all references to data model entities from other layers\n      const referencesFrom = new Set<string>();\n      for (const layerName of this.model.getLayerNames()) {\n        if (layerName === \"data-model\") continue;\n        const layer = await this.model.getLayer(layerName);\n        if (!layer) continue;\n\n        for (const element of layer.listElements()) {\n          if (element.references) {\n            for (const ref of element.references) {\n              if (ref.target.startsWith(\"data-model.\")) {\n                referencesFrom.add(ref.target);\n              }\n            }\n          }\n        }\n      }\n\n      for (const element of elements) {\n        const attributes = element.attributes ? Object.keys(element.attributes) : [];\n        attributeCount += attributes.length;\n\n        entities.push({\n          id: element.path || element.id || \"\",\n          name: element.name,\n          layer: \"data-model\",\n          attributes,\n          relatedEntities: element.relationships ? element.relationships.map((r) => r.target) : [],\n          isReferenced: referencesFrom.has(element.path || element.id || \"\"),\n        });\n      }\n    }\n\n    const entityCount = entities.length;\n    const referencedCount = entities.filter((e) => e.isReferenced).length;\n    const orphaned = entities.filter((e) => !e.isReferenced && e.relatedEntities.length === 0);\n\n    // Calculate actual attribute coverage: percentage of entities that have at least one attribute\n    const entitiesWithAttributes = entities.filter((e) => e.attributes.length > 0).length;\n    const attributeCoverage =\n      entityCount > 0 ? (entitiesWithAttributes / entityCount) * 100 : 0;\n\n    const avgAttrs = entityCount > 0 ? attributeCount / entityCount : 0;\n    const maxAttrs = Math.max(0, ...entities.map((e) => e.attributes.length));\n    const avgRels =\n      entityCount > 0 ? entities.reduce((sum, e) => sum + e.relatedEntities.length, 0) / entityCount : 0;\n\n    this.cachedDataModel = {\n      entityCount,\n      attributeCount,\n      relationshipCount: entities.reduce((sum, e) => sum + e.relatedEntities.length, 0),\n      entities,\n      entityCoverage: entityCount > 0 ? (referencedCount / entityCount) * 100 : 0,\n      attributeCoverage,\n      avgAttributesPerEntity: Math.round(avgAttrs * 10) / 10,\n      maxAttributesPerEntity: maxAttrs,\n      avgRelationshipsPerEntity: Math.round(avgRels * 10) / 10,\n      referencedEntities: referencedCount,\n      orphanedEntities: orphaned.map((e) => e.id),\n    };\n\n    return this.cachedDataModel;\n  }\n\n  /**\n   * Get quality metrics for the model\n   */\n  async getQualityMetrics(): Promise<QualityMetrics> {\n    if (this.cachedQuality) {\n      return this.cachedQuality;\n    }\n\n    const stats = await this.getStatistics();\n    const relationships = await this.getRelationshipAnalysis();\n\n    // Coverage metrics\n    const elementCoverage = stats.statistics.totalElements > 0 ? 100 : 0;\n    const relationshipCoverage =\n      stats.statistics.totalElements > 0\n        ? (stats.statistics.totalRelationships / stats.statistics.totalElements) * 100\n        : 0;\n    const documentationCoverage = this.calculateDocumentationCoverage(stats);\n    const layerCoverage =\n      stats.statistics.totalLayers > 0\n        ? (stats.statistics.populatedLayers / stats.statistics.totalLayers) * 100\n        : 0;\n\n    // Structural quality\n    const orphanedElements = stats.orphanedElements.length;\n    const circularDependencies = relationships.circularDependencies.length;\n\n    // Semantic quality - simplified calculation\n    const archimateCompliance = this.calculateArchimateCompliance(relationships);\n    const specCompliance = this.calculateSpecCompliance(relationships);\n    const semanticConsistency = (archimateCompliance + specCompliance) / 2;\n\n    // Layering quality\n    const crossLayerReferenceHealth =\n      relationships.totalRelationships > 0\n        ? (relationships.crossLayerCount / relationships.totalRelationships) * 100\n        : 0;\n\n    // Layer compliance score: proportion of relationships going higher -> lower\n    const layerComplianceScore = this.calculateLayerComplianceScore(relationships);\n\n    this.cachedQuality = {\n      elementCoverage,\n      relationshipCoverage: Math.min(100, relationshipCoverage),\n      documentationCoverage: Math.min(100, documentationCoverage),\n      layerCoverage: Math.min(100, layerCoverage),\n      orphanedElements,\n      circularDependencies,\n      archimateCompliance,\n      specCompliance,\n      semanticConsistency,\n      crossLayerReferenceHealth: Math.min(100, crossLayerReferenceHealth),\n      layerComplianceScore,\n    };\n\n    return this.cachedQuality;\n  }\n\n  /**\n   * Classify a single relationship with semantic metadata\n   */\n  private classifyRelationship(rel: Relationship, id: string): ClassifiedRelationship {\n    // Extract layer name from element ID (format: layer.type.name)\n    const sourceParts = rel.source.split(\".\");\n    const targetParts = rel.target.split(\".\");\n\n    // Validate element ID format: must have at least layer (part 0)\n    const sourceLayer = sourceParts[0];\n    const targetLayer = targetParts[0];\n\n    if (!sourceLayer || !targetLayer) {\n      // Log warning for malformed element IDs but continue with available data\n      // This allows partial analysis without breaking the entire report\n      console.warn(\n        `[REPORT_001] Malformed element ID format in relationship: ` +\n          `source=\"${rel.source}\" (${sourceParts.length} parts), ` +\n          `target=\"${rel.target}\" (${targetParts.length} parts). ` +\n          `Expected format: layer.type.name`\n      );\n    }\n\n    const relationshipType = this.relationshipTypeMap.get(rel.predicate);\n\n    // Determine spec compliance: unknown predicates are not compliant\n    const isSpecCompliant = relationshipType !== undefined;\n\n    return createClassifiedRelationship(\n      {\n        id,\n        source: rel.source,\n        target: rel.target,\n        predicate: rel.predicate,\n        category: relationshipType?.category || \"unknown\",\n        archimateAlignment: relationshipType?.archimateAlignment || null,\n        directionality: relationshipType?.semantics?.directionality || \"unidirectional\",\n        transitivity: relationshipType?.semantics?.transitivity || false,\n        symmetry: relationshipType?.semantics?.symmetry || false,\n        reflexivity: relationshipType?.semantics?.reflexivity,\n        isSpecCompliant,\n      },\n      sourceLayer,\n      targetLayer\n    );\n  }\n\n  /**\n   * Detect circular dependencies in relationships\n   * Max depth limit prevents stack overflow on complex graphs\n   */\n  private detectCircularDependencies(relationships: ClassifiedRelationship[]): CircularPath[] {\n    const MAX_SEARCH_DEPTH = 100;\n    const circularPaths: CircularPath[] = [];\n    const visited = new Set<string>();\n    const path: string[] = [];\n    const predicatePath: string[] = [];\n\n    for (const rel of relationships) {\n      if (!visited.has(rel.source)) {\n        this.findCircles(rel.source, relationships, visited, path, predicatePath, circularPaths, 0, MAX_SEARCH_DEPTH);\n      }\n    }\n\n    return circularPaths;\n  }\n\n  /**\n   * Helper to find circular paths using DFS with depth limit\n   */\n  private findCircles(\n    node: string,\n    relationships: ClassifiedRelationship[],\n    visited: Set<string>,\n    path: string[],\n    predicatePath: string[],\n    circularPaths: CircularPath[],\n    depth: number,\n    maxDepth: number\n  ): void {\n    // Prevent stack overflow on complex graphs\n    if (depth > maxDepth) {\n      return;\n    }\n    if (path.includes(node)) {\n      const circleStart = path.indexOf(node);\n      const circlePath = path.slice(circleStart);\n      const circlePredicates = predicatePath.slice(circleStart);\n\n      // Only add if not already found (use immutable sort for comparison)\n      const circleKey = [...circlePath].sort().join(\"\u2192\");\n      const isDuplicate = circularPaths.some(\n        (c) => [...c.elements].sort().join(\"\u2192\") === circleKey\n      );\n\n      if (!isDuplicate && circlePath.length > 1) {\n        circularPaths.push({\n          elements: circlePath,\n          predicates: circlePredicates,\n          pathLength: circlePath.length,\n        });\n      }\n      return;\n    }\n\n    if (visited.has(node)) {\n      return;\n    }\n\n    path.push(node);\n    visited.add(node);\n\n    // Find all outgoing edges from this node\n    for (const rel of relationships) {\n      if (rel.source === node) {\n        predicatePath.push(rel.predicate);\n        this.findCircles(rel.target, relationships, visited, path, predicatePath, circularPaths, depth + 1, maxDepth);\n        predicatePath.pop();\n      }\n    }\n\n    path.pop();\n    visited.delete(node); // Remove from visited during backtrack to detect cycles from alternate paths\n  }\n\n  /**\n   * Calculate documentation coverage percentage\n   * Checks what proportion of elements have meaningful descriptions\n   */\n  private calculateDocumentationCoverage(stats: ModelStats): number {\n    if (stats.statistics.totalElements === 0) return 0;\n\n    // Count elements with descriptions across all layers\n    let documentedCount = 0;\n    for (const layerName of this.model.getLayerNames()) {\n      const layer = this.model.layers.get(layerName);\n      if (!layer) continue;\n\n      for (const element of layer.listElements()) {\n        if (element.description && element.description.trim().length > 0) {\n          documentedCount++;\n        }\n      }\n    }\n\n    return Math.round((documentedCount / stats.statistics.totalElements) * 100);\n  }\n\n  /**\n   * Calculate ArchiMate alignment percentage\n   */\n  private calculateArchimateCompliance(analysis: RelationshipAnalysis): number {\n    if (analysis.totalRelationships === 0) return 100;\n\n    const archimateAligned = analysis.classified.filter((r) => r.archimateAlignment).length;\n    return Math.round((archimateAligned / analysis.totalRelationships) * 100);\n  }\n\n  /**\n   * Calculate spec compliance percentage\n   */\n  private calculateSpecCompliance(analysis: RelationshipAnalysis): number {\n    if (analysis.totalRelationships === 0) return 100;\n\n    const specCompliant = analysis.classified.filter((r) => r.isSpecCompliant).length;\n    return Math.round((specCompliant / analysis.totalRelationships) * 100);\n  }\n\n  /**\n   * Calculate layer compliance score (directional compliance)\n   * Measures adherence to the higher -> lower layer reference rule\n   */\n  private calculateLayerComplianceScore(analysis: RelationshipAnalysis): number {\n    // Only count relationships with known (valid) layer names\n    const validRelationships = analysis.classified.filter((rel) => {\n      const sourceOrder = getLayerOrder(rel.sourceLayer);\n      const targetOrder = getLayerOrder(rel.targetLayer);\n      return sourceOrder > 0 && targetOrder > 0;\n    });\n\n    if (validRelationships.length === 0) return 100;\n\n    let compliantCount = 0;\n\n    for (const rel of validRelationships) {\n      const sourceOrder = getLayerOrder(rel.sourceLayer);\n      const targetOrder = getLayerOrder(rel.targetLayer);\n\n      // Compliant if source >= target (higher layer -> lower/same layer)\n      if (sourceOrder >= targetOrder) {\n        compliantCount++;\n      }\n    }\n\n    return Math.round((compliantCount / validRelationships.length) * 100);\n  }\n\n  /**\n   * Clear all cached data\n   */\n  clearCache(): void {\n    this.cachedStats = null;\n    this.cachedRelationships = null;\n    this.cachedDataModel = null;\n    this.cachedQuality = null;\n    this.cachedReport = null;\n  }\n\n  /**\n   * Get the relationship catalog\n   */\n  getCatalog(): RelationshipCatalog {\n    return this.relationshipCatalog;\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/core/spec-data-service.js

@@ -0,0 +1,185 @@
+import { SpecDataLoader } from "./spec-loader.js";
+class SpecDataService {
+  loader;
+  nodeTypeMetadataCache = /* @__PURE__ */ new Map();
+  constructor(options = {}) {
+    this.loader = new SpecDataLoader(options);
+  }
+  /**
+   * Load specification data
+   */
+  async initialize() {
+    await this.loader.load();
+  }
+  /**
+   * Check if service is initialized
+   */
+  isInitialized() {
+    return this.loader.isLoaded();
+  }
+  /**
+   * Get raw specification data
+   */
+  getSpecData() {
+    return this.loader.getSpecData();
+  }
+  /**
+   * Get specification statistics
+   */
+  getStatistics() {
+    return this.loader.getStatistics();
+  }
+  /**
+   * Find node types by filter
+   */
+  findNodeTypes(filter = {}) {
+    return this.loader.findNodeTypes(filter);
+  }
+  /**
+   * Find relationship types by filter
+   */
+  findRelationshipTypes(filter = {}) {
+    return this.loader.findRelationshipTypes(filter);
+  }
+  /**
+   * Get all layers
+   */
+  getAllLayers() {
+    return this.loader.getAllLayers();
+  }
+  /**
+   * Get layer by ID
+   */
+  getLayer(layerId) {
+    return this.loader.getLayer(layerId);
+  }
+  /**
+   * Get node type by spec_node_id
+   */
+  getNodeType(specNodeId) {
+    return this.loader.getNodeType(specNodeId);
+  }
+  /**
+   * Get node types for a specific layer
+   */
+  getNodeTypesForLayer(layerId) {
+    return this.loader.getNodeTypesForLayer(layerId);
+  }
+  /**
+   * Get enriched metadata for a node type (including relationships and layers)
+   */
+  getNodeTypeMetadata(specNodeId) {
+    if (this.nodeTypeMetadataCache.has(specNodeId))
+      return this.nodeTypeMetadataCache.get(specNodeId);
+    const nodeType = this.loader.getNodeType(specNodeId);
+    if (!nodeType)
+      return;
+    const layer = this.loader.getLayer(nodeType.layer_id), incomingRelationships = this.getRelationshipMetadata(this.loader.getNodeTypesReferencingType(specNodeId)), outgoingRelationships = this.getRelationshipMetadata(this.loader.getNodeTypesReferencedByType(specNodeId)), metadata = {
+      nodeType,
+      layer,
+      incomingRelationships,
+      outgoingRelationships
+    };
+    return this.nodeTypeMetadataCache.set(specNodeId, metadata), metadata;
+  }
+  /**
+   * Get enriched metadata for relationship types
+   */
+  getRelationshipMetadata(relationshipTypes) {
+    return relationshipTypes.map((rt) => ({
+      relationshipType: rt,
+      predicate: this.loader.getPredicate(rt.predicate),
+      sourceNodeType: this.loader.getNodeType(rt.source_spec_node_id),
+      destinationNodeType: this.loader.getNodeType(rt.destination_spec_node_id),
+      sourceLayer: this.loader.getLayer(rt.source_layer),
+      destinationLayer: this.loader.getLayer(rt.destination_layer)
+    }));
+  }
+  /**
+   * Validate if a relationship is valid between two node types
+   */
+  isValidRelationship(sourceSpecNodeId, destSpecNodeId, predicate) {
+    return this.loader.findRelationshipTypes({
+      sourceSpecNodeId,
+      destinationSpecNodeId: destSpecNodeId,
+      predicate
+    }).length > 0;
+  }
+  /**
+   * Get valid relationship predicates between two node types
+   */
+  getValidPredicates(sourceSpecNodeId, destSpecNodeId) {
+    const relationships = this.loader.findRelationshipTypes({
+      sourceSpecNodeId,
+      destinationSpecNodeId: destSpecNodeId
+    }), predicateSet = /* @__PURE__ */ new Set();
+    for (const rel of relationships)
+      predicateSet.add(rel.predicate);
+    return Array.from(predicateSet).map((p) => this.loader.getPredicate(p)).filter((p) => p !== void 0);
+  }
+  /**
+   * Find all node types that can be a source for a given destination node type with a predicate
+   */
+  getSourceNodeTypesForDestination(destSpecNodeId, predicate) {
+    const relationships = this.loader.findRelationshipTypes({
+      destinationSpecNodeId: destSpecNodeId,
+      predicate
+    }), sourceSpecNodeIds = new Set(relationships.map((r) => r.source_spec_node_id)), sources = [];
+    for (const id of sourceSpecNodeIds) {
+      const nodeType = this.loader.getNodeType(id);
+      nodeType && sources.push(nodeType);
+    }
+    return sources;
+  }
+  /**
+   * Find all node types that can be a destination for a given source node type with a predicate
+   */
+  getDestinationNodeTypesForSource(sourceSpecNodeId, predicate) {
+    const relationships = this.loader.findRelationshipTypes({
+      sourceSpecNodeId,
+      predicate
+    }), destSpecNodeIds = new Set(relationships.map((r) => r.destination_spec_node_id)), destinations = [];
+    for (const id of destSpecNodeIds) {
+      const nodeType = this.loader.getNodeType(id);
+      nodeType && destinations.push(nodeType);
+    }
+    return destinations;
+  }
+  /**
+   * Get relationship types between two layers
+   */
+  getRelationshipsBetweenLayers(sourceLayerId, destLayerId) {
+    return this.loader.getRelationshipTypesForLayerPair(sourceLayerId, destLayerId);
+  }
+  /**
+   * Validate spec data integrity
+   * Returns array of issues found, empty if valid
+   */
+  validateIntegrity() {
+    const issues = [], specData = this.loader.getSpecData();
+    for (const relType of specData.relationshipTypes)
+      specData.nodeTypes.find((nt) => nt.spec_node_id === relType.source_spec_node_id) || issues.push(`Relationship ${relType.id} references non-existent source node type: ${relType.source_spec_node_id}`), relType.destination_spec_node_id && !specData.nodeTypes.find((nt) => nt.spec_node_id === relType.destination_spec_node_id) && issues.push(`Relationship ${relType.id} references non-existent destination node type: ${relType.destination_spec_node_id}`), relType.predicate && !specData.predicates.has(relType.predicate) && issues.push(`Relationship ${relType.id} references non-existent predicate: ${relType.predicate}`);
+    for (const nodeType of specData.nodeTypes)
+      specData.layers.find((l) => l.id === nodeType.layer_id) || issues.push(`Node type ${nodeType.spec_node_id} references non-existent layer: ${nodeType.layer_id}`);
+    return issues;
+  }
+  /**
+   * Clear all caches
+   */
+  clear() {
+    this.loader.clear(), this.nodeTypeMetadataCache.clear();
+  }
+}
+let globalSpecDataService = null;
+function getGlobalSpecDataService(options = {}) {
+  return globalSpecDataService || (globalSpecDataService = new SpecDataService(options)), globalSpecDataService;
+}
+function resetGlobalSpecDataService() {
+  globalSpecDataService = null;
+}
+export {
+  SpecDataService,
+  getGlobalSpecDataService,
+  resetGlobalSpecDataService
+};
+//# sourceMappingURL=spec-data-service.js.map

package/dist/core/spec-data-service.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/core/spec-data-service.ts"],
+  "sourcesContent": ["/**\n * SpecDataService - High-level service for specification data operations\n *\n * Provides a convenient API for querying and analyzing specification metadata.\n * Manages the lifecycle of SpecDataLoader and provides caching and performance optimizations.\n */\n\nimport { SpecDataLoader } from \"./spec-loader.js\";\nimport {\n  LayerSpec,\n  NodeTypeSpec,\n  RelationshipTypeSpec,\n  PredicateSpec,\n  SpecData,\n  SpecStatistics,\n  SpecLoaderOptions,\n  NodeTypeQueryFilter,\n  RelationshipTypeQueryFilter,\n} from \"./spec-loader-types.js\";\n\n/**\n * Relationship metadata computed from spec data\n */\nexport interface RelationshipMetadata {\n  relationshipType: RelationshipTypeSpec;\n  predicate: PredicateSpec | undefined;\n  sourceNodeType: NodeTypeSpec | undefined;\n  destinationNodeType: NodeTypeSpec | undefined;\n  sourceLayer: LayerSpec | undefined;\n  destinationLayer: LayerSpec | undefined;\n}\n\n/**\n * Node type metadata with computed relationships\n */\nexport interface NodeTypeMetadata {\n  nodeType: NodeTypeSpec;\n  layer: LayerSpec | undefined;\n  incomingRelationships: RelationshipMetadata[];\n  outgoingRelationships: RelationshipMetadata[];\n}\n\n/**\n * SpecDataService provides a high-level API for specification operations\n */\nexport class SpecDataService {\n  private loader: SpecDataLoader;\n  private nodeTypeMetadataCache: Map<string, NodeTypeMetadata> = new Map();\n\n  constructor(options: SpecLoaderOptions = {}) {\n    this.loader = new SpecDataLoader(options);\n  }\n\n  /**\n   * Load specification data\n   */\n  async initialize(): Promise<void> {\n    await this.loader.load();\n  }\n\n  /**\n   * Check if service is initialized\n   */\n  isInitialized(): boolean {\n    return this.loader.isLoaded();\n  }\n\n  /**\n   * Get raw specification data\n   */\n  getSpecData(): SpecData {\n    return this.loader.getSpecData();\n  }\n\n  /**\n   * Get specification statistics\n   */\n  getStatistics(): SpecStatistics {\n    return this.loader.getStatistics();\n  }\n\n  /**\n   * Find node types by filter\n   */\n  findNodeTypes(filter: NodeTypeQueryFilter = {}): NodeTypeSpec[] {\n    return this.loader.findNodeTypes(filter);\n  }\n\n  /**\n   * Find relationship types by filter\n   */\n  findRelationshipTypes(filter: RelationshipTypeQueryFilter = {}): RelationshipTypeSpec[] {\n    return this.loader.findRelationshipTypes(filter);\n  }\n\n  /**\n   * Get all layers\n   */\n  getAllLayers(): LayerSpec[] {\n    return this.loader.getAllLayers();\n  }\n\n  /**\n   * Get layer by ID\n   */\n  getLayer(layerId: string): LayerSpec | undefined {\n    return this.loader.getLayer(layerId);\n  }\n\n  /**\n   * Get node type by spec_node_id\n   */\n  getNodeType(specNodeId: string): NodeTypeSpec | undefined {\n    return this.loader.getNodeType(specNodeId);\n  }\n\n  /**\n   * Get node types for a specific layer\n   */\n  getNodeTypesForLayer(layerId: string): NodeTypeSpec[] {\n    return this.loader.getNodeTypesForLayer(layerId);\n  }\n\n  /**\n   * Get enriched metadata for a node type (including relationships and layers)\n   */\n  getNodeTypeMetadata(specNodeId: string): NodeTypeMetadata | undefined {\n    // Check cache first\n    if (this.nodeTypeMetadataCache.has(specNodeId)) {\n      return this.nodeTypeMetadataCache.get(specNodeId);\n    }\n\n    const nodeType = this.loader.getNodeType(specNodeId);\n    if (!nodeType) {\n      return undefined;\n    }\n\n    const layer = this.loader.getLayer(nodeType.layer_id);\n    const incomingRelationships = this.getRelationshipMetadata(\n      this.loader.getNodeTypesReferencingType(specNodeId)\n    );\n    const outgoingRelationships = this.getRelationshipMetadata(\n      this.loader.getNodeTypesReferencedByType(specNodeId)\n    );\n\n    const metadata: NodeTypeMetadata = {\n      nodeType,\n      layer,\n      incomingRelationships,\n      outgoingRelationships,\n    };\n\n    // Cache the metadata\n    this.nodeTypeMetadataCache.set(specNodeId, metadata);\n\n    return metadata;\n  }\n\n  /**\n   * Get enriched metadata for relationship types\n   */\n  private getRelationshipMetadata(relationshipTypes: RelationshipTypeSpec[]): RelationshipMetadata[] {\n    return relationshipTypes.map((rt) => ({\n      relationshipType: rt,\n      predicate: this.loader.getPredicate(rt.predicate),\n      sourceNodeType: this.loader.getNodeType(rt.source_spec_node_id),\n      destinationNodeType: this.loader.getNodeType(rt.destination_spec_node_id),\n      sourceLayer: this.loader.getLayer(rt.source_layer),\n      destinationLayer: this.loader.getLayer(rt.destination_layer),\n    }));\n  }\n\n  /**\n   * Validate if a relationship is valid between two node types\n   */\n  isValidRelationship(\n    sourceSpecNodeId: string,\n    destSpecNodeId: string,\n    predicate?: string\n  ): boolean {\n    const relationships = this.loader.findRelationshipTypes({\n      sourceSpecNodeId,\n      destinationSpecNodeId: destSpecNodeId,\n      predicate,\n    });\n\n    return relationships.length > 0;\n  }\n\n  /**\n   * Get valid relationship predicates between two node types\n   */\n  getValidPredicates(sourceSpecNodeId: string, destSpecNodeId: string): PredicateSpec[] {\n    const relationships = this.loader.findRelationshipTypes({\n      sourceSpecNodeId,\n      destinationSpecNodeId: destSpecNodeId,\n    });\n\n    const predicateSet = new Set<string>();\n    for (const rel of relationships) {\n      predicateSet.add(rel.predicate);\n    }\n\n    return Array.from(predicateSet)\n      .map((p) => this.loader.getPredicate(p))\n      .filter((p): p is PredicateSpec => p !== undefined);\n  }\n\n  /**\n   * Find all node types that can be a source for a given destination node type with a predicate\n   */\n  getSourceNodeTypesForDestination(\n    destSpecNodeId: string,\n    predicate?: string\n  ): NodeTypeSpec[] {\n    const relationships = this.loader.findRelationshipTypes({\n      destinationSpecNodeId: destSpecNodeId,\n      predicate,\n    });\n\n    const sourceSpecNodeIds = new Set(relationships.map((r) => r.source_spec_node_id));\n    const sources: NodeTypeSpec[] = [];\n\n    for (const id of sourceSpecNodeIds) {\n      const nodeType = this.loader.getNodeType(id);\n      if (nodeType) {\n        sources.push(nodeType);\n      }\n    }\n\n    return sources;\n  }\n\n  /**\n   * Find all node types that can be a destination for a given source node type with a predicate\n   */\n  getDestinationNodeTypesForSource(\n    sourceSpecNodeId: string,\n    predicate?: string\n  ): NodeTypeSpec[] {\n    const relationships = this.loader.findRelationshipTypes({\n      sourceSpecNodeId,\n      predicate,\n    });\n\n    const destSpecNodeIds = new Set(relationships.map((r) => r.destination_spec_node_id));\n    const destinations: NodeTypeSpec[] = [];\n\n    for (const id of destSpecNodeIds) {\n      const nodeType = this.loader.getNodeType(id);\n      if (nodeType) {\n        destinations.push(nodeType);\n      }\n    }\n\n    return destinations;\n  }\n\n  /**\n   * Get relationship types between two layers\n   */\n  getRelationshipsBetweenLayers(sourceLayerId: string, destLayerId?: string): RelationshipTypeSpec[] {\n    return this.loader.getRelationshipTypesForLayerPair(sourceLayerId, destLayerId);\n  }\n\n  /**\n   * Validate spec data integrity\n   * Returns array of issues found, empty if valid\n   */\n  validateIntegrity(): string[] {\n    const issues: string[] = [];\n    const specData = this.loader.getSpecData();\n\n    // Validate that all relationship type references exist\n    for (const relType of specData.relationshipTypes) {\n      if (!specData.nodeTypes.find((nt) => nt.spec_node_id === relType.source_spec_node_id)) {\n        issues.push(\n          `Relationship ${relType.id} references non-existent source node type: ${relType.source_spec_node_id}`\n        );\n      }\n\n      if (\n        relType.destination_spec_node_id &&\n        !specData.nodeTypes.find((nt) => nt.spec_node_id === relType.destination_spec_node_id)\n      ) {\n        issues.push(\n          `Relationship ${relType.id} references non-existent destination node type: ${relType.destination_spec_node_id}`\n        );\n      }\n\n      if (relType.predicate && !specData.predicates.has(relType.predicate)) {\n        issues.push(\n          `Relationship ${relType.id} references non-existent predicate: ${relType.predicate}`\n        );\n      }\n    }\n\n    // Validate that all node types are defined in a layer\n    for (const nodeType of specData.nodeTypes) {\n      if (!specData.layers.find((l) => l.id === nodeType.layer_id)) {\n        issues.push(\n          `Node type ${nodeType.spec_node_id} references non-existent layer: ${nodeType.layer_id}`\n        );\n      }\n    }\n\n    return issues;\n  }\n\n  /**\n   * Clear all caches\n   */\n  clear(): void {\n    this.loader.clear();\n    this.nodeTypeMetadataCache.clear();\n  }\n}\n\n/**\n * Global singleton instance for SpecDataService\n */\nlet globalSpecDataService: SpecDataService | null = null;\n\n/**\n * Get or create global SpecDataService instance\n * WARNING: Options are only applied on first call. Subsequent calls with different\n * options will be silently ignored and the existing instance returned. Call resetGlobalSpecDataService()\n * before calling this again with different options.\n */\nexport function getGlobalSpecDataService(options: SpecLoaderOptions = {}): SpecDataService {\n  if (!globalSpecDataService) {\n    globalSpecDataService = new SpecDataService(options);\n  }\n  return globalSpecDataService;\n}\n\n/**\n * Reset global SpecDataService instance\n */\nexport function resetGlobalSpecDataService(): void {\n  globalSpecDataService = null;\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/core/spec-loader-types.js

@@ -0,0 +1 @@
+//# sourceMappingURL=spec-loader-types.js.map

package/dist/core/spec-loader-types.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/core/spec-loader.js

@@ -0,0 +1,234 @@
+import path from "node:path";
+import { fileURLToPath } from "url";
+import fs from "node:fs/promises";
+import { existsSync } from "fs";
+import { getErrorMessage } from "../utils/errors.js";
+import { logDebug } from "../utils/globals.js";
+class SpecDataLoader {
+  bundledDir;
+  options;
+  cachedData = null;
+  loadedAt = null;
+  constructor(options = {}) {
+    this.options = {
+      cache: !0,
+      includeSchemas: !1,
+      ...options
+    }, this.bundledDir = this.options.bundledDir || this.getDefaultBundledDir();
+  }
+  /**
+   * Resolve the bundled dist directory.
+   *
+   * Priority:
+   * 1. Explicit override via options.bundledDir
+   * 2. CLI installation: schemas/bundled/ next to compiled source
+   * 3. Development monorepo: spec/dist/
+   */
+  getDefaultBundledDir() {
+    const currentDir = path.dirname(fileURLToPath(import.meta.url)), installPath = path.join(currentDir, "..", "schemas", "bundled");
+    if (existsSync(path.join(installPath, "manifest.json")))
+      return logDebug(`SpecDataLoader using bundled schemas: ${installPath}`), installPath;
+    const devDistPath = path.join(currentDir, "../../../spec/dist");
+    if (existsSync(path.join(devDistPath, "manifest.json")))
+      return logDebug(`SpecDataLoader using bundled schemas: ${devDistPath}`), devDistPath;
+    throw new Error(`Cannot find compiled spec schemas. Tried:
+  1. CLI installation: ${installPath}
+  2. Development monorepo: ${devDistPath}
+
+Ensure you have built the spec (npm run build:spec) or installed the CLI.`);
+  }
+  /**
+   * Load all specification data
+   */
+  async load() {
+    if (this.options.cache && this.cachedData)
+      return this.cachedData;
+    try {
+      const [layers, nodeTypes, relationshipTypes, predicates] = await Promise.all([
+        this.loadLayers(),
+        this.loadNodeTypes(),
+        this.loadRelationshipTypes(),
+        this.loadPredicates()
+      ]), data = { layers, nodeTypes, relationshipTypes, predicates };
+      return this.options.cache && (this.cachedData = data, this.loadedAt = /* @__PURE__ */ new Date()), data;
+    } catch (error) {
+      throw new Error(`Failed to load specification data from ${this.bundledDir}: ${getErrorMessage(error)}`);
+    }
+  }
+  /**
+   * Load layer specifications from manifest.json + per-layer files
+   */
+  async loadLayers() {
+    const manifest = await this.readManifest(), layers = [];
+    for (const entry of manifest.layers) {
+      const layerFile = path.join(this.bundledDir, `${entry.id}.json`), content = await fs.readFile(layerFile, "utf-8"), layer = JSON.parse(content).layer;
+      layers.push(layer);
+    }
+    return layers.sort((a, b) => a.number - b.number);
+  }
+  /**
+   * Load node type specifications from nodeSchemas in each layer file
+   */
+  async loadNodeTypes() {
+    const manifest = await this.readManifest(), nodeTypes = [];
+    for (const entry of manifest.layers) {
+      const layerFile = path.join(this.bundledDir, `${entry.id}.json`), content = await fs.readFile(layerFile, "utf-8"), layerData = JSON.parse(content);
+      for (const [, schema] of Object.entries(layerData.nodeSchemas)) {
+        const spec_node_id = schema.properties?.spec_node_id?.const, layer_id = schema.properties?.layer_id?.const, type = schema.properties?.type?.const;
+        if (!spec_node_id || !layer_id || !type)
+          throw new Error(`Node schema in ${entry.id}.json missing required const values: spec_node_id=${spec_node_id}, layer_id=${layer_id}, type=${type}`);
+        nodeTypes.push({
+          spec_node_id,
+          layer_id,
+          type,
+          title: schema.title || "",
+          description: schema.description || "",
+          attributes: this.extractAttributes(schema.properties?.attributes),
+          ...this.options.includeSchemas && { schema }
+        });
+      }
+    }
+    return nodeTypes;
+  }
+  /**
+   * Extract attribute specifications from node schema
+   */
+  extractAttributes(attributesSchema) {
+    if (!attributesSchema || !attributesSchema.properties)
+      return [];
+    const props = attributesSchema.properties, required = new Set(attributesSchema.required || []);
+    return Object.entries(props).map(([name, schema]) => ({
+      name,
+      type: schema.type || "unknown",
+      format: schema.format,
+      required: required.has(name),
+      description: schema.description
+    }));
+  }
+  /**
+   * Load relationship type specifications from relationshipSchemas in each layer file
+   *
+   * The bundled format stores flat data directly (not wrapped in JSON Schema),
+   * so we read the fields directly rather than extracting from .const values.
+   */
+  async loadRelationshipTypes() {
+    const manifest = await this.readManifest(), relationshipTypes = [];
+    for (const entry of manifest.layers) {
+      const layerFile = path.join(this.bundledDir, `${entry.id}.json`), content = await fs.readFile(layerFile, "utf-8"), layerData = JSON.parse(content);
+      for (const rel of Object.values(layerData.relationshipSchemas)) {
+        if (!rel.id || !rel.source_spec_node_id || !rel.source_layer)
+          throw new Error(`Relationship schema in ${entry.id}.json missing required fields: id=${rel.id}`);
+        relationshipTypes.push({
+          id: rel.id,
+          source_spec_node_id: rel.source_spec_node_id,
+          source_layer: rel.source_layer,
+          destination_spec_node_id: rel.destination_spec_node_id || "",
+          destination_layer: rel.destination_layer || "",
+          predicate: rel.predicate || "",
+          cardinality: rel.cardinality || "many-to-many",
+          strength: rel.strength || "medium",
+          required: rel.required
+        });
+      }
+    }
+    return relationshipTypes;
+  }
+  /**
+   * Load predicate definitions from base.json
+   */
+  async loadPredicates() {
+    const basePath = path.join(this.bundledDir, "base.json");
+    try {
+      const content = await fs.readFile(basePath, "utf-8");
+      let data;
+      try {
+        data = JSON.parse(content);
+      } catch (parseError) {
+        throw new Error(`Failed to parse base.json at ${basePath}: ${getErrorMessage(parseError)}`);
+      }
+      const predicates = /* @__PURE__ */ new Map();
+      for (const [, pred] of Object.entries(data.predicates)) {
+        const predSpec = pred;
+        predicates.set(predSpec.predicate, {
+          predicate: predSpec.predicate,
+          inverse: predSpec.inverse,
+          category: predSpec.category,
+          description: predSpec.description,
+          archimate_alignment: predSpec.archimate_alignment,
+          semantics: predSpec.semantics
+        });
+      }
+      return predicates;
+    } catch (error) {
+      throw new Error(`Failed to load predicates from ${basePath}: ${getErrorMessage(error)}`);
+    }
+  }
+  /**
+   * Read and parse the bundled manifest.json
+   */
+  async readManifest() {
+    const manifestPath = path.join(this.bundledDir, "manifest.json"), content = await fs.readFile(manifestPath, "utf-8");
+    return JSON.parse(content);
+  }
+  /**
+   * Get loaded specification data
+   * Throws if data hasn't been loaded yet
+   */
+  getSpecData() {
+    if (!this.cachedData)
+      throw new Error("Specification data not loaded. Call load() first.");
+    return this.cachedData;
+  }
+  isLoaded() {
+    return this.cachedData !== null;
+  }
+  getStatistics() {
+    const data = this.getSpecData();
+    return {
+      layerCount: data.layers.length,
+      nodeTypeCount: data.nodeTypes.length,
+      relationshipTypeCount: data.relationshipTypes.length,
+      predicateCount: data.predicates.size,
+      totalAttributes: data.nodeTypes.reduce((sum, nt) => sum + nt.attributes.length, 0),
+      loadedAt: this.loadedAt || /* @__PURE__ */ new Date()
+    };
+  }
+  clear() {
+    this.cachedData = null, this.loadedAt = null;
+  }
+  findNodeTypes(filter = {}) {
+    return this.getSpecData().nodeTypes.filter((nt) => !(filter.layer && nt.layer_id !== filter.layer || filter.type && nt.type !== filter.type || filter.specNodeId && nt.spec_node_id !== filter.specNodeId || filter.title && !nt.title.toLowerCase().includes(filter.title.toLowerCase())));
+  }
+  findRelationshipTypes(filter = {}) {
+    return this.getSpecData().relationshipTypes.filter((rt) => !(filter.sourceLayer && rt.source_layer !== filter.sourceLayer || filter.sourceSpecNodeId && rt.source_spec_node_id !== filter.sourceSpecNodeId || filter.destinationLayer && rt.destination_layer !== filter.destinationLayer || filter.destinationSpecNodeId && rt.destination_spec_node_id !== filter.destinationSpecNodeId || filter.predicate && rt.predicate !== filter.predicate));
+  }
+  getNodeTypesForLayer(layerId) {
+    return this.findNodeTypes({ layer: layerId });
+  }
+  getRelationshipTypesForLayerPair(sourceLayer, destLayer) {
+    const filter = { sourceLayer };
+    return destLayer && (filter.destinationLayer = destLayer), this.findRelationshipTypes(filter);
+  }
+  getPredicate(predicateName) {
+    return this.getSpecData().predicates.get(predicateName);
+  }
+  getLayer(layerId) {
+    return this.getSpecData().layers.find((l) => l.id === layerId);
+  }
+  getAllLayers() {
+    return this.getSpecData().layers;
+  }
+  getNodeType(specNodeId) {
+    return this.getSpecData().nodeTypes.find((nt) => nt.spec_node_id === specNodeId);
+  }
+  getNodeTypesReferencingType(specNodeId) {
+    return this.findRelationshipTypes({ destinationSpecNodeId: specNodeId });
+  }
+  getNodeTypesReferencedByType(specNodeId) {
+    return this.findRelationshipTypes({ sourceSpecNodeId: specNodeId });
+  }
+}
+export {
+  SpecDataLoader
+};
+//# sourceMappingURL=spec-loader.js.map

package/dist/core/spec-loader.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/core/spec-loader.ts"],
+  "sourcesContent": ["/**\n * SpecDataLoader - Loads specification metadata from compiled bundled dist files\n *\n * Reads directly from the 14 compiled JSON files in cli/src/schemas/bundled/:\n *   manifest.json, base.json, {layer}.json (x12)\n *\n * Never reads from .dr/ or expanded individual schema files.\n */\n\nimport path from \"node:path\";\nimport { fileURLToPath } from \"url\";\nimport fs from \"node:fs/promises\";\nimport { existsSync } from \"fs\";\nimport { getErrorMessage } from \"../utils/errors.js\";\nimport { logDebug } from \"../utils/globals.js\";\nimport {\n  LayerSpec,\n  NodeTypeSpec,\n  RelationshipTypeSpec,\n  PredicateSpec,\n  SpecData,\n  SpecStatistics,\n  SpecLoaderOptions,\n  NodeTypeQueryFilter,\n  RelationshipTypeQueryFilter,\n  AttributeSpec,\n} from \"./spec-loader-types.js\";\n\n// Bundled dist format types (matches spec/dist/ output)\ninterface CompiledManifest {\n  specVersion: string;\n  builtAt: string;\n  layers: Array<{ id: string; number: number; name: string; nodeTypeCount: number; relationshipCount: number }>;\n}\n\ninterface CompiledBase {\n  specVersion: string;\n  schemas: Record<string, unknown>;\n  predicates: Record<string, unknown>;\n}\n\ninterface CompiledRelationshipFlat {\n  id: string;\n  source_spec_node_id: string;\n  source_layer: string;\n  destination_spec_node_id: string;\n  destination_layer: string;\n  predicate: string;\n  cardinality?: string;\n  strength?: string;\n  required?: boolean;\n}\n\ninterface CompiledLayer {\n  layer: Record<string, unknown>;\n  nodeSchemas: Record<string, Record<string, unknown>>;\n  relationshipSchemas: Record<string, CompiledRelationshipFlat>;\n}\n\n/**\n * SpecDataLoader loads specification metadata from the compiled bundled dist files\n */\nexport class SpecDataLoader {\n  private bundledDir: string;\n  private options: SpecLoaderOptions;\n  private cachedData: SpecData | null = null;\n  private loadedAt: Date | null = null;\n\n  constructor(options: SpecLoaderOptions = {}) {\n    this.options = {\n      cache: true,\n      includeSchemas: false,\n      ...options,\n    };\n\n    this.bundledDir = this.options.bundledDir || this.getDefaultBundledDir();\n  }\n\n  /**\n   * Resolve the bundled dist directory.\n   *\n   * Priority:\n   * 1. Explicit override via options.bundledDir\n   * 2. CLI installation: schemas/bundled/ next to compiled source\n   * 3. Development monorepo: spec/dist/\n   */\n  private getDefaultBundledDir(): string {\n    const currentDir = path.dirname(fileURLToPath(import.meta.url));\n\n    // Try 1: CLI installation (dist/core \u2192 dist/schemas/bundled)\n    const installPath = path.join(currentDir, \"..\", \"schemas\", \"bundled\");\n    if (existsSync(path.join(installPath, \"manifest.json\"))) {\n      logDebug(`SpecDataLoader using bundled schemas: ${installPath}`);\n      return installPath;\n    }\n\n    // Try 2: Development path \u2014 spec/dist/ in monorepo\n    const devDistPath = path.join(currentDir, \"../../../spec/dist\");\n    if (existsSync(path.join(devDistPath, \"manifest.json\"))) {\n      logDebug(`SpecDataLoader using bundled schemas: ${devDistPath}`);\n      return devDistPath;\n    }\n\n    throw new Error(\n      \"Cannot find compiled spec schemas. Tried:\\n\" +\n      `  1. CLI installation: ${installPath}\\n` +\n      `  2. Development monorepo: ${devDistPath}\\n\\n` +\n      \"Ensure you have built the spec (npm run build:spec) or installed the CLI.\"\n    );\n  }\n\n  /**\n   * Load all specification data\n   */\n  async load(): Promise<SpecData> {\n    if (this.options.cache && this.cachedData) {\n      return this.cachedData;\n    }\n\n    try {\n      const [layers, nodeTypes, relationshipTypes, predicates] = await Promise.all([\n        this.loadLayers(),\n        this.loadNodeTypes(),\n        this.loadRelationshipTypes(),\n        this.loadPredicates(),\n      ]);\n\n      const data: SpecData = { layers, nodeTypes, relationshipTypes, predicates };\n\n      if (this.options.cache) {\n        this.cachedData = data;\n        this.loadedAt = new Date();\n      }\n\n      return data;\n    } catch (error) {\n      throw new Error(\n        `Failed to load specification data from ${this.bundledDir}: ${getErrorMessage(error)}`\n      );\n    }\n  }\n\n  /**\n   * Load layer specifications from manifest.json + per-layer files\n   */\n  private async loadLayers(): Promise<LayerSpec[]> {\n    const manifest = await this.readManifest();\n    const layers: LayerSpec[] = [];\n\n    for (const entry of manifest.layers) {\n      const layerFile = path.join(this.bundledDir, `${entry.id}.json`);\n      const content = await fs.readFile(layerFile, \"utf-8\");\n      const layerData = JSON.parse(content) as CompiledLayer;\n      const layer = layerData.layer as unknown as LayerSpec;\n      layers.push(layer);\n    }\n\n    return layers.sort((a, b) => a.number - b.number);\n  }\n\n  /**\n   * Load node type specifications from nodeSchemas in each layer file\n   */\n  private async loadNodeTypes(): Promise<NodeTypeSpec[]> {\n    const manifest = await this.readManifest();\n    const nodeTypes: NodeTypeSpec[] = [];\n\n    for (const entry of manifest.layers) {\n      const layerFile = path.join(this.bundledDir, `${entry.id}.json`);\n      const content = await fs.readFile(layerFile, \"utf-8\");\n      const layerData = JSON.parse(content) as CompiledLayer;\n\n      for (const [, schema] of Object.entries(layerData.nodeSchemas)) {\n        const spec_node_id = (schema.properties as Record<string, Record<string, unknown>>)?.spec_node_id?.const as string;\n        const layer_id = (schema.properties as Record<string, Record<string, unknown>>)?.layer_id?.const as string;\n        const type = (schema.properties as Record<string, Record<string, unknown>>)?.type?.const as string;\n\n        if (!spec_node_id || !layer_id || !type) {\n          throw new Error(\n            `Node schema in ${entry.id}.json missing required const values: spec_node_id=${spec_node_id}, layer_id=${layer_id}, type=${type}`\n          );\n        }\n\n        nodeTypes.push({\n          spec_node_id,\n          layer_id,\n          type,\n          title: (schema.title as string) || \"\",\n          description: (schema.description as string) || \"\",\n          attributes: this.extractAttributes((schema.properties as Record<string, unknown>)?.attributes as Record<string, unknown>),\n          ...(this.options.includeSchemas && { schema: schema as Record<string, unknown> }),\n        });\n      }\n    }\n\n    return nodeTypes;\n  }\n\n  /**\n   * Extract attribute specifications from node schema\n   */\n  private extractAttributes(attributesSchema: Record<string, unknown>): AttributeSpec[] {\n    if (!attributesSchema || !attributesSchema.properties) {\n      return [];\n    }\n\n    const props = attributesSchema.properties as Record<string, Record<string, unknown>>;\n    const required = new Set((attributesSchema.required as string[]) || []);\n\n    return Object.entries(props).map(([name, schema]) => ({\n      name,\n      type: (schema.type as string) || \"unknown\",\n      format: schema.format as string | undefined,\n      required: required.has(name),\n      description: schema.description as string | undefined,\n    }));\n  }\n\n  /**\n   * Load relationship type specifications from relationshipSchemas in each layer file\n   *\n   * The bundled format stores flat data directly (not wrapped in JSON Schema),\n   * so we read the fields directly rather than extracting from .const values.\n   */\n  private async loadRelationshipTypes(): Promise<RelationshipTypeSpec[]> {\n    const manifest = await this.readManifest();\n    const relationshipTypes: RelationshipTypeSpec[] = [];\n\n    for (const entry of manifest.layers) {\n      const layerFile = path.join(this.bundledDir, `${entry.id}.json`);\n      const content = await fs.readFile(layerFile, \"utf-8\");\n      const layerData = JSON.parse(content) as CompiledLayer;\n\n      for (const rel of Object.values(layerData.relationshipSchemas)) {\n        if (!rel.id || !rel.source_spec_node_id || !rel.source_layer) {\n          throw new Error(\n            `Relationship schema in ${entry.id}.json missing required fields: id=${rel.id}`\n          );\n        }\n\n        relationshipTypes.push({\n          id: rel.id,\n          source_spec_node_id: rel.source_spec_node_id,\n          source_layer: rel.source_layer,\n          destination_spec_node_id: rel.destination_spec_node_id || \"\",\n          destination_layer: rel.destination_layer || \"\",\n          predicate: rel.predicate || \"\",\n          cardinality: rel.cardinality || \"many-to-many\",\n          strength: rel.strength || \"medium\",\n          required: rel.required,\n        });\n      }\n    }\n\n    return relationshipTypes;\n  }\n\n  /**\n   * Load predicate definitions from base.json\n   */\n  private async loadPredicates(): Promise<Map<string, PredicateSpec>> {\n    const basePath = path.join(this.bundledDir, \"base.json\");\n\n    try {\n      const content = await fs.readFile(basePath, \"utf-8\");\n      let data: CompiledBase;\n      try {\n        data = JSON.parse(content) as CompiledBase;\n      } catch (parseError) {\n        throw new Error(`Failed to parse base.json at ${basePath}: ${getErrorMessage(parseError)}`);\n      }\n\n      const predicates = new Map<string, PredicateSpec>();\n      for (const [, pred] of Object.entries(data.predicates)) {\n        const predSpec = pred as unknown as PredicateSpec;\n        predicates.set(predSpec.predicate, {\n          predicate: predSpec.predicate,\n          inverse: predSpec.inverse,\n          category: predSpec.category,\n          description: predSpec.description,\n          archimate_alignment: predSpec.archimate_alignment,\n          semantics: predSpec.semantics,\n        });\n      }\n\n      return predicates;\n    } catch (error) {\n      throw new Error(\n        `Failed to load predicates from ${basePath}: ${getErrorMessage(error)}`\n      );\n    }\n  }\n\n  /**\n   * Read and parse the bundled manifest.json\n   */\n  private async readManifest(): Promise<CompiledManifest> {\n    const manifestPath = path.join(this.bundledDir, \"manifest.json\");\n    const content = await fs.readFile(manifestPath, \"utf-8\");\n    return JSON.parse(content) as CompiledManifest;\n  }\n\n  /**\n   * Get loaded specification data\n   * Throws if data hasn't been loaded yet\n   */\n  getSpecData(): SpecData {\n    if (!this.cachedData) {\n      throw new Error(\"Specification data not loaded. Call load() first.\");\n    }\n    return this.cachedData;\n  }\n\n  isLoaded(): boolean {\n    return this.cachedData !== null;\n  }\n\n  getStatistics(): SpecStatistics {\n    const data = this.getSpecData();\n    return {\n      layerCount: data.layers.length,\n      nodeTypeCount: data.nodeTypes.length,\n      relationshipTypeCount: data.relationshipTypes.length,\n      predicateCount: data.predicates.size,\n      totalAttributes: data.nodeTypes.reduce((sum, nt) => sum + nt.attributes.length, 0),\n      loadedAt: this.loadedAt || new Date(),\n    };\n  }\n\n  clear(): void {\n    this.cachedData = null;\n    this.loadedAt = null;\n  }\n\n  findNodeTypes(filter: NodeTypeQueryFilter = {}): NodeTypeSpec[] {\n    const data = this.getSpecData();\n\n    return data.nodeTypes.filter((nt) => {\n      if (filter.layer && nt.layer_id !== filter.layer) return false;\n      if (filter.type && nt.type !== filter.type) return false;\n      if (filter.specNodeId && nt.spec_node_id !== filter.specNodeId) return false;\n      if (filter.title && !nt.title.toLowerCase().includes(filter.title.toLowerCase()))\n        return false;\n      return true;\n    });\n  }\n\n  findRelationshipTypes(filter: RelationshipTypeQueryFilter = {}): RelationshipTypeSpec[] {\n    const data = this.getSpecData();\n\n    return data.relationshipTypes.filter((rt) => {\n      if (filter.sourceLayer && rt.source_layer !== filter.sourceLayer) return false;\n      if (filter.sourceSpecNodeId && rt.source_spec_node_id !== filter.sourceSpecNodeId)\n        return false;\n      if (filter.destinationLayer && rt.destination_layer !== filter.destinationLayer)\n        return false;\n      if (filter.destinationSpecNodeId && rt.destination_spec_node_id !== filter.destinationSpecNodeId)\n        return false;\n      if (filter.predicate && rt.predicate !== filter.predicate) return false;\n      return true;\n    });\n  }\n\n  getNodeTypesForLayer(layerId: string): NodeTypeSpec[] {\n    return this.findNodeTypes({ layer: layerId });\n  }\n\n  getRelationshipTypesForLayerPair(sourceLayer: string, destLayer?: string): RelationshipTypeSpec[] {\n    const filter: RelationshipTypeQueryFilter = { sourceLayer };\n    if (destLayer) {\n      filter.destinationLayer = destLayer;\n    }\n    return this.findRelationshipTypes(filter);\n  }\n\n  getPredicate(predicateName: string): PredicateSpec | undefined {\n    return this.getSpecData().predicates.get(predicateName);\n  }\n\n  getLayer(layerId: string): LayerSpec | undefined {\n    const data = this.getSpecData();\n    return data.layers.find((l) => l.id === layerId);\n  }\n\n  getAllLayers(): LayerSpec[] {\n    return this.getSpecData().layers;\n  }\n\n  getNodeType(specNodeId: string): NodeTypeSpec | undefined {\n    const data = this.getSpecData();\n    return data.nodeTypes.find((nt) => nt.spec_node_id === specNodeId);\n  }\n\n  getNodeTypesReferencingType(specNodeId: string): RelationshipTypeSpec[] {\n    return this.findRelationshipTypes({ destinationSpecNodeId: specNodeId });\n  }\n\n  getNodeTypesReferencedByType(specNodeId: string): RelationshipTypeSpec[] {\n    return this.findRelationshipTypes({ sourceSpecNodeId: specNodeId });\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}