|
1 | 1 | --- |
2 | | -name: bootstrap-migrate-v3-to-v5 |
| 2 | +name: migrate-bootstrap |
3 | 3 | description: >- |
4 | 4 | Migrates a traditional Power Pages site from Bootstrap 3 to Bootstrap 5. Downloads the |
5 | 5 | site, runs the pac pages bootstrap-migrate engine, reviews the change report, applies |
@@ -65,9 +65,9 @@ confirmed, and the required commands are available. |
65 | 65 | then `pac auth create --environment "<URL>"` and re-verify. Capture the environment name, URL, |
66 | 66 | and ID. |
67 | 67 |
|
68 | | -<!-- gate: bootstrap-migrate-v3-to-v5:1.confirm-env | category=consent | cancel-leaves=nothing --> |
| 68 | +<!-- gate: migrate-bootstrap:1.confirm-env | category=consent | cancel-leaves=nothing --> |
69 | 69 |
|
70 | | -> 🚦 **Gate (consent · bootstrap-migrate-v3-to-v5:1.confirm-env):** Confirm the target environment before any download, migration, or upload. Running the migration against the wrong environment is destructive, so this confirmation is mandatory. |
| 70 | +> 🚦 **Gate (consent · migrate-bootstrap:1.confirm-env):** Confirm the target environment before any download, migration, or upload. Running the migration against the wrong environment is destructive, so this confirmation is mandatory. |
71 | 71 |
|
72 | 72 | 4. Confirm the target environment with the user (`AskUserQuestion`: use this environment / choose |
73 | 73 | another via `pac org list` + `pac org select`). |
@@ -114,9 +114,9 @@ and `upload` confirmed available, `PAC_LOG` path captured. |
114 | 114 | pac pages list |
115 | 115 | ``` |
116 | 116 |
|
117 | | -<!-- gate: bootstrap-migrate-v3-to-v5:2.1.select-site | category=plan | cancel-leaves=nothing --> |
| 117 | +<!-- gate: migrate-bootstrap:2.1.select-site | category=plan | cancel-leaves=nothing --> |
118 | 118 |
|
119 | | - > 🚦 **Gate (plan · bootstrap-migrate-v3-to-v5:2.1.select-site):** Choose which website to download when more than one exists. Canceling leaves nothing changed. |
| 119 | + > 🚦 **Gate (plan · migrate-bootstrap:2.1.select-site):** Choose which website to download when more than one exists. Canceling leaves nothing changed. |
120 | 120 |
|
121 | 121 | Present the websites via `AskUserQuestion`, then download the selected site: |
122 | 122 |
|
@@ -214,9 +214,9 @@ running the engine. |
214 | 214 |
|
215 | 215 | **Actions**: |
216 | 216 |
|
217 | | -<!-- gate: bootstrap-migrate-v3-to-v5:4.run-engine | category=consent | cancel-leaves=nothing --> |
| 217 | +<!-- gate: migrate-bootstrap:4.run-engine | category=consent | cancel-leaves=nothing --> |
218 | 218 |
|
219 | | -> 🚦 **Gate (consent · bootstrap-migrate-v3-to-v5:4.run-engine):** Explicit consent before running `pac pages bootstrap-migrate`. The engine writes a new `<SITE_FOLDER>V5` copy and never edits the source, so canceling leaves nothing changed. |
| 219 | +> 🚦 **Gate (consent · migrate-bootstrap:4.run-engine):** Explicit consent before running `pac pages bootstrap-migrate`. The engine writes a new `<SITE_FOLDER>V5` copy and never edits the source, so canceling leaves nothing changed. |
220 | 220 |
|
221 | 221 | 1. Get explicit consent to run the engine (`AskUserQuestion`: "Run the Bootstrap 5 migration on |
222 | 222 | `<SITE_FOLDER>`? This creates a new `<SITE_FOLDER>V5` copy and does not modify the original."). |
@@ -277,9 +277,9 @@ the `MIGRATED_FOLDER` files. |
277 | 277 |
|
278 | 278 | 1. Group the residual items by category (grid hierarchy, navbar structure, panel/card styling, |
279 | 279 | page-header, pager, btn-block, Liquid edge cases, partial paths). |
280 | | -<!-- gate: bootstrap-migrate-v3-to-v5:6.residual-fixes | category=progress | cancel-leaves=nothing --> |
| 280 | +<!-- gate: migrate-bootstrap:6.residual-fixes | category=progress | cancel-leaves=nothing --> |
281 | 281 |
|
282 | | -> 🚦 **Gate (progress · bootstrap-migrate-v3-to-v5:6.residual-fixes):** Per-category consent before applying each residual fix to the `MIGRATED_FOLDER` files. Changes are local to the V5 copy and committed per category; canceling leaves nothing outward-facing changed. |
| 282 | +> 🚦 **Gate (progress · migrate-bootstrap:6.residual-fixes):** Per-category consent before applying each residual fix to the `MIGRATED_FOLDER` files. Changes are local to the V5 copy and committed per category; canceling leaves nothing outward-facing changed. |
283 | 283 |
|
284 | 284 | 2. For **each category**, get per-category consent (`AskUserQuestion`: "Apply the `<category>` fixes |
285 | 285 | to `<N>` file(s)?"). On consent: |
@@ -314,9 +314,9 @@ Verify both (`Grep`/`Read`). If either is missing, the flag flip silently no-ops |
314 | 314 |
|
315 | 315 | ### 7.2 Final consent gate, then upload |
316 | 316 |
|
317 | | -<!-- gate: bootstrap-migrate-v3-to-v5:7.2.upload | category=final | cancel-leaves=nothing --> |
| 317 | +<!-- gate: migrate-bootstrap:7.2.upload | category=final | cancel-leaves=nothing --> |
318 | 318 |
|
319 | | -> 🚦 **Gate (final · bootstrap-migrate-v3-to-v5:7.2.upload):** Final sign-off before the first outward-facing change. `pac pages upload` publishes the Bootstrap 5 site and auto-enables the runtime flag. Canceling before upload leaves the live site untouched. |
| 319 | +> 🚦 **Gate (final · migrate-bootstrap:7.2.upload):** Final sign-off before the first outward-facing change. `pac pages upload` publishes the Bootstrap 5 site and auto-enables the runtime flag. Canceling before upload leaves the live site untouched. |
320 | 320 |
|
321 | 321 | This is the first **outward-facing** change. Get explicit consent (`AskUserQuestion`: "Upload |
322 | 322 | `<MIGRATED_FOLDER>` to environment `<ENV_NAME>`? This publishes the Bootstrap 5 site and enables the |
@@ -377,7 +377,7 @@ restart. |
377 | 377 | panels/cards, forms, pagination) for layout regressions introduced by the migration. |
378 | 378 | 3. **Record skill usage** — follow `${PLUGIN_ROOT}/references/skill-tracking-reference.md`, passing |
379 | 379 | `--projectRoot "<MIGRATED_FOLDER>"` (the folder containing `powerpages.config.json`) and |
380 | | - `--skillName "BootstrapMigrateV3ToV5"`. Tracking only writes when the project is a **code site** |
| 380 | + `--skillName "MigrateBootstrap"`. Tracking only writes when the project is a **code site** |
381 | 381 | (`.powerpages-site/site-settings/` exists); for a traditional/native download the script exits |
382 | 382 | silently as a no-op — that is expected, so call it unconditionally and don't treat the no-op as an |
383 | 383 | error. If tracking files are written, include them in the final commit. |
|
0 commit comments