@living-architecture/riviere-builder 0.7.12 → 0.8.0

package/dist/features/building/domain/builder-facade.d.ts

@@ -1,11 +1,11 @@
 import type { APIComponent, CustomComponent, DomainOpComponent, EventComponent, EventHandlerComponent, ExternalLink, Link, RiviereGraph, SourceInfo, UIComponent, UseCaseComponent } from '@living-architecture/riviere-schema';
 import type { ValidationResult } from '@living-architecture/riviere-query';
-import type { APIInput, BuilderOptions, CustomInput, CustomTypeInput, DomainInput, DomainOpInput, EventHandlerInput, EventInput, UIInput, UseCaseInput } from './construction/construction-types';
+import type { APIInput, BuilderOptions, CustomInput, CustomTypeInput, DomainInput, DomainOpInput, EventHandlerInput, EventInput, UpsertOptions, UIInput, UseCaseInput } from './construction/construction-types';
 import type { EnrichmentInput } from './enrichment/enrichment-types';
 import type { NearMatchMismatch, NearMatchOptions, NearMatchQuery, NearMatchResult } from './error-recovery/match-types';
 import type { BuilderStats, BuilderWarning } from './inspection/inspection-types';
 import type { ExternalLinkInput, LinkInput } from './linking/linking-types';
-export type { APIInput, BuilderOptions, BuilderStats, BuilderWarning, CustomInput, CustomTypeInput, DomainInput, DomainOpInput, EnrichmentInput, EventHandlerInput, EventInput, ExternalLinkInput, LinkInput, NearMatchMismatch, NearMatchOptions, NearMatchQuery, NearMatchResult, UIInput, UseCaseInput, };
+export type { APIInput, BuilderOptions, BuilderStats, BuilderWarning, CustomInput, CustomTypeInput, DomainInput, DomainOpInput, EnrichmentInput, EventHandlerInput, EventInput, ExternalLinkInput, LinkInput, NearMatchMismatch, NearMatchOptions, NearMatchQuery, NearMatchResult, UpsertOptions, UIInput, UseCaseInput, };
 /**
  * Programmatically construct Riviere architecture graphs.
  *
@@ -53,6 +53,10 @@ export declare class RiviereBuilder {
      * @returns The created UI component
      */
     addUI(input: UIInput): UIComponent;
+    upsertUI(input: UIInput, options?: UpsertOptions): {
+        component: UIComponent;
+        created: boolean;
+    };
     /**
      * Adds an API component to the graph.
      *
@@ -60,6 +64,10 @@ export declare class RiviereBuilder {
      * @returns The created API component
      */
     addApi(input: APIInput): APIComponent;
+    upsertApi(input: APIInput, options?: UpsertOptions): {
+        component: APIComponent;
+        created: boolean;
+    };
     /**
      * Adds a UseCase component to the graph.
      *
@@ -67,6 +75,10 @@ export declare class RiviereBuilder {
      * @returns The created UseCase component
      */
     addUseCase(input: UseCaseInput): UseCaseComponent;
+    upsertUseCase(input: UseCaseInput, options?: UpsertOptions): {
+        component: UseCaseComponent;
+        created: boolean;
+    };
     /**
      * Adds a DomainOp component to the graph.
      *
@@ -74,6 +86,10 @@ export declare class RiviereBuilder {
      * @returns The created DomainOp component
      */
     addDomainOp(input: DomainOpInput): DomainOpComponent;
+    upsertDomainOp(input: DomainOpInput, options?: UpsertOptions): {
+        component: DomainOpComponent;
+        created: boolean;
+    };
     /**
      * Adds an Event component to the graph.
      *
@@ -81,6 +97,10 @@ export declare class RiviereBuilder {
      * @returns The created Event component
      */
     addEvent(input: EventInput): EventComponent;
+    upsertEvent(input: EventInput, options?: UpsertOptions): {
+        component: EventComponent;
+        created: boolean;
+    };
     /**
      * Adds an EventHandler component to the graph.
      *
@@ -88,6 +108,10 @@ export declare class RiviereBuilder {
      * @returns The created EventHandler component
      */
     addEventHandler(input: EventHandlerInput): EventHandlerComponent;
+    upsertEventHandler(input: EventHandlerInput, options?: UpsertOptions): {
+        component: EventHandlerComponent;
+        created: boolean;
+    };
     /**
      * Defines a custom component type for the graph.
      *
@@ -101,6 +125,10 @@ export declare class RiviereBuilder {
      * @returns The created Custom component
      */
     addCustom(input: CustomInput): CustomComponent;
+    upsertCustom(input: CustomInput, options?: UpsertOptions): {
+        component: CustomComponent;
+        created: boolean;
+    };
     /**
      * Enriches a DomainOp component with additional domain details.
      *

package/dist/features/building/domain/builder-facade.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"builder-facade.d.ts","sourceRoot":"","sources":["../../../../src/features/building/domain/builder-facade.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"builder-facade.d.ts","sourceRoot":"","sources":["../../../../src/features/building/domain/builder-facade.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,qBAAqB,EACrB,YAAY,EACZ,IAAI,EACJ,YAAY,EACZ,UAAU,EACV,WAAW,EACX,gBAAgB,EACjB,MAAM,qCAAqC,CAAA;AAC5C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAA;AAE1E,OAAO,KAAK,EACV,QAAQ,EACR,cAAc,EACd,WAAW,EACX,eAAe,EACf,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,UAAU,EACV,aAAa,EACb,OAAO,EACP,YAAY,EACb,MAAM,mCAAmC,CAAA;AAC1C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAA;AACpE,OAAO,KAAK,EACV,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,eAAe,EAChB,MAAM,8BAA8B,CAAA;AACrC,OAAO,KAAK,EACV,YAAY,EAAE,cAAc,EAC7B,MAAM,+BAA+B,CAAA;AACtC,OAAO,KAAK,EACV,iBAAiB,EAAE,SAAS,EAC7B,MAAM,yBAAyB,CAAA;AAEhC,YAAY,EACV,QAAQ,EACR,cAAc,EACd,YAAY,EACZ,cAAc,EACd,WAAW,EACX,eAAe,EACf,WAAW,EACX,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,UAAU,EACV,iBAAiB,EACjB,SAAS,EACT,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,aAAa,EACb,OAAO,EACP,YAAY,GACb,CAAA;AAED;;;;;;;GAOG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;IAExC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAE1B,OAAO;IAKP;;;;;;OAMG;IACH,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,YAAY,EAAE,SAAS,SAAK,GAAG,cAAc;IAIlE;;;;;;OAMG;IACH,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,cAAc,EAAE,SAAS,SAAK,GAAG,cAAc;IAInE;;;;OAIG;IACH,SAAS,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAInC;;;;OAIG;IACH,SAAS,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAInC;;;;;OAKG;IACH,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW;IAIlC,QAAQ,CACN,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,aAAa,GACtB;QACD,SAAS,EAAE,WAAW,CAAA;QACtB,OAAO,EAAE,OAAO,CAAA;KACjB;IAID;;;;;OAKG;IACH,MAAM,CAAC,KAAK,EAAE,QAAQ,GAAG,YAAY;IAIrC,SAAS,CACP,KAAK,EAAE,QAAQ,EACf,OAAO,CAAC,EAAE,aAAa,GACtB;QACD,SAAS,EAAE,YAAY,CAAA;QACvB,OAAO,EAAE,OAAO,CAAA;KACjB;IAID;;;;;OAKG;IACH,UAAU,CAAC,KAAK,EAAE,YAAY,GAAG,gBAAgB;IAIjD,aAAa,CACX,KAAK,EAAE,YAAY,EACnB,OAAO,CAAC,EAAE,aAAa,GACtB;QACD,SAAS,EAAE,gBAAgB,CAAA;QAC3B,OAAO,EAAE,OAAO,CAAA;KACjB;IAID;;;;;OAKG;IACH,WAAW,CAAC,KAAK,EAAE,aAAa,GAAG,iBAAiB;IAIpD,cAAc,CACZ,KAAK,EAAE,aAAa,EACpB,OAAO,CAAC,EAAE,aAAa,GACtB;QACD,SAAS,EAAE,iBAAiB,CAAA;QAC5B,OAAO,EAAE,OAAO,CAAA;KACjB;IAID;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,cAAc;IAI3C,WAAW,CACT,KAAK,EAAE,UAAU,EACjB,OAAO,CAAC,EAAE,aAAa,GACtB;QACD,SAAS,EAAE,cAAc,CAAA;QACzB,OAAO,EAAE,OAAO,CAAA;KACjB;IAID;;;;;OAKG;IACH,eAAe,CAAC,KAAK,EAAE,iBAAiB,GAAG,qBAAqB;IAIhE,kBAAkB,CAChB,KAAK,EAAE,iBAAiB,EACxB,OAAO,CAAC,EAAE,aAAa,GACtB;QACD,SAAS,EAAE,qBAAqB,CAAA;QAChC,OAAO,EAAE,OAAO,CAAA;KACjB;IAID;;;;OAIG;IACH,gBAAgB,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI;IAI9C;;;;;OAKG;IACH,SAAS,CAAC,KAAK,EAAE,WAAW,GAAG,eAAe;IAI9C,YAAY,CACV,KAAK,EAAE,WAAW,EAClB,OAAO,CAAC,EAAE,aAAa,GACtB;QACD,SAAS,EAAE,eAAe,CAAA;QAC1B,OAAO,EAAE,OAAO,CAAA;KACjB;IAID;;;;;OAKG;IACH,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,eAAe,GAAG,IAAI;IAI9D;;;;;;OAMG;IACH,WAAW,CAAC,KAAK,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,eAAe,EAAE;IAIjF;;;;;OAKG;IACH,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAI5B;;;;;OAKG;IACH,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,YAAY;IAIpD;;;;OAIG;IACH,QAAQ,IAAI,cAAc,EAAE;IAI5B;;;;OAIG;IACH,KAAK,IAAI,YAAY;IAIrB;;;;OAIG;IACH,QAAQ,IAAI,gBAAgB;IAI5B;;;;OAIG;IACH,OAAO,IAAI,MAAM,EAAE;IAInB;;;;OAIG;IACH,KAAK,IAAI,OAAO,oCAAoC,EAAE,YAAY;IAIlE;;;;OAIG;IACH,SAAS,IAAI,MAAM;IAInB;;;;OAIG;IACH,KAAK,IAAI,YAAY;CAGtB"}

package/dist/features/building/domain/builder-facade.js

@@ -59,6 +59,9 @@ export 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.
      *
@@ -68,6 +71,9 @@ export 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.
      *
@@ -77,6 +83,9 @@ export 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.
      *
@@ -86,6 +95,9 @@ export 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.
      *
@@ -95,6 +107,9 @@ export 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.
      *
@@ -104,6 +119,9 @@ export 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.
      *
@@ -121,6 +139,9 @@ export 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/dist/features/building/domain/construction/construction-errors.d.ts

@@ -4,6 +4,11 @@ export declare class DuplicateDomainError extends Error {
     constructor(domainName: string);
 }
 /** @riviere-role domain-error */
+export declare class SourceConflictError extends Error {
+    readonly repository: string;
+    constructor(repository: string);
+}
+/** @riviere-role domain-error */
 export declare class DomainNotFoundError extends Error {
     readonly domainName: string;
     constructor(domainName: string);
@@ -20,6 +25,13 @@ export declare class DuplicateComponentError extends Error {
     constructor(componentId: string);
 }
 /** @riviere-role domain-error */
+export declare class ComponentTypeMismatchError extends Error {
+    readonly componentId: string;
+    readonly existingType: string;
+    readonly incomingType: string;
+    constructor(componentId: string, existingType: string, incomingType: string);
+}
+/** @riviere-role domain-error */
 export declare class ComponentNotFoundError extends Error {
     readonly componentId: string;
     readonly suggestions: string[];

package/dist/features/building/domain/construction/construction-errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"construction-errors.d.ts","sourceRoot":"","sources":["../../../../../src/features/building/domain/construction/construction-errors.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;gBAEf,UAAU,EAAE,MAAM;CAK/B;AAED,iCAAiC;AACjC,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;gBAEf,UAAU,EAAE,MAAM;CAK/B;AAED,iCAAiC;AACjC,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE,CAAA;gBAEnB,cAAc,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE;CAU3D;AAED,iCAAiC;AACjC,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;gBAEhB,WAAW,EAAE,MAAM;CAKhC;AAED,iCAAiC;AACjC,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,CAAA;gBAElB,WAAW,EAAE,MAAM,EAAE,WAAW,GAAE,MAAM,EAAO;CAW5D;AAED,iCAAiC;AACjC,qBAAa,6BAA8B,SAAQ,KAAK;IACtD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;gBAEb,QAAQ,EAAE,MAAM;CAK7B;AAED,iCAAiC;AACjC,qBAAa,8BAA+B,SAAQ,KAAK;IACvD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,CAAA;gBAElB,cAAc,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE;CAM1D;AAED,iCAAiC;AACjC,qBAAa,iBAAkB,SAAQ,KAAK;gBAC9B,MAAM,EAAE,MAAM;CAI3B;AAED,iCAAiC;AACjC,qBAAa,mBAAoB,SAAQ,KAAK;;CAK7C;AAED,iCAAiC;AACjC,qBAAa,mBAAoB,SAAQ,KAAK;;CAK7C;AAED,iCAAiC;AACjC,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,kBAAkB,EAAE,MAAM,EAAE,CAAA;gBAEzB,QAAQ,EAAE,MAAM,EAAE;CAK/B"}
+{"version":3,"file":"construction-errors.d.ts","sourceRoot":"","sources":["../../../../../src/features/building/domain/construction/construction-errors.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;gBAEf,UAAU,EAAE,MAAM;CAK/B;AAED,iCAAiC;AACjC,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;gBAEf,UAAU,EAAE,MAAM;CAK/B;AAED,iCAAiC;AACjC,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;gBAEf,UAAU,EAAE,MAAM;CAK/B;AAED,iCAAiC;AACjC,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE,CAAA;gBAEnB,cAAc,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE;CAU3D;AAED,iCAAiC;AACjC,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;gBAEhB,WAAW,EAAE,MAAM;CAKhC;AAED,iCAAiC;AACjC,qBAAa,0BAA2B,SAAQ,KAAK;IACnD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;gBAEjB,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM;CAS5E;AAED,iCAAiC;AACjC,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,CAAA;gBAElB,WAAW,EAAE,MAAM,EAAE,WAAW,GAAE,MAAM,EAAO;CAW5D;AAED,iCAAiC;AACjC,qBAAa,6BAA8B,SAAQ,KAAK;IACtD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;gBAEb,QAAQ,EAAE,MAAM;CAK7B;AAED,iCAAiC;AACjC,qBAAa,8BAA+B,SAAQ,KAAK;IACvD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,CAAA;gBAElB,cAAc,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE;CAM1D;AAED,iCAAiC;AACjC,qBAAa,iBAAkB,SAAQ,KAAK;gBAC9B,MAAM,EAAE,MAAM;CAI3B;AAED,iCAAiC;AACjC,qBAAa,mBAAoB,SAAQ,KAAK;;CAK7C;AAED,iCAAiC;AACjC,qBAAa,mBAAoB,SAAQ,KAAK;;CAK7C;AAED,iCAAiC;AACjC,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,kBAAkB,EAAE,MAAM,EAAE,CAAA;gBAEzB,QAAQ,EAAE,MAAM,EAAE;CAK/B"}

package/dist/features/building/domain/construction/construction-errors.js

@@ -8,6 +8,15 @@ export class DuplicateDomainError extends Error {
     }
 }
 /** @riviere-role domain-error */
+export class SourceConflictError extends Error {
+    repository;
+    constructor(repository) {
+        super(`Source '${repository}' already exists with different values`);
+        this.name = 'SourceConflictError';
+        this.repository = repository;
+    }
+}
+/** @riviere-role domain-error */
 export class DomainNotFoundError extends Error {
     domainName;
     constructor(domainName) {
@@ -40,6 +49,19 @@ export class DuplicateComponentError extends Error {
     }
 }
 /** @riviere-role domain-error */
+export class ComponentTypeMismatchError 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;
+    }
+}
+/** @riviere-role domain-error */
 export class ComponentNotFoundError extends Error {
     componentId;
     suggestions;

package/dist/features/building/domain/construction/construction-types.d.ts

@@ -13,6 +13,10 @@ export interface DomainInput {
     systemType: SystemType;
 }
 /** @riviere-role value-object */
+export interface UpsertOptions {
+    noOverwrite?: boolean;
+}
+/** @riviere-role value-object */
 export interface UIInput {
     name: string;
     domain: string;

package/dist/features/building/domain/construction/construction-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"construction-types.d.ts","sourceRoot":"","sources":["../../../../../src/features/building/domain/construction/construction-types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"construction-types.d.ts","sourceRoot":"","sources":["../../../../../src/features/building/domain/construction/construction-types.ts"],"names":[],"mappings":"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"}

package/dist/features/building/domain/construction/graph-construction.d.ts

@@ -1,20 +1,58 @@
 import type { APIComponent, CustomComponent, DomainOpComponent, EventComponent, EventHandlerComponent, SourceInfo, UIComponent, UseCaseComponent } from '@living-architecture/riviere-schema';
 import type { BuilderGraph } from '../builder-graph';
-import type { APIInput, CustomInput, CustomTypeInput, DomainInput, DomainOpInput, EventHandlerInput, EventInput, UIInput, UseCaseInput } from './construction-types';
+import type { APIInput, CustomInput, CustomTypeInput, DomainInput, DomainOpInput, EventHandlerInput, EventInput, UpsertOptions, UIInput, UseCaseInput } from './construction-types';
+import type { BuilderWarning } from '../inspection/inspection-types';
 /** @riviere-role domain-service */
 export declare class GraphConstruction {
     private readonly graph;
-    constructor(graph: BuilderGraph);
+    private readonly operationWarnings;
+    constructor(graph: BuilderGraph, operationWarnings: BuilderWarning[]);
     addSource(source: SourceInfo): void;
     addDomain(input: DomainInput): void;
     addUI(input: UIInput): UIComponent;
+    upsertUI(input: UIInput, options?: UpsertOptions): {
+        component: UIComponent;
+        created: boolean;
+    };
     addApi(input: APIInput): APIComponent;
+    upsertApi(input: APIInput, options?: UpsertOptions): {
+        component: APIComponent;
+        created: boolean;
+    };
     addUseCase(input: UseCaseInput): UseCaseComponent;
+    upsertUseCase(input: UseCaseInput, options?: UpsertOptions): {
+        component: UseCaseComponent;
+        created: boolean;
+    };
     addDomainOp(input: DomainOpInput): DomainOpComponent;
+    upsertDomainOp(input: DomainOpInput, options?: UpsertOptions): {
+        component: DomainOpComponent;
+        created: boolean;
+    };
     addEvent(input: EventInput): EventComponent;
+    upsertEvent(input: EventInput, options?: UpsertOptions): {
+        component: EventComponent;
+        created: boolean;
+    };
     addEventHandler(input: EventHandlerInput): EventHandlerComponent;
+    upsertEventHandler(input: EventHandlerInput, options?: UpsertOptions): {
+        component: EventHandlerComponent;
+        created: boolean;
+    };
     defineCustomType(input: CustomTypeInput): void;
     addCustom(input: CustomInput): CustomComponent;
+    upsertCustom(input: CustomInput, options?: UpsertOptions): {
+        component: CustomComponent;
+        created: boolean;
+    };
+    private buildUIComponent;
+    private buildAPIComponent;
+    private buildUseCaseComponent;
+    private buildDomainOpComponent;
+    private buildEventComponent;
+    private buildEventHandlerComponent;
+    private buildCustomComponent;
     private registerComponent;
+    private upsertTypedComponent;
 }
 //# sourceMappingURL=graph-construction.d.ts.map

package/dist/features/building/domain/construction/graph-construction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"graph-construction.d.ts","sourceRoot":"","sources":["../../../../../src/features/building/domain/construction/graph-construction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EAEZ,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,qBAAqB,EACrB,UAAU,EACV,WAAW,EACX,gBAAgB,EACjB,MAAM,qCAAqC,CAAA;AAC5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,KAAK,EACV,QAAQ,EACR,WAAW,EACX,eAAe,EACf,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,UAAU,EACV,OAAO,EACP,YAAY,EACb,MAAM,sBAAsB,CAAA;AAa7B,mCAAmC;AACnC,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;gBAExB,KAAK,EAAE,YAAY;IAI/B,SAAS,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAInC,SAAS,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAWnC,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW;IAiBlC,MAAM,CAAC,KAAK,EAAE,QAAQ,GAAG,YAAY;IAoBrC,UAAU,CAAC,KAAK,EAAE,YAAY,GAAG,gBAAgB;IAgBjD,WAAW,CAAC,KAAK,EAAE,aAAa,GAAG,iBAAiB;IAsBpD,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,cAAc;IAkB3C,eAAe,CAAC,KAAK,EAAE,iBAAiB,GAAG,qBAAqB;IAiBhE,gBAAgB,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI;IAc9C,SAAS,CAAC,KAAK,EAAE,WAAW,GAAG,eAAe;IAwB9C,OAAO,CAAC,iBAAiB;CAO1B"}
+{"version":3,"file":"graph-construction.d.ts","sourceRoot":"","sources":["../../../../../src/features/building/domain/construction/graph-construction.ts"],"names":[],"mappings":"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"}

package/dist/features/building/domain/construction/graph-construction.js

@@ -1,16 +1,30 @@
-import { CustomTypeAlreadyDefinedError, DuplicateComponentError, DuplicateDomainError, } from './construction-errors';
+import { ComponentTypeMismatchError, CustomTypeAlreadyDefinedError, DuplicateComponentError, DuplicateDomainError, SourceConflictError, } from './construction-errors';
 import { generateComponentId, validateCustomType, validateDomainExists, validateRequiredProperties, } from './builder-internals';
+import { mergeComponentForUpsert } from '../enrichment/upsert-merge';
 /** @riviere-role domain-service */
 export class GraphConstruction {
     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] = {
@@ -19,9 +33,62 @@ export class GraphConstruction {
         };
     }
     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 !== undefined && { requiredProperties: input.requiredProperties, }),
+            ...(input.optionalProperties !== undefined && { optionalProperties: input.optionalProperties, }),
+            ...(input.description !== undefined && { 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,
@@ -31,12 +98,11 @@ export class GraphConstruction {
             sourceLocation: input.sourceLocation,
             ...(input.description !== undefined && { 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,
@@ -49,12 +115,11 @@ export class GraphConstruction {
             ...(input.operationName !== undefined && { operationName: input.operationName }),
             ...(input.description !== undefined && { 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,
@@ -63,12 +128,11 @@ export class GraphConstruction {
             sourceLocation: input.sourceLocation,
             ...(input.description !== undefined && { 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,
@@ -83,12 +147,11 @@ export class GraphConstruction {
             ...(input.businessRules !== undefined && { businessRules: input.businessRules }),
             ...(input.description !== undefined && { 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,
@@ -99,12 +162,11 @@ export class GraphConstruction {
             ...(input.eventSchema !== undefined && { eventSchema: input.eventSchema }),
             ...(input.description !== undefined && { 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,
@@ -114,20 +176,8 @@ export class GraphConstruction {
             sourceLocation: input.sourceLocation,
             ...(input.description !== undefined && { 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 !== undefined && { requiredProperties: input.requiredProperties, }),
-            ...(input.optionalProperties !== undefined && { optionalProperties: input.optionalProperties, }),
-            ...(input.description !== undefined && { 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);
@@ -143,7 +193,7 @@ export class GraphConstruction {
             ...(input.description !== undefined && { description: input.description }),
             ...input.metadata,
         };
-        return this.registerComponent(component);
+        return component;
     }
     registerComponent(component) {
         if (this.graph.components.some((c) => c.id === component.id)) {
@@ -152,4 +202,32 @@ export class GraphConstruction {
         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;
 }

package/dist/features/building/domain/enrichment/upsert-merge.d.ts

@@ -0,0 +1,6 @@
+import type { Component } from '@living-architecture/riviere-schema';
+import type { UpsertOptions } from '../construction/construction-types';
+import type { BuilderWarning } from '../inspection/inspection-types';
+/** @riviere-role domain-service */
+export declare function mergeComponentForUpsert<T extends Component>(existing: T, incoming: T, options: UpsertOptions | undefined, warnings: BuilderWarning[]): T;
+//# sourceMappingURL=upsert-merge.d.ts.map

package/dist/features/building/domain/enrichment/upsert-merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upsert-merge.d.ts","sourceRoot":"","sources":["../../../../../src/features/building/domain/enrichment/upsert-merge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EAGV,MAAM,qCAAqC,CAAA;AAC5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAA;AACvE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAA;AAiBpE,mCAAmC;AACnC,wBAAgB,uBAAuB,CAAC,CAAC,SAAS,SAAS,EACzD,QAAQ,EAAE,CAAC,EACX,QAAQ,EAAE,CAAC,EACX,OAAO,EAAE,aAAa,GAAG,SAAS,EAClC,QAAQ,EAAE,cAAc,EAAE,GACzB,CAAC,CAmBH"}

package/dist/features/building/domain/enrichment/upsert-merge.js

@@ -0,0 +1,200 @@
+import { mergeBehavior } from './merge-behavior';
+const IDENTITY_FIELDS = new Set(['id', 'type', 'name', 'domain', 'module']);
+const CUSTOM_BASE_FIELDS = new Set([
+    'id',
+    'type',
+    'customTypeName',
+    'name',
+    'domain',
+    'module',
+    'description',
+    'sourceLocation',
+]);
+/** @riviere-role domain-service */
+export 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 : undefined;
+        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 : undefined;
+            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 undefined;
+    }
+    return toOperationBehaviorFromRecord(value);
+}
+function toOperationBehaviorFromRecord(value) {
+    const behavior = {};
+    const reads = toStringArray(value['reads']);
+    if (reads !== undefined) {
+        behavior.reads = reads;
+    }
+    const validates = toStringArray(value['validates']);
+    if (validates !== undefined) {
+        behavior.validates = validates;
+    }
+    const modifies = toStringArray(value['modifies']);
+    if (modifies !== undefined) {
+        behavior.modifies = modifies;
+    }
+    const emits = toStringArray(value['emits']);
+    if (emits !== undefined) {
+        behavior.emits = emits;
+    }
+    return behavior;
+}
+function toStringArray(value) {
+    if (!Array.isArray(value)) {
+        return undefined;
+    }
+    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 !== undefined && 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';
+}

package/dist/features/building/domain/index.d.ts

@@ -1,6 +1,6 @@
 export * from './builder-facade';
 export { ComponentId, type ComponentIdParts } from '@living-architecture/riviere-schema';
-export { DuplicateDomainError, DomainNotFoundError, CustomTypeNotFoundError, DuplicateComponentError, ComponentNotFoundError, CustomTypeAlreadyDefinedError, MissingRequiredPropertiesError, InvalidGraphError, MissingSourcesError, MissingDomainsError, BuildValidationError, } from './construction/construction-errors';
+export { DuplicateDomainError, SourceConflictError, DomainNotFoundError, CustomTypeNotFoundError, DuplicateComponentError, ComponentTypeMismatchError, ComponentNotFoundError, CustomTypeAlreadyDefinedError, MissingRequiredPropertiesError, InvalidGraphError, MissingSourcesError, MissingDomainsError, BuildValidationError, } from './construction/construction-errors';
 export { InvalidEnrichmentTargetError } from './enrichment/enrichment-errors';
 export { findNearMatches } from './error-recovery/component-suggestion';
 //# sourceMappingURL=index.d.ts.map

package/dist/features/building/domain/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/features/building/domain/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAA;AAChC,OAAO,EACL,WAAW,EAAE,KAAK,gBAAgB,EACnC,MAAM,qCAAqC,CAAA;AAC5C,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,uBAAuB,EACvB,uBAAuB,EACvB,sBAAsB,EACtB,6BAA6B,EAC7B,8BAA8B,EAC9B,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,oCAAoC,CAAA;AAC3C,OAAO,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAA;AAC7E,OAAO,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/features/building/domain/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAA;AAChC,OAAO,EACL,WAAW,EAAE,KAAK,gBAAgB,EACnC,MAAM,qCAAqC,CAAA;AAC5C,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EACnB,uBAAuB,EACvB,uBAAuB,EACvB,0BAA0B,EAC1B,sBAAsB,EACtB,6BAA6B,EAC7B,8BAA8B,EAC9B,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,oCAAoC,CAAA;AAC3C,OAAO,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAA;AAC7E,OAAO,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAA"}

package/dist/features/building/domain/index.js

@@ -1,5 +1,5 @@
 export * from './builder-facade';
 export { ComponentId } from '@living-architecture/riviere-schema';
-export { DuplicateDomainError, DomainNotFoundError, CustomTypeNotFoundError, DuplicateComponentError, ComponentNotFoundError, CustomTypeAlreadyDefinedError, MissingRequiredPropertiesError, InvalidGraphError, MissingSourcesError, MissingDomainsError, BuildValidationError, } from './construction/construction-errors';
+export { DuplicateDomainError, SourceConflictError, DomainNotFoundError, CustomTypeNotFoundError, DuplicateComponentError, ComponentTypeMismatchError, ComponentNotFoundError, CustomTypeAlreadyDefinedError, MissingRequiredPropertiesError, InvalidGraphError, MissingSourcesError, MissingDomainsError, BuildValidationError, } from './construction/construction-errors';
 export { InvalidEnrichmentTargetError } from './enrichment/enrichment-errors';
 export { findNearMatches } from './error-recovery/component-suggestion';

package/dist/features/building/domain/inspection/graph-inspection.d.ts

@@ -5,7 +5,8 @@ import type { BuilderStats, BuilderWarning } from './inspection-types';
 /** @riviere-role domain-service */
 export declare class GraphInspection {
     private readonly graph;
-    constructor(graph: BuilderGraph);
+    private readonly operationWarnings;
+    constructor(graph: BuilderGraph, operationWarnings: readonly BuilderWarning[]);
     warnings(): BuilderWarning[];
     stats(): BuilderStats;
     orphans(): string[];

package/dist/features/building/domain/inspection/graph-inspection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"graph-inspection.d.ts","sourceRoot":"","sources":["../../../../../src/features/building/domain/inspection/graph-inspection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAA;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAA;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,KAAK,EACV,YAAY,EAAE,cAAc,EAC7B,MAAM,oBAAoB,CAAA;AAS3B,mCAAmC;AACnC,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;gBAExB,KAAK,EAAE,YAAY;IAI/B,QAAQ,IAAI,cAAc,EAAE;IAI5B,KAAK,IAAI,YAAY;IAIrB,OAAO,IAAI,MAAM,EAAE;IAInB,QAAQ,IAAI,gBAAgB;IAI5B,KAAK,IAAI,YAAY;CAGtB"}
+{"version":3,"file":"graph-inspection.d.ts","sourceRoot":"","sources":["../../../../../src/features/building/domain/inspection/graph-inspection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAA;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAA;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,KAAK,EACV,YAAY,EAAE,cAAc,EAC7B,MAAM,oBAAoB,CAAA;AAS3B,mCAAmC;AACnC,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;IACpC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA2B;gBAEjD,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,SAAS,cAAc,EAAE;IAK7E,QAAQ,IAAI,cAAc,EAAE;IAI5B,KAAK,IAAI,YAAY;IAIrB,OAAO,IAAI,MAAM,EAAE;IAInB,QAAQ,IAAI,gBAAgB;IAI5B,KAAK,IAAI,YAAY;CAGtB"}

package/dist/features/building/domain/inspection/graph-inspection.js

@@ -3,11 +3,13 @@ import { calculateStats, findOrphans, findWarnings, toRiviereGraph, validateGrap
 /** @riviere-role domain-service */
 export class GraphInspection {
     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);

package/dist/features/building/domain/inspection/inspection-types.d.ts

@@ -15,12 +15,20 @@ export interface BuilderStats {
     domainCount: number;
 }
 /** @riviere-role value-object */
-export type WarningCode = 'ORPHAN_COMPONENT' | 'UNUSED_DOMAIN';
+export type WarningCode = 'ORPHAN_COMPONENT' | 'UNUSED_DOMAIN' | 'SCALAR_OVERWRITE' | 'DUPLICATE_LINK_SKIPPED';
 /** @riviere-role value-object */
 export interface BuilderWarning {
     code: WarningCode;
     message: string;
     componentId?: string;
     domainName?: string;
+    field?: string;
+    oldValue?: string | number | boolean;
+    newValue?: string | number | boolean;
+    source?: string;
+    target?: string;
+    linkType?: string;
+    targetRepository?: string;
+    targetName?: string;
 }
 //# sourceMappingURL=inspection-types.d.ts.map

package/dist/features/building/domain/inspection/inspection-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"inspection-types.d.ts","sourceRoot":"","sources":["../../../../../src/features/building/domain/inspection/inspection-types.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,MAAM,WAAW,YAAY;IAC3B,cAAc,EAAE,MAAM,CAAA;IACtB,gBAAgB,EAAE;QAChB,EAAE,EAAE,MAAM,CAAA;QACV,GAAG,EAAE,MAAM,CAAA;QACX,OAAO,EAAE,MAAM,CAAA;QACf,QAAQ,EAAE,MAAM,CAAA;QAChB,KAAK,EAAE,MAAM,CAAA;QACb,YAAY,EAAE,MAAM,CAAA;QACpB,MAAM,EAAE,MAAM,CAAA;KACf,CAAA;IACD,SAAS,EAAE,MAAM,CAAA;IACjB,iBAAiB,EAAE,MAAM,CAAA;IACzB,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,iCAAiC;AACjC,MAAM,MAAM,WAAW,GAAG,kBAAkB,GAAG,eAAe,CAAA;AAE9D,iCAAiC;AACjC,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,WAAW,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB"}
+{"version":3,"file":"inspection-types.d.ts","sourceRoot":"","sources":["../../../../../src/features/building/domain/inspection/inspection-types.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,MAAM,WAAW,YAAY;IAC3B,cAAc,EAAE,MAAM,CAAA;IACtB,gBAAgB,EAAE;QAChB,EAAE,EAAE,MAAM,CAAA;QACV,GAAG,EAAE,MAAM,CAAA;QACX,OAAO,EAAE,MAAM,CAAA;QACf,QAAQ,EAAE,MAAM,CAAA;QAChB,KAAK,EAAE,MAAM,CAAA;QACb,YAAY,EAAE,MAAM,CAAA;QACpB,MAAM,EAAE,MAAM,CAAA;KACf,CAAA;IACD,SAAS,EAAE,MAAM,CAAA;IACjB,iBAAiB,EAAE,MAAM,CAAA;IACzB,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,iCAAiC;AACjC,MAAM,MAAM,WAAW,GACnB,kBAAkB,GAClB,eAAe,GACf,kBAAkB,GAClB,wBAAwB,CAAA;AAE5B,iCAAiC;AACjC,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,WAAW,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;IACpC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;IACpC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB"}

package/dist/features/building/domain/linking/graph-linking.d.ts

@@ -1,10 +1,12 @@
 import type { ExternalLink, Link } from '@living-architecture/riviere-schema';
 import type { BuilderGraph } from '../builder-graph';
+import type { BuilderWarning } from '../inspection/inspection-types';
 import type { ExternalLinkInput, LinkInput } from './linking-types';
 /** @riviere-role domain-service */
 export declare class GraphLinking {
     private readonly graph;
-    constructor(graph: BuilderGraph);
+    private readonly operationWarnings;
+    constructor(graph: BuilderGraph, operationWarnings: BuilderWarning[]);
     link(input: LinkInput): Link;
     linkExternal(input: ExternalLinkInput): ExternalLink;
 }

package/dist/features/building/domain/linking/graph-linking.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"graph-linking.d.ts","sourceRoot":"","sources":["../../../../../src/features/building/domain/linking/graph-linking.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EAAE,IAAI,EACnB,MAAM,qCAAqC,CAAA;AAC5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,KAAK,EACV,iBAAiB,EAAE,SAAS,EAC7B,MAAM,iBAAiB,CAAA;AAGxB,mCAAmC;AACnC,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;gBAExB,KAAK,EAAE,YAAY;IAI/B,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAe5B,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,YAAY;CAgBrD"}
+{"version":3,"file":"graph-linking.d.ts","sourceRoot":"","sources":["../../../../../src/features/building/domain/linking/graph-linking.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EAAE,IAAI,EACnB,MAAM,qCAAqC,CAAA;AAC5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAA;AACpE,OAAO,KAAK,EACV,iBAAiB,EAAE,SAAS,EAC7B,MAAM,iBAAiB,CAAA;AAGxB,mCAAmC;AACnC,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;IACpC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAkB;gBAExC,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE;IAKpE,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IA+B5B,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,YAAY;CAsCrD"}

package/dist/features/building/domain/linking/graph-linking.js

@@ -2,14 +2,27 @@ import { createComponentNotFoundError } from '../construction/builder-internals'
 /** @riviere-role domain-service */
 export class GraphLinking {
     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((link) => link.source === input.from && link.target === input.to && link.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 !== undefined && { linkType: input.type }),
+            });
+            return duplicate;
+        }
         const link = {
             source: input.from,
             target: input.to,
@@ -23,6 +36,22 @@ export class GraphLinking {
         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 !== undefined && { linkType: input.type }),
+                ...(input.target.repository !== undefined && { targetRepository: input.target.repository }),
+                targetName: input.target.name,
+            });
+            return duplicate;
+        }
         const externalLink = {
             source: input.from,
             target: input.target,

package/dist/features/building/domain/riviere-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"riviere-builder.d.ts","sourceRoot":"","sources":["../../../../src/features/building/domain/riviere-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAA;AAEvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAA;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAA;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAA;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAA;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAA;AASvE,mCAAmC;AACnC,qBAAa,cAAc;IACzB,QAAQ,CAAC,YAAY,EAAE,iBAAiB,CAAA;IACxC,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAA;IACpC,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAA;IAC9B,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAA;IACpC,QAAQ,CAAC,aAAa,EAAE,SAAS,CAAA;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAE1B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;IAEpC,OAAO;IAUP,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,YAAY,EAAE,SAAS,SAAK,GAAG,cAAc;IAmBlE,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,cAAc,EAAE,SAAS,SAAK,GAAG,cAAc;IA0BnE,SAAS,IAAI,MAAM;IAInB,KAAK,IAAI,YAAY;CAQtB"}
+{"version":3,"file":"riviere-builder.d.ts","sourceRoot":"","sources":["../../../../src/features/building/domain/riviere-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAA;AAEvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAA;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAA;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAA;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAA;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAA;AAUvE,mCAAmC;AACnC,qBAAa,cAAc;IACzB,QAAQ,CAAC,YAAY,EAAE,iBAAiB,CAAA;IACxC,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAA;IACpC,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAA;IAC9B,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAA;IACpC,QAAQ,CAAC,aAAa,EAAE,SAAS,CAAA;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAE1B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;IAEpC,OAAO;IAWP,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,YAAY,EAAE,SAAS,SAAK,GAAG,cAAc;IAmBlE,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,cAAc,EAAE,SAAS,SAAK,GAAG,cAAc;IA0BnE,SAAS,IAAI,MAAM;IAInB,KAAK,IAAI,YAAY;CAQtB"}

package/dist/features/building/domain/riviere-builder.js

@@ -17,10 +17,11 @@ export 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 = '') {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@living-architecture/riviere-builder",
-  "version": "0.7.12",
+  "version": "0.8.0",
   "publishConfig": {
     "access": "public"
   },