From 9323fc1aa824b89034883bea725a096f5d59f0d1 Mon Sep 17 00:00:00 2001 From: Grzegorz Pilich Date: Fri, 31 Jul 2026 19:38:50 +0200 Subject: [PATCH] docs: sync handbook skill for 0.4.1 --- .claude/skills/neuralengine/SKILL.md | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) diff --git a/.claude/skills/neuralengine/SKILL.md b/.claude/skills/neuralengine/SKILL.md index d5daddd..d53f9c0 100644 --- a/.claude/skills/neuralengine/SKILL.md +++ b/.claude/skills/neuralengine/SKILL.md @@ -390,6 +390,27 @@ provenance and makes no revision-specific claim. Selection, Run recording, Evalu creation, and decision linkage remain explicit caller actions; none triggers automatic learning, mutation, materialization, activation, application, or evolution. +## Package and Brain format version contracts + +NeuralEngine package/application version and persisted Brain format version are independent +contracts. + +For NeuralEngine v1.1.0: + +- package/application version is 1.1.0, +- persisted Brain format version remains 1.0.0. + +A package release does not imply a Brain-format migration. Brain compatibility is determined by +the persisted Brain format contract, not by the package version. + +The authority for the package/application version is the NeuralEngine `pyproject.toml` and the +`neuralengine.__version__` module attribute. The authority for the persisted Brain format version +is the Brain `VERSION` file produced by Brain initialization. + +Package upgrade does not automatically migrate Brain format. Compatibility checks use the +persisted format contract, not the package version. Only behavior supported by NeuralEngine source +determines actual format support. + ## Decision Learning architecture # Decision Learning Architecture