feat: implement SQL console feature

- Add `feature:console` with `domain`, `presentation`, and `ui` modules to allow executing raw SQL commands.
- Implement `ConsoleUseCase` for input normalization and command execution against the database.
- Create `ConsoleViewModel` to manage input state, command history, and transcript results.
- Develop a custom `ConsoleSurface` UI component with a terminal-like experience, supporting multi-line input and continuation prompts.
- Integrate "SQLite Shell" as a new category in Settings across all platforms (Android, iOS, JVM, WasmJs).
- Add "Console tips" menu in the UI with copy and autofill functionality for common SQL commands.
- Include unit tests for domain logic and UI transformations, plus integration tests for the new screen.
- Bump `agp` to `9.1.1`, `koin-bom` to `4.2.1`, `firebase` to `34.12.0`, `crashlytics` to `3.0.7`, and update `compileSdk`/`targetSdk` to `37`.

Author: softartdev

AGENTS.md

@@ -9,6 +9,7 @@
 
 ### Project Structure & Module Organization
 - Core: `core/domain`, `core/presentation`, `core/data/db-sqldelight` (default), `core/data/db-room` (optional), `core/test`.
+- Features: `feature/backup/{domain,ui}`, `feature/console/{domain,presentation,ui}`, `feature/file-explorer/data`.
 - UI: `ui/shared` (common Compose code and resources), `ui/test` (multiplatform Compose UI tests), `ui/test-jvm` (JVM-specific UI test utilities).
 - Apps: `app/android`, `app/desktop`, `app/web`, `app/ios-kit` (CocoaPods framework), `app/iosApp` (Xcode project).
 - Tooling: `build-logic` (Gradle conventions), `thirdparty` (vendored modules), `gradle/libs.versions.toml` (versions).

app/android/src/androidTest/java/com/softartdev/notedelight/ui/AndroidUiTests.kt

@@ -67,6 +67,9 @@ class AndroidUiTests : AbstractJvmUiTests() {
         unloadKoinModules(backupTestModule)
     }
 
+    @Test
+    override fun consoleFeatureTest() = super.consoleFeatureTest()
+
     override fun pressBack() = Espresso.pressBack()
 
     override fun closeSoftKeyboard() = Espresso.closeSoftKeyboard()

app/desktop/src/jvmTest/kotlin/com/softartdev/notedelight/ui/DesktopUiTests.kt

@@ -106,6 +106,9 @@ class DesktopUiTests : AbstractJvmUiTests() {
     @Test
     override fun backupFeatureTest() = super.backupFeatureTest()
 
+    @Test
+    override fun consoleFeatureTest() = super.consoleFeatureTest()
+
     override fun pressBack() {
         val backButtons = composeTestRule.onAllNodesWithContentDescription(
             label = Icons.AutoMirrored.Filled.ArrowBack.name

app/iosApp/iosApp.xcworkspace/xcuserdata/artur.xcuserdatad/UserInterfaceState.xcuserstate

@@ -19,6 +19,7 @@ import co.touchlab.kermit.platformLogWriter
 import com.softartdev.notedelight.di.sharedModules
 import com.softartdev.notedelight.di.uiTestModules
 import com.softartdev.notedelight.ui.cases.BackupFeatureTestCase
+import com.softartdev.notedelight.ui.cases.ConsoleFeatureTestCase
 import com.softartdev.notedelight.ui.cases.CreateNoteWhileSelectedTestCase
 import com.softartdev.notedelight.ui.cases.CrudTestCase
 import com.softartdev.notedelight.ui.cases.EditTitleAfterCreateTestCase
@@ -139,6 +140,15 @@ class WebUiTests {
         ).invoke()
     }
 
+    @Test
+    fun consoleFeatureTest() = awaitComposeUiTest {
+        launchApp(composeUiTest = this@awaitComposeUiTest)
+        ConsoleFeatureTestCase(
+            composeUiTest = this@awaitComposeUiTest,
+            pressBack = { clickBack(this@awaitComposeUiTest) },
+        ).invoke()
+    }
+
     private fun launchApp(composeUiTest: ComposeUiTest) {
         val lifecycleOwner = TestLifecycleOwner(initialState = Lifecycle.State.RESUMED)
         composeUiTest.setContent {
@@ -173,4 +183,5 @@ class WebUiTests {
     @Test override fun settingPasswordTest(): TestResult = super.settingPasswordTest()
     @Test override fun localeTest(): TestResult = super.localeTest()
     @Test override fun backupFeatureTest(): TestResult = super.backupFeatureTest()
+    @Test override fun consoleFeatureTest(): TestResult = super.consoleFeatureTest()
 }*/

app/web/src/wasmJsTest/kotlin/com/softartdev/notedelight/WebUiTests.kt

@@ -4,6 +4,7 @@ enum class SettingsCategory {
     Appearance,
     Security,
     Backup,
+    Console,
     Info;
 
     val id: Long = ordinal.toLong()

core/domain/src/commonMain/kotlin/com/softartdev/notedelight/model/SettingsCategory.kt

@@ -0,0 +1,70 @@
+# feature:console
+
+SQL Console feature modules for executing raw SQL commands against the app database.
+
+## Modules
+
+### feature:console:domain
+- `ConsoleTranscriptEntryKind` — `COMMAND`, `OUTPUT`, `STATUS`, `ERROR`
+- `ConsoleTranscriptEntry` — domain model for transcript rows
+- `ConsoleCommandExecutor` — interface for the data layer to implement
+- `ExecuteConsoleCommandUseCase` — orchestrates input validation, semicolon normalization, execution, and error wrapping
+
+Use case behavior:
+- Trims input; rejects blank input with `ValidationError("Enter a SQL statement.")`
+- Appends `;` if missing
+- Wraps thrown exceptions into `ExecutionError` with `throwable.message ?: "Console command failed."`
+
+### feature:console:data
+- `SqlDelightConsoleCommandExecutor` — implements `ConsoleCommandExecutor` using `SafeRepo.execute()`
+- Queries returning a non-null value produce `OUTPUT` + `STATUS("Query returned 1 row(s).")`
+- Statements returning null produce `STATUS("Statement executed successfully.")`
+
+### feature:console:presentation
+- `ConsoleViewModel` with `ConsoleResult` / `ConsoleAction` MVI pattern
+- Manages `input`, `running`, `transcript`, and `commandHistory` state
+- Session-only history (not persisted across restarts)
+- Ignores submit while already running
+
+### feature:console:ui
+Custom Compose-Multiplatform terminal surface (Android/JVM/iOS/wasmJs).
+- `ConsoleSurface` — public composable; the body of the console screen
+- `ConsoleBuffer` / `ConsoleBufferBuilder` — read-only scrollback model
+- `ConsolePromptVisualTransformation` — adds `    ...> ` continuation prompt after every `\n` in the input
+- `ConsoleStatementAnalyzer` — heuristic completeness check (trim → empty false → `.` prefix true → `;` suffix true)
+- `ConsoleTheme` / `rememberConsoleTheme()` — Material3-derived palette and typography (no hardcoded colors)
+- Internal renderers in `render/`: `ConsoleHistoryCanvas` (Canvas + `TextMeasurer`) and `ConsoleInputRow` (`BasicTextField` + Run button)
+
+The module is resource-free — the surrounding `ConsoleScreen` in `:ui:shared` resolves strings via `stringResource(...)` and passes them as plain parameters. See `feature/console/ui/README.md` for design rationale and roadmap.
+
+## Limitations
+
+`SafeRepo.execute()` returns only the first column of the first row as `String?`. Full result sets are not available through the console.
+
+## UI
+
+The `ConsoleScreen` composable lives in `ui:shared` alongside other settings detail screens. It owns the Scaffold/TopAppBar, tips dropdown, helper text, progress indicator, and Koin view-model wiring; the terminal body itself is delegated to `ConsoleSurface` from `:feature:console:ui`. Together they provide:
+- Top app bar with "Console tips" overflow menu
+- A custom Canvas-rendered scrollback with theme-aware colors
+- Multi-line input with `sqlite>` prompt and `    ...> ` continuation prompt
+- Run button preserves the existing test contract
+
+## Testing
+
+```bash
+# Domain and data unit tests
+./gradlew :feature:console:domain:allTests
+./gradlew :feature:console:data:allTests
+
+# ViewModel tests
+./gradlew :feature:console:presentation:allTests
+
+# UI module unit tests (buffer, statement analyzer, visual transformation)
+./gradlew :feature:console:ui:jvmTest
+
+# Compose UI tests (ConsoleScreen)
+./gradlew :ui:test-jvm:jvmTest
+
+# Full build
+./gradle/build_quick.sh
+```

feature/console/README.md

@@ -0,0 +1,52 @@
+@file:OptIn(ExperimentalWasmDsl::class)
+
+import org.jetbrains.kotlin.gradle.ExperimentalWasmDsl
+import org.jetbrains.kotlin.gradle.dsl.JvmTarget
+
+plugins {
+    alias(libs.plugins.gradle.convention)
+    alias(libs.plugins.kotlin.multiplatform)
+    alias(libs.plugins.android.kotlin.multiplatform.library)
+}
+
+kotlin {
+    jvmToolchain(libs.versions.jdk.get().toInt())
+    jvm()
+    android {
+        namespace = "com.softartdev.notedelight.feature.console.domain"
+        compileSdk = libs.versions.compileSdk.get().toInt()
+        minSdk = libs.versions.minSdk.get().toInt()
+        compilerOptions {
+            jvmTarget.set(JvmTarget.fromTarget(libs.versions.jdk.get()))
+        }
+    }
+    iosArm64()
+    iosSimulatorArm64()
+    wasmJs {
+        browser()
+    }
+    sourceSets.forEach {
+        it.dependencies {
+            implementation(project.dependencies.enforcedPlatform(libs.coroutines.bom))
+        }
+    }
+    sourceSets {
+        val commonMain by getting {
+            dependencies {
+                implementation(projects.core.domain)
+                implementation(libs.coroutines.core)
+            }
+        }
+        val commonTest by getting {
+            dependencies {
+                implementation(kotlin("test"))
+                implementation(libs.coroutines.test)
+            }
+        }
+    }
+    compilerOptions.freeCompilerArgs.add("-Xexpect-actual-classes")
+}
+
+dependencies {
+    coreLibraryDesugaring(libs.desugar)
+}

feature/console/domain/build.gradle.kts

@@ -0,0 +1,13 @@
+package com.softartdev.notedelight.usecase.console
+
+enum class ConsoleTranscriptEntryKind {
+    COMMAND,
+    OUTPUT,
+    STATUS,
+    ERROR,
+}
+
+data class ConsoleTranscriptEntry(
+    val kind: ConsoleTranscriptEntryKind,
+    val text: String,
+)

feature/console/domain/src/commonMain/kotlin/com/softartdev/notedelight/usecase/console/ConsoleTranscriptEntry.kt

@@ -0,0 +1,39 @@
+package com.softartdev.notedelight.usecase.console
+
+import com.softartdev.notedelight.repository.SafeRepo
+
+class ConsoleUseCase(private val safeRepo: SafeRepo) {
+
+    suspend operator fun invoke(rawInput: String): ConsoleUseCaseResult {
+        val trimmed: String = rawInput.trim()
+        if (trimmed.isBlank()) return ConsoleUseCaseResult.ValidationError("Enter a SQL statement.")
+        val sql: String = if (trimmed.endsWith(";")) trimmed else "$trimmed;"
+        return try {
+            val entries = when (val result: String? = safeRepo.execute(sql)) {
+                null -> listOf(
+                    ConsoleTranscriptEntry(
+                        kind = ConsoleTranscriptEntryKind.STATUS,
+                        text = "Statement executed successfully."
+                    ),
+                )
+                else -> listOf(
+                    ConsoleTranscriptEntry(
+                        kind = ConsoleTranscriptEntryKind.OUTPUT,
+                        text = result
+                    ),
+                    ConsoleTranscriptEntry(
+                        kind = ConsoleTranscriptEntryKind.STATUS,
+                        text = "Query returned 1 row(s)."
+                    ),
+                )
+            }
+            ConsoleUseCaseResult.Executed(entries = entries, normalizedCommand = sql)
+        } catch (t: Throwable) {
+            val msg = t.message ?: "Console command failed."
+            ConsoleUseCaseResult.Executed(
+                entries = listOf(ConsoleTranscriptEntry(ConsoleTranscriptEntryKind.ERROR, msg)),
+                normalizedCommand = sql,
+            )
+        }
+    }
+}