@sonenta/mcp 0.31.0 → 0.33.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sonenta/mcp",
-  "version": "0.31.0",
+  "version": "0.33.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.31.0"
+version = "0.33.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.31.0"
+__version__ = "0.33.0"

package/python/verbumia_mcp/tools.py

@@ -89,27 +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) + FM1 (task 1390): audit trail of code edits an agent made while
-# resolving a duplicate group — accepted on ALL FOUR resolution paths
+# 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[]. FM1 changed
-# the semantics to UNION-MERGE (accumulate + dedup by tuple), not overwrite.
+# 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?}. Accepted on "
-        "every resolution path and MERGED (union + dedup by the full {path,line,"
-        "key_name} tuple) into the record — so record your 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."
+        "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,
@@ -1377,6 +1383,44 @@ def register(server: Server, client: VerbumiaClient) -> tuple[Any, Any]:
                     "additionalProperties": False,
                 },
             ),
+            Tool(
+                name="list_untranslated_surfaces",
+                description=(
+                    "The TRANSLATION MAP: every a11y surface cell that has an APPROVED "
+                    "SOURCE value but is missing the target-language translation, WITH that "
+                    "source value to translate from. Returns {cells: [{key_uuid, key_name, "
+                    "namespace_slug, key_type, surface, language_code, source_value}]}. Use "
+                    "this to fill a11y surfaces (aria_label / alt_text / screen_reader / "
+                    "plain_language) by FAITHFULLY translating each source_value into the "
+                    "missing language — do NOT invent new content — then write each with "
+                    "set_a11y_variant(key_uuid, language_code, surface, <translation>). "
+                    "Optionally filter by surface and/or language_code. (Local-first: you "
+                    "translate; 0 AI credits. The billed server path is translate_a11y_variants.)"
+                ),
+                inputSchema={
+                    "type": "object",
+                    "properties": {
+                        "project_uuid": {
+                            "type": "string",
+                            "description": "Project UUID. Required when multiple projects are configured (SONENTA_PROJECTS); defaults to the single configured project otherwise.",
+                        },
+                        "surface": {
+                            "type": "string",
+                            "enum": list(A11Y_SURFACES),
+                            "description": "Optional: only this a11y surface.",
+                        },
+                        "language_code": {
+                            "type": "string",
+                            "description": "Optional: only this target language (BCP-47).",
+                        },
+                        "version_id": {
+                            "type": "string",
+                            "description": "Optional version UUID; defaults to the production version.",
+                        },
+                    },
+                    "additionalProperties": False,
+                },
+            ),
             Tool(
                 name="set_a11y_variant",
                 description=(
@@ -2785,6 +2829,33 @@ def register(server: Server, client: VerbumiaClient) -> tuple[Any, Any]:
                         "gaps": gaps,
                     }
                 )
+            if name == "list_untranslated_surfaces":
+                project_uuid = _project_uuid(args, client)
+                params: dict[str, Any] = {"include_untranslated": True}
+                if args.get("version_id"):
+                    params["version_id"] = args["version_id"]
+                report = await client.get(
+                    f"/v1/mcp/projects/{project_uuid}/a11y-report", params=params
+                )
+                items = report.get("items", []) if isinstance(report, dict) else []
+                surf_f = args.get("surface")
+                lang_f = args.get("language_code")
+                cells = [
+                    {
+                        "key_uuid": it.get("key_uuid"),
+                        "key_name": it.get("key_name"),
+                        "namespace_slug": it.get("namespace_slug"),
+                        "key_type": it.get("key_type"),
+                        "surface": it.get("surface"),
+                        "language_code": it.get("locale"),
+                        "source_value": it.get("source_value"),
+                    }
+                    for it in items
+                    if it.get("gap") == "a11y_untranslated"
+                    and (surf_f is None or it.get("surface") == surf_f)
+                    and (lang_f is None or it.get("locale") == lang_f)
+                ]
+                return _text({"project_uuid": project_uuid, "count": len(cells), "cells": cells})
             if name in ("set_a11y_variant", "delete_a11y_variant"):
                 project_uuid = _project_uuid(args, client)
                 key_uuid = args.get("key_uuid")