feat(PRE-COMMIT): add poetry-sphinx-build-language hook with custom types and CI fixes

This commit implements the `poetry-sphinx-build-language` pre-commit hook.

Key changes:
- Created `src/cicd_tools_pre_commit/sphinx.py` with the build logic.
- Created `src/cicd_tools_pre_commit/system/argparse_types.py` for reusable validation logic.
- Refactored logic to use custom argparse types for directory and path validation.
- Exposed `sphinx_build_language` in `src/cicd_tools_pre_commit/__init__.py`.
- Added the script to `pyproject.toml`.
- Registered and sorted the hook in `.pre-commit-hooks.yaml`.
- Fixed YAML indentation in `.pre-commit-hooks.yaml` to pass YAML linting.
- Added unit tests in `src/cicd_tools_pre_commit/tests/test_sphinx.py`.

Co-authored-by: niall-byrne <9848926+niall-byrne@users.noreply.github.com>

Author: google-labs-jules[bot]

.pre-commit-hooks.yaml

@@ -4,55 +4,55 @@
   description: Install a CICD-Tools toolbox from the gpg key verified manifest.
   entry: ./src/pre-commit/cicd-tools-box.sh -c curlimages/curl:8.90.@sha256:4c1cc1c836054961219e03d71e3f48a993aa40b92c3482eed316e50ede4889d9 -j ghcr.io/cicd-tools-org/cicd-tools:main -g ghcr.io/cicd-tools-org/cicd-tools-gpg:main
   args:
-  - -b
-  - 0.1.0
-  - -m
-  - https://raw.githubusercontent.com/cicd-tools-org/manifest/main/manifest.json.asc
+    - -b
+    - 0.1.0
+    - -m
+    - https://raw.githubusercontent.com/cicd-tools-org/manifest/main/manifest.json.asc
   always_run: true
   language: script
   pass_filenames: false
   require_serial: true
   stages:
-  - manual
+    - manual
 - id: cicd-tools-key
   name: cicd-tools-key
   description: Import the CICD-Tools gpg key for toolbox manifest verification.
   entry: ./src/pre-commit/cicd-tools-key.sh -g ghcr.io/cicd-tools-org/cicd-tools-gpg:main
   args:
-  - -n
-  - F07A79647E91E561A786B6D0D9020F7FEE20DBF2
-  - -p
-  - hkps://keys.openpgp.org
-  - -s
-  - keyserver.ubuntu.com
+    - -n
+    - F07A79647E91E561A786B6D0D9020F7FEE20DBF2
+    - -p
+    - hkps://keys.openpgp.org
+    - -s
+    - keyserver.ubuntu.com
   always_run: true
   language: script
   pass_filenames: false
   require_serial: true
   stages:
-  - manual
+    - manual
 - id: cicd-tools-schema-cookiecutter
   name: cicd-tools-schema-cookiecutter
   description: Verify a JSON file against the CICD-Tools cookiecutter schema.
   entry: with-cicd-resources check-jsonschema
   args:
-  - --schemafile
-  - '{CICD_RESOURCES}/schemas/cookiecutter.json'
+    - --schemafile
+    - '{CICD_RESOURCES}/schemas/cookiecutter.json'
   language: python
   pass_filenames: true
   stages:
-  - commit
+    - commit
 - id: cicd-tools-schema-manifest
   name: cicd-tools-schema-manifest
   description: Verify a JSON file against the CICD-Tools manifest schema.
   entry: with-cicd-resources check-jsonschema
   args:
-  - --schemafile
-  - '{CICD_RESOURCES}/schemas/manifest.json'
+    - --schemafile
+    - '{CICD_RESOURCES}/schemas/manifest.json'
   language: python
   pass_filenames: true
   stages:
-  - commit
+    - commit
 - id: commitizen-pre-bump
   name: commitizen-pre-bump
   description: TOML quote formatting for commitizen.
@@ -62,22 +62,22 @@
   pass_filenames: false
   require_serial: true
   stages:
-  - manual
+    - manual
 - id: format-shell
   name: format-shell
   description: Format the project's shell scripts.
   entry: --entrypoint=shfmt --env=FORCE_COLOR=1 ghcr.io/cicd-tools-org/cicd-tools:main
   args:
-  - -w
-  - --indent=2
-  - -ci
-  - -sr
+    - -w
+    - --indent=2
+    - -ci
+    - -sr
   exclude: ^\.cicd-tools/boxes/.+$
   files: ^.+\.(bash|sh)$
   language: docker_image
   pass_filenames: true
   stages:
-  - commit
+    - commit
 - id: format-toml
   name: format-toml
   description: Format the project's TOML files.
@@ -86,7 +86,7 @@
   language: docker_image
   pass_filenames: true
   stages:
-  - commit
+    - commit
 - id: gettext-translations-add
   name: gettext-translations-add
   description: Add new languages to the project folder structure for gettext.
@@ -96,7 +96,7 @@
   pass_filenames: false
   require_serial: true
   stages:
-  - manual
+    - manual
 - id: gettext-translations-compile
   name: gettext-translations-compile
   description: Compile gettext '.po' files into '.mo' files for distribution.
@@ -106,7 +106,7 @@
   pass_filenames: false
   require_serial: true
   stages:
-  - manual
+    - manual
 - id: gettext-translations-missing
   name: gettext-translations-missing
   description: Check all gettext '.po' files for untranslated strings.
@@ -117,7 +117,7 @@
   pass_filenames: false
   require_serial: true
   stages:
-  - commit
+    - commit
 - id: gettext-translations-update
   name: gettext-translations-update
   description: Extract translatable strings from the code base with gettext and regenerate '.pot' and '.po' files.
@@ -128,40 +128,40 @@
   pass_filenames: false
   require_serial: true
   stages:
-  - commit
+    - commit
 - id: git-conflict-markers
   name: git-conflict-markers
   entry: git
   args:
-  - --no-pager
-  - diff
-  - --cached
-  - --check
+    - --no-pager
+    - diff
+    - --cached
+    - --check
   language: system
   stages:
-  - commit
+    - commit
 - id: lint-dockerfile
   name: lint-dockerfile
   description: Lint the project's Dockerfiles.
   entry: --entrypoint=hadolint ghcr.io/cicd-tools-org/cicd-tools:main
   language: docker_image
   stages:
-  - commit
+    - commit
   types:
-  - dockerfile
+    - dockerfile
 - id: lint-github-workflow
   name: lint-github-workflow
   description: Lint the project's GitHub workflow files.
   entry: --entrypoint=actionlint ghcr.io/cicd-tools-org/cicd-tools:main
   args:
-  - -color
-  - -config-file
-  - .cicd-tools/configuration/actionlint.yaml
+    - -color
+    - -config-file
+    - .cicd-tools/configuration/actionlint.yaml
   files: ^.github/workflows/.+\.(yaml|yml)$
   language: docker_image
   pass_filenames: false
   stages:
-  - commit
+    - commit
 - id: lint-github-workflow-header
   name: lint-github-workflow-header
   description: Lint the headers of the project's GitHub workflow files.
@@ -170,34 +170,34 @@
   language: script
   pass_filenames: true
   stages:
-  - commit
+    - commit
 - id: lint-markdown
   name: lint-markdown
   description: Lint the Markdown files.
   files: ^.+\.md$
   entry: ghcr.io/igorshubovych/markdownlint-cli:v0.35.0@sha256:22cf4699a448a7bbc311a940e0600019423d7671cbedae9c35cd32b51f560350
   args:
-  - -c
-  - .markdownlint.yml
+    - -c
+    - .markdownlint.yml
   language: docker_image
   pass_filenames: true
   stages:
-  - commit
+    - commit
 - id: lint-shell
   name: lint-shell
   description: Lint the project's shell scripts.
   entry: --entrypoint=shellcheck ghcr.io/cicd-tools-org/cicd-tools:main
   args:
-  - --color=always
-  - --source-path=SCRIPTDIR
-  - --exclude=SC2317
-  - -x
+    - --color=always
+    - --source-path=SCRIPTDIR
+    - --exclude=SC2317
+    - -x
   exclude: ^\.cicd-tools/boxes/.+$
   files: ^.+\.(bash|sh)$
   language: docker_image
   pass_filenames: true
   stages:
-  - commit
+    - commit
 - id: poetry-lint-ansible
   name: poetry-lint-ansible
   description: Check the collection or role for Ansible best practices using ansible-lint from the local poetry environment.
@@ -206,15 +206,15 @@
   language: script
   pass_filenames: false
   stages:
-  - commit
+    - commit
 - id: poetry-lint-python
   name: poetry-lint-python
   description: Lint the project's Python files using pylint from the local poetry environment.
   entry: poetry run pylint
   files: ^.+\.py$
   language: system
   stages:
-  - commit
+    - commit
 - id: poetry-sphinx-build-language
   name: poetry-sphinx-build-language
   description: Build sphinx documentation for a specific language using poetry.
@@ -223,72 +223,72 @@
   pass_filenames: false
   require_serial: true
   stages:
-  - manual
+    - manual
 - id: poetry-types-python
   name: types-python
   description: Type check the project's Python files using mypy from the local poetry environment.
   entry: poetry run mypy
   args:
-  - --strict
-  - --show-error-codes
-  - --implicit-reexport
-  - --explicit-package-bases
+    - --strict
+    - --show-error-codes
+    - --implicit-reexport
+    - --explicit-package-bases
   files: ^.+\.pyi?$
   language: system
   require_serial: true
   stages:
-  - commit
+    - commit
 - id: pre-commit-sort-config
   name: pre-commit-sort-config
   description: Sort the hooks inside your pre-commit configuration files.
   entry: ./src/pre-commit/pre-commit-sort-config.sh
   args:
-  - ghcr.io/cicd-tools-org/cicd-tools:main
+    - ghcr.io/cicd-tools-org/cicd-tools:main
   files: ^(.+/)*\.pre-commit-config\.yaml$
   language: script
   pass_filenames: true
   require_serial: true
   stages:
-  - commit
+    - commit
 - id: pre-commit-sort-hooks
   name: pre-commit-sort-hooks
   description: Sort the hooks inside your pre-commit hook definition files.
   entry: ./src/pre-commit/pre-commit-sort-hooks.sh
   args:
-  - ghcr.io/cicd-tools-org/cicd-tools:main
+    - ghcr.io/cicd-tools-org/cicd-tools:main
   files: ^(.+/)*\.pre-commit-hooks\.yaml$
   language: script
   pass_filenames: true
   require_serial: true
   stages:
-  - commit
+    - commit
 - id: security-credentials
   name: security-credentials
   description: Scan codebase for checked in credentials.
   entry: trufflesecurity/trufflehog:3.63.2@sha256:16c1cf07b7142037a2859d4ad0f51c40603e7e58703ddb8bd80cf40e6af51f44
   args:
-  - git
-  - file://.
-  - --fail
-  - --no-update
-  - --debug
-  - --max-depth=500
+    - git
+    - file://.
+    - --fail
+    - --no-update
+    - --debug
+    - --max-depth=500
   language: docker_image
   pass_filenames: false
   stages:
-  - commit
+    - commit
 - id: spelling-commit-message
   name: spelling-commit-message
   description: Check the spelling on the commit message.
   entry: ./src/pre-commit/spelling-commit-message.sh
   args:
-  - ghcr.io/cicd-tools-org/cicd-tools:main
+    - ghcr.io/cicd-tools-org/cicd-tools:main
   always_run: true
   language: script
   pass_filenames: true
   require_serial: true
   stages:
-  - commit-msg
+    - commit-msg
 - id: spelling-markdown
   name: spelling-markdown
   description: Spellcheck the Markdown files.
@@ -297,22 +297,22 @@
   language: docker_image
   pass_filenames: true
   stages:
-  - commit
+    - commit
 - id: spelling-vale-sync
   name: spelling-vale-sync
   description: Download any required vale packages.
   entry: -v /tmp:/tmp --entrypoint=vale ghcr.io/cicd-tools-org/cicd-tools:main
   args:
-  - sync
+    - sync
   always_run: true
   language: docker_image
   pass_filenames: false
   stages:
-  - manual
+    - manual
 - id: spelling-vale-vocab
   name: spelling-vale-vocab
   entry: sh -c 'for FILE in "$@"; do sort -u -o ${FILE} ${FILE}; done' --
   files: ^.vale/Vocab/.+/(accept|reject)\.txt$
   language: system
   stages:
-  - commit
+    - commit