@lumenflow/core 3.2.0 → 3.2.1

package/dist/schemas/initiative-schemas.d.ts

@@ -0,0 +1,256 @@
+/**
+ * @file initiative-schemas.ts
+ * @description Shared Zod schemas for Initiative commands (WU-1455)
+ *
+ * These schemas are the single source of truth for initiative command validation.
+ * Both CLI argument parsing and MCP inputSchema derivation use these schemas.
+ *
+ * This file covers the 8 initiative commands that were previously hand-coded
+ * in MCP and CLI separately. Combined with the schemas from command-schemas.ts
+ * (WU-1431) and wu-lifecycle-schemas.ts (WU-1454), this provides full shared
+ * schema coverage for all LumenFlow commands.
+ *
+ * Design decisions:
+ * - Use snake_case for property names (MCP convention, JSON Schema friendly)
+ * - Include descriptions for each field (used in both CLI help and MCP tool descriptions)
+ * - CLI-only aliases are NOT defined here (handled in arg-validators)
+ * - Initiative status enum values match INIT_STATUSES from @lumenflow/initiatives
+ * - Phase status enum values match PHASE_STATUSES from @lumenflow/initiatives
+ */
+import { z } from 'zod';
+/**
+ * Initiative status values (matches INIT_STATUSES from initiative-constants.ts)
+ */
+export declare const initiativeStatusEnum: z.ZodEnum<{
+    in_progress: "in_progress";
+    done: "done";
+    draft: "draft";
+    open: "open";
+    archived: "archived";
+}>;
+export type InitiativeStatus = z.infer<typeof initiativeStatusEnum>;
+/**
+ * Phase status values (matches PHASE_STATUSES from initiative-constants.ts)
+ */
+export declare const phaseStatusEnum: z.ZodEnum<{
+    in_progress: "in_progress";
+    blocked: "blocked";
+    done: "done";
+    pending: "pending";
+}>;
+export type PhaseStatus = z.infer<typeof phaseStatusEnum>;
+/**
+ * Output format values used by initiative:list and initiative:status
+ */
+export declare const outputFormatEnum: z.ZodEnum<{
+    json: "json";
+    table: "table";
+}>;
+/**
+ * Schema for initiative:create command
+ *
+ * Required: id, slug, title
+ * Optional: priority, owner, target_date
+ */
+export declare const initiativeCreateSchema: z.ZodObject<{
+    id: z.ZodString;
+    slug: z.ZodString;
+    title: z.ZodString;
+    priority: z.ZodOptional<z.ZodString>;
+    owner: z.ZodOptional<z.ZodString>;
+    target_date: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type InitiativeCreateInput = z.infer<typeof initiativeCreateSchema>;
+/**
+ * Schema for initiative:edit command
+ *
+ * Required: id
+ * Optional: status, blocked_by, blocked_reason, unblock, add_lane, remove_lane,
+ *           notes, description, add_phase, add_success_metric, phase_id, phase_status, phase_title,
+ *           created
+ */
+export declare const initiativeEditSchema: z.ZodObject<{
+    id: z.ZodString;
+    status: z.ZodOptional<z.ZodEnum<{
+        in_progress: "in_progress";
+        done: "done";
+        draft: "draft";
+        open: "open";
+        archived: "archived";
+    }>>;
+    blocked_by: z.ZodOptional<z.ZodString>;
+    blocked_reason: z.ZodOptional<z.ZodString>;
+    unblock: z.ZodOptional<z.ZodBoolean>;
+    add_lane: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    remove_lane: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    notes: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    add_phase: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    add_success_metric: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    phase_id: z.ZodOptional<z.ZodString>;
+    phase_status: z.ZodOptional<z.ZodEnum<{
+        in_progress: "in_progress";
+        blocked: "blocked";
+        done: "done";
+        pending: "pending";
+    }>>;
+    phase_title: z.ZodOptional<z.ZodString>;
+    created: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type InitiativeEditInput = z.infer<typeof initiativeEditSchema>;
+/**
+ * Schema for initiative:list command
+ *
+ * No required fields
+ * Optional: status, format, color
+ */
+export declare const initiativeListSchema: z.ZodObject<{
+    status: z.ZodOptional<z.ZodString>;
+    format: z.ZodOptional<z.ZodEnum<{
+        json: "json";
+        table: "table";
+    }>>;
+    color: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type InitiativeListInput = z.infer<typeof initiativeListSchema>;
+/**
+ * Schema for initiative:status command
+ *
+ * Required: id
+ * Optional: format, color
+ */
+export declare const initiativeStatusSchema: z.ZodObject<{
+    id: z.ZodString;
+    format: z.ZodOptional<z.ZodEnum<{
+        json: "json";
+        table: "table";
+    }>>;
+    color: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type InitiativeStatusInput = z.infer<typeof initiativeStatusSchema>;
+/**
+ * Schema for initiative:add-wu command
+ *
+ * Required: initiative, wu
+ * Optional: phase
+ */
+export declare const initiativeAddWuSchema: z.ZodObject<{
+    initiative: z.ZodString;
+    wu: z.ZodString;
+    phase: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type InitiativeAddWuInput = z.infer<typeof initiativeAddWuSchema>;
+/**
+ * Schema for initiative:remove-wu command
+ *
+ * Required: initiative, wu
+ */
+export declare const initiativeRemoveWuSchema: z.ZodObject<{
+    initiative: z.ZodString;
+    wu: z.ZodString;
+}, z.core.$strip>;
+export type InitiativeRemoveWuInput = z.infer<typeof initiativeRemoveWuSchema>;
+/**
+ * Schema for initiative:bulk-assign command
+ *
+ * No required fields (defaults to dry-run)
+ * Optional: config, apply, sync_from_initiative
+ */
+export declare const initiativeBulkAssignSchema: z.ZodObject<{
+    config: z.ZodOptional<z.ZodString>;
+    apply: z.ZodOptional<z.ZodBoolean>;
+    sync_from_initiative: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type InitiativeBulkAssignInput = z.infer<typeof initiativeBulkAssignSchema>;
+/**
+ * Schema for initiative:plan command
+ *
+ * Required: initiative
+ * Optional: plan, create
+ */
+export declare const initiativePlanSchema: z.ZodObject<{
+    initiative: z.ZodString;
+    plan: z.ZodOptional<z.ZodString>;
+    create: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type InitiativePlanInput = z.infer<typeof initiativePlanSchema>;
+/**
+ * Registry of all initiative command schemas for validation and parity checking.
+ * These complement the schemas in command-schemas.ts (WU-1431) and
+ * wu-lifecycle-schemas.ts (WU-1454).
+ */
+export declare const initiativeCommandSchemas: {
+    readonly 'initiative:create': z.ZodObject<{
+        id: z.ZodString;
+        slug: z.ZodString;
+        title: z.ZodString;
+        priority: z.ZodOptional<z.ZodString>;
+        owner: z.ZodOptional<z.ZodString>;
+        target_date: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    readonly 'initiative:edit': z.ZodObject<{
+        id: z.ZodString;
+        status: z.ZodOptional<z.ZodEnum<{
+            in_progress: "in_progress";
+            done: "done";
+            draft: "draft";
+            open: "open";
+            archived: "archived";
+        }>>;
+        blocked_by: z.ZodOptional<z.ZodString>;
+        blocked_reason: z.ZodOptional<z.ZodString>;
+        unblock: z.ZodOptional<z.ZodBoolean>;
+        add_lane: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        remove_lane: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        notes: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        add_phase: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        add_success_metric: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        phase_id: z.ZodOptional<z.ZodString>;
+        phase_status: z.ZodOptional<z.ZodEnum<{
+            in_progress: "in_progress";
+            blocked: "blocked";
+            done: "done";
+            pending: "pending";
+        }>>;
+        phase_title: z.ZodOptional<z.ZodString>;
+        created: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    readonly 'initiative:list': z.ZodObject<{
+        status: z.ZodOptional<z.ZodString>;
+        format: z.ZodOptional<z.ZodEnum<{
+            json: "json";
+            table: "table";
+        }>>;
+        color: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>;
+    readonly 'initiative:status': z.ZodObject<{
+        id: z.ZodString;
+        format: z.ZodOptional<z.ZodEnum<{
+            json: "json";
+            table: "table";
+        }>>;
+        color: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>;
+    readonly 'initiative:add-wu': z.ZodObject<{
+        initiative: z.ZodString;
+        wu: z.ZodString;
+        phase: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>;
+    readonly 'initiative:remove-wu': z.ZodObject<{
+        initiative: z.ZodString;
+        wu: z.ZodString;
+    }, z.core.$strip>;
+    readonly 'initiative:bulk-assign': z.ZodObject<{
+        config: z.ZodOptional<z.ZodString>;
+        apply: z.ZodOptional<z.ZodBoolean>;
+        sync_from_initiative: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    readonly 'initiative:plan': z.ZodObject<{
+        initiative: z.ZodString;
+        plan: z.ZodOptional<z.ZodString>;
+        create: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>;
+};
+export type InitiativeCommandName = keyof typeof initiativeCommandSchemas;
+//# sourceMappingURL=initiative-schemas.d.ts.map

package/dist/schemas/initiative-schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"initiative-schemas.d.ts","sourceRoot":"","sources":["../../src/schemas/initiative-schemas.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;EAA+D,CAAC;AACjG,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;EAAwD,CAAC;AACrF,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE1D;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;EAA4B,CAAC;AAM1D;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB;;;;;;;iBAOjC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAM3E;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAmB/B,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAMvE;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB;;;;;;;iBAI/B,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAMvE;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB;;;;;;;iBAIjC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAM3E;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB;;;;iBAIhC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAMzE;;;;GAIG;AACH,eAAO,MAAM,wBAAwB;;;iBAGnC,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAM/E;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B;;;;iBAIrC,CAAC;AAEH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAMnF;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB;;;;iBAI/B,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAMvE;;;;GAIG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAS3B,CAAC;AAEX,MAAM,MAAM,qBAAqB,GAAG,MAAM,OAAO,wBAAwB,CAAC"}

package/dist/schemas/initiative-schemas.js

@@ -0,0 +1,186 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * @file initiative-schemas.ts
+ * @description Shared Zod schemas for Initiative commands (WU-1455)
+ *
+ * These schemas are the single source of truth for initiative command validation.
+ * Both CLI argument parsing and MCP inputSchema derivation use these schemas.
+ *
+ * This file covers the 8 initiative commands that were previously hand-coded
+ * in MCP and CLI separately. Combined with the schemas from command-schemas.ts
+ * (WU-1431) and wu-lifecycle-schemas.ts (WU-1454), this provides full shared
+ * schema coverage for all LumenFlow commands.
+ *
+ * Design decisions:
+ * - Use snake_case for property names (MCP convention, JSON Schema friendly)
+ * - Include descriptions for each field (used in both CLI help and MCP tool descriptions)
+ * - CLI-only aliases are NOT defined here (handled in arg-validators)
+ * - Initiative status enum values match INIT_STATUSES from @lumenflow/initiatives
+ * - Phase status enum values match PHASE_STATUSES from @lumenflow/initiatives
+ */
+import { z } from 'zod';
+// =============================================================================
+// Shared Enums
+// =============================================================================
+/**
+ * Initiative status values (matches INIT_STATUSES from initiative-constants.ts)
+ */
+export const initiativeStatusEnum = z.enum(['draft', 'open', 'in_progress', 'done', 'archived']);
+/**
+ * Phase status values (matches PHASE_STATUSES from initiative-constants.ts)
+ */
+export const phaseStatusEnum = z.enum(['pending', 'in_progress', 'done', 'blocked']);
+/**
+ * Output format values used by initiative:list and initiative:status
+ */
+export const outputFormatEnum = z.enum(['table', 'json']);
+// =============================================================================
+// initiative:create Schema
+// =============================================================================
+/**
+ * Schema for initiative:create command
+ *
+ * Required: id, slug, title
+ * Optional: priority, owner, target_date
+ */
+export const initiativeCreateSchema = z.object({
+    id: z.string().describe('Initiative ID (e.g., INIT-001)'),
+    slug: z.string().describe('Initiative slug (kebab-case, e.g., my-initiative)'),
+    title: z.string().describe('Initiative title'),
+    priority: z.string().optional().describe('Priority level (P0, P1, P2, P3)'),
+    owner: z.string().optional().describe('Owner email or name'),
+    target_date: z.string().optional().describe('Target completion date (YYYY-MM-DD)'),
+});
+// =============================================================================
+// initiative:edit Schema
+// =============================================================================
+/**
+ * Schema for initiative:edit command
+ *
+ * Required: id
+ * Optional: status, blocked_by, blocked_reason, unblock, add_lane, remove_lane,
+ *           notes, description, add_phase, add_success_metric, phase_id, phase_status, phase_title,
+ *           created
+ */
+export const initiativeEditSchema = z.object({
+    id: z.string().describe('Initiative ID to edit'),
+    status: initiativeStatusEnum.optional().describe('New initiative status'),
+    blocked_by: z.string().optional().describe('Initiative ID that blocks this initiative'),
+    blocked_reason: z.string().optional().describe('Reason for blocking'),
+    unblock: z.boolean().optional().describe('Remove blocked_by and blocked_reason fields'),
+    add_lane: z.array(z.string()).optional().describe('Lanes to add (repeatable)'),
+    remove_lane: z.array(z.string()).optional().describe('Lanes to remove (repeatable)'),
+    notes: z.string().optional().describe('Note to append to notes array'),
+    description: z.string().optional().describe('Replace the initiative description field'),
+    add_phase: z.array(z.string()).optional().describe('Phase titles to add (repeatable)'),
+    add_success_metric: z
+        .array(z.string())
+        .optional()
+        .describe('Success metrics to add (repeatable, deduplicated)'),
+    phase_id: z.string().optional().describe('Phase ID to update (use with phase_status)'),
+    phase_status: phaseStatusEnum.optional().describe('New phase status'),
+    phase_title: z.string().optional().describe('New phase title'),
+    created: z.string().optional().describe('Set created date (YYYY-MM-DD format)'),
+});
+// =============================================================================
+// initiative:list Schema
+// =============================================================================
+/**
+ * Schema for initiative:list command
+ *
+ * No required fields
+ * Optional: status, format, color
+ */
+export const initiativeListSchema = z.object({
+    status: z.string().optional().describe('Filter by initiative status'),
+    format: outputFormatEnum.optional().describe('Output format (table, json)'),
+    color: z.boolean().optional().describe('Enable colored output'),
+});
+// =============================================================================
+// initiative:status Schema
+// =============================================================================
+/**
+ * Schema for initiative:status command
+ *
+ * Required: id
+ * Optional: format, color
+ */
+export const initiativeStatusSchema = z.object({
+    id: z.string().describe('Initiative ID or slug'),
+    format: outputFormatEnum.optional().describe('Output format (table, json)'),
+    color: z.boolean().optional().describe('Enable colored output'),
+});
+// =============================================================================
+// initiative:add-wu Schema
+// =============================================================================
+/**
+ * Schema for initiative:add-wu command
+ *
+ * Required: initiative, wu
+ * Optional: phase
+ */
+export const initiativeAddWuSchema = z.object({
+    initiative: z.string().describe('Initiative ID to link WU to'),
+    wu: z.string().describe('WU ID to add (or array for batch)'),
+    phase: z.number().optional().describe('Phase number to assign (1-based)'),
+});
+// =============================================================================
+// initiative:remove-wu Schema
+// =============================================================================
+/**
+ * Schema for initiative:remove-wu command
+ *
+ * Required: initiative, wu
+ */
+export const initiativeRemoveWuSchema = z.object({
+    initiative: z.string().describe('Initiative ID to unlink WU from'),
+    wu: z.string().describe('WU ID to remove'),
+});
+// =============================================================================
+// initiative:bulk-assign Schema
+// =============================================================================
+/**
+ * Schema for initiative:bulk-assign command
+ *
+ * No required fields (defaults to dry-run)
+ * Optional: config, apply, sync_from_initiative
+ */
+export const initiativeBulkAssignSchema = z.object({
+    config: z.string().optional().describe('Path to lane bucket configuration file'),
+    apply: z.boolean().optional().describe('Apply changes (default is dry-run)'),
+    sync_from_initiative: z.string().optional().describe('Reconcile WUs from a specific initiative'),
+});
+// =============================================================================
+// initiative:plan Schema
+// =============================================================================
+/**
+ * Schema for initiative:plan command
+ *
+ * Required: initiative
+ * Optional: plan, create
+ */
+export const initiativePlanSchema = z.object({
+    initiative: z.string().describe('Initiative ID to link plan to'),
+    plan: z.string().optional().describe('Path to existing plan file (markdown)'),
+    create: z.boolean().optional().describe('Create a new plan template instead of linking'),
+});
+// =============================================================================
+// Initiative Schema Registry
+// =============================================================================
+/**
+ * Registry of all initiative command schemas for validation and parity checking.
+ * These complement the schemas in command-schemas.ts (WU-1431) and
+ * wu-lifecycle-schemas.ts (WU-1454).
+ */
+export const initiativeCommandSchemas = {
+    'initiative:create': initiativeCreateSchema,
+    'initiative:edit': initiativeEditSchema,
+    'initiative:list': initiativeListSchema,
+    'initiative:status': initiativeStatusSchema,
+    'initiative:add-wu': initiativeAddWuSchema,
+    'initiative:remove-wu': initiativeRemoveWuSchema,
+    'initiative:bulk-assign': initiativeBulkAssignSchema,
+    'initiative:plan': initiativePlanSchema,
+};
+//# sourceMappingURL=initiative-schemas.js.map

package/dist/schemas/initiative-schemas.js.map

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

package/dist/schemas/lanes-config.d.ts

@@ -0,0 +1,153 @@
+/**
+ * Lanes Configuration Schemas
+ *
+ * Lane definitions, enforcement rules, lock policies, and lifecycle status.
+ *
+ * @module schemas/lanes-config
+ */
+import { z } from 'zod';
+/**
+ * WU-1325: Lock policy for lane-level WIP enforcement
+ *
+ * Controls how lane locks behave:
+ * - 'all' (default): Lock acquired on claim, held through block, released on done
+ * - 'active': Lock acquired on claim, released on block, re-acquired on unblock
+ * - 'none': No lock files created, WIP checking disabled
+ *
+ * @example
+ * ```yaml
+ * lanes:
+ *   definitions:
+ *     - name: 'Content: Documentation'
+ *       wip_limit: 4
+ *       lock_policy: 'none'  # Docs don't need lock coordination
+ * ```
+ */
+export declare const LockPolicySchema: z.ZodDefault<z.ZodEnum<{
+    none: "none";
+    all: "all";
+    active: "active";
+}>>;
+/** WU-1325: TypeScript type for lock policy */
+export type LockPolicy = z.infer<typeof LockPolicySchema>;
+/**
+ * WU-1345: Lane enforcement configuration schema
+ *
+ * Controls how lane format validation behaves.
+ */
+export declare const LanesEnforcementSchema: z.ZodObject<{
+    require_parent: z.ZodDefault<z.ZodBoolean>;
+    allow_custom: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+/**
+ * WU-1748: Explicit lane lifecycle status for deferred lane process
+ */
+export declare const LaneLifecycleStatusSchema: z.ZodEnum<{
+    unconfigured: "unconfigured";
+    draft: "draft";
+    locked: "locked";
+}>;
+/** WU-1748: Lane lifecycle metadata */
+export declare const LaneLifecycleSchema: z.ZodObject<{
+    status: z.ZodEnum<{
+        unconfigured: "unconfigured";
+        draft: "draft";
+        locked: "locked";
+    }>;
+    updated_at: z.ZodOptional<z.ZodString>;
+    migrated_at: z.ZodOptional<z.ZodString>;
+    migration_reason: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * WU-1322: Lane definition schema for workspace.yaml
+ *
+ * Extends the existing lane configuration with lock_policy field.
+ * Compatible with WU-1016 (wip_limit) and WU-1187 (wip_justification).
+ */
+export declare const LaneDefinitionSchema: z.ZodObject<{
+    name: z.ZodString;
+    wip_limit: z.ZodOptional<z.ZodNumber>;
+    wip_justification: z.ZodOptional<z.ZodString>;
+    lock_policy: z.ZodDefault<z.ZodDefault<z.ZodEnum<{
+        none: "none";
+        all: "all";
+        active: "active";
+    }>>>;
+    code_paths: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+/**
+ * WU-1345: Complete lanes configuration schema
+ *
+ * Supports three formats:
+ * 1. definitions array (recommended)
+ * 2. engineering + business arrays (legacy/alternate)
+ * 3. flat array (simple format - parsed as definitions)
+ *
+ * @example
+ * ```yaml
+ * lanes:
+ *   enforcement:
+ *     require_parent: true
+ *     allow_custom: false
+ *   definitions:
+ *     - name: 'Framework: Core'
+ *       wip_limit: 1
+ *       code_paths:
+ *         - 'packages/@lumenflow/core/**'
+ * ```
+ */
+export declare const LanesConfigSchema: z.ZodObject<{
+    enforcement: z.ZodOptional<z.ZodObject<{
+        require_parent: z.ZodDefault<z.ZodBoolean>;
+        allow_custom: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    lifecycle: z.ZodOptional<z.ZodObject<{
+        status: z.ZodEnum<{
+            unconfigured: "unconfigured";
+            draft: "draft";
+            locked: "locked";
+        }>;
+        updated_at: z.ZodOptional<z.ZodString>;
+        migrated_at: z.ZodOptional<z.ZodString>;
+        migration_reason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    definitions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        wip_limit: z.ZodOptional<z.ZodNumber>;
+        wip_justification: z.ZodOptional<z.ZodString>;
+        lock_policy: z.ZodDefault<z.ZodDefault<z.ZodEnum<{
+            none: "none";
+            all: "all";
+            active: "active";
+        }>>>;
+        code_paths: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>>;
+    engineering: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        wip_limit: z.ZodOptional<z.ZodNumber>;
+        wip_justification: z.ZodOptional<z.ZodString>;
+        lock_policy: z.ZodDefault<z.ZodDefault<z.ZodEnum<{
+            none: "none";
+            all: "all";
+            active: "active";
+        }>>>;
+        code_paths: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>>;
+    business: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        wip_limit: z.ZodOptional<z.ZodNumber>;
+        wip_justification: z.ZodOptional<z.ZodString>;
+        lock_policy: z.ZodDefault<z.ZodDefault<z.ZodEnum<{
+            none: "none";
+            all: "all";
+            active: "active";
+        }>>>;
+        code_paths: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type LaneDefinition = z.infer<typeof LaneDefinitionSchema>;
+export type LanesEnforcement = z.infer<typeof LanesEnforcementSchema>;
+export type LaneLifecycleStatus = z.infer<typeof LaneLifecycleStatusSchema>;
+export type LaneLifecycle = z.infer<typeof LaneLifecycleSchema>;
+export type LanesConfig = z.infer<typeof LanesConfigSchema>;
+//# sourceMappingURL=lanes-config.d.ts.map

package/dist/schemas/lanes-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lanes-config.d.ts","sourceRoot":"","sources":["../../src/schemas/lanes-config.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,gBAAgB;;;;GAAmD,CAAC;AAEjF,+CAA+C;AAC/C,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D;;;;GAIG;AACH,eAAO,MAAM,sBAAsB;;;iBAajC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;EAA8C,CAAC;AAErF,uCAAuC;AACvC,eAAO,MAAM,mBAAmB;;;;;;;;;iBAK9B,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;iBA+B/B,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAe5B,CAAC;AAGH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC5E,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC"}