agenr 0.7.5 → 0.7.6

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## [0.7.6] - 2026-02-20
+
+### Fixed
+- fix(plugin): `agenr_recall` now passes query as a positional argument instead of unsupported `--query`
+- fix(plugin): `agenr_recall` now uses `--type` (singular) instead of invalid `--types`
+- fix(plugin): removed unsupported `--threshold` forwarding from `agenr_recall`; threshold has no direct CLI equivalent
+- fix(plugin): `agenr_store` now sends entries array directly on stdin and passes `platform`/`project` as CLI flags
+- fix(plugin): `agenr_store` now infers missing `subject` from `content` before CLI spawn, matching MCP server behavior
+- fix(plugin): `agenr_retire` now calls `agenr retire --id <entry_id>` instead of subject matching with UUIDs
+- fix(cli): `agenr retire` now supports `--id <id>` and enforces exactly one of subject or `--id`
+- fix(plugin): `agenr_extract` now uses a two-step flow for `store=true` (`extract --json` then `store`) and injects source metadata before storing
+- fix(cli): `agenr store` now accepts the `--aggressive` flag used by plugin dedup config forwarding
+
 ## [0.7.5] - 2026-02-20
 
 ### Changed

package/README.md

@@ -202,7 +202,7 @@ MCP settings.
 | `agenr extract <files...>` | Extract knowledge entries from text files |
 | `agenr store [files...]` | Store entries with semantic dedup |
 | `agenr recall [query]` | Semantic + memory-aware recall |
-| `agenr retire <subject>` | Retire a stale entry (hidden, not deleted) |
+| `agenr retire [subject]` | Retire a stale entry (hidden, not deleted). Match by subject text or use --id <id> to target by entry ID. |
 | `agenr watch [file]` | Live-watch files/directories, auto-extract knowledge |
 | `agenr daemon install` | Install background watch daemon (macOS launchd) |
 | `agenr daemon status` | Show daemon status (running/stopped, pid, watched file, recent logs) |
@@ -227,7 +227,7 @@ Deep dive: [docs/ARCHITECTURE.md](./docs/ARCHITECTURE.md)
 
 ## Status
 
-The core pipeline is stable and tested (782 tests). We use it daily managing
+The core pipeline is stable and tested (797 tests). We use it daily managing
 thousands of knowledge entries across OpenClaw sessions.
 
 What works: extraction, storage, recall, MCP integration, online dedup, consolidation, smart filtering, live watching, daemon mode.

package/dist/cli-main.js

@@ -14968,6 +14968,23 @@ async function queryCandidates(db, subject, contains) {
     content: toStringValue5(row.content)
   }));
 }
+async function queryById(db, id) {
+  const result = await db.execute({
+    sql: `
+      SELECT id, type, subject, importance, content
+      FROM entries
+      WHERE retired = 0 AND id = ?
+    `,
+    args: [id]
+  });
+  return result.rows.map((row) => ({
+    id: toStringValue5(row.id),
+    type: toStringValue5(row.type),
+    subject: toStringValue5(row.subject),
+    importance: toNumber7(row.importance),
+    content: toStringValue5(row.content)
+  }));
+}
 async function runRetireCommand(subject, options, deps) {
   const resolvedDeps = {
     readConfigFn: deps?.readConfigFn ?? readConfig,
@@ -14989,8 +15006,12 @@ async function runRetireCommand(subject, options, deps) {
     logFn: deps?.logFn ?? ((line) => clack7.log.info(line, { output: process.stderr }))
   };
   const querySubject = subject.trim();
-  if (!querySubject) {
-    throw new Error("subject is required");
+  const queryId = options.id?.trim() ?? "";
+  if (!queryId && !querySubject) {
+    throw new Error("subject or id is required");
+  }
+  if (queryId && querySubject) {
+    throw new Error("subject and id are mutually exclusive");
   }
   const clackOutput = { output: process.stderr };
   clack7.intro(banner(), clackOutput);
@@ -15000,9 +15021,15 @@ async function runRetireCommand(subject, options, deps) {
   try {
     await resolvedDeps.initDbFn(db);
     const contains = options.contains === true;
-    const candidates = await queryCandidates(db, querySubject, contains);
+    let candidates;
+    if (queryId) {
+      candidates = await queryById(db, queryId);
+    } else {
+      candidates = await queryCandidates(db, querySubject, contains);
+    }
+    const queryDisplay = queryId || querySubject;
     if (candidates.length === 0) {
-      clack7.log.warn(`No active entries matching: ${querySubject}`, clackOutput);
+      clack7.log.warn(`No active entries matching: ${queryDisplay}`, clackOutput);
       clack7.outro(void 0, clackOutput);
       return { exitCode: 1 };
     }
@@ -15038,16 +15065,17 @@ async function runRetireCommand(subject, options, deps) {
         return { exitCode: 1 };
       }
     }
+    const retireSubject = queryId ? candidates[0]?.subject ?? queryId : querySubject;
     const retired = await resolvedDeps.retireEntriesFn({
-      subjectPattern: querySubject,
-      matchType: contains ? "contains" : "exact",
+      subjectPattern: retireSubject,
+      matchType: queryId ? "exact" : contains ? "contains" : "exact",
       reason: options.reason?.trim() || void 0,
       writeLedger: options.persist === true,
       db,
       dbPath
     });
     if (retired.count === 0) {
-      clack7.log.warn(`No active entries matching: ${querySubject}`, clackOutput);
+      clack7.log.warn(`No active entries matching: ${queryDisplay}`, clackOutput);
       clack7.outro(void 0, clackOutput);
       return { exitCode: 1 };
     }
@@ -17249,7 +17277,7 @@ function createProgram() {
     });
     process.exitCode = result.exitCode;
   });
-  program.command("store").description("Store extracted knowledge entries in the local database").argument("[files...]", "One or more extraction JSON files").option("--db <path>", "Database path override").option("--dry-run", "Show what would be stored without writing", false).option("--verbose", "Show per-entry dedup decisions", false).option("--force", "Skip dedup and store all entries as new", false).option("--platform <name>", "Platform tag: openclaw, claude-code, codex").option("--project <name>", "Project tag (lowercase).", (val, prev) => [...prev, val], []).option("--online-dedup", "Enable online LLM dedup at write time", true).option("--no-online-dedup", "Disable online LLM dedup at write time").option("--dedup-threshold <n>", "Similarity threshold for online dedup (0.0-1.0)").action(
+  program.command("store").description("Store extracted knowledge entries in the local database").argument("[files...]", "One or more extraction JSON files").option("--db <path>", "Database path override").option("--dry-run", "Show what would be stored without writing", false).option("--verbose", "Show per-entry dedup decisions", false).option("--force", "Skip dedup and store all entries as new", false).option("--aggressive", "Enable aggressive dedup (lower similarity threshold)", false).option("--platform <name>", "Platform tag: openclaw, claude-code, codex").option("--project <name>", "Project tag (lowercase).", (val, prev) => [...prev, val], []).option("--online-dedup", "Enable online LLM dedup at write time", true).option("--no-online-dedup", "Disable online LLM dedup at write time").option("--dedup-threshold <n>", "Similarity threshold for online dedup (0.0-1.0)").action(
     async (files, opts) => {
       const result = await runStoreCommand(files ?? [], opts);
       process.exitCode = result.exitCode;
@@ -17277,13 +17305,25 @@ function createProgram() {
     });
     process.exitCode = result.exitCode;
   });
-  program.command("retire <subject>").description("Retire a stale entry from active recall (entry is hidden, not deleted)").option("--persist", "Write to retirements ledger so retirement survives re-ingest").option("--contains", "Use substring matching instead of exact match").option("--dry-run", "Preview matches without retiring").option("--reason <text>", "Reason for retirement").option("--db <path>", "Path to database file").action(async (subject, opts) => {
-    const result = await runRetireCommand(subject, {
+  program.command("retire [subject]").description("Retire a stale entry from active recall (entry is hidden, not deleted)").option("--persist", "Write to retirements ledger so retirement survives re-ingest").option("--contains", "Use substring matching instead of exact match").option("--dry-run", "Preview matches without retiring").option("--reason <text>", "Reason for retirement").option("--db <path>", "Path to database file").option("--id <id>", "Retire a specific entry by its ID (overrides subject matching)").action(async (subject, opts) => {
+    const entryId = opts.id;
+    if (!entryId && !subject) {
+      console.error("Error: provide a subject or --id <id>");
+      process.exitCode = 1;
+      return;
+    }
+    if (entryId && subject) {
+      console.error("Error: --id and subject are mutually exclusive");
+      process.exitCode = 1;
+      return;
+    }
+    const result = await runRetireCommand(subject ?? "", {
       persist: opts.persist === true,
       contains: opts.contains === true,
       dryRun: opts.dryRun === true,
       reason: opts.reason,
-      db: opts.db
+      db: opts.db,
+      id: entryId
     });
     process.exitCode = result.exitCode;
   });

package/dist/openclaw-plugin/index.js

@@ -313,11 +313,10 @@ async function runRecallTool(agenrPath, params) {
   const limit = asNumber(params.limit);
   const types = asString(params.types);
   const since = asString(params.since);
-  const threshold = asNumber(params.threshold);
   const platform = asString(params.platform);
   const project = asString(params.project);
   if (query) {
-    args.push("--query", query);
+    args.push(query);
   }
   if (context) {
     args.push("--context", context);
@@ -326,14 +325,11 @@ async function runRecallTool(agenrPath, params) {
     args.push("--limit", String(limit));
   }
   if (types) {
-    args.push("--types", types);
+    args.push("--type", types);
   }
   if (since) {
     args.push("--since", since);
   }
-  if (threshold !== void 0) {
-    args.push("--threshold", String(threshold));
-  }
   if (platform) {
     args.push("--platform", platform);
   }
@@ -381,14 +377,20 @@ async function runStoreTool(agenrPath, params, pluginConfig) {
   const entries = Array.isArray(params.entries) ? params.entries : [];
   const platform = asString(params.platform);
   const project = asString(params.project);
-  const payload = { entries };
+  const storeArgs = ["store"];
   if (platform) {
-    payload.platform = platform;
+    storeArgs.push("--platform", platform);
   }
   if (project) {
-    payload.project = project;
+    storeArgs.push("--project", project);
   }
-  const storeArgs = ["store"];
+  const processedEntries = entries.map((e) => {
+    const entry = e && typeof e === "object" ? e : {};
+    if (!entry.subject && typeof entry.content === "string") {
+      entry.subject = entry.content.slice(0, 60).replace(/[.!?][\s\S]*$/, "").trim() || entry.content.slice(0, 40);
+    }
+    return entry;
+  });
   const dedupConfig = pluginConfig?.dedup;
   if (dedupConfig?.aggressive === true) {
     storeArgs.push("--aggressive");
@@ -396,7 +398,7 @@ async function runStoreTool(agenrPath, params, pluginConfig) {
   if (typeof dedupConfig?.threshold === "number") {
     storeArgs.push("--dedup-threshold", String(dedupConfig.threshold));
   }
-  const result = await runAgenrCommand(agenrPath, storeArgs, JSON.stringify(payload));
+  const result = await runAgenrCommand(agenrPath, storeArgs, JSON.stringify(processedEntries));
   if (result.timedOut) {
     return {
       content: [{ type: "text", text: "agenr_store timed out" }]
@@ -426,13 +428,6 @@ async function runExtractTool(agenrPath, params) {
     };
   }
   const args = ["extract", "--json"];
-  if (params.store === true) {
-    args.push("--store");
-  }
-  const source = asString(params.source);
-  if (source) {
-    args.push("--source", source);
-  }
   const tempFile = join(
     tmpdir(),
     `agenr-extract-${Date.now()}-${Math.random().toString(36).slice(2)}.txt`
@@ -440,37 +435,74 @@ async function runExtractTool(agenrPath, params) {
   try {
     writeFileSync(tempFile, text, "utf8");
     args.push(tempFile);
-    const result = await runAgenrCommand(agenrPath, args, void 0, EXTRACT_TIMEOUT_MS);
-    if (result.timedOut) {
+    const extractResult = await runAgenrCommand(agenrPath, args, void 0, EXTRACT_TIMEOUT_MS);
+    if (extractResult.timedOut) {
       return {
         content: [{ type: "text", text: "agenr_extract failed: command timed out" }]
       };
     }
-    if (result.error) {
+    if (extractResult.error) {
       return {
-        content: [{ type: "text", text: `agenr_extract failed: ${result.error.message}` }]
+        content: [{ type: "text", text: `agenr_extract failed: ${extractResult.error.message}` }]
       };
     }
-    if (result.code !== 0) {
-      const message = result.stderr.trim() || result.stdout.trim() || "unknown error";
+    if (extractResult.code !== 0) {
+      const message = extractResult.stderr.trim() || extractResult.stdout.trim() || "unknown error";
       return {
         content: [{ type: "text", text: `agenr_extract failed: ${message}` }]
       };
     }
+    if (params.store === true) {
+      let entries;
+      try {
+        entries = JSON.parse(extractResult.stdout);
+        if (!Array.isArray(entries)) {
+          throw new Error("extract did not return an array");
+        }
+      } catch (err) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: `agenr_extract failed: could not parse extract output for store: ${err instanceof Error ? err.message : String(err)}`
+            }
+          ]
+        };
+      }
+      const source = asString(params.source);
+      if (source) {
+        for (const e of entries) {
+          if (e && typeof e === "object") {
+            const entry = e;
+            if (!entry.source) {
+              entry.source = { file: source, context: "extracted via agenr_extract" };
+            }
+          }
+        }
+      }
+      const storeResult = await runAgenrCommand(agenrPath, ["store"], JSON.stringify(entries));
+      if (storeResult.timedOut) {
+        return { content: [{ type: "text", text: "agenr_extract store step timed out" }] };
+      }
+      if (storeResult.error) {
+        return { content: [{ type: "text", text: `agenr_extract store step failed: ${storeResult.error.message}` }] };
+      }
+      if (storeResult.code !== 0) {
+        const message = storeResult.stderr.trim() || storeResult.stdout.trim() || "unknown error";
+        return { content: [{ type: "text", text: `agenr_extract store step failed: ${message}` }] };
+      }
+      return { content: [{ type: "text", text: `Extracted and stored ${entries.length} entries.` }] };
+    }
     try {
-      const parsed = JSON.parse(result.stdout);
+      const parsed = JSON.parse(extractResult.stdout);
       return {
         content: [{ type: "text", text: JSON.stringify(parsed, null, 2) }],
         details: parsed
       };
-    } catch (error) {
+    } catch {
       return {
-        content: [
-          {
-            type: "text",
-            text: `agenr_extract failed: ${error instanceof Error ? error.message : String(error)}`
-          }
-        ]
+        content: [{ type: "text", text: "No results found." }],
+        details: { count: 0 }
       };
     }
   } finally {
@@ -489,7 +521,7 @@ async function runRetireTool(agenrPath, params) {
   }
   const reason = asString(params.reason);
   const persist = params.persist === true;
-  const args = ["retire", entryId];
+  const args = ["retire", "--id", entryId];
   if (reason) {
     args.push("--reason", reason);
   }
@@ -700,7 +732,6 @@ var plugin = {
             since: Type.Optional(
               Type.String({ description: "Only entries newer than this (ISO date or relative, e.g. 7d)." })
             ),
-            threshold: Type.Optional(Type.Number({ description: "Minimum relevance score 0.0-1.0." })),
             platform: Type.Optional(Type.String({ description: "Platform filter: openclaw, claude-code, codex." })),
             project: Type.Optional(Type.String({ description: "Project scope. Pass * for all projects." }))
           }),

package/package.json

@@ -1,7 +1,6 @@
 {
   "name": "agenr",
-  "version": "0.7.5",
-
+  "version": "0.7.6",
   "openclaw": {
     "extensions": [
       "dist/openclaw-plugin/index.js"
@@ -12,13 +11,6 @@
   "bin": {
     "agenr": "dist/cli.js"
   },
-  "scripts": {
-    "build": "tsup src/cli.ts src/cli-main.ts src/openclaw-plugin/index.ts --format esm --dts",
-    "dev": "tsup src/cli.ts src/cli-main.ts --format esm --watch",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "typecheck": "tsc --noEmit"
-  },
   "dependencies": {
     "@clack/prompts": "^1.0.1",
     "@libsql/client": "^0.17.0",
@@ -62,9 +54,11 @@
     "README.md"
   ],
   "author": "agenr-ai",
-  "pnpm": {
-    "overrides": {
-      "fast-xml-parser": "^5.3.6"
-    }
+  "scripts": {
+    "build": "tsup src/cli.ts src/cli-main.ts src/openclaw-plugin/index.ts --format esm --dts",
+    "dev": "tsup src/cli.ts src/cli-main.ts --format esm --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
   }
-}
+}