claude-brain 0.15.2 → 0.17.0

package/src/server/utils/validators.ts

@@ -1,210 +1,210 @@
-/**
- * Tool Validators
- * Utilities for validating tool arguments
- */
-
-import { McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js'
-import { z } from 'zod'
-
-/**
- * ToolValidator provides methods for validating tool inputs
- */
-export class ToolValidator {
-  /**
-   * Validate tool arguments against a Zod schema
-   * @param args - Arguments to validate
-   * @param schema - Zod schema to validate against
-   * @returns Parsed and validated arguments
-   * @throws McpError if validation fails
-   */
-  static validate<T>(args: unknown, schema: z.ZodSchema<T>): T {
-    try {
-      return schema.parse(args)
-    } catch (error) {
-      if (error instanceof z.ZodError) {
-        const issues = error.issues
-          .map(issue => `${issue.path.join('.')}: ${issue.message}`)
-          .join(', ')
-        throw new McpError(
-          ErrorCode.InvalidParams,
-          `Invalid parameters: ${issues}`
-        )
-      }
-      throw error
-    }
-  }
-
-  /**
-   * Validate and return a required string parameter
-   * @param value - Value to validate
-   * @param name - Parameter name for error messages
-   * @returns Validated string
-   * @throws McpError if validation fails
-   */
-  static requireString(value: unknown, name: string): string {
-    if (typeof value !== 'string') {
-      throw new McpError(
-        ErrorCode.InvalidParams,
-        `${name} is required and must be a string`
-      )
-    }
-    if (value.trim() === '') {
-      throw new McpError(
-        ErrorCode.InvalidParams,
-        `${name} cannot be empty`
-      )
-    }
-    return value
-  }
-
-  /**
-   * Get an optional string parameter with default
-   * @param value - Value to check
-   * @param defaultValue - Default value if not provided
-   * @returns String value or default
-   * @throws McpError if value is present but not a string
-   */
-  static optionalString(value: unknown, defaultValue: string = ''): string {
-    if (value === undefined || value === null) {
-      return defaultValue
-    }
-    if (typeof value !== 'string') {
-      throw new McpError(
-        ErrorCode.InvalidParams,
-        'Parameter must be a string'
-      )
-    }
-    return value
-  }
-
-  /**
-   * Validate and return a required number parameter
-   * @param value - Value to validate
-   * @param name - Parameter name for error messages
-   * @returns Validated number
-   * @throws McpError if validation fails
-   */
-  static requireNumber(value: unknown, name: string): number {
-    if (typeof value !== 'number' || isNaN(value)) {
-      throw new McpError(
-        ErrorCode.InvalidParams,
-        `${name} is required and must be a number`
-      )
-    }
-    return value
-  }
-
-  /**
-   * Get an optional number parameter with default
-   * @param value - Value to check
-   * @param defaultValue - Default value if not provided
-   * @returns Number value or default
-   * @throws McpError if value is present but not a number
-   */
-  static optionalNumber(value: unknown, defaultValue: number): number {
-    if (value === undefined || value === null) {
-      return defaultValue
-    }
-    if (typeof value !== 'number' || isNaN(value)) {
-      throw new McpError(
-        ErrorCode.InvalidParams,
-        'Parameter must be a number'
-      )
-    }
-    return value
-  }
-
-  /**
-   * Validate and return a required boolean parameter
-   * @param value - Value to validate
-   * @param name - Parameter name for error messages
-   * @returns Validated boolean
-   * @throws McpError if validation fails
-   */
-  static requireBoolean(value: unknown, name: string): boolean {
-    if (typeof value !== 'boolean') {
-      throw new McpError(
-        ErrorCode.InvalidParams,
-        `${name} is required and must be a boolean`
-      )
-    }
-    return value
-  }
-
-  /**
-   * Get an optional boolean parameter with default
-   * @param value - Value to check
-   * @param defaultValue - Default value if not provided
-   * @returns Boolean value or default
-   */
-  static optionalBoolean(value: unknown, defaultValue: boolean): boolean {
-    if (value === undefined || value === null) {
-      return defaultValue
-    }
-    if (typeof value !== 'boolean') {
-      throw new McpError(
-        ErrorCode.InvalidParams,
-        'Parameter must be a boolean'
-      )
-    }
-    return value
-  }
-
-  /**
-   * Validate and return a required array parameter
-   * @param value - Value to validate
-   * @param name - Parameter name for error messages
-   * @returns Validated array
-   * @throws McpError if validation fails
-   */
-  static requireArray<T>(value: unknown, name: string): T[] {
-    if (!Array.isArray(value)) {
-      throw new McpError(
-        ErrorCode.InvalidParams,
-        `${name} is required and must be an array`
-      )
-    }
-    return value as T[]
-  }
-
-  /**
-   * Get an optional array parameter with default
-   * @param value - Value to check
-   * @param defaultValue - Default value if not provided
-   * @returns Array value or default
-   */
-  static optionalArray<T>(value: unknown, defaultValue: T[] = []): T[] {
-    if (value === undefined || value === null) {
-      return defaultValue
-    }
-    if (!Array.isArray(value)) {
-      throw new McpError(
-        ErrorCode.InvalidParams,
-        'Parameter must be an array'
-      )
-    }
-    return value as T[]
-  }
-
-  /**
-   * Validate value is one of allowed enum values
-   * @param value - Value to validate
-   * @param allowed - Array of allowed values
-   * @param name - Parameter name for error messages
-   * @returns Validated value
-   * @throws McpError if validation fails
-   */
-  static requireEnum<T extends string>(
-    value: unknown,
-    allowed: readonly T[],
-    name: string
-  ): T {
-    if (typeof value !== 'string' || !allowed.includes(value as T)) {
-      throw new McpError(
-        ErrorCode.InvalidParams,
-        `${name} must be one of: ${allowed.join(', ')}`
-      )
-    }
-    return value as T
-  }
-}
+/**
+ * Tool Validators
+ * Utilities for validating tool arguments
+ */
+
+import { McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js'
+import { z } from 'zod'
+
+/**
+ * ToolValidator provides methods for validating tool inputs
+ */
+export class ToolValidator {
+  /**
+   * Validate tool arguments against a Zod schema
+   * @param args - Arguments to validate
+   * @param schema - Zod schema to validate against
+   * @returns Parsed and validated arguments
+   * @throws McpError if validation fails
+   */
+  static validate<T>(args: unknown, schema: z.ZodSchema<T>): T {
+    try {
+      return schema.parse(args)
+    } catch (error) {
+      if (error instanceof z.ZodError) {
+        const issues = error.issues
+          .map(issue => `${issue.path.join('.')}: ${issue.message}`)
+          .join(', ')
+        throw new McpError(
+          ErrorCode.InvalidParams,
+          `Invalid parameters: ${issues}`
+        )
+      }
+      throw error
+    }
+  }
+
+  /**
+   * Validate and return a required string parameter
+   * @param value - Value to validate
+   * @param name - Parameter name for error messages
+   * @returns Validated string
+   * @throws McpError if validation fails
+   */
+  static requireString(value: unknown, name: string): string {
+    if (typeof value !== 'string') {
+      throw new McpError(
+        ErrorCode.InvalidParams,
+        `${name} is required and must be a string`
+      )
+    }
+    if (value.trim() === '') {
+      throw new McpError(
+        ErrorCode.InvalidParams,
+        `${name} cannot be empty`
+      )
+    }
+    return value
+  }
+
+  /**
+   * Get an optional string parameter with default
+   * @param value - Value to check
+   * @param defaultValue - Default value if not provided
+   * @returns String value or default
+   * @throws McpError if value is present but not a string
+   */
+  static optionalString(value: unknown, defaultValue: string = ''): string {
+    if (value === undefined || value === null) {
+      return defaultValue
+    }
+    if (typeof value !== 'string') {
+      throw new McpError(
+        ErrorCode.InvalidParams,
+        'Parameter must be a string'
+      )
+    }
+    return value
+  }
+
+  /**
+   * Validate and return a required number parameter
+   * @param value - Value to validate
+   * @param name - Parameter name for error messages
+   * @returns Validated number
+   * @throws McpError if validation fails
+   */
+  static requireNumber(value: unknown, name: string): number {
+    if (typeof value !== 'number' || isNaN(value)) {
+      throw new McpError(
+        ErrorCode.InvalidParams,
+        `${name} is required and must be a number`
+      )
+    }
+    return value
+  }
+
+  /**
+   * Get an optional number parameter with default
+   * @param value - Value to check
+   * @param defaultValue - Default value if not provided
+   * @returns Number value or default
+   * @throws McpError if value is present but not a number
+   */
+  static optionalNumber(value: unknown, defaultValue: number): number {
+    if (value === undefined || value === null) {
+      return defaultValue
+    }
+    if (typeof value !== 'number' || isNaN(value)) {
+      throw new McpError(
+        ErrorCode.InvalidParams,
+        'Parameter must be a number'
+      )
+    }
+    return value
+  }
+
+  /**
+   * Validate and return a required boolean parameter
+   * @param value - Value to validate
+   * @param name - Parameter name for error messages
+   * @returns Validated boolean
+   * @throws McpError if validation fails
+   */
+  static requireBoolean(value: unknown, name: string): boolean {
+    if (typeof value !== 'boolean') {
+      throw new McpError(
+        ErrorCode.InvalidParams,
+        `${name} is required and must be a boolean`
+      )
+    }
+    return value
+  }
+
+  /**
+   * Get an optional boolean parameter with default
+   * @param value - Value to check
+   * @param defaultValue - Default value if not provided
+   * @returns Boolean value or default
+   */
+  static optionalBoolean(value: unknown, defaultValue: boolean): boolean {
+    if (value === undefined || value === null) {
+      return defaultValue
+    }
+    if (typeof value !== 'boolean') {
+      throw new McpError(
+        ErrorCode.InvalidParams,
+        'Parameter must be a boolean'
+      )
+    }
+    return value
+  }
+
+  /**
+   * Validate and return a required array parameter
+   * @param value - Value to validate
+   * @param name - Parameter name for error messages
+   * @returns Validated array
+   * @throws McpError if validation fails
+   */
+  static requireArray<T>(value: unknown, name: string): T[] {
+    if (!Array.isArray(value)) {
+      throw new McpError(
+        ErrorCode.InvalidParams,
+        `${name} is required and must be an array`
+      )
+    }
+    return value as T[]
+  }
+
+  /**
+   * Get an optional array parameter with default
+   * @param value - Value to check
+   * @param defaultValue - Default value if not provided
+   * @returns Array value or default
+   */
+  static optionalArray<T>(value: unknown, defaultValue: T[] = []): T[] {
+    if (value === undefined || value === null) {
+      return defaultValue
+    }
+    if (!Array.isArray(value)) {
+      throw new McpError(
+        ErrorCode.InvalidParams,
+        'Parameter must be an array'
+      )
+    }
+    return value as T[]
+  }
+
+  /**
+   * Validate value is one of allowed enum values
+   * @param value - Value to validate
+   * @param allowed - Array of allowed values
+   * @param name - Parameter name for error messages
+   * @returns Validated value
+   * @throws McpError if validation fails
+   */
+  static requireEnum<T extends string>(
+    value: unknown,
+    allowed: readonly T[],
+    name: string
+  ): T {
+    if (typeof value !== 'string' || !allowed.includes(value as T)) {
+      throw new McpError(
+        ErrorCode.InvalidParams,
+        `${name} must be one of: ${allowed.join(', ')}`
+      )
+    }
+    return value as T
+  }
+}

package/src/setup/index.ts

@@ -1,48 +1,48 @@
-import { createLogger } from '@/utils/logger'
-import { resolveHomePath } from '@/config/home'
-import { ensureHomeDirectory } from '@/cli/auto-setup'
-import { SetupWizard } from './wizard'
-import { renderBanner, typewrite, transition, box, errorText, theme } from '@/cli/ui/index.js'
-import { readFileSync } from 'node:fs'
-import { resolve, dirname } from 'node:path'
-import { fileURLToPath } from 'node:url'
-
-export * from './wizard'
-
-const __filename = fileURLToPath(import.meta.url)
-const __dirname = dirname(__filename)
-const PACKAGE_ROOT = resolve(__dirname, '..', '..')
-
-function getVersion(): string {
-  try {
-    const pkg = JSON.parse(readFileSync(resolve(PACKAGE_ROOT, 'package.json'), 'utf-8'))
-    return pkg.version || 'unknown'
-  } catch {
-    return 'unknown'
-  }
-}
-
-export async function runSetup() {
-  ensureHomeDirectory()
-
-  const version = getVersion()
-  console.log()
-  console.log(renderBanner(version))
-  console.log()
-
-  await typewrite(theme.dim('Welcome! Let\'s configure Claude Brain for your system.'))
-  await transition(400)
-
-  const logger = createLogger('info', resolveHomePath('./logs/setup.log'))
-
-  try {
-    const wizard = new SetupWizard(logger)
-    const answers = await wizard.run()
-    await wizard.applyConfiguration(answers)
-
-  } catch (error) {
-    console.log()
-    console.log(box(errorText(`Setup failed: ${error instanceof Error ? error.message : String(error)}`), 'Error'))
-    process.exit(1)
-  }
-}
+import { createLogger } from '@/utils/logger'
+import { resolveHomePath } from '@/config/home'
+import { ensureHomeDirectory } from '@/cli/auto-setup'
+import { SetupWizard } from './wizard'
+import { renderBanner, typewrite, transition, box, errorText, theme } from '@/cli/ui/index.js'
+import { readFileSync } from 'node:fs'
+import { resolve, dirname } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+export * from './wizard'
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = dirname(__filename)
+const PACKAGE_ROOT = resolve(__dirname, '..', '..')
+
+function getVersion(): string {
+  try {
+    const pkg = JSON.parse(readFileSync(resolve(PACKAGE_ROOT, 'package.json'), 'utf-8'))
+    return pkg.version || 'unknown'
+  } catch {
+    return 'unknown'
+  }
+}
+
+export async function runSetup() {
+  ensureHomeDirectory()
+
+  const version = getVersion()
+  console.log()
+  console.log(renderBanner(version))
+  console.log()
+
+  await typewrite(theme.dim('Welcome! Let\'s configure Claude Brain for your system.'))
+  await transition(400)
+
+  const logger = createLogger('info', resolveHomePath('./logs/setup.log'))
+
+  try {
+    const wizard = new SetupWizard(logger)
+    const answers = await wizard.run()
+    await wizard.applyConfiguration(answers)
+
+  } catch (error) {
+    console.log()
+    console.log(box(errorText(`Setup failed: ${error instanceof Error ? error.message : String(error)}`), 'Error'))
+    process.exit(1)
+  }
+}