@contextful-com/contextful-mcp 0.10.0 → 0.12.0

package/README.md

@@ -28,7 +28,9 @@ To choose an agent explicitly, add `--client codex` or `--client claude`.
 
 Copy this prompt and replace the Hub URL:
 
-> Install Contextful for this project using https://YOUR-HUB and the official
+> First run `node --version`. If Node is missing or older than 24, stop and tell
+> me to install Node.js 24 or later from nodejs.org, then to ask you again.
+> Otherwise, install Contextful for this project using https://YOUR-HUB and the official
 > @contextful-com/contextful-mcp npm package. Run its `install --plan --json` first
 > and show me what it found and every decision it lists. Ask me all of them at once,
 > then install with my answers. Guide me through browser sign-in. Never answer a
@@ -36,24 +38,31 @@ Copy this prompt and replace the Hub URL:
 
 Instructions for the installing agent:
 
-1. From the project, run
+1. Run `node --version` before anything else. If the command is not found, or the
+   version is below v24, stop: nothing has changed yet. Tell the person to install
+   Node.js 24 or later (from nodejs.org, `brew install node` on macOS, or
+   `winget install OpenJS.NodeJS.LTS` on Windows), open a new terminal or agent
+   session, and ask again.
+2. From the project, run
    `npx -y @contextful-com/contextful-mcp@latest install --hub <URL> --plan --json`.
    It changes nothing and needs no network. Show the person its `plan` items: what
    is ready (`ok`), what must change first (`blocked`, with a `code`), each
    `decision` with its `question` and the `flag` that answers it, and `info` items
    such as an agent that is installed but does not start (`client_unusable`, with
    the file in `details.executable`).
-2. Ask every decision at once: which agent (`--client claude|codex|both|none`), starting a
+3. Ask every decision at once: which agent (`--client claude|codex|both|none`), starting a
    Git repository when the folder has none (`--start-repository`), uploading
    committed history (`--yes`), private prompt history (`--history` or
-   `--no-history`), automatic updates (`--auto-refresh`), and lesson sharing
-   (`--share-lessons` or `--no-share-lessons`). `npx -y` only accepts npm's package
+   `--no-history`), automatic updates (`--auto-refresh`), lesson sharing
+   (`--share-lessons` or `--no-share-lessons`), and, when Claude's desktop app still
+   starts an older Contextful, removing that entry
+   (`--remove-stale-claude-desktop-entry`). `npx -y` only accepts npm's package
    download; the install command's `--yes` approves the upload and nothing else.
-3. Run `install --hub <URL>` with the answers as flags, plus `--scope repo` (leave it
+4. Run `install --hub <URL>` with the answers as flags, plus `--scope repo` (leave it
    out with `--client none`) and `--project . --json --no-open --no-wait`. Use a long timeout or run it in the background: show
    `authorization_required`'s link and code at once and keep the process running
    while the person signs in. Never request passwords or read stored tokens.
-4. If an `error` event arrives, act on its `kind`:
+5. If an `error` event arrives, act on its `kind`:
    - `needs_person`: put its `ask` to the person; run its `rerun` (prefixed with
      this npm package) only with their answer. This covers upload consent, starting
      a repository, installing Git (show `details.steps`; the person runs any sudo
@@ -64,7 +73,7 @@ Instructions for the installing agent:
    - `retry`: rerun the same command; completed steps are kept.
    - `unsupported`: explain it (`details.lines`) and stop. Retrying cannot help.
    `contextful-mcp help <code>` explains any code.
-5. After `complete`, report the installed agent, its activation `actions` and the
+6. After `complete`, report the installed agent, its activation `actions` and the
    repository's Hub link (`repository.url`), and relay `learned` (what Contextful
    found different in this repository) when present. When `repository.state` is
    `building`, training is still running or not confirmed ready: say so, never call

package/native-manifest.json

@@ -1,36 +1,36 @@
 {
   "schemaVersion": 1,
-  "version": "0.10.0",
+  "version": "0.12.0",
   "targets": {
     "darwin-arm64": {
       "package": "@contextful-com/contextful-mcp-darwin-arm64",
       "executable": "bin/contextful-mcp",
-      "sha256": "2f3c9e99348559f83f4223911616fd5a1541f5e91420b33d2397acbd665cc3c5",
-      "size": 65826546
+      "sha256": "93a4db34c5a026f4713c670215a701328232bc66064defc45f5bb3a33814aef0",
+      "size": 93585122
     },
     "darwin-x64": {
       "package": "@contextful-com/contextful-mcp-darwin-x64",
       "executable": "bin/contextful-mcp",
-      "sha256": "77f6846cabfcb942ea2a3bfdf3748e86247fde4178cfe95c4295daacb60749ce",
-      "size": 72904976
+      "sha256": "b4bfba5e474ba93adbe4b87cfdf7ad389f2baeb1029d1b1da6d2562ee969240c",
+      "size": 102559200
     },
     "linux-arm64": {
       "package": "@contextful-com/contextful-mcp-linux-arm64",
       "executable": "bin/contextful-mcp",
-      "sha256": "8df83dcec26716b88843fcad7eef3209e59bc3553557888f854c6860ad5857d5",
-      "size": 84855080
+      "sha256": "906c4d093d4f6460842005a4ee1ff9797d55cac55070a852c51379c1de20ca63",
+      "size": 113626104
     },
     "linux-x64": {
       "package": "@contextful-com/contextful-mcp-linux-x64",
       "executable": "bin/contextful-mcp",
-      "sha256": "1727f8093e6122590b5c49b31a9ee01c50eb9b7d0b8da89a1818d0cf52904835",
-      "size": 84895200
+      "sha256": "c4b5115cff7708cbcd54ecd29c06087c611abc4f5424dd83cd5c885357fd271f",
+      "size": 113522864
     },
     "win32-x64": {
       "package": "@contextful-com/contextful-mcp-win32-x64",
       "executable": "bin/contextful-mcp.exe",
-      "sha256": "bfec6808f21e8c6f6fa245cec287e738ae83969f079ebc6d905aaf7065ef2425",
-      "size": 89667584
+      "sha256": "8d649b8da05c44f64860021e518a54d6e43825a802118c958ab60bf77b993844",
+      "size": 119672832
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contextful-com/contextful-mcp",
-  "version": "0.10.0",
+  "version": "0.12.0",
   "license": "UNLICENSED",
   "repository": {
     "type": "git",
@@ -23,10 +23,10 @@
     "native-manifest.json"
   ],
   "optionalDependencies": {
-    "@contextful-com/contextful-mcp-darwin-arm64": "0.10.0",
-    "@contextful-com/contextful-mcp-darwin-x64": "0.10.0",
-    "@contextful-com/contextful-mcp-linux-arm64": "0.10.0",
-    "@contextful-com/contextful-mcp-linux-x64": "0.10.0",
-    "@contextful-com/contextful-mcp-win32-x64": "0.10.0"
+    "@contextful-com/contextful-mcp-darwin-arm64": "0.12.0",
+    "@contextful-com/contextful-mcp-darwin-x64": "0.12.0",
+    "@contextful-com/contextful-mcp-linux-arm64": "0.12.0",
+    "@contextful-com/contextful-mcp-linux-x64": "0.12.0",
+    "@contextful-com/contextful-mcp-win32-x64": "0.12.0"
   }
 }