Stable public API with semantic versioning guarantees

[ibrahimcesar]

Finalize and stabilize the public API for 1.0 release.

Goals

• Audit all public types and functions
• Remove or stabilize experimental APIs
• Document stability guarantees
• Semantic versioning commitment

Tasks

• Review all pub items in lib.rs
• Mark experimental features appropriately
• Create API stability documentation
• Set up deprecation policy

Acceptance Criteria

• All public APIs documented
• No breaking changes without major version
• Clear experimental vs stable distinction
• Migration guide for pre-1.0 users