Add changelog and update packaging metadata

Introduces a CHANGELOG.md file following the Keep a Changelog format. Updates setup.py to append the changelog to the long description for PyPI, bumps the version to 1.0.0, and adds a Changelog link to project URLs.

Author: dirreno

CHANGELOG.md

@@ -0,0 +1,26 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on "Keep a Changelog" (https://keepachangelog.com/en/1.0.0/)
+
+## [Unreleased]
+- Prepare improvements and documentation updates.
+
+## [1.0.0] - 2025-10-22
+### Added
+- Project now includes changelog linked from packaging metadata.
+- Minor documentation updates.
+
+### Fixed
+- Packaging metadata clarified in `setup.py`.
+
+## [0.1.7] - 2024-06-01
+### Added
+- Initial public release notes placeholder.
+
+
+
+## [Unreleased]: https://github.com/harmonize-tools/socio4health/compare/v1.0.0...HEAD
+## [1.0.0]: https://github.com/harmonize-tools/socio4health/compare/v0.1.7...v1.0.0
+## [0.1.7]: https://github.com/harmonize-tools/socio4health/releases/tag/v0.1.7

setup.py

@@ -16,6 +16,17 @@
 with open(path.join(here, 'README.md'), encoding='utf-8') as f:
     long_description = f.read()
 
+# Optionally append the changelog to the long description so PyPI shows it
+changelog_path = path.join(here, 'CHANGELOG.md')
+try:
+    with open(changelog_path, encoding='utf-8') as f:
+        changelog = f.read()
+    # Separate README and changelog with a horizontal rule for readability
+    long_description = long_description + "\n\n---\n\n" + changelog
+except FileNotFoundError:
+    # If changelog is missing, continue without it
+    changelog = None
+
 # Arguments marked as "Required" below must be included for upload to PyPI.
 # Fields marked as "Optional" may be commented out.
 
@@ -28,7 +39,7 @@
     # For a discussion on single-sourcing the version across setup.py and the
     # project code, see
     # https://packaging.python.org/en/latest/single_source_version.html
-    version='0.1.7',  # Required
+    version='1.0.0',  # Required
 
     # This is a one-line description or tagline of what your project does. This
     # corresponds to the "Summary" metadata field:
@@ -203,5 +214,6 @@
     project_urls={  # Optional
         'Bug Reports': 'https://github.com/harmonize-tools/socio4health/issues',
         'Source': 'https://github.com/harmonize-tools/socio4health/',
+        'Changelog': 'https://github.com/harmonize-tools/socio4health/blob/main/CHANGELOG.md',
     },
 )