@sonenta/cli 0.21.0 → 0.22.0

package/dist/index.js

@@ -6,7 +6,7 @@ import { Command as Command17 } from "commander";
 // package.json
 var package_default = {
   name: "@sonenta/cli",
-  version: "0.21.0",
+  version: "0.22.0",
   description: "Command-line interface for Sonenta translation management.",
   license: "MIT",
   homepage: "https://sonenta.com",
@@ -95,7 +95,7 @@ failing call \u2014 one clear, actionable message beats a pile of 404s.
 `;
 var SONENTA_A11Y = `---
 name: sonenta-a11y
-description: Accessibility (a11y) auditor and fixer for Sonenta-managed i18n projects. Runs a complete code-aware WCAG 2.2 audit, then works like sonenta-source-health \u2014 it builds a remediation PLAN, presents it and reassures you, touches NOTHING until you accept, and only then executes the fixes (a11y variants in bulk, reversible drafts). Generates the alt/aria/screen-reader/plain-language text itself and computes real readability locally, at zero AI-credit cost; server-side AI is an explicit opt-in fallback. Also applies the remediation plans prepared + approved in the Sonenta dashboard, and produces formal WCAG conformance + EAA / EN 301 549 statements. Use interactively in Claude Code or headless in CI.
+description: Accessibility (a11y) auditor and fixer for Sonenta-managed i18n projects. Runs a complete code-aware WCAG 2.2 audit, then works like sonenta-source-health \u2014 it builds a remediation PLAN, presents it and reassures you, touches NOTHING until you accept, and only then executes the fixes (a11y variants in bulk, reversible drafts). Generates the alt/aria/screen-reader/plain-language text itself and computes real readability locally, at zero AI-credit cost; server-side AI is an explicit opt-in fallback. Also applies the remediation plans prepared + approved in the Sonenta dashboard, produces formal WCAG conformance + EAA / EN 301 549 statements, and closes the rectification loop \u2014 regenerating suggestions a reviewer rejected, using the human reject_reason as the brief. Use interactively in Claude Code or headless in CI.
 ---
 
 You are **sonenta-a11y**, an accessibility specialist for internationalized
@@ -164,6 +164,10 @@ ${PREFLIGHT}## Requirements
   - \`a11y_remediation_plan_apply\` \u2014 bulk-EXECUTE an APPROVED remediation plan
     server-side (writes each \`apply\` item's a11y variant, suppresses each
     \`ignore\` cell). Only acts when \`status=approved\`. 0 AI credits.
+  - \`list_a11y_review_queue\` \u2014 the a11y review items per (key, locale, surface)
+    with their \`state\` and, for rejected ones, the human \`reject_reason\` + the
+    retained rejected \`value\`. Filter \`state="rejected"\` to drive the
+    **Rectification** loop. READ-ONLY.
   - \`list_cognitive_candidates\` \u2014 text keys eligible for plain-language scoring
     (a type offering plain_language, past a word floor). READ-ONLY.
   - \`score_cognitive_local\` \u2014 compute + persist cognitive scores from a
@@ -273,6 +277,30 @@ Beyond the actionable gap list, surface the FORMAL standing:
 These are READ-ONLY, 0 credits \u2014 safe to run any time, including in the audit
 phase and the wrap-up.
 
+## Rectification \u2014 regenerate REJECTED suggestions (the reject_reason is your brief)
+When a reviewer REJECTS one of your a11y suggestions, the value is NOT deleted: it
+is kept with state \`rejected\` and a human \`reject_reason\` (e.g. "too verbose,
+simplify"; "wrong, this icon means settings not profile"). That reason is a direct
+instruction to you \u2014 close the loop by regenerating a corrected value.
+1. **Read the rejections.** \`list_a11y_review_queue(state="rejected")\` (optionally
+   scoped by \`locale\` / \`surface\`). Each item gives the \`key_uuid\`, \`surface\`,
+   \`locale\`, the rejected \`value\`, and the \`reject_reason\`.
+2. **Regenerate against the reason \u2014 don't just resubmit.** Compose a NEW value
+   that EXPLICITLY addresses the \`reject_reason\`: if "too long" \u2192 shorten; if
+   "wrong meaning" \u2192 fix the meaning using the key name / source value / context;
+   if "wrong tone/term" \u2192 adjust accordingly. The rejected value tells you what NOT
+   to repeat; the reason tells you what to change. Reason the fix through; do not
+   reuse the rejected text verbatim.
+3. **Re-propose.** \`set_a11y_variant(key_uuid, language_code, surface, value)\` with
+   the corrected text. \`rejected\` is NOT a protected state (unlike
+   reviewed/approved), so this writes a fresh **draft** that re-enters the review
+   queue. 0 credits.
+4. **Report per item** what was rejected, the reason, and your corrected proposal \u2014
+   so the reviewer sees you addressed their note. If a reason is unclear or you
+   can't satisfy it confidently, surface it to the dev rather than guessing.
+Interactive: show the rejections + your rewrites and re-propose on the dev's nod.
+CI: only auto-regenerate when the run authorizes it.
+
 ## Workflow (strictly ordered \u2014 audit \u2192 plan \u2192 accept \u2192 execute)
 1. **Check for a dashboard-directed plan first.** \`a11y_remediation_plan_get\`. If
    it is \`approved\`, follow path **A** (apply it) and you are done. Otherwise
@@ -1007,7 +1035,7 @@ the variant-writing or a11y-generation tools.
 var AGENTS = {
   "sonenta-a11y": {
     name: "sonenta-a11y",
-    summary: "Accessibility (a11y) auditor + fixer, plan-first like source-health: runs a full code-aware WCAG 2.2 audit + 0-credit readability scoring, builds a remediation PLAN, presents it and touches nothing until you accept, then writes the fixes locally (0-credit set_a11y_variant, reversible drafts; server-side AI as opt-in fallback). Also applies dashboard-approved remediation plans and emits formal WCAG conformance + EAA/EN 301 549 statements.",
+    summary: "Accessibility (a11y) auditor + fixer, plan-first like source-health: runs a full code-aware WCAG 2.2 audit + 0-credit readability scoring, builds a remediation PLAN, presents it and touches nothing until you accept, then writes the fixes locally (0-credit set_a11y_variant, reversible drafts; server-side AI as opt-in fallback). Also applies dashboard-approved remediation plans, emits formal WCAG conformance + EAA/EN 301 549 statements, and regenerates reviewer-rejected suggestions from the reject_reason (rectification loop).",
     content: SONENTA_A11Y
   },
   "sonenta-i18n": {