@mojoaar/opencode-mimir 0.17.0 → 0.19.0

package/README.md

@@ -58,7 +58,7 @@ session carries on.
 The plugin registers a `context` hook that puts the project's digest at the top
 of the system prompt before the first turn, once per session. It asks for 800
 tokens with a 1.5 second timeout, and does nothing at all when Mimir is
-unreachable, slow, or unconfigured — a session never waits on memory.
+unreachable, slow, or unconfigured - a session never waits on memory.
 
 ## Import an existing project
 
@@ -68,8 +68,8 @@ Until the package is published, run the CLI from a checkout:
 node packages/opencode-plugin/dist/bin.js ingest .
 ```
 
-Walks the folder and loads its **documentation and configuration** — READMEs,
-`docs/`, markdown, compose files, `package.json` — under the `import/` path
+Walks the folder and loads its **documentation and configuration** - READMEs,
+`docs/`, markdown, compose files, `package.json` - under the `import/` path
 prefix. Source code is skipped by default; the agent already has it.
 
 | Flag | What it does |

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 import { Plugin } from '@opencode/plugin';
 export declare const DIGEST_HEADER = "## What this project already knows (Mimir)\n\n";
+export declare const NUDGE_HEADER = "## Memory check (Mimir)\n\n";
 /**
  * One injection point and two tools. The hook is what puts the project's
  * digest in front of the model before the first turn, so a session starts

package/dist/index.js

@@ -3,6 +3,16 @@ import { callTool, detectRepo } from './client.js';
 import { resolveConfig } from './config.js';
 import { registerTools } from './tools.js';
 export const DIGEST_HEADER = '## What this project already knows (Mimir)\n\n';
+export const NUDGE_HEADER = '## Memory check (Mimir)\n\n';
+/**
+ * A fact written before a compaction is cheap; one that has already been
+ * summarised away is gone. So the reminder comes every twenty turns, and again
+ * the moment the transcript shrinks, which is what a compaction looks like from
+ * the message list this hook is handed.
+ */
+const NUDGE_EVERY = 20;
+const NUDGE = 'If this session settled a decision, a convention or a gotcha that is not in Mimir yet, ' +
+    'call memory_write now at one clear path, before the detail is compacted away.';
 /**
  * One injection point and two tools. The hook is what puts the project's
  * digest in front of the model before the first turn, so a session starts
@@ -35,10 +45,20 @@ export default Plugin.define({
                 return;
             event.system.push({ type: 'text', text: `${DIGEST_HEADER}${text}` });
         });
+        const counts = new Map();
+        const nudge = await ctx.session.hook('context', async (event) => {
+            const state = counts.get(event.sessionID) ?? { turns: 0, nudgedAt: 0 };
+            const turns = event.messages?.length ?? 0;
+            const due = turns < state.turns || turns - state.nudgedAt >= NUDGE_EVERY;
+            counts.set(event.sessionID, { turns, nudgedAt: due ? turns : state.nudgedAt });
+            if (due)
+                event.system.push({ type: 'text', text: `${NUDGE_HEADER}${NUDGE}` });
+        });
         const tools = await registerTools(ctx, config, repo);
         return async () => {
             await tools.dispose();
             await session.dispose();
+            await nudge.dispose();
         };
     },
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mojoaar/opencode-mimir",
-  "version": "0.17.0",
+  "version": "0.19.0",
   "description": "Mimir long-term memory for OpenCode sessions",
   "type": "module",
   "main": "src/index.ts",

package/src/index.ts

@@ -4,6 +4,18 @@ import { resolveConfig } from './config.js'
 import { registerTools } from './tools.js'
 
 export const DIGEST_HEADER = '## What this project already knows (Mimir)\n\n'
+export const NUDGE_HEADER = '## Memory check (Mimir)\n\n'
+
+/**
+ * A fact written before a compaction is cheap; one that has already been
+ * summarised away is gone. So the reminder comes every twenty turns, and again
+ * the moment the transcript shrinks, which is what a compaction looks like from
+ * the message list this hook is handed.
+ */
+const NUDGE_EVERY = 20
+const NUDGE =
+  'If this session settled a decision, a convention or a gotcha that is not in Mimir yet, ' +
+  'call memory_write now at one clear path, before the detail is compacted away.'
 
 /**
  * One injection point and two tools. The hook is what puts the project's
@@ -43,11 +55,21 @@ export default Plugin.define({
       event.system.push({ type: 'text', text: `${DIGEST_HEADER}${text}` })
     })
 
+    const counts = new Map<string, { turns: number; nudgedAt: number }>()
+    const nudge = await ctx.session.hook('context', async (event) => {
+      const state = counts.get(event.sessionID) ?? { turns: 0, nudgedAt: 0 }
+      const turns = event.messages?.length ?? 0
+      const due = turns < state.turns || turns - state.nudgedAt >= NUDGE_EVERY
+      counts.set(event.sessionID, { turns, nudgedAt: due ? turns : state.nudgedAt })
+      if (due) event.system.push({ type: 'text', text: `${NUDGE_HEADER}${NUDGE}` })
+    })
+
     const tools = await registerTools(ctx, config, repo)
 
     return async () => {
       await tools.dispose()
       await session.dispose()
+      await nudge.dispose()
     }
   },
 })