Versioning and changelog created

CHANGELOG.md

@@ -0,0 +1,38 @@
+# Changelog
+
+All notable changes to this project are documented in this file.
+
+This project uses [Semantic Versioning](https://semver.org/) beginning with version `v0.1.7-alpha.2` (or `v0.1.7-beta.1`).  
+Earlier releases (`v0.1.0-alpha.1` to `v0.1.7-alpha.1`) were experimental and do not strictly follow SemVer conventions.
+
+---
+
+## [v0.1.7-alpha.2] - YYYY-MM-DD
+
+### Changed
+
+- **Adopted proper SemVer pre-release flow:** All future releases will follow `alpha.n → beta.n → rc.n → stable`.
+- **Stability commitment:** This release marks the beginning of structured, progressive versioning and a focus on stability.
+- **Changelog and versioning policy:** Added `CHANGELOG.md` and `VERSIONING.md` to document release history and policy.
+- **(List any new features, bug fixes, or improvements here)**
+
+---
+
+## Legacy Experimental Releases
+
+These were single-shot development releases with no progressive alpha/beta cycle.
+
+| Version Tag      | Notes                                     |
+| ---------------- | ----------------------------------------- |
+| `v0.1.0-alpha.1` | Initial experimental release              |
+| `v0.1.1-alpha.1` | Feature/bug updates without SemVer phases |
+| `v0.1.2-alpha.1` | Same as above                             |
+| `v0.1.3-alpha.1` | —                                         |
+| `v0.1.4-alpha.1` | —                                         |
+| `v0.1.5-alpha.1` | —                                         |
+| `v0.1.6-alpha.1` | —                                         |
+| `v0.1.7-alpha.1` | Final experimental/unstable release       |
+
+---
+
+**From v0.1.7-alpha.2 onward, all releases will follow a structured, progressive SemVer pre-release cycle.**

VERSIONING.md

@@ -0,0 +1,43 @@
+# Versioning Policy
+
+This project follows [Semantic Versioning 2.0.0](https://semver.org/), starting from version `v0.1.8-alpha.1`.
+
+---
+
+## 🧪 Pre-release lifecycle
+
+Each version progresses through the following phases:
+
+vX.Y.Z-alpha.n → vX.Y.Z-beta.n → vX.Y.Z-rc.n → vX.Y.Z
+
+| Stage  | Tag Example      | Purpose                                     |
+| ------ | ---------------- | ------------------------------------------- |
+| Alpha  | `v0.2.0-alpha.1` | Early development, unstable, features added |
+| Beta   | `v0.2.0-beta.1`  | Feature complete, internal/external testing |
+| RC     | `v0.2.0-rc.1`    | Ready for release, final polish             |
+| Stable | `v0.2.0`         | Production-ready release                    |
+
+---
+
+## 📦 Legacy Pre-SemVer Releases
+
+The following tags were used during the early development phase and do **not follow** progressive SemVer conventions:
+
+v0.1.0-alpha.1
+v0.1.1-alpha.1
+v0.1.2-alpha.1
+v0.1.3-alpha.1
+v0.1.4-alpha.1
+v0.1.5-alpha.1
+v0.1.6-alpha.1
+v0.1.7-alpha.1
+
+These were considered one-shot alpha builds during initial experimentation. They remain frozen in GitHub history for archival purposes.
+
+---
+
+## 🏁 First SemVer-compliant tag
+
+v0.1.7-alpha.2
+
+This tag marks the transition to proper SemVer pre-release flow and consistent versioning practices.