Aller au contenu

mark_cluster_applied

Mark ONE cluster of a duplicate group's merge plan as APPLIED - addressed by the group's source_value + the cluster's canonical_key_uuid. Call it after you have repointed the redundant keys' t() usages onto the canonical and trashed them (delete_keys_bulk), so the dashboard tracks per-cluster progress. Pass applied=false to UN-mark it. Once every cluster of the group is applied (and the survivor_outcome handled), set_duplicate_status(resolved) closes the group.

NomTypeDescription
project_uuidstringoptionnelProject UUID. Required when multiple projects are configured (SONENTA_PROJECTS); defaults to the single configured project otherwise.
source_valuestringrequisThe shared source-language value identifying the duplicate group.
canonical_key_uuidstringrequisThe surviving canonical key of the cluster to mark applied.
appliedbooleanoptionnelTrue to mark applied (default), false to un-mark.
files_modifiedarrayoptionnelOptional 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.
{
"tool": "mark_cluster_applied",
"arguments": {
"source_value": "<source_value>",
"canonical_key_uuid": "<canonical_key_uuid>"
}
}