bantamkit 0.36.1__tar.gz → 0.36.2__tar.gz

{bantamkit-0.36.1 → bantamkit-0.36.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: bantamkit
-Version: 0.36.1
+Version: 0.36.2
 Summary: Persistent memory for coding agents: an MCP server for Claude Code, Claude Desktop, Cursor and VS Code Copilot, plus a Python library that lifts small-model agents. Install once, run offline.
 Project-URL: Homepage, https://github.com/Ink01101011/bantamkit
 Project-URL: Repository, https://github.com/Ink01101011/bantamkit
@@ -74,8 +74,9 @@ Then restart the host (in Claude Code, open a new session) and ask the agent to
 - **Offline after one install.** `--install` records the venv's console script by absolute path,
   so no launch needs the network or your shell's PATH.
 - **Claude Code hooks, if you want them.** `--install-hooks` puts the memory index in front of
-  each new session, surfaces matching facts on each prompt, and nudges a save at the end of a
-  long session that saved nothing
+  each new session, surfaces matching facts on each prompt, mirrors each fact Claude Code writes
+  into its own auto-memory into the project store (one way, new writes only), and nudges a save at
+  the end of a long session that saved nothing
   ([docs/hooks.md](https://github.com/Ink01101011/bantamkit/blob/main/docs/hooks.md)).
 - **More than memory.** JSON Schema validation, a token ledger read off the host's transcripts,
   a skill-catalogue audit, and shift-work tools that plan and hand off multi-step jobs —
@@ -105,7 +106,7 @@ Then restart the host (in Claude Code, open a new session) and ask the agent to
 | [What it serves](#-what-it-serves) | 14 tools, one prompt, two resource templates |
 | [Requirements](#-requirements) | Python and dependencies |
 | [The asset pack](#-the-asset-pack) | `--assets-root`, `BANTAMKIT_ASSETS` |
-| [The operator CLI: `python -m bantamkit.memory`](#-the-operator-cli-python--m-bantamkitmemory) | status, lint, compact, archived, archive, restore |
+| [The operator CLI: `python -m bantamkit.memory`](#-the-operator-cli-python--m-bantamkitmemory) | status, lint, compact, archived, archive, restore, list, candidates, merge |
 | [Where the Python and Node servers differ](#-where-the-python-and-node-servers-differ) | One store; pdf/.doc/.rtf, CLI name, `build_id`, YAML only PyYAML reads |
 | [Module API](#-module-api) | `import bantamkit`: the library half, measured from the wheel |
 | [Development](#-development) | Clone, test, lint, conformance |
@@ -144,9 +145,9 @@ CPU architecture and Python minor version** (some wheels, such as `pydantic_core
 one platform only), copy `wheels/` across, and install from it:
 
 ```bash
-python -m pip download "bantamkit[mcp]==0.36.1" -d wheels
+python -m pip download "bantamkit[mcp]==0.36.2" -d wheels
 python -m venv <env>
-<env>/bin/pip install --no-index --find-links wheels "bantamkit[mcp]==0.36.1"
+<env>/bin/pip install --no-index --find-links wheels "bantamkit[mcp]==0.36.2"
 <env>/bin/bantamkit-mcp --install cursor
 ```
 
@@ -373,9 +374,13 @@ python -m bantamkit.memory compact    # archive the stalest facts
 python -m bantamkit.memory archived   # list what compaction has moved out
 python -m bantamkit.memory archive <name>
 python -m bantamkit.memory restore <name>
+python -m bantamkit.memory list [--type T] [--outcome error|success] [--status active|done]
+python -m bantamkit.memory candidates [--older-than DAYS] [--apply]
+python -m bantamkit.memory merge --names A B --name NEW --type T --description D --body TEXT [--apply]
 ```
 
-`archive` moves a fact out without deleting it; `restore` brings it back by name.
+`archive` moves a fact out without deleting it; `restore` brings it back by name. `candidates`
+and `merge` are dry runs unless `--apply` is given.
 Full reference: [docs/memory.md → The operator CLI](https://github.com/Ink01101011/bantamkit/blob/main/docs/memory.md#the-operator-cli).
 
 ## 🔀 Where the Python and Node servers differ

{bantamkit-0.36.1 → bantamkit-0.36.2}/README.md

@@ -43,8 +43,9 @@ Then restart the host (in Claude Code, open a new session) and ask the agent to
 - **Offline after one install.** `--install` records the venv's console script by absolute path,
   so no launch needs the network or your shell's PATH.
 - **Claude Code hooks, if you want them.** `--install-hooks` puts the memory index in front of
-  each new session, surfaces matching facts on each prompt, and nudges a save at the end of a
-  long session that saved nothing
+  each new session, surfaces matching facts on each prompt, mirrors each fact Claude Code writes
+  into its own auto-memory into the project store (one way, new writes only), and nudges a save at
+  the end of a long session that saved nothing
   ([docs/hooks.md](https://github.com/Ink01101011/bantamkit/blob/main/docs/hooks.md)).
 - **More than memory.** JSON Schema validation, a token ledger read off the host's transcripts,
   a skill-catalogue audit, and shift-work tools that plan and hand off multi-step jobs —
@@ -74,7 +75,7 @@ Then restart the host (in Claude Code, open a new session) and ask the agent to
 | [What it serves](#-what-it-serves) | 14 tools, one prompt, two resource templates |
 | [Requirements](#-requirements) | Python and dependencies |
 | [The asset pack](#-the-asset-pack) | `--assets-root`, `BANTAMKIT_ASSETS` |
-| [The operator CLI: `python -m bantamkit.memory`](#-the-operator-cli-python--m-bantamkitmemory) | status, lint, compact, archived, archive, restore |
+| [The operator CLI: `python -m bantamkit.memory`](#-the-operator-cli-python--m-bantamkitmemory) | status, lint, compact, archived, archive, restore, list, candidates, merge |
 | [Where the Python and Node servers differ](#-where-the-python-and-node-servers-differ) | One store; pdf/.doc/.rtf, CLI name, `build_id`, YAML only PyYAML reads |
 | [Module API](#-module-api) | `import bantamkit`: the library half, measured from the wheel |
 | [Development](#-development) | Clone, test, lint, conformance |
@@ -113,9 +114,9 @@ CPU architecture and Python minor version** (some wheels, such as `pydantic_core
 one platform only), copy `wheels/` across, and install from it:
 
 ```bash
-python -m pip download "bantamkit[mcp]==0.36.1" -d wheels
+python -m pip download "bantamkit[mcp]==0.36.2" -d wheels
 python -m venv <env>
-<env>/bin/pip install --no-index --find-links wheels "bantamkit[mcp]==0.36.1"
+<env>/bin/pip install --no-index --find-links wheels "bantamkit[mcp]==0.36.2"
 <env>/bin/bantamkit-mcp --install cursor
 ```
 
@@ -342,9 +343,13 @@ python -m bantamkit.memory compact    # archive the stalest facts
 python -m bantamkit.memory archived   # list what compaction has moved out
 python -m bantamkit.memory archive <name>
 python -m bantamkit.memory restore <name>
+python -m bantamkit.memory list [--type T] [--outcome error|success] [--status active|done]
+python -m bantamkit.memory candidates [--older-than DAYS] [--apply]
+python -m bantamkit.memory merge --names A B --name NEW --type T --description D --body TEXT [--apply]
 ```
 
-`archive` moves a fact out without deleting it; `restore` brings it back by name.
+`archive` moves a fact out without deleting it; `restore` brings it back by name. `candidates`
+and `merge` are dry runs unless `--apply` is given.
 Full reference: [docs/memory.md → The operator CLI](https://github.com/Ink01101011/bantamkit/blob/main/docs/memory.md#the-operator-cli).
 
 ## 🔀 Where the Python and Node servers differ

{bantamkit-0.36.1 → bantamkit-0.36.2}/_assets/skills/memory.md

@@ -12,6 +12,7 @@ past-you would have used. Do this before acting, not after.
 - The user corrects you or states a preference → type "feedback"
 - A durable fact about the user → "user", about ongoing work → "project",
   a URL/dashboard/ticket → "reference"
+- Tag a lesson with outcome: error|success; close a project fact by saving it again with status: done.
 
 ## When NOT to save
 

{bantamkit-0.36.1 → bantamkit-0.36.2}/_assets/tools/memory_recall.json

@@ -1,7 +1,7 @@
 {
   "name": "memory_recall",
   "title": "Recall memories",
-  "description": "Search persistent memory for facts a past session saved. Call it BEFORE starting a task that resembles past work, and when the user refers to something decided earlier; use memory_save to add a fact, and memory_compact or memory_dream only to tidy the store — this tool never changes what a fact says. Reads every layer in order — the project store, any read-only grants in .bantamkit/config.yaml, then the machine-wide profile — and returns the top word matches, never fewer than the store default of 3 when that many match; a query that is exactly a fact's name returns that fact alone. Why it is not read-only: every hit is appended to the usage ledger (~/.bantamkit/usage/<store-id>.jsonl) as a recall event — the staleness order memory_compact archives by — and a project fact file still in the 0.35.x format is rewritten once into the current one; both are best-effort and never fail a recall. A fact file that cannot be read is named in the reply, never silently skipped.",
+  "description": "Search persistent memory for facts a past session saved. Call it BEFORE starting a task that resembles past work, and when the user refers to something decided earlier; use memory_save to add a fact, and memory_compact or memory_dream only to tidy the store — this tool never changes what a fact says. Reads every layer in order — the project store, any read-only grants in .bantamkit/config.yaml, then the machine-wide profile — and returns the top word matches, never fewer than the store default of 3 when that many match; a query that is exactly a fact's name returns that fact alone. Why it is not read-only: every hit is appended to the usage ledger (~/.bantamkit/usage/<store-id>.jsonl) as a recall event — the staleness order memory_compact archives by — and a project fact file still in the 0.35.x format is rewritten once into the current one; both are best-effort and never fail a recall. A fact file that cannot be read is named in the reply, never silently skipped. Pass outcome: error to see only recorded failures.",
   "surfaces": [
     "agent",
     "mcp"
@@ -19,6 +19,14 @@
       "k": {
         "type": "integer",
         "description": "Facts wanted, clamped to 1..5. Raised to the store default of 3 when smaller; never lowered below it."
+      },
+      "outcome": {
+        "type": "string",
+        "enum": [
+          "error",
+          "success"
+        ],
+        "description": "Keep only facts saved with this outcome — `error` answers \"what failed before\", `success` \"what worked\". Facts with no outcome are dropped from the answer; omit it for the normal search."
       }
     },
     "additionalProperties": false

{bantamkit-0.36.1 → bantamkit-0.36.2}/_assets/tools/memory_save.json

@@ -1,7 +1,7 @@
 {
   "name": "memory_save",
   "title": "Save a memory",
-  "description": "Save ONE durable fact to persistent memory — a preference the user stated, a decision, the fix that worked — so a future session can recall it. Use it only for facts a future session needs; never for anything derivable from the repo, git history or docs, nor for one-off state of this conversation. To find a fact use memory_recall; to change one, save again under its EXACT name, which replaces it in place; to free room call memory_compact. Refused with nothing written, each with its own sentence: a description too close to an existing fact's (the reply names that fact — save under that SAME name or skip, never rename to force a copy), a spelling that normalises onto an existing name (`Deploy Command` onto `deploy-command`), and a save that would push the always-loaded index over its byte budget (the reply names the remedy). Every save lands in the writable project store (.bantamkit/memory), never in the profile or a read-only grant, and is appended to the usage ledger.",
+  "description": "Save ONE durable fact to persistent memory — a preference the user stated, a decision, the fix that worked — so a future session can recall it. Use it only for facts a future session needs; never for anything derivable from the repo, git history or docs, nor for one-off state of this conversation. To find a fact use memory_recall; to change one, save again under its EXACT name, which replaces it in place; to free room call memory_compact. Refused with nothing written, each with its own sentence: a description too close to an existing fact's (the reply names that fact — save under that SAME name or skip, never rename to force a copy), a spelling that normalises onto an existing name (`Deploy Command` onto `deploy-command`), and a save that would push the always-loaded index over its byte budget (the reply names the remedy). Every save lands in the writable project store (.bantamkit/memory), never in the profile or a read-only grant, and is appended to the usage ledger. Optional outcome (error|success) tags a lesson and status: done closes a project fact; nothing here archives — that is the operator's bantamkit-memory candidates/merge.",
   "surfaces": [
     "agent",
     "mcp"
@@ -44,6 +44,22 @@
           "type": "string"
         },
         "description": "names of related memories"
+      },
+      "outcome": {
+        "type": "string",
+        "enum": [
+          "error",
+          "success"
+        ],
+        "description": "What the lesson records: `error` (a failure to avoid) or `success` (a way that worked). Only on feedback and project facts; refused on user and reference. Read back by `bantamkit-memory list --outcome` and by memory_recall's `outcome` filter."
+      },
+      "status": {
+        "type": "string",
+        "enum": [
+          "active",
+          "done"
+        ],
+        "description": "Lifecycle of a project fact. Save an existing name with `done` when the work it describes has shipped; `bantamkit-memory candidates` lists done facts for the operator to archive. Absent means active; `active` is never written."
       }
     },
     "additionalProperties": false

{bantamkit-0.36.1 → bantamkit-0.36.2}/src/bantamkit/__init__.py

@@ -29,4 +29,4 @@ from bantamkit.structured import StructuredOutputError, extract_json, structured
 # file as its dynamic version source, so the wheel's metadata and the string the MCP
 # server advertises are the same committed bytes, and neither is a function of when
 # someone last ran `pip`.
-__version__ = "0.36.1"
+__version__ = "0.36.2"

{bantamkit-0.36.1 → bantamkit-0.36.2}/src/bantamkit/hookadapter.py

@@ -73,9 +73,12 @@ from datetime import UTC, datetime
 from pathlib import Path
 from typing import Any
 
+import yaml
+
+from .client import BantamError
 from .memory.component import Memory
 from .memory.layers import discover_project_store, resolve_project_store
-from .memory.store import DURABLE_TYPES, Fact, MemoryStore, tokens
+from .memory.store import DURABLE_TYPES, NAME_MAX_CHARS, Fact, MemoryStore, tokens
 
 # The process clock, for the `ms` on every log line. `time.time()` and not `monotonic`,
 # because the Node module reads `Date.now()` here and the two logs are read side by side.
@@ -1728,21 +1731,33 @@ def _post_save(run: HookRun, payload: dict[str, Any]) -> None:
     ledger["saved"] = int(ledger.get("saved") or 0) + 1
     _write_ledger(run, payload.get("session_id"), ledger)
     cwd = str(payload.get("cwd") or os.getcwd())
-    configured, scope = _configured_index_budget(run, cwd)
-    budget_source = "configured" if configured is not None else "default"
-    budget_scope = scope if configured is not None else None
+    configured, _scope = _configured_index_budget(run, cwd)
     m = (
         Memory.layered(cwd)
         if configured is None
         else Memory.layered(cwd, index_budget=_budget_value(configured))
     )
+    _compact_if_needed(run, payload, cwd, m, {"action": "saved"})
+
+
+def _compact_if_needed(
+    run: HookRun, payload: dict[str, Any], cwd: str, m: Memory, record: dict[str, Any]
+) -> None:
+    """The auto-compact tail shared by `_post_save` and the native mirror (#228).
+
+    `record` already carries `action` (and for the mirror `file`, `name`, `nativeBranch`);
+    it is logged as is when the index is under the band.
+    """
+    configured, scope = _configured_index_budget(run, cwd)
+    budget_source = "configured" if configured is not None else "default"
+    budget_scope = scope if configured is not None else None
     size, budget = m.index_accounting()
     if size is None or size < COMPACT_AT * budget:
         _log(
             run,
             {
+                **record,
                 "event": "PostToolUse",
-                "action": "saved",
                 "bytes": size,
                 "budget": budget,
                 "budgetSource": budget_source,
@@ -2282,6 +2297,142 @@ def _maybe_dream(run: HookRun, payload: dict[str, Any]) -> None:
     )
 
 
+# ---------------------------------------------- PostToolUse[Write|Edit|MultiEdit] -> mirror
+# #228: a fact the host writes into its native memory directory is saved, one way, into the
+# project store. One file per call (the one the tool just wrote); never a scan, never a write
+# into the native directory, never a read of MEMORY.md.
+
+MIRROR_TOOLS = frozenset({"Write", "Edit", "MultiEdit"})
+#: A `.md` path with a `memory` directory segment (the old Stop-nudge shape).
+_MEMORY_SEGMENT = re.compile(r"[\\/]memory[\\/].*\.md\Z", re.DOTALL)
+_WIKILINK = re.compile(r"\[\[([^\]]+)\]\]")
+_MIRROR_NAME = re.compile(r"^[a-z0-9][a-z0-9-]*\Z")
+_MIRROR_TYPES = ("user", "feedback", "project", "reference")
+
+
+def _mirror_name(value: Any) -> str | None:
+    name = str(value).strip().lower().replace(".", "-").replace("_", "-")
+    if not _MIRROR_NAME.match(name) or len(name) > NAME_MAX_CHARS:
+        return None
+    return name
+
+
+def _mirror_links(meta: dict[str, Any], body: str) -> list[str]:
+    raw: list[str] = []
+    listed = meta.get("links")
+    if isinstance(listed, list):
+        raw.extend(str(x) for x in listed)
+    raw.extend(_WIKILINK.findall(body))
+    out: list[str] = []
+    for item in raw:
+        name = _mirror_name(item)
+        if name is not None and name not in out:
+            out.append(name)
+    return out
+
+
+def _parse_native_fact(text: str) -> tuple[dict[str, Any], str] | None:
+    try:
+        _, front, body = text.split("---\n", 2)
+        meta = yaml.safe_load(front)
+    except (ValueError, yaml.YAMLError):
+        return None
+    # NO KEYS IS NO FACT (J74-4): `{}` is a dict to PyYAML and an empty or comment-only
+    # frontmatter is `None`; the port refuses `{}` as #120's empty flow mapping. One rule,
+    # spelled the same on both sides, so all three are a `frontmatter` skip.
+    if not isinstance(meta, dict) or not meta:
+        return None
+    return meta, body
+
+
+def _mirror_native_write(run: HookRun, payload: dict[str, Any]) -> None:
+    ti = payload.get("tool_input")
+    fp = ti.get("file_path") if isinstance(ti, dict) else None
+    if not isinstance(fp, str) or not fp:
+        return
+    native = _resolve_native_memory(run, payload)
+    base: dict[str, Any] = {"event": "PostToolUse", "file": fp, "nativeBranch": native.branch}
+
+    def skip(reason: str, **more: Any) -> None:
+        _log(run, {"action": "mirror-skipped", **base, **more, "reason": reason})
+
+    inside = False
+    if native.dir is not None and fp.endswith(".md") and os.path.basename(fp) != NATIVE_INDEX:
+        root = os.path.realpath(native.dir)
+        parent = os.path.realpath(os.path.dirname(fp))
+        inside = parent == root or (parent + os.sep).startswith(root.rstrip(os.sep) + os.sep)
+    if not inside:
+        if (
+            fp.endswith(".md")
+            and _MEMORY_SEGMENT.search(fp)
+            and os.path.basename(fp) != NATIVE_INDEX
+        ):
+            skip("not-native")
+        return
+    try:
+        with open(fp, encoding="utf-8", errors="replace") as fh:
+            text = fh.read()
+    except OSError:
+        skip("frontmatter")
+        return
+    parsed = _parse_native_fact(text)
+    if parsed is None:
+        skip("frontmatter")
+        return
+    meta, raw_body = parsed
+    nested = meta.get("metadata") if isinstance(meta.get("metadata"), dict) else {}
+    if nested.get("source") == "bantamkit":
+        skip("export-stub")
+        return
+    source = meta.get("name")
+    if not (isinstance(source, str) and source):
+        source = os.path.basename(fp)[: -len(".md")]
+    name = _mirror_name(source)
+    if name is None:
+        skip("name")
+        return
+    fact_type = meta.get("type") if isinstance(meta.get("type"), str) else nested.get("type")
+    if fact_type not in _MIRROR_TYPES:
+        fact_type = "project"
+    # A list or a mapping is not a description (J74-4): `str()` and `String()` spell one
+    # differently, so neither side may turn it into text.
+    raw_description = meta.get("description")
+    if isinstance(raw_description, (list, dict)):
+        raw_description = None
+    description = _collapse_whitespace(raw_description or "")
+    if not description:
+        skip("description", name=name)
+        return
+    body = raw_body.strip()
+    if not body:
+        skip("body", name=name)
+        return
+    links = _mirror_links(meta, body)
+    cwd = str(payload.get("cwd") or os.getcwd())
+    configured, _scope = _configured_index_budget(run, cwd)
+    m = (
+        Memory.layered(cwd)
+        if configured is None
+        else Memory.layered(cwd, index_budget=_budget_value(configured))
+    )
+    try:
+        result = m.store.save(fact_type, name, description, body, tuple(links))
+    except BantamError as e:
+        _log(run, {"action": "mirror-refused", **base, "name": name, "reason": str(e)})
+        return
+    ledger = _read_ledger(run, payload.get("session_id"))
+    ledger["saved"] = int(ledger.get("saved") or 0) + 1
+    _write_ledger(run, payload.get("session_id"), ledger)
+    action = "mirrored" if result.status == "saved" else "mirror-duplicate"
+    _compact_if_needed(
+        run,
+        payload,
+        cwd,
+        m,
+        {"action": action, "file": fp, "name": name, "nativeBranch": native.branch},
+    )
+
+
 # -------------------------------------------------------------------------- Stop
 # The experience collector. Once per session, when the session did real work and nothing
 # durable was written, hand the turn back with one instruction. The host's `type:prompt`
@@ -2289,48 +2440,6 @@ def _maybe_dream(run: HookRun, payload: dict[str, Any]) -> None:
 
 _TOOL_USE = re.compile(r'"type":\s*"tool_use"')
 _SAVE_CALL = re.compile(r'"name":\s*"mcp__bantamkit__memory_save"')
-#: The native write tools whose `file_path` can put a fact into a `memory/` directory.
-_SAVE_WRITE_TOOLS = frozenset({"Write", "Edit", "MultiEdit"})
-#: The path shape of a native memory write: a `.md` under any `memory/` directory. The class
-#: is backslash-or-slash, spelled as a module constant because a backslash inside an f-string
-#: expression is a syntax error before CPython 3.12 and this package supports 3.11.
-_SAVE_WRITE_PATH = re.compile(r"[\\/]memory[\\/].*\.md\Z", re.DOTALL)
-#: A line can only hold a native write if it names one of the tools; the rest are not parsed.
-_SAVE_LINE_HINT = re.compile(r'"name":\s*"(?:Write|Edit|MultiEdit)"')
-
-
-def _transcript_wrote_memory(text: str) -> bool:
-    """Did the transcript WRITE a native memory file (job65, #169)? Only a `tool_use` counts.
-
-    A Write/Edit/MultiEdit whose `file_path` is a `.md` under a `memory/` directory. Before
-    this a regex over the whole text took ANY `"file_path"` under `memory/` -- a Read of
-    `docs/memory/notes.md` included -- as a save, and silenced the nudge. (A `memory_save`
-    call is still recognised by its tool name, as it always was; that half was never the
-    defect.) Lines are prefiltered on the tool names and only those parsed; a line that does
-    not parse is not a save.
-    """
-    for line in text.split("\n"):
-        if not _SAVE_LINE_HINT.search(line):
-            continue
-        try:
-            record = json.loads(line)
-        except ValueError:
-            continue
-        msg = record.get("message") if isinstance(record, dict) else None
-        content = msg.get("content") if isinstance(msg, dict) else None
-        if not isinstance(content, list):
-            continue
-        for block in content:
-            if not isinstance(block, dict) or block.get("type") != "tool_use":
-                continue
-            if block.get("name") not in _SAVE_WRITE_TOOLS:
-                continue
-            ti = block.get("input")
-            fp = ti.get("file_path") if isinstance(ti, dict) else None
-            if isinstance(fp, str) and _SAVE_WRITE_PATH.search(fp):
-                return True
-    return False
-
 
 def _stop(run: HookRun, payload: dict[str, Any]) -> None:
     if payload.get("stop_hook_active"):
@@ -2346,11 +2455,7 @@ def _stop(run: HookRun, payload: dict[str, Any]) -> None:
     except OSError:
         return
     tool_uses = len(_TOOL_USE.findall(text))
-    saved = bool(
-        int(ledger.get("saved") or 0) > 0
-        or _SAVE_CALL.search(text)
-        or _transcript_wrote_memory(text)
-    )
+    saved = bool(int(ledger.get("saved") or 0) > 0 or _SAVE_CALL.search(text))
     if tool_uses < STOP_NUDGE_MIN_TOOL_CALLS or saved:
         _log(run, {"event": "Stop", "action": "pass", "toolUses": tool_uses, "saved": saved})
         return
@@ -2435,6 +2540,8 @@ def run_hook(stdin: Any = None) -> None:
         _append_usage_event(run, payload)
         if payload.get("tool_name") == "mcp__bantamkit__memory_save":
             _post_save(run, payload)
+        elif payload.get("tool_name") in MIRROR_TOOLS:
+            _mirror_native_write(run, payload)
         return
     if event == "PreCompact":
         _pre_compact(run, payload)

{bantamkit-0.36.1 → bantamkit-0.36.2}/src/bantamkit/mcpserver.py

@@ -1464,10 +1464,18 @@ def build_server(memory: Memory, log: EventLog | None = None) -> Any:
         return f'{document[:-2]},\n  "bantamkit_degraded": {key}\n}}'
 
     def memory_save(
-        type: str, name: str, description: str, body: str, links: list[str] | None = None
+        type: str,
+        name: str,
+        description: str,
+        body: str,
+        links: list[str] | None = None,
+        outcome: str | None = None,
+        status: str | None = None,
     ) -> str:
         with _record_raise(log, "memory_save"):
-            outcome = memory.save_outcome(type, name, description, body, links)
+            outcome_ = memory.save_outcome(
+                type, name, description, body, links, outcome=outcome, status=status
+            )
         if log.enabled:
             # Only when a log is actually on: `index_accounting` re-parses `facts/`, and
             # a diagnostic must not put that on the path of an operator who did not ask
@@ -1477,10 +1485,10 @@ def build_server(memory: Memory, log: EventLog | None = None) -> Any:
             detail: dict[str, Any] = {"budget": budget}
             if index_bytes is not None:
                 detail["index_bytes"] = index_bytes
-            log.record("memory_save", outcome.status, detail)
-        return _noted(outcome.reply)
+            log.record("memory_save", outcome_.status, detail)
+        return _noted(outcome_.reply)
 
-    def memory_recall(query: str, k: int | None = None) -> str:
+    def memory_recall(query: str, k: int | None = None, outcome: str | None = None) -> str:
         if k is not None:
             # Clamped, not refused, and the manifest says so: `assets/tools/memory_recall.json`
             # used to advertise `minimum: 1, maximum: 5` on `k` while this line and the
@@ -1490,19 +1498,19 @@ def build_server(memory: Memory, log: EventLog | None = None) -> Any:
             # answer for a stricter one. The description now states the clamp.
             k = max(1, min(k, 5))
         with _record_raise(log, "memory_recall"):
-            outcome = memory.recall_outcome(query, k)
+            outcome_ = memory.recall_outcome(query, k, outcome=outcome)
         detail = {
-            "budget": outcome.budget,
-            "candidates": outcome.candidates,
-            "layers": outcome.layers,
-            "reached": outcome.reached,
-            "returned": outcome.returned,
-            "unreadable": outcome.unreadable,
+            "budget": outcome_.budget,
+            "candidates": outcome_.candidates,
+            "layers": outcome_.layers,
+            "reached": outcome_.reached,
+            "returned": outcome_.returned,
+            "unreadable": outcome_.unreadable,
         }
-        if outcome.source is not None:
-            detail["source"] = outcome.source
-        log.record("memory_recall", outcome.status, detail)
-        return _noted(outcome.reply)
+        if outcome_.source is not None:
+            detail["source"] = outcome_.source
+        log.record("memory_recall", outcome_.status, detail)
+        return _noted(outcome_.reply)
 
     def memory_compact(reserve: int | None = None) -> str:
         """The model's half of compaction; the hook (`docs/hooks.md`) is the automatic half.