Merge branch 'master' into advance-rfc-0830

Author: ef4

.github/PULL_REQUEST_TEMPLATE/advance-to-ready-for-release.md

@@ -1,5 +1,7 @@
 # Advance #__RFC_NUMBER__ to the [Ready For Release Stage](https://github.com/emberjs/rfcs#ready-for-release)
 
+## [Rendered](__RFC_RENDERED_URL__)
+
 ## Summary
 
 This pull request is advancing the RFC to the [Ready For Release Stage](https://github.com/emberjs/rfcs#ready-for-release).
@@ -28,16 +30,18 @@ Each Ember core team will be requested as a reviewer on the PR to move into this
 
 - [ ] Implementation is complete according to plan outlined in the RFC, with any adjustments noted in the RFC
 - [ ] Any necessary learning materials have been updated
-- [ ] The Ember team is ready to commit to the stability of any interfaces exposed by the current implementation of the feature 
+- [ ] The Ember team is ready to commit to the stability of any interfaces exposed by the current implementation of the feature. This is the go/no go decision for any feature flags, but the flags should only be turned on when moving to Released.
+- [ ] The feature may not yet have support by the entire ecosystem (e.g. IDEs, addons, Ember Inspector, Engines, Lint Rules, Blueprints, etc), but it does not unintentionally break any existing functionality in those areas.
+- [ ] The Interactive Tutorial is not broken by this feature.
 - [ ] Criteria for moving to the Recommended Stage has been filled out
 - [ ] This PR has been converted from a draft to a regular PR and the `Final Comment Period` label has been added to start the FCP
-- [ ] Each [team](https://github.com/emberjs/rfcs#relevant-teams) has been added as a reviewer to the PR at the start of the FCP
-  * [ ] Framework @emberjs/framework
-  * [ ] Data @emberjs/ember-data-core
-  * [ ] CLI @emberjs/cli
-  * [ ] Learning @emberjs/learning-core
-  * [ ] Typescript @emberjs/typescript-core
-  * [ ] Steering @emberjs/steering
+- [ ] Each [team](https://github.com/emberjs/rfcs#relevant-teams) has been added as a reviewer to the PR at the start of the FCP. Reviews are not required by the end of the FCP. This is a notification step.
+  * Framework @emberjs/framework
+  * Data @emberjs/ember-data-core
+  * CLI @emberjs/cli
+  * Learning @emberjs/learning-core
+  * Typescript @emberjs/typescript-core
+  * Steering @emberjs/steering
 
 
 ## Criteria for moving to Recommended (required)

.github/PULL_REQUEST_TEMPLATE/advance-to-recommended.md

@@ -1,5 +1,7 @@
 # Advance #__RFC_NUMBER__ to the [Recommended Stage](https://github.com/emberjs/rfcs#recommended)
 
+## [Rendered](__RFC_RENDERED_URL__)
+
 ## Summary
 
 This pull request is advancing the RFC to the [Recommended Stage](https://github.com/emberjs/rfcs#recommended).
@@ -35,13 +37,21 @@ An FCP is required to enter this stage. Multiple RFCs may be moved as a batch in
 
 ## Checklist to move to Recommended
 
-- [ ] Any criteria for "Recommended" for this proposal that were established in the Ready For Release stage have been met
-- [ ] If appropriate, the feature is integrated into the tutorial and the guides prose. API documentation is polished and updates are carried through to other areas of API docs that may not directly pertain to the feature.
-- [ ] If the proposal replaces an existing feature, the addon ecosystem has largely updated to work with both old and new features.
-- [ ] If the proposal updates or replaces an existing feature, high-quality codemods are available
-- [ ] If needed, Ember debugging tools as well as popular IDE support have been updated to support the feature.
-- [ ] If the feature is part of a suite of features that were designed to work together for best ergonomics, the other features are also ready to be "Recommended".
-- [ ] This PR has been converted from a draft to a regular PR and the `Final Comment Period` label has been added to start the FCP
+- [ ] **Criteria specific to this feature:** Any additional criteria for "Recommended" for this proposal that were established in the Ready For Release stage have been met.
+- [ ] **Tutorial:** If appropriate, the feature is integrated into the tutorial.
+- [ ] **Guides:** If appropriate, the feature is integrated into the guides prose. 
+- [ ] **API Docs:** API documentation is polished and updates are carried through to other areas of API docs that may not directly pertain to the feature.
+- [ ] **Addon Ecosystem:** If the proposal replaces an existing feature, the addon ecosystem has largely updated to work with both old and new features.
+- [ ] **Codemods:** If the proposal updates or replaces an existing feature, high-quality codemods are available.
+- [ ] **Debugging Tools:** If needed, Ember debugging tools (e.g. Ember Inspector, Deprecation Workflow) have been updated to support the feature.
+- [ ] **IDE Support:** If needed, popular IDE support has been updated to support the feature.
+- [ ] **Engines, SSR:** If needed, ecosystem feature such as Ember Engines, SSR support have been updated to support the feature.
+- [ ] **Blueprints:** Blueprints have been updated to support the feature and to reflect the new best practices implied by this feature.
+- [ ] **Linting:** Lint rules have been updated or added or removed to support the feature and to reflect the new best practices implied by this feature.
+- [ ] **Deprecations:** If this feature implies that other features are no longer best practice, RFCs have been created to deprecate those features.
+- [ ] **Blog Post:** Consider if a blog post should be written to introduce this feature to the community.
+- [ ] **Feature Suite:** If the feature is part of a suite of features that were designed to work together for best ergonomics, the other features are also ready to be "Recommended".
+- [ ] **FCP to Recommended:** This PR has been converted from a draft to a regular PR and the `Final Comment Period` label has been added to start the FCP.
 
 ## Criteria for moving to Recommended (required)
 

.github/PULL_REQUEST_TEMPLATE/advance-to-released.md

@@ -1,5 +1,7 @@
 # Advance #__RFC_NUMBER__ to the [Released Stage](https://github.com/emberjs/rfcs#released)
 
+## [Rendered](__RFC_RENDERED_URL__)
+
 ## Summary
 
 This pull request is advancing the RFC to the [Released Stage](https://github.com/emberjs/rfcs#released).
@@ -23,6 +25,6 @@ An RFC is moved into "Released" when the above is verified by consensus of the r
 
 ## Checklist to move to Released
 
-- [ ] The work is published in stable versions of the relevant package(s)
+- [ ] The work is published in stable versions of the relevant package(s), with any feature flags toggled on.
 - [ ] Deviations from the original RFC are noted in the RFC
 - [ ] Release packages and dates are updated in the RFC frontmatter

.github/actions/find-added-or-modified-rfcs/action.yml

@@ -17,31 +17,20 @@ outputs:
     value: ${{ steps.modified-rfc.outputs.path }}
   modified-rfcs-count:
     description: "The count of how many RFCs were added or modified"
-    value: ${{ steps.counts.outputs.all_changed }}
+    value: ${{ steps.rfcs.outputs.all_changed_files_count }}
   added-rfcs-count:
     description: "The count of how many RFCs that were added"
-    value: ${{ steps.counts.outputs.added }}
+    value: ${{ steps.rfcs.outputs.added_files_count }}
 
 runs:
   using: "composite"
   steps:
     - name: Find added or modified RFCs
       id: rfcs
-      uses: tj-actions/changed-files@v31
+      uses: tj-actions/changed-files@v39
       with:
-        path: 'text'
-        json: 'true'
-        sha: ${{ inputs.sha }}
-        base_sha: ${{ inputs.base-sha }}
-
-    - name: Get counts of changed and added RFCs
-      id: counts
-      shell: bash
-      run: |
-        changed_len=`echo "${{ steps.rfcs.outputs.all_changed_files }}" | jq '. | length'`    
-        echo "all_changed=$changed_len" >> $GITHUB_OUTPUT
-        added_len=`echo "${{ steps.rfcs.outputs.added_files }}" | jq '. | length'`
-        echo "added=$added_len" >> $GITHUB_OUTPUT
+        files: text
+        json: true
 
     - name: Find modified or added RFC info
       id: modified-rfc

.github/actions/setup-rfcs-tooling/action.yml

@@ -9,7 +9,7 @@ runs:
       with:
         repository: emberjs/rfcs-tooling
         path: rfcs-tooling
-        ref: 'v2.1.1'
+        ref: 'v3.0.0'
 
     - uses: actions/setup-node@v3
       with:

.github/pull_request_template.md

@@ -0,0 +1,61 @@
+<!-- If you are proposing a new RFC, please fill out the below template. 
+If not, please remove the below contents
+-->
+
+# Propose {{RFC_NAME}}
+
+<!-- Update the below to link to the rendered version of your RFC. 
+The URL can be interpolated below or can be found by going to the files tab
+and choosing `View file' from the `...' menu in the right hand corner of the file. -->
+
+## [Rendered](https://github.com/{{username}}/rfcs/blob/{{branch}}/text/{{rfc_number}}-{{rfc_slug}}.md)
+
+## Summary
+
+This pull request is proposing a new RFC.
+
+To succeed, it will need to pass into the [Exploring Stage](https://github.com/emberjs/rfcs#exploring), followed by the [Accepted Stage](https://github.com/emberjs/rfcs#accepted).
+
+A Proposed or Exploring RFC may also move to the [Closed Stage](https://github.com/emberjs/rfcs#closed) if it is withdrawn by the author or if it is rejected by the Ember team. This requires an "FCP to Close" period.
+
+**An FCP is required before merging this PR to advance to Accepted.**
+
+Upon merging this PR, automation will open a draft PR for this RFC to move to the [Ready for Released Stage](https://github.com/emberjs/rfcs#ready-for-release).
+
+<details>
+  <summary>Exploring Stage Description</summary>
+
+This stage is entered when the Ember team believes the concept described in the RFC should be pursued, but the RFC may still need some more work, discussion, answers to open questions, and/or a champion before it can move to the next stage.
+
+An RFC is moved into Exploring with consensus of the relevant teams. The relevant team expects to spend time helping to refine the proposal. The RFC remains a PR and will have an `Exploring` label applied.
+
+An Exploring RFC that is successfully completed can move to [Accepted](https://github.com/emberjs/rfcs#accepted) with an FCP is required as in the existing process. It may also be moved to [Closed](https://github.com/emberjs/rfcs#closed) with an FCP.
+</details>
+
+<details>
+  <summary>Accepted Stage Description</summary>
+
+To move into the "accepted stage" the RFC must have complete prose and have successfully passed through an "FCP to Accept" period in which the community has weighed in and consensus has been achieved on the direction. The relevant teams believe that the proposal is well-specified and ready for implementation. The RFC has a champion within one of the relevant teams.
+
+If there are unanswered questions, we have outlined them and expect that they will be answered before [Ready for Release](https://github.com/emberjs/rfcs#ready-for-release). 
+
+When the RFC is accepted, the PR will be merged, and automation will open a new PR to move the RFC to the [Ready for Release](https://github.com/emberjs/rfcs#ready-for-release) stage. That PR should be used to track implementation progress and gain consensus to move to the next stage.
+
+</details>
+
+## Checklist to move to Exploring
+
+- [ ] The team believes the concepts described in the RFC should be pursued.
+- [ ] The label `S-Proposed` is removed from the PR and the label `S-Exploring` is added. 
+- [ ] The Ember team is willing to work on the proposal to get it to Accepted
+
+## Checklist to move to Accepted
+
+- [ ] This PR has had the `Final Comment Period` label has been added to start the FCP
+- [ ] The RFC is announced in #news-and-announcements in the Ember Discord.
+- [ ] The RFC has complete prose, is well-specified and ready for implementation.
+  - [ ] All sections of the RFC are filled out.
+  - [ ] Any unanswered questions are outlined and expected to be answered before Ready for Release.
+  - [ ] "How we teach this?" is sufficiently filled out.
+- [ ] The RFC has a champion within one of the relevant teams.
+- [ ] The RFC has consensus after the FCP period.

.github/workflows/advance-rfc.yml

@@ -26,8 +26,6 @@ jobs:
       - name: RFCs Added or Changed
         id: rfcs
         uses: ./.github/actions/find-added-or-modified-rfcs
-        with:
-          base-sha: ${{ github.event.before }}
 
       - name: Fail if more than 1 RFC is added or modified
         if: steps.rfcs.outputs.modified-rfcs-count > 1
@@ -55,7 +53,7 @@ jobs:
             echo "A new RFC was added"        
             echo "value=true" >> $GITHUB_OUTPUT
           else
-            node rfcs-tooling/has-stage-changed.js ${{ github.event.before }} ${{ steps.rfcs.outputs.modified-rfc }}
+            node rfcs-tooling/scripts/has-stage-changed.mjs ${{ github.event.before }} ${{ steps.rfcs.outputs.modified-rfc }}
             if [[ $? == 0 ]]; then
               echo "## Yes, stage has changed" >> $GITHUB_STEP_SUMMARY
               echo "value=true" >> $GITHUB_OUTPUT
@@ -69,7 +67,7 @@ jobs:
         if: steps.has-stage-changed.outputs.value == 'true'
         id: new-stage
         run: |
-          new_stage=`node rfcs-tooling/find-next-stage.js ${{ steps.rfcs.outputs.modified-rfc }}`
+          new_stage=`node rfcs-tooling/scripts/find-next-stage.mjs ${{ steps.rfcs.outputs.modified-rfc }}`
           echo "New Stage: $new_stage"
           echo "value=$new_stage" >> $GITHUB_OUTPUT
 

.github/workflows/ci.yml

@@ -15,4 +15,4 @@ jobs:
         uses: ./.github/actions/setup-rfcs-tooling
 
       - name: Lint the frontmatter of all RFCs
-        run: node ./rfcs-tooling/lint-rfc-frontmatter.js text/*.md
+        run: node ./rfcs-tooling/scripts/lint-rfc-frontmatter.mjs text/*.md

.github/workflows/generate-rfc-frontmatter-json.yml

@@ -18,7 +18,7 @@ jobs:
 
       - name: Generate frontmatter data file
         run: |
-          node rfcs-tooling/list-frontmatter.js text/*.md > rfc-data.json
+          node rfcs-tooling/scripts/list-frontmatter.mjs text/*.md > rfc-data.json
 
       - uses: actions/upload-artifact@v3
         with:

.github/workflows/newly-added-rfcs.yml

@@ -8,13 +8,6 @@ on:
     paths:
       - 'text/*.md'
 
-concurrency:
-  # Events within 5 minutes are not guaranteed to run in order, and so when removing S-Proposed and adding S-Exploring
-  # we can't guarantee that the run of the workflow will be the one where S-Exploring is added. Adding `github.event_name`
-  # to the concurrency allows both workflows to complete and the PR to eventually have successful checks.
-  group: newly-added-rfc-${{ github.head_ref || github.ref }}-${{ github.event_name }}
-  cancel-in-progress: true
-
 jobs:
   check-rfcs:
     name: Does PR add RFCs?
@@ -76,7 +69,7 @@ jobs:
       - name: Fail if more than 1 RFC is added or modified
         if: ${{ needs.check-rfcs.outputs.rfcs-changed > 1}}
         run: |
-          echo "::error::More than 1 RFC is added in this PR; will be unable to automatically open PRs for advancement"
+          echo "::error::More than 1 RFC is added or modified in this PR; will be unable to automatically open PRs for advancement"
           exit 1
 
   frontmatter-stage-is-accepted:
@@ -92,7 +85,7 @@ jobs:
 
       - name: Verify stage of newly added RFC is `accepted` in frontmatter
         run: |
-          frontmatter=`node rfcs-tooling/rfc-frontmatter.js ${{ needs.check-rfcs.outputs.modified-rfc }}`
+          frontmatter=`node rfcs-tooling/scripts/rfc-frontmatter.mjs ${{ needs.check-rfcs.outputs.modified-rfc }}`
           stage=`echo $frontmatter | jq '.stage'`
           if [[ $stage != '"accepted"' ]]; then
               echo "::error::Newly added RFCs must have the stage 'accepted' in the frontmatter"
@@ -113,8 +106,7 @@ jobs:
       - name: Test RFC Filename matches PR Number that adds it
         env:
           PR_NUMBER: ${{ github.event.pull_request.number }}
-        run: node check-filename-matches-pr.js $PR_NUMBER ${{ needs.check-rfcs.outputs.modified-rfc }}
-        working-directory: rfcs-tooling
+        run: node rfcs-tooling/scripts/check-filename-matches-pr.mjs $PR_NUMBER ${{ needs.check-rfcs.outputs.modified-rfc }}
 
   check-accepted-pr-url:
     name: Verify Accepted PR URL is correct
@@ -129,7 +121,7 @@ jobs:
 
       - name: Verify Accepted PR URL is correct
         run: |
-          frontmatter=`node rfcs-tooling/rfc-frontmatter.js ${{ needs.check-rfcs.outputs.modified-rfc }}`
+          frontmatter=`node rfcs-tooling/scripts/rfc-frontmatter.mjs ${{ needs.check-rfcs.outputs.modified-rfc }}`
           accepted_pr=`echo $frontmatter | jq '.prs.accepted'`
           accepted_pr=${accepted_pr//\"/}
           expected_pr="${{ github.event.pull_request.html_url }}"