@contextful-com/contextful-mcp-darwin-arm64 0.2.1 → 0.2.2

package/README.md

@@ -18,6 +18,9 @@ organization; otherwise, choose an organization by name. It asks before uploadin
 committed repository history. Private prompt history and usage are opt-in.
 It then asks whether to upload new commits on your default branch automatically
 and, when your Hub offers it, whether to share the lessons your agent writes down.
+In a folder that is not a Git repository yet, it offers to start one with a first
+commit; without Git, it offers to install it. `contextful-mcp help codes` explains
+every reason install can stop.
 
 To choose an agent explicitly, add `--client codex` or `--client claude`.
 
@@ -26,36 +29,47 @@ 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
-> @contextful-com/contextful-mcp npm package. Use the current agent, or ask whether
-> I want Codex or Claude Code. Guide me through browser sign-in and complete the
-> MCP, hooks, and skills installation. Ask before uploading repository history,
-> turning on automatic updates, or sharing lessons.
+> @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
+> question for me and never run a sudo step for me.
 
 Instructions for the installing agent:
 
-- Run the package's `install --hub <URL>` command from the project and supply
-  `--client codex` or `--client claude`. Use `--scope repo --project .` for this
-  project, and `--json --no-open --no-wait --no-history` to handle progress and
-  keep private history local. If no project is available, ask which folder to use.
-- `npx -y` accepts npm's package download prompt. The install command's `--yes`
-  separately approves committed-history upload; use it only after user approval.
-- `--yes` answers no other question. Ask whether to upload new commits on the
-  default branch automatically and whether to share the lessons the agent writes
-  down; add `--auto-refresh` and `--share-lessons` or `--no-share-lessons` only
-  after the user answers. Without them, automatic updates stay off.
-- Show `authorization_required`'s link and code immediately, and keep the process
-  running while the user signs in. Do not request passwords or read stored tokens.
-- On `organization_required`, ask the user to choose from the returned names;
-  supply the selected ID internally when resuming. On `consent_required`, obtain
-  approval for the stated Hub and upload, then resume with the returned arguments.
-  Prefix returned `contextful-mcp` commands with this npm package when needed.
-- After `complete`, report the installed agent and required activation actions.
-  Hub training may still be running. Do not report pending training as ready, or
-  bypass the agent's hook trust. Rerun the same install command to resume failures.
+1. 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`), and each
+   `decision` with its `question` and the `flag` that answers it.
+2. Ask every decision at once: which agent (`--client claude|codex|both`), 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
+   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 --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`:
+   - `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).
+   - `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 and its activation actions. Hub
+   training may still be running: do not report pending training as ready, and do
+   not bypass the agent's hook trust.
 
 ## Requirements
 
 - Node.js 24 or newer and npm to run the npm launcher.
+- Git, in a Git repository with at least one commit. In a terminal, install offers
+  to install Git and to start a repository in a folder that has none.
 - A supported Claude Code or Codex installation. The installer checks its version.
 - macOS ARM64/x64, Linux ARM64/x64 with glibc, or Windows x64.
 

package/bin/contextful-mcp

@@ -1,4 +1,4 @@
 [diffend] Oversized file quarantined before diffing.
 name: package/bin/contextful-mcp
-size: 65991666 bytes
-sha256: 0c0dad7b4e894ab6cd2d788da7bd0c22316b9f75c7d9a9f94dbbb8a3eee1fe4c
+size: 66041202 bytes
+sha256: 1f82d61fc3b18827d5ce4ad7e05d9cfc35108caa53b225fd19e848cbbb4ad573

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contextful-com/contextful-mcp-darwin-arm64",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "license": "UNLICENSED",
   "publishConfig": {
     "access": "public",