@documentation-robotics/cli 0.1.13 → 0.3.0

package/dist/core/farm-sync-state.js

@@ -0,0 +1,167 @@
+import yaml from "yaml";
+import { readFile, writeFile, fileExists } from "../utils/file-io.js";
+class FarmSyncStateNotFoundError extends Error {
+  code = "FARM_SYNC_STATE_NOT_FOUND";
+  filePath;
+  constructor(filePath) {
+    super(`Farm sync state file not found: ${filePath}`), this.name = "FarmSyncStateNotFoundError", this.filePath = filePath;
+  }
+}
+class FarmSyncState {
+  projectName;
+  lastSyncCommit;
+  lastSyncTimestamp;
+  syncHistory;
+  ambiguities;
+  filePath;
+  constructor(data) {
+    this.projectName = data.project_name, this.lastSyncCommit = data.last_sync_commit, this.lastSyncTimestamp = data.last_sync_timestamp, this.syncHistory = data.sync_history || [], this.ambiguities = data.ambiguities?.map((a) => ({
+      filePath: a.file_path,
+      possibleElements: a.possible_elements.map((e) => ({
+        elementId: e.element_id,
+        layer: e.layer,
+        confidence: e.confidence
+      }))
+    })) || [];
+  }
+  /**
+   * Load farm sync state from file
+   * @param filePath - Path to .farm-sync.yaml
+   * @returns FarmSyncState instance
+   */
+  static async load(filePath) {
+    if (!await fileExists(filePath))
+      throw new FarmSyncStateNotFoundError(filePath);
+    const content = await readFile(filePath), rawData = yaml.parse(content);
+    if (!rawData)
+      throw new Error(`Invalid farm sync state: file is empty or contains invalid YAML at ${filePath}`);
+    const data = {
+      project_name: rawData.project_name || rawData.projectName,
+      last_sync_commit: rawData.last_sync_commit || rawData.lastSyncCommit,
+      last_sync_timestamp: rawData.last_sync_timestamp || rawData.lastSyncTimestamp,
+      sync_history: (rawData.sync_history || rawData.syncHistory || []).map((record) => ({
+        timestamp: record.timestamp,
+        commit: record.commit,
+        changeset: record.changeset || record.changesetId,
+        files_changed: record.files_changed || record.filesChanged,
+        elements_affected: record.elements_affected || record.elementsAffected,
+        status: record.status,
+        notes: record.notes
+      })),
+      ambiguities: (rawData.ambiguities || []).map((a) => ({
+        file_path: a.file_path || a.filePath,
+        possible_elements: (a.possible_elements || a.possibleElements || []).map((e) => ({
+          element_id: e.element_id || e.elementId,
+          layer: e.layer,
+          confidence: e.confidence
+        }))
+      }))
+    };
+    if (!data.project_name)
+      throw new Error("Farm sync state must have a 'project_name' field");
+    const state = new FarmSyncState(data);
+    return state.filePath = filePath, state;
+  }
+  /**
+   * Create a new farm sync state
+   * @param projectName - Name of the project
+   * @param options - Optional initial state
+   * @returns FarmSyncState instance
+   */
+  static create(projectName, options = {}) {
+    return new FarmSyncState({
+      project_name: projectName,
+      last_sync_commit: options.lastSyncCommit,
+      last_sync_timestamp: options.lastSyncTimestamp,
+      sync_history: [],
+      ambiguities: []
+    });
+  }
+  /**
+   * Load or create farm sync state
+   * @param filePath - Path to .farm-sync.yaml
+   * @param projectName - Project name (used if creating new)
+   * @returns FarmSyncState instance
+   */
+  static async loadOrCreate(filePath, projectName) {
+    return await fileExists(filePath) ? this.load(filePath) : this.create(projectName);
+  }
+  /**
+   * Save state to file
+   * @param filePath - Path where to save .farm-sync.yaml
+   */
+  async save(filePath) {
+    const targetPath = filePath || this.filePath;
+    if (!targetPath)
+      throw new Error("No file path specified for saving farm sync state");
+    const data = this.toJSON(), yamlContent = yaml.stringify(data, { lineWidth: 0 });
+    await writeFile(targetPath, yamlContent), this.filePath = targetPath;
+  }
+  /**
+   * Record a sync (successful or failed)
+   */
+  recordSync(record) {
+    const status = record.status || "success";
+    (status === "success" || status === "partial") && (this.lastSyncCommit = record.commit, this.lastSyncTimestamp = record.timestamp), this.syncHistory.push({
+      timestamp: record.timestamp,
+      commit: record.commit,
+      status,
+      changeset: record.changeset,
+      files_changed: record.files_changed,
+      elements_affected: record.elements_affected,
+      notes: record.notes
+    }), this.syncHistory.length > 100 && (this.syncHistory = this.syncHistory.slice(-100));
+  }
+  /**
+   * Record ambiguous file-to-element mappings for review
+   */
+  recordAmbiguities(ambiguities) {
+    this.ambiguities = ambiguities;
+  }
+  /**
+   * Clear ambiguities after review
+   */
+  clearAmbiguities() {
+    this.ambiguities = [];
+  }
+  /**
+   * Get the last sync record if any
+   */
+  getLastSync() {
+    return this.syncHistory.length > 0 ? this.syncHistory[this.syncHistory.length - 1] : void 0;
+  }
+  /**
+   * Serialize to JSON representation for saving
+   */
+  toJSON() {
+    return {
+      project_name: this.projectName,
+      last_sync_commit: this.lastSyncCommit,
+      last_sync_timestamp: this.lastSyncTimestamp,
+      sync_history: this.syncHistory.map((record) => ({
+        timestamp: record.timestamp,
+        commit: record.commit,
+        changeset: record.changeset,
+        files_changed: record.files_changed,
+        elements_affected: record.elements_affected,
+        status: record.status,
+        notes: record.notes
+      })),
+      ...this.ambiguities.length > 0 && {
+        ambiguities: this.ambiguities.map((a) => ({
+          file_path: a.filePath,
+          possible_elements: a.possibleElements.map((e) => ({
+            element_id: e.elementId,
+            layer: e.layer,
+            confidence: e.confidence
+          }))
+        }))
+      }
+    };
+  }
+}
+export {
+  FarmSyncState,
+  FarmSyncStateNotFoundError
+};
+//# sourceMappingURL=farm-sync-state.js.map

package/dist/core/farm-sync-state.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/core/farm-sync-state.ts"],
+  "sourcesContent": ["/**\n * Farm Sync State - Manages .farm-sync.yaml per project\n *\n * Tracks sync history, last sync commit, and timestamps for each project.\n */\n\nimport yaml from \"yaml\";\nimport { readFile, writeFile, fileExists } from \"../utils/file-io.js\";\n\n/**\n * Represents a single sync record\n */\nexport interface SyncRecord {\n  timestamp: string; // ISO 8601 timestamp\n  commit: string; // Commit SHA where sync occurred\n  changeset?: string; // ID of generated changeset\n  files_changed?: number; // Number of files that changed\n  elements_affected?: number; // Number of model elements affected\n  status: \"success\" | \"partial\" | \"failed\"; // Status of the sync\n  notes?: string; // Optional notes about the sync\n}\n\n/**\n * Farm sync state for a single project\n */\nexport interface FarmSyncStateData {\n  project_name: string;\n  last_sync_commit?: string; // Last successful sync commit SHA\n  last_sync_timestamp?: string; // ISO 8601 timestamp\n  sync_history: SyncRecord[]; // Complete history of syncs\n  ambiguities?: Array<{\n    file_path: string;\n    possible_elements: Array<{\n      element_id: string;\n      layer: string;\n      confidence: number; // 0-100 confidence score\n    }>;\n  }>; // Ambiguous file-to-element mappings flagged for review\n}\n\n/**\n * Thrown by FarmSyncState.load when the .farm-sync.yaml file does not exist.\n * Callers that treat \"never synced\" differently from other failures check `code`\n * (or `instanceof`) rather than matching the message text.\n */\nexport class FarmSyncStateNotFoundError extends Error {\n  readonly code = \"FARM_SYNC_STATE_NOT_FOUND\";\n  readonly filePath: string;\n\n  constructor(filePath: string) {\n    super(`Farm sync state file not found: ${filePath}`);\n    this.name = \"FarmSyncStateNotFoundError\";\n    this.filePath = filePath;\n  }\n}\n\n/**\n * FarmSyncState class - Load, validate, and save farm sync state per project\n */\nexport class FarmSyncState {\n  projectName: string;\n  lastSyncCommit?: string;\n  lastSyncTimestamp?: string;\n  syncHistory: SyncRecord[];\n  ambiguities: Array<{\n    filePath: string;\n    possibleElements: Array<{\n      elementId: string;\n      layer: string;\n      confidence: number;\n    }>;\n  }>;\n  filePath?: string;\n\n  constructor(data: FarmSyncStateData) {\n    this.projectName = data.project_name;\n    this.lastSyncCommit = data.last_sync_commit;\n    this.lastSyncTimestamp = data.last_sync_timestamp;\n    this.syncHistory = data.sync_history || [];\n    this.ambiguities = data.ambiguities?.map(a => ({\n      filePath: a.file_path,\n      possibleElements: a.possible_elements.map(e => ({\n        elementId: e.element_id,\n        layer: e.layer,\n        confidence: e.confidence,\n      })),\n    })) || [];\n  }\n\n  /**\n   * Load farm sync state from file\n   * @param filePath - Path to .farm-sync.yaml\n   * @returns FarmSyncState instance\n   */\n  static async load(filePath: string): Promise<FarmSyncState> {\n    if (!(await fileExists(filePath))) {\n      throw new FarmSyncStateNotFoundError(filePath);\n    }\n\n    const content = await readFile(filePath);\n    const rawData = yaml.parse(content) as any;\n\n    if (!rawData) {\n      throw new Error(\n        `Invalid farm sync state: file is empty or contains invalid YAML at ${filePath}`\n      );\n    }\n\n    // Handle both old (camelCase) and new (snake_case) formats for backward compatibility\n    const data: FarmSyncStateData = {\n      project_name: rawData.project_name || rawData.projectName,\n      last_sync_commit: rawData.last_sync_commit || rawData.lastSyncCommit,\n      last_sync_timestamp: rawData.last_sync_timestamp || rawData.lastSyncTimestamp,\n      sync_history: (rawData.sync_history || rawData.syncHistory || []).map((record: any) => ({\n        timestamp: record.timestamp,\n        commit: record.commit,\n        changeset: record.changeset || record.changesetId,\n        files_changed: record.files_changed || record.filesChanged,\n        elements_affected: record.elements_affected || record.elementsAffected,\n        status: record.status,\n        notes: record.notes,\n      })),\n      ambiguities: (rawData.ambiguities || []).map((a: any) => ({\n        file_path: a.file_path || a.filePath,\n        possible_elements: (a.possible_elements || a.possibleElements || []).map((e: any) => ({\n          element_id: e.element_id || e.elementId,\n          layer: e.layer,\n          confidence: e.confidence,\n        })),\n      })),\n    };\n\n    if (!data.project_name) {\n      throw new Error(\"Farm sync state must have a 'project_name' field\");\n    }\n\n    const state = new FarmSyncState(data);\n    state.filePath = filePath;\n    return state;\n  }\n\n  /**\n   * Create a new farm sync state\n   * @param projectName - Name of the project\n   * @param options - Optional initial state\n   * @returns FarmSyncState instance\n   */\n  static create(\n    projectName: string,\n    options: {\n      lastSyncCommit?: string;\n      lastSyncTimestamp?: string;\n    } = {}\n  ): FarmSyncState {\n    return new FarmSyncState({\n      project_name: projectName,\n      last_sync_commit: options.lastSyncCommit,\n      last_sync_timestamp: options.lastSyncTimestamp,\n      sync_history: [],\n      ambiguities: [],\n    });\n  }\n\n  /**\n   * Load or create farm sync state\n   * @param filePath - Path to .farm-sync.yaml\n   * @param projectName - Project name (used if creating new)\n   * @returns FarmSyncState instance\n   */\n  static async loadOrCreate(filePath: string, projectName: string): Promise<FarmSyncState> {\n    if (await fileExists(filePath)) {\n      return this.load(filePath);\n    }\n    return this.create(projectName);\n  }\n\n  /**\n   * Save state to file\n   * @param filePath - Path where to save .farm-sync.yaml\n   */\n  async save(filePath?: string): Promise<void> {\n    const targetPath = filePath || this.filePath;\n    if (!targetPath) {\n      throw new Error(\"No file path specified for saving farm sync state\");\n    }\n\n    const data = this.toJSON();\n    const yamlContent = yaml.stringify(data, { lineWidth: 0 });\n\n    await writeFile(targetPath, yamlContent);\n    this.filePath = targetPath;\n  }\n\n  /**\n   * Record a sync (successful or failed)\n   */\n  recordSync(record: Omit<SyncRecord, \"status\"> & { status?: \"success\" | \"partial\" | \"failed\" }): void {\n    const status = record.status || \"success\";\n\n    // Update lastSyncCommit on successful and partial syncs to avoid reprocessing confident files.\n    // Failed syncs do not advance the pointer (will retry from same point).\n    // Partial syncs advance because confident files have been processed and staged;\n    // ambiguous files are tracked separately for manual review.\n    if (status === \"success\" || status === \"partial\") {\n      this.lastSyncCommit = record.commit;\n      this.lastSyncTimestamp = record.timestamp;\n    }\n\n    this.syncHistory.push({\n      timestamp: record.timestamp,\n      commit: record.commit,\n      status,\n      changeset: record.changeset,\n      files_changed: record.files_changed,\n      elements_affected: record.elements_affected,\n      notes: record.notes,\n    });\n\n    // Keep history trimmed to last 100 syncs\n    if (this.syncHistory.length > 100) {\n      this.syncHistory = this.syncHistory.slice(-100);\n    }\n  }\n\n  /**\n   * Record ambiguous file-to-element mappings for review\n   */\n  recordAmbiguities(\n    ambiguities: Array<{\n      filePath: string;\n      possibleElements: Array<{\n        elementId: string;\n        layer: string;\n        confidence: number;\n      }>;\n    }>\n  ): void {\n    this.ambiguities = ambiguities;\n  }\n\n  /**\n   * Clear ambiguities after review\n   */\n  clearAmbiguities(): void {\n    this.ambiguities = [];\n  }\n\n  /**\n   * Get the last sync record if any\n   */\n  getLastSync(): SyncRecord | undefined {\n    return this.syncHistory.length > 0 ? this.syncHistory[this.syncHistory.length - 1] : undefined;\n  }\n\n  /**\n   * Serialize to JSON representation for saving\n   */\n  toJSON(): FarmSyncStateData {\n    return {\n      project_name: this.projectName,\n      last_sync_commit: this.lastSyncCommit,\n      last_sync_timestamp: this.lastSyncTimestamp,\n      sync_history: this.syncHistory.map(record => ({\n        timestamp: record.timestamp,\n        commit: record.commit,\n        changeset: record.changeset,\n        files_changed: record.files_changed,\n        elements_affected: record.elements_affected,\n        status: record.status,\n        notes: record.notes,\n      })),\n      ...(this.ambiguities.length > 0 && {\n        ambiguities: this.ambiguities.map(a => ({\n          file_path: a.filePath,\n          possible_elements: a.possibleElements.map(e => ({\n            element_id: e.elementId,\n            layer: e.layer,\n            confidence: e.confidence,\n          })),\n        }))\n      }),\n    };\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/core/manifest.js

@@ -5,10 +5,13 @@ class Manifest {
   author;
   created;
   modified;
+  cliVersion;
   specVersion;
   changeset_history;
+  models;
+  codebase_path;
   constructor(data) {
-    this.name = data.name, this.version = data.version, this.description = data.description, this.author = data.author, this.created = data.created ?? (/* @__PURE__ */ new Date()).toISOString(), this.modified = data.modified ?? (/* @__PURE__ */ new Date()).toISOString(), this.specVersion = data.specVersion, this.changeset_history = this.migrateChangesetHistory(data.changeset_history);
+    this.name = data.name, this.version = data.version, this.description = data.description, this.author = data.author, this.created = data.created ?? (/* @__PURE__ */ new Date()).toISOString(), this.modified = data.modified ?? (/* @__PURE__ */ new Date()).toISOString(), this.cliVersion = data.cliVersion, this.specVersion = data.specVersion, this.models = data.models, this.codebase_path = data.codebase_path, this.changeset_history = this.migrateChangesetHistory(data.changeset_history);
   }
   /**
    * Migrate changeset history from legacy field names to new format
@@ -45,7 +48,7 @@ class Manifest {
    * Serialize to JSON representation
    *
    * Converts the Manifest to a JSON-serializable object that includes project
-   * metadata and changeset history.
+   * metadata, changeset history, and external model declarations.
    *
    * @returns ManifestData object suitable for JSON serialization
    */
@@ -56,7 +59,7 @@ class Manifest {
       created: this.created,
       modified: this.modified
     };
-    return this.description && (result.description = this.description), this.author && (result.author = this.author), this.specVersion && (result.specVersion = this.specVersion), this.changeset_history && this.changeset_history.length > 0 && (result.changeset_history = this.changeset_history), result;
+    return this.description && (result.description = this.description), this.author && (result.author = this.author), this.cliVersion && (result.cliVersion = this.cliVersion), this.specVersion && (result.specVersion = this.specVersion), this.codebase_path && (result.codebase_path = this.codebase_path), this.changeset_history && this.changeset_history.length > 0 && (result.changeset_history = this.changeset_history), this.models && Object.keys(this.models).length > 0 && (result.models = this.models), result;
   }
   /**
    * Create Manifest from JSON string

package/dist/core/manifest.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/core/manifest.ts"],
-  "sourcesContent": ["import type {\n  ManifestData,\n  ChangesetHistoryEntry,\n} from \"../types/index.js\";\n\n/**\n * Manifest representing model metadata and configuration\n *\n * The Manifest class manages all metadata about a Documentation Robotics model,\n * including project information, changeset history, and layer configuration.\n *\n * This class handles:\n * - Project metadata (name, version, description, author)\n * - Changeset application history\n */\nexport class Manifest {\n  name: string;\n  version: string;\n  description?: string;\n  author?: string;\n  created: string;\n  modified: string;\n  specVersion?: string;\n  changeset_history?: ChangesetHistoryEntry[];\n\n  constructor(data: ManifestData) {\n    this.name = data.name;\n    this.version = data.version;\n    this.description = data.description;\n    this.author = data.author;\n    this.created = data.created ?? new Date().toISOString();\n    this.modified = data.modified ?? new Date().toISOString();\n    this.specVersion = data.specVersion;\n\n    // Migrate changeset history from legacy format (if present)\n    this.changeset_history = this.migrateChangesetHistory(data.changeset_history);\n  }\n\n  /**\n   * Migrate changeset history from legacy field names to new format\n   * Legacy format: applied_at \u2192 committed_at, action: \"applied\" \u2192 action: \"committed\"\n   *\n   * @param history - Changeset history from manifest (may use legacy field names)\n   * @returns Migrated changeset history using new field names\n   * @throws Error if action value is unrecognized (not \"committed\", \"discarded\", \"applied\", or \"reverted\")\n   */\n  private migrateChangesetHistory(\n    history: ChangesetHistoryEntry[] | undefined\n  ): ChangesetHistoryEntry[] {\n    if (!history || history.length === 0) {\n      return [];\n    }\n\n    return history.map((entry: any) => {\n      // Validate action value to prevent silent data corruption\n      let action: \"committed\" | \"discarded\";\n      if (entry.action === \"applied\" || entry.action === \"committed\") {\n        action = \"committed\";\n      } else if (entry.action === \"reverted\" || entry.action === \"discarded\") {\n        action = \"discarded\";\n      } else {\n        throw new Error(\n          `Invalid changeset history action '${entry.action}' for changeset '${entry.name}'. ` +\n          `Expected: committed, discarded, applied (legacy), or reverted (legacy).`\n        );\n      }\n\n      return {\n        name: entry.name,\n        // Handle legacy field name: applied_at \u2192 committed_at\n        committed_at: entry.committed_at || entry.applied_at || new Date().toISOString(),\n        action,\n      };\n    });\n  }\n\n  /**\n   * Update the modified timestamp to current time\n   */\n  updateModified(): void {\n    this.modified = new Date().toISOString();\n  }\n\n  /**\n   * Serialize to JSON representation\n   *\n   * Converts the Manifest to a JSON-serializable object that includes project\n   * metadata and changeset history.\n   *\n   * @returns ManifestData object suitable for JSON serialization\n   */\n  toJSON(): Record<string, unknown> {\n    const result: Record<string, unknown> = {\n      name: this.name,\n      version: this.version,\n      created: this.created,\n      modified: this.modified,\n    };\n\n    if (this.description) {\n      result.description = this.description;\n    }\n\n    if (this.author) {\n      result.author = this.author;\n    }\n\n    if (this.specVersion) {\n      result.specVersion = this.specVersion;\n    }\n\n    if (this.changeset_history && this.changeset_history.length > 0) {\n      result.changeset_history = this.changeset_history;\n    }\n\n    return result;\n  }\n\n  /**\n   * Create Manifest from JSON string\n   */\n  static fromJSON(json: string): Manifest {\n    const data = JSON.parse(json) as ManifestData;\n    return new Manifest(data);\n  }\n\n  /**\n   * String representation\n   */\n  toString(): string {\n    return `Manifest(${this.name} v${this.version})`;\n  }\n}\n"],
-  "mappings": "AAeM,MAAO,SAAQ;EACnB;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EAEA,YAAY,MAAkB;AAC5B,SAAK,OAAO,KAAK,MACjB,KAAK,UAAU,KAAK,SACpB,KAAK,cAAc,KAAK,aACxB,KAAK,SAAS,KAAK,QACnB,KAAK,UAAU,KAAK,YAAW,oBAAI,KAAI,GAAG,YAAW,GACrD,KAAK,WAAW,KAAK,aAAY,oBAAI,KAAI,GAAG,YAAW,GACvD,KAAK,cAAc,KAAK,aAGxB,KAAK,oBAAoB,KAAK,wBAAwB,KAAK,iBAAiB;EAC9E;;;;;;;;;EAUQ,wBACN,SAA4C;AAE5C,WAAI,CAAC,WAAW,QAAQ,WAAW,IAC1B,CAAA,IAGF,QAAQ,IAAI,CAAC,UAAc;AAEhC,UAAI;AACJ,UAAI,MAAM,WAAW,aAAa,MAAM,WAAW;AACjD,iBAAS;eACA,MAAM,WAAW,cAAc,MAAM,WAAW;AACzD,iBAAS;;AAET,cAAM,IAAI,MACR,qCAAqC,MAAM,MAAM,oBAAoB,MAAM,IAAI,4EACN;AAI7E,aAAO;QACL,MAAM,MAAM;;QAEZ,cAAc,MAAM,gBAAgB,MAAM,eAAc,oBAAI,KAAI,GAAG,YAAW;QAC9E;;IAEJ,CAAC;EACH;;;;EAKA,iBAAc;AACZ,SAAK,YAAW,oBAAI,KAAI,GAAG,YAAW;EACxC;;;;;;;;;EAUA,SAAM;AACJ,UAAM,SAAkC;MACtC,MAAM,KAAK;MACX,SAAS,KAAK;MACd,SAAS,KAAK;MACd,UAAU,KAAK;;AAGjB,WAAI,KAAK,gBACP,OAAO,cAAc,KAAK,cAGxB,KAAK,WACP,OAAO,SAAS,KAAK,SAGnB,KAAK,gBACP,OAAO,cAAc,KAAK,cAGxB,KAAK,qBAAqB,KAAK,kBAAkB,SAAS,MAC5D,OAAO,oBAAoB,KAAK,oBAG3B;EACT;;;;EAKA,OAAO,SAAS,MAAY;AAC1B,UAAM,OAAO,KAAK,MAAM,IAAI;AAC5B,WAAO,IAAI,SAAS,IAAI;EAC1B;;;;EAKA,WAAQ;AACN,WAAO,YAAY,KAAK,IAAI,KAAK,KAAK,OAAO;EAC/C;;",
+  "sourcesContent": ["import type {\n  ManifestData,\n  ChangesetHistoryEntry,\n  ExternalModelDeclaration,\n} from \"../types/index.js\";\n\n/**\n * Manifest representing model metadata and configuration\n *\n * The Manifest class manages all metadata about a Documentation Robotics model,\n * including project information, changeset history, layer configuration, and\n * external model declarations.\n *\n * This class handles:\n * - Project metadata (name, version, description, author)\n * - Changeset application history\n * - External model declarations for cross-model references\n */\nexport class Manifest {\n  name: string;\n  version: string;\n  description?: string;\n  author?: string;\n  created: string;\n  modified: string;\n  cliVersion?: string;\n  specVersion?: string;\n  changeset_history?: ChangesetHistoryEntry[];\n  models?: Record<string, ExternalModelDeclaration>;\n  codebase_path?: string;\n\n  constructor(data: ManifestData) {\n    this.name = data.name;\n    this.version = data.version;\n    this.description = data.description;\n    this.author = data.author;\n    this.created = data.created ?? new Date().toISOString();\n    this.modified = data.modified ?? new Date().toISOString();\n    this.cliVersion = data.cliVersion;\n    this.specVersion = data.specVersion;\n    this.models = data.models;\n    this.codebase_path = data.codebase_path;\n\n    // Migrate changeset history from legacy format (if present)\n    this.changeset_history = this.migrateChangesetHistory(data.changeset_history);\n  }\n\n  /**\n   * Migrate changeset history from legacy field names to new format\n   * Legacy format: applied_at \u2192 committed_at, action: \"applied\" \u2192 action: \"committed\"\n   *\n   * @param history - Changeset history from manifest (may use legacy field names)\n   * @returns Migrated changeset history using new field names\n   * @throws Error if action value is unrecognized (not \"committed\", \"discarded\", \"applied\", or \"reverted\")\n   */\n  private migrateChangesetHistory(\n    history: ChangesetHistoryEntry[] | undefined\n  ): ChangesetHistoryEntry[] {\n    if (!history || history.length === 0) {\n      return [];\n    }\n\n    return history.map((entry: any) => {\n      // Validate action value to prevent silent data corruption\n      let action: \"committed\" | \"discarded\";\n      if (entry.action === \"applied\" || entry.action === \"committed\") {\n        action = \"committed\";\n      } else if (entry.action === \"reverted\" || entry.action === \"discarded\") {\n        action = \"discarded\";\n      } else {\n        throw new Error(\n          `Invalid changeset history action '${entry.action}' for changeset '${entry.name}'. ` +\n          `Expected: committed, discarded, applied (legacy), or reverted (legacy).`\n        );\n      }\n\n      return {\n        name: entry.name,\n        // Handle legacy field name: applied_at \u2192 committed_at\n        committed_at: entry.committed_at || entry.applied_at || new Date().toISOString(),\n        action,\n      };\n    });\n  }\n\n  /**\n   * Update the modified timestamp to current time\n   */\n  updateModified(): void {\n    this.modified = new Date().toISOString();\n  }\n\n  /**\n   * Serialize to JSON representation\n   *\n   * Converts the Manifest to a JSON-serializable object that includes project\n   * metadata, changeset history, and external model declarations.\n   *\n   * @returns ManifestData object suitable for JSON serialization\n   */\n  toJSON(): Record<string, unknown> {\n    const result: Record<string, unknown> = {\n      name: this.name,\n      version: this.version,\n      created: this.created,\n      modified: this.modified,\n    };\n\n    if (this.description) {\n      result.description = this.description;\n    }\n\n    if (this.author) {\n      result.author = this.author;\n    }\n\n    if (this.cliVersion) {\n      result.cliVersion = this.cliVersion;\n    }\n\n    if (this.specVersion) {\n      result.specVersion = this.specVersion;\n    }\n\n    if (this.codebase_path) {\n      result.codebase_path = this.codebase_path;\n    }\n\n    if (this.changeset_history && this.changeset_history.length > 0) {\n      result.changeset_history = this.changeset_history;\n    }\n\n    if (this.models && Object.keys(this.models).length > 0) {\n      result.models = this.models;\n    }\n\n    return result;\n  }\n\n  /**\n   * Create Manifest from JSON string\n   */\n  static fromJSON(json: string): Manifest {\n    const data = JSON.parse(json) as ManifestData;\n    return new Manifest(data);\n  }\n\n  /**\n   * String representation\n   */\n  toString(): string {\n    return `Manifest(${this.name} v${this.version})`;\n  }\n}\n"],
+  "mappings": "AAkBM,MAAO,SAAQ;EACnB;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EAEA,YAAY,MAAkB;AAC5B,SAAK,OAAO,KAAK,MACjB,KAAK,UAAU,KAAK,SACpB,KAAK,cAAc,KAAK,aACxB,KAAK,SAAS,KAAK,QACnB,KAAK,UAAU,KAAK,YAAW,oBAAI,KAAI,GAAG,YAAW,GACrD,KAAK,WAAW,KAAK,aAAY,oBAAI,KAAI,GAAG,YAAW,GACvD,KAAK,aAAa,KAAK,YACvB,KAAK,cAAc,KAAK,aACxB,KAAK,SAAS,KAAK,QACnB,KAAK,gBAAgB,KAAK,eAG1B,KAAK,oBAAoB,KAAK,wBAAwB,KAAK,iBAAiB;EAC9E;;;;;;;;;EAUQ,wBACN,SAA4C;AAE5C,WAAI,CAAC,WAAW,QAAQ,WAAW,IAC1B,CAAA,IAGF,QAAQ,IAAI,CAAC,UAAc;AAEhC,UAAI;AACJ,UAAI,MAAM,WAAW,aAAa,MAAM,WAAW;AACjD,iBAAS;eACA,MAAM,WAAW,cAAc,MAAM,WAAW;AACzD,iBAAS;;AAET,cAAM,IAAI,MACR,qCAAqC,MAAM,MAAM,oBAAoB,MAAM,IAAI,4EACN;AAI7E,aAAO;QACL,MAAM,MAAM;;QAEZ,cAAc,MAAM,gBAAgB,MAAM,eAAc,oBAAI,KAAI,GAAG,YAAW;QAC9E;;IAEJ,CAAC;EACH;;;;EAKA,iBAAc;AACZ,SAAK,YAAW,oBAAI,KAAI,GAAG,YAAW;EACxC;;;;;;;;;EAUA,SAAM;AACJ,UAAM,SAAkC;MACtC,MAAM,KAAK;MACX,SAAS,KAAK;MACd,SAAS,KAAK;MACd,UAAU,KAAK;;AAGjB,WAAI,KAAK,gBACP,OAAO,cAAc,KAAK,cAGxB,KAAK,WACP,OAAO,SAAS,KAAK,SAGnB,KAAK,eACP,OAAO,aAAa,KAAK,aAGvB,KAAK,gBACP,OAAO,cAAc,KAAK,cAGxB,KAAK,kBACP,OAAO,gBAAgB,KAAK,gBAG1B,KAAK,qBAAqB,KAAK,kBAAkB,SAAS,MAC5D,OAAO,oBAAoB,KAAK,oBAG9B,KAAK,UAAU,OAAO,KAAK,KAAK,MAAM,EAAE,SAAS,MACnD,OAAO,SAAS,KAAK,SAGhB;EACT;;;;EAKA,OAAO,SAAS,MAAY;AAC1B,UAAM,OAAO,KAAK,MAAM,IAAI;AAC5B,WAAO,IAAI,SAAS,IAAI;EAC1B;;;;EAKA,WAAQ;AACN,WAAO,YAAY,KAAK,IAAI,KAAK,KAAK,OAAO;EAC/C;;",
   "names": []
 }

package/dist/core/migration-registry.js

@@ -1,4 +1,5 @@
 import { getErrorMessage } from "../utils/errors.js";
+import { applyCatalogMigrations } from "./catalog-migration.js";
 class MigrationRegistry {
   migrations = [];
   constructor() {
@@ -134,13 +135,41 @@ class MigrationRegistry {
           description: "Spec version updated to 0.9.0 (Product layer introduced at layer 3; Security through Testing shifted from layers 3\u201312 to 4\u201313)"
         };
       }
+    }), this.migrations.push({
+      fromVersion: "0.9.0",
+      toVersion: "0.10.0",
+      description: "Data Model objectschema.required type change, element type renames and relationship catalog rewrites (Spec v0.10.0)",
+      apply: async (model) => {
+        const required = await migrateObjectSchemaRequired(model), catalog = await applyCatalogMigrations(model), errors = [...required.errors, ...catalog.errors];
+        return {
+          migrationsApplied: 1,
+          filesModified: required.filesModified + catalog.filesModified,
+          description: `Spec version updated to 0.10.0 (objectschema.required converted from string to array; ${catalog.summaries.join("; ")})`,
+          ...errors.length > 0 && { error: errors.join("; ") },
+          details: catalog.details
+        };
+      }
+    }), this.migrations.push({
+      fromVersion: "0.10.0",
+      toVersion: "0.11.0",
+      description: "Relationship catalog rewrites from the layer rules pass (Spec v0.11.0)",
+      apply: async (model) => {
+        const catalog = await applyCatalogMigrations(model);
+        return {
+          migrationsApplied: 1,
+          filesModified: catalog.filesModified,
+          description: `Spec version updated to 0.11.0 (${catalog.summaries.join("; ")})`,
+          ...catalog.errors.length > 0 && { error: catalog.errors.join("; ") },
+          details: catalog.details
+        };
+      }
     });
   }
   /**
    * Get the latest available specification version
    */
   getLatestVersion() {
-    return this.migrations.length === 0 ? "0.7.0" : this.migrations.map((m) => m.toVersion).sort().reverse()[0];
+    return this.migrations.length === 0 ? "0.7.0" : this.migrations.map((m) => m.toVersion).reduce((max, current) => this.compareVersions(current, max) > 0 ? current : max);
   }
   /**
    * Get the sequence of migrations needed from one version to another
@@ -237,6 +266,60 @@ class MigrationRegistry {
     return 0;
   }
 }
+async function migrateObjectSchemaRequired(model) {
+  const result = await migrateObjectSchemaRequiredFiles(model);
+  return migrateLoadedObjectSchemaRequired(model), result;
+}
+function requiredAsArray(required) {
+  return !required || typeof required != "string" ? null : required.split(",").map((item) => item.trim()).filter((item) => item.length > 0);
+}
+function migrateLoadedObjectSchemaRequired(model) {
+  const layer = model.layers.get("data-model");
+  if (layer)
+    for (const element of layer.listElements()) {
+      if (element.spec_node_id !== "data-model.objectschema")
+        continue;
+      const required = requiredAsArray(element.attributes.required);
+      required && (element.attributes = { ...element.attributes, required }, layer.updateElement(element));
+    }
+}
+async function migrateObjectSchemaRequiredFiles(model) {
+  const fs = await import("fs/promises"), pathModule = await import("path"), YAML = await import("yaml"), dataModelDir = pathModule.join(model.rootPath, "documentation-robotics/model/08_data-model");
+  let filesModified = 0;
+  try {
+    await fs.access(dataModelDir);
+  } catch (error) {
+    if (error.code === "ENOENT")
+      return { filesModified: 0, errors: [] };
+    throw error;
+  }
+  const files = await fs.readdir(dataModelDir), errors = [];
+  for (const file of files) {
+    if (!file.endsWith(".yaml") && !file.endsWith(".yml"))
+      continue;
+    const filePath = pathModule.join(dataModelDir, file);
+    try {
+      const content = await fs.readFile(filePath, "utf-8");
+      let modified = !1;
+      const doc = YAML.parse(content);
+      if (!doc || typeof doc != "object")
+        continue;
+      for (const [, element] of Object.entries(doc)) {
+        if (!element || typeof element != "object" || element.spec_node_id !== "data-model.objectschema")
+          continue;
+        const attributes = element.attributes;
+        if (attributes && typeof attributes == "object") {
+          const required = requiredAsArray(attributes.required);
+          required && (attributes.required = required, modified = !0);
+        }
+      }
+      modified && (await fs.writeFile(filePath, YAML.stringify(doc), "utf-8"), filesModified++);
+    } catch (error) {
+      errors.push(`Failed to migrate ${file}: ${getErrorMessage(error)}`);
+    }
+  }
+  return { filesModified, errors };
+}
 export {
   MigrationRegistry
 };

package/dist/core/migration-registry.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/core/migration-registry.ts"],
-  "sourcesContent": ["/**\n * Migration Registry - Manages version-based model migrations\n *\n * Handles sequential migrations from one spec version to another,\n * supporting the evolution of the architecture model specification.\n */\n\nimport type { Model } from \"./model.js\";\nimport { getErrorMessage } from \"../utils/errors.js\";\n\n/**\n * Represents a single version migration\n */\nexport interface Migration {\n  fromVersion: string;\n  toVersion: string;\n  description: string;\n  apply: (model: Model) => Promise<MigrationResult>;\n}\n\n/**\n * Result of applying a migration\n */\nexport interface MigrationResult {\n  migrationsApplied: number;\n  filesModified: number;\n  description: string;\n  error?: string;\n  details?: Record<string, unknown>;\n}\n\n/**\n * Migration Registry managing all available migrations\n */\nexport class MigrationRegistry {\n  private migrations: Migration[] = [];\n\n  constructor() {\n    this.registerMigrations();\n  }\n\n  /**\n   * Register all available migrations\n   */\n  private registerMigrations(): void {\n    // Migration from v0.5.0 to v0.6.0: Relationship Taxonomy\n    this.migrations.push({\n      fromVersion: \"0.5.0\",\n      toVersion: \"0.6.0\",\n      description: \"Relationship Taxonomy (Spec v0.6.0)\",\n      apply: async () => {\n        // This migration is opt-in - the new relationship taxonomy\n        // is fully backward compatible with existing models\n        return {\n          migrationsApplied: 1,\n          filesModified: 0,\n          description: \"Spec version updated to 0.6.0 (Relationship Taxonomy now available)\",\n        };\n      },\n    });\n\n    // Migration from v0.6.0 to v0.7.0: Layer Schema Relationship Metadata\n    this.migrations.push({\n      fromVersion: \"0.6.0\",\n      toVersion: \"0.7.0\",\n      description: \"Layer Schema Relationship Metadata (Spec v0.7.0)\",\n      apply: async () => {\n        // This migration updates layer schemas with relationship metadata sections\n        // - All 12 layer schemas now include layerMetadata, intraLayerRelationships, crossLayerRelationships\n        // - Deprecated link-registry.json (removed in v0.8.0)\n        // - Terminology change: \"cross-layer links\" \u2192 \"cross-layer relationships\"\n        // Fully backward compatible - existing models continue to work\n        return {\n          migrationsApplied: 1,\n          filesModified: 0,\n          description:\n            \"Spec version updated to 0.7.0 (Layer schemas now include relationship metadata sections)\",\n        };\n      },\n    });\n\n    // Migration from v0.7.0 to v0.7.1: Source Code Reference Infrastructure\n    this.migrations.push({\n      fromVersion: \"0.7.0\",\n      toVersion: \"0.7.1\",\n      description: \"Source Code Reference Infrastructure (Spec v0.7.1)\",\n      apply: async () => {\n        // This migration adds source code reference infrastructure\n        // - Common schema definitions in spec/schemas/common/\n        // - Source references integrated across 10 layers\n        // - Backward compatible - existing models continue to work\n        return {\n          migrationsApplied: 1,\n          filesModified: 0,\n          description: \"Spec version updated to 0.7.1 (Source Code Reference Infrastructure)\",\n        };\n      },\n    });\n\n    // Migration from v0.7.1 to v0.8.0: JSON Schema-Only Spec Architecture\n    this.migrations.push({\n      fromVersion: \"0.7.1\",\n      toVersion: \"0.8.0\",\n      description: \"JSON Schema-Only Spec Architecture (Spec v0.8.0)\",\n      apply: async () => {\n        // Spec architecture refactored to JSON Schema-only model:\n        // - Node type definitions moved to spec/schemas/nodes/{layer}/*.node.schema.json\n        // - Relationship definitions moved to spec/schemas/relationships/{layer}/*.relationship.schema.json\n        // - Predicates relocated to spec/schemas/base/predicates.json\n        // This is a spec architecture change only - model data files are fully backward compatible\n        return {\n          migrationsApplied: 1,\n          filesModified: 0,\n          description: \"Spec version updated to 0.8.0 (JSON Schema-Only Spec Architecture)\",\n        };\n      },\n    });\n\n    // Migration from v0.8.0 to v0.8.1: Expanded Relationship Coverage and Node Improvements\n    this.migrations.push({\n      fromVersion: \"0.8.0\",\n      toVersion: \"0.8.1\",\n      description: \"Expanded Relationship Coverage and Node Improvements (Spec v0.8.1)\",\n      apply: async () => {\n        // Spec enhancements only - no model data format changes:\n        // - 733 new relationship schemas added across all 12 layers\n        // - Node type descriptions improved for all 12 layers\n        // - Enum-masquerader node types consolidated into parent attributes\n        // - Existing models continue to work without modification\n        return {\n          migrationsApplied: 1,\n          filesModified: 0,\n          description: \"Spec version updated to 0.8.1 (Expanded Relationship Coverage and Node Improvements)\",\n        };\n      },\n    });\n\n    // Migration from v0.8.1 to v0.8.2: UUID/Path identifier separation\n    this.migrations.push({\n      fromVersion: \"0.8.1\",\n      toVersion: \"0.8.2\",\n      description: \"UUID/Path identifier separation (Spec v0.8.2)\",\n      apply: async () => {\n        // The path field is now required on all spec nodes (spec-node.schema.json).\n        // Existing elements are migrated automatically on load in model.ts (loadLayer):\n        // - Elements with slug-format id: slug moved to path, deterministic UUID assigned to id\n        // - Elements with UUID id but no path: path derived from layer_id.type.kebab(name)\n        // No manual data file changes needed; migration runs transparently on next load/save.\n        return {\n          migrationsApplied: 1,\n          filesModified: 0,\n          description: \"Spec version updated to 0.8.2 (UUID/Path identifier separation)\",\n        };\n      },\n    });\n\n    // Migration from v0.8.2 to v0.8.3: Inter-layer Relationship Schemas and APM Node Types\n    this.migrations.push({\n      fromVersion: \"0.8.2\",\n      toVersion: \"0.8.3\",\n      description: \"Inter-layer Relationship Schemas and APM Node Types (Spec v0.8.3)\",\n      apply: async () => {\n        // Major expansion of inter-layer relationship coverage and APM layer:\n        // - 495 new inter-layer relationship schemas across all 12 layers\n        // - Total relationship count increased from 969 to 1,447\n        // - 2 new APM node types: apm.alert and apm.dashboard\n        // - Backward compatible - existing models continue to work without modification\n        return {\n          migrationsApplied: 1,\n          filesModified: 0,\n          description: \"Spec version updated to 0.8.3 (Inter-layer Relationship Schemas and APM Node Types)\",\n        };\n      },\n    });\n\n    // Migration from v0.8.3 to v0.8.4: Analyzer Infrastructure (CBM Mapping)\n    this.migrations.push({\n      fromVersion: \"0.8.3\",\n      toVersion: \"0.8.4\",\n      description: \"Analyzer Infrastructure (Spec v0.8.4)\",\n      apply: async () => {\n        // Introduces spec/analyzers/ with codebase-memory (CBM) mapping:\n        // - New analyzer adapter foundation and full analyzer subcommands\n        // - dr analyzer verify with changeset awareness\n        // - Claude Code integration commands (/dr-verify, /dr-map, dr-extractor)\n        // - No model data format changes; existing models are fully compatible\n        return {\n          migrationsApplied: 1,\n          filesModified: 0,\n          description: \"Spec version updated to 0.8.4 (Analyzer Infrastructure)\",\n        };\n      },\n    });\n\n    // Migration from v0.8.4 to v0.9.0: Product Layer Introduction\n    this.migrations.push({\n      fromVersion: \"0.8.4\",\n      toVersion: \"0.9.0\",\n      description: \"Product Layer Introduction (Spec v0.9.0)\",\n      apply: async (model: Model) => {\n        const fs = await import(\"fs/promises\");\n        const pathModule = await import(\"path\");\n\n        const modelDir = `${model.rootPath}/documentation-robotics/model`;\n        let filesModified = 0;\n\n        try {\n          // Verify model directory exists\n          await fs.access(modelDir);\n        } catch (error) {\n          const err = error as { code?: string };\n          // ENOENT means the directory doesn't exist - nothing to migrate\n          if (err.code === \"ENOENT\") {\n            return {\n              migrationsApplied: 1,\n              filesModified: 0,\n              description:\n                \"Spec version updated to 0.9.0 (Product layer introduced; no model directories to migrate)\",\n            };\n          }\n          // Re-throw other errors (e.g., EACCES for permission denied)\n          throw error;\n        }\n\n        // Rename existing layer directories: shift from 03-12 to 04-13\n        // Must do this in reverse order (12\u219213, 11\u219212, ..., 03\u219204) to avoid conflicts\n        const renameMap = [\n          [\"12_testing\", \"13_testing\"],\n          [\"11_apm\", \"12_apm\"],\n          [\"10_navigation\", \"11_navigation\"],\n          [\"09_ux\", \"10_ux\"],\n          [\"08_data-store\", \"09_data-store\"],\n          [\"07_data-model\", \"08_data-model\"],\n          [\"06_api\", \"07_api\"],\n          [\"05_technology\", \"06_technology\"],\n          [\"04_application\", \"05_application\"],\n          [\"03_security\", \"04_security\"],\n        ];\n\n        const renameErrors: string[] = [];\n\n        for (const [oldName, newName] of renameMap) {\n          const oldPath = pathModule.join(modelDir, oldName);\n          const newPath = pathModule.join(modelDir, newName);\n\n          try {\n            await fs.rename(oldPath, newPath);\n            filesModified++;\n          } catch (error) {\n            const err = error as { code?: string };\n            // ENOENT is expected when a directory hasn't been created yet\n            if (err.code === \"ENOENT\") {\n              continue;\n            }\n            // Track non-ENOENT errors to report them in the result\n            renameErrors.push(\n              `Failed to rename ${oldName} to ${newName}: ${getErrorMessage(error)}`\n            );\n          }\n        }\n\n        // If there were any rename failures, include them in the error field\n        if (renameErrors.length > 0) {\n          return {\n            migrationsApplied: 1,\n            filesModified,\n            description:\n              \"Spec version updated to 0.9.0 (Product layer introduced at layer 3; Security through Testing shifted from layers 3\u201312 to 4\u201313)\",\n            error: renameErrors.join(\"; \"),\n          };\n        }\n\n        // Create new product layer directory (it will be empty for now)\n        // recursive: true handles EEXIST, so no catch needed\n        const productPath = pathModule.join(modelDir, \"03_product\");\n        await fs.mkdir(productPath, { recursive: true });\n\n        return {\n          migrationsApplied: 1,\n          filesModified,\n          description:\n            \"Spec version updated to 0.9.0 (Product layer introduced at layer 3; Security through Testing shifted from layers 3\u201312 to 4\u201313)\",\n        };\n      },\n    });\n  }\n\n  /**\n   * Get the latest available specification version\n   */\n  getLatestVersion(): string {\n    if (this.migrations.length === 0) {\n      return \"0.7.0\";\n    }\n\n    // Return the highest toVersion from all migrations\n    const versions = this.migrations.map((m) => m.toVersion);\n    return versions.sort().reverse()[0];\n  }\n\n  /**\n   * Get the sequence of migrations needed from one version to another\n   */\n  getMigrationPath(fromVersion: string, toVersion?: string): Migration[] {\n    const targetVersion = toVersion || this.getLatestVersion();\n\n    if (this.compareVersions(fromVersion, targetVersion) >= 0) {\n      return [];\n    }\n\n    const path: Migration[] = [];\n    let current = fromVersion;\n\n    // Sort migrations by fromVersion\n    const sortedMigrations = [...this.migrations].sort((a, b) =>\n      this.compareVersions(a.fromVersion, b.fromVersion)\n    );\n\n    for (const migration of sortedMigrations) {\n      // Check if this migration is in our path\n      if (\n        this.compareVersions(current, migration.fromVersion) >= 0 &&\n        this.compareVersions(current, migration.toVersion) < 0 &&\n        this.compareVersions(migration.toVersion, targetVersion) <= 0\n      ) {\n        path.push(migration);\n        current = migration.toVersion;\n      }\n    }\n\n    return path;\n  }\n\n  /**\n   * Check if a model requires migration\n   */\n  requiresMigration(currentVersion: string): boolean {\n    const path = this.getMigrationPath(currentVersion);\n    return path.length > 0;\n  }\n\n  /**\n   * Apply all migrations in sequence\n   */\n  async applyMigrations(\n    model: Model,\n    options: {\n      fromVersion: string;\n      toVersion?: string;\n      dryRun?: boolean;\n      validate?: boolean;\n    }\n  ): Promise<ApplyMigrationsResult> {\n    const path = this.getMigrationPath(options.fromVersion, options.toVersion);\n    const targetVersion = options.toVersion || this.getLatestVersion();\n\n    if (path.length === 0) {\n      return {\n        applied: [],\n        currentVersion: options.fromVersion,\n        targetVersion,\n        totalChanges: 0,\n      };\n    }\n\n    const results: ApplyMigrationsResult = {\n      applied: [],\n      currentVersion: options.fromVersion,\n      targetVersion,\n      totalChanges: 0,\n    };\n\n    for (const migration of path) {\n      if (!options.dryRun) {\n        try {\n          const result = await migration.apply(model);\n\n          results.applied.push({\n            from: migration.fromVersion,\n            to: migration.toVersion,\n            description: migration.description,\n            changes: result,\n          });\n\n          results.totalChanges += result.migrationsApplied;\n\n          // Only update model's spec version if migration succeeded (no error field)\n          if (!result.error) {\n            model.manifest.specVersion = migration.toVersion;\n          } else {\n            // If migration has errors, throw to prevent partial success state\n            throw new Error(result.error);\n          }\n        } catch (error) {\n          throw new Error(\n            `Migration ${migration.fromVersion} \u2192 ${migration.toVersion} failed: ${\n              getErrorMessage(error)\n            }`\n          );\n        }\n      } else {\n        // Dry run - just record what would happen\n        results.applied.push({\n          from: migration.fromVersion,\n          to: migration.toVersion,\n          description: migration.description,\n          dryRun: true,\n        });\n      }\n    }\n\n    return results;\n  }\n\n  /**\n   * Get a summary of migrations that would be applied\n   */\n  getMigrationSummary(\n    fromVersion: string,\n    toVersion?: string\n  ): {\n    currentVersion: string;\n    targetVersion: string;\n    migrationsNeeded: number;\n    migrations: Array<{\n      from: string;\n      to: string;\n      description: string;\n    }>;\n  } {\n    const path = this.getMigrationPath(fromVersion, toVersion);\n    const targetVersion = toVersion || this.getLatestVersion();\n\n    return {\n      currentVersion: fromVersion,\n      targetVersion,\n      migrationsNeeded: path.length,\n      migrations: path.map((m) => ({\n        from: m.fromVersion,\n        to: m.toVersion,\n        description: m.description,\n      })),\n    };\n  }\n\n  /**\n   * Compare two version strings\n   * Returns: -1 if a < b, 0 if a == b, 1 if a > b\n   */\n  private compareVersions(a: string, b: string): number {\n    const aParts = a.split(\".\").map(Number);\n    const bParts = b.split(\".\").map(Number);\n\n    const maxLength = Math.max(aParts.length, bParts.length);\n\n    for (let i = 0; i < maxLength; i++) {\n      const aPart = aParts[i] || 0;\n      const bPart = bParts[i] || 0;\n\n      if (aPart < bPart) return -1;\n      if (aPart > bPart) return 1;\n    }\n\n    return 0;\n  }\n}\n\n/**\n * Result of applying multiple migrations\n */\nexport interface ApplyMigrationsResult {\n  applied: Array<{\n    from: string;\n    to: string;\n    description: string;\n    changes?: MigrationResult;\n    dryRun?: boolean;\n  }>;\n  currentVersion: string;\n  targetVersion: string;\n  totalChanges: number;\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["/**\n * Migration Registry - Manages version-based model migrations\n *\n * Handles sequential migrations from one spec version to another,\n * supporting the evolution of the architecture model specification.\n */\n\nimport type { Model } from \"./model.js\";\nimport { getErrorMessage } from \"../utils/errors.js\";\nimport { applyCatalogMigrations } from \"./catalog-migration.js\";\n\n/**\n * Represents a single version migration\n */\nexport interface Migration {\n  fromVersion: string;\n  toVersion: string;\n  description: string;\n  apply: (model: Model) => Promise<MigrationResult>;\n}\n\n/**\n * Result of applying a migration\n */\nexport interface MigrationResult {\n  migrationsApplied: number;\n  filesModified: number;\n  description: string;\n  error?: string;\n  details?: Record<string, unknown>;\n}\n\n/**\n * Migration Registry managing all available migrations\n */\nexport class MigrationRegistry {\n  private migrations: Migration[] = [];\n\n  constructor() {\n    this.registerMigrations();\n  }\n\n  /**\n   * Register all available migrations\n   */\n  private registerMigrations(): void {\n    // Migration from v0.5.0 to v0.6.0: Relationship Taxonomy\n    this.migrations.push({\n      fromVersion: \"0.5.0\",\n      toVersion: \"0.6.0\",\n      description: \"Relationship Taxonomy (Spec v0.6.0)\",\n      apply: async () => {\n        // This migration is opt-in - the new relationship taxonomy\n        // is fully backward compatible with existing models\n        return {\n          migrationsApplied: 1,\n          filesModified: 0,\n          description: \"Spec version updated to 0.6.0 (Relationship Taxonomy now available)\",\n        };\n      },\n    });\n\n    // Migration from v0.6.0 to v0.7.0: Layer Schema Relationship Metadata\n    this.migrations.push({\n      fromVersion: \"0.6.0\",\n      toVersion: \"0.7.0\",\n      description: \"Layer Schema Relationship Metadata (Spec v0.7.0)\",\n      apply: async () => {\n        // This migration updates layer schemas with relationship metadata sections\n        // - All 12 layer schemas now include layerMetadata, intraLayerRelationships, crossLayerRelationships\n        // - Deprecated link-registry.json (removed in v0.8.0)\n        // - Terminology change: \"cross-layer links\" \u2192 \"cross-layer relationships\"\n        // Fully backward compatible - existing models continue to work\n        return {\n          migrationsApplied: 1,\n          filesModified: 0,\n          description:\n            \"Spec version updated to 0.7.0 (Layer schemas now include relationship metadata sections)\",\n        };\n      },\n    });\n\n    // Migration from v0.7.0 to v0.7.1: Source Code Reference Infrastructure\n    this.migrations.push({\n      fromVersion: \"0.7.0\",\n      toVersion: \"0.7.1\",\n      description: \"Source Code Reference Infrastructure (Spec v0.7.1)\",\n      apply: async () => {\n        // This migration adds source code reference infrastructure\n        // - Common schema definitions in spec/schemas/common/\n        // - Source references integrated across 10 layers\n        // - Backward compatible - existing models continue to work\n        return {\n          migrationsApplied: 1,\n          filesModified: 0,\n          description: \"Spec version updated to 0.7.1 (Source Code Reference Infrastructure)\",\n        };\n      },\n    });\n\n    // Migration from v0.7.1 to v0.8.0: JSON Schema-Only Spec Architecture\n    this.migrations.push({\n      fromVersion: \"0.7.1\",\n      toVersion: \"0.8.0\",\n      description: \"JSON Schema-Only Spec Architecture (Spec v0.8.0)\",\n      apply: async () => {\n        // Spec architecture refactored to JSON Schema-only model:\n        // - Node type definitions moved to spec/schemas/nodes/{layer}/*.node.schema.json\n        // - Relationship definitions moved to spec/schemas/relationships/{layer}/*.relationship.schema.json\n        // - Predicates relocated to spec/schemas/base/predicates.json\n        // This is a spec architecture change only - model data files are fully backward compatible\n        return {\n          migrationsApplied: 1,\n          filesModified: 0,\n          description: \"Spec version updated to 0.8.0 (JSON Schema-Only Spec Architecture)\",\n        };\n      },\n    });\n\n    // Migration from v0.8.0 to v0.8.1: Expanded Relationship Coverage and Node Improvements\n    this.migrations.push({\n      fromVersion: \"0.8.0\",\n      toVersion: \"0.8.1\",\n      description: \"Expanded Relationship Coverage and Node Improvements (Spec v0.8.1)\",\n      apply: async () => {\n        // Spec enhancements only - no model data format changes:\n        // - 733 new relationship schemas added across all 12 layers\n        // - Node type descriptions improved for all 12 layers\n        // - Enum-masquerader node types consolidated into parent attributes\n        // - Existing models continue to work without modification\n        return {\n          migrationsApplied: 1,\n          filesModified: 0,\n          description: \"Spec version updated to 0.8.1 (Expanded Relationship Coverage and Node Improvements)\",\n        };\n      },\n    });\n\n    // Migration from v0.8.1 to v0.8.2: UUID/Path identifier separation\n    this.migrations.push({\n      fromVersion: \"0.8.1\",\n      toVersion: \"0.8.2\",\n      description: \"UUID/Path identifier separation (Spec v0.8.2)\",\n      apply: async () => {\n        // The path field is now required on all spec nodes (spec-node.schema.json).\n        // Existing elements are migrated automatically on load in model.ts (loadLayer):\n        // - Elements with slug-format id: slug moved to path, deterministic UUID assigned to id\n        // - Elements with UUID id but no path: path derived from layer_id.type.kebab(name)\n        // No manual data file changes needed; migration runs transparently on next load/save.\n        return {\n          migrationsApplied: 1,\n          filesModified: 0,\n          description: \"Spec version updated to 0.8.2 (UUID/Path identifier separation)\",\n        };\n      },\n    });\n\n    // Migration from v0.8.2 to v0.8.3: Inter-layer Relationship Schemas and APM Node Types\n    this.migrations.push({\n      fromVersion: \"0.8.2\",\n      toVersion: \"0.8.3\",\n      description: \"Inter-layer Relationship Schemas and APM Node Types (Spec v0.8.3)\",\n      apply: async () => {\n        // Major expansion of inter-layer relationship coverage and APM layer:\n        // - 495 new inter-layer relationship schemas across all 12 layers\n        // - Total relationship count increased from 969 to 1,447\n        // - 2 new APM node types: apm.alert and apm.dashboard\n        // - Backward compatible - existing models continue to work without modification\n        return {\n          migrationsApplied: 1,\n          filesModified: 0,\n          description: \"Spec version updated to 0.8.3 (Inter-layer Relationship Schemas and APM Node Types)\",\n        };\n      },\n    });\n\n    // Migration from v0.8.3 to v0.8.4: Analyzer Infrastructure (CBM Mapping)\n    this.migrations.push({\n      fromVersion: \"0.8.3\",\n      toVersion: \"0.8.4\",\n      description: \"Analyzer Infrastructure (Spec v0.8.4)\",\n      apply: async () => {\n        // Introduces spec/analyzers/ with codebase-memory (CBM) mapping:\n        // - New analyzer adapter foundation and full analyzer subcommands\n        // - dr analyzer verify with changeset awareness\n        // - Claude Code integration commands (/dr-verify, /dr-map, dr-extractor)\n        // - No model data format changes; existing models are fully compatible\n        return {\n          migrationsApplied: 1,\n          filesModified: 0,\n          description: \"Spec version updated to 0.8.4 (Analyzer Infrastructure)\",\n        };\n      },\n    });\n\n    // Migration from v0.8.4 to v0.9.0: Product Layer Introduction\n    this.migrations.push({\n      fromVersion: \"0.8.4\",\n      toVersion: \"0.9.0\",\n      description: \"Product Layer Introduction (Spec v0.9.0)\",\n      apply: async (model: Model) => {\n        const fs = await import(\"fs/promises\");\n        const pathModule = await import(\"path\");\n\n        const modelDir = `${model.rootPath}/documentation-robotics/model`;\n        let filesModified = 0;\n\n        try {\n          // Verify model directory exists\n          await fs.access(modelDir);\n        } catch (error) {\n          const err = error as { code?: string };\n          // ENOENT means the directory doesn't exist - nothing to migrate\n          if (err.code === \"ENOENT\") {\n            return {\n              migrationsApplied: 1,\n              filesModified: 0,\n              description:\n                \"Spec version updated to 0.9.0 (Product layer introduced; no model directories to migrate)\",\n            };\n          }\n          // Re-throw other errors (e.g., EACCES for permission denied)\n          throw error;\n        }\n\n        // Rename existing layer directories: shift from 03-12 to 04-13\n        // Must do this in reverse order (12\u219213, 11\u219212, ..., 03\u219204) to avoid conflicts\n        const renameMap = [\n          [\"12_testing\", \"13_testing\"],\n          [\"11_apm\", \"12_apm\"],\n          [\"10_navigation\", \"11_navigation\"],\n          [\"09_ux\", \"10_ux\"],\n          [\"08_data-store\", \"09_data-store\"],\n          [\"07_data-model\", \"08_data-model\"],\n          [\"06_api\", \"07_api\"],\n          [\"05_technology\", \"06_technology\"],\n          [\"04_application\", \"05_application\"],\n          [\"03_security\", \"04_security\"],\n        ];\n\n        const renameErrors: string[] = [];\n\n        for (const [oldName, newName] of renameMap) {\n          const oldPath = pathModule.join(modelDir, oldName);\n          const newPath = pathModule.join(modelDir, newName);\n\n          try {\n            await fs.rename(oldPath, newPath);\n            filesModified++;\n          } catch (error) {\n            const err = error as { code?: string };\n            // ENOENT is expected when a directory hasn't been created yet\n            if (err.code === \"ENOENT\") {\n              continue;\n            }\n            // Track non-ENOENT errors to report them in the result\n            renameErrors.push(\n              `Failed to rename ${oldName} to ${newName}: ${getErrorMessage(error)}`\n            );\n          }\n        }\n\n        // If there were any rename failures, include them in the error field\n        if (renameErrors.length > 0) {\n          return {\n            migrationsApplied: 1,\n            filesModified,\n            description:\n              \"Spec version updated to 0.9.0 (Product layer introduced at layer 3; Security through Testing shifted from layers 3\u201312 to 4\u201313)\",\n            error: renameErrors.join(\"; \"),\n          };\n        }\n\n        // Create new product layer directory (it will be empty for now)\n        // recursive: true handles EEXIST, so no catch needed\n        const productPath = pathModule.join(modelDir, \"03_product\");\n        await fs.mkdir(productPath, { recursive: true });\n\n        return {\n          migrationsApplied: 1,\n          filesModified,\n          description:\n            \"Spec version updated to 0.9.0 (Product layer introduced at layer 3; Security through Testing shifted from layers 3\u201312 to 4\u201313)\",\n        };\n      },\n    });\n\n    // Migration from v0.9.0 to v0.10.0: objectschema.required type change and relationship catalog rewrites\n    this.migrations.push({\n      fromVersion: \"0.9.0\",\n      toVersion: \"0.10.0\",\n      description:\n        \"Data Model objectschema.required type change, element type renames and relationship catalog rewrites (Spec v0.10.0)\",\n      apply: async (model: Model) => {\n        const required = await migrateObjectSchemaRequired(model);\n\n        // Element type renames, then relationship rewrites in relationships.yaml and in staged\n        // changesets: shared with `dr upgrade` on a model already at the current version\n        const catalog = await applyCatalogMigrations(model);\n        const errors = [...required.errors, ...catalog.errors];\n\n        return {\n          migrationsApplied: 1,\n          filesModified: required.filesModified + catalog.filesModified,\n          description: `Spec version updated to 0.10.0 (objectschema.required converted from string to array; ${catalog.summaries.join(\"; \")})`,\n          ...(errors.length > 0 && { error: errors.join(\"; \") }),\n          details: catalog.details,\n        };\n      },\n    });\n\n    // Migration from v0.10.0 to v0.11.0: the layer rules pass retired relationship types and\n    // predicates; CLI 0.2.0 stamped models 0.10.0 with the catalog from before it\n    this.migrations.push({\n      fromVersion: \"0.10.0\",\n      toVersion: \"0.11.0\",\n      description: \"Relationship catalog rewrites from the layer rules pass (Spec v0.11.0)\",\n      apply: async (model: Model) => {\n        const catalog = await applyCatalogMigrations(model);\n        return {\n          migrationsApplied: 1,\n          filesModified: catalog.filesModified,\n          description: `Spec version updated to 0.11.0 (${catalog.summaries.join(\"; \")})`,\n          ...(catalog.errors.length > 0 && { error: catalog.errors.join(\"; \") }),\n          details: catalog.details,\n        };\n      },\n    });\n  }\n\n  /**\n   * Get the latest available specification version\n   */\n  getLatestVersion(): string {\n    if (this.migrations.length === 0) {\n      return \"0.7.0\";\n    }\n\n    // Return the highest toVersion from all migrations using proper version comparison\n    const versions = this.migrations.map((m) => m.toVersion);\n    return versions.reduce((max, current) => {\n      return this.compareVersions(current, max) > 0 ? current : max;\n    });\n  }\n\n  /**\n   * Get the sequence of migrations needed from one version to another\n   */\n  getMigrationPath(fromVersion: string, toVersion?: string): Migration[] {\n    const targetVersion = toVersion || this.getLatestVersion();\n\n    if (this.compareVersions(fromVersion, targetVersion) >= 0) {\n      return [];\n    }\n\n    const path: Migration[] = [];\n    let current = fromVersion;\n\n    // Sort migrations by fromVersion\n    const sortedMigrations = [...this.migrations].sort((a, b) =>\n      this.compareVersions(a.fromVersion, b.fromVersion)\n    );\n\n    for (const migration of sortedMigrations) {\n      // Check if this migration is in our path\n      if (\n        this.compareVersions(current, migration.fromVersion) >= 0 &&\n        this.compareVersions(current, migration.toVersion) < 0 &&\n        this.compareVersions(migration.toVersion, targetVersion) <= 0\n      ) {\n        path.push(migration);\n        current = migration.toVersion;\n      }\n    }\n\n    return path;\n  }\n\n  /**\n   * Check if a model requires migration\n   */\n  requiresMigration(currentVersion: string): boolean {\n    const path = this.getMigrationPath(currentVersion);\n    return path.length > 0;\n  }\n\n  /**\n   * Apply all migrations in sequence\n   */\n  async applyMigrations(\n    model: Model,\n    options: {\n      fromVersion: string;\n      toVersion?: string;\n      dryRun?: boolean;\n      validate?: boolean;\n    }\n  ): Promise<ApplyMigrationsResult> {\n    const path = this.getMigrationPath(options.fromVersion, options.toVersion);\n    const targetVersion = options.toVersion || this.getLatestVersion();\n\n    if (path.length === 0) {\n      return {\n        applied: [],\n        currentVersion: options.fromVersion,\n        targetVersion,\n        totalChanges: 0,\n      };\n    }\n\n    const results: ApplyMigrationsResult = {\n      applied: [],\n      currentVersion: options.fromVersion,\n      targetVersion,\n      totalChanges: 0,\n    };\n\n    for (const migration of path) {\n      if (!options.dryRun) {\n        try {\n          const result = await migration.apply(model);\n\n          results.applied.push({\n            from: migration.fromVersion,\n            to: migration.toVersion,\n            description: migration.description,\n            changes: result,\n          });\n\n          results.totalChanges += result.migrationsApplied;\n\n          // Only update model's spec version if migration succeeded (no error field)\n          if (!result.error) {\n            model.manifest.specVersion = migration.toVersion;\n          } else {\n            // If migration has errors, throw to prevent partial success state\n            throw new Error(result.error);\n          }\n        } catch (error) {\n          throw new Error(\n            `Migration ${migration.fromVersion} \u2192 ${migration.toVersion} failed: ${\n              getErrorMessage(error)\n            }`\n          );\n        }\n      } else {\n        // Dry run - just record what would happen\n        results.applied.push({\n          from: migration.fromVersion,\n          to: migration.toVersion,\n          description: migration.description,\n          dryRun: true,\n        });\n      }\n    }\n\n    return results;\n  }\n\n  /**\n   * Get a summary of migrations that would be applied\n   */\n  getMigrationSummary(\n    fromVersion: string,\n    toVersion?: string\n  ): {\n    currentVersion: string;\n    targetVersion: string;\n    migrationsNeeded: number;\n    migrations: Array<{\n      from: string;\n      to: string;\n      description: string;\n    }>;\n  } {\n    const path = this.getMigrationPath(fromVersion, toVersion);\n    const targetVersion = toVersion || this.getLatestVersion();\n\n    return {\n      currentVersion: fromVersion,\n      targetVersion,\n      migrationsNeeded: path.length,\n      migrations: path.map((m) => ({\n        from: m.fromVersion,\n        to: m.toVersion,\n        description: m.description,\n      })),\n    };\n  }\n\n  /**\n   * Compare two version strings\n   * Returns: -1 if a < b, 0 if a == b, 1 if a > b\n   */\n  private compareVersions(a: string, b: string): number {\n    const aParts = a.split(\".\").map(Number);\n    const bParts = b.split(\".\").map(Number);\n\n    const maxLength = Math.max(aParts.length, bParts.length);\n\n    for (let i = 0; i < maxLength; i++) {\n      const aPart = aParts[i] || 0;\n      const bPart = bParts[i] || 0;\n\n      if (aPart < bPart) return -1;\n      if (aPart > bPart) return 1;\n    }\n\n    return 0;\n  }\n}\n\n/**\n * Result of applying multiple migrations\n */\nexport interface ApplyMigrationsResult {\n  applied: Array<{\n    from: string;\n    to: string;\n    description: string;\n    changes?: MigrationResult;\n    dryRun?: boolean;\n  }>;\n  currentVersion: string;\n  targetVersion: string;\n  totalChanges: number;\n}\n\n/**\n * Spec v0.10.0: data-model.objectschema `required` changed from a comma-separated string to an\n * array of property names. Converts every string value in 08_data-model/*.yaml, and in the\n * data-model layer when the model has it loaded: `dr upgrade` saves the loaded layers after\n * migrating, which would otherwise write the old strings back over the converted files.\n */\nasync function migrateObjectSchemaRequired(\n  model: Model\n): Promise<{ filesModified: number; errors: string[] }> {\n  const result = await migrateObjectSchemaRequiredFiles(model);\n  migrateLoadedObjectSchemaRequired(model);\n  return result;\n}\n\n/** A comma-separated `required` string as an array of property names; null for any other value */\nfunction requiredAsArray(required: unknown): string[] | null {\n  if (!required || typeof required !== \"string\") {\n    return null;\n  }\n  return required\n    .split(\",\")\n    .map((item) => item.trim())\n    .filter((item) => item.length > 0);\n}\n\nfunction migrateLoadedObjectSchemaRequired(model: Model): void {\n  // The committed layer: getLayer() would merge in an active changeset's staged changes\n  const layer = model.layers.get(\"data-model\");\n  if (!layer) {\n    return;\n  }\n  for (const element of layer.listElements()) {\n    if (element.spec_node_id !== \"data-model.objectschema\") {\n      continue;\n    }\n    const required = requiredAsArray(element.attributes.required);\n    if (required) {\n      element.attributes = { ...element.attributes, required };\n      layer.updateElement(element);\n    }\n  }\n}\n\nasync function migrateObjectSchemaRequiredFiles(\n  model: Model\n): Promise<{ filesModified: number; errors: string[] }> {\n  const fs = await import(\"fs/promises\");\n  const pathModule = await import(\"path\");\n  const YAML = await import(\"yaml\");\n\n  const dataModelDir = pathModule.join(model.rootPath, \"documentation-robotics/model/08_data-model\");\n  let filesModified = 0;\n\n  try {\n    await fs.access(dataModelDir);\n  } catch (error) {\n    // ENOENT means the directory doesn't exist - nothing to migrate\n    if ((error as { code?: string }).code === \"ENOENT\") {\n      return { filesModified: 0, errors: [] };\n    }\n    throw error;\n  }\n\n  const files = await fs.readdir(dataModelDir);\n  const errors: string[] = [];\n\n  for (const file of files) {\n    if (!file.endsWith(\".yaml\") && !file.endsWith(\".yml\")) {\n      continue;\n    }\n\n    const filePath = pathModule.join(dataModelDir, file);\n    try {\n      const content = await fs.readFile(filePath, \"utf-8\");\n      let modified = false;\n      const doc = YAML.parse(content);\n\n      if (!doc || typeof doc !== \"object\") {\n        continue;\n      }\n\n      for (const [, element] of Object.entries(doc)) {\n        if (\n          !element ||\n          typeof element !== \"object\" ||\n          (element as Record<string, unknown>).spec_node_id !== \"data-model.objectschema\"\n        ) {\n          continue;\n        }\n\n        const attributes = (element as Record<string, unknown>).attributes as\n          | Record<string, unknown>\n          | undefined;\n\n        if (attributes && typeof attributes === \"object\") {\n          const required = requiredAsArray(attributes.required);\n          if (required) {\n            attributes.required = required;\n            modified = true;\n          }\n        }\n      }\n\n      if (modified) {\n        await fs.writeFile(filePath, YAML.stringify(doc), \"utf-8\");\n        filesModified++;\n      }\n    } catch (error) {\n      errors.push(`Failed to migrate ${file}: ${getErrorMessage(error)}`);\n    }\n  }\n\n  return { filesModified, errors };\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/core/model-upgrade.js

@@ -0,0 +1,102 @@
+import { readdir } from "fs/promises";
+import { Model } from "./model.js";
+import { MigrationRegistry } from "./migration-registry.js";
+import { applyCatalogMigrations } from "./catalog-migration.js";
+import { BaseSnapshotManager } from "./base-snapshot-manager.js";
+import { StagedChangesetStorage } from "./staged-changeset-storage.js";
+import { FileLock } from "../utils/file-lock.js";
+import { getErrorMessage } from "../utils/errors.js";
+async function upgradeModel(startPath, options) {
+  const model = await Model.load(startPath, { lazyLoad: !1 }), baselines = await captureChangesetBaselines(model);
+  let migration;
+  if (options.versionBumpOnly)
+    model.manifest.specVersion = options.toVersion, await model.saveManifest();
+  else if (options.catalogOnly) {
+    const catalog = await applyCatalogMigrations(model);
+    if (catalog.errors.length > 0)
+      throw new Error(`Catalog migration failed: ${catalog.errors.join("; ")}`);
+    migration = {
+      applied: [
+        {
+          from: options.fromVersion,
+          to: options.toVersion,
+          description: `Catalog changes applied (${catalog.summaries.join("; ")})`,
+          changes: {
+            migrationsApplied: 1,
+            filesModified: catalog.filesModified,
+            description: catalog.summaries.join("; "),
+            details: catalog.details
+          }
+        }
+      ],
+      currentVersion: options.fromVersion,
+      targetVersion: options.toVersion,
+      totalChanges: 1
+    }, await model.saveDirtyLayers();
+  } else
+    migration = await new MigrationRegistry().applyMigrations(model, {
+      fromVersion: options.fromVersion,
+      toVersion: options.toVersion,
+      dryRun: !1,
+      validate: options.validate ?? !0
+    }), await model.saveManifest(), await model.saveDirtyLayers();
+  return { migration, changesets: await rebaselineChangesets(startPath, baselines) };
+}
+async function captureChangesetBaselines(model) {
+  if (model.lazyLoad)
+    throw new Error("captureChangesetBaselines needs a model loaded with lazyLoad: false");
+  const { changesets, errors } = await listStagedChangesets(model.rootPath), baselines = { snapshot: null, inStep: [], drifted: [], errors };
+  if (changesets.length === 0)
+    return baselines;
+  const snapshot = await new BaseSnapshotManager().captureSnapshot(model);
+  baselines.snapshot = snapshot;
+  for (const { ref, baseSnapshot } of changesets)
+    baseSnapshot && (baseSnapshot === snapshot ? baselines.inStep : baselines.drifted).push(ref);
+  return baselines;
+}
+async function rebaselineChangesets(startPath, baselines) {
+  const result = {
+    rebaselined: [],
+    drifted: baselines.drifted,
+    errors: [...baselines.errors]
+  };
+  if (baselines.inStep.length === 0)
+    return result;
+  const upgraded = await Model.load(startPath, { lazyLoad: !1 }), snapshot = await new BaseSnapshotManager().captureSnapshot(upgraded), storage = new StagedChangesetStorage(upgraded.rootPath);
+  for (const ref of baselines.inStep)
+    try {
+      await new FileLock(storage.getChangesetPath(ref.id)).withLock(async () => {
+        const changeset = await storage.load(ref.id);
+        !changeset || changeset.status !== "staged" || changeset.baseSnapshot !== baselines.snapshot || (changeset.baseSnapshot = snapshot, changeset.updateModified(), await storage.save(changeset), result.rebaselined.push(ref));
+      });
+    } catch (error) {
+      result.errors.push(`Could not re-baseline changeset '${ref.name}': ${getErrorMessage(error)}; committing it needs --force`);
+    }
+  return result;
+}
+async function listStagedChangesets(rootPath) {
+  const storage = new StagedChangesetStorage(rootPath), changesets = [], errors = [];
+  let ids;
+  try {
+    ids = (await readdir(storage.getChangesetsDir(), { withFileTypes: !0 })).filter((entry) => entry.isDirectory() && !entry.name.endsWith(".lock")).map((entry) => entry.name).sort();
+  } catch (error) {
+    return error.code !== "ENOENT" && errors.push(`Could not list changesets: ${getErrorMessage(error)}`), { changesets, errors };
+  }
+  for (const id of ids)
+    try {
+      const changeset = await storage.load(id);
+      changeset?.status === "staged" && changesets.push({
+        ref: { id, name: changeset.name || id },
+        baseSnapshot: changeset.baseSnapshot
+      });
+    } catch (error) {
+      errors.push(`Could not read changeset '${id}': ${getErrorMessage(error)}`);
+    }
+  return { changesets, errors };
+}
+export {
+  captureChangesetBaselines,
+  rebaselineChangesets,
+  upgradeModel
+};
+//# sourceMappingURL=model-upgrade.js.map