Initial commit

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

include/starkernel/console.h

@@ -128,6 +128,24 @@ void console_puts(const char *s);
  */
 void console_println(const char *s);
 
+/**
+ * console_ensure_line_start - Make sure the next console_putc() starts at
+ * the beginning of a fresh output line, emitting a newline if output is
+ * currently mid-line (e.g. dangling behind a re-anchored prompt).
+ * No-op if already at line start. Mirrors console_putc()'s dual
+ * serial+framebuffer behavior (a bare '\n' reaches both).
+ */
+void console_ensure_line_start(void);
+
+/**
+ * console_tx_count - Monotonic count of console_putc() calls delivered to
+ * either output (serial and/or framebuffer). In use by the REPL to detect
+ * that an idle bottom half (heartbeat, USB attach/detach) wrote to the
+ * console while the top-level prompt was showing, so it can re-anchor the
+ * prompt afterward. Never decreases.
+ */
+uint64_t console_tx_count(void);
+
 /**
  * Read a single character from serial console (non-blocking)
  * Returns -1 if no character available