From d0fd562102363667dffdc9ff4a01afdeaf431fe6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C5=8Dshin?= <git@wholezero.org>
Date: Thu, 1 Apr 2021 03:42:44 +0000
Subject: [PATCH] khan: thoughts in conn_cb

---
 pkg/urbit/vere/io/khan.c | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/pkg/urbit/vere/io/khan.c b/pkg/urbit/vere/io/khan.c
index 63d0aa85e5..aba5f4bf21 100644
--- a/pkg/urbit/vere/io/khan.c
+++ b/pkg/urbit/vere/io/khan.c
@@ -86,6 +86,21 @@ static void
 _khan_conn_cb(uv_stream_t* sem_u, c3_i tas_i)
 {
   // TODO interact
+  //
+  // There are four cases to think about here:
+  //
+  // 1. peek, runtime
+  // 2. poke, runtime
+  // 3. peek, arvo
+  // 4. poke, arvo
+  //
+  // For 1, we support a few simple text commands:
+  // ok - says "ok" (basic health test)
+  // dump - dumps runtime stat counters in simple machine/human-readable format
+  //
+  // There is not yet a use case for 2.
+  //
+  // For 3 and 4, we speak the language documented in the khan vane in arvo.
 }
 
 /* u3_khan(): initialize control plane socket.