murashit_codex-panel/docs/release.md

24 lines
1.6 KiB
Markdown
Raw Normal View History

2026-05-16 11:16:10 +00:00
# Release
GitHub Releases attach only `main.js`, `manifest.json`, and `styles.css` as Obsidian install assets. `LICENSE` and `NOTICE` are kept in the repository and source archives for license distribution.
2026-05-20 05:12:19 +00:00
Release work is Jujutsu-first in a colocated Git repository; Git is still used to push the tag that triggers the GitHub Release workflow. If the checkout has not been initialized for Jujutsu yet, run `jj git init --colocate` and `jj bookmark track main --remote=origin` once.
2026-05-16 11:16:10 +00:00
Create a release by preparing the next version, editing the generated release notes, committing the release changes, then running the preflight before pushing the matching tag:
```sh
npm run release:prepare -- X.Y.Z
# Edit .github/release-notes/X.Y.Z.md.
2026-05-20 05:12:19 +00:00
jj status
jj commit -m "Bump version to X.Y.Z"
jj bookmark move main --to @-
2026-05-16 11:16:10 +00:00
npm run release:preflight
2026-05-20 05:12:19 +00:00
jj tag set X.Y.Z -r main
jj git push --remote origin --bookmark main
git push origin X.Y.Z
2026-05-16 11:16:10 +00:00
```
2026-05-20 05:12:19 +00:00
`release:prepare` updates the version files and creates a `## Changes` release notes template. `release:preflight` verifies the local Jujutsu/Git state, release metadata, lockfile, and full build once after the release commit is on `main`.
2026-05-16 11:16:10 +00:00
The release workflow runs `npm ci`, `npm run release:check`, `npm run check:ci`, attaches the install assets, and generates GitHub artifact attestations for them. The release notes file is required and must contain a single `## Changes` section. If a tag-triggered release fails before creating the GitHub Release, fix the commit, move the local tag with `jj tag set --allow-move -r main X.Y.Z`, then update the remote tag with `git push --force origin X.Y.Z`.