docs: Create Version Management Guide and bump versions

- Add `VERSION_MANAGEMENT_GUIDE.md` with comprehensive instructions for updating versions and triggering CI/CD workflows for Android, Desktop, and iOS platforms.
- Update `AI_AGENT_GUIDE.md` and `docs/README.md` to link to the new guide.
- Bump Android version:
    - `versionCode`: 841 → 842
    - `versionName`: "8.4.1" → "8.4.2"
- Bump Desktop version:
    - `packageVersion`: "3.0.0" → "4.0.0"
- Bump iOS version:
    - `MARKETING_VERSION`: 3.0 → 4.0
    - `CFBundleShortVersionString`: "3.0" → "4.0"

Author: softartdev

app/android/build.gradle.kts

@@ -24,8 +24,8 @@ android {
         applicationId = "com.softartdev.noteroom"
         minSdk = libs.versions.minSdk.get().toInt()
         targetSdk = libs.versions.targetSdk.get().toInt()
-        versionCode = 841
-        versionName = "8.4.1"
+        versionCode = 842
+        versionName = "8.4.2"
         testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner"
         testInstrumentationRunnerArguments["clearPackageData"] = "true"
         vectorDrawables.useSupportLibrary = true

app/desktop/build.gradle.kts

@@ -49,7 +49,7 @@ compose.desktop {
         nativeDistributions {
             targetFormats(TargetFormat.Dmg, TargetFormat.Msi, TargetFormat.Deb)
             packageName = "Note Delight"
-            packageVersion = "3.0.0"
+            packageVersion = "4.0.0"
             description = "Note app with encryption"
             copyright = "© 2023 SoftArtDev"
             macOS.iconFile.set(project.file("src/jvmMain/resources/app_icon.icns"))

app/iosApp/iosApp.xcodeproj/project.pbxproj

@@ -473,7 +473,7 @@
 					"$(inherited)",
 					"@executable_path/Frameworks",
 				);
-				MARKETING_VERSION = 3.0;
+				MARKETING_VERSION = 4.0;
 				OTHER_LDFLAGS = (
 					"$(inherited)",
 					"-ObjC",
@@ -514,7 +514,7 @@
 					"$(inherited)",
 					"@executable_path/Frameworks",
 				);
-				MARKETING_VERSION = 3.0;
+				MARKETING_VERSION = 4.0;
 				OTHER_LDFLAGS = (
 					"$(inherited)",
 					"-ObjC",

app/iosApp/iosApp/Info.plist

@@ -22,7 +22,7 @@
 	<key>CFBundlePackageType</key>
 	<string>$(PRODUCT_BUNDLE_PACKAGE_TYPE)</string>
 	<key>CFBundleShortVersionString</key>
-	<string>3.0</string>
+	<string>4.0</string>
 	<key>CFBundleVersion</key>
 	<string>17</string>
 	<key>LSRequiresIPhoneOS</key>

docs/AI_AGENT_GUIDE.md

@@ -19,6 +19,21 @@ This guide is specifically written for AI agents working on the NoteDelight code
 ./gradlew :app:web:wasmJsBrowserDevelopmentRun --continuous  # Web app
 ```
 
+### Version Management Quick Reference
+
+```bash
+# Update versions in all platform files, then:
+git add app/*/build.gradle.kts app/iosApp/iosApp.xcodeproj/project.pbxproj app/iosApp/iosApp/Info.plist
+git commit -m "chore: bump version to X.Y.Z"
+
+# Trigger CI/CD workflows:
+git tag android/vX.Y.Z && git push origin android/vX.Y.Z
+git tag desktop/vX.Y.Z && git push origin desktop/vX.Y.Z  
+git tag ios/vX.Y.Z && git push origin ios/vX.Y.Z
+```
+
+**See [VERSION_MANAGEMENT_GUIDE.md](VERSION_MANAGEMENT_GUIDE.md) for detailed instructions.**
+
 ## Understanding the Codebase
 
 ### Module Hierarchy (Dependency Order)
@@ -528,6 +543,7 @@ Tests often show how to use code correctly. Look at:
 - **Architecture**: [ARCHITECTURE.md](ARCHITECTURE.md)
 - **Contributing**: [CONTRIBUTING.md](../CONTRIBUTING.md)
 - **Testing**: [TESTING_GUIDE.md](TESTING_GUIDE.md)
+- **Version Management**: [VERSION_MANAGEMENT_GUIDE.md](VERSION_MANAGEMENT_GUIDE.md)
 
 ## Quick Decision Tree
 

docs/README.md

@@ -50,6 +50,7 @@ Each module has its own detailed README.md:
 - **Development & Code Style** → [CONTRIBUTING.md](../CONTRIBUTING.md)
 - **Testing** → [TESTING_GUIDE.md](TESTING_GUIDE.md)
 - **AI Agent Tasks** → [AI_AGENT_GUIDE.md](AI_AGENT_GUIDE.md)
+- **Version Management & CI/CD** → [VERSION_MANAGEMENT_GUIDE.md](VERSION_MANAGEMENT_GUIDE.md)
 - **Platform-Specific** → Module READMEs in `app/` directories
 - **Data & Persistence** → Module READMEs in `core/data/` directories