mcp_engram_scar
Prevents repeating failed fixes or dead ends by adding a geometric repeller to the memory manifold. Use for code failures, ruled-out research paths, or uncertainty receipts.
Instructions
TRIGGER: Call this immediately if you attempt a code fix and it fails, or if the user tells you an approach is a dead end. This creates a geometric repeller in the manifold so you do not hallucinate or attempt the same bad solution again in the future. For research dead-ends, pass ruled_out + why (optional preferred_alternative) to mint/update a structured scar:* via mint_research_scar (UB15). For insufficient memory anchors (not general inference), pass uncertainty_status to mint an uncertainty:* receipt instead of guessing. Default path demotes an existing concept via op_suspend.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| why | No | UB15 research scar: why this approach is ruled out (required with ruled_out). | |
| concept | Yes | Concept to demote, scar: slug for research mint, or uncertainty slug when minting uncertainty receipt | |
| magnitude | No | Scar magnitude [0.0, 1.0]. Higher = larger CRS penalty and stronger topological deflection. Defaults to 0.15 (M-NOL default for contradiction axis spikes). Ignored for research/uncertainty mint paths. | |
| ruled_out | No | UB15 research scar: the dead-end approach being ruled out. When set with why, routes to mint_research_scar (structured scar:*). Prefer over free-form remember("scar:…"). | |
| process_context | No | Optional process:engram.* key — emits realized_by edge for process_metrics | |
| requested_anchors | No | Anchor concepts that were sought but insufficient for a memory claim | |
| uncertainty_status | No | When set, mint uncertainty:* receipt for withheld memory claim (e.g. memory_insufficient, contradictory_anchors). Scoped to recall/memory — not general inference. | |
| preferred_alternative | No | UB15 research scar: preferred path instead of the ruled-out approach (optional). |