@lumenflow/core 2.20.0 → 2.21.0

package/dist/wu-schema-normalization.js

@@ -49,8 +49,11 @@ export function normalizeWUSchema(wu) {
                         // Convert { 'Manual test': 'Navigate to /settings' } → 'Manual test: Navigate to /settings'
                         const entries = Object.entries(item);
                         if (entries.length === 1) {
-                            const [k, v] = entries[0];
-                            return `${k}: ${v}`;
+                            const entry = entries[0];
+                            if (entry) {
+                                const [k, v] = entry;
+                                return `${k}: ${v}`;
+                            }
                         }
                     }
                     return item;

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

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

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)
  *
@@ -102,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";
@@ -114,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>;
@@ -147,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>>;
@@ -226,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";
@@ -238,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>;
@@ -271,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>>;
@@ -356,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";
@@ -368,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>;
@@ -401,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>>;
@@ -443,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;
@@ -453,63 +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[];
-    plan?: 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" | "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)
@@ -529,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;
@@ -539,63 +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[];
-    plan?: 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" | "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
@@ -617,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
@@ -643,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
@@ -657,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
  *
@@ -668,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;
@@ -694,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}}
@@ -710,83 +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[];
-        plan?: 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" | "codex-cli" | "cursor" | "gemini-cli" | "windsurf" | "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
@@ -812,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;AAghBpD;;;;;;;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":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA6BxB;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,oBAAoB,kBAAkB,CAAC;AAoBpD,UAAU,qBAAqB;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,UAAU,iBAAiB;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,wBAAwB,CAAC,EAAE,OAAO,CAAC;CACpC;AAED,UAAU,mBAAmB;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE;QACN,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC;IACF,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAQD,KAAK,wBAAwB,GAAG,IAAI,CAAC,iBAAiB,EAAE,MAAM,GAAG,YAAY,GAAG,UAAU,CAAC,CAAC;AA6f5F;;;;;;;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,EAAE,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAEvC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAE5C;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,qBAAqB,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAiB9F;AAUD;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,UAKpC,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,iBAAiB,GAAG;IAC5D,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAiCA;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,EAAE,EAAE,wBAAwB,GAAG,MAAM,EAAE,CAoB/E;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,EAAE,EAAE,wBAAwB,EAC5B,UAAU,EAAE,MAAM,GACjB;IACD,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,yBAAyB,EAAE,OAAO,CAAC;CACpC,CAUA;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,EAAE,EAAE,wBAAwB,GAAG;IACxE,qBAAqB,EAAE,OAAO,CAAC;IAC/B,qBAAqB,EAAE,OAAO,CAAC;IAC/B,wBAAwB,EAAE,OAAO,CAAC;CACnC,CAOA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,OAAO,GAAG;IACzD,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,GAAG,IAAI,CAAC;IAC5C,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,aAAa,EAAE,OAAO,CAAC;CACxB,CA0BA;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,mBAAmB,GAAG;IAAE,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAiDtF"}