Implement base 9P2000 sessions, shared transports, and conformance probes

2 files changed, 120 insertions, 0 deletions

diff --git a/docs/results/batch.json b/docs/results/batch.json
new file mode 100644
index 0000000..b2d4d76
--- /dev/null
+++ b/docs/results/batch.json
@@ -0,0 +1,60 @@
+{
+  "cloud9": {
+    "allocation_evidence": "no allocator or allocation calls in codec",
+    "bytes_in": 3803125,
+    "bytes_out": 3803125,
+    "codec_allocations": 0,
+    "codec_ns": 11364700,
+    "implementation": "cloud9",
+    "operations": 540000,
+    "read_calls": 54001,
+    "write_calls": 27000
+  },
+  "configuration": {
+    "chunk": 65536,
+    "frames": 27000,
+    "go": "go1.26.5-X:nodwarf5",
+    "platform": "linux/amd64",
+    "repeats": 20,
+    "rounds": 1000,
+    "seed": 4200
+  },
+  "correctness": "all generated base-9P2000 frames agree byte-for-byte",
+  "measurement_notes": [
+    "Cloud9 codec timer excludes pipe I/O; Go timers include in-memory stream parsing and byte comparison. Do not treat these as equivalent throughput benchmarks.",
+    "Go allocations use runtime.MemStats deltas on a single-process run; cloud9 codec has no allocation API.",
+    "Cloud9 I/O counters are actual stdin/stdout syscalls; Go read counters are io.Reader calls, not syscalls.",
+    "These are wire-conformance probes, not differential filesystem-server semantics."
+  ],
+  "references": [
+    {
+      "implementation": "9fans v0.0.7",
+      "operations": 540000,
+      "codec_ns": 116434888,
+      "codec_allocations": 2509437,
+      "allocated_bytes": 486133240,
+      "read_calls": 1080000,
+      "bytes": 76062500
+    },
+    {
+      "implementation": "go9p v1.18.0",
+      "operations": 540000,
+      "codec_ns": 94922755,
+      "codec_allocations": 3130709,
+      "allocated_bytes": 289069480,
+      "read_calls": 1080000,
+      "bytes": 76062500
+    }
+  ],
+  "session": {
+    "bytes_read": 3156839,
+    "bytes_written": 646229,
+    "checks": "walk/open/write/read/stat/EOF/clunk, content oracle, fragmented requests and replies",
+    "read_calls": 454124,
+    "requests": 7003,
+    "rounds": 1000,
+    "seed": 4200,
+    "server": "go9p v1.18.0 StaticFile",
+    "write_calls": 217407
+  }
+}
diff --git a/docs/results/fragmented.json b/docs/results/fragmented.json
new file mode 100644
index 0000000..a49b23a
--- /dev/null
+++ b/docs/results/fragmented.json
@@ -0,0 +1,60 @@
+{
+  "cloud9": {
+    "allocation_evidence": "no allocator or allocation calls in codec",
+    "bytes_in": 369117,
+    "bytes_out": 369117,
+    "codec_allocations": 0,
+    "codec_ns": 1327036,
+    "implementation": "cloud9",
+    "operations": 54000,
+    "read_calls": 369118,
+    "write_calls": 369117
+  },
+  "configuration": {
+    "chunk": 1,
+    "frames": 2700,
+    "go": "go1.26.5-X:nodwarf5",
+    "platform": "linux/amd64",
+    "repeats": 20,
+    "rounds": 100,
+    "seed": 4201
+  },
+  "correctness": "all generated base-9P2000 frames agree byte-for-byte",
+  "measurement_notes": [
+    "Cloud9 codec timer excludes pipe I/O; Go timers include in-memory stream parsing and byte comparison. Do not treat these as equivalent throughput benchmarks.",
+    "Go allocations use runtime.MemStats deltas on a single-process run; cloud9 codec has no allocation API.",
+    "Cloud9 I/O counters are actual stdin/stdout syscalls; Go read counters are io.Reader calls, not syscalls.",
+    "These are wire-conformance probes, not differential filesystem-server semantics."
+  ],
+  "references": [
+    {
+      "implementation": "9fans v0.0.7",
+      "operations": 54000,
+      "codec_ns": 48042988,
+      "codec_allocations": 250519,
+      "allocated_bytes": 48088256,
+      "read_calls": 7382340,
+      "bytes": 7382340
+    },
+    {
+      "implementation": "go9p v1.18.0",
+      "operations": 54000,
+      "codec_ns": 43224680,
+      "codec_allocations": 312801,
+      "allocated_bytes": 28165920,
+      "read_calls": 7382340,
+      "bytes": 7382340
+    }
+  ],
+  "session": {
+    "bytes_read": 282585,
+    "bytes_written": 63853,
+    "checks": "walk/open/write/read/stat/EOF/clunk, content oracle, fragmented requests and replies",
+    "read_calls": 40697,
+    "requests": 703,
+    "rounds": 100,
+    "seed": 4201,
+    "server": "go9p v1.18.0 StaticFile",
+    "write_calls": 21488
+  }
+}