[AgentX010]

Overview

This PR adds the deprecation flow for creator keys: the creator can initiate deprecation, holders get a time-boxed migration window to exit at a guaranteed floor price, and finalization permanently halts key operations. The changes are limited to event definitions and the key freeze module.

Related Issue

Closes #AGENT-DEPRECATION

Changes

🔒 Deprecation Lifecycle

• [MODIFY] creator-keys/src/events.rs

  • Adds the KeyDeprecated event emitted when deprecate(key_id, migration_window_seconds) initiates deprecation.

• [MODIFY] creator-keys/src/key_freeze.rs

  • Adds deprecation state handling: captures floor_price from the bonding curve at initiation and stores it immutably alongside the window expiry.
  • Supports exit_deprecating(key_id) during the window, paying out the stored floor price, and rejects calls after expiry with DeprecationWindowClosed.
  • finalize_deprecation(key_id) permanently halts buy, sell, and transfer for the key.
  • get_deprecation_status(key_id) exposes status, floor price, and window expiry.

Verification Results

Not run in this PR beyond the manual review of the changed files; no new test files were added in this change set.

Acceptance Criteria	Status
floor_price stored correctly at deprecation initiation block	✅ Captured and stored immutably at initiation
exit_deprecating pays correct floor price during window	✅ Pays stored floor price to caller
Exits after window closes revert with DeprecationWindowClosed	✅ Enforced in key_freeze.rs
finalize_deprecation halts buy, sell, and transfer permanently	✅ Halts all three operations
get_deprecation_status returns accurate status and expiry at any point	✅ Reports status, floor price, and expiry

Closes #1181