Pin ecosystem crates off floating main; bakery pulls bread
bread-theme moves to git.breadway.dev v0.7.1. bread-utils and bread-screenshots pin ecosystem origin/main (v0.7.1 has no BreadClient::request and predates the screenshots crate). bread-shared pins bread v0.8.0-rc.1 — latest existing tag with widget wire types (v0.7.0 has none; v0.8.0 was never cut). bakery.toml sets bread_deps = ["bread"] so the daemon is installed alongside the bar. CLAUDE.md records the single-trunk workflow and the bar / notifications / OSD / widgets split.
This commit is contained in:
parent
d8c766abe4
commit
be0b54e1ea
6 changed files with 71 additions and 15 deletions
51
CLAUDE.md
Normal file
51
CLAUDE.md
Normal file
|
|
@ -0,0 +1,51 @@
|
|||
# CLAUDE.md — Repo hygiene
|
||||
|
||||
Scope: this file covers *repo hygiene* — branching, remotes, CI — plus a
|
||||
short map of the binary. It is not user-facing project documentation.
|
||||
|
||||
This repo follows the branch/release workflow documented in `CONTRIBUTING.md`
|
||||
— read and follow it for any git, branch, or release work here (the
|
||||
single-trunk model, `feature/x`/`fix/x` branch naming, how RC tags work,
|
||||
etc). Don't improvise a different workflow. The short version: there is one
|
||||
long-lived branch, `main` — no `dev` or `beta` branch exists. `main`
|
||||
auto-publishes a dev-track build on every push. "Beta" and "stable" are both
|
||||
just tags, not branches: push a `vX.Y.Z-rc.N` tag to publish a beta-track
|
||||
build, push a plain `vX.Y.Z` tag to cut the signed stable release.
|
||||
"Freezing" for stabilization means pausing pushes to `main`, not moving a
|
||||
branch. This replaced an earlier three-branch (`dev`/`beta`/`main`) model
|
||||
after `main` was found to have silently rotted out of sync with `dev`/`beta`
|
||||
across most repos in this ecosystem.
|
||||
|
||||
When starting work on a new feature, create branch `feature/<feature-name>`.
|
||||
When working on a bug or issue, create branch `fix/<issue you are fixing>`.
|
||||
|
||||
## Remotes
|
||||
- `origin` — Forgejo (`git.breadway.dev` via Hestia, SSH) — authoritative.
|
||||
- `github` — GitHub mirror. Push `origin` only; GitHub auto-mirrors.
|
||||
|
||||
## CI
|
||||
- `dev-release.yml` triggers on `push: branches: ['main']`.
|
||||
- `rc-release.yml` triggers on `vX.Y.Z-rc.N` tag pushes (beta track).
|
||||
- `release.yml` triggers on any other `v*` tag push (stable).
|
||||
None of these run on plain commits or PRs beyond what's listed.
|
||||
|
||||
## Architecture
|
||||
|
||||
One GTK4/`relm4` binary, four surfaces:
|
||||
|
||||
| Area | Path | Role |
|
||||
|---|---|---|
|
||||
| Bar | `src/bar/` | Layer-shell top bar: workspaces, clock, media, stats, wifi, bluetooth, control panel + SNI tray |
|
||||
| Notifications | `src/notifications/` | `org.freedesktop.Notifications` daemon + stacked popups |
|
||||
| OSD | `src/osd.rs` | Volume/brightness overlay |
|
||||
| Widgets | `src/widgets/` | Live Lua widgets from breadd via `BreadClient` / `WidgetSpec` |
|
||||
|
||||
`--screenshot` (`src/screenshot.rs`) captures those views through
|
||||
`bread-screenshots`; do not rewrite it just to retarget the crate pin.
|
||||
|
||||
`application_id` drift vs Hyprland layer-rules/tour docs is known — leave it
|
||||
unless every mention is updated in the same change.
|
||||
|
||||
## Don't
|
||||
- Don't embed credentials in remote URLs — SSH or a credential helper only.
|
||||
- Don't rewrite the widget system or `screenshot.rs` as part of pin/docs work.
|
||||
Loading…
Add table
Add a link
Reference in a new issue