@lumenflow/core 3.1.3 → 3.2.1

package/dist/domain/recovery.schemas.d.ts

@@ -0,0 +1,164 @@
+/**
+ * Recovery Schemas
+ *
+ * WU-1093: INIT-002 Phase 1 - Define ports and domain schemas
+ *
+ * Zod schemas for recovery-related types in the context-aware validation system.
+ * Types are inferred from Zod schemas using z.infer<> for single source of truth.
+ *
+ * @module domain/recovery.schemas
+ */
+import { z } from 'zod';
+/**
+ * Recovery issue code values
+ *
+ * Mirrors CONTEXT_VALIDATION.RECOVERY_ISSUES from wu-constants.ts
+ */
+export declare const RECOVERY_ISSUE_CODE_VALUES: readonly ["PARTIAL_CLAIM", "ORPHAN_CLAIM", "INCONSISTENT_STATE", "ORPHAN_BRANCH", "STALE_LOCK", "LEFTOVER_WORKTREE"];
+/**
+ * RecoveryIssueCode enum for use in code
+ *
+ * Provides named constants for recovery issue codes to avoid magic string literals.
+ *
+ * @example
+ * import { RecoveryIssueCode } from '@lumenflow/core';
+ *
+ * if (issue.code === RecoveryIssueCode.PARTIAL_CLAIM) {
+ *   // Handle partial claim issue
+ * }
+ */
+export declare const RecoveryIssueCode: {
+    /** Worktree exists but WU status is "ready" */
+    readonly PARTIAL_CLAIM: "PARTIAL_CLAIM";
+    /** WU is "in_progress" but worktree does not exist */
+    readonly ORPHAN_CLAIM: "ORPHAN_CLAIM";
+    /** YAML status differs from state store */
+    readonly INCONSISTENT_STATE: "INCONSISTENT_STATE";
+    /** Branch exists but worktree does not */
+    readonly ORPHAN_BRANCH: "ORPHAN_BRANCH";
+    /** Lock file from different WU */
+    readonly STALE_LOCK: "STALE_LOCK";
+    /** WU is done but worktree was not cleaned up */
+    readonly LEFTOVER_WORKTREE: "LEFTOVER_WORKTREE";
+};
+/**
+ * Schema for recovery issue codes
+ */
+export declare const RecoveryIssueCodeSchema: z.ZodEnum<{
+    INCONSISTENT_STATE: "INCONSISTENT_STATE";
+    PARTIAL_CLAIM: "PARTIAL_CLAIM";
+    ORPHAN_CLAIM: "ORPHAN_CLAIM";
+    ORPHAN_BRANCH: "ORPHAN_BRANCH";
+    STALE_LOCK: "STALE_LOCK";
+    LEFTOVER_WORKTREE: "LEFTOVER_WORKTREE";
+}>;
+/**
+ * Recovery action type values
+ *
+ * Mirrors CONTEXT_VALIDATION.RECOVERY_ACTIONS from wu-constants.ts
+ */
+export declare const RECOVERY_ACTION_TYPE_VALUES: readonly ["resume", "reset", "nuke", "cleanup"];
+/**
+ * RecoveryActionType enum for use in code
+ *
+ * Provides named constants for recovery action types to avoid magic string literals.
+ *
+ * @example
+ * import { RecoveryActionType } from '@lumenflow/core';
+ *
+ * if (action.type === RecoveryActionType.RESUME) {
+ *   // Resume the WU
+ * }
+ */
+export declare const RecoveryActionType: {
+    /** Reconcile state and continue working (preserves work) */
+    readonly RESUME: "resume";
+    /** Discard worktree, reset WU to ready */
+    readonly RESET: "reset";
+    /** Remove all artifacts completely (requires --force) */
+    readonly NUKE: "nuke";
+    /** Remove leftover worktree (for done WUs) */
+    readonly CLEANUP: "cleanup";
+};
+/**
+ * Schema for recovery action types
+ */
+export declare const RecoveryActionTypeSchema: z.ZodEnum<{
+    reset: "reset";
+    resume: "resume";
+    nuke: "nuke";
+    cleanup: "cleanup";
+}>;
+/**
+ * Schema for recovery issue
+ *
+ * Issue detected during recovery analysis.
+ */
+export declare const RecoveryIssueSchema: z.ZodObject<{
+    code: z.ZodEnum<{
+        INCONSISTENT_STATE: "INCONSISTENT_STATE";
+        PARTIAL_CLAIM: "PARTIAL_CLAIM";
+        ORPHAN_CLAIM: "ORPHAN_CLAIM";
+        ORPHAN_BRANCH: "ORPHAN_BRANCH";
+        STALE_LOCK: "STALE_LOCK";
+        LEFTOVER_WORKTREE: "LEFTOVER_WORKTREE";
+    }>;
+    description: z.ZodString;
+    context: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+/**
+ * Schema for recovery action
+ *
+ * Suggested recovery action.
+ */
+export declare const RecoveryActionSchema: z.ZodObject<{
+    type: z.ZodEnum<{
+        reset: "reset";
+        resume: "resume";
+        nuke: "nuke";
+        cleanup: "cleanup";
+    }>;
+    description: z.ZodString;
+    command: z.ZodString;
+    requiresForce: z.ZodBoolean;
+    warning: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Schema for recovery analysis result
+ *
+ * Result of recovery analysis.
+ */
+export declare const RecoveryAnalysisSchema: z.ZodObject<{
+    hasIssues: z.ZodBoolean;
+    issues: z.ZodArray<z.ZodObject<{
+        code: z.ZodEnum<{
+            INCONSISTENT_STATE: "INCONSISTENT_STATE";
+            PARTIAL_CLAIM: "PARTIAL_CLAIM";
+            ORPHAN_CLAIM: "ORPHAN_CLAIM";
+            ORPHAN_BRANCH: "ORPHAN_BRANCH";
+            STALE_LOCK: "STALE_LOCK";
+            LEFTOVER_WORKTREE: "LEFTOVER_WORKTREE";
+        }>;
+        description: z.ZodString;
+        context: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>;
+    actions: z.ZodArray<z.ZodObject<{
+        type: z.ZodEnum<{
+            reset: "reset";
+            resume: "resume";
+            nuke: "nuke";
+            cleanup: "cleanup";
+        }>;
+        description: z.ZodString;
+        command: z.ZodString;
+        requiresForce: z.ZodBoolean;
+        warning: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    wuId: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type RecoveryIssueCode = (typeof RecoveryIssueCode)[keyof typeof RecoveryIssueCode];
+export type RecoveryActionType = (typeof RecoveryActionType)[keyof typeof RecoveryActionType];
+export type RecoveryIssue = z.infer<typeof RecoveryIssueSchema>;
+export type RecoveryAction = z.infer<typeof RecoveryActionSchema>;
+export type RecoveryAnalysis = z.infer<typeof RecoveryAnalysisSchema>;
+//# sourceMappingURL=recovery.schemas.d.ts.map

package/dist/domain/recovery.schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recovery.schemas.d.ts","sourceRoot":"","sources":["../../src/domain/recovery.schemas.ts"],"names":[],"mappings":"AAGA;;;;;;;;;GASG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,sHAO7B,CAAC;AAEX;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,iBAAiB;IAC5B,+CAA+C;;IAE/C,sDAAsD;;IAEtD,2CAA2C;;IAE3C,0CAA0C;;IAE1C,kCAAkC;;IAElC,iDAAiD;;CAEzC,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;;;;EAAqC,CAAC;AAE1E;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,iDAAkD,CAAC;AAE3F;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,kBAAkB;IAC7B,4DAA4D;;IAE5D,0CAA0C;;IAE1C,yDAAyD;;IAEzD,8CAA8C;;CAEtC,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;;EAAsC,CAAC;AAE5E;;;;GAIG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;iBAO9B,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;iBAW/B,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;iBASjC,CAAC;AAIH,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,OAAO,iBAAiB,CAAC,CAAC;AAE3F,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,OAAO,kBAAkB,CAAC,CAAC;AAC9F,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC"}

package/dist/domain/recovery.schemas.js

@@ -0,0 +1,134 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * Recovery Schemas
+ *
+ * WU-1093: INIT-002 Phase 1 - Define ports and domain schemas
+ *
+ * Zod schemas for recovery-related types in the context-aware validation system.
+ * Types are inferred from Zod schemas using z.infer<> for single source of truth.
+ *
+ * @module domain/recovery.schemas
+ */
+import { z } from 'zod';
+/**
+ * Recovery issue code values
+ *
+ * Mirrors CONTEXT_VALIDATION.RECOVERY_ISSUES from wu-constants.ts
+ */
+export const RECOVERY_ISSUE_CODE_VALUES = [
+    'PARTIAL_CLAIM',
+    'ORPHAN_CLAIM',
+    'INCONSISTENT_STATE',
+    'ORPHAN_BRANCH',
+    'STALE_LOCK',
+    'LEFTOVER_WORKTREE',
+];
+/**
+ * RecoveryIssueCode enum for use in code
+ *
+ * Provides named constants for recovery issue codes to avoid magic string literals.
+ *
+ * @example
+ * import { RecoveryIssueCode } from '@lumenflow/core';
+ *
+ * if (issue.code === RecoveryIssueCode.PARTIAL_CLAIM) {
+ *   // Handle partial claim issue
+ * }
+ */
+export const RecoveryIssueCode = {
+    /** Worktree exists but WU status is "ready" */
+    PARTIAL_CLAIM: 'PARTIAL_CLAIM',
+    /** WU is "in_progress" but worktree does not exist */
+    ORPHAN_CLAIM: 'ORPHAN_CLAIM',
+    /** YAML status differs from state store */
+    INCONSISTENT_STATE: 'INCONSISTENT_STATE',
+    /** Branch exists but worktree does not */
+    ORPHAN_BRANCH: 'ORPHAN_BRANCH',
+    /** Lock file from different WU */
+    STALE_LOCK: 'STALE_LOCK',
+    /** WU is done but worktree was not cleaned up */
+    LEFTOVER_WORKTREE: 'LEFTOVER_WORKTREE',
+};
+/**
+ * Schema for recovery issue codes
+ */
+export const RecoveryIssueCodeSchema = z.enum(RECOVERY_ISSUE_CODE_VALUES);
+/**
+ * Recovery action type values
+ *
+ * Mirrors CONTEXT_VALIDATION.RECOVERY_ACTIONS from wu-constants.ts
+ */
+export const RECOVERY_ACTION_TYPE_VALUES = ['resume', 'reset', 'nuke', 'cleanup'];
+/**
+ * RecoveryActionType enum for use in code
+ *
+ * Provides named constants for recovery action types to avoid magic string literals.
+ *
+ * @example
+ * import { RecoveryActionType } from '@lumenflow/core';
+ *
+ * if (action.type === RecoveryActionType.RESUME) {
+ *   // Resume the WU
+ * }
+ */
+export const RecoveryActionType = {
+    /** Reconcile state and continue working (preserves work) */
+    RESUME: 'resume',
+    /** Discard worktree, reset WU to ready */
+    RESET: 'reset',
+    /** Remove all artifacts completely (requires --force) */
+    NUKE: 'nuke',
+    /** Remove leftover worktree (for done WUs) */
+    CLEANUP: 'cleanup',
+};
+/**
+ * Schema for recovery action types
+ */
+export const RecoveryActionTypeSchema = z.enum(RECOVERY_ACTION_TYPE_VALUES);
+/**
+ * Schema for recovery issue
+ *
+ * Issue detected during recovery analysis.
+ */
+export const RecoveryIssueSchema = z.object({
+    /** Issue code from RECOVERY_ISSUES */
+    code: RecoveryIssueCodeSchema,
+    /** Human-readable description */
+    description: z.string(),
+    /** Additional context for the issue */
+    context: z.record(z.string(), z.unknown()).optional(),
+});
+/**
+ * Schema for recovery action
+ *
+ * Suggested recovery action.
+ */
+export const RecoveryActionSchema = z.object({
+    /** Action type from RECOVERY_ACTIONS */
+    type: RecoveryActionTypeSchema,
+    /** Human-readable description of what this action does */
+    description: z.string(),
+    /** Command to execute (copy-paste ready) */
+    command: z.string(),
+    /** Whether this action requires --force flag */
+    requiresForce: z.boolean(),
+    /** Warning message if UnsafeAny */
+    warning: z.string().optional(),
+});
+/**
+ * Schema for recovery analysis result
+ *
+ * Result of recovery analysis.
+ */
+export const RecoveryAnalysisSchema = z.object({
+    /** Whether UnsafeAny issues were found */
+    hasIssues: z.boolean(),
+    /** List of detected issues */
+    issues: z.array(RecoveryIssueSchema),
+    /** Suggested recovery actions */
+    actions: z.array(RecoveryActionSchema),
+    /** WU ID analyzed */
+    wuId: z.string().nullable(),
+});
+//# sourceMappingURL=recovery.schemas.js.map

package/dist/domain/recovery.schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recovery.schemas.js","sourceRoot":"","sources":["../../src/domain/recovery.schemas.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAEzC;;;;;;;;;GASG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,eAAe;IACf,cAAc;IACd,oBAAoB;IACpB,eAAe;IACf,YAAY;IACZ,mBAAmB;CACX,CAAC;AAEX;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,+CAA+C;IAC/C,aAAa,EAAE,eAAe;IAC9B,sDAAsD;IACtD,YAAY,EAAE,cAAc;IAC5B,2CAA2C;IAC3C,kBAAkB,EAAE,oBAAoB;IACxC,0CAA0C;IAC1C,aAAa,EAAE,eAAe;IAC9B,kCAAkC;IAClC,UAAU,EAAE,YAAY;IACxB,iDAAiD;IACjD,iBAAiB,EAAE,mBAAmB;CAC9B,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;AAE1E;;;;GAIG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,CAAU,CAAC;AAE3F;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,4DAA4D;IAC5D,MAAM,EAAE,QAAQ;IAChB,0CAA0C;IAC1C,KAAK,EAAE,OAAO;IACd,yDAAyD;IACzD,IAAI,EAAE,MAAM;IACZ,8CAA8C;IAC9C,OAAO,EAAE,SAAS;CACV,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;AAE5E;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,sCAAsC;IACtC,IAAI,EAAE,uBAAuB;IAC7B,iCAAiC;IACjC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,uCAAuC;IACvC,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;CACtD,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,wCAAwC;IACxC,IAAI,EAAE,wBAAwB;IAC9B,0DAA0D;IAC1D,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,4CAA4C;IAC5C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,gDAAgD;IAChD,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE;IAC1B,mCAAmC;IACnC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC/B,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,0CAA0C;IAC1C,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE;IACtB,8BAA8B;IAC9B,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,mBAAmB,CAAC;IACpC,iCAAiC;IACjC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC;IACtC,qBAAqB;IACrB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC5B,CAAC,CAAC"}

package/dist/domain/validation.schemas.d.ts

@@ -0,0 +1,147 @@
+/**
+ * Validation Schemas
+ *
+ * WU-1093: INIT-002 Phase 1 - Define ports and domain schemas
+ *
+ * Zod schemas for validation-related types in the context-aware validation system.
+ * Types are inferred from Zod schemas using z.infer<> for single source of truth.
+ *
+ * @module domain/validation.schemas
+ */
+import { z } from 'zod';
+import { LocationTypeSchema } from './context.schemas.js';
+export { LocationTypeSchema };
+/**
+ * Validation error code values
+ *
+ * Mirrors CONTEXT_VALIDATION.ERROR_CODES from wu-constants.ts
+ */
+export declare const VALIDATION_ERROR_CODE_VALUES: readonly ["WRONG_LOCATION", "WU_NOT_FOUND", "WU_ALREADY_EXISTS", "WRONG_WU_STATUS", "LANE_OCCUPIED", "WORKTREE_EXISTS", "WORKTREE_MISSING", "GATES_NOT_PASSED", "DIRTY_GIT", "REMOTE_UNAVAILABLE", "INCONSISTENT_STATE"];
+/**
+ * Schema for validation error codes
+ */
+export declare const ValidationErrorCodeSchema: z.ZodEnum<{
+    WRONG_LOCATION: "WRONG_LOCATION";
+    WU_NOT_FOUND: "WU_NOT_FOUND";
+    WU_ALREADY_EXISTS: "WU_ALREADY_EXISTS";
+    WRONG_WU_STATUS: "WRONG_WU_STATUS";
+    LANE_OCCUPIED: "LANE_OCCUPIED";
+    WORKTREE_EXISTS: "WORKTREE_EXISTS";
+    WORKTREE_MISSING: "WORKTREE_MISSING";
+    GATES_NOT_PASSED: "GATES_NOT_PASSED";
+    DIRTY_GIT: "DIRTY_GIT";
+    REMOTE_UNAVAILABLE: "REMOTE_UNAVAILABLE";
+    INCONSISTENT_STATE: "INCONSISTENT_STATE";
+}>;
+/**
+ * Severity values
+ *
+ * Mirrors CONTEXT_VALIDATION.SEVERITY from wu-constants.ts
+ */
+export declare const PREDICATE_SEVERITY_VALUES: readonly ["error", "warning"];
+/**
+ * Schema for predicate severity
+ */
+export declare const PredicateSeveritySchema: z.ZodEnum<{
+    error: "error";
+    warning: "warning";
+}>;
+/**
+ * Schema for validation error with fix guidance
+ */
+export declare const ValidationErrorSchema: z.ZodObject<{
+    code: z.ZodEnum<{
+        WRONG_LOCATION: "WRONG_LOCATION";
+        WU_NOT_FOUND: "WU_NOT_FOUND";
+        WU_ALREADY_EXISTS: "WU_ALREADY_EXISTS";
+        WRONG_WU_STATUS: "WRONG_WU_STATUS";
+        LANE_OCCUPIED: "LANE_OCCUPIED";
+        WORKTREE_EXISTS: "WORKTREE_EXISTS";
+        WORKTREE_MISSING: "WORKTREE_MISSING";
+        GATES_NOT_PASSED: "GATES_NOT_PASSED";
+        DIRTY_GIT: "DIRTY_GIT";
+        REMOTE_UNAVAILABLE: "REMOTE_UNAVAILABLE";
+        INCONSISTENT_STATE: "INCONSISTENT_STATE";
+    }>;
+    message: z.ZodString;
+    fixCommand: z.ZodNullable<z.ZodString>;
+    context: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+/**
+ * Schema for validation warning (non-blocking)
+ */
+export declare const ValidationWarningSchema: z.ZodObject<{
+    id: z.ZodString;
+    message: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Schema for validation result (partial, without context for serialization)
+ *
+ * Note: The full ValidationResult in types.ts includes the context object,
+ * but this schema is for serializable results without the context.
+ */
+export declare const ValidationResultSchema: z.ZodObject<{
+    valid: z.ZodBoolean;
+    errors: z.ZodArray<z.ZodObject<{
+        code: z.ZodEnum<{
+            WRONG_LOCATION: "WRONG_LOCATION";
+            WU_NOT_FOUND: "WU_NOT_FOUND";
+            WU_ALREADY_EXISTS: "WU_ALREADY_EXISTS";
+            WRONG_WU_STATUS: "WRONG_WU_STATUS";
+            LANE_OCCUPIED: "LANE_OCCUPIED";
+            WORKTREE_EXISTS: "WORKTREE_EXISTS";
+            WORKTREE_MISSING: "WORKTREE_MISSING";
+            GATES_NOT_PASSED: "GATES_NOT_PASSED";
+            DIRTY_GIT: "DIRTY_GIT";
+            REMOTE_UNAVAILABLE: "REMOTE_UNAVAILABLE";
+            INCONSISTENT_STATE: "INCONSISTENT_STATE";
+        }>;
+        message: z.ZodString;
+        fixCommand: z.ZodNullable<z.ZodString>;
+        context: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>;
+    warnings: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        message: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * Schema for command predicate configuration (serializable)
+ *
+ * This schema represents the serializable configuration of a predicate,
+ * not the full CommandPredicate which includes the check function.
+ */
+export declare const CommandPredicateConfigSchema: z.ZodObject<{
+    id: z.ZodString;
+    description: z.ZodString;
+    severity: z.ZodEnum<{
+        error: "error";
+        warning: "warning";
+    }>;
+}, z.core.$strip>;
+/**
+ * Schema for command definition configuration (serializable)
+ *
+ * This schema represents the serializable configuration of a command definition,
+ * not the full CommandDefinition which includes function references.
+ */
+export declare const CommandDefinitionConfigSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    requiredLocation: z.ZodNullable<z.ZodEnum<{
+        unknown: "unknown";
+        worktree: "worktree";
+        main: "main";
+        detached: "detached";
+    }>>;
+    requiredWuStatus: z.ZodNullable<z.ZodString>;
+    predicateIds: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type ValidationErrorCode = z.infer<typeof ValidationErrorCodeSchema>;
+export type PredicateSeverity = z.infer<typeof PredicateSeveritySchema>;
+export type ValidationError = z.infer<typeof ValidationErrorSchema>;
+export type ValidationWarning = z.infer<typeof ValidationWarningSchema>;
+export type ValidationResult = z.infer<typeof ValidationResultSchema>;
+export type CommandPredicateConfig = z.infer<typeof CommandPredicateConfigSchema>;
+export type CommandDefinitionConfig = z.infer<typeof CommandDefinitionConfigSchema>;
+//# sourceMappingURL=validation.schemas.d.ts.map

package/dist/domain/validation.schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.schemas.d.ts","sourceRoot":"","sources":["../../src/domain/validation.schemas.ts"],"names":[],"mappings":"AAGA;;;;;;;;;GASG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAG1D,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAE9B;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,0NAY/B,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;EAAuC,CAAC;AAE9E;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,+BAAgC,CAAC;AAEvE;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;EAAoC,CAAC;AAEzE;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;iBAShC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;iBAKlC,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;iBAOjC,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B;;;;;;;iBAOvC,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,6BAA6B;;;;;;;;;;;iBAWxC,CAAC;AAGH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC5E,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACxE,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,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAClF,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC"}

package/dist/domain/validation.schemas.js

@@ -0,0 +1,117 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * Validation Schemas
+ *
+ * WU-1093: INIT-002 Phase 1 - Define ports and domain schemas
+ *
+ * Zod schemas for validation-related types in the context-aware validation system.
+ * Types are inferred from Zod schemas using z.infer<> for single source of truth.
+ *
+ * @module domain/validation.schemas
+ */
+import { z } from 'zod';
+import { LocationTypeSchema } from './context.schemas.js';
+// Re-export LocationTypeSchema for command definitions
+export { LocationTypeSchema };
+/**
+ * Validation error code values
+ *
+ * Mirrors CONTEXT_VALIDATION.ERROR_CODES from wu-constants.ts
+ */
+export const VALIDATION_ERROR_CODE_VALUES = [
+    'WRONG_LOCATION',
+    'WU_NOT_FOUND',
+    'WU_ALREADY_EXISTS',
+    'WRONG_WU_STATUS',
+    'LANE_OCCUPIED',
+    'WORKTREE_EXISTS',
+    'WORKTREE_MISSING',
+    'GATES_NOT_PASSED',
+    'DIRTY_GIT',
+    'REMOTE_UNAVAILABLE',
+    'INCONSISTENT_STATE',
+];
+/**
+ * Schema for validation error codes
+ */
+export const ValidationErrorCodeSchema = z.enum(VALIDATION_ERROR_CODE_VALUES);
+/**
+ * Severity values
+ *
+ * Mirrors CONTEXT_VALIDATION.SEVERITY from wu-constants.ts
+ */
+export const PREDICATE_SEVERITY_VALUES = ['error', 'warning'];
+/**
+ * Schema for predicate severity
+ */
+export const PredicateSeveritySchema = z.enum(PREDICATE_SEVERITY_VALUES);
+/**
+ * Schema for validation error with fix guidance
+ */
+export const ValidationErrorSchema = z.object({
+    /** Error code */
+    code: ValidationErrorCodeSchema,
+    /** Human-readable message */
+    message: z.string(),
+    /** Copy-paste ready fix command (if available) */
+    fixCommand: z.string().nullable(),
+    /** Additional context for debugging */
+    context: z.record(z.string(), z.unknown()).optional(),
+});
+/**
+ * Schema for validation warning (non-blocking)
+ */
+export const ValidationWarningSchema = z.object({
+    /** Warning ID */
+    id: z.string(),
+    /** Human-readable message */
+    message: z.string(),
+});
+/**
+ * Schema for validation result (partial, without context for serialization)
+ *
+ * Note: The full ValidationResult in types.ts includes the context object,
+ * but this schema is for serializable results without the context.
+ */
+export const ValidationResultSchema = z.object({
+    /** Whether command can proceed */
+    valid: z.boolean(),
+    /** Errors that block execution */
+    errors: z.array(ValidationErrorSchema),
+    /** Warnings that don't block execution */
+    warnings: z.array(ValidationWarningSchema),
+});
+/**
+ * Schema for command predicate configuration (serializable)
+ *
+ * This schema represents the serializable configuration of a predicate,
+ * not the full CommandPredicate which includes the check function.
+ */
+export const CommandPredicateConfigSchema = z.object({
+    /** Unique identifier for the predicate */
+    id: z.string(),
+    /** Human-readable description */
+    description: z.string(),
+    /** Severity: 'error' blocks execution, 'warning' allows with warning */
+    severity: PredicateSeveritySchema,
+});
+/**
+ * Schema for command definition configuration (serializable)
+ *
+ * This schema represents the serializable configuration of a command definition,
+ * not the full CommandDefinition which includes function references.
+ */
+export const CommandDefinitionConfigSchema = z.object({
+    /** Command name (e.g., 'wu:create') */
+    name: z.string(),
+    /** Human-readable description */
+    description: z.string(),
+    /** Required location type (null = UnsafeAny location) */
+    requiredLocation: LocationTypeSchema.nullable(),
+    /** Required WU status (null = no status requirement) */
+    requiredWuStatus: z.string().nullable(),
+    /** Predicate IDs for additional checks */
+    predicateIds: z.array(z.string()),
+});
+//# sourceMappingURL=validation.schemas.js.map

package/dist/domain/validation.schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.schemas.js","sourceRoot":"","sources":["../../src/domain/validation.schemas.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAEzC;;;;;;;;;GASG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,uDAAuD;AACvD,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAE9B;;;;GAIG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG;IAC1C,gBAAgB;IAChB,cAAc;IACd,mBAAmB;IACnB,iBAAiB;IACjB,eAAe;IACf,iBAAiB;IACjB,kBAAkB;IAClB,kBAAkB;IAClB,WAAW;IACX,oBAAoB;IACpB,oBAAoB;CACZ,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;AAE9E;;;;GAIG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,OAAO,EAAE,SAAS,CAAU,CAAC;AAEvE;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;AAEzE;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,iBAAiB;IACjB,IAAI,EAAE,yBAAyB;IAC/B,6BAA6B;IAC7B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,kDAAkD;IAClD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,uCAAuC;IACvC,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;CACtD,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,iBAAiB;IACjB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,6BAA6B;IAC7B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;CACpB,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,kCAAkC;IAClC,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE;IAClB,kCAAkC;IAClC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,qBAAqB,CAAC;IACtC,0CAA0C;IAC1C,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,uBAAuB,CAAC;CAC3C,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IACnD,0CAA0C;IAC1C,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,iCAAiC;IACjC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,wEAAwE;IACxE,QAAQ,EAAE,uBAAuB;CAClC,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC,MAAM,CAAC;IACpD,uCAAuC;IACvC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,iCAAiC;IACjC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,yDAAyD;IACzD,gBAAgB,EAAE,kBAAkB,CAAC,QAAQ,EAAE;IAC/C,wDAAwD;IACxD,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACvC,0CAA0C;IAC1C,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;CAClC,CAAC,CAAC"}