claude-brain 0.15.2 → 0.16.0

package/src/retrieval/query/expander.ts

@@ -1,198 +1,198 @@
-/**
- * Query Expander
- * Expands queries with synonyms and related terms
- */
-
-import type { ExpandedQuery } from '../types'
-
-/** Domain-specific synonym mappings */
-const SYNONYMS: Record<string, string[]> = {
-  // Database terms
-  database: ['db', 'datastore', 'storage', 'persistence'],
-  sql: ['query', 'relational', 'postgresql', 'mysql', 'sqlite'],
-  nosql: ['mongodb', 'dynamodb', 'document store', 'key-value'],
-
-  // API terms
-  api: ['endpoint', 'rest', 'graphql', 'interface', 'service'],
-  authentication: ['auth', 'login', 'signin', 'identity', 'credential'],
-  authorization: ['permission', 'access control', 'rbac', 'acl'],
-
-  // Architecture terms
-  architecture: ['design', 'structure', 'pattern', 'system design'],
-  microservice: ['service', 'distributed', 'soa'],
-  monolith: ['monolithic', 'single service'],
-
-  // Frontend terms
-  frontend: ['ui', 'client', 'web', 'interface', 'view'],
-  component: ['widget', 'element', 'module'],
-  state: ['store', 'data', 'context', 'redux'],
-
-  // Backend terms
-  backend: ['server', 'service', 'api', 'serverside'],
-  server: ['backend', 'service', 'host'],
-
-  // Testing terms
-  test: ['testing', 'spec', 'unit test', 'integration test'],
-  mock: ['stub', 'fake', 'spy', 'double'],
-
-  // Error terms
-  error: ['exception', 'failure', 'bug', 'issue', 'problem'],
-  fix: ['resolve', 'repair', 'patch', 'correct', 'solve'],
-
-  // Performance terms
-  performance: ['speed', 'optimization', 'efficiency', 'latency'],
-  cache: ['caching', 'memoization', 'store', 'buffer'],
-
-  // Security terms
-  security: ['secure', 'protection', 'safety', 'vulnerability'],
-  encrypt: ['encryption', 'cipher', 'hash', 'secure'],
-
-  // Configuration terms
-  config: ['configuration', 'settings', 'options', 'preferences'],
-  environment: ['env', 'environment variables', 'config'],
-
-  // Data terms
-  data: ['information', 'payload', 'content', 'record'],
-  schema: ['model', 'structure', 'type', 'definition'],
-
-  // Process terms
-  deploy: ['deployment', 'release', 'ship', 'publish'],
-  build: ['compile', 'bundle', 'package'],
-
-  // Common verbs
-  create: ['add', 'new', 'generate', 'make'],
-  update: ['modify', 'change', 'edit', 'patch'],
-  delete: ['remove', 'destroy', 'drop'],
-  get: ['fetch', 'retrieve', 'read', 'query'],
-
-  // Framework terms
-  react: ['reactjs', 'react.js', 'component'],
-  vue: ['vuejs', 'vue.js'],
-  angular: ['angularjs', 'ng'],
-  node: ['nodejs', 'node.js'],
-  typescript: ['ts', 'typed javascript'],
-  javascript: ['js', 'ecmascript']
-}
-
-/** Concept expansions (broader than synonyms) */
-const CONCEPT_EXPANSIONS: Record<string, string[]> = {
-  database: ['query', 'migration', 'schema', 'orm', 'connection'],
-  authentication: ['jwt', 'oauth', 'session', 'token', 'password'],
-  frontend: ['react', 'vue', 'angular', 'css', 'html'],
-  backend: ['express', 'fastify', 'nest', 'koa'],
-  testing: ['jest', 'vitest', 'mocha', 'cypress', 'playwright'],
-  deployment: ['docker', 'kubernetes', 'ci/cd', 'vercel', 'aws']
-}
-
-export interface QueryExpanderConfig {
-  /** Use synonyms */
-  useSynonyms?: boolean
-  /** Use concept expansions */
-  useConceptExpansions?: boolean
-  /** Maximum expansion terms */
-  maxExpansions?: number
-  /** Weight for original query (0-1) */
-  originalWeight?: number
-}
-
-const DEFAULT_CONFIG: QueryExpanderConfig = {
-  useSynonyms: true,
-  useConceptExpansions: false, // Off by default to avoid over-expansion
-  maxExpansions: 5,
-  originalWeight: 0.8
-}
-
-/**
- * Expand a query with synonyms and related terms
- */
-export function expandQuery(
-  query: string,
-  config: QueryExpanderConfig = {}
-): ExpandedQuery {
-  const opts = { ...DEFAULT_CONFIG, ...config }
-
-  // Tokenize query
-  const words = query.toLowerCase().split(/\s+/)
-  const expansions: string[] = []
-
-  for (const word of words) {
-    // Check synonyms
-    if (opts.useSynonyms && SYNONYMS[word]) {
-      expansions.push(...SYNONYMS[word].slice(0, 3))
-    }
-
-    // Check concept expansions
-    if (opts.useConceptExpansions && CONCEPT_EXPANSIONS[word]) {
-      expansions.push(...CONCEPT_EXPANSIONS[word].slice(0, 2))
-    }
-  }
-
-  // Deduplicate and limit expansions
-  const uniqueExpansions = [...new Set(expansions)]
-    .filter(term => !query.toLowerCase().includes(term))
-    .slice(0, opts.maxExpansions!)
-
-  // Create combined query
-  const combined = uniqueExpansions.length > 0
-    ? `${query} ${uniqueExpansions.join(' ')}`
-    : query
-
-  return {
-    original: query,
-    expansions: uniqueExpansions,
-    combined,
-    originalWeight: opts.originalWeight!
-  }
-}
-
-/**
- * Get synonyms for a term
- */
-export function getSynonyms(term: string): string[] {
-  const normalized = term.toLowerCase()
-  return SYNONYMS[normalized] || []
-}
-
-/**
- * Get concept expansions for a term
- */
-export function getConceptExpansions(term: string): string[] {
-  const normalized = term.toLowerCase()
-  return CONCEPT_EXPANSIONS[normalized] || []
-}
-
-/**
- * Add custom synonym mapping
- */
-export function addSynonym(term: string, synonyms: string[]): void {
-  const normalized = term.toLowerCase()
-  SYNONYMS[normalized] = [...(SYNONYMS[normalized] || []), ...synonyms]
-}
-
-/**
- * Add custom concept expansion
- */
-export function addConceptExpansion(term: string, expansions: string[]): void {
-  const normalized = term.toLowerCase()
-  CONCEPT_EXPANSIONS[normalized] = [...(CONCEPT_EXPANSIONS[normalized] || []), ...expansions]
-}
-
-export class QueryExpander {
-  private config: QueryExpanderConfig
-
-  constructor(config: QueryExpanderConfig = {}) {
-    this.config = { ...DEFAULT_CONFIG, ...config }
-  }
-
-  expand(query: string): ExpandedQuery {
-    return expandQuery(query, this.config)
-  }
-
-  getSynonyms(term: string): string[] {
-    return getSynonyms(term)
-  }
-
-  getConceptExpansions(term: string): string[] {
-    return getConceptExpansions(term)
-  }
-}
+/**
+ * Query Expander
+ * Expands queries with synonyms and related terms
+ */
+
+import type { ExpandedQuery } from '../types'
+
+/** Domain-specific synonym mappings */
+const SYNONYMS: Record<string, string[]> = {
+  // Database terms
+  database: ['db', 'datastore', 'storage', 'persistence'],
+  sql: ['query', 'relational', 'postgresql', 'mysql', 'sqlite'],
+  nosql: ['mongodb', 'dynamodb', 'document store', 'key-value'],
+
+  // API terms
+  api: ['endpoint', 'rest', 'graphql', 'interface', 'service'],
+  authentication: ['auth', 'login', 'signin', 'identity', 'credential'],
+  authorization: ['permission', 'access control', 'rbac', 'acl'],
+
+  // Architecture terms
+  architecture: ['design', 'structure', 'pattern', 'system design'],
+  microservice: ['service', 'distributed', 'soa'],
+  monolith: ['monolithic', 'single service'],
+
+  // Frontend terms
+  frontend: ['ui', 'client', 'web', 'interface', 'view'],
+  component: ['widget', 'element', 'module'],
+  state: ['store', 'data', 'context', 'redux'],
+
+  // Backend terms
+  backend: ['server', 'service', 'api', 'serverside'],
+  server: ['backend', 'service', 'host'],
+
+  // Testing terms
+  test: ['testing', 'spec', 'unit test', 'integration test'],
+  mock: ['stub', 'fake', 'spy', 'double'],
+
+  // Error terms
+  error: ['exception', 'failure', 'bug', 'issue', 'problem'],
+  fix: ['resolve', 'repair', 'patch', 'correct', 'solve'],
+
+  // Performance terms
+  performance: ['speed', 'optimization', 'efficiency', 'latency'],
+  cache: ['caching', 'memoization', 'store', 'buffer'],
+
+  // Security terms
+  security: ['secure', 'protection', 'safety', 'vulnerability'],
+  encrypt: ['encryption', 'cipher', 'hash', 'secure'],
+
+  // Configuration terms
+  config: ['configuration', 'settings', 'options', 'preferences'],
+  environment: ['env', 'environment variables', 'config'],
+
+  // Data terms
+  data: ['information', 'payload', 'content', 'record'],
+  schema: ['model', 'structure', 'type', 'definition'],
+
+  // Process terms
+  deploy: ['deployment', 'release', 'ship', 'publish'],
+  build: ['compile', 'bundle', 'package'],
+
+  // Common verbs
+  create: ['add', 'new', 'generate', 'make'],
+  update: ['modify', 'change', 'edit', 'patch'],
+  delete: ['remove', 'destroy', 'drop'],
+  get: ['fetch', 'retrieve', 'read', 'query'],
+
+  // Framework terms
+  react: ['reactjs', 'react.js', 'component'],
+  vue: ['vuejs', 'vue.js'],
+  angular: ['angularjs', 'ng'],
+  node: ['nodejs', 'node.js'],
+  typescript: ['ts', 'typed javascript'],
+  javascript: ['js', 'ecmascript']
+}
+
+/** Concept expansions (broader than synonyms) */
+const CONCEPT_EXPANSIONS: Record<string, string[]> = {
+  database: ['query', 'migration', 'schema', 'orm', 'connection'],
+  authentication: ['jwt', 'oauth', 'session', 'token', 'password'],
+  frontend: ['react', 'vue', 'angular', 'css', 'html'],
+  backend: ['express', 'fastify', 'nest', 'koa'],
+  testing: ['jest', 'vitest', 'mocha', 'cypress', 'playwright'],
+  deployment: ['docker', 'kubernetes', 'ci/cd', 'vercel', 'aws']
+}
+
+export interface QueryExpanderConfig {
+  /** Use synonyms */
+  useSynonyms?: boolean
+  /** Use concept expansions */
+  useConceptExpansions?: boolean
+  /** Maximum expansion terms */
+  maxExpansions?: number
+  /** Weight for original query (0-1) */
+  originalWeight?: number
+}
+
+const DEFAULT_CONFIG: QueryExpanderConfig = {
+  useSynonyms: true,
+  useConceptExpansions: false, // Off by default to avoid over-expansion
+  maxExpansions: 5,
+  originalWeight: 0.8
+}
+
+/**
+ * Expand a query with synonyms and related terms
+ */
+export function expandQuery(
+  query: string,
+  config: QueryExpanderConfig = {}
+): ExpandedQuery {
+  const opts = { ...DEFAULT_CONFIG, ...config }
+
+  // Tokenize query
+  const words = query.toLowerCase().split(/\s+/)
+  const expansions: string[] = []
+
+  for (const word of words) {
+    // Check synonyms
+    if (opts.useSynonyms && SYNONYMS[word]) {
+      expansions.push(...SYNONYMS[word].slice(0, 3))
+    }
+
+    // Check concept expansions
+    if (opts.useConceptExpansions && CONCEPT_EXPANSIONS[word]) {
+      expansions.push(...CONCEPT_EXPANSIONS[word].slice(0, 2))
+    }
+  }
+
+  // Deduplicate and limit expansions
+  const uniqueExpansions = [...new Set(expansions)]
+    .filter(term => !query.toLowerCase().includes(term))
+    .slice(0, opts.maxExpansions!)
+
+  // Create combined query
+  const combined = uniqueExpansions.length > 0
+    ? `${query} ${uniqueExpansions.join(' ')}`
+    : query
+
+  return {
+    original: query,
+    expansions: uniqueExpansions,
+    combined,
+    originalWeight: opts.originalWeight!
+  }
+}
+
+/**
+ * Get synonyms for a term
+ */
+export function getSynonyms(term: string): string[] {
+  const normalized = term.toLowerCase()
+  return SYNONYMS[normalized] || []
+}
+
+/**
+ * Get concept expansions for a term
+ */
+export function getConceptExpansions(term: string): string[] {
+  const normalized = term.toLowerCase()
+  return CONCEPT_EXPANSIONS[normalized] || []
+}
+
+/**
+ * Add custom synonym mapping
+ */
+export function addSynonym(term: string, synonyms: string[]): void {
+  const normalized = term.toLowerCase()
+  SYNONYMS[normalized] = [...(SYNONYMS[normalized] || []), ...synonyms]
+}
+
+/**
+ * Add custom concept expansion
+ */
+export function addConceptExpansion(term: string, expansions: string[]): void {
+  const normalized = term.toLowerCase()
+  CONCEPT_EXPANSIONS[normalized] = [...(CONCEPT_EXPANSIONS[normalized] || []), ...expansions]
+}
+
+export class QueryExpander {
+  private config: QueryExpanderConfig
+
+  constructor(config: QueryExpanderConfig = {}) {
+    this.config = { ...DEFAULT_CONFIG, ...config }
+  }
+
+  expand(query: string): ExpandedQuery {
+    return expandQuery(query, this.config)
+  }
+
+  getSynonyms(term: string): string[] {
+    return getSynonyms(term)
+  }
+
+  getConceptExpansions(term: string): string[] {
+    return getConceptExpansions(term)
+  }
+}

package/src/retrieval/query/index.ts

@@ -1,27 +1,27 @@
-/**
- * Query Understanding Module
- * Exports intent classification, query expansion, and temporal parsing
- */
-
-export {
-  IntentClassifier,
-  classifyIntent,
-  hasIntent,
-  getIntents
-} from './intent-classifier'
-
-export {
-  QueryExpander,
-  expandQuery,
-  getSynonyms,
-  getConceptExpansions,
-  addSynonym,
-  addConceptExpansion
-} from './expander'
-
-export {
-  TemporalParser,
-  parseTemporal,
-  parseTemporalAdvanced,
-  formatDateRangeForQuery
-} from './temporal-parser'
+/**
+ * Query Understanding Module
+ * Exports intent classification, query expansion, and temporal parsing
+ */
+
+export {
+  IntentClassifier,
+  classifyIntent,
+  hasIntent,
+  getIntents
+} from './intent-classifier'
+
+export {
+  QueryExpander,
+  expandQuery,
+  getSynonyms,
+  getConceptExpansions,
+  addSynonym,
+  addConceptExpansion
+} from './expander'
+
+export {
+  TemporalParser,
+  parseTemporal,
+  parseTemporalAdvanced,
+  formatDateRangeForQuery
+} from './temporal-parser'