fix: scan root workspace entry scripts

Author: Jammy2211

agents/conductors/hygiene/AGENTS.md

@@ -41,7 +41,7 @@ kinds, which is what makes its count comparable (or not):
 | `deps` | capped/pinned specifiers in library `pyproject.toml` (**surface**) | `/dep_audit` (Heart, hits PyPI) |
 | `docs` | `docs/api/*.rst` + `currentmodule` counts across the 3 doc repos (**surface**) | `/audit_docs` (Heart, imports) |
 | `crlf` | executable scripts (`.sh` + shebang-`755` `.py`) with CRLF — the shebang breaks on Linux/HPC (**debris**, the ranked count); library `.py` CRLF is reported separately as *cosmetic* (Python reads it fine — don't mass-normalise) | `/refactor` + `.gitattributes eol=lf` |
-| `docstrings` | consecutive module-level triple-quoted expressions separated only by whitespace in user-facing `*_workspace` and `HowTo*` `scripts/**/*.py` files (**finding**) | `/refactor` (mechanically merge each confirmed boundary) |
+| `docstrings` | consecutive module-level triple-quoted expressions separated only by whitespace in user-facing `*_workspace` and `HowTo*` root `*.py` entry scripts and `scripts/**/*.py` files (**finding**) | `/refactor` (mechanically merge each confirmed boundary) |
 | `config` | library `config/*.yaml` keys missing from the matching workspace config — recursive diff (**surface**) | `/refactor` (mirror keys) |
 | `artifacts` | tracked files that look like leaked run outputs / stray data (under `output/`, or data-ext outside fixtures) (**debris**) | `/repo_cleanup` (gitignore + `git rm --cached`) |
 | `packaging` | ignored, fully-untracked top-level `*.egg-info/` and `build/` directories in managed library repos (**debris**) | preview then run `PyAutoBrain/bin/clean_slate.sh --packaging`; repo-set, exact-name, root-depth and tracked-file guards apply |

agents/conductors/hygiene/_hygiene_docstrings.py

@@ -125,7 +125,11 @@ def scan(root: Path) -> tuple[list[Finding], list[ParseError], int]:
     repositories = repository_paths(root)
 
     for repository in repositories:
-        for path in sorted((repository / "scripts").rglob("*.py")):
+        script_paths = {
+            *repository.glob("*.py"),
+            *(repository / "scripts").rglob("*.py"),
+        }
+        for path in sorted(script_paths):
             relative = path.relative_to(repository).as_posix()
             try:
                 source = path.read_text(encoding="utf-8")

skills/hygiene/hygiene.md

@@ -19,7 +19,8 @@ Shared routing context: `PyAutoBrain/skills/COMMANDS.md`.
    tracked leaked outputs/data; `packaging` = ignored, fully-untracked top-level
    `*.egg-info/` and `build/` directories in managed library repositories;
    `docstrings` = exact adjacent module-level triple-quoted documentation
-   boundaries in user-facing workspace and HowTo scripts.)
+   boundaries in user-facing workspace and HowTo root entry scripts and
+   `scripts/**/*.py` files.)
 2. Execute the emitted plan: run the named delegate — `/repo_cleanup` (git
    debris), `/cli_noise_clean`, `/dep_audit`, `/audit_docs` — for the full audit,
    or for `perf` route slow imports/functions to `/refactor` / `/bug` (JAX-adapt

tests/test_hygiene_conductor.py

@@ -142,6 +142,22 @@ def test_docstrings_reports_only_adjacent_top_level_triple_quoted_blocks(tmp_pat
     ] == [(1, 3), (3, 4)]
 
 
+def test_docstrings_includes_root_level_entry_scripts(tmp_path):
+    scripts = tmp_path / "demo_workspace" / "scripts"
+    scripts.mkdir(parents=True)
+    entry_script = tmp_path / "demo_workspace" / "start_here.py"
+    entry_script.write_text('"""first"""\n\n"""second"""\n')
+
+    result = _run(["docstrings", "--json"], tmp_path)
+
+    assert result.returncode == 0, result.stderr
+    row = json.loads(result.stdout)["row"]
+    assert row["count"] == 1
+    assert row["findings"][0]["file"] == "start_here.py"
+    assert row["findings"][0]["first_end_line"] == 1
+    assert row["findings"][0]["second_line"] == 3
+
+
 def test_docstrings_human_output_includes_exact_locations(tmp_path):
     _write_docstring_fixture(tmp_path)