# Metis Domain Implementation Map

Generated on May 8, 2026. This document maps the current repository footprint
and Oshun-specific integration points for Metis.

## Implementation Context

Metis owns education, tutoring, assessment, course publication, and grounded
learning workflows in the Oshun platform. It carries forward the Minerva
learning-system capabilities as a domain-oriented service set with explicit
release gates for learner-facing publication.

## Status Snapshot

- Repository status: Repository implementation exists under apps/libs/services.
- Oshun integration status: Registered in the Oshun domain registry.
- TODO phases: `25`

## Applications

- `apps/metis/admin/` - Admin
- `apps/metis/api-gateway/` - Api Gateway
- `apps/metis/web/` - Web
- `apps/metis/worker/` - Worker

## Libraries

- `libs/metis/ab-testing/` - Ab Testing
- `libs/metis/adaptive/` - Adaptive
- `libs/metis/agents/` - Agents
- `libs/metis/agents-types/` - Agents Types
- `libs/metis/api-client/` - Api Client
- `libs/metis/assessment/` - Assessment
- `libs/metis/core/` - Core
- `libs/metis/cost-tracking/` - Cost Tracking
- `libs/metis/course/` - Course
- `libs/metis/database-types/` - Database Types
- `libs/metis/integrations/` - Integrations
- `libs/metis/knowledge-graph/` - Knowledge Graph
- `libs/metis/learning/` - Learning
- `libs/metis/linters-types/` - Linters Types
- `libs/metis/llm-client/` - Llm Client
- `libs/metis/model-registry/` - Model Registry
- `libs/metis/models/` - Models
- `libs/metis/multimedia/` - Multimedia
- `libs/metis/prompt-management/` - Prompt Management
- `libs/metis/quality/` - Quality
- `libs/metis/research/` - Research
- `libs/metis/tutoring/` - Tutoring

## Services

- `services/metis/alembic/` - Alembic
- `services/metis/alembic.ini` - Alembic.ini
- `services/metis/docker-compose.yml` - Docker Compose.yml
- `services/metis/Dockerfile` - Dockerfile
- `services/metis/Dockerfile.dev` - Dockerfile.dev
- `services/metis/openapi/` - Openapi
- `services/metis/pyproject.toml` - Pyproject.toml
- `services/metis/scripts/` - Scripts
- `services/metis/src/` - Src
- `services/metis/tests/` - Tests

## OpenAPI And Contract Roots

No OpenAPI or domain-specific API root discovered.

## Existing Standalone Domain Docs

- `docs/domains/metis/dependency-upgrade-roadmap.md` - Dependency Upgrade
  Roadmap.md
- `docs/domains/metis/extras/` - Extras
- `docs/domains/metis/METIS_KNOWLEDGE_GRAPH_AND_RETRIEVAL_ALGORITHM_STATUS.md` -
  METIS KNOWLEDGE GRAPH AND RETRIEVAL ALGORITHM STATUS.md
- `docs/domains/metis/METIS_OPERATOR_TRAINING_AND_LAUNCH_CRITERIA.md` - METIS
  OPERATOR TRAINING AND LAUNCH CRITERIA.md
- `docs/domains/metis/METIS_PUBLICATION_RELEASE_GATES_RUNBOOK.md` - METIS
  PUBLICATION RELEASE GATES RUNBOOK.md
- `docs/domains/metis/multi-region-deployment.md` - Multi Region Deployment.md
- `docs/domains/metis/README.md` - README.md
- `docs/domains/metis/success-criteria-metrics.md` - Success Criteria Metrics.md
- `docs/domains/metis/test-coverage-baseline.md` - Test Coverage Baseline.md

## Test And Verification Evidence

- `tests/integration/flows/metis-real-llm-e2e.integration.test.ts`

## Oshun Integration Summary

| Reference Scope | Count |
| --------------- | ----- |
| apps/oshun      | 343   |
| libs/oshun      | 127   |

## Oshun-Specific Integration References

- `apps/oshun/admin/.next/server/app/api/admin/workspaces/[workspaceId]/saved-views/route.js`
- `apps/oshun/admin/.next/server/app/inbox/page.js`
- `apps/oshun/admin/.next/server/app/incidents/page.js`
- `apps/oshun/admin/.next/server/app/policy/page.js`
- `apps/oshun/admin/.next/server/app/review/page.js`
- `apps/oshun/admin/.next/static/chunks/app/inbox/page.js`
- `apps/oshun/admin/.next/static/chunks/app/incidents/page.js`
- `apps/oshun/admin/.next/static/chunks/app/policy/page.js`
- `apps/oshun/admin/.next/static/chunks/app/review/page.js`
- `apps/oshun/bff/README.md`
- `apps/oshun/bff/openapi/oshun-bff.openapi.yaml`
- `apps/oshun/bff/package.json`
- `apps/oshun/bff/src/__tests__/activity-route.test.ts`
- `apps/oshun/bff/src/__tests__/contract/shell-bff-contract.test.ts`
- `apps/oshun/bff/src/__tests__/contract/shell-bff-operations-contract.test.ts`
- `apps/oshun/bff/src/__tests__/cross-domain-recommendation-telemetry.test.ts`
- `apps/oshun/bff/src/__tests__/cross-domain-recommendations-route.test.ts`
- `apps/oshun/bff/src/__tests__/customer-entitlement-feature-exposure.test.ts`
- `apps/oshun/bff/src/__tests__/domains-route.test.ts`
- `apps/oshun/bff/src/__tests__/library-route.test.ts`
- `apps/oshun/bff/src/__tests__/notifications-preferences-route.test.ts`
- `apps/oshun/bff/src/__tests__/profile-route.test.ts`
- `apps/oshun/bff/src/__tests__/search-route.test.ts`
- `apps/oshun/bff/src/__tests__/search-suggestions-route.test.ts`
- `apps/oshun/bff/src/notifications/preferences-store.ts`

Additional references omitted: 445

## Documentation Gaps

- Repository implementation roots are present and reflected above.
- Standalone domain docs exist and were folded into the evidence profile.
- Domain test evidence exists and is listed above.
