@lumenflow/core 3.1.1 → 3.1.3

package/dist/schemas/arg-validators.js

@@ -1,193 +0,0 @@
-// Copyright (c) 2026 Hellmai Ltd
-// SPDX-License-Identifier: AGPL-3.0-only
-/**
- * @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

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

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

@@ -1,171 +0,0 @@
-/**
- * @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
- * Optional: cloud, branch_only, pr_mode (WU-1491: mode selection flags)
- */
-export declare const wuClaimSchema: z.ZodObject<{
-    id: z.ZodString;
-    lane: z.ZodString;
-    cloud: z.ZodOptional<z.ZodBoolean>;
-    branch_only: z.ZodOptional<z.ZodBoolean>;
-    pr_mode: z.ZodOptional<z.ZodBoolean>;
-}, 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;
-        cloud: z.ZodOptional<z.ZodBoolean>;
-        branch_only: z.ZodOptional<z.ZodBoolean>;
-        pr_mode: z.ZodOptional<z.ZodBoolean>;
-    }, 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

@@ -1 +0,0 @@
-{"version":3,"file":"command-schemas.d.ts","sourceRoot":"","sources":["../../src/schemas/command-schemas.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;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;;;;;GAKG;AACH,eAAO,MAAM,aAAa;;;;;;iBAYxB,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

@@ -1,145 +0,0 @@
-// Copyright (c) 2026 Hellmai Ltd
-// SPDX-License-Identifier: AGPL-3.0-only
-/**
- * @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
- * Optional: cloud, branch_only, pr_mode (WU-1491: mode selection flags)
- */
-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'),
-    cloud: z
-        .boolean()
-        .optional()
-        .describe('Use cloud/branch-pr mode (no worktree, PR-based completion for cloud agents)'),
-    branch_only: z
-        .boolean()
-        .optional()
-        .describe('Use branch-only mode (no worktree, direct branch work)'),
-    pr_mode: z.boolean().optional().describe('Use PR mode (create PR instead of auto-merge)'),
-});
-// =============================================================================
-// 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

@@ -1 +0,0 @@
-{"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

@@ -1,32 +0,0 @@
-import type { ValidationResult } from './arg-validators.js';
-/** Validate flow:bottlenecks arguments */
-export declare const validateFlowBottlenecksArgs: (args: Record<string, unknown>) => ValidationResult<{
-    limit?: number | undefined;
-    format?: "json" | "table" | "mermaid" | undefined;
-    json?: boolean | undefined;
-}>;
-/** Validate flow:report arguments */
-export declare const validateFlowReportArgs: (args: Record<string, unknown>) => ValidationResult<{
-    start?: string | undefined;
-    end?: string | undefined;
-    days?: number | undefined;
-    format?: "json" | "table" | undefined;
-    json?: boolean | undefined;
-}>;
-/** Validate metrics:snapshot arguments */
-export declare const validateMetricsSnapshotArgs: (args: Record<string, unknown>) => ValidationResult<{
-    type?: "all" | "lanes" | "dora" | "flow" | undefined;
-    output?: string | undefined;
-    days?: number | undefined;
-    dry_run?: boolean | undefined;
-    format?: "json" | "table" | undefined;
-}>;
-/** Validate metrics arguments */
-export declare const validateMetricsArgs: (args: Record<string, unknown>) => ValidationResult<{
-    subcommand?: "all" | "lanes" | "dora" | "flow" | undefined;
-    format?: "json" | "table" | undefined;
-    days?: number | undefined;
-    output?: string | undefined;
-    dry_run?: boolean | undefined;
-}>;
-//# sourceMappingURL=flow-arg-validators.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"flow-arg-validators.d.ts","sourceRoot":"","sources":["../../src/schemas/flow-arg-validators.ts"],"names":[],"mappings":"AAuBA,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

@@ -1,57 +0,0 @@
-// Copyright (c) 2026 Hellmai Ltd
-// SPDX-License-Identifier: AGPL-3.0-only
-/**
- * @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

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

@@ -1 +0,0 @@
-{"version":3,"file":"flow-arg-validators.js","sourceRoot":"","sources":["../../src/schemas/flow-arg-validators.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAEzC;;;;;;;GAOG;AAEH,OAAO,EACL,qBAAqB,EACrB,gBAAgB,EAChB,qBAAqB,EACrB,aAAa,GAKd,MAAM,mBAAmB,CAAC;AAqB3B,SAAS,eAAe,CAAC,KAAmB;IAC1C,OAAO,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QAChC,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,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;;GAEG;AACH,SAAS,eAAe,CAAI,MAE3B;IACC,OAAO,CAAC,IAA6B,EAAuB,EAAE;QAC5D,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAEtC,IAAI,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAChD,OAAO;gBACL,KAAK,EAAE,IAAI;gBACX,MAAM,EAAE,EAAE;gBACV,QAAQ,EAAE,EAAE;gBACZ,UAAU,EAAE,MAAM,CAAC,IAAI;aACxB,CAAC;QACJ,CAAC;QAED,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC;YAC5E,QAAQ,EAAE,EAAE;YACZ,UAAU,EAAE,IAAS;SACtB,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,aAAa;AACb,gFAAgF;AAEhF,0CAA0C;AAC1C,MAAM,CAAC,MAAM,2BAA2B,GACtC,eAAe,CAAuB,qBAAqB,CAAC,CAAC;AAE/D,qCAAqC;AACrC,MAAM,CAAC,MAAM,sBAAsB,GAAG,eAAe,CAAkB,gBAAgB,CAAC,CAAC;AAEzF,0CAA0C;AAC1C,MAAM,CAAC,MAAM,2BAA2B,GACtC,eAAe,CAAuB,qBAAqB,CAAC,CAAC;AAE/D,iCAAiC;AACjC,MAAM,CAAC,MAAM,mBAAmB,GAAG,eAAe,CAAe,aAAa,CAAC,CAAC"}