claude-brain 0.15.2 → 0.16.0

package/src/server/handlers/tools/schemas.ts

@@ -1,253 +1,253 @@
-/**
- * Zod Validation Schemas for Tool Handlers
- * Provides input validation for all MCP tool handlers
- */
-
-import { z } from 'zod'
-
-// ============================================================================
-// Project Context & Management
-// ============================================================================
-
-export const GetProjectContextSchema = z.object({
-  project_name: z.string().min(1, 'project_name is required'),
-  include_memories: z.boolean().optional().default(true),
-  memory_limit: z.number().int().min(1).max(100).optional().default(5)
-})
-
-export const ListProjectsSchema = z.object({
-  status_filter: z.enum(['active', 'archived', 'planning', 'all']).optional().default('active')
-})
-
-export const CreateProjectSchema = z.object({
-  project_name: z.string().min(1, 'project_name is required')
-    .regex(/^[a-z0-9-]+$/, 'project_name must be lowercase with hyphens only'),
-  description: z.string().optional(),
-  tech_stack: z.array(z.string()).optional().default([]),
-  status: z.enum(['planning', 'active', 'on-hold', 'completed']).optional().default('planning'),
-  tags: z.array(z.string()).optional().default([])
-})
-
-export const InitProjectSchema = z.object({
-  project_path: z.string().optional(),
-  project_name: z.string().optional(),
-  save_to_memory: z.boolean().optional().default(true)
-})
-
-// ============================================================================
-// Decision & Memory
-// ============================================================================
-
-export const RememberDecisionSchema = z.object({
-  project_name: z.string().min(1, 'project_name is required'),
-  context: z.string().min(1, 'context is required'),
-  decision: z.string().min(1, 'decision is required'),
-  reasoning: z.string().min(1, 'reasoning is required'),
-  alternatives_considered: z.string().optional(),
-  tags: z.array(z.string()).optional().default([])
-})
-
-export const RecallSimilarSchema = z.object({
-  query: z.string().min(1, 'query is required'),
-  project_filter: z.string().optional(),
-  limit: z.number().int().min(1).max(50).optional().default(5),
-  min_similarity: z.number().min(0).max(1).optional().default(0.3)
-})
-
-// ============================================================================
-// Smart Context & Automation
-// ============================================================================
-
-export const SmartContextSchema = z.object({
-  project_name: z.string().min(1, 'project_name is required'),
-  current_task: z.string().min(1, 'current_task is required'),
-  min_similarity: z.number().min(0).max(1).optional().default(0.3)
-})
-
-export const AutoRememberSchema = z.object({
-  project_name: z.string().min(1, 'project_name is required'),
-  text: z.string().min(1, 'text is required'),
-  confidence_threshold: z.number().min(0).max(1).optional().default(0.7)
-})
-
-// ============================================================================
-// Code Standards
-// ============================================================================
-
-export const GetCodeStandardsSchema = z.object({
-  project_name: z.string().min(1, 'project_name is required'),
-  language: z.string().optional()
-})
-
-// ============================================================================
-// Progress Tracking
-// ============================================================================
-
-export const UpdateProgressSchema = z.object({
-  project_name: z.string().min(1, 'project_name is required'),
-  completed_task: z.string().min(1, 'completed_task is required'),
-  next_steps: z.string().min(1, 'next_steps is required'),
-  notes: z.string().optional()
-})
-
-// ============================================================================
-// Patterns & Corrections
-// ============================================================================
-
-export const RecognizePatternSchema = z.object({
-  project_name: z.string().min(1, 'project_name is required'),
-  pattern_type: z.enum(['solution', 'anti-pattern', 'best-practice', 'common-issue']),
-  description: z.string().min(1, 'description is required'),
-  example: z.string().optional(),
-  confidence: z.number().min(0).max(1).optional().default(0.8),
-  context: z.string().optional()
-})
-
-export const RecordCorrectionSchema = z.object({
-  project_name: z.string().min(1, 'project_name is required'),
-  original: z.string().min(1, 'original is required'),
-  correction: z.string().min(1, 'correction is required'),
-  reasoning: z.string().min(1, 'reasoning is required'),
-  context: z.string().optional(),
-  confidence: z.number().min(0).max(1).optional().default(0.9)
-})
-
-export const GetPatternsSchema = z.object({
-  project_name: z.string().optional(),
-  pattern_type: z.enum(['solution', 'anti-pattern', 'best-practice', 'common-issue']).optional(),
-  limit: z.number().int().min(1).max(100).optional().default(10),
-  query: z.string().optional()
-})
-
-export const GetCorrectionsSchema = z.object({
-  project_name: z.string().optional(),
-  limit: z.number().int().min(1).max(100).optional().default(10),
-  query: z.string().optional()
-})
-
-// ============================================================================
-// Phase 12 Status
-// ============================================================================
-
-export const GetPhase12StatusSchema = z.object({})
-
-// ============================================================================
-// Phase 13 Retrieval Feedback
-// ============================================================================
-
-export const RateMemorySchema = z.object({
-  memory_id: z.string().min(1, 'memory_id is required'),
-  rating: z.number().int().min(1).max(5) as z.ZodType<1 | 2 | 3 | 4 | 5>,
-  query: z.string().min(1, 'query is required'),
-  was_used: z.boolean().optional().default(true),
-  feedback_text: z.string().optional(),
-  project_name: z.string().optional()
-})
-
-// ============================================================================
-// Phase 14 Knowledge Graph & Episodic Memory
-// ============================================================================
-
-export const SearchKnowledgeGraphSchema = z.object({
-  query: z.string().optional(),
-  node_type: z.enum(['project', 'technology', 'concept', 'person', 'file', 'decision', 'pattern', 'correction', 'date']).optional(),
-  start_node_id: z.string().optional(),
-  hops: z.number().int().min(1).max(10).optional().default(2),
-  limit: z.number().int().min(1).max(100).optional().default(20)
-})
-
-export const GetEpisodeSchema = z.object({
-  episode_id: z.string().optional(),
-  project_name: z.string().optional()
-})
-
-export const ListEpisodesSchema = z.object({
-  project_name: z.string().optional(),
-  limit: z.number().int().min(1).max(100).optional().default(10),
-  status: z.enum(['active', 'completed']).optional()
-})
-
-// ============================================================================
-// Phase 15 - Advanced Intelligence & Temporal Reasoning
-// ============================================================================
-
-export const GetDecisionTimelineSchema = z.object({
-  project_name: z.string().optional(),
-  topic: z.string().optional(),
-  time_range: z.string().optional(),
-  limit: z.number().int().min(1).max(200).optional().default(50)
-})
-
-export const AnalyzeDecisionEvolutionSchema = z.object({
-  topic: z.string().min(1, 'topic is required'),
-  project_name: z.string().optional(),
-  limit: z.number().int().min(1).max(100).optional().default(20)
-})
-
-export const DetectTrendsSchema = z.object({
-  project_name: z.string().optional(),
-  period_days: z.number().int().min(1).max(3650).optional().default(90),
-  min_occurrences: z.number().int().min(1).optional().default(2),
-  limit: z.number().int().min(1).max(100).optional().default(20)
-})
-
-export const WhatIfAnalysisSchema = z.object({
-  change: z.string().min(1, 'change description is required'),
-  project_name: z.string().optional(),
-  max_results: z.number().int().min(1).max(100).optional().default(20)
-})
-
-export const GetRecommendationsSchema = z.object({
-  query: z.string().min(1, 'query is required'),
-  project_name: z.string().optional(),
-  limit: z.number().int().min(1).max(50).optional().default(10)
-})
-
-export const FindCrossProjectPatternsSchema = z.object({
-  min_projects: z.number().int().min(1).max(50).optional().default(2),
-  limit: z.number().int().min(1).max(100).optional().default(20),
-  query: z.string().optional()
-})
-
-// ============================================================================
-// Phase 16 - Unified Brain Tool
-// ============================================================================
-
-export const BrainSchema = z.object({
-  message: z.string().min(1, 'message is required'),
-  project: z.string().optional()
-})
-
-// ============================================================================
-// Type exports for validated inputs
-// ============================================================================
-
-export type ValidatedGetProjectContext = z.infer<typeof GetProjectContextSchema>
-export type ValidatedListProjects = z.infer<typeof ListProjectsSchema>
-export type ValidatedCreateProject = z.infer<typeof CreateProjectSchema>
-export type ValidatedInitProject = z.infer<typeof InitProjectSchema>
-export type ValidatedRememberDecision = z.infer<typeof RememberDecisionSchema>
-export type ValidatedRecallSimilar = z.infer<typeof RecallSimilarSchema>
-export type ValidatedSmartContext = z.infer<typeof SmartContextSchema>
-export type ValidatedAutoRemember = z.infer<typeof AutoRememberSchema>
-export type ValidatedGetCodeStandards = z.infer<typeof GetCodeStandardsSchema>
-export type ValidatedUpdateProgress = z.infer<typeof UpdateProgressSchema>
-export type ValidatedRecognizePattern = z.infer<typeof RecognizePatternSchema>
-export type ValidatedRecordCorrection = z.infer<typeof RecordCorrectionSchema>
-export type ValidatedGetPatterns = z.infer<typeof GetPatternsSchema>
-export type ValidatedGetCorrections = z.infer<typeof GetCorrectionsSchema>
-export type ValidatedRateMemory = z.infer<typeof RateMemorySchema>
-export type ValidatedSearchKnowledgeGraph = z.infer<typeof SearchKnowledgeGraphSchema>
-export type ValidatedGetEpisode = z.infer<typeof GetEpisodeSchema>
-export type ValidatedListEpisodes = z.infer<typeof ListEpisodesSchema>
-
-// Phase 15
-export type ValidatedGetDecisionTimeline = z.infer<typeof GetDecisionTimelineSchema>
-export type ValidatedAnalyzeDecisionEvolution = z.infer<typeof AnalyzeDecisionEvolutionSchema>
-export type ValidatedDetectTrends = z.infer<typeof DetectTrendsSchema>
-export type ValidatedWhatIfAnalysis = z.infer<typeof WhatIfAnalysisSchema>
-export type ValidatedGetRecommendations = z.infer<typeof GetRecommendationsSchema>
-export type ValidatedFindCrossProjectPatterns = z.infer<typeof FindCrossProjectPatternsSchema>
-
-// Phase 16
-export type ValidatedBrain = z.infer<typeof BrainSchema>
+/**
+ * Zod Validation Schemas for Tool Handlers
+ * Provides input validation for all MCP tool handlers
+ */
+
+import { z } from 'zod'
+
+// ============================================================================
+// Project Context & Management
+// ============================================================================
+
+export const GetProjectContextSchema = z.object({
+  project_name: z.string().min(1, 'project_name is required'),
+  include_memories: z.boolean().optional().default(true),
+  memory_limit: z.number().int().min(1).max(100).optional().default(5)
+})
+
+export const ListProjectsSchema = z.object({
+  status_filter: z.enum(['active', 'archived', 'planning', 'all']).optional().default('active')
+})
+
+export const CreateProjectSchema = z.object({
+  project_name: z.string().min(1, 'project_name is required')
+    .regex(/^[a-z0-9-]+$/, 'project_name must be lowercase with hyphens only'),
+  description: z.string().optional(),
+  tech_stack: z.array(z.string()).optional().default([]),
+  status: z.enum(['planning', 'active', 'on-hold', 'completed']).optional().default('planning'),
+  tags: z.array(z.string()).optional().default([])
+})
+
+export const InitProjectSchema = z.object({
+  project_path: z.string().optional(),
+  project_name: z.string().optional(),
+  save_to_memory: z.boolean().optional().default(true)
+})
+
+// ============================================================================
+// Decision & Memory
+// ============================================================================
+
+export const RememberDecisionSchema = z.object({
+  project_name: z.string().min(1, 'project_name is required'),
+  context: z.string().min(1, 'context is required'),
+  decision: z.string().min(1, 'decision is required'),
+  reasoning: z.string().min(1, 'reasoning is required'),
+  alternatives_considered: z.string().optional(),
+  tags: z.array(z.string()).optional().default([])
+})
+
+export const RecallSimilarSchema = z.object({
+  query: z.string().min(1, 'query is required'),
+  project_filter: z.string().optional(),
+  limit: z.number().int().min(1).max(50).optional().default(5),
+  min_similarity: z.number().min(0).max(1).optional().default(0.3)
+})
+
+// ============================================================================
+// Smart Context & Automation
+// ============================================================================
+
+export const SmartContextSchema = z.object({
+  project_name: z.string().min(1, 'project_name is required'),
+  current_task: z.string().min(1, 'current_task is required'),
+  min_similarity: z.number().min(0).max(1).optional().default(0.3)
+})
+
+export const AutoRememberSchema = z.object({
+  project_name: z.string().min(1, 'project_name is required'),
+  text: z.string().min(1, 'text is required'),
+  confidence_threshold: z.number().min(0).max(1).optional().default(0.7)
+})
+
+// ============================================================================
+// Code Standards
+// ============================================================================
+
+export const GetCodeStandardsSchema = z.object({
+  project_name: z.string().min(1, 'project_name is required'),
+  language: z.string().optional()
+})
+
+// ============================================================================
+// Progress Tracking
+// ============================================================================
+
+export const UpdateProgressSchema = z.object({
+  project_name: z.string().min(1, 'project_name is required'),
+  completed_task: z.string().min(1, 'completed_task is required'),
+  next_steps: z.string().min(1, 'next_steps is required'),
+  notes: z.string().optional()
+})
+
+// ============================================================================
+// Patterns & Corrections
+// ============================================================================
+
+export const RecognizePatternSchema = z.object({
+  project_name: z.string().min(1, 'project_name is required'),
+  pattern_type: z.enum(['solution', 'anti-pattern', 'best-practice', 'common-issue']),
+  description: z.string().min(1, 'description is required'),
+  example: z.string().optional(),
+  confidence: z.number().min(0).max(1).optional().default(0.8),
+  context: z.string().optional()
+})
+
+export const RecordCorrectionSchema = z.object({
+  project_name: z.string().min(1, 'project_name is required'),
+  original: z.string().min(1, 'original is required'),
+  correction: z.string().min(1, 'correction is required'),
+  reasoning: z.string().min(1, 'reasoning is required'),
+  context: z.string().optional(),
+  confidence: z.number().min(0).max(1).optional().default(0.9)
+})
+
+export const GetPatternsSchema = z.object({
+  project_name: z.string().optional(),
+  pattern_type: z.enum(['solution', 'anti-pattern', 'best-practice', 'common-issue']).optional(),
+  limit: z.number().int().min(1).max(100).optional().default(10),
+  query: z.string().optional()
+})
+
+export const GetCorrectionsSchema = z.object({
+  project_name: z.string().optional(),
+  limit: z.number().int().min(1).max(100).optional().default(10),
+  query: z.string().optional()
+})
+
+// ============================================================================
+// Phase 12 Status
+// ============================================================================
+
+export const GetPhase12StatusSchema = z.object({})
+
+// ============================================================================
+// Phase 13 Retrieval Feedback
+// ============================================================================
+
+export const RateMemorySchema = z.object({
+  memory_id: z.string().min(1, 'memory_id is required'),
+  rating: z.number().int().min(1).max(5) as z.ZodType<1 | 2 | 3 | 4 | 5>,
+  query: z.string().min(1, 'query is required'),
+  was_used: z.boolean().optional().default(true),
+  feedback_text: z.string().optional(),
+  project_name: z.string().optional()
+})
+
+// ============================================================================
+// Phase 14 Knowledge Graph & Episodic Memory
+// ============================================================================
+
+export const SearchKnowledgeGraphSchema = z.object({
+  query: z.string().optional(),
+  node_type: z.enum(['project', 'technology', 'concept', 'person', 'file', 'decision', 'pattern', 'correction', 'date']).optional(),
+  start_node_id: z.string().optional(),
+  hops: z.number().int().min(1).max(10).optional().default(2),
+  limit: z.number().int().min(1).max(100).optional().default(20)
+})
+
+export const GetEpisodeSchema = z.object({
+  episode_id: z.string().optional(),
+  project_name: z.string().optional()
+})
+
+export const ListEpisodesSchema = z.object({
+  project_name: z.string().optional(),
+  limit: z.number().int().min(1).max(100).optional().default(10),
+  status: z.enum(['active', 'completed']).optional()
+})
+
+// ============================================================================
+// Phase 15 - Advanced Intelligence & Temporal Reasoning
+// ============================================================================
+
+export const GetDecisionTimelineSchema = z.object({
+  project_name: z.string().optional(),
+  topic: z.string().optional(),
+  time_range: z.string().optional(),
+  limit: z.number().int().min(1).max(200).optional().default(50)
+})
+
+export const AnalyzeDecisionEvolutionSchema = z.object({
+  topic: z.string().min(1, 'topic is required'),
+  project_name: z.string().optional(),
+  limit: z.number().int().min(1).max(100).optional().default(20)
+})
+
+export const DetectTrendsSchema = z.object({
+  project_name: z.string().optional(),
+  period_days: z.number().int().min(1).max(3650).optional().default(90),
+  min_occurrences: z.number().int().min(1).optional().default(2),
+  limit: z.number().int().min(1).max(100).optional().default(20)
+})
+
+export const WhatIfAnalysisSchema = z.object({
+  change: z.string().min(1, 'change description is required'),
+  project_name: z.string().optional(),
+  max_results: z.number().int().min(1).max(100).optional().default(20)
+})
+
+export const GetRecommendationsSchema = z.object({
+  query: z.string().min(1, 'query is required'),
+  project_name: z.string().optional(),
+  limit: z.number().int().min(1).max(50).optional().default(10)
+})
+
+export const FindCrossProjectPatternsSchema = z.object({
+  min_projects: z.number().int().min(1).max(50).optional().default(2),
+  limit: z.number().int().min(1).max(100).optional().default(20),
+  query: z.string().optional()
+})
+
+// ============================================================================
+// Phase 16 - Unified Brain Tool
+// ============================================================================
+
+export const BrainSchema = z.object({
+  message: z.string().min(1, 'message is required'),
+  project: z.string().optional()
+})
+
+// ============================================================================
+// Type exports for validated inputs
+// ============================================================================
+
+export type ValidatedGetProjectContext = z.infer<typeof GetProjectContextSchema>
+export type ValidatedListProjects = z.infer<typeof ListProjectsSchema>
+export type ValidatedCreateProject = z.infer<typeof CreateProjectSchema>
+export type ValidatedInitProject = z.infer<typeof InitProjectSchema>
+export type ValidatedRememberDecision = z.infer<typeof RememberDecisionSchema>
+export type ValidatedRecallSimilar = z.infer<typeof RecallSimilarSchema>
+export type ValidatedSmartContext = z.infer<typeof SmartContextSchema>
+export type ValidatedAutoRemember = z.infer<typeof AutoRememberSchema>
+export type ValidatedGetCodeStandards = z.infer<typeof GetCodeStandardsSchema>
+export type ValidatedUpdateProgress = z.infer<typeof UpdateProgressSchema>
+export type ValidatedRecognizePattern = z.infer<typeof RecognizePatternSchema>
+export type ValidatedRecordCorrection = z.infer<typeof RecordCorrectionSchema>
+export type ValidatedGetPatterns = z.infer<typeof GetPatternsSchema>
+export type ValidatedGetCorrections = z.infer<typeof GetCorrectionsSchema>
+export type ValidatedRateMemory = z.infer<typeof RateMemorySchema>
+export type ValidatedSearchKnowledgeGraph = z.infer<typeof SearchKnowledgeGraphSchema>
+export type ValidatedGetEpisode = z.infer<typeof GetEpisodeSchema>
+export type ValidatedListEpisodes = z.infer<typeof ListEpisodesSchema>
+
+// Phase 15
+export type ValidatedGetDecisionTimeline = z.infer<typeof GetDecisionTimelineSchema>
+export type ValidatedAnalyzeDecisionEvolution = z.infer<typeof AnalyzeDecisionEvolutionSchema>
+export type ValidatedDetectTrends = z.infer<typeof DetectTrendsSchema>
+export type ValidatedWhatIfAnalysis = z.infer<typeof WhatIfAnalysisSchema>
+export type ValidatedGetRecommendations = z.infer<typeof GetRecommendationsSchema>
+export type ValidatedFindCrossProjectPatterns = z.infer<typeof FindCrossProjectPatternsSchema>
+
+// Phase 16
+export type ValidatedBrain = z.infer<typeof BrainSchema>