Status: Canonical Date: 2026-04-26 Owners: OSHUN Nisaba Product, OSHUN
Cross-Domain, OSHUN Product Analytics Tracks: V1-OBS-007 from
OSHUN_V1_TODOS.md Spec source: libs/oshun/analytics/src/dashboards-nisaba.ts
This document is the canonical, human-readable companion to the machine-readable
V1 Nisaba dashboard manifest in @oshun/analytics.
The machine-readable manifest is the single source of truth.
1. Scope#
This manifest defines the two V1 Nisaba dashboards mandated by V1-OBS-007:
oshun-v1-nisaba-adoption— Nisaba customer adoption: launches, study actions, inspector opens, expert-mode adoption, note-savers, passage opens, and a D7/D30 cohort grid.oshun-v1-nisaba-cross-domain-attachment— how Nisaba attaches to Tara and the companion domains: bidirectional cross-domain recommendations, Nisaba-filtered universal search, activity reentry into Nisaba, and the Nisaba share of home continuation impressions and clicks.
Pairs with:
- the customer taxonomy (
customer-taxonomy.ts, V1-OBS-001) — the source of every event a metric reads from - the customer KPI dashboard manifest (
dashboards-customer-kpi.ts, V1-OBS-006) — the shared metric/panel/visualization shape
Out-of-scope:
- assistant quality / disclosure dashboards (V1-OBS-008)
2. Manifest shape#
Nisaba dashboards reuse the metric/panel shape from
dashboards-customer-kpi.ts. The dashboard identifier and owner enums are
extended to cover the Nisaba surface:
id:oshun-v1-nisaba-adoption|oshun-v1-nisaba-cross-domain-attachmentowner:nisaba_product|cross_domain|product_analytics
3. Adoption dashboard#
Metrics:
nisaba_adoption.domain_launched— count ofoshun.domain.launchedfiltered todomain=nisabanisaba_adoption.unique_users— unique users who launched Nisabanisaba_adoption.study_action_count—nisaba.study.action_triggeredbyactionnisaba_adoption.inspector_opens_by_pane—nisaba.inspector.openedbyinspectornisaba_adoption.expert_mode_enabled_share—nisaba.expert_mode.toggledfiltered toenabled=truenisaba_adoption.note_saved_unique_users— unique users who saved a note vianisaba.note.savednisaba_adoption.passage_opens_by_origin—nisaba.passage.openedbyoriginsurfacenisaba_adoption.cohort_d7_d30_resume— D7/D30 cohort retention for Nisaba launchers, anchored onoshun.domain.launchedfiltered todomain=nisaba
Panels: launches, unique users, study actions, inspector opens, expert-mode adoption, note-savers, passage opens, cohort grid.
4. Cross-domain attachment dashboard#
Metrics:
nisaba_attachment.recommendations_into_nisaba—oshun.recommendation.impressedfiltered totarget_domain=nisaba, grouped bysource_domainnisaba_attachment.recommendations_from_nisaba— same event filtered tosource_domain=nisaba, grouped bytarget_domainnisaba_attachment.recommendation_tap_rate_into_nisaba— conversion ratio ofoshun.recommendation.tapped / oshun.recommendation.impressedfiltered totarget_domain=nisabanisaba_attachment.search_with_nisaba_filter—oshun.search.executedfiltered todomain_filter=nisabanisaba_attachment.activity_reentry_into_nisaba—oshun.activity.reentry_openedfiltered toprimary_domain=nisaba, grouped bytriggernisaba_attachment.home_continuation_nisaba_share— share ofoshun.home_continuation.impressedemissions wheresurface=nisabanisaba_attachment.home_continuation_click_rate_nisaba— conversion ofoshun.home_continuation.clicked / oshun.home_continuation.impressedforsurface=nisaba
Panels: recommendations into Nisaba, recommendations from Nisaba, recommendation tap-rate into Nisaba, Nisaba-filtered search, activity reentries, home continuation share, home continuation click-rate.
5. KPI parity and integrity#
Tests in dashboards-nisaba.test.ts enforce:
- the four-dashboard manifest is published (two Nisaba dashboards in V1)
- every metric event reference resolves to the customer taxonomy
- every panel references only same-dashboard metrics
- every Nisaba-scoped string filter targets the literal
"nisaba"value - the adoption dashboard exercises every Nisaba-namespace event in the customer
taxonomy (
nisaba.study.action_triggered,nisaba.inspector.opened,nisaba.expert_mode.toggled,nisaba.note.saved,nisaba.passage.opened) - the cross-domain dashboard tracks attachment in both directions
6. Governance#
6.1 Amendments#
Adding or changing a Nisaba dashboard, metric, or panel requires:
- updating
dashboards-nisaba.ts - updating tests (lock-style tests fail closed if metrics drift away from the customer taxonomy)
- updating this document if the change is structurally significant
- signoff from the listed
ownerplus platform analytics
6.2 Versioning#
Same rules as the customer KPI dashboard manifest.
7. Out-of-scope#
- assistant quality / disclosure dashboards (V1-OBS-008)
8. Change log#
- 2026-04-26 — Initial canonical V1 Nisaba dashboard manifest published
alongside
libs/oshun/analytics/src/dashboards-nisaba.ts(V1-OBS-007).