Skip to content

[1/5] Plan SDK evolution demo reliability repairs - #51

Merged
ebarti merged 1 commit into
mainfrom
agent/sdk-evolution-demo-reliability-plan
Jul 28, 2026
Merged

[1/5] Plan SDK evolution demo reliability repairs#51
ebarti merged 1 commit into
mainfrom
agent/sdk-evolution-demo-reliability-plan

Conversation

@ebarti

@ebarti ebarti commented Jul 13, 2026

Copy link
Copy Markdown
Owner

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 Add reusable SDK evolution upgrade script #19 and Overhaul SDK evolution workflow #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

@ebarti
ebarti marked this pull request as ready for review July 28, 2026 16:48
@ebarti
ebarti merged commit f030ebb into main Jul 28, 2026
11 checks passed
@ebarti
ebarti deleted the agent/sdk-evolution-demo-reliability-plan branch July 28, 2026 17:53
ebarti added a commit that referenced this pull request Jul 28, 2026
## Summary

- treat `uv.lock` as the authoritative SDK baseline during explicit
candidate inspection
- isolate locked baselines when the matching SDK is absent or the
ambient environment has drifted
- keep non-opt-in runs honest by recording the actual ambient version
instead of stamping it as locked
- convert isolated API snapshot setup, install, execution, timeout, and
malformed-output failures into bounded evidence

## Stack

- Depends on #51
- This is layer 2 of 5 in the SDK evolution demo reliability stack

## Review boundary

This layer repairs baseline provenance and snapshot collection only.
Behavior-probe subprocess failures and the final `fail > incomplete >
changed > pass` assessment are intentionally implemented together in the
next layer so incomplete evidence cannot temporarily appear green.

## Validation

- `PYTHONPATH=. .venv/bin/python -m pytest -q` — 421 passed, 12 skipped
- `.venv/bin/ruff check .`
- `.venv/bin/mypy`
- `uv lock --check`
- `git diff --check`
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant