@lumenflow/core 3.1.3 → 3.2.1

package/dist/schemas/memory-schemas.js

@@ -0,0 +1,242 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * @file memory-schemas.ts
+ * @description Shared Zod schemas for Memory commands (WU-1456)
+ *
+ * These schemas are the single source of truth for memory command validation.
+ * Both CLI argument parsing and MCP inputSchema derivation use these schemas.
+ *
+ * This file covers the 13 memory commands that were previously hand-coded
+ * in MCP and CLI separately. Combined with the schemas from command-schemas.ts
+ * (WU-1431), wu-lifecycle-schemas.ts (WU-1454), and initiative-schemas.ts
+ * (WU-1455), this provides full shared schema coverage for all LumenFlow commands.
+ *
+ * Design decisions:
+ * - Use snake_case for property names (MCP convention, JSON Schema friendly)
+ * - Include descriptions for each field (used in both CLI help and MCP tool descriptions)
+ * - CLI-only options (base_dir, quiet) are NOT included here (transport-specific)
+ * - Schemas reflect the semantic parameters visible to both CLI and MCP consumers
+ */
+import { z } from 'zod';
+// =============================================================================
+// mem:init Schema
+// =============================================================================
+/**
+ * Schema for mem:init command
+ *
+ * No required fields - initializes memory layer in current directory
+ */
+export const memInitSchema = z.object({
+    wu: z.string().optional().describe('WU ID to initialize memory for'),
+});
+// =============================================================================
+// mem:start Schema
+// =============================================================================
+/**
+ * Schema for mem:start command
+ *
+ * Required: wu
+ * Optional: lane, agent_type, context_tier
+ */
+export const memStartSchema = z.object({
+    wu: z.string().describe('WU ID to start session for'),
+    lane: z.string().optional().describe('Lane name'),
+    agent_type: z
+        .string()
+        .optional()
+        .describe('Agent type (e.g., general-purpose, explore, test-engineer)'),
+    context_tier: z.string().optional().describe('Context tier (core, full, minimal)'),
+});
+// =============================================================================
+// mem:ready Schema
+// =============================================================================
+/**
+ * Schema for mem:ready command
+ *
+ * Required: wu
+ * Optional: type, format
+ */
+export const memReadySchema = z.object({
+    wu: z.string().describe('WU ID to check pending nodes for'),
+    type: z.string().optional().describe('Filter by node type'),
+    format: z.enum(['json', 'human']).optional().describe('Output format'),
+});
+// =============================================================================
+// mem:checkpoint Schema
+// =============================================================================
+/**
+ * Schema for mem:checkpoint command
+ *
+ * Required: wu
+ * Optional: message, session, progress, next_steps, trigger
+ */
+export const memCheckpointSchema = z.object({
+    wu: z.string().describe('WU ID to checkpoint'),
+    message: z.string().optional().describe('Checkpoint message'),
+    session: z.string().optional().describe('Session ID to link checkpoint to (UUID)'),
+    progress: z.string().optional().describe('Progress summary'),
+    next_steps: z.string().optional().describe('Next steps description'),
+    trigger: z.string().optional().describe('Handoff trigger type (e.g., clear, handoff)'),
+});
+// =============================================================================
+// mem:cleanup Schema
+// =============================================================================
+/**
+ * Schema for mem:cleanup command
+ *
+ * No required fields
+ * Optional: dry_run, ttl, session_id
+ */
+export const memCleanupSchema = z.object({
+    dry_run: z.boolean().optional().describe('Preview cleanup without making changes'),
+    ttl: z.string().optional().describe('Remove nodes older than duration (e.g., 30d, 7d, 24h)'),
+    session_id: z.string().optional().describe('Session ID to consider closed'),
+});
+// =============================================================================
+// mem:context Schema
+// =============================================================================
+/**
+ * Schema for mem:context command
+ *
+ * Required: wu
+ * Optional: lane, max_size, max_recent_summaries, max_project_nodes, format
+ */
+export const memContextSchema = z.object({
+    wu: z.string().describe('WU ID to get context for'),
+    lane: z.string().optional().describe('Filter by lane'),
+    max_size: z.number().optional().describe('Maximum context size in bytes'),
+    max_recent_summaries: z.number().optional().describe('Maximum number of recent summaries'),
+    max_project_nodes: z.number().optional().describe('Maximum number of project nodes'),
+    format: z.enum(['json', 'human']).optional().describe('Output format'),
+});
+// =============================================================================
+// mem:create Schema
+// =============================================================================
+/**
+ * Schema for mem:create command
+ *
+ * Required: message
+ * Optional: wu, type, tags, discovered_from, session, priority
+ */
+export const memCreateSchema = z.object({
+    message: z.string().describe('Memory node message'),
+    wu: z.string().optional().describe('WU ID to associate with'),
+    type: z.string().optional().describe('Node type (e.g., discovery, session, checkpoint, note)'),
+    tags: z.array(z.string()).optional().describe('Tags for the node'),
+    discovered_from: z.string().optional().describe('Parent node ID for provenance tracking'),
+    session: z.string().optional().describe('Session ID to link node to (UUID)'),
+    priority: z.string().optional().describe('Priority level (P0, P1, P2, P3)'),
+});
+// =============================================================================
+// mem:delete Schema
+// =============================================================================
+/**
+ * Schema for mem:delete command
+ *
+ * Required: id
+ * Optional: tag, older_than, dry_run
+ */
+export const memDeleteSchema = z.object({
+    id: z.string().describe('Memory node ID to delete'),
+    tag: z.string().optional().describe('Delete all nodes matching this tag'),
+    older_than: z.string().optional().describe('Delete nodes older than duration (e.g., 30d)'),
+    dry_run: z.boolean().optional().describe('Preview deletion without making changes'),
+});
+// =============================================================================
+// mem:export Schema
+// =============================================================================
+/**
+ * Schema for mem:export command
+ *
+ * Required: wu
+ * Optional: format, type, lifecycle
+ */
+export const memExportSchema = z.object({
+    wu: z.string().describe('WU ID to export'),
+    format: z.enum(['markdown', 'json']).optional().describe('Export format'),
+    type: z.string().optional().describe('Filter by node type'),
+    lifecycle: z
+        .string()
+        .optional()
+        .describe('Filter by lifecycle (ephemeral, session, wu, project)'),
+});
+// =============================================================================
+// mem:inbox Schema
+// =============================================================================
+/**
+ * Schema for mem:inbox command
+ *
+ * No required fields
+ * Optional: since, wu, lane
+ */
+export const memInboxSchema = z.object({
+    since: z.string().optional().describe('Time filter (e.g., "30m", "1h")'),
+    wu: z.string().optional().describe('Filter by WU ID'),
+    lane: z.string().optional().describe('Filter by lane'),
+});
+// =============================================================================
+// mem:signal Schema
+// =============================================================================
+/**
+ * Schema for mem:signal command
+ *
+ * Required: message, wu
+ */
+export const memSignalSchema = z.object({
+    message: z.string().describe('Signal message'),
+    wu: z.string().describe('WU ID to associate with'),
+});
+// =============================================================================
+// mem:summarize Schema
+// =============================================================================
+/**
+ * Schema for mem:summarize command
+ *
+ * Required: wu
+ * Optional: dry_run
+ */
+export const memSummarizeSchema = z.object({
+    wu: z.string().describe('WU ID to summarize'),
+    dry_run: z.boolean().optional().describe('Preview summary without making changes'),
+});
+// =============================================================================
+// mem:triage Schema
+// =============================================================================
+/**
+ * Schema for mem:triage command
+ *
+ * No required fields
+ * Optional: wu, promote, lane, archive, reason
+ */
+export const memTriageSchema = z.object({
+    wu: z.string().optional().describe('WU ID to triage discoveries for'),
+    promote: z.string().optional().describe('Memory node ID to promote to Bug WU'),
+    lane: z.string().optional().describe('Lane for promoted Bug WU'),
+    archive: z.string().optional().describe('Memory node ID to archive'),
+    reason: z.string().optional().describe('Reason for archiving'),
+});
+// =============================================================================
+// Memory Schema Registry
+// =============================================================================
+/**
+ * Registry of all memory command schemas for validation and parity checking.
+ * These complement the schemas in command-schemas.ts (WU-1431),
+ * wu-lifecycle-schemas.ts (WU-1454), and initiative-schemas.ts (WU-1455).
+ */
+export const memoryCommandSchemas = {
+    'mem:init': memInitSchema,
+    'mem:start': memStartSchema,
+    'mem:ready': memReadySchema,
+    'mem:checkpoint': memCheckpointSchema,
+    'mem:cleanup': memCleanupSchema,
+    'mem:context': memContextSchema,
+    'mem:create': memCreateSchema,
+    'mem:delete': memDeleteSchema,
+    'mem:export': memExportSchema,
+    'mem:inbox': memInboxSchema,
+    'mem:signal': memSignalSchema,
+    'mem:summarize': memSummarizeSchema,
+    'mem:triage': memTriageSchema,
+};
+//# sourceMappingURL=memory-schemas.js.map

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

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

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

@@ -0,0 +1,145 @@
+/**
+ * Operational Configuration Schemas
+ *
+ * Experimental features, cleanup triggers, telemetry, UI, YAML serialization,
+ * package manager, and test runner schemas.
+ *
+ * @module schemas/operational-config
+ */
+import { z } from 'zod';
+/**
+ * WU-1356: Package manager options
+ *
+ * Supported package managers for LumenFlow CLI operations.
+ * Used for build commands, dependency installation, and script execution.
+ *
+ * @example
+ * ```yaml
+ * package_manager: npm
+ * ```
+ */
+export declare const PackageManagerSchema: z.ZodDefault<z.ZodEnum<{
+    pnpm: "pnpm";
+    npm: "npm";
+    yarn: "yarn";
+    bun: "bun";
+}>>;
+/** WU-1356: TypeScript type for package manager */
+export type PackageManager = z.infer<typeof PackageManagerSchema>;
+/**
+ * WU-1356: Test runner options
+ *
+ * Supported test runners for incremental test detection and execution.
+ * Determines how changed tests are detected and ignore patterns are derived.
+ *
+ * @example
+ * ```yaml
+ * test_runner: jest
+ * ```
+ */
+export declare const TestRunnerSchema: z.ZodDefault<z.ZodEnum<{
+    vitest: "vitest";
+    jest: "jest";
+    mocha: "mocha";
+}>>;
+/** WU-1356: TypeScript type for test runner */
+export type TestRunner = z.infer<typeof TestRunnerSchema>;
+/**
+ * UI configuration
+ */
+export declare const UiConfigSchema: z.ZodObject<{
+    errorBoxWidth: z.ZodDefault<z.ZodNumber>;
+    statusPreviewLines: z.ZodDefault<z.ZodNumber>;
+    readinessBoxWidth: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * YAML serialization configuration
+ */
+export declare const YamlConfigSchema: z.ZodObject<{
+    lineWidth: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * Validation mode for context-aware commands
+ * WU-1090: Context-aware state machine for WU lifecycle commands
+ */
+export declare const ValidationModeSchema: z.ZodDefault<z.ZodEnum<{
+    error: "error";
+    off: "off";
+    warn: "warn";
+}>>;
+/**
+ * Experimental features configuration
+ * WU-1090: Feature flags for gradual rollout
+ */
+export declare const ExperimentalConfigSchema: z.ZodObject<{
+    context_validation: z.ZodDefault<z.ZodBoolean>;
+    validation_mode: z.ZodDefault<z.ZodEnum<{
+        error: "error";
+        off: "off";
+        warn: "warn";
+    }>>;
+    show_next_steps: z.ZodDefault<z.ZodBoolean>;
+    recovery_command: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+/**
+ * WU-1270: Methodology telemetry configuration
+ *
+ * Opt-in telemetry to track which methodology modes are being used.
+ * Privacy-preserving: No PII or project-identifying information collected.
+ */
+export declare const MethodologyTelemetryConfigSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+/**
+ * WU-1270: Telemetry configuration
+ *
+ * Configuration for opt-in telemetry features.
+ */
+export declare const TelemetryConfigSchema: z.ZodObject<{
+    methodology: z.ZodDefault<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * WU-1366: Cleanup trigger options
+ *
+ * Controls when automatic state cleanup runs:
+ * - 'on_done': Run after wu:done success (default)
+ * - 'on_init': Run during lumenflow init
+ * - 'manual': Only run via pnpm state:cleanup
+ */
+export declare const CleanupTriggerSchema: z.ZodDefault<z.ZodEnum<{
+    manual: "manual";
+    on_done: "on_done";
+    on_init: "on_init";
+}>>;
+/** WU-1366: TypeScript type for cleanup trigger */
+export type CleanupTrigger = z.infer<typeof CleanupTriggerSchema>;
+/**
+ * WU-1366: Cleanup configuration schema
+ *
+ * Controls when and how automatic state cleanup runs.
+ *
+ * @example
+ * ```yaml
+ * cleanup:
+ *   trigger: on_done  # on_done | on_init | manual
+ * ```
+ */
+export declare const CleanupConfigSchema: z.ZodObject<{
+    trigger: z.ZodDefault<z.ZodEnum<{
+        manual: "manual";
+        on_done: "on_done";
+        on_init: "on_init";
+    }>>;
+    commit_message: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>;
+/** WU-1366: TypeScript type for cleanup config */
+export type CleanupConfig = z.infer<typeof CleanupConfigSchema>;
+export type UiConfig = z.infer<typeof UiConfigSchema>;
+export type YamlConfig = z.infer<typeof YamlConfigSchema>;
+export type ExperimentalConfig = z.infer<typeof ExperimentalConfigSchema>;
+export type ValidationMode = z.infer<typeof ValidationModeSchema>;
+export type MethodologyTelemetryConfig = z.infer<typeof MethodologyTelemetryConfigSchema>;
+export type TelemetryConfig = z.infer<typeof TelemetryConfigSchema>;
+//# sourceMappingURL=operational-config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"operational-config.d.ts","sourceRoot":"","sources":["../../src/schemas/operational-config.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;GAUG;AACH,eAAO,MAAM,oBAAoB;;;;;GAAyD,CAAC;AAE3F,mDAAmD;AACnD,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE;;;;;;;;;;GAUG;AACH,eAAO,MAAM,gBAAgB;;;;GAAwD,CAAC;AAEtF,+CAA+C;AAC/C,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D;;GAEG;AACH,eAAO,MAAM,cAAc;;;;iBASzB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,gBAAgB;;iBAG3B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;;;GAAmD,CAAC;AAErF;;;GAGG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;iBA4BnC,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,gCAAgC;;iBAQ3C,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,qBAAqB;;;;iBAQhC,CAAC;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB;;;;GAA8D,CAAC;AAEhG,mDAAmD;AACnD,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE;;;;;;;;;;GAUG;AACH,eAAO,MAAM,mBAAmB;;;;;;;iBAyB9B,CAAC;AAEH,kDAAkD;AAClD,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AACtD,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC1D,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC1E,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAC;AAC1F,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC"}

package/dist/schemas/operational-config.js

@@ -0,0 +1,161 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * Operational Configuration Schemas
+ *
+ * Experimental features, cleanup triggers, telemetry, UI, YAML serialization,
+ * package manager, and test runner schemas.
+ *
+ * @module schemas/operational-config
+ */
+import { z } from 'zod';
+/**
+ * WU-1356: Package manager options
+ *
+ * Supported package managers for LumenFlow CLI operations.
+ * Used for build commands, dependency installation, and script execution.
+ *
+ * @example
+ * ```yaml
+ * package_manager: npm
+ * ```
+ */
+export const PackageManagerSchema = z.enum(['pnpm', 'npm', 'yarn', 'bun']).default('pnpm');
+/**
+ * WU-1356: Test runner options
+ *
+ * Supported test runners for incremental test detection and execution.
+ * Determines how changed tests are detected and ignore patterns are derived.
+ *
+ * @example
+ * ```yaml
+ * test_runner: jest
+ * ```
+ */
+export const TestRunnerSchema = z.enum(['vitest', 'jest', 'mocha']).default('vitest');
+/**
+ * UI configuration
+ */
+export const UiConfigSchema = z.object({
+    /** Error box width (default: 70) */
+    errorBoxWidth: z.number().int().positive().default(70),
+    /** Status preview lines (default: 5) */
+    statusPreviewLines: z.number().int().positive().default(5),
+    /** Readiness box width (default: 50) */
+    readinessBoxWidth: z.number().int().positive().default(50),
+});
+/**
+ * YAML serialization configuration
+ */
+export const YamlConfigSchema = z.object({
+    /** Line width for YAML output (default: 100, -1 for no wrap) */
+    lineWidth: z.number().int().default(100),
+});
+/**
+ * Validation mode for context-aware commands
+ * WU-1090: Context-aware state machine for WU lifecycle commands
+ */
+export const ValidationModeSchema = z.enum(['off', 'warn', 'error']).default('warn');
+/**
+ * Experimental features configuration
+ * WU-1090: Feature flags for gradual rollout
+ */
+export const ExperimentalConfigSchema = z.object({
+    /**
+     * Enable context-aware validation for wu:* commands
+     * When enabled, commands will check location, WU status, and predicates
+     * @default true
+     */
+    context_validation: z.boolean().default(true),
+    /**
+     * Validation behavior mode
+     * - 'off': No validation (legacy behavior)
+     * - 'warn': Show warnings but proceed
+     * - 'error': Block on validation failures
+     * @default 'warn'
+     */
+    validation_mode: ValidationModeSchema,
+    /**
+     * Show next steps guidance after successful command completion
+     * @default true
+     */
+    show_next_steps: z.boolean().default(true),
+    /**
+     * Enable wu:recover command for state recovery
+     * @default true
+     */
+    recovery_command: z.boolean().default(true),
+});
+/**
+ * WU-1270: Methodology telemetry configuration
+ *
+ * Opt-in telemetry to track which methodology modes are being used.
+ * Privacy-preserving: No PII or project-identifying information collected.
+ */
+export const MethodologyTelemetryConfigSchema = z.object({
+    /**
+     * Enable methodology telemetry (opt-in).
+     * When true, tracks methodology.testing and methodology.architecture values
+     * on wu:spawn events. Data is privacy-preserving (no PII/project info).
+     * @default false
+     */
+    enabled: z.boolean().default(false),
+});
+/**
+ * WU-1270: Telemetry configuration
+ *
+ * Configuration for opt-in telemetry features.
+ */
+export const TelemetryConfigSchema = z.object({
+    /**
+     * Methodology telemetry configuration (opt-in).
+     * Tracks methodology selection patterns for adoption insights.
+     */
+    methodology: MethodologyTelemetryConfigSchema.default(() => MethodologyTelemetryConfigSchema.parse({})),
+});
+/**
+ * WU-1366: Cleanup trigger options
+ *
+ * Controls when automatic state cleanup runs:
+ * - 'on_done': Run after wu:done success (default)
+ * - 'on_init': Run during lumenflow init
+ * - 'manual': Only run via pnpm state:cleanup
+ */
+export const CleanupTriggerSchema = z.enum(['on_done', 'on_init', 'manual']).default('on_done');
+/**
+ * WU-1366: Cleanup configuration schema
+ *
+ * Controls when and how automatic state cleanup runs.
+ *
+ * @example
+ * ```yaml
+ * cleanup:
+ *   trigger: on_done  # on_done | on_init | manual
+ * ```
+ */
+export const CleanupConfigSchema = z.object({
+    /**
+     * When to trigger automatic state cleanup.
+     * - 'on_done': Run after wu:done success (default)
+     * - 'on_init': Run during lumenflow init
+     * - 'manual': Only run via pnpm state:cleanup
+     *
+     * @default 'on_done'
+     */
+    trigger: CleanupTriggerSchema,
+    /**
+     * WU-1542: Commit message for auto-cleanup changes.
+     * Consumer repos with strict main-branch guards may reject the default.
+     * Configure this to match your repo's allowed commit message patterns.
+     *
+     * @default 'chore: lumenflow state cleanup [skip ci]'
+     *
+     * @example
+     * ```yaml
+     * cleanup:
+     *   commit_message: 'chore(repair): auto state cleanup [skip ci]'
+     * ```
+     */
+    commit_message: z.string().default('chore: lumenflow state cleanup [skip ci]'),
+});
+//# sourceMappingURL=operational-config.js.map

package/dist/schemas/operational-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operational-config.js","sourceRoot":"","sources":["../../src/schemas/operational-config.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAEzC;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;AAK3F;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;AAKtF;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,oCAAoC;IACpC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IAEtD,wCAAwC;IACxC,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAE1D,wCAAwC;IACxC,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;CAC3D,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,gEAAgE;IAChE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC;CACzC,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;AAErF;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C;;;;OAIG;IACH,kBAAkB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IAE7C;;;;;;OAMG;IACH,eAAe,EAAE,oBAAoB;IAErC;;;OAGG;IACH,eAAe,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IAE1C;;;OAGG;IACH,gBAAgB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;CAC5C,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,CAAC,MAAM,CAAC;IACvD;;;;;OAKG;IACH,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;CACpC,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C;;;OAGG;IACH,WAAW,EAAE,gCAAgC,CAAC,OAAO,CAAC,GAAG,EAAE,CACzD,gCAAgC,CAAC,KAAK,CAAC,EAAE,CAAC,CAC3C;CACF,CAAC,CAAC;AAEH;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAKhG;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C;;;;;;;OAOG;IACH,OAAO,EAAE,oBAAoB;IAE7B;;;;;;;;;;;;OAYG;IACH,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,0CAA0C,CAAC;CAC/E,CAAC,CAAC"}

package/dist/schemas/schema-utils.d.ts

@@ -0,0 +1,87 @@
+/**
+ * @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';
+/**
+ * JSON Schema representation for MCP inputSchema
+ */
+export interface JsonSchemaProperty {
+    type: string;
+    description?: string;
+    enum?: string[];
+    items?: JsonSchemaProperty;
+}
+export interface JsonSchema {
+    type: 'object';
+    properties: Record<string, JsonSchemaProperty>;
+    required?: string[];
+    additionalProperties?: boolean;
+}
+/**
+ * CLI option definition compatible with Commander.js
+ */
+export interface CliOption {
+    name: string;
+    flags: string;
+    description: string;
+    default?: unknown;
+    isRepeatable?: boolean;
+    required?: boolean;
+}
+/**
+ * CLI-only alias definition
+ */
+export interface CliAlias {
+    name: string;
+    flags: string;
+    description: string;
+    canonical: string;
+    isRepeatable?: boolean;
+}
+/**
+ * Validation result for parity checking
+ */
+export interface ParityValidationResult {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+}
+/**
+ * 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 declare function getCliOnlyAliases(): Record<string, CliAlias>;
+/**
+ * Convert a Zod schema to MCP-compatible JSON Schema
+ *
+ * @param schema - Zod object schema
+ * @returns JSON Schema representation for MCP inputSchema
+ */
+export declare function zodToMcpInputSchema(schema: z.ZodObject<z.ZodRawShape>): JsonSchema;
+/**
+ * Convert a Zod schema to CLI option definitions
+ *
+ * @param schema - Zod object schema
+ * @returns Array of CLI option definitions compatible with Commander.js
+ */
+export declare function zodToCliOptions(schema: z.ZodObject<z.ZodRawShape>): CliOption[];
+/**
+ * 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 declare function validateCliMcpParity(commandName: string, schema: z.ZodObject<z.ZodRawShape>): ParityValidationResult;
+//# sourceMappingURL=schema-utils.d.ts.map

package/dist/schemas/schema-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-utils.d.ts","sourceRoot":"","sources":["../../src/schemas/schema-utils.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA4BxB;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,kBAAkB,CAAC;CAC5B;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAC/C,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AA2BD;;;;;GAKG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAE5D;AAiKD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,UAAU,CAoClF;AAoBD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,SAAS,EAAE,CA2B/E;AAMD;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,GACjC,sBAAsB,CAoCxB"}