Historical task source. The Eve task board holds current task state.
Phase 4: Contracts & Schema Layer#
4.1 @oshun/contracts-common (Shared Schemas) ✅#
- 4.1.1 Create libs/contracts/ project
- 4.1.2 Add project.json with scope:shared, layer:contracts tags
- 4.1.3 Define Asset schema with provenance and licensing fields
- 4.1.4 Define User schema (shared across domains)
- 4.1.5 Define Project schema
- 4.1.6 Define Timestamps and audit trail schemas
- 4.1.7 Export as Zod schemas (Proto integration deferred to 4.3)
- 4.1.8 TypeScript types inferred from Zod schemas
4.2 @oshun/contracts-events (Event Contracts) ✅#
- 4.2.1 Create libs/contracts/src/events/ module
- 4.2.2 Included in @oshun/contracts package
- 4.2.3 Define event envelope schema (id, type, timestamp, payload, metadata)
- 4.2.4 Define isis.asset.generated event
- 4.2.5 Define isis.job.failed event
- 4.2.6 Define isis.workflow.registered event
- 4.2.7 Define sophia.document.ingested event
- 4.2.8 Define sophia.index.updated event
- 4.2.9 Define hathor.world.published event
- 4.2.10 Define hathor.simulation.completed event
- 4.2.11 Define bellona.build.completed event
- 4.2.12 Define bellona.export.ready event
- 4.2.13 Define yemaya.project.created event
- 4.2.14 Define yemaya.asset.approved event
- 4.2.15 Event publisher interface in envelope.ts
- 4.2.16 Event consumer interface in envelope.ts
4.3 @oshun/proto (Protocol Buffer Definitions) ✅#
- 4.3.1 Create libs/proto/ project (separate library)
- 4.3.2 Add project.json with scope:shared, layer:contracts tags
- 4.3.3 Migrate yemaya/packages/proto (19 .proto files):
- common/types.proto (shared types, UUID, pagination)
- ai/ai.proto (AI service definitions)
- agent/agent.proto (agent orchestration)
- asset/asset.proto (asset management)
- auth/auth.proto (authentication)
- bridge/blender.proto (Blender bridge)
- bridge/godot.proto (Godot bridge)
- bridge/unreal.proto (Unreal bridge)
- collaboration/collaboration.proto
- generation3d/generation3d.proto
- health/health.proto
- loadbalancing/loadbalancing.proto
- pipeline/autonomous_pipeline.proto
- procedural/procedural.proto
- project/project.proto
- reflection/reflection.proto
- rendering/rendering.proto
- splatting/gaussian_splatting.proto
- user/user.proto
- 4.3.4 Create TypeScript proto loader utilities
- 4.3.5 Create service definitions with metadata
- 4.3.6 Create proto generation script (scripts/generate.ts)
- 4.3.7 Add proto files for isis services
- 4.3.8 Add proto files for sophia services
- 4.3.9 Add proto files for hathor services
- 4.3.10 Set up buf.yaml for linting
4.4 @oshun/openapi (OpenAPI Specifications) ✅#
- 4.4.1 Create libs/openapi/ project (standalone library)
- 4.4.2 Add project.json with scope:shared, layer:contracts tags
- 4.4.3 Migrate lilith/openapi/openapi.yaml as main spec (37k+ lines)
- 4.4.4 Create spec loader utilities for reading YAML specs
- 4.4.5 Create spec registry with domain metadata
- 4.4.6 Create spec merging utility for combining modular specs
- 4.4.7 Create endpoint and schema extraction utilities
- 4.4.8 Create TypeScript generation script skeleton
- 4.4.9 Create modular OpenAPI specs per domain:
- isis-api.yaml, sophia-api.yaml, hathor-api.yaml
- bellona-api.yaml, yemaya-api.yaml, lilith-api.yaml
- 4.4.10 Set up OpenAPI validation in CI