Skip to content
This repository was archived by the owner on Aug 24, 2026. It is now read-only.

Document the release procedure - #51

Merged
mihneaptu merged 1 commit into
mainfrom
codex/docs-releasing
Jul 28, 2026
Merged

mihneaptu merged 1 commit into
mainfrom
codex/docs-releasing

Conversation

@mihneaptu

Copy link
Copy Markdown
Owner

Summary

Releasing 1.1.0 surfaced two facts that were written down nowhere: which branch
users actually install from, and that the bundle version lives in two files kept
in sync by a contract test. This records them.

docs/releasing.md covers the per-PR changelog duty, how to choose the version
by installed-copy impact, and the tag-and-publish steps. It also records the
rough edge that BUNDLE_VERSION moves only at release, so an install from main
mid-cycle writes the previous version into .fusion-install.json.

README gains the tag-pinned install form, so users are not forced to track
main.

Verification

  • npm test - 184 tests, 182 pass, 2 skipped, 0 fail
  • Both pin forms were checked against this repo with skills add --list, which
    resolved @ v1.1.0 and found the skill without installing anything:
    • mihneaptu/opencode-fusion#v1.1.0
    • https://github.com/mihneaptu/opencode-fusion/tree/v1.1.0

Deliberately not included

The install command also appears in site/index.html (twice), site/docs.html,
and site/llms.txt. Those are unchanged: the default install should stay the
untagged one, and adding a pin note to every surface is a separate decision.
Docs-only change, so no changelog entry.

Releasing 1.1.0 surfaced two things that were not written down anywhere:
which branch users actually install from, and that the bundle version
lives in two files a contract test keeps in sync.

docs/releasing.md records the per-PR changelog duty, how to choose the
version by installed-copy impact, and the tag-and-publish steps. It also
notes the rough edge that BUNDLE_VERSION moves only at release, so an
install from main mid-cycle records the previous version.

README gains the tag-pinned install form. Both `#v1.1.0` and the
`/tree/v1.1.0` URL were verified against this repo with `skills add
--list`, which resolved `@ v1.1.0` and found the skill without
installing.

npm test passes (184 tests, 182 pass, 2 skipped).
@mihneaptu
mihneaptu merged commit c22249b into main Jul 28, 2026
9 checks passed
@mihneaptu
mihneaptu deleted the codex/docs-releasing branch July 28, 2026 18:15
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant