set_cognitive_score

Record a key's cognitive-difficulty SCORE (0-100, higher = harder to read) and an optional plain-language SUGGESTION - the local-first, 0-credit path. Use this after scoring a candidate YOURSELF: you (the agent) judge the difficulty and write a clearer rewrite, then persist both here (marked by_bot). A key only enters the review queue (reading_level_high) once its score is >= the project threshold (default 60). The suggestion is a draft for a human to apply/approve.

Parameters

Name	Type		Description
project_uuid	string	optional	Project UUID. Required when multiple projects are configured (SONENTA_PROJECTS); defaults to the single configured project otherwise.
key_uuid	string	required	Key UUID (from list_cognitive_candidates / list_keys).
score	number	required	Cognitive difficulty score, 0 (easy) to 100 (hard).
suggestion	string	optional	Optional plain-language rewrite of the source value (draft).

Example

{
  "tool": "set_cognitive_score",
  "arguments": {
    "key_uuid": "<key_uuid>",
    "score": 0
  }
}