# HyperTwist Phase 4 template-signal confidence snapshot analytics packet

## Purpose

This packet pushes the persisted comparable-peer confidence snapshot from per-run provenance into repo-backed template analytics for broader `TemplateScopedOutcomeSignal` analytics tie-break launches. Operators can now compare whether broader analytics picks made while the split-confidence lane was already `confidence-eligible` are outperforming broader picks that launched while that lane was still `suppressed`, without inspecting individual runs one at a time.

## Scope

- add repo-backed template-scoped stat buckets for broader analytics launches split by retained confidence snapshot state
- classify broader analytics launches into:
  - `confidence-eligible`
  - `suppressed`
  - `no-retained-lane`
- treat older broader analytics launches without the new persisted snapshot as `no-retained-lane` for continuity
- surface that split through the shared template analytics detail used by the live dashboard, template launch history, and run recap

## What landed

- `HyperTwistTrainingTypes.h`
  - added three new per-template selection-scoped stat buckets under `FHyperTwistTrainingTemplateLaunchScopedStats` for broader template-signal launches:
    - `DashboardAnalyticsTieBreakTemplateScopedSignalNoRetainedComparablePeerConfidenceLaneStats`
    - `DashboardAnalyticsTieBreakTemplateScopedSignalConfidenceEligibleStats`
    - `DashboardAnalyticsTieBreakTemplateScopedSignalSuppressedPeerNoEvidenceHeavyStats`
- `HyperTwistTrainingRepositoryLibrary.cpp`
  - added matching internal accumulators
  - broadened analytics tie-break aggregation so `TemplateScopedOutcomeSignal` launches are routed into the new snapshot-state buckets
  - legacy broader analytics launches without the persisted snapshot now accumulate in `no-retained-lane`
- `HyperTwistCoachDashboardWidget.cpp`
  - added a shared formatter for the broader template-signal confidence snapshot split
  - shared template analytics detail now shows:
    - `confidence-eligible`
    - `suppressed`
    - `no-retained-lane`
  - when both eligible and suppressed buckets have outcome history, the detail also reports `eligible-minus-suppressed` delta success and delta mistakes

## Product effect

- the live `[Template Launch]` detail now shows whether broader template-signal picks with an already-eligible split-confidence lane are actually beating broader picks launched from a suppressed lane
- template launch history and run recap inherit the same aggregate comparison automatically through the shared analytics fragment
- operators can distinguish between current broader analytics performance that is evidence-backed, still suppressed, or legacy/no-retained-lane

## Acceptance criteria

- repo-backed template-scoped stats derive distinct broader template-signal buckets for `confidence-eligible`, `suppressed`, and `no-retained-lane`
- older broader template-signal launches without the persisted snapshot land in `no-retained-lane`
- shared template analytics detail shows the new broader template-signal snapshot split
- when both eligible and suppressed buckets have outcomes, shared detail reports delta success and delta mistakes

## Validation checklist

1. full `Development Editor|Win64` build succeeds
2. confirm repository aggregation routes broader template-signal launches into the three new snapshot-state buckets
3. confirm shared analytics detail shows `confidence-eligible`, `suppressed`, and `no-retained-lane`
4. confirm shared detail reports `eligible-minus-suppressed` deltas when both buckets have outcome history
