Skip to content

Improve dev workflow documentation and tooling#74

Merged
markcoleman merged 1 commit intomainfrom
dev-ex
Feb 22, 2026
Merged

Improve dev workflow documentation and tooling#74
markcoleman merged 1 commit intomainfrom
dev-ex

Conversation

@markcoleman
Copy link
Copy Markdown
Owner

Summary

  • refresh workflow and agent guidance across .github and top-level docs to match the updated dev experience goals
  • document AI-assisted workflow assets and developer setup steps, ensuring references such as AGENTS.md, README.md, and docs/ai/CODEX_WORKFLOW.md stay aligned
  • add automation tweaks via updated workflow/YAML files plus scripts to support cleaner CI/DEVOPS operations

Testing

  • Not run (not requested)

@github-actions
Copy link
Copy Markdown
Contributor

⚠️ This PR is very large. Consider breaking it into smaller PRs for easier review.

PR Stats:

  • Lines added: 300
  • Lines deleted: 1099
  • Files changed: 21

Tips for large PRs:

  • Break into smaller, focused PRs
  • Ensure comprehensive test coverage
  • Add detailed descriptions for each change

@github-actions github-actions Bot added size/extra-large documentation Improvements or additions to documentation ci security labels Feb 22, 2026
Copy link
Copy Markdown

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: ea77e23779

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment on lines +6 to +12
paths:
- 'Sources/**'
- 'Tests/**'
- 'Package.swift'
- '.swiftlint.yml'
- 'scripts/pre-commit-check.sh'
- '.github/workflows/ios-ci.yml'
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Trigger iOS CI on toolchain pin updates

The new paths filter omits .xcode-version, so a PR that only updates the pinned Xcode version will skip this workflow entirely and merge without running lint/build/tests under the new toolchain. Because this file is the repo’s toolchain source-of-truth, excluding it from the trigger can hide breakage until a later unrelated change touches a tracked path.

Useful? React with 👍 / 👎.

Comment on lines +53 to +57
REQUIRED_SWIFT_MAJOR=$(echo "$REQUIRED_SWIFT_TOOLS" | cut -d. -f1)
if command -v swift >/dev/null 2>&1; then
SWIFT_VERSION=$(swift --version 2>/dev/null | head -n 1 || echo "unknown")
if [[ "$SWIFT_VERSION" == *"5.9"* ]] || [[ "$SWIFT_VERSION" == *"5.10"* ]] || [[ "$SWIFT_VERSION" == *"6."* ]]; then
print_status 0 "Swift version meets minimum requirement (5.9+)"
INSTALLED_SWIFT_MAJOR=$(echo "$SWIFT_VERSION" | sed -E 's/.*Swift version ([0-9]+)\..*/\1/' || echo "0")
if [[ "$INSTALLED_SWIFT_MAJOR" =~ ^[0-9]+$ ]] && [ "$INSTALLED_SWIFT_MAJOR" -ge "$REQUIRED_SWIFT_MAJOR" ]; then
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Compare full Swift tools version, not only major

This check only compares major versions, so with // swift-tools-version: 6.2 an installed Swift 6.0 or 6.1 is reported as compatible even though it does not satisfy the package tools requirement. That gives a misleading “version matches” result and defeats the script’s CI-parity goal for developers on older minor releases.

Useful? React with 👍 / 👎.

@markcoleman markcoleman merged commit 8c2a134 into main Feb 22, 2026
7 checks passed
@markcoleman markcoleman deleted the dev-ex branch February 22, 2026 15:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

ci documentation Improvements or additions to documentation security size/extra-large

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant