@procedures/mark 0.46.0 → 0.47.2

package/CHANGELOG.md

@@ -1,5 +1,72 @@
 # @procedures/mark
 
+## 0.47.2
+
+### Patch Changes
+
+- Updated dependencies [0650616]
+- Updated dependencies [ae1e3fd]
+- Updated dependencies [f1ece74]
+  - @procedures/client@0.47.2
+  - @procedures/cli-kit@0.47.2
+  - @procedures/cli-run@0.47.2
+  - @procedures/fs@0.47.2
+  - @procedures/lib@0.47.2
+  - @procedures/pnpm@0.47.2
+  - @procedures/procedure@0.47.2
+  - @procedures/peer@0.47.2
+  - @procedures/shell@0.47.2
+  - @procedures/vitest@0.47.2
+  - @procedures/mcp-dev-tools@0.47.2
+  - @procedures/server@0.47.2
+
+## 0.47.1
+
+### Patch Changes
+
+- Updated dependencies [f845c6d]
+  - @procedures/client@0.47.1
+  - @procedures/lib@0.47.1
+  - @procedures/cli-kit@0.47.1
+  - @procedures/cli-run@0.47.1
+  - @procedures/fs@0.47.1
+  - @procedures/pnpm@0.47.1
+  - @procedures/procedure@0.47.1
+  - @procedures/peer@0.47.1
+  - @procedures/shell@0.47.1
+  - @procedures/vitest@0.47.1
+  - @procedures/mcp-dev-tools@0.47.1
+  - @procedures/server@0.47.1
+
+## 0.47.0
+
+### Patch Changes
+
+- ff06c60: O90: the `mark` executable enables the compile cache of Node.js before it loads the CLI. The cache folder is `mark/compile-cache` in the cache folder of the user. In CI, one call took 1019 ms with no cache and 754 ms with a warm cache. `NODE_COMPILE_CACHE` and `NODE_DISABLE_COMPILE_CACHE` still control the cache.
+- d987202: A call of `mark` loads only the packages of its path (roadmap O93). `ProcedureRegistry` gets an optional resolver, `resolve(path)` and `loadAll()`. `createLazyRegistry()` makes a registry that loads a package at the first lookup of one of its paths. A procedure that reads or writes the registry gets each package first. The manifest of `mark` (version 3) has the packages of each command. The packages `ws` and `cli-table3` load at their first use. The sync methods of the registry and the eager registries do not change.
+- e913014: Each module imports zod with `import * as z from "zod"`, not `import { z } from "zod"`. With the old form, an esbuild bundle got each locale of zod: 264 kB of minified code (esbuild metafile of the journey worker of the site). The Vite build of the site gives the same worker files with both forms. The procedure scaffolder writes the new form in `types.ts`. The API and the behavior stay the same.
+- Updated dependencies [c9125a8]
+- Updated dependencies [335728b]
+- Updated dependencies [d987202]
+- Updated dependencies [45a737f]
+- Updated dependencies [d77e9e8]
+- Updated dependencies [e913014]
+- Updated dependencies [2f0c7b0]
+- Updated dependencies [ad70c38]
+- Updated dependencies [47819c6]
+  - @procedures/client@0.47.0
+  - @procedures/cli-kit@0.47.0
+  - @procedures/cli-run@0.47.0
+  - @procedures/fs@0.47.0
+  - @procedures/lib@0.47.0
+  - @procedures/peer@0.47.0
+  - @procedures/pnpm@0.47.0
+  - @procedures/procedure@0.47.0
+  - @procedures/server@0.47.0
+  - @procedures/shell@0.47.0
+  - @procedures/vitest@0.47.0
+  - @procedures/mcp-dev-tools@0.47.0
+
 ## 0.46.0
 
 ### Patch Changes
@@ -317,8 +384,8 @@
   - A host whose `expose`, policy or limit pattern names such a path in text uses the encoded form, for example `collections.e2e%2Etabs.*`.
   - An `mcpExclude` entry, an `expose` deny entry or a limit entry in the old raw form, for example `collections.e2e.tabs.drop`, does not match. The check compares the encoded key, so the procedure becomes visible, or the limit does not apply. Write each such entry in the encoded form, for example `collections.e2e%2Etabs.drop`.
   - A subscriber of a dotted collection uses `collectionChangeTopic(name)`. The raw topic `collections.a.b` is the topic of the partition `b` of `a`.
-  - Graph: read the collection of a topic with `collectionTopicPartition(topic)`, not with a pattern, for example `/^collections\.([^.]+)\./`.
-  - The site, MiniMongo and jarvis: no change, if their collection names have no `.` and no `%`.
+  - An app: read the collection of a topic with `collectionTopicPartition(topic)`, not with a pattern, for example `/^collections\.([^.]+)\./`.
+  - Other apps: no change, if their collection names have no `.` and no `%`.
 
 ### Patch Changes
 
@@ -335,7 +402,7 @@
   
   Migration:
   
-  - The site, MiniMongo, Graph and jarvis: no change at this time. The deprecated names work until the next MINOR.
+  - Apps: no change at this time. The deprecated names work until the next MINOR.
   - Before the next MINOR, replace `zodAdapter<T>(schema)` with `schema`. To keep the check of a schema against a type, write `const schema: z.ZodType<T> = ...`.
   - Before the next MINOR, replace `typedAnySchema<T>()` and `outputSchema<T>()` with `typed<T>()`.
   - A parse-only object (`{ parse }`) in `zodAdapter` becomes a Standard Schema with a `~standard` property.
@@ -742,9 +809,9 @@
   - A script that starts `mark server create` as a server in the foreground: start `mark --server` or `procedure-server` in its place.
   - A program that calls `run()`, `main()` or `executeArgs()` of `@procedures/mark`: no change. It keeps its process. Give `ownsProcess: true` to give the process to the runner, as the bin does.
   - The site: no change. It does not start `mark`.
-  - MiniMongo: no change. Its dev host starts through `runProcedureHost()`, not through `mark`.
-  - Graph: no change. It does not start `mark`.
-  - jarvis: no change, unless a script of jarvis reads the exit code of an interrupted `mark` command. Then apply the first step.
+  - An app: no change. Its dev host starts through `runProcedureHost()`, not through `mark`.
+  - An app: no change. It does not start `mark`.
+  - An app: no change, unless one of its scripts reads the exit code of an interrupted `mark` command. Then apply the first step.
 
 ### Patch Changes
 
@@ -825,9 +892,9 @@
   
   - A host with more than 256 clients at one time: give a larger `maxSessions`, or `maxSessions: Infinity` for no limit. Give it in `faces.http` of `createMcpHost()`, in `mcpFace()`, or with `mark mcp --http <port> --max-sessions <n>`.
   - A host that keeps more than 1000 tasks: give a larger `maxStored`, or `maxStored: Infinity`, in `tasks` of the host or in `new McpTaskStore()`.
-  - The site and MiniMongo: no change. They have no MCP host.
-  - Graph: no change. Its `mcpFace()` on the procedures host gets the limit of 256 sessions, and its MCP host over stdio has no HTTP face. To keep no limit, give `mcpFace({ maxSessions: Infinity })`.
-  - jarvis: no change. Its MCP host has only stdio and SDK faces, and it has no tasks.
+  - The site and an app: no change. They have no MCP host.
+  - An app: no change. Its `mcpFace()` on the procedures host gets the limit of 256 sessions, and its MCP host over stdio has no HTTP face. To keep no limit, give `mcpFace({ maxSessions: Infinity })`.
+  - An app: no change. Its MCP host has only stdio and SDK faces, and it has no tasks.
   - polite-crawler-mcp: no change for the sessions, because it sets `maxSessions: 32`. Its `McpTaskStore` gets the limit of 1000 stored tasks. Before, 32 sessions of 100 tasks bounded the store at 3200 tasks. To keep that bound, give `new McpTaskStore({ maxStored: 3200 })`.
   - polite-crawler-mcp also gives the deprecated option `mount: true`, which has no effect. Remove it when it moves to the new range.
 
@@ -958,7 +1025,7 @@
   
   Deprecated: at the timeout of 15 s, `server.start` gives `success: true` with the message "still loading" while the process still starts. From the next MINOR of the client group, a start that is not ready at the timeout gives `success: false`, with the PID of the process that still starts. Read the readiness probe or `mark server status` for the state.
   
-  The site, MiniMongo, Graph and jarvis: no change. A host with a listener now also answers the paths under `/_probes`. Before, these paths got 404.
+  Apps: no change. A host with a listener now also answers the paths under `/_probes`. Before, these paths got 404.
 - Updated dependencies [636f098]
   - @procedures/peer@0.17.3
   - @procedures/server@0.17.3
@@ -1088,7 +1155,7 @@
   - The listener of the Streamable HTTP face: the options `port`, `host` and `server` of `HttpTransportOptions`, and `McpHttpTransport.listen()`. Give `mount: true`, and mount `McpHost.handleHttp` on a listener of the service.
   - `startDevToolsServer()` of `@procedures/mcp-dev-tools`. Use `runDevToolsServer()`.
   
-  Migration for the next MINOR: the site uses none of them. MiniMongo uses none of them. Graph mounts `mcpFace()` on its host, and its stdio host keeps `createMcpHost()` with `stdio`: no change. jarvis uses `createMcpHost()` with stdio and SDK faces: no change. A host with `faces.http: { port }` moves to `faces.http: { mount: true }` and a listener of the service.
+  Migration for the next MINOR: the site uses none of them. One app uses none of them. Another app mounts `mcpFace()` on its host, and its stdio host keeps `createMcpHost()` with `stdio`: no change. A third app uses `createMcpHost()` with stdio and SDK faces: no change. A host with `faces.http: { port }` moves to `faces.http: { mount: true }` and a listener of the service.
 - Updated dependencies [85999c1]
 - Updated dependencies [fc968f6]
 - Updated dependencies [dc7a462]
@@ -1230,7 +1297,7 @@
   
   Migration steps:
   
-  - The site, MiniMongo, Graph and jarvis: no change is necessary. They do not start these entries.
+  - Apps: no change is necessary. They do not start these entries.
   - A script that starts `procedure-server` or `mark serve` and stops it with a signal: no change is necessary. Wait for the exit, in 10 s at most.
   - A program that embeds the server outside a service: use `startServer()`, which starts it as a peer, and `peer.stop()`.
 

package/README.md

@@ -95,6 +95,12 @@ node packages/mark/dist/cli.js --help
 - Node.js >= 22.0.0
 - pnpm (the version of the workspace `packageManager` field)
 
+### The compile cache
+
+The `mark` executable enables the compile cache of Node.js (22.1 and later) before it loads the CLI. The second and later runs read the compiled code from the cache. In CI, one `mark` call took 1019 ms with no cache and 754 ms with a warm cache. The first run after an install, or after a change of a file, writes the cache and takes approximately 170 ms more.
+
+The cache folder is `mark/compile-cache` in the cache folder of the user: `$XDG_CACHE_HOME` or `~/.cache` on Linux, `~/Library/Caches` on macOS and `%LOCALAPPDATA%` on Windows. Set `NODE_COMPILE_CACHE=<folder>` to use a different folder, or `NODE_DISABLE_COMPILE_CACHE=1` to turn the cache off. If the folder cannot be written, `mark` runs with no cache.
+
 ## Execution Flow
 
 ```mermaid
@@ -492,7 +498,7 @@ A package that does not load gives one warning line. A package that is not built
 **Example register.js:**
 ```typescript
 import { defineProcedure } from "@procedures/client";
-import { z } from "zod";
+import * as z from "zod";
 
 const libNew = defineProcedure({
   path: ["lib", "new"],