[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-microsoft-force-link-environment":3,"mdc--3w7cip-key":40,"related-repo-microsoft-force-link-environment":2631,"related-org-microsoft-force-link-environment":2728},{"slug":4,"name":4,"fn":5,"description":6,"org":7,"tags":11,"stars":23,"repoUrl":24,"updatedAt":25,"license":26,"forks":27,"topics":28,"repo":35,"sourceUrl":38,"mdContent":39},"force-link-environment","link environments to Power Platform Pipelines","Force-links a development or target environment to a Power Platform Pipelines host, overriding any existing association with a previous host. Use when creating a deploymentenvironments record fails with \"this environment is already associated with another pipelines host\", or when intentionally migrating an environment from one host to another (e.g., Platform Host → Custom Host, or between two Custom Hosts). Calls the documented `ManageEnvironmentStamp` Dataverse action (the API behind the \"Force Link\" button in the Deployment Pipeline Configuration app). DESTRUCTIVE to the previous host: makers lose access to any pipelines in that host that used this environment. Reversible by running Force Link from the previous host. Use when asked to: \"force link environment\", \"force-link to new host\", \"switch pipelines host\", \"environment already associated with another host\", \"take over pipelines association\", \"relink environment to host\".",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},"microsoft","Microsoft","https:\u002F\u002Fpexgzepcugksgbtrxkhf.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Forg-logos\u002Fmicrosoft.png",[12,16,17,20],{"name":13,"slug":14,"type":15},"Operations","operations","tag",{"name":9,"slug":8,"type":15},{"name":18,"slug":19,"type":15},"Deployment","deployment",{"name":21,"slug":22,"type":15},"Power Platform","power-platform",564,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fpower-platform-skills","2026-07-03T16:31:51.761308",null,114,[29,30,31,32,33,34,22],"claude-code-plugin","claude-code-skills","code-apps","github-copilot-plugin","power-apps","power-pages",{"repoUrl":24,"stars":23,"forks":27,"topics":36,"description":37},[29,30,31,32,33,34,22],"A plugin marketplace for Claude Code\u002FGitHub Copilot that provides Power Platform development plugins, including reusable skills, agents, and commands for building and deploying solutions.","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fpower-platform-skills\u002Ftree\u002FHEAD\u002Fplugins\u002Fpower-pages\u002Fskills\u002Fforce-link-environment","---\nname: force-link-environment\ndescription: >-\n  Force-links a development or target environment to a Power Platform Pipelines\n  host, overriding any existing association with a previous host. Use when\n  creating a deploymentenvironments record fails with \"this environment is\n  already associated with another pipelines host\", or when intentionally\n  migrating an environment from one host to another (e.g., Platform Host →\n  Custom Host, or between two Custom Hosts). Calls the documented\n  `ManageEnvironmentStamp` Dataverse action (the API behind the \"Force Link\"\n  button in the Deployment Pipeline Configuration app). DESTRUCTIVE to the\n  previous host: makers lose access to any pipelines in that host that used\n  this environment. Reversible by running Force Link from the previous host.\n  Use when asked to: \"force link environment\", \"force-link to new host\",\n  \"switch pipelines host\", \"environment already associated with another host\",\n  \"take over pipelines association\", \"relink environment to host\".\nuser-invocable: true\nargument-hint: \"Optional: '--host \u003Curl>' to skip the host resolution step; '--dev-env \u003CbapEnvId>' to skip the dev env prompt. With both flags supplied, the skill still pauses for destructive-action confirmation.\"\nallowed-tools: Read, Write, Edit, Bash, Glob, Grep, TaskCreate, TaskUpdate, TaskList, AskUserQuestion, mcp__plugin_power-pages_microsoft-learn__microsoft_docs_search, mcp__plugin_power-pages_microsoft-learn__microsoft_docs_fetch\nmodel: opus\n---\n\n> **Plugin check**: Run `node \"${PLUGIN_ROOT}\u002Fscripts\u002Fcheck-version.js\"` — if it outputs a message, show it to the user before proceeding.\n\n# force-link-environment\n\nMove a dev or target environment's Power Platform Pipelines host association from one host to another. This is the documented remediation when `deploymentenvironments` create fails with *\"this environment is already associated with another pipelines host\"*, and also the right tool when intentionally migrating environments between hosts.\n\n**Microsoft Learn (ground truth):** [Using Force Link to associate an environment with a new host](https:\u002F\u002Flearn.microsoft.com\u002Fen-us\u002Fpower-platform\u002Falm\u002Fcustom-host-pipelines#using-force-link-to-associate-an-environment-with-a-new-host)\n\n## What this skill changes\n\nIn the **target host** (the new host the user wants to use):\n- Marks the existing `deploymentenvironments` record as the active stamp for the BAP environment.\n- Re-runs validation; on success, `validationstatus` flips to `Succeeded` (200000001).\n\nIn the **previous host** (the host the env was previously linked to):\n- The corresponding `deploymentenvironments` row is **delinked**. Its `validationstatus` is left stale until refreshed in the previous host's UI.\n- Makers who could run pipelines through that environment in the previous host **lose access** to those pipelines via this environment.\n\nThe action is reversible by running Force Link again from the previous host.\n\n## Phase 1.5 — Microsoft Learn grounding (required)\n\nBefore any Dataverse call, refresh the agent's grounding by fetching the doc above via `mcp__plugin_power-pages_microsoft-learn__microsoft_docs_fetch`. If the doc has updated behaviors (e.g., new permission requirements, new warning text), surface them to the user before continuing. See `${PLUGIN_ROOT}\u002Freferences\u002Falm-docs-grounding.md` for the shared pattern.\n\n## Phases\n\n| # | Phase | Output |\n|---|---|---|\n| 1 | Prerequisites | Azure CLI token for the host environment; PAC CLI authenticated |\n| 1.5 | MCP Learn grounding | Confirmed current behavior of Force Link \u002F `ManageEnvironmentStamp` |\n| 2 | Identify host + dev env | `hostEnvUrl`, target host's `deploymentEnvironmentId`, source BAP env GUID |\n| 3 | Resolve `deploymentenvironments` record | Either an existing record on the new host, or a freshly created one |\n| 4 | Confirm destructive action | Explicit user consent via `AskUserQuestion` |\n| 5 | Execute Force Link | 204 from `ManageEnvironmentStamp` + post-validation Succeeded |\n| 6 | Write marker + summary | `docs\u002Falm\u002Flast-force-link.json` + human-readable summary |\n\nCreate all tasks at Phase 1 start with `TaskCreate`. Mark each `in_progress` when starting and `completed` when done.\n\n---\n\n## Phase 1 — Prerequisites\n\nReuse the shared verifier:\n\n```bash\nnode \"${PLUGIN_ROOT}\u002Fscripts\u002Flib\u002Fverify-alm-prerequisites.js\"\n```\n\nSpecifically required:\n- **PAC CLI auth** — `pac env who` must report an authenticated environment (for `--dev-env` auto-discovery).\n- **Azure CLI auth** — `az account show` succeeds.\n- **Host-scoped token** — the caller must have Deployment Pipeline Administrator on the target host (the host the env is being linked TO). Without it, `ManageEnvironmentStamp` returns 403.\n\nFetch the host token from Azure CLI using the host's Dataverse URL as the resource. Reuse `getAuthToken` from `scripts\u002Flib\u002Fvalidation-helpers.js`.\n\n## Phase 1.5 — MCP Learn grounding\n\nCall:\n\n```\nmcp__plugin_power-pages_microsoft-learn__microsoft_docs_fetch(url=\n  \"https:\u002F\u002Flearn.microsoft.com\u002Fen-us\u002Fpower-platform\u002Falm\u002Fcustom-host-pipelines\")\n```\n\nConfirm the *\"Using Force Link…\"* section's current warnings before proceeding. If the section now mentions new prerequisites or rollback constraints not covered in this skill, surface them to the user.\n\n## Phase 2 — Identify host + dev env\n\n\u003C!-- gate: force-link-environment:2.host-url | category=plan | cancel-leaves=nothing -->\n\n> 🚦 **Gate (plan · force-link-environment:2.host-url):** Pick the target host environment URL when arg \u002F marker resolution paths all came up empty. Fires only on the \"no `--host` arg, no `last-host-check.json`, no `last-pipeline.json`\" branch (step 4 below).\n>\n> **Trigger:** Phase 2 resolution order steps 1–3 all returned no value.\n> **Why we ask:** Auto-picking the wrong host runs `ManageEnvironmentStamp` against the wrong tenant and moves the stamp irreversibly without consent.\n> **Cancel leaves:** Nothing — no API call yet.\n\n\u003C!-- gate: force-link-environment:2.dev-env | category=plan | cancel-leaves=nothing -->\n\n> 🚦 **Gate (plan · force-link-environment:2.dev-env):** Pick (or paste) the source dev env's BAP env GUID when `--dev-env` arg is absent and `pac env who` didn't confirm. Fires only on the \"no arg + no confirmation\" branch (step 3 below).\n>\n> **Trigger:** Phase 2 BAP-GUID resolution steps 1–2 all returned no value.\n> **Why we ask:** Auto-picking the wrong dev env relinks a different env to the new host — makers of the wrong env lose pipeline access.\n> **Cancel leaves:** Nothing — no API call yet.\n\nResolution order for `hostEnvUrl`:\n1. `--host \u003Curl>` argument, if supplied.\n2. `docs\u002Falm\u002Flast-host-check.json` (written by `ensure-pipelines-host`) — read `finalHostEnvUrl`.\n3. `docs\u002Falm\u002Flast-pipeline.json` — read `hostEnvUrl`.\n4. Prompt user via `AskUserQuestion`.\n\nResolution order for the source dev env's BAP env GUID:\n1. `--dev-env \u003Cguid>` argument, if supplied.\n2. `pac env who` (current PAC CLI env) — but ONLY if the user confirms this is the env to relink.\n3. Prompt user via `AskUserQuestion`.\n\n## Phase 3 — Resolve `deploymentenvironments` record on the new host\n\n**Goal of this phase:** obtain the `deploymentEnvironmentId` (the new host's record ID) regardless of whether it already exists, just got created, or got created in a Failed state. Force Link in Phase 5 cannot run without that GUID.\n\n### Step 3.1 — Look up by BAP env GUID\n\n```bash\nGET {hostEnvUrl}\u002Fapi\u002Fdata\u002Fv9.1\u002Fdeploymentenvironments?$filter=environmentid eq '{bapEnvId}'&$select=deploymentenvironmentid,name,environmenttype,validationstatus,errormessage\n```\n\n| Result | Action |\n|---|---|\n| One hit, `validationstatus = 200000001` (Succeeded) | Already linked to this host. Skip to Phase 6 with a no-op summary; no Force Link needed. |\n| One hit, `validationstatus = 200000002` (Failed) | This is the *\"already associated with another pipelines host\"* state. Capture `deploymentenvironmentid` + `errormessage`. Skip to Phase 4 with those values. |\n| One hit, `validationstatus = 200000000` (Pending) | Wait briefly (3–5 s) and re-query. If still Pending after ~20 s, abort with a \"validation still in progress; retry later\" message. |\n| Zero hits | Continue to Step 3.2 — the record needs to be created first. |\n\n### Step 3.2 — Create the record on the new host (when Step 3.1 returned zero hits)\n\n```bash\nnode \"${PLUGIN_ROOT}\u002Fscripts\u002Flib\u002Fcreate-deployment-environment.js\" \\\n  --hostEnvUrl \u003ChostEnvUrl> \\\n  --token \u003ChostToken> \\\n  --name \"\u003Cdisplay name>\" \\\n  --bapEnvId \u003CbapEnvId> \\\n  --environmentType \u003C200000000|200000001>\n```\n\nThe helper polls `validationstatus` and **throws on Failed** without returning the new record's GUID in the error payload. Three outcomes to handle:\n\n| Helper outcome | Action |\n|---|---|\n| Resolves with `validationStatus = Succeeded` | Record is fully linked. Skip to Phase 6 — no Force Link needed. |\n| Throws with message containing *\"already associated with another pipelines host\"* (or similar host-claim wording) | The record **was** created in Failed state but the helper's error doesn't surface the new GUID. **Re-run Step 3.1's GET to recover the just-created record's `deploymentenvironmentid`**, then proceed to Phase 4 with that ID + the captured errormessage. Do NOT retry the create — it would log a duplicate `name`. |\n| Throws with any other message | Surface the error verbatim and abort. Force Link is not the right tool — this is a different failure (e.g., 403 on create = caller lacks role on host; 400 = bad `bapEnvId`). |\n\n**Why the re-query is necessary:** `create-deployment-environment.js` is idempotent on subsequent calls (it short-circuits via `findExistingByBapId`), but on the *first* call that lands in Failed validation it raises before the return path runs. Re-querying by `environmentid eq '{bapEnvId}'` is the canonical recovery — the same query Step 3.1 already uses.\n\nAfter this phase ends, you must hold a non-null `deploymentEnvironmentId`. If you don't, abort Phase 4 with a clear \"could not resolve record on new host\" message.\n\n## Phase 4 — Confirm destructive action\n\n\u003C!-- gate: force-link-environment:4.destructive | category=consent | cancel-leaves=nothing -->\n> 🚦 **Gate (consent · force-link-environment:4.destructive):** Mandatory consent before `ManageEnvironmentStamp` cross-host stamp move. Previous host loses pipeline access for this env. Reversible only by re-running Force Link from the previous host. **Fires fresh on every skill invocation.** Each invocation force-links exactly one env to one host. If a maker needs to migrate multiple envs across hosts, they invoke this skill once per env — each invocation requires its own consent prompt with its own env identity echoed back. No `--yes` flag, no batch mode, no consent carry-over.\n\nThis is the **mandatory** gate. Use `AskUserQuestion` with both options and a clear destructive-action warning in the question text. Required fields to display before asking:\n\n- Target host (the new host)\n- Source environment name + BAP env GUID\n- The error message from the previous host's stamp (from Phase 3), if any\n- Documented side effects:\n  - \"Makers in the previous host lose pipeline access for this environment\"\n  - \"The previous host's environment record is left with a stale validation status\"\n  - \"Reversible by running Force Link from the previous host\"\n\nQuestion structure:\n\n```\nquestion: \"Force-link this environment to \u003Chost name>? This will remove its association with the previous host.\"\noptions:\n  - \"Yes — force link\" (Recommended only if user is intentionally migrating)\n  - \"Cancel\"\n```\n\nIf the user picks Cancel, exit cleanly (no marker file written) and recommend `\u002Fpower-pages:ensure-pipelines-host detect-only` for further diagnosis.\n\n## Phase 5 — Execute Force Link\n\n```bash\nnode \"${PLUGIN_ROOT}\u002Fscripts\u002Flib\u002Fforce-link-environment.js\" \\\n  --hostEnvUrl \u003ChostEnvUrl> \\\n  --token \u003ChostToken> \\\n  --deploymentEnvironmentId \u003Cguid>\n```\n\nThe helper:\n1. Calls `ManageEnvironmentStamp` (returns 204 No Content on success).\n2. Re-polls `validationstatus` on the same record every 3s up to 20 attempts.\n3. Resolves on Succeeded (200000001), throws on Failed (200000002) with the captured `errormessage`.\n\nIf the helper throws with status 403, the caller lacks Deployment Pipeline Administrator on the target host — surface that as the remediation message.\n\nIf the helper throws with status 404, the `deploymentenvironments` record doesn't exist on the target host — Phase 3 must have failed silently; loop back.\n\n## Phase 6 — Write marker + summary\n\nEnsure the `docs\u002Falm\u002F` directory exists (`node -e \"require('fs').mkdirSync('docs\u002Falm',{recursive:true})\"`), then write `docs\u002Falm\u002Flast-force-link.json`:\n\n```json\n{\n  \"schemaVersion\": 1,\n  \"hostEnvUrl\": \"https:\u002F\u002F...\",\n  \"deploymentEnvironmentId\": \"...\",\n  \"bapEnvId\": \"...\",\n  \"previousHostEnvUrl\": \"https:\u002F\u002F...\",\n  \"validationStatus\": 200000001,\n  \"forcedAt\": \"2026-05-11T...\"\n}\n```\n\n`previousHostEnvUrl` is best-effort. Derive in this order; leave `null` if none of these yield a value:\n1. **From `docs\u002Falm\u002Flast-host-check.json`** (written by `ensure-pipelines-host`): if `finalHostEnvUrl` is set AND differs from the current `hostEnvUrl`, the discovery flow had already bound this env to that previous host — record it.\n2. **From Phase 3's errormessage**: scan the captured `errormessage` for the pattern `https?:\u002F\u002F[^\\s'\"]+\\.(crm\\d*\\.dynamics\\.com|dynamics-int\\.com|crm\\.microsoftdynamics\\.us)` and pick the first match that is **not** the current `hostEnvUrl`. Microsoft's error wording on the \"already associated\" path sometimes includes the prior host's URL, sometimes only its display name; treat the regex as opportunistic, not authoritative.\n3. **Otherwise**: leave `null`. The marker schema permits this — validator does not require the field.\n\nDo NOT prompt the user to fill `previousHostEnvUrl`; it's informational only for the post-run summary.\n\nPresent a summary table with:\n- Environment force-linked\n- Old host → new host\n- Validation status\n- Reminder: \"You can undo this by running `\u002Fpower-pages:force-link-environment` from the previous host.\"\n\nRecord skill usage per `${PLUGIN_ROOT}\u002Freferences\u002Fskill-tracking-reference.md`.\n\n---\n\n## Failure modes & remediation\n\n| Failure | Surface to user | Next step |\n|---|---|---|\n| `403 Forbidden` on `ManageEnvironmentStamp` | \"You need Deployment Pipeline Administrator role on \u003ChostName>.\" | Ask host admin to grant the role; documented in [share with pipeline administrators](https:\u002F\u002Flearn.microsoft.com\u002Fen-us\u002Fpower-platform\u002Falm\u002Fcustom-host-pipelines#share-with-pipeline-administrators). |\n| `404 Not Found` on the deployment env record | \"No deploymentenvironments record exists yet on this host.\" | Re-run Phase 3's create step. |\n| Post-link validation status flips to Failed | Show the `errormessage` verbatim. | If the message mentions the env is still associated with a host, the previous host may have an immediate-reapply policy — check with the previous host's admin. |\n| User cancels at Phase 4 | \"Force Link not performed; previous association preserved.\" | Suggest `\u002Fpower-pages:ensure-pipelines-host detect-only` for a wider diagnosis. |\n\n## What this skill does NOT do\n\n- It does not install the Pipelines application on the new host — use `\u002Fpower-pages:ensure-pipelines-host` for that.\n- It does not create the new host environment itself.\n- It does not re-link pipeline definitions; only the env↔host stamp is moved. Pipelines that referenced this env in the previous host stay there and lose this env as a participant.\n- It does not modify the user's solution. No `.solution-manifest.json` updates; no `AddSolutionComponent` calls.\n\n## Progress tracking\n\n| Phase | Status |\n|---|---|\n| 1 — Prerequisites | ⏳ |\n| 1.5 — MCP Learn grounding | ⏳ |\n| 2 — Identify host + dev env | ⏳ |\n| 3 — Resolve deploymentenvironments record | ⏳ |\n| 4 — Confirm destructive action | ⏳ |\n| 5 — Execute Force Link | ⏳ |\n| 6 — Write marker + summary | ⏳ |\n\nUpdate this table as phases complete.\n",{"data":41,"body":46},{"name":4,"description":6,"user-invocable":42,"argument-hint":43,"allowed-tools":44,"model":45},true,"Optional: '--host \u003Curl>' to skip the host resolution step; '--dev-env \u003CbapEnvId>' to skip the dev env prompt. With both flags supplied, the skill still pauses for destructive-action confirmation.","Read, Write, Edit, Bash, Glob, Grep, TaskCreate, TaskUpdate, TaskList, AskUserQuestion, mcp__plugin_power-pages_microsoft-learn__microsoft_docs_search, mcp__plugin_power-pages_microsoft-learn__microsoft_docs_fetch","opus",{"type":47,"children":48},"root",[49,76,81,102,121,128,140,178,189,230,235,241,262,268,473,502,506,512,517,568,573,636,657,663,668,678,690,696,766,814,826,895,900,933,946,963,970,1030,1149,1155,1341,1360,1466,1506,1518,1524,1560,1578,1619,1624,1633,1646,1652,1771,1776,1814,1819,1831,1837,1864,2130,2148,2242,2254,2259,2290,2302,2305,2311,2455,2461,2508,2514,2620,2625],{"type":50,"tag":51,"props":52,"children":53},"element","blockquote",{},[54],{"type":50,"tag":55,"props":56,"children":57},"p",{},[58,65,67,74],{"type":50,"tag":59,"props":60,"children":61},"strong",{},[62],{"type":63,"value":64},"text","Plugin check",{"type":63,"value":66},": Run ",{"type":50,"tag":68,"props":69,"children":71},"code",{"className":70},[],[72],{"type":63,"value":73},"node \"${PLUGIN_ROOT}\u002Fscripts\u002Fcheck-version.js\"",{"type":63,"value":75}," — if it outputs a message, show it to the user before proceeding.",{"type":50,"tag":77,"props":78,"children":79},"h1",{"id":4},[80],{"type":63,"value":4},{"type":50,"tag":55,"props":82,"children":83},{},[84,86,92,94,100],{"type":63,"value":85},"Move a dev or target environment's Power Platform Pipelines host association from one host to another. This is the documented remediation when ",{"type":50,"tag":68,"props":87,"children":89},{"className":88},[],[90],{"type":63,"value":91},"deploymentenvironments",{"type":63,"value":93}," create fails with ",{"type":50,"tag":95,"props":96,"children":97},"em",{},[98],{"type":63,"value":99},"\"this environment is already associated with another pipelines host\"",{"type":63,"value":101},", and also the right tool when intentionally migrating environments between hosts.",{"type":50,"tag":55,"props":103,"children":104},{},[105,110,112],{"type":50,"tag":59,"props":106,"children":107},{},[108],{"type":63,"value":109},"Microsoft Learn (ground truth):",{"type":63,"value":111}," ",{"type":50,"tag":113,"props":114,"children":118},"a",{"href":115,"rel":116},"https:\u002F\u002Flearn.microsoft.com\u002Fen-us\u002Fpower-platform\u002Falm\u002Fcustom-host-pipelines#using-force-link-to-associate-an-environment-with-a-new-host",[117],"nofollow",[119],{"type":63,"value":120},"Using Force Link to associate an environment with a new host",{"type":50,"tag":122,"props":123,"children":125},"h2",{"id":124},"what-this-skill-changes",[126],{"type":63,"value":127},"What this skill changes",{"type":50,"tag":55,"props":129,"children":130},{},[131,133,138],{"type":63,"value":132},"In the ",{"type":50,"tag":59,"props":134,"children":135},{},[136],{"type":63,"value":137},"target host",{"type":63,"value":139}," (the new host the user wants to use):",{"type":50,"tag":141,"props":142,"children":143},"ul",{},[144,157],{"type":50,"tag":145,"props":146,"children":147},"li",{},[148,150,155],{"type":63,"value":149},"Marks the existing ",{"type":50,"tag":68,"props":151,"children":153},{"className":152},[],[154],{"type":63,"value":91},{"type":63,"value":156}," record as the active stamp for the BAP environment.",{"type":50,"tag":145,"props":158,"children":159},{},[160,162,168,170,176],{"type":63,"value":161},"Re-runs validation; on success, ",{"type":50,"tag":68,"props":163,"children":165},{"className":164},[],[166],{"type":63,"value":167},"validationstatus",{"type":63,"value":169}," flips to ",{"type":50,"tag":68,"props":171,"children":173},{"className":172},[],[174],{"type":63,"value":175},"Succeeded",{"type":63,"value":177}," (200000001).",{"type":50,"tag":55,"props":179,"children":180},{},[181,182,187],{"type":63,"value":132},{"type":50,"tag":59,"props":183,"children":184},{},[185],{"type":63,"value":186},"previous host",{"type":63,"value":188}," (the host the env was previously linked to):",{"type":50,"tag":141,"props":190,"children":191},{},[192,218],{"type":50,"tag":145,"props":193,"children":194},{},[195,197,202,204,209,211,216],{"type":63,"value":196},"The corresponding ",{"type":50,"tag":68,"props":198,"children":200},{"className":199},[],[201],{"type":63,"value":91},{"type":63,"value":203}," row is ",{"type":50,"tag":59,"props":205,"children":206},{},[207],{"type":63,"value":208},"delinked",{"type":63,"value":210},". Its ",{"type":50,"tag":68,"props":212,"children":214},{"className":213},[],[215],{"type":63,"value":167},{"type":63,"value":217}," is left stale until refreshed in the previous host's UI.",{"type":50,"tag":145,"props":219,"children":220},{},[221,223,228],{"type":63,"value":222},"Makers who could run pipelines through that environment in the previous host ",{"type":50,"tag":59,"props":224,"children":225},{},[226],{"type":63,"value":227},"lose access",{"type":63,"value":229}," to those pipelines via this environment.",{"type":50,"tag":55,"props":231,"children":232},{},[233],{"type":63,"value":234},"The action is reversible by running Force Link again from the previous host.",{"type":50,"tag":122,"props":236,"children":238},{"id":237},"phase-15-microsoft-learn-grounding-required",[239],{"type":63,"value":240},"Phase 1.5 — Microsoft Learn grounding (required)",{"type":50,"tag":55,"props":242,"children":243},{},[244,246,252,254,260],{"type":63,"value":245},"Before any Dataverse call, refresh the agent's grounding by fetching the doc above via ",{"type":50,"tag":68,"props":247,"children":249},{"className":248},[],[250],{"type":63,"value":251},"mcp__plugin_power-pages_microsoft-learn__microsoft_docs_fetch",{"type":63,"value":253},". If the doc has updated behaviors (e.g., new permission requirements, new warning text), surface them to the user before continuing. See ",{"type":50,"tag":68,"props":255,"children":257},{"className":256},[],[258],{"type":63,"value":259},"${PLUGIN_ROOT}\u002Freferences\u002Falm-docs-grounding.md",{"type":63,"value":261}," for the shared pattern.",{"type":50,"tag":122,"props":263,"children":265},{"id":264},"phases",[266],{"type":63,"value":267},"Phases",{"type":50,"tag":269,"props":270,"children":271},"table",{},[272,296],{"type":50,"tag":273,"props":274,"children":275},"thead",{},[276],{"type":50,"tag":277,"props":278,"children":279},"tr",{},[280,286,291],{"type":50,"tag":281,"props":282,"children":283},"th",{},[284],{"type":63,"value":285},"#",{"type":50,"tag":281,"props":287,"children":288},{},[289],{"type":63,"value":290},"Phase",{"type":50,"tag":281,"props":292,"children":293},{},[294],{"type":63,"value":295},"Output",{"type":50,"tag":297,"props":298,"children":299},"tbody",{},[300,319,343,375,400,424,449],{"type":50,"tag":277,"props":301,"children":302},{},[303,309,314],{"type":50,"tag":304,"props":305,"children":306},"td",{},[307],{"type":63,"value":308},"1",{"type":50,"tag":304,"props":310,"children":311},{},[312],{"type":63,"value":313},"Prerequisites",{"type":50,"tag":304,"props":315,"children":316},{},[317],{"type":63,"value":318},"Azure CLI token for the host environment; PAC CLI authenticated",{"type":50,"tag":277,"props":320,"children":321},{},[322,327,332],{"type":50,"tag":304,"props":323,"children":324},{},[325],{"type":63,"value":326},"1.5",{"type":50,"tag":304,"props":328,"children":329},{},[330],{"type":63,"value":331},"MCP Learn grounding",{"type":50,"tag":304,"props":333,"children":334},{},[335,337],{"type":63,"value":336},"Confirmed current behavior of Force Link \u002F ",{"type":50,"tag":68,"props":338,"children":340},{"className":339},[],[341],{"type":63,"value":342},"ManageEnvironmentStamp",{"type":50,"tag":277,"props":344,"children":345},{},[346,351,356],{"type":50,"tag":304,"props":347,"children":348},{},[349],{"type":63,"value":350},"2",{"type":50,"tag":304,"props":352,"children":353},{},[354],{"type":63,"value":355},"Identify host + dev env",{"type":50,"tag":304,"props":357,"children":358},{},[359,365,367,373],{"type":50,"tag":68,"props":360,"children":362},{"className":361},[],[363],{"type":63,"value":364},"hostEnvUrl",{"type":63,"value":366},", target host's ",{"type":50,"tag":68,"props":368,"children":370},{"className":369},[],[371],{"type":63,"value":372},"deploymentEnvironmentId",{"type":63,"value":374},", source BAP env GUID",{"type":50,"tag":277,"props":376,"children":377},{},[378,383,395],{"type":50,"tag":304,"props":379,"children":380},{},[381],{"type":63,"value":382},"3",{"type":50,"tag":304,"props":384,"children":385},{},[386,388,393],{"type":63,"value":387},"Resolve ",{"type":50,"tag":68,"props":389,"children":391},{"className":390},[],[392],{"type":63,"value":91},{"type":63,"value":394}," record",{"type":50,"tag":304,"props":396,"children":397},{},[398],{"type":63,"value":399},"Either an existing record on the new host, or a freshly created one",{"type":50,"tag":277,"props":401,"children":402},{},[403,408,413],{"type":50,"tag":304,"props":404,"children":405},{},[406],{"type":63,"value":407},"4",{"type":50,"tag":304,"props":409,"children":410},{},[411],{"type":63,"value":412},"Confirm destructive action",{"type":50,"tag":304,"props":414,"children":415},{},[416,418],{"type":63,"value":417},"Explicit user consent via ",{"type":50,"tag":68,"props":419,"children":421},{"className":420},[],[422],{"type":63,"value":423},"AskUserQuestion",{"type":50,"tag":277,"props":425,"children":426},{},[427,432,437],{"type":50,"tag":304,"props":428,"children":429},{},[430],{"type":63,"value":431},"5",{"type":50,"tag":304,"props":433,"children":434},{},[435],{"type":63,"value":436},"Execute Force Link",{"type":50,"tag":304,"props":438,"children":439},{},[440,442,447],{"type":63,"value":441},"204 from ",{"type":50,"tag":68,"props":443,"children":445},{"className":444},[],[446],{"type":63,"value":342},{"type":63,"value":448}," + post-validation Succeeded",{"type":50,"tag":277,"props":450,"children":451},{},[452,457,462],{"type":50,"tag":304,"props":453,"children":454},{},[455],{"type":63,"value":456},"6",{"type":50,"tag":304,"props":458,"children":459},{},[460],{"type":63,"value":461},"Write marker + summary",{"type":50,"tag":304,"props":463,"children":464},{},[465,471],{"type":50,"tag":68,"props":466,"children":468},{"className":467},[],[469],{"type":63,"value":470},"docs\u002Falm\u002Flast-force-link.json",{"type":63,"value":472}," + human-readable summary",{"type":50,"tag":55,"props":474,"children":475},{},[476,478,484,486,492,494,500],{"type":63,"value":477},"Create all tasks at Phase 1 start with ",{"type":50,"tag":68,"props":479,"children":481},{"className":480},[],[482],{"type":63,"value":483},"TaskCreate",{"type":63,"value":485},". Mark each ",{"type":50,"tag":68,"props":487,"children":489},{"className":488},[],[490],{"type":63,"value":491},"in_progress",{"type":63,"value":493}," when starting and ",{"type":50,"tag":68,"props":495,"children":497},{"className":496},[],[498],{"type":63,"value":499},"completed",{"type":63,"value":501}," when done.",{"type":50,"tag":503,"props":504,"children":505},"hr",{},[],{"type":50,"tag":122,"props":507,"children":509},{"id":508},"phase-1-prerequisites",[510],{"type":63,"value":511},"Phase 1 — Prerequisites",{"type":50,"tag":55,"props":513,"children":514},{},[515],{"type":63,"value":516},"Reuse the shared verifier:",{"type":50,"tag":518,"props":519,"children":524},"pre",{"className":520,"code":521,"language":522,"meta":523,"style":523},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","node \"${PLUGIN_ROOT}\u002Fscripts\u002Flib\u002Fverify-alm-prerequisites.js\"\n","bash","",[525],{"type":50,"tag":68,"props":526,"children":527},{"__ignoreMap":523},[528],{"type":50,"tag":529,"props":530,"children":533},"span",{"class":531,"line":532},"line",1,[534,540,546,552,557,563],{"type":50,"tag":529,"props":535,"children":537},{"style":536},"--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B",[538],{"type":63,"value":539},"node",{"type":50,"tag":529,"props":541,"children":543},{"style":542},"--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF",[544],{"type":63,"value":545}," \"${",{"type":50,"tag":529,"props":547,"children":549},{"style":548},"--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8",[550],{"type":63,"value":551},"PLUGIN_ROOT",{"type":50,"tag":529,"props":553,"children":554},{"style":542},[555],{"type":63,"value":556},"}",{"type":50,"tag":529,"props":558,"children":560},{"style":559},"--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D",[561],{"type":63,"value":562},"\u002Fscripts\u002Flib\u002Fverify-alm-prerequisites.js",{"type":50,"tag":529,"props":564,"children":565},{"style":542},[566],{"type":63,"value":567},"\"\n",{"type":50,"tag":55,"props":569,"children":570},{},[571],{"type":63,"value":572},"Specifically required:",{"type":50,"tag":141,"props":574,"children":575},{},[576,602,619],{"type":50,"tag":145,"props":577,"children":578},{},[579,584,586,592,594,600],{"type":50,"tag":59,"props":580,"children":581},{},[582],{"type":63,"value":583},"PAC CLI auth",{"type":63,"value":585}," — ",{"type":50,"tag":68,"props":587,"children":589},{"className":588},[],[590],{"type":63,"value":591},"pac env who",{"type":63,"value":593}," must report an authenticated environment (for ",{"type":50,"tag":68,"props":595,"children":597},{"className":596},[],[598],{"type":63,"value":599},"--dev-env",{"type":63,"value":601}," auto-discovery).",{"type":50,"tag":145,"props":603,"children":604},{},[605,610,611,617],{"type":50,"tag":59,"props":606,"children":607},{},[608],{"type":63,"value":609},"Azure CLI auth",{"type":63,"value":585},{"type":50,"tag":68,"props":612,"children":614},{"className":613},[],[615],{"type":63,"value":616},"az account show",{"type":63,"value":618}," succeeds.",{"type":50,"tag":145,"props":620,"children":621},{},[622,627,629,634],{"type":50,"tag":59,"props":623,"children":624},{},[625],{"type":63,"value":626},"Host-scoped token",{"type":63,"value":628}," — the caller must have Deployment Pipeline Administrator on the target host (the host the env is being linked TO). Without it, ",{"type":50,"tag":68,"props":630,"children":632},{"className":631},[],[633],{"type":63,"value":342},{"type":63,"value":635}," returns 403.",{"type":50,"tag":55,"props":637,"children":638},{},[639,641,647,649,655],{"type":63,"value":640},"Fetch the host token from Azure CLI using the host's Dataverse URL as the resource. Reuse ",{"type":50,"tag":68,"props":642,"children":644},{"className":643},[],[645],{"type":63,"value":646},"getAuthToken",{"type":63,"value":648}," from ",{"type":50,"tag":68,"props":650,"children":652},{"className":651},[],[653],{"type":63,"value":654},"scripts\u002Flib\u002Fvalidation-helpers.js",{"type":63,"value":656},".",{"type":50,"tag":122,"props":658,"children":660},{"id":659},"phase-15-mcp-learn-grounding",[661],{"type":63,"value":662},"Phase 1.5 — MCP Learn grounding",{"type":50,"tag":55,"props":664,"children":665},{},[666],{"type":63,"value":667},"Call:",{"type":50,"tag":518,"props":669,"children":673},{"className":670,"code":672,"language":63},[671],"language-text","mcp__plugin_power-pages_microsoft-learn__microsoft_docs_fetch(url=\n  \"https:\u002F\u002Flearn.microsoft.com\u002Fen-us\u002Fpower-platform\u002Falm\u002Fcustom-host-pipelines\")\n",[674],{"type":50,"tag":68,"props":675,"children":676},{"__ignoreMap":523},[677],{"type":63,"value":672},{"type":50,"tag":55,"props":679,"children":680},{},[681,683,688],{"type":63,"value":682},"Confirm the ",{"type":50,"tag":95,"props":684,"children":685},{},[686],{"type":63,"value":687},"\"Using Force Link…\"",{"type":63,"value":689}," section's current warnings before proceeding. If the section now mentions new prerequisites or rollback constraints not covered in this skill, surface them to the user.",{"type":50,"tag":122,"props":691,"children":693},{"id":692},"phase-2-identify-host-dev-env",[694],{"type":63,"value":695},"Phase 2 — Identify host + dev env",{"type":50,"tag":51,"props":697,"children":698},{},[699,735],{"type":50,"tag":55,"props":700,"children":701},{},[702,704,709,711,717,719,725,727,733],{"type":63,"value":703},"🚦 ",{"type":50,"tag":59,"props":705,"children":706},{},[707],{"type":63,"value":708},"Gate (plan · force-link-environment:2.host-url):",{"type":63,"value":710}," Pick the target host environment URL when arg \u002F marker resolution paths all came up empty. Fires only on the \"no ",{"type":50,"tag":68,"props":712,"children":714},{"className":713},[],[715],{"type":63,"value":716},"--host",{"type":63,"value":718}," arg, no ",{"type":50,"tag":68,"props":720,"children":722},{"className":721},[],[723],{"type":63,"value":724},"last-host-check.json",{"type":63,"value":726},", no ",{"type":50,"tag":68,"props":728,"children":730},{"className":729},[],[731],{"type":63,"value":732},"last-pipeline.json",{"type":63,"value":734},"\" branch (step 4 below).",{"type":50,"tag":55,"props":736,"children":737},{},[738,743,745,750,752,757,759,764],{"type":50,"tag":59,"props":739,"children":740},{},[741],{"type":63,"value":742},"Trigger:",{"type":63,"value":744}," Phase 2 resolution order steps 1–3 all returned no value.\n",{"type":50,"tag":59,"props":746,"children":747},{},[748],{"type":63,"value":749},"Why we ask:",{"type":63,"value":751}," Auto-picking the wrong host runs ",{"type":50,"tag":68,"props":753,"children":755},{"className":754},[],[756],{"type":63,"value":342},{"type":63,"value":758}," against the wrong tenant and moves the stamp irreversibly without consent.\n",{"type":50,"tag":59,"props":760,"children":761},{},[762],{"type":63,"value":763},"Cancel leaves:",{"type":63,"value":765}," Nothing — no API call yet.",{"type":50,"tag":51,"props":767,"children":768},{},[769,794],{"type":50,"tag":55,"props":770,"children":771},{},[772,773,778,780,785,787,792],{"type":63,"value":703},{"type":50,"tag":59,"props":774,"children":775},{},[776],{"type":63,"value":777},"Gate (plan · force-link-environment:2.dev-env):",{"type":63,"value":779}," Pick (or paste) the source dev env's BAP env GUID when ",{"type":50,"tag":68,"props":781,"children":783},{"className":782},[],[784],{"type":63,"value":599},{"type":63,"value":786}," arg is absent and ",{"type":50,"tag":68,"props":788,"children":790},{"className":789},[],[791],{"type":63,"value":591},{"type":63,"value":793}," didn't confirm. Fires only on the \"no arg + no confirmation\" branch (step 3 below).",{"type":50,"tag":55,"props":795,"children":796},{},[797,801,803,807,809,813],{"type":50,"tag":59,"props":798,"children":799},{},[800],{"type":63,"value":742},{"type":63,"value":802}," Phase 2 BAP-GUID resolution steps 1–2 all returned no value.\n",{"type":50,"tag":59,"props":804,"children":805},{},[806],{"type":63,"value":749},{"type":63,"value":808}," Auto-picking the wrong dev env relinks a different env to the new host — makers of the wrong env lose pipeline access.\n",{"type":50,"tag":59,"props":810,"children":811},{},[812],{"type":63,"value":763},{"type":63,"value":765},{"type":50,"tag":55,"props":815,"children":816},{},[817,819,824],{"type":63,"value":818},"Resolution order for ",{"type":50,"tag":68,"props":820,"children":822},{"className":821},[],[823],{"type":63,"value":364},{"type":63,"value":825},":",{"type":50,"tag":827,"props":828,"children":829},"ol",{},[830,841,867,884],{"type":50,"tag":145,"props":831,"children":832},{},[833,839],{"type":50,"tag":68,"props":834,"children":836},{"className":835},[],[837],{"type":63,"value":838},"--host \u003Curl>",{"type":63,"value":840}," argument, if supplied.",{"type":50,"tag":145,"props":842,"children":843},{},[844,850,852,858,860,866],{"type":50,"tag":68,"props":845,"children":847},{"className":846},[],[848],{"type":63,"value":849},"docs\u002Falm\u002Flast-host-check.json",{"type":63,"value":851}," (written by ",{"type":50,"tag":68,"props":853,"children":855},{"className":854},[],[856],{"type":63,"value":857},"ensure-pipelines-host",{"type":63,"value":859},") — read ",{"type":50,"tag":68,"props":861,"children":863},{"className":862},[],[864],{"type":63,"value":865},"finalHostEnvUrl",{"type":63,"value":656},{"type":50,"tag":145,"props":868,"children":869},{},[870,876,878,883],{"type":50,"tag":68,"props":871,"children":873},{"className":872},[],[874],{"type":63,"value":875},"docs\u002Falm\u002Flast-pipeline.json",{"type":63,"value":877}," — read ",{"type":50,"tag":68,"props":879,"children":881},{"className":880},[],[882],{"type":63,"value":364},{"type":63,"value":656},{"type":50,"tag":145,"props":885,"children":886},{},[887,889,894],{"type":63,"value":888},"Prompt user via ",{"type":50,"tag":68,"props":890,"children":892},{"className":891},[],[893],{"type":63,"value":423},{"type":63,"value":656},{"type":50,"tag":55,"props":896,"children":897},{},[898],{"type":63,"value":899},"Resolution order for the source dev env's BAP env GUID:",{"type":50,"tag":827,"props":901,"children":902},{},[903,913,923],{"type":50,"tag":145,"props":904,"children":905},{},[906,912],{"type":50,"tag":68,"props":907,"children":909},{"className":908},[],[910],{"type":63,"value":911},"--dev-env \u003Cguid>",{"type":63,"value":840},{"type":50,"tag":145,"props":914,"children":915},{},[916,921],{"type":50,"tag":68,"props":917,"children":919},{"className":918},[],[920],{"type":63,"value":591},{"type":63,"value":922}," (current PAC CLI env) — but ONLY if the user confirms this is the env to relink.",{"type":50,"tag":145,"props":924,"children":925},{},[926,927,932],{"type":63,"value":888},{"type":50,"tag":68,"props":928,"children":930},{"className":929},[],[931],{"type":63,"value":423},{"type":63,"value":656},{"type":50,"tag":122,"props":934,"children":936},{"id":935},"phase-3-resolve-deploymentenvironments-record-on-the-new-host",[937,939,944],{"type":63,"value":938},"Phase 3 — Resolve ",{"type":50,"tag":68,"props":940,"children":942},{"className":941},[],[943],{"type":63,"value":91},{"type":63,"value":945}," record on the new host",{"type":50,"tag":55,"props":947,"children":948},{},[949,954,956,961],{"type":50,"tag":59,"props":950,"children":951},{},[952],{"type":63,"value":953},"Goal of this phase:",{"type":63,"value":955}," obtain the ",{"type":50,"tag":68,"props":957,"children":959},{"className":958},[],[960],{"type":63,"value":372},{"type":63,"value":962}," (the new host's record ID) regardless of whether it already exists, just got created, or got created in a Failed state. Force Link in Phase 5 cannot run without that GUID.",{"type":50,"tag":964,"props":965,"children":967},"h3",{"id":966},"step-31-look-up-by-bap-env-guid",[968],{"type":63,"value":969},"Step 3.1 — Look up by BAP env GUID",{"type":50,"tag":518,"props":971,"children":973},{"className":520,"code":972,"language":522,"meta":523,"style":523},"GET {hostEnvUrl}\u002Fapi\u002Fdata\u002Fv9.1\u002Fdeploymentenvironments?$filter=environmentid eq '{bapEnvId}'&$select=deploymentenvironmentid,name,environmenttype,validationstatus,errormessage\n",[974],{"type":50,"tag":68,"props":975,"children":976},{"__ignoreMap":523},[977],{"type":50,"tag":529,"props":978,"children":979},{"class":531,"line":532},[980,985,990,995,1000,1005,1010,1015,1020,1025],{"type":50,"tag":529,"props":981,"children":982},{"style":536},[983],{"type":63,"value":984},"GET",{"type":50,"tag":529,"props":986,"children":987},{"style":559},[988],{"type":63,"value":989}," {hostEnvUrl}\u002Fapi\u002Fdata\u002Fv9.1\u002Fdeploymentenvironments?",{"type":50,"tag":529,"props":991,"children":992},{"style":548},[993],{"type":63,"value":994},"$filter",{"type":50,"tag":529,"props":996,"children":997},{"style":559},[998],{"type":63,"value":999},"=environmentid",{"type":50,"tag":529,"props":1001,"children":1002},{"style":559},[1003],{"type":63,"value":1004}," eq",{"type":50,"tag":529,"props":1006,"children":1007},{"style":542},[1008],{"type":63,"value":1009}," '",{"type":50,"tag":529,"props":1011,"children":1012},{"style":559},[1013],{"type":63,"value":1014},"{bapEnvId}",{"type":50,"tag":529,"props":1016,"children":1017},{"style":542},[1018],{"type":63,"value":1019},"'",{"type":50,"tag":529,"props":1021,"children":1022},{"style":542},[1023],{"type":63,"value":1024},"&",{"type":50,"tag":529,"props":1026,"children":1027},{"style":548},[1028],{"type":63,"value":1029},"$select=deploymentenvironmentid,name,environmenttype,validationstatus,errormessage\n",{"type":50,"tag":269,"props":1031,"children":1032},{},[1033,1049],{"type":50,"tag":273,"props":1034,"children":1035},{},[1036],{"type":50,"tag":277,"props":1037,"children":1038},{},[1039,1044],{"type":50,"tag":281,"props":1040,"children":1041},{},[1042],{"type":63,"value":1043},"Result",{"type":50,"tag":281,"props":1045,"children":1046},{},[1047],{"type":63,"value":1048},"Action",{"type":50,"tag":297,"props":1050,"children":1051},{},[1052,1073,1116,1136],{"type":50,"tag":277,"props":1053,"children":1054},{},[1055,1068],{"type":50,"tag":304,"props":1056,"children":1057},{},[1058,1060,1066],{"type":63,"value":1059},"One hit, ",{"type":50,"tag":68,"props":1061,"children":1063},{"className":1062},[],[1064],{"type":63,"value":1065},"validationstatus = 200000001",{"type":63,"value":1067}," (Succeeded)",{"type":50,"tag":304,"props":1069,"children":1070},{},[1071],{"type":63,"value":1072},"Already linked to this host. Skip to Phase 6 with a no-op summary; no Force Link needed.",{"type":50,"tag":277,"props":1074,"children":1075},{},[1076,1088],{"type":50,"tag":304,"props":1077,"children":1078},{},[1079,1080,1086],{"type":63,"value":1059},{"type":50,"tag":68,"props":1081,"children":1083},{"className":1082},[],[1084],{"type":63,"value":1085},"validationstatus = 200000002",{"type":63,"value":1087}," (Failed)",{"type":50,"tag":304,"props":1089,"children":1090},{},[1091,1093,1098,1100,1106,1108,1114],{"type":63,"value":1092},"This is the ",{"type":50,"tag":95,"props":1094,"children":1095},{},[1096],{"type":63,"value":1097},"\"already associated with another pipelines host\"",{"type":63,"value":1099}," state. Capture ",{"type":50,"tag":68,"props":1101,"children":1103},{"className":1102},[],[1104],{"type":63,"value":1105},"deploymentenvironmentid",{"type":63,"value":1107}," + ",{"type":50,"tag":68,"props":1109,"children":1111},{"className":1110},[],[1112],{"type":63,"value":1113},"errormessage",{"type":63,"value":1115},". Skip to Phase 4 with those values.",{"type":50,"tag":277,"props":1117,"children":1118},{},[1119,1131],{"type":50,"tag":304,"props":1120,"children":1121},{},[1122,1123,1129],{"type":63,"value":1059},{"type":50,"tag":68,"props":1124,"children":1126},{"className":1125},[],[1127],{"type":63,"value":1128},"validationstatus = 200000000",{"type":63,"value":1130}," (Pending)",{"type":50,"tag":304,"props":1132,"children":1133},{},[1134],{"type":63,"value":1135},"Wait briefly (3–5 s) and re-query. If still Pending after ~20 s, abort with a \"validation still in progress; retry later\" message.",{"type":50,"tag":277,"props":1137,"children":1138},{},[1139,1144],{"type":50,"tag":304,"props":1140,"children":1141},{},[1142],{"type":63,"value":1143},"Zero hits",{"type":50,"tag":304,"props":1145,"children":1146},{},[1147],{"type":63,"value":1148},"Continue to Step 3.2 — the record needs to be created first.",{"type":50,"tag":964,"props":1150,"children":1152},{"id":1151},"step-32-create-the-record-on-the-new-host-when-step-31-returned-zero-hits",[1153],{"type":63,"value":1154},"Step 3.2 — Create the record on the new host (when Step 3.1 returned zero hits)",{"type":50,"tag":518,"props":1156,"children":1158},{"className":520,"code":1157,"language":522,"meta":523,"style":523},"node \"${PLUGIN_ROOT}\u002Fscripts\u002Flib\u002Fcreate-deployment-environment.js\" \\\n  --hostEnvUrl \u003ChostEnvUrl> \\\n  --token \u003ChostToken> \\\n  --name \"\u003Cdisplay name>\" \\\n  --bapEnvId \u003CbapEnvId> \\\n  --environmentType \u003C200000000|200000001>\n",[1159],{"type":50,"tag":68,"props":1160,"children":1161},{"__ignoreMap":523},[1162,1196,1229,1260,1287,1318],{"type":50,"tag":529,"props":1163,"children":1164},{"class":531,"line":532},[1165,1169,1173,1177,1181,1186,1191],{"type":50,"tag":529,"props":1166,"children":1167},{"style":536},[1168],{"type":63,"value":539},{"type":50,"tag":529,"props":1170,"children":1171},{"style":542},[1172],{"type":63,"value":545},{"type":50,"tag":529,"props":1174,"children":1175},{"style":548},[1176],{"type":63,"value":551},{"type":50,"tag":529,"props":1178,"children":1179},{"style":542},[1180],{"type":63,"value":556},{"type":50,"tag":529,"props":1182,"children":1183},{"style":559},[1184],{"type":63,"value":1185},"\u002Fscripts\u002Flib\u002Fcreate-deployment-environment.js",{"type":50,"tag":529,"props":1187,"children":1188},{"style":542},[1189],{"type":63,"value":1190},"\"",{"type":50,"tag":529,"props":1192,"children":1193},{"style":548},[1194],{"type":63,"value":1195}," \\\n",{"type":50,"tag":529,"props":1197,"children":1199},{"class":531,"line":1198},2,[1200,1205,1210,1215,1220,1225],{"type":50,"tag":529,"props":1201,"children":1202},{"style":559},[1203],{"type":63,"value":1204},"  --hostEnvUrl",{"type":50,"tag":529,"props":1206,"children":1207},{"style":542},[1208],{"type":63,"value":1209}," \u003C",{"type":50,"tag":529,"props":1211,"children":1212},{"style":559},[1213],{"type":63,"value":1214},"hostEnvUr",{"type":50,"tag":529,"props":1216,"children":1217},{"style":548},[1218],{"type":63,"value":1219},"l",{"type":50,"tag":529,"props":1221,"children":1222},{"style":542},[1223],{"type":63,"value":1224},">",{"type":50,"tag":529,"props":1226,"children":1227},{"style":548},[1228],{"type":63,"value":1195},{"type":50,"tag":529,"props":1230,"children":1232},{"class":531,"line":1231},3,[1233,1238,1242,1247,1252,1256],{"type":50,"tag":529,"props":1234,"children":1235},{"style":559},[1236],{"type":63,"value":1237},"  --token",{"type":50,"tag":529,"props":1239,"children":1240},{"style":542},[1241],{"type":63,"value":1209},{"type":50,"tag":529,"props":1243,"children":1244},{"style":559},[1245],{"type":63,"value":1246},"hostToke",{"type":50,"tag":529,"props":1248,"children":1249},{"style":548},[1250],{"type":63,"value":1251},"n",{"type":50,"tag":529,"props":1253,"children":1254},{"style":542},[1255],{"type":63,"value":1224},{"type":50,"tag":529,"props":1257,"children":1258},{"style":548},[1259],{"type":63,"value":1195},{"type":50,"tag":529,"props":1261,"children":1263},{"class":531,"line":1262},4,[1264,1269,1274,1279,1283],{"type":50,"tag":529,"props":1265,"children":1266},{"style":559},[1267],{"type":63,"value":1268},"  --name",{"type":50,"tag":529,"props":1270,"children":1271},{"style":542},[1272],{"type":63,"value":1273}," \"",{"type":50,"tag":529,"props":1275,"children":1276},{"style":559},[1277],{"type":63,"value":1278},"\u003Cdisplay name>",{"type":50,"tag":529,"props":1280,"children":1281},{"style":542},[1282],{"type":63,"value":1190},{"type":50,"tag":529,"props":1284,"children":1285},{"style":548},[1286],{"type":63,"value":1195},{"type":50,"tag":529,"props":1288,"children":1290},{"class":531,"line":1289},5,[1291,1296,1300,1305,1310,1314],{"type":50,"tag":529,"props":1292,"children":1293},{"style":559},[1294],{"type":63,"value":1295},"  --bapEnvId",{"type":50,"tag":529,"props":1297,"children":1298},{"style":542},[1299],{"type":63,"value":1209},{"type":50,"tag":529,"props":1301,"children":1302},{"style":559},[1303],{"type":63,"value":1304},"bapEnvI",{"type":50,"tag":529,"props":1306,"children":1307},{"style":548},[1308],{"type":63,"value":1309},"d",{"type":50,"tag":529,"props":1311,"children":1312},{"style":542},[1313],{"type":63,"value":1224},{"type":50,"tag":529,"props":1315,"children":1316},{"style":548},[1317],{"type":63,"value":1195},{"type":50,"tag":529,"props":1319,"children":1321},{"class":531,"line":1320},6,[1322,1327,1331,1336],{"type":50,"tag":529,"props":1323,"children":1324},{"style":559},[1325],{"type":63,"value":1326},"  --environmentType",{"type":50,"tag":529,"props":1328,"children":1329},{"style":542},[1330],{"type":63,"value":1209},{"type":50,"tag":529,"props":1332,"children":1333},{"style":559},[1334],{"type":63,"value":1335},"200000000",{"type":50,"tag":529,"props":1337,"children":1338},{"style":542},[1339],{"type":63,"value":1340},"|200000001>\n",{"type":50,"tag":55,"props":1342,"children":1343},{},[1344,1346,1351,1353,1358],{"type":63,"value":1345},"The helper polls ",{"type":50,"tag":68,"props":1347,"children":1349},{"className":1348},[],[1350],{"type":63,"value":167},{"type":63,"value":1352}," and ",{"type":50,"tag":59,"props":1354,"children":1355},{},[1356],{"type":63,"value":1357},"throws on Failed",{"type":63,"value":1359}," without returning the new record's GUID in the error payload. Three outcomes to handle:",{"type":50,"tag":269,"props":1361,"children":1362},{},[1363,1378],{"type":50,"tag":273,"props":1364,"children":1365},{},[1366],{"type":50,"tag":277,"props":1367,"children":1368},{},[1369,1374],{"type":50,"tag":281,"props":1370,"children":1371},{},[1372],{"type":63,"value":1373},"Helper outcome",{"type":50,"tag":281,"props":1375,"children":1376},{},[1377],{"type":63,"value":1048},{"type":50,"tag":297,"props":1379,"children":1380},{},[1381,1400,1445],{"type":50,"tag":277,"props":1382,"children":1383},{},[1384,1395],{"type":50,"tag":304,"props":1385,"children":1386},{},[1387,1389],{"type":63,"value":1388},"Resolves with ",{"type":50,"tag":68,"props":1390,"children":1392},{"className":1391},[],[1393],{"type":63,"value":1394},"validationStatus = Succeeded",{"type":50,"tag":304,"props":1396,"children":1397},{},[1398],{"type":63,"value":1399},"Record is fully linked. Skip to Phase 6 — no Force Link needed.",{"type":50,"tag":277,"props":1401,"children":1402},{},[1403,1414],{"type":50,"tag":304,"props":1404,"children":1405},{},[1406,1408,1412],{"type":63,"value":1407},"Throws with message containing ",{"type":50,"tag":95,"props":1409,"children":1410},{},[1411],{"type":63,"value":1097},{"type":63,"value":1413}," (or similar host-claim wording)",{"type":50,"tag":304,"props":1415,"children":1416},{},[1417,1419,1424,1426,1436,1438,1444],{"type":63,"value":1418},"The record ",{"type":50,"tag":59,"props":1420,"children":1421},{},[1422],{"type":63,"value":1423},"was",{"type":63,"value":1425}," created in Failed state but the helper's error doesn't surface the new GUID. ",{"type":50,"tag":59,"props":1427,"children":1428},{},[1429,1431],{"type":63,"value":1430},"Re-run Step 3.1's GET to recover the just-created record's ",{"type":50,"tag":68,"props":1432,"children":1434},{"className":1433},[],[1435],{"type":63,"value":1105},{"type":63,"value":1437},", then proceed to Phase 4 with that ID + the captured errormessage. Do NOT retry the create — it would log a duplicate ",{"type":50,"tag":68,"props":1439,"children":1441},{"className":1440},[],[1442],{"type":63,"value":1443},"name",{"type":63,"value":656},{"type":50,"tag":277,"props":1446,"children":1447},{},[1448,1453],{"type":50,"tag":304,"props":1449,"children":1450},{},[1451],{"type":63,"value":1452},"Throws with any other message",{"type":50,"tag":304,"props":1454,"children":1455},{},[1456,1458,1464],{"type":63,"value":1457},"Surface the error verbatim and abort. Force Link is not the right tool — this is a different failure (e.g., 403 on create = caller lacks role on host; 400 = bad ",{"type":50,"tag":68,"props":1459,"children":1461},{"className":1460},[],[1462],{"type":63,"value":1463},"bapEnvId",{"type":63,"value":1465},").",{"type":50,"tag":55,"props":1467,"children":1468},{},[1469,1474,1475,1481,1483,1489,1491,1496,1498,1504],{"type":50,"tag":59,"props":1470,"children":1471},{},[1472],{"type":63,"value":1473},"Why the re-query is necessary:",{"type":63,"value":111},{"type":50,"tag":68,"props":1476,"children":1478},{"className":1477},[],[1479],{"type":63,"value":1480},"create-deployment-environment.js",{"type":63,"value":1482}," is idempotent on subsequent calls (it short-circuits via ",{"type":50,"tag":68,"props":1484,"children":1486},{"className":1485},[],[1487],{"type":63,"value":1488},"findExistingByBapId",{"type":63,"value":1490},"), but on the ",{"type":50,"tag":95,"props":1492,"children":1493},{},[1494],{"type":63,"value":1495},"first",{"type":63,"value":1497}," call that lands in Failed validation it raises before the return path runs. Re-querying by ",{"type":50,"tag":68,"props":1499,"children":1501},{"className":1500},[],[1502],{"type":63,"value":1503},"environmentid eq '{bapEnvId}'",{"type":63,"value":1505}," is the canonical recovery — the same query Step 3.1 already uses.",{"type":50,"tag":55,"props":1507,"children":1508},{},[1509,1511,1516],{"type":63,"value":1510},"After this phase ends, you must hold a non-null ",{"type":50,"tag":68,"props":1512,"children":1514},{"className":1513},[],[1515],{"type":63,"value":372},{"type":63,"value":1517},". If you don't, abort Phase 4 with a clear \"could not resolve record on new host\" message.",{"type":50,"tag":122,"props":1519,"children":1521},{"id":1520},"phase-4-confirm-destructive-action",[1522],{"type":63,"value":1523},"Phase 4 — Confirm destructive action",{"type":50,"tag":51,"props":1525,"children":1526},{},[1527],{"type":50,"tag":55,"props":1528,"children":1529},{},[1530,1531,1536,1538,1543,1545,1550,1552,1558],{"type":63,"value":703},{"type":50,"tag":59,"props":1532,"children":1533},{},[1534],{"type":63,"value":1535},"Gate (consent · force-link-environment:4.destructive):",{"type":63,"value":1537}," Mandatory consent before ",{"type":50,"tag":68,"props":1539,"children":1541},{"className":1540},[],[1542],{"type":63,"value":342},{"type":63,"value":1544}," cross-host stamp move. Previous host loses pipeline access for this env. Reversible only by re-running Force Link from the previous host. ",{"type":50,"tag":59,"props":1546,"children":1547},{},[1548],{"type":63,"value":1549},"Fires fresh on every skill invocation.",{"type":63,"value":1551}," Each invocation force-links exactly one env to one host. If a maker needs to migrate multiple envs across hosts, they invoke this skill once per env — each invocation requires its own consent prompt with its own env identity echoed back. No ",{"type":50,"tag":68,"props":1553,"children":1555},{"className":1554},[],[1556],{"type":63,"value":1557},"--yes",{"type":63,"value":1559}," flag, no batch mode, no consent carry-over.",{"type":50,"tag":55,"props":1561,"children":1562},{},[1563,1564,1569,1571,1576],{"type":63,"value":1092},{"type":50,"tag":59,"props":1565,"children":1566},{},[1567],{"type":63,"value":1568},"mandatory",{"type":63,"value":1570}," gate. Use ",{"type":50,"tag":68,"props":1572,"children":1574},{"className":1573},[],[1575],{"type":63,"value":423},{"type":63,"value":1577}," with both options and a clear destructive-action warning in the question text. Required fields to display before asking:",{"type":50,"tag":141,"props":1579,"children":1580},{},[1581,1586,1591,1596],{"type":50,"tag":145,"props":1582,"children":1583},{},[1584],{"type":63,"value":1585},"Target host (the new host)",{"type":50,"tag":145,"props":1587,"children":1588},{},[1589],{"type":63,"value":1590},"Source environment name + BAP env GUID",{"type":50,"tag":145,"props":1592,"children":1593},{},[1594],{"type":63,"value":1595},"The error message from the previous host's stamp (from Phase 3), if any",{"type":50,"tag":145,"props":1597,"children":1598},{},[1599,1601],{"type":63,"value":1600},"Documented side effects:\n",{"type":50,"tag":141,"props":1602,"children":1603},{},[1604,1609,1614],{"type":50,"tag":145,"props":1605,"children":1606},{},[1607],{"type":63,"value":1608},"\"Makers in the previous host lose pipeline access for this environment\"",{"type":50,"tag":145,"props":1610,"children":1611},{},[1612],{"type":63,"value":1613},"\"The previous host's environment record is left with a stale validation status\"",{"type":50,"tag":145,"props":1615,"children":1616},{},[1617],{"type":63,"value":1618},"\"Reversible by running Force Link from the previous host\"",{"type":50,"tag":55,"props":1620,"children":1621},{},[1622],{"type":63,"value":1623},"Question structure:",{"type":50,"tag":518,"props":1625,"children":1628},{"className":1626,"code":1627,"language":63},[671],"question: \"Force-link this environment to \u003Chost name>? This will remove its association with the previous host.\"\noptions:\n  - \"Yes — force link\" (Recommended only if user is intentionally migrating)\n  - \"Cancel\"\n",[1629],{"type":50,"tag":68,"props":1630,"children":1631},{"__ignoreMap":523},[1632],{"type":63,"value":1627},{"type":50,"tag":55,"props":1634,"children":1635},{},[1636,1638,1644],{"type":63,"value":1637},"If the user picks Cancel, exit cleanly (no marker file written) and recommend ",{"type":50,"tag":68,"props":1639,"children":1641},{"className":1640},[],[1642],{"type":63,"value":1643},"\u002Fpower-pages:ensure-pipelines-host detect-only",{"type":63,"value":1645}," for further diagnosis.",{"type":50,"tag":122,"props":1647,"children":1649},{"id":1648},"phase-5-execute-force-link",[1650],{"type":63,"value":1651},"Phase 5 — Execute Force Link",{"type":50,"tag":518,"props":1653,"children":1655},{"className":520,"code":1654,"language":522,"meta":523,"style":523},"node \"${PLUGIN_ROOT}\u002Fscripts\u002Flib\u002Fforce-link-environment.js\" \\\n  --hostEnvUrl \u003ChostEnvUrl> \\\n  --token \u003ChostToken> \\\n  --deploymentEnvironmentId \u003Cguid>\n",[1656],{"type":50,"tag":68,"props":1657,"children":1658},{"__ignoreMap":523},[1659,1691,1718,1745],{"type":50,"tag":529,"props":1660,"children":1661},{"class":531,"line":532},[1662,1666,1670,1674,1678,1683,1687],{"type":50,"tag":529,"props":1663,"children":1664},{"style":536},[1665],{"type":63,"value":539},{"type":50,"tag":529,"props":1667,"children":1668},{"style":542},[1669],{"type":63,"value":545},{"type":50,"tag":529,"props":1671,"children":1672},{"style":548},[1673],{"type":63,"value":551},{"type":50,"tag":529,"props":1675,"children":1676},{"style":542},[1677],{"type":63,"value":556},{"type":50,"tag":529,"props":1679,"children":1680},{"style":559},[1681],{"type":63,"value":1682},"\u002Fscripts\u002Flib\u002Fforce-link-environment.js",{"type":50,"tag":529,"props":1684,"children":1685},{"style":542},[1686],{"type":63,"value":1190},{"type":50,"tag":529,"props":1688,"children":1689},{"style":548},[1690],{"type":63,"value":1195},{"type":50,"tag":529,"props":1692,"children":1693},{"class":531,"line":1198},[1694,1698,1702,1706,1710,1714],{"type":50,"tag":529,"props":1695,"children":1696},{"style":559},[1697],{"type":63,"value":1204},{"type":50,"tag":529,"props":1699,"children":1700},{"style":542},[1701],{"type":63,"value":1209},{"type":50,"tag":529,"props":1703,"children":1704},{"style":559},[1705],{"type":63,"value":1214},{"type":50,"tag":529,"props":1707,"children":1708},{"style":548},[1709],{"type":63,"value":1219},{"type":50,"tag":529,"props":1711,"children":1712},{"style":542},[1713],{"type":63,"value":1224},{"type":50,"tag":529,"props":1715,"children":1716},{"style":548},[1717],{"type":63,"value":1195},{"type":50,"tag":529,"props":1719,"children":1720},{"class":531,"line":1231},[1721,1725,1729,1733,1737,1741],{"type":50,"tag":529,"props":1722,"children":1723},{"style":559},[1724],{"type":63,"value":1237},{"type":50,"tag":529,"props":1726,"children":1727},{"style":542},[1728],{"type":63,"value":1209},{"type":50,"tag":529,"props":1730,"children":1731},{"style":559},[1732],{"type":63,"value":1246},{"type":50,"tag":529,"props":1734,"children":1735},{"style":548},[1736],{"type":63,"value":1251},{"type":50,"tag":529,"props":1738,"children":1739},{"style":542},[1740],{"type":63,"value":1224},{"type":50,"tag":529,"props":1742,"children":1743},{"style":548},[1744],{"type":63,"value":1195},{"type":50,"tag":529,"props":1746,"children":1747},{"class":531,"line":1262},[1748,1753,1757,1762,1766],{"type":50,"tag":529,"props":1749,"children":1750},{"style":559},[1751],{"type":63,"value":1752},"  --deploymentEnvironmentId",{"type":50,"tag":529,"props":1754,"children":1755},{"style":542},[1756],{"type":63,"value":1209},{"type":50,"tag":529,"props":1758,"children":1759},{"style":559},[1760],{"type":63,"value":1761},"gui",{"type":50,"tag":529,"props":1763,"children":1764},{"style":548},[1765],{"type":63,"value":1309},{"type":50,"tag":529,"props":1767,"children":1768},{"style":542},[1769],{"type":63,"value":1770},">\n",{"type":50,"tag":55,"props":1772,"children":1773},{},[1774],{"type":63,"value":1775},"The helper:",{"type":50,"tag":827,"props":1777,"children":1778},{},[1779,1791,1803],{"type":50,"tag":145,"props":1780,"children":1781},{},[1782,1784,1789],{"type":63,"value":1783},"Calls ",{"type":50,"tag":68,"props":1785,"children":1787},{"className":1786},[],[1788],{"type":63,"value":342},{"type":63,"value":1790}," (returns 204 No Content on success).",{"type":50,"tag":145,"props":1792,"children":1793},{},[1794,1796,1801],{"type":63,"value":1795},"Re-polls ",{"type":50,"tag":68,"props":1797,"children":1799},{"className":1798},[],[1800],{"type":63,"value":167},{"type":63,"value":1802}," on the same record every 3s up to 20 attempts.",{"type":50,"tag":145,"props":1804,"children":1805},{},[1806,1808,1813],{"type":63,"value":1807},"Resolves on Succeeded (200000001), throws on Failed (200000002) with the captured ",{"type":50,"tag":68,"props":1809,"children":1811},{"className":1810},[],[1812],{"type":63,"value":1113},{"type":63,"value":656},{"type":50,"tag":55,"props":1815,"children":1816},{},[1817],{"type":63,"value":1818},"If the helper throws with status 403, the caller lacks Deployment Pipeline Administrator on the target host — surface that as the remediation message.",{"type":50,"tag":55,"props":1820,"children":1821},{},[1822,1824,1829],{"type":63,"value":1823},"If the helper throws with status 404, the ",{"type":50,"tag":68,"props":1825,"children":1827},{"className":1826},[],[1828],{"type":63,"value":91},{"type":63,"value":1830}," record doesn't exist on the target host — Phase 3 must have failed silently; loop back.",{"type":50,"tag":122,"props":1832,"children":1834},{"id":1833},"phase-6-write-marker-summary",[1835],{"type":63,"value":1836},"Phase 6 — Write marker + summary",{"type":50,"tag":55,"props":1838,"children":1839},{},[1840,1842,1848,1850,1856,1858,1863],{"type":63,"value":1841},"Ensure the ",{"type":50,"tag":68,"props":1843,"children":1845},{"className":1844},[],[1846],{"type":63,"value":1847},"docs\u002Falm\u002F",{"type":63,"value":1849}," directory exists (",{"type":50,"tag":68,"props":1851,"children":1853},{"className":1852},[],[1854],{"type":63,"value":1855},"node -e \"require('fs').mkdirSync('docs\u002Falm',{recursive:true})\"",{"type":63,"value":1857},"), then write ",{"type":50,"tag":68,"props":1859,"children":1861},{"className":1860},[],[1862],{"type":63,"value":470},{"type":63,"value":825},{"type":50,"tag":518,"props":1865,"children":1869},{"className":1866,"code":1867,"language":1868,"meta":523,"style":523},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"schemaVersion\": 1,\n  \"hostEnvUrl\": \"https:\u002F\u002F...\",\n  \"deploymentEnvironmentId\": \"...\",\n  \"bapEnvId\": \"...\",\n  \"previousHostEnvUrl\": \"https:\u002F\u002F...\",\n  \"validationStatus\": 200000001,\n  \"forcedAt\": \"2026-05-11T...\"\n}\n","json",[1870],{"type":50,"tag":68,"props":1871,"children":1872},{"__ignoreMap":523},[1873,1881,1914,1950,1986,2021,2057,2087,2121],{"type":50,"tag":529,"props":1874,"children":1875},{"class":531,"line":532},[1876],{"type":50,"tag":529,"props":1877,"children":1878},{"style":542},[1879],{"type":63,"value":1880},"{\n",{"type":50,"tag":529,"props":1882,"children":1883},{"class":531,"line":1198},[1884,1889,1895,1899,1903,1909],{"type":50,"tag":529,"props":1885,"children":1886},{"style":542},[1887],{"type":63,"value":1888},"  \"",{"type":50,"tag":529,"props":1890,"children":1892},{"style":1891},"--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA",[1893],{"type":63,"value":1894},"schemaVersion",{"type":50,"tag":529,"props":1896,"children":1897},{"style":542},[1898],{"type":63,"value":1190},{"type":50,"tag":529,"props":1900,"children":1901},{"style":542},[1902],{"type":63,"value":825},{"type":50,"tag":529,"props":1904,"children":1906},{"style":1905},"--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C",[1907],{"type":63,"value":1908}," 1",{"type":50,"tag":529,"props":1910,"children":1911},{"style":542},[1912],{"type":63,"value":1913},",\n",{"type":50,"tag":529,"props":1915,"children":1916},{"class":531,"line":1231},[1917,1921,1925,1929,1933,1937,1942,1946],{"type":50,"tag":529,"props":1918,"children":1919},{"style":542},[1920],{"type":63,"value":1888},{"type":50,"tag":529,"props":1922,"children":1923},{"style":1891},[1924],{"type":63,"value":364},{"type":50,"tag":529,"props":1926,"children":1927},{"style":542},[1928],{"type":63,"value":1190},{"type":50,"tag":529,"props":1930,"children":1931},{"style":542},[1932],{"type":63,"value":825},{"type":50,"tag":529,"props":1934,"children":1935},{"style":542},[1936],{"type":63,"value":1273},{"type":50,"tag":529,"props":1938,"children":1939},{"style":559},[1940],{"type":63,"value":1941},"https:\u002F\u002F...",{"type":50,"tag":529,"props":1943,"children":1944},{"style":542},[1945],{"type":63,"value":1190},{"type":50,"tag":529,"props":1947,"children":1948},{"style":542},[1949],{"type":63,"value":1913},{"type":50,"tag":529,"props":1951,"children":1952},{"class":531,"line":1262},[1953,1957,1961,1965,1969,1973,1978,1982],{"type":50,"tag":529,"props":1954,"children":1955},{"style":542},[1956],{"type":63,"value":1888},{"type":50,"tag":529,"props":1958,"children":1959},{"style":1891},[1960],{"type":63,"value":372},{"type":50,"tag":529,"props":1962,"children":1963},{"style":542},[1964],{"type":63,"value":1190},{"type":50,"tag":529,"props":1966,"children":1967},{"style":542},[1968],{"type":63,"value":825},{"type":50,"tag":529,"props":1970,"children":1971},{"style":542},[1972],{"type":63,"value":1273},{"type":50,"tag":529,"props":1974,"children":1975},{"style":559},[1976],{"type":63,"value":1977},"...",{"type":50,"tag":529,"props":1979,"children":1980},{"style":542},[1981],{"type":63,"value":1190},{"type":50,"tag":529,"props":1983,"children":1984},{"style":542},[1985],{"type":63,"value":1913},{"type":50,"tag":529,"props":1987,"children":1988},{"class":531,"line":1289},[1989,1993,1997,2001,2005,2009,2013,2017],{"type":50,"tag":529,"props":1990,"children":1991},{"style":542},[1992],{"type":63,"value":1888},{"type":50,"tag":529,"props":1994,"children":1995},{"style":1891},[1996],{"type":63,"value":1463},{"type":50,"tag":529,"props":1998,"children":1999},{"style":542},[2000],{"type":63,"value":1190},{"type":50,"tag":529,"props":2002,"children":2003},{"style":542},[2004],{"type":63,"value":825},{"type":50,"tag":529,"props":2006,"children":2007},{"style":542},[2008],{"type":63,"value":1273},{"type":50,"tag":529,"props":2010,"children":2011},{"style":559},[2012],{"type":63,"value":1977},{"type":50,"tag":529,"props":2014,"children":2015},{"style":542},[2016],{"type":63,"value":1190},{"type":50,"tag":529,"props":2018,"children":2019},{"style":542},[2020],{"type":63,"value":1913},{"type":50,"tag":529,"props":2022,"children":2023},{"class":531,"line":1320},[2024,2028,2033,2037,2041,2045,2049,2053],{"type":50,"tag":529,"props":2025,"children":2026},{"style":542},[2027],{"type":63,"value":1888},{"type":50,"tag":529,"props":2029,"children":2030},{"style":1891},[2031],{"type":63,"value":2032},"previousHostEnvUrl",{"type":50,"tag":529,"props":2034,"children":2035},{"style":542},[2036],{"type":63,"value":1190},{"type":50,"tag":529,"props":2038,"children":2039},{"style":542},[2040],{"type":63,"value":825},{"type":50,"tag":529,"props":2042,"children":2043},{"style":542},[2044],{"type":63,"value":1273},{"type":50,"tag":529,"props":2046,"children":2047},{"style":559},[2048],{"type":63,"value":1941},{"type":50,"tag":529,"props":2050,"children":2051},{"style":542},[2052],{"type":63,"value":1190},{"type":50,"tag":529,"props":2054,"children":2055},{"style":542},[2056],{"type":63,"value":1913},{"type":50,"tag":529,"props":2058,"children":2060},{"class":531,"line":2059},7,[2061,2065,2070,2074,2078,2083],{"type":50,"tag":529,"props":2062,"children":2063},{"style":542},[2064],{"type":63,"value":1888},{"type":50,"tag":529,"props":2066,"children":2067},{"style":1891},[2068],{"type":63,"value":2069},"validationStatus",{"type":50,"tag":529,"props":2071,"children":2072},{"style":542},[2073],{"type":63,"value":1190},{"type":50,"tag":529,"props":2075,"children":2076},{"style":542},[2077],{"type":63,"value":825},{"type":50,"tag":529,"props":2079,"children":2080},{"style":1905},[2081],{"type":63,"value":2082}," 200000001",{"type":50,"tag":529,"props":2084,"children":2085},{"style":542},[2086],{"type":63,"value":1913},{"type":50,"tag":529,"props":2088,"children":2090},{"class":531,"line":2089},8,[2091,2095,2100,2104,2108,2112,2117],{"type":50,"tag":529,"props":2092,"children":2093},{"style":542},[2094],{"type":63,"value":1888},{"type":50,"tag":529,"props":2096,"children":2097},{"style":1891},[2098],{"type":63,"value":2099},"forcedAt",{"type":50,"tag":529,"props":2101,"children":2102},{"style":542},[2103],{"type":63,"value":1190},{"type":50,"tag":529,"props":2105,"children":2106},{"style":542},[2107],{"type":63,"value":825},{"type":50,"tag":529,"props":2109,"children":2110},{"style":542},[2111],{"type":63,"value":1273},{"type":50,"tag":529,"props":2113,"children":2114},{"style":559},[2115],{"type":63,"value":2116},"2026-05-11T...",{"type":50,"tag":529,"props":2118,"children":2119},{"style":542},[2120],{"type":63,"value":567},{"type":50,"tag":529,"props":2122,"children":2124},{"class":531,"line":2123},9,[2125],{"type":50,"tag":529,"props":2126,"children":2127},{"style":542},[2128],{"type":63,"value":2129},"}\n",{"type":50,"tag":55,"props":2131,"children":2132},{},[2133,2138,2140,2146],{"type":50,"tag":68,"props":2134,"children":2136},{"className":2135},[],[2137],{"type":63,"value":2032},{"type":63,"value":2139}," is best-effort. Derive in this order; leave ",{"type":50,"tag":68,"props":2141,"children":2143},{"className":2142},[],[2144],{"type":63,"value":2145},"null",{"type":63,"value":2147}," if none of these yield a value:",{"type":50,"tag":827,"props":2149,"children":2150},{},[2151,2186,2225],{"type":50,"tag":145,"props":2152,"children":2153},{},[2154,2164,2165,2170,2172,2177,2179,2184],{"type":50,"tag":59,"props":2155,"children":2156},{},[2157,2159],{"type":63,"value":2158},"From ",{"type":50,"tag":68,"props":2160,"children":2162},{"className":2161},[],[2163],{"type":63,"value":849},{"type":63,"value":851},{"type":50,"tag":68,"props":2166,"children":2168},{"className":2167},[],[2169],{"type":63,"value":857},{"type":63,"value":2171},"): if ",{"type":50,"tag":68,"props":2173,"children":2175},{"className":2174},[],[2176],{"type":63,"value":865},{"type":63,"value":2178}," is set AND differs from the current ",{"type":50,"tag":68,"props":2180,"children":2182},{"className":2181},[],[2183],{"type":63,"value":364},{"type":63,"value":2185},", the discovery flow had already bound this env to that previous host — record it.",{"type":50,"tag":145,"props":2187,"children":2188},{},[2189,2194,2196,2201,2203,2209,2211,2216,2218,2223],{"type":50,"tag":59,"props":2190,"children":2191},{},[2192],{"type":63,"value":2193},"From Phase 3's errormessage",{"type":63,"value":2195},": scan the captured ",{"type":50,"tag":68,"props":2197,"children":2199},{"className":2198},[],[2200],{"type":63,"value":1113},{"type":63,"value":2202}," for the pattern ",{"type":50,"tag":68,"props":2204,"children":2206},{"className":2205},[],[2207],{"type":63,"value":2208},"https?:\u002F\u002F[^\\s'\"]+\\.(crm\\d*\\.dynamics\\.com|dynamics-int\\.com|crm\\.microsoftdynamics\\.us)",{"type":63,"value":2210}," and pick the first match that is ",{"type":50,"tag":59,"props":2212,"children":2213},{},[2214],{"type":63,"value":2215},"not",{"type":63,"value":2217}," the current ",{"type":50,"tag":68,"props":2219,"children":2221},{"className":2220},[],[2222],{"type":63,"value":364},{"type":63,"value":2224},". Microsoft's error wording on the \"already associated\" path sometimes includes the prior host's URL, sometimes only its display name; treat the regex as opportunistic, not authoritative.",{"type":50,"tag":145,"props":2226,"children":2227},{},[2228,2233,2235,2240],{"type":50,"tag":59,"props":2229,"children":2230},{},[2231],{"type":63,"value":2232},"Otherwise",{"type":63,"value":2234},": leave ",{"type":50,"tag":68,"props":2236,"children":2238},{"className":2237},[],[2239],{"type":63,"value":2145},{"type":63,"value":2241},". The marker schema permits this — validator does not require the field.",{"type":50,"tag":55,"props":2243,"children":2244},{},[2245,2247,2252],{"type":63,"value":2246},"Do NOT prompt the user to fill ",{"type":50,"tag":68,"props":2248,"children":2250},{"className":2249},[],[2251],{"type":63,"value":2032},{"type":63,"value":2253},"; it's informational only for the post-run summary.",{"type":50,"tag":55,"props":2255,"children":2256},{},[2257],{"type":63,"value":2258},"Present a summary table with:",{"type":50,"tag":141,"props":2260,"children":2261},{},[2262,2267,2272,2277],{"type":50,"tag":145,"props":2263,"children":2264},{},[2265],{"type":63,"value":2266},"Environment force-linked",{"type":50,"tag":145,"props":2268,"children":2269},{},[2270],{"type":63,"value":2271},"Old host → new host",{"type":50,"tag":145,"props":2273,"children":2274},{},[2275],{"type":63,"value":2276},"Validation status",{"type":50,"tag":145,"props":2278,"children":2279},{},[2280,2282,2288],{"type":63,"value":2281},"Reminder: \"You can undo this by running ",{"type":50,"tag":68,"props":2283,"children":2285},{"className":2284},[],[2286],{"type":63,"value":2287},"\u002Fpower-pages:force-link-environment",{"type":63,"value":2289}," from the previous host.\"",{"type":50,"tag":55,"props":2291,"children":2292},{},[2293,2295,2301],{"type":63,"value":2294},"Record skill usage per ",{"type":50,"tag":68,"props":2296,"children":2298},{"className":2297},[],[2299],{"type":63,"value":2300},"${PLUGIN_ROOT}\u002Freferences\u002Fskill-tracking-reference.md",{"type":63,"value":656},{"type":50,"tag":503,"props":2303,"children":2304},{},[],{"type":50,"tag":122,"props":2306,"children":2308},{"id":2307},"failure-modes-remediation",[2309],{"type":63,"value":2310},"Failure modes & remediation",{"type":50,"tag":269,"props":2312,"children":2313},{},[2314,2335],{"type":50,"tag":273,"props":2315,"children":2316},{},[2317],{"type":50,"tag":277,"props":2318,"children":2319},{},[2320,2325,2330],{"type":50,"tag":281,"props":2321,"children":2322},{},[2323],{"type":63,"value":2324},"Failure",{"type":50,"tag":281,"props":2326,"children":2327},{},[2328],{"type":63,"value":2329},"Surface to user",{"type":50,"tag":281,"props":2331,"children":2332},{},[2333],{"type":63,"value":2334},"Next step",{"type":50,"tag":297,"props":2336,"children":2337},{},[2338,2381,2405,2430],{"type":50,"tag":277,"props":2339,"children":2340},{},[2341,2357,2368],{"type":50,"tag":304,"props":2342,"children":2343},{},[2344,2350,2352],{"type":50,"tag":68,"props":2345,"children":2347},{"className":2346},[],[2348],{"type":63,"value":2349},"403 Forbidden",{"type":63,"value":2351}," on ",{"type":50,"tag":68,"props":2353,"children":2355},{"className":2354},[],[2356],{"type":63,"value":342},{"type":50,"tag":304,"props":2358,"children":2359},{},[2360,2362],{"type":63,"value":2361},"\"You need Deployment Pipeline Administrator role on ",{"type":50,"tag":2363,"props":2364,"children":2365},"host-name",{},[2366],{"type":63,"value":2367},".\"",{"type":50,"tag":304,"props":2369,"children":2370},{},[2371,2373,2380],{"type":63,"value":2372},"Ask host admin to grant the role; documented in ",{"type":50,"tag":113,"props":2374,"children":2377},{"href":2375,"rel":2376},"https:\u002F\u002Flearn.microsoft.com\u002Fen-us\u002Fpower-platform\u002Falm\u002Fcustom-host-pipelines#share-with-pipeline-administrators",[117],[2378],{"type":63,"value":2379},"share with pipeline administrators",{"type":63,"value":656},{"type":50,"tag":277,"props":2382,"children":2383},{},[2384,2395,2400],{"type":50,"tag":304,"props":2385,"children":2386},{},[2387,2393],{"type":50,"tag":68,"props":2388,"children":2390},{"className":2389},[],[2391],{"type":63,"value":2392},"404 Not Found",{"type":63,"value":2394}," on the deployment env record",{"type":50,"tag":304,"props":2396,"children":2397},{},[2398],{"type":63,"value":2399},"\"No deploymentenvironments record exists yet on this host.\"",{"type":50,"tag":304,"props":2401,"children":2402},{},[2403],{"type":63,"value":2404},"Re-run Phase 3's create step.",{"type":50,"tag":277,"props":2406,"children":2407},{},[2408,2413,2425],{"type":50,"tag":304,"props":2409,"children":2410},{},[2411],{"type":63,"value":2412},"Post-link validation status flips to Failed",{"type":50,"tag":304,"props":2414,"children":2415},{},[2416,2418,2423],{"type":63,"value":2417},"Show the ",{"type":50,"tag":68,"props":2419,"children":2421},{"className":2420},[],[2422],{"type":63,"value":1113},{"type":63,"value":2424}," verbatim.",{"type":50,"tag":304,"props":2426,"children":2427},{},[2428],{"type":63,"value":2429},"If the message mentions the env is still associated with a host, the previous host may have an immediate-reapply policy — check with the previous host's admin.",{"type":50,"tag":277,"props":2431,"children":2432},{},[2433,2438,2443],{"type":50,"tag":304,"props":2434,"children":2435},{},[2436],{"type":63,"value":2437},"User cancels at Phase 4",{"type":50,"tag":304,"props":2439,"children":2440},{},[2441],{"type":63,"value":2442},"\"Force Link not performed; previous association preserved.\"",{"type":50,"tag":304,"props":2444,"children":2445},{},[2446,2448,2453],{"type":63,"value":2447},"Suggest ",{"type":50,"tag":68,"props":2449,"children":2451},{"className":2450},[],[2452],{"type":63,"value":1643},{"type":63,"value":2454}," for a wider diagnosis.",{"type":50,"tag":122,"props":2456,"children":2458},{"id":2457},"what-this-skill-does-not-do",[2459],{"type":63,"value":2460},"What this skill does NOT do",{"type":50,"tag":141,"props":2462,"children":2463},{},[2464,2477,2482,2487],{"type":50,"tag":145,"props":2465,"children":2466},{},[2467,2469,2475],{"type":63,"value":2468},"It does not install the Pipelines application on the new host — use ",{"type":50,"tag":68,"props":2470,"children":2472},{"className":2471},[],[2473],{"type":63,"value":2474},"\u002Fpower-pages:ensure-pipelines-host",{"type":63,"value":2476}," for that.",{"type":50,"tag":145,"props":2478,"children":2479},{},[2480],{"type":63,"value":2481},"It does not create the new host environment itself.",{"type":50,"tag":145,"props":2483,"children":2484},{},[2485],{"type":63,"value":2486},"It does not re-link pipeline definitions; only the env↔host stamp is moved. Pipelines that referenced this env in the previous host stay there and lose this env as a participant.",{"type":50,"tag":145,"props":2488,"children":2489},{},[2490,2492,2498,2500,2506],{"type":63,"value":2491},"It does not modify the user's solution. No ",{"type":50,"tag":68,"props":2493,"children":2495},{"className":2494},[],[2496],{"type":63,"value":2497},".solution-manifest.json",{"type":63,"value":2499}," updates; no ",{"type":50,"tag":68,"props":2501,"children":2503},{"className":2502},[],[2504],{"type":63,"value":2505},"AddSolutionComponent",{"type":63,"value":2507}," calls.",{"type":50,"tag":122,"props":2509,"children":2511},{"id":2510},"progress-tracking",[2512],{"type":63,"value":2513},"Progress tracking",{"type":50,"tag":269,"props":2515,"children":2516},{},[2517,2532],{"type":50,"tag":273,"props":2518,"children":2519},{},[2520],{"type":50,"tag":277,"props":2521,"children":2522},{},[2523,2527],{"type":50,"tag":281,"props":2524,"children":2525},{},[2526],{"type":63,"value":290},{"type":50,"tag":281,"props":2528,"children":2529},{},[2530],{"type":63,"value":2531},"Status",{"type":50,"tag":297,"props":2533,"children":2534},{},[2535,2548,2560,2572,2584,2596,2608],{"type":50,"tag":277,"props":2536,"children":2537},{},[2538,2543],{"type":50,"tag":304,"props":2539,"children":2540},{},[2541],{"type":63,"value":2542},"1 — Prerequisites",{"type":50,"tag":304,"props":2544,"children":2545},{},[2546],{"type":63,"value":2547},"⏳",{"type":50,"tag":277,"props":2549,"children":2550},{},[2551,2556],{"type":50,"tag":304,"props":2552,"children":2553},{},[2554],{"type":63,"value":2555},"1.5 — MCP Learn grounding",{"type":50,"tag":304,"props":2557,"children":2558},{},[2559],{"type":63,"value":2547},{"type":50,"tag":277,"props":2561,"children":2562},{},[2563,2568],{"type":50,"tag":304,"props":2564,"children":2565},{},[2566],{"type":63,"value":2567},"2 — Identify host + dev env",{"type":50,"tag":304,"props":2569,"children":2570},{},[2571],{"type":63,"value":2547},{"type":50,"tag":277,"props":2573,"children":2574},{},[2575,2580],{"type":50,"tag":304,"props":2576,"children":2577},{},[2578],{"type":63,"value":2579},"3 — Resolve deploymentenvironments record",{"type":50,"tag":304,"props":2581,"children":2582},{},[2583],{"type":63,"value":2547},{"type":50,"tag":277,"props":2585,"children":2586},{},[2587,2592],{"type":50,"tag":304,"props":2588,"children":2589},{},[2590],{"type":63,"value":2591},"4 — Confirm destructive action",{"type":50,"tag":304,"props":2593,"children":2594},{},[2595],{"type":63,"value":2547},{"type":50,"tag":277,"props":2597,"children":2598},{},[2599,2604],{"type":50,"tag":304,"props":2600,"children":2601},{},[2602],{"type":63,"value":2603},"5 — Execute Force Link",{"type":50,"tag":304,"props":2605,"children":2606},{},[2607],{"type":63,"value":2547},{"type":50,"tag":277,"props":2609,"children":2610},{},[2611,2616],{"type":50,"tag":304,"props":2612,"children":2613},{},[2614],{"type":63,"value":2615},"6 — Write marker + summary",{"type":50,"tag":304,"props":2617,"children":2618},{},[2619],{"type":63,"value":2547},{"type":50,"tag":55,"props":2621,"children":2622},{},[2623],{"type":63,"value":2624},"Update this table as phases complete.",{"type":50,"tag":2626,"props":2627,"children":2628},"style",{},[2629],{"type":63,"value":2630},"html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"items":2632,"total":2727},[2633,2644,2657,2667,2682,2695,2711],{"slug":2634,"name":2634,"fn":2635,"description":2636,"org":2637,"tags":2638,"stars":23,"repoUrl":24,"updatedAt":2643},"activate-site","provision and activate Power Pages sites","Activates and provisions a Power Pages website in a Power Platform environment via the Power Platform REST API. Use when the user wants to activate, provision, turn on, or enable a Power Pages website or portal.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2639,2640,2641],{"name":18,"slug":19,"type":15},{"name":9,"slug":8,"type":15},{"name":2642,"slug":34,"type":15},"Power Pages","2026-04-06T18:34:34.732549",{"slug":2645,"name":2645,"fn":2646,"description":2647,"org":2648,"tags":2649,"stars":23,"repoUrl":24,"updatedAt":2656},"add-connector","add Power Platform connectors to apps","Adds any Power Platform connector to a Power Apps code app. Generic fallback for connectors not covered by a specific skill.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2650,2653,2655],{"name":2651,"slug":2652,"type":15},"Integrations","integrations",{"name":2654,"slug":33,"type":15},"Power Apps",{"name":21,"slug":22,"type":15},"2026-07-31T05:54:47.042251",{"slug":2658,"name":2658,"fn":2659,"description":2660,"org":2661,"tags":2662,"stars":23,"repoUrl":24,"updatedAt":2666},"add-datasource","add data sources to Power Apps","Adds a data source or connector to a Power Apps code app. Asks what the user wants to accomplish and routes to the appropriate specialized skill.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2663,2664,2665],{"name":2651,"slug":2652,"type":15},{"name":9,"slug":8,"type":15},{"name":2654,"slug":33,"type":15},"2026-07-03T16:31:47.822186",{"slug":2668,"name":2668,"fn":2669,"description":2670,"org":2671,"tags":2672,"stars":23,"repoUrl":24,"updatedAt":2681},"add-dataverse","add Dataverse tables to Power Apps","Use when the user wants to add Dataverse tables (existing or new) to a Power Apps mobile app, extend an existing Dataverse table with new columns, or apply an approved data model plan.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2673,2676,2679,2680],{"name":2674,"slug":2675,"type":15},"Data Modeling","data-modeling",{"name":2677,"slug":2678,"type":15},"Dataverse","dataverse",{"name":9,"slug":8,"type":15},{"name":2654,"slug":33,"type":15},"2026-07-31T05:54:46.078014",{"slug":2683,"name":2683,"fn":2684,"description":2685,"org":2686,"tags":2687,"stars":23,"repoUrl":24,"updatedAt":2694},"add-excel","integrate Excel Online into Power Apps","Adds Excel Online (Business) connector to a Power Apps code app. Use when reading or writing Excel workbook data from OneDrive or SharePoint.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2688,2691,2692,2693],{"name":2689,"slug":2690,"type":15},"Excel","excel",{"name":2651,"slug":2652,"type":15},{"name":9,"slug":8,"type":15},{"name":2654,"slug":33,"type":15},"2026-07-31T05:54:44.030943",{"slug":2696,"name":2696,"fn":2697,"description":2698,"org":2699,"tags":2700,"stars":23,"repoUrl":24,"updatedAt":2710},"add-mcscopilot","add Copilot Studio connectors to Power Apps","Adds Microsoft Copilot Studio connector to a Power Apps code app. Use when invoking Copilot Studio agents, sending prompts to agents, or integrating agent responses.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2701,2704,2707,2708,2709],{"name":2702,"slug":2703,"type":15},"Agents","agents",{"name":2705,"slug":2706,"type":15},"Copilot Studio","copilot-studio",{"name":2651,"slug":2652,"type":15},{"name":9,"slug":8,"type":15},{"name":2654,"slug":33,"type":15},"2026-07-31T05:54:39.025597",{"slug":2712,"name":2712,"fn":2713,"description":2714,"org":2715,"tags":2716,"stars":23,"repoUrl":24,"updatedAt":2726},"add-sample-data","populate Power Pages tables with sample data","Populates Dataverse tables with sample records for testing and demoing a Power Pages site. Use when the user wants to add sample data, seed data, generate test records, or insert demo data into their tables.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2717,2720,2721,2722,2723],{"name":2718,"slug":2719,"type":15},"Database","database",{"name":2677,"slug":2678,"type":15},{"name":9,"slug":8,"type":15},{"name":2642,"slug":34,"type":15},{"name":2724,"slug":2725,"type":15},"Testing","testing","2026-04-06T18:34:41.141155",26,{"items":2729,"total":2920},[2730,2752,2771,2792,2807,2824,2835,2848,2863,2878,2895,2908],{"slug":2731,"name":2731,"fn":2732,"description":2733,"org":2734,"tags":2735,"stars":2749,"repoUrl":2750,"updatedAt":2751},"rushstack-best-practices","manage Rush monorepos with best practices","Provides best practices and guidance for working with Rush monorepos. Use when the user is working in a Rush-based repository, asks about Rush commands (install, update, build, rebuild), needs help with project selection, dependency management, build caching, subspace configuration, or troubleshooting Rush-specific issues.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2736,2739,2742,2743,2746],{"name":2737,"slug":2738,"type":15},"Engineering","engineering",{"name":2740,"slug":2741,"type":15},"Local Development","local-development",{"name":9,"slug":8,"type":15},{"name":2744,"slug":2745,"type":15},"Project Management","project-management",{"name":2747,"slug":2748,"type":15},"Rush","rush",6484,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Frushstack","2026-04-06T18:34:44.965032",{"slug":2753,"name":2753,"fn":2754,"description":2755,"org":2756,"tags":2757,"stars":2768,"repoUrl":2769,"updatedAt":2770},"azure-ai-agents-persistent-dotnet","build AI agents with Azure .NET SDK","Azure AI Agents Persistent SDK for .NET. Low-level SDK for creating and managing AI agents with threads, messages, runs, and tools. Use for agent CRUD, conversation threads, streaming responses, function calling, file search, and code interpreter. Triggers: \"PersistentAgentsClient\", \"persistent agents\", \"agent threads\", \"agent runs\", \"streaming agents\", \"function calling agents .NET\".\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2758,2761,2762,2765],{"name":2759,"slug":2760,"type":15},".NET","net",{"name":2702,"slug":2703,"type":15},{"name":2763,"slug":2764,"type":15},"Azure","azure",{"name":2766,"slug":2767,"type":15},"LLM","llm",2804,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fskills","2026-07-03T16:32:10.297433",{"slug":2772,"name":2772,"fn":2773,"description":2774,"org":2775,"tags":2776,"stars":2768,"repoUrl":2769,"updatedAt":2791},"azure-ai-anomalydetector-java","build anomaly detection applications with Java","Build anomaly detection applications with Azure AI Anomaly Detector SDK for Java. Use when implementing univariate\u002Fmultivariate anomaly detection, time-series analysis, or AI-powered monitoring.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2777,2780,2781,2784,2787,2788],{"name":2778,"slug":2779,"type":15},"Analytics","analytics",{"name":2763,"slug":2764,"type":15},{"name":2782,"slug":2783,"type":15},"Data Analysis","data-analysis",{"name":2785,"slug":2786,"type":15},"Java","java",{"name":9,"slug":8,"type":15},{"name":2789,"slug":2790,"type":15},"Monitoring","monitoring","2026-05-13T06:14:16.261754",{"slug":2793,"name":2793,"fn":2794,"description":2795,"org":2796,"tags":2797,"stars":2768,"repoUrl":2769,"updatedAt":2806},"azure-ai-contentsafety-java","build content moderation applications with Azure AI","Build content moderation applications with Azure AI Content Safety SDK for Java. Use when implementing text\u002Fimage analysis, blocklist management, or harm detection for hate, violence, sexual content, and self-harm.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2798,2801,2802,2803],{"name":2799,"slug":2800,"type":15},"AI Infrastructure","ai-infrastructure",{"name":2763,"slug":2764,"type":15},{"name":2785,"slug":2786,"type":15},{"name":2804,"slug":2805,"type":15},"Security","security","2026-07-07T06:53:31.293235",{"slug":2808,"name":2808,"fn":2809,"description":2810,"org":2811,"tags":2812,"stars":2768,"repoUrl":2769,"updatedAt":2823},"azure-ai-contentsafety-py","detect harmful content with Azure AI Content Safety","Azure AI Content Safety SDK for Python. Use for detecting harmful content in text and images with multi-severity classification.\nTriggers: \"azure-ai-contentsafety\", \"ContentSafetyClient\", \"content moderation\", \"harmful content\", \"text analysis\", \"image analysis\".\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2813,2814,2817,2818,2819,2822],{"name":2763,"slug":2764,"type":15},{"name":2815,"slug":2816,"type":15},"Compliance","compliance",{"name":2766,"slug":2767,"type":15},{"name":9,"slug":8,"type":15},{"name":2820,"slug":2821,"type":15},"Python","python",{"name":2804,"slug":2805,"type":15},"2026-07-18T05:14:23.017504",{"slug":2825,"name":2825,"fn":2826,"description":2827,"org":2828,"tags":2829,"stars":2768,"repoUrl":2769,"updatedAt":2834},"azure-ai-language-conversations-py","implement conversational language understanding with Python","Implement Conversational Language Understanding (CLU) using the azure-ai-language-conversations Python SDK. Use when working with ConversationAnalysisClient to analyze conversation intent and entities, building NLP features, or integrating language understanding into applications.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2830,2831,2832,2833],{"name":2778,"slug":2779,"type":15},{"name":2763,"slug":2764,"type":15},{"name":2766,"slug":2767,"type":15},{"name":2820,"slug":2821,"type":15},"2026-07-31T05:54:29.068751",{"slug":2836,"name":2836,"fn":2837,"description":2838,"org":2839,"tags":2840,"stars":2768,"repoUrl":2769,"updatedAt":2847},"azure-ai-translation-text-py","translate text using Azure AI services","Azure AI Text Translation SDK for real-time text translation, transliteration, language detection, and dictionary lookup. Use for translating text content in applications.\nTriggers: \"text translation\", \"translator\", \"translate text\", \"transliterate\", \"TextTranslationClient\".\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2841,2844,2845,2846],{"name":2842,"slug":2843,"type":15},"API Development","api-development",{"name":2763,"slug":2764,"type":15},{"name":9,"slug":8,"type":15},{"name":2820,"slug":2821,"type":15},"2026-07-18T05:14:16.988376",{"slug":2849,"name":2849,"fn":2850,"description":2851,"org":2852,"tags":2853,"stars":2768,"repoUrl":2769,"updatedAt":2862},"azure-ai-vision-imageanalysis-py","analyze images with Azure AI Vision","Azure AI Vision Image Analysis SDK for captions, tags, objects, OCR, people detection, and smart cropping. Use for computer vision and image understanding tasks.\nTriggers: \"image analysis\", \"computer vision\", \"OCR\", \"object detection\", \"ImageAnalysisClient\", \"image caption\".\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2854,2855,2858,2861],{"name":2763,"slug":2764,"type":15},{"name":2856,"slug":2857,"type":15},"Computer Vision","computer-vision",{"name":2859,"slug":2860,"type":15},"Images","images",{"name":2820,"slug":2821,"type":15},"2026-07-18T05:14:18.007737",{"slug":2864,"name":2864,"fn":2865,"description":2866,"org":2867,"tags":2868,"stars":2768,"repoUrl":2769,"updatedAt":2877},"azure-appconfiguration-java","manage configuration with Azure App Configuration","Azure App Configuration SDK for Java. Centralized application configuration management with key-value settings, feature flags, and snapshots.\nTriggers: \"ConfigurationClient java\", \"app configuration java\", \"feature flag java\", \"configuration setting java\", \"azure config java\".\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2869,2870,2873,2876],{"name":2763,"slug":2764,"type":15},{"name":2871,"slug":2872,"type":15},"Configuration","configuration",{"name":2874,"slug":2875,"type":15},"Feature Flags","feature-flags",{"name":2785,"slug":2786,"type":15},"2026-07-03T16:32:01.278468",{"slug":2879,"name":2879,"fn":2880,"description":2881,"org":2882,"tags":2883,"stars":2768,"repoUrl":2769,"updatedAt":2894},"azure-cosmos-rust","build applications with Azure Cosmos DB","Azure Cosmos DB library for Rust (NoSQL API). Document CRUD, containers, and globally distributed data.\nTriggers: \"cosmos db rust\", \"CosmosClient rust\", \"document crud rust\", \"NoSQL rust\", \"partition key rust\".\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2884,2887,2888,2891],{"name":2885,"slug":2886,"type":15},"Cosmos DB","cosmos-db",{"name":2718,"slug":2719,"type":15},{"name":2889,"slug":2890,"type":15},"NoSQL","nosql",{"name":2892,"slug":2893,"type":15},"Rust","rust","2026-07-31T05:54:27.021432",{"slug":2896,"name":2896,"fn":2880,"description":2897,"org":2898,"tags":2899,"stars":2768,"repoUrl":2769,"updatedAt":2907},"azure-cosmos-ts","Azure Cosmos DB JavaScript\u002FTypeScript SDK (@azure\u002Fcosmos) for data plane operations. Use for CRUD operations on documents, queries, bulk operations, and container management. Triggers: \"Cosmos DB\", \"@azure\u002Fcosmos\", \"CosmosClient\", \"document CRUD\", \"NoSQL queries\", \"bulk operations\", \"partition key\", \"container.items\".\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2900,2901,2902,2903,2904],{"name":2885,"slug":2886,"type":15},{"name":2718,"slug":2719,"type":15},{"name":9,"slug":8,"type":15},{"name":2889,"slug":2890,"type":15},{"name":2905,"slug":2906,"type":15},"TypeScript","typescript","2026-07-03T16:31:19.368382",{"slug":2909,"name":2909,"fn":2910,"description":2911,"org":2912,"tags":2913,"stars":2768,"repoUrl":2769,"updatedAt":2919},"azure-data-tables-java","build table storage applications with Java","Build table storage applications with Azure Tables SDK for Java. Use when working with Azure Table Storage or Cosmos DB Table API for NoSQL key-value data, schemaless storage, or structured data at scale.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2914,2915,2916,2917,2918],{"name":2763,"slug":2764,"type":15},{"name":2885,"slug":2886,"type":15},{"name":2718,"slug":2719,"type":15},{"name":2785,"slug":2786,"type":15},{"name":2889,"slug":2890,"type":15},"2026-05-13T06:14:17.582229",267]