@pella-labs/pinakes 0.1.10 → 0.3.0

package/dist/mcp/tools/search.js

@@ -1,21 +1,23 @@
 import { z } from 'zod';
-import { hybridSearch } from '../../retrieval/hybrid.js';
+import { hybridSearch, rrfFuseMulti } from '../../retrieval/hybrid.js';
+import { dedupResults } from '../../retrieval/dedup.js';
+import { expandQuery } from '../../retrieval/expand.js';
 import { fitResults, countEnvelopeTokens } from '../../gate/budget.js';
 import { buildEnvelope, QueryTimer } from '../envelope.js';
 import { nextReader } from '../../db/client.js';
 /**
- * `kg_search` — fast-path hybrid search against the knowledge graph.
+ * `search` — fast-path hybrid search against the project knowledge base.
  *
  * Phase 5: supports all three scopes. For `scope='both'`, results from
- * both KGs are merged and tagged with `source_scope`.
+ * both knowledge bases are merged and tagged with `source_scope`.
  */
-export const kgSearchInputShape = {
+export const searchInputShape = {
     query: z
         .string()
         .min(1)
-        .describe('The search term. Hybrid FTS5 + vector search against every indexed ' +
-        'chunk of the wiki, ranked by Reciprocal Rank Fusion. ' +
-        'Examples: "hashPassword", "bcrypt", "auth flow".'),
+        .describe('Natural language or keyword query. Semantic search finds relevant ' +
+        'knowledge even with different wording. ' +
+        'Examples: "how does auth work", "database design decisions", "error handling conventions".'),
     max_tokens: z
         .number()
         .int()
@@ -29,34 +31,43 @@ export const kgSearchInputShape = {
     scope: z
         .enum(['project', 'personal', 'both'])
         .optional()
-        .describe('Which KG to query. "project" (default) searches the project wiki, ' +
-        '"personal" searches the personal wiki, "both" merges results from ' +
-        'both with `source_scope` tagging on each result.'),
+        .describe('Which knowledge base to query. "project" (default) = this project\'s knowledge, ' +
+        '"personal" = your cross-project notes, "both" = merged with source tagging.'),
+    expand: z
+        .boolean()
+        .optional()
+        .describe('Set to true to use an LLM for multi-query expansion. Generates 2 ' +
+        'alternative phrasings and merges results via RRF for better recall. ' +
+        'Requires an LLM provider (Ollama, API key, or Claude/Codex CLI). ' +
+        'Non-fatal: falls back to the original query if unavailable.'),
 };
-export const kgSearchToolConfig = {
-    title: 'Search the knowledge graph',
-    description: 'Hybrid FTS + vector search the curated project knowledge wiki (not source ' +
-        'code — use grep/read for that). Best for conceptual questions about ' +
-        'architecture, conventions, and decisions. Results are ranked by Reciprocal ' +
-        'Rank Fusion with `title` and `section_path` for quick triage. ' +
-        'Prefer this for short lookups; use `kg_execute` when you need to chain ' +
-        'filters, browse the wiki index, write new pages, or check knowledge gaps.',
-    inputSchema: kgSearchInputShape,
+export const searchToolConfig = {
+    title: 'Search project knowledge base',
+    description: 'START HERE when you need to understand the project — architecture, ' +
+        'conventions, decisions, requirements, data models, deployment, or how ' +
+        'subsystems relate. Returns distilled knowledge at a fraction of the tokens ' +
+        'vs. reading raw source files. Semantic hybrid search (FTS5 + vector) finds ' +
+        'relevant context even when you don\'t know exact terms. Results ranked by ' +
+        'relevance with `title` and `section_path` for quick triage. ' +
+        'Use `execute` for advanced queries: chaining filters, browsing the full ' +
+        'index, writing new knowledge, or checking knowledge gaps.',
+    inputSchema: searchInputShape,
 };
 /**
- * Build the `kg_search` handler. Supports project, personal, and both scopes.
+ * Build the `search` handler. Supports project, personal, and both scopes.
  */
-export function makeKgSearchHandler(deps) {
+export function makeSearchHandler(deps) {
     return async (args) => {
         const timer = new QueryTimer();
         const maxTokens = args.max_tokens ?? 5000;
         const scope = args.scope ?? 'project';
+        const shouldExpand = args.expand === true;
         // Check personal scope availability
         if ((scope === 'personal' || scope === 'both') && !deps.personalBundle) {
             const envelope = buildEnvelope({
                 result: {
-                    error: 'personal scope requested but no personal KG is configured — ' +
-                        'set KG_PROFILE_PATH or pass --profile-path',
+                    error: 'personal scope requested but no personal wiki is configured — ' +
+                        'create a personal wiki at ~/.pinakes/wiki/ or pass --profile-path',
                 },
                 tokensBudgeted: maxTokens,
                 tokensUsed: 0,
@@ -66,11 +77,22 @@ export function makeKgSearchHandler(deps) {
             });
             return wrapText(envelope);
         }
-        let allHits = [];
+        // Determine query variants: original + optional expansions
+        const queries = [args.query];
+        if (shouldExpand && deps.llmProvider) {
+            const expanded = await expandQuery(args.query, deps.llmProvider);
+            queries.push(...expanded.alternatives);
+        }
+        const allHits = [];
         if (scope === 'project' || scope === 'both') {
             const reader = nextReader(deps.bundle);
-            const hits = await hybridSearch(reader, 'project', args.query, deps.embedder);
-            const tagged = hits.map((h) => ({
+            // Run hybrid search for all query variants
+            const hitLists = await Promise.all(queries.map((q) => hybridSearch(reader, 'project', q, deps.embedder, { dedup: false })));
+            // If multiple queries, merge via multi-list RRF then dedup
+            const merged = hitLists.length > 1
+                ? dedupResults(rrfFuseMulti(hitLists, 60, 40)).slice(0, 20)
+                : hitLists[0];
+            const tagged = merged.map((h) => ({
                 id: h.id, text: h.text, source_uri: h.source_uri, score: h.score,
                 confidence: h.confidence, title: h.title, section_path: h.section_path,
                 ...(scope === 'both' ? { source_scope: 'project' } : {}),
@@ -79,8 +101,11 @@ export function makeKgSearchHandler(deps) {
         }
         if ((scope === 'personal' || scope === 'both') && deps.personalBundle) {
             const reader = nextReader(deps.personalBundle);
-            const hits = await hybridSearch(reader, 'personal', args.query, deps.embedder);
-            const tagged = hits.map((h) => ({
+            const hitLists = await Promise.all(queries.map((q) => hybridSearch(reader, 'personal', q, deps.embedder, { dedup: false })));
+            const merged = hitLists.length > 1
+                ? dedupResults(rrfFuseMulti(hitLists, 60, 40)).slice(0, 20)
+                : hitLists[0];
+            const tagged = merged.map((h) => ({
                 id: h.id, text: h.text, source_uri: h.source_uri, score: h.score,
                 confidence: h.confidence, title: h.title, section_path: h.section_path,
                 ...(scope === 'both' ? { source_scope: 'personal' } : {}),

package/dist/mcp/tools/search.js.map

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

package/dist/observability/audit.d.ts

@@ -3,8 +3,8 @@ import type { Database as BetterSqliteDatabase } from 'better-sqlite3';
  * Audit log writer with scope-split JSONL mirror.
  *
  * Per CLAUDE.md §Security #7:
- *   - scope='project' → kg_audit table in project .kg/kg.db + .kg/audit.jsonl
- *   - scope='personal' or 'both' → kg_audit table in ~/.kg/kg.db + ~/.kg/audit.jsonl
+ *   - scope='project' → pinakes_audit table in ~/.pinakes/projects/<mangled>/pinakes.db + audit.jsonl
+ *   - scope='personal' or 'both' → pinakes_audit table in ~/.pinakes/pinakes.db + ~/.pinakes/audit.jsonl
  *   - NEVER write personal query text to a path inside the project repo
  */
 export interface AuditEntry {

package/dist/observability/audit.js

@@ -10,15 +10,15 @@ import { logger } from './logger.js';
  */
 export function writeAuditRow(writer, jsonlPath, entry) {
     const ts = Date.now();
-    // Write to kg_audit table
+    // Write to pinakes_audit table
     try {
         writer
-            .prepare(`INSERT INTO kg_audit (ts, tool_name, scope_requested, caller_ctx, response_tokens, error)
+            .prepare(`INSERT INTO pinakes_audit (ts, tool_name, scope_requested, caller_ctx, response_tokens, error)
          VALUES (?, ?, ?, ?, ?, ?)`)
             .run(ts, entry.toolName, entry.scopeRequested, entry.callerCtx ?? null, entry.responseTokens ?? null, entry.error ?? null);
     }
     catch (err) {
-        logger.warn({ err, entry }, 'failed to write kg_audit row');
+        logger.warn({ err, entry }, 'failed to write pinakes_audit row');
     }
     // Mirror to JSONL
     if (jsonlPath) {

package/dist/observability/audit.js.map

@@ -1 +1 @@
-{"version":3,"file":"audit.js","sourceRoot":"","sources":["../../src/observability/audit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAChE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAmBrC;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAC3B,MAA4B,EAC5B,SAA6B,EAC7B,KAAiB;IAEjB,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAEtB,0BAA0B;IAC1B,IAAI,CAAC;QACH,MAAM;aACH,OAAO,CACN;mCAC2B,CAC5B;aACA,GAAG,CACF,EAAE,EACF,KAAK,CAAC,QAAQ,EACd,KAAK,CAAC,cAAc,EACpB,KAAK,CAAC,SAAS,IAAI,IAAI,EACvB,KAAK,CAAC,cAAc,IAAI,IAAI,EAC5B,KAAK,CAAC,KAAK,IAAI,IAAI,CACpB,CAAC;IACN,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,8BAA8B,CAAC,CAAC;IAC9D,CAAC;IAED,kBAAkB;IAClB,IAAI,SAAS,EAAE,CAAC;QACd,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;YAC/B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACrB,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACtC,CAAC;YACD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,GAAG,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;YACrD,cAAc,CAAC,SAAS,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QAC3C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE,8BAA8B,CAAC,CAAC;QAClE,CAAC;IACH,CAAC;AACH,CAAC"}
+{"version":3,"file":"audit.js","sourceRoot":"","sources":["../../src/observability/audit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAChE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAmBrC;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAC3B,MAA4B,EAC5B,SAA6B,EAC7B,KAAiB;IAEjB,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAEtB,+BAA+B;IAC/B,IAAI,CAAC;QACH,MAAM;aACH,OAAO,CACN;mCAC2B,CAC5B;aACA,GAAG,CACF,EAAE,EACF,KAAK,CAAC,QAAQ,EACd,KAAK,CAAC,cAAc,EACpB,KAAK,CAAC,SAAS,IAAI,IAAI,EACvB,KAAK,CAAC,cAAc,IAAI,IAAI,EAC5B,KAAK,CAAC,KAAK,IAAI,IAAI,CACpB,CAAC;IACN,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,mCAAmC,CAAC,CAAC;IACnE,CAAC;IAED,kBAAkB;IAClB,IAAI,SAAS,EAAE,CAAC;QACd,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;YAC/B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACrB,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACtC,CAAC;YACD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,GAAG,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;YACrD,cAAc,CAAC,SAAS,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QAC3C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE,8BAA8B,CAAC,CAAC;QAClE,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/observability/logger.js

@@ -1,6 +1,6 @@
 import { pino } from 'pino';
 /**
- * Pino logger for KG-MCP.
+ * Pino logger for Pinakes.
  *
  * CRITICAL: MCP stdio transport uses stdout for the JSON-RPC protocol. Every
  * log line must go to stderr — writing to stdout would corrupt the protocol
@@ -9,20 +9,20 @@ import { pino } from 'pino';
  * destination that would route to stdout.
  *
  * Pretty transport is only enabled when:
- *   1. `KG_LOG_LEVEL=debug` or `trace`, AND
+ *   1. `PINAKES_LOG_LEVEL=debug` or `trace`, AND
  *   2. stderr is a TTY (i.e. a developer is watching in a terminal)
  *
  * In production (Pharos-spawned stdio child, non-TTY), logs stay as newline-
  * delimited JSON for machine consumption.
  */
-const level = process.env.KG_LOG_LEVEL ?? 'info';
+const level = process.env.PINAKES_LOG_LEVEL ?? 'info';
 const isVerbose = level === 'debug' || level === 'trace';
 const isTty = process.stderr.isTTY ?? false;
 const usePretty = isVerbose && isTty;
 const baseOptions = {
     level,
     base: {
-        service: 'kg-mcp',
+        service: 'pinakes',
         pid: process.pid,
     },
     timestamp: pino.stdTimeFunctions.isoTime,

package/dist/observability/logger.js.map

@@ -1 +1 @@
-{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/observability/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAmC,MAAM,MAAM,CAAC;AAE7D;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,MAAM,CAAC;AACjD,MAAM,SAAS,GAAG,KAAK,KAAK,OAAO,IAAI,KAAK,KAAK,OAAO,CAAC;AACzD,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,IAAI,KAAK,CAAC;AAC5C,MAAM,SAAS,GAAG,SAAS,IAAI,KAAK,CAAC;AAErC,MAAM,WAAW,GAAkB;IACjC,KAAK;IACL,IAAI,EAAE;QACJ,OAAO,EAAE,QAAQ;QACjB,GAAG,EAAE,OAAO,CAAC,GAAG;KACjB;IACD,SAAS,EAAE,IAAI,CAAC,gBAAgB,CAAC,OAAO;CACzC,CAAC;AAEF,SAAS,YAAY;IACnB,IAAI,SAAS,EAAE,CAAC;QACd,2EAA2E;QAC3E,yCAAyC;QACzC,OAAO,IAAI,CAAC;YACV,GAAG,WAAW;YACd,SAAS,EAAE;gBACT,MAAM,EAAE,aAAa;gBACrB,OAAO,EAAE;oBACP,QAAQ,EAAE,IAAI;oBACd,WAAW,EAAE,CAAC,EAAE,SAAS;oBACzB,aAAa,EAAE,YAAY;oBAC3B,MAAM,EAAE,sBAAsB;iBAC/B;aACF;SACF,CAAC,CAAC;IACL,CAAC;IACD,0EAA0E;IAC1E,+DAA+D;IAC/D,8BAA8B;IAC9B,OAAO,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAW,YAAY,EAAE,CAAC;AAE7C,MAAM,UAAU,KAAK,CAAC,QAAiC;IACrD,OAAO,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;AAChC,CAAC"}
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/observability/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAmC,MAAM,MAAM,CAAC;AAE7D;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,MAAM,CAAC;AACtD,MAAM,SAAS,GAAG,KAAK,KAAK,OAAO,IAAI,KAAK,KAAK,OAAO,CAAC;AACzD,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,IAAI,KAAK,CAAC;AAC5C,MAAM,SAAS,GAAG,SAAS,IAAI,KAAK,CAAC;AAErC,MAAM,WAAW,GAAkB;IACjC,KAAK;IACL,IAAI,EAAE;QACJ,OAAO,EAAE,SAAS;QAClB,GAAG,EAAE,OAAO,CAAC,GAAG;KACjB;IACD,SAAS,EAAE,IAAI,CAAC,gBAAgB,CAAC,OAAO;CACzC,CAAC;AAEF,SAAS,YAAY;IACnB,IAAI,SAAS,EAAE,CAAC;QACd,2EAA2E;QAC3E,yCAAyC;QACzC,OAAO,IAAI,CAAC;YACV,GAAG,WAAW;YACd,SAAS,EAAE;gBACT,MAAM,EAAE,aAAa;gBACrB,OAAO,EAAE;oBACP,QAAQ,EAAE,IAAI;oBACd,WAAW,EAAE,CAAC,EAAE,SAAS;oBACzB,aAAa,EAAE,YAAY;oBAC3B,MAAM,EAAE,sBAAsB;iBAC/B;aACF;SACF,CAAC,CAAC;IACL,CAAC;IACD,0EAA0E;IAC1E,+DAA+D;IAC/D,8BAA8B;IAC9B,OAAO,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAW,YAAY,EAAE,CAAC;AAE7C,MAAM,UAAU,KAAK,CAAC,QAAiC;IACrD,OAAO,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;AAChC,CAAC"}

package/dist/observability/metrics.js

@@ -57,7 +57,7 @@ export function installSighupHandler() {
     process.on('SIGHUP', () => {
         const snap = metrics.snapshot();
         // Write directly to stderr to avoid pino's async buffering.
-        process.stderr.write(JSON.stringify({ kg_mcp_metrics: snap }) + '\n');
+        process.stderr.write(JSON.stringify({ pinakes_metrics: snap }) + '\n');
         logger.info('SIGHUP: metrics dumped to stderr');
     });
 }

package/dist/observability/metrics.js.map

@@ -1 +1 @@
-{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../../src/observability/metrics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAiBrC,MAAM,OAAO;IACH,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;IACtC,UAAU,GAAG,IAAI,GAAG,EAAkB,CAAC;IACvC,WAAW,GAAG,IAAI,GAAG,EAAyB,CAAC;IAC/C,WAAW,GAAG,CAAC,CAAC;IAChB,YAAY,GAAG,CAAC,CAAC;IACR,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAExC,cAAc,CAAC,IAAY,EAAE,SAAiB,EAAE,KAAe;QAC7D,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAC9D,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAClE,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;QACvE,GAAG,CAAC,KAAK,EAAE,CAAC;QACZ,GAAG,CAAC,GAAG,IAAI,SAAS,CAAC;QACrB,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QACvC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAClC,CAAC;IAED,YAAY,CAAC,KAAe;QAC1B,IAAI,KAAK;YAAE,IAAI,CAAC,YAAY,EAAE,CAAC;;YAC1B,IAAI,CAAC,WAAW,EAAE,CAAC;IAC1B,CAAC;IAED,QAAQ;QACN,OAAO;YACL,UAAU,EAAE,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC;YAC9C,WAAW,EAAE,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC;YAChD,eAAe,EAAE,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC;YACrD,YAAY,EAAE,IAAI,CAAC,WAAW;YAC9B,aAAa,EAAE,IAAI,CAAC,YAAY;YAChC,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC;SAC3D,CAAC;IACJ,CAAC;CACF;AAED,MAAM,CAAC,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAErC;;;GAGG;AACH,IAAI,eAAe,GAAG,KAAK,CAAC;AAC5B,MAAM,UAAU,oBAAoB;IAClC,IAAI,eAAe;QAAE,OAAO;IAC5B,eAAe,GAAG,IAAI,CAAC;IACvB,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;QACxB,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;QAChC,4DAA4D;QAC5D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;QACtE,MAAM,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../../src/observability/metrics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAiBrC,MAAM,OAAO;IACH,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;IACtC,UAAU,GAAG,IAAI,GAAG,EAAkB,CAAC;IACvC,WAAW,GAAG,IAAI,GAAG,EAAyB,CAAC;IAC/C,WAAW,GAAG,CAAC,CAAC;IAChB,YAAY,GAAG,CAAC,CAAC;IACR,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAExC,cAAc,CAAC,IAAY,EAAE,SAAiB,EAAE,KAAe;QAC7D,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAC9D,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAClE,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;QACvE,GAAG,CAAC,KAAK,EAAE,CAAC;QACZ,GAAG,CAAC,GAAG,IAAI,SAAS,CAAC;QACrB,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QACvC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAClC,CAAC;IAED,YAAY,CAAC,KAAe;QAC1B,IAAI,KAAK;YAAE,IAAI,CAAC,YAAY,EAAE,CAAC;;YAC1B,IAAI,CAAC,WAAW,EAAE,CAAC;IAC1B,CAAC;IAED,QAAQ;QACN,OAAO;YACL,UAAU,EAAE,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC;YAC9C,WAAW,EAAE,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC;YAChD,eAAe,EAAE,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC;YACrD,YAAY,EAAE,IAAI,CAAC,WAAW;YAC9B,aAAa,EAAE,IAAI,CAAC,YAAY;YAChC,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC;SAC3D,CAAC;IACJ,CAAC;CACF;AAED,MAAM,CAAC,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAErC;;;GAGG;AACH,IAAI,eAAe,GAAG,KAAK,CAAC;AAC5B,MAAM,UAAU,oBAAoB;IAClC,IAAI,eAAe;QAAE,OAAO;IAC5B,eAAe,GAAG,IAAI,CAAC;IACvB,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;QACxB,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;QAChC,4DAA4D;QAC5D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;QACvE,MAAM,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/paths.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Centralized path resolution for Pinakes.
+ *
+ * All Pinakes data lives under a single root directory (~/.pinakes by default).
+ * Project data is stored in mirrored paths under ~/.pinakes/projects/, using
+ * the Claude Code convention of replacing '/' with '-' in the absolute project
+ * path. Personal data lives directly under the root.
+ *
+ * Layout:
+ *   ~/.pinakes/
+ *     wiki/                                       # personal wiki
+ *     pinakes.db                                  # personal DB
+ *     audit.jsonl                                 # personal audit
+ *     manifest.json                               # personal manifest
+ *     projects/
+ *       -Users-sebastian-dev-myproject/            # mangled project root
+ *         wiki/                                   # project wiki
+ *         pinakes.db                              # project DB
+ *         audit.jsonl                             # project audit
+ *         manifest.json                           # project manifest
+ */
+/** Resolve a path to absolute, using cwd if relative. */
+export declare function resolveAbs(p: string): string;
+/**
+ * Mangle an absolute path into a directory-safe name.
+ * Uses Claude Code's convention: replace '/' with '-'.
+ *
+ * `/Users/sebastian/dev/myproject` → `-Users-sebastian-dev-myproject`
+ */
+export declare function mangleProjectPath(absolutePath: string): string;
+/**
+ * Pinakes root directory. All data lives here.
+ * Default: `~/.pinakes`
+ * Override: `PINAKES_ROOT` env var
+ */
+export declare function pinakesRoot(): string;
+/**
+ * The mirrored data directory for a project.
+ * e.g. `/Users/me/dev/proj` → `~/.pinakes/projects/-Users-me-dev-proj`
+ */
+export declare function projectDataDir(projectRoot: string): string;
+export declare function projectWikiPath(projectRoot: string): string;
+export declare function projectDbPath(projectRoot: string): string;
+export declare function projectAuditJsonlPath(projectRoot: string): string;
+export declare function projectManifestPath(projectRoot: string): string;
+export declare function personalWikiPath(): string;
+export declare function personalDbPath(): string;
+export declare function personalAuditJsonlPath(): string;
+export declare function personalManifestPath(): string;
+export interface CliPathOverrides {
+    projectRoot?: string;
+    dbPath?: string;
+    wikiPath?: string;
+    profileDbPath?: string;
+}
+/**
+ * Resolve the DB path for a given scope, honoring CLI overrides.
+ * Shared by all CLI subcommands (status, audit, export, import, purge, etc.)
+ */
+export declare function resolveCliDbPath(options: CliPathOverrides, scope: 'project' | 'personal'): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AASH,yDAAyD;AACzD,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAE9D;AAMD;;;;GAIG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAIpC;AAMD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAG1D;AAED,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEjE;AAED,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE/D;AAMD,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,wBAAgB,sBAAsB,IAAI,MAAM,CAE/C;AAED,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAMD,MAAM,WAAW,gBAAgB;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,gBAAgB,EACzB,KAAK,EAAE,SAAS,GAAG,UAAU,GAC5B,MAAM,CAOR"}

package/dist/paths.js

@@ -0,0 +1,106 @@
+/**
+ * Centralized path resolution for Pinakes.
+ *
+ * All Pinakes data lives under a single root directory (~/.pinakes by default).
+ * Project data is stored in mirrored paths under ~/.pinakes/projects/, using
+ * the Claude Code convention of replacing '/' with '-' in the absolute project
+ * path. Personal data lives directly under the root.
+ *
+ * Layout:
+ *   ~/.pinakes/
+ *     wiki/                                       # personal wiki
+ *     pinakes.db                                  # personal DB
+ *     audit.jsonl                                 # personal audit
+ *     manifest.json                               # personal manifest
+ *     projects/
+ *       -Users-sebastian-dev-myproject/            # mangled project root
+ *         wiki/                                   # project wiki
+ *         pinakes.db                              # project DB
+ *         audit.jsonl                             # project audit
+ *         manifest.json                           # project manifest
+ */
+import { homedir } from 'node:os';
+import { isAbsolute, resolve } from 'node:path';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/** Resolve a path to absolute, using cwd if relative. */
+export function resolveAbs(p) {
+    return isAbsolute(p) ? p : resolve(process.cwd(), p);
+}
+/**
+ * Mangle an absolute path into a directory-safe name.
+ * Uses Claude Code's convention: replace '/' with '-'.
+ *
+ * `/Users/sebastian/dev/myproject` → `-Users-sebastian-dev-myproject`
+ */
+export function mangleProjectPath(absolutePath) {
+    return absolutePath.replace(/\//g, '-');
+}
+// ---------------------------------------------------------------------------
+// Root
+// ---------------------------------------------------------------------------
+/**
+ * Pinakes root directory. All data lives here.
+ * Default: `~/.pinakes`
+ * Override: `PINAKES_ROOT` env var
+ */
+export function pinakesRoot() {
+    const env = process.env.PINAKES_ROOT;
+    if (env)
+        return resolveAbs(env);
+    return resolve(homedir(), '.pinakes');
+}
+// ---------------------------------------------------------------------------
+// Project paths (derived from project root directory)
+// ---------------------------------------------------------------------------
+/**
+ * The mirrored data directory for a project.
+ * e.g. `/Users/me/dev/proj` → `~/.pinakes/projects/-Users-me-dev-proj`
+ */
+export function projectDataDir(projectRoot) {
+    const abs = resolveAbs(projectRoot);
+    return resolve(pinakesRoot(), 'projects', mangleProjectPath(abs));
+}
+export function projectWikiPath(projectRoot) {
+    return resolve(projectDataDir(projectRoot), 'wiki');
+}
+export function projectDbPath(projectRoot) {
+    return resolve(projectDataDir(projectRoot), 'pinakes.db');
+}
+export function projectAuditJsonlPath(projectRoot) {
+    return resolve(projectDataDir(projectRoot), 'audit.jsonl');
+}
+export function projectManifestPath(projectRoot) {
+    return resolve(projectDataDir(projectRoot), 'manifest.json');
+}
+// ---------------------------------------------------------------------------
+// Personal paths (directly under pinakes root)
+// ---------------------------------------------------------------------------
+export function personalWikiPath() {
+    return resolve(pinakesRoot(), 'wiki');
+}
+export function personalDbPath() {
+    return resolve(pinakesRoot(), 'pinakes.db');
+}
+export function personalAuditJsonlPath() {
+    return resolve(pinakesRoot(), 'audit.jsonl');
+}
+export function personalManifestPath() {
+    return resolve(pinakesRoot(), 'manifest.json');
+}
+/**
+ * Resolve the DB path for a given scope, honoring CLI overrides.
+ * Shared by all CLI subcommands (status, audit, export, import, purge, etc.)
+ */
+export function resolveCliDbPath(options, scope) {
+    if (scope === 'personal') {
+        if (options.profileDbPath)
+            return resolveAbs(options.profileDbPath);
+        return personalDbPath();
+    }
+    if (options.dbPath)
+        return resolveAbs(options.dbPath);
+    return projectDbPath(options.projectRoot ?? process.cwd());
+}
+//# sourceMappingURL=paths.js.map

package/dist/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEhD,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,yDAAyD;AACzD,MAAM,UAAU,UAAU,CAAC,CAAS;IAClC,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC;AACvD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,YAAoB;IACpD,OAAO,YAAY,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AAC1C,CAAC;AAED,8EAA8E;AAC9E,OAAO;AACP,8EAA8E;AAE9E;;;;GAIG;AACH,MAAM,UAAU,WAAW;IACzB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;IACrC,IAAI,GAAG;QAAE,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC;IAChC,OAAO,OAAO,CAAC,OAAO,EAAE,EAAE,UAAU,CAAC,CAAC;AACxC,CAAC;AAED,8EAA8E;AAC9E,sDAAsD;AACtD,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,WAAmB;IAChD,MAAM,GAAG,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;IACpC,OAAO,OAAO,CAAC,WAAW,EAAE,EAAE,UAAU,EAAE,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC;AACpE,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,WAAmB;IACjD,OAAO,OAAO,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,WAAmB;IAC/C,OAAO,OAAO,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE,YAAY,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,WAAmB;IACvD,OAAO,OAAO,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE,aAAa,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,WAAmB;IACrD,OAAO,OAAO,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE,eAAe,CAAC,CAAC;AAC/D,CAAC;AAED,8EAA8E;AAC9E,+CAA+C;AAC/C,8EAA8E;AAE9E,MAAM,UAAU,gBAAgB;IAC9B,OAAO,OAAO,CAAC,WAAW,EAAE,EAAE,MAAM,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,OAAO,OAAO,CAAC,WAAW,EAAE,EAAE,YAAY,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,sBAAsB;IACpC,OAAO,OAAO,CAAC,WAAW,EAAE,EAAE,aAAa,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,oBAAoB;IAClC,OAAO,OAAO,CAAC,WAAW,EAAE,EAAE,eAAe,CAAC,CAAC;AACjD,CAAC;AAaD;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAAyB,EACzB,KAA6B;IAE7B,IAAI,KAAK,KAAK,UAAU,EAAE,CAAC;QACzB,IAAI,OAAO,CAAC,aAAa;YAAE,OAAO,UAAU,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;QACpE,OAAO,cAAc,EAAE,CAAC;IAC1B,CAAC;IACD,IAAI,OAAO,CAAC,MAAM;QAAE,OAAO,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACtD,OAAO,aAAa,CAAC,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;AAC7D,CAAC"}

package/dist/retrieval/dedup.d.ts

@@ -0,0 +1,25 @@
+import type { HybridResult } from './hybrid.js';
+/**
+ * Post-RRF dedup pipeline (D37, GBrain-inspired).
+ *
+ * Three layers, applied in order after RRF fusion:
+ *
+ * 1. **Source-URI cap (max 3)**: no single wiki page dominates results.
+ * 2. **Jaccard bigram similarity (>0.85)**: drop near-duplicate text
+ *    regardless of which file it came from.
+ * 3. **Final source-URI cap (max 2)**: tighter diversity after dedup.
+ *
+ * The input must already be sorted by descending RRF score (which
+ * `rrfFuse` guarantees). The output preserves that ordering.
+ */
+/**
+ * Deduplicate hybrid search results. Input MUST be sorted by descending
+ * RRF score. Returns a new array (does not mutate the input).
+ */
+export declare function dedupResults(results: HybridResult[]): HybridResult[];
+/** Split text into a set of whitespace-separated bigrams. */
+declare function toBigrams(text: string): Set<string>;
+/** |A ∩ B| / |A ∪ B| — classic Jaccard index. */
+declare function jaccardSimilarity(a: Set<string>, b: Set<string>): number;
+export { toBigrams as _toBigrams, jaccardSimilarity as _jaccardSimilarity };
+//# sourceMappingURL=dedup.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dedup.d.ts","sourceRoot":"","sources":["../../src/retrieval/dedup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD;;;;;;;;;;;;GAYG;AAEH;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,YAAY,EAAE,CAWpE;AAoDD,6DAA6D;AAC7D,iBAAS,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAW5C;AAED,iDAAiD;AACjD,iBAAS,iBAAiB,CAAC,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM,CAUjE;AAGD,OAAO,EAAE,SAAS,IAAI,UAAU,EAAE,iBAAiB,IAAI,kBAAkB,EAAE,CAAC"}

package/dist/retrieval/dedup.js

@@ -0,0 +1,97 @@
+/**
+ * Post-RRF dedup pipeline (D37, GBrain-inspired).
+ *
+ * Three layers, applied in order after RRF fusion:
+ *
+ * 1. **Source-URI cap (max 3)**: no single wiki page dominates results.
+ * 2. **Jaccard bigram similarity (>0.85)**: drop near-duplicate text
+ *    regardless of which file it came from.
+ * 3. **Final source-URI cap (max 2)**: tighter diversity after dedup.
+ *
+ * The input must already be sorted by descending RRF score (which
+ * `rrfFuse` guarantees). The output preserves that ordering.
+ */
+/**
+ * Deduplicate hybrid search results. Input MUST be sorted by descending
+ * RRF score. Returns a new array (does not mutate the input).
+ */
+export function dedupResults(results) {
+    // Layer 1: max 3 chunks per source_uri
+    let kept = capPerSourceUri(results, 3);
+    // Layer 2: Jaccard bigram similarity > 0.85 against already-kept
+    kept = jaccardDedup(kept, 0.85);
+    // Layer 3: final cap at 2 per source_uri
+    kept = capPerSourceUri(kept, 2);
+    return kept;
+}
+// ---------------------------------------------------------------------------
+// Layer 1 & 3: cap per source_uri
+// ---------------------------------------------------------------------------
+function capPerSourceUri(results, maxPerUri) {
+    const counts = new Map();
+    const out = [];
+    for (const r of results) {
+        const count = counts.get(r.source_uri) ?? 0;
+        if (count >= maxPerUri)
+            continue;
+        counts.set(r.source_uri, count + 1);
+        out.push(r);
+    }
+    return out;
+}
+// ---------------------------------------------------------------------------
+// Layer 2: Jaccard bigram similarity
+// ---------------------------------------------------------------------------
+/**
+ * Remove results whose text is too similar (Jaccard > threshold) to a
+ * higher-ranked result already in the kept set. Preserves rank order.
+ */
+function jaccardDedup(results, threshold) {
+    const kept = [];
+    const keptBigrams = [];
+    for (const r of results) {
+        const bigrams = toBigrams(r.text);
+        let duplicate = false;
+        for (const existingBigrams of keptBigrams) {
+            if (jaccardSimilarity(bigrams, existingBigrams) > threshold) {
+                duplicate = true;
+                break;
+            }
+        }
+        if (!duplicate) {
+            kept.push(r);
+            keptBigrams.push(bigrams);
+        }
+    }
+    return kept;
+}
+/** Split text into a set of whitespace-separated bigrams. */
+function toBigrams(text) {
+    const words = text.toLowerCase().split(/\s+/).filter(Boolean);
+    const bigrams = new Set();
+    for (let i = 0; i < words.length - 1; i++) {
+        bigrams.add(`${words[i]} ${words[i + 1]}`);
+    }
+    // Single-word texts: use the word itself as the "bigram"
+    if (bigrams.size === 0 && words.length > 0) {
+        bigrams.add(words[0]);
+    }
+    return bigrams;
+}
+/** |A ∩ B| / |A ∪ B| — classic Jaccard index. */
+function jaccardSimilarity(a, b) {
+    if (a.size === 0 && b.size === 0)
+        return 1;
+    let intersection = 0;
+    const smaller = a.size <= b.size ? a : b;
+    const larger = a.size <= b.size ? b : a;
+    for (const item of smaller) {
+        if (larger.has(item))
+            intersection++;
+    }
+    const union = a.size + b.size - intersection;
+    return union === 0 ? 1 : intersection / union;
+}
+// Re-export for testing
+export { toBigrams as _toBigrams, jaccardSimilarity as _jaccardSimilarity };
+//# sourceMappingURL=dedup.js.map

package/dist/retrieval/dedup.js.map

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

package/dist/retrieval/embedder.d.ts

@@ -5,15 +5,15 @@
  * between the ingest path (computing chunk embeddings on insert) and the
  * future query path in Phase 4 (computing query embeddings for vector
  * search). Putting it under `retrieval/` keeps the code-mode bindings'
- * mental model consistent — `kg.vec()` and ingest both call into the same
+ * mental model consistent — `pinakes.vec()` and ingest both call into the same
  * factory.
  *
  * **Provider strategy** (CLAUDE.md §AI Rules #3): Phase 2 ships only the
  * bundled MiniLM provider. Phase 4 adds the env-driven factory:
- *   - `KG_EMBED_PROVIDER=transformers` (default, this file)
- *   - `KG_EMBED_PROVIDER=ollama` (HTTP, user-controlled)
- *   - `KG_EMBED_PROVIDER=voyage` (HTTPS, paid)
- *   - `KG_EMBED_PROVIDER=openai` (HTTPS, paid)
+ *   - `PINAKES_EMBED_PROVIDER=transformers` (default, this file)
+ *   - `PINAKES_EMBED_PROVIDER=ollama` (HTTP, user-controlled)
+ *   - `PINAKES_EMBED_PROVIDER=voyage` (HTTPS, paid)
+ *   - `PINAKES_EMBED_PROVIDER=openai` (HTTPS, paid)
  *
  * **Failure mode** (CLAUDE.md §AI Rules #4): if the embedder fails during
  * ingest, the ingester logs a warning and inserts the node + chunks WITHOUT
@@ -32,7 +32,7 @@ export declare const EMBEDDING_DIM = 384;
  * `VoyageEmbedder` / `OpenAIEmbedder`.
  */
 export interface Embedder {
-    /** Output dimension — load-bearing for the `kg_chunks_vec` schema */
+    /** Output dimension — load-bearing for the `pinakes_chunks_vec` schema */
     readonly dim: number;
     /** Eagerly load the underlying model. Optional — embed() will lazy-load on first call. */
     warmup(): Promise<void>;
@@ -80,7 +80,7 @@ export declare class CountingEmbedder implements Embedder {
 }
 /**
  * Ollama embedder via HTTP POST to `/api/embeddings`.
- * Requires `KG_OLLAMA_URL` and `KG_OLLAMA_MODEL` env vars.
+ * Requires `PINAKES_OLLAMA_URL` and `PINAKES_OLLAMA_MODEL` env vars.
  */
 export declare class OllamaEmbedder implements Embedder {
     private readonly baseUrl;
@@ -92,7 +92,7 @@ export declare class OllamaEmbedder implements Embedder {
 }
 /**
  * Voyage AI embedder via HTTPS POST to `https://api.voyageai.com/v1/embeddings`.
- * Requires `KG_VOYAGE_API_KEY` env var.
+ * Requires `PINAKES_VOYAGE_API_KEY` env var.
  */
 export declare class VoyageEmbedder implements Embedder {
     private readonly apiKey;
@@ -104,7 +104,7 @@ export declare class VoyageEmbedder implements Embedder {
 }
 /**
  * OpenAI embedder via HTTPS POST to `https://api.openai.com/v1/embeddings`.
- * Requires `KG_OPENAI_API_KEY` env var.
+ * Requires `PINAKES_OPENAI_API_KEY` env var.
  */
 export declare class OpenAIEmbedder implements Embedder {
     private readonly apiKey;