fix: scope Python linters to src/ and tests/, sync standard-tooling v1.1.4 (#352)

Exclude scripts/ from ruff to avoid conflicts with centrally managed standard-tooling scripts. Remove now-unnecessary per-file-ignores for scripts/. Sync all shared scripts from standard-tooling v1.1.4.

Co-authored-by: wphillipmoore-claude <255925739+wphillipmoore-claude@users.noreply.github.com>

Author: wphillipmoore

pyproject.toml

@@ -64,7 +64,7 @@ pymqrest = ["py.typed", "mapping-data.json"]
 line-length = 120
 target-version = "py312"
 src = ["src", "tests"]
-extend-exclude = ["docs/archive"]
+extend-exclude = ["docs/archive", "scripts"]
 
 [tool.ruff.lint]
 select = ["ALL"]
@@ -90,10 +90,6 @@ docstring-quotes = "double"
     "S105", # Hardcoded test passwords are expected in test fixtures.
     "S106", # Hardcoded test password arguments are expected in test fixtures.
 ]
-"scripts/**/*.py" = [
-    "D1",  # Internal tooling scripts do not require docstrings.
-    "T201", # Scripts use print for user-facing output.
-]
 "examples/**/*.py" = [
     "INP001", # Example scripts are not a package; no __init__.py needed.
     "T201",   # Example scripts use print for user-facing output.

scripts/dev/commit.sh

@@ -1,4 +1,6 @@
 #!/usr/bin/env bash
+# Managed by standard-tooling — DO NOT EDIT in downstream repos.
+# Canonical source: https://github.com/wphillipmoore/standard-tooling
 # Commit wrapper that constructs standards-compliant commit messages.
 # Resolves Co-Authored-By identities from docs/repository-standards.md.
 

scripts/dev/finalize_repo.sh

@@ -1,4 +1,6 @@
 #!/usr/bin/env bash
+# Managed by standard-tooling — DO NOT EDIT in downstream repos.
+# Canonical source: https://github.com/wphillipmoore/standard-tooling
 set -euo pipefail
 
 # Finalize a repository after a PR merge: switch to the target branch,

scripts/dev/prepare_release.py

@@ -1,4 +1,6 @@
 #!/usr/bin/env python3
+# Managed by standard-tooling — DO NOT EDIT in downstream repos.
+# Canonical source: https://github.com/wphillipmoore/standard-tooling
 """Automate release preparation: branch, changelog, PR, auto-merge.
 
 Shared script for library repositories using the library-release branching
@@ -207,10 +209,10 @@ def merge_main(version: str) -> None:
 
 
 def generate_changelog(version: str) -> bool:
-    """Generate changelog via git-cliff if available. Return True if generated."""
-    if not shutil.which("git-cliff"):
-        print("git-cliff not found, skipping changelog generation.")
-        return False
+    """Generate changelog via git-cliff. Return True if generated."""
+    for tool in ("git-cliff", "markdownlint"):
+        if not shutil.which(tool):
+            raise SystemExit(f"Required tool '{tool}' not found. Install it before releasing.")
     tag = f"develop-v{version}"
     print(f"Generating changelog with boundary tag: {tag}")
     run_command(("git-cliff", "--tag", tag, "-o", "CHANGELOG.md"))
@@ -219,6 +221,18 @@ def generate_changelog(version: str) -> bool:
         changelog.read_text(encoding="utf-8").rstrip() + "\n",
         encoding="utf-8",
     )
+    result = subprocess.run(
+        ("markdownlint", "CHANGELOG.md"),
+        capture_output=True,
+        text=True,
+    )
+    if result.returncode != 0:
+        print(result.stdout)
+        print(result.stderr)
+        raise SystemExit(
+            "CHANGELOG.md failed markdownlint validation. "
+            "Fix cliff.toml template or CHANGELOG content before releasing."
+        )
     run_command(("git", "add", "CHANGELOG.md"))
     status = read_command_output(("git", "status", "--porcelain"))
     if not status:

scripts/dev/submit-pr.sh

@@ -1,4 +1,6 @@
 #!/usr/bin/env bash
+# Managed by standard-tooling — DO NOT EDIT in downstream repos.
+# Canonical source: https://github.com/wphillipmoore/standard-tooling
 # PR submission wrapper that constructs standards-compliant PR bodies.
 # Populates .github/pull_request_template.md programmatically.
 

scripts/dev/sync-tooling.sh

@@ -1,4 +1,6 @@
 #!/usr/bin/env bash
+# Managed by standard-tooling — DO NOT EDIT in downstream repos.
+# Canonical source: https://github.com/wphillipmoore/standard-tooling
 set -euo pipefail
 
 # sync-tooling.sh — keep local copies of shared scripts in sync with
@@ -110,7 +112,7 @@ if [[ -n "$ref" ]]; then
 else
   # Discover the latest tag without a full clone.
   clone_ref="$(git ls-remote --tags --sort=-v:refname "$TOOLING_REPO" 'v*' \
-    | head -n 1 | sed 's|.*refs/tags/||')"
+    | head -n 1 | sed 's|.*refs/tags/||; s|\^{}$||')"
   if [[ -z "$clone_ref" ]]; then
     echo "ERROR: no tags found in $TOOLING_REPO" >&2
     exit 1

scripts/dev/validate_local.sh

@@ -1,5 +1,6 @@
 #!/usr/bin/env bash
-# Canonical source: standard-tooling
+# Managed by standard-tooling — DO NOT EDIT in downstream repos.
+# Canonical source: https://github.com/wphillipmoore/standard-tooling
 # validate_local.sh — shared driver for pre-PR local validation.
 #
 # Reads primary_language from docs/repository-standards.md, then runs:

scripts/dev/validate_local_common.sh

@@ -1,5 +1,6 @@
 #!/usr/bin/env bash
-# Canonical source: standard-tooling
+# Managed by standard-tooling — DO NOT EDIT in downstream repos.
+# Canonical source: https://github.com/wphillipmoore/standard-tooling
 # validate_local_common.sh — shared checks run for ALL repos.
 set -euo pipefail
 

scripts/dev/validate_local_go.sh

@@ -1,5 +1,6 @@
 #!/usr/bin/env bash
-# Canonical source: standard-tooling
+# Managed by standard-tooling — DO NOT EDIT in downstream repos.
+# Canonical source: https://github.com/wphillipmoore/standard-tooling
 # validate_local_go.sh — Go-specific local validation checks.
 set -euo pipefail
 

scripts/dev/validate_local_java.sh

@@ -1,5 +1,6 @@
 #!/usr/bin/env bash
-# Canonical source: standard-tooling
+# Managed by standard-tooling — DO NOT EDIT in downstream repos.
+# Canonical source: https://github.com/wphillipmoore/standard-tooling
 # validate_local_java.sh — Java-specific local validation checks.
 set -euo pipefail