Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
32 changes: 32 additions & 0 deletions .github/workflows/release.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,32 @@
# Publishes a release for a version tag: the level-1 checks and the release binaries run inside
# the devcontainer image, as in ci.yml, so a release is built with the pinned tool versions.
# Only this workflow may write to the repository's contents, and only to create the release.
name: release

on:
push:
tags: ["v[0-9]+.[0-9]+.[0-9]+"]

permissions:
contents: read

jobs:
release:
runs-on: ubuntu-24.04-arm
timeout-minutes: 30
permissions:
contents: write
steps:
- uses: actions/checkout@v7
- name: just test and just dist (in the devcontainer)
uses: devcontainers/ci@v0.3
with:
push: never
runCmd: |
just test
just dist "${{ github.ref_name }}"
# gh comes with the runner. A failed check above stops the job, so nothing is published.
- name: Publish the release
env:
GH_TOKEN: ${{ github.token }}
run: gh release create "${{ github.ref_name }}" dist/* --verify-tag --generate-notes --title "${{ github.ref_name }}"
21 changes: 13 additions & 8 deletions CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,13 +18,16 @@ Phase 0 approved (2026-10-28). Phase 1 (v0.1) and Phase 2 (v0.2) approved and ar
(2026-10-28, `openspec/changes/archive/2026-10-28-phase-1-stacks-and-routing` and
`…-phase-2-overview-and-budget`). Phase 3 (v0.3) approved and archived (2026-10-29,
`…/2026-10-29-phase-3-snapshots-and-queue`). Phase 4 (v0.4) approved and archived (2026-10-29,
`…/2026-10-29-phase-4-idle-and-wake`); its spike dropped Sablier (see its design.md). siding
today: `setup [--port] [--budget] [--builds] [--idle]`, `teardown [--snapshots]`, `up [--wait]
[--force] [--seed]`, `status [--wait]`, `ps`, `logs`, `open`, `down [--volumes]`,
`snapshot save|ls|rm`, `gc`, `lint`, `ui`, `skill`; routing by host and path through
`siding-proxy`; a memory budget with a start queue and learned peaks, where idle stacks make
room (the verdict `Stopped`); build slots; `just smoke-stacks`, `just build-darwin`. Next:
Phase 5 (`phase-5-remote-host`, v0.5), starting with `/opsx:propose`.
`…/2026-10-29-phase-4-idle-and-wake`); its spike dropped Sablier (see its design.md). Phase 5
(v0.5) approved and archived (2026-10-29, `…/2026-10-29-phase-5-onboarding`); its release
`v0.5.0` is tagged from `main` once phases 3 to 5 are merged. siding today: `setup [--port]
[--budget] [--builds] [--idle]`, `teardown [--snapshots]`, `up [--wait] [--force] [--seed]`,
`status [--wait]`, `ps`, `logs`, `open`, `down [--volumes]`, `snapshot save|ls|rm`, `gc`,
`lint`, `ui`, `skill [--install] [--dir]`; routing by host and path through `siding-proxy`; a
memory budget with a start queue and learned peaks, where idle stacks make room (the verdict
`Stopped`); build slots; `EnvFileMissing` for env files of the main worktree; the snapshot
`default`; `just smoke-stacks`, `just build-darwin`, `just dist` and releases on `v*` tags.
Next: Phase 6 (`phase-6-remote-host`, v0.6), starting with `/opsx:propose`.

## Working agreements

Expand Down Expand Up @@ -92,6 +95,7 @@ requests and on `main`, all inside the devcontainer image.
| `just test` | devcontainer | level-1 checks, as in CI: gofmt, vet, `go test -race`, golangci-lint, `openspec validate --all --strict` |
| `just golden` | devcontainer | rewrite golden files after an intended change |
| `just build` | devcontainer | build a static `bin/siding` (linux) |
| `just dist <version>` | devcontainer | build the release binaries (macOS and Linux, arm64 and amd64) and `SHA256SUMS` into `dist/`; CI does it on `v*` tags and publishes a GitHub Release |
| `just build-darwin` | devcontainer | build `bin/siding-darwin-arm64` and `-amd64`, to try siding on the Mac against Docker Desktop (product use, not development) |
| `just smoke-docker` | devcontainer | inner daemon: compose project with two services and healthchecks, `ports: !reset []`, Traefik on `siding` routing `demo.main.localhost` at `/` and `/api` |
| `just smoke-stacks` | devcontainer | inner daemon: siding's own commands end to end (`internal/e2e`, build tag `docker`): setup, `up --wait`, routing, a Failed verdict with log tail, `ps`, `down`, the guard of `down --volumes`; also checks golden overrides with `docker compose config` |
Expand Down Expand Up @@ -140,7 +144,8 @@ requests and on `main`, all inside the devcontainer image.
(`volume|script|none`), `dev.siding.seed.command` (the seed command of `script`). Volume
label `dev.siding.shared`. Snapshot volumes: `dev.siding.snapshot` (name),
`dev.siding.snapshot-volume` (the stack's volume key), `dev.siding.snapshot-created`, plus
`dev.siding.repo` and `dev.siding.machine`. On `siding-proxy`: `dev.siding.budget` (the memory
`dev.siding.repo` and `dev.siding.machine`. The snapshot named `default` seeds a stack's
first `up` without `--seed`; `none` is not a snapshot name (`--seed none` starts empty). On `siding-proxy`: `dev.siding.budget` (the memory
budget in bytes), `dev.siding.builds` (build slots), `dev.siding.idle` (the idle threshold in seconds, `0`
for off) and `dev.siding.host-alias` (what `host.docker.internal` resolves to in the proxy).
- Compose project `<repo>-<branch-slug>`, host `<repo>.<branch-slug>.localhost`, proxy
Expand Down
Loading
Loading