brainjar 0.3.702 → 0.3.703

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.702";
+    CLI_VERSION = "0.3.703";
     CACHE = path.join(os.homedir(), ".brainjar", "version-check.json");
     DAY = 864e5;
   }
@@ -4587,7 +4587,7 @@ var require_pg_pool = __commonJS({
     function throwOnDoubleRelease() {
       throw new Error("Release called on client which has already been released to the pool.");
     }
-    function promisify5(Promise2, callback) {
+    function promisify6(Promise2, callback) {
       if (callback) {
         return { callback, result: void 0 };
       }
@@ -4725,7 +4725,7 @@ var require_pg_pool = __commonJS({
           const err = new Error("Cannot use a pool after calling end on the pool");
           return cb ? cb(err) : this.Promise.reject(err);
         }
-        const response = promisify5(this.Promise, cb);
+        const response = promisify6(this.Promise, cb);
         const result = response.result;
         if (this._isFull() || this._idle.length) {
           if (this._idle.length) {
@@ -4910,7 +4910,7 @@ var require_pg_pool = __commonJS({
       }
       query(text, values, cb) {
         if (typeof text === "function") {
-          const response2 = promisify5(this.Promise, text);
+          const response2 = promisify6(this.Promise, text);
           setImmediate(function() {
             return response2.callback(new Error("Passing a function as the first parameter to pool.query is not supported"));
           });
@@ -4920,7 +4920,7 @@ var require_pg_pool = __commonJS({
           cb = values;
           values = void 0;
         }
-        const response = promisify5(this.Promise, cb);
+        const response = promisify6(this.Promise, cb);
         cb = response.callback;
         this.connect((err, client) => {
           if (err) {
@@ -4965,7 +4965,7 @@ var require_pg_pool = __commonJS({
           return cb ? cb(err) : this.Promise.reject(err);
         }
         this.ending = true;
-        const promised = promisify5(this.Promise, cb);
+        const promised = promisify6(this.Promise, cb);
         this._endCallback = promised.callback;
         this._pulseQueue();
         return promised.result;
@@ -15143,13 +15143,20 @@ __export(brief_exports, {
   BRIEF_FILE: () => BRIEF_FILE,
   BRIEF_START: () => BRIEF_START,
   CLAUDE_IMPORT: () => CLAUDE_IMPORT,
+  CURSOR_RULE_FILE: () => CURSOR_RULE_FILE,
+  POINTER: () => POINTER,
   briefMain: () => briefMain,
   claudeMdWithImport: () => claudeMdWithImport,
-  refreshBrief: () => refreshBrief,
-  upsertBriefBlock: () => upsertBriefBlock
+  cursorRule: () => cursorRule,
+  installPointer: () => installPointer,
+  refreshCursorRules: () => refreshCursorRules,
+  upsertBriefBlock: () => upsertBriefBlock,
+  withExcluded: () => withExcluded
 });
-import { readFileSync as readFileSync11, writeFileSync as writeFileSync3, existsSync as existsSync11 } from "node:fs";
+import { readFileSync as readFileSync11, writeFileSync as writeFileSync3, existsSync as existsSync11, mkdirSync as mkdirSync3 } from "node:fs";
 import path15 from "node:path";
+import { execFile as execFile3 } from "node:child_process";
+import { promisify as promisify3 } from "node:util";
 function claudeMdWithImport(existing) {
   let text = existing;
   const start = text.indexOf(BRIEF_START);
@@ -15180,6 +15187,7 @@ function upsertBriefBlock(existing, brief) {
   const block = `${BRIEF_START}
 
 ${defuseMarkers(brief).trimEnd()}
+
 ${BRIEF_END}
 `;
   const start = existing.indexOf(BRIEF_START);
@@ -15192,18 +15200,11 @@ ${BRIEF_END}
   if (!existing.trim()) return block;
   return existing.trimEnd() + "\n\n" + block;
 }
-async function refreshBrief(cwd) {
+function installPointer(root) {
   if (loadEnv().BRAINJAR_NO_BRIEF === "1") return "skipped";
-  const root = await repoRoot(cwd);
-  const link = await captureProject(root);
-  if (!link) return "skipped";
-  const { text } = await captureApi(
-    `/capture/brief?brain=${link.brainId}`
-  );
-  if (!text) return "skipped";
   const file = path15.join(root, BRIEF_FILE);
   const existing = existsSync11(file) ? readFileSync11(file, "utf8") : "";
-  const next = upsertBriefBlock(existing, text);
+  const next = upsertBriefBlock(existing, POINTER);
   if (next !== null) writeFileSync3(file, next);
   const claudeFile = path15.join(root, "CLAUDE.md");
   const claude = existsSync11(claudeFile) ? readFileSync11(claudeFile, "utf8") : "";
@@ -15211,28 +15212,95 @@ async function refreshBrief(cwd) {
   if (claudeNext !== null) writeFileSync3(claudeFile, claudeNext);
   return next !== null || claudeNext !== null ? "updated" : "unchanged";
 }
+function cursorRule(brief) {
+  return [
+    "---",
+    "description: BrainJar session context (generated by brainjar, kept out of git)",
+    "alwaysApply: true",
+    "---",
+    "",
+    brief.trimEnd(),
+    ""
+  ].join("\n");
+}
+function withExcluded(existing, line) {
+  if (existing.split(/\r?\n/).some((l) => l.trim() === line)) return null;
+  const sep = existing.length && !existing.endsWith("\n") ? "\n" : "";
+  return `${existing}${sep}${line}
+`;
+}
+async function refreshCursorRules(root) {
+  if (loadEnv().BRAINJAR_NO_BRIEF === "1") return "skipped";
+  const cursor3 = CAPTURE_TOOLS.find((t) => t.id === "cursor");
+  if (!cursor3?.detect(root)) return "skipped";
+  const link = await captureProject(root);
+  if (!link) return "skipped";
+  const { text } = await captureApi(
+    `/capture/brief?brain=${link.brainId}`
+  );
+  if (!text) return "skipped";
+  const file = path15.join(root, CURSOR_RULE_FILE);
+  const next = cursorRule(text);
+  const changed = !existsSync11(file) || readFileSync11(file, "utf8") !== next;
+  if (changed) {
+    mkdirSync3(path15.dirname(file), { recursive: true });
+    writeFileSync3(file, next);
+  }
+  try {
+    const { stdout } = await run3(
+      "git",
+      ["rev-parse", "--path-format=absolute", "--git-path", "info/exclude"],
+      { cwd: root, windowsHide: true }
+    );
+    const exclude = stdout.trim();
+    const current = existsSync11(exclude) ? readFileSync11(exclude, "utf8") : "";
+    const withLine = withExcluded(current, CURSOR_RULE_FILE);
+    if (withLine !== null) {
+      mkdirSync3(path15.dirname(exclude), { recursive: true });
+      writeFileSync3(exclude, withLine);
+    }
+  } catch {
+  }
+  return changed ? "updated" : "unchanged";
+}
 async function briefMain() {
   try {
-    const result = await refreshBrief(process.cwd());
+    const root = await repoRoot(process.cwd());
+    const link = await captureProject(root);
+    if (!link) {
+      console.error(notConnected(root));
+      process.exitCode = 1;
+      return;
+    }
+    const { text } = await captureApi(
+      `/capture/brief?brain=${link.brainId}`
+    );
     console.log(
-      result === "updated" ? "AGENTS.md brief block updated (CLAUDE.md imports it)." : result === "unchanged" ? "AGENTS.md brief block already current." : "skipped (no connected Brain, empty brief, or BRAINJAR_NO_BRIEF=1)"
+      text || "The Brain has no features yet; the brief fills in as captures land."
     );
   } catch (e) {
     console.error("brainjar brief:", e instanceof Error ? e.message : e);
     process.exitCode = 1;
   }
 }
-var BRIEF_START, BRIEF_END, BRIEF_FILE, CLAUDE_IMPORT;
+var run3, BRIEF_START, BRIEF_END, BRIEF_FILE, CLAUDE_IMPORT, CURSOR_RULE_FILE, POINTER;
 var init_brief = __esm({
   "packages/cli/src/brief.ts"() {
     "use strict";
     init_src3();
     init_src();
     init_api_client();
+    run3 = promisify3(execFile3);
     BRIEF_START = "<!-- brainjar:brief:start -->";
     BRIEF_END = "<!-- brainjar:brief:end -->";
     BRIEF_FILE = "AGENTS.md";
     CLAUDE_IMPORT = "@AGENTS.md";
+    CURSOR_RULE_FILE = ".cursor/rules/brainjar.mdc";
+    POINTER = [
+      "## Memory",
+      "",
+      "This project uses BrainJar as its memory. Before non-trivial work, search it (MCP tool `search_memory`; `get_negative_constraints` before trying an approach that may have failed before). The session context (working discipline, reuse index, project rules, known failures) arrives at session start from the server, never from this file."
+    ].join("\n");
   }
 });
 
@@ -15242,12 +15310,12 @@ __export(debt_exports, {
   debtMain: () => debtMain,
   scanDebtInRepo: () => scanDebtInRepo
 });
-import { execFile as execFile3 } from "node:child_process";
+import { execFile as execFile4 } from "node:child_process";
 import { readFile as readFile11 } from "node:fs/promises";
-import { promisify as promisify3 } from "node:util";
+import { promisify as promisify4 } from "node:util";
 import path16 from "node:path";
 async function scanDebtInRepo(root) {
-  const { stdout } = await run3("git", ["-C", root, "ls-files"], {
+  const { stdout } = await run4("git", ["-C", root, "ls-files"], {
     maxBuffer: 16 * 1048576
   });
   const files = [];
@@ -15286,13 +15354,13 @@ async function debtMain() {
 `);
   }
 }
-var run3;
+var run4;
 var init_debt = __esm({
   "packages/cli/src/debt.ts"() {
     "use strict";
     init_src3();
     init_api_client();
-    run3 = promisify3(execFile3);
+    run4 = promisify4(execFile4);
   }
 });
 
@@ -16409,7 +16477,7 @@ __export(hook_exports, {
 import {
   appendFileSync,
   existsSync as existsSync12,
-  mkdirSync as mkdirSync3,
+  mkdirSync as mkdirSync4,
   readdirSync,
   readFileSync as readFileSync12,
   rmSync,
@@ -16504,7 +16572,7 @@ async function hookMain(argv) {
     if (out.reply) process.stdout.write(out.reply);
     const file = spoolPath(adapter.id, out.sessionId);
     if (out.events.length) {
-      mkdirSync3(path17.dirname(file), { recursive: true });
+      mkdirSync4(path17.dirname(file), { recursive: true });
       appendFileSync(
         file,
         out.events.map((e) => JSON.stringify(clampCaptureEvent(e))).join("\n") + "\n"
@@ -16615,10 +16683,9 @@ async function syncRepo(root) {
     }
   } finally {
     try {
-      const { refreshBrief: refreshBrief2 } = await Promise.resolve().then(() => (init_brief(), brief_exports));
-      const r = await refreshBrief2(root);
-      if (r === "updated")
-        console.error("brainjar: AGENTS.md brief block updated");
+      const { refreshCursorRules: refreshCursorRules2 } = await Promise.resolve().then(() => (init_brief(), brief_exports));
+      if (await refreshCursorRules2(root) === "updated")
+        console.error("brainjar: Cursor rule file refreshed");
     } catch {
     }
   }
@@ -16783,15 +16850,20 @@ async function init(argv) {
   ok(
     gitHook ? "git post-commit hook installed" : "git post-commit hook already present"
   );
-  step(7, "Informed laziness \u2014 the brief block in AGENTS.md\u2026");
+  step(7, "Informed laziness \u2014 the memory pointer in AGENTS.md\u2026");
   try {
-    const { refreshBrief: refreshBrief2 } = await Promise.resolve().then(() => (init_brief(), brief_exports));
-    const r = await refreshBrief2(root);
+    const { installPointer: installPointer2, refreshCursorRules: refreshCursorRules2 } = await Promise.resolve().then(() => (init_brief(), brief_exports));
+    const pointer = installPointer2(root);
     ok(
-      r === "updated" ? "brief block written (discipline core + reuse index, kept current by sync)" : r === "unchanged" ? "brief block already current" : "skipped (empty Brain or BRAINJAR_NO_BRIEF=1) \u2014 sync adds it once features exist"
+      pointer === "updated" ? "AGENTS.md points to the Brain (static, never changes again); the brief itself arrives at every session start" : pointer === "unchanged" ? "AGENTS.md pointer already in place" : "skipped (BRAINJAR_NO_BRIEF=1)"
     );
+    const cursor3 = await refreshCursorRules2(root);
+    if (cursor3 !== "skipped")
+      ok(
+        `Cursor rule file ${cursor3} (.cursor/rules/brainjar.mdc, kept out of git)`
+      );
   } catch {
-    ok("skipped (server unreachable) \u2014 the sync hook will add it");
+    ok("skipped (could not write the pointer)");
   }
   try {
     await captureApi("/capture/connect", {
@@ -16892,13 +16964,6 @@ async function constraintsMain(argv) {
     else if (hook && argv.includes("--cline")) console.log(CLINE_REPLY);
     else if (!hook)
       console.log("No recorded failed approaches or rules for this Brain.");
-    if (hook) {
-      try {
-        const { refreshBrief: refreshBrief2 } = await Promise.resolve().then(() => (init_brief(), brief_exports));
-        await refreshBrief2(root);
-      } catch {
-      }
-    }
   } catch (e) {
     if (hook && e instanceof TokenError) console.log(envelope(e.message));
     else
@@ -16948,8 +17013,8 @@ __export(doctor_exports, {
   renderDoctorReport: () => renderDoctorReport,
   runDoctor: () => runDoctor
 });
-import { execFile as execFile4 } from "node:child_process";
-import { promisify as promisify4 } from "node:util";
+import { execFile as execFile5 } from "node:child_process";
+import { promisify as promisify5 } from "node:util";
 async function runDoctor(root, opts = {}) {
   const checks = [];
   const add = (name, ok2, detail) => checks.push({ name, ok: ok2, detail });
@@ -17019,7 +17084,7 @@ async function runDoctor(root, opts = {}) {
   }
   if (opts.runtime === false) return { checks, ok: checks.every((c) => c.ok) };
   try {
-    const { stdout } = await run4("npx", ["--yes", "tsx", "--version"], {
+    const { stdout } = await run5("npx", ["--yes", "tsx", "--version"], {
       cwd: root,
       shell: true,
       // Windows resolves npx.cmd
@@ -17055,14 +17120,14 @@ brainjar doctor. repo: ${root}
     process.exitCode = 1;
   }
 }
-var run4;
+var run5;
 var init_doctor = __esm({
   "packages/cli/src/doctor.ts"() {
     "use strict";
     init_src3();
     init_api_client();
     init_version_check();
-    run4 = promisify4(execFile4);
+    run5 = promisify5(execFile5);
   }
 });
 
@@ -17352,7 +17417,7 @@ async function main() {
     return;
   }
   try {
-    await run5(cmd, argv);
+    await run6(cmd, argv);
   } finally {
     if (cmd !== "hook" && !argv.includes("--hook")) {
       const { noticeNewerVersion: noticeNewerVersion2 } = await Promise.resolve().then(() => (init_version_check(), version_check_exports));
@@ -17360,7 +17425,7 @@ async function main() {
     }
   }
 }
-async function run5(cmd, argv) {
+async function run6(cmd, argv) {
   switch (cmd) {
     case "brief": {
       const { briefMain: briefMain2 } = await Promise.resolve().then(() => (init_brief(), brief_exports));

package/package.json

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