Loop Engine™

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