Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
32 changes: 29 additions & 3 deletions .claude/skills/pac-cli-update/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -76,14 +76,39 @@ Both packages must always use the same version. Never update only one.

## Step 4 — Update extension/overview.md

Add a new entry under `{{NextReleaseVersion}}:` (do not remove the placeholder — it stays):
**Must be additive — never overwrite the previous pac CLI bullet.**

The bullet under `{{NextReleaseVersion}}:` represents the version that shipped most recently. Before replacing it with the new pac CLI version, move it down as a versioned entry using the last published extension version from GitHub releases:

```bash
LAST_RELEASE=$(gh release list --repo microsoft/powerplatform-build-tools --limit 1 --json tagName --jq '.[0].tagName' | sed 's/^[Vv]//')
echo "Last published extension version: $LAST_RELEASE"
```

Then transform `extension/overview.md`:

Before:
```markdown
{{NextReleaseVersion}}:
- pac CLI <previous-major.minor>, [Release Notes on nuget.org](.../<previous-pac-version>...)

2.0.97:
- pac CLI 1.49, ...
```

After:
```markdown
{{NextReleaseVersion}}:
- pac CLI <major.minor>, [Release Notes on nuget.org](https://www.nuget.org/packages/Microsoft.PowerApps.CLI/<pac-version>#releasenotes-body-tab)
- pac CLI <new-major.minor>, [Release Notes on nuget.org](https://www.nuget.org/packages/Microsoft.PowerApps.CLI/<pac-version>#releasenotes-body-tab)

<LAST_RELEASE>:
- pac CLI <previous-major.minor>, [Release Notes on nuget.org](.../<previous-pac-version>...)

2.0.97:
- pac CLI 1.49, ...
```

If additional changes are in this update (new task, Node target bump, etc.), add bullet points below the pac CLI line.
If additional changes are in this update (new task, Node target bump, etc.), add bullet points below the pac CLI line under `{{NextReleaseVersion}}:`.

---

Expand Down Expand Up @@ -212,4 +237,5 @@ Print:
- Never skip the release/stable PR — every CLI update needs both
- Never cherry-pick to release/stable without verifying the main PR CI passes first
- The `{{NextReleaseVersion}}` placeholder in `overview.md` must stay — add below it, never replace it
- Updates to `overview.md` must be **additive** — preserve the previous pac CLI bullet by moving it down as a versioned entry (using the latest GitHub release version), never overwrite it
- If the Linux pac CLI package (`Microsoft.PowerApps.CLI.Core.linux-x64`) doesn't have the new version yet, wait — don't ship with mismatched versions
3 changes: 3 additions & 0 deletions extension/overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,6 +22,9 @@ Please use the issues tracker in the home repo: <https://github.com/microsoft/po
# Release Notes

{{NextReleaseVersion}}:
- pac CLI 2.7, [Release Notes on nuget.org](https://www.nuget.org/packages/Microsoft.PowerApps.CLI/2.7.4#releasenotes-body-tab)

2.0.136:
- pac CLI 2.6, [Release Notes on nuget.org](https://www.nuget.org/packages/Microsoft.PowerApps.CLI/2.6.4#releasenotes-body-tab)

2.0.97:
Expand Down
4 changes: 2 additions & 2 deletions nuget.json
Original file line number Diff line number Diff line change
Expand Up @@ -2,13 +2,13 @@
"packages": [
{
"name": "Microsoft.PowerApps.CLI",
"version": "2.6.4",
"version": "2.7.4",
"internalName": "pac",
"useFeed": "nuget.org"
},
{
"name": "Microsoft.PowerApps.CLI.Core.linux-x64",
"version": "2.6.4",
"version": "2.7.4",
"internalName": "pac_linux",
"chmod": "tools/pac",
"useFeed": "nuget.org"
Expand Down