Skip to content

Release/v0.2.0 - #10

Merged
dieselxxx merged 5 commits into
masterfrom
release/v0.2.0
Aug 31, 2026
Merged

dieselxxx merged 5 commits into
masterfrom
release/v0.2.0

Conversation

@dieselxxx

Copy link
Copy Markdown
Contributor

🔖 Release Pull Request

Version

  • Release version: v0.2.0

Related Branches

  • Release branch: release/v0.2.0
  • Target branch:
    • develop
    • master

Description

Add the new DecimalEngine arbitrary-precision decimal arithmetic engine and update the project version badge in the README.

Release Overview

Included Changes

  • Added DecimalEngine for arbitrary-precision decimal arithmetic using string-based calculations.
  • Added decimal arithmetic operations:
    • Addition
    • Subtraction
    • Multiplication
    • Division
  • Added decimal rounding with eight rounding modes.
  • Added decimal number and scale validation.
  • Added comprehensive unit tests covering arithmetic, rounding, validation, division by zero, and scale handling.
  • Updated the version badge in README.md.
  • Updated the changelog for v0.2.0.

Pre-release Verification

  • Changelog completed:
    • Yes
  • Documentation updated:
    • Yes

Testing & Validation

System Validation

  • All unit tests pass
  • All integration tests pass
  • Core modules verified
  • Adapter modules verified
  • CI/CD pipelines are successful

Release Readiness

  • No critical bugs open
  • No blocking issues remaining
  • Performance checks completed

Versioning

  • Semantic Versioning compliance:

    • Major
    • Minor
    • Patch
  • Tagging:

    • Release tag v0.2.0 will be created

Deployment

  • Target environment:

    • Staging
    • Production
  • Deployment notes:

  • Merge the release branch into master.

    • Create and push the v0.2.0 release tag.
    • Publish the v0.2.0 package release.

Checklist

  • CHANGELOG.md updated
  • README.md updated (if needed)
  • Version bumped correctly
  • All tests passing
  • CI/CD pipelines green
  • Release branch merged correctly
  • Release tag created

Risks / Impact

  • Risk level:
    • None
    • Low
    • Medium
    • High

Potential Risks

  • Breaking changes:

    • No breaking changes are expected.
  • Deployment risks:

    • Low. The release primarily adds new decimal arithmetic functionality without changing existing public behavior.
  • Rollback considerations:

    • Revert the v0.2.0 release and restore the previous stable version if a critical regression is discovered.
  • Deployment risks:

  • Rollback considerations:

Notes

Release Notes

  • DecimalEngine introduces arbitrary-precision decimal arithmetic without relying on floating-point arithmetic or external arbitrary-precision extensions.
  • Supports addition, subtraction, multiplication, and division.
  • Supports configurable decimal precision and eight rounding modes.
  • Includes extensive automated test coverage for arithmetic and rounding behavior.

Deployment Instructions

  • Merge release/v0.2.0 into master.
  • Create the v0.2.0 Git tag from the release commit.
  • Push the tag and publish the release.

Known Issues

  • None known at release time.

dieselxxx and others added 4 commits August 31, 2026 10:38
**Details:**
- Introduced `Add`, `Subtract`, `Multiply`, `Divide`, and `Round` methods as individual traits in `FireHub\Runtime\Math\Decimal` for arbitrary-precision decimal arithmetic.
- Added implementation for core operations: addition, subtraction, multiplication, division (with scale support), and rounding.
- Comprehensive use of PHPDoc annotations to ensure clarity, type safety, and IDE support.
- Included unit tests in `DecimalEngineTest` to verify the correctness of all operations:
  - Extensive test cases for edge scenarios like negative numbers, fractional numbers, and invalid inputs.
  - Built-in exceptions tested for invalid scale values and division by zero.
- Updated `CHANGELOG.md` with version `v0.1.5` to document fixes and new feature integration.

This feature greatly extends mathematical functionality while ensuring reliability and clarity through rigorous testing and documentation.
**Details:**
- Corrected the square bracket mismatch in the header for version `v0.1.0` to ensure proper formatting.
- No changes to content; improves readability and consistency in the changelog structure.
**Details:**
- Updated `CHANGELOG.md` with a new section for version `v0.2.0`, released on `2026-08-31`.
- Documented the addition of the `DecimalEngine` enum.
- Ensures changelog reflects latest changes for better version tracking and transparency.
Updated README.md to reflect changes in repository purpose, branch information, and added various badges for better visibility.
@dieselxxx dieselxxx added the type: Maintenance Ongoing upkeep like dependencies, compatibility, and system health. label Aug 31, 2026
@dieselxxx dieselxxx moved this from Todo to Done in 🚩 Triage Aug 31, 2026
@dieselxxx dieselxxx moved this from Backlog to Done in 📌 Core Development: v0 → v1 Aug 31, 2026
@dieselxxx
dieselxxx marked this pull request as ready for review August 31, 2026 08:47
@dieselxxx
dieselxxx requested a review from a team as a code owner August 31, 2026 08:47
@dieselxxx
dieselxxx merged commit 66467d6 into master Aug 31, 2026
7 of 9 checks passed
@dieselxxx
dieselxxx deleted the release/v0.2.0 branch August 31, 2026 08:49
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

type: Maintenance Ongoing upkeep like dependencies, compatibility, and system health.

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

1 participant