@cmssy/cli 0.22.3 → 0.22.4
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.
|
@@ -76,7 +76,9 @@ All block content MUST be keyed by the workspace's enabled language codes (see R
|
|
|
76
76
|
|
|
77
77
|
Layout blocks (header, footer) live in `layoutBlocks` on a page, not in `blocks`. They use the same `update_block_content` tool and the same language-keyed content structure - with the exact same language codes from `enabledLanguages`.
|
|
78
78
|
|
|
79
|
-
|
|
79
|
+
> **Field names are NOT universal - they depend on the workspace's actual header/footer block.** Always inspect the real block with `get_page` before editing. The lists below are the **default cmssy theme**; a custom layout block may use entirely different keys (e.g. `brand`, `links[].label`, `phones[].number`, `email` instead of `navigation[]`/`ctaLabel`/`linkColumns[]`).
|
|
80
|
+
|
|
81
|
+
### Header translatable fields (default theme - verify with `get_page`)
|
|
80
82
|
|
|
81
83
|
- `navigation[].label` - top-level nav labels
|
|
82
84
|
- `navigation[].children[].label` - submenu item labels
|
|
@@ -85,7 +87,7 @@ Layout blocks (header, footer) live in `layoutBlocks` on a page, not in `blocks`
|
|
|
85
87
|
- `announcementText` - announcement bar text
|
|
86
88
|
- `logoutButtonText` - logout button
|
|
87
89
|
|
|
88
|
-
### Footer translatable fields
|
|
90
|
+
### Footer translatable fields (default theme - verify with `get_page`)
|
|
89
91
|
|
|
90
92
|
- `tagline` - site tagline
|
|
91
93
|
- `linkColumns[].title` - column headings
|
|
@@ -127,7 +129,8 @@ Layout blocks (header, footer) live in `layoutBlocks` on a page, not in `blocks`
|
|
|
127
129
|
## Rule 5: Publishing workflow
|
|
128
130
|
|
|
129
131
|
- `update_block_content` creates unpublished changes (draft)
|
|
130
|
-
-
|
|
132
|
+
- `patch_block_content` does the same via surgical HTML edits (insert_before/insert_after/replace_section) - prefer it for large docs-style content bodies (~10x cheaper, rejects ambiguous/missing markers). Only works on language-keyed content (`content[locale]`); flat content must be restructured with `update_block_content` first.
|
|
133
|
+
- Use `publish_page` to make changes live - it publishes **both content and layout axes** (split per-axis since CMS-628). `hasUnpublishedContentChanges` and `hasUnpublishedLayoutChanges` track the two axes separately.
|
|
131
134
|
- Use `revert_to_published` to discard draft changes
|
|
132
135
|
- Always inform the user about unpublished state after edits
|
|
133
136
|
|
|
@@ -135,31 +138,32 @@ Layout blocks (header, footer) live in `layoutBlocks` on a page, not in `blocks`
|
|
|
135
138
|
|
|
136
139
|
## Rule 6: Available MCP tools quick reference
|
|
137
140
|
|
|
138
|
-
| Tool | Use for
|
|
139
|
-
| --------------------------------------- |
|
|
140
|
-
| `get_site_config` | **Languages**, site name, features
|
|
141
|
-
| `get_workspace_info` | Plan, limits, usage
|
|
142
|
-
| `list_pages` | Browse/search pages
|
|
143
|
-
| `get_page` | Full page with blocks and content
|
|
144
|
-
| `create_page` | New page
|
|
145
|
-
| `update_page_settings` | SEO, displayName, description
|
|
146
|
-
| `update_block_content` | Edit block content (page or layout)
|
|
147
|
-
| `
|
|
148
|
-
| `
|
|
149
|
-
| `
|
|
150
|
-
| `
|
|
151
|
-
| `
|
|
152
|
-
| `
|
|
153
|
-
| `
|
|
154
|
-
| `
|
|
155
|
-
| `
|
|
156
|
-
| `
|
|
157
|
-
| `
|
|
158
|
-
| `
|
|
159
|
-
| `
|
|
160
|
-
| `
|
|
161
|
-
| `
|
|
162
|
-
| `
|
|
141
|
+
| Tool | Use for |
|
|
142
|
+
| --------------------------------------- | -------------------------------------------------------------------------- |
|
|
143
|
+
| `get_site_config` | **Languages**, site name, features |
|
|
144
|
+
| `get_workspace_info` | Plan, limits, usage |
|
|
145
|
+
| `list_pages` | Browse/search pages |
|
|
146
|
+
| `get_page` | Full page with blocks and content |
|
|
147
|
+
| `create_page` | New page |
|
|
148
|
+
| `update_page_settings` | SEO, displayName, description |
|
|
149
|
+
| `update_block_content` | Edit block content (page or layout) |
|
|
150
|
+
| `patch_block_content` | Surgical HTML edits to a localized content body (insert/replace by marker) |
|
|
151
|
+
| `add_block_to_page` | Add new block |
|
|
152
|
+
| `remove_block_from_page` | Remove block |
|
|
153
|
+
| `update_page_blocks` | Reorder blocks |
|
|
154
|
+
| `update_page_layout` | Change layout blocks |
|
|
155
|
+
| `publish_page` / `unpublish_page` | Publishing |
|
|
156
|
+
| `list_block_types` / `get_block_schema` | Discover available blocks |
|
|
157
|
+
| `list_media` | Browse uploaded media |
|
|
158
|
+
| `list_forms` | Browse forms (filter by status) |
|
|
159
|
+
| `get_form` | Full form with fields, settings, i18n |
|
|
160
|
+
| `create_form` | New form with fields and settings |
|
|
161
|
+
| `update_form` | Edit form name, fields, settings, status |
|
|
162
|
+
| `delete_form` | Delete form and all submissions |
|
|
163
|
+
| `list_form_submissions` | Browse submissions (filter by form/status) |
|
|
164
|
+
| `get_form_submission` | Full submission details |
|
|
165
|
+
| `update_form_submission_status` | Change status (pending/processed/spam/archived) |
|
|
166
|
+
| `delete_form_submission` | Delete a submission |
|
|
163
167
|
|
|
164
168
|
---
|
|
165
169
|
|