@living-architecture/riviere-builder 0.6.6 → 0.7.3

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

@@ -11,24 +11,29 @@ export type { APIInput, BuilderOptions, BuilderStats, BuilderWarning, CustomInpu
  *
  * Thin facade preserving the flat public API while delegating
  * to focused domain classes internally.
+ *
+ * @riviere-role aggregate
  */
 export declare class RiviereBuilder {
     private readonly delegate;
+    readonly graphPath: string;
     private constructor();
     /**
      * Restores a builder from a previously serialized graph.
      *
      * @param graph - A valid RiviereGraph to resume from
+     * @param graphPath - File path where the graph is persisted
      * @returns A new RiviereBuilder with the graph state restored
      */
-    static resume(graph: RiviereGraph): RiviereBuilder;
+    static resume(graph: RiviereGraph, graphPath?: string): RiviereBuilder;
     /**
      * Creates a new builder with initial configuration.
      *
      * @param options - Configuration including sources and domains
+     * @param graphPath - File path where the graph will be persisted
      * @returns A new RiviereBuilder instance
      */
-    static new(options: BuilderOptions): RiviereBuilder;
+    static new(options: BuilderOptions, graphPath?: string): RiviereBuilder;
     /**
      * Adds an additional source repository to the graph.
      *

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":"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,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,OAAO,EACP,YAAY,GACb,CAAA;AAED;;;;;GAKG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;IAExC,OAAO;IAIP;;;;;OAKG;IACH,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,YAAY,GAAG,cAAc;IAIlD;;;;;OAKG;IACH,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,cAAc,GAAG,cAAc;IAInD;;;;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;;;;;OAKG;IACH,MAAM,CAAC,KAAK,EAAE,QAAQ,GAAG,YAAY;IAIrC;;;;;OAKG;IACH,UAAU,CAAC,KAAK,EAAE,YAAY,GAAG,gBAAgB;IAIjD;;;;;OAKG;IACH,WAAW,CAAC,KAAK,EAAE,aAAa,GAAG,iBAAiB;IAIpD;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,cAAc;IAI3C;;;;;OAKG;IACH,eAAe,CAAC,KAAK,EAAE,iBAAiB,GAAG,qBAAqB;IAIhE;;;;OAIG;IACH,gBAAgB,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI;IAI9C;;;;;OAKG;IACH,SAAS,CAAC,KAAK,EAAE,WAAW,GAAG,eAAe;IAI9C;;;;;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"}
+{"version":3,"file":"builder-facade.d.ts","sourceRoot":"","sources":["../../../../src/features/building/domain/builder-facade.ts"],"names":[],"mappings":"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"}

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

@@ -4,29 +4,35 @@ import { RiviereBuilder as DomainBuilder } from './riviere-builder';
  *
  * Thin facade preserving the flat public API while delegating
  * to focused domain classes internally.
+ *
+ * @riviere-role aggregate
  */
 export class RiviereBuilder {
     delegate;
+    graphPath;
     constructor(delegate) {
         this.delegate = delegate;
+        this.graphPath = delegate.graphPath;
     }
     /**
      * Restores a builder from a previously serialized graph.
      *
      * @param graph - A valid RiviereGraph to resume from
+     * @param graphPath - File path where the graph is persisted
      * @returns A new RiviereBuilder with the graph state restored
      */
-    static resume(graph) {
-        return new RiviereBuilder(DomainBuilder.resume(graph));
+    static resume(graph, graphPath = '') {
+        return new RiviereBuilder(DomainBuilder.resume(graph, graphPath));
     }
     /**
      * Creates a new builder with initial configuration.
      *
      * @param options - Configuration including sources and domains
+     * @param graphPath - File path where the graph will be persisted
      * @returns A new RiviereBuilder instance
      */
-    static new(options) {
-        return new RiviereBuilder(DomainBuilder.new(options));
+    static new(options, graphPath = '') {
+        return new RiviereBuilder(DomainBuilder.new(options, graphPath));
     }
     /**
      * Adds an additional source repository to the graph.

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

@@ -1,8 +1,10 @@
 import type { CustomTypeDefinition, ExternalLink, GraphMetadata, RiviereGraph, SourceInfo } from '@living-architecture/riviere-schema';
+/** @riviere-role value-object */
 export interface BuilderMetadata extends Omit<GraphMetadata, 'sources' | 'customTypes'> {
     sources: SourceInfo[];
     customTypes: Record<string, CustomTypeDefinition>;
 }
+/** @riviere-role value-object */
 export interface BuilderGraph extends Omit<RiviereGraph, 'metadata' | 'externalLinks'> {
     metadata: BuilderMetadata;
     externalLinks: ExternalLink[];

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

@@ -1 +1 @@
-{"version":3,"file":"builder-graph.d.ts","sourceRoot":"","sources":["../../../../src/features/building/domain/builder-graph.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EACpB,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,UAAU,EACX,MAAM,qCAAqC,CAAA;AAE5C,MAAM,WAAW,eAAgB,SAAQ,IAAI,CAAC,aAAa,EAAE,SAAS,GAAG,aAAa,CAAC;IACrF,OAAO,EAAE,UAAU,EAAE,CAAA;IACrB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAA;CAClD;AAED,MAAM,WAAW,YAAa,SAAQ,IAAI,CAAC,YAAY,EAAE,UAAU,GAAG,eAAe,CAAC;IACpF,QAAQ,EAAE,eAAe,CAAA;IACzB,aAAa,EAAE,YAAY,EAAE,CAAA;CAC9B"}
+{"version":3,"file":"builder-graph.d.ts","sourceRoot":"","sources":["../../../../src/features/building/domain/builder-graph.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EACpB,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,UAAU,EACX,MAAM,qCAAqC,CAAA;AAE5C,iCAAiC;AACjC,MAAM,WAAW,eAAgB,SAAQ,IAAI,CAAC,aAAa,EAAE,SAAS,GAAG,aAAa,CAAC;IACrF,OAAO,EAAE,UAAU,EAAE,CAAA;IACrB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAA;CAClD;AAED,iCAAiC;AACjC,MAAM,WAAW,YAAa,SAAQ,IAAI,CAAC,YAAY,EAAE,UAAU,GAAG,eAAe,CAAC;IACpF,QAAQ,EAAE,eAAe,CAAA;IACzB,aAAa,EAAE,YAAY,EAAE,CAAA;CAC9B"}

package/dist/features/building/domain/construction/builder-assertions.d.ts

@@ -1,5 +1,8 @@
 import type { CustomTypeDefinition, DomainMetadata } from '@living-architecture/riviere-schema';
+/** @riviere-role domain-service */
 export declare function assertDomainExists(domains: Record<string, DomainMetadata>, domain: string): void;
+/** @riviere-role domain-service */
 export declare function assertCustomTypeExists(customTypes: Record<string, CustomTypeDefinition>, customTypeName: string): void;
+/** @riviere-role domain-service */
 export declare function assertRequiredPropertiesProvided(customTypes: Record<string, CustomTypeDefinition>, customTypeName: string, metadata: Record<string, unknown> | undefined): void;
 //# sourceMappingURL=builder-assertions.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"builder-assertions.d.ts","sourceRoot":"","sources":["../../../../../src/features/building/domain/construction/builder-assertions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EAAE,cAAc,EACrC,MAAM,qCAAqC,CAAA;AAO5C,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAIhG;AAED,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,EACjD,cAAc,EAAE,MAAM,GACrB,IAAI,CAKN;AAED,wBAAgB,gCAAgC,CAC9C,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,EACjD,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAC5C,IAAI,CAaN"}
+{"version":3,"file":"builder-assertions.d.ts","sourceRoot":"","sources":["../../../../../src/features/building/domain/construction/builder-assertions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EAAE,cAAc,EACrC,MAAM,qCAAqC,CAAA;AAO5C,mCAAmC;AACnC,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAIhG;AAED,mCAAmC;AACnC,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,EACjD,cAAc,EAAE,MAAM,GACrB,IAAI,CAKN;AAED,mCAAmC;AACnC,wBAAgB,gCAAgC,CAC9C,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,EACjD,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAC5C,IAAI,CAaN"}

package/dist/features/building/domain/construction/builder-assertions.js

@@ -1,15 +1,18 @@
 import { CustomTypeNotFoundError, DomainNotFoundError, MissingRequiredPropertiesError, } from './construction-errors';
+/** @riviere-role domain-service */
 export function assertDomainExists(domains, domain) {
     if (!domains[domain]) {
         throw new DomainNotFoundError(domain);
     }
 }
+/** @riviere-role domain-service */
 export function assertCustomTypeExists(customTypes, customTypeName) {
     if (!customTypes[customTypeName]) {
         const definedTypes = Object.keys(customTypes);
         throw new CustomTypeNotFoundError(customTypeName, definedTypes);
     }
 }
+/** @riviere-role domain-service */
 export function assertRequiredPropertiesProvided(customTypes, customTypeName, metadata) {
     const typeDefinition = customTypes[customTypeName];
     if (!typeDefinition?.requiredProperties) {

package/dist/features/building/domain/construction/builder-internals.d.ts

@@ -1,7 +1,12 @@
 import type { Component, CustomTypeDefinition, DomainMetadata } from '@living-architecture/riviere-schema';
+/** @riviere-role domain-service */
 export declare function generateComponentId(domain: string, module: string, type: string, name: string): string;
+/** @riviere-role domain-service */
 export declare function createComponentNotFoundError(components: Component[], id: string): Error;
+/** @riviere-role domain-service */
 export declare function validateDomainExists(domains: Record<string, DomainMetadata>, domain: string): void;
+/** @riviere-role domain-service */
 export declare function validateCustomType(customTypes: Record<string, CustomTypeDefinition>, customTypeName: string): void;
+/** @riviere-role domain-service */
 export declare function validateRequiredProperties(customTypes: Record<string, CustomTypeDefinition>, customTypeName: string, metadata: Record<string, unknown> | undefined): void;
 //# sourceMappingURL=builder-internals.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"builder-internals.d.ts","sourceRoot":"","sources":["../../../../../src/features/building/domain/construction/builder-internals.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,oBAAoB,EACpB,cAAc,EACf,MAAM,qCAAqC,CAAA;AAS5C,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX,MAAM,CAGR;AAED,wBAAgB,4BAA4B,CAAC,UAAU,EAAE,SAAS,EAAE,EAAE,EAAE,EAAE,MAAM,GAAG,KAAK,CAEvF;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,EACvC,MAAM,EAAE,MAAM,GACb,IAAI,CAEN;AAED,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,EACjD,cAAc,EAAE,MAAM,GACrB,IAAI,CAEN;AAED,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,EACjD,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAC5C,IAAI,CAEN"}
+{"version":3,"file":"builder-internals.d.ts","sourceRoot":"","sources":["../../../../../src/features/building/domain/construction/builder-internals.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,oBAAoB,EACpB,cAAc,EACf,MAAM,qCAAqC,CAAA;AAS5C,mCAAmC;AACnC,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX,MAAM,CAGR;AAED,mCAAmC;AACnC,wBAAgB,4BAA4B,CAAC,UAAU,EAAE,SAAS,EAAE,EAAE,EAAE,EAAE,MAAM,GAAG,KAAK,CAEvF;AAED,mCAAmC;AACnC,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,EACvC,MAAM,EAAE,MAAM,GACb,IAAI,CAEN;AAED,mCAAmC;AACnC,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,EACjD,cAAc,EAAE,MAAM,GACrB,IAAI,CAEN;AAED,mCAAmC;AACnC,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,EACjD,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAC5C,IAAI,CAEN"}

package/dist/features/building/domain/construction/builder-internals.js

@@ -1,19 +1,24 @@
 import { ComponentId } from '@living-architecture/riviere-schema';
 import { createSourceNotFoundError } from '../error-recovery/component-suggestion';
 import { assertCustomTypeExists, assertDomainExists, assertRequiredPropertiesProvided, } from './builder-assertions';
+/** @riviere-role domain-service */
 export function generateComponentId(domain, module, type, name) {
     const nameSegment = name.toLowerCase().replaceAll(/\s+/g, '-');
     return `${domain}:${module}:${type}:${nameSegment}`;
 }
+/** @riviere-role domain-service */
 export function createComponentNotFoundError(components, id) {
     return createSourceNotFoundError(components, ComponentId.parse(id));
 }
+/** @riviere-role domain-service */
 export function validateDomainExists(domains, domain) {
     assertDomainExists(domains, domain);
 }
+/** @riviere-role domain-service */
 export function validateCustomType(customTypes, customTypeName) {
     assertCustomTypeExists(customTypes, customTypeName);
 }
+/** @riviere-role domain-service */
 export function validateRequiredProperties(customTypes, customTypeName, metadata) {
     assertRequiredPropertiesProvided(customTypes, customTypeName, metadata);
 }

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

@@ -1,43 +1,54 @@
+/** @riviere-role domain-error */
 export declare class DuplicateDomainError extends Error {
     readonly domainName: string;
     constructor(domainName: string);
 }
+/** @riviere-role domain-error */
 export declare class DomainNotFoundError extends Error {
     readonly domainName: string;
     constructor(domainName: string);
 }
+/** @riviere-role domain-error */
 export declare class CustomTypeNotFoundError extends Error {
     readonly customTypeName: string;
     readonly definedTypes: string[];
     constructor(customTypeName: string, definedTypes: string[]);
 }
+/** @riviere-role domain-error */
 export declare class DuplicateComponentError extends Error {
     readonly componentId: string;
     constructor(componentId: string);
 }
+/** @riviere-role domain-error */
 export declare class ComponentNotFoundError extends Error {
     readonly componentId: string;
     readonly suggestions: string[];
     constructor(componentId: string, suggestions?: string[]);
 }
+/** @riviere-role domain-error */
 export declare class CustomTypeAlreadyDefinedError extends Error {
     readonly typeName: string;
     constructor(typeName: string);
 }
+/** @riviere-role domain-error */
 export declare class MissingRequiredPropertiesError extends Error {
     readonly customTypeName: string;
     readonly missingKeys: string[];
     constructor(customTypeName: string, missingKeys: string[]);
 }
+/** @riviere-role domain-error */
 export declare class InvalidGraphError extends Error {
     constructor(reason: string);
 }
+/** @riviere-role domain-error */
 export declare class MissingSourcesError extends Error {
     constructor();
 }
+/** @riviere-role domain-error */
 export declare class MissingDomainsError extends Error {
     constructor();
 }
+/** @riviere-role domain-error */
 export declare class BuildValidationError extends Error {
     readonly validationMessages: string[];
     constructor(messages: 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,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;gBAEf,UAAU,EAAE,MAAM;CAK/B;AAED,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;gBAEf,UAAU,EAAE,MAAM;CAK/B;AAED,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,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;gBAEhB,WAAW,EAAE,MAAM;CAKhC;AAED,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,qBAAa,6BAA8B,SAAQ,KAAK;IACtD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;gBAEb,QAAQ,EAAE,MAAM;CAK7B;AAED,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,qBAAa,iBAAkB,SAAQ,KAAK;gBAC9B,MAAM,EAAE,MAAM;CAI3B;AAED,qBAAa,mBAAoB,SAAQ,KAAK;;CAK7C;AAED,qBAAa,mBAAoB,SAAQ,KAAK;;CAK7C;AAED,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,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"}

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

@@ -1,3 +1,4 @@
+/** @riviere-role domain-error */
 export class DuplicateDomainError extends Error {
     domainName;
     constructor(domainName) {
@@ -6,6 +7,7 @@ export class DuplicateDomainError extends Error {
         this.domainName = domainName;
     }
 }
+/** @riviere-role domain-error */
 export class DomainNotFoundError extends Error {
     domainName;
     constructor(domainName) {
@@ -14,6 +16,7 @@ export class DomainNotFoundError extends Error {
         this.domainName = domainName;
     }
 }
+/** @riviere-role domain-error */
 export class CustomTypeNotFoundError extends Error {
     customTypeName;
     definedTypes;
@@ -27,6 +30,7 @@ export class CustomTypeNotFoundError extends Error {
         this.definedTypes = definedTypes;
     }
 }
+/** @riviere-role domain-error */
 export class DuplicateComponentError extends Error {
     componentId;
     constructor(componentId) {
@@ -35,6 +39,7 @@ export class DuplicateComponentError extends Error {
         this.componentId = componentId;
     }
 }
+/** @riviere-role domain-error */
 export class ComponentNotFoundError extends Error {
     componentId;
     suggestions;
@@ -49,6 +54,7 @@ export class ComponentNotFoundError extends Error {
         this.suggestions = suggestions;
     }
 }
+/** @riviere-role domain-error */
 export class CustomTypeAlreadyDefinedError extends Error {
     typeName;
     constructor(typeName) {
@@ -57,6 +63,7 @@ export class CustomTypeAlreadyDefinedError extends Error {
         this.typeName = typeName;
     }
 }
+/** @riviere-role domain-error */
 export class MissingRequiredPropertiesError extends Error {
     customTypeName;
     missingKeys;
@@ -67,24 +74,28 @@ export class MissingRequiredPropertiesError extends Error {
         this.missingKeys = missingKeys;
     }
 }
+/** @riviere-role domain-error */
 export class InvalidGraphError extends Error {
     constructor(reason) {
         super(`Invalid graph: ${reason}`);
         this.name = 'InvalidGraphError';
     }
 }
+/** @riviere-role domain-error */
 export class MissingSourcesError extends Error {
     constructor() {
         super('At least one source required');
         this.name = 'MissingSourcesError';
     }
 }
+/** @riviere-role domain-error */
 export class MissingDomainsError extends Error {
     constructor() {
         super('At least one domain required');
         this.name = 'MissingDomainsError';
     }
 }
+/** @riviere-role domain-error */
 export class BuildValidationError extends Error {
     validationMessages;
     constructor(messages) {

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

@@ -1,15 +1,18 @@
 import type { ApiType, CustomPropertyDefinition, DomainMetadata, HttpMethod, OperationBehavior, OperationSignature, SourceInfo, SourceLocation, StateTransition, SystemType } from '@living-architecture/riviere-schema';
+/** @riviere-role value-object */
 export interface BuilderOptions {
     name?: string;
     description?: string;
     sources: SourceInfo[];
     domains: Record<string, DomainMetadata>;
 }
+/** @riviere-role value-object */
 export interface DomainInput {
     name: string;
     description: string;
     systemType: SystemType;
 }
+/** @riviere-role value-object */
 export interface UIInput {
     name: string;
     domain: string;
@@ -19,6 +22,7 @@ export interface UIInput {
     sourceLocation: SourceLocation;
     metadata?: Record<string, unknown>;
 }
+/** @riviere-role value-object */
 export interface APIInput {
     name: string;
     domain: string;
@@ -31,6 +35,7 @@ export interface APIInput {
     sourceLocation: SourceLocation;
     metadata?: Record<string, unknown>;
 }
+/** @riviere-role value-object */
 export interface UseCaseInput {
     name: string;
     domain: string;
@@ -39,6 +44,7 @@ export interface UseCaseInput {
     sourceLocation: SourceLocation;
     metadata?: Record<string, unknown>;
 }
+/** @riviere-role value-object */
 export interface DomainOpInput {
     name: string;
     domain: string;
@@ -53,6 +59,7 @@ export interface DomainOpInput {
     sourceLocation: SourceLocation;
     metadata?: Record<string, unknown>;
 }
+/** @riviere-role value-object */
 export interface EventInput {
     name: string;
     domain: string;
@@ -63,6 +70,7 @@ export interface EventInput {
     sourceLocation: SourceLocation;
     metadata?: Record<string, unknown>;
 }
+/** @riviere-role value-object */
 export interface EventHandlerInput {
     name: string;
     domain: string;
@@ -72,12 +80,14 @@ export interface EventHandlerInput {
     sourceLocation: SourceLocation;
     metadata?: Record<string, unknown>;
 }
+/** @riviere-role value-object */
 export interface CustomTypeInput {
     name: string;
     description?: string;
     requiredProperties?: Record<string, CustomPropertyDefinition>;
     optionalProperties?: Record<string, CustomPropertyDefinition>;
 }
+/** @riviere-role value-object */
 export interface CustomInput {
     customTypeName: string;
     name: 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,6 +1,7 @@
 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';
+/** @riviere-role domain-service */
 export declare class GraphConstruction {
     private readonly graph;
     constructor(graph: BuilderGraph);

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,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":"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"}

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

@@ -1,5 +1,6 @@
 import { CustomTypeAlreadyDefinedError, DuplicateComponentError, DuplicateDomainError, } from './construction-errors';
 import { generateComponentId, validateCustomType, validateDomainExists, validateRequiredProperties, } from './builder-internals';
+/** @riviere-role domain-service */
 export class GraphConstruction {
     graph;
     constructor(graph) {

package/dist/features/building/domain/enrichment/deduplicate-transitions.d.ts

@@ -1,3 +1,4 @@
 import type { StateTransition } from '@living-architecture/riviere-schema';
+/** @riviere-role domain-service */
 export declare function deduplicateStateTransitions(existing: StateTransition[], incoming: StateTransition[]): StateTransition[];
 //# sourceMappingURL=deduplicate-transitions.d.ts.map

package/dist/features/building/domain/enrichment/deduplicate-transitions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deduplicate-transitions.d.ts","sourceRoot":"","sources":["../../../../../src/features/building/domain/enrichment/deduplicate-transitions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAA;AAE1E,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,eAAe,EAAE,EAC3B,QAAQ,EAAE,eAAe,EAAE,GAC1B,eAAe,EAAE,CAKnB"}
+{"version":3,"file":"deduplicate-transitions.d.ts","sourceRoot":"","sources":["../../../../../src/features/building/domain/enrichment/deduplicate-transitions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAA;AAE1E,mCAAmC;AACnC,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,eAAe,EAAE,EAC3B,QAAQ,EAAE,eAAe,EAAE,GAC1B,eAAe,EAAE,CAKnB"}

package/dist/features/building/domain/enrichment/deduplicate-transitions.js

@@ -1,3 +1,4 @@
+/** @riviere-role domain-service */
 export function deduplicateStateTransitions(existing, incoming) {
     return incoming.filter((item) => !existing.some((e) => e.from === item.from && e.to === item.to && e.trigger === item.trigger));
 }

package/dist/features/building/domain/enrichment/enrichment-errors.d.ts

@@ -1,3 +1,4 @@
+/** @riviere-role domain-error */
 export declare class InvalidEnrichmentTargetError extends Error {
     readonly componentId: string;
     readonly componentType: string;

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

@@ -1 +1 @@
-{"version":3,"file":"enrichment-errors.d.ts","sourceRoot":"","sources":["../../../../../src/features/building/domain/enrichment/enrichment-errors.ts"],"names":[],"mappings":"AAAA,qBAAa,4BAA6B,SAAQ,KAAK;IACrD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;gBAElB,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM;CAMvD"}
+{"version":3,"file":"enrichment-errors.d.ts","sourceRoot":"","sources":["../../../../../src/features/building/domain/enrichment/enrichment-errors.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,qBAAa,4BAA6B,SAAQ,KAAK;IACrD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;gBAElB,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM;CAMvD"}

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

@@ -1,3 +1,4 @@
+/** @riviere-role domain-error */
 export class InvalidEnrichmentTargetError extends Error {
     componentId;
     componentType;

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

@@ -1,4 +1,5 @@
 import type { OperationBehavior, OperationSignature, StateTransition } from '@living-architecture/riviere-schema';
+/** @riviere-role value-object */
 export interface EnrichmentInput {
     entity?: string;
     stateChanges?: StateTransition[];

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

@@ -1 +1 @@
-{"version":3,"file":"enrichment-types.d.ts","sourceRoot":"","sources":["../../../../../src/features/building/domain/enrichment/enrichment-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EAChB,MAAM,qCAAqC,CAAA;AAE5C,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,YAAY,CAAC,EAAE,eAAe,EAAE,CAAA;IAChC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;IACxB,QAAQ,CAAC,EAAE,iBAAiB,CAAA;IAC5B,SAAS,CAAC,EAAE,kBAAkB,CAAA;CAC/B"}
+{"version":3,"file":"enrichment-types.d.ts","sourceRoot":"","sources":["../../../../../src/features/building/domain/enrichment/enrichment-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EAChB,MAAM,qCAAqC,CAAA;AAE5C,iCAAiC;AACjC,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,YAAY,CAAC,EAAE,eAAe,EAAE,CAAA;IAChC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;IACxB,QAAQ,CAAC,EAAE,iBAAiB,CAAA;IAC5B,SAAS,CAAC,EAAE,kBAAkB,CAAA;CAC/B"}

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

@@ -1,5 +1,6 @@
 import type { BuilderGraph } from '../builder-graph';
 import type { EnrichmentInput } from './enrichment-types';
+/** @riviere-role domain-service */
 export declare class GraphEnrichment {
     private readonly graph;
     constructor(graph: BuilderGraph);

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

@@ -1 +1 @@
-{"version":3,"file":"graph-enrichment.d.ts","sourceRoot":"","sources":["../../../../../src/features/building/domain/enrichment/graph-enrichment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAOzD,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;gBAExB,KAAK,EAAE,YAAY;IAI/B,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,eAAe,GAAG,IAAI;CA4B/D"}
+{"version":3,"file":"graph-enrichment.d.ts","sourceRoot":"","sources":["../../../../../src/features/building/domain/enrichment/graph-enrichment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAOzD,mCAAmC;AACnC,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;gBAExB,KAAK,EAAE,YAAY;IAI/B,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,eAAe,GAAG,IAAI;CA4B/D"}

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

@@ -3,6 +3,7 @@ import { createComponentNotFoundError } from '../construction/builder-internals'
 import { deduplicateStateTransitions } from './deduplicate-transitions';
 import { deduplicateStrings } from '../../../../platform/domain/collection-utils/deduplicate-strings';
 import { mergeBehavior } from './merge-behavior';
+/** @riviere-role domain-service */
 export class GraphEnrichment {
     graph;
     constructor(graph) {

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

@@ -1,3 +1,4 @@
 import type { DomainOpComponent, OperationBehavior } from '@living-architecture/riviere-schema';
+/** @riviere-role domain-service */
 export declare function mergeBehavior(existing: DomainOpComponent['behavior'], incoming: OperationBehavior): OperationBehavior;
 //# sourceMappingURL=merge-behavior.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"merge-behavior.d.ts","sourceRoot":"","sources":["../../../../../src/features/building/domain/enrichment/merge-behavior.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EAAE,iBAAiB,EACrC,MAAM,qCAAqC,CAAA;AAQ5C,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,iBAAiB,CAAC,UAAU,CAAC,EACvC,QAAQ,EAAE,iBAAiB,GAC1B,iBAAiB,CASnB"}
+{"version":3,"file":"merge-behavior.d.ts","sourceRoot":"","sources":["../../../../../src/features/building/domain/enrichment/merge-behavior.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EAAE,iBAAiB,EACrC,MAAM,qCAAqC,CAAA;AAQ5C,mCAAmC;AACnC,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,iBAAiB,CAAC,UAAU,CAAC,EACvC,QAAQ,EAAE,iBAAiB,GAC1B,iBAAiB,CASnB"}

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

@@ -3,6 +3,7 @@ function mergeStringArray(existing, incoming) {
     const base = existing ?? [];
     return [...base, ...deduplicateStrings(base, incoming)];
 }
+/** @riviere-role domain-service */
 export function mergeBehavior(existing, incoming) {
     const base = existing ?? {};
     return {

package/dist/features/building/domain/error-recovery/component-suggestion.d.ts

@@ -6,6 +6,8 @@ import type { NearMatchOptions, NearMatchQuery, NearMatchResult } from './match-
  *
  * Used for error recovery to suggest alternatives when exact matches fail.
  *
+ * @riviere-role domain-service
+ *
  * @param components - Array of components to search
  * @param query - Search criteria with name and optional type/domain filters
  * @param options - Optional threshold and limit settings
@@ -21,6 +23,8 @@ export declare function findNearMatches(components: Component[], query: NearMatc
 /**
  * Creates a typed error with suggestions for a missing source component.
  *
+ * @riviere-role domain-service
+ *
  * @param components - Array of existing components to search for suggestions
  * @param id - The ComponentId that was not found
  * @returns ComponentNotFoundError with suggestions array for programmatic access

package/dist/features/building/domain/error-recovery/component-suggestion.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"component-suggestion.d.ts","sourceRoot":"","sources":["../../../../../src/features/building/domain/error-recovery/component-suggestion.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EAAE,WAAW,EACvB,MAAM,qCAAqC,CAAA;AAC5C,OAAO,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAA;AAE5E,OAAO,KAAK,EAEV,gBAAgB,EAChB,cAAc,EACd,eAAe,EAChB,MAAM,eAAe,CAAA;AA+BtB;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,SAAS,EAAE,EACvB,KAAK,EAAE,cAAc,EACrB,OAAO,CAAC,EAAE,gBAAgB,GACzB,eAAe,EAAE,CAuBnB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,SAAS,EAAE,EACvB,EAAE,EAAE,WAAW,GACd,sBAAsB,CAIxB"}
+{"version":3,"file":"component-suggestion.d.ts","sourceRoot":"","sources":["../../../../../src/features/building/domain/error-recovery/component-suggestion.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EAAE,WAAW,EACvB,MAAM,qCAAqC,CAAA;AAC5C,OAAO,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAA;AAE5E,OAAO,KAAK,EAEV,gBAAgB,EAChB,cAAc,EACd,eAAe,EAChB,MAAM,eAAe,CAAA;AA+BtB;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,SAAS,EAAE,EACvB,KAAK,EAAE,cAAc,EACrB,OAAO,CAAC,EAAE,gBAAgB,GACzB,eAAe,EAAE,CAuBnB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,SAAS,EAAE,EACvB,EAAE,EAAE,WAAW,GACd,sBAAsB,CAIxB"}

package/dist/features/building/domain/error-recovery/component-suggestion.js

@@ -26,6 +26,8 @@ function detectMismatch(query, component) {
  *
  * Used for error recovery to suggest alternatives when exact matches fail.
  *
+ * @riviere-role domain-service
+ *
  * @param components - Array of components to search
  * @param query - Search criteria with name and optional type/domain filters
  * @param options - Optional threshold and limit settings
@@ -61,6 +63,8 @@ export function findNearMatches(components, query, options) {
 /**
  * Creates a typed error with suggestions for a missing source component.
  *
+ * @riviere-role domain-service
+ *
  * @param components - Array of existing components to search for suggestions
  * @param id - The ComponentId that was not found
  * @returns ComponentNotFoundError with suggestions array for programmatic access

package/dist/features/building/domain/error-recovery/match-types.d.ts

@@ -1,19 +1,23 @@
 import type { ComponentType } from '@living-architecture/riviere-schema';
+/** @riviere-role value-object */
 export interface NearMatchQuery {
     name: string;
     type?: ComponentType;
     domain?: string;
 }
+/** @riviere-role value-object */
 export interface NearMatchMismatch {
     field: 'type' | 'domain';
     expected: string;
     actual: string;
 }
+/** @riviere-role value-object */
 export interface NearMatchResult {
     component: import('@living-architecture/riviere-schema').Component;
     score: number;
     mismatch?: NearMatchMismatch | undefined;
 }
+/** @riviere-role value-object */
 export interface NearMatchOptions {
     threshold?: number;
     limit?: number;

package/dist/features/building/domain/error-recovery/match-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"match-types.d.ts","sourceRoot":"","sources":["../../../../../src/features/building/domain/error-recovery/match-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAA;AAExE,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,aAAa,CAAA;IACpB,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,GAAG,QAAQ,CAAA;IACxB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,OAAO,qCAAqC,EAAE,SAAS,CAAA;IAClE,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAA;CACzC;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf"}
+{"version":3,"file":"match-types.d.ts","sourceRoot":"","sources":["../../../../../src/features/building/domain/error-recovery/match-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAA;AAExE,iCAAiC;AACjC,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,aAAa,CAAA;IACpB,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,iCAAiC;AACjC,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,GAAG,QAAQ,CAAA;IACxB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;CACf;AAED,iCAAiC;AACjC,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,OAAO,qCAAqC,EAAE,SAAS,CAAA;IAClE,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAA;CACzC;AAED,iCAAiC;AACjC,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf"}

package/dist/features/building/domain/error-recovery/near-match.d.ts

@@ -1,5 +1,6 @@
 import type { BuilderGraph } from '../builder-graph';
 import type { NearMatchOptions, NearMatchQuery, NearMatchResult } from './match-types';
+/** @riviere-role domain-service */
 export declare class NearMatch {
     private readonly graph;
     constructor(graph: BuilderGraph);

package/dist/features/building/domain/error-recovery/near-match.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"near-match.d.ts","sourceRoot":"","sources":["../../../../../src/features/building/domain/error-recovery/near-match.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,KAAK,EACV,gBAAgB,EAAE,cAAc,EAAE,eAAe,EAClD,MAAM,eAAe,CAAA;AAGtB,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;gBAExB,KAAK,EAAE,YAAY;IAI/B,eAAe,CAAC,KAAK,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,eAAe,EAAE;CAGtF"}
+{"version":3,"file":"near-match.d.ts","sourceRoot":"","sources":["../../../../../src/features/building/domain/error-recovery/near-match.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,KAAK,EACV,gBAAgB,EAAE,cAAc,EAAE,eAAe,EAClD,MAAM,eAAe,CAAA;AAGtB,mCAAmC;AACnC,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;gBAExB,KAAK,EAAE,YAAY;IAI/B,eAAe,CAAC,KAAK,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,eAAe,EAAE;CAGtF"}

package/dist/features/building/domain/error-recovery/near-match.js

@@ -1,4 +1,5 @@
 import { findNearMatches } from './component-suggestion';
+/** @riviere-role domain-service */
 export class NearMatch {
     graph;
     constructor(graph) {

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

@@ -2,6 +2,7 @@ import type { ValidationResult } from '@living-architecture/riviere-query';
 import { RiviereQuery } from '@living-architecture/riviere-query';
 import type { BuilderGraph } from '../builder-graph';
 import type { BuilderStats, BuilderWarning } from './inspection-types';
+/** @riviere-role domain-service */
 export declare class GraphInspection {
     private readonly graph;
     constructor(graph: BuilderGraph);

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,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;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"}

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

@@ -1,5 +1,6 @@
 import { RiviereQuery } from '@living-architecture/riviere-query';
 import { calculateStats, findOrphans, findWarnings, toRiviereGraph, validateGraph, } from './inspection-functions';
+/** @riviere-role domain-service */
 export class GraphInspection {
     graph;
     constructor(graph) {

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

@@ -18,6 +18,8 @@ interface InspectionGraph {
 /**
  * Finds components with no incoming or outgoing links.
  *
+ * @riviere-role domain-service
+ *
  * @param graph - The graph to inspect
  * @returns Array of orphaned component IDs
  *
@@ -31,6 +33,8 @@ export declare function findOrphans(graph: InspectionGraph): string[];
 /**
  * Calculates statistics about the graph.
  *
+ * @riviere-role domain-service
+ *
  * @param graph - The graph to analyze
  * @returns Object with component counts, link counts, and domain count
  *
@@ -46,6 +50,8 @@ export declare function calculateStats(graph: InspectionGraph): BuilderStats;
  *
  * Detects orphaned components and unused domains.
  *
+ * @riviere-role domain-service
+ *
  * @param graph - The graph to inspect
  * @returns Array of warning objects
  *
@@ -61,6 +67,8 @@ export declare function findWarnings(graph: InspectionGraph): BuilderWarning[];
  *
  * Removes undefined optional fields and ensures proper structure.
  *
+ * @riviere-role domain-service
+ *
  * @param graph - The internal builder graph
  * @returns Schema-compliant RiviereGraph
  *
@@ -74,6 +82,8 @@ export declare function toRiviereGraph(graph: InspectionGraph): RiviereGraph;
 /**
  * Validates the graph against the Rivière schema.
  *
+ * @riviere-role domain-service
+ *
  * @param graph - The graph to validate
  * @returns Validation result with valid flag and any errors
  *

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

@@ -1 +1 @@
-{"version":3,"file":"inspection-functions.d.ts","sourceRoot":"","sources":["../../../../../src/features/building/domain/inspection/inspection-functions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,oBAAoB,EACpB,cAAc,EACd,YAAY,EACZ,IAAI,EACJ,YAAY,EACZ,UAAU,EACX,MAAM,qCAAqC,CAAA;AAC5C,OAAO,EACS,KAAK,gBAAgB,EACpC,MAAM,oCAAoC,CAAA;AAC3C,OAAO,KAAK,EACV,YAAY,EAAE,cAAc,EAC7B,MAAM,oBAAoB,CAAA;AAE3B,UAAU,eAAe;IACvB,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE;QACR,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,SAAS,CAAC,EAAE,MAAM,CAAA;QAClB,OAAO,EAAE,UAAU,EAAE,CAAA;QACrB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA;QACvC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAA;KAClD,CAAA;IACD,UAAU,EAAE,SAAS,EAAE,CAAA;IACvB,KAAK,EAAE,IAAI,EAAE,CAAA;IACb,aAAa,EAAE,YAAY,EAAE,CAAA;CAC9B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,EAAE,CAa5D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,eAAe,GAAG,YAAY,CAiBnE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,eAAe,GAAG,cAAc,EAAE,CAuBrE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,eAAe,GAAG,YAAY,CAiBnE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,eAAe,GAAG,gBAAgB,CAEtE"}
+{"version":3,"file":"inspection-functions.d.ts","sourceRoot":"","sources":["../../../../../src/features/building/domain/inspection/inspection-functions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,oBAAoB,EACpB,cAAc,EACd,YAAY,EACZ,IAAI,EACJ,YAAY,EACZ,UAAU,EACX,MAAM,qCAAqC,CAAA;AAC5C,OAAO,EACS,KAAK,gBAAgB,EACpC,MAAM,oCAAoC,CAAA;AAC3C,OAAO,KAAK,EACV,YAAY,EAAE,cAAc,EAC7B,MAAM,oBAAoB,CAAA;AAE3B,UAAU,eAAe;IACvB,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE;QACR,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,SAAS,CAAC,EAAE,MAAM,CAAA;QAClB,OAAO,EAAE,UAAU,EAAE,CAAA;QACrB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA;QACvC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAA;KAClD,CAAA;IACD,UAAU,EAAE,SAAS,EAAE,CAAA;IACvB,KAAK,EAAE,IAAI,EAAE,CAAA;IACb,aAAa,EAAE,YAAY,EAAE,CAAA;CAC9B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,EAAE,CAa5D;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,eAAe,GAAG,YAAY,CAiBnE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,eAAe,GAAG,cAAc,EAAE,CAuBrE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,eAAe,GAAG,YAAY,CAiBnE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,eAAe,GAAG,gBAAgB,CAEtE"}

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

@@ -2,6 +2,8 @@ import { RiviereQuery } from '@living-architecture/riviere-query';
 /**
  * Finds components with no incoming or outgoing links.
  *
+ * @riviere-role domain-service
+ *
  * @param graph - The graph to inspect
  * @returns Array of orphaned component IDs
  *
@@ -25,6 +27,8 @@ export function findOrphans(graph) {
 /**
  * Calculates statistics about the graph.
  *
+ * @riviere-role domain-service
+ *
  * @param graph - The graph to analyze
  * @returns Object with component counts, link counts, and domain count
  *
@@ -57,6 +61,8 @@ export function calculateStats(graph) {
  *
  * Detects orphaned components and unused domains.
  *
+ * @riviere-role domain-service
+ *
  * @param graph - The graph to inspect
  * @returns Array of warning objects
  *
@@ -92,6 +98,8 @@ export function findWarnings(graph) {
  *
  * Removes undefined optional fields and ensures proper structure.
  *
+ * @riviere-role domain-service
+ *
  * @param graph - The internal builder graph
  * @returns Schema-compliant RiviereGraph
  *
@@ -121,6 +129,8 @@ export function toRiviereGraph(graph) {
 /**
  * Validates the graph against the Rivière schema.
  *
+ * @riviere-role domain-service
+ *
  * @param graph - The graph to validate
  * @returns Validation result with valid flag and any errors
  *

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

@@ -1,3 +1,4 @@
+/** @riviere-role value-object */
 export interface BuilderStats {
     componentCount: number;
     componentsByType: {
@@ -13,7 +14,9 @@ export interface BuilderStats {
     externalLinkCount: number;
     domainCount: number;
 }
+/** @riviere-role value-object */
 export type WarningCode = 'ORPHAN_COMPONENT' | 'UNUSED_DOMAIN';
+/** @riviere-role value-object */
 export interface BuilderWarning {
     code: WarningCode;
     message: string;

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,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,MAAM,MAAM,WAAW,GAAG,kBAAkB,GAAG,eAAe,CAAA;AAE9D,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,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"}

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

@@ -1,6 +1,7 @@
 import type { ExternalLink, Link } from '@living-architecture/riviere-schema';
 import type { BuilderGraph } from '../builder-graph';
 import type { ExternalLinkInput, LinkInput } from './linking-types';
+/** @riviere-role domain-service */
 export declare class GraphLinking {
     private readonly graph;
     constructor(graph: BuilderGraph);

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,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,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"}

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

@@ -1,4 +1,5 @@
 import { createComponentNotFoundError } from '../construction/builder-internals';
+/** @riviere-role domain-service */
 export class GraphLinking {
     graph;
     constructor(graph) {

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

@@ -1,9 +1,11 @@
 import type { ExternalTarget, LinkType, SourceLocation } from '@living-architecture/riviere-schema';
+/** @riviere-role value-object */
 export interface LinkInput {
     from: string;
     to: string;
     type?: LinkType;
 }
+/** @riviere-role value-object */
 export interface ExternalLinkInput {
     from: string;
     target: ExternalTarget;

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

@@ -1 +1 @@
-{"version":3,"file":"linking-types.d.ts","sourceRoot":"","sources":["../../../../../src/features/building/domain/linking/linking-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EAAE,QAAQ,EAAE,cAAc,EACzC,MAAM,qCAAqC,CAAA;AAE5C,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,CAAC,EAAE,QAAQ,CAAA;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,cAAc,CAAA;IACtB,IAAI,CAAC,EAAE,QAAQ,CAAA;IACf,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,cAAc,CAAC,EAAE,cAAc,CAAA;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC"}
+{"version":3,"file":"linking-types.d.ts","sourceRoot":"","sources":["../../../../../src/features/building/domain/linking/linking-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EAAE,QAAQ,EAAE,cAAc,EACzC,MAAM,qCAAqC,CAAA;AAE5C,iCAAiC;AACjC,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,CAAC,EAAE,QAAQ,CAAA;CAChB;AAED,iCAAiC;AACjC,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,cAAc,CAAA;IACtB,IAAI,CAAC,EAAE,QAAQ,CAAA;IACf,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,cAAc,CAAC,EAAE,cAAc,CAAA;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC"}

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

@@ -5,16 +5,18 @@ import { GraphLinking } from './linking/graph-linking';
 import { GraphInspection } from './inspection/graph-inspection';
 import { NearMatch } from './error-recovery/near-match';
 import type { BuilderOptions } from './construction/construction-types';
+/** @riviere-role domain-service */
 export declare class RiviereBuilder {
     readonly construction: GraphConstruction;
     readonly enrichment: GraphEnrichment;
     readonly linking: GraphLinking;
     readonly inspection: GraphInspection;
     readonly errorRecovery: NearMatch;
+    readonly graphPath: string;
     private readonly graph;
     private constructor();
-    static resume(graph: RiviereGraph): RiviereBuilder;
-    static new(options: BuilderOptions): RiviereBuilder;
+    static resume(graph: RiviereGraph, graphPath?: string): RiviereBuilder;
+    static new(options: BuilderOptions, graphPath?: string): RiviereBuilder;
     serialize(): string;
     build(): RiviereGraph;
 }

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,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;IAEjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;IAEpC,OAAO;IASP,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,YAAY,GAAG,cAAc;IAmBlD,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,cAAc,GAAG,cAAc;IA0BnD,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;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"}

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

@@ -5,22 +5,25 @@ import { GraphInspection } from './inspection/graph-inspection';
 import { NearMatch } from './error-recovery/near-match';
 import { BuildValidationError, InvalidGraphError, MissingDomainsError, MissingSourcesError, } from './construction/construction-errors';
 import { toRiviereGraph } from './inspection/inspection-functions';
+/** @riviere-role domain-service */
 export class RiviereBuilder {
     construction;
     enrichment;
     linking;
     inspection;
     errorRecovery;
+    graphPath;
     graph;
-    constructor(graph) {
+    constructor(graph, graphPath) {
         this.graph = graph;
+        this.graphPath = graphPath;
         this.construction = new GraphConstruction(graph);
         this.enrichment = new GraphEnrichment(graph);
         this.linking = new GraphLinking(graph);
         this.inspection = new GraphInspection(graph);
         this.errorRecovery = new NearMatch(graph);
     }
-    static resume(graph) {
+    static resume(graph, graphPath = '') {
         if (!graph.metadata.sources || graph.metadata.sources.length === 0) {
             throw new InvalidGraphError('missing sources');
         }
@@ -35,9 +38,9 @@ export class RiviereBuilder {
             links: graph.links,
             externalLinks: graph.externalLinks ?? [],
         };
-        return new RiviereBuilder(builderGraph);
+        return new RiviereBuilder(builderGraph, graphPath);
     }
-    static new(options) {
+    static new(options, graphPath = '') {
         if (options.sources.length === 0) {
             throw new MissingSourcesError();
         }
@@ -57,7 +60,7 @@ export class RiviereBuilder {
             links: [],
             externalLinks: [],
         };
-        return new RiviereBuilder(graph);
+        return new RiviereBuilder(graph, graphPath);
     }
     serialize() {
         return JSON.stringify(this.graph, null, 2);

package/dist/platform/domain/collection-utils/deduplicate-strings.d.ts

@@ -1,2 +1,3 @@
+/** @riviere-role domain-service */
 export declare function deduplicateStrings(existing: string[], incoming: string[]): string[];
 //# sourceMappingURL=deduplicate-strings.d.ts.map

package/dist/platform/domain/collection-utils/deduplicate-strings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deduplicate-strings.d.ts","sourceRoot":"","sources":["../../../../src/platform/domain/collection-utils/deduplicate-strings.ts"],"names":[],"mappings":"AAAA,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAGnF"}
+{"version":3,"file":"deduplicate-strings.d.ts","sourceRoot":"","sources":["../../../../src/platform/domain/collection-utils/deduplicate-strings.ts"],"names":[],"mappings":"AAAA,mCAAmC;AACnC,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAGnF"}

package/dist/platform/domain/collection-utils/deduplicate-strings.js

@@ -1,3 +1,4 @@
+/** @riviere-role domain-service */
 export function deduplicateStrings(existing, incoming) {
     const existingSet = new Set(existing);
     return incoming.filter((item) => !existingSet.has(item));

package/dist/platform/domain/text-similarity/string-similarity.d.ts

@@ -1,6 +1,8 @@
 /**
  * Calculates the Levenshtein edit distance between two strings.
  *
+ * @riviere-role domain-service
+ *
  * @param a - First string
  * @param b - Second string
  * @returns Number of single-character edits needed to transform a into b
@@ -18,6 +20,8 @@ export declare function levenshteinDistance(a: string, b: string): number;
  * Returns 1.0 for identical strings, 0.0 for completely different strings.
  * Case-insensitive comparison.
  *
+ * @riviere-role domain-service
+ *
  * @param a - First string
  * @param b - Second string
  * @returns Similarity score from 0.0 to 1.0

package/dist/platform/domain/text-similarity/string-similarity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"string-similarity.d.ts","sourceRoot":"","sources":["../../../../src/platform/domain/text-similarity/string-similarity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAqBhE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAW5D"}
+{"version":3,"file":"string-similarity.d.ts","sourceRoot":"","sources":["../../../../src/platform/domain/text-similarity/string-similarity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAqBhE;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAW5D"}

package/dist/platform/domain/text-similarity/string-similarity.js

@@ -1,6 +1,8 @@
 /**
  * Calculates the Levenshtein edit distance between two strings.
  *
+ * @riviere-role domain-service
+ *
  * @param a - First string
  * @param b - Second string
  * @returns Number of single-character edits needed to transform a into b
@@ -38,6 +40,8 @@ export function levenshteinDistance(a, b) {
  * Returns 1.0 for identical strings, 0.0 for completely different strings.
  * Case-insensitive comparison.
  *
+ * @riviere-role domain-service
+ *
  * @param a - First string
  * @param b - Second string
  * @returns Similarity score from 0.0 to 1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@living-architecture/riviere-builder",
-  "version": "0.6.6",
+  "version": "0.7.3",
   "publishConfig": {
     "access": "public"
   },
@@ -22,7 +22,7 @@
     "!**/*.tsbuildinfo"
   ],
   "dependencies": {
-    "@living-architecture/riviere-query": "0.5.6",
-    "@living-architecture/riviere-schema": "0.5.6"
+    "@living-architecture/riviere-schema": "0.6.3",
+    "@living-architecture/riviere-query": "0.6.3"
   }
 }