@living-architecture/riviere-cli 0.9.15 → 0.9.17

package/dist/bin.js

@@ -6802,6 +6802,14 @@ var DuplicateDomainError = class extends Error {
     this.domainName = domainName;
   }
 };
+var SourceConflictError = class extends Error {
+  repository;
+  constructor(repository) {
+    super(`Source '${repository}' already exists with different values`);
+    this.name = "SourceConflictError";
+    this.repository = repository;
+  }
+};
 var DomainNotFoundError = class extends Error {
   domainName;
   constructor(domainName) {
@@ -6829,6 +6837,18 @@ var DuplicateComponentError = class extends Error {
     this.componentId = componentId;
   }
 };
+var ComponentTypeMismatchError = class extends Error {
+  componentId;
+  existingType;
+  incomingType;
+  constructor(componentId, existingType, incomingType) {
+    super(`Component '${componentId}' already exists as type '${existingType}'; cannot upsert as '${incomingType}'`);
+    this.name = "ComponentTypeMismatchError";
+    this.componentId = componentId;
+    this.existingType = existingType;
+    this.incomingType = incomingType;
+  }
+};
 var ComponentNotFoundError = class extends Error {
   componentId;
   suggestions;
@@ -7725,17 +7745,250 @@ function validateRequiredProperties(customTypes, customTypeName, metadata) {
   assertRequiredPropertiesProvided(customTypes, customTypeName, metadata);
 }
 
+// ../riviere-builder/dist/platform/domain/collection-utils/deduplicate-strings.js
+function deduplicateStrings(existing, incoming) {
+  const existingSet = new Set(existing);
+  return incoming.filter((item) => !existingSet.has(item));
+}
+
+// ../riviere-builder/dist/features/building/domain/enrichment/merge-behavior.js
+function mergeStringArray(existing, incoming) {
+  const base = existing ?? [];
+  return [...base, ...deduplicateStrings(base, incoming)];
+}
+function mergeBehavior(existing, incoming) {
+  const base = existing ?? {};
+  return {
+    ...base,
+    ...incoming.reads !== void 0 && { reads: mergeStringArray(base.reads, incoming.reads) },
+    ...incoming.validates !== void 0 && { validates: mergeStringArray(base.validates, incoming.validates) },
+    ...incoming.modifies !== void 0 && { modifies: mergeStringArray(base.modifies, incoming.modifies) },
+    ...incoming.emits !== void 0 && { emits: mergeStringArray(base.emits, incoming.emits) }
+  };
+}
+
+// ../riviere-builder/dist/features/building/domain/enrichment/upsert-merge.js
+var IDENTITY_FIELDS = /* @__PURE__ */ new Set(["id", "type", "name", "domain", "module"]);
+var CUSTOM_BASE_FIELDS = /* @__PURE__ */ new Set([
+  "id",
+  "type",
+  "customTypeName",
+  "name",
+  "domain",
+  "module",
+  "description",
+  "sourceLocation"
+]);
+function mergeComponentForUpsert(existing, incoming, options, warnings) {
+  const merged = { ...existing };
+  for (const [field, incomingValue] of Object.entries(incoming)) {
+    if (shouldSkipTopLevelField(field, incomingValue)) {
+      continue;
+    }
+    mergeTopLevelField(merged, existing.id, field, incomingValue, options, warnings);
+  }
+  if (isCustomComponent(existing) && isCustomComponent(incoming)) {
+    const mergedMetadata = mergeCustomMetadata(existing, incoming, options, warnings);
+    for (const [key, value] of Object.entries(mergedMetadata)) {
+      setField(merged, key, value);
+    }
+  }
+  return merged;
+}
+function mergeTopLevelField(target, componentId, field, incomingValue, options, warnings) {
+  if (Array.isArray(incomingValue)) {
+    mergeArrayField(target, field, incomingValue);
+    return;
+  }
+  if (field === "behavior" && isRecord(incomingValue)) {
+    mergeBehaviorField(target, incomingValue);
+    return;
+  }
+  if (isRecord(incomingValue) && shouldRecursivelyMergeTopLevelObject(field)) {
+    const existingValue = getField(target, field);
+    const existingRecord = isRecord(existingValue) ? existingValue : void 0;
+    setField(target, field, mergeNestedObject(existingRecord, incomingValue, options, warnings, componentId, field));
+    return;
+  }
+  mergeScalarLikeField(target, field, incomingValue, options, warnings, componentId);
+}
+function mergeCustomMetadata(existing, incoming, options, warnings) {
+  const existingMetadata = extractCustomMetadata(existing);
+  const incomingMetadata = extractCustomMetadata(incoming);
+  return mergeNestedObject(existingMetadata, incomingMetadata, options, warnings, existing.id, "metadata");
+}
+function extractCustomMetadata(component) {
+  const metadata = {};
+  for (const [key, value] of Object.entries(component)) {
+    if (CUSTOM_BASE_FIELDS.has(key)) {
+      continue;
+    }
+    metadata[key] = value;
+  }
+  return metadata;
+}
+function shouldSkipTopLevelField(field, value) {
+  return IDENTITY_FIELDS.has(field) || !isDefined(value);
+}
+function shouldRecursivelyMergeTopLevelObject(field) {
+  return field !== "sourceLocation" && field !== "signature";
+}
+function mergeArrayField(target, field, incomingValue) {
+  if (incomingValue.length === 0) {
+    return;
+  }
+  const existingValue = getField(target, field);
+  const existingArray = Array.isArray(existingValue) ? existingValue : [];
+  setField(target, field, mergeArrayUnion(existingArray, incomingValue));
+}
+function mergeBehaviorField(target, incomingValue) {
+  const existingValue = getField(target, "behavior");
+  const existingBehavior = toOperationBehavior(existingValue);
+  const incomingBehavior = toOperationBehaviorFromRecord(incomingValue);
+  setField(target, "behavior", mergeBehavior(existingBehavior, incomingBehavior));
+}
+function mergeScalarLikeField(target, field, incomingValue, options, warnings, componentId) {
+  const existingValue = getField(target, field);
+  if (options?.noOverwrite && isDefined(existingValue)) {
+    return;
+  }
+  maybePushScalarOverwriteWarning(warnings, componentId, field, existingValue, incomingValue);
+  setField(target, field, incomingValue);
+}
+function maybePushScalarOverwriteWarning(warnings, componentId, field, existingValue, incomingValue) {
+  if (!isPrimitive(existingValue) || !isPrimitive(incomingValue) || existingValue === incomingValue) {
+    return;
+  }
+  warnings.push({
+    code: "SCALAR_OVERWRITE",
+    message: `Scalar field '${field}' on component '${componentId}' overwritten`,
+    componentId,
+    field,
+    oldValue: existingValue,
+    newValue: incomingValue
+  });
+}
+function mergeNestedObject(existing, incoming, options, warnings, componentId, pathPrefix) {
+  const merged = { ...existing ?? {} };
+  for (const [field, incomingValue] of Object.entries(incoming)) {
+    if (!isDefined(incomingValue)) {
+      continue;
+    }
+    if (Array.isArray(incomingValue)) {
+      mergeArrayField(merged, field, incomingValue);
+      continue;
+    }
+    if (isRecord(incomingValue)) {
+      const existingValue = merged[field];
+      const existingRecord = isRecord(existingValue) ? existingValue : void 0;
+      merged[field] = mergeNestedObject(existingRecord, incomingValue, options, warnings, componentId, `${pathPrefix}.${field}`);
+      continue;
+    }
+    if (options?.noOverwrite && isDefined(merged[field])) {
+      continue;
+    }
+    maybePushScalarOverwriteWarning(warnings, componentId, `${pathPrefix}.${field}`, merged[field], incomingValue);
+    merged[field] = incomingValue;
+  }
+  return merged;
+}
+function toOperationBehavior(value) {
+  if (!isRecord(value)) {
+    return void 0;
+  }
+  return toOperationBehaviorFromRecord(value);
+}
+function toOperationBehaviorFromRecord(value) {
+  const behavior = {};
+  const reads = toStringArray(value["reads"]);
+  if (reads !== void 0) {
+    behavior.reads = reads;
+  }
+  const validates = toStringArray(value["validates"]);
+  if (validates !== void 0) {
+    behavior.validates = validates;
+  }
+  const modifies = toStringArray(value["modifies"]);
+  if (modifies !== void 0) {
+    behavior.modifies = modifies;
+  }
+  const emits = toStringArray(value["emits"]);
+  if (emits !== void 0) {
+    behavior.emits = emits;
+  }
+  return behavior;
+}
+function toStringArray(value) {
+  if (!Array.isArray(value)) {
+    return void 0;
+  }
+  return value.filter(isString);
+}
+function mergeArrayUnion(existing, incoming) {
+  const merged = [...existing];
+  const seen = new Set(existing.map((item) => toStableKey(item)));
+  for (const item of incoming) {
+    const key = toStableKey(item);
+    if (seen.has(key)) {
+      continue;
+    }
+    seen.add(key);
+    merged.push(item);
+  }
+  return merged;
+}
+function getField(target, field) {
+  return Reflect.get(target, field);
+}
+function setField(target, field, value) {
+  Reflect.set(target, field, value);
+}
+function toStableKey(value) {
+  if (isPrimitive(value)) {
+    return `${typeof value}:${String(value)}`;
+  }
+  return `json:${JSON.stringify(value)}`;
+}
+function isDefined(value) {
+  return value !== void 0 && value !== null;
+}
+function isPrimitive(value) {
+  return typeof value === "string" || typeof value === "number" || typeof value === "boolean";
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isString(value) {
+  return typeof value === "string";
+}
+function isCustomComponent(component) {
+  return component.type === "Custom";
+}
+
 // ../riviere-builder/dist/features/building/domain/construction/graph-construction.js
 var GraphConstruction = class {
   graph;
-  constructor(graph) {
+  operationWarnings;
+  constructor(graph, operationWarnings) {
     this.graph = graph;
+    this.operationWarnings = operationWarnings;
   }
   addSource(source) {
+    const existing = this.graph.metadata.sources.find((item) => item.repository === source.repository);
+    if (existing) {
+      if (areSourcesEqual(existing, source)) {
+        return;
+      }
+      throw new SourceConflictError(source.repository);
+    }
     this.graph.metadata.sources.push(source);
   }
   addDomain(input) {
-    if (this.graph.metadata.domains[input.name]) {
+    const existing = this.graph.metadata.domains[input.name];
+    if (existing) {
+      if (existing.description === input.description && existing.systemType === input.systemType) {
+        return;
+      }
       throw new DuplicateDomainError(input.name);
     }
     this.graph.metadata.domains[input.name] = {
@@ -7744,9 +7997,62 @@ var GraphConstruction = class {
     };
   }
   addUI(input) {
+    return this.registerComponent(this.buildUIComponent(input));
+  }
+  upsertUI(input, options) {
+    return this.upsertTypedComponent(this.buildUIComponent(input), options);
+  }
+  addApi(input) {
+    return this.registerComponent(this.buildAPIComponent(input));
+  }
+  upsertApi(input, options) {
+    return this.upsertTypedComponent(this.buildAPIComponent(input), options);
+  }
+  addUseCase(input) {
+    return this.registerComponent(this.buildUseCaseComponent(input));
+  }
+  upsertUseCase(input, options) {
+    return this.upsertTypedComponent(this.buildUseCaseComponent(input), options);
+  }
+  addDomainOp(input) {
+    return this.registerComponent(this.buildDomainOpComponent(input));
+  }
+  upsertDomainOp(input, options) {
+    return this.upsertTypedComponent(this.buildDomainOpComponent(input), options);
+  }
+  addEvent(input) {
+    return this.registerComponent(this.buildEventComponent(input));
+  }
+  upsertEvent(input, options) {
+    return this.upsertTypedComponent(this.buildEventComponent(input), options);
+  }
+  addEventHandler(input) {
+    return this.registerComponent(this.buildEventHandlerComponent(input));
+  }
+  upsertEventHandler(input, options) {
+    return this.upsertTypedComponent(this.buildEventHandlerComponent(input), options);
+  }
+  defineCustomType(input) {
+    const customTypes = this.graph.metadata.customTypes;
+    if (customTypes[input.name]) {
+      throw new CustomTypeAlreadyDefinedError(input.name);
+    }
+    customTypes[input.name] = {
+      ...input.requiredProperties !== void 0 && { requiredProperties: input.requiredProperties },
+      ...input.optionalProperties !== void 0 && { optionalProperties: input.optionalProperties },
+      ...input.description !== void 0 && { description: input.description }
+    };
+  }
+  addCustom(input) {
+    return this.registerComponent(this.buildCustomComponent(input));
+  }
+  upsertCustom(input, options) {
+    return this.upsertTypedComponent(this.buildCustomComponent(input), options);
+  }
+  buildUIComponent(input) {
     validateDomainExists(this.graph.metadata.domains, input.domain);
     const id = generateComponentId(input.domain, input.module, "ui", input.name);
-    const component = {
+    return {
       id,
       type: "UI",
       name: input.name,
@@ -7756,12 +8062,11 @@ var GraphConstruction = class {
       sourceLocation: input.sourceLocation,
       ...input.description !== void 0 && { description: input.description }
     };
-    return this.registerComponent(component);
   }
-  addApi(input) {
+  buildAPIComponent(input) {
     validateDomainExists(this.graph.metadata.domains, input.domain);
     const id = generateComponentId(input.domain, input.module, "api", input.name);
-    const component = {
+    return {
       id,
       type: "API",
       name: input.name,
@@ -7774,12 +8079,11 @@ var GraphConstruction = class {
       ...input.operationName !== void 0 && { operationName: input.operationName },
       ...input.description !== void 0 && { description: input.description }
     };
-    return this.registerComponent(component);
   }
-  addUseCase(input) {
+  buildUseCaseComponent(input) {
     validateDomainExists(this.graph.metadata.domains, input.domain);
     const id = generateComponentId(input.domain, input.module, "usecase", input.name);
-    const component = {
+    return {
       id,
       type: "UseCase",
       name: input.name,
@@ -7788,12 +8092,11 @@ var GraphConstruction = class {
       sourceLocation: input.sourceLocation,
       ...input.description !== void 0 && { description: input.description }
     };
-    return this.registerComponent(component);
   }
-  addDomainOp(input) {
+  buildDomainOpComponent(input) {
     validateDomainExists(this.graph.metadata.domains, input.domain);
     const id = generateComponentId(input.domain, input.module, "domainop", input.name);
-    const component = {
+    return {
       id,
       type: "DomainOp",
       name: input.name,
@@ -7808,12 +8111,11 @@ var GraphConstruction = class {
       ...input.businessRules !== void 0 && { businessRules: input.businessRules },
       ...input.description !== void 0 && { description: input.description }
     };
-    return this.registerComponent(component);
   }
-  addEvent(input) {
+  buildEventComponent(input) {
     validateDomainExists(this.graph.metadata.domains, input.domain);
     const id = generateComponentId(input.domain, input.module, "event", input.name);
-    const component = {
+    return {
       id,
       type: "Event",
       name: input.name,
@@ -7824,12 +8126,11 @@ var GraphConstruction = class {
       ...input.eventSchema !== void 0 && { eventSchema: input.eventSchema },
       ...input.description !== void 0 && { description: input.description }
     };
-    return this.registerComponent(component);
   }
-  addEventHandler(input) {
+  buildEventHandlerComponent(input) {
     validateDomainExists(this.graph.metadata.domains, input.domain);
     const id = generateComponentId(input.domain, input.module, "eventhandler", input.name);
-    const component = {
+    return {
       id,
       type: "EventHandler",
       name: input.name,
@@ -7839,20 +8140,8 @@ var GraphConstruction = class {
       sourceLocation: input.sourceLocation,
       ...input.description !== void 0 && { description: input.description }
     };
-    return this.registerComponent(component);
-  }
-  defineCustomType(input) {
-    const customTypes = this.graph.metadata.customTypes;
-    if (customTypes[input.name]) {
-      throw new CustomTypeAlreadyDefinedError(input.name);
-    }
-    customTypes[input.name] = {
-      ...input.requiredProperties !== void 0 && { requiredProperties: input.requiredProperties },
-      ...input.optionalProperties !== void 0 && { optionalProperties: input.optionalProperties },
-      ...input.description !== void 0 && { description: input.description }
-    };
   }
-  addCustom(input) {
+  buildCustomComponent(input) {
     validateDomainExists(this.graph.metadata.domains, input.domain);
     validateCustomType(this.graph.metadata.customTypes, input.customTypeName);
     validateRequiredProperties(this.graph.metadata.customTypes, input.customTypeName, input.metadata);
@@ -7868,7 +8157,7 @@ var GraphConstruction = class {
       ...input.description !== void 0 && { description: input.description },
       ...input.metadata
     };
-    return this.registerComponent(component);
+    return component;
   }
   registerComponent(component) {
     if (this.graph.components.some((c) => c.id === component.id)) {
@@ -7877,7 +8166,33 @@ var GraphConstruction = class {
     this.graph.components.push(component);
     return component;
   }
+  upsertTypedComponent(incoming, options) {
+    const existingIndex = this.graph.components.findIndex((component) => component.id === incoming.id);
+    if (existingIndex === -1) {
+      this.graph.components.push(incoming);
+      return {
+        component: incoming,
+        created: true
+      };
+    }
+    const existing = this.graph.components[existingIndex];
+    if (!isSameTypeComponent(existing, incoming)) {
+      throw new ComponentTypeMismatchError(incoming.id, existing?.type ?? "unknown", incoming.type);
+    }
+    const merged = mergeComponentForUpsert(existing, incoming, options, this.operationWarnings);
+    this.graph.components[existingIndex] = merged;
+    return {
+      component: merged,
+      created: false
+    };
+  }
 };
+function areSourcesEqual(existing, incoming) {
+  return existing.repository === incoming.repository && existing.commit === incoming.commit && existing.extractedAt === incoming.extractedAt;
+}
+function isSameTypeComponent(existing, incoming) {
+  return existing?.type === incoming.type;
+}
 
 // ../riviere-builder/dist/features/building/domain/enrichment/enrichment-errors.js
 var InvalidEnrichmentTargetError = class extends Error {
@@ -7896,28 +8211,6 @@ function deduplicateStateTransitions(existing, incoming) {
   return incoming.filter((item) => !existing.some((e) => e.from === item.from && e.to === item.to && e.trigger === item.trigger));
 }
 
-// ../riviere-builder/dist/platform/domain/collection-utils/deduplicate-strings.js
-function deduplicateStrings(existing, incoming) {
-  const existingSet = new Set(existing);
-  return incoming.filter((item) => !existingSet.has(item));
-}
-
-// ../riviere-builder/dist/features/building/domain/enrichment/merge-behavior.js
-function mergeStringArray(existing, incoming) {
-  const base = existing ?? [];
-  return [...base, ...deduplicateStrings(base, incoming)];
-}
-function mergeBehavior(existing, incoming) {
-  const base = existing ?? {};
-  return {
-    ...base,
-    ...incoming.reads !== void 0 && { reads: mergeStringArray(base.reads, incoming.reads) },
-    ...incoming.validates !== void 0 && { validates: mergeStringArray(base.validates, incoming.validates) },
-    ...incoming.modifies !== void 0 && { modifies: mergeStringArray(base.modifies, incoming.modifies) },
-    ...incoming.emits !== void 0 && { emits: mergeStringArray(base.emits, incoming.emits) }
-  };
-}
-
 // ../riviere-builder/dist/features/building/domain/enrichment/graph-enrichment.js
 var GraphEnrichment = class {
   graph;
@@ -7957,14 +8250,27 @@ var GraphEnrichment = class {
 // ../riviere-builder/dist/features/building/domain/linking/graph-linking.js
 var GraphLinking = class {
   graph;
-  constructor(graph) {
+  operationWarnings;
+  constructor(graph, operationWarnings) {
     this.graph = graph;
+    this.operationWarnings = operationWarnings;
   }
   link(input) {
     const sourceExists = this.graph.components.some((c) => c.id === input.from);
     if (!sourceExists) {
       throw createComponentNotFoundError(this.graph.components, input.from);
     }
+    const duplicate = this.graph.links.find((link2) => link2.source === input.from && link2.target === input.to && link2.type === input.type);
+    if (duplicate) {
+      this.operationWarnings.push({
+        code: "DUPLICATE_LINK_SKIPPED",
+        message: `Duplicate link '${input.from}' -> '${input.to}' (${input.type ?? "unspecified"}) skipped`,
+        source: input.from,
+        target: input.to,
+        ...input.type !== void 0 && { linkType: input.type }
+      });
+      return duplicate;
+    }
     const link = {
       source: input.from,
       target: input.to,
@@ -7978,6 +8284,19 @@ var GraphLinking = class {
     if (!sourceExists) {
       throw createComponentNotFoundError(this.graph.components, input.from);
     }
+    const duplicate = this.graph.externalLinks.find((link) => link.source === input.from && link.target.repository === input.target.repository && link.target.name === input.target.name && link.type === input.type);
+    if (duplicate) {
+      this.operationWarnings.push({
+        code: "DUPLICATE_LINK_SKIPPED",
+        message: `Duplicate external link '${input.from}' -> '${input.target.name}' (${input.type ?? "unspecified"}) skipped`,
+        source: input.from,
+        target: input.target.name,
+        ...input.type !== void 0 && { linkType: input.type },
+        ...input.target.repository !== void 0 && { targetRepository: input.target.repository },
+        targetName: input.target.name
+      });
+      return duplicate;
+    }
     const externalLink = {
       source: input.from,
       target: input.target,
@@ -22354,7 +22673,7 @@ function buildEventHandlerInfo(handler, eventByName) {
 }
 
 // ../riviere-query/dist/features/querying/queries/graph-validation.js
-function isCustomComponent(component) {
+function isCustomComponent2(component) {
   return component.type === "Custom";
 }
 function validateGraph(graph) {
@@ -22386,7 +22705,7 @@ function validateCustomTypes(graph) {
   const errors = [];
   const customTypes = graph.metadata.customTypes;
   graph.components.forEach((component, index) => {
-    if (!isCustomComponent(component)) {
+    if (!isCustomComponent2(component)) {
       return;
     }
     const customTypeName = component.customTypeName;
@@ -23138,11 +23457,13 @@ function validateGraph2(graph) {
 // ../riviere-builder/dist/features/building/domain/inspection/graph-inspection.js
 var GraphInspection = class {
   graph;
-  constructor(graph) {
+  operationWarnings;
+  constructor(graph, operationWarnings) {
     this.graph = graph;
+    this.operationWarnings = operationWarnings;
   }
   warnings() {
-    return findWarnings(this.graph);
+    return [...findWarnings(this.graph), ...this.operationWarnings];
   }
   stats() {
     return calculateStats(this.graph);
@@ -23181,10 +23502,11 @@ var RiviereBuilder = class _RiviereBuilder {
   constructor(graph, graphPath) {
     this.graph = graph;
     this.graphPath = graphPath;
-    this.construction = new GraphConstruction(graph);
+    const operationWarnings = [];
+    this.construction = new GraphConstruction(graph, operationWarnings);
     this.enrichment = new GraphEnrichment(graph);
-    this.linking = new GraphLinking(graph);
-    this.inspection = new GraphInspection(graph);
+    this.linking = new GraphLinking(graph, operationWarnings);
+    this.inspection = new GraphInspection(graph, operationWarnings);
     this.errorRecovery = new NearMatch(graph);
   }
   static resume(graph, graphPath = "") {
@@ -23292,6 +23614,9 @@ var RiviereBuilder2 = class _RiviereBuilder {
   addUI(input) {
     return this.delegate.construction.addUI(input);
   }
+  upsertUI(input, options) {
+    return this.delegate.construction.upsertUI(input, options);
+  }
   /**
    * Adds an API component to the graph.
    *
@@ -23301,6 +23626,9 @@ var RiviereBuilder2 = class _RiviereBuilder {
   addApi(input) {
     return this.delegate.construction.addApi(input);
   }
+  upsertApi(input, options) {
+    return this.delegate.construction.upsertApi(input, options);
+  }
   /**
    * Adds a UseCase component to the graph.
    *
@@ -23310,6 +23638,9 @@ var RiviereBuilder2 = class _RiviereBuilder {
   addUseCase(input) {
     return this.delegate.construction.addUseCase(input);
   }
+  upsertUseCase(input, options) {
+    return this.delegate.construction.upsertUseCase(input, options);
+  }
   /**
    * Adds a DomainOp component to the graph.
    *
@@ -23319,6 +23650,9 @@ var RiviereBuilder2 = class _RiviereBuilder {
   addDomainOp(input) {
     return this.delegate.construction.addDomainOp(input);
   }
+  upsertDomainOp(input, options) {
+    return this.delegate.construction.upsertDomainOp(input, options);
+  }
   /**
    * Adds an Event component to the graph.
    *
@@ -23328,6 +23662,9 @@ var RiviereBuilder2 = class _RiviereBuilder {
   addEvent(input) {
     return this.delegate.construction.addEvent(input);
   }
+  upsertEvent(input, options) {
+    return this.delegate.construction.upsertEvent(input, options);
+  }
   /**
    * Adds an EventHandler component to the graph.
    *
@@ -23337,6 +23674,9 @@ var RiviereBuilder2 = class _RiviereBuilder {
   addEventHandler(input) {
     return this.delegate.construction.addEventHandler(input);
   }
+  upsertEventHandler(input, options) {
+    return this.delegate.construction.upsertEventHandler(input, options);
+  }
   /**
    * Defines a custom component type for the graph.
    *
@@ -23354,6 +23694,9 @@ var RiviereBuilder2 = class _RiviereBuilder {
   addCustom(input) {
     return this.delegate.construction.addCustom(input);
   }
+  upsertCustom(input, options) {
+    return this.delegate.construction.upsertCustom(input, options);
+  }
   /**
    * Enriches a DomainOp component with additional domain details.
    *
@@ -31325,7 +31668,7 @@ function parsePackageJson(pkg) {
 }
 function loadPackageJson() {
   if (true) {
-    return { version: "0.9.14" };
+    return { version: "0.9.16" };
   }
   const require2 = createRequire2(import.meta.url);
   return parsePackageJson(require2("../../package.json"));

package/dist/index.js

@@ -6801,6 +6801,14 @@ var DuplicateDomainError = class extends Error {
     this.domainName = domainName;
   }
 };
+var SourceConflictError = class extends Error {
+  repository;
+  constructor(repository) {
+    super(`Source '${repository}' already exists with different values`);
+    this.name = "SourceConflictError";
+    this.repository = repository;
+  }
+};
 var DomainNotFoundError = class extends Error {
   domainName;
   constructor(domainName) {
@@ -6828,6 +6836,18 @@ var DuplicateComponentError = class extends Error {
     this.componentId = componentId;
   }
 };
+var ComponentTypeMismatchError = class extends Error {
+  componentId;
+  existingType;
+  incomingType;
+  constructor(componentId, existingType, incomingType) {
+    super(`Component '${componentId}' already exists as type '${existingType}'; cannot upsert as '${incomingType}'`);
+    this.name = "ComponentTypeMismatchError";
+    this.componentId = componentId;
+    this.existingType = existingType;
+    this.incomingType = incomingType;
+  }
+};
 var ComponentNotFoundError = class extends Error {
   componentId;
   suggestions;
@@ -7724,17 +7744,250 @@ function validateRequiredProperties(customTypes, customTypeName, metadata) {
   assertRequiredPropertiesProvided(customTypes, customTypeName, metadata);
 }
 
+// ../riviere-builder/dist/platform/domain/collection-utils/deduplicate-strings.js
+function deduplicateStrings(existing, incoming) {
+  const existingSet = new Set(existing);
+  return incoming.filter((item) => !existingSet.has(item));
+}
+
+// ../riviere-builder/dist/features/building/domain/enrichment/merge-behavior.js
+function mergeStringArray(existing, incoming) {
+  const base = existing ?? [];
+  return [...base, ...deduplicateStrings(base, incoming)];
+}
+function mergeBehavior(existing, incoming) {
+  const base = existing ?? {};
+  return {
+    ...base,
+    ...incoming.reads !== void 0 && { reads: mergeStringArray(base.reads, incoming.reads) },
+    ...incoming.validates !== void 0 && { validates: mergeStringArray(base.validates, incoming.validates) },
+    ...incoming.modifies !== void 0 && { modifies: mergeStringArray(base.modifies, incoming.modifies) },
+    ...incoming.emits !== void 0 && { emits: mergeStringArray(base.emits, incoming.emits) }
+  };
+}
+
+// ../riviere-builder/dist/features/building/domain/enrichment/upsert-merge.js
+var IDENTITY_FIELDS = /* @__PURE__ */ new Set(["id", "type", "name", "domain", "module"]);
+var CUSTOM_BASE_FIELDS = /* @__PURE__ */ new Set([
+  "id",
+  "type",
+  "customTypeName",
+  "name",
+  "domain",
+  "module",
+  "description",
+  "sourceLocation"
+]);
+function mergeComponentForUpsert(existing, incoming, options, warnings) {
+  const merged = { ...existing };
+  for (const [field, incomingValue] of Object.entries(incoming)) {
+    if (shouldSkipTopLevelField(field, incomingValue)) {
+      continue;
+    }
+    mergeTopLevelField(merged, existing.id, field, incomingValue, options, warnings);
+  }
+  if (isCustomComponent(existing) && isCustomComponent(incoming)) {
+    const mergedMetadata = mergeCustomMetadata(existing, incoming, options, warnings);
+    for (const [key, value] of Object.entries(mergedMetadata)) {
+      setField(merged, key, value);
+    }
+  }
+  return merged;
+}
+function mergeTopLevelField(target, componentId, field, incomingValue, options, warnings) {
+  if (Array.isArray(incomingValue)) {
+    mergeArrayField(target, field, incomingValue);
+    return;
+  }
+  if (field === "behavior" && isRecord(incomingValue)) {
+    mergeBehaviorField(target, incomingValue);
+    return;
+  }
+  if (isRecord(incomingValue) && shouldRecursivelyMergeTopLevelObject(field)) {
+    const existingValue = getField(target, field);
+    const existingRecord = isRecord(existingValue) ? existingValue : void 0;
+    setField(target, field, mergeNestedObject(existingRecord, incomingValue, options, warnings, componentId, field));
+    return;
+  }
+  mergeScalarLikeField(target, field, incomingValue, options, warnings, componentId);
+}
+function mergeCustomMetadata(existing, incoming, options, warnings) {
+  const existingMetadata = extractCustomMetadata(existing);
+  const incomingMetadata = extractCustomMetadata(incoming);
+  return mergeNestedObject(existingMetadata, incomingMetadata, options, warnings, existing.id, "metadata");
+}
+function extractCustomMetadata(component) {
+  const metadata = {};
+  for (const [key, value] of Object.entries(component)) {
+    if (CUSTOM_BASE_FIELDS.has(key)) {
+      continue;
+    }
+    metadata[key] = value;
+  }
+  return metadata;
+}
+function shouldSkipTopLevelField(field, value) {
+  return IDENTITY_FIELDS.has(field) || !isDefined(value);
+}
+function shouldRecursivelyMergeTopLevelObject(field) {
+  return field !== "sourceLocation" && field !== "signature";
+}
+function mergeArrayField(target, field, incomingValue) {
+  if (incomingValue.length === 0) {
+    return;
+  }
+  const existingValue = getField(target, field);
+  const existingArray = Array.isArray(existingValue) ? existingValue : [];
+  setField(target, field, mergeArrayUnion(existingArray, incomingValue));
+}
+function mergeBehaviorField(target, incomingValue) {
+  const existingValue = getField(target, "behavior");
+  const existingBehavior = toOperationBehavior(existingValue);
+  const incomingBehavior = toOperationBehaviorFromRecord(incomingValue);
+  setField(target, "behavior", mergeBehavior(existingBehavior, incomingBehavior));
+}
+function mergeScalarLikeField(target, field, incomingValue, options, warnings, componentId) {
+  const existingValue = getField(target, field);
+  if (options?.noOverwrite && isDefined(existingValue)) {
+    return;
+  }
+  maybePushScalarOverwriteWarning(warnings, componentId, field, existingValue, incomingValue);
+  setField(target, field, incomingValue);
+}
+function maybePushScalarOverwriteWarning(warnings, componentId, field, existingValue, incomingValue) {
+  if (!isPrimitive(existingValue) || !isPrimitive(incomingValue) || existingValue === incomingValue) {
+    return;
+  }
+  warnings.push({
+    code: "SCALAR_OVERWRITE",
+    message: `Scalar field '${field}' on component '${componentId}' overwritten`,
+    componentId,
+    field,
+    oldValue: existingValue,
+    newValue: incomingValue
+  });
+}
+function mergeNestedObject(existing, incoming, options, warnings, componentId, pathPrefix) {
+  const merged = { ...existing ?? {} };
+  for (const [field, incomingValue] of Object.entries(incoming)) {
+    if (!isDefined(incomingValue)) {
+      continue;
+    }
+    if (Array.isArray(incomingValue)) {
+      mergeArrayField(merged, field, incomingValue);
+      continue;
+    }
+    if (isRecord(incomingValue)) {
+      const existingValue = merged[field];
+      const existingRecord = isRecord(existingValue) ? existingValue : void 0;
+      merged[field] = mergeNestedObject(existingRecord, incomingValue, options, warnings, componentId, `${pathPrefix}.${field}`);
+      continue;
+    }
+    if (options?.noOverwrite && isDefined(merged[field])) {
+      continue;
+    }
+    maybePushScalarOverwriteWarning(warnings, componentId, `${pathPrefix}.${field}`, merged[field], incomingValue);
+    merged[field] = incomingValue;
+  }
+  return merged;
+}
+function toOperationBehavior(value) {
+  if (!isRecord(value)) {
+    return void 0;
+  }
+  return toOperationBehaviorFromRecord(value);
+}
+function toOperationBehaviorFromRecord(value) {
+  const behavior = {};
+  const reads = toStringArray(value["reads"]);
+  if (reads !== void 0) {
+    behavior.reads = reads;
+  }
+  const validates = toStringArray(value["validates"]);
+  if (validates !== void 0) {
+    behavior.validates = validates;
+  }
+  const modifies = toStringArray(value["modifies"]);
+  if (modifies !== void 0) {
+    behavior.modifies = modifies;
+  }
+  const emits = toStringArray(value["emits"]);
+  if (emits !== void 0) {
+    behavior.emits = emits;
+  }
+  return behavior;
+}
+function toStringArray(value) {
+  if (!Array.isArray(value)) {
+    return void 0;
+  }
+  return value.filter(isString);
+}
+function mergeArrayUnion(existing, incoming) {
+  const merged = [...existing];
+  const seen = new Set(existing.map((item) => toStableKey(item)));
+  for (const item of incoming) {
+    const key = toStableKey(item);
+    if (seen.has(key)) {
+      continue;
+    }
+    seen.add(key);
+    merged.push(item);
+  }
+  return merged;
+}
+function getField(target, field) {
+  return Reflect.get(target, field);
+}
+function setField(target, field, value) {
+  Reflect.set(target, field, value);
+}
+function toStableKey(value) {
+  if (isPrimitive(value)) {
+    return `${typeof value}:${String(value)}`;
+  }
+  return `json:${JSON.stringify(value)}`;
+}
+function isDefined(value) {
+  return value !== void 0 && value !== null;
+}
+function isPrimitive(value) {
+  return typeof value === "string" || typeof value === "number" || typeof value === "boolean";
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isString(value) {
+  return typeof value === "string";
+}
+function isCustomComponent(component) {
+  return component.type === "Custom";
+}
+
 // ../riviere-builder/dist/features/building/domain/construction/graph-construction.js
 var GraphConstruction = class {
   graph;
-  constructor(graph) {
+  operationWarnings;
+  constructor(graph, operationWarnings) {
     this.graph = graph;
+    this.operationWarnings = operationWarnings;
   }
   addSource(source) {
+    const existing = this.graph.metadata.sources.find((item) => item.repository === source.repository);
+    if (existing) {
+      if (areSourcesEqual(existing, source)) {
+        return;
+      }
+      throw new SourceConflictError(source.repository);
+    }
     this.graph.metadata.sources.push(source);
   }
   addDomain(input) {
-    if (this.graph.metadata.domains[input.name]) {
+    const existing = this.graph.metadata.domains[input.name];
+    if (existing) {
+      if (existing.description === input.description && existing.systemType === input.systemType) {
+        return;
+      }
       throw new DuplicateDomainError(input.name);
     }
     this.graph.metadata.domains[input.name] = {
@@ -7743,9 +7996,62 @@ var GraphConstruction = class {
     };
   }
   addUI(input) {
+    return this.registerComponent(this.buildUIComponent(input));
+  }
+  upsertUI(input, options) {
+    return this.upsertTypedComponent(this.buildUIComponent(input), options);
+  }
+  addApi(input) {
+    return this.registerComponent(this.buildAPIComponent(input));
+  }
+  upsertApi(input, options) {
+    return this.upsertTypedComponent(this.buildAPIComponent(input), options);
+  }
+  addUseCase(input) {
+    return this.registerComponent(this.buildUseCaseComponent(input));
+  }
+  upsertUseCase(input, options) {
+    return this.upsertTypedComponent(this.buildUseCaseComponent(input), options);
+  }
+  addDomainOp(input) {
+    return this.registerComponent(this.buildDomainOpComponent(input));
+  }
+  upsertDomainOp(input, options) {
+    return this.upsertTypedComponent(this.buildDomainOpComponent(input), options);
+  }
+  addEvent(input) {
+    return this.registerComponent(this.buildEventComponent(input));
+  }
+  upsertEvent(input, options) {
+    return this.upsertTypedComponent(this.buildEventComponent(input), options);
+  }
+  addEventHandler(input) {
+    return this.registerComponent(this.buildEventHandlerComponent(input));
+  }
+  upsertEventHandler(input, options) {
+    return this.upsertTypedComponent(this.buildEventHandlerComponent(input), options);
+  }
+  defineCustomType(input) {
+    const customTypes = this.graph.metadata.customTypes;
+    if (customTypes[input.name]) {
+      throw new CustomTypeAlreadyDefinedError(input.name);
+    }
+    customTypes[input.name] = {
+      ...input.requiredProperties !== void 0 && { requiredProperties: input.requiredProperties },
+      ...input.optionalProperties !== void 0 && { optionalProperties: input.optionalProperties },
+      ...input.description !== void 0 && { description: input.description }
+    };
+  }
+  addCustom(input) {
+    return this.registerComponent(this.buildCustomComponent(input));
+  }
+  upsertCustom(input, options) {
+    return this.upsertTypedComponent(this.buildCustomComponent(input), options);
+  }
+  buildUIComponent(input) {
     validateDomainExists(this.graph.metadata.domains, input.domain);
     const id = generateComponentId(input.domain, input.module, "ui", input.name);
-    const component = {
+    return {
       id,
       type: "UI",
       name: input.name,
@@ -7755,12 +8061,11 @@ var GraphConstruction = class {
       sourceLocation: input.sourceLocation,
       ...input.description !== void 0 && { description: input.description }
     };
-    return this.registerComponent(component);
   }
-  addApi(input) {
+  buildAPIComponent(input) {
     validateDomainExists(this.graph.metadata.domains, input.domain);
     const id = generateComponentId(input.domain, input.module, "api", input.name);
-    const component = {
+    return {
       id,
       type: "API",
       name: input.name,
@@ -7773,12 +8078,11 @@ var GraphConstruction = class {
       ...input.operationName !== void 0 && { operationName: input.operationName },
       ...input.description !== void 0 && { description: input.description }
     };
-    return this.registerComponent(component);
   }
-  addUseCase(input) {
+  buildUseCaseComponent(input) {
     validateDomainExists(this.graph.metadata.domains, input.domain);
     const id = generateComponentId(input.domain, input.module, "usecase", input.name);
-    const component = {
+    return {
       id,
       type: "UseCase",
       name: input.name,
@@ -7787,12 +8091,11 @@ var GraphConstruction = class {
       sourceLocation: input.sourceLocation,
       ...input.description !== void 0 && { description: input.description }
     };
-    return this.registerComponent(component);
   }
-  addDomainOp(input) {
+  buildDomainOpComponent(input) {
     validateDomainExists(this.graph.metadata.domains, input.domain);
     const id = generateComponentId(input.domain, input.module, "domainop", input.name);
-    const component = {
+    return {
       id,
       type: "DomainOp",
       name: input.name,
@@ -7807,12 +8110,11 @@ var GraphConstruction = class {
       ...input.businessRules !== void 0 && { businessRules: input.businessRules },
       ...input.description !== void 0 && { description: input.description }
     };
-    return this.registerComponent(component);
   }
-  addEvent(input) {
+  buildEventComponent(input) {
     validateDomainExists(this.graph.metadata.domains, input.domain);
     const id = generateComponentId(input.domain, input.module, "event", input.name);
-    const component = {
+    return {
       id,
       type: "Event",
       name: input.name,
@@ -7823,12 +8125,11 @@ var GraphConstruction = class {
       ...input.eventSchema !== void 0 && { eventSchema: input.eventSchema },
       ...input.description !== void 0 && { description: input.description }
     };
-    return this.registerComponent(component);
   }
-  addEventHandler(input) {
+  buildEventHandlerComponent(input) {
     validateDomainExists(this.graph.metadata.domains, input.domain);
     const id = generateComponentId(input.domain, input.module, "eventhandler", input.name);
-    const component = {
+    return {
       id,
       type: "EventHandler",
       name: input.name,
@@ -7838,20 +8139,8 @@ var GraphConstruction = class {
       sourceLocation: input.sourceLocation,
       ...input.description !== void 0 && { description: input.description }
     };
-    return this.registerComponent(component);
-  }
-  defineCustomType(input) {
-    const customTypes = this.graph.metadata.customTypes;
-    if (customTypes[input.name]) {
-      throw new CustomTypeAlreadyDefinedError(input.name);
-    }
-    customTypes[input.name] = {
-      ...input.requiredProperties !== void 0 && { requiredProperties: input.requiredProperties },
-      ...input.optionalProperties !== void 0 && { optionalProperties: input.optionalProperties },
-      ...input.description !== void 0 && { description: input.description }
-    };
   }
-  addCustom(input) {
+  buildCustomComponent(input) {
     validateDomainExists(this.graph.metadata.domains, input.domain);
     validateCustomType(this.graph.metadata.customTypes, input.customTypeName);
     validateRequiredProperties(this.graph.metadata.customTypes, input.customTypeName, input.metadata);
@@ -7867,7 +8156,7 @@ var GraphConstruction = class {
       ...input.description !== void 0 && { description: input.description },
       ...input.metadata
     };
-    return this.registerComponent(component);
+    return component;
   }
   registerComponent(component) {
     if (this.graph.components.some((c) => c.id === component.id)) {
@@ -7876,7 +8165,33 @@ var GraphConstruction = class {
     this.graph.components.push(component);
     return component;
   }
+  upsertTypedComponent(incoming, options) {
+    const existingIndex = this.graph.components.findIndex((component) => component.id === incoming.id);
+    if (existingIndex === -1) {
+      this.graph.components.push(incoming);
+      return {
+        component: incoming,
+        created: true
+      };
+    }
+    const existing = this.graph.components[existingIndex];
+    if (!isSameTypeComponent(existing, incoming)) {
+      throw new ComponentTypeMismatchError(incoming.id, existing?.type ?? "unknown", incoming.type);
+    }
+    const merged = mergeComponentForUpsert(existing, incoming, options, this.operationWarnings);
+    this.graph.components[existingIndex] = merged;
+    return {
+      component: merged,
+      created: false
+    };
+  }
 };
+function areSourcesEqual(existing, incoming) {
+  return existing.repository === incoming.repository && existing.commit === incoming.commit && existing.extractedAt === incoming.extractedAt;
+}
+function isSameTypeComponent(existing, incoming) {
+  return existing?.type === incoming.type;
+}
 
 // ../riviere-builder/dist/features/building/domain/enrichment/enrichment-errors.js
 var InvalidEnrichmentTargetError = class extends Error {
@@ -7895,28 +8210,6 @@ function deduplicateStateTransitions(existing, incoming) {
   return incoming.filter((item) => !existing.some((e) => e.from === item.from && e.to === item.to && e.trigger === item.trigger));
 }
 
-// ../riviere-builder/dist/platform/domain/collection-utils/deduplicate-strings.js
-function deduplicateStrings(existing, incoming) {
-  const existingSet = new Set(existing);
-  return incoming.filter((item) => !existingSet.has(item));
-}
-
-// ../riviere-builder/dist/features/building/domain/enrichment/merge-behavior.js
-function mergeStringArray(existing, incoming) {
-  const base = existing ?? [];
-  return [...base, ...deduplicateStrings(base, incoming)];
-}
-function mergeBehavior(existing, incoming) {
-  const base = existing ?? {};
-  return {
-    ...base,
-    ...incoming.reads !== void 0 && { reads: mergeStringArray(base.reads, incoming.reads) },
-    ...incoming.validates !== void 0 && { validates: mergeStringArray(base.validates, incoming.validates) },
-    ...incoming.modifies !== void 0 && { modifies: mergeStringArray(base.modifies, incoming.modifies) },
-    ...incoming.emits !== void 0 && { emits: mergeStringArray(base.emits, incoming.emits) }
-  };
-}
-
 // ../riviere-builder/dist/features/building/domain/enrichment/graph-enrichment.js
 var GraphEnrichment = class {
   graph;
@@ -7956,14 +8249,27 @@ var GraphEnrichment = class {
 // ../riviere-builder/dist/features/building/domain/linking/graph-linking.js
 var GraphLinking = class {
   graph;
-  constructor(graph) {
+  operationWarnings;
+  constructor(graph, operationWarnings) {
     this.graph = graph;
+    this.operationWarnings = operationWarnings;
   }
   link(input) {
     const sourceExists = this.graph.components.some((c) => c.id === input.from);
     if (!sourceExists) {
       throw createComponentNotFoundError(this.graph.components, input.from);
     }
+    const duplicate = this.graph.links.find((link2) => link2.source === input.from && link2.target === input.to && link2.type === input.type);
+    if (duplicate) {
+      this.operationWarnings.push({
+        code: "DUPLICATE_LINK_SKIPPED",
+        message: `Duplicate link '${input.from}' -> '${input.to}' (${input.type ?? "unspecified"}) skipped`,
+        source: input.from,
+        target: input.to,
+        ...input.type !== void 0 && { linkType: input.type }
+      });
+      return duplicate;
+    }
     const link = {
       source: input.from,
       target: input.to,
@@ -7977,6 +8283,19 @@ var GraphLinking = class {
     if (!sourceExists) {
       throw createComponentNotFoundError(this.graph.components, input.from);
     }
+    const duplicate = this.graph.externalLinks.find((link) => link.source === input.from && link.target.repository === input.target.repository && link.target.name === input.target.name && link.type === input.type);
+    if (duplicate) {
+      this.operationWarnings.push({
+        code: "DUPLICATE_LINK_SKIPPED",
+        message: `Duplicate external link '${input.from}' -> '${input.target.name}' (${input.type ?? "unspecified"}) skipped`,
+        source: input.from,
+        target: input.target.name,
+        ...input.type !== void 0 && { linkType: input.type },
+        ...input.target.repository !== void 0 && { targetRepository: input.target.repository },
+        targetName: input.target.name
+      });
+      return duplicate;
+    }
     const externalLink = {
       source: input.from,
       target: input.target,
@@ -22353,7 +22672,7 @@ function buildEventHandlerInfo(handler, eventByName) {
 }
 
 // ../riviere-query/dist/features/querying/queries/graph-validation.js
-function isCustomComponent(component) {
+function isCustomComponent2(component) {
   return component.type === "Custom";
 }
 function validateGraph(graph) {
@@ -22385,7 +22704,7 @@ function validateCustomTypes(graph) {
   const errors = [];
   const customTypes = graph.metadata.customTypes;
   graph.components.forEach((component, index) => {
-    if (!isCustomComponent(component)) {
+    if (!isCustomComponent2(component)) {
       return;
     }
     const customTypeName = component.customTypeName;
@@ -23137,11 +23456,13 @@ function validateGraph2(graph) {
 // ../riviere-builder/dist/features/building/domain/inspection/graph-inspection.js
 var GraphInspection = class {
   graph;
-  constructor(graph) {
+  operationWarnings;
+  constructor(graph, operationWarnings) {
     this.graph = graph;
+    this.operationWarnings = operationWarnings;
   }
   warnings() {
-    return findWarnings(this.graph);
+    return [...findWarnings(this.graph), ...this.operationWarnings];
   }
   stats() {
     return calculateStats(this.graph);
@@ -23180,10 +23501,11 @@ var RiviereBuilder = class _RiviereBuilder {
   constructor(graph, graphPath) {
     this.graph = graph;
     this.graphPath = graphPath;
-    this.construction = new GraphConstruction(graph);
+    const operationWarnings = [];
+    this.construction = new GraphConstruction(graph, operationWarnings);
     this.enrichment = new GraphEnrichment(graph);
-    this.linking = new GraphLinking(graph);
-    this.inspection = new GraphInspection(graph);
+    this.linking = new GraphLinking(graph, operationWarnings);
+    this.inspection = new GraphInspection(graph, operationWarnings);
     this.errorRecovery = new NearMatch(graph);
   }
   static resume(graph, graphPath = "") {
@@ -23291,6 +23613,9 @@ var RiviereBuilder2 = class _RiviereBuilder {
   addUI(input) {
     return this.delegate.construction.addUI(input);
   }
+  upsertUI(input, options) {
+    return this.delegate.construction.upsertUI(input, options);
+  }
   /**
    * Adds an API component to the graph.
    *
@@ -23300,6 +23625,9 @@ var RiviereBuilder2 = class _RiviereBuilder {
   addApi(input) {
     return this.delegate.construction.addApi(input);
   }
+  upsertApi(input, options) {
+    return this.delegate.construction.upsertApi(input, options);
+  }
   /**
    * Adds a UseCase component to the graph.
    *
@@ -23309,6 +23637,9 @@ var RiviereBuilder2 = class _RiviereBuilder {
   addUseCase(input) {
     return this.delegate.construction.addUseCase(input);
   }
+  upsertUseCase(input, options) {
+    return this.delegate.construction.upsertUseCase(input, options);
+  }
   /**
    * Adds a DomainOp component to the graph.
    *
@@ -23318,6 +23649,9 @@ var RiviereBuilder2 = class _RiviereBuilder {
   addDomainOp(input) {
     return this.delegate.construction.addDomainOp(input);
   }
+  upsertDomainOp(input, options) {
+    return this.delegate.construction.upsertDomainOp(input, options);
+  }
   /**
    * Adds an Event component to the graph.
    *
@@ -23327,6 +23661,9 @@ var RiviereBuilder2 = class _RiviereBuilder {
   addEvent(input) {
     return this.delegate.construction.addEvent(input);
   }
+  upsertEvent(input, options) {
+    return this.delegate.construction.upsertEvent(input, options);
+  }
   /**
    * Adds an EventHandler component to the graph.
    *
@@ -23336,6 +23673,9 @@ var RiviereBuilder2 = class _RiviereBuilder {
   addEventHandler(input) {
     return this.delegate.construction.addEventHandler(input);
   }
+  upsertEventHandler(input, options) {
+    return this.delegate.construction.upsertEventHandler(input, options);
+  }
   /**
    * Defines a custom component type for the graph.
    *
@@ -23353,6 +23693,9 @@ var RiviereBuilder2 = class _RiviereBuilder {
   addCustom(input) {
     return this.delegate.construction.addCustom(input);
   }
+  upsertCustom(input, options) {
+    return this.delegate.construction.upsertCustom(input, options);
+  }
   /**
    * Enriches a DomainOp component with additional domain details.
    *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@living-architecture/riviere-cli",
-  "version": "0.9.15",
+  "version": "0.9.17",
   "publishConfig": {
     "access": "public"
   },
@@ -32,10 +32,10 @@
     "glob": "^11.0.2",
     "ts-morph": "^24.0.0",
     "yaml": "^2.7.0",
-    "@living-architecture/riviere-extract-config": "0.5.11",
-    "@living-architecture/riviere-extract-ts": "0.4.14",
-    "@living-architecture/riviere-schema": "0.6.11",
-    "@living-architecture/riviere-query": "0.6.11",
-    "@living-architecture/riviere-builder": "0.7.11"
+    "@living-architecture/riviere-builder": "0.8.0",
+    "@living-architecture/riviere-extract-config": "0.5.12",
+    "@living-architecture/riviere-extract-ts": "0.4.15",
+    "@living-architecture/riviere-query": "0.6.12",
+    "@living-architecture/riviere-schema": "0.6.12"
   }
 }