docs(specs): v1.5.0 spec refresh — autocorrect, sanitization, clipboard, settings, setup

All file:line citations re-verified against current source with rg.

- autocorrect-spec (v1.5.0): entry point WordPredictor.kt:1855; guard
  layer (AutocorrectContextGuard NON_PROSE_CHARS :22, morphology :1946,
  possessive AC-4 :1951, elongation :1889); Damerau transposition
  (:1831, TRANSPOSITION_PENALTY :153); same-length sub cap
  (MAX_SAME_LENGTH_SUBSTITUTIONS :73); rule-based tiebreak verbatim
  (:2163-2185) replaces the removed ALIAS_SCORE_BONUS four-tier model;
  FrequencyFloor slider 100-2000 -> dictionary-scaled (:40-59, use
  :2023); disabled-word exclusion :2062; custom-word floor exemption
  :2202; #151 URI-field token replacement (SuggestionHandler.kt:491)
- url-sanitization-spec (v1.5.0): current URL_REGEX (quotes allowed
  inside, :47-49); rules compiled as anchored regex (:52-62, was
  literal-key matching); verbatim stripQueryParams (:108-130); system
  clipboard write-back (systemClipboardRewrite :34-35, service
  :304-308, :349-362); 207 providers; reddit_embed_host_url chaining;
  mid-session reload via reloadSanitizationSettings (Config.kt:965)
- clipboard-history-spec (v1.4.0): new Duplicate Handling section —
  move-to-top on re-copy (#108, ClipboardDatabase.kt:186-199), pinned/
  todo duplicates still rejected
- haptics-spec (v1.5.0): rewritten from illustrative pseudo-code to
  the real VibratorCompat dispatch (:60-97), per-event constants, #154
  one-time migration (vibrate_custom_migration_v1, Config.kt:1480),
  real pref keys/defaults (swipe-complete now true, Config.kt:84)
- settings-system-architecture-spec (v1.5.0): decomposed ui/settings/
  layer (17 section composables), settings search subsystem
  (SettingsSearch.kt, generated index, gate-aware scroll), corrected
  Defaults snippet values (height 27/40, thresholds, clipboard limit)
- appearance-spec (v1.5.0): Secondary Label Size #133
  (secondary_label_size_scale, Keyboard2View.kt:1275)
- setup-spec (v1.5.0): Defaults table re-cited (swipe-complete true,
  height 27, gesture %-units); launcher Enable/Select flow UT-6
  (LauncherActivity.kt:131-164); language packs are imported via SAF,
  never downloaded (no INTERNET permission) — replaced the fictional
  "download from GitHub releases" flow; packs install to
  files/langpacks/
- short-swipes-spec (v1.5.0): config table corrected — max distance is
  the 141% short/long boundary (range 50-200, was "65% / 40-80"), key
  short_gestures_enabled, PercentOfKey value class

— Fable 5

Author: tribixbite

docs/wiki/specs/clipboard/clipboard-history-spec.md

@@ -2,7 +2,7 @@
 title: Clipboard History - Technical Specification
 user_guide: ../../clipboard/clipboard-history.md
 status: implemented
-version: v1.3.0
+version: v1.4.0
 schema_version: v4
 ---
 
@@ -172,6 +172,28 @@ private fun addCurrentClip() {
 }
 ```
 
+### Duplicate Handling — Move to Top (#108)
+
+Copying text that is already in history does NOT create a second row and does NOT get silently ignored — the existing entry is moved to the top by refreshing its timestamps:
+
+```kotlin
+// ClipboardDatabase.kt:186-199 (inside addClipboardEntry)
+db.rawQuery(duplicateQuery, arrayOf(contentHash, trimmedContent, currentTime.toString())).use { cursor ->
+    if (cursor.moveToFirst()) {
+        // #108: Move duplicate to top by updating its timestamp instead of ignoring
+        val existingId = cursor.getLong(0)
+        val updateValues = ContentValues().apply {
+            put(COLUMN_TIMESTAMP, currentTime)
+            put(COLUMN_EXPIRY_TIMESTAMP, expiryTimestamp)
+        }
+        db.update(TABLE_CLIPBOARD, updateValues, "$COLUMN_ID = ?", arrayOf(existingId.toString()))
+        return true
+    }
+}
+```
+
+Duplicates are detected by `content_hash` + exact content match against non-expired entries. Media entries get the same treatment via their SHA-256 content hash (`ClipboardDatabase.kt:245-252`, "Duplicate media moved to top"). Pinned and todo tables behave differently: adding an already-pinned/already-todo item is rejected (`return false`) with no timestamp refresh — their ordering is user-managed (drag positions), not recency-based.
+
 ### Content URI Processing (IO thread)
 
 ```kotlin

docs/wiki/specs/clipboard/url-sanitization-spec.md

@@ -2,7 +2,7 @@
 title: Short Swipes - Technical Specification
 user_guide: ../../gestures/short-swipes.md
 status: implemented
-version: v1.2.7
+version: v1.5.0
 ---
 
 # Short Swipes Technical Specification
@@ -152,9 +152,11 @@ fun drawSwipeTrail(canvas: Canvas, points: List<PointF>) {
 
 | Setting | Key | Default | Range |
 |---------|-----|---------|-------|
-| **Min Distance** | `short_gesture_min_distance` | 28% | 15-50 |
-| **Max Distance** | `short_gesture_max_distance` | 65% | 40-80 |
-| **Enable Short Swipes** | `short_swipes_enabled` | true | boolean |
+| **Min Distance** | `short_gesture_min_distance` | 28 (% of key diagonal) | 10-60 (`Config.kt:119`) |
+| **Max Distance** (short/long boundary) | `short_gesture_max_distance` | 141 (% of key diagonal) | 50-200 (`Config.kt:120`) |
+| **Enable Short Swipes** | `short_gestures_enabled` | true | boolean (`Config.kt:118`) |
+
+`short_gesture_max_distance` is the short/long boundary: displacement at or below it is a short swipe (subkey); beyond it the gesture continues as a word swipe. The old "200 = disabled" UI label was never implemented and has been retired (`Config.kt:571`). Both distances are stored as `PercentOfKey` — a value class that makes raw-pixel vs percent confusion uncompilable (`Config.kt:570-571`).
 
 ## Calibration Activity
 

docs/wiki/specs/gestures/short-swipes-spec.md

@@ -2,7 +2,7 @@
 title: First Time Setup - Technical Specification
 user_guide: ../../getting-started/first-time-setup.md
 status: implemented
-version: v1.2.9
+version: v1.5.0
 ---
 
 # First Time Setup Technical Specification
@@ -18,7 +18,8 @@ Initial keyboard configuration flow including language pack download and prefere
 | Settings Activity | `SettingsActivity.kt` | Main configuration UI |
 | Config | `Config.kt` | Default values and preference keys |
 | DirectBootPrefs | `DirectBootAwarePreferences.kt` | Device-encrypted storage |
-| Language Manager | `LanguagePackManager.kt` | Download and install language packs |
+| Launcher | `LauncherActivity.kt` | First-run Enable/Select Keyboard flow |
+| Language Manager | `langpack/LanguagePackManager.kt` | Import and install language packs (SAF, no network) |
 
 ## Initialization Flow
 
@@ -44,7 +45,7 @@ Normal keyboard operation
 |---------|------|----------|
 | **Preferences** | `shared_prefs/cleverkeys_prefs.xml` | User settings |
 | **Device Protected** | `shared_prefs/neural_performance_stats.xml` | Stats (encrypted) |
-| **Language Packs** | `files/language_packs/` | Downloaded ONNX models |
+| **Language Packs** | `files/langpacks/` | Imported dictionaries + unigrams (`LanguagePackManager.kt:29`) |
 
 ## Default Values
 
@@ -53,34 +54,42 @@ Key defaults from `Config.kt` `object Defaults` (line 18+):
 | Setting | Default | Source (`Config.kt` line) |
 |---------|---------|--------------------------|
 | `THEME` | `"cleverkeysdark"` | 20 |
-| `KEYBOARD_HEIGHT_PORTRAIT` | 30 | 21 |
-| `KEYBOARD_HEIGHT_LANDSCAPE` | 40 | 22 |
-| `SHORT_GESTURE_MIN_DISTANCE` | 28 | 99 |
-| `SHORT_GESTURE_MAX_DISTANCE` | 141 | 100 |
-| `AUTOCORRECT_ENABLED` | true | 153 |
-| `LONGPRESS_TIMEOUT` | 600 | 70 |
-| `NEURAL_BEAM_WIDTH` | 6 | 114 |
-| `NEURAL_MAX_LENGTH` | 20 | 115 |
-| `NEURAL_CONFIDENCE_THRESHOLD` | 0.01f | 116 |
-| `ONNX_XNNPACK_THREADS` | 2 | 247 |
-| `HAPTIC_ENABLED` | true | 63 |
-| `HAPTIC_SWIPE_COMPLETE` | false | 69 |
-| `SMART_PUNCTUATION` | true | 77 |
-| `DOUBLE_SPACE_TO_PERIOD` | true | 86 |
-| `DOUBLE_SPACE_THRESHOLD` | 500 | 87 |
-| `LANGUAGE_DETECTION_SENSITIVITY` | 0.6f | 243 |
-| `CLIPBOARD_HISTORY_LIMIT` | 50 | 176-177 |
-
-## Language Pack Download
-
-Flow in `LanguagePackManager.kt`:
-
-1. Check network connectivity
-2. Fetch pack list from GitHub releases
-3. Download ZIP containing model + dictionary
-4. Extract to `language_packs/{lang}/`
-5. Verify model loads successfully
-6. Update preferences with available languages
+| `KEYBOARD_HEIGHT_PORTRAIT` | 27 | 23 |
+| `KEYBOARD_HEIGHT_LANDSCAPE` | 40 | 24 |
+| `SHORT_GESTURE_MIN_DISTANCE` | 28 (% of key diagonal) | 119 |
+| `SHORT_GESTURE_MAX_DISTANCE` | 141 (% of key diagonal; short/long boundary) | 120 |
+| `AUTOCORRECT_ENABLED` | true | 176 |
+| `LONGPRESS_TIMEOUT` | 600 | 85 |
+| `NEURAL_BEAM_WIDTH` | 6 | 134 |
+| `NEURAL_MAX_LENGTH` | 20 | 135 |
+| `NEURAL_CONFIDENCE_THRESHOLD` | 0.01f | 136 |
+| `ONNX_XNNPACK_THREADS` | 2 | 299 |
+| `HAPTIC_ENABLED` | true | 75 |
+| `HAPTIC_SWIPE_COMPLETE` | true | 84 |
+| `SMART_PUNCTUATION` | true | 95 |
+| `DOUBLE_SPACE_TO_PERIOD` | true | 104 |
+| `DOUBLE_SPACE_THRESHOLD` | 500 | 105 |
+| `LANGUAGE_DETECTION_SENSITIVITY` | 0.6f | 295 |
+| `CLIPBOARD_HISTORY_LIMIT` | "0" (unlimited) | 215 |
+
+## Enable / Select Keyboard Flow (LauncherActivity)
+
+The in-app launcher offers **Enable Keyboard** and **Select Keyboard** actions (`LauncherActivity.kt:110-111`). `Select Keyboard` never calls `showInputMethodPicker()` in crash-prone states (UT-6, `LauncherActivity.kt:131-164`):
+
+- CleverKeys **not yet enabled** as an input method → opens the system IME settings screen instead of the picker (`isCleverKeysEnabledCompat()` check → `launchKeyboardSettings()`).
+- Enabled **and window focused** → shows the system input-method picker.
+- Enabled but **window unfocused** at picker time → falls back to IME settings.
+
+Rationale: `showInputMethodPicker()` displays a dialog owned by `system_server`; issuing it while the IME isn't enabled or the window is unfocused can crash or no-op silently.
+
+## Language Pack Import
+
+CleverKeys has **no INTERNET permission** — language packs are never downloaded by the app. Flow:
+
+1. Obtain a prebuilt `langpack-<lang>.zip` (repo `scripts/dictionaries/`) or build one with `scripts/build_langpack.py`
+2. Settings → 🌐 Multi-Language → **Import Pack** (SAF file picker)
+3. Pack contents (manifest.json + dictionary.bin + unigrams.txt) are installed under `files/langpacks/`
+4. The language becomes selectable; installed packs are detected alongside bundled dictionaries
 
 ## Related Specifications
 

docs/wiki/specs/getting-started/setup-spec.md

@@ -2,7 +2,7 @@
 title: Appearance Settings - Technical Specification
 user_guide: ../../settings/appearance.md
 status: implemented
-version: v1.2.9
+version: v1.5.0
 ---
 
 # Appearance Settings Technical Specification
@@ -244,6 +244,17 @@ class PredictionBarView : ViewGroup {
 | **Popup Mode** | `key_popup_mode` | ALWAYS | Always/HoldOnly |
 | **Prediction Height** | `prediction_bar_height` | NORMAL | Hidden/Compact/Normal/Expanded |
 | **Prediction Count** | `prediction_count` | 5 | 3-7 |
+| **Secondary Label Size** | `secondary_label_size_scale` | 1.0 (100% = unchanged) | 0.5–2.0 (UI slider 50%–200%) |
+
+### Secondary Label Size (#133, v1.5.0)
+
+Independent scale for the small corner (short-swipe/flick) labels, decoupled from Character Size. Default `SECONDARY_LABEL_SIZE_SCALE = 1.0f` (`Config.kt:39`); applied multiplicatively in `Keyboard2View.kt:1275`:
+
+```kotlin
+_subLabelSize = labelBaseSize * _config.sublabelTextSize * _config.secondary_label_size_scale
+```
+
+Turn it down when a large Character Size makes sublabels crowd the main label.
 
 ## Related Specifications