@visa/cli 5.0.0-rc.416 → 5.0.0-rc.418

package/install.ps1

@@ -188,15 +188,14 @@ foreach ($commandName in $cliCommandNames) {
 Write-Host ""
 if ($verifiedCommand) {
     Write-Host "  Visa CLI $visaVersion installed." -ForegroundColor Green
-    Write-Host "  Connect an AI client with: $verifiedCommand connect <client>" -ForegroundColor Cyan
-    # Same door as install.sh, same reason: this line used to name the retired
-    # setup ceremony. `pnpm lint:docs-sync` reads this file too.
-    Write-Host "  Then create your agent with: visa connect" -ForegroundColor Cyan
+    # Same one next step as install.sh: an angle-bracket placeholder is a redirection when
+    # pasted. `pnpm lint:docs-sync` reads this file too.
+    Write-Host "  Next: visa connect" -ForegroundColor Cyan
     Write-Host "  Or ask your agent to call its connect tool. You approve it in the browser." -ForegroundColor Cyan
     Write-Host ""
 } else {
     $primaryCommand = $cliCommandNames | Select-Object -First 1
     Write-Host "  Installed but '$primaryCommand' was not runnable from PATH yet." -ForegroundColor Yellow
-    Write-Host "  Close and reopen PowerShell, then run: $primaryCommand connect <client>" -ForegroundColor Yellow
+    Write-Host "  Close and reopen PowerShell, then run: visa connect" -ForegroundColor Yellow
     Write-Host ""
 }

package/install.sh

@@ -1,6 +1,6 @@
 #!/usr/bin/env bash
 # Visa CLI installer for macOS and Linux
-# Usage: curl -fsSL https://app.visacli.sh/cli | bash
+# Usage: bash -o pipefail -c 'curl -fsSL https://app.visacli.sh/cli | bash'
 #
 # The entire body is wrapped in _visa_install() so bash must parse the full
 # file before executing anything — prevents partial-download execution if
@@ -40,10 +40,7 @@ esac
 
 # ── check Node.js ─────────────────────────────────────────────────────────────
 if ! command -v node &>/dev/null; then
-  fail "Node.js is required but not installed.
-  Install from https://nodejs.org/ or use nvm:
-    curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
-    nvm install ${REQUIRED_NODE_MAJOR}"
+  fail "Install Node.js ${REQUIRED_NODE_MAJOR}+ from https://nodejs.org/."
 fi
 
 NODE_VERSION="$(node --version)"
@@ -55,8 +52,7 @@ case "$NODE_MAJOR" in
 esac
 
 if [ "$NODE_MAJOR" -lt "$REQUIRED_NODE_MAJOR" ]; then
-  fail "Node.js ${NODE_VERSION} is too old. Version ${REQUIRED_NODE_MAJOR}+ required.
-  Install from https://nodejs.org/ or:  nvm install ${REQUIRED_NODE_MAJOR}"
+  fail "Install Node.js ${REQUIRED_NODE_MAJOR}+ from https://nodejs.org/."
 fi
 
 ok "Node.js ${NODE_VERSION}"
@@ -76,16 +72,24 @@ NPM_OUTPUT=""
 NPM_EXIT=0
 NPM_OUTPUT="$(npm install -g "$PACKAGE" 2>&1)" || NPM_EXIT=$?
 
+# No permission to write npm's global folder (a system Node): install once more
+# under a folder this user owns, instead of handing back manual steps (T33).
+USER_PREFIX=""
+if [ "$NPM_EXIT" -ne 0 ] && echo "$NPM_OUTPUT" | grep -qiE 'EACCES|permission denied|access denied'; then
+  USER_PREFIX="$HOME/.npm-global"
+  printf "  ${DIM}No permission for npm's global folder. Running: npm install -g --prefix ~/.npm-global ${PACKAGE}${RESET}\n"
+  mkdir -p "$USER_PREFIX"
+  NPM_EXIT=0
+  NPM_OUTPUT="$(npm install -g --prefix "$USER_PREFIX" "$PACKAGE" 2>&1)" || NPM_EXIT=$?
+  export PATH="$USER_PREFIX/bin:$PATH"
+fi
+
 if [ "$NPM_EXIT" -ne 0 ]; then
   echo "$NPM_OUTPUT"
   echo ""
 
   if echo "$NPM_OUTPUT" | grep -qiE 'EACCES|permission denied|access denied'; then
-    warn "Permission problem. Fix with a user-scoped npm prefix:"
-    warn "  mkdir -p ~/.npm-global"
-    warn "  npm config set prefix ~/.npm-global"
-    warn '  export PATH="$HOME/.npm-global/bin:$PATH"'
-    warn "Add the export line to your shell profile, then rerun this installer."
+    warn "npm could not write to ~/.npm-global either. Check that your home folder is writable, then rerun this installer."
   elif echo "$NPM_OUTPUT" | grep -qiE 'UNABLE_TO_GET_ISSUER_CERT|SELF_SIGNED_CERT|CERT_HAS_EXPIRED'; then
     warn "Certificate/proxy problem. If you are on a corporate network,"
     warn "use a personal network or ask IT for the npm certificate configuration."
@@ -108,16 +112,18 @@ fi
 echo ""
 if [ -n "$VISA_VERSION" ]; then
   ok "Visa CLI ${VISA_VERSION} installed."
-  info "Connect an AI client with: visa-cli connect <client>"
-  # The door, named as the shell sees it. This line used to name the retired
-  # setup ceremony, so an owner who followed it to the letter got
-  # legacy_door_removed at the end of a clean install (owner report,
-  # 2026-09-15). `pnpm lint:docs-sync` now reads this file.
-  info "Then create your agent with: visa connect"
+  # One runnable next step (T16). `visa connect` mounts the app it runs in and
+  # names that app's restart; a pasted placeholder in angle brackets is a shell
+  # redirection. `pnpm lint:docs-sync` reads this file.
+  if [ -n "$USER_PREFIX" ]; then
+    # The one line that keeps it on PATH in new shells.
+    info "Add to your shell profile: export PATH=\"\$HOME/.npm-global/bin:\$PATH\""
+  fi
+  info "Next: visa connect"
   info "Or ask your agent to call its connect tool. You approve it in the browser."
 else
   warn "Installed, but 'visa-cli' was not found on PATH."
-  warn "Restart your shell, then run: visa-cli connect <client>"
+  warn "Restart your shell, then run: visa connect"
 fi
 echo ""
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@visa/cli",
-  "version": "5.0.0-rc.416",
+  "version": "5.0.0-rc.418",
   "description": "Visa CLI runtime for stable agent identity and separately authorized payment capabilities",
   "bin": {
     "visa-cli": "./bin/visa-cli.js",
@@ -60,6 +60,7 @@
     "@visa/financial-core": "workspace:*",
     "@visa/identity": "workspace:*",
     "@visa/contracts": "workspace:*",
+    "@visa/integration-taskmarket": "workspace:*",
     "@visa/observability": "workspace:*",
     "@visa/shared": "workspace:*",
     "@visa/wallet": "workspace:*",

package/server.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
   "name": "io.github.visa-crypto-labs/visa-cli",
-  "version": "5.0.0-rc.416",
+  "version": "5.0.0-rc.418",
   "title": "Visa CLI",
   "description": "Connect an owner-approved agent, then discover and pay supported Tempo MPP services within its limits.",
   "websiteUrl": "https://web-visa-code-preview.up.railway.app/docs",
@@ -9,7 +9,7 @@
     {
       "registryType": "npm",
       "identifier": "@visa/cli",
-      "version": "5.0.0-rc.416",
+      "version": "5.0.0-rc.418",
       "transport": {
         "type": "stdio"
       },