@pellux/goodvibes-agent 1.1.0 → 1.1.1

package/CHANGELOG.md

@@ -2,6 +2,10 @@
 
 Product-facing release notes for GoodVibes Agent.
 
+## 1.1.1 - 2026-06-05
+
+- Fix first-run onboarding so clean launches open the fullscreen setup workspace until the user explicitly chooses Finish -> Apply & close.
+
 ## 1.1.0 - 2026-06-05
 
 - Add a final onboarding Finish category with Apply & close completion that saves the user onboarding marker and keeps future normal launches in the main conversation.

package/dist/package/main.js

@@ -817145,7 +817145,7 @@ var createStyledCell = (char, overrides = {}) => ({
 // src/version.ts
 import { readFileSync } from "fs";
 import { join } from "path";
-var _version = "1.1.0";
+var _version = "1.1.1";
 try {
   const pkg = JSON.parse(readFileSync(join(import.meta.dir, "..", "package.json"), "utf-8"));
   _version = typeof pkg.version === "string" ? pkg.version : _version;
@@ -849851,13 +849851,13 @@ init_state3();
 
 // src/input/commands/recall-shared.ts
 var VALID_CLASSES = ["decision", "constraint", "incident", "pattern", "fact", "risk", "runbook", "architecture", "ownership"];
-var VALID_SCOPES = ["session", "project", "team"];
+var VALID_SCOPES2 = ["session", "project", "team"];
 var VALID_REVIEW_STATES = ["fresh", "reviewed", "stale", "contradicted"];
 function isValidClass(s4) {
   return VALID_CLASSES.includes(s4);
 }
 function isValidScope(s4) {
-  return VALID_SCOPES.includes(s4);
+  return VALID_SCOPES2.includes(s4);
 }
 function isValidReviewState(s4) {
   return VALID_REVIEW_STATES.includes(s4);
@@ -849900,7 +849900,7 @@ function handleRecallSearch(args2, context) {
     if (isValidScope(scope))
       filter.scope = scope;
     else {
-      context.print(`[memory] Unknown scope "${scope}". Valid values ${VALID_SCOPES.join(", ")}.`);
+      context.print(`[memory] Unknown scope "${scope}". Valid values ${VALID_SCOPES2.join(", ")}.`);
       return;
     }
   }
@@ -850075,7 +850075,7 @@ function handleRecallList(args2, context) {
   if (scopeIdx !== -1 && args2[scopeIdx + 1]) {
     const scope = args2[scopeIdx + 1];
     if (!isValidScope(scope)) {
-      context.print(`[memory] Unknown scope "${scope}". Valid values ${VALID_SCOPES.join(", ")}.`);
+      context.print(`[memory] Unknown scope "${scope}". Valid values ${VALID_SCOPES2.join(", ")}.`);
       return;
     }
     filter.scope = scope;
@@ -850125,7 +850125,7 @@ async function handleRecallAdd(args2, context) {
   const tags = tagsRaw ? tagsRaw.split(",").map((token) => token.trim()).filter(Boolean) : [];
   const scope = scopeRaw && isValidScope(scopeRaw) ? scopeRaw : "project";
   if (scopeRaw && !isValidScope(scopeRaw)) {
-    context.print(`[memory] Invalid scope "${scopeRaw}". Valid values ${VALID_SCOPES.join(", ")}.`);
+    context.print(`[memory] Invalid scope "${scopeRaw}". Valid values ${VALID_SCOPES2.join(", ")}.`);
     return;
   }
   const provenance = [];
@@ -850259,7 +850259,7 @@ function handleRecallExport(args2, context) {
   if (scopeIdx !== -1 && commandArgs[scopeIdx + 1]) {
     const scope = commandArgs[scopeIdx + 1];
     if (!isValidScope(scope)) {
-      context.print(`[memory] Unknown scope "${scope}". Valid values ${VALID_SCOPES.join(", ")}.`);
+      context.print(`[memory] Unknown scope "${scope}". Valid values ${VALID_SCOPES2.join(", ")}.`);
       return;
     }
     filter.scope = scope;
@@ -850338,7 +850338,7 @@ function handleRecallHandoffExport(args2, context) {
   const scopeIdx = commandArgs.indexOf("--scope");
   const scopeRaw = scopeIdx !== -1 ? commandArgs[scopeIdx + 1] : "team";
   if (!scopeRaw || !isValidScope(scopeRaw)) {
-    context.print(`[memory] Unknown scope "${scopeRaw ?? ""}". Valid values ${VALID_SCOPES.join(", ")}.`);
+    context.print(`[memory] Unknown scope "${scopeRaw ?? ""}". Valid values ${VALID_SCOPES2.join(", ")}.`);
     return;
   }
   const bundle = memory.exportBundle({ scope: scopeRaw });
@@ -850454,7 +850454,7 @@ function handleRecallPromote(args2, context) {
   const id = parsed.rest[0];
   const scope = parsed.rest[1];
   if (!id || !scope || !isValidScope(scope)) {
-    context.print(`[memory] Usage: /memory promote <id> <${VALID_SCOPES.join("|")}> --yes`);
+    context.print(`[memory] Usage: /memory promote <id> <${VALID_SCOPES2.join("|")}> --yes`);
     return;
   }
   if (!parsed.yes) {
@@ -863720,8 +863720,9 @@ function deriveStep1CapabilityFlags(snapshot) {
 import { existsSync as existsSync77, mkdirSync as mkdirSync63, readFileSync as readFileSync85, writeFileSync as writeFileSync54 } from "fs";
 import { dirname as dirname60 } from "path";
 var ONBOARDING_CHECK_MARKER_FILE = "onboarding-checked.json";
-function resolveMarkerPath(shellPaths, scope) {
-  return scope === "project" ? shellPaths.resolveProjectPath(GOODVIBES_AGENT_SURFACE_ROOT, ONBOARDING_CHECK_MARKER_FILE) : shellPaths.resolveUserPath(GOODVIBES_AGENT_SURFACE_ROOT, ONBOARDING_CHECK_MARKER_FILE);
+var ONBOARDING_COMPLETION_MARKER_FILE = "onboarding-complete.json";
+function resolveMarkerPath(shellPaths, scope, fileName = ONBOARDING_CHECK_MARKER_FILE) {
+  return scope === "project" ? shellPaths.resolveProjectPath(GOODVIBES_AGENT_SURFACE_ROOT, fileName) : shellPaths.resolveUserPath(GOODVIBES_AGENT_SURFACE_ROOT, fileName);
 }
 function isObject6(value) {
   return typeof value === "object" && value !== null;
@@ -863759,8 +863760,8 @@ function pickEffectiveMarker(user) {
 function getOnboardingCheckMarkerPath(shellPaths, scope = "user") {
   return resolveMarkerPath(shellPaths, scope);
 }
-function readOnboardingCheckMarker(shellPaths, scope = "user") {
-  const path7 = resolveMarkerPath(shellPaths, scope);
+function readOnboardingMarker(shellPaths, scope, fileName) {
+  const path7 = resolveMarkerPath(shellPaths, scope, fileName);
   if (!existsSync77(path7))
     return buildMissingMarkerState(scope, path7);
   try {
@@ -863779,6 +863780,12 @@ function readOnboardingCheckMarker(shellPaths, scope = "user") {
     return buildParseErrorState(scope, path7, parseError);
   }
 }
+function readOnboardingCheckMarker(shellPaths, scope = "user") {
+  return readOnboardingMarker(shellPaths, scope, ONBOARDING_CHECK_MARKER_FILE);
+}
+function readOnboardingCompletionMarker(shellPaths, scope = "user") {
+  return readOnboardingMarker(shellPaths, scope, ONBOARDING_COMPLETION_MARKER_FILE);
+}
 function readOnboardingCheckMarkers(shellPaths) {
   const user = readOnboardingCheckMarker(shellPaths, "user");
   const project = readOnboardingCheckMarker(shellPaths, "project");
@@ -863788,9 +863795,9 @@ function readOnboardingCheckMarkers(shellPaths) {
     effective: pickEffectiveMarker(user)
   };
 }
-function writeOnboardingCheckMarker(shellPaths, options = {}) {
+function writeOnboardingMarker(shellPaths, options, fileName) {
   const scope = options.scope ?? "user";
-  const path7 = resolveMarkerPath(shellPaths, scope);
+  const path7 = resolveMarkerPath(shellPaths, scope, fileName);
   const checkedAt = options.checkedAt ?? Date.now();
   const payload = {
     version: 1,
@@ -863803,7 +863810,13 @@ function writeOnboardingCheckMarker(shellPaths, options = {}) {
   mkdirSync63(dirname60(path7), { recursive: true });
   writeFileSync54(path7, `${JSON.stringify(payload, null, 2)}
 `, "utf-8");
-  return readOnboardingCheckMarker(shellPaths, scope);
+  return readOnboardingMarker(shellPaths, scope, fileName);
+}
+function writeOnboardingCheckMarker(shellPaths, options = {}) {
+  return writeOnboardingMarker(shellPaths, options, ONBOARDING_CHECK_MARKER_FILE);
+}
+function writeOnboardingCompletionMarker(shellPaths, options = {}) {
+  return writeOnboardingMarker(shellPaths, options, ONBOARDING_COMPLETION_MARKER_FILE);
 }
 // src/cli/help.ts
 import { existsSync as existsSync78, readFileSync as readFileSync86 } from "fs";
@@ -866578,7 +866591,7 @@ import { mkdirSync as mkdirSync66, readFileSync as readFileSync88, writeFileSync
 import { dirname as dirname64, resolve as resolve39 } from "path";
 init_state3();
 var VALID_CLASSES2 = ["decision", "constraint", "incident", "pattern", "fact", "risk", "runbook", "architecture", "ownership"];
-var VALID_SCOPES3 = ["session", "project", "team"];
+var VALID_SCOPES4 = ["session", "project", "team"];
 var VALID_REVIEW_STATES3 = ["fresh", "reviewed", "stale", "contradicted"];
 var VALID_PROVENANCE_KINDS = ["session", "turn", "task", "event", "file"];
 var VALUE_OPTIONS = new Set([
@@ -866678,7 +866691,7 @@ function isMemoryClass2(value) {
   return VALID_CLASSES2.includes(value);
 }
 function isMemoryScope2(value) {
-  return VALID_SCOPES3.includes(value);
+  return VALID_SCOPES4.includes(value);
 }
 function isReviewState(value) {
   return VALID_REVIEW_STATES3.includes(value);
@@ -866693,7 +866706,7 @@ function requireClass(value) {
 }
 function requireScope(value) {
   if (!value || !isMemoryScope2(value))
-    throw new Error(`Invalid memory scope "${value ?? ""}". Valid values ${VALID_SCOPES3.join(", ")}`);
+    throw new Error(`Invalid memory scope "${value ?? ""}". Valid values ${VALID_SCOPES4.join(", ")}`);
   return value;
 }
 function optionalScope(value) {
@@ -895939,12 +895952,14 @@ class AgentWorkspace {
       return;
     }
     try {
-      writeOnboardingCheckMarker(shellPaths3, {
+      const marker = {
         scope: "user",
         source: "wizard",
         mode: "new",
         workspaceRoot: shellPaths3.workingDirectory
-      });
+      };
+      writeOnboardingCheckMarker(shellPaths3, marker);
+      writeOnboardingCompletionMarker(shellPaths3, marker);
       this.status = "Onboarding applied and closed.";
       this.lastActionResult = {
         kind: "refreshed",
@@ -903889,7 +903904,7 @@ function getInteractiveTerminalLaunchError(input) {
 }
 function applyInitialTuiCliState(options) {
   const { cli, input, commandRegistry, commandContext, shellPaths: shellPaths3, render } = options;
-  const globalOnboardingMarker = readOnboardingCheckMarker(shellPaths3, "user");
+  const onboardingCompletionMarker = readOnboardingCompletionMarker(shellPaths3, "user");
   const seededPrompt = cli.flags.prompt ?? (cli.rawCommand === undefined && cli.positionals.length > 0 ? cli.positionals.join(" ") : undefined);
   if (cli.command === "onboarding") {
     input.openAgentWorkspace(commandContext);
@@ -903898,8 +903913,8 @@ function applyInitialTuiCliState(options) {
     if (target) {
       commandRegistry.execute("session", ["resume", target], commandContext).then(() => render());
     }
-  } else if (!globalOnboardingMarker.exists) {
-    input.openAgentWorkspace(commandContext);
+  } else if (!onboardingCompletionMarker.payload) {
+    input.openAgentWorkspace(commandContext, "setup");
   }
   if (seededPrompt) {
     input.prompt = seededPrompt;

package/package.json

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

package/src/cli/tui-startup.ts

@@ -1,6 +1,6 @@
 import type { CommandContext, CommandRegistry } from '../input/command-registry.ts';
 import type { InputHandler } from '../input/handler.ts';
-import { readOnboardingCheckMarker } from '../runtime/onboarding/index.ts';
+import { readOnboardingCompletionMarker } from '../runtime/onboarding/index.ts';
 import type { GoodVibesCliParseResult } from './types.ts';
 
 export type InteractiveTerminalCheckInput = {
@@ -95,11 +95,11 @@ export function applyInitialTuiCliState(options: {
   readonly input: InputHandler;
   readonly commandRegistry: CommandRegistry;
   readonly commandContext: CommandContext;
-  readonly shellPaths: Parameters<typeof readOnboardingCheckMarker>[0];
+  readonly shellPaths: Parameters<typeof readOnboardingCompletionMarker>[0];
   readonly render: () => void;
 }): void {
   const { cli, input, commandRegistry, commandContext, shellPaths, render } = options;
-  const globalOnboardingMarker = readOnboardingCheckMarker(shellPaths, 'user');
+  const onboardingCompletionMarker = readOnboardingCompletionMarker(shellPaths, 'user');
   const seededPrompt = cli.flags.prompt ?? (cli.rawCommand === undefined && cli.positionals.length > 0 ? cli.positionals.join(' ') : undefined);
   if (cli.command === 'onboarding') {
     input.openAgentWorkspace(commandContext);
@@ -108,8 +108,8 @@ export function applyInitialTuiCliState(options: {
     if (target) {
       void commandRegistry.execute('session', ['resume', target], commandContext).then(() => render());
     }
-  } else if (!globalOnboardingMarker.exists) {
-    input.openAgentWorkspace(commandContext);
+  } else if (!onboardingCompletionMarker.payload) {
+    input.openAgentWorkspace(commandContext, 'setup');
   }
 
   if (seededPrompt) {

package/src/input/agent-workspace.ts

@@ -20,7 +20,7 @@ import { buildAgentWorkspaceRequirements } from './agent-workspace-requirements.
 import { appendAgentWorkspaceActionSearchText, backspaceAgentWorkspaceActionSearch, beginAgentWorkspaceActionSearch, clearAgentWorkspaceActionSearch, commitAgentWorkspaceActionSearchSelection, searchAgentWorkspaceActions } from './agent-workspace-search.ts';
 import { buildAgentWorkspaceRuntimeSnapshot } from './agent-workspace-snapshot.ts';
 import type { AgentWorkspaceAction, AgentWorkspaceActionResult, AgentWorkspaceActionSearchResult, AgentWorkspaceCategory, AgentWorkspaceCommandDispatcher, AgentWorkspaceEditorField, AgentWorkspaceFocusPane, AgentWorkspaceLocalEditor, AgentWorkspaceLocalEditorKind, AgentWorkspaceLocalLibraryItem, AgentWorkspaceLocalOperation, AgentWorkspacePromptDispatcher, AgentWorkspaceRuntimeSnapshot } from './agent-workspace-types.ts';
-import { writeOnboardingCheckMarker } from '../runtime/onboarding/index.ts';
+import { writeOnboardingCheckMarker, writeOnboardingCompletionMarker } from '../runtime/onboarding/index.ts';
 
 export type { AgentWorkspaceChannelRisk, AgentWorkspaceChannelStatus } from './agent-workspace-channels.ts';
 export type { AgentWorkspaceAction, AgentWorkspaceActionResult, AgentWorkspaceActionSearchResult, AgentWorkspaceCategory, AgentWorkspaceCategoryId, AgentWorkspaceCommandDispatcher, AgentWorkspaceEditorField, AgentWorkspaceFocusPane, AgentWorkspaceLocalEditor, AgentWorkspaceLocalEditorKind, AgentWorkspaceLocalLibraryItem, AgentWorkspaceLocalOperation, AgentWorkspacePromptDispatcher, AgentWorkspaceRuntimeSnapshot } from './agent-workspace-types.ts';
@@ -321,12 +321,14 @@ export class AgentWorkspace {
     }
 
     try {
-      writeOnboardingCheckMarker(shellPaths, {
+      const marker = {
         scope: 'user',
         source: 'wizard',
         mode: 'new',
         workspaceRoot: shellPaths.workingDirectory,
-      });
+      } as const;
+      writeOnboardingCheckMarker(shellPaths, marker);
+      writeOnboardingCompletionMarker(shellPaths, marker);
       this.status = 'Onboarding applied and closed.';
       this.lastActionResult = {
         kind: 'refreshed',

package/src/runtime/onboarding/markers.ts

@@ -11,6 +11,7 @@ import type {
 import { GOODVIBES_AGENT_SURFACE_ROOT } from '../../config/surface.ts';
 
 const ONBOARDING_CHECK_MARKER_FILE = 'onboarding-checked.json';
+const ONBOARDING_COMPLETION_MARKER_FILE = 'onboarding-complete.json';
 
 type OnboardingShellPaths = Pick<
   ShellPathService,
@@ -20,10 +21,11 @@ type OnboardingShellPaths = Pick<
 function resolveMarkerPath(
   shellPaths: OnboardingShellPaths,
   scope: OnboardingStateScope,
+  fileName = ONBOARDING_CHECK_MARKER_FILE,
 ): string {
   return scope === 'project'
-    ? shellPaths.resolveProjectPath(GOODVIBES_AGENT_SURFACE_ROOT, ONBOARDING_CHECK_MARKER_FILE)
-    : shellPaths.resolveUserPath(GOODVIBES_AGENT_SURFACE_ROOT, ONBOARDING_CHECK_MARKER_FILE);
+    ? shellPaths.resolveProjectPath(GOODVIBES_AGENT_SURFACE_ROOT, fileName)
+    : shellPaths.resolveUserPath(GOODVIBES_AGENT_SURFACE_ROOT, fileName);
 }
 
 function isObject(value: unknown): value is Record<string, unknown> {
@@ -87,11 +89,12 @@ export function getOnboardingCheckMarkerPath(
   return resolveMarkerPath(shellPaths, scope);
 }
 
-export function readOnboardingCheckMarker(
+function readOnboardingMarker(
   shellPaths: OnboardingShellPaths,
-  scope: OnboardingStateScope = 'user',
+  scope: OnboardingStateScope,
+  fileName: string,
 ): OnboardingCheckMarkerState {
-  const path = resolveMarkerPath(shellPaths, scope);
+  const path = resolveMarkerPath(shellPaths, scope, fileName);
   if (!existsSync(path)) return buildMissingMarkerState(scope, path);
 
   try {
@@ -112,6 +115,27 @@ export function readOnboardingCheckMarker(
   }
 }
 
+export function readOnboardingCheckMarker(
+  shellPaths: OnboardingShellPaths,
+  scope: OnboardingStateScope = 'user',
+): OnboardingCheckMarkerState {
+  return readOnboardingMarker(shellPaths, scope, ONBOARDING_CHECK_MARKER_FILE);
+}
+
+export function getOnboardingCompletionMarkerPath(
+  shellPaths: OnboardingShellPaths,
+  scope: OnboardingStateScope = 'user',
+): string {
+  return resolveMarkerPath(shellPaths, scope, ONBOARDING_COMPLETION_MARKER_FILE);
+}
+
+export function readOnboardingCompletionMarker(
+  shellPaths: OnboardingShellPaths,
+  scope: OnboardingStateScope = 'user',
+): OnboardingCheckMarkerState {
+  return readOnboardingMarker(shellPaths, scope, ONBOARDING_COMPLETION_MARKER_FILE);
+}
+
 export function readOnboardingCheckMarkers(
   shellPaths: OnboardingShellPaths,
 ): OnboardingCheckMarkersState {
@@ -125,12 +149,13 @@ export function readOnboardingCheckMarkers(
   };
 }
 
-export function writeOnboardingCheckMarker(
+function writeOnboardingMarker(
   shellPaths: OnboardingShellPaths,
-  options: WriteOnboardingCheckMarkerOptions = {},
+  options: WriteOnboardingCheckMarkerOptions,
+  fileName: string,
 ): OnboardingCheckMarkerState {
   const scope = options.scope ?? 'user';
-  const path = resolveMarkerPath(shellPaths, scope);
+  const path = resolveMarkerPath(shellPaths, scope, fileName);
   const checkedAt = options.checkedAt ?? Date.now();
   const payload: OnboardingCheckMarkerPayload = {
     version: 1,
@@ -144,5 +169,19 @@ export function writeOnboardingCheckMarker(
   mkdirSync(dirname(path), { recursive: true });
   writeFileSync(path, `${JSON.stringify(payload, null, 2)}\n`, 'utf-8');
 
-  return readOnboardingCheckMarker(shellPaths, scope);
+  return readOnboardingMarker(shellPaths, scope, fileName);
+}
+
+export function writeOnboardingCheckMarker(
+  shellPaths: OnboardingShellPaths,
+  options: WriteOnboardingCheckMarkerOptions = {},
+): OnboardingCheckMarkerState {
+  return writeOnboardingMarker(shellPaths, options, ONBOARDING_CHECK_MARKER_FILE);
+}
+
+export function writeOnboardingCompletionMarker(
+  shellPaths: OnboardingShellPaths,
+  options: WriteOnboardingCheckMarkerOptions = {},
+): OnboardingCheckMarkerState {
+  return writeOnboardingMarker(shellPaths, options, ONBOARDING_COMPLETION_MARKER_FILE);
 }

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 = '1.1.0';
+let _version = '1.1.1';
 try {
   const pkg = JSON.parse(readFileSync(join(import.meta.dir, '..', 'package.json'), 'utf-8')) as {
     readonly version?: unknown;