@pellux/goodvibes-agent 0.1.86 → 0.1.89

package/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 All notable changes to GoodVibes Agent will be recorded here.
 
+## 0.1.89 - 2026-06-01
+
+- 6be201c Fix Agent workspace command targets
+
+## 0.1.88 - 2026-06-01
+
+- e97d2a2 Fix release test daemon port allocation
+
+## 0.1.87 - 2026-06-01
+
+- cd0d9fc Improve Agent TUI startup diagnostics
+
 ## 0.1.86 - 2026-06-01
 
 - aac1849 Retry npm publish verification

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pellux/goodvibes-agent",
-  "version": "0.1.86",
+  "version": "0.1.89",
   "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",

package/src/cli/tui-startup.ts

@@ -9,6 +9,70 @@ export type InteractiveTerminalCheckInput = {
   readonly stdoutIsTTY: boolean | undefined;
 };
 
+type NodeLikeError = Error & {
+  readonly code?: string;
+  readonly path?: string;
+  readonly syscall?: string;
+};
+
+export type FatalStartupFormatOptions = {
+  readonly binary: string;
+  readonly debug?: boolean;
+};
+
+function isNodeLikeError(error: unknown): error is NodeLikeError {
+  return error instanceof Error;
+}
+
+function fatalStartupMessage(error: unknown): string {
+  if (error instanceof Error) return error.message;
+  if (typeof error === 'string') return error;
+  try {
+    return JSON.stringify(error);
+  } catch {
+    return String(error);
+  }
+}
+
+function fatalStartupStack(error: unknown): string {
+  if (error instanceof Error) return error.stack ?? error.message;
+  return fatalStartupMessage(error);
+}
+
+export function formatFatalStartupErrorForLog(error: unknown): string {
+  return fatalStartupStack(error);
+}
+
+export function formatFatalStartupErrorForUser(error: unknown, options: FatalStartupFormatOptions): string {
+  if (options.debug === true) return fatalStartupStack(error);
+
+  const message = fatalStartupMessage(error);
+  if (isNodeLikeError(error) && (error.code === 'EACCES' || error.code === 'EPERM')) {
+    return [
+      `${options.binary} could not prepare its local workspace or log directory.`,
+      error.path ? `  path: ${error.path}` : '',
+      error.syscall ? `  operation: ${error.syscall}` : '',
+      '  reason: permission denied',
+      `  next: launch from a writable directory, pass '${options.binary} --cd <dir>', or set GOODVIBES_WORKING_DIR to a writable path.`,
+      '  note: GOODVIBES_AGENT_HOME can be set to move Agent-local config, sessions, memory, skills, personas, and routines.',
+    ].filter((line) => line.length > 0).join('\n');
+  }
+
+  if (isNodeLikeError(error) && error.code === 'ENOENT') {
+    return [
+      `${options.binary} could not find a required startup path.`,
+      error.path ? `  path: ${error.path}` : '',
+      `  reason: ${message}`,
+      `  next: check '${options.binary} --cd <dir>' and GOODVIBES_WORKING_DIR, then rerun '${options.binary} status'.`,
+    ].filter((line) => line.length > 0).join('\n');
+  }
+
+  return [
+    message || `${options.binary} failed during startup.`,
+    'Set GOODVIBES_AGENT_DEBUG=1 to print a stack trace.',
+  ].join('\n');
+}
+
 export function getInteractiveTerminalLaunchError(input: InteractiveTerminalCheckInput): string | null {
   const stdinReady = input.stdinIsTTY === true;
   const stdoutReady = input.stdoutIsTTY === true;

package/src/input/agent-workspace-categories.ts

@@ -49,8 +49,8 @@ export const AGENT_WORKSPACE_CATEGORIES: readonly AgentWorkspaceCategory[] = [
     detail: 'Agent uses externally managed channels. Pairing, account inspection, and readiness checks are visible here; inbound delivery and public channel exposure stay policy-gated.',
     actions: [
       { id: 'pair', label: 'Pair companion', detail: 'Open the QR pairing view for companion app setup.', command: '/pair', kind: 'command', safety: 'safe' },
-      { id: 'communication', label: 'Communication routes', detail: 'Inspect structured communication routes and recent activity.', command: '/communication', kind: 'command', safety: 'read-only' },
-      { id: 'setup-review', label: 'Channel setup review', detail: 'Review setup posture without starting inbound endpoints or mutating channel state.', command: '/setup review', kind: 'command', safety: 'read-only' },
+      { id: 'notification-routes', label: 'Notification routes', detail: 'Inspect configured webhook notification URLs without sending a test message.', command: '/notify list', kind: 'command', safety: 'read-only' },
+      { id: 'setup-review', label: 'Health review', detail: 'Review setup posture without starting inbound endpoints or mutating channel state.', command: '/health review', kind: 'command', safety: 'read-only' },
       { id: 'channel-safety', label: 'Delivery safety', detail: 'External messages, channel DMs, and public delivery targets require explicit user action and runtime policy. Agent will not silently send or expose channels from this workspace.', kind: 'guidance', safety: 'blocked' },
     ],
   },
@@ -90,14 +90,14 @@ export const AGENT_WORKSPACE_CATEGORIES: readonly AgentWorkspaceCategory[] = [
     group: 'SETUP',
     label: 'Profiles',
     summary: 'Isolated Agent homes, config profiles, and setup bundles.',
-    detail: 'Profiles isolate Agent state. GoodVibes Agent exposes named homes, config profile pickers, profile-sync bundles, setup transfer bundles, and support bundles while keeping the shared runtime external.',
+    detail: 'Profiles isolate Agent state. GoodVibes Agent exposes named homes, starter templates, and config profile pickers while keeping the shared runtime external.',
     actions: [
       { id: 'profiles-open', label: 'Open config profiles', detail: 'Open the config profile picker for display/provider/behavior profile files.', command: '/profiles', kind: 'command', safety: 'safe' },
       { id: 'runtime-profile-guide', label: 'Starter authoring guide', detail: 'Open the Agent-local starter authoring flow inside the Agent TUI.', command: '/agent-profile guide', kind: 'command', safety: 'safe' },
       { id: 'runtime-profile-templates', label: 'Browse starter templates', detail: 'List built-in and local Agent starter templates with persona, skill, routine, and source details.', command: '/agent-profile templates', kind: 'command', safety: 'read-only' },
-      { id: 'profile-sync-list', label: 'Profile sync list', detail: 'Inspect saved config profiles available for export/import.', command: '/profilesync list', kind: 'command', safety: 'read-only' },
-      { id: 'profile-sync-export', label: 'Export profile sync', detail: 'Export config profiles to a portable bundle. Requires a real path and explicit --yes.', command: '/profilesync export <path> --yes', kind: 'command', safety: 'safe' },
-      { id: 'setup-transfer-export', label: 'Export setup transfer', detail: 'Export Agent setup transfer data from the current home. Requires a real path and explicit --yes.', command: '/setup transfer export <path> --yes', kind: 'command', safety: 'safe' },
+      { id: 'runtime-profile-list', label: 'List Agent profiles', detail: 'List isolated Agent profile homes under this Agent home.', command: '/agent-profile list', kind: 'command', safety: 'read-only' },
+      { id: 'runtime-profile-template-export', label: 'Export starter template', detail: 'Export a starter template JSON file. Requires a real starter id, path, and explicit --yes.', command: '/agent-profile template export <id> <path> --yes', kind: 'command', safety: 'safe' },
+      { id: 'runtime-profile-template-import', label: 'Import starter template', detail: 'Import a reviewed starter template JSON file into this Agent home. Requires a real path and explicit --yes.', command: '/agent-profile template import <path> --yes', kind: 'command', safety: 'safe' },
       { id: 'runtime-profile-create', label: 'Create Agent profile', detail: 'Open an in-workspace form that creates an isolated Agent home from a built-in or local starter.', editorKind: 'profile', kind: 'editor', safety: 'safe' },
       { id: 'runtime-profile-template-edit', label: 'Customize starter', detail: 'Export a starter JSON file, edit it, import it as a local starter, then create a profile from it.', command: '/agent-profile template export <id> <path> --yes', kind: 'command', safety: 'safe' },
       { id: 'runtime-profile-switch', label: 'Switch Agent profile', detail: 'Launch goodvibes-agent --agent-profile <name> to use that isolated Agent home. This workspace cannot switch the current process home after startup.', kind: 'guidance', safety: 'safe' },

package/src/main.ts

@@ -45,7 +45,7 @@ import { deriveComposerState } from './core/composer-state.ts';
 import { buildPersistedSessionContext, formatReturnContextForDisplay, getReturnContextMode, maybeAssistReturnContextSummary } from '@/runtime/index.ts';
 import { summarizeError } from '@pellux/goodvibes-sdk/platform/utils';
 import { prepareShellCliRuntime } from './cli/entrypoint.ts';
-import { applyInitialTuiCliState, getInteractiveTerminalLaunchError } from './cli/tui-startup.ts';
+import { applyInitialTuiCliState, formatFatalStartupErrorForLog, formatFatalStartupErrorForUser, getInteractiveTerminalLaunchError } from './cli/tui-startup.ts';
 import { wireSpokenTurnRuntime } from './audio/spoken-turn-wiring.ts';
 import { attachSpokenTurnModelRouting, createSpokenTurnInputOptions } from './audio/spoken-turn-model-routing.ts';
 import { allowTerminalWrite, installTuiTerminalOutputGuard } from './runtime/terminal-output-guard.ts';
@@ -768,29 +768,19 @@ async function main() {
 
 }
 
-function formatFatalStartupError(error: unknown): string {
-  if (error instanceof Error) {
-    return error.stack ?? error.message;
-  }
-  if (typeof error === 'string') {
-    return error;
-  }
-  try {
-    return JSON.stringify(error);
-  } catch {
-    return String(error);
-  }
-}
-
 main().catch((err: unknown) => {
-  const detail = formatFatalStartupError(err);
+  const detail = formatFatalStartupErrorForLog(err);
   try {
     logger.error('Fatal error', { error: detail });
   } catch {
     // Startup diagnostics must never hide the original launch failure.
   }
+  const userDetail = formatFatalStartupErrorForUser(err, {
+    binary: 'goodvibes-agent',
+    debug: process.env['GOODVIBES_AGENT_DEBUG'] === '1',
+  });
   try {
-    process.stderr.write(`goodvibes-agent failed to launch:\n${detail}\n`);
+    process.stderr.write(`goodvibes-agent failed to launch:\n${userDetail}\n`);
   } catch {
     // Ignore secondary stderr failures during process teardown.
   }

package/src/renderer/agent-workspace.ts

@@ -232,7 +232,7 @@ function snapshotLines(workspace: AgentWorkspace, category: AgentWorkspaceCatego
       });
     }
     base.push({ text: 'Only config key names and readiness state are rendered here.', fg: PALETTE.muted });
-    base.push({ text: 'Pairing: use /pair or /qrcode; inspect routed activity with /communication and /setup review.', fg: PALETTE.info });
+    base.push({ text: 'Pairing: use /pair or /qrcode; inspect notification targets with /notify list and health with /health review.', fg: PALETTE.info });
   } else if (category.id === 'knowledge') {
     base.push(
       { text: `Route family: ${snapshot.knowledgeRoute}/{status,ask,search}`, fg: PALETTE.info },

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