Skip to content

fix(ci): deploy docs after dependency and workflow updates - #4976

Merged
jbeckwith-oai merged 4 commits into
mainfrom
dependabot/uv/mkdocs-material-9.7.7
Sep 13, 2026
Merged

jbeckwith-oai merged 4 commits into
mainfrom
dependabot/uv/mkdocs-material-9.7.7

Conversation

@dependabot

@dependabot dependabot Bot commented on behalf of github Sep 12, 2026 •

Copy link
Copy Markdown
Contributor

Summary

This pull request fixes docs deployment after dependency and deployment-workflow updates. Changes to uv.lock or .github/workflows/docs.yml select docs build and publication even in mixed pushes, so this workflow fix itself publishes the Material 9.7.7 assets already locked on main. Other pushes retain the existing docs-only policy, and missing or failed commit/diff evidence cannot authorize deployment.

Dependency installation and the frozen docs build run with contents: read and no persisted checkout credentials. A separate contents: write job downloads the same-run static artifact and publishes it to the existing gh-pages branch without installing dependencies or executing artifact code. Static copying excludes Git metadata. Runs are serialized with queued runs retained.

No SDK runtime, dependency, or hosting configuration changes.

Test plan

  • 55 focused tests, including the workflow detector, permissions, and actual publisher command against a local Git remote.
  • Two consecutive clean independent review rounds after the final correction, with two fresh reviewers each.
  • Full verification passed: formatting, lint, Mypy, Pyright, and 9,668 tests. Native macOS coverage runs in hosted CI.
  • make build-docs passed with Material 9.7.7.
  • Full-site local publishing rehearsal passed: all 1,198 published files matched generated output. No production deployment was performed locally.

Checks

  • I've added new tests, if relevant
  • I've run .agents/skills/code-change-verification/scripts/run.sh
  • I've confirmed all verification steps pass
  • If using Codex, I've run /review before submitting this PR

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

Copy link
Copy Markdown

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: 60fbd0e790

ℹ️ About Codex in GitHub

Codex has been enabled to automatically 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 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

Comment thread uv.lock Resolved
@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Sep 12, 2026 •

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-09-13T23:12:59.163498Z 901e5c8 New commits
🔒 Security Review ✅ Completed 2026-09-13T23:14:27.269495Z 901e5c8 New commits

Security findings

Advisory findings (1)

ℹ️ 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" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

HAYDEN-OAI
HAYDEN-OAI previously approved these changes Sep 12, 2026

@HAYDEN-OAI HAYDEN-OAI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

No actionable findings in the complete four-file diff at 9ee753346d4199b0bda9b8c5c64b6013543fffed. The previous redeployment concern is addressed: uv.lock selects the docs build and main-branch deployment even in mixed pushes, while missing commits or failed diffs still deny deployment. Pushes without a lockfile change retain the existing docs-only behavior.

Reviewed the detector and its callers, workflow privilege boundaries, complete lockfile changes, current docs configuration, and published Material 9.7.7 artifacts. The non-Material marker edits preserve reachable Python environments; the retained dependencies satisfy the upgraded theme's requirements. Both Material artifact hashes match the lockfile and PyPI metadata. The published search-suggestion advisory is fixed in 9.7.7, but search.suggest is not enabled here, so this review does not establish that the prior site was exploitable.

Static source/metadata/artifact review only. No installation, builds, tests, lint, CI or mergeability assessment, workflow execution, or live deployed-asset verification. Published provenance metadata was inspected, not its complete Sigstore certificate/transparency chain.

markstuart-oai
markstuart-oai previously approved these changes Sep 13, 2026

@markstuart-oai markstuart-oai left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

No actionable findings in the four-file diff at 9ee753346d4199b0bda9b8c5c64b6013543fffed. Reviewed the dependency update, docs build/deployment triggers, mixed lockfile pushes, and failure handling. The implementation preserves docs-only deployment behavior when no lockfile changes are present and refuses deployment when commit/diff evidence is unavailable.

Validation: 41 independent synthetic detector cases passed; all 22 hosted checks succeeded. The docs build installed Material 9.7.7 and completed. No local dependency installation or live deployment was performed.

@seratch

seratch commented Sep 13, 2026

Copy link
Copy Markdown
Member

@dependabot rebase plz

@dependabot @github

dependabot Bot commented on behalf of github Sep 13, 2026

Copy link
Copy Markdown
Contributor Author

Looks like this PR has been edited by someone other than Dependabot. That means Dependabot can't rebase it - sorry!

If you're happy for Dependabot to recreate it from scratch, overwriting any edits, you can request @dependabot recreate.

seratch
seratch previously approved these changes Sep 13, 2026

@seratch seratch left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

@jbeckwith-oai Once the conflicts are resolved, this looks good to me

@jbeckwith-oai jbeckwith-oai changed the title chore(deps-dev): bump mkdocs-material from 9.6.16 to 9.7.7 fix(ci): deploy docs after lockfile updates Sep 13, 2026
@jbeckwith-oai

Copy link
Copy Markdown
Contributor

Summary

This pull request fixes docs deployment after dependency lockfile changes. Changes to uv.lock now select the docs build and main-branch deployment, including pushes that also change code or CI. Pushes without lockfile changes retain the existing docs-only deployment policy; unavailable commit or diff evidence cannot authorize deployment.

Merged current main to resolve the conflict. Material 9.7.7 is already present on main, so this PR preserves its lockfile exactly. The remaining diff contains only the detector, docs workflow, and regression tests. This merge itself has no docs or lockfile change and therefore does not trigger immediate publication.

Test plan

  • 50 focused change-detection tests passed.
  • Two consecutive independent adversarial-review rounds, two fresh reviewers each; no blocking findings.
  • Full verification passed: formatting, lint, Mypy, Pyright, and 9,663 tests. Native macOS coverage runs in hosted CI.
  • make build-docs passed with Material 9.7.7.
  • Earlier end-to-end rehearsal exercised the real publishing command against a local bare remote, validated published assets, and checked browser navigation/search. Live publication is separate.

Checks

  • I've added new tests, if relevant
  • I've run .agents/skills/code-change-verification/scripts/run.sh
  • I've confirmed all verification steps pass
  • If using Codex, I've run /review before submitting this PR

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

Copy link
Copy Markdown

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: 07a0d59e60

ℹ️ 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 thread .github/workflows/docs.yml Resolved

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

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

🛡️ Codex Security Review · Automatically triggered

Here are some automated security review suggestions for this pull request.

Reviewed commit: 07a0d59e60

ℹ️ About Codex security reviews in GitHub

This is an experimental Codex feature. Security reviews are triggered when:

  • You comment "@codex security review"
  • A regular code review gets triggered (for example, "@codex review" or when a PR is opened), and you’re opted in so security review runs alongside code review

Once complete, Codex will leave suggestions, or a comment if no findings are found.

Comment thread .github/scripts/detect-changes.sh Resolved
@jbeckwith-oai
jbeckwith-oai enabled auto-merge (squash) September 13, 2026 22:44
@jbeckwith-oai jbeckwith-oai changed the title fix(ci): deploy docs after lockfile updates fix(ci): deploy docs after dependency and workflow updates Sep 13, 2026

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

Copy link
Copy Markdown

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: 901e5c81c5

ℹ️ 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 thread .github/workflows/docs.yml Resolved
@jbeckwith-oai
jbeckwith-oai merged commit c8c0763 into main Sep 13, 2026
22 checks passed
@jbeckwith-oai
jbeckwith-oai deleted the dependabot/uv/mkdocs-material-9.7.7 branch September 13, 2026 23:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants