@superdoc-dev/cli 0.2.0-next.100 → 0.2.0-next.101

package/dist/index.js

@@ -121914,9 +121914,9 @@ var init_remark_gfm_CjV8kaUy_es = __esm(() => {
   init_remark_gfm_z_sDF4ss_es();
 });
 
-// ../../packages/superdoc/dist/chunks/src-DDewAWSX.es.js
-var exports_src_DDewAWSX_es = {};
-__export(exports_src_DDewAWSX_es, {
+// ../../packages/superdoc/dist/chunks/src-CK4nCjzb.es.js
+var exports_src_CK4nCjzb_es = {};
+__export(exports_src_CK4nCjzb_es, {
   zt: () => defineMark,
   z: () => cM,
   yt: () => removeAwarenessStates,
@@ -199196,7 +199196,7 @@ var Node$13 = class Node$14 {
     trackedChanges: context.trackedChanges ?? []
   });
 }, _hoisted_1$6, _hoisted_2$2, _hoisted_3, _hoisted_4, ContextMenu_default, _hoisted_1$5, BasicUpload_default, _hoisted_1$4, MIN_WIDTH = 200, PPI = 96, alignment = "flex-end", Ruler_default, GenericPopover_default, _hoisted_1$3, _hoisted_2$1, RESIZE_HANDLE_WIDTH_PX = 9, RESIZE_HANDLE_HEIGHT_PX = 9, RESIZE_HANDLE_OFFSET_PX = 4, DRAG_OVERLAY_EXTENSION_PX = 1000, MIN_DRAG_OVERLAY_WIDTH_PX = 2000, THROTTLE_INTERVAL_MS = 16, MIN_RESIZE_DELTA_PX = 1, TableResizeOverlay_default, _hoisted_1$2, OVERLAY_EXPANSION_PX = 2000, RESIZE_HANDLE_SIZE_PX = 12, MOUSE_MOVE_THROTTLE_MS = 16, DIMENSION_CHANGE_THRESHOLD_PX = 1, Z_INDEX_OVERLAY = 10, Z_INDEX_HANDLE = 15, Z_INDEX_GUIDELINE = 20, ImageResizeOverlay_default, LINK_CLICK_DEBOUNCE_MS = 300, CURSOR_UPDATE_TIMEOUT_MS = 10, POPOVER_VERTICAL_OFFSET_PX = 15, LinkClickHandler_default, _hoisted_1$1, _hoisted_2, DOCX2 = "application/vnd.openxmlformats-officedocument.wordprocessingml.document", TABLE_RESIZE_HOVER_THRESHOLD = 8, TABLE_RESIZE_THROTTLE_MS = 16, SuperEditor_default, _hoisted_1, SuperInput_default, SlashMenu, Extensions;
-var init_src_DDewAWSX_es = __esm(() => {
+var init_src_CK4nCjzb_es = __esm(() => {
   init_rolldown_runtime_B2q5OVn9_es();
   init_SuperConverter_DSgQEo7o_es();
   init_jszip_ChlR43oI_es();
@@ -218949,10 +218949,9 @@ function print() { __p += __j.call(arguments, '') }
         if (transaction) {
           this.#epochMapper.recordTransaction(transaction);
           this.#selectionSync.setDocEpoch(this.#epochMapper.getCurrentEpoch());
-          if (transaction.getMeta?.(ySyncPluginKey)?.isChangeOrigin && transaction.docChanged)
-            this.#flowBlockCache?.setHasExternalChanges(true);
           const inputType = transaction.getMeta?.("inputType");
-          if ((inputType === "historyUndo" || inputType === "historyRedo") && transaction.docChanged)
+          const ySyncMeta = transaction.getMeta?.(ySyncPluginKey);
+          if (transaction.docChanged && (ySyncMeta?.isChangeOrigin || inputType === "historyUndo" || inputType === "historyRedo"))
             this.#flowBlockCache?.setHasExternalChanges(true);
         }
         if (trackedChangesChanged || transaction?.docChanged) {
@@ -230954,8 +230953,8 @@ function print() { __p += __j.call(arguments, '') }
     return isObjectLike_default(value) && hasOwnProperty$8.call(value, "callee") && !propertyIsEnumerable$1.call(value, "callee");
   };
   stubFalse_default = stubFalse;
-  freeExports$2 = typeof exports_src_DDewAWSX_es == "object" && exports_src_DDewAWSX_es && !exports_src_DDewAWSX_es.nodeType && exports_src_DDewAWSX_es;
-  freeModule$2 = freeExports$2 && typeof module_src_DDewAWSX_es == "object" && module_src_DDewAWSX_es && !module_src_DDewAWSX_es.nodeType && module_src_DDewAWSX_es;
+  freeExports$2 = typeof exports_src_CK4nCjzb_es == "object" && exports_src_CK4nCjzb_es && !exports_src_CK4nCjzb_es.nodeType && exports_src_CK4nCjzb_es;
+  freeModule$2 = freeExports$2 && typeof module_src_CK4nCjzb_es == "object" && module_src_CK4nCjzb_es && !module_src_CK4nCjzb_es.nodeType && module_src_CK4nCjzb_es;
   Buffer$1 = freeModule$2 && freeModule$2.exports === freeExports$2 ? _root_default.Buffer : undefined;
   isBuffer_default = (Buffer$1 ? Buffer$1.isBuffer : undefined) || stubFalse_default;
   typedArrayTags = {};
@@ -230963,8 +230962,8 @@ function print() { __p += __j.call(arguments, '') }
   typedArrayTags[argsTag$1] = typedArrayTags[arrayTag$1] = typedArrayTags[arrayBufferTag$1] = typedArrayTags[boolTag$1] = typedArrayTags[dataViewTag$2] = typedArrayTags[dateTag$1] = typedArrayTags[errorTag$1] = typedArrayTags[funcTag] = typedArrayTags[mapTag$2] = typedArrayTags[numberTag$1] = typedArrayTags[objectTag$3] = typedArrayTags[regexpTag$1] = typedArrayTags[setTag$2] = typedArrayTags[stringTag$1] = typedArrayTags[weakMapTag$1] = false;
   _baseIsTypedArray_default = baseIsTypedArray;
   _baseUnary_default = baseUnary;
-  freeExports$1 = typeof exports_src_DDewAWSX_es == "object" && exports_src_DDewAWSX_es && !exports_src_DDewAWSX_es.nodeType && exports_src_DDewAWSX_es;
-  freeModule$1 = freeExports$1 && typeof module_src_DDewAWSX_es == "object" && module_src_DDewAWSX_es && !module_src_DDewAWSX_es.nodeType && module_src_DDewAWSX_es;
+  freeExports$1 = typeof exports_src_CK4nCjzb_es == "object" && exports_src_CK4nCjzb_es && !exports_src_CK4nCjzb_es.nodeType && exports_src_CK4nCjzb_es;
+  freeModule$1 = freeExports$1 && typeof module_src_CK4nCjzb_es == "object" && module_src_CK4nCjzb_es && !module_src_CK4nCjzb_es.nodeType && module_src_CK4nCjzb_es;
   freeProcess = freeModule$1 && freeModule$1.exports === freeExports$1 && _freeGlobal_default.process;
   _nodeUtil_default = function() {
     try {
@@ -231069,8 +231068,8 @@ function print() { __p += __j.call(arguments, '') }
   Stack.prototype.has = _stackHas_default;
   Stack.prototype.set = _stackSet_default;
   _Stack_default = Stack;
-  freeExports = typeof exports_src_DDewAWSX_es == "object" && exports_src_DDewAWSX_es && !exports_src_DDewAWSX_es.nodeType && exports_src_DDewAWSX_es;
-  freeModule = freeExports && typeof module_src_DDewAWSX_es == "object" && module_src_DDewAWSX_es && !module_src_DDewAWSX_es.nodeType && module_src_DDewAWSX_es;
+  freeExports = typeof exports_src_CK4nCjzb_es == "object" && exports_src_CK4nCjzb_es && !exports_src_CK4nCjzb_es.nodeType && exports_src_CK4nCjzb_es;
+  freeModule = freeExports && typeof module_src_CK4nCjzb_es == "object" && module_src_CK4nCjzb_es && !module_src_CK4nCjzb_es.nodeType && module_src_CK4nCjzb_es;
   Buffer4 = freeModule && freeModule.exports === freeExports ? _root_default.Buffer : undefined;
   allocUnsafe = Buffer4 ? Buffer4.allocUnsafe : undefined;
   _cloneBuffer_default = cloneBuffer;
@@ -239150,7 +239149,7 @@ var init_zipper_DqXT7uTa_es = __esm(() => {
 
 // ../../packages/superdoc/dist/super-editor.es.js
 var init_super_editor_es = __esm(() => {
-  init_src_DDewAWSX_es();
+  init_src_CK4nCjzb_es();
   init_SuperConverter_DSgQEo7o_es();
   init_jszip_ChlR43oI_es();
   init_xml_js_DLE8mr0n_es();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superdoc-dev/cli",
-  "version": "0.2.0-next.100",
+  "version": "0.2.0-next.101",
   "type": "module",
   "bin": {
     "superdoc": "./dist/index.js"
@@ -20,21 +20,21 @@
     "@types/bun": "^1.3.8",
     "@types/node": "22.19.2",
     "typescript": "^5.9.2",
-    "@superdoc/pm-adapter": "0.0.0",
     "@superdoc/document-api": "0.0.1",
-    "superdoc": "1.18.0",
-    "@superdoc/super-editor": "0.0.1"
+    "@superdoc/pm-adapter": "0.0.0",
+    "@superdoc/super-editor": "0.0.1",
+    "superdoc": "1.18.0"
   },
   "module": "src/index.ts",
   "publishConfig": {
     "access": "public"
   },
   "optionalDependencies": {
-    "@superdoc-dev/cli-darwin-arm64": "0.2.0-next.100",
-    "@superdoc-dev/cli-darwin-x64": "0.2.0-next.100",
-    "@superdoc-dev/cli-linux-x64": "0.2.0-next.100",
-    "@superdoc-dev/cli-linux-arm64": "0.2.0-next.100",
-    "@superdoc-dev/cli-windows-x64": "0.2.0-next.100"
+    "@superdoc-dev/cli-darwin-arm64": "0.2.0-next.101",
+    "@superdoc-dev/cli-darwin-x64": "0.2.0-next.101",
+    "@superdoc-dev/cli-linux-x64": "0.2.0-next.101",
+    "@superdoc-dev/cli-linux-arm64": "0.2.0-next.101",
+    "@superdoc-dev/cli-windows-x64": "0.2.0-next.101"
   },
   "scripts": {
     "dev": "bun run src/index.ts",

package/skill/SKILL.md

@@ -1,45 +1,96 @@
 ---
 name: editing-docx
-description: Searches, replaces, and reads text in Word documents. Use when the user asks to edit, search, or extract text from .docx files.
+description: Edit, query, and transform Word documents with the SuperDoc CLI v1 operation surface. Use when the user asks to read, search, modify, comment, or review changes in .docx files.
 ---
 
-# SuperDoc CLI
+# SuperDoc CLI (v1)
 
-Edit Word documents from the command line. Use instead of python-docx.
+Use SuperDoc CLI for DOCX work. Prefer canonical v1 commands.
+Do not default to legacy commands unless explicitly needed for v0-style bulk workflows.
 
-## Commands
+Use `superdoc` if installed, or `npx @superdoc-dev/cli@latest` as a fallback.
 
-| Command | Description |
-|---------|-------------|
-| `npx @superdoc-dev/cli@latest search <pattern> <files...>` | Find text across documents |
-| `npx @superdoc-dev/cli@latest replace-legacy <find> <to> <files...>` | Find and replace text |
-| `npx @superdoc-dev/cli@latest read <file>` | Extract plain text |
+## First Step: Discover Exact Params
 
-## When to Use
+For unknown commands or flags, inspect runtime metadata first:
 
-Use superdoc when the user asks to:
-- Search text in .docx files
-- Find and replace text in Word documents
-- Extract text content from .docx files
-- Bulk edit multiple Word documents
+```bash
+superdoc describe
+superdoc describe command find
+superdoc describe command "comments add"
+```
+
+Use `describe command` for per-command args and constraints.
 
-## Examples
+## Preferred Workflows
+
+### 1) Stateful multi-step edits (recommended)
 
 ```bash
-# Search across documents
-npx @superdoc-dev/cli@latest search "indemnification" ./contracts/*.docx
+superdoc open ./contract.docx
+superdoc find --type text --pattern "termination"
+superdoc replace --target-json '{"kind":"text","blockId":"p1","range":{"start":0,"end":11}}' --text "expiration"
+superdoc save --in-place
+superdoc close
+```
 
-# Find and replace
-npx @superdoc-dev/cli@latest replace-legacy "ACME Corp" "Globex Inc" ./merger/*.docx
+- After `open`, commands run against the active/default session when `<doc>` is omitted.
+- Use `superdoc session list|set-default|save|close` for explicit session control.
+- `close` on dirty state requires `--discard` or a prior `save`.
 
-# Extract text
-npx @superdoc-dev/cli@latest read ./proposal.docx
+### 2) Stateless one-off reads
 
-# JSON output for scripting
-npx @superdoc-dev/cli@latest search "Article 7" ./**/*.docx --json
+```bash
+superdoc get-text ./proposal.docx
+superdoc get-markdown ./proposal.docx
+superdoc info ./proposal.docx
 ```
 
-## Options
+### 3) Stateless one-off mutations
+
+```bash
+superdoc replace ./proposal.docx \
+  --target-json '{"kind":"text","blockId":"p1","range":{"start":0,"end":5}}' \
+  --text "Updated" \
+  --out ./proposal.updated.docx
+```
+
+- In stateless mode (`<doc>` provided), mutating commands require `--out` unless using `--dry-run`.
+
+## Common v1 Commands
+
+- Search text/nodes: `find --type text --pattern "..."` or `find --query-json '{...}'`
+- Replace text: `replace --target-json '{...}' --text "..."`
+- Add/edit comments: `comments add|reply|edit|resolve|remove`
+- Review tracked changes: `track-changes list|accept|reject|accept-all|reject-all`
+- Extract content: `get-text`, `get-markdown`, `get-html`
+- Low-level direct invoke: `call <operationId> --input-json '{...}'`
+
+## JSON/File Payload Flags
+
+Use one of each pair (not both):
+
+- `--query-json` or `--query-file`
+- `--target-json` or `--target-file`
+- `--address-json` or `--address-file`
+- `--input-json` or `--input-file` (for `call`)
+
+## Output and Global Flags
+
+- Default output is JSON envelope.
+- Use `--pretty` for human-readable output.
+- Global flags: `--output <json|pretty>`, `--session <id>`, `--timeout-ms <n>`.
+- `<doc>` can be `-` to read DOCX bytes from stdin.
+
+## Legacy Compatibility (Use Sparingly)
+
+Legacy v0.x bridge commands still exist:
+
+```bash
+superdoc search <pattern> <files...>
+superdoc replace-legacy <find> <to> <files...>
+superdoc read <file>
+```
 
-- `--json` — Machine-readable output
-- `--help` — Show help
+Use these only when you specifically need v0-style behavior (especially multi-file glob search/replace).
+For new automations, prefer v1 operations.