V48 Gate 3 (specification-implementation): every tooltip carries ALL its sections

Hover stat/pill tooltips: TelemetryPillExplainer.generic is REQUIRED
again — a rich tooltip without the second (generic type copy) section
no longer compiles. Every stat call site now passes both sections:
route header metric chips, panel disclosure summaries, and proof-root
rows (product-route-shell generics); session/authority/earning/
opportunity rows (DEPOSIT_STAT_TOOLTIP_GENERICS in
deposit-stat-explainers.ts); table overview stat chips + state pills.

Inline (i) explainers: every BitcodeExplainer entry across the product
registries now carries all six sections (kicker, title, summary,
detail, 'Use this to' points, current source + canon references):
- bitcode-transaction-explainers: references added to all 20 entries
  (shared source/canon ref consts + per-entry component paths)
- terminal-workspace-explainers: kicker + points added to 26 entries
- auxillary-pane-explainers: references added to all 6 entries
- bitcode-public-explainers: references added to all 7 entries
(deposit-explainers already complete; all cited source paths verified
to exist.)

Spec: presentation-laws section gains the all-sections tooltip law —
the two tooltip families and their complete required section sets,
with the hover family's second section enforced at the type level.

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

Author: geraldarthurdavis

BITCODE_SPEC_V48_NOTES.md

@@ -604,6 +604,17 @@ shared transactions/telemetry components) is governed by these laws:
   (copy: `uapi/app/deposits/deposit-stat-explainers.ts`). Tooltips are
   viewport-height capped and INTERACTIVE: overflow scrolls inside the
   tooltip (pointer can travel in; inner scrolls do not dismiss it).
+- **All tooltips carry ALL their sections.** Two tooltip families, each
+  with a complete required section set:
+  - Hover stat/pill tooltips (`TelemetryPillExplainer`): kicker + title +
+    SPECIFIC copy (this exact value) + GENERIC type copy below the divider.
+    `generic` is TYPE-REQUIRED — a tooltip without the second section does
+    not compile.
+  - Inline (i) explainers (`BitcodeExplainer`): kicker, title, summary,
+    detail, 'Use this to' points, and references (current source files +
+    current canon). Every explainer entry on the product surfaces
+    (transaction filters/table, deposit sections, terminal workspace)
+    carries all six.
 - **The one rich dropdown.** Every pick-one control is the shared
   SearchableSelect combobox (square, text-searchable): all seven table
   filters, provider, repository, branch, and commit. The deposit source

uapi/app/auxillaries/components/auxillary-pane-explainers.ts

@@ -18,6 +18,12 @@ export const auxillaryPaneExplainers: Record<
       "Keep MCP API and ChatGPT App entry posture predictable",
       "Decide whether proofs open visually, mixed, or as raw evidence",
     ],
+    references: {
+      source: [
+        "uapi/app/auxillaries/components/AuxillariesInterfacesPane.tsx",
+      ],
+      canon: ["BITCODE_SPEC_V48_NOTES.md — deposit/read product-surface presentation laws"],
+    },
   },
   interfacesPrompt: {
     kicker: "Interfaces auxillary",
@@ -31,6 +37,12 @@ export const auxillaryPaneExplainers: Record<
       "Bias toward throughput, quality, or balanced review",
       "Preserve one reusable non-ledgerized instruction surface",
     ],
+    references: {
+      source: [
+        "uapi/app/auxillaries/components/AuxillariesInterfacesPane.tsx",
+      ],
+      canon: ["BITCODE_SPEC_V48_NOTES.md — deposit/read product-surface presentation laws"],
+    },
   },
   interfacesModels: {
     kicker: "Interfaces auxillary",
@@ -44,6 +56,12 @@ export const auxillaryPaneExplainers: Record<
       "Keep provider and model evidence in telemetry",
       "Treat conversation-only model choice as outside settlement authority",
     ],
+    references: {
+      source: [
+        "uapi/app/auxillaries/components/AuxillariesInterfacesPane.tsx",
+      ],
+      canon: ["BITCODE_SPEC_V48_NOTES.md — deposit/read product-surface presentation laws"],
+    },
   },
   btdWallet: {
     kicker: "Wallet auxillary",
@@ -57,6 +75,12 @@ export const auxillaryPaneExplainers: Record<
       "Surface whether BTC and wallet binding are already attached",
       "Keep team and membership posture visible beside fee and share posture",
     ],
+    references: {
+      source: [
+        "uapi/app/auxillaries/components/AuxillariesWalletPane.tsx",
+      ],
+      canon: ["BITCODE_SPEC_V48_NOTES.md — deposit/read product-surface presentation laws"],
+    },
   },
   btdShares: {
     kicker: "Wallet auxillary",
@@ -70,6 +94,12 @@ export const auxillaryPaneExplainers: Record<
       "Keep settlement reading explicit before closure",
       "Control how BTD-specific detail re-enters Terminal and interface surfaces",
     ],
+    references: {
+      source: [
+        "uapi/app/auxillaries/components/AuxillariesWalletPane.tsx",
+      ],
+      canon: ["BITCODE_SPEC_V48_NOTES.md — deposit/read product-surface presentation laws"],
+    },
   },
   btdAdvanced: {
     kicker: "Wallet auxillary",
@@ -83,5 +113,11 @@ export const auxillaryPaneExplainers: Record<
       "Decide how BTD detail should open back into transaction views",
       "Keep replay and closure posture aligned to one account preference",
     ],
+    references: {
+      source: [
+        "uapi/app/auxillaries/components/AuxillariesWalletPane.tsx",
+      ],
+      canon: ["BITCODE_SPEC_V48_NOTES.md — deposit/read product-surface presentation laws"],
+    },
   },
 };

uapi/app/deposits/DepositPageClient.tsx

@@ -72,6 +72,7 @@ import BitcodeInlineExplainer from "@/components/base/bitcode/execution/BitcodeI
 import { DEPOSIT_SECTION_EXPLAINERS } from "@/app/deposits/deposit-explainers";
 import {
   DEPOSIT_AUTHORITY_BLOCKERS_EXPLAINER,
+  DEPOSIT_STAT_TOOLTIP_GENERICS,
   DEPOSIT_AUTHORITY_ROW_EXPLAINERS,
   DEPOSIT_DISCLOSURE_BOUNDARY_EXPLAINER,
   DEPOSIT_EARNING_ROW_EXPLAINERS,
@@ -2279,6 +2280,7 @@ export default function DepositPageClient() {
                     kicker: "Earning intelligence",
                     title: "Likely demand",
                     specific: DEPOSIT_EARNING_ROW_EXPLAINERS["Likely demand"],
+                    generic: DEPOSIT_STAT_TOOLTIP_GENERICS.earningIntelligence,
                   }}
                 >
                   <dt className="text-[0.58rem] uppercase tracking-[0.14em] text-neutral-500">
@@ -2300,6 +2302,7 @@ export default function DepositPageClient() {
                     kicker: "Earning intelligence",
                     title: "Unfit Need opportunities",
                     specific: DEPOSIT_EARNING_ROW_EXPLAINERS["Unfit Need opportunities"],
+                    generic: DEPOSIT_STAT_TOOLTIP_GENERICS.earningIntelligence,
                   }}
                 >
                   <dt className="text-[0.58rem] uppercase tracking-[0.14em] text-neutral-500">
@@ -2324,6 +2327,7 @@ export default function DepositPageClient() {
                     kicker: "Earning intelligence",
                     title: "Expected compensation",
                     specific: DEPOSIT_EARNING_ROW_EXPLAINERS["Expected compensation"],
+                    generic: DEPOSIT_STAT_TOOLTIP_GENERICS.earningIntelligence,
                   }}
                 >
                   <dt className="text-[0.58rem] uppercase tracking-[0.14em] text-neutral-500">
@@ -2348,6 +2352,7 @@ export default function DepositPageClient() {
                     kicker: "Earning intelligence",
                     title: "Supply recommendations",
                     specific: DEPOSIT_EARNING_ROW_EXPLAINERS["Supply recommendations"],
+                    generic: DEPOSIT_STAT_TOOLTIP_GENERICS.earningIntelligence,
                   }}
                 >
                   <dt className="text-[0.58rem] uppercase tracking-[0.14em] text-neutral-500">
@@ -2381,6 +2386,7 @@ export default function DepositPageClient() {
                           kicker: "Opportunity root",
                           title: opportunity.label,
                           specific: DEPOSIT_OPPORTUNITY_ROOT_EXPLAINER,
+                          generic: DEPOSIT_STAT_TOOLTIP_GENERICS.opportunityRoot,
                         }}
                       >
                         <dt className="text-[0.56rem] uppercase tracking-[0.12em] text-neutral-500">
@@ -2426,6 +2432,7 @@ export default function DepositPageClient() {
                       specific:
                         DEPOSIT_AUTHORITY_ROW_EXPLAINERS[row.label] ??
                         "Organization authority state for this deposit route.",
+                      generic: DEPOSIT_STAT_TOOLTIP_GENERICS.governance,
                     }}
                   >
                     <dt className="text-[0.58rem] uppercase tracking-[0.14em] text-neutral-500">
@@ -2483,6 +2490,7 @@ export default function DepositPageClient() {
                       specific:
                         DEPOSIT_SESSION_ROW_EXPLAINERS[row.label] ??
                         "Source-safe session state for this deposit route.",
+                      generic: DEPOSIT_STAT_TOOLTIP_GENERICS.sessionState,
                     }}
                   >
                     <dt className="text-[0.58rem] uppercase tracking-[0.14em] text-neutral-500">

uapi/app/deposits/deposit-stat-explainers.ts

@@ -97,3 +97,18 @@ export const DEPOSIT_DISCLOSURE_BOUNDARY_EXPLAINER =
 
 export const DEPOSIT_AUTHORITY_BLOCKERS_EXPLAINER =
   "The concrete deposit actions the organization authority currently denies, and why. Repairing these unblocks the Submit deposit stage.";
+
+/**
+ * Section (b) generic copy for the stat tooltips — the what-is-this-type
+ * text rendered below the specific copy, per tooltip kicker.
+ */
+export const DEPOSIT_STAT_TOOLTIP_GENERICS = {
+  sessionState:
+    "Session state rows are the source-safe state of this deposit route — derived from the connected source package and this session's measurements, never from withheld source content.",
+  governance:
+    "Governance rows come from the organization policy + wallet authority evaluation that gates every deposit action; denied actions list their blockers.",
+  earningIntelligence:
+    "Earning intelligence rows come from the DepositorEarningSupplyIntelligence measurement: network demand, unfit-Need opportunities, and expected compensation for this supply.",
+  opportunityRoot:
+    "Proof roots are source-safe hashes anchoring measurements into proof readback — auditable without revealing withheld content.",
+} as const;