@lumenflow/core 4.23.0 → 5.0.0

package/dist/delegation-registry-schema.d.ts

@@ -1,40 +1,27 @@
 /// <reference path="./types.d.ts" />
 import { z } from 'zod';
-/**
- * Delegation status values.
- */
 export declare const DelegationStatus: {
     readonly PENDING: "pending";
-    readonly COMPLETED: string;
+    readonly COMPLETED: "completed";
     readonly TIMEOUT: "timeout";
     readonly CRASHED: "crashed";
     readonly ESCALATED: "escalated";
 };
-/** Type for delegation status values */
 export type DelegationStatusValue = (typeof DelegationStatus)[keyof typeof DelegationStatus];
-/** Array of valid delegation statuses */
-export declare const DELEGATION_STATUSES: readonly ["pending", string, "timeout", "crashed", "escalated"];
-/**
- * Optional delegation intent source values.
- */
+export declare const DELEGATION_STATUSES: readonly ["pending", "completed", "timeout", "crashed", "escalated"];
 export declare const DelegationIntent: {
     readonly DELEGATION: "delegation";
     readonly LEGACY_SPAWN: "legacy-spawn";
 };
-/** Type for delegation intent values */
 export type DelegationIntentValue = (typeof DelegationIntent)[keyof typeof DelegationIntent];
-/** Array of valid delegation intent values */
 export declare const DELEGATION_INTENTS: readonly ["delegation", "legacy-spawn"];
-/**
- * Regex patterns for delegation validation.
- */
 export declare const DELEGATION_PATTERNS: {
     DELEGATION_ID: RegExp;
     WU_ID: RegExp;
 };
-/**
- * Optional wu:brief prompt attestation captured by wu:delegate.
- */
+export declare const DELEGATION_SCHEMA_VERSION_V2: "v2";
+export declare const DELEGATION_SCHEMA_VERSIONS: readonly ["v2"];
+export type DelegationSchemaVersion = (typeof DELEGATION_SCHEMA_VERSIONS)[number];
 export declare const DelegationBriefAttestationSchema: z.ZodObject<{
     algorithm: z.ZodLiteral<"sha256">;
     promptHash: z.ZodString;
@@ -42,10 +29,67 @@ export declare const DelegationBriefAttestationSchema: z.ZodObject<{
     generatedAt: z.ZodString;
     clientName: z.ZodString;
 }, z.core.$strip>;
-/**
- * Delegation event schema.
- */
-export declare const DelegationEventSchema: z.ZodObject<{
+export declare const DelegationRoleDescriptorSchema: z.ZodObject<{
+    lifecycle_role: z.ZodString;
+    specialty_profile: z.ZodString;
+    role_alias: z.ZodOptional<z.ZodString>;
+    capabilities: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export declare const DelegationOwnershipScopeSchema: z.ZodObject<{
+    initiative_id: z.ZodOptional<z.ZodString>;
+    wu_ids: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    lane: z.ZodOptional<z.ZodString>;
+    responsibility_kinds: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+declare const DelegationEventV1Schema: z.ZodObject<{
+    id: z.ZodString;
+    parentWuId: z.ZodString;
+    targetWuId: z.ZodString;
+    lane: z.ZodString;
+    intent: z.ZodOptional<z.ZodEnum<{
+        delegation: "delegation";
+        "legacy-spawn": "legacy-spawn";
+    }>>;
+    delegatedAt: z.ZodString;
+    status: z.ZodEnum<{
+        timeout: "timeout";
+        completed: "completed";
+        pending: "pending";
+        crashed: "crashed";
+        escalated: "escalated";
+    }>;
+    completedAt: z.ZodNullable<z.ZodString>;
+    pickedUpAt: z.ZodOptional<z.ZodString>;
+    pickedUpBy: z.ZodOptional<z.ZodString>;
+    briefAttestation: z.ZodOptional<z.ZodObject<{
+        algorithm: z.ZodLiteral<"sha256">;
+        promptHash: z.ZodString;
+        promptLength: z.ZodNumber;
+        generatedAt: z.ZodString;
+        clientName: z.ZodString;
+    }, z.core.$strip>>;
+    schemaVersion: z.ZodOptional<z.ZodUndefined>;
+    requested_role: z.ZodOptional<z.ZodObject<{
+        lifecycle_role: z.ZodString;
+        specialty_profile: z.ZodString;
+        role_alias: z.ZodOptional<z.ZodString>;
+        capabilities: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>;
+    actual_role: z.ZodOptional<z.ZodObject<{
+        lifecycle_role: z.ZodString;
+        specialty_profile: z.ZodString;
+        role_alias: z.ZodOptional<z.ZodString>;
+        capabilities: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>;
+    capabilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    ownership_scope: z.ZodOptional<z.ZodObject<{
+        initiative_id: z.ZodOptional<z.ZodString>;
+        wu_ids: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        lane: z.ZodOptional<z.ZodString>;
+        responsibility_kinds: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+declare const DelegationEventV2Schema: z.ZodObject<{
     id: z.ZodString;
     parentWuId: z.ZodString;
     targetWuId: z.ZodString;
@@ -56,7 +100,11 @@ export declare const DelegationEventSchema: z.ZodObject<{
     }>>;
     delegatedAt: z.ZodString;
     status: z.ZodEnum<{
-        [x: string]: string;
+        timeout: "timeout";
+        completed: "completed";
+        pending: "pending";
+        crashed: "crashed";
+        escalated: "escalated";
     }>;
     completedAt: z.ZodNullable<z.ZodString>;
     pickedUpAt: z.ZodOptional<z.ZodString>;
@@ -68,21 +116,200 @@ export declare const DelegationEventSchema: z.ZodObject<{
         generatedAt: z.ZodString;
         clientName: z.ZodString;
     }, z.core.$strip>>;
+    schemaVersion: z.ZodLiteral<"v2">;
+    requested_role: z.ZodObject<{
+        lifecycle_role: z.ZodString;
+        specialty_profile: z.ZodString;
+        role_alias: z.ZodOptional<z.ZodString>;
+        capabilities: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>;
+    actual_role: z.ZodObject<{
+        lifecycle_role: z.ZodString;
+        specialty_profile: z.ZodString;
+        role_alias: z.ZodOptional<z.ZodString>;
+        capabilities: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>;
+    capabilities: z.ZodArray<z.ZodString>;
+    ownership_scope: z.ZodObject<{
+        initiative_id: z.ZodOptional<z.ZodString>;
+        wu_ids: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        lane: z.ZodOptional<z.ZodString>;
+        responsibility_kinds: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>;
 }, z.core.$strip>;
-/** TypeScript type inferred from schema */
+export declare const DelegationEventSchema: z.ZodUnion<readonly [z.ZodObject<{
+    id: z.ZodString;
+    parentWuId: z.ZodString;
+    targetWuId: z.ZodString;
+    lane: z.ZodString;
+    intent: z.ZodOptional<z.ZodEnum<{
+        delegation: "delegation";
+        "legacy-spawn": "legacy-spawn";
+    }>>;
+    delegatedAt: z.ZodString;
+    status: z.ZodEnum<{
+        timeout: "timeout";
+        completed: "completed";
+        pending: "pending";
+        crashed: "crashed";
+        escalated: "escalated";
+    }>;
+    completedAt: z.ZodNullable<z.ZodString>;
+    pickedUpAt: z.ZodOptional<z.ZodString>;
+    pickedUpBy: z.ZodOptional<z.ZodString>;
+    briefAttestation: z.ZodOptional<z.ZodObject<{
+        algorithm: z.ZodLiteral<"sha256">;
+        promptHash: z.ZodString;
+        promptLength: z.ZodNumber;
+        generatedAt: z.ZodString;
+        clientName: z.ZodString;
+    }, z.core.$strip>>;
+    schemaVersion: z.ZodLiteral<"v2">;
+    requested_role: z.ZodObject<{
+        lifecycle_role: z.ZodString;
+        specialty_profile: z.ZodString;
+        role_alias: z.ZodOptional<z.ZodString>;
+        capabilities: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>;
+    actual_role: z.ZodObject<{
+        lifecycle_role: z.ZodString;
+        specialty_profile: z.ZodString;
+        role_alias: z.ZodOptional<z.ZodString>;
+        capabilities: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>;
+    capabilities: z.ZodArray<z.ZodString>;
+    ownership_scope: z.ZodObject<{
+        initiative_id: z.ZodOptional<z.ZodString>;
+        wu_ids: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        lane: z.ZodOptional<z.ZodString>;
+        responsibility_kinds: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    parentWuId: z.ZodString;
+    targetWuId: z.ZodString;
+    lane: z.ZodString;
+    intent: z.ZodOptional<z.ZodEnum<{
+        delegation: "delegation";
+        "legacy-spawn": "legacy-spawn";
+    }>>;
+    delegatedAt: z.ZodString;
+    status: z.ZodEnum<{
+        timeout: "timeout";
+        completed: "completed";
+        pending: "pending";
+        crashed: "crashed";
+        escalated: "escalated";
+    }>;
+    completedAt: z.ZodNullable<z.ZodString>;
+    pickedUpAt: z.ZodOptional<z.ZodString>;
+    pickedUpBy: z.ZodOptional<z.ZodString>;
+    briefAttestation: z.ZodOptional<z.ZodObject<{
+        algorithm: z.ZodLiteral<"sha256">;
+        promptHash: z.ZodString;
+        promptLength: z.ZodNumber;
+        generatedAt: z.ZodString;
+        clientName: z.ZodString;
+    }, z.core.$strip>>;
+    schemaVersion: z.ZodOptional<z.ZodUndefined>;
+    requested_role: z.ZodOptional<z.ZodObject<{
+        lifecycle_role: z.ZodString;
+        specialty_profile: z.ZodString;
+        role_alias: z.ZodOptional<z.ZodString>;
+        capabilities: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>;
+    actual_role: z.ZodOptional<z.ZodObject<{
+        lifecycle_role: z.ZodString;
+        specialty_profile: z.ZodString;
+        role_alias: z.ZodOptional<z.ZodString>;
+        capabilities: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>;
+    capabilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    ownership_scope: z.ZodOptional<z.ZodObject<{
+        initiative_id: z.ZodOptional<z.ZodString>;
+        wu_ids: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        lane: z.ZodOptional<z.ZodString>;
+        responsibility_kinds: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>]>;
 export type DelegationEvent = z.infer<typeof DelegationEventSchema>;
+export type DelegationEventV1 = z.infer<typeof DelegationEventV1Schema>;
+export type DelegationEventV2 = z.infer<typeof DelegationEventV2Schema>;
 export type DelegationBriefAttestation = z.infer<typeof DelegationBriefAttestationSchema>;
-/**
- * Validates delegation event data against schema.
- */
+export type DelegationRoleDescriptor = z.infer<typeof DelegationRoleDescriptorSchema>;
+export type DelegationOwnershipScope = z.infer<typeof DelegationOwnershipScopeSchema>;
+export interface DelegationRoleContract {
+    requested_role: DelegationRoleDescriptor;
+    actual_role: DelegationRoleDescriptor;
+    capabilities: string[];
+    ownership_scope: DelegationOwnershipScope;
+}
 export declare function validateDelegationEvent(data: unknown): z.ZodSafeParseResult<{
     id: string;
     parentWuId: string;
     targetWuId: string;
     lane: string;
     delegatedAt: string;
-    status: string;
+    status: "timeout" | "completed" | "pending" | "crashed" | "escalated";
+    completedAt: string | null;
+    intent?: "delegation" | "legacy-spawn" | undefined;
+    pickedUpAt?: string | undefined;
+    pickedUpBy?: string | undefined;
+    briefAttestation?: {
+        algorithm: "sha256";
+        promptHash: string;
+        promptLength: number;
+        generatedAt: string;
+        clientName: string;
+    } | undefined;
+    schemaVersion?: undefined;
+    requested_role?: {
+        lifecycle_role: string;
+        specialty_profile: string;
+        capabilities: string[];
+        role_alias?: string | undefined;
+    } | undefined;
+    actual_role?: {
+        lifecycle_role: string;
+        specialty_profile: string;
+        capabilities: string[];
+        role_alias?: string | undefined;
+    } | undefined;
+    capabilities?: string[] | undefined;
+    ownership_scope?: {
+        responsibility_kinds: string[];
+        initiative_id?: string | undefined;
+        wu_ids?: string[] | undefined;
+        lane?: string | undefined;
+    } | undefined;
+} | {
+    id: string;
+    parentWuId: string;
+    targetWuId: string;
+    lane: string;
+    delegatedAt: string;
+    status: "timeout" | "completed" | "pending" | "crashed" | "escalated";
     completedAt: string | null;
+    schemaVersion: "v2";
+    requested_role: {
+        lifecycle_role: string;
+        specialty_profile: string;
+        capabilities: string[];
+        role_alias?: string | undefined;
+    };
+    actual_role: {
+        lifecycle_role: string;
+        specialty_profile: string;
+        capabilities: string[];
+        role_alias?: string | undefined;
+    };
+    capabilities: string[];
+    ownership_scope: {
+        responsibility_kinds: string[];
+        initiative_id?: string | undefined;
+        wu_ids?: string[] | undefined;
+        lane?: string | undefined;
+    };
     intent?: "delegation" | "legacy-spawn" | undefined;
     pickedUpAt?: string | undefined;
     pickedUpBy?: string | undefined;
@@ -94,8 +321,7 @@ export declare function validateDelegationEvent(data: unknown): z.ZodSafeParseRe
         clientName: string;
     } | undefined;
 }>;
-/**
- * Generates a unique delegation ID.
- */
+export declare function isV2DelegationEvent(event: DelegationEvent): event is DelegationEventV2;
 export declare function generateDelegationId(parentWuId: string, targetWuId: string): string;
+export {};
 //# sourceMappingURL=delegation-registry-schema.d.ts.map

package/dist/delegation-registry-schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"delegation-registry-schema.d.ts","sourceRoot":"","sources":["../src/delegation-registry-schema.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;;CAMnB,CAAC;AAEX,wCAAwC;AACxC,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,OAAO,gBAAgB,CAAC,CAAC;AAE7F,yCAAyC;AACzC,eAAO,MAAM,mBAAmB,iEAMtB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;CAGnB,CAAC;AAEX,wCAAwC;AACxC,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,OAAO,gBAAgB,CAAC,CAAC;AAE7F,8CAA8C;AAC9C,eAAO,MAAM,kBAAkB,yCAGrB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;CAG/B,CAAC;AAoBF;;GAEG;AACH,eAAO,MAAM,gCAAgC;;;;;;iBAM3C,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;iBAchC,CAAC;AAEH,2CAA2C;AAC3C,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAC;AAE1F;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,OAAO;;;;;;;;;;;;;;;;;;GAEpD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAMnF"}
+{"version":3,"file":"delegation-registry-schema.d.ts","sourceRoot":"","sources":["../src/delegation-registry-schema.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,gBAAgB;;;;;;CAMnB,CAAC;AAEX,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,OAAO,gBAAgB,CAAC,CAAC;AAE7F,eAAO,MAAM,mBAAmB,sEAMtB,CAAC;AAEX,eAAO,MAAM,gBAAgB;;;CAGnB,CAAC;AAEX,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,OAAO,gBAAgB,CAAC,CAAC;AAE7F,eAAO,MAAM,kBAAkB,yCAGrB,CAAC;AAEX,eAAO,MAAM,mBAAmB;;;CAG/B,CAAC;AAEF,eAAO,MAAM,4BAA4B,EAAG,IAAa,CAAC;AAC1D,eAAO,MAAM,0BAA0B,iBAA0C,CAAC;AAElF,MAAM,MAAM,uBAAuB,GAAG,CAAC,OAAO,0BAA0B,CAAC,CAAC,MAAM,CAAC,CAAC;AAkBlF,eAAO,MAAM,gCAAgC;;;;;;iBAM3C,CAAC;AAEH,eAAO,MAAM,8BAA8B;;;;;iBAKzC,CAAC;AAEH,eAAO,MAAM,8BAA8B;;;;;iBAKzC,CAAC;AAkBH,QAAA,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAM3B,CAAC;AAEH,QAAA,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAM3B,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mBAA8D,CAAC;AAEjG,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACxE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACxE,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAC;AAC1F,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AACtF,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAEtF,MAAM,WAAW,sBAAsB;IACrC,cAAc,EAAE,wBAAwB,CAAC;IACzC,WAAW,EAAE,wBAAwB,CAAC;IACtC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,eAAe,EAAE,wBAAwB,CAAC;CAC3C;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAEpD;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,eAAe,GAAG,KAAK,IAAI,iBAAiB,CAEtF;AAED,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAMnF"}

package/dist/delegation-registry-schema.js

@@ -1,24 +1,23 @@
 // Copyright (c) 2026 Hellmai Ltd
 // SPDX-License-Identifier: AGPL-3.0-only
 /**
- * Delegation Registry Schema (WU-1674)
+ * Delegation Registry Schema compatibility surface.
  *
- * Canonical delegation schema and helpers for delegation lifecycle records.
+ * Core keeps a local copy of the delegation schema so legacy
+ * `@lumenflow/core/*` consumers keep working even when sibling pack `dist/`
+ * artifacts are not present in a workspace checkout.
  */
 import crypto from 'node:crypto';
 import { z } from 'zod';
-import { WU_STATUS } from './wu-constants.js';
-/**
- * Delegation status values.
- */
+const DELEGATION_STATUS_COMPLETED = 'completed';
+const GENERATED_DELEGATION_HEX_LENGTH = 8;
 export const DelegationStatus = {
     PENDING: 'pending',
-    COMPLETED: WU_STATUS.COMPLETED,
+    COMPLETED: DELEGATION_STATUS_COMPLETED,
     TIMEOUT: 'timeout',
     CRASHED: 'crashed',
     ESCALATED: 'escalated',
 };
-/** Array of valid delegation statuses */
 export const DELEGATION_STATUSES = [
     DelegationStatus.PENDING,
     DelegationStatus.COMPLETED,
@@ -26,30 +25,22 @@ export const DELEGATION_STATUSES = [
     DelegationStatus.CRASHED,
     DelegationStatus.ESCALATED,
 ];
-/**
- * Optional delegation intent source values.
- */
 export const DelegationIntent = {
     DELEGATION: 'delegation',
     LEGACY_SPAWN: 'legacy-spawn',
 };
-/** Array of valid delegation intent values */
 export const DELEGATION_INTENTS = [
     DelegationIntent.DELEGATION,
     DelegationIntent.LEGACY_SPAWN,
 ];
-/**
- * Regex patterns for delegation validation.
- */
 export const DELEGATION_PATTERNS = {
-    DELEGATION_ID: /^dlg-[0-9a-f]{4}$/,
+    DELEGATION_ID: /^dlg-(?:[0-9a-f]{4}|[0-9a-f]{8,})$/,
     WU_ID: /^WU-\d+$/,
 };
-/**
- * Error messages for schema validation.
- */
+export const DELEGATION_SCHEMA_VERSION_V2 = 'v2';
+export const DELEGATION_SCHEMA_VERSIONS = [DELEGATION_SCHEMA_VERSION_V2];
 const ERROR_MESSAGES = {
-    DELEGATION_ID: 'Delegation ID must match pattern dlg-XXXX (e.g., dlg-a1b2)',
+    DELEGATION_ID: 'Delegation ID must match pattern dlg-XXXX or dlg-XXXXXXXX (e.g., dlg-a1b2, dlg-a1b2c3d4)',
     WU_ID: 'WU ID must match pattern WU-XXX (e.g., WU-1000)',
     LANE_REQUIRED: 'Lane is required',
     STATUS: `Status must be one of: ${DELEGATION_STATUSES.join(', ')}`,
@@ -61,9 +52,6 @@ const ERROR_MESSAGES = {
     BRIEF_CLIENT_REQUIRED: 'briefAttestation.clientName must be a non-empty string',
 };
 const SHA256_HEX_256_REGEX = /^[a-f0-9]{64}$/;
-/**
- * Optional wu:brief prompt attestation captured by wu:delegate.
- */
 export const DelegationBriefAttestationSchema = z.object({
     algorithm: z.literal('sha256', { error: ERROR_MESSAGES.BRIEF_ALGORITHM }),
     promptHash: z.string().regex(SHA256_HEX_256_REGEX, { message: ERROR_MESSAGES.BRIEF_HASH }),
@@ -71,10 +59,19 @@ export const DelegationBriefAttestationSchema = z.object({
     generatedAt: z.string().datetime({ message: ERROR_MESSAGES.TIMESTAMP_REQUIRED }),
     clientName: z.string().min(1, { message: ERROR_MESSAGES.BRIEF_CLIENT_REQUIRED }),
 });
-/**
- * Delegation event schema.
- */
-export const DelegationEventSchema = z.object({
+export const DelegationRoleDescriptorSchema = z.object({
+    lifecycle_role: z.string().min(1, { message: 'lifecycle_role must be non-empty' }),
+    specialty_profile: z.string().min(1, { message: 'specialty_profile must be non-empty' }),
+    role_alias: z.string().min(1).optional(),
+    capabilities: z.array(z.string()),
+});
+export const DelegationOwnershipScopeSchema = z.object({
+    initiative_id: z.string().min(1).optional(),
+    wu_ids: z.array(z.string().min(1)).optional(),
+    lane: z.string().min(1).optional(),
+    responsibility_kinds: z.array(z.string().min(1)),
+});
+const DelegationEventBaseSchema = z.object({
     id: z.string().regex(DELEGATION_PATTERNS.DELEGATION_ID, {
         message: ERROR_MESSAGES.DELEGATION_ID,
     }),
@@ -89,20 +86,32 @@ export const DelegationEventSchema = z.object({
     pickedUpBy: z.string().min(1, { message: ERROR_MESSAGES.PICKUP_BY_REQUIRED }).optional(),
     briefAttestation: DelegationBriefAttestationSchema.optional(),
 });
-/**
- * Validates delegation event data against schema.
- */
+const DelegationEventV1Schema = DelegationEventBaseSchema.extend({
+    schemaVersion: z.undefined().optional(),
+    requested_role: DelegationRoleDescriptorSchema.optional(),
+    actual_role: DelegationRoleDescriptorSchema.optional(),
+    capabilities: z.array(z.string()).optional(),
+    ownership_scope: DelegationOwnershipScopeSchema.optional(),
+});
+const DelegationEventV2Schema = DelegationEventBaseSchema.extend({
+    schemaVersion: z.literal(DELEGATION_SCHEMA_VERSION_V2),
+    requested_role: DelegationRoleDescriptorSchema,
+    actual_role: DelegationRoleDescriptorSchema,
+    capabilities: z.array(z.string()),
+    ownership_scope: DelegationOwnershipScopeSchema,
+});
+export const DelegationEventSchema = z.union([DelegationEventV2Schema, DelegationEventV1Schema]);
 export function validateDelegationEvent(data) {
     return DelegationEventSchema.safeParse(data);
 }
-/**
- * Generates a unique delegation ID.
- */
+export function isV2DelegationEvent(event) {
+    return event.schemaVersion === DELEGATION_SCHEMA_VERSION_V2;
+}
 export function generateDelegationId(parentWuId, targetWuId) {
     const timestamp = Date.now().toString();
     const randomBytes = crypto.randomBytes(4).toString('hex');
     const input = `${parentWuId}:${targetWuId}:${timestamp}:${randomBytes}`;
     const hash = crypto.createHash('sha256').update(input).digest('hex');
-    return `dlg-${hash.slice(0, 4)}`;
+    return `dlg-${hash.slice(0, GENERATED_DELEGATION_HEX_LENGTH)}`;
 }
 //# sourceMappingURL=delegation-registry-schema.js.map

package/dist/delegation-registry-schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"delegation-registry-schema.js","sourceRoot":"","sources":["../src/delegation-registry-schema.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"delegation-registry-schema.js","sourceRoot":"","sources":["../src/delegation-registry-schema.ts"],"names":[],"mappings":"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"}

package/dist/delegation-registry-store.d.ts

@@ -1,147 +1,23 @@
 /// <reference path="./types.d.ts" />
-import { type DelegationEvent, type DelegationBriefAttestation, type DelegationIntentValue } from './delegation-registry-schema.js';
-/** Delegation registry file name constant */
+import { type DelegationEvent, type DelegationBriefAttestation, type DelegationIntentValue, type DelegationRoleContract } from './delegation-registry-schema.js';
 export declare const DELEGATION_REGISTRY_FILE_NAME = "delegation-registry.jsonl";
-/**
- * Delegation Registry Store class
- *
- * Manages delegation registry state via event sourcing pattern.
- * Events are appended to JSONL file, state is rebuilt by replaying events.
- */
 export declare class DelegationRegistryStore {
     private readonly baseDir;
     private readonly registryFilePath;
     private readonly delegations;
     private readonly byParent;
     private readonly byTarget;
-    /**
-     * @param {string} baseDir - Directory containing .lumenflow/state/
-     */
     constructor(baseDir: string);
-    /**
-     * Loads and replays events from JSONL file into current state.
-     *
-     * Handles:
-     * - Missing file: returns empty state
-     * - Empty file: returns empty state
-     * - Empty lines: skipped gracefully
-     * - Malformed JSON: throws error with line info
-     * - Invalid events: throws validation error
-     *
-     * @returns {Promise<void>}
-     * @throws {Error} If file contains malformed JSON or invalid events
-     *
-     * @example
-     * const store = new DelegationRegistryStore('/path/to/project');
-     * await store.load();
-     * const pending = store.getPendingDelegations();
-     */
     load(): Promise<void>;
-    /**
-     * Applies an event to the in-memory state.
-     * If event for same delegation ID exists, updates it (latest wins).
-     *
-     * @private
-     */
-    private _applyEvent;
-    /**
-     * Appends an event to the registry file.
-     *
-     * Uses append mode to avoid full file rewrite.
-     * Creates file and parent directories if they don't exist.
-     * Validates event before appending.
-     *
-     * @private
-     * @throws {Error} If event fails validation
-     */
-    private _appendEvent;
-    /**
-     * Records a new delegation event with pending status.
-     *
-     * @param {string} parentWuId - Parent WU ID (orchestrator)
-     * @param {string} targetWuId - Target WU ID (delegated work)
-     * @param {string} lane - Lane for the delegated work
-     * @param {DelegationIntentValue} [intent] - Optional intent source (e.g., delegation)
-     * @param {string} [delegationId] - Optional pre-generated delegation ID
-     * @returns {Promise<string>} The generated delegation ID
-     * @throws {Error} If validation fails
-     *
-     * @example
-     * const delegationId = await store.record('WU-1000', 'WU-1001', 'Operations: Tooling');
-     */
-    record(parentWuId: string, targetWuId: string, lane: string, intent?: DelegationIntentValue, briefAttestation?: DelegationBriefAttestation, delegationId?: string): Promise<string>;
-    /**
-     * Updates the status of a delegation.
-     *
-     * @param {string} delegationId - Delegation ID to update
-     * @param {string} status - New status
-     * @returns {Promise<void>}
-     * @throws {Error} If delegation ID not found
-     *
-     * @example
-     * await store.updateStatus('dlg-a1b2', 'completed');
-     */
+    private applyEvent;
+    private appendEvent;
+    record(parentWuId: string, targetWuId: string, lane: string, intent?: DelegationIntentValue, briefAttestation?: DelegationBriefAttestation, delegationId?: string, roleContract?: DelegationRoleContract): Promise<string>;
     updateStatus(delegationId: string, status: string): Promise<void>;
-    /**
-     * Records claim-time pickup evidence for a delegation entry.
-     *
-     * WU-1605: This distinguishes intent-only delegation records from
-     * delegated work that was actually picked up via wu:claim.
-     *
-     * @param {string} delegationId - Delegation ID to update
-     * @param {string} pickedUpBy - Agent identity that claimed the target WU
-     * @param {string} [pickedUpAt] - Optional ISO timestamp (defaults to now)
-     * @returns {Promise<void>}
-     * @throws {Error} If delegation ID not found
-     */
     recordPickup(delegationId: string, pickedUpBy: string, pickedUpAt?: string): Promise<void>;
-    /**
-     * Gets all delegations for a parent WU.
-     *
-     * @param {string} parentWuId - Parent WU ID
-     * @returns {DelegationEvent[]} Array of delegation events
-     *
-     * @example
-     * const delegations = store.getByParent('WU-1000');
-     */
     getByParent(parentWuId: string): DelegationEvent[];
-    /**
-     * Gets delegation for a target WU.
-     *
-     * @param {string} targetWuId - Target WU ID
-     * @returns {DelegationEvent | null} Delegation event or null
-     *
-     * @example
-     * const delegation = store.getByTarget('WU-1001');
-     */
     getByTarget(targetWuId: string): DelegationEvent | null;
-    /**
-     * Gets all pending delegations.
-     *
-     * @returns {DelegationEvent[]} Array of pending delegation events
-     *
-     * @example
-     * const pending = store.getPendingDelegations();
-     */
     getPendingDelegations(): DelegationEvent[];
-    /**
-     * Gets all delegations as an array.
-     *
-     * @returns {DelegationEvent[]} Array of all delegation events
-     *
-     * @example
-     * const allDelegations = store.getAllDelegations();
-     */
     getAllDelegations(): DelegationEvent[];
-    /**
-     * Gets delegation by ID.
-     *
-     * @param {string} delegationId - Delegation ID
-     * @returns {DelegationEvent | null} Delegation event or null
-     *
-     * @example
-     * const delegation = store.getById('dlg-a1b2');
-     */
     getById(delegationId: string): DelegationEvent | null;
 }
 //# sourceMappingURL=delegation-registry-store.d.ts.map