@farmslot/protocol 0.14.0 → 0.15.0

package/dist/transport/signal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"signal.d.ts","sourceRoot":"","sources":["../../src/transport/signal.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,SAAS,EACT,yBAAyB,EACzB,sBAAsB,EACvB,MAAM,uBAAuB,CAAC;AAE/B,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC/D,OAAO,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;IAC5C,WAAW,CAAC,EAAE,yBAAyB,CAAC;IACxC,QAAQ,CAAC,EAAE,sBAAsB,CAAC;IAClC,eAAe,CAAC,EAAE,2BAA2B,CAAC;IAC9C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,2BAA2B;IAC1C,aAAa,EAAE,CAAC,CAAC;IACjB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,MAAM,EAAE,0BAA0B,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,0BAA0B;IACzC,kFAAkF;IAClF,UAAU,EAAE,MAAM,CAAC;IACnB,0FAA0F;IAC1F,KAAK,EAAE,MAAM,CAAC;IACd,6EAA6E;IAC7E,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,sEAAsE;AACtE,MAAM,MAAM,qBAAqB,GAC7B,OAAO,GACP,SAAS,GACT,cAAc,GACd,SAAS,GACT,cAAc,GACd,gBAAgB,GAChB,cAAc,GACd,kBAAkB,GAClB,OAAO,CAAC;AAEZ,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,OAAO,CAAC;IACZ,IAAI,EAAE,qBAAqB,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,kFAAkF;IAClF,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB"}
+{"version":3,"file":"signal.d.ts","sourceRoot":"","sources":["../../src/transport/signal.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,SAAS,EACT,yBAAyB,EACzB,sBAAsB,EACvB,MAAM,uBAAuB,CAAC;AAE/B,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC/D,OAAO,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;IAC5C,WAAW,CAAC,EAAE,yBAAyB,CAAC;IACxC,QAAQ,CAAC,EAAE,sBAAsB,CAAC;IAClC,eAAe,CAAC,EAAE,2BAA2B,CAAC;IAC9C,eAAe,CAAC,EAAE,2BAA2B,CAAC;IAC9C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wFAAwF;IACxF,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,2BAA2B;IAC1C,0EAA0E;IAC1E,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,2BAA2B;IAC1C,aAAa,EAAE,CAAC,CAAC;IACjB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,MAAM,EAAE,0BAA0B,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,0BAA0B;IACzC,kFAAkF;IAClF,UAAU,EAAE,MAAM,CAAC;IACnB,0FAA0F;IAC1F,KAAK,EAAE,MAAM,CAAC;IACd,6EAA6E;IAC7E,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,sEAAsE;AACtE,MAAM,MAAM,qBAAqB,GAC7B,OAAO,GACP,SAAS,GACT,cAAc,GACd,SAAS,GACT,cAAc,GACd,gBAAgB,GAChB,cAAc,GACd,kBAAkB,GAClB,OAAO,GACP,mBAAmB,GACnB,kCAAkC,CAAC;AAEvC,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,OAAO,CAAC;IACZ,IAAI,EAAE,qBAAqB,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,kFAAkF;IAClF,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB"}

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-export declare const PROTOCOL_VERSION = "0.14.0";
+export declare const PROTOCOL_VERSION = "0.15.0";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -3,5 +3,5 @@
 // fleet can be upgraded deliberately; optional method/event fields remain
 // backward-compatible unless a caller requires a new node capability.
 // Format: semver-ish, increment when methods/events/frame format changes.
-export const PROTOCOL_VERSION = '0.14.0';
+export const PROTOCOL_VERSION = '0.15.0';
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farmslot/protocol",
-  "version": "0.14.0",
+  "version": "0.15.0",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/schemas/recipe-suite-result-v1.schema.json

@@ -0,0 +1,134 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://farmslot.io/schemas/recipe-suite-result-v1.schema.json",
+  "title": "Farmslot Recipe Suite Result v1",
+  "description": "A fail-closed resolution for every case in an immutable recipe suite scope.",
+  "type": "object",
+  "required": ["$schema", "suite_id", "scope_digest", "totals", "resolutions"],
+  "properties": {
+    "$schema": {
+      "const": "https://farmslot.io/schemas/recipe-suite-result-v1.schema.json",
+      "description": "Canonical Recipe Suite Result v1 schema URL."
+    },
+    "suite_id": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Suite identifier copied from the frozen scope."
+    },
+    "scope_digest": {
+      "type": "string",
+      "pattern": "^sha256:[a-f0-9]{64}$",
+      "description": "SHA-256 digest of the canonical frozen scope document."
+    },
+    "totals": {
+      "$ref": "#/$defs/totals",
+      "description": "Derived counts that must reconcile with the scope and resolutions."
+    },
+    "resolutions": {
+      "type": "array",
+      "minItems": 1,
+      "description": "Exactly one verdict or explicit non-execution record per declared case.",
+      "items": {
+        "oneOf": [{ "$ref": "#/$defs/verdict" }, { "$ref": "#/$defs/notExecuted" }]
+      }
+    }
+  },
+  "additionalProperties": false,
+  "$defs": {
+    "totals": {
+      "type": "object",
+      "required": ["declared", "executed", "not_executed"],
+      "properties": {
+        "declared": {
+          "type": "integer",
+          "minimum": 1,
+          "description": "Number of cases in the frozen scope."
+        },
+        "executed": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Number of cases resolved by retained recipe-run summaries."
+        },
+        "not_executed": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Number of cases carrying explicit non-execution records."
+        }
+      },
+      "additionalProperties": false
+    },
+    "verdict": {
+      "type": "object",
+      "required": ["id", "kind", "status", "summary_path", "summary_digest"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Declared case identifier this verdict resolves."
+        },
+        "kind": {
+          "const": "verdict",
+          "description": "Marks a case resolved by a completed recipe run."
+        },
+        "status": {
+          "enum": ["pass", "fail", "unknown"],
+          "description": "Terminal status copied from the retained summary."
+        },
+        "summary_path": {
+          "type": "string",
+          "minLength": 1,
+          "pattern": "^(?![A-Za-z]:)(?![\\\\/])(?!.*(?:^|[\\\\/])\\.\\.(?:[\\\\/]|$)).+$",
+          "description": "Safe relative path to the retained summary in the suite package."
+        },
+        "summary_digest": {
+          "type": "string",
+          "pattern": "^sha256:[a-f0-9]{64}$",
+          "description": "SHA-256 digest of the canonical retained summary document."
+        }
+      },
+      "additionalProperties": false
+    },
+    "notExecuted": {
+      "type": "object",
+      "required": ["id", "kind", "reason_class", "detail"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Declared case identifier that was not executed."
+        },
+        "kind": {
+          "const": "not_executed",
+          "description": "Marks a case resolved by an explicit non-execution reason."
+        },
+        "reason_class": {
+          "enum": ["prerequisite_missing", "ordering_dependent", "needs_manual", "oversight"],
+          "description": "Machine-readable reason the case did not execute."
+        },
+        "detail": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Specific explanation for this non-execution decision."
+        },
+        "blocked_by": {
+          "type": "array",
+          "minItems": 1,
+          "uniqueItems": true,
+          "items": { "type": "string", "minLength": 1 },
+          "description": "Declared case IDs blocking an ordering-dependent case."
+        }
+      },
+      "additionalProperties": false,
+      "allOf": [
+        {
+          "if": {
+            "properties": { "reason_class": { "const": "ordering_dependent" } },
+            "required": ["reason_class"]
+          },
+          "then": { "properties": { "blocked_by": true }, "required": ["blocked_by"] },
+          "else": { "not": { "required": ["blocked_by"] } }
+        }
+      ]
+    }
+  }
+}

package/schemas/recipe-suite-scope-v1.schema.json

@@ -0,0 +1,41 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://farmslot.io/schemas/recipe-suite-scope-v1.schema.json",
+  "title": "Farmslot Recipe Suite Scope v1",
+  "description": "The immutable set of opaque cases a recipe suite must resolve.",
+  "type": "object",
+  "required": ["$schema", "suite_id", "cases"],
+  "properties": {
+    "$schema": {
+      "const": "https://farmslot.io/schemas/recipe-suite-scope-v1.schema.json",
+      "description": "Canonical Recipe Suite Scope v1 schema URL."
+    },
+    "suite_id": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Stable identifier shared by the scope and its result."
+    },
+    "cases": {
+      "type": "array",
+      "minItems": 1,
+      "uniqueItems": true,
+      "description": "Complete case set frozen before any case executes.",
+      "items": { "$ref": "#/$defs/case" }
+    }
+  },
+  "additionalProperties": false,
+  "$defs": {
+    "case": {
+      "type": "object",
+      "required": ["id"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Opaque case identifier unique within the suite."
+        }
+      },
+      "additionalProperties": false
+    }
+  }
+}