/domain/manuscript/
├── .msx/                     # Proto source definitions (SOURCE OF TRUTH)
│   ├── Makefile              # Multi-language compilation pipeline
│   ├── shared/v1.proto       # Shared metadata & custom options
│   └── domains/
│       ├── envelope/v1.proto    # Universal event envelope
│       ├── user/v1.proto        # User domain events (12 types)
│       ├── document/v1.proto    # Document lifecycle
│       ├── collaboration/v1.proto # Real-time editing
│       ├── workspace/v1.proto   # Team management
│       ├── aria/v1.proto        # AI safety gates
│       ├── notification/v1.proto # Notifications & webhooks
│       └── audit/v1.proto       # Compliance & audit trails
│
├── proto/                    # Go module (github.com/materi/domain/proto)
│   ├── go.mod
│   ├── wrapper.go            # Re-exports for clean imports
│   └── materi/v1/            # Generated .pb.go files
│
├── ts/                       # TypeScript package (@materi/proto)
│   ├── package.json
│   ├── src/index.ts          # Re-exports for clean imports
│   └── generated/            # Generated .ts files
│
├── py/                       # Python package (materi-proto)
│   ├── pyproject.toml
│   ├── src/materi_proto/     # Generated *_pb2.py files
│   └── tests/
│
├── cmd/
│   └── msx-inspector/        # Interactive schema explorer (Bubble Tea TUI)
│
├── scripts/
│   └── sync-version.sh       # Version synchronization across packages
│
└── .github/workflows/        # CI/CD for all languages
    ├── proto.yml             # Validation & drift detection
    ├── publish-npm.yml       # npm publishing
    └── publish-pypi.yml      # PyPI publishing

go get github.com/materi/domain/proto

import (
    "github.com/materi/domain/proto"
    envelope "github.com/materi/domain/proto/materi/v1/envelope"
    user "github.com/materi/domain/proto/materi/v1/user"
)

// Create an event
event := &user.UserCreatedEvent{
    UserId: "user-123",
    Email:  "alice@example.com",
    Name:   "Alice",
}

npm install @materi/proto
# or
yarn add @materi/proto

import { UserCreatedEvent, DomainEvent, Status } from '@materi/proto';

const event: UserCreatedEvent = {
    userId: 'user-123',
    email: 'alice@example.com',
    name: 'Alice',
    createdAt: new Date(),
};

// Serialize to bytes
const bytes = UserCreatedEvent.encode(event).finish();

pip install materi-proto

from materi_proto import UserCreatedEvent, DomainEvent, Status

event = UserCreatedEvent(
    user_id="user-123",
    email="alice@example.com",
    name="Alice",
)

# Serialize to bytes
data = event.SerializeToString()

cd /domain/manuscript

# Install Go dependencies
go mod download

# Install TypeScript dependencies
cd ts && npm install && cd ..

# Install Python dependencies
cd py && python3 -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]" && cd ..

# Compile all languages
make compile-all

# Build MSX Inspector TUI
go build -o msx-inspector ./cmd/msx-inspector

./msx-inspector

package main

import (
    "github.com/materi/msx/internal/schema"
)

func main() {
    // Create a schema registry
    registry := schema.NewSchemaRegistry()

    // Get all events
    events := registry.GetAllEvents()

    // Find events by domain
    userEvents := registry.GetEventsByDomain("user")

    // Find events consumed by a specific service
    apiEvents := registry.GetEventsByConsumer("API")

    // Get schema statistics
    stats := registry.GetStats()
    println("Total events:", stats.TotalEvents)
    println("Auditable rate:", stats.AuditableRate * 100, "%")
    println("Replayable rate:", stats.ReplayableRate * 100, "%")
}

message UserCreatedEvent {
  string event_id = 1;
  string user_id = 2;
  string email = 3;

  // Custom metadata option
  option (materi.EventMetadata).consumers = "API,Shield,Aria";
  option (materi.EventMetadata).stream = "materi:events:user";
  option (materi.EventMetadata).retention_days = 90;
  option (materi.EventMetadata).is_auditable = true;
  option (materi.EventMetadata).ordering = "causally_ordered";
}

# Compile Go, TypeScript, and Python
make compile-all

# Or from .msx directory
cd .msx && make compile-all

# Go only
make compile-protos

# TypeScript only
make compile-ts

# Python only
make compile-py

# Build TypeScript package (ESM + CJS + types)
make build-ts

# Build Python package (wheel + sdist)
make build-py

# Sync version across all packages
./scripts/sync-version.sh 0.2.0

# Watch for proto changes and recompile
make watch

# Run all tests
go test ./...

# Run with coverage
go test -cover ./...

# Run proto module tests
cd proto && go test ./...

cd ts

# Type check
npm run typecheck

# Build and verify
npm run build

cd py

# Activate venv
source .venv/bin/activate

# Run tests
PYTHONPATH=src pytest tests/ -v

# Type check (optional)
mypy src/materi_proto

type DomainEvent struct {
    EventId        string
    AggregateId    string
    AggregateType  string
    EventType      string
    Data           []byte
    Timestamp      int64

    // Tracing fields
    TraceId        string  // W3C trace context
    SpanId         string  // Current span
    ParentSpanId   string  // Parent span
    CorrelationId  string  // Causality tracking
}

FROM golang:1.22-alpine

WORKDIR /app
COPY . .
RUN go mod download
RUN go build -o msx-inspector ./cmd/msx-inspector

ENTRYPOINT ["./msx-inspector"]

apiVersion: apps/v1
kind: Deployment
metadata:
    name: msx-inspector
spec:
    replicas: 1
    template:
        spec:
            containers:
                - name: inspector
                  image: materi/msx-inspector:latest
                  ports:
                      - containerPort: 8080

# Publish to npm (requires NPM_TOKEN secret)
gh workflow run publish-npm.yml -f version=0.2.0 -f tag=latest

# Publish to PyPI (uses trusted publishing)
gh workflow run publish-pypi.yml -f version=0.2.0 -f repository=pypi

# Sync version across Go, TypeScript, and Python
./scripts/sync-version.sh 0.2.0

# Commit and tag
git commit -am "chore: bump version to 0.2.0"
git tag v0.2.0
git push && git push --tags