feat(cli): self update preserves install scope (local vs global)

[christso]

Summary

• agentv self update now detects whether agentv was invoked from a local project dependency (process.argv[1] contains node_modules) or a global install, and runs the package manager with the matching scope:
  • Global (default): npm install -g agentv@latest / bun add -g agentv@latest
  • Local: npm install agentv@latest / bun add agentv@latest (no -g)
• The detected scope is shown in the console output (e.g. Updating agentv using npm (local (project))...).

Implementation

• apps/cli/src/self-update.ts
  • New helpers: detectInstallScopeFromPath(scriptPath) and detectInstallScope().
  • getInstallArgs() takes a scope parameter and emits ['install', pkg] / ['add', pkg] without -g for local.
  • performSelfUpdate() accepts an optional scope override (defaults to auto-detect) and returns the resolved scope alongside the existing fields.
• apps/cli/src/commands/self/index.ts — passes the detected scope through to performSelfUpdate() and surfaces it in the Updating agentv using … log line.
• apps/cli/test/self-update.test.ts — adds coverage for detectInstallScopeFromPath (local node_modules, npx cache, /usr/local/bin, .bun/bin, nvm, empty string).

Red/Green UAT

To exercise the spawn without actually installing anything, npm and bun were shadowed with fake shims that echo their received args; bun was invoked via an absolute path so PATH override only affects child processes.

Red (on main): Running performSelfUpdate from a script path under node_modules:

process.argv[1]: /tmp/fake-local-node_modules/node_modules/agentv-pretend/dist/cli-main.ts
FAKE-NPM-RECEIVED-ARGS: install -g agentv@latest

→ -g is used even though the invocation came from a local install — the reported bug.

Green (this branch):

1. Local path (under node_modules/):

   process.argv[1]: /tmp/fake-local-node_modules/node_modules/agentv-pretend/dist/cli.ts
   FAKE-NPM-RECEIVED-ARGS: install agentv@latest
   Result scope: local
   

2. Global path (no node_modules):

   process.argv[1]: /tmp/fake-global-path/cli-global.ts
   FAKE-NPM-RECEIVED-ARGS: install -g agentv@latest
   Result scope: global
   

Both cases behave as specified in the issue: local installs no longer get the -g flag, global installs still do.

Test plan

• 10/10 apps/cli/test/self-update.test.ts pass (incl. 6 new cases covering detectInstallScopeFromPath)
• Pre-push hooks: build, typecheck, lint, tests, validate-examples all pass
• Manual red/green UAT captured above

Related

• Follow-up from feat(cli): Auto-update when version mismatch detected #1125 (auto-update on version mismatch).
• Complementary to feat(cli): add version check to agentv studio/serve commands #1128 (version check for studio/serve).

Closes #1127

[cloudflare-workers-and-pages]

Deploying agentv with    Cloudflare Pages

Latest commit:	6793914
Status:	✅  Deploy successful!
Preview URL:	https://3b840ad3.agentv.pages.dev
Branch Preview URL:	https://feat-1127-self-update-local.agentv.pages.dev

View logs