@monosmith/plugin-sdk 0.7.0 → 0.9.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@monosmith/plugin-sdk",
-  "version": "0.7.0",
+  "version": "0.9.0",
   "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

@@ -2605,6 +2605,17 @@ export const protocolSchema = {
                     },
                     "description": "Outputs are directories relative to the project root, restored on a cache hit."
                 },
+                "ship": {
+                    "type": "array",
+                    "items": {
+                        "type": "string"
+                    },
+                    "description": "Ship names what the task makes in a tool's work folder that the project ships: globs relative to the project root (\"../../dist/cargo/debug/api\"). After the task succeeds, smith hard-links each match into the project's shipped folder (ProjectBuildDir), a folder file by file, under its base name, and copies a file it cannot link. A glob that matches nothing is skipped. Such a task lists the shipped folder in Outputs, never the tool's work folder: a cache restore empties each output folder first."
+                },
+                "release": {
+                    "$ref": "#/$defs/TaskProfile",
+                    "description": "Release is the task as `smith run --release` runs it: the command of the optimised profile (\"cargo build --release\") and what that profile ships. Nil means the task has one profile and runs the same way with the flag. The cache key holds the command, so each profile has its own cache entry."
+                },
                 "dependsOn": {
                     "type": "array",
                     "items": {
@@ -2640,6 +2651,29 @@ export const protocolSchema = {
                 "command"
             ]
         },
+        "TaskProfile": {
+            "description": "TaskProfile is another build profile of a task: the command that builds it and what it ships (see Task.Ship).",
+            "type": "object",
+            "properties": {
+                "command": {
+                    "type": "array",
+                    "items": {
+                        "type": "string"
+                    },
+                    "description": "Command is an argv array; it is never passed through a shell."
+                },
+                "ship": {
+                    "type": "array",
+                    "items": {
+                        "type": "string"
+                    },
+                    "description": "Ship names what this profile makes in a tool's work folder that the project ships, as Task.Ship does. Empty means the task ships nothing."
+                }
+            },
+            "required": [
+                "command"
+            ]
+        },
         "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\", \"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",

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

@@ -1408,6 +1408,22 @@ export interface Task {
     inputs?: string[];
     /** Outputs are directories relative to the project root, restored on a cache hit. */
     outputs?: string[];
+    /**
+     * Ship names what the task makes in a tool's work folder that the project ships: globs relative
+     * to the project root ("../../dist/cargo/debug/api"). After the task succeeds, smith hard-links
+     * each match into the project's shipped folder (ProjectBuildDir), a folder file by file, under
+     * its base name, and copies a file it cannot link. A glob that matches nothing is skipped. Such a
+     * task lists the shipped folder in Outputs, never the tool's work folder: a cache restore empties
+     * each output folder first.
+     */
+    ship?: string[];
+    /**
+     * Release is the task as `smith run --release` runs it: the command of the optimised profile
+     * ("cargo build --release") and what that profile ships. Nil means the task has one profile and
+     * runs the same way with the flag. The cache key holds the command, so each profile has its own
+     * cache entry.
+     */
+    release?: TaskProfile;
     /**
      * DependsOn lists task names: "build" runs this project's build first, "^build" runs the build of
      * every project this one imports first.
@@ -1437,6 +1453,19 @@ export interface Task {
     /** ServeTimeout is how long to wait for ServeURL, as a Go duration ("60s"); empty means 60s. */
     serveTimeout?: string;
 }
+/**
+ * TaskProfile is another build profile of a task: the command that builds it and what it ships (see
+ * Task.Ship).
+ */
+export interface TaskProfile {
+    /** Command is an argv array; it is never passed through a shell. */
+    command: string[];
+    /**
+     * Ship names what this profile makes in a tool's work folder that the project ships, as Task.Ship
+     * does. Empty means the task ships nothing.
+     */
+    ship?: string[];
+}
 /**
  * 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,