ipor-fusion 4.0.0.dev291__tar.gz → 4.0.0.dev293__tar.gz

{ipor_fusion-4.0.0.dev291 → ipor_fusion-4.0.0.dev293}/AGENTS.md

@@ -154,6 +154,15 @@ the lifecycle matrix follows that.
   `commit-lint.yml` fails a PR whose commit subjects or title break it. Never
   hand-bump `project.version`; the release workflow stamps it and re-locks
   `uv.lock`.
+- Preview features (`ipor_fusion.crosschain` with its subpackages, and
+  `ipor_fusion.hypercore`) keep no backward compatibility: they follow the
+  current official contracts only, and support for retired deployments (the
+  pilot executors and factories, canaries) is removed rather than kept beside
+  them. From 4.1 on, a breaking change confined to them ships as `feat`/`fix`
+  without `!` or a `BREAKING CHANGE:` footer, so it never forces a major
+  release; anything it changes outside those packages (the top level, the
+  `vault info` document, the CLI and MCP) is still breaking by the usual rules.
+  4.0 itself keeps its MIGRATION_4.md entries for them, for 3.x users.
 - This repository is public, and commit messages also ship in `CHANGELOG.md`
   inside the wheel. No issue-tracker keys (`IL-` plus a number), internal hosts,
   dashboard links or private repository names in commits, branch names, PR
@@ -207,7 +216,8 @@ the lifecycle matrix follows that.
   path. Adding or removing a
   name updates the snapshots in `tests/test_public_api.py` (every `__all__`, and
   the names each public module keeps by path); moving a name out of a public
-  module leaves a re-export there. A removal or rename is a breaking change.
+  module leaves a re-export there. A removal or rename is a breaking change,
+  except inside a preview package (see Conventions).
   A project type used in a public signature or field is exported too
   (`tests/test_public_type_reachability.py`). The package is `py.typed`, so public APIs stay fully
   annotated.

{ipor_fusion-4.0.0.dev291 → ipor_fusion-4.0.0.dev293}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: ipor-fusion
-Version: 4.0.0.dev291
+Version: 4.0.0.dev293
 Summary: The IPOR Fusion SDK for Python
 Project-URL: homepage, https://ipor.io
 Project-URL: repository, https://github.com/IPOR-Labs/ipor-fusion.py
@@ -418,7 +418,8 @@ release; adding one does not.
 - **Preview features** (`PREVIEW_FEATURES` in `ipor_fusion.about`) export only
   from their own subpackages, `ipor_fusion.crosschain` (with `crosschain.fuses`,
   `crosschain.ccip` and `crosschain.stargate`) and `ipor_fusion.hypercore`, never
-  from the top level, and may change in a minor release. Their exception classes
+  from the top level, and keep no backward compatibility: a minor release may
+  change or remove them (see [Preview features](#preview-features-ipor_fusioncrosschain-ipor_fusionhypercore)). Their exception classes
   stay in `ipor_fusion.errors`, and the `vault info` document's HyperCore blocks
   (`HyperCoreJson`, ...) stay with the document.
 - **Third-party types** are not re-exported: import `ChecksumAddress` and
@@ -488,7 +489,10 @@ Fuse.method()  -->  FuseAction  -->  PlasmaVault.execute([actions])  -->  Call
 ### Preview features (`ipor_fusion.crosschain`, `ipor_fusion.hypercore`)
 
 Not production (see the note at the top) and outside the stable top level:
-import these from their subpackage, and expect changes in a minor release.
+import these from their subpackage. They track the current official contracts
+only, with no backward compatibility: from 4.1 on, a minor release may change or
+remove any of these names and drops support for retired deployments (such as
+the pilot executors and factories). Pin an exact version if you depend on them.
 
 | Name | Purpose |
 |------|---------|

{ipor_fusion-4.0.0.dev291 → ipor_fusion-4.0.0.dev293}/README.md

@@ -369,7 +369,8 @@ release; adding one does not.
 - **Preview features** (`PREVIEW_FEATURES` in `ipor_fusion.about`) export only
   from their own subpackages, `ipor_fusion.crosschain` (with `crosschain.fuses`,
   `crosschain.ccip` and `crosschain.stargate`) and `ipor_fusion.hypercore`, never
-  from the top level, and may change in a minor release. Their exception classes
+  from the top level, and keep no backward compatibility: a minor release may
+  change or remove them (see [Preview features](#preview-features-ipor_fusioncrosschain-ipor_fusionhypercore)). Their exception classes
   stay in `ipor_fusion.errors`, and the `vault info` document's HyperCore blocks
   (`HyperCoreJson`, ...) stay with the document.
 - **Third-party types** are not re-exported: import `ChecksumAddress` and
@@ -439,7 +440,10 @@ Fuse.method()  -->  FuseAction  -->  PlasmaVault.execute([actions])  -->  Call
 ### Preview features (`ipor_fusion.crosschain`, `ipor_fusion.hypercore`)
 
 Not production (see the note at the top) and outside the stable top level:
-import these from their subpackage, and expect changes in a minor release.
+import these from their subpackage. They track the current official contracts
+only, with no backward compatibility: from 4.1 on, a minor release may change or
+remove any of these names and drops support for retired deployments (such as
+the pilot executors and factories). Pin an exact version if you depend on them.
 
 | Name | Purpose |
 |------|---------|

{ipor_fusion-4.0.0.dev291 → ipor_fusion-4.0.0.dev293}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "ipor-fusion"
-version = "4.0.0.dev291"
+version = "4.0.0.dev293"
 description = "The IPOR Fusion SDK for Python"
 authors = [
     { name = "Adam Mydlarz", email = "amydlarz@gmail.com" },

{ipor_fusion-4.0.0.dev291 → ipor_fusion-4.0.0.dev293}/src/ipor_fusion/about.py

@@ -41,7 +41,8 @@ PREVIEW_FEATURES: tuple[PreviewFeature, ...] = (
 PREVIEW_STATEMENT = (
     "Preview, not production: the contracts are under active development, the "
     "mainnet deployments are a proof of concept and IPOR Labs canaries, and "
-    "interfaces may change between minor versions."
+    "interfaces may change or be removed between minor versions, with no "
+    "backward compatibility."
 )
 
 _DISTRIBUTION = "ipor-fusion"

{ipor_fusion-4.0.0.dev291 → ipor_fusion-4.0.0.dev293}/src/ipor_fusion/mcp/models.py

@@ -1176,8 +1176,9 @@ class PreviewFeatureModel(_Base):
         default="preview",
         description="Always 'preview': not production. The contracts are under "
         "active development, the mainnet deployments are a proof of concept "
-        "and IPOR Labs canaries, and interfaces may change between minor "
-        "versions. Route no production capital through these features.",
+        "and IPOR Labs canaries, and interfaces may change or be removed "
+        "between minor versions, with no backward compatibility. Route no "
+        "production capital through these features.",
     )