ketraterm-completion-persistence/io.github.ketraterm.completion.persistence/TerminalCompletionLearningCoordinator

TerminalCompletionLearningCoordinator

class TerminalCompletionLearningCoordinator

Owns synchronous exact-command learning and optional fixed-path persistence.

One caller-owned worker hydrates the file once, observes last-value enablement, and checkpoints the latest dirty snapshot at a fixed interval. Recording and reset mutate memory synchronously and never wait for disk. Reset bypasses enablement and the checkpoint interval so persisted learning is replaced promptly. Shutdown awaits the final required write.

Constructors

constructor(learningStore: TerminalCompletionLearningStore, coroutineScope: CoroutineScope, persistencePath: Path, persistenceEnabled: Boolean, onPersistenceLoadFailure: (Throwable) -> Unit)

Creates a learning owner using Dispatchers.IO for blocking snapshot file access.

constructor(learningStore: TerminalCompletionLearningStore, coroutineScope: CoroutineScope, persistencePath: Path, persistenceEnabled: Boolean, ioDispatcher: CoroutineDispatcher, onPersistenceLoadFailure: (Throwable) -> Unit)

Creates a lifecycle-bound learning owner for one fixed persistence path.

Types

Companion

object Companion

Functions

closeAndFlush

suspend fun closeAndFlush()

Stops accepting events and awaits the final dirty write when persistence is enabled.

closeWithoutFlush

suspend fun closeWithoutFlush()

Stops learning and awaits the worker without loading or saving pending state.

recordCommandResult

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

Records one completed command in memory and marks a changed snapshot dirty for optional persistence.

recordSuggestionFeedback

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

Records accepted or dismissed feedback for one exact suggested command.

resetLearning

fun resetLearning()

Removes all completion learning and schedules immediate replacement of the persisted snapshot.

setPersistenceEnabled

fun setPersistenceEnabled(enabled: Boolean)

Enables or disables persistence for the fixed configured path.