@pellux/goodvibes-agent 0.1.71 → 0.1.72

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 All notable changes to GoodVibes Agent will be recorded here.
 
+## 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
 
@@ -87,7 +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 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
 
@@ -102,7 +102,7 @@ GoodVibes TUI owns coding execution: file edits, git/worktree workflows, coding
 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,7 +14,7 @@ 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.

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.72",
   "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/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 = [
@@ -75,8 +75,15 @@ const PACKAGE_FACING_FORBIDDEN_TEXT = [
   ['capabilities', ' command'].join(''),
   ['near', '-fork'].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 +99,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'

package/src/panels/confirm-state.ts

@@ -2,7 +2,7 @@
 // useConfirmState<T> — reusable inline y/n confirmation helper
 //
 // Pattern (chosen over ConfirmableListPanel base class):
-//   - Composable: any panel holds a ConfirmState field, not a new base class
+//   - Composable: each panel holds a ConfirmState field, not a new base class
 //   - Identical y/n UX everywhere: y confirms, n/Esc cancels, any other key
 //     is absorbed (does nothing) while confirm is active
 //   - Render: caller calls renderConfirmLines(width, state) to get the two

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

package/docs/deployment-and-services.md

@@ -1,52 +0,0 @@
-# Deployment And Services
-
-GoodVibes Agent is a client/operator TUI. It connects to an already-running GoodVibes runtime and does not own runtime or listener deployment.
-
-## Runtime Ownership
-
-Agent must not:
-
-- start an embedded runtime
-- start an embedded HTTP listener
-- install or uninstall OS services
-- 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. Agent reports external runtime readiness but does not configure that host.
-
-## Agent Runtime
-
-The installed package exposes one executable:
-
-```sh
-goodvibes-agent
-```
-
-The executable 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
-- `goodvibes-agent smoke --json` when that command is available in the baseline being tested
-
-## External Runtime Connection
-
-Agent reads configuration and tokens, then connects to an already-running GoodVibes runtime. The default local control-plane URL is normally:
-
-```text
-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.
-
-## Release Rule
-
-Only publish Agent releases that preserve the Agent product policy:
-
-- serial/proactive assistant by default
-- local memory/routines/skills/personas until shared registries are stable
-- Agent knowledge routes only for Agent wiki calls
-- companion chat for normal assistant chat
-- explicit delegation to GoodVibes TUI for build/fix/review work
-- WRFC only when explicitly requested for delegated build/fix/review work

package/src/cli/service-command.ts

@@ -1,26 +0,0 @@
-import type { CliCommandRuntime } from './management.ts';
-import { buildCliServicePosture, formatCliServicePosture } from './service-posture.ts';
-import type { CliCommandOutput } from './types.ts';
-
-export async function handleServiceCommand(runtime: CliCommandRuntime): Promise<CliCommandOutput> {
-  const [sub = 'status'] = runtime.cli.commandArgs;
-  const json = runtime.cli.flags.outputFormat === 'json';
-  if (sub === 'status' || sub === 'check') {
-    const posture = await buildCliServicePosture(runtime, { probe: sub === 'check' });
-    return {
-      output: formatCliServicePosture(posture, json),
-      exitCode: sub === 'check' && posture.issues.length > 0 ? 1 : 0,
-    };
-  }
-  if (sub === 'install' || sub === 'start' || sub === 'restart' || sub === 'stop' || sub === 'uninstall') {
-    const text = 'GoodVibes Agent connects to an existing GoodVibes runtime and does not manage runtime lifecycle. Use GoodVibes TUI or host tooling for service mutations.';
-    return {
-      output: json ? JSON.stringify({ ok: false, kind: 'daemon_lifecycle_external', action: sub, error: text }, null, 2) : text,
-      exitCode: 2,
-    };
-  }
-  return {
-    output: `Usage: ${runtime.cli.binary} service [status|check]`,
-    exitCode: 2,
-  };
-}

package/src/cli/surface-command.ts

@@ -1,247 +0,0 @@
-import type { ConfigKey } from '../config/index.ts';
-import {
-  GOODVIBES_NTFY_AGENT_TOPIC,
-  GOODVIBES_NTFY_CHAT_TOPIC,
-  GOODVIBES_NTFY_REMOTE_TOPIC,
-  resolveGoodVibesNtfyTopics,
-} from '@pellux/goodvibes-sdk/platform/integrations';
-import { getMissingSurfaceFeatureFlags } from '../runtime/surface-feature-flags.ts';
-import { resolveRuntimeEndpointBinding } from './endpoints.ts';
-import { classifyBindPosture, isNetworkFacing } from './network-posture.ts';
-import type { CliCommandRuntime } from './management.ts';
-import {
-  formatJsonOrText,
-  isPresentConfigValue,
-  probeTcp,
-  readAuthPaths,
-  yesNo,
-} from './management.ts';
-
-export const SURFACE_CONFIGS = [
-  ['slack', 'Slack', ['surfaces.slack.signingSecret', 'surfaces.slack.botToken']],
-  ['discord', 'Discord', ['surfaces.discord.publicKey', 'surfaces.discord.botToken', 'surfaces.discord.applicationId']],
-  ['telegram', 'Telegram', ['surfaces.telegram.botToken']],
-  ['webhook', 'Webhook', ['surfaces.webhook.secret']],
-  ['ntfy', 'ntfy', ['surfaces.ntfy.baseUrl']],
-  ['googleChat', 'Google Chat', ['surfaces.googleChat.webhookUrl']],
-  ['signal', 'Signal', ['surfaces.signal.bridgeUrl', 'surfaces.signal.account']],
-  ['whatsapp', 'WhatsApp', ['surfaces.whatsapp.accessToken', 'surfaces.whatsapp.phoneNumberId']],
-  ['imessage', 'iMessage', ['surfaces.imessage.bridgeUrl', 'surfaces.imessage.account']],
-  ['msteams', 'Microsoft Teams', ['surfaces.msteams.appId', 'surfaces.msteams.appPassword']],
-  ['bluebubbles', 'BlueBubbles', ['surfaces.bluebubbles.serverUrl', 'surfaces.bluebubbles.password']],
-  ['mattermost', 'Mattermost', ['surfaces.mattermost.baseUrl', 'surfaces.mattermost.botToken']],
-  ['matrix', 'Matrix', ['surfaces.matrix.homeserverUrl', 'surfaces.matrix.accessToken', 'surfaces.matrix.userId']],
-] as const;
-
-export async function handleSurfacesCommand(runtime: CliCommandRuntime): Promise<{ readonly output: string; readonly exitCode: number }> {
-  const config = runtime.configManager;
-  const [sub = 'list', ...rest] = runtime.cli.commandArgs;
-  const target = rest[0];
-  if (sub === 'enable' || sub === 'disable') {
-    if (!target) return { output: `Usage: goodvibes-agent surfaces ${sub} <web|listener|control-plane|surfaceId>`, exitCode: 2 };
-    const text = [
-      'GoodVibes Agent does not mutate runtime, listener, web, or channel surface posture.',
-      'Configure those surfaces from GoodVibes TUI or the external GoodVibes runtime host, then use `goodvibes-agent surfaces check` for read-only diagnostics.',
-    ].join(' ');
-    return {
-      output: formatJsonOrText(runtime.cli)({
-        ok: false,
-        kind: 'daemon_lifecycle_external',
-        action: `surfaces.${sub}`,
-        target,
-        error: text,
-      }, text),
-      exitCode: 2,
-    };
-  }
-  if (sub !== 'list' && sub !== 'status' && sub !== 'check' && sub !== 'show') {
-    return { output: 'Usage: goodvibes-agent surfaces [list|check|show <surfaceId>]', exitCode: 2 };
-  }
-  const controlPlane = resolveRuntimeEndpointBinding(config, 'controlPlane');
-  const web = resolveRuntimeEndpointBinding(config, 'web');
-  const httpListener = resolveRuntimeEndpointBinding(config, 'httpListener');
-  const includeProbe = sub === 'check';
-  const targetExternalSurface = target && SURFACE_CONFIGS.some(([id]) => id === target);
-  const shouldProbeControlPlane = includeProbe && !target;
-  const shouldProbeWeb = includeProbe && !target;
-  const shouldProbeListener = includeProbe && (!target || targetExternalSurface);
-  const [controlPlaneReachable, webReachable, listenerReachable] = includeProbe
-    ? await Promise.all([
-      shouldProbeControlPlane ? probeTcp(controlPlane.host, controlPlane.port) : Promise.resolve(undefined),
-      shouldProbeWeb ? probeTcp(web.host, web.port) : Promise.resolve(undefined),
-      shouldProbeListener ? probeTcp(httpListener.host, httpListener.port) : Promise.resolve(undefined),
-    ])
-    : [undefined, undefined, undefined];
-  const externalSurfaces = SURFACE_CONFIGS.map(([id, label, requiredKeys]) => {
-    const enabled = config.get(`surfaces.${id}.enabled` as ConfigKey);
-    const missing = requiredKeys.filter((key) => !isPresentConfigValue(config.get(key as ConfigKey)));
-    const missingFeatureFlags = enabled === true ? getMissingSurfaceFeatureFlags(config, id) : [];
-    return {
-      id,
-      label,
-      enabled,
-      ready: !enabled || (missing.length === 0 && missingFeatureFlags.length === 0),
-      missing,
-      missingFeatureFlags,
-    };
-  });
-  const filteredSurfaces = target ? externalSurfaces.filter((surface) => surface.id === target) : externalSurfaces;
-  if (target && filteredSurfaces.length === 0) return { output: `Unknown surface: ${target}`, exitCode: 1 };
-  const ntfyTopics = resolveGoodVibesNtfyTopics({
-    chatTopic: String(config.get('surfaces.ntfy.chatTopic' as ConfigKey) || GOODVIBES_NTFY_CHAT_TOPIC),
-    agentTopic: String(config.get('surfaces.ntfy.agentTopic' as ConfigKey) || GOODVIBES_NTFY_AGENT_TOPIC),
-    remoteTopic: String(config.get('surfaces.ntfy.remoteTopic' as ConfigKey) || GOODVIBES_NTFY_REMOTE_TOPIC),
-  });
-  const readinessIssues: string[] = [];
-  if (shouldProbeControlPlane && config.get('controlPlane.enabled') === true && !controlPlaneReachable) {
-    readinessIssues.push(`Control plane is enabled but not reachable on ${controlPlane.host}:${controlPlane.port}.`);
-  }
-  if (shouldProbeWeb && config.get('web.enabled') === true && !webReachable) {
-    readinessIssues.push(`Web surface is enabled but not reachable on ${web.host}:${web.port}.`);
-  }
-  if (shouldProbeListener && config.get('danger.httpListener') === true && !listenerReachable) {
-    readinessIssues.push(`HTTP listener is enabled but not reachable on ${httpListener.host}:${httpListener.port}.`);
-  }
-  for (const surface of filteredSurfaces) {
-    if (surface.enabled !== true) continue;
-    if (config.get('danger.httpListener') !== true) {
-      readinessIssues.push(`${surface.label} is enabled but the HTTP listener is disabled.`);
-    }
-    if (surface.missing.length > 0) {
-      readinessIssues.push(`${surface.label} is enabled but missing ${surface.missing.join(', ')}.`);
-    }
-    if (surface.missingFeatureFlags.length > 0) {
-      readinessIssues.push(`${surface.label} is enabled but feature gates are disabled: ${surface.missingFeatureFlags.join(', ')}.`);
-    }
-  }
-  const value = {
-    controlPlane: {
-      enabled: config.get('controlPlane.enabled'),
-      hostMode: controlPlane.hostMode,
-      configuredHost: controlPlane.configuredHost,
-      host: controlPlane.host,
-      port: controlPlane.port,
-      reachable: controlPlaneReachable,
-    },
-    web: {
-      enabled: config.get('web.enabled'),
-      hostMode: web.hostMode,
-      configuredHost: web.configuredHost,
-      host: web.host,
-      port: web.port,
-      reachable: webReachable,
-    },
-    httpListener: {
-      enabled: config.get('danger.httpListener'),
-      hostMode: httpListener.hostMode,
-      configuredHost: httpListener.configuredHost,
-      host: httpListener.host,
-      port: httpListener.port,
-      reachable: listenerReachable,
-    },
-    surfaces: filteredSurfaces,
-    readinessIssues,
-  };
-  const output = formatJsonOrText(runtime.cli)(value, [
-    'GoodVibes Agent surfaces',
-    `  control-plane: ${yesNo(value.controlPlane.enabled)} (${value.controlPlane.hostMode} ${value.controlPlane.host}:${value.controlPlane.port})${includeProbe ? ` reachable=${yesNo(value.controlPlane.reachable)}` : ''}`,
-    `  web: ${yesNo(value.web.enabled)} (${value.web.hostMode} ${value.web.host}:${value.web.port})${includeProbe ? ` reachable=${yesNo(value.web.reachable)}` : ''}`,
-    `  http-listener: ${yesNo(value.httpListener.enabled)} (${value.httpListener.hostMode} ${value.httpListener.host}:${value.httpListener.port})${includeProbe ? ` reachable=${yesNo(value.httpListener.reachable)}` : ''}`,
-    '',
-    'External surfaces:',
-    ...value.surfaces.map((surface) => `  ${surface.label.padEnd(16)} enabled=${yesNo(surface.enabled)} ready=${yesNo(surface.ready)}${surface.enabled && surface.missing.length > 0 ? ` missing=${surface.missing.join(',')}` : ''}${surface.enabled && surface.missingFeatureFlags.length > 0 ? ` featureGates=${surface.missingFeatureFlags.join(',')}` : ''}`),
-    ...(filteredSurfaces.some((surface) => surface.id === 'ntfy') ? [
-      '',
-      'ntfy inbound topics:',
-      `  chat: ${ntfyTopics.chatTopic}`,
-      `  agent: ${ntfyTopics.agentTopic}`,
-      `  runtime-only remote: ${ntfyTopics.remoteTopic}`,
-      `  default delivery topic: ${String(config.get('surfaces.ntfy.topic') || '(none)')}`,
-    ] : []),
-    ...(includeProbe ? [
-      readinessIssues.length === 0 ? 'Readiness: ready' : 'Readiness: needs attention',
-      ...readinessIssues.map((issue) => `  - ${issue}`),
-    ] : []),
-  ].join('\n'));
-  return { output, exitCode: includeProbe && readinessIssues.length > 0 ? 1 : 0 };
-}
-
-export interface ListenerTestResult {
-  readonly enabled: unknown;
-  readonly hostMode: string;
-  readonly configuredHost: string;
-  readonly host: string;
-  readonly port: number;
-  readonly posture: ReturnType<typeof classifyBindPosture>;
-  readonly reachable: boolean;
-  readonly service: {
-    readonly enabled: unknown;
-    readonly autostart: unknown;
-    readonly restartOnFailure: unknown;
-  };
-  readonly auth: ReturnType<typeof readAuthPaths>;
-  readonly surfaces: readonly {
-    readonly id: string;
-    readonly label: string;
-    readonly enabled: unknown;
-    readonly ready: boolean;
-    readonly missing: readonly string[];
-    readonly missingFeatureFlags: readonly string[];
-  }[];
-  readonly issues: readonly string[];
-}
-
-export async function buildListenerTestResult(runtime: CliCommandRuntime): Promise<ListenerTestResult> {
-  const enabled = runtime.configManager.get('danger.httpListener');
-  const binding = resolveRuntimeEndpointBinding(runtime.configManager, 'httpListener');
-  const posture = classifyBindPosture(binding);
-  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 surfaces = SURFACE_CONFIGS.map(([id, label, requiredKeys]) => {
-    const surfaceEnabled = runtime.configManager.get(`surfaces.${id}.enabled` as ConfigKey);
-    const missing = requiredKeys.filter((key) => !isPresentConfigValue(runtime.configManager.get(key as ConfigKey)));
-    const missingFeatureFlags = surfaceEnabled === true ? getMissingSurfaceFeatureFlags(runtime.configManager, id) : [];
-    return {
-      id,
-      label,
-      enabled: surfaceEnabled,
-      ready: surfaceEnabled !== true || (missing.length === 0 && missingFeatureFlags.length === 0),
-      missing,
-      missingFeatureFlags,
-    };
-  }).filter((surface) => surface.enabled === true);
-  const issues: string[] = [];
-  if (enabled !== true) issues.push('HTTP listener is disabled.');
-  if (enabled === true && service.enabled !== true) issues.push('HTTP listener is enabled on the external runtime config, but Agent service ownership is disabled.');
-  if (enabled === true && service.autostart !== true) issues.push('HTTP listener is enabled on the external runtime config, but autostart is off.');
-  if (enabled === true && service.restartOnFailure !== true) issues.push('HTTP listener is enabled on the external runtime config, but restart-on-failure is off.');
-  if (isNetworkFacing(enabled, binding) && !auth.userStorePresent) issues.push('Network-facing listener has no local auth user store.');
-  if (isNetworkFacing(enabled, binding) && auth.bootstrapCredentialPresent) issues.push('Network-facing listener still has a bootstrap credential file.');
-  for (const surface of surfaces) {
-    if (surface.missing.length > 0) issues.push(`${surface.label} is enabled but missing ${surface.missing.join(', ')}.`);
-    if (surface.missingFeatureFlags.length > 0) issues.push(`${surface.label} is enabled but feature gates are disabled: ${surface.missingFeatureFlags.join(', ')}.`);
-  }
-  return { enabled, ...binding, posture, reachable, service, auth, surfaces, issues };
-}
-
-export function formatListenerTestResult(runtime: CliCommandRuntime, value: ListenerTestResult): string {
-  return formatJsonOrText(runtime.cli)(value, [
-    'GoodVibes Agent listener test',
-    `  enabled: ${yesNo(value.enabled)}`,
-    `  endpoint: ${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'}`,
-    value.surfaces.length === 0 ? '  enabled webhook surfaces: none' : '  enabled webhook surfaces:',
-    ...value.surfaces.map((surface) => `    ${surface.label}: ready=${yesNo(surface.ready)}${surface.missing.length > 0 ? ` missing=${surface.missing.join(',')}` : ''}${surface.missingFeatureFlags.length > 0 ? ` featureGates=${surface.missingFeatureFlags.join(',')}` : ''}`),
-    value.issues.length === 0 ? '  readiness: ready' : '  readiness: needs attention',
-    ...value.issues.map((issue) => `    - ${issue}`),
-  ].join('\n'));
-}