cocottetech/@platform/codebase/@features/ai-copilot/docs/trust-panel.screen.md

84 lines
4.9 KiB
Markdown
Raw Normal View History

# trust-panel.screen
Per-specialist trust breakdown. Implements [brief I §5](./I-audit-trust-replay.brief.md). Reached from specialist-drawer.screen.md trust-meter tap. Voice: working, plain on graduation/demotion language.
## Layout (full-screen sheet)
```
┌─────────────────────────────────────────────────┐
│ ◄ bookings-tryst Done │ 56pt
├─────────────────────────────────────────────────┤
│ Trust 0.82 of 1.00 │
│ ━━━━━━━━━━━━━━━━━━━━━░░░ ↑ 0.04 / 30d │ bar + delta
│ │
│ ─── Components ─── │
│ ✓ Action-acceptance rate · 0.94 (last 30d) │
│ ✓ Quinn-correction rate · 0.06 (last 30d) │
│ ✓ External-success rate · 0.91 │
│ ⚠ Surface-ban incidents · 0 (12mo) │
│ ✓ Auto-vs-approve mix · 78% auto │
│ │
│ ─── Posture graduation history ─── │
│ • 2026-04-12 Auto enabled for bumps │ trust milestone log
│ • 2026-03-20 Draft enabled for profile copy │
│ • 2026-03-01 First action ran │
│ │
│ ─── Recent corrections (last 5) ─── │
│ • 2026-05-15 · CHASE_CHECK · "too eager" │ correction list
│ [ See full → ] │
│ • 2026-05-12 · VOICE_REGISTER · "too clinical" │
│ … │
│ │
│ ─── Adjust posture ─── │
│ [ Edit auto/draft thresholds → ] │ routes to graduations sheet
│ [ Demote to draft-only (1 tap) ] │ destructive one-shot
│ [ Retire this specialist (deep) ] │ destructive deep flow
│ │
└─────────────────────────────────────────────────┘
```
## Components
| Component | Notes |
|---|---|
| Top bar | Specialist name + Done. |
| Trust bar | 0.001.00; color per F §F1 (<0.4 / 0.40.7 / >0.7). 30-day delta chevron. |
| Components | 46 contributing signals with current values + 30-day window. Tap → drilldown chart. |
| Posture graduation history | Append-only log of posture changes (auto / draft). Sourced from `agent_actions` per brief I. |
| Recent corrections | Last 5 👎 with CoT step that failed (the 6-step labels per brief J). Tap → audit-row-detail. |
| Adjust posture | 3 actions: edit thresholds (sheet), demote (instant), retire (deep flow). |
## States
1. **Healthy** (>0.7) — default green bar.
2. **Watching** (0.40.7) — amber bar, banner: "I'm watching this one — keep an eye on corrections."
3. **At risk** (<0.4) rose bar + plain banner: "Trust is low. I'll only draft until you graduate me again."
4. **Auto-demoted recently** (per L §L4) — banner: "I dialed myself back to draft-only on {date} after 4 corrections this week."
5. **Retired** — read-only; "Adjust posture" hidden; banner: "Retired {date}. History preserved."
6. **First-7-days** — Components show "—" with copy "Trust takes a few days to build." Bar shows 0.50 neutral.
7. **Reduced motion** — no animated chevron.
## Interactions
- **Tap a component** → drilldown chart of that signal over 90 days.
- **Tap "Edit thresholds"** → graduations sheet (per-action-type auto threshold sliders).
- **Tap "Demote"** → confirms (medium-stakes); commits + records audit.
- **Tap "Retire"** → deep confirmation (high-stakes); plain register.
- **Tap a correction row** → audit-row-detail.
## Edge cases
- **Component data missing** (e.g. external-success unknown) — value shows "—"; doesn't penalize trust.
- **Quinn retiring her own primary specialist** (e.g. ai-copilot) → blocked; chip: "ai-copilot is the front door and can't be retired."
- **Trust math conflict** (signals contradict — high acceptance but high corrections) — banner: "Mixed signals. Edit thresholds with care."
## Related
- [Brief I §5](./I-audit-trust-replay.brief.md) — parent.
- [Brief L §L4](./L-specialists-fleet.brief.md) — lifecycle (demote, retire, onboard).
- [specialist-drawer.screen.md](./specialist-drawer.screen.md) — entry point.
- [audit-row-detail.screen.md](./audit-row-detail.screen.md) — correction-row target.
## Out of scope
- The graduations sheet interior (own screen if it grows).
- Cross-specialist trust comparison (defer).