Eve library

phase-4.md

Tracker

Revision 1

On this page

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