@eleboucher/pi-memini 0.5.11 → 0.5.12

package/dist/index.js

@@ -417,6 +417,12 @@ export default function meminiExtension(pi) {
                 "current workspace state and the user's instructions):",
             ...fit.items,
         ];
+        // /v1/search sets `degraded: "keyword_only"` (plus a `note`) when the query
+        // embed was unavailable and it fell back to keyword-only matching; both are
+        // already on `result`, so surfacing them is a one-line addition.
+        if (result?.degraded) {
+            lines.push(`[memini: ${result.note || "semantic search unavailable — results are keyword-only and may be incomplete"}]`);
+        }
         if (fit.dropped > 0)
             lines.push(`[... ${fit.dropped} item(s) truncated by token budget]`);
         return {
@@ -467,7 +473,11 @@ export default function meminiExtension(pi) {
     pi.registerTool({
         name: "memory_recall",
         label: "Recall memory",
-        description: "Recall relevant memories from long-term memory (memini) via hybrid (semantic + keyword) search.",
+        description: "Recall relevant memories from long-term memory (memini) via hybrid (semantic + keyword) search. " +
+            "Call before starting work that may have history: editing an unfamiliar file, debugging a recurring " +
+            "issue, or when asked what's known about something. A degraded:\"keyword_only\" field in the result " +
+            "means semantic search was unavailable and results came from keyword matching alone — treat as " +
+            "incomplete, not exhaustive.",
         parameters: Type.Object({
             query: Type.String({ description: "What to search for" }),
             limit: Type.Optional(Type.Number({ description: "Max results (default 3)" })),
@@ -488,7 +498,9 @@ export default function meminiExtension(pi) {
                 tier: r?.memory?.tier || "",
                 score: typeof r?.score === "number" ? r.score : 0,
             }));
-            return text({ results });
+            // /v1/search already carries `degraded`/`note` on `res`; pass them through
+            // rather than dropping them silently.
+            return text(res?.degraded ? { results, degraded: res.degraded, note: res.note } : { results });
         },
     });
     pi.registerTool({
@@ -519,7 +531,9 @@ export default function meminiExtension(pi) {
     pi.registerTool({
         name: "memory_remember",
         label: "Remember",
-        description: "Store a durable fact, decision, or preference in long-term memory (memini).",
+        description: "Store a durable fact, decision, or preference in long-term memory (memini). Call proactively when " +
+            "the user says 'remember this', after an architectural decision (capture the why), or after " +
+            "discovering a non-obvious bug or convention. Keep memories atomic — one self-contained fact per call.",
         parameters: Type.Object({
             content: Type.String({ description: "The fact to remember" }),
             tier: Type.Optional(Type.String({
@@ -548,8 +562,10 @@ export default function meminiExtension(pi) {
     pi.registerTool({
         name: "memory_forget",
         label: "Forget",
-        description: "Delete a memory from long-term memory (memini) by its id — use when a recalled memory is wrong, " +
-            "outdated, or poisoned. Get the id from memory_recall or memory_list. This is a soft delete (tombstone).",
+        description: "Permanently delete a memory from long-term memory (memini) by its id — use when a recalled memory " +
+            "is wrong, outdated, or poisoned. Get the id from memory_recall or memory_list. To correct a fact, " +
+            "forget the stale one and remember the corrected version — this integration talks to memini over " +
+            "REST, which has no partial-update endpoint.",
         parameters: Type.Object({
             id: Type.String({ description: "The id of the memory to forget (from memory_recall / memory_list)." }),
         }),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eleboucher/pi-memini",
-  "version": "0.5.11",
+  "version": "0.5.12",
   "description": "Shared cross-session memory for the Pi coding agent, backed by a memini service.",
   "files": [
     "dist"