fix plugin smoke fs chmod mode

Author: marcofortina

examples/runbooks/runbooks/20-fs.check.yaml

@@ -50,7 +50,7 @@ tasks:
       use: fs.chmod
       with:
         path: /tmp/automax-demo
-        mode: 420
+        mode: '0644'
     - id: fs_chown
       use: fs.chown
       with:

tests/test_documentation_and_regressions.py

@@ -11,6 +11,7 @@
 import sys
 
 import pytest
+import yaml
 from click.testing import CliRunner
 
 from automax.cli.cli import cli
@@ -627,6 +628,22 @@ def test_runbook_helpers_keep_sudo_password_env_explicit():
         assert '--sudo-password-env "$SUDO_PASSWORD_ENV"' in script
 
 
+def test_plugin_smoke_runbooks_keep_file_modes_as_strings():
+    offenders = []
+    for runbook_path in sorted(Path("examples/runbooks/runbooks").glob("*.check.yaml")):
+        data = yaml.safe_load(runbook_path.read_text(encoding="utf-8"))
+        for task in data.get("tasks", []):
+            for step in task.get("steps", []):
+                for substep in step.get("substeps", []):
+                    params = substep.get("with") or {}
+                    if "mode" in params and not isinstance(params["mode"], str):
+                        offenders.append(
+                            f"{runbook_path}:{substep.get('id')}:{substep.get('use')}: "
+                            f"mode must be quoted string, got {type(params['mode']).__name__}"
+                        )
+
+    assert offenders == []
+
 def test_docs_show_sudo_password_env_for_runs_and_capability_installs():
     docs = "\n".join(
         path.read_text(encoding="utf-8")