cumora 0.1.45 → 0.1.46

package/dist/cli.js

@@ -56,8 +56,17 @@ async function exists(p) {
   }
 }
 async function ensureCommonHome(home) {
+  await mkdir(join(home, "memory"), { recursive: true });
   await mkdir(join(home, "notes"), { recursive: true });
   await mkdir(join(home, "workspace"), { recursive: true });
+  const memoryIndex = join(home, "memory", "MEMORY.md");
+  if (!await exists(memoryIndex)) {
+    await writeFile(
+      memoryIndex,
+      "# Memory index\n\nOne line per durable fact, pointing at the file that holds it:\n`- [Title](file.md) \u2014 one-line hook`\n\nWrite the fact itself in its own `memory/<topic>.md` file; keep this index short.\n",
+      "utf8"
+    );
+  }
 }
 function spawnEngine(bin, args, { home, env, onLog, signal }) {
   return new Promise((resolve, reject) => {
@@ -92,7 +101,13 @@ var PERSONA_HEADER = (p) => `# ${p.name}${p.role ? ` \u2014 ${p.role}` : ""}
 You are **${p.name}**, a member of a team that collaborates in Cumora (a team chat).
 This directory is your private home and your working directory \u2014 it persists
 across wakes and is yours alone. Its layout:
-- \`CLAUDE.md\` (this file) + \`memory/\` + \`notes/\` \u2014 your durable memory and notes.
+- \`CLAUDE.md\` (this file) \u2014 always loaded each wake; keep it short.
+- \`memory/\` \u2014 your durable memory. There is NO hidden memory store: to remember
+  something across wakes you MUST write it to a file here (e.g. \`memory/<topic>.md\`)
+  and add a one-line pointer in \`memory/MEMORY.md\`. Saying "I'll remember" without
+  writing a file means you will NOT remember. At the start of each wake, read
+  \`memory/MEMORY.md\` (and the files it points to) to recall what you know.
+- \`notes/\` \u2014 scratch notes and drafts.
 - \`.claude/skills/\` \u2014 your skills.
 - \`workspace/\` \u2014 **put all project files and scratch here**: git clones, builds,
   downloads, temp files. Always \`cd workspace\` (or use \`workspace/\u2026\` paths) for
@@ -332,7 +347,21 @@ var AgentRunner = class {
       CUMORA_AGENT_ID: this.agent.id
     };
   }
-  prompt() {
+  /** Preload the memory index (memory/MEMORY.md) so it's ALWAYS in the wake
+   *  prompt — the lightweight BYOA analog of the cloud agent's RAG memory
+   *  preload. We inject only the small index; the agent opens detail files on
+   *  demand. Capped so a runaway index can't blow up the prompt. */
+  async memoryDigest() {
+    try {
+      const txt = (await readFile(join2(this.home, "memory", "MEMORY.md"), "utf8")).trim();
+      if (!txt) return "";
+      return txt.length > 4e3 ? `${txt.slice(0, 4e3)}
+\u2026(truncated \u2014 cat the file for the rest)` : txt;
+    } catch {
+      return "";
+    }
+  }
+  prompt(memoryDigest) {
     return `You've been woken because there's new activity in your Cumora conversations.
 
 Use the \`cumora\` tool to catch up and respond:
@@ -340,6 +369,11 @@ Use the \`cumora\` tool to catch up and respond:
 2. \`cumora messages <conversationId> --tail 30\` \u2014 read the relevant thread(s)
 3. \`cumora reply <conversationId> '<text>'\` \u2014 reply, in your own voice, only where you add something
 
+` + (memoryDigest ? `Your memory index (\`memory/MEMORY.md\`) \u2014 consult before replying; \`cat memory/<file>\` for any detail it points to:
+${memoryDigest}
+
+` : ``) + `Memory is your ONLY durable store. When the operator asks you to remember something (or you learn a durable fact), you MUST write it to a file under \`memory/\` and add a one-line pointer in \`memory/MEMORY.md\` \u2014 actually run the write. Saying "got it, I'll remember" does NOT persist anything.
+
 Mentions: to notify or address a specific teammate, write @<their-id> using their participant id (the short id shown in \`cumora messages\` and \`cumora participants\`), NOT their display name. "@Alex P" does nothing; "@alex-3f9a" actually pings them. Run \`cumora participants\` if you need to look up an id.
 
 Know when to stay quiet \u2014 this is how teams avoid endless back-and-forth:
@@ -384,7 +418,7 @@ If nothing genuinely needs you, it's fine to do nothing and stop. When finished,
         try {
           const result = await this.adapter.run({
             home: this.home,
-            prompt: this.prompt(),
+            prompt: this.prompt(await this.memoryDigest()),
             env: this.engineEnv(),
             model: this.agent.model,
             fastModel: this.agent.fastModel,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cumora",
-  "version": "0.1.45",
+  "version": "0.1.46",
   "description": "Run your Cumora agents on your own machine or VPS, powered by your local Claude Code or Codex CLI (BYOA).",
   "type": "module",
   "bin": {