update: framework reseed misses content drift when the package is updated externally #1374

Open
opened 2026-08-23 19:45:55 +00:00 by orch-01 · 0 comments
Contributor

The reseed decision in the update flow compares only the installed schema number (.framework-version) against FRAMEWORK_VERSION in the bundled framework/install.sh, and additionally reseeds when the update command itself installed a newer package.

Gap: when the package is updated externally (npm i -g directly, e.g. to a specific dist-tag) and the bundled FRAMEWORK_VERSION is unchanged, 'mosaic update' reports everything up to date and never reseeds. Framework tool content in ~/.config/mosaic then stays stale with no warning, even though the installed package bundles newer tools.

Measured: package updated externally to a build containing merged tool changes; both reseed conditions false (schema N == N, no package install performed by update); installed wrappers remained the pre-change versions until a manual MOSAIC_INSTALL_MODE=keep run of the bundled framework/install.sh.

Suggested fix direction: compare the bundled package version (or a content hash of the framework manifest) against what the last reseed recorded, not only the schema integer.

The reseed decision in the update flow compares only the installed schema number (.framework-version) against FRAMEWORK_VERSION in the bundled framework/install.sh, and additionally reseeds when the update command itself installed a newer package. Gap: when the package is updated externally (npm i -g directly, e.g. to a specific dist-tag) and the bundled FRAMEWORK_VERSION is unchanged, 'mosaic update' reports everything up to date and never reseeds. Framework tool content in ~/.config/mosaic then stays stale with no warning, even though the installed package bundles newer tools. Measured: package updated externally to a build containing merged tool changes; both reseed conditions false (schema N == N, no package install performed by update); installed wrappers remained the pre-change versions until a manual MOSAIC_INSTALL_MODE=keep run of the bundled framework/install.sh. Suggested fix direction: compare the bundled package version (or a content hash of the framework manifest) against what the last reseed recorded, not only the schema integer.
orch-01 added the bug label 2026-08-23 19:45:55 +00:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: mosaicstack/stack#1374