fix: hide completion cache hint by default

configs/core/perf.zsh

@@ -76,7 +76,7 @@ _zsh_report() {
   _print_duration_row 'total' "$total_ms"
   echo '└────────────────────────────┘'
 
-  if [[ "${_zsh_completion_cache_mode:-}" == 'cache-hit' && -n "${_zsh_compdump_file:-}" ]]; then
+  if [[ "${SUITUP_SHOW_COMPLETION_CACHE_HINT:-0}" == '1' && "${_zsh_completion_cache_mode:-}" == 'cache-hit' && -n "${_zsh_compdump_file:-}" ]]; then
     printf 'completion cache hit; remove %s to rebuild\n' "$_zsh_compdump_file"
   fi
 }

configs/shared/tools/_loader.zsh

@@ -1,5 +1,6 @@
 # ============================================================================
 # Shared tool loader and cached init helpers
+# Generated by suitup
 # ============================================================================
 #
 # This file contains common helpers used by multiple tool modules.

configs/shared/tools/atuin.zsh

@@ -1,5 +1,6 @@
 # ============================================================================
 # atuin history integration
+# Generated by suitup
 # ============================================================================
 #
 # This module owns shell initialization for atuin.

configs/shared/tools/bun.zsh

@@ -1,5 +1,6 @@
 # ============================================================================
 # bun completion
+# Generated by suitup
 # ============================================================================
 #
 # This module keeps bun completion isolated because it is optional and can be

configs/shared/tools/fzf.zsh

@@ -1,5 +1,6 @@
 # ============================================================================
 # fzf configuration and Ctrl-T widget
+# Generated by suitup
 # ============================================================================
 #
 # This module owns all fzf-specific shell behavior in this config.

configs/shared/tools/runtime.zsh

@@ -1,5 +1,6 @@
 # ============================================================================
 # Runtime helper tools
+# Generated by suitup
 # ============================================================================
 #
 # This module groups lightweight shell integrations that do not own complex

tests/setup.test.js

@@ -360,6 +360,63 @@ describe("Setup simulation in sandbox", () => {
     }
   });
 
+  test("flags managed tool module edits as zsh-config pending", () => {
+    const completedSandbox = createSandbox();
+    try {
+      mkdirSync(join(completedSandbox.path, ".config", "zsh", "core"), { recursive: true });
+      mkdirSync(join(completedSandbox.path, ".config", "zsh", "shared"), { recursive: true });
+      mkdirSync(join(completedSandbox.path, ".config", "zsh", "local"), { recursive: true });
+      mkdirSync(join(completedSandbox.path, ".config", "zsh", "shared", "tools"), { recursive: true });
+
+      copyFileSync(join(CONFIGS_DIR, "zshrc.template"), join(completedSandbox.path, ".zshrc"));
+      copyFileSync(join(CONFIGS_DIR, "zshenv.template"), join(completedSandbox.path, ".zshenv"));
+      for (const file of ["perf.zsh", "env.zsh", "paths.zsh", "options.zsh"]) {
+        copyFileSync(
+          join(CONFIGS_DIR, "core", file),
+          join(completedSandbox.path, ".config", "zsh", "core", file)
+        );
+      }
+      for (const file of ["tools.zsh", "completion.zsh", "highlighting.zsh", "aliases.zsh", "plugins.zsh", "prompt.zsh"]) {
+        copyFileSync(
+          join(CONFIGS_DIR, "shared", file),
+          join(completedSandbox.path, ".config", "zsh", "shared", file)
+        );
+      }
+      for (const file of ["_loader.zsh", "fzf.zsh", "runtime.zsh", "atuin.zsh", "bun.zsh"]) {
+        copyFileSync(
+          join(CONFIGS_DIR, "shared", "tools", file),
+          join(completedSandbox.path, ".config", "zsh", "shared", "tools", file)
+        );
+      }
+      copyFileSync(
+        join(CONFIGS_DIR, "local", "machine.zsh"),
+        join(completedSandbox.path, ".config", "zsh", "local", "machine.zsh")
+      );
+
+      const loaderPath = join(completedSandbox.path, ".config", "zsh", "shared", "tools", "_loader.zsh");
+      const loader = readFileSync(loaderPath, "utf-8");
+      writeFileSync(
+        loaderPath,
+        loader.replace(
+          "# This file contains common helpers used by multiple tool modules.",
+          "# This file contains common helpers used by multiple tool modules, now with an added note."
+        )
+      );
+
+      const opts = {
+        home: completedSandbox.path,
+        platform: "darwin",
+        commandExistsFn(name) {
+          return ["zsh", "brew"].includes(name);
+        },
+      };
+
+      expect(detectPendingStepUpdates(opts)).toContain("zsh-config");
+    } finally {
+      completedSandbox.cleanup();
+    }
+  });
+
   test("does not treat non-suitup shell files as completed zsh config", () => {
     mkdirSync(join(sandbox, ".config", "zsh", "core"), { recursive: true });
     mkdirSync(join(sandbox, ".config", "zsh", "shared"), { recursive: true });