Skip to content
Aerangis Docs

CoCoFlow 0.4.1 Release Notes

CoCoFlow 0.4.1 was released on September 4, 2026. It removes the legacy Gameplay sample and rebuilds the mature Editor surfaces around a unified UI Toolkit visual language. No new public Runtime capability is added.

Gameplay sample removed

Section titled “Gameplay sample removed”

The entire Samples~/Gameplay sample tree (Character/Enemy/Item runtime, Editor tooling, and sample tests) was removed. No replacement sample ships with the package; the Git history remains the archive and no Legacy or Archive copy was created.

Eight sample tests that proved package contracts were migrated into the formal Tests/Runtime suites with fully test-owned fixtures. The remaining sample-specific tests were removed together with the sample.

Package dependencies slimmed

Section titled “Package dependencies slimmed”

com.unity.splines and com.unity.ai.navigation are no longer package dependencies. Their only package consumers lived in the removed sample. Install them through your own project manifest when a host project needs them; CoCoFlow does not require them.

Runtime API removals and migrations

Section titled “Runtime API removals and migrations”
  • PersistenceCharacterContextAdapter and PersistenceItemContextAdapter were removed, together with their default registrations in PersistenceContextAdapterRegistry. The registry is now a pure extension point: a host that needs Context capture implements IPersistenceContextAdapter and calls Register itself.
  • The internal helper PersistenceContextReflection was removed; it lost its only consumers together with the built-in adapters.
  • The Core interfaces ICoCoIntent, ICoCoIntentSource<T>, and ICoCoContextFrameResolver were removed. They carried the 0.3.x mutable-object intent pattern; the official intent path is the StateFlow IntentFrame contract family.
  • The CoCoFlow.Runtime.Gameplay prefix entries were removed from the StateGraph authoring forbidden-assembly guards, matching diagnostic wording, and the package keywords.

Editor rebuilds on a unified visual language

Section titled “Editor rebuilds on a unified visual language”
  • A shared Editor/Common UI Toolkit visual language (ccflow USS, reusable element builders, and bilingual English/简体中文 Editor chrome) now backs the mature Editor surfaces. Asset names, descriptor names, and Runtime diagnostic payloads are never translated.
  • The CoCoLog window was rebuilt on this language while preserving filtering, counts, clear, auto-scroll, module colors, and unknown-module behavior.
  • The Setup Assistant was renamed and rebuilt as the CoCoFlow Utility panel (CoCoFlow > Utility Panel, window title “CoCoFlow Utility”). It migrated from IMGUI to UI Toolkit and was split into focused setup modules: module catalog, dependency actions, status scanner, JSON utility, and version policies. The CoCoFlowSetupAssistant editor type is replaced by CoCoFlowUtility. “Apply Recommended Dependencies” now shows an explicit impact-disclosure confirmation before writing anything, and cancelling writes nothing.
  • The StateGraph Editor was rebuilt on the same visual language: the main window, canvas cards, Preset Wizard, and the Asset Inspector share one theme, with bilingual static chrome. The canvas is a flattened genealogy view of the whole Layer with Animator-style Transition edges, persistent per-State layout, a “Tidy Subtree” action, and a read-only Host-requirements card derived from the compilation manifests.
  • The StateGraphHost Inspector and the Runtime Debugger were rebuilt with UI Toolkit. The Inspector keeps the existing binding and validation contracts; the Debugger is now a read-only temporal-history view for the selected Host covering Current Frame, Temporal Ring, and Persisted Frame, with an optional SceneView target marker.
  • CoCoFlow.Editor.StateGraph now references CoCoFlow.Editor.Common.

Animation snapshot fix

Section titled “Animation snapshot fix”

BUG-032: Animator Float/Integer/Boolean parameters are now sampled and restored per binding type. Float lanes keep GetFloat/SetFloat (behavior unchanged), Integer lanes carry the parameter’s exact 32-bit payload as raw bits through the fixed lane (full Int32 range, no numeric cast), and Boolean lanes sample as 0f/1f and restore with SetBool. Trigger behavior is unchanged. See Animation for the documented snapshot semantics.

Verification evidence

Section titled “Verification evidence”

Test runs executed on the release snapshot d9fbbae (“release: prepare CoCoFlow 0.4.1”). The final tag 7ab190c has a Git tree identical to that snapshot, so the evidence applies unchanged to the published package.

Unity version EditMode Editor PlayMode
6000.3.20f1 721 passed, 1 ignored*, 0 failed/inconclusive 379/379
6000.5.5f1 722/722 379/379

* The single 6000.3 EditMode ignore is an environment condition: the verification host already contained a StateGraph asset, so one test’s precondition was not met. The same unmodified test passes on 6000.5.

Compatibility note

Section titled “Compatibility note”

As with 0.4.0, the 0.4 line targets new projects and does not include an automatic migration runtime for 0.3.9 projects. Pin the package URL to #v0.4.1 when you need this exact release baseline.

See Installation for the package URL and Dependency Matrix for required and optional integrations.