Repository navigation
ci: configure Copilot cloud agent development environment - #240
Merged
Merged
Conversation
Prepare Python 3.11 with locked development dependencies, optional PyArrow, and documentation tooling. Document environment usage and validation. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Contributor
There was a problem hiding this comment.
🟢 Approval recommended
No active review issues were identified in the Copilot development-environment setup and documentation changes.
No open issues 🎉
What changed in this PR
Adds a reproducible development environment for Copilot cloud agents without changing the project's minimum Python version or existing CI configuration.
Changes:
- Adds an Ubuntu setup workflow with Python 3.11, Poetry 2.5.1, caching, locked development dependencies, optional extras, and documentation tooling.
- Includes lightweight readiness checks, manual execution, and path-filtered pull request validation.
- Documents environment usage, validation commands, activation requirements, and integration-test limitations.
| File | Description |
|---|---|
| CONTRIBUTING.md | Documents the Copilot environment, validation commands, and setup limitations. |
| .github/workflows/copilot-setup-steps.yml | Configures dependency installation and readiness checks for Copilot sessions. |
Review effort: Balanced
cameronwaterman
approved these changes
Oct 29, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What does this Pull Request accomplish?
copilot-setup-stepsworkflow to prepare an Ubuntu environment with Python 3.11 and Poetry 2.5.1.Why should this Pull Request be merged?
Copilot cloud agents can start with the tools needed to develop, test, and build documentation without discovering and installing dependencies by trial and error.
The workflow uses Python 3.11 in preparation for the separate minimum-version update; this PR does not change the project's minimum Python version, lockfile, existing CI, or Read the Docs configuration. It does not expose integration or release credentials or run the full suite during every agent startup.
The setup applies to Copilot sessions running on GitHub Actions and must be merged into the default branch for normal activation.
What testing has been done?
Local validation used Windows and Python 3.10.11. The final workflow selects Python 3.11; a hosted Ubuntu/Python 3.11 workflow or agent session has not been run locally.
git diff --checkandgit diff --cached --check: passed..\.venv\Scripts\python.exe -: passed; verified the required job, supported settings, read-only permissions, path filters, Python 3.11, caching, absence of secrets/failure suppression, and matching contributor documentation..\.venv\Scripts\python.exe -m pip check: passed; no broken requirements..\.venv\Scripts\python.exe -m pytest tests -m '(not slow) and (not cloud) and (not enterprise)' -q: passed; 399 passed, 26 skipped, 278 deselected..\.venv\Scripts\sphinx-build.exe -b html docs 'C:\Users\rbell\.copilot\session-state\0a617ac6-2994-4519-95f1-7e0189b7c971\files\copilot-pr-docs-html': passed with 193 existing documentation warnings.The existing
poetry run poe testtask encountered Windows marker-expression quoting trouble; the equivalent direct pytest selection above passed. Formatting, lint, type-checking, doctests, and credentialed integration suites were not rerun for these workflow/documentation changes.