[Abdullahbinmushtaq]

Summary

Finalizes LongCache v1.0.0 and graduates the package from Beta to Production/Stable. This release locks the public API for the 1.x series, guarantees seamless upgrades for existing cache stores, and hardens the release pipeline.

What's Changed

• Stable API Freeze: Promoted all core APIs, backends (SQLite, Redis, Shared Redis, In-Memory), and active integrations (CachedOpenAI, LongCacheMiddleware) to "stable" under a strict 1.x SemVer contract (API_CONTRACT_VERSION = "1.0").
• Clear Pass-Through Warnings: Compatibility wrappers (CachedLLM, CachedChain, CachedQueryEngine, CachedState, streaming helpers) now emit LongCachePassThroughWarning by default so users know when caching is bypassed (can be silenced with warn_passthrough=False).
• Zero-Reset Storage Upgrade: Existing Format-2 SQLite databases and Redis stores upgrade to 1.0.0 directly without data loss or re-indexing.
• Release Provenance & CI: Added CycloneDX 1.5 SBOM generation, PEP 740 PyPI artifact attestations, and gated auto-tagging on passing CI runs.
• Documentation: Added the 1.x SemVer Contract and v1.0 Migration Guide, and updated the README and support matrix for 1.0.0.