@teamlens/core 0.1.0

package/dist/retrieval/retriever.d.ts

@@ -0,0 +1,33 @@
+import type { MemoryDatabase } from '../store/database.js';
+import { EmbeddingProvider } from '../store/embeddings.js';
+import type { RetrievalQuery, ScoredMemory, Memory, TeamLensConfig } from '../types.js';
+/**
+ * Multi-signal retriever — ranks memories using:
+ *   0.40 × semantic similarity  (embedding cosine)
+ *   0.25 × file proximity       (same directory as scope)
+ *   0.20 × recency              (newer = higher)
+ *   0.15 × confidence           (author confidence score)
+ *   – staleness penalty          (stale memories pushed down)
+ *
+ * Falls back to keyword matching when embeddings aren't available.
+ */
+export declare class MemoryRetriever {
+    private db;
+    private embeddings;
+    private config;
+    constructor(db: MemoryDatabase, embeddings: EmbeddingProvider, config: TeamLensConfig);
+    query(request: RetrievalQuery): Promise<ScoredMemory[]>;
+    /** Convenience: get all conventions (no query needed). */
+    getConventions(): Promise<Memory[]>;
+    /** Convenience: get decisions for a scope. */
+    getDecisions(scope?: string): Promise<Memory[]>;
+    private scoreSemantic;
+    private scoreFileProximity;
+    private scoreRecency;
+    /**
+     * Simple keyword overlap score when embeddings aren't available.
+     * Counts how many query words appear in the content.
+     */
+    private keywordScore;
+}
+//# sourceMappingURL=retriever.d.ts.map

package/dist/retrieval/retriever.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retriever.d.ts","sourceRoot":"","sources":["../../src/retrieval/retriever.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EACV,cAAc,EACd,YAAY,EACZ,MAAM,EACN,cAAc,EACf,MAAM,aAAa,CAAC;AAErB;;;;;;;;;GASG;AACH,qBAAa,eAAe;IAExB,OAAO,CAAC,EAAE;IACV,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,MAAM;gBAFN,EAAE,EAAE,cAAc,EAClB,UAAU,EAAE,iBAAiB,EAC7B,MAAM,EAAE,cAAc;IAG1B,KAAK,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAgE7D,0DAA0D;IACpD,cAAc,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAIzC,8CAA8C;IACxC,YAAY,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAUrD,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,kBAAkB;IAU1B,OAAO,CAAC,YAAY;IAQpB;;;OAGG;IACH,OAAO,CAAC,YAAY;CAYrB"}

package/dist/retrieval/retriever.js

@@ -0,0 +1,126 @@
+import { EmbeddingProvider } from '../store/embeddings.js';
+/**
+ * Multi-signal retriever — ranks memories using:
+ *   0.40 × semantic similarity  (embedding cosine)
+ *   0.25 × file proximity       (same directory as scope)
+ *   0.20 × recency              (newer = higher)
+ *   0.15 × confidence           (author confidence score)
+ *   – staleness penalty          (stale memories pushed down)
+ *
+ * Falls back to keyword matching when embeddings aren't available.
+ */
+export class MemoryRetriever {
+    db;
+    embeddings;
+    config;
+    constructor(db, embeddings, config) {
+        this.db = db;
+        this.embeddings = embeddings;
+        this.config = config;
+    }
+    async query(request) {
+        const limit = request.limit ?? this.config.defaultLimit;
+        const includeStale = request.includeStale ?? false;
+        // Get candidate memories
+        let candidates;
+        if (request.tier) {
+            candidates = this.db.getMemoriesByTier(request.tier, includeStale);
+        }
+        else if (request.category) {
+            candidates = this.db.getMemoriesByCategory(request.category);
+        }
+        else {
+            candidates = this.db.getAllMemories(includeStale);
+        }
+        // Further filter by category if both tier and category specified
+        if (request.tier && request.category) {
+            candidates = candidates.filter((m) => m.category === request.category);
+        }
+        // Filter by scope (directory prefix)
+        if (request.scope) {
+            candidates = candidates.filter((m) => m.relatedFiles.some((f) => f.startsWith(request.scope)));
+        }
+        if (candidates.length === 0)
+            return [];
+        // Try to get query embedding for semantic scoring
+        const queryEmbedding = await this.embeddings.embed(request.query);
+        // Score each candidate
+        const scored = candidates.map((memory) => {
+            const semantic = this.scoreSemantic(memory, request.query, queryEmbedding);
+            const fileProximity = this.scoreFileProximity(memory, request.scope);
+            const recency = this.scoreRecency(memory);
+            const confidence = memory.confidence;
+            const stalenessPenalty = memory.staleness * 0.5;
+            const score = 0.4 * semantic +
+                0.25 * fileProximity +
+                0.2 * recency +
+                0.15 * confidence -
+                stalenessPenalty;
+            return {
+                memory,
+                score,
+                breakdown: {
+                    semantic,
+                    fileProximity,
+                    recency,
+                    confidence,
+                    stalenessPenalty,
+                },
+            };
+        });
+        // Sort by score descending, return top-K
+        scored.sort((a, b) => b.score - a.score);
+        return scored.slice(0, limit);
+    }
+    /** Convenience: get all conventions (no query needed). */
+    async getConventions() {
+        return this.db.getMemoriesByCategory('convention');
+    }
+    /** Convenience: get decisions for a scope. */
+    async getDecisions(scope) {
+        const decisions = this.db.getMemoriesByCategory('decision');
+        if (!scope)
+            return decisions;
+        return decisions.filter((m) => m.relatedFiles.some((f) => f.startsWith(scope)));
+    }
+    // ── Scoring Functions ──
+    scoreSemantic(memory, query, queryEmbedding) {
+        // If we have embeddings for both, use cosine similarity
+        if (queryEmbedding && memory.embedding) {
+            return EmbeddingProvider.cosineSimilarity(queryEmbedding, memory.embedding);
+        }
+        // Fallback: keyword matching
+        return this.keywordScore(memory.content, query);
+    }
+    scoreFileProximity(memory, scope) {
+        if (!scope)
+            return 0.5; // Neutral when no scope
+        const matches = memory.relatedFiles.filter((f) => f.startsWith(scope)).length;
+        const total = memory.relatedFiles.length;
+        if (total === 0)
+            return 0.3;
+        return Math.min(matches / total, 1.0);
+    }
+    scoreRecency(memory) {
+        const ageMs = Date.now() - new Date(memory.createdAt).getTime();
+        const ageDays = ageMs / (1000 * 60 * 60 * 24);
+        // Exponential decay: half-life of 30 days
+        return Math.exp(-ageDays / 30);
+    }
+    /**
+     * Simple keyword overlap score when embeddings aren't available.
+     * Counts how many query words appear in the content.
+     */
+    keywordScore(content, query) {
+        const queryWords = query
+            .toLowerCase()
+            .split(/\s+/)
+            .filter((w) => w.length > 2);
+        const contentLower = content.toLowerCase();
+        if (queryWords.length === 0)
+            return 0;
+        const matches = queryWords.filter((w) => contentLower.includes(w)).length;
+        return matches / queryWords.length;
+    }
+}
+//# sourceMappingURL=retriever.js.map

package/dist/retrieval/retriever.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retriever.js","sourceRoot":"","sources":["../../src/retrieval/retriever.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAQ3D;;;;;;;;;GASG;AACH,MAAM,OAAO,eAAe;IAEhB;IACA;IACA;IAHV,YACU,EAAkB,EAClB,UAA6B,EAC7B,MAAsB;QAFtB,OAAE,GAAF,EAAE,CAAgB;QAClB,eAAU,GAAV,UAAU,CAAmB;QAC7B,WAAM,GAAN,MAAM,CAAgB;IAC7B,CAAC;IAEJ,KAAK,CAAC,KAAK,CAAC,OAAuB;QACjC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC;QACxD,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,KAAK,CAAC;QAEnD,yBAAyB;QACzB,IAAI,UAAoB,CAAC;QACzB,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,UAAU,GAAG,IAAI,CAAC,EAAE,CAAC,iBAAiB,CAAC,OAAO,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;QACrE,CAAC;aAAM,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YAC5B,UAAU,GAAG,IAAI,CAAC,EAAE,CAAC,qBAAqB,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC/D,CAAC;aAAM,CAAC;YACN,UAAU,GAAG,IAAI,CAAC,EAAE,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC;QACpD,CAAC;QAED,iEAAiE;QACjE,IAAI,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACrC,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;QACzE,CAAC;QAED,qCAAqC;QACrC,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YAClB,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CACnC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,KAAM,CAAC,CAAC,CACzD,CAAC;QACJ,CAAC;QAED,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAEvC,kDAAkD;QAClD,MAAM,cAAc,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAElE,uBAAuB;QACvB,MAAM,MAAM,GAAmB,UAAU,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;YACvD,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC;YAC3E,MAAM,aAAa,GAAG,IAAI,CAAC,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;YACrE,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;YAC1C,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;YACrC,MAAM,gBAAgB,GAAG,MAAM,CAAC,SAAS,GAAG,GAAG,CAAC;YAEhD,MAAM,KAAK,GACT,GAAG,GAAG,QAAQ;gBACd,IAAI,GAAG,aAAa;gBACpB,GAAG,GAAG,OAAO;gBACb,IAAI,GAAG,UAAU;gBACjB,gBAAgB,CAAC;YAEnB,OAAO;gBACL,MAAM;gBACN,KAAK;gBACL,SAAS,EAAE;oBACT,QAAQ;oBACR,aAAa;oBACb,OAAO;oBACP,UAAU;oBACV,gBAAgB;iBACjB;aACF,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,yCAAyC;QACzC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;QACzC,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IAChC,CAAC;IAED,0DAA0D;IAC1D,KAAK,CAAC,cAAc;QAClB,OAAO,IAAI,CAAC,EAAE,CAAC,qBAAqB,CAAC,YAAY,CAAC,CAAC;IACrD,CAAC;IAED,8CAA8C;IAC9C,KAAK,CAAC,YAAY,CAAC,KAAc;QAC/B,MAAM,SAAS,GAAG,IAAI,CAAC,EAAE,CAAC,qBAAqB,CAAC,UAAU,CAAC,CAAC;QAC5D,IAAI,CAAC,KAAK;YAAE,OAAO,SAAS,CAAC;QAC7B,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAC5B,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAChD,CAAC;IACJ,CAAC;IAED,0BAA0B;IAElB,aAAa,CAAC,MAAc,EAAE,KAAa,EAAE,cAA+B;QAClF,wDAAwD;QACxD,IAAI,cAAc,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;YACvC,OAAO,iBAAiB,CAAC,gBAAgB,CAAC,cAAc,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;QAC9E,CAAC;QAED,6BAA6B;QAC7B,OAAO,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAClD,CAAC;IAEO,kBAAkB,CAAC,MAAc,EAAE,KAAc;QACvD,IAAI,CAAC,KAAK;YAAE,OAAO,GAAG,CAAC,CAAC,wBAAwB;QAEhD,MAAM,OAAO,GAAG,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;QAC9E,MAAM,KAAK,GAAG,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC;QAEzC,IAAI,KAAK,KAAK,CAAC;YAAE,OAAO,GAAG,CAAC;QAC5B,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,GAAG,KAAK,EAAE,GAAG,CAAC,CAAC;IACxC,CAAC;IAEO,YAAY,CAAC,MAAc;QACjC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC;QAChE,MAAM,OAAO,GAAG,KAAK,GAAG,CAAC,IAAI,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;QAE9C,0CAA0C;QAC1C,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;IACjC,CAAC;IAED;;;OAGG;IACK,YAAY,CAAC,OAAe,EAAE,KAAa;QACjD,MAAM,UAAU,GAAG,KAAK;aACrB,WAAW,EAAE;aACb,KAAK,CAAC,KAAK,CAAC;aACZ,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC/B,MAAM,YAAY,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;QAE3C,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,CAAC,CAAC;QAEtC,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;QAC1E,OAAO,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC;IACrC,CAAC;CACF"}

package/dist/session/insight-detector.d.ts

@@ -0,0 +1,10 @@
+import type { InsightType, MemoryCategory } from '../types.js';
+export declare class InsightDetector {
+    /** Detect the most likely insight type from content. */
+    detect(content: string): InsightType;
+    /** Score confidence in the detected type (0.0 - 1.0). */
+    scoreConfidence(content: string, type: InsightType): number;
+    /** Convert InsightType to MemoryCategory. */
+    toCategory(type: InsightType): MemoryCategory;
+}
+//# sourceMappingURL=insight-detector.d.ts.map

package/dist/session/insight-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"insight-detector.d.ts","sourceRoot":"","sources":["../../src/session/insight-detector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAkD/D,qBAAa,eAAe;IAC1B,wDAAwD;IACxD,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW;IAoBpC,yDAAyD;IACzD,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,MAAM;IAkB3D,6CAA6C;IAC7C,UAAU,CAAC,IAAI,EAAE,WAAW,GAAG,cAAc;CAG9C"}

package/dist/session/insight-detector.js

@@ -0,0 +1,87 @@
+const PATTERNS = {
+    gotcha: [
+        /\b(gotcha|pitfall|trap|caveat|watch out|careful|beware|silently|unexpect|quirk|subtle|hidden)\b/i,
+        /\b(doesn'?t work|broke|breaking|fail|error when|crash|bug|issue with)\b/i,
+        /\b(actually|turns out|it seems|surprisingly|counterintuitive)\b/i,
+    ],
+    convention: [
+        /\b(convention|naming|style|pattern|always use|never use|prefer|standard|consistent)\b/i,
+        /\b(format|lint|eslint|prettier|coding style|best practice)\b/i,
+        /\b(should be|must be|required to|expected to)\b/i,
+    ],
+    architecture: [
+        /\b(architect|structure|design|pattern|module|component|layer|service|system)\b/i,
+        /\b(split|extract|decouple|separate|organize|restructure)\b/i,
+        /\b(data flow|pipeline|middleware|handler|controller|provider)\b/i,
+    ],
+    dependency: [
+        /\b(depend|package|library|version|npm|import|require|install|upgrade)\b/i,
+        /\b(compatible|incompatible|peer|resolution|conflict)\b/i,
+        /\b(deprecated|removed|replaced|alternative)\b/i,
+    ],
+    decision: [
+        /\b(decided|chose|picked|selected|went with|opted for|reason)\b/i,
+        /\b(because|instead of|trade-?off|pros? and cons?|alternative)\b/i,
+        /\b(approach|strategy|solution|design decision)\b/i,
+    ],
+    correction: [
+        /\b(wrong|incorrect|mistake|fix|correct|should not|don'?t|avoid|never)\b/i,
+        /\b(deprecated|outdated|stale|obsolete|removed)\b/i,
+        /\b(instead|replace|update|change to)\b/i,
+    ],
+    discovery: [
+        /\b(found|discover|learn|realize|notice|understand|figure out)\b/i,
+        /\b(how .+ works|works by|implemented as|under the hood)\b/i,
+        /\b(interesting|notable|important|key insight)\b/i,
+    ],
+};
+const INSIGHT_TO_CATEGORY = {
+    gotcha: 'gotcha',
+    convention: 'convention',
+    architecture: 'architecture',
+    dependency: 'dependency',
+    decision: 'decision',
+    correction: 'correction',
+    discovery: 'discovery',
+};
+export class InsightDetector {
+    /** Detect the most likely insight type from content. */
+    detect(content) {
+        let bestType = 'discovery';
+        let bestScore = 0;
+        for (const [type, patterns] of Object.entries(PATTERNS)) {
+            let score = 0;
+            for (const pattern of patterns) {
+                if (pattern.test(content)) {
+                    score++;
+                }
+            }
+            if (score > bestScore) {
+                bestScore = score;
+                bestType = type;
+            }
+        }
+        return bestType;
+    }
+    /** Score confidence in the detected type (0.0 - 1.0). */
+    scoreConfidence(content, type) {
+        const patterns = PATTERNS[type];
+        if (!patterns)
+            return 0.5;
+        let matches = 0;
+        for (const pattern of patterns) {
+            if (pattern.test(content))
+                matches++;
+        }
+        // Base confidence from pattern matches
+        const matchRatio = matches / patterns.length;
+        // Boost for longer content (more context = more confident)
+        const lengthBoost = Math.min(content.length / 200, 0.2);
+        return Math.min(0.5 + matchRatio * 0.4 + lengthBoost, 1.0);
+    }
+    /** Convert InsightType to MemoryCategory. */
+    toCategory(type) {
+        return INSIGHT_TO_CATEGORY[type];
+    }
+}
+//# sourceMappingURL=insight-detector.js.map

package/dist/session/insight-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"insight-detector.js","sourceRoot":"","sources":["../../src/session/insight-detector.ts"],"names":[],"mappings":"AAEA,MAAM,QAAQ,GAAkC;IAC9C,MAAM,EAAE;QACN,kGAAkG;QAClG,0EAA0E;QAC1E,kEAAkE;KACnE;IACD,UAAU,EAAE;QACV,wFAAwF;QACxF,+DAA+D;QAC/D,kDAAkD;KACnD;IACD,YAAY,EAAE;QACZ,iFAAiF;QACjF,6DAA6D;QAC7D,kEAAkE;KACnE;IACD,UAAU,EAAE;QACV,0EAA0E;QAC1E,yDAAyD;QACzD,gDAAgD;KACjD;IACD,QAAQ,EAAE;QACR,iEAAiE;QACjE,kEAAkE;QAClE,mDAAmD;KACpD;IACD,UAAU,EAAE;QACV,0EAA0E;QAC1E,mDAAmD;QACnD,yCAAyC;KAC1C;IACD,SAAS,EAAE;QACT,kEAAkE;QAClE,4DAA4D;QAC5D,kDAAkD;KACnD;CACF,CAAC;AAEF,MAAM,mBAAmB,GAAwC;IAC/D,MAAM,EAAE,QAAQ;IAChB,UAAU,EAAE,YAAY;IACxB,YAAY,EAAE,cAAc;IAC5B,UAAU,EAAE,YAAY;IACxB,QAAQ,EAAE,UAAU;IACpB,UAAU,EAAE,YAAY;IACxB,SAAS,EAAE,WAAW;CACvB,CAAC;AAEF,MAAM,OAAO,eAAe;IAC1B,wDAAwD;IACxD,MAAM,CAAC,OAAe;QACpB,IAAI,QAAQ,GAAgB,WAAW,CAAC;QACxC,IAAI,SAAS,GAAG,CAAC,CAAC;QAElB,KAAK,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAA8B,EAAE,CAAC;YACrF,IAAI,KAAK,GAAG,CAAC,CAAC;YACd,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;gBAC/B,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;oBAC1B,KAAK,EAAE,CAAC;gBACV,CAAC;YACH,CAAC;YACD,IAAI,KAAK,GAAG,SAAS,EAAE,CAAC;gBACtB,SAAS,GAAG,KAAK,CAAC;gBAClB,QAAQ,GAAG,IAAI,CAAC;YAClB,CAAC;QACH,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,yDAAyD;IACzD,eAAe,CAAC,OAAe,EAAE,IAAiB;QAChD,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,CAAC,QAAQ;YAAE,OAAO,GAAG,CAAC;QAE1B,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC;gBAAE,OAAO,EAAE,CAAC;QACvC,CAAC;QAED,uCAAuC;QACvC,MAAM,UAAU,GAAG,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC;QAE7C,2DAA2D;QAC3D,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,GAAG,GAAG,EAAE,GAAG,CAAC,CAAC;QAExD,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,UAAU,GAAG,GAAG,GAAG,WAAW,EAAE,GAAG,CAAC,CAAC;IAC7D,CAAC;IAED,6CAA6C;IAC7C,UAAU,CAAC,IAAiB;QAC1B,OAAO,mBAAmB,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;CACF"}

package/dist/session/session-manager.d.ts

@@ -0,0 +1,49 @@
+import type { MemoryDatabase } from '../store/database.js';
+import type { TeamLensConfig, Session, ActivityType, Memory } from '../types.js';
+import type { TeamSync } from '../sync/team-sync.js';
+import type { EmbeddingProvider } from '../store/embeddings.js';
+export declare class SessionManager {
+    private db;
+    private config;
+    private teamSync;
+    private embeddings;
+    private currentSessionId;
+    private sessionJustCreated;
+    private insightDetector;
+    constructor(db: MemoryDatabase, config: TeamLensConfig, teamSync: TeamSync, embeddings: EmbeddingProvider);
+    /** Get or create an active session. Auto-session pattern. */
+    getOrCreateSession(toolName?: string): Session;
+    /** Check if the last getOrCreateSession call created a new session. */
+    wasSessionJustCreated(): boolean;
+    /** Explicitly start a session with task context. */
+    startSession(task?: string, toolName?: string): Session;
+    /** End a session with optional summary. */
+    endSession(sessionId?: string, summary?: string): Session | null;
+    /** Share an insight with the team. Auto-detects type, auto-creates session if needed. */
+    shareInsight(content: string, relatedFiles?: string[], tags?: string[]): Promise<{
+        memoryId: string;
+        insightType: string;
+        sessionId: string;
+    }>;
+    /** Log an activity event. Auto-creates session if needed. */
+    logActivity(type: ActivityType, description?: string, files?: string[]): {
+        eventId: string;
+        sessionId: string;
+    };
+    /** Add a file to the session's files_touched list. */
+    trackFile(sessionId: string, filePath: string): void;
+    /** Close stale sessions that have been active too long. */
+    cleanupStaleSessions(timeoutMinutes?: number): number;
+    /** Get the current active session. */
+    getActiveSession(): Session | null;
+    /** Get team context for injection at session start. */
+    getTeamContext(limit?: number): Memory[];
+    /**
+     * Ingest hook events from .teamlens/hooks.jsonl into the database.
+     * Called by the MCP server before each tool handler to pick up
+     * activity logged by Claude Code PostToolUse hooks.
+     */
+    ingestHookEvents(repoPath: string): number;
+    private createSession;
+}
+//# sourceMappingURL=session-manager.d.ts.map

package/dist/session/session-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-manager.d.ts","sourceRoot":"","sources":["../../src/session/session-manager.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,OAAO,EAAiB,YAAY,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAEhG,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEhE,qBAAa,cAAc;IAMvB,OAAO,CAAC,EAAE;IACV,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,UAAU;IARpB,OAAO,CAAC,gBAAgB,CAAuB;IAC/C,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,eAAe,CAAkB;gBAG/B,EAAE,EAAE,cAAc,EAClB,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,QAAQ,EAClB,UAAU,EAAE,iBAAiB;IAKvC,6DAA6D;IAC7D,kBAAkB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO;IAgB9C,uEAAuE;IACvE,qBAAqB,IAAI,OAAO;IAIhC,oDAAoD;IACpD,YAAY,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO;IAavD,2CAA2C;IAC3C,UAAU,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI;IAahE,yFAAyF;IACnF,YAAY,CAChB,OAAO,EAAE,MAAM,EACf,YAAY,GAAE,MAAM,EAAO,EAC3B,IAAI,GAAE,MAAM,EAAO,GAClB,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAqDxE,6DAA6D;IAC7D,WAAW,CACT,IAAI,EAAE,YAAY,EAClB,WAAW,GAAE,MAAW,EACxB,KAAK,GAAE,MAAM,EAAO,GACnB;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE;IAyBzC,sDAAsD;IACtD,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAYpD,2DAA2D;IAC3D,oBAAoB,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM;IAKrD,sCAAsC;IACtC,gBAAgB,IAAI,OAAO,GAAG,IAAI;IAQlC,uDAAuD;IACvD,cAAc,CAAC,KAAK,SAAK,GAAG,MAAM,EAAE;IAIpC;;;;OAIG;IACH,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAuD1C,OAAO,CAAC,aAAa;CA0BtB"}

package/dist/session/session-manager.js

@@ -0,0 +1,228 @@
+import { randomUUID } from 'node:crypto';
+import fs from 'node:fs';
+import path from 'node:path';
+import { InsightDetector } from './insight-detector.js';
+export class SessionManager {
+    db;
+    config;
+    teamSync;
+    embeddings;
+    currentSessionId = null;
+    sessionJustCreated = false;
+    insightDetector;
+    constructor(db, config, teamSync, embeddings) {
+        this.db = db;
+        this.config = config;
+        this.teamSync = teamSync;
+        this.embeddings = embeddings;
+        this.insightDetector = new InsightDetector();
+    }
+    /** Get or create an active session. Auto-session pattern. */
+    getOrCreateSession(toolName) {
+        // Check for existing active session
+        const developer = this.config.developer !== 'unknown' ? this.config.developer : this.config.author;
+        const existing = this.db.getActiveSession(developer);
+        if (existing) {
+            this.currentSessionId = existing.id;
+            this.sessionJustCreated = false;
+            return existing;
+        }
+        // Create new session
+        const session = this.createSession(toolName);
+        this.sessionJustCreated = true;
+        return session;
+    }
+    /** Check if the last getOrCreateSession call created a new session. */
+    wasSessionJustCreated() {
+        return this.sessionJustCreated;
+    }
+    /** Explicitly start a session with task context. */
+    startSession(task, toolName) {
+        const developer = this.config.developer !== 'unknown' ? this.config.developer : this.config.author;
+        // Close any existing active session
+        const existing = this.db.getActiveSession(developer);
+        if (existing) {
+            this.db.closeSession(existing.id);
+        }
+        const session = this.createSession(toolName, task);
+        return session;
+    }
+    /** End a session with optional summary. */
+    endSession(sessionId, summary) {
+        const id = sessionId ?? this.currentSessionId;
+        if (!id)
+            return null;
+        this.db.closeSession(id, summary);
+        if (id === this.currentSessionId) {
+            this.currentSessionId = null;
+        }
+        return this.db.getSession(id);
+    }
+    /** Share an insight with the team. Auto-detects type, auto-creates session if needed. */
+    async shareInsight(content, relatedFiles = [], tags = []) {
+        // Ensure session exists
+        const session = this.getOrCreateSession();
+        // Auto-detect insight type
+        const insightType = this.insightDetector.detect(content);
+        const category = this.insightDetector.toCategory(insightType);
+        const confidence = this.insightDetector.scoreConfidence(content, insightType);
+        // Store as team memory with session context
+        const memory = this.db.insertMemory({
+            content,
+            category,
+            relatedFiles,
+            tags: [...tags, insightType],
+            confidence,
+            commitSha: null,
+        }, this.config.developer !== 'unknown' ? this.config.developer : this.config.author, 'team', session.id);
+        // Generate embedding
+        const embedding = await this.embeddings.embed(content);
+        if (embedding) {
+            this.db.updateEmbedding(memory.id, embedding);
+        }
+        // Update session insight count
+        this.db.updateSession(session.id, {
+            insightCount: session.insightCount + 1,
+        });
+        // Export to team.jsonl (append-only, not full rewrite)
+        this.teamSync.appendMemory(memory);
+        // Auto-commit and push so teammates get it immediately
+        this.teamSync.autoCommitAndPush();
+        // Track related files
+        for (const file of relatedFiles) {
+            this.trackFile(session.id, file);
+        }
+        return {
+            memoryId: memory.id,
+            insightType,
+            sessionId: session.id,
+        };
+    }
+    /** Log an activity event. Auto-creates session if needed. */
+    logActivity(type, description = '', files = []) {
+        const session = this.getOrCreateSession();
+        const event = {
+            id: randomUUID(),
+            sessionId: session.id,
+            type,
+            description,
+            files,
+            timestamp: new Date().toISOString(),
+        };
+        this.db.insertActivityEvent(event);
+        // Track files
+        for (const file of files) {
+            this.trackFile(session.id, file);
+        }
+        return {
+            eventId: event.id,
+            sessionId: session.id,
+        };
+    }
+    /** Add a file to the session's files_touched list. */
+    trackFile(sessionId, filePath) {
+        const session = this.db.getSession(sessionId);
+        if (!session)
+            return;
+        if (!session.filesTouched.includes(filePath)) {
+            session.filesTouched.push(filePath);
+            this.db.updateSession(sessionId, {
+                filesTouched: session.filesTouched,
+            });
+        }
+    }
+    /** Close stale sessions that have been active too long. */
+    cleanupStaleSessions(timeoutMinutes) {
+        const timeout = timeoutMinutes ?? this.config.sessionTimeoutMinutes;
+        return this.db.cleanupStaleSessions(timeout);
+    }
+    /** Get the current active session. */
+    getActiveSession() {
+        if (this.currentSessionId) {
+            return this.db.getSession(this.currentSessionId);
+        }
+        const developer = this.config.developer !== 'unknown' ? this.config.developer : this.config.author;
+        return this.db.getActiveSession(developer);
+    }
+    /** Get team context for injection at session start. */
+    getTeamContext(limit = 10) {
+        return this.db.getRecentInsights(limit);
+    }
+    /**
+     * Ingest hook events from .teamlens/hooks.jsonl into the database.
+     * Called by the MCP server before each tool handler to pick up
+     * activity logged by Claude Code PostToolUse hooks.
+     */
+    ingestHookEvents(repoPath) {
+        const hooksFile = path.join(repoPath, this.config.storageDir, 'hooks.jsonl');
+        if (!fs.existsSync(hooksFile))
+            return 0;
+        const content = fs.readFileSync(hooksFile, 'utf-8').trim();
+        if (!content)
+            return 0;
+        const lines = content.split('\n').filter(Boolean);
+        if (lines.length === 0)
+            return 0;
+        const session = this.getOrCreateSession();
+        let ingested = 0;
+        for (const line of lines) {
+            try {
+                const hookEvent = JSON.parse(line);
+                const event = {
+                    id: randomUUID(),
+                    sessionId: session.id,
+                    type: hookEvent.type ?? 'other',
+                    description: hookEvent.description ?? hookEvent.tool ?? '',
+                    files: hookEvent.files ?? [],
+                    timestamp: hookEvent.timestamp ?? new Date().toISOString(),
+                };
+                this.db.insertActivityEvent(event);
+                // Track files
+                for (const file of event.files) {
+                    this.trackFile(session.id, file);
+                }
+                ingested++;
+            }
+            catch {
+                // Skip malformed lines
+            }
+        }
+        // Update session activity count
+        if (ingested > 0) {
+            const updated = this.db.getSession(session.id);
+            if (updated) {
+                this.db.updateSession(session.id, {
+                    activityCount: updated.activityCount + ingested,
+                });
+            }
+        }
+        // Clear the hooks file after ingestion
+        fs.writeFileSync(hooksFile, '');
+        return ingested;
+    }
+    // ── Private ──
+    createSession(toolName, task) {
+        const developer = this.config.developer !== 'unknown' ? this.config.developer : this.config.author;
+        const session = {
+            id: randomUUID(),
+            developer,
+            task: task ?? '',
+            status: 'active',
+            toolName: toolName ?? 'unknown',
+            startedAt: new Date().toISOString(),
+            endedAt: null,
+            durationSeconds: null,
+            filesTouched: [],
+            summary: null,
+            insightCount: 0,
+            activityCount: 0,
+            duplicatesPrevented: 0,
+        };
+        this.db.insertSession(session);
+        this.currentSessionId = session.id;
+        // Cleanup any stale sessions
+        this.cleanupStaleSessions();
+        return session;
+    }
+}
+//# sourceMappingURL=session-manager.js.map

package/dist/session/session-manager.js.map

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

package/dist/staleness/staleness-engine.d.ts

@@ -0,0 +1,36 @@
+import type { MemoryDatabase } from '../store/database.js';
+import type { GitExtractor } from '../extractor/git-extractor.js';
+import type { StalenessCheck, Memory } from '../types.js';
+/**
+ * Staleness Engine — auto-invalidates memories when referenced files change.
+ *
+ * On each git event:
+ *  1. Get changed files from diff
+ *  2. Find memories that reference those files
+ *  3. Score staleness based on change magnitude
+ *  4. Update memory staleness scores
+ *
+ * Stale memories are downranked in retrieval, not deleted.
+ */
+export declare class StalenessEngine {
+    private db;
+    private git;
+    constructor(db: MemoryDatabase, git: GitExtractor);
+    /** Check all memories against current file states. Returns list of changes made. */
+    checkAll(): Promise<StalenessCheck[]>;
+    /** Check a single memory against its referenced files. */
+    checkMemory(memory: Memory): Promise<StalenessCheck[]>;
+    /** Process a set of changed files (e.g., from a git hook). */
+    processChangedFiles(changedFiles: string[]): Promise<StalenessCheck[]>;
+    private applyStale;
+    /**
+     * Estimate how much a file change should affect staleness.
+     *
+     * Heuristic based on file name patterns:
+     * - Config files changing → high impact (0.7)
+     * - Test files changing → low impact (0.1)
+     * - Source files → medium (0.3–0.5)
+     */
+    private estimateChangeMagnitude;
+}
+//# sourceMappingURL=staleness-engine.d.ts.map

package/dist/staleness/staleness-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"staleness-engine.d.ts","sourceRoot":"","sources":["../../src/staleness/staleness-engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1D;;;;;;;;;;GAUG;AACH,qBAAa,eAAe;IAExB,OAAO,CAAC,EAAE;IACV,OAAO,CAAC,GAAG;gBADH,EAAE,EAAE,cAAc,EAClB,GAAG,EAAE,YAAY;IAG3B,oFAAoF;IAC9E,QAAQ,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAY3C,0DAA0D;IACpD,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IA4C5D,8DAA8D;IACxD,mBAAmB,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAqC5E,OAAO,CAAC,UAAU;IAoBlB;;;;;;;OAOG;YACW,uBAAuB;CAiCtC"}