@documentation-robotics/cli 0.1.0 → 0.1.7

package/dist/core/element.js

@@ -1,62 +1,133 @@
 class Element {
-  id;
-  type;
-  name;
+  // Spec-node aligned required fields
+  id = "";
+  path = "";
+  spec_node_id = "";
+  type = "";
+  layer_id = "";
+  name = "";
+  // Spec-node aligned optional fields
   description;
-  properties;
-  references;
-  relationships;
+  attributes = {};
+  source_reference;
+  metadata;
+  // Relationship tracking
+  references = [];
+  relationships = [];
+  // Internal tracking (unchanged)
   layer;
-  // Track which layer this element belongs to (Python CLI compatibility)
   filePath;
-  // Track source file path for saving back (Python CLI compatibility)
   rawData;
-  // Preserve raw YAML data to avoid losing unknown fields (Python CLI compatibility)
+  // Original semantic ID mapping (for legacy format elements converted to UUID)
+  // Used to look up elements by their original semantic ID after UUID conversion
+  semanticId;
   constructor(data) {
-    this.id = data.id, this.type = data.type, this.name = data.name, this.description = data.description, this.properties = data.properties ?? {}, this.references = data.references ?? [], this.relationships = data.relationships ?? [], this.layer = data.layer, this.filePath = data.filePath, this.rawData = data.rawData;
+    this.initializeFromSpecNode(data);
   }
   /**
-   * Get a property by key with type inference
+   * Initialize Element from spec-node aligned format
    */
-  getProperty(key) {
-    return this.properties[key];
+  initializeFromSpecNode(data) {
+    if (!data.id)
+      throw new Error("Element must have an 'id' field. Missing ID prevents proper element tracking and causes silent data loss.");
+    this.id = data.id, this.path = data.path || "", this.spec_node_id = data.spec_node_id || "", this.type = data.type || "", this.layer_id = data.layer_id || "", this.name = data.name || "", this.description = data.description, this.attributes = data.attributes || {}, data.source_reference && (this.source_reference = data.source_reference), this.metadata = data.metadata, this.references = data.references || [], this.relationships = data.relationships || [], this.layer = data.layer || data.layer_id, this.filePath = data.filePath, this.rawData = data.rawData, this.semanticId = data.semanticId;
   }
   /**
-   * Set a property by key
+   * Convert Element to spec-node format for validation
+   * Returns object that matches spec-node.schema.json structure
    */
-  setProperty(key, value) {
-    this.properties[key] = value;
+  toSpecNode() {
+    return {
+      id: this.id,
+      path: this.path,
+      spec_node_id: this.spec_node_id,
+      type: this.type,
+      layer_id: this.layer_id,
+      name: this.name,
+      ...this.description && { description: this.description },
+      attributes: this.attributes,
+      ...this.source_reference && { source_reference: this.source_reference },
+      ...this.metadata && { metadata: this.metadata }
+    };
+  }
+  /**
+   * Create Element from spec-node format
+   */
+  static fromSpecNode(data) {
+    return new Element({
+      id: data.id,
+      path: data.path,
+      spec_node_id: data.spec_node_id,
+      type: data.type,
+      layer_id: data.layer_id,
+      name: data.name,
+      description: data.description,
+      attributes: data.attributes || {},
+      source_reference: data.source_reference,
+      metadata: data.metadata
+    });
+  }
+  /**
+   * Get metadata with defensive copy for audit integrity
+   *
+   * Returns a deep copy of metadata to prevent external code from mutating
+   * the internal metadata object. This ensures timestamp immutability
+   * for audit trail integrity.
+   *
+   * @returns A defensive copy of the metadata object, or undefined if not set
+   */
+  getMetadata() {
+    if (this.metadata)
+      return {
+        created_at: this.metadata.created_at,
+        updated_at: this.metadata.updated_at,
+        created_by: this.metadata.created_by,
+        version: this.metadata.version
+      };
+  }
+  /**
+   * Get source reference from element
+   *
+   * Returns the source reference from the top-level source_reference field.
+   *
+   * @returns The source reference if found, undefined otherwise
+   */
+  getSourceReference() {
+    return this.source_reference;
   }
   /**
-   * Get array property with type safety
+   * Set source reference on element
+   *
+   * @param sourceRef The source reference to set, or undefined to remove existing reference
    */
-  getArrayProperty(key) {
-    const value = this.properties[key];
-    return Array.isArray(value) ? value : [];
+  setSourceReference(sourceRef) {
+    this.source_reference = sourceRef;
   }
   /**
-   * Add item to array property
+   * Check if element has a source reference
    */
-  addToArrayProperty(key, item) {
-    const current = this.getArrayProperty(key);
-    current.push(item), this.properties[key] = current;
+  hasSourceReference() {
+    return this.getSourceReference() !== void 0;
   }
   /**
-   * Serialize to JSON representation
+   * Serialize to JSON representation (spec-node aligned format)
    */
   toJSON() {
     const result = {
       id: this.id,
+      path: this.path,
+      spec_node_id: this.spec_node_id,
       type: this.type,
+      layer_id: this.layer_id,
       name: this.name
     };
-    return this.description && (result.description = this.description), Object.keys(this.properties).length > 0 && (result.properties = this.properties), this.references.length > 0 && (result.references = this.references), this.relationships.length > 0 && (result.relationships = this.relationships), result;
+    return this.description && (result.description = this.description), Object.keys(this.attributes).length > 0 && (result.attributes = this.attributes), this.source_reference && (result.source_reference = this.source_reference), this.metadata && (result.metadata = this.metadata), this.references.length > 0 && (result.references = this.references), this.relationships.length > 0 && (result.relationships = this.relationships), result;
   }
   /**
    * String representation
    */
   toString() {
-    return `Element(${this.id})`;
+    return `Element(${this.path || this.id})`;
   }
 }
 export {

package/dist/core/element.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/core/element.ts"],
-  "sourcesContent": ["import type { Element as IElement, Reference, Relationship } from \"../types/index.js\";\n\n/**\n * Element class representing an individual architecture item\n */\nexport class Element implements IElement {\n  id: string;\n  type: string;\n  name: string;\n  description?: string;\n  properties: Record<string, unknown>;\n  references: Reference[];\n  relationships: Relationship[];\n  layer?: string;  // Track which layer this element belongs to (Python CLI compatibility)\n  filePath?: string;  // Track source file path for saving back (Python CLI compatibility)\n  rawData?: any;  // Preserve raw YAML data to avoid losing unknown fields (Python CLI compatibility)\n\n  constructor(data: {\n    id: string;\n    type: string;\n    name: string;\n    description?: string;\n    properties?: Record<string, unknown>;\n    references?: Reference[];\n    relationships?: Relationship[];\n    layer?: string;\n    filePath?: string;\n    rawData?: any;\n  }) {\n    this.id = data.id;\n    this.type = data.type;\n    this.name = data.name;\n    this.description = data.description;\n    this.properties = data.properties ?? {};\n    this.references = data.references ?? [];\n    this.relationships = data.relationships ?? [];\n    this.layer = data.layer;\n    this.filePath = data.filePath;\n    this.rawData = data.rawData;\n  }\n\n  /**\n   * Get a property by key with type inference\n   */\n  getProperty<T>(key: string): T | undefined {\n    return this.properties[key] as T | undefined;\n  }\n\n  /**\n   * Set a property by key\n   */\n  setProperty(key: string, value: unknown): void {\n    this.properties[key] = value;\n  }\n\n  /**\n   * Get array property with type safety\n   */\n  getArrayProperty<T>(key: string): T[] {\n    const value = this.properties[key];\n    if (Array.isArray(value)) {\n      return value as T[];\n    }\n    return [];\n  }\n\n  /**\n   * Add item to array property\n   */\n  addToArrayProperty<T>(key: string, item: T): void {\n    const current = this.getArrayProperty<T>(key);\n    current.push(item);\n    this.properties[key] = current;\n  }\n\n  /**\n   * Serialize to JSON representation\n   */\n  toJSON(): IElement {\n    const result: IElement = {\n      id: this.id,\n      type: this.type,\n      name: this.name,\n    };\n\n    if (this.description) {\n      result.description = this.description;\n    }\n\n    if (Object.keys(this.properties).length > 0) {\n      result.properties = this.properties;\n    }\n\n    if (this.references.length > 0) {\n      result.references = this.references;\n    }\n\n    if (this.relationships.length > 0) {\n      result.relationships = this.relationships;\n    }\n\n    return result;\n  }\n\n  /**\n   * String representation\n   */\n  toString(): string {\n    return `Element(${this.id})`;\n  }\n}\n"],
-  "mappings": "AAKM,MAAO,QAAO;EAClB;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;EACA;;EACA;;EAEA,YAAY,MAWX;AACC,SAAK,KAAK,KAAK,IACf,KAAK,OAAO,KAAK,MACjB,KAAK,OAAO,KAAK,MACjB,KAAK,cAAc,KAAK,aACxB,KAAK,aAAa,KAAK,cAAc,CAAA,GACrC,KAAK,aAAa,KAAK,cAAc,CAAA,GACrC,KAAK,gBAAgB,KAAK,iBAAiB,CAAA,GAC3C,KAAK,QAAQ,KAAK,OAClB,KAAK,WAAW,KAAK,UACrB,KAAK,UAAU,KAAK;EACtB;;;;EAKA,YAAe,KAAW;AACxB,WAAO,KAAK,WAAW,GAAG;EAC5B;;;;EAKA,YAAY,KAAa,OAAc;AACrC,SAAK,WAAW,GAAG,IAAI;EACzB;;;;EAKA,iBAAoB,KAAW;AAC7B,UAAM,QAAQ,KAAK,WAAW,GAAG;AACjC,WAAI,MAAM,QAAQ,KAAK,IACd,QAEF,CAAA;EACT;;;;EAKA,mBAAsB,KAAa,MAAO;AACxC,UAAM,UAAU,KAAK,iBAAoB,GAAG;AAC5C,YAAQ,KAAK,IAAI,GACjB,KAAK,WAAW,GAAG,IAAI;EACzB;;;;EAKA,SAAM;AACJ,UAAM,SAAmB;MACvB,IAAI,KAAK;MACT,MAAM,KAAK;MACX,MAAM,KAAK;;AAGb,WAAI,KAAK,gBACP,OAAO,cAAc,KAAK,cAGxB,OAAO,KAAK,KAAK,UAAU,EAAE,SAAS,MACxC,OAAO,aAAa,KAAK,aAGvB,KAAK,WAAW,SAAS,MAC3B,OAAO,aAAa,KAAK,aAGvB,KAAK,cAAc,SAAS,MAC9B,OAAO,gBAAgB,KAAK,gBAGvB;EACT;;;;EAKA,WAAQ;AACN,WAAO,WAAW,KAAK,EAAE;EAC3B;;",
+  "sourcesContent": ["import type {\n  Element as IElement,\n  ElementMetadata,\n  Reference,\n  Relationship,\n  SourceReference,\n} from \"../types/index.js\";\n\n/**\n * Element class representing an individual architecture item\n *\n * Aligns with spec-node.schema.json structure for direct validation.\n * Provides type-safe access to spec-node aligned fields with source reference support.\n */\nexport class Element implements IElement {\n  // Spec-node aligned required fields\n  id: string = \"\";\n  path: string = \"\";\n  spec_node_id: string = \"\";\n  type: string = \"\";\n  layer_id: string = \"\";\n  name: string = \"\";\n\n  // Spec-node aligned optional fields\n  description?: string;\n  attributes: Record<string, unknown> = {};\n  source_reference?: SourceReference;\n  metadata?: ElementMetadata;\n\n  // Relationship tracking\n  references: Reference[] = [];\n  relationships: Relationship[] = [];\n\n  // Internal tracking (unchanged)\n  layer?: string;\n  filePath?: string;\n  rawData?: any;\n\n  // Original semantic ID mapping (for legacy format elements converted to UUID)\n  // Used to look up elements by their original semantic ID after UUID conversion\n  semanticId?: string;\n\n  constructor(data: Partial<IElement>) {\n    this.initializeFromSpecNode(data);\n  }\n\n  /**\n   * Initialize Element from spec-node aligned format\n   */\n  private initializeFromSpecNode(data: Partial<IElement>): void {\n    // ID is required\n    if (!data.id) {\n      throw new Error(\n        \"Element must have an 'id' field. Missing ID prevents proper element tracking and causes silent data loss.\"\n      );\n    }\n\n    this.id = data.id;\n    this.path = data.path || \"\";\n    this.spec_node_id = data.spec_node_id || \"\";\n    this.type = data.type || \"\";\n    this.layer_id = data.layer_id || \"\";\n    this.name = data.name || \"\";\n    this.description = data.description;\n\n    // Handle attributes - spec requires 'attributes' field only\n    this.attributes = data.attributes || {};\n\n    // Extract source_reference\n    if (data.source_reference) {\n      this.source_reference = data.source_reference;\n    }\n\n    this.metadata = data.metadata;\n\n    // Relationship tracking\n    this.references = data.references || [];\n    this.relationships = data.relationships || [];\n\n    // Internal tracking\n    this.layer = data.layer || data.layer_id;\n    this.filePath = data.filePath;\n    this.rawData = data.rawData;\n\n    // Semantic ID (for legacy format elements converted to UUID)\n    this.semanticId = (data as any).semanticId;\n  }\n\n  /**\n   * Convert Element to spec-node format for validation\n   * Returns object that matches spec-node.schema.json structure\n   */\n  toSpecNode(): Record<string, unknown> {\n    return {\n      id: this.id,\n      path: this.path,\n      spec_node_id: this.spec_node_id,\n      type: this.type,\n      layer_id: this.layer_id,\n      name: this.name,\n      ...(this.description && { description: this.description }),\n      attributes: this.attributes,\n      ...(this.source_reference && { source_reference: this.source_reference }),\n      ...(this.metadata && { metadata: this.metadata }),\n    };\n  }\n\n  /**\n   * Create Element from spec-node format\n   */\n  static fromSpecNode(data: Record<string, unknown>): Element {\n    return new Element({\n      id: data.id as string,\n      path: data.path as string | undefined,\n      spec_node_id: data.spec_node_id as string,\n      type: data.type as string,\n      layer_id: data.layer_id as string,\n      name: data.name as string,\n      description: data.description as string | undefined,\n      attributes: (data.attributes as Record<string, unknown>) || {},\n      source_reference: data.source_reference as SourceReference | undefined,\n      metadata: data.metadata as ElementMetadata | undefined,\n    });\n  }\n\n  /**\n   * Get metadata with defensive copy for audit integrity\n   *\n   * Returns a deep copy of metadata to prevent external code from mutating\n   * the internal metadata object. This ensures timestamp immutability\n   * for audit trail integrity.\n   *\n   * @returns A defensive copy of the metadata object, or undefined if not set\n   */\n  getMetadata(): ElementMetadata | undefined {\n    if (!this.metadata) {\n      return undefined;\n    }\n\n    // Return a defensive copy to prevent external mutations\n    return {\n      created_at: this.metadata.created_at,\n      updated_at: this.metadata.updated_at,\n      created_by: this.metadata.created_by,\n      version: this.metadata.version,\n    };\n  }\n\n  /**\n   * Get source reference from element\n   *\n   * Returns the source reference from the top-level source_reference field.\n   *\n   * @returns The source reference if found, undefined otherwise\n   */\n  getSourceReference(): SourceReference | undefined {\n    return this.source_reference;\n  }\n\n  /**\n   * Set source reference on element\n   *\n   * @param sourceRef The source reference to set, or undefined to remove existing reference\n   */\n  setSourceReference(sourceRef: SourceReference | undefined): void {\n    this.source_reference = sourceRef;\n  }\n\n  /**\n   * Check if element has a source reference\n   */\n  hasSourceReference(): boolean {\n    return this.getSourceReference() !== undefined;\n  }\n\n  /**\n   * Serialize to JSON representation (spec-node aligned format)\n   */\n  toJSON(): IElement {\n    const result: IElement = {\n      id: this.id,\n      path: this.path,\n      spec_node_id: this.spec_node_id,\n      type: this.type,\n      layer_id: this.layer_id,\n      name: this.name,\n    };\n\n    if (this.description) {\n      result.description = this.description;\n    }\n\n    if (Object.keys(this.attributes).length > 0) {\n      result.attributes = this.attributes;\n    }\n\n    if (this.source_reference) {\n      result.source_reference = this.source_reference;\n    }\n\n    if (this.metadata) {\n      result.metadata = this.metadata;\n    }\n\n    if (this.references.length > 0) {\n      result.references = this.references;\n    }\n\n    if (this.relationships.length > 0) {\n      result.relationships = this.relationships;\n    }\n\n    return result;\n  }\n\n  /**\n   * String representation\n   */\n  toString(): string {\n    return `Element(${this.path || this.id})`;\n  }\n}\n"],
+  "mappings": "AAcM,MAAO,QAAO;;EAElB,KAAa;EACb,OAAe;EACf,eAAuB;EACvB,OAAe;EACf,WAAmB;EACnB,OAAe;;EAGf;EACA,aAAsC,CAAA;EACtC;EACA;;EAGA,aAA0B,CAAA;EAC1B,gBAAgC,CAAA;;EAGhC;EACA;EACA;;;EAIA;EAEA,YAAY,MAAuB;AACjC,SAAK,uBAAuB,IAAI;EAClC;;;;EAKQ,uBAAuB,MAAuB;AAEpD,QAAI,CAAC,KAAK;AACR,YAAM,IAAI,MACR,2GAA2G;AAI/G,SAAK,KAAK,KAAK,IACf,KAAK,OAAO,KAAK,QAAQ,IACzB,KAAK,eAAe,KAAK,gBAAgB,IACzC,KAAK,OAAO,KAAK,QAAQ,IACzB,KAAK,WAAW,KAAK,YAAY,IACjC,KAAK,OAAO,KAAK,QAAQ,IACzB,KAAK,cAAc,KAAK,aAGxB,KAAK,aAAa,KAAK,cAAc,CAAA,GAGjC,KAAK,qBACP,KAAK,mBAAmB,KAAK,mBAG/B,KAAK,WAAW,KAAK,UAGrB,KAAK,aAAa,KAAK,cAAc,CAAA,GACrC,KAAK,gBAAgB,KAAK,iBAAiB,CAAA,GAG3C,KAAK,QAAQ,KAAK,SAAS,KAAK,UAChC,KAAK,WAAW,KAAK,UACrB,KAAK,UAAU,KAAK,SAGpB,KAAK,aAAc,KAAa;EAClC;;;;;EAMA,aAAU;AACR,WAAO;MACL,IAAI,KAAK;MACT,MAAM,KAAK;MACX,cAAc,KAAK;MACnB,MAAM,KAAK;MACX,UAAU,KAAK;MACf,MAAM,KAAK;MACX,GAAI,KAAK,eAAe,EAAE,aAAa,KAAK,YAAW;MACvD,YAAY,KAAK;MACjB,GAAI,KAAK,oBAAoB,EAAE,kBAAkB,KAAK,iBAAgB;MACtE,GAAI,KAAK,YAAY,EAAE,UAAU,KAAK,SAAQ;;EAElD;;;;EAKA,OAAO,aAAa,MAA6B;AAC/C,WAAO,IAAI,QAAQ;MACjB,IAAI,KAAK;MACT,MAAM,KAAK;MACX,cAAc,KAAK;MACnB,MAAM,KAAK;MACX,UAAU,KAAK;MACf,MAAM,KAAK;MACX,aAAa,KAAK;MAClB,YAAa,KAAK,cAA0C,CAAA;MAC5D,kBAAkB,KAAK;MACvB,UAAU,KAAK;KAChB;EACH;;;;;;;;;;EAWA,cAAW;AACT,QAAK,KAAK;AAKV,aAAO;QACL,YAAY,KAAK,SAAS;QAC1B,YAAY,KAAK,SAAS;QAC1B,YAAY,KAAK,SAAS;QAC1B,SAAS,KAAK,SAAS;;EAE3B;;;;;;;;EASA,qBAAkB;AAChB,WAAO,KAAK;EACd;;;;;;EAOA,mBAAmB,WAAsC;AACvD,SAAK,mBAAmB;EAC1B;;;;EAKA,qBAAkB;AAChB,WAAO,KAAK,mBAAkB,MAAO;EACvC;;;;EAKA,SAAM;AACJ,UAAM,SAAmB;MACvB,IAAI,KAAK;MACT,MAAM,KAAK;MACX,cAAc,KAAK;MACnB,MAAM,KAAK;MACX,UAAU,KAAK;MACf,MAAM,KAAK;;AAGb,WAAI,KAAK,gBACP,OAAO,cAAc,KAAK,cAGxB,OAAO,KAAK,KAAK,UAAU,EAAE,SAAS,MACxC,OAAO,aAAa,KAAK,aAGvB,KAAK,qBACP,OAAO,mBAAmB,KAAK,mBAG7B,KAAK,aACP,OAAO,WAAW,KAAK,WAGrB,KAAK,WAAW,SAAS,MAC3B,OAAO,aAAa,KAAK,aAGvB,KAAK,cAAc,SAAS,MAC9B,OAAO,gBAAgB,KAAK,gBAGvB;EACT;;;;EAKA,WAAQ;AACN,WAAO,WAAW,KAAK,QAAQ,KAAK,EAAE;EACxC;;",
   "names": []
 }

package/dist/core/golden-copy-cache.js

@@ -0,0 +1,290 @@
+import { Model } from "./model.js";
+import { Layer } from "./layer.js";
+import { Element } from "./element.js";
+import { mkdir, cp, rm, access } from "fs/promises";
+import { join } from "path";
+import { tmpdir } from "os";
+import { getErrorMessage } from "../utils/errors.js";
+class GoldenCopyCacheManager {
+  static instance = null;
+  static lastConfig;
+  goldenModel = null;
+  goldenRootPath = null;
+  config;
+  lifecycleState = { status: "uninitialized" };
+  stats = {
+    initCount: 0,
+    cloneCount: 0,
+    totalInitTime: 0,
+    totalCloneTime: 0,
+    avgInitTime: 0,
+    avgCloneTime: 0
+  };
+  constructor(config = {}) {
+    this.config = {
+      cacheDir: config.cacheDir || join(tmpdir(), "dr-golden-copy-cache"),
+      eagerLoad: config.eagerLoad ?? !1,
+      warmup: config.warmup ?? !1,
+      modelOptions: config.modelOptions || {
+        name: "Golden Copy Test Model",
+        version: "0.1.0",
+        specVersion: "0.7.1",
+        description: "Shared golden copy for test initialization",
+        author: "Test Suite"
+      }
+    };
+  }
+  /**
+   * Get or create the singleton instance
+   *
+   * Thread-safe: If multiple threads/workers call getInstance() concurrently
+   * with different configs, the first one wins. This is acceptable because
+   * getInstance() should be called early in test setup with consistent config.
+   *
+   * @throws Error if config differs from existing instance and GOLDEN_COPY_STRICT is enabled
+   */
+  static getInstance(config) {
+    if (!GoldenCopyCacheManager.instance)
+      GoldenCopyCacheManager.instance = new GoldenCopyCacheManager(config), GoldenCopyCacheManager.lastConfig = config;
+    else if (process.env.GOLDEN_COPY_STRICT === "true") {
+      const configStr = JSON.stringify(config || {}), lastConfigStr = JSON.stringify(GoldenCopyCacheManager.lastConfig || {});
+      configStr !== lastConfigStr && console.warn(`[GoldenCopy] WARNING: getInstance() called with different config. First config wins. Current: ${configStr}, Last: ${lastConfigStr}`);
+    }
+    return GoldenCopyCacheManager.instance;
+  }
+  /**
+   * Reset the singleton instance (useful for testing)
+   */
+  static resetInstance() {
+    GoldenCopyCacheManager.instance = null;
+  }
+  /**
+   * Initialize the golden copy cache
+   *
+   * Creates or loads a shared golden model that serves as the basis
+   * for all test model clones. This should be called once per test worker.
+   * Subsequent calls are idempotent (no-op if already initialized).
+   *
+   * Thread-safe: Concurrent calls before initialization completes are handled
+   * via initializationPromise lock. Only the first call performs actual work.
+   *
+   * @returns Promise resolving when golden copy is ready
+   */
+  async init() {
+    if (this.lifecycleState.status === "initialized") {
+      process.env.DEBUG_GOLDEN_COPY && console.log("[GoldenCopy] Already initialized, skipping init");
+      return;
+    }
+    if (this.lifecycleState.status === "initializing")
+      return process.env.DEBUG_GOLDEN_COPY && console.log("[GoldenCopy] Initialization in progress, waiting..."), this.lifecycleState.promise;
+    if (this.lifecycleState.status === "cleaned-up")
+      throw new Error("Golden copy manager has been cleaned up. Create a new instance.");
+    const initPromise = this.performInitialization();
+    this.lifecycleState = { status: "initializing", promise: initPromise };
+    try {
+      await initPromise;
+    } catch (error) {
+      throw this.lifecycleState = { status: "uninitialized" }, error;
+    }
+  }
+  /**
+   * Perform the actual initialization work
+   * @private
+   */
+  async performInitialization() {
+    const startTime = Date.now();
+    try {
+      await mkdir(this.config.cacheDir, { recursive: !0 });
+      const goldenPath = join(this.config.cacheDir, "golden-model");
+      let modelExists = !1;
+      try {
+        await access(goldenPath), modelExists = !0;
+      } catch {
+      }
+      if (modelExists)
+        this.goldenModel = await Model.load(goldenPath, { lazyLoad: !this.config.eagerLoad }), this.goldenRootPath = goldenPath;
+      else {
+        const created = await Model.init(goldenPath, {
+          name: this.config.modelOptions.name || "Golden Copy Test Model",
+          version: this.config.modelOptions.version || "0.1.0",
+          specVersion: this.config.modelOptions.specVersion || "0.7.1",
+          description: this.config.modelOptions.description || "Shared golden copy for test initialization",
+          author: this.config.modelOptions.author || "Test Suite",
+          created: (/* @__PURE__ */ new Date()).toISOString()
+        }, { lazyLoad: !this.config.eagerLoad });
+        this.goldenModel = created, this.goldenRootPath = goldenPath, this.config.warmup && (await this.populateGoldenCopy(), await created.save());
+      }
+      this.stats.initCount++, this.stats.totalInitTime += Date.now() - startTime, this.stats.avgInitTime = this.stats.totalInitTime / this.stats.initCount, this.goldenModel && this.goldenRootPath && (this.lifecycleState = {
+        status: "initialized",
+        model: this.goldenModel,
+        rootPath: this.goldenRootPath
+      }), process.env.DEBUG_GOLDEN_COPY && console.log(`[GoldenCopy] Initialized in ${Date.now() - startTime}ms`);
+    } catch (error) {
+      throw new Error(`Failed to initialize golden copy cache: ${getErrorMessage(error)}`);
+    }
+  }
+  /**
+   * Clone the golden model for test use
+   *
+   * Creates an independent copy of the golden model that a test can safely modify
+   * without affecting other tests. The clone is isolated in its own temporary directory.
+   *
+   * Handles filesystem errors:
+   * - EEXIST: Retries with new random suffix (collision handling)
+   * - ENOSPC: Reports disk full error with guidance
+   * - Other: Reports with context
+   *
+   * Differentiates between copy failures and model load failures in error messages.
+   *
+   * @returns Promise resolving to the cloned model with cleanup handler
+   */
+  async clone() {
+    if (!this.goldenModel || !this.goldenRootPath)
+      throw new Error("Golden copy cache not initialized. Call init() first.");
+    const startTime = Date.now();
+    let clonePath = null, copySuccessful = !1;
+    try {
+      clonePath = await this.generateClonePath();
+      try {
+        await cp(this.goldenRootPath, clonePath, { recursive: !0 }), copySuccessful = !0;
+      } catch (copyError) {
+        throw copyError instanceof Error && copyError.code === "ENOSPC" ? new Error(`Disk space exhausted while cloning golden copy. Ensure at least 100MB free space is available. Error: ${copyError.message}`) : new Error(`Failed to copy golden model to ${clonePath}: ${copyError instanceof Error ? copyError.message : String(copyError)}`);
+      }
+      let clonedModel;
+      try {
+        clonedModel = await Model.load(clonePath);
+      } catch (loadError) {
+        throw new Error(`Successfully copied golden model to ${clonePath}, but failed to load cloned model. This suggests corrupted source data. Error: ${loadError instanceof Error ? loadError.message : String(loadError)}`);
+      }
+      const cloneTime = Date.now() - startTime;
+      this.stats.cloneCount++, this.stats.totalCloneTime += cloneTime, this.stats.avgCloneTime = this.stats.totalCloneTime / this.stats.cloneCount, process.env.DEBUG_GOLDEN_COPY && console.log(`[GoldenCopy] Cloned model in ${cloneTime}ms (clone ${this.stats.cloneCount})`);
+      let cleanupCalled = !1;
+      return {
+        model: clonedModel,
+        rootPath: clonePath,
+        cleanup: async () => {
+          if (cleanupCalled) {
+            process.env.DEBUG_GOLDEN_COPY && console.log(`[GoldenCopy] Cleanup already called for ${clonePath}`);
+            return;
+          }
+          cleanupCalled = !0;
+          try {
+            await rm(clonePath, { recursive: !0, force: !0 });
+          } catch (e) {
+            console.error(`[GoldenCopy] ERROR: Failed to clean up cloned model at ${clonePath}. This may cause disk space issues. Error: ${e instanceof Error ? e.message : String(e)}`);
+          }
+        },
+        stats: {
+          cloneTime
+        }
+      };
+    } catch (error) {
+      if (copySuccessful && clonePath)
+        try {
+          await rm(clonePath, { recursive: !0, force: !0 });
+        } catch (cleanupError) {
+          console.error(`[GoldenCopy] ERROR: Model load failed AND cleanup failed. Orphaned directory may exist at ${clonePath}. Load error: ${getErrorMessage(error)}. Cleanup error: ${cleanupError instanceof Error ? cleanupError.message : String(cleanupError)}`);
+        }
+      throw error;
+    }
+  }
+  /**
+   * Generate a unique clone path with retry logic for EEXIST collisions
+   * @private
+   */
+  async generateClonePath(maxRetries = 5) {
+    for (let attempt = 0; attempt < maxRetries; attempt++) {
+      const cloneId = `${Date.now()}-${Math.random().toString(36).substring(2, 9)}-attempt${attempt}`, clonePath = join(tmpdir(), `dr-test-clone-${cloneId}`);
+      try {
+        await access(clonePath);
+      } catch {
+        return clonePath;
+      }
+    }
+    throw new Error(`Failed to generate unique clone path after ${maxRetries} attempts. Potential issue with concurrent test execution or stale directories.`);
+  }
+  /**
+   * Populate the golden copy with standard test data
+   *
+   * This is called during warmup to pre-populate the golden model with
+   * a canonical set of test elements across layers.
+   *
+   * @private
+   */
+  async populateGoldenCopy() {
+    if (!this.goldenModel)
+      throw new Error("Golden model not initialized");
+    const addElement = async (layerName, type, id, name, attributes) => {
+      let layer = await this.goldenModel.getLayer(layerName);
+      layer || (layer = new Layer(layerName), this.goldenModel.addLayer(layer));
+      const element = new Element({
+        id,
+        type,
+        name,
+        description: `Golden copy element: ${name}`,
+        attributes: attributes || {}
+      });
+      layer.addElement(element);
+    };
+    await addElement("motivation", "goal", "motivation.goal.golden-1", "Golden Goal 1"), await addElement("motivation", "goal", "motivation.goal.golden-2", "Golden Goal 2"), await addElement("motivation", "requirement", "motivation.requirement.golden-1", "Golden Requirement 1"), await addElement("business", "process", "business.process.golden-1", "Golden Process 1"), await addElement("business", "service", "business.service.golden-1", "Golden Service 1"), await addElement("application", "component", "application.component.golden-1", "Golden Component 1"), await addElement("application", "service", "application.service.golden-1", "Golden Service 1"), await addElement("technology", "infrastructure", "technology.infrastructure.golden-1", "Golden Infrastructure 1"), await addElement("technology", "platform", "technology.platform.golden-1", "Golden Platform 1"), await addElement("api", "endpoint", "api.endpoint.golden-1", "Golden Endpoint 1", {
+      method: "GET",
+      path: "/golden/1"
+    }), await addElement("api", "endpoint", "api.endpoint.golden-2", "Golden Endpoint 2", {
+      method: "POST",
+      path: "/golden/2"
+    }), await addElement("data-model", "entity", "data-model.entity.golden-1", "Golden Entity 1"), await addElement("data-model", "entity", "data-model.entity.golden-2", "Golden Entity 2");
+  }
+  /**
+   * Get statistics about golden copy cache performance
+   */
+  getStats() {
+    return { ...this.stats };
+  }
+  /**
+   * Check if golden copy is initialized
+   */
+  isInitialized() {
+    return this.goldenModel !== null && this.goldenRootPath !== null;
+  }
+  /**
+   * Get the golden model (immutable reference)
+   *
+   * Returns a frozen reference to prevent accidental mutations that could
+   * corrupt the shared golden copy. Direct modifications through the returned
+   * object will fail at runtime.
+   *
+   * @returns Frozen golden model or null if not initialized
+   */
+  getGoldenModel() {
+    return this.goldenModel ? Object.freeze(Object.create(Object.getPrototypeOf(this.goldenModel), Object.getOwnPropertyDescriptors(this.goldenModel))) : null;
+  }
+  /**
+   * Get the cache directory path
+   */
+  getCacheDir() {
+    return this.config.cacheDir;
+  }
+  /**
+   * Clean up the golden copy cache
+   *
+   * Removes the cached golden model and resets the cache manager.
+   * Should be called at the end of test suite execution.
+   *
+   * Idempotent: Safe to call multiple times without error.
+   */
+  async cleanup() {
+    if (this.lifecycleState.status === "cleaned-up") {
+      process.env.DEBUG_GOLDEN_COPY && console.log("[GoldenCopy] Already cleaned up, skipping");
+      return;
+    }
+    try {
+      this.goldenRootPath && await rm(this.goldenRootPath, { recursive: !0, force: !0 }), this.goldenModel = null, this.goldenRootPath = null, this.lifecycleState = { status: "cleaned-up" }, GoldenCopyCacheManager.resetInstance(), process.env.DEBUG_GOLDEN_COPY && (console.log("[GoldenCopy] Cache cleaned up"), console.log("[GoldenCopy] Stats:", this.stats));
+    } catch (error) {
+      console.error(`[GoldenCopy] ERROR: Failed to clean up golden copy cache at ${this.goldenRootPath}. This may cause disk space issues. Error: ${getErrorMessage(error)}`);
+    }
+  }
+}
+export {
+  GoldenCopyCacheManager
+};
+//# sourceMappingURL=golden-copy-cache.js.map

package/dist/core/golden-copy-cache.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/core/golden-copy-cache.ts"],
+  "sourcesContent": ["/**\n * Golden Copy Cache Management\n *\n * Provides a shared golden copy of a test model that can be efficiently cloned\n * for use across multiple tests, improving test initialization performance.\n *\n * Key Features:\n * - Single initialization of a canonical test model on first use\n * - Fast cloning via filesystem copy (copy-on-write semantics)\n * - Automatic cache lifecycle management\n * - Optional warm-up for eager element loading\n * - Support for custom golden copy configurations\n */\n\nimport { Model } from \"./model.js\";\nimport { Layer } from \"./layer.js\";\nimport { Element } from \"./element.js\";\nimport { mkdir, cp, rm, access } from \"fs/promises\";\nimport { join } from \"path\";\nimport { tmpdir } from \"os\";\nimport { getErrorMessage } from \"../utils/errors.js\";\n\n/**\n * Configuration for the golden copy cache\n */\nexport interface GoldenCopyCacheConfig {\n  /** Base directory for golden copy cache (defaults to temp directory) */\n  cacheDir?: string;\n\n  /** Whether to eagerly load all layers when creating golden copy */\n  eagerLoad?: boolean;\n\n  /** Whether to enable warm-up (populate with sample data) */\n  warmup?: boolean;\n\n  /** Custom test model options */\n  modelOptions?: {\n    name?: string;\n    version?: string;\n    specVersion?: string;\n    description?: string;\n    author?: string;\n  };\n}\n\n/**\n * Statistics for golden copy cache operations\n */\nexport interface GoldenCopyStats {\n  initCount: number;\n  cloneCount: number;\n  totalInitTime: number;\n  totalCloneTime: number;\n  avgInitTime: number;\n  avgCloneTime: number;\n}\n\n/**\n * Result of a golden copy clone operation\n */\nexport interface ClonedModel {\n  model: Model;\n  rootPath: string;\n  cleanup: () => Promise<void>;\n  stats: {\n    cloneTime: number;\n  };\n}\n\n/**\n * Lifecycle state of the golden copy manager\n */\ntype ManagerLifecycleState =\n  | { status: \"uninitialized\" }\n  | { status: \"initializing\"; promise: Promise<void> }\n  | { status: \"initialized\"; model: Model; rootPath: string }\n  | { status: \"cleaned-up\" };\n\n/**\n * Golden Copy Cache Manager\n *\n * Manages the lifecycle of a shared golden test model and provides\n * efficient cloning for individual test use.\n */\nexport class GoldenCopyCacheManager {\n  private static instance: GoldenCopyCacheManager | null = null;\n  private static lastConfig: GoldenCopyCacheConfig | undefined;\n  private goldenModel: Model | null = null;\n  private goldenRootPath: string | null = null;\n  private config: Required<GoldenCopyCacheConfig>;\n  private lifecycleState: ManagerLifecycleState = { status: \"uninitialized\" };\n  private stats: GoldenCopyStats = {\n    initCount: 0,\n    cloneCount: 0,\n    totalInitTime: 0,\n    totalCloneTime: 0,\n    avgInitTime: 0,\n    avgCloneTime: 0,\n  };\n\n  private constructor(config: GoldenCopyCacheConfig = {}) {\n    this.config = {\n      cacheDir: config.cacheDir || join(tmpdir(), \"dr-golden-copy-cache\"),\n      eagerLoad: config.eagerLoad ?? false,\n      warmup: config.warmup ?? false,\n      modelOptions: config.modelOptions || {\n        name: \"Golden Copy Test Model\",\n        version: \"0.1.0\",\n        specVersion: \"0.7.1\",\n        description: \"Shared golden copy for test initialization\",\n        author: \"Test Suite\",\n      },\n    };\n  }\n\n  /**\n   * Get or create the singleton instance\n   *\n   * Thread-safe: If multiple threads/workers call getInstance() concurrently\n   * with different configs, the first one wins. This is acceptable because\n   * getInstance() should be called early in test setup with consistent config.\n   *\n   * @throws Error if config differs from existing instance and GOLDEN_COPY_STRICT is enabled\n   */\n  static getInstance(config?: GoldenCopyCacheConfig): GoldenCopyCacheManager {\n    if (!GoldenCopyCacheManager.instance) {\n      GoldenCopyCacheManager.instance = new GoldenCopyCacheManager(config);\n      GoldenCopyCacheManager.lastConfig = config;\n    } else if (process.env.GOLDEN_COPY_STRICT === \"true\") {\n      // In strict mode, warn if config differs\n      const configStr = JSON.stringify(config || {});\n      const lastConfigStr = JSON.stringify(GoldenCopyCacheManager.lastConfig || {});\n      if (configStr !== lastConfigStr) {\n        console.warn(\n          `[GoldenCopy] WARNING: getInstance() called with different config. ` +\n            `First config wins. Current: ${configStr}, Last: ${lastConfigStr}`\n        );\n      }\n    }\n    return GoldenCopyCacheManager.instance;\n  }\n\n  /**\n   * Reset the singleton instance (useful for testing)\n   */\n  static resetInstance(): void {\n    GoldenCopyCacheManager.instance = null;\n  }\n\n  /**\n   * Initialize the golden copy cache\n   *\n   * Creates or loads a shared golden model that serves as the basis\n   * for all test model clones. This should be called once per test worker.\n   * Subsequent calls are idempotent (no-op if already initialized).\n   *\n   * Thread-safe: Concurrent calls before initialization completes are handled\n   * via initializationPromise lock. Only the first call performs actual work.\n   *\n   * @returns Promise resolving when golden copy is ready\n   */\n  async init(): Promise<void> {\n    // If already initialized, return early (idempotent)\n    if (this.lifecycleState.status === \"initialized\") {\n      if (process.env.DEBUG_GOLDEN_COPY) {\n        console.log(\"[GoldenCopy] Already initialized, skipping init\");\n      }\n      return;\n    }\n\n    // If initialization is in progress, wait for it to complete\n    if (this.lifecycleState.status === \"initializing\") {\n      if (process.env.DEBUG_GOLDEN_COPY) {\n        console.log(\"[GoldenCopy] Initialization in progress, waiting...\");\n      }\n      return this.lifecycleState.promise;\n    }\n\n    // If cleaned up, cannot reinitialize\n    if (this.lifecycleState.status === \"cleaned-up\") {\n      throw new Error(\"Golden copy manager has been cleaned up. Create a new instance.\");\n    }\n\n    // Mark initialization as in progress\n    const initPromise = this.performInitialization();\n    this.lifecycleState = { status: \"initializing\", promise: initPromise };\n\n    try {\n      await initPromise;\n    } catch (error) {\n      // Reset to uninitialized on failure\n      this.lifecycleState = { status: \"uninitialized\" };\n      throw error;\n    }\n  }\n\n  /**\n   * Perform the actual initialization work\n   * @private\n   */\n  private async performInitialization(): Promise<void> {\n    const startTime = Date.now();\n\n    try {\n      // Create cache directory\n      await mkdir(this.config.cacheDir, { recursive: true });\n\n      // Check if golden copy already exists on disk\n      const goldenPath = join(this.config.cacheDir, \"golden-model\");\n      let modelExists = false;\n\n      try {\n        await access(goldenPath);\n        modelExists = true;\n      } catch {\n        // Directory doesn't exist, will create new\n      }\n\n      if (!modelExists) {\n        // Create new golden model\n        const created = await Model.init(\n          goldenPath,\n          {\n            name: this.config.modelOptions.name || \"Golden Copy Test Model\",\n            version: this.config.modelOptions.version || \"0.1.0\",\n            specVersion: this.config.modelOptions.specVersion || \"0.7.1\",\n            description:\n              this.config.modelOptions.description || \"Shared golden copy for test initialization\",\n            author: this.config.modelOptions.author || \"Test Suite\",\n            created: new Date().toISOString(),\n          },\n          { lazyLoad: !this.config.eagerLoad }\n        );\n\n        this.goldenModel = created;\n        this.goldenRootPath = goldenPath;\n\n        // Optional warm-up: populate with sample data\n        if (this.config.warmup) {\n          await this.populateGoldenCopy();\n          await created.save();\n        }\n      } else {\n        // Load existing golden model\n        this.goldenModel = await Model.load(goldenPath, { lazyLoad: !this.config.eagerLoad });\n        this.goldenRootPath = goldenPath;\n      }\n\n      this.stats.initCount++;\n      this.stats.totalInitTime += Date.now() - startTime;\n      this.stats.avgInitTime = this.stats.totalInitTime / this.stats.initCount;\n\n      // Mark as initialized\n      if (this.goldenModel && this.goldenRootPath) {\n        this.lifecycleState = {\n          status: \"initialized\",\n          model: this.goldenModel,\n          rootPath: this.goldenRootPath,\n        };\n      }\n\n      if (process.env.DEBUG_GOLDEN_COPY) {\n        console.log(`[GoldenCopy] Initialized in ${Date.now() - startTime}ms`);\n      }\n    } catch (error) {\n      throw new Error(\n        `Failed to initialize golden copy cache: ${getErrorMessage(error)}`\n      );\n    }\n  }\n\n  /**\n   * Clone the golden model for test use\n   *\n   * Creates an independent copy of the golden model that a test can safely modify\n   * without affecting other tests. The clone is isolated in its own temporary directory.\n   *\n   * Handles filesystem errors:\n   * - EEXIST: Retries with new random suffix (collision handling)\n   * - ENOSPC: Reports disk full error with guidance\n   * - Other: Reports with context\n   *\n   * Differentiates between copy failures and model load failures in error messages.\n   *\n   * @returns Promise resolving to the cloned model with cleanup handler\n   */\n  async clone(): Promise<ClonedModel> {\n    if (!this.goldenModel || !this.goldenRootPath) {\n      throw new Error(\"Golden copy cache not initialized. Call init() first.\");\n    }\n\n    const startTime = Date.now();\n    let clonePath: string | null = null;\n    let copySuccessful = false;\n\n    try {\n      // Generate clone path with retry logic for collisions\n      clonePath = await this.generateClonePath();\n\n      // Create a filesystem copy of the golden model\n      // This is efficient and provides copy-on-write semantics\n      try {\n        await cp(this.goldenRootPath, clonePath, { recursive: true });\n        copySuccessful = true;\n      } catch (copyError) {\n        // Distinguish copy errors\n        if (copyError instanceof Error && (copyError as NodeJS.ErrnoException).code === \"ENOSPC\") {\n          throw new Error(\n            `Disk space exhausted while cloning golden copy. ` +\n              `Ensure at least 100MB free space is available. ` +\n              `Error: ${copyError.message}`\n          );\n        }\n        throw new Error(\n          `Failed to copy golden model to ${clonePath}: ${copyError instanceof Error ? copyError.message : String(copyError)}`\n        );\n      }\n\n      // Load the cloned model\n      let clonedModel: Model;\n      try {\n        clonedModel = await Model.load(clonePath);\n      } catch (loadError) {\n        throw new Error(\n          `Successfully copied golden model to ${clonePath}, but failed to load cloned model. ` +\n            `This suggests corrupted source data. Error: ${loadError instanceof Error ? loadError.message : String(loadError)}`\n        );\n      }\n\n      const cloneTime = Date.now() - startTime;\n      this.stats.cloneCount++;\n      this.stats.totalCloneTime += cloneTime;\n      this.stats.avgCloneTime = this.stats.totalCloneTime / this.stats.cloneCount;\n\n      if (process.env.DEBUG_GOLDEN_COPY) {\n        console.log(`[GoldenCopy] Cloned model in ${cloneTime}ms (clone ${this.stats.cloneCount})`);\n      }\n\n      let cleanupCalled = false;\n\n      return {\n        model: clonedModel,\n        rootPath: clonePath,\n        cleanup: async () => {\n          if (cleanupCalled) {\n            if (process.env.DEBUG_GOLDEN_COPY) {\n              console.log(`[GoldenCopy] Cleanup already called for ${clonePath}`);\n            }\n            return;\n          }\n          cleanupCalled = true;\n\n          try {\n            await rm(clonePath!, { recursive: true, force: true });\n          } catch (e) {\n            // Always log cleanup errors - they can cause disk space issues\n            console.error(\n              `[GoldenCopy] ERROR: Failed to clean up cloned model at ${clonePath}. ` +\n                `This may cause disk space issues. ` +\n                `Error: ${e instanceof Error ? e.message : String(e)}`\n            );\n          }\n        },\n        stats: {\n          cloneTime,\n        },\n      };\n    } catch (error) {\n      // Attempt cleanup only if copy was successful\n      if (copySuccessful && clonePath) {\n        try {\n          await rm(clonePath, { recursive: true, force: true });\n        } catch (cleanupError) {\n          // Log cleanup failures even in error paths\n          console.error(\n            `[GoldenCopy] ERROR: Model load failed AND cleanup failed. ` +\n              `Orphaned directory may exist at ${clonePath}. ` +\n              `Load error: ${getErrorMessage(error)}. ` +\n              `Cleanup error: ${cleanupError instanceof Error ? cleanupError.message : String(cleanupError)}`\n          );\n        }\n      }\n      throw error;\n    }\n  }\n\n  /**\n   * Generate a unique clone path with retry logic for EEXIST collisions\n   * @private\n   */\n  private async generateClonePath(maxRetries: number = 5): Promise<string> {\n    for (let attempt = 0; attempt < maxRetries; attempt++) {\n      const cloneId = `${Date.now()}-${Math.random().toString(36).substring(2, 9)}-attempt${attempt}`;\n      const clonePath = join(tmpdir(), `dr-test-clone-${cloneId}`);\n\n      try {\n        // Check if path already exists\n        await access(clonePath);\n        // Path exists, continue to next attempt\n      } catch {\n        // Path doesn't exist, we can use it\n        return clonePath;\n      }\n    }\n\n    throw new Error(\n      `Failed to generate unique clone path after ${maxRetries} attempts. ` +\n        `Potential issue with concurrent test execution or stale directories.`\n    );\n  }\n\n  /**\n   * Populate the golden copy with standard test data\n   *\n   * This is called during warmup to pre-populate the golden model with\n   * a canonical set of test elements across layers.\n   *\n   * @private\n   */\n  private async populateGoldenCopy(): Promise<void> {\n    if (!this.goldenModel) {\n      throw new Error(\"Golden model not initialized\");\n    }\n\n    const addElement = async (\n      layerName: string,\n      type: string,\n      id: string,\n      name: string,\n      attributes?: Record<string, unknown>\n    ) => {\n      let layer = await this.goldenModel!.getLayer(layerName);\n      if (!layer) {\n        layer = new Layer(layerName);\n        this.goldenModel!.addLayer(layer);\n      }\n\n      const element = new Element({\n        id,\n        type,\n        name,\n        description: `Golden copy element: ${name}`,\n        attributes: attributes || {},\n      });\n\n      layer.addElement(element);\n    };\n\n    // Motivation layer\n    await addElement(\"motivation\", \"goal\", \"motivation.goal.golden-1\", \"Golden Goal 1\");\n    await addElement(\"motivation\", \"goal\", \"motivation.goal.golden-2\", \"Golden Goal 2\");\n    await addElement(\n      \"motivation\",\n      \"requirement\",\n      \"motivation.requirement.golden-1\",\n      \"Golden Requirement 1\"\n    );\n\n    // Business layer\n    await addElement(\"business\", \"process\", \"business.process.golden-1\", \"Golden Process 1\");\n    await addElement(\"business\", \"service\", \"business.service.golden-1\", \"Golden Service 1\");\n\n    // Application layer\n    await addElement(\n      \"application\",\n      \"component\",\n      \"application.component.golden-1\",\n      \"Golden Component 1\"\n    );\n    await addElement(\"application\", \"service\", \"application.service.golden-1\", \"Golden Service 1\");\n\n    // Technology layer\n    await addElement(\n      \"technology\",\n      \"infrastructure\",\n      \"technology.infrastructure.golden-1\",\n      \"Golden Infrastructure 1\"\n    );\n    await addElement(\"technology\", \"platform\", \"technology.platform.golden-1\", \"Golden Platform 1\");\n\n    // API layer\n    await addElement(\"api\", \"endpoint\", \"api.endpoint.golden-1\", \"Golden Endpoint 1\", {\n      method: \"GET\",\n      path: \"/golden/1\",\n    });\n    await addElement(\"api\", \"endpoint\", \"api.endpoint.golden-2\", \"Golden Endpoint 2\", {\n      method: \"POST\",\n      path: \"/golden/2\",\n    });\n\n    // Data Model layer\n    await addElement(\"data-model\", \"entity\", \"data-model.entity.golden-1\", \"Golden Entity 1\");\n    await addElement(\"data-model\", \"entity\", \"data-model.entity.golden-2\", \"Golden Entity 2\");\n  }\n\n  /**\n   * Get statistics about golden copy cache performance\n   */\n  getStats(): GoldenCopyStats {\n    return { ...this.stats };\n  }\n\n  /**\n   * Check if golden copy is initialized\n   */\n  isInitialized(): boolean {\n    return this.goldenModel !== null && this.goldenRootPath !== null;\n  }\n\n  /**\n   * Get the golden model (immutable reference)\n   *\n   * Returns a frozen reference to prevent accidental mutations that could\n   * corrupt the shared golden copy. Direct modifications through the returned\n   * object will fail at runtime.\n   *\n   * @returns Frozen golden model or null if not initialized\n   */\n  getGoldenModel(): Readonly<Model> | null {\n    if (!this.goldenModel) {\n      return null;\n    }\n    // Return frozen reference to prevent mutations\n    return Object.freeze(\n      Object.create(\n        Object.getPrototypeOf(this.goldenModel),\n        Object.getOwnPropertyDescriptors(this.goldenModel)\n      )\n    );\n  }\n\n  /**\n   * Get the cache directory path\n   */\n  getCacheDir(): string {\n    return this.config.cacheDir;\n  }\n\n  /**\n   * Clean up the golden copy cache\n   *\n   * Removes the cached golden model and resets the cache manager.\n   * Should be called at the end of test suite execution.\n   *\n   * Idempotent: Safe to call multiple times without error.\n   */\n  async cleanup(): Promise<void> {\n    // If already cleaned up, this is a no-op\n    if (this.lifecycleState.status === \"cleaned-up\") {\n      if (process.env.DEBUG_GOLDEN_COPY) {\n        console.log(\"[GoldenCopy] Already cleaned up, skipping\");\n      }\n      return;\n    }\n\n    try {\n      if (this.goldenRootPath) {\n        await rm(this.goldenRootPath, { recursive: true, force: true });\n      }\n      this.goldenModel = null;\n      this.goldenRootPath = null;\n      this.lifecycleState = { status: \"cleaned-up\" };\n      GoldenCopyCacheManager.resetInstance();\n\n      if (process.env.DEBUG_GOLDEN_COPY) {\n        console.log(\"[GoldenCopy] Cache cleaned up\");\n        console.log(\"[GoldenCopy] Stats:\", this.stats);\n      }\n    } catch (error) {\n      // Always log cleanup errors\n      console.error(\n        `[GoldenCopy] ERROR: Failed to clean up golden copy cache at ${this.goldenRootPath}. ` +\n          `This may cause disk space issues. ` +\n          `Error: ${getErrorMessage(error)}`\n      );\n    }\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}