@microsoft/deploy

---
name: deploy
description: Builds and deploys a Power Apps code app to Power Platform. Use when deploying changes, redeploying an existing app, or pushing updates.
user-invocable: true
allowed-tools: Read, Edit, Write, Grep, Glob, Bash
model: sonnet
---

**📋 Shared Instructions: [shared-instructions.md](${CLAUDE_PLUGIN_ROOT}/shared/shared-instructions.md)** - Cross-cutting concerns.

# Deploy

Builds and deploys the app in the current directory to Power Platform.

## Workflow

1. Check Memory Bank → 2. Build → 3. Deploy → 4. Update Memory Bank

---

### Step 1: Check Memory Bank

Check for `memory-bank.md` in the project root. If found, read it for the project name, environment, and current version. If not found, proceed — the project may have been created without the plugin.

### Step 2: Build

```powershell
npm run build
```

If the build fails:

- **TS6133 (unused import)**: Remove the unused import and retry.
- **Other TypeScript errors**: Report the error with the file and line number and stop. Do not deploy a broken build.

Verify `dist/` exists with `index.html` before continuing.

### Step 3: Deploy

```bash
pac code push
```

Capture the app URL from the output if present.

If deploy fails, report the error and follow this diagnostic sequence — do not retry silently:

1. **Always run `pac auth list` first** to check authentication state and which environment is active:
   ```bash
   pwsh -NoProfile -Command "pac auth list"
   ```
2. **If authenticated but targeting the wrong environment**: switch environment and retry:
   ```bash
   pwsh -NoProfile -Command "pac env select --environment <correct-environment-id>"
   pwsh -NoProfile -Command "pac code push"
   ```
3. **If `pac env select` fails, or pac is not authenticated at all**: then run:
   ```bash
   pwsh -NoProfile -Command "pac auth create"
   pwsh -NoProfile -Command "pac code push"
   ```

**Mac fallback — if `pac code push` fails with an auth error on macOS:**
`pac` has known authentication bugs on Mac that can block the push. Use the npx CLI instead:
```bash
npm install -g @microsoft/power-apps-cli   # skip if already installed
npx power-apps push
```
This is functionally equivalent to `pac code push` and bypasses the Mac auth issue.

### Step 4: Update Memory Bank

If `memory-bank.md` exists, increment the version (e.g., `v1.0.0` → `v1.1.0`) and update:

- Current version
- Last deployed timestamp
- App URL (if captured)