docs: clarify Pi reload and update workflows

scripts/verify-workspace-install-docs.sh

@@ -1136,12 +1136,12 @@ verify_pi_management_guide() {
     return 1
   }
   require_headings "$guide" "Pi management guide" \
-    "Who can use Pi Management" \
-    "Use the Pi Management page" \
-    "Use thothctl" \
-    "Handle credentials and secrets" \
-    "Update and roll back Pi" \
-    "Recover a failed update" \
+    "Choose application defaults" \
+    "Edit the provider catalog and enabled-model policy" \
+    "Store provider credentials" \
+    "Reload changed configuration" \
+    "Update the bundled Pi version" \
+    "Recover a failed lifecycle operation" \
     "Direct support access"
   require_text "$guide" "Pi management guide" \
     "pi status" \
@@ -1149,6 +1149,11 @@ verify_pi_management_guide() {
     "pi test" \
     "pi check" \
     "pi configure" \
+    "pi restart --yes --drain" \
+    "restart only core" \
+    "deploy/pi/models.json" \
+    "deploy/pi/settings.json" \
+    "PI_AUTH_FILE" \
     "pi update" \
     "pi rollback --yes" \
     "pi maintenance status" \
@@ -1158,6 +1163,10 @@ verify_pi_management_guide() {
     "Raw Compose access is unsupported" \
     "no browser shell" \
     "does not mount the Docker socket"
+  if grep -Fq '~/.pi/agent/' "$guide"; then
+    echo "Pi management guide must not direct ThothII operators to native Pi paths" >&2
+    return 1
+  fi
   node - "$guide" <<'NODE'
 const fs = require("fs");
 const source = fs.readFileSync(process.argv[2], "utf8");