@wpmoo/toolkit 0.9.32 → 0.9.33

package/README.md

@@ -143,6 +143,9 @@ Every cockpit action maps to a direct command, so the same workflow can be used
 
 When an environment has many module candidates, module selection switches to
 search so names, repositories, and source categories can be filtered quickly.
+Runtime actions that need running services or a ready database are disabled in
+the cockpit until the environment is ready; file-only actions such as module
+scaffolding, source repository changes, and safe reset remain available.
 
 ```bash
 ./moo start

package/dist/cockpit/menu.js

@@ -21,6 +21,16 @@ const topLevelCategoryOrder = [
 const topLevelCommands = topLevelCategoryOrder.flatMap((category) => cockpitCommands.filter((command) => command.category === category && command.id !== 'exit'));
 const topLevelCommandLabelWidth = Math.max(...topLevelCommands.map((command) => command.label.length));
 const moduleDependentCommandIds = new Set(['list-modules', 'install', 'update', 'test', 'pot', 'remove-module']);
+const runningServicesRequiredCommandIds = new Set([
+    'install',
+    'update',
+    'test',
+    'pot',
+    'psql',
+    'snapshot',
+    'restore-snapshot',
+    'resetdb',
+]);
 function rgb(red, green, blue, value) {
     return `\u001B[38;2;${red};${green};${blue}m${value}\u001B[39m`;
 }
@@ -39,6 +49,7 @@ const disabledReasonNextStep = {
     'Services stopped.': 'Next: choose "Start services" first.',
     'Already running.': 'Next: choose "Stop services" or "Restart services".',
     'Docker not running.': 'Next: start Docker, then choose "Start services".',
+    'Database not ready.': 'Next: wait for the database or choose "Restart services".',
     'No source repos found.': 'Next: choose "Add source repo" first.',
 };
 function disabledError(reason) {
@@ -50,15 +61,22 @@ function disabledError(reason) {
     return nextStep ? `${base}\nReason: ${reason}\n${nextStep}` : `${base}\nReason: ${reason}`;
 }
 function serviceDisabledReason(command, serviceStatus) {
-    if (command.category !== 'services' || !serviceStatus)
+    if (!serviceStatus)
+        return undefined;
+    const requiresRunningServices = command.category === 'services' || runningServicesRequiredCommandIds.has(command.id);
+    if (!requiresRunningServices)
         return undefined;
     if (serviceStatus.kind === 'docker-not-running')
         return 'Docker not running.';
     if (serviceStatus.kind === 'running' && command.id === 'start')
         return 'Already running.';
-    if (serviceStatus.kind === 'stopped' && ['stop', 'restart', 'logs', 'shell'].includes(command.id)) {
+    if (serviceStatus.kind === 'stopped' &&
+        (['stop', 'restart', 'logs', 'shell'].includes(command.id) || runningServicesRequiredCommandIds.has(command.id))) {
         return 'Services stopped.';
     }
+    if (serviceStatus.kind === 'services-running' && runningServicesRequiredCommandIds.has(command.id)) {
+        return 'Database not ready.';
+    }
     return undefined;
 }
 function moduleDisabledReason(command, moduleCount) {
@@ -71,10 +89,10 @@ function snapshotDisabledReason(command, snapshotCount) {
     return snapshotCount === 0 && command.id === 'restore-snapshot' ? 'No snapshots found.' : undefined;
 }
 function disabledReason(command, serviceStatus, moduleCount, sourceRepoCount, snapshotCount) {
-    return (serviceDisabledReason(command, serviceStatus) ??
-        moduleDisabledReason(command, moduleCount) ??
+    return (moduleDisabledReason(command, moduleCount) ??
         sourceRepoDisabledReason(command, sourceRepoCount) ??
-        snapshotDisabledReason(command, snapshotCount));
+        snapshotDisabledReason(command, snapshotCount) ??
+        serviceDisabledReason(command, serviceStatus));
 }
 function commandDisabledValue(reason) {
     if (!reason) {

package/docs/command-reference.md

@@ -29,6 +29,12 @@ unscoped `npx wpmoo` short alias is optional and best-effort; scripts should use
 
 Run these from the generated environment root:
 
+The cockpit disables runtime actions such as `psql`, `snapshot`, `resetdb`,
+`restore-snapshot`, `install`, `update`, `test`, and `pot` while services are
+stopped or the database is not ready. File-only cockpit actions remain
+selectable so source repositories, module scaffolds, and safe reset can still be
+managed.
+
 | Command | Cockpit Equivalent | Guarded In Stage/Prod | Notes |
 | --- | --- | --- | --- |
 | `./moo start` | Services -> Start services | No | Starts local Odoo services. Disabled in cockpit when already running. |

package/docs/troubleshooting.md

@@ -11,6 +11,8 @@ Symptoms:
 - The create wizard stops before writing files.
 - `./moo start`, `./moo status`, or `./moo doctor` reports Docker or Docker
   Compose as unavailable.
+- The cockpit disables database or module runtime actions because Docker,
+  services, or the database are not ready.
 
 Check:
 
@@ -30,6 +32,9 @@ The create wizard intentionally stops before setup questions when required
 runtime tools are missing. That protects the workspace from half-created
 environments.
 
+If Docker is running but the cockpit says the database is not ready, wait for
+PostgreSQL readiness or choose `Restart services`.
+
 ## No Modules Found
 
 Symptoms:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wpmoo/toolkit",
-  "version": "0.9.32",
+  "version": "0.9.33",
   "description": "WPMoo Toolkit for development, staging, and production lifecycle workflows.",
   "type": "module",
   "repository": {