feat(versioning): snapshot corpus per spec version

A frozen spec is only meaningful if it's paired with the corpus that was current at release time — otherwise a v0.1.0 reader follows "see corpus/payloads/ack/" and lands on a file whose test vectors may have changed since v0.1.0 was cut. Three changes: 1. `cut-version` now copies BOTH src/ AND corpus/ into the snapshot directory. A release is the pair, not just the text. 2. The corpus URL rewriting in cut-version now retargets /tree/main/corpus -> /tree/main/versions/<v>/corpus (and the blob variant). This lets the link resolve on GitHub from main alone — no git tag required, since the frozen copy is a real path under main. Downgrades the "tag is REQUIRED" message from last commit back to "optionally tag the commit". 3. The frozen corpus's spec_ref fields get rewritten too: from `src/04-payload-ack.md` to `versions/<v>/04-payload-ack.md`, so a reader following a test vector lands on the spec text the vector was paired with at release time. versions/v0.1.0/ regenerated from scratch via `just cut-version v0.1.0` to pick up the corpus snapshot + the new sed patterns. The release is now self-consistent: v0.1.0 spec links go to v0.1.0 corpus, which links back to v0.1.0 spec. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-12 10:38:02 -06:00
1 parent f83d4088e3
commit 9232c16f7c
@@ -0,0 +1,97 @@
+{
+  "$schema": "../../schema/test-vector.schema.json",
+  "name": "Raw Custom Payload - Basic",
+  "spec_ref": "versions/v0.1.0/13-payload-raw-custom.md",
+  "protocol_version": 0,
+  "description": "Tests raw custom payload encoding. RAW_CUSTOM carries application-defined raw bytes.",
+  "vectors": [
+    {
+      "id": "raw-001",
+      "description": "Minimal raw custom payload (1 byte)",
+      "type": "encode_decode",
+      "structured": {
+        "header": {
+          "version": 0,
+          "payload_type": "raw_custom",
+          "route_type": "direct"
+        },
+        "path": {
+          "hash_size": 1,
+          "hash_count": 0,
+          "hashes": []
+        },
+        "payload": {
+          "data": "42"
+        }
+      },
+      "binary": "3E 00 42",
+      "notes": "Header 0x3E = RAW_CUSTOM(15)+DIRECT(2). Single byte payload."
+    },
+    {
+      "id": "raw-002",
+      "description": "Raw custom with binary data",
+      "type": "encode_decode",
+      "structured": {
+        "header": {
+          "version": 0,
+          "payload_type": "raw_custom",
+          "route_type": "direct"
+        },
+        "path": {
+          "hash_size": 1,
+          "hash_count": 1,
+          "hashes": [
+            "AA"
+          ]
+        },
+        "payload": {
+          "data": "DEADBEEFCAFEBABE"
+        }
+      },
+      "binary": "3E 01 AA DEADBEEFCAFEBABE",
+      "notes": "Direct route with 1-hop path."
+    },
+    {
+      "id": "raw-003",
+      "description": "Raw custom with all-zero payload",
+      "type": "encode_decode",
+      "structured": {
+        "header": {
+          "version": 0,
+          "payload_type": "raw_custom",
+          "route_type": "direct"
+        },
+        "path": {
+          "hash_size": 1,
+          "hash_count": 0,
+          "hashes": []
+        },
+        "payload": {
+          "data": "0000000000000000"
+        }
+      },
+      "binary": "3E 00 0000000000000000"
+    },
+    {
+      "id": "raw-004",
+      "description": "Raw custom with all-FF payload",
+      "type": "encode_decode",
+      "structured": {
+        "header": {
+          "version": 0,
+          "payload_type": "raw_custom",
+          "route_type": "direct"
+        },
+        "path": {
+          "hash_size": 1,
+          "hash_count": 0,
+          "hashes": []
+        },
+        "payload": {
+          "data": "FFFFFFFFFFFFFFFF"
+        }
+      },
+      "binary": "3E 00 FFFFFFFFFFFFFFFF"
+    }
+  ]
+}