Skip to content

Improve plan readiness semantics and npm release resilience#20

Merged
heimanba merged 2 commits into
mainfrom
codex/plan-readiness-release-resilience
Jul 17, 2026
Merged

Improve plan readiness semantics and npm release resilience#20
heimanba merged 2 commits into
mainfrom
codex/plan-readiness-release-resilience

Conversation

@heimanba

Copy link
Copy Markdown
Contributor

Summary

  • classify Agent readiness from structured readinessImpact and changedPaths instead of parsing human-readable reason text
  • persist hash-only readiness baselines and remote drift paths, and expose the structured fields through the SDK/OpenAPI contract
  • tolerate npm registry propagation for up to 15 minutes with online queries and actionable retry diagnostics
  • cap the registry readiness job at 20 minutes and cover the release policy with regression tests

Why

Readiness decisions were coupled to display text such as “description” or “metadata”, which made localized or reworded plan reasons capable of changing runtime behavior. Separately, npm packages could publish successfully but take longer than the five-minute registry visibility window, causing the release workflow to fail after publication and skip consumer certification and GitHub Release creation.

Impact

Description- and metadata-only updates remain non-blocking, while operational and unknown changes fail closed as blocking. Stored readiness baselines contain only irreversible hashes. npm releases continue to gate GitHub Release creation on registry visibility and cross-platform consumer tests, but normal propagation delays no longer produce premature failures.

Validation

  • bun run verify:release
  • pre-push bun scripts/verify.ts push
  • live registry check for @openagentpack/{sdk,playground,cli}@0.1.0

heimanba added 2 commits July 17, 2026 12:02
Change-Id: I2fda5eedb254b1b2caa0a624b45a96d496db530d
Change-Id: I329bd0b0f21f7ded2bf21671cdead6a264aab0f0
@heimanba
heimanba marked this pull request as ready for review July 17, 2026 04:30
@heimanba
heimanba merged commit ba1af83 into main Jul 17, 2026
15 checks passed
@heimanba
heimanba deleted the codex/plan-readiness-release-resilience branch July 17, 2026 04:30
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