Release prep for 2.2.0-alpha: bump UPM manifest, changelog, and install pin - #66
Merged
Conversation
Source staging is an explicit allowlist, and anything unlisted is dropped without a warning. A source-mode package built from this release would have been missing the behavior composites, the condition set, and the sync/async report bridge that State.Log and the composites both call, so it could not compile at the consumer. Binary mode is the release default, which is why this went unnoticed.
Enzx
force-pushed
the
release-prep/2.2.0-alpha
branch
from
August 6, 2026 21:10
59210d1 to
f2b3929
Compare
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.
Release prep for 2.2.0-alpha, per the UPM release checklist (three artifacts, one version):
package.jsonversion →2.2.0-alphaCHANGELOG.md→ new[2.2.0-alpha]entry covering everything merged since the 2.1.0-alpha tagREADME.mdinstall pin →upm/v2.2.0-alphaRebased onto
mainafter #67 (data-built branching) merged, so the entry now covers that too.What the release contains
Breaking — the delegate-backed director states were renamed (
ChoiceState→RelayChoiceState,SwitchState<TKey>→RelaySwitchState<TKey>, and both async twins), with no forwarding aliases, because the old names are reused in this same release for the new data-built states. Consumer code fails to compile until the type names are updated; that is deliberate, and the changelog leads with it. The version stays2.2.0-alpharather than taking a major bump — this is a pre-stable alpha line.Runtime — data-built branching (serializable
ChoiceState/SwitchState<T>deciding fromIConditionlists or literal cases), typed event entry points, declarative behaviors with bounded repetition, machine lifecycle hardening, the cross-runtime log-report bridge (now a capability, so non-Statenodes such as branches reach the observer too), director target observation under built ids, timeout wrapper wiring forwarding, self-sufficient validation plus labelled Mermaid branch arms, and serialization payload versions 7–10 with hardened read paths.Package — the netstandard2.1 API baseline, analyzers-as-errors, and the source-staging fix below.
Release blocker found while preparing this
NxGraph.Build's source-staging list is an explicit allowlist, and anything unlisted is dropped silently — the copy loop only reports folders it was asked for and could not find. It was missing theBehaviorsandConditionsfolders andValueTaskSync.cs, so a source-mode package built from this release would not have compiled at the consumer: the behavior composites, the condition set, and the sync/async report bridge thatState.Logand the composites both call were all absent. Binary mode is the release default, which is why this went unnoticed since the behaviors feature landed.Fixed in this PR, with a comment on the list recording that it is an allowlist that must track the core project's folders. Verified by running
stage-sourceand confirming all three appear in the staged output.Verification
dotnet run --project NxGraph.Build -- cion this branch: green, 0 warnings, 840 core + 235 serialization tests, 83% line coverage.After merge
Tag
v2.2.0-alpha(publishes all three NuGet packages) andupm/v2.2.0-alpha(UPM release, binary mode) on the merge commit.