@theglitchking/semantic-pages 0.6.6 → 0.9.0

package/.claude-plugin/marketplace.json

@@ -6,13 +6,13 @@
   },
   "metadata": {
     "description": "Official marketplace for semantic-pages - Semantic search + knowledge graph MCP server with auto-wiring for .claude/.vault and hit-em-with-the-docs companion",
-    "version": "0.6.3"
+    "version": "0.9.0"
   },
   "plugins": [
     {
       "name": "semantic-pages",
       "description": "Semantic search + knowledge graph MCP server for markdown vaults. Auto-wires a read/write vault at .claude/.vault, and a read-only docs index at .documentation when hit-em-with-the-docs is also installed.",
-      "version": "0.6.3",
+      "version": "0.9.0",
       "author": {
         "name": "TheGlitchKing"
       },

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "semantic-pages",
   "description": "Semantic search + knowledge graph MCP server for markdown vaults. Auto-wires a read/write vault at .claude/.vault, and a read-only docs index at .documentation when hit-em-with-the-docs is also installed.",
-  "version": "0.6.3",
+  "version": "0.9.0",
   "author": {
     "name": "TheGlitchKing",
     "email": "theglitchking@users.noreply.github.com"

package/README.md

@@ -479,6 +479,113 @@ Each flow probes its MCP server independently and degrades gracefully when one i
 
 When you install `semantic-pages` via the Claude Code plugin marketplace or via npm, Claude Code picks up this skill automatically — no extra wiring required.
 
+### How auto-linking works *(0.7.0+)*
+
+When installed as an npm dependency, a `postinstall` script symlinks every directory under the package's `skills/` into your project's `.claude/skills/` (creating that directory if missing). Claude Code only scans `<project>/.claude/skills/` and `~/.claude/skills/` — it does not look inside `node_modules/` — so this link is what makes bundled skills discoverable.
+
+- The link is relative, pointing into `node_modules/@theglitchking/semantic-pages/skills/<name>`, and is refreshed on every install/update.
+- If a regular file or directory already exists at the destination (i.e. someone copied a skill manually), the script leaves it alone and prints a warning.
+- The script is a no-op when you're developing the plugin itself (`INIT_CWD` equals the package root), so the plugin never self-links into its own repo.
+- The linker never hard-fails an install — permission errors and odd filesystems downgrade to a warning.
+
+Add the linked skills to `.gitignore` so they don't get committed in consuming projects:
+
+```
+/.claude/skills/semantic-first/
+```
+
+**Opt-out**: set `SEMANTIC_PAGES_SKIP_LINK=1` to skip linking during install — useful if you want to manage `.claude/skills/` manually.
+
+```bash
+SEMANTIC_PAGES_SKIP_LINK=1 npm install @theglitchking/semantic-pages
+```
+
+---
+
+## Update Policy & Session-Start Hook *(0.8.0+)*
+
+When you install `semantic-pages` as an npm dependency, the postinstall step also:
+
+1. Writes `<project>/.claude/semantic-pages.json` with `{ "updatePolicy": "nudge" }` if one doesn't exist.
+2. Registers a `SessionStart` hook in `<project>/.claude/settings.json` — but **only** if `settings.json` exists and neither the Claude Code plugin nor an existing semantic-pages hook is already handling it.
+
+### What the hook does
+
+At the start of every Claude Code session, the hook:
+
+- Reconciles `.mcp.json` (the same `semantic-vault` + conditional `.documentation` wiring you'd get from the plugin).
+- Checks npm for a newer version of `@theglitchking/semantic-pages` (~3s budget, results cached for 6h, skipped in CI).
+- Acts on the result according to your policy.
+
+### Policies
+
+| Policy | Behavior |
+|--------|----------|
+| `nudge` *(default)* | Print a one-liner when a newer version is available. No changes. |
+| `auto`  | Run `npm update @theglitchking/semantic-pages`, re-link skills, print `⬆️ vX → vY`. |
+| `off`   | Silent — no update check. |
+
+### Setting the policy
+
+Preferred:
+
+```
+/semantic-pages:policy auto
+/semantic-pages:policy nudge
+/semantic-pages:policy off
+```
+
+Or from the terminal:
+
+```bash
+npx --no @theglitchking/semantic-pages policy auto
+```
+
+Resolution order:
+
+1. `SEMANTIC_PAGES_UPDATE_POLICY` env var (one-shot override).
+2. `<project>/.claude/semantic-pages.json` → `updatePolicy`.
+3. Default: `nudge`.
+
+### Plugin-command menu
+
+With `semantic-pages` installed (plugin or npm), you get these slash commands:
+
+| Command | Does |
+|---------|------|
+| `/semantic-pages:update`   | Runs `npm update`, re-links skills, reports before/after. |
+| `/semantic-pages:policy [auto\|nudge\|off]` | Get or set the update policy. |
+| `/semantic-pages:status`   | Installed version, latest on npm, policy, hook state. |
+| `/semantic-pages:relink`   | Re-symlink bundled skills into `.claude/skills/`. |
+
+Each has a CLI equivalent: `npx --no @theglitchking/semantic-pages <subcommand>`.
+
+### Dedup between plugin and npm installs
+
+If you install via **both** the Claude Code plugin and the npm dep, the postinstall detects the plugin in `~/.claude/settings.json` → `enabledPlugins` and skips the settings.json hook registration. One hook fires per session, not two. If you later uninstall the plugin, the next `npm install` re-registers the project-level hook.
+
+### Opt-out
+
+```bash
+# Skip settings.json hook registration:
+SEMANTIC_PAGES_SKIP_HOOK_REGISTER=1 npm install @theglitchking/semantic-pages
+
+# Skip skill symlinking:
+SEMANTIC_PAGES_SKIP_LINK=1 npm install @theglitchking/semantic-pages
+```
+
+### Uninstalling cleanly
+
+```bash
+# 1. Remove the hook entry from .claude/settings.json (look for any SessionStart
+#    entry whose command references "semantic-pages").
+# 2. Remove the policy file:
+rm .claude/semantic-pages.json
+
+# 3. Remove the package:
+npm uninstall @theglitchking/semantic-pages
+```
+
 ---
 
 ## Common Workflows

package/commands/policy.md

@@ -0,0 +1,16 @@
+---
+description: Get or set the semantic-pages update policy (auto | nudge | off)
+allowed-tools: Bash(npx:*)
+argument-hint: "[auto|nudge|off]"
+---
+
+Arguments: $ARGUMENTS
+
+- If `$ARGUMENTS` is empty, run `npx --no @theglitchking/semantic-pages policy` and report the current policy and config path.
+- If `$ARGUMENTS` is one of `auto`, `nudge`, `off`, run `npx --no @theglitchking/semantic-pages policy $ARGUMENTS` and confirm the new setting to the user.
+- If `$ARGUMENTS` is anything else, tell the user the valid values are `auto`, `nudge`, `off`.
+
+Policies:
+- `auto`  — auto-run `npm update @theglitchking/semantic-pages` at session start when a newer version is available.
+- `nudge` — print a one-liner when a newer version is available (default).
+- `off`   — do not check for updates.

package/commands/relink.md

@@ -0,0 +1,6 @@
+---
+description: Re-run the skill linker — refresh symlinks from node_modules into .claude/skills/
+allowed-tools: Bash(npx:*)
+---
+
+Run `npx --no @theglitchking/semantic-pages relink` and report the result.

package/commands/status.md

@@ -0,0 +1,6 @@
+---
+description: Show installed version, latest available version, current update policy, and hook registration state
+allowed-tools: Bash(npx:*)
+---
+
+Run `npx --no @theglitchking/semantic-pages status` and relay the output to the user verbatim.

package/commands/update.md

@@ -0,0 +1,6 @@
+---
+description: Update semantic-pages to the latest version (runs npm update + re-links skills)
+allowed-tools: Bash(npx:*)
+---
+
+Run `npx --no @theglitchking/semantic-pages update` and report the before/after versions to the user. If the project doesn't have a local install, fall back to `npx -y @theglitchking/semantic-pages update` and note that in your summary.

package/dist/cli/index.js

@@ -2,10 +2,27 @@
 
 // src/cli/index.ts
 import { program } from "commander";
-import { resolve } from "path";
+import { resolve, join } from "path";
 import { existsSync } from "fs";
 import { createRequire } from "module";
-var { version } = createRequire(import.meta.url)("../../package.json");
+import { spawnSync } from "child_process";
+import { registerUpdateCommands } from "@theglitchking/claude-plugin-runtime";
+var require_ = createRequire(import.meta.url);
+var { version } = require_("../../package.json");
+var PKG_NAME = "@theglitchking/semantic-pages";
+function runRelink(cwd) {
+  const linker = join(cwd, "node_modules", "@theglitchking", "semantic-pages", "scripts", "link-skills.js");
+  const script = existsSync(linker) ? linker : resolve(process.cwd(), "scripts", "link-skills.js");
+  if (!existsSync(script)) {
+    console.error("link-skills.js not found \u2014 is the package installed?");
+    return;
+  }
+  spawnSync(process.execPath, [script], {
+    cwd,
+    env: { ...process.env, INIT_CWD: cwd },
+    stdio: "inherit"
+  });
+}
 var TOOL_HELP = {
   // Search
   search_semantic: {
@@ -254,5 +271,11 @@ program.command("serve", { isDefault: true }).description("Start the MCP server
     readOnly: opts.readOnly
   });
 });
+registerUpdateCommands(program, {
+  packageName: PKG_NAME,
+  pluginName: "semantic-pages",
+  configFile: "semantic-pages.json",
+  onAfterUpdate: (cwd) => runRelink(cwd)
+});
 program.parse();
 //# sourceMappingURL=index.js.map

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\";\nimport { createRequire } from \"node:module\";\n\nconst { version } = createRequire(import.meta.url)(\"../../package.json\") as { version: string };\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(version);\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(\"--wait-for-ready\", \"Block startup until index is fully built before serving (default: index in background; tools return 'Indexing in progress' until ready)\")\n  .option(\"--read-only\", \"Suppress write tools (create_note, update_note, delete_note, move_note, update_frontmatter, manage_tags, rename_tag) — use for shared docs vaults owned by another tool\")\n  .option(\"--model <name>\", \"Embedding model to use (default: all-MiniLM-L6-v2, fast; use nomic-ai/nomic-embed-text-v1.5 for higher quality)\")\n  .option(\"--workers <n>\", \"Number of worker threads for parallel embedding\", parseInt)\n  .option(\"--batch-size <n>\", \"Texts per ONNX forward pass (default: 8)\", parseInt)\n  .option(\"--no-quantized\", \"Use full-precision model instead of quantized (slower, slightly higher quality)\")\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        quantized: opts.quantized,\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, {\n      watch: opts.watch,\n      waitForReady: opts.waitForReady,\n      model: opts.model,\n      workers: opts.workers,\n      batchSize: opts.batchSize,\n      quantized: opts.quantized,\n      readOnly: opts.readOnly,\n    });\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, join } from \"node:path\";\nimport { existsSync } from \"node:fs\";\nimport { createRequire } from \"node:module\";\nimport { spawnSync } from \"node:child_process\";\nimport { registerUpdateCommands } from \"@theglitchking/claude-plugin-runtime\";\n\nconst require_ = createRequire(import.meta.url);\nconst { version } = require_(\"../../package.json\") as { version: string };\n\nconst PKG_NAME = \"@theglitchking/semantic-pages\";\n\nfunction runRelink(cwd: string) {\n  const linker = join(cwd, \"node_modules\", \"@theglitchking\", \"semantic-pages\", \"scripts\", \"link-skills.js\");\n  const script = existsSync(linker) ? linker : resolve(process.cwd(), \"scripts\", \"link-skills.js\");\n  if (!existsSync(script)) {\n    console.error(\"link-skills.js not found — is the package installed?\");\n    return;\n  }\n  spawnSync(process.execPath, [script], {\n    cwd,\n    env: { ...process.env, INIT_CWD: cwd },\n    stdio: \"inherit\",\n  });\n}\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(version);\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(\"--wait-for-ready\", \"Block startup until index is fully built before serving (default: index in background; tools return 'Indexing in progress' until ready)\")\n  .option(\"--read-only\", \"Suppress write tools (create_note, update_note, delete_note, move_note, update_frontmatter, manage_tags, rename_tag) — use for shared docs vaults owned by another tool\")\n  .option(\"--model <name>\", \"Embedding model to use (default: all-MiniLM-L6-v2, fast; use nomic-ai/nomic-embed-text-v1.5 for higher quality)\")\n  .option(\"--workers <n>\", \"Number of worker threads for parallel embedding\", parseInt)\n  .option(\"--batch-size <n>\", \"Texts per ONNX forward pass (default: 8)\", parseInt)\n  .option(\"--no-quantized\", \"Use full-precision model instead of quantized (slower, slightly higher quality)\")\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        quantized: opts.quantized,\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, {\n      watch: opts.watch,\n      waitForReady: opts.waitForReady,\n      model: opts.model,\n      workers: opts.workers,\n      batchSize: opts.batchSize,\n      quantized: opts.quantized,\n      readOnly: opts.readOnly,\n    });\n  });\n\nregisterUpdateCommands(program, {\n  packageName: PKG_NAME,\n  pluginName: \"semantic-pages\",\n  configFile: \"semantic-pages.json\",\n  onAfterUpdate: (cwd) => runRelink(cwd),\n});\n\nprogram.parse();\n"],"mappings":"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","names":[]}

package/hooks/hooks.json

@@ -1,12 +1,12 @@
 {
-  "description": "semantic-pages SessionStart hook — auto-wires .claude/.vault and, when hit-em-with-the-docs is installed, adds a read-only .documentation index",
+  "description": "semantic-pages SessionStart hook — reconciles .mcp.json wiring and nudges/auto-updates per policy.",
   "hooks": {
     "SessionStart": [
       {
         "hooks": [
           {
             "type": "command",
-            "command": "bash \"${CLAUDE_PLUGIN_ROOT}/hooks/session-start.sh\""
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/session-start.js\""
           }
         ]
       }

package/hooks/reconcile.js

@@ -0,0 +1,90 @@
+// Plugin-specific SessionStart reconciliation for semantic-pages.
+//
+// Ensures <project>/.claude/.vault exists. Reconciles .mcp.json so the
+// "semantic-vault" entry always points at ./.claude/.vault, and adds
+// (or removes) a read-only "semantic-pages" entry pointed at
+// ./.documentation only when hit-em-with-the-docs is enabled and the
+// .documentation directory exists.
+//
+// Idempotent: only writes .mcp.json when the computed JSON differs from
+// what's on disk.
+
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+
+const PKG = "@theglitchking/semantic-pages";
+
+function readJson(path, fallback = null) {
+  try {
+    const raw = readFileSync(path, "utf8");
+    return raw.trim() ? JSON.parse(raw) : fallback;
+  } catch {
+    return fallback;
+  }
+}
+
+function hewtdEnabled() {
+  const settings = readJson(join(homedir(), ".claude", "settings.json"));
+  const enabled = settings?.enabledPlugins || {};
+  return Object.keys(enabled).some(
+    (k) => k.startsWith("hit-em-with-the-docs@") && enabled[k] === true,
+  );
+}
+
+export function reconcile(projectRoot) {
+  const vaultDir = join(projectRoot, ".claude", ".vault");
+  const docsDir = join(projectRoot, ".documentation");
+  const mcpPath = join(projectRoot, ".mcp.json");
+
+  try { mkdirSync(vaultDir, { recursive: true }); } catch {}
+
+  const docsWired = hewtdEnabled() && existsSync(docsDir);
+
+  let data = { mcpServers: {} };
+  if (existsSync(mcpPath)) {
+    const parsed = readJson(mcpPath, null);
+    if (parsed === null) {
+      let raw = "";
+      try { raw = readFileSync(mcpPath, "utf8"); } catch {}
+      if (raw.trim()) {
+        process.stderr.write(`semantic-pages hook: could not parse ${mcpPath}; leaving untouched\n`);
+        return;
+      }
+    } else if (parsed && typeof parsed === "object") {
+      data = parsed;
+      if (!data.mcpServers || typeof data.mcpServers !== "object") {
+        data.mcpServers = {};
+      }
+    }
+  }
+
+  const before = JSON.stringify(data);
+
+  data.mcpServers["semantic-vault"] = {
+    type: "stdio",
+    command: "npx",
+    args: ["-y", `${PKG}@latest`, "--notes", "./.claude/.vault"],
+  };
+
+  if (docsWired) {
+    data.mcpServers["semantic-pages"] = {
+      type: "stdio",
+      command: "npx",
+      args: ["-y", `${PKG}@latest`, "--notes", "./.documentation", "--read-only"],
+    };
+  } else if (data.mcpServers["semantic-pages"]) {
+    const existing = data.mcpServers["semantic-pages"];
+    const args = Array.isArray(existing.args) ? existing.args : [];
+    const looksLikeOurs = args.some(
+      (a) => typeof a === "string" && a.includes(".documentation"),
+    );
+    if (looksLikeOurs) delete data.mcpServers["semantic-pages"];
+  }
+
+  const after = JSON.stringify(data);
+  if (after === before) return;
+
+  mkdirSync(dirname(mcpPath), { recursive: true });
+  writeFileSync(mcpPath, JSON.stringify(data, null, 2) + "\n");
+}

package/hooks/session-start.js

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+// semantic-pages SessionStart hook. Delegates lifecycle + update-check to
+// @theglitchking/claude-plugin-runtime; plugin-specific .mcp.json wiring
+// lives in ./reconcile.js.
+
+import { runSessionStart } from "@theglitchking/claude-plugin-runtime";
+import { reconcile } from "./reconcile.js";
+
+await runSessionStart({
+  packageName: "@theglitchking/semantic-pages",
+  pluginName: "semantic-pages",
+  configFile: "semantic-pages.json",
+  reconcile,
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theglitchking/semantic-pages",
-  "version": "0.6.6",
+  "version": "0.9.0",
   "description": "Semantic search + knowledge graph MCP server for markdown vaults. Claude Code plugin with auto-wiring for .claude/.vault and read-only .documentation companion when hit-em-with-the-docs is installed.",
   "type": "module",
   "main": "./dist/core/index.js",
@@ -17,6 +17,8 @@
     "dist",
     ".claude-plugin",
     "hooks",
+    "commands",
+    "scripts/link-skills.js",
     "skills/semantic-first",
     "README.md",
     "LICENSE"
@@ -27,7 +29,8 @@
     "test": "vitest run",
     "test:watch": "vitest",
     "lint": "tsc --noEmit",
-    "prepublishOnly": "npm run build"
+    "prepublishOnly": "npm run build",
+    "postinstall": "node scripts/link-skills.js"
   },
   "keywords": [
     "mcp",
@@ -55,7 +58,7 @@
   "dependencies": {
     "@huggingface/transformers": "^4.0.1",
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "onnxruntime-web": "^1.24.3",
+    "@theglitchking/claude-plugin-runtime": "^0.1.0",
     "chokidar": "^5.0.0",
     "commander": "^14.0.3",
     "glob": "^13.0.6",
@@ -66,6 +69,7 @@
     "gray-matter": "^4.0.3",
     "hnswlib-node": "^3.0.0",
     "minimatch": "^10.2.5",
+    "onnxruntime-web": "^1.24.3",
     "remark-parse": "^11.0.0",
     "remark-wiki-link": "^2.0.1",
     "unified": "^11.0.5"

package/scripts/link-skills.js

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+// Postinstall — delegates to @theglitchking/claude-plugin-runtime.
+// The runtime handles: skill symlinking, default policy config write, and
+// settings.json hook registration with plugin/npm dedup. See the runtime's
+// docs/PLUGIN_AUTHORING_SCAFFOLD.md for the full contract.
+
+import { runPostinstall } from "@theglitchking/claude-plugin-runtime";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const packageRoot = resolve(dirname(fileURLToPath(import.meta.url)), "..");
+
+try {
+  runPostinstall({
+    packageName: "@theglitchking/semantic-pages",
+    pluginName: "semantic-pages",
+    configFile: "semantic-pages.json",
+    skillsDir: "skills",
+    packageRoot,
+    hookCommand:
+      "node ./node_modules/@theglitchking/semantic-pages/hooks/session-start.js",
+  });
+} catch (err) {
+  console.warn(`[semantic-pages] postinstall failed: ${err?.message || err}`);
+}

package/hooks/session-start.sh

@@ -1,147 +0,0 @@
-#!/usr/bin/env bash
-#
-# semantic-pages SessionStart hook
-#
-# Reconciles the project's .mcp.json so that:
-#   1. A "semantic-vault" entry always points at ./.claude/.vault (read/write).
-#   2. A "semantic-pages" entry points at ./.documentation (read-only) ONLY IF
-#      both conditions hold:
-#        - hit-em-with-the-docs is installed+enabled as a Claude Code plugin
-#        - ./.documentation/ exists in this project
-#      Otherwise any stale "semantic-pages" entry is removed.
-#
-# Idempotent: only writes .mcp.json when the computed JSON differs from disk.
-# Fails open: any error logs to stderr and exits 0 so Claude Code isn't blocked.
-#
-# Runs on every SessionStart event. Keeps wiring in sync with plugin state.
-
-set -u
-
-# Fail-open: if anything goes sideways, swallow and return the empty SessionStart
-# response so the session keeps going.
-trap 'emit_empty_response; exit 0' ERR
-
-emit_empty_response() {
-  # SessionStart hooks need to return JSON; empty additionalContext is fine.
-  printf '{"hookSpecificOutput":{"hookEventName":"SessionStart"}}\n'
-}
-
-log() {
-  printf 'semantic-pages hook: %s\n' "$*" >&2
-}
-
-# Project root is cwd when Claude Code invokes the hook.
-PROJECT_ROOT="${CLAUDE_PROJECT_DIR:-$PWD}"
-cd "$PROJECT_ROOT" || { emit_empty_response; exit 0; }
-
-VAULT_DIR="$PROJECT_ROOT/.claude/.vault"
-DOCS_DIR="$PROJECT_ROOT/.documentation"
-MCP_JSON="$PROJECT_ROOT/.mcp.json"
-CLAUDE_SETTINGS="$HOME/.claude/settings.json"
-
-# 1. Ensure .claude/.vault exists (idempotent).
-mkdir -p "$VAULT_DIR" 2>/dev/null || true
-
-# 2. Detect hit-em-with-the-docs: must be listed in enabledPlugins in
-#    ~/.claude/settings.json (covers any marketplace source).
-HEWTD_ENABLED=0
-if [ -f "$CLAUDE_SETTINGS" ]; then
-  if node -e '
-    const fs = require("fs");
-    try {
-      const s = JSON.parse(fs.readFileSync(process.argv[1], "utf8"));
-      const enabled = s.enabledPlugins || {};
-      const hit = Object.keys(enabled).some(
-        (k) => k.startsWith("hit-em-with-the-docs@") && enabled[k] === true
-      );
-      process.exit(hit ? 0 : 1);
-    } catch { process.exit(1); }
-  ' "$CLAUDE_SETTINGS" 2>/dev/null; then
-    HEWTD_ENABLED=1
-  fi
-fi
-
-# 3. Docs MCP entry is conditional on BOTH hewtd enabled AND .documentation present.
-DOCS_WIRED=0
-if [ "$HEWTD_ENABLED" = "1" ] && [ -d "$DOCS_DIR" ]; then
-  DOCS_WIRED=1
-fi
-
-# 4. Reconcile .mcp.json using node (cross-platform JSON edit, idempotent write).
-node - "$MCP_JSON" "$DOCS_WIRED" <<'NODE' || { log "reconcile failed"; emit_empty_response; exit 0; }
-const fs = require("fs");
-const path = require("path");
-const [, , mcpPath, docsWiredArg] = process.argv;
-const docsWired = docsWiredArg === "1";
-
-let data = { mcpServers: {} };
-if (fs.existsSync(mcpPath)) {
-  try {
-    const raw = fs.readFileSync(mcpPath, "utf8");
-    const parsed = raw.trim() ? JSON.parse(raw) : {};
-    if (parsed && typeof parsed === "object") data = parsed;
-    if (!data.mcpServers || typeof data.mcpServers !== "object") data.mcpServers = {};
-  } catch (err) {
-    // Corrupt .mcp.json — leave it alone and emit a note to stderr
-    process.stderr.write(
-      `semantic-pages hook: could not parse ${mcpPath} (${err.message}); leaving untouched\n`
-    );
-    process.exit(0);
-  }
-}
-
-// Canonical entries
-const vaultEntry = {
-  type: "stdio",
-  command: "npx",
-  args: [
-    "-y",
-    "@theglitchking/semantic-pages@latest",
-    "--notes",
-    "./.claude/.vault",
-  ],
-};
-
-const docsEntry = {
-  type: "stdio",
-  command: "npx",
-  args: [
-    "-y",
-    "@theglitchking/semantic-pages@latest",
-    "--notes",
-    "./.documentation",
-    "--read-only",
-  ],
-};
-
-const before = JSON.stringify(data);
-
-// Always ensure semantic-vault
-data.mcpServers["semantic-vault"] = vaultEntry;
-
-// semantic-pages (docs) is conditional
-if (docsWired) {
-  data.mcpServers["semantic-pages"] = docsEntry;
-} else if (data.mcpServers["semantic-pages"]) {
-  // Only remove if it looks like ours (points at .documentation). Don't clobber
-  // a user-custom entry under the same name.
-  const existing = data.mcpServers["semantic-pages"];
-  const args = Array.isArray(existing.args) ? existing.args : [];
-  const looksLikeOurs =
-    args.some((a) => typeof a === "string" && a.includes(".documentation"));
-  if (looksLikeOurs) delete data.mcpServers["semantic-pages"];
-}
-
-const after = JSON.stringify(data, null, 2) + "\n";
-
-// Only write if content actually changed — prevents needless git churn.
-if (JSON.stringify(JSON.parse(after)) === before) {
-  process.exit(0);
-}
-
-fs.mkdirSync(path.dirname(mcpPath), { recursive: true });
-fs.writeFileSync(mcpPath, after);
-NODE
-
-emit_empty_response
-exit 0