@lumenflow/core 2.11.0 → 2.13.0

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

@@ -0,0 +1,335 @@
+/**
+ * @file setup-schemas.ts
+ * @description Shared Zod schemas for Setup, Agent, Orchestration, Spawn, and Coordination commands (WU-1457)
+ *
+ * These schemas are the single source of truth for command validation.
+ * Both CLI argument parsing and MCP inputSchema derivation use these schemas.
+ *
+ * This file covers the 18 commands that were previously hand-coded
+ * in MCP and CLI separately:
+ * - 8 setup/lumenflow commands
+ * - 4 agent commands
+ * - 3 orchestration commands
+ * - 1 spawn command
+ * - 2 coordination 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 aliases are NOT defined here (handled in arg-validators)
+ */
+import { z } from 'zod';
+/**
+ * Schema for lumenflow:init command
+ *
+ * No required fields
+ * Optional: client, merge, full, minimal, framework
+ */
+export declare const lumenflowInitSchema: z.ZodObject<{
+    client: z.ZodOptional<z.ZodString>;
+    merge: z.ZodOptional<z.ZodBoolean>;
+    full: z.ZodOptional<z.ZodBoolean>;
+    minimal: z.ZodOptional<z.ZodBoolean>;
+    framework: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type LumenflowInitInput = z.infer<typeof lumenflowInitSchema>;
+/**
+ * Schema for lumenflow:doctor command
+ *
+ * No parameters
+ */
+export declare const lumenflowDoctorSchema: z.ZodObject<{}, z.core.$strip>;
+export type LumenflowDoctorInput = z.infer<typeof lumenflowDoctorSchema>;
+/**
+ * Schema for lumenflow:integrate command
+ *
+ * Required: client
+ */
+export declare const lumenflowIntegrateSchema: z.ZodObject<{
+    client: z.ZodString;
+}, z.core.$strip>;
+export type LumenflowIntegrateInput = z.infer<typeof lumenflowIntegrateSchema>;
+/**
+ * Schema for lumenflow:upgrade command
+ *
+ * No parameters
+ */
+export declare const lumenflowUpgradeSchema: z.ZodObject<{}, z.core.$strip>;
+export type LumenflowUpgradeInput = z.infer<typeof lumenflowUpgradeSchema>;
+/**
+ * Schema for lumenflow:commands (lumenflow commands) command
+ *
+ * No parameters
+ */
+export declare const lumenflowCommandsSchema: z.ZodObject<{}, z.core.$strip>;
+export type LumenflowCommandsInput = z.infer<typeof lumenflowCommandsSchema>;
+/**
+ * Schema for docs:sync command
+ *
+ * No parameters
+ */
+export declare const docsSyncSchema: z.ZodObject<{}, z.core.$strip>;
+export type DocsSyncInput = z.infer<typeof docsSyncSchema>;
+/**
+ * Schema for release command
+ *
+ * No required fields
+ * Optional: dry_run
+ */
+export declare const releaseSchema: z.ZodObject<{
+    dry_run: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type ReleaseInput = z.infer<typeof releaseSchema>;
+/**
+ * Schema for sync:templates command
+ *
+ * No parameters
+ */
+export declare const syncTemplatesSchema: z.ZodObject<{}, z.core.$strip>;
+export type SyncTemplatesInput = z.infer<typeof syncTemplatesSchema>;
+/**
+ * Schema for agent:session command
+ *
+ * Required: wu, tier
+ * Optional: agent_type
+ */
+export declare const agentSessionSchema: z.ZodObject<{
+    wu: z.ZodString;
+    tier: z.ZodNumber;
+    agent_type: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type AgentSessionInput = z.infer<typeof agentSessionSchema>;
+/**
+ * Schema for agent:session:end command
+ *
+ * No parameters
+ */
+export declare const agentSessionEndSchema: z.ZodObject<{}, z.core.$strip>;
+export type AgentSessionEndInput = z.infer<typeof agentSessionEndSchema>;
+/**
+ * Schema for agent:log-issue command
+ *
+ * Required: category, severity, title, description
+ * Optional: resolution, tags, step, files
+ */
+export declare const agentLogIssueSchema: z.ZodObject<{
+    category: z.ZodEnum<{
+        tooling: "tooling";
+        error: "error";
+        workflow: "workflow";
+        confusion: "confusion";
+        violation: "violation";
+    }>;
+    severity: z.ZodEnum<{
+        blocker: "blocker";
+        major: "major";
+        minor: "minor";
+        info: "info";
+    }>;
+    title: z.ZodString;
+    description: z.ZodString;
+    resolution: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    step: z.ZodOptional<z.ZodString>;
+    files: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type AgentLogIssueInput = z.infer<typeof agentLogIssueSchema>;
+/**
+ * Schema for agent:issues-query command
+ *
+ * No required fields
+ * Optional: since, category, severity
+ */
+export declare const agentIssuesQuerySchema: z.ZodObject<{
+    since: z.ZodOptional<z.ZodNumber>;
+    category: z.ZodOptional<z.ZodString>;
+    severity: z.ZodOptional<z.ZodEnum<{
+        blocker: "blocker";
+        major: "major";
+        minor: "minor";
+        trivial: "trivial";
+    }>>;
+}, z.core.$strip>;
+export type AgentIssuesQueryInput = z.infer<typeof agentIssuesQuerySchema>;
+/**
+ * Schema for orchestrate:initiative command
+ *
+ * Required: initiative
+ * Optional: dry_run, progress, checkpoint_per_wave
+ */
+export declare const orchestrateInitiativeSchema: z.ZodObject<{
+    initiative: z.ZodString;
+    dry_run: z.ZodOptional<z.ZodBoolean>;
+    progress: z.ZodOptional<z.ZodBoolean>;
+    checkpoint_per_wave: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type OrchestrateInitiativeInput = z.infer<typeof orchestrateInitiativeSchema>;
+/**
+ * Schema for orchestrate:init-status command
+ *
+ * Required: initiative
+ */
+export declare const orchestrateInitStatusSchema: z.ZodObject<{
+    initiative: z.ZodString;
+}, z.core.$strip>;
+export type OrchestrateInitStatusInput = z.infer<typeof orchestrateInitStatusSchema>;
+/**
+ * Schema for orchestrate:monitor command
+ *
+ * No required fields
+ * Optional: threshold, recover, dry_run, since, wu, signals_only
+ */
+export declare const orchestrateMonitorSchema: z.ZodObject<{
+    threshold: z.ZodOptional<z.ZodNumber>;
+    recover: z.ZodOptional<z.ZodBoolean>;
+    dry_run: z.ZodOptional<z.ZodBoolean>;
+    since: z.ZodOptional<z.ZodString>;
+    wu: z.ZodOptional<z.ZodString>;
+    signals_only: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type OrchestrateMonitorInput = z.infer<typeof orchestrateMonitorSchema>;
+/**
+ * Schema for spawn:list command
+ *
+ * No required fields
+ * Optional: wu, initiative, json
+ */
+export declare const spawnListSchema: z.ZodObject<{
+    wu: z.ZodOptional<z.ZodString>;
+    initiative: z.ZodOptional<z.ZodString>;
+    json: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type SpawnListInput = z.infer<typeof spawnListSchema>;
+/**
+ * Schema for session:coordinator command
+ *
+ * No required fields (subcommand is positional in CLI)
+ * Optional: command, wu, agent, reason
+ */
+export declare const sessionCoordinatorSchema: z.ZodObject<{
+    command: z.ZodOptional<z.ZodEnum<{
+        status: "status";
+        start: "start";
+        stop: "stop";
+        handoff: "handoff";
+    }>>;
+    wu: z.ZodOptional<z.ZodString>;
+    agent: z.ZodOptional<z.ZodString>;
+    reason: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type SessionCoordinatorInput = z.infer<typeof sessionCoordinatorSchema>;
+/**
+ * Schema for rotate:progress command
+ *
+ * No required fields
+ * Optional: dry_run, limit
+ */
+export declare const rotateProgressSchema: z.ZodObject<{
+    dry_run: z.ZodOptional<z.ZodBoolean>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type RotateProgressInput = z.infer<typeof rotateProgressSchema>;
+/**
+ * Registry of all setup, agent, orchestration, spawn, and coordination command
+ * schemas for validation and parity checking.
+ * These complement the schemas in command-schemas.ts (WU-1431),
+ * wu-lifecycle-schemas.ts (WU-1454), initiative-schemas.ts (WU-1455),
+ * memory-schemas.ts (WU-1456), flow-schemas.ts (WU-1457),
+ * and validation-schemas.ts (WU-1457).
+ */
+export declare const setupCommandSchemas: {
+    readonly 'lumenflow:init': z.ZodObject<{
+        client: z.ZodOptional<z.ZodString>;
+        merge: z.ZodOptional<z.ZodBoolean>;
+        full: z.ZodOptional<z.ZodBoolean>;
+        minimal: z.ZodOptional<z.ZodBoolean>;
+        framework: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    readonly 'lumenflow:doctor': z.ZodObject<{}, z.core.$strip>;
+    readonly 'lumenflow:integrate': z.ZodObject<{
+        client: z.ZodString;
+    }, z.core.$strip>;
+    readonly 'lumenflow:upgrade': z.ZodObject<{}, z.core.$strip>;
+    readonly 'lumenflow:commands': z.ZodObject<{}, z.core.$strip>;
+    readonly 'docs:sync': z.ZodObject<{}, z.core.$strip>;
+    readonly release: z.ZodObject<{
+        dry_run: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>;
+    readonly 'sync:templates': z.ZodObject<{}, z.core.$strip>;
+    readonly 'agent:session': z.ZodObject<{
+        wu: z.ZodString;
+        tier: z.ZodNumber;
+        agent_type: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    readonly 'agent:session:end': z.ZodObject<{}, z.core.$strip>;
+    readonly 'agent:log-issue': z.ZodObject<{
+        category: z.ZodEnum<{
+            tooling: "tooling";
+            error: "error";
+            workflow: "workflow";
+            confusion: "confusion";
+            violation: "violation";
+        }>;
+        severity: z.ZodEnum<{
+            blocker: "blocker";
+            major: "major";
+            minor: "minor";
+            info: "info";
+        }>;
+        title: z.ZodString;
+        description: z.ZodString;
+        resolution: z.ZodOptional<z.ZodString>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        step: z.ZodOptional<z.ZodString>;
+        files: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>;
+    readonly 'agent:issues-query': z.ZodObject<{
+        since: z.ZodOptional<z.ZodNumber>;
+        category: z.ZodOptional<z.ZodString>;
+        severity: z.ZodOptional<z.ZodEnum<{
+            blocker: "blocker";
+            major: "major";
+            minor: "minor";
+            trivial: "trivial";
+        }>>;
+    }, z.core.$strip>;
+    readonly 'orchestrate:initiative': z.ZodObject<{
+        initiative: z.ZodString;
+        dry_run: z.ZodOptional<z.ZodBoolean>;
+        progress: z.ZodOptional<z.ZodBoolean>;
+        checkpoint_per_wave: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>;
+    readonly 'orchestrate:init-status': z.ZodObject<{
+        initiative: z.ZodString;
+    }, z.core.$strip>;
+    readonly 'orchestrate:monitor': z.ZodObject<{
+        threshold: z.ZodOptional<z.ZodNumber>;
+        recover: z.ZodOptional<z.ZodBoolean>;
+        dry_run: z.ZodOptional<z.ZodBoolean>;
+        since: z.ZodOptional<z.ZodString>;
+        wu: z.ZodOptional<z.ZodString>;
+        signals_only: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>;
+    readonly 'spawn:list': z.ZodObject<{
+        wu: z.ZodOptional<z.ZodString>;
+        initiative: z.ZodOptional<z.ZodString>;
+        json: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>;
+    readonly 'session:coordinator': z.ZodObject<{
+        command: z.ZodOptional<z.ZodEnum<{
+            status: "status";
+            start: "start";
+            stop: "stop";
+            handoff: "handoff";
+        }>>;
+        wu: z.ZodOptional<z.ZodString>;
+        agent: z.ZodOptional<z.ZodString>;
+        reason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    readonly 'rotate:progress': z.ZodObject<{
+        dry_run: z.ZodOptional<z.ZodBoolean>;
+        limit: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>;
+};
+export type SetupCommandName = keyof typeof setupCommandSchemas;
+//# sourceMappingURL=setup-schemas.d.ts.map

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

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

package/dist/schemas/setup-schemas.js

@@ -0,0 +1,258 @@
+/**
+ * @file setup-schemas.ts
+ * @description Shared Zod schemas for Setup, Agent, Orchestration, Spawn, and Coordination commands (WU-1457)
+ *
+ * These schemas are the single source of truth for command validation.
+ * Both CLI argument parsing and MCP inputSchema derivation use these schemas.
+ *
+ * This file covers the 18 commands that were previously hand-coded
+ * in MCP and CLI separately:
+ * - 8 setup/lumenflow commands
+ * - 4 agent commands
+ * - 3 orchestration commands
+ * - 1 spawn command
+ * - 2 coordination 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 aliases are NOT defined here (handled in arg-validators)
+ */
+import { z } from 'zod';
+// =============================================================================
+// Setup / LumenFlow Commands
+// =============================================================================
+/**
+ * Schema for lumenflow:init command
+ *
+ * No required fields
+ * Optional: client, merge, full, minimal, framework
+ */
+export const lumenflowInitSchema = z.object({
+    client: z
+        .string()
+        .optional()
+        .describe('Client type (claude, cursor, windsurf, codex, all, none)'),
+    merge: z.boolean().optional().describe('Merge into existing files using bounded markers'),
+    full: z.boolean().optional().describe('Add docs + agent onboarding + task scaffolding'),
+    minimal: z.boolean().optional().describe('Skip agent onboarding docs (only core files)'),
+    framework: z.string().optional().describe('Add framework hint + overlay docs'),
+});
+/**
+ * Schema for lumenflow:doctor command
+ *
+ * No parameters
+ */
+export const lumenflowDoctorSchema = z.object({});
+/**
+ * Schema for lumenflow:integrate command
+ *
+ * Required: client
+ */
+export const lumenflowIntegrateSchema = z.object({
+    client: z.string().describe('Client name (claude-code, cursor, etc.)'),
+});
+/**
+ * Schema for lumenflow:upgrade command
+ *
+ * No parameters
+ */
+export const lumenflowUpgradeSchema = z.object({});
+/**
+ * Schema for lumenflow:commands (lumenflow commands) command
+ *
+ * No parameters
+ */
+export const lumenflowCommandsSchema = z.object({});
+/**
+ * Schema for docs:sync command
+ *
+ * No parameters
+ */
+export const docsSyncSchema = z.object({});
+/**
+ * Schema for release command
+ *
+ * No required fields
+ * Optional: dry_run
+ */
+export const releaseSchema = z.object({
+    dry_run: z.boolean().optional().describe('Preview release without publishing'),
+});
+/**
+ * Schema for sync:templates command
+ *
+ * No parameters
+ */
+export const syncTemplatesSchema = z.object({});
+// =============================================================================
+// Agent Commands
+// =============================================================================
+/**
+ * Schema for agent:session command
+ *
+ * Required: wu, tier
+ * Optional: agent_type
+ */
+export const agentSessionSchema = z.object({
+    wu: z.string().describe('WU ID to work on (e.g., WU-1234)'),
+    tier: z.number().min(1).max(3).describe('Context tier (1, 2, or 3)'),
+    agent_type: z.string().optional().describe('Agent type (default: claude-code)'),
+});
+/**
+ * Schema for agent:session:end command
+ *
+ * No parameters
+ */
+export const agentSessionEndSchema = z.object({});
+/**
+ * Schema for agent:log-issue command
+ *
+ * Required: category, severity, title, description
+ * Optional: resolution, tags, step, files
+ */
+export const agentLogIssueSchema = z.object({
+    category: z
+        .enum(['workflow', 'tooling', 'confusion', 'violation', 'error'])
+        .describe('Issue category'),
+    severity: z.enum(['blocker', 'major', 'minor', 'info']).describe('Severity level'),
+    title: z.string().describe('Short description (5-100 chars)'),
+    description: z.string().describe('Detailed context (10-2000 chars)'),
+    resolution: z.string().optional().describe('How the issue was resolved'),
+    tags: z.array(z.string()).optional().describe('Tags for categorization'),
+    step: z.string().optional().describe('Current workflow step (e.g., wu:done, gates)'),
+    files: z.array(z.string()).optional().describe('Related file paths'),
+});
+/**
+ * Schema for agent:issues-query command
+ *
+ * No required fields
+ * Optional: since, category, severity
+ */
+export const agentIssuesQuerySchema = z.object({
+    since: z.number().optional().describe('Days to include (default: 7)'),
+    category: z.string().optional().describe('Filter by category'),
+    severity: z
+        .enum(['blocker', 'major', 'minor', 'trivial'])
+        .optional()
+        .describe('Filter by severity'),
+});
+// =============================================================================
+// Orchestration Commands
+// =============================================================================
+/**
+ * Schema for orchestrate:initiative command
+ *
+ * Required: initiative
+ * Optional: dry_run, progress, checkpoint_per_wave
+ */
+export const orchestrateInitiativeSchema = z.object({
+    initiative: z.string().describe('Initiative ID to orchestrate (e.g., INIT-001)'),
+    dry_run: z.boolean().optional().describe('Show execution plan without spawning agents'),
+    progress: z.boolean().optional().describe('Show current progress only'),
+    checkpoint_per_wave: z.boolean().optional().describe('Spawn next wave then exit (no polling)'),
+});
+/**
+ * Schema for orchestrate:init-status command
+ *
+ * Required: initiative
+ */
+export const orchestrateInitStatusSchema = z.object({
+    initiative: z.string().describe('Initiative ID or slug (e.g., INIT-001)'),
+});
+/**
+ * Schema for orchestrate:monitor command
+ *
+ * No required fields
+ * Optional: threshold, recover, dry_run, since, wu, signals_only
+ */
+export const orchestrateMonitorSchema = z.object({
+    threshold: z.number().optional().describe('Stuck detection threshold in minutes (default: 30)'),
+    recover: z.boolean().optional().describe('Run recovery actions for stuck spawns'),
+    dry_run: z.boolean().optional().describe('Show what would be done without taking action'),
+    since: z.string().optional().describe('Show signals since (e.g., 30m, 1h)'),
+    wu: z.string().optional().describe('Filter by WU ID'),
+    signals_only: z.boolean().optional().describe('Only show signals (skip spawn analysis)'),
+});
+// =============================================================================
+// Spawn Commands
+// =============================================================================
+/**
+ * Schema for spawn:list command
+ *
+ * No required fields
+ * Optional: wu, initiative, json
+ */
+export const spawnListSchema = z.object({
+    wu: z.string().optional().describe('WU ID to show spawns for (e.g., WU-1234)'),
+    initiative: z
+        .string()
+        .optional()
+        .describe('Initiative ID to show all spawns for (e.g., INIT-001)'),
+    json: z.boolean().optional().describe('Output as JSON'),
+});
+// =============================================================================
+// Coordination Commands
+// =============================================================================
+/**
+ * Schema for session:coordinator command
+ *
+ * No required fields (subcommand is positional in CLI)
+ * Optional: command, wu, agent, reason
+ */
+export const sessionCoordinatorSchema = z.object({
+    command: z
+        .enum(['start', 'stop', 'status', 'handoff'])
+        .optional()
+        .describe('Session subcommand (start, stop, status, handoff)'),
+    wu: z.string().optional().describe('WU ID to work on'),
+    agent: z.string().optional().describe('Agent name/type'),
+    reason: z.string().optional().describe('Reason for stopping session'),
+});
+/**
+ * Schema for rotate:progress command
+ *
+ * No required fields
+ * Optional: dry_run, limit
+ */
+export const rotateProgressSchema = z.object({
+    dry_run: z.boolean().optional().describe('Show changes without writing'),
+    limit: z.number().optional().describe('Maximum number of WUs to rotate'),
+});
+// =============================================================================
+// Setup Schema Registry
+// =============================================================================
+/**
+ * Registry of all setup, agent, orchestration, spawn, and coordination command
+ * schemas for validation and parity checking.
+ * These complement the schemas in command-schemas.ts (WU-1431),
+ * wu-lifecycle-schemas.ts (WU-1454), initiative-schemas.ts (WU-1455),
+ * memory-schemas.ts (WU-1456), flow-schemas.ts (WU-1457),
+ * and validation-schemas.ts (WU-1457).
+ */
+export const setupCommandSchemas = {
+    // Setup commands
+    'lumenflow:init': lumenflowInitSchema,
+    'lumenflow:doctor': lumenflowDoctorSchema,
+    'lumenflow:integrate': lumenflowIntegrateSchema,
+    'lumenflow:upgrade': lumenflowUpgradeSchema,
+    'lumenflow:commands': lumenflowCommandsSchema,
+    'docs:sync': docsSyncSchema,
+    release: releaseSchema,
+    'sync:templates': syncTemplatesSchema,
+    // Agent commands
+    'agent:session': agentSessionSchema,
+    'agent:session:end': agentSessionEndSchema,
+    'agent:log-issue': agentLogIssueSchema,
+    'agent:issues-query': agentIssuesQuerySchema,
+    // Orchestration commands
+    'orchestrate:initiative': orchestrateInitiativeSchema,
+    'orchestrate:init-status': orchestrateInitStatusSchema,
+    'orchestrate:monitor': orchestrateMonitorSchema,
+    // Spawn commands
+    'spawn:list': spawnListSchema,
+    // Coordination commands
+    'session:coordinator': sessionCoordinatorSchema,
+    'rotate:progress': rotateProgressSchema,
+};
+//# sourceMappingURL=setup-schemas.js.map

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

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

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

@@ -0,0 +1,26 @@
+/**
+ * @file validation-arg-validators.ts
+ * @description CLI argument validators for validation commands using shared schemas (WU-1457)
+ *
+ * These validators use the shared Zod schemas to validate CLI arguments for the
+ * 5 validation commands. They follow the same pattern as memory-arg-validators.ts
+ * (WU-1456).
+ */
+import type { ValidationResult } from './arg-validators.js';
+/** Validate validate arguments */
+export declare const validateValidateArgs: (args: Record<string, unknown>) => ValidationResult<{
+    id?: string;
+    strict?: boolean;
+    done_only?: boolean;
+}>;
+/** Validate validate:agent-skills arguments */
+export declare const validateValidateAgentSkillsArgs: (args: Record<string, unknown>) => ValidationResult<{
+    skill?: string;
+}>;
+/** Validate validate:agent-sync arguments */
+export declare const validateValidateAgentSyncArgs: (args: Record<string, unknown>) => ValidationResult<Record<string, never>>;
+/** Validate validate:backlog-sync arguments */
+export declare const validateValidateBacklogSyncArgs: (args: Record<string, unknown>) => ValidationResult<Record<string, never>>;
+/** Validate validate:skills-spec arguments */
+export declare const validateValidateSkillsSpecArgs: (args: Record<string, unknown>) => ValidationResult<Record<string, never>>;
+//# sourceMappingURL=validation-arg-validators.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validation-arg-validators.d.ts","sourceRoot":"","sources":["../../src/schemas/validation-arg-validators.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAeH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AA4E5D,kCAAkC;AAClC,eAAO,MAAM,oBAAoB,SA3BtB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;EA2BgD,CAAC;AAEnF,+CAA+C;AAC/C,eAAO,MAAM,+BAA+B,SA9BjC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;EA+BoC,CAAC;AAEvE,6CAA6C;AAC7C,eAAO,MAAM,6BAA6B,SAlC/B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,4CAmCgC,CAAC;AAEnE,+CAA+C;AAC/C,eAAO,MAAM,+BAA+B,SAtCjC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,4CAuCoC,CAAC;AAEvE,8CAA8C;AAC9C,eAAO,MAAM,8BAA8B,SA1ChC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,4CA2CkC,CAAC"}