feat(schemas): encode the wire protocol as Zod single-source-of-truth

eslint.config.ts

@@ -31,5 +31,17 @@ export default exadevConfig(
       ],
     },
   },
+  /* Test fixtures legitimately encode raw protocol values (16-byte tokens,
+     24-hex hop ids, chain lengths); naming them would obscure the fixture. */
+  {
+    files: ["**/*.test.ts"],
+    rules: { "@typescript-eslint/no-magic-numbers": "off" },
+  },
+  /* defineSchema attaches a guard to a live Zod class instance; spread would
+     destroy the prototype, so Object.assign is the only correct tool there. */
+  {
+    files: ["src/schemas/define-schema.ts"],
+    rules: { "exadev/no-object-assign": "off" },
+  },
   eslintPluginPrettierRecommended,
 );

package.json

@@ -70,7 +70,8 @@
       "koffi"
     ],
     "overrides": {
-      "eslint-plugin-jsdoc": "64.3.6"
+      "eslint-plugin-jsdoc": "64.3.6",
+      "conventional-changelog-writer": "9.2.1"
     }
   },
   "devDependencies": {
@@ -80,10 +81,12 @@
     "@commitlint/types": "21.2.0",
     "@exadev/eslint-config": "2.11.0",
     "@semantic-release/changelog": "7.0.0",
+    "@semantic-release/commit-analyzer": "13.0.1",
     "@semantic-release/exec": "7.1.0",
     "@semantic-release/git": "11.0.1",
     "@semantic-release/github": "12.0.9",
     "@semantic-release/npm": "13.1.5",
+    "@semantic-release/release-notes-generator": "14.1.1",
     "@stryker-mutator/core": "10.0.0",
     "@stryker-mutator/vitest-runner": "10.0.0",
     "@types/node": "26.4.1",

release.config.ts

@@ -6,7 +6,7 @@ const config: GlobalConfig = {
   branches: ["main"],
   plugins: [
     [
-      "semantic-release/commit-analyzer",
+      "@semantic-release/commit-analyzer",
       {
         preset: "conventionalcommits",
         releaseRules: [
@@ -25,7 +25,7 @@ const config: GlobalConfig = {
       },
     ],
     [
-      "semantic-release/release-notes-generator",
+      "@semantic-release/release-notes-generator",
       { preset: "conventionalcommits" },
     ],
     ["@semantic-release/changelog", { changelogFile: "CHANGELOG.md" }],

schemas/artifact-replies-yielded.schema.json

@@ -0,0 +1,47 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "type": {
+      "type": "string",
+      "const": "control"
+    },
+    "action": {
+      "type": "string",
+      "const": "artifact_replies_yielded"
+    },
+    "orig_msg_id": {
+      "type": "string",
+      "maxLength": 128
+    },
+    "yielded": {
+      "type": "string"
+    },
+    "not_held": {
+      "type": "string"
+    },
+    "refused": {
+      "type": "string"
+    },
+    "msgV": {
+      "type": "integer",
+      "minimum": -9007199254740991,
+      "maximum": 9007199254740991
+    },
+    "msg_id": {
+      "type": "string",
+      "minLength": 1
+    },
+    "from": {
+      "type": "string"
+    }
+  },
+  "required": [
+    "type",
+    "action",
+    "orig_msg_id",
+    "msgV",
+    "msg_id"
+  ],
+  "additionalProperties": false
+}

schemas/auth-line.schema.json

@@ -0,0 +1,19 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "type": {
+      "type": "string",
+      "const": "auth"
+    },
+    "token": {
+      "type": "string",
+      "pattern": "^[0-9a-f]{32}$"
+    }
+  },
+  "required": [
+    "type",
+    "token"
+  ],
+  "additionalProperties": false
+}