wiki-graph 0.7.0 → 0.8.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.
@@ -222,6 +222,19 @@ Notes:
222
222
  - This does not delete empty parent directories.
223
223
  - Removing an archive can make an existing library index cache stale.
224
224
  - Remove holds the library write lock and cannot run concurrently with library scan, add, path binding, archive path changes, or index rebuild for the same library.
225
+ {% elif target.kind == "archive" and predicate == "replace" %}
226
+ Purpose:
227
+ Atomically replace this managed archive's contents while preserving its library membership identity and relative path.
228
+
229
+ Usage:
230
+ {{ commandName }} {{ uri }} replace --input <path> [--json]
231
+
232
+ Notes:
233
+ - The input must be a current, valid `.wikg` file and is never modified.
234
+ - Replacement waits for current archive access to finish and blocks new access during publication.
235
+ - Active build jobs block replacement.
236
+ - Archive and library query caches, sessions, cursors, and the aggregate library index are invalidated.
237
+ - Sync the library index again before running library-wide queries.
225
238
  {% elif target.kind == "metadata" and predicate == "set" %}
226
239
  Purpose:
227
240
  Replace the whole library metadata map.
@@ -133,11 +133,13 @@ Use when:
133
133
  Usage:
134
134
  {{ commandName }} {{ uri }} [--json]
135
135
  {{ commandName }} {{ uri }} inspect [--json]
136
+ {{ commandName }} {{ uri }} replace --input <path> [--json]
136
137
  {{ commandName }} {{ uri }}/path set <relative-wikg-path> [--json]
137
138
  {{ commandName }} {{ uri }} remove --confirm [--json]
138
139
 
139
140
  Predicate commands:
140
141
  - inspect: inspect this managed archive's archive readiness. Help: {{ commandName }} {{ uri }} inspect --help
142
+ - replace: atomically replace this member's archive contents while preserving its library identity. Help: {{ commandName }} {{ uri }} replace --help
141
143
  - path set: move or rename this archive inside the same library folder without changing its archive id. Help: {{ commandName }} {{ uri }}/path set --help
142
144
  - remove: delete this archive file from the library folder and unregister it. Help: {{ commandName }} {{ uri }} remove --help
143
145
  {% elif target.kind == "scope" and target.objectUri == "wikg://index" %}