Initial commit

Signed-off-by: Robert Allan James <robert.allan.james@gmail.com>

include/starkernel/repl.h

@@ -120,12 +120,20 @@ int sk_console_key_available(void);
  * uses internally, so a mid-word EXPECT behaves identically to typing at
  * "ok>" itself.
  *
- * @param buf        Destination buffer
- * @param size       Buffer capacity, including the NUL terminator
- * @param active_vm  VM whose idle dispatch runs while waiting
+ * @param buf            Destination buffer
+ * @param size           Buffer capacity, including the NUL terminator
+ * @param active_vm      VM whose idle dispatch runs while waiting
+ * @param reanchor_prompt  Nonzero to re-print the "ok> " prompt whenever
+ *                an idle bottom half (heartbeat, USB attach/detach) writes
+ *                to the console while this readline blocks at a bare,
+ *                untyped prompt -- keeps the top-level prompt as the last
+ *                thing shown once the chatter dies down. Callers whose
+ *                prompt line is their own (shim.c's fgets(), i.e.
+ *                QUERY/EXPECT/ACCEPT) pass 0 so "ok> " never gets stamped
+ *                onto their mid-word input context.
  * @return number of characters placed in buf, not counting the NUL
  */
-int sk_console_readline(char *buf, int size, VM *active_vm);
+int sk_console_readline(char* buf, int size, VM* active_vm, int reanchor_prompt);
 
 #ifdef __cplusplus
 }