@theglitchking/semantic-pages 0.4.0 → 0.4.1

package/dist/cli/index.js

@@ -199,7 +199,7 @@ function printToolDetail(name) {
 }
 program.name("semantic-pages").description(
   "Semantic search + knowledge graph MCP server for markdown files\n\n  Start MCP server:  semantic-pages --notes ./vault\n  Show vault stats:  semantic-pages --notes ./vault --stats\n  Force reindex:     semantic-pages --notes ./vault --reindex\n  List MCP tools:    semantic-pages tools\n  Tool details:      semantic-pages tools search_semantic"
-).version("0.4.0");
+).version("0.4.1");
 program.command("tools [name]").description("List all MCP tools, or show details for a specific tool").action((name) => {
   if (name) {
     printToolDetail(name);

package/dist/cli/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/cli/index.ts"],"sourcesContent":["#!/usr/bin/env node\n\nimport { program } from \"commander\";\nimport { resolve } from \"node:path\";\nimport { existsSync } from \"node:fs\";\n\nconst TOOL_HELP: Record<string, { description: string; args: string; examples: string[] }> = {\n  // Search\n  search_semantic: {\n    description: \"Vector similarity search — find notes by meaning, not just keywords\",\n    args: '{ \"query\": \"string\", \"limit?\": 10 }',\n    examples: [\n      '{ \"query\": \"microservices architecture\", \"limit\": 5 }',\n      '{ \"query\": \"how to deploy to production\" }',\n    ],\n  },\n  search_text: {\n    description: \"Full-text keyword or regex search with optional filters\",\n    args: '{ \"pattern\": \"string\", \"regex?\": false, \"caseSensitive?\": false, \"pathGlob?\": \"string\", \"tagFilter?\": [\"string\"], \"limit?\": 20 }',\n    examples: [\n      '{ \"pattern\": \"RabbitMQ\" }',\n      '{ \"pattern\": \"OAuth\\\\\\\\d\", \"regex\": true }',\n      '{ \"pattern\": \"deploy\", \"pathGlob\": \"devops/**\", \"tagFilter\": [\"kubernetes\"] }',\n    ],\n  },\n  search_graph: {\n    description: \"Graph traversal — find notes connected to a concept via wikilinks and tags\",\n    args: '{ \"concept\": \"string\", \"maxDepth?\": 2 }',\n    examples: [\n      '{ \"concept\": \"microservices\" }',\n      '{ \"concept\": \"auth\", \"maxDepth\": 3 }',\n    ],\n  },\n  search_hybrid: {\n    description: \"Combined semantic + graph search — vector results re-ranked by graph proximity\",\n    args: '{ \"query\": \"string\", \"limit?\": 10 }',\n    examples: [\n      '{ \"query\": \"event driven architecture\", \"limit\": 5 }',\n    ],\n  },\n\n  // Read\n  read_note: {\n    description: \"Read the full content of a specific note by path\",\n    args: '{ \"path\": \"string\" }',\n    examples: [\n      '{ \"path\": \"project-overview.md\" }',\n      '{ \"path\": \"notes/meeting-2024-01-15.md\" }',\n    ],\n  },\n  read_multiple_notes: {\n    description: \"Batch read multiple notes in one call\",\n    args: '{ \"paths\": [\"string\"] }',\n    examples: [\n      '{ \"paths\": [\"overview.md\", \"architecture.md\", \"deployment.md\"] }',\n    ],\n  },\n  list_notes: {\n    description: \"List all indexed notes with metadata (title, tags, link count)\",\n    args: \"{}\",\n    examples: [\"{}\"],\n  },\n\n  // Write\n  create_note: {\n    description: \"Create a new markdown note with optional YAML frontmatter\",\n    args: '{ \"path\": \"string\", \"content\": \"string\", \"frontmatter?\": {} }',\n    examples: [\n      '{ \"path\": \"new-guide.md\", \"content\": \"# Guide\\\\n\\\\nContent here.\" }',\n      '{ \"path\": \"tagged.md\", \"content\": \"Content.\", \"frontmatter\": { \"title\": \"Tagged Note\", \"tags\": [\"test\"] } }',\n    ],\n  },\n  update_note: {\n    description: \"Edit note content — overwrite, append, prepend, or patch by heading\",\n    args: '{ \"path\": \"string\", \"content\": \"string\", \"mode\": \"overwrite|append|prepend|patch-by-heading\", \"heading?\": \"string\" }',\n    examples: [\n      '{ \"path\": \"guide.md\", \"content\": \"New content.\", \"mode\": \"overwrite\" }',\n      '{ \"path\": \"guide.md\", \"content\": \"\\\\n## Appendix\\\\nExtra info.\", \"mode\": \"append\" }',\n      '{ \"path\": \"guide.md\", \"content\": \"Updated architecture section.\", \"mode\": \"patch-by-heading\", \"heading\": \"Architecture\" }',\n    ],\n  },\n  delete_note: {\n    description: \"Delete a note permanently (requires confirm=true)\",\n    args: '{ \"path\": \"string\", \"confirm\": true }',\n    examples: [\n      '{ \"path\": \"old-note.md\", \"confirm\": true }',\n      '{ \"path\": \"old-note.md\", \"confirm\": false }  // returns warning, does not delete',\n    ],\n  },\n  move_note: {\n    description: \"Move or rename a note — automatically updates wikilinks across the vault\",\n    args: '{ \"from\": \"string\", \"to\": \"string\" }',\n    examples: [\n      '{ \"from\": \"user-service.md\", \"to\": \"auth-service.md\" }',\n      '{ \"from\": \"old/note.md\", \"to\": \"new/location/note.md\" }',\n    ],\n  },\n\n  // Metadata\n  get_frontmatter: {\n    description: \"Read parsed YAML frontmatter from a note as JSON\",\n    args: '{ \"path\": \"string\" }',\n    examples: ['{ \"path\": \"project-overview.md\" }'],\n  },\n  update_frontmatter: {\n    description: \"Set or delete YAML frontmatter keys — pass null to delete a key\",\n    args: '{ \"path\": \"string\", \"fields\": {} }',\n    examples: [\n      '{ \"path\": \"note.md\", \"fields\": { \"status\": \"active\", \"priority\": 1 } }',\n      '{ \"path\": \"note.md\", \"fields\": { \"deprecated_field\": null } }  // deletes the key',\n    ],\n  },\n  manage_tags: {\n    description: \"Add, remove, or list tags on a note (frontmatter and inline)\",\n    args: '{ \"path\": \"string\", \"action\": \"add|remove|list\", \"tags?\": [\"string\"] }',\n    examples: [\n      '{ \"path\": \"note.md\", \"action\": \"list\" }',\n      '{ \"path\": \"note.md\", \"action\": \"add\", \"tags\": [\"important\", \"reviewed\"] }',\n      '{ \"path\": \"note.md\", \"action\": \"remove\", \"tags\": [\"draft\"] }',\n    ],\n  },\n  rename_tag: {\n    description: \"Rename a tag across all notes in the vault (frontmatter + inline)\",\n    args: '{ \"oldTag\": \"string\", \"newTag\": \"string\" }',\n    examples: ['{ \"oldTag\": \"architecture\", \"newTag\": \"arch\" }'],\n  },\n\n  // Graph\n  backlinks: {\n    description: \"Find all notes that link TO a given note via [[wikilinks]]\",\n    args: '{ \"path\": \"string\" }',\n    examples: ['{ \"path\": \"microservices.md\" }'],\n  },\n  forwardlinks: {\n    description: \"Find all notes linked FROM a given note\",\n    args: '{ \"path\": \"string\" }',\n    examples: ['{ \"path\": \"project-overview.md\" }'],\n  },\n  graph_path: {\n    description: \"Find the shortest path between two notes in the knowledge graph\",\n    args: '{ \"from\": \"string\", \"to\": \"string\" }',\n    examples: ['{ \"from\": \"project-overview.md\", \"to\": \"user-service.md\" }'],\n  },\n  graph_statistics: {\n    description: \"Knowledge graph stats — most connected nodes, orphans, density\",\n    args: \"{}\",\n    examples: [\"{}\"],\n  },\n\n  // System\n  get_stats: {\n    description: \"Vault and index statistics — note count, chunks, embeddings, graph density\",\n    args: \"{}\",\n    examples: [\"{}\"],\n  },\n  reindex: {\n    description: \"Force a full reindex of the vault\",\n    args: \"{}\",\n    examples: [\"{}\"],\n  },\n};\n\nconst TOOL_CATEGORIES: Record<string, string[]> = {\n  Search: [\"search_semantic\", \"search_text\", \"search_graph\", \"search_hybrid\"],\n  Read: [\"read_note\", \"read_multiple_notes\", \"list_notes\"],\n  Write: [\"create_note\", \"update_note\", \"delete_note\", \"move_note\"],\n  Metadata: [\"get_frontmatter\", \"update_frontmatter\", \"manage_tags\", \"rename_tag\"],\n  Graph: [\"backlinks\", \"forwardlinks\", \"graph_path\", \"graph_statistics\"],\n  System: [\"get_stats\", \"reindex\"],\n};\n\nfunction printToolList() {\n  console.log(\"\\nSemantic Pages — 21 MCP Tools\\n\");\n  console.log(\"Usage: These tools are available via MCP when the server is running.\");\n  console.log(\"       Run `semantic-pages tools <name>` for details on a specific tool.\\n\");\n\n  for (const [category, tools] of Object.entries(TOOL_CATEGORIES)) {\n    console.log(`  ${category}:`);\n    for (const name of tools) {\n      const tool = TOOL_HELP[name];\n      console.log(`    ${name.padEnd(24)} ${tool.description}`);\n    }\n    console.log();\n  }\n\n  console.log(\"Run `semantic-pages tools <tool-name>` for arguments and examples.\");\n}\n\nfunction printToolDetail(name: string) {\n  const tool = TOOL_HELP[name];\n  if (!tool) {\n    console.error(`Unknown tool: ${name}`);\n    console.error(`Run \\`semantic-pages tools\\` to see all available tools.`);\n    process.exit(1);\n  }\n\n  console.log(`\\n  ${name}`);\n  console.log(`  ${\"─\".repeat(name.length)}`);\n  console.log(`  ${tool.description}\\n`);\n  console.log(`  Arguments:`);\n  console.log(`    ${tool.args}\\n`);\n  console.log(`  Examples:`);\n  for (const ex of tool.examples) {\n    console.log(`    ${ex}`);\n  }\n  console.log();\n}\n\nprogram\n  .name(\"semantic-pages\")\n  .description(\n    \"Semantic search + knowledge graph MCP server for markdown files\\n\\n\" +\n    \"  Start MCP server:  semantic-pages --notes ./vault\\n\" +\n    \"  Show vault stats:  semantic-pages --notes ./vault --stats\\n\" +\n    \"  Force reindex:     semantic-pages --notes ./vault --reindex\\n\" +\n    \"  List MCP tools:    semantic-pages tools\\n\" +\n    \"  Tool details:      semantic-pages tools search_semantic\"\n  )\n  .version(\"0.4.0\");\n\nprogram\n  .command(\"tools [name]\")\n  .description(\"List all MCP tools, or show details for a specific tool\")\n  .action((name?: string) => {\n    if (name) {\n      printToolDetail(name);\n    } else {\n      printToolList();\n    }\n    process.exit(0);\n  });\n\nprogram\n  .command(\"serve\", { isDefault: true })\n  .description(\"Start the MCP server (default command)\")\n  .requiredOption(\"--notes <path>\", \"Path to markdown notes directory\")\n  .option(\"--reindex\", \"Force full reindex and exit\")\n  .option(\"--stats\", \"Show vault statistics and exit\")\n  .option(\"--model <name>\", \"Embedding model to use\", \"nomic-ai/nomic-embed-text-v1.5\")\n  .option(\"--workers <n>\", \"Number of worker threads for parallel embedding\", parseInt)\n  .option(\"--batch-size <n>\", \"Texts per ONNX forward pass (default: 32)\", parseInt)\n  .option(\"--no-watch\", \"Disable file watcher\")\n  .action(async (opts) => {\n    const notesPath = resolve(opts.notes);\n\n    if (!existsSync(notesPath)) {\n      console.error(`Error: notes directory not found: ${notesPath}`);\n      process.exit(1);\n    }\n\n    if (opts.stats) {\n      const { Indexer } = await import(\"../core/indexer.js\");\n      const indexer = new Indexer(notesPath);\n      const docs = await indexer.indexAll();\n      console.log(`Notes: ${docs.length}`);\n      console.log(`Chunks: ${docs.reduce((n: number, d: any) => n + d.chunks.length, 0)}`);\n      console.log(`Wikilinks: ${docs.reduce((n: number, d: any) => n + d.wikilinks.length, 0)}`);\n      console.log(`Tags: ${new Set(docs.flatMap((d: any) => d.tags)).size} unique`);\n      process.exit(0);\n    }\n\n    if (opts.reindex) {\n      const { createServer } = await import(\"../mcp/server.js\");\n      await createServer(notesPath, {\n        watch: false,\n        waitForReady: true,\n        model: opts.model,\n        workers: opts.workers,\n        batchSize: opts.batchSize,\n        onProgress: (embedded, total) => {\n          process.stderr.write(`\\rEmbedding ${embedded}/${total} chunks...`);\n        },\n      });\n      process.stderr.write(\"\\n\");\n      console.log(\"Reindex complete.\");\n      process.exit(0);\n    }\n\n    // Default: start MCP server on stdio\n    const { startServer } = await import(\"../mcp/server.js\");\n    await startServer(notesPath, { watch: opts.watch, model: opts.model, workers: opts.workers, batchSize: opts.batchSize });\n  });\n\nprogram.parse();\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/cli/index.ts"],"sourcesContent":["#!/usr/bin/env node\n\nimport { program } from \"commander\";\nimport { resolve } from \"node:path\";\nimport { existsSync } from \"node:fs\";\n\nconst TOOL_HELP: Record<string, { description: string; args: string; examples: string[] }> = {\n  // Search\n  search_semantic: {\n    description: \"Vector similarity search — find notes by meaning, not just keywords\",\n    args: '{ \"query\": \"string\", \"limit?\": 10 }',\n    examples: [\n      '{ \"query\": \"microservices architecture\", \"limit\": 5 }',\n      '{ \"query\": \"how to deploy to production\" }',\n    ],\n  },\n  search_text: {\n    description: \"Full-text keyword or regex search with optional filters\",\n    args: '{ \"pattern\": \"string\", \"regex?\": false, \"caseSensitive?\": false, \"pathGlob?\": \"string\", \"tagFilter?\": [\"string\"], \"limit?\": 20 }',\n    examples: [\n      '{ \"pattern\": \"RabbitMQ\" }',\n      '{ \"pattern\": \"OAuth\\\\\\\\d\", \"regex\": true }',\n      '{ \"pattern\": \"deploy\", \"pathGlob\": \"devops/**\", \"tagFilter\": [\"kubernetes\"] }',\n    ],\n  },\n  search_graph: {\n    description: \"Graph traversal — find notes connected to a concept via wikilinks and tags\",\n    args: '{ \"concept\": \"string\", \"maxDepth?\": 2 }',\n    examples: [\n      '{ \"concept\": \"microservices\" }',\n      '{ \"concept\": \"auth\", \"maxDepth\": 3 }',\n    ],\n  },\n  search_hybrid: {\n    description: \"Combined semantic + graph search — vector results re-ranked by graph proximity\",\n    args: '{ \"query\": \"string\", \"limit?\": 10 }',\n    examples: [\n      '{ \"query\": \"event driven architecture\", \"limit\": 5 }',\n    ],\n  },\n\n  // Read\n  read_note: {\n    description: \"Read the full content of a specific note by path\",\n    args: '{ \"path\": \"string\" }',\n    examples: [\n      '{ \"path\": \"project-overview.md\" }',\n      '{ \"path\": \"notes/meeting-2024-01-15.md\" }',\n    ],\n  },\n  read_multiple_notes: {\n    description: \"Batch read multiple notes in one call\",\n    args: '{ \"paths\": [\"string\"] }',\n    examples: [\n      '{ \"paths\": [\"overview.md\", \"architecture.md\", \"deployment.md\"] }',\n    ],\n  },\n  list_notes: {\n    description: \"List all indexed notes with metadata (title, tags, link count)\",\n    args: \"{}\",\n    examples: [\"{}\"],\n  },\n\n  // Write\n  create_note: {\n    description: \"Create a new markdown note with optional YAML frontmatter\",\n    args: '{ \"path\": \"string\", \"content\": \"string\", \"frontmatter?\": {} }',\n    examples: [\n      '{ \"path\": \"new-guide.md\", \"content\": \"# Guide\\\\n\\\\nContent here.\" }',\n      '{ \"path\": \"tagged.md\", \"content\": \"Content.\", \"frontmatter\": { \"title\": \"Tagged Note\", \"tags\": [\"test\"] } }',\n    ],\n  },\n  update_note: {\n    description: \"Edit note content — overwrite, append, prepend, or patch by heading\",\n    args: '{ \"path\": \"string\", \"content\": \"string\", \"mode\": \"overwrite|append|prepend|patch-by-heading\", \"heading?\": \"string\" }',\n    examples: [\n      '{ \"path\": \"guide.md\", \"content\": \"New content.\", \"mode\": \"overwrite\" }',\n      '{ \"path\": \"guide.md\", \"content\": \"\\\\n## Appendix\\\\nExtra info.\", \"mode\": \"append\" }',\n      '{ \"path\": \"guide.md\", \"content\": \"Updated architecture section.\", \"mode\": \"patch-by-heading\", \"heading\": \"Architecture\" }',\n    ],\n  },\n  delete_note: {\n    description: \"Delete a note permanently (requires confirm=true)\",\n    args: '{ \"path\": \"string\", \"confirm\": true }',\n    examples: [\n      '{ \"path\": \"old-note.md\", \"confirm\": true }',\n      '{ \"path\": \"old-note.md\", \"confirm\": false }  // returns warning, does not delete',\n    ],\n  },\n  move_note: {\n    description: \"Move or rename a note — automatically updates wikilinks across the vault\",\n    args: '{ \"from\": \"string\", \"to\": \"string\" }',\n    examples: [\n      '{ \"from\": \"user-service.md\", \"to\": \"auth-service.md\" }',\n      '{ \"from\": \"old/note.md\", \"to\": \"new/location/note.md\" }',\n    ],\n  },\n\n  // Metadata\n  get_frontmatter: {\n    description: \"Read parsed YAML frontmatter from a note as JSON\",\n    args: '{ \"path\": \"string\" }',\n    examples: ['{ \"path\": \"project-overview.md\" }'],\n  },\n  update_frontmatter: {\n    description: \"Set or delete YAML frontmatter keys — pass null to delete a key\",\n    args: '{ \"path\": \"string\", \"fields\": {} }',\n    examples: [\n      '{ \"path\": \"note.md\", \"fields\": { \"status\": \"active\", \"priority\": 1 } }',\n      '{ \"path\": \"note.md\", \"fields\": { \"deprecated_field\": null } }  // deletes the key',\n    ],\n  },\n  manage_tags: {\n    description: \"Add, remove, or list tags on a note (frontmatter and inline)\",\n    args: '{ \"path\": \"string\", \"action\": \"add|remove|list\", \"tags?\": [\"string\"] }',\n    examples: [\n      '{ \"path\": \"note.md\", \"action\": \"list\" }',\n      '{ \"path\": \"note.md\", \"action\": \"add\", \"tags\": [\"important\", \"reviewed\"] }',\n      '{ \"path\": \"note.md\", \"action\": \"remove\", \"tags\": [\"draft\"] }',\n    ],\n  },\n  rename_tag: {\n    description: \"Rename a tag across all notes in the vault (frontmatter + inline)\",\n    args: '{ \"oldTag\": \"string\", \"newTag\": \"string\" }',\n    examples: ['{ \"oldTag\": \"architecture\", \"newTag\": \"arch\" }'],\n  },\n\n  // Graph\n  backlinks: {\n    description: \"Find all notes that link TO a given note via [[wikilinks]]\",\n    args: '{ \"path\": \"string\" }',\n    examples: ['{ \"path\": \"microservices.md\" }'],\n  },\n  forwardlinks: {\n    description: \"Find all notes linked FROM a given note\",\n    args: '{ \"path\": \"string\" }',\n    examples: ['{ \"path\": \"project-overview.md\" }'],\n  },\n  graph_path: {\n    description: \"Find the shortest path between two notes in the knowledge graph\",\n    args: '{ \"from\": \"string\", \"to\": \"string\" }',\n    examples: ['{ \"from\": \"project-overview.md\", \"to\": \"user-service.md\" }'],\n  },\n  graph_statistics: {\n    description: \"Knowledge graph stats — most connected nodes, orphans, density\",\n    args: \"{}\",\n    examples: [\"{}\"],\n  },\n\n  // System\n  get_stats: {\n    description: \"Vault and index statistics — note count, chunks, embeddings, graph density\",\n    args: \"{}\",\n    examples: [\"{}\"],\n  },\n  reindex: {\n    description: \"Force a full reindex of the vault\",\n    args: \"{}\",\n    examples: [\"{}\"],\n  },\n};\n\nconst TOOL_CATEGORIES: Record<string, string[]> = {\n  Search: [\"search_semantic\", \"search_text\", \"search_graph\", \"search_hybrid\"],\n  Read: [\"read_note\", \"read_multiple_notes\", \"list_notes\"],\n  Write: [\"create_note\", \"update_note\", \"delete_note\", \"move_note\"],\n  Metadata: [\"get_frontmatter\", \"update_frontmatter\", \"manage_tags\", \"rename_tag\"],\n  Graph: [\"backlinks\", \"forwardlinks\", \"graph_path\", \"graph_statistics\"],\n  System: [\"get_stats\", \"reindex\"],\n};\n\nfunction printToolList() {\n  console.log(\"\\nSemantic Pages — 21 MCP Tools\\n\");\n  console.log(\"Usage: These tools are available via MCP when the server is running.\");\n  console.log(\"       Run `semantic-pages tools <name>` for details on a specific tool.\\n\");\n\n  for (const [category, tools] of Object.entries(TOOL_CATEGORIES)) {\n    console.log(`  ${category}:`);\n    for (const name of tools) {\n      const tool = TOOL_HELP[name];\n      console.log(`    ${name.padEnd(24)} ${tool.description}`);\n    }\n    console.log();\n  }\n\n  console.log(\"Run `semantic-pages tools <tool-name>` for arguments and examples.\");\n}\n\nfunction printToolDetail(name: string) {\n  const tool = TOOL_HELP[name];\n  if (!tool) {\n    console.error(`Unknown tool: ${name}`);\n    console.error(`Run \\`semantic-pages tools\\` to see all available tools.`);\n    process.exit(1);\n  }\n\n  console.log(`\\n  ${name}`);\n  console.log(`  ${\"─\".repeat(name.length)}`);\n  console.log(`  ${tool.description}\\n`);\n  console.log(`  Arguments:`);\n  console.log(`    ${tool.args}\\n`);\n  console.log(`  Examples:`);\n  for (const ex of tool.examples) {\n    console.log(`    ${ex}`);\n  }\n  console.log();\n}\n\nprogram\n  .name(\"semantic-pages\")\n  .description(\n    \"Semantic search + knowledge graph MCP server for markdown files\\n\\n\" +\n    \"  Start MCP server:  semantic-pages --notes ./vault\\n\" +\n    \"  Show vault stats:  semantic-pages --notes ./vault --stats\\n\" +\n    \"  Force reindex:     semantic-pages --notes ./vault --reindex\\n\" +\n    \"  List MCP tools:    semantic-pages tools\\n\" +\n    \"  Tool details:      semantic-pages tools search_semantic\"\n  )\n  .version(\"0.4.1\");\n\nprogram\n  .command(\"tools [name]\")\n  .description(\"List all MCP tools, or show details for a specific tool\")\n  .action((name?: string) => {\n    if (name) {\n      printToolDetail(name);\n    } else {\n      printToolList();\n    }\n    process.exit(0);\n  });\n\nprogram\n  .command(\"serve\", { isDefault: true })\n  .description(\"Start the MCP server (default command)\")\n  .requiredOption(\"--notes <path>\", \"Path to markdown notes directory\")\n  .option(\"--reindex\", \"Force full reindex and exit\")\n  .option(\"--stats\", \"Show vault statistics and exit\")\n  .option(\"--model <name>\", \"Embedding model to use\", \"nomic-ai/nomic-embed-text-v1.5\")\n  .option(\"--workers <n>\", \"Number of worker threads for parallel embedding\", parseInt)\n  .option(\"--batch-size <n>\", \"Texts per ONNX forward pass (default: 32)\", parseInt)\n  .option(\"--no-watch\", \"Disable file watcher\")\n  .action(async (opts) => {\n    const notesPath = resolve(opts.notes);\n\n    if (!existsSync(notesPath)) {\n      console.error(`Error: notes directory not found: ${notesPath}`);\n      process.exit(1);\n    }\n\n    if (opts.stats) {\n      const { Indexer } = await import(\"../core/indexer.js\");\n      const indexer = new Indexer(notesPath);\n      const docs = await indexer.indexAll();\n      console.log(`Notes: ${docs.length}`);\n      console.log(`Chunks: ${docs.reduce((n: number, d: any) => n + d.chunks.length, 0)}`);\n      console.log(`Wikilinks: ${docs.reduce((n: number, d: any) => n + d.wikilinks.length, 0)}`);\n      console.log(`Tags: ${new Set(docs.flatMap((d: any) => d.tags)).size} unique`);\n      process.exit(0);\n    }\n\n    if (opts.reindex) {\n      const { createServer } = await import(\"../mcp/server.js\");\n      await createServer(notesPath, {\n        watch: false,\n        waitForReady: true,\n        model: opts.model,\n        workers: opts.workers,\n        batchSize: opts.batchSize,\n        onProgress: (embedded, total) => {\n          process.stderr.write(`\\rEmbedding ${embedded}/${total} chunks...`);\n        },\n      });\n      process.stderr.write(\"\\n\");\n      console.log(\"Reindex complete.\");\n      process.exit(0);\n    }\n\n    // Default: start MCP server on stdio\n    const { startServer } = await import(\"../mcp/server.js\");\n    await startServer(notesPath, { watch: opts.watch, model: opts.model, workers: opts.workers, batchSize: opts.batchSize });\n  });\n\nprogram.parse();\n"],"mappings":"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","names":[]}

package/dist/mcp/server.js

@@ -4475,7 +4475,7 @@ async function createServer(notesPath, options = {}) {
   const cached = await tryLoadCachedIndex();
   if (options.waitForReady) {
     await fullIndex();
-  } else {
+  } else if (!cached) {
     backgroundIndex();
   }
   if (options.watch !== false) {