@pellux/goodvibes-agent 0.1.55 → 0.1.56

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 All notable changes to GoodVibes Agent will be recorded here.
 
+## 0.1.56 - 2026-05-31
+
+- a0b54e8 Document Bun global PATH setup
+- f845cca Rename onboarding capabilities step
+- 4462e52 Clarify Bun-only install path
+
 ## 0.1.55 - 2026-05-31
 
 - d8f4eee Remove copied developer audit surfaces

package/README.md

@@ -19,6 +19,13 @@ goodvibes-agent profiles templates
 goodvibes-agent knowledge status
 ```
 
+If `goodvibes-agent` is not found after installation, add Bun's global bin directory to `PATH`:
+
+```sh
+export PATH="$(bun pm bin -g):$PATH"
+goodvibes-agent --help
+```
+
 If Bun reports untrusted lifecycle dependencies, trust only the package and dependencies required by this package:
 
 ```sh

package/docs/getting-started.md

@@ -18,6 +18,13 @@ goodvibes-agent --help
 goodvibes-agent status
 ```
 
+If the installed command is not found, add Bun's global bin directory to `PATH`:
+
+```sh
+export PATH="$(bun pm bin -g):$PATH"
+goodvibes-agent --help
+```
+
 If Bun requires lifecycle trust:
 
 ```sh

package/docs/release-and-publishing.md

@@ -4,13 +4,22 @@ GoodVibes Agent's current installable public alpha version is recorded in `packa
 
 ## Package Identity
 
-- npm package: `@pellux/goodvibes-agent`
+- registry package: `@pellux/goodvibes-agent`
 - executable: `goodvibes-agent`
 - SDK dependency: exact pin to `@pellux/goodvibes-sdk@0.33.35`
 - runtime: Bun
 - source language: TypeScript
 - daemon ownership: external only
 
+End users install and run GoodVibes Agent with Bun:
+
+```sh
+bun add -g @pellux/goodvibes-agent
+goodvibes-agent --help
+```
+
+Do not add non-Bun install instructions for this product. The package is hosted on the npm registry, but the supported install and smoke path is Bun.
+
 ## Required Gates
 
 Before any release candidate:
@@ -25,7 +34,7 @@ bun pm pack --dry-run
 git diff --check
 ```
 
-`bun run publish:package` publishes from a staged package directory. If `NPM_CONFIG_USERCONFIG` is already set, npm uses it. Otherwise the script creates a temporary 0600 npm userconfig from `NODE_AUTH_TOKEN` or `NPM_TOKEN`, uses it for that publish command, and removes it with the staging directory.
+`bun run publish:package` publishes from a staged package directory to the package registry. If `NPM_CONFIG_USERCONFIG` is already set, the registry publish command uses it. Otherwise the script creates a temporary 0600 registry userconfig from `NODE_AUTH_TOKEN` or `NPM_TOKEN`, uses it for that publish command, and removes it with the staging directory.
 
 Also run the package install smoke from a packed artifact. It must prove:
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pellux/goodvibes-agent",
-  "version": "0.1.55",
+  "version": "0.1.56",
   "private": false,
   "description": "Near-fork GoodVibes operator assistant with the GoodVibes TUI shell, renderer, input, fullscreen workspace, and daemon-connected Agent product brain.",
   "type": "module",

package/scripts/check-bun.sh

@@ -5,9 +5,13 @@ if ! command -v bun >/dev/null 2>&1; then
   cat >&2 <<'EOF'
 goodvibes-agent requires Bun.
 
-Install Bun first, then install GoodVibes Agent from the npm registry with:
+Install Bun first, then install GoodVibes Agent with:
 
   bun add -g @pellux/goodvibes-agent
+
+If the installed command is not found, add Bun's global bin directory to PATH:
+
+  export PATH="$(bun pm bin -g):$PATH"
 EOF
   exit 1
 fi

package/src/input/onboarding/onboarding-wizard-steps.ts

@@ -130,12 +130,12 @@ export function buildCapabilitiesStep(controller: OnboardingWizardController): O
 
     return {
       id: 'capabilities',
-      title: 'Choose GoodVibes surfaces',
-      shortLabel: 'Capabilities',
+      title: 'Choose Agent surfaces',
+      shortLabel: 'Surfaces',
       description: 'Choose what Agent should prepare locally. Daemon-backed surfaces are reviewed as external dependencies; Agent does not enable service mode or autostart.',
       summaryTitle: 'Selected surfaces',
       summaryLines: [
-        `${selectedCount}/${capabilities.length} option(s) selected`,
+        `${selectedCount}/${capabilities.length} surface option(s) selected`,
         `Mode: ${controller.mode === 'edit' ? 'edit existing shell state' : controller.mode === 'reopen' ? 'reopen review flow' : 'new setup'}`,
         controller.runtimeSnapshot?.collectionIssues.length
           ? `${controller.runtimeSnapshot.collectionIssues.length} runtime collection issue(s)`

package/src/version.ts

@@ -6,7 +6,7 @@ import { join } from 'node:path';
 // The prebuild script updates the fallback value before compilation.
 // Uses import.meta.dir (Bun) to locate package.json relative to this file,
 // which is correct regardless of the process working directory.
-let _version = '0.1.55';
+let _version = '0.1.56';
 let _sdkVersion = '0.33.35';
 try {
   const pkg = JSON.parse(readFileSync(join(import.meta.dir, '..', 'package.json'), 'utf-8')) as {