Sitelet https://github.com/argotorg/fe/pull/1787
Skip to content

Assemble release notes with eisenbote - #1787

Merged
sbillig merged 4 commits into
masterfrom
release-notes-eisenbote
Oct 6, 2026
Merged

sbillig merged 4 commits into
masterfrom
release-notes-eisenbote

Conversation

@cburgdorf

Copy link
Copy Markdown
Collaborator

Replaces towncrier and newsfragments/validate_files.py with
eisenbote, a towncrier replacement
written in Fe for the native backend. Fragments are written as before. For our
settings the output is byte-identical to towncrier; eisenbote's tests check this
by replaying all past Fe releases.

Process

  • make notes version=X builds the compiler from this checkout, builds
    eisenbote with it, writes CHANGELOG.md, removes the consumed fragments and
    commits.
  • make release and make push-tag use eisenbote check --empty; CI uses
    make check-notes.
  • The Makefile keeps a clone of eisenbote in target/eisenbote;
    EISENBOTE=<path> uses another checkout.
  • Settings move from pyproject.toml to eisenbote.toml.

Dogfooding

Each release builds and runs a Fe program (a workspace with a git dependency,
native I/O and heap buffers) with the compiler being released, before tagging.
Writing it already turned up several compiler bugs, which have separate fix
branches.

Fallback

eisenbote's CI builds it daily against Fe master and publishes passing builds as
its last-working release. If building eisenbote with this Fe fails,
make notes uses that executable; EISENBOTE_BUILD=0 uses it directly.

eisenbote (https://github.com/fe-lang/eisenbote) replaces towncrier and
newsfragments/validate_files.py. It reads the existing [tool.towncrier]
settings in pyproject.toml and produces the same release notes.

`make notes` builds eisenbote with the Fe compiler about to be released,
which also exercises the native backend on a real program, and falls back
to eisenbote's last working executable if that build fails. `make release`,
`make push-tag` and CI use `eisenbote check` for the fragment directory.
eisenbote is expected next to this repository (EISENBOTE=../eisenbote).
Move the release notes settings from pyproject.toml, which only held them
for towncrier, to eisenbote.toml, and drop the towncrier name from the
changelog's start marker. The release notes are unchanged.
The Makefile keeps its own clone of eisenbote in target/eisenbote and
updates it to eisenbote's latest master, instead of expecting a checkout
next to the repository. EISENBOTE still selects another checkout. CI runs
the new `make check-notes`.
EISENBOTE_BUILD=0 uses eisenbote's last working executable instead of
building it with this Fe. The build step says how to do that, since fe
prints nothing for minutes while it compiles.
@cburgdorf
cburgdorf requested a review from sbillig October 6, 2026 08:30
@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Oct 6, 2026 •

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-10-06T08:33:11.252440Z e6621f9 PR opened
🔒 Security Review ✅ Completed 2026-10-06T08:37:29.598307Z e6621f9 PR opened

Security findings

Advisory findings (1)

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@cburgdorf

Copy link
Copy Markdown
Collaborator Author

@sbillig I gave this a good manual test. We should be good.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🛡️ Codex Security Review · Automatically triggered

Here are some automated security review suggestions for this pull request.

Reviewed commit: e6621f918d

ℹ️ About Codex security reviews in GitHub

This is an experimental Codex feature. Security reviews are triggered when:

  • You comment "@codex security review"
  • A regular code review gets triggered (for example, "@codex review" or when a PR is opened), and you’re opted in so security review runs alongside code review

Once complete, Codex will leave suggestions, or a comment if no findings are found.

Comment thread Makefile

@sbillig sbillig left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🎉

@sbillig
sbillig merged commit 0e5777e into master Oct 6, 2026
9 checks passed
@sbillig
sbillig deleted the release-notes-eisenbote branch October 6, 2026 16:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants