@documentation-robotics/cli 0.2.0 → 0.4.0

package/dist/core/mutation-handler.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/core/mutation-handler.ts"],
-  "sourcesContent": ["/**\n * MutationHandler - Unified mutation execution strategy\n *\n * Eliminates duplicate code paths by centralizing all element mutations.\n * Ensures consistency between staging and base model operations through\n * a single execution path that supports both.\n *\n * This fixes data corruption risk from divergent code paths in add/update/delete commands.\n */\n\nimport { Model } from \"./model.js\";\nimport { Element } from \"./element.js\";\nimport { StagingAreaManager } from \"./staging-area.js\";\nimport { isValidLayerName } from \"./layers.js\";\nimport { CLIError } from \"../utils/errors.js\";\nimport { getErrorMessage } from \"../utils/errors.js\";\nimport { ModelReportOrchestrator } from \"../reports/model-report-orchestrator.js\";\nimport { emitLog, SeverityNumber } from \"../telemetry/index.js\";\n\nexport type MutationType = \"add\" | \"update\" | \"delete\";\n\nexport interface MutationContext {\n  model: Model;\n  elementId: string;\n  layerName: string;\n  element?: Element;\n  before?: Record<string, unknown>;\n  after?: Record<string, unknown>;\n}\n\nexport interface MutationStep {\n  execute: (context: MutationContext) => void | Promise<void>;\n  stageable: boolean; // Can this step be executed in staging?\n  description: string;\n}\n\n/**\n * Unified mutation executor\n *\n * Single point of mutation execution that:\n * 1. Builds complete before/after states\n * 2. Validates mutations\n * 3. Executes consistently for both staging and base model\n * 4. Handles all persistence atomically\n * 5. Tracks changes in legacy changeset context\n */\nexport class MutationHandler {\n  private context: MutationContext;\n  private steps: MutationStep[] = [];\n  private stagingManager: StagingAreaManager;\n\n  constructor(model: Model, elementId: string, layerName: string) {\n    this.context = { model, elementId, layerName };\n    this.stagingManager = new StagingAreaManager(model.rootPath, model);\n  }\n\n  /**\n   * Set the element being mutated\n   */\n  setElement(element: Element): this {\n    this.context.element = element;\n    return this;\n  }\n\n  /**\n   * Add a mutation step\n   */\n  addStep(step: MutationStep): this {\n    this.steps.push(step);\n    return this;\n  }\n\n  /**\n   * Get before state (snapshot before mutations)\n   */\n  getBeforeState(): Record<string, unknown> | undefined {\n    return this.context.before;\n  }\n\n  /**\n   * Get after state (result of mutations)\n   */\n  getAfterState(): Record<string, unknown> | undefined {\n    return this.context.after;\n  }\n\n  /**\n   * Get staging manager for accessing changeset information\n   */\n  getStagingManager(): StagingAreaManager {\n    return this.stagingManager;\n  }\n\n  /**\n   * Compute before and after states\n   *\n   * For add: before is undefined, after is the new element state\n   * For update: before is original state, after is modified state\n   * For delete: before is original state, after is undefined\n   */\n  async computeStates(element: Element): Promise<void> {\n    this.context.element = element;\n    this.context.before = element.toJSON() as unknown as Record<string, unknown>;\n    this.context.after = { ...this.context.before };\n  }\n\n  /**\n   * Execute mutation for add operation\n   */\n  async executeAdd(\n    element: Element,\n    mutator: (elem: Element) => void | Promise<void>\n  ): Promise<void> {\n    // For add, before is undefined, after is the new element\n    this.context.element = element;\n    this.context.before = undefined;\n\n    // Check if we're in staging mode\n    const activeChangeset = await this.stagingManager.getActive();\n    if (activeChangeset && activeChangeset.status === \"staged\") {\n      // Staging path: capture after state and stage\n      this.context.after = element.toJSON() as unknown as Record<string, unknown>;\n\n      await this.stagingManager.stage(activeChangeset.id, {\n        type: \"add\",\n        elementId: this.context.elementId,\n        layerName: this.context.layerName,\n        after: this.context.after,\n        timestamp: new Date().toISOString(),\n      });\n      return;\n    }\n\n    // Base model path: add element and persist\n    await mutator(element);\n    this.context.after = element.toJSON() as unknown as Record<string, unknown>;\n\n    // Persist to base model\n    await this._persistChanges(\"add\");\n  }\n\n  /**\n   * Execute mutation for update operation\n   */\n  async executeUpdate(\n    element: Element,\n    mutator: (elem: Element, after: Record<string, unknown>) => Promise<void>\n  ): Promise<void> {\n    // Compute before and after states\n    this.context.element = element;\n    this.context.before = element.toJSON() as unknown as Record<string, unknown>;\n    this.context.after = { ...this.context.before };\n\n    // Check if we're in staging mode\n    const activeChangeset = await this.stagingManager.getActive();\n    if (activeChangeset && activeChangeset.status === \"staged\") {\n      // Staging path: apply mutations to after state, then stage\n      await mutator(element, this.context.after);\n\n      await this.stagingManager.stage(activeChangeset.id, {\n        type: \"update\",\n        elementId: this.context.elementId,\n        layerName: this.context.layerName,\n        before: this.context.before,\n        after: this.context.after,\n        timestamp: new Date().toISOString(),\n      });\n      return;\n    }\n\n    // Base model path: apply mutations atomically\n    await this._executeBasePath(mutator);\n  }\n\n  /**\n   * Execute mutation for delete operation\n   */\n  async executeDelete(element: Element): Promise<void> {\n    // For delete, before is the current state, after is undefined\n    this.context.element = element;\n    this.context.before = element.toJSON() as unknown as Record<string, unknown>;\n    this.context.after = undefined;\n\n    // Check if we're in staging mode\n    const activeChangeset = await this.stagingManager.getActive();\n    if (activeChangeset && activeChangeset.status === \"staged\") {\n      // Staging path: stage the deletion only\n      await this.stagingManager.stage(activeChangeset.id, {\n        type: \"delete\",\n        elementId: this.context.elementId,\n        layerName: this.context.layerName,\n        before: this.context.before,\n        timestamp: new Date().toISOString(),\n      });\n      return;\n    }\n\n    // Base model path: delete from model\n    const layer = (await this.context.model.getLayer(this.context.layerName))!;\n    const deleted = layer.deleteElement(element.path || element.id);\n\n    if (!deleted) {\n      throw new CLIError(`Failed to delete element ${this.context.elementId}`, 1, [\n        \"Element may have already been deleted\",\n      ]);\n    }\n\n    // Delete relationships\n    this.context.model.relationships.deleteForElement(this.context.elementId);\n\n    // Track and save atomically\n    await this._persistChanges(\"delete\");\n  }\n\n  /**\n   * Execute all registered steps and persist\n   */\n  async execute(\n    mutator: (elem: Element, after: Record<string, unknown>) => Promise<void>,\n    type: \"add\" | \"update\" | \"delete\"\n  ): Promise<void> {\n    if (!this.context.element) {\n      throw new CLIError(\"Element not set on MutationHandler\", 1);\n    }\n\n    // Check if we're in staging mode\n    const activeChangeset = await this.stagingManager.getActive();\n    if (activeChangeset && activeChangeset.status === \"staged\") {\n      // Staging path: build after state and stage\n      if (this.context.before === undefined && type !== \"add\") {\n        this.context.before = this.context.element.toJSON() as unknown as Record<string, unknown>;\n      }\n\n      this.context.after =\n        type === \"delete\"\n          ? undefined\n          : {\n              ...(this.context.before ||\n                (this.context.element.toJSON() as unknown as Record<string, unknown>)),\n            };\n\n      if (type !== \"delete\" && this.context.after) {\n        await mutator(this.context.element, this.context.after);\n      }\n\n      await this.stagingManager.stage(activeChangeset.id, {\n        type,\n        elementId: this.context.elementId,\n        layerName: this.context.layerName,\n        ...(this.context.before !== undefined && { before: this.context.before }),\n        ...(this.context.after !== undefined && { after: this.context.after }),\n        timestamp: new Date().toISOString(),\n      });\n      return;\n    }\n\n    // Base model path: execute and persist atomically\n    await this._executeBasePath(mutator, type);\n  }\n\n  /**\n   * Base model path: execute mutations and persist atomically\n   */\n  private async _executeBasePath(\n    mutator: (elem: Element, after: Record<string, unknown>) => Promise<void>,\n    type?: string\n  ): Promise<void> {\n    if (!this.context.element) {\n      throw new CLIError(\"Element not set\", 1);\n    }\n\n    // Initialize before state if not already set\n    if (this.context.before === undefined) {\n      this.context.before = this.context.element.toJSON() as unknown as Record<string, unknown>;\n    }\n\n    // Initialize after state if not already set\n    if (this.context.after === undefined) {\n      this.context.after = { ...this.context.before };\n    }\n\n    // Apply mutations to element AND after state together\n    // This ensures they stay in sync\n    await mutator(this.context.element, this.context.after);\n\n    // Persist changes to disk\n    await this._persistChanges(type);\n  }\n\n  /**\n   * Persist changes to disk\n   *\n   * Performs sequential writes to layer, relationships, and manifest files.\n   * If any write fails, subsequent writes are skipped via error propagation.\n   * Note: Not truly atomic\u2014if a write succeeds then a later write fails,\n   * earlier writes remain on disk. Use within transaction-like contexts only.\n   */\n  private async _persistChanges(type?: string): Promise<void> {\n    try {\n      // Save layer\n      await this.context.model.saveLayer(this.context.layerName);\n\n      // Save relationships if modified (for deletes)\n      if (type === \"delete\" && this.context.model.relationships.isDirty()) {\n        await this.context.model.saveRelationships();\n      }\n\n      // Save manifest\n      await this.context.model.saveManifest();\n    } catch (error) {\n      throw new CLIError(\n        `Failed to persist changes: ${getErrorMessage(error)}`,\n        1,\n        [\"Check that the model directory is writable\", \"Verify the model is not corrupted\"]\n      );\n    }\n\n    // Post-persist: regenerate affected layer reports (non-blocking, FR-4)\n    // This is a separate try/catch from the above to ensure report failures never cause mutations to fail\n    try {\n      const orchestrator = new ModelReportOrchestrator(\n        this.context.model,\n        this.context.model.rootPath\n      );\n      if (isValidLayerName(this.context.layerName)) {\n        const affected = orchestrator.computeAffectedLayers(this.context.layerName);\n        await orchestrator.regenerate(affected);\n      } else {\n        emitLog(SeverityNumber.WARN, \"Report regeneration skipped: invalid layer name\", {\n          \"layer.name\": this.context.layerName,\n          \"elementId\": this.context.elementId,\n        });\n      }\n    } catch (error) {\n      emitLog(SeverityNumber.WARN, \"Failed to update layer reports after mutation\", {\n        \"error\": getErrorMessage(error),\n        \"layer.name\": this.context.layerName,\n        \"elementId\": this.context.elementId,\n      });\n    }\n  }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["/**\n * MutationHandler - Unified mutation execution strategy\n *\n * Eliminates duplicate code paths by centralizing all element mutations.\n * Ensures consistency between staging and base model operations through\n * a single execution path that supports both.\n *\n * This fixes data corruption risk from divergent code paths in add/update/delete commands.\n */\n\nimport { Model } from \"./model.js\";\nimport { Element } from \"./element.js\";\nimport { elementIdentifiers } from \"./relationships.js\";\nimport { StagingAreaManager } from \"./staging-area.js\";\nimport { isValidLayerName } from \"./layers.js\";\nimport { CLIError } from \"../utils/errors.js\";\nimport { ChangesetOnlyError } from \"./changeset-only-guard.js\";\nimport { getErrorMessage } from \"../utils/errors.js\";\nimport { ModelReportOrchestrator } from \"../reports/model-report-orchestrator.js\";\nimport { emitLog, SeverityNumber } from \"../telemetry/index.js\";\nimport type { Changeset, StagedChange } from \"./changeset.js\";\nimport { changedFields } from \"./changeset-summary.js\";\n\n/**\n * An element snapshot staged by an add, with an update applied: the top-level keys the update\n * changed (before vs after) take their new value, and a key the update cleared is removed. Keys the\n * update did not touch keep the add's own value, so the add's shape is preserved.\n */\nexport function foldIntoSnapshot(\n  addAfter: Record<string, unknown>,\n  before: Record<string, unknown> | undefined,\n  after: Record<string, unknown> | undefined\n): Record<string, unknown> {\n  const folded = { ...addAfter };\n  const b = before ?? {};\n  const a = after ?? {};\n  for (const key of new Set([...Object.keys(b), ...Object.keys(a)])) {\n    if (JSON.stringify(b[key]) === JSON.stringify(a[key])) continue;\n    if (a[key] === undefined) {\n      delete folded[key];\n    } else {\n      folded[key] = a[key];\n    }\n  }\n  // A cleared source reference is written as `source_reference: null`; drop the legacy camelCase key\n  // so it cannot shadow it.\n  if (\"source_reference\" in a && JSON.stringify(b.source_reference) !== JSON.stringify(a.source_reference)) {\n    delete folded.sourceReference;\n  }\n  return folded;\n}\n\nexport type MutationType = \"add\" | \"update\" | \"delete\";\n\nexport interface MutationContext {\n  model: Model;\n  elementId: string;\n  layerName: string;\n  element?: Element;\n  before?: Record<string, unknown>;\n  after?: Record<string, unknown>;\n}\n\nexport interface MutationStep {\n  execute: (context: MutationContext) => void | Promise<void>;\n  stageable: boolean; // Can this step be executed in staging?\n  description: string;\n}\n\n/**\n * Unified mutation executor\n *\n * Single point of mutation execution that:\n * 1. Builds complete before/after states\n * 2. Validates mutations\n * 3. Executes consistently for both staging and base model\n * 4. Handles all persistence atomically\n * 5. Tracks changes in legacy changeset context\n */\nexport class MutationHandler {\n  private context: MutationContext;\n  private steps: MutationStep[] = [];\n  private stagingManager: StagingAreaManager;\n  private changedFields: string[] = [];\n  private foldedIntoAdd = false;\n\n  constructor(model: Model, elementId: string, layerName: string) {\n    this.context = { model, elementId, layerName };\n    this.stagingManager = new StagingAreaManager(model.rootPath, model);\n  }\n\n  /**\n   * Set the element being mutated\n   */\n  setElement(element: Element): this {\n    this.context.element = element;\n    return this;\n  }\n\n  /**\n   * Add a mutation step\n   */\n  addStep(step: MutationStep): this {\n    this.steps.push(step);\n    return this;\n  }\n\n  /**\n   * Get before state (snapshot before mutations)\n   */\n  getBeforeState(): Record<string, unknown> | undefined {\n    return this.context.before;\n  }\n\n  /**\n   * Get after state (result of mutations)\n   */\n  getAfterState(): Record<string, unknown> | undefined {\n    return this.context.after;\n  }\n\n  /**\n   * Get staging manager for accessing changeset information\n   */\n  getStagingManager(): StagingAreaManager {\n    return this.stagingManager;\n  }\n\n  /**\n   * The fields the last executeUpdate changed (`attributes.x` for attribute keys), sorted.\n   * Empty before an update runs or when it changed nothing.\n   */\n  getChangedFields(): string[] {\n    return this.changedFields;\n  }\n\n  /** Whether the last executeUpdate rewrote the changeset's staged add of the element in place. */\n  wasFoldedIntoAdd(): boolean {\n    return this.foldedIntoAdd;\n  }\n\n  /**\n   * The active changeset's add of this element, when an update should be folded into it: the\n   * add is the element's only staged element change (an update staged after it by an earlier\n   * build keeps the old append behaviour, so it is not overridden), and the base model does not\n   * already hold the element (commit skips such an add; a staged update still applies).\n   */\n  private async stagedAddToFoldInto(changeset: Changeset, element: Element): Promise<StagedChange | null> {\n    const ids = new Set(elementIdentifiers(element, this.context.elementId));\n    const own = (changeset.changes as StagedChange[]).filter(\n      (c) => !c.type.startsWith(\"relationship-\") && ids.has(c.elementId)\n    );\n    if (own.length !== 1 || own[0].type !== \"add\" || !own[0].after) return null;\n    const baseLayer = await this.context.model.getBaseLayer(this.context.layerName);\n    if ([...ids].some((id) => baseLayer?.getElement(id))) return null;\n    return own[0];\n  }\n\n  /**\n   * Compute before and after states\n   *\n   * For add: before is undefined, after is the new element state\n   * For update: before is original state, after is modified state\n   * For delete: before is original state, after is undefined\n   */\n  async computeStates(element: Element): Promise<void> {\n    this.context.element = element;\n    this.context.before = element.toJSON() as unknown as Record<string, unknown>;\n    this.context.after = { ...this.context.before };\n  }\n\n  /**\n   * Execute mutation for add operation\n   */\n  async executeAdd(\n    element: Element,\n    mutator: (elem: Element) => void | Promise<void>\n  ): Promise<void> {\n    // For add, before is undefined, after is the new element\n    this.context.element = element;\n    this.context.before = undefined;\n\n    // Check if we're in staging mode\n    const activeChangeset = await this.stagingManager.getActive();\n    if (activeChangeset && activeChangeset.status === \"staged\") {\n      // Staging path: capture after state and stage\n      this.context.after = element.toJSON() as unknown as Record<string, unknown>;\n\n      await this.stagingManager.stage(activeChangeset.id, {\n        type: \"add\",\n        elementId: this.context.elementId,\n        layerName: this.context.layerName,\n        after: this.context.after,\n        timestamp: new Date().toISOString(),\n      });\n      return;\n    }\n\n    // Base model path: add element and persist\n    await mutator(element);\n    this.context.after = element.toJSON() as unknown as Record<string, unknown>;\n\n    // Persist to base model\n    await this._persistChanges(\"add\");\n  }\n\n  /**\n   * Execute mutation for update operation\n   */\n  async executeUpdate(\n    element: Element,\n    mutator: (elem: Element, after: Record<string, unknown>) => Promise<void>\n  ): Promise<void> {\n    // Compute before and after states\n    this.context.element = element;\n    this.context.before = element.toJSON() as unknown as Record<string, unknown>;\n    this.context.after = { ...this.context.before };\n\n    // Check if we're in staging mode\n    const activeChangeset = await this.stagingManager.getActive();\n    if (activeChangeset && activeChangeset.status === \"staged\") {\n      // Staging path: apply mutations to after state, then stage\n      await mutator(element, this.context.after);\n      this.changedFields = changedFields(this.context.before, this.context.after);\n\n      // An element this changeset adds: rewrite the add's snapshot rather than stacking an update.\n      const add = await this.stagedAddToFoldInto(activeChangeset, element);\n      if (add) {\n        await this.stagingManager.restage(activeChangeset.id, add.elementId, {\n          type: \"add\",\n          elementId: add.elementId,\n          layerName: add.layerName,\n          ...(add.before !== undefined ? { before: add.before } : {}),\n          after: foldIntoSnapshot(add.after!, this.context.before, this.context.after),\n          timestamp: new Date().toISOString(),\n        });\n        this.foldedIntoAdd = true;\n        return;\n      }\n\n      await this.stagingManager.stage(activeChangeset.id, {\n        type: \"update\",\n        elementId: this.context.elementId,\n        layerName: this.context.layerName,\n        before: this.context.before,\n        after: this.context.after,\n        timestamp: new Date().toISOString(),\n      });\n      return;\n    }\n\n    // Base model path: apply mutations atomically\n    await this._executeBasePath(mutator);\n  }\n\n  /**\n   * Execute mutation for delete operation\n   */\n  async executeDelete(element: Element): Promise<void> {\n    // For delete, before is the current state, after is undefined\n    this.context.element = element;\n    this.context.before = element.toJSON() as unknown as Record<string, unknown>;\n    this.context.after = undefined;\n\n    // Every identifier relationships.yaml may use for this element: UUID id, dotted\n    // path, and whatever the caller addressed it by.\n    const identifiers = elementIdentifiers(element, this.context.elementId);\n\n    // Check if we're in staging mode\n    const activeChangeset = await this.stagingManager.getActive();\n    if (activeChangeset && activeChangeset.status === \"staged\") {\n      // Staging path: stage the deletion, then stage the removal of every\n      // relationship that names the element so the commit leaves no dangling rows\n      // (and so commit validation does not reject the changeset for them).\n      await this.stagingManager.stage(activeChangeset.id, {\n        type: \"delete\",\n        elementId: this.context.elementId,\n        layerName: this.context.layerName,\n        before: this.context.before,\n        timestamp: new Date().toISOString(),\n      });\n\n      const ids = new Set(identifiers);\n      // A cascade delete stages one handler per element; a row between two deleted\n      // elements must not be staged for removal twice.\n      const alreadyStaged = new Set(\n        activeChangeset.changes\n          .filter((change) => change.type === \"relationship-delete\")\n          .map((change) => change.elementId)\n      );\n      const dangling = this.context.model.relationships\n        .getAll()\n        .filter((rel) => ids.has(rel.source) || ids.has(rel.target))\n        .filter((rel) => !alreadyStaged.has(`${rel.source}::${rel.predicate}::${rel.target}`));\n      for (const rel of dangling) {\n        alreadyStaged.add(`${rel.source}::${rel.predicate}::${rel.target}`);\n        await this.stagingManager.stage(activeChangeset.id, {\n          type: \"relationship-delete\",\n          elementId: `${rel.source}::${rel.predicate}::${rel.target}`,\n          layerName: rel.layer,\n          before: {\n            source: rel.source,\n            target: rel.target,\n            predicate: rel.predicate,\n            layer: rel.layer,\n            ...(rel.targetLayer ? { targetLayer: rel.targetLayer } : {}),\n            ...(rel.properties ? { properties: rel.properties } : {}),\n          },\n          timestamp: new Date().toISOString(),\n        });\n      }\n      return;\n    }\n\n    // Base model path: delete from model\n    const layer = (await this.context.model.getLayer(this.context.layerName))!;\n    const deleted = layer.deleteElement(element.path || element.id);\n\n    if (!deleted) {\n      throw new CLIError(`Failed to delete element ${this.context.elementId}`, 1, [\n        \"Element may have already been deleted\",\n      ]);\n    }\n\n    // Delete relationships that name the element by UUID or by path\n    this.context.model.relationships.deleteForElement(identifiers);\n\n    // Track and save atomically\n    await this._persistChanges(\"delete\");\n  }\n\n  /**\n   * Execute all registered steps and persist\n   */\n  async execute(\n    mutator: (elem: Element, after: Record<string, unknown>) => Promise<void>,\n    type: \"add\" | \"update\" | \"delete\"\n  ): Promise<void> {\n    if (!this.context.element) {\n      throw new CLIError(\"Element not set on MutationHandler\", 1);\n    }\n\n    // Check if we're in staging mode\n    const activeChangeset = await this.stagingManager.getActive();\n    if (activeChangeset && activeChangeset.status === \"staged\") {\n      // Staging path: build after state and stage\n      if (this.context.before === undefined && type !== \"add\") {\n        this.context.before = this.context.element.toJSON() as unknown as Record<string, unknown>;\n      }\n\n      this.context.after =\n        type === \"delete\"\n          ? undefined\n          : {\n              ...(this.context.before ||\n                (this.context.element.toJSON() as unknown as Record<string, unknown>)),\n            };\n\n      if (type !== \"delete\" && this.context.after) {\n        await mutator(this.context.element, this.context.after);\n      }\n\n      await this.stagingManager.stage(activeChangeset.id, {\n        type,\n        elementId: this.context.elementId,\n        layerName: this.context.layerName,\n        ...(this.context.before !== undefined && { before: this.context.before }),\n        ...(this.context.after !== undefined && { after: this.context.after }),\n        timestamp: new Date().toISOString(),\n      });\n      return;\n    }\n\n    // Base model path: execute and persist atomically\n    await this._executeBasePath(mutator, type);\n  }\n\n  /**\n   * Base model path: execute mutations and persist atomically\n   */\n  private async _executeBasePath(\n    mutator: (elem: Element, after: Record<string, unknown>) => Promise<void>,\n    type?: string\n  ): Promise<void> {\n    if (!this.context.element) {\n      throw new CLIError(\"Element not set\", 1);\n    }\n\n    // Initialize before state if not already set\n    if (this.context.before === undefined) {\n      this.context.before = this.context.element.toJSON() as unknown as Record<string, unknown>;\n    }\n\n    // Initialize after state if not already set\n    if (this.context.after === undefined) {\n      this.context.after = { ...this.context.before };\n    }\n\n    // Apply mutations to element AND after state together\n    // This ensures they stay in sync\n    await mutator(this.context.element, this.context.after);\n    this.changedFields = changedFields(this.context.before, this.context.after);\n\n    // Persist changes to disk\n    await this._persistChanges(type);\n  }\n\n  /**\n   * Persist changes to disk\n   *\n   * Performs sequential writes to layer, relationships, and manifest files.\n   * If any write fails, subsequent writes are skipped via error propagation.\n   * Note: Not truly atomic\u2014if a write succeeds then a later write fails,\n   * earlier writes remain on disk. Use within transaction-like contexts only.\n   */\n  private async _persistChanges(type?: string): Promise<void> {\n    try {\n      // Save layer\n      await this.context.model.saveLayer(this.context.layerName);\n\n      // Save relationships if modified (for deletes)\n      if (type === \"delete\" && this.context.model.relationships.isDirty()) {\n        await this.context.model.saveRelationships();\n      }\n\n      // Save manifest\n      await this.context.model.saveManifest();\n    } catch (error) {\n      // A changeset-only refusal is not a disk failure: keep it recognisable for callers.\n      if (error instanceof ChangesetOnlyError) throw error;\n      throw new CLIError(\n        `Failed to persist changes: ${getErrorMessage(error)}`,\n        1,\n        [\"Check that the model directory is writable\", \"Verify the model is not corrupted\"]\n      );\n    }\n\n    // Post-persist: regenerate affected layer reports (non-blocking, FR-4)\n    // This is a separate try/catch from the above to ensure report failures never cause mutations to fail\n    try {\n      const orchestrator = new ModelReportOrchestrator(\n        this.context.model,\n        this.context.model.rootPath\n      );\n      if (isValidLayerName(this.context.layerName)) {\n        const affected = orchestrator.computeAffectedLayers(this.context.layerName);\n        await orchestrator.regenerate(affected);\n      } else {\n        emitLog(SeverityNumber.WARN, \"Report regeneration skipped: invalid layer name\", {\n          \"layer.name\": this.context.layerName,\n          \"elementId\": this.context.elementId,\n        });\n      }\n    } catch (error) {\n      emitLog(SeverityNumber.WARN, \"Failed to update layer reports after mutation\", {\n        \"error\": getErrorMessage(error),\n        \"layer.name\": this.context.layerName,\n        \"elementId\": this.context.elementId,\n      });\n    }\n  }\n}\n"],
+  "mappings": "AAYA,SAAS,0BAA0B;AACnC,SAAS,0BAA0B;AACnC,SAAS,wBAAwB;AACjC,SAAS,gBAAgB;AACzB,SAAS,0BAA0B;AACnC,SAAS,uBAAuB;AAChC,SAAS,+BAA+B;AACxC,SAAS,SAAS,sBAAsB;AAExC,SAAS,qBAAqB;AAOxB,SAAU,iBACd,UACA,QACA,OAA0C;AAE1C,QAAM,SAAS,EAAE,GAAG,SAAQ,GACtB,IAAI,UAAU,CAAA,GACd,IAAI,SAAS,CAAA;AACnB,aAAW,OAAO,oBAAI,IAAI,CAAC,GAAG,OAAO,KAAK,CAAC,GAAG,GAAG,OAAO,KAAK,CAAC,CAAC,CAAC;AAC9D,IAAI,KAAK,UAAU,EAAE,GAAG,CAAC,MAAM,KAAK,UAAU,EAAE,GAAG,CAAC,MAChD,EAAE,GAAG,MAAM,SACb,OAAO,OAAO,GAAG,IAEjB,OAAO,GAAG,IAAI,EAAE,GAAG;AAKvB,SAAI,sBAAsB,KAAK,KAAK,UAAU,EAAE,gBAAgB,MAAM,KAAK,UAAU,EAAE,gBAAgB,KACrG,OAAO,OAAO,iBAET;AACT;AA6BM,MAAO,gBAAe;EAClB;EACA,QAAwB,CAAA;EACxB;EACA,gBAA0B,CAAA;EAC1B,gBAAgB;EAExB,YAAY,OAAc,WAAmB,WAAiB;AAC5D,SAAK,UAAU,EAAE,OAAO,WAAW,UAAS,GAC5C,KAAK,iBAAiB,IAAI,mBAAmB,MAAM,UAAU,KAAK;EACpE;;;;EAKA,WAAW,SAAgB;AACzB,gBAAK,QAAQ,UAAU,SAChB;EACT;;;;EAKA,QAAQ,MAAkB;AACxB,gBAAK,MAAM,KAAK,IAAI,GACb;EACT;;;;EAKA,iBAAc;AACZ,WAAO,KAAK,QAAQ;EACtB;;;;EAKA,gBAAa;AACX,WAAO,KAAK,QAAQ;EACtB;;;;EAKA,oBAAiB;AACf,WAAO,KAAK;EACd;;;;;EAMA,mBAAgB;AACd,WAAO,KAAK;EACd;;EAGA,mBAAgB;AACd,WAAO,KAAK;EACd;;;;;;;EAQQ,MAAM,oBAAoB,WAAsB,SAAgB;AACtE,UAAM,MAAM,IAAI,IAAI,mBAAmB,SAAS,KAAK,QAAQ,SAAS,CAAC,GACjE,MAAO,UAAU,QAA2B,OAChD,CAAC,MAAM,CAAC,EAAE,KAAK,WAAW,eAAe,KAAK,IAAI,IAAI,EAAE,SAAS,CAAC;AAEpE,QAAI,IAAI,WAAW,KAAK,IAAI,CAAC,EAAE,SAAS,SAAS,CAAC,IAAI,CAAC,EAAE;AAAO,aAAO;AACvE,UAAM,YAAY,MAAM,KAAK,QAAQ,MAAM,aAAa,KAAK,QAAQ,SAAS;AAC9E,WAAI,CAAC,GAAG,GAAG,EAAE,KAAK,CAAC,OAAO,WAAW,WAAW,EAAE,CAAC,IAAU,OACtD,IAAI,CAAC;EACd;;;;;;;;EASA,MAAM,cAAc,SAAgB;AAClC,SAAK,QAAQ,UAAU,SACvB,KAAK,QAAQ,SAAS,QAAQ,OAAM,GACpC,KAAK,QAAQ,QAAQ,EAAE,GAAG,KAAK,QAAQ,OAAM;EAC/C;;;;EAKA,MAAM,WACJ,SACA,SAAgD;AAGhD,SAAK,QAAQ,UAAU,SACvB,KAAK,QAAQ,SAAS;AAGtB,UAAM,kBAAkB,MAAM,KAAK,eAAe,UAAS;AAC3D,QAAI,mBAAmB,gBAAgB,WAAW,UAAU;AAE1D,WAAK,QAAQ,QAAQ,QAAQ,OAAM,GAEnC,MAAM,KAAK,eAAe,MAAM,gBAAgB,IAAI;QAClD,MAAM;QACN,WAAW,KAAK,QAAQ;QACxB,WAAW,KAAK,QAAQ;QACxB,OAAO,KAAK,QAAQ;QACpB,YAAW,oBAAI,KAAI,GAAG,YAAW;OAClC;AACD;IACF;AAGA,UAAM,QAAQ,OAAO,GACrB,KAAK,QAAQ,QAAQ,QAAQ,OAAM,GAGnC,MAAM,KAAK,gBAAgB,KAAK;EAClC;;;;EAKA,MAAM,cACJ,SACA,SAAyE;AAGzE,SAAK,QAAQ,UAAU,SACvB,KAAK,QAAQ,SAAS,QAAQ,OAAM,GACpC,KAAK,QAAQ,QAAQ,EAAE,GAAG,KAAK,QAAQ,OAAM;AAG7C,UAAM,kBAAkB,MAAM,KAAK,eAAe,UAAS;AAC3D,QAAI,mBAAmB,gBAAgB,WAAW,UAAU;AAE1D,YAAM,QAAQ,SAAS,KAAK,QAAQ,KAAK,GACzC,KAAK,gBAAgB,cAAc,KAAK,QAAQ,QAAQ,KAAK,QAAQ,KAAK;AAG1E,YAAM,MAAM,MAAM,KAAK,oBAAoB,iBAAiB,OAAO;AACnE,UAAI,KAAK;AACP,cAAM,KAAK,eAAe,QAAQ,gBAAgB,IAAI,IAAI,WAAW;UACnE,MAAM;UACN,WAAW,IAAI;UACf,WAAW,IAAI;UACf,GAAI,IAAI,WAAW,SAAY,EAAE,QAAQ,IAAI,OAAM,IAAK,CAAA;UACxD,OAAO,iBAAiB,IAAI,OAAQ,KAAK,QAAQ,QAAQ,KAAK,QAAQ,KAAK;UAC3E,YAAW,oBAAI,KAAI,GAAG,YAAW;SAClC,GACD,KAAK,gBAAgB;AACrB;MACF;AAEA,YAAM,KAAK,eAAe,MAAM,gBAAgB,IAAI;QAClD,MAAM;QACN,WAAW,KAAK,QAAQ;QACxB,WAAW,KAAK,QAAQ;QACxB,QAAQ,KAAK,QAAQ;QACrB,OAAO,KAAK,QAAQ;QACpB,YAAW,oBAAI,KAAI,GAAG,YAAW;OAClC;AACD;IACF;AAGA,UAAM,KAAK,iBAAiB,OAAO;EACrC;;;;EAKA,MAAM,cAAc,SAAgB;AAElC,SAAK,QAAQ,UAAU,SACvB,KAAK,QAAQ,SAAS,QAAQ,OAAM,GACpC,KAAK,QAAQ,QAAQ;AAIrB,UAAM,cAAc,mBAAmB,SAAS,KAAK,QAAQ,SAAS,GAGhE,kBAAkB,MAAM,KAAK,eAAe,UAAS;AAC3D,QAAI,mBAAmB,gBAAgB,WAAW,UAAU;AAI1D,YAAM,KAAK,eAAe,MAAM,gBAAgB,IAAI;QAClD,MAAM;QACN,WAAW,KAAK,QAAQ;QACxB,WAAW,KAAK,QAAQ;QACxB,QAAQ,KAAK,QAAQ;QACrB,YAAW,oBAAI,KAAI,GAAG,YAAW;OAClC;AAED,YAAM,MAAM,IAAI,IAAI,WAAW,GAGzB,gBAAgB,IAAI,IACxB,gBAAgB,QACb,OAAO,CAAC,WAAW,OAAO,SAAS,qBAAqB,EACxD,IAAI,CAAC,WAAW,OAAO,SAAS,CAAC,GAEhC,WAAW,KAAK,QAAQ,MAAM,cACjC,OAAM,EACN,OAAO,CAAC,QAAQ,IAAI,IAAI,IAAI,MAAM,KAAK,IAAI,IAAI,IAAI,MAAM,CAAC,EAC1D,OAAO,CAAC,QAAQ,CAAC,cAAc,IAAI,GAAG,IAAI,MAAM,KAAK,IAAI,SAAS,KAAK,IAAI,MAAM,EAAE,CAAC;AACvF,iBAAW,OAAO;AAChB,sBAAc,IAAI,GAAG,IAAI,MAAM,KAAK,IAAI,SAAS,KAAK,IAAI,MAAM,EAAE,GAClE,MAAM,KAAK,eAAe,MAAM,gBAAgB,IAAI;UAClD,MAAM;UACN,WAAW,GAAG,IAAI,MAAM,KAAK,IAAI,SAAS,KAAK,IAAI,MAAM;UACzD,WAAW,IAAI;UACf,QAAQ;YACN,QAAQ,IAAI;YACZ,QAAQ,IAAI;YACZ,WAAW,IAAI;YACf,OAAO,IAAI;YACX,GAAI,IAAI,cAAc,EAAE,aAAa,IAAI,YAAW,IAAK,CAAA;YACzD,GAAI,IAAI,aAAa,EAAE,YAAY,IAAI,WAAU,IAAK,CAAA;;UAExD,YAAW,oBAAI,KAAI,GAAG,YAAW;SAClC;AAEH;IACF;AAMA,QAAI,EAHW,MAAM,KAAK,QAAQ,MAAM,SAAS,KAAK,QAAQ,SAAS,GACjD,cAAc,QAAQ,QAAQ,QAAQ,EAAE;AAG5D,YAAM,IAAI,SAAS,4BAA4B,KAAK,QAAQ,SAAS,IAAI,GAAG;QAC1E;OACD;AAIH,SAAK,QAAQ,MAAM,cAAc,iBAAiB,WAAW,GAG7D,MAAM,KAAK,gBAAgB,QAAQ;EACrC;;;;EAKA,MAAM,QACJ,SACA,MAAiC;AAEjC,QAAI,CAAC,KAAK,QAAQ;AAChB,YAAM,IAAI,SAAS,sCAAsC,CAAC;AAI5D,UAAM,kBAAkB,MAAM,KAAK,eAAe,UAAS;AAC3D,QAAI,mBAAmB,gBAAgB,WAAW,UAAU;AAE1D,MAAI,KAAK,QAAQ,WAAW,UAAa,SAAS,UAChD,KAAK,QAAQ,SAAS,KAAK,QAAQ,QAAQ,OAAM,IAGnD,KAAK,QAAQ,QACX,SAAS,WACL,SACA;QACE,GAAI,KAAK,QAAQ,UACd,KAAK,QAAQ,QAAQ,OAAM;SAGlC,SAAS,YAAY,KAAK,QAAQ,SACpC,MAAM,QAAQ,KAAK,QAAQ,SAAS,KAAK,QAAQ,KAAK,GAGxD,MAAM,KAAK,eAAe,MAAM,gBAAgB,IAAI;QAClD;QACA,WAAW,KAAK,QAAQ;QACxB,WAAW,KAAK,QAAQ;QACxB,GAAI,KAAK,QAAQ,WAAW,UAAa,EAAE,QAAQ,KAAK,QAAQ,OAAM;QACtE,GAAI,KAAK,QAAQ,UAAU,UAAa,EAAE,OAAO,KAAK,QAAQ,MAAK;QACnE,YAAW,oBAAI,KAAI,GAAG,YAAW;OAClC;AACD;IACF;AAGA,UAAM,KAAK,iBAAiB,SAAS,IAAI;EAC3C;;;;EAKQ,MAAM,iBACZ,SACA,MAAa;AAEb,QAAI,CAAC,KAAK,QAAQ;AAChB,YAAM,IAAI,SAAS,mBAAmB,CAAC;AAIzC,IAAI,KAAK,QAAQ,WAAW,WAC1B,KAAK,QAAQ,SAAS,KAAK,QAAQ,QAAQ,OAAM,IAI/C,KAAK,QAAQ,UAAU,WACzB,KAAK,QAAQ,QAAQ,EAAE,GAAG,KAAK,QAAQ,OAAM,IAK/C,MAAM,QAAQ,KAAK,QAAQ,SAAS,KAAK,QAAQ,KAAK,GACtD,KAAK,gBAAgB,cAAc,KAAK,QAAQ,QAAQ,KAAK,QAAQ,KAAK,GAG1E,MAAM,KAAK,gBAAgB,IAAI;EACjC;;;;;;;;;EAUQ,MAAM,gBAAgB,MAAa;AACzC,QAAI;AAEF,YAAM,KAAK,QAAQ,MAAM,UAAU,KAAK,QAAQ,SAAS,GAGrD,SAAS,YAAY,KAAK,QAAQ,MAAM,cAAc,QAAO,KAC/D,MAAM,KAAK,QAAQ,MAAM,kBAAiB,GAI5C,MAAM,KAAK,QAAQ,MAAM,aAAY;IACvC,SAAS,OAAO;AAEd,YAAI,iBAAiB,qBAA0B,QACzC,IAAI,SACR,8BAA8B,gBAAgB,KAAK,CAAC,IACpD,GACA,CAAC,8CAA8C,mCAAmC,CAAC;IAEvF;AAIA,QAAI;AACF,YAAM,eAAe,IAAI,wBACvB,KAAK,QAAQ,OACb,KAAK,QAAQ,MAAM,QAAQ;AAE7B,UAAI,iBAAiB,KAAK,QAAQ,SAAS,GAAG;AAC5C,cAAM,WAAW,aAAa,sBAAsB,KAAK,QAAQ,SAAS;AAC1E,cAAM,aAAa,WAAW,QAAQ;MACxC;AACE,gBAAQ,eAAe,MAAM,mDAAmD;UAC9E,cAAc,KAAK,QAAQ;UAC3B,WAAa,KAAK,QAAQ;SAC3B;IAEL,SAAS,OAAO;AACd,cAAQ,eAAe,MAAM,iDAAiD;QAC5E,OAAS,gBAAgB,KAAK;QAC9B,cAAc,KAAK,QAAQ;QAC3B,WAAa,KAAK,QAAQ;OAC3B;IACH;EACF;;",
   "names": []
 }

package/dist/core/project-init.js

@@ -0,0 +1,53 @@
+import { join } from "path";
+import { Model } from "./model.js";
+import { fileExists } from "../utils/file-io.js";
+import { logVerbose as globalLogVerbose, logDebug as globalLogDebug } from "../utils/globals.js";
+import { installSpecReference } from "../utils/spec-installer.js";
+import { getCliBundledSpecVersion } from "../utils/spec-version.js";
+import { getErrorMessage } from "../utils/errors.js";
+import { regenerateLayerReports } from "../commands/reports.js";
+function modelManifestPath(rootPath) {
+  return join(rootPath, "documentation-robotics", "model", "manifest.yaml");
+}
+async function hasModel(rootPath) {
+  return fileExists(modelManifestPath(rootPath));
+}
+async function initProject(rootPath, options) {
+  if (await hasModel(rootPath))
+    throw new Error(`A model already exists in ${rootPath}`);
+  const logVerbose = options.logVerbose ?? globalLogVerbose, logDebug = options.logDebug ?? globalLogDebug, specVersion = getCliBundledSpecVersion(), modelPath = join(rootPath, "documentation-robotics", "model");
+  logDebug(`Creating model directory at ${rootPath}/documentation-robotics/model`);
+  const model = await Model.init(rootPath, {
+    name: options.name,
+    version: "0.1.0",
+    description: options.description || void 0,
+    author: options.author || void 0,
+    specVersion,
+    created: (/* @__PURE__ */ new Date()).toISOString()
+  }, { lazyLoad: !1 });
+  logVerbose(`Model saved with:
+  - Version: 0.1.0
+  - Spec Version: ${specVersion}
+  - Location: ${rootPath}/documentation-robotics/model`), logDebug("Installing spec reference (.dr/ folder)..."), await installSpecReference(rootPath, !1), logVerbose("Spec reference installed");
+  let reportError;
+  logDebug("Generating reports and README...");
+  try {
+    await regenerateLayerReports(rootPath, options.log), logVerbose("Reports and README generated");
+  } catch (error) {
+    reportError = getErrorMessage(error), logDebug(`Report generation failed (non-fatal): ${reportError}`);
+  }
+  return {
+    rootPath,
+    modelPath,
+    name: model.manifest.name,
+    version: "0.1.0",
+    specVersion,
+    ...reportError !== void 0 ? { reportError } : {}
+  };
+}
+export {
+  hasModel,
+  initProject,
+  modelManifestPath
+};
+//# sourceMappingURL=project-init.js.map

package/dist/core/project-init.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/core/project-init.ts"],
+  "sourcesContent": ["/**\n * Project init - creates an empty model at the CLI's spec version in a folder.\n *\n * Shared by `dr init` (which gathers the name and the rest by prompting) and the\n * `project_init` MCP tool (which takes them as arguments). Neither installs per-project\n * integration files: `dr claude install` and the Claude Code plugin do that.\n */\n\nimport { join } from \"path\";\nimport { Model } from \"./model.js\";\nimport { fileExists } from \"../utils/file-io.js\";\nimport { logVerbose as globalLogVerbose, logDebug as globalLogDebug } from \"../utils/globals.js\";\nimport { installSpecReference } from \"../utils/spec-installer.js\";\nimport { getCliBundledSpecVersion } from \"../utils/spec-version.js\";\nimport { getErrorMessage } from \"../utils/errors.js\";\nimport { regenerateLayerReports } from \"../commands/reports.js\";\n\nexport interface ProjectInitOptions {\n  name: string;\n  description?: string;\n  author?: string;\n  /** Where progress lines go; `dr init` prints them, the MCP server must not write stdout. */\n  log?: (message: string) => void;\n  /** Where --verbose lines go (default: stdout when verbose is on). */\n  logVerbose?: (message: string) => void;\n  /** Where --debug lines go (default: console.debug when debug is on). */\n  logDebug?: (message: string) => void;\n}\n\nexport interface ProjectInitResult {\n  rootPath: string;\n  modelPath: string;\n  name: string;\n  version: string;\n  specVersion: string;\n  /** Set when the model was created but its layer reports and README could not be generated. */\n  reportError?: string;\n}\n\n/** The manifest path of the model in a folder (not searching parent folders). */\nexport function modelManifestPath(rootPath: string): string {\n  return join(rootPath, \"documentation-robotics\", \"model\", \"manifest.yaml\");\n}\n\n/** Whether the folder already holds a model. */\nexport async function hasModel(rootPath: string): Promise<boolean> {\n  return fileExists(modelManifestPath(rootPath));\n}\n\n/**\n * Create the model in rootPath, install the spec reference (.dr/) and generate the layer\n * reports and README. Throws when the folder already has a model. A report failure doesn't\n * fail the init: it comes back as reportError.\n */\nexport async function initProject(rootPath: string, options: ProjectInitOptions): Promise<ProjectInitResult> {\n  if (await hasModel(rootPath)) {\n    throw new Error(`A model already exists in ${rootPath}`);\n  }\n\n  const logVerbose = options.logVerbose ?? globalLogVerbose;\n  const logDebug = options.logDebug ?? globalLogDebug;\n  const specVersion = getCliBundledSpecVersion();\n  const modelPath = join(rootPath, \"documentation-robotics\", \"model\");\n\n  logDebug(`Creating model directory at ${rootPath}/documentation-robotics/model`);\n  const model = await Model.init(\n    rootPath,\n    {\n      name: options.name,\n      version: \"0.1.0\",\n      description: options.description || undefined,\n      author: options.author || undefined,\n      specVersion,\n      created: new Date().toISOString(),\n    },\n    { lazyLoad: false }\n  );\n\n  logVerbose(`Model saved with:\n  - Version: 0.1.0\n  - Spec Version: ${specVersion}\n  - Location: ${rootPath}/documentation-robotics/model`);\n\n  logDebug(\"Installing spec reference (.dr/ folder)...\");\n  await installSpecReference(rootPath, false);\n  logVerbose(\"Spec reference installed\");\n\n  let reportError: string | undefined;\n  logDebug(\"Generating reports and README...\");\n  try {\n    await regenerateLayerReports(rootPath, options.log);\n    logVerbose(\"Reports and README generated\");\n  } catch (error) {\n    reportError = getErrorMessage(error);\n    logDebug(`Report generation failed (non-fatal): ${reportError}`);\n  }\n\n  return {\n    rootPath,\n    modelPath,\n    name: model.manifest.name,\n    version: \"0.1.0\",\n    specVersion,\n    ...(reportError !== undefined ? { reportError } : {}),\n  };\n}\n"],
+  "mappings": "AAQA,SAAS,YAAY;AACrB,SAAS,aAAa;AACtB,SAAS,kBAAkB;AAC3B,SAAS,cAAc,kBAAkB,YAAY,sBAAsB;AAC3E,SAAS,4BAA4B;AACrC,SAAS,gCAAgC;AACzC,SAAS,uBAAuB;AAChC,SAAS,8BAA8B;AAyBjC,SAAU,kBAAkB,UAAgB;AAChD,SAAO,KAAK,UAAU,0BAA0B,SAAS,eAAe;AAC1E;AAGA,eAAsB,SAAS,UAAgB;AAC7C,SAAO,WAAW,kBAAkB,QAAQ,CAAC;AAC/C;AAOA,eAAsB,YAAY,UAAkB,SAA2B;AAC7E,MAAI,MAAM,SAAS,QAAQ;AACzB,UAAM,IAAI,MAAM,6BAA6B,QAAQ,EAAE;AAGzD,QAAM,aAAa,QAAQ,cAAc,kBACnC,WAAW,QAAQ,YAAY,gBAC/B,cAAc,yBAAwB,GACtC,YAAY,KAAK,UAAU,0BAA0B,OAAO;AAElE,WAAS,+BAA+B,QAAQ,+BAA+B;AAC/E,QAAM,QAAQ,MAAM,MAAM,KACxB,UACA;IACE,MAAM,QAAQ;IACd,SAAS;IACT,aAAa,QAAQ,eAAe;IACpC,QAAQ,QAAQ,UAAU;IAC1B;IACA,UAAS,oBAAI,KAAI,GAAG,YAAW;KAEjC,EAAE,UAAU,GAAK,CAAE;AAGrB,aAAW;;oBAEO,WAAW;gBACf,QAAQ,+BAA+B,GAErD,SAAS,4CAA4C,GACrD,MAAM,qBAAqB,UAAU,EAAK,GAC1C,WAAW,0BAA0B;AAErC,MAAI;AACJ,WAAS,kCAAkC;AAC3C,MAAI;AACF,UAAM,uBAAuB,UAAU,QAAQ,GAAG,GAClD,WAAW,8BAA8B;EAC3C,SAAS,OAAO;AACd,kBAAc,gBAAgB,KAAK,GACnC,SAAS,yCAAyC,WAAW,EAAE;EACjE;AAEA,SAAO;IACL;IACA;IACA,MAAM,MAAM,SAAS;IACrB,SAAS;IACT;IACA,GAAI,gBAAgB,SAAY,EAAE,YAAW,IAAK,CAAA;;AAEtD;",
+  "names": []
+}