@cat-factory/app 0.195.0 → 0.195.2

package/app/utils/estimateGating.ts

@@ -0,0 +1,60 @@
+/**
+ * The three axes a `task-estimator` step scores a task on, and the presentation vocabulary every
+ * surface that lets a human gate work on them shares.
+ *
+ * Deliberately NOT `RISK_POLICY_AXES`: those are the axes a `merger` scores a finished pull
+ * request on, and although the three names coincide, the two are produced by different agents at
+ * different points in a run and mean different things to a reader. Folding them together would
+ * make a rename in one silently retitle the other.
+ */
+export const ESTIMATE_AXES = ['complexity', 'risk', 'impact'] as const
+
+export type EstimateAxis = (typeof ESTIMATE_AXES)[number]
+
+/**
+ * Axis → label key. Exhaustive over the union with LITERAL catalog keys, so the typed-message-key
+ * check sees them and a new axis fails the typecheck rather than rendering a raw key.
+ */
+export const ESTIMATE_AXIS_LABEL_KEYS: Record<EstimateAxis, string> = {
+  complexity: 'pipeline.builder.complexityThreshold',
+  risk: 'pipeline.builder.riskThreshold',
+  impact: 'pipeline.builder.impactThreshold',
+}
+
+/**
+ * Axis → the `StepGating`/`ConsensusGating` field carrying its floor. Both schemas spell the
+ * three the same way, which is what lets one editor serve every gate in the builder.
+ */
+export const ESTIMATE_AXIS_FIELD: Record<EstimateAxis, 'minComplexity' | 'minRisk' | 'minImpact'> =
+  {
+    complexity: 'minComplexity',
+    risk: 'minRisk',
+    impact: 'minImpact',
+  }
+
+/** Axis → the tooltip explaining what the axis measures and on what scale. Same discipline. */
+export const ESTIMATE_AXIS_HINT_KEYS: Record<EstimateAxis, string> = {
+  complexity: 'pipeline.builder.complexityThresholdHint',
+  risk: 'pipeline.builder.riskThresholdHint',
+  impact: 'pipeline.builder.impactThresholdHint',
+}
+
+/**
+ * Read one axis threshold field back into a stored floor.
+ *
+ * An emptied or unparseable field CLEARS the axis rather than storing `0`, which is the whole
+ * reason this is a function: the two are opposites. An unset axis is not considered at all,
+ * where a floor of `0` is cleared by every estimate there is — so a user who deletes the number
+ * to stop gating on risk would, under a `?? 0`, have gated on it permanently instead.
+ *
+ * The scale is the estimator's 0..1, and a value outside it is CLAMPED rather than rejected, so
+ * a fat-fingered `10` lands on the ceiling instead of silently failing the pipeline save with a
+ * 422 from the contract's score bounds.
+ */
+export function parseAxisThreshold(raw: string): number | undefined {
+  const trimmed = raw.trim()
+  if (trimmed === '') return undefined
+  const parsed = Number.parseFloat(trimmed)
+  if (!Number.isFinite(parsed)) return undefined
+  return Math.min(1, Math.max(0, parsed))
+}

package/app/utils/initiative.spec.ts

@@ -9,6 +9,7 @@ import {
   isPendingQuestion,
   orderInterviewQuestions,
   pendingCheckpointPhase,
+  planReviewDocument,
   selectPlanApproval,
 } from './initiative'
 
@@ -205,6 +206,48 @@ describe('selectPlanApproval', () => {
   })
 })
 
+// Which shape the plan gate takes in the tracker window: a document review that OWNS the window, or
+// the compact notice above the tracker's own sections. Both the window's layout and the review
+// surface read this one value, so these pin the cases where "there is a plan to read" is not the
+// same as "the proposal is non-empty".
+
+describe('planReviewDocument', () => {
+  const gate = (proposal: string | null | undefined, outputIsRendered: boolean) => ({
+    approval: { proposal },
+    outputIsRendered,
+  })
+
+  it('is the proposal when the step says it IS the plan rendering', () => {
+    expect(planReviewDocument(gate('# Initiative plan\n\n## Goal', true))).toBe(
+      '# Initiative plan\n\n## Goal',
+    )
+  })
+
+  it('returns the proposal verbatim, so comment anchors stay on the lines they quote', () => {
+    // Anchoring is by SOURCE LINE, so trimming a leading newline would shift every anchor up one.
+    expect(planReviewDocument(gate('\n# Initiative plan\n', true))).toBe('\n# Initiative plan\n')
+  })
+
+  it('reads an un-rendered proposal as no document, however substantial it looks', () => {
+    // The planner's transcript summary: a perfectly non-empty string that is not the plan. Showing
+    // it under a table of contents is the failure the rendered review exists to end.
+    expect(
+      planReviewDocument(gate('I drafted a three-phase plan and stopped for review.', false)),
+    ).toBe('')
+  })
+
+  it('reads a rendered but blank proposal as no document', () => {
+    expect(planReviewDocument(gate('   \n  ', true))).toBe('')
+    expect(planReviewDocument(gate(null, true))).toBe('')
+    expect(planReviewDocument(gate(undefined, true))).toBe('')
+  })
+
+  it('has no document when nothing is parked', () => {
+    expect(planReviewDocument(null)).toBe('')
+    expect(planReviewDocument(undefined)).toBe('')
+  })
+})
+
 /**
  * These tables are the reason the initiative card and the inspector word one park identically,
  * and they are exactly the shape both i18n drift guards are blind to: the typed-key check and

package/app/utils/initiative.ts

@@ -103,6 +103,29 @@ export function selectPlanApproval<A extends { agentKind: string }>(
   return approvals.find((a) => resultViewOf(a.agentKind) !== INTERVIEW_GATE_RESULT_VIEW)
 }
 
+/**
+ * The plan DOCUMENT a parked gate offers for review — its proposal, but only once the step says
+ * that proposal IS the plan rendering (`outputIsRendered`); `''` otherwise.
+ *
+ * A step that rendered nothing parks on the planner's transcript SUMMARY, which is a perfectly
+ * non-empty string, so an emptiness check alone would present one sentence under a table of
+ * contents as though it were the plan. `''` is what routes such a gate to the compact notice
+ * instead — and the SAME value decides the tracker window's layout (a document review takes the
+ * whole window; a notice sits above the tracker's own sections), so the surface and its host can
+ * never disagree about which shape is on screen.
+ *
+ * Rendered-but-blank counts as no document. The proposal comes back VERBATIM, never trimmed: the
+ * review anchors comments to source LINE numbers, so dropping a leading newline would shift every
+ * anchor off the block it quotes.
+ */
+export function planReviewDocument(
+  gate: { approval: { proposal?: string | null }; outputIsRendered: boolean } | null | undefined,
+): string {
+  if (!gate?.outputIsRendered) return ''
+  const proposal = gate.approval.proposal ?? ''
+  return proposal.trim() ? proposal : ''
+}
+
 /** Follow-up triage status → i18n label key. Exhaustive so a new status fails the build. */
 export const INITIATIVE_FOLLOWUP_STATUS_LABEL_KEYS: Record<InitiativeFollowUp['status'], string> = {
   open: 'initiative.followUpStatus.open',

package/i18n/locales/de.json

@@ -1629,6 +1629,7 @@
       },
       "subtasks": "Teilaufgaben · {completed}/{total}",
       "standardsApplied": "Angewendete Standards",
+      "standardsAppliedHint": "Die Best-Practice-Standards, die in den System-Prompt dieses Schritts eingefügt wurden. Ein umsetzender Agent erhält von jedem eine gekürzte Fassung; Reviewer und Planer bekommen den vollen Text.",
       "decision": "Entscheidung",
       "awaitingChoice": "Wartet auf eine menschliche Wahl",
       "approvalGate": "Freigabe-Gate",
@@ -1696,13 +1697,16 @@
       "effort": {
         "heading": "Agenten-Aufwand",
         "difficulty": "Schwierigkeit",
+        "difficultyHint": "Die eigene Einschätzung des Agenten, wie schwer dieser Schritt war, von zehn. Selbst angegeben, nicht gemessen.",
         "outOfTen": "{value}/10",
         "reduced": "Was die Effektivität verringert hat",
         "obstacles": "Wichtigste Hindernisse"
       },
       "adherence": {
         "heading": "Einhaltung der Best Practices",
+        "headingHint": "Die Best-Practice-Standards, die in den Prompt dieses Reviewers eingefügt wurden, und wie genau die Änderung ihnen nach seinem Urteil folgt.",
         "outOfTen": "{value}/10",
+        "ratingHint": "Die eigene Bewertung des Reviewers, wie genau die Änderung diesem Standard folgt, von zehn. Selbst angegeben, nicht gemessen.",
         "relatedFindings": "Zugehörige Befunde",
         "unnamed": "Standard"
       },
@@ -2558,6 +2562,14 @@
         "pr_ready": "Aktiv",
         "done": "Live"
       },
+      "statusHint": {
+        "planned": "Für diesen Service gibt es noch keine Aufgaben. Ein Service wird nie fertig, das hier ist also der Anfang und kein Stillstand.",
+        "ready": "Alle Aufgaben unter diesem Service ruhen oder sind gemergt. Es läuft nichts und nichts wartet auf Sie.",
+        "in_progress": "Mindestens eine Aufgabe unter diesem Service läuft oder hat einen offenen Pull Request.",
+        "blocked": "Mindestens eine Aufgabe oder Initiative unter diesem Service wartet auf eine Entscheidung von Ihnen.",
+        "pr_ready": "Mindestens eine Aufgabe unter diesem Service läuft oder hat einen offenen Pull Request.",
+        "done": "Alle Aufgaben unter diesem Service ruhen oder sind gemergt. Es läuft nichts und nichts wartet auf Sie."
+      },
       "shared": "Geteilt",
       "sharedTitle": "Über Workspaces in dieser Organisation hinweg geteilt",
       "bootstrapping": "Wird gebootstrappt…",
@@ -3241,7 +3253,9 @@
     },
     "legend": {
       "metered": "Abgerechnet",
-      "subscription": "Abo"
+      "meteredHint": "Vom Anbieter pro Token abgerechnet. Das ist echtes Geld.",
+      "subscription": "Abo",
+      "subscriptionHint": "Nur zur Veranschaulichung. Diese Aufrufe liefen über einen Pauschaltarif; der Betrag zeigt, was dieselben Token über eine abgerechnete API gekostet hätten. Er wurde nie in Rechnung gestellt und zählt nie als Ausgabe."
     },
     "spend": {
       "byModel": "Kosten nach Modell",
@@ -3598,9 +3612,14 @@
       "companionGateTooltip": "Diesen Companion nur ausführen, wenn die Aufgabenschätzung einen Schwellenwert überschreitet (benötigt vorher einen Task Estimator)",
       "consensusGateTooltip": "Konsens nur ausführen, wenn die Aufgabenschätzung einen Schwellenwert überschreitet (sonst läuft der Standard-Agent)",
       "runWhenAny": "ausführen wenn (beliebig):",
+      "gatingRunWhenAnyHint": "Der Schritt läuft, sobald eine dieser Achsen erreicht oder überschritten wird, und wird sonst übersprungen. Liegt keine Schätzung vor, läuft er trotzdem.",
+      "gatingRunWhenAnyConsensusHint": "Das Panel tagt, sobald eine dieser Achsen erreicht oder überschritten wird; darunter läuft stattdessen der einzelne Agent. Liegt keine Schätzung vor, tagt das Panel trotzdem.",
       "complexityThreshold": "Komplexität ≥",
+      "complexityThresholdHint": "Wie aufwendig die Umsetzung ist, bewertet vom Task Estimator weiter oben in der Pipeline. Die Skala reicht von 0 bis 1, nicht von 1 bis 10. Leer lassen, um diese Achse zu ignorieren.",
       "riskThreshold": "Risiko ≥",
+      "riskThresholdHint": "Wie viel die Änderung kaputt machen könnte, bewertet vom Task Estimator weiter oben in der Pipeline. Die Skala reicht von 0 bis 1, nicht von 1 bis 10. Leer lassen, um diese Achse zu ignorieren.",
       "impactThreshold": "Auswirkung ≥",
+      "impactThresholdHint": "Wie weit die Änderung ins System hineinreicht, bewertet vom Task Estimator weiter oben in der Pipeline. Die Skala reicht von 0 bis 1, nicht von 1 bis 10. Leer lassen, um diese Achse zu ignorieren.",
       "strategy": "Strategie",
       "rounds": "Runden",
       "purposeLabel": "Zweck",
@@ -3755,6 +3774,7 @@
       "stepLabel": "Ausgabebudget",
       "kindLabel": "Ausgabebudget",
       "kindHint": "Gilt für jeden Lauf dieses Agenten. Ein Pipeline-Schritt kann es überschreiben.",
+      "hint": "Der Höchstumfang einer einzelnen Antwort dieses Agenten. Leer lassen heißt vom nächsthöheren Level erben, nicht das Limit aufheben. Der Wert eines Pipeline-Schritts sticht die Vorgabe des Workspace.",
       "inherits": "Übernommen",
       "inheritsValue": "Übernommen ({tokens})"
     }
@@ -4426,11 +4446,12 @@
     },
     "planReview": {
       "title": "Dieser Plan wartet auf dich",
-      "body": "Der Planner hat die Phasen und Aufgaben unten entworfen. Gib sie frei, um den Plan zu committen und die Arbeit zu starten, oder schicke den Plan mit deinen Änderungswünschen zurück.",
+      "body": "Der Planner hat diese Phasen und Aufgaben entworfen. Gib sie frei, um den Plan zu committen und die Arbeit zu starten, oder schicke den Plan mit deinen Änderungswünschen zurück.",
       "approve": "Plan freigeben",
       "feedbackPlaceholder": "Was soll der Planner ändern? Umfang, Reihenfolge der Phasen, fehlende Arbeit, eine Aufgabe, die woanders hingehört …",
       "sendBack": "An den Planner zurückschicken",
-      "noDocument": "Dieser Plan entstand, bevor die Plattform Pläne zur Prüfung gerendert hat — es gibt kein Dokument zum Navigieren; die Abschnitte unten sind der Plan.",
+      "noDocument": "Dieser Planungsschritt hat kein Plandokument zur Prüfung hinterlassen, es gibt hier also nichts zu navigieren.",
+      "noDocumentSections": "Der Plan sind die Abschnitte unten.",
       "needsFeedback": "Füge zuerst einen Kommentar oder eine Rückmeldung hinzu — der Planer plant damit neu.",
       "commentHint": "Klicke auf einen Teil des Plans, um ihn zu kommentieren."
     },
@@ -4894,6 +4915,7 @@
     "empty": "Dieser Schritt hat noch kein Urteil erzeugt.",
     "notScored": "Nicht bewertet",
     "threshold": "Schwellenwert {threshold}",
+    "thresholdHint": "Der Wert, den dieser Schritt erreichen musste, aus der Merge-Policy der Aufgabe. Darunter schickt der Judge die Arbeit mit seinen Befunden als Nacharbeit an den erzeugenden Schritt zurück oder parkt den Lauf für Sie, wenn kein Versuchsbudget mehr übrig ist.",
     "rubricOverridden": "Raster des Arbeitsbereichs",
     "reworkRounds": "Überarbeitung {spent}/{budget}",
     "findingsHeading": "Was das Bewertungsraster beanstandet hat",
@@ -5815,10 +5837,12 @@
       "config": "Konfiguration & CI",
       "source": "Quellcode",
       "schema": "Schema & Migrationen",
-      "unknown": "Nicht klassifiziert"
+      "unknown": "Nicht klassifiziert",
+      "hint": "Was der Diff berührt hat, ermittelt aus den geänderten Dateien. Die Merge-Policy kann pro Klasse eine eigene Regel setzen; ein Diff über mehrere Klassen zählt als die schwerste davon."
     },
     "effort": {
       "prompt": "Review-Aufwand",
+      "promptHint": "Hält fest, wie viel Review dieser Pull Request wirklich gebraucht hat. Ihre Antwort ist die Referenz, an der die Auto-Merge-Schwellen kalibriert werden. Das Taggen ist freiwillig, Sie können auch ohne mergen.",
       "none": "Keine Anmerkungen",
       "minor": "Kleine Anmerkungen",
       "major": "Echte Nacharbeit",

package/i18n/locales/en.json

@@ -409,6 +409,14 @@
         "pr_ready": "Active",
         "done": "Live"
       },
+      "statusHint": {
+        "planned": "No tasks on this service yet. A service is never finished, so this is where one starts rather than a stalled state.",
+        "ready": "Every task under this service is idle or merged. Nothing is running and nothing is waiting on you.",
+        "in_progress": "At least one task under this service is running or has an open pull request.",
+        "blocked": "At least one task or initiative under this service is waiting on a decision from you.",
+        "pr_ready": "At least one task under this service is running or has an open pull request.",
+        "done": "Every task under this service is idle or merged. Nothing is running and nothing is waiting on you."
+      },
       "shared": "Shared",
       "sharedTitle": "Shared across workspaces in this org",
       "bootstrapping": "Bootstrapping…",
@@ -1318,6 +1326,7 @@
       },
       "subtasks": "Subtasks · {completed}/{total}",
       "standardsApplied": "Standards applied",
+      "standardsAppliedHint": "The best-practice standards folded into this step's system prompt. An implementing agent receives a condensed version of each; reviewers and planners get the full text.",
       "decision": "Decision",
       "awaitingChoice": "Awaiting a human choice",
       "approvalGate": "Approval gate",
@@ -1385,13 +1394,16 @@
       "effort": {
         "heading": "Agent effort",
         "difficulty": "Difficulty",
+        "difficultyHint": "The agent's own assessment of how hard this step was, out of ten. Self-reported, not measured.",
         "outOfTen": "{value}/10",
         "reduced": "What reduced effectiveness",
         "obstacles": "Key obstacles"
       },
       "adherence": {
         "heading": "Best-practice adherence",
+        "headingHint": "The best-practice standards folded into this reviewer's prompt, and how closely it judged the change to follow each one.",
         "outOfTen": "{value}/10",
+        "ratingHint": "The reviewer's own rating of how closely the change follows this standard, out of ten. Self-reported, not measured.",
         "relatedFindings": "Related findings",
         "unnamed": "Standard"
       },
@@ -1666,7 +1678,9 @@
     },
     "legend": {
       "metered": "Metered",
-      "subscription": "Subscription"
+      "meteredHint": "Billed per token by the provider. This is real money.",
+      "subscription": "Subscription",
+      "subscriptionHint": "Illustrative only. These calls ran on a flat-rate plan, so this is what the same tokens would have cost through a metered API. It was never billed and never counts as spend."
     },
     "spend": {
       "byModel": "Spend by model",
@@ -4036,9 +4050,14 @@
       "companionGateTooltip": "Only run this companion when the task estimate clears a threshold (needs a Task Estimator earlier)",
       "consensusGateTooltip": "Only run consensus when the task estimate clears a threshold (else the standard agent runs)",
       "runWhenAny": "run when (any):",
+      "gatingRunWhenAnyHint": "The step runs when any one of these axes is met or exceeded, and is skipped otherwise. If no estimate is available it runs anyway.",
+      "gatingRunWhenAnyConsensusHint": "The panel convenes when any one of these axes is met or exceeded; below that the single agent runs instead. If no estimate is available the panel convenes anyway.",
       "complexityThreshold": "complexity ≥",
+      "complexityThresholdHint": "How hard the work is to carry out, scored by the Task Estimator step earlier in the pipeline. The scale is 0 to 1, not 1 to 10. Leave it empty to ignore this axis.",
       "riskThreshold": "risk ≥",
+      "riskThresholdHint": "How much the change could break, scored by the Task Estimator step earlier in the pipeline. The scale is 0 to 1, not 1 to 10. Leave it empty to ignore this axis.",
       "impactThreshold": "impact ≥",
+      "impactThresholdHint": "How far the change reaches across the system, scored by the Task Estimator step earlier in the pipeline. The scale is 0 to 1, not 1 to 10. Leave it empty to ignore this axis.",
       "strategy": "Strategy",
       "rounds": "Rounds",
       "purposeLabel": "Purpose",
@@ -4193,6 +4212,7 @@
       "stepLabel": "Output budget",
       "kindLabel": "Output budget",
       "kindHint": "Applies to every run of this agent. A pipeline step can override it.",
+      "hint": "The most a single reply from this agent may run to. Leave it empty to inherit the next level up rather than to lift the limit. A pipeline step's own value wins over the workspace default.",
       "inherits": "Inherited",
       "inheritsValue": "Inherited ({tokens})"
     }
@@ -4394,6 +4414,7 @@
     "empty": "This step has not produced a verdict yet.",
     "notScored": "Not scored",
     "threshold": "threshold {threshold}",
+    "thresholdHint": "The score this step had to reach, taken from the task's merge policy. Below it the judge sends the work back to the step that produced it, with its findings as rework, or parks the run for you when no attempt budget is left.",
     "rubricOverridden": "workspace rubric",
     "reworkRounds": "rework {spent}/{budget}",
     "findingsHeading": "What the rubric flagged",
@@ -5645,11 +5666,12 @@
     },
     "planReview": {
       "title": "This plan is waiting for you",
-      "body": "The planner drafted the phases and items below. Approve them to commit the plan and start the work, or send the plan back with what to change.",
+      "body": "The planner drafted these phases and items. Approve them to commit the plan and start the work, or send the plan back with what to change.",
       "approve": "Approve plan",
       "feedbackPlaceholder": "What should the planner change? Scope, phase order, missing work, an item that belongs elsewhere…",
       "sendBack": "Send back to the planner",
-      "noDocument": "This plan was drafted before the platform rendered plans for review, so there is no document to navigate — the sections below are the plan.",
+      "noDocument": "This planning step left no plan document to review, so there is nothing to navigate here.",
+      "noDocumentSections": "The sections below are the plan.",
       "needsFeedback": "Add a comment or some feedback first — the planner re-plans from it.",
       "commentHint": "Click any part of the plan to comment on it."
     },
@@ -6001,10 +6023,12 @@
         "description": "'Source' here means program source code (as opposed to docs/config/tests), NOT the origin of something."
       },
       "schema": "Schema & migrations",
-      "unknown": "Unclassified"
+      "unknown": "Unclassified",
+      "hint": "What the diff touched, worked out from the changed files. Merge policy can set its own rule per class, and a diff spanning several classes takes the heaviest one."
     },
     "effort": {
       "prompt": "Review effort",
+      "promptHint": "Records how much review this pull request really needed. Your answer is the ground truth the auto-merge thresholds are calibrated against. Tagging is optional and you can merge without it.",
       "none": "No comments",
       "@none": {
         "description": "Answer to 'how much review effort did this PR need?': means the reviewer had NOTHING to say, not that no review happened."

package/i18n/locales/es.json

@@ -376,6 +376,14 @@
         "pr_ready": "Activo",
         "done": "Activo"
       },
+      "statusHint": {
+        "planned": "Aun no hay tareas en este servicio. Un servicio nunca se termina, asi que este es su punto de partida y no un estado atascado.",
+        "ready": "Todas las tareas de este servicio estan inactivas o fusionadas. No hay nada en ejecucion ni nada esperandote.",
+        "in_progress": "Al menos una tarea de este servicio esta en ejecucion o tiene un pull request abierto.",
+        "blocked": "Al menos una tarea o iniciativa de este servicio esta esperando una decision tuya.",
+        "pr_ready": "Al menos una tarea de este servicio esta en ejecucion o tiene un pull request abierto.",
+        "done": "Todas las tareas de este servicio estan inactivas o fusionadas. No hay nada en ejecucion ni nada esperandote."
+      },
       "shared": "Compartido",
       "sharedTitle": "Compartido entre espacios de trabajo de esta organización",
       "bootstrapping": "Arrancando…",
@@ -1235,6 +1243,7 @@
       "spinningUpContainer": "Iniciando contenedor…",
       "subtasks": "Subtareas · {completed}/{total}",
       "standardsApplied": "Estándares aplicados",
+      "standardsAppliedHint": "Los estandares de buenas practicas incorporados al prompt de sistema de este paso. Un agente que implementa recibe una version condensada de cada uno; los revisores y planificadores reciben el texto completo.",
       "decision": "Decisión",
       "awaitingChoice": "Esperando una elección humana",
       "approvalGate": "Verificación de aprobación",
@@ -1321,13 +1330,16 @@
       "effort": {
         "heading": "Esfuerzo del agente",
         "difficulty": "Dificultad",
+        "difficultyHint": "La valoracion del propio agente sobre lo dificil que fue este paso, sobre diez. Autodeclarada, no medida.",
         "outOfTen": "{value}/10",
         "reduced": "Qué redujo la efectividad",
         "obstacles": "Obstáculos clave"
       },
       "adherence": {
         "heading": "Cumplimiento de buenas prácticas",
+        "headingHint": "Los estandares de buenas practicas incorporados al prompt de este revisor, y con cuanta fidelidad juzgo que el cambio sigue cada uno.",
         "outOfTen": "{value}/10",
+        "ratingHint": "La valoracion del propio revisor sobre con cuanta fidelidad el cambio sigue este estandar, sobre diez. Autodeclarada, no medida.",
         "relatedFindings": "Hallazgos relacionados",
         "unnamed": "Estándar"
       },
@@ -1599,7 +1611,9 @@
     },
     "legend": {
       "metered": "Medido",
-      "subscription": "Suscripción"
+      "meteredHint": "Facturado por token por el proveedor. Esto es dinero real.",
+      "subscription": "Suscripción",
+      "subscriptionHint": "Solo ilustrativo. Estas llamadas se ejecutaron con un plan de tarifa plana, asi que esta cifra es lo que habrian costado los mismos tokens a traves de una API con medicion. Nunca se facturo ni cuenta como gasto."
     },
     "spend": {
       "byModel": "Gasto por modelo",
@@ -3921,9 +3935,14 @@
       "companionGateTooltip": "Ejecutar este compañero solo cuando la estimación de la tarea supere un umbral (requiere un Task Estimator antes)",
       "consensusGateTooltip": "Ejecutar el consenso solo cuando la estimación de la tarea supere un umbral (de lo contrario se ejecuta el agente estándar)",
       "runWhenAny": "ejecutar cuando (cualquiera):",
+      "gatingRunWhenAnyHint": "El paso se ejecuta cuando se alcanza o supera cualquiera de estos ejes, y se omite en caso contrario. Si no hay estimacion, se ejecuta igualmente.",
+      "gatingRunWhenAnyConsensusHint": "El panel se reune cuando se alcanza o supera cualquiera de estos ejes; por debajo se ejecuta el agente unico. Si no hay estimacion, el panel se reune igualmente.",
       "complexityThreshold": "complejidad ≥",
+      "complexityThresholdHint": "Lo dificil que es llevar a cabo el trabajo, puntuado por el Task Estimator anterior en el pipeline. La escala va de 0 a 1, no de 1 a 10. Dejalo vacio para ignorar este eje.",
       "riskThreshold": "riesgo ≥",
+      "riskThresholdHint": "Cuanto podria romper el cambio, puntuado por el Task Estimator anterior en el pipeline. La escala va de 0 a 1, no de 1 a 10. Dejalo vacio para ignorar este eje.",
       "impactThreshold": "impacto ≥",
+      "impactThresholdHint": "Hasta donde llega el cambio en el sistema, puntuado por el Task Estimator anterior en el pipeline. La escala va de 0 a 1, no de 1 a 10. Dejalo vacio para ignorar este eje.",
       "strategy": "Estrategia",
       "rounds": "Rondas",
       "purposeLabel": "Propósito",
@@ -4078,6 +4097,7 @@
       "stepLabel": "Presupuesto de salida",
       "kindLabel": "Presupuesto de salida",
       "kindHint": "Se aplica a todas las ejecuciones de este agente. Un paso del pipeline puede anularlo.",
+      "hint": "El maximo al que puede llegar una sola respuesta de este agente. Dejarlo vacio hereda del nivel superior; no elimina el limite. El valor propio de un paso del pipeline prevalece sobre el predeterminado del espacio de trabajo.",
       "inherits": "Heredado",
       "inheritsValue": "Heredado ({tokens})"
     }
@@ -4207,6 +4227,7 @@
     "empty": "Este paso todavía no ha producido un veredicto.",
     "notScored": "Sin puntuar",
     "threshold": "umbral {threshold}",
+    "thresholdHint": "La puntuacion que este paso tenia que alcanzar, tomada de la politica de fusion de la tarea. Por debajo, el juez devuelve el trabajo al paso que lo produjo con sus hallazgos como retrabajo, o aparca la ejecucion para ti cuando ya no queda presupuesto de intentos.",
     "rubricOverridden": "rúbrica del espacio de trabajo",
     "reworkRounds": "revisión {spent}/{budget}",
     "findingsHeading": "Lo que señaló la rúbrica",
@@ -5453,11 +5474,12 @@
     },
     "planReview": {
       "title": "Este plan te está esperando",
-      "body": "El planificador redactó las fases y los elementos de abajo. Apruébalos para confirmar el plan y empezar el trabajo, o devuelve el plan indicando qué cambiar.",
+      "body": "El planificador redactó estas fases y estos elementos. Apruébalos para confirmar el plan y empezar el trabajo, o devuelve el plan indicando qué cambiar.",
       "approve": "Aprobar plan",
       "feedbackPlaceholder": "¿Qué debería cambiar el planificador? Alcance, orden de las fases, trabajo que falta, un elemento que va en otro sitio…",
       "sendBack": "Devolver al planificador",
-      "noDocument": "Este plan se redactó antes de que la plataforma generara planes para revisión, así que no hay documento que recorrer: las secciones de abajo son el plan.",
+      "noDocument": "Este paso de planificación no dejó ningún documento del plan para revisar, así que aquí no hay nada que recorrer.",
+      "noDocumentSections": "Las secciones de abajo son el plan.",
       "needsFeedback": "Añade primero un comentario o algún comentario general: el planificador replanifica a partir de ello.",
       "commentHint": "Haz clic en cualquier parte del plan para comentarla."
     },
@@ -5803,10 +5825,12 @@
       "config": "Configuración y CI",
       "source": "Código fuente",
       "schema": "Esquema y migraciones",
-      "unknown": "Sin clasificar"
+      "unknown": "Sin clasificar",
+      "hint": "Lo que toco el diff, deducido de los archivos modificados. La politica de fusion puede fijar su propia regla por clase, y un diff que abarca varias clases toma la mas pesada."
     },
     "effort": {
       "prompt": "Esfuerzo de revisión",
+      "promptHint": "Registra cuanta revision necesito realmente este pull request. Tu respuesta es la referencia con la que se calibran los umbrales de fusion automatica. Etiquetar es opcional y puedes fusionar sin hacerlo.",
       "none": "Sin comentarios",
       "minor": "Comentarios menores",
       "major": "Retrabajo real",

package/i18n/locales/fr.json

@@ -376,6 +376,14 @@
         "pr_ready": "Actif",
         "done": "En ligne"
       },
+      "statusHint": {
+        "planned": "Aucune tache sur ce service pour l'instant. Un service ne se termine jamais : c'est donc son point de depart, pas un blocage.",
+        "ready": "Toutes les taches de ce service sont inactives ou fusionnees. Rien ne s'execute et rien n'attend apres vous.",
+        "in_progress": "Au moins une tache de ce service s'execute ou a une pull request ouverte.",
+        "blocked": "Au moins une tache ou initiative de ce service attend une decision de votre part.",
+        "pr_ready": "Au moins une tache de ce service s'execute ou a une pull request ouverte.",
+        "done": "Toutes les taches de ce service sont inactives ou fusionnees. Rien ne s'execute et rien n'attend apres vous."
+      },
       "shared": "Partagé",
       "sharedTitle": "Partagé entre les espaces de travail de cette organisation",
       "bootstrapping": "Initialisation…",
@@ -1235,6 +1243,7 @@
       "spinningUpContainer": "Démarrage du conteneur…",
       "subtasks": "Sous-tâches · {completed}/{total}",
       "standardsApplied": "Standards appliqués",
+      "standardsAppliedHint": "Les standards de bonnes pratiques integres au prompt systeme de cette etape. Un agent qui implemente en recoit une version condensee ; les relecteurs et les planificateurs recoivent le texte complet.",
       "decision": "Décision",
       "awaitingChoice": "En attente d'un choix humain",
       "approvalGate": "Gate d'approbation",
@@ -1321,13 +1330,16 @@
       "effort": {
         "heading": "Effort de l'agent",
         "difficulty": "Difficulté",
+        "difficultyHint": "L'evaluation par l'agent lui-meme de la difficulte de cette etape, sur dix. Declaree par l'agent, non mesuree.",
         "outOfTen": "{value}/10",
         "reduced": "Ce qui a réduit l'efficacité",
         "obstacles": "Principaux obstacles"
       },
       "adherence": {
         "heading": "Respect des bonnes pratiques",
+        "headingHint": "Les standards de bonnes pratiques integres au prompt de ce relecteur, et le degre de respect de chacun qu'il a estime pour la modification.",
         "outOfTen": "{value}/10",
+        "ratingHint": "L'evaluation par le relecteur lui-meme du respect de ce standard par la modification, sur dix. Declaree par le relecteur, non mesuree.",
         "relatedFindings": "Constats associés",
         "unnamed": "Standard"
       },
@@ -1599,7 +1611,9 @@
     },
     "legend": {
       "metered": "Facturé",
-      "subscription": "Abonnement"
+      "meteredHint": "Facture au token par le fournisseur. Il s'agit d'argent reel.",
+      "subscription": "Abonnement",
+      "subscriptionHint": "A titre indicatif uniquement. Ces appels ont ete passes sur un forfait : ce montant correspond a ce que les memes tokens auraient coute via une API facturee. Il n'a jamais ete facture et ne compte jamais comme depense."
     },
     "spend": {
       "byModel": "Dépense par modèle",
@@ -3921,9 +3935,14 @@
       "companionGateTooltip": "N'exécuter ce compagnon que lorsque l'estimation de la tâche dépasse un seuil (nécessite un Task Estimator en amont)",
       "consensusGateTooltip": "N'exécuter le consensus que lorsque l'estimation de la tâche dépasse un seuil (sinon l'agent standard s'exécute)",
       "runWhenAny": "exécuter quand (l'un de) :",
+      "gatingRunWhenAnyHint": "L'etape s'execute des qu'un de ces axes est atteint ou depasse, et est ignoree sinon. En l'absence d'estimation, elle s'execute quand meme.",
+      "gatingRunWhenAnyConsensusHint": "Le panel se reunit des qu'un de ces axes est atteint ou depasse ; en dessous, c'est l'agent unique qui s'execute. En l'absence d'estimation, le panel se reunit quand meme.",
       "complexityThreshold": "complexité ≥",
+      "complexityThresholdHint": "La difficulte de realisation du travail, notee par le Task Estimator situe plus haut dans le pipeline. L'echelle va de 0 a 1, pas de 1 a 10. Laissez vide pour ignorer cet axe.",
       "riskThreshold": "risque ≥",
+      "riskThresholdHint": "Ce que la modification risque de casser, note par le Task Estimator situe plus haut dans le pipeline. L'echelle va de 0 a 1, pas de 1 a 10. Laissez vide pour ignorer cet axe.",
       "impactThreshold": "impact ≥",
+      "impactThresholdHint": "L'etendue de la modification dans le systeme, notee par le Task Estimator situe plus haut dans le pipeline. L'echelle va de 0 a 1, pas de 1 a 10. Laissez vide pour ignorer cet axe.",
       "strategy": "Stratégie",
       "rounds": "Tours",
       "purposeLabel": "Objectif",
@@ -4078,6 +4097,7 @@
       "stepLabel": "Budget de sortie",
       "kindLabel": "Budget de sortie",
       "kindHint": "S'applique à chaque exécution de cet agent. Une étape du pipeline peut le remplacer.",
+      "hint": "La longueur maximale d'une seule reponse de cet agent. Laisser vide herite du niveau superieur, cela ne leve pas la limite. La valeur propre a une etape du pipeline l'emporte sur la valeur par defaut de l'espace de travail.",
       "inherits": "Hérité",
       "inheritsValue": "Hérité ({tokens})"
     }
@@ -4207,6 +4227,7 @@
     "empty": "Cette étape n'a pas encore produit de verdict.",
     "notScored": "Non noté",
     "threshold": "seuil {threshold}",
+    "thresholdHint": "Le score que cette etape devait atteindre, issu de la politique de fusion de la tache. En dessous, le juge renvoie le travail a l'etape qui l'a produit avec ses constats a reprendre, ou met l'execution en attente pour vous quand il ne reste plus de budget de tentatives.",
     "rubricOverridden": "grille de l'espace de travail",
     "reworkRounds": "reprise {spent}/{budget}",
     "findingsHeading": "Ce que la grille a signalé",
@@ -5453,11 +5474,12 @@
     },
     "planReview": {
       "title": "Ce plan vous attend",
-      "body": "Le planificateur a rédigé les phases et les éléments ci-dessous. Approuvez-les pour valider le plan et lancer le travail, ou renvoyez le plan en indiquant ce qu'il faut changer.",
+      "body": "Le planificateur a rédigé ces phases et ces éléments. Approuvez-les pour valider le plan et lancer le travail, ou renvoyez le plan en indiquant ce qu'il faut changer.",
       "approve": "Approuver le plan",
       "feedbackPlaceholder": "Que doit changer le planificateur ? Périmètre, ordre des phases, travail manquant, un élément qui a sa place ailleurs…",
       "sendBack": "Renvoyer au planificateur",
-      "noDocument": "Ce plan a été rédigé avant que la plateforme ne produise des plans à relire ; il n'y a donc pas de document à parcourir — les sections ci-dessous sont le plan.",
+      "noDocument": "Cette étape de planification n'a laissé aucun document de plan à relire, il n'y a donc rien à parcourir ici.",
+      "noDocumentSections": "Les sections ci-dessous sont le plan.",
       "needsFeedback": "Ajoutez d'abord un commentaire ou un retour : le planificateur s'en sert pour replanifier.",
       "commentHint": "Cliquez sur une partie du plan pour la commenter."
     },
@@ -5803,10 +5825,12 @@
       "config": "Configuration et CI",
       "source": "Code source",
       "schema": "Schéma et migrations",
-      "unknown": "Non classé"
+      "unknown": "Non classé",
+      "hint": "Ce que le diff a touche, deduit des fichiers modifies. La politique de fusion peut definir sa propre regle par classe, et un diff couvrant plusieurs classes prend la plus lourde."
     },
     "effort": {
       "prompt": "Effort de revue",
+      "promptHint": "Enregistre la quantite de relecture dont cette pull request a reellement eu besoin. Votre reponse sert de reference pour calibrer les seuils de fusion automatique. Le marquage est facultatif et vous pouvez fusionner sans.",
       "none": "Aucun commentaire",
       "minor": "Remarques mineures",
       "major": "Reprise importante",