microsoft/power-platform-skills

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

+ 70   When the maker wants a rebuild to keep a web resource's content in step with the spec, mark that
+ 71   resource `reconcile: "declared"` instead (`minimumPluginVersion: "2.21.0"`) — only when asked, one
+ 72   resource at a time, never a shared (`external`) one, and never every resource of a downloaded or
+ 73   older spec. A rebuild that would change one that exists stops before writing and names its approval
+ 74   (`--authorize adopt:webresource:<web resource name>`) with the components that depend on it: show them to the
+ 75   maker and let them choose. Emptying its content also needs `--allow-destructive`; the halt says so.
+ 96 - **App theme and header logo (Preview, 2.21.0)** — `app.theme`. Add it **only when the maker explicitly asks
+ 97   for branding** (brand colours, a header colour, a logo) or says yes to the branding question you ask of every new app
+ 98   at the personas step (authoring-flow Level (a0)); an ordinary app gets **no** `app.theme` without one of those, and you never
+ 99   invent a palette, a font or a logo. Offer the choices: a `basePaletteColor` (or explicit `palette` slots), the
+ 100   `appHeader` colours, a `font` only if they name one, and a `logo` that is an **existing image web resource**
+ 101   (or one you also declare in `webResources[]`), never a URL. Say before the build that the theme is published
+ 102   with the **app**, and that an app publication publishes **every** pending change of the app, not only the theme.
+ 103   The theme does not change the `newLook` / header choices above — do not switch them to fit a theme. Omit the key
+ 104   to leave the app's theme alone; `null` removes the app's override (the environment theme applies again). Theme
+ 105   versions are never deleted, and a logo the theme only references is never touched by teardown. `--verify` reports the theme's **API state** (saved,
+ 106   pending publish, live) — tell the maker to check the header in the app itself.
+ 107 - **App membership** — which forms, views and charts the app offers (`app.mainForms`, `app.tables`).
+ 108   **Only these forms on an existing app.** `app.mainForms` adds the forms you list. To also take the table's other Main
+ 109   forms **out of the app** on an update, set `"mainFormsOnUpdate": "exact"` — ask the maker first, it is a removal from the
+ 110   app's membership (no form is deleted). It needs an unmanaged, published app; the build publishes only once Dataverse reads
+ 111   back exactly your list, and otherwise stops with the change saved and the app's publication owed.
+ 112 
+ 113   **Pin the artifacts the spec declares.** `"pinDeclaredArtifacts": true` adds the spec's own forms, views, charts and
+ 114   dashboards to the app explicitly — use it for a chart or view of a table that is not in the navigation. It only adds.
+ 115   When to use them: `"exact"` only on an explicit "only these forms" / "remove the other forms" ask, after
+ 116   showing the maker which tables it covers (the build refuses it on an existing app without
+ 117   `--allow-destructive`); never for "add the Summary form", which `app.mainForms` alone does. Suggest
+ 118   `pinDeclaredArtifacts: true` for a **new** app whose spec declares a chart, view or dashboard of a table
+ 119   that is not in its navigation. Never turn either on by yourself for an existing app. Both need
+ 120   `minimumPluginVersion: "2.21.0"`.
+ 123 - **Confidential columns** — `isSecured` + `fieldSecurityProfiles[]`. Reach for them when the design
+ 124   names a value only some people may see or change (salary, medical notes, an identifier, private
+ 125   comments): a security role cannot hide one column, a profile can. Name who gets each profile
+ 126   (`assignTo` users or teams, by id) — never infer them from a persona — and say in the preview who
+ 127   gains access, or that no assignment was requested. Tell the maker that System Administrators see
+ 128   every secured column (test as a non-admin), that an open app may need a reload, to grant `read`
+ 129   unless `update` is needed, that unsecuring a column deletes its permissions
+ 130   (`--authorize isSecured:<table>.<column>`), and that a teardown keeps each declared profile and names it.
+ 131 - **Portable schema** — `{ "value", "label" }` options when an integration or another environment
+ 132   depends on the option numbers; `dateTimeBehavior: "DateOnly"` for birthdays, due and renewal
+ 133   dates, `"TimeZoneIndependent"` for a time that means the same clock everywhere (omit it for
+ 134   timestamps); table `searchEnabled` / `duplicateDetectionEnabled` only when the maker asks. Never
+ 135   change an existing column's date behaviour or turn duplicate detection off unasked: both need
+ 136   `--authorize`. All need `minimumPluginVersion: "2.21.0"` — see
+ 137   [`references/app-spec-schema-advanced.md`](../../references/app-spec-schema-advanced.md).
+ 138 - **Declared views, charts and search columns** (`minimumPluginVersion: "2.21.0"`) — write
+ 139   `reconcile: "declared"` on each view or chart you author for a **new** app, and, when editing, on the
+ 140   one existing view or chart the maker asks to change: a rebuild then applies its columns, filters, sort
+ 141   and joins (`linkEntities`) instead of only adding columns. Never set `title` on a new declared chart,
+ 142   and give a declared view its own name — not the stock `Active <plural>` or `Inactive <plural>`, which
+ 143   every table already has, so changing one is an adoption. Two declared views on one table need different
+ 144   names, and so do two declared charts: a `viewId` pin does not tell them apart, and the build refuses the
+ 145   pair (see Approvals in the advanced reference).
+ 146   For a new table you create, propose `entities[].quickFind.findColumns` (the primary name plus what a
+ 147   user types in the search box: a number, an email, a code) and confirm it with the maker; on an
+ 148   existing table, only when the maker names what search should match. A change to a view or chart that
+ 149   already exists stops the build with nothing written and names its approval
+ 150   (`--authorize adopt:view:<table>/<name>` or `adopt:chart:`, `overwrite:` for changes made elsewhere, `--allow-destructive`
+ 151   to remove columns): explain it and let the maker choose; never edit the spec to avoid it. A local copy
+ 152   that differs from the server's stops it the same way (`workspace-copy-unsent-edits`) and is kept: ask
+ 153   whether to put that change into the spec and refresh the local copy, or approve the `overwrite:` key
+ 154   it prints (`overwrite:quickfind:<table>` for search columns); pass a key exactly as printed. Never write
+ 155   `reconcile` on a web resource except as the web-resource bullet above says, on a form, a dashboard, a business
+ 156   rule or a business process flow except as their bullets below say, and never write a command `key` (keyed command bars are refused
+ 157   in this version). Leave a downloaded or older spec without these fields as it is — see the advanced reference.
+ 158 - **Declared form layouts** (`minimumPluginVersion: "2.21.0"`) — write `reconcile: "declared"` on a form
+ 159   only when the maker asked its layout to follow the spec (fields, spans, sections, field options, sub-grids,
+ 160   handlers) or said yes when you offered it at Level (b); not for "add a form" or "add a field" with no layout. Tell the maker: controls the spec does not
+ 161   declare stay where they are and nothing is deleted (so no `--allow-destructive` is needed for them); a layout the build cannot place safely stops before any
+ 162   write; a table publish puts live every saved change on that table, not only this form, with or without
+ 163   `--publish` (a declared dashboard is published after its write either way); and Dataverse does
+ 164   not provide a working conditional-write guard for a form's saved layer, so the build re-checks it just
+ 165   before writing, but an edit made in Maker at that instant cannot be detected. Never write `genPages`, `prune`, `isDefault`,
+ 166   `deactivateOtherMainForms`, `securityRoles` or a `mainFormOrder` place on a declared form (refused).
+ 167   An existing form is bound only with `--authorize "adopt:form:<table>/<formtype>/<name>"` (lower case;
+ 168   `overwrite:form:` for changes made elsewhere): explain it and let the maker choose. `--verify` checks a
+ 169   declared form against the spec, sub-grid views included (a form whose publish is unconfirmed is unverified,
+ 170   not passed). A download brings declared forms back only with `--include-managed --managed-manifest <store
+ 171   file>` (one with an event handler comes back with its handler library as an `external` web resource when
+ 172   that library is this publisher's own unmanaged script; otherwise it is left out and named in
+ 173   `managedForms.stale`, and its declaration is written ready to paste in the new file `managedFragments.file` names (`.maker-workspace/managed-fragments-<time>-<random>.json`)
+ 174   with the library it needs, so tell the maker to add both from the spec it was built from); it carries no binding, so the first build that binds each form from the downloaded folder needs
+ 175   `adopt:form:<key>` (a rebuild that writes nothing may leave it unbound). A form removed from the spec and
+ 176   then deleted in Maker is released by the next build, which names it (`managed-root-retired`); until then
+ 177   `--verify` fails it. One whose publish is unconfirmed is not released (see the unconfirmed publish below). A
+ 178   build that warns a form's or dashboard's retirement could not be confirmed stops before it writes anything
+ 179   (`managed-not-settled`) and sends nothing more in that run, not even an earlier attempt's deferred publish;
+ 180   running it again reads it afresh and publishes that. A plain form (by its name, `<table> form` when it has
+ 181   none, or its `formId`) that replaces a removed declared form with unfinished work (a lost create, an owed or
+ 182   unconfirmed publish) is refused (`managed-form-unsettled`):
+ 183   restore the declaration and let it settle, or run the build again later.
+ 184 - **Declared dashboards** (`minimumPluginVersion: "2.21.0"`) — write `reconcile: "declared"` on a global
+ 185   dashboard only when the maker asked its tiles to follow the spec on rebuilds, or said yes when you offered it at Level (b); give it and every tile a
+ 186   `key`. Tell the maker: tiles the spec omits stay (nothing is deleted), and settings a tile does not state are
+ 187   kept; a new tile is added after the last row; in an environment with more than one language a new tile gets
+ 188   its caption, with the same text, in every language the environment has (if the build cannot read those
+ 189   languages, it stops before it writes the dashboard: `dashboard-languages-unreadable`, so run it again; the
+ 190   platform keeps some of those captions and drops others, an iframe tile's for one, and a dropped one other
+ 191   than the base-language caption is no change); an
+ 192   unfinished dashboard of the same name is not taken over
+ 193   and not deleted; a dashboard this build cannot finish is not published, including by the app publish; a
+ 194   dashboard the build created and could not prove is named by id in the stop: when the build knows it created it,
+ 195   delete it and run the build again, which creates it anew; when the stop says the build cannot tell who created
+ 196   it, have the maker inspect it and do not delete it; `dashboard-languages-unreadable` after a lost answer means
+ 197   run the build again; and
+ 198   Dataverse does not version a dashboard's saved layer, so an edit made in Maker at the instant of the write
+ 199   cannot be detected. An existing dashboard is bound only with `--authorize adopt:dashboard:<key>`
+ 200   (`overwrite:dashboard:<key>` or `overwrite:dashboard:<key>/<tile>` for changes made elsewhere,
+ 201   `--allow-destructive` to clear its description with `""`): explain it and let the maker choose. `--verify`
+ 202   holds a declared dashboard to its last build (a dashboard changed in Maker since fails until a build
+ 203   settles it; one whose publish is unconfirmed is unverified, not passed). A download brings it back declared
+ 204   only with `--include-managed --managed-manifest <store file>` (otherwise it is an undeclared entry), with the
+ 205   dashboard and tile ids it was proved on; its first binding needs `adopt:dashboard:<key>`, because the
+ 206   downloaded folder has no store.
+ 207 - **Declared business rules** (`minimumPluginVersion: "2.21.0"`) — write `reconcile: "declared"` on a rule only
+ 208   when the maker accepts that the build manages the WHOLE rule (the offer at the personas step, or their own ask); give every condition, action and apply-action a
+ 209   `key`. Tell the maker: conditions and actions are never matched by their text; a new rule is created Draft and
+ 210   activated only if nobody changed it in between; a rule that already exists is never edited by the build
+ 211   (change it in Maker, then re-adopt it); a rule changed outside the spec stops the build until it is re-adopted

This preview is limited. See the complete change on GitHub.

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

- 548                  | "pac_timeout" | "no_env_url" | "whoami_403" | "whoami_401" | "whoami_error",
+ 548                  | "pac_timeout" | "no_env_url" | "whoami_403" | "whoami_401" | "whoami_error"
+ 549                  | "no_customization_role",
+ 571 - **`blocker: "no_customization_role"`** means WhoAmI passed but the identity holds no security role, so
+ 572   every customization read would fail (HTTP 403 `0x80042f09`). Show the `message` and stop: the maker
+ 573   needs an administrator to assign a role such as System Customizer (or to sign in as the PAC user when
+ 574   `message` offers it). Any other failure of that one extra read is only a `warnings` entry.
- 917    Then review the page for iteration that compiles to nothing:
- 918 
- 919    The page compiler targets ES5 without iterator downleveling or full type checking.
- 920    Spreading, looping over, or array-destructuring a Map, Set or iterator reads length
- 921    and indices instead of the iterator: values can disappear, defaults can replace them,
- 922    or rest destructuring can throw. This includes `[...new Set(xs)]`, `[...m.values()]`,
+ 922    Then review the page for iteration that another page compiler can lose:
+ 923 
+ 924    Pages this plugin uploads are compiled with iterator support (ES5 with
+ 925    `downlevelIteration`), so a spread, a `for...of` loop or an array destructure of a Map,
+ 926    Set, iterator, generator or string reads it as modern JavaScript does. A tool that
+ 927    compiles the page again without that support — an older maker portal, or `pac` — reads
+ 928    length and indices instead: values disappear, defaults replace them, and rest
+ 929    destructuring or a string spread throws, all with a clean compile. Keep the page
+ 930    correct under every compiler: convert with `Array.from(...)` before spreading, looping
+ 931    or destructuring, for example `[...new Set(xs)]`, `[...m.values()]`,
- 924    `[...selected]` and `[...text.matchAll(re)]`. Convert with `Array.from(...)` before
- 925    spreading, looping or destructuring; copy a Set with `new Set(prev)` then `.add(id)`.
- 926    Ordinary array spreads and loops remain valid. `Object.keys`, `Object.values` and
- 927    `Object.entries` return arrays. Spreads of `arguments` and ordinary indexed
- 928    array-likes work; rest destructuring of an array-like without `slice` does not.
- 929    String spread throws, and an ES5 string loop visits UTF-16 code units rather than
- 930    Unicode code points. See **Common Errors > 5. Iteration that compiles to nothing**
- 931    in `references/rules.md` for the pairs.
+ 933    `[...selected]` and `[...text.matchAll(re)]`; copy a Set with `new Set(prev)` then
+ 934    `.add(id)`. Ordinary array spreads and loops remain valid. `Object.keys`,
+ 935    `Object.values` and `Object.entries` return arrays. Rest destructuring of a non-iterable array-like
+ 936    without `slice` throws under every compiler. A destructuring default must not write to
+ 937    the array being destructured: `const [a = (values[1] = 3), b] = values` leaves `b` at
+ 938    its old value here, unlike modern JavaScript. See **Common Errors > 5. Iteration that
+ 939    another page compiler can lose** in `references/rules.md` for the pairs.
- 1035 exited 0 is not deployed. Review every generated page for iteration that compiles to
- 1036 nothing as well, and fix it yourself: the workers follow the same rule
- 1037 (`references/rules.md`, **Common Errors > 5. Iteration that compiles to nothing**).
+ 1043 exited 0 is not deployed. Review every generated page for iteration that another page
+ 1044 compiler can lose as well, and fix it yourself: the workers follow the same rule
+ 1045 (`references/rules.md`, **Common Errors > 5. Iteration that another page compiler can lose**).
+ 1261 
+ 1262 #### Drafts, the pages lease, and a compiler refresh
+ 1263 
+ 1264 - **`--draft`** on `genpage-upload.js` (a page's content): use it only when the user says "save as draft", "review before
+ 1265   publishing" or "don't publish yet" (for example "update the overview page but don't publish it yet"). Add `--draft` to the
+ 1266   same create or update command. The page is saved and not published; with `--add-to-sitemap` its navigation entry is saved as
+ 1267   a draft too, and nothing publishes the app. Tell the user it is saved, not published: the app that runs is unchanged until a
+ 1268   build, the app designer or the same upload without `--draft` publishes it. The answer has `draft: true`, `saved`,
+ 1269   `pendingPublish` (null: nothing new was saved) and `publish.kind: "skipped"`. Never describe a draft as live or published.
+ 1270   A page an earlier upload created and did not finish refuses `--draft`: finish it without `--draft`.
+ 1271 - **`--draft`** on `genpage.js add-to-app` / `remove-from-app`: use it only when the user wants the navigation change saved but
+ 1272   not live yet (to review it, or to publish several edits at once). Tell them it is saved, not published: the app that runs is
+ 1273   unchanged until a build, the app designer or the same command without `--draft` publishes it. On a removal, `liveState`
+ 1274   says what the published navigation showed; only `shown` means the page cannot be deleted until the app is published.
+ 1275 - **`--turn-id '<guid>' --app-dir '<folder>'`** on `genpage-upload.js`: do NOT pass it for an ordinary create or edit. It is
+ 1276   only for a host or script that retries one complete edit after losing its answer, and the id must be minted and kept BEFORE
+ 1277   the first send — never added after an answer was lost. Retry with the same files, flags, `--app-dir` and receipt; the record
+ 1278   is kept in `<folder>/.maker-workspace/turns`. A reuse asking for anything else is refused with nothing written
+ 1279   (`GENPAGE_TURN_ID_REUSED`); a changed edit needs a new id once the old one's outcome is known. `GENPAGE_APP_PUBLISH_UNPROVEN`
+ 1280   under a turn means the placement is not finished: run the same command again with the same turn id. Never delete the marker
+ 1281   or the turn record, or drop the turn id, to get past an error. A retry from another folder or machine is not supported.
+ 1282 - **`pages-locked`** or **`build-locked`** (exit 1, nothing written) from `add-to-app`, `remove-from-app` or `genpage-upload.js --app-id`: a build or
+ 1283   another edit of the same app is running from that folder. Wait for it and run again; pass `--app-dir '<folder>'` when the
+ 1284   command is not run from the app's build folder. The lock covers one machine and one folder only.
+ 1285   `GENPAGE_APP_LEASE_UNRESOLVED` (exit 1, nothing written) from the same commands: the app's unique name, which names the
+ 1286   lock, could not be read — the app id is wrong, or the read failed (the message says which). Check the id and run again.
+ 1287 - **Compiler refresh** — only when the user names a page whose loops over a Map, a Set or a string misbehave after an older
+ 1288   build. Download the page, then run `node "${PLUGIN_ROOT}/scripts/genpage.js" prepare-compiler-refresh --env '<org-url>'
+ 1289   --page-id '<page-id>' --file '<working-dir>/<file>.tsx' --output-file '<working-dir>/<file>.refresh.tsx'`. It writes nothing
+ 1290   to the environment; it adds one comment line so the SDK compiles the page again. Show the user the one-line `diff`, get
+ 1291   approval, then upload the proposed file as an ordinary update (above). Never refresh pages in bulk: nothing proves which
+ 1292   compiler built a page. `COMPILER_REFRESH_MARKER_UNPROVEN` means the source already has the line — make a reviewed source change
+ 1293   instead; `COMPILER_REFRESH_BASE_MISMATCH` means download the page and review again.

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

- 36 This plan is grounded in three primary sources, in priority order:
- 37 
- 38 1. **`useGetOrCreatePlatformEnvironment.v4.ts`** (Microsoft-internal client source — `power-platform-ux/packages/powerapps-appdeployment-ux/src/hooks/v4/`). Defines the exact HTTP contract for Platform Environment provisioning: endpoint, body, headers, polling.
- 39 2. **`ProjectHostProvider.tsx`** (same repo, `src/components/ProjectHostProvider/`). Defines the exact resolution order the Power Apps UI uses to determine which environment is the project host for a source environment. We mirror that order so this skill agrees with the UI.
- 40 3. **eng.ms `createcustompipelineshost`** (Microsoft-internal). Documents the Custom Host fast-path: a `D365_ProjectHost` org template that ships the Pipelines app pre-installed, callable through the standard environment-creation API.
- 41 
- 42 Public Microsoft Learn (`learn.microsoft.com/power-platform/alm/{platform-host-pipelines, custom-host-pipelines, set-a-default-pipelines-host}`) is the user-facing description of the same flows; we cite it for behaviors users will recognize. HARs in `PipelinesDeployScenario.har` and `Pipelines.har` confirm the read-side calls.
+ 36 This plan is grounded in how the Power Platform UIs themselves provision and resolve a host, in priority order:
+ 37 
+ 38 1. **Platform Environment provisioning** — the HTTP contract the `make.powerapps.com` Pipelines page uses: endpoint, body, headers, polling.
+ 39 2. **Host resolution** — the order the Power Apps UI uses to determine which environment is the project host for a source environment. We mirror that order so this skill agrees with the UI.
+ 40 3. **The Custom Host fast-path** — a `D365_ProjectHost` org template that ships the Pipelines app pre-installed, callable through the standard environment-creation API (the template PPAC's `New custom host` uses).
+ 41 
+ 42 Public Microsoft Learn (`learn.microsoft.com/power-platform/alm/{platform-host-pipelines, custom-host-pipelines, set-a-default-pipelines-host}`) is the user-facing description of the same flows; we cite it for behaviors users will recognize. Browser network captures of the Pipelines pages confirm the read-side calls.
- 54 ## Resolution order (mirrors `ProjectHostProvider.tsx`)
+ 54 ## Resolution order (mirrors the Power Apps UI)
- 119 Source: `ProjectHostProvider.tsx` lines 100–213 (orgSetting fetch → defaultCustomPipelinesHost fetch → finalProjectHostEnvironmentId resolution).
+ 119 The Power Apps UI resolves in this order: org-setting fetch → tenant default custom host fetch → final host resolution.
- 144 1. **JIT provisioning is required when a PE is selected — existing or freshly provisioned.** From `ProjectHostProvider.tsx` (line 232–240 comment): *"In the Platform Environment case, the user may not already be provisioned there, so BAP cannot discover it. So we'll use the org URL we retrieve from the getOrCreate call to make this first request so that user JIT can be triggered."* When Phase 2 detects an existing PE and the user accepts it (Phase 3.A) — or when Phase 4.0 provisions a new PE via `getOrCreate` — Phase 5's `WhoAmI` call against `instanceApiUrl` triggers JIT before any subsequent host op. (For Custom Host paths the caller has access by construction.)
+ 144 1. **JIT provisioning is required when a PE is selected — existing or freshly provisioned.** In the Platform Environment case the user may not yet be provisioned there, so BAP cannot discover it; the Power Apps UI therefore sends its first request to the org URL the `getOrCreate` call returns, which triggers user JIT. When Phase 2 detects an existing PE and the user accepts it (Phase 3.A) — or when Phase 4.0 provisions a new PE via `getOrCreate` — Phase 5's `WhoAmI` call against `instanceApiUrl` triggers JIT before any subsequent host op. (For Custom Host paths the caller has access by construction.)
- 146 3. **Admin-only Custom Host fast-path.** PPAC's `New custom host` flow is gated by `DeploymentHubCreatePipelinesHostForAdminsOnly` and shows only for Global / Power Platform / Dynamics admins (eng.ms doc). The BAP env-create API also needs the equivalent privilege. Non-admins get 403; the skill preflight-attestation-prompts and gracefully falls back to manual paths.
- 147 4. **404 from BAP env GET is ambiguous.** Returns 404 for *deleted*, *disabled*, *no-PE*, and *no-access* without distinguishing (`PowerPipelines_PE_Knowledge.md` §6.A). We never treat a single 404 as "no host exists" — we corroborate via list-environments and the org setting before acting.
+ 146 3. **Admin-only Custom Host fast-path.** PPAC's `New custom host` flow is gated by `DeploymentHubCreatePipelinesHostForAdminsOnly` and shows only for Global / Power Platform / Dynamics admins. The BAP env-create API also needs the equivalent privilege. Non-admins get 403; the skill preflight-attestation-prompts and gracefully falls back to manual paths.
+ 147 4. **404 from BAP env GET is ambiguous.** Returns 404 for *deleted*, *disabled*, *no-PE*, and *no-access* without distinguishing. We never treat a single 404 as "no host exists" — we corroborate via list-environments and the org setting before acting.
- 237 The phase mirrors `ProjectHostProvider.tsx` exactly. The `useState` variables in that hook map to fields in our `RESOLUTION`:
- 238 
- 239 | TS variable | Our field |
+ 237 The phase mirrors the Power Apps UI's resolution exactly. Its state maps to fields in our `RESOLUTION`:
+ 238 
+ 239 | UI state | Our field |
- 241 | `orgSetting.orgDbOrgSettingValue` | `orgSettingHostEnvId` |
- 242 | `initialProjectHostEnvironmentId` | (same) |
- 243 | `isInitialHostPlatformEnvironment` | `isPlatform` |
- 244 | `defaultCustomPipelinesHost` | `tenantDefaultCustomHostEnvId` |
- 245 | `finalProjectHostEnvironmentId` | `finalHostEnvId` |
- 246 | `projectHostStatus` | `status` |
+ 241 | the source env's `ProjectHostEnvironmentId` org setting | `orgSettingHostEnvId` |
+ 242 | the host that setting names | (same) |
+ 243 | whether that host is a Platform Environment | `isPlatform` |
+ 244 | the tenant's default custom host (`DefaultCustomPipelinesHostEnvForTenant`) | `tenantDefaultCustomHostEnvId` |
+ 245 | the resolved host | `finalHostEnvId` |
+ 246 | the resolution status | `status` |
- 250 1. **Org-setting probe** (mirrors `useGetOrgDbOrgSetting('ProjectHostEnvironmentId')` line 103 in tsx). New helper `check-env-host-binding.js`:
+ 250 1. **Org-setting probe** (reads the `ProjectHostEnvironmentId` org setting, as the UI does). New helper `check-env-host-binding.js`:
- 260 2. **Resolve env via BAP** (mirrors `useGetEnvironmentByName(initialProjectHostEnvironmentId)` line 483 in tsx). New helper `resolve-env-by-id.js`:
+ 260 2. **Resolve env via BAP** (looks the host up by its environment id, as the UI does). New helper `resolve-env-by-id.js`:
- 272 3. **If `isPlatform === true`**, mirror the default-custom-tenant-setting check (lines 148–213 in tsx). Reuse the existing `discover-pipelines-host.js`:
+ 272 3. **If `isPlatform === true`**, mirror the UI's default-custom-tenant-setting check. Reuse the existing `discover-pipelines-host.js`:
- 597 The lowest-friction host-provisioning path. Calls the idempotent BAP `getOrCreate` endpoint with a `D365_1stPartyAdminApps` + `Platform` body. Same call `make.powerapps.com → Pipelines` page makes when a user clicks "Get started" — we just invoke it directly. Spec from `useGetOrCreatePlatformEnvironment.v4.ts`. New helper `provision-platform-host.js`.
+ 597 The lowest-friction host-provisioning path. Calls the idempotent BAP `getOrCreate` endpoint with a `D365_1stPartyAdminApps` + `Platform` body. Same call `make.powerapps.com → Pipelines` page makes when a user clicks "Get started" — we just invoke it directly. New helper `provision-platform-host.js`.
- 648 Standard env-create API with the `D365_ProjectHost` template (eng.ms-documented; same template PPAC `New custom host` uses internally). New helper `provision-custom-host.js`.
+ 648 Standard env-create API with the `D365_ProjectHost` template (the same template PPAC's `New custom host` uses). New helper `provision-custom-host.js`.
- 804    > Per eng.ms doc: *"the panel will default to the Production environment type. Adding Dataverse is also required... template and sample apps options are hidden here, as we use a specific organization template for this scenario."* (The template is `D365_ProjectHost` — same one Path 4.A automates.)
+ 804    > The panel defaults to the Production environment type and requires Dataverse; its template and sample-app options are hidden because the scenario uses a specific organization template (`D365_ProjectHost` — the same one Path 4.A automates).
- 1014 4. **`BapApiVersion` value for env-create.** The `D365_ProjectHost` template was onboarded for Pegasus / BAP-RP / Neptune (per eng.ms PR list). The PPAC UI uses `2021-04-01` for env operations. Confirm during execution by capturing a fresh HAR from `New custom host`.
+ 1014 4. **`BapApiVersion` value for env-create.** The PPAC UI uses `2021-04-01` for env operations. Confirm during execution by capturing a fresh HAR from `New custom host`.
- 1020 10. ~~**Per-env probe rate-limit budget.**~~ ✅ **PARTIALLY RESOLVED 2026-04-28**: Microsoft-internal test tenant has 1000 envs (526 Production sku, 453 Sandbox). Naïve probe-all is too slow even with 10-concurrent. Adopted multi-tier filter:
+ 1020 10. ~~**Per-env probe rate-limit budget.**~~ ✅ **PARTIALLY RESOLVED 2026-04-28**: a large test tenant has 1000 envs (526 Production sku, 453 Sandbox). Naïve probe-all is too slow even with 10-concurrent. Adopted multi-tier filter:

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Instructions only → After Instructions only

c159268b994b → 9a3cf2e61277

Compare on GitHub

Before Not checked yet → After Instructions only

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub

Before Network or broad shell → After Network or broad shell

c159268b994b → 9a3cf2e61277

- 38 1. Check Node.js 22/24 LTS and Azure CLI 2.54+ (`az version`).
+ 38 1. Check Node.js 22+ (prefer a maintained LTS release) and Azure CLI 2.54+ (`az version`).

Compare on GitHub

Before Not checked yet → After Network or broad shell

First observation → c159268b994b

No earlier version was observed for comparison.

Compare on GitHub