@wpmoo/toolkit 0.9.21 → 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/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.21",
+  "version": "0.9.22",
   "description": "WPMoo Toolkit for development, staging, and production lifecycle workflows.",
   "type": "module",
   "repository": {