@contextful-com/contextful-mcp 0.9.0 → 0.11.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,34 +38,42 @@ 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
-     step), choosing an organization, and an agent sandbox that blocks the network
-     or a write (ask to run outside the sandbox).
+     step), choosing an organization, whether this folder is the same project as a
+     repository on the Hub or a fork or copy of it (`--join` or `--fork`), and an
+     agent sandbox that blocks the network or a write (ask to run outside the sandbox).
    - `fix_and_rerun`: tell the person what the message names, then rerun.
    - `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.9.0",
+  "version": "0.11.0",
   "targets": {
     "darwin-arm64": {
       "package": "@contextful-com/contextful-mcp-darwin-arm64",
       "executable": "bin/contextful-mcp",
-      "sha256": "29b72d5d580a36ac8afd57c4a6efc06eb886e81ba6d967faafdca35b6792632e",
-      "size": 65595378
+      "sha256": "3b9bf02900eda424824fb3f5c27e3bf25f4f4c03aa5917321b46f457cf5a5c1d",
+      "size": 65991666
     },
     "darwin-x64": {
       "package": "@contextful-com/contextful-mcp-darwin-x64",
       "executable": "bin/contextful-mcp",
-      "sha256": "2ac0c4d10d58786354b3a43288c50e3bf700579f5414949b7fea70e72dcfb847",
-      "size": 72675600
+      "sha256": "d799d5f5eb4f0fbaf97248c7c90932338cbfda8a5b3e70a21ec68945f53340b3",
+      "size": 73068816
     },
     "linux-arm64": {
       "package": "@contextful-com/contextful-mcp-linux-arm64",
       "executable": "bin/contextful-mcp",
-      "sha256": "f7ecac7b232609b5bdbf7f1365a057493209ce936f92650564534a600f40225d",
-      "size": 84658472
+      "sha256": "be1e7d5dbefaaf4ea76e7387644da2f0e3fdc05795925d76aa4b1f3f24f6ab85",
+      "size": 85051688
     },
     "linux-x64": {
       "package": "@contextful-com/contextful-mcp-linux-x64",
       "executable": "bin/contextful-mcp",
-      "sha256": "cc5aa42510cc6a1c25e99ccf3bf91ecef0c0493d5c70353ceb25db6a32d32892",
-      "size": 84661728
+      "sha256": "d7d68a5ab6f987df72f7e1df933487b273ec40d233b3972a83a303a85abbaaa0",
+      "size": 85063136
     },
     "win32-x64": {
       "package": "@contextful-com/contextful-mcp-win32-x64",
       "executable": "bin/contextful-mcp.exe",
-      "sha256": "4106c83e7f57ee9739c14b9cb25307e04a50fdbd7dd4dabcae11a02039b00526",
-      "size": 89435136
+      "sha256": "ddc1f1840ae384e2db1083fb35daaae4778ee7db99e3a34bb1b7bbe95830c233",
+      "size": 89835008
     }
   }
 }

package/package.json

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