alvis/oO

Files

alvis bad1bb2cba feat(simulate): MLflow tracking, Airflow DAG integration, health checks for mlflow/airflow

- sim_runs schema: add judge_mode, n_policies, airflow_dag_run_id, mlflow_run_id columns
- admin health endpoint: add mlflow + airflow checks (Basic auth for Airflow API)
- admin nav: add Simulations page link; rename section label
- runner.py: optional MLflow experiment tracking; multi-policy support
- sim_dag.py: Airflow DAG for offline sim pipeline
- admin simulate page + API client methods for sim runs
- shared-types tsconfig: exclude test files from build

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

2026-04-26 12:08:36 +00:00

events

feat(schema): protobuf event registry + buf CI gate (#54 )

2026-04-25 16:48:24 +00:00

src

feat(schema): protobuf event registry + buf CI gate (#54 )

2026-04-25 16:48:24 +00:00

.gitkeep

chore: scaffold oO monorepo with architecture, roadmap, and module stubs

2026-04-13 14:19:56 +00:00

package.json

feat(schema): protobuf event registry + buf CI gate (#54 )

2026-04-25 16:48:24 +00:00

README.md

docs(schema): update docs for #54 — proto registry + buf CI gate

2026-04-25 16:53:20 +00:00

tsconfig.json

feat(simulate): MLflow tracking, Airflow DAG integration, health checks for mlflow/airflow

2026-04-26 12:08:36 +00:00

vitest.config.ts

feat: ε-greedy v1 as active policy; dwell-time reward inference; offline sim framework

2026-04-16 07:44:37 +00:00

README.md

@oo/shared-types

Canonical contracts for all inter-module communication. Two surfaces:

Surface	Format	Location
HTTP (sync)	OpenAPI / TypeScript interfaces	`src/http/`
Events (async)	Protocol Buffers + TS interfaces	`src/events/`, `events/`

HTTP types

Hand-written TypeScript interfaces generated from OpenAPI specs. Imported by services/api, apps/web, and ml/serving (Python hand-mirrors).

File	Types
`src/http/tip.ts`	`TipCandidate`, `RecommendResponse`, `TipFeedback`
`src/http/auth.ts`	`SessionUser`
`src/http/integrations.ts`	`IntegrationsResponse`, `Integration`
`src/http/user.ts`	`UserProfile`
`src/http/signal.ts`	`Signal`, `SignalSource`

Event types

Protobuf schemas live in events/oo/events/v1/. TypeScript interfaces in src/events/index.ts mirror the proto envelope and payload types.

Proto file	Messages
`envelope.proto`	`Envelope` (wraps every event)
`signals.proto`	`TaskSyncedPayload`, `TipServedPayload`, `TipFeedbackPayload`, `TipRewardFailedPayload`
`integration.proto`	`IntegrationTokenExpiredPayload`

Schema evolution rules (ADR-0005):

Additive changes only within a version (new fields, new message types).
Removed fields must be marked reserved — never reuse a field number.
Breaking changes require a new package version (oo.events.v2) and a schemaVersion bump in the envelope.

Schema registry / CI gate

buf enforces lint and breaking-change detection on every PR that touches events/:

# Lint
buf lint events/

# Breaking-change check against main
buf breaking events/ --against '.git#branch=main,subdir=packages/shared-types/events'

Local shortcut: ./scripts/buf-check.sh

CI: .gitea/workflows/buf-check.yaml (requires a Gitea Actions runner).

Install buf: curl -sSfL https://github.com/bufbuild/buf/releases/latest/download/buf-Linux-x86_64 -o /usr/local/bin/buf && chmod +x /usr/local/bin/buf

Contract

/health — not applicable (library package, no process).

Extraction criteria — always a shared library. Extract to a separate registry service only when schema governance requires independent versioning and deployment (e.g. external consumers, SLA divergence from the monorepo).