ketraterm-completion/io.github.ketraterm.completion.api/TerminalCompletionLearningStore

TerminalCompletionLearningStore

class TerminalCompletionLearningStore @JvmOverloads constructor(capacity: Int = DEFAULT_CAPACITY)

Mutable, bounded in-memory store for exact command completion learning.

Hosts record command lifecycle outcomes and explicit popup feedback. Optional persistence may hydrate the store once through mergeSnapshot and persist snapshot values. The store performs no I/O and does not emit candidates. Mutations are serialized around one mutable exact index. Ranking rows retain only opaque identities; plaintext replay is attached only to successful commands that TerminalCompletionReplayPolicy approves. Published snapshots are immutable and retain identity until their contents change.

Parameters

capacity

maximum distinct exact-command rows retained.

Throws

IllegalArgumentException

if capacity is not positive.

Constructors

TerminalCompletionLearningStore

constructor(capacity: Int = DEFAULT_CAPACITY)

Functions

fun clear()

Removes all retained ranking evidence and replay commands.

fun mergeSnapshot(snapshot: TerminalCompletionLearningSnapshot)

Adds distinct aggregate events from snapshot to retained learning.

recordCommandResult

fun recordCommandResult(commandLine: String, successful: Boolean, profileId: String?, workingDirectoryUri: String?, usedAtEpochMillis: Long): Boolean

Records a completed command execution.

recordSuggestionFeedback

fun recordSuggestionFeedback(commandLine: String, feedback: TerminalCompletionFeedbackKind, profileId: String?, workingDirectoryUri: String?, feedbackAtEpochMillis: Long): Boolean

Records explicit user feedback for the exact suggested command.

fun snapshot(): TerminalCompletionLearningSnapshot

Returns the current immutable exact-command statistics snapshot.