@pellux/goodvibes-agent 0.1.1 → 0.1.3

package/src/input/commands/knowledge.ts

@@ -8,10 +8,10 @@ type KnowledgeAskInput = Parameters<KnowledgeService['ask']>[0];
 type KnowledgeAskResult = Awaited<ReturnType<KnowledgeService['ask']>>;
 type KnowledgeAskMode = NonNullable<KnowledgeAskInput['mode']>;
 
-function requireKnowledgeApi(context: CommandContext) {
-  const knowledgeApi = context.clients?.knowledgeApi;
+function requireAgentKnowledgeApi(context: CommandContext) {
+  const knowledgeApi = context.clients?.agentKnowledgeApi;
   if (!knowledgeApi) {
-    context.print('[knowledge] Knowledge API is not available in this runtime.');
+    context.print('[knowledge] Agent Knowledge API is not available in this runtime. Refusing to use default Knowledge/Wiki or HomeGraph fallback.');
     return null;
   }
   return knowledgeApi;
@@ -57,14 +57,11 @@ function positionalArgs(args: string[], valuedFlags: readonly string[] = []): st
   });
 }
 
-function requireKnowledgeAsk(context: CommandContext): ((input: KnowledgeAskInput) => Promise<KnowledgeAskResult>) | null {
-  const serviceAsk = context.extensions.knowledgeService?.ask?.bind(context.extensions.knowledgeService);
+function requireAgentKnowledgeAsk(context: CommandContext): ((input: KnowledgeAskInput) => Promise<KnowledgeAskResult>) | null {
+  const serviceAsk = context.extensions.agentKnowledgeService?.ask?.bind(context.extensions.agentKnowledgeService);
   if (serviceAsk) return serviceAsk;
 
-  const clientAsk = (context.clients?.knowledgeApi as unknown as { ask?: (input: KnowledgeAskInput) => Promise<KnowledgeAskResult> } | undefined)?.ask;
-  if (clientAsk) return clientAsk;
-
-  context.print('[knowledge] Knowledge ask is not available in this runtime.');
+  context.print('[knowledge] Agent Knowledge ask is not available in this runtime. Refusing to use default Knowledge/Wiki or HomeGraph fallback.');
   return null;
 }
 
@@ -132,11 +129,11 @@ function renderKnowledgeAskResult(result: KnowledgeAskResult): string {
 export const knowledgeCommand: SlashCommand = {
   name: 'knowledge',
   aliases: ['know', 'kb'],
-  description: 'Structured knowledge graph: ingest URLs/bookmarks, inspect issues, and build compact prompt packets.',
+  description: 'Agent Knowledge/Wiki: isolated Agent-owned sources, graph, review queue, and compact prompt packets.',
   usage: '<subcommand> [args]',
   argsHint: 'status|ask|ingest-url|import-bookmarks|import-urls|list|search|get|queue|review-issue|candidates|reports|schedules|lint|packet|explain|reindex|consolidate',
   handler: async (args: string[], context: CommandContext): Promise<void> => {
-    const knowledge = requireKnowledgeApi(context);
+    const knowledge = requireAgentKnowledgeApi(context);
     if (!knowledge) {
       return;
     }
@@ -149,12 +146,16 @@ export const knowledgeCommand: SlashCommand = {
 
     switch (sub) {
       case 'ask': {
-        const ask = requireKnowledgeAsk(context);
+        const ask = requireAgentKnowledgeAsk(context);
         if (!ask) return;
-        const valuedFlags = ['--space', '--knowledge-space', '--limit', '--mode'];
+        const valuedFlags = ['--limit', '--mode'];
         const query = positionalArgs(rest, valuedFlags).join(' ').trim();
         if (!query) {
-          context.print('[knowledge] Usage: /knowledge ask <query> [--space <knowledgeSpaceId>] [--limit <n>] [--mode <concise|standard|detailed>]');
+          context.print('[knowledge] Usage: /knowledge ask <query> [--limit <n>] [--mode <concise|standard|detailed>]');
+          return;
+        }
+        if (readFlag(rest, '--space') || readFlag(rest, '--knowledge-space')) {
+          context.print('[knowledge] Agent Knowledge is isolated. --space/--knowledge-space is not accepted because Agent must not fall back to default Knowledge/Wiki or HomeGraph.');
           return;
         }
         const requestedMode = readFlag(rest, '--mode') as KnowledgeAskMode | undefined;
@@ -163,7 +164,6 @@ export const knowledgeCommand: SlashCommand = {
           : 'standard';
         const result = await ask({
           query,
-          knowledgeSpaceId: readFlag(rest, '--space') ?? readFlag(rest, '--knowledge-space'),
           limit: readPositiveIntFlag(rest, '--limit', 10),
           mode,
           includeSources: true,
@@ -177,7 +177,7 @@ export const knowledgeCommand: SlashCommand = {
       case 'status': {
         const status = await knowledge.status.get();
         context.print([
-          '[knowledge] Structured knowledge status',
+          '[knowledge] Agent Knowledge status',
           `  ready: ${status.ready ? 'yes' : 'no'}`,
           `  storage: ${status.storagePath}`,
           `  sources: ${status.sourceCount}`,
@@ -385,7 +385,7 @@ export const knowledgeCommand: SlashCommand = {
           const result = await knowledge.graph.issues.review({
             issueId,
             action: action as KnowledgeReviewAction,
-            reviewer: readFlag(rest, '--reviewer') ?? 'tui',
+            reviewer: readFlag(rest, '--reviewer') ?? 'agent',
             ...(value ? { value } : {}),
           });
           context.print([
@@ -508,7 +508,7 @@ export const knowledgeCommand: SlashCommand = {
         context.print([
           'Usage: /knowledge <subcommand>',
           '  status',
-          '  ask <query> [--space <knowledgeSpaceId>] [--limit <n>] [--mode <concise|standard|detailed>]',
+          '  ask <query> [--limit <n>] [--mode <concise|standard|detailed>]',
           '  ingest-url <url> [--title <title>] [--tags <a,b>] [--folder <path>]',
           '  import-bookmarks <path>',
           '  import-urls <path>',

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

@@ -0,0 +1,219 @@
+import { AgentPersonaRegistry, type AgentPersonaRecord } from '../../agent/persona-registry.ts';
+import type { CommandContext, CommandRegistry } from '../command-registry.ts';
+import { requireShellPaths } from './runtime-services.ts';
+
+interface ParsedPersonaArgs {
+  readonly rest: readonly string[];
+  readonly flags: ReadonlyMap<string, string>;
+  readonly yes: boolean;
+}
+
+function parsePersonaArgs(args: readonly string[]): ParsedPersonaArgs {
+  const flags = new Map<string, string>();
+  const rest: string[] = [];
+  let yes = false;
+  for (let index = 0; index < args.length; index += 1) {
+    const token = args[index] ?? '';
+    if (token === '--yes') {
+      yes = true;
+      continue;
+    }
+    if (token.startsWith('--')) {
+      const key = token.slice(2);
+      const next = args[index + 1];
+      if (next !== undefined && !next.startsWith('--')) {
+        flags.set(key, next);
+        index += 1;
+      } else {
+        flags.set(key, 'true');
+      }
+      continue;
+    }
+    rest.push(token);
+  }
+  return { rest, flags, yes };
+}
+
+function splitList(value: string | undefined): readonly string[] {
+  if (!value) return [];
+  return value.split(',').map((entry) => entry.trim()).filter(Boolean);
+}
+
+function registryFromContext(ctx: CommandContext): AgentPersonaRegistry {
+  return AgentPersonaRegistry.fromShellPaths(requireShellPaths(ctx));
+}
+
+function summarizePersona(persona: AgentPersonaRecord, activePersonaId: string | null): string {
+  const active = persona.id === activePersonaId ? 'active' : 'inactive';
+  const tags = persona.tags.length > 0 ? ` tags=${persona.tags.join(',')}` : '';
+  return `  ${persona.id}  ${active}  ${persona.reviewState}  ${persona.name} - ${persona.description}${tags}`;
+}
+
+function renderList(title: string, registry: AgentPersonaRegistry, personas: readonly AgentPersonaRecord[]): string {
+  const snapshot = registry.snapshot();
+  if (personas.length === 0) {
+    return `${title}\n  No local Agent personas yet. Create one with /personas create --name <name> --description <summary> --body <instructions>.`;
+  }
+  return [
+    `${title} (${personas.length})`,
+    `  store: ${snapshot.path}`,
+    `  active: ${snapshot.activePersona?.name ?? '(none)'}`,
+    ...personas.map((persona) => summarizePersona(persona, snapshot.activePersonaId)),
+  ].join('\n');
+}
+
+function renderPersona(persona: AgentPersonaRecord, activePersonaId: string | null): string {
+  return [
+    `Persona ${persona.name}`,
+    `  id: ${persona.id}`,
+    `  active: ${persona.id === activePersonaId ? 'yes' : 'no'}`,
+    `  review: ${persona.reviewState}`,
+    `  source: ${persona.source}`,
+    `  provenance: ${persona.provenance}`,
+    `  tags: ${persona.tags.join(', ') || '(none)'}`,
+    `  triggers: ${persona.triggers.join(', ') || '(none)'}`,
+    `  created: ${persona.createdAt}`,
+    `  updated: ${persona.updatedAt}`,
+    persona.staleReason ? `  stale reason: ${persona.staleReason}` : '',
+    '',
+    persona.description,
+    '',
+    persona.body,
+  ].filter(Boolean).join('\n');
+}
+
+function requiredFlag(flags: ReadonlyMap<string, string>, key: string): string {
+  const value = flags.get(key)?.trim();
+  if (!value) throw new Error(`Missing --${key}.`);
+  return value;
+}
+
+function printError(ctx: CommandContext, error: unknown): void {
+  ctx.print(`Error: ${error instanceof Error ? error.message : String(error)}`);
+}
+
+export function registerPersonasRuntimeCommands(registry: CommandRegistry): void {
+  registry.register({
+    name: 'personas',
+    aliases: ['persona'],
+    description: 'Manage local GoodVibes Agent personas',
+    usage: '[list|search <query>|show <id>|create --name <name> --description <summary> --body <instructions>|update <id> [--name ...] [--description ...] [--body ...]|use <id>|active|clear|review <id>|stale <id> <reason...>|delete <id> --yes]',
+    async handler(args, ctx) {
+      const sub = (args[0] ?? 'list').toLowerCase();
+      const registryStore = registryFromContext(ctx);
+      try {
+        if (sub === 'list' || sub === 'open') {
+          ctx.print(renderList('Agent Personas', registryStore, registryStore.list()));
+          return;
+        }
+        if (sub === 'search') {
+          const query = args.slice(1).join(' ').trim();
+          ctx.print(renderList(query ? `Agent Personas matching "${query}"` : 'Agent Personas', registryStore, registryStore.search(query)));
+          return;
+        }
+        if (sub === 'show') {
+          const id = args[1];
+          if (!id) {
+            ctx.print('Usage: /personas show <id>');
+            return;
+          }
+          const snapshot = registryStore.snapshot();
+          const persona = registryStore.get(id);
+          ctx.print(persona ? renderPersona(persona, snapshot.activePersonaId) : `Unknown persona: ${id}`);
+          return;
+        }
+        if (sub === 'create') {
+          const parsed = parsePersonaArgs(args.slice(1));
+          const body = parsed.flags.get('body')?.trim() || parsed.rest.join(' ').trim();
+          const persona = registryStore.create({
+            name: requiredFlag(parsed.flags, 'name'),
+            description: requiredFlag(parsed.flags, 'description'),
+            body,
+            tags: splitList(parsed.flags.get('tags')),
+            triggers: splitList(parsed.flags.get('triggers')),
+            source: 'user',
+            provenance: 'slash-command',
+          });
+          ctx.print(`Created Agent persona ${persona.id}: ${persona.name}`);
+          return;
+        }
+        if (sub === 'update') {
+          const id = args[1];
+          if (!id) {
+            ctx.print('Usage: /personas update <id> [--name ...] [--description ...] [--body ...]');
+            return;
+          }
+          const parsed = parsePersonaArgs(args.slice(2));
+          const updated = registryStore.update(id, {
+            name: parsed.flags.get('name'),
+            description: parsed.flags.get('description'),
+            body: parsed.flags.get('body'),
+            tags: parsed.flags.has('tags') ? splitList(parsed.flags.get('tags')) : undefined,
+            triggers: parsed.flags.has('triggers') ? splitList(parsed.flags.get('triggers')) : undefined,
+            provenance: 'slash-command',
+          });
+          ctx.print(`Updated Agent persona ${updated.id}: ${updated.name}`);
+          return;
+        }
+        if (sub === 'use') {
+          const id = args[1];
+          if (!id) {
+            ctx.print('Usage: /personas use <id>');
+            return;
+          }
+          const persona = registryStore.setActive(id);
+          ctx.print(`Active Agent persona: ${persona.name} (${persona.id})`);
+          return;
+        }
+        if (sub === 'active') {
+          const snapshot = registryStore.snapshot();
+          ctx.print(snapshot.activePersona ? renderPersona(snapshot.activePersona, snapshot.activePersonaId) : 'No active Agent persona.');
+          return;
+        }
+        if (sub === 'clear') {
+          registryStore.clearActive();
+          ctx.print('Cleared active Agent persona.');
+          return;
+        }
+        if (sub === 'review') {
+          const id = args[1];
+          if (!id) {
+            ctx.print('Usage: /personas review <id>');
+            return;
+          }
+          const persona = registryStore.markReviewed(id);
+          ctx.print(`Reviewed Agent persona ${persona.id}.`);
+          return;
+        }
+        if (sub === 'stale') {
+          const id = args[1];
+          if (!id) {
+            ctx.print('Usage: /personas stale <id> <reason...>');
+            return;
+          }
+          const persona = registryStore.markStale(id, args.slice(2).join(' '));
+          ctx.print(`Marked Agent persona ${persona.id} stale.`);
+          return;
+        }
+        if (sub === 'delete' || sub === 'remove') {
+          const parsed = parsePersonaArgs(args.slice(1));
+          const id = parsed.rest[0];
+          if (!id) {
+            ctx.print('Usage: /personas delete <id> --yes');
+            return;
+          }
+          if (!parsed.yes) {
+            ctx.print(`Refusing to delete Agent persona ${id} without --yes.`);
+            return;
+          }
+          const removed = registryStore.deletePersona(id);
+          ctx.print(`Deleted Agent persona ${removed.id}: ${removed.name}`);
+          return;
+        }
+        ctx.print('Usage: /personas [list|search <query>|show <id>|create|update|use|active|clear|review|stale|delete]');
+      } catch (error) {
+        printError(ctx, error);
+      }
+    },
+  });
+}

package/src/input/commands/shell-core.ts

@@ -2,7 +2,6 @@ import type { CommandRegistry } from '../command-registry.ts';
 import type { SelectionItem } from '../selection-modal.ts';
 import { EFFORT_DESCRIPTIONS } from '@pellux/goodvibes-sdk/platform/providers';
 import { REASONING_BUDGET_MAP } from '@pellux/goodvibes-sdk/platform/providers';
-import { executeWriteQuit } from './quit-shared.ts';
 import { compactConversation, requireKeybindingsManager, requireProviderApi } from './runtime-services.ts';
 import { summarizeError } from '@pellux/goodvibes-sdk/platform/utils';
 import { logger } from '@pellux/goodvibes-sdk/platform/utils';
@@ -159,7 +158,7 @@ export function registerShellCoreCommands(registry: CommandRegistry): void {
           { id: '/secrets', label: '/secrets set|link|get|test|list|delete', detail: 'Manage encrypted and provider-backed secrets', category: 'Tools & System' },
           { id: '/help', label: '/help', detail: 'This help', category: 'Tools & System' },
           { id: '/quit', label: '/quit', detail: 'Exit', category: 'Tools & System' },
-          { id: '/wq', label: '/wq', detail: 'Commit all git changes and then exit', category: 'Tools & System' },
+          { id: '/wq', label: '/wq', detail: 'Blocked in Agent; git commit/exit belongs to GoodVibes TUI', category: 'Tools & System' },
         ];
         ctx.openSelection('Help  —  Commands', items, { allowSearch: true }, (result) => {
           if (!result) return;
@@ -173,7 +172,7 @@ export function registerShellCoreCommands(registry: CommandRegistry): void {
         });
         return;
       }
-      ctx.print('Use /help to open the help modal. Commands: /agent, /model, /provider, /config, /template, /tools, /paste, /sessions, /bookmarks, /save, /load, /undo, /redo, /retry, /clear, /reset, /compact, /export, /title, /effort, /expand, /collapse, /debug, /quit, /wq');
+      ctx.print('Use /help to open the help modal. Commands: /agent, /model, /provider, /config, /template, /tools, /paste, /sessions, /bookmarks, /save, /load, /undo, /redo, /retry, /clear, /reset, /compact, /export, /title, /effort, /expand, /collapse, /debug, /quit');
     },
   });
 
@@ -225,9 +224,13 @@ export function registerShellCoreCommands(registry: CommandRegistry): void {
   registry.register({
     name: 'wq',
     aliases: [':wq'],
-    description: 'Commit all git changes and then exit',
-    async handler(_args, ctx) {
-      await executeWriteQuit(ctx);
+    description: 'Blocked in Agent; git commit/exit is owned by GoodVibes TUI',
+    handler(_args, ctx) {
+      ctx.print([
+        'Blocked: /wq is not available in GoodVibes Agent.',
+        'Git commit, worktree, and coding-session exit flows belong to GoodVibes TUI.',
+        'No files, commits, or repository state were changed.',
+      ].join('\n'));
     },
   });
 

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

@@ -12,15 +12,20 @@ import {
   upsertEcosystemCatalogEntry,
 } from '@/runtime/index.ts';
 import { requireEcosystemCatalogPaths, requirePanelManager, requireShellPaths } from './runtime-services.ts';
+import { runAgentSkillsRuntimeCommand } from './agent-skills-runtime.ts';
 
 export function registerSkillsRuntimeCommands(registry: CommandRegistry): void {
   registry.register({
     name: 'skills',
     aliases: ['skill'],
     description: 'Inspect installed skill packs',
-    usage: '[open|list|show <name>|origins|browse [query]|installed|catalog-review <id>|publish-local <id> <path> <summary...>|unpublish <id>|install-hint <catalog-id>|install <id> [project|user]|update <id> [project|user]|uninstall <id> [project|user]]',
+    usage: '[open|local ...|list|show <name>|origins|browse [query]|installed|catalog-review <id>|publish-local <id> <path> <summary...>|unpublish <id>|install-hint <catalog-id>|install <id> [project|user]|update <id> [project|user]|uninstall <id> [project|user]]',
     async handler(args, ctx) {
       const sub = args[0] ?? 'open';
+      if (sub === 'local' || sub === 'agent') {
+        await runAgentSkillsRuntimeCommand(args.slice(1), ctx);
+        return;
+      }
       if (sub === 'open' || sub === 'panel') {
         if (ctx.showPanel) ctx.showPanel('skills');
         else {
@@ -215,7 +220,7 @@ export function registerSkillsRuntimeCommands(registry: CommandRegistry): void {
         ctx.print(result.ok ? `Uninstalled curated skill ${entryId} from ${result.removedPath}` : `Error: ${result.error}`);
         return;
       }
-      ctx.print('Usage: /skills [open|list|show <name>|origins|browse [query]|installed|catalog-review <id>|publish-local <id> <path> <summary...>|unpublish <id>|install-hint <catalog-id>|install <id> [project|user]|update <id> [project|user]|uninstall <id> [project|user]]');
+      ctx.print('Usage: /skills [open|local ...|list|show <name>|origins|browse [query]|installed|catalog-review <id>|publish-local <id> <path> <summary...>|unpublish <id>|install-hint <catalog-id>|install <id> [project|user]|update <id> [project|user]|uninstall <id> [project|user]]');
     },
   });
 }

package/src/input/commands.ts

@@ -54,6 +54,9 @@ import { registerCloudflareRuntimeCommands } from './commands/cloudflare-runtime
 import { registerWorkPlanRuntimeCommands } from './commands/work-plan-runtime.ts';
 import { registerAgentWorkspaceRuntimeCommands } from './commands/agent-workspace-runtime.ts';
 import { registerAgentExternalizedTuiCommands } from './commands/agent-externalized-tui.ts';
+import { registerDelegationRuntimeCommands } from './commands/delegation-runtime.ts';
+import { registerPersonasRuntimeCommands } from './commands/personas-runtime.ts';
+import { registerAgentSkillsRuntimeCommands } from './commands/agent-skills-runtime.ts';
 
 /**
  * registerBuiltinCommands - Register all built-in slash commands into the registry.
@@ -62,6 +65,9 @@ import { registerAgentExternalizedTuiCommands } from './commands/agent-externali
 export function registerBuiltinCommands(registry: CommandRegistry): void {
   registerShellCoreCommands(registry);
   registerAgentWorkspaceRuntimeCommands(registry);
+  registerPersonasRuntimeCommands(registry);
+  registerAgentSkillsRuntimeCommands(registry);
+  registerDelegationRuntimeCommands(registry);
   registerConfigCommand(registry);
   registerOperatorRuntimeCommands(registry);
   registerIntegrationRuntimeCommands(registry);

package/src/input/panel-integration-actions.ts

@@ -2,37 +2,8 @@ import type { CommandContext } from './command-registry.ts';
 import { logger } from '@pellux/goodvibes-sdk/platform/utils';
 import type { Panel } from '../panels/types.ts';
 import type { PanelManager } from '../panels/panel-manager.ts';
-import { FileExplorerPanel } from '../panels/file-explorer-panel.ts';
-import { FilePreviewPanel } from '../panels/file-preview-panel.ts';
-import { SymbolOutlinePanel } from '../panels/symbol-outline-panel.ts';
 import { ApprovalPanel } from '../panels/approval-panel.ts';
 
-function ensurePreviewPanel(panelManager: PanelManager): FilePreviewPanel | null {
-  const existing = panelManager.getPanel('preview');
-  if (existing instanceof FilePreviewPanel) {
-    const pane = panelManager.getPaneOf('preview');
-    panelManager.activateById('preview');
-    if (pane) panelManager.focusPane(pane);
-    return existing;
-  }
-  const targetPane: 'top' | 'bottom' = panelManager.isBottomPaneVisible()
-    ? (panelManager.getFocusedPane() === 'top' ? 'bottom' : 'top')
-    : 'bottom';
-  const opened = panelManager.open('preview', targetPane);
-  panelManager.show();
-  panelManager.focusPane(targetPane);
-  return opened instanceof FilePreviewPanel ? opened : null;
-}
-
-function syncSymbolOutlineFromPreview(panelManager: PanelManager, previewPanel: FilePreviewPanel): void {
-  const symbols = panelManager.getPanel('symbols');
-  const filePath = previewPanel.getCurrentFilePath();
-  const source = previewPanel.getSource();
-  if (symbols instanceof SymbolOutlinePanel && filePath && source !== null) {
-    symbols.loadFile(filePath, source);
-  }
-}
-
 export function handlePanelIntegrationAction(
   panelManager: PanelManager,
   activePanel: Panel | null,
@@ -41,29 +12,6 @@ export function handlePanelIntegrationAction(
 ): boolean {
   if (!activePanel) return false;
 
-  if ((key === 'enter' || key === 'return' || key === 'right') && activePanel instanceof FileExplorerPanel) {
-    const filePath = activePanel.getFocusedFilePath();
-    if (!filePath) return false;
-    const previewPanel = ensurePreviewPanel(panelManager);
-    if (!previewPanel) return false;
-    previewPanel.openFile(filePath);
-    syncSymbolOutlineFromPreview(panelManager, previewPanel);
-    return true;
-  }
-
-  if ((key === 'enter' || key === 'return') && activePanel instanceof SymbolOutlinePanel) {
-    const location = activePanel.getSelectedLocation();
-    if (!location) return false;
-    const previewPanel = ensurePreviewPanel(panelManager);
-    if (!previewPanel) return false;
-    if (previewPanel.getCurrentFilePath() !== location.path) {
-      previewPanel.openFile(location.path);
-      syncSymbolOutlineFromPreview(panelManager, previewPanel);
-    }
-    previewPanel.goToLine(location.line);
-    return true;
-  }
-
   if ((key === 'enter' || key === 'return') && activePanel instanceof ApprovalPanel) {
     const command = activePanel.getSelectedCommand();
     if (!command || !commandContext?.executeCommand) return false;

package/src/input/submission-router.ts

@@ -8,7 +8,7 @@ export interface SubmissionRouterInput {
 }
 
 const PLAN_COMMANDS = new Set(['plan']);
-const DELEGATION_COMMANDS = new Set(['review', 'wrfc', 'teamwork', 'agents', 'remote']);
+const DELEGATION_COMMANDS = new Set(['delegate', 'build', 'review', 'wrfc', 'teamwork', 'agents', 'remote']);
 const PANEL_COMMANDS = new Set(['panel']);
 const ORCHESTRATION_COMMANDS = new Set([
   'orchestration',

package/src/main.ts

@@ -54,6 +54,7 @@ import { allowTerminalWrite, installTuiTerminalOutputGuard } from './runtime/ter
 import { ProjectPlanningCoordinator } from './planning/project-planning-coordinator.ts';
 import { buildCommandArgsHint } from './input/command-args-hint.ts';
 import { summarizeRunningAgents } from './renderer/process-summary.ts';
+import { GOODVIBES_AGENT_PAIRING_SURFACE } from './config/surface.ts';
 
 const ALT_SCREEN_ENTER = '\x1b[?1049h';
 const ALT_SCREEN_EXIT  = '\x1b[?1049l';
@@ -320,7 +321,7 @@ async function main() {
               inputOptions = {
                 origin: {
                   source: 'project-planning',
-                  surface: 'tui',
+                  surface: GOODVIBES_AGENT_PAIRING_SURFACE,
                   metadata: {
                     projectId: ctx.services.projectPlanningProjectId,
                     knowledgeSpaceId: planning.state.knowledgeSpaceId,

package/src/panels/builtin/agent.ts

@@ -3,7 +3,6 @@ import { AgentLogsPanel } from '../agent-logs-panel.ts';
 import { ContextVisualizerPanel } from '../context-visualizer-panel.ts';
 import { ThinkingPanel } from '../thinking-panel.ts';
 import { ToolInspectorPanel } from '../tool-inspector-panel.ts';
-import { WrfcPanel } from '../wrfc-panel.ts';
 import { SchedulePanel } from '../schedule-panel.ts';
 import { ProjectPlanningPanel } from '../project-planning-panel.ts';
 import { WorkPlanPanel } from '../work-plan-panel.ts';
@@ -67,19 +66,6 @@ export function registerAgentPanels(manager: PanelManager, deps: ResolvedBuiltin
     },
   });
 
-  manager.registerType({
-    id: 'wrfc',
-    name: 'WRFC',
-    icon: 'W',
-    category: 'agent',
-    description: 'WRFC chain view: write, review, fix, and confirm cycle status',
-    preload: true,
-    factory: () => {
-      const ui = requireUiServices(deps);
-      return new WrfcPanel(ui.events.workflows, { controller: ui.agents.wrfcController });
-    },
-  });
-
   manager.registerType({
     id: 'work-plan',
     name: 'Work Plan',

package/src/panels/builtin/session.ts

@@ -14,6 +14,7 @@ import {
   buildCompanionConnectionInfo,
 } from '@pellux/goodvibes-sdk/platform/pairing';
 import { copyToClipboard } from '../../utils/clipboard.ts';
+import { GOODVIBES_AGENT_PAIRING_SURFACE } from '../../config/surface.ts';
 
 function getLocalNetworkIp(): string {
   const nets = networkInterfaces();
@@ -51,7 +52,7 @@ export function registerSessionPanels(manager: PanelManager, deps: ResolvedBuilt
     factory: () => {
       if (!deps.daemonHomeDir) throw new Error('daemonHomeDir must be provided to the session panel factory via BuiltinPanelDeps');
       const daemonHomeDir = deps.daemonHomeDir;
-      const tokenRecord = getOrCreateCompanionToken('tui', { daemonHomeDir });
+      const tokenRecord = getOrCreateCompanionToken(GOODVIBES_AGENT_PAIRING_SURFACE, { daemonHomeDir });
       const daemonPort = deps.configManager.get('controlPlane.port');
       const daemonHost = String(process.env['GOODVIBES_DAEMON_HOST'] ?? getLocalNetworkIp());
       const daemonUrl = `http://${daemonHost}:${daemonPort}`;
@@ -60,7 +61,7 @@ export function registerSessionPanels(manager: PanelManager, deps: ResolvedBuilt
         daemonUrl,
         token: tokenRecord.token,
         password: bootstrapPassword,
-        surface: 'tui',
+        surface: GOODVIBES_AGENT_PAIRING_SURFACE,
       });
       const regenerate = (): typeof connectionInfo => {
         const newRecord = regenerateCompanionToken({ daemonHomeDir });
@@ -68,7 +69,7 @@ export function registerSessionPanels(manager: PanelManager, deps: ResolvedBuilt
           daemonUrl,
           token: newRecord.token,
           password: bootstrapPassword,
-          surface: 'tui',
+          surface: GOODVIBES_AGENT_PAIRING_SURFACE,
         });
       };
       return new QrPanel(connectionInfo, regenerate, copyToClipboard);

package/src/panels/index.ts

@@ -6,13 +6,9 @@ export { TokenBudgetPanel } from './token-budget-panel.ts';
 export { CostTrackerPanel } from './cost-tracker-panel.ts';
 export { AgentInspectorPanel } from './agent-inspector-panel.ts';
 export { AgentLogsPanel } from './agent-logs-panel.ts';
-export { WrfcPanel } from './wrfc-panel.ts';
 export { ProviderHealthPanel } from './provider-health-panel.ts';
 export { ProviderHealthTracker } from './provider-health-tracker.ts';
 export type { ProviderHealth, ProviderStatus } from './provider-health-tracker.ts';
-export { GitPanel } from './git-panel.ts';
-export { SymbolOutlinePanel } from './symbol-outline-panel.ts';
-export type { SymbolEntry, SymbolKind } from './symbol-outline-panel.ts';
 export { ProviderStatsPanel } from './provider-stats-panel.ts';
 export { SessionBrowserPanel } from './session-browser-panel.ts';
 export { DocsPanel } from './docs-panel.ts';
@@ -38,7 +34,6 @@ export { SubscriptionPanel } from './subscription-panel.ts';
 export { HooksPanel } from './hooks-panel.ts';
 export { SecurityPanel } from './security-panel.ts';
 export { MarketplacePanel } from './marketplace-panel.ts';
-export { SandboxPanel } from './sandbox-panel.ts';
 export { ApprovalPanel } from './approval-panel.ts';
 export { KnowledgePanel } from './knowledge-panel.ts';
 export { SystemMessagesPanel } from './system-messages-panel.ts';

package/src/panels/orchestration-panel.ts

@@ -1,6 +1,5 @@
 /**
- * OrchestrationPanel — displays task graphs, node contracts, recursion guards,
- * and WRFC-visible orchestration state.
+ * OrchestrationPanel — displays task graphs, node contracts, and recursion guards.
  *
  * Migrated (Wave B2): extends ScrollableListPanel<OrchestrationGraphRecord>.
  * Navigation (up/down/j/k) is handled by the base class.
@@ -102,7 +101,7 @@ export class OrchestrationPanel extends ScrollableListPanel<OrchestrationGraphRe
   // ---------------------------------------------------------------------------
 
   public render(width: number, height: number): Line[] {
-    const intro = 'Task graphs, node contracts, recursion guards, and WRFC-visible orchestration state.';
+    const intro = 'Read-only task graph posture, node contracts, and recursion guard state. Agent does not start local worker chains.';
 
     if (!this.readModel) {
       this.needsRender = false;
@@ -134,7 +133,7 @@ export class OrchestrationPanel extends ScrollableListPanel<OrchestrationGraphRe
         { label: 'failed', value: String(snapshot.totalFailedGraphs), valueColor: snapshot.totalFailedGraphs > 0 ? C.failed : C.dim },
         { label: 'guards', value: String(snapshot.recursionGuardTrips), valueColor: snapshot.recursionGuardTrips > 0 ? C.blocked : C.dim },
       ], C),
-      buildGuidanceLine(width, '/orchestration', 'inspect recursive execution posture, graph health, and node contract flow', C),
+      buildGuidanceLine(width, '/orchestration', 'inspect graph health without spawning local workers', C),
     ];
     if (graphs.length === 0) {
       this.needsRender = false;
@@ -148,7 +147,7 @@ export class OrchestrationPanel extends ScrollableListPanel<OrchestrationGraphRe
             ...buildEmptyState(
               width,
               this.getEmptyStateMessage(),
-              'Graphs, nodes, child contracts, and recursion guard trips will appear here as orchestration starts.',
+              'Graphs, nodes, child contracts, and recursion guard trips appear here only if a runtime record already exists.',
               [
                 { command: '/tasks', summary: 'create or inspect task flows that feed orchestration graphs' },
                 { command: '/communication', summary: 'review structured agent communication alongside graph execution' },