@pellux/goodvibes-agent 1.1.7 → 1.3.0

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

@@ -1,8 +1,9 @@
 import type { ModelPickerTarget } from './model-picker.ts';
-import type { AgentWorkspaceChannelStatus } from './agent-workspace-channels.ts';
+import type { AgentWorkspaceChannelSetupGuide, AgentWorkspaceChannelStatus } from './agent-workspace-channels.ts';
 import type { AgentWorkspaceSetupChecklistItem } from './agent-workspace-setup.ts';
 import type { AgentWorkspaceVoiceMediaReadiness } from './agent-workspace-voice-media.ts';
 import type { AgentBehaviorDiscoverySnapshot } from '../agent/behavior-discovery-summary.ts';
+import type { AgentSetupWizard } from '../agent/setup-wizard.ts';
 
 export const AGENT_WORKSPACE_MODAL_NAME = 'agentWorkspace';
 
@@ -19,7 +20,9 @@ export const AGENT_WORKSPACE_CATEGORY_IDS = [
   'onboarding-voice-media',
   'onboarding-context',
   'onboarding-automation',
+  'personal-ops',
   'research',
+  'documents',
   'artifacts',
   'conversation',
   'channels',
@@ -41,7 +44,8 @@ export const AGENT_WORKSPACE_CATEGORY_IDS = [
 
 export type AgentWorkspaceCategoryId = (typeof AGENT_WORKSPACE_CATEGORY_IDS)[number];
 
-export type AgentWorkspaceActionKind = 'command' | 'guidance' | 'workspace' | 'editor' | 'setting' | 'settings-import' | 'model-picker' | 'settings-modal' | 'local-selection' | 'local-operation' | 'onboarding-complete';
+export type AgentWorkspaceActionKind = 'command' | 'guidance' | 'workspace' | 'editor' | 'setting' | 'settings-import' | 'setup-checkpoint' | 'model-picker' | 'settings-modal' | 'local-selection' | 'local-operation' | 'onboarding-complete';
+export type AgentWorkspaceSetupCheckpointOperation = 'show' | 'mark-current' | 'clear';
 
 export type AgentWorkspaceLocalEditorKind = 'memory' | 'note' | 'persona' | 'skill' | 'routine' | 'profile';
 
@@ -49,6 +53,9 @@ export type AgentWorkspaceEditorKind =
   | AgentWorkspaceLocalEditorKind
   | 'web-research'
   | 'web-fetch'
+  | 'research-run'
+  | 'research-source'
+  | 'research-report'
   | 'knowledge-url'
   | 'knowledge-urls'
   | 'knowledge-file'
@@ -66,6 +73,23 @@ export type AgentWorkspaceEditorKind =
   | 'knowledge-consolidate'
   | 'knowledge-packet'
   | 'knowledge-explain'
+  | 'document-browse'
+  | 'document-show'
+  | 'document-create'
+  | 'document-update'
+  | 'document-review'
+  | 'document-comment'
+  | 'document-resolve-comment'
+  | 'document-suggest'
+  | 'document-accept-suggestion'
+  | 'document-reject-suggestion'
+  | 'document-insert-artifact'
+  | 'document-attach-artifact'
+  | 'document-export'
+  | 'document-reviewer-readiness'
+  | 'document-review-packet-wizard'
+  | 'document-review-packet-preset'
+  | 'document-review-packet-preset-refresh'
   | 'memory-search'
   | 'memory-get'
   | 'memory-explain'
@@ -98,7 +122,21 @@ export type AgentWorkspaceEditorKind =
   | 'secret-delete'
   | 'tts-prompt'
   | 'image-input'
+  | 'artifact-browser'
+  | 'artifact-show'
+  | 'artifact-export-file'
+  | 'artifact-export-package'
+  | 'artifact-promote-knowledge'
   | 'media-generate'
+  | 'model-compare'
+  | 'local-model-benchmark'
+  | 'model-compare-review'
+  | 'model-compare-handoff-diff'
+  | 'model-compare-judge'
+  | 'model-compare-apply'
+  | 'model-compare-route-decision'
+  | 'model-compare-export'
+  | 'model-compare-analytics'
   | 'skill-bundle'
   | 'skill-bundle-search'
   | 'skill-bundle-show'
@@ -155,6 +193,7 @@ export type AgentWorkspaceEditorKind =
   | 'channel-doctor'
   | 'channel-setup'
   | 'channel-send'
+  | 'document-review-packet-share'
   | 'session-save'
   | 'session-load'
   | 'session-rename'
@@ -183,6 +222,7 @@ export type AgentWorkspaceEditorKind =
   | 'automation-run-cancel'
   | 'automation-run-retry'
   | 'schedule-run'
+  | 'schedule-edit'
   | 'routine-receipt'
   | 'schedule-receipt'
   | 'mode-preset'
@@ -262,6 +302,7 @@ export interface AgentWorkspaceAction {
   readonly modelPickerTarget?: ModelPickerTarget;
   readonly modelPickerFlow?: 'providerModel' | 'model';
   readonly settingsTarget?: string;
+  readonly setupCheckpointOperation?: AgentWorkspaceSetupCheckpointOperation;
   readonly visibleWhenSettingKey?: string;
   readonly visibleWhenSettingValue?: string | boolean | number;
   readonly localKind?: AgentWorkspaceLocalEditorKind;
@@ -319,6 +360,121 @@ export interface AgentWorkspaceLocalLibraryItem {
   readonly startCount?: number;
 }
 
+export interface AgentWorkspaceRecentReviewerHandoffArtifact {
+  readonly id: string;
+  readonly filename: string;
+  readonly createdAt: number;
+  readonly handoffId: string;
+  readonly comparisonId: string;
+  readonly sourceArtifactId: string;
+  readonly sourceKind: string;
+  readonly relatedArtifactCount: number;
+}
+
+export interface AgentWorkspaceReviewerReadinessBadge {
+  readonly status: 'ready' | 'attention' | 'needs-setup';
+  readonly summary: string;
+  readonly next: string;
+  readonly issueCount: number;
+  readonly openComments: number;
+  readonly proposedSuggestions: number;
+  readonly missingSourceArtifacts: number;
+  readonly unrevealedComparisons: number;
+  readonly hiddenJudgments: number;
+  readonly revealedJudgments: number;
+  readonly handoffsMissingRelatedArtifacts: number;
+}
+
+export type AgentWorkspaceReviewPacketTimelineEventKind =
+  | 'document'
+  | 'comment'
+  | 'suggestion'
+  | 'attachment'
+  | 'document-export'
+  | 'compare'
+  | 'compare-export'
+  | 'judgment'
+  | 'route-decision'
+  | 'packet-preset'
+  | 'handoff'
+  | 'handoff-archive';
+
+export interface AgentWorkspaceReviewPacketTimelineEvent {
+  readonly id: string;
+  readonly kind: AgentWorkspaceReviewPacketTimelineEventKind;
+  readonly at: number;
+  readonly label: string;
+  readonly detail: string;
+  readonly status: 'ready' | 'attention' | 'complete' | 'info';
+  readonly route: string;
+  readonly sourceId: string;
+}
+
+export interface AgentWorkspaceReviewPacketTimeline {
+  readonly available: boolean;
+  readonly count: number;
+  readonly next: string;
+  readonly items: readonly AgentWorkspaceReviewPacketTimelineEvent[];
+}
+
+export interface AgentWorkspaceReviewPacketPresetLineage {
+  readonly artifactId: string;
+  readonly presetId: string | null;
+  readonly name: string | null;
+  readonly refreshed: boolean;
+  readonly refreshedFromArtifactId: string | null;
+  readonly refreshedFromPresetId: string | null;
+  readonly freshnessMissingCount: number | null;
+  readonly freshnessSupersededCount: number | null;
+  readonly freshnessUnresolvedCount: number | null;
+  readonly summary: string;
+  readonly inspectRoute: string;
+}
+
+export interface AgentWorkspaceReviewPacketDefaults {
+  readonly documentId: string | null;
+  readonly documentTitle: string | null;
+  readonly documentExportArtifactId: string | null;
+  readonly comparisonArtifactId: string | null;
+  readonly judgmentArtifactId: string | null;
+  readonly revealedJudgmentArtifactId: string | null;
+  readonly routeDecisionArtifactId: string | null;
+  readonly routeDecision: string | null;
+  readonly handoffArtifactId: string | null;
+  readonly handoffArchiveArtifactId: string | null;
+  readonly reviewPacketPresetArtifactId: string | null;
+  readonly reviewPacketPresetName: string | null;
+  readonly reviewPacketPresetLineage: AgentWorkspaceReviewPacketPresetLineage | null;
+  readonly relatedArtifactIds: readonly string[];
+  readonly summary: string;
+}
+
+export type AgentWorkspaceReviewPacketWizardStepStatus = 'done' | 'current' | 'pending' | 'blocked';
+
+export interface AgentWorkspaceReviewPacketWizardStep {
+  readonly id: string;
+  readonly label: string;
+  readonly status: AgentWorkspaceReviewPacketWizardStepStatus;
+  readonly detail: string;
+  readonly userRoute: string;
+  readonly modelRoute: string;
+  readonly actionId: string;
+  readonly backtrackRoute: string | null;
+}
+
+export interface AgentWorkspaceReviewPacketWizard {
+  readonly available: boolean;
+  readonly status: 'complete' | 'active' | 'blocked' | 'empty';
+  readonly completedSteps: number;
+  readonly totalSteps: number;
+  readonly currentStepId: string | null;
+  readonly currentStepLabel: string | null;
+  readonly next: string;
+  readonly finalReview: string;
+  readonly presetLineage: AgentWorkspaceReviewPacketPresetLineage | null;
+  readonly steps: readonly AgentWorkspaceReviewPacketWizardStep[];
+}
+
 export interface AgentWorkspaceRuntimeProfileItem {
   readonly id: string;
   readonly homeDirectory: string;
@@ -348,6 +504,109 @@ export interface AgentWorkspaceRoutineScheduleReceiptSummary {
   readonly createdAt: string;
 }
 
+export interface AgentWorkspaceResearchRunSummary {
+  readonly id: string;
+  readonly title: string;
+  readonly status: string;
+  readonly phase: string;
+  readonly progress: number;
+  readonly sourceIds: readonly string[];
+  readonly nextSteps: readonly string[];
+  readonly checkpointCount: number;
+  readonly logTail: readonly string[];
+  readonly updatedAt: string;
+  readonly note?: string;
+  readonly reportArtifactId?: string;
+}
+
+export interface AgentWorkspaceResearchContractSummary {
+  readonly status: string;
+  readonly label: string;
+  readonly next: string;
+  readonly route: string;
+  readonly details: readonly string[];
+}
+
+export interface AgentWorkspaceVibeSummary {
+  readonly status: 'ready' | 'attention' | 'needs-setup' | 'unavailable';
+  readonly applied: number;
+  readonly blocked: number;
+  readonly truncated: number;
+  readonly projectInitPath: string | null;
+  readonly globalInitPath: string | null;
+  readonly statusRoute: '/vibe status';
+  readonly initProjectRoute: '/vibe init';
+  readonly initGlobalRoute: '/vibe init --global';
+  readonly next: string;
+}
+
+export interface AgentWorkspaceProjectContextSummary {
+  readonly status: 'ready' | 'attention' | 'needs-setup' | 'unavailable';
+  readonly loaded: number;
+  readonly blocked: number;
+  readonly truncated: number;
+  readonly supportedSources: readonly string[];
+  readonly targetAware: boolean;
+  readonly catalogRoute: 'context action:"files"';
+  readonly inspectRoute: 'context action:"file"';
+  readonly next: string;
+}
+
+export interface AgentWorkspacePromptContextReceiptSummary {
+  readonly receiptId: string;
+  readonly turnId: string | null;
+  readonly source: string;
+  readonly provider: string;
+  readonly model: string;
+  readonly createdAt: number;
+  readonly activeRecords: number;
+  readonly suppressedRecords: number;
+  readonly segmentCount: number;
+  readonly approxPromptTokens: number;
+  readonly outcomeStatus: 'completed' | 'error' | 'cancelled' | 'pending';
+  readonly stopReason: string | null;
+  readonly completedAt: number | null;
+  readonly detail: string | null;
+  readonly inspectRoute: string;
+  readonly outcomeFilterRoute: string;
+}
+
+export interface AgentWorkspacePromptContextReceiptTimeline {
+  readonly status: 'ready' | 'empty' | 'unavailable';
+  readonly count: number;
+  readonly latestReceiptId: string | null;
+  readonly latestTurnId: string | null;
+  readonly completedCount: number;
+  readonly errorCount: number;
+  readonly cancelledCount: number;
+  readonly pendingCount: number;
+  readonly inspectRoute: 'context action:"prompt" includeParameters:true';
+  readonly filterRoutes: {
+    readonly completed: string;
+    readonly error: string;
+    readonly cancelled: string;
+    readonly pending: string;
+  };
+  readonly next: string;
+  readonly items: readonly AgentWorkspacePromptContextReceiptSummary[];
+}
+
+export interface AgentWorkspaceProcessSupervisionSummary {
+  readonly status: 'available' | 'unavailable';
+  readonly tracked: number;
+  readonly running: number;
+  readonly completed: number;
+  readonly stdinWriteStatus: 'supported-with-confirmation' | 'not-yet-supported';
+  readonly stdinMethod: string | null;
+  readonly ptyStatus: 'contract-discovered' | 'not-yet-supported';
+  readonly ptyMethod: string | null;
+  readonly sudoStatus: 'foreground-only';
+  readonly processRoute: string;
+  readonly capabilitiesRoute: string;
+  readonly visibleMonitorRoute: string;
+  readonly liveTailRoute: string;
+}
+
 export interface AgentWorkspaceCompanionAccessSummary {
   readonly surface: 'goodvibes-agent';
   readonly hostUrl: string;
@@ -417,6 +676,30 @@ export interface AgentWorkspaceRuntimeSnapshot {
   readonly localNoteCount: number;
   readonly localNoteReviewQueueCount: number;
   readonly localNotes: readonly AgentWorkspaceLocalLibraryItem[];
+  readonly researchSourceCount: number;
+  readonly researchSourceCandidateCount: number;
+  readonly researchSourceReviewedCount: number;
+  readonly researchSourceRejectedCount: number;
+  readonly researchSourceUsedCount: number;
+  readonly researchRunCount: number;
+  readonly researchRunPlannedCount: number;
+  readonly researchRunRunningCount: number;
+  readonly researchRunPausedCount: number;
+  readonly researchRunBlockedCount: number;
+  readonly researchRunTerminalCount: number;
+  readonly researchRuns: readonly AgentWorkspaceResearchRunSummary[];
+  readonly researchBrowserRunnerContract: AgentWorkspaceResearchContractSummary;
+  readonly researchVisualReportContract: AgentWorkspaceResearchContractSummary;
+  readonly vibe: AgentWorkspaceVibeSummary;
+  readonly projectContext: AgentWorkspaceProjectContextSummary;
+  readonly promptContextReceipts: AgentWorkspacePromptContextReceiptTimeline;
+  readonly processSupervision: AgentWorkspaceProcessSupervisionSummary;
+  readonly recentReviewerHandoffArtifactCount: number;
+  readonly recentReviewerHandoffArtifacts: readonly AgentWorkspaceRecentReviewerHandoffArtifact[];
+  readonly reviewerReadinessBadge: AgentWorkspaceReviewerReadinessBadge;
+  readonly reviewPacketTimeline: AgentWorkspaceReviewPacketTimeline;
+  readonly reviewPacketDefaults: AgentWorkspaceReviewPacketDefaults;
+  readonly reviewPacketWizard: AgentWorkspaceReviewPacketWizard;
   readonly localRoutineCount: number;
   readonly enabledRoutineCount: number;
   readonly localRoutines: readonly AgentWorkspaceLocalLibraryItem[];
@@ -441,6 +724,7 @@ export interface AgentWorkspaceRuntimeSnapshot {
   readonly delegatedReviewPolicy: 'explicit-build-delegation-only';
   readonly companionAccess: AgentWorkspaceCompanionAccessSummary;
   readonly channels: readonly AgentWorkspaceChannelStatus[];
+  readonly channelSetupGuide: AgentWorkspaceChannelSetupGuide;
   readonly voiceProviderCount: number;
   readonly voiceStreamingProviderCount: number;
   readonly voiceSttProviderCount: number;
@@ -470,5 +754,6 @@ export interface AgentWorkspaceRuntimeSnapshot {
   readonly localStarterTemplateCount: number;
   readonly runtimeStarterTemplates: readonly AgentWorkspaceRuntimeStarterTemplateItem[];
   readonly setupChecklist: readonly AgentWorkspaceSetupChecklistItem[];
+  readonly setupWizard: AgentSetupWizard;
   readonly warnings: readonly string[];
 }

package/src/input/agent-workspace.ts

@@ -18,7 +18,8 @@ import { applyAgentWorkspaceLocalLibraryOperation } from './agent-workspace-loca
 import { deleteAgentWorkspaceMemoryEditor, submitAgentWorkspaceMemoryEditor } from './agent-workspace-memory-editor.ts';
 import { jumpAgentWorkspaceSelection, moveAgentWorkspaceSelection, selectAgentWorkspaceCategory } from './agent-workspace-navigation.ts';
 import { appendAgentWorkspaceActionSearchText, backspaceAgentWorkspaceActionSearch, beginAgentWorkspaceActionSearch, clearAgentWorkspaceActionSearch, commitAgentWorkspaceActionSearchSelection, searchAgentWorkspaceActions } from './agent-workspace-search.ts';
-import { agentWorkspaceSettingSchema, applyAgentWorkspaceSettingValue, buildAgentWorkspaceSettingActionEffect, importAgentWorkspaceTuiSettings, isAgentWorkspaceActionVisible } from './agent-workspace-settings.ts';
+import { applyAgentWorkspaceSetupCheckpointAction } from './agent-workspace-setup-checkpoint-action.ts';
+import { agentWorkspaceSettingSchema, applyAgentWorkspaceSettingValue, buildAgentWorkspaceSettingActionEffect, buildAgentWorkspaceSettingActionPreview, importAgentWorkspaceTuiSettings, isAgentWorkspaceActionVisible } from './agent-workspace-settings.ts';
 import { buildAgentWorkspaceRuntimeSnapshot } from './agent-workspace-snapshot.ts';
 import { submitAgentWorkspaceSubscriptionLoginFinishEditor, submitAgentWorkspaceSubscriptionLoginStartEditor, submitAgentWorkspaceSubscriptionLogoutEditor } from './agent-workspace-subscription-editor.ts';
 import type { AgentWorkspaceAction, AgentWorkspaceActionResult, AgentWorkspaceActionSearchResult, AgentWorkspaceCategory, AgentWorkspaceCommandDispatcher, AgentWorkspaceEditorField, AgentWorkspaceFocusPane, AgentWorkspaceLocalEditor, AgentWorkspaceLocalEditorKind, AgentWorkspaceLocalLibraryItem, AgentWorkspaceLocalOperation, AgentWorkspacePromptDispatcher, AgentWorkspaceRuntimeSnapshot } from './agent-workspace-types.ts';
@@ -141,6 +142,10 @@ export class AgentWorkspace {
     return selectedAgentWorkspaceLocalLibraryItem(this.runtimeSnapshot, this.selectedLibraryItemIndexes, kind);
   }
 
+  settingActionPreview(action: AgentWorkspaceAction): string | null {
+    return buildAgentWorkspaceSettingActionPreview(this.context, action);
+  }
+
   focusCategories(): void {
     this.focusPane = 'categories';
   }
@@ -402,6 +407,23 @@ export class AgentWorkspace {
     void this.importTuiSettingsAsync(requestRender);
   }
 
+  applySetupCheckpointAction(action: AgentWorkspaceAction, requestRender?: () => void): void {
+    applyAgentWorkspaceSetupCheckpointAction({
+      context: this.context,
+      runtimeSnapshot: this.runtimeSnapshot,
+      setRuntimeSnapshot: (snapshot) => {
+        this.runtimeSnapshot = snapshot;
+      },
+      setStatus: (status) => {
+        this.status = status;
+      },
+      setLastActionResult: (result) => {
+        this.lastActionResult = result;
+      },
+      clampSelection: () => this.clampSelection(),
+    }, action, requestRender);
+  }
+
   private selectedItemForOperation(operation: AgentWorkspaceLocalOperation): AgentWorkspaceLocalLibraryItem | null {
     if (operation.startsWith('memory-')) return this.selectedLocalLibraryItem('memory');
     if (operation.startsWith('note-')) return this.selectedLocalLibraryItem('note');

package/src/input/command-registry.ts

@@ -4,6 +4,7 @@ import type { ConversationManager } from '../core/conversation';
 import type { ConfigManager } from '../config/index.ts';
 import type { DeepReadonly, GoodVibesConfig } from '../config/index.ts';
 import type { ToolRegistry } from '@pellux/goodvibes-sdk/platform/tools';
+import type { ProcessManager } from '@pellux/goodvibes-sdk/platform/tools';
 import type { PermissionRequestHandler } from '@pellux/goodvibes-sdk/platform/permissions';
 import type { SelectionItem, SelectionResult, SelectionAction } from './selection-modal.ts';
 import type { FileUndoManager } from '@pellux/goodvibes-sdk/platform/state';
@@ -17,10 +18,12 @@ import type { OpsApi } from '@/runtime/index.ts';
 import type { OperatorClient } from '@/runtime/index.ts';
 import type { PeerClient } from '@/runtime/index.ts';
 import type { DirectTransport } from '@/runtime/index.ts';
+import type { AgentPromptContextReceiptStore } from '../agent/prompt-context-receipts.ts';
 import type { VoiceProviderRegistry, VoiceService } from '@pellux/goodvibes-sdk/platform/voice';
 import type { MediaProviderRegistry } from '@pellux/goodvibes-sdk/platform/media';
 import type { ArtifactStore } from '@pellux/goodvibes-sdk/platform/artifacts';
 import type { ChannelDeliveryRouter } from '@pellux/goodvibes-sdk/platform/channels';
+import type { AgentExecutionLedger } from '../runtime/execution-ledger.ts';
 import type {
   CommandWorkspaceShellServices,
 } from '@/runtime/index.ts';
@@ -157,6 +160,7 @@ export interface CommandWorkspaceUiServices {
   keybindingsManager?: KeybindingsManager;
   fileUndoManager?: FileUndoManager;
   panelManager?: PanelManager;
+  processManager?: ProcessManager;
   profileManager?: import('@pellux/goodvibes-sdk/platform/profiles').ProfileManager;
   bookmarkManager?: import('@pellux/goodvibes-sdk/platform/bookmarks').BookmarkManager;
   projectPlanningService?: import('@pellux/goodvibes-sdk/platform/knowledge').ProjectPlanningService;
@@ -174,7 +178,7 @@ export interface CommandPlatformConfigServices {
   readonly voiceProviderRegistry?: VoiceProviderRegistry;
   readonly voiceService?: VoiceService;
   readonly mediaProviderRegistry?: MediaProviderRegistry;
-  readonly artifactStore?: Pick<ArtifactStore, 'create'>;
+  readonly artifactStore?: Pick<ArtifactStore, 'create'> & Partial<Pick<ArtifactStore, 'get' | 'list' | 'readContent'>>;
   readonly channelDeliveryRouter?: Pick<ChannelDeliveryRouter, 'deliver' | 'listStrategies'>;
 }
 
@@ -183,7 +187,9 @@ export interface CommandPlatformServices
     CommandPlatformShellServices {}
 
 export interface CommandOpsServices
-  extends CommandOpsShellServices {}
+  extends CommandOpsShellServices {
+  readonly executionLedger?: AgentExecutionLedger;
+}
 
 export interface CommandExtensionRegistryServices {
   readonly toolRegistry: ToolRegistry;
@@ -215,6 +221,7 @@ export interface CommandContext
     readonly peer?: PeerClient;
     readonly providerApi?: ProviderApi;
     readonly agentKnowledgeApi?: KnowledgeApi;
+    readonly promptContextReceipts?: AgentPromptContextReceiptStore;
     readonly hookApi?: HookApi;
     readonly mcpApi?: McpApi;
     readonly opsApi?: OpsApi;

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

@@ -49,7 +49,8 @@ function templateLine(template: AgentRuntimeProfileTemplateSummary): string {
     `    persona ${template.personaName}`,
     `    skills ${template.skillNames.join(', ')}`,
     `    routines ${template.routineNames.join(', ')}`,
-  ].join('\n');
+    template.vibeIncluded ? '    vibe included' : '',
+  ].filter(Boolean).join('\n');
 }
 
 function renderProfiles(homeDirectory: string): string {
@@ -106,7 +107,7 @@ function renderGuide(homeDirectory: string): string {
     '   /agent-profile templates',
     '2. Export a starter JSON file:',
     '   /agent-profile template export research ./agent-starter.json --yes',
-    '3. Edit id, name, description, persona, skills, and routines in that JSON file.',
+    '3. Edit id, name, description, persona, skills, routines, and optional vibe in that JSON file.',
     '4. Import it into this Agent home:',
     '   /agent-profile template import ./agent-starter.json --yes',
     '5. Create an Agent profile from the imported starter:',
@@ -126,9 +127,10 @@ function renderTemplatePreview(homeDirectory: string, templateId: string): strin
     `  persona ${file.template.persona.name}`,
     `  skills ${file.template.skills.map((skill) => skill.name).join(', ')}`,
     `  routines ${file.template.routines.map((routine) => routine.name).join(', ')}`,
+    file.template.vibe ? '  vibe included' : '',
     '',
     'Export/edit/import to customize this starter:',
-    `  /agent-profile template export ${file.template.id} ./agent-starter.json --yes`,
+    `  /agent-profile template export ${file.template.id} ./agent-starter.json --include-vibe --yes`,
   ].join('\n');
 }
 
@@ -242,17 +244,25 @@ export function registerAgentRuntimeProfileRuntimeCommands(registry: CommandRegi
             const templateId = commandArgs[2];
             const pathArg = commandArgs[3];
             if (!templateId || !pathArg) {
-              ctx.print('Usage: /agent-profile template export <id> <path> --yes');
+            ctx.print('Usage: /agent-profile template export <id> <path> [--include-vibe] --yes');
               return;
             }
             if (!parsed.yes) {
-              requireYesFlag(ctx, `export Agent starter template ${templateId}`, '/agent-profile template export <id> <path> --yes');
+              requireYesFlag(ctx, `export Agent starter template ${templateId}`, '/agent-profile template export <id> <path> [--include-vibe] --yes');
               return;
             }
             const targetPath = shellPaths.resolveWorkspacePath(pathArg);
             mkdirSync(dirname(targetPath), { recursive: true });
-            const template = exportAgentRuntimeProfileTemplate(homeDirectory, templateId, targetPath);
-            ctx.print(`Agent starter template exported: ${template.id}\n  path ${template.path ?? targetPath}\n  edit it, then import it with /agent-profile template import <path> --yes`);
+            const template = exportAgentRuntimeProfileTemplate(homeDirectory, templateId, targetPath, {
+              includeVibe: commandArgs.includes('--include-vibe'),
+              shellPaths,
+            });
+            ctx.print([
+              `Agent starter template exported: ${template.id}`,
+              `  path ${template.path ?? targetPath}`,
+              template.vibeIncluded ? '  vibe included' : '',
+              '  edit it, then import it with /agent-profile template import <path> --yes',
+            ].filter(Boolean).join('\n'));
             return;
           }
           if (mode === 'import') {
@@ -273,7 +283,7 @@ export function registerAgentRuntimeProfileRuntimeCommands(registry: CommandRegi
           if (mode === 'from-discovered' || mode === 'import-discovered') {
             const templateId = commandArgs[2];
             if (!templateId) {
-              ctx.print('Usage: /agent-profile template from-discovered <id> [--name <name>] [--description <summary>] [--persona <name>] [--skills all|name,name] [--routines all|name,name] [--replace] --yes');
+              ctx.print('Usage: /agent-profile template from-discovered <id> [--name <name>] [--description <summary>] [--persona <name>] [--skills all|name,name] [--routines all|name,name] [--include-vibe] [--replace] --yes');
               return;
             }
             if (!parsed.yes) {
@@ -287,6 +297,7 @@ export function registerAgentRuntimeProfileRuntimeCommands(registry: CommandRegi
               persona: parseFlag(commandArgs, '--persona'),
               skills: parseCsvFlag(commandArgs, '--skills'),
               routines: parseCsvFlag(commandArgs, '--routines'),
+              includeVibe: commandArgs.includes('--include-vibe'),
               replace: commandArgs.includes('--replace'),
             });
             ctx.print([
@@ -294,11 +305,12 @@ export function registerAgentRuntimeProfileRuntimeCommands(registry: CommandRegi
               `  persona ${template.personaName}`,
               `  skills ${template.skillNames.join(', ')}`,
               `  routines ${template.routineNames.join(', ')}`,
+              template.vibeIncluded ? '  vibe included' : '',
               `  use /agent-profile create <name> --template ${template.id} --yes`,
-            ].join('\n'));
+            ].filter(Boolean).join('\n'));
             return;
           }
-          ctx.print('Usage: /agent-profile template [show <id>|export <id> <path> --yes|import <path> --yes|from-discovered <id> --yes]');
+          ctx.print('Usage: /agent-profile template [show <id>|export <id> <path> [--include-vibe] --yes|import <path> --yes|from-discovered <id> --yes]');
           return;
         }
 
@@ -318,6 +330,7 @@ export function registerAgentRuntimeProfileRuntimeCommands(registry: CommandRegi
             `Agent profile created: ${profile.id}`,
             `  home ${profile.homeDirectory}`,
             profile.starterTemplateId ? `  starter: ${profile.starterTemplateId}` : '',
+            profile.starterTemplateApplication?.vibePath ? `  vibe ${profile.starterTemplateApplication.vibePath}` : '',
             `  launch goodvibes-agent --agent-profile ${profile.id}`,
           ].filter(Boolean).join('\n'));
           return;
@@ -326,7 +339,7 @@ export function registerAgentRuntimeProfileRuntimeCommands(registry: CommandRegi
         if (sub === 'create-from-discovered' || sub === 'create-discovered') {
           const profileName = commandArgs[1];
           if (!profileName) {
-            ctx.print('Usage: /agent-profile create-from-discovered <name> [--template-id <id>] [--profile-name <display>] [--description <summary>] [--persona <name>] [--skills all|name,name] [--routines all|name,name] [--replace] --yes');
+            ctx.print('Usage: /agent-profile create-from-discovered <name> [--template-id <id>] [--profile-name <display>] [--description <summary>] [--persona <name>] [--skills all|name,name] [--routines all|name,name] [--include-vibe] [--replace] --yes');
             return;
           }
           if (!parsed.yes) {
@@ -341,6 +354,7 @@ export function registerAgentRuntimeProfileRuntimeCommands(registry: CommandRegi
             persona: parseFlag(commandArgs, '--persona'),
             skills: parseCsvFlag(commandArgs, '--skills'),
             routines: parseCsvFlag(commandArgs, '--routines'),
+            includeVibe: commandArgs.includes('--include-vibe'),
             replace: commandArgs.includes('--replace'),
           });
           ctx.print([
@@ -350,8 +364,9 @@ export function registerAgentRuntimeProfileRuntimeCommands(registry: CommandRegi
             `  persona ${created.template.personaName}`,
             `  skills ${created.template.skillNames.join(', ')}`,
             `  routines ${created.template.routineNames.join(', ')}`,
+            created.template.vibeIncluded ? '  vibe included' : '',
             `  launch goodvibes-agent --agent-profile ${created.profile.id}`,
-          ].join('\n'));
+          ].filter(Boolean).join('\n'));
           return;
         }
 
@@ -369,7 +384,7 @@ export function registerAgentRuntimeProfileRuntimeCommands(registry: CommandRegi
           return;
         }
 
-        ctx.print('Usage: /agent-profile [list|show <name>|default [<name>|clear] --yes|use <name> --yes|templates|guide|template show <id>|template export <id> <path> --yes|template import <path> --yes|create <name> [--template <id>] --yes|create-from-discovered <name> --yes|delete <name> --yes]');
+        ctx.print('Usage: /agent-profile [list|show <name>|default [<name>|clear] --yes|use <name> --yes|templates|guide|template show <id>|template export <id> <path> [--include-vibe] --yes|template import <path> --yes|create <name> [--template <id>] --yes|create-from-discovered <name> [--include-vibe] --yes|delete <name> --yes]');
       } catch (error) {
         ctx.print([
           'Error',