chore: update CHANGELOG for 0.3.2; fix lint, mypy, and stale test

- Promote [Unreleased] items into a new [0.3.2] section dated 2026-03-13
- Exclude tests/animation fixture dir from ruff
- Drop unused 'misc' from type: ignore in watch.py
- Decode bytes paths in watch event logger (mypy str-bytes-safe)
- Rename 'found' → 'svg_meta' in read-meta to fix mypy no-redef error
- Update test_cli_not_a_directory → test_cli_single_file to match the
  single-file input support added in ac1e51c

Author: deeplook

CHANGELOG.md

@@ -7,17 +7,38 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.3.2] - 2026-03-13
+
 ### Added
 
-- **Multiple local roots**: `dirplot map bar baz` accepts two or more local directory
-  paths. dirplot finds their common parent, scans each path independently, and assembles
-  a synthetic wrapper tree that contains only the requested subtrees — siblings are
-  excluded entirely.
-- **`--subtree` / `-s`** option (repeatable) — an allowlist complement to `--exclude`:
-  after scanning the root, keep only the named direct children. Supports nested paths
-  such as `--subtree src/dirplot/fonts`, which produces a synthetic `src → dirplot`
-  chain containing only the `fonts` subtree. Useful when it is easier to name what you
-  want than to enumerate what you don't.
+- **`dirplot watch`** subcommand — watches a directory and regenerates the treemap
+  on every file-system change using watchdog (FSEvents on macOS, inotify on Linux,
+  kqueue on BSD). Requires `watchdog`, now a core dependency.
+  ```bash
+  dirplot watch . --output treemap.png
+  dirplot watch . --output treemap.png --animate   # APNG, one frame per change
+  ```
+- **Vertical file labels**: file tiles that are at least twice as tall as wide now
+  display their label rotated 90° CCW, letting the text span the full tile height
+  instead of being squeezed into the narrow width.
+- **Scan and render timing** shown in header output:
+  `Found 1,414 files … [2.3s]` and `Saved dirplot to out.png  [0.4s]`.
+- **Multiple local roots**: `dirplot map src tests` accepts two or more local
+  directory paths, finds their common parent, and shows only those subtrees.
+- **`--subtree` / `-s`** option (repeatable) — allowlist complement to `--exclude`:
+  keep only the named direct children of the root after scanning. Supports nested
+  paths such as `--subtree src/dirplot/fonts`.
+
+### Fixed
+
+- `--exclude` on pod and Docker backends now prunes entire subtrees — previously only
+  the exact path was matched, so all children leaked through.
+- Clearer error for distroless pods: exit code 126 from `kubectl exec` now surfaces as
+  an actionable message explaining that the container has no shell or `find` utility.
+- Adaptive file-label font size is now computed with a single `textbbox` measurement
+  (one call per tile) instead of stepping down one pixel at a time — eliminates an
+  O(font_size × n_tiles) bottleneck that caused near-blocking on large trees such as
+  `.venv` directories.
 
 ### Changed
 

pyproject.toml

@@ -78,6 +78,7 @@ packages = ["src/dirplot"]
 line-length = 100
 target-version = "py310"
 src = ["src", "tests"]
+exclude = ["tests/animation"]
 
 [tool.ruff.lint]
 select = ["E", "F", "W", "I", "UP", "B", "C4", "SIM"]

src/dirplot/main.py

@@ -204,17 +204,17 @@ def read_meta(
         except ET.ParseError as exc:
             typer.echo(f"Error parsing SVG: {exc}", err=True)
             raise typer.Exit(1) from exc
-        found: dict[str, str] = {}
+        svg_meta: dict[str, str] = {}
         for desc in root.iter("{http://www.w3.org/1999/02/22-rdf-syntax-ns#}Description"):
             for child in desc:
                 local = child.tag.split("}")[-1] if "}" in child.tag else child.tag
                 ns_uri = child.tag.split("}")[0].lstrip("{") if "}" in child.tag else ""
                 if ns_uri == "https://github.com/deeplook/dirplot#" and child.text:
-                    found[local] = child.text
-        if not found:
+                    svg_meta[local] = child.text
+        if not svg_meta:
             typer.echo("No dirplot metadata found in SVG.", err=True)
             raise typer.Exit(1)
-        for k, v in found.items():
+        for k, v in svg_meta.items():
             typer.echo(f"{k}: {v}")
 
     else:

src/dirplot/watch.py

@@ -9,7 +9,7 @@
     from watchdog.events import FileSystemEvent, FileSystemEventHandler
     from watchdog.observers import Observer
 except ImportError:
-    Observer = None  # type: ignore[assignment,misc]
+    Observer = None  # type: ignore[assignment]
 
 from dirplot.render import create_treemap
 from dirplot.scanner import apply_log_sizes, build_tree
@@ -142,7 +142,9 @@ def _regenerate(self) -> None:
     def _log_event(self, verb: str, event: FileSystemEvent) -> None:
         src = event.src_path
         dest = getattr(event, "dest_path", None)
-        msg = f"{verb}: {src}" if not dest else f"{verb}: {src} → {dest}"
+        src_s = src.decode() if isinstance(src, bytes) else src
+        dest_s = dest.decode() if isinstance(dest, bytes) else dest
+        msg = f"{verb}: {src_s}" if not dest_s else f"{verb}: {src_s} → {dest_s}"
         print(msg, file=sys.stderr)
 
     def on_created(self, event: FileSystemEvent) -> None:

tests/test_cli.py

@@ -24,12 +24,11 @@ def test_cli_invalid_path() -> None:
     assert "does not exist" in result.output
 
 
-def test_cli_not_a_directory(tmp_path: Path) -> None:
+def test_cli_single_file(tmp_path: Path) -> None:
     f = tmp_path / "file.txt"
     f.write_text("hello")
     result = runner.invoke(app, ["map", str(f), "--no-show"])
-    assert result.exit_code == 1
-    assert "Not a directory" in result.output
+    assert result.exit_code == 0
 
 
 def test_cli_bad_colormap(sample_tree: Path) -> None: