@lumenflow/core 3.1.3 → 3.2.1

package/dist/wu-state-schema.d.ts

@@ -0,0 +1,253 @@
+/**
+ * WU State Schema (WU-1570)
+ *
+ * Zod schemas for WU state event validation.
+ * Defines event types for WU lifecycle: create, claim, block, unblock, complete.
+ *
+ * @see {@link packages/@lumenflow/cli/src/lib/__tests__/wu-state-store.test.ts} - Tests
+ */
+import { z } from 'zod';
+/**
+ * WU event types
+ *
+ * - create: WU created (transitions to ready)
+ * - claim: WU claimed (transitions to in_progress)
+ * - block: WU blocked (transitions to blocked)
+ * - unblock: WU unblocked (transitions back to in_progress)
+ * - complete: WU completed (transitions to done)
+ * - checkpoint: Progress checkpoint (WU-1748: cross-agent visibility)
+ * - delegation: WU delegated from parent (WU-1947: parent-child relationships)
+ * - release: WU released (WU-1080: transitions from in_progress to ready for orphan recovery)
+ */
+export declare const WU_EVENT_TYPES: readonly ["create", "claim", "block", "unblock", "complete", "checkpoint", "delegation", "release"];
+/** Type for WU event types */
+export type WUEventType = (typeof WU_EVENT_TYPES)[number];
+/**
+ * WU Event Type constant object (WU-2044)
+ *
+ * Named constants for event type strings, analogous to WU_STATUS.
+ * Use WU_EVENT_TYPE.CLAIM instead of raw 'claim' strings.
+ */
+export declare const WU_EVENT_TYPE: Readonly<{
+    CREATE: "create";
+    CLAIM: "claim";
+    BLOCK: "block";
+    UNBLOCK: "unblock";
+    COMPLETE: "complete";
+    CHECKPOINT: "checkpoint";
+    DELEGATION: "delegation";
+    RELEASE: "release";
+}>;
+/**
+ * WU status values (matches LumenFlow state machine)
+ */
+export declare const WU_STATUSES: readonly ["ready", "in_progress", "blocked", "waiting", "done"];
+/** Type for WU status values */
+export type WUStatus = (typeof WU_STATUSES)[number];
+/**
+ * Regex patterns for WU validation
+ */
+export declare const WU_PATTERNS: {
+    /** WU ID format: WU-{digits} */
+    WU_ID: RegExp;
+};
+/**
+ * Create event schema
+ */
+export declare const CreateEventSchema: z.ZodObject<{
+    wuId: z.ZodString;
+    timestamp: z.ZodString;
+    type: z.ZodLiteral<"create">;
+    lane: z.ZodString;
+    title: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Claim event schema
+ */
+export declare const ClaimEventSchema: z.ZodObject<{
+    wuId: z.ZodString;
+    timestamp: z.ZodString;
+    type: z.ZodLiteral<"claim">;
+    lane: z.ZodString;
+    title: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Block event schema
+ */
+export declare const BlockEventSchema: z.ZodObject<{
+    wuId: z.ZodString;
+    timestamp: z.ZodString;
+    type: z.ZodLiteral<"block">;
+    reason: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Unblock event schema
+ */
+export declare const UnblockEventSchema: z.ZodObject<{
+    wuId: z.ZodString;
+    timestamp: z.ZodString;
+    type: z.ZodLiteral<"unblock">;
+}, z.core.$strip>;
+/**
+ * Complete event schema
+ */
+export declare const CompleteEventSchema: z.ZodObject<{
+    wuId: z.ZodString;
+    timestamp: z.ZodString;
+    type: z.ZodLiteral<"complete">;
+}, z.core.$strip>;
+/**
+ * Checkpoint event schema (WU-1748: cross-agent visibility)
+ * Records progress checkpoints for abandoned WU detection
+ */
+export declare const CheckpointEventSchema: z.ZodObject<{
+    wuId: z.ZodString;
+    timestamp: z.ZodString;
+    type: z.ZodLiteral<"checkpoint">;
+    note: z.ZodString;
+    sessionId: z.ZodOptional<z.ZodString>;
+    progress: z.ZodOptional<z.ZodString>;
+    nextSteps: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Delegation event schema (WU-1947: parent-child relationships)
+ * Records WU delegation relationships for tracking parent-child WUs
+ */
+export declare const DelegationEventSchema: z.ZodObject<{
+    wuId: z.ZodString;
+    timestamp: z.ZodString;
+    type: z.ZodLiteral<"delegation">;
+    parentWuId: z.ZodString;
+    delegationId: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Release event schema (WU-1080: orphan recovery)
+ * Releases an in_progress WU back to ready state when agent is interrupted.
+ * Allows another agent to reclaim the orphaned WU.
+ */
+export declare const ReleaseEventSchema: z.ZodObject<{
+    wuId: z.ZodString;
+    timestamp: z.ZodString;
+    type: z.ZodLiteral<"release">;
+    reason: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Union schema for all event types
+ */
+export declare const WUEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    wuId: z.ZodString;
+    timestamp: z.ZodString;
+    type: z.ZodLiteral<"create">;
+    lane: z.ZodString;
+    title: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    wuId: z.ZodString;
+    timestamp: z.ZodString;
+    type: z.ZodLiteral<"claim">;
+    lane: z.ZodString;
+    title: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    wuId: z.ZodString;
+    timestamp: z.ZodString;
+    type: z.ZodLiteral<"block">;
+    reason: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    wuId: z.ZodString;
+    timestamp: z.ZodString;
+    type: z.ZodLiteral<"unblock">;
+}, z.core.$strip>, z.ZodObject<{
+    wuId: z.ZodString;
+    timestamp: z.ZodString;
+    type: z.ZodLiteral<"complete">;
+}, z.core.$strip>, z.ZodObject<{
+    wuId: z.ZodString;
+    timestamp: z.ZodString;
+    type: z.ZodLiteral<"checkpoint">;
+    note: z.ZodString;
+    sessionId: z.ZodOptional<z.ZodString>;
+    progress: z.ZodOptional<z.ZodString>;
+    nextSteps: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    wuId: z.ZodString;
+    timestamp: z.ZodString;
+    type: z.ZodLiteral<"delegation">;
+    parentWuId: z.ZodString;
+    delegationId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    wuId: z.ZodString;
+    timestamp: z.ZodString;
+    type: z.ZodLiteral<"release">;
+    reason: z.ZodString;
+}, z.core.$strip>], "type">;
+/**
+ * TypeScript types inferred from schemas
+ */
+export type CreateEvent = z.infer<typeof CreateEventSchema>;
+export type ClaimEvent = z.infer<typeof ClaimEventSchema>;
+export type BlockEvent = z.infer<typeof BlockEventSchema>;
+export type UnblockEvent = z.infer<typeof UnblockEventSchema>;
+export type CompleteEvent = z.infer<typeof CompleteEventSchema>;
+export type CheckpointEvent = z.infer<typeof CheckpointEventSchema>;
+export type DelegationEvent = z.infer<typeof DelegationEventSchema>;
+export type ReleaseEvent = z.infer<typeof ReleaseEventSchema>;
+export type WUEvent = z.infer<typeof WUEventSchema>;
+/**
+ * Validates WU event data against schema
+ *
+ * @param {unknown} data - Data to validate
+ * @returns {z.SafeParseReturnType<WUEvent, WUEvent>} Validation result
+ *
+ * @example
+ * const result = validateWUEvent(eventData);
+ * if (!result.success) {
+ *   result.error.issues.forEach(issue => {
+ *     console.error(`${issue.path.join('.')}: ${issue.message}`);
+ *   });
+ * }
+ */
+export declare function validateWUEvent(data: UnsafeAny): z.ZodSafeParseResult<{
+    wuId: string;
+    timestamp: string;
+    type: "create";
+    lane: string;
+    title: string;
+} | {
+    wuId: string;
+    timestamp: string;
+    type: "claim";
+    lane: string;
+    title: string;
+} | {
+    wuId: string;
+    timestamp: string;
+    type: "block";
+    reason: string;
+} | {
+    wuId: string;
+    timestamp: string;
+    type: "unblock";
+} | {
+    wuId: string;
+    timestamp: string;
+    type: "complete";
+} | {
+    wuId: string;
+    timestamp: string;
+    type: "checkpoint";
+    note: string;
+    sessionId?: string | undefined;
+    progress?: string | undefined;
+    nextSteps?: string | undefined;
+} | {
+    wuId: string;
+    timestamp: string;
+    type: "delegation";
+    parentWuId: string;
+    delegationId: string;
+} | {
+    wuId: string;
+    timestamp: string;
+    type: "release";
+    reason: string;
+}>;
+//# sourceMappingURL=wu-state-schema.d.ts.map

package/dist/wu-state-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wu-state-schema.d.ts","sourceRoot":"","sources":["../src/wu-state-schema.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,cAAc,qGASjB,CAAC;AAEX,8BAA8B;AAC9B,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1D;;;;;GAKG;AACH,eAAO,MAAM,aAAa;;;;;;;;;EASxB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,WAAW,iEAAkE,CAAC;AAE3F,gCAAgC;AAChC,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpD;;GAEG;AACH,eAAO,MAAM,WAAW;IACtB,gCAAgC;;CAEjC,CAAC;AA8BF;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;iBAI5B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;;iBAI3B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;iBAG3B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;iBAE7B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;iBAE9B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;iBAUhC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,qBAAqB;;;;;;iBAQhC,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,kBAAkB;;;;;iBAI7B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BASxB,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC1D,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC1D,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAEpD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAE9C"}

package/dist/wu-state-schema.js

@@ -0,0 +1,188 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * WU State Schema (WU-1570)
+ *
+ * Zod schemas for WU state event validation.
+ * Defines event types for WU lifecycle: create, claim, block, unblock, complete.
+ *
+ * @see {@link packages/@lumenflow/cli/src/lib/__tests__/wu-state-store.test.ts} - Tests
+ */
+import { z } from 'zod';
+/**
+ * WU event types
+ *
+ * - create: WU created (transitions to ready)
+ * - claim: WU claimed (transitions to in_progress)
+ * - block: WU blocked (transitions to blocked)
+ * - unblock: WU unblocked (transitions back to in_progress)
+ * - complete: WU completed (transitions to done)
+ * - checkpoint: Progress checkpoint (WU-1748: cross-agent visibility)
+ * - delegation: WU delegated from parent (WU-1947: parent-child relationships)
+ * - release: WU released (WU-1080: transitions from in_progress to ready for orphan recovery)
+ */
+export const WU_EVENT_TYPES = [
+    'create',
+    'claim',
+    'block',
+    'unblock',
+    'complete',
+    'checkpoint',
+    'delegation',
+    'release',
+];
+/**
+ * WU Event Type constant object (WU-2044)
+ *
+ * Named constants for event type strings, analogous to WU_STATUS.
+ * Use WU_EVENT_TYPE.CLAIM instead of raw 'claim' strings.
+ */
+export const WU_EVENT_TYPE = Object.freeze({
+    CREATE: 'create',
+    CLAIM: 'claim',
+    BLOCK: 'block',
+    UNBLOCK: 'unblock',
+    COMPLETE: 'complete',
+    CHECKPOINT: 'checkpoint',
+    DELEGATION: 'delegation',
+    RELEASE: 'release',
+});
+/**
+ * WU status values (matches LumenFlow state machine)
+ */
+export const WU_STATUSES = ['ready', 'in_progress', 'blocked', 'waiting', 'done'];
+/**
+ * Regex patterns for WU validation
+ */
+export const WU_PATTERNS = {
+    /** WU ID format: WU-{digits} */
+    WU_ID: /^WU-\d+$/,
+};
+/**
+ * Error messages for schema validation
+ */
+const ERROR_MESSAGES = {
+    EVENT_TYPE: `Event type must be one of: ${WU_EVENT_TYPES.join(', ')}`,
+    WU_ID: 'WU ID must match pattern WU-XXX (e.g., WU-1570)',
+    LANE_REQUIRED: 'Lane is required',
+    TITLE_REQUIRED: 'Title is required',
+    REASON_REQUIRED: 'Reason is required',
+    TIMESTAMP_REQUIRED: 'Timestamp is required',
+};
+/**
+ * Base event schema (common fields for all events)
+ */
+const BaseEventSchema = z.object({
+    /** Event type */
+    type: z.enum(WU_EVENT_TYPES, {
+        error: ERROR_MESSAGES.EVENT_TYPE,
+    }),
+    /** WU ID */
+    wuId: z.string().regex(WU_PATTERNS.WU_ID, { message: ERROR_MESSAGES.WU_ID }),
+    /** Event timestamp (ISO 8601 datetime) */
+    timestamp: z.string().datetime({ message: ERROR_MESSAGES.TIMESTAMP_REQUIRED }),
+});
+/**
+ * Create event schema
+ */
+export const CreateEventSchema = BaseEventSchema.extend({
+    type: z.literal('create'),
+    lane: z.string().min(1, { message: ERROR_MESSAGES.LANE_REQUIRED }),
+    title: z.string().min(1, { message: ERROR_MESSAGES.TITLE_REQUIRED }),
+});
+/**
+ * Claim event schema
+ */
+export const ClaimEventSchema = BaseEventSchema.extend({
+    type: z.literal('claim'),
+    lane: z.string().min(1, { message: ERROR_MESSAGES.LANE_REQUIRED }),
+    title: z.string().min(1, { message: ERROR_MESSAGES.TITLE_REQUIRED }),
+});
+/**
+ * Block event schema
+ */
+export const BlockEventSchema = BaseEventSchema.extend({
+    type: z.literal('block'),
+    reason: z.string().min(1, { message: ERROR_MESSAGES.REASON_REQUIRED }),
+});
+/**
+ * Unblock event schema
+ */
+export const UnblockEventSchema = BaseEventSchema.extend({
+    type: z.literal('unblock'),
+});
+/**
+ * Complete event schema
+ */
+export const CompleteEventSchema = BaseEventSchema.extend({
+    type: z.literal('complete'),
+});
+/**
+ * Checkpoint event schema (WU-1748: cross-agent visibility)
+ * Records progress checkpoints for abandoned WU detection
+ */
+export const CheckpointEventSchema = BaseEventSchema.extend({
+    type: z.literal('checkpoint'),
+    /** Checkpoint note/description */
+    note: z.string().min(1, { message: 'Checkpoint note is required' }),
+    /** Optional session ID */
+    sessionId: z.string().optional(),
+    /** Optional progress summary */
+    progress: z.string().optional(),
+    /** Optional next steps */
+    nextSteps: z.string().optional(),
+});
+/**
+ * Delegation event schema (WU-1947: parent-child relationships)
+ * Records WU delegation relationships for tracking parent-child WUs
+ */
+export const DelegationEventSchema = BaseEventSchema.extend({
+    type: z.literal('delegation'),
+    /** Parent WU ID that delegated this WU */
+    parentWuId: z
+        .string()
+        .regex(WU_PATTERNS.WU_ID, { message: 'Parent WU ID must match pattern WU-XXX' }),
+    /** Unique delegation identifier */
+    delegationId: z.string().min(1, { message: 'Delegation ID is required' }),
+});
+/**
+ * Release event schema (WU-1080: orphan recovery)
+ * Releases an in_progress WU back to ready state when agent is interrupted.
+ * Allows another agent to reclaim the orphaned WU.
+ */
+export const ReleaseEventSchema = BaseEventSchema.extend({
+    type: z.literal('release'),
+    /** Reason for releasing the WU */
+    reason: z.string().min(1, { message: ERROR_MESSAGES.REASON_REQUIRED }),
+});
+/**
+ * Union schema for all event types
+ */
+export const WUEventSchema = z.discriminatedUnion('type', [
+    CreateEventSchema,
+    ClaimEventSchema,
+    BlockEventSchema,
+    UnblockEventSchema,
+    CompleteEventSchema,
+    CheckpointEventSchema,
+    DelegationEventSchema,
+    ReleaseEventSchema,
+]);
+/**
+ * Validates WU event data against schema
+ *
+ * @param {unknown} data - Data to validate
+ * @returns {z.SafeParseReturnType<WUEvent, WUEvent>} Validation result
+ *
+ * @example
+ * const result = validateWUEvent(eventData);
+ * if (!result.success) {
+ *   result.error.issues.forEach(issue => {
+ *     console.error(`${issue.path.join('.')}: ${issue.message}`);
+ *   });
+ * }
+ */
+export function validateWUEvent(data) {
+    return WUEventSchema.safeParse(data);
+}
+//# sourceMappingURL=wu-state-schema.js.map

package/dist/wu-state-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wu-state-schema.js","sourceRoot":"","sources":["../src/wu-state-schema.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAEzC;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,QAAQ;IACR,OAAO;IACP,OAAO;IACP,SAAS;IACT,UAAU;IACV,YAAY;IACZ,YAAY;IACZ,SAAS;CACD,CAAC;AAKX;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC;IACzC,MAAM,EAAE,QAAiB;IACzB,KAAK,EAAE,OAAgB;IACvB,KAAK,EAAE,OAAgB;IACvB,OAAO,EAAE,SAAkB;IAC3B,QAAQ,EAAE,UAAmB;IAC7B,UAAU,EAAE,YAAqB;IACjC,UAAU,EAAE,YAAqB;IACjC,OAAO,EAAE,SAAkB;CAC5B,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,CAAU,CAAC;AAK3F;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,gCAAgC;IAChC,KAAK,EAAE,UAAU;CAClB,CAAC;AAEF;;GAEG;AACH,MAAM,cAAc,GAAG;IACrB,UAAU,EAAE,8BAA8B,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;IACrE,KAAK,EAAE,iDAAiD;IACxD,aAAa,EAAE,kBAAkB;IACjC,cAAc,EAAE,mBAAmB;IACnC,eAAe,EAAE,oBAAoB;IACrC,kBAAkB,EAAE,uBAAuB;CAC5C,CAAC;AAEF;;GAEG;AACH,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/B,iBAAiB;IACjB,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,cAAc,EAAE;QAC3B,KAAK,EAAE,cAAc,CAAC,UAAU;KACjC,CAAC;IAEF,YAAY;IACZ,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,cAAc,CAAC,KAAK,EAAE,CAAC;IAE5E,0CAA0C;IAC1C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,cAAc,CAAC,kBAAkB,EAAE,CAAC;CAC/E,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,eAAe,CAAC,MAAM,CAAC;IACtD,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;IACzB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,cAAc,CAAC,aAAa,EAAE,CAAC;IAClE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,cAAc,CAAC,cAAc,EAAE,CAAC;CACrE,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,eAAe,CAAC,MAAM,CAAC;IACrD,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;IACxB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,cAAc,CAAC,aAAa,EAAE,CAAC;IAClE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,cAAc,CAAC,cAAc,EAAE,CAAC;CACrE,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,eAAe,CAAC,MAAM,CAAC;IACrD,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;IACxB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,cAAc,CAAC,eAAe,EAAE,CAAC;CACvE,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,eAAe,CAAC,MAAM,CAAC;IACvD,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;CAC3B,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,eAAe,CAAC,MAAM,CAAC;IACxD,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;CAC5B,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,eAAe,CAAC,MAAM,CAAC;IAC1D,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC;IAC7B,kCAAkC;IAClC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,6BAA6B,EAAE,CAAC;IACnE,0BAA0B;IAC1B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,gCAAgC;IAChC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,0BAA0B;IAC1B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,eAAe,CAAC,MAAM,CAAC;IAC1D,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC;IAC7B,0CAA0C;IAC1C,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,KAAK,CAAC,WAAW,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,wCAAwC,EAAE,CAAC;IAClF,mCAAmC;IACnC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,2BAA2B,EAAE,CAAC;CAC1E,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,eAAe,CAAC,MAAM,CAAC;IACvD,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;IAC1B,kCAAkC;IAClC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,cAAc,CAAC,eAAe,EAAE,CAAC;CACvE,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;IACxD,iBAAiB;IACjB,gBAAgB;IAChB,gBAAgB;IAChB,kBAAkB;IAClB,mBAAmB;IACnB,qBAAqB;IACrB,qBAAqB;IACrB,kBAAkB;CACnB,CAAC,CAAC;AAeH;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,eAAe,CAAC,IAAe;IAC7C,OAAO,aAAa,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;AACvC,CAAC"}

package/dist/wu-state-store.d.ts

@@ -0,0 +1,64 @@
+/**
+ * WU State Store - Facade (WU-2013, WU-2020)
+ *
+ * Thin facade delegating to: WUEventSourcer, WUStateIndexer,
+ * wu-lock-manager, wu-repair-service.
+ *
+ * WU-2020: Implements IWuStateStore port interface for DIP compliance.
+ * Command handlers should depend on IWuStateStore, not this concrete class.
+ * Use createWUStateStore() factory for new instances.
+ */
+import { type WUEvent } from './wu-state-schema.js';
+import { WUStateIndexer } from './wu-state-indexer.js';
+import type { IWuStateStore } from './ports/wu-state.ports.js';
+export type { IWuStateStore } from './ports/wu-state.ports.js';
+export { WU_EVENTS_FILE_NAME } from './wu-event-sourcer.js';
+export type { WUStateEntry, CheckpointOptions } from './wu-state-indexer.js';
+export { isLockStale, acquireLock, releaseLock } from './wu-lock-manager.js';
+export type { LockData } from './wu-lock-manager.js';
+export { repairStateFile } from './wu-repair-service.js';
+export type { RepairResult } from './wu-repair-service.js';
+/**
+ * WU State Store - event-sourced WU lifecycle state.
+ * Delegates to focused services for each responsibility.
+ *
+ * Implements IWuStateStore port interface (WU-2020) so consumers
+ * can depend on the interface instead of this concrete class.
+ */
+export declare class WUStateStore implements IWuStateStore {
+    private readonly indexer;
+    private readonly sourcer;
+    constructor(baseDir: string);
+    load(): Promise<void>;
+    appendAndApply(event: WUEvent): Promise<void>;
+    claim(wuId: string, lane: string, title: string): Promise<void>;
+    complete(wuId: string): Promise<void>;
+    getWUState(wuId: string): ReturnType<WUStateIndexer['getWUState']>;
+    createCompleteEvent(wuId: string, timestamp?: string): WUEvent;
+    applyEvent(event: WUEvent): void;
+    block(wuId: string, reason: string): Promise<void>;
+    unblock(wuId: string): Promise<void>;
+    checkpoint(wuId: string, note: string, options?: {
+        sessionId?: string;
+        progress?: string;
+        nextSteps?: string;
+    }): Promise<void>;
+    getByStatus(status: string): Set<string>;
+    getByLane(lane: string): Set<string>;
+    getChildWUs(parentWuId: string): Set<string>;
+    delegate(childWuId: string, parentWuId: string, delegationId: string): Promise<void>;
+    release(wuId: string, reason: string): Promise<void>;
+    createReleaseEvent(wuId: string, reason: string, timestamp?: string): WUEvent;
+}
+/**
+ * Factory function to create a WUStateStore instance (WU-2020).
+ *
+ * Command handlers should prefer this factory over direct `new WUStateStore()`
+ * to enable future swapping of implementations and easier testing.
+ * The return type is the IWuStateStore interface, not the concrete class.
+ *
+ * @param baseDir - Base directory for the state store (e.g., `.lumenflow/state`)
+ * @returns An IWuStateStore implementation
+ */
+export declare function createWUStateStore(baseDir: string): IWuStateStore;
+//# sourceMappingURL=wu-state-store.d.ts.map

package/dist/wu-state-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wu-state-store.d.ts","sourceRoot":"","sources":["../src/wu-state-store.ts"],"names":[],"mappings":"AAGA;;;;;;;;;GASG;AAEH,OAAO,EAAkC,KAAK,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAEpF,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAG/D,YAAY,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAG/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC7E,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC7E,YAAY,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,YAAY,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAsB3D;;;;;;GAMG;AACH,qBAAa,YAAa,YAAW,aAAa;IAChD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;IACzC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;gBAE7B,OAAO,EAAE,MAAM;IAKrB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7C,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB/D,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAW3C,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC;IAIlE,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,GAAE,MAAiC,GAAG,OAAO;IAKxF,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAI1B,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYlD,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAcpC,UAAU,CACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO,GAC1E,OAAO,CAAC,IAAI,CAAC;IAchB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;IAIxC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;IAIpC,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;IAItC,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYpF,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAY1D,kBAAkB,CAChB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,SAAS,GAAE,MAAiC,GAC3C,OAAO;CAIX;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CAEjE"}