@lumenflow/core 2.19.0 → 2.20.1

package/dist/wu-schema.d.ts

@@ -35,6 +35,34 @@ import { z } from 'zod';
  * if (doc.description.includes(PLACEHOLDER_SENTINEL)) { error(); }
  */
 export declare const PLACEHOLDER_SENTINEL = "[PLACEHOLDER]";
+interface WUDoneValidationInput {
+    type?: string;
+    code_paths?: string[];
+}
+interface WUEscalationInput {
+    id: string;
+    lane?: string;
+    code_paths?: string[];
+    priority?: string;
+    escalation_triggers?: string[];
+    requires_human_escalation?: boolean;
+    escalation_resolved_by?: string;
+    escalation_resolved_at?: string;
+    requires_cso_approval?: boolean;
+    requires_cto_approval?: boolean;
+    requires_design_approval?: boolean;
+}
+interface WUCompletenessInput {
+    id: string;
+    status?: string;
+    type?: string;
+    notes?: string;
+    tests?: {
+        manual?: string[];
+    };
+    spec_refs?: unknown;
+}
+type EscalationDetectionInput = Pick<WUEscalationInput, 'lane' | 'code_paths' | 'priority'>;
 /**
  * Base WU Schema (structural validation only)
  *
@@ -93,6 +121,7 @@ export declare const BaseWUSchema: z.ZodObject<{
     blocks: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string[], string[]>>, z.ZodArray<z.ZodString>>>;
     blocked_by: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string[], string[]>>, z.ZodArray<z.ZodString>>>;
     labels: z.ZodOptional<z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string[], string[]>>>;
+    plan: z.ZodOptional<z.ZodString>;
     spec_refs: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
         file: z.ZodOptional<z.ZodString>;
         section: z.ZodString;
@@ -101,10 +130,10 @@ export declare const BaseWUSchema: z.ZodObject<{
         section: z.ZodString;
     }, z.core.$strip>]>>]>>;
     risks: z.ZodDefault<z.ZodOptional<z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string[], string[]>>>>;
-    notes: z.ZodPipe<z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>, z.ZodTransform<string, string | string[]>>;
+    notes: z.ZodPipe<z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>, z.ZodTransform<string, string | string[] | undefined>>;
     requires_review: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     locked: z.ZodOptional<z.ZodBoolean>;
-    completed_at: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string, string>>;
+    completed_at: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string | undefined, string | undefined>>;
     claimed_mode: z.ZodOptional<z.ZodEnum<{
         worktree: "worktree";
         "branch-only": "branch-only";
@@ -113,7 +142,7 @@ export declare const BaseWUSchema: z.ZodObject<{
     }>>;
     claimed_branch: z.ZodOptional<z.ZodString>;
     assigned_to: z.ZodOptional<z.ZodString>;
-    claimed_at: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string, string>>;
+    claimed_at: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string | undefined, string | undefined>>;
     blocked_reason: z.ZodOptional<z.ZodString>;
     worktree_path: z.ZodOptional<z.ZodString>;
     session_id: z.ZodOptional<z.ZodString>;
@@ -123,7 +152,10 @@ export declare const BaseWUSchema: z.ZodObject<{
         completed: z.ZodOptional<z.ZodString>;
         agent_type: z.ZodEnum<{
             "claude-code": "claude-code";
+            "codex-cli": "codex-cli";
             cursor: "cursor";
+            "gemini-cli": "gemini-cli";
+            windsurf: "windsurf";
             copilot: "copilot";
             other: "other";
         }>;
@@ -143,16 +175,15 @@ export declare const BaseWUSchema: z.ZodObject<{
     navigation_path: z.ZodOptional<z.ZodString>;
     escalation_triggers: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodEnum<{
         budget: "budget";
-        phi_pii: "phi_pii";
+        sensitive_data: "sensitive_data";
         security_p0: "security_p0";
-        external_compliance: "external_compliance";
         cross_lane_arch: "cross_lane_arch";
     }>>>>;
     requires_human_escalation: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     approved_by: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    approved_at: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string, string>>;
+    approved_at: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string | undefined, string | undefined>>;
     escalation_resolved_by: z.ZodOptional<z.ZodString>;
-    escalation_resolved_at: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string, string>>;
+    escalation_resolved_at: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string | undefined, string | undefined>>;
     requires_cso_approval: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     requires_cto_approval: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     requires_design_approval: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
@@ -213,6 +244,7 @@ export declare const ReadyWUSchema: z.ZodObject<{
     blocks: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string[], string[]>>, z.ZodArray<z.ZodString>>>;
     blocked_by: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string[], string[]>>, z.ZodArray<z.ZodString>>>;
     labels: z.ZodOptional<z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string[], string[]>>>;
+    plan: z.ZodOptional<z.ZodString>;
     spec_refs: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
         file: z.ZodOptional<z.ZodString>;
         section: z.ZodString;
@@ -221,10 +253,10 @@ export declare const ReadyWUSchema: z.ZodObject<{
         section: z.ZodString;
     }, z.core.$strip>]>>]>>;
     risks: z.ZodDefault<z.ZodOptional<z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string[], string[]>>>>;
-    notes: z.ZodPipe<z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>, z.ZodTransform<string, string | string[]>>;
+    notes: z.ZodPipe<z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>, z.ZodTransform<string, string | string[] | undefined>>;
     requires_review: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     locked: z.ZodOptional<z.ZodBoolean>;
-    completed_at: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string, string>>;
+    completed_at: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string | undefined, string | undefined>>;
     claimed_mode: z.ZodOptional<z.ZodEnum<{
         worktree: "worktree";
         "branch-only": "branch-only";
@@ -233,7 +265,7 @@ export declare const ReadyWUSchema: z.ZodObject<{
     }>>;
     claimed_branch: z.ZodOptional<z.ZodString>;
     assigned_to: z.ZodOptional<z.ZodString>;
-    claimed_at: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string, string>>;
+    claimed_at: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string | undefined, string | undefined>>;
     blocked_reason: z.ZodOptional<z.ZodString>;
     worktree_path: z.ZodOptional<z.ZodString>;
     session_id: z.ZodOptional<z.ZodString>;
@@ -243,7 +275,10 @@ export declare const ReadyWUSchema: z.ZodObject<{
         completed: z.ZodOptional<z.ZodString>;
         agent_type: z.ZodEnum<{
             "claude-code": "claude-code";
+            "codex-cli": "codex-cli";
             cursor: "cursor";
+            "gemini-cli": "gemini-cli";
+            windsurf: "windsurf";
             copilot: "copilot";
             other: "other";
         }>;
@@ -263,16 +298,15 @@ export declare const ReadyWUSchema: z.ZodObject<{
     navigation_path: z.ZodOptional<z.ZodString>;
     escalation_triggers: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodEnum<{
         budget: "budget";
-        phi_pii: "phi_pii";
+        sensitive_data: "sensitive_data";
         security_p0: "security_p0";
-        external_compliance: "external_compliance";
         cross_lane_arch: "cross_lane_arch";
     }>>>>;
     requires_human_escalation: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     approved_by: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    approved_at: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string, string>>;
+    approved_at: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string | undefined, string | undefined>>;
     escalation_resolved_by: z.ZodOptional<z.ZodString>;
-    escalation_resolved_at: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string, string>>;
+    escalation_resolved_at: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string | undefined, string | undefined>>;
     requires_cso_approval: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     requires_cto_approval: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     requires_design_approval: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
@@ -339,6 +373,7 @@ export declare const WUSchema: z.ZodObject<{
     blocks: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string[], string[]>>, z.ZodArray<z.ZodString>>>;
     blocked_by: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string[], string[]>>, z.ZodArray<z.ZodString>>>;
     labels: z.ZodOptional<z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string[], string[]>>>;
+    plan: z.ZodOptional<z.ZodString>;
     spec_refs: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
         file: z.ZodOptional<z.ZodString>;
         section: z.ZodString;
@@ -347,10 +382,10 @@ export declare const WUSchema: z.ZodObject<{
         section: z.ZodString;
     }, z.core.$strip>]>>]>>;
     risks: z.ZodDefault<z.ZodOptional<z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string[], string[]>>>>;
-    notes: z.ZodPipe<z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>, z.ZodTransform<string, string | string[]>>;
+    notes: z.ZodPipe<z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>, z.ZodTransform<string, string | string[] | undefined>>;
     requires_review: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     locked: z.ZodOptional<z.ZodBoolean>;
-    completed_at: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string, string>>;
+    completed_at: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string | undefined, string | undefined>>;
     claimed_mode: z.ZodOptional<z.ZodEnum<{
         worktree: "worktree";
         "branch-only": "branch-only";
@@ -359,7 +394,7 @@ export declare const WUSchema: z.ZodObject<{
     }>>;
     claimed_branch: z.ZodOptional<z.ZodString>;
     assigned_to: z.ZodOptional<z.ZodString>;
-    claimed_at: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string, string>>;
+    claimed_at: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string | undefined, string | undefined>>;
     blocked_reason: z.ZodOptional<z.ZodString>;
     worktree_path: z.ZodOptional<z.ZodString>;
     session_id: z.ZodOptional<z.ZodString>;
@@ -369,7 +404,10 @@ export declare const WUSchema: z.ZodObject<{
         completed: z.ZodOptional<z.ZodString>;
         agent_type: z.ZodEnum<{
             "claude-code": "claude-code";
+            "codex-cli": "codex-cli";
             cursor: "cursor";
+            "gemini-cli": "gemini-cli";
+            windsurf: "windsurf";
             copilot: "copilot";
             other: "other";
         }>;
@@ -389,16 +427,15 @@ export declare const WUSchema: z.ZodObject<{
     navigation_path: z.ZodOptional<z.ZodString>;
     escalation_triggers: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodEnum<{
         budget: "budget";
-        phi_pii: "phi_pii";
+        sensitive_data: "sensitive_data";
         security_p0: "security_p0";
-        external_compliance: "external_compliance";
         cross_lane_arch: "cross_lane_arch";
     }>>>>;
     requires_human_escalation: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     approved_by: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    approved_at: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string, string>>;
+    approved_at: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string | undefined, string | undefined>>;
     escalation_resolved_by: z.ZodOptional<z.ZodString>;
-    escalation_resolved_at: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string, string>>;
+    escalation_resolved_at: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string | undefined, string | undefined>>;
     requires_cso_approval: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     requires_cto_approval: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     requires_design_approval: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
@@ -431,7 +468,9 @@ export declare const WUSchema: z.ZodObject<{
  *   });
  * }
  */
-export declare function validateWU(data: any): z.ZodSafeParseResult<{
+export declare function validateWU(data: unknown): z.ZodSafeParseResult<{
+    description: string;
+    acceptance: string[] | Record<string, string[]>;
     id: string;
     title: string;
     lane: string;
@@ -441,62 +480,61 @@ export declare function validateWU(data: any): z.ZodSafeParseResult<{
     created: string;
     code_paths: string[];
     tests: {
-        manual?: string[];
-        unit?: string[];
-        integration?: string[];
-        e2e?: string[];
+        manual?: string[] | undefined;
+        unit?: string[] | undefined;
+        integration?: string[] | undefined;
+        e2e?: string[] | undefined;
     };
     artifacts: string[];
     dependencies: string[];
     risks: string[];
+    notes: string;
     requires_review: boolean;
-    escalation_triggers: ("budget" | "phi_pii" | "security_p0" | "external_compliance" | "cross_lane_arch")[];
+    completed_at: string | undefined;
+    claimed_at: string | undefined;
+    escalation_triggers: ("budget" | "sensitive_data" | "security_p0" | "cross_lane_arch")[];
     requires_human_escalation: boolean;
+    approved_at: string | undefined;
+    escalation_resolved_at: string | undefined;
     requires_cso_approval: boolean;
     requires_cto_approval: boolean;
     requires_design_approval: boolean;
-    description?: string;
-    acceptance?: string[] | Record<string, string[]>;
-    initiative?: string;
-    phase?: number;
-    blocks?: string[];
-    blocked_by?: string[];
-    labels?: string[];
+    initiative?: string | undefined;
+    phase?: number | undefined;
+    blocks?: string[] | undefined;
+    blocked_by?: string[] | undefined;
+    labels?: string[] | undefined;
+    plan?: string | undefined;
     spec_refs?: {
         section: string;
-        file?: string;
+        file?: string | undefined;
     } | (string | {
         section: string;
-        file?: string;
-    })[];
-    notes?: string;
-    locked?: boolean;
-    completed_at?: string;
-    claimed_mode?: "worktree" | "branch-only" | "worktree-pr" | "branch-pr";
-    claimed_branch?: string;
-    assigned_to?: string;
-    claimed_at?: string;
-    blocked_reason?: string;
-    worktree_path?: string;
-    session_id?: string;
+        file?: string | undefined;
+    })[] | undefined;
+    locked?: boolean | undefined;
+    claimed_mode?: "worktree" | "branch-only" | "worktree-pr" | "branch-pr" | undefined;
+    claimed_branch?: string | undefined;
+    assigned_to?: string | undefined;
+    blocked_reason?: string | undefined;
+    worktree_path?: string | undefined;
+    session_id?: string | undefined;
     agent_sessions?: {
         session_id: string;
         started: string;
-        agent_type: "claude-code" | "cursor" | "copilot" | "other";
+        agent_type: "claude-code" | "codex-cli" | "cursor" | "gemini-cli" | "windsurf" | "copilot" | "other";
+        context_tier: 1 | 2 | 3;
         incidents_logged: number;
         incidents_major: number;
-        completed?: string;
-        context_tier?: 1 | 2 | 3;
-        artifacts?: string[];
-    }[];
-    exposure?: "documentation" | "ui" | "api" | "backend-only";
-    user_journey?: string;
-    ui_pairing_wus?: string[];
-    navigation_path?: string;
-    approved_by?: string[];
-    approved_at?: string;
-    escalation_resolved_by?: string;
-    escalation_resolved_at?: string;
+        completed?: string | undefined;
+        artifacts?: string[] | undefined;
+    }[] | undefined;
+    exposure?: "documentation" | "ui" | "api" | "backend-only" | undefined;
+    user_journey?: string | undefined;
+    ui_pairing_wus?: string[] | undefined;
+    navigation_path?: string | undefined;
+    approved_by?: string[] | undefined;
+    escalation_resolved_by?: string | undefined;
 }>;
 /**
  * Validates WU data against base schema (structural only)
@@ -516,7 +554,9 @@ export declare function validateWU(data: any): z.ZodSafeParseResult<{
  *   die(`WU YAML validation failed:\n\n${errors}`);
  * }
  */
-export declare function validateReadyWU(data: any): z.ZodSafeParseResult<{
+export declare function validateReadyWU(data: unknown): z.ZodSafeParseResult<{
+    description: string;
+    acceptance: string[] | Record<string, string[]>;
     id: string;
     title: string;
     lane: string;
@@ -526,62 +566,61 @@ export declare function validateReadyWU(data: any): z.ZodSafeParseResult<{
     created: string;
     code_paths: string[];
     tests: {
-        manual?: string[];
-        unit?: string[];
-        integration?: string[];
-        e2e?: string[];
+        manual?: string[] | undefined;
+        unit?: string[] | undefined;
+        integration?: string[] | undefined;
+        e2e?: string[] | undefined;
     };
     artifacts: string[];
     dependencies: string[];
     risks: string[];
+    notes: string;
     requires_review: boolean;
-    escalation_triggers: ("budget" | "phi_pii" | "security_p0" | "external_compliance" | "cross_lane_arch")[];
+    completed_at: string | undefined;
+    claimed_at: string | undefined;
+    escalation_triggers: ("budget" | "sensitive_data" | "security_p0" | "cross_lane_arch")[];
     requires_human_escalation: boolean;
+    approved_at: string | undefined;
+    escalation_resolved_at: string | undefined;
     requires_cso_approval: boolean;
     requires_cto_approval: boolean;
     requires_design_approval: boolean;
-    description?: string;
-    acceptance?: string[] | Record<string, string[]>;
-    initiative?: string;
-    phase?: number;
-    blocks?: string[];
-    blocked_by?: string[];
-    labels?: string[];
+    initiative?: string | undefined;
+    phase?: number | undefined;
+    blocks?: string[] | undefined;
+    blocked_by?: string[] | undefined;
+    labels?: string[] | undefined;
+    plan?: string | undefined;
     spec_refs?: {
         section: string;
-        file?: string;
+        file?: string | undefined;
     } | (string | {
         section: string;
-        file?: string;
-    })[];
-    notes?: string;
-    locked?: boolean;
-    completed_at?: string;
-    claimed_mode?: "worktree" | "branch-only" | "worktree-pr" | "branch-pr";
-    claimed_branch?: string;
-    assigned_to?: string;
-    claimed_at?: string;
-    blocked_reason?: string;
-    worktree_path?: string;
-    session_id?: string;
+        file?: string | undefined;
+    })[] | undefined;
+    locked?: boolean | undefined;
+    claimed_mode?: "worktree" | "branch-only" | "worktree-pr" | "branch-pr" | undefined;
+    claimed_branch?: string | undefined;
+    assigned_to?: string | undefined;
+    blocked_reason?: string | undefined;
+    worktree_path?: string | undefined;
+    session_id?: string | undefined;
     agent_sessions?: {
         session_id: string;
         started: string;
-        agent_type: "claude-code" | "cursor" | "copilot" | "other";
+        agent_type: "claude-code" | "codex-cli" | "cursor" | "gemini-cli" | "windsurf" | "copilot" | "other";
+        context_tier: 1 | 2 | 3;
         incidents_logged: number;
         incidents_major: number;
-        completed?: string;
-        context_tier?: 1 | 2 | 3;
-        artifacts?: string[];
-    }[];
-    exposure?: "documentation" | "ui" | "api" | "backend-only";
-    user_journey?: string;
-    ui_pairing_wus?: string[];
-    navigation_path?: string;
-    approved_by?: string[];
-    approved_at?: string;
-    escalation_resolved_by?: string;
-    escalation_resolved_at?: string;
+        completed?: string | undefined;
+        artifacts?: string[] | undefined;
+    }[] | undefined;
+    exposure?: "documentation" | "ui" | "api" | "backend-only" | undefined;
+    user_journey?: string | undefined;
+    ui_pairing_wus?: string[] | undefined;
+    navigation_path?: string | undefined;
+    approved_by?: string[] | undefined;
+    escalation_resolved_by?: string | undefined;
 }>;
 /**
  * Validates WU spec completeness for done status
@@ -603,9 +642,9 @@ export declare function validateReadyWU(data: any): z.ZodSafeParseResult<{
  *   }
  * }
  */
-export declare function validateDoneWU(wu: any): {
+export declare function validateDoneWU(wu: WUDoneValidationInput): {
     valid: boolean;
-    errors: any[];
+    errors: string[];
 };
 /**
  * WU-2080: Valid escalation trigger types
@@ -629,10 +668,10 @@ export declare const ESCALATION_TRIGGER_TYPES: string[];
  * @param {object} wu - Validated WU data
  * @returns {{valid: boolean, errors: string[], warnings: string[]}}
  */
-export declare function validateApprovalGates(wu: any): {
+export declare function validateApprovalGates(wu: WUEscalationInput): {
     valid: boolean;
-    errors: any[];
-    warnings: any[];
+    errors: string[];
+    warnings: string[];
 };
 /**
  * WU-2080: Detect escalation triggers from WU content
@@ -643,7 +682,7 @@ export declare function validateApprovalGates(wu: any): {
  * @param {object} wu - WU data with lane, type, code_paths
  * @returns {string[]} Array of triggered escalation types
  */
-export declare function detectEscalationTriggers(wu: any): any[];
+export declare function detectEscalationTriggers(wu: EscalationDetectionInput): string[];
 /**
  * WU-2080: Generate auto-approval metadata for wu:claim
  *
@@ -654,17 +693,17 @@ export declare function detectEscalationTriggers(wu: any): any[];
  * @param {string} agentEmail - Email of claiming agent
  * @returns {{approved_by: string[], approved_at: string, escalation_triggers: string[], requires_human_escalation: boolean}}
  */
-export declare function generateAutoApproval(wu: any, agentEmail: any): {
-    approved_by: any[];
+export declare function generateAutoApproval(wu: EscalationDetectionInput, agentEmail: string): {
+    approved_by: string[];
     approved_at: string;
-    escalation_triggers: any[];
+    escalation_triggers: string[];
     requires_human_escalation: boolean;
 };
 /**
  * @deprecated Use detectEscalationTriggers instead
  * WU-2079: Legacy function for backwards compatibility
  */
-export declare function determineRequiredApprovals(wu: any): {
+export declare function determineRequiredApprovals(wu: EscalationDetectionInput): {
     requires_cso_approval: boolean;
     requires_cto_approval: boolean;
     requires_design_approval: boolean;
@@ -680,8 +719,8 @@ export declare function determineRequiredApprovals(wu: any): {
  * Returns:
  * - valid: true if schema validation passes (after normalisations)
  * - normalized: the normalized data (even if validation fails, partial normalization is returned)
- * - errors: validation errors if any
- * - wasNormalized: true if any normalisations were applied
+ * - errors: validation errors if UnsafeAny
+ * - wasNormalized: true if UnsafeAny normalisations were applied
  *
  * @param {unknown} data - Parsed YAML data to validate and normalize
  * @returns {{valid: boolean, normalized: object|null, errors: string[], wasNormalized: boolean}}
@@ -696,82 +735,11 @@ export declare function determineRequiredApprovals(wu: any): {
  *   die(`Validation failed:\n${errors.join('\n')}`);
  * }
  */
-export declare function validateAndNormalizeWUYAML(data: any): {
+export declare function validateAndNormalizeWUYAML(data: unknown): {
     valid: boolean;
-    normalized: any;
+    normalized: z.infer<typeof WUSchema> | null;
     errors: string[];
     wasNormalized: boolean;
-} | {
-    valid: boolean;
-    normalized: {
-        id: string;
-        title: string;
-        lane: string;
-        type: "documentation" | "process" | "feature" | "tooling" | "bug" | "chore" | "refactor";
-        status: "todo" | "ready" | "backlog" | "in_progress" | "blocked" | "done" | "completed" | "cancelled" | "abandoned" | "deferred" | "closed" | "superseded";
-        priority: "P2" | "P1" | "P0" | "P3";
-        created: string;
-        code_paths: string[];
-        tests: {
-            manual?: string[];
-            unit?: string[];
-            integration?: string[];
-            e2e?: string[];
-        };
-        artifacts: string[];
-        dependencies: string[];
-        risks: string[];
-        requires_review: boolean;
-        escalation_triggers: ("budget" | "phi_pii" | "security_p0" | "external_compliance" | "cross_lane_arch")[];
-        requires_human_escalation: boolean;
-        requires_cso_approval: boolean;
-        requires_cto_approval: boolean;
-        requires_design_approval: boolean;
-        description?: string;
-        acceptance?: string[] | Record<string, string[]>;
-        initiative?: string;
-        phase?: number;
-        blocks?: string[];
-        blocked_by?: string[];
-        labels?: string[];
-        spec_refs?: {
-            section: string;
-            file?: string;
-        } | (string | {
-            section: string;
-            file?: string;
-        })[];
-        notes?: string;
-        locked?: boolean;
-        completed_at?: string;
-        claimed_mode?: "worktree" | "branch-only" | "worktree-pr" | "branch-pr";
-        claimed_branch?: string;
-        assigned_to?: string;
-        claimed_at?: string;
-        blocked_reason?: string;
-        worktree_path?: string;
-        session_id?: string;
-        agent_sessions?: {
-            session_id: string;
-            started: string;
-            agent_type: "claude-code" | "cursor" | "copilot" | "other";
-            incidents_logged: number;
-            incidents_major: number;
-            completed?: string;
-            context_tier?: 1 | 2 | 3;
-            artifacts?: string[];
-        }[];
-        exposure?: "documentation" | "ui" | "api" | "backend-only";
-        user_journey?: string;
-        ui_pairing_wus?: string[];
-        navigation_path?: string;
-        approved_by?: string[];
-        approved_at?: string;
-        escalation_resolved_by?: string;
-        escalation_resolved_at?: string;
-    };
-    errors: any[];
-    wasNormalized: boolean;
 };
 /**
  * WU-1833: Validate WU spec completeness with advisory warnings
@@ -797,7 +765,8 @@ export declare function validateAndNormalizeWUYAML(data: any): {
  *   }
  * }
  */
-export declare function validateWUCompleteness(wu: any): {
-    warnings: any[];
+export declare function validateWUCompleteness(wu: WUCompletenessInput): {
+    warnings: string[];
 };
+export {};
 //# sourceMappingURL=wu-schema.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"wu-schema.d.ts","sourceRoot":"","sources":["../src/wu-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA6BxB;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,oBAAoB,kBAAkB,CAAC;AAkgBpD;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAIvB,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAAe,CAAC;AAE1C;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAInB,CAAC;AAEH;;;;;;;;;;GAUG;AAEH;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,UAAU,CAAC,IAAI,KAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAE9B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,eAAe,CAAC,IAAI,KAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAEnC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,cAAc,CAAC,EAAE,KAAA;;;EAiBhC;AAUD;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,UAMpC,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,CAAC,EAAE,KAAA;;;;EAiCvC;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,EAAE,KAAA,SAqC1C;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,KAAA,EAAE,UAAU,KAAA;;;;;EAUlD;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,EAAE,KAAA;;;;EAO5C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,KAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyB9C;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,sBAAsB,CAAC,EAAE,KAAA;;EA+CxC"}
+{"version":3,"file":"wu-schema.d.ts","sourceRoot":"","sources":["../src/wu-schema.ts"],"names":[],"mappings":"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"}