ketraterm-testkit/io.github.ketraterm.testkit/TerminalConformanceHarness

TerminalConformanceHarness

class TerminalConformanceHarness @JvmOverloads constructor(columns: Int, rows: Int, maxHistory: Int = 1000)

Deterministic headless parser-to-core conformance harness.

The harness wires the production parser, host adapter, core buffer, response channel, and render-frame ABI without a PTY or UI. It is intentionally stateful so callers can snapshot intermediate states while replaying a transcript. Create a fresh instance for independent differential runs.

Parameters

columns

initial terminal width in cells.

rows

initial terminal height in rows.

maxHistory

maximum retained primary-screen history rows.

Constructors

TerminalConformanceHarness

constructor(columns: Int, rows: Int, maxHistory: Int = 1000)

Functions

fun apply(event: TerminalReplayEvent)

Applies one replay event and captures any response bytes it produces.

fun replay(transcript: TerminalReplayTranscript): TerminalConformanceSnapshot

Applies every event in transcript and returns the resulting snapshot.

fun snapshot(): TerminalConformanceSnapshot

Captures retained history, the live grid, cursor, modes, host metadata, and all response bytes emitted since this harness was created.