@lumenflow/core 3.1.3 → 3.2.1

package/dist/schemas/schema-utils.js

@@ -0,0 +1,320 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * @file schema-utils.ts
+ * @description Utilities for converting Zod schemas to MCP inputSchema and CLI options (WU-1431)
+ *
+ * These utilities enable deriving both MCP inputSchema and CLI argument definitions
+ * from the shared Zod schemas, ensuring parity between CLI and MCP.
+ */
+import { z } from 'zod';
+/**
+ * Get the internal _def from a Zod type
+ */
+function getDef(zodType) {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-return
+    return zodType._def;
+}
+// =============================================================================
+// CLI-Only Aliases
+// =============================================================================
+/**
+ * CLI-only aliases that are NOT exposed in MCP schemas
+ * These provide ergonomic shortcuts for CLI users but map to canonical fields
+ */
+const CLI_ONLY_ALIASES = {
+    codePath: {
+        name: 'codePath',
+        flags: '--code-path <path>',
+        description: 'Alias for --code-paths (repeatable)',
+        canonical: 'code_paths',
+        isRepeatable: true,
+    },
+    manualTest: {
+        name: 'manualTest',
+        flags: '--manual-test <test>',
+        description: 'Alias for --test-paths-manual (repeatable)',
+        canonical: 'test_paths_manual',
+        isRepeatable: true,
+    },
+};
+/**
+ * Get CLI-only alias definitions
+ *
+ * These aliases are NOT exposed in MCP schemas but are available in CLI.
+ * They map to canonical field names for validation/processing.
+ */
+export function getCliOnlyAliases() {
+    return { ...CLI_ONLY_ALIASES };
+}
+// =============================================================================
+// Zod to JSON Schema (for MCP inputSchema)
+// =============================================================================
+/**
+ * Get Zod type name (compatible with both Zod 3 and Zod 4)
+ */
+function getZodTypeName(zodType) {
+    const def = getDef(zodType);
+    // Zod 4 uses _def.type as a string
+    if (def?.type && typeof def.type === 'string') {
+        return def.type;
+    }
+    // Zod 3 uses _def.typeName
+    if (def?.typeName) {
+        return def.typeName;
+    }
+    return 'unknown';
+}
+/**
+ * Get inner type from Zod wrapper types (optional, default, etc.)
+ */
+function getInnerType(zodType) {
+    const def = getDef(zodType);
+    // Zod 4: innerType is an object with its own _def
+    if (def?.innerType) {
+        // In Zod 4, innerType has a def property we need to wrap
+        if (def.innerType.def) {
+            return { _def: def.innerType.def };
+        }
+        return def.innerType;
+    }
+    return undefined;
+}
+/**
+ * Convert a Zod type to JSON Schema type string
+ */
+function zodTypeToJsonType(zodType) {
+    const typeName = getZodTypeName(zodType);
+    switch (typeName) {
+        case 'string':
+        case 'ZodString':
+            return 'string';
+        case 'number':
+        case 'ZodNumber':
+            return 'number';
+        case 'boolean':
+        case 'ZodBoolean':
+            return 'boolean';
+        case 'array':
+        case 'ZodArray':
+            return 'array';
+        case 'object':
+        case 'ZodObject':
+            return 'object';
+        case 'enum':
+        case 'ZodEnum':
+            return 'string';
+        case 'optional':
+        case 'ZodOptional': {
+            const inner = getInnerType(zodType);
+            return inner ? zodTypeToJsonType(inner) : 'string';
+        }
+        case 'default':
+        case 'ZodDefault': {
+            const inner = getInnerType(zodType);
+            return inner ? zodTypeToJsonType(inner) : 'string';
+        }
+        default:
+            return 'string'; // Fallback
+    }
+}
+/**
+ * Get enum values from Zod enum type
+ */
+function getEnumValues(zodType) {
+    const typeName = getZodTypeName(zodType);
+    const def = getDef(zodType);
+    // Zod 4 enum
+    if (typeName === 'enum' && def?.entries) {
+        return Object.keys(def.entries);
+    }
+    // Zod 3 enum
+    if (typeName === 'ZodEnum' && def?.values) {
+        return def.values;
+    }
+    // Unwrap optional/default
+    if (typeName === 'optional' ||
+        typeName === 'ZodOptional' ||
+        typeName === 'default' ||
+        typeName === 'ZodDefault') {
+        const inner = getInnerType(zodType);
+        return inner ? getEnumValues(inner) : undefined;
+    }
+    return undefined;
+}
+/**
+ * Get description from Zod type
+ */
+function getDescription(zodType) {
+    const def = getDef(zodType);
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-member-access
+    return def?.description ?? zodType.description;
+}
+/**
+ * Check if Zod type is optional
+ */
+function isOptional(zodType) {
+    const typeName = getZodTypeName(zodType);
+    return (typeName === 'optional' ||
+        typeName === 'ZodOptional' ||
+        typeName === 'default' ||
+        typeName === 'ZodDefault' ||
+        zodType.isOptional?.() === true);
+}
+/**
+ * Get inner type from Zod array
+ */
+function getArrayItemType(zodType) {
+    const typeName = getZodTypeName(zodType);
+    const def = getDef(zodType);
+    // Zod 4 array
+    if (typeName === 'array' && def?.element) {
+        // Wrap the element's def for compatibility
+        if (def.element.def) {
+            return { _def: def.element.def };
+        }
+        return def.element;
+    }
+    // Zod 3 array
+    if (typeName === 'ZodArray' && def?.type) {
+        return def.type;
+    }
+    // Unwrap optional/default
+    if (typeName === 'optional' ||
+        typeName === 'ZodOptional' ||
+        typeName === 'default' ||
+        typeName === 'ZodDefault') {
+        const inner = getInnerType(zodType);
+        return inner ? getArrayItemType(inner) : undefined;
+    }
+    return undefined;
+}
+/**
+ * Convert a Zod schema to MCP-compatible JSON Schema
+ *
+ * @param schema - Zod object schema
+ * @returns JSON Schema representation for MCP inputSchema
+ */
+export function zodToMcpInputSchema(schema) {
+    const shape = schema.shape;
+    const properties = {};
+    const required = [];
+    for (const [key, zodType] of Object.entries(shape)) {
+        const type = zodTypeToJsonType(zodType);
+        const description = getDescription(zodType);
+        const enumValues = getEnumValues(zodType);
+        const property = { type };
+        if (description)
+            property.description = description;
+        if (enumValues)
+            property.enum = enumValues;
+        // Handle array items
+        if (type === 'array') {
+            const itemType = getArrayItemType(zodType);
+            if (itemType) {
+                property.items = { type: zodTypeToJsonType(itemType) };
+            }
+        }
+        properties[key] = property;
+        // Track required fields
+        if (!isOptional(zodType)) {
+            required.push(key);
+        }
+    }
+    return {
+        type: 'object',
+        properties,
+        ...(required.length > 0 && { required }),
+        additionalProperties: false,
+    };
+}
+// =============================================================================
+// Zod to CLI Options (for Commander.js)
+// =============================================================================
+/**
+ * Convert snake_case to kebab-case for CLI flags
+ */
+function toKebabCase(str) {
+    return str.replace(/_/g, '-');
+}
+/**
+ * Convert snake_case to camelCase for option names
+ */
+function toCamelCase(str) {
+    return str.replace(/_([a-z])/g, (_, letter) => letter.toUpperCase());
+}
+/**
+ * Convert a Zod schema to CLI option definitions
+ *
+ * @param schema - Zod object schema
+ * @returns Array of CLI option definitions compatible with Commander.js
+ */
+export function zodToCliOptions(schema) {
+    const shape = schema.shape;
+    const options = [];
+    for (const [key, zodType] of Object.entries(shape)) {
+        const type = zodTypeToJsonType(zodType);
+        const description = getDescription(zodType) ?? '';
+        const isRequired = !isOptional(zodType);
+        const isRepeatable = type === 'array';
+        const kebabKey = toKebabCase(key);
+        const camelKey = toCamelCase(key);
+        // Build flags string
+        // Boolean flags don't need <value> placeholder
+        const valueSpec = type === 'boolean' ? '' : ` <${key}>`;
+        const flags = `--${kebabKey}${valueSpec}`;
+        options.push({
+            name: camelKey,
+            flags,
+            description,
+            required: isRequired,
+            isRepeatable,
+        });
+    }
+    return options;
+}
+// =============================================================================
+// Parity Validation
+// =============================================================================
+/**
+ * Validate CLI/MCP parity for a command schema
+ *
+ * Checks that:
+ * 1. All MCP fields are available in CLI
+ * 2. Required fields are consistent
+ * 3. Types are compatible
+ *
+ * @param commandName - Name of the command (for error messages)
+ * @param schema - Zod schema for the command
+ * @returns Validation result with errors and warnings
+ */
+export function validateCliMcpParity(commandName, schema) {
+    const errors = [];
+    const warnings = [];
+    // Generate both representations
+    const jsonSchema = zodToMcpInputSchema(schema);
+    const cliOptions = zodToCliOptions(schema);
+    // Check that all MCP fields have CLI equivalents
+    for (const mcpField of Object.keys(jsonSchema.properties)) {
+        const cliField = toCamelCase(mcpField);
+        const hasCliOption = cliOptions.some((opt) => opt.name === cliField);
+        if (!hasCliOption) {
+            errors.push(`${commandName}: MCP field '${mcpField}' has no CLI equivalent`);
+        }
+    }
+    // Check required field consistency
+    const mcpRequired = new Set(jsonSchema.required ?? []);
+    for (const opt of cliOptions) {
+        const mcpField = toKebabCase(opt.name).replace(/-/g, '_');
+        const mcpIsRequired = mcpRequired.has(mcpField);
+        if (opt.required !== mcpIsRequired) {
+            errors.push(`${commandName}: Field '${opt.name}' required mismatch (CLI: ${opt.required}, MCP: ${mcpIsRequired})`);
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings,
+    };
+}
+//# sourceMappingURL=schema-utils.js.map

package/dist/schemas/schema-utils.js.map

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

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

@@ -0,0 +1,91 @@
+import type { ValidationResult } from './arg-validators.js';
+/** Validate lumenflow:init arguments */
+export declare const validateLumenflowInitArgs: (args: Record<string, unknown>) => ValidationResult<{
+    client?: string | undefined;
+    merge?: boolean | undefined;
+    full?: boolean | undefined;
+    minimal?: boolean | undefined;
+    framework?: string | undefined;
+}>;
+/** Validate lumenflow:doctor arguments */
+export declare const validateLumenflowDoctorArgs: (args: Record<string, unknown>) => ValidationResult<Record<string, never>>;
+/** Validate lumenflow:integrate arguments */
+export declare const validateLumenflowIntegrateArgs: (args: Record<string, unknown>) => ValidationResult<{
+    client: string;
+}>;
+/** Validate lumenflow:upgrade arguments */
+export declare const validateLumenflowUpgradeArgs: (args: Record<string, unknown>) => ValidationResult<Record<string, never>>;
+/** Validate lumenflow:commands arguments */
+export declare const validateLumenflowCommandsArgs: (args: Record<string, unknown>) => ValidationResult<Record<string, never>>;
+/** Validate docs:sync arguments */
+export declare const validateDocsSyncArgs: (args: Record<string, unknown>) => ValidationResult<Record<string, never>>;
+/** Validate release arguments */
+export declare const validateReleaseArgs: (args: Record<string, unknown>) => ValidationResult<{
+    dry_run?: boolean | undefined;
+}>;
+/** Validate sync:templates arguments */
+export declare const validateSyncTemplatesArgs: (args: Record<string, unknown>) => ValidationResult<Record<string, never>>;
+/** Validate agent:session arguments */
+export declare const validateAgentSessionArgs: (args: Record<string, unknown>) => ValidationResult<{
+    wu: string;
+    tier: number;
+    agent_type?: string | undefined;
+}>;
+/** Validate agent:session:end arguments */
+export declare const validateAgentSessionEndArgs: (args: Record<string, unknown>) => ValidationResult<Record<string, never>>;
+/** Validate agent:log-issue arguments */
+export declare const validateAgentLogIssueArgs: (args: Record<string, unknown>) => ValidationResult<{
+    category: "tooling" | "error" | "workflow" | "confusion" | "violation";
+    severity: "blocker" | "major" | "minor" | "info";
+    title: string;
+    description: string;
+    resolution?: string | undefined;
+    tags?: string[] | undefined;
+    step?: string | undefined;
+    files?: string[] | undefined;
+}>;
+/** Validate agent:issues-query arguments */
+export declare const validateAgentIssuesQueryArgs: (args: Record<string, unknown>) => ValidationResult<{
+    since?: number | undefined;
+    category?: string | undefined;
+    severity?: "blocker" | "major" | "minor" | "trivial" | undefined;
+}>;
+/** Validate orchestrate:initiative arguments */
+export declare const validateOrchestrateInitiativeArgs: (args: Record<string, unknown>) => ValidationResult<{
+    initiative: string;
+    dry_run?: boolean | undefined;
+    progress?: boolean | undefined;
+    checkpoint_per_wave?: boolean | undefined;
+}>;
+/** Validate orchestrate:init-status arguments */
+export declare const validateOrchestrateInitStatusArgs: (args: Record<string, unknown>) => ValidationResult<{
+    initiative: string;
+}>;
+/** Validate orchestrate:monitor arguments */
+export declare const validateOrchestrateMonitorArgs: (args: Record<string, unknown>) => ValidationResult<{
+    threshold?: number | undefined;
+    recover?: boolean | undefined;
+    dry_run?: boolean | undefined;
+    since?: string | undefined;
+    wu?: string | undefined;
+    signals_only?: boolean | undefined;
+}>;
+/** Validate delegation:list arguments */
+export declare const validateDelegationListArgs: (args: Record<string, unknown>) => ValidationResult<{
+    wu?: string | undefined;
+    initiative?: string | undefined;
+    json?: boolean | undefined;
+}>;
+/** Validate session:coordinator arguments */
+export declare const validateSessionCoordinatorArgs: (args: Record<string, unknown>) => ValidationResult<{
+    command?: "status" | "start" | "stop" | "handoff" | undefined;
+    wu?: string | undefined;
+    agent?: string | undefined;
+    reason?: string | undefined;
+}>;
+/** Validate rotate:progress arguments */
+export declare const validateRotateProgressArgs: (args: Record<string, unknown>) => ValidationResult<{
+    dry_run?: boolean | undefined;
+    limit?: number | undefined;
+}>;
+//# sourceMappingURL=setup-arg-validators.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"setup-arg-validators.d.ts","sourceRoot":"","sources":["../../src/schemas/setup-arg-validators.ts"],"names":[],"mappings":"AAoDA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AA4E5D,wCAAwC;AACxC,eAAO,MAAM,yBAAyB,SA3B3B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;EA2B+D,CAAC;AAElG,0CAA0C;AAC1C,eAAO,MAAM,2BAA2B,SA9B7B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,4CA+B4B,CAAC;AAE/D,6CAA6C;AAC7C,eAAO,MAAM,8BAA8B,SAlChC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;EAmCkC,CAAC;AAErE,2CAA2C;AAC3C,eAAO,MAAM,4BAA4B,SAtC9B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,4CAuC8B,CAAC;AAEjE,4CAA4C;AAC5C,eAAO,MAAM,6BAA6B,SA1C/B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,4CA2CgC,CAAC;AAEnE,mCAAmC;AACnC,eAAO,MAAM,oBAAoB,SA9CtB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,4CA8CgD,CAAC;AAEnF,iCAAiC;AACjC,eAAO,MAAM,mBAAmB,SAjDrB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;EAiD6C,CAAC;AAEhF,wCAAwC;AACxC,eAAO,MAAM,yBAAyB,SApD3B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,4CAoD+D,CAAC;AAMlG,uCAAuC;AACvC,eAAO,MAAM,wBAAwB,SA3D1B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;EA2D4D,CAAC;AAE/F,2CAA2C;AAC3C,eAAO,MAAM,2BAA2B,SA9D7B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,4CA+D4B,CAAC;AAE/D,yCAAyC;AACzC,eAAO,MAAM,yBAAyB,SAlE3B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;;;EAkE+D,CAAC;AAElG,4CAA4C;AAC5C,eAAO,MAAM,4BAA4B,SArE9B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;EAsE8B,CAAC;AAMjE,gDAAgD;AAChD,eAAO,MAAM,iCAAiC,SA7EnC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;EA+EjC,CAAC;AAEF,iDAAiD;AACjD,eAAO,MAAM,iCAAiC,SAlFnC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;EAoFjC,CAAC;AAEF,6CAA6C;AAC7C,eAAO,MAAM,8BAA8B,SAvFhC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;EAwFkC,CAAC;AAMrE,yCAAyC;AACzC,eAAO,MAAM,0BAA0B,SA/F5B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;EAgG0B,CAAC;AAM7D,6CAA6C;AAC7C,eAAO,MAAM,8BAA8B,SAvGhC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;EAwGkC,CAAC;AAErE,yCAAyC;AACzC,eAAO,MAAM,0BAA0B,SA3G5B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;EA4G0B,CAAC"}

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

@@ -0,0 +1,98 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * @file setup-arg-validators.ts
+ * @description CLI argument validators for setup, agent, orchestration, delegation, and coordination
+ * commands using shared schemas (WU-1457)
+ *
+ * These validators use the shared Zod schemas to validate CLI arguments for the
+ * 18 setup/agent/orchestration/delegation/coordination commands. They follow the same
+ * pattern as memory-arg-validators.ts (WU-1456).
+ */
+import { lumenflowInitSchema, lumenflowDoctorSchema, lumenflowIntegrateSchema, lumenflowUpgradeSchema, lumenflowCommandsSchema, docsSyncSchema, releaseSchema, syncTemplatesSchema, agentSessionSchema, agentSessionEndSchema, agentLogIssueSchema, agentIssuesQuerySchema, orchestrateInitiativeSchema, orchestrateInitStatusSchema, orchestrateMonitorSchema, delegationListSchema, sessionCoordinatorSchema, rotateProgressSchema, } from './setup-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,
+        };
+    };
+}
+// =============================================================================
+// Setup Validators
+// =============================================================================
+/** Validate lumenflow:init arguments */
+export const validateLumenflowInitArgs = createValidator(lumenflowInitSchema);
+/** Validate lumenflow:doctor arguments */
+export const validateLumenflowDoctorArgs = createValidator(lumenflowDoctorSchema);
+/** Validate lumenflow:integrate arguments */
+export const validateLumenflowIntegrateArgs = createValidator(lumenflowIntegrateSchema);
+/** Validate lumenflow:upgrade arguments */
+export const validateLumenflowUpgradeArgs = createValidator(lumenflowUpgradeSchema);
+/** Validate lumenflow:commands arguments */
+export const validateLumenflowCommandsArgs = createValidator(lumenflowCommandsSchema);
+/** Validate docs:sync arguments */
+export const validateDocsSyncArgs = createValidator(docsSyncSchema);
+/** Validate release arguments */
+export const validateReleaseArgs = createValidator(releaseSchema);
+/** Validate sync:templates arguments */
+export const validateSyncTemplatesArgs = createValidator(syncTemplatesSchema);
+// =============================================================================
+// Agent Validators
+// =============================================================================
+/** Validate agent:session arguments */
+export const validateAgentSessionArgs = createValidator(agentSessionSchema);
+/** Validate agent:session:end arguments */
+export const validateAgentSessionEndArgs = createValidator(agentSessionEndSchema);
+/** Validate agent:log-issue arguments */
+export const validateAgentLogIssueArgs = createValidator(agentLogIssueSchema);
+/** Validate agent:issues-query arguments */
+export const validateAgentIssuesQueryArgs = createValidator(agentIssuesQuerySchema);
+// =============================================================================
+// Orchestration Validators
+// =============================================================================
+/** Validate orchestrate:initiative arguments */
+export const validateOrchestrateInitiativeArgs = createValidator(orchestrateInitiativeSchema);
+/** Validate orchestrate:init-status arguments */
+export const validateOrchestrateInitStatusArgs = createValidator(orchestrateInitStatusSchema);
+/** Validate orchestrate:monitor arguments */
+export const validateOrchestrateMonitorArgs = createValidator(orchestrateMonitorSchema);
+// =============================================================================
+// Delegation Validators
+// =============================================================================
+/** Validate delegation:list arguments */
+export const validateDelegationListArgs = createValidator(delegationListSchema);
+// =============================================================================
+// Coordination Validators
+// =============================================================================
+/** Validate session:coordinator arguments */
+export const validateSessionCoordinatorArgs = createValidator(sessionCoordinatorSchema);
+/** Validate rotate:progress arguments */
+export const validateRotateProgressArgs = createValidator(rotateProgressSchema);
+//# sourceMappingURL=setup-arg-validators.js.map

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

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