@se-studio/contentful-cms 3.12.0 → 3.13.0

package/docs/help/index.md

@@ -19,6 +19,7 @@ Available topics for `cms-edit help <topic>`:
 |---|---|
 | `workflow` | Standard editing workflow — open, snapshot, edit, save |
 | `create-from-json` | Create a new page or article from a JSON file (single-shot) |
+| `create-editor-entries` | Create banners, page variants, page tests, and custom types |
 | `taxonomy-from-json` | Batch-create tagType, articleType, and tag entries from JSON |
 | `person-from-json` | Batch-create person/author entries from JSON |
 | `article-tags-from-json` | Set tags on multiple articles from JSON |
@@ -81,7 +82,7 @@ cms-edit batch run --json '[...]'
 
 ### Navigation & Discovery
 
-**Content discovery** uses the local catalog index (`index sync`) and `list --type <type>`. Catalog types: `page`, `article`, `pageVariant`, `template`, `articleType`, `tagType`, `tag`, `navigation`, `navigationItem`. Other types (e.g. `person`, `customType`, `pageTest`): `list --type <type> --force-cma`.
+**Content discovery** uses the local catalog index (`index sync`) and `list --type <type>`. Catalog types: `page`, `article`, `pageVariant`, `template`, `articleType`, `tagType`, `tag`, `navigation`, `navigationItem`, `banner`, `pageTest`, `customType`. Other types (e.g. `person`): `list --type <type>` via the Contentful API.
 
 | Command | Description |
 |---|---|
@@ -141,6 +142,10 @@ cms-edit batch run --json '[...]'
 | `create tag` | Create a tag entry (draft) |
 | `create page` | Create a blank page interactively |
 | `create article` | Create a blank article interactively |
+| `create banner` | Create a site banner (draft) |
+| `create page-variant` | Create a page variant and open it |
+| `create page-test` | Create a page test (draft) |
+| `create custom-type` | Create a custom type and open it |
 
 ### Batch Operations
 | Command | Description |

package/docs/help/lookup.md

@@ -67,6 +67,20 @@ cms-edit list --type article --article-type-name "Publications"
 | `--page-variant-title` | `title` |
 | `--page-variant-cms-label` | `cmsLabel` |
 
+## Banners, page tests, custom types
+
+| Flag | Contentful field |
+|------|------------------|
+| `--banner-label` | `banner.cmsLabel` |
+| `--page-test-label` | `pageTest.cmsLabel` |
+| `--custom-type-slug` | `customType.slug` |
+| `--custom-type-name` | `customType.name` |
+
+```bash
+cms-edit open --banner-label "Spring promo"
+cms-edit open --custom-type-slug people
+```
+
 ## Taxonomy
 
 | Type | Slug | Name | cmsLabel |

package/docs/help/person-from-json.md

@@ -37,7 +37,8 @@ All entries are created as **drafts**. Nothing is published automatically.
 | Key | Required | Description |
 |---|---|---|
 | `slug` | Yes | URL slug |
-| `name` | Yes | Display name |
+| `name` | Yes | Display name and on-page heading. Document `<title>` uses this when `metaTitle` is empty |
+| `metaTitle` | No | Optional search-result title. Pass it in `fields`. Does not change the on-page heading |
 | `cmsLabel` | No | CMS label (defaults to `name`) |
 | `jobTitle` | No | Job title (CLI flags override JSON `fields` on single-entry create) |
 | `description` | No | Short description |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@se-studio/contentful-cms",
-  "version": "3.12.0",
+  "version": "3.13.0",
   "description": "CLI tool for AI agents to read and edit Contentful draft content without publish permissions",
   "repository": {
     "type": "git",

package/skills/core/SKILL.md

@@ -456,9 +456,19 @@ cms-edit create taxonomy-from-json --json '{"tagTypes":[...]}' --if-not-exists
 cms-edit create tag-type --slug conference-venue --name "Conference Venue" --if-not-exists
 cms-edit create tag --slug asco-2025 --name "ASCO 2025" --tag-type conference-venue \
   --description "Annual ASCO conference." --featured-image <logoAssetId> --if-not-exists
+
+# Site-wide and routing entries (drafts). See cms-edit help create-editor-entries.
+cms-edit create banner --cms-label "Spring promo" --message "Free delivery this week"
+cms-edit create page-test --cms-label "Home hero test" --control <pageId> --variant <pageVariantId>
+cms-edit create page-variant --cms-label "Home B" --slug home-b --original-page /
+cms-edit create custom-type --cms-label "People" --name "People" --slug people \
+  --index-page-name "Team" --index-page-title "Team" --index-page-description "The team" \
+  --featured-image <assetId>
 ```
 
-See `cms-edit help fields-taxonomy` and `cms-edit help taxonomy-from-json` for field reference and batch schema.
+`create page-variant` and `create custom-type` open a session. Banner and page test do not. On an open page variant, the only `add` content type is `alternatePageContent` (`--source-id` required, optional `--replacement-id`). That content type is refused on a page or article, and a component is refused on a page variant.
+
+See `cms-edit help fields-taxonomy`, `cms-edit help taxonomy-from-json`, and `cms-edit help create-editor-entries`.
 
 ## Person entries
 
@@ -839,7 +849,7 @@ cms-edit resolve 4xKj2abcDef
 
 ## Inventory & Status
 
-Use `list --type <type>` for inventory. Catalog types (page, article, pageVariant, template, taxonomy, navigation) use the local index. Use `--force-cma` for other types (person, customType, pageTest) or published-only with `--published`.
+Use `list --type <type>` for inventory. Catalog types (page, article, pageVariant, template, taxonomy, navigation, banner, pageTest, customType) use the local index after `index sync`. Use `--force-cma` for types still outside the catalog (person) or published-only with `--published`.
 
 ```bash
 cms-edit list --type page