feat: add FlowStudio monitoring + governance skills, update debug + build + mcp (#1304)

- **New skill: flowstudio-power-automate-monitoring** — flow health, failure
  rates, maker inventory, Power Apps, environment/connection counts via
  FlowStudio MCP cached store tools.
- **New skill: flowstudio-power-automate-governance** — 10 CoE-aligned
  governance workflows: compliance review, orphan detection, archive scoring,
  connector audit, notification management, classification/tagging, maker
  offboarding, security review, environment governance, governance dashboard.
- **Updated flowstudio-power-automate-debug** — purely live API tools (no
  store dependencies), mandatory action output inspection step, resubmit
  clarified as working for ALL trigger types.
- **Updated flowstudio-power-automate-build** — Step 1 uses list_live_flows
  (not list_store_flows) for the duplicate check, resubmit-first testing.
- **Updated flowstudio-power-automate-mcp** — store tool catalog, response
  shapes verified against real API calls, set_store_flow_state shape fix.
- Plugin version bumped to 2.0.0, all 5 skills listed in plugin.json.
- Generated docs regenerated via npm start.

All response shapes verified against real FlowStudio MCP API calls.
All 10 governance workflows validated with real tenant data.

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

plugins/flowstudio-power-automate/.github/plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "flowstudio-power-automate",
-  "description": "Complete toolkit for managing Power Automate cloud flows via the FlowStudio MCP server. Includes skills for connecting to the MCP server, debugging failed flow runs, and building/deploying flows from natural language.",
-  "version": "1.0.0",
+  "description": "Give your AI agent full visibility into Power Automate cloud flows via the FlowStudio MCP server. Connect, debug, build, monitor health, and govern flows at scale — action-level inputs and outputs, not just status codes.",
+  "version": "2.0.0",
   "author": {
     "name": "Awesome Copilot Community"
   },
@@ -14,11 +14,15 @@
     "mcp",
     "model-context-protocol",
     "cloud-flows",
-    "workflow-automation"
+    "workflow-automation",
+    "monitoring",
+    "governance"
   ],
   "skills": [
     "./skills/flowstudio-power-automate-mcp/",
     "./skills/flowstudio-power-automate-debug/",
-    "./skills/flowstudio-power-automate-build/"
+    "./skills/flowstudio-power-automate-build/",
+    "./skills/flowstudio-power-automate-monitoring/",
+    "./skills/flowstudio-power-automate-governance/"
   ]
 }

plugins/flowstudio-power-automate/README.md

@@ -1,13 +1,26 @@
 # FlowStudio Power Automate Plugin
 
-Complete toolkit for managing Power Automate cloud flows via the FlowStudio MCP server. Connect, debug, and build/deploy flows using AI agents.
+Give your AI agent the same visibility you have in the Power Automate portal. The Graph API only returns top-level run status — agents can't see action inputs, loop iterations, nested failures, or who owns a flow. Flow Studio MCP exposes all of it.
 
-Requires a FlowStudio MCP subscription — see https://flowstudio.app
+This plugin includes five skills covering the full lifecycle: connect, debug, build, monitor, and govern Power Automate cloud flows.
+
+Requires a [FlowStudio MCP](https://mcp.flowstudio.app) subscription.
+
+## What Agents Can't See Today
+
+| What you see in the portal | What agents see via Graph API |
+|---|---|
+| Action inputs and outputs | Run passed or failed (no detail) |
+| Loop iteration data | Nothing |
+| Child flow failures | Top-level error code only |
+| Flow health and failure rates | Nothing |
+| Who built a flow, what connectors it uses | Nothing |
+
+Flow Studio MCP fills these gaps.
 
 ## Installation
 
 ```bash
-# Using Copilot CLI
 copilot plugin install flowstudio-power-automate@awesome-copilot
 ```
 
@@ -17,21 +30,44 @@ copilot plugin install flowstudio-power-automate@awesome-copilot
 
 | Skill | Description |
 |-------|-------------|
-| `flowstudio-power-automate-mcp` | Core connection setup, tool discovery, and CRUD operations for Power Automate cloud flows via the FlowStudio MCP server. |
-| `flowstudio-power-automate-debug` | Step-by-step diagnostic workflow for investigating and fixing failing Power Automate cloud flow runs. |
-| `flowstudio-power-automate-build` | Build, scaffold, and deploy Power Automate cloud flows from natural language descriptions with bundled action pattern templates. |
+| `flowstudio-power-automate-mcp` | Core connection setup, tool discovery, and operations — list flows, read definitions, check runs, resubmit, cancel. |
+| `flowstudio-power-automate-debug` | Step-by-step diagnostic workflow — action-level inputs and outputs, not just error codes. Identifies root cause across nested child flows and loop iterations. |
+| `flowstudio-power-automate-build` | Build and deploy flow definitions from scratch — scaffold triggers, wire connections, deploy, and test via resubmit. |
+| `flowstudio-power-automate-monitoring` | Flow health from the cached store — failure rates, run history with remediation hints, maker inventory, Power Apps, environment and connection counts. |
+| `flowstudio-power-automate-governance` | Governance workflows — classify flows by business impact, detect orphaned resources, audit connectors, manage notification rules, compute archive scores. |
+
+The first three skills call the live Power Automate API. The monitoring and governance skills read from a cached daily snapshot with aggregated stats and governance metadata.
+
+## Prerequisites
+
+- A [FlowStudio MCP](https://mcp.flowstudio.app) subscription
+- MCP endpoint: `https://mcp.flowstudio.app/mcp`
+- API key (passed as `x-api-key` header — not Bearer)
 
 ## Getting Started
 
 1. Install the plugin
-2. Subscribe to FlowStudio MCP at https://flowstudio.app
-3. Configure your MCP connection with the JWT from your workspace
-4. Ask Copilot to list your flows, debug a failure, or build a new flow
+2. Get your API key at [mcp.flowstudio.app](https://mcp.flowstudio.app)
+3. Configure the MCP connection in VS Code (`.vscode/mcp.json`):
+   ```json
+   {
+     "servers": {
+       "flowstudio": {
+         "type": "http",
+         "url": "https://mcp.flowstudio.app/mcp",
+         "headers": { "x-api-key": "<YOUR_TOKEN>" }
+       }
+     }
+   }
+   ```
+4. Ask Copilot to list your flows, debug a failure, build a new flow, check flow health, or run a governance review
 
 ## Source
 
 This plugin is part of [Awesome Copilot](https://github.com/github/awesome-copilot), a community-driven collection of GitHub Copilot extensions.
 
+Skills source: [ninihen1/power-automate-mcp-skills](https://github.com/ninihen1/power-automate-mcp-skills)
+
 ## License
 
 MIT