feat: escrow partial release, portfolio analytics, team collaboration, review moderation (#601-604)

[a-malik-gh]

Summary

This PR implements all four issues assigned to a-malik-gh.

Closes #601
Closes #602
Closes #603
Closes #604

---

#601 – Escrow Partial Release for Milestone-Based Work

Files: contracts/escrow/src/lib.rs, contracts/escrow/src/storage.rs, contracts/escrow/src/tests.rs, contracts/escrow/src/storage_edge_tests.rs

• Added partial_release(commission_id, release_amount, config_contract): releases a fixed amount from a Locked or PartiallyReleased escrow to the artist (minus platform fee split). Transitions to Released when the full amount has been paid out.
• Added auto_release_on_deadline(commission_id, auto_release_ledger, config_contract): releases the remaining balance automatically once the ledger sequence meets or exceeds auto_release_ledger.
• Added PartiallyReleased = 5 variant to CommissionStatus enum.
• Added released_amount: i128 field to EscrowRecord to track cumulative partial releases.
• All operations follow CEI ordering and are protected by the re-entrancy guard.
• Overflow-safe arithmetic (checked_add, checked_sub, checked_mul) throughout.
• Tests cover: state machine transitions, fee split calculations, deadline boundary, amount validation, and end-to-end partial → full release flow.

#602 – Portfolio Analytics Contract

Files: contracts/analytics/ (new package)

• record_earning: tracks earnings per category and client, increments completed_count, appends a paginated EarningsRecord.
• record_cancellation: increments cancelled_count for completion rate calculation.
• record_response_time: rolling sum for average response-time analytics.
• record_satisfaction: score_x10 (range 10–50) rolling average for satisfaction trends.
• predict_earnings: returns mean payout per commission as an earnings forecast.
• Read functions: get_metrics, get_completion_rate, get_avg_response_time, get_avg_satisfaction, get_earning, get_earning_count.
• Admin-only write operations; data retained for ~90 days (ANALYTICS_TTL_LEDGERS).
• Full test suite covering all five acceptance criteria.

#603 – Team Collaboration Features

Files: contracts/commission_agreement/src/lib.rs, contracts/commission_agreement/src/types.rs, contracts/commission_agreement/src/errors.rs, contracts/commission_agreement/src/test.rs

• invite_team_member: lead artist invites members with TeamRole (Lead/Contributor/Viewer), payment_share_bps (cumulative cap at 10 000 bps), dedup, max 10 members.
• accept_team_invitation / decline_team_invitation: only the invited member can act on their own Pending invitation.
• update_contribution_note: member or lead artist can update the contribution description.
• get_team_members: returns the full team list for a commission.
• New types: TeamRole, InvitationStatus, TeamMember.
• New errors: MemberAlreadyExists, PaymentShareExceeded, InvalidInvitationStatus, TeamSizeLimit.
• Tests cover: invite, duplicate guard, share cap, accept, decline, role assignment, empty team, and status guard.

#604 – Review Moderation & Appeal System

Files: contracts/reputation/ (new package)

• submit_review: rating_x10 range 10–50, dedup by review_id, reviewer auth required.
• report_review: reason enum (Spam/Abuse/Misleading/Other), dedup by reporter+review_id, transitions review → UnderReview, adds to admin moderation queue.
• moderate_review: admin-only, sets Removed or Cleared, appends a ModerationRecord to decision history.
• file_appeal: only the affected artist or original reviewer may appeal a Removed review; one appeal per review enforced.
• resolve_appeal: Upheld reinstates the review to Active; Denied leaves it Removed.
• escalate_appeal: marks appeal Escalated for the external dispute arbiter.
• Full test suite covering all five acceptance criteria.

---

Code Quality

• 0 compiler errors, 0 warnings on cargo build
• Removed 3 unnecessary mut bindings in commission_agreement/lib.rs
• Wrapped escrow/integration_tests under #[cfg(test)]
• Added #[allow(dead_code)] on get_suggestion helpers (public introspection API, consumed by SDK/frontend)

Testing

cargo build passes cleanly. Unit tests are written and structured for all four contracts. The cargo test runner is blocked environment-wide by a pre-existing ed25519-dalek version conflict in soroban-env-host (not introduced by this PR — affects all packages in the workspace equally).

[drips-wave]

@a-malik-gh Great news! 🎉 Based on an automated assessment of this PR, the linked Wave issue(s) no longer count against your application limits.

You can now already apply to more issues while waiting for a review of this PR. Keep up the great work! 🚀

Learn more about application limits