@lumenflow/core 3.1.2 → 3.2.0

package/dist/schemas/schema-utils.js

@@ -1,320 +0,0 @@
-// 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

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

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

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

@@ -1,98 +0,0 @@
-// 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

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