sdlc-agent-4-enterprise-server 1.0.0

package/dist/modules/memory/ScopePromotionService.js

@@ -0,0 +1,263 @@
+/**
+ * ScopePromotionService — Hybrid auto-promotion logic (Option D).
+ *
+ * Rules:
+ * 1. Agent can ingest directly as USER (default) or PROJECT (explicit)
+ * 2. Background scan detects high-value USER entries → auto-suggest to PROJECT
+ * 3. PROJECT → SHARED: ALWAYS requires admin approval (cross-project impact)
+ *
+ * Auto-promotion criteria (USER → PROJECT):
+ * - citations >= 2 (cross-agent usage)
+ * - access_count >= 5 (frequently accessed)
+ * - quality_score >= 70 (if scored)
+ * - age >= 24h (not transient working memory)
+ *
+ * Entries matching ANY 2 of these → queued for PROJECT promotion.
+ */
+const DEFAULT_CONFIG = {
+    minCitations: 2,
+    minAccessCount: 5,
+    minQualityScore: 70,
+    minAgeHours: 24,
+    minCriteriaMet: 2,
+    autoApproveToProject: false,
+};
+export class ScopePromotionService {
+    db;
+    logger;
+    config;
+    constructor(db, logger, config) {
+        this.db = db;
+        this.logger = logger.child({ service: 'scope-promotion' });
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        this.ensurePromotionQueueTable();
+    }
+    /** Create kb_promotion_queue if not exists. */
+    ensurePromotionQueueTable() {
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS kb_promotion_queue (
+        promotion_id TEXT PRIMARY KEY,
+        entry_id INTEGER NOT NULL,
+        source_tier TEXT NOT NULL,
+        target_tier TEXT NOT NULL,
+        reason TEXT NOT NULL,
+        score REAL NOT NULL DEFAULT 0,
+        status TEXT NOT NULL DEFAULT 'PENDING',
+        review_comment TEXT,
+        reviewed_by TEXT,
+        reviewed_at TEXT,
+        cooldown_until TEXT,
+        created_at TEXT NOT NULL DEFAULT (datetime('now')),
+        FOREIGN KEY (entry_id) REFERENCES knowledge_entries(id) ON DELETE CASCADE
+      );
+      CREATE INDEX IF NOT EXISTS idx_kpq_status ON kb_promotion_queue(status);
+      CREATE INDEX IF NOT EXISTS idx_kpq_entry ON kb_promotion_queue(entry_id);
+    `);
+    }
+    /**
+     * Scan USER-scope entries and find promotion candidates.
+     * Called periodically (e.g., every hour or on-demand via tool).
+     */
+    scanForPromotionCandidates(limit = 50) {
+        const candidates = [];
+        const minAge = new Date(Date.now() - this.config.minAgeHours * 3600_000).toISOString();
+        // Get USER entries older than minAgeHours, not archived, not already queued
+        const entries = this.db.prepare(`
+      SELECT ke.id, ke.summary, ke.type, ke.access_count, ke.quality_score, ke.created_at
+      FROM knowledge_entries ke
+      WHERE ke.scope = 'USER'
+        AND ke.archived = 0
+        AND ke.created_at <= ?
+        AND ke.id NOT IN (
+          SELECT entry_id FROM kb_promotion_queue
+          WHERE status IN ('PENDING', 'APPROVED')
+        )
+      ORDER BY ke.access_count DESC
+      LIMIT ?
+    `).all(minAge, limit);
+        for (const entry of entries) {
+            const criteria = this.evaluateCriteria(entry);
+            if (criteria.metCount >= this.config.minCriteriaMet) {
+                candidates.push({
+                    entryId: entry.id,
+                    currentScope: 'USER',
+                    targetScope: 'PROJECT',
+                    reason: criteria.reasons.join('; '),
+                    score: criteria.score,
+                });
+            }
+        }
+        this.logger.info({ scanned: entries.length, candidates: candidates.length }, 'Promotion scan complete');
+        return candidates;
+    }
+    /**
+     * Evaluate promotion criteria for a single entry.
+     */
+    evaluateCriteria(entry) {
+        const reasons = [];
+        let metCount = 0;
+        let score = 0;
+        // Criterion 1: Citations >= threshold
+        const citationCount = this.db.prepare('SELECT COUNT(*) as cnt FROM citations WHERE entry_id = ?').get(entry.id)?.cnt ?? 0;
+        if (citationCount >= this.config.minCitations) {
+            metCount++;
+            reasons.push(`citations=${citationCount}`);
+            score += 30;
+        }
+        // Criterion 2: Access count >= threshold
+        if (entry.access_count >= this.config.minAccessCount) {
+            metCount++;
+            reasons.push(`access_count=${entry.access_count}`);
+            score += 25;
+        }
+        // Criterion 3: Quality score >= threshold
+        if (entry.quality_score !== null && entry.quality_score >= this.config.minQualityScore) {
+            metCount++;
+            reasons.push(`quality=${entry.quality_score}`);
+            score += 25;
+        }
+        // Criterion 4: Cross-agent usage (cited by different agents)
+        const crossAgentCites = this.db.prepare('SELECT COUNT(DISTINCT cited_by) as cnt FROM citations WHERE entry_id = ?').get(entry.id)?.cnt ?? 0;
+        if (crossAgentCites >= 2) {
+            metCount++;
+            reasons.push(`cross_agent_cites=${crossAgentCites}`);
+            score += 20;
+        }
+        return { metCount, reasons, score };
+    }
+    /**
+     * Queue candidates for promotion review.
+     * If autoApproveToProject is true, USER→PROJECT promotions are applied immediately.
+     */
+    queueCandidates(candidates) {
+        let queued = 0;
+        let autoApproved = 0;
+        const insertStmt = this.db.prepare(`
+      INSERT OR IGNORE INTO kb_promotion_queue
+      (promotion_id, entry_id, source_tier, target_tier, reason, score, status)
+      VALUES (?, ?, ?, ?, ?, ?, ?)
+    `);
+        const promoteStmt = this.db.prepare(`
+      UPDATE knowledge_entries SET scope = ?, updated_at = datetime('now') WHERE id = ?
+    `);
+        const transaction = this.db.transaction((items) => {
+            for (const c of items) {
+                const promotionId = `promo-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+                if (this.config.autoApproveToProject && c.targetScope === 'PROJECT') {
+                    // Auto-approve: promote directly
+                    promoteStmt.run(c.targetScope, c.entryId);
+                    insertStmt.run(promotionId, c.entryId, c.currentScope, c.targetScope, c.reason, c.score, 'APPROVED');
+                    autoApproved++;
+                }
+                else {
+                    // Queue for manual review
+                    insertStmt.run(promotionId, c.entryId, c.currentScope, c.targetScope, c.reason, c.score, 'PENDING');
+                    queued++;
+                }
+            }
+        });
+        transaction(candidates);
+        this.logger.info({ queued, autoApproved }, 'Promotion candidates processed');
+        return { queued, autoApproved };
+    }
+    /**
+     * Run full promotion cycle: scan → queue.
+     */
+    runPromotionCycle() {
+        const candidates = this.scanForPromotionCandidates();
+        if (candidates.length === 0) {
+            return 'No promotion candidates found.';
+        }
+        const { queued, autoApproved } = this.queueCandidates(candidates);
+        return `Promotion cycle: ${candidates.length} candidates found. Queued: ${queued}, Auto-approved: ${autoApproved}.`;
+    }
+    /** Get pending promotions for admin review. */
+    listPending(limit = 20) {
+        return this.db.prepare(`
+      SELECT pq.*, ke.summary, ke.type, ke.tier, ke.scope
+      FROM kb_promotion_queue pq
+      JOIN knowledge_entries ke ON ke.id = pq.entry_id
+      WHERE pq.status = 'PENDING'
+      ORDER BY pq.score DESC, pq.created_at ASC
+      LIMIT ?
+    `).all(limit);
+    }
+    /** Approve a pending promotion. */
+    approve(entryId, reviewerId, comment) {
+        const promo = this.db.prepare('SELECT * FROM kb_promotion_queue WHERE entry_id = ? AND status = ?').get(entryId, 'PENDING');
+        if (!promo)
+            return false;
+        this.db.prepare(`
+      UPDATE kb_promotion_queue
+      SET status = 'APPROVED', reviewed_by = ?, review_comment = ?, reviewed_at = datetime('now')
+      WHERE promotion_id = ?
+    `).run(reviewerId, comment, promo.promotion_id);
+        this.db.prepare(`UPDATE knowledge_entries SET scope = ?, updated_at = datetime('now') WHERE id = ?`).run(promo.target_tier, entryId);
+        this.logger.info({ entryId, target: promo.target_tier, reviewer: reviewerId }, 'Promotion approved');
+        return true;
+    }
+    /** Reject a pending promotion (no cooldown — can be re-scanned next cycle). */
+    reject(entryId, reviewerId, comment) {
+        const promo = this.db.prepare('SELECT * FROM kb_promotion_queue WHERE entry_id = ? AND status = ?').get(entryId, 'PENDING');
+        if (!promo)
+            return false;
+        this.db.prepare(`
+      UPDATE kb_promotion_queue
+      SET status = 'REJECTED', reviewed_by = ?, review_comment = ?, reviewed_at = datetime('now')
+      WHERE promotion_id = ?
+    `).run(reviewerId, comment, promo.promotion_id);
+        this.logger.info({ entryId, reviewer: reviewerId }, 'Promotion rejected (no cooldown)');
+        return true;
+    }
+    /** Request promotion to SHARED scope (always manual). */
+    requestSharedPromotion(entryId, reason) {
+        const entry = this.db.prepare('SELECT * FROM knowledge_entries WHERE id = ? AND scope = ?').get(entryId, 'PROJECT');
+        if (!entry)
+            return false;
+        const existing = this.db.prepare("SELECT 1 FROM kb_promotion_queue WHERE entry_id = ? AND target_tier = 'SHARED' AND status = 'PENDING'").get(entryId);
+        if (existing)
+            return false;
+        const promotionId = `promo-shared-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+        this.db.prepare(`
+      INSERT INTO kb_promotion_queue (promotion_id, entry_id, source_tier, target_tier, reason, score, status)
+      VALUES (?, ?, 'PROJECT', 'SHARED', ?, 0, 'PENDING')
+    `).run(promotionId, entryId, reason);
+        this.logger.info({ entryId, reason }, 'SHARED promotion requested');
+        return true;
+    }
+    /**
+     * Auto-promote all USER entries related to a ticket to PROJECT scope.
+     * Triggered when code is merged to main/master or released.
+     * This bypasses the scan criteria — merge/release = team-validated knowledge.
+     */
+    promoteOnMerge(ticketKey) {
+        // Find all USER-scope entries tagged with or sourced from this ticket
+        const entries = this.db.prepare(`
+      SELECT id, scope FROM knowledge_entries
+      WHERE scope = 'USER'
+        AND archived = 0
+        AND (
+          tags LIKE ? OR source LIKE ? OR summary LIKE ?
+        )
+    `).all(`%${ticketKey}%`, `%${ticketKey}%`, `%${ticketKey}%`);
+        let promoted = 0;
+        let skipped = 0;
+        const promoteStmt = this.db.prepare(`UPDATE knowledge_entries SET scope = 'PROJECT', updated_at = datetime('now') WHERE id = ?`);
+        const logStmt = this.db.prepare(`INSERT INTO consolidation_log (entry_id, from_tier, to_tier, reason) VALUES (?, 'USER', 'PROJECT', ?)`);
+        const transaction = this.db.transaction((items) => {
+            for (const entry of items) {
+                if (entry.scope !== 'USER') {
+                    skipped++;
+                    continue;
+                }
+                promoteStmt.run(entry.id);
+                logStmt.run(entry.id, `Auto-promoted on merge/release: ${ticketKey}`);
+                promoted++;
+            }
+        });
+        transaction(entries);
+        this.logger.info({ ticketKey, promoted, skipped, total: entries.length }, 'promoteOnMerge completed');
+        return { promoted, skipped };
+    }
+}
+//# sourceMappingURL=ScopePromotionService.js.map

package/dist/modules/memory/ScopePromotionService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScopePromotionService.js","sourceRoot":"","sources":["../../../src/modules/memory/ScopePromotionService.ts"],"names":[],"mappings":"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"}

package/dist/modules/memory/__tests__/MemoryToolDispatcher.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/modules/memory/__tests__/MemoryToolDispatcher.test.js

@@ -0,0 +1,72 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import { DatabaseManager } from '../../../engine/db/database-manager.js';
+import { MemoryEngine } from '../MemoryEngine.js';
+import { MemoryToolDispatcher } from '../MemoryToolDispatcher.js';
+import { QueryLayer } from '../../../engine/query/query-layer.js';
+describe('MemoryToolDispatcher sync_code & live status', () => {
+    let tmpDir;
+    let dbPath;
+    let dbManager;
+    let engine;
+    let queryLayer;
+    let dispatcher;
+    beforeEach(() => {
+        DatabaseManager.sharedDb = null;
+        tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'ksa-mem-test-'));
+        dbPath = path.join(tmpDir, 'index.db');
+        dbManager = new DatabaseManager(dbPath);
+        dbManager.initialize();
+        engine = new MemoryEngine(dbManager.getDb());
+        queryLayer = new QueryLayer(dbManager);
+        dispatcher = new MemoryToolDispatcher(engine, tmpDir, queryLayer);
+    });
+    afterEach(() => {
+        dbManager.close();
+        fs.rmSync(tmpDir, { recursive: true, force: true });
+    });
+    it('reports correct live counts in status action', () => {
+        const statusBefore = dispatcher.dispatch('mem_status', {});
+        expect(statusBefore).toBe('Entries: 0 | Edges: 0');
+        // Insert an entry manually
+        engine.insert({
+            content: 'test content',
+            summary: 'test summary',
+            type: 'CONTEXT',
+            tier: 'WORKING',
+        });
+        const statusAfter = dispatcher.dispatch('mem_status', {});
+        expect(statusAfter).toBe('Entries: 1 | Edges: 0');
+    });
+    it('performs sync_code and creates cross-references', () => {
+        const db = dbManager.getDb();
+        // 1. Seed files and symbols in database
+        db.prepare("INSERT INTO files (path, relative_path, language, content_hash, size_bytes) VALUES ('C:/projects/kiro/src/index.ts', 'src/index.ts', 'typescript', 'hash123', 100)").run();
+        const fileId = db.prepare("SELECT id FROM files WHERE relative_path = 'src/index.ts'").get().id;
+        db.prepare(`
+      INSERT INTO symbols (file_id, name, kind, signature, start_line, end_line, visibility) 
+      VALUES (?, 'MyClass', 'class', 'class MyClass {}', 10, 20, 'public')
+    `).run(fileId);
+        // 2. Seed a document in knowledge entries referencing the class name
+        engine.insert({
+            content: 'Documentation for MyClass, which implements some feature.',
+            summary: 'MyClass Doc',
+            type: 'REQUIREMENT',
+            tier: 'SEMANTIC',
+        });
+        // 3. Dispatch sync_code
+        const syncRes = dispatcher.dispatch('mem_sync_code', {});
+        expect(syncRes).toContain('Synced: 1 code symbols, 1 cross-reference edges');
+        // 4. Verify counts
+        const statusRes = dispatcher.dispatch('mem_status', {});
+        expect(statusRes).toBe('Entries: 2 | Edges: 1');
+        // 5. Verify the code entity was inserted with type CODE_ENTITY
+        const entries = engine.findFiltered(undefined, 'CODE_ENTITY');
+        expect(entries).toHaveLength(1);
+        expect(entries[0].summary).toBe('class: MyClass (src/index.ts)');
+        expect(entries[0].content).toContain('class MyClass');
+    });
+});
+//# sourceMappingURL=MemoryToolDispatcher.test.js.map

package/dist/modules/memory/__tests__/MemoryToolDispatcher.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MemoryToolDispatcher.test.js","sourceRoot":"","sources":["../../../../src/modules/memory/__tests__/MemoryToolDispatcher.test.ts"],"names":[],"mappings":"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"}

package/dist/modules/memory/__tests__/ScopePromotionService.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/modules/memory/__tests__/ScopePromotionService.test.js

@@ -0,0 +1,142 @@
+/**
+ * Unit Tests — ScopePromotionService (KSA-295)
+ * Covers: scan criteria, queue, approve, reject (no cooldown), promoteOnMerge, requestShared.
+ */
+import { describe, it, expect, beforeEach } from 'vitest';
+import Database from 'better-sqlite3';
+import pino from 'pino';
+import { ScopePromotionService } from '../ScopePromotionService.js';
+import { MEMORY_SCHEMA } from '../schema.js';
+function createTestDb() {
+    const db = new Database(':memory:');
+    db.pragma('journal_mode = WAL');
+    db.pragma('foreign_keys = ON');
+    db.exec(MEMORY_SCHEMA);
+    return db;
+}
+const logger = pino({ level: 'silent' });
+function seedEntry(db, overrides = {}) {
+    const defaults = {
+        content: 'test content', summary: 'test', type: 'CONTEXT',
+        tier: 'WORKING', scope: 'USER', user_id: 'user-1',
+        tags: '', confidence: 1.0, access_count: 0,
+        created_at: new Date(Date.now() - 48 * 3600_000).toISOString(),
+    };
+    const d = { ...defaults, ...overrides };
+    const r = db.prepare(`
+    INSERT INTO knowledge_entries (content, summary, type, tier, scope, user_id, tags, confidence, access_count, created_at)
+    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+  `).run(d.content, d.summary, d.type, d.tier, d.scope, d.user_id, d.tags, d.confidence, d.access_count, d.created_at);
+    return r.lastInsertRowid;
+}
+function addCitation(db, entryId, citedBy) {
+    db.prepare('INSERT INTO citations (entry_id, cited_by) VALUES (?, ?)').run(entryId, citedBy);
+}
+describe('ScopePromotionService', () => {
+    let db;
+    let svc;
+    beforeEach(() => {
+        db = createTestDb();
+        svc = new ScopePromotionService(db, logger);
+    });
+    describe('scanForPromotionCandidates', () => {
+        it('detects entry meeting 2+ criteria', () => {
+            const id = seedEntry(db, { access_count: 8, quality_score: 80 });
+            addCitation(db, id, 'agent-ba');
+            addCitation(db, id, 'agent-sa');
+            addCitation(db, id, 'agent-dev');
+            const candidates = svc.scanForPromotionCandidates();
+            expect(candidates.length).toBe(1);
+            expect(candidates[0].entryId).toBe(id);
+            expect(candidates[0].targetScope).toBe('PROJECT');
+            expect(candidates[0].score).toBeGreaterThan(0);
+        });
+        it('skips entry meeting only 1 criterion', () => {
+            seedEntry(db, { access_count: 10 });
+            const candidates = svc.scanForPromotionCandidates();
+            expect(candidates.length).toBe(0);
+        });
+        it('skips entries younger than 24h', () => {
+            const id = seedEntry(db, {
+                access_count: 20, quality_score: 90,
+                created_at: new Date().toISOString(),
+            });
+            addCitation(db, id, 'a1');
+            addCitation(db, id, 'a2');
+            addCitation(db, id, 'a3');
+            const candidates = svc.scanForPromotionCandidates();
+            expect(candidates.length).toBe(0);
+        });
+        it('skips already-queued entries', () => {
+            const id = seedEntry(db, { access_count: 8, quality_score: 80 });
+            addCitation(db, id, 'a1');
+            addCitation(db, id, 'a2');
+            svc.queueCandidates(svc.scanForPromotionCandidates());
+            const c2 = svc.scanForPromotionCandidates();
+            expect(c2.length).toBe(0);
+        });
+    });
+    describe('approve', () => {
+        it('changes entry scope USER to PROJECT', () => {
+            const id = seedEntry(db, { access_count: 8, quality_score: 80 });
+            addCitation(db, id, 'a1');
+            addCitation(db, id, 'a2');
+            svc.queueCandidates(svc.scanForPromotionCandidates());
+            expect(svc.approve(id, 'admin-001', 'Good')).toBe(true);
+            const e = db.prepare('SELECT scope FROM knowledge_entries WHERE id = ?').get(id);
+            expect(e.scope).toBe('PROJECT');
+        });
+        it('returns false for non-pending', () => {
+            expect(svc.approve(999, 'admin', 'x')).toBe(false);
+        });
+    });
+    describe('reject', () => {
+        it('no cooldown — entry re-scannable', () => {
+            const id = seedEntry(db, { access_count: 8, quality_score: 80 });
+            addCitation(db, id, 'a1');
+            addCitation(db, id, 'a2');
+            svc.queueCandidates(svc.scanForPromotionCandidates());
+            expect(svc.reject(id, 'admin', 'Not ready')).toBe(true);
+            const e = db.prepare('SELECT scope FROM knowledge_entries WHERE id = ?').get(id);
+            expect(e.scope).toBe('USER');
+            const q = db.prepare('SELECT cooldown_until FROM kb_promotion_queue WHERE entry_id = ?').get(id);
+            expect(q.cooldown_until).toBeNull();
+        });
+    });
+    describe('promoteOnMerge', () => {
+        it('promotes matching USER entries', () => {
+            const id1 = seedEntry(db, { tags: 'KSA-295,arch' });
+            const id2 = seedEntry(db, { summary: 'KSA-295 req' });
+            seedEntry(db, { tags: 'KSA-100' });
+            const { promoted } = svc.promoteOnMerge('KSA-295');
+            expect(promoted).toBe(2);
+            expect(db.prepare('SELECT scope FROM knowledge_entries WHERE id=?').get(id1).scope).toBe('PROJECT');
+            expect(db.prepare('SELECT scope FROM knowledge_entries WHERE id=?').get(id2).scope).toBe('PROJECT');
+        });
+        it('skips non-USER entries (not matched by query)', () => {
+            seedEntry(db, { tags: 'KSA-295', scope: 'PROJECT' });
+            const { promoted, skipped } = svc.promoteOnMerge('KSA-295');
+            expect(promoted).toBe(0);
+            expect(skipped).toBe(0); // PROJECT entries not in WHERE scope='USER' query
+        });
+    });
+    describe('requestSharedPromotion', () => {
+        it('creates PENDING for PROJECT entry', () => {
+            const id = seedEntry(db, { scope: 'PROJECT' });
+            expect(svc.requestSharedPromotion(id, 'Cross-project')).toBe(true);
+            const q = db.prepare('SELECT * FROM kb_promotion_queue WHERE entry_id=?').get(id);
+            expect(q.target_tier).toBe('SHARED');
+            expect(q.status).toBe('PENDING');
+        });
+        it('returns false for USER entry', () => {
+            const id = seedEntry(db, { scope: 'USER' });
+            expect(svc.requestSharedPromotion(id, 'x')).toBe(false);
+        });
+        it('blocks duplicate', () => {
+            const id = seedEntry(db, { scope: 'PROJECT' });
+            svc.requestSharedPromotion(id, 'first');
+            expect(svc.requestSharedPromotion(id, 'second')).toBe(false);
+        });
+    });
+});
+//# sourceMappingURL=ScopePromotionService.test.js.map

package/dist/modules/memory/__tests__/ScopePromotionService.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScopePromotionService.test.js","sourceRoot":"","sources":["../../../../src/modules/memory/__tests__/ScopePromotionService.test.ts"],"names":[],"mappings":"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"}

package/dist/modules/memory/llm/LLMService.d.ts

@@ -0,0 +1,17 @@
+/**
+ * LLMService — facade for multi-provider LLM access.
+ * Reads config from backend config, selects appropriate adapter.
+ */
+import type { LLMConfig, LLMMessage, LLMResponse } from './types.js';
+export declare class LLMService {
+    private config;
+    private adapter;
+    constructor(config?: Partial<LLMConfig>);
+    complete(messages: LLMMessage[]): Promise<LLMResponse>;
+    isAvailable(): Promise<boolean>;
+    getConfig(): LLMConfig;
+    /** Convenience: ask a simple question */
+    ask(prompt: string, systemPrompt?: string): Promise<string>;
+    /** Name a cluster of entries given their summaries */
+    nameCluster(summaries: string[]): Promise<string>;
+}

package/dist/modules/memory/llm/LLMService.js

@@ -0,0 +1,64 @@
+/**
+ * LLMService — facade for multi-provider LLM access.
+ * Reads config from backend config, selects appropriate adapter.
+ */
+import { OllamaAdapter } from './ollama-adapter.js';
+import { OpenAIAdapter } from './openai-adapter.js';
+const ADAPTERS = {
+    ollama: () => new OllamaAdapter(),
+    openai: () => new OpenAIAdapter(),
+    anthropic: () => new OpenAIAdapter(), // Anthropic via compatible API
+    gemini: () => new OpenAIAdapter(), // Gemini via compatible API
+    lmstudio: () => new OpenAIAdapter(), // LM Studio via OpenAI-compatible API
+    copilot: () => new OpenAIAdapter(), // Copilot via compatible API
+};
+const DEFAULT_CONFIGS = {
+    ollama: { baseUrl: 'http://localhost:11434', model: 'qwen2.5:7b-instruct-q4_K_M', temperature: 0.3, maxTokens: 300 },
+    openai: { baseUrl: 'https://api.openai.com/v1', model: 'gpt-4o-mini', temperature: 0.3, maxTokens: 300 },
+    anthropic: { baseUrl: 'https://api.anthropic.com/v1', model: 'claude-3-haiku-20240307', temperature: 0.3, maxTokens: 300 },
+    gemini: { baseUrl: 'https://generativelanguage.googleapis.com/v1beta/openai', model: 'gemini-1.5-flash', temperature: 0.3, maxTokens: 300 },
+    lmstudio: { baseUrl: 'http://localhost:1234/v1', model: 'default', temperature: 0.3, maxTokens: 300 },
+    copilot: { baseUrl: 'http://localhost:11435', model: 'copilot', temperature: 0.3, maxTokens: 300 },
+};
+export class LLMService {
+    config;
+    adapter;
+    constructor(config) {
+        const provider = (config?.provider || process.env.LLM_PROVIDER || 'ollama');
+        const defaults = DEFAULT_CONFIGS[provider] || DEFAULT_CONFIGS.ollama;
+        this.config = {
+            provider,
+            model: config?.model || process.env.LLM_MODEL || defaults.model || 'qwen3:8b',
+            baseUrl: config?.baseUrl || process.env.LLM_BASE_URL || defaults.baseUrl || 'http://localhost:11434',
+            apiKey: config?.apiKey || process.env.LLM_API_KEY || undefined,
+            temperature: config?.temperature ?? defaults.temperature ?? 0.3,
+            maxTokens: config?.maxTokens ?? defaults.maxTokens ?? 300,
+        };
+        this.adapter = ADAPTERS[provider]?.() || new OllamaAdapter();
+    }
+    async complete(messages) {
+        return this.adapter.complete(messages, this.config);
+    }
+    async isAvailable() {
+        return this.adapter.isAvailable(this.config);
+    }
+    getConfig() { return { ...this.config }; }
+    /** Convenience: ask a simple question */
+    async ask(prompt, systemPrompt) {
+        const messages = [];
+        if (systemPrompt)
+            messages.push({ role: 'system', content: systemPrompt });
+        messages.push({ role: 'user', content: prompt });
+        const res = await this.complete(messages);
+        return res.content;
+    }
+    /** Name a cluster of entries given their summaries */
+    async nameCluster(summaries) {
+        const systemPrompt = `You are a technical project analyst. Given a list of document summaries from the same project area, provide a concise business feature name (3-8 words, English). Return ONLY the name, nothing else.`;
+        const userPrompt = `These documents belong to the same feature area:\n${summaries.slice(0, 8).map((s, i) => `${i + 1}. ${s}`).join('\n')}\n\nBusiness feature name:`;
+        const result = await this.ask(userPrompt, systemPrompt);
+        // Clean up: remove quotes, newlines, prefixes
+        return result.replace(/^["'\s]+|["'\s]+$/g, '').split('\n')[0].trim().substring(0, 80);
+    }
+}
+//# sourceMappingURL=LLMService.js.map

package/dist/modules/memory/llm/LLMService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LLMService.js","sourceRoot":"","sources":["../../../../src/modules/memory/llm/LLMService.ts"],"names":[],"mappings":"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"}

package/dist/modules/memory/llm/TagAnalyzerService.d.ts

@@ -0,0 +1,37 @@
+/**
+ * TagAnalyzerService — LLM-based automatic tag assignment for KB entries.
+ * Called internally during mem_ingest pipeline (NOT an MCP tool).
+ * Zero context token cost for agents.
+ */
+import { LLMService } from './LLMService.js';
+import type { Logger } from 'pino';
+export interface TagSuggestion {
+    tag: string;
+    category: string;
+    confidence: number;
+    reason: string;
+}
+export interface TagAnalysisResult {
+    appliedTags: string[];
+    suggestedTags: TagSuggestion[];
+    fallbackUsed: boolean;
+}
+export interface TagAnalyzeOptions {
+    taxonomyCategories?: string[];
+    threshold?: number;
+    autoApply?: boolean;
+}
+export declare class TagAnalyzerService {
+    private llmService;
+    private taxonomy;
+    private allValidTags;
+    private logger?;
+    constructor(llmService: LLMService, logger?: Logger);
+    analyzeTags(content: string, options?: TagAnalyzeOptions): Promise<TagAnalysisResult>;
+    private analyzeWithLLM;
+    private parseResponse;
+    private applyThreshold;
+    private fallbackKeywordExtraction;
+    private filterTaxonomy;
+    private timeout;
+}