@roomi-fields/notebooklm-mcp 1.7.0 → 1.7.2

package/README.md

@@ -4,7 +4,7 @@
 
 **Automate Google NotebookLM at scale. 33-endpoint HTTP REST API for n8n / Zapier / Make / curl, plus an MCP server for Claude Code / Cursor / Codex. Citation-backed Q&A, full Studio generation (audio · video · infographic · report · presentation · data table), multi-account rotation with auto-reauth.**
 
-> v1.7.0 — production-grade, batch-tested on overnight runs of 1 000+ questions. New: `batch_to_vault` is now a first-class MCP tool (no HTTP server required) on top of the existing `POST /batch-to-vault` endpoint. See [RTFM integration](./deployment/docs/14-RTFM-INTEGRATION.md) for the full pattern. [Compare with `PleasePrompto/notebooklm-mcp` v2.0.0](https://roomi-fields.github.io/notebooklm-mcp/compare) to see when this project is the right pick (REST API, full Studio, auto-reauth) and when the MCP-only upstream is.
+> v1.7.2 — production-grade, batch-tested on overnight runs of 1 000+ questions. New: `batch_to_vault` is now a first-class MCP tool (no HTTP server required) on top of the existing `POST /batch-to-vault` endpoint. See [RTFM integration](./deployment/docs/14-RTFM-INTEGRATION.md) for the full pattern. [Compare with `PleasePrompto/notebooklm-mcp` v2.0.0](https://roomi-fields.github.io/notebooklm-mcp/compare) to see when this project is the right pick (REST API, full Studio, auto-reauth) and when the MCP-only upstream is.
 
 <!-- Badges -->
 
@@ -72,6 +72,17 @@ Generate multiple content types from your notebook sources:
 
 ## Quick Start
 
+### Option 0 — Claude Code marketplace (one-liner, recommended for Claude Code users)
+
+The fastest way to get NotebookLM into Claude Code. Distributed via the [`roomi-fields/claude-plugins`](https://github.com/roomi-fields/claude-plugins) marketplace alongside [RTFM](https://github.com/roomi-fields/rtfm) (the retrieval companion — see [RTFM integration guide](./deployment/docs/14-RTFM-INTEGRATION.md)):
+
+```text
+/plugin marketplace add roomi-fields/claude-plugins
+/plugin install notebooklm@roomi-fields
+```
+
+That registers the MCP server, runs `npx -y @roomi-fields/notebooklm-mcp` automatically on first use (Node ≥ 18 required), and keeps you in sync with releases via `/plugin update`. Then run `npm run setup-auth` once to log into Google. To install RTFM at the same time: `/plugin install rtfm@roomi-fields`.
+
 ### Option 1 — HTTP REST API (n8n, Zapier, Make, curl, any HTTP client)
 
 ```bash
@@ -163,6 +174,7 @@ See [ROADMAP.md](./ROADMAP.md) for planned features and version history.
 
 **Latest releases:**
 
+- **v1.7.2** — Claude Code plugin manifest (`.claude-plugin/plugin.json`) + cross-file version sync script enforced in CI; README "Install via Claude Code marketplace" one-liner
 - **v1.7.0** — `batch_to_vault` exposed as a first-class MCP tool (parity with the HTTP endpoint, no localhost server required); shared `runBatchToVault` helper deduplicates the loop across both transports
 - **v1.6.0** — `/batch-to-vault` endpoint + RTFM integration (`nblm-answer-v1` JSON Schema published at [schemas.roomi-fields.com/nblm-answer-v1.json](https://schemas.roomi-fields.com/nblm-answer-v1.json)) for caching NotebookLM answers as a searchable markdown vault
 - **v1.5.9** — Restore `mcpName` field for MCP Registry npm-package ownership verification

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@roomi-fields/notebooklm-mcp",
-  "version": "1.7.0",
+  "version": "1.7.2",
   "mcpName": "io.github.roomi-fields/notebooklm-mcp",
   "description": "MCP server for NotebookLM API with HTTP REST API - Zero hallucinations from your notebooks",
   "type": "module",
@@ -20,6 +20,8 @@
     "dev:http": "tsx watch src/http-wrapper.ts",
     "dev:proxy": "tsx watch src/stdio-http-proxy.ts",
     "build": "tsc && npm run build:i18n",
+    "version:sync": "node scripts/sync-version.mjs",
+    "version:check": "node scripts/sync-version.mjs --check",
     "build:i18n": "node -e \"require('fs').cpSync('src/i18n', 'dist/i18n', {recursive: true, filter: (s) => s.endsWith('.json') || require('fs').statSync(s).isDirectory()})\"",
     "watch": "tsc --watch",
     "dev": "tsx watch src/index.ts",

package/scripts/sync-version.mjs

@@ -0,0 +1,95 @@
+#!/usr/bin/env node
+/**
+ * Sync the version from package.json to every other file that ships it:
+ *   - .claude-plugin/plugin.json   (Claude Code plugin manifest)
+ *   - website/docusaurus.config.ts (schema.org softwareVersion)
+ *   - README.md                    (hero "v1.x.x — ..." line)
+ *
+ * Usage:
+ *   node scripts/sync-version.mjs           # rewrite drifted files in place
+ *   node scripts/sync-version.mjs --check   # exit 1 if anything would change (CI guard)
+ *
+ * Run after bumping package.json. The CI release workflow runs --check so a
+ * release can never ship with a stale plugin manifest or website badge.
+ */
+
+import { readFileSync, writeFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+
+const ROOT = join(dirname(fileURLToPath(import.meta.url)), '..');
+const checkOnly = process.argv.includes('--check');
+
+const pkg = JSON.parse(readFileSync(join(ROOT, 'package.json'), 'utf-8'));
+const VERSION = pkg.version;
+if (!VERSION) {
+  console.error('package.json has no version field');
+  process.exit(2);
+}
+
+/** @type {Array<{path: string, label: string, transform: (s: string) => string}>} */
+const targets = [
+  {
+    path: '.claude-plugin/plugin.json',
+    label: 'plugin manifest',
+    // Regex replace (not reparse+reserialize) so prettier-controlled
+    // formatting decisions (e.g. keywords array on one line vs many) are
+    // preserved between releases and don't trigger phantom drift.
+    transform: (s) =>
+      s.replace(
+        /^(\s*"version":\s*)"\d+\.\d+\.\d+"/m,
+        `$1"${VERSION}"`
+      ),
+  },
+  {
+    path: 'website/docusaurus.config.ts',
+    label: 'docusaurus softwareVersion',
+    transform: (s) =>
+      s.replace(
+        /softwareVersion:\s*'[^']+'/,
+        `softwareVersion: '${VERSION}'`
+      ),
+  },
+  {
+    path: 'README.md',
+    label: 'README hero version',
+    transform: (s) =>
+      s.replace(/(>\s*v)\d+\.\d+\.\d+(\s+—)/, `$1${VERSION}$2`),
+  },
+];
+
+let drifted = 0;
+for (const target of targets) {
+  const fullPath = join(ROOT, target.path);
+  const original = readFileSync(fullPath, 'utf-8');
+  const updated = target.transform(original);
+
+  if (original === updated) {
+    console.log(`✓ ${target.path} already at ${VERSION} (${target.label})`);
+    continue;
+  }
+
+  drifted++;
+  if (checkOnly) {
+    console.error(`✗ DRIFT in ${target.path} (${target.label})`);
+  } else {
+    writeFileSync(fullPath, updated, 'utf-8');
+    console.log(`→ ${target.path} synced to ${VERSION} (${target.label})`);
+  }
+}
+
+if (checkOnly && drifted > 0) {
+  console.error(
+    `\n${drifted} file(s) out of sync with package.json@${VERSION}. ` +
+      `Run "npm run version:sync" locally and commit.`
+  );
+  process.exit(1);
+}
+
+if (!checkOnly) {
+  console.log(
+    drifted === 0
+      ? `\nAll files already at ${VERSION}.`
+      : `\nSynced ${drifted} file(s) to ${VERSION}.`
+  );
+}