Skip to content

Expose compatibility-date.capnp and add AGENTS.md guidance for new APIs - #7274

Merged
harrishancock merged 2 commits into
mainfrom
harris/EW-10964-snapshot-global-scope
Sep 9, 2026
Merged

Expose compatibility-date.capnp and add AGENTS.md guidance for new APIs#7274
harrishancock merged 2 commits into
mainfrom
harris/EW-10964-snapshot-global-scope

Conversation

@harrishancock

@harrishancock harrishancock commented Sep 8, 2026

Copy link
Copy Markdown
Collaborator

The intent here is to prevent a recurrence of #6907.

An internal test will surface new APIs for compatibility review, with either a compatibility flag or explicit risk acceptance as valid outcomes. In order to write that test, we need to expose compatibility-date.capnp, so we can easily enumerate every existing non-experimental compatibility flag. We can't just use future compatibility dates to "enable everything", because many flags have no enable-date, and we want to guarantee their API stability, too.

@harrishancock
harrishancock requested review from a team as code owners September 8, 2026 11:40
@ask-bonk

ask-bonk Bot commented Sep 8, 2026

Copy link
Copy Markdown
Contributor

LGTM

github run

Comment thread AGENTS.md Outdated
Comment thread AGENTS.md Outdated
Comment thread AGENTS.md
Comment thread src/workerd/io/BUILD.bazel Outdated
@harrishancock
harrishancock force-pushed the harris/EW-10964-snapshot-global-scope branch from 99d44e2 to 9b15a33 Compare September 8, 2026 16:29
@github-actions

github-actions Bot commented Sep 8, 2026

Copy link
Copy Markdown

The generated output of @cloudflare/workers-types matches the snapshot in types/generated-snapshot 🎉

The global-scope snapshot needs flag names, including flags with no
enable date. Export the schema source so a text-based build rule can
read those names without a compiled helper.

Assisted-by: Codex:gpt-6
A new global can switch existing Workers from a polyfill to the runtime
implementation without any action by their authors. Require an explicit
compatibility decision for API enablements, including those caused by
V8 flags or upstream defaults.

Assisted-by: Codex:gpt-6
@harrishancock
harrishancock force-pushed the harris/EW-10964-snapshot-global-scope branch from 9b15a33 to 3e8e74b Compare September 8, 2026 16:58
@codecov-commenter

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 37.33%. Comparing base (6637171) to head (3e8e74b).

Additional details and impacted files
@@            Coverage Diff             @@
##             main    #7274      +/-   ##
==========================================
- Coverage   37.56%   37.33%   -0.24%     
==========================================
  Files         801      801              
  Lines      253637   251822    -1815     
  Branches    20021    20021              
==========================================
- Hits        95286    94011    -1275     
+ Misses     146993   146453     -540     
  Partials    11358    11358              

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

@harrishancock
harrishancock merged commit 360a40d into main Sep 9, 2026
22 of 23 checks passed
@harrishancock
harrishancock deleted the harris/EW-10964-snapshot-global-scope branch September 9, 2026 15:09
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.

5 participants