@makaio/framework 1.0.0-dev-1789178780636 → 1.0.0-dev-1789234461336

package/dist/{index-DhunnX8V.d.mts → index-ClKwF6LE.d.mts}

@@ -1,4 +1,4 @@
-import { C as ArtifactScope, K as ArtifactKindRegistration$1, V as ArtifactCategory, X as ArtifactLifecycleState, _ as ArtifactRelationTarget, ot as ArtifactRef$1, p as ArtifactRelation, rt as ArtifactUniquenessRule, s as ArtifactObservation$1, t as ArtifactActor, x as ArtifactRevision$1, y as ArtifactRepresentations } from "./schemas-CKVm28Oy.mjs";
+import { C as ArtifactScope, K as ArtifactKindRegistration$1, V as ArtifactCategory, X as ArtifactLifecycleState, _ as ArtifactRelationTarget, ot as ArtifactRef$1, p as ArtifactRelation, rt as ArtifactUniquenessRule, s as ArtifactObservation$1, t as ArtifactActor, x as ArtifactRevision$1, y as ArtifactRepresentations } from "./schemas-JjyFxrC0.mjs";
 import { l as JsonValue$1 } from "./json-value-Ymw2f8i_.mjs";
 import { z } from "zod";
 import * as _$_makaio_core0 from "@makaio/framework/core";
@@ -674,6 +674,7 @@ declare const ArtifactContextRefEntrySchema: z.ZodObject<{
     revision: z.ZodString;
   }, z.core.$strict>;
   relationType: z.ZodString;
+  sourceLocalId: z.ZodOptional<z.ZodString>;
   hint: z.ZodString;
   status: z.ZodEnum<{
     resolved: "resolved";
@@ -736,6 +737,7 @@ declare const ResolvedArtifactContextWireSchema: z.ZodObject<{
       revision: z.ZodString;
     }, z.core.$strict>;
     relationType: z.ZodString;
+    sourceLocalId: z.ZodOptional<z.ZodString>;
     hint: z.ZodString;
     status: z.ZodEnum<{
       resolved: "resolved";
@@ -761,6 +763,7 @@ declare const ResolvedArtifactContextWireSchema: z.ZodObject<{
     data: z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>;
     relations: z.ZodArray<z.ZodObject<{
       type: z.ZodString;
+      sourceLocalId: z.ZodOptional<z.ZodString>;
       target: z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
         refClass: z.ZodLiteral<"artifact">;
         kind: z.ZodString;
@@ -931,6 +934,8 @@ type ArtifactContextRootNode = ResolvedArtifactContextNodeBase;
 interface ResolvedArtifactContextNode extends ResolvedArtifactContextNodeBase {
   /** Relation type that led to this node from its parent. */
   readonly relation: string;
+  /** Optional local identifier of the parent part that owns this relation. */
+  readonly sourceLocalId?: string;
 }
 /** An unresolved node representing a relation that could not be followed. */
 interface UnresolvedArtifactContextNode {
@@ -939,6 +944,8 @@ interface UnresolvedArtifactContextNode {
   readonly target: ArtifactRelationTarget;
   /** Relation type that led to this node from its parent. */
   readonly relation: string;
+  /** Optional local identifier of the parent part that owns this relation. */
+  readonly sourceLocalId?: string;
   /** Render hint applied to this node. */
   readonly hint: ArtifactContextRenderHint;
   /** Reason the target was not resolved. */
@@ -1196,8 +1203,8 @@ declare const ArtifactSchemas$1: {
   }; /** Create a new artifact and its first revision (RPC). */
   create: {
     request: z.ZodObject<{
-      kind: z.ZodString;
       data: z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>;
+      kind: z.ZodString;
       evidence: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
         source: z.ZodObject<{
           kind: z.ZodLiteral<"git-file">;
@@ -1258,6 +1265,7 @@ declare const ArtifactSchemas$1: {
       }, z.core.$strip>;
       relations: z.ZodArray<z.ZodObject<{
         type: z.ZodString;
+        sourceLocalId: z.ZodOptional<z.ZodString>;
         target: z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
           refClass: z.ZodLiteral<"artifact">;
           kind: z.ZodString;
@@ -1348,6 +1356,7 @@ declare const ArtifactSchemas$1: {
         data: z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>;
         relations: z.ZodArray<z.ZodObject<{
           type: z.ZodString;
+          sourceLocalId: z.ZodOptional<z.ZodString>;
           target: z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
             refClass: z.ZodLiteral<"artifact">;
             kind: z.ZodString;
@@ -1490,8 +1499,8 @@ declare const ArtifactSchemas$1: {
       }, z.core.$strict>;
       statusPath: z.ZodOptional<z.ZodString>;
       revision: z.ZodObject<{
-        kind: z.ZodString;
         data: z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>;
+        kind: z.ZodString;
         evidence: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
           source: z.ZodObject<{
             kind: z.ZodLiteral<"git-file">;
@@ -1552,6 +1561,7 @@ declare const ArtifactSchemas$1: {
         }, z.core.$strip>;
         relations: z.ZodArray<z.ZodObject<{
           type: z.ZodString;
+          sourceLocalId: z.ZodOptional<z.ZodString>;
           target: z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
             refClass: z.ZodLiteral<"artifact">;
             kind: z.ZodString;
@@ -1642,6 +1652,7 @@ declare const ArtifactSchemas$1: {
         data: z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>;
         relations: z.ZodArray<z.ZodObject<{
           type: z.ZodString;
+          sourceLocalId: z.ZodOptional<z.ZodString>;
           target: z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
             refClass: z.ZodLiteral<"artifact">;
             kind: z.ZodString;
@@ -1918,6 +1929,7 @@ declare const ArtifactSchemas$1: {
         data: z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>;
         relations: z.ZodArray<z.ZodObject<{
           type: z.ZodString;
+          sourceLocalId: z.ZodOptional<z.ZodString>;
           target: z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
             refClass: z.ZodLiteral<"artifact">;
             kind: z.ZodString;
@@ -2169,6 +2181,7 @@ declare const ArtifactSchemas$1: {
         data: z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>;
         relations: z.ZodArray<z.ZodObject<{
           type: z.ZodString;
+          sourceLocalId: z.ZodOptional<z.ZodString>;
           target: z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
             refClass: z.ZodLiteral<"artifact">;
             kind: z.ZodString;
@@ -2329,6 +2342,7 @@ declare const ArtifactSchemas$1: {
         data: z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>;
         relations: z.ZodArray<z.ZodObject<{
           type: z.ZodString;
+          sourceLocalId: z.ZodOptional<z.ZodString>;
           target: z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
             refClass: z.ZodLiteral<"artifact">;
             kind: z.ZodString;
@@ -2471,6 +2485,7 @@ declare const ArtifactSchemas$1: {
         data: z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>;
         relations: z.ZodArray<z.ZodObject<{
           type: z.ZodString;
+          sourceLocalId: z.ZodOptional<z.ZodString>;
           target: z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
             refClass: z.ZodLiteral<"artifact">;
             kind: z.ZodString;
@@ -2763,6 +2778,7 @@ declare const ArtifactSchemas$1: {
             revision: z.ZodString;
           }, z.core.$strict>;
           relationType: z.ZodString;
+          sourceLocalId: z.ZodOptional<z.ZodString>;
           hint: z.ZodString;
           status: z.ZodEnum<{
             resolved: "resolved";
@@ -2788,6 +2804,7 @@ declare const ArtifactSchemas$1: {
           data: z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>;
           relations: z.ZodArray<z.ZodObject<{
             type: z.ZodString;
+            sourceLocalId: z.ZodOptional<z.ZodString>;
             target: z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
               refClass: z.ZodLiteral<"artifact">;
               kind: z.ZodString;
@@ -2934,6 +2951,7 @@ declare const ArtifactSchemas$1: {
       data: z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>;
       relations: z.ZodArray<z.ZodObject<{
         type: z.ZodString;
+        sourceLocalId: z.ZodOptional<z.ZodString>;
         target: z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
           refClass: z.ZodLiteral<"artifact">;
           kind: z.ZodString;
@@ -3084,6 +3102,7 @@ declare const ArtifactSchemas$1: {
       data: z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>;
       relations: z.ZodArray<z.ZodObject<{
         type: z.ZodString;
+        sourceLocalId: z.ZodOptional<z.ZodString>;
         target: z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
           refClass: z.ZodLiteral<"artifact">;
           kind: z.ZodString;
@@ -3224,6 +3243,7 @@ declare const ArtifactSchemas$1: {
     }, z.core.$strict>;
     relation: z.ZodObject<{
       type: z.ZodString;
+      sourceLocalId: z.ZodOptional<z.ZodString>;
       target: z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
         refClass: z.ZodLiteral<"artifact">;
         kind: z.ZodString;
@@ -3971,8 +3991,8 @@ declare const ArtifactNamespace: _$_makaio_core0.BusNamespaceDefinition<"artifac
   }; /** Create a new artifact and its first revision (RPC). */
   create: {
     request: z.ZodObject<{
-      kind: z.ZodString;
       data: z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>;
+      kind: z.ZodString;
       evidence: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
         source: z.ZodObject<{
           kind: z.ZodLiteral<"git-file">;
@@ -4033,6 +4053,7 @@ declare const ArtifactNamespace: _$_makaio_core0.BusNamespaceDefinition<"artifac
       }, z.core.$strip>;
       relations: z.ZodArray<z.ZodObject<{
         type: z.ZodString;
+        sourceLocalId: z.ZodOptional<z.ZodString>;
         target: z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
           refClass: z.ZodLiteral<"artifact">;
           kind: z.ZodString;
@@ -4123,6 +4144,7 @@ declare const ArtifactNamespace: _$_makaio_core0.BusNamespaceDefinition<"artifac
         data: z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>;
         relations: z.ZodArray<z.ZodObject<{
           type: z.ZodString;
+          sourceLocalId: z.ZodOptional<z.ZodString>;
           target: z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
             refClass: z.ZodLiteral<"artifact">;
             kind: z.ZodString;
@@ -4265,8 +4287,8 @@ declare const ArtifactNamespace: _$_makaio_core0.BusNamespaceDefinition<"artifac
       }, z.core.$strict>;
       statusPath: z.ZodOptional<z.ZodString>;
       revision: z.ZodObject<{
-        kind: z.ZodString;
         data: z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>;
+        kind: z.ZodString;
         evidence: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
           source: z.ZodObject<{
             kind: z.ZodLiteral<"git-file">;
@@ -4327,6 +4349,7 @@ declare const ArtifactNamespace: _$_makaio_core0.BusNamespaceDefinition<"artifac
         }, z.core.$strip>;
         relations: z.ZodArray<z.ZodObject<{
           type: z.ZodString;
+          sourceLocalId: z.ZodOptional<z.ZodString>;
           target: z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
             refClass: z.ZodLiteral<"artifact">;
             kind: z.ZodString;
@@ -4417,6 +4440,7 @@ declare const ArtifactNamespace: _$_makaio_core0.BusNamespaceDefinition<"artifac
         data: z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>;
         relations: z.ZodArray<z.ZodObject<{
           type: z.ZodString;
+          sourceLocalId: z.ZodOptional<z.ZodString>;
           target: z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
             refClass: z.ZodLiteral<"artifact">;
             kind: z.ZodString;
@@ -4693,6 +4717,7 @@ declare const ArtifactNamespace: _$_makaio_core0.BusNamespaceDefinition<"artifac
         data: z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>;
         relations: z.ZodArray<z.ZodObject<{
           type: z.ZodString;
+          sourceLocalId: z.ZodOptional<z.ZodString>;
           target: z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
             refClass: z.ZodLiteral<"artifact">;
             kind: z.ZodString;
@@ -4944,6 +4969,7 @@ declare const ArtifactNamespace: _$_makaio_core0.BusNamespaceDefinition<"artifac
         data: z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>;
         relations: z.ZodArray<z.ZodObject<{
           type: z.ZodString;
+          sourceLocalId: z.ZodOptional<z.ZodString>;
           target: z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
             refClass: z.ZodLiteral<"artifact">;
             kind: z.ZodString;
@@ -5104,6 +5130,7 @@ declare const ArtifactNamespace: _$_makaio_core0.BusNamespaceDefinition<"artifac
         data: z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>;
         relations: z.ZodArray<z.ZodObject<{
           type: z.ZodString;
+          sourceLocalId: z.ZodOptional<z.ZodString>;
           target: z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
             refClass: z.ZodLiteral<"artifact">;
             kind: z.ZodString;
@@ -5246,6 +5273,7 @@ declare const ArtifactNamespace: _$_makaio_core0.BusNamespaceDefinition<"artifac
         data: z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>;
         relations: z.ZodArray<z.ZodObject<{
           type: z.ZodString;
+          sourceLocalId: z.ZodOptional<z.ZodString>;
           target: z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
             refClass: z.ZodLiteral<"artifact">;
             kind: z.ZodString;
@@ -5538,6 +5566,7 @@ declare const ArtifactNamespace: _$_makaio_core0.BusNamespaceDefinition<"artifac
             revision: z.ZodString;
           }, z.core.$strict>;
           relationType: z.ZodString;
+          sourceLocalId: z.ZodOptional<z.ZodString>;
           hint: z.ZodString;
           status: z.ZodEnum<{
             resolved: "resolved";
@@ -5563,6 +5592,7 @@ declare const ArtifactNamespace: _$_makaio_core0.BusNamespaceDefinition<"artifac
           data: z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>;
           relations: z.ZodArray<z.ZodObject<{
             type: z.ZodString;
+            sourceLocalId: z.ZodOptional<z.ZodString>;
             target: z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
               refClass: z.ZodLiteral<"artifact">;
               kind: z.ZodString;
@@ -5709,6 +5739,7 @@ declare const ArtifactNamespace: _$_makaio_core0.BusNamespaceDefinition<"artifac
       data: z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>;
       relations: z.ZodArray<z.ZodObject<{
         type: z.ZodString;
+        sourceLocalId: z.ZodOptional<z.ZodString>;
         target: z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
           refClass: z.ZodLiteral<"artifact">;
           kind: z.ZodString;
@@ -5859,6 +5890,7 @@ declare const ArtifactNamespace: _$_makaio_core0.BusNamespaceDefinition<"artifac
       data: z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>;
       relations: z.ZodArray<z.ZodObject<{
         type: z.ZodString;
+        sourceLocalId: z.ZodOptional<z.ZodString>;
         target: z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
           refClass: z.ZodLiteral<"artifact">;
           kind: z.ZodString;
@@ -5999,6 +6031,7 @@ declare const ArtifactNamespace: _$_makaio_core0.BusNamespaceDefinition<"artifac
     }, z.core.$strict>;
     relation: z.ZodObject<{
       type: z.ZodString;
+      sourceLocalId: z.ZodOptional<z.ZodString>;
       target: z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
         refClass: z.ZodLiteral<"artifact">;
         kind: z.ZodString;
@@ -6768,8 +6801,8 @@ declare const ArtifactSubjects$1: _$_makaio_core0.BusSubjects<_$_makaio_core0.Fl
   }; /** Create a new artifact and its first revision (RPC). */
   create: {
     request: z.ZodObject<{
-      kind: z.ZodString;
       data: z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>;
+      kind: z.ZodString;
       evidence: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
         source: z.ZodObject<{
           kind: z.ZodLiteral<"git-file">;
@@ -6830,6 +6863,7 @@ declare const ArtifactSubjects$1: _$_makaio_core0.BusSubjects<_$_makaio_core0.Fl
       }, z.core.$strip>;
       relations: z.ZodArray<z.ZodObject<{
         type: z.ZodString;
+        sourceLocalId: z.ZodOptional<z.ZodString>;
         target: z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
           refClass: z.ZodLiteral<"artifact">;
           kind: z.ZodString;
@@ -6920,6 +6954,7 @@ declare const ArtifactSubjects$1: _$_makaio_core0.BusSubjects<_$_makaio_core0.Fl
         data: z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>;
         relations: z.ZodArray<z.ZodObject<{
           type: z.ZodString;
+          sourceLocalId: z.ZodOptional<z.ZodString>;
           target: z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
             refClass: z.ZodLiteral<"artifact">;
             kind: z.ZodString;
@@ -7062,8 +7097,8 @@ declare const ArtifactSubjects$1: _$_makaio_core0.BusSubjects<_$_makaio_core0.Fl
       }, z.core.$strict>;
       statusPath: z.ZodOptional<z.ZodString>;
       revision: z.ZodObject<{
-        kind: z.ZodString;
         data: z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>;
+        kind: z.ZodString;
         evidence: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
           source: z.ZodObject<{
             kind: z.ZodLiteral<"git-file">;
@@ -7124,6 +7159,7 @@ declare const ArtifactSubjects$1: _$_makaio_core0.BusSubjects<_$_makaio_core0.Fl
         }, z.core.$strip>;
         relations: z.ZodArray<z.ZodObject<{
           type: z.ZodString;
+          sourceLocalId: z.ZodOptional<z.ZodString>;
           target: z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
             refClass: z.ZodLiteral<"artifact">;
             kind: z.ZodString;
@@ -7214,6 +7250,7 @@ declare const ArtifactSubjects$1: _$_makaio_core0.BusSubjects<_$_makaio_core0.Fl
         data: z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>;
         relations: z.ZodArray<z.ZodObject<{
           type: z.ZodString;
+          sourceLocalId: z.ZodOptional<z.ZodString>;
           target: z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
             refClass: z.ZodLiteral<"artifact">;
             kind: z.ZodString;
@@ -7490,6 +7527,7 @@ declare const ArtifactSubjects$1: _$_makaio_core0.BusSubjects<_$_makaio_core0.Fl
         data: z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>;
         relations: z.ZodArray<z.ZodObject<{
           type: z.ZodString;
+          sourceLocalId: z.ZodOptional<z.ZodString>;
           target: z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
             refClass: z.ZodLiteral<"artifact">;
             kind: z.ZodString;
@@ -7741,6 +7779,7 @@ declare const ArtifactSubjects$1: _$_makaio_core0.BusSubjects<_$_makaio_core0.Fl
         data: z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>;
         relations: z.ZodArray<z.ZodObject<{
           type: z.ZodString;
+          sourceLocalId: z.ZodOptional<z.ZodString>;
           target: z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
             refClass: z.ZodLiteral<"artifact">;
             kind: z.ZodString;
@@ -7901,6 +7940,7 @@ declare const ArtifactSubjects$1: _$_makaio_core0.BusSubjects<_$_makaio_core0.Fl
         data: z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>;
         relations: z.ZodArray<z.ZodObject<{
           type: z.ZodString;
+          sourceLocalId: z.ZodOptional<z.ZodString>;
           target: z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
             refClass: z.ZodLiteral<"artifact">;
             kind: z.ZodString;
@@ -8043,6 +8083,7 @@ declare const ArtifactSubjects$1: _$_makaio_core0.BusSubjects<_$_makaio_core0.Fl
         data: z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>;
         relations: z.ZodArray<z.ZodObject<{
           type: z.ZodString;
+          sourceLocalId: z.ZodOptional<z.ZodString>;
           target: z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
             refClass: z.ZodLiteral<"artifact">;
             kind: z.ZodString;
@@ -8335,6 +8376,7 @@ declare const ArtifactSubjects$1: _$_makaio_core0.BusSubjects<_$_makaio_core0.Fl
             revision: z.ZodString;
           }, z.core.$strict>;
           relationType: z.ZodString;
+          sourceLocalId: z.ZodOptional<z.ZodString>;
           hint: z.ZodString;
           status: z.ZodEnum<{
             resolved: "resolved";
@@ -8360,6 +8402,7 @@ declare const ArtifactSubjects$1: _$_makaio_core0.BusSubjects<_$_makaio_core0.Fl
           data: z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>;
           relations: z.ZodArray<z.ZodObject<{
             type: z.ZodString;
+            sourceLocalId: z.ZodOptional<z.ZodString>;
             target: z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
               refClass: z.ZodLiteral<"artifact">;
               kind: z.ZodString;
@@ -8506,6 +8549,7 @@ declare const ArtifactSubjects$1: _$_makaio_core0.BusSubjects<_$_makaio_core0.Fl
       data: z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>;
       relations: z.ZodArray<z.ZodObject<{
         type: z.ZodString;
+        sourceLocalId: z.ZodOptional<z.ZodString>;
         target: z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
           refClass: z.ZodLiteral<"artifact">;
           kind: z.ZodString;
@@ -8656,6 +8700,7 @@ declare const ArtifactSubjects$1: _$_makaio_core0.BusSubjects<_$_makaio_core0.Fl
       data: z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>;
       relations: z.ZodArray<z.ZodObject<{
         type: z.ZodString;
+        sourceLocalId: z.ZodOptional<z.ZodString>;
         target: z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
           refClass: z.ZodLiteral<"artifact">;
           kind: z.ZodString;
@@ -8796,6 +8841,7 @@ declare const ArtifactSubjects$1: _$_makaio_core0.BusSubjects<_$_makaio_core0.Fl
     }, z.core.$strict>;
     relation: z.ZodObject<{
       type: z.ZodString;
+      sourceLocalId: z.ZodOptional<z.ZodString>;
       target: z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
         refClass: z.ZodLiteral<"artifact">;
         kind: z.ZodString;
@@ -9533,6 +9579,35 @@ declare function checkArtifactPartIds(areas: readonly {
   path: string;
   idPath: string;
 }[], data: Record<string, unknown>): ArtifactDataIssue[];
+/**
+ * One relation source that does not identify exactly one declared part.
+ *
+ * `relationIndex` addresses the relation collection rather than artifact data:
+ * callers own the wire path used to present this issue.
+ */
+interface ArtifactRelationSourceIssue {
+  /** Zero-based index of the rejected relation. */
+  readonly relationIndex: number;
+  /** Why the local source identifier did not resolve uniquely. */
+  readonly reason: string;
+}
+/**
+ * Check that every locally sourced relation resolves uniquely in one revision.
+ *
+ * Relations without `sourceLocalId` belong to the whole artifact and need no
+ * part lookup. The supplied `data` is the containing revision's payload, so
+ * this helper intentionally accepts no independent source revision pin.
+ * @param areas - Declared part areas for the artifact kind.
+ * @param data - Payload of the revision that stores the relations.
+ * @param relations - Relations of that same revision, structurally typed to avoid import cycles.
+ * @returns One issue for each local source that does not resolve uniquely.
+ */
+declare function checkArtifactRelationSourceParts(areas: readonly {
+  path: string;
+  idPath: string;
+}[], data: Record<string, unknown>, relations: readonly {
+  readonly sourceLocalId?: string;
+}[]): ArtifactRelationSourceIssue[];
 /**
  * Stable failure classifications for a part-resolution rejection.
  *
@@ -11934,4 +12009,4 @@ declare function buildUniquenessKeys(rules: readonly ArtifactUniquenessRule[], r
  */
 declare function describeUniquenessKey(key: UniquenessKey): string;
 //#endregion
-export { ArtifactLifecycleTransitionedEntry as $, ArtifactDataCheck as $n, ArtifactCreateRequest as $t, ArtifactLifecycleSchemas as A, ArtifactResolvePartRequestSchema as An, EVIDENCE_VALUE_TYPE as Ar, ArtifactPatchSegment as At, ArtifactLifecycleIdentitySchema as B, ArtifactContextRefEntrySchema as Bn, ARTIFACT_RESOLVE_PART_ERROR_CODES as Bt, ArtifactLifecycleGetResponseSchema as C, ArtifactReviseRequest as Cn, EvidenceOccurrenceExtractionOptions as Cr, ArtifactPatchOperator as Ct, ArtifactLifecycleHistoryResponseSchema as D, ArtifactStatusChangedPayload as Dn, EvidenceResolveResponse as Dr, ArtifactPatchRequestSchema as Dt, ArtifactLifecycleHistoryResponse as E, ArtifactSchemas$1 as En, EvidenceResolveRequestSchema as Er, ArtifactPatchRequest as Et, ArtifactLifecycleCurrent as F, ArtifactContextRootNode as Fn, artifactPatchFilterName as Ft, ArtifactLifecycleSituation as G, ARTIFACT_CONTEXT_RENDER_HINTS as Gn, checkArtifactPartIds as Gt, ArtifactLifecycleInitializedEntrySchema as H, ArtifactContextUnresolvedReasonSchema as Hn, ArtifactResolvePartError as Ht, ArtifactLifecycleCurrentSchema as I, ArtifactContextTree as In, artifactPatchInstructions as It, ArtifactLifecycleSnapshotSchema as J, ArtifactContextRelationSelectorSchema as Jn, ARTIFACT_COLLECTION_ELEMENT_SEGMENT as Jt, ArtifactLifecycleSituationSchema as K, ArtifactContextKnownRenderHint as Kn, resolveArtifactPart as Kt, ArtifactLifecycleError as L, ResolvedArtifactContextNode as Ln, artifactPatchPathFilterNames as Lt, ArtifactLifecycleTransitionResponseSchema as M, ArtifactResolvePartResponseSchema as Mn, EvidenceValueSchema$1 as Mr, ArtifactPatchSuccessSchema as Mt, toArtifactLifecycleFailure as N, hydrateArtifactContextTree as Nn, ArtifactPatchTarget as Nt, ArtifactLifecycleRejectedPayload as O, ArtifactSubjects$1 as On, EvidenceResolveResponseSchema as Or, ArtifactPatchResponse as Ot, ARTIFACT_LIFECYCLE_REJECTED_CODE as P, ArtifactContextNode as Pn, ArtifactPatchTargetSchema as Pt, ArtifactLifecycleTransitionIntentSchema as Q, ArtifactContextSelectorSchema as Qn, readArtifactTitle as Qt, ArtifactLifecycleHistoryEntry as R, UnresolvedArtifactContextNode as Rn, artifactPatchSegment as Rt, ArtifactLifecycleGetResponse as S, ArtifactResolveResponse as Sn, EvidenceOccurrence as Sr, ArtifactPatchOperationResultSchema as St, ArtifactLifecycleHistoryRequestSchema as T, ArtifactRevisedPayload as Tn, EvidenceResolveRequest as Tr, ArtifactPatchPersistedSchema as Tt, ArtifactLifecycleRejection as U, ResolvedArtifactContextWire$1 as Un, ArtifactResolvePartErrorCode as Ut, ArtifactLifecycleInitializedEntry as V, ArtifactContextUnresolvedReason as Vn, ArtifactPartResolution as Vt, ArtifactLifecycleRejectionSchema as W, ResolvedArtifactContextWireSchema as Wn, ArtifactResolvePartErrorSchema as Wt, ArtifactLifecycleTransitionCommandSchema as X, ArtifactContextRenderHintSchema as Xn, inspectArtifactDataLocation as Xt, ArtifactLifecycleTransitionCommand as Y, ArtifactContextRenderHint as Yn, ArtifactSchemaFragment as Yt, ArtifactLifecycleTransitionIntent as Z, ArtifactContextSelector$1 as Zn, isArtifactDataPathDeclared as Zt, ArtifactLifecycleCommittedPayloadSchema as _, ArtifactRelationTypeRegisterRequest as _n, ArtifactLifecycleHookRegistration$1 as _r, ArtifactPatchIssue as _t, UniquenessKeyPart as a, ArtifactKindListRequest as an, AnyArtifactKindDefinition as ar, ARTIFACT_PATCH_ERROR_CODES as at, ArtifactLifecycleGetRequest as b, ArtifactResolveContextResponse as bn, BeforeArtifactHookRegistration as br, ArtifactPatchMigrationSchema as bt, assessUniquenessSupport as c, ArtifactKindRegisterResponse as cn, ArtifactOf as cr, ArtifactPatchArrayFilterSchema as ct, ArtifactRelationTargetIdentity as d, ArtifactPatchSubjectRequest as dn, AfterArtifactHookRegistration as dr, ArtifactPatchDryRunSchema as dt, ArtifactCreateResponse as en, ArtifactDataChecker as er, ArtifactLifecycleTransitionedEntrySchema as et, ArtifactRelationTargetIdentitySchema as f, ArtifactPatchSubjectResponse as fn, ArtifactDraft as fr, ArtifactPatchError as ft, ArtifactLifecycleCommittedPayload as g, ArtifactRelationTypeListResponse as gn, ArtifactLifecycleHookEvent as gr, ArtifactPatchInstruction as gt, serializeArtifactRelationTargetIdentity as h, ArtifactRelationTypeListRequest as hn, ArtifactLifecycleHookDefinition as hr, ArtifactPatchFailureSchema as ht, UniquenessKeyIssueReason as i, ArtifactKindChangedPayload as in, compileArtifactDataSchema as ir, isArtifactLifecycleTransitionAllowed as it, ArtifactLifecycleTransitionResponse as j, ArtifactResolvePartResponse as jn, EvidenceValue$1 as jr, ArtifactPatchSuccess as jt, ArtifactLifecycleRejectedPayloadSchema as k, ArtifactResolvePartRequest as kn, ARTIFACT_VALUE_TYPE_KEYWORD as kr, ArtifactPatchResponseSchema as kt, buildUniquenessKeys as l, ArtifactNamespace as ln, defineArtifactKind as lr, ArtifactPatchDocument as lt, describeArtifactRelationTargetIdentity as m, ArtifactRelationAddedPayload as mn, ArtifactHookFilter as mr, ArtifactPatchErrorSchema as mt, UniquenessKey as n, ArtifactEvidenceResolveRequest as nn, ArtifactDataValidator as nr, advanceArtifactLifecycle as nt, UniquenessSelectorCapability as o, ArtifactKindListResponse as on, ArtifactDataOf as or, ARTIFACT_PATCH_OPERATORS as ot, artifactRelationTargetIdentity as p, ArtifactQueryResponse as pn, ArtifactDraftPatch as pr, ArtifactPatchErrorCode as pt, ArtifactLifecycleSnapshot as q, ArtifactContextRelationSelector as qn, validateArtifactPartAreas as qt, UniquenessKeyIssue as r, ArtifactEvidenceResolveResponse$1 as rn, compileArtifactDataChecker as rr, initialArtifactLifecycle as rt, UniquenessSupportIssue as s, ArtifactKindRegisterRequest as sn, ArtifactKindDefinition as sr, ArtifactPatchArrayFilter as st, BuildUniquenessKeysResult as t, ArtifactCreatedPayload as tn, ArtifactDataIssue as tr, ArtifactLifecycleVersionSchema as tt, describeUniquenessKey as u, ArtifactObservationAddedPayload as un, AfterArtifactHookContext as ur, ArtifactPatchDocumentSchema as ut, ArtifactLifecycleFailure as v, ArtifactRelationTypeRegisterResponse as vn, ArtifactLifecycleSemanticEvent as vr, ArtifactPatchIssueSchema as vt, ArtifactLifecycleHistoryRequest as w, ArtifactReviseResponse as wn, extractEvidenceOccurrences as wr, ArtifactPatchPathSchema as wt, ArtifactLifecycleGetRequestSchema as x, ArtifactResolveRequest as xn, defineArtifactLifecycleHooks as xr, ArtifactPatchOperationResult as xt, ArtifactLifecycleFailureSchema as y, ArtifactResolveContextRequest as yn, BeforeArtifactHookContext as yr, ArtifactPatchMigration as yt, ArtifactLifecycleHistoryEntrySchema as z, ArtifactContextRefEntry as zn, artifactPatchSegments as zt };
+export { ArtifactLifecycleTransitionedEntry as $, ArtifactContextSelector$1 as $n, isArtifactDataPathDeclared as $t, ArtifactLifecycleSchemas as A, ArtifactSubjects$1 as An, EvidenceResolveResponseSchema as Ar, ArtifactPatchSegment as At, ArtifactLifecycleIdentitySchema as B, UnresolvedArtifactContextNode as Bn, ARTIFACT_RESOLVE_PART_ERROR_CODES as Bt, ArtifactLifecycleGetResponseSchema as C, ArtifactResolveRequest as Cn, defineArtifactLifecycleHooks as Cr, ArtifactPatchOperator as Ct, ArtifactLifecycleHistoryResponseSchema as D, ArtifactRevisedPayload as Dn, EvidenceResolveRequest as Dr, ArtifactPatchRequestSchema as Dt, ArtifactLifecycleHistoryResponse as E, ArtifactReviseResponse as En, extractEvidenceOccurrences as Er, ArtifactPatchRequest as Et, ArtifactLifecycleCurrent as F, hydrateArtifactContextTree as Fn, artifactPatchFilterName as Ft, ArtifactLifecycleSituation as G, ResolvedArtifactContextWire$1 as Gn, ArtifactResolvePartErrorSchema as Gt, ArtifactLifecycleInitializedEntrySchema as H, ArtifactContextRefEntrySchema as Hn, ArtifactRelationSourceIssue as Ht, ArtifactLifecycleCurrentSchema as I, ArtifactContextNode as In, artifactPatchInstructions as It, ArtifactLifecycleSnapshotSchema as J, ArtifactContextKnownRenderHint as Jn, resolveArtifactPart as Jt, ArtifactLifecycleSituationSchema as K, ResolvedArtifactContextWireSchema as Kn, checkArtifactPartIds as Kt, ArtifactLifecycleError as L, ArtifactContextRootNode as Ln, artifactPatchPathFilterNames as Lt, ArtifactLifecycleTransitionResponseSchema as M, ArtifactResolvePartRequestSchema as Mn, EVIDENCE_VALUE_TYPE as Mr, ArtifactPatchSuccessSchema as Mt, toArtifactLifecycleFailure as N, ArtifactResolvePartResponse as Nn, EvidenceValue$1 as Nr, ArtifactPatchTarget as Nt, ArtifactLifecycleRejectedPayload as O, ArtifactSchemas$1 as On, EvidenceResolveRequestSchema as Or, ArtifactPatchResponse as Ot, ARTIFACT_LIFECYCLE_REJECTED_CODE as P, ArtifactResolvePartResponseSchema as Pn, EvidenceValueSchema$1 as Pr, ArtifactPatchTargetSchema as Pt, ArtifactLifecycleTransitionIntentSchema as Q, ArtifactContextRenderHintSchema as Qn, inspectArtifactDataLocation as Qt, ArtifactLifecycleHistoryEntry as R, ArtifactContextTree as Rn, artifactPatchSegment as Rt, ArtifactLifecycleGetResponse as S, ArtifactResolveContextResponse as Sn, BeforeArtifactHookRegistration as Sr, ArtifactPatchOperationResultSchema as St, ArtifactLifecycleHistoryRequestSchema as T, ArtifactReviseRequest as Tn, EvidenceOccurrenceExtractionOptions as Tr, ArtifactPatchPersistedSchema as Tt, ArtifactLifecycleRejection as U, ArtifactContextUnresolvedReason as Un, ArtifactResolvePartError as Ut, ArtifactLifecycleInitializedEntry as V, ArtifactContextRefEntry as Vn, ArtifactPartResolution as Vt, ArtifactLifecycleRejectionSchema as W, ArtifactContextUnresolvedReasonSchema as Wn, ArtifactResolvePartErrorCode as Wt, ArtifactLifecycleTransitionCommandSchema as X, ArtifactContextRelationSelectorSchema as Xn, ARTIFACT_COLLECTION_ELEMENT_SEGMENT as Xt, ArtifactLifecycleTransitionCommand as Y, ArtifactContextRelationSelector as Yn, validateArtifactPartAreas as Yt, ArtifactLifecycleTransitionIntent as Z, ArtifactContextRenderHint as Zn, ArtifactSchemaFragment as Zt, ArtifactLifecycleCommittedPayloadSchema as _, ArtifactRelationTypeListRequest as _n, ArtifactLifecycleHookDefinition as _r, ArtifactPatchIssue as _t, UniquenessKeyPart as a, ArtifactEvidenceResolveResponse$1 as an, compileArtifactDataChecker as ar, ARTIFACT_PATCH_ERROR_CODES as at, ArtifactLifecycleGetRequest as b, ArtifactRelationTypeRegisterResponse as bn, ArtifactLifecycleSemanticEvent as br, ArtifactPatchMigrationSchema as bt, assessUniquenessSupport as c, ArtifactKindListResponse as cn, ArtifactDataOf as cr, ArtifactPatchArrayFilterSchema as ct, ArtifactRelationTargetIdentity as d, ArtifactNamespace as dn, defineArtifactKind as dr, ArtifactPatchDryRunSchema as dt, readArtifactTitle as en, ArtifactContextSelectorSchema as er, ArtifactLifecycleTransitionedEntrySchema as et, ArtifactRelationTargetIdentitySchema as f, ArtifactObservationAddedPayload as fn, AfterArtifactHookContext as fr, ArtifactPatchError as ft, ArtifactLifecycleCommittedPayload as g, ArtifactRelationAddedPayload as gn, ArtifactHookFilter as gr, ArtifactPatchInstruction as gt, serializeArtifactRelationTargetIdentity as h, ArtifactQueryResponse as hn, ArtifactDraftPatch as hr, ArtifactPatchFailureSchema as ht, UniquenessKeyIssueReason as i, ArtifactEvidenceResolveRequest as in, ArtifactDataValidator as ir, isArtifactLifecycleTransitionAllowed as it, ArtifactLifecycleTransitionResponse as j, ArtifactResolvePartRequest as jn, ARTIFACT_VALUE_TYPE_KEYWORD as jr, ArtifactPatchSuccess as jt, ArtifactLifecycleRejectedPayloadSchema as k, ArtifactStatusChangedPayload as kn, EvidenceResolveResponse as kr, ArtifactPatchResponseSchema as kt, buildUniquenessKeys as l, ArtifactKindRegisterRequest as ln, ArtifactKindDefinition as lr, ArtifactPatchDocument as lt, describeArtifactRelationTargetIdentity as m, ArtifactPatchSubjectResponse as mn, ArtifactDraft as mr, ArtifactPatchErrorSchema as mt, UniquenessKey as n, ArtifactCreateResponse as nn, ArtifactDataChecker as nr, advanceArtifactLifecycle as nt, UniquenessSelectorCapability as o, ArtifactKindChangedPayload as on, compileArtifactDataSchema as or, ARTIFACT_PATCH_OPERATORS as ot, artifactRelationTargetIdentity as p, ArtifactPatchSubjectRequest as pn, AfterArtifactHookRegistration as pr, ArtifactPatchErrorCode as pt, ArtifactLifecycleSnapshot as q, ARTIFACT_CONTEXT_RENDER_HINTS as qn, checkArtifactRelationSourceParts as qt, UniquenessKeyIssue as r, ArtifactCreatedPayload as rn, ArtifactDataIssue as rr, initialArtifactLifecycle as rt, UniquenessSupportIssue as s, ArtifactKindListRequest as sn, AnyArtifactKindDefinition as sr, ArtifactPatchArrayFilter as st, BuildUniquenessKeysResult as t, ArtifactCreateRequest as tn, ArtifactDataCheck as tr, ArtifactLifecycleVersionSchema as tt, describeUniquenessKey as u, ArtifactKindRegisterResponse as un, ArtifactOf as ur, ArtifactPatchDocumentSchema as ut, ArtifactLifecycleFailure as v, ArtifactRelationTypeListResponse as vn, ArtifactLifecycleHookEvent as vr, ArtifactPatchIssueSchema as vt, ArtifactLifecycleHistoryRequest as w, ArtifactResolveResponse as wn, EvidenceOccurrence as wr, ArtifactPatchPathSchema as wt, ArtifactLifecycleGetRequestSchema as x, ArtifactResolveContextRequest as xn, BeforeArtifactHookContext as xr, ArtifactPatchOperationResult as xt, ArtifactLifecycleFailureSchema as y, ArtifactRelationTypeRegisterRequest as yn, ArtifactLifecycleHookRegistration$1 as yr, ArtifactPatchMigration as yt, ArtifactLifecycleHistoryEntrySchema as z, ResolvedArtifactContextNode as zn, artifactPatchSegments as zt };