@pellux/goodvibes-agent 0.1.70 → 0.1.72

package/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 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.
+- Trimmed the built-in panel registry to Agent-relevant approval, automation, auth, provider, security, task, and policy views.
+- Reduced package contents so hidden copied command and panel modules are not shipped with the installed Agent TUI.
+
 ## 0.1.70 - 2026-05-31
 
 - Removed copied TUI coding, runtime lifecycle, and developer-maintenance slash commands from the visible Agent command registry.

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.70",
+  "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",
@@ -16,17 +16,58 @@
     "!src/test",
     "!src/**/*.test.ts",
     "!src/**/__tests__",
+    "!src/input/commands/branch-runtime.ts",
+    "!src/input/commands/control-room-runtime.ts",
+    "!src/input/commands/discovery-runtime.ts",
+    "!src/input/commands/hooks-runtime.ts",
+    "!src/input/commands/incident-runtime.ts",
+    "!src/input/commands/integration-runtime.ts",
+    "!src/input/commands/local-setup.ts",
+    "!src/input/commands/managed-runtime.ts",
+    "!src/input/commands/marketplace-runtime.ts",
+    "!src/input/commands/memory-product-runtime.ts",
+    "!src/input/commands/operator-panel-runtime.ts",
+    "!src/input/commands/platform-services-runtime.ts",
+    "!src/input/commands/profile-sync-runtime.ts",
+    "!src/input/commands/provider.ts",
+    "!src/input/commands/remote-runtime.ts",
+    "!src/input/commands/remote-runtime-pool.ts",
+    "!src/input/commands/remote-runtime-setup.ts",
+    "!src/input/commands/replay-runtime.ts",
+    "!src/input/commands/services-runtime.ts",
+    "!src/input/commands/settings-sync-runtime.ts",
+    "!src/input/commands/share-runtime.ts",
+    "!src/input/commands/skills-runtime.ts",
+    "!src/input/commands/teleport-runtime.ts",
+    "!src/panels/cockpit-panel.ts",
+    "!src/panels/communication-panel.ts",
+    "!src/panels/control-plane-panel.ts",
     "!src/panels/diff-panel.ts",
+    "!src/panels/forensics-panel.ts",
     "!src/panels/git-panel.ts",
+    "!src/panels/hooks-panel.ts",
+    "!src/panels/incident-review-panel.ts",
+    "!src/panels/marketplace-panel.ts",
+    "!src/panels/ops-control-panel.ts",
+    "!src/panels/ops-strategy-panel.ts",
+    "!src/panels/orchestration-panel.ts",
+    "!src/panels/plugins-panel.ts",
+    "!src/panels/remote-panel.ts",
+    "!src/panels/routes-panel.ts",
     "!src/panels/sandbox-panel.ts",
+    "!src/panels/services-panel.ts",
+    "!src/panels/settings-sync-panel.ts",
+    "!src/panels/skills-panel.ts",
+    "!src/panels/watchers-panel.ts",
     "!src/panels/worktree-panel.ts",
     "!src/panels/wrfc-panel.ts",
+    "!src/verification",
     "tsconfig.json",
     "README.md",
     "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/agent/skill-discovery.ts

@@ -0,0 +1,119 @@
+import { promises as fsPromises } from 'node:fs';
+import { join } from 'node:path';
+import type { ShellPathService } from '@/runtime/index.ts';
+import { GOODVIBES_AGENT_SURFACE_ROOT } from '../config/surface.ts';
+
+export type SkillOrigin = 'project-local' | 'global' | 'custom';
+
+export interface SkillRecord {
+  name: string;
+  description: string;
+  path: string;
+  origin: SkillOrigin;
+  dependencies: string[];
+  includes: string[];
+  frontmatter: Record<string, string>;
+}
+
+function parseFrontmatter(content: string): Record<string, string> {
+  const match = content.match(/^---\n([\s\S]*?)\n---/);
+  if (!match) return {};
+  const result: Record<string, string> = {};
+  for (const line of match[1].split('\n')) {
+    const [key, ...rest] = line.split(':');
+    if (key && rest.length > 0) {
+      result[key.trim()] = rest.join(':').trim();
+    }
+  }
+  return result;
+}
+
+function getSkillDirectories(cwd: string, homeDir: string): Array<{ root: string; origin: SkillOrigin }> {
+  return [
+    { root: join(cwd, '.goodvibes', 'skills'), origin: 'project-local' },
+    { root: join(cwd, '.goodvibes', GOODVIBES_AGENT_SURFACE_ROOT, 'skills'), origin: 'project-local' },
+    { root: join(homeDir, '.goodvibes', 'skills'), origin: 'global' },
+    { root: join(homeDir, '.goodvibes', GOODVIBES_AGENT_SURFACE_ROOT, 'skills'), origin: 'global' },
+  ];
+}
+
+async function readSkillFile(path: string, origin: SkillOrigin): Promise<SkillRecord | null> {
+  let content = '';
+  try {
+    content = await fsPromises.readFile(path, 'utf-8');
+  } catch {
+    return null;
+  }
+
+  const frontmatter = parseFrontmatter(content);
+  const body = content.replace(/^---\n[\s\S]*?\n---\n?/, '');
+  const name = frontmatter.name ?? path.split(/[\\/]/).pop()?.replace(/\.md$/, '') ?? 'skill';
+  const description = frontmatter.description ?? frontmatter.summary ?? '';
+  const dependencies = frontmatter.depends_on
+    ? frontmatter.depends_on.split(',').map((item) => item.trim()).filter(Boolean)
+    : [];
+  const includes: string[] = [];
+  const includeRegex = /^@([\w/-]+)/gm;
+  let match: RegExpExecArray | null;
+  while ((match = includeRegex.exec(body)) !== null) {
+    includes.push(match[1]);
+  }
+
+  return {
+    name,
+    description,
+    path,
+    origin,
+    dependencies,
+    includes,
+    frontmatter,
+  };
+}
+
+async function scanSkillDirectory(root: string, origin: SkillOrigin): Promise<SkillRecord[]> {
+  let entries: string[] = [];
+  try {
+    entries = await fsPromises.readdir(root);
+  } catch {
+    return [];
+  }
+
+  const records: SkillRecord[] = [];
+  for (const entry of entries.sort((a, b) => a.localeCompare(b))) {
+    if (entry.endsWith('.md')) {
+      const record = await readSkillFile(join(root, entry), origin);
+      if (record) records.push(record);
+      continue;
+    }
+
+    const markerPath = join(root, entry, 'SKILL.md');
+    const record = await readSkillFile(markerPath, origin);
+    if (record) records.push(record);
+  }
+
+  return records;
+}
+
+export async function discoverSkills(shellPaths: Pick<ShellPathService, 'workingDirectory' | 'homeDirectory'>): Promise<SkillRecord[]> {
+  const cwd = shellPaths.workingDirectory;
+  const homeDir = shellPaths.homeDirectory;
+  const seen = new Set<string>();
+  const records: SkillRecord[] = [];
+
+  for (const { root, origin } of getSkillDirectories(cwd, homeDir)) {
+    for (const record of await scanSkillDirectory(root, origin)) {
+      if (seen.has(record.name.toLowerCase())) continue;
+      seen.add(record.name.toLowerCase());
+      records.push(record);
+    }
+  }
+
+  return records.sort((a, b) => {
+    const originRank = a.origin === b.origin
+      ? 0
+      : a.origin === 'project-local'
+        ? -1
+        : 1;
+    return originRank || a.name.localeCompare(b.name);
+  });
+}

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'] },
 ];