@pellux/goodvibes-agent 0.1.75 → 0.1.76

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 All notable changes to GoodVibes Agent will be recorded here.
 
+## 0.1.76 - 2026-05-31
+
+- Added optional starter profile creation to first-run onboarding so setup can create an isolated Agent home seeded with persona, skill, and routine templates.
+- Added onboarding apply/verify support for Agent profile creation with prevalidation, rollback, and overwrite protection.
+- Updated onboarding and renderer regressions so the first-run flow stays Agent-specific while exposing the starter profile path directly in the TUI.
+
 ## 0.1.75 - 2026-05-31
 
 - Reworded Agent status, doctor, and external runtime diagnostics away from copied service/surface ownership language.

package/package.json

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

package/src/input/onboarding/onboarding-wizard-apply.ts

@@ -38,6 +38,16 @@ export function buildOnboardingApplyRequest(controller: OnboardingWizardControll
 
     setSecret('OPENAI_API_KEY', controller.getStringFieldValue('providers.openai-api-key', ''));
 
+    const profileName = controller.getStringFieldValue('agent-setup.profile-name', '').trim();
+    if (profileName.length > 0) {
+      const selectedTemplate = controller.getStringFieldValue('agent-setup.profile-template', 'none').trim();
+      operations.push({
+        kind: 'create-agent-profile',
+        name: profileName,
+        ...(selectedTemplate.length > 0 && selectedTemplate !== 'none' ? { templateId: selectedTemplate } : {}),
+      });
+    }
+
     return {
       mode: controller.mode,
       source: 'wizard',

package/src/input/onboarding/onboarding-wizard-steps.ts

@@ -1,7 +1,23 @@
 import { REASONING_OPTIONS, HITL_MODE_OPTIONS, GUIDANCE_MODE_OPTIONS, PERMISSION_MODE_OPTIONS, SECRET_POLICY_OPTIONS } from './onboarding-wizard-constants.ts';
 import { modelSelectionLabel, normalizeText } from './onboarding-wizard-helpers.ts';
+import { listAgentRuntimeProfileTemplates } from '../../agent/runtime-profile.ts';
 import type { OnboardingWizardController } from './onboarding-wizard.ts';
-import type { OnboardingWizardActionFieldDefinition, OnboardingWizardFieldDefinition, OnboardingWizardModelPickerFieldDefinition, OnboardingWizardRadioFieldDefinition, OnboardingWizardStepDefinition } from './onboarding-wizard-types.ts';
+import type { OnboardingWizardActionFieldDefinition, OnboardingWizardFieldDefinition, OnboardingWizardModelPickerFieldDefinition, OnboardingWizardRadioFieldDefinition, OnboardingWizardRadioOption, OnboardingWizardStepDefinition } from './onboarding-wizard-types.ts';
+
+function buildStarterTemplateOptions(): readonly OnboardingWizardRadioOption[] {
+  return [
+    {
+      id: 'none',
+      label: 'No profile',
+      hint: 'Keep using the current Agent home. You can create isolated profiles later from the Agent workspace.',
+    },
+    ...listAgentRuntimeProfileTemplates().map((template): OnboardingWizardRadioOption => ({
+      id: template.id,
+      label: template.name,
+      hint: `${template.description} Includes persona ${template.personaName}, skills ${template.skillNames.join(', ')}, and routines ${template.routineNames.join(', ')}.`,
+    })),
+  ];
+}
 
 export function buildOnboardingWizardSteps(controller: OnboardingWizardController): readonly OnboardingWizardStepDefinition[] {
   if (controller.hydrationPending || controller.hydrationError !== null) return [buildLoadingStep(controller)];
@@ -169,6 +185,7 @@ export function buildAgentSetupStep(controller: OnboardingWizardController): Onb
     summaryTitle: 'Agent setup posture',
     summaryLines: [
       'Agent owns the operator TUI and local behavior registry.',
+      'Optional starter profile: create an isolated Agent home from setup.',
       'GoodVibes runtime lifecycle is external to this product.',
       `Secret policy: ${controller.getStringFieldValue('agent-setup.secret-policy', secretPolicy)}`,
       collectionIssues > 0 ? `${collectionIssues} setup snapshot issue(s)` : 'Setup snapshot collected cleanly',
@@ -198,12 +215,28 @@ export function buildAgentSetupStep(controller: OnboardingWizardController): Onb
         options: SECRET_POLICY_OPTIONS,
         defaultValue: secretPolicy,
       },
+      {
+        kind: 'text',
+        id: 'agent-setup.profile-name',
+        label: 'Create starter profile',
+        hint: 'Optional: enter a new Agent profile name to create an isolated home during setup. Leave blank to keep the current home.',
+        placeholder: 'research-desk',
+        defaultValue: '',
+      },
+      {
+        kind: 'radio',
+        id: 'agent-setup.profile-template',
+        label: 'Starter profile template',
+        hint: 'Choose the persona, skills, and routine bundle to seed into the optional new Agent profile.',
+        options: buildStarterTemplateOptions(),
+        defaultValue: 'none',
+      },
       {
         kind: 'status',
         id: 'agent-setup.profile-guide',
-        label: 'Agent profiles',
-        hint: 'Use /agent-profile guide after setup to create household, research, travel, operations, or custom Agent profiles.',
-        defaultValue: 'Profiles',
+        label: 'Profile guidance',
+        hint: 'Use /agent-profile guide after setup to export, customize, import, and launch Agent profiles.',
+        defaultValue: 'Available',
       },
     ],
   };

package/src/runtime/onboarding/apply.ts

@@ -1,7 +1,12 @@
-import { existsSync, mkdirSync, readFileSync, unlinkSync, writeFileSync } from 'node:fs';
+import { existsSync, mkdirSync, readFileSync, rmSync, unlinkSync, writeFileSync } from 'node:fs';
 import { dirname } from 'node:path';
 import { isSecretRefInput } from '@pellux/goodvibes-sdk/platform/config';
 import { CONFIG_SCHEMA, DEFAULT_CONFIG } from '../../config/index.ts';
+import {
+  createAgentRuntimeProfile,
+  getAgentRuntimeProfileTemplate,
+  resolveAgentRuntimeProfileHome,
+} from '../../agent/runtime-profile.ts';
 import type { FeatureFlagConfigKey } from '../surface-feature-flags.ts';
 import {
   getOnboardingRuntimeStatePath,
@@ -250,6 +255,22 @@ function validateAcknowledgementOperation(
   }
 }
 
+function validateCreateAgentProfileOperation(
+  deps: OnboardingApplyDependencies,
+  operation: Extract<OnboardingApplyOperation, { kind: 'create-agent-profile' }>,
+): void {
+  const name = operation.name.trim();
+  if (name.length === 0) throw new Error('Agent profile name is required.');
+
+  const resolution = resolveAgentRuntimeProfileHome(deps.shellPaths.homeDirectory, name);
+  if (existsSync(resolution.homeDirectory)) {
+    throw new Error(`Agent profile already exists: ${resolution.id}`);
+  }
+
+  const templateId = operation.templateId?.trim();
+  if (templateId) getAgentRuntimeProfileTemplate(templateId, deps.shellPaths.homeDirectory);
+}
+
 function applyConfigOperation(
   deps: OnboardingApplyDependencies,
   operation: Extract<OnboardingApplyOperation, { kind: 'set-config' }>,
@@ -441,6 +462,13 @@ async function buildRollbackAction(
     );
   }
 
+  if (operation.kind === 'create-agent-profile') {
+    const resolution = resolveAgentRuntimeProfileHome(deps.shellPaths.homeDirectory, operation.name);
+    return () => {
+      if (existsSync(resolution.homeDirectory)) rmSync(resolution.homeDirectory, { recursive: true, force: true });
+    };
+  }
+
   const neverOperation: never = operation;
   throw new Error(`Unsupported onboarding operation: ${JSON.stringify(neverOperation)}`);
 }
@@ -465,6 +493,24 @@ function applyAcknowledgementOperation(
   };
 }
 
+function applyCreateAgentProfileOperation(
+  deps: OnboardingApplyDependencies,
+  operation: Extract<OnboardingApplyOperation, { kind: 'create-agent-profile' }>,
+): OnboardingAppliedOperation {
+  validateCreateAgentProfileOperation(deps, operation);
+  const templateId = operation.templateId?.trim();
+  const profile = createAgentRuntimeProfile(deps.shellPaths.homeDirectory, operation.name, {
+    ...(templateId ? { templateId } : {}),
+  });
+
+  return {
+    kind: operation.kind,
+    summary: profile.starterTemplateId
+      ? `Created Agent profile ${profile.id} from ${profile.starterTemplateId}.`
+      : `Created Agent profile ${profile.id}.`,
+  };
+}
+
 function orderApplyOperations(
   operations: readonly OnboardingApplyOperation[],
 ): readonly OnboardingApplyOperation[] {
@@ -476,6 +522,7 @@ function orderApplyOperations(
   const configOperations = operations.filter((operation) => (
     operation.kind === 'set-config' && operation.key !== 'storage.secretPolicy'
   ));
+  const agentProfileOperations = operations.filter((operation) => operation.kind === 'create-agent-profile');
   const finalOperations = operations.filter((operation) => (
     operation.kind === 'acknowledge'
   ));
@@ -485,6 +532,7 @@ function orderApplyOperations(
     ...authOperations,
     ...secretOperations,
     ...configOperations,
+    ...agentProfileOperations,
     ...finalOperations,
   ];
 }
@@ -521,6 +569,11 @@ function prevalidateApplyRequest(
         continue;
       }
 
+      if (operation.kind === 'create-agent-profile') {
+        validateCreateAgentProfileOperation(deps, operation);
+        continue;
+      }
+
       const neverOperation: never = operation;
       throw new Error(`Unsupported onboarding operation: ${JSON.stringify(neverOperation)}`);
     } catch (error) {
@@ -539,6 +592,7 @@ function getVerificationFailureKind(itemId: string): OnboardingApplyOperation['k
   if (itemId.startsWith('secret:')) return 'set-secret';
   if (itemId.startsWith('auth:')) return 'ensure-auth-user';
   if (itemId.startsWith('acknowledge:')) return 'acknowledge';
+  if (itemId.startsWith('agent-profile:')) return 'create-agent-profile';
   return 'set-config';
 }
 
@@ -590,6 +644,12 @@ export async function applyOnboardingRequest(
           continue;
         }
 
+        if (operation.kind === 'create-agent-profile') {
+          applied.push(applyCreateAgentProfileOperation(deps, operation));
+          rollbacks.push(rollback);
+          continue;
+        }
+
         const neverOperation: never = operation;
         throw new Error(`Unsupported onboarding operation: ${JSON.stringify(neverOperation)}`);
       } catch (error) {

package/src/runtime/onboarding/types.ts

@@ -264,6 +264,11 @@ export type OnboardingApplyOperation =
       readonly kind: 'acknowledge';
       readonly target: OnboardingAcknowledgementTarget;
       readonly acknowledged: boolean;
+    }
+  | {
+      readonly kind: 'create-agent-profile';
+      readonly name: string;
+      readonly templateId?: string;
     };
 
 export interface OnboardingApplyRequest {
@@ -358,7 +363,7 @@ export interface OnboardingProviderAccountReadHelper {
 
 export type OnboardingShellPaths = Pick<
   ShellPathService,
-  'workingDirectory' | 'resolveProjectPath' | 'resolveUserPath'
+  'homeDirectory' | 'workingDirectory' | 'resolveProjectPath' | 'resolveUserPath'
 >;
 
 export interface OnboardingSnapshotDependencies {

package/src/runtime/onboarding/verify.ts

@@ -1,4 +1,7 @@
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
 import { isSecretRefInput } from '@pellux/goodvibes-sdk/platform/config';
+import { resolveAgentRuntimeProfileHome } from '../../agent/runtime-profile.ts';
 import { readOnboardingRuntimeState } from './state.ts';
 import type {
   OnboardingApplyOperation,
@@ -147,6 +150,22 @@ function verifyAuthOperation(
   };
 }
 
+function verifyCreateAgentProfileOperation(
+  deps: OnboardingVerificationDependencies,
+  operation: Extract<OnboardingApplyOperation, { kind: 'create-agent-profile' }>,
+): OnboardingVerificationItem {
+  const resolution = resolveAgentRuntimeProfileHome(deps.shellPaths.homeDirectory, operation.name);
+  const ok = existsSync(join(resolution.homeDirectory, 'profile.json'));
+  return {
+    id: `agent-profile:${resolution.id}`,
+    status: ok ? 'pass' : 'fail',
+    message: ok
+      ? `${resolution.id} Agent profile exists.`
+      : `${resolution.id} Agent profile was not created.`,
+    target: resolution.id,
+  };
+}
+
 async function verifyOperation(
   deps: OnboardingVerificationDependencies,
   operation: OnboardingApplyOperation,
@@ -154,7 +173,8 @@ async function verifyOperation(
   if (operation.kind === 'set-config') return verifyConfigOperation(deps, operation);
   if (operation.kind === 'set-secret') return verifySecretOperation(deps, operation);
   if (operation.kind === 'ensure-auth-user') return verifyAuthOperation(deps, operation);
-  return verifyAcknowledgementOperation(deps, operation);
+  if (operation.kind === 'acknowledge') return verifyAcknowledgementOperation(deps, operation);
+  return verifyCreateAgentProfileOperation(deps, operation);
 }
 
 export async function verifyOnboardingRequest(

package/src/version.ts

@@ -6,7 +6,7 @@ import { join } from 'node:path';
 // The prebuild script updates the fallback value before compilation.
 // Uses import.meta.dir (Bun) to locate package.json relative to this file,
 // which is correct regardless of the process working directory.
-let _version = '0.1.75';
+let _version = '0.1.76';
 let _sdkVersion = '0.33.35';
 try {
   const pkg = JSON.parse(readFileSync(join(import.meta.dir, '..', 'package.json'), 'utf-8')) as {