Contributing & Internal

See also: Release Process, Admin API Contract Workflow, Data Relationships, Budgets and Spending, End-to-End Contract Tests

This surface is for maintainers and contributors changing Oceans LLM itself.

Use the primary docs for admin, user, caller, and client workflows. Use this surface for release work, contract generation, schema and migration changes, implementation plans, interviews, test harnesses, and design notes that help contributors maintain the project.

Maintainer Workflows

• Release mechanics:
  • Release Process
• Database migration authoring:
  • Migration Authoring
• Local authentication fixture testing:
  • Testing Authentication Locally
• Screenshot review assets:
  • Screenshots

Contracts and Tests

• Admin OpenAPI and generated TypeScript artifacts:
  • Admin API Contract Workflow
• Browser and HTTP contract harness:
  • End-to-End Contract Tests

Data and Accounting

• Persistent schema and entity relationships:
  • Data Relationships
• Spend ledger and budget enforcement internals:
  • Budgets and Spending

Design Notes

• MCP registry implementation trail:
  • MCP Registry and Discovery
• Active implementation plans:
  • Issue 206: Top-Level Service Account Config
• Discovery interviews:
  • Request ID and Request Attempt Observability Interview
  • Budget Hierarchy and Owner Taxonomy Interview
  • MCP Gateway Auth Alignment Interview
• Specs:
  • Request ID and Request Attempt Observability Design