@lumenflow/core 2.10.0 → 2.12.0

package/dist/schemas/arg-validators.d.ts

@@ -0,0 +1,58 @@
+/**
+ * @file arg-validators.ts
+ * @description CLI argument validators using shared schemas (WU-1431)
+ *
+ * These validators use the shared Zod schemas to validate CLI arguments.
+ * They handle:
+ * - CLI-only alias mapping (codePath -> code_paths, manualTest -> test_paths_manual)
+ * - Conditional validation (skip_gates requires reason)
+ * - Normalized output for consistent downstream processing
+ */
+import { type WuCreateInput, type WuClaimInput, type WuStatusInput, type WuDoneInput, type GatesInput } from './command-schemas.js';
+/**
+ * Validation result with normalized data
+ */
+export interface ValidationResult<T> {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+    normalized: T;
+}
+/**
+ * Validate wu:create arguments
+ *
+ * @param args - Raw CLI arguments
+ * @returns Validation result with normalized WuCreateInput
+ */
+export declare function validateWuCreateArgs(args: Record<string, unknown>): ValidationResult<WuCreateInput>;
+/**
+ * Validate wu:claim arguments
+ *
+ * @param args - Raw CLI arguments
+ * @returns Validation result with normalized WuClaimInput
+ */
+export declare function validateWuClaimArgs(args: Record<string, unknown>): ValidationResult<WuClaimInput>;
+/**
+ * Validate wu:status arguments
+ *
+ * @param args - Raw CLI arguments
+ * @returns Validation result with normalized WuStatusInput
+ */
+export declare function validateWuStatusArgs(args: Record<string, unknown>): ValidationResult<WuStatusInput>;
+/**
+ * Validate wu:done arguments
+ *
+ * Includes additional validation: skip_gates requires reason
+ *
+ * @param args - Raw CLI arguments
+ * @returns Validation result with normalized WuDoneInput
+ */
+export declare function validateWuDoneArgs(args: Record<string, unknown>): ValidationResult<WuDoneInput>;
+/**
+ * Validate gates arguments
+ *
+ * @param args - Raw CLI arguments
+ * @returns Validation result with normalized GatesInput
+ */
+export declare function validateGatesArgs(args: Record<string, unknown>): ValidationResult<GatesInput>;
+//# sourceMappingURL=arg-validators.d.ts.map

package/dist/schemas/arg-validators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arg-validators.d.ts","sourceRoot":"","sources":["../../src/schemas/arg-validators.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAML,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,UAAU,EAChB,MAAM,sBAAsB,CAAC;AAO9B;;GAEG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,EAAE,CAAC,CAAC;CACf;AA+ED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,gBAAgB,CAAC,aAAa,CAAC,CAmBjC;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,gBAAgB,CAAC,YAAY,CAAC,CAkBjG;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,gBAAgB,CAAC,aAAa,CAAC,CAkBjC;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAwB/F;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAkB7F"}

package/dist/schemas/arg-validators.js

@@ -0,0 +1,191 @@
+/**
+ * @file arg-validators.ts
+ * @description CLI argument validators using shared schemas (WU-1431)
+ *
+ * These validators use the shared Zod schemas to validate CLI arguments.
+ * They handle:
+ * - CLI-only alias mapping (codePath -> code_paths, manualTest -> test_paths_manual)
+ * - Conditional validation (skip_gates requires reason)
+ * - Normalized output for consistent downstream processing
+ */
+import { wuCreateSchema, wuClaimSchema, wuStatusSchema, wuDoneSchema, gatesSchema, } from './command-schemas.js';
+import { getCliOnlyAliases } from './schema-utils.js';
+// =============================================================================
+// CLI Alias Mapping
+// =============================================================================
+/**
+ * Map CLI-only aliases to their canonical field names
+ *
+ * @param args - Raw CLI arguments (may include aliases)
+ * @returns Arguments with aliases mapped to canonical names
+ */
+function mapCliAliases(args) {
+    const aliases = getCliOnlyAliases();
+    const result = { ...args };
+    for (const [aliasName, aliasDef] of Object.entries(aliases)) {
+        if (aliasName in result) {
+            const canonicalName = aliasDef.canonical;
+            // Merge alias value into canonical field (arrays are concatenated)
+            const aliasValue = result[aliasName];
+            const canonicalValue = result[canonicalName];
+            if (Array.isArray(aliasValue)) {
+                if (Array.isArray(canonicalValue)) {
+                    result[canonicalName] = [...canonicalValue, ...aliasValue];
+                }
+                else {
+                    result[canonicalName] = aliasValue;
+                }
+            }
+            else {
+                result[canonicalName] = aliasValue;
+            }
+            // Remove the alias field
+            delete result[aliasName];
+        }
+    }
+    return result;
+}
+/**
+ * Format Zod errors into human-readable strings
+ */
+function formatZodErrors(error) {
+    return error.issues.map((issue) => {
+        // Convert path to string (filter out symbols)
+        const path = issue.path.filter((p) => typeof p !== 'symbol').join('.');
+        // Handle required field errors (Zod 4 uses invalid_type with "received undefined")
+        if (issue.code === 'invalid_type' && issue.message.includes('received undefined')) {
+            return `${path} is required`;
+        }
+        if (issue.message === 'Required') {
+            return `${path} is required`;
+        }
+        return `${path}: ${issue.message}`;
+    });
+}
+// =============================================================================
+// Validators
+// =============================================================================
+/**
+ * Validate wu:create arguments
+ *
+ * @param args - Raw CLI arguments
+ * @returns Validation result with normalized WuCreateInput
+ */
+export function validateWuCreateArgs(args) {
+    const mapped = mapCliAliases(args);
+    const result = wuCreateSchema.safeParse(mapped);
+    if (result.success) {
+        return {
+            valid: true,
+            errors: [],
+            warnings: [],
+            normalized: result.data,
+        };
+    }
+    return {
+        valid: false,
+        errors: formatZodErrors(result.error),
+        warnings: [],
+        normalized: mapped,
+    };
+}
+/**
+ * Validate wu:claim arguments
+ *
+ * @param args - Raw CLI arguments
+ * @returns Validation result with normalized WuClaimInput
+ */
+export function validateWuClaimArgs(args) {
+    const result = wuClaimSchema.safeParse(args);
+    if (result.success) {
+        return {
+            valid: true,
+            errors: [],
+            warnings: [],
+            normalized: result.data,
+        };
+    }
+    return {
+        valid: false,
+        errors: formatZodErrors(result.error),
+        warnings: [],
+        normalized: args,
+    };
+}
+/**
+ * Validate wu:status arguments
+ *
+ * @param args - Raw CLI arguments
+ * @returns Validation result with normalized WuStatusInput
+ */
+export function validateWuStatusArgs(args) {
+    const result = wuStatusSchema.safeParse(args);
+    if (result.success) {
+        return {
+            valid: true,
+            errors: [],
+            warnings: [],
+            normalized: result.data,
+        };
+    }
+    return {
+        valid: false,
+        errors: formatZodErrors(result.error),
+        warnings: [],
+        normalized: args,
+    };
+}
+/**
+ * Validate wu:done arguments
+ *
+ * Includes additional validation: skip_gates requires reason
+ *
+ * @param args - Raw CLI arguments
+ * @returns Validation result with normalized WuDoneInput
+ */
+export function validateWuDoneArgs(args) {
+    const result = wuDoneSchema.safeParse(args);
+    if (!result.success) {
+        return {
+            valid: false,
+            errors: formatZodErrors(result.error),
+            warnings: [],
+            normalized: args,
+        };
+    }
+    // Additional validation: skip_gates requires reason
+    const errors = [];
+    if (result.data.skip_gates && !result.data.reason) {
+        errors.push('skip_gates requires reason to be provided');
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings: [],
+        normalized: result.data,
+    };
+}
+/**
+ * Validate gates arguments
+ *
+ * @param args - Raw CLI arguments
+ * @returns Validation result with normalized GatesInput
+ */
+export function validateGatesArgs(args) {
+    const result = gatesSchema.safeParse(args);
+    if (result.success) {
+        return {
+            valid: true,
+            errors: [],
+            warnings: [],
+            normalized: result.data,
+        };
+    }
+    return {
+        valid: false,
+        errors: formatZodErrors(result.error),
+        warnings: [],
+        normalized: args,
+    };
+}
+//# sourceMappingURL=arg-validators.js.map

package/dist/schemas/arg-validators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"arg-validators.js","sourceRoot":"","sources":["../../src/schemas/arg-validators.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EACL,cAAc,EACd,aAAa,EACb,cAAc,EACd,YAAY,EACZ,WAAW,GAMZ,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAgBtD,gFAAgF;AAChF,oBAAoB;AACpB,gFAAgF;AAEhF;;;;;GAKG;AACH,SAAS,aAAa,CAAC,IAA6B;IAClD,MAAM,OAAO,GAAG,iBAAiB,EAAE,CAAC;IACpC,MAAM,MAAM,GAAG,EAAE,GAAG,IAAI,EAAE,CAAC;IAE3B,KAAK,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5D,IAAI,SAAS,IAAI,MAAM,EAAE,CAAC;YACxB,MAAM,aAAa,GAAG,QAAQ,CAAC,SAAS,CAAC;YACzC,mEAAmE;YACnE,MAAM,UAAU,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;YACrC,MAAM,cAAc,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC;YAE7C,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC9B,IAAI,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,CAAC;oBAClC,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,cAAc,EAAE,GAAG,UAAU,CAAC,CAAC;gBAC7D,CAAC;qBAAM,CAAC;oBACN,MAAM,CAAC,aAAa,CAAC,GAAG,UAAU,CAAC;gBACrC,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,aAAa,CAAC,GAAG,UAAU,CAAC;YACrC,CAAC;YAED,yBAAyB;YACzB,OAAO,MAAM,CAAC,SAAS,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAkBD;;GAEG;AACH,SAAS,eAAe,CAAC,KAAmB;IAC1C,OAAO,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QAChC,8CAA8C;QAC9C,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAwB,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC7F,mFAAmF;QACnF,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,CAAC;YAClF,OAAO,GAAG,IAAI,cAAc,CAAC;QAC/B,CAAC;QACD,IAAI,KAAK,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;YACjC,OAAO,GAAG,IAAI,cAAc,CAAC;QAC/B,CAAC;QACD,OAAO,GAAG,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;IACrC,CAAC,CAAC,CAAC;AACL,CAAC;AAED,gFAAgF;AAChF,aAAa;AACb,gFAAgF;AAEhF;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAClC,IAA6B;IAE7B,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,MAAM,GAAG,cAAc,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAEhD,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO;YACL,KAAK,EAAE,IAAI;YACX,MAAM,EAAE,EAAE;YACV,QAAQ,EAAE,EAAE;YACZ,UAAU,EAAE,MAAM,CAAC,IAAI;SACxB,CAAC;IACJ,CAAC;IAED,OAAO;QACL,KAAK,EAAE,KAAK;QACZ,MAAM,EAAE,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC;QACrC,QAAQ,EAAE,EAAE;QACZ,UAAU,EAAE,MAAuB;KACpC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAA6B;IAC/D,MAAM,MAAM,GAAG,aAAa,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAE7C,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO;YACL,KAAK,EAAE,IAAI;YACX,MAAM,EAAE,EAAE;YACV,QAAQ,EAAE,EAAE;YACZ,UAAU,EAAE,MAAM,CAAC,IAAI;SACxB,CAAC;IACJ,CAAC;IAED,OAAO;QACL,KAAK,EAAE,KAAK;QACZ,MAAM,EAAE,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC;QACrC,QAAQ,EAAE,EAAE;QACZ,UAAU,EAAE,IAAoB;KACjC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAClC,IAA6B;IAE7B,MAAM,MAAM,GAAG,cAAc,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAE9C,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO;YACL,KAAK,EAAE,IAAI;YACX,MAAM,EAAE,EAAE;YACV,QAAQ,EAAE,EAAE;YACZ,UAAU,EAAE,MAAM,CAAC,IAAI;SACxB,CAAC;IACJ,CAAC;IAED,OAAO;QACL,KAAK,EAAE,KAAK;QACZ,MAAM,EAAE,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC;QACrC,QAAQ,EAAE,EAAE;QACZ,UAAU,EAAE,IAAqB;KAClC,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAA6B;IAC9D,MAAM,MAAM,GAAG,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAE5C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,MAAM,EAAE,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC;YACrC,QAAQ,EAAE,EAAE;YACZ,UAAU,EAAE,IAAmB;SAChC,CAAC;IACJ,CAAC;IAED,oDAAoD;IACpD,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;QAClD,MAAM,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAC;IAC3D,CAAC;IAED,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;QAC1B,MAAM;QACN,QAAQ,EAAE,EAAE;QACZ,UAAU,EAAE,MAAM,CAAC,IAAI;KACxB,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAA6B;IAC7D,MAAM,MAAM,GAAG,WAAW,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAE3C,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO;YACL,KAAK,EAAE,IAAI;YACX,MAAM,EAAE,EAAE;YACV,QAAQ,EAAE,EAAE;YACZ,UAAU,EAAE,MAAM,CAAC,IAAI;SACxB,CAAC;IACJ,CAAC;IAED,OAAO;QACL,KAAK,EAAE,KAAK;QACZ,MAAM,EAAE,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC;QACrC,QAAQ,EAAE,EAAE;QACZ,UAAU,EAAE,IAAkB;KAC/B,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,164 @@
+/**
+ * @file command-schemas.ts
+ * @description Shared Zod schemas for CLI/MCP parity (WU-1431)
+ *
+ * These schemas are the single source of truth for command validation.
+ * Both CLI argument parsing and MCP inputSchema derivation use these schemas.
+ *
+ * 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 (they're handled separately in arg-validators.ts)
+ */
+import { z } from 'zod';
+/**
+ * Exposure type enum (ui, api, backend-only, documentation)
+ */
+export declare const exposureEnum: z.ZodEnum<{
+    documentation: "documentation";
+    ui: "ui";
+    api: "api";
+    "backend-only": "backend-only";
+}>;
+export type Exposure = z.infer<typeof exposureEnum>;
+/**
+ * WU status enum
+ */
+export declare const wuStatusEnum: z.ZodEnum<{
+    ready: "ready";
+    in_progress: "in_progress";
+    blocked: "blocked";
+    done: "done";
+    waiting: "waiting";
+}>;
+export type WuStatus = z.infer<typeof wuStatusEnum>;
+/**
+ * Schema for wu:create command
+ *
+ * Required: lane, title
+ * Optional: id (auto-generated if omitted), description, acceptance, code_paths, exposure, etc.
+ */
+export declare const wuCreateSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    lane: z.ZodString;
+    title: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    acceptance: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    code_paths: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    test_paths_unit: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    test_paths_e2e: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    test_paths_manual: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    exposure: z.ZodOptional<z.ZodEnum<{
+        documentation: "documentation";
+        ui: "ui";
+        api: "api";
+        "backend-only": "backend-only";
+    }>>;
+    spec_refs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    initiative: z.ZodOptional<z.ZodString>;
+    phase: z.ZodOptional<z.ZodNumber>;
+    priority: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type WuCreateInput = z.infer<typeof wuCreateSchema>;
+/**
+ * Schema for wu:claim command
+ *
+ * Required: id, lane
+ */
+export declare const wuClaimSchema: z.ZodObject<{
+    id: z.ZodString;
+    lane: z.ZodString;
+}, z.core.$strip>;
+export type WuClaimInput = z.infer<typeof wuClaimSchema>;
+/**
+ * Schema for wu:status command
+ *
+ * Optional: id (auto-detect from current directory if omitted)
+ */
+export declare const wuStatusSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    json: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type WuStatusInput = z.infer<typeof wuStatusSchema>;
+/**
+ * Schema for wu:done command
+ *
+ * Required: id
+ * Optional: skip_gates (requires reason and fix_wu)
+ *
+ * Note: skip_gates validation (requires reason) is handled in arg-validators.ts
+ * via refinement logic since it involves conditional requirements.
+ */
+export declare const wuDoneSchema: z.ZodObject<{
+    id: z.ZodString;
+    skip_gates: z.ZodOptional<z.ZodBoolean>;
+    reason: z.ZodOptional<z.ZodString>;
+    fix_wu: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type WuDoneInput = z.infer<typeof wuDoneSchema>;
+/**
+ * Schema for gates command
+ *
+ * Optional: docs_only
+ */
+export declare const gatesSchema: z.ZodObject<{
+    docs_only: z.ZodOptional<z.ZodBoolean>;
+    full_lint: z.ZodOptional<z.ZodBoolean>;
+    full_tests: z.ZodOptional<z.ZodBoolean>;
+    full_coverage: z.ZodOptional<z.ZodBoolean>;
+    coverage_mode: z.ZodOptional<z.ZodString>;
+    verbose: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type GatesInput = z.infer<typeof gatesSchema>;
+/**
+ * Registry of all command schemas for validation and parity checking
+ */
+export declare const commandSchemas: {
+    readonly 'wu:create': z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        lane: z.ZodString;
+        title: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        acceptance: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        code_paths: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        test_paths_unit: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        test_paths_e2e: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        test_paths_manual: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        exposure: z.ZodOptional<z.ZodEnum<{
+            documentation: "documentation";
+            ui: "ui";
+            api: "api";
+            "backend-only": "backend-only";
+        }>>;
+        spec_refs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        initiative: z.ZodOptional<z.ZodString>;
+        phase: z.ZodOptional<z.ZodNumber>;
+        priority: z.ZodOptional<z.ZodString>;
+        type: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    readonly 'wu:claim': z.ZodObject<{
+        id: z.ZodString;
+        lane: z.ZodString;
+    }, z.core.$strip>;
+    readonly 'wu:status': z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        json: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>;
+    readonly 'wu:done': z.ZodObject<{
+        id: z.ZodString;
+        skip_gates: z.ZodOptional<z.ZodBoolean>;
+        reason: z.ZodOptional<z.ZodString>;
+        fix_wu: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    readonly gates: z.ZodObject<{
+        docs_only: z.ZodOptional<z.ZodBoolean>;
+        full_lint: z.ZodOptional<z.ZodBoolean>;
+        full_tests: z.ZodOptional<z.ZodBoolean>;
+        full_coverage: z.ZodOptional<z.ZodBoolean>;
+        coverage_mode: z.ZodOptional<z.ZodString>;
+        verbose: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>;
+};
+export type CommandName = keyof typeof commandSchemas;
+//# sourceMappingURL=command-schemas.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"command-schemas.d.ts","sourceRoot":"","sources":["../../src/schemas/command-schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;EAAyD,CAAC;AACnF,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAEpD;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;;EAAiE,CAAC;AAC3F,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAMpD;;;;;GAKG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;iBAqBzB,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAM3D;;;;GAIG;AACH,eAAO,MAAM,aAAa;;;iBAGxB,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAMzD;;;;GAIG;AACH,eAAO,MAAM,cAAc;;;iBAGzB,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAM3D;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY;;;;;iBAKvB,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAMvD;;;;GAIG;AACH,eAAO,MAAM,WAAW;;;;;;;iBAatB,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAMrD;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAMjB,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG,MAAM,OAAO,cAAc,CAAC"}

package/dist/schemas/command-schemas.js

@@ -0,0 +1,133 @@
+/**
+ * @file command-schemas.ts
+ * @description Shared Zod schemas for CLI/MCP parity (WU-1431)
+ *
+ * These schemas are the single source of truth for command validation.
+ * Both CLI argument parsing and MCP inputSchema derivation use these schemas.
+ *
+ * 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 (they're handled separately in arg-validators.ts)
+ */
+import { z } from 'zod';
+// =============================================================================
+// Shared Enums
+// =============================================================================
+/**
+ * Exposure type enum (ui, api, backend-only, documentation)
+ */
+export const exposureEnum = z.enum(['ui', 'api', 'backend-only', 'documentation']);
+/**
+ * WU status enum
+ */
+export const wuStatusEnum = z.enum(['ready', 'in_progress', 'blocked', 'waiting', 'done']);
+// =============================================================================
+// wu:create Schema
+// =============================================================================
+/**
+ * Schema for wu:create command
+ *
+ * Required: lane, title
+ * Optional: id (auto-generated if omitted), description, acceptance, code_paths, exposure, etc.
+ */
+export const wuCreateSchema = z.object({
+    id: z.string().optional().describe('WU ID (e.g., WU-1234). Auto-generated if omitted.'),
+    lane: z.string().describe('Lane name (e.g., "Framework: Core")'),
+    title: z.string().describe('Work Unit title'),
+    description: z
+        .string()
+        .optional()
+        .describe('WU description (Context: ... Problem: ... Solution: ...)'),
+    acceptance: z.array(z.string()).optional().describe('Acceptance criteria (array of strings)'),
+    code_paths: z.array(z.string()).optional().describe('Code paths affected by this WU'),
+    test_paths_unit: z.array(z.string()).optional().describe('Unit test file paths'),
+    test_paths_e2e: z.array(z.string()).optional().describe('E2E test file paths'),
+    test_paths_manual: z.array(z.string()).optional().describe('Manual test descriptions'),
+    exposure: exposureEnum
+        .optional()
+        .describe('Exposure level (ui, api, backend-only, documentation)'),
+    spec_refs: z.array(z.string()).optional().describe('Spec/plan references (lumenflow:// URIs)'),
+    initiative: z.string().optional().describe('Parent initiative (INIT-XXX or slug)'),
+    phase: z.number().int().positive().optional().describe('Phase number within initiative'),
+    priority: z.string().optional().describe('Priority level (P0, P1, P2, P3)'),
+    type: z.string().optional().describe('WU type (feature, bug, refactor, documentation)'),
+});
+// =============================================================================
+// wu:claim Schema
+// =============================================================================
+/**
+ * Schema for wu:claim command
+ *
+ * Required: id, lane
+ */
+export const wuClaimSchema = z.object({
+    id: z.string().describe('WU ID to claim (e.g., WU-1234)'),
+    lane: z.string().describe('Lane for the WU'),
+});
+// =============================================================================
+// wu:status Schema
+// =============================================================================
+/**
+ * Schema for wu:status command
+ *
+ * Optional: id (auto-detect from current directory if omitted)
+ */
+export const wuStatusSchema = z.object({
+    id: z.string().optional().describe('WU ID to check status for'),
+    json: z.boolean().optional().describe('Output as JSON'),
+});
+// =============================================================================
+// wu:done Schema
+// =============================================================================
+/**
+ * Schema for wu:done command
+ *
+ * Required: id
+ * Optional: skip_gates (requires reason and fix_wu)
+ *
+ * Note: skip_gates validation (requires reason) is handled in arg-validators.ts
+ * via refinement logic since it involves conditional requirements.
+ */
+export const wuDoneSchema = z.object({
+    id: z.string().describe('WU ID to complete'),
+    skip_gates: z.boolean().optional().describe('Skip gates check (requires reason and fix_wu)'),
+    reason: z.string().optional().describe('Reason for skipping gates'),
+    fix_wu: z.string().optional().describe('WU ID that will fix the skipped issue'),
+});
+// =============================================================================
+// gates Schema
+// =============================================================================
+/**
+ * Schema for gates command
+ *
+ * Optional: docs_only
+ */
+export const gatesSchema = z.object({
+    docs_only: z.boolean().optional().describe('Run docs-only gates (skip lint/typecheck/tests)'),
+    full_lint: z.boolean().optional().describe('Run full lint instead of incremental'),
+    full_tests: z.boolean().optional().describe('Run full test suite instead of incremental'),
+    full_coverage: z
+        .boolean()
+        .optional()
+        .describe('Force full test suite and coverage gate (implies full_tests)'),
+    coverage_mode: z.string().optional().describe('Coverage gate mode: "warn" or "block"'),
+    verbose: z
+        .boolean()
+        .optional()
+        .describe('Stream output in agent mode instead of logging to file'),
+});
+// =============================================================================
+// Schema Registry
+// =============================================================================
+/**
+ * Registry of all command schemas for validation and parity checking
+ */
+export const commandSchemas = {
+    'wu:create': wuCreateSchema,
+    'wu:claim': wuClaimSchema,
+    'wu:status': wuStatusSchema,
+    'wu:done': wuDoneSchema,
+    gates: gatesSchema,
+};
+//# sourceMappingURL=command-schemas.js.map

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

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

package/dist/schemas/flow-arg-validators.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @file flow-arg-validators.ts
+ * @description CLI argument validators for flow/metrics commands using shared schemas (WU-1457)
+ *
+ * These validators use the shared Zod schemas to validate CLI arguments for the
+ * 4 flow/metrics commands. They follow the same pattern as memory-arg-validators.ts
+ * (WU-1456).
+ */
+import type { ValidationResult } from './arg-validators.js';
+/** Validate flow:bottlenecks arguments */
+export declare const validateFlowBottlenecksArgs: (args: Record<string, unknown>) => ValidationResult<{
+    limit?: number;
+    format?: "json" | "table" | "mermaid";
+    json?: boolean;
+}>;
+/** Validate flow:report arguments */
+export declare const validateFlowReportArgs: (args: Record<string, unknown>) => ValidationResult<{
+    start?: string;
+    end?: string;
+    days?: number;
+    format?: "json" | "table";
+    json?: boolean;
+}>;
+/** Validate metrics:snapshot arguments */
+export declare const validateMetricsSnapshotArgs: (args: Record<string, unknown>) => ValidationResult<{
+    type?: "all" | "lanes" | "dora" | "flow";
+    output?: string;
+    days?: number;
+    dry_run?: boolean;
+    format?: "json" | "table";
+}>;
+/** Validate metrics arguments */
+export declare const validateMetricsArgs: (args: Record<string, unknown>) => ValidationResult<{
+    subcommand?: "all" | "lanes" | "dora" | "flow";
+    format?: "json" | "table";
+    days?: number;
+    output?: string;
+    dry_run?: boolean;
+}>;
+//# sourceMappingURL=flow-arg-validators.d.ts.map

package/dist/schemas/flow-arg-validators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow-arg-validators.d.ts","sourceRoot":"","sources":["../../src/schemas/flow-arg-validators.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAaH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AA4E5D,0CAA0C;AAC1C,eAAO,MAAM,2BAA2B,SA3B7B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;EA4B4B,CAAC;AAE/D,qCAAqC;AACrC,eAAO,MAAM,sBAAsB,SA/BxB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;EA+BsD,CAAC;AAEzF,0CAA0C;AAC1C,eAAO,MAAM,2BAA2B,SAlC7B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;EAmC4B,CAAC;AAE/D,iCAAiC;AACjC,eAAO,MAAM,mBAAmB,SAtCrB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;EAsC6C,CAAC"}

package/dist/schemas/flow-arg-validators.js

@@ -0,0 +1,55 @@
+/**
+ * @file flow-arg-validators.ts
+ * @description CLI argument validators for flow/metrics commands using shared schemas (WU-1457)
+ *
+ * These validators use the shared Zod schemas to validate CLI arguments for the
+ * 4 flow/metrics commands. They follow the same pattern as memory-arg-validators.ts
+ * (WU-1456).
+ */
+import { flowBottlenecksSchema, flowReportSchema, metricsSnapshotSchema, metricsSchema, } from './flow-schemas.js';
+function formatZodErrors(error) {
+    return error.issues.map((issue) => {
+        const path = issue.path.filter((p) => typeof p !== 'symbol').join('.');
+        if (issue.code === 'invalid_type' && issue.message.includes('received undefined')) {
+            return `${path} is required`;
+        }
+        if (issue.message === 'Required') {
+            return `${path} is required`;
+        }
+        return `${path}: ${issue.message}`;
+    });
+}
+/**
+ * Create a validator function from a Zod schema
+ */
+function createValidator(schema) {
+    return (args) => {
+        const result = schema.safeParse(args);
+        if (result.success && result.data !== undefined) {
+            return {
+                valid: true,
+                errors: [],
+                warnings: [],
+                normalized: result.data,
+            };
+        }
+        return {
+            valid: false,
+            errors: result.error ? formatZodErrors(result.error) : ['Validation failed'],
+            warnings: [],
+            normalized: args,
+        };
+    };
+}
+// =============================================================================
+// Validators
+// =============================================================================
+/** Validate flow:bottlenecks arguments */
+export const validateFlowBottlenecksArgs = createValidator(flowBottlenecksSchema);
+/** Validate flow:report arguments */
+export const validateFlowReportArgs = createValidator(flowReportSchema);
+/** Validate metrics:snapshot arguments */
+export const validateMetricsSnapshotArgs = createValidator(metricsSnapshotSchema);
+/** Validate metrics arguments */
+export const validateMetricsArgs = createValidator(metricsSchema);
+//# sourceMappingURL=flow-arg-validators.js.map