code-foundry 0.36.2 → 0.37.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.github/CONTRIBUTING.md +14 -14
- package/AGENTS.md +6 -0
- package/CHANGELOG.md +14 -0
- package/package.json +1 -1
- package/src/commands/sync.mjs +8 -4
package/.github/CONTRIBUTING.md
CHANGED
|
@@ -153,15 +153,15 @@ Keep pull requests focused and reviewable. Include screenshots or recordings for
|
|
|
153
153
|
|
|
154
154
|
## Workflow and check behavior
|
|
155
155
|
|
|
156
|
-
| Event
|
|
157
|
-
|
|
|
158
|
-
| Pull request targeting `staging`
|
|
159
|
-
| Ordinary pull request targeting `main`
|
|
160
|
-
| Exact Release Please pull request targeting `main` | Release-policy validation only, ending in `Validation / Gate`
|
|
161
|
-
| Scheduled or manual validation
|
|
162
|
-
| Push to a working branch
|
|
163
|
-
| Push to `staging`
|
|
164
|
-
| Push to `main`
|
|
156
|
+
| Event | Expected automation |
|
|
157
|
+
| -------------------------------------------------- | ------------------------------------------------------------------------------------- |
|
|
158
|
+
| Pull request targeting `staging` | Fast validation: CI plus unit tests, ending in `Validation / Gate` |
|
|
159
|
+
| Ordinary pull request targeting `main` | Audit validation: CI, full tests, Security, and CodeQL, ending in `Validation / Gate` |
|
|
160
|
+
| Exact Release Please pull request targeting `main` | Release-policy validation only, ending in `Validation / Gate` |
|
|
161
|
+
| Scheduled or manual validation | Full audit tier |
|
|
162
|
+
| Push to a working branch | Draft PR workflow |
|
|
163
|
+
| Push to `staging` | Promotion PR workflow; canonical validation waits for the PR event |
|
|
164
|
+
| Push to `main` | Release workflow; canonical validation already ran on the merged PR |
|
|
165
165
|
|
|
166
166
|
The single validation caller keys concurrency by event and pull-request head. A newer update to the same pull request cancels its superseded validation run; scheduled and manual audits remain independent. The mode-aware orchestrator fans out only the jobs required by that event and always concludes with the stable aggregate gate.
|
|
167
167
|
|
|
@@ -175,11 +175,11 @@ Security checks can be skipped when repository visibility or the GitHub plan doe
|
|
|
175
175
|
|
|
176
176
|
## Review and merge protocol
|
|
177
177
|
|
|
178
|
-
| Change
|
|
179
|
-
|
|
|
180
|
-
| Working branch
|
|
181
|
-
| `staging` → `main` promotion | `main`
|
|
182
|
-
| Release Please version PR
|
|
178
|
+
| Change | Target | Merge method | Merge gate |
|
|
179
|
+
| ---------------------------- | --------- | ----------------------------------------------- | --------------------------------------------------------- |
|
|
180
|
+
| Working branch | `staging` | Squash | All applicable required checks pass |
|
|
181
|
+
| `staging` → `main` promotion | `main` | Rebase (`merge_strategy`) | Current staging checks, release review, and rollout notes |
|
|
182
|
+
| Release Please version PR | `main` | Rebase (`release_merge_strategy`, fails closed) | Validation gate and release policy pass |
|
|
183
183
|
|
|
184
184
|
Reviewers focus on correctness, security, maintainability, test coverage, operational impact, and compatibility. Authors remain responsible for responding to feedback and verifying the final commit.
|
|
185
185
|
|
package/AGENTS.md
CHANGED
|
@@ -71,6 +71,12 @@ Ask for clarification when a missing decision would materially change the implem
|
|
|
71
71
|
|
|
72
72
|
For normal feature work, branch from `staging` and target pull requests at `staging`. Treat `main` as the protected release branch. Follow `.github/CONTRIBUTING.md` for the complete internal and external contribution flow.
|
|
73
73
|
|
|
74
|
+
## Git workflow and merging
|
|
75
|
+
|
|
76
|
+
This repository uses the `staging-release` workflow: topic branches **squash** into `staging`, a promotion PR **rebases** validated changes into `main` (`merge_strategy: rebase`), and the Release Please version PR **rebases** into `main` (`release_merge_strategy: rebase`). Feature PRs land on `staging` with squash merges; promotion and release PRs land on `main` with rebase merges. Re-align `staging` with `main` after a release when needed.
|
|
77
|
+
|
|
78
|
+
Merge only with the repository's canonical method. Never merge with `--admin`, never default or auto-select a merge method, and never use a method the branch ruleset does not allow. When in doubt, prefer the merge button's configured method and verify the ruleset after merging. Check `.github/CONTRIBUTING.md` for the complete flow and merge table.
|
|
79
|
+
|
|
74
80
|
## Toolchain and dependencies
|
|
75
81
|
|
|
76
82
|
- Follow `toolchain: auto` in `.github/code-foundry.yml`; use native tools by
|
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,19 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## [0.37.1](https://github.com/0xPlayerOne/code-foundry/compare/v0.37.0...v0.37.1) (2026-08-08)
|
|
4
|
+
|
|
5
|
+
|
|
6
|
+
### Bug Fixes
|
|
7
|
+
|
|
8
|
+
* **sync:** prettier-canonical CONTRIBUTING.md tables for both topologies ([af9137b](https://github.com/0xPlayerOne/code-foundry/commit/af9137bc788853ed97c4c17aef9848b7f9d15fbf))
|
|
9
|
+
|
|
10
|
+
## [0.37.0](https://github.com/0xPlayerOne/code-foundry/compare/v0.36.2...v0.37.0) (2026-08-07)
|
|
11
|
+
|
|
12
|
+
|
|
13
|
+
### Features
|
|
14
|
+
|
|
15
|
+
* **agents:** add explicit merge-workflow guidance ([a74c0ce](https://github.com/0xPlayerOne/code-foundry/commit/a74c0ce61c8dc53795a645ab5f2062ded732e3a5))
|
|
16
|
+
|
|
3
17
|
## [0.36.2](https://github.com/0xPlayerOne/code-foundry/compare/v0.36.1...v0.36.2) (2026-08-07)
|
|
4
18
|
|
|
5
19
|
|
package/package.json
CHANGED
package/src/commands/sync.mjs
CHANGED
|
@@ -434,6 +434,10 @@ const DIRECT_DOC_REPLACEMENTS = {
|
|
|
434
434
|
'Use `push` for `main, staging` and `pull_request` for `staging` unless a workflow has a documented event-specific reason.',
|
|
435
435
|
'Use `push` for `main` and `pull_request` for `main` unless a workflow has a documented event-specific reason.',
|
|
436
436
|
],
|
|
437
|
+
[
|
|
438
|
+
'This repository uses the `staging-release` workflow: topic branches **squash** into `staging`, a promotion PR **rebases** validated changes into `main` (`merge_strategy: rebase`), and the Release Please version PR **rebases** into `main` (`release_merge_strategy: rebase`). Feature PRs land on `staging` with squash merges; promotion and release PRs land on `main` with rebase merges. Re-align `staging` with `main` after a release when needed.',
|
|
439
|
+
'This repository uses the `direct` workflow: topic branches **squash** directly into `main`, and the Release Please version PR **rebases** into `main` (`release_merge_strategy: rebase`). Feature PRs land on `main` with squash merges; release PRs land on `main` with rebase merges. No integration branch exists; all pull requests target `main`.',
|
|
440
|
+
],
|
|
437
441
|
],
|
|
438
442
|
'.github/CONTRIBUTING.md': [
|
|
439
443
|
[
|
|
@@ -477,12 +481,12 @@ const DIRECT_DOC_REPLACEMENTS = {
|
|
|
477
481
|
'7. Push to the fork and open a pull request targeting `main`.',
|
|
478
482
|
],
|
|
479
483
|
[
|
|
480
|
-
'| Event
|
|
481
|
-
'| Event
|
|
484
|
+
'| Event | Expected automation |\n| -------------------------------------------------- | ------------------------------------------------------------------------------------- |\n| Pull request targeting `staging` | Fast validation: CI plus unit tests, ending in `Validation / Gate` |\n| Ordinary pull request targeting `main` | Audit validation: CI, full tests, Security, and CodeQL, ending in `Validation / Gate` |\n| Exact Release Please pull request targeting `main` | Release-policy validation only, ending in `Validation / Gate` |\n| Scheduled or manual validation | Full audit tier |\n| Push to a working branch | Draft PR workflow |\n| Push to `staging` | Promotion PR workflow; canonical validation waits for the PR event |\n| Push to `main` | Release workflow; canonical validation already ran on the merged PR |\n',
|
|
485
|
+
'| Event | Expected automation |\n|------------------------------------------------------------------------------------------------------------------------------------------------|\n| Pull request targeting `main` | Audit validation: CI, full tests, Security, and CodeQL, ending in `Validation / Gate` |\n| Exact Release Please pull request targeting `main` | Release-policy validation only, ending in `Validation / Gate` |\n| Scheduled or manual validation | Full audit tier |\n| Push to a working branch | Draft PR workflow |\n| Push to `main` | Release workflow; canonical validation already ran on the merged PR |',
|
|
482
486
|
],
|
|
483
487
|
[
|
|
484
|
-
'| Change
|
|
485
|
-
'| Change
|
|
488
|
+
'| Change | Target | Merge method | Merge gate |\n| ---------------------------- | --------- | ----------------------------------------------- | --------------------------------------------------------- |\n| Working branch | `staging` | Squash | All applicable required checks pass |\n| `staging` → `main` promotion | `main` | Rebase (`merge_strategy`) | Current staging checks, release review, and rollout notes |\n| Release Please version PR | `main` | Rebase (`release_merge_strategy`, fails closed) | Validation gate and release policy pass |\n',
|
|
489
|
+
'| Change | Target | Merge method | Merge gate |\n|----------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Working branch | `main` | Squash | All applicable required checks pass |\n| Release Please version PR | `main` | Rebase (`release_merge_strategy`, fails closed) | Validation gate and release policy pass |',
|
|
486
490
|
],
|
|
487
491
|
[
|
|
488
492
|
'1. Create a focused branch from `staging`.',
|