@lumenflow/core 3.1.2 → 3.2.0

package/dist/wu-schema.d.ts

@@ -1,772 +0,0 @@
-/**
- * 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";
-        process: "process";
-        feature: "feature";
-        tooling: "tooling";
-        bug: "bug";
-        chore: "chore";
-        refactor: "refactor";
-    }>>;
-    status: z.ZodDefault<z.ZodEnum<{
-        todo: "todo";
-        ready: "ready";
-        backlog: "backlog";
-        in_progress: "in_progress";
-        blocked: "blocked";
-        done: "done";
-        completed: "completed";
-        cancelled: "cancelled";
-        abandoned: "abandoned";
-        deferred: "deferred";
-        closed: "closed";
-        superseded: "superseded";
-    }>>;
-    priority: z.ZodDefault<z.ZodEnum<{
-        P2: "P2";
-        P1: "P1";
-        P0: "P0";
-        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<{
-        documentation: "documentation";
-        ui: "ui";
-        api: "api";
-        "backend-only": "backend-only";
-    }>>;
-    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>;
-    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";
-        process: "process";
-        feature: "feature";
-        tooling: "tooling";
-        bug: "bug";
-        chore: "chore";
-        refactor: "refactor";
-    }>>;
-    status: z.ZodDefault<z.ZodEnum<{
-        todo: "todo";
-        ready: "ready";
-        backlog: "backlog";
-        in_progress: "in_progress";
-        blocked: "blocked";
-        done: "done";
-        completed: "completed";
-        cancelled: "cancelled";
-        abandoned: "abandoned";
-        deferred: "deferred";
-        closed: "closed";
-        superseded: "superseded";
-    }>>;
-    priority: z.ZodDefault<z.ZodEnum<{
-        P2: "P2";
-        P1: "P1";
-        P0: "P0";
-        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<{
-        documentation: "documentation";
-        ui: "ui";
-        api: "api";
-        "backend-only": "backend-only";
-    }>>;
-    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>;
-    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";
-        process: "process";
-        feature: "feature";
-        tooling: "tooling";
-        bug: "bug";
-        chore: "chore";
-        refactor: "refactor";
-    }>>;
-    status: z.ZodDefault<z.ZodEnum<{
-        todo: "todo";
-        ready: "ready";
-        backlog: "backlog";
-        in_progress: "in_progress";
-        blocked: "blocked";
-        done: "done";
-        completed: "completed";
-        cancelled: "cancelled";
-        abandoned: "abandoned";
-        deferred: "deferred";
-        closed: "closed";
-        superseded: "superseded";
-    }>>;
-    priority: z.ZodDefault<z.ZodEnum<{
-        P2: "P2";
-        P1: "P1";
-        P0: "P0";
-        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<{
-        documentation: "documentation";
-        ui: "ui";
-        api: "api";
-        "backend-only": "backend-only";
-    }>>;
-    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>;
-    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" | "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[] | 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 | 2 | 3;
-        incidents_logged: number;
-        incidents_major: number;
-        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)
- *
- * 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" | "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[] | 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 | 2 | 3;
-        incidents_logged: number;
-        incidents_major: number;
-        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
- *
- * 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