From f5c3cfc6c7d350c7e83a49cb0bb62f59692137c4 Mon Sep 17 00:00:00 2001
From: Ian Littman <iansltx@gmail.com>
Date: Wed, 15 Jan 2025 16:24:10 -0600
Subject: [PATCH] Include notes on when automations won't run for a given host
 in software and script automation UIs (#25453)

For #25452.

- [x] Manual QA for all new/changed functionality
---
 .../InstallSoftwareModal/InstallSoftwareModal.tsx         | 7 +++++--
 .../components/InstallSoftwareModal/_styles.scss          | 5 +++++
 .../PolicyRunScriptModal/PolicyRunScriptModal.tsx         | 8 +++++---
 .../components/PolicyRunScriptModal/_styles.scss          | 5 +++++
 4 files changed, 20 insertions(+), 5 deletions(-)

diff --git a/frontend/pages/policies/ManagePoliciesPage/components/InstallSoftwareModal/InstallSoftwareModal.tsx b/frontend/pages/policies/ManagePoliciesPage/components/InstallSoftwareModal/InstallSoftwareModal.tsx
index 106dd3b640..90c16e9e54 100644
--- a/frontend/pages/policies/ManagePoliciesPage/components/InstallSoftwareModal/InstallSoftwareModal.tsx
+++ b/frontend/pages/policies/ManagePoliciesPage/components/InstallSoftwareModal/InstallSoftwareModal.tsx
@@ -284,8 +284,11 @@ const InstallSoftwareModal = ({
             )}
           </ul>
           <span className="form-field__help-text">
-            Selected software, if compatible with the host, will be installed
-            when hosts fail the chosen policy.{" "}
+            If compatible with the host, the selected software will be installed
+            when hosts fail the policy. App Store apps will not be installed if
+            hosts are not enrolled in MDM, or if no VPP licenses are available
+            for the app. If custom targets are enabled and a host with a failing
+            policy is <b>not</b> targeted, installation will be skipped.{" "}
             <CustomLink
               url="https://fleetdm.com/learn-more-about/policy-automation-install-software"
               text="Learn more"
diff --git a/frontend/pages/policies/ManagePoliciesPage/components/InstallSoftwareModal/_styles.scss b/frontend/pages/policies/ManagePoliciesPage/components/InstallSoftwareModal/_styles.scss
index 4de5eb6c27..bf8b54797b 100644
--- a/frontend/pages/policies/ManagePoliciesPage/components/InstallSoftwareModal/_styles.scss
+++ b/frontend/pages/policies/ManagePoliciesPage/components/InstallSoftwareModal/_styles.scss
@@ -1,5 +1,10 @@
 .manage-policies-page {
   .install-software-modal {
+    .form-field__help-text {
+      font-size: 14px;
+      line-height: 21px;
+    }
+
     .form-field--dropdown {
       width: 276px;
       .Select-placeholder {
diff --git a/frontend/pages/policies/ManagePoliciesPage/components/PolicyRunScriptModal/PolicyRunScriptModal.tsx b/frontend/pages/policies/ManagePoliciesPage/components/PolicyRunScriptModal/PolicyRunScriptModal.tsx
index bfb7864426..f9f3e66ad1 100644
--- a/frontend/pages/policies/ManagePoliciesPage/components/PolicyRunScriptModal/PolicyRunScriptModal.tsx
+++ b/frontend/pages/policies/ManagePoliciesPage/components/PolicyRunScriptModal/PolicyRunScriptModal.tsx
@@ -210,12 +210,14 @@ const PolicyRunScriptModal = ({
             )}
           </ul>
           <span className="form-field__help-text">
-            Selected script, if{" "}
+            If{" "}
             <TooltipWrapper tipContent={compatibleTipContent}>
               compatible
             </TooltipWrapper>{" "}
-            with the host, will run when hosts fail the policy. Host counts will
-            reset when a new script is selected.{" "}
+            with the host, the selected script will run when hosts fail the
+            policy. The script will not run on hosts with scripts disabled, or
+            on hosts with too many pending scripts. Host counts will reset when
+            new scripts are selected.{" "}
             <CustomLink
               url="https://fleetdm.com/learn-more-about/policy-automation-run-script"
               text="Learn more"
diff --git a/frontend/pages/policies/ManagePoliciesPage/components/PolicyRunScriptModal/_styles.scss b/frontend/pages/policies/ManagePoliciesPage/components/PolicyRunScriptModal/_styles.scss
index 7900c31ac2..4ffb0920d5 100644
--- a/frontend/pages/policies/ManagePoliciesPage/components/PolicyRunScriptModal/_styles.scss
+++ b/frontend/pages/policies/ManagePoliciesPage/components/PolicyRunScriptModal/_styles.scss
@@ -1,5 +1,10 @@
 .manage-policies-page {
   .policy-run-script-modal {
+    .form-field__help-text {
+      font-size: 14px;
+      line-height: 21px;
+    }
+
     .form-field--dropdown {
       width: 276px;
       .Select-placeholder {