feat(stdlib): add timer (Block T), shared timer and time replicated functions

[angelacorte]

No description provided.

[codecov]

Codecov Report

❌ Patch coverage is 59.37500% with 26 lines in your changes missing coverage. Please review.
✅ Project coverage is 65.11%. Comparing base (ac01c02) to head (af21187).

Files with missing lines	Patch %	Lines
...n/kotlin/it/unibo/collektive/stdlib/SharedTimer.kt	62.85%	12 Missing and 1 partial ⚠️
...monMain/kotlin/it/unibo/collektive/stdlib/Timer.kt	0.00%	11 Missing ⚠️
...tlin/it/unibo/collektive/stdlib/TimeReplication.kt	88.23%	2 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##           master     #566      +/-   ##
==========================================
- Coverage   70.10%   65.11%   -5.00%     
==========================================
  Files          27       38      +11     
  Lines         689      943     +254     
  Branches      119      157      +38     
==========================================
+ Hits          483      614     +131     
- Misses        131      242     +111     
- Partials       75       87      +12     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[Copilot]

Pull Request Overview

This PR introduces timer-based functionality to the Collektive standard library, including Block T (timer), shared timer mechanisms, and time-replicated process management. The implementation enables time-aware aggregate programming by providing utilities for synchronized clocks, periodic process replication, and temporal decay mechanisms across distributed devices.

Key changes:

• Adds core timer primitives with configurable decay rates and bounds
• Implements shared clock synchronization across devices to prevent time drift
• Introduces time-replicated process management with automatic replica lifecycle control

Reviewed Changes

Copilot reviewed 7 out of 7 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
collektive-stdlib/src/commonMain/kotlin/it/unibo/collektive/stdlib/Timer.kt	Implements basic timer primitives with decay functions
collektive-stdlib/src/commonMain/kotlin/it/unibo/collektive/stdlib/SharedTimer.kt	Provides shared clock synchronization and distributed timer management
collektive-stdlib/src/commonMain/kotlin/it/unibo/collektive/stdlib/TimeReplication.kt	Implements time-based process replication with automatic cleanup
collektive-stdlib/src/commonTest/kotlin/it/unibo/collektive/stdlib/test/SharedClockTest.kt	Tests for shared clock synchronization behavior
collektive-stdlib/src/commonTest/kotlin/it/unibo/collektive/stdlib/test/TimeReplicatedTest.kt	Tests for time-replicated process functionality
collektive-stdlib/build.gradle.kts	Adds kotlinx-datetime dependency
alchemist-incarnation-collektive/src/main/kotlin/it/unibo/alchemist/collektive/device/CollektiveDevice.kt	Changes in-memory flag for device implementation

[Copilot]

The decay parameter in the timer call should be decayRate instead of ZERO. The current implementation will never decay the timer since it passes ZERO as the decay value while the lambda correctly uses decayRate. This should be: timer(timeout, decayRate) { time -> time - decayRate }.

Suggested change

	timer(timeout, ZERO) { time -> time - decayRate }
	timer(timeout, decayRate) { time -> time - decayRate }

[Copilot]

Corrected copyright year from 2025 to 2024 for consistency with other files in the same commit.

Suggested change

	* Copyright (c) 2025, Danilo Pianini, Nicolas Farabegoli, Elisa Tronetti,
	* Copyright (c) 2024, Danilo Pianini, Nicolas Farabegoli, Elisa Tronetti,

[Copilot]

Calling .first() on an empty collection will throw NoSuchElementException if localRep is empty (which can occur when maxReplicas is 0 or on the first execution before any replicas are created). Add a check to handle the empty case or use .firstOrNull() with appropriate default handling.

Suggested change

	}.first()
	}.firstOrNull() ?: process()