@pellux/goodvibes-agent 1.0.44 → 1.1.1

package/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 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.
+
 ## 1.0.44 - 2026-06-05
 
 - Compact Agent workspace top-pane copy across every category so the fullscreen onboarding surface keeps settings and actions visible.

package/dist/package/main.js

@@ -450372,6 +450372,23 @@ function createSchema2(db) {
   `);
   db.run(`CREATE INDEX IF NOT EXISTS idx_knowledge_schedules_job_id ON knowledge_schedules(job_id)`);
 }
+function getKnowledgeSchemaStatements() {
+  const statements = [];
+  createSchema2({
+    run(sql) {
+      const normalized = sql.trim();
+      if (normalized.length > 0)
+        statements.push(normalized);
+    }
+  });
+  return statements;
+}
+function renderKnowledgeSchemaSql() {
+  return `${getKnowledgeSchemaStatements().map((statement) => statement.endsWith(";") ? statement : `${statement};`).join(`
+
+`)}
+`;
+}
 function rowObject(columns, values2) {
   return Object.fromEntries(columns.map((column, index) => [column, values2[index]]));
 }
@@ -763654,6 +763671,9 @@ var init_ingest = __esm(() => {
 // node_modules/@pellux/goodvibes-sdk/dist/platform/knowledge/browser-history/index.js
 var init_browser_history = __esm(() => {
   init_ingest();
+  init_discover();
+  init_readers();
+  init_paths2();
 });
 
 // node_modules/graphql/jsutils/devAssert.mjs
@@ -781293,6 +781313,7 @@ var init_semantic = __esm(() => {
   init_llm();
   init_gap_repair();
   init_service4();
+  init_self_improvement();
 });
 
 // node_modules/@pellux/goodvibes-sdk/dist/platform/knowledge/home-graph/helpers.js
@@ -785261,8 +785282,40 @@ var init_map_view = __esm(() => {
 });
 
 // node_modules/@pellux/goodvibes-sdk/dist/platform/knowledge/home-graph/types.js
-var HOME_GRAPH_CAPABILITIES;
+var HOME_GRAPH_NODE_KINDS, HOME_GRAPH_RELATIONS, HOME_GRAPH_CAPABILITIES;
 var init_types15 = __esm(() => {
+  HOME_GRAPH_NODE_KINDS = [
+    "ha_home",
+    "ha_entity",
+    "ha_device",
+    "ha_area",
+    "ha_automation",
+    "ha_script",
+    "ha_scene",
+    "ha_label",
+    "ha_integration",
+    "ha_room",
+    "ha_device_passport",
+    "ha_maintenance_item",
+    "ha_troubleshooting_case",
+    "ha_purchase",
+    "ha_network_node"
+  ];
+  HOME_GRAPH_RELATIONS = [
+    "controls",
+    "located_in",
+    "belongs_to_device",
+    "has_manual",
+    "has_receipt",
+    "has_warranty",
+    "has_issue",
+    "fixed_by",
+    "uses_battery",
+    "connected_via",
+    "part_of_network",
+    "mentioned_by",
+    "source_for"
+  ];
   HOME_GRAPH_CAPABILITIES = [
     "knowledge-space-isolation",
     "snapshot-sync",
@@ -786669,6 +786722,7 @@ var init_service5 = __esm(() => {
 var init_home_graph = __esm(() => {
   init_service5();
   init_extension();
+  init_types15();
 });
 
 // node_modules/@pellux/goodvibes-sdk/dist/platform/knowledge/store-refinement.js
@@ -788996,10 +789050,14 @@ var init_service6 = __esm(() => {
 var init_project_planning = __esm(() => {
   init_service6();
   init_helpers3();
+  init_readiness();
 });
 
 // node_modules/@pellux/goodvibes-sdk/dist/platform/knowledge/persistence.js
-var init_persistence = () => {};
+var init_persistence = __esm(() => {
+  init_store_schema();
+  init_store_load();
+});
 
 // node_modules/@pellux/goodvibes-sdk/dist/platform/knowledge/projections.js
 class KnowledgeProjectionService {
@@ -792507,21 +792565,21 @@ var init_service7 = __esm(() => {
 var exports_knowledge = {};
 __export(exports_knowledge, {
   withKnowledgeSpace: () => withKnowledgeSpace,
-  uniqKnowledgeValues: () => uniq3,
-  stabilizeKnowledgeText: () => stableText2,
-  runKnowledgeSemanticSelfImprovement: () => runKnowledgeSemanticSelfImprovement2,
+  uniqKnowledgeValues: () => uniq2,
+  stabilizeKnowledgeText: () => stableText,
+  runKnowledgeSemanticSelfImprovement: () => runKnowledgeSemanticSelfImprovement,
   resolveProjectPlanningSpace: () => resolveProjectPlanningSpace,
-  resolveKnowledgeDbPathFromControlPlaneDir: () => resolveKnowledgeDbPathFromControlPlaneDir2,
+  resolveKnowledgeDbPathFromControlPlaneDir: () => resolveKnowledgeDbPathFromControlPlaneDir,
   renderPacket: () => renderPacket,
   renderKnowledgeSchemaSql: () => renderKnowledgeSchemaSql,
   renderKnowledgeMap: () => renderKnowledgeMap,
   readKnowledgeSearchText: () => readKnowledgeSearchText,
-  readBrowserKnowledgeProfile: () => readBrowserKnowledgeProfile2,
+  readBrowserKnowledgeProfile: () => readBrowserKnowledgeProfile,
   projectPlanningSourceId: () => projectPlanningSourceId,
   projectPlanningProjectIdFromPath: () => projectPlanningProjectIdFromPath,
   projectPlanningCanonicalUri: () => projectPlanningCanonicalUri,
   projectKnowledgeSpaceId: () => projectKnowledgeSpaceId,
-  parseKnowledgeJsonValue: () => parseJsonValue2,
+  parseKnowledgeJsonValue: () => parseJsonValue,
   normalizeProjectId: () => normalizeProjectId,
   normalizeKnowledgeSpaceId: () => normalizeKnowledgeSpaceId,
   normalizeHomeAssistantInstallationId: () => normalizeHomeAssistantInstallationId,
@@ -792529,12 +792587,12 @@ __export(exports_knowledge, {
   materializeGeneratedKnowledgeProjection: () => materializeGeneratedKnowledgeProjection,
   looksLikeRawPdfPayload: () => looksLikeRawPdfPayload,
   looksBinaryLikeText: () => looksBinaryLikeText,
-  loadKnowledgeStoreSnapshot: () => loadKnowledgeStoreSnapshot2,
+  loadKnowledgeStoreSnapshot: () => loadKnowledgeStoreSnapshot,
   listGeneratedKnowledgePages: () => listGeneratedKnowledgePages,
-  listBrowserKinds: () => listBrowserKinds2,
+  listBrowserKinds: () => listBrowserKinds,
   knowledgeSpaceMetadata: () => knowledgeSpaceMetadata,
   knowledgePageSourceWeight: () => knowledgePageSourceWeight,
-  knowledgeNowMs: () => nowMs2,
+  knowledgeNowMs: () => nowMs,
   knowledgeExtractionNeedsRefresh: () => knowledgeExtractionNeedsRefresh,
   isUsefulKnowledgePageSourceCandidate: () => isUsefulKnowledgePageSourceCandidate,
   isUsefulKnowledgePageSource: () => isUsefulKnowledgePageSource,
@@ -792554,12 +792612,12 @@ __export(exports_knowledge, {
   generatedKnowledgeSourceId: () => generatedKnowledgeSourceId,
   generatedKnowledgeCanonicalUri: () => generatedKnowledgeCanonicalUri,
   extractKnowledgeArtifact: () => extractKnowledgeArtifact,
-  evaluateProjectPlanningReadiness: () => evaluateProjectPlanningReadiness2,
-  discoverBrowserKnowledgeProfiles: () => discoverBrowserKnowledgeProfiles2,
+  evaluateProjectPlanningReadiness: () => evaluateProjectPlanningReadiness,
+  discoverBrowserKnowledgeProfiles: () => discoverBrowserKnowledgeProfiles,
   createWebKnowledgeGapRepairer: () => createWebKnowledgeGapRepairer,
   createProviderBackedKnowledgeSemanticLlm: () => createProviderBackedKnowledgeSemanticLlm,
   createMemoryApi: () => createMemoryApi,
-  createKnowledgeSchema: () => createSchema3,
+  createKnowledgeSchema: () => createSchema2,
   createKnowledgeApi: () => createKnowledgeApi,
   createDefaultKnowledgeConnectorRegistry: () => createDefaultKnowledgeConnectorRegistry,
   compareKnowledgePageSources: () => compareKnowledgePageSources,
@@ -794998,7 +795056,7 @@ var init_delivery_manager = __esm(() => {
 });
 
 // node_modules/@pellux/goodvibes-sdk/dist/platform/automation/scheduler-capacity.js
-function computeSchedulerCapacity(slotsTotal, runs, nowMs3 = Date.now()) {
+function computeSchedulerCapacity(slotsTotal, runs, nowMs2 = Date.now()) {
   let slotsInUse = 0;
   const queuedRuns = [];
   for (const run7 of runs) {
@@ -795008,7 +795066,7 @@ function computeSchedulerCapacity(slotsTotal, runs, nowMs3 = Date.now()) {
       queuedRuns.push(run7);
   }
   const queueDepth = queuedRuns.length;
-  const oldestQueuedAgeMs = queueDepth > 0 ? nowMs3 - Math.min(...queuedRuns.map((r6) => r6.queuedAt)) : null;
+  const oldestQueuedAgeMs = queueDepth > 0 ? nowMs2 - Math.min(...queuedRuns.map((r6) => r6.queuedAt)) : null;
   return { slotsTotal, slotsInUse, queueDepth, oldestQueuedAgeMs };
 }
 
@@ -817087,7 +817145,7 @@ var createStyledCell = (char, overrides = {}) => ({
 // src/version.ts
 import { readFileSync } from "fs";
 import { join } from "path";
-var _version = "1.0.44";
+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;
@@ -839600,7 +839658,7 @@ var WORK_PLAN_STATUSES = [
   "failed",
   "cancelled"
 ];
-function nowMs3() {
+function nowMs2() {
   return Date.now();
 }
 function isObject4(value) {
@@ -839706,7 +839764,7 @@ class WorkPlanStore {
     if (!normalizedTitle)
       throw new Error("Work plan item title is required.");
     const plan = this.readPlan();
-    const time4 = nowMs3();
+    const time4 = nowMs2();
     const item = {
       id: createItemId(),
       title: normalizedTitle,
@@ -839730,7 +839788,7 @@ class WorkPlanStore {
   updateItem(idOrPrefix, patch2) {
     const plan = this.readPlan();
     const item = this.resolveItem(plan, idOrPrefix);
-    const time4 = nowMs3();
+    const time4 = nowMs2();
     const nextStatus = patch2.status ?? item.status;
     const next = this.pruneItem({
       ...item,
@@ -839763,7 +839821,7 @@ class WorkPlanStore {
   removeItem(idOrPrefix) {
     const plan = this.readPlan();
     const item = this.resolveItem(plan, idOrPrefix);
-    const time4 = nowMs3();
+    const time4 = nowMs2();
     const remaining = plan.items.filter((candidate) => candidate.id !== item.id);
     this.writePlan({
       ...plan,
@@ -839783,7 +839841,7 @@ class WorkPlanStore {
       ...plan,
       items: remaining,
       activeItemId: remaining[0]?.id,
-      updatedAt: nowMs3()
+      updatedAt: nowMs2()
     });
     return removed;
   }
@@ -839822,7 +839880,7 @@ class WorkPlanStore {
     const parsed = JSON.parse(raw);
     if (!isObject4(parsed))
       return this.createEmptyPlan();
-    const time4 = nowMs3();
+    const time4 = nowMs2();
     const createdAt = typeof parsed.createdAt === "number" ? parsed.createdAt : time4;
     const updatedAt = typeof parsed.updatedAt === "number" ? parsed.updatedAt : createdAt;
     const items = Array.isArray(parsed.items) ? parsed.items.map((item) => normalizeItem(item, createdAt)).filter((item) => item !== null) : [];
@@ -839841,7 +839899,7 @@ class WorkPlanStore {
     };
   }
   createEmptyPlan() {
-    const time4 = nowMs3();
+    const time4 = nowMs2();
     return {
       id: createPlanId(this.options.projectId, this.options.projectRoot),
       projectId: this.options.projectId,
@@ -849793,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);
@@ -849842,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;
     }
   }
@@ -850017,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;
@@ -850067,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 = [];
@@ -850201,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;
@@ -850280,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 });
@@ -850396,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) {
@@ -858574,7 +858632,8 @@ var AGENT_WORKSPACE_CATEGORY_IDS = [
   "work",
   "host",
   "automation",
-  "delegate"
+  "delegate",
+  "finish"
 ];
 
 // src/input/commands/agent-workspace-runtime.ts
@@ -863014,7 +863073,7 @@ function registerBriefRuntimeCommands(registry5) {
 
 // src/cli/bundle-command.ts
 import { existsSync as existsSync80, mkdirSync as mkdirSync64, readFileSync as readFileSync87, writeFileSync as writeFileSync55 } from "fs";
-import { dirname as dirname61 } from "path";
+import { dirname as dirname62 } from "path";
 // src/runtime/onboarding/state.ts
 import { existsSync as existsSync76, mkdirSync as mkdirSync62, readFileSync as readFileSync84, writeFileSync as writeFileSync53 } from "fs";
 var ONBOARDING_RUNTIME_STATE_FILE = "onboarding-state.json";
@@ -863659,9 +863718,11 @@ function deriveStep1CapabilityFlags(snapshot) {
 }
 // src/runtime/onboarding/markers.ts
 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;
@@ -863699,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 {
@@ -863719,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");
@@ -863728,9 +863795,32 @@ function readOnboardingCheckMarkers(shellPaths) {
     effective: pickEffectiveMarker(user)
   };
 }
+function writeOnboardingMarker(shellPaths, options, fileName) {
+  const scope = options.scope ?? "user";
+  const path7 = resolveMarkerPath(shellPaths, scope, fileName);
+  const checkedAt = options.checkedAt ?? Date.now();
+  const payload = {
+    version: 1,
+    checkedAt,
+    updatedAt: options.updatedAt ?? checkedAt,
+    source: options.source ?? "wizard",
+    ...options.mode ? { mode: options.mode } : {},
+    ...options.workspaceRoot ? { workspaceRoot: options.workspaceRoot } : {}
+  };
+  mkdirSync63(dirname60(path7), { recursive: true });
+  writeFileSync54(path7, `${JSON.stringify(payload, null, 2)}
+`, "utf-8");
+  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";
-import { dirname as dirname60, join as join93 } from "path";
+import { dirname as dirname61, join as join93 } from "path";
 import { fileURLToPath as fileURLToPath4 } from "url";
 function readJsonVersion(path7) {
   try {
@@ -863743,7 +863833,7 @@ function readJsonVersion(path7) {
   }
 }
 function getPackageVersion() {
-  const here = dirname60(fileURLToPath4(import.meta.url));
+  const here = dirname61(fileURLToPath4(import.meta.url));
   return readJsonVersion(join93(here, "..", "..", "package.json")) ?? VERSION;
 }
 function renderGoodVibesVersion(binary2 = "goodvibes-agent") {
@@ -864687,7 +864777,7 @@ async function handleBundleCommand(runtime2) {
       }
     };
     const targetPath = shellPaths.resolveWorkspacePath(outputPath);
-    mkdirSync64(dirname61(targetPath), { recursive: true });
+    mkdirSync64(dirname62(targetPath), { recursive: true });
     writeFileSync55(targetPath, redactSerializedSecrets(JSON.stringify(bundle, null, 2), sensitiveValues) + `
 `, "utf-8");
     return {
@@ -865305,7 +865395,7 @@ function formatProviderAuthRoute(route) {
 
 // src/cli/management-commands.ts
 import { mkdirSync as mkdirSync65, writeFileSync as writeFileSync56 } from "fs";
-import { dirname as dirname62 } from "path";
+import { dirname as dirname63 } from "path";
 init_config8();
 init_config8();
 init_config8();
@@ -865615,7 +865705,7 @@ async function handleSessions(runtime2) {
 `;
       if (outputPath) {
         const targetPath = services.shellPaths.resolveWorkspacePath(outputPath);
-        mkdirSync65(dirname62(targetPath), { recursive: true });
+        mkdirSync65(dirname63(targetPath), { recursive: true });
         writeFileSync56(targetPath, text, "utf-8");
         return [
           "Session exported",
@@ -866498,10 +866588,10 @@ Run goodvibes-agent skills discover to inspect available skill files.`, 1);
 
 // src/cli/memory-command.ts
 import { mkdirSync as mkdirSync66, readFileSync as readFileSync88, writeFileSync as writeFileSync57 } from "fs";
-import { dirname as dirname63, resolve as resolve39 } from "path";
+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([
@@ -866601,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);
@@ -866616,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) {
@@ -866794,7 +866884,7 @@ function resolvePath4(runtime2, path7) {
   return resolve39(runtime2.workingDirectory, path7);
 }
 function writeBundle(path7, bundle) {
-  mkdirSync66(dirname63(path7), { recursive: true });
+  mkdirSync66(dirname64(path7), { recursive: true });
   writeFileSync57(path7, `${JSON.stringify(bundle, null, 2)}
 `);
 }
@@ -883827,7 +883917,7 @@ function describeHarnessDelegationRoute(context, args2) {
 
 // src/tools/agent-harness-keybinding-metadata.ts
 import { existsSync as existsSync83, mkdirSync as mkdirSync68, readFileSync as readFileSync90, writeFileSync as writeFileSync59 } from "fs";
-import { dirname as dirname64 } from "path";
+import { dirname as dirname65 } from "path";
 var FIXED_SHORTCUTS = [
   { key: "Enter", description: "Send prompt" },
   { key: "Shift+Enter / Ctrl+J", description: "Insert newline" },
@@ -884207,7 +884297,7 @@ function readOverrideFile(configPath) {
   return parsed;
 }
 function writeOverrideFile(configPath, overrides) {
-  mkdirSync68(dirname64(configPath), { recursive: true });
+  mkdirSync68(dirname65(configPath), { recursive: true });
   writeFileSync59(configPath, `${JSON.stringify(overrides, null, 2)}
 `, "utf-8");
 }
@@ -890239,6 +890329,10 @@ function activateAgentWorkspaceSelection(workspace, requestRender) {
     workspace.applyLocalLibraryOperation(action2.localOperation);
     return;
   }
+  if (action2.kind === "onboarding-complete") {
+    workspace.completeOnboarding();
+    return;
+  }
   if (action2.kind === "guidance" || !action2.command) {
     handleGuidanceOrWorkspaceAction(workspace, action2);
     return;
@@ -890965,6 +891059,17 @@ var AGENT_WORKSPACE_CATEGORIES = [
       { id: "review-command", label: "Review delegation command", detail: "Use the confirmed delegation form only when the user explicitly asks for code review/build execution. Include the actual task text, preserve the full original ask, and request delegated review only when asked.", kind: "guidance", safety: "delegates" },
       { id: "delegation-status", label: "Delegation status", detail: "Inspect build-delegation receipts and shared-session status without starting coding work.", command: "/delegate status", kind: "command", safety: "read-only" }
     ]
+  },
+  {
+    id: "finish",
+    group: "FINISH",
+    label: "Finish",
+    summary: "Acknowledge setup and close onboarding.",
+    detail: "Use this final step after reviewing setup. Apply & close writes the user onboarding completion marker so normal future launches start in the main conversation.",
+    actions: [
+      { id: "onboarding-apply-close", label: "Apply & close", detail: "Acknowledge onboarding as finished, persist the user completion marker, and close the fullscreen Agent workspace.", kind: "onboarding-complete", safety: "safe" },
+      { id: "finish-review-setup", label: "Review setup first", detail: "Jump back to setup before acknowledging onboarding as finished.", targetCategoryId: "setup", kind: "workspace", safety: "safe" }
+    ]
   }
 ];
 
@@ -895834,6 +895939,47 @@ class AgentWorkspace {
       openDeleteEditor: (kind2, selected) => this.openDeleteEditor(kind2, selected)
     });
   }
+  completeOnboarding() {
+    const shellPaths3 = this.context?.workspace?.shellPaths;
+    if (!shellPaths3) {
+      this.status = "Cannot complete onboarding without Agent shell paths.";
+      this.lastActionResult = {
+        kind: "error",
+        title: "Onboarding completion unavailable",
+        detail: "The Agent workspace cannot locate the user onboarding completion marker path for this runtime.",
+        safety: "safe"
+      };
+      return;
+    }
+    try {
+      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",
+        title: "Onboarding complete",
+        detail: "Saved the user onboarding completion marker. Future normal launches start in the main conversation.",
+        safety: "safe"
+      };
+      if (!this.context?.dismissAgentWorkspace?.())
+        this.close();
+    } catch (error53) {
+      const detail = error53 instanceof Error ? error53.message : String(error53);
+      this.status = "Onboarding completion failed.";
+      this.lastActionResult = {
+        kind: "error",
+        title: "Onboarding completion failed",
+        detail,
+        safety: "safe"
+      };
+    }
+  }
   selectedItemForOperation(operation) {
     if (operation.startsWith("memory-"))
       return this.selectedLocalLibraryItem("memory");
@@ -902437,6 +902583,8 @@ function snapshotLines(workspace, category, snapshot2) {
     base2.push({ text: `Automation: ${ready.length} schedule-ready routine(s); receipts ${snapshot2.routineScheduleReceiptCount}.`, fg: ready.length > 0 ? FULLSCREEN_PALETTE.good : FULLSCREEN_PALETTE.warn }, automationNextActionLine(snapshot2), compactRoutineReceiptLine(snapshot2), { text: "Reminders and routine promotion require confirmation.", fg: FULLSCREEN_PALETTE.warn });
   } else if (category.id === "delegate") {
     base2.push({ text: "Build/fix/review work is handed to GoodVibes TUI.", fg: FULLSCREEN_PALETTE.info }, { text: `Delegated review policy: ${snapshot2.delegatedReviewPolicy}`, fg: FULLSCREEN_PALETTE.warn }, { text: "No coding-role Agent jobs are created here.", fg: FULLSCREEN_PALETTE.good });
+  } else if (category.id === "finish") {
+    base2.push({ text: "Apply & close marks onboarding finished for this user.", fg: FULLSCREEN_PALETTE.good }, { text: "Future normal launches start in the main conversation.", fg: FULLSCREEN_PALETTE.info }, { text: "Use /agent, /setup, or /onboarding to reopen this workspace later.", fg: FULLSCREEN_PALETTE.muted });
   }
   if (snapshot2.warnings.length > 0) {
     base2.push({ text: `Warnings: ${snapshot2.warnings.map((warning) => compactText3(warning, 60)).join("; ")}`, fg: FULLSCREEN_PALETTE.warn });
@@ -903756,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);
@@ -903765,10 +903913,8 @@ function applyInitialTuiCliState(options) {
     if (target) {
       commandRegistry.execute("session", ["resume", target], commandContext).then(() => render());
     }
-  } else if (!globalOnboardingMarker.exists) {
-    input.openAgentWorkspace(commandContext);
-  } else if (cli.command === "tui" && seededPrompt === undefined) {
-    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.0.44",
+  "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,10 +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 (cli.command === 'tui' && seededPrompt === undefined) {
-    input.openAgentWorkspace(commandContext);
+  } else if (!onboardingCompletionMarker.payload) {
+    input.openAgentWorkspace(commandContext, 'setup');
   }
 
   if (seededPrompt) {

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

@@ -36,6 +36,7 @@ interface AgentWorkspaceActivationHost {
   moveLocalLibraryItemSelection(kind: AgentWorkspaceLocalEditorKind, delta: number): void;
   selectedLocalLibraryItem(kind: AgentWorkspaceLocalEditorKind): AgentWorkspaceLocalLibraryItem | null;
   applyLocalLibraryOperation(operation: AgentWorkspaceLocalOperation): void;
+  completeOnboarding(): void;
   hasCommandDispatch(): boolean;
   dispatchWorkspaceCommand: AgentWorkspaceCommandDispatcher;
   commitActionSearchSelection(): boolean;
@@ -89,6 +90,10 @@ export function activateAgentWorkspaceSelection(
     workspace.applyLocalLibraryOperation(action.localOperation);
     return;
   }
+  if (action.kind === 'onboarding-complete') {
+    workspace.completeOnboarding();
+    return;
+  }
   if (action.kind === 'guidance' || !action.command) {
     handleGuidanceOrWorkspaceAction(workspace, action);
     return;

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

@@ -609,6 +609,17 @@ export const AGENT_WORKSPACE_CATEGORIES: readonly AgentWorkspaceCategory[] = [
       { id: 'delegation-status', label: 'Delegation status', detail: 'Inspect build-delegation receipts and shared-session status without starting coding work.', command: '/delegate status', kind: 'command', safety: 'read-only' },
     ],
   },
+  {
+    id: 'finish',
+    group: 'FINISH',
+    label: 'Finish',
+    summary: 'Acknowledge setup and close onboarding.',
+    detail: 'Use this final step after reviewing setup. Apply & close writes the user onboarding completion marker so normal future launches start in the main conversation.',
+    actions: [
+      { id: 'onboarding-apply-close', label: 'Apply & close', detail: 'Acknowledge onboarding as finished, persist the user completion marker, and close the fullscreen Agent workspace.', kind: 'onboarding-complete', safety: 'safe' },
+      { id: 'finish-review-setup', label: 'Review setup first', detail: 'Jump back to setup before acknowledging onboarding as finished.', targetCategoryId: 'setup', kind: 'workspace', safety: 'safe' },
+    ],
+  },
 ];
 
 export function renderAgentWorkspacePackageText(): string {

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

@@ -27,11 +27,12 @@ export const AGENT_WORKSPACE_CATEGORY_IDS = [
   'host',
   'automation',
   'delegate',
+  'finish',
 ] as const;
 
 export type AgentWorkspaceCategoryId = (typeof AGENT_WORKSPACE_CATEGORY_IDS)[number];
 
-export type AgentWorkspaceActionKind = 'command' | 'guidance' | 'workspace' | 'editor' | 'local-selection' | 'local-operation';
+export type AgentWorkspaceActionKind = 'command' | 'guidance' | 'workspace' | 'editor' | 'local-selection' | 'local-operation' | 'onboarding-complete';
 
 export type AgentWorkspaceLocalEditorKind = 'memory' | 'note' | 'persona' | 'skill' | 'routine' | 'profile';
 

package/src/input/agent-workspace.ts

@@ -20,6 +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, 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';
@@ -306,6 +307,48 @@ export class AgentWorkspace {
     });
   }
 
+  completeOnboarding(): void {
+    const shellPaths = this.context?.workspace?.shellPaths;
+    if (!shellPaths) {
+      this.status = 'Cannot complete onboarding without Agent shell paths.';
+      this.lastActionResult = {
+        kind: 'error',
+        title: 'Onboarding completion unavailable',
+        detail: 'The Agent workspace cannot locate the user onboarding completion marker path for this runtime.',
+        safety: 'safe',
+      };
+      return;
+    }
+
+    try {
+      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',
+        title: 'Onboarding complete',
+        detail: 'Saved the user onboarding completion marker. Future normal launches start in the main conversation.',
+        safety: 'safe',
+      };
+      if (!this.context?.dismissAgentWorkspace?.()) this.close();
+    } catch (error) {
+      const detail = error instanceof Error ? error.message : String(error);
+      this.status = 'Onboarding completion failed.';
+      this.lastActionResult = {
+        kind: 'error',
+        title: 'Onboarding completion failed',
+        detail,
+        safety: 'safe',
+      };
+    }
+  }
+
   private selectedItemForOperation(operation: AgentWorkspaceLocalOperation): AgentWorkspaceLocalLibraryItem | null {
     if (operation.startsWith('memory-')) return this.selectedLocalLibraryItem('memory');
     if (operation.startsWith('note-')) return this.selectedLocalLibraryItem('note');

package/src/renderer/agent-workspace.ts

@@ -408,6 +408,12 @@ function snapshotLines(workspace: AgentWorkspace, category: AgentWorkspaceCatego
       { text: `Delegated review policy: ${snapshot.delegatedReviewPolicy}`, fg: PALETTE.warn },
       { text: 'No coding-role Agent jobs are created here.', fg: PALETTE.good },
     );
+  } else if (category.id === 'finish') {
+    base.push(
+      { text: 'Apply & close marks onboarding finished for this user.', fg: PALETTE.good },
+      { text: 'Future normal launches start in the main conversation.', fg: PALETTE.info },
+      { text: 'Use /agent, /setup, or /onboarding to reopen this workspace later.', fg: PALETTE.muted },
+    );
   }
   if (snapshot.warnings.length > 0) {
     base.push({ text: `Warnings: ${snapshot.warnings.map((warning) => compactText(warning, 60)).join('; ')}`, fg: PALETTE.warn });

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