causantic 0.9.4 → 0.10.1

package/dist/index-entries/index-refresher.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Batch index entry refinement and backfill.
+ *
+ * Follows the cluster-refresh.ts pattern: Anthropic client, rate limiter,
+ * keychain API key. Used by the backfill-index maintenance task.
+ */
+/** Result from a backfill run. */
+export interface BackfillResult {
+    /** Number of new index entries created */
+    entriesCreated: number;
+    /** Number of entries created via LLM */
+    llmEntries: number;
+    /** Number of entries created via Jeopardy-style generation */
+    jeopardyEntries: number;
+    /** Number of entries created via heuristic */
+    heuristicEntries: number;
+    /** Number of chunks that had no content to index */
+    skipped: number;
+    /** Total duration in milliseconds */
+    durationMs: number;
+}
+/**
+ * Index entry refresher for batch backfill and refinement.
+ */
+export declare class IndexRefresher {
+    private client;
+    private rateLimiter;
+    private config;
+    constructor();
+    /**
+     * Initialize the Anthropic client. Returns null if no API key available.
+     */
+    private getClient;
+    /**
+     * Backfill index entries for chunks that don't have them.
+     *
+     * Processes chunks in session-grouped batches. Uses LLM when available,
+     * falls back to heuristic. Also embeds the generated descriptions.
+     */
+    backfill(options?: {
+        limit?: number;
+        onProgress?: (current: number, total: number) => void;
+    }): Promise<BackfillResult>;
+    /**
+     * Get backfill status: how many chunks still need index entries.
+     */
+    getBackfillStatus(): {
+        indexed: number;
+        total: number;
+        remaining: number;
+    };
+}
+export declare const indexRefresher: IndexRefresher;
+//# sourceMappingURL=index-refresher.d.ts.map

package/dist/index-entries/index-refresher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-refresher.d.ts","sourceRoot":"","sources":["../../src/index-entries/index-refresher.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAwCH,kCAAkC;AAClC,MAAM,WAAW,cAAc;IAC7B,0CAA0C;IAC1C,cAAc,EAAE,MAAM,CAAC;IACvB,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,eAAe,EAAE,MAAM,CAAC;IACxB,8CAA8C;IAC9C,gBAAgB,EAAE,MAAM,CAAC;IACzB,oDAAoD;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,MAAM,CAAe;;IAM7B;;OAEG;YACW,SAAS;IAuBvB;;;;;OAKG;IACG,QAAQ,CAAC,OAAO,CAAC,EAAE;QACvB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;KACvD,GAAG,OAAO,CAAC,cAAc,CAAC;IAgI3B;;OAEG;IACH,iBAAiB,IAAI;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE;CAU3E;AAGD,eAAO,MAAM,cAAc,gBAAuB,CAAC"}

package/dist/index-entries/index-refresher.js

@@ -0,0 +1,203 @@
+/**
+ * Batch index entry refinement and backfill.
+ *
+ * Follows the cluster-refresh.ts pattern: Anthropic client, rate limiter,
+ * keychain API key. Used by the backfill-index maintenance task.
+ */
+import Anthropic from '@anthropic-ai/sdk';
+import { getConfig } from '../config/memory-config.js';
+import { getChunksByIds } from '../storage/chunk-store.js';
+import { getUnindexedChunkIds, insertIndexEntries, getIndexedChunkCount, } from '../storage/index-entry-store.js';
+import { getChunkCount } from '../storage/chunk-store.js';
+import { indexVectorStore } from '../storage/vector-store.js';
+import { Embedder } from '../models/embedder.js';
+import { getModel } from '../models/model-registry.js';
+import { createSecretStore } from '../utils/secret-store.js';
+import { createLogger } from '../utils/logger.js';
+import { generateLLMEntries, generateHeuristicEntry } from './index-generator.js';
+const log = createLogger('index-refresher');
+/** Rate limiter for API calls. */
+class RateLimiter {
+    lastCall = 0;
+    minIntervalMs;
+    constructor(callsPerMinute) {
+        this.minIntervalMs = (60 * 1000) / callsPerMinute;
+    }
+    async wait() {
+        const now = Date.now();
+        const elapsed = now - this.lastCall;
+        if (elapsed < this.minIntervalMs) {
+            await new Promise((resolve) => setTimeout(resolve, this.minIntervalMs - elapsed));
+        }
+        this.lastCall = Date.now();
+    }
+}
+/**
+ * Index entry refresher for batch backfill and refinement.
+ */
+export class IndexRefresher {
+    client = null;
+    rateLimiter;
+    config = getConfig();
+    constructor() {
+        this.rateLimiter = new RateLimiter(this.config.refreshRateLimitPerMin);
+    }
+    /**
+     * Initialize the Anthropic client. Returns null if no API key available.
+     */
+    async getClient() {
+        if (!this.client) {
+            if (!process.env.ANTHROPIC_API_KEY) {
+                try {
+                    const store = createSecretStore();
+                    const storedKey = await store.get('anthropic-api-key');
+                    if (storedKey) {
+                        process.env.ANTHROPIC_API_KEY = storedKey;
+                    }
+                }
+                catch {
+                    // Keychain not available
+                }
+            }
+            if (!process.env.ANTHROPIC_API_KEY) {
+                return null;
+            }
+            this.client = new Anthropic();
+        }
+        return this.client;
+    }
+    /**
+     * Backfill index entries for chunks that don't have them.
+     *
+     * Processes chunks in session-grouped batches. Uses LLM when available,
+     * falls back to heuristic. Also embeds the generated descriptions.
+     */
+    async backfill(options) {
+        const startTime = Date.now();
+        const limit = options?.limit ?? this.config.semanticIndex.batchRefreshLimit;
+        // Find chunks without index entries
+        const unindexedChunkIds = getUnindexedChunkIds(limit);
+        if (unindexedChunkIds.length === 0) {
+            return {
+                entriesCreated: 0,
+                llmEntries: 0,
+                jeopardyEntries: 0,
+                heuristicEntries: 0,
+                skipped: 0,
+                durationMs: Date.now() - startTime,
+            };
+        }
+        log.info('Starting index backfill', { chunkCount: unindexedChunkIds.length });
+        // Load chunks
+        const chunks = getChunksByIds(unindexedChunkIds);
+        // Group by session slug for batched LLM calls
+        const sessionGroups = new Map();
+        for (const chunk of chunks) {
+            const group = sessionGroups.get(chunk.sessionSlug) ?? [];
+            group.push({
+                id: chunk.id,
+                sessionSlug: chunk.sessionSlug,
+                startTime: chunk.startTime,
+                content: chunk.content,
+                approxTokens: chunk.approxTokens,
+                agentId: chunk.agentId,
+                teamName: chunk.teamName,
+            });
+            sessionGroups.set(chunk.sessionSlug, group);
+        }
+        let entriesCreated = 0;
+        let llmEntries = 0;
+        let jeopardyEntries = 0;
+        let heuristicEntries = 0;
+        let skipped = 0;
+        // Set up embedder
+        const embedder = new Embedder();
+        const embeddingModel = this.config.embeddingModel;
+        await embedder.load(getModel(embeddingModel));
+        indexVectorStore.setModelId(embeddingModel);
+        try {
+            const client = await this.getClient();
+            let sessionIndex = 0;
+            const totalSessions = sessionGroups.size;
+            for (const [sessionSlug, sessionChunks] of sessionGroups) {
+                sessionIndex++;
+                options?.onProgress?.(sessionIndex, totalSessions);
+                // Generate entries (rate limiting happens per sub-batch inside generateLLMEntries)
+                let entries;
+                if (client) {
+                    entries = await generateLLMEntries(sessionChunks, sessionSlug, {
+                        onBeforeBatch: () => this.rateLimiter.wait(),
+                    });
+                }
+                else {
+                    entries = sessionChunks.map((chunk) => generateHeuristicEntry(chunk, sessionSlug));
+                }
+                // Filter out empty descriptions
+                const validEntries = entries.filter((e) => e.description.trim().length > 0);
+                skipped += entries.length - validEntries.length;
+                if (validEntries.length === 0)
+                    continue;
+                // Insert entries
+                const entryIds = insertIndexEntries(validEntries);
+                // Embed descriptions
+                const embeddings = [];
+                for (let i = 0; i < validEntries.length; i++) {
+                    const result = await embedder.embed(validEntries[i].description, false);
+                    embeddings.push({ id: entryIds[i], embedding: result.embedding });
+                }
+                await indexVectorStore.insertBatch(embeddings);
+                // Track stats
+                for (const entry of validEntries) {
+                    if (entry.generationMethod === 'jeopardy') {
+                        jeopardyEntries++;
+                    }
+                    else if (entry.generationMethod === 'llm') {
+                        llmEntries++;
+                    }
+                    else {
+                        heuristicEntries++;
+                    }
+                }
+                entriesCreated += validEntries.length;
+                log.debug('Backfilled session', {
+                    sessionSlug,
+                    entries: validEntries.length,
+                });
+            }
+        }
+        finally {
+            await embedder.dispose();
+        }
+        log.info('Index backfill complete', {
+            entriesCreated,
+            llmEntries,
+            jeopardyEntries,
+            heuristicEntries,
+            skipped,
+            durationMs: Date.now() - startTime,
+        });
+        return {
+            entriesCreated,
+            llmEntries,
+            jeopardyEntries,
+            heuristicEntries,
+            skipped,
+            durationMs: Date.now() - startTime,
+        };
+    }
+    /**
+     * Get backfill status: how many chunks still need index entries.
+     */
+    getBackfillStatus() {
+        const indexed = getIndexedChunkCount();
+        const total = getChunkCount();
+        return {
+            indexed,
+            total,
+            remaining: total - indexed,
+        };
+    }
+}
+// Singleton
+export const indexRefresher = new IndexRefresher();
+//# sourceMappingURL=index-refresher.js.map

package/dist/index-entries/index-refresher.js.map

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

package/dist/index-entries/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Semantic index layer exports.
+ */
+export { generateLLMEntries, generateHeuristicEntry, type ChunkForIndexing, type GenerateOptions, } from './index-generator.js';
+export { IndexRefresher, indexRefresher, type BackfillResult } from './index-refresher.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index-entries/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index-entries/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,KAAK,gBAAgB,EACrB,KAAK,eAAe,GACrB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/index-entries/index.js

@@ -0,0 +1,6 @@
+/**
+ * Semantic index layer exports.
+ */
+export { generateLLMEntries, generateHeuristicEntry, } from './index-generator.js';
+export { IndexRefresher, indexRefresher } from './index-refresher.js';
+//# sourceMappingURL=index.js.map

package/dist/index-entries/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index-entries/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,kBAAkB,EAClB,sBAAsB,GAGvB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,cAAc,EAAE,cAAc,EAAuB,MAAM,sBAAsB,CAAC"}

package/dist/index.d.ts

@@ -11,10 +11,14 @@ export * from './storage/encryption.js';
 export * from './storage/archive.js';
 export { ingestSession } from './ingest/ingest-session.js';
 export type { IngestResult, IngestOptions } from './ingest/ingest-session.js';
+export { extractSessionState } from './ingest/session-state.js';
+export type { SessionState, SessionError, SessionTask } from './ingest/session-state.js';
 export { batchIngest } from './ingest/batch-ingest.js';
 export type { BatchIngestOptions, BatchIngestResult } from './ingest/batch-ingest.js';
 export * from './retrieval/index.js';
 export * from './clusters/index.js';
+export * from './index-entries/index.js';
+export * from './repomap/index.js';
 export * from './maintenance/index.js';
 export * from './hooks/index.js';
 export { createSecretStore, getApiKey } from './utils/secret-store.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,cAAc,mBAAmB,CAAC;AAGlC,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AAGrC,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC9E,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAGtF,cAAc,sBAAsB,CAAC;AAGrC,cAAc,qBAAqB,CAAC;AAGpC,cAAc,wBAAwB,CAAC;AAGvC,cAAc,kBAAkB,CAAC;AAGjC,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,cAAc,mBAAmB,CAAC;AAGlC,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AAGrC,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC9E,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACzF,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAGtF,cAAc,sBAAsB,CAAC;AAGrC,cAAc,qBAAqB,CAAC;AAGpC,cAAc,0BAA0B,CAAC;AAGzC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,wBAAwB,CAAC;AAGvC,cAAc,kBAAkB,CAAC;AAGjC,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/index.js

@@ -13,11 +13,16 @@ export * from './storage/encryption.js';
 export * from './storage/archive.js';
 // Ingestion
 export { ingestSession } from './ingest/ingest-session.js';
+export { extractSessionState } from './ingest/session-state.js';
 export { batchIngest } from './ingest/batch-ingest.js';
 // Retrieval
 export * from './retrieval/index.js';
 // Clustering
 export * from './clusters/index.js';
+// Semantic Index
+export * from './index-entries/index.js';
+// Repo Map
+export * from './repomap/index.js';
 // Maintenance
 export * from './maintenance/index.js';
 // Hooks

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,gBAAgB;AAChB,cAAc,mBAAmB,CAAC;AAElC,yCAAyC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AAErC,YAAY;AACZ,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAE3D,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAGvD,YAAY;AACZ,cAAc,sBAAsB,CAAC;AAErC,aAAa;AACb,cAAc,qBAAqB,CAAC;AAEpC,cAAc;AACd,cAAc,wBAAwB,CAAC;AAEvC,QAAQ;AACR,cAAc,kBAAkB,CAAC;AAEjC,QAAQ;AACR,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,gBAAgB;AAChB,cAAc,mBAAmB,CAAC;AAElC,yCAAyC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AAErC,YAAY;AACZ,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAE3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAEhE,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAGvD,YAAY;AACZ,cAAc,sBAAsB,CAAC;AAErC,aAAa;AACb,cAAc,qBAAqB,CAAC;AAEpC,iBAAiB;AACjB,cAAc,0BAA0B,CAAC;AAEzC,WAAW;AACX,cAAc,oBAAoB,CAAC;AAEnC,cAAc;AACd,cAAc,wBAAwB,CAAC;AAEvC,QAAQ;AACR,cAAc,kBAAkB,CAAC;AAEjC,QAAQ;AACR,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/ingest/entity-extractor.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Deterministic entity extraction from chunk content.
+ *
+ * Pure function — no LLM, no database access. Extracts mentions of
+ * people, channels, meetings, organizations, and URLs using regex patterns.
+ *
+ * Only extracts from [User] and [Assistant] blocks; skips [Thinking] blocks
+ * and code blocks (triple-backtick fencing) to reduce noise.
+ */
+export type EntityType = 'person' | 'channel' | 'meeting' | 'organization' | 'url';
+export interface EntityMention {
+    entityType: EntityType;
+    mentionForm: string;
+    normalizedName: string;
+    confidence: number;
+}
+/**
+ * Extract entities from chunk text.
+ *
+ * Returns deduplicated entity mentions with types, normalized names, and confidence scores.
+ */
+export declare function extractEntities(text: string): EntityMention[];
+//# sourceMappingURL=entity-extractor.d.ts.map

package/dist/ingest/entity-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-extractor.d.ts","sourceRoot":"","sources":["../../src/ingest/entity-extractor.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,cAAc,GAAG,KAAK,CAAC;AAEnF,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,UAAU,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;CACpB;AAoJD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,EAAE,CA4F7D"}

package/dist/ingest/entity-extractor.js

@@ -0,0 +1,233 @@
+/**
+ * Deterministic entity extraction from chunk content.
+ *
+ * Pure function — no LLM, no database access. Extracts mentions of
+ * people, channels, meetings, organizations, and URLs using regex patterns.
+ *
+ * Only extracts from [User] and [Assistant] blocks; skips [Thinking] blocks
+ * and code blocks (triple-backtick fencing) to reduce noise.
+ */
+/** Words that look like names in "X said" patterns but aren't. */
+const BLOCKLIST = new Set([
+    // Pronouns
+    'i',
+    'he',
+    'she',
+    'we',
+    'they',
+    'you',
+    'it',
+    'me',
+    'him',
+    'her',
+    'us',
+    'them',
+    'my',
+    'his',
+    'our',
+    'their',
+    'your',
+    'its',
+    // Articles / determiners
+    'the',
+    'a',
+    'an',
+    'this',
+    'that',
+    'these',
+    'those',
+    // Common sentence starters / conjunctions
+    'but',
+    'and',
+    'or',
+    'so',
+    'if',
+    'when',
+    'then',
+    'also',
+    'just',
+    'now',
+    'here',
+    'there',
+    'what',
+    'who',
+    'how',
+    'why',
+    'which',
+    'where',
+    'some',
+    'all',
+    'any',
+    'each',
+    'every',
+    'not',
+    'no',
+    'yes',
+    'maybe',
+    'perhaps',
+    // Common words that appear capitalized at start of sentences
+    'however',
+    'therefore',
+    'meanwhile',
+    'otherwise',
+    'furthermore',
+    'additionally',
+    'finally',
+    'first',
+    'second',
+    'third',
+    'next',
+    'last',
+    // Tool/system words often capitalized
+    'error',
+    'warning',
+    'note',
+    'todo',
+    'fixme',
+    'hack',
+    'true',
+    'false',
+    'null',
+    'undefined',
+    'none',
+]);
+/** Meeting-related keywords. */
+const MEETING_KEYWORDS = /\b(standup|stand-up|retro|retrospective|1:1|one-on-one|sync|daily|weekly|sprint\s+review|sprint\s+planning|kick-?off|all-?hands)\b/gi;
+/** Email regex. */
+const EMAIL_PATTERN = /\b[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}\b/g;
+/** URL regex — matches http/https URLs. */
+const URL_PATTERN = /https?:\/\/[^\s<>"')\]]+/g;
+/** @mention pattern (Slack/Discord style). */
+const AT_MENTION_PATTERN = /@([a-zA-Z][a-zA-Z0-9._-]{0,30})\b/g;
+/** #channel pattern. */
+const CHANNEL_PATTERN = /#([a-zA-Z][a-zA-Z0-9_-]{0,50})\b/g;
+/** "X said" / "with X" / "from X" patterns — capitalized proper nouns. */
+const CONTEXTUAL_NAME_PATTERN = /\b([A-Z][a-z]{1,20}(?:\s+[A-Z][a-z]{1,20})?)\s+(?:said|says|mentioned|asked|replied|suggested|noted|reported|confirmed|explained|wrote|responded)\b/g;
+const WITH_FROM_PATTERN = /\b(?:with|from|by|to|cc|cc'd|cced)\s+([A-Z][a-z]{1,20}(?:\s+[A-Z][a-z]{1,20})?)\b/g;
+/**
+ * Strip code blocks (triple-backtick fenced) from text.
+ */
+function stripCodeBlocks(text) {
+    return text.replace(/```[\s\S]*?```/g, '');
+}
+/**
+ * Extract only [User] and [Assistant] blocks, skipping [Thinking] blocks.
+ * If no block markers found, returns the full text (non-session content).
+ */
+function extractRelevantBlocks(text) {
+    // Check if text has block markers
+    if (!text.includes('[User]') && !text.includes('[Assistant]')) {
+        return text;
+    }
+    const blocks = [];
+    // Split on block headers
+    const parts = text.split(/(\[(?:User|Assistant|Thinking)\])/);
+    let inRelevantBlock = false;
+    for (const part of parts) {
+        if (part === '[User]' || part === '[Assistant]') {
+            inRelevantBlock = true;
+            continue;
+        }
+        if (part === '[Thinking]') {
+            inRelevantBlock = false;
+            continue;
+        }
+        if (inRelevantBlock) {
+            blocks.push(part);
+        }
+    }
+    return blocks.join('\n');
+}
+/**
+ * Extract entities from chunk text.
+ *
+ * Returns deduplicated entity mentions with types, normalized names, and confidence scores.
+ */
+export function extractEntities(text) {
+    // Pre-process: skip thinking blocks and code blocks
+    const relevant = extractRelevantBlocks(text);
+    const cleaned = stripCodeBlocks(relevant);
+    const mentions = [];
+    const seen = new Set(); // "type:normalized" dedup key
+    function addMention(mention) {
+        const key = `${mention.entityType}:${mention.normalizedName}`;
+        if (seen.has(key))
+            return;
+        seen.add(key);
+        mentions.push(mention);
+    }
+    // @mentions → person
+    for (const match of cleaned.matchAll(AT_MENTION_PATTERN)) {
+        const name = match[1];
+        addMention({
+            entityType: 'person',
+            mentionForm: `@${name}`,
+            normalizedName: name.toLowerCase(),
+            confidence: 0.95,
+        });
+    }
+    // #channels → channel
+    for (const match of cleaned.matchAll(CHANNEL_PATTERN)) {
+        const name = match[1];
+        // Skip common non-channel uses of # (hex colors, markdown headers handled by context)
+        if (/^[0-9a-fA-F]{3,8}$/.test(name))
+            continue;
+        addMention({
+            entityType: 'channel',
+            mentionForm: `#${name}`,
+            normalizedName: name.toLowerCase(),
+            confidence: 0.95,
+        });
+    }
+    // Email addresses → person
+    for (const match of cleaned.matchAll(EMAIL_PATTERN)) {
+        const email = match[0];
+        addMention({
+            entityType: 'person',
+            mentionForm: email,
+            normalizedName: email.toLowerCase(),
+            confidence: 0.9,
+        });
+    }
+    // URLs → url
+    for (const match of cleaned.matchAll(URL_PATTERN)) {
+        const url = match[0];
+        addMention({
+            entityType: 'url',
+            mentionForm: url,
+            normalizedName: url,
+            confidence: 1.0,
+        });
+    }
+    // "X said" / "with X" patterns → person (lower confidence)
+    for (const pattern of [CONTEXTUAL_NAME_PATTERN, WITH_FROM_PATTERN]) {
+        pattern.lastIndex = 0; // Reset stateful regex
+        for (const match of cleaned.matchAll(pattern)) {
+            const name = match[1];
+            const normalized = name.toLowerCase();
+            // Check blocklist for each word in the name
+            const words = normalized.split(/\s+/);
+            if (words.some((w) => BLOCKLIST.has(w)))
+                continue;
+            addMention({
+                entityType: 'person',
+                mentionForm: name,
+                normalizedName: normalized,
+                confidence: 0.6,
+            });
+        }
+    }
+    // Meeting keywords → meeting
+    MEETING_KEYWORDS.lastIndex = 0;
+    for (const match of cleaned.matchAll(MEETING_KEYWORDS)) {
+        const keyword = match[1];
+        addMention({
+            entityType: 'meeting',
+            mentionForm: keyword,
+            normalizedName: keyword.toLowerCase().replace(/\s+/g, '-'),
+            confidence: 0.7,
+        });
+    }
+    return mentions;
+}
+//# sourceMappingURL=entity-extractor.js.map

package/dist/ingest/entity-extractor.js.map

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

package/dist/ingest/index-entry-hook.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Hook for generating semantic index entries during ingestion.
+ *
+ * Called after chunks are stored and embedded. Generates index entries
+ * (LLM or heuristic) and embeds the descriptions into the index vector store.
+ */
+import type { ChunkForIndexing } from '../index-entries/index-generator.js';
+/**
+ * Generate and store index entries for newly ingested chunks.
+ *
+ * This is called from processMainSession() after chunks are stored and embedded.
+ * It's a best-effort operation — failures are logged but don't block ingestion.
+ */
+export declare function generateIndexEntriesForChunks(chunks: ChunkForIndexing[], sessionSlug: string, _chunkEmbeddings: number[][], _chunkIds: string[], embeddingModel: string): Promise<void>;
+//# sourceMappingURL=index-entry-hook.d.ts.map

package/dist/ingest/index-entry-hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-entry-hook.d.ts","sourceRoot":"","sources":["../../src/ingest/index-entry-hook.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AAqB5E;;;;;GAKG;AACH,wBAAsB,6BAA6B,CACjD,MAAM,EAAE,gBAAgB,EAAE,EAC1B,WAAW,EAAE,MAAM,EACnB,gBAAgB,EAAE,MAAM,EAAE,EAAE,EAC5B,SAAS,EAAE,MAAM,EAAE,EACnB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,IAAI,CAAC,CAmDf"}