chore: bump version to 0.1.4

Update version to 0.1.4 for Phase 1.5 release (Scenario Metadata & Filtering System).

Changes:
- README.md: Updated version references, added Phase 1.5 features to Current Status
- Cargo.toml: Version 0.1.3 → 0.1.4
- CHANGELOG.md: Added comprehensive 0.1.4 release notes
- Updated project metrics (tests: 164 → 392, scenarios: 20 → 25, LOC: ~5,759 → ~7,200)

Phase 1.5 features:
- Rich metadata system (category, difficulty, tags, taught commands)
- Flexible filtering and sorting (6 sort modes, chainable filters)
- Visual indicators (🟢🟡🔴 difficulty + ✅ completion)
- Automated scenario validation tests
- Performance benchmarks (<1ms for 1000 scenarios)

Author: bug-ops

CHANGELOG.md

@@ -7,6 +7,91 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.1.4] - 2025-11-28
+
+### Added
+
+**Phase 1.5: Scenario Metadata & Filtering System**
+
+- Rich scenario metadata system
+  - `ScenarioMetadata` with category, difficulty, tags, and taught commands
+  - 25 scenarios fully categorized: Movement (5), Editing (11), Clipboard (3), Advanced (6)
+  - Difficulty levels: Beginner (20), Intermediate (5)
+  - Each scenario tagged with taught commands and practice focus areas
+
+- Flexible filtering and sorting system
+  - `ScenarioCollection` with six sort modes (alphabetical, difficulty, category, completion, recent, random)
+  - Filter by category (Movement, Editing, Clipboard, Advanced)
+  - Filter by difficulty (Beginner, Intermediate, Advanced)
+  - Filter by taught commands (e.g., show all scenarios teaching 'w' or 'dd')
+  - Filter by completion status (completed vs. uncompleted)
+  - Chainable filters for complex queries
+  - 100% backward compatible with existing scenarios (metadata optional)
+
+- Enhanced UI indicators
+  - Difficulty badges: 🟢 Beginner / 🟡 Intermediate / 🔴 Advanced
+  - Completion status: ✅ for completed scenarios
+  - Visual feedback in scenario menu
+
+- Automated scenario validation tests
+  - `test_all_scenarios_load_successfully`: validates all 25 scenarios load without errors
+  - `test_all_scenarios_execute_solution`: executes solution commands and verifies target state
+  - Catches cursor position errors, invalid command formats, and other issues
+  - Runs during CI to prevent scenario regressions
+
+- Performance benchmarks
+  - Criterion benchmarks in `benches/filtering_sorting.rs`
+  - <1ms filtering/sorting for collections of 1000 scenarios
+  - Memory-efficient metadata storage
+
+### Changed
+
+- Integrated `ScenarioCollection` into `AppState` (replacing raw `Vec<Scenario>`)
+- Menu now displays difficulty and completion indicators for each scenario
+- Updated all 25 scenarios with complete metadata (category, difficulty, tags, taught commands)
+
+### Fixed
+
+- Corrected cursor positions in multiple scenarios:
+  - `repeat_insert_001`: Fixed target cursor [1, 17] → [1, 16]
+  - `paste_before_001`: Fixed target cursor [0, 1] → [0, 2]
+  - `delete_line_001`: Start cursor on line 1 instead of line 0
+  - `document_end_001`: Cursor at [4, 9] (end of document)
+  - `select_word_001`: Cursor at [0, 9] (after word end)
+  - `repeat_indent_001`: Cursor [2, 2] → [2, 4] (after second indent)
+
+- Fixed command format in scenarios:
+  - Changed multi-key commands from arrays to strings (e.g., `["d", "d"]` → `["dd"]`)
+  - Applies to: `dd`, `gg`, `r_`, and other multi-key sequences
+
+- Fixed repeat command repeatability:
+  - Made all printable ASCII characters and space repeatable in `is_repeatable_command()`
+  - Allows replace commands like `r_` to work with repeat (`.`)
+
+- Fixed indentation in `repeat_indent_001`:
+  - Changed from 4-space to 2-space indentation to match simulator behavior
+
+- Fixed append mode behavior in `append_mode_001`:
+  - Adjusted target content to match actual `e` command behavior (cursor after word, not on last char)
+
+### Performance
+
+- Filtering 1000 scenarios: ~50-200 µs (well under 1ms budget)
+- Sorting 1000 scenarios: ~100-400 µs depending on sort mode
+- Zero overhead for scenarios without metadata (backward compatible)
+
+### Security
+
+- Added `walkdir = "2.5"` dev-dependency for safe directory traversal in tests
+- All scenario validation tests run with bounds checking
+
+### Tests
+
+- Added 16 comprehensive unit tests for `ScenarioCollection`
+- Added 2 integration tests for scenario validation
+- Total test count: 392 (all passing)
+- Zero clippy warnings
+
 ## [0.1.3] - 2025-11-28
 
 ### Fixed
@@ -240,7 +325,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
-[Unreleased]: https://github.com/bug-ops/helix-trainer/compare/v0.1.2...HEAD
+[Unreleased]: https://github.com/bug-ops/helix-trainer/compare/v0.1.4...HEAD
+[0.1.4]: https://github.com/bug-ops/helix-trainer/compare/v0.1.3...v0.1.4
+[0.1.3]: https://github.com/bug-ops/helix-trainer/compare/v0.1.2...v0.1.3
 [0.1.2]: https://github.com/bug-ops/helix-trainer/compare/v0.1.1...v0.1.2
 [0.1.1]: https://github.com/bug-ops/helix-trainer/compare/v0.1.0...v0.1.1
 [0.1.0]: https://github.com/bug-ops/helix-trainer/releases/tag/v0.1.0

Cargo.lock

@@ -1,6 +1,6 @@
 [package]
 name = "helix-trainer"
-version = "0.1.3"
+version = "0.1.4"
 edition = "2024"
 rust-version = "1.85"
 authors = ["Andrei G <andrei.g@my.com>"]

Cargo.toml

@@ -4,6 +4,7 @@
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
 [![Rust](https://img.shields.io/badge/rust-1.85+-orange.svg)](https://www.rust-lang.org)
 [![Release](https://img.shields.io/github/v/release/bug-ops/helix-trainer)](https://github.com/bug-ops/helix-trainer/releases/latest)
+[![Version](https://img.shields.io/badge/version-0.1.4-blue)](https://github.com/bug-ops/helix-trainer/releases/tag/v0.1.4)
 
 **Master Helix editor keybindings through scientifically-optimized spaced repetition and gamified training.**
 
@@ -23,10 +24,12 @@ Stop learning commands in isolation. Train real development workflows with FSRS-
 - 🎯 **Daily Quest System** — Duolingo-style challenges with streak tracking
 - 📊 **Scenario Mastery** — Three-tier progression (Learning → Proficient → Mastered) with graduated XP scaling
 - 🛡️ **Anti-Farming Protection** — Session penalties prevent XP exploitation
+- 🔍 **Smart Scenario Discovery** — Filter by category, difficulty, commands, or completion status with 6 sort modes
+- 📋 **Rich Metadata** — Every scenario tagged with category, difficulty, taught commands, and practice focus
 - ⚡ **Real Helix Accuracy** — Uses official `helix-core` library (v25.07.1)
 - 🎮 **31 Commands** — Movement, editing, clipboard, undo/redo, repeat
 - 🔒 **100% Offline** — No cloud, no tracking, all data stays local (`~/.config/helix-trainer/`)
-- 📚 **20 Training Scenarios** — From basics to intermediate workflows
+- 📚 **25 Training Scenarios** — From basics to intermediate workflows with difficulty indicators
 
 ---
 
@@ -44,15 +47,15 @@ Download for your platform from [**Releases**](https://github.com/bug-ops/helix-
 
 ```bash
 # GNU libc (most distributions)
-wget https://github.com/bug-ops/helix-trainer/releases/latest/download/helix-trainer-v0.1.3-x86_64-unknown-linux-gnu.tar.gz
-tar -xzf helix-trainer-v0.1.3-x86_64-unknown-linux-gnu.tar.gz
-cd helix-trainer-v0.1.3-x86_64-unknown-linux-gnu
+wget https://github.com/bug-ops/helix-trainer/releases/latest/download/helix-trainer-v0.1.4-x86_64-unknown-linux-gnu.tar.gz
+tar -xzf helix-trainer-v0.1.4-x86_64-unknown-linux-gnu.tar.gz
+cd helix-trainer-v0.1.4-x86_64-unknown-linux-gnu
 ./helix-trainer
 
 # musl (Alpine Linux, static binary)
-wget https://github.com/bug-ops/helix-trainer/releases/latest/download/helix-trainer-v0.1.3-x86_64-unknown-linux-musl.tar.gz
-tar -xzf helix-trainer-v0.1.3-x86_64-unknown-linux-musl.tar.gz
-cd helix-trainer-v0.1.3-x86_64-unknown-linux-musl
+wget https://github.com/bug-ops/helix-trainer/releases/latest/download/helix-trainer-v0.1.4-x86_64-unknown-linux-musl.tar.gz
+tar -xzf helix-trainer-v0.1.4-x86_64-unknown-linux-musl.tar.gz
+cd helix-trainer-v0.1.4-x86_64-unknown-linux-musl
 ./helix-trainer
 ```
 </details>
@@ -62,15 +65,15 @@ cd helix-trainer-v0.1.3-x86_64-unknown-linux-musl
 
 ```bash
 # GNU libc
-wget https://github.com/bug-ops/helix-trainer/releases/latest/download/helix-trainer-v0.1.3-aarch64-unknown-linux-gnu.tar.gz
-tar -xzf helix-trainer-v0.1.3-aarch64-unknown-linux-gnu.tar.gz
-cd helix-trainer-v0.1.3-aarch64-unknown-linux-gnu
+wget https://github.com/bug-ops/helix-trainer/releases/latest/download/helix-trainer-v0.1.4-aarch64-unknown-linux-gnu.tar.gz
+tar -xzf helix-trainer-v0.1.4-aarch64-unknown-linux-gnu.tar.gz
+cd helix-trainer-v0.1.4-aarch64-unknown-linux-gnu
 ./helix-trainer
 
 # musl
-wget https://github.com/bug-ops/helix-trainer/releases/latest/download/helix-trainer-v0.1.3-aarch64-unknown-linux-musl.tar.gz
-tar -xzf helix-trainer-v0.1.3-aarch64-unknown-linux-musl.tar.gz
-cd helix-trainer-v0.1.3-aarch64-unknown-linux-musl
+wget https://github.com/bug-ops/helix-trainer/releases/latest/download/helix-trainer-v0.1.4-aarch64-unknown-linux-musl.tar.gz
+tar -xzf helix-trainer-v0.1.4-aarch64-unknown-linux-musl.tar.gz
+cd helix-trainer-v0.1.4-aarch64-unknown-linux-musl
 ./helix-trainer
 ```
 </details>
@@ -80,15 +83,15 @@ cd helix-trainer-v0.1.3-aarch64-unknown-linux-musl
 
 ```bash
 # Apple Silicon (M1/M2/M3/M4)
-curl -LO https://github.com/bug-ops/helix-trainer/releases/latest/download/helix-trainer-v0.1.3-aarch64-apple-darwin.tar.gz
-tar -xzf helix-trainer-v0.1.3-aarch64-apple-darwin.tar.gz
-cd helix-trainer-v0.1.3-aarch64-apple-darwin
+curl -LO https://github.com/bug-ops/helix-trainer/releases/latest/download/helix-trainer-v0.1.4-aarch64-apple-darwin.tar.gz
+tar -xzf helix-trainer-v0.1.4-aarch64-apple-darwin.tar.gz
+cd helix-trainer-v0.1.4-aarch64-apple-darwin
 ./helix-trainer
 
 # Intel
-curl -LO https://github.com/bug-ops/helix-trainer/releases/latest/download/helix-trainer-v0.1.3-x86_64-apple-darwin.tar.gz
-tar -xzf helix-trainer-v0.1.3-x86_64-apple-darwin.tar.gz
-cd helix-trainer-v0.1.3-x86_64-apple-darwin
+curl -LO https://github.com/bug-ops/helix-trainer/releases/latest/download/helix-trainer-v0.1.4-x86_64-apple-darwin.tar.gz
+tar -xzf helix-trainer-v0.1.4-x86_64-apple-darwin.tar.gz
+cd helix-trainer-v0.1.4-x86_64-apple-darwin
 ./helix-trainer
 ```
 </details>
@@ -97,8 +100,8 @@ cd helix-trainer-v0.1.3-x86_64-apple-darwin
 <summary><b>Windows</b></summary>
 
 Download from [Releases page](https://github.com/bug-ops/helix-trainer/releases/latest):
-- **x86_64**: `helix-trainer-v0.1.3-x86_64-pc-windows-msvc.zip`
-- **ARM64**: `helix-trainer-v0.1.3-aarch64-pc-windows-msvc.zip`
+- **x86_64**: `helix-trainer-v0.1.4-x86_64-pc-windows-msvc.zip`
+- **ARM64**: `helix-trainer-v0.1.4-aarch64-pc-windows-msvc.zip`
 
 Extract and run `helix-trainer.exe`
 </details>
@@ -239,6 +242,17 @@ Duolingo-proven mechanics:
 - Repeat command (`.`) for efficient workflows
 - 164 passing tests, zero clippy warnings
 
+### ✅ Phase 1.5: Scenario Metadata & Discovery (COMPLETE - v0.1.4)
+
+- Rich metadata system (category, difficulty, tags, taught commands)
+- Flexible filtering (category, difficulty, commands, completion status)
+- Six sort modes (alphabetical, difficulty, category, completion, recent, random)
+- Visual indicators (🟢 Beginner / 🟡 Intermediate / 🔴 Advanced + ✅ completed)
+- 25 fully categorized scenarios (Movement: 5, Editing: 11, Clipboard: 3, Advanced: 6)
+- Performance benchmarks for filtering/sorting (<1ms for 1000 scenarios)
+- Automated scenario validation tests
+- 392 passing tests, zero clippy warnings
+
 ### 🔄 Phase 2: Workflow Simulator (Planned - 6+ months)
 
 The flagship feature that makes Helix Trainer unique:
@@ -265,8 +279,9 @@ The flagship feature that makes Helix Trainer unique:
 **Project Metrics**:
 - **Language**: Rust 2024 Edition
 - **MSRV**: 1.85
-- **Lines of Code**: ~5,759
-- **Tests**: 164 (all passing)
+- **Lines of Code**: ~7,200
+- **Tests**: 392 (all passing)
+- **Scenarios**: 25 (fully categorized with metadata)
 - **Binary Size**: ~3MB (release mode)
 - **Build Time**: ~1.5-2s (incremental, with sccache)
 
@@ -398,9 +413,9 @@ Licensed under MIT — see [LICENSE](LICENSE) for details.
 
 ```bash
 # Download and run
-wget https://github.com/bug-ops/helix-trainer/releases/latest/download/helix-trainer-v0.1.3-x86_64-unknown-linux-gnu.tar.gz
-tar -xzf helix-trainer-v0.1.3-x86_64-unknown-linux-gnu.tar.gz
-cd helix-trainer-v0.1.3-x86_64-unknown-linux-gnu
+wget https://github.com/bug-ops/helix-trainer/releases/latest/download/helix-trainer-v0.1.4-x86_64-unknown-linux-gnu.tar.gz
+tar -xzf helix-trainer-v0.1.4-x86_64-unknown-linux-gnu.tar.gz
+cd helix-trainer-v0.1.4-x86_64-unknown-linux-gnu
 ./helix-trainer
 ```