@procedures/tailscale 0.33.0 → 0.35.0

package/CHANGELOG.md

@@ -1,5 +1,56 @@
 # @procedures/tailscale
 
+## 0.35.0
+
+### Patch Changes
+
+- 0b0cb42: One CLI-tool runner in `@procedures/shell` (dedupe review F2, tracker item O60).
+  
+  PATCH: new exports `defineCliTool` and `./testing`, no break. Before 1.0.0, a feature raises the PATCH, and the fixed group shares one version.
+  
+  - The new entry `@procedures/shell/cli` gives `defineCliTool({ name, resolve, error })`. Its runner has `run`, `runJson`, `output`, `json`, `arg` and `shellInput`. Each command goes as argv to `shell.run` through `ctx.client`, never as a shell string.
+  - The entry also gives `cliArg()`, `buildArgv()`, `parseJsonDocument()`, `parseJsonOutput()`, the shared result `CliToolOutput` with `cliToolOutputSchema()`, and the program lookup `nodeScript()`, `execPathProgram()` and `findInPath()`. The package root exports them too.
+  - The new entry `@procedures/shell/testing` gives `fakeShell(results)`: the shell procedures with their real schemas, effects and root rules, and handlers that record each input. Use `shell.module` in `createRegistry()`, or `shell.client` as `ctx.client`.
+  - gh, npm, pnpm, docker and `cli.run` run their program through `defineCliTool()`. Each procedure keeps its path, its schemas, its effects and its behavior. The exported helpers (`resolveNpm`, `resolvePnpm`, the output types and schemas) stay.
+  - `PnpmCommandOutput`, `NpmCommandOutput`, `DockerCommandOutput` and `CliRunOutput` extend `CliToolOutput`. Their schemas come from `cliToolOutputSchema()`. The `stderr` description of pnpm and `cli.run` now also names the error message when the program did not start.
+  - `@procedures/restic` and `@procedures/tailscale` re-export `buildArgv`, `parseJsonOutput`, `FLAG_NAME` and `ArgValue` from `@procedures/shell/cli`. The two copies of `argv.ts` are gone.
+  - `@procedures/vite` and `@procedures/vitest` use `cliArg()` for their argument guard.
+  - `SERVER-LAYERS.md` records the one run path of a CLI wrapper, and the reasons.
+- fc5df9d: PATCH: internal, no change to the public API. The follow-ups of the one CLI-tool runner (tracker item O64).
+  
+  - `pnpm.store.path` runs `pnpm store path` with argv through the nested `shell.run` call, as the other pnpm procedures do. Before, it ran a shell string with `execSync`. Its path, schemas, effects and output stay the same. It declares `calls: ["shell.run"]`.
+  - `tailscale.run` runs tailscale through `defineCliTool()` and the nested `shell.run` call. The engine applies its rules to that call, and a cancel stops the program. The module requires the module of `@procedures/shell`. A program that does not start still gives the error "tailscale did not start".
+  - `@procedures/mark` no longer declares `@clack/prompts`. No file of mark imports it since the move to `@procedures/cli-kit`.
+- Updated dependencies [0b0cb42]
+  - @procedures/shell@0.35.0
+  - @procedures/client@0.35.0
+
+## 0.34.0
+
+### Patch Changes
+
+- fa1a61a: Less boilerplate in each procedure definition (dedupe review F1, tracker item O58).
+  
+  PATCH (pre-1.0): this change adds exports and deprecates names. It removes no export and changes no behavior.
+  
+  - `@procedures/client` has the new export `typed<T>()`. It is the one pass-through schema that gives only the type `T`.
+  - `@procedures/client` has the new export `definePackage(name, procedures, requires?)`. It gives `{ module, register }` and registers nothing at the call. The new type `PackageDefinition` is its result.
+  - `zodAdapter` is deprecated. `input()` and `output()` take each Standard Schema and infer its type, so a zod schema goes in directly.
+  - `typedAnySchema` and `outputSchema` are deprecated. Use `typed<T>()`. They give the same pass-through schema.
+  - The procedures of the packages give their zod schemas to `input()` and `output()` directly. The `.build() as AnyProcedure` casts are gone. The schemas, the types of the exports and the validation do not change.
+  - `mark procedure new` writes `.input(<Name>InputSchema)` and `.output(<Name>OutputSchema)`, without `zodAdapter`.
+  
+  Migration:
+  
+  - The site, MiniMongo, Graph and jarvis: 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.
+- Updated dependencies [d4376c2]
+- Updated dependencies [fa1a61a]
+  - @procedures/client@0.34.0
+  - @procedures/shell@0.34.0
+
 ## 0.33.0
 
 ### Patch Changes