agenr 0.7.1 → 0.7.3

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog
 
+## [0.7.3] - 2026-02-20
+
+### Added
+- feat(plugin): bundled OpenClaw skill (skills/SKILL.md) - teaches agents when to call agenr_store and agenr_recall as MCP tools; automatically available when plugin is installed
+- feat(plugin): complete configSchema in openclaw.plugin.json (signalMinImportance, signalMaxPerSignal, signalsEnabled, dbPath)
+
+### Changed
+- fix(init): removed AGENTS.md auto-detection heuristic for openclaw platform - openclaw must be specified explicitly via --platform openclaw (AGENTS.md is also used by Codex; the heuristic was unreliable)
+- fix(init): agenr init --platform openclaw no longer writes to AGENTS.md - the OpenClaw plugin handles memory injection via prependContext; AGENTS.md write was redundant
+
+### Internal
+- chore(plugin): bump openclaw.plugin.json version to 0.7.3
+
+## [0.7.2] - 2026-02-20
+
+### Fixed
+- fix(store): within-batch deduplication - entries with the same subject+type+source file in a single storeEntries() call are now deduplicated before processing, preventing same-batch signal duplicates (entries from different source files with the same subject are kept as distinct)
+- fix(store): re-extraction guard - entries with the same subject+type+source_file extracted within 24 hours now increment confirmations instead of adding a new entry
+- fix(mcp): append-only MCP access log at ~/.agenr/mcp-access.log for observability of agenr_recall and agenr_store tool calls
+
 ## [0.7.1] - 2026-02-20
 
 ### Added

package/dist/cli-main.js

@@ -4469,6 +4469,7 @@ var AUTO_SKIP_THRESHOLD = 0.95;
 var SMART_DEDUP_THRESHOLD = 0.88;
 var DEFAULT_DEDUP_THRESHOLD = 0.8;
 var DEFAULT_SIMILAR_LIMIT = 5;
+var RECENCY_DEDUP_HOURS = 24;
 var CANONICAL_KEY_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+){2,4}$/;
 var CROSS_TYPE_TODO_SUPERSEDE_TYPES = /* @__PURE__ */ new Set(["event", "fact", "decision"]);
 var TODO_COMPLETION_SIGNALS = ["done", "fixed", "resolved", "completed", "shipped", "closed", "merged"];
@@ -5066,6 +5067,47 @@ async function findEntryByTypeAndCanonicalKey(db, type, canonicalKey) {
   const tagsById = await getTagsForEntryIds2(db, [entryId]);
   return mapStoredEntry2(row, tagsById.get(entryId) ?? []);
 }
+async function findRecentEntryBySubjectTypeAndSourceFile(db, normalizedSubject, type, sourceFile, withinHours) {
+  const result = await db.execute({
+    sql: `
+      SELECT
+        id,
+        type,
+        subject,
+        canonical_key,
+        content,
+        importance,
+        expiry,
+        source_file,
+        source_context,
+        embedding,
+        created_at,
+        updated_at,
+        last_recalled_at,
+        recall_count,
+        confirmations,
+        contradictions,
+        superseded_by
+      FROM entries e
+      WHERE lower(trim(e.subject)) = ?
+        AND e.type = ?
+        AND e.source_file = ?
+        AND e.retired = 0
+        AND e.superseded_by IS NULL
+        AND e.created_at > datetime('now', '-' || ? || ' hours')
+      ORDER BY e.rowid DESC
+      LIMIT 1
+    `,
+    args: [normalizedSubject, type, sourceFile, withinHours]
+  });
+  const row = result.rows[0];
+  if (!row) {
+    return null;
+  }
+  const entryId = toStringValue2(row.id);
+  const tagsById = await getTagsForEntryIds2(db, [entryId]);
+  return mapStoredEntry2(row, tagsById.get(entryId) ?? []);
+}
 async function findActiveTodoByCanonicalKey(db, canonicalKey) {
   return findEntryByTypeAndCanonicalKey(db, "todo", canonicalKey);
 }
@@ -5474,6 +5516,28 @@ async function storeEntries(db, entries, apiKey, options = {}) {
   let superseded = 0;
   let relationsCreated = 0;
   let llmDedupCalls = 0;
+  if (!options.force && !onlineDedup) {
+    const seen = /* @__PURE__ */ new Map();
+    for (let i = 0; i < entries.length; i += 1) {
+      const key = `${entries[i].subject.trim().toLowerCase()}:${entries[i].type}:${entries[i].source.file}`;
+      seen.set(key, i);
+    }
+    for (let i = 0; i < entries.length; i += 1) {
+      const key = `${entries[i].subject.trim().toLowerCase()}:${entries[i].type}:${entries[i].source.file}`;
+      if (seen.get(key) !== i) {
+        skipped += 1;
+        options.onDecision?.({
+          entry: entries[i],
+          action: "skipped",
+          reason: "within-batch duplicate (same subject+type+source.file)"
+        });
+      }
+    }
+    entries = entries.filter((entry, i) => {
+      const key = `${entry.subject.trim().toLowerCase()}:${entry.type}:${entry.source.file}`;
+      return seen.get(key) === i;
+    });
+  }
   const processOne = async (entry) => {
     const normalizedEntry = {
       ...entry,
@@ -5489,6 +5553,28 @@ async function storeEntries(db, entries, apiKey, options = {}) {
       });
       return;
     }
+    if (!options.force && !onlineDedup && normalizedEntry.source.file) {
+      const recentMatch = await findRecentEntryBySubjectTypeAndSourceFile(
+        db,
+        normalizedEntry.subject.trim().toLowerCase(),
+        normalizedEntry.type,
+        normalizedEntry.source.file,
+        RECENCY_DEDUP_HOURS
+      );
+      if (recentMatch) {
+        await incrementConfirmations(db, recentMatch.id, contentHash);
+        updated += 1;
+        options.onDecision?.({
+          entry: normalizedEntry,
+          action: "updated",
+          reason: "re-extraction guard: same subject+type+source within 24h",
+          matchedEntryId: recentMatch.id,
+          matchedEntry: recentMatch,
+          sameSubject: true
+        });
+        return;
+      }
+    }
     if (!options.force && normalizedEntry.canonical_key) {
       const canonicalMatch = await findEntryByTypeAndCanonicalKey(db, normalizedEntry.type, normalizedEntry.canonical_key);
       if (canonicalMatch) {
@@ -13226,9 +13312,6 @@ async function detectPlatform(projectDir) {
   if (await isDirectory(path28.join(projectDir, ".cursor"))) {
     return "cursor";
   }
-  if (await pathExists(path28.join(projectDir, "AGENTS.md"))) {
-    return "openclaw";
-  }
   if (await pathExists(path28.join(projectDir, ".windsurfrules"))) {
     return "windsurf";
   }
@@ -13251,6 +13334,9 @@ async function resolveInstructionsPath(projectDir, platform) {
   if (platform === "codex") {
     return path28.join(os16.homedir(), ".codex", "AGENTS.md");
   }
+  if (platform === "openclaw") {
+    return null;
+  }
   return path28.join(projectDir, "AGENTS.md");
 }
 function withMarkers(promptBlock) {
@@ -13400,9 +13486,13 @@ function formatInitSummary(result) {
   const lines = [
     `agenr init: platform=${result.platform} project=${result.project} dependencies=${dependencyLabel}`,
     `- Wrote .agenr/config.json`,
-    `- Wrote system prompt block to ${path28.basename(result.instructionsPath)}`,
     `- Wrote MCP config to ${path28.relative(result.projectDir, result.mcpPath) || path28.basename(result.mcpPath)}`
   ];
+  if (result.instructionsPath !== null) {
+    lines.splice(2, 0, `- Wrote system prompt block to ${path28.basename(result.instructionsPath)}`);
+  } else {
+    lines.splice(2, 0, `- Memory injection: handled automatically by ${result.platform} plugin (no instructions file needed)`);
+  }
   if (result.gitignoreUpdated) {
     lines.push("- Added .agenr/knowledge.db to .gitignore");
   }
@@ -13430,12 +13520,14 @@ async function runInitCommand(options) {
   const dependencies = options.dependsOn !== void 0 ? normalizeSlugList(options.dependsOn) : void 0;
   const configResult = await writeAgenrConfig(projectDir, project, resolvedPlatform, dependencies);
   const instructionsPath = await resolveInstructionsPath(projectDir, resolvedPlatform);
-  await upsertPromptBlock(instructionsPath, buildSystemPromptBlock(project));
+  if (instructionsPath !== null) {
+    await upsertPromptBlock(instructionsPath, buildSystemPromptBlock(project));
+  }
   const mcpPath = await writeMcpConfig(projectDir, resolvedPlatform);
   const gitignoreEntries = [".agenr/knowledge.db"];
   if (resolvedPlatform === "cursor") {
     gitignoreEntries.push(".cursor/rules/agenr.mdc");
-    if (isPathInsideProject(projectDir, instructionsPath)) {
+    if (instructionsPath !== null && isPathInsideProject(projectDir, instructionsPath)) {
       const relativeInstructionsPath = path28.relative(projectDir, instructionsPath).split(path28.sep).join("/");
       gitignoreEntries.push(relativeInstructionsPath);
     }
@@ -13462,6 +13554,14 @@ import os17 from "os";
 import path29 from "path";
 import * as readline from "readline";
 import { once } from "events";
+async function appendMcpLog(line) {
+  try {
+    const logPath = path29.join(os17.homedir(), ".agenr", "mcp-access.log");
+    const entry = JSON.stringify({ ts: (/* @__PURE__ */ new Date()).toISOString(), ...line }) + "\n";
+    await fs30.appendFile(logPath, entry, "utf8");
+  } catch {
+  }
+}
 var MCP_PROTOCOL_VERSION = "2024-11-05";
 var JSON_RPC_PARSE_ERROR = -32700;
 var JSON_RPC_INVALID_REQUEST = -32600;
@@ -14277,13 +14377,31 @@ function createMcpServer(options = {}, deps = {}) {
   async function dispatchToolCall(params) {
     try {
       if (params.name === "agenr_recall") {
+        const result = await callRecallTool(params.args);
+        await appendMcpLog({
+          tool: "agenr_recall",
+          query: typeof params.args.query === "string" ? params.args.query.slice(0, 120) : void 0,
+          context: typeof params.args.context === "string" ? params.args.context : void 0,
+          project: typeof params.args.project === "string" ? params.args.project : void 0
+        });
         return {
-          content: [{ type: "text", text: await callRecallTool(params.args) }]
+          content: [{ type: "text", text: result }]
         };
       }
       if (params.name === "agenr_store") {
+        const result = await callStoreTool(params.args);
+        const storeArgsEntries = Array.isArray(params.args.entries) ? params.args.entries : [];
+        const firstEntry = storeArgsEntries[0];
+        await appendMcpLog({
+          tool: "agenr_store",
+          count: storeArgsEntries.length,
+          firstType: typeof firstEntry?.type === "string" ? firstEntry.type : void 0,
+          firstSubject: typeof firstEntry?.subject === "string" ? firstEntry.subject.slice(0, 80) : void 0,
+          firstImportance: typeof firstEntry?.importance === "number" ? firstEntry.importance : void 0,
+          project: typeof params.args.project === "string" ? params.args.project : void 0
+        });
         return {
-          content: [{ type: "text", text: await callStoreTool(params.args) }]
+          content: [{ type: "text", text: result }]
         };
       }
       if (params.name === "agenr_extract") {

package/openclaw.plugin.json

@@ -2,7 +2,10 @@
   "id": "agenr",
   "name": "agenr Memory",
   "description": "Local memory layer - injects agenr context at session start",
-  "version": "0.6.6",
+  "version": "0.7.3",
+  "skills": [
+    "skills"
+  ],
   "configSchema": {
     "type": "object",
     "additionalProperties": false,
@@ -18,6 +21,22 @@
       "enabled": {
         "type": "boolean",
         "description": "Set false to disable memory injection without uninstalling."
+      },
+      "signalMinImportance": {
+        "type": "number",
+        "description": "Minimum importance for mid-session signals (1-10, default: 7). Raise to reduce noise."
+      },
+      "signalMaxPerSignal": {
+        "type": "number",
+        "description": "Max entries per signal notification (default: 5)."
+      },
+      "signalsEnabled": {
+        "type": "boolean",
+        "description": "Set false to disable mid-session signals without uninstalling."
+      },
+      "dbPath": {
+        "type": "string",
+        "description": "Path to agenr DB. Defaults to AGENR_DB_PATH env or ~/.agenr/knowledge.db."
       }
     }
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agenr",
-  "version": "0.7.1",
+  "version": "0.7.3",
   "openclaw": {
     "extensions": [
       "dist/openclaw-plugin/index.js"
@@ -47,6 +47,7 @@
   ],
   "files": [
     "dist",
+    "skills",
     "openclaw.plugin.json",
     "CHANGELOG.md",
     "LICENSE",

package/skills/SKILL.md

@@ -0,0 +1,16 @@
+---
+name: agenr
+description: Use when storing new knowledge (decisions, preferences, lessons, todos) or recalling context mid-session. The agenr plugin auto-injects memory at session start - this skill covers proactive store and on-demand recall.
+---
+
+Use `agenr_store` proactively. Call it immediately after any decision, user preference, lesson learned, important event, or fact worth remembering. Do not ask first.
+
+Required fields: `type`, `content`, `importance`.
+Types: `fact | decision | preference | todo | lesson | event`.
+Importance: `1-10` (default `7`), use `9` for critical items, use `10` sparingly.
+
+Do not store secrets/credentials, temporary state, or verbatim conversation.
+
+Use `agenr_recall` mid-session when you need context you do not already have. Use a specific query so results stay relevant.
+
+Session-start recall is already handled automatically by the OpenClaw plugin. Do not call `agenr_recall` at turn 1 unless you need extra context beyond the injected summary.