@pellux/goodvibes-agent 0.1.60 → 0.1.61

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 All notable changes to GoodVibes Agent will be recorded here.
 
+## 0.1.61 - 2026-05-31
+
+- ff6766d Stop shipping repo-local skills
+- 2eedcf5 Focus primary CLI help on Agent use
+- 0ec6af0 Document Bun trust path for SDK native deps
+- f9a6c76 Surface Agent actions in slash help
+
 ## 0.1.60 - 2026-05-31
 
 - f3f2486 Stop shipping developer guidance in package

package/README.md

@@ -29,7 +29,7 @@ goodvibes-agent --help
 If Bun reports untrusted lifecycle dependencies, trust only the package and dependencies required by this package:
 
 ```sh
-bun pm trust -g @pellux/goodvibes-agent @pellux/goodvibes-sdk core-js
+bun pm trust -g @pellux/goodvibes-agent @pellux/goodvibes-sdk core-js tree-sitter-css tree-sitter-javascript tree-sitter-json tree-sitter-python tree-sitter-typescript
 ```
 
 ## Source Usage

package/docs/getting-started.md

@@ -28,7 +28,7 @@ goodvibes-agent --help
 If Bun requires lifecycle trust:
 
 ```sh
-bun pm trust -g @pellux/goodvibes-agent @pellux/goodvibes-sdk core-js
+bun pm trust -g @pellux/goodvibes-agent @pellux/goodvibes-sdk core-js tree-sitter-css tree-sitter-javascript tree-sitter-json tree-sitter-python tree-sitter-typescript
 ```
 
 ## Run From Source

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pellux/goodvibes-agent",
-  "version": "0.1.60",
+  "version": "0.1.61",
   "private": false,
   "description": "GoodVibes personal operator assistant TUI with a proactive Agent product brain, isolated Agent Knowledge, local profiles, routines, skills, personas, and explicit build delegation.",
   "type": "module",
@@ -12,7 +12,6 @@
   "files": [
     "bin",
     "LICENSE",
-    ".goodvibes/skills",
     "src",
     "!src/test",
     "!src/**/*.test.ts",
@@ -107,7 +106,12 @@
   },
   "trustedDependencies": [
     "@pellux/goodvibes-sdk",
-    "core-js"
+    "core-js",
+    "tree-sitter-css",
+    "tree-sitter-javascript",
+    "tree-sitter-json",
+    "tree-sitter-python",
+    "tree-sitter-typescript"
   ],
   "overrides": {
     "minimatch": "^10.2.5"

package/src/cli/help.ts

@@ -31,9 +31,7 @@ export function renderGoodVibesHelp(binary = 'goodvibes-agent'): string {
     'Commands:',
     '  tui [path]                 Start the interactive Agent terminal UI (default)',
     '  run|exec [prompt]          Run non-interactively with text/json/stream-json output',
-    '  web                        Show browser surface bind URL and enablement',
-    '  service                    Inspect existing daemon service posture (read-only)',
-    '  status                     Print config, provider, service, and onboarding posture',
+    '  status                     Print config, provider, auth, and onboarding posture',
     '  doctor                     Print status plus setup warnings',
     '  onboarding [status]        Open Agent onboarding, or print onboarding status',
     '  models [provider]          List/use/pin selectable models and recent model history',
@@ -48,14 +46,9 @@ export function renderGoodVibesHelp(binary = 'goodvibes-agent'): string {
     '  subscription               Start/finish/logout provider subscription sessions',
     '  secrets                    List, set, link, delete, and test GoodVibes secret refs',
     '  sessions                   List, show, export, or resume saved sessions',
-    '  tasks                      List/show in-process runtime tasks (read-only)',
     '  pair|qrcode                Print companion pairing payload and QR code',
-    '  surfaces                   Inspect/check browser/listener/external surfaces (read-only)',
-    '  listener test              Test HTTP listener/webhook readiness',
-    '  control-plane status       Inspect daemon auth, local admin, tokens, and ports',
     '  bundle export|inspect|import',
     '                             Move setup/profile/trust/support bundles',
-    '  remote|bridge              Inspect remote runner/node posture',
     '  completion <shell>         Generate shell completion script',
     '  help [command]             Print this help or command-specific help',
     '  version                    Print version',
@@ -66,7 +59,6 @@ export function renderGoodVibesHelp(binary = 'goodvibes-agent'): string {
     '      --agent-profile <name>     Use an isolated Agent runtime profile home',
     '  -C, --cd <dir>                 Set working directory for this launch',
     '      --working-dir <dir>        Alias for --cd',
-    '      --daemon-home <dir>        Override daemon home for daemon-backed commands',
     '  -c, --config <key=value>       Override a config value for this launch',
     '      --enable <feature>         Enable a feature flag for this launch',
     '      --disable <feature>        Disable a feature flag for this launch',
@@ -76,9 +68,6 @@ export function renderGoodVibesHelp(binary = 'goodvibes-agent'): string {
     '      --output-format <format>   Alias for --output',
     '      --json                     Alias for --output-format json',
     '      --no-alt-screen            Keep output in normal terminal scrollback',
-    '      --port <port>              Port for server/web commands',
-    '      --hostname <host>          Hostname for server/web commands',
-    '      --open                     Open browser when supported',
     '  -r, --resume [id|latest]       Resume saved session when supported',
     '  -s, --session <id>             Use a specific session when supported',
     '      --continue                 Continue the latest session when supported',
@@ -105,13 +94,10 @@ export function renderGoodVibesHelp(binary = 'goodvibes-agent'): string {
     `  ${binary} ask "What is GoodVibes Agent?"`,
     `  ${binary} search "release checklist"`,
     `  ${binary} delegate --wrfc "fix the failing tests in ~/work/project"`,
-    `  ${binary} surfaces`,
-    `  ${binary} surfaces check`,
-    `  ${binary} service check`,
-    `  ${binary} listener test`,
-    `  ${binary} control-plane status`,
     `  ${binary} subscription providers`,
     `  ${binary} subscription login openai start --open`,
+    `  ${binary} help service`,
+    `  ${binary} help surfaces`,
   ].join('\n');
 }
 

package/src/cli/package-verification.ts

@@ -42,7 +42,7 @@ const REQUIRED_TARBALL_PATHS = [
   'docs/deployment-and-services.md',
   'docs/release-and-publishing.md',
 ] as const;
-const FORBIDDEN_TARBALL_PREFIXES = ['.github/', 'src/test/', 'src/.test/', '.goodvibes/memory/', '.goodvibes/agents/', 'vendor/'] as const;
+const FORBIDDEN_TARBALL_PREFIXES = ['.github/', 'src/test/', 'src/.test/', '.goodvibes/', 'vendor/'] as const;
 const FORBIDDEN_TARBALL_DOCS = [
   ['docs/cloud', 'flare-batch.md'].join(''),
   ['docs/home', 'assistant-surface.md'].join(''),
@@ -55,7 +55,6 @@ const PACKAGE_FACING_TEXT_PATHS = [
   'docs/getting-started.md',
   'docs/deployment-and-services.md',
   'docs/release-and-publishing.md',
-  '.goodvibes/skills/add-provider/SKILL.md',
 ] as const;
 const PACKAGE_FACING_FORBIDDEN_TEXT = [
   ['/api/', 'knowledge'].join(''),

package/src/input/commands/shell-core.ts

@@ -116,6 +116,13 @@ export function registerShellCoreCommands(registry: CommandRegistry): void {
         const items: SelectionItem[] = [
           { id: '/agent', label: '/agent', detail: 'Open the Agent operator workspace', category: 'Agent Operator' },
           { id: '/home', label: '/home', detail: 'Alias for the Agent operator workspace', category: 'Agent Operator' },
+          { id: '/knowledge', label: '/knowledge', detail: 'Inspect isolated Agent Knowledge status, ask/search, and ingest flows', category: 'Agent Operator' },
+          { id: '/memory', label: '/memory', detail: 'Review local Agent memory records', category: 'Agent Operator' },
+          { id: '/personas', label: '/personas', detail: 'Create, review, and activate local Agent personas', category: 'Agent Operator' },
+          { id: '/agent-skills', label: '/agent-skills', detail: 'Create, review, and enable reusable Agent skills', category: 'Agent Operator' },
+          { id: '/routines', label: '/routines', detail: 'Create, review, start, and promote Agent routines explicitly', category: 'Agent Operator' },
+          { id: '/delegate', label: '/delegate [task]', detail: 'Explicit build/fix/review handoff to GoodVibes TUI', category: 'Agent Operator' },
+          { id: '/pair', label: '/pair', detail: 'Pair companion clients through the external GoodVibes service', category: 'Agent Operator' },
           { id: '/model', label: '/model [id]', detail: 'Select LLM model', category: 'Model & Provider' },
           { id: '/provider', label: '/provider [name]', detail: 'Switch provider', category: 'Model & Provider' },
           { id: '/effort', label: '/effort [level]', detail: 'Reasoning effort (instant/low/medium/high)', category: 'Model & Provider' },

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.60';
+let _version = '0.1.61';
 let _sdkVersion = '0.33.35';
 try {
   const pkg = JSON.parse(readFileSync(join(import.meta.dir, '..', 'package.json'), 'utf-8')) as {

package/.goodvibes/skills/add-provider/SKILL.md

@@ -1,199 +0,0 @@
----
-name: add-provider
-description: Adds custom LLM providers and models to GoodVibes Agent. Use when the user wants to add a provider, add a model, configure Ollama, Together AI, OpenRouter, Groq, LM Studio, Fireworks, vLLM, or any OpenAI-compatible endpoint.
-version: 1.0.0
-triggers:
-  - /add-provider
-  - add provider
-  - add a provider
-  - new provider
-  - custom provider
-  - add model
-  - add a model
-author: goodvibes
----
-
-# Add Custom Provider
-
-Interactively collect provider and model details from the user, then write a JSON config to `~/.goodvibes/agent/providers/{name}.json`.
-
-## Workflow
-
-### Step 1: Check for Existing Provider
-
-Before collecting info, check if `~/.goodvibes/agent/providers/` already has JSON files. If the user names a provider that already exists, ask:
-- **Add models** to the existing provider, or
-- **Overwrite** it entirely
-
-If adding models, read the existing JSON, append new models, and write back.
-
-### Step 2: Collect Provider Details
-
-Ask the user for each field. Apply smart defaults when the provider name matches a known service.
-
-#### Required Fields
-
-| Field | Description | Validation |
-|-------|-------------|------------|
-| `name` | Internal ID | Lowercase alphanumeric + hyphens only, 1-64 chars |
-| `displayName` | Human-readable name | Non-empty string |
-| `type` | API compatibility | `openai-compat` (recommended) or `anthropic-compat` (not yet supported — use `openai-compat`) |
-| `baseURL` | API endpoint | Must start with `http://` or `https://` |
-
-> **Note:** `anthropic-compat` is accepted in the JSON schema for forward compatibility but is not yet functional at runtime. The loader will skip configs with this type and emit a warning. Use `openai-compat` for now — most Anthropic-compatible proxies (e.g., via LiteLLM) expose an OpenAI-compatible endpoint.
-
-#### Optional Fields
-
-| Field | Description | Default |
-|-------|-------------|---------|
-| `apiKeyEnv` | Environment variable for API key | None |
-| `apiKey` | Explicit API key (not recommended) | None |
-| `defaultHeaders` | Custom HTTP headers sent with every API request (e.g., for proxy authentication or routing) | None |
-
-### Smart Defaults
-
-When the user mentions a known provider, pre-fill these values and confirm:
-
-```yaml
-ollama:
-  displayName: Ollama
-  type: openai-compat
-  baseURL: http://localhost:11434/v1
-  apiKeyEnv: null
-
-together:
-  displayName: Together AI
-  type: openai-compat
-  baseURL: https://api.together.xyz/v1
-  apiKeyEnv: TOGETHER_API_KEY
-
-openrouter:
-  displayName: OpenRouter
-  type: openai-compat
-  baseURL: https://openrouter.ai/api/v1
-  apiKeyEnv: OPENROUTER_API_KEY
-
-groq:
-  displayName: Groq
-  type: openai-compat
-  baseURL: https://api.groq.com/openai/v1
-  apiKeyEnv: GROQ_API_KEY
-
-lm-studio:
-  displayName: LM Studio
-  type: openai-compat
-  baseURL: http://localhost:1234/v1
-  apiKeyEnv: null
-
-fireworks:
-  displayName: Fireworks AI
-  type: openai-compat
-  baseURL: https://api.fireworks.ai/inference/v1
-  apiKeyEnv: FIREWORKS_API_KEY
-
-vllm:
-  displayName: vLLM
-  type: openai-compat
-  baseURL: http://localhost:8000/v1
-  apiKeyEnv: null
-```
-
-If the name does not match a known provider, ask for all fields individually.
-
-### Step 3: Collect Model Details
-
-Collect at least one model. For each model:
-
-| Field | Description | Validation |
-|-------|-------------|------------|
-| `id` | Model identifier sent to the API | Non-empty string |
-| `displayName` | Human-readable name | Non-empty string |
-| `description` | Short description | Optional, auto-generate if blank |
-| `contextWindow` | Max tokens in context | Positive integer |
-| `capabilities.toolCalling` | Supports function/tool calling | Boolean, default `true` |
-| `capabilities.codeEditing` | Good at code editing tasks | Boolean, default `true` |
-| `capabilities.reasoning` | Extended reasoning/chain-of-thought | Boolean, default `false` |
-| `capabilities.multimodal` | Supports image input | Boolean, default `false` |
-| `reasoningEffort` | Supported reasoning effort levels | Optional, e.g., `["low", "medium", "high"]` |
-
-After each model, ask: "Add another model?" Loop until done.
-
-### Step 4: Preview and Confirm
-
-Show the complete JSON to the user and ask for confirmation before writing.
-
-Example output:
-
-```json
-{
-  "name": "ollama",
-  "displayName": "Ollama",
-  "type": "openai-compat",
-  "baseURL": "http://localhost:11434/v1",
-  "models": [
-    {
-      "id": "llama3.3-70b",
-      "displayName": "Llama 3.3 70B",
-      "description": "Meta's Llama 3.3 70B parameter model",
-      "contextWindow": 131072,
-      "capabilities": {
-        "toolCalling": true,
-        "codeEditing": true,
-        "reasoning": true,
-        "multimodal": false
-      },
-      "reasoningEffort": ["low", "medium", "high"]
-    }
-  ]
-}
-```
-
-### Step 5: Write the File
-
-Write to `~/.goodvibes/agent/providers/{name}.json`. Create the directory if it does not exist.
-
-Use `precision_write` with `mode: "fail_if_exists"` for new providers. Use `mode: "overwrite"` when the user chose to overwrite an existing provider or when merging models into an existing file.
-
-If the `apiKeyEnv` field is set, include it in the JSON. If the user provided an explicit `apiKey`, include it but warn that storing keys in plain text is not recommended -- suggest using an environment variable instead.
-
-If `defaultHeaders` were provided, include them.
-
-### Step 6: Confirm
-
-Tell the user:
-- The file was written to `~/.goodvibes/agent/providers/{name}.json`
-- The provider should be available to the Agent runtime after provider reload or next Agent startup
-- If an API key is needed, remind them to set the environment variable
-
-## Validation Rules
-
-Before writing, verify:
-1. `name` matches `/^[a-z0-9]([a-z0-9-]*[a-z0-9])?$/` and is 1-64 characters (no trailing hyphens)
-2. `baseURL` starts with `http://` or `https://`
-3. `contextWindow` is a positive integer for every model
-4. At least one model is defined
-5. Every model has a non-empty `id` and `displayName`
-
-If validation fails, tell the user which field is invalid and ask for correction.
-
-## JSON Schema Reference
-
-The provider JSON maps to the codebase types:
-
-- Provider registration uses `OpenAICompatProvider` for `openai-compat` type. The `anthropic-compat` type is parsed and accepted in the JSON but is **not yet supported at runtime** — the loader skips it with a warning. Recommend `openai-compat` for all custom providers.
-- `OpenAICompatOptions`: `{ name, baseURL, apiKey, defaultModel, models }`
-- Model entries map to `ModelDefinition`: `{ id, provider, displayName, description, contextWindow, capabilities, reasoningEffort?, selectable }`
-  - `reasoningEffort?: string[]` — optional array of supported effort levels, e.g., `["low", "medium", "high"]`
-- The `selectable` field defaults to `true` for custom models
-- The `provider` field in `ModelDefinition` is auto-set to the provider `name`
-
-## Conversational Style
-
-Be natural and helpful. Guide users step-by-step but do not be overly verbose. If the user provides multiple details at once (e.g., "add ollama with llama3.3-70b"), extract what you can and only ask for missing fields.
-
-## Edge Cases
-
-- **Unknown context window**: Suggest 4096 as a safe default, note the user can update later
-- **No API key needed**: Omit `apiKeyEnv` and `apiKey` from the JSON entirely
-- **User provides a full JSON blob**: Validate it against the schema and write directly
-- **Multiple providers in one session**: After completing one, ask if they want to add another