From 3147c7deb7c41d465b94e6f3cebee17e247b620e Mon Sep 17 00:00:00 2001 From: zemion Date: Tue, 7 Jul 2026 09:12:50 +0200 Subject: [PATCH] Sync Repo-docs-RELEASE-DEPENDENCIES from project files --- Repo-docs-RELEASE-DEPENDENCIES.-.md | 37 ++++++++++++++++++++++------- 1 file changed, 28 insertions(+), 9 deletions(-) diff --git a/Repo-docs-RELEASE-DEPENDENCIES.-.md b/Repo-docs-RELEASE-DEPENDENCIES.-.md index f969fb7..8972edb 100644 --- a/Repo-docs-RELEASE-DEPENDENCIES.-.md +++ b/Repo-docs-RELEASE-DEPENDENCIES.-.md @@ -1,4 +1,4 @@ - + > Mirrored from `/mnt/DATA/git/govoplan-core/docs/RELEASE_DEPENDENCIES.md`. > Origin: `repository`. @@ -53,18 +53,37 @@ already installed. It does not install or uninstall Python/npm packages from inside the running server. For runtime package changes, create an operator install plan in Admin > System > -Modules. The plan can also be rendered from the server shell: +Modules. The module manager shows the trusted installer preflight status and +blocks unsafe uninstalls before the operator touches packages. + +Preflight from the server shell: ```bash -govoplan-module-install-plan --format shell -# or -python -m govoplan_core.commands.module_install_plan --format shell +govoplan-module-installer --format shell ``` -Apply those commands from a controlled operator shell while maintenance mode is -active. Install rows must use tagged package/git refs or registry packages, not -local `file:` or workspace links. After package changes, run migrations and -restart or reload the affected server/WebUI processes according to the +Apply from a controlled operator shell while maintenance mode is active: + +```bash +govoplan-module-installer --apply --build-webui +``` + +The installer uses a runtime lock, snapshots `pip freeze` plus WebUI +`package.json`/`package-lock.json`, writes a run record below +`runtime/module-installer/runs`, and marks planned rows as applied only after +all commands succeed. + +Rollback uses the saved run snapshot: + +```bash +govoplan-module-installer --rollback +``` + +Install rows must use tagged package/git refs or registry packages, not local +`file:` or workspace links. WebUI package changes still require `npm install` +and a WebUI rebuild/reload because the current shell resolves WebUI modules from +the build-time package graph. After backend package changes, run migrations and +restart or reload the affected server/worker processes according to the deployment model. ## WebUI