From 0eab292eb4575d8aaa8837f141de0eb42ebd7cc7 Mon Sep 17 00:00:00 2001
From: igarbayo <ignacio.garbayo@rai.usc.es>
Date: Mon, 16 Mar 2026 23:41:47 +0100
Subject: [PATCH 01/15] feat: add interactive REPL for manual testing

---
 README.md                                     |  39 +-
 build.gradle                                  |   9 +
 docs/manual-testing-guide.md                  | 314 ++++++++++++++++
 gradle.properties                             |   2 +
 src/main/java/com/terminal/buffer/Main.java   | 351 ++++++++++++++++++
 .../com/terminal/buffer/TerminalBuffer.java   |  12 +-
 6 files changed, 719 insertions(+), 8 deletions(-)
 create mode 100644 docs/manual-testing-guide.md
 create mode 100644 gradle.properties
 create mode 100644 src/main/java/com/terminal/buffer/Main.java

diff --git a/README.md b/README.md
index ef06081..5efce1d 100644
--- a/README.md
+++ b/README.md
@@ -10,6 +10,43 @@ A terminal text buffer implementation in Java — the core data structure used b
 
 Requires Java 8+. No external libraries except JUnit 5 for testing.
 
+## Interactive REPL
+
+A command-line REPL is included to test the buffer manually:
+
+```bash
+./gradlew run --console=plain -q
+```
+
+Type `help` inside the REPL to list all commands, or see the table below:
+
+| Command | Description |
+|---|---|
+| `write <text>` | Write text at cursor position (overwrite) |
+| `insert <text>` | Insert text at cursor, shifting content right |
+| `fill [char]` | Fill current line with character (space if omitted) |
+| `newline` | Insert empty line at bottom, scroll top to scrollback |
+| `clear` | Clear screen and reset cursor to (0, 0) |
+| `clearall` | Clear screen, scrollback, and reset cursor |
+| `cursor <col> <row>` | Move cursor to position |
+| `move up\|down\|left\|right [n]` | Move cursor N steps (default 1) |
+| `fg <COLOR>` | Set foreground color |
+| `bg <COLOR>` | Set background color |
+| `bold` / `italic` / `underline` | Enable text style |
+| `nostyle <STYLE>` | Disable text style |
+| `reset` | Reset all attributes to default |
+| `resize <w> <h>` | Resize the buffer |
+| `print` | Repaint the buffer |
+| `scrollback` | Print scrollback history |
+| `info` | Show dimensions, cursor, and current attributes |
+| `codepoints <text>` | Show Unicode code points (debug) |
+| `exit` / `quit` | Exit the REPL |
+
+Colors: `DEFAULT RED GREEN YELLOW BLUE MAGENTA CYAN WHITE BLACK` and `BRIGHT_*` variants.
+
+See [docs/manual-testing-guide.md](docs/manual-testing-guide.md) for a full walkthrough
+of every feature and edge case, including expected output for each command.
+
 ---
 
 ## Architecture
@@ -139,4 +176,4 @@ This implementation was built using **TDD (Test-Driven Development)** in a botto
 11. Wide character support
 12. Resize
 
-We'all use Git Flow branching for feature development and pull requests for code review. Each commit is focused on a single behavior or refactor, with descriptive messages.
+We'll use Git Flow branching for feature development and pull requests for code review. Each commit is focused on a single behavior or refactor, with descriptive messages.
diff --git a/build.gradle b/build.gradle
index a4bae0f..b608b5c 100644
--- a/build.gradle
+++ b/build.gradle
@@ -1,5 +1,14 @@
 plugins {
     id 'java'
+    id 'application'
+}
+
+application {
+    mainClass = 'com.terminal.buffer.Main'
+}
+
+run {
+    standardInput = System.in
 }
 
 group = 'com.terminal'
diff --git a/docs/manual-testing-guide.md b/docs/manual-testing-guide.md
new file mode 100644
index 0000000..78a5a43
--- /dev/null
+++ b/docs/manual-testing-guide.md
@@ -0,0 +1,314 @@
+# Manual Testing Guide — Terminal Text Buffer REPL
+
+This guide covers how to run the interactive REPL and test every feature of
+`TerminalBuffer` by hand, including edge cases and boundary conditions.
+
+## Starting the REPL
+
+```bash
+./gradlew run --console=plain -q
+```
+
+The REPL starts with an 80×24 buffer and 200-line scrollback. Type `help` at any
+point to list all available commands.
+
+> **Note on wide characters (CJK/emoji):** PowerShell and CMD replace CJK characters
+> with `?` before they reach Java, so wide character input is only verifiable through
+> the automated tests (`./gradlew test`) or via IntelliJ's built-in terminal /
+> Windows Terminal with `chcp 65001`.
+
+---
+
+## 1. Basic `writeText`
+
+```
+write Hola mundo
+```
+Expected: text appears at row 0 col 0; cursor moves to (10, 0).
+
+```
+cursor 5 2
+write Texto centrado
+```
+Expected: text starts at col 5 row 2.
+
+### Edge case — right-edge wrap (pending wrap flag)
+
+```
+clear
+cursor 75 0
+write 123456789012345
+```
+Expected: `12345` fits in cols 75–79; the remaining `678901234` wraps to row 1 col 0.
+Cursor stays at the position after the last written character.
+
+---
+
+## 2. Colors and styles
+
+```
+clear
+fg RED
+bold
+write Texto rojo negrita
+cursor 0 1
+fg BLUE
+italic
+write Texto azul cursiva
+reset
+cursor 0 2
+write Texto normal
+```
+Expected: row 0 in red+bold, row 1 in blue+italic, row 2 in default style.
+
+Available colors: `DEFAULT RED GREEN YELLOW BLUE MAGENTA CYAN WHITE BLACK`
+and their `BRIGHT_*` variants.
+
+Available styles: `bold`, `italic`, `underline`. Deactivate with `nostyle BOLD` etc.
+
+---
+
+## 3. Cursor movement
+
+```
+cursor 0 0
+move right 5
+move down 3
+info
+```
+Expected: cursor at (5, 3).
+
+### Edge case — cursor clamped at screen bounds
+
+```
+cursor 0 0
+move up 10
+info
+```
+Expected: cursor stays at (0, 0) — cannot move above row 0.
+
+```
+cursor 79 23
+move right 5
+move down 5
+info
+```
+Expected: cursor stays at (79, 23) — cannot move beyond last col/row.
+
+---
+
+## 4. `fillLine`
+
+```
+clear
+cursor 0 1
+fill -
+cursor 0 3
+fill =
+```
+Expected: row 1 filled with `-`, row 3 filled with `=`.
+
+```
+cursor 0 5
+fill
+```
+Expected: row 5 filled with spaces (clears it).
+
+---
+
+## 5. `insertEmptyLine` and scrollback
+
+```
+clear
+cursor 0 0
+write Linea 1
+newline
+write Linea 2
+newline
+write Linea 3
+scrollback
+```
+Expected: after each `newline`, the top row scrolls into scrollback.
+`scrollback` shows `[-2] Linea 1` and `[-1] Linea 2` (Linea 3 is still on screen).
+
+### Fill scrollback
+
+```
+clearall
+cursor 0 0
+write AAA
+newline
+write BBB
+newline
+write CCC
+newline
+scrollback
+```
+Expected:
+```
+[-3] AAA
+[-2] BBB
+[-1] CCC
+```
+
+---
+
+## 6. `insertText` — shift right
+
+```
+clear
+cursor 0 0
+write ABCDE
+cursor 2 0
+insert XXX
+```
+Expected: row 0 becomes `ABXXXCDE` — existing content shifts right.
+
+### Edge case — overflow to next line
+
+```
+clear
+cursor 0 0
+write 12345678901234567890123456789012345678901234567890123456789012345678901234567890
+cursor 0 0
+insert OVERFLOW
+```
+Expected: `OVERFLOW` is inserted at col 0, shifting the 80 existing chars right.
+The last 8 characters fall to row 1 col 0.
+
+---
+
+## 7. Wide characters
+
+> Requires IntelliJ terminal or Windows Terminal with UTF-8 (see note above).
+
+```
+clear
+cursor 0 0
+write 日本語
+info
+```
+Expected: cursor at (6, 0) — each CJK character occupies 2 cells.
+
+### Edge case — wide char at right edge
+
+```
+clear
+cursor 79 0
+write 日
+```
+Expected: no room for both halves; column 79 is left empty, cursor stays at 79.
+
+### Verify code points (debug command)
+
+```
+codepoints 日本語
+```
+Expected: `U+65E5`, `U+672C`, `U+8A9E` — all detected as `isWide=true`.
+
+---
+
+## 8. Resize
+
+```
+clear
+write Texto que puede quedar cortado
+resize 20 5
+print
+```
+Expected: screen is 20×5. The text is **truncated at col 20** in the row that contained
+it. Rows removed from the top (shrinking from 24 to 5 rows) enter scrollback.
+Run `scrollback` to confirm the text is preserved there.
+
+```
+resize 80 24
+```
+Restores original dimensions. Previous scrollback entries are still accessible.
+
+---
+
+## 9. `clearScreen` vs `clearAll`
+
+```
+clearall
+cursor 0 0
+write Primera linea
+newline
+write Segunda linea
+newline
+scrollback
+```
+Expected: `[-2] Primera linea`, `[-1] Segunda linea`.
+
+```
+clear
+scrollback
+```
+Expected: screen is blank, but scrollback **still shows 2 entries** — `clear` does not
+touch scrollback.
+
+```
+clearall
+scrollback
+```
+Expected: `--- Scrollback vacio ---` — `clearall` wipes everything including scrollback.
+
+---
+
+## 10. Full demo sequence
+
+Combines all features: colors, cursor movement, fill, insert, scrollback, and resize.
+
+```
+clearall
+fg GREEN
+bold
+write === Terminal Buffer Demo ===
+reset
+cursor 0 2
+write Linea normal
+cursor 0 3
+fg YELLOW
+write Linea amarilla
+reset
+cursor 0 4
+fill -
+newline
+newline
+newline
+scrollback
+cursor 0 0
+insert INSERCION AL PRINCIPIO
+resize 40 10
+print
+resize 80 24
+```
+
+---
+
+## Automated tests
+
+All features and edge cases are also covered by the JUnit 5 test suite:
+
+```bash
+./gradlew test
+```
+
+HTML report: `build/reports/tests/test/index.html`
+
+| Test class | What it covers |
+|---|---|
+| `CellAttributesTest` | Immutability, fluent builders, equality |
+| `CellTest` | Wide cell types, EMPTY sentinel |
+| `RowTest` | get/set, fill, copy constructor |
+| `CursorTest` | setCursor clamping, move in all directions |
+| `AttributeStateTest` | setForeground/Background, addStyle/removeStyle, reset |
+| `ClearScreenTest` | clearScreen preserves scrollback; clearAll wipes both |
+| `WriteTextTest` | Overwrite, pending wrap, attribute storage |
+| `FillLineTest` | Fill entire row, cursor row selection |
+| `InsertEmptyLineTest` | Row push to scrollback, deque ordering |
+| `ScrollbackTest` | Max scrollback eviction, negative row indexing |
+| `InsertTextTest` | Shift right, overflow to next line |
+| `ContentAccessTest` | getLine trimming, getRawLine fixed width, getAllContent |
+| `WideCharTest` | 2-cell rendering, right-edge truncation |
+| `ResizeTest` | Truncate/pad rows, height shrink → scrollback |
diff --git a/gradle.properties b/gradle.properties
new file mode 100644
index 0000000..9a58b79
--- /dev/null
+++ b/gradle.properties
@@ -0,0 +1,2 @@
+org.gradle.java.home=C:\\Program Files\\Java\\jdk1.8.0_261
+org.gradle.console=plain
diff --git a/src/main/java/com/terminal/buffer/Main.java b/src/main/java/com/terminal/buffer/Main.java
new file mode 100644
index 0000000..111a2ce
--- /dev/null
+++ b/src/main/java/com/terminal/buffer/Main.java
@@ -0,0 +1,351 @@
+package com.terminal.buffer;
+
+import java.util.Scanner;
+import java.util.Set;
+
+public class Main {
+
+    private static TerminalBuffer buf = new TerminalBuffer(80, 24, 200);
+
+    public static void main(String[] args) {
+        printHelp();
+        printBuffer();
+
+        try (Scanner scanner = new Scanner(System.in, "UTF-8")) {
+            while (scanner.hasNextLine()) {
+                String line = scanner.nextLine().trim();
+                if (line.isEmpty()) continue;
+
+                boolean changed = handleCommand(line);
+                if (changed) printBuffer();
+            }
+        }
+    }
+
+    private static boolean handleCommand(String line) {
+        String[] parts = line.split(" ", 2);
+        String cmd = parts[0].toLowerCase();
+        String arg = parts.length > 1 ? parts[1] : "";
+
+        try {
+            switch (cmd) {
+                case "write":
+                    if (arg.isEmpty()) { err("write <texto>"); return false; }
+                    buf.writeText(arg);
+                    return true;
+
+                case "insert":
+                    if (arg.isEmpty()) { err("insert <texto>"); return false; }
+                    buf.insertText(arg);
+                    return true;
+
+                case "fill": {
+                    char ch = arg.isEmpty() ? ' ' : arg.charAt(0);
+                    buf.fillLine(ch);
+                    return true;
+                }
+
+                case "newline":
+                    buf.insertEmptyLine();
+                    return true;
+
+                case "clear":
+                    buf.clearScreen();
+                    buf.setCursor(0, 0);
+                    return true;
+
+                case "clearall":
+                    buf.clearAll();
+                    buf.setCursor(0, 0);
+                    return true;
+
+                case "cursor": {
+                    String[] xy = arg.split(" ");
+                    if (xy.length < 2) { err("cursor <col> <row>"); return false; }
+                    buf.setCursor(Integer.parseInt(xy[0]), Integer.parseInt(xy[1]));
+                    return true;
+                }
+
+                case "move": {
+                    String[] mv = arg.split(" ");
+                    String dir = mv[0].toLowerCase();
+                    int n = mv.length > 1 ? Integer.parseInt(mv[1]) : 1;
+                    switch (dir) {
+                        case "up":    buf.moveCursorUp(n);    break;
+                        case "down":  buf.moveCursorDown(n);  break;
+                        case "left":  buf.moveCursorLeft(n);  break;
+                        case "right": buf.moveCursorRight(n); break;
+                        default: err("move up|down|left|right [n]"); return false;
+                    }
+                    return true;
+                }
+
+                case "fg":
+                    if (arg.isEmpty()) { err("fg <COLOR>"); return false; }
+                    buf.setForeground(TerminalColor.valueOf(arg.toUpperCase()));
+                    return true;
+
+                case "bg":
+                    if (arg.isEmpty()) { err("bg <COLOR>"); return false; }
+                    buf.setBackground(TerminalColor.valueOf(arg.toUpperCase()));
+                    return true;
+
+                case "bold":
+                    buf.addStyle(TextStyle.BOLD);
+                    return true;
+
+                case "italic":
+                    buf.addStyle(TextStyle.ITALIC);
+                    return true;
+
+                case "underline":
+                    buf.addStyle(TextStyle.UNDERLINE);
+                    return true;
+
+                case "nostyle":
+                    if (arg.isEmpty()) { err("nostyle BOLD|ITALIC|UNDERLINE"); return false; }
+                    buf.removeStyle(TextStyle.valueOf(arg.toUpperCase()));
+                    return true;
+
+                case "reset":
+                    buf.resetAttributes();
+                    return true;
+
+                case "resize": {
+                    String[] wh = arg.split(" ");
+                    if (wh.length < 2) { err("resize <w> <h>"); return false; }
+                    buf.resize(Integer.parseInt(wh[0]), Integer.parseInt(wh[1]));
+                    return true;
+                }
+
+                case "print":
+                    return true;
+
+                case "scrollback":
+                    printScrollback();
+                    return false;
+
+                case "info":
+                    printInfo();
+                    return false;
+
+                case "codepoints":
+                    if (arg.isEmpty()) { err("codepoints <texto>"); return false; }
+                    for (int i = 0; i < arg.length(); ) {
+                        int cp = arg.codePointAt(i);
+                        System.out.printf("  U+%04X  isWide=%-5b  char=%s%n",
+                                cp, cp >= 0x4E00 && cp <= 0x9FFF, new String(Character.toChars(cp)));
+                        i += Character.charCount(cp);
+                    }
+                    System.out.print("> ");
+                    System.out.flush();
+                    return false;
+
+                case "help":
+                    printHelp();
+                    return false;
+
+                case "exit":
+                case "quit":
+                    System.out.println("Hasta luego.");
+                    System.exit(0);
+                    return false;
+
+                default:
+                    err("Comando desconocido: '" + cmd + "'. Escribe 'help' para ver los comandos.");
+                    return false;
+            }
+        } catch (IllegalArgumentException e) {
+            err("Error: " + e.getMessage());
+            return false;
+        }
+    }
+
+    // -------------------------------------------------------------------------
+    // Print buffer
+    // -------------------------------------------------------------------------
+
+    private static void printBuffer() {
+        int w = buf.getWidth();
+        String top    = "\u250c" + repeat("\u2500", w) + "\u2510";
+        String bottom = "\u2514" + repeat("\u2500", w) + "\u2518";
+
+        System.out.println(top);
+        CursorPosition cur = buf.getCursor();
+        for (int row = 0; row < buf.getHeight(); row++) {
+            StringBuilder sb = new StringBuilder("\u2502");
+            CellAttributes prev = null;
+            for (int col = 0; col < w; col++) {
+                Cell cell = buf.getCell(col, row);
+                CellAttributes attrs = cell.getAttributes();
+                if (!attrs.equals(prev)) {
+                    sb.append("\033[0m");
+                    sb.append(ansiAttrs(attrs));
+                    prev = attrs;
+                }
+                boolean isCursor = (col == cur.getCol() && row == cur.getRow());
+                char ch = cell.getCharacter();
+                if (isCursor) {
+                    sb.append(ch == ' ' || ch == '\0' ? '\u258c' : ch);
+                } else {
+                    sb.append(ch == '\0' ? ' ' : ch);
+                }
+            }
+            sb.append("\033[0m\u2502");
+            System.out.println(sb);
+        }
+        System.out.println(bottom);
+
+        CellAttributes attrs = buf.getAttributes();
+        Set<TextStyle> styles = attrs.getStyles();
+        System.out.printf("Cursor: (%d, %d)  fg=%-14s bg=%-14s estilos=[%s%s]  Scrollback: %d lineas%n",
+                cur.getCol(), cur.getRow(),
+                attrs.getForeground(),
+                attrs.getBackground(),
+                styles.isEmpty() ? "ninguno" : "",
+                styles.isEmpty() ? "" : styleList(styles),
+                buf.getScrollbackSize());
+        System.out.print("> ");
+        System.out.flush();
+    }
+
+    private static String styleList(Set<TextStyle> styles) {
+        StringBuilder sb = new StringBuilder();
+        for (TextStyle s : styles) {
+            if (sb.length() > 0) sb.append(", ");
+            sb.append(s.name());
+        }
+        return sb.toString();
+    }
+
+    // -------------------------------------------------------------------------
+    // Print scrollback
+    // -------------------------------------------------------------------------
+
+    private static void printScrollback() {
+        int size = buf.getScrollbackSize();
+        if (size == 0) {
+            System.out.println("--- Scrollback vacio ---");
+            System.out.print("> ");
+            System.out.flush();
+            return;
+        }
+        System.out.println("--- Scrollback (" + size + " lineas, mas antigua primero) ---");
+        for (int i = -size; i <= -1; i++) {
+            String content = buf.getLine(i);
+            System.out.printf("[%3d] %s%n", i, content);
+        }
+        System.out.print("> ");
+        System.out.flush();
+    }
+
+    // -------------------------------------------------------------------------
+    // Print info
+    // -------------------------------------------------------------------------
+
+    private static void printInfo() {
+        CursorPosition cur = buf.getCursor();
+        CellAttributes attrs = buf.getAttributes();
+        System.out.println("Dimensiones : " + buf.getWidth() + " x " + buf.getHeight());
+        System.out.println("Scrollback  : " + buf.getScrollbackSize() + " / " + buf.getMaxScrollback() + " lineas");
+        System.out.println("Cursor      : col=" + cur.getCol() + " row=" + cur.getRow());
+        System.out.println("Foreground  : " + attrs.getForeground());
+        System.out.println("Background  : " + attrs.getBackground());
+        Set<TextStyle> styles = attrs.getStyles();
+        System.out.println("Estilos     : " + (styles.isEmpty() ? "ninguno" : styleList(styles)));
+        System.out.print("> ");
+        System.out.flush();
+    }
+
+    // -------------------------------------------------------------------------
+    // Help
+    // -------------------------------------------------------------------------
+
+    private static void printHelp() {
+        System.out.println("╔══════════════════════════════════════════════════════╗");
+        System.out.println("║          Terminal Text Buffer — REPL                 ║");
+        System.out.println("╠══════════════════════════════════════════════════════╣");
+        System.out.println("║ Escritura                                            ║");
+        System.out.println("║   write <texto>              Escribe en posicion     ║");
+        System.out.println("║   insert <texto>             Inserta (hace shift)    ║");
+        System.out.println("║   fill [char]                Rellena la linea actual ║");
+        System.out.println("║   newline                    Inserta linea vacia     ║");
+        System.out.println("╠══════════════════════════════════════════════════════╣");
+        System.out.println("║ Cursor                                               ║");
+        System.out.println("║   cursor <col> <row>         Mueve el cursor         ║");
+        System.out.println("║   move up|down|left|right [n]  Mueve N posiciones    ║");
+        System.out.println("╠══════════════════════════════════════════════════════╣");
+        System.out.println("║ Atributos                                            ║");
+        System.out.println("║   fg <COLOR>                 Color de texto          ║");
+        System.out.println("║   bg <COLOR>                 Color de fondo          ║");
+        System.out.println("║   bold | italic | underline  Activa estilo           ║");
+        System.out.println("║   nostyle BOLD|ITALIC|UNDERLINE  Desactiva estilo    ║");
+        System.out.println("║   reset                      Resetea atributos       ║");
+        System.out.println("║ Colores: DEFAULT RED GREEN YELLOW BLUE MAGENTA       ║");
+        System.out.println("║          CYAN WHITE BLACK  (y BRIGHT_* variantes)    ║");
+        System.out.println("╠══════════════════════════════════════════════════════╣");
+        System.out.println("║ Pantalla                                             ║");
+        System.out.println("║   clear                      Limpia la pantalla      ║");
+        System.out.println("║   clearall                   Limpia pantalla+scrollb ║");
+        System.out.println("║   resize <w> <h>             Redimensiona el buffer  ║");
+        System.out.println("╠══════════════════════════════════════════════════════╣");
+        System.out.println("║ Info                                                 ║");
+        System.out.println("║   print                      Repinta el buffer       ║");
+        System.out.println("║   scrollback                 Muestra el scrollback   ║");
+        System.out.println("║   info                       Estado actual           ║");
+        System.out.println("║   help                       Muestra esta ayuda      ║");
+        System.out.println("║   exit / quit                Salir                   ║");
+        System.out.println("╚══════════════════════════════════════════════════════╝");
+    }
+
+    // -------------------------------------------------------------------------
+    // Helpers
+    // -------------------------------------------------------------------------
+
+    private static void err(String msg) {
+        System.out.println("  [!] " + msg);
+        System.out.print("> ");
+        System.out.flush();
+    }
+
+    private static String repeat(String s, int n) {
+        StringBuilder sb = new StringBuilder();
+        for (int i = 0; i < n; i++) sb.append(s);
+        return sb.toString();
+    }
+
+    private static String ansiAttrs(CellAttributes attrs) {
+        StringBuilder sb = new StringBuilder();
+        if (attrs.hasStyle(TextStyle.BOLD))      sb.append("\033[1m");
+        if (attrs.hasStyle(TextStyle.ITALIC))    sb.append("\033[3m");
+        if (attrs.hasStyle(TextStyle.UNDERLINE)) sb.append("\033[4m");
+        String fg = ansiColor(attrs.getForeground(), false);
+        if (!fg.isEmpty()) sb.append(fg);
+        String bg = ansiColor(attrs.getBackground(), true);
+        if (!bg.isEmpty()) sb.append(bg);
+        return sb.toString();
+    }
+
+    private static String ansiColor(TerminalColor color, boolean background) {
+        int base = background ? 40 : 30;
+        switch (color) {
+            case BLACK:          return "\033[" + base + "m";
+            case RED:            return "\033[" + (base + 1) + "m";
+            case GREEN:          return "\033[" + (base + 2) + "m";
+            case YELLOW:         return "\033[" + (base + 3) + "m";
+            case BLUE:           return "\033[" + (base + 4) + "m";
+            case MAGENTA:        return "\033[" + (base + 5) + "m";
+            case CYAN:           return "\033[" + (base + 6) + "m";
+            case WHITE:          return "\033[" + (base + 7) + "m";
+            case BRIGHT_BLACK:   return "\033[" + (base + 60) + "m";
+            case BRIGHT_RED:     return "\033[" + (base + 61) + "m";
+            case BRIGHT_GREEN:   return "\033[" + (base + 62) + "m";
+            case BRIGHT_YELLOW:  return "\033[" + (base + 63) + "m";
+            case BRIGHT_BLUE:    return "\033[" + (base + 64) + "m";
+            case BRIGHT_MAGENTA: return "\033[" + (base + 65) + "m";
+            case BRIGHT_CYAN:    return "\033[" + (base + 66) + "m";
+            case BRIGHT_WHITE:   return "\033[" + (base + 67) + "m";
+            default:             return "";
+        }
+    }
+}
diff --git a/src/main/java/com/terminal/buffer/TerminalBuffer.java b/src/main/java/com/terminal/buffer/TerminalBuffer.java
index 8a3aa57..b664074 100644
--- a/src/main/java/com/terminal/buffer/TerminalBuffer.java
+++ b/src/main/java/com/terminal/buffer/TerminalBuffer.java
@@ -519,12 +519,11 @@ private Row resizeRow(Row row, int newWidth) {
     }
 
     private static boolean isWideCodePoint(int cp) {
-        int type = Character.getType(cp);
-        // East Asian Wide / Fullwidth characters
-        return type == Character.OTHER_LETTER &&
-                ((cp >= 0x1100 && cp <= 0x115F)   // Hangul Jamo
+        // East Asian Wide / Fullwidth characters — ranges alone are sufficient,
+        // no need to filter by Unicode category type.
+        return (cp >= 0x1100 && cp <= 0x115F)   // Hangul Jamo
                 || (cp >= 0x2E80 && cp <= 0x303E)  // CJK Radicals
-                || (cp >= 0x3041 && cp <= 0x33FF)  // Japanese
+                || (cp >= 0x3041 && cp <= 0x33FF)  // Japanese (hiragana, katakana, CJK symbols)
                 || (cp >= 0x3400 && cp <= 0x4DBF)  // CJK Extension A
                 || (cp >= 0x4E00 && cp <= 0x9FFF)  // CJK Unified Ideographs
                 || (cp >= 0xA000 && cp <= 0xA4CF)  // Yi
@@ -535,7 +534,6 @@ private static boolean isWideCodePoint(int cp) {
                 || (cp >= 0xFF00 && cp <= 0xFF60)  // Fullwidth Forms
                 || (cp >= 0xFFE0 && cp <= 0xFFE6)  // Fullwidth Signs
                 || (cp >= 0x1F300 && cp <= 0x1F9FF) // Emoji
-                || (cp >= 0x20000 && cp <= 0x2A6DF) // CJK Extension B
-                );
+                || (cp >= 0x20000 && cp <= 0x2A6DF); // CJK Extension B
     }
 }

From 9aee494a20c14e2a35aa507a8f3a5246dac43b53 Mon Sep 17 00:00:00 2001
From: igarbayo <ignacio.garbayo@rai.usc.es>
Date: Tue, 17 Mar 2026 00:35:16 +0100
Subject: [PATCH 02/15] chore: add open source standards (license, REUSE,
 community docs, CI, GitHub templates)

---
 .github/CODEOWNERS                            |   5 +
 .github/ISSUE_TEMPLATE/bug_report.md          |  37 +++
 .github/ISSUE_TEMPLATE/config.yml             |  11 +
 .github/ISSUE_TEMPLATE/feature_request.md     |  37 +++
 .github/PULL_REQUEST_TEMPLATE.md              |  27 +++
 .github/dependabot.yml                        |  23 ++
 .github/workflows/ci.yml                      |  49 ++++
 .reuse/dep5                                   |  14 ++
 CODE_OF_CONDUCT.md                            |  42 ++++
 CONTRIBUTING.md                               | 158 +++++++++++++
 GOVERNANCE.md                                 |  96 ++++++++
 LICENSE                                       |  21 ++
 LICENSES/MIT.txt                              |  21 ++
 README.md                                     | 222 ++++++++++++++----
 SECURITY.md                                   | 100 ++++++++
 build.gradle                                  |   3 +
 docs/manual-testing-guide.md                  |   3 +
 settings.gradle                               |   3 +
 src/main/java/com/terminal/buffer/Cell.java   |   3 +
 .../com/terminal/buffer/CellAttributes.java   |   3 +
 .../com/terminal/buffer/CursorPosition.java   |   3 +
 src/main/java/com/terminal/buffer/Main.java   |   3 +
 src/main/java/com/terminal/buffer/Row.java    |   3 +
 .../com/terminal/buffer/TerminalBuffer.java   |   3 +
 .../com/terminal/buffer/TerminalColor.java    |   3 +
 .../java/com/terminal/buffer/TextStyle.java   |   3 +
 .../terminal/buffer/AttributeStateTest.java   |   3 +
 .../terminal/buffer/CellAttributesTest.java   |   3 +
 .../java/com/terminal/buffer/CellTest.java    |   3 +
 .../com/terminal/buffer/ClearScreenTest.java  |   3 +
 .../terminal/buffer/ContentAccessTest.java    |   3 +
 .../java/com/terminal/buffer/CursorTest.java  |   3 +
 .../com/terminal/buffer/FillLineTest.java     |   3 +
 .../terminal/buffer/InsertEmptyLineTest.java  |   3 +
 .../com/terminal/buffer/InsertTextTest.java   |   3 +
 .../java/com/terminal/buffer/ResizeTest.java  |   3 +
 .../java/com/terminal/buffer/RowTest.java     |   3 +
 .../com/terminal/buffer/ScrollbackTest.java   |   3 +
 .../com/terminal/buffer/WideCharTest.java     |   3 +
 .../com/terminal/buffer/WriteTextTest.java    |   3 +
 40 files changed, 886 insertions(+), 52 deletions(-)
 create mode 100644 .github/CODEOWNERS
 create mode 100644 .github/ISSUE_TEMPLATE/bug_report.md
 create mode 100644 .github/ISSUE_TEMPLATE/config.yml
 create mode 100644 .github/ISSUE_TEMPLATE/feature_request.md
 create mode 100644 .github/PULL_REQUEST_TEMPLATE.md
 create mode 100644 .github/dependabot.yml
 create mode 100644 .github/workflows/ci.yml
 create mode 100644 .reuse/dep5
 create mode 100644 CODE_OF_CONDUCT.md
 create mode 100644 CONTRIBUTING.md
 create mode 100644 GOVERNANCE.md
 create mode 100644 LICENSE
 create mode 100644 LICENSES/MIT.txt
 create mode 100644 SECURITY.md

diff --git a/.github/CODEOWNERS b/.github/CODEOWNERS
new file mode 100644
index 0000000..b7fcd31
--- /dev/null
+++ b/.github/CODEOWNERS
@@ -0,0 +1,5 @@
+# SPDX-FileCopyrightText: 2026 Ignacio Garbayo Fernández <ignacio.garbayo@rai.usc.es>
+# SPDX-License-Identifier: MIT
+
+# All files are owned by the project maintainer.
+* @igarbayo
diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md
new file mode 100644
index 0000000..73ac70f
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/bug_report.md
@@ -0,0 +1,37 @@
+---
+name: Bug report
+about: Something is not working as documented
+title: 'fix: '
+labels: bug
+assignees: ''
+---
+
+## What happened?
+
+<!-- Describe the bug clearly. What did you observe? -->
+
+## What did you expect?
+
+<!-- What should have happened instead? -->
+
+## Steps to reproduce
+
+<!-- Minimal code or REPL commands that trigger the bug -->
+
+```java
+TerminalBuffer buf = new TerminalBuffer(80, 24, 100);
+// ...
+```
+
+## Environment
+
+- OS:
+- Java version (`java -version`):
+- Shell (PowerShell / bash / zsh / other):
+
+## Additional context
+
+<!-- Stack trace, screenshots, anything else that helps -->
+
+<!-- SPDX-FileCopyrightText: 2026 Ignacio Garbayo Fernández <ignacio.garbayo@rai.usc.es> -->
+<!-- SPDX-License-Identifier: MIT -->
diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml
new file mode 100644
index 0000000..7078930
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/config.yml
@@ -0,0 +1,11 @@
+# SPDX-FileCopyrightText: 2026 Ignacio Garbayo Fernández <ignacio.garbayo@rai.usc.es>
+# SPDX-License-Identifier: MIT
+
+blank_issues_enabled: false
+
+contact_links:
+  - name: Security vulnerability
+    url: https://github.com/igarbayo/terminal-text-buffer/blob/master/SECURITY.md
+    about: >
+      Do NOT open a public issue for security vulnerabilities.
+      Please follow the responsible disclosure process described in SECURITY.md.
diff --git a/.github/ISSUE_TEMPLATE/feature_request.md b/.github/ISSUE_TEMPLATE/feature_request.md
new file mode 100644
index 0000000..5024732
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/feature_request.md
@@ -0,0 +1,37 @@
+---
+name: Feature request
+about: Propose an improvement or new capability
+title: 'feat: '
+labels: enhancement
+assignees: ''
+---
+
+## What problem does this solve?
+
+<!-- Describe the problem you are facing, not just the solution.
+     Example: "When I try to use this library to build a TUI, I cannot X because..." -->
+
+## Proposed solution
+
+<!-- Describe what you would like to happen.
+     Example: "Add a method getAttributesAt(col, row) that returns the CellAttributes..." -->
+
+## Example usage
+
+<!-- Show how the feature would be used, even if it is pseudocode -->
+
+```java
+// Example of how the new feature would look
+buf.newMethod(arg1, arg2);
+```
+
+## Alternatives considered
+
+<!-- Have you thought of other ways to solve the problem? Why are they worse? -->
+
+## Additional context
+
+<!-- Anything else that helps understand the request -->
+
+<!-- SPDX-FileCopyrightText: 2026 Ignacio Garbayo Fernández <ignacio.garbayo@rai.usc.es> -->
+<!-- SPDX-License-Identifier: MIT -->
diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md
new file mode 100644
index 0000000..6e99a10
--- /dev/null
+++ b/.github/PULL_REQUEST_TEMPLATE.md
@@ -0,0 +1,27 @@
+## Description
+
+<!-- What does this PR do? Why is it needed? -->
+
+## Type of change
+
+- [ ] `feat` — new feature
+- [ ] `fix` — bug fix
+- [ ] `test` — tests only
+- [ ] `docs` — documentation only
+- [ ] `refactor` — code change, no feature or fix
+- [ ] `chore` — tooling, dependencies, build
+
+## Checklist
+
+- [ ] I branched from `develop` (not from `master`)
+- [ ] The PR title is a valid Conventional Commit message (e.g. `feat: add X`)
+- [ ] `./gradlew test` passes locally
+- [ ] New or changed files have SPDX license headers
+- [ ] I have updated documentation if needed
+
+## Related issues
+
+Closes # <!-- issue number, if applicable -->
+
+<!-- SPDX-FileCopyrightText: 2026 Ignacio Garbayo Fernández <ignacio.garbayo@rai.usc.es> -->
+<!-- SPDX-License-Identifier: MIT -->
diff --git a/.github/dependabot.yml b/.github/dependabot.yml
new file mode 100644
index 0000000..4395d3e
--- /dev/null
+++ b/.github/dependabot.yml
@@ -0,0 +1,23 @@
+# SPDX-FileCopyrightText: 2026 Ignacio Garbayo Fernández <ignacio.garbayo@rai.usc.es>
+# SPDX-License-Identifier: MIT
+
+version: 2
+updates:
+  # Keep Gradle dependencies up to date (e.g. JUnit 5)
+  - package-ecosystem: gradle
+    directory: /
+    schedule:
+      interval: weekly
+      day: monday
+    labels:
+      - dependencies
+
+  # Keep GitHub Actions up to date
+  - package-ecosystem: github-actions
+    directory: /
+    schedule:
+      interval: weekly
+      day: monday
+    labels:
+      - dependencies
+      - github-actions
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
new file mode 100644
index 0000000..588a84c
--- /dev/null
+++ b/.github/workflows/ci.yml
@@ -0,0 +1,49 @@
+# SPDX-FileCopyrightText: 2026 Ignacio Garbayo Fernández <ignacio.garbayo@rai.usc.es>
+# SPDX-License-Identifier: MIT
+
+name: CI
+
+on:
+  push:
+    branches: [ master, develop, 'feature/**', 'hotfix/**' ]
+  pull_request:
+    branches: [ master, develop ]
+
+jobs:
+  build:
+    name: Build and test (Java ${{ matrix.java }})
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        java: [ '11', '17', '21' ]
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Java ${{ matrix.java }}
+        uses: actions/setup-java@v4
+        with:
+          java-version: ${{ matrix.java }}
+          distribution: temurin
+
+      - name: Run tests
+        run: ./gradlew test
+
+      - name: Upload test report
+        if: failure()
+        uses: actions/upload-artifact@v4
+        with:
+          name: test-report-java-${{ matrix.java }}
+          path: build/reports/tests/test/
+
+  reuse:
+    name: REUSE compliance
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Check REUSE compliance
+        uses: fsfe/reuse-action@v4
diff --git a/.reuse/dep5 b/.reuse/dep5
new file mode 100644
index 0000000..2d001eb
--- /dev/null
+++ b/.reuse/dep5
@@ -0,0 +1,14 @@
+Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
+Upstream-Name: terminal-text-buffer
+Upstream-Contact: Ignacio Garbayo Fernández <ignacio.garbayo@rai.usc.es>
+Source: https://github.com/YOUR_USERNAME/terminal-text-buffer
+
+# Gradle wrapper — generated by Gradle, licensed under Apache-2.0
+Files: gradlew gradlew.bat gradle/wrapper/gradle-wrapper.jar gradle/wrapper/gradle-wrapper.properties
+Copyright: Gradle Inc.
+License: Apache-2.0
+
+# Project configuration files — authored by the project maintainer
+Files: gradle.properties .gitignore settings.gradle
+Copyright: 2026 Ignacio Garbayo Fernández <ignacio.garbayo@rai.usc.es>
+License: MIT
diff --git a/CODE_OF_CONDUCT.md b/CODE_OF_CONDUCT.md
new file mode 100644
index 0000000..b3d7299
--- /dev/null
+++ b/CODE_OF_CONDUCT.md
@@ -0,0 +1,42 @@
+# Code of Conduct
+
+## Our Pledge
+
+We are committed to making participation in this project a welcoming and
+respectful experience for everyone, regardless of background or experience level.
+
+## Expected Behaviour
+
+- Be kind and respectful in all interactions.
+- Give and accept constructive feedback graciously.
+- Focus on what is best for the project and the community.
+- Show empathy towards other contributors.
+
+## Unacceptable Behaviour
+
+- Harassment, insults, or derogatory comments of any kind.
+- Trolling or deliberately disruptive behaviour.
+- Publishing others' private information without consent.
+
+## Enforcement
+
+Instances of unacceptable behaviour may be reported to the project maintainer
+at **ignacio.garbayo@rai.usc.es**. All reports will be reviewed and
+investigated promptly and fairly.
+
+The maintainer has the right and responsibility to remove, edit, or reject
+comments, commits, and other contributions that do not align with this Code
+of Conduct.
+
+## Scope
+
+This Code of Conduct applies in all project spaces — issues, pull requests,
+discussions — and when an individual is representing the project publicly.
+
+## Attribution
+
+This Code of Conduct is adapted from the
+[Contributor Covenant](https://www.contributor-covenant.org/), version 2.1.
+
+<!-- SPDX-FileCopyrightText: 2026 Ignacio Garbayo Fernández <ignacio.garbayo@rai.usc.es> -->
+<!-- SPDX-License-Identifier: MIT -->
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
new file mode 100644
index 0000000..94a05bc
--- /dev/null
+++ b/CONTRIBUTING.md
@@ -0,0 +1,158 @@
+# Contributing to Terminal Text Buffer
+
+First of all — thank you for taking the time to read this and for your interest
+in the project. Whether you are here out of curiosity, to report a bug, or to
+propose a change, it genuinely means a lot.
+
+---
+
+## A note before you start
+
+This is an **academic project** maintained by a single student. Please set your
+expectations accordingly:
+
+- Response times may be **weeks or months**. This is not negligence — it is
+  reality. Coursework, exams, and life happen.
+- There is **no roadmap** and no commitment to implement any particular feature.
+- The project may go quiet for extended periods.
+
+None of this means your contribution is not valued. It means you should not
+block on a response from me.
+
+---
+
+## How to report a bug
+
+1. Check that the bug has not already been reported in the
+   [issue tracker](https://github.com/igarbayo/terminal-text-buffer/issues).
+2. Open a new issue using the **Bug Report** template.
+3. Include:
+   - What you did (exact commands or code).
+   - What you expected to happen.
+   - What actually happened (paste the output or stack trace).
+   - Your environment: OS, Java version (`java -version`), shell.
+
+**Example of a useful bug report:**
+
+> **Steps to reproduce:**
+> ```java
+> TerminalBuffer buf = new TerminalBuffer(10, 5, 100);
+> buf.setCursor(9, 0);
+> buf.writeText("AB");   // A fits, B should wrap
+> ```
+> **Expected:** cursor at (0, 1), 'B' written on row 1.
+> **Got:** cursor at (9, 0), 'B' lost.
+
+---
+
+## How to propose a feature or improvement
+
+Open an issue using the **Feature Request** template. Describe:
+
+- The problem you are trying to solve (not just the solution).
+- Your proposed approach, if you have one.
+- Any alternatives you considered.
+
+---
+
+## How to contribute code
+
+### 1. Fork and set up
+
+```bash
+git clone https://github.com/igarbayo/terminal-text-buffer.git
+cd terminal-text-buffer
+./gradlew test   # make sure everything passes before you start
+```
+
+### 2. Create a feature branch from `develop`
+
+```bash
+git checkout develop
+git checkout -b feature/your-feature-name
+```
+
+Never branch from `master`. Never commit directly to `master` or `develop`.
+
+### 3. Write your code
+
+- Follow the existing code style (no formatter config yet, just be consistent).
+- Write tests first if possible — this project was built with TDD.
+- Add SPDX headers to any new file you create:
+
+```java
+// SPDX-FileCopyrightText: <YEAR> <Your Name> <your@email.com>
+// SPDX-License-Identifier: MIT
+```
+
+### 4. Commit with Conventional Commits
+
+All commit messages must follow the
+[Conventional Commits](https://www.conventionalcommits.org/) format:
+
+```
+<type>: <short description in present tense, lowercase>
+```
+
+Valid types:
+
+| Type | Use it for |
+|---|---|
+| `feat` | A new feature or behaviour |
+| `fix` | A bug fix |
+| `test` | Adding or fixing tests |
+| `docs` | Documentation only |
+| `refactor` | Code change with no feature or fix |
+| `chore` | Tooling, dependencies, build |
+
+**Examples:**
+
+```
+feat: add SGR escape sequence parser
+fix: correct cursor clamping when width is 1
+test: add scrollback eviction edge case
+docs: clarify wide character limitations in README
+chore: bump JUnit to 5.11.0
+```
+
+Breaking changes: add `!` after the type and a `BREAKING CHANGE:` footer.
+
+```
+feat!: change scrollback row indexing to 0-based
+
+BREAKING CHANGE: getLine() now uses 0 for the most recent scrollback row
+instead of -1.
+```
+
+### 5. Open a Pull Request to `develop`
+
+- Fill in the PR template completely.
+- The PR title must itself be a valid Conventional Commit message.
+- CI must be green (build + tests + REUSE compliance).
+
+---
+
+## PGP signed commits
+
+The maintainer signs all commits with a PGP key. You are not required to sign
+your commits, but it is encouraged. If you do, please include your public key
+fingerprint in the PR description.
+
+---
+
+## Code of Conduct
+
+This project follows the
+[Contributor Covenant Code of Conduct](CODE_OF_CONDUCT.md).
+By participating you agree to abide by its terms.
+
+---
+
+## Contact
+
+If you have a question that does not fit an issue, you can reach the maintainer
+at **ignacio.garbayo@rai.usc.es**. Please use the subject line
+`[terminal-text-buffer] your topic` so it does not get lost.
+
+<!-- SPDX-FileCopyrightText: 2026 Ignacio Garbayo Fernández <ignacio.garbayo@rai.usc.es> -->
+<!-- SPDX-License-Identifier: MIT -->
diff --git a/GOVERNANCE.md b/GOVERNANCE.md
new file mode 100644
index 0000000..1bd948f
--- /dev/null
+++ b/GOVERNANCE.md
@@ -0,0 +1,96 @@
+# Governance
+
+## Project status
+
+Terminal Text Buffer is an active academic project. There is no formal roadmap,
+no release schedule, and no commitment to any particular feature or timeline.
+
+---
+
+## Maintainer
+
+| Name | Email | Role |
+|---|---|---|
+| Ignacio Garbayo Fernández | ignacio.garbayo@rai.usc.es | Sole maintainer |
+
+This is a single-maintainer project. All decisions about direction, merges,
+and releases are made by the maintainer. There is no steering committee,
+no vote, and no formal RFC process.
+
+For questions, open an issue or send an email with subject
+`[terminal-text-buffer] your topic`.
+
+---
+
+## Decision making
+
+The maintainer has final say on all technical and community decisions. Proposals
+are welcome via issues or pull requests and will be considered seriously, but
+there is no obligation to implement them or to respond within any given time.
+
+Response times are **best-effort** — expect weeks or months. This is a
+student project competing with coursework and exams.
+
+---
+
+## Branch strategy (Git Flow)
+
+| Branch | Purpose | Direct commits allowed |
+|---|---|---|
+| `master` | Stable releases only | No — PR required |
+| `develop` | Integration of finished features | No — PR required |
+| `feature/*` | Individual features, branched from `develop` | Yes |
+| `hotfix/*` | Urgent fixes on `master` | Yes |
+
+### Rules
+
+- **No direct commits to `master` or `develop`.** All changes go through a
+  pull request, even from the maintainer.
+- Feature branches are created from `develop`:
+  ```bash
+  git checkout develop
+  git checkout -b feature/my-feature
+  ```
+- When a feature is ready, open a PR targeting `develop`.
+- Releases are merged from `develop` to `master` and tagged with a semver tag.
+
+### Branch protection (configured in GitHub)
+
+- `master`: require PR, no direct push, CI must pass (build + REUSE).
+- `develop`: require PR, no direct push, CI must pass.
+
+To configure: GitHub → Settings → Branches → Branch protection rules.
+
+---
+
+## Release process
+
+1. All planned features for the release are merged into `develop`.
+2. `develop` is merged into `master` via PR.
+3. A tag is created on `master`:
+   ```bash
+   git tag -s v1.0.0 -m "Release v1.0.0"
+   git push origin v1.0.0
+   ```
+   Tags are signed with the maintainer's PGP key.
+4. A GitHub Release is created from the tag with release notes.
+
+Versioning follows [Semantic Versioning](https://semver.org/):
+`MAJOR.MINOR.PATCH`.
+
+---
+
+## Commit signing
+
+All commits from the maintainer are signed with a PGP key. Contributors are
+encouraged (but not required) to sign their commits.
+
+---
+
+## Amendments
+
+This document may be updated by the maintainer at any time. Significant changes
+will be noted in the commit message and changelog.
+
+<!-- SPDX-FileCopyrightText: 2026 Ignacio Garbayo Fernández <ignacio.garbayo@rai.usc.es> -->
+<!-- SPDX-License-Identifier: MIT -->
diff --git a/LICENSE b/LICENSE
new file mode 100644
index 0000000..233d1b7
--- /dev/null
+++ b/LICENSE
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ignacio Garbayo Fernández
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
diff --git a/LICENSES/MIT.txt b/LICENSES/MIT.txt
new file mode 100644
index 0000000..233d1b7
--- /dev/null
+++ b/LICENSES/MIT.txt
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ignacio Garbayo Fernández
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
diff --git a/README.md b/README.md
index 5efce1d..22fad24 100644
--- a/README.md
+++ b/README.md
@@ -1,26 +1,107 @@
 # Terminal Text Buffer
 
-A terminal text buffer implementation in Java — the core data structure used by terminal emulators to store and render text output.
+[![CI](https://github.com/igarbayo/terminal-text-buffer/actions/workflows/ci.yml/badge.svg)](https://github.com/igarbayo/terminal-text-buffer/actions/workflows/ci.yml)
+[![REUSE Compliant](https://api.reuse.software/badge/github.com/igarbayo/terminal-text-buffer)](https://api.reuse.software/info/github.com/igarbayo/terminal-text-buffer)
 
-## Building and Running Tests
+> A terminal text buffer implementation in Java — the core data structure used by
+> terminal emulators to store, edit, and render text output.
+
+---
+
+## What is this?
+
+When a shell prints output, something has to keep track of what character is in
+each cell of the screen, what colour it has, and where the cursor is. That
+"something" is a terminal buffer.
+
+This library implements that data structure from scratch in Java, without any
+external runtime dependencies. It is meant for developers who are:
+
+- building a terminal emulator or TUI framework,
+- studying how terminal emulators work internally, or
+- looking for a clean, tested reference implementation.
+
+It is **not** a terminal emulator itself — it does not parse escape sequences,
+drive a display, or handle input events. It is the data layer only.
+
+---
+
+## Known Limitations
+
+Be aware of these before you use it:
+
+- **Wide characters in Windows PowerShell / CMD:** PowerShell replaces CJK
+  ideographs and many emoji with `?` before they reach the JVM. Wide character
+  support works correctly in the library (verified by the automated test suite)
+  but cannot be tested interactively from those terminals. Use IntelliJ's
+  built-in terminal or Windows Terminal with `chcp 65001`.
+
+- **Scrollback access is O(n):** `resolveRow()` iterates an `ArrayDeque` to
+  find a scrollback row by index. For large scrollback sizes this is linear.
+  See [Architecture & Design](#architecture--design) for the recommended fix.
+
+- **Supplementary-plane emoji (U+1F300+):** The `Cell` class stores characters
+  as `char` (UTF-16 code unit). Codepoints above U+FFFF are detected correctly
+  via `codePointAt` but stored as `(char) codePoint`, losing the high surrogate.
+  Changing `Cell.character` to `int` would fix this.
+
+---
+
+## Quick Start
+
+**Requirements:** Java 8+, no external runtime dependencies.
 
 ```bash
+git clone https://github.com/igarbayo/terminal-text-buffer.git
+cd terminal-text-buffer
 ./gradlew test
 ```
 
-Requires Java 8+. No external libraries except JUnit 5 for testing.
+All 14 test classes run. The HTML report is at
+`build/reports/tests/test/index.html`.
+
+> **Windows note:** if Gradle cannot find the compiler, set
+> `org.gradle.java.home` in `gradle.properties` to point to your JDK (not JRE):
+> ```
+> org.gradle.java.home=C:\\Program Files\\Java\\jdk1.8.0_261
+> ```
+
+### Use the buffer in your code
+
+```java
+// Create an 80x24 buffer with 500 lines of scrollback
+TerminalBuffer buf = new TerminalBuffer(80, 24, 500);
+
+// Set attributes and write
+buf.setForeground(TerminalColor.RED);
+buf.addStyle(TextStyle.BOLD);
+buf.writeText("Hello, terminal!");
+
+// Move the cursor and write more
+buf.setCursor(0, 1);
+buf.resetAttributes();
+buf.writeText("Normal text on row 1");
+
+// Read back
+String line0 = buf.getLine(0);   // "Hello, terminal!"
+char   ch     = buf.getChar(0, 0); // 'H'
+```
+
+---
 
 ## Interactive REPL
 
-A command-line REPL is included to test the buffer manually:
+A command-line REPL lets you poke at the buffer manually:
 
 ```bash
 ./gradlew run --console=plain -q
 ```
 
-Type `help` inside the REPL to list all commands, or see the table below:
+Type `help` at the prompt to see all commands, or consult the
+[manual testing guide](docs/manual-testing-guide.md) for a full walkthrough
+with expected output.
 
-| Command | Description |
+| Command | What it does |
 |---|---|
 | `write <text>` | Write text at cursor position (overwrite) |
 | `insert <text>` | Insert text at cursor, shifting content right |
@@ -44,12 +125,9 @@ Type `help` inside the REPL to list all commands, or see the table below:
 
 Colors: `DEFAULT RED GREEN YELLOW BLUE MAGENTA CYAN WHITE BLACK` and `BRIGHT_*` variants.
 
-See [docs/manual-testing-guide.md](docs/manual-testing-guide.md) for a full walkthrough
-of every feature and edge case, including expected output for each command.
-
 ---
 
-## Architecture
+## Architecture & Design
 
 ### Class Overview
 
@@ -67,101 +145,118 @@ TerminalBuffer (public)    — the main API class
 
 #### Immutability strategy: Cell immutable, Row mutable
 
-`Cell` and `CellAttributes` are immutable value objects. This makes it safe to share `Cell.EMPTY` everywhere without defensive copying, and ensures that scrollback history cannot be accidentally modified after a row is pushed there.
+`Cell` and `CellAttributes` are immutable value objects. This makes it safe to
+share `Cell.EMPTY` everywhere without defensive copying, and ensures that
+scrollback history cannot be accidentally modified after a row is pushed there.
 
-`Row` is mutable (package-private) — writing a character is O(1) instead of creating a new row array on every keystroke. When a row is pushed into scrollback, a copy-constructor snapshot is taken (`new Row(original)`), so future mutations to the screen row don't corrupt history.
+`Row` is mutable (package-private) — writing a character is O(1) instead of
+creating a new row array on every keystroke. When a row is pushed into
+scrollback, a copy-constructor snapshot is taken (`new Row(original)`), so
+future mutations to the screen row do not corrupt history.
 
 #### Color and style representation
 
-`TerminalColor` is a 17-value enum (DEFAULT + 16 standard ANSI colors). `TextStyle` flags use `EnumSet<TextStyle>`, which is backed by a long bitmask internally — compact, type-safe, and requires no custom bitfield arithmetic.
+`TerminalColor` is a 17-value enum (DEFAULT + 16 standard ANSI colors).
+`TextStyle` flags use `EnumSet<TextStyle>`, backed by a long bitmask internally
+— compact, type-safe, and no custom bitfield arithmetic needed.
 
 #### Scrollback storage
 
-`ArrayDeque<Row>` with front=oldest, back=newest. Gives O(1) push (addLast) and O(1) eviction (removeFirst). When the deque exceeds `maxScrollback`, the oldest entry is evicted.
+`ArrayDeque<Row>` with front=oldest, back=newest. O(1) push (`addLast`) and
+O(1) eviction (`removeFirst`). Random access by index is O(n) — a fixed-size
+`Row[]` circular buffer would give O(1) at the cost of complexity.
 
 #### Coordinate system
 
-- **Screen**: row `[0, height-1]`, where row 0 is the top (first visible line).
-- **Scrollback**: row `[-scrollbackSize, -1]`, where row `-1` is the most recently scrolled-off line (visually just above the screen) and row `-scrollbackSize` is the oldest.
+- **Screen**: row `[0, height-1]`, where row 0 is the top visible line.
+- **Scrollback**: row `[-scrollbackSize, -1]`, where row -1 is the most
+  recently scrolled-off line and `-scrollbackSize` is the oldest.
 
-This signed-integer convention unifies all content-access methods under a single `int row` parameter without needing a separate type or overloaded flag.
+This signed-integer convention unifies all content-access methods under a
+single `int row` parameter without needing a separate type or flag.
 
-#### Wide character support (bonus)
+#### Wide character support
 
-Uses the **placeholder cell strategy** (the same approach as xterm, VTE, and most real terminal emulators):
+Uses the **placeholder cell strategy** (same as xterm, VTE, and most real
+terminal emulators):
 
-- A wide glyph (CJK ideograph, emoji) at column `c` sets `cells[c] = WIDE_LEFT` and `cells[c+1] = WIDE_RIGHT`.
-- `WIDE_RIGHT` stores `'\0'` as its character and is skipped in `toContentString()`.
-- Writing over a `WIDE_LEFT` automatically clears its `WIDE_RIGHT` partner (and vice versa) to prevent half-wide artifacts.
-- A wide char that doesn't fit at the right edge is truncated (the column is left empty).
+- A wide glyph at column `c` sets `cells[c] = WIDE_LEFT` and
+  `cells[c+1] = WIDE_RIGHT`.
+- `WIDE_RIGHT` stores `'\0'` and is skipped in `toContentString()`.
+- Writing over either half of a wide pair automatically clears both halves.
+- A wide char that does not fit at the right edge is skipped.
 
-Wide character detection uses Unicode block ranges for CJK ideographs, Hangul, fullwidth forms, and common emoji (BMP range). Supplementary-plane emoji (U+1F300+) are detected via the `int codepoint` API.
+Detection uses Unicode block ranges directly (not `Character.getType()`, which
+is too restrictive for some ranges).
 
 #### `writeText` — pending wrap flag
 
-`writeText` implements xterm's **"pending wrap"** behavior rather than immediate truncation:
-
-- When the last character is written to column `width-1`, the cursor stays at `width-1` and an internal `pendingWrap = true` flag is set.
-- The _next_ call to `writeText` resolves the pending wrap first: it advances the cursor to column 0 of the next row (scrolling if at the last row), then writes the new character there.
-- Any explicit `setCursor` call clears `pendingWrap`.
-
-This matches real terminal behavior and allows consecutive writes to flow naturally across lines.
+When the last character is written to column `width-1`, the cursor stays there
+and `pendingWrap = true` is set internally. The next `writeText` call resolves
+the wrap first — advances to column 0 of the next row (inserting a new line if
+at the bottom) — then writes. This matches xterm behaviour.
 
 #### `insertText` — push-down wrapping
 
-`insertText` inserts characters at the cursor position, shifting existing row content right. Overflow flows to subsequent rows recursively:
+Inserts at the cursor, shifting existing row content right. Overflow flows to
+subsequent rows recursively:
 
-1. Capture existing content from cursor column to end of row.
+1. Capture content from cursor column to end of row.
 2. Merge: `combined = [new cells] + [existing]`.
-3. Write the first `(width - cursorCol)` elements of `combined` back into the row.
-4. If `combined` has more elements and they contain actual content (non-space, non-default), insert them at column 0 of the next row using the same algorithm.
-5. If this overflow reaches the last screen row, `insertEmptyLine()` is called — the top row scrolls into scrollback, and the new bottom row receives the overflow.
-
-Trailing spaces from displaced empty cells are detected by `hasActualContent()` and discarded to avoid propagating blank overflow infinitely.
+3. Write the first `(width - cursorCol)` cells back.
+4. If overflow contains actual content, recurse at column 0 of the next row.
+5. If overflow reaches the last row, `insertEmptyLine()` is called — the top
+   row scrolls into scrollback.
 
 #### `getLine` vs `getRawLine`
 
-- `getLine(row)` — returns the line content with trailing spaces trimmed. Convenient for tests and display.
-- `getRawLine(row)` — returns the fixed-width string (always `width` characters). Useful for width-sensitive rendering.
+- `getLine(row)` — content with trailing spaces trimmed. Convenient for tests.
+- `getRawLine(row)` — fixed-width string (always `width` characters). For
+  width-sensitive rendering.
 
-#### Resize (bonus)
+#### Resize
 
 `resize(newWidth, newHeight)` handles four cases:
 
 - **Wider**: rows padded with `Cell.EMPTY` at the right.
 - **Narrower**: rows truncated at the new width.
 - **Taller**: new empty rows appended at the bottom.
-- **Shorter**: rows removed from the top of the screen enter scrollback (same as scrolling).
-
-The cursor is clamped to the new bounds after resize.
+- **Shorter**: rows removed from the top enter scrollback.
 
 ---
 
 ## Trade-offs and Known Limitations
 
-- **`char` vs `int` for wide chars**: The implementation uses `char` (UTF-16 code unit) for cell storage, which covers BMP characters including all CJK ideographs and most common emoji. Supplementary-plane emoji above U+FFFF are detected via `codePointAt` but stored as `(char) codePoint`, which loses the high surrogate. Changing `Cell.character` to `int` (Unicode codepoint) would fix this without changing the public API of `TerminalBuffer`, and is the recommended future improvement.
+- **`char` vs `int` for wide chars**: Cell stores `char` (covers all BMP
+  including CJK). Supplementary-plane emoji above U+FFFF are detected but
+  stored with loss. Changing `Cell.character` to `int` fixes this without
+  changing the public API.
 
-- **`insertText` cursor position after overflow**: The cursor advancement after `insertText` uses arithmetic based on the total character count relative to the cursor start position. If `insertEmptyLine()` is triggered during overflow (causing rows to shift up), the cursor position is calculated relative to the final state. This is consistent in the current implementation but could be refined if complex multi-line insert scenarios are needed.
+- **`insertText` cursor position after overflow**: Cursor arithmetic is based
+  on total character count relative to the cursor start. Consistent in the
+  current implementation; could be refined for complex multi-line inserts.
 
-- **`insertText` hasActualContent check**: Trailing spaces from empty rows are suppressed to avoid infinite blank-cell propagation. However, if a user explicitly inserts spaces into a full row and wants those spaces to flow to the next line, they would be dropped. This is a pragmatic trade-off — meaningful overflow content is always preserved.
+- **`hasActualContent` trailing spaces**: Spaces from empty rows are suppressed
+  to avoid infinite blank-cell propagation. Intentional trailing spaces at the
+  end of a full row would be dropped.
 
-- **Scrollback access is O(n)**: `resolveRow()` for scrollback iterates the `ArrayDeque` to find the row at a given index. For production use, replacing `ArrayDeque` with a fixed-size circular buffer (`Row[]` + head/tail indices) would give O(1) random access. For the scope of this task, the simplicity of `ArrayDeque` is preferred.
+- **Scrollback access is O(n)**: See [Known Limitations](#known-limitations).
 
 ---
 
 ## Potential Improvements
 
 - Replace `ArrayDeque<Row>` with a `Row[]` circular buffer for O(1) scrollback access.
-- Change `Cell.character` from `char` to `int` (Unicode codepoint) for full supplementary-plane emoji support.
+- Change `Cell.character` from `char` to `int` for full supplementary-plane emoji support.
 - Add `Bidi` (bidirectional text) support for RTL languages.
-- Add `SGR` (Select Graphic Rendition) parsing to directly process ANSI escape sequences into attribute changes.
+- Add `SGR` (Select Graphic Rendition) parsing to process ANSI escape sequences directly.
 - Add alternate screen buffer support (used by fullscreen TUI apps like vim).
 
 ---
 
 ## Development Process
 
-This implementation was built using **TDD (Test-Driven Development)** in a bottom-up order:
+Built using **TDD (Test-Driven Development)** in a bottom-up order:
 
 1. Value objects (`CellAttributes`, `Cell`) — tested in isolation first
 2. `Row` — the storage primitive
@@ -176,4 +271,27 @@ This implementation was built using **TDD (Test-Driven Development)** in a botto
 11. Wide character support
 12. Resize
 
-We'll use Git Flow branching for feature development and pull requests for code review. Each commit is focused on a single behavior or refactor, with descriptive messages.
+Commits are signed with PGP. Branch strategy follows Git Flow —
+see [GOVERNANCE.md](GOVERNANCE.md) for details.
+
+---
+
+## Contributing
+
+Contributions, questions and feedback are welcome.
+Please read [CONTRIBUTING.md](CONTRIBUTING.md) before opening a pull request.
+
+---
+
+## License
+
+This project is licensed under the **MIT License** — see [LICENSE](LICENSE) for
+the full text.
+
+The choice of MIT reflects the academic nature of this project: maximum freedom
+to study, adapt, and reuse, with no restrictions on how you use it.
+
+[![REUSE Compliant](https://api.reuse.software/badge/github.com/igarbayo/terminal-text-buffer)](https://api.reuse.software/info/github.com/igarbayo/terminal-text-buffer)
+
+<!-- SPDX-FileCopyrightText: 2026 Ignacio Garbayo Fernández <ignacio.garbayo@rai.usc.es> -->
+<!-- SPDX-License-Identifier: MIT -->
diff --git a/SECURITY.md b/SECURITY.md
new file mode 100644
index 0000000..2d45382
--- /dev/null
+++ b/SECURITY.md
@@ -0,0 +1,100 @@
+# Security Policy
+
+## Academic project notice
+
+This is an academic project with no production deployment and no commercial use.
+It is not subject to the mandatory requirements of the EU Cyber Resilience Act
+(CRA). However, this project voluntarily adopts CRA-aligned security practices
+as a matter of good hygiene.
+
+---
+
+## Supported versions
+
+Only the latest version on the `master` branch is supported. There are no
+long-term support versions.
+
+| Version | Supported |
+|---|---|
+| Latest (`master`) | Yes |
+| Older commits | No |
+
+---
+
+## Scope
+
+### In scope
+
+- Memory safety issues in buffer operations (e.g. `resize`, `insertText`)
+- Incorrect data isolation between screen and scrollback (e.g. mutation of
+  scrollback rows after push)
+- Logic errors that could cause data loss or silent corruption of buffer state
+
+### Out of scope
+
+- Wide character rendering in Windows PowerShell / CMD (known OS-level
+  limitation, not a library bug — see README)
+- Performance issues that do not affect correctness
+- Theoretical vulnerabilities with no realistic attack vector given the
+  library's use case (in-process data structure, no network, no I/O)
+
+---
+
+## Reporting a vulnerability
+
+**Do not open a public GitHub issue for security vulnerabilities.**
+
+Send an email to **ignacio.garbayo@rai.usc.es** with:
+
+- Subject: `[SECURITY] terminal-text-buffer — <brief description>`
+- A description of the vulnerability and its potential impact
+- Steps to reproduce or a minimal reproducing example
+- Any suggested fix, if you have one
+
+### Example report
+
+> **Subject:** `[SECURITY] terminal-text-buffer — resize allows negative width`
+>
+> Calling `buf.resize(-1, 24)` throws an unchecked `NegativeArraySizeException`
+> instead of the documented `IllegalArgumentException`, causing the buffer to
+> enter an inconsistent state if the exception is caught upstream.
+>
+> **Reproducer:**
+> ```java
+> TerminalBuffer buf = new TerminalBuffer(80, 24, 100);
+> try { buf.resize(-1, 24); } catch (Exception e) { /* ignored */ }
+> // buf is now broken
+> ```
+
+---
+
+## Response timeline
+
+| Stage | Target time |
+|---|---|
+| Acknowledgement | 7 days |
+| Initial assessment | 30 days |
+| Fix or mitigation | Best-effort (academic project, no SLA) |
+
+---
+
+## Disclosure policy
+
+This project follows **coordinated disclosure**:
+
+1. You report privately.
+2. The maintainer confirms and works on a fix.
+3. A fixed version is released.
+4. The vulnerability is disclosed publicly, with credit to the reporter if desired.
+
+Public disclosure should not happen before 90 days from the initial report,
+unless both parties agree otherwise.
+
+---
+
+## No bug bounty
+
+This is a student academic project. There is no bug bounty programme.
+
+<!-- SPDX-FileCopyrightText: 2026 Ignacio Garbayo Fernández <ignacio.garbayo@rai.usc.es> -->
+<!-- SPDX-License-Identifier: MIT -->
diff --git a/build.gradle b/build.gradle
index b608b5c..040aea8 100644
--- a/build.gradle
+++ b/build.gradle
@@ -1,3 +1,6 @@
+// SPDX-FileCopyrightText: 2026 Ignacio Garbayo Fernández <ignacio.garbayo@rai.usc.es>
+// SPDX-License-Identifier: MIT
+
 plugins {
     id 'java'
     id 'application'
diff --git a/docs/manual-testing-guide.md b/docs/manual-testing-guide.md
index 78a5a43..3cc2d0f 100644
--- a/docs/manual-testing-guide.md
+++ b/docs/manual-testing-guide.md
@@ -312,3 +312,6 @@ HTML report: `build/reports/tests/test/index.html`
 | `ContentAccessTest` | getLine trimming, getRawLine fixed width, getAllContent |
 | `WideCharTest` | 2-cell rendering, right-edge truncation |
 | `ResizeTest` | Truncate/pad rows, height shrink → scrollback |
+
+<!-- SPDX-FileCopyrightText: 2026 Ignacio Garbayo Fernández <ignacio.garbayo@rai.usc.es> -->
+<!-- SPDX-License-Identifier: MIT -->
diff --git a/settings.gradle b/settings.gradle
index 3e8565b..71d1222 100644
--- a/settings.gradle
+++ b/settings.gradle
@@ -1 +1,4 @@
+// SPDX-FileCopyrightText: 2026 Ignacio Garbayo Fernández <ignacio.garbayo@rai.usc.es>
+// SPDX-License-Identifier: MIT
+
 rootProject.name = 'terminal-text-buffer'
diff --git a/src/main/java/com/terminal/buffer/Cell.java b/src/main/java/com/terminal/buffer/Cell.java
index f023f16..5a319e7 100644
--- a/src/main/java/com/terminal/buffer/Cell.java
+++ b/src/main/java/com/terminal/buffer/Cell.java
@@ -1,3 +1,6 @@
+// SPDX-FileCopyrightText: 2026 Ignacio Garbayo Fernández <ignacio.garbayo@rai.usc.es>
+// SPDX-License-Identifier: MIT
+
 package com.terminal.buffer;
 
 import java.util.Objects;
diff --git a/src/main/java/com/terminal/buffer/CellAttributes.java b/src/main/java/com/terminal/buffer/CellAttributes.java
index 9439cb0..1f6ed6e 100644
--- a/src/main/java/com/terminal/buffer/CellAttributes.java
+++ b/src/main/java/com/terminal/buffer/CellAttributes.java
@@ -1,3 +1,6 @@
+// SPDX-FileCopyrightText: 2026 Ignacio Garbayo Fernández <ignacio.garbayo@rai.usc.es>
+// SPDX-License-Identifier: MIT
+
 package com.terminal.buffer;
 
 import java.util.Collections;
diff --git a/src/main/java/com/terminal/buffer/CursorPosition.java b/src/main/java/com/terminal/buffer/CursorPosition.java
index aaa88c5..6235ccf 100644
--- a/src/main/java/com/terminal/buffer/CursorPosition.java
+++ b/src/main/java/com/terminal/buffer/CursorPosition.java
@@ -1,3 +1,6 @@
+// SPDX-FileCopyrightText: 2026 Ignacio Garbayo Fernández <ignacio.garbayo@rai.usc.es>
+// SPDX-License-Identifier: MIT
+
 package com.terminal.buffer;
 
 import java.util.Objects;
diff --git a/src/main/java/com/terminal/buffer/Main.java b/src/main/java/com/terminal/buffer/Main.java
index 111a2ce..aa13260 100644
--- a/src/main/java/com/terminal/buffer/Main.java
+++ b/src/main/java/com/terminal/buffer/Main.java
@@ -1,3 +1,6 @@
+// SPDX-FileCopyrightText: 2026 Ignacio Garbayo Fernández <ignacio.garbayo@rai.usc.es>
+// SPDX-License-Identifier: MIT
+
 package com.terminal.buffer;
 
 import java.util.Scanner;
diff --git a/src/main/java/com/terminal/buffer/Row.java b/src/main/java/com/terminal/buffer/Row.java
index e331abe..b1675d4 100644
--- a/src/main/java/com/terminal/buffer/Row.java
+++ b/src/main/java/com/terminal/buffer/Row.java
@@ -1,3 +1,6 @@
+// SPDX-FileCopyrightText: 2026 Ignacio Garbayo Fernández <ignacio.garbayo@rai.usc.es>
+// SPDX-License-Identifier: MIT
+
 package com.terminal.buffer;
 
 import java.util.Arrays;
diff --git a/src/main/java/com/terminal/buffer/TerminalBuffer.java b/src/main/java/com/terminal/buffer/TerminalBuffer.java
index b664074..628a24f 100644
--- a/src/main/java/com/terminal/buffer/TerminalBuffer.java
+++ b/src/main/java/com/terminal/buffer/TerminalBuffer.java
@@ -1,3 +1,6 @@
+// SPDX-FileCopyrightText: 2026 Ignacio Garbayo Fernández <ignacio.garbayo@rai.usc.es>
+// SPDX-License-Identifier: MIT
+
 package com.terminal.buffer;
 
 import java.util.ArrayDeque;
diff --git a/src/main/java/com/terminal/buffer/TerminalColor.java b/src/main/java/com/terminal/buffer/TerminalColor.java
index ffe3019..6a1b6fc 100644
--- a/src/main/java/com/terminal/buffer/TerminalColor.java
+++ b/src/main/java/com/terminal/buffer/TerminalColor.java
@@ -1,3 +1,6 @@
+// SPDX-FileCopyrightText: 2026 Ignacio Garbayo Fernández <ignacio.garbayo@rai.usc.es>
+// SPDX-License-Identifier: MIT
+
 package com.terminal.buffer;
 
 public enum TerminalColor {
diff --git a/src/main/java/com/terminal/buffer/TextStyle.java b/src/main/java/com/terminal/buffer/TextStyle.java
index dc20123..6f85dc2 100644
--- a/src/main/java/com/terminal/buffer/TextStyle.java
+++ b/src/main/java/com/terminal/buffer/TextStyle.java
@@ -1,3 +1,6 @@
+// SPDX-FileCopyrightText: 2026 Ignacio Garbayo Fernández <ignacio.garbayo@rai.usc.es>
+// SPDX-License-Identifier: MIT
+
 package com.terminal.buffer;
 
 public enum TextStyle {
diff --git a/src/test/java/com/terminal/buffer/AttributeStateTest.java b/src/test/java/com/terminal/buffer/AttributeStateTest.java
index 9842ae8..5cf4951 100644
--- a/src/test/java/com/terminal/buffer/AttributeStateTest.java
+++ b/src/test/java/com/terminal/buffer/AttributeStateTest.java
@@ -1,3 +1,6 @@
+// SPDX-FileCopyrightText: 2026 Ignacio Garbayo Fernández <ignacio.garbayo@rai.usc.es>
+// SPDX-License-Identifier: MIT
+
 package com.terminal.buffer;
 
 import org.junit.jupiter.api.BeforeEach;
diff --git a/src/test/java/com/terminal/buffer/CellAttributesTest.java b/src/test/java/com/terminal/buffer/CellAttributesTest.java
index 6a85514..29753aa 100644
--- a/src/test/java/com/terminal/buffer/CellAttributesTest.java
+++ b/src/test/java/com/terminal/buffer/CellAttributesTest.java
@@ -1,3 +1,6 @@
+// SPDX-FileCopyrightText: 2026 Ignacio Garbayo Fernández <ignacio.garbayo@rai.usc.es>
+// SPDX-License-Identifier: MIT
+
 package com.terminal.buffer;
 
 import org.junit.jupiter.api.Test;
diff --git a/src/test/java/com/terminal/buffer/CellTest.java b/src/test/java/com/terminal/buffer/CellTest.java
index e9ffe55..d6311e6 100644
--- a/src/test/java/com/terminal/buffer/CellTest.java
+++ b/src/test/java/com/terminal/buffer/CellTest.java
@@ -1,3 +1,6 @@
+// SPDX-FileCopyrightText: 2026 Ignacio Garbayo Fernández <ignacio.garbayo@rai.usc.es>
+// SPDX-License-Identifier: MIT
+
 package com.terminal.buffer;
 
 import org.junit.jupiter.api.Test;
diff --git a/src/test/java/com/terminal/buffer/ClearScreenTest.java b/src/test/java/com/terminal/buffer/ClearScreenTest.java
index 82a9f42..118ddef 100644
--- a/src/test/java/com/terminal/buffer/ClearScreenTest.java
+++ b/src/test/java/com/terminal/buffer/ClearScreenTest.java
@@ -1,3 +1,6 @@
+// SPDX-FileCopyrightText: 2026 Ignacio Garbayo Fernández <ignacio.garbayo@rai.usc.es>
+// SPDX-License-Identifier: MIT
+
 package com.terminal.buffer;
 
 import org.junit.jupiter.api.BeforeEach;
diff --git a/src/test/java/com/terminal/buffer/ContentAccessTest.java b/src/test/java/com/terminal/buffer/ContentAccessTest.java
index 9765b3c..8a171f1 100644
--- a/src/test/java/com/terminal/buffer/ContentAccessTest.java
+++ b/src/test/java/com/terminal/buffer/ContentAccessTest.java
@@ -1,3 +1,6 @@
+// SPDX-FileCopyrightText: 2026 Ignacio Garbayo Fernández <ignacio.garbayo@rai.usc.es>
+// SPDX-License-Identifier: MIT
+
 package com.terminal.buffer;
 
 import org.junit.jupiter.api.BeforeEach;
diff --git a/src/test/java/com/terminal/buffer/CursorTest.java b/src/test/java/com/terminal/buffer/CursorTest.java
index 789b5af..5d7ef6c 100644
--- a/src/test/java/com/terminal/buffer/CursorTest.java
+++ b/src/test/java/com/terminal/buffer/CursorTest.java
@@ -1,3 +1,6 @@
+// SPDX-FileCopyrightText: 2026 Ignacio Garbayo Fernández <ignacio.garbayo@rai.usc.es>
+// SPDX-License-Identifier: MIT
+
 package com.terminal.buffer;
 
 import org.junit.jupiter.api.BeforeEach;
diff --git a/src/test/java/com/terminal/buffer/FillLineTest.java b/src/test/java/com/terminal/buffer/FillLineTest.java
index c434f84..251cdca 100644
--- a/src/test/java/com/terminal/buffer/FillLineTest.java
+++ b/src/test/java/com/terminal/buffer/FillLineTest.java
@@ -1,3 +1,6 @@
+// SPDX-FileCopyrightText: 2026 Ignacio Garbayo Fernández <ignacio.garbayo@rai.usc.es>
+// SPDX-License-Identifier: MIT
+
 package com.terminal.buffer;
 
 import org.junit.jupiter.api.BeforeEach;
diff --git a/src/test/java/com/terminal/buffer/InsertEmptyLineTest.java b/src/test/java/com/terminal/buffer/InsertEmptyLineTest.java
index c91062f..4324706 100644
--- a/src/test/java/com/terminal/buffer/InsertEmptyLineTest.java
+++ b/src/test/java/com/terminal/buffer/InsertEmptyLineTest.java
@@ -1,3 +1,6 @@
+// SPDX-FileCopyrightText: 2026 Ignacio Garbayo Fernández <ignacio.garbayo@rai.usc.es>
+// SPDX-License-Identifier: MIT
+
 package com.terminal.buffer;
 
 import org.junit.jupiter.api.BeforeEach;
diff --git a/src/test/java/com/terminal/buffer/InsertTextTest.java b/src/test/java/com/terminal/buffer/InsertTextTest.java
index e83638f..740f968 100644
--- a/src/test/java/com/terminal/buffer/InsertTextTest.java
+++ b/src/test/java/com/terminal/buffer/InsertTextTest.java
@@ -1,3 +1,6 @@
+// SPDX-FileCopyrightText: 2026 Ignacio Garbayo Fernández <ignacio.garbayo@rai.usc.es>
+// SPDX-License-Identifier: MIT
+
 package com.terminal.buffer;
 
 import org.junit.jupiter.api.BeforeEach;
diff --git a/src/test/java/com/terminal/buffer/ResizeTest.java b/src/test/java/com/terminal/buffer/ResizeTest.java
index 07d6234..0d085a8 100644
--- a/src/test/java/com/terminal/buffer/ResizeTest.java
+++ b/src/test/java/com/terminal/buffer/ResizeTest.java
@@ -1,3 +1,6 @@
+// SPDX-FileCopyrightText: 2026 Ignacio Garbayo Fernández <ignacio.garbayo@rai.usc.es>
+// SPDX-License-Identifier: MIT
+
 package com.terminal.buffer;
 
 import org.junit.jupiter.api.BeforeEach;
diff --git a/src/test/java/com/terminal/buffer/RowTest.java b/src/test/java/com/terminal/buffer/RowTest.java
index 3a5fe4e..4b56330 100644
--- a/src/test/java/com/terminal/buffer/RowTest.java
+++ b/src/test/java/com/terminal/buffer/RowTest.java
@@ -1,3 +1,6 @@
+// SPDX-FileCopyrightText: 2026 Ignacio Garbayo Fernández <ignacio.garbayo@rai.usc.es>
+// SPDX-License-Identifier: MIT
+
 package com.terminal.buffer;
 
 import org.junit.jupiter.api.Test;
diff --git a/src/test/java/com/terminal/buffer/ScrollbackTest.java b/src/test/java/com/terminal/buffer/ScrollbackTest.java
index d6108e7..5e9df18 100644
--- a/src/test/java/com/terminal/buffer/ScrollbackTest.java
+++ b/src/test/java/com/terminal/buffer/ScrollbackTest.java
@@ -1,3 +1,6 @@
+// SPDX-FileCopyrightText: 2026 Ignacio Garbayo Fernández <ignacio.garbayo@rai.usc.es>
+// SPDX-License-Identifier: MIT
+
 package com.terminal.buffer;
 
 import org.junit.jupiter.api.BeforeEach;
diff --git a/src/test/java/com/terminal/buffer/WideCharTest.java b/src/test/java/com/terminal/buffer/WideCharTest.java
index 93cf25c..0ccb98b 100644
--- a/src/test/java/com/terminal/buffer/WideCharTest.java
+++ b/src/test/java/com/terminal/buffer/WideCharTest.java
@@ -1,3 +1,6 @@
+// SPDX-FileCopyrightText: 2026 Ignacio Garbayo Fernández <ignacio.garbayo@rai.usc.es>
+// SPDX-License-Identifier: MIT
+
 package com.terminal.buffer;
 
 import org.junit.jupiter.api.BeforeEach;
diff --git a/src/test/java/com/terminal/buffer/WriteTextTest.java b/src/test/java/com/terminal/buffer/WriteTextTest.java
index 82a4b91..5c40921 100644
--- a/src/test/java/com/terminal/buffer/WriteTextTest.java
+++ b/src/test/java/com/terminal/buffer/WriteTextTest.java
@@ -1,3 +1,6 @@
+// SPDX-FileCopyrightText: 2026 Ignacio Garbayo Fernández <ignacio.garbayo@rai.usc.es>
+// SPDX-License-Identifier: MIT
+
 package com.terminal.buffer;
 
 import org.junit.jupiter.api.BeforeEach;

From 27a794d6181e38ad10188dcf2c1ef48a0f1537f0 Mon Sep 17 00:00:00 2001
From: igarbayo <ignacio.garbayo@rai.usc.es>
Date: Tue, 17 Mar 2026 00:36:54 +0100
Subject: [PATCH 03/15] chore: fix gradlew executable permission

---
 gradlew | 0
 1 file changed, 0 insertions(+), 0 deletions(-)
 mode change 100644 => 100755 gradlew

diff --git a/gradlew b/gradlew
old mode 100644
new mode 100755

From bd58f67b5fe59cbca5797277f63bfebd6f7e8fa9 Mon Sep 17 00:00:00 2001
From: igarbayo <ignacio.garbayo@rai.usc.es>
Date: Tue, 17 Mar 2026 00:40:45 +0100
Subject: [PATCH 04/15] chore: run CI on Ubuntu and Windows across Java 11, 17
 and 21

---
 .github/workflows/ci.yml | 6 ++++--
 gradle.properties        | 1 -
 2 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 588a84c..60b3b15 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -11,10 +11,11 @@ on:
 
 jobs:
   build:
-    name: Build and test (Java ${{ matrix.java }})
-    runs-on: ubuntu-latest
+    name: Build and test (Java ${{ matrix.java }}, ${{ matrix.os }})
+    runs-on: ${{ matrix.os }}
     strategy:
       matrix:
+        os: [ ubuntu-latest, windows-latest ]
         java: [ '11', '17', '21' ]
 
     steps:
@@ -29,6 +30,7 @@ jobs:
 
       - name: Run tests
         run: ./gradlew test
+        shell: bash
 
       - name: Upload test report
         if: failure()
diff --git a/gradle.properties b/gradle.properties
index 9a58b79..336465c 100644
--- a/gradle.properties
+++ b/gradle.properties
@@ -1,2 +1 @@
-org.gradle.java.home=C:\\Program Files\\Java\\jdk1.8.0_261
 org.gradle.console=plain

From 1fae3a5b4ac966554093033f8df2ee2cbaa80974 Mon Sep 17 00:00:00 2001
From: igarbayo <ignacio.garbayo@rai.usc.es>
Date: Tue, 17 Mar 2026 00:45:15 +0100
Subject: [PATCH 05/15] chore: add Apache-2.0 license text and fix missing
 REUSE footers

---
 LICENSES/Apache-2.0.txt | 170 ++++++++++++++++++++++++++++++++++++++++
 1 file changed, 170 insertions(+)
 create mode 100644 LICENSES/Apache-2.0.txt

diff --git a/LICENSES/Apache-2.0.txt b/LICENSES/Apache-2.0.txt
new file mode 100644
index 0000000..eeeb215
--- /dev/null
+++ b/LICENSES/Apache-2.0.txt
@@ -0,0 +1,170 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship made available under
+      the License, as indicated by a copyright notice that is included in
+      or attached to the work (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean, as submitted to the Licensor for inclusion
+      in the Work by the copyright owner or by an individual or Legal Entity
+      authorized to submit on behalf of the copyright owner. For the purposes
+      of this definition, "submitted" means any form of electronic, verbal,
+      or written communication sent to the Licensor or its representatives,
+      including but not limited to communication on electronic mailing lists,
+      source code control systems, and issue tracking systems that are managed
+      by, or on behalf of, the Licensor for the purpose of discussing and
+      improving the Work, but excluding communication that is conspicuously
+      marked or designated in writing by the copyright owner as "Not a
+      Contribution."
+
+      "Contributor" shall mean Licensor and any Legal Entity on behalf of
+      whom a Contribution has been received by the Licensor and included
+      within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by the combination of their Contributions
+      with the Work to which such Contributions were submitted. If You
+      institute patent litigation against any entity (including a cross-claim
+      or counterclaim in a lawsuit) alleging that the Work or any
+      Contribution embodied within the Work constitutes direct or contributory
+      patent infringement, then any patent licenses granted to You under
+      this License for that Work shall terminate as of the date such
+      litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or Derivative
+          Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, You must include a readable copy of the
+          attribution notices contained within such NOTICE file, in
+          at least one of the following places: within a NOTICE text
+          file distributed as part of the Derivative Works; within
+          the Source form or documentation, if provided along with the
+          Derivative Works; or, within a display generated by the
+          Derivative Works, if and wherever such third-party notices
+          normally appear. The contents of the NOTICE file are for
+          informational purposes only and do not modify the License.
+          You may add Your own attribution notices within Derivative
+          Works that You distribute, alongside or in addition to the
+          NOTICE text from the Work, provided that such additional
+          attribution notices cannot be construed as modifying the License.
+
+      You may add Your own license statement for Your modifications and
+      may provide additional grant of rights to use, reproduce, modify,
+      prepare Derivative Works of, convert to other media types, display,
+      perform, and distribute such Contributions under the terms of Your
+      license.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any conditions of TITLE,
+      NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR
+      PURPOSE. You are solely responsible for determining the
+      appropriateness of using or reproducing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or exemplary damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or all other
+      commercial damages or losses), even if such Contributor has been
+      advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may offer such
+      conditions only on Your own behalf and on Your sole responsibility,
+      not on behalf of any other Contributor, and only if You agree to
+      indemnify, defend, and hold each Contributor harmless for any
+      liability incurred by, or claims asserted against, such Contributor
+      by reason of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS

From 4b130a06ab3acb7b24d805155081743ee6b16339 Mon Sep 17 00:00:00 2001
From: igarbayo <ignacio.garbayo@rai.usc.es>
Date: Tue, 17 Mar 2026 00:47:53 +0100
Subject: [PATCH 06/15] chore: fix REUSE compliance for README and docs

---
 .reuse/dep5 | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/.reuse/dep5 b/.reuse/dep5
index 2d001eb..9975b04 100644
--- a/.reuse/dep5
+++ b/.reuse/dep5
@@ -1,7 +1,7 @@
 Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
 Upstream-Name: terminal-text-buffer
 Upstream-Contact: Ignacio Garbayo Fernández <ignacio.garbayo@rai.usc.es>
-Source: https://github.com/YOUR_USERNAME/terminal-text-buffer
+Source: https://github.com/igarbayo/terminal-text-buffer
 
 # Gradle wrapper — generated by Gradle, licensed under Apache-2.0
 Files: gradlew gradlew.bat gradle/wrapper/gradle-wrapper.jar gradle/wrapper/gradle-wrapper.properties
@@ -10,5 +10,10 @@ License: Apache-2.0
 
 # Project configuration files — authored by the project maintainer
 Files: gradle.properties .gitignore settings.gradle
-Copyright: 2026 Ignacio Garbayo Fernández <ignacio.garbayo@rai.usc.es>
+Copyright: 2026 Ignacio Garbayo Fernandez <ignacio.garbayo@rai.usc.es>
+License: MIT
+
+# Documentation — authored by the project maintainer
+Files: README.md docs/manual-testing-guide.md
+Copyright: 2026 Ignacio Garbayo Fernandez <ignacio.garbayo@rai.usc.es>
 License: MIT

From 9d01e53d837480f1ca41ce71b5cd864b3947c40d Mon Sep 17 00:00:00 2001
From: igarbayo <ignacio.garbayo@rai.usc.es>
Date: Tue, 17 Mar 2026 13:29:18 +0100
Subject: [PATCH 07/15] docs: add explanatory comments to all test classes

---
 src/main/java/com/terminal/buffer/Cell.java     | 10 +++++++++-
 .../com/terminal/buffer/CellAttributes.java     |  8 ++++++++
 .../com/terminal/buffer/CursorPosition.java     |  7 +++++++
 src/main/java/com/terminal/buffer/Main.java     | 15 +++++++++++++++
 src/main/java/com/terminal/buffer/Row.java      | 15 +++++++++++----
 .../com/terminal/buffer/TerminalBuffer.java     |  9 +++++++++
 .../java/com/terminal/buffer/TerminalColor.java |  1 +
 .../java/com/terminal/buffer/TextStyle.java     |  1 +
 .../com/terminal/buffer/AttributeStateTest.java |  8 ++++++++
 .../com/terminal/buffer/CellAttributesTest.java | 14 ++++++++++++++
 src/test/java/com/terminal/buffer/CellTest.java | 10 ++++++++++
 .../com/terminal/buffer/ClearScreenTest.java    |  6 ++++++
 .../com/terminal/buffer/ContentAccessTest.java  | 11 +++++++++++
 .../java/com/terminal/buffer/CursorTest.java    | 17 +++++++++++++++++
 .../java/com/terminal/buffer/FillLineTest.java  |  5 +++++
 .../terminal/buffer/InsertEmptyLineTest.java    |  7 +++++++
 .../com/terminal/buffer/InsertTextTest.java     |  9 +++++++++
 .../java/com/terminal/buffer/ResizeTest.java    |  8 ++++++++
 src/test/java/com/terminal/buffer/RowTest.java  |  8 ++++++++
 .../com/terminal/buffer/ScrollbackTest.java     |  7 +++++++
 .../java/com/terminal/buffer/WideCharTest.java  | 11 +++++++++++
 .../java/com/terminal/buffer/WriteTextTest.java | 12 ++++++++++++
 22 files changed, 194 insertions(+), 5 deletions(-)

diff --git a/src/main/java/com/terminal/buffer/Cell.java b/src/main/java/com/terminal/buffer/Cell.java
index 5a319e7..76d48ca 100644
--- a/src/main/java/com/terminal/buffer/Cell.java
+++ b/src/main/java/com/terminal/buffer/Cell.java
@@ -8,17 +8,19 @@
 public final class Cell {
 
     public enum CellType {
-        NORMAL,
+        NORMAL,      // regular single-column character
         WIDE_LEFT,   // left half of a 2-column glyph
         WIDE_RIGHT   // synthetic placeholder occupying the right column
     }
 
+    // A shared immutable empty cell instance to avoid unnecessary allocations for blank spaces
     public static final Cell EMPTY = new Cell(' ', CellAttributes.DEFAULT, CellType.NORMAL);
 
     private final char character;
     private final CellAttributes attributes;
     private final CellType type;
 
+    // Constructors
     public Cell(char character, CellAttributes attributes) {
         this(character, attributes, CellType.NORMAL);
     }
@@ -29,6 +31,7 @@ public Cell(char character, CellAttributes attributes, CellType type) {
         this.type = type;
     }
 
+    // Getters
     public char getCharacter() {
         return character;
     }
@@ -41,6 +44,9 @@ public CellType getType() {
         return type;
     }
 
+    // there are no setters needed, as Cell is a final class with private final fields, making it immutable
+
+    // Convenience methods for checking cell type
     public boolean isWide() {
         return type == CellType.WIDE_LEFT;
     }
@@ -49,6 +55,7 @@ public boolean isPlaceholder() {
         return type == CellType.WIDE_RIGHT;
     }
 
+    // we always redefine equals and hashcode together, even if we don't use them in hash-based collections, to ensure consistent behavior when comparing cells
     @Override
     public boolean equals(Object o) {
         if (this == o) return true;
@@ -64,6 +71,7 @@ public int hashCode() {
         return Objects.hash(character, attributes, type);
     }
 
+    // For debugging purposes, we provide a string representation of the cell that includes its character, attributes, and type
     @Override
     public String toString() {
         return "Cell{'" + character + "', " + attributes + ", " + type + "}";
diff --git a/src/main/java/com/terminal/buffer/CellAttributes.java b/src/main/java/com/terminal/buffer/CellAttributes.java
index 1f6ed6e..0317c65 100644
--- a/src/main/java/com/terminal/buffer/CellAttributes.java
+++ b/src/main/java/com/terminal/buffer/CellAttributes.java
@@ -17,12 +17,14 @@ public final class CellAttributes {
     private final TerminalColor background;
     private final EnumSet<TextStyle> styles;
 
+    // Constructors
     public CellAttributes(TerminalColor foreground, TerminalColor background, Set<TextStyle> styles) {
         this.foreground = foreground;
         this.background = background;
         this.styles = styles.isEmpty() ? EnumSet.noneOf(TextStyle.class) : EnumSet.copyOf(styles);
     }
 
+    // Getters
     public TerminalColor getForeground() {
         return foreground;
     }
@@ -35,6 +37,9 @@ public Set<TextStyle> getStyles() {
         return Collections.unmodifiableSet(styles);
     }
 
+    // no setters are needed, as CellAttributes is a final class with private final fields, making it immutable
+
+    // Convenience methods for checking styles
     public boolean hasStyle(TextStyle style) {
         return styles.contains(style);
     }
@@ -59,6 +64,8 @@ public CellAttributes withoutStyle(TextStyle style) {
         return new CellAttributes(foreground, background, newStyles);
     }
 
+
+    // we always redefine equals and hashcode together, even if we don't use them in hash-based collections, to ensure consistent behavior when comparing cell attributes
     @Override
     public boolean equals(Object o) {
         if (this == o) return true;
@@ -74,6 +81,7 @@ public int hashCode() {
         return Objects.hash(foreground, background, styles);
     }
 
+    // For debugging purposes, we provide a string representation of the cell attributes that includes its foreground, background, and styles
     @Override
     public String toString() {
         return "CellAttributes{fg=" + foreground + ", bg=" + background + ", styles=" + styles + "}";
diff --git a/src/main/java/com/terminal/buffer/CursorPosition.java b/src/main/java/com/terminal/buffer/CursorPosition.java
index 6235ccf..e1eb12c 100644
--- a/src/main/java/com/terminal/buffer/CursorPosition.java
+++ b/src/main/java/com/terminal/buffer/CursorPosition.java
@@ -7,14 +7,17 @@
 
 public final class CursorPosition {
 
+    // CursorPosition is a simple immutable data class representing the column and row of the cursor in the terminal buffer. It provides basic getters, equality, and string representation methods.
     private final int col;
     private final int row;
 
+    // Constructor
     public CursorPosition(int col, int row) {
         this.col = col;
         this.row = row;
     }
 
+    // Getters
     public int getCol() {
         return col;
     }
@@ -23,6 +26,9 @@ public int getRow() {
         return row;
     }
 
+    // no setters are needed, as CursorPosition is a final class with private final fields, making it immutable
+
+    // we always redefine equals and hashcode together, even if we don't use them in hash-based collections, to ensure consistent behavior when comparing cursor positions
     @Override
     public boolean equals(Object o) {
         if (this == o) return true;
@@ -36,6 +42,7 @@ public int hashCode() {
         return Objects.hash(col, row);
     }
 
+    // For debugging purposes, we provide a string representation of the cursor position that includes its column and row
     @Override
     public String toString() {
         return "CursorPosition{col=" + col + ", row=" + row + "}";
diff --git a/src/main/java/com/terminal/buffer/Main.java b/src/main/java/com/terminal/buffer/Main.java
index aa13260..3685b20 100644
--- a/src/main/java/com/terminal/buffer/Main.java
+++ b/src/main/java/com/terminal/buffer/Main.java
@@ -8,17 +8,21 @@
 
 public class Main {
 
+    // Main REPL demo buffer: 80x24 with up to 200 scrollback lines.
     private static TerminalBuffer buf = new TerminalBuffer(80, 24, 200);
 
     public static void main(String[] args) {
+        // Show help and the initial state before accepting commands.
         printHelp();
         printBuffer();
 
+        // Read commands line by line from stdin until EOF.
         try (Scanner scanner = new Scanner(System.in, "UTF-8")) {
             while (scanner.hasNextLine()) {
                 String line = scanner.nextLine().trim();
                 if (line.isEmpty()) continue;
 
+                // Repaint only when the command changes buffer contents.
                 boolean changed = handleCommand(line);
                 if (changed) printBuffer();
             }
@@ -26,11 +30,13 @@ public static void main(String[] args) {
     }
 
     private static boolean handleCommand(String line) {
+        // Split command and argument to keep parsing simple.
         String[] parts = line.split(" ", 2);
         String cmd = parts[0].toLowerCase();
         String arg = parts.length > 1 ? parts[1] : "";
 
         try {
+            // Main REPL command dispatcher.
             switch (cmd) {
                 case "write":
                     if (arg.isEmpty()) { err("write <texto>"); return false; }
@@ -181,6 +187,7 @@ private static void printBuffer() {
             for (int col = 0; col < w; col++) {
                 Cell cell = buf.getCell(col, row);
                 CellAttributes attrs = cell.getAttributes();
+                // Emit ANSI attributes only when they change from the previous cell.
                 if (!attrs.equals(prev)) {
                     sb.append("\033[0m");
                     sb.append(ansiAttrs(attrs));
@@ -188,6 +195,7 @@ private static void printBuffer() {
                 }
                 boolean isCursor = (col == cur.getCol() && row == cur.getRow());
                 char ch = cell.getCharacter();
+                // Highlight cursor position; use a visible block for blank cells.
                 if (isCursor) {
                     sb.append(ch == ' ' || ch == '\0' ? '\u258c' : ch);
                 } else {
@@ -227,6 +235,7 @@ private static String styleList(Set<TextStyle> styles) {
 
     private static void printScrollback() {
         int size = buf.getScrollbackSize();
+        // Print scrollback history from oldest to newest.
         if (size == 0) {
             System.out.println("--- Scrollback vacio ---");
             System.out.print("> ");
@@ -249,6 +258,7 @@ private static void printScrollback() {
     private static void printInfo() {
         CursorPosition cur = buf.getCursor();
         CellAttributes attrs = buf.getAttributes();
+        // Print a compact runtime snapshot of buffer, cursor, and active attributes.
         System.out.println("Dimensiones : " + buf.getWidth() + " x " + buf.getHeight());
         System.out.println("Scrollback  : " + buf.getScrollbackSize() + " / " + buf.getMaxScrollback() + " lineas");
         System.out.println("Cursor      : col=" + cur.getCol() + " row=" + cur.getRow());
@@ -265,6 +275,7 @@ private static void printInfo() {
     // -------------------------------------------------------------------------
 
     private static void printHelp() {
+        // Render static command reference shown at startup and on demand.
         System.out.println("╔══════════════════════════════════════════════════════╗");
         System.out.println("║          Terminal Text Buffer — REPL                 ║");
         System.out.println("╠══════════════════════════════════════════════════════╣");
@@ -306,12 +317,14 @@ private static void printHelp() {
     // -------------------------------------------------------------------------
 
     private static void err(String msg) {
+        // Keep error output and prompt behavior consistent across commands.
         System.out.println("  [!] " + msg);
         System.out.print("> ");
         System.out.flush();
     }
 
     private static String repeat(String s, int n) {
+        // Small utility to repeat border characters for frame rendering.
         StringBuilder sb = new StringBuilder();
         for (int i = 0; i < n; i++) sb.append(s);
         return sb.toString();
@@ -319,6 +332,7 @@ private static String repeat(String s, int n) {
 
     private static String ansiAttrs(CellAttributes attrs) {
         StringBuilder sb = new StringBuilder();
+        // Build ANSI sequence by combining active styles and colors.
         if (attrs.hasStyle(TextStyle.BOLD))      sb.append("\033[1m");
         if (attrs.hasStyle(TextStyle.ITALIC))    sb.append("\033[3m");
         if (attrs.hasStyle(TextStyle.UNDERLINE)) sb.append("\033[4m");
@@ -330,6 +344,7 @@ private static String ansiAttrs(CellAttributes attrs) {
     }
 
     private static String ansiColor(TerminalColor color, boolean background) {
+        // Map terminal color enum values to ANSI SGR foreground/background codes.
         int base = background ? 40 : 30;
         switch (color) {
             case BLACK:          return "\033[" + base + "m";
diff --git a/src/main/java/com/terminal/buffer/Row.java b/src/main/java/com/terminal/buffer/Row.java
index b1675d4..1dd79af 100644
--- a/src/main/java/com/terminal/buffer/Row.java
+++ b/src/main/java/com/terminal/buffer/Row.java
@@ -7,25 +7,35 @@
 
 final class Row {
 
+    // Row represents a single line in the terminal buffer, consisting of an array of Cell objects. It provides methods to access and modify cells, fill ranges with a specific cell, and convert the row content to a string while skipping placeholder cells.
     private final Cell[] cells;
 
+    // Constructor to create a new Row with a specified width, initializing all cells to the shared EMPTY instance to optimize memory usage for blank spaces.
     Row(int width) {
         this.cells = new Cell[width];
         Arrays.fill(cells, Cell.EMPTY);
     }
 
+    // Copy constructor to create a new Row by copying the cells from another Row, ensuring that the new Row has its own array of cells while sharing the same Cell instances where possible.
     Row(Row other) {
         this.cells = Arrays.copyOf(other.cells, other.cells.length);
     }
 
+    // Getters
     Cell getCell(int col) {
         return cells[col];
     }
 
+    int getWidth() {
+        return cells.length;
+    }
+
+    // Setters
     void setCell(int col, Cell cell) {
         cells[col] = cell;
     }
 
+    // Methods to fill the entire row or a specific range of columns with a given Cell instance, which can be used for operations like clearing a line or applying a uniform style.
     void fill(Cell cell) {
         Arrays.fill(cells, cell);
     }
@@ -34,6 +44,7 @@ void fill(int fromCol, int toCol, Cell cell) {
         Arrays.fill(cells, fromCol, toCol, cell);
     }
 
+    // Converts the content of the row to a string by concatenating the characters of the cells, while skipping any placeholder cells (those that are part of a wide character) to ensure that the resulting string accurately represents the visible content of the row.
     String toContentString() {
         StringBuilder sb = new StringBuilder(cells.length);
         for (Cell cell : cells) {
@@ -43,8 +54,4 @@ String toContentString() {
         }
         return sb.toString();
     }
-
-    int getWidth() {
-        return cells.length;
-    }
 }
diff --git a/src/main/java/com/terminal/buffer/TerminalBuffer.java b/src/main/java/com/terminal/buffer/TerminalBuffer.java
index 628a24f..b6f3766 100644
--- a/src/main/java/com/terminal/buffer/TerminalBuffer.java
+++ b/src/main/java/com/terminal/buffer/TerminalBuffer.java
@@ -18,6 +18,7 @@ public class TerminalBuffer {
 
     private int cursorCol;
     private int cursorRow;
+    // xterm-style deferred wrap once writing reaches the last column.
     private boolean pendingWrap;
 
     private CellAttributes currentAttributes;
@@ -60,6 +61,7 @@ public TerminalBuffer(int width, int height, int maxScrollback) {
     // -------------------------------------------------------------------------
 
     public void setAttributes(CellAttributes attributes) {
+        // Replaces the full active attribute state used by future writes.
         this.currentAttributes = attributes;
     }
 
@@ -96,12 +98,14 @@ public CursorPosition getCursor() {
     }
 
     public void setCursor(int col, int row) {
+        // Keep cursor always inside visible screen bounds.
         cursorCol = clampCol(col);
         cursorRow = clampRow(row);
         pendingWrap = false;
     }
 
     public void moveCursorRight(int n) {
+        // Relative movement is clamped instead of throwing on overflow.
         cursorCol = clampCol(cursorCol + n);
         pendingWrap = false;
     }
@@ -364,6 +368,7 @@ public void resize(int newWidth, int newHeight) {
         width = newWidth;
         height = newHeight;
 
+        // Cursor may become out-of-bounds after resize, so clamp it again.
         cursorCol = clampCol(cursorCol);
         cursorRow = clampRow(cursorRow);
         pendingWrap = false;
@@ -382,6 +387,7 @@ private int clampRow(int row) {
     }
 
     private Row resolveRow(int row) {
+        // Non-negative rows address visible screen, negative rows address scrollback.
         if (row >= 0 && row < height) {
             return screen[row];
         }
@@ -405,6 +411,7 @@ private void pushTopRowToScrollback() {
 
     private void pushRowToScrollback(Row row) {
         if (maxScrollback == 0) return;
+        // Store a copy so later screen mutations do not affect history.
         scrollback.addLast(new Row(row));
         if (scrollback.size() > maxScrollback) {
             scrollback.removeFirst();
@@ -412,6 +419,7 @@ private void pushRowToScrollback(Row row) {
     }
 
     private void advanceCursorToNextLine() {
+        // At bottom edge, advance implies scroll-up by inserting an empty line.
         if (cursorRow < height - 1) {
             cursorRow++;
             cursorCol = 0;
@@ -492,6 +500,7 @@ private void insertCellsAt(int col, int row, Cell[] cells) {
         if (combined.length > available) {
             Cell[] overflow = Arrays.copyOfRange(combined, available, combined.length);
             if (hasActualContent(overflow)) {
+                // Recursively continue insertion on following rows.
                 int nextRow = row + 1;
                 if (nextRow >= height) {
                     insertEmptyLine();
diff --git a/src/main/java/com/terminal/buffer/TerminalColor.java b/src/main/java/com/terminal/buffer/TerminalColor.java
index 6a1b6fc..362f98b 100644
--- a/src/main/java/com/terminal/buffer/TerminalColor.java
+++ b/src/main/java/com/terminal/buffer/TerminalColor.java
@@ -3,6 +3,7 @@
 
 package com.terminal.buffer;
 
+// TerminalColor is an enumeration representing the standard terminal colors, including both normal and bright variants, as well as a default color that can be used to indicate no specific color preference. This enum can be used in CellAttributes to specify the foreground and background colors of terminal cells.
 public enum TerminalColor {
     DEFAULT,
     BLACK, RED, GREEN, YELLOW, BLUE, MAGENTA, CYAN, WHITE,
diff --git a/src/main/java/com/terminal/buffer/TextStyle.java b/src/main/java/com/terminal/buffer/TextStyle.java
index 6f85dc2..d3f044a 100644
--- a/src/main/java/com/terminal/buffer/TextStyle.java
+++ b/src/main/java/com/terminal/buffer/TextStyle.java
@@ -3,6 +3,7 @@
 
 package com.terminal.buffer;
 
+// TextStyle is an enumeration representing the various text styles that can be applied to terminal cells, such as bold, italic, and underline. This enum can be used in CellAttributes to specify the styles that should be applied to the text in a cell.
 public enum TextStyle {
     BOLD, ITALIC, UNDERLINE
 }
diff --git a/src/test/java/com/terminal/buffer/AttributeStateTest.java b/src/test/java/com/terminal/buffer/AttributeStateTest.java
index 5cf4951..b076720 100644
--- a/src/test/java/com/terminal/buffer/AttributeStateTest.java
+++ b/src/test/java/com/terminal/buffer/AttributeStateTest.java
@@ -17,11 +17,13 @@ void setUp() {
         buf = new TerminalBuffer(10, 5, 100);
     }
 
+    // A freshly created buffer must report DEFAULT attributes (no color, no styles).
     @Test
     void bufferStartsWithDefaultAttributes() {
         assertEquals(CellAttributes.DEFAULT, buf.getAttributes());
     }
 
+    // Setting the foreground must not affect the background or style set.
     @Test
     void setForegroundChangesOnlyForeground() {
         buf.setForeground(TerminalColor.RED);
@@ -30,6 +32,7 @@ void setForegroundChangesOnlyForeground() {
         assertTrue(buf.getAttributes().getStyles().isEmpty());
     }
 
+    // Setting the background must not affect the foreground.
     @Test
     void setBackgroundChangesOnlyBackground() {
         buf.setBackground(TerminalColor.BLUE);
@@ -37,6 +40,7 @@ void setBackgroundChangesOnlyBackground() {
         assertEquals(TerminalColor.DEFAULT, buf.getAttributes().getForeground());
     }
 
+    // Adding BOLD must not activate unrelated styles such as ITALIC.
     @Test
     void addStyleAddsBoldWithoutAffectingOthers() {
         buf.addStyle(TextStyle.BOLD);
@@ -44,6 +48,7 @@ void addStyleAddsBoldWithoutAffectingOthers() {
         assertFalse(buf.getAttributes().hasStyle(TextStyle.ITALIC));
     }
 
+    // Multiple styles can coexist independently in the same attribute state.
     @Test
     void addMultipleStyles() {
         buf.addStyle(TextStyle.BOLD);
@@ -53,6 +58,7 @@ void addMultipleStyles() {
         assertFalse(buf.getAttributes().hasStyle(TextStyle.ITALIC));
     }
 
+    // Removing one style must leave other active styles unchanged.
     @Test
     void removeStyleRemovesOnlyThatStyle() {
         buf.addStyle(TextStyle.BOLD);
@@ -62,6 +68,7 @@ void removeStyleRemovesOnlyThatStyle() {
         assertTrue(buf.getAttributes().hasStyle(TextStyle.ITALIC));
     }
 
+    // resetAttributes must restore the attribute state to exactly DEFAULT.
     @Test
     void resetAttributesRestoresDefault() {
         buf.setForeground(TerminalColor.RED);
@@ -71,6 +78,7 @@ void resetAttributesRestoresDefault() {
         assertEquals(CellAttributes.DEFAULT, buf.getAttributes());
     }
 
+    // setAttributes must replace the entire current attribute state.
     @Test
     void setAttributesReplacesEntirely() {
         CellAttributes custom = new CellAttributes(TerminalColor.GREEN, TerminalColor.MAGENTA,
diff --git a/src/test/java/com/terminal/buffer/CellAttributesTest.java b/src/test/java/com/terminal/buffer/CellAttributesTest.java
index 29753aa..21a4449 100644
--- a/src/test/java/com/terminal/buffer/CellAttributesTest.java
+++ b/src/test/java/com/terminal/buffer/CellAttributesTest.java
@@ -12,6 +12,7 @@
 
 class CellAttributesTest {
 
+    // DEFAULT must have DEFAULT foreground and background and an empty style set.
     @Test
     void defaultAttributesHaveDefaultColors() {
         CellAttributes attrs = CellAttributes.DEFAULT;
@@ -20,6 +21,7 @@ void defaultAttributesHaveDefaultColors() {
         assertTrue(attrs.getStyles().isEmpty());
     }
 
+    // The constructor must store the supplied colors and styles correctly.
     @Test
     void constructorStoresValues() {
         CellAttributes attrs = new CellAttributes(TerminalColor.RED, TerminalColor.BLUE,
@@ -30,6 +32,8 @@ void constructorStoresValues() {
         assertFalse(attrs.hasStyle(TextStyle.ITALIC));
     }
 
+    // The constructor must copy the style set defensively so later mutations of the source
+    // do not affect the stored styles.
     @Test
     void constructorDefensivelyCopiesStyles() {
         EnumSet<TextStyle> original = EnumSet.of(TextStyle.BOLD);
@@ -38,6 +42,7 @@ void constructorDefensivelyCopiesStyles() {
         assertFalse(attrs.hasStyle(TextStyle.ITALIC), "mutation of source set must not affect stored styles");
     }
 
+    // getStyles must return an unmodifiable view so callers cannot corrupt the internal state.
     @Test
     void getStylesReturnsUnmodifiableView() {
         CellAttributes attrs = new CellAttributes(TerminalColor.DEFAULT, TerminalColor.DEFAULT,
@@ -46,6 +51,7 @@ void getStylesReturnsUnmodifiableView() {
         assertThrows(UnsupportedOperationException.class, () -> styles.add(TextStyle.ITALIC));
     }
 
+    // withForeground must return a new instance with the updated color without modifying the original.
     @Test
     void withForegroundReturnsNewInstanceWithUpdatedColor() {
         CellAttributes original = CellAttributes.DEFAULT;
@@ -55,6 +61,7 @@ void withForegroundReturnsNewInstanceWithUpdatedColor() {
         assertEquals(TerminalColor.DEFAULT, original.getForeground(), "original must be unchanged");
     }
 
+    // withBackground must return a new instance with the updated color without modifying the original.
     @Test
     void withBackgroundReturnsNewInstanceWithUpdatedColor() {
         CellAttributes original = CellAttributes.DEFAULT;
@@ -63,6 +70,7 @@ void withBackgroundReturnsNewInstanceWithUpdatedColor() {
         assertEquals(TerminalColor.DEFAULT, original.getBackground(), "original must be unchanged");
     }
 
+    // withStyle must return a new instance with the added style without modifying the original.
     @Test
     void withStyleAddsStyleWithoutAffectingOriginal() {
         CellAttributes original = CellAttributes.DEFAULT;
@@ -71,12 +79,14 @@ void withStyleAddsStyleWithoutAffectingOriginal() {
         assertFalse(original.hasStyle(TextStyle.BOLD), "original must be unchanged");
     }
 
+    // Adding the same style twice must not result in duplicates.
     @Test
     void withStyleDoesNotDuplicateExistingStyle() {
         CellAttributes attrs = CellAttributes.DEFAULT.withStyle(TextStyle.BOLD).withStyle(TextStyle.BOLD);
         assertEquals(1, attrs.getStyles().size());
     }
 
+    // withoutStyle must return a new instance with the style removed without modifying the original.
     @Test
     void withoutStyleRemovesStyleWithoutAffectingOriginal() {
         CellAttributes original = CellAttributes.DEFAULT.withStyle(TextStyle.BOLD).withStyle(TextStyle.ITALIC);
@@ -86,6 +96,7 @@ void withoutStyleRemovesStyleWithoutAffectingOriginal() {
         assertTrue(original.hasStyle(TextStyle.BOLD), "original must be unchanged");
     }
 
+    // Two instances with identical colors and styles must be equal with matching hash codes.
     @Test
     void equalAttributesAreEqual() {
         CellAttributes a = new CellAttributes(TerminalColor.RED, TerminalColor.BLUE, EnumSet.of(TextStyle.BOLD));
@@ -94,6 +105,7 @@ void equalAttributesAreEqual() {
         assertEquals(a.hashCode(), b.hashCode());
     }
 
+    // A different foreground color must make two instances unequal.
     @Test
     void differentForegroundMakesNotEqual() {
         CellAttributes a = new CellAttributes(TerminalColor.RED, TerminalColor.DEFAULT,
@@ -103,6 +115,7 @@ void differentForegroundMakesNotEqual() {
         assertNotEquals(a, b);
     }
 
+    // Different style sets must make two instances unequal.
     @Test
     void differentStylesMakesNotEqual() {
         CellAttributes a = CellAttributes.DEFAULT.withStyle(TextStyle.BOLD);
@@ -110,6 +123,7 @@ void differentStylesMakesNotEqual() {
         assertNotEquals(a, b);
     }
 
+    // toString must include the color names and style names for easy debugging.
     @Test
     void toStringContainsColorAndStyleInfo() {
         CellAttributes attrs = new CellAttributes(TerminalColor.RED, TerminalColor.BLUE,
diff --git a/src/test/java/com/terminal/buffer/CellTest.java b/src/test/java/com/terminal/buffer/CellTest.java
index d6311e6..0b6bb3a 100644
--- a/src/test/java/com/terminal/buffer/CellTest.java
+++ b/src/test/java/com/terminal/buffer/CellTest.java
@@ -9,6 +9,7 @@
 
 class CellTest {
 
+    // Cell.EMPTY must represent a space with default attributes and NORMAL type.
     @Test
     void emptyConstantHasSpaceAndDefaultAttributes() {
         assertEquals(' ', Cell.EMPTY.getCharacter());
@@ -16,6 +17,7 @@ void emptyConstantHasSpaceAndDefaultAttributes() {
         assertEquals(Cell.CellType.NORMAL, Cell.EMPTY.getType());
     }
 
+    // The two-argument constructor must default to NORMAL type.
     @Test
     void twoArgConstructorDefaultsToNormalType() {
         Cell cell = new Cell('A', CellAttributes.DEFAULT);
@@ -25,6 +27,7 @@ void twoArgConstructorDefaultsToNormalType() {
         assertFalse(cell.isPlaceholder());
     }
 
+    // A WIDE_LEFT cell must report isWide=true and isPlaceholder=false.
     @Test
     void wideCellIsWideAndNotPlaceholder() {
         Cell cell = new Cell('字', CellAttributes.DEFAULT, Cell.CellType.WIDE_LEFT);
@@ -32,6 +35,7 @@ void wideCellIsWideAndNotPlaceholder() {
         assertFalse(cell.isPlaceholder());
     }
 
+    // A WIDE_RIGHT (placeholder) cell must report isPlaceholder=true and isWide=false.
     @Test
     void placeholderCellIsPlaceholderAndNotWide() {
         Cell cell = new Cell('\0', CellAttributes.DEFAULT, Cell.CellType.WIDE_RIGHT);
@@ -39,6 +43,7 @@ void placeholderCellIsPlaceholderAndNotWide() {
         assertTrue(cell.isPlaceholder());
     }
 
+    // A NORMAL cell is neither wide nor a placeholder.
     @Test
     void normalCellIsNeitherWideNorPlaceholder() {
         Cell cell = new Cell('A', CellAttributes.DEFAULT, Cell.CellType.NORMAL);
@@ -46,6 +51,7 @@ void normalCellIsNeitherWideNorPlaceholder() {
         assertFalse(cell.isPlaceholder());
     }
 
+    // Two cells with the same character, attributes and type must be equal (equals and hashCode).
     @Test
     void equalCellsAreEqual() {
         Cell a = new Cell('A', CellAttributes.DEFAULT);
@@ -54,6 +60,7 @@ void equalCellsAreEqual() {
         assertEquals(a.hashCode(), b.hashCode());
     }
 
+    // Cells with different characters must not be equal.
     @Test
     void cellsWithDifferentCharsAreNotEqual() {
         Cell a = new Cell('A', CellAttributes.DEFAULT);
@@ -61,6 +68,7 @@ void cellsWithDifferentCharsAreNotEqual() {
         assertNotEquals(a, b);
     }
 
+    // Cells with the same character but different types must not be equal.
     @Test
     void cellsWithDifferentTypesAreNotEqual() {
         Cell a = new Cell('A', CellAttributes.DEFAULT, Cell.CellType.NORMAL);
@@ -68,6 +76,7 @@ void cellsWithDifferentTypesAreNotEqual() {
         assertNotEquals(a, b);
     }
 
+    // Cells with the same character but different attributes must not be equal.
     @Test
     void cellsWithDifferentAttributesAreNotEqual() {
         Cell a = new Cell('A', CellAttributes.DEFAULT);
@@ -75,6 +84,7 @@ void cellsWithDifferentAttributesAreNotEqual() {
         assertNotEquals(a, b);
     }
 
+    // The cell must return exactly the attributes it was constructed with.
     @Test
     void cellStoresAttributes() {
         CellAttributes attrs = CellAttributes.DEFAULT.withForeground(TerminalColor.RED).withStyle(TextStyle.BOLD);
diff --git a/src/test/java/com/terminal/buffer/ClearScreenTest.java b/src/test/java/com/terminal/buffer/ClearScreenTest.java
index 118ddef..6123ed4 100644
--- a/src/test/java/com/terminal/buffer/ClearScreenTest.java
+++ b/src/test/java/com/terminal/buffer/ClearScreenTest.java
@@ -17,6 +17,7 @@ void setUp() {
         buf = new TerminalBuffer(5, 3, 100);
     }
 
+    // A fresh buffer must render as a grid of spaces (no content written yet).
     @Test
     void freshBufferScreenContentIsAllSpaces() {
         String content = buf.getScreenContent();
@@ -24,6 +25,7 @@ void freshBufferScreenContentIsAllSpaces() {
         assertEquals("     \n     \n     ", content);
     }
 
+    // clearScreen must reset every cell on the screen to a space with default attributes.
     @Test
     void clearScreenResetsAllCellsToEmpty() {
         buf.setCursor(0, 0);
@@ -37,6 +39,7 @@ void clearScreenResetsAllCellsToEmpty() {
         }
     }
 
+    // clearScreen must leave the scrollback buffer intact.
     @Test
     void clearScreenDoesNotRemoveScrollback() {
         // Push something into scrollback
@@ -47,6 +50,7 @@ void clearScreenDoesNotRemoveScrollback() {
         assertEquals(1, buf.getScrollbackSize(), "clearScreen must not touch scrollback");
     }
 
+    // clearAll must wipe the scrollback completely.
     @Test
     void clearAllRemovesScrollback() {
         buf.insertEmptyLine();
@@ -57,6 +61,7 @@ void clearAllRemovesScrollback() {
         assertEquals(0, buf.getScrollbackSize());
     }
 
+    // clearAll must also clear the screen content, not only the scrollback.
     @Test
     void clearAllAlsoClearsScreen() {
         buf.setCursor(0, 0);
@@ -65,6 +70,7 @@ void clearAllAlsoClearsScreen() {
         assertEquals(' ', buf.getChar(0, 0));
     }
 
+    // getScreenContent must return exactly height lines each of exactly width characters.
     @Test
     void getScreenContentHasCorrectDimensions() {
         String content = buf.getScreenContent();
diff --git a/src/test/java/com/terminal/buffer/ContentAccessTest.java b/src/test/java/com/terminal/buffer/ContentAccessTest.java
index 8a171f1..3ed267b 100644
--- a/src/test/java/com/terminal/buffer/ContentAccessTest.java
+++ b/src/test/java/com/terminal/buffer/ContentAccessTest.java
@@ -17,6 +17,7 @@ void setUp() {
         buf = new TerminalBuffer(5, 3, 100);
     }
 
+    // getLine must strip trailing spaces so callers receive a clean string.
     @Test
     void getLineTrimmsTrailingSpaces() {
         buf.setCursor(0, 0);
@@ -24,11 +25,13 @@ void getLineTrimmsTrailingSpaces() {
         assertEquals("Hi", buf.getLine(0));
     }
 
+    // getLine on a blank row must return an empty string (all spaces trimmed).
     @Test
     void getLineReturnsEmptyStringForBlankLine() {
         assertEquals("", buf.getLine(0));
     }
 
+    // getRawLine must return the full fixed-width content including trailing spaces.
     @Test
     void getRawLineReturnsFixedWidth() {
         buf.setCursor(0, 0);
@@ -36,6 +39,7 @@ void getRawLineReturnsFixedWidth() {
         assertEquals("Hi   ", buf.getRawLine(0)); // padded to width=5
     }
 
+    // getLine with a negative index must address the scrollback (row -1 = most recent).
     @Test
     void getLineScrollbackRow() {
         buf.setCursor(0, 0);
@@ -44,16 +48,19 @@ void getLineScrollbackRow() {
         assertEquals("ABCDE", buf.getLine(-1));
     }
 
+    // getLine with a screen row index >= height must throw IllegalArgumentException.
     @Test
     void getLineOutOfRangePositiveThrows() {
         assertThrows(IllegalArgumentException.class, () -> buf.getLine(3));
     }
 
+    // getLine with a negative index when the scrollback is empty must throw IllegalArgumentException.
     @Test
     void getLineOutOfRangeNegativeThrows() {
         assertThrows(IllegalArgumentException.class, () -> buf.getLine(-1));
     }
 
+    // getScreenContent must contain exactly height-1 newline characters.
     @Test
     void getScreenContentHasHeightMinusOneNewlines() {
         String content = buf.getScreenContent();
@@ -61,6 +68,7 @@ void getScreenContentHasHeightMinusOneNewlines() {
         assertEquals(buf.getHeight() - 1, newlines);
     }
 
+    // getAllContent must contain scrollback lines followed by screen lines separated by newlines.
     @Test
     void getAllContentHasScrollbackPlusScreenLines() {
         buf.insertEmptyLine();
@@ -71,6 +79,7 @@ void getAllContentHasScrollbackPlusScreenLines() {
         assertEquals(buf.getScrollbackSize() + buf.getHeight() - 1, newlines);
     }
 
+    // getChar must be able to read a character from a scrollback row using a negative index.
     @Test
     void getCharOnScrollbackRow() {
         buf.setForeground(TerminalColor.RED);
@@ -80,6 +89,7 @@ void getCharOnScrollbackRow() {
         assertEquals('X', buf.getChar(2, -1));
     }
 
+    // getAttributesAt must be able to read attributes from a scrollback row using a negative index.
     @Test
     void getAttributesAtOnScrollbackRow() {
         buf.setForeground(TerminalColor.BLUE);
@@ -89,6 +99,7 @@ void getAttributesAtOnScrollbackRow() {
         assertEquals(TerminalColor.BLUE, buf.getAttributesAt(1, -1).getForeground());
     }
 
+    // getLine on a scrollback row must also trim trailing spaces.
     @Test
     void getLineScrollbackWithTrimming() {
         buf.setCursor(0, 0);
diff --git a/src/test/java/com/terminal/buffer/CursorTest.java b/src/test/java/com/terminal/buffer/CursorTest.java
index 5d7ef6c..b316393 100644
--- a/src/test/java/com/terminal/buffer/CursorTest.java
+++ b/src/test/java/com/terminal/buffer/CursorTest.java
@@ -17,6 +17,7 @@ void setUp() {
         buf = new TerminalBuffer(10, 5, 100);
     }
 
+    // A freshly created buffer must place the cursor at the origin (0, 0).
     @Test
     void initialCursorIsAtOrigin() {
         CursorPosition pos = buf.getCursor();
@@ -24,6 +25,7 @@ void initialCursorIsAtOrigin() {
         assertEquals(0, pos.getRow());
     }
 
+    // setCursor must move the cursor to the exact requested position.
     @Test
     void setCursorMovesToPosition() {
         buf.setCursor(3, 2);
@@ -31,30 +33,35 @@ void setCursorMovesToPosition() {
         assertEquals(2, buf.getCursor().getRow());
     }
 
+    // A negative column must be clamped to 0.
     @Test
     void setCursorClampsNegativeColToZero() {
         buf.setCursor(-5, 0);
         assertEquals(0, buf.getCursor().getCol());
     }
 
+    // A negative row must be clamped to 0.
     @Test
     void setCursorClampsNegativeRowToZero() {
         buf.setCursor(0, -1);
         assertEquals(0, buf.getCursor().getRow());
     }
 
+    // A column beyond the right edge (>= width) must be clamped to width-1.
     @Test
     void setCursorClampsColBeyondWidth() {
         buf.setCursor(10, 0);  // width=10, valid cols 0..9
         assertEquals(9, buf.getCursor().getCol());
     }
 
+    // A row beyond the bottom edge (>= height) must be clamped to height-1.
     @Test
     void setCursorClampsRowBeyondHeight() {
         buf.setCursor(0, 5);  // height=5, valid rows 0..4
         assertEquals(4, buf.getCursor().getRow());
     }
 
+    // moveCursorRight(n) must advance the column by n steps.
     @Test
     void moveCursorRightByN() {
         buf.setCursor(2, 0);
@@ -62,6 +69,7 @@ void moveCursorRightByN() {
         assertEquals(5, buf.getCursor().getCol());
     }
 
+    // moveCursorRight must stop at the rightmost valid column when the step overshoots.
     @Test
     void moveCursorRightClampsAtRightEdge() {
         buf.setCursor(8, 0);
@@ -69,6 +77,7 @@ void moveCursorRightClampsAtRightEdge() {
         assertEquals(9, buf.getCursor().getCol());
     }
 
+    // moveCursorLeft(n) must retreat the column by n steps.
     @Test
     void moveCursorLeftByN() {
         buf.setCursor(7, 0);
@@ -76,6 +85,7 @@ void moveCursorLeftByN() {
         assertEquals(4, buf.getCursor().getCol());
     }
 
+    // moveCursorLeft must stop at column 0 when the step overshoots.
     @Test
     void moveCursorLeftClampsAtLeftEdge() {
         buf.setCursor(2, 0);
@@ -83,6 +93,7 @@ void moveCursorLeftClampsAtLeftEdge() {
         assertEquals(0, buf.getCursor().getCol());
     }
 
+    // moveCursorDown(n) must advance the row by n steps.
     @Test
     void moveCursorDownByN() {
         buf.setCursor(0, 1);
@@ -90,6 +101,7 @@ void moveCursorDownByN() {
         assertEquals(3, buf.getCursor().getRow());
     }
 
+    // moveCursorDown must stop at the bottom row when the step overshoots.
     @Test
     void moveCursorDownClampsAtBottom() {
         buf.setCursor(0, 3);
@@ -97,6 +109,7 @@ void moveCursorDownClampsAtBottom() {
         assertEquals(4, buf.getCursor().getRow());
     }
 
+    // moveCursorUp(n) must retreat the row by n steps.
     @Test
     void moveCursorUpByN() {
         buf.setCursor(0, 4);
@@ -104,6 +117,7 @@ void moveCursorUpByN() {
         assertEquals(2, buf.getCursor().getRow());
     }
 
+    // moveCursorUp must stop at row 0 when the step overshoots.
     @Test
     void moveCursorUpClampsAtTop() {
         buf.setCursor(0, 1);
@@ -111,6 +125,7 @@ void moveCursorUpClampsAtTop() {
         assertEquals(0, buf.getCursor().getRow());
     }
 
+    // Moving by zero in any direction must leave the cursor exactly where it was.
     @Test
     void moveCursorByZeroIsNoOp() {
         buf.setCursor(3, 2);
@@ -122,12 +137,14 @@ void moveCursorByZeroIsNoOp() {
         assertEquals(2, buf.getCursor().getRow());
     }
 
+    // getWidth and getHeight must return the dimensions passed to the constructor.
     @Test
     void bufferExposesWidthAndHeight() {
         assertEquals(10, buf.getWidth());
         assertEquals(5, buf.getHeight());
     }
 
+    // getMaxScrollback must return the limit passed to the constructor.
     @Test
     void bufferExposesMaxScrollback() {
         assertEquals(100, buf.getMaxScrollback());
diff --git a/src/test/java/com/terminal/buffer/FillLineTest.java b/src/test/java/com/terminal/buffer/FillLineTest.java
index 251cdca..609d54a 100644
--- a/src/test/java/com/terminal/buffer/FillLineTest.java
+++ b/src/test/java/com/terminal/buffer/FillLineTest.java
@@ -17,6 +17,7 @@ void setUp() {
         buf = new TerminalBuffer(5, 3, 100);
     }
 
+    // fillLine must overwrite every column of the cursor's row with the given character.
     @Test
     void fillLineFillesEntireCurrentRowWithChar() {
         buf.setCursor(2, 1); // cursor on row 1, col 2
@@ -26,6 +27,7 @@ void fillLineFillesEntireCurrentRowWithChar() {
         }
     }
 
+    // fillLine must only affect the cursor's row; other rows must remain untouched.
     @Test
     void fillLineDoesNotAffectOtherRows() {
         buf.setCursor(0, 1);
@@ -34,6 +36,7 @@ void fillLineDoesNotAffectOtherRows() {
         assertEquals(' ', buf.getChar(0, 2), "row 2 must be untouched");
     }
 
+    // fillLine must stamp the current buffer attributes onto every cell it writes.
     @Test
     void fillLineUsesCurrentAttributes() {
         buf.setForeground(TerminalColor.CYAN);
@@ -42,6 +45,7 @@ void fillLineUsesCurrentAttributes() {
         assertEquals(TerminalColor.CYAN, buf.getAttributesAt(2, 0).getForeground());
     }
 
+    // fillLine must not move the cursor; its position must be the same before and after.
     @Test
     void fillLineLeavsCursorColumnUnchanged() {
         buf.setCursor(3, 0);
@@ -50,6 +54,7 @@ void fillLineLeavsCursorColumnUnchanged() {
         assertEquals(0, buf.getCursor().getRow());
     }
 
+    // fillLine with a space character is equivalent to clearing the entire row.
     @Test
     void fillLineWithSpaceClearsRow() {
         buf.setCursor(0, 0);
diff --git a/src/test/java/com/terminal/buffer/InsertEmptyLineTest.java b/src/test/java/com/terminal/buffer/InsertEmptyLineTest.java
index 4324706..92d500a 100644
--- a/src/test/java/com/terminal/buffer/InsertEmptyLineTest.java
+++ b/src/test/java/com/terminal/buffer/InsertEmptyLineTest.java
@@ -17,6 +17,8 @@ void setUp() {
         buf = new TerminalBuffer(5, 3, 100);
     }
 
+    // insertEmptyLine must shift all existing screen rows up by one, pushing the top row to scrollback,
+    // and place a blank row at the bottom.
     @Test
     void insertEmptyLineShiftsContentUp() {
         buf.setCursor(0, 0);
@@ -34,6 +36,7 @@ void insertEmptyLineShiftsContentUp() {
         assertEquals("", buf.getLine(2));
     }
 
+    // The row that was pushed off the top of the screen must appear as the most recent scrollback line.
     @Test
     void insertEmptyLinePushesTopRowToScrollback() {
         buf.setCursor(0, 0);
@@ -44,6 +47,7 @@ void insertEmptyLinePushesTopRowToScrollback() {
         assertEquals("Hello", buf.getLine(-1));
     }
 
+    // Each call to insertEmptyLine must increase the scrollback size by exactly one.
     @Test
     void scrollbackSizeIncrementsWithEachInsert() {
         for (int i = 0; i < 5; i++) {
@@ -52,6 +56,7 @@ void scrollbackSizeIncrementsWithEachInsert() {
         assertEquals(5, buf.getScrollbackSize());
     }
 
+    // When the scrollback is full, the oldest entry must be evicted to make room for the new one.
     @Test
     void scrollbackEvictsOldestWhenFull() {
         buf = new TerminalBuffer(5, 1, 3); // maxScrollback=3
@@ -74,6 +79,7 @@ void scrollbackEvictsOldestWhenFull() {
         assertEquals("B", buf.getLine(-3));
     }
 
+    // When maxScrollback is 0, the evicted row must be silently discarded.
     @Test
     void insertEmptyLineWithZeroMaxScrollbackDiscardsRow() {
         buf = new TerminalBuffer(5, 2, 0);
@@ -83,6 +89,7 @@ void insertEmptyLineWithZeroMaxScrollbackDiscardsRow() {
         assertEquals(0, buf.getScrollbackSize());
     }
 
+    // The newly inserted bottom row must be blank (empty string after trimming).
     @Test
     void newBottomRowIsBlank() {
         buf.insertEmptyLine();
diff --git a/src/test/java/com/terminal/buffer/InsertTextTest.java b/src/test/java/com/terminal/buffer/InsertTextTest.java
index 740f968..e0db991 100644
--- a/src/test/java/com/terminal/buffer/InsertTextTest.java
+++ b/src/test/java/com/terminal/buffer/InsertTextTest.java
@@ -17,6 +17,7 @@ void setUp() {
         buf = new TerminalBuffer(5, 3, 100);
     }
 
+    // Inserting into an empty row must write the characters starting at the cursor column.
     @Test
     void insertTextAtStartOfEmptyRowWritesChars() {
         buf.setCursor(0, 0);
@@ -25,6 +26,8 @@ void insertTextAtStartOfEmptyRowWritesChars() {
         assertEquals('i', buf.getChar(1, 0));
     }
 
+    // Inserting in the middle of a row must push existing characters to the right;
+    // characters that overflow the row width wrap to the next row.
     @Test
     void insertTextShiftsExistingContentRight() {
         buf.setCursor(0, 0);
@@ -37,6 +40,7 @@ void insertTextShiftsExistingContentRight() {
         assertEquals("DE", buf.getLine(1));
     }
 
+    // Inserting at column 0 must shift every existing character right by one position per inserted char.
     @Test
     void insertTextAtColumnZeroShiftsEntireRow() {
         buf.setCursor(0, 0);
@@ -52,6 +56,7 @@ void insertTextAtColumnZeroShiftsEntireRow() {
         assertEquals("E", buf.getLine(1));
     }
 
+    // When the inserted text fits exactly up to the end of the row, no wrapping must occur.
     @Test
     void insertTextFillsExactlyToEndOfLineNoWrap() {
         buf.setCursor(3, 0);
@@ -61,6 +66,7 @@ void insertTextFillsExactlyToEndOfLineNoWrap() {
         assertEquals("", buf.getLine(1), "no wrap needed, row 1 must be empty");
     }
 
+    // When overflow reaches the last row, the top row must scroll into the scrollback.
     @Test
     void insertTextWrappingAtLastRowCausesScroll() {
         buf = new TerminalBuffer(3, 2, 100);
@@ -76,6 +82,7 @@ void insertTextWrappingAtLastRowCausesScroll() {
         assertEquals(1, buf.getScrollbackSize(), "top row should have scrolled to scrollback");
     }
 
+    // The cursor must advance past all inserted characters; wrapping to the next row if necessary.
     @Test
     void insertTextAdvancesCursorPastInsertedContent() {
         buf.setCursor(0, 0);
@@ -85,6 +92,7 @@ void insertTextAdvancesCursorPastInsertedContent() {
         assertEquals(1, buf.getCursor().getRow());
     }
 
+    // insertText must stamp the current buffer attributes onto every character it writes.
     @Test
     void insertTextUsesCurrentAttributes() {
         buf.setForeground(TerminalColor.GREEN);
@@ -93,6 +101,7 @@ void insertTextUsesCurrentAttributes() {
         assertEquals(TerminalColor.GREEN, buf.getAttributesAt(0, 0).getForeground());
     }
 
+    // Inserting an empty string must be a no-op (cursor and content unchanged).
     @Test
     void insertEmptyStringIsNoOp() {
         buf.setCursor(2, 1);
diff --git a/src/test/java/com/terminal/buffer/ResizeTest.java b/src/test/java/com/terminal/buffer/ResizeTest.java
index 0d085a8..f9b0f87 100644
--- a/src/test/java/com/terminal/buffer/ResizeTest.java
+++ b/src/test/java/com/terminal/buffer/ResizeTest.java
@@ -17,6 +17,7 @@ void setUp() {
         buf = new TerminalBuffer(5, 3, 100);
     }
 
+    // Resizing to the exact current dimensions must leave content and dimensions unchanged.
     @Test
     void resizeToSameDimensionsIsNoOp() {
         buf.setCursor(0, 0);
@@ -27,6 +28,7 @@ void resizeToSameDimensionsIsNoOp() {
         assertEquals(3, buf.getHeight());
     }
 
+    // Increasing the width must pad every row on the right with empty cells.
     @Test
     void resizeWiderPadsRowsWithEmptyCells() {
         buf.setCursor(0, 0);
@@ -36,6 +38,7 @@ void resizeWiderPadsRowsWithEmptyCells() {
         assertEquals("Hi      ", buf.getRawLine(0));
     }
 
+    // Decreasing the width must truncate every row to the new width.
     @Test
     void resizeNarrowerTruncatesRows() {
         buf.setCursor(0, 0);
@@ -45,6 +48,7 @@ void resizeNarrowerTruncatesRows() {
         assertEquals("Hel", buf.getRawLine(0));
     }
 
+    // Increasing the height must append blank rows at the bottom of the screen.
     @Test
     void resizeTallerAddsEmptyRowsAtBottom() {
         buf.resize(5, 5);
@@ -53,6 +57,7 @@ void resizeTallerAddsEmptyRowsAtBottom() {
         assertEquals("", buf.getLine(4));
     }
 
+    // Decreasing the height must push the excess top rows into the scrollback.
     @Test
     void resizeShorterPushesTopRowsToScrollback() {
         buf.setCursor(0, 0);
@@ -71,6 +76,7 @@ void resizeShorterPushesTopRowsToScrollback() {
         assertEquals("CCCCC", buf.getLine(1));
     }
 
+    // After a resize, the cursor must be clamped to stay within the new bounds.
     @Test
     void resizeClampsCursorToNewBounds() {
         buf.setCursor(4, 2);
@@ -79,12 +85,14 @@ void resizeClampsCursorToNewBounds() {
         assertEquals(1, buf.getCursor().getRow(), "cursor row clamped to new height-1");
     }
 
+    // A width of zero or negative must throw IllegalArgumentException.
     @Test
     void resizeWithInvalidWidthThrows() {
         assertThrows(IllegalArgumentException.class, () -> buf.resize(0, 3));
         assertThrows(IllegalArgumentException.class, () -> buf.resize(-1, 3));
     }
 
+    // A height of zero must throw IllegalArgumentException.
     @Test
     void resizeWithInvalidHeightThrows() {
         assertThrows(IllegalArgumentException.class, () -> buf.resize(5, 0));
diff --git a/src/test/java/com/terminal/buffer/RowTest.java b/src/test/java/com/terminal/buffer/RowTest.java
index 4b56330..7de14ea 100644
--- a/src/test/java/com/terminal/buffer/RowTest.java
+++ b/src/test/java/com/terminal/buffer/RowTest.java
@@ -9,6 +9,7 @@
 
 class RowTest {
 
+    // A newly constructed Row must have every cell initialised to Cell.EMPTY.
     @Test
     void newRowIsFilledWithEmptyCells() {
         Row row = new Row(5);
@@ -17,6 +18,7 @@ void newRowIsFilledWithEmptyCells() {
         }
     }
 
+    // setCell followed by getCell must return the stored cell; neighbouring cells must be unaffected.
     @Test
     void setCellAndGetCellRoundTrip() {
         Row row = new Row(5);
@@ -27,6 +29,7 @@ void setCellAndGetCellRoundTrip() {
         assertEquals(Cell.EMPTY, row.getCell(3));
     }
 
+    // fill(cell) must overwrite every column of the row with the given cell.
     @Test
     void fillWithCellFillsAllColumns() {
         Row row = new Row(4);
@@ -37,6 +40,7 @@ void fillWithCellFillsAllColumns() {
         }
     }
 
+    // fill(from, to, cell) must only overwrite the specified range, leaving other columns untouched.
     @Test
     void fillRangeOnlyFillsSpecifiedColumns() {
         Row row = new Row(6);
@@ -50,6 +54,7 @@ void fillRangeOnlyFillsSpecifiedColumns() {
         assertEquals(Cell.EMPTY, row.getCell(5));
     }
 
+    // The copy constructor must produce an independent array; mutating the copy must not affect the original.
     @Test
     void copyConstructorProducesIndependentCopy() {
         Row original = new Row(4);
@@ -62,6 +67,7 @@ void copyConstructorProducesIndependentCopy() {
         assertEquals('B', copy.getCell(1).getCharacter());
     }
 
+    // toContentString must concatenate the character of every cell, including empty (space) cells.
     @Test
     void toContentStringReturnsAllChars() {
         Row row = new Row(5);
@@ -73,6 +79,7 @@ void toContentStringReturnsAllChars() {
         assertEquals("Hello", row.toContentString());
     }
 
+    // toContentString must skip WIDE_RIGHT placeholder cells so a wide character counts as one glyph.
     @Test
     void toContentStringSkipsWidePlaceholderCells() {
         Row row = new Row(4);
@@ -84,6 +91,7 @@ void toContentStringSkipsWidePlaceholderCells() {
         assertEquals("字A ", row.toContentString());
     }
 
+    // getWidth must return the width passed to the constructor.
     @Test
     void getWidthReturnsConstructedWidth() {
         assertEquals(80, new Row(80).getWidth());
diff --git a/src/test/java/com/terminal/buffer/ScrollbackTest.java b/src/test/java/com/terminal/buffer/ScrollbackTest.java
index 5e9df18..6296ba7 100644
--- a/src/test/java/com/terminal/buffer/ScrollbackTest.java
+++ b/src/test/java/com/terminal/buffer/ScrollbackTest.java
@@ -17,6 +17,7 @@ void setUp() {
         buf = new TerminalBuffer(5, 3, 100);
     }
 
+    // Row index -1 must address the most recently pushed scrollback line.
     @Test
     void getLineMinus1ReturnsMostRecentScrollbackLine() {
         buf.setCursor(0, 0);
@@ -25,6 +26,7 @@ void getLineMinus1ReturnsMostRecentScrollbackLine() {
         assertEquals("First", buf.getLine(-1));
     }
 
+    // Scrollback is ordered newest-to-oldest: -1 is the newest, -2 is older, etc.
     @Test
     void scrollbackLinesOrderedOldestToNewest() {
         buf.setCursor(0, 0);
@@ -39,6 +41,7 @@ void scrollbackLinesOrderedOldestToNewest() {
         assertEquals("AAA", buf.getLine(-2));
     }
 
+    // getAllContent must return scrollback lines first, followed by screen lines, all separated by newlines.
     @Test
     void getAllContentReturnScrollbackThenScreen() {
         buf = new TerminalBuffer(3, 2, 100);
@@ -56,6 +59,7 @@ void getAllContentReturnScrollbackThenScreen() {
         assertEquals("   ", lines[2]);
     }
 
+    // Accessing a scrollback row when the scrollback is empty, or a screen row >= height, must throw.
     @Test
     void getLineOutOfBoundsThrowsIllegalArgumentException() {
         assertThrows(IllegalArgumentException.class, () -> buf.getLine(-1),
@@ -64,6 +68,7 @@ void getLineOutOfBoundsThrowsIllegalArgumentException() {
                 "should throw for row >= height");
     }
 
+    // clearScreen must not remove any scrollback lines.
     @Test
     void clearScreenDoesNotAffectScrollback() {
         buf.insertEmptyLine();
@@ -72,6 +77,7 @@ void clearScreenDoesNotAffectScrollback() {
         assertEquals(2, buf.getScrollbackSize());
     }
 
+    // clearAll must remove all scrollback lines and make negative row indices invalid again.
     @Test
     void clearAllResetsScrollbackToZero() {
         buf.insertEmptyLine();
@@ -81,6 +87,7 @@ void clearAllResetsScrollbackToZero() {
         assertThrows(IllegalArgumentException.class, () -> buf.getLine(-1));
     }
 
+    // Cell attributes written before the line was pushed to scrollback must be preserved there.
     @Test
     void scrollbackAttributesArePreserved() {
         buf.setForeground(TerminalColor.RED);
diff --git a/src/test/java/com/terminal/buffer/WideCharTest.java b/src/test/java/com/terminal/buffer/WideCharTest.java
index 0ccb98b..de4b192 100644
--- a/src/test/java/com/terminal/buffer/WideCharTest.java
+++ b/src/test/java/com/terminal/buffer/WideCharTest.java
@@ -17,6 +17,8 @@ void setUp() {
         buf = new TerminalBuffer(8, 4, 100);
     }
 
+    // Writing a CJK character must place a WIDE_LEFT cell at the cursor column
+    // and a WIDE_RIGHT placeholder cell in the next column.
     @Test
     void writingCjkCharOccupiesTwoColumns() {
         buf.setCursor(0, 0);
@@ -27,6 +29,7 @@ void writingCjkCharOccupiesTwoColumns() {
         assertEquals(Cell.CellType.WIDE_RIGHT, buf.getCell(1, 0).getType());
     }
 
+    // After writing a wide character, the cursor must advance by two columns.
     @Test
     void cursorAdvancesTwoAfterWideChar() {
         buf.setCursor(0, 0);
@@ -34,6 +37,7 @@ void cursorAdvancesTwoAfterWideChar() {
         assertEquals(2, buf.getCursor().getCol());
     }
 
+    // getLine must treat a wide character as a single logical character (not two columns).
     @Test
     void getLineTreatsWideCharAsOneCharacter() {
         buf.setCursor(0, 0);
@@ -43,6 +47,8 @@ void getLineTreatsWideCharAsOneCharacter() {
         assertTrue(line.startsWith("字A"), "line should start with wide char then A, got: " + line);
     }
 
+    // A wide character that would start at the last column must not be written
+    // because there is no room for its right half; the column must remain empty.
     @Test
     void wideCharAtLastColumnIsTruncated() {
         // width=8; position wide char at col 7 (last) — no room for both halves
@@ -53,6 +59,8 @@ void wideCharAtLastColumnIsTruncated() {
         assertEquals(' ', buf.getChar(7, 0), "wide char at last col should not be written");
     }
 
+    // Writing a new character over the WIDE_LEFT cell of an existing wide character
+    // must also clear the corresponding WIDE_RIGHT placeholder.
     @Test
     void writingOverWideLeftClearsBothHalves() {
         buf.setCursor(0, 0);
@@ -65,6 +73,7 @@ void writingOverWideLeftClearsBothHalves() {
         assertEquals(Cell.CellType.NORMAL, buf.getCell(1, 0).getType());
     }
 
+    // Writing a new character over the WIDE_RIGHT placeholder must also clear the WIDE_LEFT cell.
     @Test
     void writingOverWideRightClearsBothHalves() {
         buf.setCursor(0, 0);
@@ -75,6 +84,7 @@ void writingOverWideRightClearsBothHalves() {
         assertEquals('B', buf.getChar(1, 0));
     }
 
+    // Consecutive wide characters must each occupy two columns in sequence.
     @Test
     void multipleWideCharsWrittenSequentially() {
         buf.setCursor(0, 0);
@@ -86,6 +96,7 @@ void multipleWideCharsWrittenSequentially() {
         assertEquals(4, buf.getCursor().getCol());
     }
 
+    // Narrow and wide characters can be mixed freely; the cursor advances by 1 or 2 accordingly.
     @Test
     void mixedNarrowAndWideChars() {
         buf.setCursor(0, 0);
diff --git a/src/test/java/com/terminal/buffer/WriteTextTest.java b/src/test/java/com/terminal/buffer/WriteTextTest.java
index 5c40921..c74d833 100644
--- a/src/test/java/com/terminal/buffer/WriteTextTest.java
+++ b/src/test/java/com/terminal/buffer/WriteTextTest.java
@@ -17,6 +17,7 @@ void setUp() {
         buf = new TerminalBuffer(10, 5, 100);
     }
 
+    // writeText must place each character at the cursor position and advance the cursor by one per character.
     @Test
     void writeTextPlacesCharsAtCursorAndAdvancesCursor() {
         buf.setCursor(0, 0);
@@ -30,6 +31,7 @@ void writeTextPlacesCharsAtCursorAndAdvancesCursor() {
         assertEquals(0, buf.getCursor().getRow());
     }
 
+    // writeText must overwrite whatever was already in the cells (no shifting).
     @Test
     void writeTextOverwritesExistingContent() {
         buf.setCursor(0, 0);
@@ -43,6 +45,7 @@ void writeTextOverwritesExistingContent() {
         assertEquals('o', buf.getChar(4, 0));
     }
 
+    // Every character written must carry the buffer's current attribute state at the time of writing.
     @Test
     void writeTextStoresCurrentAttributes() {
         buf.setForeground(TerminalColor.RED);
@@ -54,6 +57,7 @@ void writeTextStoresCurrentAttributes() {
         assertTrue(attrs.hasStyle(TextStyle.BOLD));
     }
 
+    // Writing on a non-zero row must not affect any other row.
     @Test
     void writeTextOnNonZeroRow() {
         buf.setCursor(0, 2);
@@ -63,6 +67,7 @@ void writeTextOnNonZeroRow() {
         assertEquals(' ', buf.getChar(0, 0), "other rows must be untouched");
     }
 
+    // Writing an empty string must be a no-op (cursor and content unchanged).
     @Test
     void writeEmptyStringIsNoOp() {
         buf.setCursor(3, 1);
@@ -71,6 +76,7 @@ void writeEmptyStringIsNoOp() {
         assertEquals(1, buf.getCursor().getRow());
     }
 
+    // Passing null must be treated the same as an empty string (no-op).
     @Test
     void writeTextNullIsNoOp() {
         buf.setCursor(3, 1);
@@ -78,6 +84,8 @@ void writeTextNullIsNoOp() {
         assertEquals(3, buf.getCursor().getCol());
     }
 
+    // Writing past the last column must fill up to the edge and leave the cursor at the last column
+    // in a "pending wrap" state (wrap deferred until the next character is written).
     @Test
     void writeTextTruncatesAtRightEdgeWithPendingWrap() {
         // width=10; cursor at col 8, write "AB"
@@ -89,6 +97,7 @@ void writeTextTruncatesAtRightEdgeWithPendingWrap() {
         assertEquals(9, buf.getCursor().getCol());
     }
 
+    // After a pending wrap, the next writeText call must first wrap to the next row before writing.
     @Test
     void pendingWrapCausesNextWriteToWrapToNextLine() {
         buf.setCursor(9, 0); // last col
@@ -100,6 +109,7 @@ void pendingWrapCausesNextWriteToWrapToNextLine() {
         assertEquals(1, buf.getCursor().getRow());
     }
 
+    // When a pending wrap fires on the last row, the buffer must scroll (insert an empty line).
     @Test
     void pendingWrapAtLastRowScrolls() {
         buf = new TerminalBuffer(5, 2, 100);
@@ -111,6 +121,7 @@ void pendingWrapAtLastRowScrolls() {
         assertEquals(1, buf.getScrollbackSize());
     }
 
+    // An explicit setCursor call must cancel any pending wrap state.
     @Test
     void setCursorClearsPendingWrap() {
         buf.setCursor(9, 0);
@@ -121,6 +132,7 @@ void setCursorClearsPendingWrap() {
         assertEquals(0, buf.getCursor().getRow());
     }
 
+    // Writing at the start of a non-first row must not affect rows above it.
     @Test
     void writeTextOnStartOfNonFirstRow() {
         buf.setCursor(0, 2);

From 83651901f427db8fa2ffd1bb9310db8f225d2b15 Mon Sep 17 00:00:00 2001
From: igarbayo <ignacio.garbayo@rai.usc.es>
Date: Tue, 17 Mar 2026 13:55:15 +0100
Subject: [PATCH 08/15] docs: rewrite governance and contributing files
 following OSS best practices

---
 CODE_OF_CONDUCT.md | 141 ++++++++++++++++++++++++++++++++++++++-------
 CONTRIBUTING.md    |  92 ++++++++++++++++++++++++-----
 GOVERNANCE.md      |  84 ++++++++++++++++++++++-----
 README.md          |  97 +++++++++++++++++++++++++++++++
 SECURITY.md        |  50 ++++++++++++----
 5 files changed, 404 insertions(+), 60 deletions(-)

diff --git a/CODE_OF_CONDUCT.md b/CODE_OF_CONDUCT.md
index b3d7299..3adca20 100644
--- a/CODE_OF_CONDUCT.md
+++ b/CODE_OF_CONDUCT.md
@@ -2,41 +2,142 @@
 
 ## Our Pledge
 
-We are committed to making participation in this project a welcoming and
-respectful experience for everyone, regardless of background or experience level.
+We as members, contributors, and maintainers pledge to make participation in
+this project and community a harassment-free experience for everyone, regardless
+of age, body size, visible or invisible disability, ethnicity, sex
+characteristics, gender identity and expression, level of experience, education,
+socio-economic status, nationality, personal appearance, race, caste, colour,
+religion, or sexual identity and orientation.
 
-## Expected Behaviour
+We pledge to act and interact in ways that contribute to an open, welcoming,
+diverse, inclusive, and healthy community.
 
-- Be kind and respectful in all interactions.
-- Give and accept constructive feedback graciously.
-- Focus on what is best for the project and the community.
-- Show empathy towards other contributors.
+---
 
-## Unacceptable Behaviour
+## Our Standards
 
-- Harassment, insults, or derogatory comments of any kind.
-- Trolling or deliberately disruptive behaviour.
-- Publishing others' private information without consent.
+Examples of behaviour that contributes to a positive environment:
 
-## Enforcement
+- Demonstrating empathy and kindness toward other people
+- Being respectful of differing opinions, viewpoints, and experiences
+- Giving and gracefully accepting constructive feedback
+- Accepting responsibility and apologising to those affected by our mistakes,
+  and learning from the experience
+- Focusing on what is best not just for us as individuals, but for the overall
+  community
 
-Instances of unacceptable behaviour may be reported to the project maintainer
-at **ignacio.garbayo@rai.usc.es**. All reports will be reviewed and
-investigated promptly and fairly.
+Examples of unacceptable behaviour:
+
+- The use of sexualised language or imagery, and sexual attention or advances of
+  any kind
+- Trolling, insulting or derogatory comments, and personal or political attacks
+- Public or private harassment
+- Publishing others' private information, such as a physical or electronic
+  address, without their explicit permission
+- Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+---
+
+## Enforcement Responsibilities
+
+The project maintainer is responsible for clarifying and enforcing these
+standards and will take appropriate and fair corrective action in response to
+any behaviour that is deemed inappropriate, threatening, offensive, or harmful.
 
 The maintainer has the right and responsibility to remove, edit, or reject
-comments, commits, and other contributions that do not align with this Code
-of Conduct.
+comments, commits, code, wiki edits, issues, and other contributions that are
+not aligned with this Code of Conduct, and will communicate reasons for
+moderation decisions when appropriate.
+
+---
 
 ## Scope
 
-This Code of Conduct applies in all project spaces — issues, pull requests,
-discussions — and when an individual is representing the project publicly.
+This Code of Conduct applies within all project spaces — GitHub Issues, Pull
+Requests, Discussions, and email — and also applies when an individual is
+officially representing the project in public spaces.
+
+---
+
+## Reporting
+
+Instances of abusive, harassing, or otherwise unacceptable behaviour may be
+reported to the project maintainer at:
+
+**ignacio.garbayo@rai.usc.es**
+
+Please use the subject line `[COC] terminal-text-buffer — <brief description>`.
+
+**Do not report conduct issues in public GitHub issues.** All reports will be
+handled privately.
+
+The maintainer will acknowledge receipt of your report within **72 hours** and
+will keep you informed of the outcome.
+
+All reports will be reviewed and investigated promptly and fairly. The
+maintainer is obligated to maintain confidentiality with regard to the reporter
+of an incident.
+
+---
+
+## Enforcement Guidelines
+
+The maintainer will follow these guidelines to determine the consequences for
+any action deemed in violation of this Code of Conduct:
+
+### 1. Correction
+
+**Community impact:** Use of inappropriate language or other behaviour deemed
+unprofessional or unwelcome.
+
+**Consequence:** A private written warning explaining the nature of the
+violation and why the behaviour was inappropriate. A public apology may be
+requested.
+
+### 2. Warning
+
+**Community impact:** A violation through a single incident or series of
+actions.
+
+**Consequence:** A warning with consequences for continued behaviour. No
+interaction with the people involved, including unsolicited interaction with
+those enforcing the Code of Conduct, for a specified period of time. This
+includes avoiding interactions in community spaces as well as external channels
+like social media. Violating these terms may lead to a temporary or permanent
+ban.
+
+### 3. Temporary Ban
+
+**Community impact:** A serious violation of community standards, including
+sustained inappropriate behaviour.
+
+**Consequence:** A temporary ban from any sort of interaction or public
+communication with the project for a specified period of time. No public or
+private interaction with the people involved, including unsolicited interaction
+with those enforcing the Code of Conduct, is allowed during this period.
+Violating these terms may lead to a permanent ban.
+
+### 4. Permanent Ban
+
+**Community impact:** Demonstrating a pattern of violation of community
+standards, including sustained inappropriate behaviour, harassment of an
+individual, or aggression toward or disparagement of classes of individuals.
+
+**Consequence:** A permanent ban from any sort of public interaction within the
+project community.
+
+---
 
 ## Attribution
 
 This Code of Conduct is adapted from the
-[Contributor Covenant](https://www.contributor-covenant.org/), version 2.1.
+[Contributor Covenant](https://www.contributor-covenant.org/), version 2.1,
+available at
+https://www.contributor-covenant.org/version/2/1/code_of_conduct.html.
+
+Community Impact Guidelines were inspired by
+[Mozilla's code of conduct enforcement ladder](https://github.com/mozilla/diversity).
 
 <!-- SPDX-FileCopyrightText: 2026 Ignacio Garbayo Fernández <ignacio.garbayo@rai.usc.es> -->
 <!-- SPDX-License-Identifier: MIT -->
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 94a05bc..7b0d5b6 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -1,8 +1,9 @@
 # Contributing to Terminal Text Buffer
 
-First of all — thank you for taking the time to read this and for your interest
-in the project. Whether you are here out of curiosity, to report a bug, or to
-propose a change, it genuinely means a lot.
+Thank you so much for taking the time to read this. It genuinely means a lot.
+Terminal Text Buffer is a small project born from a Jetbrains coding challenge,
+and the fact that you are here considering contributing to it is something we do
+not take for granted.
 
 ---
 
@@ -57,41 +58,85 @@ Open an issue using the **Feature Request** template. Describe:
 
 ## How to contribute code
 
-### 1. Fork and set up
+### 1. Set up your development environment
+
+**Prerequisites:**
+
+- **JDK 11 or later.** Make sure `java -version` and `javac -version` both
+  report the same JDK (not a JRE).
+- **Git** (any recent version).
+- No other tools required — the Gradle wrapper (`gradlew`) is bundled.
+
+**Steps:**
 
 ```bash
-git clone https://github.com/igarbayo/terminal-text-buffer.git
+# 1. Fork the repository on GitHub, then clone your fork
+git clone https://github.com/<your-username>/terminal-text-buffer.git
 cd terminal-text-buffer
-./gradlew test   # make sure everything passes before you start
+
+# 2. Verify the build passes before making any changes
+./gradlew test
+
+# The HTML test report is at build/reports/tests/test/index.html
 ```
 
+> **Windows note:** if Gradle complains about `tools.jar`, set
+> `org.gradle.java.home` in `gradle.properties` to your JDK directory
+> (not a JRE). See [README — Troubleshooting](README.md#troubleshooting).
+
 ### 2. Create a feature branch from `develop`
 
 ```bash
 git checkout develop
-git checkout -b feature/your-feature-name
+git checkout -b feature/your-descriptive-name
 ```
 
 Never branch from `master`. Never commit directly to `master` or `develop`.
 
 ### 3. Write your code
 
-- Follow the existing code style (no formatter config yet, just be consistent).
-- Write tests first if possible — this project was built with TDD.
-- Add SPDX headers to any new file you create:
+#### Code style
+
+This project uses the **Allman brace style** with **4-space indentation**
+(no tabs).
+
+```java
+// Allman style — opening brace on its own line
+if (condition)
+{
+    doSomething();
+}
+else
+{
+    doSomethingElse();
+}
+```
+
+- Keep lines under 120 characters where possible.
+- Prefer `final` for local variables and parameters that are not reassigned.
+- Write tests first (this project was built with TDD — see the development
+  process in the README).
+- Add SPDX license headers to any new source file you create:
 
 ```java
 // SPDX-FileCopyrightText: <YEAR> <Your Name> <your@email.com>
 // SPDX-License-Identifier: MIT
 ```
 
+For non-source files (Markdown, YAML, etc.) use an HTML or `#`-style comment
+as appropriate, or create a `.license` sidecar file.
+
 ### 4. Commit with Conventional Commits
 
 All commit messages must follow the
 [Conventional Commits](https://www.conventionalcommits.org/) format:
 
 ```
-<type>: <short description in present tense, lowercase>
+<type>(<optional scope>): <short description in present tense, lowercase>
+
+<optional body — explain why, not what>
+
+<optional footer — issue references, BREAKING CHANGE>
 ```
 
 Valid types:
@@ -100,10 +145,14 @@ Valid types:
 |---|---|
 | `feat` | A new feature or behaviour |
 | `fix` | A bug fix |
+| `refactor` | Code change with no feature or fix |
+| `perf` | Performance improvement (special case of `refactor`) |
+| `style` | Whitespace, formatting — no behaviour change |
 | `test` | Adding or fixing tests |
 | `docs` | Documentation only |
-| `refactor` | Code change with no feature or fix |
-| `chore` | Tooling, dependencies, build |
+| `build` | Build tools, dependencies, project version |
+| `ops` | CI/CD, infrastructure, deployment scripts |
+| `chore` | Initial commit, `.gitignore`, other housekeeping |
 
 **Examples:**
 
@@ -112,6 +161,7 @@ feat: add SGR escape sequence parser
 fix: correct cursor clamping when width is 1
 test: add scrollback eviction edge case
 docs: clarify wide character limitations in README
+perf: replace ArrayDeque with circular buffer for O(1) scrollback access
 chore: bump JUnit to 5.11.0
 ```
 
@@ -129,6 +179,19 @@ instead of -1.
 - Fill in the PR template completely.
 - The PR title must itself be a valid Conventional Commit message.
 - CI must be green (build + tests + REUSE compliance).
+- At least one maintainer approval is required before merging.
+
+---
+
+## Definition of done
+
+A contribution is considered complete when all of the following are true:
+
+- [ ] `./gradlew test` passes locally with no failures or errors
+- [ ] New or changed source files have SPDX license headers
+- [ ] New public behaviour is covered by at least one test
+- [ ] Documentation is updated if the change affects behaviour or the API
+- [ ] The PR title and all commit messages follow the Conventional Commits format
 
 ---
 
@@ -136,7 +199,8 @@ instead of -1.
 
 The maintainer signs all commits with a PGP key. You are not required to sign
 your commits, but it is encouraged. If you do, please include your public key
-fingerprint in the PR description.
+fingerprint in the PR description. See [docs/GPG_KEY.md](docs/GPG_KEY.md) for
+setup instructions.
 
 ---
 
diff --git a/GOVERNANCE.md b/GOVERNANCE.md
index 1bd948f..583cbf4 100644
--- a/GOVERNANCE.md
+++ b/GOVERNANCE.md
@@ -7,29 +7,80 @@ no release schedule, and no commitment to any particular feature or timeline.
 
 ---
 
-## Maintainer
+## Contact
 
-| Name | Email | Role |
-|---|---|---|
-| Ignacio Garbayo Fernández | ignacio.garbayo@rai.usc.es | Sole maintainer |
-
-This is a single-maintainer project. All decisions about direction, merges,
-and releases are made by the maintainer. There is no steering committee,
-no vote, and no formal RFC process.
+| Name | Email | GitHub | Role |
+|---|---|---|---|
+| Ignacio Garbayo Fernández | ignacio.garbayo@rai.usc.es | @igarbayo | Sole maintainer |
 
-For questions, open an issue or send an email with subject
+For questions or discussions, open an issue or send an email with subject
 `[terminal-text-buffer] your topic`.
 
 ---
 
+## Roles
+
+**Maintainer** — currently Ignacio Garbayo Fernández. The maintainer:
+
+- Reviews and merges pull requests
+- Manages releases and version tags
+- Enforces the Code of Conduct
+- Makes final decisions on technical direction
+- Signs commits and release tags with a PGP key
+
+There is no steering committee and no formal RFC process.
+
+---
+
 ## Decision making
 
-The maintainer has final say on all technical and community decisions. Proposals
-are welcome via issues or pull requests and will be considered seriously, but
-there is no obligation to implement them or to respond within any given time.
+### Routine decisions
+
+The maintainer can act alone on routine matters without prior discussion:
+
+- Bug fixes and correctness improvements
+- Documentation updates
+- CI/CD configuration changes
+- Dependency version bumps (within the same major version)
+- Code style and refactoring
+
+### Significant decisions
+
+The following decisions require the maintainer to document the rationale in
+[docs/ARCHITECTURE_DECISIONS.md](docs/ARCHITECTURE_DECISIONS.md) before or
+alongside the change:
+
+- Adding a new external dependency
+- Breaking changes to the public API
+- Releasing a new major version
+- Changing the license or REUSE compliance strategy
+- Changing the branch protection rules or CI requirements
+
+This is a single-maintainer project, so there is no second-approval requirement.
+The documentation requirement serves as a public record and forces deliberate
+thinking before significant changes.
+
+### Adding new maintainers
+
+New maintainers are added at the current maintainer's discretion, when the
+project genuinely needs it. Any new maintainer must agree to the Code of
+Conduct and the governance rules in this document.
+
+### Response times
+
+Response times are **best-effort** — expect weeks or months. This is a student
+project competing with coursework and exams.
+
+---
+
+## Conflict resolution
+
+Community members are encouraged to raise concerns via issues. If a contributor
+disagrees with a decision, they are welcome to discuss it openly in the issue
+tracker. The maintainer commits to explaining decisions transparently.
 
-Response times are **best-effort** — expect weeks or months. This is a
-student project competing with coursework and exams.
+In the case of conduct violations, the process described in
+[CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md) takes precedence.
 
 ---
 
@@ -83,14 +134,15 @@ Versioning follows [Semantic Versioning](https://semver.org/):
 ## Commit signing
 
 All commits from the maintainer are signed with a PGP key. Contributors are
-encouraged (but not required) to sign their commits.
+encouraged (but not required) to sign their commits. See
+[docs/GPG_KEY.md](docs/GPG_KEY.md) for setup instructions.
 
 ---
 
 ## Amendments
 
 This document may be updated by the maintainer at any time. Significant changes
-will be noted in the commit message and changelog.
+to governance will be noted in the commit message.
 
 <!-- SPDX-FileCopyrightText: 2026 Ignacio Garbayo Fernández <ignacio.garbayo@rai.usc.es> -->
 <!-- SPDX-License-Identifier: MIT -->
diff --git a/README.md b/README.md
index 22fad24..d2b81b8 100644
--- a/README.md
+++ b/README.md
@@ -127,8 +127,105 @@ Colors: `DEFAULT RED GREEN YELLOW BLUE MAGENTA CYAN WHITE BLACK` and `BRIGHT_*`
 
 ---
 
+## Compatibility
+
+Tested on every combination in CI:
+
+| Java version | Ubuntu | Windows |
+|---|---|---|
+| 11 | Passing | Passing |
+| 17 | Passing | Passing |
+| 21 | Passing | Passing |
+
+Wide character support (CJK + emoji) is verified by the automated test suite on
+all platforms. Interactive display of wide characters requires a Unicode-aware
+terminal — see [Known Limitations](#known-limitations).
+
+---
+
+## Troubleshooting
+
+### `Could not find tools.jar` on Windows
+
+Gradle is picking up a JRE instead of a JDK. Set `org.gradle.java.home` in
+`gradle.properties` to point to a JDK directory (the one that contains `bin/javac`):
+
+```properties
+org.gradle.java.home=C:\\Program Files\\Java\\jdk1.8.0_261
+```
+
+Or set `JAVA_HOME` in your terminal before running Gradle:
+
+```powershell
+$env:JAVA_HOME = "C:\Program Files\Java\jdk1.8.0_261"
+./gradlew test
+```
+
+### Wide characters display as `?` in Windows PowerShell / CMD
+
+PowerShell and CMD do not forward CJK ideographs or many emoji to the JVM — they
+replace them with `?` before the Java process ever receives the input. This is an
+OS-level limitation. The library itself handles wide characters correctly (verified
+by the automated test suite). To test interactively, use:
+
+- **IntelliJ IDEA's built-in terminal**
+- **Windows Terminal** with `chcp 65001` (UTF-8 code page)
+
+### Build succeeds but tests are reported as `UP-TO-DATE` without running
+
+Gradle cached the last run. Force a fresh run with:
+
+```bash
+./gradlew cleanTest test
+```
+
+### `UnsupportedClassVersionError` at runtime
+
+The class was compiled with a newer JDK than the one running it. Make sure the
+JDK used to build (`JAVA_HOME`) and the JDK used to run are the same version, or
+at least that the runtime is at least Java 8.
+
+---
+
 ## Architecture & Design
 
+```
+                    ┌────────────────────────────────────────────────┐
+                    │              TerminalBuffer (public API)         │
+                    │                                                  │
+                    │  cursor: CursorPosition                          │
+                    │  attrs:  CellAttributes  (fg, bg, styles)        │
+                    │                                                  │
+                    │  ┌──────────────────────┐  ┌──────────────────┐ │
+                    │  │      Screen          │  │    Scrollback    │ │
+                    │  │  Row[height]         │  │  ArrayDeque<Row> │ │
+                    │  │  (mutable, editable) │  │  (read-only;     │ │
+                    │  │                      │  │   max size cap)  │ │
+                    │  │  row 0 = top line    │  │  -1 = newest     │ │
+                    │  │  row h-1 = bottom    │  │  -n = oldest     │ │
+                    │  └──────────────────────┘  └──────────────────┘ │
+                    │           │                          │            │
+                    │           └──────────┬───────────────┘            │
+                    │                      │                            │
+                    │               Row  ──┤ Cell[]  (fixed width)      │
+                    │                      │                            │
+                    │               Cell ──┤ char + CellAttributes      │
+                    │                      │ + CellType                 │
+                    │                      │ (NORMAL/WIDE_LEFT/         │
+                    │                      │  WIDE_RIGHT)               │
+                    └──────────────────────┴────────────────────────────┘
+
+  CellAttributes = TerminalColor (fg) + TerminalColor (bg) + EnumSet<TextStyle>
+  TerminalColor  = DEFAULT | BLACK | RED | GREEN | YELLOW | BLUE |
+                   MAGENTA | CYAN | WHITE | BRIGHT_* variants (17 total)
+  TextStyle      = BOLD | ITALIC | UNDERLINE
+```
+
+When `insertEmptyLine()` is called (or the cursor reaches the bottom), the top
+screen row is snapshotted (copy-constructor) and pushed to the back of the
+scrollback deque. If the deque is at capacity the oldest entry is evicted from
+the front.
+
 ### Class Overview
 
 ```
diff --git a/SECURITY.md b/SECURITY.md
index 2d45382..02ee26f 100644
--- a/SECURITY.md
+++ b/SECURITY.md
@@ -3,9 +3,10 @@
 ## Academic project notice
 
 This is an academic project with no production deployment and no commercial use.
-It is not subject to the mandatory requirements of the EU Cyber Resilience Act
-(CRA). However, this project voluntarily adopts CRA-aligned security practices
-as a matter of good hygiene.
+Under the EU Cyber Resilience Act (CRA), non-commercial free and open-source
+software is exempt from the mandatory requirements that apply to commercial
+manufacturers. This project voluntarily adopts CRA-aligned security practices
+anyway — not because it is required, but because it is the right thing to do.
 
 ---
 
@@ -21,20 +22,45 @@ long-term support versions.
 
 ---
 
+## Known limitations
+
+These are known, accepted limitations — not bugs to report:
+
+- **Wide character rendering in Windows PowerShell / CMD:** PowerShell and CMD
+  replace CJK ideographs and many emoji with `?` before the characters reach
+  the JVM. The library handles wide characters correctly (verified by the
+  automated test suite), but interactive testing from those terminals is not
+  possible. Use IntelliJ's built-in terminal or Windows Terminal with
+  `chcp 65001`.
+
+- **Supplementary-plane emoji (U+1F300 and above):** `Cell` stores characters
+  as `char` (a UTF-16 code unit). Code points above U+FFFF are detected
+  correctly but stored with loss of the high surrogate. This is a known
+  trade-off documented in the README.
+
+- **No input validation at network or process boundaries:** This is an
+  in-process data structure library. It does not handle untrusted external
+  input and does not perform sanitization. Callers are responsible for
+  validating input before passing it to the buffer.
+
+- **Scrollback access is O(n):** Random access by index iterates the internal
+  `ArrayDeque`. This is a performance characteristic, not a security issue.
+
+---
+
 ## Scope
 
 ### In scope
 
 - Memory safety issues in buffer operations (e.g. `resize`, `insertText`)
 - Incorrect data isolation between screen and scrollback (e.g. mutation of
-  scrollback rows after push)
+  scrollback rows after they are pushed off-screen)
 - Logic errors that could cause data loss or silent corruption of buffer state
 
 ### Out of scope
 
-- Wide character rendering in Windows PowerShell / CMD (known OS-level
-  limitation, not a library bug — see README)
-- Performance issues that do not affect correctness
+- Wide character rendering in Windows PowerShell / CMD (see Known Limitations)
+- Performance issues that do not affect correctness or data safety
 - Theoretical vulnerabilities with no realistic attack vector given the
   library's use case (in-process data structure, no network, no I/O)
 
@@ -72,10 +98,14 @@ Send an email to **ignacio.garbayo@rai.usc.es** with:
 
 | Stage | Target time |
 |---|---|
-| Acknowledgement | 7 days |
-| Initial assessment | 30 days |
+| Acknowledgement | 72 hours |
+| Initial assessment | 14 days |
 | Fix or mitigation | Best-effort (academic project, no SLA) |
 
+These timelines are targets, not guarantees. This is a student project — exams
+and coursework take priority. If you do not hear back within 72 hours, a
+follow-up email is welcome.
+
 ---
 
 ## Disclosure policy
@@ -87,7 +117,7 @@ This project follows **coordinated disclosure**:
 3. A fixed version is released.
 4. The vulnerability is disclosed publicly, with credit to the reporter if desired.
 
-Public disclosure should not happen before 90 days from the initial report,
+Public disclosure should not happen before **90 days** from the initial report,
 unless both parties agree otherwise.
 
 ---

From 58d449a76ab599d37203c36883808f0646e54012 Mon Sep 17 00:00:00 2001
From: igarbayo <ignacio.garbayo@rai.usc.es>
Date: Tue, 17 Mar 2026 13:55:21 +0100
Subject: [PATCH 09/15] docs: add COMPONENTS_LICENSE, GPG_KEY,
 ARCHITECTURE_DECISIONS and DCO

---
 DCO                            |  34 +++++++
 docs/ARCHITECTURE_DECISIONS.md | 157 +++++++++++++++++++++++++++++++
 docs/COMPONENTS_LICENSE.md     | 105 +++++++++++++++++++++
 docs/GPG_KEY.md                | 165 +++++++++++++++++++++++++++++++++
 4 files changed, 461 insertions(+)
 create mode 100644 DCO
 create mode 100644 docs/ARCHITECTURE_DECISIONS.md
 create mode 100644 docs/COMPONENTS_LICENSE.md
 create mode 100644 docs/GPG_KEY.md

diff --git a/DCO b/DCO
new file mode 100644
index 0000000..49b8cb0
--- /dev/null
+++ b/DCO
@@ -0,0 +1,34 @@
+Developer Certificate of Origin
+Version 1.1
+
+Copyright (C) 2004, 2006 The Linux Foundation and its contributors.
+
+Everyone is permitted to copy and distribute verbatim copies of this
+license document, but changing it is not allowed.
+
+
+Developer's Certificate of Origin 1.1
+
+By making a contribution to this project, I certify that:
+
+(a) The contribution was created in whole or in part by me and I
+    have the right to submit it under the open source license
+    indicated in the file; or
+
+(b) The contribution is based upon previous work that, to the best
+    of my knowledge, is covered under an appropriate open source
+    license and I have the right under that license to submit that
+    work with modifications, whether created in whole or in part
+    by me, under the same open source license (unless I am
+    permitted to submit under a different license), as indicated
+    in the file; or
+
+(c) The contribution was provided directly to me by some other
+    person who certified (a), (b) or (c) and I have not modified
+    it.
+
+(d) I understand and agree that this project and the contribution
+    are public and that a record of the contribution (including all
+    personal information I submit with it, including my sign-off) is
+    maintained indefinitely and may be redistributed consistent with
+    this project or the open source license(s) involved.
diff --git a/docs/ARCHITECTURE_DECISIONS.md b/docs/ARCHITECTURE_DECISIONS.md
new file mode 100644
index 0000000..6ebf742
--- /dev/null
+++ b/docs/ARCHITECTURE_DECISIONS.md
@@ -0,0 +1,157 @@
+# Architecture Decisions
+
+This document records the significant decisions made during the development of
+Terminal Text Buffer — the trade-offs considered, the options rejected, and the
+reasons behind the choices that were made. It is a living document: new entries
+are added as decisions are taken.
+
+The goal is not to justify every line of code, but to give future contributors
+(and future-me) enough context to understand *why* things are the way they are.
+
+---
+
+## ADR-001: Language and build tool
+
+**Decision:** Java with Gradle.
+
+**Context:** The project was specified as a Jetbrains coding challenge with Java
+as the required language. Gradle was chosen over Maven because it is the default
+build tool in the IntelliJ/Jetbrains ecosystem and produces a more concise build
+file for a project of this scope.
+
+**Consequences:** The Gradle wrapper (`gradlew`) is committed to the repository
+so that anyone can build without installing Gradle separately. The wrapper is
+licensed under Apache-2.0 (see [COMPONENTS_LICENSE.md](COMPONENTS_LICENSE.md)).
+
+---
+
+## ADR-002: No external runtime dependencies
+
+**Decision:** The compiled library has zero runtime dependencies beyond the
+Java standard library.
+
+**Context:** This is a data structure library. Pulling in external libraries
+for a self-contained data structure would add complexity and licensing
+considerations with no benefit.
+
+**Consequences:** The library can be dropped into any Java project without
+dependency conflicts.
+
+---
+
+## ADR-003: Test framework — JUnit 5
+
+**Decision:** JUnit Jupiter (JUnit 5) for all tests.
+
+**Context:** JUnit 5 is the current standard for Java testing. It is available
+as a Gradle test dependency and does not affect the runtime artefact.
+
+**Consequences:** EPL-2.0 licence (JUnit's licence) applies to the test code at
+build time. It does not affect the MIT-licensed library artefact.
+
+---
+
+## ADR-004: Cell immutability, Row mutability
+
+**Decision:** `Cell` and `CellAttributes` are immutable value objects. `Row` is
+mutable.
+
+**Context:** Two competing concerns:
+- **Safety:** Scrollback rows must not change after they are pushed off-screen.
+- **Performance:** Writing one character should not create a new row array.
+
+**Chosen trade-off:** `Row` is mutable (O(1) writes), but when a row is pushed
+to scrollback a snapshot is taken via a copy constructor (`new Row(original)`).
+`Cell.EMPTY` is shared as a singleton — safe because `Cell` is immutable.
+
+**Rejected alternative:** Making `Row` immutable would require copying the
+entire row array on every character write — O(width) per character.
+
+---
+
+## ADR-005: Scrollback storage — ArrayDeque
+
+**Decision:** `ArrayDeque<Row>` for scrollback, with the front being the oldest
+entry and the back the newest.
+
+**Context:** Scrollback needs O(1) push (when a row scrolls off the screen) and
+O(1) eviction (when the scrollback is full). Random access by index was not
+initially a performance concern.
+
+**Trade-off:** Push and eviction are O(1). Random access by index is O(n). For
+a 10 000-line scrollback this is measurable but acceptable for the expected use
+cases.
+
+**Known improvement:** Replacing `ArrayDeque` with a fixed-size `Row[]` circular
+buffer would give O(1) random access at the cost of a more complex
+implementation. See Potential Improvements in the README.
+
+---
+
+## ADR-006: Coordinate system — signed integer for row
+
+**Decision:** Screen rows use indices `[0, height-1]`. Scrollback rows use
+negative indices: `-1` is the most recently scrolled-off line, `-scrollbackSize`
+is the oldest.
+
+**Context:** All content-access methods (`getChar`, `getLine`, `getAttributes`)
+need to address both screen and scrollback. Options:
+1. Separate method signatures for screen and scrollback.
+2. A wrapper type (enum tag + index).
+3. A single signed integer (negative = scrollback).
+
+**Chosen trade-off:** Option 3. It makes the unified `resolveRow(int row)` method
+the single gateway, keeps method signatures simple, and is intuitive once
+documented.
+
+**Rejected alternative:** Separate methods would double the API surface. A
+wrapper type would require callers to construct it on every access.
+
+---
+
+## ADR-007: Wide character support — placeholder cell strategy
+
+**Decision:** A wide glyph at column `c` occupies two cells: `cells[c]` holds
+the character with type `WIDE_LEFT`, and `cells[c+1]` stores `'\0'` with type
+`WIDE_RIGHT`. `WIDE_RIGHT` cells are skipped in string rendering.
+
+**Context:** This is the same strategy used by xterm, VTE, and most real
+terminal emulators. The alternatives were:
+1. Store wide chars in a separate side-channel structure.
+2. Use `char[]` pairs (surrogate-style) within a single cell.
+
+**Chosen trade-off:** The placeholder strategy integrates naturally with the
+existing fixed-width `Row` model. Writing over either half of a wide pair
+automatically clears both halves.
+
+**Known limitation:** Characters above U+FFFF (supplementary-plane emoji) are
+detected correctly but stored as `(char) codePoint`, losing the high surrogate.
+Changing `Cell.character` from `char` to `int` would fix this without breaking
+the public API.
+
+---
+
+## ADR-008: writeText — pending wrap flag
+
+**Decision:** When the last character is written to column `width-1`, the cursor
+stays there and an internal `pendingWrap` flag is set. The next `writeText` call
+resolves the wrap first.
+
+**Context:** This matches xterm's behaviour. The alternative (advancing the
+cursor immediately) would place the cursor out of bounds at column `width`.
+
+**Consequence:** The cursor stays in-bounds at all times. The wrap is deferred
+until the next write, which allows the end-of-line position to be read without
+immediately triggering a scroll.
+
+---
+
+## ADR-009: MIT licence
+
+**Decision:** MIT.
+
+**Rationale:** See [COMPONENTS_LICENSE.md](COMPONENTS_LICENSE.md) for the full
+justification.
+
+<!-- SPDX-FileCopyrightText: 2026 Ignacio Garbayo Fernández <ignacio.garbayo@rai.usc.es> -->
+<!-- SPDX-License-Identifier: MIT -->
diff --git a/docs/COMPONENTS_LICENSE.md b/docs/COMPONENTS_LICENSE.md
new file mode 100644
index 0000000..ad917c7
--- /dev/null
+++ b/docs/COMPONENTS_LICENSE.md
@@ -0,0 +1,105 @@
+# Components and Licensing
+
+This document explains why this project uses the MIT License, what licences
+its dependencies carry, and whether all of those licences are compatible with
+each other. The goal is to let any reader — developer, legal team, or curious
+student — understand the full licensing picture at a glance.
+
+---
+
+## Project license: MIT
+
+This project is released under the **MIT License** (SPDX: `MIT`). The full
+text is in [LICENSE](../LICENSE) and [LICENSES/MIT.txt](../LICENSES/MIT.txt).
+
+### Why MIT?
+
+MIT was chosen because:
+
+1. **Maximum freedom for readers and adopters.** This project exists to be
+   studied, adapted, and reused — for learning, for building terminal
+   emulators, or for any other purpose. MIT places essentially no restrictions
+   on any of that.
+
+2. **Academic context.** This is a coding-challenge project, not a commercial
+   product. There is no business reason to restrict use.
+
+3. **Compatibility.** MIT is compatible with virtually every other open-source
+   licence, including Apache-2.0 (used by the Gradle wrapper) and EPL-2.0
+   (used by JUnit 5). A more restrictive licence (GPL, AGPL) would create
+   compatibility problems for anyone wanting to link this library into a
+   larger project.
+
+4. **No-warranty clause.** Like all OSI-approved licences, MIT explicitly
+   disclaims warranties. This is standard practice for open-source software.
+
+### What MIT allows and requires
+
+Anyone who receives this software may use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies — for any purpose, including
+commercial — as long as they:
+
+- Include the original copyright notice and the MIT licence text in any
+  substantial copy or distribution of the software.
+
+That is the only obligation. There is no copyleft requirement, no
+network-use clause, and no patent retaliation clause.
+
+---
+
+## Dependency licence audit
+
+### Runtime dependencies
+
+This library has **no runtime dependencies**. The compiled JAR depends only
+on the Java standard library (which is part of the JDK/JRE and is not
+redistributed by this project).
+
+### Test dependencies
+
+| Dependency | Version | Licence (SPDX) | Compatibility with MIT |
+|---|---|---|---|
+| JUnit Jupiter (JUnit 5) | 5.x | `EPL-2.0` | Compatible — EPL-2.0 is a weak copyleft licence. It requires that modifications to EPL-licensed files be shared back under EPL, but it does not "infect" MIT-licensed code that merely calls JUnit as a test framework. JUnit is used only during testing and is never bundled into the distributed artefact. |
+
+### Build tool
+
+| Component | Licence (SPDX) | Notes |
+|---|---|---|
+| Gradle wrapper (`gradlew`, `gradlew.bat`, `gradle/wrapper/`) | `Apache-2.0` | Included in the repository as a convenience. Apache-2.0 is a permissive licence fully compatible with MIT. REUSE metadata for these files is in [.reuse/dep5](../.reuse/dep5). |
+
+---
+
+## REUSE compliance
+
+This project follows the [REUSE Specification](https://reuse.software/)
+version 3.3. Every file in the repository has a corresponding licence
+declaration, either through:
+
+- An **SPDX header comment** in the file itself (all source and documentation
+  files authored by this project), or
+- The [.reuse/dep5](../.reuse/dep5) file (third-party files that cannot be
+  modified, such as the Gradle wrapper).
+
+Licence texts for every SPDX identifier used in this project are stored in
+the [LICENSES/](../LICENSES/) directory:
+
+| File | SPDX identifier |
+|---|---|
+| `LICENSES/MIT.txt` | `MIT` |
+| `LICENSES/Apache-2.0.txt` | `Apache-2.0` |
+
+---
+
+## No warranty
+
+As stated in the MIT License:
+
+> THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+> IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+> FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+
+This is standard for open-source software. Users and adopters are responsible
+for evaluating the suitability of this software for their own use case.
+
+<!-- SPDX-FileCopyrightText: 2026 Ignacio Garbayo Fernández <ignacio.garbayo@rai.usc.es> -->
+<!-- SPDX-License-Identifier: MIT -->
diff --git a/docs/GPG_KEY.md b/docs/GPG_KEY.md
new file mode 100644
index 0000000..18e8c93
--- /dev/null
+++ b/docs/GPG_KEY.md
@@ -0,0 +1,165 @@
+# GPG Commit Signing
+
+This document explains how to set up GPG signing for your Git commits, how to
+verify that a commit is signed, and how to configure GitHub to require signed
+commits on protected branches.
+
+All commits from this project's maintainer are signed. Contributors are
+encouraged (but not required) to sign their commits as well.
+
+---
+
+## Why sign commits?
+
+A GPG signature on a commit proves that the commit was made by the person who
+holds the corresponding private key — not just someone who knows the committer's
+name and email. Without signatures, anyone who gains access to a repository can
+push commits that impersonate another author.
+
+GitHub displays a green **Verified** badge on signed commits.
+
+---
+
+## Step 1: Generate a GPG key
+
+If you do not already have a GPG key, generate one:
+
+```bash
+gpg --full-generate-key
+```
+
+When prompted:
+
+- **Key type:** `RSA and RSA` (default) or `ED25519` (recommended — shorter and faster)
+- **Key size:** `4096` bits (for RSA)
+- **Expiration:** Choose an expiration date (e.g. `2y` for 2 years) — an
+  expiring key is safer than one that never expires
+- **Name and email:** Use the same email you use for your GitHub account
+
+### List your keys
+
+```bash
+gpg --list-secret-keys --keyid-format=long
+```
+
+Example output:
+
+```
+sec   rsa4096/3AA5C34371567BD2 2024-01-01 [SC]
+      ABCDEF0123456789ABCDEF0123456789ABCDEF01
+uid   [ultimate] Your Name <your@email.com>
+ssb   rsa4096/4BB6D45482678CE3 2024-01-01 [E]
+```
+
+The key ID is the part after the slash on the `sec` line: `3AA5C34371567BD2`.
+
+---
+
+## Step 2: Tell Git to use your key
+
+```bash
+git config --global user.signingkey 3AA5C34371567BD2
+git config --global commit.gpgsign true
+git config --global tag.gpgsign true
+```
+
+From now on, every commit and tag you create will be signed automatically.
+
+> **Windows users:** If you get `error: gpg failed to sign the data`, Git may
+> not be finding the right `gpg` binary. Set it explicitly:
+>
+> ```bash
+> git config --global gpg.program "C:/Program Files (x86)/GnuPG/bin/gpg.exe"
+> ```
+> Adjust the path to match your GnuPG installation.
+
+---
+
+## Step 3: Add your public key to GitHub
+
+Export your public key in ASCII-armored format:
+
+```bash
+gpg --armor --export 3AA5C34371567BD2
+```
+
+Copy the entire output (including the `-----BEGIN PGP PUBLIC KEY BLOCK-----`
+and `-----END PGP PUBLIC KEY BLOCK-----` lines).
+
+Then in GitHub:
+
+1. Go to **Settings → SSH and GPG keys**
+2. Click **New GPG key**
+3. Paste the exported key
+4. Click **Add GPG key**
+
+GitHub will now show a **Verified** badge on your signed commits.
+
+---
+
+## Step 4: Verify a signed commit
+
+To check the signature on any commit:
+
+```bash
+git log --show-signature -1
+```
+
+Example output for a valid signature:
+
+```
+commit abc123def456...
+gpg: Signature made Mon 17 Mar 2026 12:00:00 UTC
+gpg:                using RSA key 3AA5C34371567BD2
+gpg: Good signature from "Your Name <your@email.com>" [ultimate]
+```
+
+A `Good signature` message confirms the commit is authentic.
+
+---
+
+## Step 5 (optional): Require signed commits on protected branches
+
+To enforce signing for all contributions to `master` and `develop`:
+
+1. Go to the repository on GitHub
+2. **Settings → Branches → Branch protection rules**
+3. Edit the rule for `master` (and separately for `develop`)
+4. Enable **Require signed commits**
+5. Save changes
+
+With this setting, GitHub will reject any push or pull request merge that
+includes unsigned commits on those branches.
+
+---
+
+## Troubleshooting
+
+### `error: gpg failed to sign the data`
+
+Make sure the GPG key's email matches the email in your Git config:
+
+```bash
+git config user.email        # should match the GPG key's UID
+gpg --list-secret-keys --keyid-format=long
+```
+
+Also check that `gpg-agent` is running:
+
+```bash
+gpgconf --launch gpg-agent
+```
+
+### `There is no assurance this key belongs to the named user`
+
+Your key's trust level is not set to `ultimate`. Set it:
+
+```bash
+gpg --edit-key 3AA5C34371567BD2
+> trust
+> 5   (ultimate)
+> quit
+```
+
+<!-- SPDX-FileCopyrightText: 2026 Ignacio Garbayo Fernández <ignacio.garbayo@rai.usc.es> -->
+<!-- SPDX-License-Identifier: MIT -->

From aa76273b9df864c3005d2b76fcace3c34e94d93d Mon Sep 17 00:00:00 2001
From: igarbayo <ignacio.garbayo@rai.usc.es>
Date: Tue, 17 Mar 2026 13:55:21 +0100
Subject: [PATCH 10/15] ops: add permissions read-all to CI, pin checkout
 action SHA, add question template

---
 .github/ISSUE_TEMPLATE/config.yml  |  4 +++
 .github/ISSUE_TEMPLATE/question.md | 41 ++++++++++++++++++++++++++++++
 .github/workflows/ci.yml           | 14 ++++++----
 3 files changed, 54 insertions(+), 5 deletions(-)
 create mode 100644 .github/ISSUE_TEMPLATE/question.md

diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml
index 7078930..4bc8785 100644
--- a/.github/ISSUE_TEMPLATE/config.yml
+++ b/.github/ISSUE_TEMPLATE/config.yml
@@ -9,3 +9,7 @@ contact_links:
     about: >
       Do NOT open a public issue for security vulnerabilities.
       Please follow the responsible disclosure process described in SECURITY.md.
+  - name: General question or usage help
+    url: https://github.com/igarbayo/terminal-text-buffer/issues/new?template=question.md
+    about: >
+      Ask a question about how to use the library or understand its behaviour.
diff --git a/.github/ISSUE_TEMPLATE/question.md b/.github/ISSUE_TEMPLATE/question.md
new file mode 100644
index 0000000..4cd9497
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/question.md
@@ -0,0 +1,41 @@
+---
+name: Question
+about: Ask a question about how to use the library or understand its behaviour
+title: '[QUESTION] '
+labels: question
+assignees: ''
+
+---
+
+<!-- SPDX-FileCopyrightText: 2026 Ignacio Garbayo Fernández <ignacio.garbayo@rai.usc.es> -->
+<!-- SPDX-License-Identifier: MIT -->
+
+## What are you trying to do?
+
+<!-- Describe what you want to accomplish. For example:
+     "I want to read back the colour of a character I just wrote."
+-->
+
+## What have you tried?
+
+<!-- Show the code or commands you have already tried, and what result you got.
+     For example:
+     ```java
+     TerminalBuffer buf = new TerminalBuffer(80, 24, 500);
+     buf.setForeground(TerminalColor.RED);
+     buf.writeText("Hello");
+     CellAttributes attrs = buf.getAttributes(0, 0);
+     // I expected RED but got DEFAULT
+     System.out.println(attrs.getForeground()); // prints DEFAULT
+     ```
+-->
+
+## Environment
+
+- **OS:** <!-- e.g. Ubuntu 22.04, Windows 11 -->
+- **Java version:** <!-- output of `java -version` -->
+- **How are you running the library?** <!-- e.g. REPL, unit test, own application -->
+
+## Additional context
+
+<!-- Anything else that might help answer the question. -->
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 60b3b15..a3506b1 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -9,6 +9,10 @@ on:
   pull_request:
     branches: [ master, develop ]
 
+# Minimum permissions by default. Jobs that need more declare it explicitly.
+permissions:
+  contents: read
+
 jobs:
   build:
     name: Build and test (Java ${{ matrix.java }}, ${{ matrix.os }})
@@ -20,10 +24,10 @@ jobs:
 
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v4
+        uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
 
       - name: Set up Java ${{ matrix.java }}
-        uses: actions/setup-java@v4
+        uses: actions/setup-java@v4 # TODO: pin to SHA
         with:
           java-version: ${{ matrix.java }}
           distribution: temurin
@@ -34,7 +38,7 @@ jobs:
 
       - name: Upload test report
         if: failure()
-        uses: actions/upload-artifact@v4
+        uses: actions/upload-artifact@v4 # TODO: pin to SHA
         with:
           name: test-report-java-${{ matrix.java }}
           path: build/reports/tests/test/
@@ -45,7 +49,7 @@ jobs:
 
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v4
+        uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
 
       - name: Check REUSE compliance
-        uses: fsfe/reuse-action@v4
+        uses: fsfe/reuse-action@v4 # TODO: pin to SHA

From 2bb01ace136fa0d1ad86d271241fb99e39ced2c9 Mon Sep 17 00:00:00 2001
From: igarbayo <ignacio.garbayo@rai.usc.es>
Date: Tue, 17 Mar 2026 13:55:23 +0100
Subject: [PATCH 11/15] chore: update dep5 to cover new docs files and DCO

---
 .reuse/dep5 | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/.reuse/dep5 b/.reuse/dep5
index 9975b04..01029b5 100644
--- a/.reuse/dep5
+++ b/.reuse/dep5
@@ -14,6 +14,11 @@ Copyright: 2026 Ignacio Garbayo Fernandez <ignacio.garbayo@rai.usc.es>
 License: MIT
 
 # Documentation — authored by the project maintainer
-Files: README.md docs/manual-testing-guide.md
+Files: README.md docs/manual-testing-guide.md docs/COMPONENTS_LICENSE.md docs/GPG_KEY.md docs/ARCHITECTURE_DECISIONS.md
 Copyright: 2026 Ignacio Garbayo Fernandez <ignacio.garbayo@rai.usc.es>
 License: MIT
+
+# Root governance files — authored by the project maintainer
+Files: DCO
+Copyright: The Linux Foundation and its contributors
+License: MIT

From 6782ac651b74a202af4a905759d92fc393dd45e0 Mon Sep 17 00:00:00 2001
From: igarbayo <ignacio.garbayo@rai.usc.es>
Date: Tue, 17 Mar 2026 14:24:22 +0100
Subject: [PATCH 12/15] docs: add governance and security files to dep5

---
 .reuse/dep5 | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.reuse/dep5 b/.reuse/dep5
index 01029b5..180ba39 100644
--- a/.reuse/dep5
+++ b/.reuse/dep5
@@ -13,8 +13,8 @@ Files: gradle.properties .gitignore settings.gradle
 Copyright: 2026 Ignacio Garbayo Fernandez <ignacio.garbayo@rai.usc.es>
 License: MIT
 
-# Documentation — authored by the project maintainer
-Files: README.md docs/manual-testing-guide.md docs/COMPONENTS_LICENSE.md docs/GPG_KEY.md docs/ARCHITECTURE_DECISIONS.md
+# Documentation and governance files — authored by the project maintainer
+Files: README.md CODE_OF_CONDUCT.md GOVERNANCE.md SECURITY.md docs/manual-testing-guide.md docs/COMPONENTS_LICENSE.md docs/GPG_KEY.md docs/ARCHITECTURE_DECISIONS.md
 Copyright: 2026 Ignacio Garbayo Fernandez <ignacio.garbayo@rai.usc.es>
 License: MIT
 

From cd14db56e56f0cca2f0cfeaa5117df38e2d5b434 Mon Sep 17 00:00:00 2001
From: igarbayo <ignacio.garbayo@rai.usc.es>
Date: Wed, 18 Mar 2026 01:51:18 +0100
Subject: [PATCH 13/15] Translate REPL output and help menu to English

---
 build.gradle                                |   1 +
 src/main/java/com/terminal/buffer/Main.java | 106 ++++++++++++--------
 2 files changed, 67 insertions(+), 40 deletions(-)

diff --git a/build.gradle b/build.gradle
index 040aea8..f401f89 100644
--- a/build.gradle
+++ b/build.gradle
@@ -12,6 +12,7 @@ application {
 
 run {
     standardInput = System.in
+    jvmArgs '-Duser.language=en', '-Duser.country=US'
 }
 
 group = 'com.terminal'
diff --git a/src/main/java/com/terminal/buffer/Main.java b/src/main/java/com/terminal/buffer/Main.java
index 3685b20..85d21d3 100644
--- a/src/main/java/com/terminal/buffer/Main.java
+++ b/src/main/java/com/terminal/buffer/Main.java
@@ -38,36 +38,43 @@ private static boolean handleCommand(String line) {
         try {
             // Main REPL command dispatcher.
             switch (cmd) {
+                // Overwrite text at the current cursor position, advancing it.
                 case "write":
-                    if (arg.isEmpty()) { err("write <texto>"); return false; }
+                    if (arg.isEmpty()) { err("write <text>"); return false; }
                     buf.writeText(arg);
                     return true;
 
+                // Insert text at the cursor, pushing existing content to the right.
                 case "insert":
-                    if (arg.isEmpty()) { err("insert <texto>"); return false; }
+                    if (arg.isEmpty()) { err("insert <text>"); return false; }
                     buf.insertText(arg);
                     return true;
 
+                // Fill the current line with a repeated character (default: space).
                 case "fill": {
                     char ch = arg.isEmpty() ? ' ' : arg.charAt(0);
                     buf.fillLine(ch);
                     return true;
                 }
 
+                // Scroll the top screen row into scrollback and add a blank line at the bottom.
                 case "newline":
                     buf.insertEmptyLine();
                     return true;
 
+                // Blank every cell on screen and place the cursor at (0, 0).
                 case "clear":
                     buf.clearScreen();
                     buf.setCursor(0, 0);
                     return true;
 
+                // Blank screen and discard the entire scrollback history.
                 case "clearall":
                     buf.clearAll();
                     buf.setCursor(0, 0);
                     return true;
 
+                // Move cursor to an absolute (col, row) position.
                 case "cursor": {
                     String[] xy = arg.split(" ");
                     if (xy.length < 2) { err("cursor <col> <row>"); return false; }
@@ -75,6 +82,7 @@ private static boolean handleCommand(String line) {
                     return true;
                 }
 
+                // Move the cursor N steps in a cardinal direction (default N = 1).
                 case "move": {
                     String[] mv = arg.split(" ");
                     String dir = mv[0].toLowerCase();
@@ -89,16 +97,19 @@ private static boolean handleCommand(String line) {
                     return true;
                 }
 
+                // Change the foreground (text) color for subsequent writes.
                 case "fg":
                     if (arg.isEmpty()) { err("fg <COLOR>"); return false; }
                     buf.setForeground(TerminalColor.valueOf(arg.toUpperCase()));
                     return true;
 
+                // Change the background color for subsequent writes.
                 case "bg":
                     if (arg.isEmpty()) { err("bg <COLOR>"); return false; }
                     buf.setBackground(TerminalColor.valueOf(arg.toUpperCase()));
                     return true;
 
+                // Enable individual text style flags.
                 case "bold":
                     buf.addStyle(TextStyle.BOLD);
                     return true;
@@ -111,15 +122,18 @@ private static boolean handleCommand(String line) {
                     buf.addStyle(TextStyle.UNDERLINE);
                     return true;
 
+                // Remove a single style flag while leaving others intact.
                 case "nostyle":
                     if (arg.isEmpty()) { err("nostyle BOLD|ITALIC|UNDERLINE"); return false; }
                     buf.removeStyle(TextStyle.valueOf(arg.toUpperCase()));
                     return true;
 
+                // Reset fg, bg, and all style flags back to their defaults.
                 case "reset":
                     buf.resetAttributes();
                     return true;
 
+                // Resize the screen; content is preserved where possible.
                 case "resize": {
                     String[] wh = arg.split(" ");
                     if (wh.length < 2) { err("resize <w> <h>"); return false; }
@@ -127,19 +141,23 @@ private static boolean handleCommand(String line) {
                     return true;
                 }
 
+                // Force a repaint without changing buffer contents.
                 case "print":
                     return true;
 
+                // Dump the scrollback history to stdout (does not repaint).
                 case "scrollback":
                     printScrollback();
                     return false;
 
+                // Print a compact snapshot of dimensions, cursor, and active attributes.
                 case "info":
                     printInfo();
                     return false;
 
+                // Show each Unicode codepoint in the given string — useful for debugging wide chars.
                 case "codepoints":
-                    if (arg.isEmpty()) { err("codepoints <texto>"); return false; }
+                    if (arg.isEmpty()) { err("codepoints <text>"); return false; }
                     for (int i = 0; i < arg.length(); ) {
                         int cp = arg.codePointAt(i);
                         System.out.printf("  U+%04X  isWide=%-5b  char=%s%n",
@@ -150,18 +168,20 @@ private static boolean handleCommand(String line) {
                     System.out.flush();
                     return false;
 
+                // Reprint the command reference table.
                 case "help":
                     printHelp();
                     return false;
 
+                // Terminate the REPL process.
                 case "exit":
                 case "quit":
-                    System.out.println("Hasta luego.");
+                    System.out.println("Goodbye.");
                     System.exit(0);
                     return false;
 
                 default:
-                    err("Comando desconocido: '" + cmd + "'. Escribe 'help' para ver los comandos.");
+                    err("Unknown command: '" + cmd + "'. Type 'help' to see available commands.");
                     return false;
             }
         } catch (IllegalArgumentException e) {
@@ -176,6 +196,7 @@ private static boolean handleCommand(String line) {
 
     private static void printBuffer() {
         int w = buf.getWidth();
+        // Build box-drawing borders sized to the current buffer width.
         String top    = "\u250c" + repeat("\u2500", w) + "\u2510";
         String bottom = "\u2514" + repeat("\u2500", w) + "\u2518";
 
@@ -194,26 +215,29 @@ private static void printBuffer() {
                     prev = attrs;
                 }
                 boolean isCursor = (col == cur.getCol() && row == cur.getRow());
-                char ch = cell.getCharacter();
+                int ch = cell.getCodePoint();
                 // Highlight cursor position; use a visible block for blank cells.
                 if (isCursor) {
-                    sb.append(ch == ' ' || ch == '\0' ? '\u258c' : ch);
+                    sb.appendCodePoint(ch == ' ' || ch == 0 ? '\u258c' : ch);
                 } else {
-                    sb.append(ch == '\0' ? ' ' : ch);
+                    // WIDE_RIGHT placeholder cells store codepoint 0 — render as space.
+                    sb.appendCodePoint(ch == 0 ? ' ' : ch);
                 }
             }
+            // Reset ANSI attributes at the end of each row to avoid bleed.
             sb.append("\033[0m\u2502");
             System.out.println(sb);
         }
         System.out.println(bottom);
 
+        // Status line: cursor position, active attributes, and scrollback depth.
         CellAttributes attrs = buf.getAttributes();
         Set<TextStyle> styles = attrs.getStyles();
-        System.out.printf("Cursor: (%d, %d)  fg=%-14s bg=%-14s estilos=[%s%s]  Scrollback: %d lineas%n",
+        System.out.printf("Cursor: (%d, %d)  fg=%-14s bg=%-14s styles=[%s%s]  Scrollback: %d lines%n",
                 cur.getCol(), cur.getRow(),
                 attrs.getForeground(),
                 attrs.getBackground(),
-                styles.isEmpty() ? "ninguno" : "",
+                styles.isEmpty() ? "none" : "",
                 styles.isEmpty() ? "" : styleList(styles),
                 buf.getScrollbackSize());
         System.out.print("> ");
@@ -235,15 +259,17 @@ private static String styleList(Set<TextStyle> styles) {
 
     private static void printScrollback() {
         int size = buf.getScrollbackSize();
-        // Print scrollback history from oldest to newest.
+        // Nothing to show if the scrollback is still empty.
         if (size == 0) {
-            System.out.println("--- Scrollback vacio ---");
+            System.out.println("--- Scrollback empty ---");
             System.out.print("> ");
             System.out.flush();
             return;
         }
-        System.out.println("--- Scrollback (" + size + " lineas, mas antigua primero) ---");
+        // Iterate from -size (oldest) to -1 (most recent), matching the signed-index convention.
+        System.out.println("--- Scrollback (" + size + " lines, oldest first) ---");
         for (int i = -size; i <= -1; i++) {
+            // getLine trims trailing spaces, keeping output readable.
             String content = buf.getLine(i);
             System.out.printf("[%3d] %s%n", i, content);
         }
@@ -259,13 +285,13 @@ private static void printInfo() {
         CursorPosition cur = buf.getCursor();
         CellAttributes attrs = buf.getAttributes();
         // Print a compact runtime snapshot of buffer, cursor, and active attributes.
-        System.out.println("Dimensiones : " + buf.getWidth() + " x " + buf.getHeight());
-        System.out.println("Scrollback  : " + buf.getScrollbackSize() + " / " + buf.getMaxScrollback() + " lineas");
+        System.out.println("Dimensions  : " + buf.getWidth() + " x " + buf.getHeight());
+        System.out.println("Scrollback  : " + buf.getScrollbackSize() + " / " + buf.getMaxScrollback() + " lines");
         System.out.println("Cursor      : col=" + cur.getCol() + " row=" + cur.getRow());
         System.out.println("Foreground  : " + attrs.getForeground());
         System.out.println("Background  : " + attrs.getBackground());
         Set<TextStyle> styles = attrs.getStyles();
-        System.out.println("Estilos     : " + (styles.isEmpty() ? "ninguno" : styleList(styles)));
+        System.out.println("Styles      : " + (styles.isEmpty() ? "none" : styleList(styles)));
         System.out.print("> ");
         System.out.flush();
     }
@@ -279,36 +305,36 @@ private static void printHelp() {
         System.out.println("╔══════════════════════════════════════════════════════╗");
         System.out.println("║          Terminal Text Buffer — REPL                 ║");
         System.out.println("╠══════════════════════════════════════════════════════╣");
-        System.out.println("║ Escritura                                            ║");
-        System.out.println("║   write <texto>              Escribe en posicion     ║");
-        System.out.println("║   insert <texto>             Inserta (hace shift)    ║");
-        System.out.println("║   fill [char]                Rellena la linea actual ║");
-        System.out.println("║   newline                    Inserta linea vacia     ║");
+        System.out.println("║ Writing                                              ║");
+        System.out.println("║   write <text>               Write at cursor pos     ║");
+        System.out.println("║   insert <text>              Insert (shifts content) ║");
+        System.out.println("║   fill [char]                Fill current line       ║");
+        System.out.println("║   newline                    Insert empty line       ║");
         System.out.println("╠══════════════════════════════════════════════════════╣");
         System.out.println("║ Cursor                                               ║");
-        System.out.println("║   cursor <col> <row>         Mueve el cursor         ║");
-        System.out.println("║   move up|down|left|right [n]  Mueve N posiciones    ║");
+        System.out.println("║   cursor <col> <row>         Move cursor             ║");
+        System.out.println("║   move up|down|left|right [n]  Move N positions      ║");
         System.out.println("╠══════════════════════════════════════════════════════╣");
-        System.out.println("║ Atributos                                            ║");
-        System.out.println("║   fg <COLOR>                 Color de texto          ║");
-        System.out.println("║   bg <COLOR>                 Color de fondo          ║");
-        System.out.println("║   bold | italic | underline  Activa estilo           ║");
-        System.out.println("║   nostyle BOLD|ITALIC|UNDERLINE  Desactiva estilo    ║");
-        System.out.println("║   reset                      Resetea atributos       ║");
-        System.out.println("║ Colores: DEFAULT RED GREEN YELLOW BLUE MAGENTA       ║");
-        System.out.println("║          CYAN WHITE BLACK  (y BRIGHT_* variantes)    ║");
+        System.out.println("║ Attributes                                           ║");
+        System.out.println("║   fg <COLOR>                 Text color              ║");
+        System.out.println("║   bg <COLOR>                 Background color        ║");
+        System.out.println("║   bold | italic | underline  Enable style            ║");
+        System.out.println("║   nostyle BOLD|ITALIC|UNDERLINE  Disable style       ║");
+        System.out.println("║   reset                      Reset attributes        ║");
+        System.out.println("║ Colors: DEFAULT RED GREEN YELLOW BLUE MAGENTA        ║");
+        System.out.println("║         CYAN WHITE BLACK  (and BRIGHT_* variants)    ║");
         System.out.println("╠══════════════════════════════════════════════════════╣");
-        System.out.println("║ Pantalla                                             ║");
-        System.out.println("║   clear                      Limpia la pantalla      ║");
-        System.out.println("║   clearall                   Limpia pantalla+scrollb ║");
-        System.out.println("║   resize <w> <h>             Redimensiona el buffer  ║");
+        System.out.println("║ Screen                                               ║");
+        System.out.println("║   clear                      Clear the screen        ║");
+        System.out.println("║   clearall                   Clear screen+scrollback ║");
+        System.out.println("║   resize <w> <h>             Resize the buffer       ║");
         System.out.println("╠══════════════════════════════════════════════════════╣");
         System.out.println("║ Info                                                 ║");
-        System.out.println("║   print                      Repinta el buffer       ║");
-        System.out.println("║   scrollback                 Muestra el scrollback   ║");
-        System.out.println("║   info                       Estado actual           ║");
-        System.out.println("║   help                       Muestra esta ayuda      ║");
-        System.out.println("║   exit / quit                Salir                   ║");
+        System.out.println("║   print                      Repaint buffer          ║");
+        System.out.println("║   scrollback                 Show scrollback         ║");
+        System.out.println("║   info                       Current state           ║");
+        System.out.println("║   help                       Show this help          ║");
+        System.out.println("║   exit / quit                Exit                    ║");
         System.out.println("╚══════════════════════════════════════════════════════╝");
     }
 

From b9910542770974099d084952e9bef6ba51f477dc Mon Sep 17 00:00:00 2001
From: igarbayo <ignacio.garbayo@rai.usc.es>
Date: Wed, 18 Mar 2026 01:52:14 +0100
Subject: [PATCH 14/15] docs: translate MANUAL_TESTING_GUIDE examples to
 English, rename file

---
 README.md                                     |  69 ++++-----
 docs/ARCHITECTURE_DECISIONS.md                |  41 +++---
 docs/COMPONENTS_LICENSE.md                    |  26 ++--
 ...sting-guide.md => MANUAL_TESTING_GUIDE.md} |  38 ++---
 images/image-1.png                            | Bin 0 -> 19122 bytes
 images/image.png                              | Bin 0 -> 96881 bytes
 src/main/java/com/terminal/buffer/Cell.java   |  20 +--
 src/main/java/com/terminal/buffer/Row.java    |   2 +-
 .../com/terminal/buffer/TerminalBuffer.java   | 133 +++++++++++-------
 .../java/com/terminal/buffer/CellTest.java    |  13 +-
 .../java/com/terminal/buffer/RowTest.java     |   4 +-
 .../com/terminal/buffer/WideCharTest.java     |  16 +++
 12 files changed, 206 insertions(+), 156 deletions(-)
 rename docs/{manual-testing-guide.md => MANUAL_TESTING_GUIDE.md} (90%)
 create mode 100644 images/image-1.png
 create mode 100644 images/image.png

diff --git a/README.md b/README.md
index d2b81b8..640d9c8 100644
--- a/README.md
+++ b/README.md
@@ -6,6 +6,9 @@
 > A terminal text buffer implementation in Java — the core data structure used by
 > terminal emulators to store, edit, and render text output.
 
+![alt text](images/image.png)
+![alt text](images/image-1.png)
+
 ---
 
 ## What is this?
@@ -36,15 +39,6 @@ Be aware of these before you use it:
   but cannot be tested interactively from those terminals. Use IntelliJ's
   built-in terminal or Windows Terminal with `chcp 65001`.
 
-- **Scrollback access is O(n):** `resolveRow()` iterates an `ArrayDeque` to
-  find a scrollback row by index. For large scrollback sizes this is linear.
-  See [Architecture & Design](#architecture--design) for the recommended fix.
-
-- **Supplementary-plane emoji (U+1F300+):** The `Cell` class stores characters
-  as `char` (UTF-16 code unit). Codepoints above U+FFFF are detected correctly
-  via `codePointAt` but stored as `(char) codePoint`, losing the high surrogate.
-  Changing `Cell.character` to `int` would fix this.
-
 ---
 
 ## Quick Start
@@ -94,11 +88,11 @@ char   ch     = buf.getChar(0, 0); // 'H'
 A command-line REPL lets you poke at the buffer manually:
 
 ```bash
-./gradlew run --console=plain -q
+./gradlew run
 ```
 
 Type `help` at the prompt to see all commands, or consult the
-[manual testing guide](docs/manual-testing-guide.md) for a full walkthrough
+[manual testing guide](docs/MANUAL_TESTING_GUIDE.md) for a full walkthrough
 with expected output.
 
 | Command | What it does |
@@ -190,20 +184,20 @@ at least that the runtime is at least Java 8.
 ## Architecture & Design
 
 ```
-                    ┌────────────────────────────────────────────────┐
-                    │              TerminalBuffer (public API)         │
-                    │                                                  │
-                    │  cursor: CursorPosition                          │
-                    │  attrs:  CellAttributes  (fg, bg, styles)        │
-                    │                                                  │
-                    │  ┌──────────────────────┐  ┌──────────────────┐ │
-                    │  │      Screen          │  │    Scrollback    │ │
-                    │  │  Row[height]         │  │  ArrayDeque<Row> │ │
-                    │  │  (mutable, editable) │  │  (read-only;     │ │
-                    │  │                      │  │   max size cap)  │ │
-                    │  │  row 0 = top line    │  │  -1 = newest     │ │
-                    │  │  row h-1 = bottom    │  │  -n = oldest     │ │
-                    │  └──────────────────────┘  └──────────────────┘ │
+                    ┌───────────────────────────────────────────────────┐
+                    │              TerminalBuffer (public API)          │
+                    │                                                   │
+                    │  cursor: CursorPosition                           │
+                    │  attrs:  CellAttributes  (fg, bg, styles)         │
+                    │                                                   │
+                    │  ┌──────────────────────┐  ┌──────────────────┐   │
+                    │  │      Screen          │  │    Scrollback    │   │
+                    │  │  Row[height]         │  │  Row[] circular  │   │
+                    │  │  (mutable, editable) │  │  (read-only;     │   │
+                    │  │                      │  │   max size cap)  │   │
+                    │  │  row 0 = top line    │  │  -1 = newest     │   │
+                    │  │  row h-1 = bottom    │  │  -n = oldest     │   │
+                    │  └──────────────────────┘  └──────────────────┘   │
                     │           │                          │            │
                     │           └──────────┬───────────────┘            │
                     │                      │                            │
@@ -215,7 +209,7 @@ at least that the runtime is at least Java 8.
                     │                      │  WIDE_RIGHT)               │
                     └──────────────────────┴────────────────────────────┘
 
-  CellAttributes = TerminalColor (fg) + TerminalColor (bg) + EnumSet<TextStyle>
+  CellAttributes = TerminalColor (fg) + TerminalColor (bg) + Set<TextStyle>
   TerminalColor  = DEFAULT | BLACK | RED | GREEN | YELLOW | BLUE |
                    MAGENTA | CYAN | WHITE | BRIGHT_* variants (17 total)
   TextStyle      = BOLD | ITALIC | UNDERLINE
@@ -232,12 +226,15 @@ the front.
 TerminalColor (enum)       — 16 standard colors + DEFAULT (17 values)
 TextStyle (enum)           — BOLD, ITALIC, UNDERLINE
 CellAttributes (immutable) — fg color + bg color + EnumSet<TextStyle>
-Cell (immutable)           — char + CellAttributes + CellType (NORMAL/WIDE_LEFT/WIDE_RIGHT)
+Cell (immutable)           — int codePoint + CellAttributes + CellType (NORMAL/WIDE_LEFT/WIDE_RIGHT)
 Row (package-private)      — mutable fixed-width array of Cells
 CursorPosition (immutable) — (col, row) value object
 TerminalBuffer (public)    — the main API class
 ```
 
+For the full rationale and alternatives considered for each decision, see
+[ARCHITECTURE_DECISIONS.md](docs/ARCHITECTURE_DECISIONS.md).
+
 ### Key Design Decisions
 
 #### Immutability strategy: Cell immutable, Row mutable
@@ -259,9 +256,9 @@ future mutations to the screen row do not corrupt history.
 
 #### Scrollback storage
 
-`ArrayDeque<Row>` with front=oldest, back=newest. O(1) push (`addLast`) and
-O(1) eviction (`removeFirst`). Random access by index is O(n) — a fixed-size
-`Row[]` circular buffer would give O(1) at the cost of complexity.
+A fixed-size `Row[]` circular buffer with `sbHead` (index of the oldest entry)
+and `sbCount` (number of live entries). Push and eviction are O(1); random
+access by index is also O(1) via `scrollback[(sbHead + sbCount + n) % maxScrollback]`.
 
 #### Coordinate system
 
@@ -324,11 +321,6 @@ subsequent rows recursively:
 
 ## Trade-offs and Known Limitations
 
-- **`char` vs `int` for wide chars**: Cell stores `char` (covers all BMP
-  including CJK). Supplementary-plane emoji above U+FFFF are detected but
-  stored with loss. Changing `Cell.character` to `int` fixes this without
-  changing the public API.
-
 - **`insertText` cursor position after overflow**: Cursor arithmetic is based
   on total character count relative to the cursor start. Consistent in the
   current implementation; could be refined for complex multi-line inserts.
@@ -337,14 +329,10 @@ subsequent rows recursively:
   to avoid infinite blank-cell propagation. Intentional trailing spaces at the
   end of a full row would be dropped.
 
-- **Scrollback access is O(n)**: See [Known Limitations](#known-limitations).
-
 ---
 
 ## Potential Improvements
 
-- Replace `ArrayDeque<Row>` with a `Row[]` circular buffer for O(1) scrollback access.
-- Change `Cell.character` from `char` to `int` for full supplementary-plane emoji support.
 - Add `Bidi` (bidirectional text) support for RTL languages.
 - Add `SGR` (Select Graphic Rendition) parsing to process ANSI escape sequences directly.
 - Add alternate screen buffer support (used by fullscreen TUI apps like vim).
@@ -388,6 +376,9 @@ the full text.
 The choice of MIT reflects the academic nature of this project: maximum freedom
 to study, adapt, and reuse, with no restrictions on how you use it.
 
+Third-party component licenses are listed in
+[COMPONENTS_LICENSE.md](docs/COMPONENTS_LICENSE.md).
+
 [![REUSE Compliant](https://api.reuse.software/badge/github.com/igarbayo/terminal-text-buffer)](https://api.reuse.software/info/github.com/igarbayo/terminal-text-buffer)
 
 <!-- SPDX-FileCopyrightText: 2026 Ignacio Garbayo Fernández <ignacio.garbayo@rai.usc.es> -->
diff --git a/docs/ARCHITECTURE_DECISIONS.md b/docs/ARCHITECTURE_DECISIONS.md
index 6ebf742..0e41e7e 100644
--- a/docs/ARCHITECTURE_DECISIONS.md
+++ b/docs/ARCHITECTURE_DECISIONS.md
@@ -46,7 +46,7 @@ dependency conflicts.
 **Context:** JUnit 5 is the current standard for Java testing. It is available
 as a Gradle test dependency and does not affect the runtime artefact.
 
-**Consequences:** EPL-2.0 licence (JUnit's licence) applies to the test code at
+**Consequences:** EPL-2.0 license (JUnit's license) applies to the test code at
 build time. It does not affect the MIT-licensed library artefact.
 
 ---
@@ -69,22 +69,24 @@ entire row array on every character write — O(width) per character.
 
 ---
 
-## ADR-005: Scrollback storage — ArrayDeque
+## ADR-005: Scrollback storage — circular buffer
 
-**Decision:** `ArrayDeque<Row>` for scrollback, with the front being the oldest
-entry and the back the newest.
+**Decision:** A fixed-size `Row[]` circular buffer with two int fields:
+`sbHead` (index of the oldest live entry) and `sbCount` (number of live
+entries). The newest entry lives at index `(sbHead + sbCount - 1) % maxScrollback`;
+the `n`-th entry relative to the current scrollback tail is resolved as
+`scrollback[(sbHead + sbCount + n) % maxScrollback]` (where `n` is negative).
 
-**Context:** Scrollback needs O(1) push (when a row scrolls off the screen) and
-O(1) eviction (when the scrollback is full). Random access by index was not
-initially a performance concern.
+**Context:** Scrollback needs O(1) push (when a row scrolls off the screen),
+O(1) eviction (when the scrollback is full), and O(1) random access for
+`resolveRow()`.
 
-**Trade-off:** Push and eviction are O(1). Random access by index is O(n). For
-a 10 000-line scrollback this is measurable but acceptable for the expected use
-cases.
+**Trade-off:** All three operations are O(1). The implementation is slightly
+more complex than a `ArrayDeque`, but the indices are straightforward once the
+modular arithmetic is understood.
 
-**Known improvement:** Replacing `ArrayDeque` with a fixed-size `Row[]` circular
-buffer would give O(1) random access at the cost of a more complex
-implementation. See Potential Improvements in the README.
+**Supersedes:** An earlier version used `ArrayDeque<Row>` which gave O(1) push
+and eviction but O(n) random access.
 
 ---
 
@@ -124,10 +126,13 @@ terminal emulators. The alternatives were:
 existing fixed-width `Row` model. Writing over either half of a wide pair
 automatically clears both halves.
 
-**Known limitation:** Characters above U+FFFF (supplementary-plane emoji) are
-detected correctly but stored as `(char) codePoint`, losing the high surrogate.
-Changing `Cell.character` from `char` to `int` would fix this without breaking
-the public API.
+**Note on supplementary-plane codepoints:** `Cell.character` is stored as
+`int` (a Unicode codepoint, not a UTF-16 `char`), so emoji and other
+supplementary-plane characters above U+FFFF are stored without loss.
+`Row.toContentString()` uses `StringBuilder.appendCodePoint(int)` to render
+them correctly. The public `getChar(col, row)` method still returns `char`
+for convenience — callers that need the full codepoint can use
+`Cell.getCodePoint()` directly.
 
 ---
 
@@ -146,7 +151,7 @@ immediately triggering a scroll.
 
 ---
 
-## ADR-009: MIT licence
+## ADR-009: MIT license
 
 **Decision:** MIT.
 
diff --git a/docs/COMPONENTS_LICENSE.md b/docs/COMPONENTS_LICENSE.md
index ad917c7..090f54f 100644
--- a/docs/COMPONENTS_LICENSE.md
+++ b/docs/COMPONENTS_LICENSE.md
@@ -1,7 +1,7 @@
 # Components and Licensing
 
-This document explains why this project uses the MIT License, what licences
-its dependencies carry, and whether all of those licences are compatible with
+This document explains why this project uses the MIT License, what licenses
+its dependencies carry, and whether all of those licenses are compatible with
 each other. The goal is to let any reader — developer, legal team, or curious
 student — understand the full licensing picture at a glance.
 
@@ -25,12 +25,12 @@ MIT was chosen because:
    product. There is no business reason to restrict use.
 
 3. **Compatibility.** MIT is compatible with virtually every other open-source
-   licence, including Apache-2.0 (used by the Gradle wrapper) and EPL-2.0
-   (used by JUnit 5). A more restrictive licence (GPL, AGPL) would create
+   license, including Apache-2.0 (used by the Gradle wrapper) and EPL-2.0
+   (used by JUnit 5). A more restrictive license (GPL, AGPL) would create
    compatibility problems for anyone wanting to link this library into a
    larger project.
 
-4. **No-warranty clause.** Like all OSI-approved licences, MIT explicitly
+4. **No-warranty clause.** Like all OSI-approved licenses, MIT explicitly
    disclaims warranties. This is standard practice for open-source software.
 
 ### What MIT allows and requires
@@ -39,7 +39,7 @@ Anyone who receives this software may use, copy, modify, merge, publish,
 distribute, sublicense, and/or sell copies — for any purpose, including
 commercial — as long as they:
 
-- Include the original copyright notice and the MIT licence text in any
+- Include the original copyright notice and the MIT license text in any
   substantial copy or distribution of the software.
 
 That is the only obligation. There is no copyleft requirement, no
@@ -47,7 +47,7 @@ network-use clause, and no patent retaliation clause.
 
 ---
 
-## Dependency licence audit
+## Dependency license audit
 
 ### Runtime dependencies
 
@@ -57,22 +57,22 @@ redistributed by this project).
 
 ### Test dependencies
 
-| Dependency | Version | Licence (SPDX) | Compatibility with MIT |
+| Dependency | Version | license (SPDX) | Compatibility with MIT |
 |---|---|---|---|
-| JUnit Jupiter (JUnit 5) | 5.x | `EPL-2.0` | Compatible — EPL-2.0 is a weak copyleft licence. It requires that modifications to EPL-licensed files be shared back under EPL, but it does not "infect" MIT-licensed code that merely calls JUnit as a test framework. JUnit is used only during testing and is never bundled into the distributed artefact. |
+| JUnit Jupiter (JUnit 5) | 5.x | `EPL-2.0` | Compatible — EPL-2.0 is a weak copyleft license. It requires that modifications to EPL-licensed files be shared back under EPL, but it does not "infect" MIT-licensed code that merely calls JUnit as a test framework. JUnit is used only during testing and is never bundled into the distributed artefact. |
 
 ### Build tool
 
-| Component | Licence (SPDX) | Notes |
+| Component | license (SPDX) | Notes |
 |---|---|---|
-| Gradle wrapper (`gradlew`, `gradlew.bat`, `gradle/wrapper/`) | `Apache-2.0` | Included in the repository as a convenience. Apache-2.0 is a permissive licence fully compatible with MIT. REUSE metadata for these files is in [.reuse/dep5](../.reuse/dep5). |
+| Gradle wrapper (`gradlew`, `gradlew.bat`, `gradle/wrapper/`) | `Apache-2.0` | Included in the repository as a convenience. Apache-2.0 is a permissive license fully compatible with MIT. REUSE metadata for these files is in [.reuse/dep5](../.reuse/dep5). |
 
 ---
 
 ## REUSE compliance
 
 This project follows the [REUSE Specification](https://reuse.software/)
-version 3.3. Every file in the repository has a corresponding licence
+version 3.3. Every file in the repository has a corresponding license
 declaration, either through:
 
 - An **SPDX header comment** in the file itself (all source and documentation
@@ -80,7 +80,7 @@ declaration, either through:
 - The [.reuse/dep5](../.reuse/dep5) file (third-party files that cannot be
   modified, such as the Gradle wrapper).
 
-Licence texts for every SPDX identifier used in this project are stored in
+license texts for every SPDX identifier used in this project are stored in
 the [LICENSES/](../LICENSES/) directory:
 
 | File | SPDX identifier |
diff --git a/docs/manual-testing-guide.md b/docs/MANUAL_TESTING_GUIDE.md
similarity index 90%
rename from docs/manual-testing-guide.md
rename to docs/MANUAL_TESTING_GUIDE.md
index 3cc2d0f..002e98f 100644
--- a/docs/manual-testing-guide.md
+++ b/docs/MANUAL_TESTING_GUIDE.md
@@ -6,7 +6,7 @@ This guide covers how to run the interactive REPL and test every feature of
 ## Starting the REPL
 
 ```bash
-./gradlew run --console=plain -q
+./gradlew run
 ```
 
 The REPL starts with an 80×24 buffer and 200-line scrollback. Type `help` at any
@@ -22,13 +22,13 @@ point to list all available commands.
 ## 1. Basic `writeText`
 
 ```
-write Hola mundo
+write Hello world
 ```
-Expected: text appears at row 0 col 0; cursor moves to (10, 0).
+Expected: text appears at row 0 col 0; cursor moves to (11, 0).
 
 ```
 cursor 5 2
-write Texto centrado
+write Centered text
 ```
 Expected: text starts at col 5 row 2.
 
@@ -50,14 +50,14 @@ Cursor stays at the position after the last written character.
 clear
 fg RED
 bold
-write Texto rojo negrita
+write Red bold text
 cursor 0 1
 fg BLUE
 italic
-write Texto azul cursiva
+write Blue italic text
 reset
 cursor 0 2
-write Texto normal
+write Normal text
 ```
 Expected: row 0 in red+bold, row 1 in blue+italic, row 2 in default style.
 
@@ -121,15 +121,15 @@ Expected: row 5 filled with spaces (clears it).
 ```
 clear
 cursor 0 0
-write Linea 1
+write Line 1
 newline
-write Linea 2
+write Line 2
 newline
-write Linea 3
+write Line 3
 scrollback
 ```
 Expected: after each `newline`, the top row scrolls into scrollback.
-`scrollback` shows `[-2] Linea 1` and `[-1] Linea 2` (Linea 3 is still on screen).
+`scrollback` shows `[-2] Line 1` and `[-1] Line 2` (Line 3 is still on screen).
 
 ### Fill scrollback
 
@@ -212,7 +212,7 @@ Expected: `U+65E5`, `U+672C`, `U+8A9E` — all detected as `isWide=true`.
 
 ```
 clear
-write Texto que puede quedar cortado
+write Text that may get truncated here
 resize 20 5
 print
 ```
@@ -232,13 +232,13 @@ Restores original dimensions. Previous scrollback entries are still accessible.
 ```
 clearall
 cursor 0 0
-write Primera linea
+write First line
 newline
-write Segunda linea
+write Second line
 newline
 scrollback
 ```
-Expected: `[-2] Primera linea`, `[-1] Segunda linea`.
+Expected: `[-2] First line`, `[-1] Second line`.
 
 ```
 clear
@@ -251,7 +251,7 @@ touch scrollback.
 clearall
 scrollback
 ```
-Expected: `--- Scrollback vacio ---` — `clearall` wipes everything including scrollback.
+Expected: `--- Scrollback empty ---` — `clearall` wipes everything including scrollback.
 
 ---
 
@@ -266,10 +266,10 @@ bold
 write === Terminal Buffer Demo ===
 reset
 cursor 0 2
-write Linea normal
+write Normal line
 cursor 0 3
 fg YELLOW
-write Linea amarilla
+write Yellow line
 reset
 cursor 0 4
 fill -
@@ -278,7 +278,7 @@ newline
 newline
 scrollback
 cursor 0 0
-insert INSERCION AL PRINCIPIO
+insert INSERTED AT THE START
 resize 40 10
 print
 resize 80 24
diff --git a/images/image-1.png b/images/image-1.png
new file mode 100644
index 0000000000000000000000000000000000000000..1a3c046c9b0313cf1c1486aea30b52cd11e22897
GIT binary patch
literal 19122
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
Nj(Z$RzWD0v{{`j~JmmlY

literal 0
HcmV?d00001

diff --git a/images/image.png b/images/image.png
new file mode 100644
index 0000000000000000000000000000000000000000..71d744380abc81bfe47fea22e1c1de0f374cc29a
GIT binary patch
literal 96881
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
B)P?{6

literal 0
HcmV?d00001

diff --git a/src/main/java/com/terminal/buffer/Cell.java b/src/main/java/com/terminal/buffer/Cell.java
index 76d48ca..08f0dc0 100644
--- a/src/main/java/com/terminal/buffer/Cell.java
+++ b/src/main/java/com/terminal/buffer/Cell.java
@@ -16,24 +16,24 @@ public enum CellType {
     // A shared immutable empty cell instance to avoid unnecessary allocations for blank spaces
     public static final Cell EMPTY = new Cell(' ', CellAttributes.DEFAULT, CellType.NORMAL);
 
-    private final char character;
+    private final int codePoint;
     private final CellAttributes attributes;
     private final CellType type;
 
     // Constructors
-    public Cell(char character, CellAttributes attributes) {
-        this(character, attributes, CellType.NORMAL);
+    public Cell(int codePoint, CellAttributes attributes) {
+        this(codePoint, attributes, CellType.NORMAL);
     }
 
-    public Cell(char character, CellAttributes attributes, CellType type) {
-        this.character = character;
+    public Cell(int codePoint, CellAttributes attributes, CellType type) {
+        this.codePoint = codePoint;
         this.attributes = attributes;
         this.type = type;
     }
 
     // Getters
-    public char getCharacter() {
-        return character;
+    public int getCodePoint() {
+        return codePoint;
     }
 
     public CellAttributes getAttributes() {
@@ -61,19 +61,19 @@ public boolean equals(Object o) {
         if (this == o) return true;
         if (!(o instanceof Cell)) return false;
         Cell cell = (Cell) o;
-        return character == cell.character &&
+        return codePoint == cell.codePoint &&
                 type == cell.type &&
                 Objects.equals(attributes, cell.attributes);
     }
 
     @Override
     public int hashCode() {
-        return Objects.hash(character, attributes, type);
+        return Objects.hash(codePoint, attributes, type);
     }
 
     // For debugging purposes, we provide a string representation of the cell that includes its character, attributes, and type
     @Override
     public String toString() {
-        return "Cell{'" + character + "', " + attributes + ", " + type + "}";
+        return "Cell{'" + new String(Character.toChars(codePoint)) + "', " + attributes + ", " + type + "}";
     }
 }
diff --git a/src/main/java/com/terminal/buffer/Row.java b/src/main/java/com/terminal/buffer/Row.java
index 1dd79af..d5e35d3 100644
--- a/src/main/java/com/terminal/buffer/Row.java
+++ b/src/main/java/com/terminal/buffer/Row.java
@@ -49,7 +49,7 @@ String toContentString() {
         StringBuilder sb = new StringBuilder(cells.length);
         for (Cell cell : cells) {
             if (!cell.isPlaceholder()) {
-                sb.append(cell.getCharacter());
+                sb.appendCodePoint(cell.getCodePoint());
             }
         }
         return sb.toString();
diff --git a/src/main/java/com/terminal/buffer/TerminalBuffer.java b/src/main/java/com/terminal/buffer/TerminalBuffer.java
index b6f3766..df62248 100644
--- a/src/main/java/com/terminal/buffer/TerminalBuffer.java
+++ b/src/main/java/com/terminal/buffer/TerminalBuffer.java
@@ -3,9 +3,7 @@
 
 package com.terminal.buffer;
 
-import java.util.ArrayDeque;
 import java.util.Arrays;
-import java.util.EnumSet;
 
 public class TerminalBuffer {
 
@@ -14,7 +12,9 @@ public class TerminalBuffer {
     private final int maxScrollback;
 
     private Row[] screen;
-    private final ArrayDeque<Row> scrollback;
+    private final Row[] scrollback;   // fixed-size circular ring
+    private int sbHead;               // index of oldest entry
+    private int sbCount;              // number of stored rows
 
     private int cursorCol;
     private int cursorRow;
@@ -36,11 +36,15 @@ public TerminalBuffer(int width, int height, int maxScrollback) {
         this.height = height;
         this.maxScrollback = maxScrollback;
 
+        // Allocate the screen grid; every cell starts as Cell.EMPTY (space, default attributes).
         this.screen = new Row[height];
         for (int i = 0; i < height; i++) {
             screen[i] = new Row(width);
         }
-        this.scrollback = new ArrayDeque<>();
+        // Scrollback is pre-allocated once; entries are filled lazily as rows scroll off.
+        this.scrollback = new Row[maxScrollback];
+        this.sbHead = 0;
+        this.sbCount = 0;
         this.cursorCol = 0;
         this.cursorRow = 0;
         this.pendingWrap = false;
@@ -54,7 +58,7 @@ public TerminalBuffer(int width, int height, int maxScrollback) {
     public int getWidth() { return width; }
     public int getHeight() { return height; }
     public int getMaxScrollback() { return maxScrollback; }
-    public int getScrollbackSize() { return scrollback.size(); }
+    public int getScrollbackSize() { return sbCount; }
 
     // -------------------------------------------------------------------------
     // Current Attributes
@@ -70,22 +74,27 @@ public CellAttributes getAttributes() {
     }
 
     public void setForeground(TerminalColor color) {
+        // Produces a new CellAttributes with only the foreground changed.
         currentAttributes = currentAttributes.withForeground(color);
     }
 
     public void setBackground(TerminalColor color) {
+        // Produces a new CellAttributes with only the background changed.
         currentAttributes = currentAttributes.withBackground(color);
     }
 
     public void addStyle(TextStyle style) {
+        // Adds one style flag; other flags are preserved.
         currentAttributes = currentAttributes.withStyle(style);
     }
 
     public void removeStyle(TextStyle style) {
+        // Removes one style flag; other flags are preserved.
         currentAttributes = currentAttributes.withoutStyle(style);
     }
 
     public void resetAttributes() {
+        // Restores fg=DEFAULT, bg=DEFAULT, and clears all style flags.
         currentAttributes = CellAttributes.DEFAULT;
     }
 
@@ -94,6 +103,7 @@ public void resetAttributes() {
     // -------------------------------------------------------------------------
 
     public CursorPosition getCursor() {
+        // Returns a snapshot — callers cannot mutate internal cursor state.
         return new CursorPosition(cursorCol, cursorRow);
     }
 
@@ -101,6 +111,7 @@ public void setCursor(int col, int row) {
         // Keep cursor always inside visible screen bounds.
         cursorCol = clampCol(col);
         cursorRow = clampRow(row);
+        // Any explicit cursor move cancels a pending wrap.
         pendingWrap = false;
     }
 
@@ -142,35 +153,36 @@ public void writeText(String text) {
             int cp = text.codePointAt(i);
             i += Character.charCount(cp);
 
-            // Resolve pending wrap before writing
+            // Resolve pending wrap before writing the next character.
             if (pendingWrap) {
                 pendingWrap = false;
                 advanceCursorToNextLine();
             }
 
             if (isWideCodePoint(cp)) {
-                // Need 2 columns; truncate if only 1 column left
+                // A wide glyph needs 2 columns; skip it if only 1 column remains.
                 if (cursorCol >= width - 1) {
-                    // No room for both halves — skip character, stay at edge
                     cursorCol = width - 1;
                     pendingWrap = true;
                     break;
                 }
+                // Clear any wide-pair halves that overlap the two target columns.
                 clearWideOverlap(cursorCol);
                 clearWideOverlap(cursorCol + 1);
-                char ch = (char) cp; // safe for BMP
                 screen[cursorRow].setCell(cursorCol,
-                        new Cell(ch, currentAttributes, Cell.CellType.WIDE_LEFT));
+                        new Cell(cp, currentAttributes, Cell.CellType.WIDE_LEFT));
                 screen[cursorRow].setCell(cursorCol + 1,
-                        new Cell('\0', currentAttributes, Cell.CellType.WIDE_RIGHT));
+                        new Cell(0, currentAttributes, Cell.CellType.WIDE_RIGHT));
                 cursorCol += 2;
             } else {
+                // Narrow character: clear any wide pair at this column, then write.
                 clearWideOverlap(cursorCol);
                 screen[cursorRow].setCell(cursorCol,
-                        new Cell((char) cp, currentAttributes));
+                        new Cell(cp, currentAttributes));
                 cursorCol++;
             }
 
+            // If the cursor has moved past the last column, arm the pending-wrap flag.
             if (cursorCol >= width) {
                 cursorCol = width - 1;
                 pendingWrap = true;
@@ -186,16 +198,17 @@ public void writeText(String text) {
     public void insertText(String text) {
         if (text == null || text.isEmpty()) return;
 
+        // Honour any pending wrap the same way writeText does.
         if (pendingWrap) {
             pendingWrap = false;
             advanceCursorToNextLine();
         }
 
-        // Collect all cells to insert
+        // Build the full cell array for the new text, then delegate to the recursive helper.
         Cell[] toInsert = buildCells(text);
         insertCellsAt(cursorCol, cursorRow, toInsert);
 
-        // Advance cursor past inserted content
+        // Advance cursor past the inserted content, wrapping across rows if necessary.
         int advance = toInsert.length;
         int newCol = cursorCol + advance;
         if (newCol >= width) {
@@ -212,6 +225,7 @@ public void insertText(String text) {
      * current attributes. Cursor column is unchanged.
      */
     public void fillLine(char ch) {
+        // A single Cell is constructed and shared; Row.fill copies it into every slot.
         Cell fill = new Cell(ch, currentAttributes);
         screen[cursorRow].fill(fill);
     }
@@ -226,6 +240,7 @@ public void fillLine(char ch) {
      */
     public void insertEmptyLine() {
         pushTopRowToScrollback();
+        // Shift rows [1..height-1] one slot up in O(height) via arraycopy.
         System.arraycopy(screen, 1, screen, 0, height - 1);
         screen[height - 1] = new Row(width);
     }
@@ -235,13 +250,16 @@ public void clearScreen() {
         for (int i = 0; i < height; i++) {
             screen[i] = new Row(width);
         }
+        // Reset pending wrap so the next write starts cleanly.
         pendingWrap = false;
     }
 
     /** Clears screen and all scrollback history. */
     public void clearAll() {
         clearScreen();
-        scrollback.clear();
+        // Reset both ring-buffer pointers to discard every stored row.
+        sbHead = 0;
+        sbCount = 0;
     }
 
     // -------------------------------------------------------------------------
@@ -253,7 +271,8 @@ public void clearAll() {
      * Screen: row in [0, height-1]; Scrollback: row in [-scrollbackSize, -1].
      */
     public char getChar(int col, int row) {
-        return resolveRow(row).getCell(col).getCharacter();
+        // Cast is safe for BMP characters; use getCell().getCodePoint() for full Unicode.
+        return (char) resolveRow(row).getCell(col).getCodePoint();
     }
 
     /**
@@ -276,6 +295,7 @@ public CellAttributes getAttributesAt(int col, int row) {
      */
     public String getLine(int row) {
         String raw = resolveRow(row).toContentString();
+        // Strip trailing spaces so callers get a clean logical string.
         int end = raw.length();
         while (end > 0 && raw.charAt(end - 1) == ' ') end--;
         return raw.substring(0, end);
@@ -285,6 +305,7 @@ public String getLine(int row) {
      * Returns the full fixed-width content of the given line (always width chars).
      */
     public String getRawLine(int row) {
+        // No trimming: every cell is included, padded with spaces where empty.
         return resolveRow(row).toContentString();
     }
 
@@ -305,9 +326,10 @@ public String getScreenContent() {
      */
     public String getAllContent() {
         StringBuilder sb = new StringBuilder();
-        for (Row row : scrollback) {
-            sb.append(row.toContentString());
-            sb.append('\n');
+        // Iterate the circular buffer in chronological order (oldest → newest).
+        for (int i = 0; i < sbCount; i++) {
+            Row row = scrollback[(sbHead + i) % maxScrollback];
+            sb.append(row.toContentString()).append('\n');
         }
         for (int i = 0; i < height; i++) {
             if (i > 0) sb.append('\n');
@@ -332,23 +354,21 @@ public void resize(int newWidth, int newHeight) {
         if (newWidth <= 0) throw new IllegalArgumentException("width must be > 0");
         if (newHeight <= 0) throw new IllegalArgumentException("height must be > 0");
 
-        // Adjust width of all existing rows
+        // Adjust width of all existing screen and scrollback rows first.
         if (newWidth != width) {
             for (int i = 0; i < height; i++) {
                 screen[i] = resizeRow(screen[i], newWidth);
             }
-            Row[] newScrollback = new Row[scrollback.size()];
-            int idx = 0;
-            for (Row r : scrollback) {
-                newScrollback[idx++] = resizeRow(r, newWidth);
+            // Also resize scrollback rows so getChar works consistently after resize.
+            for (int i = 0; i < sbCount; i++) {
+                int idx = (sbHead + i) % maxScrollback;
+                scrollback[idx] = resizeRow(scrollback[idx], newWidth);
             }
-            scrollback.clear();
-            for (Row r : newScrollback) scrollback.addLast(r);
         }
 
-        // Adjust height
+        // Adjust height after width so row objects already have the correct width.
         if (newHeight < height) {
-            // Rows removed from the top enter scrollback
+            // Rows removed from the top enter scrollback so history is not lost.
             int rowsToRemove = height - newHeight;
             for (int i = 0; i < rowsToRemove; i++) {
                 pushRowToScrollback(screen[i]);
@@ -357,6 +377,7 @@ public void resize(int newWidth, int newHeight) {
             System.arraycopy(screen, rowsToRemove, newScreen, 0, newHeight);
             screen = newScreen;
         } else if (newHeight > height) {
+            // Grow: append blank rows at the bottom.
             Row[] newScreen = new Row[newHeight];
             System.arraycopy(screen, 0, newScreen, 0, height);
             for (int i = height; i < newHeight; i++) {
@@ -391,30 +412,30 @@ private Row resolveRow(int row) {
         if (row >= 0 && row < height) {
             return screen[row];
         }
-        int sbSize = scrollback.size();
-        if (row < 0 && row >= -sbSize) {
-            // row -1 → index sbSize-1 (most recent), row -sbSize → index 0 (oldest)
-            int index = sbSize + row;
-            int i = 0;
-            for (Row r : scrollback) {
-                if (i == index) return r;
-                i++;
-            }
+        if (row < 0 && row >= -sbCount) {
+            // row -1 → newest (offset sbCount-1 from head), row -sbCount → oldest (head)
+            int index = sbCount + row;
+            return scrollback[(sbHead + index) % maxScrollback];
         }
         throw new IllegalArgumentException("Row out of bounds: " + row +
-                " (screen height=" + height + ", scrollbackSize=" + sbSize + ")");
+                " (screen height=" + height + ", scrollbackSize=" + sbCount + ")");
     }
 
     private void pushTopRowToScrollback() {
+        // Convenience wrapper that always pushes the first visible screen row.
         pushRowToScrollback(screen[0]);
     }
 
     private void pushRowToScrollback(Row row) {
         if (maxScrollback == 0) return;
-        // Store a copy so later screen mutations do not affect history.
-        scrollback.addLast(new Row(row));
-        if (scrollback.size() > maxScrollback) {
-            scrollback.removeFirst();
+        // Store a snapshot so later screen mutations do not corrupt history.
+        int tail = (sbHead + sbCount) % maxScrollback;
+        scrollback[tail] = new Row(row);
+        if (sbCount < maxScrollback) {
+            sbCount++;
+        } else {
+            // Ring is full: advance head to evict the oldest entry.
+            sbHead = (sbHead + 1) % maxScrollback;
         }
     }
 
@@ -424,6 +445,7 @@ private void advanceCursorToNextLine() {
             cursorRow++;
             cursorCol = 0;
         } else {
+            // Already on the last row: scroll the screen and keep the cursor there.
             insertEmptyLine();
             cursorCol = 0;
             // cursorRow stays at height-1
@@ -434,8 +456,10 @@ private void advanceCursorToNextLine() {
     private void clearWideOverlap(int col) {
         if (col < 0 || col >= width) return;
         Cell existing = screen[cursorRow].getCell(col);
+        // Overwriting the left half of a wide pair: erase the right placeholder.
         if (existing.isWide() && col + 1 < width) {
             screen[cursorRow].setCell(col + 1, Cell.EMPTY);
+        // Overwriting the right placeholder: erase the left half that owns the glyph.
         } else if (existing.isPlaceholder() && col - 1 >= 0) {
             screen[cursorRow].setCell(col - 1, Cell.EMPTY);
         }
@@ -443,7 +467,7 @@ private void clearWideOverlap(int col) {
 
     /** Build an array of Cells from a string, honouring wide characters. */
     private Cell[] buildCells(String text) {
-        // Count total cells needed
+        // First pass: count total cells needed (wide chars cost 2 slots).
         int cellCount = 0;
         for (int i = 0; i < text.length(); ) {
             int cp = text.codePointAt(i);
@@ -451,16 +475,18 @@ private Cell[] buildCells(String text) {
             cellCount += isWideCodePoint(cp) ? 2 : 1;
         }
 
+        // Second pass: populate the cell array.
         Cell[] cells = new Cell[cellCount];
         int idx = 0;
         for (int i = 0; i < text.length(); ) {
             int cp = text.codePointAt(i);
             i += Character.charCount(cp);
             if (isWideCodePoint(cp)) {
-                cells[idx++] = new Cell((char) cp, currentAttributes, Cell.CellType.WIDE_LEFT);
-                cells[idx++] = new Cell('\0', currentAttributes, Cell.CellType.WIDE_RIGHT);
+                // Wide glyph: left cell holds the codepoint, right cell is a zero placeholder.
+                cells[idx++] = new Cell(cp, currentAttributes, Cell.CellType.WIDE_LEFT);
+                cells[idx++] = new Cell(0, currentAttributes, Cell.CellType.WIDE_RIGHT);
             } else {
-                cells[idx++] = new Cell((char) cp, currentAttributes);
+                cells[idx++] = new Cell(cp, currentAttributes);
             }
         }
         return cells;
@@ -480,29 +506,30 @@ private void insertCellsAt(int col, int row, Cell[] cells) {
         Row currentRow = screen[row];
         int available = width - col;
 
-        // Save existing content from col to end of row
+        // Capture the tail of the current row that will be displaced by the insertion.
         Cell[] existing = new Cell[available];
         for (int i = 0; i < available; i++) {
             existing[i] = currentRow.getCell(col + i);
         }
 
-        // Combined: new cells first, then displaced existing content
+        // Merged array: new cells first, then the displaced tail.
         Cell[] combined = new Cell[cells.length + available];
         System.arraycopy(cells, 0, combined, 0, cells.length);
         System.arraycopy(existing, 0, combined, cells.length, available);
 
-        // Write first `available` slots of combined back into the row
+        // Write the first `available` cells of combined back into the current row.
         for (int i = 0; i < available; i++) {
             currentRow.setCell(col + i, combined[i]);
         }
 
-        // Overflow: everything past the first `available` elements
+        // If the combined array is longer than the row tail, we have overflow to push down.
         if (combined.length > available) {
             Cell[] overflow = Arrays.copyOfRange(combined, available, combined.length);
             if (hasActualContent(overflow)) {
-                // Recursively continue insertion on following rows.
+                // Recursively continue insertion on the next row.
                 int nextRow = row + 1;
                 if (nextRow >= height) {
+                    // We've hit the bottom: scroll up to make room.
                     insertEmptyLine();
                     nextRow = height - 1;
                 }
@@ -513,8 +540,9 @@ private void insertCellsAt(int col, int row, Cell[] cells) {
 
     /** Returns true if any cell contains non-space content or non-default attributes. */
     private static boolean hasActualContent(Cell[] cells) {
+        // Suppresses propagation of overflow that is purely blank space.
         for (Cell c : cells) {
-            if (c.getCharacter() != ' ' || !c.getAttributes().equals(CellAttributes.DEFAULT)) {
+            if (c.getCodePoint() != ' ' || !c.getAttributes().equals(CellAttributes.DEFAULT)) {
                 return true;
             }
         }
@@ -523,6 +551,7 @@ private static boolean hasActualContent(Cell[] cells) {
 
     private Row resizeRow(Row row, int newWidth) {
         Row newRow = new Row(newWidth);
+        // Copy as many cells as fit in the new width; extras are left as Cell.EMPTY.
         int copyLen = Math.min(row.getWidth(), newWidth);
         for (int i = 0; i < copyLen; i++) {
             newRow.setCell(i, row.getCell(i));
diff --git a/src/test/java/com/terminal/buffer/CellTest.java b/src/test/java/com/terminal/buffer/CellTest.java
index 0b6bb3a..22c3986 100644
--- a/src/test/java/com/terminal/buffer/CellTest.java
+++ b/src/test/java/com/terminal/buffer/CellTest.java
@@ -12,7 +12,7 @@ class CellTest {
     // Cell.EMPTY must represent a space with default attributes and NORMAL type.
     @Test
     void emptyConstantHasSpaceAndDefaultAttributes() {
-        assertEquals(' ', Cell.EMPTY.getCharacter());
+        assertEquals(' ', Cell.EMPTY.getCodePoint());
         assertEquals(CellAttributes.DEFAULT, Cell.EMPTY.getAttributes());
         assertEquals(Cell.CellType.NORMAL, Cell.EMPTY.getType());
     }
@@ -21,7 +21,7 @@ void emptyConstantHasSpaceAndDefaultAttributes() {
     @Test
     void twoArgConstructorDefaultsToNormalType() {
         Cell cell = new Cell('A', CellAttributes.DEFAULT);
-        assertEquals('A', cell.getCharacter());
+        assertEquals('A', cell.getCodePoint());
         assertEquals(Cell.CellType.NORMAL, cell.getType());
         assertFalse(cell.isWide());
         assertFalse(cell.isPlaceholder());
@@ -84,6 +84,15 @@ void cellsWithDifferentAttributesAreNotEqual() {
         assertNotEquals(a, b);
     }
 
+    // A supplementary-plane codepoint (U+1F600, above U+FFFF) must survive a round-trip
+    // through Cell without truncation — this was impossible when the field was a char.
+    @Test
+    void supplementaryPlaneCodePointRoundTrips() {
+        int emoji = 0x1F600; // 😀
+        Cell cell = new Cell(emoji, CellAttributes.DEFAULT);
+        assertEquals(emoji, cell.getCodePoint());
+    }
+
     // The cell must return exactly the attributes it was constructed with.
     @Test
     void cellStoresAttributes() {
diff --git a/src/test/java/com/terminal/buffer/RowTest.java b/src/test/java/com/terminal/buffer/RowTest.java
index 7de14ea..038144d 100644
--- a/src/test/java/com/terminal/buffer/RowTest.java
+++ b/src/test/java/com/terminal/buffer/RowTest.java
@@ -63,8 +63,8 @@ void copyConstructorProducesIndependentCopy() {
 
         copy.setCell(1, new Cell('B', CellAttributes.DEFAULT));
 
-        assertEquals('A', original.getCell(1).getCharacter(), "mutation of copy must not affect original");
-        assertEquals('B', copy.getCell(1).getCharacter());
+        assertEquals('A', original.getCell(1).getCodePoint(), "mutation of copy must not affect original");
+        assertEquals('B', copy.getCell(1).getCodePoint());
     }
 
     // toContentString must concatenate the character of every cell, including empty (space) cells.
diff --git a/src/test/java/com/terminal/buffer/WideCharTest.java b/src/test/java/com/terminal/buffer/WideCharTest.java
index de4b192..bece24b 100644
--- a/src/test/java/com/terminal/buffer/WideCharTest.java
+++ b/src/test/java/com/terminal/buffer/WideCharTest.java
@@ -107,4 +107,20 @@ void mixedNarrowAndWideChars() {
         assertEquals('B', buf.getChar(3, 0));
         assertEquals(4, buf.getCursor().getCol());
     }
+
+    // Supplementary-plane emoji (U+1F600, encoded as a surrogate pair in Java String) must be
+    // written as a wide glyph occupying 2 columns, with the full codepoint preserved in the cell.
+    @Test
+    void supplementaryPlaneEmojiIsStoredAsWideGlyph() {
+        String emoji = "\uD83D\uDE00"; // 😀 U+1F600 as surrogate pair
+        buf.setCursor(0, 0);
+        buf.writeText(emoji);
+
+        Cell left = buf.getCell(0, 0);
+        assertEquals(Cell.CellType.WIDE_LEFT, left.getType());
+        assertEquals(0x1F600, left.getCodePoint());   // full codepoint, not truncated
+        assertEquals(Cell.CellType.WIDE_RIGHT, buf.getCell(1, 0).getType());
+        assertEquals(2, buf.getCursor().getCol());
+        assertEquals(emoji, buf.getLine(0));
+    }
 }

From 2f0d08f97a96dcbc450e66fb1da0dc44fc665c5e Mon Sep 17 00:00:00 2001
From: igarbayo <ignacio.garbayo@rai.usc.es>
Date: Wed, 18 Mar 2026 01:55:45 +0100
Subject: [PATCH 15/15] chore: add missing files to REUSE dep5

---
 .reuse/dep5 | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.reuse/dep5 b/.reuse/dep5
index 180ba39..458a943 100644
--- a/.reuse/dep5
+++ b/.reuse/dep5
@@ -14,7 +14,7 @@ Copyright: 2026 Ignacio Garbayo Fernandez <ignacio.garbayo@rai.usc.es>
 License: MIT
 
 # Documentation and governance files — authored by the project maintainer
-Files: README.md CODE_OF_CONDUCT.md GOVERNANCE.md SECURITY.md docs/manual-testing-guide.md docs/COMPONENTS_LICENSE.md docs/GPG_KEY.md docs/ARCHITECTURE_DECISIONS.md
+Files: README.md CODE_OF_CONDUCT.md GOVERNANCE.md SECURITY.md docs/MANUAL_TESTING_GUIDE.md docs/COMPONENTS_LICENSE.md docs/GPG_KEY.md docs/ARCHITECTURE_DECISIONS.md images/image.png images/image-1.png
 Copyright: 2026 Ignacio Garbayo Fernandez <ignacio.garbayo@rai.usc.es>
 License: MIT