Governance

Contributing

Contributing to Loop Engine

Before you build anything

Open an issue before significant work. This avoids duplicated implementation and ensures roadmap alignment.

DCO sign-off

All commits must be signed off.

1git commit -s -m "feat: add ..."

This appends the required Signed-off-by: Your Name <email> trailer.

What belongs in this repo

Allowed:

• domain-neutral primitives (packages/core)
• reusable loop definitions (loops/)
• adapters and examples with cross-domain utility

Not accepted:

• SCM-specific business logic
• proprietary optimization algorithms
• Better Data tenant/billing internals

Governance model

Repository currently documents a BDFL model:

• Better Data, Inc. controls final roadmap and release decisions
• community contributions are welcomed

Branch and PR conventions

• open issue first for significant work
• pass CI checks before review
• breaking changes to core types require RFC issue ([RFC])

Versioning with changesets

1pnpm changeset

Event schema breaking changes require a 6-month deprecation notice.

Local development

1pnpm install
2pnpm build
3pnpm test

Run package-specific tests:

1pnpm --filter @loop-engine/core test
2pnpm --filter @loop-engine/runtime test