@monosmith/plugin-sdk 2.0.0-beta.10 → 2.0.0-beta.12

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@monosmith/plugin-sdk",
-  "version": "2.0.0-beta.10",
+  "version": "2.0.0-beta.12",
   "description": "The TypeScript SDK for writing smith plugins: the protocol's types, the serve loop, a test host, the conformance checks, templating and key-order-keeping JSON editing. No runtime dependencies.",
   "license": "MIT",
   "type": "module",

package/protocol/protocol-schema.contract.js

@@ -643,6 +643,10 @@ export const protocolSchema = {
                     "type": "boolean",
                     "description": "Channels says a prerelease version the plugin publishes never takes the place of the stable one: the plugin publishes under PublishParams.Tag, a release channel's name, without moving the registry's stable pointer (npm's latest), or its registry orders a prerelease below the release (PyPI, NuGet) and needs no tag. A host does not publish a package of a release channel with a plugin that lacks it."
                 },
+                "packs": {
+                    "type": "boolean",
+                    "description": "Packs says publish honours PublishParams.PackDir: it writes the package file and publishes nowhere (registry = \"github-release\"). A host never calls publish with the setting on a plugin that lacks it, since the plugin would publish to the public registry."
+                },
                 "declared": {
                     "type": "boolean",
                     "description": "Declared says the plugin describes the projects smith.toml declares for its language (DiscoverParams.declared): folders with no manifest of their own. A plugin without it finds a project by its manifest only, and the host refuses a declaration for its language with a message that says so."
@@ -1430,6 +1434,13 @@ export const protocolSchema = {
                 "dir": {
                     "type": "string",
                     "description": "Dir is where it runs, workspace-relative; empty is the workspace root."
+                },
+                "env": {
+                    "type": "array",
+                    "items": {
+                        "type": "string"
+                    },
+                    "description": "Env are KEY=VALUE entries added to the environment of the command (GOBIN=<folder> makes go install write there). Absent adds none."
                 }
             },
             "required": [
@@ -2049,6 +2060,10 @@ export const protocolSchema = {
                     "type": "string",
                     "description": "PropagationWait is the longest time a plugin waits, in a Finalize call, for the packages of the release to be fetchable from the registry: a duration such as \"15m\", \"0\" to not wait. Empty means the default. Only npm has such a wait. A publish never waits."
                 },
+                "packDir": {
+                    "type": "string",
+                    "description": "PackDir, when set, turns the call into a pack: the plugin writes the package file of the project's ecosystem (npm tarball, wheel and sdist, .nupkg, .gem, .crate) and returns the files in PublishResult.Assets, and publishes nothing anywhere. A workspace-relative folder. The host sends it only to a plugin with the packs capability. In a dry run the plugin lists the files it would write, writes none, and reads no registry."
+                },
                 "finalize": {
                     "type": "array",
                     "items": {
@@ -2197,6 +2212,10 @@ export const protocolSchema = {
                 "noPublish": {
                     "type": "boolean",
                     "description": "NoPublish means smith.toml says registry = \"none\": the release versions and tags the project and publishes it to no registry (a registry that builds from the tag, such as JitPack, does the rest)."
+                },
+                "packToRelease": {
+                    "type": "boolean",
+                    "description": "PackToRelease means smith.toml says registry = \"github-release\": the release packs the project into its ecosystem's package file and attaches it to the project's GitHub Release, publishing to no registry. The host sends PublishParams.PackDir to a plugin with the packs capability and never calls publish on one without it."
                 }
             }
         },
@@ -2605,7 +2624,7 @@ export const protocolSchema = {
             ]
         },
         "ToolInstall": {
-            "description": "ToolInstall is one way to get a tool with a package manager. Manager is one of: \"winget\", \"brew\", \"brew-cask\", \"apt\", \"dnf\", \"pacman\", \"npm\", \"uv\", \"fnm\", \"rustup\" and \"cargo\". The host builds the exact command from the manager and Package; Package may hold {major} and {major.minor}, which the pinned or suggested version fills. The language's own installers (uv, fnm, rustup, cargo) are offered only when they are already on the machine.",
+            "description": "ToolInstall is one way to get a tool with a package manager. Manager is one of: \"winget\", \"brew\", \"brew-cask\", \"apt\", \"dnf\", \"pacman\", \"npm\", \"uv\", \"fnm\", \"rustup\", \"cargo\" and \"go\" (go install, for a tool published as a Go module). The host builds the exact command from the manager and Package; Package may hold {major}, {major.minor} and {version} (the whole version), which the pinned or suggested version fills. The language's own installers (uv, fnm, rustup, cargo) are offered only when they are already on the machine.",
             "type": "object",
             "properties": {
                 "manager": {
@@ -2695,6 +2714,10 @@ export const protocolSchema = {
                     "type": "boolean",
                     "description": "Optional marks a tool whose absence only costs a feature (running a function app locally). Doctor reports it as a warning, not a failure."
                 },
+                "exact": {
+                    "type": "boolean",
+                    "description": "Exact says Suggested is the one version the workspace wants, such as the version CI pins: an installed version that differs, older or newer, is reported as different, and an install fetches that version."
+                },
                 "install": {
                     "type": "array",
                     "items": {

package/protocol/protocol-types.contract.d.ts

@@ -211,6 +211,12 @@ export interface Capabilities {
      * plugin that lacks it.
      */
     channels?: boolean;
+    /**
+     * Packs says publish honours PublishParams.PackDir: it writes the package file and publishes
+     * nowhere (registry = "github-release"). A host never calls publish with the setting on a plugin
+     * that lacks it, since the plugin would publish to the public registry.
+     */
+    packs?: boolean;
     /**
      * Declared says the plugin describes the projects smith.toml declares for its language
      * (DiscoverParams.declared): folders with no manifest of their own. A plugin without it finds a
@@ -668,6 +674,11 @@ export interface FixStep {
     argv: string[];
     /** Dir is where it runs, workspace-relative; empty is the workspace root. */
     dir?: string;
+    /**
+     * Env are KEY=VALUE entries added to the environment of the command (GOBIN=<folder> makes go
+     * install write there). Absent adds none.
+     */
+    env?: string[];
 }
 /**
  * GenerateParams asks a plugin to scaffold a project. The host chooses the directory from the kind
@@ -1097,6 +1108,14 @@ export interface PublishParams {
      * means the default. Only npm has such a wait. A publish never waits.
      */
     propagationWait?: string;
+    /**
+     * PackDir, when set, turns the call into a pack: the plugin writes the package file of the
+     * project's ecosystem (npm tarball, wheel and sdist, .nupkg, .gem, .crate) and returns the files
+     * in PublishResult.Assets, and publishes nothing anywhere. A workspace-relative folder. The host
+     * sends it only to a plugin with the packs capability. In a dry run the plugin lists the files it
+     * would write, writes none, and reads no registry.
+     */
+    packDir?: string;
     /**
      * Finalize turns the call into the last phase of a release: nothing is published; for each move
      * the plugin waits until its packages are fetchable, then moves the dist-tag. The host sends it
@@ -1190,6 +1209,13 @@ export interface Registries {
      * rest).
      */
     noPublish?: boolean;
+    /**
+     * PackToRelease means smith.toml says registry = "github-release": the release packs the project
+     * into its ecosystem's package file and attaches it to the project's GitHub Release, publishing
+     * to no registry. The host sends PublishParams.PackDir to a plugin with the packs capability and
+     * never calls publish on one without it.
+     */
+    packToRelease?: boolean;
 }
 /**
  * Registry is a package registry smith.toml names in [registries.<name>]: a private feed (Azure
@@ -1387,9 +1413,10 @@ export interface Task {
 }
 /**
  * ToolInstall is one way to get a tool with a package manager. Manager is one of: "winget", "brew",
- * "brew-cask", "apt", "dnf", "pacman", "npm", "uv", "fnm", "rustup" and "cargo". The host builds
- * the exact command from the manager and Package; Package may hold {major} and {major.minor}, which
- * the pinned or suggested version fills. The language's own installers (uv, fnm, rustup, cargo) are
+ * "brew-cask", "apt", "dnf", "pacman", "npm", "uv", "fnm", "rustup", "cargo" and "go" (go install,
+ * for a tool published as a Go module). The host builds the exact command from the manager and
+ * Package; Package may hold {major}, {major.minor} and {version} (the whole version), which the
+ * pinned or suggested version fills. The language's own installers (uv, fnm, rustup, cargo) are
  * offered only when they are already on the machine.
  */
 export interface ToolInstall {
@@ -1461,6 +1488,12 @@ export interface ToolNeed {
      * Doctor reports it as a warning, not a failure.
      */
     optional?: boolean;
+    /**
+     * Exact says Suggested is the one version the workspace wants, such as the version CI pins: an
+     * installed version that differs, older or newer, is reported as different, and an install
+     * fetches that version.
+     */
+    exact?: boolean;
     /** Install are the ways to get the tool, per package manager and system. */
     install?: ToolInstall[];
     /**