npm - @muggleai/works - Versions diffs - 4.11.4 → 4.12.1 - Mend

@muggleai/works 4.11.4 → 4.12.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (96) hide show

package/dist/plugin/skills/muggle-pr-followup/output-templates/escalation.md ADDED Viewed

@@ -0,0 +1,32 @@
+# Escalation messages
+Emitted by `/muggle-do` in address-reviews mode. One per invocation, at most. Anchored here so wording stays consistent.
+## Ambiguous escalation
+```
+**Review-followup escalation — <owner>/<repo>#<n>**
+I can't act on <count> review(s) without your input. Listed below; reply on GitHub by submitting a new review with clearer direction, or tell me here which way to go.
+Review #<id> from <login>:
+> <body or "(no body)">
+Comments:
+- <file>:<line> — <body>
+- ...
+[Repeat per ambiguous review in the batch.]
+```
+## Design-adjustment escalation
+```
+**Design-adjustment needed — <owner>/<repo>#<n>**
+While addressing review #<id>, the cycle surfaced a conflict with the current design:
+  <one-paragraph description of the conflict>
+This is beyond a routine code change. Confirm the design intent (reply here, or update the requirements doc) before I retry.
+```

package/dist/plugin/skills/muggle-pr-followup/output-templates/help.md ADDED Viewed

@@ -0,0 +1,17 @@
+# Help output
+For `/muggle:muggle-pr-followup` with no args, or with `help` / `?`:
+```
+muggle-pr-followup — watcher loop for PR review follow-ups
+Active loops:
+  <slug> → <owner>/<repo>#<n> (cursor @ review #<id>, <N> cycles)
+  ...
+  (or "no active loops")
+Usage:
+  /muggle:muggle-pr-followup <pr-url>            → bootstrap a new loop
+  /muggle:muggle-pr-followup <slug> <pr-number>  → run one tick (called by /loop)
+  /muggle:muggle-pr-followup <pr-number>         → run one tick (slug inferred from on-disk state)
+```

package/dist/plugin/skills/muggle-pr-followup/output-templates/inline-reply.md ADDED Viewed

@@ -0,0 +1,17 @@
+# Per-comment inline reply
+Posted via `gh api .../comments/<comment-id>/replies` per cycle, one per line comment.
+```
+Addressed in <short-sha>: <one-line summary of the change made for THIS comment>.
+```
+`<short-sha>` is the first 7 chars of the new SHA. The body must contain that substring — the resolve-reminder stage greps for it to classify threads as addressed-by-loop.
+## Top-level fallback (review-body-only)
+When an actionable review has a non-empty body but zero line comments, GitHub has no `/replies` endpoint for the body. Post a top-level PR comment instead, at most once per such review:
+```
+Re: review #<review_id> — addressed in <short-sha>: <one-line summary>.
+```

package/dist/plugin/skills/muggle-pr-followup/output-templates/resolve-reminder.md ADDED Viewed

@@ -0,0 +1,12 @@
+# Resolve-reminder top-level PR comment
+Posted via `gh pr comment` after the resolve-reminder stage scans threads. Only when at least one addressed-by-loop thread exists.
+```
+I addressed these threads in <short-sha> — mark them resolved when satisfied:
+- #<thread-id-1>
+- #<thread-id-2>
+- ...
+```
+If `addressed_by_loop == 0`, no comment is posted (silent).

package/dist/plugin/skills/muggle-pr-followup/output-templates/watcher-log.md ADDED Viewed

@@ -0,0 +1,21 @@
+# Watcher tick log lines
+The watcher does **not** print to the user during normal operation. It only appends to `followup.log`. All user-facing escalations come from `/muggle-do`.
+## Idle tick
+```
+<ISO-8601> tick pr=<n> reviews_seen=0 idle
+```
+## Dispatching tick
+```
+<ISO-8601> tick pr=<n> reviews_seen=<count> dispatched=<id1>,<id2>,...
+```
+## Terminal tick
+```
+<ISO-8601> tick pr=<n> terminal=<merged|closed> result.md written
+```

package/dist/plugin/skills/muggle-pr-followup/output-templates.md ADDED Viewed

@@ -0,0 +1,14 @@
+# Output templates
+All user-facing message text used by the watcher, bootstrap, and `/muggle-do` in address-reviews mode. Each template group is its own file — load only what the current step emits.
+## Index
+| Group | Use case |
+| :---- | :------- |
+| [`bootstrap`](output-templates/bootstrap.md) | Bootstrap success summary + all bootstrap aborts. |
+| [`watcher-log`](output-templates/watcher-log.md) | The three `followup.log` line shapes (idle, dispatching, terminal). |
+| [`escalation`](output-templates/escalation.md) | `/muggle-do` terminal escalation messages (ambiguous, design-adjustment). |
+| [`inline-reply`](output-templates/inline-reply.md) | Per-comment inline reply + top-level fallback for body-only reviews. |
+| [`resolve-reminder`](output-templates/resolve-reminder.md) | Top-level PR comment for the resolve-reminder stage. |
+| [`help`](output-templates/help.md) | Skill help output (no args / `help` / `?`). |

package/dist/plugin/skills/muggle-pr-followup/state-schemas.md ADDED Viewed

@@ -0,0 +1,104 @@
+# Session State Schemas
+Canonical shapes for the JSON files in a PR-follow-up session slot. The slot path is `.muggle-do/sessions/<slug>/` (the caller's session dir; `muggle-do` is the current and only caller).
+All files are atomic writes — the caller rewrites the whole file each time, never mutates in place. Use a temp file + rename if the platform supports it.
+## `prs.json`
+A list of one entry. (Historical: the file is an array for forward-compat with the original session-wide model. Today, each PR has its own session slot, so the array always has exactly one entry.)
+```json
+[
+  {
+    "repo": "<owner>/<repo>",
+    "number": <int>,
+    "url": "https://github.com/<owner>/<repo>/pull/<number>",
+    "head_sha": "<40-char-hex-sha>",
+    "state": "open" | "merged" | "closed"
+  }
+]
+```
+- `state` is the **observed** state from the last `gh pr view`. The watcher refreshes it each tick.
+- Terminal states (`merged`, `closed`) are sticky — once set, the watcher writes `result.md` and exits without rescheduling.
+## `last_seen.json`
+Keyed by `"<owner>/<repo>#<n>"`. One key per PR in the slot.
+```json
+{
+  "<owner>/<repo>#<n>": {
+    "reviewId": <int>,
+    "last_pushed_sha": "<sha-or-null>",
+    "idle_tick_count": <int>,
+    "cycles_completed": <int>,
+    "escalated_review_ids": [<int>, ...],
+    "pushed_shas": ["<sha>", ...]
+  }
+}
+```
+- `reviewId`: the cursor. The watcher fetches reviews with `id > reviewId`. Bootstrap pins this to the highest existing submitted review id (or `0` if none).
+- `last_pushed_sha`: most recent SHA `/muggle-do` pushed in this PR's life; `null` until the first push.
+- `idle_tick_count`: incremented each tick that sees zero new reviews. Reset to 0 on any tick that dispatches `/muggle-do`. Diagnostic only — does not gate behavior.
+- `cycles_completed`: incremented each time `/muggle-do` completes an address-reviews invocation (regardless of actionable/ambiguous/mixed).
+- `escalated_review_ids`: review ids classified as ambiguous by `/muggle-do`. The watcher excludes these from future review fetches so the same ambiguous review is never re-dispatched.
+- `pushed_shas`: every SHA `/muggle-do` has pushed for this PR. Append-only. Used by the resolve-reminder stage to recognize threads addressed by the loop.
+## `state.md`
+Free-form markdown. No required schema beyond a few well-known fields the caller-agnostic code reads:
+```markdown
+# Session — <slug>
+**PR:** <url>
+**Slug:** <slug>
+**Loop user:** <github-login>          ← cached from `gh api user`
+**Created:** <ISO-8601>
+**Bootstrapped from URL:** <yes | no>
+...free-form notes added by /muggle-do and bootstrap...
+```
+The watcher does **not** read or write `state.md`. Only bootstrap, `/muggle-do`, and the caller's stages touch it.
+## `followup.log`
+Append-only line-per-tick log. One line per watcher tick, plus one line per `/muggle-do` invocation. Format is loose, but each line starts with an ISO-8601 timestamp:
+```
+2026-05-20T12:34:56Z tick pr=154 reviews_seen=0 idle
+2026-05-20T12:35:56Z tick pr=154 reviews_seen=1 dispatched=4295962800
+2026-05-20T12:36:14Z muggle-do cycle review_ids=[4295962800] outcome=pushed head_sha=abc1234
+```
+Used for forensics only — never read back by skills.
+## `result.md`
+Written exactly once when the PR's watcher exits terminally (PR merged or closed). Free-form markdown summarizing the PR's life under this loop:
+```markdown
+# Result — <slug>
+**PR:** <url>
+**Final state:** merged | closed
+**Cycles completed:** <int>
+**Pushed SHAs:** <comma-separated list>
+**Escalated review ids:** <comma-separated list or "none">
+## Timeline
+- <ISO-8601> bootstrap (cursor pinned at <reviewId>)
+- <ISO-8601> review <id> from <login> — actionable, pushed <sha>
+- <ISO-8601> review <id> from <login> — ambiguous, escalated
+- ...
+- <ISO-8601> PR <merged|closed> — watcher terminal
+```
+## Not in the slot
+`cycle.json` and `requirements.md` are not seeded or read. `/muggle-do` reads reviews off GitHub each invocation.

package/dist/plugin/skills/muggle-test-regenerate-missing/SKILL.md CHANGED Viewed

@@ -180,15 +180,15 @@ Bulk regen does not run replays, so the section B (replay) router does not apply
 ### Step 8 — Open the Dashboard
-Open the Muggle AI dashboard so the user can watch progress visually:
+Open the Muggle AI dashboard so the user can watch progress visually. Point them at the **scripts** page (where DRAFT → GENERATING → ACTIVE transitions are visible), not `/runs` (which is for replay batches and shows nothing for a regen):
 ```bash
-open "https://www.muggle-ai.com/muggleTestV0/dashboard/projects/{projectId}/runs"
+open "https://www.muggle-ai.com/muggleTestV0/dashboard/projects/{projectId}/scripts"
 ```
 Tell them:
-> "I've opened the project's runs page. Generation jobs typically take a few minutes each — they'll appear here as they progress. Your test cases will move into `ACTIVE` status as scripts complete."
+> "I've opened the project's scripts page. Generation jobs typically take a few minutes each — your test cases will move from `DRAFT` through `GENERATING` to `ACTIVE` as scripts complete."
 ### Step 9 (optional) — Poll Status

package/dist/release-manifest.json CHANGED Viewed

@@ -1,7 +1,7 @@
 {
-  "release": "4.11.4",
-  "buildId": "run-37-1",
-  "commitSha": "36a1f8499178f2361b5a683ddd5420de28558c23",
-  "buildTime": "2026-05-20T22:12:49Z",
+  "release": "4.12.1",
+  "buildId": "run-39-1",
+  "commitSha": "e69fef56f40ab4b9c47ea9fa90c2237ab9ca62eb",
+  "buildTime": "2026-05-21T22:26:42Z",
   "serviceName": "muggle-ai-works-mcp"
 }

package/package.json CHANGED Viewed

@@ -1,108 +1,108 @@
 {
-    "name": "@muggleai/works",
-    "mcpName": "io.github.multiplex-ai/muggle",
-    "version": "4.11.4",
-    "description": "Ship quality products with AI-powered E2E acceptance testing that validates your web app like a real user — from Claude Code and Cursor to PR.",
-    "type": "module",
-    "main": "dist/index.js",
-    "bin": {
-        "muggle": "bin/muggle.js"
-    },
-    "files": [
-        "dist",
-        "plugin",
-        "bin/muggle.js",
-        "scripts/postinstall.mjs"
-    ],
-    "scripts": {
-        "clean": "rimraf dist",
-        "build": "tsup && node scripts/strip-telemetry-comments.mjs && node scripts/write-release-manifest.mjs && node scripts/sync-versions.mjs && node scripts/build-plugin.mjs",
-        "build:plugin": "node scripts/build-plugin.mjs",
-        "sync:versions": "node scripts/sync-versions.mjs",
-        "build:release": "npm run build",
-        "verify:plugin": "node scripts/verify-plugin-marketplace.mjs",
-        "verify:contracts": "node scripts/verify-compatibility-contracts.mjs",
-        "verify:electron-release-checksums": "node scripts/verify-electron-release-checksums.mjs",
-        "verify:upgrade-experience": "node scripts/verify-upgrade-experience.mjs",
-        "build:workspace": "turbo run build",
-        "typecheck:workspace": "turbo run typecheck",
-        "lint:workspace": "turbo run lint",
-        "test:workspace": "turbo run test",
-        "dev:workspace": "turbo run dev",
-        "bootstrap": "npm install && npm run build",
-        "bootstrap:workspace": "pnpm install && pnpm run build:workspace",
-        "postinstall": "node scripts/postinstall.mjs",
-        "start": "node dist/index.js",
-        "dev": "tsx watch src/index.ts",
-        "lint": "eslint . --fix",
-        "lint:check": "eslint .",
-        "typecheck": "tsc --noEmit",
-        "test": "vitest run",
-        "test:watch": "vitest"
-    },
-    "muggleConfig": {
-        "electronAppVersion": "1.0.88",
-        "downloadBaseUrl": "https://github.com/multiplex-ai/muggle-ai-works/releases/download",
-        "runtimeTargetDefault": "production",
-        "checksums": {
-            "darwin-arm64": "dbcefc10f2cdeabe8be74490354ed83f600eb18d8f411b3f1dec266e5eb2e95b",
-            "darwin-x64": "ac4430824e18d15476ed91a6bbe81d0880239b758006cbf721d8e7d58a0c3676",
-            "win32-x64": "16119743fb344990f2b67fa2a9844a50a46d70f6fbf3f72435b5ce1d7a635cd9",
-            "linux-x64": "4e43f3946c80918f972a4c587a5f83873ccaeb5338f6eb8b5296022ba096f059"
-        }
-    },
-    "dependencies": {
-        "@modelcontextprotocol/sdk": "^1.25.3",
-        "applicationinsights": "^3.14.0",
-        "axios": "^1.7.9",
-        "commander": "^14.0.3",
-        "open": "^11.0.0",
-        "ulid": "^3.0.2",
-        "uuid": "^14.0.0",
-        "winston": "^3.17.0",
-        "zod": "^4.3.6"
-    },
-    "devDependencies": {
-        "@anthropic-ai/claude-agent-sdk": "^0.2.133",
-        "@eslint/js": "^10.0.1",
-        "@muggleai/mcp": "file:packages/mcps",
-        "@muggleai/workflows": "file:packages/workflows",
-        "@types/node": "^25.5.2",
-        "@types/uuid": "^11.0.0",
-        "@typescript-eslint/eslint-plugin": "^8.34.0",
-        "@typescript-eslint/parser": "^8.34.0",
-        "eslint": "^10.2.0",
-        "eslint-plugin-unused-imports": "^4.2.0",
-        "rimraf": "^6.0.1",
-        "tsup": "^8.5.1",
-        "tsx": "^4.19.2",
-        "turbo": "^2.9.4",
-        "typescript": "^6.0.2",
-        "vitest": "^4.0.18"
-    },
-    "engines": {
-        "node": ">=22.0.0"
-    },
-    "keywords": [
-        "mcp",
-        "model-context-protocol",
-        "muggle-ai",
-        "e2e-testing",
-        "testing",
-        "automation",
-        "localhost",
-        "ai-coding",
-        "user-experience",
-        "cursor",
-        "claude-code",
-        "vibe-coding"
-    ],
-    "author": "Muggle AI",
-    "license": "MIT",
-    "packageManager": "pnpm@10.0.0",
-    "repository": {
-        "type": "git",
-        "url": "git+https://github.com/multiplex-ai/muggle-ai-works.git"
-    },
-    "homepage": "https://www.muggle-ai.com/muggleTestV0/docs/mcp/mcp-overview"
+  "name": "@muggleai/works",
+  "mcpName": "io.github.multiplex-ai/muggle",
+  "version": "4.12.1",
+  "description": "Ship quality products with AI-powered E2E acceptance testing that validates your web app like a real user — from Claude Code and Cursor to PR.",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "muggle": "bin/muggle.js"
+  },
+  "files": [
+    "dist",
+    "plugin",
+    "bin/muggle.js",
+    "scripts/postinstall.mjs"
+  ],
+  "scripts": {
+    "clean": "rimraf dist",
+    "build": "tsup && node scripts/strip-telemetry-comments.mjs && node scripts/write-release-manifest.mjs && node scripts/sync-versions.mjs && node scripts/build-plugin.mjs",
+    "build:plugin": "node scripts/build-plugin.mjs",
+    "sync:versions": "node scripts/sync-versions.mjs",
+    "build:release": "npm run build",
+    "verify:plugin": "node scripts/verify-plugin-marketplace.mjs",
+    "verify:contracts": "node scripts/verify-compatibility-contracts.mjs",
+    "verify:electron-release-checksums": "node scripts/verify-electron-release-checksums.mjs",
+    "verify:upgrade-experience": "node scripts/verify-upgrade-experience.mjs",
+    "build:workspace": "turbo run build",
+    "typecheck:workspace": "turbo run typecheck",
+    "lint:workspace": "turbo run lint",
+    "test:workspace": "turbo run test",
+    "dev:workspace": "turbo run dev",
+    "bootstrap": "npm install && npm run build",
+    "bootstrap:workspace": "pnpm install && pnpm run build:workspace",
+    "postinstall": "node scripts/postinstall.mjs",
+    "start": "node dist/index.js",
+    "dev": "tsx watch src/index.ts",
+    "lint": "eslint . --fix",
+    "lint:check": "eslint .",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "muggleConfig": {
+    "electronAppVersion": "1.0.92",
+    "downloadBaseUrl": "https://github.com/multiplex-ai/muggle-ai-works/releases/download",
+    "runtimeTargetDefault": "production",
+    "checksums": {
+      "darwin-arm64": "26fbcadb2e43a708fc424cf85c30dad99d9dff4b1013c6101de6f9c8233fc928",
+      "darwin-x64": "80fa0d2f00ce2f1209c5d9ba421d6c9fe39baba97aa1390a4d04616302fed693",
+      "linux-x64": "9898c5df678d19a2fcf07733caccd26b35953286b43d722f3bf7d8bafda21a51",
+      "win32-x64": "994c637547f12d1e9c57acba324946b54f1c36631fe314e6f8e1043e1c1afedf"
+    }
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.25.3",
+    "applicationinsights": "^3.14.0",
+    "axios": "^1.7.9",
+    "commander": "^14.0.3",
+    "open": "^11.0.0",
+    "ulid": "^3.0.2",
+    "uuid": "^14.0.0",
+    "winston": "^3.17.0",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@anthropic-ai/claude-agent-sdk": "^0.2.133",
+    "@eslint/js": "^10.0.1",
+    "@muggleai/mcp": "file:packages/mcps",
+    "@muggleai/workflows": "file:packages/workflows",
+    "@types/node": "^25.5.2",
+    "@types/uuid": "^11.0.0",
+    "@typescript-eslint/eslint-plugin": "^8.34.0",
+    "@typescript-eslint/parser": "^8.34.0",
+    "eslint": "^10.2.0",
+    "eslint-plugin-unused-imports": "^4.2.0",
+    "rimraf": "^6.0.1",
+    "tsup": "^8.5.1",
+    "tsx": "^4.19.2",
+    "turbo": "^2.9.4",
+    "typescript": "^6.0.2",
+    "vitest": "^4.0.18"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "muggle-ai",
+    "e2e-testing",
+    "testing",
+    "automation",
+    "localhost",
+    "ai-coding",
+    "user-experience",
+    "cursor",
+    "claude-code",
+    "vibe-coding"
+  ],
+  "author": "Muggle AI",
+  "license": "MIT",
+  "packageManager": "pnpm@10.0.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/multiplex-ai/muggle-ai-works.git"
+  },
+  "homepage": "https://www.muggle-ai.com/muggleTestV0/docs/mcp/mcp-overview"
 }

package/plugin/.claude-plugin/plugin.json CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "name": "muggle",
   "description": "Run real-browser end-to-end (E2E) acceptance tests on your web app from any AI coding agent. Generate test scripts from plain English, replay them on localhost, capture screenshots, and validate user flows like signup, checkout, and dashboards. Works across Claude Code, Cursor, Codex, and Windsurf.",
-  "version": "4.11.4",
+  "version": "4.12.1",
   "author": {
     "name": "Muggle AI",
     "email": "support@muggle-ai.com"

package/plugin/.cursor-plugin/plugin.json CHANGED Viewed

@@ -2,7 +2,7 @@
   "name": "muggle",
   "displayName": "Muggle AI",
   "description": "Ship quality products with AI-powered end-to-end (E2E) acceptance testing that validates your web app like a real user — from Claude Code and Cursor to PR.",
-  "version": "4.11.4",
+  "version": "4.12.1",
   "author": {
     "name": "Muggle AI",
     "email": "support@muggle-ai.com"

package/plugin/scripts/ensure-electron-app.sh CHANGED Viewed

@@ -3,10 +3,35 @@
 set -euo pipefail
 # Ensure the Electron browser test runner is installed/up to date (silent, best-effort).
-if command -v muggle >/dev/null 2>&1; then
-  muggle setup >/dev/null 2>&1 || true
-else
-  npx -y @muggleai/works setup >/dev/null 2>&1 || true
+#
+# Bounded + cached: this script runs from a SessionStart hook on every Claude
+# session, so a hung `muggle setup` (e.g. one blocked by host security policy
+# on Windows) must not leak a ~100 MB orphan per session start. We cap the
+# attempt with `timeout` and skip the call entirely if we already checked
+# within the last day.
+ensure_marker_dir="${HOME}/.cache/muggle"
+ensure_marker="${ensure_marker_dir}/electron-app-checked"
+ensure_ttl=$((24 * 60 * 60))
+ensure_now=$(date +%s)
+ensure_last=0
+if [ -f "${ensure_marker}" ]; then
+    ensure_last=$(stat -f %m "${ensure_marker}" 2>/dev/null || stat -c %Y "${ensure_marker}" 2>/dev/null || echo 0)
+fi
+if [ $((ensure_now - ensure_last)) -ge "${ensure_ttl}" ]; then
+    if command -v timeout >/dev/null 2>&1; then
+        ensure_timeout="timeout -k 5 60"
+    else
+        ensure_timeout=""
+    fi
+    if command -v muggle >/dev/null 2>&1; then
+        ${ensure_timeout} muggle setup >/dev/null 2>&1 || true
+    else
+        ${ensure_timeout} npx -y @muggleai/works setup >/dev/null 2>&1 || true
+    fi
+    mkdir -p "${ensure_marker_dir}" 2>/dev/null || true
+    touch "${ensure_marker}" 2>/dev/null || true
 fi
 # --- Context injection ---

package/plugin/skills/_shared/github-cli-recipes/line-comments-for-review.md ADDED Viewed

@@ -0,0 +1,8 @@
+# Line comments for a specific review
+For per-comment reply routing in `/muggle-do`.
+```bash
+gh api repos/<owner>/<repo>/pulls/<n>/comments --paginate \
+  --jq '[.[] | select(.pull_request_review_id == <review-id>)]'
+```

package/plugin/skills/_shared/github-cli-recipes/loop-user-identity.md ADDED Viewed

@@ -0,0 +1,9 @@
+# Identify the loop user
+The GitHub identity that owns the authenticated `gh` token. Resolve-reminder thread classification and reply attribution need this.
+```bash
+gh api user --jq '.login'
+```
+Cache in `state.md` under `Loop user:`; re-resolve only when missing.

package/plugin/skills/_shared/github-cli-recipes/pr-edit.md ADDED Viewed

@@ -0,0 +1,8 @@
+# Refresh the PR title or body
+For `open-prs/update.md` when E2E state flips (passing↔failing) or validation strategy changes.
+```bash
+gh pr edit <pr-number> --repo <owner>/<repo> --title "<new-title>"
+gh pr edit <pr-number> --repo <owner>/<repo> --body-file <file>
+```

package/plugin/skills/_shared/github-cli-recipes/pr-metadata.md ADDED Viewed

@@ -0,0 +1,12 @@
+# PR metadata snapshot
+Fetch the fields the watcher and bootstrap need in one call.
+```bash
+gh pr view <pr-number> --repo <owner>/<repo> \
+  --json url,number,headRefOid,headRefName,baseRefName,state,mergedAt,closedAt,body,title,author
+```
+- `state` is one of `OPEN`, `MERGED`, `CLOSED`.
+- `headRefOid` is the current head SHA — store as `head_sha` in `prs.json`.
+- `headRefName` is the branch — must match the working tree's branch in bootstrap.

package/plugin/skills/_shared/github-cli-recipes/push-to-branch.md ADDED Viewed

@@ -0,0 +1,10 @@
+# Push to the PR branch
+After the address-reviews cycle's work.
+```bash
+git -C <repo-path> push origin <head-ref-name>
+git -C <repo-path> rev-parse HEAD
+```
+Append the new SHA to `last_seen.pushed_shas[]` so resolve-reminder can recognize it.

package/plugin/skills/_shared/github-cli-recipes/reply-line-comment.md ADDED Viewed

@@ -0,0 +1,10 @@
+# Reply to a line comment (threaded)
+Used by `/muggle-do` per-comment inline replies.
+```bash
+gh api --method POST \
+  -H "Accept: application/vnd.github+json" \
+  repos/<owner>/<repo>/pulls/<n>/comments/<comment-id>/replies \
+  -f body="<reply-text>"
+```

package/plugin/skills/_shared/github-cli-recipes/submitted-reviews.md ADDED Viewed

@@ -0,0 +1,15 @@
+# Submitted reviews past a cursor
+For the watcher's poll and the address-reviews fetch.
+```bash
+gh api repos/<owner>/<repo>/pulls/<n>/reviews --paginate
+```
+Filter client-side:
+- `submitted_at != null` (skip PENDING drafts)
+- `id > last_seen.reviewId`
+- `id` not in `last_seen.escalated_review_ids`
+- `user.login` in the resolved allow-list
+- `state` in `{CHANGES_REQUESTED, COMMENTED}`, OR `APPROVED` with a non-empty body or at least one line comment

package/plugin/skills/_shared/github-cli-recipes/top-level-comment.md ADDED Viewed

@@ -0,0 +1,7 @@
+# Top-level PR comment
+For the resolve-reminder stage and any non-threaded notice.
+```bash
+gh pr comment <pr-number> --repo <owner>/<repo> --body "<text>"
+```