v1.0.0 — Initial Stable Release of Maatify SharedCommon

🎉 Initial Stable Release

This is the first stable release of Maatify SharedCommon, a foundational
library providing shared contracts and abstractions used across the Maatify
ecosystem.

The goal of this package is to standardize common cross-cutting concerns such as
time handling, telemetry context, and security event context while keeping
modules framework-agnostic and easily testable.

---

✨ Key Features

• Clock Abstraction

  • ClockInterface for deterministic time handling
  • Default implementation: SystemClock
  • Improves testability by removing direct usage of time() and date()

• Telemetry Context Contract

  • Unified interface for propagating telemetry metadata across modules

• Security Event Context

  • Standardized structure for security-related event information

• Framework-Agnostic Design

  • No dependency on frameworks
  • Can be integrated with any DI container

• Dependency Injection Bindings

  • SharedCommonBindings helper for registering default implementations

---

🏗 Architecture

The module is intentionally minimal and focuses only on shared contracts used
by other Maatify components such as:

• AdminKernel
• Verification
• future infrastructure modules

This ensures consistent behavior across the entire ecosystem.

---

📦 Installation

composer require maatify/shared-common

---

🔧 Requirements

• PHP 8.2+

---

📚 Documentation

Full documentation is available in the project documentation book:

• Architecture overview
• Clock abstraction design
• Integration patterns
• Extension points

See the docs/book directory for details.

---

🔒 Security

If you discover a security issue, please review the project's
Security Policy.

---

📜 License

MIT License.