@nxuss/lemma 1.15.0 → 1.16.0

package/README.md

@@ -41,7 +41,10 @@ lemma start     # gateway + dashboard on http://localhost:8081
   one. Memories can depend on other memories (`derivedFrom`) and inherit their staleness
   transitively; `verify_memory` batch-revalidates a set of ids by hash-compare alone, no search
   round trip; `semanticDiff` tells a comment/formatting-only edit apart from a real one so
-  reformatting a file doesn't falsely invalidate what was learned about it. Ranking factors in
+  reformatting a file doesn't falsely invalidate what was learned about it. Write tools
+  (`surgical_ast_insert`, `apply_workspace_patch`, `write_workspace_file`) warn proactively when
+  the code they're about to touch has dependent memories — including a documented failed
+  attempt — instead of only finding out on the next search. Ranking factors in
   real usage (`hits`), explicit negative feedback (`downvote_memory`), and `cognitive_map` domain
   tags; a passing `test_oracle` run over an uncommitted diff auto-captures itself; two memories
   about the same symbol that disagree on outcome are flagged, not silently both suggested.

package/dist/cjs/mcp/tools.js

@@ -2102,7 +2102,8 @@ async function handleWriteWorkspaceFile(args) {
             fs_1.default.mkdirSync(dir, { recursive: true });
         }
         fs_1.default.writeFileSync(resolved, content, "utf8");
-        return { content: [{ type: "text", text: `Success: Written file to ${filePath}` }] };
+        const blastRadius = formatBlastRadiusNote((0, TheBrainV2_1.getBrain)().findBlastRadius(filePath));
+        return { content: [{ type: "text", text: `Success: Written file to ${filePath}${blastRadius}` }] };
     }
     catch (err) {
         (0, utils_1.logError)("write_workspace_file", err);
@@ -2153,6 +2154,24 @@ function stripLineNumberGutter(text) {
 }
 // Splices one resolved match into the file and writes it. Shared by the normal
 // single-match path and the ambiguous-match-resolved-via-elicitation path below.
+/**
+ * Fase E — blast radius. Purely advisory text appended to a write tool's success response:
+ * which Brain memories (direct or derived via Fase B's derivedFrom) depend on the
+ * file/symbol just written, and which of those document a documented FAILED attempt. Never
+ * blocks the write and never mutates anything — the next search_memory/verify_memory call
+ * already re-checks freshness lazily; this only surfaces the same signal earlier, at the
+ * moment it's cheapest to act on.
+ */
+function formatBlastRadiusNote(result) {
+    if (result.hits.length === 0)
+        return "";
+    const ids = result.hits.map((h) => h.id).join(", ");
+    const base = `\n📎 ${result.hits.length} memor${result.hits.length === 1 ? "y" : "ies"} in the Brain depend on this and will go stale: ${ids}. They'll re-verify next time they're searched.`;
+    if (result.failedHits.length === 0)
+        return base;
+    const failedIds = result.failedHits.map((h) => h.id).join(", ");
+    return `${base}\n⚠️ ${result.failedHits.length} of those document a PRIOR ATTEMPT THAT FAILED on related code: ${failedIds}. Review before continuing down this path.`;
+}
 async function applyMatch(match, filePath, resolved, originalContent, searchContent, replaceContent) {
     let updatedContent;
     if (match.strategy === "exact" && match.charStart !== undefined && match.charEnd !== undefined) {
@@ -2173,7 +2192,8 @@ async function applyMatch(match, filePath, resolved, originalContent, searchCont
     }
     fs_1.default.writeFileSync(resolved, updatedContent, "utf8");
     const note = match.strategy === "exact" ? "" : ` (matched via ${match.strategy}, score ${match.score.toFixed(2)})`;
-    return { content: [{ type: "text", text: `Success: Patch successfully applied to ${filePath}${note}` }] };
+    const blastRadius = formatBlastRadiusNote((0, TheBrainV2_1.getBrain)().findBlastRadius(filePath));
+    return { content: [{ type: "text", text: `Success: Patch successfully applied to ${filePath}${note}${blastRadius}` }] };
 }
 async function handleApplyWorkspacePatch(args) {
     const filePath = args?.filePath;
@@ -5157,10 +5177,11 @@ async function handleSurgicalAstInsert(args) {
             toolName: "surgical_ast_insert",
             filePath
         });
+        const blastRadius = formatBlastRadiusNote((0, TheBrainV2_1.getBrain)().findBlastRadius(filePath, symbolName || anchorSymbol));
         return {
             content: [{
                     type: "text",
-                    text: `Success: Surgically inserted code into ${filePath} using AST compiler.`
+                    text: `Success: Surgically inserted code into ${filePath} using AST compiler.${blastRadius}`
                 }]
         };
     }