@se-studio/contentful-cms 3.1.3 → 3.1.5
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.
- package/CHANGELOG.md +12 -0
- package/dist/generated/version.d.ts +1 -1
- package/dist/generated/version.js +1 -1
- package/dist/mcp/prompts/onboarding.js +3 -3
- package/dist/mcp/prompts/onboarding.js.map +1 -1
- package/dist/preview/entry-urls.d.ts +1 -0
- package/dist/preview/entry-urls.d.ts.map +1 -1
- package/dist/preview/entry-urls.js +19 -8
- package/dist/preview/entry-urls.js.map +1 -1
- package/docs/editor-tasks/media-reuse-and-upload.md +7 -3
- package/docs/editor-tasks/preview-verify.md +15 -15
- package/docs/editor-tasks/publish-handoff.md +9 -4
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,17 @@
|
|
|
1
1
|
# @se-studio/contentful-cms Changelog
|
|
2
2
|
|
|
3
|
+
## 3.1.5
|
|
4
|
+
|
|
5
|
+
### Patch Changes
|
|
6
|
+
|
|
7
|
+
- Clarify preview URL labels for editors: **Live preview (publish here)** vs **Preview (staging site)**. Sort preview URLs with live preview first. Update task playbooks and MCP prompts to hand off both links after save.
|
|
8
|
+
|
|
9
|
+
## 3.1.4
|
|
10
|
+
|
|
11
|
+
### Patch Changes
|
|
12
|
+
|
|
13
|
+
- Clarify Media entry reuse for `visuals` in task-media-reuse-and-upload (avoid duplicate wrappers on shared composites).
|
|
14
|
+
|
|
3
15
|
## 3.1.3
|
|
4
16
|
|
|
5
17
|
### Patch Changes
|
|
@@ -3,9 +3,9 @@ import { prefixHostedToolDescription } from '../hosted-metadata.js';
|
|
|
3
3
|
const TASKS_PREAMBLE = 'Start by reading customer playbooks: cms_edit ["customer", "tasks-index"]; ' +
|
|
4
4
|
'cms_edit ["customer", "capabilities"]; cms_edit ["customer", "checklist"].\n\n';
|
|
5
5
|
const PREVIEW_AFTER_SAVE = 'After save: cms_edit ["preview", "urls", "<slug>"] (or use session entry id). ' +
|
|
6
|
-
'
|
|
7
|
-
'
|
|
8
|
-
'See task-preview-verify.\n';
|
|
6
|
+
'Give the user **both** links: (1) **Live preview (publish here)** — Contentful in-app preview with the green Publish button; ' +
|
|
7
|
+
'(2) **Preview (staging site)** — full-page staging URL (with bypass params when configured). ' +
|
|
8
|
+
'Also offer **production** (published only). See task-preview-verify and task-publish-handoff.\n';
|
|
9
9
|
function hostedNote(hosted) {
|
|
10
10
|
if (!hosted) {
|
|
11
11
|
return 'Local MCP: use --space when multiple spaces are configured.';
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"onboarding.js","sourceRoot":"","sources":["../../../src/mcp/prompts/onboarding.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AAEpE,MAAM,cAAc,GAClB,6EAA6E;IAC7E,gFAAgF,CAAC;AAEnF,MAAM,kBAAkB,GACtB,gFAAgF;IAChF
|
|
1
|
+
{"version":3,"file":"onboarding.js","sourceRoot":"","sources":["../../../src/mcp/prompts/onboarding.ts"],"names":[],"mappings":"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"}
|
|
@@ -17,6 +17,7 @@ export interface PreviewUrlResult {
|
|
|
17
17
|
showsDrafts: boolean;
|
|
18
18
|
notes?: string;
|
|
19
19
|
}
|
|
20
|
+
export declare function sortPreviewUrlResults(results: PreviewUrlResult[]): PreviewUrlResult[];
|
|
20
21
|
export declare function buildContentfulEntryUrl(spaceId: string, environment: string, entryId: string, options?: {
|
|
21
22
|
focusedField?: string;
|
|
22
23
|
}): string;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"entry-urls.d.ts","sourceRoot":"","sources":["../../src/preview/entry-urls.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,gBAAgB,GACxB,SAAS,GACT,YAAY,GACZ,iBAAiB,GACjB,iBAAiB,GACjB,uBAAuB,CAAC;AAE5B,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,gBAAgB,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,6DAA6D;IAC7D,WAAW,EAAE,OAAO,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAWD,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,GAClC,MAAM,CAMR;AAED;;;GAGG;AACH,wBAAsB,6BAA6B,CACjD,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAaxB;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,GAAG,gBAAgB,EAAE,
|
|
1
|
+
{"version":3,"file":"entry-urls.d.ts","sourceRoot":"","sources":["../../src/preview/entry-urls.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,gBAAgB,GACxB,SAAS,GACT,YAAY,GACZ,iBAAiB,GACjB,iBAAiB,GACjB,uBAAuB,CAAC;AAE5B,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,gBAAgB,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,6DAA6D;IAC7D,WAAW,EAAE,OAAO,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAWD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,gBAAgB,EAAE,CAIrF;AAWD,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,GAClC,MAAM,CAMR;AAED;;;GAGG;AACH,wBAAsB,6BAA6B,CACjD,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAaxB;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,GAAG,gBAAgB,EAAE,CA4DjF;AAED,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,qBAAqB,GAAG;IAAE,eAAe,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1D,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAuB7B"}
|
|
@@ -1,4 +1,15 @@
|
|
|
1
1
|
import { appendRequestParams } from './capture-urls.js';
|
|
2
|
+
/** Preferred order when presenting URLs to editors (publish-first). */
|
|
3
|
+
const PREVIEW_URL_ORDER = [
|
|
4
|
+
'contentfulLivePreview',
|
|
5
|
+
'staging',
|
|
6
|
+
'siteLivePreview',
|
|
7
|
+
'production',
|
|
8
|
+
'contentfulEntry',
|
|
9
|
+
];
|
|
10
|
+
export function sortPreviewUrlResults(results) {
|
|
11
|
+
return [...results].sort((a, b) => PREVIEW_URL_ORDER.indexOf(a.target) - PREVIEW_URL_ORDER.indexOf(b.target));
|
|
12
|
+
}
|
|
2
13
|
function normalizeBaseUrl(url) {
|
|
3
14
|
return url.replace(/\/$/, '');
|
|
4
15
|
}
|
|
@@ -41,10 +52,10 @@ export function buildPreviewUrls(input) {
|
|
|
41
52
|
const stagingUrl = appendRequestParams(`${normalizeBaseUrl(input.devBaseUrl)}${slug === '/' ? '' : slug}`, input.requestParams);
|
|
42
53
|
results.push({
|
|
43
54
|
target: 'staging',
|
|
44
|
-
label: '
|
|
55
|
+
label: 'Preview (staging site)',
|
|
45
56
|
url: stagingUrl,
|
|
46
57
|
showsDrafts: false,
|
|
47
|
-
notes: '
|
|
58
|
+
notes: 'Full-page check on the staging deployment (includes Vercel bypass params when configured). Use alongside Live preview — publish from the Live preview link.',
|
|
48
59
|
});
|
|
49
60
|
}
|
|
50
61
|
if (input.devBaseUrl && input.entryId) {
|
|
@@ -56,10 +67,10 @@ export function buildPreviewUrls(input) {
|
|
|
56
67
|
}
|
|
57
68
|
results.push({
|
|
58
69
|
target: 'siteLivePreview',
|
|
59
|
-
label: '
|
|
70
|
+
label: 'Preview redirect',
|
|
60
71
|
url: `${normalizeBaseUrl(input.devBaseUrl)}/preview?${params.toString()}`,
|
|
61
72
|
showsDrafts: true,
|
|
62
|
-
notes: 'Entry-aware redirect
|
|
73
|
+
notes: 'Entry-aware redirect to the staging path. Alternative to the Preview (staging site) URL when you only have an entry ID.',
|
|
63
74
|
});
|
|
64
75
|
}
|
|
65
76
|
if (input.productionSiteUrl && slug) {
|
|
@@ -79,7 +90,7 @@ export function buildPreviewUrls(input) {
|
|
|
79
90
|
focusedField: input.focusedField,
|
|
80
91
|
}),
|
|
81
92
|
showsDrafts: true,
|
|
82
|
-
notes: '
|
|
93
|
+
notes: 'Classic entry editor. Prefer the Live preview link for reviewing drafts and publishing.',
|
|
83
94
|
});
|
|
84
95
|
}
|
|
85
96
|
return results;
|
|
@@ -91,13 +102,13 @@ export async function buildAllPreviewUrls(input) {
|
|
|
91
102
|
if (livePreviewUrl) {
|
|
92
103
|
results.push({
|
|
93
104
|
target: 'contentfulLivePreview',
|
|
94
|
-
label: '
|
|
105
|
+
label: 'Live preview (publish here)',
|
|
95
106
|
url: livePreviewUrl,
|
|
96
107
|
showsDrafts: true,
|
|
97
|
-
notes: '
|
|
108
|
+
notes: 'Opens Contentful in-app preview editor. Review the draft, then click the green Publish button at the top.',
|
|
98
109
|
});
|
|
99
110
|
}
|
|
100
111
|
}
|
|
101
|
-
return results;
|
|
112
|
+
return sortPreviewUrlResults(results);
|
|
102
113
|
}
|
|
103
114
|
//# sourceMappingURL=entry-urls.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"entry-urls.js","sourceRoot":"","sources":["../../src/preview/entry-urls.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AA6BxD,SAAS,gBAAgB,CAAC,GAAW;IACnC,OAAO,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;AAChC,CAAC;AAED,SAAS,aAAa,CAAC,IAAY;IACjC,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAC;IAClD,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,OAAe,EACf,WAAmB,EACnB,OAAe,EACf,OAAmC;IAEnC,MAAM,IAAI,GAAG,qCAAqC,OAAO,iBAAiB,WAAW,YAAY,OAAO,EAAE,CAAC;IAC3G,IAAI,OAAO,EAAE,YAAY,EAAE,CAAC;QAC1B,OAAO,GAAG,IAAI,iBAAiB,kBAAkB,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;IAC5E,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,6BAA6B,CACjD,OAAe,EACf,WAAmB,EACnB,OAAe,EACf,eAAuB;IAEvB,MAAM,QAAQ,GAAG,qCAAqC,OAAO,iBAAiB,WAAW,YAAY,OAAO,UAAU,CAAC;IACvH,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,QAAQ,EAAE;YAChC,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,eAAe,EAAE,EAAE;SACxD,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,OAAO,IAAI,CAAC;QACzB,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAA2C,CAAC;QAC1E,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,WAAW,CAAC;QACzC,OAAO,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;IACxE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAA4B;IAC3D,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAChE,MAAM,OAAO,GAAuB,EAAE,CAAC;IAEvC,IAAI,KAAK,CAAC,UAAU,IAAI,IAAI,EAAE,CAAC;QAC7B,MAAM,UAAU,GAAG,mBAAmB,CACpC,GAAG,gBAAgB,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,EAClE,KAAK,CAAC,aAAa,CACpB,CAAC;QACF,OAAO,CAAC,IAAI,CAAC;YACX,MAAM,EAAE,SAAS;YACjB,KAAK,EAAE,
|
|
1
|
+
{"version":3,"file":"entry-urls.js","sourceRoot":"","sources":["../../src/preview/entry-urls.ts"],"names":[],"mappings":"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"}
|
|
@@ -23,7 +23,8 @@
|
|
|
23
23
|
- `cms_edit ["asset", "search", "--filename-match", "<partial-name>"]`
|
|
24
24
|
- `cms_edit ["list", "--type", "media", "--asset-filename-match", "<partial>"]`
|
|
25
25
|
3. If match found — link by asset ID or filename in `set` / `create from-json` (`featuredImageAssetFilename`, `visualAssetFilename`, etc.)
|
|
26
|
-
4.
|
|
26
|
+
4. For **`visuals`** (Media entry array): prefer an **existing Media entry** — `cms_edit ["list", "--type", "media", "--asset-id", "<assetId>"]` — then `set @root visuals <mediaEntryId> --links`. Do **not** `create media` or use `asset upload --with-media` when a wrapper already exists.
|
|
27
|
+
5. `create media` only when no Media entry wraps that asset (RTF embeds, or first article in a new composite batch — then **reuse that media ID** on sibling entries)
|
|
27
28
|
|
|
28
29
|
## Upload only when no match
|
|
29
30
|
|
|
@@ -43,12 +44,15 @@ Rules:
|
|
|
43
44
|
- Upload alone does **not** attach the asset — follow with **link + save** (below)
|
|
44
45
|
- Use `--if-exists-by-filename` (with `--file-name`) to avoid duplicate assets when re-running
|
|
45
46
|
|
|
46
|
-
|
|
47
|
+
After staged upload, create a Media wrapper **only when none exists** for that asset:
|
|
47
48
|
|
|
48
49
|
```
|
|
49
|
-
cms_edit ["
|
|
50
|
+
cms_edit ["list", "--type", "media", "--asset-id", "<newPortraitAssetId>"]
|
|
51
|
+
cms_edit ["create", "media", "--asset-id", "<newPortraitAssetId>", "--name", "…"]
|
|
50
52
|
```
|
|
51
53
|
|
|
54
|
+
Avoid `asset upload --with-media` when multiple entries will share the same image (e.g. news composites) — it creates duplicate Media entries. Upload the asset only, then one shared `create media`, then link the media ID on each entry.
|
|
55
|
+
|
|
52
56
|
**Last resort `--url`** only when the file is already on public HTTPS and staged upload is impractical:
|
|
53
57
|
|
|
54
58
|
```
|
|
@@ -19,16 +19,15 @@ Always available.
|
|
|
19
19
|
|
|
20
20
|
## Preview targets
|
|
21
21
|
|
|
22
|
-
After saving a draft, agents should
|
|
22
|
+
After saving a draft, agents should return **all applicable URLs** and explain which to use when.
|
|
23
23
|
|
|
24
|
-
| Target |
|
|
25
|
-
|
|
26
|
-
| **
|
|
27
|
-
| **
|
|
28
|
-
| **
|
|
29
|
-
| **
|
|
30
|
-
| **
|
|
31
|
-
| **Contentful live preview** | Included in `preview urls` when available | In-app iframe preview with inspector (ephemeral token from Contentful API) |
|
|
24
|
+
| Target | Label | When to use |
|
|
25
|
+
|--------|-------|-------------|
|
|
26
|
+
| **contentfulLivePreview** | Live preview (publish here) | **Primary for editors.** Opens `app.contentful.com/.../entries/.../preview/...` — in-app preview with inspector. User clicks the green **Publish** button at the top to go live. |
|
|
27
|
+
| **staging** | Preview (staging site) | Full-page check on staging, e.g. `{devBaseUrl}/resources/news/{tag}/{slug}/` (includes Vercel bypass params when configured). |
|
|
28
|
+
| **siteLivePreview** | Preview redirect | `{devBaseUrl}/preview?id={entryId}` — entry-aware redirect to the staging path. |
|
|
29
|
+
| **production** | Production site | Published content only — compare after publish. |
|
|
30
|
+
| **contentfulEntry** | Contentful entry editor | Classic entry form. Prefer **Live preview** for review and publish. |
|
|
32
31
|
|
|
33
32
|
## Steps
|
|
34
33
|
|
|
@@ -42,11 +41,11 @@ After saving a draft, agents should offer **all applicable URLs** and open the b
|
|
|
42
41
|
```
|
|
43
42
|
Use `--json` for machine-readable output.
|
|
44
43
|
|
|
45
|
-
2. **
|
|
44
|
+
2. **Hand off to the editor with both links:**
|
|
45
|
+
- **Live preview** — for reviewing the draft and publishing (green Publish button in Contentful).
|
|
46
|
+
- **Preview (staging site)** — for a full-screen check on the staging deployment.
|
|
46
47
|
|
|
47
|
-
3.
|
|
48
|
-
|
|
49
|
-
4. Summarize what to check (headings, CTAs, images, template blocks) before publish handoff.
|
|
48
|
+
3. Summarize what to check (headings, CTAs, images, template blocks) before publish handoff.
|
|
50
49
|
|
|
51
50
|
### Legacy single URL
|
|
52
51
|
|
|
@@ -54,7 +53,7 @@ After saving a draft, agents should offer **all applicable URLs** and open the b
|
|
|
54
53
|
cms_edit ["preview", "url", "--page-slug", "<slug>"]
|
|
55
54
|
```
|
|
56
55
|
|
|
57
|
-
|
|
56
|
+
Returns the staging preview path only.
|
|
58
57
|
|
|
59
58
|
## Confirmation gates
|
|
60
59
|
|
|
@@ -64,9 +63,10 @@ Still valid for staging-only checks.
|
|
|
64
63
|
|
|
65
64
|
## Out of scope
|
|
66
65
|
|
|
67
|
-
- Publish
|
|
66
|
+
- Publish (human uses Live preview → Publish button)
|
|
68
67
|
|
|
69
68
|
## Related resources
|
|
70
69
|
|
|
71
70
|
- `cms-edit://customer/overview`
|
|
71
|
+
- `cms-edit://customer/task-publish-handoff`
|
|
72
72
|
- `cms-edit://customer/production-site`
|
|
@@ -18,14 +18,18 @@ Always available.
|
|
|
18
18
|
## Handoff steps
|
|
19
19
|
|
|
20
20
|
1. Ensure all edits are saved (`diff` was reviewed)
|
|
21
|
-
2.
|
|
22
|
-
3.
|
|
23
|
-
|
|
21
|
+
2. Run `cms_edit ["preview", "urls", "<slug>"]` (or use session entry id after save)
|
|
22
|
+
3. Give the user **both** links:
|
|
23
|
+
- **Live preview (publish here)** — `app.contentful.com/.../entries/.../preview/...` — open this to review and click the green **Publish** button at the top
|
|
24
|
+
- **Preview (staging site)** — full staging URL for a full-page check (optional)
|
|
25
|
+
4. Tell the user which entry was changed (title, slug, CMS label)
|
|
26
|
+
5. Remind them: production URL updates 1–3 minutes after publish
|
|
24
27
|
|
|
25
28
|
## Confirmation gates
|
|
26
29
|
|
|
27
30
|
1. Never claim changes are live until a human publishes
|
|
28
|
-
2.
|
|
31
|
+
2. Always include the **Live preview** link when `contentfulLivePreview` is available
|
|
32
|
+
3. List draft entries awaiting publish
|
|
29
33
|
|
|
30
34
|
## Out of scope
|
|
31
35
|
|
|
@@ -33,4 +37,5 @@ Always available.
|
|
|
33
37
|
|
|
34
38
|
## Related resources
|
|
35
39
|
|
|
40
|
+
- `cms-edit://customer/task-preview-verify`
|
|
36
41
|
- `cms-edit://customer/overview`
|