Skip to content

docs: add CLA infrastructure and modernize GitHub templates#1521

Merged
braden-w merged 8 commits intomainfrom
opencode/clever-planet
Mar 14, 2026
Merged

docs: add CLA infrastructure and modernize GitHub templates#1521
braden-w merged 8 commits intomainfrom
opencode/clever-planet

Conversation

@braden-w
Copy link
Member

@braden-w braden-w commented Mar 13, 2026

Adds CLA infrastructure—Apache ICLA-style license grant, GitHub Action enforcement, CODEOWNERS gating for commercially relevant paths—and updates GitHub templates to reflect the Epicenter rebrand.

FINANCIAL_SUSTAINABILITY.md lays out how we hope to become financially sustainable: AGPL stays, we sell commercial licenses to enterprises that can't accept it. Grafana, Bitwarden, MinIO, AppFlowy, and Logseq all use this same model, and every one of them requires a CLA.

CLA infrastructure

.github/workflows/ci.cla.yml    ← GitHub Action via contributor-assistant/github-action@v2
CLA.md                           ← Apache ICLA adapted for Epicenter (license grant, NOT copyright assignment)
signatures/cla.json              ← Created automatically on first signature
.github/CODEOWNERS               ← Gates apps/api/, packages/sync/, packages/sync-client/ for @braden-w review

The CLA bot comments on first-time PRs with signing instructions. Contributors reply with the signing phrase and they're set—takes about ten seconds. Bots (dependabot, renovate, github-actions) are allowlisted.

Template updates

The GitHub templates were still referencing "Whispering" in places and missing ecosystem-wide components. This PR:

  • Renames "Whispering Version" → "Epicenter Version" in bug reports
  • Adds Sync, CLI, Workspace, and Landing Page to the affected component dropdown
  • Removes the redundant "Type of Change" checkbox section from the PR template (the commit prefix already communicates this)
  • Adds a CODEOWNERS reminder to the PR checklist
  • Mentions CLA in the feature request's "Willing to Contribute?" dropdown
  • Adds issue template config with blank issue option and Discord/Contributing links

Documentation updates

CONTRIBUTING.md gets a new "Licensing and CLA" section explaining the requirement. FINANCIAL_SUSTAINABILITY.md is updated to reflect that the CLA is now in place (previously it said "we don't need one yet") and acknowledges that all listed comps use CLAs. A new section clarifies AGPL-compatible license options for downstream developers.

Lays groundwork for #792

Add Apache ICLA-style CLA (license grant, not copyright assignment),
GitHub Action enforcement via contributor-assistant/github-action@v2,
and CODEOWNERS gating for commercially relevant sync server paths.

- CLA.md: 7-section Apache ICLA adapted for EpicenterHQ
- ci.cla.yml: enforces CLA signing on PRs, allowlists bots
- CODEOWNERS: gates apps/api/, packages/sync/, packages/sync-client/
- CONTRIBUTING.md: added Licensing and CLA section
- HOW_TO_MONETIZE.md: updated to reflect CLA is now in place
- Workflow README: documented ci.cla.yml in CI table
Add Sync, CLI, Workspace, and Landing Page to the Affected Component
dropdown. Existing Whispering-centric options kept since they're still
the primary bug surface.
…plate

Conventional commit prefixes in the PR title already encode the change
type. The checkboxes added friction without new signal.
Contributors touching the sync server or API paths now get a heads-up
that those directories require explicit owner review.
… link

Contributors can now open blank issues or jump straight to Discord from
the template chooser.
@braden-w braden-w merged commit 57cb330 into main Mar 14, 2026
1 of 8 checks passed
@braden-w braden-w deleted the opencode/clever-planet branch March 14, 2026 09:14
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant