synabun 2.0.7 → 2.0.9

package/CHANGELOG.md

@@ -1,3 +1,41 @@
+# SynaBun v.2.0.9
+
+2.0.9 makes npm installs and updates more reliable, especially on Windows: SynaBun's dependencies are installed in one place at pinned versions, none of them runs its own install script, and the Windows updater closes the SynaBun processes your AI clients started before it replaces the package. A fresh install now starts with no memory categories, Codex on Windows no longer asks for administrator approval when SynaBun starts it, and the Assistant's account menu is easier to read.
+
+## ✨ New
+
+- **Admin sandbox** — When SynaBun started Codex on Windows, Codex could ask Windows for administrator approval (a UAC prompt) to set up its elevated sandbox, once for every Codex account, and a scheduled or background run waited on a prompt nobody saw. Codex started by SynaBun now uses the Windows sandbox that needs no administrator approval, which isolates commands less strictly. To use the elevated one, turn on **Admin sandbox** at the end of the Assistant's permission menu, under **Every agent**. It is off by default, applies to every agent SynaBun starts and never changes your own Codex settings; Claude Code and OpenCode are not affected.
+
+## 🛠 Fixed
+
+- **npm installs and updates that failed on Windows** — An install or update could stop with "Failed to install MCP Server dependencies", or fail because a SynaBun MCP server that an AI client had started still held files of the package open. All of SynaBun's dependencies are now installed together with the package, at the versions the release pins, and SynaBun no longer runs npm when it starts. On Windows the updater first closes the SynaBun processes that AI clients started from the install folder, and tries again when Windows still holds a file.
+- **Installs that downloaded or compiled extra parts** — No dependency runs its own install script during an install or update any more. On Linux x64 an install could download CUDA libraries SynaBun never uses, and on a computer with its own libvips the image library tried to compile itself and failed.
+
+## ⚙️ Changed
+
+- **No memory categories until you need them** — A fresh install starts with no categories, so categories you never used, such as the YouTube one, no longer appear. Adding a project creates its five default categories once: a default you delete stays deleted, and starting a session no longer brings it back. A feature such as conversations, plans or ideas creates its own category the first time it saves something. Categories you already have are not changed.
+- **The Assistant's account menu** — ⚙ → **Account** shows each account on one row with its plan or API key, who is signed in and how much usage is left, with the reset time in words. A signed-out account opens its sign-in, and the account your workers use is in the same menu. The composer's **Model** menu shows the same rows, and the model chip shows the model with the account's initial, with the account's name in its tooltip.
+- **Side panel headers stay on one row** — In a narrow Claude Code, Codex or OpenCode panel, the session name gets shorter instead of the header wrapping onto a second row, and the whole name shows when you point at it.
+- **Repairing an npm install** — When an npm install needs repairing, the launcher names the command: close SynaBun and every AI client that uses it, then run `npm i -g synabun@<version>` with your version. A plain `npm rebuild -g` runs the dependencies' install scripts again, so do not use it.
+
+---
+
+# SynaBun v.2.0.8
+
+2.0.8 fixes the Windows installer of 2.0.7, which could not finish on any Windows PC. It now installs in a few minutes, and when something does go wrong it says what and where to look. macOS, Linux and npm installs were not affected.
+
+## 🛠 Fixed
+
+- **The Windows installer of 2.0.7 never finished** — On every Windows PC, the 2.0.7 installer unpacked SynaBun, could not check the files it had unpacked, unpacked everything again several times over more than ten minutes and then showed a box that blamed the disk space. One of its scripts could not be read by the PowerShell that comes with Windows, so the check never ran. The 2.0.8 installer finishes. If the 2.0.7 installer is still open on your PC, click **Cancel** in its box before you start the new one.
+- **Clear errors when an install cannot finish** — The installer never unpacks again by itself. If files are missing or incomplete, it names them and shows how much space the disk has left and where the installation log is: **Retry** unpacks once more, and **Cancel** stops and puts back the SynaBun you had. The installation log now also shows what the installer did to close SynaBun and to check the files.
+- **Leftovers of a failed install** — A copy that a failed 2.0.7 install left on your PC is replaced cleanly by the new version.
+
+## ⚙️ Changed
+
+- **Faster Windows installs** — Installing over an earlier version moves the old copy aside in one step instead of uninstalling it file by file, the check of the unpacked files takes about a second, and the app carries about 2,300 fewer files for Windows to write and scan.
+
+---
+
 # SynaBun v.2.0.7
 
 2.0.7 brings the SynaBun desktop app for macOS, Windows and Linux, with updates that install themselves and a Windows installer that shows every step. SynaBun now finds every installed Claude Code, Codex and OpenCode the same way and installs a missing one with one click, you can sign in from the Claude and Codex panels, and the WhatsApp Assistant can send you files and understand voice notes.

package/README.md

@@ -159,7 +159,7 @@ Everything SynaBun stores is in one folder outside the app: `~/.synabun` on macO
 
 ## Links
 
-- [Changelog](./CHANGELOG.md): what is new in 2.0.7 and before
+- [Changelog](./CHANGELOG.md): what is new in 2.0.9 and before
 - [Security](./SECURITY.md): security model and how to report a vulnerability
 - [Contributing](./CONTRIBUTING.md): bug reports and feature requests are welcome as [issues](https://github.com/danilokhury/Synabun/issues); pull requests are not accepted
 - [Website](https://synabun.ai), [docs](https://synabun.ai/docs) and [blog](https://synabun.ai/blog)

package/hooks/claude-code/post-plan.mjs

@@ -31,7 +31,7 @@ import { dirname, join, basename } from 'node:path';
 import { fileURLToPath, pathToFileURL } from 'node:url';
 import { createHash } from 'node:crypto';
 import { withStateLock, writeJsonAtomic, planMemoryKey } from './state.mjs';
-import { detectProject, getMcpCategoriesPath, MCP_DATA_DIR, DATA_DIR, readStdin, hookBudget, hookJudge, clipForJudge, isTemporaryChat } from './shared.mjs';
+import { detectProject, ensureCategories, FEATURE_CATEGORIES, DATA_DIR, readStdin, hookBudget, hookJudge, clipForJudge, isTemporaryChat } from './shared.mjs';
 
 // Cross-platform safety: catch uncaught errors and output valid hook JSON
 process.on('uncaughtException', () => { try { process.stdout.write('{}'); } catch {} process.exit(0); });
@@ -356,38 +356,14 @@ function findLatestPlan() {
 
 // ─── Category management ───
 
+// "plans" and "plans-<project>" are made by the first plan stored (a fresh install has neither).
 function ensureProjectCategory(project) {
   const categoryName = `plans-${project}`;
-  const catPath = getMcpCategoriesPath();
-
   try {
-    const data = JSON.parse(readFileSync(catPath, 'utf-8'));
-    const categories = data.categories || [];
-
-    if (categories.some((c) => c.name === categoryName)) {
-      return categoryName;
-    }
-
-    if (!categories.some((c) => c.name === 'plans')) {
-      categories.push({
-        name: 'plans',
-        description: 'Implementation plans stored after plan mode approval. Sub-categorized by project name.',
-        is_parent: true,
-        color: '#06d6a0',
-        created_at: new Date().toISOString(),
-      });
-    }
-
-    categories.push({
-      name: categoryName,
-      description: `Implementation plans for ${project} project`,
-      parent: 'plans',
-      created_at: new Date().toISOString(),
-    });
-
-    data.categories = categories;
-    writeFileSync(catPath, JSON.stringify(data, null, 2), 'utf-8');
-
+    ensureCategories([
+      { name: 'plans', description: FEATURE_CATEGORIES.plans.description, is_parent: true, color: '#06d6a0' },
+      { name: categoryName, description: `Implementation plans for ${project} project`, parent: 'plans' },
+    ]);
     return categoryName;
   } catch {
     return 'plans';

package/hooks/claude-code/session-start.mjs

@@ -33,7 +33,7 @@ import { execSync } from 'node:child_process';
 import { dirname, join } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { homedir } from 'node:os';
-import { getHookFeatures, detectProject, ensureProjectCategories, cleanupStaleLoops, cleanupStalePendingRemember, cleanupStaleFiles, appendCapped, DATA_DIR, isTemporaryChat, niUrl, greetingSurface, greetingOff, GREETING_NOTE_DIR } from './shared.mjs';
+import { getHookFeatures, detectProject, cleanupStaleLoops, cleanupStalePendingRemember, cleanupStaleFiles, appendCapped, DATA_DIR, isTemporaryChat, niUrl, greetingSurface, greetingOff, GREETING_NOTE_DIR } from './shared.mjs';
 
 // CC updates (especially when installer runs as root) can wipe ~/.claude.json
 // or strip mcpServers.SynaBun, leaving the side panel/CLI with MCP disabled
@@ -228,9 +228,6 @@ async function main() {
     } catch { /* ok */ }
   }
 
-  // Ensure all registered projects have their default category trees
-  try { withStateLock(() => ensureProjectCategories()); } catch { /* non-critical */ }
-
   // Self-heal SynaBun MCP registration (CC updates can strip it)
   healSynaBunMcp();
 

package/hooks/claude-code/shared.mjs

@@ -1031,15 +1031,21 @@ export function buildCategoryTree(categories) {
 }
 
 // --- Auto-category creation ---
+// A fresh install has no categories. The only ones made without being asked are a
+// project's defaults (when the project is added) and a feature's own category (the
+// first time that feature saves into it).
 
 /**
- * Standalone categories required by hooks. Always created regardless of projects.
+ * Categories features save into by name, created on first save, never earlier.
+ * The hooks' and the Neural Interface's share of mcp-server/src/services/categories.ts
+ * FEATURE_CATEGORIES: keep the descriptions the same.
  */
-const STANDALONE_DEFAULTS = [
-  { name: 'conversations', description: 'Session summaries and conversation indexing' },
-  { name: 'communication-style', description: 'User communication patterns and preferences' },
-  { name: 'plans', description: 'Implementation plans stored after plan mode approval', is_parent: true, color: '#06d6a0' },
-];
+export const FEATURE_CATEGORIES = {
+  conversations: { description: 'Indexed conversation sessions with compacted summaries for cross-session recall: session metadata (date, branch, session id) and topic summaries, so past conversations can be found by asking for them.' },
+  'communication-style': { description: 'How the user communicates and works: patterns in how they give instructions, correct, decide and signal frustration, and their stated preferences.' },
+  plans: { description: 'Implementation plans stored after plan mode approval, one child category per project.', is_parent: true },
+  uncategorized: { description: 'Fallback for memories stored without a category.' },
+};
 
 /**
  * Default child categories for every registered project.
@@ -1052,90 +1058,118 @@ const PROJECT_CHILDREN = [
   { suffix: 'config', description: 'Configuration, deployment, environment, and infrastructure' },
 ];
 
+/** A project's parent category name: the label normalized, cut to 16 so children stay within 30 chars (16 + 1 + 12 = 29). */
+export function projectCategoryLabel(label) {
+  let name = normalizeLabel(String(label || ''));
+  if (name.length > 16) name = name.slice(0, 16).replace(/-$/, '');
+  return name;
+}
+
 /**
- * Ensure all registered projects have a parent category with default children,
- * and that standalone hook-required categories exist.
+ * Add the categories in `defs` that are missing, in order (parents first), to the
+ * MCP server's categories file (no connection suffix), whose watcher refreshes the
+ * tool schemas. A missing file is an empty list; an unreadable one is left alone.
+ * `mutate(categories, now)` may push more entries and return the names it created.
  *
- * Writes to the MCP server's categories file (no connection suffix) so the
- * MCP server's file watcher picks up changes and refreshes tool schemas.
- *
- * Idempotent: only adds missing categories, never modifies or removes existing ones.
+ * Idempotent: only adds missing categories, never modifies or removes existing ones
+ * (a project parent that exists without the flag is marked `is_parent` so its
+ * children can sit under it).
  *
  * @returns {{ created: string[], total: number }}
  */
-export function ensureProjectCategories() {
-  const projects = loadRegisteredProjects();
+function addMissingCategories(mutate) {
   const catPath = getMcpCategoriesPath();
-
-  let data;
-  try {
-    data = JSON.parse(readFileSync(catPath, 'utf-8'));
-  } catch {
-    data = { version: 1, categories: [] };
+  let data = { version: 1, categories: [] };
+  if (existsSync(catPath)) {
+    try { data = JSON.parse(readFileSync(catPath, 'utf-8')); } catch { return { created: [], total: 0 }; }
+    if (!data || !Array.isArray(data.categories)) return { created: [], total: 0 };
   }
+  const categories = data.categories;
+  const created = mutate(categories, new Date().toISOString());
+  if (created.length > 0) {
+    data.version = data.version || 1;
+    mkdirSync(dirname(catPath), { recursive: true });
+    writeFileSync(catPath, JSON.stringify(data, null, 2), 'utf-8');
+  }
+  return { created, total: categories.length };
+}
 
-  const categories = data.categories || [];
-  const existingNames = new Set(categories.map((c) => c.name));
-  const created = [];
-  const now = new Date().toISOString();
-
-  // 1. Ensure standalone defaults exist
-  for (const def of STANDALONE_DEFAULTS) {
-    if (!existingNames.has(def.name)) {
-      const cat = { name: def.name, description: def.description, created_at: now };
-      if (def.is_parent) cat.is_parent = true;
+/**
+ * Create categories the first time something saves into them.
+ * `defs`: [{ name, description, parent?, is_parent?, color? }], parents first. A
+ * parent is attached only when it exists (or is created by an earlier def).
+ *
+ * @returns {{ created: string[], total: number }}
+ */
+export function ensureCategories(defs) {
+  return addMissingCategories((categories, now) => {
+    const names = new Set(categories.map((c) => c.name));
+    const created = [];
+    for (const def of defs || []) {
+      if (!def?.name || names.has(def.name)) continue;
+      const cat = { name: def.name, description: def.description || def.name, created_at: now };
+      if (def.parent && names.has(def.parent)) cat.parent = def.parent;
+      else if (def.is_parent) cat.is_parent = true;
       if (def.color) cat.color = def.color;
       categories.push(cat);
-      existingNames.add(def.name);
+      names.add(def.name);
       created.push(def.name);
     }
-  }
-
-  // 2. Ensure project parents + children exist
-  for (const proj of projects) {
-    let label = normalizeLabel(proj.label);
-    // Truncate to 16 chars so children stay within 30-char limit (16 + 1 + 12 = 29)
-    if (label.length > 16) label = label.slice(0, 16).replace(/-$/, '');
-
-    // Ensure parent exists
-    if (!existingNames.has(label)) {
-      categories.push({
-        name: label,
-        description: `Knowledge and context for the ${proj.label} project`,
-        is_parent: true,
-        created_at: now,
-      });
-      existingNames.add(label);
-      created.push(label);
-    } else {
-      // Parent exists — ensure it has is_parent flag
-      const existing = categories.find((c) => c.name === label);
-      if (existing && !existing.is_parent) existing.is_parent = true;
-    }
+    return created;
+  });
+}
 
-    // Ensure each default child exists
-    for (const child of PROJECT_CHILDREN) {
-      const childName = `${label}-${child.suffix}`;
-      if (!existingNames.has(childName)) {
+/**
+ * Create a project's parent category with the default children, once: at the moment
+ * the project is registered (the Neural Interface's add-project route, the only
+ * writer of the registry). Never called for a project that was already registered,
+ * so a default category the user deleted stays deleted.
+ *
+ * @param {Array<{ label: string }>} projects — the project(s) just registered
+ * @returns {{ created: string[], total: number }}
+ */
+export function ensureProjectCategories(projects) {
+  return addMissingCategories((categories, now) => {
+    const existingNames = new Set(categories.map((c) => c.name));
+    const created = [];
+    for (const proj of projects || []) {
+      if (!proj?.label) continue;
+      const label = projectCategoryLabel(proj.label);
+      if (!label) continue;
+
+      // Ensure parent exists
+      if (!existingNames.has(label)) {
         categories.push({
-          name: childName,
-          description: `${child.description} for ${proj.label}`,
-          parent: label,
+          name: label,
+          description: `Knowledge and context for the ${proj.label} project`,
+          is_parent: true,
           created_at: now,
         });
-        existingNames.add(childName);
-        created.push(childName);
+        existingNames.add(label);
+        created.push(label);
+      } else {
+        // Parent exists — ensure it has is_parent flag
+        const existing = categories.find((c) => c.name === label);
+        if (existing && !existing.is_parent && !existing.parent) existing.is_parent = true;
       }
-    }
-  }
 
-  // Only write if we created something new
-  if (created.length > 0) {
-    data.categories = categories;
-    writeFileSync(catPath, JSON.stringify(data, null, 2), 'utf-8');
-  }
-
-  return { created, total: categories.length };
+      // Ensure each default child exists
+      for (const child of PROJECT_CHILDREN) {
+        const childName = `${label}-${child.suffix}`;
+        if (!existingNames.has(childName)) {
+          categories.push({
+            name: childName,
+            description: `${child.description} for ${proj.label}`,
+            parent: label,
+            created_at: now,
+          });
+          existingNames.add(childName);
+          created.push(childName);
+        }
+      }
+    }
+    return created;
+  });
 }
 
 /**