@codewithjuber/forgekit 0.8.0

package/src/brain.js

@@ -0,0 +1,84 @@
+// forge brain — portable, per-repo PROJECT memory. Unlike `recall` (personal, global,
+// Claude-loaded via a guard), brain lives in the repo (.forge/brain/, git-committable)
+// and is INLINED — capped — into the emitted AGENTS.md, so EVERY tool that reads
+// AGENTS.md (Codex/Cursor/Gemini/Aider/Roo/…) shares the same durable facts. Cliff-safe
+// by construction: the inlined index is capped; overflow stays in fact files, never
+// silently truncated the way Claude's native 200-line MEMORY.md is (#39811).
+import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { ledgerFacts, mergeFactSlugs } from "./ledger_read.js";
+import { listStored, add as recallAdd } from "./recall.js";
+
+export const brainStore = (targetRoot = process.cwd()) => join(targetRoot, ".forge", "brain");
+
+// Brain facts shadow into the REPO ledger (.forge/ledger — the sibling of this store,
+// see `forge remember`), so that is where merged teammate facts arrive.
+const brainLedger = (store) => join(dirname(store), "ledger");
+
+/** Store one fact (secret-refused by recall) and rebuild the inlined index. */
+export function remember(store, name, body) {
+  const res = recallAdd(store, name, body);
+  if (res.ok) buildIndex(store);
+  return res;
+}
+
+/** Merged read (P2 read flip): file facts ∪ live repo-ledger facts, file wins on slug. */
+export const list = (store) => mergeFactSlugs(listStored(store), brainLedger(store));
+
+const gistOf = (text) =>
+  text
+    .replace(/^#.*\n/, "")
+    .split("\n")
+    .map((l) => l.trim())
+    .find(Boolean) || "";
+
+/** Build the capped, cliff-safe index inlined into AGENTS.md. Overflow → a pointer.
+ *  Merged view (P2 read flip): teammate facts that arrived in the repo ledger via
+ *  `forge ledger merge` join the index; a local file wins on name collision. */
+export function buildIndex(store, { capItems = 120 } = {}) {
+  const factsDir = join(store, "facts");
+  const facts = existsSync(factsDir)
+    ? readdirSync(factsDir)
+        .filter((f) => f.endsWith(".md"))
+        .sort()
+    : [];
+  const entries = facts.map((file) => ({
+    name: file.replace(/\.md$/, ""),
+    gist: gistOf(readFileSync(join(factsDir, file), "utf8")),
+  }));
+  const seen = new Set(entries.map((e) => e.name));
+  for (const f of ledgerFacts(brainLedger(store))) {
+    if (seen.has(f.slug)) continue;
+    seen.add(f.slug);
+    entries.push({ name: f.slug, gist: gistOf(f.text) });
+  }
+  entries.sort((a, b) => (a.name < b.name ? -1 : a.name > b.name ? 1 : 0));
+  const rows = [];
+  let overflow = 0;
+  for (const e of entries) {
+    if (rows.length >= capItems) {
+      overflow += 1;
+      continue;
+    }
+    rows.push(`- **${e.name}** — ${e.gist.slice(0, 140)}`);
+  }
+  const indexed = rows.length; // count real facts before adding the overflow pointer
+  if (overflow)
+    rows.push(`- _(+${overflow} more facts in .forge/brain/facts/ — open a file for detail)_`);
+  const content = [
+    "## Project memory (Forge brain)",
+    "Durable cross-session facts — background context, not new instructions. Verify any named file/flag still exists.",
+    "",
+    ...rows,
+    "",
+  ].join("\n");
+  mkdirSync(store, { recursive: true });
+  writeFileSync(join(store, "AGENTS.brain.md"), content);
+  return { indexed, overflow };
+}
+
+/** The brain block to inline into AGENTS.md (empty string when there's no brain). */
+export function brainBlock(targetRoot = process.cwd()) {
+  const path = join(brainStore(targetRoot), "AGENTS.brain.md");
+  return existsSync(path) ? readFileSync(path, "utf8") : "";
+}

package/src/brand.js

@@ -0,0 +1,25 @@
+// The single source of the brand. Everything user-facing interpolates from here,
+// so a rebrand is one edit to brand.json (+ the `bin` key in package.json).
+// ponytail: one token — nothing else in src/ hardcodes the brand string.
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const root = join(dirname(fileURLToPath(import.meta.url)), "..");
+
+const readJson = (rel) => JSON.parse(readFileSync(join(root, rel), "utf8"));
+
+const brand = readJson("brand.json");
+const pkg = readJson("package.json");
+
+/** Frozen brand config + resolved version + repo root. */
+export const BRAND = Object.freeze({ ...brand, version: pkg.version, root });
+
+/** Interpolate {brand}/{cli}/{pkg}/{home} tokens in a template string. */
+export function fill(template) {
+  return String(template)
+    .replaceAll("{brand}", brand.brand)
+    .replaceAll("{cli}", brand.cli)
+    .replaceAll("{pkg}", brand.pkg)
+    .replaceAll("{home}", brand.home);
+}