maint: prepare first release readiness - #20
Merged
Conversation
Prepare the repository for its first release without performing one. No tag, published version, or version bump is created here. - Add a Keep-a-Changelog `CHANGELOG.md` with a single `[Unreleased]` section summarizing pull requests #1–#18 grouped by Added/Changed and by milestone. - Add `.github/workflows/release.yml`, triggered only on `v*` tag pushes (plus a build-only `workflow_dispatch`). It builds the `autophagy` CLI for macOS (arm64) and Linux (x86_64) via the mise-pinned toolchain, builds the macOS app bundle with `swift build -c release` through `make-app-bundle.sh`, uploads everything as workflow artifacts, and creates a DRAFT GitHub release for a human to publish. All actions are SHA-pinned. It stays dormant until tagged. - Update the README Status section to reflect the completed alpha (retrieval, synthesis boundary, macOS read-only app) and add an "Install / Build from source" section (mise + cargo + swift). - Add a release-readiness closing note to the alpha roadmap. Version audit: all 14 workspace crates use `version.workspace = true`, resolving to `0.1.0-alpha.1` in the root `Cargo.toml`. Left unchanged. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Claim
Make the repository ready for its first release without performing one. No tag, published version, or version-bump commit is created here — a human still runs the actual release later.
CHANGELOG.md(new, repo root): Keep-a-Changelog format with a single## [Unreleased]section (no version stamped, no date). Summarizes pull requests feat: establish AEP v0.1 foundation #1–feat: add native read-only macOS experience #18 grouped under Added/Changed, organized milestone-by-milestone, each entry citing its PR number..github/workflows/release.yml(new): triggers only onpushofv*tags, plus a build-onlyworkflow_dispatch(dry_runinput). It builds theautophagyCLI for macOS (arm64,macos-14) and Linux (x86_64,ubuntu-24.04) via the mise-pinned toolchain, builds the macOS app bundle withswift build -c releasethrough the existingapps/macos/scripts/make-app-bundle.sh, uploads all outputs as workflow artifacts, and creates a draft GitHub release (gh release create --draft) that a human must publish. Since nov*tag exists, the workflow stays dormant — intended.README.md: Status section updated to reflect the completed alpha (exact/hybrid retrieval, local synthesis boundary, native read-only macOS app); new "Install / Build from source" section (mise + cargo + swift), pointing at the guides and repository-structure doc.docs/roadmap/alpha-pull-requests.md: short closing note that the alpha sequence is complete and the first release is being prepared.Evidence
mise run checkpasses (fmt, clippy-D warnings, full workspace tests,actionlint, pandoc docs).actionlintexits 0 on the new workflow.actions/checkout@…9c091bb(v7.0.0),jdx/mise-action@…e6a8b39(v4.2.0),actions/upload-artifact@…ea165f8(v4.6.2),actions/download-artifact@…d3f86a1(v4.3.0).CHANGELOG.md,README.md) is not covered bymise run docs(which scansdocs/**/*.md); both were separately validated as GFM withpandoc --from=gfmand pass.version.workspace = true, resolving to0.1.0-alpha.1in the rootCargo.toml. Left unchanged. One separate versioning scheme was found and deliberately not changed: the macOS app bundleInfo.plistinmake-app-bundle.shhard-codesCFBundleShortVersionString=0.1.0(app marketing version, distinct from the crate version). Reported rather than silently altered.store.rsormain.rs).Privacy implications
None. Documentation, changelog, and a dormant CI workflow only; no change to data handling, redaction, or persisted content.
🤖 Generated with Claude Code