@lumenflow/packs-software-delivery 4.24.0 → 5.0.0

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

@@ -0,0 +1,831 @@
+/**
+ * Work Unit YAML Schema
+ *
+ * Zod schema for runtime validation of WU YAML structure.
+ * Provides compile-time type inference and semantic validation.
+ *
+ * Part of WU-1162: Add Zod schema validation to prevent placeholder WU completions
+ * Part of WU-1539: Add BaseWUSchema pattern for create/edit validation
+ *
+ * Schema Architecture (DRY pattern):
+ * - BaseWUSchema: Structural validation only (field types, formats, lengths)
+ * - WUSchema: Extends base + placeholder rejection (for wu:claim, wu:done)
+ * - ReadyWUSchema: Alias for BaseWUSchema (for wu:create, wu:edit)
+ *
+ * @see {@link packages/@lumenflow/cli/src/wu-done.ts} - Consumer (validates spec completeness, uses WUSchema)
+ * @see {@link packages/@lumenflow/cli/src/wu-claim.ts} - Consumer (validates spec completeness, uses WUSchema)
+ * @see {@link packages/@lumenflow/cli/src/wu-create.ts} - Consumer (structural validation, uses ReadyWUSchema)
+ * @see {@link packages/@lumenflow/cli/src/wu-edit.ts} - Consumer (structural validation, uses ReadyWUSchema)
+ * @see {@link packages/@lumenflow/cli/src/validate.ts} - Consumer (CI validation)
+ * @see {@link apps/web/src/lib/llm/schemas/orchestrator.ts} - Pattern reference
+ */
+import { z } from 'zod';
+/**
+ * Placeholder sentinel constant
+ *
+ * Used in wu:create template generation and validation.
+ * Single source of truth for placeholder detection (DRY principle).
+ *
+ * @example
+ * // tools/wu-create.ts
+ * description: `${PLACEHOLDER_SENTINEL} Describe the work...`
+ *
+ * @example
+ * // tools/validate.ts
+ * 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)
+ *
+ * WU-1539: Used by wu:create and wu:edit for fail-fast structural validation.
+ * Allows placeholder markers - only checks field types, formats, and lengths.
+ *
+ * Use case: Validate WU structure at creation/edit time before placeholders are filled.
+ */
+export declare const BaseWUSchema: z.ZodObject<{
+    description: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+    acceptance: z.ZodUnion<readonly [z.ZodPipe<z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string[], string[]>>, z.ZodArray<z.ZodString>>, z.ZodRecord<z.ZodString, z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string[], string[]>>>]>;
+    id: z.ZodString;
+    title: z.ZodString;
+    lane: z.ZodString;
+    type: z.ZodDefault<z.ZodEnum<{
+        documentation: "documentation";
+        feature: "feature";
+        bug: "bug";
+        process: "process";
+        tooling: "tooling";
+        chore: "chore";
+        refactor: "refactor";
+    }>>;
+    status: z.ZodDefault<z.ZodEnum<{
+        in_progress: "in_progress";
+        todo: "todo";
+        ready: "ready";
+        backlog: "backlog";
+        blocked: "blocked";
+        done: "done";
+        completed: "completed";
+        cancelled: "cancelled";
+        abandoned: "abandoned";
+        deferred: "deferred";
+        closed: "closed";
+        superseded: "superseded";
+    }>>;
+    priority: z.ZodDefault<z.ZodEnum<{
+        P2: "P2";
+        P0: "P0";
+        P1: "P1";
+        P3: "P3";
+    }>>;
+    created: z.ZodString;
+    code_paths: z.ZodDefault<z.ZodPipe<z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string[], string[]>>, z.ZodArray<z.ZodString>>>;
+    tests: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+        manual: z.ZodOptional<z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string[], string[]>>>;
+        unit: z.ZodOptional<z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string[], string[]>>>;
+        integration: z.ZodOptional<z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string[], string[]>>>;
+        e2e: z.ZodOptional<z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string[], string[]>>>;
+    }, z.core.$strip>>>;
+    artifacts: z.ZodDefault<z.ZodOptional<z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string[], string[]>>>>;
+    dependencies: z.ZodDefault<z.ZodOptional<z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string[], string[]>>>>;
+    initiative: z.ZodOptional<z.ZodString>;
+    phase: z.ZodOptional<z.ZodNumber>;
+    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;
+    }, z.core.$strip>, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        file: z.ZodOptional<z.ZodString>;
+        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[] | 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 | undefined, string | undefined>>;
+    claimed_mode: z.ZodOptional<z.ZodEnum<{
+        worktree: "worktree";
+        "branch-only": "branch-only";
+        "worktree-pr": "worktree-pr";
+        "branch-pr": "branch-pr";
+    }>>;
+    claimed_branch: z.ZodOptional<z.ZodString>;
+    assigned_to: z.ZodOptional<z.ZodString>;
+    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>;
+    agent_sessions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        session_id: z.ZodString;
+        started: z.ZodString;
+        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";
+        }>;
+        context_tier: z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>]>;
+        incidents_logged: z.ZodDefault<z.ZodNumber>;
+        incidents_major: z.ZodDefault<z.ZodNumber>;
+        artifacts: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>>;
+    exposure: z.ZodOptional<z.ZodEnum<{
+        ui: "ui";
+        api: "api";
+        "backend-only": "backend-only";
+        documentation: "documentation";
+    }>>;
+    user_journey: z.ZodOptional<z.ZodString>;
+    ui_pairing_wus: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string[], string[]>>, z.ZodArray<z.ZodString>>>;
+    navigation_path: z.ZodOptional<z.ZodString>;
+    sizing_estimate: z.ZodOptional<z.ZodObject<{
+        estimated_files: z.ZodNumber;
+        estimated_tool_calls: z.ZodNumber;
+        strategy: z.ZodEnum<{
+            "single-session": "single-session";
+            "checkpoint-resume": "checkpoint-resume";
+            "orchestrator-worker": "orchestrator-worker";
+            decomposition: "decomposition";
+        }>;
+        exception_type: z.ZodOptional<z.ZodEnum<{
+            "docs-only": "docs-only";
+            "shallow-multi-file": "shallow-multi-file";
+        }>>;
+        exception_reason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    escalation_triggers: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        budget: "budget";
+        sensitive_data: "sensitive_data";
+        security_p0: "security_p0";
+        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 | undefined, string | undefined>>;
+    escalation_resolved_by: z.ZodOptional<z.ZodString>;
+    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>>;
+}, z.core.$strip>;
+/**
+ * Ready WU Schema (alias for BaseWUSchema)
+ *
+ * WU-1539: Semantic alias for clarity in wu:create and wu:edit.
+ * Same validation as BaseWUSchema - allows placeholders, enforces structure.
+ */
+export declare const ReadyWUSchema: z.ZodObject<{
+    description: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+    acceptance: z.ZodUnion<readonly [z.ZodPipe<z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string[], string[]>>, z.ZodArray<z.ZodString>>, z.ZodRecord<z.ZodString, z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string[], string[]>>>]>;
+    id: z.ZodString;
+    title: z.ZodString;
+    lane: z.ZodString;
+    type: z.ZodDefault<z.ZodEnum<{
+        documentation: "documentation";
+        feature: "feature";
+        bug: "bug";
+        process: "process";
+        tooling: "tooling";
+        chore: "chore";
+        refactor: "refactor";
+    }>>;
+    status: z.ZodDefault<z.ZodEnum<{
+        in_progress: "in_progress";
+        todo: "todo";
+        ready: "ready";
+        backlog: "backlog";
+        blocked: "blocked";
+        done: "done";
+        completed: "completed";
+        cancelled: "cancelled";
+        abandoned: "abandoned";
+        deferred: "deferred";
+        closed: "closed";
+        superseded: "superseded";
+    }>>;
+    priority: z.ZodDefault<z.ZodEnum<{
+        P2: "P2";
+        P0: "P0";
+        P1: "P1";
+        P3: "P3";
+    }>>;
+    created: z.ZodString;
+    code_paths: z.ZodDefault<z.ZodPipe<z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string[], string[]>>, z.ZodArray<z.ZodString>>>;
+    tests: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+        manual: z.ZodOptional<z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string[], string[]>>>;
+        unit: z.ZodOptional<z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string[], string[]>>>;
+        integration: z.ZodOptional<z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string[], string[]>>>;
+        e2e: z.ZodOptional<z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string[], string[]>>>;
+    }, z.core.$strip>>>;
+    artifacts: z.ZodDefault<z.ZodOptional<z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string[], string[]>>>>;
+    dependencies: z.ZodDefault<z.ZodOptional<z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string[], string[]>>>>;
+    initiative: z.ZodOptional<z.ZodString>;
+    phase: z.ZodOptional<z.ZodNumber>;
+    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;
+    }, z.core.$strip>, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        file: z.ZodOptional<z.ZodString>;
+        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[] | 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 | undefined, string | undefined>>;
+    claimed_mode: z.ZodOptional<z.ZodEnum<{
+        worktree: "worktree";
+        "branch-only": "branch-only";
+        "worktree-pr": "worktree-pr";
+        "branch-pr": "branch-pr";
+    }>>;
+    claimed_branch: z.ZodOptional<z.ZodString>;
+    assigned_to: z.ZodOptional<z.ZodString>;
+    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>;
+    agent_sessions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        session_id: z.ZodString;
+        started: z.ZodString;
+        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";
+        }>;
+        context_tier: z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>]>;
+        incidents_logged: z.ZodDefault<z.ZodNumber>;
+        incidents_major: z.ZodDefault<z.ZodNumber>;
+        artifacts: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>>;
+    exposure: z.ZodOptional<z.ZodEnum<{
+        ui: "ui";
+        api: "api";
+        "backend-only": "backend-only";
+        documentation: "documentation";
+    }>>;
+    user_journey: z.ZodOptional<z.ZodString>;
+    ui_pairing_wus: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string[], string[]>>, z.ZodArray<z.ZodString>>>;
+    navigation_path: z.ZodOptional<z.ZodString>;
+    sizing_estimate: z.ZodOptional<z.ZodObject<{
+        estimated_files: z.ZodNumber;
+        estimated_tool_calls: z.ZodNumber;
+        strategy: z.ZodEnum<{
+            "single-session": "single-session";
+            "checkpoint-resume": "checkpoint-resume";
+            "orchestrator-worker": "orchestrator-worker";
+            decomposition: "decomposition";
+        }>;
+        exception_type: z.ZodOptional<z.ZodEnum<{
+            "docs-only": "docs-only";
+            "shallow-multi-file": "shallow-multi-file";
+        }>>;
+        exception_reason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    escalation_triggers: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        budget: "budget";
+        sensitive_data: "sensitive_data";
+        security_p0: "security_p0";
+        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 | undefined, string | undefined>>;
+    escalation_resolved_by: z.ZodOptional<z.ZodString>;
+    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>>;
+}, z.core.$strip>;
+/**
+ * Strict WU Schema (structural + placeholder rejection)
+ *
+ * Validates WU files against LumenFlow requirements:
+ * - No placeholder text in done WUs
+ * - Minimum description length (50 chars)
+ * - Code paths present for non-documentation WUs
+ * - Proper status/lane/type enums
+ *
+ * Used by wu:claim and wu:done to ensure specs are complete.
+ * Provides runtime validation and TypeScript type inference.
+ */
+export declare const WUSchema: z.ZodObject<{
+    description: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+    acceptance: z.ZodUnion<readonly [z.ZodPipe<z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string[], string[]>>, z.ZodArray<z.ZodString>>, z.ZodRecord<z.ZodString, z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string[], string[]>>>]>;
+    id: z.ZodString;
+    title: z.ZodString;
+    lane: z.ZodString;
+    type: z.ZodDefault<z.ZodEnum<{
+        documentation: "documentation";
+        feature: "feature";
+        bug: "bug";
+        process: "process";
+        tooling: "tooling";
+        chore: "chore";
+        refactor: "refactor";
+    }>>;
+    status: z.ZodDefault<z.ZodEnum<{
+        in_progress: "in_progress";
+        todo: "todo";
+        ready: "ready";
+        backlog: "backlog";
+        blocked: "blocked";
+        done: "done";
+        completed: "completed";
+        cancelled: "cancelled";
+        abandoned: "abandoned";
+        deferred: "deferred";
+        closed: "closed";
+        superseded: "superseded";
+    }>>;
+    priority: z.ZodDefault<z.ZodEnum<{
+        P2: "P2";
+        P0: "P0";
+        P1: "P1";
+        P3: "P3";
+    }>>;
+    created: z.ZodString;
+    code_paths: z.ZodDefault<z.ZodPipe<z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string[], string[]>>, z.ZodArray<z.ZodString>>>;
+    tests: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+        manual: z.ZodOptional<z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string[], string[]>>>;
+        unit: z.ZodOptional<z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string[], string[]>>>;
+        integration: z.ZodOptional<z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string[], string[]>>>;
+        e2e: z.ZodOptional<z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string[], string[]>>>;
+    }, z.core.$strip>>>;
+    artifacts: z.ZodDefault<z.ZodOptional<z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string[], string[]>>>>;
+    dependencies: z.ZodDefault<z.ZodOptional<z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string[], string[]>>>>;
+    initiative: z.ZodOptional<z.ZodString>;
+    phase: z.ZodOptional<z.ZodNumber>;
+    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;
+    }, z.core.$strip>, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        file: z.ZodOptional<z.ZodString>;
+        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[] | 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 | undefined, string | undefined>>;
+    claimed_mode: z.ZodOptional<z.ZodEnum<{
+        worktree: "worktree";
+        "branch-only": "branch-only";
+        "worktree-pr": "worktree-pr";
+        "branch-pr": "branch-pr";
+    }>>;
+    claimed_branch: z.ZodOptional<z.ZodString>;
+    assigned_to: z.ZodOptional<z.ZodString>;
+    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>;
+    agent_sessions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        session_id: z.ZodString;
+        started: z.ZodString;
+        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";
+        }>;
+        context_tier: z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>]>;
+        incidents_logged: z.ZodDefault<z.ZodNumber>;
+        incidents_major: z.ZodDefault<z.ZodNumber>;
+        artifacts: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>>;
+    exposure: z.ZodOptional<z.ZodEnum<{
+        ui: "ui";
+        api: "api";
+        "backend-only": "backend-only";
+        documentation: "documentation";
+    }>>;
+    user_journey: z.ZodOptional<z.ZodString>;
+    ui_pairing_wus: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string[], string[]>>, z.ZodArray<z.ZodString>>>;
+    navigation_path: z.ZodOptional<z.ZodString>;
+    sizing_estimate: z.ZodOptional<z.ZodObject<{
+        estimated_files: z.ZodNumber;
+        estimated_tool_calls: z.ZodNumber;
+        strategy: z.ZodEnum<{
+            "single-session": "single-session";
+            "checkpoint-resume": "checkpoint-resume";
+            "orchestrator-worker": "orchestrator-worker";
+            decomposition: "decomposition";
+        }>;
+        exception_type: z.ZodOptional<z.ZodEnum<{
+            "docs-only": "docs-only";
+            "shallow-multi-file": "shallow-multi-file";
+        }>>;
+        exception_reason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    escalation_triggers: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        budget: "budget";
+        sensitive_data: "sensitive_data";
+        security_p0: "security_p0";
+        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 | undefined, string | undefined>>;
+    escalation_resolved_by: z.ZodOptional<z.ZodString>;
+    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>>;
+}, z.core.$strip>;
+/**
+ * TypeScript type inferred from schema
+ *
+ * Single source of truth for both runtime validation and compile-time types.
+ * Replaces manual WU interfaces (DRY principle).
+ *
+ * Note: Type inference available in TypeScript via z.infer<typeof WUSchema>
+ * This is a JavaScript file, so the type export is not needed here.
+ *
+ * @typedef {import('zod').z.infer<typeof WUSchema>} WU
+ */
+/**
+ * Validates WU data against strict schema (placeholder rejection)
+ *
+ * Used by wu:claim and wu:done to ensure specs are complete.
+ * Rejects WUs with placeholder markers.
+ *
+ * @param {unknown} data - Parsed YAML data to validate
+ * @returns {z.SafeParseReturnType<WU, WU>} Validation result
+ *
+ * @example
+ * const result = validateWU(yamlData);
+ * if (!result.success) {
+ *   result.error.issues.forEach(issue => {
+ *     console.error(`${issue.path.join('.')}: ${issue.message}`);
+ *   });
+ * }
+ */
+export declare function validateWU(data: unknown): z.ZodSafeParseResult<{
+    description: string;
+    acceptance: string[] | Record<string, string[]>;
+    id: string;
+    title: string;
+    lane: string;
+    type: "documentation" | "feature" | "bug" | "process" | "tooling" | "chore" | "refactor";
+    status: "in_progress" | "todo" | "ready" | "backlog" | "blocked" | "done" | "completed" | "cancelled" | "abandoned" | "deferred" | "closed" | "superseded";
+    priority: "P2" | "P0" | "P1" | "P3";
+    created: string;
+    code_paths: string[];
+    tests: {
+        manual?: string[] | undefined;
+        unit?: string[] | undefined;
+        integration?: string[] | undefined;
+        e2e?: string[] | undefined;
+    };
+    artifacts: string[];
+    dependencies: string[];
+    risks: string[];
+    notes: string;
+    requires_review: boolean;
+    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;
+    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 | undefined;
+    } | (string | {
+        section: 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 | 3 | 2;
+        incidents_logged: number;
+        incidents_major: number;
+        completed?: string | undefined;
+        artifacts?: string[] | undefined;
+    }[] | undefined;
+    exposure?: "ui" | "api" | "backend-only" | "documentation" | undefined;
+    user_journey?: string | undefined;
+    ui_pairing_wus?: string[] | undefined;
+    navigation_path?: string | undefined;
+    sizing_estimate?: {
+        estimated_files: number;
+        estimated_tool_calls: number;
+        strategy: "single-session" | "checkpoint-resume" | "orchestrator-worker" | "decomposition";
+        exception_type?: "docs-only" | "shallow-multi-file" | undefined;
+        exception_reason?: string | undefined;
+    } | undefined;
+    approved_by?: string[] | undefined;
+    escalation_resolved_by?: string | undefined;
+}>;
+/**
+ * Validates WU data against base schema (structural only)
+ *
+ * WU-1539: Used by wu:create and wu:edit for fail-fast structural validation.
+ * Allows placeholder markers - only checks field types, formats, and lengths.
+ *
+ * @param {unknown} data - Parsed YAML data to validate
+ * @returns {z.SafeParseReturnType<WU, WU>} Validation result
+ *
+ * @example
+ * const result = validateReadyWU(yamlData);
+ * if (!result.success) {
+ *   const errors = result.error.issues
+ *     .map(issue => `  • ${issue.path.join('.')}: ${issue.message}`)
+ *     .join('\n');
+ *   die(`WU YAML validation failed:\n\n${errors}`);
+ * }
+ */
+export declare function validateReadyWU(data: unknown): z.ZodSafeParseResult<{
+    description: string;
+    acceptance: string[] | Record<string, string[]>;
+    id: string;
+    title: string;
+    lane: string;
+    type: "documentation" | "feature" | "bug" | "process" | "tooling" | "chore" | "refactor";
+    status: "in_progress" | "todo" | "ready" | "backlog" | "blocked" | "done" | "completed" | "cancelled" | "abandoned" | "deferred" | "closed" | "superseded";
+    priority: "P2" | "P0" | "P1" | "P3";
+    created: string;
+    code_paths: string[];
+    tests: {
+        manual?: string[] | undefined;
+        unit?: string[] | undefined;
+        integration?: string[] | undefined;
+        e2e?: string[] | undefined;
+    };
+    artifacts: string[];
+    dependencies: string[];
+    risks: string[];
+    notes: string;
+    requires_review: boolean;
+    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;
+    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 | undefined;
+    } | (string | {
+        section: 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 | 3 | 2;
+        incidents_logged: number;
+        incidents_major: number;
+        completed?: string | undefined;
+        artifacts?: string[] | undefined;
+    }[] | undefined;
+    exposure?: "ui" | "api" | "backend-only" | "documentation" | undefined;
+    user_journey?: string | undefined;
+    ui_pairing_wus?: string[] | undefined;
+    navigation_path?: string | undefined;
+    sizing_estimate?: {
+        estimated_files: number;
+        estimated_tool_calls: number;
+        strategy: "single-session" | "checkpoint-resume" | "orchestrator-worker" | "decomposition";
+        exception_type?: "docs-only" | "shallow-multi-file" | undefined;
+        exception_reason?: string | undefined;
+    } | undefined;
+    approved_by?: string[] | undefined;
+    escalation_resolved_by?: string | undefined;
+}>;
+/**
+ * Validates WU spec completeness for done status
+ *
+ * Additional validation beyond schema for WUs marked as done:
+ * - Code paths required for non-documentation WUs
+ * - Locked must be true
+ * - Completed timestamp must be present
+ *
+ * @param {WU} wu - Validated WU data
+ * @returns {{valid: boolean, errors: string[]}} Validation result
+ *
+ * @example
+ * const schemaResult = validateWU(data);
+ * if (schemaResult.success && data.status === 'done') {
+ *   const completenessResult = validateDoneWU(schemaResult.data);
+ *   if (!completenessResult.valid) {
+ *     console.error(completenessResult.errors);
+ *   }
+ * }
+ */
+export declare function validateDoneWU(wu: WUDoneValidationInput): {
+    valid: boolean;
+    errors: string[];
+};
+/**
+ * WU-2080: Valid escalation trigger types
+ *
+ * These are the only conditions that require human intervention.
+ * Everything else is auto-approved by agents.
+ */
+export declare const ESCALATION_TRIGGER_TYPES: string[];
+/**
+ * WU-2080: Agent-first approval validation
+ *
+ * AGENT-FIRST MODEL: Agents auto-approve by default.
+ * Human escalation only when escalation_triggers is non-empty
+ * AND requires_human_escalation is true AND not yet resolved.
+ *
+ * Returns:
+ * - valid: true if agent can proceed (no unresolved escalation)
+ * - errors: blocking issues requiring human resolution
+ * - warnings: advisory messages (non-blocking)
+ *
+ * @param {object} wu - Validated WU data
+ * @returns {{valid: boolean, errors: string[], warnings: string[]}}
+ */
+export declare function validateApprovalGates(wu: WUEscalationInput): {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+};
+/**
+ * WU-2080: Detect escalation triggers from WU content
+ *
+ * Analyzes WU metadata to detect conditions requiring human escalation.
+ * Called by wu:claim to auto-set escalation_triggers.
+ *
+ * @param {object} wu - WU data with lane, type, code_paths
+ * @returns {string[]} Array of triggered escalation types
+ */
+export declare function detectEscalationTriggers(wu: EscalationDetectionInput): string[];
+/**
+ * WU-2080: Generate auto-approval metadata for wu:claim
+ *
+ * Called by wu:claim to auto-approve agents within policy.
+ * Sets approved_by and approved_at, detects escalation triggers.
+ *
+ * @param {object} wu - WU data
+ * @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: EscalationDetectionInput, agentEmail: string): {
+    approved_by: string[];
+    approved_at: string;
+    escalation_triggers: string[];
+    requires_human_escalation: boolean;
+};
+/**
+ * @deprecated Use detectEscalationTriggers instead
+ * WU-2079: Legacy function for backwards compatibility
+ */
+export declare function determineRequiredApprovals(wu: EscalationDetectionInput): {
+    requires_cso_approval: boolean;
+    requires_cto_approval: boolean;
+    requires_design_approval: boolean;
+};
+/**
+ * WU-1811: Validates and normalizes WU YAML data with auto-fixable normalisations
+ *
+ * This function validates the WU YAML schema and applies fixable normalisations:
+ * - Trimming whitespace from string fields
+ * - Normalizing escaped newlines (\\n → \n)
+ * - Splitting embedded newlines in arrays (["a\nb"] → ["a", "b"])
+ *
+ * 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 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}}
+ *
+ * @example
+ * const { valid, normalized, errors, wasNormalized } = validateAndNormalizeWUYAML(yamlData);
+ * if (valid && wasNormalized) {
+ *   // Write normalized data back to YAML file
+ *   writeWU(wuPath, normalized);
+ * }
+ * if (!valid) {
+ *   die(`Validation failed:\n${errors.join('\n')}`);
+ * }
+ */
+export declare function validateAndNormalizeWUYAML(data: unknown): {
+    valid: boolean;
+    normalized: z.infer<typeof WUSchema> | null;
+    errors: string[];
+    wasNormalized: boolean;
+};
+/**
+ * WU-1833: Validate WU spec completeness with advisory warnings
+ *
+ * Provides soft validation that warns (doesn't fail) when recommended fields are missing.
+ * Used by wu:validate command to surface quality issues without blocking workflow.
+ *
+ * Feature and bug WUs should have:
+ * - notes (implementation context, deployment instructions)
+ * - tests.manual (verification steps)
+ * - spec_refs (links to plans, design docs) - for features only
+ *
+ * @param {object} wu - Validated WU data (must pass WUSchema first)
+ * @returns {{warnings: string[]}} Array of warning messages
+ *
+ * @example
+ * const schemaResult = validateWU(data);
+ * if (schemaResult.success) {
+ *   const { warnings } = validateWUCompleteness(schemaResult.data);
+ *   if (warnings.length > 0) {
+ *     console.warn('Quality warnings:');
+ *     warnings.forEach(w => console.warn(`  ⚠️  ${w}`));
+ *   }
+ * }
+ */
+export declare function validateWUCompleteness(wu: WUCompletenessInput): {
+    warnings: string[];
+};
+export {};
+//# sourceMappingURL=wu-schema.d.ts.map