claude-brain 0.15.2 → 0.17.0

package/src/context/types.ts

@@ -1,252 +1,252 @@
-/**
- * Context Management System Types
- * Phase 5: Intelligent context assembly for Claude Brain
- */
-
-/**
- * A single context layer with priority
- */
-export interface ContextLayer {
-  level: 'global' | 'project' | 'file' | 'function'
-  priority: number
-  content: Record<string, unknown>
-  metadata: ContextMetadata
-}
-
-/**
- * Metadata for context entries
- */
-export interface ContextMetadata {
-  source: string
-  timestamp: Date
-  version: number
-  tags: string[]
-  relevance?: number
-}
-
-/**
- * Global context shared across all projects
- */
-export interface GlobalContext {
-  standards: CodeStandards
-  patterns: DesignPatterns
-  bestPractices: BestPractices
-  commonPitfalls: string[]
-}
-
-/**
- * Project-specific context
- */
-export interface ProjectContext {
-  name: string
-  description: string
-  techStack: string[]
-  architecture: string
-  goals: string[]
-  constraints: string[]
-  currentPhase: string
-  progress: ProgressState
-  decisions: DecisionSummary[]
-  standards: CodeStandards
-  teamPreferences: Record<string, unknown>
-}
-
-/**
- * File-level context
- */
-export interface FileContext {
-  path: string
-  purpose: string
-  dependencies: string[]
-  relatedFiles: string[]
-  lastModified: Date
-}
-
-/**
- * Complete code standards definition
- */
-export interface CodeStandards {
-  languages: LanguageStandards[]
-  frameworks: FrameworkStandards[]
-  naming: NamingConventions
-  formatting: FormattingRules
-  testing: TestingStandards
-  documentation: DocumentationStandards
-  security: SecurityStandards
-}
-
-/**
- * Language-specific coding standards
- */
-export interface LanguageStandards {
-  language: string
-  version: string
-  style: string
-  linting: Record<string, unknown>
-  conventions: string[]
-  antiPatterns: string[]
-}
-
-/**
- * Framework-specific standards
- */
-export interface FrameworkStandards {
-  framework: string
-  version: string
-  patterns: string[]
-  bestPractices: string[]
-  conventions: string[]
-}
-
-/**
- * Project progress tracking
- */
-export interface ProgressState {
-  currentPhase: string
-  completionPercentage: number
-  completedTasks: TaskSummary[]
-  currentTasks: TaskSummary[]
-  nextSteps: string[]
-  blockers: Blocker[]
-  velocity: number
-}
-
-/**
- * Task summary for progress tracking
- */
-export interface TaskSummary {
-  id: string
-  title: string
-  status: string
-  completedAt?: Date
-}
-
-/**
- * Project blocker
- */
-export interface Blocker {
-  description: string
-  severity: 'low' | 'medium' | 'high' | 'critical'
-  since: Date
-  owner?: string
-}
-
-/**
- * Decision summary for context
- */
-export interface DecisionSummary {
-  id: string
-  title: string
-  decision: string
-  date: Date
-  impact: string
-}
-
-/**
- * Completely assembled context for a project
- */
-export interface AssembledContext {
-  project: ProjectContext
-  global: GlobalContext
-  memories: MemoryContext[]
-  progress: ProgressState
-  standards: CodeStandards
-  metadata: {
-    assembledAt: Date
-    tokenCount: number
-    sources: string[]
-  }
-}
-
-/**
- * Memory context with relevance score
- */
-export interface MemoryContext {
-  content: string
-  similarity: number
-  date: Date
-  tags: string[]
-}
-
-/**
- * Options for context assembly
- */
-export interface ContextOptions {
-  includeMemories: boolean
-  includeProgress: boolean
-  includeStandards: boolean
-  maxTokens?: number
-  relevanceThreshold?: number
-}
-
-/**
- * Design patterns and their usage
- */
-export interface DesignPatterns {
-  [patternName: string]: {
-    description: string
-    whenToUse: string[]
-    examples: string[]
-  }
-}
-
-/**
- * Best practices organized by category
- */
-export interface BestPractices {
-  [category: string]: string[]
-}
-
-/**
- * Naming conventions
- */
-export interface NamingConventions {
-  variables: string
-  functions: string
-  classes: string
-  constants: string
-  interfaces: string
-  types: string
-  files: string
-}
-
-/**
- * Formatting rules
- */
-export interface FormattingRules {
-  indentSize: number
-  indentStyle: 'spaces' | 'tabs'
-  maxLineLength: number
-  trailingCommas: boolean
-  semicolons: boolean
-  quotes: 'single' | 'double' | 'backtick'
-}
-
-/**
- * Testing standards
- */
-export interface TestingStandards {
-  framework: string
-  coverageTarget: number
-  testFilePattern: string
-  namingConvention: string
-}
-
-/**
- * Documentation standards
- */
-export interface DocumentationStandards {
-  jsdoc: boolean
-  readmeSections: string[]
-  apiDocs: boolean
-  inlineComments: boolean
-}
-
-/**
- * Security standards
- */
-export interface SecurityStandards {
-  auditCommands: string[]
-  sensitivePatterns: string[]
-  dependencyChecks: boolean
-}
+/**
+ * Context Management System Types
+ * Phase 5: Intelligent context assembly for Claude Brain
+ */
+
+/**
+ * A single context layer with priority
+ */
+export interface ContextLayer {
+  level: 'global' | 'project' | 'file' | 'function'
+  priority: number
+  content: Record<string, unknown>
+  metadata: ContextMetadata
+}
+
+/**
+ * Metadata for context entries
+ */
+export interface ContextMetadata {
+  source: string
+  timestamp: Date
+  version: number
+  tags: string[]
+  relevance?: number
+}
+
+/**
+ * Global context shared across all projects
+ */
+export interface GlobalContext {
+  standards: CodeStandards
+  patterns: DesignPatterns
+  bestPractices: BestPractices
+  commonPitfalls: string[]
+}
+
+/**
+ * Project-specific context
+ */
+export interface ProjectContext {
+  name: string
+  description: string
+  techStack: string[]
+  architecture: string
+  goals: string[]
+  constraints: string[]
+  currentPhase: string
+  progress: ProgressState
+  decisions: DecisionSummary[]
+  standards: CodeStandards
+  teamPreferences: Record<string, unknown>
+}
+
+/**
+ * File-level context
+ */
+export interface FileContext {
+  path: string
+  purpose: string
+  dependencies: string[]
+  relatedFiles: string[]
+  lastModified: Date
+}
+
+/**
+ * Complete code standards definition
+ */
+export interface CodeStandards {
+  languages: LanguageStandards[]
+  frameworks: FrameworkStandards[]
+  naming: NamingConventions
+  formatting: FormattingRules
+  testing: TestingStandards
+  documentation: DocumentationStandards
+  security: SecurityStandards
+}
+
+/**
+ * Language-specific coding standards
+ */
+export interface LanguageStandards {
+  language: string
+  version: string
+  style: string
+  linting: Record<string, unknown>
+  conventions: string[]
+  antiPatterns: string[]
+}
+
+/**
+ * Framework-specific standards
+ */
+export interface FrameworkStandards {
+  framework: string
+  version: string
+  patterns: string[]
+  bestPractices: string[]
+  conventions: string[]
+}
+
+/**
+ * Project progress tracking
+ */
+export interface ProgressState {
+  currentPhase: string
+  completionPercentage: number
+  completedTasks: TaskSummary[]
+  currentTasks: TaskSummary[]
+  nextSteps: string[]
+  blockers: Blocker[]
+  velocity: number
+}
+
+/**
+ * Task summary for progress tracking
+ */
+export interface TaskSummary {
+  id: string
+  title: string
+  status: string
+  completedAt?: Date
+}
+
+/**
+ * Project blocker
+ */
+export interface Blocker {
+  description: string
+  severity: 'low' | 'medium' | 'high' | 'critical'
+  since: Date
+  owner?: string
+}
+
+/**
+ * Decision summary for context
+ */
+export interface DecisionSummary {
+  id: string
+  title: string
+  decision: string
+  date: Date
+  impact: string
+}
+
+/**
+ * Completely assembled context for a project
+ */
+export interface AssembledContext {
+  project: ProjectContext
+  global: GlobalContext
+  memories: MemoryContext[]
+  progress: ProgressState
+  standards: CodeStandards
+  metadata: {
+    assembledAt: Date
+    tokenCount: number
+    sources: string[]
+  }
+}
+
+/**
+ * Memory context with relevance score
+ */
+export interface MemoryContext {
+  content: string
+  similarity: number
+  date: Date
+  tags: string[]
+}
+
+/**
+ * Options for context assembly
+ */
+export interface ContextOptions {
+  includeMemories: boolean
+  includeProgress: boolean
+  includeStandards: boolean
+  maxTokens?: number
+  relevanceThreshold?: number
+}
+
+/**
+ * Design patterns and their usage
+ */
+export interface DesignPatterns {
+  [patternName: string]: {
+    description: string
+    whenToUse: string[]
+    examples: string[]
+  }
+}
+
+/**
+ * Best practices organized by category
+ */
+export interface BestPractices {
+  [category: string]: string[]
+}
+
+/**
+ * Naming conventions
+ */
+export interface NamingConventions {
+  variables: string
+  functions: string
+  classes: string
+  constants: string
+  interfaces: string
+  types: string
+  files: string
+}
+
+/**
+ * Formatting rules
+ */
+export interface FormattingRules {
+  indentSize: number
+  indentStyle: 'spaces' | 'tabs'
+  maxLineLength: number
+  trailingCommas: boolean
+  semicolons: boolean
+  quotes: 'single' | 'double' | 'backtick'
+}
+
+/**
+ * Testing standards
+ */
+export interface TestingStandards {
+  framework: string
+  coverageTarget: number
+  testFilePattern: string
+  namingConvention: string
+}
+
+/**
+ * Documentation standards
+ */
+export interface DocumentationStandards {
+  jsdoc: boolean
+  readmeSections: string[]
+  apiDocs: boolean
+  inlineComments: boolean
+}
+
+/**
+ * Security standards
+ */
+export interface SecurityStandards {
+  auditCommands: string[]
+  sensitivePatterns: string[]
+  dependencyChecks: boolean
+}

package/src/context/validator.ts

@@ -1,58 +1,58 @@
-/**
- * Context Schema Validator
- * Validates context structures using Zod schemas
- */
-
-import { z } from 'zod'
-
-export const ProjectContextSchema = z.object({
-  name: z.string().min(1),
-  description: z.string(),
-  techStack: z.array(z.string()),
-  architecture: z.string(),
-  goals: z.array(z.string()),
-  constraints: z.array(z.string()),
-  currentPhase: z.string(),
-  progress: z.object({
-    currentPhase: z.string(),
-    completionPercentage: z.number().min(0).max(100),
-    completedTasks: z.array(z.any()),
-    currentTasks: z.array(z.any()),
-    nextSteps: z.array(z.string()),
-    blockers: z.array(z.any()),
-    velocity: z.number()
-  }),
-  decisions: z.array(z.any()),
-  standards: z.any(),
-  teamPreferences: z.record(z.any())
-})
-
-export const CodeStandardsSchema = z.object({
-  languages: z.array(z.any()),
-  frameworks: z.array(z.any()),
-  naming: z.any(),
-  formatting: z.any(),
-  testing: z.any(),
-  documentation: z.any(),
-  security: z.any()
-})
-
-export class ContextValidator {
-  static validateProjectContext(data: unknown): boolean {
-    try {
-      ProjectContextSchema.parse(data)
-      return true
-    } catch {
-      return false
-    }
-  }
-
-  static validateCodeStandards(data: unknown): boolean {
-    try {
-      CodeStandardsSchema.parse(data)
-      return true
-    } catch {
-      return false
-    }
-  }
-}
+/**
+ * Context Schema Validator
+ * Validates context structures using Zod schemas
+ */
+
+import { z } from 'zod'
+
+export const ProjectContextSchema = z.object({
+  name: z.string().min(1),
+  description: z.string(),
+  techStack: z.array(z.string()),
+  architecture: z.string(),
+  goals: z.array(z.string()),
+  constraints: z.array(z.string()),
+  currentPhase: z.string(),
+  progress: z.object({
+    currentPhase: z.string(),
+    completionPercentage: z.number().min(0).max(100),
+    completedTasks: z.array(z.any()),
+    currentTasks: z.array(z.any()),
+    nextSteps: z.array(z.string()),
+    blockers: z.array(z.any()),
+    velocity: z.number()
+  }),
+  decisions: z.array(z.any()),
+  standards: z.any(),
+  teamPreferences: z.record(z.any())
+})
+
+export const CodeStandardsSchema = z.object({
+  languages: z.array(z.any()),
+  frameworks: z.array(z.any()),
+  naming: z.any(),
+  formatting: z.any(),
+  testing: z.any(),
+  documentation: z.any(),
+  security: z.any()
+})
+
+export class ContextValidator {
+  static validateProjectContext(data: unknown): boolean {
+    try {
+      ProjectContextSchema.parse(data)
+      return true
+    } catch {
+      return false
+    }
+  }
+
+  static validateCodeStandards(data: unknown): boolean {
+    try {
+      CodeStandardsSchema.parse(data)
+      return true
+    } catch {
+      return false
+    }
+  }
+}