@se-studio/skills 1.5.1 → 1.5.2

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @se-studio/skills
 
+## 1.5.2
+
+### Patch Changes
+
+- Cap `asset review --include-usage` with `--usage-limit` (default 50) to avoid hosted MCP timeouts on large spaces. Document usage-limit in asset-review help and media-review skill.
+
 ## 1.5.1
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@se-studio/skills",
-  "version": "1.5.1",
+  "version": "1.5.2",
   "description": "SE Studio agent skills for marketing site development with Contentful CMS",
   "repository": {
     "type": "git",

package/skills/contentful-cms-media-review/SKILL.md

@@ -123,10 +123,10 @@ Use this extension when the client wants a **reference guide** for all CMS image
 
 ```bash
 cms-edit index sync --space <space-key>
-cms-edit --json asset review --include-usage --include-passing --space <space-key> > /tmp/image-inventory.json
+cms-edit --json asset review --include-usage --include-passing --usage-limit 0 --space <space-key> > /tmp/image-inventory.json
 ```
 
-Each asset in JSON includes `usages[]`: slug-bearing ancestors (page, article, tag, person, etc.) that ultimately use the asset.
+Each asset in JSON includes `usages[]` when resolved: slug-bearing ancestors (page, article, tag, person, etc.) that ultimately use the asset. Default `--usage-limit` is **50** (set `0` for unlimited when running locally). JSON includes `usageLimit`, `usageResolvedCount`, and `usageTruncated` when `--include-usage` is set.
 
 To inspect how images relate to a specific page, use `cms-edit open --page-slug /<slug>` + `snapshot`, or `cms-edit peek --page-slug /<slug>` without affecting your session.
 

package/skills/contentful-cms-regenerate-editor-pack/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: contentful-cms-regenerate-editor-pack
-description: "Regenerate cms-edit editor-pack for hosted MCP after registrations, guidelines, routing, or cms-editor docs change; validate, commit, and deploy."
+description: "Regenerate cms-edit editor-pack for hosted MCP after registrations, guidelines, routing, or cms-editor docs change; validate, commit, and push (never manual vercel deploy)."
 ---
 
 # Regenerate cms-edit editor pack
@@ -83,28 +83,23 @@ git add cms-edit/editor-pack   # or cms-edit/<site>/editor-pack
 git commit -m "chore(cms-edit): regenerate editor pack"
 ```
 
-## Step 6 — Deploy
+## Step 6 — Publish (commit + push only)
 
-### Customer repo with `cms-edit/host/` (SE Studio, Pedestal, Headwater)
+**Absolute rule for agents:** hosted MCP is **never** published via `vercel deploy`, `pnpm cms-edit:deploy*`, or `deploy-cms-edit-host.sh`. Commit and push is the only deploy path for customer repos with `cms-edit/host/`.
 
-Commit `editor-pack/`, then push to the branch Vercel watches (usually `develop`). Changes under `cms-edit/**` trigger a host rebuild (`stage-site.mjs` copies committed artifacts).
+### Customer repo with `cms-edit/host/` (SE Studio, Pedestal, Headwater, Brightline, …)
+
+Commit `editor-pack/` (and any other `cms-edit/**` changes), then push to the branch Vercel watches (usually `develop`). Changes under `cms-edit/**` trigger a host rebuild (`stage-site.mjs` copies committed artifacts on the Vercel build).
 
 ```bash
-git push
+git push origin develop   # or the site's configured deploy branch
 ```
 
-Manual deploy without pushing: `pnpm cms-edit:deploy` (single-site) or `pnpm cms-edit:deploy:<site>` (multi-site) — runs validate, stage, then `vercel deploy --prod` **from the repo root** with `--project <vercel-project>`. Do not `cd cms-edit/host` first (Vercel Root Directory is already `cms-edit/host`).
+Do **not** run `pnpm cms-edit:deploy` or `vercel deploy` after this step.
 
 ### Customers without `cms-edit/host/` in their repo
 
-From `se-core-product`:
-
-```bash
-./scripts/deploy-cms-edit-host.sh \
-  --config <customer-repo>/cms-edit/<site>/project.json \
-  --editor-pack <customer-repo>/cms-edit/<site>/editor-pack \
-  --prod
-```
+Rare layout — coordinate with the repo owner. Agents still must not run deploy scripts unless explicitly asked.
 
 ## Homepage slug reminder