Add reusable SDK evolution upgrade script - #19
Open
ebarti wants to merge 6 commits into
Open
Conversation
ebarti
added a commit
that referenced
this pull request
Jul 28, 2026
## Summary - records the reproduced false-green and missing-baseline failure modes on current `main` - defines the evidence invariants, First Principles model, Five Whys, and owning fix layers - lays out a five-PR delivery stack with exact files, tests, acceptance criteria, and report-only rehearsals - keeps the replacement stack independent of stale open PRs #19 and #40 ## Why The Agent SDK stages execute successfully, but the documented evolution workflow can label ambient import failures as locked SDK evidence, collapse incomplete probes into a passing headline, and permanently fail CLI-binary snapshots through the wrong module name. The repair needs to preserve the explicit candidate-inspection and credential-scrubbing boundary while making the supported command actionable. ## Stack This is PR 1 of 5 and contains planning documentation only. The implementation branches will be based in order on this branch: 1. truthful locked-baseline collection 2. fail-closed evidence summaries and exact transition gates 3. Codex CLI binary introspection 4. actionable runtime-specific operator commands and documentation conformance ## Validation - `git diff --cached --check` - reviewed against `origin/main` at `2e7e4c3` - checked against the current implementation, tests, documentation, and live PR topology
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
1 participant
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.
Summary
scripts/sdk_evolution_upgrade.pyas the canonical local upgrade runnerclaude-agent-sdk,openai-codex,openai-codex-cli-bin, andgoogle-antigravitygit worktree addcommands--report-onlyis set.codexand.claudeupgrade surfaces to thin wrappers that call the scriptValidation
env -u UV_EXCLUDE_NEWER -u UV_EXCLUDE_NEWER_PACKAGE uv run python scripts/sdk_evolution_upgrade.py --helpenv -u UV_EXCLUDE_NEWER -u UV_EXCLUDE_NEWER_PACKAGE uv run ruff check .env -u UV_EXCLUDE_NEWER -u UV_EXCLUDE_NEWER_PACKAGE uv run mypyenv -u UV_EXCLUDE_NEWER -u UV_EXCLUDE_NEWER_PACKAGE uv run pytestenv -u UV_EXCLUDE_NEWER -u UV_EXCLUDE_NEWER_PACKAGE uv run --with pyyaml python /Users/eloibarti/.codex/skills/.system/skill-creator/scripts/quick_validate.py .codex/skills/agent-runtime-kit-upgradegit diff --check origin/main...HEAD