Define remark program instruction context

packages/web/spec/program/context/remark.mdx

@@ -0,0 +1,15 @@
+---
+sidebar_position: 6
+---
+
+import SchemaViewer from "@site/src/components/SchemaViewer";
+
+# Human-readable annotations
+
+Contexts may include a human-readable comment. This feature is included to
+assist in human annotation of **ethdebug/format** data and is not primarily
+for compilers to use.
+
+<SchemaViewer
+  schema={{ id: "schema:ethdebug/format/program/context/remark" }}
+  />

packages/web/src/schemas.ts

@@ -215,7 +215,7 @@ const programSchemaIndex: SchemaIndex = {
   },
 
   ...(
-    ["code", "variables"].map(name => ({
+    ["code", "variables", "remark"].map(name => ({
       [`schema:ethdebug/format/program/context/${name}`]: {
         href: `/spec/program/context/${name}`
       }

schemas/program/context.schema.yaml

@@ -11,6 +11,7 @@ type: object
 anyOf:
   - $ref: "schema:ethdebug/format/program/context/code"
   - $ref: "schema:ethdebug/format/program/context/variables"
+  - $ref: "schema:ethdebug/format/program/context/remark"
 
 minProperties: 1
 unevaluatedProperties: false

schemas/program/context/remark.schema.yaml

@@ -0,0 +1,19 @@
+$schema: "https://json-schema.org/draft/2020-12/schema"
+$id: "schema:ethdebug/format/program/context/remark"
+
+title: ethdebug/format/program/context/remark
+description: |
+  Human-readable information about the instruction. This field is intended
+  primarily not for compilers to use directly, but rather for humans
+  (directly or indirectly) to use as an annotation field.
+
+type: object
+properties:
+  remark:
+    type: string
+
+required:
+  - remark
+
+examples:
+  - remark: "jump to end if zero"