v1.0 is a major refactor focused on strict type safety and cleaner internal architecture. If you are upgrading from a previous release, you'll need to make a few quick adjustments:
Update all project imports to use the new package name:
# Previous Version
import provably
# New Version
import sourcerykit
All configuration environment variable prefixes have been standardized to match the new engine scope:
| Previous Version | New Version | Notes |
|---|---|---|
PROVABLY_API_KEY | SOURCERYKIT_API_KEY | System-wide prefix change |
PROVABLY_ORG_ID | SOURCERYKIT_ORG_ID | System-wide prefix change |
POSTGRES_URL | SOURCERYKIT_POSTGRES_URL | System-wide prefix change |
PROVABLY_RUST_BE_URL and PROVABLY_MCP_URL are now handled automatically by the runtime configuration loader and are no longer required in your local environment files.
Breaking Change: The core data types of the internal tables have shifted from SERIAL integers to UUID identifiers. Upgrading directly from a previous version will cause a structural conflict.
To handle this smoothly, an automated purge script has been integrated directly into the migration sequence. Running the update command will automatically drop the previous tables and initialize the fresh new schemas in a single safe step.
Run the migration engine to update your environment automatically:
alembic upgrade head
Core engine methods have been renamed or restructured for asynchronous clarity and better data flow:
| Previous Version | New Version | Notes |
|---|---|---|
intercept_context(..) | async_intercept_context(..) | Migrated to an async context manager |
configure_indexing() | bootstrap_system() | Renamed for architectural clarity |
| Not Provided | insert_trusted_endpoint() | New method to add trusted endpoints |