@stackmemoryai/stackmemory 0.3.1 → 0.3.5

package/dist/core/skills/skill-storage.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/core/skills/skill-storage.ts"],
+  "sourcesContent": ["/**\n * Skill Storage Service\n * Redis-backed persistent storage for agent learnings and skills\n * All skills are namespaced by userId for multi-user support\n */\n\nimport 'dotenv/config';\nimport Redis from 'ioredis';\nimport { v4 as uuidv4 } from 'uuid';\nimport { logger } from '../monitoring/logger.js';\nimport {\n  Skill,\n  CreateSkillInput,\n  UpdateSkillInput,\n  SkillQuery,\n  JournalEntry,\n  JournalEntryType,\n  SessionSummary,\n  SkillCategory,\n  SkillPriority,\n  REDIS_KEYS,\n  CACHE_TTL,\n  calculateSkillTTL,\n  SkillSchema,\n  JournalEntrySchema,\n} from './types.js';\n\nexport interface SkillStorageConfig {\n  redisUrl: string;\n  userId: string; // Required: user namespace for skills\n  keyPrefix?: string;\n  enableMetrics?: boolean;\n}\n\nexport interface SkillStorageMetrics {\n  userId: string;\n  skillsTotal: number;\n  skillsByCategory: Record<SkillCategory, number>;\n  journalEntriesTotal: number;\n  sessionsTracked: number;\n  cacheHits: number;\n  cacheMisses: number;\n}\n\nexport class SkillStorageService {\n  private redis: Redis;\n  private userId: string;\n  private keyPrefix: string;\n  private enableMetrics: boolean;\n\n  // Metrics tracking\n  private metrics = {\n    cacheHits: 0,\n    cacheMisses: 0,\n  };\n\n  constructor(config: SkillStorageConfig) {\n    this.redis = new Redis(config.redisUrl);\n    this.userId = config.userId;\n    this.keyPrefix = config.keyPrefix || 'sm:skills';\n    this.enableMetrics = config.enableMetrics ?? true;\n\n    this.redis.on('error', (err) => {\n      logger.error('Redis connection error in SkillStorage', err);\n    });\n\n    this.redis.on('connect', () => {\n      logger.info('SkillStorage connected to Redis');\n    });\n\n    logger.info('SkillStorageService initialized', {\n      userId: this.userId,\n      keyPrefix: this.keyPrefix,\n      enableMetrics: this.enableMetrics,\n    });\n  }\n\n  private key(pattern: string): string {\n    return `${this.keyPrefix}:${pattern}`;\n  }\n\n  /**\n   * Get the current user ID\n   */\n  getUserId(): string {\n    return this.userId;\n  }\n\n  // ============================================================\n  // SKILL CRUD OPERATIONS\n  // ============================================================\n\n  /**\n   * Create a new skill\n   */\n  async createSkill(input: CreateSkillInput): Promise<Skill> {\n    const now = new Date().toISOString();\n    const skill: Skill = {\n      ...input,\n      id: uuidv4(),\n      createdAt: now,\n      updatedAt: now,\n      validatedCount: 0,\n    };\n\n    // Validate\n    SkillSchema.parse(skill);\n\n    const pipeline = this.redis.pipeline();\n    const skillKey = this.key(REDIS_KEYS.skill(this.userId, skill.id));\n\n    // Store skill\n    pipeline.setex(\n      skillKey,\n      calculateSkillTTL(skill.validatedCount),\n      JSON.stringify(skill)\n    );\n\n    // Index by tool\n    if (skill.tool) {\n      pipeline.zadd(\n        this.key(REDIS_KEYS.skillsByTool(this.userId, skill.tool)),\n        Date.now(),\n        skill.id\n      );\n    }\n\n    // Index by category\n    pipeline.zadd(\n      this.key(REDIS_KEYS.skillsByCategory(this.userId, skill.category)),\n      this.priorityScore(skill.priority),\n      skill.id\n    );\n\n    // Index by tags\n    for (const tag of skill.tags) {\n      pipeline.zadd(\n        this.key(REDIS_KEYS.skillsByTag(this.userId, tag)),\n        Date.now(),\n        skill.id\n      );\n    }\n\n    // Add to recent skills\n    pipeline.zadd(\n      this.key(REDIS_KEYS.skillsRecent(this.userId)),\n      Date.now(),\n      skill.id\n    );\n    pipeline.zremrangebyrank(\n      this.key(REDIS_KEYS.skillsRecent(this.userId)),\n      0,\n      -1001\n    ); // Keep last 1000\n\n    await pipeline.exec();\n\n    logger.info('Created skill', {\n      userId: this.userId,\n      id: skill.id,\n      category: skill.category,\n      tool: skill.tool,\n    });\n\n    return skill;\n  }\n\n  /**\n   * Get skill by ID\n   */\n  async getSkill(id: string): Promise<Skill | null> {\n    const skillKey = this.key(REDIS_KEYS.skill(this.userId, id));\n    const data = await this.redis.get(skillKey);\n\n    if (!data) {\n      this.metrics.cacheMisses++;\n      return null;\n    }\n\n    this.metrics.cacheHits++;\n    return JSON.parse(data) as Skill;\n  }\n\n  /**\n   * Update an existing skill\n   */\n  async updateSkill(input: UpdateSkillInput): Promise<Skill | null> {\n    const existing = await this.getSkill(input.id);\n    if (!existing) {\n      return null;\n    }\n\n    const updated: Skill = {\n      ...existing,\n      ...input,\n      updatedAt: new Date().toISOString(),\n    };\n\n    // Validate\n    SkillSchema.parse(updated);\n\n    const skillKey = this.key(REDIS_KEYS.skill(this.userId, updated.id));\n    await this.redis.setex(\n      skillKey,\n      calculateSkillTTL(updated.validatedCount),\n      JSON.stringify(updated)\n    );\n\n    logger.info('Updated skill', { userId: this.userId, id: updated.id });\n\n    return updated;\n  }\n\n  /**\n   * Validate a skill (increment validation count)\n   */\n  async validateSkill(id: string): Promise<Skill | null> {\n    const skill = await this.getSkill(id);\n    if (!skill) {\n      return null;\n    }\n\n    skill.validatedCount++;\n    skill.lastValidated = new Date().toISOString();\n    skill.updatedAt = new Date().toISOString();\n\n    const skillKey = this.key(REDIS_KEYS.skill(this.userId, id));\n    // TTL increases with validation count: 7 days base + 7 days per validation, max 90 days\n    await this.redis.setex(\n      skillKey,\n      calculateSkillTTL(skill.validatedCount),\n      JSON.stringify(skill)\n    );\n\n    // Update validated index\n    await this.redis.zadd(\n      this.key(REDIS_KEYS.skillsValidated(this.userId)),\n      skill.validatedCount,\n      id\n    );\n\n    // Check for promotion eligibility\n    if (skill.validatedCount >= 3 && skill.priority !== 'critical') {\n      await this.redis.sadd(\n        this.key(REDIS_KEYS.promotionCandidates(this.userId)),\n        id\n      );\n    }\n\n    logger.info('Validated skill', {\n      userId: this.userId,\n      id,\n      validatedCount: skill.validatedCount,\n    });\n\n    return skill;\n  }\n\n  /**\n   * Delete a skill\n   */\n  async deleteSkill(id: string): Promise<boolean> {\n    const skill = await this.getSkill(id);\n    if (!skill) {\n      return false;\n    }\n\n    const pipeline = this.redis.pipeline();\n    const skillKey = this.key(REDIS_KEYS.skill(this.userId, id));\n\n    // Remove skill\n    pipeline.del(skillKey);\n\n    // Remove from indexes\n    if (skill.tool) {\n      pipeline.zrem(\n        this.key(REDIS_KEYS.skillsByTool(this.userId, skill.tool)),\n        id\n      );\n    }\n\n    pipeline.zrem(\n      this.key(REDIS_KEYS.skillsByCategory(this.userId, skill.category)),\n      id\n    );\n\n    for (const tag of skill.tags) {\n      pipeline.zrem(this.key(REDIS_KEYS.skillsByTag(this.userId, tag)), id);\n    }\n\n    pipeline.zrem(this.key(REDIS_KEYS.skillsRecent(this.userId)), id);\n    pipeline.zrem(this.key(REDIS_KEYS.skillsValidated(this.userId)), id);\n    pipeline.srem(this.key(REDIS_KEYS.promotionCandidates(this.userId)), id);\n\n    await pipeline.exec();\n\n    logger.info('Deleted skill', { userId: this.userId, id });\n\n    return true;\n  }\n\n  // ============================================================\n  // SKILL QUERIES\n  // ============================================================\n\n  /**\n   * Query skills with filters\n   */\n  async querySkills(query: SkillQuery): Promise<Skill[]> {\n    let skillIds: string[] = [];\n\n    // Determine which index to use\n    if (query.tool) {\n      skillIds = await this.redis.zrevrange(\n        this.key(REDIS_KEYS.skillsByTool(this.userId, query.tool)),\n        0,\n        -1\n      );\n    } else if (query.categories && query.categories.length === 1) {\n      skillIds = await this.redis.zrevrange(\n        this.key(REDIS_KEYS.skillsByCategory(this.userId, query.categories[0])),\n        0,\n        -1\n      );\n    } else if (query.tags && query.tags.length === 1) {\n      skillIds = await this.redis.zrevrange(\n        this.key(REDIS_KEYS.skillsByTag(this.userId, query.tags[0])),\n        0,\n        -1\n      );\n    } else {\n      // Default to recent skills\n      skillIds = await this.redis.zrevrange(\n        this.key(REDIS_KEYS.skillsRecent(this.userId)),\n        0,\n        query.limit + query.offset\n      );\n    }\n\n    if (skillIds.length === 0) {\n      return [];\n    }\n\n    // Fetch skills\n    const pipeline = this.redis.pipeline();\n    for (const id of skillIds) {\n      pipeline.get(this.key(REDIS_KEYS.skill(this.userId, id)));\n    }\n\n    const results = await pipeline.exec();\n    if (!results) {\n      return [];\n    }\n\n    let skills: Skill[] = results\n      .map(([err, data]) => {\n        if (err || !data) return null;\n        try {\n          return JSON.parse(data as string) as Skill;\n        } catch {\n          return null;\n        }\n      })\n      .filter((s): s is Skill => s !== null);\n\n    // Apply additional filters\n    if (query.categories && query.categories.length > 0) {\n      skills = skills.filter((s) => query.categories!.includes(s.category));\n    }\n\n    if (query.priorities && query.priorities.length > 0) {\n      skills = skills.filter((s) => query.priorities!.includes(s.priority));\n    }\n\n    if (query.minValidatedCount !== undefined) {\n      skills = skills.filter(\n        (s) => s.validatedCount >= query.minValidatedCount!\n      );\n    }\n\n    if (query.language) {\n      skills = skills.filter((s) => s.language === query.language);\n    }\n\n    if (query.framework) {\n      skills = skills.filter((s) => s.framework === query.framework);\n    }\n\n    // Sort\n    skills.sort((a, b) => {\n      let aVal: number, bVal: number;\n\n      switch (query.sortBy) {\n        case 'priority':\n          aVal = this.priorityScore(a.priority);\n          bVal = this.priorityScore(b.priority);\n          break;\n        case 'validatedCount':\n          aVal = a.validatedCount;\n          bVal = b.validatedCount;\n          break;\n        case 'createdAt':\n          aVal = new Date(a.createdAt).getTime();\n          bVal = new Date(b.createdAt).getTime();\n          break;\n        case 'updatedAt':\n          aVal = new Date(a.updatedAt).getTime();\n          bVal = new Date(b.updatedAt).getTime();\n          break;\n        default:\n          aVal = this.priorityScore(a.priority);\n          bVal = this.priorityScore(b.priority);\n      }\n\n      return query.sortOrder === 'desc' ? bVal - aVal : aVal - bVal;\n    });\n\n    // Apply pagination\n    return skills.slice(query.offset, query.offset + query.limit);\n  }\n\n  /**\n   * Get skills relevant to current context\n   */\n  async getRelevantSkills(context: {\n    tool?: string;\n    language?: string;\n    framework?: string;\n    tags?: string[];\n  }): Promise<Skill[]> {\n    const skills: Skill[] = [];\n    const seenIds = new Set<string>();\n\n    // Always include critical skills\n    const criticalIds = await this.redis.zrevrange(\n      this.key(REDIS_KEYS.skillsByCategory(this.userId, 'correction')),\n      0,\n      -1\n    );\n\n    for (const id of criticalIds) {\n      const skill = await this.getSkill(id);\n      if (skill && skill.priority === 'critical' && !seenIds.has(id)) {\n        skills.push(skill);\n        seenIds.add(id);\n      }\n    }\n\n    // Get tool-specific skills\n    if (context.tool) {\n      const toolSkills = await this.querySkills({\n        tool: context.tool,\n        limit: 20,\n        offset: 0,\n        sortBy: 'priority',\n        sortOrder: 'desc',\n      });\n\n      for (const skill of toolSkills) {\n        if (!seenIds.has(skill.id)) {\n          skills.push(skill);\n          seenIds.add(skill.id);\n        }\n      }\n    }\n\n    // Get highly validated skills\n    const validatedIds = await this.redis.zrevrange(\n      this.key(REDIS_KEYS.skillsValidated(this.userId)),\n      0,\n      10\n    );\n\n    for (const id of validatedIds) {\n      if (!seenIds.has(id)) {\n        const skill = await this.getSkill(id);\n        if (skill) {\n          skills.push(skill);\n          seenIds.add(id);\n        }\n      }\n    }\n\n    return skills.slice(0, 50); // Cap at 50 skills\n  }\n\n  // ============================================================\n  // SESSION JOURNAL\n  // ============================================================\n\n  /**\n   * Create a journal entry\n   */\n  async createJournalEntry(\n    sessionId: string,\n    type: JournalEntryType,\n    title: string,\n    content: string,\n    context?: JournalEntry['context']\n  ): Promise<JournalEntry> {\n    const entry: JournalEntry = {\n      id: uuidv4(),\n      sessionId,\n      type,\n      title,\n      content,\n      context,\n      createdAt: new Date().toISOString(),\n    };\n\n    // Validate\n    JournalEntrySchema.parse(entry);\n\n    const pipeline = this.redis.pipeline();\n\n    // Store entry\n    pipeline.setex(\n      this.key(REDIS_KEYS.journalEntry(this.userId, entry.id)),\n      CACHE_TTL.journal,\n      JSON.stringify(entry)\n    );\n\n    // Index by session\n    pipeline.zadd(\n      this.key(REDIS_KEYS.journalSession(this.userId, sessionId)),\n      Date.now(),\n      entry.id\n    );\n\n    // Add to recent journal\n    pipeline.zadd(\n      this.key(REDIS_KEYS.journalRecent(this.userId)),\n      Date.now(),\n      entry.id\n    );\n    pipeline.zremrangebyrank(\n      this.key(REDIS_KEYS.journalRecent(this.userId)),\n      0,\n      -501\n    ); // Keep last 500\n\n    await pipeline.exec();\n\n    logger.info('Created journal entry', {\n      userId: this.userId,\n      id: entry.id,\n      sessionId,\n      type,\n      title,\n    });\n\n    return entry;\n  }\n\n  /**\n   * Get journal entries for a session\n   */\n  async getSessionJournal(sessionId: string): Promise<JournalEntry[]> {\n    const entryIds = await this.redis.zrevrange(\n      this.key(REDIS_KEYS.journalSession(this.userId, sessionId)),\n      0,\n      -1\n    );\n\n    if (entryIds.length === 0) {\n      return [];\n    }\n\n    const pipeline = this.redis.pipeline();\n    for (const id of entryIds) {\n      pipeline.get(this.key(REDIS_KEYS.journalEntry(this.userId, id)));\n    }\n\n    const results = await pipeline.exec();\n    if (!results) {\n      return [];\n    }\n\n    return results\n      .map(([err, data]) => {\n        if (err || !data) return null;\n        try {\n          return JSON.parse(data as string) as JournalEntry;\n        } catch {\n          return null;\n        }\n      })\n      .filter((e): e is JournalEntry => e !== null);\n  }\n\n  /**\n   * Promote a journal entry to a skill\n   */\n  async promoteToSkill(\n    entryId: string,\n    category: SkillCategory,\n    priority: SkillPriority = 'medium'\n  ): Promise<Skill | null> {\n    const entryData = await this.redis.get(\n      this.key(REDIS_KEYS.journalEntry(this.userId, entryId))\n    );\n\n    if (!entryData) {\n      return null;\n    }\n\n    const entry = JSON.parse(entryData) as JournalEntry;\n\n    const skill = await this.createSkill({\n      content: entry.content,\n      summary: entry.title,\n      category,\n      priority,\n      tags: [],\n      tool: entry.context?.tool,\n      source: 'observation',\n      sessionId: entry.sessionId,\n    });\n\n    // Update entry with promotion reference\n    entry.promotedToSkillId = skill.id;\n    await this.redis.setex(\n      this.key(REDIS_KEYS.journalEntry(this.userId, entryId)),\n      CACHE_TTL.journal,\n      JSON.stringify(entry)\n    );\n\n    logger.info('Promoted journal entry to skill', {\n      userId: this.userId,\n      entryId,\n      skillId: skill.id,\n    });\n\n    return skill;\n  }\n\n  // ============================================================\n  // SESSION MANAGEMENT\n  // ============================================================\n\n  /**\n   * Start tracking a new session\n   */\n  async startSession(sessionId: string): Promise<void> {\n    const summary: SessionSummary = {\n      sessionId,\n      startedAt: new Date().toISOString(),\n      entriesCount: 0,\n      correctionsCount: 0,\n      decisionsCount: 0,\n      keyLearnings: [],\n      promotedSkillIds: [],\n    };\n\n    await this.redis.setex(\n      this.key(REDIS_KEYS.sessionSummary(this.userId, sessionId)),\n      CACHE_TTL.session,\n      JSON.stringify(summary)\n    );\n\n    await this.redis.sadd(\n      this.key(REDIS_KEYS.sessionsActive(this.userId)),\n      sessionId\n    );\n\n    logger.info('Started session tracking', { userId: this.userId, sessionId });\n  }\n\n  /**\n   * End a session and generate summary\n   */\n  async endSession(sessionId: string): Promise<SessionSummary | null> {\n    const summaryData = await this.redis.get(\n      this.key(REDIS_KEYS.sessionSummary(this.userId, sessionId))\n    );\n\n    if (!summaryData) {\n      return null;\n    }\n\n    const summary = JSON.parse(summaryData) as SessionSummary;\n    summary.endedAt = new Date().toISOString();\n\n    // Count entries by type\n    const entries = await this.getSessionJournal(sessionId);\n    summary.entriesCount = entries.length;\n    summary.correctionsCount = entries.filter(\n      (e) => e.type === 'correction'\n    ).length;\n    summary.decisionsCount = entries.filter(\n      (e) => e.type === 'decision'\n    ).length;\n\n    // Extract key learnings\n    summary.keyLearnings = entries\n      .filter((e) => e.type === 'correction' || e.type === 'resolution')\n      .slice(0, 5)\n      .map((e) => e.title);\n\n    // Get promoted skills\n    summary.promotedSkillIds = entries\n      .filter((e) => e.promotedToSkillId)\n      .map((e) => e.promotedToSkillId!);\n\n    await this.redis.setex(\n      this.key(REDIS_KEYS.sessionSummary(this.userId, sessionId)),\n      CACHE_TTL.session,\n      JSON.stringify(summary)\n    );\n\n    await this.redis.srem(\n      this.key(REDIS_KEYS.sessionsActive(this.userId)),\n      sessionId\n    );\n\n    logger.info('Ended session', {\n      userId: this.userId,\n      sessionId,\n      entriesCount: summary.entriesCount,\n      keyLearnings: summary.keyLearnings.length,\n    });\n\n    return summary;\n  }\n\n  /**\n   * Get session summary\n   */\n  async getSessionSummary(sessionId: string): Promise<SessionSummary | null> {\n    const data = await this.redis.get(\n      this.key(REDIS_KEYS.sessionSummary(this.userId, sessionId))\n    );\n\n    if (!data) {\n      return null;\n    }\n\n    return JSON.parse(data) as SessionSummary;\n  }\n\n  // ============================================================\n  // KNOWLEDGE HYGIENE\n  // ============================================================\n\n  /**\n   * Get skills eligible for promotion\n   */\n  async getPromotionCandidates(): Promise<Skill[]> {\n    const ids = await this.redis.smembers(\n      this.key(REDIS_KEYS.promotionCandidates(this.userId))\n    );\n\n    const skills: Skill[] = [];\n    for (const id of ids) {\n      const skill = await this.getSkill(id);\n      if (skill && skill.validatedCount >= 3) {\n        skills.push(skill);\n      }\n    }\n\n    return skills;\n  }\n\n  /**\n   * Promote a skill (increase priority)\n   */\n  async promoteSkill(id: string): Promise<Skill | null> {\n    const skill = await this.getSkill(id);\n    if (!skill) {\n      return null;\n    }\n\n    const priorityOrder: SkillPriority[] = [\n      'low',\n      'medium',\n      'high',\n      'critical',\n    ];\n    const currentIndex = priorityOrder.indexOf(skill.priority);\n\n    if (currentIndex < priorityOrder.length - 1) {\n      skill.priority = priorityOrder[currentIndex + 1];\n      skill.updatedAt = new Date().toISOString();\n\n      await this.redis.setex(\n        this.key(REDIS_KEYS.skill(this.userId, id)),\n        calculateSkillTTL(skill.validatedCount),\n        JSON.stringify(skill)\n      );\n\n      // Update category index with new score\n      await this.redis.zadd(\n        this.key(REDIS_KEYS.skillsByCategory(this.userId, skill.category)),\n        this.priorityScore(skill.priority),\n        id\n      );\n\n      // Remove from promotion candidates if now critical\n      if (skill.priority === 'critical') {\n        await this.redis.srem(\n          this.key(REDIS_KEYS.promotionCandidates(this.userId)),\n          id\n        );\n      }\n\n      logger.info('Promoted skill', {\n        userId: this.userId,\n        id,\n        newPriority: skill.priority,\n      });\n    }\n\n    return skill;\n  }\n\n  /**\n   * Archive stale skills (not validated in 90 days)\n   */\n  async archiveStaleSkills(daysThreshold: number = 90): Promise<number> {\n    const cutoff = Date.now() - daysThreshold * 24 * 60 * 60 * 1000;\n    let archivedCount = 0;\n\n    // Get all recent skills\n    const skillIds = await this.redis.zrangebyscore(\n      this.key(REDIS_KEYS.skillsRecent(this.userId)),\n      0,\n      cutoff\n    );\n\n    for (const id of skillIds) {\n      const skill = await this.getSkill(id);\n      if (skill && skill.priority !== 'critical') {\n        // Check if it was validated recently\n        if (\n          !skill.lastValidated ||\n          new Date(skill.lastValidated).getTime() < cutoff\n        ) {\n          // Downgrade to low priority instead of deleting\n          if (skill.priority !== 'low') {\n            skill.priority = 'low';\n            skill.updatedAt = new Date().toISOString();\n            await this.redis.setex(\n              this.key(REDIS_KEYS.skill(this.userId, id)),\n              calculateSkillTTL(skill.validatedCount),\n              JSON.stringify(skill)\n            );\n            archivedCount++;\n          }\n        }\n      }\n    }\n\n    logger.info('Archived stale skills', {\n      userId: this.userId,\n      archivedCount,\n      daysThreshold,\n    });\n\n    return archivedCount;\n  }\n\n  // ============================================================\n  // METRICS & UTILITIES\n  // ============================================================\n\n  /**\n   * Get storage metrics\n   */\n  async getMetrics(): Promise<SkillStorageMetrics> {\n    const [\n      skillsTotal,\n      toolSkills,\n      workflowSkills,\n      correctionSkills,\n      patternSkills,\n      preferenceSkills,\n      pitfallSkills,\n      optimizationSkills,\n      journalTotal,\n      sessionsActive,\n    ] = await Promise.all([\n      this.redis.zcard(this.key(REDIS_KEYS.skillsRecent(this.userId))),\n      this.redis.zcard(\n        this.key(REDIS_KEYS.skillsByCategory(this.userId, 'tool'))\n      ),\n      this.redis.zcard(\n        this.key(REDIS_KEYS.skillsByCategory(this.userId, 'workflow'))\n      ),\n      this.redis.zcard(\n        this.key(REDIS_KEYS.skillsByCategory(this.userId, 'correction'))\n      ),\n      this.redis.zcard(\n        this.key(REDIS_KEYS.skillsByCategory(this.userId, 'pattern'))\n      ),\n      this.redis.zcard(\n        this.key(REDIS_KEYS.skillsByCategory(this.userId, 'preference'))\n      ),\n      this.redis.zcard(\n        this.key(REDIS_KEYS.skillsByCategory(this.userId, 'pitfall'))\n      ),\n      this.redis.zcard(\n        this.key(REDIS_KEYS.skillsByCategory(this.userId, 'optimization'))\n      ),\n      this.redis.zcard(this.key(REDIS_KEYS.journalRecent(this.userId))),\n      this.redis.scard(this.key(REDIS_KEYS.sessionsActive(this.userId))),\n    ]);\n\n    return {\n      userId: this.userId,\n      skillsTotal,\n      skillsByCategory: {\n        tool: toolSkills,\n        workflow: workflowSkills,\n        correction: correctionSkills,\n        pattern: patternSkills,\n        preference: preferenceSkills,\n        pitfall: pitfallSkills,\n        optimization: optimizationSkills,\n      },\n      journalEntriesTotal: journalTotal,\n      sessionsTracked: sessionsActive,\n      cacheHits: this.metrics.cacheHits,\n      cacheMisses: this.metrics.cacheMisses,\n    };\n  }\n\n  /**\n   * Priority to numeric score for sorting\n   */\n  private priorityScore(priority: SkillPriority): number {\n    const scores: Record<SkillPriority, number> = {\n      critical: 1000,\n      high: 100,\n      medium: 10,\n      low: 1,\n    };\n    return scores[priority];\n  }\n\n  /**\n   * Close Redis connection\n   */\n  async close(): Promise<void> {\n    await this.redis.quit();\n    logger.info('SkillStorageService closed');\n  }\n}\n\n// ============================================================\n// SINGLETON INSTANCES (per user)\n// ============================================================\n\nconst userStorageInstances = new Map<string, SkillStorageService>();\n\n/**\n * Get or create skill storage instance for a user\n */\nexport function getSkillStorage(\n  config: SkillStorageConfig\n): SkillStorageService {\n  const existing = userStorageInstances.get(config.userId);\n  if (existing) {\n    return existing;\n  }\n\n  const instance = new SkillStorageService(config);\n  userStorageInstances.set(config.userId, instance);\n  return instance;\n}\n\n/**\n * Initialize skill storage with Redis URL from environment\n */\nexport function initializeSkillStorage(\n  userId: string,\n  redisUrl?: string\n): SkillStorageService {\n  const url = redisUrl || process.env.REDIS_URL;\n\n  if (!url) {\n    throw new Error('REDIS_URL environment variable not set');\n  }\n\n  return getSkillStorage({ redisUrl: url, userId });\n}\n\n/**\n * Get default user ID from environment or generate one\n */\nexport function getDefaultUserId(): string {\n  return (\n    process.env.STACKMEMORY_USER_ID ||\n    process.env.USER ||\n    process.env.USERNAME ||\n    'default'\n  );\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/core/skills/types.js

@@ -0,0 +1,189 @@
+import { z } from "zod";
+const SkillCategorySchema = z.enum([
+  "tool",
+  // Tool-specific patterns
+  "workflow",
+  // Process/workflow improvements
+  "correction",
+  // User corrections to remember
+  "pattern",
+  // Code/architecture patterns
+  "preference",
+  // User preferences
+  "pitfall",
+  // Things to avoid
+  "optimization"
+  // Performance/efficiency tips
+]);
+const SkillPrioritySchema = z.enum([
+  "critical",
+  // Always include in context
+  "high",
+  // Include when relevant
+  "medium",
+  // Include if space permits
+  "low"
+  // Archive/reference only
+]);
+const SkillSchema = z.object({
+  id: z.string().uuid(),
+  // Content
+  content: z.string().min(1).max(5e3),
+  summary: z.string().max(500).optional(),
+  // Classification
+  category: SkillCategorySchema,
+  priority: SkillPrioritySchema.default("medium"),
+  tags: z.array(z.string()).default([]),
+  // Context
+  tool: z.string().optional(),
+  // Related tool name
+  project: z.string().optional(),
+  // Project context
+  language: z.string().optional(),
+  // Programming language
+  framework: z.string().optional(),
+  // Framework context
+  // Validation tracking
+  validatedCount: z.number().int().min(0).default(0),
+  lastValidated: z.string().datetime().optional(),
+  // Lifecycle
+  createdAt: z.string().datetime(),
+  updatedAt: z.string().datetime(),
+  expiresAt: z.string().datetime().optional(),
+  // Source tracking
+  source: z.enum(["correction", "observation", "explicit", "inferred"]),
+  sessionId: z.string().optional()
+});
+const CreateSkillSchema = SkillSchema.omit({
+  id: true,
+  createdAt: true,
+  updatedAt: true,
+  validatedCount: true
+});
+const UpdateSkillSchema = SkillSchema.partial().extend({
+  id: z.string().uuid()
+});
+const JournalEntryTypeSchema = z.enum([
+  "decision",
+  // Architectural/design decision
+  "correction",
+  // User corrected agent behavior
+  "blocker",
+  // Issue encountered
+  "resolution",
+  // How an issue was resolved
+  "observation",
+  // Noticed pattern or behavior
+  "outcome"
+  // Result of an action
+]);
+const JournalEntrySchema = z.object({
+  id: z.string().uuid(),
+  sessionId: z.string(),
+  type: JournalEntryTypeSchema,
+  // Content
+  title: z.string().max(200),
+  content: z.string().max(5e3),
+  // Context
+  context: z.object({
+    file: z.string().optional(),
+    tool: z.string().optional(),
+    command: z.string().optional()
+  }).optional(),
+  // Outcome tracking
+  outcome: z.enum(["success", "failure", "partial", "pending"]).optional(),
+  // Timestamps
+  createdAt: z.string().datetime(),
+  // Link to promoted skill
+  promotedToSkillId: z.string().uuid().optional()
+});
+const SessionSummarySchema = z.object({
+  sessionId: z.string(),
+  startedAt: z.string().datetime(),
+  endedAt: z.string().datetime().optional(),
+  // Stats
+  entriesCount: z.number().int().min(0),
+  correctionsCount: z.number().int().min(0),
+  decisionsCount: z.number().int().min(0),
+  // Key learnings from this session
+  keyLearnings: z.array(z.string()).default([]),
+  // Skills promoted from this session
+  promotedSkillIds: z.array(z.string().uuid()).default([])
+});
+const SkillQuerySchema = z.object({
+  // Filter by classification
+  categories: z.array(SkillCategorySchema).optional(),
+  priorities: z.array(SkillPrioritySchema).optional(),
+  tags: z.array(z.string()).optional(),
+  // Filter by context
+  tool: z.string().optional(),
+  project: z.string().optional(),
+  language: z.string().optional(),
+  framework: z.string().optional(),
+  // Filter by validation
+  minValidatedCount: z.number().int().min(0).optional(),
+  // Pagination
+  limit: z.number().int().min(1).max(100).default(50),
+  offset: z.number().int().min(0).default(0),
+  // Sorting
+  sortBy: z.enum(["priority", "validatedCount", "createdAt", "updatedAt"]).default("priority"),
+  sortOrder: z.enum(["asc", "desc"]).default("desc")
+});
+const REDIS_KEYS = {
+  // Skills (namespaced by user)
+  skill: (userId, id) => `user:${userId}:skill:${id}`,
+  skillsByTool: (userId, tool) => `user:${userId}:skills:tool:${tool}`,
+  skillsByCategory: (userId, category) => `user:${userId}:skills:category:${category}`,
+  skillsByTag: (userId, tag) => `user:${userId}:skills:tag:${tag}`,
+  skillsRecent: (userId) => `user:${userId}:skills:recent`,
+  skillsValidated: (userId) => `user:${userId}:skills:validated`,
+  // Session journal (namespaced by user)
+  journalEntry: (userId, id) => `user:${userId}:journal:entry:${id}`,
+  journalSession: (userId, sessionId) => `user:${userId}:journal:session:${sessionId}`,
+  journalRecent: (userId) => `user:${userId}:journal:recent`,
+  // Session tracking (namespaced by user)
+  sessionSummary: (userId, sessionId) => `user:${userId}:session:summary:${sessionId}`,
+  sessionsActive: (userId) => `user:${userId}:sessions:active`,
+  // Promotion tracking (namespaced by user)
+  promotionCandidates: (userId) => `user:${userId}:skills:promotion:candidates`,
+  // Locks (global)
+  syncLock: (resource) => `lock:skill:${resource}`
+};
+const CACHE_TTL = {
+  // Base skill TTL: 7 days minimum
+  skillBase: 604800,
+  // 7 days
+  // Max skill TTL: 90 days for frequently used skills
+  skillMax: 7776e3,
+  // 90 days
+  // TTL increment per validation/use: +7 days
+  skillIncrement: 604800,
+  // 7 days
+  skillIndex: 86400,
+  // 1 day (was 1 hour)
+  session: 604800,
+  // 7 days
+  journal: 2592e3,
+  // 30 days
+  lock: 30
+  // 30 seconds
+};
+function calculateSkillTTL(validatedCount) {
+  const ttl = CACHE_TTL.skillBase + validatedCount * CACHE_TTL.skillIncrement;
+  return Math.min(ttl, CACHE_TTL.skillMax);
+}
+export {
+  CACHE_TTL,
+  CreateSkillSchema,
+  JournalEntrySchema,
+  JournalEntryTypeSchema,
+  REDIS_KEYS,
+  SessionSummarySchema,
+  SkillCategorySchema,
+  SkillPrioritySchema,
+  SkillQuerySchema,
+  SkillSchema,
+  UpdateSkillSchema,
+  calculateSkillTTL
+};
+//# sourceMappingURL=types.js.map

package/dist/core/skills/types.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/core/skills/types.ts"],
+  "sourcesContent": ["/**\n * Skill Storage Types\n * Types for persistent agent learning and skill memory\n */\n\nimport { z } from 'zod';\n\n// ============================================================\n// SKILL SCHEMAS\n// ============================================================\n\n/**\n * Skill category for organization\n */\nexport const SkillCategorySchema = z.enum([\n  'tool', // Tool-specific patterns\n  'workflow', // Process/workflow improvements\n  'correction', // User corrections to remember\n  'pattern', // Code/architecture patterns\n  'preference', // User preferences\n  'pitfall', // Things to avoid\n  'optimization', // Performance/efficiency tips\n]);\n\nexport type SkillCategory = z.infer<typeof SkillCategorySchema>;\n\n/**\n * Skill priority for retrieval ordering\n */\nexport const SkillPrioritySchema = z.enum([\n  'critical', // Always include in context\n  'high', // Include when relevant\n  'medium', // Include if space permits\n  'low', // Archive/reference only\n]);\n\nexport type SkillPriority = z.infer<typeof SkillPrioritySchema>;\n\n/**\n * Individual skill/learning entry\n */\nexport const SkillSchema = z.object({\n  id: z.string().uuid(),\n\n  // Content\n  content: z.string().min(1).max(5000),\n  summary: z.string().max(500).optional(),\n\n  // Classification\n  category: SkillCategorySchema,\n  priority: SkillPrioritySchema.default('medium'),\n  tags: z.array(z.string()).default([]),\n\n  // Context\n  tool: z.string().optional(), // Related tool name\n  project: z.string().optional(), // Project context\n  language: z.string().optional(), // Programming language\n  framework: z.string().optional(), // Framework context\n\n  // Validation tracking\n  validatedCount: z.number().int().min(0).default(0),\n  lastValidated: z.string().datetime().optional(),\n\n  // Lifecycle\n  createdAt: z.string().datetime(),\n  updatedAt: z.string().datetime(),\n  expiresAt: z.string().datetime().optional(),\n\n  // Source tracking\n  source: z.enum(['correction', 'observation', 'explicit', 'inferred']),\n  sessionId: z.string().optional(),\n});\n\nexport type Skill = z.infer<typeof SkillSchema>;\n\n/**\n * Skill creation input\n */\nexport const CreateSkillSchema = SkillSchema.omit({\n  id: true,\n  createdAt: true,\n  updatedAt: true,\n  validatedCount: true,\n});\n\nexport type CreateSkillInput = z.infer<typeof CreateSkillSchema>;\n\n/**\n * Skill update input\n */\nexport const UpdateSkillSchema = SkillSchema.partial().extend({\n  id: z.string().uuid(),\n});\n\nexport type UpdateSkillInput = z.infer<typeof UpdateSkillSchema>;\n\n// ============================================================\n// SESSION JOURNAL SCHEMAS\n// ============================================================\n\n/**\n * Session journal entry type\n */\nexport const JournalEntryTypeSchema = z.enum([\n  'decision', // Architectural/design decision\n  'correction', // User corrected agent behavior\n  'blocker', // Issue encountered\n  'resolution', // How an issue was resolved\n  'observation', // Noticed pattern or behavior\n  'outcome', // Result of an action\n]);\n\nexport type JournalEntryType = z.infer<typeof JournalEntryTypeSchema>;\n\n/**\n * Session journal entry\n */\nexport const JournalEntrySchema = z.object({\n  id: z.string().uuid(),\n  sessionId: z.string(),\n  type: JournalEntryTypeSchema,\n\n  // Content\n  title: z.string().max(200),\n  content: z.string().max(5000),\n\n  // Context\n  context: z\n    .object({\n      file: z.string().optional(),\n      tool: z.string().optional(),\n      command: z.string().optional(),\n    })\n    .optional(),\n\n  // Outcome tracking\n  outcome: z.enum(['success', 'failure', 'partial', 'pending']).optional(),\n\n  // Timestamps\n  createdAt: z.string().datetime(),\n\n  // Link to promoted skill\n  promotedToSkillId: z.string().uuid().optional(),\n});\n\nexport type JournalEntry = z.infer<typeof JournalEntrySchema>;\n\n/**\n * Session summary\n */\nexport const SessionSummarySchema = z.object({\n  sessionId: z.string(),\n  startedAt: z.string().datetime(),\n  endedAt: z.string().datetime().optional(),\n\n  // Stats\n  entriesCount: z.number().int().min(0),\n  correctionsCount: z.number().int().min(0),\n  decisionsCount: z.number().int().min(0),\n\n  // Key learnings from this session\n  keyLearnings: z.array(z.string()).default([]),\n\n  // Skills promoted from this session\n  promotedSkillIds: z.array(z.string().uuid()).default([]),\n});\n\nexport type SessionSummary = z.infer<typeof SessionSummarySchema>;\n\n// ============================================================\n// QUERY SCHEMAS\n// ============================================================\n\n/**\n * Skill query filters\n */\nexport const SkillQuerySchema = z.object({\n  // Filter by classification\n  categories: z.array(SkillCategorySchema).optional(),\n  priorities: z.array(SkillPrioritySchema).optional(),\n  tags: z.array(z.string()).optional(),\n\n  // Filter by context\n  tool: z.string().optional(),\n  project: z.string().optional(),\n  language: z.string().optional(),\n  framework: z.string().optional(),\n\n  // Filter by validation\n  minValidatedCount: z.number().int().min(0).optional(),\n\n  // Pagination\n  limit: z.number().int().min(1).max(100).default(50),\n  offset: z.number().int().min(0).default(0),\n\n  // Sorting\n  sortBy: z\n    .enum(['priority', 'validatedCount', 'createdAt', 'updatedAt'])\n    .default('priority'),\n  sortOrder: z.enum(['asc', 'desc']).default('desc'),\n});\n\nexport type SkillQuery = z.infer<typeof SkillQuerySchema>;\n\n// ============================================================\n// REDIS KEY PATTERNS\n// ============================================================\n\n/**\n * Redis key generators - all keys are namespaced by userId\n * Use 'global' as userId for shared/team skills\n */\nexport const REDIS_KEYS = {\n  // Skills (namespaced by user)\n  skill: (userId: string, id: string) => `user:${userId}:skill:${id}`,\n  skillsByTool: (userId: string, tool: string) =>\n    `user:${userId}:skills:tool:${tool}`,\n  skillsByCategory: (userId: string, category: SkillCategory) =>\n    `user:${userId}:skills:category:${category}`,\n  skillsByTag: (userId: string, tag: string) =>\n    `user:${userId}:skills:tag:${tag}`,\n  skillsRecent: (userId: string) => `user:${userId}:skills:recent`,\n  skillsValidated: (userId: string) => `user:${userId}:skills:validated`,\n\n  // Session journal (namespaced by user)\n  journalEntry: (userId: string, id: string) =>\n    `user:${userId}:journal:entry:${id}`,\n  journalSession: (userId: string, sessionId: string) =>\n    `user:${userId}:journal:session:${sessionId}`,\n  journalRecent: (userId: string) => `user:${userId}:journal:recent`,\n\n  // Session tracking (namespaced by user)\n  sessionSummary: (userId: string, sessionId: string) =>\n    `user:${userId}:session:summary:${sessionId}`,\n  sessionsActive: (userId: string) => `user:${userId}:sessions:active`,\n\n  // Promotion tracking (namespaced by user)\n  promotionCandidates: (userId: string) =>\n    `user:${userId}:skills:promotion:candidates`,\n\n  // Locks (global)\n  syncLock: (resource: string) => `lock:skill:${resource}`,\n} as const;\n\n// ============================================================\n// CACHE TTL CONSTANTS (in seconds)\n// ============================================================\n\nexport const CACHE_TTL = {\n  // Base skill TTL: 7 days minimum\n  skillBase: 604800, // 7 days\n  // Max skill TTL: 90 days for frequently used skills\n  skillMax: 7776000, // 90 days\n  // TTL increment per validation/use: +7 days\n  skillIncrement: 604800, // 7 days\n\n  skillIndex: 86400, // 1 day (was 1 hour)\n  session: 604800, // 7 days\n  journal: 2592000, // 30 days\n  lock: 30, // 30 seconds\n} as const;\n\n/**\n * Calculate TTL for a skill based on usage\n * Base: 7 days, +7 days per validation, max 90 days\n */\nexport function calculateSkillTTL(validatedCount: number): number {\n  const ttl = CACHE_TTL.skillBase + validatedCount * CACHE_TTL.skillIncrement;\n  return Math.min(ttl, CACHE_TTL.skillMax);\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/core/storage/chromadb-adapter.js

@@ -0,0 +1,346 @@
+import { CloudClient } from "chromadb";
+import { v4 as uuidv4 } from "uuid";
+import { Logger } from "../monitoring/logger.js";
+class ChromaDBAdapter {
+  client;
+  collection = null;
+  logger;
+  config;
+  userId;
+  teamId;
+  constructor(config, userId, teamId) {
+    this.config = config;
+    this.userId = userId;
+    this.teamId = teamId;
+    this.logger = new Logger("ChromaDBAdapter");
+    this.client = new CloudClient({
+      apiKey: config.apiKey,
+      tenant: config.tenant,
+      database: config.database
+    });
+  }
+  async initialize() {
+    try {
+      const collectionName = this.config.collectionName || "stackmemory_contexts";
+      this.collection = await this.client.getOrCreateCollection({
+        name: collectionName,
+        metadata: {
+          description: "StackMemory context storage",
+          version: "1.0.0",
+          created_at: (/* @__PURE__ */ new Date()).toISOString()
+        }
+      });
+      this.logger.info(`ChromaDB collection '${collectionName}' initialized`);
+    } catch (error) {
+      this.logger.error("Failed to initialize ChromaDB collection", error);
+      throw error;
+    }
+  }
+  /**
+   * Store a frame in ChromaDB
+   */
+  async storeFrame(frame) {
+    if (!this.collection) {
+      throw new Error("ChromaDB not initialized");
+    }
+    try {
+      const frameMetadata = {
+        user_id: this.userId,
+        frame_id: frame.frameId,
+        session_id: frame.sessionId || "unknown",
+        project_name: frame.projectName || "default",
+        timestamp: frame.timestamp,
+        type: "frame",
+        score: frame.score,
+        tags: frame.tags || []
+      };
+      if (this.teamId) {
+        frameMetadata.team_id = this.teamId;
+      }
+      const document = {
+        id: `frame_${frame.frameId}_${this.userId}`,
+        document: this.frameToDocument(frame),
+        metadata: frameMetadata
+      };
+      await this.collection.add({
+        ids: [document.id],
+        documents: [document.document],
+        metadatas: [document.metadata]
+      });
+      this.logger.debug(`Stored frame ${frame.frameId} for user ${this.userId}`);
+    } catch (error) {
+      this.logger.error(`Failed to store frame ${frame.frameId}`, error);
+      throw error;
+    }
+  }
+  /**
+   * Store a decision or observation
+   */
+  async storeContext(type, content, metadata) {
+    if (!this.collection) {
+      throw new Error("ChromaDB not initialized");
+    }
+    try {
+      const contextId = `${type}_${uuidv4()}_${this.userId}`;
+      const documentMetadata = {
+        user_id: this.userId,
+        frame_id: metadata?.frame_id || "none",
+        session_id: metadata?.session_id || "unknown",
+        project_name: metadata?.project_name || "default",
+        timestamp: Date.now(),
+        type,
+        ...metadata
+      };
+      if (this.teamId) {
+        documentMetadata.team_id = this.teamId;
+      }
+      const document = {
+        id: contextId,
+        document: content,
+        metadata: documentMetadata
+      };
+      await this.collection.add({
+        ids: [document.id],
+        documents: [document.document],
+        metadatas: [document.metadata]
+      });
+      this.logger.debug(`Stored ${type} for user ${this.userId}`);
+    } catch (error) {
+      this.logger.error(`Failed to store ${type}`, error);
+      throw error;
+    }
+  }
+  /**
+   * Query contexts by semantic similarity
+   */
+  async queryContexts(query, limit = 10, filters) {
+    if (!this.collection) {
+      throw new Error("ChromaDB not initialized");
+    }
+    try {
+      const whereClause = {
+        user_id: this.userId
+      };
+      if (this.teamId) {
+        whereClause["$or"] = [
+          { team_id: this.teamId },
+          { user_id: this.userId }
+        ];
+      }
+      if (filters?.type && filters.type.length > 0) {
+        whereClause.type = { $in: filters.type };
+      }
+      if (filters?.projectName) {
+        whereClause.project_name = filters.projectName;
+      }
+      if (filters?.sessionId) {
+        whereClause.session_id = filters.sessionId;
+      }
+      if (filters?.startTime || filters?.endTime) {
+        whereClause.timestamp = {};
+        if (filters.startTime) {
+          whereClause.timestamp.$gte = filters.startTime;
+        }
+        if (filters.endTime) {
+          whereClause.timestamp.$lte = filters.endTime;
+        }
+      }
+      const results = await this.collection.query({
+        queryTexts: [query],
+        nResults: limit,
+        where: whereClause,
+        include: ["documents", "metadatas", "distances"]
+      });
+      const contexts = [];
+      if (results.documents && results.documents[0]) {
+        for (let i = 0; i < results.documents[0].length; i++) {
+          contexts.push({
+            content: results.documents[0][i] || "",
+            metadata: results.metadatas?.[0]?.[i] || {},
+            distance: results.distances?.[0]?.[i] || 0
+          });
+        }
+      }
+      this.logger.debug(`Found ${contexts.length} contexts for query`);
+      return contexts;
+    } catch (error) {
+      this.logger.error("Failed to query contexts", error);
+      throw error;
+    }
+  }
+  /**
+   * Get user's recent contexts
+   */
+  async getRecentContexts(limit = 20, type) {
+    if (!this.collection) {
+      throw new Error("ChromaDB not initialized");
+    }
+    try {
+      const whereClause = {
+        user_id: this.userId
+      };
+      if (type) {
+        whereClause.type = type;
+      }
+      const results = await this.collection.get({
+        where: whereClause,
+        include: ["documents", "metadatas"]
+      });
+      const contexts = [];
+      if (results.documents) {
+        const indexed = results.documents.map((doc, i) => ({
+          content: doc || "",
+          metadata: results.metadatas?.[i] || {}
+        }));
+        indexed.sort((a, b) => (b.metadata.timestamp || 0) - (a.metadata.timestamp || 0));
+        contexts.push(...indexed.slice(0, limit));
+      }
+      return contexts;
+    } catch (error) {
+      this.logger.error("Failed to get recent contexts", error);
+      throw error;
+    }
+  }
+  /**
+   * Delete old contexts (retention policy)
+   */
+  async deleteOldContexts(olderThanDays = 30) {
+    if (!this.collection) {
+      throw new Error("ChromaDB not initialized");
+    }
+    try {
+      const cutoffTime = Date.now() - olderThanDays * 24 * 60 * 60 * 1e3;
+      const results = await this.collection.get({
+        where: {
+          user_id: this.userId,
+          timestamp: { $lt: cutoffTime }
+        },
+        include: ["ids"]
+      });
+      if (!results.ids || results.ids.length === 0) {
+        return 0;
+      }
+      await this.collection.delete({
+        ids: results.ids
+      });
+      this.logger.info(`Deleted ${results.ids.length} old contexts`);
+      return results.ids.length;
+    } catch (error) {
+      this.logger.error("Failed to delete old contexts", error);
+      throw error;
+    }
+  }
+  /**
+   * Get team contexts (if user is part of a team)
+   */
+  async getTeamContexts(limit = 20) {
+    if (!this.collection || !this.teamId) {
+      return [];
+    }
+    try {
+      const results = await this.collection.get({
+        where: {
+          team_id: this.teamId
+        },
+        include: ["documents", "metadatas"],
+        limit
+      });
+      const contexts = [];
+      if (results.documents) {
+        for (let i = 0; i < results.documents.length; i++) {
+          contexts.push({
+            content: results.documents[i] || "",
+            metadata: results.metadatas?.[i] || {}
+          });
+        }
+      }
+      return contexts;
+    } catch (error) {
+      this.logger.error("Failed to get team contexts", error);
+      return [];
+    }
+  }
+  /**
+   * Convert frame to searchable document
+   */
+  frameToDocument(frame) {
+    const parts = [
+      `Frame: ${frame.title}`,
+      `Type: ${frame.type}`,
+      `Status: ${frame.status}`
+    ];
+    if (frame.description) {
+      parts.push(`Description: ${frame.description}`);
+    }
+    if (frame.inputs && frame.inputs.length > 0) {
+      parts.push(`Inputs: ${frame.inputs.join(", ")}`);
+    }
+    if (frame.outputs && frame.outputs.length > 0) {
+      parts.push(`Outputs: ${frame.outputs.join(", ")}`);
+    }
+    if (frame.tags && frame.tags.length > 0) {
+      parts.push(`Tags: ${frame.tags.join(", ")}`);
+    }
+    if (frame.digest_json) {
+      try {
+        const digest = JSON.parse(frame.digest_json);
+        if (digest.summary) {
+          parts.push(`Summary: ${digest.summary}`);
+        }
+        if (digest.keyDecisions) {
+          parts.push(`Decisions: ${digest.keyDecisions.join(". ")}`);
+        }
+      } catch {
+      }
+    }
+    return parts.join("\n");
+  }
+  /**
+   * Update team ID for a user
+   */
+  async updateTeamId(newTeamId) {
+    this.teamId = newTeamId;
+    this.logger.info(`Updated team ID to ${newTeamId} for user ${this.userId}`);
+  }
+  /**
+   * Get storage statistics
+   */
+  async getStats() {
+    if (!this.collection) {
+      throw new Error("ChromaDB not initialized");
+    }
+    try {
+      const userResults = await this.collection.get({
+        where: { user_id: this.userId },
+        include: ["metadatas"]
+      });
+      const stats = {
+        totalDocuments: 0,
+        userDocuments: userResults.ids?.length || 0,
+        documentsByType: {}
+      };
+      if (userResults.metadatas) {
+        for (const metadata of userResults.metadatas) {
+          const type = metadata?.type || "unknown";
+          stats.documentsByType[type] = (stats.documentsByType[type] || 0) + 1;
+        }
+      }
+      if (this.teamId) {
+        const teamResults = await this.collection.get({
+          where: { team_id: this.teamId },
+          include: ["ids"]
+        });
+        stats.teamDocuments = teamResults.ids?.length || 0;
+      }
+      stats.totalDocuments = stats.userDocuments + (stats.teamDocuments || 0);
+      return stats;
+    } catch (error) {
+      this.logger.error("Failed to get stats", error);
+      throw error;
+    }
+  }
+}
+export {
+  ChromaDBAdapter
+};
+//# sourceMappingURL=chromadb-adapter.js.map