soma-memory-fix

What problem does it solve?

Audits AgentStack agents for unwired kb_search nodes (missing knowledgeBaseId), proposes a fix plan, and — after confirmation — patches each node using only live MCP data. Zero hallucination tolerance: every ID used in a patch comes from a real tool response in the current session.

Core Features & Use Cases

• Inspect production agents for unwired kb_search nodes
• Match each unwired node to its correct KB in a strict 1:1 manner
• Build and present a patch plan before applying changes
• Patch nodes using as_patch_node_field with only live IDs
• Verify patches via post-patch re-read

Hard rules (zero-hallucination constraints):

• Every agent ID, KB ID, and node ID used in a patch command must come from a live MCP tool response in the current session. Never use values from memory or previous sessions.
• Never call as_patch_node_field without first reading current node state via as_inspect_flow.
• Never mark a node as FIXED without a post-patch re-read confirming the field is set.
• If KB matching is ambiguous (0 or 2+ KBs for an agent) → halt that agent and report. Never guess which KB to use.

Quick Start

Run soma-memory-fix to audit, plan, and patch unwired kb_search nodes across all production agents.