Implement Aegis SDK compliance readiness checker

[El-swaggerito]

Description

Difficulty: Expert

Type: Feature

Summary

Implement a compliance readiness checker for investor and admin operations.

Current Behaviour

SDK consumers may not have one reliable way to determine whether an address is eligible for restricted RWA actions.

Expected Behaviour

The SDK should expose a typed readiness result for approved, blocked, revoked, pending, unknown, and unavailable states.

Suggested Implementation

Create readiness types, compliance integration, reason mapping, tests, fixtures, and docs.

Files or Areas Likely Affected

• src/compliance/
• src/investor/
• src/errors/
• src/types/
• tests/
• docs/

Acceptance Criteria

• Compliance readiness checker is implemented.
• Approved, blocked, revoked, pending, unknown, and unavailable states are represented.
• Typed reason codes are included.
• Tests cover major readiness states.
• Docs explain compliance limitations.
• Dashboard integration guidance is included.

Additional Notes

Do not imply legal KYC completion beyond protocol state.

[panditdhamdhere]

I would like work on this