learning_ai_common_plat/docs
saravanakumardb1 57a09c31dd feat(ai-ui): @bytelyst/ai-ui@0.5.0 — Wave 13.C trust surfaces (CostMeter / ConfidenceTag / RefusalCard)
Three new primitives — every product chat / agent surface should
adopt these to make the model honest about what it is doing.

──────────────────────────────────────────────────────────────────
<CostMeter>  ·  Wave 13.C.1
──────────────────────────────────────────────────────────────────
  packages/ai-ui/src/CostMeter.tsx (new)

  - Live token + (optional) USD readout
  - 4 tiers: neutral (no budget) · ok (<70 %) · warn (>=70 %) ·
    danger (>=95 %) — token-tinted via color-mix() so all four
    palettes degrade gracefully on browsers without var() support
  - NaN-safe — non-finite / negative inputs floor to 0
  - role=status + aria-live=polite + aria-label assembles a
    screen-reader-friendly sentence
  - Mini-bar visual indicator at the end of the pill when budget
    is provided
  - Pure passive surface — never warns / prompts / blocks

──────────────────────────────────────────────────────────────────
<ConfidenceTag>  ·  Wave 13.C.2
──────────────────────────────────────────────────────────────────
  packages/ai-ui/src/ConfidenceTag.tsx (new)

  - Accepts `number | 'high' | 'medium' | 'low' | 'unknown'`
  - Default thresholds 0.8 / 0.5 — both overridable
  - Out-of-range numerics map to `unknown` (no false confidence)
  - Optional `showScore` renders a tabular-nums percent suffix
  - 4 token-tinted palettes (success / warning / danger /
    neutral) — pair naturally with <CitationChip> for the full
    'show your work' story

──────────────────────────────────────────────────────────────────
<RefusalCard>  ·  Wave 13.C.3
──────────────────────────────────────────────────────────────────
  packages/ai-ui/src/RefusalCard.tsx (new)

  - 6 reason archetypes — safety / policy / capability /
    authorization / rate-limit / unknown — each with a typed
    heading + glyph
  - Calm warning palette (never red) — refusals are not errors
  - Up to 3 actionable next steps (further entries silently
    clipped) — one is markable `primary` to render as filled CTA
  - Optional `footer` slot for policy doc links
  - role=note + composite aria-label covering heading +
    explanation

──────────────────────────────────────────────────────────────────
Quality gates
──────────────────────────────────────────────────────────────────
  ✓ pnpm -F @bytelyst/ai-ui test  →  67/67 passing (was 53/53)
    +14 new trust-surface tests in src/__tests__/trust.test.tsx
  ✓ Exports wired in src/index.ts under '0.5 surfaces' section
  ✓ package.json 0.4.0 → 0.5.0

──────────────────────────────────────────────────────────────────
Roadmap tracker — 5 boxes flipped (§11)
──────────────────────────────────────────────────────────────────
  13.C.1  CostMeter shipped
  13.C.2  ConfidenceTag shipped
  13.C.3  RefusalCard shipped
  13.C.7  trust-surfaces showcase (lands in paired showcase commit)
  MAG.3   the trust-surfaces customer-magnet 

Wave 13 Futurism: 5/39 → 9/39 (23%)
Magnet demos:     1/8  → 2/8  (25%)
TOTAL:            19/202 → 24/202 (12%)

Vendored snapshot + showcase /ai-ui/* + /futurism/trust-surfaces
routes land in the paired showcase commit.

Pending in 13.C: ProvenanceDrawer (.4) · DebugOverlay (.5) ·
PrivacyBadge (.6).
2026-05-27 16:45:07 -07:00
..
_MobileApps docs: add Apple App Store + Google Play Store release guides 2026-04-04 23:37:25 -07:00
architecture docs(inventory): refresh platform and workspace capability maps 2026-03-05 22:59:45 -08:00
audits docs(audits): mobile app readiness audit + companion targets implementation prompt 2026-03-27 08:19:32 -07:00
design docs: complete Platform Acceleration Roadmap (all 4 phases) — move to completed/ 2026-03-19 22:13:21 -07:00
design-system docs: design system audit, onboarding guide, and AGENTS.md updates 2026-03-03 21:55:02 -08:00
design-system-agents docs(design-system): rewrite agent prompts with parallel-safety, pre-flight checks, build gates, rollback recipes 2026-03-27 17:43:03 -07:00
devops chore(gitea): rename npm package owner ByteLyst -> learning_ai_user 2026-05-26 18:38:57 -07:00
ecosystem docs: add Hermes delegation channel 2026-05-25 02:18:28 +00:00
guides docs: align ecosystem docs with single-source-of-truth agent pattern 2026-05-23 12:07:58 -07:00
MCP+A2A docs: Update EXECUTION_CHECKLIST.md with Phase 15 completion 2026-03-05 22:07:53 -08:00
pnpm docs(pnpm): add MindLyst to migration tracker, update Gitea registry status 2026-03-24 08:28:11 -07:00
rfc ci(packages): close ROADMAP TODOs #5, #6 + draft RFC for #4 2026-05-27 11:49:21 -07:00
roadmaps docs(roadmaps): detailed 2026-04-17 plans for event bus, RAG, agent runtime, approval queue 2026-04-17 09:36:44 -07:00
runbooks docs(runbooks): GITEA_VM_SETUP.md — step-by-step cloud VM wiring 2026-05-27 03:46:09 -07:00
session-logs docs: reorganize docs/ into category folders with roadmaps/{completed,partial,not-started} 2026-03-01 23:17:15 -08:00
workstreams docs(workstreams): align checklist with service consolidation 2026-02-15 08:58:58 -08:00
AGENT_COMPLIANCE_ROADMAP.md docs(compliance): final roadmap update \u2014 100% ecosystem compliance reached 2026-05-23 19:34:49 -07:00
AUDIT_PLATFORM.md docs(audit): reconcile final handoff state 2026-05-04 17:39:48 -07:00
AUDIT_WARNING_COMPLETION_CHECKLIST.md docs(audit): reconcile final handoff state 2026-05-04 17:39:48 -07:00
BROADCAST_SURVEY_API_REFERENCE.md docs(broadcasts,surveys): Complete API reference documentation 2026-03-03 08:28:15 -08:00
CODEX_RESUME_PROMPT.md docs(audit): record auth test reliability fix 2026-05-04 16:59:53 -07:00
CROSS_REPO_DRY_AUDIT.md docs: fix 10 inaccuracies in DRY audit + roadmap after thorough review 2026-03-20 07:15:07 -07:00
DASHBOARD_UI_COVERAGE_ROADMAP.md docs: fix 10 bugs in dashboard UI coverage roadmap — self-audit corrections 2026-03-21 17:35:30 -07:00
DASHBOARD_UI_GAP_ANALYSIS.md docs(admin-web): update gap analysis — all Q1-Q4 TODOs resolved, 0 partially exposed pages 2026-03-21 23:15:24 -07:00
DESIGN_SYSTEM_AUDIT.md docs(audit): add Round 3 hardcoded hex elimination findings to DESIGN_SYSTEM_AUDIT.md 2026-03-29 10:40:47 -07:00
DESIGN_SYSTEM_REMEDIATION_PLAYBOOK.md docs: agent-executable design system remediation playbook — 5 phases, 20 tasks, code templates, verification commands 2026-03-27 16:08:27 -07:00
DESIGN_SYSTEM_REMEDIATION_ROADMAP.md docs(audit): mark all design system remediation roadmap items complete 2026-03-29 01:47:06 -07:00
ECOSYSTEM_CONSISTENCY_AUDIT.md docs: align ecosystem docs with single-source-of-truth agent pattern 2026-05-23 12:07:58 -07:00
ECOSYSTEM_CROSS_POLLINATION_OPPORTUNITIES.md docs: create canonical ecosystem docs home 2026-04-03 15:25:00 -07:00
HANDOVER.md docs(audit): reconcile final handoff state 2026-05-04 17:39:48 -07:00
learning_ai_common_plat_INVENTORY.md docs: align ecosystem docs with single-source-of-truth agent pattern 2026-05-23 12:07:58 -07:00
MOBILE_DRY_REFACTORING_ROADMAP.md docs: Add post-implementation review fixes section to roadmap 2026-03-20 23:16:19 -07:00
PROTOTYPE_DEPLOYMENT.md chore(docker): add interactive cleanup menu 2026-05-05 18:28:55 -07:00
ROADMAP_2026_DECISIONS.md feat(packages): close ROADMAP TODOs #1, #2, #3 — density tier, react-auth fix, routePrefix 2026-05-27 11:49:20 -07:00
STORYBOOK_TEMPLATE.md ci(packages): close ROADMAP TODOs #5, #6 + draft RFC for #4 2026-05-27 11:49:21 -07:00
UI_ROADMAP_2026_V3_CROSS_REPO.md feat(ai-ui): @bytelyst/ai-ui@0.5.0 — Wave 13.C trust surfaces (CostMeter / ConfidenceTag / RefusalCard) 2026-05-27 16:45:07 -07:00
UNIFIED_BYTELYST_PORTAL_PRD.md fix(docs): self-audit Portal PRD + roadmap — 15 findings corrected 2026-03-21 20:57:28 -07:00
UNIFIED_BYTELYST_PORTAL_ROADMAP.md fix(docs): self-audit Portal PRD + roadmap — 15 findings corrected 2026-03-21 20:57:28 -07:00
WORKSPACE_INVENTORY.md docs(workspace): index gitea runner rollout 2026-05-25 02:32:19 +00:00
WORKSPACE_TODO_AUDIT.md fix(exports): strip data payload from list endpoint + update audit doc 2026-03-22 01:23:08 -07:00