Added tons of AI generated docs and a lot of cleanups. No code changes. (0.41.5)

src/vm/json/parse.c

@@ -5,8 +5,28 @@
  * Copyright 2025 Johannes Findeisen <you@hanez.org>
  * Licensed under the terms of the Apache-2.0 license.
  * https://opensource.org/license/apache-2-0
+ */
+
+/**
+ * @file parse.c
+ * @brief VM opcode snippet for parsing a JSON string into a Fun Value.
  *
- * Added: 2025-11-24
+ * Implements the OP_JSON_PARSE instruction. Expects a string (or any value
+ * convertible to string) on the stack, parses it with json-c, converts the
+ * resulting json_object to a Fun Value and pushes it.
+ *
+ * Build gating: compiled only when FUN_WITH_JSON is enabled. Otherwise the
+ * opcode consumes its argument and pushes Nil.
+ *
+ * Stack effect (with FUN_WITH_JSON):
+ * - Pops: text (any; converted to string)
+ * - Pushes: Value converted from JSON, or Nil on error
+ *
+ * Errors and edge cases:
+ * - If allocation fails, tokenization fails, or the text is not valid JSON,
+ *   the opcode pushes Nil.
+ * - The temporary json-c objects are released after conversion; ownership of
+ *   the pushed Fun Value follows normal VM semantics.
  */
 
 /* JSON_PARSE */