@se-studio/contentful-cms 1.0.19 → 1.0.21

package/dist/session/store.js

@@ -2,8 +2,33 @@ import * as fs from 'node:fs';
 import * as os from 'node:os';
 import * as path from 'node:path';
 const SESSIONS_DIR = path.join(os.homedir(), '.contentful-cms', 'sessions');
-function getSessionPath(spaceId, rootEntryId) {
-    return path.join(SESSIONS_DIR, `${spaceId}-${rootEntryId}.json`);
+/**
+ * Returns the name of the active session from CLI options or the CONTENTFUL_CMS_SESSION env var.
+ * Used by all commands to support named, isolated sessions (--session <name>).
+ */
+export function resolveSessionName(cliName) {
+    return cliName ?? process.env['CONTENTFUL_CMS_SESSION'] ?? undefined;
+}
+function getSessionPath(spaceId, rootEntryId, sessionName) {
+    const suffix = sessionName ? `-${sessionName}` : '';
+    return path.join(SESSIONS_DIR, `${spaceId}-${rootEntryId}${suffix}.json`);
+}
+/**
+ * Returns the path to the most recently modified session file whose name contains the given
+ * session name suffix, if any. Used when only --session is given without spaceId/rootEntryId.
+ */
+function findNamedSessionPath(sessionName) {
+    if (!fs.existsSync(SESSIONS_DIR))
+        return null;
+    const suffix = `-${sessionName}.json`;
+    const files = fs.readdirSync(SESSIONS_DIR).filter((f) => f.endsWith(suffix));
+    if (files.length === 0)
+        return null;
+    const sorted = files
+        .map((f) => ({ file: f, mtime: fs.statSync(path.join(SESSIONS_DIR, f)).mtime }))
+        .sort((a, b) => b.mtime.getTime() - a.mtime.getTime());
+    const latest = sorted[0];
+    return latest ? path.join(SESSIONS_DIR, latest.file) : null;
 }
 /** Returns the path to the most recently modified session file, if any. */
 function findLatestSessionPath() {
@@ -18,8 +43,13 @@ function findLatestSessionPath() {
     const latest = sorted[0];
     return latest ? path.join(SESSIONS_DIR, latest.file) : null;
 }
-export function loadSession(spaceId, rootEntryId) {
-    const sessionPath = spaceId && rootEntryId ? getSessionPath(spaceId, rootEntryId) : findLatestSessionPath();
+export function loadSession(spaceId, rootEntryId, sessionName) {
+    const resolvedName = resolveSessionName(sessionName);
+    const sessionPath = spaceId && rootEntryId
+        ? getSessionPath(spaceId, rootEntryId, resolvedName)
+        : resolvedName
+            ? findNamedSessionPath(resolvedName)
+            : findLatestSessionPath();
     if (!sessionPath || !fs.existsSync(sessionPath))
         return null;
     try {
@@ -29,13 +59,15 @@ export function loadSession(spaceId, rootEntryId) {
         return null;
     }
 }
-export function saveSession(state) {
+export function saveSession(state, sessionName) {
     fs.mkdirSync(SESSIONS_DIR, { recursive: true });
-    const sessionPath = getSessionPath(state.spaceId, state.rootEntryId);
+    const resolvedName = resolveSessionName(sessionName);
+    const sessionPath = getSessionPath(state.spaceId, state.rootEntryId, resolvedName);
     fs.writeFileSync(sessionPath, JSON.stringify(state, null, 2), 'utf-8');
 }
-export function clearSession(spaceId, rootEntryId) {
-    const sessionPath = getSessionPath(spaceId, rootEntryId);
+export function clearSession(spaceId, rootEntryId, sessionName) {
+    const resolvedName = resolveSessionName(sessionName);
+    const sessionPath = getSessionPath(spaceId, rootEntryId, resolvedName);
     if (fs.existsSync(sessionPath)) {
         fs.unlinkSync(sessionPath);
     }
@@ -51,11 +83,14 @@ export function clearAllSessions() {
 }
 /**
  * Loads the active session or throws a helpful error if none exists.
+ * Pass `sessionName` (or set CONTENTFUL_CMS_SESSION) to target a named session.
  */
-export function requireSession() {
-    const session = loadSession();
+export function requireSession(sessionName) {
+    const session = loadSession(undefined, undefined, sessionName);
     if (!session) {
-        throw new Error("No active session. Run 'cms-edit open <slug>' or 'cms-edit open <id> --id' first.");
+        const nameHint = resolveSessionName(sessionName);
+        const hint = nameHint ? ` (session: ${nameHint})` : '';
+        throw new Error(`No active session${hint}. Run 'cms-edit open <slug>' or 'cms-edit open <id> --id' first.`);
     }
     return session;
 }

package/dist/session/store.js.map

@@ -1 +1 @@
-{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/session/store.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/session/store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAGlC,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,iBAAiB,EAAE,UAAU,CAAC,CAAC;AAE5E;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAgB;IACjD,OAAO,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,IAAI,SAAS,CAAC;AACvE,CAAC;AAED,SAAS,cAAc,CAAC,OAAe,EAAE,WAAmB,EAAE,WAAoB;IAChF,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,IAAI,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACpD,OAAO,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,GAAG,OAAO,IAAI,WAAW,GAAG,MAAM,OAAO,CAAC,CAAC;AAC5E,CAAC;AAED;;;GAGG;AACH,SAAS,oBAAoB,CAAC,WAAmB;IAC/C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9C,MAAM,MAAM,GAAG,IAAI,WAAW,OAAO,CAAC;IACtC,MAAM,KAAK,GAAG,EAAE,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IAC7E,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACpC,MAAM,MAAM,GAAG,KAAK;SACjB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;SAC/E,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IACzD,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IACzB,OAAO,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC9D,CAAC;AAED,2EAA2E;AAC3E,SAAS,qBAAqB;IAC5B,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9C,MAAM,KAAK,GAAG,EAAE,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;IAC9E,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACpC,MAAM,MAAM,GAAG,KAAK;SACjB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;SAC/E,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IACzD,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IACzB,OAAO,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,WAAW,CACzB,OAAgB,EAChB,WAAoB,EACpB,WAAoB;IAEpB,MAAM,YAAY,GAAG,kBAAkB,CAAC,WAAW,CAAC,CAAC;IACrD,MAAM,WAAW,GACf,OAAO,IAAI,WAAW;QACpB,CAAC,CAAC,cAAc,CAAC,OAAO,EAAE,WAAW,EAAE,YAAY,CAAC;QACpD,CAAC,CAAC,YAAY;YACZ,CAAC,CAAC,oBAAoB,CAAC,YAAY,CAAC;YACpC,CAAC,CAAC,qBAAqB,EAAE,CAAC;IAChC,IAAI,CAAC,WAAW,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC;QAAE,OAAO,IAAI,CAAC;IAC7D,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAiB,CAAC;IAC3E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAmB,EAAE,WAAoB;IACnE,EAAE,CAAC,SAAS,CAAC,YAAY,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD,MAAM,YAAY,GAAG,kBAAkB,CAAC,WAAW,CAAC,CAAC;IACrD,MAAM,WAAW,GAAG,cAAc,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;IACnF,EAAE,CAAC,aAAa,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAe,EAAE,WAAmB,EAAE,WAAoB;IACrF,MAAM,YAAY,GAAG,kBAAkB,CAAC,WAAW,CAAC,CAAC;IACrD,MAAM,WAAW,GAAG,cAAc,CAAC,OAAO,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC;IACvE,IAAI,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC/B,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;IAC7B,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC;QAAE,OAAO;IACzC,KAAK,MAAM,IAAI,IAAI,EAAE,CAAC,WAAW,CAAC,YAAY,CAAC,EAAE,CAAC;QAChD,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YAC3B,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,WAAoB;IACjD,MAAM,OAAO,GAAG,WAAW,CAAC,SAAS,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;IAC/D,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,QAAQ,GAAG,kBAAkB,CAAC,WAAW,CAAC,CAAC;QACjD,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,cAAc,QAAQ,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QACvD,MAAM,IAAI,KAAK,CACb,oBAAoB,IAAI,kEAAkE,CAC3F,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/telemetry/index.d.ts

@@ -0,0 +1,10 @@
+import type { TelemetryWriter } from './types.js';
+export { LocalFileTelemetryWriter } from './local.js';
+export type { TelemetryEvent, TelemetryWriter } from './types.js';
+/**
+ * Returns the default telemetry writer for this environment.
+ * Currently always returns a LocalFileTelemetryWriter.
+ * Swap this factory to switch to a remote sink in the future.
+ */
+export declare function createTelemetryWriter(): TelemetryWriter;
+//# sourceMappingURL=index.d.ts.map

package/dist/telemetry/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/telemetry/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,OAAO,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AACtD,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElE;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,eAAe,CAEvD"}

package/dist/telemetry/index.js

@@ -0,0 +1,11 @@
+import { LocalFileTelemetryWriter } from './local.js';
+export { LocalFileTelemetryWriter } from './local.js';
+/**
+ * Returns the default telemetry writer for this environment.
+ * Currently always returns a LocalFileTelemetryWriter.
+ * Swap this factory to switch to a remote sink in the future.
+ */
+export function createTelemetryWriter() {
+    return new LocalFileTelemetryWriter();
+}
+//# sourceMappingURL=index.js.map

package/dist/telemetry/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/telemetry/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAGtD,OAAO,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAGtD;;;;GAIG;AACH,MAAM,UAAU,qBAAqB;IACnC,OAAO,IAAI,wBAAwB,EAAE,CAAC;AACxC,CAAC"}

package/dist/telemetry/local.d.ts

@@ -0,0 +1,9 @@
+import type { TelemetryEvent, TelemetryWriter } from './types.js';
+/**
+ * Appends telemetry events as newline-delimited JSON to ~/.contentful-cms/telemetry.log.
+ * Errors are silently swallowed so telemetry never affects CLI behaviour.
+ */
+export declare class LocalFileTelemetryWriter implements TelemetryWriter {
+    record(event: TelemetryEvent): void;
+}
+//# sourceMappingURL=local.d.ts.map

package/dist/telemetry/local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local.d.ts","sourceRoot":"","sources":["../../src/telemetry/local.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAIlE;;;GAGG;AACH,qBAAa,wBAAyB,YAAW,eAAe;IAC9D,MAAM,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;CASpC"}

package/dist/telemetry/local.js

@@ -0,0 +1,21 @@
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+const LOG_PATH = path.join(os.homedir(), '.contentful-cms', 'telemetry.log');
+/**
+ * Appends telemetry events as newline-delimited JSON to ~/.contentful-cms/telemetry.log.
+ * Errors are silently swallowed so telemetry never affects CLI behaviour.
+ */
+export class LocalFileTelemetryWriter {
+    record(event) {
+        try {
+            const dir = path.dirname(LOG_PATH);
+            fs.mkdirSync(dir, { recursive: true });
+            fs.appendFileSync(LOG_PATH, JSON.stringify(event) + '\n', 'utf-8');
+        }
+        catch {
+            // Intentionally swallowed — telemetry must not break the CLI
+        }
+    }
+}
+//# sourceMappingURL=local.js.map

package/dist/telemetry/local.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local.js","sourceRoot":"","sources":["../../src/telemetry/local.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAGlC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,iBAAiB,EAAE,eAAe,CAAC,CAAC;AAE7E;;;GAGG;AACH,MAAM,OAAO,wBAAwB;IACnC,MAAM,CAAC,KAAqB;QAC1B,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YACnC,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACvC,EAAE,CAAC,cAAc,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;QACrE,CAAC;QAAC,MAAM,CAAC;YACP,6DAA6D;QAC/D,CAAC;IACH,CAAC;CACF"}

package/dist/telemetry/types.d.ts

@@ -0,0 +1,29 @@
+/**
+ * A single telemetry event recording one CLI command invocation.
+ * No PII is stored: no slugs, entry IDs, field values, query text, or replacement strings.
+ */
+export interface TelemetryEvent {
+    /** ISO 8601 timestamp of when the command completed. */
+    timestamp: string;
+    /** Top-level command name (e.g. "rtf", "open", "save"). */
+    command: string;
+    /** Subcommand name when applicable (e.g. "replace", "embed", "headings"). */
+    subcommand?: string;
+    /** Whether the command succeeded, errored, or exited (process.exit called). */
+    outcome: 'success' | 'error' | 'exit';
+    /** Process exit code (populated for 'exit' outcome). */
+    exit_code?: number;
+    /** Error constructor name only — NOT the message, to avoid logging PII. */
+    error_name?: string;
+    /** Wall-clock duration from command start to completion in milliseconds. */
+    duration_ms: number;
+}
+/**
+ * Abstraction for telemetry sinks. Swap out LocalFileTelemetryWriter for a remote
+ * implementation in the future without changing call sites.
+ */
+export interface TelemetryWriter {
+    record(event: TelemetryEvent): void;
+    flush?(): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/telemetry/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/telemetry/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,wDAAwD;IACxD,SAAS,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,OAAO,EAAE,MAAM,CAAC;IAChB,6EAA6E;IAC7E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+EAA+E;IAC/E,OAAO,EAAE,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;IACtC,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2EAA2E;IAC3E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4EAA4E;IAC5E,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAAC;IACpC,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB"}

package/dist/telemetry/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/telemetry/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/telemetry/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@se-studio/contentful-cms",
-  "version": "1.0.19",
+  "version": "1.0.21",
   "description": "CLI tool for AI agents to read and edit Contentful draft content without publish permissions",
   "repository": {
     "type": "git",
@@ -28,15 +28,15 @@
   "dependencies": {
     "@contentful/rich-text-types": "^17.2.5",
     "commander": "^14.0.3",
-    "contentful-management": "^11.75.0",
+    "contentful-management": "^12.0.0",
     "dotenv": "^17.3.1",
     "picocolors": "^1.1.1"
   },
   "devDependencies": {
-    "@biomejs/biome": "^2.4.8",
+    "@biomejs/biome": "^2.4.9",
     "@types/node": "^22.19.15",
     "typescript": "^6.0.2",
-    "vitest": "^4.1.1"
+    "vitest": "^4.1.2"
   },
   "keywords": [
     "contentful",

package/skills/core/SKILL.md

@@ -48,6 +48,8 @@ cms-edit open 4xKj2abcDef --id
 cms-edit open /
 ```
 
+**Slug `open`:** matches **page**, **article**, **articleType**, and **tag** by `fields.slug` (in that order; first match wins). For **template** or **navigation**, use `open <id> --id` or `cms-edit nav open`.
+
 ### Step 2: Read the snapshot
 
 ```bash
@@ -510,6 +512,88 @@ cms-edit screenshot @c0 --out after.png
 agent-browser diff screenshot --baseline before.png after.png
 ```
 
+## Revert
+
+Field-level undo — restore fields to their original values from when the session was opened.
+
+```bash
+cms-edit revert @c0 heading       # Revert a single field to its original value
+cms-edit revert @c0               # Revert all fields on an entry
+cms-edit revert --all             # Revert all modified entries (session stays open)
+```
+
+Note: Entries created via `add` cannot be reverted — use `remove` instead.
+
+## Health Check
+
+Validate config and connectivity before running a workflow.
+
+```bash
+cms-edit health   # Check config file, space config, Contentful connectivity, agent-browser
+```
+
+## Schema Inspection
+
+Inspect field definitions for a content type. Prefer this over `cms-edit types <ct>` when you need full field info.
+
+```bash
+cms-edit schema component         # Show all fields, types, enum values, link targets
+cms-edit schema component --json  # Full JSON output
+```
+
+## Sitemap
+
+Browse all pages in the space.
+
+```bash
+cms-edit sitemap                         # All pages, sorted by slug
+cms-edit sitemap --prefix /blog          # Filter by slug prefix
+cms-edit sitemap --status draft          # Draft pages only
+cms-edit sitemap --sort updated          # Most recently updated first
+cms-edit sitemap --tree                  # Tree rendering
+cms-edit sitemap --include page,article  # Include articles too
+```
+
+## Peek
+
+Inspect a page without affecting your active session.
+
+```bash
+cms-edit peek /pricing   # Show snapshot of /pricing; your active session is unchanged
+cms-edit peek <id> --id  # Look up by entry ID
+```
+
+## Batch Operations (run)
+
+Run a sequence of operations from a JSON file or stdin.
+
+```bash
+cms-edit run --file ops.json            # Run batch ops from file
+echo '[...]' | cms-edit run             # Pipe from stdin
+cms-edit run --file ops.json --dry-run  # Validate without saving
+```
+
+Supported ops: `open`, `set`, `rtf`, `rtf-replace`, `save`.
+
+Example `ops.json`:
+```json
+[
+  { "cmd": "open", "args": ["/pricing"] },
+  { "cmd": "set", "args": ["@c0", "heading", "New Heading"] },
+  { "cmd": "rtf", "args": ["@c1", "body", "## Section\n\nContent here."] },
+  { "cmd": "save" }
+]
+```
+
+## Concurrent Sessions
+
+Use `--session <name>` or `CONTENTFUL_CMS_SESSION=<name>` to isolate parallel workflows.
+
+```bash
+cms-edit --session agent-1 open /pricing
+cms-edit --session agent-2 open /blog
+```
+
 ## Related skills
 
 For templates see the **templates** skill; for navigation see the **navigation** skill; for rich text and embeds see the **rich-text** skill; for screenshots see the **screenshots** skill.

package/skills/rich-text/SKILL.md

@@ -18,6 +18,69 @@ Use **set** for scalar and link fields; use **rtf** only for rich text fields.
 
 Editing or moving existing embeds is **not supported in v1**.
 
+## rtf replace — additional flags
+
+These flags provide finer control when using `rtf replace`:
+
+| Flag | Description |
+|------|-------------|
+| `--find-plain <text>` | Alias for `--find`; treats the search string as literal text (use when the string contains `*`) |
+| `--ignore-marks` | Match across adjacent bold/plain splits within the same block node |
+| `--protect-pattern <regex>` | Skip matches that fall inside spans matching this regex (e.g. existing quidget tokens) |
+| `--dry-run` | Count matches without writing any changes |
+| `--in-table-row <n>` | Restrict matches to row N (1-indexed; row 1 = header) |
+| `--in-row-containing <text>` | Restrict to rows where any cell contains this text |
+| `--in-col-containing <text>` | Restrict to the column whose header cell contains this text |
+
+Example — replace a value only in the column whose header contains "CSP":
+```bash
+cms-edit rtf replace @c1 body \
+  --find 'None' \
+  --replace-plain '{*credit_card_id*:*5048345*,*field*:*foreign_transaction_fee*,*api*:*cc*}' \
+  --in-col-containing 'CSP' \
+  --mode all
+```
+
+## rtf patch — JSON batch find/replace
+
+Apply multiple find/replace operations in a single call. All ops are validated before any write.
+
+```bash
+# From file
+cms-edit rtf patch @c0 body --file patch.json
+
+# From stdin
+echo '[{"find":"old","replaceWith":"new","mode":"exactlyOne"}]' | cms-edit rtf patch @c0 body
+```
+
+Each op in the JSON array supports:
+
+| Key | Required | Description |
+|-----|----------|-------------|
+| `find` | yes | Search string (Markdown-interpreted) |
+| `replaceWith` | yes | Replacement string (Markdown-interpreted unless `replaceIsMarkdown: false`) |
+| `replaceIsMarkdown` | no | Set to `false` to treat `replaceWith` as plain text (like `--replace-plain`) |
+| `mode` | no | `"exactlyOne"` (default), `"all"`, `"first"` |
+| `ignoreMarks` | no | Match across adjacent bold/plain splits |
+| `inTableCol` | no | Restrict to column N (1-indexed) |
+| `inTableRow` | no | Restrict to row N (1-indexed) |
+| `inRowContaining` | no | Restrict to rows where any cell contains this text |
+| `inColContaining` | no | Restrict to the column whose header cell contains this text |
+| `section` | no | Restrict to a document section |
+| `protectPattern` | no | Skip matches inside spans matching this regex |
+
+Add `--dry-run` to count matches without writing.
+
+## rtf edit — replace field via stdin
+
+Replace an entire rich text field by piping Markdown from stdin. Avoids shell quoting issues for long content.
+
+```bash
+echo "## New heading\n\nNew body text." | cms-edit rtf edit @c1 body
+```
+
+In human (interactive) mode, the command prints the current Markdown to stdout first, then reads the replacement from stdin.
+
 ## Related skills
 
 See the **core** skill for workflow, refs, and all commands.

package/dist/commands/export-converted.d.ts

@@ -1,8 +0,0 @@
-/** biome-ignore-all lint/suspicious/noConsole: Console output is intentional in CLI */
-import type { Command } from 'commander';
-/**
- * Export a session ref's entry as converted (IBase*) JSON by calling the app's
- * convert API. Use the output with cms-edit screenshot --json-file for variants.
- */
-export declare function registerExportConvertedCommand(program: Command): void;
-//# sourceMappingURL=export-converted.d.ts.map

package/dist/commands/export-converted.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"export-converted.d.ts","sourceRoot":"","sources":["../../src/commands/export-converted.ts"],"names":[],"mappings":"AAAA,uFAAuF;AAIvF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQzC;;;GAGG;AACH,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA4DrE"}

package/dist/commands/export-converted.js

@@ -1,62 +0,0 @@
-/** biome-ignore-all lint/suspicious/noConsole: Console output is intentional in CLI */
-import * as fs from 'node:fs';
-import * as path from 'node:path';
-import { loadConfig, resolveSpaceConfig } from '../config/load.js';
-import { errorMsg, successMsg } from '../output/print.js';
-import { resolveRef } from '../session/refs.js';
-import { requireSession } from '../session/store.js';
-const DEFAULT_BASE_URL = 'http://localhost:3000';
-/**
- * Export a session ref's entry as converted (IBase*) JSON by calling the app's
- * convert API. Use the output with cms-edit screenshot --json-file for variants.
- */
-export function registerExportConvertedCommand(program) {
-    program
-        .command('export-converted <ref>')
-        .description("Export a ref's entry as converted JSON (IBase*) via the app's convert API. " +
-        'Use with screenshot --json-file for custom variants. App must be running at devBaseUrl.')
-        .option('--out <path>', 'Output file path (required)')
-        .action(async (ref, opts, cmd) => {
-        try {
-            const session = requireSession();
-            const parentOpts = cmd.parent?.opts() ?? {};
-            const config = loadConfig(parentOpts.config);
-            const { space } = resolveSpaceConfig(config, parentOpts.space);
-            const baseUrl = space.devBaseUrl ?? DEFAULT_BASE_URL;
-            if (!space.devBaseUrl) {
-                errorMsg('No devBaseUrl set. Add "devBaseUrl" (e.g. "http://localhost:3010") to your space in .contentful-cms.json.');
-                process.exit(1);
-            }
-            if (!opts.out) {
-                errorMsg('Missing --out <path>. Example: cms-edit export-converted @c1 --out hero-base.json');
-                process.exit(1);
-            }
-            const entry = resolveRef(session, ref);
-            const entryId = entry.sys.id;
-            const convertUrl = `${baseUrl}/api/cms-preview/convert?id=${entryId}`;
-            const res = await fetch(convertUrl);
-            if (!res.ok) {
-                const text = await res.text();
-                errorMsg(`Convert API failed (${res.status}). Ensure the app is running at ${baseUrl}. ${text.slice(0, 150)}`);
-                process.exit(1);
-            }
-            const body = (await res.json());
-            if (body.data === undefined || body.data === null) {
-                errorMsg('Convert API returned no data.');
-                process.exit(1);
-            }
-            const outPath = path.resolve(opts.out);
-            const dir = path.dirname(outPath);
-            if (dir && dir !== '.') {
-                fs.mkdirSync(dir, { recursive: true });
-            }
-            fs.writeFileSync(outPath, JSON.stringify(body.data, null, 2), 'utf-8');
-            successMsg(`Exported converted JSON to ${outPath}`);
-        }
-        catch (err) {
-            errorMsg(err instanceof Error ? err.message : String(err));
-            process.exit(1);
-        }
-    });
-}
-//# sourceMappingURL=export-converted.js.map

package/dist/commands/export-converted.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"export-converted.js","sourceRoot":"","sources":["../../src/commands/export-converted.ts"],"names":[],"mappings":"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"}