lean-runtime 2.0.2__tar.gz → 2.0.5__tar.gz

{lean_runtime-2.0.2 → lean_runtime-2.0.5}/CHANGELOG.md

@@ -1,5 +1,27 @@
 # Changelog
 
+## Unreleased
+
+## 2.0.5
+
+- Integrate bounded exact-environment discovery into the `lean-runtime` package.
+- Make `lean-run FILE` discover standalone Mathlib environments automatically when
+  no exact context or pinned Lake project is present.
+- Bundle an initial deterministic catalog for core Lean v4.32.2 and Mathlib
+  v4.32.2, v4.31.0, and v4.30.0, including exact Runtime locks and module inventories.
+- Add `lean_runtime.discovery` for explicit planning, catalog, and authoritative
+  discovery APIs, plus the `lean-runtime-catalog` maintainer command.
+
+Version 2.0.4 was not published because its release tag retained 2.0.3 package
+metadata.
+
+## 2.0.3
+
+- Accept portable-copy symlinks whose normalized targets remain inside the
+  extracted copy, including common links such as `docs/README.md -> ../README.md`.
+- Continue rejecting absolute or escaping symlink targets, duplicate archive
+  members, and later archive writes that traverse an extracted symlink.
+
 ## 2.0.2
 
 - Remove staged environments safely when Git-for-Windows leaves source pack

{lean_runtime-2.0.2 → lean_runtime-2.0.5}/MANIFEST.in

@@ -3,6 +3,7 @@ include mkdocs.yml
 recursive-include docs *.md
 recursive-include examples *.toml
 recursive-include compatibility *.json *.md *.toml
+recursive-include catalog *.json *.toml
 recursive-include scripts *.py
 recursive-include schemas *.json
 recursive-include tests *.py

{lean_runtime-2.0.2/lean_runtime.egg-info → lean_runtime-2.0.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lean-runtime
-Version: 2.0.2
+Version: 2.0.5
 Summary: Run Lean 4 proofs from Python or standalone files
 Author: Alejandro Radisic
 License-Expression: Apache-2.0
@@ -62,13 +62,9 @@ Inside an existing pinned Lake project, just pass the file:
 lean-run MyProject/Main.lean
 ```
 
-For a portable standalone file, declare exact dependencies in TOML frontmatter:
+Standalone files do not need a throwaway Lake project or dependency declaration:
 
 ```lean
--- /// lean-runtime
--- requires = ["mathlib@v4.32.2"]
--- ///
-
 import Mathlib
 
 example : 2 + 2 = 4 := by norm_num
@@ -78,13 +74,38 @@ example : 2 + 2 = 4 := by norm_num
 lean-run Main.lean
 ```
 
+When no explicit context or pinned Lake project exists, `lean-run` analyzes imports,
+ranks a bounded set of exact environments from its bundled catalog, and asks Lean to
+check each candidate. The successful exact lock is retained by Runtime. Pin it for
+portable reuse whenever desired:
+
+```bash
+lean-run Main.lean --lock-out environment.lock.json
+lean-run Main.lean --lock environment.lock.json
+```
+
+The initial catalog covers core Lean v4.32.2 plus Mathlib v4.32.2, v4.31.0, and
+v4.30.0. Runtime first tries its local store and downloadable environment libraries,
+then builds the exact source environment when necessary. Use `--no-source-build` to
+forbid that potentially large fallback or `--offline` to use retained environments only.
+
+Explicit frontmatter remains available when the desired context is already known:
+
+```lean
+-- /// lean-runtime
+-- requires = ["mathlib@v4.32.2"]
+-- ///
+
+import Mathlib
+```
+
 The same context can be supplied from the command line:
 
 ```bash
 lean-run Main.lean --with mathlib@v4.32.2
 ```
 
-Create an exact lock for CI without changing the file:
+Create an exact lock from an explicit dependency for CI without changing the file:
 
 ```bash
 lean-run Main.lean --with mathlib@v4.32.2 \

{lean_runtime-2.0.2 → lean_runtime-2.0.5}/README.md

@@ -27,13 +27,9 @@ Inside an existing pinned Lake project, just pass the file:
 lean-run MyProject/Main.lean
 ```
 
-For a portable standalone file, declare exact dependencies in TOML frontmatter:
+Standalone files do not need a throwaway Lake project or dependency declaration:
 
 ```lean
--- /// lean-runtime
--- requires = ["mathlib@v4.32.2"]
--- ///
-
 import Mathlib
 
 example : 2 + 2 = 4 := by norm_num
@@ -43,13 +39,38 @@ example : 2 + 2 = 4 := by norm_num
 lean-run Main.lean
 ```
 
+When no explicit context or pinned Lake project exists, `lean-run` analyzes imports,
+ranks a bounded set of exact environments from its bundled catalog, and asks Lean to
+check each candidate. The successful exact lock is retained by Runtime. Pin it for
+portable reuse whenever desired:
+
+```bash
+lean-run Main.lean --lock-out environment.lock.json
+lean-run Main.lean --lock environment.lock.json
+```
+
+The initial catalog covers core Lean v4.32.2 plus Mathlib v4.32.2, v4.31.0, and
+v4.30.0. Runtime first tries its local store and downloadable environment libraries,
+then builds the exact source environment when necessary. Use `--no-source-build` to
+forbid that potentially large fallback or `--offline` to use retained environments only.
+
+Explicit frontmatter remains available when the desired context is already known:
+
+```lean
+-- /// lean-runtime
+-- requires = ["mathlib@v4.32.2"]
+-- ///
+
+import Mathlib
+```
+
 The same context can be supplied from the command line:
 
 ```bash
 lean-run Main.lean --with mathlib@v4.32.2
 ```
 
-Create an exact lock for CI without changing the file:
+Create an exact lock from an explicit dependency for CI without changing the file:
 
 ```bash
 lean-run Main.lean --with mathlib@v4.32.2 \

lean_runtime-2.0.5/catalog/environments.toml

@@ -0,0 +1,38 @@
+schema = "lean-runtime.discovery.catalog-source/v1"
+generated_at = "2026-08-08T16:24:59Z"
+
+[[environment]]
+id = "core-v4.32.2"
+channel = "stable"
+lock = "locks/core-v4.32.2.lock.json"
+inventory_packages = []
+modules = ["Init", "Lean", "Std"]
+library_hints = []
+created_at = "2026-08-08T16:24:59Z"
+
+[[environment]]
+id = "mathlib-v4.32.2"
+channel = "stable"
+lock = "locks/mathlib-v4.32.2.lock.json"
+references = ["github:leanprover-community/mathlib4@v4.32.2"]
+inventory_packages = ["mathlib"]
+library_hints = []
+created_at = "2026-07-28T18:36:13+02:00"
+
+[[environment]]
+id = "mathlib-v4.31.0"
+channel = "stable"
+lock = "locks/mathlib-v4.31.0.lock.json"
+references = ["github:leanprover-community/mathlib4@v4.31.0"]
+inventory_packages = ["mathlib"]
+library_hints = []
+created_at = "2026-06-15T14:22:22Z"
+
+[[environment]]
+id = "mathlib-v4.30.0"
+channel = "stable"
+lock = "locks/mathlib-v4.30.0.lock.json"
+references = ["github:leanprover-community/mathlib4@v4.30.0"]
+inventory_packages = ["mathlib"]
+library_hints = []
+created_at = "2026-05-26T18:25:31Z"

lean_runtime-2.0.5/catalog/locks/core-v4.32.2.lock.json

@@ -0,0 +1,17 @@
+{
+  "lock_id": "lock_83e4ada30f7aa251dd42fb99d3e576849d278fb3e1c2c81c06aadd2a3616e195",
+  "manifest": {
+    "fixedToolchain": false,
+    "lakeDir": ".lake",
+    "name": "lean_runtime_environment",
+    "packages": [],
+    "packagesDir": ".lake/packages",
+    "version": "1.2.0"
+  },
+  "packages": [],
+  "root_lakefile": "name = \"lean_runtime_environment\"\nversion = \"0.0.0\"\ndefaultTargets = [\"LeanRuntimeEnvironment\"]\n\n[[lean_lib]]\nname = \"LeanRuntimeEnvironment\"\n",
+  "root_module": "\n/- Generated by Lean Runtime. -/\n",
+  "schema": "lean-runtime-environment-lock/1",
+  "spec_digest": "spec_9202fc6a5f4488d9b4a0c09a293b7fa8d7002ae3822be8d345c7efa006ca9bc5",
+  "toolchain": "leanprover/lean4:v4.32.2"
+}

lean_runtime-2.0.5/catalog/locks/mathlib-v4.30.0.lock.json

@@ -0,0 +1,244 @@
+{
+  "lock_id": "lock_f9a835e9c2467c8a31cc752a72e7c3f651df114fa017da47090ba7eba6517149",
+  "manifest": {
+    "fixedToolchain": false,
+    "lakeDir": ".lake",
+    "name": "lean_runtime_environment",
+    "packages": [
+      {
+        "configFile": "lakefile.lean",
+        "inherited": false,
+        "inputRev": "c5ea00351c28e24afc9f0f84379aa41082b1188f",
+        "manifestFile": "lake-manifest.json",
+        "name": "mathlib",
+        "rev": "c5ea00351c28e24afc9f0f84379aa41082b1188f",
+        "scope": "",
+        "subDir": null,
+        "type": "git",
+        "url": "https://github.com/leanprover-community/mathlib4.git"
+      },
+      {
+        "configFile": "lakefile.toml",
+        "inherited": true,
+        "inputRev": "main",
+        "manifestFile": "lake-manifest.json",
+        "name": "plausible",
+        "rev": "a456461b368b71d2accd95234832cd9c174b5437",
+        "scope": "leanprover-community",
+        "subDir": null,
+        "type": "git",
+        "url": "https://github.com/leanprover-community/plausible"
+      },
+      {
+        "configFile": "lakefile.toml",
+        "inherited": true,
+        "inputRev": "main",
+        "manifestFile": "lake-manifest.json",
+        "name": "LeanSearchClient",
+        "rev": "c5d5b8fe6e5158def25cd28eb94e4141ad97c843",
+        "scope": "leanprover-community",
+        "subDir": null,
+        "type": "git",
+        "url": "https://github.com/leanprover-community/LeanSearchClient"
+      },
+      {
+        "configFile": "lakefile.toml",
+        "inherited": true,
+        "inputRev": "main",
+        "manifestFile": "lake-manifest.json",
+        "name": "importGraph",
+        "rev": "515cf9d0c00ece5e661f6de4326a53dedc1e8ea1",
+        "scope": "leanprover-community",
+        "subDir": null,
+        "type": "git",
+        "url": "https://github.com/leanprover-community/import-graph"
+      },
+      {
+        "configFile": "lakefile.lean",
+        "inherited": true,
+        "inputRev": "v0.0.99",
+        "manifestFile": "lake-manifest.json",
+        "name": "proofwidgets",
+        "rev": "a84b3e2475d5c5ab979567b1ad8aea21b764bcf8",
+        "scope": "leanprover-community",
+        "subDir": null,
+        "type": "git",
+        "url": "https://github.com/leanprover-community/ProofWidgets4"
+      },
+      {
+        "configFile": "lakefile.toml",
+        "inherited": true,
+        "inputRev": "v4.30.0",
+        "manifestFile": "lake-manifest.json",
+        "name": "aesop",
+        "rev": "558915ae105bfd8074e22d597613d1961822adc2",
+        "scope": "leanprover-community",
+        "subDir": null,
+        "type": "git",
+        "url": "https://github.com/leanprover-community/aesop"
+      },
+      {
+        "configFile": "lakefile.toml",
+        "inherited": true,
+        "inputRev": "v4.30.0",
+        "manifestFile": "lake-manifest.json",
+        "name": "Qq",
+        "rev": "a6e6c34c4ef182f83b219a3a5a385f51f44bdc4c",
+        "scope": "leanprover-community",
+        "subDir": null,
+        "type": "git",
+        "url": "https://github.com/leanprover-community/quote4"
+      },
+      {
+        "configFile": "lakefile.toml",
+        "inherited": true,
+        "inputRev": "main",
+        "manifestFile": "lake-manifest.json",
+        "name": "batteries",
+        "rev": "32dc18cde3684679f3c003de608743b57498c56f",
+        "scope": "leanprover-community",
+        "subDir": null,
+        "type": "git",
+        "url": "https://github.com/leanprover-community/batteries"
+      },
+      {
+        "configFile": "lakefile.toml",
+        "inherited": true,
+        "inputRev": "v4.30.0",
+        "manifestFile": "lake-manifest.json",
+        "name": "Cli",
+        "rev": "6b907cf12b2e445ccb7c24bc208ef04a1f39e84c",
+        "scope": "leanprover",
+        "subDir": null,
+        "type": "git",
+        "url": "https://github.com/leanprover/lean4-cli"
+      }
+    ],
+    "packagesDir": ".lake/packages",
+    "version": "1.2.0"
+  },
+  "packages": [
+    {
+      "artifact_command": [],
+      "inherited": true,
+      "name": "Cli",
+      "requested_revision": "v4.30.0",
+      "revision": "6b907cf12b2e445ccb7c24bc208ef04a1f39e84c",
+      "root_module": null,
+      "source": "git",
+      "source_id": "source_c01f06910785f51a955b789fe595cb0f7a9e31fdbd52a9c179c13bc15a215aba",
+      "subdir": null,
+      "tree_hash": "8a76534436fb49125055d57998a2907a396186f8",
+      "url": "https://github.com/leanprover/lean4-cli"
+    },
+    {
+      "artifact_command": [],
+      "inherited": true,
+      "name": "LeanSearchClient",
+      "requested_revision": "main",
+      "revision": "c5d5b8fe6e5158def25cd28eb94e4141ad97c843",
+      "root_module": null,
+      "source": "git",
+      "source_id": "source_de17867f530aa12a11295b9e954c0bc71adf2e186913d1eb3d494b206a324b67",
+      "subdir": null,
+      "tree_hash": "d0224b6df6c90cc0b4ed2db6218037d31bfd6f52",
+      "url": "https://github.com/leanprover-community/LeanSearchClient"
+    },
+    {
+      "artifact_command": [],
+      "inherited": true,
+      "name": "Qq",
+      "requested_revision": "v4.30.0",
+      "revision": "a6e6c34c4ef182f83b219a3a5a385f51f44bdc4c",
+      "root_module": null,
+      "source": "git",
+      "source_id": "source_60de60b0b4c17b986970ce14b7745f03577878d68d571d26b0f79ad2050944c5",
+      "subdir": null,
+      "tree_hash": "3cd6c8c7454ab4cdc4f5c7068250d42e6f072b42",
+      "url": "https://github.com/leanprover-community/quote4"
+    },
+    {
+      "artifact_command": [],
+      "inherited": true,
+      "name": "aesop",
+      "requested_revision": "v4.30.0",
+      "revision": "558915ae105bfd8074e22d597613d1961822adc2",
+      "root_module": null,
+      "source": "git",
+      "source_id": "source_d00c4fd39cd426bf0c5055708b35c89ee9d4a93bb7b1703858a84820b53d7a83",
+      "subdir": null,
+      "tree_hash": "9f9a222ac975ad751c92bcf0f46de9fd2b0c3cfb",
+      "url": "https://github.com/leanprover-community/aesop"
+    },
+    {
+      "artifact_command": [],
+      "inherited": true,
+      "name": "batteries",
+      "requested_revision": "main",
+      "revision": "32dc18cde3684679f3c003de608743b57498c56f",
+      "root_module": null,
+      "source": "git",
+      "source_id": "source_e9f2d8aa0918281163471c383fe2b84f3e8664c515d68e2b5a8be71a8bf1a656",
+      "subdir": null,
+      "tree_hash": "436fbfdcb885492763ccee85e5db580d1995966f",
+      "url": "https://github.com/leanprover-community/batteries"
+    },
+    {
+      "artifact_command": [],
+      "inherited": true,
+      "name": "importGraph",
+      "requested_revision": "main",
+      "revision": "515cf9d0c00ece5e661f6de4326a53dedc1e8ea1",
+      "root_module": null,
+      "source": "git",
+      "source_id": "source_a017eacbcf51b53b1088560de28a2887167215ef1c65dbce09eb4fe0d884e9f7",
+      "subdir": null,
+      "tree_hash": "7418207a8b90a9f8e7223c20009d7eab86a4fd53",
+      "url": "https://github.com/leanprover-community/import-graph"
+    },
+    {
+      "artifact_command": [],
+      "inherited": false,
+      "name": "mathlib",
+      "requested_revision": "c5ea00351c28e24afc9f0f84379aa41082b1188f",
+      "revision": "c5ea00351c28e24afc9f0f84379aa41082b1188f",
+      "root_module": "Mathlib",
+      "source": "git",
+      "source_id": "source_fe2d2fc9c4c54f6dc89ac1ccd4c00581a362e2c2f1914e024983c4d70c375637",
+      "subdir": null,
+      "tree_hash": "1fe688f4d9e84fb268a300f8ac33cbca883fbd28",
+      "url": "https://github.com/leanprover-community/mathlib4.git"
+    },
+    {
+      "artifact_command": [],
+      "inherited": true,
+      "name": "plausible",
+      "requested_revision": "main",
+      "revision": "a456461b368b71d2accd95234832cd9c174b5437",
+      "root_module": null,
+      "source": "git",
+      "source_id": "source_6a376c3e5442e8aaca75bf1fbffba6168941014ad82653c242c5b646042557ba",
+      "subdir": null,
+      "tree_hash": "cbfb86e477a2ed89137953b22bbf38149658b672",
+      "url": "https://github.com/leanprover-community/plausible"
+    },
+    {
+      "artifact_command": [],
+      "inherited": true,
+      "name": "proofwidgets",
+      "requested_revision": "v0.0.99",
+      "revision": "a84b3e2475d5c5ab979567b1ad8aea21b764bcf8",
+      "root_module": null,
+      "source": "git",
+      "source_id": "source_25d2a88210f202e2624693750d9bbfba88d9012ec3a95576f25bdf49cb50ca85",
+      "subdir": null,
+      "tree_hash": "e0e2c368464f34b36f0db3901ce3c8ab4a1b8a40",
+      "url": "https://github.com/leanprover-community/ProofWidgets4"
+    }
+  ],
+  "root_lakefile": "name = \"lean_runtime_environment\"\nversion = \"0.0.0\"\ndefaultTargets = [\"LeanRuntimeEnvironment\"]\n\n[[require]]\nname = \"mathlib\"\ngit = \"https://github.com/leanprover-community/mathlib4.git\"\nrev = \"c5ea00351c28e24afc9f0f84379aa41082b1188f\"\n\n[[lean_lib]]\nname = \"LeanRuntimeEnvironment\"\n",
+  "root_module": "import Mathlib\n\n/- Generated by Lean Runtime. -/\n",
+  "schema": "lean-runtime-environment-lock/1",
+  "spec_digest": "spec_eba7ce427693583a568fd4a84c8678a604e3d2db44939614971e1a2a988bb241",
+  "toolchain": "leanprover/lean4:v4.30.0"
+}