@documentation-robotics/cli 0.1.13 → 0.2.0

package/dist/reports/model-readme-generator.js

@@ -0,0 +1,116 @@
+import { formatLayerName } from "../utils/layer-name-formatter.js";
+import { formatMarkdownTable } from "../utils/markdown-table.js";
+import { escapeMarkdown } from "../export/markdown-utils.js";
+class ModelReadmeGenerator {
+  generatedAt;
+  constructor(generatedAt) {
+    this.generatedAt = generatedAt;
+  }
+  /**
+   * Generate complete model README markdown
+   */
+  generate(data) {
+    const lines = [];
+    return lines.push(this.generateHeader(data)), lines.push(this.generateStatistics(data)), lines.push(this.generateProjectSummary(data)), lines.push(this.generateIntroduction()), lines.push(this.generateLayerIndex(data)), lines.push(this.generateFooter(data)), lines.join("");
+  }
+  generateHeader(data) {
+    const lines = [];
+    return lines.push(`# ${escapeMarkdown(data.projectName)}
+`), lines.push(`
+`), lines.join("");
+  }
+  generateStatistics(data) {
+    const lines = [];
+    lines.push(`## Model Statistics
+`), lines.push(`
+`);
+    const headers = ["Metric", "Value"], rows = [
+      ["Total Elements", String(data.totalElements)],
+      ["Total Relationships", String(data.totalRelationships)],
+      ["Populated Layers", String(data.populatedLayerCount)],
+      ["Last Updated", data.lastUpdated],
+      ["CLI Version", data.cliVersion]
+    ];
+    data.specVersion && rows.push(["Spec Version", data.specVersion]);
+    const table = formatMarkdownTable(headers, rows);
+    return lines.push(table), lines.push(`
+`), lines.join("");
+  }
+  generateProjectSummary(data) {
+    const lines = [];
+    lines.push(`## Project Summary
+`), lines.push(`
+`), data.projectDescription && lines.push(`${escapeMarkdown(data.projectDescription)}
+
+`);
+    const populatedLayers = data.layers.filter((l) => l.elementCount > 0);
+    if (populatedLayers.length > 0) {
+      lines.push(`**Populated Layers**:
+
+`);
+      const layerNames = populatedLayers.map((l) => `- ${formatLayerName(l.layerName)}`).join(`
+`);
+      lines.push(`${layerNames}
+
+`);
+    }
+    return lines.join("");
+  }
+  generateIntroduction() {
+    const lines = [];
+    lines.push(`## About Documentation Robotics
+`), lines.push(`
+`), lines.push(`Documentation Robotics is a toolkit for managing federated architecture data models across 13 interconnected layers. It provides a structured approach to documenting systems architecture by organizing elements and relationships across distinct layers that represent different concerns: from business motivation and strategy through to technology infrastructure and testing.
+
+`), lines.push(`### The 13-Layer Architecture Model
+
+`);
+    const layerDescriptions = [
+      "1. **Motivation** - Goals, requirements, drivers, and strategic outcomes",
+      "2. **Business** - Business processes, functions, roles, and services",
+      "3. **Product** - Product features, capabilities, personas, and milestones",
+      "4. **Security** - Authentication, authorization, threats, and controls",
+      "5. **Application** - Application components, services, and interactions",
+      "6. **Technology** - Infrastructure, platforms, and technology components",
+      "7. **API** - REST APIs, operations, and endpoints",
+      "8. **Data Model** - Data entities, relationships, and structure definitions",
+      "9. **Data Store** - Databases and persistence mechanisms",
+      "10. **UX** - User interface components and user experience elements",
+      "11. **Navigation** - Application routing and navigation flows",
+      "12. **APM** - Observability, monitoring, metrics, and tracing",
+      "13. **Testing** - Test strategies, test cases, and test coverage"
+    ];
+    return lines.push(layerDescriptions.join(`
+`)), lines.push(`
+
+`), lines.push(`Each layer is independently managed but interconnected, allowing elements in higher layers to reference elements in lower layers, creating a comprehensive dependency graph that ensures architectural coherence and traceability across all concerns.
+
+`), lines.join("");
+  }
+  generateLayerIndex(data) {
+    const lines = [];
+    lines.push(`## Layer Reports
+`), lines.push(`
+`);
+    const headers = ["Layer", "Elements", "Report"], rows = [], sortedLayers = [...data.layers].sort((a, b) => a.layerNumber - b.layerNumber);
+    for (const layer of sortedLayers) {
+      const layerName = formatLayerName(layer.layerName), elementCount = String(layer.elementCount);
+      let report;
+      layer.elementCount > 0 ? report = `[${layer.reportFileName}](./reports/${layer.reportFileName})` : report = "\u2014", rows.push([layerName, elementCount, report]);
+    }
+    const table = formatMarkdownTable(headers, rows);
+    return lines.push(table), lines.push(`
+`), lines.join("");
+  }
+  generateFooter(data) {
+    const lines = [];
+    return lines.push(`---
+`), lines.push(`
+`), lines.push(`Generated: ${this.generatedAt} | Model Version: ${data.modelVersion}
+`), lines.join("");
+  }
+}
+export {
+  ModelReadmeGenerator
+};
+//# sourceMappingURL=model-readme-generator.js.map

package/dist/reports/model-readme-generator.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/reports/model-readme-generator.ts"],
+  "sourcesContent": ["/**\n * Model README Generator\n *\n * Generates the main README.md for the model documentation with:\n * - Model statistics (elements, relationships, versions)\n * - Project summary\n * - Introduction to documentation robotics\n * - Per-layer report index table\n */\n\nimport type { ModelReadmeData } from './model-report-data.js';\nimport { formatLayerName } from '../utils/layer-name-formatter.js';\nimport { formatMarkdownTable } from '../utils/markdown-table.js';\nimport { escapeMarkdown } from '../export/markdown-utils.js';\n\nexport class ModelReadmeGenerator {\n  constructor(private generatedAt: string) {}\n\n  /**\n   * Generate complete model README markdown\n   */\n  generate(data: ModelReadmeData): string {\n    const lines: string[] = [];\n\n    // Header with project name\n    lines.push(this.generateHeader(data));\n\n    // Statistics section\n    lines.push(this.generateStatistics(data));\n\n    // Project summary\n    lines.push(this.generateProjectSummary(data));\n\n    // Documentation robotics introduction\n    lines.push(this.generateIntroduction());\n\n    // Layer index table\n    lines.push(this.generateLayerIndex(data));\n\n    // Footer\n    lines.push(this.generateFooter(data));\n\n    return lines.join('');\n  }\n\n  private generateHeader(data: ModelReadmeData): string {\n    const lines: string[] = [];\n    lines.push(`# ${escapeMarkdown(data.projectName)}\\n`);\n    lines.push('\\n');\n    return lines.join('');\n  }\n\n  private generateStatistics(data: ModelReadmeData): string {\n    const lines: string[] = [];\n    lines.push('## Model Statistics\\n');\n    lines.push('\\n');\n\n    const headers = ['Metric', 'Value'];\n    const rows = [\n      ['Total Elements', String(data.totalElements)],\n      ['Total Relationships', String(data.totalRelationships)],\n      ['Populated Layers', String(data.populatedLayerCount)],\n      ['Last Updated', data.lastUpdated],\n      ['CLI Version', data.cliVersion],\n    ];\n\n    // Add spec version if available\n    if (data.specVersion) {\n      rows.push(['Spec Version', data.specVersion]);\n    }\n\n    const table = formatMarkdownTable(headers, rows);\n    lines.push(table);\n    lines.push('\\n');\n\n    return lines.join('');\n  }\n\n  private generateProjectSummary(data: ModelReadmeData): string {\n    const lines: string[] = [];\n    lines.push('## Project Summary\\n');\n    lines.push('\\n');\n\n    // Project description if available\n    if (data.projectDescription) {\n      lines.push(`${escapeMarkdown(data.projectDescription)}\\n\\n`);\n    }\n\n    // Layer population summary\n    const populatedLayers = data.layers.filter(l => l.elementCount > 0);\n    if (populatedLayers.length > 0) {\n      lines.push('**Populated Layers**:\\n\\n');\n      const layerNames = populatedLayers\n        .map(l => `- ${formatLayerName(l.layerName)}`)\n        .join('\\n');\n      lines.push(`${layerNames}\\n\\n`);\n    }\n\n    return lines.join('');\n  }\n\n  private generateIntroduction(): string {\n    const lines: string[] = [];\n    lines.push('## About Documentation Robotics\\n');\n    lines.push('\\n');\n    lines.push(\n      'Documentation Robotics is a toolkit for managing federated architecture data models across 13 interconnected layers. ' +\n      'It provides a structured approach to documenting systems architecture by organizing elements and relationships across ' +\n      'distinct layers that represent different concerns: from business motivation and strategy through to technology infrastructure and testing.\\n\\n'\n    );\n\n    lines.push('### The 13-Layer Architecture Model\\n\\n');\n\n    const layerDescriptions = [\n      '1. **Motivation** - Goals, requirements, drivers, and strategic outcomes',\n      '2. **Business** - Business processes, functions, roles, and services',\n      '3. **Product** - Product features, capabilities, personas, and milestones',\n      '4. **Security** - Authentication, authorization, threats, and controls',\n      '5. **Application** - Application components, services, and interactions',\n      '6. **Technology** - Infrastructure, platforms, and technology components',\n      '7. **API** - REST APIs, operations, and endpoints',\n      '8. **Data Model** - Data entities, relationships, and structure definitions',\n      '9. **Data Store** - Databases and persistence mechanisms',\n      '10. **UX** - User interface components and user experience elements',\n      '11. **Navigation** - Application routing and navigation flows',\n      '12. **APM** - Observability, monitoring, metrics, and tracing',\n      '13. **Testing** - Test strategies, test cases, and test coverage',\n    ];\n\n    lines.push(layerDescriptions.join('\\n'));\n    lines.push('\\n\\n');\n\n    lines.push(\n      'Each layer is independently managed but interconnected, allowing elements in higher layers to reference elements in lower layers, ' +\n      'creating a comprehensive dependency graph that ensures architectural coherence and traceability across all concerns.\\n\\n'\n    );\n\n    return lines.join('');\n  }\n\n  private generateLayerIndex(data: ModelReadmeData): string {\n    const lines: string[] = [];\n    lines.push('## Layer Reports\\n');\n    lines.push('\\n');\n\n    const headers = ['Layer', 'Elements', 'Report'];\n    const rows: string[][] = [];\n\n    // Sort layers by layer number for consistent ordering\n    const sortedLayers = [...data.layers].sort((a, b) => a.layerNumber - b.layerNumber);\n\n    for (const layer of sortedLayers) {\n      const layerName = formatLayerName(layer.layerName);\n      const elementCount = String(layer.elementCount);\n\n      let report: string;\n      if (layer.elementCount > 0) {\n        // Create link to layer report (in reports/ subdirectory)\n        report = `[${layer.reportFileName}](./reports/${layer.reportFileName})`;\n      } else {\n        // No link for empty layers\n        report = '\u2014';\n      }\n\n      rows.push([layerName, elementCount, report]);\n    }\n\n    const table = formatMarkdownTable(headers, rows);\n    lines.push(table);\n    lines.push('\\n');\n\n    return lines.join('');\n  }\n\n  private generateFooter(data: ModelReadmeData): string {\n    const lines: string[] = [];\n    lines.push('---\\n');\n    lines.push('\\n');\n    lines.push(`Generated: ${this.generatedAt} | Model Version: ${data.modelVersion}\\n`);\n    return lines.join('');\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/reports/model-report-data.js

@@ -1,5 +1,7 @@
 import { Element } from "../core/element.js";
-import { getLayerOrder, isValidLayerName } from "../core/layers.js";
+import { getLayerOrder, CANONICAL_LAYER_NAMES, isValidLayerName } from "../core/layers.js";
+import { getCliVersion } from "../utils/spec-version.js";
+import { getLayerReportFileName } from "./model-report-utils.js";
 class ModelReportDataCollector {
   /**
    * Collect report data for a specific layer
@@ -50,6 +52,40 @@ class ModelReportDataCollector {
       statistics
     };
   }
+  /**
+   * Collect aggregated model-wide data for the model README
+   *
+   * @param model - The live Model instance
+   * @returns Aggregated model-wide data including project metadata, per-layer summaries, and statistics
+   */
+  collectModelData(model) {
+    const layers = [];
+    let totalElements = 0;
+    for (const layerName of CANONICAL_LAYER_NAMES) {
+      const elementCount = model.graph.getNodesByLayer(layerName).length;
+      totalElements += elementCount;
+      const layerNumber = getLayerOrder(layerName), reportFileName = getLayerReportFileName(layerName);
+      layers.push({
+        layerName,
+        layerNumber,
+        elementCount,
+        reportFileName
+      });
+    }
+    const totalRelationships = model.relationships.getAll().length, populatedLayerCount = layers.filter((l) => l.elementCount > 0).length;
+    return {
+      projectName: model.manifest.name,
+      projectDescription: model.manifest.description,
+      modelVersion: model.manifest.version,
+      cliVersion: model.manifest.cliVersion || getCliVersion(),
+      specVersion: model.manifest.specVersion,
+      lastUpdated: model.manifest.modified,
+      totalElements,
+      totalRelationships,
+      populatedLayerCount,
+      layers
+    };
+  }
 }
 export {
   ModelReportDataCollector

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/reports/model-report-data.ts"],
-  "sourcesContent": ["import type { Model } from '../core/model.js';\nimport { Element } from '../core/element.js';\nimport type { Relationship } from '../core/relationships.js';\nimport { getLayerOrder, type CanonicalLayerName, isValidLayerName } from '../core/layers.js';\n\n/**\n * Statistics about relationships in a layer\n */\nexport interface ModelLayerStatistics {\n  elementCount: number;\n  intraRelationshipCount: number;\n  interRelationshipCount: number;\n  inboundRelationshipCount: number;   // inter-layer rels targeting this layer\n  outboundRelationshipCount: number;  // inter-layer rels sourced from this layer\n}\n\n/**\n * Report-friendly data structure for a single layer\n * Analogous to ReportDataModel in scripts/generate-layer-reports.ts\n */\nexport interface ModelLayerReportData {\n  layerName: CanonicalLayerName;\n  layerNumber: number;\n  elements: Element[];                        // sorted by element.path\n  intraRelationships: Relationship[];         // both source and target in same layer\n  interRelationships: Relationship[];         // source or target in a different layer\n  upstreamLayers: CanonicalLayerName[];       // canonical layer names referencing INTO this layer\n  downstreamLayers: CanonicalLayerName[];     // canonical layer names this layer references OUT TO\n  statistics: ModelLayerStatistics;\n}\n\n/**\n * Data collector for generating layer report data from a live Model instance\n * Reads from Model/Layer/Relationships and transforms into report-friendly shapes\n */\nexport class ModelReportDataCollector {\n  /**\n   * Collect report data for a specific layer\n   *\n   * @param model - The live Model instance\n   * @param layerName - The canonical layer name (e.g., 'api', 'data-model')\n   * @returns Report-friendly data structure for the layer\n   */\n  collectLayerData(model: Model, layerName: CanonicalLayerName): ModelLayerReportData {\n    // Get the layer number for file naming\n    const layerNumber = getLayerOrder(layerName);\n\n    // Get all elements in this layer using GraphModel's indexed lookup for O(1) layer-scoped access\n    // Convert GraphNodes to Elements for report-friendly shape\n    const graphNodes = model.graph.getNodesByLayer(layerName);\n    const elements: Element[] = graphNodes\n      .map(\n        (node) =>\n          new Element({\n            id: node.uuid || node.id,\n            path: node.id,\n            spec_node_id: node.spec_node_id || '',\n            type: node.type,\n            layer_id: node.layer,\n            name: node.name,\n            description: node.description,\n            attributes: node.attributes,\n            source_reference: node.source_reference,\n            metadata: node.metadata,\n          })\n      )\n      .sort((a, b) => (a.path || a.id).localeCompare(b.path || b.id));\n\n    // Get all relationships and classify them\n    const allRelationships = model.relationships.getAll();\n\n    // Filter relationships involving this layer\n    const allRelatingRelationships = allRelationships.filter(\n      r => r.layer === layerName || r.targetLayer === layerName\n    );\n\n    // Intra-layer relationships: both source and target in same layer\n    // Note: Relationships with missing targetLayer are treated as intra-layer because targetLayer is\n    // typically only populated for inter-layer relationships during persistence and loading.\n    const intraRelationships = allRelatingRelationships.filter(\n      r => r.layer === layerName && (r.targetLayer === layerName || !r.targetLayer)\n    );\n\n    // Inter-layer relationships: source or target in different layer (or other endpoint exists)\n    const interRelationships = allRelatingRelationships.filter(\n      r => !(r.layer === layerName && (r.targetLayer === layerName || !r.targetLayer))\n    );\n\n    // Compute upstream and downstream layers from inter-layer relationships\n    const upstreamLayerSet = new Set<CanonicalLayerName>();\n    const downstreamLayerSet = new Set<CanonicalLayerName>();\n    let inboundRelationshipCount = 0;\n    let outboundRelationshipCount = 0;\n\n    for (const rel of interRelationships) {\n      // Upstream: layers that have relationships targeting THIS layer\n      if (rel.targetLayer === layerName && rel.layer !== layerName) {\n        // Validate layer name before casting (defensive: guards against user-editable YAML with invalid layer names)\n        if (isValidLayerName(rel.layer)) {\n          upstreamLayerSet.add(rel.layer);\n          inboundRelationshipCount++;\n        } else {\n          console.warn(`Skipping invalid layer name in relationship: ${rel.layer}`);\n        }\n      }\n      // Downstream: layers that THIS layer references\n      if (rel.layer === layerName && rel.targetLayer && rel.targetLayer !== layerName) {\n        // Validate layer name before casting (defensive: guards against user-editable YAML with invalid layer names)\n        if (isValidLayerName(rel.targetLayer)) {\n          downstreamLayerSet.add(rel.targetLayer);\n          outboundRelationshipCount++;\n        } else {\n          console.warn(`Skipping invalid layer name in relationship: ${rel.targetLayer}`);\n        }\n      }\n    }\n\n    // Sort upstream and downstream layers\n    const upstreamLayers = Array.from(upstreamLayerSet).sort();\n    const downstreamLayers = Array.from(downstreamLayerSet).sort();\n\n    // Sort relationships deterministically by \"${source}-${predicate}-${target}\"\n    intraRelationships.sort((a, b) => {\n      const aKey = `${a.source}-${a.predicate}-${a.target}`;\n      const bKey = `${b.source}-${b.predicate}-${b.target}`;\n      return aKey.localeCompare(bKey);\n    });\n\n    interRelationships.sort((a, b) => {\n      const aKey = `${a.source}-${a.predicate}-${a.target}`;\n      const bKey = `${b.source}-${b.predicate}-${b.target}`;\n      return aKey.localeCompare(bKey);\n    });\n\n    // Build statistics\n    const statistics: ModelLayerStatistics = {\n      elementCount: elements.length,\n      intraRelationshipCount: intraRelationships.length,\n      interRelationshipCount: interRelationships.length,\n      inboundRelationshipCount,\n      outboundRelationshipCount,\n    };\n\n    return {\n      layerName,\n      layerNumber,\n      elements,\n      intraRelationships,\n      interRelationships,\n      upstreamLayers,\n      downstreamLayers,\n      statistics,\n    };\n  }\n}\n"],
-  "mappings": "AACA,SAAS,eAAe;AAExB,SAAS,eAAwC,wBAAwB;AAgCnE,MAAO,yBAAwB;;;;;;;;EAQnC,iBAAiB,OAAc,WAA6B;AAE1D,UAAM,cAAc,cAAc,SAAS,GAKrC,WADa,MAAM,MAAM,gBAAgB,SAAS,EAErD,IACC,CAAC,SACC,IAAI,QAAQ;MACV,IAAI,KAAK,QAAQ,KAAK;MACtB,MAAM,KAAK;MACX,cAAc,KAAK,gBAAgB;MACnC,MAAM,KAAK;MACX,UAAU,KAAK;MACf,MAAM,KAAK;MACX,aAAa,KAAK;MAClB,YAAY,KAAK;MACjB,kBAAkB,KAAK;MACvB,UAAU,KAAK;KAChB,CAAC,EAEL,KAAK,CAAC,GAAG,OAAO,EAAE,QAAQ,EAAE,IAAI,cAAc,EAAE,QAAQ,EAAE,EAAE,CAAC,GAM1D,2BAHmB,MAAM,cAAc,OAAM,EAGD,OAChD,OAAK,EAAE,UAAU,aAAa,EAAE,gBAAgB,SAAS,GAMrD,qBAAqB,yBAAyB,OAClD,OAAK,EAAE,UAAU,cAAc,EAAE,gBAAgB,aAAa,CAAC,EAAE,YAAY,GAIzE,qBAAqB,yBAAyB,OAClD,OAAK,EAAE,EAAE,UAAU,cAAc,EAAE,gBAAgB,aAAa,CAAC,EAAE,aAAa,GAI5E,mBAAmB,oBAAI,IAAG,GAC1B,qBAAqB,oBAAI,IAAG;AAClC,QAAI,2BAA2B,GAC3B,4BAA4B;AAEhC,eAAW,OAAO;AAEhB,MAAI,IAAI,gBAAgB,aAAa,IAAI,UAAU,cAE7C,iBAAiB,IAAI,KAAK,KAC5B,iBAAiB,IAAI,IAAI,KAAK,GAC9B,8BAEA,QAAQ,KAAK,gDAAgD,IAAI,KAAK,EAAE,IAIxE,IAAI,UAAU,aAAa,IAAI,eAAe,IAAI,gBAAgB,cAEhE,iBAAiB,IAAI,WAAW,KAClC,mBAAmB,IAAI,IAAI,WAAW,GACtC,+BAEA,QAAQ,KAAK,gDAAgD,IAAI,WAAW,EAAE;AAMpF,UAAM,iBAAiB,MAAM,KAAK,gBAAgB,EAAE,KAAI,GAClD,mBAAmB,MAAM,KAAK,kBAAkB,EAAE,KAAI;AAG5D,uBAAmB,KAAK,CAAC,GAAG,MAAK;AAC/B,YAAM,OAAO,GAAG,EAAE,MAAM,IAAI,EAAE,SAAS,IAAI,EAAE,MAAM,IAC7C,OAAO,GAAG,EAAE,MAAM,IAAI,EAAE,SAAS,IAAI,EAAE,MAAM;AACnD,aAAO,KAAK,cAAc,IAAI;IAChC,CAAC,GAED,mBAAmB,KAAK,CAAC,GAAG,MAAK;AAC/B,YAAM,OAAO,GAAG,EAAE,MAAM,IAAI,EAAE,SAAS,IAAI,EAAE,MAAM,IAC7C,OAAO,GAAG,EAAE,MAAM,IAAI,EAAE,SAAS,IAAI,EAAE,MAAM;AACnD,aAAO,KAAK,cAAc,IAAI;IAChC,CAAC;AAGD,UAAM,aAAmC;MACvC,cAAc,SAAS;MACvB,wBAAwB,mBAAmB;MAC3C,wBAAwB,mBAAmB;MAC3C;MACA;;AAGF,WAAO;MACL;MACA;MACA;MACA;MACA;MACA;MACA;MACA;;EAEJ;;",
+  "sourcesContent": ["import type { Model } from '../core/model.js';\nimport { Element } from '../core/element.js';\nimport type { Relationship } from '../core/relationships.js';\nimport { getLayerOrder, CANONICAL_LAYER_NAMES, type CanonicalLayerName, isValidLayerName } from '../core/layers.js';\nimport { getCliVersion } from '../utils/spec-version.js';\nimport { getLayerReportFileName } from './model-report-utils.js';\n\n/**\n * Statistics about relationships in a layer\n */\nexport interface ModelLayerStatistics {\n  elementCount: number;\n  intraRelationshipCount: number;\n  interRelationshipCount: number;\n  inboundRelationshipCount: number;   // inter-layer rels targeting this layer\n  outboundRelationshipCount: number;  // inter-layer rels sourced from this layer\n}\n\n/**\n * Report-friendly data structure for a single layer\n * Analogous to ReportDataModel in scripts/generate-layer-reports.ts\n */\nexport interface ModelLayerReportData {\n  layerName: CanonicalLayerName;\n  layerNumber: number;\n  elements: Element[];                        // sorted by element.path\n  intraRelationships: Relationship[];         // both source and target in same layer\n  interRelationships: Relationship[];         // source or target in a different layer\n  upstreamLayers: CanonicalLayerName[];       // canonical layer names referencing INTO this layer\n  downstreamLayers: CanonicalLayerName[];     // canonical layer names this layer references OUT TO\n  statistics: ModelLayerStatistics;\n}\n\n/**\n * Per-layer summary for the model README\n */\nexport interface ModelReadmeLayerSummary {\n  layerName: CanonicalLayerName;\n  layerNumber: number;\n  elementCount: number;\n  reportFileName: string;\n}\n\n/**\n * Aggregated model-wide data for the model README\n */\nexport interface ModelReadmeData {\n  projectName: string;\n  projectDescription?: string;\n  modelVersion: string;\n  cliVersion: string;\n  specVersion?: string;\n  lastUpdated: string;\n  totalElements: number;\n  totalRelationships: number;\n  populatedLayerCount: number;\n  layers: ModelReadmeLayerSummary[];\n}\n\n/**\n * Data collector for generating layer report data from a live Model instance\n * Reads from Model/Layer/Relationships and transforms into report-friendly shapes\n */\nexport class ModelReportDataCollector {\n  /**\n   * Collect report data for a specific layer\n   *\n   * @param model - The live Model instance\n   * @param layerName - The canonical layer name (e.g., 'api', 'data-model')\n   * @returns Report-friendly data structure for the layer\n   */\n  collectLayerData(model: Model, layerName: CanonicalLayerName): ModelLayerReportData {\n    // Get the layer number for file naming\n    const layerNumber = getLayerOrder(layerName);\n\n    // Get all elements in this layer using GraphModel's indexed lookup for O(1) layer-scoped access\n    // Convert GraphNodes to Elements for report-friendly shape\n    const graphNodes = model.graph.getNodesByLayer(layerName);\n    const elements: Element[] = graphNodes\n      .map(\n        (node) =>\n          new Element({\n            id: node.uuid || node.id,\n            path: node.id,\n            spec_node_id: node.spec_node_id || '',\n            type: node.type,\n            layer_id: node.layer,\n            name: node.name,\n            description: node.description,\n            attributes: node.attributes,\n            source_reference: node.source_reference,\n            metadata: node.metadata,\n          })\n      )\n      .sort((a, b) => (a.path || a.id).localeCompare(b.path || b.id));\n\n    // Get all relationships and classify them\n    const allRelationships = model.relationships.getAll();\n\n    // Filter relationships involving this layer\n    const allRelatingRelationships = allRelationships.filter(\n      r => r.layer === layerName || r.targetLayer === layerName\n    );\n\n    // Intra-layer relationships: both source and target in same layer\n    // Note: Relationships with missing targetLayer are treated as intra-layer because targetLayer is\n    // typically only populated for inter-layer relationships during persistence and loading.\n    const intraRelationships = allRelatingRelationships.filter(\n      r => r.layer === layerName && (r.targetLayer === layerName || !r.targetLayer)\n    );\n\n    // Inter-layer relationships: source or target in different layer (or other endpoint exists)\n    const interRelationships = allRelatingRelationships.filter(\n      r => !(r.layer === layerName && (r.targetLayer === layerName || !r.targetLayer))\n    );\n\n    // Compute upstream and downstream layers from inter-layer relationships\n    const upstreamLayerSet = new Set<CanonicalLayerName>();\n    const downstreamLayerSet = new Set<CanonicalLayerName>();\n    let inboundRelationshipCount = 0;\n    let outboundRelationshipCount = 0;\n\n    for (const rel of interRelationships) {\n      // Upstream: layers that have relationships targeting THIS layer\n      if (rel.targetLayer === layerName && rel.layer !== layerName) {\n        // Validate layer name before casting (defensive: guards against user-editable YAML with invalid layer names)\n        if (isValidLayerName(rel.layer)) {\n          upstreamLayerSet.add(rel.layer);\n          inboundRelationshipCount++;\n        } else {\n          console.warn(`Skipping invalid layer name in relationship: ${rel.layer}`);\n        }\n      }\n      // Downstream: layers that THIS layer references\n      if (rel.layer === layerName && rel.targetLayer && rel.targetLayer !== layerName) {\n        // Validate layer name before casting (defensive: guards against user-editable YAML with invalid layer names)\n        if (isValidLayerName(rel.targetLayer)) {\n          downstreamLayerSet.add(rel.targetLayer);\n          outboundRelationshipCount++;\n        } else {\n          console.warn(`Skipping invalid layer name in relationship: ${rel.targetLayer}`);\n        }\n      }\n    }\n\n    // Sort upstream and downstream layers\n    const upstreamLayers = Array.from(upstreamLayerSet).sort();\n    const downstreamLayers = Array.from(downstreamLayerSet).sort();\n\n    // Sort relationships deterministically by \"${source}-${predicate}-${target}\"\n    intraRelationships.sort((a, b) => {\n      const aKey = `${a.source}-${a.predicate}-${a.target}`;\n      const bKey = `${b.source}-${b.predicate}-${b.target}`;\n      return aKey.localeCompare(bKey);\n    });\n\n    interRelationships.sort((a, b) => {\n      const aKey = `${a.source}-${a.predicate}-${a.target}`;\n      const bKey = `${b.source}-${b.predicate}-${b.target}`;\n      return aKey.localeCompare(bKey);\n    });\n\n    // Build statistics\n    const statistics: ModelLayerStatistics = {\n      elementCount: elements.length,\n      intraRelationshipCount: intraRelationships.length,\n      interRelationshipCount: interRelationships.length,\n      inboundRelationshipCount,\n      outboundRelationshipCount,\n    };\n\n    return {\n      layerName,\n      layerNumber,\n      elements,\n      intraRelationships,\n      interRelationships,\n      upstreamLayers,\n      downstreamLayers,\n      statistics,\n    };\n  }\n\n  /**\n   * Collect aggregated model-wide data for the model README\n   *\n   * @param model - The live Model instance\n   * @returns Aggregated model-wide data including project metadata, per-layer summaries, and statistics\n   */\n  collectModelData(model: Model): ModelReadmeData {\n    // Collect per-layer element counts\n    const layers: ModelReadmeLayerSummary[] = [];\n    let totalElements = 0;\n\n    for (const layerName of CANONICAL_LAYER_NAMES) {\n      const graphNodes = model.graph.getNodesByLayer(layerName);\n      const elementCount = graphNodes.length;\n      totalElements += elementCount;\n\n      const layerNumber = getLayerOrder(layerName);\n      const reportFileName = getLayerReportFileName(layerName);\n\n      layers.push({\n        layerName,\n        layerNumber,\n        elementCount,\n        reportFileName,\n      });\n    }\n\n    // Count total relationships\n    const totalRelationships = model.relationships.getAll().length;\n\n    // Count populated layers (layers with at least one element)\n    const populatedLayerCount = layers.filter(l => l.elementCount > 0).length;\n\n    return {\n      projectName: model.manifest.name,\n      projectDescription: model.manifest.description,\n      modelVersion: model.manifest.version,\n      cliVersion: model.manifest.cliVersion || getCliVersion(),\n      specVersion: model.manifest.specVersion,\n      lastUpdated: model.manifest.modified,\n      totalElements,\n      totalRelationships,\n      populatedLayerCount,\n      layers,\n    };\n  }\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/reports/model-report-orchestrator.js

@@ -1,7 +1,9 @@
 import { ModelReportDataCollector } from "./model-report-data.js";
 import { ModelLayerReportGenerator } from "./model-layer-report-generator.js";
-import { CANONICAL_LAYER_NAMES, getLayerOrder, isValidLayerName } from "../core/layers.js";
+import { ModelReadmeGenerator } from "./model-readme-generator.js";
+import { CANONICAL_LAYER_NAMES, isValidLayerName } from "../core/layers.js";
 import { getErrorMessage } from "../utils/errors.js";
+import { getLayerReportFileName } from "./model-report-utils.js";
 import * as fs from "fs/promises";
 import * as path from "path";
 class ModelReportOrchestrator {
@@ -9,19 +11,23 @@ class ModelReportOrchestrator {
   rootPath;
   collector;
   generator;
+  readmeGenerator;
   constructor(model, rootPath) {
     this.model = model, this.rootPath = rootPath, this.collector = new ModelReportDataCollector();
     const modelVersion = model.manifest.version || "unknown", generatedAt = (/* @__PURE__ */ new Date()).toISOString();
-    this.generator = new ModelLayerReportGenerator(modelVersion, generatedAt);
+    this.generator = new ModelLayerReportGenerator(modelVersion, generatedAt), this.readmeGenerator = new ModelReadmeGenerator(generatedAt);
   }
   /**
    * Regenerate reports for a specific set of affected layers.
    * On first invocation or when reports don't exist, regenerates all 13 reports.
    * Invalid layer names in the affected set are skipped with a warning.
+   * Also regenerates the README since it contains model-wide stats that may have changed.
+   * README is generated first so it exists even if a layer report throws.
    */
   async regenerate(affectedLayers) {
     if (!await this.isInitialized())
       return this.regenerateAll();
+    await this.generateReadme();
     for (const layerName of affectedLayers) {
       if (!isValidLayerName(layerName)) {
         console.warn(`Skipping invalid layer name: ${layerName}`);
@@ -31,12 +37,13 @@ class ModelReportOrchestrator {
     }
   }
   /**
-   * Regenerate all 13 layer reports.
+   * Regenerate all 13 layer reports and the README.
    * Lets mkdir errors propagate so callers can handle them with proper telemetry.
+   * README is generated first so it exists even if a layer report throws.
    */
   async regenerateAll() {
     const reportDir = this.getReportDir();
-    await fs.mkdir(reportDir, { recursive: !0 });
+    await fs.mkdir(reportDir, { recursive: !0 }), await this.generateReadme();
     for (const layerName of CANONICAL_LAYER_NAMES)
       await this.generateLayerReport(layerName);
   }
@@ -78,7 +85,7 @@ class ModelReportOrchestrator {
    * Get the full file path for a layer report.
    */
   getReportFilePath(layerName) {
-    const layerNumber = getLayerOrder(layerName), filename = `${String(layerNumber).padStart(2, "0")}-${layerName}-layer-report.md`;
+    const filename = getLayerReportFileName(layerName);
     return path.join(this.getReportDir(), filename);
   }
   /**
@@ -91,11 +98,27 @@ class ModelReportOrchestrator {
     try {
       data = this.collector.collectLayerData(this.model, layerName), markdown = this.generator.generate(data);
     } catch (error) {
-      throw new Error(`Failed to generate report content for layer: ${layerName} (programming error or corrupted model) - ${getErrorMessage(error)}`);
+      throw new Error(`Failed to generate report content for layer: ${layerName} (programming error or corrupted model) - ${getErrorMessage(error)}`, { cause: error });
     }
     const filePath = this.getReportFilePath(layerName);
     await fs.writeFile(filePath, markdown, "utf-8");
   }
+  /**
+   * Generate and write the model README.
+   * Separates concerns to distinguish programming bugs from I/O errors.
+   * Lets generation and write errors propagate so callers can handle them with proper telemetry.
+   * README is written to documentation-robotics/README.md (outside reports/ folder).
+   */
+  async generateReadme() {
+    let data, markdown;
+    try {
+      data = this.collector.collectModelData(this.model), markdown = this.readmeGenerator.generate(data);
+    } catch (error) {
+      throw new Error(`Failed to generate README content (programming error or corrupted model) - ${getErrorMessage(error)}`, { cause: error });
+    }
+    const filePath = path.join(this.rootPath, "documentation-robotics", "README.md");
+    await fs.writeFile(filePath, markdown, "utf-8");
+  }
 }
 export {
   ModelReportOrchestrator

package/dist/reports/model-report-orchestrator.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/reports/model-report-orchestrator.ts"],
-  "sourcesContent": ["/**\n * Model Report Orchestrator\n *\n * Coordinates report generation across all 13 architecture layers.\n * Determines which reports need regeneration and manages the report directory.\n */\n\nimport type { Model } from '../core/model.js';\nimport { ModelReportDataCollector } from './model-report-data.js';\nimport { ModelLayerReportGenerator } from './model-layer-report-generator.js';\nimport { CANONICAL_LAYER_NAMES, type CanonicalLayerName, getLayerOrder, isValidLayerName } from '../core/layers.js';\nimport { getErrorMessage } from '../utils/errors.js';\nimport * as fs from 'fs/promises';\nimport * as path from 'path';\n\nexport class ModelReportOrchestrator {\n  private collector: ModelReportDataCollector;\n  private generator: ModelLayerReportGenerator;\n\n  constructor(private model: Model, private rootPath: string) {\n    this.collector = new ModelReportDataCollector();\n    const modelVersion = model.manifest.version || 'unknown';\n    const generatedAt = new Date().toISOString();\n    this.generator = new ModelLayerReportGenerator(modelVersion, generatedAt);\n  }\n\n  /**\n   * Regenerate reports for a specific set of affected layers.\n   * On first invocation or when reports don't exist, regenerates all 13 reports.\n   * Invalid layer names in the affected set are skipped with a warning.\n   */\n  async regenerate(affectedLayers: Set<string>): Promise<void> {\n    if (!(await this.isInitialized())) {\n      return this.regenerateAll();\n    }\n\n    for (const layerName of affectedLayers) {\n      // Type predicate narrows layerName to CanonicalLayerName automatically\n      if (!isValidLayerName(layerName)) {\n        console.warn(`Skipping invalid layer name: ${layerName}`);\n        continue;\n      }\n      await this.generateLayerReport(layerName);\n    }\n  }\n\n  /**\n   * Regenerate all 13 layer reports.\n   * Lets mkdir errors propagate so callers can handle them with proper telemetry.\n   */\n  async regenerateAll(): Promise<void> {\n    // Ensure report directory exists\n    const reportDir = this.getReportDir();\n    await fs.mkdir(reportDir, { recursive: true });\n\n    // Generate all 13 layer reports\n    for (const layerName of CANONICAL_LAYER_NAMES) {\n      await this.generateLayerReport(layerName);\n    }\n  }\n\n  /**\n   * Compute the set of layers affected by a change to a primary layer.\n   * Returns the primary layer plus any layers that have cross-layer relationships with it.\n   * Throws if the primary layer is not a recognized canonical layer name.\n   */\n  computeAffectedLayers(primaryLayer: CanonicalLayerName): Set<CanonicalLayerName> {\n    // Defense-in-depth: validate despite type signature (guards against as casts from callers)\n    if (!isValidLayerName(primaryLayer)) {\n      throw new Error(\n        `Invalid primary layer name: '${primaryLayer}' is not a recognized canonical layer. ` +\n        `Valid layers are: ${CANONICAL_LAYER_NAMES.join(', ')}`\n      );\n    }\n\n    const affected = new Set<CanonicalLayerName>([primaryLayer]);\n\n    for (const rel of this.model.relationships.getAll()) {\n      // Outbound: this layer references another layer\n      if (rel.layer === primaryLayer && rel.targetLayer) {\n        // Validate layer name before casting (defensive: guards against user-editable YAML with invalid layer names)\n        if (isValidLayerName(rel.targetLayer)) {\n          affected.add(rel.targetLayer);\n        }\n      }\n      // Inbound: another layer references this layer\n      if (rel.targetLayer === primaryLayer) {\n        // Validate layer name before casting (defensive: guards against user-editable YAML with invalid layer names)\n        if (isValidLayerName(rel.layer)) {\n          affected.add(rel.layer);\n        }\n      }\n    }\n\n    return affected;\n  }\n\n  /**\n   * Check if all 13 report files exist and are initialized.\n   * Returns false only if files don't exist (ENOENT); propagates other errors like EACCES, EMFILE, EIO.\n   */\n  private async isInitialized(): Promise<boolean> {\n    for (const layerName of CANONICAL_LAYER_NAMES) {\n      try {\n        await fs.access(this.getReportFilePath(layerName));\n      } catch (error: unknown) {\n        const err = error as NodeJS.ErrnoException;\n        // Only ENOENT (file not found) should return false; other errors propagate\n        if (err.code === 'ENOENT') {\n          return false;\n        }\n        // Re-throw permission errors, I/O errors, etc.\n        throw error;\n      }\n    }\n    return true;\n  }\n\n  /**\n   * Get the reports directory path.\n   */\n  private getReportDir(): string {\n    return path.join(this.rootPath, 'documentation-robotics', 'reports');\n  }\n\n  /**\n   * Get the full file path for a layer report.\n   */\n  private getReportFilePath(layerName: CanonicalLayerName): string {\n    const layerNumber = getLayerOrder(layerName);\n    const paddedNumber = String(layerNumber).padStart(2, '0');\n    const filename = `${paddedNumber}-${layerName}-layer-report.md`;\n    return path.join(this.getReportDir(), filename);\n  }\n\n  /**\n   * Generate and write a single layer report.\n   * Separates concerns to distinguish programming bugs from I/O errors.\n   * Lets generation and write errors propagate so callers can handle them with proper telemetry.\n   */\n  private async generateLayerReport(layerName: CanonicalLayerName): Promise<void> {\n    let data;\n    let markdown;\n\n    try {\n      // Collect layer data (may throw if programming bug or model is corrupted)\n      data = this.collector.collectLayerData(this.model, layerName);\n\n      // Generate markdown report (may throw if programming bug)\n      markdown = this.generator.generate(data);\n    } catch (error) {\n      throw new Error(\n        `Failed to generate report content for layer: ${layerName} (programming error or corrupted model) - ${getErrorMessage(error)}`\n      );\n    }\n\n    // Write to file (may throw for I/O errors like ENOSPC, EACCES, EIO)\n    // Let write errors propagate so callers can handle them with proper telemetry\n    const filePath = this.getReportFilePath(layerName);\n    await fs.writeFile(filePath, markdown, 'utf-8');\n  }\n}\n"],
-  "mappings": "AAQA,SAAS,gCAAgC;AACzC,SAAS,iCAAiC;AAC1C,SAAS,uBAAgD,eAAe,wBAAwB;AAChG,SAAS,uBAAuB;AAChC,YAAY,QAAQ;AACpB,YAAY,UAAU;AAEhB,MAAO,wBAAuB;EAId;EAAsB;EAHlC;EACA;EAER,YAAoB,OAAsB,UAAgB;AAAtC,SAAA,QAAA,OAAsB,KAAA,WAAA,UACxC,KAAK,YAAY,IAAI,yBAAwB;AAC7C,UAAM,eAAe,MAAM,SAAS,WAAW,WACzC,eAAc,oBAAI,KAAI,GAAG,YAAW;AAC1C,SAAK,YAAY,IAAI,0BAA0B,cAAc,WAAW;EAC1E;;;;;;EAOA,MAAM,WAAW,gBAA2B;AAC1C,QAAI,CAAE,MAAM,KAAK,cAAa;AAC5B,aAAO,KAAK,cAAa;AAG3B,eAAW,aAAa,gBAAgB;AAEtC,UAAI,CAAC,iBAAiB,SAAS,GAAG;AAChC,gBAAQ,KAAK,gCAAgC,SAAS,EAAE;AACxD;MACF;AACA,YAAM,KAAK,oBAAoB,SAAS;IAC1C;EACF;;;;;EAMA,MAAM,gBAAa;AAEjB,UAAM,YAAY,KAAK,aAAY;AACnC,UAAM,GAAG,MAAM,WAAW,EAAE,WAAW,GAAI,CAAE;AAG7C,eAAW,aAAa;AACtB,YAAM,KAAK,oBAAoB,SAAS;EAE5C;;;;;;EAOA,sBAAsB,cAAgC;AAEpD,QAAI,CAAC,iBAAiB,YAAY;AAChC,YAAM,IAAI,MACR,gCAAgC,YAAY,4DACvB,sBAAsB,KAAK,IAAI,CAAC,EAAE;AAI3D,UAAM,WAAW,oBAAI,IAAwB,CAAC,YAAY,CAAC;AAE3D,eAAW,OAAO,KAAK,MAAM,cAAc,OAAM;AAE/C,MAAI,IAAI,UAAU,gBAAgB,IAAI,eAEhC,iBAAiB,IAAI,WAAW,KAClC,SAAS,IAAI,IAAI,WAAW,GAI5B,IAAI,gBAAgB,gBAElB,iBAAiB,IAAI,KAAK,KAC5B,SAAS,IAAI,IAAI,KAAK;AAK5B,WAAO;EACT;;;;;EAMQ,MAAM,gBAAa;AACzB,eAAW,aAAa;AACtB,UAAI;AACF,cAAM,GAAG,OAAO,KAAK,kBAAkB,SAAS,CAAC;MACnD,SAAS,OAAgB;AAGvB,YAFY,MAEJ,SAAS;AACf,iBAAO;AAGT,cAAM;MACR;AAEF,WAAO;EACT;;;;EAKQ,eAAY;AAClB,WAAO,KAAK,KAAK,KAAK,UAAU,0BAA0B,SAAS;EACrE;;;;EAKQ,kBAAkB,WAA6B;AACrD,UAAM,cAAc,cAAc,SAAS,GAErC,WAAW,GADI,OAAO,WAAW,EAAE,SAAS,GAAG,GAAG,CACxB,IAAI,SAAS;AAC7C,WAAO,KAAK,KAAK,KAAK,aAAY,GAAI,QAAQ;EAChD;;;;;;EAOQ,MAAM,oBAAoB,WAA6B;AAC7D,QAAI,MACA;AAEJ,QAAI;AAEF,aAAO,KAAK,UAAU,iBAAiB,KAAK,OAAO,SAAS,GAG5D,WAAW,KAAK,UAAU,SAAS,IAAI;IACzC,SAAS,OAAO;AACd,YAAM,IAAI,MACR,gDAAgD,SAAS,6CAA6C,gBAAgB,KAAK,CAAC,EAAE;IAElI;AAIA,UAAM,WAAW,KAAK,kBAAkB,SAAS;AACjD,UAAM,GAAG,UAAU,UAAU,UAAU,OAAO;EAChD;;",
+  "sourcesContent": ["/**\n * Model Report Orchestrator\n *\n * Coordinates report generation across all 13 architecture layers.\n * Determines which reports need regeneration and manages the report directory.\n */\n\nimport type { Model } from '../core/model.js';\nimport { ModelReportDataCollector } from './model-report-data.js';\nimport { ModelLayerReportGenerator } from './model-layer-report-generator.js';\nimport { ModelReadmeGenerator } from './model-readme-generator.js';\nimport { CANONICAL_LAYER_NAMES, type CanonicalLayerName, isValidLayerName } from '../core/layers.js';\nimport { getErrorMessage } from '../utils/errors.js';\nimport { getLayerReportFileName } from './model-report-utils.js';\nimport * as fs from 'fs/promises';\nimport * as path from 'path';\n\nexport class ModelReportOrchestrator {\n  private collector: ModelReportDataCollector;\n  private generator: ModelLayerReportGenerator;\n  private readmeGenerator: ModelReadmeGenerator;\n\n  constructor(private model: Model, private rootPath: string) {\n    this.collector = new ModelReportDataCollector();\n    const modelVersion = model.manifest.version || 'unknown';\n    const generatedAt = new Date().toISOString();\n    this.generator = new ModelLayerReportGenerator(modelVersion, generatedAt);\n    this.readmeGenerator = new ModelReadmeGenerator(generatedAt);\n  }\n\n  /**\n   * Regenerate reports for a specific set of affected layers.\n   * On first invocation or when reports don't exist, regenerates all 13 reports.\n   * Invalid layer names in the affected set are skipped with a warning.\n   * Also regenerates the README since it contains model-wide stats that may have changed.\n   * README is generated first so it exists even if a layer report throws.\n   */\n  async regenerate(affectedLayers: Set<string>): Promise<void> {\n    if (!(await this.isInitialized())) {\n      return this.regenerateAll();\n    }\n\n    // Generate README first so it exists even if a layer report throws\n    await this.generateReadme();\n\n    for (const layerName of affectedLayers) {\n      // Type predicate narrows layerName to CanonicalLayerName automatically\n      if (!isValidLayerName(layerName)) {\n        console.warn(`Skipping invalid layer name: ${layerName}`);\n        continue;\n      }\n      await this.generateLayerReport(layerName);\n    }\n  }\n\n  /**\n   * Regenerate all 13 layer reports and the README.\n   * Lets mkdir errors propagate so callers can handle them with proper telemetry.\n   * README is generated first so it exists even if a layer report throws.\n   */\n  async regenerateAll(): Promise<void> {\n    // Ensure report directory exists\n    const reportDir = this.getReportDir();\n    await fs.mkdir(reportDir, { recursive: true });\n\n    // Generate README first so it exists even if a layer report throws\n    await this.generateReadme();\n\n    // Generate all 13 layer reports\n    for (const layerName of CANONICAL_LAYER_NAMES) {\n      await this.generateLayerReport(layerName);\n    }\n  }\n\n  /**\n   * Compute the set of layers affected by a change to a primary layer.\n   * Returns the primary layer plus any layers that have cross-layer relationships with it.\n   * Throws if the primary layer is not a recognized canonical layer name.\n   */\n  computeAffectedLayers(primaryLayer: CanonicalLayerName): Set<CanonicalLayerName> {\n    // Defense-in-depth: validate despite type signature (guards against as casts from callers)\n    if (!isValidLayerName(primaryLayer)) {\n      throw new Error(\n        `Invalid primary layer name: '${primaryLayer}' is not a recognized canonical layer. ` +\n        `Valid layers are: ${CANONICAL_LAYER_NAMES.join(', ')}`\n      );\n    }\n\n    const affected = new Set<CanonicalLayerName>([primaryLayer]);\n\n    for (const rel of this.model.relationships.getAll()) {\n      // Outbound: this layer references another layer\n      if (rel.layer === primaryLayer && rel.targetLayer) {\n        // Validate layer name before casting (defensive: guards against user-editable YAML with invalid layer names)\n        if (isValidLayerName(rel.targetLayer)) {\n          affected.add(rel.targetLayer);\n        }\n      }\n      // Inbound: another layer references this layer\n      if (rel.targetLayer === primaryLayer) {\n        // Validate layer name before casting (defensive: guards against user-editable YAML with invalid layer names)\n        if (isValidLayerName(rel.layer)) {\n          affected.add(rel.layer);\n        }\n      }\n    }\n\n    return affected;\n  }\n\n  /**\n   * Check if all 13 report files exist and are initialized.\n   * Returns false only if files don't exist (ENOENT); propagates other errors like EACCES, EMFILE, EIO.\n   */\n  private async isInitialized(): Promise<boolean> {\n    for (const layerName of CANONICAL_LAYER_NAMES) {\n      try {\n        await fs.access(this.getReportFilePath(layerName));\n      } catch (error: unknown) {\n        const err = error as NodeJS.ErrnoException;\n        // Only ENOENT (file not found) should return false; other errors propagate\n        if (err.code === 'ENOENT') {\n          return false;\n        }\n        // Re-throw permission errors, I/O errors, etc.\n        throw error;\n      }\n    }\n    return true;\n  }\n\n  /**\n   * Get the reports directory path.\n   */\n  private getReportDir(): string {\n    return path.join(this.rootPath, 'documentation-robotics', 'reports');\n  }\n\n  /**\n   * Get the full file path for a layer report.\n   */\n  private getReportFilePath(layerName: CanonicalLayerName): string {\n    const filename = getLayerReportFileName(layerName);\n    return path.join(this.getReportDir(), filename);\n  }\n\n  /**\n   * Generate and write a single layer report.\n   * Separates concerns to distinguish programming bugs from I/O errors.\n   * Lets generation and write errors propagate so callers can handle them with proper telemetry.\n   */\n  private async generateLayerReport(layerName: CanonicalLayerName): Promise<void> {\n    let data;\n    let markdown;\n\n    try {\n      // Collect layer data (may throw if programming bug or model is corrupted)\n      data = this.collector.collectLayerData(this.model, layerName);\n\n      // Generate markdown report (may throw if programming bug)\n      markdown = this.generator.generate(data);\n    } catch (error) {\n      throw new Error(\n        `Failed to generate report content for layer: ${layerName} (programming error or corrupted model) - ${getErrorMessage(error)}`,\n        { cause: error }\n      );\n    }\n\n    // Write to file (may throw for I/O errors like ENOSPC, EACCES, EIO)\n    // Let write errors propagate so callers can handle them with proper telemetry\n    const filePath = this.getReportFilePath(layerName);\n    await fs.writeFile(filePath, markdown, 'utf-8');\n  }\n\n  /**\n   * Generate and write the model README.\n   * Separates concerns to distinguish programming bugs from I/O errors.\n   * Lets generation and write errors propagate so callers can handle them with proper telemetry.\n   * README is written to documentation-robotics/README.md (outside reports/ folder).\n   */\n  private async generateReadme(): Promise<void> {\n    let data;\n    let markdown;\n\n    try {\n      // Collect model-wide data (may throw if programming bug or model is corrupted)\n      data = this.collector.collectModelData(this.model);\n\n      // Generate markdown README (may throw if programming bug)\n      markdown = this.readmeGenerator.generate(data);\n    } catch (error) {\n      throw new Error(\n        `Failed to generate README content (programming error or corrupted model) - ${getErrorMessage(error)}`,\n        { cause: error }\n      );\n    }\n\n    // Write to file (may throw for I/O errors like ENOSPC, EACCES, EIO)\n    // Let write errors propagate so callers can handle them with proper telemetry\n    const filePath = path.join(this.rootPath, 'documentation-robotics', 'README.md');\n    await fs.writeFile(filePath, markdown, 'utf-8');\n  }\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/reports/model-report-utils.js

@@ -0,0 +1,9 @@
+import { getLayerOrder } from "../core/layers.js";
+function getLayerReportFileName(layerName) {
+  const layerNumber = getLayerOrder(layerName);
+  return `${String(layerNumber).padStart(2, "0")}-${layerName}-layer-report.md`;
+}
+export {
+  getLayerReportFileName
+};
+//# sourceMappingURL=model-report-utils.js.map

package/dist/reports/model-report-utils.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/reports/model-report-utils.ts"],
+  "sourcesContent": ["import type { CanonicalLayerName } from '../core/layers.js';\nimport { getLayerOrder } from '../core/layers.js';\n\n/**\n * Generate the report filename for a layer using the shared pattern: {NN}-{layerName}-layer-report.md\n *\n * @param layerName - The canonical layer name (e.g., 'api', 'data-model')\n * @returns The filename string with zero-padded layer number\n */\nexport function getLayerReportFileName(layerName: CanonicalLayerName): string {\n  const layerNumber = getLayerOrder(layerName);\n  const paddedNumber = String(layerNumber).padStart(2, '0');\n  return `${paddedNumber}-${layerName}-layer-report.md`;\n}\n"],
+  "mappings": "AACA,SAAS,qBAAqB;AAQxB,SAAU,uBAAuB,WAA6B;AAClE,QAAM,cAAc,cAAc,SAAS;AAE3C,SAAO,GADc,OAAO,WAAW,EAAE,SAAS,GAAG,GAAG,CAClC,IAAI,SAAS;AACrC;",
+  "names": []
+}

package/dist/schemas/bundled/analyzers/cbm.json

@@ -1,7 +1,7 @@
 {
   "name": "cbm",
-  "version": "0.9.0",
-  "source_version": "0.9.0",
+  "version": "0.10.0",
+  "source_version": "0.10.0",
   "analyzer": {
     "name": "cbm",
     "display_name": "codebase-memory-mcp",

package/dist/schemas/bundled/analyzers/manifest.json

@@ -1,9 +1,9 @@
 {
-  "specVersion": "0.9.0",
+  "specVersion": "0.10.0",
   "analyzers": [
     {
       "name": "cbm",
-      "version": "0.9.0"
+      "version": "0.10.0"
     }
   ]
 }

package/dist/schemas/bundled/api.json

@@ -1,5 +1,5 @@
 {
-  "specVersion": "0.9.0",
+  "specVersion": "0.10.0",
   "layer": {
     "id": "api",
     "number": 7,

package/dist/schemas/bundled/apm.json

@@ -1,5 +1,5 @@
 {
-  "specVersion": "0.9.0",
+  "specVersion": "0.10.0",
   "layer": {
     "id": "apm",
     "number": 12,

package/dist/schemas/bundled/application.json

@@ -1,5 +1,5 @@
 {
-  "specVersion": "0.9.0",
+  "specVersion": "0.10.0",
   "layer": {
     "id": "application",
     "number": 5,
@@ -1073,6 +1073,17 @@
       "strength": "medium",
       "required": false
     },
+    "application.applicationservice.accesses.application.dataobject": {
+      "id": "application.applicationservice.accesses.application.dataobject",
+      "source_spec_node_id": "application.applicationservice",
+      "source_layer": "application",
+      "destination_spec_node_id": "application.dataobject",
+      "destination_layer": "application",
+      "predicate": "accesses",
+      "cardinality": "many-to-many",
+      "strength": "medium",
+      "required": false
+    },
     "application.applicationservice.constrained-by.security.accesscondition": {
       "id": "application.applicationservice.constrained-by.security.accesscondition",
       "source_spec_node_id": "application.applicationservice",

package/dist/schemas/bundled/base.json

@@ -1,5 +1,5 @@
 {
-  "specVersion": "0.9.0",
+  "specVersion": "0.10.0",
   "schemas": {
     "spec-node": {
       "$schema": "http://json-schema.org/draft-07/schema#",

package/dist/schemas/bundled/business.json

@@ -1,5 +1,5 @@
 {
-  "specVersion": "0.9.0",
+  "specVersion": "0.10.0",
   "layer": {
     "id": "business",
     "number": 2,

package/dist/schemas/bundled/data-model.json

@@ -1,5 +1,5 @@
 {
-  "specVersion": "0.9.0",
+  "specVersion": "0.10.0",
   "layer": {
     "id": "data-model",
     "number": 8,
@@ -202,7 +202,10 @@
               "description": "Schema applied to all property names of the object instance for name validation"
             },
             "required": {
-              "type": "string"
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
             },
             "additionalProperties": {
               "type": "string"
@@ -777,6 +780,17 @@
       "strength": "medium",
       "required": false
     },
+    "data-model.objectschema.maps-to.data-store.collection": {
+      "id": "data-model.objectschema.maps-to.data-store.collection",
+      "source_spec_node_id": "data-model.objectschema",
+      "source_layer": "data-model",
+      "destination_spec_node_id": "data-store.collection",
+      "destination_layer": "data-store",
+      "predicate": "maps-to",
+      "cardinality": "many-to-many",
+      "strength": "medium",
+      "required": false
+    },
     "data-model.objectschema.maps-to.api.requestbody": {
       "id": "data-model.objectschema.maps-to.api.requestbody",
       "source_spec_node_id": "data-model.objectschema",
@@ -887,6 +901,28 @@
       "strength": "medium",
       "required": false
     },
+    "data-model.objectschema.serves.application.applicationcomponent": {
+      "id": "data-model.objectschema.serves.application.applicationcomponent",
+      "source_spec_node_id": "data-model.objectschema",
+      "source_layer": "data-model",
+      "destination_spec_node_id": "application.applicationcomponent",
+      "destination_layer": "application",
+      "predicate": "serves",
+      "cardinality": "many-to-many",
+      "strength": "medium",
+      "required": false
+    },
+    "data-model.objectschema.serves.application.applicationfunction": {
+      "id": "data-model.objectschema.serves.application.applicationfunction",
+      "source_spec_node_id": "data-model.objectschema",
+      "source_layer": "data-model",
+      "destination_spec_node_id": "application.applicationfunction",
+      "destination_layer": "application",
+      "predicate": "serves",
+      "cardinality": "many-to-many",
+      "strength": "medium",
+      "required": false
+    },
     "data-model.reference.maps-to.application.applicationservice": {
       "id": "data-model.reference.maps-to.application.applicationservice",
       "source_spec_node_id": "data-model.reference",

package/dist/schemas/bundled/data-store.json

@@ -1,5 +1,5 @@
 {
-  "specVersion": "0.9.0",
+  "specVersion": "0.10.0",
   "layer": {
     "id": "data-store",
     "number": 9,

package/dist/schemas/bundled/manifest.json

@@ -1,5 +1,5 @@
 {
-  "specVersion": "0.9.0",
+  "specVersion": "0.10.0",
   "layers": [
     {
       "id": "motivation",
@@ -34,7 +34,7 @@
       "number": 5,
       "name": "Application Layer",
       "nodeTypeCount": 9,
-      "relationshipCount": 79
+      "relationshipCount": 80
     },
     {
       "id": "technology",
@@ -55,7 +55,7 @@
       "number": 8,
       "name": "Data Model Layer",
       "nodeTypeCount": 9,
-      "relationshipCount": 71
+      "relationshipCount": 74
     },
     {
       "id": "data-store",
@@ -95,6 +95,6 @@
   ],
   "totals": {
     "nodeTypes": 191,
-    "relationships": 1585
+    "relationships": 1589
   }
 }

package/dist/schemas/bundled/motivation.json

@@ -1,5 +1,5 @@
 {
-  "specVersion": "0.9.0",
+  "specVersion": "0.10.0",
   "layer": {
     "id": "motivation",
     "number": 1,

package/dist/schemas/bundled/navigation.json

@@ -1,5 +1,5 @@
 {
-  "specVersion": "0.9.0",
+  "specVersion": "0.10.0",
   "layer": {
     "id": "navigation",
     "number": 11,

package/dist/schemas/bundled/product.json

@@ -1,5 +1,5 @@
 {
-  "specVersion": "0.9.0",
+  "specVersion": "0.10.0",
   "layer": {
     "id": "product",
     "number": 3,

package/dist/schemas/bundled/security.json

@@ -1,5 +1,5 @@
 {
-  "specVersion": "0.9.0",
+  "specVersion": "0.10.0",
   "layer": {
     "id": "security",
     "number": 4,

package/dist/schemas/bundled/technology.json

@@ -1,5 +1,5 @@
 {
-  "specVersion": "0.9.0",
+  "specVersion": "0.10.0",
   "layer": {
     "id": "technology",
     "number": 6,