Skip to content

Commit 8e5f81d

Browse files
hext-devclaude
andcommitted
docs: update branch strategy - main is now the dev branch
All development now happens on main. The hext/gcp-lifecycle-reporting feature branch has been merged and is no longer used separately. Also updated version references to hext-dev-v0.1.4. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
1 parent b22cd84 commit 8e5f81d

1 file changed

Lines changed: 10 additions & 16 deletions

File tree

docs/hext-dev-notes.md

Lines changed: 10 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -6,29 +6,28 @@ This document tracks custom modifications in the hext-dev/envbuilder fork.
66

77
| Branch | Purpose | Image Tag |
88
|--------|---------|-----------|
9-
| `main` | Stable, synced with upstream | `ghcr.io/hext-dev/envbuilder:latest` |
10-
| `hext/gcp-lifecycle-reporting` | GCP instance identity auth + lifecycle reporting | `ghcr.io/hext-dev/envbuilder:hext-dev-*` |
9+
| `main` | All hext-dev features (GCP auth, lifecycle reporting, container persistence) | `ghcr.io/hext-dev/envbuilder:hext-dev-*` |
10+
11+
The `main` branch contains all custom hext-dev features. We no longer track upstream on main - sync manually when needed.
1112

1213
## Tag Namespace
1314

1415
- **Upstream tags:** `v1.x.x` (from coder/envbuilder)
1516
- **Hext dev tags:** `hext-dev-v0.x.x` (our custom features)
1617

17-
**Current dev version:** `hext-dev-v0.1.3` (GCP instance identity auth + lifecycle reporting + container persistence)
18+
**Current dev version:** `hext-dev-v0.1.4` (GCP instance identity auth + lifecycle reporting + container persistence + unexpanded ARG handling)
1819

1920
This separation allows easy rollback:
2021
```terraform
2122
# Use stable version
2223
devcontainer_builder_image = "ghcr.io/hext-dev/envbuilder:latest"
2324
2425
# Use dev version with all hext-dev features
25-
devcontainer_builder_image = "ghcr.io/hext-dev/envbuilder:hext-dev-v0.1.3"
26+
devcontainer_builder_image = "ghcr.io/hext-dev/envbuilder:hext-dev-v0.1.4"
2627
```
2728

2829
## Feature: GCP Instance Identity Auth + Lifecycle Reporting
2930

30-
**Branch:** `hext/gcp-lifecycle-reporting`
31-
3231
**Problem:** When envbuilder fails to build a devcontainer, the Coder workspace hangs forever because:
3332
1. The Coder agent runs inside the container (never starts if build fails)
3433
2. We can't use `CODER_AGENT_TOKEN` due to caching/agent association issues
@@ -57,7 +56,7 @@ devcontainer_builder_image = "ghcr.io/hext-dev/envbuilder:hext-dev-v0.1.3"
5756

5857
```bash
5958
# Template uses new image
60-
devcontainer_builder_image = "ghcr.io/hext-dev/envbuilder:hext-dev-v0.1.3"
59+
devcontainer_builder_image = "ghcr.io/hext-dev/envbuilder:hext-dev-v0.1.4"
6160

6261
# Pass new env vars
6362
"ENVBUILDER_CODER_AUTH_METHOD": "gcp-instance-identity",
@@ -67,8 +66,7 @@ devcontainer_builder_image = "ghcr.io/hext-dev/envbuilder:hext-dev-v0.1.3"
6766

6867
## Feature: Container Persistence (ENVBUILDER_ENV_FILE)
6968

70-
**Branch:** `hext/gcp-lifecycle-reporting`
71-
**Version:** `hext-dev-v0.1.3`
69+
**Version:** `hext-dev-v0.1.3+`
7270

7371
**Problem:** By default, Coder workspaces use `docker run --rm`, destroying the container on stop. This loses:
7472
- Installed packages (`apt install`, `pip install`)
@@ -120,16 +118,12 @@ See [container-persistence.md](container-persistence.md) for full design details
120118

121119
```bash
122120
git fetch upstream
123-
git checkout main
124-
git merge upstream/main
121+
git merge upstream/main # Merge upstream changes into main
125122
git push origin main
126-
127-
# Rebase feature branch
128-
git checkout hext/gcp-lifecycle-reporting
129-
git rebase main
130-
git push --force-with-lease origin hext/gcp-lifecycle-reporting
131123
```
132124

125+
Note: We no longer maintain a separate feature branch. All development happens on `main`.
126+
133127
## Critical Gotchas
134128

135129
### Use Annotated Tags for Releases

0 commit comments

Comments
 (0)