Skip to content

Commit da94496

Browse files
Add prose about specifying any blueprint version via flag
Co-authored-by: NullVoxPopuli <199018+NullVoxPopuli@users.noreply.github.com>
1 parent e6eec28 commit da94496

1 file changed

Lines changed: 20 additions & 1 deletion

File tree

text/1160-no-more-release-train.md

Lines changed: 20 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -58,6 +58,7 @@ We want a workflow where blueprint changes can ship as soon as they are merged,
5858
- Blueprint packages ship continuously from `main`.
5959
- `ember-cli` defaults to a known-good, pinned blueprint version.
6060
- Users may choose the latest blueprint version at generation time.
61+
- Users may specify any specific blueprint version at generation time (e.g. for testing).
6162
- If pinned and latest match, do not prompt.
6263

6364
### Non-goals
@@ -139,13 +140,31 @@ If the user is offline or the registry is unavailable:
139140
- `ember new my-app`
140141
- No prompt; generation proceeds using the bundled version.
141142

143+
If the user specifies a specific blueprint version:
144+
145+
- `ember new my-app --blueprints-version=1.2.3`
146+
- No prompt; generation proceeds using blueprint version `1.2.3`.
147+
148+
#### Specifying a specific blueprint version
149+
150+
Users may also specify an exact blueprint version using a flag such as `--blueprints-version=X.Y.Z` (or equivalent). This is useful for:
151+
152+
- Testing a specific blueprint release before it becomes the bundled default.
153+
- Reproducing a blueprint output from a known version for debugging or comparison.
154+
- Downgrading to an older blueprint version when needed (e.g. to verify behavior differences between releases).
155+
156+
When this flag is provided, `ember-cli` must skip the interactive prompt and use the requested version directly. If the requested version cannot be resolved (e.g. it does not exist on the registry), `ember-cli` should report an error and abort.
157+
158+
This flag is intentionally lower-profile than `--use-latest-blueprints`—it targets advanced users and tooling authors who have a specific reason to pin to a particular version. It should be documented but not prominently featured in onboarding materials.
159+
142160
#### Non-interactive environments
143161

144162
When `ember-cli` is running in a non-interactive environment (e.g. CI), the default must be bundled to preserve determinism.
145163

146-
This RFC recommends (but does not require) an explicit opt-in flag to avoid relying on interactive prompting in automation:
164+
This RFC recommends (but does not require) explicit opt-in flags to avoid relying on interactive prompting in automation:
147165

148166
- `--use-latest-blueprints` (or equivalent) to force using the latest blueprint version.
167+
- `--blueprints-version=X.Y.Z` (or equivalent) to force using a specific blueprint version.
149168

150169
### Implementation notes (non-normative)
151170

0 commit comments

Comments
 (0)