Made fsattrs immutable parameterized and added convenience bodies

The fsattrs immutable body was updated to accept a boolean parameter, allowing explicit control over a file's immutability state. To simplify usage, is_immutable and is_not_immutable bodies were introduced as direct aliases for the parameterized immutable with "true" and "false" arguments, respectively.

Ticket: CFE-4582
Changelog: Title

Author: nickanderson

lib/files.cf

@@ -1941,16 +1941,19 @@ body delete tidy
 ## fsattrs
 ##-------------------------------------------------------
 
-body fsattrs immutable
-# @brief Ensure promised file is immutable
+body fsattrs immutable(CF_BOOL)
+# @brief Ensure promised file is immutable or is not immutable
+# @param true_or_false A string, when true file immutability is enfored, when false file immutability is prevented.
+# cf-promises --syntax-description json | jq '.bodyTypes.fsattrs.attributes.immutable.range': "true,false,yes,no,on,off"
+
 #
 # **Example:**
 #
 # ```cf3
 # files:
 #   "/etc/motd"
 #     content => "There are, in fact, rules. You have been notified.",
-#     fsatters => immutable,
+#     fsatters => immutable("true"),
 #     perms => mog( "644", "root", "root" );
 # ````
 {
@@ -1959,9 +1962,49 @@ body fsattrs immutable
       # transparently with the bit being removed just before modification
       # and restored immediately after the atomic change is made.
 
+        immutable => "$(CF_BOOL)"; # The i attribute supported by chattr
+}
+
+body fsattrs is_immutable
+# @brief Ensure promised file is immutable
+#
+# **Example:**
+#
+# ```cf3
+# files:
+#   "/etc/motd"
+#     content => "There are, in fact, rules. You have been notified.",
+#     fsatters => is_immutable,
+#     perms => mog( "644", "root", "root" );
+# ````
+{
+      # The end state of the file should be immutable. If the promise
+      # necessitates a change in the file, the agent will handle immutability
+      # transparently with the bit being removed just before modification and
+      # restored immediately after the atomic change is made.
+
         immutable => "true"; # The i attribute supported by chattr
 }
 
+body fsattrs is_not_immutable
+# @brief Ensure promised file is immutable
+#
+# **Example:**
+#
+# ```cf3
+# files:
+#   "/etc/motd"
+#     content => "There are, in fact, rules. You have been notified.",
+#     fsatters => is_not_immutable,
+#     perms => mog( "644", "root", "root" );
+# ````
+{
+      # The end state of the file should be mutable. If the immutable bit is set
+      # it will be removed.
+
+        immutable => "false"; # The i attribute supported by chattr
+}
+
 @endif
 
 ##-------------------------------------------------------