v0.25.0 β Definition Revisioning, Migration & Design Service
π΄ Palm Engine 0.25.0 β Definition Revisioning, Migration & Design Service
This release is a single jump from 0.23.1 that delivers the full definition evolution stack Palm has been building toward since the 0.24 vision.
What's new
Definition revisioning (0.24)
- Flow catalog is append-only β
update_flowpublishes revisionN+1, not an in-place overwrite - Instances pin
flow_revisionat submit and keep their snapshot until explicitly migrated - Migration rules registry with
can_migrate/migrate_statehooks - Impact query β see which instances are behind a target revision and whether migration is compatible, blocked, or snapshot-only
- Instance migration β dry-run or apply via REST/MCP;
migration_*metadata preserved across job sync
Design Service (0.25)
- Sixth service domain:
propose β validate β impact β commit host.design, REST/v1/api/design/proposals, MCPpalm_design_*- Durable proposals on
StorageEnginewhen storage is active - Auto-migrate compatible instances on commit (blocked instances skipped; revision not rolled back)
- Agent safety β
commit_tokenfrom validate/impact; strict mode viaPALM_MCP_REQUIRE_INPUT_TOKEN palm_assistdesign paths βdesign/propose,design/impact,design/commit, etc.- Wizard design contributor β slug uniqueness, collection schema checks
Agent workflow
palm_design_propose_flow β palm_design_validate β palm_design_impact β palm_design_commit
Agents should prefer palm_design_* for catalog writes. Direct palm_definitions_* CRUD remains for integrators and Explorer.
Upgrade from 0.23.1
Read MIGRATION-0.24.md (revision semantics, impact/migrate) and MIGRATION-0.25.md (design workflow).
Breaking semantic change: PUT /v1/api/definitions/flows/{id} appends a revision; running instances are not silently upgraded.
References
One-liner (social / commit tag)
Palm 0.25.0: revisioned definitions, instance migration, and Design Service β safe, inspectable catalog evolution for agents and operators.