feat(maestro): exclude hidden dirs from spawn-form autocomplete (NAP-329)

crates/maestro-daemon/src/dirlist.rs

@@ -28,7 +28,7 @@ pub const MAX_ENTRIES: usize = 1000;
 
 /// List the immediate subdirectories of `requested`, expanding it against
 /// `home_dir` first. Returns directory **names** only (not full paths), sorted
-/// case-insensitively, with hidden entries included.
+/// case-insensitively. Hidden directories (dotfiles) are excluded.
 pub fn list_dir(home_dir: &str, requested: &str) -> Result<DirListing, ErrorInfo> {
     let dir = resolve(home_dir, requested);
 
@@ -36,8 +36,14 @@ pub fn list_dir(home_dir: &str, requested: &str) -> Result<DirListing, ErrorInfo
 
     let mut entries: Vec<String> = Vec::new();
     for entry in read.flatten() {
+        let name = entry.file_name().to_string_lossy().into_owned();
+        // Skip hidden directories — the spawn form rarely targets dotfile dirs
+        // and they only clutter the completion list.
+        if name.starts_with('.') {
+            continue;
+        }
         if is_dir(&entry) {
-            entries.push(entry.file_name().to_string_lossy().into_owned());
+            entries.push(name);
         }
     }
     // Case-insensitive sort so `Projects` and `projects` interleave the way a
@@ -124,12 +130,13 @@ mod tests {
     }
 
     #[test]
-    fn lists_dirs_only_sorted_case_insensitively_including_hidden() {
+    fn lists_visible_dirs_only_sorted_case_insensitively() {
         let tmp = fixture();
         let home = tmp.path().to_string_lossy();
         let listing = list_dir(&home, "").unwrap();
-        // The file is excluded; dirs (incl. hidden + symlinked dir) are present.
+        // Files and hidden dirs are excluded; visible dirs (incl. a symlinked
-        assert!(listing.entries.contains(&".config".to_string()));
+        // dir) are present.
+        assert!(!listing.entries.contains(&".config".to_string()));
         assert!(listing.entries.contains(&"projects".to_string()));
         assert!(listing.entries.contains(&"Downloads".to_string()));
         assert!(!listing.entries.contains(&"notes.txt".to_string()));

crates/maestro-protocol/src/lib.rs

@@ -77,7 +77,7 @@ pub struct DirListing {
     pub path: PathBuf,
     /// Immediate subdirectory names (not full paths), sorted case-insensitively.
     /// Directories only — the spawn form's targets are always dirs. Hidden
-    /// entries (dotfiles) are included, matching shell completion.
+    /// directories (dotfiles) are excluded.
     pub entries: Vec<String>,
     /// True when `entries` was truncated at the daemon's cap; the client can
     /// surface "narrow your search" rather than implying the dir is small.

docs/superpowers/specs/2026-06-15-spawn-dir-autocomplete-design.md

@@ -33,7 +33,7 @@ The daemon lists **one directory's immediate subdirectories**; the web caches
 the result per `(daemonId, dir)` and filters the trailing path segment
 client-side, re-querying only when the user crosses a `/`. Fewer round-trips,
 instant filtering, still live. Directories only (cwd / base-repo are always
-dirs); hidden dirs included (shell parity); sorted case-insensitively; capped.
+dirs); hidden dirs excluded; sorted case-insensitively; capped.
 
 ### Wire protocol (`maestro-protocol`)
 
@@ -92,7 +92,7 @@ machinery, so older peers degrade gracefully.
 
 - Protocol: serde round-trip for the four new variants + `DirListing`, and an
   unknown-variant decode (already covered generically).
-- Daemon `dirlist`: temp-dir listing (dirs-only, hidden included, sorted), `~`
+- Daemon `dirlist`: temp-dir listing (dirs-only, hidden excluded, sorted), `~`
   and relative + empty expansion, and `not_found` / `not_a_directory` codes.
 - Daemon `broker`: `forward_list_dir` round-trip + fail-fast-while-disconnected,
   mirroring the existing forward_create/kill tests.