Skip to content

Commit 04dfb4e

Browse files
committed
docs(fork): update release branch guidance
1 parent f6c9a52 commit 04dfb4e

2 files changed

Lines changed: 7 additions & 7 deletions

File tree

AGENTS.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ Completion/build step
1313
- Policy: All errors AND all warnings must be fixed before you’re done. Treat any compiler warning as a failure and address it (rename unused vars with `_`, remove `mut`, delete dead code, etc.).
1414
- Do not run additional format/lint/test commands on completion (e.g., `just fmt`, `just fix`, `cargo test`) unless explicitly requested for a specific task.
1515
- ***NEVER run rustfmt***
16-
- Before pushing to `main`, run `./pre-release.sh` to mirror the release preflight (dev-fast build, CLI smokes, workspace nextest).
16+
- Before pushing to `webui-main`, run `./pre-release.sh` to mirror the release preflight (dev-fast build, CLI smokes, workspace nextest).
1717

1818
Optional regression checks (recommended when touching the Rust workspace):
1919

@@ -65,7 +65,7 @@ See `FORK.md` for fork branch + release policy.
6565
When the user asks you to "push" local work:
6666

6767
- Never rebase in this flow. Do not use `git pull --rebase` or attempt to replay local commits.
68-
- Prefer a simple merge of `origin/main` into the current branch, keeping our local history intact.
68+
- Prefer a simple merge of `origin/webui-main` into the current branch, keeping our local history intact.
6969
- If the remote only has trivial release metadata changes (e.g., `codex-cli/package.json` version bumps), adopt the remote version for those files and keep ours for everything else unless the user specifies otherwise.
7070
- If in doubt or if conflicts touch non-trivial areas, pause and ask before resolving.
7171

@@ -75,7 +75,7 @@ Quick procedure (merge-only):
7575
- Review: `git --no-pager diff --stat` and `git --no-pager diff`
7676
- Stage + commit: `git add -A && git commit -m "<descriptive message of local changes>"`
7777
- Fetch remote: `git fetch origin`
78-
- Merge without auto-commit: `git merge --no-ff --no-commit origin/main` (stops before committing so you can choose sides)
78+
- Merge without auto-commit: `git merge --no-ff --no-commit origin/webui-main` (stops before committing so you can choose sides)
7979
- Resolve policy:
8080
- Default to ours: `git checkout --ours .`
8181
- Take remote for trivial package/version files as needed, e.g.: `git checkout --theirs codex-cli/package.json`
@@ -139,7 +139,7 @@ This architecture separates concerns between execution logic (core), UI state ma
139139
### Monitor Release Workflows After Pushing
140140

141141
- Use `scripts/wait-for-gh-run.sh` to follow GitHub Actions releases without spamming manual `gh` commands.
142-
- Typical release check right after a push: `scripts/wait-for-gh-run.sh --workflow Release --branch main`.
142+
- Typical release check right after a push: `scripts/wait-for-gh-run.sh --workflow Release --branch webui-main`.
143143
- If you already know the run ID (e.g., from webhook output), run `scripts/wait-for-gh-run.sh --run <run-id>`.
144144
- Adjust the poll cadence via `--interval <seconds>` (defaults to 8). The script exits 0 on success and 1 on failure, so it can gate local automation.
145145
- Pass `--failure-logs` to automatically dump logs for any job that does not finish successfully.

FORK.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -11,9 +11,9 @@ This repository tracks upstream closely, but we carry a long-running fork branch
1111

1212
## Releases (fork)
1313

14-
- Workflow: `Release (Fork)` (`.github/workflows/release-fork.yml`).
15-
- Trigger: push a tag matching `v*`.
16-
- Tags must point at the desired `webui-main` commit (not at `main`).
14+
- Workflow: `Release` (`.github/workflows/release.yml`).
15+
- Trigger: push to `webui-main`.
16+
- Do not release from `main` (mirror only).
1717

1818
### Version scheme
1919

0 commit comments

Comments
 (0)