@wpmoo/toolkit 0.9.20 → 0.9.22

package/README.md

@@ -190,6 +190,17 @@ The unscoped `wpmoo` short alias is optional. If npm returns `E404` or rejects
 that alias during the publish workflow, the workflow reports a non-blocking
 warning while keeping the scoped package release valid.
 
+### Release candidate rules
+
+- **Required release artifacts**: `@wpmoo/toolkit`, `@wpmoo/odoo`, and
+  `@wpmoo/odoo-dev` must be publishable at package version `$VERSION` for tag
+  `v$VERSION` to count as valid.
+- **Optional artifact**: `wpmoo` at package version `$VERSION` is best-effort only. If npm
+  rejects it, the release still succeeds as long as the three required scoped
+  packages are valid.
+- **Smoke expectation**: run `npm run smoke:published -- "$VERSION"` after the
+  release tag workflow completes.
+
 ## Documentation
 
 - [External Resources](docs/external-resources.md)

package/dist/cli.js

@@ -280,8 +280,8 @@ async function showStartup(argv, skipUpdateCheck, details) {
     }
     console.log();
 }
-async function selectCockpitCommandFromMenu(serviceStatus, moduleCount) {
-    const selection = await selectCockpitTopLevelMenu({ serviceStatus, moduleCount });
+async function selectCockpitCommandFromMenu(serviceStatus, moduleCount, sourceRepoCount) {
+    const selection = await selectCockpitTopLevelMenu({ serviceStatus, moduleCount, sourceRepoCount });
     if (selection.kind === 'exit') {
         return 'exit';
     }
@@ -1453,7 +1453,7 @@ export async function runCli(cliArgv = process.argv.slice(2), cwd = process.cwd(
         };
         while (true) {
             try {
-                const command = await selectCockpitCommandFromMenu(serviceStatus, status.kind === 'environment' ? status.moduleCandidateCount : undefined);
+                const command = await selectCockpitCommandFromMenu(serviceStatus, status.kind === 'environment' ? status.moduleCandidateCount : undefined, status.kind === 'environment' ? status.sourceRepoCount : undefined);
                 if (command === 'exit') {
                     return;
                 }

package/dist/cockpit/menu.js

@@ -48,8 +48,13 @@ function serviceDisabledReason(command, serviceStatus) {
 function moduleDisabledReason(command, moduleCount) {
     return moduleCount === 0 && moduleDependentCommandIds.has(command.id) ? 'No modules found.' : undefined;
 }
-function disabledReason(command, serviceStatus, moduleCount) {
-    return serviceDisabledReason(command, serviceStatus) ?? moduleDisabledReason(command, moduleCount);
+function sourceRepoDisabledReason(command, sourceRepoCount) {
+    return sourceRepoCount === 0 && command.id === 'add-module' ? 'No source repos found.' : undefined;
+}
+function disabledReason(command, serviceStatus, moduleCount, sourceRepoCount) {
+    return (serviceDisabledReason(command, serviceStatus) ??
+        moduleDisabledReason(command, moduleCount) ??
+        sourceRepoDisabledReason(command, sourceRepoCount));
 }
 function disabledError() {
     return 'This option is disabled and cannot be selected.';
@@ -60,7 +65,7 @@ function commandDisabledValue(reason) {
     }
     return reason;
 }
-function categoryChoices(category, index, serviceStatus, moduleCount) {
+function categoryChoices(category, index, serviceStatus, moduleCount, sourceRepoCount) {
     const choices = [
         promptSeparator(categoryHeading(category)),
         ...topLevelCommands
@@ -70,7 +75,7 @@ function categoryChoices(category, index, serviceStatus, moduleCount) {
                 value: command,
                 name: commandName(command),
                 short: command.label,
-                disabled: commandDisabledValue(disabledReason(command, serviceStatus, moduleCount)),
+                disabled: commandDisabledValue(disabledReason(command, serviceStatus, moduleCount, sourceRepoCount)),
             };
         }),
     ];
@@ -103,8 +108,8 @@ function menuDeps(deps = {}) {
 function isCockpitCommand(value) {
     return typeof value === 'object' && value !== null && 'id' in value && 'slashAlias' in value;
 }
-function topLevelChoices(serviceStatus, moduleCount) {
-    return topLevelCategoryOrder.flatMap((category, index) => categoryChoices(category, index, serviceStatus, moduleCount));
+function topLevelChoices(serviceStatus, moduleCount, sourceRepoCount) {
+    return topLevelCategoryOrder.flatMap((category, index) => categoryChoices(category, index, serviceStatus, moduleCount, sourceRepoCount));
 }
 function defaultCommand(serviceStatus) {
     if (serviceStatus?.kind === 'running') {
@@ -117,7 +122,7 @@ function defaultCommand(serviceStatus) {
 }
 export async function selectCockpitTopLevelMenu(options = {}) {
     const deps = menuDeps(options);
-    const choices = topLevelChoices(options.serviceStatus, options.moduleCount);
+    const choices = topLevelChoices(options.serviceStatus, options.moduleCount, options.sourceRepoCount);
     const cancelAction = 'back';
     const selected = await deps.select({
         message: '',

package/docs/generated-environment-verification.md

@@ -160,3 +160,29 @@ npm test
 npm run test:coverage
 npm run build
 ```
+
+## Coverage watchlist (risk monitoring)
+
+The following list is a risk watchlist for Train 2 verification, not a hard gate.
+It uses the full `npm run test:coverage` suite to highlight where changes in
+high-impact runtime files should be reviewed with extra care:
+
+- `src/cli.ts`: **watch**: 83.74% line coverage (1458/1741), function coverage
+  92.47% (86/93), branch coverage 80.61% (420/521). This file remains the
+  highest-risk surface because it owns direct commands, cockpit dispatch, JSON
+  routes, and release-facing error behavior.
+- `src/doctor.ts`: **observe**: 94.48% line coverage (702/743), function
+  coverage 95.56% (43/45), branch coverage 86.42% (229/265).
+- `src/module-actions.ts`: **observe**: 96.83% line coverage (519/536),
+  function coverage 97.22% (35/36), branch coverage 88.97% (129/145).
+- `src/templates.ts`: **observe**: 99.24% line coverage (262/264), function
+  coverage 100.00% (38/38), branch coverage 90.08% (109/121).
+- `src/prompts/index.ts`: **observe**: 95.15% line coverage (294/309),
+  function coverage 100.00% (36/36), branch coverage 92.31% (96/104).
+
+Train 2 full-suite coverage baseline:
+
+- Statements: 92.65% (7304/7883)
+- Branches: 88.24% (2432/2756)
+- Functions: 96.27% (595/618)
+- Lines: 92.65% (7304/7883)

package/docs/handoff.md

@@ -42,7 +42,23 @@ npm view "@wpmoo/odoo-dev@$VERSION" version
 ```
 
 `npm view "wpmoo@$VERSION" version` is optional and may report that the short
-alias is absent.
+alias is absent. A release is valid when all required scoped packages verify:
+
+- `npm view "@wpmoo/toolkit@$VERSION" version`
+- `npm view "@wpmoo/odoo@$VERSION" version`
+- `npm view "@wpmoo/odoo-dev@$VERSION" version`
+
+Optional short alias rule:
+
+- `wpmoo` may be reported as missing or fail publish without invalidating the
+  release candidate. Scoped packages are the supported release artifacts and
+  are sufficient to mark the release valid.
+
+Suggested smoke check:
+
+```bash
+npm run smoke:published -- "$VERSION"
+```
 
 Current command standard:
 

package/package.json

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