@pellux/goodvibes-agent 0.1.89 → 0.1.91

package/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 All notable changes to GoodVibes Agent will be recorded here.
 
+## 0.1.91 - 2026-06-01
+
+- efbb82a Expand Agent Knowledge CLI management
+
+## 0.1.90 - 2026-06-01
+
+- 19f67ea Polish Agent command guidance
+
 ## 0.1.89 - 2026-06-01
 
 - 6be201c Fix Agent workspace command targets

package/README.md

@@ -17,6 +17,8 @@ goodvibes-agent --help
 goodvibes-agent status
 goodvibes-agent profiles templates
 goodvibes-agent knowledge status
+goodvibes-agent knowledge list --kind sources
+goodvibes-agent knowledge import-urls ./agent-sources.txt --yes
 ```
 
 If `goodvibes-agent` is not found after installation, add Bun's global bin directory to `PATH`:
@@ -95,6 +97,8 @@ GoodVibes Agent owns the operator assistant TUI: serial assistant flow, proactiv
 
 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.
 
+Agent Knowledge CLI commands can ask/search, inspect sources/nodes/issues, inspect connectors, ingest a URL, import URL/bookmark files, and reindex the Agent segment. Confirmed mutations require `--yes`.
+
 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pellux/goodvibes-agent",
-  "version": "0.1.89",
+  "version": "0.1.91",
   "private": false,
   "description": "GoodVibes personal operator assistant TUI with a proactive Agent product brain, isolated Agent Knowledge, local profiles, routines, skills, personas, and explicit build delegation.",
   "type": "module",

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

@@ -5,6 +5,19 @@ import { summarizeError } from '@pellux/goodvibes-sdk/platform/utils';
 import { SDK_VERSION, VERSION } from '../version.ts';
 import type { CliCommandOutput } from './types.ts';
 import type { CliCommandRuntime } from './management.ts';
+import {
+  formatAsk,
+  formatBatchIngest,
+  formatConnectors,
+  formatEntityList,
+  formatFailure,
+  formatIngest,
+  formatItem,
+  formatMap,
+  formatReindex,
+  formatSearch,
+  formatStatus,
+} from './agent-knowledge-format.ts';
 import { formatJsonOrText, yesNo } from './management.ts';
 
 type JsonRecord = Record<string, unknown>;
@@ -52,10 +65,46 @@ const AGENT_KNOWLEDGE_METHODS = {
     kind: 'agentKnowledge.search',
     route: '/api/goodvibes-agent/knowledge/search',
   },
+  sourcesList: {
+    kind: 'agentKnowledge.sources.list',
+    route: '/api/goodvibes-agent/knowledge/sources',
+  },
+  nodesList: {
+    kind: 'agentKnowledge.nodes.list',
+    route: '/api/goodvibes-agent/knowledge/nodes',
+  },
+  issuesList: {
+    kind: 'agentKnowledge.issues.list',
+    route: '/api/goodvibes-agent/knowledge/issues',
+  },
+  itemGet: {
+    kind: 'agentKnowledge.item.get',
+    route: '/api/goodvibes-agent/knowledge/items/{id}',
+  },
+  map: {
+    kind: 'agentKnowledge.map',
+    route: '/api/goodvibes-agent/knowledge/map',
+  },
+  connectorsList: {
+    kind: 'agentKnowledge.connectors.list',
+    route: '/api/goodvibes-agent/knowledge/connectors',
+  },
   ingestUrl: {
     kind: 'agentKnowledge.ingest.url',
     route: '/api/goodvibes-agent/knowledge/ingest/url',
   },
+  ingestUrls: {
+    kind: 'agentKnowledge.ingest.urls',
+    route: '/api/goodvibes-agent/knowledge/ingest/urls',
+  },
+  ingestBookmarks: {
+    kind: 'agentKnowledge.ingest.bookmarks',
+    route: '/api/goodvibes-agent/knowledge/ingest/bookmarks',
+  },
+  reindex: {
+    kind: 'agentKnowledge.reindex',
+    route: '/api/goodvibes-agent/knowledge/reindex',
+  },
 } as const;
 
 const DELEGATION_METHOD = {
@@ -79,25 +128,6 @@ function readString(record: JsonRecord | null, key: string): string | null {
   return typeof value === 'string' ? value : null;
 }
 
-function readNumber(record: JsonRecord | null, key: string): number | null {
-  const value = record?.[key];
-  return typeof value === 'number' && Number.isFinite(value) ? value : null;
-}
-
-function readBoolean(record: JsonRecord | null, key: string): boolean | null {
-  const value = record?.[key];
-  return typeof value === 'boolean' ? value : null;
-}
-
-function readArray(record: JsonRecord | null, key: string): readonly unknown[] {
-  const value = record?.[key];
-  return Array.isArray(value) ? value : [];
-}
-
-function cleanInline(value: unknown): string {
-  return typeof value === 'string' ? value.replace(/\s+/g, ' ').trim() : '';
-}
-
 function commandValues(args: readonly string[]): string[] {
   const values: string[] = [];
   for (let index = 0; index < args.length; index += 1) {
@@ -265,6 +295,50 @@ async function postAgentKnowledgeJson<TData>(
   return parsed as TData;
 }
 
+function queryRoute(route: string, query: JsonRecord): string {
+  const params = new URLSearchParams();
+  for (const [key, value] of Object.entries(query)) {
+    if (value === undefined || value === null || value === '') continue;
+    if (Array.isArray(value)) {
+      for (const item of value) {
+        if (typeof item === 'string' && item.trim().length > 0) params.append(key, item);
+      }
+      continue;
+    }
+    if (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean') {
+      params.set(key, String(value));
+    }
+  }
+  const suffix = params.toString();
+  return suffix ? `${route}?${suffix}` : route;
+}
+
+async function getAgentKnowledgeJson<TData>(
+  connection: AgentDaemonConnection,
+  route: string,
+  query: JsonRecord = {},
+): Promise<TData> {
+  const response = await fetch(`${connection.baseUrl}${queryRoute(route, query)}`, {
+    headers: {
+      authorization: `Bearer ${connection.token ?? ''}`,
+    },
+  });
+  const text = await response.text();
+  let parsed: unknown = text;
+  if (text.trim()) {
+    try {
+      parsed = JSON.parse(text) as unknown;
+    } catch {
+      parsed = text;
+    }
+  }
+  if (!response.ok) {
+    const detail = isRecord(parsed) && typeof parsed.error === 'string' ? parsed.error : text;
+    throw new Error(`HTTP ${response.status} ${response.statusText}${detail ? `: ${detail}` : ''}`);
+  }
+  return parsed as TData;
+}
+
 function findDisallowedKnowledgeScopeFlag(args: readonly string[]): string | null {
   const disallowed = [
     '--space',
@@ -292,111 +366,6 @@ function formatScopeFlagRejection(flag: string): string {
   ].join('\n');
 }
 
-function sourceLine(value: unknown): string {
-  const record = isRecord(value) ? value : {};
-  const title = cleanInline(record.title)
-    || cleanInline(record.canonicalUri)
-    || cleanInline(record.sourceUri)
-    || cleanInline(record.url)
-    || cleanInline(record.id)
-    || 'untitled';
-  const type = cleanInline(record.sourceType) || cleanInline(record.type) || 'source';
-  const url = cleanInline(record.canonicalUri) || cleanInline(record.sourceUri) || cleanInline(record.url);
-  return url && url !== title ? `[${type}] ${title} (${url})` : `[${type}] ${title}`;
-}
-
-function resultLine(value: unknown): string {
-  const record = isRecord(value) ? value : {};
-  const title = cleanInline(record.title) || cleanInline(record.id) || 'untitled';
-  const id = cleanInline(record.id);
-  const type = cleanInline(record.type) || cleanInline(record.kind) || cleanInline(record.sourceType) || 'result';
-  const score = readNumber(record, 'score');
-  const url = cleanInline(record.url) || cleanInline(record.canonicalUri) || cleanInline(record.sourceUri);
-  const snippet = cleanInline(record.snippet) || cleanInline(record.summary) || cleanInline(record.text);
-  const parts = [
-    `[${type}] ${title}`,
-    id && id !== title ? `id=${id}` : '',
-    score !== null ? `score=${score.toFixed(3)}` : '',
-    url ? `url=${url}` : '',
-  ].filter((part) => part.length > 0);
-  return snippet ? `${parts.join('  ')}\n    ${snippet}` : parts.join('  ');
-}
-
-function formatStatus(data: unknown): string {
-  const record = isRecord(data) ? data : {};
-  const ready = readBoolean(record, 'ready');
-  const sourceCount = readNumber(record, 'sourceCount');
-  const nodeCount = readNumber(record, 'nodeCount');
-  const issueCount = readNumber(record, 'issueCount');
-  const edgeCount = readNumber(record, 'edgeCount');
-  const storagePath = readString(record, 'storagePath');
-  return [
-    'Agent Knowledge status',
-    `  ready: ${ready === null ? 'unknown' : yesNo(ready)}`,
-    `  sources: ${sourceCount ?? 'unknown'}`,
-    `  nodes: ${nodeCount ?? 'unknown'}`,
-    `  edges: ${edgeCount ?? 'unknown'}`,
-    `  issues: ${issueCount ?? 'unknown'}`,
-    storagePath ? `  storage: ${storagePath}` : null,
-    '  route: /api/goodvibes-agent/knowledge/status',
-  ].filter((line): line is string => Boolean(line)).join('\n');
-}
-
-function formatAsk(data: unknown, query: string): string {
-  const record = isRecord(data) ? data : {};
-  const answer = isRecord(record.answer) ? record.answer : record;
-  const text = cleanInline(answer.text) || cleanInline(record.answer) || 'No answer returned.';
-  const confidence = readNumber(answer, 'confidence') ?? readNumber(record, 'confidence');
-  const synthesized = readBoolean(answer, 'synthesized');
-  const sources = readArray(answer, 'sources');
-  const facts = readArray(answer, 'facts');
-  const gaps = readArray(answer, 'gaps');
-  const lines = [
-    `Agent Knowledge answer: ${query}`,
-    text,
-    '',
-    `confidence: ${confidence ?? 'unknown'}${synthesized === null ? '' : `  synthesized: ${yesNo(synthesized)}`}`,
-  ];
-  if (sources.length > 0) {
-    lines.push('', 'Sources:', ...sources.slice(0, 8).map((source) => `  - ${sourceLine(source)}`));
-  }
-  if (facts.length > 0) lines.push('', `Facts: ${facts.length}`);
-  if (gaps.length > 0) lines.push('', `Gaps: ${gaps.length}`);
-  return lines.join('\n');
-}
-
-function formatSearch(data: unknown, query: string): string {
-  const record = isRecord(data) ? data : {};
-  const items = readArray(record, 'items');
-  const results = items.length > 0 ? items : readArray(record, 'results');
-  if (results.length === 0) {
-    return [
-      `Agent Knowledge search: ${query}`,
-      '  no results',
-      '  route: /api/goodvibes-agent/knowledge/search',
-    ].join('\n');
-  }
-  return [
-    `Agent Knowledge search: ${query}`,
-    ...results.slice(0, 10).map((result, index) => `  ${index + 1}. ${resultLine(result)}`),
-  ].join('\n');
-}
-
-function formatIngest(data: unknown, url: string): string {
-  const record = isRecord(data) ? data : {};
-  const source = isRecord(record.source) ? record.source : record;
-  const sourceId = cleanInline(source.id);
-  const canonicalUri = cleanInline(source.canonicalUri) || cleanInline(source.sourceUri) || url;
-  const artifactId = cleanInline(record.artifactId);
-  return [
-    'Agent Knowledge ingest-url accepted',
-    `  source: ${sourceId || '(pending)'}`,
-    `  url: ${canonicalUri}`,
-    artifactId ? `  artifact: ${artifactId}` : null,
-    '  route: /api/goodvibes-agent/knowledge/ingest/url',
-  ].filter((line): line is string => Boolean(line)).join('\n');
-}
-
 function buildDelegationBody(task: string, wrfcRequested: boolean): string {
   return [
     'GoodVibes Agent explicit build delegation.',
@@ -414,25 +383,6 @@ function buildDelegationBody(task: string, wrfcRequested: boolean): string {
   ].join('\n');
 }
 
-function formatFailure(failure: AgentKnowledgeFailure, json: boolean): string {
-  if (json) return JSON.stringify(failure, null, 2);
-  return [
-    `Agent Knowledge error: ${failure.kind}`,
-    `  ${failure.error}`,
-    `  runtime: ${failure.baseUrl}`,
-    `  route: ${failure.route}`,
-    failure.kind === 'version_mismatch' && failure.daemonVersion && failure.expectedSdkVersion
-      ? `  versions: runtime=${failure.daemonVersion} expected=${failure.expectedSdkVersion}`
-      : null,
-    failure.kind === 'version_mismatch'
-      ? '  next: update/restart the external GoodVibes runtime so /status matches the Agent SDK pin.'
-      : null,
-    failure.kind === 'daemon_route_unavailable'
-      ? '  next: update/restart the external GoodVibes runtime to the SDK version required by this Agent package.'
-      : null,
-  ].filter((line): line is string => Boolean(line)).join('\n');
-}
-
 async function runKnowledgeCall<TData>(
   runtime: CliCommandRuntime,
   method: DaemonCallMethod,
@@ -524,6 +474,63 @@ export async function handleAgentKnowledgeCommand(runtime: CliCommandRuntime): P
     };
   }
 
+  if (normalized === 'list' || normalized === 'sources' || normalized === 'nodes' || normalized === 'issues') {
+    const requestedKind = normalized === 'list' ? (readOptionValue(rest, '--kind') ?? 'sources').toLowerCase() : normalized;
+    const kind = requestedKind === 'nodes' || requestedKind === 'issues' ? requestedKind : 'sources';
+    const limit = readPositiveInt(rest, '--limit', 10);
+    const method = kind === 'sources'
+      ? AGENT_KNOWLEDGE_METHODS.sourcesList
+      : kind === 'nodes'
+        ? AGENT_KNOWLEDGE_METHODS.nodesList
+        : AGENT_KNOWLEDGE_METHODS.issuesList;
+    const result = await runKnowledgeCall(runtime, method, async (connection) => (
+      await getAgentKnowledgeJson(connection, method.route, { limit })
+    ));
+    if (!result.ok) return { output: formatFailure(result, json), exitCode: 1 };
+    return {
+      output: formatJsonOrText(runtime.cli)(result, formatEntityList(result.data, kind, limit)),
+      exitCode: 0,
+    };
+  }
+
+  if (normalized === 'get') {
+    const [id] = commandValues(rest);
+    if (!id) return { output: 'Usage: goodvibes-agent knowledge get <source|node|issue id>', exitCode: 2 };
+    const route = `/api/goodvibes-agent/knowledge/items/${encodeURIComponent(id)}`;
+    const result = await runKnowledgeCall(runtime, AGENT_KNOWLEDGE_METHODS.itemGet, async (connection) => (
+      await getAgentKnowledgeJson(connection, route)
+    ));
+    if (!result.ok) return { output: formatFailure(result, json), exitCode: 1 };
+    return {
+      output: formatJsonOrText(runtime.cli)(result, formatItem(result.data, id)),
+      exitCode: 0,
+    };
+  }
+
+  if (normalized === 'map') {
+    const limit = readPositiveInt(rest, '--limit', 50);
+    const query = commandValues(rest).join(' ').trim();
+    const result = await runKnowledgeCall(runtime, AGENT_KNOWLEDGE_METHODS.map, async (connection) => (
+      await getAgentKnowledgeJson(connection, AGENT_KNOWLEDGE_METHODS.map.route, { limit, query })
+    ));
+    if (!result.ok) return { output: formatFailure(result, json), exitCode: 1 };
+    return {
+      output: formatJsonOrText(runtime.cli)(result, formatMap(result.data)),
+      exitCode: 0,
+    };
+  }
+
+  if (normalized === 'connectors') {
+    const result = await runKnowledgeCall(runtime, AGENT_KNOWLEDGE_METHODS.connectorsList, async (connection) => (
+      await getAgentKnowledgeJson(connection, AGENT_KNOWLEDGE_METHODS.connectorsList.route)
+    ));
+    if (!result.ok) return { output: formatFailure(result, json), exitCode: 1 };
+    return {
+      output: formatJsonOrText(runtime.cli)(result, formatConnectors(result.data)),
+      exitCode: 0,
+    };
+  }
+
   if (normalized === 'ingest-url') {
     const values = commandValues(rest);
     const url = values[0];
@@ -558,8 +565,69 @@ export async function handleAgentKnowledgeCommand(runtime: CliCommandRuntime): P
     };
   }
 
+  if (normalized === 'import-urls' || normalized === 'import-bookmarks') {
+    const values = commandValues(rest);
+    const path = values[0];
+    const method = normalized === 'import-urls'
+      ? AGENT_KNOWLEDGE_METHODS.ingestUrls
+      : AGENT_KNOWLEDGE_METHODS.ingestBookmarks;
+    if (!path) {
+      return {
+        output: `Usage: goodvibes-agent knowledge ${normalized} <path> [--allow-private-hosts] --yes`,
+        exitCode: 2,
+      };
+    }
+    if (!confirmation.present) {
+      const failure = {
+        ok: false,
+        kind: 'confirmation_required',
+        error: `Refusing to import ${path} into Agent Knowledge without --yes.`,
+        route: method.route,
+      };
+      return {
+        output: json ? JSON.stringify(failure, null, 2) : `${failure.error}\nUsage: goodvibes-agent knowledge ${normalized} <path> [--allow-private-hosts] --yes`,
+        exitCode: 2,
+      };
+    }
+    const result = await runKnowledgeCall(runtime, method, async (connection) => (
+      await postAgentKnowledgeJson(connection, method.route, {
+        path,
+        allowPrivateHosts: hasFlag(rest, '--allow-private-hosts'),
+        metadata: { originSurface: 'goodvibes-agent-cli' },
+      })
+    ));
+    if (!result.ok) return { output: formatFailure(result, json), exitCode: 1 };
+    return {
+      output: formatJsonOrText(runtime.cli)(result, formatBatchIngest(result.data, normalized)),
+      exitCode: 0,
+    };
+  }
+
+  if (normalized === 'reindex') {
+    if (!confirmation.present) {
+      const failure = {
+        ok: false,
+        kind: 'confirmation_required',
+        error: 'Refusing to reindex Agent Knowledge without --yes.',
+        route: AGENT_KNOWLEDGE_METHODS.reindex.route,
+      };
+      return {
+        output: json ? JSON.stringify(failure, null, 2) : `${failure.error}\nUsage: goodvibes-agent knowledge reindex --yes`,
+        exitCode: 2,
+      };
+    }
+    const result = await runKnowledgeCall(runtime, AGENT_KNOWLEDGE_METHODS.reindex, async (connection) => (
+      await postAgentKnowledgeJson(connection, AGENT_KNOWLEDGE_METHODS.reindex.route, {})
+    ));
+    if (!result.ok) return { output: formatFailure(result, json), exitCode: 1 };
+    return {
+      output: formatJsonOrText(runtime.cli)(result, formatReindex(result.data)),
+      exitCode: 0,
+    };
+  }
+
   return {
-    output: 'Usage: goodvibes-agent knowledge [status|ask <question>|search <query>|ingest-url <url> --yes]',
+    output: 'Usage: goodvibes-agent knowledge [status|ask <question>|search <query>|list|sources|nodes|issues|get <id>|map|connectors|ingest-url <url> --yes|import-urls <path> --yes|import-bookmarks <path> --yes|reindex --yes]',
     exitCode: 2,
   };
 }

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

@@ -0,0 +1,325 @@
+type JsonRecord = Record<string, unknown>;
+
+export interface AgentKnowledgeFailureLike {
+  readonly ok: false;
+  readonly kind: string;
+  readonly error: string;
+  readonly baseUrl: string;
+  readonly route: string;
+  readonly daemonVersion?: string;
+  readonly expectedSdkVersion?: string;
+}
+
+export function isRecord(value: unknown): value is JsonRecord {
+  return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
+}
+
+export function readString(record: JsonRecord | null, key: string): string | null {
+  const value = record?.[key];
+  return typeof value === 'string' ? value : null;
+}
+
+function readNumber(record: JsonRecord | null, key: string): number | null {
+  const value = record?.[key];
+  return typeof value === 'number' && Number.isFinite(value) ? value : null;
+}
+
+function readBoolean(record: JsonRecord | null, key: string): boolean | null {
+  const value = record?.[key];
+  return typeof value === 'boolean' ? value : null;
+}
+
+function readArray(record: JsonRecord | null, key: string): readonly unknown[] {
+  const value = record?.[key];
+  return Array.isArray(value) ? value : [];
+}
+
+function cleanInline(value: unknown): string {
+  return typeof value === 'string' ? value.replace(/\s+/g, ' ').trim() : '';
+}
+
+function yesNo(value: boolean): string {
+  return value ? 'yes' : 'no';
+}
+
+function sourceLine(value: unknown): string {
+  const record = isRecord(value) ? value : {};
+  const title = cleanInline(record.title)
+    || cleanInline(record.canonicalUri)
+    || cleanInline(record.sourceUri)
+    || cleanInline(record.url)
+    || cleanInline(record.id)
+    || 'untitled';
+  const type = cleanInline(record.sourceType) || cleanInline(record.type) || 'source';
+  const url = cleanInline(record.canonicalUri) || cleanInline(record.sourceUri) || cleanInline(record.url);
+  return url && url !== title ? `[${type}] ${title} (${url})` : `[${type}] ${title}`;
+}
+
+function resultLine(value: unknown): string {
+  const record = isRecord(value) ? value : {};
+  const title = cleanInline(record.title) || cleanInline(record.id) || 'untitled';
+  const id = cleanInline(record.id);
+  const type = cleanInline(record.type) || cleanInline(record.kind) || cleanInline(record.sourceType) || 'result';
+  const score = readNumber(record, 'score');
+  const url = cleanInline(record.url) || cleanInline(record.canonicalUri) || cleanInline(record.sourceUri);
+  const snippet = cleanInline(record.snippet) || cleanInline(record.summary) || cleanInline(record.text);
+  const parts = [
+    `[${type}] ${title}`,
+    id && id !== title ? `id=${id}` : '',
+    score !== null ? `score=${score.toFixed(3)}` : '',
+    url ? `url=${url}` : '',
+  ].filter((part) => part.length > 0);
+  return snippet ? `${parts.join('  ')}\n    ${snippet}` : parts.join('  ');
+}
+
+function nodeLine(value: unknown): string {
+  const record = isRecord(value) ? value : {};
+  const id = cleanInline(record.id);
+  const kind = cleanInline(record.kind) || 'node';
+  const title = cleanInline(record.title) || id || 'untitled';
+  const confidence = readNumber(record, 'confidence');
+  const status = cleanInline(record.status);
+  const summary = cleanInline(record.summary);
+  const parts = [
+    `[${kind}] ${title}`,
+    id && id !== title ? `id=${id}` : '',
+    status ? `status=${status}` : '',
+    confidence !== null ? `confidence=${confidence}` : '',
+  ].filter((part) => part.length > 0);
+  return summary ? `${parts.join('  ')}\n    ${summary}` : parts.join('  ');
+}
+
+function issueLine(value: unknown): string {
+  const record = isRecord(value) ? value : {};
+  const id = cleanInline(record.id) || 'issue';
+  const severity = cleanInline(record.severity) || 'unknown';
+  const code = cleanInline(record.code) || 'issue';
+  const status = cleanInline(record.status);
+  const message = cleanInline(record.message);
+  const suffix = status ? ` status=${status}` : '';
+  return `  - ${id} [${severity}] ${code}${suffix}${message ? ` - ${message}` : ''}`;
+}
+
+function connectorLine(value: unknown): string {
+  const record = isRecord(value) ? value : {};
+  const id = cleanInline(record.id) || 'connector';
+  const name = cleanInline(record.displayName) || id;
+  const sourceType = cleanInline(record.sourceType);
+  const description = cleanInline(record.description);
+  const suffix = sourceType ? ` sourceType=${sourceType}` : '';
+  return description ? `  - ${id}  ${name}${suffix}\n    ${description}` : `  - ${id}  ${name}${suffix}`;
+}
+
+export function formatStatus(data: unknown): string {
+  const record = isRecord(data) ? data : {};
+  const ready = readBoolean(record, 'ready');
+  const sourceCount = readNumber(record, 'sourceCount');
+  const nodeCount = readNumber(record, 'nodeCount');
+  const issueCount = readNumber(record, 'issueCount');
+  const edgeCount = readNumber(record, 'edgeCount');
+  const storagePath = readString(record, 'storagePath');
+  return [
+    'Agent Knowledge status',
+    `  ready: ${ready === null ? 'unknown' : yesNo(ready)}`,
+    `  sources: ${sourceCount ?? 'unknown'}`,
+    `  nodes: ${nodeCount ?? 'unknown'}`,
+    `  edges: ${edgeCount ?? 'unknown'}`,
+    `  issues: ${issueCount ?? 'unknown'}`,
+    storagePath ? `  storage: ${storagePath}` : null,
+    '  route: /api/goodvibes-agent/knowledge/status',
+  ].filter((line): line is string => Boolean(line)).join('\n');
+}
+
+export function formatEntityList(data: unknown, kind: 'sources' | 'nodes' | 'issues', limit: number): string {
+  const record = isRecord(data) ? data : {};
+  const values = readArray(record, kind);
+  if (values.length === 0) {
+    return [
+      `Agent Knowledge ${kind}`,
+      '  no records',
+      `  route: /api/goodvibes-agent/knowledge/${kind}`,
+    ].join('\n');
+  }
+  const format = kind === 'sources'
+    ? sourceLine
+    : kind === 'nodes'
+      ? nodeLine
+      : issueLine;
+  return [
+    `Agent Knowledge ${kind} (${values.length}, limit ${limit})`,
+    ...values.slice(0, limit).map((value, index) => (
+      kind === 'issues' ? format(value) : `  ${index + 1}. ${format(value)}`
+    )),
+  ].join('\n');
+}
+
+export function formatItem(data: unknown, id: string): string {
+  const record = isRecord(data) ? data : {};
+  const source = record.source;
+  const node = record.node;
+  const issue = record.issue;
+  const relatedEdges = readArray(record, 'relatedEdges').length;
+  const linkedSources = readArray(record, 'linkedSources').length;
+  const linkedNodes = readArray(record, 'linkedNodes').length;
+  if (source) {
+    return [
+      `Agent Knowledge item: ${id}`,
+      `  ${sourceLine(source)}`,
+      `  relatedEdges=${relatedEdges} linkedSources=${linkedSources} linkedNodes=${linkedNodes}`,
+    ].join('\n');
+  }
+  if (node) {
+    return [
+      `Agent Knowledge item: ${id}`,
+      `  ${nodeLine(node)}`,
+      `  relatedEdges=${relatedEdges} linkedSources=${linkedSources} linkedNodes=${linkedNodes}`,
+    ].join('\n');
+  }
+  if (issue) {
+    return [
+      `Agent Knowledge item: ${id}`,
+      issueLine(issue),
+      `  relatedEdges=${relatedEdges} linkedSources=${linkedSources} linkedNodes=${linkedNodes}`,
+    ].join('\n');
+  }
+  return [
+    `Agent Knowledge item: ${id}`,
+    '  not found',
+    '  route: /api/goodvibes-agent/knowledge/items/{id}',
+  ].join('\n');
+}
+
+export function formatMap(data: unknown): string {
+  const record = isRecord(data) ? data : {};
+  const sources = readArray(record, 'sources');
+  const nodes = readArray(record, 'nodes');
+  const edges = readArray(record, 'edges');
+  const issues = readArray(record, 'issues');
+  return [
+    'Agent Knowledge map',
+    `  sources: ${sources.length}`,
+    `  nodes: ${nodes.length}`,
+    `  edges: ${edges.length}`,
+    `  issues: ${issues.length}`,
+    '  route: /api/goodvibes-agent/knowledge/map',
+  ].join('\n');
+}
+
+export function formatConnectors(data: unknown): string {
+  const record = isRecord(data) ? data : {};
+  const connectors = readArray(record, 'connectors');
+  if (connectors.length === 0) {
+    return [
+      'Agent Knowledge connectors',
+      '  no connectors',
+      '  route: /api/goodvibes-agent/knowledge/connectors',
+    ].join('\n');
+  }
+  return [
+    `Agent Knowledge connectors (${connectors.length})`,
+    ...connectors.map(connectorLine),
+  ].join('\n');
+}
+
+export function formatAsk(data: unknown, query: string): string {
+  const record = isRecord(data) ? data : {};
+  const answer = isRecord(record.answer) ? record.answer : record;
+  const text = cleanInline(answer.text) || cleanInline(record.answer) || 'No answer returned.';
+  const confidence = readNumber(answer, 'confidence') ?? readNumber(record, 'confidence');
+  const synthesized = readBoolean(answer, 'synthesized');
+  const sources = readArray(answer, 'sources');
+  const facts = readArray(answer, 'facts');
+  const gaps = readArray(answer, 'gaps');
+  const lines = [
+    `Agent Knowledge answer: ${query}`,
+    text,
+    '',
+    `confidence: ${confidence ?? 'unknown'}${synthesized === null ? '' : `  synthesized: ${yesNo(synthesized)}`}`,
+  ];
+  if (sources.length > 0) {
+    lines.push('', 'Sources:', ...sources.slice(0, 8).map((source) => `  - ${sourceLine(source)}`));
+  }
+  if (facts.length > 0) lines.push('', `Facts: ${facts.length}`);
+  if (gaps.length > 0) lines.push('', `Gaps: ${gaps.length}`);
+  return lines.join('\n');
+}
+
+export function formatSearch(data: unknown, query: string): string {
+  const record = isRecord(data) ? data : {};
+  const items = readArray(record, 'items');
+  const results = items.length > 0 ? items : readArray(record, 'results');
+  if (results.length === 0) {
+    return [
+      `Agent Knowledge search: ${query}`,
+      '  no results',
+      '  route: /api/goodvibes-agent/knowledge/search',
+    ].join('\n');
+  }
+  return [
+    `Agent Knowledge search: ${query}`,
+    ...results.slice(0, 10).map((result, index) => `  ${index + 1}. ${resultLine(result)}`),
+  ].join('\n');
+}
+
+export function formatIngest(data: unknown, url: string): string {
+  const record = isRecord(data) ? data : {};
+  const source = isRecord(record.source) ? record.source : record;
+  const sourceId = cleanInline(source.id);
+  const canonicalUri = cleanInline(source.canonicalUri) || cleanInline(source.sourceUri) || url;
+  const artifactId = cleanInline(record.artifactId);
+  return [
+    'Agent Knowledge ingest-url accepted',
+    `  source: ${sourceId || '(pending)'}`,
+    `  url: ${canonicalUri}`,
+    artifactId ? `  artifact: ${artifactId}` : null,
+    '  route: /api/goodvibes-agent/knowledge/ingest/url',
+  ].filter((line): line is string => Boolean(line)).join('\n');
+}
+
+export function formatBatchIngest(data: unknown, label: string): string {
+  const record = isRecord(data) ? data : {};
+  const imported = readNumber(record, 'imported');
+  const failed = readNumber(record, 'failed');
+  const sources = readArray(record, 'sources');
+  const errors = readArray(record, 'errors');
+  return [
+    `Agent Knowledge ${label} accepted`,
+    `  imported: ${imported ?? sources.length}`,
+    `  failed: ${failed ?? errors.length}`,
+    `  sources: ${sources.length}`,
+    ...sources.slice(0, 5).map((source) => `  - ${sourceLine(source)}`),
+    ...(errors.length > 0 ? ['  errors:', ...errors.slice(0, 5).map((error) => `  - ${cleanInline(error)}`)] : []),
+  ].join('\n');
+}
+
+export function formatReindex(data: unknown): string {
+  const record = isRecord(data) ? data : {};
+  const status = isRecord(record.status) ? record.status : {};
+  return [
+    'Agent Knowledge reindex complete',
+    `  sources: ${readNumber(status, 'sourceCount') ?? 'unknown'}`,
+    `  nodes: ${readNumber(status, 'nodeCount') ?? 'unknown'}`,
+    `  edges: ${readNumber(status, 'edgeCount') ?? 'unknown'}`,
+    `  issues: ${readNumber(status, 'issueCount') ?? 'unknown'}`,
+    '  route: /api/goodvibes-agent/knowledge/reindex',
+  ].join('\n');
+}
+
+export function formatFailure(failure: AgentKnowledgeFailureLike, json: boolean): string {
+  if (json) return JSON.stringify(failure, null, 2);
+  return [
+    `Agent Knowledge error: ${failure.kind}`,
+    `  ${failure.error}`,
+    `  runtime: ${failure.baseUrl}`,
+    `  route: ${failure.route}`,
+    failure.kind === 'version_mismatch' && failure.daemonVersion && failure.expectedSdkVersion
+      ? `  versions: runtime=${failure.daemonVersion} expected=${failure.expectedSdkVersion}`
+      : null,
+    failure.kind === 'version_mismatch'
+      ? '  next: update/restart the external GoodVibes runtime so /status matches the Agent SDK pin.'
+      : null,
+    failure.kind === 'daemon_route_unavailable'
+      ? '  next: update/restart the external GoodVibes runtime to the SDK version required by this Agent package.'
+      : null,
+  ].filter((line): line is string => Boolean(line)).join('\n');
+}

package/src/cli/help.ts

@@ -184,14 +184,23 @@ const COMMAND_HELP: Record<string, CommandHelp> = {
       'knowledge status',
       'knowledge ask <question> [--limit <n>] [--mode concise|standard|detailed]',
       'knowledge search <query> [--limit <n>]',
+      'knowledge list [--kind sources|nodes|issues] [--limit <n>]',
+      'knowledge get <id>',
+      'knowledge connectors',
       'knowledge ingest-url <url> [--title <title>] [--tags a,b] --yes',
+      'knowledge import-urls <path> --yes',
+      'knowledge import-bookmarks <path> --yes',
+      'knowledge reindex --yes',
     ],
     summary: 'Call isolated Agent Knowledge/Wiki routes under /api/goodvibes-agent/knowledge. No default wiki or non-Agent fallback.',
     examples: [
       'knowledge status',
       'knowledge ask "What is GoodVibes Agent?"',
       'knowledge search "release checklist"',
+      'knowledge list --kind sources',
+      'knowledge connectors',
       'knowledge ingest-url https://example.com/page --title "Reference" --yes',
+      'knowledge import-urls ~/agent-links.txt --yes',
     ],
   },
   ask: {

package/src/cli/package-verification.ts

@@ -1,6 +1,8 @@
 import { execSync } from 'node:child_process';
 import { existsSync, readFileSync, statSync } from 'node:fs';
 import { join } from 'node:path';
+import { CommandRegistry } from '../input/command-registry.ts';
+import { registerBuiltinCommands } from '../input/commands.ts';
 
 export interface PackageCliBinVerification {
   readonly command: 'goodvibes-agent';
@@ -108,11 +110,40 @@ const PACKAGE_FACING_REQUIRED_TEXT: readonly {
   { path: 'docs/runtime-connection.md', required: ['/api/goodvibes-agent/knowledge'] },
   { path: 'docs/release-and-publishing.md', required: ['/api/goodvibes-agent/knowledge'] },
 ];
+const NON_COMMAND_ROUTE_ROOTS = new Set(['api', 'status']);
 
 function readPackageJson(root: string): Record<string, unknown> {
   return JSON.parse(readFileSync(join(root, 'package.json'), 'utf-8')) as Record<string, unknown>;
 }
 
+function buildRegisteredSlashCommandNames(): ReadonlySet<string> {
+  const registry = new CommandRegistry();
+  registerBuiltinCommands(registry);
+  const names = new Set<string>();
+  for (const command of registry.list()) {
+    names.add(command.name);
+    for (const alias of command.aliases ?? []) names.add(alias);
+  }
+  return names;
+}
+
+function verifyPackageFacingSlashCommands(path: string, content: string, registeredCommands: ReadonlySet<string>): readonly string[] {
+  const failures: string[] = [];
+  const commandPattern = /(^|[\s`([])\/([a-z][a-z0-9_-]*)(?=$|[\s`.,;:)\]])/g;
+  const lines = content.split(/\r?\n/);
+  for (let lineIndex = 0; lineIndex < lines.length; lineIndex += 1) {
+    const line = lines[lineIndex] ?? '';
+    commandPattern.lastIndex = 0;
+    for (let match = commandPattern.exec(line); match !== null; match = commandPattern.exec(line)) {
+      const root = match[2] ?? '';
+      if (NON_COMMAND_ROUTE_ROOTS.has(root)) continue;
+      if (registeredCommands.has(root)) continue;
+      failures.push(`package-facing text ${path}:${lineIndex + 1} references unknown Agent slash command: /${root}`);
+    }
+  }
+  return failures;
+}
+
 function hasExecutableBit(path: string): boolean {
   return existsSync(path) && (statSync(path).mode & 0o111) !== 0;
 }
@@ -146,6 +177,7 @@ function registryPackDryRun(root: string): { readonly files: readonly string[];
 
 export function verifyPackageFacingText(root: string): { readonly checkedPaths: readonly string[]; readonly failures: readonly string[] } {
   const failures: string[] = [];
+  const registeredCommands = buildRegisteredSlashCommandNames();
   for (const path of PACKAGE_FACING_TEXT_PATHS) {
     const absolutePath = join(root, path);
     if (!existsSync(absolutePath)) {
@@ -153,6 +185,9 @@ export function verifyPackageFacingText(root: string): { readonly checkedPaths:
       continue;
     }
     const content = readFileSync(absolutePath, 'utf-8');
+    if (path !== 'CHANGELOG.md') {
+      failures.push(...verifyPackageFacingSlashCommands(path, content, registeredCommands));
+    }
     for (const forbidden of PACKAGE_FACING_FORBIDDEN_TEXT) {
       if (content.includes(forbidden)) {
         failures.push(`package-facing text ${path} contains forbidden default/TUI route or policy: ${forbidden}`);

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

@@ -40,7 +40,7 @@ export function buildAgentWorkspaceSetupChecklist(input: AgentWorkspaceSetupChec
       label: 'GoodVibes runtime',
       status: 'ready',
       detail: `Agent will connect to ${input.daemonBaseUrl}; runtime ownership stays outside this product.`,
-      command: '/status',
+      command: '/health',
     },
     {
       id: 'provider-model',

package/src/input/commands/agent-skills-runtime.ts

@@ -238,6 +238,10 @@ function runBundleCommand(args: readonly string[], ctx: CommandContext, skillReg
 
 export async function runAgentSkillsRuntimeCommand(args: readonly string[], ctx: CommandContext): Promise<void> {
   const sub = (args[0] ?? 'list').toLowerCase();
+  if (sub === 'local' || sub === 'agent') {
+    await runAgentSkillsRuntimeCommand(args.slice(1), ctx);
+    return;
+  }
   const skillRegistry = registryFromContext(ctx);
   try {
     if (sub === 'bundle' || sub === 'bundles') {
@@ -356,7 +360,7 @@ export async function runAgentSkillsRuntimeCommand(args: readonly string[], ctx:
 export function registerAgentSkillsRuntimeCommands(registry: CommandRegistry): void {
   registry.register({
     name: 'agent-skills',
-    aliases: ['askills', 'local-skills'],
+    aliases: ['askills', 'local-skills', 'skills', 'skill'],
     description: 'Manage local GoodVibes Agent skills',
     usage: '[list|enabled|search <query>|show <id>|create --name <name> --description <summary> --procedure <steps>|update <id> [--name ...] [--description ...] [--procedure ...]|enable <id>|disable <id>|review <id>|stale <id> <reason...>|delete <id> --yes|bundle ...]',
     handler: runAgentSkillsRuntimeCommand,

package/src/input/commands/health-runtime.ts

@@ -103,9 +103,9 @@ export function registerHealthRuntimeCommands(registry: CommandRegistry): void {
           `  recent failures: ${settings.recentFailureCount}`,
           `  staged bundle: ${settings.hasStagedManagedBundle ? 'present' : 'none'}`,
           ...(issues.length > 0 ? issues.map((issue) => `  issue: ${issue}`) : ['  no active settings-control issues detected']),
-          '  next: /settingssync panel',
-          '  next: /settingssync show <key>',
-          '  next: /managed staged',
+          '  next: /settings',
+          '  next: /config <key>',
+          '  next: /health repair settings',
         ].join('\n'));
         return;
       }
@@ -131,8 +131,8 @@ export function registerHealthRuntimeCommands(registry: CommandRegistry): void {
           `  active connections: ${snapshot.activeConnections}`,
           `  degraded: ${snapshot.degradedConnections}`,
           ...(issues.length > 0 ? issues.map((issue) => `  issue: ${issue}`) : ['  no active remote recovery issues detected']),
-          '  next: /remote supervisor',
-          '  next: /remote recover <runnerId>',
+          '  next: /delegate <build/fix/review task> for explicit TUI build work',
+          '  next: use the external runtime host for remote worker repair',
         ].join('\n'));
         return;
       }
@@ -217,14 +217,14 @@ export function registerHealthRuntimeCommands(registry: CommandRegistry): void {
           lines.push('  domain: settings');
           lines.push(...(
             settings.conflicts.length > 0
-              ? ['  /settingssync panel', '  /settingssync show <key>', '  /managed staged']
+              ? ['  /settings', '  /config <key>', '  runtime-owned managed setting repair stays external']
               : ['  no active settings repair actions suggested']
           ));
           lines.push('  verify: /health settings');
         } else if (domain === 'auth') {
           lines.push('  domain: auth');
           lines.push('  /auth review');
-          lines.push('  /providers');
+          lines.push('  /provider');
           lines.push('  /subscription providers');
           lines.push('  runtime auth users/bootstrap cleanup: use the runtime-owning GoodVibes TUI or host tooling');
           lines.push('  verify: /health auth');
@@ -237,15 +237,13 @@ export function registerHealthRuntimeCommands(registry: CommandRegistry): void {
           lines.push('  verify: /health accounts');
         } else if (domain === 'services') {
           lines.push('  domain: services');
-          lines.push('  /services doctor');
-          lines.push('  /services auth-review');
           lines.push('  /health services');
+          lines.push('  runtime service repair belongs to the external GoodVibes runtime host');
           lines.push('  verify: /health services');
         } else if (domain === 'remote') {
           lines.push('  domain: remote');
-          lines.push('  /remote supervisor');
-          lines.push('  /remote recover <runnerId>');
-          lines.push('  /remote setup');
+          lines.push('  /delegate <build/fix/review task> for explicit TUI build work');
+          lines.push('  remote runner setup and recovery belong to the external runtime host');
           lines.push('  verify: /health remote');
         } else if (domain === 'mcp') {
           lines.push('  domain: mcp');
@@ -262,9 +260,8 @@ export function registerHealthRuntimeCommands(registry: CommandRegistry): void {
         } else if (domain === 'maintenance') {
           lines.push('  domain: maintenance');
           lines.push('  /health maintenance');
-          lines.push('  /guidance review');
+          lines.push('  /mode');
           lines.push('  /compact');
-          lines.push('  /panel tokens');
           lines.push('  verify: /health maintenance');
         } else {
           lines.push('  domains: settings, auth, accounts, services, remote, mcp, continuity, maintenance');
@@ -329,7 +326,7 @@ export function registerHealthRuntimeCommands(registry: CommandRegistry): void {
         '  /health remote',
         '  /health maintenance',
         '  /health repair <domain>',
-        '  /setup onboarding',
+        '  /onboarding',
       ].join('\n'));
     },
   });

package/src/input/commands/mcp-runtime.ts

@@ -202,7 +202,7 @@ export function registerMcpRuntimeCommands(registry: CommandRegistry): void {
               ...needingAttention.map((server) => (
                 `  ${server.name}  connected=${server.connected ? 'yes' : 'no'}  freshness=${server.schemaFreshness}  trust=${server.trustMode}`
               )),
-              '  next: /services auth-review',
+              '  next: /auth review',
               '  next: /mcp repair <server>',
             ].join('\n')
           : 'MCP Auth Review\n  No MCP servers currently need auth or quarantine recovery.');
@@ -223,7 +223,7 @@ export function registerMcpRuntimeCommands(registry: CommandRegistry): void {
           selected.schemaFreshness === 'quarantined'
             ? `/mcp quarantine ${selected.name} approve operator --yes`
             : null,
-          !selected.connected ? '/services auth-review' : null,
+          !selected.connected ? '/auth review' : null,
           '/mcp review',
           '/health review',
         ].filter((entry): entry is string => entry !== null);

package/src/input/commands/session-workflow.ts

@@ -264,7 +264,7 @@ export async function handleSessionWorkflowCommand(args: string[], ctx: CommandC
           ctx.print(`  Reopened panels: ${reopenedPanels.join(', ')}`);
         }
         if ((meta.returnContext.remoteRunners?.length ?? 0) > 0) {
-          ctx.print(`  Remote re-entry: /remote recover ${meta.returnContext.remoteRunners![0]}`);
+          ctx.print('  Remote re-entry: use the external runtime host for remote runner recovery; delegate explicit build/fix/review recovery from Agent.');
         }
         if ((meta.returnContext.worktreePaths?.length ?? 0) > 0) {
           ctx.print('  Worktree re-entry: open GoodVibes TUI in the target workspace; delegate explicit build/fix/review recovery from Agent.');

package/src/panels/approval-panel.ts

@@ -20,7 +20,7 @@ const APPROVAL_ROWS = [
   ['network', 'why prompted: external hosts, fetch scope, egress policy', 'review via /approval review network'],
   ['delegate', 'why prompted: recursive agents, spawn ceilings, write-set inheritance', 'review via /approval review delegate'],
   ['mcp', 'why prompted: trust escalation, host scope, path scope, coherence mismatch', 'review via /mcp trust and /security'],
-  ['remote', 'why prompted: runner trust, remote write scope, artifact requirements', 'review via /remote and delegated TUI execution context'],
+  ['remote', 'why prompted: runner trust, remote write scope, artifact requirements', 'review delegated TUI execution context'],
   ['hook', 'why prompted: deny/mutate authority, blocking behavior, runner provenance', 'review via /hooks and /security'],
   ['plugin', 'why prompted: install/update lifecycle, provenance, capability grants', 'review via /marketplace and /security'],
 ] as const;

package/src/panels/automation-control-panel.ts

@@ -88,7 +88,7 @@ export class AutomationControlPanel extends ScrollableListPanel<AutomationRun> {
   protected override getEmptyStateActions(): Array<{ command: string; summary: string }> {
     return [
       { command: '/schedule list', summary: 'inspect jobs and run history without mutating schedules' },
-      { command: '/automation jobs', summary: 'review runtime-owned automation jobs from Agent' },
+      { command: '/schedule receipts', summary: 'review Agent routine promotion receipts' },
     ];
   }
 

package/src/panels/provider-account-snapshot.ts

@@ -217,7 +217,7 @@ export async function buildProviderAccountSnapshot(
     }
     if (hasServiceOAuth && !serviceOauth?.usable) {
       issues.push('Service OAuth is configured but missing a usable credential.');
-      recommendedActions.push(`Repair service OAuth credentials for ${providerId} in /services or /settings.`);
+      recommendedActions.push(`Repair service OAuth credentials for ${providerId} in /settings or the external runtime host.`);
     }
 
     return {

package/src/panels/provider-health-domains.ts

@@ -55,8 +55,8 @@ export function buildProviderHealthDomainSummaries(
       auth.bootstrapCredentialPresent ? 'Runtime bootstrap cleanup must be done from the runtime-owning TUI or host tooling.' : '',
     ].filter(Boolean),
     nextSteps: auth.bootstrapCredentialPresent
-      ? ['/auth review', '/providers', '/subscription providers']
-      : ['/auth review', '/providers'],
+      ? ['/auth review', '/provider', '/subscription providers']
+      : ['/auth review', '/provider'],
   });
 
   const settingIssueCount = settings.conflictCount + settings.recentFailureCount + (settings.hasStagedManagedBundle ? 1 : 0);
@@ -68,7 +68,7 @@ export function buildProviderHealthDomainSummaries(
       : settingIssueCount > 0
         ? `${settings.conflictCount} conflicts / ${settings.recentFailureCount} failures${settings.hasStagedManagedBundle ? ' / staged bundle' : ''}`
         : 'settings runtime API clean',
-    next: settingIssueCount > 0 ? '/settingssync panel' : '/settingssync show <key>',
+    next: settingIssueCount > 0 ? '/settings' : '/config <key>',
     details: [
       settings.conflictCount > 0 ? `${settings.conflictCount} unresolved import conflict(s)` : '',
       settings.recentFailureCount > 0 ? `${settings.recentFailureCount} recent sync or managed failure(s)` : '',
@@ -76,8 +76,8 @@ export function buildProviderHealthDomainSummaries(
       settings.managedLockCount > 0 ? `${settings.managedLockCount} managed lock(s) enforced` : '',
     ].filter(Boolean),
     nextSteps: settingIssueCount > 0
-      ? ['/settingssync panel', '/settingssync show <key>', '/managed staged']
-      : ['/settingssync show <key>'],
+      ? ['/settings', '/config <key>', '/health settings']
+      : ['/config <key>'],
   });
 
   summaries.push({
@@ -86,7 +86,7 @@ export function buildProviderHealthDomainSummaries(
     summary: remote.supervisor.sessions.length === 0
       ? 'no remote sessions tracked'
       : `${remote.supervisor.sessions.length} sessions / ${remote.supervisor.degradedConnections} degraded`,
-    next: remote.supervisor.degradedConnections > 0 ? '/remote recover <workerId>' : '/remote supervisor',
+    next: remote.supervisor.degradedConnections > 0 ? '/delegate <build/fix/review task>' : '/health remote',
     details: remote.supervisor.sessions.length === 0
       ? ['no remote sessions have been attached yet']
       : remote.supervisor.sessions
@@ -99,8 +99,8 @@ export function buildProviderHealthDomainSummaries(
           .slice(0, 3)
           .map((entry) => `${entry.runnerId}: transport=${entry.transportState} heartbeat=${entry.heartbeat.status}${entry.lastError ? ` error=${entry.lastError}` : ''}`),
     nextSteps: remote.supervisor.degradedConnections > 0
-      ? ['/remote supervisor', '/remote recover <workerId>', '/remote support']
-      : ['/remote supervisor'],
+      ? ['/delegate <build/fix/review task>', '/health remote']
+      : ['/health remote'],
   });
 
   const degradedServers = security.mcpServers.filter((server) =>
@@ -141,7 +141,7 @@ export function buildProviderHealthDomainSummaries(
         ? 'warn'
         : 'good',
     summary: maintenance.summary,
-    next: maintenance.nextSteps[0] ?? '/guidance review',
+    next: maintenance.nextSteps[0] ?? '/health maintenance',
     details: maintenance.reasons.slice(0, 3),
     nextSteps: maintenance.nextSteps,
   });

package/src/panels/session-browser-panel.ts

@@ -266,7 +266,7 @@ export class SessionBrowserPanel extends BasePanel {
             ...formatReturnContextLines(selected.returnContext).map((line) =>
               buildPanelLine(width, [[' ', DEFAULT_PANEL_PALETTE.dim], [truncateDisplay(line, Math.max(0, width - 2)), DEFAULT_PANEL_PALETTE.dim]])
             ),
-            buildPanelLine(width, [[' Next ', DEFAULT_PANEL_PALETTE.label], [selected.returnContext?.remoteRunners?.length ? `/remote recover ${selected.returnContext.remoteRunners[0]}` : '/session resume', DEFAULT_PANEL_PALETTE.dim]]),
+            buildPanelLine(width, [[' Next ', DEFAULT_PANEL_PALETTE.label], ['/session resume', DEFAULT_PANEL_PALETTE.dim]]),
           ],
         }
       : { title: 'Selected', lines: [] };

package/src/panels/session-maintenance.ts

@@ -76,13 +76,13 @@ export function evaluateSessionMaintenance(input: PanelSessionMaintenanceInput):
     level = 'needs-repair';
     summary = `Compact now to recover context headroom (${usagePct}% used).`;
     reasons.push(`Context pressure is high at ${usagePct}% usage.`);
-    nextSteps.push('/compact', '/panel tokens');
+    nextSteps.push('/compact', '/context');
     compactRecommended = true;
   } else if (usagePct >= thresholdPct || remainingTokens <= 15_000) {
     level = 'suggest-compact';
     summary = `Watch context growth (${usagePct}% used).`;
     reasons.push(`Context pressure is climbing at ${usagePct}% usage.`);
-    nextSteps.push('/panel tokens');
+    nextSteps.push('/context');
     compactRecommended = true;
   } else if (usagePct >= 70 || staleByMessageGrowth) {
     level = 'watch';
@@ -92,7 +92,7 @@ export function evaluateSessionMaintenance(input: PanelSessionMaintenanceInput):
     reasons.push(staleByMessageGrowth
       ? `Conversation has grown ${messageCount.toLocaleString()} messages since the last maintenance checkpoint.`
       : `Context usage is climbing toward the ${thresholdPct}% maintenance threshold.`);
-    nextSteps.push('/panel tokens');
+    nextSteps.push('/context');
   } else {
     reasons.push('Context pressure is currently within the stable operating band.');
   }

package/src/panels/subscription-panel.ts

@@ -80,7 +80,7 @@ export class SubscriptionPanel extends ScrollableListPanel<SubscriptionRow> {
     return [
       { command: '/subscription login openai start --yes', summary: 'start the first-class OpenAI subscription flow' },
       { command: '/login provider <name> start --yes', summary: 'use the front-door auth flow for supported providers' },
-      { command: '/services auth-review', summary: 'inspect configured service auth posture and stored secrets' },
+      { command: '/auth review', summary: 'inspect runtime auth posture without exposing token values' },
     ];
   }
 

package/src/renderer/help-overlay.ts

@@ -69,21 +69,23 @@ export function renderHelpOverlay(
   // Each entry is [commandName, subcommandOrArgHint, description].
   // Commands not registered in the live registry are omitted at render time.
   const FEATURED_COMMANDS: Array<[name: string, argHint: string, desc: string]> = [
-    ['onboarding',   '',           'Open the onboarding wizard with current settings preloaded'],
-    ['cockpit',      '',           'Unified runtime control room'],
-    ['settings',     '',           'Settings and config browser'],
+    ['agent',        '',           'Open the Agent operator workspace'],
+    ['onboarding',   '',           'Open Agent setup with current settings preloaded'],
+    ['knowledge',    'status',     'Inspect isolated Agent Knowledge readiness'],
+    ['memory',       '',           'Manage local Agent memory records'],
+    ['personas',     '',           'Manage serial Agent operating personas'],
+    ['agent-skills', '',           'Manage local Agent skills and bundles'],
+    ['routines',     '',           'Manage reusable main-conversation routines'],
+    ['workplan',     '',           'Inspect shared work-plan state'],
+    ['approval',     '',           'Review and explicitly act on approvals'],
+    ['schedule',     '',           'Inspect schedules and routine promotion receipts'],
+    ['delegate',     '',           'Explicitly hand build/fix/review work to GoodVibes TUI'],
+    ['mcp',          '',           'Inspect MCP servers and tool readiness'],
     ['provider',     '',           'Choose provider or model family'],
+    ['model',        '',           'Select the active model route'],
     ['subscription', '',           'Review provider logins and subscriptions'],
-    ['marketplace',  'open',       'Browse plugins, skills, and packs'],
-    ['remote',       'setup',      'Review remote, bridge, and tunnel flows'],
-    ['security',     '',           'Security review workspace'],
-    ['policy',       '',           'Simulation, lint, and preflight review'],
-    ['incident',     '',           'Incident workspace and export flows'],
-    ['knowledge',    '',           'Durable knowledge and review queue'],
-    ['hooks',        '',           'Hook workbench and runtime activity'],
-    ['orchestration','',           'Graph and recursive-agent control room'],
-    ['communication','',           'Structured agent communication workspace'],
-    ['tasks',        '',           'Read-only task view for list/show/pause/resume/output'],
+    ['secrets',      '',           'Manage secret references without printing values'],
+    ['health',       '',           'Run Agent runtime and setup diagnostics'],
   ];
 
   // Build command rows from featured list, filtering out unregistered commands.
@@ -115,7 +117,29 @@ export function renderHelpOverlay(
 
   if (commands && commands.length > 0) {
     commandRows.push('', '  Available Slash Commands', '  ' + '\u2500'.repeat(40));
-    const preferred = ['setup', 'cockpit', 'settings', 'provider', 'subscription', 'marketplace', 'remote', 'security', 'policy', 'incident', 'knowledge', 'hooks', 'orchestration', 'communication', 'tasks'];
+    const preferred = [
+      'agent',
+      'onboarding',
+      'knowledge',
+      'memory',
+      'personas',
+      'agent-skills',
+      'routines',
+      'workplan',
+      'approval',
+      'schedule',
+      'delegate',
+      'mcp',
+      'provider',
+      'model',
+      'subscription',
+      'secrets',
+      'health',
+      'settings',
+      'security',
+      'policy',
+      'tasks',
+    ];
     const seen = new Set<string>();
     for (const name of preferred) {
       const cmd = commands.find((entry) => entry.name === name);

package/src/renderer/settings-modal.ts

@@ -148,7 +148,7 @@ function buildSettingContext(modal: SettingsModal, entry: SettingEntry): string[
   ];
 
   if (entry.locked) lines.push(`Locked: ${entry.lockReason ?? 'This setting is locked by a higher-priority layer.'}`);
-  if (entry.conflict) lines.push(`Conflict: resolve with /settingssync resolve ${entry.setting.key} local|synced.`);
+  if (entry.conflict) lines.push(`Conflict: inspect with /settings and resolve runtime-owned sync state in the external host.`);
 
   lines.push('', entry.setting.description);
 

package/src/runtime/bootstrap-hook-bridge.ts

@@ -74,7 +74,7 @@ export function createResumeSessionHandler(options: ResumeSessionOptions): (sess
           options.conversation.log(`Resume: Reopened panels: ${reopenedPanels.join(', ')}`, { fg: '244' });
         }
         if ((meta.returnContext.remoteRunners?.length ?? 0) > 0) {
-          options.conversation.log(`Resume: Remote re-entry -> /remote recover ${meta.returnContext.remoteRunners![0]}`, { fg: '244' });
+          options.conversation.log('Resume: Remote re-entry belongs to the external runtime host; delegate explicit build/fix/review recovery from Agent.', { fg: '244' });
         }
         if (returnContextMode === 'assisted') {
           const helperModel = new HelperModel({

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