kirograph 0.20.0 → 0.22.0

package/dist/memory/index.js

@@ -44,7 +44,8 @@ class MemoryManager {
     this.db = db;
     this.projectRoot = projectRoot;
     this.memDb = new import_database.MemoryDatabase(db);
-    this.vectorMgr = new import_vectors.MemoryVectorManager(config, this.memDb);
+    const kirographDir = require("path").join(projectRoot, ".kirograph");
+    this.vectorMgr = new import_vectors.MemoryVectorManager(config, this.memDb, kirographDir);
     this.cavemanMode = config.cavemanMode ?? "off";
     this.excludePatterns = config.memoryExcludePatterns ?? [];
     this.watchmenChecker = config.enableWatchmen ? new import_watchmen.WatchmenChecker(config.watchmenThreshold) : null;

package/dist/memory/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/memory/index.ts"],
-  "sourcesContent": ["/**\n * KiroGraph Memory \u2014 Public API\n *\n * MemoryManager is the single entry point for all memory operations.\n * Coordinates compression, storage, symbol detection, and embedding.\n */\n\nimport type { KiroGraphConfig } from '../config';\nimport type {\n  MemObservation,\n  MemObservationInput,\n  MemSession,\n  ScoredObservation,\n  MemSearchOptions,\n  MemTimelineOptions,\n  MemStats,\n  CompressResult,\n  WatchmenReadyResult,\n} from './types';\nimport { MemoryDatabase } from './database';\nimport { compressObservation, type CavemanMode } from './compress';\nimport { detectSymbols } from './symbols';\nimport { MemoryVectorManager } from './vectors';\nimport { WatchmenChecker } from '../watchmen';\nimport { logDebug } from '../errors';\n\nexport { MemoryDatabase } from './database';\nexport { compressObservation, extractIdentifiers, type CavemanMode } from './compress';\nexport { detectSymbols } from './symbols';\nexport { MemoryVectorManager } from './vectors';\nexport * from './types';\n\n// \u2500\u2500 MemoryManager \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport class MemoryManager {\n  private memDb: MemoryDatabase;\n  private vectorMgr: MemoryVectorManager;\n  private config: KiroGraphConfig;\n  private db: any; // raw sqlite handle for symbol detection\n  private cavemanMode: CavemanMode;\n  private excludePatterns: string[];\n  private watchmenChecker: WatchmenChecker | null;\n  private projectRoot: string;\n\n  constructor(config: KiroGraphConfig, db: any, projectRoot = process.cwd()) {\n    this.config = config;\n    this.db = db;\n    this.projectRoot = projectRoot;\n    this.memDb = new MemoryDatabase(db);\n    this.vectorMgr = new MemoryVectorManager(config, this.memDb);\n    this.cavemanMode = (config as any).cavemanMode ?? 'off';\n    this.excludePatterns = (config as any).memoryExcludePatterns ?? [];\n    this.watchmenChecker = config.enableWatchmen\n      ? new WatchmenChecker(config.watchmenThreshold)\n      : null;\n  }\n\n  /**\n   * Initialize memory tables. Must be called before any operations.\n   */\n  initialize(): void {\n    this.memDb.initialize();\n  }\n\n  /**\n   * Check if memory is enabled in config.\n   */\n  static isEnabled(config: KiroGraphConfig): boolean {\n    return !!(config as any).enableMemory;\n  }\n\n  // \u2500\u2500 Store \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  /**\n   * Store an observation. Handles:\n   * 1. Privacy stripping (<private> blocks)\n   * 2. Exclude pattern checking\n   * 3. Caveman compression (if enabled)\n   * 4. Deduplication (content hash)\n   * 5. Symbol detection and linking\n   * 6. Embedding (if enabled)\n   * 7. Watchmen threshold check (if enabled) \u2014 returns WatchmenReadyResult when synthesis should run\n   *\n   * Returns the observation ID, a WatchmenReadyResult, or null if skipped (duplicate or excluded).\n   */\n  async store(input: MemObservationInput, ide = 'kiro'): Promise<string | WatchmenReadyResult | null> {\n    let text = input.content;\n\n    // 1. Strip <private> blocks\n    text = MemoryDatabase.stripPrivate(text);\n    if (!text.trim()) return null;\n\n    // 2. Check exclude patterns\n    if (this.shouldExclude(text)) return null;\n\n    // 3. Compress (if caveman is on)\n    let contentRaw: string | undefined;\n    if (this.cavemanMode !== 'off') {\n      const result = compressObservation(text, this.cavemanMode);\n      contentRaw = text;\n      text = result.compressed;\n    }\n\n    // 4. Get or create session\n    const cwd = process.cwd();\n    const sessionTimeout = (this.config as any).memorySessionTimeout ?? 7200;\n    const sessionId = this.memDb.getOrCreateSession(ide, cwd, sessionTimeout);\n\n    // 5. Insert observation (deduplicates via content_hash)\n    const id = this.memDb.insertObservation(text, {\n      contentRaw: this.cavemanMode !== 'off' ? contentRaw : undefined,\n      kind: input.kind ?? 'note',\n      source: input.source ?? 'manual',\n      tags: input.tags,\n      sessionId,\n    });\n\n    if (!id) {\n      logDebug('Memory: duplicate observation skipped');\n      return null;\n    }\n\n    // 6. Detect and link symbols\n    const symbols = detectSymbols(text, this.db);\n    if (symbols.length > 0) {\n      this.memDb.linkToSymbols(id, symbols.map(s => s.qualifiedName));\n    }\n\n    // Also detect in raw text if different\n    if (contentRaw) {\n      const rawSymbols = detectSymbols(contentRaw, this.db);\n      const extraSymbols = rawSymbols.filter(\n        s => !symbols.some(existing => existing.qualifiedName === s.qualifiedName)\n      );\n      if (extraSymbols.length > 0) {\n        this.memDb.linkToSymbols(id, extraSymbols.map(s => s.qualifiedName));\n      }\n    }\n\n    // 7. Embed (async, non-blocking for the store operation)\n    const obs = this.memDb.getObservation(id);\n    if (obs) {\n      await this.vectorMgr.embedObservation(obs);\n    }\n\n    // 8. Watchmen threshold check\n    if (this.watchmenChecker && input.kind !== 'summary') {\n      const check = this.watchmenChecker.shouldSynthesize(this.memDb);\n      if (check.ready) {\n        return this.watchmenChecker.buildReadyResponse(id, check.pendingCount, this.projectRoot);\n      }\n    }\n\n    return id;\n  }\n\n  // \u2500\u2500 Search \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  /**\n   * Hybrid search: combines FTS5 and vector search with configurable alpha.\n   */\n  async search(query: string, opts: MemSearchOptions = {}): Promise<ScoredObservation[]> {\n    const limit = opts.limit ?? 10;\n    const alpha = opts.alpha ?? (this.config as any).memorySearchAlpha ?? 0.5;\n\n    // FTS search\n    const ftsResults = this.memDb.searchFTS(query, { ...opts, limit: limit * 2 });\n\n    // Vector search (if enabled and no model mismatch)\n    let vectorResults: ScoredObservation[] = [];\n    if (this.vectorMgr.isEnabled() && !this.vectorMgr.hasModelMismatch()) {\n      vectorResults = await this.vectorMgr.search(query, limit * 2);\n    }\n\n    // If only one source has results, return it directly\n    if (vectorResults.length === 0) return ftsResults.slice(0, limit);\n    if (ftsResults.length === 0) return vectorResults.slice(0, limit);\n\n    // Hybrid merge: normalize scores and blend\n    const merged = this.mergeResults(ftsResults, vectorResults, alpha);\n    return merged.slice(0, limit);\n  }\n\n  /**\n   * Get observations linked to specific symbols.\n   * Used by kirograph_context and kirograph_impact.\n   */\n  getLinkedObservations(qualifiedNames: string[], limit = 3, threshold = 0.3): ScoredObservation[] {\n    const results = this.memDb.getLinkedObservationsForSymbols(qualifiedNames, limit * 2);\n    return results.filter(r => r.score >= threshold).slice(0, limit);\n  }\n\n  // \u2500\u2500 Timeline \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  /**\n   * List sessions with their observation counts.\n   */\n  timeline(opts: MemTimelineOptions = {}): { sessions: MemSession[]; observations: Map<string, MemObservation[]> } {\n    const limit = opts.limit ?? 5;\n\n    if (opts.sessionId) {\n      const session = this.memDb.getSession(opts.sessionId);\n      if (!session) return { sessions: [], observations: new Map() };\n      const obs = this.memDb.getObservationsBySession(opts.sessionId);\n      const map = new Map<string, MemObservation[]>();\n      map.set(opts.sessionId, obs);\n      return { sessions: [session], observations: map };\n    }\n\n    const sessions = this.memDb.listSessions(limit);\n    const observations = new Map<string, MemObservation[]>();\n    for (const session of sessions) {\n      const obs = this.memDb.getObservationsBySession(session.id, 10);\n      observations.set(session.id, obs);\n    }\n    return { sessions, observations };\n  }\n\n  // \u2500\u2500 Status \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  getStats(): MemStats {\n    const modelName = (this.config as any).embeddingModel ?? 'nomic-ai/nomic-embed-text-v1.5';\n    return this.memDb.getStats(modelName);\n  }\n\n  // \u2500\u2500 Session management \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  endCurrentSession(ide = 'kiro'): void {\n    const cwd = process.cwd();\n    const sessionTimeout = (this.config as any).memorySessionTimeout ?? 7200;\n    // Find active session and close it\n    const sessionId = this.memDb.getOrCreateSession(ide, cwd, sessionTimeout);\n    this.memDb.endSession(sessionId);\n  }\n\n  // \u2500\u2500 Maintenance \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  prune(olderThanMs: number): number {\n    const cutoff = Date.now() - olderThanMs;\n    return this.memDb.prune(cutoff);\n  }\n\n  async reembed(batchSize = 32): Promise<number> {\n    return this.vectorMgr.reembed(batchSize);\n  }\n\n  lint(): { staleLinks: number; modelMismatch: boolean; staleSessions: number } {\n    const staleLinks = this.memDb.findStaleLinks().length;\n    const modelMismatch = this.vectorMgr.hasModelMismatch();\n    const sessionTimeout = ((this.config as any).memorySessionTimeout ?? 7200) * 1000;\n    const staleSessions = this.memDb.closeStaleSessionsOlderThan(sessionTimeout);\n    return { staleLinks, modelMismatch, staleSessions };\n  }\n\n  removeStaleLinks(): number {\n    return this.memDb.removeStaleLinks();\n  }\n\n  // \u2500\u2500 Private \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  private shouldExclude(text: string): boolean {\n    if (this.excludePatterns.length === 0) return false;\n\n    // Simple check: if any exclude pattern appears as a substring in the text\n    // This is a basic implementation; could use picomatch for glob matching\n    for (const pattern of this.excludePatterns) {\n      const normalized = pattern.replace(/\\*/g, '');\n      if (normalized && text.includes(normalized)) return true;\n    }\n    return false;\n  }\n\n  private mergeResults(\n    ftsResults: ScoredObservation[],\n    vectorResults: ScoredObservation[],\n    alpha: number\n  ): ScoredObservation[] {\n    // Normalize FTS scores (rank is negative in FTS5, lower = better)\n    const maxFts = Math.max(...ftsResults.map(r => r.score), 1);\n    const normalizedFts = new Map<string, number>();\n    for (const r of ftsResults) {\n      normalizedFts.set(r.observation.id, r.score / maxFts);\n    }\n\n    // Vector scores are already 0-1 (cosine similarity)\n    const normalizedVec = new Map<string, number>();\n    for (const r of vectorResults) {\n      normalizedVec.set(r.observation.id, r.score);\n    }\n\n    // Merge: collect all unique observation IDs\n    const allIds = new Set([...normalizedFts.keys(), ...normalizedVec.keys()]);\n    const merged: ScoredObservation[] = [];\n\n    // Build a lookup for observations\n    const obsMap = new Map<string, MemObservation>();\n    for (const r of ftsResults) obsMap.set(r.observation.id, r.observation);\n    for (const r of vectorResults) obsMap.set(r.observation.id, r.observation);\n\n    for (const id of allIds) {\n      const ftsScore = normalizedFts.get(id) ?? 0;\n      const vecScore = normalizedVec.get(id) ?? 0;\n      const hybridScore = (1 - alpha) * ftsScore + alpha * vecScore;\n      const obs = obsMap.get(id)!;\n      merged.push({ observation: obs, score: hybridScore, scoreSource: 'hybrid' });\n    }\n\n    merged.sort((a, b) => b.score - a.score);\n    return merged;\n  }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["/**\n * KiroGraph Memory \u2014 Public API\n *\n * MemoryManager is the single entry point for all memory operations.\n * Coordinates compression, storage, symbol detection, and embedding.\n */\n\nimport type { KiroGraphConfig } from '../config';\nimport type {\n  MemObservation,\n  MemObservationInput,\n  MemSession,\n  ScoredObservation,\n  MemSearchOptions,\n  MemTimelineOptions,\n  MemStats,\n  CompressResult,\n  WatchmenReadyResult,\n} from './types';\nimport { MemoryDatabase } from './database';\nimport { compressObservation, type CavemanMode } from './compress';\nimport { detectSymbols } from './symbols';\nimport { MemoryVectorManager } from './vectors';\nimport { WatchmenChecker } from '../watchmen';\nimport { logDebug } from '../errors';\n\nexport { MemoryDatabase } from './database';\nexport { compressObservation, extractIdentifiers, type CavemanMode } from './compress';\nexport { detectSymbols } from './symbols';\nexport { MemoryVectorManager } from './vectors';\nexport * from './types';\n\n// \u2500\u2500 MemoryManager \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport class MemoryManager {\n  private memDb: MemoryDatabase;\n  private vectorMgr: MemoryVectorManager;\n  private config: KiroGraphConfig;\n  private db: any; // raw sqlite handle for symbol detection\n  private cavemanMode: CavemanMode;\n  private excludePatterns: string[];\n  private watchmenChecker: WatchmenChecker | null;\n  private projectRoot: string;\n\n  constructor(config: KiroGraphConfig, db: any, projectRoot = process.cwd()) {\n    this.config = config;\n    this.db = db;\n    this.projectRoot = projectRoot;\n    this.memDb = new MemoryDatabase(db);\n    const kirographDir = require('path').join(projectRoot, '.kirograph');\n    this.vectorMgr = new MemoryVectorManager(config, this.memDb, kirographDir);\n    this.cavemanMode = (config as any).cavemanMode ?? 'off';\n    this.excludePatterns = (config as any).memoryExcludePatterns ?? [];\n    this.watchmenChecker = config.enableWatchmen\n      ? new WatchmenChecker(config.watchmenThreshold)\n      : null;\n  }\n\n  /**\n   * Initialize memory tables. Must be called before any operations.\n   */\n  initialize(): void {\n    this.memDb.initialize();\n  }\n\n  /**\n   * Check if memory is enabled in config.\n   */\n  static isEnabled(config: KiroGraphConfig): boolean {\n    return !!(config as any).enableMemory;\n  }\n\n  // \u2500\u2500 Store \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  /**\n   * Store an observation. Handles:\n   * 1. Privacy stripping (<private> blocks)\n   * 2. Exclude pattern checking\n   * 3. Caveman compression (if enabled)\n   * 4. Deduplication (content hash)\n   * 5. Symbol detection and linking\n   * 6. Embedding (if enabled)\n   * 7. Watchmen threshold check (if enabled) \u2014 returns WatchmenReadyResult when synthesis should run\n   *\n   * Returns the observation ID, a WatchmenReadyResult, or null if skipped (duplicate or excluded).\n   */\n  async store(input: MemObservationInput, ide = 'kiro'): Promise<string | WatchmenReadyResult | null> {\n    let text = input.content;\n\n    // 1. Strip <private> blocks\n    text = MemoryDatabase.stripPrivate(text);\n    if (!text.trim()) return null;\n\n    // 2. Check exclude patterns\n    if (this.shouldExclude(text)) return null;\n\n    // 3. Compress (if caveman is on)\n    let contentRaw: string | undefined;\n    if (this.cavemanMode !== 'off') {\n      const result = compressObservation(text, this.cavemanMode);\n      contentRaw = text;\n      text = result.compressed;\n    }\n\n    // 4. Get or create session\n    const cwd = process.cwd();\n    const sessionTimeout = (this.config as any).memorySessionTimeout ?? 7200;\n    const sessionId = this.memDb.getOrCreateSession(ide, cwd, sessionTimeout);\n\n    // 5. Insert observation (deduplicates via content_hash)\n    const id = this.memDb.insertObservation(text, {\n      contentRaw: this.cavemanMode !== 'off' ? contentRaw : undefined,\n      kind: input.kind ?? 'note',\n      source: input.source ?? 'manual',\n      tags: input.tags,\n      sessionId,\n    });\n\n    if (!id) {\n      logDebug('Memory: duplicate observation skipped');\n      return null;\n    }\n\n    // 6. Detect and link symbols\n    const symbols = detectSymbols(text, this.db);\n    if (symbols.length > 0) {\n      this.memDb.linkToSymbols(id, symbols.map(s => s.qualifiedName));\n    }\n\n    // Also detect in raw text if different\n    if (contentRaw) {\n      const rawSymbols = detectSymbols(contentRaw, this.db);\n      const extraSymbols = rawSymbols.filter(\n        s => !symbols.some(existing => existing.qualifiedName === s.qualifiedName)\n      );\n      if (extraSymbols.length > 0) {\n        this.memDb.linkToSymbols(id, extraSymbols.map(s => s.qualifiedName));\n      }\n    }\n\n    // 7. Embed (async, non-blocking for the store operation)\n    const obs = this.memDb.getObservation(id);\n    if (obs) {\n      await this.vectorMgr.embedObservation(obs);\n    }\n\n    // 8. Watchmen threshold check\n    if (this.watchmenChecker && input.kind !== 'summary') {\n      const check = this.watchmenChecker.shouldSynthesize(this.memDb);\n      if (check.ready) {\n        return this.watchmenChecker.buildReadyResponse(id, check.pendingCount, this.projectRoot);\n      }\n    }\n\n    return id;\n  }\n\n  // \u2500\u2500 Search \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  /**\n   * Hybrid search: combines FTS5 and vector search with configurable alpha.\n   */\n  async search(query: string, opts: MemSearchOptions = {}): Promise<ScoredObservation[]> {\n    const limit = opts.limit ?? 10;\n    const alpha = opts.alpha ?? (this.config as any).memorySearchAlpha ?? 0.5;\n\n    // FTS search\n    const ftsResults = this.memDb.searchFTS(query, { ...opts, limit: limit * 2 });\n\n    // Vector search (if enabled and no model mismatch)\n    let vectorResults: ScoredObservation[] = [];\n    if (this.vectorMgr.isEnabled() && !this.vectorMgr.hasModelMismatch()) {\n      vectorResults = await this.vectorMgr.search(query, limit * 2);\n    }\n\n    // If only one source has results, return it directly\n    if (vectorResults.length === 0) return ftsResults.slice(0, limit);\n    if (ftsResults.length === 0) return vectorResults.slice(0, limit);\n\n    // Hybrid merge: normalize scores and blend\n    const merged = this.mergeResults(ftsResults, vectorResults, alpha);\n    return merged.slice(0, limit);\n  }\n\n  /**\n   * Get observations linked to specific symbols.\n   * Used by kirograph_context and kirograph_impact.\n   */\n  getLinkedObservations(qualifiedNames: string[], limit = 3, threshold = 0.3): ScoredObservation[] {\n    const results = this.memDb.getLinkedObservationsForSymbols(qualifiedNames, limit * 2);\n    return results.filter(r => r.score >= threshold).slice(0, limit);\n  }\n\n  // \u2500\u2500 Timeline \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  /**\n   * List sessions with their observation counts.\n   */\n  timeline(opts: MemTimelineOptions = {}): { sessions: MemSession[]; observations: Map<string, MemObservation[]> } {\n    const limit = opts.limit ?? 5;\n\n    if (opts.sessionId) {\n      const session = this.memDb.getSession(opts.sessionId);\n      if (!session) return { sessions: [], observations: new Map() };\n      const obs = this.memDb.getObservationsBySession(opts.sessionId);\n      const map = new Map<string, MemObservation[]>();\n      map.set(opts.sessionId, obs);\n      return { sessions: [session], observations: map };\n    }\n\n    const sessions = this.memDb.listSessions(limit);\n    const observations = new Map<string, MemObservation[]>();\n    for (const session of sessions) {\n      const obs = this.memDb.getObservationsBySession(session.id, 10);\n      observations.set(session.id, obs);\n    }\n    return { sessions, observations };\n  }\n\n  // \u2500\u2500 Status \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  getStats(): MemStats {\n    const modelName = (this.config as any).embeddingModel ?? 'nomic-ai/nomic-embed-text-v1.5';\n    return this.memDb.getStats(modelName);\n  }\n\n  // \u2500\u2500 Session management \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  endCurrentSession(ide = 'kiro'): void {\n    const cwd = process.cwd();\n    const sessionTimeout = (this.config as any).memorySessionTimeout ?? 7200;\n    // Find active session and close it\n    const sessionId = this.memDb.getOrCreateSession(ide, cwd, sessionTimeout);\n    this.memDb.endSession(sessionId);\n  }\n\n  // \u2500\u2500 Maintenance \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  prune(olderThanMs: number): number {\n    const cutoff = Date.now() - olderThanMs;\n    return this.memDb.prune(cutoff);\n  }\n\n  async reembed(batchSize = 32): Promise<number> {\n    return this.vectorMgr.reembed(batchSize);\n  }\n\n  lint(): { staleLinks: number; modelMismatch: boolean; staleSessions: number } {\n    const staleLinks = this.memDb.findStaleLinks().length;\n    const modelMismatch = this.vectorMgr.hasModelMismatch();\n    const sessionTimeout = ((this.config as any).memorySessionTimeout ?? 7200) * 1000;\n    const staleSessions = this.memDb.closeStaleSessionsOlderThan(sessionTimeout);\n    return { staleLinks, modelMismatch, staleSessions };\n  }\n\n  removeStaleLinks(): number {\n    return this.memDb.removeStaleLinks();\n  }\n\n  // \u2500\u2500 Private \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  private shouldExclude(text: string): boolean {\n    if (this.excludePatterns.length === 0) return false;\n\n    // Simple check: if any exclude pattern appears as a substring in the text\n    // This is a basic implementation; could use picomatch for glob matching\n    for (const pattern of this.excludePatterns) {\n      const normalized = pattern.replace(/\\*/g, '');\n      if (normalized && text.includes(normalized)) return true;\n    }\n    return false;\n  }\n\n  private mergeResults(\n    ftsResults: ScoredObservation[],\n    vectorResults: ScoredObservation[],\n    alpha: number\n  ): ScoredObservation[] {\n    // Normalize FTS scores (rank is negative in FTS5, lower = better)\n    const maxFts = Math.max(...ftsResults.map(r => r.score), 1);\n    const normalizedFts = new Map<string, number>();\n    for (const r of ftsResults) {\n      normalizedFts.set(r.observation.id, r.score / maxFts);\n    }\n\n    // Vector scores are already 0-1 (cosine similarity)\n    const normalizedVec = new Map<string, number>();\n    for (const r of vectorResults) {\n      normalizedVec.set(r.observation.id, r.score);\n    }\n\n    // Merge: collect all unique observation IDs\n    const allIds = new Set([...normalizedFts.keys(), ...normalizedVec.keys()]);\n    const merged: ScoredObservation[] = [];\n\n    // Build a lookup for observations\n    const obsMap = new Map<string, MemObservation>();\n    for (const r of ftsResults) obsMap.set(r.observation.id, r.observation);\n    for (const r of vectorResults) obsMap.set(r.observation.id, r.observation);\n\n    for (const id of allIds) {\n      const ftsScore = normalizedFts.get(id) ?? 0;\n      const vecScore = normalizedVec.get(id) ?? 0;\n      const hybridScore = (1 - alpha) * ftsScore + alpha * vecScore;\n      const obs = obsMap.get(id)!;\n      merged.push({ observation: obs, score: hybridScore, scoreSource: 'hybrid' });\n    }\n\n    merged.sort((a, b) => b.score - a.score);\n    return merged;\n  }\n}\n"],
+  "mappings": "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",
   "names": ["import_database", "import_compress", "import_symbols", "import_vectors"]
 }

package/dist/memory/vectors.js

@@ -32,6 +32,7 @@ __export(vectors_exports, {
 });
 module.exports = __toCommonJS(vectors_exports);
 var import_errors = require("../errors");
+var import_turboquant_index = require("../vectors/turboquant-index");
 const MAX_TOKEN_CHARS = 2e3;
 let transformers = null;
 let pipeline = null;
@@ -71,13 +72,27 @@ function cosine(a, b) {
   return denom === 0 ? 0 : dot / denom;
 }
 class MemoryVectorManager {
-  constructor(config, memDb) {
+  constructor(config, memDb, kirographDir) {
+    this.tqIndex = null;
+    this.tqInitialized = false;
     this.config = config;
     this.memDb = memDb;
     this.modelName = config.embeddingModel ?? "nomic-ai/nomic-embed-text-v1.5";
     const { homedir } = require("os");
-    const path = require("path");
-    this.cacheDir = path.join(homedir(), ".kirograph", "models");
+    const pathMod = require("path");
+    this.cacheDir = pathMod.join(homedir(), ".kirograph", "models");
+    if (kirographDir && config.turboquantMemDocs) {
+      const bits = config.turboquantBits ?? 3;
+      const dim = config.embeddingDim ?? 768;
+      this.tqIndex = new import_turboquant_index.TurboQuantIndex(kirographDir, "turboquant-mem.bin", dim, bits);
+      this._kirographDir = kirographDir;
+    }
+  }
+  /** Lazily initialize the TurboQuant index on first use. */
+  async ensureTQReady() {
+    if (this.tqInitialized) return;
+    this.tqInitialized = true;
+    if (this.tqIndex) await this.tqIndex.initialize();
   }
   /**
    * Check if embeddings are enabled in config.
@@ -96,6 +111,10 @@ class MemoryVectorManager {
       if (embedding) {
         const buffer = Buffer.from(embedding.buffer);
         this.memDb.insertVector(obs.id, buffer, this.modelName);
+        if (this.tqIndex) {
+          await this.ensureTQReady();
+          this.tqIndex.upsert(obs.id, embedding);
+        }
       }
     } catch (err) {
       (0, import_errors.logWarn)(`Failed to embed observation ${obs.id}: ${err}`);
@@ -126,22 +145,31 @@ class MemoryVectorManager {
     try {
       const queryEmbedding = await this.embed(query);
       if (!queryEmbedding) return [];
+      if (this.tqIndex) {
+        await this.ensureTQReady();
+        if (this.tqIndex.isAvailable()) {
+          const hits = this.tqIndex.searchWithScores(queryEmbedding, limit);
+          const results2 = [];
+          for (const { id, score } of hits) {
+            const obs = this.memDb.getObservation(id);
+            if (obs) results2.push({ observation: obs, score, scoreSource: "vector" });
+          }
+          return results2;
+        }
+      }
       const allVectors = this.memDb.getAllVectors(this.modelName);
       if (allVectors.length === 0) return [];
       const scored = [];
       for (const { observationId, embedding } of allVectors) {
         const vec = new Float32Array(embedding.buffer, embedding.byteOffset, embedding.byteLength / 4);
-        const score = cosine(queryEmbedding, vec);
-        scored.push({ observationId, score });
+        scored.push({ observationId, score: cosine(queryEmbedding, vec) });
       }
       scored.sort((a, b) => b.score - a.score);
       const topN = scored.slice(0, limit);
       const results = [];
       for (const { observationId, score } of topN) {
         const obs = this.memDb.getObservation(observationId);
-        if (obs) {
-          results.push({ observation: obs, score, scoreSource: "vector" });
-        }
+        if (obs) results.push({ observation: obs, score, scoreSource: "vector" });
       }
       return results;
     } catch (err) {
@@ -160,6 +188,10 @@ class MemoryVectorManager {
    */
   async reembed(batchSize = 32) {
     this.memDb.deleteVectors();
+    if (this.tqIndex) {
+      this.tqIndex.close();
+      this.tqInitialized = false;
+    }
     const db = this.memDb.db;
     const rows = db.all("SELECT * FROM mem_observations ORDER BY created_at");
     const observations = rows.map((row) => ({
@@ -178,6 +210,18 @@ class MemoryVectorManager {
       const batch = observations.slice(i, i + batchSize);
       embedded += await this.embedBatch(batch);
     }
+    if (this.tqIndex?.isAvailable() && this._kirographDir) {
+      await this.tqIndex.save();
+      const stats = this.tqIndex.memoryStats();
+      const dim = this.config.embeddingDim ?? 768;
+      const rawBytes = embedded * dim * 4;
+      (0, import_turboquant_index.writeTurboQuantStats)(this._kirographDir, {
+        memEnabled: true,
+        memCount: embedded,
+        memActualBytes: stats.actualBytes,
+        memRawBytes: rawBytes
+      });
+    }
     return embedded;
   }
   // ── Private ────────────────────────────────────────────────────────────────

package/dist/memory/vectors.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/memory/vectors.ts"],
-  "sourcesContent": ["/**\n * KiroGraph Memory \u2014 Vector embedding and search\n *\n * Reuses the same embedding model and semantic engine as the code graph,\n * but operates on mem_vectors table independently.\n */\n\nimport type { KiroGraphConfig } from '../config';\nimport type { MemObservation, ScoredObservation } from './types';\nimport type { MemoryDatabase } from './database';\nimport { logDebug, logWarn, logError } from '../errors';\n\nconst MAX_TOKEN_CHARS = 2000;\n\n// \u2500\u2500 Embedder (reuses the same pipeline as code vectors) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nlet transformers: typeof import('@huggingface/transformers') | null = null;\nlet pipeline: any = null;\nlet pipelineModel: string | null = null;\n\nasync function getTransformers() {\n  if (!transformers) {\n    transformers = await import('@huggingface/transformers');\n  }\n  return transformers;\n}\n\nasync function getPipeline(modelName: string, cacheDir: string) {\n  if (pipeline && pipelineModel === modelName) return pipeline;\n\n  const tf = await getTransformers();\n  pipeline = await tf.pipeline('feature-extraction', modelName, {\n    cache_dir: cacheDir,\n    dtype: 'fp32',\n  } as any);\n  pipelineModel = modelName;\n  return pipeline;\n}\n\n/**\n * Build searchable text from an observation.\n * Truncated to MAX_TOKEN_CHARS.\n */\nfunction observationToText(obs: MemObservation): string {\n  const parts = [`[${obs.kind}] ${obs.content}`];\n  if (obs.tags && obs.tags.length > 0) {\n    parts.push(`tags: ${obs.tags.join(', ')}`);\n  }\n  const text = parts.join('\\n');\n  return text.length > MAX_TOKEN_CHARS ? text.slice(0, MAX_TOKEN_CHARS) : text;\n}\n\n/** Cosine similarity between two Float32Arrays */\nfunction cosine(a: Float32Array, b: Float32Array): number {\n  let dot = 0, na = 0, nb = 0;\n  for (let i = 0; i < a.length; i++) {\n    dot += a[i] * b[i];\n    na += a[i] * a[i];\n    nb += b[i] * b[i];\n  }\n  const denom = Math.sqrt(na) * Math.sqrt(nb);\n  return denom === 0 ? 0 : dot / denom;\n}\n\n// \u2500\u2500 MemoryVectorManager \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport class MemoryVectorManager {\n  private config: KiroGraphConfig;\n  private memDb: MemoryDatabase;\n  private modelName: string;\n  private cacheDir: string;\n\n  constructor(config: KiroGraphConfig, memDb: MemoryDatabase) {\n    this.config = config;\n    this.memDb = memDb;\n    this.modelName = (config as any).embeddingModel ?? 'nomic-ai/nomic-embed-text-v1.5';\n\n    const { homedir } = require('os');\n    const path = require('path');\n    this.cacheDir = path.join(homedir(), '.kirograph', 'models');\n  }\n\n  /**\n   * Check if embeddings are enabled in config.\n   */\n  isEnabled(): boolean {\n    return !!(this.config as any).enableEmbeddings;\n  }\n\n  /**\n   * Embed a single observation and store in mem_vectors.\n   */\n  async embedObservation(obs: MemObservation): Promise<void> {\n    if (!this.isEnabled()) return;\n\n    try {\n      const text = observationToText(obs);\n      const embedding = await this.embed(text);\n      if (embedding) {\n        const buffer = Buffer.from(embedding.buffer);\n        this.memDb.insertVector(obs.id, buffer, this.modelName);\n      }\n    } catch (err) {\n      logWarn(`Failed to embed observation ${obs.id}: ${err}`);\n    }\n  }\n\n  /**\n   * Embed multiple observations in batch.\n   */\n  async embedBatch(observations: MemObservation[]): Promise<number> {\n    if (!this.isEnabled()) return 0;\n\n    let embedded = 0;\n    for (const obs of observations) {\n      try {\n        await this.embedObservation(obs);\n        embedded++;\n      } catch (err) {\n        logWarn(`Failed to embed observation ${obs.id}: ${err}`);\n      }\n    }\n    return embedded;\n  }\n\n  /**\n   * Vector search over memory observations.\n   * Falls back to empty results if embeddings are disabled or model mismatches.\n   */\n  async search(query: string, limit = 10): Promise<ScoredObservation[]> {\n    if (!this.isEnabled()) return [];\n\n    try {\n      const queryEmbedding = await this.embed(query);\n      if (!queryEmbedding) return [];\n\n      // Get all vectors with matching model\n      const allVectors = this.memDb.getAllVectors(this.modelName);\n      if (allVectors.length === 0) return [];\n\n      // Compute cosine similarity for each\n      const scored: Array<{ observationId: string; score: number }> = [];\n      for (const { observationId, embedding } of allVectors) {\n        const vec = new Float32Array(embedding.buffer, embedding.byteOffset, embedding.byteLength / 4);\n        const score = cosine(queryEmbedding, vec);\n        scored.push({ observationId, score });\n      }\n\n      // Sort by score descending, take top N\n      scored.sort((a, b) => b.score - a.score);\n      const topN = scored.slice(0, limit);\n\n      // Fetch full observations\n      const results: ScoredObservation[] = [];\n      for (const { observationId, score } of topN) {\n        const obs = this.memDb.getObservation(observationId);\n        if (obs) {\n          results.push({ observation: obs, score, scoreSource: 'vector' });\n        }\n      }\n\n      return results;\n    } catch (err) {\n      logError('Memory vector search failed', { error: err });\n      return [];\n    }\n  }\n\n  /**\n   * Check if there are vectors with a mismatched model.\n   */\n  hasModelMismatch(): boolean {\n    return this.memDb.getVectorModelMismatch(this.modelName) > 0;\n  }\n\n  /**\n   * Re-embed all observations with the current model.\n   */\n  async reembed(batchSize = 32): Promise<number> {\n    // Delete all existing vectors\n    this.memDb.deleteVectors();\n\n    // Get all observations\n    const db = (this.memDb as any).db;\n    const rows = db.all('SELECT * FROM mem_observations ORDER BY created_at');\n    const observations: MemObservation[] = rows.map((row: any) => ({\n      id: row.id,\n      sessionId: row.session_id ?? undefined,\n      content: row.content,\n      contentRaw: row.content_raw ?? undefined,\n      contentHash: row.content_hash,\n      kind: row.kind,\n      source: row.source,\n      tags: row.tags ? JSON.parse(row.tags) : undefined,\n      createdAt: row.created_at,\n    }));\n\n    let embedded = 0;\n    for (let i = 0; i < observations.length; i += batchSize) {\n      const batch = observations.slice(i, i + batchSize);\n      embedded += await this.embedBatch(batch);\n    }\n\n    return embedded;\n  }\n\n  // \u2500\u2500 Private \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  private async embed(text: string): Promise<Float32Array | null> {\n    try {\n      const pipe = await getPipeline(this.modelName, this.cacheDir);\n      const output = await pipe(text, { pooling: 'mean', normalize: true });\n      return output.data as Float32Array;\n    } catch (err) {\n      logDebug(`Embedding failed: ${err}`);\n      return null;\n    }\n  }\n}\n"],
-  "mappings": "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",
-  "names": []
+  "sourcesContent": ["/**\n * KiroGraph Memory \u2014 Vector embedding and search\n *\n * Reuses the same embedding model and semantic engine as the code graph,\n * but operates on mem_vectors table independently.\n */\n\nimport type { KiroGraphConfig } from '../config';\nimport type { MemObservation, ScoredObservation } from './types';\nimport type { MemoryDatabase } from './database';\nimport { logDebug, logWarn, logError } from '../errors';\nimport { TurboQuantIndex, writeTurboQuantStats } from '../vectors/turboquant-index';\n\nconst MAX_TOKEN_CHARS = 2000;\n\n// \u2500\u2500 Embedder (reuses the same pipeline as code vectors) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nlet transformers: typeof import('@huggingface/transformers') | null = null;\nlet pipeline: any = null;\nlet pipelineModel: string | null = null;\n\nasync function getTransformers() {\n  if (!transformers) {\n    transformers = await import('@huggingface/transformers');\n  }\n  return transformers;\n}\n\nasync function getPipeline(modelName: string, cacheDir: string) {\n  if (pipeline && pipelineModel === modelName) return pipeline;\n\n  const tf = await getTransformers();\n  pipeline = await tf.pipeline('feature-extraction', modelName, {\n    cache_dir: cacheDir,\n    dtype: 'fp32',\n  } as any);\n  pipelineModel = modelName;\n  return pipeline;\n}\n\n/**\n * Build searchable text from an observation.\n * Truncated to MAX_TOKEN_CHARS.\n */\nfunction observationToText(obs: MemObservation): string {\n  const parts = [`[${obs.kind}] ${obs.content}`];\n  if (obs.tags && obs.tags.length > 0) {\n    parts.push(`tags: ${obs.tags.join(', ')}`);\n  }\n  const text = parts.join('\\n');\n  return text.length > MAX_TOKEN_CHARS ? text.slice(0, MAX_TOKEN_CHARS) : text;\n}\n\n/** Cosine similarity between two Float32Arrays */\nfunction cosine(a: Float32Array, b: Float32Array): number {\n  let dot = 0, na = 0, nb = 0;\n  for (let i = 0; i < a.length; i++) {\n    dot += a[i] * b[i];\n    na += a[i] * a[i];\n    nb += b[i] * b[i];\n  }\n  const denom = Math.sqrt(na) * Math.sqrt(nb);\n  return denom === 0 ? 0 : dot / denom;\n}\n\n// \u2500\u2500 MemoryVectorManager \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport class MemoryVectorManager {\n  private config: KiroGraphConfig;\n  private memDb: MemoryDatabase;\n  private modelName: string;\n  private cacheDir: string;\n  private tqIndex: TurboQuantIndex | null = null;\n  private tqInitialized = false;\n\n  constructor(config: KiroGraphConfig, memDb: MemoryDatabase, kirographDir?: string) {\n    this.config = config;\n    this.memDb = memDb;\n    this.modelName = (config as any).embeddingModel ?? 'nomic-ai/nomic-embed-text-v1.5';\n\n    const { homedir } = require('os');\n    const pathMod = require('path');\n    this.cacheDir = pathMod.join(homedir(), '.kirograph', 'models');\n\n    if (kirographDir && (config as any).turboquantMemDocs) {\n      const bits = (config as any).turboquantBits ?? 3;\n      const dim = (config as any).embeddingDim ?? 768;\n      this.tqIndex = new TurboQuantIndex(kirographDir, 'turboquant-mem.bin', dim, bits);\n      this._kirographDir = kirographDir;\n    }\n  }\n\n  private _kirographDir: string | undefined;\n\n  /** Lazily initialize the TurboQuant index on first use. */\n  private async ensureTQReady(): Promise<void> {\n    if (this.tqInitialized) return;\n    this.tqInitialized = true;\n    if (this.tqIndex) await this.tqIndex.initialize();\n  }\n\n  /**\n   * Check if embeddings are enabled in config.\n   */\n  isEnabled(): boolean {\n    return !!(this.config as any).enableEmbeddings;\n  }\n\n  /**\n   * Embed a single observation and store in mem_vectors.\n   */\n  async embedObservation(obs: MemObservation): Promise<void> {\n    if (!this.isEnabled()) return;\n\n    try {\n      const text = observationToText(obs);\n      const embedding = await this.embed(text);\n      if (embedding) {\n        const buffer = Buffer.from(embedding.buffer);\n        this.memDb.insertVector(obs.id, buffer, this.modelName);\n        if (this.tqIndex) {\n          await this.ensureTQReady();\n          this.tqIndex.upsert(obs.id, embedding);\n        }\n      }\n    } catch (err) {\n      logWarn(`Failed to embed observation ${obs.id}: ${err}`);\n    }\n  }\n\n  /**\n   * Embed multiple observations in batch.\n   */\n  async embedBatch(observations: MemObservation[]): Promise<number> {\n    if (!this.isEnabled()) return 0;\n\n    let embedded = 0;\n    for (const obs of observations) {\n      try {\n        await this.embedObservation(obs);\n        embedded++;\n      } catch (err) {\n        logWarn(`Failed to embed observation ${obs.id}: ${err}`);\n      }\n    }\n    return embedded;\n  }\n\n  /**\n   * Vector search over memory observations.\n   * Falls back to empty results if embeddings are disabled or model mismatches.\n   */\n  async search(query: string, limit = 10): Promise<ScoredObservation[]> {\n    if (!this.isEnabled()) return [];\n\n    try {\n      const queryEmbedding = await this.embed(query);\n      if (!queryEmbedding) return [];\n\n      // ANN path: TurboQuant index replaces the O(n) linear scan\n      if (this.tqIndex) {\n        await this.ensureTQReady();\n        if (this.tqIndex.isAvailable()) {\n          const hits = this.tqIndex.searchWithScores(queryEmbedding, limit);\n          const results: ScoredObservation[] = [];\n          for (const { id, score } of hits) {\n            const obs = this.memDb.getObservation(id);\n            if (obs) results.push({ observation: obs, score, scoreSource: 'vector' });\n          }\n          return results;\n        }\n      }\n\n      // Fallback: linear cosine scan over all stored embeddings\n      const allVectors = this.memDb.getAllVectors(this.modelName);\n      if (allVectors.length === 0) return [];\n\n      const scored: Array<{ observationId: string; score: number }> = [];\n      for (const { observationId, embedding } of allVectors) {\n        const vec = new Float32Array(embedding.buffer, embedding.byteOffset, embedding.byteLength / 4);\n        scored.push({ observationId, score: cosine(queryEmbedding, vec) });\n      }\n\n      scored.sort((a, b) => b.score - a.score);\n      const topN = scored.slice(0, limit);\n\n      const results: ScoredObservation[] = [];\n      for (const { observationId, score } of topN) {\n        const obs = this.memDb.getObservation(observationId);\n        if (obs) results.push({ observation: obs, score, scoreSource: 'vector' });\n      }\n      return results;\n    } catch (err) {\n      logError('Memory vector search failed', { error: err });\n      return [];\n    }\n  }\n\n  /**\n   * Check if there are vectors with a mismatched model.\n   */\n  hasModelMismatch(): boolean {\n    return this.memDb.getVectorModelMismatch(this.modelName) > 0;\n  }\n\n  /**\n   * Re-embed all observations with the current model.\n   */\n  async reembed(batchSize = 32): Promise<number> {\n    // Delete all existing vectors\n    this.memDb.deleteVectors();\n\n    // Reset TurboQuant index so it rebuilds from scratch\n    if (this.tqIndex) {\n      this.tqIndex.close();\n      this.tqInitialized = false;\n    }\n\n    // Get all observations\n    const db = (this.memDb as any).db;\n    const rows = db.all('SELECT * FROM mem_observations ORDER BY created_at');\n    const observations: MemObservation[] = rows.map((row: any) => ({\n      id: row.id,\n      sessionId: row.session_id ?? undefined,\n      content: row.content,\n      contentRaw: row.content_raw ?? undefined,\n      contentHash: row.content_hash,\n      kind: row.kind,\n      source: row.source,\n      tags: row.tags ? JSON.parse(row.tags) : undefined,\n      createdAt: row.created_at,\n    }));\n\n    let embedded = 0;\n    for (let i = 0; i < observations.length; i += batchSize) {\n      const batch = observations.slice(i, i + batchSize);\n      embedded += await this.embedBatch(batch);\n    }\n\n    if (this.tqIndex?.isAvailable() && this._kirographDir) {\n      await this.tqIndex.save();\n      const stats = this.tqIndex.memoryStats();\n      const dim = (this.config as any).embeddingDim ?? 768;\n      const rawBytes = embedded * dim * 4;\n      writeTurboQuantStats(this._kirographDir, {\n        memEnabled: true,\n        memCount: embedded,\n        memActualBytes: stats.actualBytes,\n        memRawBytes: rawBytes,\n      });\n    }\n\n    return embedded;\n  }\n\n  // \u2500\u2500 Private \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  private async embed(text: string): Promise<Float32Array | null> {\n    try {\n      const pipe = await getPipeline(this.modelName, this.cacheDir);\n      const output = await pipe(text, { pooling: 'mean', normalize: true });\n      return output.data as Float32Array;\n    } catch (err) {\n      logDebug(`Embedding failed: ${err}`);\n      return null;\n    }\n  }\n}\n"],
+  "mappings": "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",
+  "names": ["results"]
 }

package/dist/patterns/library/code-eval-elixir.yaml

@@ -0,0 +1,11 @@
+id: code-eval-elixir
+language: elixir
+severity: critical
+owaspCategory: A03
+description: Code.eval_string() executes arbitrary Elixir code — code injection vector
+fixHint: Remove Code.eval_string/eval_quoted; use pattern matching or a restricted DSL instead. Never evaluate user-controlled strings.
+rule:
+  kind: call
+  has:
+    kind: dot
+    regex: '^Code\.eval_string'

package/dist/patterns/library/command-injection-c.yaml

@@ -0,0 +1,11 @@
+id: command-injection-c
+language: [c, cpp]
+severity: critical
+owaspCategory: A03
+description: system() or popen() with a variable argument — command injection vector
+fixHint: Avoid system()/popen(); use execv/execvp with an array of fixed arguments. Validate all inputs.
+rule:
+  kind: call_expression
+  has:
+    kind: identifier
+    regex: '^(system|popen)$'

package/dist/patterns/library/command-injection-go.yaml

@@ -4,8 +4,26 @@ severity: critical
 owaspCategory: A03
 description: exec.Command() with string concatenation — command injection vector
 fixHint: Use exec.Command() with separate arguments (never shell=true). Validate all inputs.
-fix: "exec.Command($CMD, args...)"
 rule:
   any:
-    - pattern: exec.Command($A + $B)
-    - pattern: exec.Command(fmt.Sprintf($$$))
+    - kind: call_expression
+      all:
+        - has:
+            kind: selector_expression
+            regex: '^exec\.Command$'
+        - has:
+            kind: argument_list
+            has:
+              kind: binary_expression
+    - kind: call_expression
+      all:
+        - has:
+            kind: selector_expression
+            regex: '^exec\.Command$'
+        - has:
+            kind: argument_list
+            has:
+              kind: call_expression
+              has:
+                kind: selector_expression
+                regex: '^fmt\.Sprintf$'

package/dist/patterns/library/command-injection-kotlin.yaml

@@ -0,0 +1,10 @@
+id: command-injection-kotlin
+language: kotlin
+severity: critical
+owaspCategory: A03
+description: Runtime.exec() or ProcessBuilder — command injection vector if arguments are user-controlled
+fixHint: Pass a fixed executable and a validated argument array. Never build command strings from user input.
+rule:
+  any:
+    - pattern: Runtime.getRuntime().exec($CMD)
+    - pattern: ProcessBuilder($CMD).start()

package/dist/patterns/library/command-injection-php.yaml

@@ -0,0 +1,11 @@
+id: command-injection-php
+language: php
+severity: critical
+owaspCategory: A03
+description: system()/exec()/shell_exec()/passthru() — command injection vector
+fixHint: Use escapeshellarg() on every argument, or replace with a native PHP library that avoids shell invocation entirely.
+rule:
+  kind: function_call_expression
+  has:
+    kind: name
+    regex: '^(system|exec|shell_exec|passthru|popen|proc_open)$'

package/dist/patterns/library/command-injection-ruby.yaml

@@ -0,0 +1,11 @@
+id: command-injection-ruby
+language: ruby
+severity: critical
+owaspCategory: A03
+description: system()/exec()/spawn() with variable argument — command injection vector
+fixHint: Pass an array of fixed arguments to system/exec to disable shell interpretation. Validate all user input.
+rule:
+  kind: call
+  has:
+    kind: identifier
+    regex: '^(system|exec|spawn)$'

package/dist/patterns/library/command-injection-rust.yaml

@@ -0,0 +1,11 @@
+id: command-injection-rust
+language: rust
+severity: critical
+owaspCategory: A03
+description: std::process::Command built with a variable argument — command injection vector
+fixHint: Pass a fixed executable path and validate each argument individually. Never construct commands from user input.
+rule:
+  kind: call_expression
+  has:
+    kind: scoped_identifier
+    regex: 'Command::new'

package/dist/patterns/library/dangerous-eval-bash.yaml

@@ -0,0 +1,11 @@
+id: dangerous-eval-bash
+language: bash
+severity: critical
+owaspCategory: A03
+description: eval command executes arbitrary shell code — command injection vector
+fixHint: Remove eval; use explicit variable assignments and function calls. Never evaluate user-controlled strings.
+rule:
+  kind: command
+  has:
+    kind: command_name
+    regex: '^eval$'

package/dist/patterns/library/dangerous-eval-php.yaml

@@ -0,0 +1,11 @@
+id: dangerous-eval-php
+language: php
+severity: critical
+owaspCategory: A03
+description: eval() executes arbitrary PHP code — code injection vector
+fixHint: Remove eval(); parse data with json_decode() or use explicit logic. Never evaluate user-supplied strings.
+rule:
+  kind: function_call_expression
+  has:
+    kind: name
+    regex: '^eval$'

package/dist/patterns/library/dangerous-eval-ruby.yaml

@@ -0,0 +1,11 @@
+id: dangerous-eval-ruby
+language: ruby
+severity: critical
+owaspCategory: A03
+description: eval() executes arbitrary Ruby code — code injection vector
+fixHint: Remove eval(); use a safe parser (e.g. JSON.parse, Integer()) or explicit case/when logic instead.
+rule:
+  kind: call
+  has:
+    kind: identifier
+    regex: '^eval$'

package/dist/patterns/library/dynamic-load-lua.yaml

@@ -0,0 +1,10 @@
+id: dynamic-load-lua
+language: lua
+severity: critical
+owaspCategory: A03
+description: load()/loadstring() executes arbitrary Lua code — code injection vector
+fixHint: Remove dynamic code loading; use explicit functions or a restricted sandbox. Never evaluate user-controlled strings.
+rule:
+  any:
+    - pattern: load($CODE)()
+    - pattern: loadstring($CODE)()

package/dist/patterns/library/os-cmd-elixir.yaml

@@ -0,0 +1,16 @@
+id: os-cmd-elixir
+language: elixir
+severity: critical
+owaspCategory: A03
+description: ':os.cmd() or System.cmd() with a variable argument — command injection vector'
+fixHint: "Use System.cmd/2 with a fixed executable and a list of validated arguments. Never interpolate user input into shell strings."
+rule:
+  any:
+    - kind: call
+      has:
+        kind: dot
+        regex: '^:os\.cmd'
+    - kind: call
+      has:
+        kind: dot
+        regex: '^System\.cmd'

package/dist/patterns/library/os-execute-lua.yaml

@@ -0,0 +1,10 @@
+id: os-execute-lua
+language: lua
+severity: critical
+owaspCategory: A03
+description: os.execute() or io.popen() with a variable argument — command injection vector
+fixHint: Avoid shell execution; use Lua native I/O functions. If unavoidable, validate and escape all arguments.
+rule:
+  any:
+    - pattern: os.execute($CMD)
+    - pattern: io.popen($CMD)

package/dist/patterns/library/path-traversal-go.yaml

@@ -5,7 +5,7 @@ owaspCategory: A01
 description: os.Open() or ioutil.ReadFile() with user-controlled path — path traversal vector
 fixHint: Use filepath.Clean() and verify the result is within an allowed base directory.
 rule:
-  any:
-    - pattern: os.Open($PATH)
-    - pattern: ioutil.ReadFile($PATH)
-    - pattern: os.ReadFile($PATH)
+  kind: call_expression
+  has:
+    kind: selector_expression
+    regex: '^(os\.Open|ioutil\.ReadFile|os\.ReadFile)$'

package/dist/patterns/library/process-launch-swift.yaml

@@ -0,0 +1,11 @@
+id: process-launch-swift
+language: swift
+severity: critical
+owaspCategory: A03
+description: Process.launch() — command injection vector if launchPath or arguments are user-controlled
+fixHint: Validate executableURL and all arguments against an allowlist before calling run(). Never set launchPath from user input.
+rule:
+  kind: call_expression
+  has:
+    kind: navigation_expression
+    regex: '\.launch$'

package/dist/patterns/library/process-run-dart.yaml

@@ -0,0 +1,15 @@
+id: process-run-dart
+language: dart
+severity: critical
+owaspCategory: A03
+description: Process.run() or Process.start() — command injection vector if arguments are user-controlled
+fixHint: Pass a fixed executable and a validated list of arguments. Never build arguments from unsanitised user input.
+rule:
+  kind: expression_statement
+  all:
+    - has:
+        kind: identifier
+        regex: '^Process$'
+    - has:
+        kind: selector
+        regex: '^\.run|^\.start'

package/dist/patterns/library/source-injection-bash.yaml

@@ -0,0 +1,11 @@
+id: source-injection-bash
+language: bash
+severity: high
+owaspCategory: A03
+description: source/. with a variable path — arbitrary script execution
+fixHint: Hardcode the script path or validate it against an allowlist before sourcing.
+rule:
+  kind: command
+  has:
+    kind: command_name
+    regex: '^(source|\.)$'

package/dist/patterns/library/sql-injection-dart.yaml

@@ -0,0 +1,9 @@
+id: sql-injection-dart
+language: dart
+severity: critical
+owaspCategory: A03
+description: SQL query built by string concatenation — SQL injection vector
+fixHint: Use parameterized queries with ? placeholder lists. Never concatenate user input into SQL strings.
+rule:
+  kind: additive_expression
+  regex: '(SELECT|INSERT|UPDATE|DELETE|UNION)'

package/dist/patterns/library/sql-injection-kotlin.yaml

@@ -0,0 +1,11 @@
+id: sql-injection-kotlin
+language: kotlin
+severity: critical
+owaspCategory: A03
+description: JDBC query built by string concatenation — SQL injection vector
+fixHint: Use PreparedStatement with ? placeholders. Never concatenate user input into SQL strings.
+rule:
+  any:
+    - pattern: µSTMT.executeQuery(µA + µB)
+    - pattern: µSTMT.execute(µA + µB)
+    - pattern: µSTMT.executeUpdate(µA + µB)

package/dist/patterns/library/sql-injection-php.yaml

@@ -0,0 +1,9 @@
+id: sql-injection-php
+language: php
+severity: critical
+owaspCategory: A03
+description: SQL query built by string concatenation (.) — SQL injection vector
+fixHint: Use PDO prepared statements with ? placeholders and bound parameters. Never concatenate user input into SQL.
+rule:
+  kind: binary_expression
+  regex: '(SELECT|INSERT|UPDATE|DELETE|UNION)'

package/dist/patterns/library/sql-injection-swift.yaml

@@ -0,0 +1,11 @@
+id: sql-injection-swift
+language: swift
+severity: critical
+owaspCategory: A03
+description: SQL query built by string concatenation — SQL injection vector
+fixHint: Use parameterized queries with ? placeholders. Never concatenate user input into SQL strings.
+rule:
+  any:
+    - pattern: µDB.execute(µA + µB)
+    - pattern: µDB.query(µA + µB)
+    - pattern: µDB.run(µA + µB)

package/dist/patterns/library/subshell-injection-ruby.yaml

@@ -0,0 +1,8 @@
+id: subshell-injection-ruby
+language: ruby
+severity: critical
+owaspCategory: A03
+description: Backtick or %x{} subshell execution — command injection vector
+fixHint: Replace subshell calls with Open3.capture2e using an argument array. Never interpolate user input into shell strings.
+rule:
+  kind: subshell

package/dist/patterns/library/unsafe-block-rust.yaml

@@ -0,0 +1,8 @@
+id: unsafe-block-rust
+language: rust
+severity: high
+owaspCategory: A04
+description: unsafe block — bypasses Rust memory-safety guarantees
+fixHint: Minimise unsafe surface; wrap raw pointer operations in a safe abstraction and document invariants.
+rule:
+  kind: unsafe_block

package/dist/patterns/library/unsafe-string-c.yaml

@@ -0,0 +1,11 @@
+id: unsafe-string-c
+language: [c, cpp]
+severity: high
+owaspCategory: A04
+description: Unsafe C string function (strcpy/strcat/gets/sprintf) — buffer overflow vector
+fixHint: Use strncpy/strncat/fgets/snprintf with explicit size limits. Prefer bounded alternatives everywhere.
+rule:
+  kind: call_expression
+  has:
+    kind: identifier
+    regex: '^(strcpy|strcat|gets|sprintf|vsprintf)$'