@cat-factory/app 0.195.0 → 0.195.2

package/app/components/initiative/InitiativeTrackerWindow.vue

@@ -23,10 +23,12 @@ import {
   INITIATIVE_STATUS_LABEL_KEYS,
   initiativeProgress,
   pendingCheckpointPhase,
+  planReviewDocument,
 } from '~/utils/initiative'
 import ResultWindowShell from '~/components/panels/ResultWindowShell.vue'
 import StepRunMeta from '~/components/panels/StepRunMeta.vue'
 import InitiativePlanReview from '~/components/initiative/InitiativePlanReview.vue'
+import InitiativePlanNotice from '~/components/initiative/InitiativePlanNotice.vue'
 
 const board = useBoardStore()
 const initiatives = useInitiativesStore()
@@ -61,6 +63,24 @@ const {
   stepIndex: () => stepIndex.value,
 })
 
+/**
+ * The `StepRunMeta` prop bundle, or null when no step speaks for this window. Bound as one object
+ * because it has two homes — the tracker's end-side column, and the plan review's sidebar while the
+ * review owns the window — and the run details must read identically in both.
+ */
+const runMeta = computed(() =>
+  metaStep.value
+    ? {
+        step: metaStep.value,
+        instanceId: runId.value,
+        stepNumber: position.value,
+        totalSteps: totalSteps.value,
+        runFailed: runFailed.value,
+        failureAt: failureAt.value,
+      }
+    : null,
+)
+
 const phases = computed(() => initiative.value?.phases ?? [])
 function itemsOf(phaseId: string): InitiativeItem[] {
   return (initiative.value?.items ?? []).filter((i) => i.phaseId === phaseId)
@@ -103,9 +123,19 @@ async function checkpointControl(action: 'resume' | 'cancel') {
 // ---- Plan review: the planner step's human gate, resolved right here -----------------------
 // Derived from the BLOCK (via the shared planning composable), not from this window's own
 // `stepIndex`: the card / inspector open the tracker with no step, and that is the entry point a
-// human parked on the gate actually uses. So the rail appears on every route into the window.
+// human parked on the gate actually uses. So the review appears on every route into the window.
 const { planApproval } = useInitiativePlanning(() => blockId.value ?? '')
 
+/**
+ * The plan document the parked gate offers, or `''` — which is also the layout decision. A rendered
+ * plan is a REPLACEMENT for the tracker body rather than a card above it: the render reads the
+ * ingested entity, so the sections below would be a second copy of what the reviewer is reading,
+ * and everything the tracker adds on top (PR links, item curation, checkpoints, follow-ups) is
+ * execution-time state that cannot exist until the plan is committed. With no document, the tracker
+ * body IS the plan, so the gate takes the compact notice above it instead.
+ */
+const planDocument = computed(() => planReviewDocument(planApproval.value))
+
 const policyRules = computed(() => initiative.value?.policy?.rules ?? [])
 function ruleAxes(rule: { minComplexity?: number; minRisk?: number; minImpact?: number }): string {
   const axes = [
@@ -236,30 +266,54 @@ async function savePolicy() {
       </UBadge>
     </template>
 
-    <div class="flex min-h-0 flex-1">
+    <!-- The planner's human gate, with the plan rendered as a document. This window is where the
+         park ROUTES (the planner's archetype declares this result view), so it is the only surface
+         that can resolve it — and while it is parked the review OWNS the window: an outline sidebar,
+         the plan at full height, per-block commenting and the commands in an end-side rail, the same
+         tools and the same shape the step reader gives the architect's prose. The tracker body it
+         replaces would only repeat the plan (see `planDocument`). -->
+    <InitiativePlanReview
+      v-if="planApproval && planDocument"
+      :approval="planApproval.approval"
+      :instance-id="planApproval.instanceId"
+      :can-execute="access.canExecuteRuns.value"
+      :plan-document="planDocument"
+    >
+      <template v-if="runMeta" #run-details>
+        <StepRunMeta v-bind="runMeta" />
+      </template>
+    </InitiativePlanReview>
+
+    <div v-else class="flex min-h-0 flex-1">
       <div class="min-w-0 flex-1 overflow-y-auto px-5 py-4">
-        <!-- No entity yet (module unwired / still creating) -->
+        <!-- A parked gate whose step rendered no plan: the commands, plus a notice pointing at the
+             sections below — which in that case are the only rendering of the plan there is.
+             Deliberately OUTSIDE the entity branch: the gate lives on the RUN, so it is parked
+             before `initiatives.load()` has resolved (and stays parked if it fails), and a window
+             that answered such a gate with the empty state alone would leave it unresolvable from
+             the UI. `hasSections` is what keeps the notice honest about whether the sections it
+             points at are actually rendered underneath. -->
+        <InitiativePlanNotice
+          v-if="planApproval"
+          :approval="planApproval.approval"
+          :instance-id="planApproval.instanceId"
+          :can-execute="access.canExecuteRuns.value"
+          :has-sections="!!initiative"
+        />
+
+        <!-- No entity yet (module unwired / still creating). Centred in the column when it is the
+             only thing in it; merely inset when the notice above it means `h-full` would overflow
+             the scroller by the notice's own height. -->
         <div
           v-if="!initiative"
-          class="flex h-full flex-col items-center justify-center gap-2 text-center text-slate-400"
+          class="flex flex-col items-center justify-center gap-2 text-center text-slate-400"
+          :class="planApproval ? 'py-16' : 'h-full'"
         >
           <UIcon name="i-lucide-milestone" class="h-8 w-8 opacity-40" />
           <p class="text-sm">{{ t('initiative.tracker.empty') }}</p>
         </div>
 
         <template v-else>
-          <!-- The planner's human gate. This window is where the park ROUTES (the planner's
-               archetype declares this result view), so it is the only surface that can resolve
-               it — and the plan it judges is rendered as a navigable document with per-block
-               commenting, the same tools the step reader gives the architect's prose. -->
-          <InitiativePlanReview
-            v-if="planApproval"
-            :approval="planApproval.approval"
-            :instance-id="planApproval.instanceId"
-            :can-execute="access.canExecuteRuns.value"
-            :output-is-rendered="planApproval.outputIsRendered"
-          />
-
           <!-- Paused at a phase checkpoint (D2): a completed checkpoint phase is awaiting
                    review before the next phase spawns. Read the phase's artifacts/PRs below,
                    then resume (continue) or cancel (stop) the initiative right here. -->
@@ -646,18 +700,11 @@ async function savePolicy() {
            through `useResultViewRunMeta`, so it is present on the card / inspector entry point
            too — where this window carries no step index of its own. -->
       <aside
-        v-if="metaStep"
+        v-if="runMeta"
         data-testid="initiative-tracker-run-meta"
         class="hidden w-60 shrink-0 flex-col gap-4 overflow-y-auto border-s border-slate-800 bg-slate-900/50 px-4 py-4 lg:flex"
       >
-        <StepRunMeta
-          :step="metaStep"
-          :instance-id="runId"
-          :step-number="position"
-          :total-steps="totalSteps"
-          :run-failed="runFailed"
-          :failure-at="failureAt"
-        />
+        <StepRunMeta v-bind="runMeta" />
       </aside>
     </div>
   </ResultWindowShell>

package/app/components/judge/JudgeResultView.vue

@@ -151,7 +151,11 @@ async function act(choice: 'proceed' | 'bounce' | 'stop') {
           <span class="text-[13px] font-semibold text-slate-100">
             {{ score === null ? t('judge.notScored') : n(score, 'percent') }}
           </span>
-          <span v-if="threshold !== null" class="text-[12px] text-slate-400">
+          <span
+            v-if="threshold !== null"
+            class="text-[12px] text-slate-400"
+            :title="t('judge.thresholdHint')"
+          >
             {{ t('judge.threshold', { threshold: n(threshold, 'percent') }) }}
           </span>
           <span v-if="judge.disposition" class="text-[12px] text-slate-400">

package/app/components/merge/MergeEffortChips.vue

@@ -87,7 +87,10 @@ function pick(effort: ReviewEffort) {
 <template>
   <div data-testid="merge-effort-chips" class="mt-2">
     <div class="flex items-center gap-1.5">
-      <span class="text-[10px] uppercase tracking-wide text-slate-500">
+      <span
+        class="text-[10px] uppercase tracking-wide text-slate-500"
+        :title="t('merge.effort.promptHint')"
+      >
         {{ t('merge.effort.prompt') }}
       </span>
       <UBadge
@@ -96,6 +99,7 @@ function pick(effort: ReviewEffort) {
         color="neutral"
         variant="subtle"
         size="sm"
+        :title="t('merge.changeClass.hint')"
       >
         {{ classLabel }}
       </UBadge>

package/app/components/panels/ReportsPanel.vue

@@ -309,12 +309,15 @@ watch(
                   </div>
                 </div>
                 <div class="mt-2 flex items-center gap-4 text-[11px] text-slate-500">
-                  <span class="flex items-center gap-1">
+                  <span class="flex items-center gap-1" :title="t('reports.legend.meteredHint')">
                     <span class="h-2 w-2 rounded-sm bg-violet-500" />{{
                       t('reports.legend.metered')
                     }}
                   </span>
-                  <span class="flex items-center gap-1">
+                  <span
+                    class="flex items-center gap-1"
+                    :title="t('reports.legend.subscriptionHint')"
+                  >
                     <span class="h-2 w-2 rounded-sm bg-amber-600" />{{
                       t('reports.legend.subscription')
                     }}

package/app/components/panels/ReportsSpendBreakdown.vue

@@ -40,7 +40,11 @@ const max = computed(() => maxOf(props.rows, spendMagnitude))
                figure would report money that was never billed. -->
           <span class="shrink-0 tabular-nums text-slate-400">
             {{ money(row.meteredCost) }}
-            <span v-if="row.subscriptionCost > 0" class="text-amber-400">
+            <span
+              v-if="row.subscriptionCost > 0"
+              class="text-amber-400"
+              :title="t('reports.legend.subscriptionHint')"
+            >
               {{ t('reports.spend.subscriptionAside', { value: money(row.subscriptionCost) }) }}
             </span>
           </span>

package/app/components/panels/StepEffortReport.vue

@@ -42,7 +42,12 @@ const difficultyClass = computed(() => BAR_CLASS[effortBand(props.report.difficu
     </div>
 
     <div class="flex items-center gap-2">
-      <span class="text-[12px] text-slate-300">{{ t('panels.stepDetail.effort.difficulty') }}</span>
+      <span
+        class="text-[12px] text-slate-300"
+        :title="t('panels.stepDetail.effort.difficultyHint')"
+      >
+        {{ t('panels.stepDetail.effort.difficulty') }}
+      </span>
       <div class="h-1.5 flex-1 overflow-hidden rounded-full bg-slate-700/60">
         <div
           class="h-full rounded-full"
@@ -50,7 +55,11 @@ const difficultyClass = computed(() => BAR_CLASS[effortBand(props.report.difficu
           :style="{ width: `${difficultyPct}%` }"
         />
       </div>
-      <span data-testid="step-effort-difficulty" class="text-[12px] font-medium text-slate-200">
+      <span
+        data-testid="step-effort-difficulty"
+        class="text-[12px] font-medium text-slate-200"
+        :title="t('panels.stepDetail.effort.difficultyHint')"
+      >
         {{ t('panels.stepDetail.effort.outOfTen', { value: report.difficulty }) }}
       </span>
     </div>

package/app/components/panels/StepFragmentAdherence.vue

@@ -33,7 +33,9 @@ function label(item: FragmentAdherence[number]): string {
       class="mb-2 flex items-center gap-1.5 text-[11px] font-semibold uppercase tracking-wide text-slate-400"
     >
       <UIcon name="i-lucide-clipboard-check" class="h-3.5 w-3.5" />
-      <span>{{ t('panels.stepDetail.adherence.heading') }}</span>
+      <span :title="t('panels.stepDetail.adherence.headingHint')">
+        {{ t('panels.stepDetail.adherence.heading') }}
+      </span>
     </div>
 
     <div class="space-y-2.5">
@@ -54,7 +56,10 @@ function label(item: FragmentAdherence[number]): string {
               :style="{ width: `${ratingPct(item.rating)}%` }"
             />
           </div>
-          <span class="shrink-0 text-[12px] font-medium text-slate-200">
+          <span
+            class="shrink-0 text-[12px] font-medium text-slate-200"
+            :title="t('panels.stepDetail.adherence.ratingHint')"
+          >
             {{ t('panels.stepDetail.adherence.outOfTen', { value: item.rating }) }}
           </span>
         </div>

package/app/components/panels/StepMetadataCard.vue

@@ -207,7 +207,10 @@ async function copyRunId() {
 
     <!-- standards (prompt fragments) folded into this step -->
     <div v-if="step.selectedFragmentIds && step.selectedFragmentIds.length" class="mt-4">
-      <div class="text-[11px] uppercase tracking-wide text-slate-500">
+      <div
+        class="text-[11px] uppercase tracking-wide text-slate-500"
+        :title="t('panels.stepMeta.standardsAppliedHint')"
+      >
         {{ t('panels.stepMeta.standardsApplied') }}
       </div>
       <div class="mt-1 flex flex-wrap gap-1">

package/app/components/pipeline/EstimateThresholdFields.vue

@@ -0,0 +1,74 @@
+<script setup lang="ts">
+// The estimate-gate threshold row, shared by every gate editor in the pipeline builder: a
+// companion step's own gate, a consensus step's escalation gate, and the Tester QC companion's
+// gate. One component because the three rendered the same 0..1 inputs from three copies of the
+// markup — and, more to the point, because the explanation these numbers need has to be worded
+// once. A bare "risk >=" label says nothing about where the score comes from, what its scale is,
+// or how the axes combine, and the scale is the trap: every other score the product shows a user
+// (judge verdicts, effort difficulty, adherence ratings) is out of ten, so an unlabelled 0..1
+// field reads as "risk 1 out of 10" and gates a step that was meant to run on everything.
+//
+// The gate itself is edited by the parent (the builder mutates store drafts in place), so this
+// component only renders and reports: it never writes through the `gating` prop.
+import type { EstimateAxis } from '~/utils/estimateGating'
+import {
+  ESTIMATE_AXIS_FIELD,
+  ESTIMATE_AXIS_HINT_KEYS,
+  ESTIMATE_AXIS_LABEL_KEYS,
+  parseAxisThreshold,
+} from '~/utils/estimateGating'
+
+const props = defineProps<{
+  /** The gate being edited. Read-only here — changes go back through `update`. */
+  gating: { minComplexity?: number; minRisk?: number; minImpact?: number }
+  /** Which axes this gate exposes, in render order. */
+  axes: readonly EstimateAxis[]
+  /** What clearing the gate DOES, which differs per gate and is half the explanation. */
+  outcome: 'step' | 'consensus'
+}>()
+
+const emit = defineEmits<{ update: [axis: EstimateAxis, value: number | undefined] }>()
+
+const { t } = useI18n()
+
+// Exhaustive Record over the two outcomes with LITERAL keys, so the typed-message-key check sees
+// them and a third outcome fails the typecheck rather than falling back to the step wording.
+const OUTCOME_HINT_KEYS: Record<'step' | 'consensus', string> = {
+  step: 'pipeline.builder.gatingRunWhenAnyHint',
+  consensus: 'pipeline.builder.gatingRunWhenAnyConsensusHint',
+}
+
+const fields = computed(() =>
+  props.axes.map((axis) => ({
+    axis,
+    label: t(ESTIMATE_AXIS_LABEL_KEYS[axis]),
+    hint: t(ESTIMATE_AXIS_HINT_KEYS[axis]),
+    value: props.gating[ESTIMATE_AXIS_FIELD[axis]],
+  })),
+)
+
+function commit(axis: EstimateAxis, raw: string) {
+  emit('update', axis, parseAxisThreshold(raw))
+}
+</script>
+
+<template>
+  <div class="flex flex-wrap items-center gap-2 border-t border-slate-800 pt-2">
+    <span class="text-[10px] text-slate-500" :title="t(OUTCOME_HINT_KEYS[outcome])">
+      {{ t('pipeline.builder.runWhenAny') }}
+    </span>
+    <template v-for="f in fields" :key="f.axis">
+      <label class="text-slate-400" :title="f.hint">{{ f.label }}</label>
+      <input
+        :value="f.value"
+        :title="f.hint"
+        type="number"
+        min="0"
+        max="1"
+        step="0.1"
+        class="w-14 rounded border border-slate-700 bg-slate-900 px-1.5 py-0.5 text-slate-100"
+        @change="commit(f.axis, ($event.target as HTMLInputElement).value)"
+      />
+    </template>
+  </div>
+</template>

package/app/components/pipeline/OutputBudgetInput.vue

@@ -63,6 +63,7 @@ function commit(raw: string | number) {
     :min="MIN_AGENT_MAX_OUTPUT_TOKENS"
     :max="MAX_AGENT_MAX_OUTPUT_TOKENS"
     :placeholder="placeholder"
+    :title="t('pipeline.outputBudget.hint')"
     :disabled="disabled"
     @change="commit(($event.target as HTMLInputElement).value)"
   />

package/app/components/pipeline/PipelineBuilder.vue

@@ -5,7 +5,9 @@ import type { AgentKind, Pipeline, PipelinePurpose } from '~/types/domain'
 import AgentPalette from '~/components/palettes/AgentPalette.vue'
 import AgentKindIcon from '~/components/pipeline/AgentKindIcon.vue'
 import AgentPromptEditor from '~/components/pipeline/AgentPromptEditor.vue'
+import EstimateThresholdFields from '~/components/pipeline/EstimateThresholdFields.vue'
 import OutputBudgetInput from '~/components/pipeline/OutputBudgetInput.vue'
+import { ESTIMATE_AXES, ESTIMATE_AXIS_FIELD, type EstimateAxis } from '~/utils/estimateGating'
 import { showOverrideField } from '~/utils/uiMode'
 import {
   agentKindMeta,
@@ -47,6 +49,31 @@ function addParticipant(i: number) {
 function removeParticipant(i: number, pIdx: number) {
   pipelines.draftConsensus[i]?.participants.splice(pIdx, 1)
 }
+/**
+ * The consensus escalation gate exposes only the two axes its toggle seeds (risk + impact) —
+ * complexity is a fine reason to run a deeper TEST audit but a poor reason to convene a panel,
+ * which is about disagreement risk. A module constant rather than a template literal so the
+ * array identity is stable across re-renders.
+ */
+const CONSENSUS_ESTIMATE_AXES: readonly EstimateAxis[] = ['risk', 'impact']
+
+// Writing one axis floor back onto each of the three draft gates. These are functions rather
+// than assignments inlined in the template because a template `v-if` does not narrow inside an
+// event handler's closure, so the inline form needs a non-null assertion at every call site —
+// and a `!` on a gate that has since been toggled off is the one shape that throws.
+function setCompanionGatingAxis(i: number | null, axis: EstimateAxis, value: number | undefined) {
+  const gating = i === null ? undefined : pipelines.draftGating[i]
+  if (gating) gating[ESTIMATE_AXIS_FIELD[axis]] = value
+}
+function setConsensusGatingAxis(i: number, axis: EstimateAxis, value: number | undefined) {
+  const gating = pipelines.draftConsensus[i]?.gating
+  if (gating) gating[ESTIMATE_AXIS_FIELD[axis]] = value
+}
+function setTesterQualityGatingAxis(i: number, axis: EstimateAxis, value: number | undefined) {
+  const gating = pipelines.draftTesterQuality[i]?.gating
+  if (gating) gating[ESTIMATE_AXIS_FIELD[axis]] = value
+}
+
 /** Toggle gating on/off for a draft step's consensus config. */
 function toggleGating(i: number) {
   const cfg = pipelines.draftConsensus[i]
@@ -786,43 +813,15 @@ async function clone(p: Pipeline) {
                     @click="pipelines.toggleDraftGating(unit.companionIndex)"
                   />
                 </div>
-                <div
+                <EstimateThresholdFields
                   v-if="pipelines.draftGating[unit.companionIndex]?.enabled"
-                  class="flex flex-wrap items-center gap-2 border-t border-slate-800 pt-2"
-                >
-                  <span class="text-[10px] text-slate-500">{{
-                    t('pipeline.builder.runWhenAny')
-                  }}</span>
-                  <label class="text-slate-400">{{
-                    t('pipeline.builder.complexityThreshold')
-                  }}</label>
-                  <input
-                    v-model.number="pipelines.draftGating[unit.companionIndex]!.minComplexity"
-                    type="number"
-                    min="0"
-                    max="1"
-                    step="0.1"
-                    class="w-14 rounded border border-slate-700 bg-slate-900 px-1.5 py-0.5 text-slate-100"
-                  />
-                  <label class="text-slate-400">{{ t('pipeline.builder.riskThreshold') }}</label>
-                  <input
-                    v-model.number="pipelines.draftGating[unit.companionIndex]!.minRisk"
-                    type="number"
-                    min="0"
-                    max="1"
-                    step="0.1"
-                    class="w-14 rounded border border-slate-700 bg-slate-900 px-1.5 py-0.5 text-slate-100"
-                  />
-                  <label class="text-slate-400">{{ t('pipeline.builder.impactThreshold') }}</label>
-                  <input
-                    v-model.number="pipelines.draftGating[unit.companionIndex]!.minImpact"
-                    type="number"
-                    min="0"
-                    max="1"
-                    step="0.1"
-                    class="w-14 rounded border border-slate-700 bg-slate-900 px-1.5 py-0.5 text-slate-100"
-                  />
-                </div>
+                  :gating="pipelines.draftGating[unit.companionIndex]!"
+                  :axes="ESTIMATE_AXES"
+                  outcome="step"
+                  @update="
+                    (axis, value) => setCompanionGatingAxis(unit.companionIndex, axis, value)
+                  "
+                />
               </div>
 
               <!-- Consensus config (shown when the step is consensus-enabled). -->
@@ -953,31 +952,14 @@ async function clone(p: Pipeline) {
                       :title="t('pipeline.builder.consensusGateTooltip')"
                       @click="toggleGating(unit.index)"
                     />
-                    <template v-if="pipelines.draftConsensus[unit.index]!.gating?.enabled">
-                      <label class="text-slate-400">{{
-                        t('pipeline.builder.riskThreshold')
-                      }}</label>
-                      <input
-                        v-model.number="pipelines.draftConsensus[unit.index]!.gating!.minRisk"
-                        type="number"
-                        min="0"
-                        max="1"
-                        step="0.1"
-                        class="w-14 rounded border border-slate-700 bg-slate-900 px-1.5 py-0.5 text-slate-100"
-                      />
-                      <label class="text-slate-400">{{
-                        t('pipeline.builder.impactThreshold')
-                      }}</label>
-                      <input
-                        v-model.number="pipelines.draftConsensus[unit.index]!.gating!.minImpact"
-                        type="number"
-                        min="0"
-                        max="1"
-                        step="0.1"
-                        class="w-14 rounded border border-slate-700 bg-slate-900 px-1.5 py-0.5 text-slate-100"
-                      />
-                    </template>
                   </div>
+                  <EstimateThresholdFields
+                    v-if="pipelines.draftConsensus[unit.index]!.gating?.enabled"
+                    :gating="pipelines.draftConsensus[unit.index]!.gating!"
+                    :axes="CONSENSUS_ESTIMATE_AXES"
+                    outcome="consensus"
+                    @update="(axis, value) => setConsensusGatingAxis(unit.index, axis, value)"
+                  />
                 </template>
               </div>
 
@@ -1013,43 +995,13 @@ async function clone(p: Pipeline) {
                     @click="pipelines.toggleDraftTesterQualityGating(unit.index)"
                   />
                 </div>
-                <div
+                <EstimateThresholdFields
                   v-if="pipelines.draftTesterQuality[unit.index]?.gating?.enabled"
-                  class="flex flex-wrap items-center gap-2 border-t border-slate-800 pt-2"
-                >
-                  <span class="text-[10px] text-slate-500">{{
-                    t('pipeline.builder.runWhenAny')
-                  }}</span>
-                  <label class="text-slate-400">{{
-                    t('pipeline.builder.complexityThreshold')
-                  }}</label>
-                  <input
-                    v-model.number="pipelines.draftTesterQuality[unit.index]!.gating!.minComplexity"
-                    type="number"
-                    min="0"
-                    max="1"
-                    step="0.1"
-                    class="w-14 rounded border border-slate-700 bg-slate-900 px-1.5 py-0.5 text-slate-100"
-                  />
-                  <label class="text-slate-400">{{ t('pipeline.builder.riskThreshold') }}</label>
-                  <input
-                    v-model.number="pipelines.draftTesterQuality[unit.index]!.gating!.minRisk"
-                    type="number"
-                    min="0"
-                    max="1"
-                    step="0.1"
-                    class="w-14 rounded border border-slate-700 bg-slate-900 px-1.5 py-0.5 text-slate-100"
-                  />
-                  <label class="text-slate-400">{{ t('pipeline.builder.impactThreshold') }}</label>
-                  <input
-                    v-model.number="pipelines.draftTesterQuality[unit.index]!.gating!.minImpact"
-                    type="number"
-                    min="0"
-                    max="1"
-                    step="0.1"
-                    class="w-14 rounded border border-slate-700 bg-slate-900 px-1.5 py-0.5 text-slate-100"
-                  />
-                </div>
+                  :gating="pipelines.draftTesterQuality[unit.index]!.gating!"
+                  :axes="ESTIMATE_AXES"
+                  outcome="step"
+                  @update="(axis, value) => setTesterQualityGatingAxis(unit.index, axis, value)"
+                />
               </div>
             </li>
           </ol>

package/app/components/settings/ConsensusGroupsSection.vue

@@ -427,7 +427,10 @@ function fail(title: string, e: unknown) {
           {{ t('settings.consensusGroups.editor.gatedHint') }}
         </p>
         <div v-if="editor.gated" class="flex flex-wrap items-center gap-3 text-xs">
-          <label class="flex items-center gap-1.5 text-slate-400">
+          <label
+            class="flex items-center gap-1.5 text-slate-400"
+            :title="t('pipeline.builder.riskThresholdHint')"
+          >
             {{ t('pipeline.builder.riskThreshold') }}
             <UInput
               v-model.number="editor.minRisk"
@@ -439,7 +442,10 @@ function fail(title: string, e: unknown) {
               class="w-20"
             />
           </label>
-          <label class="flex items-center gap-1.5 text-slate-400">
+          <label
+            class="flex items-center gap-1.5 text-slate-400"
+            :title="t('pipeline.builder.impactThresholdHint')"
+          >
             {{ t('pipeline.builder.impactThreshold') }}
             <UInput
               v-model.number="editor.minImpact"
@@ -451,7 +457,10 @@ function fail(title: string, e: unknown) {
               class="w-20"
             />
           </label>
-          <label class="flex items-center gap-1.5 text-slate-400">
+          <label
+            class="flex items-center gap-1.5 text-slate-400"
+            :title="t('pipeline.builder.complexityThresholdHint')"
+          >
             {{ t('settings.consensusGroups.editor.complexityThreshold') }}
             <UInput
               v-model.number="editor.minComplexity"

package/app/utils/estimateGating.spec.ts

@@ -0,0 +1,44 @@
+import { describe, it, expect } from 'vitest'
+import {
+  ESTIMATE_AXES,
+  ESTIMATE_AXIS_FIELD,
+  ESTIMATE_AXIS_HINT_KEYS,
+  ESTIMATE_AXIS_LABEL_KEYS,
+  parseAxisThreshold,
+} from './estimateGating'
+
+describe('parseAxisThreshold', () => {
+  it('clears the axis on an empty or unparseable field rather than storing a zero floor', () => {
+    // The two are opposites: an unset axis is not considered, where a 0 floor always passes.
+    expect(parseAxisThreshold('')).toBeUndefined()
+    expect(parseAxisThreshold('   ')).toBeUndefined()
+    expect(parseAxisThreshold('abc')).toBeUndefined()
+    expect(parseAxisThreshold('0')).toBe(0)
+  })
+
+  it('keeps a value inside the estimator scale', () => {
+    expect(parseAxisThreshold('0.6')).toBe(0.6)
+    expect(parseAxisThreshold(' 0.25 ')).toBe(0.25)
+  })
+
+  it('clamps out-of-range input instead of rejecting it', () => {
+    // A fat-fingered extra digit lands on the ceiling rather than failing the save with a 422.
+    expect(parseAxisThreshold('10')).toBe(1)
+    expect(parseAxisThreshold('-3')).toBe(0)
+  })
+})
+
+describe('estimate axis vocabulary', () => {
+  it('covers every axis in both key maps and the field map', () => {
+    for (const axis of ESTIMATE_AXES) {
+      expect(ESTIMATE_AXIS_LABEL_KEYS[axis]).toBeTruthy()
+      expect(ESTIMATE_AXIS_HINT_KEYS[axis]).toBeTruthy()
+      expect(ESTIMATE_AXIS_FIELD[axis]).toBeTruthy()
+    }
+  })
+
+  it('gives each axis its own hint, so no two axes explain the same thing', () => {
+    const hints = ESTIMATE_AXES.map((axis) => ESTIMATE_AXIS_HINT_KEYS[axis])
+    expect(new Set(hints).size).toBe(ESTIMATE_AXES.length)
+  })
+})