@se-studio/project-build 1.0.112 → 1.0.114

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @se-studio/project-build
 
+## 1.0.114
+
+### Patch Changes
+
+- Bulk version bump: patch for all packages
+
+## 1.0.113
+
+### Patch Changes
+
+- Bulk version bump: patch for all packages
+
 ## 1.0.112
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@se-studio/project-build",
-  "version": "1.0.112",
+  "version": "1.0.114",
   "description": "Build tools and management scripts for SE Studio projects",
   "repository": {
     "type": "git",
@@ -60,19 +60,19 @@
     "url": "https://github.com/Something-Else-Studio/se-core-product/issues"
   },
   "dependencies": {
-    "@biomejs/biome": "^2.4.8",
+    "@biomejs/biome": "^2.4.9",
     "@biomejs/js-api": "^4.0.0",
-    "@biomejs/wasm-nodejs": "^2.4.8",
+    "@biomejs/wasm-nodejs": "^2.4.9",
     "change-case": "^5.4.4",
     "chroma-js": "^3.2.0",
-    "contentful-management": "^11.74.0",
+    "contentful-management": "^11.75.0",
     "dotenv": "^17.3.1"
   },
   "devDependencies": {
     "@types/chroma-js": "^3.1.2",
     "@types/node": "^22.19.15",
-    "typescript": "^5.9.3",
-    "vitest": "^4.1.0"
+    "typescript": "^6.0.2",
+    "vitest": "^4.1.1"
   },
   "scripts": {
     "build": "node scripts/merge-contentful-skills.mjs && tsc --project tsconfig.build.json",

package/skills/contentful-cms/core/SKILL.md

@@ -510,6 +510,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/contentful-cms/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.