@procedures/archive 0.7.0 → 0.8.0

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # @procedures/archive
 
+## 0.8.0
+
+### Patch Changes
+
+- 90ea741: The root of `createArchiveModule({ root })` uses the rules of `@procedures/fs/root`, so the package has no copy of them. The procedures declare their path inputs in `metadata.fsRoot`, so the root of a host (`confineToRoot()`) confines them too (roadmap R33).
+- Updated dependencies [4b09a03]
+- Updated dependencies [4b09a03]
+- Updated dependencies [aa6e3aa]
+- Updated dependencies [698e24d]
+- Updated dependencies [4b09a03]
+- Updated dependencies [600c497]
+- Updated dependencies [7c2e7f7]
+- Updated dependencies [90ea741]
+- Updated dependencies [90ea741]
+- Updated dependencies [c4cfa34]
+- Updated dependencies [d25805a]
+  - @procedures/client@0.8.0
+  - @procedures/fs@0.8.0
+
 ## 0.7.0
 
 ### Patch Changes

package/README.md

@@ -46,7 +46,7 @@ The extract reads all the entries first. It refuses the archive, and writes noth
 
 ## The root
 
-Without a root, the procedures read and write each path that the process can reach. `createArchiveModule({ root })` confines each path of the inputs to one folder (roadmap R33). The rules are the rules of `createFsModule({ root })` of `@procedures/fs`:
+Without a root, the procedures read and write each path that the process can reach. `createArchiveModule({ root })` confines each path of the inputs to one folder (roadmap R33). The rules are the rules of `createFsModule({ root })` of `@procedures/fs`. The package imports them from `@procedures/fs/root`, so the two packages have one copy of the rules:
 
 ```ts
 import { createRegistry } from "@procedures/client";
@@ -64,6 +64,14 @@ const registry = createRegistry(createArchiveModule({ root: "/srv/files" }));
 - A relative root starts at the working folder of the process. The root must exist when a call starts.
 - `isOutsideRoot(error)` tells the refusal of the root. On Windows, the comparison ignores the case of the letters.
 
+A host with a root (`mark --fs-root`, `procedure-server --fs-root`, `MCP_FS_ROOT`) does not need `createArchiveModule({ root })`. Its `confineToRoot()` reads the rules in `metadata.fsRoot` of each procedure:
+
+| Procedure | The inputs that the root examines |
+|---|---|
+| `archive.create` | `output` and `source` (from the root), `cwd` (the default is the root), and each name of `files` (from `cwd`) |
+| `archive.extract` | `archive` and `target` |
+| `archive.list` | `archive` |
+
 ## Limits
 
 | Option | Meaning |