Skip to content

release: prepare and publish Base v1.10.1 #2520

Closed

Description

@codeforester

Goal

Prepare and publish Base v1.10.1 through the governed cross-repository release train.

Scope

  • prepare the release metadata and current-release documentation;
  • validate the selected component tags and full commit pins;
  • run the Ubuntu 24.04 and macOS 14 Ecosystem Release BOM workflow;
  • run the guarded release check and preserve the BOM evidence;
  • publish only after explicit maintainer approval, then verify the tag, assets, immutable readback, Homebrew handoff, and downstream documentation.

Release classification

This is a patch release containing release-process guardrails, CI/preflight tooling, and documentation alignment. Treat it as a high-impact patch for the release-artifact boundary: record the candidate window and independent review or solo-maintainer waiver before publication.

Acceptance criteria

  • The v1.10.1 milestone has no unrelated open work at final preflight.
  • The release-prep PR passes the full required hosted matrix.
  • The BOM is generated at the exact merged Base commit and passes on Ubuntu 24.04 and macOS 14.
  • basectl release publish --dry-run passes with the preserved BOM.
  • Publication is separately approved and followed by public release, checksum, package, documentation, and immutable-release readback.

Non-goals

Do not add the stable basectl release train command or the Base 1.11.0 AI-harness work; those remain tracked separately.

Activity

  1. added this to the v1.10.1 milestone on Oct 13, 2026
  2. self-assigned this
    on Oct 13, 2026
  3. added
    ciContinuous integration, tests, automation, or release workflows
    on Oct 13, 2026
  4. moved this to Backlog in baseon Oct 13, 2026
  5. moved this from Backlog to In Progress in baseon Oct 13, 2026
  6. moved this from In Progress to In Review in baseon Oct 13, 2026
  7. moved this from In Review to In Progress in baseon Oct 13, 2026
  8. codeforester commented on Oct 13, 2026

    @codeforester
    CollaboratorAuthor

    Candidate evidence recorded:

    • Release-prep PR release: prepare Base v1.10.1 #2521 merged at 9bd1a5484ac10acda2c3a012ab89f7d9393e8d26.
    • Hosted PR matrix passed, including macOS, Ubuntu source-checkout, security, Windows, and release-train policy gates.
    • Ecosystem Release BOM run: https://github.com/basefoundry/base/actions/runs/38353190163
    • BOM artifact checksum: 58521a0f467046859858dc3f9249e895f139aae2a1af7cf0593bc7ff710119b1
    • BOM binds basefoundry/base v1.10.1 to 9bd1a5484ac10acda2c3a012ab89f7d9393e8d26, base-cli v0.5.1, base-bash-libs v2.2.2, and base-demo v0.2.1; required Ubuntu 24.04 and macOS 14 combinations passed.
    • bin/base-release-bom validate passed.
    • bin/basectl release check --version 1.10.1 --bom ... passed with status ok.
    • bin/basectl release publish --version 1.10.1 --bom ... --dry-run passed.

    Publication, Homebrew handoff, and final public readback remain pending explicit maintainer approval.

  9. codeforester commented on Oct 13, 2026

    @codeforester
    CollaboratorAuthor

    Publication reached GitHub but is not complete.

    • Annotated tag v1.10.1 exists and peels to reviewed commit 9bd1a5484ac10acda2c3a012ab89f7d9393e8d26.
    • GitHub Release: https://github.com/basefoundry/base/releases/tag/v1.10.1
    • The release is immutable and currently has no assets. The publish command created the release before attempting to upload the required BOM pair; GitHub rejected the upload with Cannot upload assets to an immutable release.
    • Reviewed BOM checksum remains 58521a0f467046859858dc3f9249e895f139aae2a1af7cf0593bc7ff710119b1.

    I am stopping before the Homebrew handoff. The release-publish implementation needs a recovery/design decision because immutable releases cannot accept assets after publication.

  10. codeforester commented on Oct 13, 2026

    @codeforester
    CollaboratorAuthor

    Follow-up fix is now in PR #2522. It changes basectl release publish to pass release-bom.json and release-bom.sha256 directly to gh release create, so GitHub uploads them before immutable publication. Local validation: 1793 Python tests and 1041 BATS tests passed; hosted checks are running.

    Homebrew report: the live basefoundry/homebrew-base tap currently publishes Base 1.9.0, and the inspected machine has Base 1.9.0 installed. Therefore brew upgrade basefoundry/base/base correctly reports no upgrade. brew update basefoundry/base/base is not a formula-refresh command; Homebrew rewrites it to brew upgrade. The tap must receive a Base formula PR after a governed Base release before that command can upgrade.

  11. codeforester commented on Oct 19, 2026

    @codeforester
    CollaboratorAuthor

    Superseded by the successful v1.10.5 release. The v1.10.1 publication exposed the immutable-release asset-ordering defect; PR #2523 fixed it, and v1.10.5 successfully published the BOM assets with cross-platform evidence and Homebrew handoff.

  12. moved this from In Progress to Done in baseon Oct 19, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

ciContinuous integration, tests, automation, or release workflows

Type

No type

Projects

  • Status
    Done

Milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions