@bendyline/docblocks-cli 2.2.1 → 2.3.0

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/README.md CHANGED
@@ -8,7 +8,7 @@ agents.
8
8
 
9
9
  ## Installation
10
10
 
11
- Node.js 22.14 or newer is required.
11
+ Node.js 22.22.2+, 24.15.0+, or 26+ is required.
12
12
 
13
13
  ```bash
14
14
  npm install -g @bendyline/docblocks-cli
@@ -65,6 +65,14 @@ docblocks mcp
65
65
  docblocks mcp --allow-read ./documents --allow-write ./exports
66
66
  ```
67
67
 
68
+ For durable output, call `list_roots` before drafting. If no root is write-enabled,
69
+ restart the server with `--allow-write`; do not bypass MCP with the direct `convert`
70
+ command. Plain text or ordinary Markdown can be passed directly to
71
+ `convert_document` without a preflight; compatible templates are chosen automatically,
72
+ and explicit Squisq annotations remain optional overrides. `get_authoring_context` is
73
+ optional discovery for exact annotation examples and safe defaults; the complete catalog remains
74
+ available at `docblocks://authoring-guide`.
75
+
68
76
  `convert` and `video` accept Markdown, Squisq JSON Doc, DBK/ZIP, folders, and
69
77
  import-capable linked-registry formats. `build` replaces generated HTML files;
70
78
  `convert` and `video` refuse existing destinations unless `--allow-overwrite` is