[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-microsoft-deploy-site":3,"mdc--3n9zml-key":40,"related-repo-microsoft-deploy-site":3250,"related-org-microsoft-deploy-site":3347},{"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},"deploy-site","deploy Power Pages websites","Deploys an existing Power Pages code site to a Power Pages environment using PAC CLI. Handles tooling verification, authentication, environment confirmation, building, and uploading. Use when the user wants to deploy, upload, or publish their code site.",{"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},"Power Pages","power-pages","tag",{"name":9,"slug":8,"type":15},{"name":18,"slug":19,"type":15},"Deployment","deployment",{"name":21,"slug":22,"type":15},"Frontend","frontend",564,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fpower-platform-skills","2026-04-06T18:34:33.465251",null,114,[29,30,31,32,33,14,34],"claude-code-plugin","claude-code-skills","code-apps","github-copilot-plugin","power-apps","power-platform",{"repoUrl":24,"stars":23,"forks":27,"topics":36,"description":37},[29,30,31,32,33,14,34],"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\u002Fdeploy-site","---\nname: deploy-site\ndescription: >-\n  Deploys an existing Power Pages code site to a Power Pages environment using PAC CLI.\n  Handles tooling verification, authentication, environment confirmation, building, and\n  uploading. Use when the user wants to deploy, upload, or publish their code site.\nuser-invocable: true\nallowed-tools: Read, Bash, AskUserQuestion, Glob, Grep, TaskCreate, TaskUpdate, TaskList\nmodel: sonnet\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# Deploy Power Pages Code Site\n\nGuide the user through deploying an existing Power Pages code site to a Power Pages environment using PAC CLI. Follow a systematic approach: verify tooling, authenticate, confirm the target environment, build and upload the site, and handle any blockers.\n\n## Core Principles\n\n- **Verify before acting**: Always confirm PAC CLI availability, authentication status, and the target environment before attempting any deployment.\n- **Use TaskCreate\u002FTaskUpdate**: Track all progress throughout all phases — create the todo list upfront with all phases before starting any work.\n- **Never change environment settings without consent**: If deployment requires modifying environment configuration (e.g., unblocking JavaScript attachments), always explain the change and get explicit user permission first.\n\n**Initial request:** $ARGUMENTS\n\n---\n\n## Phase 1: Verify PAC CLI\n\n**Goal**: Ensure PAC CLI is installed and available on the system PATH\n\n**Actions**:\n\n1. Create todo list with all 6 phases (see [Progress Tracking](#progress-tracking) table)\n2. Run `pac help` to check if the PAC CLI is installed and available on the system PATH.\n\n   ```bash\n   pac help\n   ```\n\n3. **If the command succeeds**: PAC CLI is installed. Proceed to Phase 2.\n\n4. **If the command fails** (command not found \u002F not recognized):\n\n   1. Inform the user that PAC CLI is required but not installed.\n   2. Fetch installation instructions from `https:\u002F\u002Faka.ms\u002FPowerPlatformCLI` using the following approach:\n      - Tell the user: \"PAC CLI is not installed. You can install it by running:\"\n\n        ```bash\n        dotnet tool install --global Microsoft.PowerApps.CLI.Tool\n        ```\n\n      - If `dotnet` is also not available, direct the user to \u003Chttps:\u002F\u002Faka.ms\u002FPowerPlatformCLI> for full installation instructions including .NET SDK setup.\n\n   3. After installation, verify by running `pac help` again.\n   4. If it still fails, stop and ask the user to resolve the installation manually.\n\n**Output**: PAC CLI installed and verified\n\n---\n\n## Phase 2: Verify Authentication\n\n**Goal**: Ensure the user is authenticated with PAC CLI and has a valid session\n\n**Actions**:\n\n1. Run `pac auth who` to check the current authentication status.\n\n   ```bash\n   pac auth who\n   ```\n\n2. **If authenticated**: Extract the following values from the output:\n   - **Environment name** and **URL**\n   - **Environment ID** — the GUID after `Environment ID:`\n   - **Cloud** — the value after `Cloud:` (e.g., `Public`, `UsGov`, `UsGovHigh`, `UsGovDod`, `China`)\n\n   Proceed to Phase 3.\n\n3. **If not authenticated**:\n\n   1. Inform the user they are not authenticated with PAC CLI.\n\n   \u003C!-- not-a-gate: free-text env URL fallback when PAC CLI auth is missing — data-gathering, no destructive action -->\n\n   2. Use `AskUserQuestion` to ask for the environment URL:\n\n      | Question | Header | Options |\n      |----------|--------|---------|\n      | You are not authenticated with PAC CLI. Please provide your Power Pages environment URL (e.g., `https:\u002F\u002Forg12345.crm.dynamics.com`) so I can authenticate you. | Auth | *(free text input via \"Other\")* |\n\n      Provide two placeholder options to guide the user:\n      - \"I'll paste the URL\" (description: \"Select 'Other' below and paste your environment URL\")\n      - \"I don't know my URL\" (description: \"You can find it in the Power Platform admin center under Environments > your environment > Environment URL\")\n\n   3. Once the user provides the URL, run the authentication command:\n\n      ```bash\n      pac auth create --environment \"\u003CUSER_PROVIDED_URL>\"\n      ```\n\n      This will open a browser window for the user to sign in.\n\n   4. After the command completes, verify by running `pac auth who` again.\n   5. If authentication succeeds, proceed to Phase 3.\n   6. If authentication fails, present the error to the user and help them troubleshoot.\n\n**Output**: Authenticated PAC CLI session with environment name and URL extracted\n\n---\n\n## Phase 3: Confirm Environment\n\n**Goal**: Ensure the user is deploying to the correct target environment\n\n**Actions**:\n\n\u003C!-- gate: deploy-site:3.confirm-env | category=consent | cancel-leaves=nothing -->\n\n> 🚦 **Gate (consent · deploy-site:3.confirm-env):** Echo the current environment and require explicit confirmation before any upload. Covers the follow-up \"pick a different env\" sub-prompt in the same section — wrong-env deploys are the #1 destructive shared-state failure for this skill, so this gate must fire even when PAC CLI shows a recognizable env.\n>\n> **Trigger:** Phase 3 entry; environment resolved from PAC CLI.\n> **Why we ask:** Site uploaded to wrong tenant \u002F wrong env — committed to a Dataverse instance the user did not intend; cleanup requires manual deletion or another deploy from a different env.\n> **Cancel leaves:** Nothing — no upload fired.\n\n1. Present the current environment information to the user and ask them to confirm.\n\n   Use `AskUserQuestion` with the following structure:\n\n   | Question | Header | Options |\n   |----------|--------|---------|\n   | You are currently connected to environment: **\u003CENV_NAME>** (\u003CENV_URL>). Do you want to deploy to this environment? | Environment | Yes, use this environment, No, let me choose a different one |\n\n2. **If \"Yes, use this environment\"**: Proceed to Phase 4.\n\n3. **If \"No, let me choose a different one\"**:\n\n   1. Run `pac org list` to retrieve all available environments:\n\n      ```bash\n      pac org list\n      ```\n\n   2. Parse the output to extract environment names and URLs.\n   3. Use `AskUserQuestion` to present the available environments as options (pick up to 4 most relevant, or let user specify).\n   4. Once the user selects an environment, switch to it:\n\n      ```bash\n      pac org select --environment \"\u003CSELECTED_ENV_ID_OR_URL>\"\n      ```\n\n   5. Verify the switch by running `pac auth who` again.\n\n**Output**: Confirmed target environment for deployment\n\n---\n\n## Phase 4: Deploy the Code Site\n\n**Goal**: Locate the project, build it, and upload to Power Pages\n\n**Actions**:\n\n### 4.1 Locate the Project Root\n\nDetermine the project root directory. The project root is the directory containing `powerpages.config.json`. Use `Glob` to search for it:\n\n```text\n**\u002Fpowerpages.config.json\n```\n\n\u003C!-- gate: deploy-site:4.1.multi-project | category=plan | cancel-leaves=nothing -->\n\n> 🚦 **Gate (plan · deploy-site:4.1.multi-project):** More than one `powerpages.config.json` candidate found — pick the right project to deploy.\n>\n> **Trigger:** Phase 4.1 glob returned multiple matches.\n> **Why we ask:** Wrong project uploaded — pollutes the target env with files from a different site.\n> **Cancel leaves:** Nothing — no upload fired.\n\nIf found in the current working directory or a subdirectory, use that directory as `PROJECT_ROOT`. If multiple are found, ask the user which one to deploy using `AskUserQuestion`.\n\nIf not found, ask the user to provide the path to the project root.\n\n### 4.2 Offer Permissions Audit (Redeployments Only)\n\nIf `.powerpages-site` already exists (i.e., this is not the first deployment), table permissions and site settings may have drifted from the code since the last deployment. Offer to audit before deploying.\n\n\u003C!-- gate: deploy-site:4.2.audit-permissions | category=plan | cancel-leaves=nothing -->\n\n> 🚦 **Gate (plan · deploy-site:4.2.audit-permissions):** Re-deployment detected — offer to run `\u002Faudit-permissions` to catch drift between code and table permissions before push.\n>\n> **Trigger:** `.powerpages-site` exists (not first deployment).\n> **Why we ask:** Stale permission YAML deploys, causing 403s for users until next audit run.\n> **Cancel leaves:** Nothing — audit is read-only; declining just proceeds to build + upload.\n\nUse `AskUserQuestion`:\n\n| Question | Header | Options |\n|----------|--------|---------|\n| This site has been deployed before. Would you like to run a permissions audit to verify table permissions match your current code before deploying? | Audit | Yes, audit permissions (Recommended), Skip — permissions are up to date |\n\n**If \"Yes\"**: Invoke `\u002Faudit-permissions` to run the audit. After the audit completes, resume with Step 4.3.\n**If \"Skip\"**: Proceed to Step 4.3.\n\nIf `.powerpages-site` does **not** exist (first deployment), skip this step — there are no existing permissions to audit.\n\n### 4.3 Build the Site\n\nBefore uploading, ensure the site is built:\n\n```bash\ncd \"\u003CPROJECT_ROOT>\"\nnpm run build\n```\n\nIf the build fails, stop and help the user fix the build errors before retrying.\n\n### 4.4 Upload to Power Pages\n\nRun the upload command:\n\n```bash\npac pages upload-code-site --rootPath \"\u003CPROJECT_ROOT>\"\n```\n\n**If the upload succeeds**: Proceed to Phase 5 to verify the deployment.\n\n**If the upload fails**: Check the error message:\n\n- If the failure is related to **blocked JavaScript** (`.js`) attachments → proceed to **Phase 6**\n- If the failure mentions **`.html` type attachments are currently blocked** → this is a **misleading error**. See [Troubleshooting: HTML Blocked Attachment Error](#troubleshooting-html-blocked-attachment-error) below\n- For other errors → present the error to the user and help them troubleshoot\n\n**Output**: Site built and uploaded to Power Pages\n\n---\n\n## Phase 5: Verify Deployment\n\n**Goal**: Confirm the deployment was successful and handle post-deployment steps\n\n**Actions**:\n\n### 5.1 Verify `.powerpages-site` Folder\n\nConfirm `.powerpages-site` exists and list its contents (`web-roles\u002F`, `site-settings\u002F`, `table-permissions\u002F`).\n\n### 5.2 Record Skill Usage\n\n> Reference: `${PLUGIN_ROOT}\u002Freferences\u002Fskill-tracking-reference.md`\n\nFollow the skill tracking instructions in the reference to record this skill's usage. Use `--skillName \"DeploySite\"`.\n\n### 5.3 Confirm Upload Output\n\nReview the output from the `pac pages upload-code-site` command in Phase 4 (or Phase 6 retry). Verify it reported a successful upload with no errors.\n\n### 5.4 Commit Changes\n\nStage and commit deployment artifacts:\n\n```bash\ngit add -A\ngit commit -m \"Deploy site to Power Pages\"\n```\n\n### 5.5 Check Activation Status\n\nRun the activation status check:\n\n```bash\nnode \"${PLUGIN_ROOT}\u002Fscripts\u002Fcheck-activation-status.js\" --projectRoot \"\u003CPROJECT_ROOT>\"\n```\n\nEvaluate the JSON result:\n\n- **If `activated` is `true`**: Inform the user their site is already activated (show `websiteUrl` if present). Proceed to step 5.6, then skip to [Suggest Next Steps](#suggest-next-steps). Do NOT ask about activation.\n- **If `activated` is `false`**: Proceed to step 5.5.1.\n- **If `error` is present**: Fall back to step 5.5.1. Do not block the deployment flow.\n\n#### 5.5.1 Ask About Activation (only if site is NOT already activated)\n\n\u003C!-- gate: deploy-site:5.5.1.activate | category=plan | cancel-leaves=nothing -->\n\n> 🚦 **Gate (plan · deploy-site:5.5.1.activate):** Site deployed but not yet activated — offer to invoke `\u002Factivate-site` to provision the subdomain.\n>\n> **Trigger:** Phase 5.5 detected `activated:false` on a fresh deploy.\n> **Why we ask:** Auto-activating writes the wrong subdomain (permanent for the site); auto-skipping leaves the site without a live URL.\n> **Cancel leaves:** Nothing — no activation API call fired.\n\nAsk the user if they want to activate the site using `AskUserQuestion`:\n\n| Question | Header | Options |\n|----------|--------|---------|\n| Site deployed successfully! Would you like to activate (provision) the site now so it gets a live URL? | Activate | Activate now (Recommended) — Provision the site with a subdomain and make it live, Skip for now — I'll activate later |\n\n**If \"Activate now\"**: Invoke the `\u002Factivate-site` skill. After activation completes, proceed to step 5.6 to clear the site cache.\n**If \"Skip for now\"**: Suggest next steps (see [Suggest Next Steps](#suggest-next-steps)).\n\n### 5.6 Clear Site Cache (Only If Activated)\n\nAfter confirming the site is activated (either it was already activated in step 5.5, or the user just activated it in step 5.5.1), offer to clear the runtime cache so the deployed changes are immediately visible.\n\n**Prerequisites**: The site must be activated and the project root must be known (from Phase 4.1).\n\n\u003C!-- gate: deploy-site:5.6.restart-cache | category=plan | cancel-leaves=nothing -->\n\n> 🚦 **Gate (plan · deploy-site:5.6.restart-cache):** Restart the deployed site to flush its runtime cache. Brief production downtime (a few seconds) — explicit user consent required even though the action is recoverable.\n>\n> **Trigger:** Site confirmed activated (either pre-existing or just activated in 5.5.1).\n> **Why we ask:** Production users see stale content for several minutes until cache TTL expires.\n> **Cancel leaves:** Nothing — the deploy itself already succeeded; cache will refresh on its own.\n\nUse `AskUserQuestion` to confirm before proceeding:\n\n| Question | Header | Options |\n|----------|--------|---------|\n| Would you like to restart the site so your latest changes are immediately visible? This may cause a brief downtime (a few seconds). | Restart | Yes, restart site (Recommended), Skip — I'll restart later |\n\n**If \"Skip\"**: Skip to [Suggest Next Steps](#suggest-next-steps).\n\n**If \"Yes\"**: Run the cache-clearing script, passing the project root:\n\n```bash\nnode \"${PLUGIN_ROOT}\u002Fscripts\u002Fclear-site-cache.js\" --projectRoot \"\u003CPROJECT_ROOT>\"\n```\n\nThe script reads `siteName` from `powerpages.config.json`, looks up the website via the Power Platform API, and restarts it to flush the runtime cache.\n\nEvaluate the result:\n\n- **If `success` is `true`**: Inform the user: \"Site cache cleared — your latest changes should now be visible at **\u003CwebsiteUrl>**.\"\n- **If `success` is `false`**: Warn the user that cache clearing failed and show the error, but do not block the deployment flow. The deployment itself succeeded; cache will eventually refresh on its own. Suggest the user can manually clear cache from the Power Pages admin center if needed.\n\n**Output**: Deployment verified, changes committed, activation offered, cache cleared\n\n---\n\n## Phase 6: Handle Blocked JavaScript\n\n**Goal**: Resolve blocked JavaScript attachment errors and retry deployment\n\n**Actions**:\n\n### 6.1 Explain the Issue\n\nTell the user:\n> \"The upload failed because JavaScript (.js) file attachments are blocked in your Power Pages environment. This is a security setting that prevents uploading .js files. To deploy a code site, this restriction needs to be relaxed for .js files.\"\n\n### 6.2 Ask for Permission\n\n\u003C!-- gate: deploy-site:6.2.unblock-js | category=consent | cancel-leaves=attachment-block-modified -->\n\n> 🚦 **Gate (consent · deploy-site:6.2.unblock-js):** Reactive `blockedattachments` modification — destructive shared-state change (tenant-wide env setting). Same shape as `deploy-pipeline:7.6.2.blocked-attachments`.\n>\n> **Trigger:** Upload failed with the blocked-`.js` error.\n> **Why we ask:** Auto-unblocking modifies a tenant security setting without explicit consent — visible across the entire environment, not just this site.\n> **Cancel leaves:** `attachment-block-modified` is only possible if the user approved and then a downstream step partial-completed. Pure Cancel here leaves nothing — the original blockedattachments value is untouched.\n\nUse `AskUserQuestion`:\n\n| Question | Header | Options |\n|----------|--------|---------|\n| Would you like to remove the JavaScript (.js) block from the environment's blocked attachments list? This is required to deploy code sites. | Unblock JS | Yes, remove the .js block (Recommended), No, do not change environment settings |\n\n**If \"No\"**: Stop and inform the user that the deployment cannot proceed without unblocking `.js` attachments.\n\n**If \"Yes\"**: Proceed to 6.3.\n\n### 6.3 Update Blocked Attachments\n\n1. Run `pac env list-settings` to retrieve the current environment settings:\n\n   ```bash\n   pac env list-settings\n   ```\n\n2. Find the `blockedattachments` property in the output. It will contain a semicolon-separated list of file extensions (e.g., `ade;adp;app;asa;ashx;asmx;asp;bas;bat;cdx;cer;chm;class;cmd;com;config;cnt;cpl;crt;csh;der;dll;exe;fxp;hlp;hta;htr;htw;ida;idc;idq;inf;ins;isp;its;js;jse;ksh;lnk;mad;maf;mag;mam;maq;mar;mas;mat;mau;mav;maw;mda;mdb;mde;mdt;mdw;mdz;msc;msh;msh1;msh1xml;msh2;msh2xml;mshxml;msi;msp;mst;ops;pcd;pif;prf;prg;printer;pst;reg;rem;scf;scr;sct;shb;shs;shtm;shtml;soap;stm;tmp;url;vb;vbe;vbs;vsmacros;vss;vst;vsw;ws;wsc;wsf;wsh`).\n\n3. Remove `js` from the list. Parse the semicolon-separated values, filter out `js`, and rejoin with semicolons.\n\n4. Update the setting:\n\n   ```bash\n   pac env update-settings --name blockedattachments --value \"\u003CUPDATED_LIST_WITHOUT_JS>\"\n   ```\n\n5. Confirm the update was successful.\n\n### 6.4 Retry Upload\n\nRun the upload command again:\n\n```bash\npac pages upload-code-site --rootPath \"\u003CPROJECT_ROOT>\"\n```\n\nIf it succeeds: Proceed to Phase 5 to verify the deployment.\n\nIf it fails again with a different error, present the error to the user and help troubleshoot.\n\n**Output**: JavaScript unblocked and site deployed successfully\n\n---\n\n## Troubleshooting: HTML Blocked Attachment Error\n\nIf the upload fails with an error like:\n\n```\nError: Unable to upload webfile name 'index.html' with record Id \u003CGUID> as '.html' type attachments are currently blocked on this environment.\n```\n\n**This error is misleading.** The `.html` extension is not actually blocked — the real cause is a stale environment manifest file in the `.powerpages-site` folder. This manifest maps local files to Dataverse record IDs from a previous upload. When the mapping becomes outdated (e.g., after environment changes or record deletions), the upload fails with this confusing error.\n\n### Fix\n\n1. Locate the environment-specific manifest file in the `.powerpages-site` folder. It follows the naming pattern `\u003Cenvironment-host>-manifest.yml` (e.g., `demo1.crm.dynamics.com-manifest.yml`). Use your file-search tool (e.g., `Glob` with pattern `\u003CPROJECT_ROOT>\u002F.powerpages-site\u002F*-manifest.yml`) to find it.\n\n2. Delete the manifest file at `\u003CPROJECT_ROOT>\u002F.powerpages-site\u002F\u003Cenvironment-host>-manifest.yml`.\n\n3. Retry the upload:\n\n   ```bash\n   pac pages upload-code-site --rootPath \"\u003CPROJECT_ROOT>\"\n   ```\n\nIf the retry succeeds, proceed to Phase 5. If it fails with a different error, present the error to the user and help them troubleshoot.\n\n> **Important**: Do NOT attempt to unblock `.html` in the environment's blocked attachments list — the error is not caused by the attachment block setting.\n\n---\n\n## Suggest Next Steps\n\nIf the user skips activation (or after activation completes), suggest:\n\n- `\u002Factivate-site` — Provision the site with a subdomain and make it live (if not already activated)\n- `\u002Ftest-site` — Test the deployed site in the browser (verify pages load, check API calls)\n- `\u002Faudit-permissions` — Audit table permissions against current code (recommended after redeployments)\n- `\u002Fsetup-datamodel` — Create Dataverse tables for dynamic content\n- `\u002Fadd-seo` — Add meta tags, robots.txt, sitemap.xml, favicon\n\n---\n\n## Important Notes\n\n### NEVER Use `pac pages upload`\n\nAlways use `pac pages upload-code-site` — **never** use `pac pages upload`. The `pac pages upload` command is designed for portal-studio-style sites and will corrupt code site metadata if used on a code site project. This applies to every upload step in this skill (Phase 4.4, Phase 6.4, and troubleshooting retries).\n\n### Throughout All Phases\n\n- **Use TaskCreate\u002FTaskUpdate** to track progress at every phase\n- **Ask for user confirmation** at key decision points (see list below)\n- **Present errors clearly** — when a command fails, show the user the relevant error output and explain what went wrong before suggesting fixes\n\n### Key Decision Points (Wait for User)\n\n1. After Phase 2: If not authenticated, get environment URL from user\n2. At Phase 3: Confirm or switch the target environment\n3. At Phase 4.1: If multiple `powerpages.config.json` found, ask which project to deploy\n4. At Phase 4.2: Audit permissions now or skip (redeployments only)\n5. At Phase 5.5: Activate site now or later\n6. At Phase 6: Get permission before modifying blocked attachments setting\n\n### Progress Tracking\n\nBefore starting Phase 1, create a task list with all phases using `TaskCreate`:\n\n| Task subject | activeForm | Description |\n|-------------|------------|-------------|\n| Verify PAC CLI installation | Verifying PAC CLI | Check if PAC CLI is installed, install if missing |\n| Verify authentication | Verifying authentication | Check current auth status, authenticate if needed |\n| Confirm target environment | Confirming environment | Show current environment, let user confirm or switch |\n| Deploy the code site | Deploying site | Locate project root, build, and upload via pac pages upload-code-site |\n| Verify deployment | Verifying deployment | Confirm .powerpages-site folder exists, review upload output, commit changes, offer activation |\n| Handle blocked JavaScript | Resolving JS block | If upload fails due to blocked JS, offer to unblock and retry |\n\nMark each task `in_progress` when starting it and `completed` when done via `TaskUpdate`. Phase 6 may be marked `completed` immediately if no JavaScript blocking issue is encountered. This gives the user visibility into progress and keeps the workflow deterministic.\n\n---\n\n**Begin with Phase 1: Verify PAC CLI**\n",{"data":41,"body":45},{"name":4,"description":6,"user-invocable":42,"allowed-tools":43,"model":44},true,"Read, Bash, AskUserQuestion, Glob, Grep, TaskCreate, TaskUpdate, TaskList","sonnet",{"type":46,"children":47},"root",[48,75,82,87,94,129,139,143,149,159,169,350,360,363,369,378,386,720,729,732,738,747,755,794,992,1001,1004,1010,1019,1027,1034,1055,1065,1106,1126,1131,1137,1149,1199,1209,1251,1275,1293,1299,1304,1351,1356,1362,1367,1408,1418,1428,1494,1503,1506,1512,1521,1529,1542,1576,1582,1596,1608,1614,1627,1633,1638,1693,1699,1704,1762,1767,1847,1854,1905,1916,1958,1987,1993,1998,2008,2043,2054,2096,2110,2119,2170,2190,2195,2248,2257,2260,2266,2275,2283,2289,2294,2302,2308,2372,2382,2424,2441,2450,2456,2595,2601,2606,2643,2648,2653,2662,2665,2670,2675,2684,2708,2714,2813,2818,2838,2841,2846,2851,2907,2910,2916,2928,2961,2967,2999,3005,3045,3050,3062,3197,3233,3236,3244],{"type":49,"tag":50,"props":51,"children":52},"element","blockquote",{},[53],{"type":49,"tag":54,"props":55,"children":56},"p",{},[57,64,66,73],{"type":49,"tag":58,"props":59,"children":60},"strong",{},[61],{"type":62,"value":63},"text","Plugin check",{"type":62,"value":65},": Run ",{"type":49,"tag":67,"props":68,"children":70},"code",{"className":69},[],[71],{"type":62,"value":72},"node \"${PLUGIN_ROOT}\u002Fscripts\u002Fcheck-version.js\"",{"type":62,"value":74}," — if it outputs a message, show it to the user before proceeding.",{"type":49,"tag":76,"props":77,"children":79},"h1",{"id":78},"deploy-power-pages-code-site",[80],{"type":62,"value":81},"Deploy Power Pages Code Site",{"type":49,"tag":54,"props":83,"children":84},{},[85],{"type":62,"value":86},"Guide the user through deploying an existing Power Pages code site to a Power Pages environment using PAC CLI. Follow a systematic approach: verify tooling, authenticate, confirm the target environment, build and upload the site, and handle any blockers.",{"type":49,"tag":88,"props":89,"children":91},"h2",{"id":90},"core-principles",[92],{"type":62,"value":93},"Core Principles",{"type":49,"tag":95,"props":96,"children":97},"ul",{},[98,109,119],{"type":49,"tag":99,"props":100,"children":101},"li",{},[102,107],{"type":49,"tag":58,"props":103,"children":104},{},[105],{"type":62,"value":106},"Verify before acting",{"type":62,"value":108},": Always confirm PAC CLI availability, authentication status, and the target environment before attempting any deployment.",{"type":49,"tag":99,"props":110,"children":111},{},[112,117],{"type":49,"tag":58,"props":113,"children":114},{},[115],{"type":62,"value":116},"Use TaskCreate\u002FTaskUpdate",{"type":62,"value":118},": Track all progress throughout all phases — create the todo list upfront with all phases before starting any work.",{"type":49,"tag":99,"props":120,"children":121},{},[122,127],{"type":49,"tag":58,"props":123,"children":124},{},[125],{"type":62,"value":126},"Never change environment settings without consent",{"type":62,"value":128},": If deployment requires modifying environment configuration (e.g., unblocking JavaScript attachments), always explain the change and get explicit user permission first.",{"type":49,"tag":54,"props":130,"children":131},{},[132,137],{"type":49,"tag":58,"props":133,"children":134},{},[135],{"type":62,"value":136},"Initial request:",{"type":62,"value":138}," $ARGUMENTS",{"type":49,"tag":140,"props":141,"children":142},"hr",{},[],{"type":49,"tag":88,"props":144,"children":146},{"id":145},"phase-1-verify-pac-cli",[147],{"type":62,"value":148},"Phase 1: Verify PAC CLI",{"type":49,"tag":54,"props":150,"children":151},{},[152,157],{"type":49,"tag":58,"props":153,"children":154},{},[155],{"type":62,"value":156},"Goal",{"type":62,"value":158},": Ensure PAC CLI is installed and available on the system PATH",{"type":49,"tag":54,"props":160,"children":161},{},[162,167],{"type":49,"tag":58,"props":163,"children":164},{},[165],{"type":62,"value":166},"Actions",{"type":62,"value":168},":",{"type":49,"tag":170,"props":171,"children":172},"ol",{},[173,187,229,239],{"type":49,"tag":99,"props":174,"children":175},{},[176,178,185],{"type":62,"value":177},"Create todo list with all 6 phases (see ",{"type":49,"tag":179,"props":180,"children":182},"a",{"href":181},"#progress-tracking",[183],{"type":62,"value":184},"Progress Tracking",{"type":62,"value":186}," table)",{"type":49,"tag":99,"props":188,"children":189},{},[190,192,198,200],{"type":62,"value":191},"Run ",{"type":49,"tag":67,"props":193,"children":195},{"className":194},[],[196],{"type":62,"value":197},"pac help",{"type":62,"value":199}," to check if the PAC CLI is installed and available on the system PATH.",{"type":49,"tag":201,"props":202,"children":207},"pre",{"className":203,"code":204,"language":205,"meta":206,"style":206},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","pac help\n","bash","",[208],{"type":49,"tag":67,"props":209,"children":210},{"__ignoreMap":206},[211],{"type":49,"tag":212,"props":213,"children":216},"span",{"class":214,"line":215},"line",1,[217,223],{"type":49,"tag":212,"props":218,"children":220},{"style":219},"--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B",[221],{"type":62,"value":222},"pac",{"type":49,"tag":212,"props":224,"children":226},{"style":225},"--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D",[227],{"type":62,"value":228}," help\n",{"type":49,"tag":99,"props":230,"children":231},{},[232,237],{"type":49,"tag":58,"props":233,"children":234},{},[235],{"type":62,"value":236},"If the command succeeds",{"type":62,"value":238},": PAC CLI is installed. Proceed to Phase 2.",{"type":49,"tag":99,"props":240,"children":241},{},[242,247,249],{"type":49,"tag":58,"props":243,"children":244},{},[245],{"type":62,"value":246},"If the command fails",{"type":62,"value":248}," (command not found \u002F not recognized):",{"type":49,"tag":170,"props":250,"children":251},{},[252,257,333,345],{"type":49,"tag":99,"props":253,"children":254},{},[255],{"type":62,"value":256},"Inform the user that PAC CLI is required but not installed.",{"type":49,"tag":99,"props":258,"children":259},{},[260,262,268,270],{"type":62,"value":261},"Fetch installation instructions from ",{"type":49,"tag":67,"props":263,"children":265},{"className":264},[],[266],{"type":62,"value":267},"https:\u002F\u002Faka.ms\u002FPowerPlatformCLI",{"type":62,"value":269}," using the following approach:",{"type":49,"tag":95,"props":271,"children":272},{},[273,313],{"type":49,"tag":99,"props":274,"children":275},{},[276,278],{"type":62,"value":277},"Tell the user: \"PAC CLI is not installed. You can install it by running:\"",{"type":49,"tag":201,"props":279,"children":281},{"className":203,"code":280,"language":205,"meta":206,"style":206},"dotnet tool install --global Microsoft.PowerApps.CLI.Tool\n",[282],{"type":49,"tag":67,"props":283,"children":284},{"__ignoreMap":206},[285],{"type":49,"tag":212,"props":286,"children":287},{"class":214,"line":215},[288,293,298,303,308],{"type":49,"tag":212,"props":289,"children":290},{"style":219},[291],{"type":62,"value":292},"dotnet",{"type":49,"tag":212,"props":294,"children":295},{"style":225},[296],{"type":62,"value":297}," tool",{"type":49,"tag":212,"props":299,"children":300},{"style":225},[301],{"type":62,"value":302}," install",{"type":49,"tag":212,"props":304,"children":305},{"style":225},[306],{"type":62,"value":307}," --global",{"type":49,"tag":212,"props":309,"children":310},{"style":225},[311],{"type":62,"value":312}," Microsoft.PowerApps.CLI.Tool\n",{"type":49,"tag":99,"props":314,"children":315},{},[316,318,323,325,331],{"type":62,"value":317},"If ",{"type":49,"tag":67,"props":319,"children":321},{"className":320},[],[322],{"type":62,"value":292},{"type":62,"value":324}," is also not available, direct the user to ",{"type":49,"tag":179,"props":326,"children":329},{"href":267,"rel":327},[328],"nofollow",[330],{"type":62,"value":267},{"type":62,"value":332}," for full installation instructions including .NET SDK setup.",{"type":49,"tag":99,"props":334,"children":335},{},[336,338,343],{"type":62,"value":337},"After installation, verify by running ",{"type":49,"tag":67,"props":339,"children":341},{"className":340},[],[342],{"type":62,"value":197},{"type":62,"value":344}," again.",{"type":49,"tag":99,"props":346,"children":347},{},[348],{"type":62,"value":349},"If it still fails, stop and ask the user to resolve the installation manually.",{"type":49,"tag":54,"props":351,"children":352},{},[353,358],{"type":49,"tag":58,"props":354,"children":355},{},[356],{"type":62,"value":357},"Output",{"type":62,"value":359},": PAC CLI installed and verified",{"type":49,"tag":140,"props":361,"children":362},{},[],{"type":49,"tag":88,"props":364,"children":366},{"id":365},"phase-2-verify-authentication",[367],{"type":62,"value":368},"Phase 2: Verify Authentication",{"type":49,"tag":54,"props":370,"children":371},{},[372,376],{"type":49,"tag":58,"props":373,"children":374},{},[375],{"type":62,"value":156},{"type":62,"value":377},": Ensure the user is authenticated with PAC CLI and has a valid session",{"type":49,"tag":54,"props":379,"children":380},{},[381,385],{"type":49,"tag":58,"props":382,"children":383},{},[384],{"type":62,"value":166},{"type":62,"value":168},{"type":49,"tag":170,"props":387,"children":388},{},[389,425,530],{"type":49,"tag":99,"props":390,"children":391},{},[392,393,399,401],{"type":62,"value":191},{"type":49,"tag":67,"props":394,"children":396},{"className":395},[],[397],{"type":62,"value":398},"pac auth who",{"type":62,"value":400}," to check the current authentication status.",{"type":49,"tag":201,"props":402,"children":404},{"className":203,"code":403,"language":205,"meta":206,"style":206},"pac auth who\n",[405],{"type":49,"tag":67,"props":406,"children":407},{"__ignoreMap":206},[408],{"type":49,"tag":212,"props":409,"children":410},{"class":214,"line":215},[411,415,420],{"type":49,"tag":212,"props":412,"children":413},{"style":219},[414],{"type":62,"value":222},{"type":49,"tag":212,"props":416,"children":417},{"style":225},[418],{"type":62,"value":419}," auth",{"type":49,"tag":212,"props":421,"children":422},{"style":225},[423],{"type":62,"value":424}," who\n",{"type":49,"tag":99,"props":426,"children":427},{},[428,433,435,524,528],{"type":49,"tag":58,"props":429,"children":430},{},[431],{"type":62,"value":432},"If authenticated",{"type":62,"value":434},": Extract the following values from the output:",{"type":49,"tag":95,"props":436,"children":437},{},[438,453,469],{"type":49,"tag":99,"props":439,"children":440},{},[441,446,448],{"type":49,"tag":58,"props":442,"children":443},{},[444],{"type":62,"value":445},"Environment name",{"type":62,"value":447}," and ",{"type":49,"tag":58,"props":449,"children":450},{},[451],{"type":62,"value":452},"URL",{"type":49,"tag":99,"props":454,"children":455},{},[456,461,463],{"type":49,"tag":58,"props":457,"children":458},{},[459],{"type":62,"value":460},"Environment ID",{"type":62,"value":462}," — the GUID after ",{"type":49,"tag":67,"props":464,"children":466},{"className":465},[],[467],{"type":62,"value":468},"Environment ID:",{"type":49,"tag":99,"props":470,"children":471},{},[472,477,479,485,487,493,495,501,502,508,509,515,516,522],{"type":49,"tag":58,"props":473,"children":474},{},[475],{"type":62,"value":476},"Cloud",{"type":62,"value":478}," — the value after ",{"type":49,"tag":67,"props":480,"children":482},{"className":481},[],[483],{"type":62,"value":484},"Cloud:",{"type":62,"value":486}," (e.g., ",{"type":49,"tag":67,"props":488,"children":490},{"className":489},[],[491],{"type":62,"value":492},"Public",{"type":62,"value":494},", ",{"type":49,"tag":67,"props":496,"children":498},{"className":497},[],[499],{"type":62,"value":500},"UsGov",{"type":62,"value":494},{"type":49,"tag":67,"props":503,"children":505},{"className":504},[],[506],{"type":62,"value":507},"UsGovHigh",{"type":62,"value":494},{"type":49,"tag":67,"props":510,"children":512},{"className":511},[],[513],{"type":62,"value":514},"UsGovDod",{"type":62,"value":494},{"type":49,"tag":67,"props":517,"children":519},{"className":518},[],[520],{"type":62,"value":521},"China",{"type":62,"value":523},")",{"type":49,"tag":525,"props":526,"children":527},"br",{},[],{"type":62,"value":529},"Proceed to Phase 3.",{"type":49,"tag":99,"props":531,"children":532},{},[533,538,539,547],{"type":49,"tag":58,"props":534,"children":535},{},[536],{"type":62,"value":537},"If not authenticated",{"type":62,"value":168},{"type":49,"tag":170,"props":540,"children":541},{},[542],{"type":49,"tag":99,"props":543,"children":544},{},[545],{"type":62,"value":546},"Inform the user they are not authenticated with PAC CLI.",{"type":49,"tag":170,"props":548,"children":550},{"start":549},2,[551,645,699,710,715],{"type":49,"tag":99,"props":552,"children":553},{},[554,556,562,564,627,630,632],{"type":62,"value":555},"Use ",{"type":49,"tag":67,"props":557,"children":559},{"className":558},[],[560],{"type":62,"value":561},"AskUserQuestion",{"type":62,"value":563}," to ask for the environment URL:",{"type":49,"tag":565,"props":566,"children":567},"table",{},[568,592],{"type":49,"tag":569,"props":570,"children":571},"thead",{},[572],{"type":49,"tag":573,"props":574,"children":575},"tr",{},[576,582,587],{"type":49,"tag":577,"props":578,"children":579},"th",{},[580],{"type":62,"value":581},"Question",{"type":49,"tag":577,"props":583,"children":584},{},[585],{"type":62,"value":586},"Header",{"type":49,"tag":577,"props":588,"children":589},{},[590],{"type":62,"value":591},"Options",{"type":49,"tag":593,"props":594,"children":595},"tbody",{},[596],{"type":49,"tag":573,"props":597,"children":598},{},[599,613,618],{"type":49,"tag":600,"props":601,"children":602},"td",{},[603,605,611],{"type":62,"value":604},"You are not authenticated with PAC CLI. Please provide your Power Pages environment URL (e.g., ",{"type":49,"tag":67,"props":606,"children":608},{"className":607},[],[609],{"type":62,"value":610},"https:\u002F\u002Forg12345.crm.dynamics.com",{"type":62,"value":612},") so I can authenticate you.",{"type":49,"tag":600,"props":614,"children":615},{},[616],{"type":62,"value":617},"Auth",{"type":49,"tag":600,"props":619,"children":620},{},[621],{"type":49,"tag":622,"props":623,"children":624},"em",{},[625],{"type":62,"value":626},"(free text input via \"Other\")",{"type":49,"tag":525,"props":628,"children":629},{},[],{"type":62,"value":631},"Provide two placeholder options to guide the user:",{"type":49,"tag":95,"props":633,"children":634},{},[635,640],{"type":49,"tag":99,"props":636,"children":637},{},[638],{"type":62,"value":639},"\"I'll paste the URL\" (description: \"Select 'Other' below and paste your environment URL\")",{"type":49,"tag":99,"props":641,"children":642},{},[643],{"type":62,"value":644},"\"I don't know my URL\" (description: \"You can find it in the Power Platform admin center under Environments > your environment > Environment URL\")",{"type":49,"tag":99,"props":646,"children":647},{},[648,650,694,697],{"type":62,"value":649},"Once the user provides the URL, run the authentication command:",{"type":49,"tag":201,"props":651,"children":653},{"className":203,"code":652,"language":205,"meta":206,"style":206},"pac auth create --environment \"\u003CUSER_PROVIDED_URL>\"\n",[654],{"type":49,"tag":67,"props":655,"children":656},{"__ignoreMap":206},[657],{"type":49,"tag":212,"props":658,"children":659},{"class":214,"line":215},[660,664,668,673,678,684,689],{"type":49,"tag":212,"props":661,"children":662},{"style":219},[663],{"type":62,"value":222},{"type":49,"tag":212,"props":665,"children":666},{"style":225},[667],{"type":62,"value":419},{"type":49,"tag":212,"props":669,"children":670},{"style":225},[671],{"type":62,"value":672}," create",{"type":49,"tag":212,"props":674,"children":675},{"style":225},[676],{"type":62,"value":677}," --environment",{"type":49,"tag":212,"props":679,"children":681},{"style":680},"--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF",[682],{"type":62,"value":683}," \"",{"type":49,"tag":212,"props":685,"children":686},{"style":225},[687],{"type":62,"value":688},"\u003CUSER_PROVIDED_URL>",{"type":49,"tag":212,"props":690,"children":691},{"style":680},[692],{"type":62,"value":693},"\"\n",{"type":49,"tag":525,"props":695,"children":696},{},[],{"type":62,"value":698},"This will open a browser window for the user to sign in.",{"type":49,"tag":99,"props":700,"children":701},{},[702,704,709],{"type":62,"value":703},"After the command completes, verify by running ",{"type":49,"tag":67,"props":705,"children":707},{"className":706},[],[708],{"type":62,"value":398},{"type":62,"value":344},{"type":49,"tag":99,"props":711,"children":712},{},[713],{"type":62,"value":714},"If authentication succeeds, proceed to Phase 3.",{"type":49,"tag":99,"props":716,"children":717},{},[718],{"type":62,"value":719},"If authentication fails, present the error to the user and help them troubleshoot.",{"type":49,"tag":54,"props":721,"children":722},{},[723,727],{"type":49,"tag":58,"props":724,"children":725},{},[726],{"type":62,"value":357},{"type":62,"value":728},": Authenticated PAC CLI session with environment name and URL extracted",{"type":49,"tag":140,"props":730,"children":731},{},[],{"type":49,"tag":88,"props":733,"children":735},{"id":734},"phase-3-confirm-environment",[736],{"type":62,"value":737},"Phase 3: Confirm Environment",{"type":49,"tag":54,"props":739,"children":740},{},[741,745],{"type":49,"tag":58,"props":742,"children":743},{},[744],{"type":62,"value":156},{"type":62,"value":746},": Ensure the user is deploying to the correct target environment",{"type":49,"tag":54,"props":748,"children":749},{},[750,754],{"type":49,"tag":58,"props":751,"children":752},{},[753],{"type":62,"value":166},{"type":62,"value":168},{"type":49,"tag":50,"props":756,"children":757},{},[758,770],{"type":49,"tag":54,"props":759,"children":760},{},[761,763,768],{"type":62,"value":762},"🚦 ",{"type":49,"tag":58,"props":764,"children":765},{},[766],{"type":62,"value":767},"Gate (consent · deploy-site:3.confirm-env):",{"type":62,"value":769}," Echo the current environment and require explicit confirmation before any upload. Covers the follow-up \"pick a different env\" sub-prompt in the same section — wrong-env deploys are the #1 destructive shared-state failure for this skill, so this gate must fire even when PAC CLI shows a recognizable env.",{"type":49,"tag":54,"props":771,"children":772},{},[773,778,780,785,787,792],{"type":49,"tag":58,"props":774,"children":775},{},[776],{"type":62,"value":777},"Trigger:",{"type":62,"value":779}," Phase 3 entry; environment resolved from PAC CLI.\n",{"type":49,"tag":58,"props":781,"children":782},{},[783],{"type":62,"value":784},"Why we ask:",{"type":62,"value":786}," Site uploaded to wrong tenant \u002F wrong env — committed to a Dataverse instance the user did not intend; cleanup requires manual deletion or another deploy from a different env.\n",{"type":49,"tag":58,"props":788,"children":789},{},[790],{"type":62,"value":791},"Cancel leaves:",{"type":62,"value":793}," Nothing — no upload fired.",{"type":49,"tag":170,"props":795,"children":796},{},[797,862,872],{"type":49,"tag":99,"props":798,"children":799},{},[800,802,805,806,811,813],{"type":62,"value":801},"Present the current environment information to the user and ask them to confirm.",{"type":49,"tag":525,"props":803,"children":804},{},[],{"type":62,"value":555},{"type":49,"tag":67,"props":807,"children":809},{"className":808},[],[810],{"type":62,"value":561},{"type":62,"value":812}," with the following structure:",{"type":49,"tag":565,"props":814,"children":815},{},[816,834],{"type":49,"tag":569,"props":817,"children":818},{},[819],{"type":49,"tag":573,"props":820,"children":821},{},[822,826,830],{"type":49,"tag":577,"props":823,"children":824},{},[825],{"type":62,"value":581},{"type":49,"tag":577,"props":827,"children":828},{},[829],{"type":62,"value":586},{"type":49,"tag":577,"props":831,"children":832},{},[833],{"type":62,"value":591},{"type":49,"tag":593,"props":835,"children":836},{},[837],{"type":49,"tag":573,"props":838,"children":839},{},[840,852,857],{"type":49,"tag":600,"props":841,"children":842},{},[843,845,850],{"type":62,"value":844},"You are currently connected to environment: ",{"type":49,"tag":58,"props":846,"children":847},{},[848],{"type":62,"value":849},"\u003CENV_NAME>",{"type":62,"value":851}," (\u003CENV_URL>). Do you want to deploy to this environment?",{"type":49,"tag":600,"props":853,"children":854},{},[855],{"type":62,"value":856},"Environment",{"type":49,"tag":600,"props":858,"children":859},{},[860],{"type":62,"value":861},"Yes, use this environment, No, let me choose a different one",{"type":49,"tag":99,"props":863,"children":864},{},[865,870],{"type":49,"tag":58,"props":866,"children":867},{},[868],{"type":62,"value":869},"If \"Yes, use this environment\"",{"type":62,"value":871},": Proceed to Phase 4.",{"type":49,"tag":99,"props":873,"children":874},{},[875,880,881],{"type":49,"tag":58,"props":876,"children":877},{},[878],{"type":62,"value":879},"If \"No, let me choose a different one\"",{"type":62,"value":168},{"type":49,"tag":170,"props":882,"children":883},{},[884,920,925,936,981],{"type":49,"tag":99,"props":885,"children":886},{},[887,888,894,896],{"type":62,"value":191},{"type":49,"tag":67,"props":889,"children":891},{"className":890},[],[892],{"type":62,"value":893},"pac org list",{"type":62,"value":895}," to retrieve all available environments:",{"type":49,"tag":201,"props":897,"children":899},{"className":203,"code":898,"language":205,"meta":206,"style":206},"pac org list\n",[900],{"type":49,"tag":67,"props":901,"children":902},{"__ignoreMap":206},[903],{"type":49,"tag":212,"props":904,"children":905},{"class":214,"line":215},[906,910,915],{"type":49,"tag":212,"props":907,"children":908},{"style":219},[909],{"type":62,"value":222},{"type":49,"tag":212,"props":911,"children":912},{"style":225},[913],{"type":62,"value":914}," org",{"type":49,"tag":212,"props":916,"children":917},{"style":225},[918],{"type":62,"value":919}," list\n",{"type":49,"tag":99,"props":921,"children":922},{},[923],{"type":62,"value":924},"Parse the output to extract environment names and URLs.",{"type":49,"tag":99,"props":926,"children":927},{},[928,929,934],{"type":62,"value":555},{"type":49,"tag":67,"props":930,"children":932},{"className":931},[],[933],{"type":62,"value":561},{"type":62,"value":935}," to present the available environments as options (pick up to 4 most relevant, or let user specify).",{"type":49,"tag":99,"props":937,"children":938},{},[939,941],{"type":62,"value":940},"Once the user selects an environment, switch to it:",{"type":49,"tag":201,"props":942,"children":944},{"className":203,"code":943,"language":205,"meta":206,"style":206},"pac org select --environment \"\u003CSELECTED_ENV_ID_OR_URL>\"\n",[945],{"type":49,"tag":67,"props":946,"children":947},{"__ignoreMap":206},[948],{"type":49,"tag":212,"props":949,"children":950},{"class":214,"line":215},[951,955,959,964,968,972,977],{"type":49,"tag":212,"props":952,"children":953},{"style":219},[954],{"type":62,"value":222},{"type":49,"tag":212,"props":956,"children":957},{"style":225},[958],{"type":62,"value":914},{"type":49,"tag":212,"props":960,"children":961},{"style":225},[962],{"type":62,"value":963}," select",{"type":49,"tag":212,"props":965,"children":966},{"style":225},[967],{"type":62,"value":677},{"type":49,"tag":212,"props":969,"children":970},{"style":680},[971],{"type":62,"value":683},{"type":49,"tag":212,"props":973,"children":974},{"style":225},[975],{"type":62,"value":976},"\u003CSELECTED_ENV_ID_OR_URL>",{"type":49,"tag":212,"props":978,"children":979},{"style":680},[980],{"type":62,"value":693},{"type":49,"tag":99,"props":982,"children":983},{},[984,986,991],{"type":62,"value":985},"Verify the switch by running ",{"type":49,"tag":67,"props":987,"children":989},{"className":988},[],[990],{"type":62,"value":398},{"type":62,"value":344},{"type":49,"tag":54,"props":993,"children":994},{},[995,999],{"type":49,"tag":58,"props":996,"children":997},{},[998],{"type":62,"value":357},{"type":62,"value":1000},": Confirmed target environment for deployment",{"type":49,"tag":140,"props":1002,"children":1003},{},[],{"type":49,"tag":88,"props":1005,"children":1007},{"id":1006},"phase-4-deploy-the-code-site",[1008],{"type":62,"value":1009},"Phase 4: Deploy the Code Site",{"type":49,"tag":54,"props":1011,"children":1012},{},[1013,1017],{"type":49,"tag":58,"props":1014,"children":1015},{},[1016],{"type":62,"value":156},{"type":62,"value":1018},": Locate the project, build it, and upload to Power Pages",{"type":49,"tag":54,"props":1020,"children":1021},{},[1022,1026],{"type":49,"tag":58,"props":1023,"children":1024},{},[1025],{"type":62,"value":166},{"type":62,"value":168},{"type":49,"tag":1028,"props":1029,"children":1031},"h3",{"id":1030},"_41-locate-the-project-root",[1032],{"type":62,"value":1033},"4.1 Locate the Project Root",{"type":49,"tag":54,"props":1035,"children":1036},{},[1037,1039,1045,1047,1053],{"type":62,"value":1038},"Determine the project root directory. The project root is the directory containing ",{"type":49,"tag":67,"props":1040,"children":1042},{"className":1041},[],[1043],{"type":62,"value":1044},"powerpages.config.json",{"type":62,"value":1046},". Use ",{"type":49,"tag":67,"props":1048,"children":1050},{"className":1049},[],[1051],{"type":62,"value":1052},"Glob",{"type":62,"value":1054}," to search for it:",{"type":49,"tag":201,"props":1056,"children":1060},{"className":1057,"code":1059,"language":62,"meta":206},[1058],"language-text","**\u002Fpowerpages.config.json\n",[1061],{"type":49,"tag":67,"props":1062,"children":1063},{"__ignoreMap":206},[1064],{"type":62,"value":1059},{"type":49,"tag":50,"props":1066,"children":1067},{},[1068,1086],{"type":49,"tag":54,"props":1069,"children":1070},{},[1071,1072,1077,1079,1084],{"type":62,"value":762},{"type":49,"tag":58,"props":1073,"children":1074},{},[1075],{"type":62,"value":1076},"Gate (plan · deploy-site:4.1.multi-project):",{"type":62,"value":1078}," More than one ",{"type":49,"tag":67,"props":1080,"children":1082},{"className":1081},[],[1083],{"type":62,"value":1044},{"type":62,"value":1085}," candidate found — pick the right project to deploy.",{"type":49,"tag":54,"props":1087,"children":1088},{},[1089,1093,1095,1099,1101,1105],{"type":49,"tag":58,"props":1090,"children":1091},{},[1092],{"type":62,"value":777},{"type":62,"value":1094}," Phase 4.1 glob returned multiple matches.\n",{"type":49,"tag":58,"props":1096,"children":1097},{},[1098],{"type":62,"value":784},{"type":62,"value":1100}," Wrong project uploaded — pollutes the target env with files from a different site.\n",{"type":49,"tag":58,"props":1102,"children":1103},{},[1104],{"type":62,"value":791},{"type":62,"value":793},{"type":49,"tag":54,"props":1107,"children":1108},{},[1109,1111,1117,1119,1124],{"type":62,"value":1110},"If found in the current working directory or a subdirectory, use that directory as ",{"type":49,"tag":67,"props":1112,"children":1114},{"className":1113},[],[1115],{"type":62,"value":1116},"PROJECT_ROOT",{"type":62,"value":1118},". If multiple are found, ask the user which one to deploy using ",{"type":49,"tag":67,"props":1120,"children":1122},{"className":1121},[],[1123],{"type":62,"value":561},{"type":62,"value":1125},".",{"type":49,"tag":54,"props":1127,"children":1128},{},[1129],{"type":62,"value":1130},"If not found, ask the user to provide the path to the project root.",{"type":49,"tag":1028,"props":1132,"children":1134},{"id":1133},"_42-offer-permissions-audit-redeployments-only",[1135],{"type":62,"value":1136},"4.2 Offer Permissions Audit (Redeployments Only)",{"type":49,"tag":54,"props":1138,"children":1139},{},[1140,1141,1147],{"type":62,"value":317},{"type":49,"tag":67,"props":1142,"children":1144},{"className":1143},[],[1145],{"type":62,"value":1146},".powerpages-site",{"type":62,"value":1148}," already exists (i.e., this is not the first deployment), table permissions and site settings may have drifted from the code since the last deployment. Offer to audit before deploying.",{"type":49,"tag":50,"props":1150,"children":1151},{},[1152,1171],{"type":49,"tag":54,"props":1153,"children":1154},{},[1155,1156,1161,1163,1169],{"type":62,"value":762},{"type":49,"tag":58,"props":1157,"children":1158},{},[1159],{"type":62,"value":1160},"Gate (plan · deploy-site:4.2.audit-permissions):",{"type":62,"value":1162}," Re-deployment detected — offer to run ",{"type":49,"tag":67,"props":1164,"children":1166},{"className":1165},[],[1167],{"type":62,"value":1168},"\u002Faudit-permissions",{"type":62,"value":1170}," to catch drift between code and table permissions before push.",{"type":49,"tag":54,"props":1172,"children":1173},{},[1174,1178,1180,1185,1187,1191,1193,1197],{"type":49,"tag":58,"props":1175,"children":1176},{},[1177],{"type":62,"value":777},{"type":62,"value":1179}," ",{"type":49,"tag":67,"props":1181,"children":1183},{"className":1182},[],[1184],{"type":62,"value":1146},{"type":62,"value":1186}," exists (not first deployment).\n",{"type":49,"tag":58,"props":1188,"children":1189},{},[1190],{"type":62,"value":784},{"type":62,"value":1192}," Stale permission YAML deploys, causing 403s for users until next audit run.\n",{"type":49,"tag":58,"props":1194,"children":1195},{},[1196],{"type":62,"value":791},{"type":62,"value":1198}," Nothing — audit is read-only; declining just proceeds to build + upload.",{"type":49,"tag":54,"props":1200,"children":1201},{},[1202,1203,1208],{"type":62,"value":555},{"type":49,"tag":67,"props":1204,"children":1206},{"className":1205},[],[1207],{"type":62,"value":561},{"type":62,"value":168},{"type":49,"tag":565,"props":1210,"children":1211},{},[1212,1230],{"type":49,"tag":569,"props":1213,"children":1214},{},[1215],{"type":49,"tag":573,"props":1216,"children":1217},{},[1218,1222,1226],{"type":49,"tag":577,"props":1219,"children":1220},{},[1221],{"type":62,"value":581},{"type":49,"tag":577,"props":1223,"children":1224},{},[1225],{"type":62,"value":586},{"type":49,"tag":577,"props":1227,"children":1228},{},[1229],{"type":62,"value":591},{"type":49,"tag":593,"props":1231,"children":1232},{},[1233],{"type":49,"tag":573,"props":1234,"children":1235},{},[1236,1241,1246],{"type":49,"tag":600,"props":1237,"children":1238},{},[1239],{"type":62,"value":1240},"This site has been deployed before. Would you like to run a permissions audit to verify table permissions match your current code before deploying?",{"type":49,"tag":600,"props":1242,"children":1243},{},[1244],{"type":62,"value":1245},"Audit",{"type":49,"tag":600,"props":1247,"children":1248},{},[1249],{"type":62,"value":1250},"Yes, audit permissions (Recommended), Skip — permissions are up to date",{"type":49,"tag":54,"props":1252,"children":1253},{},[1254,1259,1261,1266,1268,1273],{"type":49,"tag":58,"props":1255,"children":1256},{},[1257],{"type":62,"value":1258},"If \"Yes\"",{"type":62,"value":1260},": Invoke ",{"type":49,"tag":67,"props":1262,"children":1264},{"className":1263},[],[1265],{"type":62,"value":1168},{"type":62,"value":1267}," to run the audit. After the audit completes, resume with Step 4.3.\n",{"type":49,"tag":58,"props":1269,"children":1270},{},[1271],{"type":62,"value":1272},"If \"Skip\"",{"type":62,"value":1274},": Proceed to Step 4.3.",{"type":49,"tag":54,"props":1276,"children":1277},{},[1278,1279,1284,1286,1291],{"type":62,"value":317},{"type":49,"tag":67,"props":1280,"children":1282},{"className":1281},[],[1283],{"type":62,"value":1146},{"type":62,"value":1285}," does ",{"type":49,"tag":58,"props":1287,"children":1288},{},[1289],{"type":62,"value":1290},"not",{"type":62,"value":1292}," exist (first deployment), skip this step — there are no existing permissions to audit.",{"type":49,"tag":1028,"props":1294,"children":1296},{"id":1295},"_43-build-the-site",[1297],{"type":62,"value":1298},"4.3 Build the Site",{"type":49,"tag":54,"props":1300,"children":1301},{},[1302],{"type":62,"value":1303},"Before uploading, ensure the site is built:",{"type":49,"tag":201,"props":1305,"children":1307},{"className":203,"code":1306,"language":205,"meta":206,"style":206},"cd \"\u003CPROJECT_ROOT>\"\nnpm run build\n",[1308],{"type":49,"tag":67,"props":1309,"children":1310},{"__ignoreMap":206},[1311,1333],{"type":49,"tag":212,"props":1312,"children":1313},{"class":214,"line":215},[1314,1320,1324,1329],{"type":49,"tag":212,"props":1315,"children":1317},{"style":1316},"--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF",[1318],{"type":62,"value":1319},"cd",{"type":49,"tag":212,"props":1321,"children":1322},{"style":680},[1323],{"type":62,"value":683},{"type":49,"tag":212,"props":1325,"children":1326},{"style":225},[1327],{"type":62,"value":1328},"\u003CPROJECT_ROOT>",{"type":49,"tag":212,"props":1330,"children":1331},{"style":680},[1332],{"type":62,"value":693},{"type":49,"tag":212,"props":1334,"children":1335},{"class":214,"line":549},[1336,1341,1346],{"type":49,"tag":212,"props":1337,"children":1338},{"style":219},[1339],{"type":62,"value":1340},"npm",{"type":49,"tag":212,"props":1342,"children":1343},{"style":225},[1344],{"type":62,"value":1345}," run",{"type":49,"tag":212,"props":1347,"children":1348},{"style":225},[1349],{"type":62,"value":1350}," build\n",{"type":49,"tag":54,"props":1352,"children":1353},{},[1354],{"type":62,"value":1355},"If the build fails, stop and help the user fix the build errors before retrying.",{"type":49,"tag":1028,"props":1357,"children":1359},{"id":1358},"_44-upload-to-power-pages",[1360],{"type":62,"value":1361},"4.4 Upload to Power Pages",{"type":49,"tag":54,"props":1363,"children":1364},{},[1365],{"type":62,"value":1366},"Run the upload command:",{"type":49,"tag":201,"props":1368,"children":1370},{"className":203,"code":1369,"language":205,"meta":206,"style":206},"pac pages upload-code-site --rootPath \"\u003CPROJECT_ROOT>\"\n",[1371],{"type":49,"tag":67,"props":1372,"children":1373},{"__ignoreMap":206},[1374],{"type":49,"tag":212,"props":1375,"children":1376},{"class":214,"line":215},[1377,1381,1386,1391,1396,1400,1404],{"type":49,"tag":212,"props":1378,"children":1379},{"style":219},[1380],{"type":62,"value":222},{"type":49,"tag":212,"props":1382,"children":1383},{"style":225},[1384],{"type":62,"value":1385}," pages",{"type":49,"tag":212,"props":1387,"children":1388},{"style":225},[1389],{"type":62,"value":1390}," upload-code-site",{"type":49,"tag":212,"props":1392,"children":1393},{"style":225},[1394],{"type":62,"value":1395}," --rootPath",{"type":49,"tag":212,"props":1397,"children":1398},{"style":680},[1399],{"type":62,"value":683},{"type":49,"tag":212,"props":1401,"children":1402},{"style":225},[1403],{"type":62,"value":1328},{"type":49,"tag":212,"props":1405,"children":1406},{"style":680},[1407],{"type":62,"value":693},{"type":49,"tag":54,"props":1409,"children":1410},{},[1411,1416],{"type":49,"tag":58,"props":1412,"children":1413},{},[1414],{"type":62,"value":1415},"If the upload succeeds",{"type":62,"value":1417},": Proceed to Phase 5 to verify the deployment.",{"type":49,"tag":54,"props":1419,"children":1420},{},[1421,1426],{"type":49,"tag":58,"props":1422,"children":1423},{},[1424],{"type":62,"value":1425},"If the upload fails",{"type":62,"value":1427},": Check the error message:",{"type":49,"tag":95,"props":1429,"children":1430},{},[1431,1456,1489],{"type":49,"tag":99,"props":1432,"children":1433},{},[1434,1436,1441,1443,1449,1451],{"type":62,"value":1435},"If the failure is related to ",{"type":49,"tag":58,"props":1437,"children":1438},{},[1439],{"type":62,"value":1440},"blocked JavaScript",{"type":62,"value":1442}," (",{"type":49,"tag":67,"props":1444,"children":1446},{"className":1445},[],[1447],{"type":62,"value":1448},".js",{"type":62,"value":1450},") attachments → proceed to ",{"type":49,"tag":58,"props":1452,"children":1453},{},[1454],{"type":62,"value":1455},"Phase 6",{"type":49,"tag":99,"props":1457,"children":1458},{},[1459,1461,1472,1474,1479,1481,1487],{"type":62,"value":1460},"If the failure mentions ",{"type":49,"tag":58,"props":1462,"children":1463},{},[1464,1470],{"type":49,"tag":67,"props":1465,"children":1467},{"className":1466},[],[1468],{"type":62,"value":1469},".html",{"type":62,"value":1471}," type attachments are currently blocked",{"type":62,"value":1473}," → this is a ",{"type":49,"tag":58,"props":1475,"children":1476},{},[1477],{"type":62,"value":1478},"misleading error",{"type":62,"value":1480},". See ",{"type":49,"tag":179,"props":1482,"children":1484},{"href":1483},"#troubleshooting-html-blocked-attachment-error",[1485],{"type":62,"value":1486},"Troubleshooting: HTML Blocked Attachment Error",{"type":62,"value":1488}," below",{"type":49,"tag":99,"props":1490,"children":1491},{},[1492],{"type":62,"value":1493},"For other errors → present the error to the user and help them troubleshoot",{"type":49,"tag":54,"props":1495,"children":1496},{},[1497,1501],{"type":49,"tag":58,"props":1498,"children":1499},{},[1500],{"type":62,"value":357},{"type":62,"value":1502},": Site built and uploaded to Power Pages",{"type":49,"tag":140,"props":1504,"children":1505},{},[],{"type":49,"tag":88,"props":1507,"children":1509},{"id":1508},"phase-5-verify-deployment",[1510],{"type":62,"value":1511},"Phase 5: Verify Deployment",{"type":49,"tag":54,"props":1513,"children":1514},{},[1515,1519],{"type":49,"tag":58,"props":1516,"children":1517},{},[1518],{"type":62,"value":156},{"type":62,"value":1520},": Confirm the deployment was successful and handle post-deployment steps",{"type":49,"tag":54,"props":1522,"children":1523},{},[1524,1528],{"type":49,"tag":58,"props":1525,"children":1526},{},[1527],{"type":62,"value":166},{"type":62,"value":168},{"type":49,"tag":1028,"props":1530,"children":1532},{"id":1531},"_51-verify-powerpages-site-folder",[1533,1535,1540],{"type":62,"value":1534},"5.1 Verify ",{"type":49,"tag":67,"props":1536,"children":1538},{"className":1537},[],[1539],{"type":62,"value":1146},{"type":62,"value":1541}," Folder",{"type":49,"tag":54,"props":1543,"children":1544},{},[1545,1547,1552,1554,1560,1561,1567,1568,1574],{"type":62,"value":1546},"Confirm ",{"type":49,"tag":67,"props":1548,"children":1550},{"className":1549},[],[1551],{"type":62,"value":1146},{"type":62,"value":1553}," exists and list its contents (",{"type":49,"tag":67,"props":1555,"children":1557},{"className":1556},[],[1558],{"type":62,"value":1559},"web-roles\u002F",{"type":62,"value":494},{"type":49,"tag":67,"props":1562,"children":1564},{"className":1563},[],[1565],{"type":62,"value":1566},"site-settings\u002F",{"type":62,"value":494},{"type":49,"tag":67,"props":1569,"children":1571},{"className":1570},[],[1572],{"type":62,"value":1573},"table-permissions\u002F",{"type":62,"value":1575},").",{"type":49,"tag":1028,"props":1577,"children":1579},{"id":1578},"_52-record-skill-usage",[1580],{"type":62,"value":1581},"5.2 Record Skill Usage",{"type":49,"tag":50,"props":1583,"children":1584},{},[1585],{"type":49,"tag":54,"props":1586,"children":1587},{},[1588,1590],{"type":62,"value":1589},"Reference: ",{"type":49,"tag":67,"props":1591,"children":1593},{"className":1592},[],[1594],{"type":62,"value":1595},"${PLUGIN_ROOT}\u002Freferences\u002Fskill-tracking-reference.md",{"type":49,"tag":54,"props":1597,"children":1598},{},[1599,1601,1607],{"type":62,"value":1600},"Follow the skill tracking instructions in the reference to record this skill's usage. Use ",{"type":49,"tag":67,"props":1602,"children":1604},{"className":1603},[],[1605],{"type":62,"value":1606},"--skillName \"DeploySite\"",{"type":62,"value":1125},{"type":49,"tag":1028,"props":1609,"children":1611},{"id":1610},"_53-confirm-upload-output",[1612],{"type":62,"value":1613},"5.3 Confirm Upload Output",{"type":49,"tag":54,"props":1615,"children":1616},{},[1617,1619,1625],{"type":62,"value":1618},"Review the output from the ",{"type":49,"tag":67,"props":1620,"children":1622},{"className":1621},[],[1623],{"type":62,"value":1624},"pac pages upload-code-site",{"type":62,"value":1626}," command in Phase 4 (or Phase 6 retry). Verify it reported a successful upload with no errors.",{"type":49,"tag":1028,"props":1628,"children":1630},{"id":1629},"_54-commit-changes",[1631],{"type":62,"value":1632},"5.4 Commit Changes",{"type":49,"tag":54,"props":1634,"children":1635},{},[1636],{"type":62,"value":1637},"Stage and commit deployment artifacts:",{"type":49,"tag":201,"props":1639,"children":1641},{"className":203,"code":1640,"language":205,"meta":206,"style":206},"git add -A\ngit commit -m \"Deploy site to Power Pages\"\n",[1642],{"type":49,"tag":67,"props":1643,"children":1644},{"__ignoreMap":206},[1645,1663],{"type":49,"tag":212,"props":1646,"children":1647},{"class":214,"line":215},[1648,1653,1658],{"type":49,"tag":212,"props":1649,"children":1650},{"style":219},[1651],{"type":62,"value":1652},"git",{"type":49,"tag":212,"props":1654,"children":1655},{"style":225},[1656],{"type":62,"value":1657}," add",{"type":49,"tag":212,"props":1659,"children":1660},{"style":225},[1661],{"type":62,"value":1662}," -A\n",{"type":49,"tag":212,"props":1664,"children":1665},{"class":214,"line":549},[1666,1670,1675,1680,1684,1689],{"type":49,"tag":212,"props":1667,"children":1668},{"style":219},[1669],{"type":62,"value":1652},{"type":49,"tag":212,"props":1671,"children":1672},{"style":225},[1673],{"type":62,"value":1674}," commit",{"type":49,"tag":212,"props":1676,"children":1677},{"style":225},[1678],{"type":62,"value":1679}," -m",{"type":49,"tag":212,"props":1681,"children":1682},{"style":680},[1683],{"type":62,"value":683},{"type":49,"tag":212,"props":1685,"children":1686},{"style":225},[1687],{"type":62,"value":1688},"Deploy site to Power Pages",{"type":49,"tag":212,"props":1690,"children":1691},{"style":680},[1692],{"type":62,"value":693},{"type":49,"tag":1028,"props":1694,"children":1696},{"id":1695},"_55-check-activation-status",[1697],{"type":62,"value":1698},"5.5 Check Activation Status",{"type":49,"tag":54,"props":1700,"children":1701},{},[1702],{"type":62,"value":1703},"Run the activation status check:",{"type":49,"tag":201,"props":1705,"children":1707},{"className":203,"code":1706,"language":205,"meta":206,"style":206},"node \"${PLUGIN_ROOT}\u002Fscripts\u002Fcheck-activation-status.js\" --projectRoot \"\u003CPROJECT_ROOT>\"\n",[1708],{"type":49,"tag":67,"props":1709,"children":1710},{"__ignoreMap":206},[1711],{"type":49,"tag":212,"props":1712,"children":1713},{"class":214,"line":215},[1714,1719,1724,1730,1735,1740,1745,1750,1754,1758],{"type":49,"tag":212,"props":1715,"children":1716},{"style":219},[1717],{"type":62,"value":1718},"node",{"type":49,"tag":212,"props":1720,"children":1721},{"style":680},[1722],{"type":62,"value":1723}," \"${",{"type":49,"tag":212,"props":1725,"children":1727},{"style":1726},"--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8",[1728],{"type":62,"value":1729},"PLUGIN_ROOT",{"type":49,"tag":212,"props":1731,"children":1732},{"style":680},[1733],{"type":62,"value":1734},"}",{"type":49,"tag":212,"props":1736,"children":1737},{"style":225},[1738],{"type":62,"value":1739},"\u002Fscripts\u002Fcheck-activation-status.js",{"type":49,"tag":212,"props":1741,"children":1742},{"style":680},[1743],{"type":62,"value":1744},"\"",{"type":49,"tag":212,"props":1746,"children":1747},{"style":225},[1748],{"type":62,"value":1749}," --projectRoot",{"type":49,"tag":212,"props":1751,"children":1752},{"style":680},[1753],{"type":62,"value":683},{"type":49,"tag":212,"props":1755,"children":1756},{"style":225},[1757],{"type":62,"value":1328},{"type":49,"tag":212,"props":1759,"children":1760},{"style":680},[1761],{"type":62,"value":693},{"type":49,"tag":54,"props":1763,"children":1764},{},[1765],{"type":62,"value":1766},"Evaluate the JSON result:",{"type":49,"tag":95,"props":1768,"children":1769},{},[1770,1809,1830],{"type":49,"tag":99,"props":1771,"children":1772},{},[1773,1791,1793,1799,1801,1807],{"type":49,"tag":58,"props":1774,"children":1775},{},[1776,1777,1783,1785],{"type":62,"value":317},{"type":49,"tag":67,"props":1778,"children":1780},{"className":1779},[],[1781],{"type":62,"value":1782},"activated",{"type":62,"value":1784}," is ",{"type":49,"tag":67,"props":1786,"children":1788},{"className":1787},[],[1789],{"type":62,"value":1790},"true",{"type":62,"value":1792},": Inform the user their site is already activated (show ",{"type":49,"tag":67,"props":1794,"children":1796},{"className":1795},[],[1797],{"type":62,"value":1798},"websiteUrl",{"type":62,"value":1800}," if present). Proceed to step 5.6, then skip to ",{"type":49,"tag":179,"props":1802,"children":1804},{"href":1803},"#suggest-next-steps",[1805],{"type":62,"value":1806},"Suggest Next Steps",{"type":62,"value":1808},". Do NOT ask about activation.",{"type":49,"tag":99,"props":1810,"children":1811},{},[1812,1828],{"type":49,"tag":58,"props":1813,"children":1814},{},[1815,1816,1821,1822],{"type":62,"value":317},{"type":49,"tag":67,"props":1817,"children":1819},{"className":1818},[],[1820],{"type":62,"value":1782},{"type":62,"value":1784},{"type":49,"tag":67,"props":1823,"children":1825},{"className":1824},[],[1826],{"type":62,"value":1827},"false",{"type":62,"value":1829},": Proceed to step 5.5.1.",{"type":49,"tag":99,"props":1831,"children":1832},{},[1833,1845],{"type":49,"tag":58,"props":1834,"children":1835},{},[1836,1837,1843],{"type":62,"value":317},{"type":49,"tag":67,"props":1838,"children":1840},{"className":1839},[],[1841],{"type":62,"value":1842},"error",{"type":62,"value":1844}," is present",{"type":62,"value":1846},": Fall back to step 5.5.1. Do not block the deployment flow.",{"type":49,"tag":1848,"props":1849,"children":1851},"h4",{"id":1850},"_551-ask-about-activation-only-if-site-is-not-already-activated",[1852],{"type":62,"value":1853},"5.5.1 Ask About Activation (only if site is NOT already activated)",{"type":49,"tag":50,"props":1855,"children":1856},{},[1857,1876],{"type":49,"tag":54,"props":1858,"children":1859},{},[1860,1861,1866,1868,1874],{"type":62,"value":762},{"type":49,"tag":58,"props":1862,"children":1863},{},[1864],{"type":62,"value":1865},"Gate (plan · deploy-site:5.5.1.activate):",{"type":62,"value":1867}," Site deployed but not yet activated — offer to invoke ",{"type":49,"tag":67,"props":1869,"children":1871},{"className":1870},[],[1872],{"type":62,"value":1873},"\u002Factivate-site",{"type":62,"value":1875}," to provision the subdomain.",{"type":49,"tag":54,"props":1877,"children":1878},{},[1879,1883,1885,1891,1893,1897,1899,1903],{"type":49,"tag":58,"props":1880,"children":1881},{},[1882],{"type":62,"value":777},{"type":62,"value":1884}," Phase 5.5 detected ",{"type":49,"tag":67,"props":1886,"children":1888},{"className":1887},[],[1889],{"type":62,"value":1890},"activated:false",{"type":62,"value":1892}," on a fresh deploy.\n",{"type":49,"tag":58,"props":1894,"children":1895},{},[1896],{"type":62,"value":784},{"type":62,"value":1898}," Auto-activating writes the wrong subdomain (permanent for the site); auto-skipping leaves the site without a live URL.\n",{"type":49,"tag":58,"props":1900,"children":1901},{},[1902],{"type":62,"value":791},{"type":62,"value":1904}," Nothing — no activation API call fired.",{"type":49,"tag":54,"props":1906,"children":1907},{},[1908,1910,1915],{"type":62,"value":1909},"Ask the user if they want to activate the site using ",{"type":49,"tag":67,"props":1911,"children":1913},{"className":1912},[],[1914],{"type":62,"value":561},{"type":62,"value":168},{"type":49,"tag":565,"props":1917,"children":1918},{},[1919,1937],{"type":49,"tag":569,"props":1920,"children":1921},{},[1922],{"type":49,"tag":573,"props":1923,"children":1924},{},[1925,1929,1933],{"type":49,"tag":577,"props":1926,"children":1927},{},[1928],{"type":62,"value":581},{"type":49,"tag":577,"props":1930,"children":1931},{},[1932],{"type":62,"value":586},{"type":49,"tag":577,"props":1934,"children":1935},{},[1936],{"type":62,"value":591},{"type":49,"tag":593,"props":1938,"children":1939},{},[1940],{"type":49,"tag":573,"props":1941,"children":1942},{},[1943,1948,1953],{"type":49,"tag":600,"props":1944,"children":1945},{},[1946],{"type":62,"value":1947},"Site deployed successfully! Would you like to activate (provision) the site now so it gets a live URL?",{"type":49,"tag":600,"props":1949,"children":1950},{},[1951],{"type":62,"value":1952},"Activate",{"type":49,"tag":600,"props":1954,"children":1955},{},[1956],{"type":62,"value":1957},"Activate now (Recommended) — Provision the site with a subdomain and make it live, Skip for now — I'll activate later",{"type":49,"tag":54,"props":1959,"children":1960},{},[1961,1966,1968,1973,1975,1980,1982,1986],{"type":49,"tag":58,"props":1962,"children":1963},{},[1964],{"type":62,"value":1965},"If \"Activate now\"",{"type":62,"value":1967},": Invoke the ",{"type":49,"tag":67,"props":1969,"children":1971},{"className":1970},[],[1972],{"type":62,"value":1873},{"type":62,"value":1974}," skill. After activation completes, proceed to step 5.6 to clear the site cache.\n",{"type":49,"tag":58,"props":1976,"children":1977},{},[1978],{"type":62,"value":1979},"If \"Skip for now\"",{"type":62,"value":1981},": Suggest next steps (see ",{"type":49,"tag":179,"props":1983,"children":1984},{"href":1803},[1985],{"type":62,"value":1806},{"type":62,"value":1575},{"type":49,"tag":1028,"props":1988,"children":1990},{"id":1989},"_56-clear-site-cache-only-if-activated",[1991],{"type":62,"value":1992},"5.6 Clear Site Cache (Only If Activated)",{"type":49,"tag":54,"props":1994,"children":1995},{},[1996],{"type":62,"value":1997},"After confirming the site is activated (either it was already activated in step 5.5, or the user just activated it in step 5.5.1), offer to clear the runtime cache so the deployed changes are immediately visible.",{"type":49,"tag":54,"props":1999,"children":2000},{},[2001,2006],{"type":49,"tag":58,"props":2002,"children":2003},{},[2004],{"type":62,"value":2005},"Prerequisites",{"type":62,"value":2007},": The site must be activated and the project root must be known (from Phase 4.1).",{"type":49,"tag":50,"props":2009,"children":2010},{},[2011,2022],{"type":49,"tag":54,"props":2012,"children":2013},{},[2014,2015,2020],{"type":62,"value":762},{"type":49,"tag":58,"props":2016,"children":2017},{},[2018],{"type":62,"value":2019},"Gate (plan · deploy-site:5.6.restart-cache):",{"type":62,"value":2021}," Restart the deployed site to flush its runtime cache. Brief production downtime (a few seconds) — explicit user consent required even though the action is recoverable.",{"type":49,"tag":54,"props":2023,"children":2024},{},[2025,2029,2031,2035,2037,2041],{"type":49,"tag":58,"props":2026,"children":2027},{},[2028],{"type":62,"value":777},{"type":62,"value":2030}," Site confirmed activated (either pre-existing or just activated in 5.5.1).\n",{"type":49,"tag":58,"props":2032,"children":2033},{},[2034],{"type":62,"value":784},{"type":62,"value":2036}," Production users see stale content for several minutes until cache TTL expires.\n",{"type":49,"tag":58,"props":2038,"children":2039},{},[2040],{"type":62,"value":791},{"type":62,"value":2042}," Nothing — the deploy itself already succeeded; cache will refresh on its own.",{"type":49,"tag":54,"props":2044,"children":2045},{},[2046,2047,2052],{"type":62,"value":555},{"type":49,"tag":67,"props":2048,"children":2050},{"className":2049},[],[2051],{"type":62,"value":561},{"type":62,"value":2053}," to confirm before proceeding:",{"type":49,"tag":565,"props":2055,"children":2056},{},[2057,2075],{"type":49,"tag":569,"props":2058,"children":2059},{},[2060],{"type":49,"tag":573,"props":2061,"children":2062},{},[2063,2067,2071],{"type":49,"tag":577,"props":2064,"children":2065},{},[2066],{"type":62,"value":581},{"type":49,"tag":577,"props":2068,"children":2069},{},[2070],{"type":62,"value":586},{"type":49,"tag":577,"props":2072,"children":2073},{},[2074],{"type":62,"value":591},{"type":49,"tag":593,"props":2076,"children":2077},{},[2078],{"type":49,"tag":573,"props":2079,"children":2080},{},[2081,2086,2091],{"type":49,"tag":600,"props":2082,"children":2083},{},[2084],{"type":62,"value":2085},"Would you like to restart the site so your latest changes are immediately visible? This may cause a brief downtime (a few seconds).",{"type":49,"tag":600,"props":2087,"children":2088},{},[2089],{"type":62,"value":2090},"Restart",{"type":49,"tag":600,"props":2092,"children":2093},{},[2094],{"type":62,"value":2095},"Yes, restart site (Recommended), Skip — I'll restart later",{"type":49,"tag":54,"props":2097,"children":2098},{},[2099,2103,2105,2109],{"type":49,"tag":58,"props":2100,"children":2101},{},[2102],{"type":62,"value":1272},{"type":62,"value":2104},": Skip to ",{"type":49,"tag":179,"props":2106,"children":2107},{"href":1803},[2108],{"type":62,"value":1806},{"type":62,"value":1125},{"type":49,"tag":54,"props":2111,"children":2112},{},[2113,2117],{"type":49,"tag":58,"props":2114,"children":2115},{},[2116],{"type":62,"value":1258},{"type":62,"value":2118},": Run the cache-clearing script, passing the project root:",{"type":49,"tag":201,"props":2120,"children":2122},{"className":203,"code":2121,"language":205,"meta":206,"style":206},"node \"${PLUGIN_ROOT}\u002Fscripts\u002Fclear-site-cache.js\" --projectRoot \"\u003CPROJECT_ROOT>\"\n",[2123],{"type":49,"tag":67,"props":2124,"children":2125},{"__ignoreMap":206},[2126],{"type":49,"tag":212,"props":2127,"children":2128},{"class":214,"line":215},[2129,2133,2137,2141,2145,2150,2154,2158,2162,2166],{"type":49,"tag":212,"props":2130,"children":2131},{"style":219},[2132],{"type":62,"value":1718},{"type":49,"tag":212,"props":2134,"children":2135},{"style":680},[2136],{"type":62,"value":1723},{"type":49,"tag":212,"props":2138,"children":2139},{"style":1726},[2140],{"type":62,"value":1729},{"type":49,"tag":212,"props":2142,"children":2143},{"style":680},[2144],{"type":62,"value":1734},{"type":49,"tag":212,"props":2146,"children":2147},{"style":225},[2148],{"type":62,"value":2149},"\u002Fscripts\u002Fclear-site-cache.js",{"type":49,"tag":212,"props":2151,"children":2152},{"style":680},[2153],{"type":62,"value":1744},{"type":49,"tag":212,"props":2155,"children":2156},{"style":225},[2157],{"type":62,"value":1749},{"type":49,"tag":212,"props":2159,"children":2160},{"style":680},[2161],{"type":62,"value":683},{"type":49,"tag":212,"props":2163,"children":2164},{"style":225},[2165],{"type":62,"value":1328},{"type":49,"tag":212,"props":2167,"children":2168},{"style":680},[2169],{"type":62,"value":693},{"type":49,"tag":54,"props":2171,"children":2172},{},[2173,2175,2181,2183,2188],{"type":62,"value":2174},"The script reads ",{"type":49,"tag":67,"props":2176,"children":2178},{"className":2177},[],[2179],{"type":62,"value":2180},"siteName",{"type":62,"value":2182}," from ",{"type":49,"tag":67,"props":2184,"children":2186},{"className":2185},[],[2187],{"type":62,"value":1044},{"type":62,"value":2189},", looks up the website via the Power Platform API, and restarts it to flush the runtime cache.",{"type":49,"tag":54,"props":2191,"children":2192},{},[2193],{"type":62,"value":2194},"Evaluate the result:",{"type":49,"tag":95,"props":2196,"children":2197},{},[2198,2228],{"type":49,"tag":99,"props":2199,"children":2200},{},[2201,2217,2219,2226],{"type":49,"tag":58,"props":2202,"children":2203},{},[2204,2205,2211,2212],{"type":62,"value":317},{"type":49,"tag":67,"props":2206,"children":2208},{"className":2207},[],[2209],{"type":62,"value":2210},"success",{"type":62,"value":1784},{"type":49,"tag":67,"props":2213,"children":2215},{"className":2214},[],[2216],{"type":62,"value":1790},{"type":62,"value":2218},": Inform the user: \"Site cache cleared — your latest changes should now be visible at ",{"type":49,"tag":58,"props":2220,"children":2221},{},[2222],{"type":49,"tag":2223,"props":2224,"children":2225},"website-url",{},[],{"type":62,"value":2227},".\"",{"type":49,"tag":99,"props":2229,"children":2230},{},[2231,2246],{"type":49,"tag":58,"props":2232,"children":2233},{},[2234,2235,2240,2241],{"type":62,"value":317},{"type":49,"tag":67,"props":2236,"children":2238},{"className":2237},[],[2239],{"type":62,"value":2210},{"type":62,"value":1784},{"type":49,"tag":67,"props":2242,"children":2244},{"className":2243},[],[2245],{"type":62,"value":1827},{"type":62,"value":2247},": Warn the user that cache clearing failed and show the error, but do not block the deployment flow. The deployment itself succeeded; cache will eventually refresh on its own. Suggest the user can manually clear cache from the Power Pages admin center if needed.",{"type":49,"tag":54,"props":2249,"children":2250},{},[2251,2255],{"type":49,"tag":58,"props":2252,"children":2253},{},[2254],{"type":62,"value":357},{"type":62,"value":2256},": Deployment verified, changes committed, activation offered, cache cleared",{"type":49,"tag":140,"props":2258,"children":2259},{},[],{"type":49,"tag":88,"props":2261,"children":2263},{"id":2262},"phase-6-handle-blocked-javascript",[2264],{"type":62,"value":2265},"Phase 6: Handle Blocked JavaScript",{"type":49,"tag":54,"props":2267,"children":2268},{},[2269,2273],{"type":49,"tag":58,"props":2270,"children":2271},{},[2272],{"type":62,"value":156},{"type":62,"value":2274},": Resolve blocked JavaScript attachment errors and retry deployment",{"type":49,"tag":54,"props":2276,"children":2277},{},[2278,2282],{"type":49,"tag":58,"props":2279,"children":2280},{},[2281],{"type":62,"value":166},{"type":62,"value":168},{"type":49,"tag":1028,"props":2284,"children":2286},{"id":2285},"_61-explain-the-issue",[2287],{"type":62,"value":2288},"6.1 Explain the Issue",{"type":49,"tag":54,"props":2290,"children":2291},{},[2292],{"type":62,"value":2293},"Tell the user:",{"type":49,"tag":50,"props":2295,"children":2296},{},[2297],{"type":49,"tag":54,"props":2298,"children":2299},{},[2300],{"type":62,"value":2301},"\"The upload failed because JavaScript (.js) file attachments are blocked in your Power Pages environment. This is a security setting that prevents uploading .js files. To deploy a code site, this restriction needs to be relaxed for .js files.\"",{"type":49,"tag":1028,"props":2303,"children":2305},{"id":2304},"_62-ask-for-permission",[2306],{"type":62,"value":2307},"6.2 Ask for Permission",{"type":49,"tag":50,"props":2309,"children":2310},{},[2311,2337],{"type":49,"tag":54,"props":2312,"children":2313},{},[2314,2315,2320,2322,2328,2330,2336],{"type":62,"value":762},{"type":49,"tag":58,"props":2316,"children":2317},{},[2318],{"type":62,"value":2319},"Gate (consent · deploy-site:6.2.unblock-js):",{"type":62,"value":2321}," Reactive ",{"type":49,"tag":67,"props":2323,"children":2325},{"className":2324},[],[2326],{"type":62,"value":2327},"blockedattachments",{"type":62,"value":2329}," modification — destructive shared-state change (tenant-wide env setting). Same shape as ",{"type":49,"tag":67,"props":2331,"children":2333},{"className":2332},[],[2334],{"type":62,"value":2335},"deploy-pipeline:7.6.2.blocked-attachments",{"type":62,"value":1125},{"type":49,"tag":54,"props":2338,"children":2339},{},[2340,2344,2346,2351,2353,2357,2359,2363,2364,2370],{"type":49,"tag":58,"props":2341,"children":2342},{},[2343],{"type":62,"value":777},{"type":62,"value":2345}," Upload failed with the blocked-",{"type":49,"tag":67,"props":2347,"children":2349},{"className":2348},[],[2350],{"type":62,"value":1448},{"type":62,"value":2352}," error.\n",{"type":49,"tag":58,"props":2354,"children":2355},{},[2356],{"type":62,"value":784},{"type":62,"value":2358}," Auto-unblocking modifies a tenant security setting without explicit consent — visible across the entire environment, not just this site.\n",{"type":49,"tag":58,"props":2360,"children":2361},{},[2362],{"type":62,"value":791},{"type":62,"value":1179},{"type":49,"tag":67,"props":2365,"children":2367},{"className":2366},[],[2368],{"type":62,"value":2369},"attachment-block-modified",{"type":62,"value":2371}," is only possible if the user approved and then a downstream step partial-completed. Pure Cancel here leaves nothing — the original blockedattachments value is untouched.",{"type":49,"tag":54,"props":2373,"children":2374},{},[2375,2376,2381],{"type":62,"value":555},{"type":49,"tag":67,"props":2377,"children":2379},{"className":2378},[],[2380],{"type":62,"value":561},{"type":62,"value":168},{"type":49,"tag":565,"props":2383,"children":2384},{},[2385,2403],{"type":49,"tag":569,"props":2386,"children":2387},{},[2388],{"type":49,"tag":573,"props":2389,"children":2390},{},[2391,2395,2399],{"type":49,"tag":577,"props":2392,"children":2393},{},[2394],{"type":62,"value":581},{"type":49,"tag":577,"props":2396,"children":2397},{},[2398],{"type":62,"value":586},{"type":49,"tag":577,"props":2400,"children":2401},{},[2402],{"type":62,"value":591},{"type":49,"tag":593,"props":2404,"children":2405},{},[2406],{"type":49,"tag":573,"props":2407,"children":2408},{},[2409,2414,2419],{"type":49,"tag":600,"props":2410,"children":2411},{},[2412],{"type":62,"value":2413},"Would you like to remove the JavaScript (.js) block from the environment's blocked attachments list? This is required to deploy code sites.",{"type":49,"tag":600,"props":2415,"children":2416},{},[2417],{"type":62,"value":2418},"Unblock JS",{"type":49,"tag":600,"props":2420,"children":2421},{},[2422],{"type":62,"value":2423},"Yes, remove the .js block (Recommended), No, do not change environment settings",{"type":49,"tag":54,"props":2425,"children":2426},{},[2427,2432,2434,2439],{"type":49,"tag":58,"props":2428,"children":2429},{},[2430],{"type":62,"value":2431},"If \"No\"",{"type":62,"value":2433},": Stop and inform the user that the deployment cannot proceed without unblocking ",{"type":49,"tag":67,"props":2435,"children":2437},{"className":2436},[],[2438],{"type":62,"value":1448},{"type":62,"value":2440}," attachments.",{"type":49,"tag":54,"props":2442,"children":2443},{},[2444,2448],{"type":49,"tag":58,"props":2445,"children":2446},{},[2447],{"type":62,"value":1258},{"type":62,"value":2449},": Proceed to 6.3.",{"type":49,"tag":1028,"props":2451,"children":2453},{"id":2452},"_63-update-blocked-attachments",[2454],{"type":62,"value":2455},"6.3 Update Blocked Attachments",{"type":49,"tag":170,"props":2457,"children":2458},{},[2459,2495,2514,2534,2590],{"type":49,"tag":99,"props":2460,"children":2461},{},[2462,2463,2469,2471],{"type":62,"value":191},{"type":49,"tag":67,"props":2464,"children":2466},{"className":2465},[],[2467],{"type":62,"value":2468},"pac env list-settings",{"type":62,"value":2470}," to retrieve the current environment settings:",{"type":49,"tag":201,"props":2472,"children":2474},{"className":203,"code":2473,"language":205,"meta":206,"style":206},"pac env list-settings\n",[2475],{"type":49,"tag":67,"props":2476,"children":2477},{"__ignoreMap":206},[2478],{"type":49,"tag":212,"props":2479,"children":2480},{"class":214,"line":215},[2481,2485,2490],{"type":49,"tag":212,"props":2482,"children":2483},{"style":219},[2484],{"type":62,"value":222},{"type":49,"tag":212,"props":2486,"children":2487},{"style":225},[2488],{"type":62,"value":2489}," env",{"type":49,"tag":212,"props":2491,"children":2492},{"style":225},[2493],{"type":62,"value":2494}," list-settings\n",{"type":49,"tag":99,"props":2496,"children":2497},{},[2498,2500,2505,2507,2513],{"type":62,"value":2499},"Find the ",{"type":49,"tag":67,"props":2501,"children":2503},{"className":2502},[],[2504],{"type":62,"value":2327},{"type":62,"value":2506}," property in the output. It will contain a semicolon-separated list of file extensions (e.g., ",{"type":49,"tag":67,"props":2508,"children":2510},{"className":2509},[],[2511],{"type":62,"value":2512},"ade;adp;app;asa;ashx;asmx;asp;bas;bat;cdx;cer;chm;class;cmd;com;config;cnt;cpl;crt;csh;der;dll;exe;fxp;hlp;hta;htr;htw;ida;idc;idq;inf;ins;isp;its;js;jse;ksh;lnk;mad;maf;mag;mam;maq;mar;mas;mat;mau;mav;maw;mda;mdb;mde;mdt;mdw;mdz;msc;msh;msh1;msh1xml;msh2;msh2xml;mshxml;msi;msp;mst;ops;pcd;pif;prf;prg;printer;pst;reg;rem;scf;scr;sct;shb;shs;shtm;shtml;soap;stm;tmp;url;vb;vbe;vbs;vsmacros;vss;vst;vsw;ws;wsc;wsf;wsh",{"type":62,"value":1575},{"type":49,"tag":99,"props":2515,"children":2516},{},[2517,2519,2525,2527,2532],{"type":62,"value":2518},"Remove ",{"type":49,"tag":67,"props":2520,"children":2522},{"className":2521},[],[2523],{"type":62,"value":2524},"js",{"type":62,"value":2526}," from the list. Parse the semicolon-separated values, filter out ",{"type":49,"tag":67,"props":2528,"children":2530},{"className":2529},[],[2531],{"type":62,"value":2524},{"type":62,"value":2533},", and rejoin with semicolons.",{"type":49,"tag":99,"props":2535,"children":2536},{},[2537,2539],{"type":62,"value":2538},"Update the setting:",{"type":49,"tag":201,"props":2540,"children":2542},{"className":203,"code":2541,"language":205,"meta":206,"style":206},"pac env update-settings --name blockedattachments --value \"\u003CUPDATED_LIST_WITHOUT_JS>\"\n",[2543],{"type":49,"tag":67,"props":2544,"children":2545},{"__ignoreMap":206},[2546],{"type":49,"tag":212,"props":2547,"children":2548},{"class":214,"line":215},[2549,2553,2557,2562,2567,2572,2577,2581,2586],{"type":49,"tag":212,"props":2550,"children":2551},{"style":219},[2552],{"type":62,"value":222},{"type":49,"tag":212,"props":2554,"children":2555},{"style":225},[2556],{"type":62,"value":2489},{"type":49,"tag":212,"props":2558,"children":2559},{"style":225},[2560],{"type":62,"value":2561}," update-settings",{"type":49,"tag":212,"props":2563,"children":2564},{"style":225},[2565],{"type":62,"value":2566}," --name",{"type":49,"tag":212,"props":2568,"children":2569},{"style":225},[2570],{"type":62,"value":2571}," blockedattachments",{"type":49,"tag":212,"props":2573,"children":2574},{"style":225},[2575],{"type":62,"value":2576}," --value",{"type":49,"tag":212,"props":2578,"children":2579},{"style":680},[2580],{"type":62,"value":683},{"type":49,"tag":212,"props":2582,"children":2583},{"style":225},[2584],{"type":62,"value":2585},"\u003CUPDATED_LIST_WITHOUT_JS>",{"type":49,"tag":212,"props":2587,"children":2588},{"style":680},[2589],{"type":62,"value":693},{"type":49,"tag":99,"props":2591,"children":2592},{},[2593],{"type":62,"value":2594},"Confirm the update was successful.",{"type":49,"tag":1028,"props":2596,"children":2598},{"id":2597},"_64-retry-upload",[2599],{"type":62,"value":2600},"6.4 Retry Upload",{"type":49,"tag":54,"props":2602,"children":2603},{},[2604],{"type":62,"value":2605},"Run the upload command again:",{"type":49,"tag":201,"props":2607,"children":2608},{"className":203,"code":1369,"language":205,"meta":206,"style":206},[2609],{"type":49,"tag":67,"props":2610,"children":2611},{"__ignoreMap":206},[2612],{"type":49,"tag":212,"props":2613,"children":2614},{"class":214,"line":215},[2615,2619,2623,2627,2631,2635,2639],{"type":49,"tag":212,"props":2616,"children":2617},{"style":219},[2618],{"type":62,"value":222},{"type":49,"tag":212,"props":2620,"children":2621},{"style":225},[2622],{"type":62,"value":1385},{"type":49,"tag":212,"props":2624,"children":2625},{"style":225},[2626],{"type":62,"value":1390},{"type":49,"tag":212,"props":2628,"children":2629},{"style":225},[2630],{"type":62,"value":1395},{"type":49,"tag":212,"props":2632,"children":2633},{"style":680},[2634],{"type":62,"value":683},{"type":49,"tag":212,"props":2636,"children":2637},{"style":225},[2638],{"type":62,"value":1328},{"type":49,"tag":212,"props":2640,"children":2641},{"style":680},[2642],{"type":62,"value":693},{"type":49,"tag":54,"props":2644,"children":2645},{},[2646],{"type":62,"value":2647},"If it succeeds: Proceed to Phase 5 to verify the deployment.",{"type":49,"tag":54,"props":2649,"children":2650},{},[2651],{"type":62,"value":2652},"If it fails again with a different error, present the error to the user and help troubleshoot.",{"type":49,"tag":54,"props":2654,"children":2655},{},[2656,2660],{"type":49,"tag":58,"props":2657,"children":2658},{},[2659],{"type":62,"value":357},{"type":62,"value":2661},": JavaScript unblocked and site deployed successfully",{"type":49,"tag":140,"props":2663,"children":2664},{},[],{"type":49,"tag":88,"props":2666,"children":2668},{"id":2667},"troubleshooting-html-blocked-attachment-error",[2669],{"type":62,"value":1486},{"type":49,"tag":54,"props":2671,"children":2672},{},[2673],{"type":62,"value":2674},"If the upload fails with an error like:",{"type":49,"tag":201,"props":2676,"children":2679},{"className":2677,"code":2678,"language":62},[1058],"Error: Unable to upload webfile name 'index.html' with record Id \u003CGUID> as '.html' type attachments are currently blocked on this environment.\n",[2680],{"type":49,"tag":67,"props":2681,"children":2682},{"__ignoreMap":206},[2683],{"type":62,"value":2678},{"type":49,"tag":54,"props":2685,"children":2686},{},[2687,2692,2694,2699,2701,2706],{"type":49,"tag":58,"props":2688,"children":2689},{},[2690],{"type":62,"value":2691},"This error is misleading.",{"type":62,"value":2693}," The ",{"type":49,"tag":67,"props":2695,"children":2697},{"className":2696},[],[2698],{"type":62,"value":1469},{"type":62,"value":2700}," extension is not actually blocked — the real cause is a stale environment manifest file in the ",{"type":49,"tag":67,"props":2702,"children":2704},{"className":2703},[],[2705],{"type":62,"value":1146},{"type":62,"value":2707}," folder. This manifest maps local files to Dataverse record IDs from a previous upload. When the mapping becomes outdated (e.g., after environment changes or record deletions), the upload fails with this confusing error.",{"type":49,"tag":1028,"props":2709,"children":2711},{"id":2710},"fix",[2712],{"type":62,"value":2713},"Fix",{"type":49,"tag":170,"props":2715,"children":2716},{},[2717,2759,2771],{"type":49,"tag":99,"props":2718,"children":2719},{},[2720,2722,2727,2729,2735,2736,2742,2744,2749,2751,2757],{"type":62,"value":2721},"Locate the environment-specific manifest file in the ",{"type":49,"tag":67,"props":2723,"children":2725},{"className":2724},[],[2726],{"type":62,"value":1146},{"type":62,"value":2728}," folder. It follows the naming pattern ",{"type":49,"tag":67,"props":2730,"children":2732},{"className":2731},[],[2733],{"type":62,"value":2734},"\u003Cenvironment-host>-manifest.yml",{"type":62,"value":486},{"type":49,"tag":67,"props":2737,"children":2739},{"className":2738},[],[2740],{"type":62,"value":2741},"demo1.crm.dynamics.com-manifest.yml",{"type":62,"value":2743},"). Use your file-search tool (e.g., ",{"type":49,"tag":67,"props":2745,"children":2747},{"className":2746},[],[2748],{"type":62,"value":1052},{"type":62,"value":2750}," with pattern ",{"type":49,"tag":67,"props":2752,"children":2754},{"className":2753},[],[2755],{"type":62,"value":2756},"\u003CPROJECT_ROOT>\u002F.powerpages-site\u002F*-manifest.yml",{"type":62,"value":2758},") to find it.",{"type":49,"tag":99,"props":2760,"children":2761},{},[2762,2764,2770],{"type":62,"value":2763},"Delete the manifest file at ",{"type":49,"tag":67,"props":2765,"children":2767},{"className":2766},[],[2768],{"type":62,"value":2769},"\u003CPROJECT_ROOT>\u002F.powerpages-site\u002F\u003Cenvironment-host>-manifest.yml",{"type":62,"value":1125},{"type":49,"tag":99,"props":2772,"children":2773},{},[2774,2776],{"type":62,"value":2775},"Retry the upload:",{"type":49,"tag":201,"props":2777,"children":2778},{"className":203,"code":1369,"language":205,"meta":206,"style":206},[2779],{"type":49,"tag":67,"props":2780,"children":2781},{"__ignoreMap":206},[2782],{"type":49,"tag":212,"props":2783,"children":2784},{"class":214,"line":215},[2785,2789,2793,2797,2801,2805,2809],{"type":49,"tag":212,"props":2786,"children":2787},{"style":219},[2788],{"type":62,"value":222},{"type":49,"tag":212,"props":2790,"children":2791},{"style":225},[2792],{"type":62,"value":1385},{"type":49,"tag":212,"props":2794,"children":2795},{"style":225},[2796],{"type":62,"value":1390},{"type":49,"tag":212,"props":2798,"children":2799},{"style":225},[2800],{"type":62,"value":1395},{"type":49,"tag":212,"props":2802,"children":2803},{"style":680},[2804],{"type":62,"value":683},{"type":49,"tag":212,"props":2806,"children":2807},{"style":225},[2808],{"type":62,"value":1328},{"type":49,"tag":212,"props":2810,"children":2811},{"style":680},[2812],{"type":62,"value":693},{"type":49,"tag":54,"props":2814,"children":2815},{},[2816],{"type":62,"value":2817},"If the retry succeeds, proceed to Phase 5. If it fails with a different error, present the error to the user and help them troubleshoot.",{"type":49,"tag":50,"props":2819,"children":2820},{},[2821],{"type":49,"tag":54,"props":2822,"children":2823},{},[2824,2829,2831,2836],{"type":49,"tag":58,"props":2825,"children":2826},{},[2827],{"type":62,"value":2828},"Important",{"type":62,"value":2830},": Do NOT attempt to unblock ",{"type":49,"tag":67,"props":2832,"children":2834},{"className":2833},[],[2835],{"type":62,"value":1469},{"type":62,"value":2837}," in the environment's blocked attachments list — the error is not caused by the attachment block setting.",{"type":49,"tag":140,"props":2839,"children":2840},{},[],{"type":49,"tag":88,"props":2842,"children":2844},{"id":2843},"suggest-next-steps",[2845],{"type":62,"value":1806},{"type":49,"tag":54,"props":2847,"children":2848},{},[2849],{"type":62,"value":2850},"If the user skips activation (or after activation completes), suggest:",{"type":49,"tag":95,"props":2852,"children":2853},{},[2854,2864,2875,2885,2896],{"type":49,"tag":99,"props":2855,"children":2856},{},[2857,2862],{"type":49,"tag":67,"props":2858,"children":2860},{"className":2859},[],[2861],{"type":62,"value":1873},{"type":62,"value":2863}," — Provision the site with a subdomain and make it live (if not already activated)",{"type":49,"tag":99,"props":2865,"children":2866},{},[2867,2873],{"type":49,"tag":67,"props":2868,"children":2870},{"className":2869},[],[2871],{"type":62,"value":2872},"\u002Ftest-site",{"type":62,"value":2874}," — Test the deployed site in the browser (verify pages load, check API calls)",{"type":49,"tag":99,"props":2876,"children":2877},{},[2878,2883],{"type":49,"tag":67,"props":2879,"children":2881},{"className":2880},[],[2882],{"type":62,"value":1168},{"type":62,"value":2884}," — Audit table permissions against current code (recommended after redeployments)",{"type":49,"tag":99,"props":2886,"children":2887},{},[2888,2894],{"type":49,"tag":67,"props":2889,"children":2891},{"className":2890},[],[2892],{"type":62,"value":2893},"\u002Fsetup-datamodel",{"type":62,"value":2895}," — Create Dataverse tables for dynamic content",{"type":49,"tag":99,"props":2897,"children":2898},{},[2899,2905],{"type":49,"tag":67,"props":2900,"children":2902},{"className":2901},[],[2903],{"type":62,"value":2904},"\u002Fadd-seo",{"type":62,"value":2906}," — Add meta tags, robots.txt, sitemap.xml, favicon",{"type":49,"tag":140,"props":2908,"children":2909},{},[],{"type":49,"tag":88,"props":2911,"children":2913},{"id":2912},"important-notes",[2914],{"type":62,"value":2915},"Important Notes",{"type":49,"tag":1028,"props":2917,"children":2919},{"id":2918},"never-use-pac-pages-upload",[2920,2922],{"type":62,"value":2921},"NEVER Use ",{"type":49,"tag":67,"props":2923,"children":2925},{"className":2924},[],[2926],{"type":62,"value":2927},"pac pages upload",{"type":49,"tag":54,"props":2929,"children":2930},{},[2931,2933,2938,2940,2945,2947,2952,2954,2959],{"type":62,"value":2932},"Always use ",{"type":49,"tag":67,"props":2934,"children":2936},{"className":2935},[],[2937],{"type":62,"value":1624},{"type":62,"value":2939}," — ",{"type":49,"tag":58,"props":2941,"children":2942},{},[2943],{"type":62,"value":2944},"never",{"type":62,"value":2946}," use ",{"type":49,"tag":67,"props":2948,"children":2950},{"className":2949},[],[2951],{"type":62,"value":2927},{"type":62,"value":2953},". The ",{"type":49,"tag":67,"props":2955,"children":2957},{"className":2956},[],[2958],{"type":62,"value":2927},{"type":62,"value":2960}," command is designed for portal-studio-style sites and will corrupt code site metadata if used on a code site project. This applies to every upload step in this skill (Phase 4.4, Phase 6.4, and troubleshooting retries).",{"type":49,"tag":1028,"props":2962,"children":2964},{"id":2963},"throughout-all-phases",[2965],{"type":62,"value":2966},"Throughout All Phases",{"type":49,"tag":95,"props":2968,"children":2969},{},[2970,2979,2989],{"type":49,"tag":99,"props":2971,"children":2972},{},[2973,2977],{"type":49,"tag":58,"props":2974,"children":2975},{},[2976],{"type":62,"value":116},{"type":62,"value":2978}," to track progress at every phase",{"type":49,"tag":99,"props":2980,"children":2981},{},[2982,2987],{"type":49,"tag":58,"props":2983,"children":2984},{},[2985],{"type":62,"value":2986},"Ask for user confirmation",{"type":62,"value":2988}," at key decision points (see list below)",{"type":49,"tag":99,"props":2990,"children":2991},{},[2992,2997],{"type":49,"tag":58,"props":2993,"children":2994},{},[2995],{"type":62,"value":2996},"Present errors clearly",{"type":62,"value":2998}," — when a command fails, show the user the relevant error output and explain what went wrong before suggesting fixes",{"type":49,"tag":1028,"props":3000,"children":3002},{"id":3001},"key-decision-points-wait-for-user",[3003],{"type":62,"value":3004},"Key Decision Points (Wait for User)",{"type":49,"tag":170,"props":3006,"children":3007},{},[3008,3013,3018,3030,3035,3040],{"type":49,"tag":99,"props":3009,"children":3010},{},[3011],{"type":62,"value":3012},"After Phase 2: If not authenticated, get environment URL from user",{"type":49,"tag":99,"props":3014,"children":3015},{},[3016],{"type":62,"value":3017},"At Phase 3: Confirm or switch the target environment",{"type":49,"tag":99,"props":3019,"children":3020},{},[3021,3023,3028],{"type":62,"value":3022},"At Phase 4.1: If multiple ",{"type":49,"tag":67,"props":3024,"children":3026},{"className":3025},[],[3027],{"type":62,"value":1044},{"type":62,"value":3029}," found, ask which project to deploy",{"type":49,"tag":99,"props":3031,"children":3032},{},[3033],{"type":62,"value":3034},"At Phase 4.2: Audit permissions now or skip (redeployments only)",{"type":49,"tag":99,"props":3036,"children":3037},{},[3038],{"type":62,"value":3039},"At Phase 5.5: Activate site now or later",{"type":49,"tag":99,"props":3041,"children":3042},{},[3043],{"type":62,"value":3044},"At Phase 6: Get permission before modifying blocked attachments setting",{"type":49,"tag":1028,"props":3046,"children":3048},{"id":3047},"progress-tracking",[3049],{"type":62,"value":184},{"type":49,"tag":54,"props":3051,"children":3052},{},[3053,3055,3061],{"type":62,"value":3054},"Before starting Phase 1, create a task list with all phases using ",{"type":49,"tag":67,"props":3056,"children":3058},{"className":3057},[],[3059],{"type":62,"value":3060},"TaskCreate",{"type":62,"value":168},{"type":49,"tag":565,"props":3063,"children":3064},{},[3065,3086],{"type":49,"tag":569,"props":3066,"children":3067},{},[3068],{"type":49,"tag":573,"props":3069,"children":3070},{},[3071,3076,3081],{"type":49,"tag":577,"props":3072,"children":3073},{},[3074],{"type":62,"value":3075},"Task subject",{"type":49,"tag":577,"props":3077,"children":3078},{},[3079],{"type":62,"value":3080},"activeForm",{"type":49,"tag":577,"props":3082,"children":3083},{},[3084],{"type":62,"value":3085},"Description",{"type":49,"tag":593,"props":3087,"children":3088},{},[3089,3107,3125,3143,3161,3179],{"type":49,"tag":573,"props":3090,"children":3091},{},[3092,3097,3102],{"type":49,"tag":600,"props":3093,"children":3094},{},[3095],{"type":62,"value":3096},"Verify PAC CLI installation",{"type":49,"tag":600,"props":3098,"children":3099},{},[3100],{"type":62,"value":3101},"Verifying PAC CLI",{"type":49,"tag":600,"props":3103,"children":3104},{},[3105],{"type":62,"value":3106},"Check if PAC CLI is installed, install if missing",{"type":49,"tag":573,"props":3108,"children":3109},{},[3110,3115,3120],{"type":49,"tag":600,"props":3111,"children":3112},{},[3113],{"type":62,"value":3114},"Verify authentication",{"type":49,"tag":600,"props":3116,"children":3117},{},[3118],{"type":62,"value":3119},"Verifying authentication",{"type":49,"tag":600,"props":3121,"children":3122},{},[3123],{"type":62,"value":3124},"Check current auth status, authenticate if needed",{"type":49,"tag":573,"props":3126,"children":3127},{},[3128,3133,3138],{"type":49,"tag":600,"props":3129,"children":3130},{},[3131],{"type":62,"value":3132},"Confirm target environment",{"type":49,"tag":600,"props":3134,"children":3135},{},[3136],{"type":62,"value":3137},"Confirming environment",{"type":49,"tag":600,"props":3139,"children":3140},{},[3141],{"type":62,"value":3142},"Show current environment, let user confirm or switch",{"type":49,"tag":573,"props":3144,"children":3145},{},[3146,3151,3156],{"type":49,"tag":600,"props":3147,"children":3148},{},[3149],{"type":62,"value":3150},"Deploy the code site",{"type":49,"tag":600,"props":3152,"children":3153},{},[3154],{"type":62,"value":3155},"Deploying site",{"type":49,"tag":600,"props":3157,"children":3158},{},[3159],{"type":62,"value":3160},"Locate project root, build, and upload via pac pages upload-code-site",{"type":49,"tag":573,"props":3162,"children":3163},{},[3164,3169,3174],{"type":49,"tag":600,"props":3165,"children":3166},{},[3167],{"type":62,"value":3168},"Verify deployment",{"type":49,"tag":600,"props":3170,"children":3171},{},[3172],{"type":62,"value":3173},"Verifying deployment",{"type":49,"tag":600,"props":3175,"children":3176},{},[3177],{"type":62,"value":3178},"Confirm .powerpages-site folder exists, review upload output, commit changes, offer activation",{"type":49,"tag":573,"props":3180,"children":3181},{},[3182,3187,3192],{"type":49,"tag":600,"props":3183,"children":3184},{},[3185],{"type":62,"value":3186},"Handle blocked JavaScript",{"type":49,"tag":600,"props":3188,"children":3189},{},[3190],{"type":62,"value":3191},"Resolving JS block",{"type":49,"tag":600,"props":3193,"children":3194},{},[3195],{"type":62,"value":3196},"If upload fails due to blocked JS, offer to unblock and retry",{"type":49,"tag":54,"props":3198,"children":3199},{},[3200,3202,3208,3210,3216,3218,3224,3226,3231],{"type":62,"value":3201},"Mark each task ",{"type":49,"tag":67,"props":3203,"children":3205},{"className":3204},[],[3206],{"type":62,"value":3207},"in_progress",{"type":62,"value":3209}," when starting it and ",{"type":49,"tag":67,"props":3211,"children":3213},{"className":3212},[],[3214],{"type":62,"value":3215},"completed",{"type":62,"value":3217}," when done via ",{"type":49,"tag":67,"props":3219,"children":3221},{"className":3220},[],[3222],{"type":62,"value":3223},"TaskUpdate",{"type":62,"value":3225},". Phase 6 may be marked ",{"type":49,"tag":67,"props":3227,"children":3229},{"className":3228},[],[3230],{"type":62,"value":3215},{"type":62,"value":3232}," immediately if no JavaScript blocking issue is encountered. This gives the user visibility into progress and keeps the workflow deterministic.",{"type":49,"tag":140,"props":3234,"children":3235},{},[],{"type":49,"tag":54,"props":3237,"children":3238},{},[3239],{"type":49,"tag":58,"props":3240,"children":3241},{},[3242],{"type":62,"value":3243},"Begin with Phase 1: Verify PAC CLI",{"type":49,"tag":3245,"props":3246,"children":3247},"style",{},[3248],{"type":62,"value":3249},"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":3251,"total":3346},[3252,3262,3276,3286,3301,3314,3330],{"slug":3253,"name":3253,"fn":3254,"description":3255,"org":3256,"tags":3257,"stars":23,"repoUrl":24,"updatedAt":3261},"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},[3258,3259,3260],{"name":18,"slug":19,"type":15},{"name":9,"slug":8,"type":15},{"name":13,"slug":14,"type":15},"2026-04-06T18:34:34.732549",{"slug":3263,"name":3263,"fn":3264,"description":3265,"org":3266,"tags":3267,"stars":23,"repoUrl":24,"updatedAt":3275},"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},[3268,3271,3273],{"name":3269,"slug":3270,"type":15},"Integrations","integrations",{"name":3272,"slug":33,"type":15},"Power Apps",{"name":3274,"slug":34,"type":15},"Power Platform","2026-07-31T05:54:47.042251",{"slug":3277,"name":3277,"fn":3278,"description":3279,"org":3280,"tags":3281,"stars":23,"repoUrl":24,"updatedAt":3285},"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},[3282,3283,3284],{"name":3269,"slug":3270,"type":15},{"name":9,"slug":8,"type":15},{"name":3272,"slug":33,"type":15},"2026-07-03T16:31:47.822186",{"slug":3287,"name":3287,"fn":3288,"description":3289,"org":3290,"tags":3291,"stars":23,"repoUrl":24,"updatedAt":3300},"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},[3292,3295,3298,3299],{"name":3293,"slug":3294,"type":15},"Data Modeling","data-modeling",{"name":3296,"slug":3297,"type":15},"Dataverse","dataverse",{"name":9,"slug":8,"type":15},{"name":3272,"slug":33,"type":15},"2026-07-31T05:54:46.078014",{"slug":3302,"name":3302,"fn":3303,"description":3304,"org":3305,"tags":3306,"stars":23,"repoUrl":24,"updatedAt":3313},"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},[3307,3310,3311,3312],{"name":3308,"slug":3309,"type":15},"Excel","excel",{"name":3269,"slug":3270,"type":15},{"name":9,"slug":8,"type":15},{"name":3272,"slug":33,"type":15},"2026-07-31T05:54:44.030943",{"slug":3315,"name":3315,"fn":3316,"description":3317,"org":3318,"tags":3319,"stars":23,"repoUrl":24,"updatedAt":3329},"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},[3320,3323,3326,3327,3328],{"name":3321,"slug":3322,"type":15},"Agents","agents",{"name":3324,"slug":3325,"type":15},"Copilot Studio","copilot-studio",{"name":3269,"slug":3270,"type":15},{"name":9,"slug":8,"type":15},{"name":3272,"slug":33,"type":15},"2026-07-31T05:54:39.025597",{"slug":3331,"name":3331,"fn":3332,"description":3333,"org":3334,"tags":3335,"stars":23,"repoUrl":24,"updatedAt":3345},"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},[3336,3339,3340,3341,3342],{"name":3337,"slug":3338,"type":15},"Database","database",{"name":3296,"slug":3297,"type":15},{"name":9,"slug":8,"type":15},{"name":13,"slug":14,"type":15},{"name":3343,"slug":3344,"type":15},"Testing","testing","2026-04-06T18:34:41.141155",26,{"items":3348,"total":3539},[3349,3371,3390,3411,3426,3443,3454,3467,3482,3497,3514,3527],{"slug":3350,"name":3350,"fn":3351,"description":3352,"org":3353,"tags":3354,"stars":3368,"repoUrl":3369,"updatedAt":3370},"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},[3355,3358,3361,3362,3365],{"name":3356,"slug":3357,"type":15},"Engineering","engineering",{"name":3359,"slug":3360,"type":15},"Local Development","local-development",{"name":9,"slug":8,"type":15},{"name":3363,"slug":3364,"type":15},"Project Management","project-management",{"name":3366,"slug":3367,"type":15},"Rush","rush",6484,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Frushstack","2026-04-06T18:34:44.965032",{"slug":3372,"name":3372,"fn":3373,"description":3374,"org":3375,"tags":3376,"stars":3387,"repoUrl":3388,"updatedAt":3389},"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},[3377,3380,3381,3384],{"name":3378,"slug":3379,"type":15},".NET","net",{"name":3321,"slug":3322,"type":15},{"name":3382,"slug":3383,"type":15},"Azure","azure",{"name":3385,"slug":3386,"type":15},"LLM","llm",2804,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fskills","2026-07-03T16:32:10.297433",{"slug":3391,"name":3391,"fn":3392,"description":3393,"org":3394,"tags":3395,"stars":3387,"repoUrl":3388,"updatedAt":3410},"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},[3396,3399,3400,3403,3406,3407],{"name":3397,"slug":3398,"type":15},"Analytics","analytics",{"name":3382,"slug":3383,"type":15},{"name":3401,"slug":3402,"type":15},"Data Analysis","data-analysis",{"name":3404,"slug":3405,"type":15},"Java","java",{"name":9,"slug":8,"type":15},{"name":3408,"slug":3409,"type":15},"Monitoring","monitoring","2026-05-13T06:14:16.261754",{"slug":3412,"name":3412,"fn":3413,"description":3414,"org":3415,"tags":3416,"stars":3387,"repoUrl":3388,"updatedAt":3425},"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},[3417,3420,3421,3422],{"name":3418,"slug":3419,"type":15},"AI Infrastructure","ai-infrastructure",{"name":3382,"slug":3383,"type":15},{"name":3404,"slug":3405,"type":15},{"name":3423,"slug":3424,"type":15},"Security","security","2026-07-07T06:53:31.293235",{"slug":3427,"name":3427,"fn":3428,"description":3429,"org":3430,"tags":3431,"stars":3387,"repoUrl":3388,"updatedAt":3442},"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},[3432,3433,3436,3437,3438,3441],{"name":3382,"slug":3383,"type":15},{"name":3434,"slug":3435,"type":15},"Compliance","compliance",{"name":3385,"slug":3386,"type":15},{"name":9,"slug":8,"type":15},{"name":3439,"slug":3440,"type":15},"Python","python",{"name":3423,"slug":3424,"type":15},"2026-07-18T05:14:23.017504",{"slug":3444,"name":3444,"fn":3445,"description":3446,"org":3447,"tags":3448,"stars":3387,"repoUrl":3388,"updatedAt":3453},"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},[3449,3450,3451,3452],{"name":3397,"slug":3398,"type":15},{"name":3382,"slug":3383,"type":15},{"name":3385,"slug":3386,"type":15},{"name":3439,"slug":3440,"type":15},"2026-07-31T05:54:29.068751",{"slug":3455,"name":3455,"fn":3456,"description":3457,"org":3458,"tags":3459,"stars":3387,"repoUrl":3388,"updatedAt":3466},"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},[3460,3463,3464,3465],{"name":3461,"slug":3462,"type":15},"API Development","api-development",{"name":3382,"slug":3383,"type":15},{"name":9,"slug":8,"type":15},{"name":3439,"slug":3440,"type":15},"2026-07-18T05:14:16.988376",{"slug":3468,"name":3468,"fn":3469,"description":3470,"org":3471,"tags":3472,"stars":3387,"repoUrl":3388,"updatedAt":3481},"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},[3473,3474,3477,3480],{"name":3382,"slug":3383,"type":15},{"name":3475,"slug":3476,"type":15},"Computer Vision","computer-vision",{"name":3478,"slug":3479,"type":15},"Images","images",{"name":3439,"slug":3440,"type":15},"2026-07-18T05:14:18.007737",{"slug":3483,"name":3483,"fn":3484,"description":3485,"org":3486,"tags":3487,"stars":3387,"repoUrl":3388,"updatedAt":3496},"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},[3488,3489,3492,3495],{"name":3382,"slug":3383,"type":15},{"name":3490,"slug":3491,"type":15},"Configuration","configuration",{"name":3493,"slug":3494,"type":15},"Feature Flags","feature-flags",{"name":3404,"slug":3405,"type":15},"2026-07-03T16:32:01.278468",{"slug":3498,"name":3498,"fn":3499,"description":3500,"org":3501,"tags":3502,"stars":3387,"repoUrl":3388,"updatedAt":3513},"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},[3503,3506,3507,3510],{"name":3504,"slug":3505,"type":15},"Cosmos DB","cosmos-db",{"name":3337,"slug":3338,"type":15},{"name":3508,"slug":3509,"type":15},"NoSQL","nosql",{"name":3511,"slug":3512,"type":15},"Rust","rust","2026-07-31T05:54:27.021432",{"slug":3515,"name":3515,"fn":3499,"description":3516,"org":3517,"tags":3518,"stars":3387,"repoUrl":3388,"updatedAt":3526},"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},[3519,3520,3521,3522,3523],{"name":3504,"slug":3505,"type":15},{"name":3337,"slug":3338,"type":15},{"name":9,"slug":8,"type":15},{"name":3508,"slug":3509,"type":15},{"name":3524,"slug":3525,"type":15},"TypeScript","typescript","2026-07-03T16:31:19.368382",{"slug":3528,"name":3528,"fn":3529,"description":3530,"org":3531,"tags":3532,"stars":3387,"repoUrl":3388,"updatedAt":3538},"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},[3533,3534,3535,3536,3537],{"name":3382,"slug":3383,"type":15},{"name":3504,"slug":3505,"type":15},{"name":3337,"slug":3338,"type":15},{"name":3404,"slug":3405,"type":15},{"name":3508,"slug":3509,"type":15},"2026-05-13T06:14:17.582229",267]