@pellux/goodvibes-agent 1.5.7 → 1.5.8

package/CHANGELOG.md

@@ -2,11 +2,17 @@
 
 Product-facing release notes for GoodVibes Agent.
 
+## 1.5.8 - 2026-07-06
+
+- The `memory` CLI command (`goodvibes-agent memory ...`) now writes to the same shared cross-surface memory store that the runtime, the terminal UI, and the SDK already read and write. Previously the CLI opened its own private database, so a memory added from the CLI was invisible everywhere else; a memory added from the CLI is now visible in the Agent runtime, the TUI, and the SDK, and vice versa.
+- Memory records written by older CLI versions are not lost: the runtime's existing startup memory merge already reads from the exact path the old CLI wrote to, so those older records are folded into the shared store automatically the next time the runtime starts. No manual migration step is needed.
+- Documentation and code-comment hygiene: internal planning shorthand was replaced with plain language in comments, test names, and past changelog entries. No behavior change.
+
 ## 1.5.7 - 2026-07-06
 
-- v1.5.7 is a patch on the 1.5 line that COMPLETES the Wave-6 platform-SDK adoption started in 1.5.6. The fullscreen Agent workspace, Agent-local behavior, isolated Agent Knowledge, connected-host operator integration, and explicit side-effect boundaries all stay in force; the bundled 1.0.0 GoodVibes platform SDK is unchanged.
-- Adopted the platform's shared credential-status read (W6-C1). When the Agent acts as a client of a connected GoodVibes host, it now reads credential *status* — whether each shared-store credential is configured and usable — over the daemon's `credentials.get` route, and renders it honestly: a host with no shared credential store, an older host that does not serve the route yet, or an unreachable host all report a plain "status unavailable" reason. It never shows a fabricated "configured" and never carries a secret value over the wire. Secret *resolution* for provider auth is unchanged and stays local; API keys remain environment-only and are never persisted.
-- Completed the memory-unification boot follow-ups (W6-C2). At startup the Agent now folds any legacy per-surface memory into the single cross-surface store and shows the fold report (nothing is silently dropped), migrates existing VIBE.md personality files into durable persona records exactly once — guarded by a persisted marker so the same file is never re-imported into near-duplicate records — and builds the VIBE prompt as a projection of those persona records. The projection preserves the precedence rule verbatim: these vibe instructions are followed only when they do not conflict with explicit user instructions, safety policy, tool contracts, confirmation requirements, or secret-handling rules.
+- v1.5.7 is a patch on the 1.5 line that completes the platform-SDK adoption started in 1.5.6. The fullscreen Agent workspace, Agent-local behavior, isolated Agent Knowledge, connected-host operator integration, and explicit side-effect boundaries all stay in force; the bundled 1.0.0 GoodVibes platform SDK is unchanged.
+- Adopted the platform's shared credential-status read. When the Agent acts as a client of a connected GoodVibes host, it now reads credential *status* — whether each shared-store credential is configured and usable — over the daemon's `credentials.get` route, and renders it honestly: a host with no shared credential store, an older host that does not serve the route yet, or an unreachable host all report a plain "status unavailable" reason. It never shows a fabricated "configured" and never carries a secret value over the wire. Secret *resolution* for provider auth is unchanged and stays local; API keys remain environment-only and are never persisted.
+- Completed the memory-unification boot follow-ups. At startup the Agent now folds any legacy per-surface memory into the single cross-surface store and shows the fold report (nothing is silently dropped), migrates existing VIBE.md personality files into durable persona records exactly once — guarded by a persisted marker so the same file is never re-imported into near-duplicate records — and builds the VIBE prompt as a projection of those persona records. The projection preserves the precedence rule verbatim: these vibe instructions are followed only when they do not conflict with explicit user instructions, safety policy, tool contracts, confirmation requirements, or secret-handling rules.
 - No change to your conversations, skills, routines, or operator confirmation gates beyond the visibility and memory adoption above.
 
 ## 1.5.6 - 2026-07-06

package/README.md

@@ -1,7 +1,7 @@
 # GoodVibes Agent
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
-[![Version: 1.5.3](https://img.shields.io/badge/version-1.5.7-blue.svg)](#install)
+[![Version: 1.5.3](https://img.shields.io/badge/version-1.5.8-blue.svg)](#install)
 
 GoodVibes Agent is the installable autonomous operator assistant for GoodVibes. It keeps the existing terminal renderer and workspace bones, but the product goal is different from a vibecoding harness: the user should experience one assistant that can chat, plan, remember, research, schedule, send, generate, run visible agents, and operate the GoodVibes daemon contract with clear confirmation gates.
 

package/dist/package/main.js

@@ -459642,23 +459642,6 @@ 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]]));
 }
@@ -772974,9 +772957,6 @@ 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
@@ -790559,7 +790539,6 @@ 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
@@ -794528,40 +794507,8 @@ var init_map_view = __esm(() => {
 });
 
 // node_modules/@pellux/goodvibes-sdk/dist/platform/knowledge/home-graph/types.js
-var HOME_GRAPH_NODE_KINDS, HOME_GRAPH_RELATIONS, HOME_GRAPH_CAPABILITIES;
+var 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",
@@ -795968,7 +795915,6 @@ 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
@@ -798359,14 +798305,10 @@ 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 = __esm(() => {
-  init_store_schema();
-  init_store_load();
-});
+var init_persistence = () => {};
 
 // node_modules/@pellux/goodvibes-sdk/dist/platform/knowledge/projections.js
 class KnowledgeProjectionService {
@@ -801871,21 +801813,21 @@ var init_service7 = __esm(() => {
 var exports_knowledge = {};
 __export(exports_knowledge, {
   withKnowledgeSpace: () => withKnowledgeSpace,
-  uniqKnowledgeValues: () => uniq2,
-  stabilizeKnowledgeText: () => stableText,
-  runKnowledgeSemanticSelfImprovement: () => runKnowledgeSemanticSelfImprovement,
+  uniqKnowledgeValues: () => uniq3,
+  stabilizeKnowledgeText: () => stableText2,
+  runKnowledgeSemanticSelfImprovement: () => runKnowledgeSemanticSelfImprovement2,
   resolveProjectPlanningSpace: () => resolveProjectPlanningSpace,
-  resolveKnowledgeDbPathFromControlPlaneDir: () => resolveKnowledgeDbPathFromControlPlaneDir,
+  resolveKnowledgeDbPathFromControlPlaneDir: () => resolveKnowledgeDbPathFromControlPlaneDir2,
   renderPacket: () => renderPacket,
   renderKnowledgeSchemaSql: () => renderKnowledgeSchemaSql,
   renderKnowledgeMap: () => renderKnowledgeMap,
   readKnowledgeSearchText: () => readKnowledgeSearchText,
-  readBrowserKnowledgeProfile: () => readBrowserKnowledgeProfile,
+  readBrowserKnowledgeProfile: () => readBrowserKnowledgeProfile2,
   projectPlanningSourceId: () => projectPlanningSourceId,
   projectPlanningProjectIdFromPath: () => projectPlanningProjectIdFromPath,
   projectPlanningCanonicalUri: () => projectPlanningCanonicalUri,
   projectKnowledgeSpaceId: () => projectKnowledgeSpaceId,
-  parseKnowledgeJsonValue: () => parseJsonValue,
+  parseKnowledgeJsonValue: () => parseJsonValue2,
   normalizeProjectId: () => normalizeProjectId,
   normalizeKnowledgeSpaceId: () => normalizeKnowledgeSpaceId,
   normalizeHomeAssistantInstallationId: () => normalizeHomeAssistantInstallationId,
@@ -801893,12 +801835,12 @@ __export(exports_knowledge, {
   materializeGeneratedKnowledgeProjection: () => materializeGeneratedKnowledgeProjection,
   looksLikeRawPdfPayload: () => looksLikeRawPdfPayload,
   looksBinaryLikeText: () => looksBinaryLikeText,
-  loadKnowledgeStoreSnapshot: () => loadKnowledgeStoreSnapshot,
+  loadKnowledgeStoreSnapshot: () => loadKnowledgeStoreSnapshot2,
   listGeneratedKnowledgePages: () => listGeneratedKnowledgePages,
-  listBrowserKinds: () => listBrowserKinds,
+  listBrowserKinds: () => listBrowserKinds2,
   knowledgeSpaceMetadata: () => knowledgeSpaceMetadata,
   knowledgePageSourceWeight: () => knowledgePageSourceWeight,
-  knowledgeNowMs: () => nowMs,
+  knowledgeNowMs: () => nowMs2,
   knowledgeExtractionNeedsRefresh: () => knowledgeExtractionNeedsRefresh,
   isUsefulKnowledgePageSourceCandidate: () => isUsefulKnowledgePageSourceCandidate,
   isUsefulKnowledgePageSource: () => isUsefulKnowledgePageSource,
@@ -801918,12 +801860,12 @@ __export(exports_knowledge, {
   generatedKnowledgeSourceId: () => generatedKnowledgeSourceId,
   generatedKnowledgeCanonicalUri: () => generatedKnowledgeCanonicalUri,
   extractKnowledgeArtifact: () => extractKnowledgeArtifact,
-  evaluateProjectPlanningReadiness: () => evaluateProjectPlanningReadiness,
-  discoverBrowserKnowledgeProfiles: () => discoverBrowserKnowledgeProfiles,
+  evaluateProjectPlanningReadiness: () => evaluateProjectPlanningReadiness2,
+  discoverBrowserKnowledgeProfiles: () => discoverBrowserKnowledgeProfiles2,
   createWebKnowledgeGapRepairer: () => createWebKnowledgeGapRepairer,
   createProviderBackedKnowledgeSemanticLlm: () => createProviderBackedKnowledgeSemanticLlm,
   createMemoryApi: () => createMemoryApi,
-  createKnowledgeSchema: () => createSchema2,
+  createKnowledgeSchema: () => createSchema3,
   createKnowledgeApi: () => createKnowledgeApi,
   createDefaultKnowledgeConnectorRegistry: () => createDefaultKnowledgeConnectorRegistry,
   compareKnowledgePageSources: () => compareKnowledgePageSources,
@@ -804387,7 +804329,7 @@ var init_delivery_manager = __esm(() => {
 });
 
 // node_modules/@pellux/goodvibes-sdk/dist/platform/automation/scheduler-capacity.js
-function computeSchedulerCapacity(slotsTotal, runs, nowMs2 = Date.now()) {
+function computeSchedulerCapacity(slotsTotal, runs, nowMs3 = Date.now()) {
   let slotsInUse = 0;
   const queuedRuns = [];
   for (const run7 of runs) {
@@ -804397,7 +804339,7 @@ function computeSchedulerCapacity(slotsTotal, runs, nowMs2 = Date.now()) {
       queuedRuns.push(run7);
   }
   const queueDepth = queuedRuns.length;
-  const oldestQueuedAgeMs = queueDepth > 0 ? nowMs2 - Math.min(...queuedRuns.map((r6) => r6.queuedAt)) : null;
+  const oldestQueuedAgeMs = queueDepth > 0 ? nowMs3 - Math.min(...queuedRuns.map((r6) => r6.queuedAt)) : null;
   return { slotsTotal, slotsInUse, queueDepth, oldestQueuedAgeMs };
 }
 
@@ -830785,7 +830727,7 @@ var createStyledCell = (char, overrides = {}) => ({
 // src/version.ts
 import { readFileSync } from "fs";
 import { join } from "path";
-var _version = "1.5.7";
+var _version = "1.5.8";
 try {
   const pkg = JSON.parse(readFileSync(join(import.meta.dir, "..", "package.json"), "utf-8"));
   _version = typeof pkg.version === "string" ? pkg.version : _version;
@@ -855898,7 +855840,7 @@ var WORK_PLAN_STATUSES = [
   "failed",
   "cancelled"
 ];
-function nowMs2() {
+function nowMs3() {
   return Date.now();
 }
 function isObject4(value) {
@@ -856004,7 +855946,7 @@ class WorkPlanStore {
     if (!normalizedTitle)
       throw new Error("Work plan item title is required.");
     const plan = this.readPlan();
-    const time4 = nowMs2();
+    const time4 = nowMs3();
     const item = {
       id: createItemId(),
       title: normalizedTitle,
@@ -856028,7 +855970,7 @@ class WorkPlanStore {
   updateItem(idOrPrefix, patch2) {
     const plan = this.readPlan();
     const item = this.resolveItem(plan, idOrPrefix);
-    const time4 = nowMs2();
+    const time4 = nowMs3();
     const nextStatus = patch2.status ?? item.status;
     const next = this.pruneItem({
       ...item,
@@ -856061,7 +856003,7 @@ class WorkPlanStore {
   removeItem(idOrPrefix) {
     const plan = this.readPlan();
     const item = this.resolveItem(plan, idOrPrefix);
-    const time4 = nowMs2();
+    const time4 = nowMs3();
     const remaining = plan.items.filter((candidate) => candidate.id !== item.id);
     this.writePlan({
       ...plan,
@@ -856081,7 +856023,7 @@ class WorkPlanStore {
       ...plan,
       items: remaining,
       activeItemId: remaining[0]?.id,
-      updatedAt: nowMs2()
+      updatedAt: nowMs3()
     });
     return removed;
   }
@@ -856120,7 +856062,7 @@ class WorkPlanStore {
     const parsed = JSON.parse(raw);
     if (!isObject4(parsed))
       return this.createEmptyPlan();
-    const time4 = nowMs2();
+    const time4 = nowMs3();
     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) : [];
@@ -856139,7 +856081,7 @@ class WorkPlanStore {
     };
   }
   createEmptyPlan() {
-    const time4 = nowMs2();
+    const time4 = nowMs3();
     return {
       id: createPlanId(this.options.projectId, this.options.projectRoot),
       projectId: this.options.projectId,
@@ -901803,9 +901745,9 @@ Run goodvibes-agent skills discover to inspect available skill files.`, 1);
 }
 
 // src/cli/memory-command.ts
+init_state();
 import { mkdirSync as mkdirSync83, readFileSync as readFileSync105, writeFileSync as writeFileSync72 } from "fs";
 import { dirname as dirname80, resolve as resolve43 } from "path";
-init_state();
 var VALID_CLASSES2 = ["decision", "constraint", "incident", "pattern", "fact", "risk", "runbook", "architecture", "ownership"];
 var VALID_SCOPES4 = ["session", "project", "team"];
 var VALID_REVIEW_STATES3 = ["fresh", "reviewed", "stale", "contradicted"];
@@ -901939,10 +901881,7 @@ function timestamp(value) {
   return new Date(value).toISOString().slice(0, 19).replace("T", " ");
 }
 function memoryDbPath(runtime2) {
-  return createShellPathService2({
-    workingDirectory: runtime2.workingDirectory,
-    homeDirectory: runtime2.homeDirectory
-  }).resolveUserPath(GOODVIBES_AGENT_SURFACE_ROOT, "memory.sqlite");
+  return resolveCanonicalMemoryDbPath(runtime2.homeDirectory);
 }
 async function withMemory(runtime2, fn) {
   const path7 = memoryDbPath(runtime2);
@@ -967711,8 +967650,8 @@ function formatDigestTime(at, from = Date.now()) {
     return `yesterday ${time4}`;
   return `${d4.toLocaleDateString(undefined, { month: "short", day: "numeric" })} ${time4}`;
 }
-function formatRelativeTime(targetMs, nowMs3 = Date.now()) {
-  const diffMs = targetMs - nowMs3;
+function formatRelativeTime(targetMs, nowMs4 = Date.now()) {
+  const diffMs = targetMs - nowMs4;
   if (diffMs <= 0)
     return "soon";
   const diffMin = Math.round(diffMs / 60000);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pellux/goodvibes-agent",
-  "version": "1.5.7",
+  "version": "1.5.8",
   "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/agent/memory-prompt.ts

@@ -1,5 +1,5 @@
 import type { MemoryRecord, MemoryRegistry, MemoryVectorStats } from '@pellux/goodvibes-sdk/platform/state';
-// W6-C2 (E6): the recall-honesty floor + eligibility receipt now live in the SDK as
+// The recall-honesty floor + eligibility receipt now live in the SDK as
 // the ONE cross-surface contract (memory-recall-contract.ts) instead of being defined
 // per surface. This file re-exports them unchanged so every existing agent consumer
 // keeps importing from './memory-prompt.ts', while the SDK is the single source of the
@@ -32,9 +32,9 @@ function formatMemoryLine(record: MemoryRecord): string {
 }
 
 /**
- * Per-turn semantic ranking of an already-eligible memory set (Wave-4 W4-A1B).
+ * Per-turn semantic ranking of an already-eligible memory set.
  *
- * W4-A1 shipped eligibility (confidence + reviewState + provenance) as the hard trust
+ * Eligibility (confidence + reviewState + provenance) shipped as the hard trust
  * gate but had no per-turn query to rank WITHIN that eligible set — records were only
  * ever ordered by stored confidence/recency, regardless of whether they had anything to
  * do with what the user actually just asked. `rankMemoryForTurn` never touches the gate

package/src/agent/operator-actions.ts

@@ -103,7 +103,7 @@ export const OPERATOR_ACTIONS: Record<OperatorActionId, OperatorActionDescriptor
     pathTemplate: '/api/automation/jobs/{jobId}/run',
     targetField: 'jobId',
   },
-  // W6-C3: automation.jobs.pause/resume were retired (redundant with
+  // automation.jobs.pause/resume were retired (redundant with
   // disable/enable — same {id,enabled} output, same semantics). The
   // user-facing "pause"/"resume" verb is unchanged; only the wire action +
   // path moved to the canonical disable/enable methods.

package/src/agent/prompt-context-receipts.ts

@@ -140,7 +140,7 @@ function receiptSegment(input: Omit<PromptContextReceiptSegment, 'approxTokens'>
 
 function buildRuntimePromptReceiptSegments(input: RuntimePromptCompositionInput): readonly PromptContextReceiptSegment[] {
   const vibe = discoverVibeFiles(input.shellPaths);
-  // W6-C2 (E6): the VIBE prompt is a PROJECTION of persona/constraint records, not a
+  // The VIBE prompt is a PROJECTION of persona/constraint records, not a
   // re-read of the files (discoverVibeFiles above stays for the file-discovery receipt).
   const vibePrompt = buildVibeProjectionPrompt(input.memoryRegistry) ?? '';
   const projectContext = discoverProjectContextFiles(input.shellPaths);
@@ -234,7 +234,7 @@ function buildRuntimePromptReceiptSegments(input: RuntimePromptCompositionInput)
       suppressedCount: suppressedMemory.length,
       promptChars: memoryPrompt.length,
       promptText: memoryPrompt,
-      // Honest degrade note (Wave-4 W4-A1B): when per-turn relevance scoring did not
+      // Honest degrade note: when per-turn relevance scoring did not
       // run — no active-turn text, semantic index unavailable, or no vector match —
       // say so instead of silently presenting the fallback confidence/recency order as
       // if it were a relevance ranking.
@@ -245,7 +245,7 @@ function buildRuntimePromptReceiptSegments(input: RuntimePromptCompositionInput)
         class: record.cls,
         confidence: record.confidence,
         reason: describeMemoryPromptEligibility(record).reason,
-        // Per-turn relevance (W4-A1B): honest wording, only present when actually scored.
+        // Per-turn relevance: honest wording, only present when actually scored.
         // F7a: the raw percent is paired with a qualitative band (see relevanceBand)
         // so a genuinely-lower-but-real score like "28%" doesn't read as noise.
         ...(memoryRanking.scored ? { relevance: `relevance to this turn: ${memoryRanking.relevanceById.get(record.id) ?? 0}% (${relevanceBand(memoryRanking.relevanceById.get(record.id) ?? 0)})` } : {}),

package/src/agent/session-registration.ts

@@ -86,7 +86,7 @@ export interface SessionRecordSummary {
 }
 
 /**
- * Honest outcome discriminator. 'still_closed' is the Wave-1 heartbeat-resurrection
+ * Honest outcome discriminator. 'still_closed' is the heartbeat-resurrection
  * guard: a 200 that carries conflict:{status:'closed'} with reopened:false MUST NOT
  * be read as 'registered' or 'reopened'.
  */

package/src/agent/vibe-file.ts

@@ -5,7 +5,7 @@ import type { ShellPathService } from '@/runtime/index.ts';
 import { GOODVIBES_AGENT_SURFACE_ROOT } from '../config/surface.ts';
 import { assertNoSecretLikeText } from './persona-registry.ts';
 import { parseMarkdownFrontmatter, stripMarkdownFrontmatter } from './markdown-frontmatter.ts';
-// W6-C2 (E6): VIBE.md is now a PROJECTION of persona/constraint records in the
+// VIBE.md is now a PROJECTION of persona/constraint records in the
 // canonical memory store, not a separate source of truth. renderVibeProjection emits
 // the same '## VIBE.md' block from those records (caveat preserved); the file is
 // demoted to an import/export FORMAT folded in via vibeBodyToConstraintOptions.
@@ -213,7 +213,7 @@ export function buildVibePrompt(shellPaths: AgentVibePaths): string | null {
 }
 
 /**
- * W6-C2 (E6): the VIBE.md prompt block as a PROJECTION of persona/constraint records.
+ * The VIBE.md prompt block as a PROJECTION of persona/constraint records.
  *
  * This is the store-sourced replacement for buildVibePrompt (which reads the file
  * directly). It renders the same '## GoodVibes Agent VIBE.md' block — including the
@@ -226,7 +226,7 @@ export function buildVibeProjectionPrompt(memoryRecords: { getAll(): readonly Me
 }
 
 /**
- * W6-C2 (E6): fold discovered VIBE.md files into the store as persona/constraint
+ * Fold discovered VIBE.md files into the store as persona/constraint
  * records — the file demoted to an IMPORT FORMAT. Each bullet becomes one record so a
  * later single-record edit changes exactly one projected line. Secret-like content is
  * already rejected by discoverVibeFiles (readVibeCandidate → assertNoSecretLikeText),
@@ -257,7 +257,7 @@ export async function importVibeFilesIntoMemory(
 }
 
 /**
- * W6-C2 (E6): the persisted marker that makes the VIBE.md → memory import a strictly
+ * The persisted marker that makes the VIBE.md → memory import a strictly
  * ONE-TIME migration. Keyed by absolute file path → content hash, so importing the same
  * VIBE.md twice is a no-op (re-import would create near-duplicate persona records), while
  * a NEW project's VIBE.md still migrates exactly once. Mirrors the sessions.spine-folded
@@ -300,7 +300,7 @@ function hashVibeBody(body: string): string {
 }
 
 /**
- * W6-C2 (E6): fold discovered VIBE.md files into persona/constraint records ONCE.
+ * Fold discovered VIBE.md files into persona/constraint records ONCE.
  * Guarded by a persisted path→hash marker so it never re-imports the same file (which
  * would create near-duplicate persona records). Called at boot AFTER memoryStore.init().
  * Returns the number of records created this run (0 when everything is already migrated).

package/src/cli/local-library-command-shared.ts

@@ -7,7 +7,7 @@ import type { CliCommandRuntime } from './management.ts';
 /**
  * Shared prelude for the Agent-local library CLI commands (personas, skills,
  * skill bundles): option parsing, success/failure envelopes, and registry
- * accessors. Split out of local-library-command.ts (W4-H1 ruling: the file
+ * accessors. Split out of local-library-command.ts (the file
  * cleanly contained three independent command handlers glued together) so
  * personas-command.ts, skills-command.ts, and skill-bundle-command.ts can
  * share one option-parsing/output prelude without duplicating it.

package/src/cli/memory-command.ts

@@ -1,10 +1,10 @@
 import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
 import { dirname, resolve } from 'node:path';
-import { createShellPathService } from '@/runtime/index.ts';
 import {
   MemoryEmbeddingProviderRegistry,
   MemoryRegistry,
   MemoryStore,
+  resolveCanonicalMemoryDbPath,
   type MemoryBundle,
   type MemoryClass,
   type MemoryLink,
@@ -18,7 +18,6 @@ import {
 } from '@pellux/goodvibes-sdk/platform/state';
 import { assertNoSecretLikeMemoryText } from '../agent/memory-safety.ts';
 import { formatAgentRecordReference, formatAgentRecordReviewState } from '../agent/record-labels.ts';
-import { GOODVIBES_AGENT_SURFACE_ROOT } from '../config/surface.ts';
 import type { CliCommandOutput } from './types.ts';
 import type { CliCommandRuntime } from './management.ts';
 
@@ -196,11 +195,15 @@ function timestamp(value: number): string {
   return new Date(value).toISOString().slice(0, 19).replace('T', ' ');
 }
 
+// The CLI no longer opens a private per-surface agent/memory.sqlite. It opens the
+// ONE canonical cross-surface store (~/.goodvibes/shared/memory.sqlite) so a memory
+// added via `goodvibes-agent memory add` is visible to the runtime, the TUI, and the
+// SDK — and vice-versa. The old CLI-written store is folded into the canonical store
+// (loss-free, idempotent) by the runtime's foldAgentLegacyMemory at boot, since that
+// fold already sources shellPaths.resolveUserPath('agent', 'memory.sqlite') — the exact
+// path this function used to write to.
 function memoryDbPath(runtime: CliCommandRuntime): string {
-  return createShellPathService({
-    workingDirectory: runtime.workingDirectory,
-    homeDirectory: runtime.homeDirectory,
-  }).resolveUserPath(GOODVIBES_AGENT_SURFACE_ROOT, 'memory.sqlite');
+  return resolveCanonicalMemoryDbPath(runtime.homeDirectory);
 }
 
 async function withMemory<T>(runtime: CliCommandRuntime, fn: (context: MemoryContext) => Promise<T> | T): Promise<T> {

package/src/cli/resume-relaunch-notice.ts

@@ -1,7 +1,7 @@
 import type { SessionManager } from '@pellux/goodvibes-sdk/platform/sessions';
 
 /**
- * RESUME-ON-RELAUNCH (W4-A4).
+ * RESUME-ON-RELAUNCH.
  *
  * The dogfood finding: relaunching the agent after a normal (non-crash) exit
  * silently starts fresh with no offer or notice about the prior session — the

package/src/cli/tui-startup.ts

@@ -116,7 +116,7 @@ export function applyInitialTuiCliState(options: {
     // Normal relaunch: onboarding is done and the user didn't ask for
     // onboarding or an explicit `sessions resume`. Surface an honest,
     // non-blocking resume affordance instead of silently starting fresh
-    // (the W4-A4 dogfood finding) — never auto-resume, declining is
+    // (a dogfood finding) — never auto-resume, declining is
     // frictionless (just start typing).
     surfaceResumeRelaunchNotice({
       getLastSessionPointer: () => readLastSessionPointer({

package/src/config/credential-status.ts

@@ -1,7 +1,7 @@
 /**
  * credential-status.ts — client-side, secret-FREE credential STATUS read.
  *
- * W6-C1 (E7 config sharing). When GoodVibes Agent acts as a CLIENT of an adopted
+ * When GoodVibes Agent acts as a CLIENT of an adopted
  * external daemon, it reads credential *status* (configured / usable) from the
  * daemon's shared store over the wire — the `credentials.get` operator method
  * (GET /config/credentials, admin + read:config). It NEVER receives raw secret

package/src/config/index.ts

@@ -56,7 +56,7 @@ export function getConfiguredSystemPrompt(configManager: Pick<ConfigManager, 'ge
 
 export { getConfiguredApiKeys, resolveApiKeys } from '@pellux/goodvibes-sdk/platform/config';
 
-// W6-C1 (E7): the daemon-client credential STATUS read (secret-free, honest-degrade).
+// The daemon-client credential STATUS read (secret-free, honest-degrade).
 // Value reads above stay local/env; only the status VISIBILITY path moves to the daemon.
 export {
   deriveCredentialAvailability,

package/src/config/secrets.ts

@@ -16,7 +16,7 @@ import {
 import { isSecretRefInput } from '@pellux/goodvibes-sdk/platform/config';
 import { GOODVIBES_AGENT_SURFACE_ROOT } from './surface.ts';
 
-// W6-C1 host-vs-client split (E7 config sharing): this SecretsManager is the LOCAL-HOST
+// Host-vs-client split: this SecretsManager is the LOCAL-HOST
 // read path — pinned to GOODVIBES_AGENT_SURFACE_ROOT, it resolves secret VALUES from the
 // surface store/env for provider auth, unchanged. When the Agent acts as a CLIENT of an
 // adopted external daemon, credential *status* (configured/usable — never bytes) is read

package/src/core/conversation-rendering.ts

@@ -123,8 +123,8 @@ export function renderConversationAssistantMessage(
     // `numWidth=6` (fits 999,999 lines, but wastes 3-4 gutter columns on typical
     // messages) or rendering the numbered output into a scratch buffer and trimming.
     // Neither is clearly better than the current two-pass measurement approach.
-    // The 4α commit message claim that this "eliminates double-parse when line
-    // numbers are enabled" was inaccurate: 4α eliminated the legacy
+    // An earlier commit message's claim that this "eliminates double-parse when line
+    // numbers are enabled" was inaccurate: that commit eliminated the legacy
     // `renderMarkdown()` duplicate used for code-block line-number mode ('code').
     // The 'all' mode double-call is a deliberate design choice and remains unchanged.
     const measureWidth = showAllLineNumbers ? width : 0;

package/src/core/system-message-noise.ts

@@ -9,7 +9,7 @@
  * Ported from the TUI (src/core/system-message-noise.ts). The TUI regexes are
  * kept VERBATIM (provider-replay fold / agents-snapshot drop / stale-replay
  * drop); the only agent-specific addition is the `[Terminal] Captured …` rule
- * (W4-R2, absorbing A8 papercut #3 — the stdout-capture leak). Dropped noise is
+ * (the stdout-capture leak). Dropped noise is
  * drop-from-the-feed, NOT delete: the captured-write detail stays reachable via
  * the activity log (the terminal-output guard logs each intercept + the count).
  */
@@ -46,7 +46,7 @@ const REPLAY_CHAIN_RE = /WRFC chain (\S+) transitioned .* waiting for action/;
 
 /**
  * Matches the terminal-output guard's aggregate captured-write notice
- * (W4-R2, agent-specific). First-run plumbing writes a burst of direct stdout
+ * (agent-specific). First-run plumbing writes a burst of direct stdout
  * that the guard intercepts and would otherwise summarize into the Recent feed;
  * the count stays reachable in the activity log, so the feed copy is dropped.
  */
@@ -57,7 +57,7 @@ const TERMINAL_CAPTURED_RE = /^\[Terminal\] Captured \d+ direct /;
  * lookup, so it is trivially testable.
  */
 export function classifyNoise(message: string, deps: NoiseGateDeps): NoiseVerdict {
-  // agent (W4-R2) — the terminal-output guard's aggregate captured-write notice.
+  // Agent-specific — the terminal-output guard's aggregate captured-write notice.
   // Kept out of the Recent feed; the detail stays in the activity log.
   if (TERMINAL_CAPTURED_RE.test(message)) {
     return DROP;

package/src/core/thinking-overlay.ts

@@ -1,5 +1,5 @@
 /**
- * thinking-overlay.ts (W4-R4) — the thinking-indicator overlay + its honest
+ * thinking-overlay.ts — the thinking-indicator overlay + its honest
  * stall clock, extracted from main.ts's render loop.
  *
  * The SDK orchestrator surfaces no lastDeltaAtMs / reconnect signal directly, so

package/src/input/agent-workspace-basic-command-editor-submission.ts

@@ -42,7 +42,7 @@ function unconfirmed(editor: AgentWorkspaceLocalEditor, message: string, status:
 /**
  * The submission data table for the kinds this module builds itself (delegate-task and
  * workplan/notify/secret/profile kinds keep dispatching to their own sibling submission
- * modules below, unchanged). W4-H2: split out of the single ~570-line
+ * modules below, unchanged). Split out of the single ~570-line
  * `buildAgentWorkspaceBasicCommandEditorSubmission` if-chain, mirroring the
  * construction-side split in agent-workspace-basic-command-editors.ts.
  */

package/src/input/agent-workspace-basic-command-editors.ts

@@ -127,7 +127,7 @@ function modelPinUnpinSpec(kind: AgentWorkspaceBasicOwnCommandEditorKind): Agent
 
 /**
  * The field-spec data table for the kinds this module builds itself (the rest are
- * delegated to sibling domain modules above). W4-H2: split out of the single
+ * delegated to sibling domain modules above). Split out of the single
  * ~600-line `createAgentWorkspaceBasicCommandEditor` if-chain into a data table, the
  * same shape used by every other agent-workspace command-editor domain.
  */

package/src/input/agent-workspace-calendar-connect-editor.ts

@@ -1,5 +1,5 @@
 /**
- * Calendar connect card (W4-A5) — promotes the "Calendar workflows" workspace
+ * Calendar connect card — promotes the "Calendar workflows" workspace
  * card from a dead guidance card into a real, dispatchable action.
  *
  * GROUNDED: unlike email, there is no external calendar account/CalDAV

package/src/input/agent-workspace-calendar-oauth-editor.ts

@@ -1,5 +1,5 @@
 /**
- * Calendar OAuth advanced-credentials wizard (W4-A10).
+ * Calendar OAuth advanced-credentials wizard.
  *
  * The DEFAULT connect experience needs no card at all: `/calendar connect google`
  * (or `outlook`) uses the bundled project client id + PKCE and opens the browser.

package/src/input/agent-workspace-calendar-subscribe-editor.ts

@@ -1,5 +1,5 @@
 /**
- * Calendar subscribe wizard (W4-A9) — the "Calendar workflows" card's real
+ * Calendar subscribe wizard — the "Calendar workflows" card's real
  * connect flow. Subscribes to an external calendar by its iCalendar feed URL
  * (Google "secret address", Outlook published .ics, or any .ics URL), READ-ONLY.
  *