claude-brain 0.30.2 → 0.30.3

package/src/server/schemas/api-schemas.ts

@@ -0,0 +1,202 @@
+/**
+ * Zod schemas for HTTP API input validation
+ * Phase 1: Security Hardening — validates all input-accepting endpoints
+ */
+
+import { z } from 'zod'
+
+// ─── Shared Enums & Primitives ────────────────────────────
+
+const MemoryCategoryEnum = z.enum([
+  'decision',
+  'pattern',
+  'correction',
+  'insight',
+  'preference',
+])
+
+// ─── Search / Recall Schemas ──────────────────────────────
+
+export const SearchQuerySchema = z.object({
+  query: z.string().min(1).max(2000),
+  project: z.string().max(200).optional(),
+  category: MemoryCategoryEnum.optional(),
+  limit: z.coerce.number().int().min(1).max(100).default(20),
+})
+
+export const RecallQuerySchema = z.object({
+  query: z.string().max(2000).optional().default(''),
+  q: z.string().max(2000).optional(),
+}).transform((data) => ({
+  query: data.query || data.q || '',
+}))
+
+export const ContextQuerySchema = z.object({
+  query: z.string().max(2000).optional().default(''),
+  q: z.string().max(2000).optional(),
+  type: z.string().optional().default(''),
+  cwd: z.string().optional().default(''),
+  limit: z.coerce.number().int().min(1).max(100).default(5),
+}).transform((data) => ({
+  query: data.query || data.q || '',
+  type: data.type,
+  cwd: data.cwd,
+  limit: data.limit,
+}))
+
+// ─── Memory CRUD Schemas ──────────────────────────────────
+
+export const StoreMemorySchema = z.object({
+  content: z.string().min(1).max(50000),
+  project: z.string().min(1).max(200),
+  category: MemoryCategoryEnum,
+  reasoning: z.string().max(10000).optional(),
+  context: z.string().max(10000).optional(),
+  tags: z.array(z.string().max(100)).max(20).optional(),
+  file_paths: z.array(z.string().max(500)).max(50).optional(),
+  symbols: z.array(z.string().max(200)).max(50).optional(),
+  confidence: z.number().min(0).max(1).optional(),
+  source: z.string().max(200).optional(),
+})
+
+export const UpdateMemorySchema = z.object({
+  content: z.string().min(1).max(50000).optional(),
+  project: z.string().min(1).max(200).optional(),
+  category: MemoryCategoryEnum.optional(),
+  reasoning: z.string().max(10000).optional(),
+  context: z.string().max(10000).optional(),
+  tags: z.array(z.string().max(100)).max(20).optional(),
+  file_paths: z.array(z.string().max(500)).max(50).optional(),
+  symbols: z.array(z.string().max(200)).max(50).optional(),
+  confidence: z.number().min(0).max(1).optional(),
+  source: z.string().max(200).optional(),
+})
+
+export const IdParamSchema = z.object({
+  id: z.string().uuid(),
+})
+
+// ─── Knowledge Ingest Schemas ─────────────────────────────
+
+const KnowledgeTypeEnum = z.enum(['decision', 'pattern', 'correction', 'progress'])
+
+const IngestKnowledgeItemSchema = z.object({
+  type: KnowledgeTypeEnum,
+  content: z.string().min(1).max(50000),
+  project: z.string().max(200).optional(),
+  confidence: z.number().min(0).max(1),
+  metadata: z.record(z.string(), z.unknown()).optional().default({}),
+  technologies: z.array(z.string().max(100)).optional().default([]),
+  source: z.literal('hook-passive').optional().default('hook-passive'),
+  timestamp: z.string().optional(),
+})
+
+export const IngestKnowledgeSchema = z.object({
+  knowledge: z.array(IngestKnowledgeItemSchema).max(100).default([]),
+  sessionId: z.string().max(200).optional(),
+})
+
+export const SessionEndSchema = z.object({
+  sessionId: z.string().min(1).max(200),
+})
+
+// ─── Project Schemas ──────────────────────────────────────
+
+export const CreateProjectSchema = z.object({
+  name: z.string().min(1).max(200),
+  description: z.string().max(5000).optional(),
+  techStack: z.array(z.string().max(100)).optional(),
+  status: z.string().max(100).optional(),
+  tags: z.array(z.string().max(100)).optional(),
+})
+
+// ─── Brain Endpoint Schemas ───────────────────────────────
+
+export const RememberDecisionSchema = z.object({
+  project_name: z.string().min(1).max(200),
+  decision: z.string().min(1).max(50000),
+  context: z.string().max(10000).optional().default(''),
+  reasoning: z.string().max(10000).optional().default(''),
+  tags: z.array(z.string().max(100)).max(20).optional(),
+})
+
+export const RecognizePatternSchema = z.object({
+  project_name: z.string().min(1).max(200),
+  description: z.string().min(1).max(50000),
+  pattern_type: z.enum(['solution', 'anti-pattern', 'best-practice', 'common-issue']),
+  context: z.string().max(10000).optional(),
+  example: z.string().max(10000).optional(),
+  confidence: z.number().min(0).max(1).optional().default(0.8),
+})
+
+export const RecordCorrectionSchema = z.object({
+  project_name: z.string().min(1).max(200),
+  original: z.string().min(1).max(50000),
+  correction: z.string().min(1).max(50000),
+  reasoning: z.string().max(10000).optional().default(''),
+  context: z.string().max(10000).optional(),
+  confidence: z.number().min(0).max(1).optional().default(0.9),
+})
+
+export const UpdateProgressSchema = z.object({
+  project_name: z.string().min(1).max(200),
+  completed_task: z.string().max(5000).optional(),
+  next_steps: z.string().max(5000).optional(),
+  notes: z.string().max(10000).optional(),
+})
+
+// ─── Code Intelligence Schemas ────────────────────────────
+
+export const CodeSearchSchema = z.object({
+  query: z.string().min(1).max(2000),
+  q: z.string().max(2000).optional(),
+  project: z.string().min(1).max(200),
+  limit: z.coerce.number().int().min(1).max(100).default(20),
+}).transform((data) => ({
+  query: data.query || data.q || '',
+  project: data.project,
+  limit: data.limit,
+}))
+
+export const CodeIndexSchema = z.object({
+  projectPath: z.string().min(1).max(500),
+  projectName: z.string().min(1).max(200),
+  force: z.boolean().optional(),
+})
+
+export const CodeReindexSchema = z.object({
+  filePath: z.string().min(1).max(500),
+  project: z.string().min(1).max(200),
+})
+
+// ─── MCP Proxy Schemas ───────────────────────────────────
+
+export const McpCallToolSchema = z.object({
+  name: z.string().min(1).max(200),
+  args: z.record(z.string(), z.unknown()).optional().default({}),
+})
+
+// ─── Query-only schemas for GET endpoints ─────────────────
+
+export const ProjectQuerySchema = z.object({
+  project: z.string().min(1).max(200),
+})
+
+export const FileQuerySchema = z.object({
+  file: z.string().min(1).max(500),
+  project: z.string().max(200).optional().default(''),
+})
+
+export const CodeDepsQuerySchema = z.object({
+  file: z.string().min(1).max(500),
+  project: z.string().min(1).max(200),
+})
+
+export const ModelsFeedbackQuerySchema = z.object({
+  task: z.string().max(200).optional(),
+})
+
+export const ModelsDisagreementsQuerySchema = z.object({
+  task: z.string().max(200).optional().default('intent'),
+  limit: z.coerce.number().int().min(1).max(500).default(50),
+})