brainjar 0.3.691 → 0.3.694

package/brainjar.js

@@ -107,7 +107,7 @@ var CLI_VERSION, CACHE, DAY;
 var init_version_check = __esm({
   "packages/cli/src/version-check.ts"() {
     "use strict";
-    CLI_VERSION = "0.3.691";
+    CLI_VERSION = "0.3.694";
     CACHE = path.join(os.homedir(), ".brainjar", "version-check.json");
     DAY = 864e5;
   }
@@ -5665,6 +5665,30 @@ function findEnvFile(startDir = process.cwd()) {
     dir = parent;
   }
 }
+function projectsPath() {
+  return path2.join(os2.homedir(), ".brainjar", "projects.json");
+}
+function projectKey(root) {
+  return root.replace(/\\/g, "/").replace(/\/+$/, "").toLowerCase();
+}
+function readProjects(filePath = projectsPath()) {
+  try {
+    const parsed = JSON.parse(readFileSync2(filePath, "utf8"));
+    return parsed && typeof parsed === "object" ? parsed : {};
+  } catch {
+    return {};
+  }
+}
+function projectLink(root, filePath = projectsPath()) {
+  const link = readProjects(filePath)[projectKey(root)];
+  return link && typeof link.brainId === "string" ? link : null;
+}
+function writeProjectLink(root, link, filePath = projectsPath()) {
+  const all = readProjects(filePath);
+  all[projectKey(root)] = link;
+  mkdirSync2(path2.dirname(filePath), { recursive: true });
+  writeFileSync2(filePath, JSON.stringify(all, null, 2) + "\n", "utf8");
+}
 function userConfigPath() {
   return path2.join(os2.homedir(), ".brainjar", "config");
 }
@@ -5995,17 +6019,6 @@ var init_vector = __esm({
 });
 
 // packages/db/src/repository.ts
-async function brainForProject(root, pool2 = getPool()) {
-  const normalized = root.replace(/\\/g, "/").replace(/\/+$/, "").toLowerCase();
-  const r = await pool2.query(
-    `SELECT brain_id FROM source
-     WHERE kind = 'git_local'
-       AND lower(regexp_replace(replace(config->>'cwd', '\\', '/'), '/+$', '')) = $1
-     ORDER BY created_at DESC LIMIT 1`,
-    [normalized]
-  );
-  return r.rows[0]?.brain_id ?? null;
-}
 async function getBrain(id, pool2 = getPool()) {
   return (await pool2.query("SELECT * FROM brain WHERE id = $1", [id])).rows[0] ?? null;
 }
@@ -6102,17 +6115,6 @@ var init_repository = __esm({
         const existing = (await this.listSources()).find((s) => s.kind === kind);
         return existing ?? await this.createSource(kind, name);
       }
-      /**
-       * The git_local source for THIS root (normalized like brainForProject), or null. One
-       * Brain can hold many checkouts; matching "any git_local" silently swallowed every root
-       * after the first (found 2026-08-21 via the benchmark's silent push).
-       */
-      async gitLocalSource(root) {
-        const normalized = root.replace(/\\/g, "/").replace(/\/+$/, "").toLowerCase();
-        return (await this.listSources()).find(
-          (s) => s.kind === "git_local" && String(s.config.cwd ?? "").replace(/\\/g, "/").replace(/\/+$/, "").toLowerCase() === normalized
-        ) ?? null;
-      }
       async listSources() {
         return (await this.pool.query(
           "SELECT * FROM source WHERE brain_id = $1 ORDER BY created_at",
@@ -12602,12 +12604,25 @@ async function repoRoot(cwd = process.cwd()) {
 function repoName(root) {
   return path5.basename(root) || "project";
 }
-async function resolveCaptureBrain(root) {
+async function mainRepoRoot(root) {
   try {
-    return await brainForProject(await repoRoot(root));
+    const { stdout } = await run2(
+      "git",
+      ["rev-parse", "--path-format=absolute", "--git-common-dir"],
+      { cwd: root, windowsHide: true }
+    );
+    const common = path5.resolve(root, stdout.trim());
+    if (path5.basename(common) === ".git") return path5.dirname(common);
   } catch {
-    return null;
   }
+  return root;
+}
+async function captureProject(root, filePath) {
+  const top = await repoRoot(root);
+  return projectLink(top, filePath) ?? projectLink(await mainRepoRoot(top), filePath);
+}
+async function resolveCaptureBrain(root, filePath) {
+  return (await captureProject(root, filePath))?.brainId ?? null;
 }
 async function transcriptFiles(root) {
   const encoded = root.replace(/[:\\/]/g, "-");
@@ -12790,6 +12805,7 @@ var init_bootstrap = __esm({
   "packages/ingest/src/bootstrap.ts"() {
     "use strict";
     init_src2();
+    init_src();
     init_sync();
     init_extraction();
     init_structure();
@@ -15082,11 +15098,14 @@ function serverUrl() {
     ""
   );
 }
+function notConnected(root) {
+  return `brainjar: no Brain is connected to ${root} on this machine. Run \`npx brainjar init --brain <id>\` there (the id is under Settings > Connect).`;
+}
 async function captureApi(pathAndQuery, init2 = {}) {
   const token = loadEnv().BRAINJAR_TOKEN?.trim();
   if (!token) {
-    throw new Error(
-      "BRAINJAR_TOKEN is not set \u2014 create a token in the web app (setup wizard or Settings > API tokens) and add it to ~/.brainjar/config or the project .env"
+    throw new TokenError(
+      "BRAINJAR_TOKEN is not set. Create a token in the web app (setup wizard or Settings > Connect) and run `npx brainjar init --brain <id> --token <token>` once on this machine."
     );
   }
   const res = await fetch(serverUrl() + pathAndQuery, {
@@ -15098,6 +15117,7 @@ async function captureApi(pathAndQuery, init2 = {}) {
     ...init2.body !== void 0 ? { body: JSON.stringify(init2.body) } : {}
   });
   const body = await res.json().catch(() => null);
+  if (res.status === 401) throw new TokenError(TOKEN_HELP);
   if (!res.ok) {
     throw new Error(
       body?.error ?? `BrainJar server responded ${res.status} (${serverUrl()})`
@@ -15105,10 +15125,14 @@ async function captureApi(pathAndQuery, init2 = {}) {
   }
   return body;
 }
+var TokenError, TOKEN_HELP;
 var init_api_client = __esm({
   "packages/cli/src/api-client.ts"() {
     "use strict";
     init_src();
+    TokenError = class extends Error {
+    };
+    TOKEN_HELP = "BrainJar token revoked or invalid. Create a new token under Account in the web app, then run `npx brainjar init --brain <id> --token <token>` once in any project on this machine.";
   }
 });
 
@@ -15171,12 +15195,10 @@ ${BRIEF_END}
 async function refreshBrief(cwd) {
   if (loadEnv().BRAINJAR_NO_BRIEF === "1") return "skipped";
   const root = await repoRoot(cwd);
-  const project = await captureApi(
-    `/capture/project?root=${encodeURIComponent(root)}`
-  );
-  if (!project.brainId) return "skipped";
+  const link = await captureProject(root);
+  if (!link) return "skipped";
   const { text } = await captureApi(
-    `/capture/brief?brain=${project.brainId}`
+    `/capture/brief?brain=${link.brainId}`
   );
   if (!text) return "skipped";
   const file = path15.join(root, BRIEF_FILE);
@@ -15243,14 +15265,13 @@ async function scanDebtInRepo(root) {
 }
 async function debtMain() {
   const root = await repoRoot(process.cwd());
-  const r = await captureApi(`/capture/debt?root=${encodeURIComponent(root)}`);
-  if (!r.brainId) {
-    console.error(
-      `brainjar: no Brain is connected to ${root} \u2014 run \`npx brainjar init\``
-    );
+  const link = await captureProject(root);
+  if (!link) {
+    console.error(notConnected(root));
     process.exitCode = 1;
     return;
   }
+  const r = await captureApi(`/capture/debt?brain=${link.brainId}`);
   if (r.entries.length === 0) {
     console.log(
       "No ponytail debt on record. Either disciplined or undocumented."
@@ -16382,7 +16403,8 @@ __export(hook_exports, {
   hookMain: () => hookMain,
   parseHookArgs: () => parseHookArgs,
   readSpool: () => readSpool,
-  spoolPath: () => spoolPath
+  spoolPath: () => spoolPath,
+  staleSpools: () => staleSpools
 });
 import {
   appendFileSync,
@@ -16426,6 +16448,34 @@ function pruneSpool(dir, keep, maxAgeMs = 7 * 864e5) {
   } catch {
   }
 }
+function staleSpools(dir, keep, minAgeMs = 36e5) {
+  try {
+    return readdirSync(dir).map((f) => path17.join(dir, f)).filter(
+      (file) => file !== keep && Date.now() - statSync2(file).mtimeMs > minAgeMs
+    ).sort();
+  } catch {
+    return [];
+  }
+}
+async function linkForSpool(file) {
+  const cwd = readSpool(file).find((e) => e.cwd)?.cwd;
+  return cwd ? captureProject(await repoRoot(cwd)) : null;
+}
+async function shipSpool(file, link) {
+  const events = readSpool(file);
+  if (!events.length) return;
+  const r = await captureApi("/capture/events", {
+    method: "POST",
+    body: {
+      brain: link.brainId,
+      events,
+      author: loadEnv().BRAINJAR_AUTHOR?.trim() || null
+    }
+  });
+  console.error(
+    `brainjar: session captured \u2014 ${r.prompts ?? 0} intents, ${r.failures ?? 0} failures, ${(r.skippedNoise ?? 0) + (r.skippedFailures ?? 0)} noise skipped` + (r.consolidated ? `, ${r.consolidated} product facts` : "")
+  );
+}
 function parseHookArgs(argv) {
   const eventFlag = argv.indexOf("--event");
   const eventIndex = eventFlag >= 0 ? eventFlag + 1 : -1;
@@ -16462,28 +16512,22 @@ async function hookMain(argv) {
     }
     if (!out.flush) return;
     const root = await repoRoot(out.cwd ?? process.cwd());
-    const events = existsSync12(file) ? readSpool(file) : [];
-    if (events.length) {
-      const r = await captureApi("/capture/events", {
-        method: "POST",
-        body: {
-          root,
-          events,
-          author: loadEnv().BRAINJAR_AUTHOR?.trim() || null
-        }
-      });
-      if (!r.brainId) {
-        console.error(
-          `brainjar: no Brain is connected to ${root} \u2014 run \`npx brainjar init\` (skipping capture)`
-        );
-      } else {
-        console.error(
-          `brainjar: session captured \u2014 ${r.prompts ?? 0} intents, ${r.failures ?? 0} failures, ${(r.skippedNoise ?? 0) + (r.skippedFailures ?? 0)} noise skipped` + (r.consolidated ? `, ${r.consolidated} product facts` : "")
-        );
-      }
+    const link = await captureProject(root);
+    if (!link) {
+      console.error(notConnected(root));
+      if (out.end) rmSync(file, { force: true });
+      return;
     }
+    if (existsSync12(file)) await shipSpool(file, link);
     if (out.end) rmSync(file, { force: true });
-    pruneSpool(path17.dirname(file), file);
+    const dir = path17.dirname(file);
+    for (const other of staleSpools(dir, file)) {
+      const otherLink = await linkForSpool(other);
+      if (!otherLink) continue;
+      await shipSpool(other, otherLink);
+      rmSync(other, { force: true });
+    }
+    pruneSpool(dir, file);
     await syncRepo(root);
   } catch (e) {
     console.error("brainjar hook:", e instanceof Error ? e.message : e);
@@ -16518,13 +16562,12 @@ function capTranscript(text) {
 }
 async function syncRepo(root) {
   try {
-    const project = await captureApi(`/capture/project?root=${encodeURIComponent(root)}`);
-    if (!project.brainId) {
-      console.error(
-        `brainjar: no Brain is connected to ${root} \u2014 run \`npx brainjar init\` (skipping capture)`
-      );
+    const link = await captureProject(root);
+    if (!link) {
+      console.error(notConnected(root));
       return;
     }
+    const project = await captureApi(`/capture/project?brain=${link.brainId}&source=${link.sourceId}`);
     if (project.sourceId) {
       const connector = createConnector("git_local", { cwd: root }, {});
       const artifacts = await connector.sync(project.cursor ?? void 0);
@@ -16534,7 +16577,7 @@ async function syncRepo(root) {
           {
             method: "POST",
             body: {
-              root,
+              brain: link.brainId,
               sourceId: project.sourceId,
               artifacts,
               cursor: maxUpdatedAt(artifacts) ?? project.cursor
@@ -16549,7 +16592,7 @@ async function syncRepo(root) {
           const graph = await scanStructure(root);
           await captureApi("/capture/structure", {
             method: "POST",
-            body: { root, graph }
+            body: { brain: link.brainId, graph }
           });
         }
       }
@@ -16559,7 +16602,10 @@ async function syncRepo(root) {
       const entries = await scanDebtInRepo2(root);
       const r = await captureApi(
         "/capture/debt",
-        { method: "POST", body: { root, entries } }
+        {
+          method: "POST",
+          body: { brain: link.brainId, source: link.sourceId, entries }
+        }
       );
       if (r.added || r.resolved)
         console.error(
@@ -16635,13 +16681,23 @@ async function init(argv) {
     return 1;
   }
   step(2, "Connecting the project Brain\u2026");
+  const known = await captureProject(root);
+  const reuse = known && (!brainFlag || known.brainId === brainFlag) ? known : null;
   const conn = await captureApi("/capture/connect", {
     method: "POST",
-    body: { root, name, ...brainFlag ? { brainId: brainFlag } : {} }
+    body: {
+      name,
+      ...brainFlag ? { brainId: brainFlag } : reuse ? { brainId: reuse.brainId } : {},
+      ...reuse ? { sourceId: reuse.sourceId } : {}
+    }
   });
   ok(
     conn.createdBrain ? `created Brain "${name}" (${conn.brainId})` : `reusing Brain "${name}" (${conn.brainId})`
   );
+  writeProjectLink(root, { brainId: conn.brainId, sourceId: conn.sourceId });
+  ok(
+    `folder linked to the Brain in ${projectsPath()} (the path stays on this machine)`
+  );
   if (serverFlag || tokenFlag) {
     writeUserConfig({
       ...serverFlag ? { BRAINJAR_SERVER: serverFlag } : {},
@@ -16653,7 +16709,7 @@ async function init(argv) {
   const graph = await scanStructure(root);
   const structure = await captureApi(
     "/capture/structure",
-    { method: "POST", body: { root, graph } }
+    { method: "POST", body: { brain: conn.brainId, graph } }
   );
   const connector = createConnector("git_local", { cwd: root }, {});
   const artifacts = await connector.sync(conn.cursor ?? void 0);
@@ -16665,7 +16721,7 @@ async function init(argv) {
       {
         method: "POST",
         body: {
-          root,
+          brain: conn.brainId,
           sourceId: conn.sourceId,
           artifacts,
           cursor: maxUpdatedAt(artifacts) ?? conn.cursor
@@ -16695,7 +16751,7 @@ async function init(argv) {
         if (truncated) truncatedCount++;
         const r = await captureApi("/capture/transcript", {
           method: "POST",
-          body: { root, text, author, backfill: true }
+          body: { brain: conn.brainId, text, author, backfill: true }
         });
         prompts += r.prompts;
         failures += r.failures;
@@ -16738,7 +16794,7 @@ async function init(argv) {
     ok("skipped (server unreachable) \u2014 the sync hook will add it");
   }
   const final = await captureApi(
-    `/capture/project?root=${encodeURIComponent(root)}`
+    `/capture/project?brain=${conn.brainId}&source=${conn.sourceId}`
   );
   console.log(
     `
@@ -16794,6 +16850,7 @@ async function constraintsMain(argv) {
   const hook = argv.includes("--hook");
   const brainFlag = argv[argv.indexOf("--brain") + 1];
   const brainOverride = argv.includes("--brain") ? brainFlag ?? null : null;
+  const envelope = argv.includes("--copilot") ? copilotContextEnvelope : argv.includes("--cline") ? clineContextEnvelope : argv.includes("--plain") ? (text) => text : sessionStartEnvelope;
   try {
     let root;
     if (hook) {
@@ -16807,21 +16864,17 @@ async function constraintsMain(argv) {
     } else {
       root = await repoRoot();
     }
-    const q = new URLSearchParams({ root, limit: "5" });
-    if (brainOverride) q.set("brain", brainOverride);
-    const r = await captureApi(
-      `/capture/constraints?${q}`
-    );
-    if (!r.brainId) {
+    const brainId = brainOverride ?? (await captureProject(root))?.brainId;
+    if (!brainId) {
       if (!hook) {
-        console.error(
-          `brainjar: no Brain is connected to ${root}. Pass --brain <id> or run \`npx brainjar init\` first.`
-        );
+        console.error(notConnected(root));
         process.exitCode = 1;
       }
       return;
     }
-    const envelope = argv.includes("--copilot") ? copilotContextEnvelope : argv.includes("--cline") ? clineContextEnvelope : argv.includes("--plain") ? (text) => text : sessionStartEnvelope;
+    const r = await captureApi(
+      `/capture/constraints?brain=${encodeURIComponent(brainId)}&limit=5`
+    );
     if (r.text) console.log(hook ? envelope(r.text) : r.text);
     else if (hook && argv.includes("--cline")) console.log(CLINE_REPLY);
     else if (!hook)
@@ -16834,7 +16887,12 @@ async function constraintsMain(argv) {
       }
     }
   } catch (e) {
-    console.error("brainjar constraints:", e);
+    if (hook && e instanceof TokenError) console.log(envelope(e.message));
+    else
+      console.error(
+        "brainjar constraints:",
+        e instanceof Error ? e.message : e
+      );
     if (!hook) process.exitCode = 1;
   }
 }
@@ -16896,22 +16954,27 @@ async function runDoctor(root, opts = {}) {
       `${serverUrl()} unreachable (${String(e).slice(0, 120)})`
     );
   }
+  const link = await captureProject(root);
   if (serverOk) {
     try {
-      const project = await captureApi(`/capture/project?root=${encodeURIComponent(root)}`);
+      const project = await captureApi(
+        link ? `/capture/project?brain=${link.brainId}&source=${link.sourceId}` : "/capture/project"
+      );
       add("token", true, "accepted");
       add(
         "brain",
         project.brainId !== null,
-        project.brainId !== null ? `${project.brainId} (${project.objects ?? 0} memory objects)` : "no Brain connected to this repo. Run npx brainjar init"
+        project.brainId !== null ? `${project.brainId} (${project.objects ?? 0} memory objects)` : "not connected on this machine. Run npx brainjar init --brain <id>"
       );
     } catch (e) {
-      add(
-        "token",
-        false,
-        String(e instanceof Error ? e.message : e).slice(0, 160)
-      );
-      add("brain", false, "skipped (token rejected)");
+      const msg = String(e instanceof Error ? e.message : e).slice(0, 200);
+      if (e instanceof TokenError) {
+        add("token", false, msg);
+        add("brain", false, "skipped (token rejected)");
+      } else {
+        add("token", true, "accepted");
+        add("brain", false, msg);
+      }
     }
   } else {
     add("token", false, "skipped (server unreachable)");
@@ -17042,11 +17105,9 @@ async function walkCandidates(root) {
 }
 async function deepscanMain() {
   const root = await repoRoot();
-  const project = await captureApi(`/capture/project?root=${encodeURIComponent(root)}`);
-  if (!project.brainId || !project.sourceId) {
-    console.error(
-      `brainjar: no Brain is connected to ${root} \u2014 run \`npx brainjar init\` first`
-    );
+  const project = await captureProject(root);
+  if (!project) {
+    console.error(notConnected(root));
     process.exitCode = 1;
     return;
   }
@@ -17090,7 +17151,7 @@ async function deepscanMain() {
       {
         method: "POST",
         body: {
-          root,
+          brain: project.brainId,
           sourceId: project.sourceId,
           artifacts: chunk,
           // Only the final chunk kicks the server-side synthesis: one scan per run.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brainjar",
-  "version": "0.3.691",
+  "version": "0.3.694",
   "description": "BrainJar CLI: turn a repository into a live, self-documenting Brain.",
   "type": "module",
   "bin": {