enroll/harvest.py

@@ -392,7 +392,7 @@ def harvest(bundle_dir: str, policy: Optional[SecretPolicy] = None) -> str:
         )
 
     # -------------------------
-    # Manually installed package roles
+    # Manual package roles
     # -------------------------
     manual_pkgs = list_manual_packages()
     # Avoid duplicate roles: if a manual package is already managed by any service role, skip its pkg_<name> role.
@@ -488,7 +488,7 @@ def harvest(bundle_dir: str, policy: Optional[SecretPolicy] = None) -> str:
 
         if not pkg_to_etc_paths.get(pkg, []) and not managed:
             notes.append(
-                "No /etc files detected for this package."
+                "No /etc files detected for this package (may be a meta package)."
             )
 
         pkg_snaps.append(

enroll/manifest.py

@@ -149,7 +149,7 @@ users_accounts:
             lines.append(f"    group: {u.get('primary_group')}")
             lines.append("    mode: '0700'")
 
-        # Copy harvested SSH public material (authorized_keys)
+        # Copy harvested SSH public material (authorized_keys + *.pub)
         for mf in managed_files:
             dest = mf["path"]
             src = mf["src_rel"]
@@ -439,7 +439,7 @@ Generated from `{unit}`.
         manifested_service_roles.append(role)
 
     # -------------------------
-    # Manually installed package roles
+    # Manual package roles
     # -------------------------
     for pr in package_roles:
         role = pr["role_name"]
@@ -490,7 +490,7 @@ Generated from `{unit}`.
         task_parts: List[str] = []
         task_parts.append(
             f"""---
-- name: Install package {pkg}
+- name: Install manual package {pkg}
   ansible.builtin.apt:
     name: "{{{{ {var_prefix}_packages }}}}"
     state: present
@@ -525,7 +525,7 @@ Generated from `{unit}`.
         notes = pr.get("notes", [])
         readme = f"""# {role}
 
-Generated for package `{pkg}`.
+Generated for manual package `{pkg}`.
 
 ## Managed files
 {os.linesep.join("- " + mf["path"] + " (" + mf["reason"] + ")" for mf in managed_files) or "- (none)"}
@@ -536,7 +536,7 @@ Generated for package `{pkg}`.
 ## Notes
 {os.linesep.join("- " + n for n in notes) or "- (none)"}
 
-> Note: package roles (those not discovered via a systemd service) do not attempt to restart or enable services automatically.
+> Note: package roles do not attempt to restart or enable services automatically.
 """
         with open(os.path.join(role_dir, "README.md"), "w", encoding="utf-8") as f:
             f.write(readme)
@@ -546,8 +546,8 @@ Generated for package `{pkg}`.
     # Playbooks
     _write_playbook(
         os.path.join(out_dir, "playbook.yml"),
-        manifested_pkg_roles
-        + manifested_service_roles
+        manifested_users_roles
         + manifested_etc_custom_roles
-        + manifested_users_roles,
+        + manifested_pkg_roles
+        + manifested_service_roles,
     )