Eve library

Oshun V1 Metis Cross-Domain Recommendation Audit

Guide

Revision 1

On this page

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.