# Metis Domain

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.

## Responsibilities

- Course, lesson, module, and assessment lifecycle management
- Source-backed course grounding, retrieval, and concept graph workflows
- Tutoring, learner progress, and adaptive recommendation flows
- Publication governance, release gates, rights review, and operator readiness
- Migration of Minerva capabilities into Oshun TypeScript and service contracts

## Primary References

| Document                                                                                                  | Purpose                                                          |
| --------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- |
| [Publication Release Gates Runbook](METIS_PUBLICATION_RELEASE_GATES_RUNBOOK.md)                           | Operator workflow for publication blockers and release decisions |
| [Operator Training and Launch Criteria](METIS_OPERATOR_TRAINING_AND_LAUNCH_CRITERIA.md)                   | Required operator training and launch-readiness criteria         |
| [Knowledge Graph and Retrieval Algorithm Status](METIS_KNOWLEDGE_GRAPH_AND_RETRIEVAL_ALGORITHM_STATUS.md) | Canonical production and benchmark retrieval paths               |
| [Dependency Upgrade Roadmap](dependency-upgrade-roadmap.md)                                               | Minerva-to-Metis dependency mapping and migration priorities     |
| [Multi-Region Deployment](multi-region-deployment.md)                                                     | Deployment topology and disaster-recovery posture                |
| [Test Coverage Baseline](test-coverage-baseline.md)                                                       | Test coverage comparison between Minerva and Metis               |

## Implementation Areas

- `services/metis/` contains the service implementation and OpenAPI export
  tooling.
- `docs/domains/metis/extras/` contains codebase analysis and endpoint
  documentation.
- Root scripts `metis:contracts:generate` and `metis:contracts:check` keep
  OpenAPI and generated contract artifacts aligned.

## Verification

Run the Metis contract gate before changing public API behavior:

```bash
pnpm metis:contracts:check
```

Run targeted service tests from the Metis service directory when changing
course, tutoring, assessment, publication, retrieval, or rights workflows.