@pellux/goodvibes-tui 0.22.0 → 0.24.0

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

@@ -1,5 +1,6 @@
 import { ServiceRegistry } from '@pellux/goodvibes-sdk/platform/config';
 import type { ConfigManager } from '@pellux/goodvibes-sdk/platform/config';
+import { probeTermCaps } from '../../renderer/term-caps.ts';
 import { evaluateSessionMaintenance, formatSessionMaintenanceLines } from '@/runtime/index.ts';
 import { estimateConversationTokens } from '@pellux/goodvibes-sdk/platform/core';
 import type { CommandRegistry } from '../command-registry.ts';
@@ -39,7 +40,7 @@ export function registerHealthRuntimeCommands(registry: CommandRegistry): void {
     name: 'health',
     aliases: ['doctor'],
     description: 'Health workspace for startup posture, service readiness, sandbox posture, and provider health',
-    usage: '[open|review|setup|services|sandbox|provider|accounts|auth|settings|intelligence|remote|mcp|continuity|worktrees|maintenance|repair [domain]]',
+    usage: '[open|review|setup|services|sandbox|provider|accounts|auth|settings|intelligence|remote|mcp|continuity|worktrees|maintenance|term|repair [domain]]',
     async handler(args, ctx) {
       const sub = (args[0] ?? 'review').toLowerCase();
       const readModels = requireReadModels(ctx);
@@ -127,8 +128,8 @@ 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: /settings-sync panel',
+          '  next: /settings-sync show <key>',
           '  next: /managed staged',
         ].join('\n'));
         return;
@@ -282,6 +283,23 @@ export function registerHealthRuntimeCommands(registry: CommandRegistry): void {
         return;
       }
 
+      if (sub === 'term') {
+        const caps = probeTermCaps(process.stdout as NodeJS.WriteStream);
+        const issues: string[] = [];
+        if (caps.capability === 'none') issues.push('terminal reports no color support — UI rendering will be degraded (no ANSI colors)');
+        if (caps.capability === 'basic16') issues.push('terminal limited to 16 ANSI colors — gradient and true-color UI elements will be approximated');
+        if (!caps.syncedOutput) issues.push('DEC Synchronized Output (mode 2026) is disabled — screen-tearing may be visible on slow connections');
+        ctx.print([
+          'Health Review: Terminal Capabilities',
+          `  color capability: ${caps.capability}`,
+          `  synced output (mode 2026): ${caps.syncedOutput ? 'enabled' : 'disabled'}`,
+          `  NO_COLOR env: ${process.env['NO_COLOR'] !== undefined && process.env['NO_COLOR'] !== '' ? 'set (forces none)' : 'unset'}`,
+          `  TERM env: ${process.env['TERM'] ?? '(unset)'}`,
+          ...(issues.length > 0 ? issues.map((issue) => `  issue: ${issue}`) : ['  no terminal capability issues detected']),
+        ].join('\n'));
+        return;
+      }
+
       if (sub === 'repair') {
         const domain = (args[1] ?? 'review').toLowerCase();
         const lines = ['Health Repair'];
@@ -290,7 +308,7 @@ export function registerHealthRuntimeCommands(registry: CommandRegistry): void {
           lines.push('  domain: settings');
           lines.push(...(
             settings.conflicts.length > 0
-              ? ['  /settingssync panel', '  /settingssync show <key>', '  /managed staged']
+              ? ['  /settings-sync panel', '  /settings-sync show <key>', '  /managed staged']
               : ['  no active settings repair actions suggested']
           ));
           lines.push('  verify: /health settings');
@@ -426,6 +444,7 @@ export function registerHealthRuntimeCommands(registry: CommandRegistry): void {
         '  /health remote',
         '  /health maintenance',
         '  /health worktrees',
+        '  /health term',
         '  /health repair <domain>',
         '  /setup onboarding',
       ].join('\n'));

package/src/input/commands/knowledge.ts

@@ -132,7 +132,7 @@ function renderKnowledgeAskResult(result: KnowledgeAskResult): string {
 export const knowledgeCommand: SlashCommand = {
   name: 'knowledge',
   aliases: ['know'],
-  description: 'Structured knowledge graph: ingest URLs/bookmarks, inspect issues, and build compact prompt packets.',
+  description: 'Structured knowledge graph: ingest URLs/bookmarks, inspect issues, and build 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> => {

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

@@ -53,7 +53,6 @@ export function registerLocalRuntimeCommands(registry: CommandRegistry): void {
     name: 'incident-review',
     aliases: [],
     description: 'Alias for /incident open',
-    usage: '',
     handler(_args, ctx) {
       if (ctx.openIncidentPanel) {
         ctx.openIncidentPanel();
@@ -249,7 +248,7 @@ export function registerLocalRuntimeCommands(registry: CommandRegistry): void {
     aliases: ['img'],
     description: 'Attach an image file to the next message',
     usage: '<path> [prompt text]',
-    argsHint: '<path> [prompt]',
+    argsHint: '<path> [prompt text]',
     async handler(args, ctx) {
       if (args.length === 0) {
         ctx.print('Usage: /image <path> [prompt text]\nSupported formats: PNG, JPEG, WebP, GIF');

package/src/input/commands/memory-product-runtime.ts

@@ -55,7 +55,7 @@ export function registerMemoryProductRuntimeCommands(registry: CommandRegistry):
 
   registry.register({
     name: 'session-memory',
-    description: 'Dedicated front-door for session-scoped memory capture and review. All subcommands are filtered to scope=session.',
+    description: 'Dedicated front-door for session-scoped memory capture and review. All subcommands are filtered to scope=session',
     usage: '[queue [limit] | export <path> | add <class> <summary...>]',
     async handler(args, ctx) {
       const sub = (args[0] ?? 'queue').toLowerCase();
@@ -82,7 +82,7 @@ export function registerMemoryProductRuntimeCommands(registry: CommandRegistry):
 
   registry.register({
     name: 'team-memory',
-    description: 'Dedicated front-door for team/shared memory review and exchange. The queue and export subcommands are filtered to scope=team.',
+    description: 'Dedicated front-door for team/shared memory review and exchange. The queue and export subcommands are filtered to scope=team',
     usage: '[queue [limit] | export <path> | import <path> | capture policy]',
     async handler(args, ctx) {
       const sub = (args[0] ?? 'queue').toLowerCase();

package/src/input/commands/memory.ts

@@ -25,7 +25,7 @@ import { VALID_CLASSES, VALID_REVIEW_STATES, VALID_SCOPES } from './recall-share
 export const recallCommand: SlashCommand = {
   name: 'recall',
   aliases: ['rc'],
-  description: 'Project memory: add decisions, constraints, incidents, and patterns with provenance.',
+  description: 'Project memory: add decisions, constraints, incidents, and patterns with provenance',
   usage: '<subcommand> [args]',
   argsHint: 'add|search|link|get|list|remove',
   handler: async (args: string[], context: CommandContext): Promise<void> => {

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

@@ -5,7 +5,6 @@ export function registerOnboardingRuntimeCommands(registry: CommandRegistry): vo
   registry.register({
     name: 'onboarding',
     description: 'Open the onboarding wizard with current settings preloaded for review and editing',
-    usage: '',
     handler(_args, ctx) {
       openOnboardingWizard(ctx, { mode: 'edit', reset: true });
       ctx.print('Opening onboarding wizard.');

package/src/input/commands/policy.ts

@@ -4,7 +4,7 @@ import { dispatchPolicyCommand } from './policy-dispatch.ts';
 export const policyCommand: SlashCommand = {
   name: 'policy',
   aliases: ['pol'],
-  description: 'Open the policy panel or manage versioned policy bundles (load, simulate, diff, promote, rollback).',
+  description: 'Open the policy panel or manage versioned policy bundles (load, simulate, diff, promote, rollback)',
   usage: '<subcommand> [args]',
   argsHint: 'load|simulate|diff|lint|preflight|promote|rollback|status',
   handler: async (args: string[], context: CommandContext): Promise<void> => {

package/src/input/commands/profile-sync-runtime.ts

@@ -16,7 +16,8 @@ function inspectProfileSyncBundle(bundle: ProfileSyncBundle): string {
 
 export function registerProfileSyncRuntimeCommands(registry: CommandRegistry): void {
   registry.register({
-    name: 'profilesync',
+    name: 'profile-sync',
+    aliases: ['profilesync'],
     description: 'Export, import, and inspect profile sync bundles',
     usage: '[list|export <path>|inspect <path>|import <path> [prefix]]',
     handler(args, ctx) {
@@ -36,7 +37,7 @@ export function registerProfileSyncRuntimeCommands(registry: CommandRegistry): v
 
       const pathArg = args[1];
       if (!pathArg) {
-        ctx.print(`Usage: /profilesync ${sub} <path>${sub === 'import' ? ' [prefix]' : ''}`);
+        ctx.print(`Usage: /profile-sync ${sub} <path>${sub === 'import' ? ' [prefix]' : ''}`);
         return;
       }
       const targetPath = shellPaths.resolveWorkspacePath(pathArg);
@@ -93,7 +94,7 @@ export function registerProfileSyncRuntimeCommands(registry: CommandRegistry): v
       }
 
       recordSettingsSyncFailure('profiles', `unsupported subcommand: ${sub}`, controlPlaneConfigDir);
-      ctx.print('Usage: /profilesync [list|export <path>|inspect <path>|import <path> [prefix]]');
+      ctx.print('Usage: /profile-sync [list|export <path>|inspect <path>|import <path> [prefix]]');
     },
   });
 }

package/src/input/commands/provider.ts

@@ -365,7 +365,7 @@ function handleFallbackTest(
 export const providerCommand: SlashCommand = {
   name: 'provider-opt',
   aliases: ['prov-opt'],
-  description: 'Manage provider routing optimizer (route, pin, explain, fallback).',
+  description: 'Manage provider routing optimizer (route, pin, explain, fallback)',
   usage: '<subcommand> [args]',
   argsHint: 'optimizer|route|explain-route|pin|fallback',
   handler: async (args: string[], context: CommandContext): Promise<void> => {

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

@@ -12,7 +12,6 @@ export function registerQrcodeRuntimeCommands(registry: CommandRegistry): void {
     name: 'qrcode',
     aliases: ['qr', 'pair'],
     description: 'Open the QR code panel for companion app pairing',
-    usage: '',
     handler(_args, ctx) {
       openCommandPanel(ctx, 'qr-code');
     },

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

@@ -7,6 +7,8 @@ import type {
   CommandSessionServices,
   CommandWorkspaceServices,
 } from '../command-registry.ts';
+import { getLastCompactionEvent } from '@pellux/goodvibes-sdk/platform/core';
+import type { CompactionContext, CompactionEvent } from '@pellux/goodvibes-sdk/platform/core';
 import type { UiReadModels } from '../../runtime/ui-read-models.ts';
 import type { ShellPathService } from '@/runtime/index.ts';
 import type { EcosystemCatalogPathOptions } from '@/runtime/index.ts';
@@ -236,13 +238,40 @@ export function requireProviderApi(context: CommandContext): ProviderApi {
   return requireContextValue(context.clients?.providerApi, 'clients.providerApi');
 }
 
-export async function compactConversation(context: CommandContext): Promise<void> {
+/**
+ * Compact the conversation and return the CompactionEvent recorded by the SDK,
+ * or null if no event was recorded (e.g. compaction was skipped or produced no
+ * change).
+ */
+export async function compactConversation(context: CommandContext): Promise<CompactionEvent | null> {
+  const eventBefore = getLastCompactionEvent();
+  const sessionMemories = context.session.sessionMemoryStore?.list() ?? [];
+  const compactionCtx: CompactionContext = {
+    messages: context.session.conversationManager.getMessagesForLLM(),
+    sessionMemories,
+    agents: [],
+    wrfcChains: [],
+    activePlan: null,
+    lineageEntries: [],
+    compactionCount: 0,
+    contextWindow: 0,
+    trigger: 'manual',
+    extractionModelId: context.session.runtime.model,
+    extractionProvider: context.session.runtime.provider,
+  };
   await context.session.conversationManager.compact(
     context.provider.providerRegistry,
     context.session.runtime.model,
     'manual',
     context.session.runtime.provider,
+    compactionCtx,
   );
+  const eventAfter = getLastCompactionEvent();
+  // Return the new event only if it differs from the one recorded before the call.
+  if (eventAfter !== null && eventAfter !== eventBefore) {
+    return eventAfter;
+  }
+  return null;
 }
 
 export function requireKnowledgeApi(context: CommandContext): KnowledgeApi {

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

@@ -162,7 +162,7 @@ export function registerSessionContentCommands(registry: CommandRegistry): void
   registry.register({
     name: 'undo',
     aliases: [],
-    description: 'Undo last action. /undo file — revert last file write/edit. /undo — remove last conversation turn.',
+    description: 'Undo last action. /undo file — revert last file write/edit. /undo — remove last conversation turn',
     usage: '[file]',
     argsHint: '[file]',
     handler(args, ctx) {
@@ -191,7 +191,7 @@ export function registerSessionContentCommands(registry: CommandRegistry): void
 
   registry.register({
     name: 'redo',
-    description: 'Redo last undone action. /redo file — re-apply last reverted file. /redo — restore conversation turn.',
+    description: 'Redo last undone action. /redo file — re-apply last reverted file. /redo — restore conversation turn',
     usage: '[file]',
     argsHint: '[file]',
     handler(args, ctx) {

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

@@ -6,7 +6,8 @@ import type { TranscriptEventKind } from '@pellux/goodvibes-sdk/platform/core';
 import type { ConversationTitleSource } from '../../core/conversation';
 import type { SessionReturnContextSummary } from '@/runtime/index.ts';
 import { formatReturnContextForDisplay, getReturnContextMode, maybeAssistReturnContextSummary } from '@/runtime/index.ts';
-import { requirePanelManager, requireProviderApi, requireSessionManager } from './runtime-services.ts';
+import { requirePanelManager, requireProviderApi, requireSessionManager, requireShellPaths } from './runtime-services.ts';
+import { replayJournalForSession } from '../../core/session-recovery.ts';
 import { summarizeError } from '@pellux/goodvibes-sdk/platform/utils';
 
 function parseTranscriptKind(raw: string | undefined): TranscriptEventKind | 'all' {
@@ -240,6 +241,26 @@ export async function handleSessionWorkflowCommand(args: string[], ctx: CommandC
       ctx.session.conversationManager.fromJSON({ messages: messages as never[], title: meta.title, titleSource: meta.titleSource });
       ctx.session.conversationManager.rebuildHistory();
       ctx.session.runtime.sessionId = found.name;
+
+      // Journal replay: recover turns that post-date the loaded snapshot.
+      const shellPaths = requireShellPaths(ctx);
+      const journalReplay = replayJournalForSession({
+        homeDirectory: shellPaths.homeDirectory,
+        snapshotTimestamp: meta.timestamp,
+        conversation: ctx.session.conversationManager,
+        sessionId: found.name,
+        persistSnapshot: (replayedMessages) => {
+          sm.save(found.name, replayedMessages as never[], {
+            title: ctx.session.conversationManager.title || meta.title,
+            model: meta.model,
+            provider: meta.provider,
+            timestamp: Date.now(),
+            titleSource: meta.titleSource,
+            returnContext: meta.returnContext,
+          });
+        },
+      });
+
       if (meta.model) {
         try {
           const selected = await providerApi.selectModel(meta.model);
@@ -252,7 +273,16 @@ export async function handleSessionWorkflowCommand(args: string[], ctx: CommandC
       }
       if (meta.provider) ctx.session.runtime.provider = meta.provider;
       ctx.renderRequest();
-      ctx.print(`Resumed session: ${found.name}\n  Name: ${meta.title || '(untitled)'}\n  Messages: ${messages.length}\n  Model: ${meta.model || ctx.session.runtime.model}`);
+      const resumedMsgCount = ctx.session.conversationManager.getMessageCount();
+      ctx.print(`Resumed session: ${found.name}\n  Name: ${meta.title || '(untitled)'}\n  Messages: ${resumedMsgCount}\n  Model: ${meta.model || ctx.session.runtime.model}`);
+      if (journalReplay.replayed > 0) {
+        ctx.print(`  [Recovery] Replayed ${journalReplay.replayed} journal record(s) — restored turns since last snapshot.`);
+      }
+      if (journalReplay.hadCorruptTail && journalReplay.replayed === 0) {
+        ctx.print('  [Recovery] Journal tail was corrupt or unrecognised (quarantined). Proceeding with snapshot only.');
+      } else if (journalReplay.hadCorruptTail) {
+        ctx.print('  [Recovery] Journal tail was partially corrupt (quarantined). Replay stopped at last good record.');
+      }
       const reopenedPanels = reopenPanelsFromReturnContext(ctx, meta.returnContext);
       const returnContextMode = getReturnContextMode(ctx.platform.configManager);
       if (returnContextMode !== 'off' && meta.returnContext) {

package/src/input/commands/session.ts

@@ -339,7 +339,7 @@ function handleCancel(args: string[], context: CommandContext): void {
 export const sessionCommand: SlashCommand = {
   name: 'session',
   aliases: ['sess'],
-  description: 'Session lifecycle and orchestration: list, resume, fork, save, export, link-task, handoff, graph, cancel.',
+  description: 'Session lifecycle and orchestration: list, resume, fork, save, export, link-task, handoff, graph, cancel',
   usage: '<subcommand> [args]',
   argsHint: 'list|rename|resume|fork|save|info|export|search|delete|events|groups|hotspots|link-task|handoff|graph|cancel',
   handler: async (args: string[], context: CommandContext): Promise<void> => {

package/src/input/commands/settings-sync-runtime.ts

@@ -24,8 +24,8 @@ import { summarizeError } from '@pellux/goodvibes-sdk/platform/utils';
 
 export function registerSettingsSyncRuntimeCommands(registry: CommandRegistry): void {
   registry.register({
-    name: 'settingssync',
-    aliases: ['settings-sync'],
+    name: 'settings-sync',
+    aliases: ['settingssync'],
     description: 'Review sync posture, export/import settings-sync bundles, and open the settings sync workspace',
     usage: '[review|panel|show <key>|staged|conflicts|resolve <key> <local|synced>|failures|rollback-history|export <path>|inspect <path>|pull <path>|push <path>|lock <key> <source> <reason...>|unlock <key>]',
     handler(args, ctx) {
@@ -39,7 +39,7 @@ export function registerSettingsSyncRuntimeCommands(registry: CommandRegistry):
       if (sub === 'show') {
         const key = args[1] as ConfigKey | undefined;
         if (!key || !CONFIG_KEYS.has(key)) {
-          ctx.print('Usage: /settingssync show <config-key>');
+          ctx.print('Usage: /settings-sync show <config-key>');
           return;
         }
         ctx.print(formatResolvedSettingReview(ctx.platform.configManager, key));
@@ -63,7 +63,7 @@ export function registerSettingsSyncRuntimeCommands(registry: CommandRegistry):
         const key = args[1] as ConfigKey | undefined;
         const resolution = (args[2] ?? '').toLowerCase();
         if (!key || !CONFIG_KEYS.has(key) || (resolution !== 'local' && resolution !== 'synced')) {
-          ctx.print('Usage: /settingssync resolve <config-key> <local|synced>');
+          ctx.print('Usage: /settings-sync resolve <config-key> <local|synced>');
           return;
         }
         const changed = resolveSettingsSyncConflict(ctx.platform.configManager, key, resolution);
@@ -102,7 +102,7 @@ export function registerSettingsSyncRuntimeCommands(registry: CommandRegistry):
       if (sub === 'export' || sub === 'push') {
         const pathArg = args[1];
         if (!pathArg) {
-          ctx.print(`Usage: /settingssync ${sub} <path>`);
+          ctx.print(`Usage: /settings-sync ${sub} <path>`);
           return;
         }
         const targetPath = shellPaths.resolveWorkspacePath(pathArg);
@@ -122,7 +122,7 @@ export function registerSettingsSyncRuntimeCommands(registry: CommandRegistry):
       if (sub === 'inspect') {
         const pathArg = args[1];
         if (!pathArg) {
-          ctx.print('Usage: /settingssync inspect <path>');
+          ctx.print('Usage: /settings-sync inspect <path>');
           return;
         }
         const sourcePath = shellPaths.resolveWorkspacePath(pathArg);
@@ -133,7 +133,7 @@ export function registerSettingsSyncRuntimeCommands(registry: CommandRegistry):
       if (sub === 'pull') {
         const pathArg = args[1];
         if (!pathArg) {
-          ctx.print('Usage: /settingssync pull <path>');
+          ctx.print('Usage: /settings-sync pull <path>');
           return;
         }
         const sourcePath = shellPaths.resolveWorkspacePath(pathArg);
@@ -152,7 +152,7 @@ export function registerSettingsSyncRuntimeCommands(registry: CommandRegistry):
         const source = args[2];
         const reason = args.slice(3).join(' ').trim();
         if (!key || !source || !reason || !CONFIG_KEYS.has(key)) {
-          ctx.print('Usage: /settingssync lock <config-key> <source> <reason...>');
+          ctx.print('Usage: /settings-sync lock <config-key> <source> <reason...>');
           return;
         }
         setManagedSettingLock(key, source, reason, controlPlaneConfigDir);
@@ -162,7 +162,7 @@ export function registerSettingsSyncRuntimeCommands(registry: CommandRegistry):
       if (sub === 'unlock') {
         const key = args[1] as ConfigKey | undefined;
         if (!key || !CONFIG_KEYS.has(key)) {
-          ctx.print('Usage: /settingssync unlock <config-key>');
+          ctx.print('Usage: /settings-sync unlock <config-key>');
           return;
         }
         ctx.print(clearManagedSettingLock(key, controlPlaneConfigDir) ? `Managed lock cleared for ${key}.` : `No managed lock found for ${key}.`);

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

@@ -17,7 +17,7 @@ import {
   resolveGithubToken,
 } from '../../export/gist-uploader.ts';
 import { copyToClipboard } from '../../utils/clipboard.ts';
-import { openBrowser } from '../../cli/management.ts';
+import { openBrowser } from '../../utils/browser.ts';
 
 export function registerShareRuntimeCommands(registry: CommandRegistry): void {
   registry.register({

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

@@ -3,7 +3,9 @@ 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 { compactConversation, requireKeybindingsManager, requireProviderApi, requireSessionMemoryStore } from './runtime-services.ts';
+import { buildCompactionPreview, buildCompactionAfterNotice, buildPinUsageText, buildPinSuccessText } from '../../renderer/compaction-preview.ts';
+import { buildCompactionHistoryText } from '../../renderer/compaction-history-modal.ts';
 import { summarizeError } from '@pellux/goodvibes-sdk/platform/utils';
 import { logger } from '@pellux/goodvibes-sdk/platform/utils';
 
@@ -13,7 +15,7 @@ export function registerShellCoreCommands(registry: CommandRegistry): void {
     aliases: ['m'],
     description: 'Select or display the current LLM model',
     usage: '[model-id]',
-    argsHint: '[name]',
+    argsHint: '[model-id]',
     async handler(args, ctx) {
       const providerApi = requireProviderApi(ctx);
       if (args.length === 0) {
@@ -204,9 +206,57 @@ export function registerShellCoreCommands(registry: CommandRegistry): void {
     aliases: [],
     description: 'Summarize conversation to free context window',
     async handler(_args, ctx) {
-      ctx.print('Compacting conversation...');
-      await compactConversation(ctx);
-      ctx.print('Conversation compacted.');
+      const messages = ctx.session.conversationManager.getMessagesForLLM();
+      // contextWindow is not on CommandContext; preview shows message/token counts
+      // without the capacity-% clause (still honest; no fabricated value).
+      const contextWindow = 0;
+      const memStore = ctx.session.sessionMemoryStore;
+      const pinnedMemoryCount = memStore ? memStore.list().length : 0;
+      // Pre-compact preview: honest estimate, clearly labelled.
+      const preview = buildCompactionPreview({ messages, contextWindow, pinnedMemoryCount, trigger: 'manual' });
+      ctx.print(preview);
+      const event = await compactConversation(ctx);
+      if (event) {
+        // Post-compact notice: uses real CompactionEvent figures.
+        ctx.print(buildCompactionAfterNotice({ event, pinnedMemoryCount }));
+      } else {
+        ctx.print('[Context] Compact complete.');
+      }
+      ctx.renderRequest();
+    },
+  });
+
+  registry.register({
+    name: 'compact-history',
+    aliases: ['compaction-history'],
+    description: 'Show compaction history for this session',
+    handler(_args, ctx) {
+      ctx.print(buildCompactionHistoryText());
+      ctx.renderRequest();
+    },
+  });
+
+  registry.register({
+    name: 'keep',
+    aliases: [],
+    description: 'Pin text to session memory (survives compaction)',
+    usage: '<text>',
+    argsHint: '<text to preserve>',
+    handler(args, ctx) {
+      const text = args.join(' ').trim();
+      if (!text) {
+        ctx.print(buildPinUsageText());
+        ctx.renderRequest();
+        return;
+      }
+      const memStore = requireSessionMemoryStore(ctx);
+      const id = memStore.add(text);
+      if (!id) {
+        ctx.print('[Pin] Nothing pinned — text was blank.');
+      } else {
+        const count = memStore.list().length;
+        ctx.print(buildPinSuccessText(id, text, count));
+      }
       ctx.renderRequest();
     },
   });
@@ -244,7 +294,7 @@ export function registerShellCoreCommands(registry: CommandRegistry): void {
     aliases: ['e'],
     description: 'Show or set reasoning effort level',
     usage: '[level]',
-    argsHint: '<instant|low|medium|high>',
+    argsHint: '[instant|low|medium|high]',
     async handler(args, ctx) {
       const currentModel = await requireProviderApi(ctx).getCurrentModel();
       const validLevels = currentModel.reasoningEffort ?? [];

package/src/input/commands/work-plan-runtime.ts

@@ -37,7 +37,7 @@ function openPanel(ctx: import('../command-registry.ts').CommandContext): void {
 
 function formatList(store: WorkPlanStore): string {
   const items = store.listItems();
-  if (items.length === 0) return 'Work plan is empty. Add one with /workplan add <title>.';
+  if (items.length === 0) return 'Work plan is empty. Add one with /work-plan add <title>.';
   return [
     `Work Plan (${items.length})`,
     ...items.map((item) => {
@@ -78,8 +78,8 @@ function parseAddArgs(args: string[]): { title: string; owner?: string; source?:
 
 export function registerWorkPlanRuntimeCommands(registry: CommandRegistry): void {
   registry.register({
-    name: 'workplan',
-    aliases: ['wp', 'todo'],
+    name: 'work-plan',
+    aliases: ['wp', 'todo', 'workplan'],
     description: 'Track a persistent workspace-scoped work plan',
     usage: '[panel|list|show|add <title> [--owner name] [--source label] [--notes text]|done <id>|start <id>|block <id>|fail <id>|cancel <id>|pending <id>|remove <id>|clear-done]',
     argsHint: '[panel|add|list|done]',
@@ -107,7 +107,7 @@ export function registerWorkPlanRuntimeCommands(registry: CommandRegistry): void
         if (subcommand === 'add') {
           const parsed = parseAddArgs(args.slice(1));
           if (!parsed.title) {
-            ctx.print('Usage: /workplan add <title> [--owner name] [--source label] [--notes text]');
+            ctx.print('Usage: /work-plan add <title> [--owner name] [--source label] [--notes text]');
             return;
           }
           const addOptions = {
@@ -123,7 +123,7 @@ export function registerWorkPlanRuntimeCommands(registry: CommandRegistry): void
         if (subcommand === 'remove' || subcommand === 'delete' || subcommand === 'rm') {
           const id = args[1];
           if (!id) {
-            ctx.print(`Usage: /workplan ${subcommand} <id>`);
+            ctx.print(`Usage: /work-plan ${subcommand} <id>`);
             return;
           }
           const item = store.removeItem(id);
@@ -138,7 +138,7 @@ export function registerWorkPlanRuntimeCommands(registry: CommandRegistry): void
         if (subcommand === 'cycle' || subcommand === 'toggle') {
           const id = args[1];
           if (!id) {
-            ctx.print(`Usage: /workplan ${subcommand} <id>`);
+            ctx.print(`Usage: /work-plan ${subcommand} <id>`);
             return;
           }
           const item = store.cycleItemStatus(id);
@@ -149,7 +149,7 @@ export function registerWorkPlanRuntimeCommands(registry: CommandRegistry): void
         if (status) {
           const id = args[1];
           if (!id) {
-            ctx.print(`Usage: /workplan ${subcommand} <id>`);
+            ctx.print(`Usage: /work-plan ${subcommand} <id>`);
             return;
           }
           const item = store.setItemStatus(id, status);
@@ -157,7 +157,7 @@ export function registerWorkPlanRuntimeCommands(registry: CommandRegistry): void
           return;
         }
         if (WORK_PLAN_STATUSES.includes(subcommand as WorkPlanItemStatus)) {
-          ctx.print(`Usage: /workplan ${subcommand} <id>`);
+          ctx.print(`Usage: /work-plan ${subcommand} <id>`);
           return;
         }
         ctx.print(`Unknown workplan subcommand: ${subcommand}`);

package/src/input/commands.ts

@@ -18,6 +18,7 @@ import { registerGitRuntimeCommands } from './commands/git-runtime.ts';
 import { registerNotifyRuntimeCommands } from './commands/notify-runtime.ts';
 import { registerReplayRuntimeCommands } from './commands/replay-runtime.ts';
 import { registerShareRuntimeCommands } from './commands/share-runtime.ts';
+import { registerChannelRuntimeCommands } from './commands/channel-runtime.ts';
 import { registerLocalSetupCommands } from './commands/local-setup.ts';
 import { registerProductRuntimeCommands } from './commands/product-runtime.ts';
 import { registerPlatformRuntimeCommands } from './commands/platform-runtime.ts';
@@ -70,6 +71,7 @@ export function registerBuiltinCommands(registry: CommandRegistry): void {
   registerNotifyRuntimeCommands(registry);
   registerReplayRuntimeCommands(registry);
   registerShareRuntimeCommands(registry);
+  registerChannelRuntimeCommands(registry);
   registerLocalSetupCommands(registry);
   registerProductRuntimeCommands(registry);
   registerPlatformRuntimeCommands(registry);

package/src/input/feed-context-factory.ts

@@ -38,6 +38,7 @@ import type { Panel } from '../panels/types.ts';
 import type { PanelManager } from '../panels/panel-manager.ts';
 import type { KeybindingsManager } from './keybindings.ts';
 import type { ModelPickerTarget } from './model-picker.ts';
+import type { KillRing } from './kill-ring.ts';
 import type { PanelMouseLayout } from './handler-feed-routes.ts';
 
 /**
@@ -124,6 +125,7 @@ export interface FeedContextStableRefs {
   conversationManager: ConversationManager | null;
   panelManager: PanelManager;
   keybindingsManager: KeybindingsManager;
+  killRing: KillRing;
   getHistory: () => InfiniteBuffer;
   getViewportHeight: () => number;
   getScrollTop: () => number;
@@ -145,6 +147,10 @@ export interface FeedContextClosures {
   handleRedo: () => void;
   handlePaste: () => void;
   saveUndoState: () => void;
+  /** Save undo state with text-insertion coalescing (burst typing merges into one group). */
+  saveUndoStateForText: () => void;
+  /** Break the current coalescing group (call on cursor moves). */
+  breakUndoCoalesce: () => void;
   ensureInputCursorVisible: (contentWidth?: number) => void;
   registerPaste: (content: string) => string;
   executeBlockAction: (id: string) => void;