Skip to content

Release v19.0.1 with safe retained-state migration guidance #831

Closed

Description

@flyingrobots

Patch thesis

v19.0.1 makes the retained v18-to-v19 migration safe and understandable for real multi-graph repositories, then publishes the already-reviewed Runtime/API fixes as one immutable package. It benefits operators upgrading authoritative repositories. It does not port individual v18 applications to the v19 public API or complete the v20 streaming architecture.

Release gates

  • Audit the public front door, architecture, API, migration, operations, and topic index against the shipped CLI and runtime
  • Document the one-pass confirmation flow, graph discovery, scratch placement, capacity model, recovery refs, failure behavior, and application/API cutover boundary
  • Synchronize all version metadata and add dated v19.0.1 release notes
  • Pass documentation, package, release-prep, and packed-artifact validation
  • Merge the non-draft release PR with green CI and clean review
  • Verify the immutable v19.0.1 tag points to the reviewed main commit
  • Publish and verify npm, JSR, GitHub Release, package imports, CLI help, and a disposable migration smoke
  • Record release evidence, lightweight retrospective, and fallout issues

Publication boundary

Do not run v19.0.0 against an authoritative retained-v18 repository. Do not treat application API migration as part of the substrate command. Do not mutate ~/.think/codex during release preparation or artifact verification.

Activity

  1. added this to the v19.0.1 milestone on Jul 28, 2026
  2. added
    type:releaseRelease operation or release gate work.
    priority:asapImmediate release pressure.
    status:activeSomeone is actively working this issue.
    area:releasePrimary work area: release.
    on Jul 28, 2026
  3. coderabbitai commented on Jul 28, 2026

    @coderabbitai
    🔗 Related PRs

    #674 - Prepare v18.1.0 release [merged]
    #788 - Add one-shot v18-to-v19 retained-substrate migration [merged]
    #802 - Release v19.0.0 [merged]
    #829 - Make v19 generation and migration guidance executable [merged]
    #832 - Release v19.0.1 with safe migration guidance [open]


    📝 Issue Planner

    Check the box below or use the @coderabbitai plan command to generate an implementation plan and prompts that you can use with your favorite coding assistant.

    • Create Plan

    🧪 Issue enrichment is currently in open beta.

    You can configure auto-planning by selecting labels in the issue_enrichment configuration.

    To disable automatic issue enrichment, add the following to your .coderabbit.yaml:

    issue_enrichment:
      auto_enrich:
        enabled: false

    💬 Have feedback or questions? Drop into our discord!

  4. added
    priority:nextNext in line after active work.
    and removed
    priority:asapImmediate release pressure.
    on Jul 28, 2026
  5. flyingrobots commented on Jul 28, 2026

    @flyingrobots
    MemberAuthor

    v19.0.1 release evidence and retrospective

    Publication

    Public artifact smoke

    A clean temporary project installed exact @git-stunts/git-warp@19.0.1 with zero vulnerabilities. The root export was exactly Runtime; the README, architecture guide, v19 migration guide, operations guide, and API guide were present in the downloaded package; and git-warp-v18-to-v19 --help described the corrected one-pass default.

    The downloaded CLI then migrated the checked-in 2 MiB published-v18 fixture: two writers, 18 commits, retained checkpoint state, guarded scratch proof, atomic promotion, and complete recovery refs. The first run returned migrated with scratchVerified: true; the second returned already-current. ~/.think/codex was not touched.

    What went well

    Executable docs contracts caught stale version signposts, missing package docs, inaccurate source-mutation wording, and outdated settlement/API claims before publication. The branch, PR, main-push tag, and tag-level release gates each proved a distinct boundary. The bounded authentic v18 fixture gave a fast public-artifact proof without checking a huge repository into Git.

    What to improve

    npm pack and npm publish repeatedly invoke the full prepack test corpus, making release feedback slower than necessary; #826 owns that debt. JSR bootstrap repeatability remains tracked by #830. Think memory is still unreadable because of the mixed-format writer history, so the application/API port and authoritative repository rehearsal remain explicitly outside this package-release issue.

    No new BAD CODE™ or COOL IDEA™ fallout was discovered during publication; the relevant existing issues are #826, #830, and #828.

  6. flyingrobots commented on Jul 28, 2026

    @flyingrobots
    MemberAuthor

    v19.0.1 is published and independently verified on npm, JSR, GitHub Releases, a clean consumer install, and a disposable retained-v18 migration fixture.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    area:docsPrimary work area: docs.area:releasePrimary work area: release.area:storagePrimary work area: storage.area:testingPrimary work area: testing.priority:nextNext in line after active work.type:releaseRelease operation or release gate work.

    Type

    No type

    Projects

    No projects

      Milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions