total-recall-brain 3.28.1 → 3.28.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "total-recall-brain",
-  "version": "3.28.1",
+  "version": "3.28.2",
   "description": "Personal AI system — database-free, SSSS-powered intelligence engine deployable to any POSIX host.",
   "type": "module",
   "workspaces": [

package/src/cli/connect.mjs

@@ -100,9 +100,8 @@ const CLIENTS = {
     label: 'Codex',
     mode: 'symlink',
     target: 'AGENTS.md',
-    // Codex only discovers skills globally under $CODEX_HOME/skills (~/.codex/skills).
-    // There is no project-local skills dir, so this projection is global by necessity.
-    skillsProjection: { scope: 'home', dir: path.join('.codex', 'skills') }
+    // Codex discovers repository skills in <project>/.agents/skills.
+    skillsProjection: { scope: 'project', dir: path.join('.agents', 'skills') }
   },
   antigravity: {
     label: 'Antigravity',
@@ -961,8 +960,7 @@ export default async function connect(args) {
     }
   }
 
-  // Project repo skills as native slash commands via the Agent Skills standard.
-  // Each <agentDir>/skills/<name>/SKILL.md becomes /<name> in the target IDE.
+  // Project repo skills into the target IDE's Agent Skills directory.
   if (preset.skillsProjection) {
     const skills = discoverRepoSkills(agentDir);
     if (skills.length > 0) {
@@ -977,8 +975,8 @@ export default async function connect(args) {
           ? destDir
           : (path.relative(cwd, destDir) || destDir);
         result.notes.push(
-          `  Repo skills projected as slash commands → ${destLabel}/:\n` +
-          fresh.map(r => `    /${r.name}`).join('\n')
+          `  Repo skills projected → ${destLabel}/:\n` +
+          fresh.map(r => `    ${r.name}`).join('\n')
         );
       }
     }

package/src/cli/init.mjs

@@ -600,13 +600,13 @@ export default async function init(args) {
   logStep('3.6/4', 'Ensuring openwiki is present');
   await ensureOpenWiki(brainDir, isProject, opts.dryRun);
 
-  // ── Step 3.7: Project skills as slash commands into the IDEs in use ──
+  // ── Step 3.7: Project skills into the IDEs in use ──
   // Scope matches the brain: `init --project` projects PROJECT skills into the
   // repo's IDE skill dirs for IDEs actually used here (.claude/, .agents/, or
   // the current process); `init` projects GLOBAL skills into installed IDEs'
-  // global skill dirs. Codex (global-only) is opt-in for project skills.
+  // global skill dirs. Codex discovers project skills in .agents/skills.
   const skillScope = isProject ? 'project' : 'global';
-  logStep('3.7/4', `Projecting ${skillScope} skills as slash commands (IDEs in use)`);
+  logStep('3.7/4', `Projecting ${skillScope} skills (IDEs in use)`);
   if (opts.dryRun) {
     const targets = detectActiveSkillTargets({ scope: skillScope, cwd });
     for (const t of targets.filter(t => t.supported)) {
@@ -627,7 +627,7 @@ export default async function init(args) {
           const n = t.results.filter(r => ['linked', 'copied', 'exists', 'source'].includes(r.action)).length;
           logOk(`${t.label}: ${n} skill(s) → ${path.relative(cwd, t.destDir) || t.destDir}/`);
         }
-        log(`  Slash commands: ${skills.map(s => '/' + s.name).join(', ')}`);
+        log(`  Discoverable skills: ${skills.map(s => s.name).join(', ')}`);
         if (available.length > 0) {
           log(`  Also available (opt-in): ${available.map(t => t.clients.join('/')).join(', ')} — \`npx total-recall connect <ide>\``);
         }

package/src/cli/skill-projection.mjs

@@ -2,8 +2,8 @@
  * Scope-aware skill → slash-command projection.
  *
  * A "repo skill" is any <skills-root>/<name>/SKILL.md directory (the Agent
- * Skills standard). Each IDE turns such a directory into a /<name> slash
- * command, but every IDE looks in a *different* place, and the right place
+ * Skills standard). Each IDE discovers skills in a different place, and that
+ * place
  * depends on the *scope* of the skill:
  *
  *   PROJECT skills (authored in <repo>/.agent/skills or <repo>/.agents/skills)
@@ -16,9 +16,9 @@
  *       machine. They are available in every repo.
  *
  * This mirrors the brain model: `init --project` ⇒ project skills; `init`
- * (global) ⇒ global skills. Codex has no project-local skills dir (it only
- * reads ~/.codex/skills globally), so it participates in GLOBAL projection only;
- * pushing project skills to Codex is opt-in via `connect codex`.
+ * (global) ⇒ global skills. Codex discovers project skills in
+ * <repo>/.agents/skills and global skills in ~/.codex/skills. In Codex,
+ * /skills opens the picker and $skill-name explicitly invokes a skill.
  */
 import fs from 'node:fs';
 import os from 'node:os';
@@ -54,9 +54,7 @@ export const IDE_SKILLS = [
     id: 'codex',
     label: 'Codex',
     clients: ['codex'],
-    // Codex only discovers skills globally under ~/.codex/skills. There is no
-    // project-local dir, so project skills are opt-in (namespaced) via connect.
-    project: null,
+    project: { dir: ['.agents', 'skills'], markers: ['.agents', 'AGENTS.md'], env: ['CODEX_HOME'] },
     global:  { dir: ['.codex', 'skills'], markers: ['.codex'] }
   },
   {
@@ -117,7 +115,7 @@ function isStaleGeneratedDir(entryPath) {
 }
 
 /**
- * Put one skill at linkPath so the IDE sees it as /<name>:
+ * Put one skill at linkPath so the IDE can discover it:
  *   1. a symlink RELATIVE to the destination dir — the projection then survives
  *      `git clone`, a moved checkout, or a different home directory (an absolute
  *      link only works on the machine that wrote it);
@@ -149,21 +147,23 @@ function placeSkill(skillDir, linkPath) {
 }
 
 /**
- * Skill source roots, in priority order. The canonical Total Recall location
- * (.agent/skills, singular) wins, but we also scan the Antigravity-native
- * .agents/skills (plural) so a skill authored in either place is discovered.
+ * Skill source roots, in priority order. The Total Recall location
+ * (.agent/skills, singular) wins, followed by repo-authored skills/ and
+ * already-projected .agents/skills. This avoids treating projected links as
+ * the source when the original is available.
  */
 export function skillSourceRoots(agentDir) {
   const roots = [path.join(agentDir, 'skills')];
   const parent = path.dirname(agentDir);
   if (path.basename(agentDir) === '.agent') {
+    roots.push(path.join(parent, 'skills'));
     roots.push(path.join(parent, '.agents', 'skills'));
   }
   return roots;
 }
 
 /**
- * Discover repo skills to expose as slash commands.
+ * Discover repo skills to expose to IDEs.
  * Every <root>/<name>/ directory containing a SKILL.md is a skill. When the
  * same name appears in more than one source root, the canonical root wins.
  */

package/src/cli/status.mjs

@@ -20,13 +20,8 @@ import fs from 'node:fs';
 import crypto from 'node:crypto';
 import { loadQueue } from '../core/research-queue.mjs';
 
-import { agentDir, brainDir, totalRecallToken } from '../core/config.mjs';
-
-const AGENT_DIR = agentDir;
-const BRAIN_CONFIG = path.join(brainDir, 'config', 'brain.json');
-const SYNC_STATE = path.join(brainDir, 'config', 'sync-state.json');
-const CLIENTS_REGISTRY = path.join(brainDir, 'config', 'clients.json');
-const INSTRUCTIONS_FILE = path.join(AGENT_DIR, 'INSTRUCTIONS.md');
+import { totalRecallToken } from '../core/config.mjs';
+import { resolveBrainDir } from './agent-dir.mjs';
 
 function parseArgs(args) {
   const opts = { json: false, brain: null, token: null, help: false };
@@ -55,21 +50,21 @@ function printHelp() {
 `);
 }
 
-function loadBrainConfig() {
-  if (!fs.existsSync(BRAIN_CONFIG)) return null;
-  try { return JSON.parse(fs.readFileSync(BRAIN_CONFIG, 'utf8')); }
+function loadBrainConfig(brainConfigPath) {
+  if (!fs.existsSync(brainConfigPath)) return null;
+  try { return JSON.parse(fs.readFileSync(brainConfigPath, 'utf8')); }
   catch { return null; }
 }
 
-function loadSyncState() {
-  if (!fs.existsSync(SYNC_STATE)) return {};
-  try { return JSON.parse(fs.readFileSync(SYNC_STATE, 'utf8')); }
+function loadSyncState(syncStatePath) {
+  if (!fs.existsSync(syncStatePath)) return {};
+  try { return JSON.parse(fs.readFileSync(syncStatePath, 'utf8')); }
   catch { return {}; }
 }
 
-function loadClientsRegistry() {
-  if (!fs.existsSync(CLIENTS_REGISTRY)) return {};
-  try { return JSON.parse(fs.readFileSync(CLIENTS_REGISTRY, 'utf8'))?.clients || {}; }
+function loadClientsRegistry(clientsRegistryPath) {
+  if (!fs.existsSync(clientsRegistryPath)) return {};
+  try { return JSON.parse(fs.readFileSync(clientsRegistryPath, 'utf8'))?.clients || {}; }
   catch { return {}; }
 }
 
@@ -90,21 +85,31 @@ function sha256(buf) {
   return crypto.createHash('sha256').update(buf).digest('hex');
 }
 
-async function probeBrain(brainUrl, token) {
+async function probeBrain(brainUrl, token, brainId) {
   const headers = {};
   if (token) headers.Authorization = `Bearer ${token}`;
   const out = { reachable: false, instructions_sha256: null, instructions_bytes: null, error: null };
   try {
-    const res = await fetch(`${brainUrl.replace(/\/$/, '')}/api/instructions`, { headers });
+    const url = new URL(`${brainUrl.replace(/\/$/, '')}/api/instructions`);
+    if (brainId) url.searchParams.set('brain', brainId);
+    const res = await fetch(url, { headers });
     if (!res.ok) {
       out.error = `HTTP ${res.status}`;
       return out;
     }
-    const body = await res.json();
+    const contentType = res.headers?.get?.('content-type') || '';
+    const body = contentType.includes('application/json') ? await res.json() : null;
     out.reachable = true;
-    out.instructions_sha256 = body.sha256 || null;
-    out.instructions_bytes = body.bytes || null;
-    out.modified = body.modified || null;
+    if (body) {
+      out.instructions_sha256 = body.sha256 || (body.content ? sha256(body.content) : null);
+      out.instructions_bytes = body.bytes || (body.content ? Buffer.byteLength(body.content) : null);
+      out.modified = body.modified || null;
+    } else {
+      const content = await res.text();
+      out.instructions_sha256 = sha256(content);
+      out.instructions_bytes = Buffer.byteLength(content);
+      out.modified = res.headers?.get?.('last-modified') || null;
+    }
   } catch (err) {
     out.error = err.message;
   }
@@ -115,9 +120,12 @@ export default async function statusCmd(args) {
   const opts = parseArgs(args);
   if (opts.help) { printHelp(); return; }
 
-  const brainConfig = loadBrainConfig();
-  const syncState = loadSyncState();
-  const clientsRegistry = loadClientsRegistry();
+  const brainDir = resolveBrainDir();
+  const agentDir = path.dirname(path.dirname(brainDir));
+  const instructionsFile = path.join(path.dirname(agentDir), 'INSTRUCTIONS.md');
+  const brainConfig = loadBrainConfig(path.join(brainDir, 'config', 'brain.json'));
+  const syncState = loadSyncState(path.join(brainDir, 'config', 'sync-state.json'));
+  const clientsRegistry = loadClientsRegistry(path.join(brainDir, 'config', 'clients.json'));
   const brainUrl = opts.brain || brainConfig?.url || null;
   const token = opts.token || brainConfig?.token || totalRecallToken || null;
 
@@ -175,11 +183,11 @@ export default async function statusCmd(args) {
   } catch {}
 
   let localInstructions = null;
-  if (fs.existsSync(INSTRUCTIONS_FILE)) {
-    const buf = fs.readFileSync(INSTRUCTIONS_FILE);
-    const stat = fs.statSync(INSTRUCTIONS_FILE);
+  if (fs.existsSync(instructionsFile)) {
+    const buf = fs.readFileSync(instructionsFile);
+    const stat = fs.statSync(instructionsFile);
     localInstructions = {
-      path: INSTRUCTIONS_FILE,
+      path: instructionsFile,
       sha256: sha256(buf),
       bytes: stat.size,
       modified: stat.mtime.toISOString()
@@ -188,14 +196,17 @@ export default async function statusCmd(args) {
 
   let remote = null;
   if (brainUrl) {
-    remote = await probeBrain(brainUrl, token);
+    const brainId = brainConfig?.layer === 'project' && brainConfig?.name
+      ? `project:${brainConfig.name}`
+      : null;
+    remote = await probeBrain(brainUrl, token, brainId);
   }
 
   const inSync = !!(localInstructions && remote?.instructions_sha256 &&
     remote.instructions_sha256 === localInstructions.sha256);
 
   const instructionsMtime = localInstructions
-    ? fs.statSync(INSTRUCTIONS_FILE).mtimeMs
+    ? fs.statSync(instructionsFile).mtimeMs
     : null;
   const clientProjections = projectionsStatus(clientsRegistry, instructionsMtime);
 

package/src/core/embeddings.mjs

@@ -61,15 +61,25 @@ let currentDbPath = null;
 const dbVssEnabled = new WeakMap();
 
 /**
- * better-sqlite3 on Linux appends ".so" when the path already ends in ".so",
- * producing "vss0.so.so". Strip known extensions before loadExtension.
+ * better-sqlite3 appends the platform suffix, so a path that already ends in
+ * ".so" reports "vss0.so.so: cannot open shared object file". Strip known
+ * extensions before loadExtension.
+ *
+ * When BOTH attempts fail, rethrow the FIRST error: the second is the artifact
+ * of the appended suffix, and logging it hid the real cause on a Linux host —
+ * "vss0.so.so: cannot open shared object file" while the actual reason was a
+ * missing libblas.so.3 that `ldd vss0.so` names immediately.
  */
 function loadExtensionBare(db, absolutePath) {
   const bare = String(absolutePath).replace(/\.(so|dylib|dll)$/i, '');
   try {
     db.loadExtension(bare);
-  } catch {
-    db.loadExtension(absolutePath);
+  } catch (bareErr) {
+    try {
+      db.loadExtension(absolutePath);
+    } catch {
+      throw bareErr;
+    }
   }
 }