Skip to content

🧹 chore(ci): establish dev integration governance - #467

Merged
seakee merged 2 commits into
devfrom
chore/dev-branch-governance
Aug 1, 2026
Merged

🧹 chore(ci): establish dev integration governance#467
seakee merged 2 commits into
devfrom
chore/dev-branch-governance

Conversation

@seakee

@seakee seakee commented Aug 1, 2026

Copy link
Copy Markdown
Owner

Summary

Establish the protected dev → main integration path while keeping main as the stable default branch. Community and maintenance work now has a documented PR target and main gains a source-identity gate.

Scope

  • Frontend panel
  • Manager Server
  • CPA panel mode
  • Full Docker mode
  • Native packages / release
  • Docs / Wiki
  • CI / build / tooling

Changes

  • Run existing PR validation and PR-template checks for pull requests and pushes involving dev.
  • Add a main promotion workflow that accepts only seakee/CPA-Manager-Plus:dev as the PR source.
  • Add CONTRIBUTING.md and PR-template guidance for the community dev integration path.

User Impact

Contributors submit changes to dev instead of directly to the stable main branch. Users continue to clone and browse the stable default branch.

Compatibility / Runtime Notes

  • CPA panel mode: N/A.
  • Manager Server mode: N/A.
  • Full Docker / native packages: N/A.

Data / Security Notes

No runtime configuration, credentials, database data, or request data changes. The promotion workflow uses read-only GitHub Actions permissions and verifies both the source repository and branch.

Risk / Rollback

Risk level: Low

Rollback notes:

Revert this PR and remove the corresponding branch-protection rules if the integration policy must be withdrawn.

Verification

  • Type check
  • Lint
  • Tests
  • Build
  • Manual UI check
  • Docs/link check
  • Not applicable, docs-only

Commands / evidence:

ruby -e 'require "yaml"; ...' .github/workflows/pr-check.yml .github/workflows/pr-template.yml .github/workflows/main-promotion.yml
npm run test  # 133 files, 1361 tests passed
git diff --check

Screenshots / Recordings

N/A — CI and contributor documentation only.

Docs

  • README / README_CN updated for user-visible capabilities
  • Matching docs manual and navigation updated
  • Demo fixtures, screenshots, and deep links reviewed
  • Release notes needed
  • Not needed — added CONTRIBUTING.md is the canonical contribution guide; product documentation and release notes are unaffected.

Docs decision:

The change documents repository governance rather than a user-facing product capability.

Related

N/A

seakee added 2 commits August 1, 2026 10:15
Run PR validation for the dev integration branch and retain it for main promotions.\nRequire main pull requests to originate from this repository's dev branch.\nThis prevents direct community or maintenance merges into the stable branch.
Document the contributor path from upstream dev through review and verification.\nExplain the protected dev-to-main promotion model and release-tag boundary.\nThis gives community contributors an actionable target without changing the stable default branch.
@seakee
seakee merged commit 5fd9096 into dev Aug 1, 2026
9 checks passed
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