# Oshun V1 Metis Cross-Domain Recommendation Audit

Task: `V1-MET-146`

## Scope

This task upgrades Oshun cross-domain recommendation logic so recommendations
can begin in Tara, Arete, Veritas, Nyx, Nisaba, or Metis and still land credibly
inside Metis with source context preserved.

## Implementation

- Updated `apps/oshun/bff/src/routes/cross-domain-recommendations.ts` so the
  cross-domain recommendation route now treats `nisaba` and `metis` as valid
  source domains in addition to the existing Tara, Arete, Veritas, and Nyx
  sources.
- Nisaba -> Metis recommendations now derive from the real Nisaba consumer
  state:
  - daily passage
  - passage context
  - annotations
  - notebooks
  - grounded evidence views
- The route now composes the canonical
  `resolveNisabaMetisStudyRelationship(...)` contract so Nisaba recommendations
  preserve the source passage anchor and Metis landing context.
- Metis -> Metis recommendations now surface a continuity-preserving reentry
  path instead of dropping Metis out of the recommendation source model.
- Updated
  `apps/oshun/bff/src/__tests__/cross-domain-recommendations-route.test.ts` to
  verify:
  - all six source domains can produce Metis landings
  - Nisaba and Metis source recommendations are returned on the shared route
  - Metis-only shell targeting still returns both external and Metis-native
    Metis continuations

## Release Semantics

- Cross-domain recommendation logic no longer assumes Metis is only a landing
  target from four source domains.
- Nisaba handoffs now preserve source-text context in the Metis destination
  instead of collapsing into generic study prompts.
- Metis can now recommend the correct Metis continuation path through the same
  route used for cross-domain recommendations, which keeps the shell handoff
  model consistent.

## Verification

- `pnpm --dir apps/oshun/bff exec vitest run src/__tests__/cross-domain-recommendations-route.test.ts`
- `pnpm exec prettier --check apps/oshun/bff/src/routes/cross-domain-recommendations.ts apps/oshun/bff/src/__tests__/cross-domain-recommendations-route.test.ts`

## Blockers

- `pnpm --dir apps/oshun/bff exec tsc --noEmit` remains blocked by unrelated
  pre-existing workspace TypeScript failures outside the touched cross-domain
  recommendation files.
