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.tsso the cross-domain recommendation route now treatsnisabaandmetisas 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.tsto 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.tspnpm 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 --noEmitremains blocked by unrelated pre-existing workspace TypeScript failures outside the touched cross-domain recommendation files.