claude-brain 0.15.2 → 0.17.0

package/src/tools/types.ts

@@ -1,412 +1,412 @@
-/**
- * Tool Types
- * TypeScript types for tool inputs and outputs
- */
-
-// ============================================================================
-// Input Types (derived from schemas)
-// ============================================================================
-
-/**
- * Input for get_project_context tool
- */
-export interface GetProjectContextInput {
-  /** Name of the project to get context for */
-  project_name: string
-  /** Whether to include similar past decisions from semantic memory */
-  include_memories?: boolean
-  /** Maximum number of relevant memories to include */
-  memory_limit?: number
-}
-
-/**
- * Input for update_progress tool
- */
-export interface UpdateProgressInput {
-  /** Name of the project */
-  project_name: string
-  /** Description of what was just completed */
-  completed_task: string
-  /** What should be done next */
-  next_steps: string
-  /** Optional additional notes or context */
-  notes?: string
-}
-
-/**
- * Input for remember_decision tool
- */
-export interface RememberDecisionInput {
-  /** Project this decision relates to */
-  project_name: string
-  /** What situation or problem led to this decision */
-  context: string
-  /** The decision that was made */
-  decision: string
-  /** Why this decision was made */
-  reasoning: string
-  /** Other options that were considered */
-  alternatives_considered?: string
-  /** Tags for categorizing this decision */
-  tags?: string[]
-}
-
-/**
- * Input for recall_similar tool
- */
-export interface RecallSimilarInput {
-  /** Description of current situation or question */
-  query: string
-  /** Optional: only search within specific project */
-  project_filter?: string
-  /** Maximum number of results to return */
-  limit?: number
-  /** Minimum similarity score (0-1) */
-  min_similarity?: number
-}
-
-/**
- * Input for get_code_standards tool
- */
-export interface GetCodeStandardsInput {
-  /** Name of the project */
-  project_name: string
-  /** Optional: filter standards by programming language */
-  language?: string
-}
-
-/**
- * Input for list_projects tool
- */
-export interface ListProjectsInput {
-  /** Filter projects by status */
-  status_filter?: 'active' | 'archived' | 'planning' | 'all'
-}
-
-// ============================================================================
-// Phase 12 Input Types
-// ============================================================================
-
-/**
- * Input for smart_context tool
- */
-export interface SmartContextInput {
-  /** Name of the project */
-  project_name: string
-  /** What you are currently working on or asking about */
-  current_task: string
-  /** Minimum similarity for memory recall (0-1) */
-  min_similarity?: number
-}
-
-/**
- * Input for auto_remember tool
- */
-export interface AutoRememberInput {
-  /** Project to associate the decision with */
-  project_name: string
-  /** Text to analyze for decisions */
-  text: string
-  /** Minimum confidence to auto-save (0-1) */
-  confidence_threshold?: number
-}
-
-/**
- * Input for get_phase12_status tool
- */
-export interface GetPhase12StatusInput {
-  // No inputs required
-}
-
-/**
- * Input for create_project tool
- */
-export interface CreateProjectInput {
-  /** Name of the project (lowercase with hyphens) */
-  project_name: string
-  /** Brief description of the project */
-  description?: string
-  /** Technologies used in the project */
-  tech_stack?: string[]
-  /** Initial project status */
-  status?: 'planning' | 'active' | 'on-hold' | 'completed'
-  /** Tags for categorizing the project */
-  tags?: string[]
-}
-
-  /**
-   * Input for init_project tool
-   */
-  export interface InitProjectInput {
-    /** Path to be project directory. Defaults to current working directory. */
-    project_path?: string
-    /** Override project name (otherwise detected from package.json or folder name) */
-    project_name?: string
-    /** Whether to save project context to semantic memory for future recall */
-    save_to_memory?: boolean
-  }
-
-  // ============================================================================
-  // Pattern & Correction Tool Input Types
-  // ============================================================================
-
-  /**
-   * Input for recognize_pattern tool
-   */
-  export interface RecognizePatternInput {
-    /** Project this pattern relates to */
-    project_name: string
-    /** Type of pattern */
-    pattern_type: 'solution' | 'anti-pattern' | 'best-practice' | 'common-issue'
-    /** Detailed description of the pattern */
-    description: string
-    /** Code example illustrating the pattern (optional) */
-    example?: string
-    /** Confidence in this pattern (0-1, default 0.8) */
-    confidence?: number
-    /** When this pattern was observed or applicable */
-    context?: string
-  }
-
-  /**
-   * Input for record_correction tool
-   */
-  export interface RecordCorrectionInput {
-    /** Project this correction relates to */
-    project_name: string
-    /** What was wrong or the mistake that was made */
-    original: string
-    /** What should have been done instead */
-    correction: string
-    /** Why the correction is better than the original approach */
-    reasoning: string
-    /** When this correction was identified or applicable */
-    context?: string
-    /** Confidence in this correction (0-1, default 0.9) */
-    confidence?: number
-  }
-
-  /**
-   * Input for get_patterns tool
-   */
-  export interface GetPatternsInput {
-    /** Project to retrieve patterns from (optional, returns all projects if not specified) */
-    project_name?: string
-    /** Filter by pattern type (optional) */
-    pattern_type?: 'solution' | 'anti-pattern' | 'best-practice' | 'common-issue'
-    /** Maximum number of patterns to return (default 10) */
-    limit?: number
-    /** Search query to find relevant patterns (optional, uses semantic search if not provided) */
-    query?: string
-  }
-
-  /**
-   * Input for get_corrections tool
-   */
-  export interface GetCorrectionsInput {
-    /** Project to retrieve corrections from (optional, returns all projects if not specified) */
-    project_name?: string
-    /** Maximum number of corrections to return (default 10) */
-    limit?: number
-    /** Search query to find relevant corrections (optional, uses semantic search if not provided) */
-    query?: string
-  }
-
-  /**
-   * Input for rate_memory tool
-   */
-  export interface RateMemoryInput {
-    /** ID of the memory to rate */
-    memory_id: string
-    /** Rating from 1 (not helpful) to 5 (very helpful) */
-    rating: 1 | 2 | 3 | 4 | 5
-    /** The original query that retrieved this memory */
-    query: string
-    /** Whether the memory was actually used */
-    was_used?: boolean
-    /** Optional feedback text */
-    feedback_text?: string
-    /** Project this feedback relates to */
-    project_name?: string
-  }
-
-  // ============================================================================
-  // Phase 15 - Advanced Intelligence Input Types
-  // ============================================================================
-
-  /**
-   * Input for get_decision_timeline tool
-   */
-  export interface GetDecisionTimelineInput {
-    /** Filter timeline by project */
-    project_name?: string
-    /** Filter timeline by topic via semantic search */
-    topic?: string
-    /** Natural language time range */
-    time_range?: string
-    /** Maximum number of entries */
-    limit?: number
-  }
-
-  /**
-   * Input for analyze_decision_evolution tool
-   */
-  export interface AnalyzeDecisionEvolutionInput {
-    /** The topic to analyze evolution for */
-    topic: string
-    /** Filter by project */
-    project_name?: string
-    /** Maximum decisions to analyze */
-    limit?: number
-  }
-
-  /**
-   * Input for detect_trends tool
-   */
-  export interface DetectTrendsInput {
-    /** Filter by project */
-    project_name?: string
-    /** Analysis period in days */
-    period_days?: number
-    /** Minimum occurrences to include */
-    min_occurrences?: number
-    /** Maximum trends to return */
-    limit?: number
-  }
-
-  /**
-   * Input for what_if_analysis tool
-   */
-  export interface WhatIfAnalysisInput {
-    /** The hypothetical change to analyze */
-    change: string
-    /** Filter by project */
-    project_name?: string
-    /** Maximum affected decisions to return */
-    max_results?: number
-  }
-
-  /**
-   * Input for get_recommendations tool
-   */
-  export interface GetRecommendationsInput {
-    /** What to get recommendations for */
-    query: string
-    /** Filter by project */
-    project_name?: string
-    /** Maximum recommendations */
-    limit?: number
-  }
-
-  /**
-   * Input for find_cross_project_patterns tool
-   */
-  export interface FindCrossProjectPatternsInput {
-    /** Minimum projects a pattern must appear in */
-    min_projects?: number
-    /** Maximum patterns to return */
-    limit?: number
-    /** Optional query to focus the search */
-    query?: string
-  }
-
-  // ============================================================================
-  // Phase 13 Retrieval Types
-  // ============================================================================
-// Output Types
-// ============================================================================
-
-/**
- * Standard MCP tool response format
- */
-export interface ToolResponse {
-  content: Array<{
-    type: 'text'
-    text: string
-  }>
-  /** Whether the tool execution resulted in an error */
-  isError?: boolean
-}
-
-/**
- * Project context returned by get_project_context
- */
-export interface ProjectContext {
-  name: string
-  description: string
-  status: string
-  standards: string[]
-  recentProgress: string[]
-  memories?: Array<{
-    id: string
-    content: string
-    similarity: number
-  }>
-}
-
-/**
- * Progress update result
- */
-export interface ProgressUpdateResult {
-  success: boolean
-  message: string
-  timestamp: string
-}
-
-/**
- * Decision storage result
- */
-export interface DecisionStorageResult {
-  success: boolean
-  memoryId: string
-  message: string
-}
-
-/**
- * Similar memory search result
- */
-export interface SimilarMemory {
-  id: string
-  project: string
-  context: string
-  decision: string
-  reasoning: string
-  similarity: number
-  timestamp: string
-}
-
-/**
- * Code standards response
- */
-export interface CodeStandards {
-  global: string[]
-  projectSpecific: string[]
-  language?: string
-}
-
-/**
- * Project list item
- */
-export interface ProjectListItem {
-  name: string
-  status: 'active' | 'archived' | 'planning'
-  description: string
-  lastUpdated: string
-}
-
-// ============================================================================
-// Union types for handler routing
-// ============================================================================
-
-export type ToolInput =
-  | GetProjectContextInput
-  | UpdateProgressInput
-  | RememberDecisionInput
-  | RecallSimilarInput
-  | GetCodeStandardsInput
-  | ListProjectsInput
-  | SmartContextInput
-  | AutoRememberInput
-  | GetPhase12StatusInput
-  | CreateProjectInput
-  | InitProjectInput
+/**
+ * Tool Types
+ * TypeScript types for tool inputs and outputs
+ */
+
+// ============================================================================
+// Input Types (derived from schemas)
+// ============================================================================
+
+/**
+ * Input for get_project_context tool
+ */
+export interface GetProjectContextInput {
+  /** Name of the project to get context for */
+  project_name: string
+  /** Whether to include similar past decisions from semantic memory */
+  include_memories?: boolean
+  /** Maximum number of relevant memories to include */
+  memory_limit?: number
+}
+
+/**
+ * Input for update_progress tool
+ */
+export interface UpdateProgressInput {
+  /** Name of the project */
+  project_name: string
+  /** Description of what was just completed */
+  completed_task: string
+  /** What should be done next */
+  next_steps: string
+  /** Optional additional notes or context */
+  notes?: string
+}
+
+/**
+ * Input for remember_decision tool
+ */
+export interface RememberDecisionInput {
+  /** Project this decision relates to */
+  project_name: string
+  /** What situation or problem led to this decision */
+  context: string
+  /** The decision that was made */
+  decision: string
+  /** Why this decision was made */
+  reasoning: string
+  /** Other options that were considered */
+  alternatives_considered?: string
+  /** Tags for categorizing this decision */
+  tags?: string[]
+}
+
+/**
+ * Input for recall_similar tool
+ */
+export interface RecallSimilarInput {
+  /** Description of current situation or question */
+  query: string
+  /** Optional: only search within specific project */
+  project_filter?: string
+  /** Maximum number of results to return */
+  limit?: number
+  /** Minimum similarity score (0-1) */
+  min_similarity?: number
+}
+
+/**
+ * Input for get_code_standards tool
+ */
+export interface GetCodeStandardsInput {
+  /** Name of the project */
+  project_name: string
+  /** Optional: filter standards by programming language */
+  language?: string
+}
+
+/**
+ * Input for list_projects tool
+ */
+export interface ListProjectsInput {
+  /** Filter projects by status */
+  status_filter?: 'active' | 'archived' | 'planning' | 'all'
+}
+
+// ============================================================================
+// Phase 12 Input Types
+// ============================================================================
+
+/**
+ * Input for smart_context tool
+ */
+export interface SmartContextInput {
+  /** Name of the project */
+  project_name: string
+  /** What you are currently working on or asking about */
+  current_task: string
+  /** Minimum similarity for memory recall (0-1) */
+  min_similarity?: number
+}
+
+/**
+ * Input for auto_remember tool
+ */
+export interface AutoRememberInput {
+  /** Project to associate the decision with */
+  project_name: string
+  /** Text to analyze for decisions */
+  text: string
+  /** Minimum confidence to auto-save (0-1) */
+  confidence_threshold?: number
+}
+
+/**
+ * Input for get_phase12_status tool
+ */
+export interface GetPhase12StatusInput {
+  // No inputs required
+}
+
+/**
+ * Input for create_project tool
+ */
+export interface CreateProjectInput {
+  /** Name of the project (lowercase with hyphens) */
+  project_name: string
+  /** Brief description of the project */
+  description?: string
+  /** Technologies used in the project */
+  tech_stack?: string[]
+  /** Initial project status */
+  status?: 'planning' | 'active' | 'on-hold' | 'completed'
+  /** Tags for categorizing the project */
+  tags?: string[]
+}
+
+  /**
+   * Input for init_project tool
+   */
+  export interface InitProjectInput {
+    /** Path to be project directory. Defaults to current working directory. */
+    project_path?: string
+    /** Override project name (otherwise detected from package.json or folder name) */
+    project_name?: string
+    /** Whether to save project context to semantic memory for future recall */
+    save_to_memory?: boolean
+  }
+
+  // ============================================================================
+  // Pattern & Correction Tool Input Types
+  // ============================================================================
+
+  /**
+   * Input for recognize_pattern tool
+   */
+  export interface RecognizePatternInput {
+    /** Project this pattern relates to */
+    project_name: string
+    /** Type of pattern */
+    pattern_type: 'solution' | 'anti-pattern' | 'best-practice' | 'common-issue'
+    /** Detailed description of the pattern */
+    description: string
+    /** Code example illustrating the pattern (optional) */
+    example?: string
+    /** Confidence in this pattern (0-1, default 0.8) */
+    confidence?: number
+    /** When this pattern was observed or applicable */
+    context?: string
+  }
+
+  /**
+   * Input for record_correction tool
+   */
+  export interface RecordCorrectionInput {
+    /** Project this correction relates to */
+    project_name: string
+    /** What was wrong or the mistake that was made */
+    original: string
+    /** What should have been done instead */
+    correction: string
+    /** Why the correction is better than the original approach */
+    reasoning: string
+    /** When this correction was identified or applicable */
+    context?: string
+    /** Confidence in this correction (0-1, default 0.9) */
+    confidence?: number
+  }
+
+  /**
+   * Input for get_patterns tool
+   */
+  export interface GetPatternsInput {
+    /** Project to retrieve patterns from (optional, returns all projects if not specified) */
+    project_name?: string
+    /** Filter by pattern type (optional) */
+    pattern_type?: 'solution' | 'anti-pattern' | 'best-practice' | 'common-issue'
+    /** Maximum number of patterns to return (default 10) */
+    limit?: number
+    /** Search query to find relevant patterns (optional, uses semantic search if not provided) */
+    query?: string
+  }
+
+  /**
+   * Input for get_corrections tool
+   */
+  export interface GetCorrectionsInput {
+    /** Project to retrieve corrections from (optional, returns all projects if not specified) */
+    project_name?: string
+    /** Maximum number of corrections to return (default 10) */
+    limit?: number
+    /** Search query to find relevant corrections (optional, uses semantic search if not provided) */
+    query?: string
+  }
+
+  /**
+   * Input for rate_memory tool
+   */
+  export interface RateMemoryInput {
+    /** ID of the memory to rate */
+    memory_id: string
+    /** Rating from 1 (not helpful) to 5 (very helpful) */
+    rating: 1 | 2 | 3 | 4 | 5
+    /** The original query that retrieved this memory */
+    query: string
+    /** Whether the memory was actually used */
+    was_used?: boolean
+    /** Optional feedback text */
+    feedback_text?: string
+    /** Project this feedback relates to */
+    project_name?: string
+  }
+
+  // ============================================================================
+  // Phase 15 - Advanced Intelligence Input Types
+  // ============================================================================
+
+  /**
+   * Input for get_decision_timeline tool
+   */
+  export interface GetDecisionTimelineInput {
+    /** Filter timeline by project */
+    project_name?: string
+    /** Filter timeline by topic via semantic search */
+    topic?: string
+    /** Natural language time range */
+    time_range?: string
+    /** Maximum number of entries */
+    limit?: number
+  }
+
+  /**
+   * Input for analyze_decision_evolution tool
+   */
+  export interface AnalyzeDecisionEvolutionInput {
+    /** The topic to analyze evolution for */
+    topic: string
+    /** Filter by project */
+    project_name?: string
+    /** Maximum decisions to analyze */
+    limit?: number
+  }
+
+  /**
+   * Input for detect_trends tool
+   */
+  export interface DetectTrendsInput {
+    /** Filter by project */
+    project_name?: string
+    /** Analysis period in days */
+    period_days?: number
+    /** Minimum occurrences to include */
+    min_occurrences?: number
+    /** Maximum trends to return */
+    limit?: number
+  }
+
+  /**
+   * Input for what_if_analysis tool
+   */
+  export interface WhatIfAnalysisInput {
+    /** The hypothetical change to analyze */
+    change: string
+    /** Filter by project */
+    project_name?: string
+    /** Maximum affected decisions to return */
+    max_results?: number
+  }
+
+  /**
+   * Input for get_recommendations tool
+   */
+  export interface GetRecommendationsInput {
+    /** What to get recommendations for */
+    query: string
+    /** Filter by project */
+    project_name?: string
+    /** Maximum recommendations */
+    limit?: number
+  }
+
+  /**
+   * Input for find_cross_project_patterns tool
+   */
+  export interface FindCrossProjectPatternsInput {
+    /** Minimum projects a pattern must appear in */
+    min_projects?: number
+    /** Maximum patterns to return */
+    limit?: number
+    /** Optional query to focus the search */
+    query?: string
+  }
+
+  // ============================================================================
+  // Phase 13 Retrieval Types
+  // ============================================================================
+// Output Types
+// ============================================================================
+
+/**
+ * Standard MCP tool response format
+ */
+export interface ToolResponse {
+  content: Array<{
+    type: 'text'
+    text: string
+  }>
+  /** Whether the tool execution resulted in an error */
+  isError?: boolean
+}
+
+/**
+ * Project context returned by get_project_context
+ */
+export interface ProjectContext {
+  name: string
+  description: string
+  status: string
+  standards: string[]
+  recentProgress: string[]
+  memories?: Array<{
+    id: string
+    content: string
+    similarity: number
+  }>
+}
+
+/**
+ * Progress update result
+ */
+export interface ProgressUpdateResult {
+  success: boolean
+  message: string
+  timestamp: string
+}
+
+/**
+ * Decision storage result
+ */
+export interface DecisionStorageResult {
+  success: boolean
+  memoryId: string
+  message: string
+}
+
+/**
+ * Similar memory search result
+ */
+export interface SimilarMemory {
+  id: string
+  project: string
+  context: string
+  decision: string
+  reasoning: string
+  similarity: number
+  timestamp: string
+}
+
+/**
+ * Code standards response
+ */
+export interface CodeStandards {
+  global: string[]
+  projectSpecific: string[]
+  language?: string
+}
+
+/**
+ * Project list item
+ */
+export interface ProjectListItem {
+  name: string
+  status: 'active' | 'archived' | 'planning'
+  description: string
+  lastUpdated: string
+}
+
+// ============================================================================
+// Union types for handler routing
+// ============================================================================
+
+export type ToolInput =
+  | GetProjectContextInput
+  | UpdateProgressInput
+  | RememberDecisionInput
+  | RecallSimilarInput
+  | GetCodeStandardsInput
+  | ListProjectsInput
+  | SmartContextInput
+  | AutoRememberInput
+  | GetPhase12StatusInput
+  | CreateProjectInput
+  | InitProjectInput