@lumenflow/core 2.11.0 → 2.13.0

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

@@ -0,0 +1,287 @@
+/**
+ * @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';
+/**
+ * Schema for mem:init command
+ *
+ * No required fields - initializes memory layer in current directory
+ */
+export declare const memInitSchema: z.ZodObject<{
+    wu: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type MemInitInput = z.infer<typeof memInitSchema>;
+/**
+ * Schema for mem:start command
+ *
+ * Required: wu
+ * Optional: lane, agent_type, context_tier
+ */
+export declare const memStartSchema: z.ZodObject<{
+    wu: z.ZodString;
+    lane: z.ZodOptional<z.ZodString>;
+    agent_type: z.ZodOptional<z.ZodString>;
+    context_tier: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type MemStartInput = z.infer<typeof memStartSchema>;
+/**
+ * Schema for mem:ready command
+ *
+ * Required: wu
+ * Optional: type, format
+ */
+export declare const memReadySchema: z.ZodObject<{
+    wu: z.ZodString;
+    type: z.ZodOptional<z.ZodString>;
+    format: z.ZodOptional<z.ZodEnum<{
+        human: "human";
+        json: "json";
+    }>>;
+}, z.core.$strip>;
+export type MemReadyInput = z.infer<typeof memReadySchema>;
+/**
+ * Schema for mem:checkpoint command
+ *
+ * Required: wu
+ * Optional: message, session, progress, next_steps, trigger
+ */
+export declare const memCheckpointSchema: z.ZodObject<{
+    wu: z.ZodString;
+    message: z.ZodOptional<z.ZodString>;
+    session: z.ZodOptional<z.ZodString>;
+    progress: z.ZodOptional<z.ZodString>;
+    next_steps: z.ZodOptional<z.ZodString>;
+    trigger: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type MemCheckpointInput = z.infer<typeof memCheckpointSchema>;
+/**
+ * Schema for mem:cleanup command
+ *
+ * No required fields
+ * Optional: dry_run, ttl, session_id
+ */
+export declare const memCleanupSchema: z.ZodObject<{
+    dry_run: z.ZodOptional<z.ZodBoolean>;
+    ttl: z.ZodOptional<z.ZodString>;
+    session_id: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type MemCleanupInput = z.infer<typeof memCleanupSchema>;
+/**
+ * Schema for mem:context command
+ *
+ * Required: wu
+ * Optional: lane, max_size, max_recent_summaries, max_project_nodes, format
+ */
+export declare const memContextSchema: z.ZodObject<{
+    wu: z.ZodString;
+    lane: z.ZodOptional<z.ZodString>;
+    max_size: z.ZodOptional<z.ZodNumber>;
+    max_recent_summaries: z.ZodOptional<z.ZodNumber>;
+    max_project_nodes: z.ZodOptional<z.ZodNumber>;
+    format: z.ZodOptional<z.ZodEnum<{
+        human: "human";
+        json: "json";
+    }>>;
+}, z.core.$strip>;
+export type MemContextInput = z.infer<typeof memContextSchema>;
+/**
+ * Schema for mem:create command
+ *
+ * Required: message
+ * Optional: wu, type, tags, discovered_from, session, priority
+ */
+export declare const memCreateSchema: z.ZodObject<{
+    message: z.ZodString;
+    wu: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    discovered_from: z.ZodOptional<z.ZodString>;
+    session: z.ZodOptional<z.ZodString>;
+    priority: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type MemCreateInput = z.infer<typeof memCreateSchema>;
+/**
+ * Schema for mem:delete command
+ *
+ * Required: id
+ * Optional: tag, older_than, dry_run
+ */
+export declare const memDeleteSchema: z.ZodObject<{
+    id: z.ZodString;
+    tag: z.ZodOptional<z.ZodString>;
+    older_than: z.ZodOptional<z.ZodString>;
+    dry_run: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type MemDeleteInput = z.infer<typeof memDeleteSchema>;
+/**
+ * Schema for mem:export command
+ *
+ * Required: wu
+ * Optional: format, type, lifecycle
+ */
+export declare const memExportSchema: z.ZodObject<{
+    wu: z.ZodString;
+    format: z.ZodOptional<z.ZodEnum<{
+        markdown: "markdown";
+        json: "json";
+    }>>;
+    type: z.ZodOptional<z.ZodString>;
+    lifecycle: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type MemExportInput = z.infer<typeof memExportSchema>;
+/**
+ * Schema for mem:inbox command
+ *
+ * No required fields
+ * Optional: since, wu, lane
+ */
+export declare const memInboxSchema: z.ZodObject<{
+    since: z.ZodOptional<z.ZodString>;
+    wu: z.ZodOptional<z.ZodString>;
+    lane: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type MemInboxInput = z.infer<typeof memInboxSchema>;
+/**
+ * Schema for mem:signal command
+ *
+ * Required: message, wu
+ */
+export declare const memSignalSchema: z.ZodObject<{
+    message: z.ZodString;
+    wu: z.ZodString;
+}, z.core.$strip>;
+export type MemSignalInput = z.infer<typeof memSignalSchema>;
+/**
+ * Schema for mem:summarize command
+ *
+ * Required: wu
+ * Optional: dry_run
+ */
+export declare const memSummarizeSchema: z.ZodObject<{
+    wu: z.ZodString;
+    dry_run: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type MemSummarizeInput = z.infer<typeof memSummarizeSchema>;
+/**
+ * Schema for mem:triage command
+ *
+ * No required fields
+ * Optional: wu, promote, lane, archive, reason
+ */
+export declare const memTriageSchema: z.ZodObject<{
+    wu: z.ZodOptional<z.ZodString>;
+    promote: z.ZodOptional<z.ZodString>;
+    lane: z.ZodOptional<z.ZodString>;
+    archive: z.ZodOptional<z.ZodString>;
+    reason: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type MemTriageInput = z.infer<typeof memTriageSchema>;
+/**
+ * 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 declare const memoryCommandSchemas: {
+    readonly 'mem:init': z.ZodObject<{
+        wu: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    readonly 'mem:start': z.ZodObject<{
+        wu: z.ZodString;
+        lane: z.ZodOptional<z.ZodString>;
+        agent_type: z.ZodOptional<z.ZodString>;
+        context_tier: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    readonly 'mem:ready': z.ZodObject<{
+        wu: z.ZodString;
+        type: z.ZodOptional<z.ZodString>;
+        format: z.ZodOptional<z.ZodEnum<{
+            human: "human";
+            json: "json";
+        }>>;
+    }, z.core.$strip>;
+    readonly 'mem:checkpoint': z.ZodObject<{
+        wu: z.ZodString;
+        message: z.ZodOptional<z.ZodString>;
+        session: z.ZodOptional<z.ZodString>;
+        progress: z.ZodOptional<z.ZodString>;
+        next_steps: z.ZodOptional<z.ZodString>;
+        trigger: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    readonly 'mem:cleanup': z.ZodObject<{
+        dry_run: z.ZodOptional<z.ZodBoolean>;
+        ttl: z.ZodOptional<z.ZodString>;
+        session_id: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    readonly 'mem:context': z.ZodObject<{
+        wu: z.ZodString;
+        lane: z.ZodOptional<z.ZodString>;
+        max_size: z.ZodOptional<z.ZodNumber>;
+        max_recent_summaries: z.ZodOptional<z.ZodNumber>;
+        max_project_nodes: z.ZodOptional<z.ZodNumber>;
+        format: z.ZodOptional<z.ZodEnum<{
+            human: "human";
+            json: "json";
+        }>>;
+    }, z.core.$strip>;
+    readonly 'mem:create': z.ZodObject<{
+        message: z.ZodString;
+        wu: z.ZodOptional<z.ZodString>;
+        type: z.ZodOptional<z.ZodString>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        discovered_from: z.ZodOptional<z.ZodString>;
+        session: z.ZodOptional<z.ZodString>;
+        priority: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    readonly 'mem:delete': z.ZodObject<{
+        id: z.ZodString;
+        tag: z.ZodOptional<z.ZodString>;
+        older_than: z.ZodOptional<z.ZodString>;
+        dry_run: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>;
+    readonly 'mem:export': z.ZodObject<{
+        wu: z.ZodString;
+        format: z.ZodOptional<z.ZodEnum<{
+            markdown: "markdown";
+            json: "json";
+        }>>;
+        type: z.ZodOptional<z.ZodString>;
+        lifecycle: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    readonly 'mem:inbox': z.ZodObject<{
+        since: z.ZodOptional<z.ZodString>;
+        wu: z.ZodOptional<z.ZodString>;
+        lane: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    readonly 'mem:signal': z.ZodObject<{
+        message: z.ZodString;
+        wu: z.ZodString;
+    }, z.core.$strip>;
+    readonly 'mem:summarize': z.ZodObject<{
+        wu: z.ZodString;
+        dry_run: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>;
+    readonly 'mem:triage': z.ZodObject<{
+        wu: z.ZodOptional<z.ZodString>;
+        promote: z.ZodOptional<z.ZodString>;
+        lane: z.ZodOptional<z.ZodString>;
+        archive: z.ZodOptional<z.ZodString>;
+        reason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+};
+export type MemoryCommandName = keyof typeof memoryCommandSchemas;
+//# sourceMappingURL=memory-schemas.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memory-schemas.d.ts","sourceRoot":"","sources":["../../src/schemas/memory-schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB;;;;GAIG;AACH,eAAO,MAAM,aAAa;;iBAExB,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAMzD;;;;;GAKG;AACH,eAAO,MAAM,cAAc;;;;;iBAQzB,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAM3D;;;;;GAKG;AACH,eAAO,MAAM,cAAc;;;;;;;iBAIzB,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAM3D;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB;;;;;;;iBAO9B,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAMrE;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB;;;;iBAI3B,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAM/D;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;iBAO3B,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAM/D;;;;;GAKG;AACH,eAAO,MAAM,eAAe;;;;;;;;iBAQ1B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAM7D;;;;;GAKG;AACH,eAAO,MAAM,eAAe;;;;;iBAK1B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAM7D;;;;;GAKG;AACH,eAAO,MAAM,eAAe;;;;;;;;iBAQ1B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAM7D;;;;;GAKG;AACH,eAAO,MAAM,cAAc;;;;iBAIzB,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAM3D;;;;GAIG;AACH,eAAO,MAAM,eAAe;;;iBAG1B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAM7D;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB;;;iBAG7B,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAMnE;;;;;GAKG;AACH,eAAO,MAAM,eAAe;;;;;;iBAM1B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAM7D;;;;GAIG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAcvB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,MAAM,OAAO,oBAAoB,CAAC"}

package/dist/schemas/memory-schemas.js

@@ -0,0 +1,240 @@
+/**
+ * @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/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":"AAAA;;;;;;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"}