@tekmidian/pai 0.4.0 → 0.5.1

package/ARCHITECTURE.md

@@ -1,12 +1,8 @@
----
-links: "[[Ideaverse/AI/PAI/PAI|PAI]]"
----
-
 # PAI Knowledge OS — Architecture
 
 Technical reference for PAI's architecture, database schema, CLI commands, and development setup.
 
-For user-facing documentation, see [README.md](Ideaverse/AI/PAI/README.md) and [MANUAL.md](MANUAL.md).
+For user-facing documentation, see [README.md](README.md) and [MANUAL.md](MANUAL.md).
 
 ---
 
@@ -174,7 +170,7 @@ Claude Code (stdio)
 
 ### Tool Reference
 
-**`memory_search(query, mode?, project?, limit?)`** — Search the indexed knowledge base. Returns ranked chunks with file paths and line numbers. `mode`: `keyword` (default), `semantic`, or `hybrid`.
+**`memory_search(query, mode?, project?, limit?, rerank?)`** — Search the indexed knowledge base. Returns ranked chunks with file paths and line numbers. `mode`: `keyword` (default), `semantic`, or `hybrid`. Cross-encoder reranking is on by default; set `rerank: false` to skip it.
 
 **`memory_get(project, path)`** — Retrieve the complete contents of a specific file from a project's memory index.
 
@@ -243,6 +239,17 @@ Runs both keyword and semantic pipelines, normalizes each result set to a 0–1
 pai memory search --mode hybrid "rate limiting patterns"
 ```
 
+### Cross-Encoder Reranking (on by default)
+
+All search results are automatically re-scored using a cross-encoder model (`Xenova/ms-marco-MiniLM-L-6-v2`, 23 MB quantized). Cross-encoders process (query, document) pairs jointly — more accurate than BM25 or bi-encoder cosine but slower since each pair is scored independently. Use `--no-rerank` to skip this step.
+
+```bash
+pai memory search "PAI memory search implementation" --mode hybrid
+pai memory search "PAI memory search implementation" --mode hybrid --no-rerank
+```
+
+The reranker loads lazily on first use (downloads the model once, ~23 MB). Subsequent calls reuse the cached model. The MCP tool defaults to `rerank: true`; pass `rerank: false` to skip.
+
 ### Mode Comparison
 
 | Mode | Speed | Requires Embeddings | Best For |
@@ -250,6 +257,7 @@ pai memory search --mode hybrid "rate limiting patterns"
 | keyword | Fast | No | Exact terms, IDs, session numbers |
 | semantic | Medium | Yes | Concepts, paraphrases, cross-language |
 | hybrid | Medium | Yes | General-purpose, best quality |
+| any (rerank default) | Slower | Model auto-downloads | All modes — best relevance ordering |
 
 ---
 
@@ -675,7 +683,8 @@ src/
 ├── federation/      # Federation schema definitions
 ├── hooks/           # Lifecycle hooks (pre-compact, session-stop)
 ├── mcp/             # Direct MCP server (legacy)
-├── memory/          # Indexer, chunker, embeddings, search
+├── memory/          # Indexer, chunker, embeddings, search, reranker
+│   ├── reranker.ts  # Cross-encoder reranking (Xenova/ms-marco-MiniLM-L-6-v2)
 │   └── vault-indexer.ts  # Obsidian vault indexing into v3 vault tables
 ├── obsidian/        # Obsidian vault bridge
 │   └── vault-fixer.ts    # Repairs broken wikilinks and orphaned entries
@@ -704,6 +713,3 @@ src/
 ## License
 
 MIT
-
----
-*Links:* [[Ideaverse/AI/PAI/PAI|PAI]]

package/README.md

@@ -1,7 +1,3 @@
----
-links: "[[Ideaverse/AI/PAI/PAI|PAI]]"
----
-
 # PAI Knowledge OS
 
 Claude Code has a memory problem. Every new session starts cold — no idea what you built yesterday, what decisions you made, or where you left off. You re-explain everything, every time. PAI fixes this.
@@ -127,6 +123,80 @@ For the technical deep-dive — architecture, database schema, CLI reference, an
 
 ---
 
+## Search Intelligence
+
+PAI doesn't just store your notes — it understands them. Three search modes work together, with reranking and recency boost on by default. All search settings are configurable.
+
+### Search Modes
+
+| Mode | How it works | Best for |
+|------|-------------|----------|
+| **Keyword** | Full-text search (BM25 via SQLite FTS5) | Exact terms, function names, error messages |
+| **Semantic** | Vector similarity (Snowflake Arctic embeddings) | Finding things by meaning, even with different words |
+| **Hybrid** | Keyword + semantic combined, scores normalized and blended | General use — the default |
+
+### Cross-Encoder Reranking
+
+Every search automatically runs a second pass: a cross-encoder model reads each (query, result) pair together and re-scores them for relevance. This catches results that keyword or vector search ranked too low.
+
+```bash
+# Search with reranking (default)
+pai memory search "how does session routing work"
+
+# Skip reranking for faster results
+pai memory search "how does session routing work" --no-rerank
+```
+
+The reranker uses a small local model (~23 MB) that runs entirely on your machine. First use downloads it automatically. No API keys, no cloud calls.
+
+### Recency Boost
+
+Recent content scores higher than older content — on by default with a 90-day half-life. A 3-month-old result retains 50% of its score, a 6-month-old retains 25%, and a year-old retains ~6%.
+
+```bash
+# Search uses recency boost automatically (90-day half-life from config)
+pai memory search "notification system"
+
+# Override the half-life for this search
+pai memory search "notification system" --recency 30
+
+# Disable recency boost for this search
+pai memory search "notification system" --recency 0
+```
+
+Via MCP, pass `recency_boost: 90` to the `memory_search` tool, or `recency_boost: 0` to disable.
+
+Recency boost is applied after cross-encoder reranking, so relevance is scored first, then time-weighted. Scores are normalized before decay so the math works correctly regardless of the underlying score scale.
+
+### Search Settings
+
+All search defaults are configurable via `~/.config/pai/config.json` and can be viewed or changed from the command line.
+
+```bash
+# View all search settings
+pai memory settings
+
+# View a single setting
+pai memory settings recencyBoostDays
+
+# Change a setting
+pai memory settings recencyBoostDays 60
+pai memory settings mode hybrid
+pai memory settings rerank false
+```
+
+| Setting | Default | Description |
+|---------|---------|-------------|
+| `mode` | `keyword` | Default search mode: `keyword`, `semantic`, or `hybrid` |
+| `rerank` | `true` | Cross-encoder reranking on by default |
+| `recencyBoostDays` | `90` | Recency half-life in days. `0` = off |
+| `defaultLimit` | `10` | Default number of results |
+| `snippetLength` | `200` | Max characters per snippet in MCP results |
+
+Settings live in the `search` section of `~/.config/pai/config.json`. Per-call parameters (CLI flags or MCP tool arguments) always override config defaults.
+
+---
+
 ## Zettelkasten Intelligence
 
 PAI implements Niklas Luhmann's Zettelkasten principles as six computational operations on your Obsidian vault.
@@ -176,5 +246,3 @@ PAI Knowledge OS is inspired by [Daniel Miessler](https://github.com/danielmiess
 
 MIT
 
----
-*Links:* [[Ideaverse/AI/PAI/PAI|PAI]]

package/dist/{auto-route-JjW3f7pV.mjs → auto-route-BG6I_4B1.mjs}

@@ -1,5 +1,5 @@
 import { r as readPaiMarker } from "./pai-marker-CXQPX2P6.mjs";
-import { t as detectProject } from "./detect-D7gPV3fQ.mjs";
+import { t as detectProject } from "./detect-BU3Nx_2L.mjs";
 import { existsSync } from "node:fs";
 import { dirname, resolve } from "node:path";
 
@@ -26,7 +26,7 @@ async function autoRoute(registryDb, federation, cwd, context) {
 	const markerResult = findMarkerUpward(registryDb, target);
 	if (markerResult) return markerResult;
 	if (context && context.trim().length > 0) {
-		const { detectTopicShift } = await import("./detector-cYYhK2Mi.mjs").then((n) => n.n);
+		const { detectTopicShift } = await import("./detector-Bp-2SM3x.mjs").then((n) => n.n);
 		const topicResult = await detectTopicShift(registryDb, federation, {
 			context,
 			threshold: .5
@@ -83,4 +83,4 @@ function formatAutoRouteJson(result) {
 
 //#endregion
 export { autoRoute, formatAutoRouteJson };
-//# sourceMappingURL=auto-route-JjW3f7pV.mjs.map
+//# sourceMappingURL=auto-route-BG6I_4B1.mjs.map

package/dist/{auto-route-JjW3f7pV.mjs.map → auto-route-BG6I_4B1.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"auto-route-JjW3f7pV.mjs","names":[],"sources":["../src/session/auto-route.ts"],"sourcesContent":["/**\n * Auto-route: automatic project routing suggestion on session start.\n *\n * Given a working directory (and optional conversation context), determine\n * which registered project the session belongs to.\n *\n * Strategy (in priority order):\n *   1. Path match   — exact or parent-directory match in the project registry\n *   2. Marker walk  — walk up from cwd looking for Notes/PAI.md, resolve slug\n *   3. Topic match  — BM25 keyword search against memory (requires context text)\n *\n * The function is stateless and works with direct DB access (no daemon\n * required), making it fast and safe to call during session startup.\n */\n\nimport type { Database } from \"better-sqlite3\";\nimport type { StorageBackend } from \"../storage/interface.js\";\nimport { resolve, dirname } from \"node:path\";\nimport { existsSync } from \"node:fs\";\nimport { readPaiMarker } from \"../registry/pai-marker.js\";\nimport { detectProject } from \"../cli/commands/detect.js\";\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\nexport type AutoRouteMethod = \"path\" | \"marker\" | \"topic\";\n\nexport interface AutoRouteResult {\n  /** Project slug */\n  slug: string;\n  /** Human-readable project name */\n  display_name: string;\n  /** Absolute path to the project root */\n  root_path: string;\n  /** How the project was detected */\n  method: AutoRouteMethod;\n  /** Confidence [0,1]: 1.0 for path/marker matches, BM25 fraction for topic */\n  confidence: number;\n}\n\n// ---------------------------------------------------------------------------\n// Core function\n// ---------------------------------------------------------------------------\n\n/**\n * Determine which project a session should be routed to.\n *\n * @param registryDb  Open PAI registry database\n * @param federation  Memory storage backend (needed only for topic fallback)\n * @param cwd         Working directory to detect from (defaults to process.cwd())\n * @param context     Optional conversation text for topic-based fallback\n * @returns           Best project match, or null if nothing matched\n */\nexport async function autoRoute(\n  registryDb: Database,\n  federation: Database | StorageBackend,\n  cwd?: string,\n  context?: string\n): Promise<AutoRouteResult | null> {\n  const target = resolve(cwd ?? process.cwd());\n\n  // -------------------------------------------------------------------------\n  // Strategy 1: Path match via registry\n  // -------------------------------------------------------------------------\n\n  const pathMatch = detectProject(registryDb, target);\n\n  if (pathMatch) {\n    return {\n      slug: pathMatch.slug,\n      display_name: pathMatch.display_name,\n      root_path: pathMatch.root_path,\n      method: \"path\",\n      confidence: 1.0,\n    };\n  }\n\n  // -------------------------------------------------------------------------\n  // Strategy 2: PAI.md marker file walk\n  //\n  // Walk up from cwd, checking <dir>/Notes/PAI.md at each level.\n  // Once found, resolve the slug against the registry to get full project info.\n  // -------------------------------------------------------------------------\n\n  const markerResult = findMarkerUpward(registryDb, target);\n  if (markerResult) {\n    return markerResult;\n  }\n\n  // -------------------------------------------------------------------------\n  // Strategy 3: Topic detection (requires context text)\n  // -------------------------------------------------------------------------\n\n  if (context && context.trim().length > 0) {\n    // Lazy import to avoid bundler pulling in daemon/index.mjs at module load time\n    const { detectTopicShift } = await import(\"../topics/detector.js\");\n    const topicResult = await detectTopicShift(registryDb, federation, {\n      context,\n      threshold: 0.5, // Lower threshold for initial routing (vs shift detection)\n    });\n\n    if (topicResult.suggestedProject && topicResult.confidence > 0) {\n      // Look up the full project info from the registry\n      const projectRow = registryDb\n        .prepare(\n          \"SELECT slug, display_name, root_path FROM projects WHERE slug = ? AND status != 'archived'\"\n        )\n        .get(topicResult.suggestedProject) as\n        | { slug: string; display_name: string; root_path: string }\n        | undefined;\n\n      if (projectRow) {\n        return {\n          slug: projectRow.slug,\n          display_name: projectRow.display_name,\n          root_path: projectRow.root_path,\n          method: \"topic\",\n          confidence: topicResult.confidence,\n        };\n      }\n    }\n  }\n\n  return null;\n}\n\n// ---------------------------------------------------------------------------\n// Marker walk helper\n// ---------------------------------------------------------------------------\n\n/**\n * Walk up the directory tree from `startDir`, checking each level for a\n * `Notes/PAI.md` file. If found, read the slug and look up the project.\n *\n * Stops at the filesystem root or after 20 levels (safety guard).\n */\nfunction findMarkerUpward(\n  registryDb: Database,\n  startDir: string\n): AutoRouteResult | null {\n  let current = startDir;\n  let depth = 0;\n\n  while (depth < 20) {\n    const markerPath = `${current}/Notes/PAI.md`;\n\n    if (existsSync(markerPath)) {\n      const marker = readPaiMarker(current);\n\n      if (marker && marker.status !== \"archived\") {\n        // Resolve slug to full project info in the registry\n        const projectRow = registryDb\n          .prepare(\n            \"SELECT slug, display_name, root_path FROM projects WHERE slug = ? AND status != 'archived'\"\n          )\n          .get(marker.slug) as\n          | { slug: string; display_name: string; root_path: string }\n          | undefined;\n\n        if (projectRow) {\n          return {\n            slug: projectRow.slug,\n            display_name: projectRow.display_name,\n            root_path: projectRow.root_path,\n            method: \"marker\",\n            confidence: 1.0,\n          };\n        }\n      }\n    }\n\n    const parent = dirname(current);\n    if (parent === current) break; // Reached filesystem root\n    current = parent;\n    depth++;\n  }\n\n  return null;\n}\n\n// ---------------------------------------------------------------------------\n// Format helpers\n// ---------------------------------------------------------------------------\n\n/**\n * Format an AutoRouteResult as a human-readable string for CLI output.\n */\nexport function formatAutoRoute(result: AutoRouteResult): string {\n  const lines: string[] = [\n    `slug:         ${result.slug}`,\n    `display_name: ${result.display_name}`,\n    `root_path:    ${result.root_path}`,\n    `method:       ${result.method}`,\n    `confidence:   ${(result.confidence * 100).toFixed(0)}%`,\n  ];\n  return lines.join(\"\\n\");\n}\n\n/**\n * Format an AutoRouteResult as JSON for machine consumption.\n */\nexport function formatAutoRouteJson(result: AutoRouteResult): string {\n  return JSON.stringify(result, null, 2);\n}\n"],"mappings":";;;;;;;;;;;;;;;AAsDA,eAAsB,UACpB,YACA,YACA,KACA,SACiC;CACjC,MAAM,SAAS,QAAQ,OAAO,QAAQ,KAAK,CAAC;CAM5C,MAAM,YAAY,cAAc,YAAY,OAAO;AAEnD,KAAI,UACF,QAAO;EACL,MAAM,UAAU;EAChB,cAAc,UAAU;EACxB,WAAW,UAAU;EACrB,QAAQ;EACR,YAAY;EACb;CAUH,MAAM,eAAe,iBAAiB,YAAY,OAAO;AACzD,KAAI,aACF,QAAO;AAOT,KAAI,WAAW,QAAQ,MAAM,CAAC,SAAS,GAAG;EAExC,MAAM,EAAE,qBAAqB,MAAM,OAAO;EAC1C,MAAM,cAAc,MAAM,iBAAiB,YAAY,YAAY;GACjE;GACA,WAAW;GACZ,CAAC;AAEF,MAAI,YAAY,oBAAoB,YAAY,aAAa,GAAG;GAE9D,MAAM,aAAa,WAChB,QACC,6FACD,CACA,IAAI,YAAY,iBAAiB;AAIpC,OAAI,WACF,QAAO;IACL,MAAM,WAAW;IACjB,cAAc,WAAW;IACzB,WAAW,WAAW;IACtB,QAAQ;IACR,YAAY,YAAY;IACzB;;;AAKP,QAAO;;;;;;;;AAaT,SAAS,iBACP,YACA,UACwB;CACxB,IAAI,UAAU;CACd,IAAI,QAAQ;AAEZ,QAAO,QAAQ,IAAI;AAGjB,MAAI,WAFe,GAAG,QAAQ,eAEJ,EAAE;GAC1B,MAAM,SAAS,cAAc,QAAQ;AAErC,OAAI,UAAU,OAAO,WAAW,YAAY;IAE1C,MAAM,aAAa,WAChB,QACC,6FACD,CACA,IAAI,OAAO,KAAK;AAInB,QAAI,WACF,QAAO;KACL,MAAM,WAAW;KACjB,cAAc,WAAW;KACzB,WAAW,WAAW;KACtB,QAAQ;KACR,YAAY;KACb;;;EAKP,MAAM,SAAS,QAAQ,QAAQ;AAC/B,MAAI,WAAW,QAAS;AACxB,YAAU;AACV;;AAGF,QAAO;;;;;AAwBT,SAAgB,oBAAoB,QAAiC;AACnE,QAAO,KAAK,UAAU,QAAQ,MAAM,EAAE"}
+{"version":3,"file":"auto-route-BG6I_4B1.mjs","names":[],"sources":["../src/session/auto-route.ts"],"sourcesContent":["/**\n * Auto-route: automatic project routing suggestion on session start.\n *\n * Given a working directory (and optional conversation context), determine\n * which registered project the session belongs to.\n *\n * Strategy (in priority order):\n *   1. Path match   — exact or parent-directory match in the project registry\n *   2. Marker walk  — walk up from cwd looking for Notes/PAI.md, resolve slug\n *   3. Topic match  — BM25 keyword search against memory (requires context text)\n *\n * The function is stateless and works with direct DB access (no daemon\n * required), making it fast and safe to call during session startup.\n */\n\nimport type { Database } from \"better-sqlite3\";\nimport type { StorageBackend } from \"../storage/interface.js\";\nimport { resolve, dirname } from \"node:path\";\nimport { existsSync } from \"node:fs\";\nimport { readPaiMarker } from \"../registry/pai-marker.js\";\nimport { detectProject } from \"../cli/commands/detect.js\";\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\nexport type AutoRouteMethod = \"path\" | \"marker\" | \"topic\";\n\nexport interface AutoRouteResult {\n  /** Project slug */\n  slug: string;\n  /** Human-readable project name */\n  display_name: string;\n  /** Absolute path to the project root */\n  root_path: string;\n  /** How the project was detected */\n  method: AutoRouteMethod;\n  /** Confidence [0,1]: 1.0 for path/marker matches, BM25 fraction for topic */\n  confidence: number;\n}\n\n// ---------------------------------------------------------------------------\n// Core function\n// ---------------------------------------------------------------------------\n\n/**\n * Determine which project a session should be routed to.\n *\n * @param registryDb  Open PAI registry database\n * @param federation  Memory storage backend (needed only for topic fallback)\n * @param cwd         Working directory to detect from (defaults to process.cwd())\n * @param context     Optional conversation text for topic-based fallback\n * @returns           Best project match, or null if nothing matched\n */\nexport async function autoRoute(\n  registryDb: Database,\n  federation: Database | StorageBackend,\n  cwd?: string,\n  context?: string\n): Promise<AutoRouteResult | null> {\n  const target = resolve(cwd ?? process.cwd());\n\n  // -------------------------------------------------------------------------\n  // Strategy 1: Path match via registry\n  // -------------------------------------------------------------------------\n\n  const pathMatch = detectProject(registryDb, target);\n\n  if (pathMatch) {\n    return {\n      slug: pathMatch.slug,\n      display_name: pathMatch.display_name,\n      root_path: pathMatch.root_path,\n      method: \"path\",\n      confidence: 1.0,\n    };\n  }\n\n  // -------------------------------------------------------------------------\n  // Strategy 2: PAI.md marker file walk\n  //\n  // Walk up from cwd, checking <dir>/Notes/PAI.md at each level.\n  // Once found, resolve the slug against the registry to get full project info.\n  // -------------------------------------------------------------------------\n\n  const markerResult = findMarkerUpward(registryDb, target);\n  if (markerResult) {\n    return markerResult;\n  }\n\n  // -------------------------------------------------------------------------\n  // Strategy 3: Topic detection (requires context text)\n  // -------------------------------------------------------------------------\n\n  if (context && context.trim().length > 0) {\n    // Lazy import to avoid bundler pulling in daemon/index.mjs at module load time\n    const { detectTopicShift } = await import(\"../topics/detector.js\");\n    const topicResult = await detectTopicShift(registryDb, federation, {\n      context,\n      threshold: 0.5, // Lower threshold for initial routing (vs shift detection)\n    });\n\n    if (topicResult.suggestedProject && topicResult.confidence > 0) {\n      // Look up the full project info from the registry\n      const projectRow = registryDb\n        .prepare(\n          \"SELECT slug, display_name, root_path FROM projects WHERE slug = ? AND status != 'archived'\"\n        )\n        .get(topicResult.suggestedProject) as\n        | { slug: string; display_name: string; root_path: string }\n        | undefined;\n\n      if (projectRow) {\n        return {\n          slug: projectRow.slug,\n          display_name: projectRow.display_name,\n          root_path: projectRow.root_path,\n          method: \"topic\",\n          confidence: topicResult.confidence,\n        };\n      }\n    }\n  }\n\n  return null;\n}\n\n// ---------------------------------------------------------------------------\n// Marker walk helper\n// ---------------------------------------------------------------------------\n\n/**\n * Walk up the directory tree from `startDir`, checking each level for a\n * `Notes/PAI.md` file. If found, read the slug and look up the project.\n *\n * Stops at the filesystem root or after 20 levels (safety guard).\n */\nfunction findMarkerUpward(\n  registryDb: Database,\n  startDir: string\n): AutoRouteResult | null {\n  let current = startDir;\n  let depth = 0;\n\n  while (depth < 20) {\n    const markerPath = `${current}/Notes/PAI.md`;\n\n    if (existsSync(markerPath)) {\n      const marker = readPaiMarker(current);\n\n      if (marker && marker.status !== \"archived\") {\n        // Resolve slug to full project info in the registry\n        const projectRow = registryDb\n          .prepare(\n            \"SELECT slug, display_name, root_path FROM projects WHERE slug = ? AND status != 'archived'\"\n          )\n          .get(marker.slug) as\n          | { slug: string; display_name: string; root_path: string }\n          | undefined;\n\n        if (projectRow) {\n          return {\n            slug: projectRow.slug,\n            display_name: projectRow.display_name,\n            root_path: projectRow.root_path,\n            method: \"marker\",\n            confidence: 1.0,\n          };\n        }\n      }\n    }\n\n    const parent = dirname(current);\n    if (parent === current) break; // Reached filesystem root\n    current = parent;\n    depth++;\n  }\n\n  return null;\n}\n\n// ---------------------------------------------------------------------------\n// Format helpers\n// ---------------------------------------------------------------------------\n\n/**\n * Format an AutoRouteResult as a human-readable string for CLI output.\n */\nexport function formatAutoRoute(result: AutoRouteResult): string {\n  const lines: string[] = [\n    `slug:         ${result.slug}`,\n    `display_name: ${result.display_name}`,\n    `root_path:    ${result.root_path}`,\n    `method:       ${result.method}`,\n    `confidence:   ${(result.confidence * 100).toFixed(0)}%`,\n  ];\n  return lines.join(\"\\n\");\n}\n\n/**\n * Format an AutoRouteResult as JSON for machine consumption.\n */\nexport function formatAutoRouteJson(result: AutoRouteResult): string {\n  return JSON.stringify(result, null, 2);\n}\n"],"mappings":";;;;;;;;;;;;;;;AAsDA,eAAsB,UACpB,YACA,YACA,KACA,SACiC;CACjC,MAAM,SAAS,QAAQ,OAAO,QAAQ,KAAK,CAAC;CAM5C,MAAM,YAAY,cAAc,YAAY,OAAO;AAEnD,KAAI,UACF,QAAO;EACL,MAAM,UAAU;EAChB,cAAc,UAAU;EACxB,WAAW,UAAU;EACrB,QAAQ;EACR,YAAY;EACb;CAUH,MAAM,eAAe,iBAAiB,YAAY,OAAO;AACzD,KAAI,aACF,QAAO;AAOT,KAAI,WAAW,QAAQ,MAAM,CAAC,SAAS,GAAG;EAExC,MAAM,EAAE,qBAAqB,MAAM,OAAO;EAC1C,MAAM,cAAc,MAAM,iBAAiB,YAAY,YAAY;GACjE;GACA,WAAW;GACZ,CAAC;AAEF,MAAI,YAAY,oBAAoB,YAAY,aAAa,GAAG;GAE9D,MAAM,aAAa,WAChB,QACC,6FACD,CACA,IAAI,YAAY,iBAAiB;AAIpC,OAAI,WACF,QAAO;IACL,MAAM,WAAW;IACjB,cAAc,WAAW;IACzB,WAAW,WAAW;IACtB,QAAQ;IACR,YAAY,YAAY;IACzB;;;AAKP,QAAO;;;;;;;;AAaT,SAAS,iBACP,YACA,UACwB;CACxB,IAAI,UAAU;CACd,IAAI,QAAQ;AAEZ,QAAO,QAAQ,IAAI;AAGjB,MAAI,WAFe,GAAG,QAAQ,eAEJ,EAAE;GAC1B,MAAM,SAAS,cAAc,QAAQ;AAErC,OAAI,UAAU,OAAO,WAAW,YAAY;IAE1C,MAAM,aAAa,WAChB,QACC,6FACD,CACA,IAAI,OAAO,KAAK;AAInB,QAAI,WACF,QAAO;KACL,MAAM,WAAW;KACjB,cAAc,WAAW;KACzB,WAAW,WAAW;KACtB,QAAQ;KACR,YAAY;KACb;;;EAKP,MAAM,SAAS,QAAQ,QAAQ;AAC/B,MAAI,WAAW,QAAS;AACxB,YAAU;AACV;;AAGF,QAAO;;;;;AAwBT,SAAgB,oBAAoB,QAAiC;AACnE,QAAO,KAAK,UAAU,QAAQ,MAAM,EAAE"}

package/dist/cli/index.mjs

@@ -6,11 +6,11 @@ import { n as ensurePaiMarker, t as discoverPaiMarkers } from "../pai-marker-CXQ
 import { n as openFederation } from "../db-Dp8VXIMR.mjs";
 import { a as indexProject, n as embedChunks, r as indexAll } from "../indexer-CKQcgKsz.mjs";
 import "../embeddings-DGRAPAYb.mjs";
-import { n as populateSlugs, r as searchMemory } from "../search-GK0ibTJy.mjs";
-import { n as formatDetection, r as formatDetectionJson, t as detectProject } from "../detect-D7gPV3fQ.mjs";
-import { t as PaiClient } from "../ipc-client-CLt2fNlC.mjs";
-import { a as expandHome, n as CONFIG_FILE$2, o as loadConfig$1, t as CONFIG_DIR } from "../config-DELNqq3Z.mjs";
-import { t as createStorageBackend } from "../factory-DZLvRf4m.mjs";
+import { n as populateSlugs, r as searchMemory } from "../search-_oHfguA5.mjs";
+import { a as expandHome, i as ensureConfigDir, n as CONFIG_FILE$2, o as loadConfig$1, t as CONFIG_DIR } from "../config-Cf92lGX_.mjs";
+import { n as formatDetection, r as formatDetectionJson, t as detectProject } from "../detect-BU3Nx_2L.mjs";
+import { t as PaiClient } from "../ipc-client-Bjg_a1dc.mjs";
+import { t as createStorageBackend } from "../factory-CeXQzlwn.mjs";
 import { appendFileSync, chmodSync, copyFileSync, existsSync, lstatSync, mkdirSync, readFileSync, readdirSync, readlinkSync, renameSync, statSync, symlinkSync, unlinkSync, writeFileSync } from "node:fs";
 import { homedir, tmpdir } from "node:os";
 import { basename, dirname, join, relative, resolve } from "node:path";
@@ -1809,10 +1809,10 @@ function cmdActive(db, opts) {
 	], rows));
 }
 async function cmdAutoRoute(opts) {
-	const { autoRoute, formatAutoRoute, formatAutoRouteJson } = await import("../auto-route-JjW3f7pV.mjs");
+	const { autoRoute, formatAutoRoute, formatAutoRouteJson } = await import("../auto-route-BG6I_4B1.mjs");
 	const { openRegistry } = await import("../db-4lSqLFb8.mjs").then((n) => n.t);
-	const { createStorageBackend } = await import("../factory-DZLvRf4m.mjs").then((n) => n.n);
-	const { loadConfig } = await import("../config-DELNqq3Z.mjs").then((n) => n.r);
+	const { createStorageBackend } = await import("../factory-CeXQzlwn.mjs").then((n) => n.n);
+	const { loadConfig } = await import("../config-Cf92lGX_.mjs").then((n) => n.r);
 	const config = loadConfig();
 	const registryDb = openRegistry();
 	const federation = await createStorageBackend(config);
@@ -2340,8 +2340,8 @@ async function displayDryRun(plans) {
 async function countVectorDbPaths(oldPaths) {
 	if (oldPaths.length === 0) return 0;
 	try {
-		const { loadConfig } = await import("../config-DELNqq3Z.mjs").then((n) => n.r);
-		const { PostgresBackend } = await import("../postgres-CRBe30Ag.mjs");
+		const { loadConfig } = await import("../config-Cf92lGX_.mjs").then((n) => n.r);
+		const { PostgresBackend } = await import("../postgres-CIxeqf_n.mjs");
 		const config = loadConfig();
 		if (config.storageBackend !== "postgres") return 0;
 		const pgBackend = new PostgresBackend(config.postgres ?? {});
@@ -2367,8 +2367,8 @@ async function countVectorDbPaths(oldPaths) {
 async function updateVectorDbPaths(moves) {
 	if (moves.length === 0) return 0;
 	try {
-		const { loadConfig } = await import("../config-DELNqq3Z.mjs").then((n) => n.r);
-		const { PostgresBackend } = await import("../postgres-CRBe30Ag.mjs");
+		const { loadConfig } = await import("../config-Cf92lGX_.mjs").then((n) => n.r);
+		const { PostgresBackend } = await import("../postgres-CIxeqf_n.mjs");
 		const config = loadConfig();
 		if (config.storageBackend !== "postgres") return 0;
 		const pgBackend = new PostgresBackend(config.postgres ?? {});
@@ -3039,6 +3039,15 @@ function registerRegistryCommands(registryCmd, getDb) {
 
 //#endregion
 //#region src/cli/commands/memory.ts
+/**
+* CLI commands for the PAI memory engine (Phase 2 / Phase 2.5).
+*
+* Commands:
+*   pai memory index [project-slug]   — index one or all projects
+*   pai memory embed [project-slug]   — generate embeddings for un-embedded chunks
+*   pai memory search <query>         — BM25/semantic/hybrid search across federation.db
+*   pai memory status [project-slug]  — show index stats
+*/
 function tierColor(tier) {
 	switch (tier) {
 		case "evergreen": return chalk.green(tier);
@@ -3110,7 +3119,7 @@ function registerMemoryCommands(memoryCmd, getDb) {
 			await runEmbed(federation, project.id, project.slug, parseInt(opts.batchSize ?? "50", 10));
 		} else await runEmbed(federation, void 0, void 0, parseInt(opts.batchSize ?? "50", 10));
 	});
-	memoryCmd.command("search <query>").description("Search indexed memory (BM25 keyword, semantic, or hybrid)").option("--project <slug>", "Restrict search to a specific project").option("--source <source>", "Restrict to 'memory' or 'notes'").option("--limit <n>", "Maximum results to return", "10").option("--mode <mode>", "Search mode: keyword (default), semantic, hybrid", "keyword").action(async (query, opts) => {
+	memoryCmd.command("search <query>").description("Search indexed memory (BM25 keyword, semantic, or hybrid)").option("--project <slug>", "Restrict search to a specific project").option("--source <source>", "Restrict to 'memory' or 'notes'").option("--limit <n>", "Maximum results to return").option("--mode <mode>", "Search mode: keyword (default), semantic, hybrid").option("--no-rerank", "Skip cross-encoder reranking (reranking is on by default)").option("--recency <days>", "Apply recency boost: score halves every N days. 0 = off").action(async (query, opts) => {
 		const registryDb = getDb();
 		let federation;
 		try {
@@ -3119,8 +3128,9 @@ function registerMemoryCommands(memoryCmd, getDb) {
 			console.error(err(`Failed to open federation database: ${e}`));
 			process.exit(1);
 		}
-		const maxResults = parseInt(opts.limit ?? "10", 10);
-		const mode = opts.mode ?? "keyword";
+		const searchConfig = loadConfig$1().search;
+		const maxResults = parseInt(opts.limit ?? String(searchConfig.defaultLimit), 10);
+		const mode = opts.mode ?? searchConfig.mode;
 		if (![
 			"keyword",
 			"semantic",
@@ -3194,8 +3204,20 @@ function registerMemoryCommands(memoryCmd, getDb) {
 			console.log(dim(`No results found for: "${query}" (mode: ${mode})`));
 			return;
 		}
+		if (opts.rerank !== false) {
+			const { rerankResults } = await import("../reranker-D7bRAHi6.mjs").then((n) => n.r);
+			console.log(dim("Reranking with cross-encoder..."));
+			results = await rerankResults(query, results, { topK: maxResults });
+		}
+		const recencyDays = parseInt(opts.recency ?? String(searchConfig.recencyBoostDays), 10);
+		if (recencyDays > 0) {
+			const { applyRecencyBoost } = await import("../search-_oHfguA5.mjs").then((n) => n.o);
+			console.log(dim(`Applying recency boost (half-life: ${recencyDays} days)...`));
+			results = applyRecencyBoost(results, recencyDays);
+		}
 		const withSlugs = populateSlugs(results, registryDb);
-		const modeLabel = mode !== "keyword" ? ` [${mode}]` : "";
+		const rerankLabel = opts.rerank !== false ? " +rerank" : "";
+		const modeLabel = mode !== "keyword" ? ` [${mode}${rerankLabel}]` : opts.rerank !== false ? ` [rerank]` : "";
 		console.log(`\n  ${bold(`Search results for: "${query}"`)}${modeLabel}  ${dim(`(${withSlugs.length} found)`)}\n`);
 		for (const result of withSlugs) {
 			const projectLabel = result.projectSlug ? chalk.cyan(result.projectSlug) : chalk.cyan(String(result.projectId));
@@ -3277,6 +3299,81 @@ function registerMemoryCommands(memoryCmd, getDb) {
 			console.log();
 		}
 	});
+	memoryCmd.command("settings [key] [value]").description("View or modify search settings in ~/.config/pai/config.json").action((key, value) => {
+		const search = loadConfig$1().search;
+		if (!key) {
+			console.log(`\n  ${bold("PAI Memory — Search Settings")}\n`);
+			console.log(`  ${bold("mode:")}             ${search.mode}`);
+			console.log(`  ${bold("rerank:")}           ${search.rerank}`);
+			console.log(`  ${bold("recencyBoostDays:")} ${search.recencyBoostDays}`);
+			console.log(`  ${bold("defaultLimit:")}     ${search.defaultLimit}`);
+			console.log(`  ${bold("snippetLength:")}    ${search.snippetLength}`);
+			console.log();
+			console.log(dim(`  Config file: ${CONFIG_FILE$2}`));
+			console.log(dim(`  Edit directly or use: pai memory settings <key> <value>`));
+			console.log();
+			return;
+		}
+		if (!value) {
+			const val = search[key];
+			if (val === void 0) {
+				console.error(err(`Unknown setting: ${key}`));
+				console.log(dim(`  Valid keys: mode, rerank, recencyBoostDays, defaultLimit, snippetLength`));
+				process.exit(1);
+			}
+			console.log(String(val));
+			return;
+		}
+		const validKeys = new Set([
+			"mode",
+			"rerank",
+			"recencyBoostDays",
+			"defaultLimit",
+			"snippetLength"
+		]);
+		if (!validKeys.has(key)) {
+			console.error(err(`Unknown setting: ${key}`));
+			console.log(dim(`  Valid keys: ${[...validKeys].join(", ")}`));
+			process.exit(1);
+		}
+		let fileConfig = {};
+		if (existsSync(CONFIG_FILE$2)) try {
+			fileConfig = JSON.parse(readFileSync(CONFIG_FILE$2, "utf-8"));
+		} catch {
+			console.error(err(`Could not parse ${CONFIG_FILE$2}`));
+			process.exit(1);
+		}
+		if (!fileConfig.search || typeof fileConfig.search !== "object") fileConfig.search = {};
+		let parsed;
+		if (key === "mode") {
+			if (![
+				"keyword",
+				"semantic",
+				"hybrid"
+			].includes(value)) {
+				console.error(err(`Invalid mode: ${value}. Must be keyword, semantic, or hybrid.`));
+				process.exit(1);
+			}
+			parsed = value;
+		} else if (key === "rerank") parsed = value === "true" || value === "1" || value === "on";
+		else {
+			parsed = parseInt(value, 10);
+			if (isNaN(parsed)) {
+				console.error(err(`Invalid number: ${value}`));
+				process.exit(1);
+			}
+		}
+		fileConfig.search[key] = parsed;
+		try {
+			ensureConfigDir();
+			writeFileSync(CONFIG_FILE$2, JSON.stringify(fileConfig, null, 2) + "\n", "utf-8");
+			console.log(ok(`Set search.${key} = ${parsed}`));
+			console.log(dim(`  Restart daemon to apply: pai daemon restart`));
+		} catch (e) {
+			console.error(err(`Could not write config: ${e}`));
+			process.exit(1);
+		}
+	});
 }
 
 //#endregion
@@ -3640,8 +3737,8 @@ function cmdLogs(opts) {
 }
 function registerDaemonCommands(daemonCmd) {
 	daemonCmd.command("serve").description("Start the PAI daemon in the foreground").action(async () => {
-		const { serve } = await import("../daemon-CeTX4NpF.mjs").then((n) => n.t);
-		const { loadConfig: lc, ensureConfigDir } = await import("../config-DELNqq3Z.mjs").then((n) => n.r);
+		const { serve } = await import("../daemon-a1W4KgFq.mjs").then((n) => n.t);
+		const { loadConfig: lc, ensureConfigDir } = await import("../config-Cf92lGX_.mjs").then((n) => n.r);
 		ensureConfigDir();
 		await serve(lc());
 	});
@@ -6087,7 +6184,7 @@ async function cmdExplore(note, opts) {
 	const depth = parseInt(opts.depth ?? "3", 10);
 	const direction = opts.direction ?? "both";
 	const mode = opts.mode ?? "all";
-	const { zettelExplore } = await import("../zettelkasten-Co-w0XSZ.mjs");
+	const { zettelExplore } = await import("../zettelkasten-e-a4rW_6.mjs");
 	const result = zettelExplore(getFedDb(), {
 		startNote: note,
 		depth,
@@ -6138,7 +6235,7 @@ async function cmdHealth(opts) {
 	const projectPath = opts.project;
 	const recentDays = parseInt(opts.days ?? "30", 10);
 	const includeTypes = opts.include ? opts.include.split(",").map((s) => s.trim()) : void 0;
-	const { zettelHealth } = await import("../zettelkasten-Co-w0XSZ.mjs");
+	const { zettelHealth } = await import("../zettelkasten-e-a4rW_6.mjs");
 	const result = zettelHealth(getFedDb(), {
 		scope,
 		projectPath,
@@ -6194,7 +6291,7 @@ async function cmdSurprise(note, opts) {
 	const limit = parseInt(opts.limit ?? "10", 10);
 	const minSimilarity = parseFloat(opts.minSimilarity ?? "0.3");
 	const minGraphDistance = parseInt(opts.minDistance ?? "3", 10);
-	const { zettelSurprise } = await import("../zettelkasten-Co-w0XSZ.mjs");
+	const { zettelSurprise } = await import("../zettelkasten-e-a4rW_6.mjs");
 	const db = getFedDb();
 	console.log();
 	console.log(header("  PAI Zettel Surprise"));
@@ -6234,7 +6331,7 @@ async function cmdSuggest(note, opts) {
 	const vaultProjectId = parseInt(opts.vaultProjectId, 10);
 	const limit = parseInt(opts.limit ?? "5", 10);
 	const excludeLinked = opts.excludeLinked !== false;
-	const { zettelSuggest } = await import("../zettelkasten-Co-w0XSZ.mjs");
+	const { zettelSuggest } = await import("../zettelkasten-e-a4rW_6.mjs");
 	const db = getFedDb();
 	console.log();
 	console.log(header("  PAI Zettel Suggest"));
@@ -6272,7 +6369,7 @@ async function cmdConverse(question, opts) {
 	const vaultProjectId = parseInt(opts.vaultProjectId, 10);
 	const depth = parseInt(opts.depth ?? "2", 10);
 	const limit = parseInt(opts.limit ?? "15", 10);
-	const { zettelConverse } = await import("../zettelkasten-Co-w0XSZ.mjs");
+	const { zettelConverse } = await import("../zettelkasten-e-a4rW_6.mjs");
 	const db = getFedDb();
 	console.log();
 	console.log(header("  PAI Zettel Converse"));
@@ -6320,7 +6417,7 @@ async function cmdThemes(opts) {
 	const minClusterSize = parseInt(opts.minSize ?? "3", 10);
 	const maxThemes = parseInt(opts.maxThemes ?? "10", 10);
 	const similarityThreshold = parseFloat(opts.threshold ?? "0.65");
-	const { zettelThemes } = await import("../zettelkasten-Co-w0XSZ.mjs");
+	const { zettelThemes } = await import("../zettelkasten-e-a4rW_6.mjs");
 	const db = getFedDb();
 	console.log();
 	console.log(header("  PAI Zettel Themes"));