Sync main with v0.3.1

[knoepfel]

• Build system

  • Bumped the project version from 0.3.0 to 0.3.1 in the top-level CMakeLists.txt.

• Packaging / installation

  • Updated the Spack installation instructions to use phlex@0.3.1 instead of phlex@0.3.0.
  • Added driver.hpp to the set of public headers installed into include/phlex.

• Documentation

  • Updated Sphinx docs configuration to report release 0.3.1 instead of 0.3.0.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: deaa8843-e845-4b68-874c-e995b04b77c7

📥 Commits

Reviewing files that changed from the base of the PR and between c2ead92 and 2bae11d.

📒 Files selected for processing (4)

• CMakeLists.txt
• INSTALLATION.md
• docs/source/conf.py
• phlex/CMakeLists.txt

📜 Recent review details

⏰ Context from checks skipped due to timeout. (4)

• GitHub Check: Analyze cpp with CodeQL
• GitHub Check: Analyze python with CodeQL
• GitHub Check: build (gcc, none)
• GitHub Check: clang-tidy-check

⚠️ CI failures not shown inline (8)

GitHub Actions: knoepfel checking Markdown format / 0_markdown-check.txt: knoepfel checking Markdown format

Conclusion: failure

View job details

##[group]Run REPO_NAME="${REPO##*/}"
 �[36;1mREPO_NAME="${REPO##*/}"�[0m
 �[36;1mif [ "success" = "success" ]; then�[0m
 �[36;1m  echo "✅ Markdown formatting check passed."�[0m
 �[36;1melse�[0m
 �[36;1m  echo "::error::Markdown formatting check failed."�[0m

---

GitHub Actions: knoepfel checking Markdown format / markdown-check: knoepfel checking Markdown format

Conclusion: failure

View job details

##[group]Run REPO_NAME="${REPO##*/}"
 �[36;1mREPO_NAME="${REPO##*/}"�[0m
 �[36;1mif [ "success" = "success" ]; then�[0m
 �[36;1m  echo "✅ Markdown formatting check passed."�[0m
 �[36;1melse�[0m
 �[36;1m  echo "::error::Markdown formatting check failed."�[0m

---

GitHub Actions: knoepfel checking CMake format / 0_cmake-format-check.txt: knoepfel checking CMake format

Conclusion: failure

View job details

##[group]Run REPO_NAME="${REPO##*/}"
 �[36;1mREPO_NAME="${REPO##*/}"�[0m
 �[36;1mif [ "success" = 'success' ]; then�[0m
 �[36;1m  echo "✅ All CMake files are properly formatted."�[0m
 �[36;1melse�[0m
 �[36;1m  echo "::error::Found files with formatting issues."�[0m

---

GitHub Actions: knoepfel checking CMake format / cmake-format-check: knoepfel checking CMake format

Conclusion: failure

View job details

##[group]Run REPO_NAME="${REPO##*/}"
 �[36;1mREPO_NAME="${REPO##*/}"�[0m
 �[36;1mif [ "success" = 'success' ]; then�[0m
 �[36;1m  echo "✅ All CMake files are properly formatted."�[0m
 �[36;1melse�[0m
 �[36;1m  echo "::error::Found files with formatting issues."�[0m

---

GitHub Actions: knoepfel checking Python code / python-check: knoepfel checking Python code

Conclusion: failure

View job details

##[group]Run REPO_NAME="${REPO##*/}"
 �[36;1mREPO_NAME="${REPO##*/}"�[0m
 �[36;1mif [ "success" = 'success' ] && [ "success" = 'success' ]; then�[0m
 �[36;1m  echo "✅ Python checks passed."�[0m
 �[36;1melse�[0m
 �[36;1m  echo "::error::Python checks failed. Comment '@${REPO_NAME}bot python-fix' on the PR to attempt auto-fix."�[0m

---

GitHub Actions: knoepfel checking Python code / 1_python-check.txt: knoepfel checking Python code

Conclusion: failure

View job details

##[group]Run REPO_NAME="${REPO##*/}"
 �[36;1mREPO_NAME="${REPO##*/}"�[0m
 �[36;1mif [ "success" = 'success' ] && [ "success" = 'success' ]; then�[0m
 �[36;1m  echo "✅ Python checks passed."�[0m
 �[36;1melse�[0m
 �[36;1m  echo "::error::Python checks failed. Comment '@${REPO_NAME}bot python-fix' on the PR to attempt auto-fix."�[0m

---

GitHub Actions: knoepfel checking Python code / 0_scripts-test.txt: knoepfel checking Python code

Conclusion: failure

View job details

eck_codeql_alerts.py::TestMainSarifMode::test_new_alert_returns_zero_and_writes_comment PASSED [ 23%]
 scripts/test/test_check_codeql_alerts.py::TestMainSarifMode::test_absent_alert_returns_zero_and_writes_comment PASSED [ 24%]
 scripts/test/test_check_codeql_alerts.py::TestMainSarifMode::test_no_alerts_returns_zero_no_comment PASSED [ 24%]
 scripts/test/test_check_codeql_alerts.py::TestMainSarifMode::test_below_threshold_alert_not_reported PASSED [ 24%]
 scripts/test/test_check_codeql_alerts.py::TestMainSarifMode::test_missing_sarif_exits_nonzero PASSED [ 24%]
 scripts/test/test_check_codeql_alerts.py::TestMainSarifMode::test_github_output_written PASSED [ 24%]
 scripts/test/test_check_codeql_alerts.py::TestMainSarifMode::test_github_output_false_when_no_alerts PASSED [ 25%]
 scripts/test/test_check_codeql_alerts.py::TestMainSarifMode::test_directory_of_sarif_files PASSED [ 25%]
 scripts/test/test_check_codeql_alerts.py::TestMainSarifMode::test_sarif_mode_pr_ref_produces_filtered_url PASSED [ 25%]
 scripts/test/test_check_codeql_alerts.py::TestMainSarifMode::test_non_integer_pr_ref_no_filtered_url PASSED [ 25%]
 scripts/test/test_check_codeql_alerts.py::TestMainApiMode::test_api_mode_new_alert PASSED [ 25%]
 scripts/test/test_check_codeql_alerts.py::TestMainApiMode::test_api_mode_min_level_filtering PASSED [ 26%]
 scripts/test/test_check_codeql_alerts.py::TestMainApiMode::test_api_mode_github_api_error_exits_2 PASSED [ 26%]
 scripts/test/test_check_codeql_alerts.py::TestMainApiMode::test_api_mode_missing_github_repository_exits_2 PASSED [ 26%]
 scripts/test/test_check_codeql_alerts.py::TestMainApiMode::test_api_mode_skipped_when_sarif_has_baseline PASSED [ 26%]
 scripts/test/test_check_codeql_alerts.py::TestMainApiModeWithPrRef::test_api_mode_pr_ref_produces_filtered_url PASSED [ 27%]
 scripts/test/test_check_codeql_alerts.py::TestMainEntrypoint::test_entrypoint_no_alerts_exits_zero PASSED [ 27%]
 scripts/test/test_clang_tidy_check_summary.py::TestLoadDiagnostic...

---

GitHub Actions: knoepfel checking Python code / scripts-test: knoepfel checking Python code

Conclusion: failure

View job details

##[group]Run codecov/codecov-action@fb8b3582c8e4def4969c97caa2f19720cb33a72f
 with:
   files: coverage-scripts.xml
   flags: scripts
   name: phlex-scripts-coverage
   fail_ci_if_error: false
   verbose: true
   root_dir: phlex-src
   disable_file_fixes: false
   disable_search: false
   disable_safe_directory: false
   disable_telem: false
   dry_run: false
   git_service: github
   gcov_executable: gcov
   handle_no_reports_found: false
   recurse_submodules: false
   run_command: upload-coverage
   skip_validation: false
   use_legacy_upload_endpoint: false
   use_oidc: false
   use_pypi: false
   version: latest
 env:
   CODECOV_***REDACTED*** /home/runner/work/_temp/uv-python-dir
   UV_CACHE_DIR: /home/runner/work/_temp/setup-uv-cache
 ##[endgroup]
 ##[group]Run missing_deps=""
 �[36;1mmissing_deps=""�[0m
 �[36;1m�[0m
 �[36;1m# Check for always-required commands�[0m
 �[36;1mfor cmd in bash git curl; do�[0m
 �[36;1m  if ! command -v "$cmd" >/dev/null 2>&1; then�[0m
 �[36;1m    missing_deps="$missing_deps $cmd"�[0m
 �[36;1m  fi�[0m
 �[36;1mdone�[0m
 �[36;1m�[0m
 �[36;1m# Check for gpg only if validation is not being skipped�[0m
 �[36;1mif [ "$INPUT_SKIP_VALIDATION" != "true" ]; then�[0m
 �[36;1m  if ! command -v gpg >/dev/null 2>&1; then�[0m
 �[36;1m    missing_deps="$missing_deps gpg"�[0m
 �[36;1m  fi�[0m
 �[36;1mfi�[0m
 �[36;1m�[0m
 �[36;1m# Report missing required dependencies�[0m
 �[36;1mif [ -n "$missing_deps" ]; then�[0m
 �[36;1m  echo "Error: The following required dependencies are missing:$missing_deps"�[0m
 �[36;1m  echo "Please install these dependencies before using this action."�[0m
 �[36;1m  exit 1�[0m
 �[36;1mfi�[0m
 �[36;1m�[0m
 �[36;1mecho "All required system dependencies are available."�[0m
 shell: /usr/bin/sh -e {0}
 env:
   CODECOV_***REDACTED*** /home/runner/work/_temp/uv-python-dir
   UV_CACHE_DIR: /home/runner/work/_temp/setup-uv-cache
   INPUT_SKIP_VALIDATION: false
 ##[endgroup]
 All required system dependencies are available.
 ##[grou...

🧰 Additional context used

📓 Path-based instructions (3)

*

📄 CodeRabbit inference engine (.github/copilot-instructions.md)

All text files must end with exactly one newline character, with no trailing blank lines or trailing whitespace on any line

Files:

• CMakeLists.txt
• INSTALLATION.md

**/*.py

📄 CodeRabbit inference engine (.github/copilot-instructions.md)

**/*.py: Use ruff for Python formatting and linting (configured in pyproject.toml); follow Google-style docstring conventions; use line length of 99 characters; use double quotes for strings
Use from __future__ import annotations to enable deferred evaluation of type annotations (avoids forward-reference issues; Python >=3.12)
Type hints are recommended; mypy is configured in pyproject.toml
Avoid naming Python test scripts types.py or other names that shadow standard library modules, as this causes obscure import errors
Python test scripts should follow the test structure pattern: C++ driver provides data streams, Jsonnet config wires the graph, and Python script implements algorithms

**/*.py: Enforce 99-character line limit and double quotes in Python via ruff configured in pyproject.toml
Use Google-style docstrings in Python code
Use type hints in Python code and configure mypy for type checking
Use from __future__ import annotations in Python to enable deferred evaluation of type annotations
Use PEP 8 naming in Python: CapWords for classes, snake_case for everything else
When using the read tool for Python files, always use integer values for offset and limit parameters, never float/double values

Files:

• docs/source/conf.py

**/*.md

📄 CodeRabbit inference engine (.github/copilot-instructions.md)

**/*.md: All Markdown files must follow markdownlint rule MD012: no multiple consecutive blank lines (never more than one blank line in a row)
All Markdown files must follow markdownlint rule MD022: headings must be surrounded by exactly one blank line before and after
All Markdown files must follow markdownlint rule MD031: fenced code blocks must be surrounded by exactly one blank line before and after
All Markdown files must follow markdownlint rule MD032: lists must be surrounded by exactly one blank line before and after (including after headings and code blocks)
All Markdown files must follow markdownlint rule MD034: no bare URLs (use markdown link syntax like [text](destination) instead of plain URLs)
All Markdown files must follow markdownlint rule MD036: use # headings for titles, not Bold:
All Markdown files must follow markdownlint rule MD040: always specify code block language (for example, use 'bash', 'python', '```text', etc.)

**/*.md: Do not use multiple consecutive blank lines in Markdown (MD012)
Surround Markdown headings with exactly one blank line (MD022)
Surround Markdown fenced code blocks with exactly one blank line (MD031)
Surround Markdown lists with exactly one blank line (MD032)
Do not use bare URLs in Markdown; use [text](url) syntax instead (MD034)
Use # headings in Markdown, not **Bold** for section titles (MD036)
Always specify language on fenced code blocks in Markdown (MD040)

Files:

• INSTALLATION.md

🔇 Additional comments (4)

CMakeLists.txt (1)

81-81: LGTM!

INSTALLATION.md (1)

106-106: LGTM!

docs/source/conf.py (1)

9-9: LGTM!

phlex/CMakeLists.txt (1)

37-37: LGTM!

---

📝 Walkthrough

Walkthrough

This PR bumps the Phlex project version from 0.3.0 to 0.3.1 across CMakeLists.txt, INSTALLATION.md, and docs/source/conf.py, and adds driver.hpp to the list of public headers installed via phlex/CMakeLists.txt.

Changes

Version bump and header install update

Layer / File(s)	Summary
Version metadata update CMakeLists.txt, INSTALLATION.md, docs/source/conf.py	Project version, Spack install instructions, and Sphinx release string all updated from 0.3.0 to 0.3.1.
Public header install list update phlex/CMakeLists.txt	Adds driver.hpp to the installed public headers under include/phlex, alongside concurrency.hpp, module.hpp, and source.hpp.

Estimated code review effort: 1 (Trivial) | ~3 minutes

Possibly related PRs

• Framework-R-D/phlex#680: Both PRs touch the same project(phlex ...) version declaration in CMakeLists.txt.
• Framework-R-D/phlex#684: Both PRs bump version metadata in the same trio of files (CMakeLists.txt, docs/source/conf.py, INSTALLATION.md).
• Framework-R-D/phlex#693: Both PRs modify phlex/CMakeLists.txt to install driver.hpp under include/phlex.

Suggested reviewers: beojan, greenc-FNAL, marcpaterno

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly matches the version-sync changes to v0.3.1 and is concise and specific.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[greenc-FNAL]

21 fixed, 0 new since branch point (c2ead92)

✅ 21 CodeQL alerts resolved since the branch point

• ✅ Warning # 196 actions/untrusted-checkout-toctou/critical at .github/workflows/clang-tidy-fix.yaml:109:9 — Insufficient protection against execution of untrusted code on a privileged workflow (issue_comment).
• ✅ Warning # 227 actions/untrusted-checkout-toctou/high at .github/workflows/clang-format-fix.yaml:94:9 — Insufficient protection against execution of untrusted code on a privileged workflow (issue_comment).
  Insufficient protection against execution of untrusted code on a privileged workflow (issue_comment).
• ✅ Warning # 228 actions/untrusted-checkout-toctou/high at .github/workflows/python-fix.yaml:94:9 — Insufficient protection against execution of untrusted code on a privileged workflow (issue_comment).
  Insufficient protection against execution of untrusted code on a privileged workflow (issue_comment).
• ✅ Warning # 229 actions/untrusted-checkout/high at .github/workflows/clang-format-fix.yaml:94:9 — Checkout of untrusted code in a privileged workflow with later potential execution (event trigger: issue_comment).
  Checkout of untrusted code in a privileged workflow with later potential execution (event trigger: issue_comment).
• ✅ Warning # 230 actions/untrusted-checkout/high at .github/workflows/python-fix.yaml:94:9 — Checkout of untrusted code in a privileged workflow with later potential execution (event trigger: issue_comment).
  Checkout of untrusted code in a privileged workflow with later potential execution (event trigger: issue_comment).
• ✅ Warning # 231 actions/untrusted-checkout-toctou/high at .github/workflows/cmake-format-fix.yaml:94:9 — Insufficient protection against execution of untrusted code on a privileged workflow (issue_comment).
  Insufficient protection against execution of untrusted code on a privileged workflow (issue_comment).
• ✅ Warning # 232 actions/untrusted-checkout-toctou/high at .github/workflows/jsonnet-format-fix.yaml:95:9 — Insufficient protection against execution of untrusted code on a privileged workflow (issue_comment).
  Insufficient protection against execution of untrusted code on a privileged workflow (issue_comment).
• ✅ Warning # 233 actions/untrusted-checkout/high at .github/workflows/cmake-format-fix.yaml:94:9 — Checkout of untrusted code in a privileged workflow with later potential execution (event trigger: issue_comment).
  Checkout of untrusted code in a privileged workflow with later potential execution (event trigger: issue_comment).
• ✅ Warning # 234 actions/untrusted-checkout/high at .github/workflows/jsonnet-format-fix.yaml:95:9 — Checkout of untrusted code in a privileged workflow with later potential execution (event trigger: issue_comment).
  Checkout of untrusted code in a privileged workflow with later potential execution (event trigger: issue_comment).
• ✅ Warning # 235 actions/untrusted-checkout/medium at .github/workflows/clang-format-check.yaml:82:9 — Potential unsafe checkout of untrusted pull request on privileged workflow.
• ✅ Warning # 236 actions/untrusted-checkout/medium at .github/workflows/actionlint-check.yaml:86:9 — Potential unsafe checkout of untrusted pull request on privileged workflow.
• ✅ Warning # 237 actions/untrusted-checkout/medium at .github/workflows/clang-tidy-check.yaml:59:9 — Potential unsafe checkout of untrusted pull request on privileged workflow.
• ✅ Warning # 238 actions/untrusted-checkout/medium at .github/workflows/cmake-format-check.yaml:79:9 — Potential unsafe checkout of untrusted pull request on privileged workflow.
• ✅ Warning # 239 actions/untrusted-checkout/medium at .github/workflows/cmake-build.yaml:159:9 — Potential unsafe checkout of untrusted pull request on privileged workflow.
• ✅ Warning # 240 actions/untrusted-checkout/medium at .github/workflows/header-guards-check.yaml:82:9 — Potential unsafe checkout of untrusted pull request on privileged workflow.
• ✅ Warning # 241 actions/untrusted-checkout/medium at .github/workflows/jsonnet-format-check.yaml:79:9 — Potential unsafe checkout of untrusted pull request on privileged workflow.
• ✅ Warning # 242 actions/untrusted-checkout/medium at .github/workflows/markdown-check.yaml:82:9 — Potential unsafe checkout of untrusted pull request on privileged workflow.
• ✅ Warning # 243 actions/untrusted-checkout/medium at .github/workflows/python-check.yaml:84:9 — Potential unsafe checkout of untrusted pull request on privileged workflow.
• ✅ Warning # 244 actions/untrusted-checkout/medium at .github/workflows/yaml-check.yaml:76:9 — Potential unsafe checkout of untrusted pull request on privileged workflow.
• ✅ Warning # 245 actions/untrusted-checkout-toctou/high at .github/workflows/coverage.yaml:386:9 — Insufficient protection against execution of untrusted code on a privileged workflow (issue_comment).
• ✅ …and 1 more alerts (see Code Scanning for the full list).

Review the full CodeQL report for details.

[github-actions]

Clang-Tidy Check Results

Found 5790 issue(s); none are newly introduced by this patch.

All issues by check:

• readability-identifier-naming: 2132
• readability-redundant-member-init: 1361
• portability-template-virtual-member-function: 575
• performance-unnecessary-value-param: 532
• readability-avoid-const-params-in-decls: 278
• modernize-pass-by-value: 215
• readability-braces-around-statements: 123
• modernize-use-designated-initializers: 93
• readability-convert-member-functions-to-static: 85
• readability-const-return-type: 50
• modernize-use-auto: 31
• performance-move-const-arg: 29
• performance-enum-size: 24
• readability-qualified-auto: 24
• readability-redundant-control-flow: 23
• modernize-use-using: 19
• modernize-concat-nested-namespaces: 17
• modernize-use-equals-default: 17
• readability-math-missing-parentheses: 16
• modernize-avoid-c-arrays: 15
• readability-function-size: 14
• readability-static-definition-in-anonymous-namespace: 14
• bugprone-branch-clone: 12
• modernize-return-braced-init-list: 10
• readability-isolate-declaration: 8
• modernize-use-starts-ends-with: 8
• readability-redundant-access-specifiers: 7
• cppcoreguidelines-special-member-functions: 7
• readability-container-size-empty: 7
• modernize-use-ranges: 6
• readability-inconsistent-declaration-parameter-name: 6
• bugprone-throw-keyword-missing: 6
• readability-redundant-casting: 5
• readability-container-contains: 5
• modernize-use-std-numbers: 3
• readability-use-anyofallof: 2
• modernize-use-integer-sign-comparison: 2
• readability-else-after-return: 2
• modernize-redundant-void-arg: 1
• modernize-use-emplace: 1
• readability-simplify-boolean-expr: 1
• modernize-make-shared: 1
• performance-avoid-endl: 1
• cppcoreguidelines-rvalue-reference-param-not-moved: 1
• readability-redundant-string-init: 1

See inline comments for details. Comment @phlexbot tidy-fix to auto-fix.