V48 Gate 3 (implementation-only): pill tooltips lead with what each element is prompted to do and what it returns

Restructure every telemetry-pill tooltip: the TOP section is now the
SPECIFIC meaning of that exact element — a human-comprehension summary of
what it is PROMPTED to do and what it RETURNS (its output-schema
expectations), written from the real sources (deposit agents' prompt
constants + zod outputSchemas, the PTRR step factories, the failsafe
sequence, the Thinkings generations) — and the generic 'Phases are…' /
'Agents are…' type-copy moves BELOW it.

- Deposit agents: per-agent 'Prompted to …; returns {…} with …' copy
  (input comprehension, clone, codebase comprehension, depository search,
  inherent regurgitation, synthesis, validation, measure-absolutes,
  upload-for-review), lens-variant where deposit/read share a role name.
- Phases: mode-aware per-phase SDIVF jobs (deposit: clone+obfuscation
  comprehension, three discovery lenses, measured patch options,
  fail-closed validation+absolutes, upload for depositor review).
- Steps: plan/try/refine/retry prompted-with copy, generating against the
  agent's output schema — sharpened by the row's agent context when the
  trigger passes one (getTelemetryPillExplainer gains an optional
  {agent, step} context; ExecutionContextPillRow passes its own).
- Failsafes: PCC {preparation, system, pipeline_execution_keys} →
  {selectedKeys}; chunk-then-sum request-budget one-vs-chunked+sum;
  stitch-until-complete schema validation + bounded error-carrying repairs.
- Generations: reason {analysis, steps, conclusion, confidence}; judge
  advisory {quality, issues, suggestions, approved}; structured_output
  typed against the zod schema.

All copy stays source-safe: shapes and purposes only, never depositor
content. TelemetryExplainerTrigger renders specific above generic.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Author: geraldarthurdavis

uapi/components/base/bitcode/execution/ExecutionContextPillRow.tsx

@@ -92,7 +92,7 @@ export function ExecutionContextPillRow({
       {pills.map((pill) => (
         <TelemetryExplainerTrigger
           key={pill.type}
-          explainer={getTelemetryPillExplainer(pill.type, pill.raw, mode)}
+          explainer={getTelemetryPillExplainer(pill.type, pill.raw, mode, { agent, step })}
         >
           <PathPill type={pill.type} label={pill.label} />
         </TelemetryExplainerTrigger>

uapi/components/base/bitcode/execution/TelemetryExplainerTrigger.tsx

@@ -23,9 +23,10 @@ interface TelemetryExplainerTriggerProps {
 
 /**
  * Wraps a telemetry pill (or row icon) as a rich-tooltip trigger: hover /
- * focus / touch shows a two-section explainer (generic type copy + the
- * specific value's copy) in a portal, using the exact placement machinery of
- * BitcodeInlineExplainer — but with the wrapped element itself as the
+ * focus / touch shows a two-section explainer — the SPECIFIC copy for this
+ * exact value on TOP (what it is prompted to do + what it returns), the
+ * generic type copy BELOW — in a portal, using the exact placement machinery
+ * of BitcodeInlineExplainer — but with the wrapped element itself as the
  * trigger instead of a separate "i" button, so the title-line stays clean.
  * Non-intrusive: no extra tab stops, clicks pass through to the row.
  */
@@ -81,10 +82,10 @@ export function TelemetryExplainerTrigger({
             {explainer.title}
           </strong>
           <span className="relative mt-2 block text-sm font-normal normal-case tracking-normal leading-6 text-neutral-200">
-            {explainer.generic}
+            {explainer.specific}
           </span>
           <span className="relative mt-3 block border-t border-white/8 pt-3 text-sm font-normal normal-case tracking-normal leading-6 text-neutral-400">
-            {explainer.specific}
+            {explainer.generic}
           </span>
         </span>,
         document.body,