@tekmidian/pai 0.2.1 → 0.3.0

package/dist/mcp/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":["z\n        .string","z\n        .boolean","z\n        .array","z.enum","z\n        .number","z\n        .enum","z.string","z\n        .record","z.unknown"],"sources":["../../src/mcp/server.ts","../../src/mcp/index.ts"],"sourcesContent":["/**\n * PAI Knowledge OS — MCP Server (Phase 3)\n *\n * Exposes PAI registry and memory as MCP tools callable by Claude Code.\n *\n * Tools:\n *   memory_search   — BM25 search across indexed memory/notes\n *   memory_get      — Read a specific file or lines from a project\n *   project_info    — Get details for a project (by slug or current dir)\n *   project_list    — List projects with optional filters\n *   session_list    — List sessions for a project\n *   registry_search — Full-text search over project slugs/names/paths\n *   project_detect  — Detect which project a path belongs to\n *   project_health  — Audit all projects for moved/deleted directories\n *   session_route   — Auto-route session to project (path/marker/topic)\n *\n * NOTE: All tool logic lives in tools.ts (shared with the daemon).\n * This file wires MCP schema definitions to those pure functions.\n */\n\nimport { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\";\nimport { z } from \"zod\";\nimport { openRegistry } from \"../registry/db.js\";\nimport { openFederation } from \"../memory/db.js\";\nimport {\n  toolMemorySearch,\n  toolMemoryGet,\n  toolProjectInfo,\n  toolProjectList,\n  toolSessionList,\n  toolRegistrySearch,\n  toolProjectDetect,\n  toolProjectHealth,\n  toolNotificationConfig,\n  toolTopicDetect,\n  toolSessionRoute,\n} from \"./tools.js\";\n\n// ---------------------------------------------------------------------------\n// Database singletons (opened lazily, once per MCP server process)\n// ---------------------------------------------------------------------------\n\nlet _registryDb: ReturnType<typeof openRegistry> | null = null;\nlet _federationDb: ReturnType<typeof openFederation> | null = null;\n\nfunction getRegistryDb() {\n  if (!_registryDb) _registryDb = openRegistry();\n  return _registryDb;\n}\n\nfunction getFederationDb() {\n  if (!_federationDb) _federationDb = openFederation();\n  return _federationDb;\n}\n\n// ---------------------------------------------------------------------------\n// MCP server startup\n// ---------------------------------------------------------------------------\n\nexport async function startMcpServer(): Promise<void> {\n  const server = new McpServer({\n    name: \"pai\",\n    version: \"0.1.0\",\n  });\n\n  // -------------------------------------------------------------------------\n  // Tool: memory_search\n  // -------------------------------------------------------------------------\n\n  server.tool(\n    \"memory_search\",\n    [\n      \"Search PAI federated memory using BM25 full-text ranking, semantic similarity, or a hybrid of both.\",\n      \"\",\n      \"Use this BEFORE answering questions about past work, decisions, dates, people,\",\n      \"preferences, project status, todos, technical choices, or anything that might\",\n      \"have been recorded in session notes or memory files.\",\n      \"\",\n      \"Modes:\",\n      \"  keyword  — BM25 full-text search (default, fast, no embeddings required)\",\n      \"  semantic — Cosine similarity over vector embeddings (requires prior embed run)\",\n      \"  hybrid   — Normalized combination of BM25 + cosine (best quality)\",\n      \"\",\n      \"Returns ranked snippets with project slug, file path, line range, and score.\",\n      \"Higher score = more relevant.\",\n    ].join(\"\\n\"),\n    {\n      query: z\n        .string()\n        .describe(\"Free-text search query. Multiple words are ORed together — any matching word returns a result, ranked by relevance.\"),\n      project: z\n        .string()\n        .optional()\n        .describe(\n          \"Scope search to a single project by slug. Omit to search all projects.\"\n        ),\n      all_projects: z\n        .boolean()\n        .optional()\n        .describe(\n          \"Explicitly search all projects (default behaviour when project is omitted).\"\n        ),\n      sources: z\n        .array(z.enum([\"memory\", \"notes\"]))\n        .optional()\n        .describe(\"Restrict to specific source types: 'memory' or 'notes'.\"),\n      limit: z\n        .number()\n        .int()\n        .min(1)\n        .max(100)\n        .optional()\n        .describe(\"Maximum results to return. Default: 10.\"),\n      mode: z\n        .enum([\"keyword\", \"semantic\", \"hybrid\"])\n        .optional()\n        .describe(\n          \"Search mode: 'keyword' (BM25, default), 'semantic' (vector cosine), or 'hybrid' (both combined).\"\n        ),\n    },\n    async (args) => {\n      const result = await toolMemorySearch(\n        getRegistryDb(),\n        getFederationDb(),\n        args\n      );\n      return {\n        content: result.content.map((c) => ({ type: c.type as \"text\", text: c.text })),\n        isError: result.isError,\n      };\n    }\n  );\n\n  // -------------------------------------------------------------------------\n  // Tool: memory_get\n  // -------------------------------------------------------------------------\n\n  server.tool(\n    \"memory_get\",\n    [\n      \"Read the content of a specific file from a registered PAI project.\",\n      \"\",\n      \"Use this to read a full memory file, session note, or document after finding\",\n      \"it via memory_search. Optionally restrict to a line range.\",\n      \"\",\n      \"The path must be a relative path within the project root (no ../ traversal).\",\n    ].join(\"\\n\"),\n    {\n      project: z\n        .string()\n        .describe(\"Project slug identifying which project's files to read from.\"),\n      path: z\n        .string()\n        .describe(\n          \"Relative path within the project root (e.g. 'Notes/0001 - 2026-01-01 - Example.md').\"\n        ),\n      from: z\n        .number()\n        .int()\n        .min(1)\n        .optional()\n        .describe(\"Starting line number (1-based, inclusive). Default: 1.\"),\n      lines: z\n        .number()\n        .int()\n        .min(1)\n        .optional()\n        .describe(\"Number of lines to return. Default: entire file.\"),\n    },\n    async (args) => {\n      const result = toolMemoryGet(getRegistryDb(), args);\n      return {\n        content: result.content.map((c) => ({ type: c.type as \"text\", text: c.text })),\n        isError: result.isError,\n      };\n    }\n  );\n\n  // -------------------------------------------------------------------------\n  // Tool: project_info\n  // -------------------------------------------------------------------------\n\n  server.tool(\n    \"project_info\",\n    [\n      \"Get detailed information about a PAI registered project.\",\n      \"\",\n      \"Use this to look up a project's root path, type, status, tags, session count,\",\n      \"and last active date. If no slug is provided, attempts to detect the current\",\n      \"project from the caller's working directory.\",\n    ].join(\"\\n\"),\n    {\n      slug: z\n        .string()\n        .optional()\n        .describe(\n          \"Project slug. Omit to auto-detect from the current working directory.\"\n        ),\n    },\n    async (args) => {\n      const result = toolProjectInfo(getRegistryDb(), args);\n      return {\n        content: result.content.map((c) => ({ type: c.type as \"text\", text: c.text })),\n        isError: result.isError,\n      };\n    }\n  );\n\n  // -------------------------------------------------------------------------\n  // Tool: project_list\n  // -------------------------------------------------------------------------\n\n  server.tool(\n    \"project_list\",\n    [\n      \"List registered PAI projects with optional filters.\",\n      \"\",\n      \"Use this to browse all known projects, find projects by status or tag,\",\n      \"or get a quick overview of the PAI registry.\",\n    ].join(\"\\n\"),\n    {\n      status: z\n        .enum([\"active\", \"archived\", \"migrating\"])\n        .optional()\n        .describe(\"Filter by project status. Default: all statuses.\"),\n      tag: z\n        .string()\n        .optional()\n        .describe(\"Filter by tag name (exact match).\"),\n      limit: z\n        .number()\n        .int()\n        .min(1)\n        .max(500)\n        .optional()\n        .describe(\"Maximum number of projects to return. Default: 50.\"),\n    },\n    async (args) => {\n      const result = toolProjectList(getRegistryDb(), args);\n      return {\n        content: result.content.map((c) => ({ type: c.type as \"text\", text: c.text })),\n        isError: result.isError,\n      };\n    }\n  );\n\n  // -------------------------------------------------------------------------\n  // Tool: session_list\n  // -------------------------------------------------------------------------\n\n  server.tool(\n    \"session_list\",\n    [\n      \"List session notes for a PAI project.\",\n      \"\",\n      \"Use this to find what sessions exist for a project, see their dates and titles,\",\n      \"and identify specific session notes to read via memory_get.\",\n    ].join(\"\\n\"),\n    {\n      project: z.string().describe(\"Project slug to list sessions for.\"),\n      limit: z\n        .number()\n        .int()\n        .min(1)\n        .max(500)\n        .optional()\n        .describe(\"Maximum sessions to return. Default: 10 (most recent first).\"),\n      status: z\n        .enum([\"open\", \"completed\", \"compacted\"])\n        .optional()\n        .describe(\"Filter by session status.\"),\n    },\n    async (args) => {\n      const result = toolSessionList(getRegistryDb(), args);\n      return {\n        content: result.content.map((c) => ({ type: c.type as \"text\", text: c.text })),\n        isError: result.isError,\n      };\n    }\n  );\n\n  // -------------------------------------------------------------------------\n  // Tool: registry_search\n  // -------------------------------------------------------------------------\n\n  server.tool(\n    \"registry_search\",\n    [\n      \"Search PAI project registry by slug, display name, or path.\",\n      \"\",\n      \"Use this to find the slug for a project when you know its name or path,\",\n      \"or to check if a project is registered. Returns matching project entries.\",\n    ].join(\"\\n\"),\n    {\n      query: z\n        .string()\n        .describe(\n          \"Search term matched against project slugs, display names, and root paths (case-insensitive substring match).\"\n        ),\n    },\n    async (args) => {\n      const result = toolRegistrySearch(getRegistryDb(), args);\n      return {\n        content: result.content.map((c) => ({ type: c.type as \"text\", text: c.text })),\n        isError: result.isError,\n      };\n    }\n  );\n\n  // -------------------------------------------------------------------------\n  // Tool: project_detect\n  // -------------------------------------------------------------------------\n\n  server.tool(\n    \"project_detect\",\n    [\n      \"Detect which registered PAI project a filesystem path belongs to.\",\n      \"\",\n      \"Use this at session start to auto-identify the current project from the\",\n      \"working directory, or to map any path back to its registered project.\",\n      \"\",\n      \"Returns: slug, display_name, root_path, type, status, match_type (exact|parent),\",\n      \"relative_path (if the given path is inside a project), and session stats.\",\n      \"\",\n      \"match_type 'exact' means the path IS the project root.\",\n      \"match_type 'parent' means the path is a subdirectory of the project root.\",\n    ].join(\"\\n\"),\n    {\n      cwd: z\n        .string()\n        .optional()\n        .describe(\n          \"Absolute path to detect project for. Defaults to the MCP server's process.cwd().\"\n        ),\n    },\n    async (args) => {\n      const result = toolProjectDetect(getRegistryDb(), args);\n      return {\n        content: result.content.map((c) => ({ type: c.type as \"text\", text: c.text })),\n        isError: result.isError,\n      };\n    }\n  );\n\n  // -------------------------------------------------------------------------\n  // Tool: project_health\n  // -------------------------------------------------------------------------\n\n  server.tool(\n    \"project_health\",\n    [\n      \"Audit all registered PAI projects to find moved or deleted directories.\",\n      \"\",\n      \"Returns a JSON report categorising every project as:\",\n      \"  active  — root_path exists on disk\",\n      \"  stale   — root_path missing, but a directory with the same name was found nearby\",\n      \"  dead    — root_path missing, no candidate found\",\n      \"\",\n      \"Use this to diagnose orphaned sessions or missing project paths.\",\n    ].join(\"\\n\"),\n    {\n      category: z\n        .enum([\"active\", \"stale\", \"dead\", \"all\"])\n        .optional()\n        .describe(\"Filter results to a specific health category. Default: all.\"),\n    },\n    async (args) => {\n      const result = await toolProjectHealth(getRegistryDb(), args);\n      return {\n        content: result.content.map((c) => ({ type: c.type as \"text\", text: c.text })),\n        isError: result.isError,\n      };\n    }\n  );\n\n  // -------------------------------------------------------------------------\n  // Tool: notification_config\n  // -------------------------------------------------------------------------\n\n  server.tool(\n    \"notification_config\",\n    [\n      \"Query or update the PAI unified notification configuration.\",\n      \"\",\n      \"Actions:\",\n      \"  get  — Return the current notification mode, active channels, and routing table.\",\n      \"  set  — Change the notification mode or update channel/routing config.\",\n      \"  send — Send a notification through the configured channels.\",\n      \"\",\n      \"Notification modes:\",\n      \"  auto      — Use the per-event routing table (default)\",\n      \"  voice     — All events sent as WhatsApp voice (TTS)\",\n      \"  whatsapp  — All events sent as WhatsApp text\",\n      \"  ntfy      — All events sent to ntfy.sh\",\n      \"  macos     — All events sent as macOS notifications\",\n      \"  cli       — All events written to CLI output only\",\n      \"  off       — Suppress all notifications\",\n      \"\",\n      \"Event types for send: error | progress | completion | info | debug\",\n      \"\",\n      \"Examples:\",\n      '  { \"action\": \"get\" }',\n      '  { \"action\": \"set\", \"mode\": \"voice\" }',\n      '  { \"action\": \"send\", \"event\": \"completion\", \"message\": \"Done!\" }',\n    ].join(\"\\n\"),\n    {\n      action: z\n        .enum([\"get\", \"set\", \"send\"])\n        .describe(\"Action: 'get' (read config), 'set' (update config), 'send' (send notification).\"),\n      mode: z\n        .enum([\"auto\", \"voice\", \"whatsapp\", \"ntfy\", \"macos\", \"cli\", \"off\"])\n        .optional()\n        .describe(\"For action=set: new notification mode.\"),\n      channels: z\n        .record(z.string(), z.unknown())\n        .optional()\n        .describe(\n          \"For action=set: partial channel config overrides as a JSON object. \" +\n          'E.g. { \"whatsapp\": { \"enabled\": true }, \"macos\": { \"enabled\": false } }'\n        ),\n      routing: z\n        .record(z.string(), z.unknown())\n        .optional()\n        .describe(\n          \"For action=set: partial routing overrides as a JSON object. \" +\n          'E.g. { \"error\": [\"whatsapp\", \"macos\"], \"progress\": [\"cli\"] }'\n        ),\n      event: z\n        .enum([\"error\", \"progress\", \"completion\", \"info\", \"debug\"])\n        .optional()\n        .describe(\"For action=send: event type. Default: 'info'.\"),\n      message: z\n        .string()\n        .optional()\n        .describe(\"For action=send: the notification message body.\"),\n      title: z\n        .string()\n        .optional()\n        .describe(\"For action=send: optional notification title (used by macOS and ntfy).\"),\n    },\n    async (args) => {\n      const result = await toolNotificationConfig(args);\n      return {\n        content: result.content.map((c) => ({ type: c.type as \"text\", text: c.text })),\n        isError: result.isError,\n      };\n    }\n  );\n\n  // -------------------------------------------------------------------------\n  // Tool: topic_detect\n  // -------------------------------------------------------------------------\n\n  server.tool(\n    \"topic_detect\",\n    [\n      \"Detect whether recent conversation context has shifted to a different project.\",\n      \"\",\n      \"Call this when the conversation may have drifted away from the initially-routed project.\",\n      \"Provide a short summary of the recent context (last few messages or tool call results).\",\n      \"\",\n      \"Returns:\",\n      \"  shifted          — true if a topic shift was detected\",\n      \"  current_project  — the project the session is currently routed to\",\n      \"  suggested_project — the project that best matches the context\",\n      \"  confidence       — [0,1] fraction of memory mass held by suggested_project\",\n      \"  chunks_scored    — number of memory chunks that contributed to scoring\",\n      \"  top_matches      — top-3 projects with their confidence percentages\",\n      \"\",\n      \"A shift is reported when confidence >= threshold (default 0.6) and the\",\n      \"best-matching project differs from current_project.\",\n      \"\",\n      \"Use cases:\",\n      \"  - Call at session start to confirm routing is correct\",\n      \"  - Call periodically when working across multiple concerns\",\n      \"  - Integrate with pre-tool hooks for automatic drift detection\",\n    ].join(\"\\n\"),\n    {\n      context: z\n        .string()\n        .describe(\n          \"Recent conversation context: a few sentences summarising what the session has been discussing. \" +\n          \"Can include file paths, feature names, commands run, or any relevant text.\"\n        ),\n      current_project: z\n        .string()\n        .optional()\n        .describe(\n          \"The project slug this session is currently routed to. \" +\n          \"If omitted, the tool still returns the best-matching project but shifted will always be false.\"\n        ),\n      threshold: z\n        .number()\n        .min(0)\n        .max(1)\n        .optional()\n        .describe(\n          \"Minimum confidence [0,1] to declare a shift. Default: 0.6. \" +\n          \"Increase to reduce false positives. Decrease to catch subtle drifts.\"\n        ),\n    },\n    async (args) => {\n      const result = await toolTopicDetect(args);\n      return {\n        content: result.content.map((c) => ({ type: c.type as \"text\", text: c.text })),\n        isError: result.isError,\n      };\n    }\n  );\n\n  // -------------------------------------------------------------------------\n  // Tool: session_route\n  // -------------------------------------------------------------------------\n\n  server.tool(\n    \"session_route\",\n    [\n      \"Automatically detect which project this session belongs to.\",\n      \"\",\n      \"Call this at session start (e.g., from CLAUDE.md or a session-start hook)\",\n      \"to route the session to the correct project automatically.\",\n      \"\",\n      \"Detection strategy (in priority order):\",\n      \"  1. path   — exact or parent-directory match in the project registry\",\n      \"  2. marker — walk up from cwd looking for Notes/PAI.md marker files\",\n      \"  3. topic  — BM25 keyword search against memory (only if context provided)\",\n      \"\",\n      \"Returns:\",\n      \"  slug         — the matched project slug\",\n      \"  display_name — human-readable project name\",\n      \"  root_path    — absolute path to the project root\",\n      \"  method       — how it was detected: 'path', 'marker', or 'topic'\",\n      \"  confidence   — 1.0 for path/marker matches, BM25 fraction for topic\",\n      \"\",\n      \"If no match is found, returns a message explaining what was tried.\",\n      \"Run 'pai project add .' to register the current directory.\",\n    ].join(\"\\n\"),\n    {\n      cwd: z\n        .string()\n        .optional()\n        .describe(\n          \"Working directory to detect from. Defaults to process.cwd(). \" +\n          \"Pass the session's actual working directory for accurate detection.\"\n        ),\n      context: z\n        .string()\n        .optional()\n        .describe(\n          \"Optional conversation context for topic-based fallback routing. \" +\n          \"A few sentences summarising what the session will work on. \" +\n          \"Only used if path and marker detection both fail.\"\n        ),\n    },\n    async (args) => {\n      const result = await toolSessionRoute(getRegistryDb(), getFederationDb(), args);\n      return {\n        content: result.content.map((c) => ({ type: c.type as \"text\", text: c.text })),\n        isError: result.isError,\n      };\n    }\n  );\n\n  // -------------------------------------------------------------------------\n  // Connect transport and start serving\n  // -------------------------------------------------------------------------\n\n  const transport = new StdioServerTransport();\n  await server.connect(transport);\n\n  // Keep the process alive — the server runs until stdin closes\n}\n","#!/usr/bin/env node\n/**\n * PAI Knowledge OS — MCP server entry point\n *\n * When invoked as `node dist/mcp/index.mjs` (or via the `pai-mcp` bin),\n * starts the PAI MCP server on stdio transport so Claude Code can call\n * memory_search, memory_get, project_info, project_list, session_list,\n * and registry_search tools directly during conversations.\n */\n\nimport { startMcpServer } from \"./server.js\";\n\nstartMcpServer().catch((err) => {\n  // Write errors to stderr only — stdout is reserved for JSON-RPC messages\n  process.stderr.write(`PAI MCP server fatal error: ${String(err)}\\n`);\n  process.exit(1);\n});\n"],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":["z\n        .string","z\n        .boolean","z\n        .array","z.enum","z\n        .number","z\n        .enum","z.string","z\n        .record","z.unknown"],"sources":["../../src/mcp/server.ts","../../src/mcp/index.ts"],"sourcesContent":["/**\n * PAI Knowledge OS — MCP Server (Phase 3)\n *\n * Exposes PAI registry and memory as MCP tools callable by Claude Code.\n *\n * Tools:\n *   memory_search   — BM25 search across indexed memory/notes\n *   memory_get      — Read a specific file or lines from a project\n *   project_info    — Get details for a project (by slug or current dir)\n *   project_list    — List projects with optional filters\n *   session_list    — List sessions for a project\n *   registry_search — Full-text search over project slugs/names/paths\n *   project_detect  — Detect which project a path belongs to\n *   project_health  — Audit all projects for moved/deleted directories\n *   session_route   — Auto-route session to project (path/marker/topic)\n *\n * NOTE: All tool logic lives in tools.ts (shared with the daemon).\n * This file wires MCP schema definitions to those pure functions.\n */\n\nimport { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\";\nimport { z } from \"zod\";\nimport { openRegistry } from \"../registry/db.js\";\nimport { openFederation } from \"../memory/db.js\";\nimport {\n  toolMemorySearch,\n  toolMemoryGet,\n  toolProjectInfo,\n  toolProjectList,\n  toolSessionList,\n  toolRegistrySearch,\n  toolProjectDetect,\n  toolProjectHealth,\n  toolNotificationConfig,\n  toolTopicDetect,\n  toolSessionRoute,\n  toolZettelExplore,\n  toolZettelHealth,\n  toolZettelSurprise,\n  toolZettelSuggest,\n  toolZettelConverse,\n  toolZettelThemes,\n} from \"./tools.js\";\n\n// ---------------------------------------------------------------------------\n// Database singletons (opened lazily, once per MCP server process)\n// ---------------------------------------------------------------------------\n\nlet _registryDb: ReturnType<typeof openRegistry> | null = null;\nlet _federationDb: ReturnType<typeof openFederation> | null = null;\n\nfunction getRegistryDb() {\n  if (!_registryDb) _registryDb = openRegistry();\n  return _registryDb;\n}\n\nfunction getFederationDb() {\n  if (!_federationDb) _federationDb = openFederation();\n  return _federationDb;\n}\n\n// ---------------------------------------------------------------------------\n// MCP server startup\n// ---------------------------------------------------------------------------\n\nexport async function startMcpServer(): Promise<void> {\n  const server = new McpServer({\n    name: \"pai\",\n    version: \"0.1.0\",\n  });\n\n  // -------------------------------------------------------------------------\n  // Tool: memory_search\n  // -------------------------------------------------------------------------\n\n  server.tool(\n    \"memory_search\",\n    [\n      \"Search PAI federated memory using BM25 full-text ranking, semantic similarity, or a hybrid of both.\",\n      \"\",\n      \"Use this BEFORE answering questions about past work, decisions, dates, people,\",\n      \"preferences, project status, todos, technical choices, or anything that might\",\n      \"have been recorded in session notes or memory files.\",\n      \"\",\n      \"Modes:\",\n      \"  keyword  — BM25 full-text search (default, fast, no embeddings required)\",\n      \"  semantic — Cosine similarity over vector embeddings (requires prior embed run)\",\n      \"  hybrid   — Normalized combination of BM25 + cosine (best quality)\",\n      \"\",\n      \"Returns ranked snippets with project slug, file path, line range, and score.\",\n      \"Higher score = more relevant.\",\n    ].join(\"\\n\"),\n    {\n      query: z\n        .string()\n        .describe(\"Free-text search query. Multiple words are ORed together — any matching word returns a result, ranked by relevance.\"),\n      project: z\n        .string()\n        .optional()\n        .describe(\n          \"Scope search to a single project by slug. Omit to search all projects.\"\n        ),\n      all_projects: z\n        .boolean()\n        .optional()\n        .describe(\n          \"Explicitly search all projects (default behaviour when project is omitted).\"\n        ),\n      sources: z\n        .array(z.enum([\"memory\", \"notes\"]))\n        .optional()\n        .describe(\"Restrict to specific source types: 'memory' or 'notes'.\"),\n      limit: z\n        .number()\n        .int()\n        .min(1)\n        .max(100)\n        .optional()\n        .describe(\"Maximum results to return. Default: 10.\"),\n      mode: z\n        .enum([\"keyword\", \"semantic\", \"hybrid\"])\n        .optional()\n        .describe(\n          \"Search mode: 'keyword' (BM25, default), 'semantic' (vector cosine), or 'hybrid' (both combined).\"\n        ),\n    },\n    async (args) => {\n      const result = await toolMemorySearch(\n        getRegistryDb(),\n        getFederationDb(),\n        args\n      );\n      return {\n        content: result.content.map((c) => ({ type: c.type as \"text\", text: c.text })),\n        isError: result.isError,\n      };\n    }\n  );\n\n  // -------------------------------------------------------------------------\n  // Tool: memory_get\n  // -------------------------------------------------------------------------\n\n  server.tool(\n    \"memory_get\",\n    [\n      \"Read the content of a specific file from a registered PAI project.\",\n      \"\",\n      \"Use this to read a full memory file, session note, or document after finding\",\n      \"it via memory_search. Optionally restrict to a line range.\",\n      \"\",\n      \"The path must be a relative path within the project root (no ../ traversal).\",\n    ].join(\"\\n\"),\n    {\n      project: z\n        .string()\n        .describe(\"Project slug identifying which project's files to read from.\"),\n      path: z\n        .string()\n        .describe(\n          \"Relative path within the project root (e.g. 'Notes/0001 - 2026-01-01 - Example.md').\"\n        ),\n      from: z\n        .number()\n        .int()\n        .min(1)\n        .optional()\n        .describe(\"Starting line number (1-based, inclusive). Default: 1.\"),\n      lines: z\n        .number()\n        .int()\n        .min(1)\n        .optional()\n        .describe(\"Number of lines to return. Default: entire file.\"),\n    },\n    async (args) => {\n      const result = toolMemoryGet(getRegistryDb(), args);\n      return {\n        content: result.content.map((c) => ({ type: c.type as \"text\", text: c.text })),\n        isError: result.isError,\n      };\n    }\n  );\n\n  // -------------------------------------------------------------------------\n  // Tool: project_info\n  // -------------------------------------------------------------------------\n\n  server.tool(\n    \"project_info\",\n    [\n      \"Get detailed information about a PAI registered project.\",\n      \"\",\n      \"Use this to look up a project's root path, type, status, tags, session count,\",\n      \"and last active date. If no slug is provided, attempts to detect the current\",\n      \"project from the caller's working directory.\",\n    ].join(\"\\n\"),\n    {\n      slug: z\n        .string()\n        .optional()\n        .describe(\n          \"Project slug. Omit to auto-detect from the current working directory.\"\n        ),\n    },\n    async (args) => {\n      const result = toolProjectInfo(getRegistryDb(), args);\n      return {\n        content: result.content.map((c) => ({ type: c.type as \"text\", text: c.text })),\n        isError: result.isError,\n      };\n    }\n  );\n\n  // -------------------------------------------------------------------------\n  // Tool: project_list\n  // -------------------------------------------------------------------------\n\n  server.tool(\n    \"project_list\",\n    [\n      \"List registered PAI projects with optional filters.\",\n      \"\",\n      \"Use this to browse all known projects, find projects by status or tag,\",\n      \"or get a quick overview of the PAI registry.\",\n    ].join(\"\\n\"),\n    {\n      status: z\n        .enum([\"active\", \"archived\", \"migrating\"])\n        .optional()\n        .describe(\"Filter by project status. Default: all statuses.\"),\n      tag: z\n        .string()\n        .optional()\n        .describe(\"Filter by tag name (exact match).\"),\n      limit: z\n        .number()\n        .int()\n        .min(1)\n        .max(500)\n        .optional()\n        .describe(\"Maximum number of projects to return. Default: 50.\"),\n    },\n    async (args) => {\n      const result = toolProjectList(getRegistryDb(), args);\n      return {\n        content: result.content.map((c) => ({ type: c.type as \"text\", text: c.text })),\n        isError: result.isError,\n      };\n    }\n  );\n\n  // -------------------------------------------------------------------------\n  // Tool: session_list\n  // -------------------------------------------------------------------------\n\n  server.tool(\n    \"session_list\",\n    [\n      \"List session notes for a PAI project.\",\n      \"\",\n      \"Use this to find what sessions exist for a project, see their dates and titles,\",\n      \"and identify specific session notes to read via memory_get.\",\n    ].join(\"\\n\"),\n    {\n      project: z.string().describe(\"Project slug to list sessions for.\"),\n      limit: z\n        .number()\n        .int()\n        .min(1)\n        .max(500)\n        .optional()\n        .describe(\"Maximum sessions to return. Default: 10 (most recent first).\"),\n      status: z\n        .enum([\"open\", \"completed\", \"compacted\"])\n        .optional()\n        .describe(\"Filter by session status.\"),\n    },\n    async (args) => {\n      const result = toolSessionList(getRegistryDb(), args);\n      return {\n        content: result.content.map((c) => ({ type: c.type as \"text\", text: c.text })),\n        isError: result.isError,\n      };\n    }\n  );\n\n  // -------------------------------------------------------------------------\n  // Tool: registry_search\n  // -------------------------------------------------------------------------\n\n  server.tool(\n    \"registry_search\",\n    [\n      \"Search PAI project registry by slug, display name, or path.\",\n      \"\",\n      \"Use this to find the slug for a project when you know its name or path,\",\n      \"or to check if a project is registered. Returns matching project entries.\",\n    ].join(\"\\n\"),\n    {\n      query: z\n        .string()\n        .describe(\n          \"Search term matched against project slugs, display names, and root paths (case-insensitive substring match).\"\n        ),\n    },\n    async (args) => {\n      const result = toolRegistrySearch(getRegistryDb(), args);\n      return {\n        content: result.content.map((c) => ({ type: c.type as \"text\", text: c.text })),\n        isError: result.isError,\n      };\n    }\n  );\n\n  // -------------------------------------------------------------------------\n  // Tool: project_detect\n  // -------------------------------------------------------------------------\n\n  server.tool(\n    \"project_detect\",\n    [\n      \"Detect which registered PAI project a filesystem path belongs to.\",\n      \"\",\n      \"Use this at session start to auto-identify the current project from the\",\n      \"working directory, or to map any path back to its registered project.\",\n      \"\",\n      \"Returns: slug, display_name, root_path, type, status, match_type (exact|parent),\",\n      \"relative_path (if the given path is inside a project), and session stats.\",\n      \"\",\n      \"match_type 'exact' means the path IS the project root.\",\n      \"match_type 'parent' means the path is a subdirectory of the project root.\",\n    ].join(\"\\n\"),\n    {\n      cwd: z\n        .string()\n        .optional()\n        .describe(\n          \"Absolute path to detect project for. Defaults to the MCP server's process.cwd().\"\n        ),\n    },\n    async (args) => {\n      const result = toolProjectDetect(getRegistryDb(), args);\n      return {\n        content: result.content.map((c) => ({ type: c.type as \"text\", text: c.text })),\n        isError: result.isError,\n      };\n    }\n  );\n\n  // -------------------------------------------------------------------------\n  // Tool: project_health\n  // -------------------------------------------------------------------------\n\n  server.tool(\n    \"project_health\",\n    [\n      \"Audit all registered PAI projects to find moved or deleted directories.\",\n      \"\",\n      \"Returns a JSON report categorising every project as:\",\n      \"  active  — root_path exists on disk\",\n      \"  stale   — root_path missing, but a directory with the same name was found nearby\",\n      \"  dead    — root_path missing, no candidate found\",\n      \"\",\n      \"Use this to diagnose orphaned sessions or missing project paths.\",\n    ].join(\"\\n\"),\n    {\n      category: z\n        .enum([\"active\", \"stale\", \"dead\", \"all\"])\n        .optional()\n        .describe(\"Filter results to a specific health category. Default: all.\"),\n    },\n    async (args) => {\n      const result = await toolProjectHealth(getRegistryDb(), args);\n      return {\n        content: result.content.map((c) => ({ type: c.type as \"text\", text: c.text })),\n        isError: result.isError,\n      };\n    }\n  );\n\n  // -------------------------------------------------------------------------\n  // Tool: notification_config\n  // -------------------------------------------------------------------------\n\n  server.tool(\n    \"notification_config\",\n    [\n      \"Query or update the PAI unified notification configuration.\",\n      \"\",\n      \"Actions:\",\n      \"  get  — Return the current notification mode, active channels, and routing table.\",\n      \"  set  — Change the notification mode or update channel/routing config.\",\n      \"  send — Send a notification through the configured channels.\",\n      \"\",\n      \"Notification modes:\",\n      \"  auto      — Use the per-event routing table (default)\",\n      \"  voice     — All events sent as WhatsApp voice (TTS)\",\n      \"  whatsapp  — All events sent as WhatsApp text\",\n      \"  ntfy      — All events sent to ntfy.sh\",\n      \"  macos     — All events sent as macOS notifications\",\n      \"  cli       — All events written to CLI output only\",\n      \"  off       — Suppress all notifications\",\n      \"\",\n      \"Event types for send: error | progress | completion | info | debug\",\n      \"\",\n      \"Examples:\",\n      '  { \"action\": \"get\" }',\n      '  { \"action\": \"set\", \"mode\": \"voice\" }',\n      '  { \"action\": \"send\", \"event\": \"completion\", \"message\": \"Done!\" }',\n    ].join(\"\\n\"),\n    {\n      action: z\n        .enum([\"get\", \"set\", \"send\"])\n        .describe(\"Action: 'get' (read config), 'set' (update config), 'send' (send notification).\"),\n      mode: z\n        .enum([\"auto\", \"voice\", \"whatsapp\", \"ntfy\", \"macos\", \"cli\", \"off\"])\n        .optional()\n        .describe(\"For action=set: new notification mode.\"),\n      channels: z\n        .record(z.string(), z.unknown())\n        .optional()\n        .describe(\n          \"For action=set: partial channel config overrides as a JSON object. \" +\n          'E.g. { \"whatsapp\": { \"enabled\": true }, \"macos\": { \"enabled\": false } }'\n        ),\n      routing: z\n        .record(z.string(), z.unknown())\n        .optional()\n        .describe(\n          \"For action=set: partial routing overrides as a JSON object. \" +\n          'E.g. { \"error\": [\"whatsapp\", \"macos\"], \"progress\": [\"cli\"] }'\n        ),\n      event: z\n        .enum([\"error\", \"progress\", \"completion\", \"info\", \"debug\"])\n        .optional()\n        .describe(\"For action=send: event type. Default: 'info'.\"),\n      message: z\n        .string()\n        .optional()\n        .describe(\"For action=send: the notification message body.\"),\n      title: z\n        .string()\n        .optional()\n        .describe(\"For action=send: optional notification title (used by macOS and ntfy).\"),\n    },\n    async (args) => {\n      const result = await toolNotificationConfig(args);\n      return {\n        content: result.content.map((c) => ({ type: c.type as \"text\", text: c.text })),\n        isError: result.isError,\n      };\n    }\n  );\n\n  // -------------------------------------------------------------------------\n  // Tool: topic_detect\n  // -------------------------------------------------------------------------\n\n  server.tool(\n    \"topic_detect\",\n    [\n      \"Detect whether recent conversation context has shifted to a different project.\",\n      \"\",\n      \"Call this when the conversation may have drifted away from the initially-routed project.\",\n      \"Provide a short summary of the recent context (last few messages or tool call results).\",\n      \"\",\n      \"Returns:\",\n      \"  shifted          — true if a topic shift was detected\",\n      \"  current_project  — the project the session is currently routed to\",\n      \"  suggested_project — the project that best matches the context\",\n      \"  confidence       — [0,1] fraction of memory mass held by suggested_project\",\n      \"  chunks_scored    — number of memory chunks that contributed to scoring\",\n      \"  top_matches      — top-3 projects with their confidence percentages\",\n      \"\",\n      \"A shift is reported when confidence >= threshold (default 0.6) and the\",\n      \"best-matching project differs from current_project.\",\n      \"\",\n      \"Use cases:\",\n      \"  - Call at session start to confirm routing is correct\",\n      \"  - Call periodically when working across multiple concerns\",\n      \"  - Integrate with pre-tool hooks for automatic drift detection\",\n    ].join(\"\\n\"),\n    {\n      context: z\n        .string()\n        .describe(\n          \"Recent conversation context: a few sentences summarising what the session has been discussing. \" +\n          \"Can include file paths, feature names, commands run, or any relevant text.\"\n        ),\n      current_project: z\n        .string()\n        .optional()\n        .describe(\n          \"The project slug this session is currently routed to. \" +\n          \"If omitted, the tool still returns the best-matching project but shifted will always be false.\"\n        ),\n      threshold: z\n        .number()\n        .min(0)\n        .max(1)\n        .optional()\n        .describe(\n          \"Minimum confidence [0,1] to declare a shift. Default: 0.6. \" +\n          \"Increase to reduce false positives. Decrease to catch subtle drifts.\"\n        ),\n    },\n    async (args) => {\n      const result = await toolTopicDetect(args);\n      return {\n        content: result.content.map((c) => ({ type: c.type as \"text\", text: c.text })),\n        isError: result.isError,\n      };\n    }\n  );\n\n  // -------------------------------------------------------------------------\n  // Tool: session_route\n  // -------------------------------------------------------------------------\n\n  server.tool(\n    \"session_route\",\n    [\n      \"Automatically detect which project this session belongs to.\",\n      \"\",\n      \"Call this at session start (e.g., from CLAUDE.md or a session-start hook)\",\n      \"to route the session to the correct project automatically.\",\n      \"\",\n      \"Detection strategy (in priority order):\",\n      \"  1. path   — exact or parent-directory match in the project registry\",\n      \"  2. marker — walk up from cwd looking for Notes/PAI.md marker files\",\n      \"  3. topic  — BM25 keyword search against memory (only if context provided)\",\n      \"\",\n      \"Returns:\",\n      \"  slug         — the matched project slug\",\n      \"  display_name — human-readable project name\",\n      \"  root_path    — absolute path to the project root\",\n      \"  method       — how it was detected: 'path', 'marker', or 'topic'\",\n      \"  confidence   — 1.0 for path/marker matches, BM25 fraction for topic\",\n      \"\",\n      \"If no match is found, returns a message explaining what was tried.\",\n      \"Run 'pai project add .' to register the current directory.\",\n    ].join(\"\\n\"),\n    {\n      cwd: z\n        .string()\n        .optional()\n        .describe(\n          \"Working directory to detect from. Defaults to process.cwd(). \" +\n          \"Pass the session's actual working directory for accurate detection.\"\n        ),\n      context: z\n        .string()\n        .optional()\n        .describe(\n          \"Optional conversation context for topic-based fallback routing. \" +\n          \"A few sentences summarising what the session will work on. \" +\n          \"Only used if path and marker detection both fail.\"\n        ),\n    },\n    async (args) => {\n      const result = await toolSessionRoute(getRegistryDb(), getFederationDb(), args);\n      return {\n        content: result.content.map((c) => ({ type: c.type as \"text\", text: c.text })),\n        isError: result.isError,\n      };\n    }\n  );\n\n  // -------------------------------------------------------------------------\n  // Tool: zettel_explore\n  // -------------------------------------------------------------------------\n\n  server.tool(\n    \"zettel_explore\",\n    [\n      \"Explore the vault's knowledge graph using Luhmann's Folgezettel traversal.\",\n      \"Follow trains of thought forward, backward, or both from a starting note.\",\n      \"Classifies links as sequential (same-folder) or associative (cross-folder).\",\n    ].join(\"\\n\"),\n    {\n      start_note: z\n        .string()\n        .describe(\"Path or title of the note to start traversal from.\"),\n      depth: z\n        .number()\n        .int()\n        .min(1)\n        .max(10)\n        .optional()\n        .describe(\"How many link hops to traverse. Default: 3.\"),\n      direction: z\n        .enum([\"forward\", \"backward\", \"both\"])\n        .optional()\n        .describe(\"Traversal direction: 'forward' (outlinks), 'backward' (backlinks), or 'both'. Default: both.\"),\n      mode: z\n        .enum([\"sequential\", \"associative\", \"all\"])\n        .optional()\n        .describe(\"Link type filter: 'sequential' (same-folder), 'associative' (cross-folder), or 'all'. Default: all.\"),\n    },\n    async (args) => {\n      const result = await toolZettelExplore(getFederationDb(), args);\n      return {\n        content: result.content.map((c) => ({ type: c.type as \"text\", text: c.text })),\n        isError: result.isError,\n      };\n    }\n  );\n\n  // -------------------------------------------------------------------------\n  // Tool: zettel_health\n  // -------------------------------------------------------------------------\n\n  server.tool(\n    \"zettel_health\",\n    [\n      \"Audit the structural health of the Obsidian vault.\",\n      \"Reports dead links, orphan notes, disconnected clusters, low-connectivity files, and an overall health score.\",\n    ].join(\"\\n\"),\n    {\n      scope: z\n        .enum([\"full\", \"recent\", \"project\"])\n        .optional()\n        .describe(\"Audit scope: 'full' (entire vault), 'recent' (recently modified), or 'project' (specific path). Default: full.\"),\n      project_path: z\n        .string()\n        .optional()\n        .describe(\"Absolute path to the project/folder to audit when scope='project'.\"),\n      recent_days: z\n        .number()\n        .int()\n        .optional()\n        .describe(\"Number of days to look back when scope='recent'. Default: 30.\"),\n      include: z\n        .array(z.enum([\"dead_links\", \"orphans\", \"disconnected\", \"low_connectivity\"]))\n        .optional()\n        .describe(\"Specific checks to include. Omit to run all checks.\"),\n    },\n    async (args) => {\n      const result = await toolZettelHealth(getFederationDb(), args);\n      return {\n        content: result.content.map((c) => ({ type: c.type as \"text\", text: c.text })),\n        isError: result.isError,\n      };\n    }\n  );\n\n  // -------------------------------------------------------------------------\n  // Tool: zettel_surprise\n  // -------------------------------------------------------------------------\n\n  server.tool(\n    \"zettel_surprise\",\n    [\n      \"Find surprising connections — notes that are semantically similar to a reference note but far away in the link graph.\",\n      \"High surprise = unexpected relevance.\",\n    ].join(\"\\n\"),\n    {\n      reference_path: z\n        .string()\n        .describe(\"Path to the reference note to find surprising connections for.\"),\n      vault_project_id: z\n        .number()\n        .int()\n        .describe(\"Project ID of the vault to search within.\"),\n      limit: z\n        .number()\n        .int()\n        .optional()\n        .describe(\"Maximum number of surprising notes to return. Default: 10.\"),\n      min_similarity: z\n        .number()\n        .optional()\n        .describe(\"Minimum semantic similarity [0,1] for a note to be considered. Default: 0.5.\"),\n      min_graph_distance: z\n        .number()\n        .int()\n        .optional()\n        .describe(\"Minimum link hops away from the reference note. Default: 3.\"),\n    },\n    async (args) => {\n      const result = await toolZettelSurprise(getFederationDb(), args);\n      return {\n        content: result.content.map((c) => ({ type: c.type as \"text\", text: c.text })),\n        isError: result.isError,\n      };\n    }\n  );\n\n  // -------------------------------------------------------------------------\n  // Tool: zettel_suggest\n  // -------------------------------------------------------------------------\n\n  server.tool(\n    \"zettel_suggest\",\n    [\n      \"Suggest new connections for a note using semantic similarity, shared tags, and graph neighborhood (friends-of-friends).\",\n    ].join(\"\\n\"),\n    {\n      note_path: z\n        .string()\n        .describe(\"Path to the note to generate link suggestions for.\"),\n      vault_project_id: z\n        .number()\n        .int()\n        .describe(\"Project ID of the vault to search within.\"),\n      limit: z\n        .number()\n        .int()\n        .optional()\n        .describe(\"Maximum number of suggestions to return. Default: 10.\"),\n      exclude_linked: z\n        .boolean()\n        .optional()\n        .describe(\"Exclude notes already linked from this note. Default: true.\"),\n    },\n    async (args) => {\n      const result = await toolZettelSuggest(getFederationDb(), args);\n      return {\n        content: result.content.map((c) => ({ type: c.type as \"text\", text: c.text })),\n        isError: result.isError,\n      };\n    }\n  );\n\n  // -------------------------------------------------------------------------\n  // Tool: zettel_converse\n  // -------------------------------------------------------------------------\n\n  server.tool(\n    \"zettel_converse\",\n    [\n      \"Use the vault as a Zettelkasten communication partner.\",\n      \"Ask a question, get relevant notes with cross-domain connections and a synthesis prompt for generating new insights.\",\n    ].join(\"\\n\"),\n    {\n      question: z\n        .string()\n        .describe(\"The question or topic to explore in the vault.\"),\n      vault_project_id: z\n        .number()\n        .int()\n        .describe(\"Project ID of the vault to query.\"),\n      depth: z\n        .number()\n        .int()\n        .optional()\n        .describe(\"How many link hops to follow from seed notes. Default: 2.\"),\n      limit: z\n        .number()\n        .int()\n        .optional()\n        .describe(\"Maximum number of relevant notes to retrieve. Default: 10.\"),\n    },\n    async (args) => {\n      const result = await toolZettelConverse(getFederationDb(), args);\n      return {\n        content: result.content.map((c) => ({ type: c.type as \"text\", text: c.text })),\n        isError: result.isError,\n      };\n    }\n  );\n\n  // -------------------------------------------------------------------------\n  // Tool: zettel_themes\n  // -------------------------------------------------------------------------\n\n  server.tool(\n    \"zettel_themes\",\n    [\n      \"Detect emerging themes by clustering recent notes with similar embeddings.\",\n      \"Reveals forming idea clusters and suggests index notes for unlinked clusters.\",\n    ].join(\"\\n\"),\n    {\n      vault_project_id: z\n        .number()\n        .int()\n        .describe(\"Project ID of the vault to analyse.\"),\n      lookback_days: z\n        .number()\n        .int()\n        .optional()\n        .describe(\"Number of days of recent notes to cluster. Default: 30.\"),\n      min_cluster_size: z\n        .number()\n        .int()\n        .optional()\n        .describe(\"Minimum notes required to form a theme cluster. Default: 3.\"),\n      max_themes: z\n        .number()\n        .int()\n        .optional()\n        .describe(\"Maximum number of theme clusters to return. Default: 10.\"),\n      similarity_threshold: z\n        .number()\n        .optional()\n        .describe(\"Minimum cosine similarity to group notes into a cluster [0,1]. Default: 0.7.\"),\n    },\n    async (args) => {\n      const result = await toolZettelThemes(getFederationDb(), args);\n      return {\n        content: result.content.map((c) => ({ type: c.type as \"text\", text: c.text })),\n        isError: result.isError,\n      };\n    }\n  );\n\n  // -------------------------------------------------------------------------\n  // Connect transport and start serving\n  // -------------------------------------------------------------------------\n\n  const transport = new StdioServerTransport();\n  await server.connect(transport);\n\n  // Keep the process alive — the server runs until stdin closes\n}\n","#!/usr/bin/env node\n/**\n * PAI Knowledge OS — MCP server entry point\n *\n * When invoked as `node dist/mcp/index.mjs` (or via the `pai-mcp` bin),\n * starts the PAI MCP server on stdio transport so Claude Code can call\n * memory_search, memory_get, project_info, project_list, session_list,\n * and registry_search tools directly during conversations.\n */\n\nimport { startMcpServer } from \"./server.js\";\n\nstartMcpServer().catch((err) => {\n  // Write errors to stderr only — stdout is reserved for JSON-RPC messages\n  process.stderr.write(`PAI MCP server fatal error: ${String(err)}\\n`);\n  process.exit(1);\n});\n"],"mappings":"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"}

package/dist/{migrate-Bwj7qPaE.mjs → migrate-jokLenje.mjs}

@@ -1,3 +1,4 @@
+import { h as smartDecodeDir } from "./utils-QSfKagcj.mjs";
 import { existsSync, readFileSync, readdirSync } from "node:fs";
 import { homedir } from "node:os";
 import { join } from "node:path";
@@ -81,6 +82,12 @@ function buildEncodedDirMap(jsonPath = join(homedir(), ".claude", "session-regis
 *                  instead of the heuristic result.
 */
 function decodeEncodedDir(encoded, lookupMap) {
+	if (lookupMap?.has(encoded)) {
+		const mapped = lookupMap.get(encoded);
+		if (existsSync(mapped)) return mapped;
+	}
+	const smart = smartDecodeDir(encoded);
+	if (smart) return smart;
 	if (lookupMap?.has(encoded)) return lookupMap.get(encoded);
 	if (encoded.startsWith("-")) return encoded.replace(/-/g, "/");
 	return encoded;
@@ -238,4 +245,4 @@ function migrateFromJson(db, registryPath = join(homedir(), ".claude", "session-
 
 //#endregion
 export { slugify as a, parseSessionFilename as i, decodeEncodedDir as n, migrateFromJson as r, buildEncodedDirMap as t };
-//# sourceMappingURL=migrate-Bwj7qPaE.mjs.map
+//# sourceMappingURL=migrate-jokLenje.mjs.map

package/dist/migrate-jokLenje.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate-jokLenje.mjs","names":[],"sources":["../src/registry/migrate.ts"],"sourcesContent":["/**\n * Migration helper: imports the existing JSON session-registry into the\n * new SQLite registry.db.\n *\n * Source file:  ~/.claude/session-registry.json\n * Target:       openRegistry() → projects + sessions tables\n *\n * The JSON registry uses encoded directory names as keys (Claude Code's\n * encoding: leading `/` is replaced by `-`, then each remaining `/` is also\n * replaced by `-`).  This module reverses that encoding to recover the real\n * filesystem path.\n *\n * Session note filenames are expected in one of two formats:\n *   Modern:  \"NNNN - YYYY-MM-DD - Description.md\"   (space-dash-space)\n *   Legacy:  \"NNNN_YYYY-MM-DD_description.md\"        (underscores)\n */\n\nimport { existsSync, readdirSync, readFileSync } from \"node:fs\";\nimport { homedir } from \"node:os\";\nimport { join } from \"node:path\";\nimport type { Database } from \"better-sqlite3\";\nimport { smartDecodeDir } from \"../cli/utils.js\";\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\n/** Shape of a single entry in session-registry.json */\ninterface RegistryEntry {\n  /** Absolute path to the Notes/ directory for this project */\n  notesDir?: string;\n  /** Display name stored in the registry (optional) */\n  displayName?: string;\n  /** Any other keys the file might carry */\n  [key: string]: unknown;\n}\n\n/** Top-level shape of session-registry.json */\ntype SessionRegistry = Record<string, RegistryEntry>;\n\n// ---------------------------------------------------------------------------\n// Encoding / decoding\n// ---------------------------------------------------------------------------\n\n/**\n * Build a lookup table from session-registry.json mapping encoded_dir →\n * original_path.  This is the authoritative source for decoding because the\n * encoding is ambiguous: `/`, ` ` (space), `.` (dot), and `-` (literal\n * hyphen) all map to `-` or `--` in ways that cannot be uniquely reversed.\n *\n * Example:\n *   `-Users-alice--ssh`  encodes  `/Users/alice/.ssh`\n *   `-Users-alice-dev-projects-04---My-App-My-App-2020---2029`\n *                        encodes  `/Users/alice/dev/projects/04 - My-App/My-App 2020 - 2029`\n *\n * @param jsonPath  Path to session-registry.json.\n *                  Defaults to ~/.claude/session-registry.json.\n * @returns Map from encoded_dir → original_path, or empty map if the file is\n *          missing / unparseable.\n */\nexport function buildEncodedDirMap(\n  jsonPath: string = join(homedir(), \".claude\", \"session-registry.json\")\n): Map<string, string> {\n  const map = new Map<string, string>();\n  if (!existsSync(jsonPath)) return map;\n\n  try {\n    const raw = readFileSync(jsonPath, \"utf8\");\n    const parsed = JSON.parse(raw) as Record<string, unknown>;\n\n    // Support both formats:\n    //   list-based:   { \"projects\": [ { \"encoded_dir\", \"original_path\" }, ... ] }\n    //   object-keyed: { \"<encoded_dir>\": { ... } }  (original Claude format)\n    if (Array.isArray(parsed.projects)) {\n      for (const entry of parsed.projects as Array<Record<string, unknown>>) {\n        const key = entry.encoded_dir as string | undefined;\n        const val = entry.original_path as string | undefined;\n        if (key && val) map.set(key, val);\n      }\n    } else {\n      // Object-keyed format — keys are encoded dirs\n      for (const [key, value] of Object.entries(parsed)) {\n        if (key === \"version\") continue;\n        const val = (value as Record<string, unknown>)?.original_path as\n          | string\n          | undefined;\n        if (val) map.set(key, val);\n      }\n    }\n  } catch {\n    // Unparseable — return empty map; callers fall back to heuristic decode\n  }\n\n  return map;\n}\n\n/**\n * Reverse Claude Code's directory encoding.\n *\n * Claude Code's actual encoding rules:\n *   - `/` (path separator) → `-`\n *   - ` ` (space)          → `--`  (escaped)\n *   - `.` (dot)            → `--`  (escaped)\n *   - `-` (literal hyphen) → `--`  (escaped)\n *\n * Because space, dot, and hyphen all encode to `--`, the encoding is\n * **lossy** — you cannot unambiguously reverse it.  This function therefore\n * provides a *best-effort* heuristic decode (treating `--` as a literal `-`\n * which gives wrong results for paths with spaces or dots).\n *\n * PREFER using {@link buildEncodedDirMap} to get the authoritative mapping\n * from session-registry.json instead of calling this function directly.\n *\n * Examples (best-effort, may be wrong for paths with spaces/dots):\n *   `-Users-alice-dev-apps-MyProject` → `/Users/alice/dev/apps/MyProject`\n *   `-Users-alice--ssh`               → `/Users/alice/-ssh` ← WRONG (actually .ssh)\n *\n * @param encoded   The Claude-encoded directory name.\n * @param lookupMap Optional authoritative map from {@link buildEncodedDirMap}.\n *                  If provided and the key is found, that value is returned\n *                  instead of the heuristic result.\n */\nexport function decodeEncodedDir(\n  encoded: string,\n  lookupMap?: Map<string, string>\n): string {\n  // Authoritative lookup wins — but only if the path actually exists on disk.\n  // session-registry.json may contain stale or incorrectly decoded paths.\n  if (lookupMap?.has(encoded)) {\n    const mapped = lookupMap.get(encoded)!;\n    if (existsSync(mapped)) return mapped;\n  }\n\n  // Filesystem-walking decode (handles spaces, dots, hyphens correctly)\n  const smart = smartDecodeDir(encoded);\n  if (smart) return smart;\n\n  // Fall back to lookup map even if path doesn't exist (for display purposes)\n  if (lookupMap?.has(encoded)) {\n    return lookupMap.get(encoded)!;\n  }\n\n  // Last resort: every `-` maps to `/` (wrong for paths with spaces/dots/hyphens)\n  if (encoded.startsWith(\"-\")) {\n    return encoded.replace(/-/g, \"/\");\n  }\n\n  // Not a Claude-encoded path — return as-is\n  return encoded;\n}\n\n// ---------------------------------------------------------------------------\n// Slug generation\n// ---------------------------------------------------------------------------\n\n/**\n * Derive a URL-safe kebab-case slug from an arbitrary string.\n *\n * Uses the last path component so that `/Users/alice/dev/my-app` → `my-app`.\n */\nexport function slugify(value: string): string {\n  // Take last path segment if it looks like a path\n  const segment = value.includes(\"/\")\n    ? value.replace(/\\/$/, \"\").split(\"/\").pop() ?? value\n    : value;\n\n  return segment\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, \"-\") // non-alphanumeric runs → single dash\n    .replace(/^-+|-+$/g, \"\");    // trim leading/trailing dashes\n}\n\n// ---------------------------------------------------------------------------\n// Session note parsing\n// ---------------------------------------------------------------------------\n\ninterface ParsedSession {\n  number: number;\n  date: string;\n  slug: string;\n  title: string;\n  filename: string;\n}\n\n/** Match `0027 - 2026-01-04 - Some Description.md` */\nconst MODERN_RE = /^(\\d{4})\\s+-\\s+(\\d{4}-\\d{2}-\\d{2})\\s+-\\s+(.+)\\.md$/i;\n\n/** Match `0027_2026-01-04_some_description.md` */\nconst LEGACY_RE = /^(\\d{4})_(\\d{4}-\\d{2}-\\d{2})_(.+)\\.md$/i;\n\n/**\n * Attempt to parse a session note filename into its structured parts.\n *\n * Returns `null` if the filename does not match either known format.\n */\nexport function parseSessionFilename(\n  filename: string\n): ParsedSession | null {\n  let m = MODERN_RE.exec(filename);\n  if (m) {\n    const [, num, date, description] = m;\n    return {\n      number: parseInt(num, 10),\n      date,\n      slug: slugify(description),\n      title: description.trim(),\n      filename,\n    };\n  }\n\n  m = LEGACY_RE.exec(filename);\n  if (m) {\n    const [, num, date, rawDesc] = m;\n    const description = rawDesc.replace(/_/g, \" \");\n    return {\n      number: parseInt(num, 10),\n      date,\n      slug: slugify(description),\n      title: description.trim(),\n      filename,\n    };\n  }\n\n  return null;\n}\n\n// ---------------------------------------------------------------------------\n// Migration\n// ---------------------------------------------------------------------------\n\nexport interface MigrationResult {\n  projectsInserted: number;\n  projectsSkipped: number;\n  sessionsInserted: number;\n  errors: string[];\n}\n\n/**\n * Migrate the existing JSON session-registry into the SQLite registry.\n *\n * @param db            Open better-sqlite3 Database (target).\n * @param registryPath  Path to session-registry.json.\n *                      Defaults to ~/.claude/session-registry.json.\n *\n * The migration is idempotent: projects and sessions that already exist\n * (matched by slug / project_id+number) are silently skipped.\n */\nexport function migrateFromJson(\n  db: Database,\n  registryPath: string = join(homedir(), \".claude\", \"session-registry.json\")\n): MigrationResult {\n  const result: MigrationResult = {\n    projectsInserted: 0,\n    projectsSkipped: 0,\n    sessionsInserted: 0,\n    errors: [],\n  };\n\n  // ── Load source file ──────────────────────────────────────────────────────\n  if (!existsSync(registryPath)) {\n    result.errors.push(`Registry file not found: ${registryPath}`);\n    return result;\n  }\n\n  let registry: SessionRegistry;\n  try {\n    const raw = readFileSync(registryPath, \"utf8\");\n    registry = JSON.parse(raw) as SessionRegistry;\n  } catch (err) {\n    result.errors.push(`Failed to parse registry JSON: ${String(err)}`);\n    return result;\n  }\n\n  // ── Prepared statements ───────────────────────────────────────────────────\n  const insertProject = db.prepare(`\n    INSERT OR IGNORE INTO projects\n      (slug, display_name, root_path, encoded_dir, type, status,\n       created_at, updated_at)\n    VALUES\n      (@slug, @display_name, @root_path, @encoded_dir, 'local', 'active',\n       @created_at, @updated_at)\n  `);\n\n  const getProject = db.prepare(\n    \"SELECT id FROM projects WHERE slug = ?\"\n  );\n\n  const insertSession = db.prepare(`\n    INSERT OR IGNORE INTO sessions\n      (project_id, number, date, slug, title, filename, status, created_at)\n    VALUES\n      (@project_id, @number, @date, @slug, @title, @filename, 'completed',\n       @created_at)\n  `);\n\n  const now = Date.now();\n\n  // ── Build authoritative encoded-dir → path lookup ─────────────────────────\n  const lookupMap = buildEncodedDirMap(registryPath);\n\n  // ── Process each encoded directory entry ──────────────────────────────────\n  for (const [encodedDir, entry] of Object.entries(registry)) {\n    const rootPath = decodeEncodedDir(encodedDir, lookupMap);\n    const baseSlug = slugify(rootPath);\n\n    // --- Upsert project ---\n    let slug = baseSlug;\n    let attempt = 0;\n    while (true) {\n      const info = insertProject.run({\n        slug,\n        display_name:\n          (entry.displayName as string | undefined) ??\n          (rootPath.split(\"/\").pop() ?? rootPath),\n        root_path: rootPath,\n        encoded_dir: encodedDir,\n        created_at: now,\n        updated_at: now,\n      });\n\n      if (info.changes > 0) {\n        result.projectsInserted++;\n        break;\n      }\n\n      // Row existed — check if it's ours (matching root_path) or a collision\n      const existing = db\n        .prepare(\"SELECT id FROM projects WHERE root_path = ?\")\n        .get(rootPath);\n      if (existing) {\n        result.projectsSkipped++;\n        break;\n      }\n\n      // Genuine slug collision — append numeric suffix and retry\n      attempt++;\n      slug = `${baseSlug}-${attempt}`;\n    }\n\n    const projectRow = getProject.get(slug) as { id: number } | undefined;\n    // Also check by root_path in case slug was different\n    const projectById = projectRow ??\n      (db\n        .prepare(\"SELECT id FROM projects WHERE root_path = ?\")\n        .get(rootPath) as { id: number } | undefined);\n\n    if (!projectById) {\n      result.errors.push(\n        `Could not resolve project id for encoded dir: ${encodedDir}`\n      );\n      continue;\n    }\n\n    const projectId = projectById.id;\n\n    // --- Scan Notes/ directory for session notes ---\n    const notesDir =\n      typeof entry.notesDir === \"string\"\n        ? entry.notesDir\n        : join(rootPath, \"Notes\");\n\n    if (!existsSync(notesDir)) {\n      // No notes directory — that is fine, project still gets created\n      continue;\n    }\n\n    let files: string[];\n    try {\n      files = readdirSync(notesDir);\n    } catch (err) {\n      result.errors.push(\n        `Cannot read notes dir ${notesDir}: ${String(err)}`\n      );\n      continue;\n    }\n\n    for (const filename of files) {\n      if (!filename.endsWith(\".md\")) continue;\n\n      const parsed = parseSessionFilename(filename);\n      if (!parsed) continue;\n\n      try {\n        const info = insertSession.run({\n          project_id: projectId,\n          number: parsed.number,\n          date: parsed.date,\n          slug: parsed.slug,\n          title: parsed.title,\n          filename: parsed.filename,\n          created_at: now,\n        });\n        if (info.changes > 0) result.sessionsInserted++;\n      } catch (err) {\n        result.errors.push(\n          `Failed to insert session ${filename}: ${String(err)}`\n        );\n      }\n    }\n  }\n\n  return result;\n}\n"],"mappings":"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"}

package/dist/{pai-marker-DX_mFLum.mjs → pai-marker-CXQPX2P6.mjs}

@@ -183,4 +183,4 @@ function discoverPaiMarkers(searchDirs) {
 
 //#endregion
 export { ensurePaiMarker as n, readPaiMarker as r, discoverPaiMarkers as t };
-//# sourceMappingURL=pai-marker-DX_mFLum.mjs.map
+//# sourceMappingURL=pai-marker-CXQPX2P6.mjs.map

package/dist/{pai-marker-DX_mFLum.mjs.map → pai-marker-CXQPX2P6.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"pai-marker-DX_mFLum.mjs","names":[],"sources":["../src/registry/pai-marker.ts"],"sourcesContent":["/**\n * PAI.md marker file management.\n *\n * Each registered project gets a `Notes/PAI.md` file with a YAML frontmatter\n * `pai:` block that PAI manages.  The rest of the file (body content, other\n * frontmatter keys) is user-owned and never modified by PAI.\n *\n * YAML parsing/updating is done with simple regex — no external dependency.\n */\n\nimport {\n  existsSync,\n  readFileSync,\n  writeFileSync,\n  mkdirSync,\n  readdirSync,\n  statSync,\n} from \"node:fs\";\nimport { join } from \"node:path\";\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\nexport interface PaiMarker {\n  /** Absolute path to the PAI.md file */\n  path: string;\n  /** The `slug` value from the `pai:` frontmatter block */\n  slug: string;\n  /** Absolute path to the project root (parent of Notes/) */\n  projectRoot: string;\n}\n\n// ---------------------------------------------------------------------------\n// Template content (mirrors templates/pai-project.template.md)\n// ---------------------------------------------------------------------------\n\nconst TEMPLATE = `---\npai:\n  slug: \"\\${SLUG}\"\n  registered: \"\\${DATE}\"\n  last_indexed: null\n  status: active\n---\n\n# \\${DISPLAY_NAME}\n\n<!-- Everything below the YAML frontmatter is yours — PAI never modifies content here. -->\n<!-- Use this file for project notes, decisions, preferences, or anything you want. -->\n<!-- PAI only reads and updates the \\`pai:\\` block in the frontmatter above. -->\n`;\n\nfunction isoDate(): string {\n  return new Date().toISOString().slice(0, 10);\n}\n\nfunction renderTemplate(slug: string, displayName: string): string {\n  return TEMPLATE.replace(/\\$\\{SLUG\\}/g, slug)\n    .replace(/\\$\\{DATE\\}/g, isoDate())\n    .replace(/\\$\\{DISPLAY_NAME\\}/g, displayName);\n}\n\n// ---------------------------------------------------------------------------\n// YAML frontmatter helpers (regex-based, no external dependency)\n// ---------------------------------------------------------------------------\n\n/**\n * Split a markdown file with YAML frontmatter into its parts.\n *\n * Returns { frontmatter, body } where:\n *   frontmatter  — content between the opening and closing `---` delimiters\n *   body         — everything after the closing `---` line\n *\n * Returns null if the file does not begin with a `---` frontmatter block.\n */\nfunction parseFrontmatter(\n  content: string\n): { frontmatter: string; body: string } | null {\n  if (!content.startsWith(\"---\")) return null;\n\n  // Skip past the opening \"---\" and its line ending\n  const afterOpen = content.slice(3);\n  const eolMatch = afterOpen.match(/^\\r?\\n/);\n  if (!eolMatch) return null;\n\n  const rest = afterOpen.slice(eolMatch[0].length);\n\n  // Find closing \"---\" on its own line\n  const closeMatch = rest.match(/^([\\s\\S]*?)\\n---[ \\t]*(\\r?\\n|$)/m);\n  if (!closeMatch) return null;\n\n  const frontmatter = closeMatch[1];\n  const body = rest.slice(closeMatch[0].length);\n\n  return { frontmatter, body };\n}\n\n/**\n * Extract a simple scalar YAML value from a block of YAML text.\n *\n *   extractYamlValue('  slug: \"my-proj\"', \"slug\")  →  \"my-proj\"\n *   extractYamlValue('  slug: my-proj', \"slug\")     →  \"my-proj\"\n *   extractYamlValue('  last_indexed: null', \"last_indexed\")  →  \"null\"\n */\nfunction extractYamlValue(yamlBlock: string, key: string): string | null {\n  const re = new RegExp(\n    `^[ \\\\t]*${key}[ \\\\t]*:[ \\\\t]*\"?([^\"\\\\n\\\\r]*?)\"?[ \\\\t]*$`,\n    \"m\"\n  );\n  const match = yamlBlock.match(re);\n  if (!match) return null;\n  return match[1].trim() || null;\n}\n\n/**\n * Replace the `pai:` mapping block inside a frontmatter string with\n * `newPaiBlock`.  If no `pai:` block is found, appends it at the end.\n *\n * The regex captures the `pai:` key and all immediately-following indented\n * lines (the mapping values), then replaces the whole group.\n *\n * Edge case: the last indented line may not have a trailing newline when it\n * is the final line of the frontmatter string.  We handle this by matching\n * lines that end with \\n OR with end-of-string.\n */\nfunction replacePaiBlock(frontmatter: string, newPaiBlock: string): string {\n  // Normalise: ensure the frontmatter string ends with \\n so the regex\n  // always finds a clean boundary after the last indented line.\n  const fm = frontmatter.endsWith(\"\\n\") ? frontmatter : frontmatter + \"\\n\";\n\n  // Match \"pai:\\n\" followed by any number of indented lines (each ending \\n).\n  const paiRe = /^pai:[ \\t]*\\r?\\n(?:[ \\t]+[^\\r\\n]*\\r?\\n)*/m;\n  if (paiRe.test(fm)) {\n    // Replace and strip the extra trailing \\n we may have added.\n    const replaced = fm.replace(paiRe, newPaiBlock);\n    return frontmatter.endsWith(\"\\n\") ? replaced : replaced.replace(/\\n$/, \"\");\n  }\n  // pai: key not found — append it\n  return fm + newPaiBlock;\n}\n\n/**\n * Build the canonical `pai:` YAML block (with a trailing newline).\n */\nfunction buildPaiBlock(\n  slug: string,\n  registered: string,\n  lastIndexed: string | null,\n  status: string\n): string {\n  const lastIndexedStr =\n    lastIndexed === null ? \"null\" : `\"${lastIndexed}\"`;\n  return (\n    `pai:\\n` +\n    `  slug: \"${slug}\"\\n` +\n    `  registered: \"${registered}\"\\n` +\n    `  last_indexed: ${lastIndexedStr}\\n` +\n    `  status: ${status}\\n`\n  );\n}\n\n// ---------------------------------------------------------------------------\n// Public API\n// ---------------------------------------------------------------------------\n\n/**\n * Create or update `<projectRoot>/Notes/PAI.md`.\n *\n * - File absent: creates `Notes/` if needed, writes from template.\n * - File present: updates only the `pai:` frontmatter block; body and all\n *   other frontmatter keys are preserved verbatim.\n *\n * @param projectRoot  Absolute path to the project root directory.\n * @param slug         PAI slug for this project.\n * @param displayName  Human-readable name (defaults to slug if omitted).\n */\nexport function ensurePaiMarker(\n  projectRoot: string,\n  slug: string,\n  displayName?: string\n): void {\n  const notesDir = join(projectRoot, \"Notes\");\n  const markerPath = join(notesDir, \"PAI.md\");\n  const name = displayName ?? slug;\n\n  // --- File does not exist — create from template ---\n  if (!existsSync(markerPath)) {\n    mkdirSync(notesDir, { recursive: true });\n    writeFileSync(markerPath, renderTemplate(slug, name), \"utf8\");\n    return;\n  }\n\n  // --- File exists — update only the `pai:` block ---\n  const raw = readFileSync(markerPath, \"utf8\");\n  const parsed = parseFrontmatter(raw);\n\n  if (!parsed) {\n    // No YAML frontmatter — prepend a fresh one, treat the whole file as body.\n    const paiBlock = buildPaiBlock(slug, isoDate(), null, \"active\");\n    const newContent = `---\\n${paiBlock}---\\n\\n${raw}`;\n    writeFileSync(markerPath, newContent, \"utf8\");\n    return;\n  }\n\n  const { frontmatter, body } = parsed;\n\n  // Preserve existing `registered` date so we don't reset it on re-scan.\n  const existingRegistered =\n    extractYamlValue(frontmatter, \"registered\") ?? isoDate();\n\n  // Preserve existing `last_indexed` value (may be \"null\" string or a date).\n  const rawLastIndexed = extractYamlValue(frontmatter, \"last_indexed\");\n  const lastIndexed =\n    rawLastIndexed === null || rawLastIndexed === \"null\"\n      ? null\n      : rawLastIndexed;\n\n  // Preserve existing `status`.\n  const existingStatus = extractYamlValue(frontmatter, \"status\") ?? \"active\";\n\n  const newPaiBlock = buildPaiBlock(\n    slug,\n    existingRegistered,\n    lastIndexed,\n    existingStatus\n  );\n\n  const newFrontmatter = replacePaiBlock(frontmatter, newPaiBlock);\n\n  // Ensure the frontmatter block ends with exactly one newline before the\n  // closing --- delimiter.\n  const fmWithNewline = newFrontmatter.endsWith(\"\\n\")\n    ? newFrontmatter\n    : newFrontmatter + \"\\n\";\n\n  // Reconstruct the full file.  Preserve whatever separator the body has.\n  const newContent = `---\\n${fmWithNewline}---\\n${body}`;\n  writeFileSync(markerPath, newContent, \"utf8\");\n}\n\n/**\n * Read PAI marker data from `<projectRoot>/Notes/PAI.md`.\n * Returns null if the file does not exist or contains no `pai:` block.\n */\nexport function readPaiMarker(\n  projectRoot: string\n): { slug: string; registered: string; status: string } | null {\n  const markerPath = join(projectRoot, \"Notes\", \"PAI.md\");\n  if (!existsSync(markerPath)) return null;\n\n  const raw = readFileSync(markerPath, \"utf8\");\n  const parsed = parseFrontmatter(raw);\n  if (!parsed) return null;\n\n  const slug = extractYamlValue(parsed.frontmatter, \"slug\");\n  if (!slug) return null;\n\n  const registered =\n    extractYamlValue(parsed.frontmatter, \"registered\") ?? \"\";\n  const status =\n    extractYamlValue(parsed.frontmatter, \"status\") ?? \"active\";\n\n  return { slug, registered, status };\n}\n\n/**\n * Scan a list of parent directories for `<child>/Notes/PAI.md` marker files.\n * Each directory in `searchDirs` is scanned one level deep — its immediate\n * child directories are checked for a `Notes/PAI.md` file.\n *\n * Returns an array of PaiMarker objects for every valid marker found.\n * Invalid or malformed markers are silently skipped.\n *\n * @param searchDirs  Absolute paths to parent directories.\n */\nexport function discoverPaiMarkers(searchDirs: string[]): PaiMarker[] {\n  const results: PaiMarker[] = [];\n\n  for (const dir of searchDirs) {\n    if (!existsSync(dir)) continue;\n\n    let children: string[];\n    try {\n      children = readdirSync(dir);\n    } catch {\n      continue;\n    }\n\n    for (const child of children) {\n      if (child.startsWith(\".\")) continue;\n      const childPath = join(dir, child);\n      try {\n        if (!statSync(childPath).isDirectory()) continue;\n      } catch {\n        continue;\n      }\n\n      const markerData = readPaiMarker(childPath);\n      if (!markerData) continue;\n\n      results.push({\n        path: join(childPath, \"Notes\", \"PAI.md\"),\n        slug: markerData.slug,\n        projectRoot: childPath,\n      });\n    }\n  }\n\n  return results;\n}\n"],"mappings":"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"}
+{"version":3,"file":"pai-marker-CXQPX2P6.mjs","names":[],"sources":["../src/registry/pai-marker.ts"],"sourcesContent":["/**\n * PAI.md marker file management.\n *\n * Each registered project gets a `Notes/PAI.md` file with a YAML frontmatter\n * `pai:` block that PAI manages.  The rest of the file (body content, other\n * frontmatter keys) is user-owned and never modified by PAI.\n *\n * YAML parsing/updating is done with simple regex — no external dependency.\n */\n\nimport {\n  existsSync,\n  readFileSync,\n  writeFileSync,\n  mkdirSync,\n  readdirSync,\n  statSync,\n} from \"node:fs\";\nimport { join } from \"node:path\";\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\nexport interface PaiMarker {\n  /** Absolute path to the PAI.md file */\n  path: string;\n  /** The `slug` value from the `pai:` frontmatter block */\n  slug: string;\n  /** Absolute path to the project root (parent of Notes/) */\n  projectRoot: string;\n}\n\n// ---------------------------------------------------------------------------\n// Template content (mirrors templates/pai-project.template.md)\n// ---------------------------------------------------------------------------\n\nconst TEMPLATE = `---\npai:\n  slug: \"\\${SLUG}\"\n  registered: \"\\${DATE}\"\n  last_indexed: null\n  status: active\n---\n\n# \\${DISPLAY_NAME}\n\n<!-- Everything below the YAML frontmatter is yours — PAI never modifies content here. -->\n<!-- Use this file for project notes, decisions, preferences, or anything you want. -->\n<!-- PAI only reads and updates the \\`pai:\\` block in the frontmatter above. -->\n`;\n\nfunction isoDate(): string {\n  return new Date().toISOString().slice(0, 10);\n}\n\nfunction renderTemplate(slug: string, displayName: string): string {\n  return TEMPLATE.replace(/\\$\\{SLUG\\}/g, slug)\n    .replace(/\\$\\{DATE\\}/g, isoDate())\n    .replace(/\\$\\{DISPLAY_NAME\\}/g, displayName);\n}\n\n// ---------------------------------------------------------------------------\n// YAML frontmatter helpers (regex-based, no external dependency)\n// ---------------------------------------------------------------------------\n\n/**\n * Split a markdown file with YAML frontmatter into its parts.\n *\n * Returns { frontmatter, body } where:\n *   frontmatter  — content between the opening and closing `---` delimiters\n *   body         — everything after the closing `---` line\n *\n * Returns null if the file does not begin with a `---` frontmatter block.\n */\nfunction parseFrontmatter(\n  content: string\n): { frontmatter: string; body: string } | null {\n  if (!content.startsWith(\"---\")) return null;\n\n  // Skip past the opening \"---\" and its line ending\n  const afterOpen = content.slice(3);\n  const eolMatch = afterOpen.match(/^\\r?\\n/);\n  if (!eolMatch) return null;\n\n  const rest = afterOpen.slice(eolMatch[0].length);\n\n  // Find closing \"---\" on its own line\n  const closeMatch = rest.match(/^([\\s\\S]*?)\\n---[ \\t]*(\\r?\\n|$)/m);\n  if (!closeMatch) return null;\n\n  const frontmatter = closeMatch[1];\n  const body = rest.slice(closeMatch[0].length);\n\n  return { frontmatter, body };\n}\n\n/**\n * Extract a simple scalar YAML value from a block of YAML text.\n *\n *   extractYamlValue('  slug: \"my-proj\"', \"slug\")  →  \"my-proj\"\n *   extractYamlValue('  slug: my-proj', \"slug\")     →  \"my-proj\"\n *   extractYamlValue('  last_indexed: null', \"last_indexed\")  →  \"null\"\n */\nfunction extractYamlValue(yamlBlock: string, key: string): string | null {\n  const re = new RegExp(\n    `^[ \\\\t]*${key}[ \\\\t]*:[ \\\\t]*\"?([^\"\\\\n\\\\r]*?)\"?[ \\\\t]*$`,\n    \"m\"\n  );\n  const match = yamlBlock.match(re);\n  if (!match) return null;\n  return match[1].trim() || null;\n}\n\n/**\n * Replace the `pai:` mapping block inside a frontmatter string with\n * `newPaiBlock`.  If no `pai:` block is found, appends it at the end.\n *\n * The regex captures the `pai:` key and all immediately-following indented\n * lines (the mapping values), then replaces the whole group.\n *\n * Edge case: the last indented line may not have a trailing newline when it\n * is the final line of the frontmatter string.  We handle this by matching\n * lines that end with \\n OR with end-of-string.\n */\nfunction replacePaiBlock(frontmatter: string, newPaiBlock: string): string {\n  // Normalise: ensure the frontmatter string ends with \\n so the regex\n  // always finds a clean boundary after the last indented line.\n  const fm = frontmatter.endsWith(\"\\n\") ? frontmatter : frontmatter + \"\\n\";\n\n  // Match \"pai:\\n\" followed by any number of indented lines (each ending \\n).\n  const paiRe = /^pai:[ \\t]*\\r?\\n(?:[ \\t]+[^\\r\\n]*\\r?\\n)*/m;\n  if (paiRe.test(fm)) {\n    // Replace and strip the extra trailing \\n we may have added.\n    const replaced = fm.replace(paiRe, newPaiBlock);\n    return frontmatter.endsWith(\"\\n\") ? replaced : replaced.replace(/\\n$/, \"\");\n  }\n  // pai: key not found — append it\n  return fm + newPaiBlock;\n}\n\n/**\n * Build the canonical `pai:` YAML block (with a trailing newline).\n */\nfunction buildPaiBlock(\n  slug: string,\n  registered: string,\n  lastIndexed: string | null,\n  status: string\n): string {\n  const lastIndexedStr =\n    lastIndexed === null ? \"null\" : `\"${lastIndexed}\"`;\n  return (\n    `pai:\\n` +\n    `  slug: \"${slug}\"\\n` +\n    `  registered: \"${registered}\"\\n` +\n    `  last_indexed: ${lastIndexedStr}\\n` +\n    `  status: ${status}\\n`\n  );\n}\n\n// ---------------------------------------------------------------------------\n// Public API\n// ---------------------------------------------------------------------------\n\n/**\n * Create or update `<projectRoot>/Notes/PAI.md`.\n *\n * - File absent: creates `Notes/` if needed, writes from template.\n * - File present: updates only the `pai:` frontmatter block; body and all\n *   other frontmatter keys are preserved verbatim.\n *\n * @param projectRoot  Absolute path to the project root directory.\n * @param slug         PAI slug for this project.\n * @param displayName  Human-readable name (defaults to slug if omitted).\n */\nexport function ensurePaiMarker(\n  projectRoot: string,\n  slug: string,\n  displayName?: string\n): void {\n  const notesDir = join(projectRoot, \"Notes\");\n  const markerPath = join(notesDir, \"PAI.md\");\n  const name = displayName ?? slug;\n\n  // --- File does not exist — create from template ---\n  if (!existsSync(markerPath)) {\n    mkdirSync(notesDir, { recursive: true });\n    writeFileSync(markerPath, renderTemplate(slug, name), \"utf8\");\n    return;\n  }\n\n  // --- File exists — update only the `pai:` block ---\n  const raw = readFileSync(markerPath, \"utf8\");\n  const parsed = parseFrontmatter(raw);\n\n  if (!parsed) {\n    // No YAML frontmatter — prepend a fresh one, treat the whole file as body.\n    const paiBlock = buildPaiBlock(slug, isoDate(), null, \"active\");\n    const newContent = `---\\n${paiBlock}---\\n\\n${raw}`;\n    writeFileSync(markerPath, newContent, \"utf8\");\n    return;\n  }\n\n  const { frontmatter, body } = parsed;\n\n  // Preserve existing `registered` date so we don't reset it on re-scan.\n  const existingRegistered =\n    extractYamlValue(frontmatter, \"registered\") ?? isoDate();\n\n  // Preserve existing `last_indexed` value (may be \"null\" string or a date).\n  const rawLastIndexed = extractYamlValue(frontmatter, \"last_indexed\");\n  const lastIndexed =\n    rawLastIndexed === null || rawLastIndexed === \"null\"\n      ? null\n      : rawLastIndexed;\n\n  // Preserve existing `status`.\n  const existingStatus = extractYamlValue(frontmatter, \"status\") ?? \"active\";\n\n  const newPaiBlock = buildPaiBlock(\n    slug,\n    existingRegistered,\n    lastIndexed,\n    existingStatus\n  );\n\n  const newFrontmatter = replacePaiBlock(frontmatter, newPaiBlock);\n\n  // Ensure the frontmatter block ends with exactly one newline before the\n  // closing --- delimiter.\n  const fmWithNewline = newFrontmatter.endsWith(\"\\n\")\n    ? newFrontmatter\n    : newFrontmatter + \"\\n\";\n\n  // Reconstruct the full file.  Preserve whatever separator the body has.\n  const newContent = `---\\n${fmWithNewline}---\\n${body}`;\n  writeFileSync(markerPath, newContent, \"utf8\");\n}\n\n/**\n * Read PAI marker data from `<projectRoot>/Notes/PAI.md`.\n * Returns null if the file does not exist or contains no `pai:` block.\n */\nexport function readPaiMarker(\n  projectRoot: string\n): { slug: string; registered: string; status: string } | null {\n  const markerPath = join(projectRoot, \"Notes\", \"PAI.md\");\n  if (!existsSync(markerPath)) return null;\n\n  const raw = readFileSync(markerPath, \"utf8\");\n  const parsed = parseFrontmatter(raw);\n  if (!parsed) return null;\n\n  const slug = extractYamlValue(parsed.frontmatter, \"slug\");\n  if (!slug) return null;\n\n  const registered =\n    extractYamlValue(parsed.frontmatter, \"registered\") ?? \"\";\n  const status =\n    extractYamlValue(parsed.frontmatter, \"status\") ?? \"active\";\n\n  return { slug, registered, status };\n}\n\n/**\n * Scan a list of parent directories for `<child>/Notes/PAI.md` marker files.\n * Each directory in `searchDirs` is scanned one level deep — its immediate\n * child directories are checked for a `Notes/PAI.md` file.\n *\n * Returns an array of PaiMarker objects for every valid marker found.\n * Invalid or malformed markers are silently skipped.\n *\n * @param searchDirs  Absolute paths to parent directories.\n */\nexport function discoverPaiMarkers(searchDirs: string[]): PaiMarker[] {\n  const results: PaiMarker[] = [];\n\n  for (const dir of searchDirs) {\n    if (!existsSync(dir)) continue;\n\n    let children: string[];\n    try {\n      children = readdirSync(dir);\n    } catch {\n      continue;\n    }\n\n    for (const child of children) {\n      if (child.startsWith(\".\")) continue;\n      const childPath = join(dir, child);\n      try {\n        if (!statSync(childPath).isDirectory()) continue;\n      } catch {\n        continue;\n      }\n\n      const markerData = readPaiMarker(childPath);\n      if (!markerData) continue;\n\n      results.push({\n        path: join(childPath, \"Notes\", \"PAI.md\"),\n        slug: markerData.slug,\n        projectRoot: childPath,\n      });\n    }\n  }\n\n  return results;\n}\n"],"mappings":";;;;;;;;;;;;;AAqCA,MAAM,WAAW;;;;;;;;;;;;;;AAejB,SAAS,UAAkB;AACzB,yBAAO,IAAI,MAAM,EAAC,aAAa,CAAC,MAAM,GAAG,GAAG;;AAG9C,SAAS,eAAe,MAAc,aAA6B;AACjE,QAAO,SAAS,QAAQ,eAAe,KAAK,CACzC,QAAQ,eAAe,SAAS,CAAC,CACjC,QAAQ,uBAAuB,YAAY;;;;;;;;;;;AAgBhD,SAAS,iBACP,SAC8C;AAC9C,KAAI,CAAC,QAAQ,WAAW,MAAM,CAAE,QAAO;CAGvC,MAAM,YAAY,QAAQ,MAAM,EAAE;CAClC,MAAM,WAAW,UAAU,MAAM,SAAS;AAC1C,KAAI,CAAC,SAAU,QAAO;CAEtB,MAAM,OAAO,UAAU,MAAM,SAAS,GAAG,OAAO;CAGhD,MAAM,aAAa,KAAK,MAAM,mCAAmC;AACjE,KAAI,CAAC,WAAY,QAAO;AAKxB,QAAO;EAAE,aAHW,WAAW;EAGT,MAFT,KAAK,MAAM,WAAW,GAAG,OAAO;EAEjB;;;;;;;;;AAU9B,SAAS,iBAAiB,WAAmB,KAA4B;CACvE,MAAM,KAAK,IAAI,OACb,WAAW,IAAI,4CACf,IACD;CACD,MAAM,QAAQ,UAAU,MAAM,GAAG;AACjC,KAAI,CAAC,MAAO,QAAO;AACnB,QAAO,MAAM,GAAG,MAAM,IAAI;;;;;;;;;;;;;AAc5B,SAAS,gBAAgB,aAAqB,aAA6B;CAGzE,MAAM,KAAK,YAAY,SAAS,KAAK,GAAG,cAAc,cAAc;CAGpE,MAAM,QAAQ;AACd,KAAI,MAAM,KAAK,GAAG,EAAE;EAElB,MAAM,WAAW,GAAG,QAAQ,OAAO,YAAY;AAC/C,SAAO,YAAY,SAAS,KAAK,GAAG,WAAW,SAAS,QAAQ,OAAO,GAAG;;AAG5E,QAAO,KAAK;;;;;AAMd,SAAS,cACP,MACA,YACA,aACA,QACQ;AAGR,QACE,kBACY,KAAK,oBACC,WAAW,qBAJ7B,gBAAgB,OAAO,SAAS,IAAI,YAAY,GAKd,cACrB,OAAO;;;;;;;;;;;;;AAmBxB,SAAgB,gBACd,aACA,MACA,aACM;CACN,MAAM,WAAW,KAAK,aAAa,QAAQ;CAC3C,MAAM,aAAa,KAAK,UAAU,SAAS;CAC3C,MAAM,OAAO,eAAe;AAG5B,KAAI,CAAC,WAAW,WAAW,EAAE;AAC3B,YAAU,UAAU,EAAE,WAAW,MAAM,CAAC;AACxC,gBAAc,YAAY,eAAe,MAAM,KAAK,EAAE,OAAO;AAC7D;;CAIF,MAAM,MAAM,aAAa,YAAY,OAAO;CAC5C,MAAM,SAAS,iBAAiB,IAAI;AAEpC,KAAI,CAAC,QAAQ;AAIX,gBAAc,YADK,QADF,cAAc,MAAM,SAAS,EAAE,MAAM,SAAS,CAC3B,SAAS,OACP,OAAO;AAC7C;;CAGF,MAAM,EAAE,aAAa,SAAS;CAG9B,MAAM,qBACJ,iBAAiB,aAAa,aAAa,IAAI,SAAS;CAG1D,MAAM,iBAAiB,iBAAiB,aAAa,eAAe;CAgBpE,MAAM,iBAAiB,gBAAgB,aAPnB,cAClB,MACA,oBATA,mBAAmB,QAAQ,mBAAmB,SAC1C,OACA,gBAGiB,iBAAiB,aAAa,SAAS,IAAI,SAOjE,CAE+D;AAUhE,eAAc,YADK,QALG,eAAe,SAAS,KAAK,GAC/C,iBACA,iBAAiB,KAGoB,OAAO,QACV,OAAO;;;;;;AAO/C,SAAgB,cACd,aAC6D;CAC7D,MAAM,aAAa,KAAK,aAAa,SAAS,SAAS;AACvD,KAAI,CAAC,WAAW,WAAW,CAAE,QAAO;CAGpC,MAAM,SAAS,iBADH,aAAa,YAAY,OAAO,CACR;AACpC,KAAI,CAAC,OAAQ,QAAO;CAEpB,MAAM,OAAO,iBAAiB,OAAO,aAAa,OAAO;AACzD,KAAI,CAAC,KAAM,QAAO;AAOlB,QAAO;EAAE;EAAM,YAJb,iBAAiB,OAAO,aAAa,aAAa,IAAI;EAI7B,QAFzB,iBAAiB,OAAO,aAAa,SAAS,IAAI;EAEjB;;;;;;;;;;;;AAarC,SAAgB,mBAAmB,YAAmC;CACpE,MAAM,UAAuB,EAAE;AAE/B,MAAK,MAAM,OAAO,YAAY;AAC5B,MAAI,CAAC,WAAW,IAAI,CAAE;EAEtB,IAAI;AACJ,MAAI;AACF,cAAW,YAAY,IAAI;UACrB;AACN;;AAGF,OAAK,MAAM,SAAS,UAAU;AAC5B,OAAI,MAAM,WAAW,IAAI,CAAE;GAC3B,MAAM,YAAY,KAAK,KAAK,MAAM;AAClC,OAAI;AACF,QAAI,CAAC,SAAS,UAAU,CAAC,aAAa,CAAE;WAClC;AACN;;GAGF,MAAM,aAAa,cAAc,UAAU;AAC3C,OAAI,CAAC,WAAY;AAEjB,WAAQ,KAAK;IACX,MAAM,KAAK,WAAW,SAAS,SAAS;IACxC,MAAM,WAAW;IACjB,aAAa;IACd,CAAC;;;AAIN,QAAO"}

package/dist/{postgres-Ccvpc6fC.mjs → postgres-CRBe30Ag.mjs}

@@ -332,4 +332,4 @@ function buildPgTsQuery(query) {
 
 //#endregion
 export { PostgresBackend };
-//# sourceMappingURL=postgres-Ccvpc6fC.mjs.map
+//# sourceMappingURL=postgres-CRBe30Ag.mjs.map

package/dist/{postgres-Ccvpc6fC.mjs.map → postgres-CRBe30Ag.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"postgres-Ccvpc6fC.mjs","names":[],"sources":["../src/storage/postgres.ts"],"sourcesContent":["/**\n * PostgresBackend — implements StorageBackend using PostgreSQL + pgvector.\n *\n * Vector similarity: pgvector's <=> cosine distance operator\n * Full-text search:  PostgreSQL tsvector/tsquery (replaces SQLite FTS5)\n * Connection pooling: node-postgres Pool\n *\n * Schema is initialized via docker/init.sql.\n * This module only handles runtime queries — schema creation is external.\n */\n\nimport pg from \"pg\";\nimport type { Pool, PoolClient } from \"pg\";\nimport type { StorageBackend, ChunkRow, FileRow, FederationStats } from \"./interface.js\";\nimport type { SearchResult, SearchOptions } from \"../memory/search.js\";\nimport { buildFtsQuery } from \"../memory/search.js\";\n\nconst { Pool: PgPool } = pg;\n\n// ---------------------------------------------------------------------------\n// Postgres config\n// ---------------------------------------------------------------------------\n\nexport interface PostgresConfig {\n  connectionString?: string;\n  host?: string;\n  port?: number;\n  database?: string;\n  user?: string;\n  password?: string;\n  /** Maximum pool connections. Default 5 */\n  maxConnections?: number;\n  /** Connection timeout in ms. Default 5000 */\n  connectionTimeoutMs?: number;\n}\n\n// ---------------------------------------------------------------------------\n// Implementation\n// ---------------------------------------------------------------------------\n\nexport class PostgresBackend implements StorageBackend {\n  readonly backendType = \"postgres\" as const;\n\n  private pool: Pool;\n\n  constructor(config: PostgresConfig) {\n    const connStr =\n      config.connectionString ??\n      `postgresql://${config.user ?? \"pai\"}:${config.password ?? \"pai\"}@${config.host ?? \"localhost\"}:${config.port ?? 5432}/${config.database ?? \"pai\"}`;\n\n    this.pool = new PgPool({\n      connectionString: connStr,\n      max: config.maxConnections ?? 5,\n      connectionTimeoutMillis: config.connectionTimeoutMs ?? 5000,\n      idleTimeoutMillis: 30_000,\n    });\n\n    // Log pool errors so they don't crash the process silently\n    this.pool.on(\"error\", (err) => {\n      process.stderr.write(`[pai-postgres] Pool error: ${err.message}\\n`);\n    });\n  }\n\n  // -------------------------------------------------------------------------\n  // Lifecycle\n  // -------------------------------------------------------------------------\n\n  async close(): Promise<void> {\n    await this.pool.end();\n  }\n\n  async getStats(): Promise<FederationStats> {\n    const client = await this.pool.connect();\n    try {\n      const filesResult = await client.query<{ n: string }>(\n        \"SELECT COUNT(*)::text AS n FROM pai_files\"\n      );\n      const chunksResult = await client.query<{ n: string }>(\n        \"SELECT COUNT(*)::text AS n FROM pai_chunks\"\n      );\n      return {\n        files: parseInt(filesResult.rows[0]?.n ?? \"0\", 10),\n        chunks: parseInt(chunksResult.rows[0]?.n ?? \"0\", 10),\n      };\n    } finally {\n      client.release();\n    }\n  }\n\n  /**\n   * Test the connection by running a trivial query.\n   * Returns null on success, error message on failure.\n   */\n  async testConnection(): Promise<string | null> {\n    let client: PoolClient | null = null;\n    try {\n      client = await this.pool.connect();\n      await client.query(\"SELECT 1\");\n      return null;\n    } catch (e) {\n      return e instanceof Error ? e.message : String(e);\n    } finally {\n      client?.release();\n    }\n  }\n\n  // -------------------------------------------------------------------------\n  // File tracking\n  // -------------------------------------------------------------------------\n\n  async getFileHash(projectId: number, path: string): Promise<string | undefined> {\n    const result = await this.pool.query<{ hash: string }>(\n      \"SELECT hash FROM pai_files WHERE project_id = $1 AND path = $2\",\n      [projectId, path]\n    );\n    return result.rows[0]?.hash;\n  }\n\n  async upsertFile(file: FileRow): Promise<void> {\n    await this.pool.query(\n      `INSERT INTO pai_files (project_id, path, source, tier, hash, mtime, size)\n       VALUES ($1, $2, $3, $4, $5, $6, $7)\n       ON CONFLICT (project_id, path) DO UPDATE SET\n         source = EXCLUDED.source,\n         tier   = EXCLUDED.tier,\n         hash   = EXCLUDED.hash,\n         mtime  = EXCLUDED.mtime,\n         size   = EXCLUDED.size`,\n      [file.projectId, file.path, file.source, file.tier, file.hash, file.mtime, file.size]\n    );\n  }\n\n  // -------------------------------------------------------------------------\n  // Chunk management\n  // -------------------------------------------------------------------------\n\n  async getChunkIds(projectId: number, path: string): Promise<string[]> {\n    const result = await this.pool.query<{ id: string }>(\n      \"SELECT id FROM pai_chunks WHERE project_id = $1 AND path = $2\",\n      [projectId, path]\n    );\n    return result.rows.map((r) => r.id);\n  }\n\n  async deleteChunksForFile(projectId: number, path: string): Promise<void> {\n    // Foreign key CASCADE handles pai_chunks deletion automatically\n    // but we don't have FK to pai_chunks from pai_files, so delete explicitly\n    await this.pool.query(\n      \"DELETE FROM pai_chunks WHERE project_id = $1 AND path = $2\",\n      [projectId, path]\n    );\n  }\n\n  async insertChunks(chunks: ChunkRow[]): Promise<void> {\n    if (chunks.length === 0) return;\n\n    const client = await this.pool.connect();\n    try {\n      await client.query(\"BEGIN\");\n\n      for (const c of chunks) {\n        // embedding is null at insert time; updated separately via updateEmbedding()\n        await client.query(\n          `INSERT INTO pai_chunks\n             (id, project_id, source, tier, path, start_line, end_line, hash, text, updated_at, fts_vector)\n           VALUES\n             ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10,\n              to_tsvector('simple', $9))\n           ON CONFLICT (id) DO UPDATE SET\n             project_id = EXCLUDED.project_id,\n             source     = EXCLUDED.source,\n             tier       = EXCLUDED.tier,\n             path       = EXCLUDED.path,\n             start_line = EXCLUDED.start_line,\n             end_line   = EXCLUDED.end_line,\n             hash       = EXCLUDED.hash,\n             text       = EXCLUDED.text,\n             updated_at = EXCLUDED.updated_at,\n             fts_vector = EXCLUDED.fts_vector`,\n          [\n            c.id,\n            c.projectId,\n            c.source,\n            c.tier,\n            c.path,\n            c.startLine,\n            c.endLine,\n            c.hash,\n            c.text,\n            c.updatedAt,\n          ]\n        );\n      }\n\n      await client.query(\"COMMIT\");\n    } catch (e) {\n      await client.query(\"ROLLBACK\");\n      throw e;\n    } finally {\n      client.release();\n    }\n  }\n\n  async getUnembeddedChunkIds(projectId?: number): Promise<Array<{ id: string; text: string }>> {\n    if (projectId !== undefined) {\n      const result = await this.pool.query<{ id: string; text: string }>(\n        \"SELECT id, text FROM pai_chunks WHERE embedding IS NULL AND project_id = $1 ORDER BY id\",\n        [projectId]\n      );\n      return result.rows;\n    }\n    const result = await this.pool.query<{ id: string; text: string }>(\n      \"SELECT id, text FROM pai_chunks WHERE embedding IS NULL ORDER BY id\"\n    );\n    return result.rows;\n  }\n\n  async updateEmbedding(chunkId: string, embedding: Buffer): Promise<void> {\n    // Deserialize the Buffer (Float32Array LE bytes) to a number[] for pgvector\n    const vec = bufferToVector(embedding);\n    const vecStr = \"[\" + vec.join(\",\") + \"]\";\n    await this.pool.query(\n      \"UPDATE pai_chunks SET embedding = $1::vector WHERE id = $2\",\n      [vecStr, chunkId]\n    );\n  }\n\n  // -------------------------------------------------------------------------\n  // Search — keyword (tsvector/tsquery)\n  // -------------------------------------------------------------------------\n\n  async searchKeyword(query: string, opts?: SearchOptions): Promise<SearchResult[]> {\n    const maxResults = opts?.maxResults ?? 10;\n\n    // Build tsquery from the same token logic as buildFtsQuery, but for Postgres\n    const tsQuery = buildPgTsQuery(query);\n    if (!tsQuery) return [];\n\n    // Use 'simple' dictionary: preserves tokens as-is, no language-specific\n    // stemming. Works reliably with any language (German, French, etc.).\n    const conditions: string[] = [\"fts_vector @@ to_tsquery('simple', $1)\"];\n    const params: (string | number)[] = [tsQuery];\n    let paramIdx = 2;\n\n    if (opts?.projectIds && opts.projectIds.length > 0) {\n      const placeholders = opts.projectIds.map(() => `$${paramIdx++}`).join(\", \");\n      conditions.push(`project_id IN (${placeholders})`);\n      params.push(...opts.projectIds);\n    }\n\n    if (opts?.sources && opts.sources.length > 0) {\n      const placeholders = opts.sources.map(() => `$${paramIdx++}`).join(\", \");\n      conditions.push(`source IN (${placeholders})`);\n      params.push(...opts.sources);\n    }\n\n    if (opts?.tiers && opts.tiers.length > 0) {\n      const placeholders = opts.tiers.map(() => `$${paramIdx++}`).join(\", \");\n      conditions.push(`tier IN (${placeholders})`);\n      params.push(...opts.tiers);\n    }\n\n    params.push(maxResults);\n    const limitParam = `$${paramIdx}`;\n\n    const sql = `\n      SELECT\n        project_id,\n        path,\n        start_line,\n        end_line,\n        text AS snippet,\n        tier,\n        source,\n        ts_rank(fts_vector, to_tsquery('simple', $1)) AS rank_score\n      FROM pai_chunks\n      WHERE ${conditions.join(\" AND \")}\n      ORDER BY rank_score DESC\n      LIMIT ${limitParam}\n    `;\n\n    try {\n      const result = await this.pool.query<{\n        project_id: number;\n        path: string;\n        start_line: number;\n        end_line: number;\n        snippet: string;\n        tier: string;\n        source: string;\n        rank_score: number;\n      }>(sql, params);\n\n      return result.rows.map((row) => ({\n        projectId: row.project_id,\n        path: row.path,\n        startLine: row.start_line,\n        endLine: row.end_line,\n        snippet: row.snippet,\n        score: row.rank_score,\n        tier: row.tier,\n        source: row.source,\n      }));\n    } catch (e) {\n      process.stderr.write(`[pai-postgres] searchKeyword error: ${e}\\n`);\n      return [];\n    }\n  }\n\n  // -------------------------------------------------------------------------\n  // Search — semantic (pgvector cosine distance)\n  // -------------------------------------------------------------------------\n\n  async searchSemantic(queryEmbedding: Float32Array, opts?: SearchOptions): Promise<SearchResult[]> {\n    const maxResults = opts?.maxResults ?? 10;\n\n    const conditions: string[] = [\"embedding IS NOT NULL\"];\n    const params: (string | number | string)[] = [];\n    let paramIdx = 1;\n\n    // pgvector vector literal\n    const vecStr = \"[\" + Array.from(queryEmbedding).join(\",\") + \"]\";\n    params.push(vecStr);\n    const vecParam = `$${paramIdx++}`;\n\n    if (opts?.projectIds && opts.projectIds.length > 0) {\n      const placeholders = opts.projectIds.map(() => `$${paramIdx++}`).join(\", \");\n      conditions.push(`project_id IN (${placeholders})`);\n      params.push(...opts.projectIds);\n    }\n\n    if (opts?.sources && opts.sources.length > 0) {\n      const placeholders = opts.sources.map(() => `$${paramIdx++}`).join(\", \");\n      conditions.push(`source IN (${placeholders})`);\n      params.push(...opts.sources);\n    }\n\n    if (opts?.tiers && opts.tiers.length > 0) {\n      const placeholders = opts.tiers.map(() => `$${paramIdx++}`).join(\", \");\n      conditions.push(`tier IN (${placeholders})`);\n      params.push(...opts.tiers);\n    }\n\n    params.push(maxResults);\n    const limitParam = `$${paramIdx}`;\n\n    // <=> is cosine distance; 1 - distance = cosine similarity\n    const sql = `\n      SELECT\n        project_id,\n        path,\n        start_line,\n        end_line,\n        text AS snippet,\n        tier,\n        source,\n        1 - (embedding <=> ${vecParam}::vector) AS cosine_similarity\n      FROM pai_chunks\n      WHERE ${conditions.join(\" AND \")}\n      ORDER BY embedding <=> ${vecParam}::vector\n      LIMIT ${limitParam}\n    `;\n\n    try {\n      const result = await this.pool.query<{\n        project_id: number;\n        path: string;\n        start_line: number;\n        end_line: number;\n        snippet: string;\n        tier: string;\n        source: string;\n        cosine_similarity: number;\n      }>(sql, params);\n\n      const minScore = opts?.minScore ?? -Infinity;\n\n      return result.rows\n        .map((row) => ({\n          projectId: row.project_id,\n          path: row.path,\n          startLine: row.start_line,\n          endLine: row.end_line,\n          snippet: row.snippet,\n          score: row.cosine_similarity,\n          tier: row.tier,\n          source: row.source,\n        }))\n        .filter((r) => r.score >= minScore);\n    } catch (e) {\n      process.stderr.write(`[pai-postgres] searchSemantic error: ${e}\\n`);\n      return [];\n    }\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\n/**\n * Convert a Buffer of Float32 LE bytes (as stored in SQLite) to number[].\n */\nfunction bufferToVector(buf: Buffer): number[] {\n  const floats: number[] = [];\n  for (let i = 0; i < buf.length; i += 4) {\n    floats.push(buf.readFloatLE(i));\n  }\n  return floats;\n}\n\n/**\n * Convert a free-text query to a Postgres tsquery string.\n *\n * Uses OR (|) semantics so that a chunk matching ANY query term is returned,\n * ranked by ts_rank (which scores higher when more terms match).  AND (&)\n * semantics are too strict for multi-word queries because all terms rarely\n * co-occur in a single chunk.\n *\n * Example: \"Synchrotech interview follow-up Gilles\"\n *   → \"synchrotech | interview | follow | gilles\"\n *   → returns chunks containing any of these words, highest-matching first\n */\nfunction buildPgTsQuery(query: string): string {\n  const STOP_WORDS = new Set([\n    \"a\", \"an\", \"and\", \"are\", \"as\", \"at\", \"be\", \"been\", \"but\", \"by\",\n    \"do\", \"for\", \"from\", \"has\", \"have\", \"he\", \"her\", \"him\", \"his\",\n    \"how\", \"i\", \"if\", \"in\", \"is\", \"it\", \"its\", \"me\", \"my\", \"not\",\n    \"of\", \"on\", \"or\", \"our\", \"out\", \"she\", \"so\", \"that\", \"the\",\n    \"their\", \"them\", \"they\", \"this\", \"to\", \"up\", \"us\", \"was\", \"we\",\n    \"were\", \"what\", \"when\", \"who\", \"will\", \"with\", \"you\", \"your\",\n  ]);\n\n  const tokens = query\n    .toLowerCase()\n    .split(/[\\s\\p{P}]+/u)\n    .filter(Boolean)\n    .filter((t) => t.length >= 2)\n    .filter((t) => !STOP_WORDS.has(t))\n    // Sanitize: strip tsquery special characters to prevent syntax errors\n    .map((t) => t.replace(/'/g, \"''\").replace(/[&|!():]/g, \"\"))\n    .filter(Boolean);\n\n  if (tokens.length === 0) {\n    // Fallback: sanitize the raw query and use it as a single term\n    const raw = query.replace(/[^a-z0-9]/gi, \" \").trim().split(/\\s+/).filter(Boolean).join(\" | \");\n    return raw || \"\";\n  }\n\n  // Use OR (|) so that chunks matching ANY term are returned.\n  // ts_rank naturally scores chunks higher when more terms match, so the\n  // most relevant results still bubble to the top.\n  return tokens.join(\" | \");\n}\n\n// Re-export buildFtsQuery so it is accessible without importing search.ts\nexport { buildPgTsQuery };\n"],"mappings":"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"}
+{"version":3,"file":"postgres-CRBe30Ag.mjs","names":[],"sources":["../src/storage/postgres.ts"],"sourcesContent":["/**\n * PostgresBackend — implements StorageBackend using PostgreSQL + pgvector.\n *\n * Vector similarity: pgvector's <=> cosine distance operator\n * Full-text search:  PostgreSQL tsvector/tsquery (replaces SQLite FTS5)\n * Connection pooling: node-postgres Pool\n *\n * Schema is initialized via docker/init.sql.\n * This module only handles runtime queries — schema creation is external.\n */\n\nimport pg from \"pg\";\nimport type { Pool, PoolClient } from \"pg\";\nimport type { StorageBackend, ChunkRow, FileRow, FederationStats } from \"./interface.js\";\nimport type { SearchResult, SearchOptions } from \"../memory/search.js\";\nimport { buildFtsQuery } from \"../memory/search.js\";\n\nconst { Pool: PgPool } = pg;\n\n// ---------------------------------------------------------------------------\n// Postgres config\n// ---------------------------------------------------------------------------\n\nexport interface PostgresConfig {\n  connectionString?: string;\n  host?: string;\n  port?: number;\n  database?: string;\n  user?: string;\n  password?: string;\n  /** Maximum pool connections. Default 5 */\n  maxConnections?: number;\n  /** Connection timeout in ms. Default 5000 */\n  connectionTimeoutMs?: number;\n}\n\n// ---------------------------------------------------------------------------\n// Implementation\n// ---------------------------------------------------------------------------\n\nexport class PostgresBackend implements StorageBackend {\n  readonly backendType = \"postgres\" as const;\n\n  private pool: Pool;\n\n  constructor(config: PostgresConfig) {\n    const connStr =\n      config.connectionString ??\n      `postgresql://${config.user ?? \"pai\"}:${config.password ?? \"pai\"}@${config.host ?? \"localhost\"}:${config.port ?? 5432}/${config.database ?? \"pai\"}`;\n\n    this.pool = new PgPool({\n      connectionString: connStr,\n      max: config.maxConnections ?? 5,\n      connectionTimeoutMillis: config.connectionTimeoutMs ?? 5000,\n      idleTimeoutMillis: 30_000,\n    });\n\n    // Log pool errors so they don't crash the process silently\n    this.pool.on(\"error\", (err) => {\n      process.stderr.write(`[pai-postgres] Pool error: ${err.message}\\n`);\n    });\n  }\n\n  // -------------------------------------------------------------------------\n  // Lifecycle\n  // -------------------------------------------------------------------------\n\n  async close(): Promise<void> {\n    await this.pool.end();\n  }\n\n  async getStats(): Promise<FederationStats> {\n    const client = await this.pool.connect();\n    try {\n      const filesResult = await client.query<{ n: string }>(\n        \"SELECT COUNT(*)::text AS n FROM pai_files\"\n      );\n      const chunksResult = await client.query<{ n: string }>(\n        \"SELECT COUNT(*)::text AS n FROM pai_chunks\"\n      );\n      return {\n        files: parseInt(filesResult.rows[0]?.n ?? \"0\", 10),\n        chunks: parseInt(chunksResult.rows[0]?.n ?? \"0\", 10),\n      };\n    } finally {\n      client.release();\n    }\n  }\n\n  /**\n   * Test the connection by running a trivial query.\n   * Returns null on success, error message on failure.\n   */\n  async testConnection(): Promise<string | null> {\n    let client: PoolClient | null = null;\n    try {\n      client = await this.pool.connect();\n      await client.query(\"SELECT 1\");\n      return null;\n    } catch (e) {\n      return e instanceof Error ? e.message : String(e);\n    } finally {\n      client?.release();\n    }\n  }\n\n  // -------------------------------------------------------------------------\n  // File tracking\n  // -------------------------------------------------------------------------\n\n  async getFileHash(projectId: number, path: string): Promise<string | undefined> {\n    const result = await this.pool.query<{ hash: string }>(\n      \"SELECT hash FROM pai_files WHERE project_id = $1 AND path = $2\",\n      [projectId, path]\n    );\n    return result.rows[0]?.hash;\n  }\n\n  async upsertFile(file: FileRow): Promise<void> {\n    await this.pool.query(\n      `INSERT INTO pai_files (project_id, path, source, tier, hash, mtime, size)\n       VALUES ($1, $2, $3, $4, $5, $6, $7)\n       ON CONFLICT (project_id, path) DO UPDATE SET\n         source = EXCLUDED.source,\n         tier   = EXCLUDED.tier,\n         hash   = EXCLUDED.hash,\n         mtime  = EXCLUDED.mtime,\n         size   = EXCLUDED.size`,\n      [file.projectId, file.path, file.source, file.tier, file.hash, file.mtime, file.size]\n    );\n  }\n\n  // -------------------------------------------------------------------------\n  // Chunk management\n  // -------------------------------------------------------------------------\n\n  async getChunkIds(projectId: number, path: string): Promise<string[]> {\n    const result = await this.pool.query<{ id: string }>(\n      \"SELECT id FROM pai_chunks WHERE project_id = $1 AND path = $2\",\n      [projectId, path]\n    );\n    return result.rows.map((r) => r.id);\n  }\n\n  async deleteChunksForFile(projectId: number, path: string): Promise<void> {\n    // Foreign key CASCADE handles pai_chunks deletion automatically\n    // but we don't have FK to pai_chunks from pai_files, so delete explicitly\n    await this.pool.query(\n      \"DELETE FROM pai_chunks WHERE project_id = $1 AND path = $2\",\n      [projectId, path]\n    );\n  }\n\n  async insertChunks(chunks: ChunkRow[]): Promise<void> {\n    if (chunks.length === 0) return;\n\n    const client = await this.pool.connect();\n    try {\n      await client.query(\"BEGIN\");\n\n      for (const c of chunks) {\n        // embedding is null at insert time; updated separately via updateEmbedding()\n        await client.query(\n          `INSERT INTO pai_chunks\n             (id, project_id, source, tier, path, start_line, end_line, hash, text, updated_at, fts_vector)\n           VALUES\n             ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10,\n              to_tsvector('simple', $9))\n           ON CONFLICT (id) DO UPDATE SET\n             project_id = EXCLUDED.project_id,\n             source     = EXCLUDED.source,\n             tier       = EXCLUDED.tier,\n             path       = EXCLUDED.path,\n             start_line = EXCLUDED.start_line,\n             end_line   = EXCLUDED.end_line,\n             hash       = EXCLUDED.hash,\n             text       = EXCLUDED.text,\n             updated_at = EXCLUDED.updated_at,\n             fts_vector = EXCLUDED.fts_vector`,\n          [\n            c.id,\n            c.projectId,\n            c.source,\n            c.tier,\n            c.path,\n            c.startLine,\n            c.endLine,\n            c.hash,\n            c.text,\n            c.updatedAt,\n          ]\n        );\n      }\n\n      await client.query(\"COMMIT\");\n    } catch (e) {\n      await client.query(\"ROLLBACK\");\n      throw e;\n    } finally {\n      client.release();\n    }\n  }\n\n  async getUnembeddedChunkIds(projectId?: number): Promise<Array<{ id: string; text: string }>> {\n    if (projectId !== undefined) {\n      const result = await this.pool.query<{ id: string; text: string }>(\n        \"SELECT id, text FROM pai_chunks WHERE embedding IS NULL AND project_id = $1 ORDER BY id\",\n        [projectId]\n      );\n      return result.rows;\n    }\n    const result = await this.pool.query<{ id: string; text: string }>(\n      \"SELECT id, text FROM pai_chunks WHERE embedding IS NULL ORDER BY id\"\n    );\n    return result.rows;\n  }\n\n  async updateEmbedding(chunkId: string, embedding: Buffer): Promise<void> {\n    // Deserialize the Buffer (Float32Array LE bytes) to a number[] for pgvector\n    const vec = bufferToVector(embedding);\n    const vecStr = \"[\" + vec.join(\",\") + \"]\";\n    await this.pool.query(\n      \"UPDATE pai_chunks SET embedding = $1::vector WHERE id = $2\",\n      [vecStr, chunkId]\n    );\n  }\n\n  // -------------------------------------------------------------------------\n  // Search — keyword (tsvector/tsquery)\n  // -------------------------------------------------------------------------\n\n  async searchKeyword(query: string, opts?: SearchOptions): Promise<SearchResult[]> {\n    const maxResults = opts?.maxResults ?? 10;\n\n    // Build tsquery from the same token logic as buildFtsQuery, but for Postgres\n    const tsQuery = buildPgTsQuery(query);\n    if (!tsQuery) return [];\n\n    // Use 'simple' dictionary: preserves tokens as-is, no language-specific\n    // stemming. Works reliably with any language (German, French, etc.).\n    const conditions: string[] = [\"fts_vector @@ to_tsquery('simple', $1)\"];\n    const params: (string | number)[] = [tsQuery];\n    let paramIdx = 2;\n\n    if (opts?.projectIds && opts.projectIds.length > 0) {\n      const placeholders = opts.projectIds.map(() => `$${paramIdx++}`).join(\", \");\n      conditions.push(`project_id IN (${placeholders})`);\n      params.push(...opts.projectIds);\n    }\n\n    if (opts?.sources && opts.sources.length > 0) {\n      const placeholders = opts.sources.map(() => `$${paramIdx++}`).join(\", \");\n      conditions.push(`source IN (${placeholders})`);\n      params.push(...opts.sources);\n    }\n\n    if (opts?.tiers && opts.tiers.length > 0) {\n      const placeholders = opts.tiers.map(() => `$${paramIdx++}`).join(\", \");\n      conditions.push(`tier IN (${placeholders})`);\n      params.push(...opts.tiers);\n    }\n\n    params.push(maxResults);\n    const limitParam = `$${paramIdx}`;\n\n    const sql = `\n      SELECT\n        project_id,\n        path,\n        start_line,\n        end_line,\n        text AS snippet,\n        tier,\n        source,\n        ts_rank(fts_vector, to_tsquery('simple', $1)) AS rank_score\n      FROM pai_chunks\n      WHERE ${conditions.join(\" AND \")}\n      ORDER BY rank_score DESC\n      LIMIT ${limitParam}\n    `;\n\n    try {\n      const result = await this.pool.query<{\n        project_id: number;\n        path: string;\n        start_line: number;\n        end_line: number;\n        snippet: string;\n        tier: string;\n        source: string;\n        rank_score: number;\n      }>(sql, params);\n\n      return result.rows.map((row) => ({\n        projectId: row.project_id,\n        path: row.path,\n        startLine: row.start_line,\n        endLine: row.end_line,\n        snippet: row.snippet,\n        score: row.rank_score,\n        tier: row.tier,\n        source: row.source,\n      }));\n    } catch (e) {\n      process.stderr.write(`[pai-postgres] searchKeyword error: ${e}\\n`);\n      return [];\n    }\n  }\n\n  // -------------------------------------------------------------------------\n  // Search — semantic (pgvector cosine distance)\n  // -------------------------------------------------------------------------\n\n  async searchSemantic(queryEmbedding: Float32Array, opts?: SearchOptions): Promise<SearchResult[]> {\n    const maxResults = opts?.maxResults ?? 10;\n\n    const conditions: string[] = [\"embedding IS NOT NULL\"];\n    const params: (string | number | string)[] = [];\n    let paramIdx = 1;\n\n    // pgvector vector literal\n    const vecStr = \"[\" + Array.from(queryEmbedding).join(\",\") + \"]\";\n    params.push(vecStr);\n    const vecParam = `$${paramIdx++}`;\n\n    if (opts?.projectIds && opts.projectIds.length > 0) {\n      const placeholders = opts.projectIds.map(() => `$${paramIdx++}`).join(\", \");\n      conditions.push(`project_id IN (${placeholders})`);\n      params.push(...opts.projectIds);\n    }\n\n    if (opts?.sources && opts.sources.length > 0) {\n      const placeholders = opts.sources.map(() => `$${paramIdx++}`).join(\", \");\n      conditions.push(`source IN (${placeholders})`);\n      params.push(...opts.sources);\n    }\n\n    if (opts?.tiers && opts.tiers.length > 0) {\n      const placeholders = opts.tiers.map(() => `$${paramIdx++}`).join(\", \");\n      conditions.push(`tier IN (${placeholders})`);\n      params.push(...opts.tiers);\n    }\n\n    params.push(maxResults);\n    const limitParam = `$${paramIdx}`;\n\n    // <=> is cosine distance; 1 - distance = cosine similarity\n    const sql = `\n      SELECT\n        project_id,\n        path,\n        start_line,\n        end_line,\n        text AS snippet,\n        tier,\n        source,\n        1 - (embedding <=> ${vecParam}::vector) AS cosine_similarity\n      FROM pai_chunks\n      WHERE ${conditions.join(\" AND \")}\n      ORDER BY embedding <=> ${vecParam}::vector\n      LIMIT ${limitParam}\n    `;\n\n    try {\n      const result = await this.pool.query<{\n        project_id: number;\n        path: string;\n        start_line: number;\n        end_line: number;\n        snippet: string;\n        tier: string;\n        source: string;\n        cosine_similarity: number;\n      }>(sql, params);\n\n      const minScore = opts?.minScore ?? -Infinity;\n\n      return result.rows\n        .map((row) => ({\n          projectId: row.project_id,\n          path: row.path,\n          startLine: row.start_line,\n          endLine: row.end_line,\n          snippet: row.snippet,\n          score: row.cosine_similarity,\n          tier: row.tier,\n          source: row.source,\n        }))\n        .filter((r) => r.score >= minScore);\n    } catch (e) {\n      process.stderr.write(`[pai-postgres] searchSemantic error: ${e}\\n`);\n      return [];\n    }\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\n/**\n * Convert a Buffer of Float32 LE bytes (as stored in SQLite) to number[].\n */\nfunction bufferToVector(buf: Buffer): number[] {\n  const floats: number[] = [];\n  for (let i = 0; i < buf.length; i += 4) {\n    floats.push(buf.readFloatLE(i));\n  }\n  return floats;\n}\n\n/**\n * Convert a free-text query to a Postgres tsquery string.\n *\n * Uses OR (|) semantics so that a chunk matching ANY query term is returned,\n * ranked by ts_rank (which scores higher when more terms match).  AND (&)\n * semantics are too strict for multi-word queries because all terms rarely\n * co-occur in a single chunk.\n *\n * Example: \"Synchrotech interview follow-up Gilles\"\n *   → \"synchrotech | interview | follow | gilles\"\n *   → returns chunks containing any of these words, highest-matching first\n */\nfunction buildPgTsQuery(query: string): string {\n  const STOP_WORDS = new Set([\n    \"a\", \"an\", \"and\", \"are\", \"as\", \"at\", \"be\", \"been\", \"but\", \"by\",\n    \"do\", \"for\", \"from\", \"has\", \"have\", \"he\", \"her\", \"him\", \"his\",\n    \"how\", \"i\", \"if\", \"in\", \"is\", \"it\", \"its\", \"me\", \"my\", \"not\",\n    \"of\", \"on\", \"or\", \"our\", \"out\", \"she\", \"so\", \"that\", \"the\",\n    \"their\", \"them\", \"they\", \"this\", \"to\", \"up\", \"us\", \"was\", \"we\",\n    \"were\", \"what\", \"when\", \"who\", \"will\", \"with\", \"you\", \"your\",\n  ]);\n\n  const tokens = query\n    .toLowerCase()\n    .split(/[\\s\\p{P}]+/u)\n    .filter(Boolean)\n    .filter((t) => t.length >= 2)\n    .filter((t) => !STOP_WORDS.has(t))\n    // Sanitize: strip tsquery special characters to prevent syntax errors\n    .map((t) => t.replace(/'/g, \"''\").replace(/[&|!():]/g, \"\"))\n    .filter(Boolean);\n\n  if (tokens.length === 0) {\n    // Fallback: sanitize the raw query and use it as a single term\n    const raw = query.replace(/[^a-z0-9]/gi, \" \").trim().split(/\\s+/).filter(Boolean).join(\" | \");\n    return raw || \"\";\n  }\n\n  // Use OR (|) so that chunks matching ANY term are returned.\n  // ts_rank naturally scores chunks higher when more terms match, so the\n  // most relevant results still bubble to the top.\n  return tokens.join(\" | \");\n}\n\n// Re-export buildFtsQuery so it is accessible without importing search.ts\nexport { buildPgTsQuery };\n"],"mappings":"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"}

package/dist/{schemas-DjdwzIQ8.mjs → schemas-BY3Pjvje.mjs}

@@ -3402,4 +3402,4 @@ const meta = meta$1;
 
 //#endregion
 export { record as a, number as i, array as n, string as o, boolean as r, unknown as s, _enum as t };
-//# sourceMappingURL=schemas-DjdwzIQ8.mjs.map
+//# sourceMappingURL=schemas-BY3Pjvje.mjs.map