Skip to content

Commit 14facba

Browse files
Tanvi DahiyaCopilot
andcommitted
power-pages: rename bootstrap-migrate-v3-to-v5 skill to migrate-bootstrap
Renames the skill directory, eval directory, SKILL.md name, all five approval-gate ids, the approval-gates catalog section, the skill-tracking entry (MigrateBootstrap / Site/AI/Skills/MigrateBootstrap), the README entry, and the reference-doc mentions. The pac pages bootstrap-migrate CLI verb is unrelated and left untouched. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: c10b282d-bbe9-4fab-ad9f-4bf333ad953b
1 parent 03f74bf commit 14facba

7 files changed

Lines changed: 24 additions & 24 deletions

File tree

evals/power-pages/bootstrap-migrate-v3-to-v5/evals.json renamed to evals/power-pages/migrate-bootstrap/evals.json

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
{
2-
"skill_name": "bootstrap-migrate-v3-to-v5",
2+
"skill_name": "migrate-bootstrap",
33
"evals": [
44
{
55
"id": 1,
@@ -21,7 +21,7 @@
2121
"A final consent gate is presented before the outward-facing upload",
2222
"pac pages upload (not upload-code-site) is run against the <folder>V5 directory",
2323
"The Bootstrap 5 runtime flag flip is explicitly verified after upload rather than trusting the upload exit code",
24-
"The site is validated via /test-site and skill usage is recorded with --skillName BootstrapMigrateV3ToV5"
24+
"The site is validated via /test-site and skill usage is recorded with --skillName MigrateBootstrap"
2525
]
2626
},
2727
{

plugins/power-pages/README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -390,7 +390,7 @@ Adds search engine optimization artifacts: `robots.txt`, `sitemap.xml`, and meta
390390

391391
### Migration
392392

393-
#### `/bootstrap-migrate-v3-to-v5`
393+
#### `/migrate-bootstrap`
394394

395395
> "Upgrade my Power Pages site from Bootstrap 3 to Bootstrap 5"
396396

plugins/power-pages/references/approval-gates.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -685,17 +685,17 @@ New skill (Power Pages source & dependency security scan). Runs local static ana
685685

686686
---
687687

688-
### 6.31 `bootstrap-migrate-v3-to-v5` (6 calls / 5 gates + 1 sub-prompt)
688+
### 6.31 `migrate-bootstrap` (6 calls / 5 gates + 1 sub-prompt)
689689

690690
New skill (migrates a traditional Power Pages site from Bootstrap 3 to Bootstrap 5). The engine does the bulk class renames; the skill assists with residual hierarchy/CSS fixes, then uploads (which auto-flips the runtime flag).
691691

692692
| ID | Kind | Category | Phase | Trigger / question | Cancel leaves |
693693
|---|---|---|---|---|---|
694-
| `bootstrap-migrate-v3-to-v5:1.confirm-env` | gate | consent | 1 | Echoes current env — *"Use this environment / choose another"*. Migrating against the wrong environment is destructive, so confirmation is mandatory. Covers the free-text env-URL sub-prompt in the same step. | nothing |
695-
| `bootstrap-migrate-v3-to-v5:2.1.select-site` | gate | plan | 2.1 | Multiple websites found — *"Which website to download?"* | nothing |
696-
| `bootstrap-migrate-v3-to-v5:4.run-engine` | gate | consent | 4 | *"Run the Bootstrap 5 migration on `<SITE_FOLDER>`?"* — engine writes a new `<SITE_FOLDER>V5` copy and never edits the source. | nothing |
697-
| `bootstrap-migrate-v3-to-v5:6.residual-fixes` | gate | progress | 6 | Per-category consent — *"Apply the `<category>` fixes to `<N>` file(s)?"* — repeated per residual category; changes are local to the V5 copy. | nothing |
698-
| `bootstrap-migrate-v3-to-v5:7.2.upload` | gate | final | 7.2 | First outward-facing change — *"Upload `<MIGRATED_FOLDER>` to `<ENV_NAME>`?"* — publishes the Bootstrap 5 site and auto-enables the runtime flag. | nothing |
694+
| `migrate-bootstrap:1.confirm-env` | gate | consent | 1 | Echoes current env — *"Use this environment / choose another"*. Migrating against the wrong environment is destructive, so confirmation is mandatory. Covers the free-text env-URL sub-prompt in the same step. | nothing |
695+
| `migrate-bootstrap:2.1.select-site` | gate | plan | 2.1 | Multiple websites found — *"Which website to download?"* | nothing |
696+
| `migrate-bootstrap:4.run-engine` | gate | consent | 4 | *"Run the Bootstrap 5 migration on `<SITE_FOLDER>`?"* — engine writes a new `<SITE_FOLDER>V5` copy and never edits the source. | nothing |
697+
| `migrate-bootstrap:6.residual-fixes` | gate | progress | 6 | Per-category consent — *"Apply the `<category>` fixes to `<N>` file(s)?"* — repeated per residual category; changes are local to the V5 copy. | nothing |
698+
| `migrate-bootstrap:7.2.upload` | gate | final | 7.2 | First outward-facing change — *"Upload `<MIGRATED_FOLDER>` to `<ENV_NAME>`?"* — publishes the Bootstrap 5 site and auto-enables the runtime flag. | nothing |
699699

700700
---
701701
### Cross-plugin shared skills — out of catalog scope

plugins/power-pages/references/skill-tracking-reference.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -56,7 +56,7 @@ If the tracking script creates or updates site setting YAML files, include those
5656
| deploy-pipeline | DeployPipeline | Site/AI/Skills/DeployPipeline |
5757
| ensure-pipelines-host | EnsurePipelinesHost | Site/AI/Skills/EnsurePipelinesHost |
5858
| force-link-environment | ForceLinkEnvironment | Site/AI/Skills/ForceLinkEnvironment |
59-
| bootstrap-migrate-v3-to-v5 | BootstrapMigrateV3ToV5 | Site/AI/Skills/BootstrapMigrateV3ToV5 |
59+
| migrate-bootstrap | MigrateBootstrap | Site/AI/Skills/MigrateBootstrap |
6060

6161
## YAML Format
6262

plugins/power-pages/skills/bootstrap-migrate-v3-to-v5/SKILL.md renamed to plugins/power-pages/skills/migrate-bootstrap/SKILL.md

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
name: bootstrap-migrate-v3-to-v5
2+
name: migrate-bootstrap
33
description: >-
44
Migrates a traditional Power Pages site from Bootstrap 3 to Bootstrap 5. Downloads the
55
site, runs the pac pages bootstrap-migrate engine, reviews the change report, applies
@@ -65,9 +65,9 @@ confirmed, and the required commands are available.
6565
then `pac auth create --environment "<URL>"` and re-verify. Capture the environment name, URL,
6666
and ID.
6767

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 -->
6969

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.
7171
7272
4. Confirm the target environment with the user (`AskUserQuestion`: use this environment / choose
7373
another via `pac org list` + `pac org select`).
@@ -114,9 +114,9 @@ and `upload` confirmed available, `PAC_LOG` path captured.
114114
pac pages list
115115
```
116116

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 -->
118118

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.
120120
121121
Present the websites via `AskUserQuestion`, then download the selected site:
122122

@@ -214,9 +214,9 @@ running the engine.
214214

215215
**Actions**:
216216

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 -->
218218

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.
220220
221221
1. Get explicit consent to run the engine (`AskUserQuestion`: "Run the Bootstrap 5 migration on
222222
`<SITE_FOLDER>`? This creates a new `<SITE_FOLDER>V5` copy and does not modify the original.").
@@ -277,9 +277,9 @@ the `MIGRATED_FOLDER` files.
277277

278278
1. Group the residual items by category (grid hierarchy, navbar structure, panel/card styling,
279279
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 -->
281281

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.
283283
284284
2. For **each category**, get per-category consent (`AskUserQuestion`: "Apply the `<category>` fixes
285285
to `<N>` file(s)?"). On consent:
@@ -314,9 +314,9 @@ Verify both (`Grep`/`Read`). If either is missing, the flag flip silently no-ops
314314

315315
### 7.2 Final consent gate, then upload
316316

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 -->
318318

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.
320320
321321
This is the first **outward-facing** change. Get explicit consent (`AskUserQuestion`: "Upload
322322
`<MIGRATED_FOLDER>` to environment `<ENV_NAME>`? This publishes the Bootstrap 5 site and enables the
@@ -377,7 +377,7 @@ restart.
377377
panels/cards, forms, pagination) for layout regressions introduced by the migration.
378378
3. **Record skill usage** — follow `${PLUGIN_ROOT}/references/skill-tracking-reference.md`, passing
379379
`--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**
381381
(`.powerpages-site/site-settings/` exists); for a traditional/native download the script exits
382382
silently as a no-op — that is expected, so call it unconditionally and don't treat the no-op as an
383383
error. If tracking files are written, include them in the final commit.

plugins/power-pages/skills/bootstrap-migrate-v3-to-v5/references/bootstrap-v5-manual-fixes.md renamed to plugins/power-pages/skills/migrate-bootstrap/references/bootstrap-v5-manual-fixes.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
`pac pages bootstrap-migrate` auto-applies the well-known class renames but can only **flag**
44
structural ("hierarchy") changes and changes that require new CSS. Those appear in `logs.txt`
55
as `Need hierarchy change for …` lines or as "replaced with styles" notes. This reference is the
6-
recipe book the `/bootstrap-migrate-v3-to-v5` skill uses in **Phase 6** to apply (or flag) each one.
6+
recipe book the `/migrate-bootstrap` skill uses in **Phase 6** to apply (or flag) each one.
77

88
**Apply with per-category consent. Never blindly rewrite Liquid-entangled markup — flag it instead.**
99
After each edit, re-check the affected lines against the file's `<file>-diff.json` so you don't

plugins/power-pages/skills/bootstrap-migrate-v3-to-v5/references/migration-engine-reference.md renamed to plugins/power-pages/skills/migrate-bootstrap/references/migration-engine-reference.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Migration Engine Reference — `pac pages bootstrap-migrate` and the auto flag-flip
22

3-
This reference documents the CLI engine the `/bootstrap-migrate-v3-to-v5` skill orchestrates: what
3+
This reference documents the CLI engine the `/migrate-bootstrap` skill orchestrates: what
44
`pac pages bootstrap-migrate` does, what it produces, and how `pac pages upload`
55
automatically flips the server-side Bootstrap 5 runtime flag.
66

0 commit comments

Comments
 (0)