@sonenta/mcp 0.30.0 → 0.32.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sonenta/mcp",
-  "version": "0.30.0",
+  "version": "0.32.0",
   "description": "MCP server for Sonenta translation management \u2014 wires Claude Desktop and other MCP clients into your project's keys, missing-key feed, and translation drafts.",
   "license": "MIT",
   "homepage": "https://sonenta.com",

package/python/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "sonenta-mcp"
-version = "0.30.0"
+version = "0.32.0"
 description = "Model Context Protocol server for Sonenta — list projects, missing keys, propose translations from Claude Desktop and other MCP clients."
 readme = "README.md"
 requires-python = ">=3.12,<3.14"

package/python/verbumia_mcp/__init__.py

@@ -1,3 +1,3 @@
 """Sonenta MCP server (MIT)."""
 
-__version__ = "0.30.0"
+__version__ = "0.32.0"

package/python/verbumia_mcp/tools.py

@@ -89,23 +89,33 @@ from .client import VerbumiaApiError, VerbumiaClient
 # visible text. `surfaceKinds` in the variants matrix tags each as a11y.
 A11Y_SURFACES = ("aria_label", "alt_text", "screen_reader", "plain_language")
 
-# RS1 (task 1367): audit trail of code edits an agent made while resolving a
-# duplicate group — passed on set_source_duplicate_merge_plan / set_duplicate_status,
-# persisted + surfaced in resolved_duplicates[]. Supplying it overwrites; omitting
-# preserves the prior value.
+# RS1 (1367) + FM1 (1390) + FF1 (1397): audit trail of t() repoints an agent made
+# while resolving a duplicate group — accepted on ALL FOUR resolution paths
+# (set_source_duplicate_merge_plan, set_duplicate_status, apply_new_key_cluster,
+# mark_cluster_applied), persisted + surfaced in resolved_duplicates[]. UNION-MERGE
+# (accumulate + dedup by normalized entry). FF1 split key_name into found_key +
+# replacement_key (key_name kept, deprecated).
 _FILES_MODIFIED_SCHEMA = {
     "type": "array",
     "description": (
-        "Optional audit trail of the code edits you made (e.g. t() repoints) while "
-        "resolving this group: each {path (required), line?, key_name?}. Supplying it "
-        "overwrites the stored record; omit to preserve the prior value."
+        "Optional audit trail of the t() repoints you made while resolving this group: "
+        "each {path (required), line?, found_key, replacement_key, occurrences?}. "
+        "`found_key` = the key string that WAS in the code at this spot (the old, "
+        "redundant one); `replacement_key` = the canonical you repointed it to (an "
+        "existing survivor, OR the new_key from apply_new_key_cluster). Accepted on "
+        "every resolution path and MERGED (union + dedup by the full normalized entry) "
+        "— record edits at whatever step you make them and they accumulate; omit to "
+        "preserve the existing list. Always pass the STRUCTURED field, never just a note."
     ),
     "items": {
         "type": "object",
         "properties": {
             "path": {"type": "string", "description": "Repo-relative file path that was edited."},
             "line": {"type": "integer", "description": "Optional 1-based line number of the edit."},
-            "key_name": {"type": "string", "description": "Optional key (namespace::name or name) the edit concerns."},
+            "found_key": {"type": "string", "description": "The OLD key found in the code at this spot (the redundant one being repointed away)."},
+            "replacement_key": {"type": "string", "description": "The CANONICAL key you repointed to (an existing survivor, or the created new_key)."},
+            "occurrences": {"type": "integer", "description": "Optional count of how many usages you replaced here."},
+            "key_name": {"type": "string", "description": "DEPRECATED (pre-FF1 single field) — prefer found_key + replacement_key."},
         },
         "required": ["path"],
         "additionalProperties": False,
@@ -2291,6 +2301,7 @@ def register(server: Server, client: VerbumiaClient) -> tuple[Any, Any]:
                             "type": "boolean",
                             "description": "True to mark applied (default), false to un-mark.",
                         },
+                        "files_modified": _FILES_MODIFIED_SCHEMA,
                     },
                     "required": ["source_value", "canonical_key_uuid"],
                     "additionalProperties": False,
@@ -2308,8 +2319,8 @@ def register(server: Server, client: VerbumiaClient) -> tuple[Any, Any]:
                     "the name must be free). Returns {new_key_uuid, name, namespace, "
                     "copied_from_key_uuid, copied_languages, trashed_key_uuids}. YOUR job "
                     "after this is the CODE only: repoint every t() usage of the trashed "
-                    "keys onto new_key_uuid, then record it via set_source_duplicate_merge_"
-                    "plan / set_duplicate_status files_modified. You do NOT create_key or "
+                    "keys onto new_key_uuid, and record those edits in `files_modified` "
+                    "(accepted right here, union-merged). You do NOT create_key or "
                     "delete_keys_bulk yourself — the backend owns that. Author the "
                     "new_key cluster in the merge plan first (on the dev's acceptance)."
                 ),
@@ -2333,6 +2344,7 @@ def register(server: Server, client: VerbumiaClient) -> tuple[Any, Any]:
                             },
                             "required": ["name", "namespace"],
                         },
+                        "files_modified": _FILES_MODIFIED_SCHEMA,
                     },
                     "required": ["source_value", "new_key"],
                     "additionalProperties": False,
@@ -3088,6 +3100,8 @@ def register(server: Server, client: VerbumiaClient) -> tuple[Any, Any]:
                 }
                 if "applied" in args:
                     body["applied"] = bool(args["applied"])
+                if args.get("files_modified"):
+                    body["files_modified"] = args["files_modified"]
                 data = await client.put(
                     f"/v1/mcp/projects/{project_uuid}/source-duplicates/cluster-applied",
                     json=body,
@@ -3100,9 +3114,12 @@ def register(server: Server, client: VerbumiaClient) -> tuple[Any, Any]:
                     return _err("source_value and new_key {name, namespace} are required")
                 if not new_key.get("name") or not new_key.get("namespace"):
                     return _err("new_key requires name and namespace")
+                body = {"source_value": args["source_value"], "new_key": new_key}
+                if args.get("files_modified"):
+                    body["files_modified"] = args["files_modified"]
                 data = await client.post(
                     f"/v1/mcp/projects/{project_uuid}/source-duplicates/apply-cluster",
-                    json={"source_value": args["source_value"], "new_key": new_key},
+                    json=body,
                 )
                 return _text(data)
             return _err(f"unknown tool: {name}")