@pellux/goodvibes-agent 0.1.67 → 0.1.69

package/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 All notable changes to GoodVibes Agent will be recorded here.
 
+## 0.1.69 - 2026-05-31
+
+- Made the first-run onboarding detail area wrap selected-row guidance across multiple lines instead of hiding setup context behind single-line truncation.
+- Shortened first-screen setup labels and values so Agent identity, runtime connection, secret policy, profiles, and continue actions remain readable at normal terminal widths.
+- Fixed tiny-view onboarding scroll behavior so the selected action stays visible when field capacity is minimal.
+
+## 0.1.68 - 2026-05-31
+
+- Removed internal foundation-phase language and blocked lifecycle command examples from package-facing docs.
+- Stopped advertising runtime lifecycle and surface-management commands in shell completion while keeping safety blocks for accidental invocations.
+- Added package text guards so shipped docs stay focused on the Agent TUI product path.
+
 ## 0.1.67 - 2026-05-31
 
 - Reworked remote bridge and remote review language from copied runner/control-room wording to Agent-facing worker/review wording.
@@ -377,7 +389,7 @@ All notable changes to GoodVibes Agent will be recorded here.
 ## 0.1.0 - 2026-05-28
 
 - Published the first public alpha package for `@pellux/goodvibes-agent`.
-- Kept the near-fork GoodVibes TUI shell, renderer, input, fullscreen workspace, command registry, and release foundation.
+- Kept the GoodVibes TUI-derived shell, renderer, input, fullscreen workspace, command registry, and release foundation.
 - Preserved Agent product policy: serial/proactive main conversation by default, no local Agent-owned WRFC/spawn fanout, and explicit GoodVibes TUI delegation for build/fix/review work.
 - Moved Agent-owned runtime state to `.goodvibes/agent` surface roots.
 - Updated packaged Agent guidance, reviewer persona, and provider skill to avoid copied TUI WRFC/multi-agent defaults.
@@ -386,7 +398,7 @@ All notable changes to GoodVibes Agent will be recorded here.
 
 ## 0.0.0 - Private Baseline
 
-- Copied the GoodVibes terminal foundation as a near-fork starting point for the Agent product.
+- Adopted the GoodVibes terminal foundation as the starting point for the Agent product.
 - Renamed package identity to `@pellux/goodvibes-agent` and exposed one executable, `goodvibes-agent`.
 - Pinned `@pellux/goodvibes-sdk` to `0.33.35`.
 - Removed packaged runtime-host binaries and blocked Agent-owned runtime/service lifecycle commands.

package/README.md

@@ -3,7 +3,7 @@
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
 [![Status: alpha](https://img.shields.io/badge/status-alpha-orange.svg)](#install)
 
-GoodVibes Agent is the personal operator assistant built on the GoodVibes terminal UI foundation. This repository is intentionally in a near-fork baseline phase: the shell, renderer, input, fullscreen workspace, command, and release bones are copied from the terminal product first, then the coding-specific behavior is removed or reshaped deliberately.
+GoodVibes Agent is the personal operator assistant TUI for GoodVibes. It is built for day-to-day operator work: chat, setup, local profiles, routines, skills, personas, isolated Agent Knowledge, status review, approvals, automation visibility, and explicit build delegation.
 
 The Agent product connects to an already-running GoodVibes runtime. It does not install, start, stop, restart, or own runtime connectivity or service lifecycle.
 
@@ -87,15 +87,7 @@ Starting a routine records local usage and prints its steps; it does not spawn b
 
 Start or restart the GoodVibes runtime from GoodVibes TUI or the owning host before launching Agent. Agent status and companion/knowledge routes connect to that external runtime, normally on `http://127.0.0.1:3421`.
 
-Agent intentionally blocks runtime lifecycle commands:
-
-```sh
-goodvibes-agent serve
-goodvibes-agent service start
-goodvibes-agent surfaces enable web
-```
-
-Those commands should return explicit external-runtime guidance instead of mutating local service posture.
+Agent reports unavailable, unauthenticated, or incompatible runtime state through `goodvibes-agent status`, `goodvibes-agent doctor`, and the TUI status surfaces. It does not provide runtime lifecycle setup commands.
 
 ## Product Boundary
 
@@ -107,10 +99,10 @@ GoodVibes TUI owns coding execution: file edits, git/worktree workflows, coding
 
 ## Package Docs
 
-Package-facing docs are intentionally narrow during the near-fork baseline:
+Package-facing docs:
 
 - [Getting Started](docs/getting-started.md)
 - [Deployment And Services](docs/deployment-and-services.md)
 - [Release And Publishing](docs/release-and-publishing.md)
 
-Broader foundation reference docs may exist in the source tree while the near-fork foundation is being completed, but the package-facing Agent documentation is limited to the docs listed above.
+The package-facing Agent documentation is limited to the docs listed above.

package/docs/README.md

@@ -1,8 +1,6 @@
 # GoodVibes Agent Docs
 
-These are the package-facing docs for GoodVibes Agent.
-
-GoodVibes Agent is a near-fork of the GoodVibes terminal foundation with a different product brain. It uses the copied terminal shell, renderer, input, fullscreen workspace, command, and release bones while the Agent-specific assistant behavior is being rebuilt.
+These are the package-facing docs for GoodVibes Agent, the personal operator assistant TUI for GoodVibes.
 
 Current package docs:
 
@@ -24,4 +22,4 @@ Important baseline constraints:
 - Normal assistant chat is not coding-session delegation.
 - Build/fix/review delegation to GoodVibes TUI must be explicit; WRFC is not the default Agent behavior.
 
-Copied TUI release and UAT histories are intentionally not part of this repository. The Agent docs above define the supported alpha behavior.
+The Agent docs above define the supported alpha behavior.

package/docs/deployment-and-services.md

@@ -1,8 +1,8 @@
 # Deployment And Services
 
-GoodVibes Agent is a client/operator surface. It does not own runtime or listener deployment.
+GoodVibes Agent is a client/operator TUI. It connects to an already-running GoodVibes runtime and does not own runtime or listener deployment.
 
-## Service Ownership
+## Runtime Ownership
 
 Agent must not:
 
@@ -12,7 +12,7 @@ Agent must not:
 - start, stop, or restart runtime services
 - enable web, listener, control-plane, or channel surface posture
 
-Those operations belong to GoodVibes TUI or the owning runtime host.
+Those operations belong to GoodVibes TUI or the owning runtime host. Agent reports external runtime readiness but does not configure that host.
 
 ## Agent Runtime
 
@@ -40,12 +40,6 @@ http://127.0.0.1:3421
 
 If the runtime is unavailable, unauthenticated, or on an incompatible SDK version, Agent commands should report actionable diagnostics without printing token values.
 
-## Surface Commands
-
-`goodvibes-agent surfaces`, `surfaces check`, and `surfaces show <surfaceId>` are read-only diagnostics.
-
-`surfaces enable` and `surfaces disable` are intentionally blocked in Agent because they can mutate runtime/listener/web/channel posture.
-
 ## Release Rule
 
 Only publish Agent releases that preserve the Agent product policy:

package/docs/getting-started.md

@@ -101,6 +101,6 @@ Agent Knowledge/Wiki is an Agent-owned product segment. Agent commands must not
 
 Agent lifecycle commands that would start or mutate runtime posture are blocked intentionally. Use `goodvibes-agent status`, `goodvibes-agent doctor`, and read-only surface checks for diagnostics.
 
-## Current Baseline Notes
+## Current Product Notes
 
-This repository keeps broad terminal foundation code intentionally so Agent can use the mature shell, renderer, input, fullscreen workspace, command registry, and release bones. The active Agent policy is serial/proactive by default, blocks local Agent-owned WRFC/spawn fanout, and delegates explicit build/fix/review work to GoodVibes TUI instead of turning the Agent into a coding TUI.
+Agent uses the mature GoodVibes terminal shell, renderer, input, fullscreen workspace, command registry, and release foundation. The active Agent policy is serial/proactive by default, blocks local Agent-owned WRFC/spawn fanout, and delegates explicit build/fix/review work to GoodVibes TUI instead of turning the Agent into a coding TUI.

package/docs/release-and-publishing.md

@@ -55,6 +55,6 @@ Do not publish if Agent Knowledge commands can fall back to default Knowledge/Wi
 
 Do not ship runtime host binaries from this package. If Agent later gets compiled artifacts, they must use Agent artifact names and remain separate from runtime ownership.
 
-## Near-Fork Baseline Rule
+## Product Rule
 
-The public alpha can include copied terminal foundation code, but package-facing behavior must follow Agent product policy. Follow-up work should continue pruning or reshaping copied coding-first surfaces while preserving the renderer, input, fullscreen workspace, command registry, and release bones.
+The public alpha can include mature terminal foundation code, but package-facing behavior must follow Agent product policy. Follow-up work should continue pruning or reshaping coding-first surfaces while preserving the renderer, input, fullscreen workspace, command registry, and release bones.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pellux/goodvibes-agent",
-  "version": "0.1.67",
+  "version": "0.1.69",
   "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/completion.ts

@@ -2,9 +2,6 @@ const COMMANDS = [
   'tui',
   'run',
   'exec',
-  'serve',
-  'web',
-  'service',
   'onboarding',
   'setup',
   'doctor',
@@ -25,9 +22,6 @@ const COMMANDS = [
   'tasks',
   'pair',
   'qrcode',
-  'surfaces',
-  'listener',
-  'control-plane',
   'bundle',
   'remote',
   'bridge',
@@ -44,7 +38,6 @@ const OPTIONS = [
   '--agent-profile',
   '--cd',
   '--working-dir',
-  '--daemon-home',
   '--config',
   '--enable',
   '--disable',
@@ -54,8 +47,6 @@ const OPTIONS = [
   '--output-format',
   '--json',
   '--no-alt-screen',
-  '--port',
-  '--hostname',
   '--open',
   '--resume',
   '--session',

package/src/cli/package-verification.ts

@@ -73,6 +73,10 @@ const PACKAGE_FACING_FORBIDDEN_TEXT = [
   ['Her', 'mes'].join(''),
   ['capabilities', ' audit'].join(''),
   ['capabilities', ' command'].join(''),
+  ['near', '-fork'].join(''),
+  ['goodvibes-agent', 'serve'].join(' '),
+  ['goodvibes-agent', 'service start'].join(' '),
+  ['goodvibes-agent', 'surfaces enable'].join(' '),
   'Every plan must have a multi-agent execution strategy',
   'NEVER skip WRFC',
   'ALWAYS work in parallel when implementing a plan',

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

@@ -35,13 +35,13 @@ export const GUIDANCE_MODE_OPTIONS: readonly OnboardingWizardRadioOption[] = [
 ];
 
 export const PERMISSION_MODE_OPTIONS: readonly OnboardingWizardRadioOption[] = [
-  { id: 'prompt', label: 'Ask before powerful actions', hint: 'Prompt before write, edit, network, and execution tools.' },
-  { id: 'allow-all', label: 'Allow everything', hint: 'Allow tools without approval prompts.' },
-  { id: 'custom', label: 'Custom advanced rules', hint: 'Use tool-specific permission rules.' },
+  { id: 'prompt', label: 'Ask first', hint: 'Prompt before write, edit, network, and execution tools.' },
+  { id: 'allow-all', label: 'Allow all', hint: 'Allow tools without approval prompts.' },
+  { id: 'custom', label: 'Custom', hint: 'Use tool-specific permission rules.' },
 ];
 
 export const SECRET_POLICY_OPTIONS: readonly OnboardingWizardRadioOption[] = [
-  { id: 'preferred_secure', label: 'Use secure storage when available', hint: 'Prefer the secure secret backend and fall back only when needed.' },
-  { id: 'require_secure', label: 'Require secure storage', hint: 'Refuse plaintext secret persistence.' },
-  { id: 'plaintext_allowed', label: 'Allow plaintext storage', hint: 'Permit local plaintext secret storage.' },
+  { id: 'preferred_secure', label: 'Secure', hint: 'Prefer the secure secret backend and fall back only when needed.' },
+  { id: 'require_secure', label: 'Require secure', hint: 'Refuse plaintext secret persistence.' },
+  { id: 'plaintext_allowed', label: 'Plaintext allowed', hint: 'Permit local plaintext secret storage.' },
 ];

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

@@ -112,5 +112,5 @@ export function getOnboardingWizardBodyRows(viewportHeight: number): number {
 }
 
 export function getOnboardingWizardVisibleFieldCount(viewportHeight: number): number {
-  return Math.max(1, getOnboardingWizardBodyRows(viewportHeight) - 6);
+  return Math.max(1, getOnboardingWizardBodyRows(viewportHeight) - 8);
 }

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

@@ -27,7 +27,7 @@ function buildApplyAndContinueAction(step: OnboardingWizardStepDefinition): Onbo
     kind: 'action',
     id: `${step.id}.apply-and-continue`,
     action: 'apply-and-continue',
-    label: 'Apply & Continue To Next Section',
+    label: 'Apply & Continue',
     hint: 'Save the current wizard selections in this onboarding session and move to the next section. Settings are persisted on the final Review apply.',
     defaultValue: 'Apply & next',
     spacerBeforeRows: 2,
@@ -179,7 +179,7 @@ export function buildAgentSetupStep(controller: OnboardingWizardController): Onb
         id: 'agent-setup.identity',
         label: 'Product identity',
         hint: 'GoodVibes Agent is a personal operator TUI with Agent-local profiles, memory, skills, personas, routines, and isolated Agent Knowledge.',
-        defaultValue: 'Agent operator',
+        defaultValue: 'Operator',
       },
       {
         kind: 'status',
@@ -188,7 +188,7 @@ export function buildAgentSetupStep(controller: OnboardingWizardController): Onb
         hint: collectionIssues > 0
           ? `${collectionIssues} setup snapshot issue(s) were reported. Status and doctor commands show connection details.`
           : 'Agent connects to an already-running GoodVibes runtime for companion chat, work plans, approvals, automation, and Agent Knowledge.',
-        defaultValue: collectionIssues > 0 ? `${collectionIssues} issue(s)` : 'External service',
+        defaultValue: collectionIssues > 0 ? `${collectionIssues} issue(s)` : 'External',
       },
       {
         kind: 'radio',
@@ -203,7 +203,7 @@ export function buildAgentSetupStep(controller: OnboardingWizardController): Onb
         id: 'agent-setup.profile-guide',
         label: 'Agent profiles',
         hint: 'Use /agent-profile guide after setup to create household, research, travel, operations, or custom Agent profiles.',
-        defaultValue: 'Local profiles',
+        defaultValue: 'Profiles',
       },
     ],
   };

package/src/renderer/onboarding/onboarding-wizard.ts

@@ -112,13 +112,18 @@ function buildFieldRows(
   if (selectedRowIndex >= start + capacity) start = selectedRowIndex - capacity + 1;
   start = clamp(start, 0, maxStart);
 
-  if (start > 0 && selectedRowIndex === start) start = Math.max(0, start - 1);
-  if (start + capacity < allRows.length && selectedRowIndex === start + capacity - 1) {
+  if (capacity > 1 && start > 0 && selectedRowIndex === start) start = Math.max(0, start - 1);
+  if (capacity > 1 && start + capacity < allRows.length && selectedRowIndex === start + capacity - 1) {
     start = Math.min(maxStart, start + 1);
   }
 
   rows.push(...allRows.slice(start, start + capacity));
-  if (start > 0 && rows.length > 0) {
+  const firstVisibleRow = rows[0];
+  if (
+    start > 0
+    && rows.length > 0
+    && !(firstVisibleRow?.kind === 'field' && firstVisibleRow.absoluteIndex === selectedFieldIndex)
+  ) {
     rows[0] = {
       kind: 'moreAbove',
       text: `${OVERLAY_GLYPHS.moreAbove} ${start} more above`,
@@ -126,7 +131,12 @@ function buildFieldRows(
   }
 
   const hiddenBelow = Math.max(0, allRows.length - (start + capacity));
-  if (hiddenBelow > 0 && rows.length > 0) {
+  const lastVisibleRow = rows[rows.length - 1];
+  if (
+    hiddenBelow > 0
+    && rows.length > 0
+    && !(lastVisibleRow?.kind === 'field' && lastVisibleRow.absoluteIndex === selectedFieldIndex)
+  ) {
     rows[rows.length - 1] = {
       kind: 'moreBelow',
       text: `${OVERLAY_GLYPHS.moreBelow} ${hiddenBelow} more below`,
@@ -253,9 +263,9 @@ function footerText(wizard: OnboardingWizardController): string {
 
 function controlsText(wizard: OnboardingWizardController): string {
   if (wizard.isEditingTextField()) {
-    return 'Controls: Enter saves this value, Esc cancels editing, Backspace deletes one character, Delete or Ctrl+U clears the field.';
+    return 'Controls: Enter saves, Esc cancels, Backspace deletes, Del clears.';
   }
-  return 'Controls: Enter or Space changes the selected row; Delete or Ctrl+U clears selected text inputs; Tab/Shift+Tab changes screens; arrows move.';
+  return 'Controls: Enter selects, Del clears, Tab moves.';
 }
 
 function renderWideLayout(
@@ -302,8 +312,9 @@ function renderWideLayout(
     `Fields ${wizard.getCompletedFieldCount(wizard.stepIndex)}/${wizard.getStepFieldCount(wizard.stepIndex)} complete`,
     changedScreensLabel(wizard),
   ];
-  const fieldStartRow = 6;
   const selectedText = selectedFieldText(wizard);
+  const selectedHintLines = wrapText(selectedText.hint, Math.max(18, centerWidth - 2)).slice(0, 3);
+  const fieldStartRow = 8;
   const fieldRows = buildFieldRows(wizard, visibleFields, Math.max(0, bodyRows - fieldStartRow));
 
   const topLine = createOverlayFilledBorderLine(
@@ -397,9 +408,9 @@ function renderWideLayout(
         bg: DEFAULT_OVERLAY_PALETTE.selectedBg,
         bold: true,
       });
-    } else if (row === 5) {
+    } else if (row >= 5 && row <= 7) {
       fillWidth(line, centerStart, centerWidth, DEFAULT_OVERLAY_PALETTE.selectedBg);
-      putOverlayText(line, centerStart + 1, centerWidth - 2, truncateDisplay(selectedText.hint, centerWidth - 2), {
+      putOverlayText(line, centerStart + 1, centerWidth - 2, selectedHintLines[row - 5] ?? '', {
         fg: UI_TONES.fg.secondary,
         bg: DEFAULT_OVERLAY_PALETTE.selectedBg,
       });
@@ -482,8 +493,9 @@ function renderCollapsedLayout(
   const innerStart = layout.margin + 1;
   const innerWidth = layout.innerWidth;
   const descriptionLines = wrapText(currentStep.description, Math.max(14, innerWidth - 2)).slice(0, 2);
-  const fieldStartRow = 6;
   const selectedText = selectedFieldText(wizard);
+  const selectedHintLines = wrapText(selectedText.hint, Math.max(14, innerWidth - 2)).slice(0, 3);
+  const fieldStartRow = 8;
   const fieldRows = buildFieldRows(wizard, visibleFields, Math.max(0, bodyRows - fieldStartRow));
 
   const topLine = createOverlayFilledBorderLine(
@@ -559,9 +571,9 @@ function renderCollapsedLayout(
         bg: DEFAULT_OVERLAY_PALETTE.selectedBg,
         bold: true,
       });
-    } else if (row === 5) {
+    } else if (row >= 5 && row <= 7) {
       fillWidth(line, innerStart, innerWidth, DEFAULT_OVERLAY_PALETTE.selectedBg);
-      putOverlayText(line, innerStart + 1, innerWidth - 2, truncateDisplay(selectedText.hint, innerWidth - 2), {
+      putOverlayText(line, innerStart + 1, innerWidth - 2, selectedHintLines[row - 5] ?? '', {
         fg: UI_TONES.fg.secondary,
         bg: DEFAULT_OVERLAY_PALETTE.selectedBg,
       });

package/src/runtime/index.ts

@@ -2,7 +2,7 @@
  * Runtime module barrel for GoodVibes Agent.
  *
  * SDK 0.33 intentionally removed private deep imports and the runtime root
- * god-barrel. This file keeps the near-fork Agent app on public SDK seams
+ * god-barrel. This file keeps the Agent app on public SDK seams
  * while preserving the local import surface used by the shell.
  */
 

package/src/tools/wrfc-agent-guard.ts

@@ -783,7 +783,7 @@ function narrowStringEnumProperty(
   property.description = description;
 }
 
-// Compatibility exports for copied TUI tests/imports during the near-fork phase.
+// Compatibility exports for inherited terminal-foundation tests/imports.
 export const installWrfcAgentToolGuard = installAgentToolPolicyGuard;
 export const wrapWrfcAgentTool = wrapAgentToolForAgentPolicy;
 export const validateWrfcAgentToolInvocation = validateAgentToolInvocationForAgentPolicy;

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