@pellux/goodvibes-agent 0.1.71 → 0.1.73

package/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 All notable changes to GoodVibes Agent will be recorded here.
 
+## 0.1.73 - 2026-05-31
+
+- Replaced copied first-run capability language with Agent-specific setup: operator TUI, provider access, isolated Agent Knowledge, local memory/skills, channels, automation review, and explicit TUI delegation.
+- Reworked the fullscreen settings workspace grouping and descriptions around Agent experience, models, local Agent state, tools/automation, and external runtime connection.
+- Added package-facing guards and regressions so copied browser/network/listener setup wording does not return to shipped Agent docs.
+
+## 0.1.72 - 2026-05-31
+
+- Removed copied runtime lifecycle and transport words from the Agent CLI parser, command handler, detailed help, and package exports.
+- Replaced package-facing deployment/service docs with runtime-connection docs focused on the external runtime prerequisite and Agent product boundary.
+- Added regression coverage so hidden lifecycle words are treated as normal TUI prompts instead of supported Agent commands.
+
 ## 0.1.71 - 2026-05-31
 
 - Stopped importing copied TUI slash-command modules that do not belong to the Agent product surface.

package/README.md

@@ -5,7 +5,7 @@
 
 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.
+The Agent product connects to an already-running GoodVibes runtime. It does not install, start, stop, restart, or own runtime hosting.
 
 ## Install
 
@@ -50,7 +50,7 @@ bun run package:install-check
 bun run publish:check
 ```
 
-Inside the Agent TUI, use `/agent`, `/home`, or `/operator` to open the operator workspace. It is the Agent-first fullscreen surface for setup, status, knowledge, local memory/skills, work-plan/approval review, automation observability, and explicit build delegation to GoodVibes TUI.
+Inside the Agent TUI, use `/agent`, `/home`, or `/operator` to open the operator workspace. It is the Agent-first fullscreen workspace for setup, status, knowledge, local memory/skills, work-plan/approval review, automation observability, and explicit build delegation to GoodVibes TUI.
 
 Inside the workspace, use `/agent-profile guide` to author custom profile starters without leaving the Agent TUI. The guided flow lists starters, exports starter JSON, imports edited local starters, and creates isolated Agent profiles from them.
 
@@ -87,22 +87,22 @@ 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 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.
+Agent reports unavailable, unauthenticated, or incompatible runtime state through `goodvibes-agent status`, `goodvibes-agent doctor`, and the TUI status views. It does not provide runtime hosting commands.
 
 ## Product Boundary
 
-GoodVibes Agent owns the operator assistant surface: serial assistant flow, proactive safe actions, local memory/routines/skills/personas, Agent knowledge routes, companion chat, approvals/automation observability, and explicit build delegation.
+GoodVibes Agent owns the operator assistant TUI: serial assistant flow, proactive safe actions, local memory/routines/skills/personas, Agent knowledge routes, companion chat, approvals/automation observability, and explicit build delegation.
 
 Agent Knowledge/Wiki is its own product segment. Agent uses `/api/goodvibes-agent/knowledge/*` and must not fall back to default Knowledge/Wiki or other product-specific knowledge routes.
 
-GoodVibes TUI owns coding execution: file edits, git/worktree workflows, coding panels, runtime-isolation UX, and WRFC execution. Agent may delegate explicit build/fix/review work to TUI through public runtime/session contracts; normal assistant chat must not use shared coding sessions.
+GoodVibes TUI owns coding execution: file edits, git/worktree workflows, coding panels, execution isolation UX, and WRFC execution. Agent may delegate explicit build/fix/review work to TUI through public runtime/session contracts; normal assistant chat must not use shared coding sessions.
 
 ## Package Docs
 
 Package-facing docs:
 
 - [Getting Started](docs/getting-started.md)
-- [Deployment And Services](docs/deployment-and-services.md)
+- [Runtime Connection](docs/runtime-connection.md)
 - [Release And Publishing](docs/release-and-publishing.md)
 
 The package-facing Agent documentation is limited to the docs listed above.

package/docs/README.md

@@ -5,7 +5,7 @@ These are the package-facing docs for GoodVibes Agent, the personal operator ass
 Current package docs:
 
 - [Getting Started](getting-started.md)
-- [Deployment And Services](deployment-and-services.md)
+- [Runtime Connection](runtime-connection.md)
 - [Release And Publishing](release-and-publishing.md)
 
 Important baseline constraints:
@@ -14,11 +14,11 @@ Important baseline constraints:
 - Agent uses Bun and TypeScript-authored source.
 - Agent depends on `@pellux/goodvibes-sdk@0.33.35`.
 - Agent connects to an externally managed GoodVibes runtime.
-- Agent does not start, stop, restart, install, uninstall, or own runtime connectivity or service lifecycle.
+- Agent does not start, stop, restart, install, uninstall, or own runtime hosting.
 - Agent Knowledge/Wiki uses only `/api/goodvibes-agent/knowledge/*`; there is no default Knowledge/Wiki or non-Agent product fallback.
 - Agent supports isolated runtime homes with `GOODVIBES_AGENT_HOME=<path>` and named profile homes with `goodvibes-agent profiles create <name> --template <starter> --yes` plus `--agent-profile <name>`.
 - Agent ships starter profile templates for household, research, travel, operations, and personal productivity local state; `profiles templates export/import` and `/agent-profile guide` support local custom starters.
-- Local personas, routines, and Agent skills are stored under the Agent surface root and are injected only into the serial Agent conversation.
+- Local personas, routines, and Agent skills are stored under the Agent home and are injected only into the serial Agent conversation.
 - 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.
 

package/docs/getting-started.md

@@ -99,7 +99,7 @@ Start the runtime from GoodVibes TUI or the owning host before using runtime-bac
 
 Agent Knowledge/Wiki is an Agent-owned product segment. Agent commands must not fall back to default Knowledge/Wiki or other product-specific knowledge spaces.
 
-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.
+Runtime-hosting commands are not part of GoodVibes Agent. Use `goodvibes-agent status`, `goodvibes-agent doctor`, and the Agent TUI status views for diagnostics.
 
 ## Current Product Notes
 

package/docs/runtime-connection.md

@@ -0,0 +1,37 @@
+# Runtime Connection
+
+GoodVibes Agent is a TUI client for an already-running GoodVibes runtime. The package exposes one executable:
+
+```sh
+goodvibes-agent
+```
+
+The installed command is backed by TypeScript-authored source with a Bun shebang. Package install smoke must verify:
+
+- `goodvibes-agent --help`
+- `goodvibes-agent --version`
+- `goodvibes-agent status --json`
+- `goodvibes-agent` launches the TUI in a real PTY
+
+## Runtime Prerequisite
+
+Start the GoodVibes runtime from the owning GoodVibes host before launching Agent. Agent expects the runtime to expose public operator routes and the isolated Agent Knowledge routes:
+
+```text
+http://127.0.0.1:3421
+/api/goodvibes-agent/knowledge/status
+/api/goodvibes-agent/knowledge/ask
+/api/goodvibes-agent/knowledge/search
+```
+
+If the runtime is unavailable, unauthenticated, or on an incompatible SDK version, Agent commands report actionable diagnostics without printing token values.
+
+## Product Boundary
+
+Agent owns the operator assistant TUI, local profiles, local memory/routines/skills/personas, isolated Agent Knowledge calls, companion chat, approvals/automation visibility, and explicit build delegation.
+
+Agent does not host runtime connectivity. It does not provide commands to install, expose, start, stop, restart, or mutate the runtime host.
+
+Agent Knowledge/Wiki is its own product segment. Agent uses `/api/goodvibes-agent/knowledge/*` only and must not fall back to default Knowledge/Wiki or other product-specific knowledge routes.
+
+Normal assistant chat uses companion chat. Build/fix/review work is delegated explicitly to GoodVibes TUI through public runtime/session contracts, and WRFC is requested only when explicitly asked for delegated build/fix/review work.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pellux/goodvibes-agent",
-  "version": "0.1.71",
+  "version": "0.1.73",
   "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",
@@ -67,7 +67,7 @@
     "CHANGELOG.md",
     "docs/README.md",
     "docs/getting-started.md",
-    "docs/deployment-and-services.md",
+    "docs/runtime-connection.md",
     "docs/release-and-publishing.md"
   ],
   "scripts": {

package/src/cli/agent-knowledge-command.ts

@@ -407,7 +407,7 @@ function buildDelegationBody(task: string, wrfcRequested: boolean): string {
     'Agent policy:',
     '- GoodVibes Agent is not the coding TUI.',
     '- Preserve the full original ask.',
-    '- GoodVibes TUI owns file edits, git/worktree flows, runtime-isolation UX, and any WRFC owner chain.',
+    '- GoodVibes TUI owns file edits, git/worktree flows, execution isolation UX, and any WRFC owner chain.',
     wrfcRequested
       ? '- WRFC was explicitly requested by the Agent user for this build/fix/review delegation.'
       : '- WRFC was not explicitly requested; do not turn this into WRFC solely because it came from Agent.',

package/src/cli/config-overrides.ts

@@ -150,10 +150,6 @@ export function applyRuntimeCommandEndpointFlagOverrides(
   flags: Pick<GoodVibesCliFlags, 'hostname' | 'port'>,
 ): readonly string[] {
   if (flags.hostname === undefined && flags.port === undefined) return [];
-  if (command === 'web') return applyRuntimeEndpointFlagOverrides(configManager, 'web', flags);
-  if (command === 'listener') return applyRuntimeEndpointFlagOverrides(configManager, 'httpListener', flags);
-  if (command === 'control-plane' || command === 'pair' || command === 'serve') {
-    return applyRuntimeEndpointFlagOverrides(configManager, 'controlPlane', flags);
-  }
+  if (command === 'pair') return applyRuntimeEndpointFlagOverrides(configManager, 'controlPlane', flags);
   return [];
 }

package/src/cli/entrypoint.ts

@@ -88,12 +88,6 @@ export async function prepareShellCliRuntime(
     process.exit(0);
   }
 
-  if (cli.command === 'serve') {
-    console.error(`${binary} connects to an already-running GoodVibes runtime and does not start or own runtime lifecycle.`);
-    console.error('Start or manage the runtime from GoodVibes TUI or host tooling, then run this Agent against it.');
-    process.exit(2);
-  }
-
   let ownership: ShellEntrypointOwnership;
   try {
     ownership = resolveShellEntrypointOwnership(

package/src/cli/help.ts

@@ -232,21 +232,6 @@ const COMMAND_HELP: Record<string, CommandHelp> = {
     summary: 'Inspect in-process runtime tasks. Agent blocks copied task submission; use run for one-shot work or delegate for explicit build/fix/review handoff.',
     examples: ['tasks list', 'tasks show task-123', 'run "check provider readiness"', 'delegate "fix the failing tests"'],
   },
-  surfaces: {
-    usage: ['surfaces [list]', 'surfaces check', 'surfaces show <surfaceId>'],
-    summary: 'Inspect advanced browser, channel, and runtime connection surfaces. Agent does not mutate runtime connection posture.',
-    examples: ['surfaces', 'surfaces check', 'surfaces show slack'],
-  },
-  listener: {
-    usage: ['listener test'],
-    summary: 'Check advanced inbound webhook readiness, network posture, auth, and enabled channel requirements.',
-    examples: ['listener test', 'listener test --json'],
-  },
-  'control-plane': {
-    usage: ['control-plane status'],
-    summary: 'Inspect advanced runtime API reachability, local auth, bootstrap credentials, and operator tokens.',
-    examples: ['control-plane status', 'control-plane status --json'],
-  },
   bundle: {
     usage: ['bundle export [path]', 'bundle inspect <path>', 'bundle import <path>'],
     summary: 'Export, inspect, or import setup/profile/trust/support bundle data.',
@@ -257,31 +242,11 @@ const COMMAND_HELP: Record<string, CommandHelp> = {
     summary: 'Print companion pairing connection details and a QR code.',
     examples: ['pair', 'qrcode'],
   },
-  web: {
-    usage: ['web [--open]'],
-    summary: 'Show the configured browser surface URL, bind address, and enablement state.',
-    examples: ['web', 'web --open', 'web --hostname 0.0.0.0 --port 3423'],
-  },
-  service: {
-    usage: ['service status', 'service check'],
-    summary: 'Inspect the externally owned GoodVibes runtime service posture. Agent does not install, start, stop, restart, or uninstall the runtime.',
-    examples: ['service status', 'service check --json'],
-  },
   completion: {
     usage: ['completion <bash|zsh|fish>'],
     summary: 'Generate shell completion scripts.',
     examples: ['completion bash', 'completion zsh'],
   },
-  serve: {
-    usage: ['serve [--hostname <host>] [--port <port>]', 'daemon [--hostname <host>] [--port <port>]'],
-    summary: 'Unavailable in GoodVibes Agent. Agent connects to an already-running GoodVibes runtime owned by GoodVibes TUI/host tooling.',
-    examples: [],
-  },
-  remote: {
-    usage: ['remote', 'bridge'],
-    summary: 'Inspect remote runner/node posture and bridge readiness.',
-    examples: ['remote', 'bridge'],
-  },
 };
 
 const HELP_ALIASES: Record<string, string> = {
@@ -295,16 +260,8 @@ const HELP_ALIASES: Record<string, string> = {
   secret: 'secrets',
   session: 'sessions',
   task: 'tasks',
-  surface: 'surfaces',
-  webhook: 'listener',
-  controlplane: 'control-plane',
-  cp: 'control-plane',
   qrcode: 'pair',
   qr: 'pair',
-  daemon: 'serve',
-  server: 'serve',
-  services: 'service',
-  bridge: 'remote',
 };
 
 function normalizeHelpTopic(topic: string): string {

package/src/cli/index.ts

@@ -5,7 +5,5 @@ export * from './status.ts';
 export * from './completion.ts';
 export * from './config-overrides.ts';
 export * from './endpoints.ts';
-export * from './surface-command.ts';
-export * from './service-command.ts';
 export * from './bundle-command.ts';
 export * from './management.ts';

package/src/cli/management-commands.ts

@@ -8,9 +8,8 @@ import { inspectProviderAuth } from '@/runtime/index.ts';
 import { getOrCreateCompanionToken, buildCompanionConnectionInfo, encodeConnectionPayload, formatConnectionBlock } from '@pellux/goodvibes-sdk/platform/pairing';
 import { generateQrMatrix, renderQrToString } from '@pellux/goodvibes-sdk/platform/pairing';
 import { resolveRuntimeEndpointBinding } from './endpoints.ts';
-import { classifyBindPosture, isNetworkFacing } from './network-posture.ts';
 import type { CliCommandRuntime } from './management.ts';
-import { extractAuthorizationCode, formatJsonOrText, hasCommandFlag, openBrowser, probeTcp, readAuthPaths, urlHostForBindHost, withRuntimeServices, yesNo } from './management.ts';
+import { extractAuthorizationCode, formatJsonOrText, hasCommandFlag, openBrowser, urlHostForBindHost, withRuntimeServices, yesNo } from './management.ts';
 import { GOODVIBES_AGENT_PAIRING_SURFACE } from '../config/surface.ts';
 
 export async function renderSubscriptions(runtime: CliCommandRuntime): Promise<string> {
@@ -300,71 +299,6 @@ export async function handleTasks(runtime: CliCommandRuntime): Promise<string> {
   });
 }
 
-export interface ControlPlaneStatusResult {
-  readonly enabled: unknown;
-  readonly hostMode: string;
-  readonly configuredHost: string;
-  readonly host: string;
-  readonly port: number;
-  readonly posture: ReturnType<typeof classifyBindPosture>;
-  readonly reachable: boolean;
-  readonly auth: ReturnType<typeof readAuthPaths>;
-  readonly service: {
-    readonly enabled: unknown;
-    readonly autostart: unknown;
-    readonly restartOnFailure: unknown;
-  };
-  readonly issues: readonly string[];
-}
-
-export async function buildControlPlaneStatusResult(runtime: CliCommandRuntime): Promise<ControlPlaneStatusResult> {
-  const binding = resolveRuntimeEndpointBinding(runtime.configManager, 'controlPlane');
-  const enabled = runtime.configManager.get('controlPlane.enabled');
-  const reachable = enabled === true ? await probeTcp(binding.host, binding.port) : false;
-  const auth = readAuthPaths(runtime);
-  const service = {
-    enabled: runtime.configManager.get('service.enabled'),
-    autostart: runtime.configManager.get('service.autostart'),
-    restartOnFailure: runtime.configManager.get('service.restartOnFailure'),
-  };
-  const issues: string[] = [];
-  if (enabled === true && !reachable) issues.push(`Runtime API is enabled but not reachable on ${binding.host}:${binding.port}.`);
-  if (enabled === true && service.enabled !== true) issues.push('Runtime API is enabled on the external runtime config, but Agent service ownership is disabled.');
-  if (enabled === true && service.autostart !== true) issues.push('Runtime API is enabled on the external runtime config, but autostart is off.');
-  if (enabled === true && service.restartOnFailure !== true) issues.push('Runtime API is enabled on the external runtime config, but restart-on-failure is off.');
-  if (isNetworkFacing(enabled, binding) && !auth.userStorePresent) issues.push('Network-facing Runtime API has no local auth user store.');
-  if (isNetworkFacing(enabled, binding) && auth.bootstrapCredentialPresent) issues.push('Network-facing Runtime API still has a bootstrap credential file.');
-  return {
-    enabled,
-    ...binding,
-    posture: classifyBindPosture(binding),
-    reachable,
-    auth,
-    service,
-    issues,
-  };
-}
-
-export function formatControlPlaneStatus(runtime: CliCommandRuntime, value: ControlPlaneStatusResult): string {
-  return formatJsonOrText(runtime.cli)(value, [
-    'GoodVibes runtime API status',
-    `  enabled: ${yesNo(value.enabled)}`,
-    `  bind: ${value.hostMode} ${value.host}:${value.port}`,
-    `  bind posture: ${value.posture.label}`,
-    `  reachable: ${yesNo(value.reachable)}`,
-    `  service: enabled=${yesNo(value.service.enabled)} autostart=${yesNo(value.service.autostart)} restartOnFailure=${yesNo(value.service.restartOnFailure)}`,
-    `  local auth users: ${value.auth.userStorePresent ? 'present' : 'missing'}`,
-    `  bootstrap credential: ${value.auth.bootstrapCredentialPresent ? 'present' : 'missing'}`,
-    `  operator tokens: ${value.auth.operatorTokenPresent ? 'present' : 'missing'}`,
-    value.issues.length === 0 ? '  readiness: ready' : '  readiness: needs attention',
-    ...value.issues.map((issue) => `    - ${issue}`),
-  ].join('\n'));
-}
-
-export async function renderControlPlaneStatus(runtime: CliCommandRuntime): Promise<string> {
-  return formatControlPlaneStatus(runtime, await buildControlPlaneStatusResult(runtime));
-}
-
 export async function renderPairing(runtime: CliCommandRuntime): Promise<string> {
   const daemonHomeDir = join(runtime.homeDirectory, '.goodvibes', 'daemon');
   const tokenRecord = getOrCreateCompanionToken(GOODVIBES_AGENT_PAIRING_SURFACE, { daemonHomeDir });
@@ -380,45 +314,3 @@ export async function renderPairing(runtime: CliCommandRuntime): Promise<string>
   const qr = renderQrToString(generateQrMatrix(payload));
   return [formatConnectionBlock(info, payload), '', qr].join('\n');
 }
-
-export async function renderRemote(runtime: CliCommandRuntime, label: 'remote' | 'bridge'): Promise<string> {
-  return await withRuntimeServices(runtime, (services) => {
-    const pools = services.remoteRunnerRegistry.listPools?.() ?? [];
-    const contracts = services.remoteRunnerRegistry.listContracts();
-    const artifacts = services.remoteRunnerRegistry.listArtifacts();
-    const value = {
-      pools: pools.length,
-      contracts: contracts.length,
-      artifacts: artifacts.length,
-      remoteFetchPrivateHosts: runtime.configManager.get('network.remoteFetch.allowPrivateHosts'),
-    };
-    return formatJsonOrText(runtime.cli)(value, [
-      `GoodVibes ${label} status`,
-      `  runner pools: ${value.pools}`,
-      `  contracts: ${value.contracts}`,
-      `  review artifacts: ${value.artifacts}`,
-      `  private-host remote fetch: ${yesNo(value.remoteFetchPrivateHosts)}`,
-    ].join('\n'));
-  });
-}
-
-export function renderWeb(runtime: CliCommandRuntime): string {
-  const binding = resolveRuntimeEndpointBinding(runtime.configManager, 'web');
-  const publicBaseUrl = String(runtime.configManager.get('web.publicBaseUrl') ?? '');
-  const hasEndpointOverride = runtime.cli.flags.hostname !== undefined || runtime.cli.flags.port !== undefined;
-  const url = !hasEndpointOverride && publicBaseUrl
-    ? publicBaseUrl
-    : `http://${urlHostForBindHost(binding.host)}:${binding.port}`;
-  const value = {
-    enabled: runtime.configManager.get('web.enabled'),
-    ...binding,
-    url,
-  };
-  return formatJsonOrText(runtime.cli)(value, [
-    'GoodVibes web',
-    `  enabled: ${yesNo(value.enabled)}`,
-    `  bind: ${value.hostMode} ${value.host}:${value.port}`,
-    `  url: ${value.url}`,
-    ...(runtime.cli.flags.open ? [`  open: ${openBrowser(value.url)}`] : []),
-  ].join('\n'));
-}

package/src/cli/management.ts

@@ -28,10 +28,8 @@ import { classifyProviderSetup } from './provider-classification.ts';
 import { resolveRuntimeEndpointBinding } from './endpoints.ts';
 import { applyRuntimeEndpointFlagOverrides } from './config-overrides.ts';
 import type { RuntimeEndpointId } from './endpoints.ts';
-import { handleServiceCommand } from './service-command.ts';
 import { handleBundleCommand } from './bundle-command.ts';
-import { buildListenerTestResult, formatListenerTestResult, handleSurfacesCommand } from './surface-command.ts';
-import { buildControlPlaneStatusResult, formatControlPlaneStatus, handleSecrets, handleSessions, handleTasks, renderPairing, renderRemote, renderSubscriptions, renderWeb } from './management-commands.ts';
+import { handleSecrets, handleSessions, handleTasks, renderPairing, renderSubscriptions } from './management-commands.ts';
 import { handleAgentKnowledgeCommand, handleAgentKnowledgeShortcutCommand, handleCompatCommand, handleDelegateCommand } from './agent-knowledge-command.ts';
 import { handleProfilesCommand } from './profiles-command.ts';
 import { handleRoutinesCommand } from './routines-command.ts';
@@ -672,14 +670,6 @@ export async function handleGoodVibesCliCommand(runtime: CliCommandRuntime): Pro
     switch (runtime.cli.command) {
       case 'run':
         return { handled: true, exitCode: await runNonInteractiveAgent(runtime) };
-      case 'web':
-        console.log(renderWeb(runtime));
-        return { handled: true, exitCode: 0 };
-      case 'service': {
-        const result = await handleServiceCommand(runtime);
-        console.log(result.output);
-        return { handled: true, exitCode: result.exitCode };
-      }
       case 'providers': {
         const output = await renderProviders(runtime);
         console.log(output);
@@ -747,21 +737,6 @@ export async function handleGoodVibesCliCommand(runtime: CliCommandRuntime): Pro
         if (output) console.log(output);
         return { handled: true, exitCode: exitCodeForText(output) };
       }
-      case 'surfaces': {
-        const result = await handleSurfacesCommand(runtime);
-        console.log(result.output);
-        return { handled: true, exitCode: result.exitCode };
-      }
-      case 'listener': {
-        const result = await buildListenerTestResult(runtime);
-        console.log(formatListenerTestResult(runtime, result));
-        return { handled: true, exitCode: result.issues.length > 0 ? 1 : 0 };
-      }
-      case 'control-plane': {
-        const result = await buildControlPlaneStatusResult(runtime);
-        console.log(formatControlPlaneStatus(runtime, result));
-        return { handled: true, exitCode: result.issues.length > 0 ? 1 : 0 };
-      }
       case 'pair':
         console.log(await renderPairing(runtime));
         return { handled: true, exitCode: 0 };
@@ -770,12 +745,6 @@ export async function handleGoodVibesCliCommand(runtime: CliCommandRuntime): Pro
         console.log(result.output);
         return { handled: true, exitCode: result.exitCode };
       }
-      case 'remote':
-        console.log(await renderRemote(runtime, 'remote'));
-        return { handled: true, exitCode: 0 };
-      case 'bridge':
-        console.log(await renderRemote(runtime, 'bridge'));
-        return { handled: true, exitCode: 0 };
       default:
         return { handled: false, exitCode: 0 };
     }

package/src/cli/package-verification.ts

@@ -39,7 +39,7 @@ const REQUIRED_TARBALL_PATHS = [
   'tsconfig.json',
   'docs/README.md',
   'docs/getting-started.md',
-  'docs/deployment-and-services.md',
+  'docs/runtime-connection.md',
   'docs/release-and-publishing.md',
 ] as const;
 const FORBIDDEN_TARBALL_PREFIXES = ['.github/', 'src/test/', 'src/.test/', '.goodvibes/', 'vendor/'] as const;
@@ -53,7 +53,7 @@ const PACKAGE_FACING_TEXT_PATHS = [
   'CHANGELOG.md',
   'docs/README.md',
   'docs/getting-started.md',
-  'docs/deployment-and-services.md',
+  'docs/runtime-connection.md',
   'docs/release-and-publishing.md',
 ] as const;
 const PACKAGE_FACING_FORBIDDEN_TEXT = [
@@ -74,9 +74,22 @@ const PACKAGE_FACING_FORBIDDEN_TEXT = [
   ['capabilities', ' audit'].join(''),
   ['capabilities', ' command'].join(''),
   ['near', '-fork'].join(''),
+  ['Optional ', 'Browser Access'].join(''),
+  ['Optional ', 'Other-Device Access'].join(''),
+  ['Optional ', 'Incoming Events'].join(''),
+  ['Service ', '& Network'].join(''),
+  ['Surfaces ', '& Integrations'].join(''),
+  ['runtime', '-isolation'].join(''),
   ['goodvibes-agent', 'serve'].join(' '),
-  ['goodvibes-agent', 'service start'].join(' '),
-  ['goodvibes-agent', 'surfaces enable'].join(' '),
+  ['goodvibes-agent', 'service'].join(' '),
+  ['goodvibes-agent', 'services'].join(' '),
+  ['goodvibes-agent', 'surfaces'].join(' '),
+  ['goodvibes-agent', 'surface'].join(' '),
+  ['goodvibes-agent', 'listener'].join(' '),
+  ['goodvibes-agent', 'control-plane'].join(' '),
+  ['goodvibes-agent', 'remote'].join(' '),
+  ['goodvibes-agent', 'bridge'].join(' '),
+  ['goodvibes-agent', 'web'].join(' '),
   'Every plan must have a multi-agent execution strategy',
   'NEVER skip WRFC',
   'ALWAYS work in parallel when implementing a plan',
@@ -92,6 +105,7 @@ const PACKAGE_FACING_REQUIRED_TEXT: readonly {
   { path: 'README.md', required: ['/api/goodvibes-agent/knowledge'] },
   { path: 'docs/README.md', required: ['/api/goodvibes-agent/knowledge'] },
   { path: 'docs/getting-started.md', required: ['/api/goodvibes-agent/knowledge'] },
+  { path: 'docs/runtime-connection.md', required: ['/api/goodvibes-agent/knowledge'] },
   { path: 'docs/release-and-publishing.md', required: ['/api/goodvibes-agent/knowledge'] },
 ];
 

package/src/cli/parser.ts

@@ -11,12 +11,6 @@ const COMMAND_ALIASES: Readonly<Record<string, GoodVibesCliCommand>> = {
   run: 'run',
   exec: 'run',
   e: 'run',
-  serve: 'serve',
-  daemon: 'serve',
-  server: 'serve',
-  web: 'web',
-  service: 'service',
-  services: 'service',
   status: 'status',
   doctor: 'doctor',
   onboarding: 'onboarding',
@@ -51,18 +45,8 @@ const COMMAND_ALIASES: Readonly<Record<string, GoodVibesCliCommand>> = {
   pair: 'pair',
   qrcode: 'pair',
   qr: 'pair',
-  surfaces: 'surfaces',
-  surface: 'surfaces',
-  listener: 'listener',
-  'http-listener': 'listener',
-  webhook: 'listener',
-  'control-plane': 'control-plane',
-  controlplane: 'control-plane',
-  cp: 'control-plane',
   bundle: 'bundle',
   bundles: 'bundle',
-  remote: 'remote',
-  bridge: 'bridge',
   completion: 'completion',
   completions: 'completion',
   help: 'help',

package/src/cli/status.ts

@@ -163,7 +163,7 @@ export function buildCliDoctorFindings(options: CliStatusOptions): readonly CliD
         summary: issue,
         cause: 'The service lifecycle inspection found a mismatch between configured service/surface state and observed host state.',
         impact: 'Runtime API, listener, or web availability may not match the configuration.',
-        action: 'Use goodvibes-agent service check for read-only detail, then manage the runtime from GoodVibes TUI or your host tooling.',
+        action: 'Use Agent status and doctor diagnostics here, then manage the runtime from GoodVibes TUI or your host tooling.',
       });
     }
   }

package/src/cli/types.ts

@@ -1,9 +1,6 @@
 export type GoodVibesCliCommand =
   | 'tui'
   | 'run'
-  | 'serve'
-  | 'web'
-  | 'service'
   | 'status'
   | 'doctor'
   | 'onboarding'
@@ -22,12 +19,7 @@ export type GoodVibesCliCommand =
   | 'sessions'
   | 'tasks'
   | 'pair'
-  | 'surfaces'
-  | 'listener'
-  | 'control-plane'
   | 'bundle'
-  | 'remote'
-  | 'bridge'
   | 'completion'
   | 'help'
   | 'version'