Workflow
- Analyze Commits & Bump Version
- Retrieve commits since the latest version tag
- Determine the next semantic version
- Bump it in all relevant manifests
- Generate Changelog
- Keep only user-facing changes
- Write a polished entry following the Changelog Guidelines and prepend it to
CHANGELOG.md
- Review
- Ask the user for edits or to proceed
- If the user requests edits, apply them and ask again
- Commit & Tag
- On confirmation, run:
git add -Agit commit -m "chore(release): <NEW_TAG>"git tag <NEW_TAG> -m ""
Changelog Guidelines
Template
##   ` 🏷️ v<new_version> `
###   <emoji> <Category>
- **<Short summary>**: <concise description, optionally with sub-bullets>. [🡥](<commit_url>) [#<issue_number>](<issue_url>)
#####    [Commit log](<repo_url>/compare/<old_tag>...<new_tag>)  •  <Mon D, YYYY>
- Group changes by category:
📢 BREAKING CHANGES✨ Features🩹 Fixes⚡ Performance📋 Docs🎨 Style📦 Distribution
- If there is no previous tag (i.e. this is the first release), use
<repo_url>/commits/<new_tag> for the commit log link.
Examples
##   ` 🏷️ v3.2.3 `
###   ✨ Features
- **Auto-scrolling during drag**: the explorer now scrolls automatically when dragging items near the edges. [🡥](https://github.com/kh4f/manual-sorting/commit/4h5i6j7)
- **SVG to ICO conversion**: added an initial `.svg` → `.ico` pipeline that renders at 16/24/32/256 px, encodes the layers as PNG, and assembles them into a single ICO file. [🡥](https://github.com/kh4f/svico/commit/b36cb72)
- **Custom layer sizes**: added the `-s`/`--sizes` option to choose layer sizes (defaults to `16,24,32,256`, validated to the 1–256 range). [🡥](https://github.com/kh4f/svico/commit/75fa69d)
###   🩹 Fixes
- **Fixed RMB drag activation**: holding the right mouse button no longer triggers drag & drop. [🡥](https://github.com/kh4f/manual-sorting/commit/7f1a2b3) [#114](https://github.com/kh4f/manual-sorting/issues/114)
- **Reliable drop zone cleanup**: drop zones now always clear when releasing the mouse, even outside Obsidian or after opening context menus on Mac. [🡥](https://github.com/kh4f/manual-sorting/commit/8c9d0e1) [#115](https://github.com/kh4f/manual-sorting/issues/115) [#116](https://github.com/kh4f/manual-sorting/issues/116)
###   📋 Docs
- **Documented ICO pipeline**: added documentation for the ICO format and the rendering pipeline. [🡥](https://github.com/kh4f/svico/commit/9532ec7)
#####    [Commit log](https://github.com/kh4f/manual-sorting/compare/v3.2.2...v3.2.3)  •  Dec 26, 2025
##   ` 🏷️ v3.2.2 `
###   🩹 Fixes
- **Improved multi-selection dragging**:
- Nested folders no longer escape to the parent level. [🡥](https://github.com/kh4f/manual-sorting/commit/4a5b6c7) [#113](https://github.com/kh4f/manual-sorting/issues/113)
- Prevented accidental nesting of selected items. [🡥](https://github.com/kh4f/manual-sorting/commit/1d2e3f4)
- Disallowed dropping a multi-selection into folders that are part of the same selection. [🡥](https://github.com/kh4f/manual-sorting/commit/9e8d7c6)
- **Refined drop zone behavior**:
- Drop zones no longer appear in default sorting modes. [🡥](https://github.com/kh4f/manual-sorting/commit/0f1e2d3)
- Fixed phantom drop zones appearing near empty folders. [🡥](https://github.com/kh4f/manual-sorting/commit/8a7b6c5)
- **Accurate drag tooltip**: the drag tooltip now always displays the correct target folder name. [🡥](https://github.com/kh4f/manual-sorting/commit/3d4e5f6)
###   🎨 Style
- **Clearer active drop indicator**: improved the visual clarity of the active drop zone for more precise positioning. [🡥](https://github.com/kh4f/manual-sorting/commit/7g8h9i0)
- **Updated drag handle icon**: drag handles now use the more familiar 2×3 dot pattern. [🡥](https://github.com/kh4f/manual-sorting/commit/6b7c8d9)
#####    [Commit log](https://github.com/kh4f/manual-sorting/compare/v3.2.1...v3.2.2)  •  Dec 24, 2025
##   ` 🏷️ v3.0.0 `
###   📢 BREAKING CHANGES
- The settings storage format has been completely redesigned. **Your existing settings, including custom order, will be reset.** [🡥](https://github.com/kh4f/manual-sorting/commit/4l5m6n7)
- The option to **disable dragging has been removed**. [🡥](https://github.com/kh4f/manual-sorting/commit/8o9p0q1)
###   🩹 Fixes
- **Fixed mobile folder expansion**: resolved issues where folders wouldn't open when tapped on mobile. [🡥](https://github.com/kh4f/manual-sorting/commit/2j3k4l5) [#118](https://github.com/kh4f/manual-sorting/issues/118)
- **Enhanced drag boundaries**: drag events now properly handle interactions outside the file explorer. [🡥](https://github.com/kh4f/manual-sorting/commit/0i1j2k3)
- **Fixed keyboard selection issue**: resolved incorrect note highlighting when using keyboard navigation. [🡥](https://github.com/kh4f/manual-sorting/commit/6u7v8w9) [#46](https://github.com/kh4f/manual-sorting/issues/46)
- **Wider touch activation area**: expanded the drag zone width for more reliable dragging on mobile. [🡥](https://github.com/kh4f/manual-sorting/commit/6m7n8o9)
###   ⚡ Performance
- **Smaller ICO files**: PNG layers are now compressed with Oxipng at max compression to shrink the resulting `.ico` size. [🡥](https://github.com/kh4f/svico/commit/9104b4d)
###   📦 Distribution
- **Direct binary in zips**: prebuilt release zips now place the executable at the archive root, so extracting yields `svico` immediately. [🡥](https://github.com/kh4f/svico/commit/0647223)
#####    [Commit log](https://github.com/kh4f/manual-sorting/compare/v2.5.1...v3.0.0)  •  Nov 6, 2025
kh4f