@superdoc/cli 0.35.0-next.7 → 0.35.0-next.9

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.
@@ -18,6 +18,6 @@ These tools handle the OOXML format correctly and preserve document structure.
18
18
 
19
19
  **Edit with named actions.** `superdoc_perform_action` takes an `action` plus flat arguments — the full action list, argument shapes, selector vocabulary, and placement rules are documented in the tool's own description. Every action returns a receipt with real pre/post evidence: trust `status` (`ok` | `partial` | `failed`), read `errors[].message` for recovery guidance, and re-inspect after `partial`.
20
20
 
21
- **Tracked changes (redlining).** Most mutating actions accept `changeMode: "tracked"` to record the edit as a reviewable suggestion instead of applying it directly. Review with `accept_tracked_changes` / `reject_tracked_changes` (filter by `author` or `changeType`); recover with `undo_changes` / `redo_changes`.
21
+ **Tracked changes (redlining).** Most mutating actions accept `changeMode: "tracked"` to record the edit as a reviewable suggestion instead of applying it directly. Review with `accept_tracked_changes` / `reject_tracked_changes` (target one change with `id`, or an exact set with `id:[…]`; or filter by `author` or `changeType`). Do not combine exact IDs with filters. Recover with `undo_changes` / `redo_changes`.
22
22
 
23
23
  **Failures are safe.** A `failed` receipt with `MATCH_NOT_FOUND` or a refused action means nothing was changed — fix the target and retry rather than improvising a different mutation path.
@@ -57,7 +57,7 @@ ACTIONS (superdoc_perform_action with flat args)
57
57
  - add_comments: commentText, and either selector (one block) or selectors:[…] to comment MANY blocks in ONE call with the same text. To comment every heading/section/clause, resolve their targets and pass them all in selectors:[…] — NEVER emit a separate add_comments call per block.
58
58
  - reply_to_comment: commentText (the reply body), and either anchorText (text the target comment is anchored on / mentions) or commentId. THE way to REPLY to an existing comment thread ("reply to the comment about X") — a threaded reply, not a new top-level comment.
59
59
  - resolve_comments: anchorText? (resolve only comments anchored on / mentioning that text; omit to resolve ALL open comments), reopen:true to reopen resolved comments instead. THE way to "resolve the comment(s)" / "mark comments resolved".
60
- - accept_tracked_changes / reject_tracked_changes: optional author:"Full Name", optional changeType:"insert"|"delete"|"replacement"|"format". "Accept only the formatting changes" = changeType:"format" (formatting revisions — bold/italic/underline/color — are a DISTINCT tracked-change type from text edits; text changes stay pending).
60
+ - accept_tracked_changes / reject_tracked_changes: id:"change-id" or id:["id1","id2"] for one atomic set, OR optional author:"Full Name" / changeType:"insert"|"delete"|"replacement"|"format" to filter. Do not combine id with author/changeType. "Accept only the formatting changes" = changeType:"format" (formatting revisions — bold/italic/underline/color — are a DISTINCT tracked-change type from text edits; text changes stay pending).
61
61
  - format_text: bold/italic/underline/strike:true, highlight:"yellow", color (named or hex), fontSize — applied to EVERY occurrence of targetText (or targetTexts:["…","…"] for several phrases in one call; or selector for a whole block). caseSensitive:true for exact case. changeMode:"tracked" produces format-type tracked changes. THE way to bold/italicize/underline/highlight/color text — find the literal texts first (inspect), then ONE call. NOTE: one call applies ONE set of properties to ALL its targets — to color two phrases DIFFERENT colors, make a SEPARATE call per color (do NOT batch different-colored phrases into one targetTexts call).
62
62
  - apply_style: selector (the block to restyle), then ONE of styleId ("Heading2"), headingLevel (1-6), or likeText (text inside the block whose style AND effective look to copy). "Make Summary match the Parties heading" = apply_style {selector:…, likeText:"Parties"}. THE way to restyle an existing block — never delete-and-recreate it.
63
63
  - normalize_body_font_size: fontSize:N.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@superdoc/cli",
3
- "version": "0.35.0-next.7",
3
+ "version": "0.35.0-next.9",
4
4
  "description": "Command-line interface for SuperDoc: inspect, convert, and edit .docx files from a terminal or a script.",
5
5
  "type": "module",
6
6
  "license": "AGPL-3.0",
@@ -29,15 +29,15 @@
29
29
  "fast-glob": "^3.3.3",
30
30
  "happy-dom": "^20.3.4",
31
31
  "ws": "^8.18.0",
32
- "superdoc": "2.15.0-next.6",
32
+ "superdoc": "2.15.0-next.7",
33
33
  "y-websocket": "^3.0.0",
34
34
  "yjs": "13.6.31"
35
35
  },
36
36
  "devDependencies": {
37
37
  "@hocuspocus/server": "^2.13.6",
38
- "@superdoc/sdk": "2.12.0-next.7",
38
+ "@superdoc/sdk": "2.12.0-next.9",
39
39
  "@superdoc/document-api": "0.1.0-alpha.0",
40
- "@superdoc/docx-engine": "0.14.0-next.5",
40
+ "@superdoc/docx-engine": "0.14.0-next.6",
41
41
  "@types/bun": "^1.3.8",
42
42
  "@types/node": "22.19.2",
43
43
  "@types/ws": "^8.5.13",
@@ -51,11 +51,11 @@
51
51
  "access": "public"
52
52
  },
53
53
  "optionalDependencies": {
54
- "@superdoc/cli-darwin-arm64": "0.35.0-next.7",
55
- "@superdoc/cli-darwin-x64": "0.35.0-next.7",
56
- "@superdoc/cli-linux-x64": "0.35.0-next.7",
57
- "@superdoc/cli-linux-arm64": "0.35.0-next.7",
58
- "@superdoc/cli-windows-x64": "0.35.0-next.7"
54
+ "@superdoc/cli-darwin-arm64": "0.35.0-next.9",
55
+ "@superdoc/cli-darwin-x64": "0.35.0-next.9",
56
+ "@superdoc/cli-linux-x64": "0.35.0-next.9",
57
+ "@superdoc/cli-linux-arm64": "0.35.0-next.9",
58
+ "@superdoc/cli-windows-x64": "0.35.0-next.9"
59
59
  },
60
60
  "scripts": {
61
61
  "predev": "node scripts/ensure-superdoc-build.js",
package/skill/SKILL.md CHANGED
@@ -8,7 +8,7 @@ description: Edit, query, and transform Word documents with the SuperDoc CLI v1
8
8
  Use SuperDoc CLI for DOCX work. Use v1 commands (canonical operations and their helper wrappers).
9
9
  Do not default to legacy commands unless explicitly needed for v0-style bulk workflows.
10
10
 
11
- Use `superdoc` if installed, or `npx @superdoc-dev/cli@latest` as a fallback.
11
+ Use `superdoc` if installed, or `npx @superdoc/cli@latest` as a fallback.
12
12
 
13
13
  ## First Step: Discover Exact Params
14
14
 
@@ -41,7 +41,7 @@ superdoc close
41
41
 
42
42
  ### 2) Generate or seed a document body (recommended for synthetic/probe docs)
43
43
 
44
- Use `open --content-override` when you want to create a new body from Markdown, HTML, or plain text in one step.
44
+ Use `open --content-override` to initialize a blank document or replace a template's main body from Markdown, HTML, or plain text in one step. Template styles, theme, section settings, headers, footers, and other non-body package content are retained.
45
45
 
46
46
  ```bash
47
47
  superdoc open --content-override "# Probe Title\n\nALPHA01" --override-type markdown