lean-runtime 4.1.1__tar.gz → 4.2.0__tar.gz

{lean_runtime-4.1.1 → lean_runtime-4.2.0}/CHANGELOG.md

@@ -2,6 +2,20 @@
 
 ## Unreleased
 
+## 4.2.0 - 2026-08-23
+
+- Add a scheduled catalog-update workflow that detects a new stable Mathlib
+  release, freezes its exact lock, rebuilds the bundled catalog, and opens a
+  pull request.
+- Add `catalog build --previous`, which reuses module inventories from a
+  prior catalog for entries whose locks are unchanged, so incremental
+  rebuilds only materialize new or changed sources.
+- Add digest-pinned, per-package declaration-index shards generated from
+  public `.ilean` files during catalog publication. Rejected standalone
+  checks can lazily fetch only the relevant shard and report the module that
+  defines an unknown name; retained shards remain available offline and are
+  reused across environments with the same source and toolchain.
+
 ## 4.1.1 - 2026-08-21
 
 - Escape source stems that are not plain Lean identifiers when rendering

{lean_runtime-4.1.1/lean_runtime.egg-info → lean_runtime-4.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lean-runtime
-Version: 4.1.1
+Version: 4.2.0
 Summary: Run Lean 4 proofs from Python or standalone files
 Author: Alejandro Radisic
 License-Expression: Apache-2.0

{lean_runtime-4.1.1 → lean_runtime-4.2.0}/catalog/environments.toml

@@ -1,5 +1,5 @@
 schema = "lean-runtime.discovery.catalog-source/v1"
-generated_at = "2026-08-13T13:49:46Z"
+generated_at = "2026-08-21T16:51:41Z"
 
 [[environment]]
 id = "core-v4.32.2"
@@ -84,3 +84,11 @@ references = [
 ]
 inventory_packages = ["LeanCert", "mathlib"]
 created_at = "2026-08-10T22:05:27Z"
+
+[[environment]]
+id = "mathlib-v4.33.1"
+channel = "stable"
+lock = "locks/mathlib-v4.33.1.lock.json"
+references = ["github:leanprover-community/mathlib4@v4.33.1"]
+inventory_packages = ["mathlib"]
+created_at = "2026-08-21T16:51:41Z"

lean_runtime-4.2.0/catalog/locks/mathlib-v4.33.1.lock.json

@@ -0,0 +1,244 @@
+{
+  "lock_id": "lock_66cf2e4f7ba9465fbcb9287abf7d770b58e102b03e27cc52f15d8e952a69e924",
+  "manifest": {
+    "fixedToolchain": false,
+    "lakeDir": ".lake",
+    "name": "lean_runtime_environment",
+    "packages": [
+      {
+        "configFile": "lakefile.lean",
+        "inherited": false,
+        "inputRev": "0df444a360eaa60ab8c11dca51a86af692955474",
+        "manifestFile": "lake-manifest.json",
+        "name": "mathlib",
+        "rev": "0df444a360eaa60ab8c11dca51a86af692955474",
+        "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": "b7eb3304aeae834b12dda98993a37f6a41f6f0bb",
+        "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": "5f4d51b81cbd3f6b32b156bfad9056621a040404",
+        "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": "16f02aa7642864af59f1ff0e384a015994db9118",
+        "scope": "leanprover-community",
+        "subDir": null,
+        "type": "git",
+        "url": "https://github.com/leanprover-community/import-graph"
+      },
+      {
+        "configFile": "lakefile.lean",
+        "inherited": true,
+        "inputRev": "main",
+        "manifestFile": "lake-manifest.json",
+        "name": "proofwidgets",
+        "rev": "4be2e3d5087eeb272cf5a8853b8f9dd025ef5957",
+        "scope": "leanprover-community",
+        "subDir": null,
+        "type": "git",
+        "url": "https://github.com/leanprover-community/ProofWidgets4"
+      },
+      {
+        "configFile": "lakefile.toml",
+        "inherited": true,
+        "inputRev": "master",
+        "manifestFile": "lake-manifest.json",
+        "name": "aesop",
+        "rev": "3448c0bcc5ce01b2d1546e483ec3620e32df3d0e",
+        "scope": "leanprover-community",
+        "subDir": null,
+        "type": "git",
+        "url": "https://github.com/leanprover-community/aesop"
+      },
+      {
+        "configFile": "lakefile.toml",
+        "inherited": true,
+        "inputRev": "master",
+        "manifestFile": "lake-manifest.json",
+        "name": "Qq",
+        "rev": "92c15be17b7caf78c2ad767ec40f89052d908d81",
+        "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": "4488d40d070b9700d4d5a6aa342f0d40c31b2a2d",
+        "scope": "leanprover-community",
+        "subDir": null,
+        "type": "git",
+        "url": "https://github.com/leanprover-community/batteries"
+      },
+      {
+        "configFile": "lakefile.toml",
+        "inherited": true,
+        "inputRev": "v4.33.0",
+        "manifestFile": "lake-manifest.json",
+        "name": "Cli",
+        "rev": "6130a47896ce867c6a4a55373441e59e565bad0f",
+        "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.33.0",
+      "revision": "6130a47896ce867c6a4a55373441e59e565bad0f",
+      "root_module": null,
+      "source": "git",
+      "source_id": "source_0402fb44cd255aa6abf01e100ffbc8b0a584fb06e7d667eca759a3fea1ce936f",
+      "subdir": null,
+      "tree_hash": "34330f4c97f983d6b2dcb6d1de73941d76f0d336",
+      "url": "https://github.com/leanprover/lean4-cli"
+    },
+    {
+      "artifact_command": [],
+      "inherited": true,
+      "name": "LeanSearchClient",
+      "requested_revision": "main",
+      "revision": "5f4d51b81cbd3f6b32b156bfad9056621a040404",
+      "root_module": null,
+      "source": "git",
+      "source_id": "source_2b06180ed488eb4e9b3be595ae700d1bcda4937b3c74a996b6ab14966ee339c8",
+      "subdir": null,
+      "tree_hash": "6df26d76c14ef44d6b84a19df906d9116cfe3a50",
+      "url": "https://github.com/leanprover-community/LeanSearchClient"
+    },
+    {
+      "artifact_command": [],
+      "inherited": true,
+      "name": "Qq",
+      "requested_revision": "master",
+      "revision": "92c15be17b7caf78c2ad767ec40f89052d908d81",
+      "root_module": null,
+      "source": "git",
+      "source_id": "source_b44eb196acecfe724380f2ccd514388734c8d02a1be9d2bf3ac9ce3bb304607e",
+      "subdir": null,
+      "tree_hash": "1e857c2d945d9f5757b39cd2a2be1ed1ea94c82c",
+      "url": "https://github.com/leanprover-community/quote4"
+    },
+    {
+      "artifact_command": [],
+      "inherited": true,
+      "name": "aesop",
+      "requested_revision": "master",
+      "revision": "3448c0bcc5ce01b2d1546e483ec3620e32df3d0e",
+      "root_module": null,
+      "source": "git",
+      "source_id": "source_9b0a2b5654b9b0c4a3f39b7d0d3536fd5a6c0743f9a578c872f2e92336df7b66",
+      "subdir": null,
+      "tree_hash": "b2a7fa8f458d93951096c5c16da08fbfab393c85",
+      "url": "https://github.com/leanprover-community/aesop"
+    },
+    {
+      "artifact_command": [],
+      "inherited": true,
+      "name": "batteries",
+      "requested_revision": "main",
+      "revision": "4488d40d070b9700d4d5a6aa342f0d40c31b2a2d",
+      "root_module": null,
+      "source": "git",
+      "source_id": "source_ed59216c03fbbd94e5c2ca84e014be429ad841975d9fb49cfaf8e7eca8ba0913",
+      "subdir": null,
+      "tree_hash": "5a1de86f7997958aaffec998882c29006b688d1e",
+      "url": "https://github.com/leanprover-community/batteries"
+    },
+    {
+      "artifact_command": [],
+      "inherited": true,
+      "name": "importGraph",
+      "requested_revision": "main",
+      "revision": "16f02aa7642864af59f1ff0e384a015994db9118",
+      "root_module": null,
+      "source": "git",
+      "source_id": "source_601bef5a8bbe2ecd1da264920f7af7f614428f74d2206055796079f550c16ead",
+      "subdir": null,
+      "tree_hash": "0330ba38791d120e992fd635f4198dd4f845f8d1",
+      "url": "https://github.com/leanprover-community/import-graph"
+    },
+    {
+      "artifact_command": [],
+      "inherited": false,
+      "name": "mathlib",
+      "requested_revision": "0df444a360eaa60ab8c11dca51a86af692955474",
+      "revision": "0df444a360eaa60ab8c11dca51a86af692955474",
+      "root_module": "Mathlib",
+      "source": "git",
+      "source_id": "source_1f0e94acb82fc5dc587e3acceb80897790beeec034b05722afad1db35764a966",
+      "subdir": null,
+      "tree_hash": "f18edc0401eb2459e5241329743eb8626fdff148",
+      "url": "https://github.com/leanprover-community/mathlib4.git"
+    },
+    {
+      "artifact_command": [],
+      "inherited": true,
+      "name": "plausible",
+      "requested_revision": "main",
+      "revision": "b7eb3304aeae834b12dda98993a37f6a41f6f0bb",
+      "root_module": null,
+      "source": "git",
+      "source_id": "source_2b217883fa26c662bc5f83bfd2dc8a2f2bb1af2cfebbe62514584c9b0a22c874",
+      "subdir": null,
+      "tree_hash": "52fb5a4067538333f08d2c2c2ee9db16351a3508",
+      "url": "https://github.com/leanprover-community/plausible"
+    },
+    {
+      "artifact_command": [],
+      "inherited": true,
+      "name": "proofwidgets",
+      "requested_revision": "main",
+      "revision": "4be2e3d5087eeb272cf5a8853b8f9dd025ef5957",
+      "root_module": null,
+      "source": "git",
+      "source_id": "source_f4de1d6d00d935d1bc5ec34f827c54091009039ef322e326b50a9d4520e490d0",
+      "subdir": null,
+      "tree_hash": "6848bab13b5769926e47be1c768b9c3cad3e0d41",
+      "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 = \"0df444a360eaa60ab8c11dca51a86af692955474\"\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_bd04dd6fc4ab7ee22d1e836be9c5d1788169f9e583dcb14fa3bf55a5357abbba",
+  "toolchain": "leanprover/lean4:v4.33.1"
+}

{lean_runtime-4.1.1 → lean_runtime-4.2.0}/lean_runtime/cli.py

@@ -21,6 +21,12 @@ else:  # pragma: no cover - exercised by Python 3.10 CI
     import tomli as tomllib
 
 from .console import ConsoleRenderer, styler_for
+from .declaration_index import DeclarationIndex, DeclarationIndexSet, DeclarationShard
+from .declaration_index_build import (
+    build_declaration_index,
+    load_declaration_index_build,
+)
+from .declaration_index_oci import OCIDeclarationIndexPublisher
 from .discovery.api import Discovery
 from .discovery.catalog_build import build_catalog_file
 from .discovery.defaults import default_catalog
@@ -41,10 +47,12 @@ from .lake import ROOT_MODULE
 from .lockfiles import EnvironmentLock
 from .matrix import load_matrix
 from .models import ExecutionResult, PhaseTiming
+from .oci import OCIRepository
 from .policies import ExecutionPolicy, format_byte_size, parse_byte_size
 from .profiling import ProfileReport
 from .project_sharing import AdoptionPlan, ProjectInitPlan, ProjectUpdatePlan
 from .projects import discover_project, project_publication_workflow
+from .publisher_verification import CosignVerifier
 from .run_cli import run as _run_front_door
 from .runtime import Runtime
 from .specs import EnvironmentSpec
@@ -101,6 +109,11 @@ def _render_storage(status: StoreStatus) -> None:
         ("Sources", status.sources, status.sources_bytes),
         ("Download cache", status.oci_blobs, status.oci_blobs_bytes),
         ("Shared module CAS", status.cas_artifacts, status.cas_artifacts_bytes),
+        (
+            "Declaration indexes",
+            status.declaration_indexes,
+            status.declaration_indexes_bytes,
+        ),
         ("Project packages", status.project_packages, status.project_packages_bytes),
         ("Toolchains", None, status.toolchains_bytes),
         ("Executions", status.executions, status.executions_bytes),
@@ -850,6 +863,8 @@ Advanced namespaces:
     env_acquire.add_argument("lock", type=Path)
     env_acquire.add_argument("--name")
     env_acquire.add_argument("--download-only", action="store_true")
+    env_acquire.add_argument("--timeout", type=float, default=1800)
+    env_acquire.add_argument("--accelerate", action="store_true")
     env_acquire.set_defaults(command="acquire")
     env_diff = env_commands.add_parser("diff", help="compare exact environments")
     env_diff.add_argument("left")
@@ -1006,11 +1021,35 @@ Advanced namespaces:
     pfinal.add_argument("--tag", action="append", default=[])
     pfinal.add_argument("--sign", action="store_true")
     pfinal.set_defaults(command="finalize-program")
+    declaration_index = commands.add_parser(
+        "declaration-index", help="build and publish composable declaration shards"
+    )
+    di = declaration_index.add_subparsers(dest="declaration_index_operation", required=True)
+    dib = di.add_parser("build")
+    dib.add_argument("lock", type=Path)
+    dib.add_argument("--output", required=True, type=Path)
+    dib.add_argument("--weights", type=Path)
+    dib.set_defaults(command="declaration-index-build")
+    dip = di.add_parser("publish")
+    dip.add_argument("lock", type=Path)
+    dip.add_argument("build", type=Path)
+    dip.add_argument("--library", required=True)
+    dip.add_argument("--sign", action="store_true")
+    dip.set_defaults(command="declaration-index-publish")
+    dii = di.add_parser("inspect")
+    dii.add_argument("build", type=Path)
+    dii.add_argument("--resolve")
+    dii.set_defaults(command="declaration-index-inspect")
     catalog = commands.add_parser("catalog", help="catalog maintenance")
     cc = catalog.add_subparsers(dest="catalog_operation", required=True)
     cb = cc.add_parser("build")
     cb.add_argument("manifest", type=Path)
     cb.add_argument("--output", required=True, type=Path)
+    cb.add_argument(
+        "--previous",
+        type=Path,
+        help="prior catalog whose unchanged entries skip module re-inventory",
+    )
     cb.set_defaults(command="catalog-build")
     return root
 
@@ -1206,12 +1245,80 @@ def main(argv: list[str] | None = None) -> int:
             trusted_issuer=args.trusted_issuer,
             verification_tool=args.verification_tool,
         )
+        if args.command == "declaration-index-build":
+            lock = EnvironmentLock.load(args.lock)
+            built = build_declaration_index(
+                runtime,
+                lock,
+                args.output,
+                weights_path=args.weights,
+            )
+            _json(built.to_dict())
+            return 0
+        if args.command == "declaration-index-publish":
+            lock = EnvironmentLock.load(args.lock)
+            built = load_declaration_index_build(args.build, expected_lock_id=lock.lock_id)
+            di_repository = OCIRepository.parse(args.library)
+            di_publication = OCIDeclarationIndexPublisher(di_repository).publish(
+                tuple(di_item.source for di_item in built.shards), lock_id=lock.lock_id
+            )
+            if args.sign:
+                CosignVerifier(executable=runtime.verification_executable).sign(
+                    di_repository, di_publication.manifest_digest
+                )
+            _json(di_publication.to_dict())
+            return 0
+        if args.command == "declaration-index-inspect":
+            built = load_declaration_index_build(args.build)
+            indexes = []
+            for di_item in built.shards:
+                di_source = di_item.source
+                shard = DeclarationShard(
+                    di_source.shard_id,
+                    di_source.package,
+                    di_source.source_id,
+                    di_source.toolchain,
+                    di_source.subdir,
+                    di_source.module_roots,
+                    di_source.namespace_roots,
+                    "sha256:" + "0" * 64,
+                    di_source.path.stat().st_size,
+                    "sha256:" + "0" * 64,
+                    1,
+                )
+                indexes.append(
+                    (
+                        shard,
+                        DeclarationIndex(di_source.path, expected_shard_id=di_source.shard_id),
+                    )
+                )
+            index_set = DeclarationIndexSet(built.lock_id, tuple(indexes))
+            di_match = index_set.resolve(args.resolve) if args.resolve else None
+            _json(
+                {
+                    "lock_id": built.lock_id,
+                    "shards": len(built.shards),
+                    "declarations": index_set.declaration_count,
+                    "match": (
+                        {
+                            "name": di_match.name,
+                            "module": di_match.module,
+                            "kind": di_match.kind,
+                            "weight": di_match.weight,
+                        }
+                        if di_match is not None
+                        else None
+                    ),
+                }
+            )
+            return 0
         if args.command == "catalog-build":
             os.environ.setdefault("MATHLIB_NO_CACHE_ON_UPDATE", "1")
             catalog_result = build_catalog_file(
                 args.manifest,
                 args.output,
                 runtime=Runtime(home=args.home, libraries=()),
+                previous_path=args.previous,
             )
             print(
                 f"wrote {args.output}: {len(catalog_result.entries)} environments, "
@@ -1541,7 +1648,12 @@ def main(argv: list[str] | None = None) -> int:
         if args.command in {"open", "acquire"}:
             if args.command == "acquire" and args.download_only:
                 runtime.availability = "required"
-            environment = runtime.open_exact(EnvironmentLock.load(args.lock), name=args.name)
+            environment = runtime.open_exact(
+                EnvironmentLock.load(args.lock),
+                name=args.name,
+                build_timeout=args.timeout,
+                accelerate=args.accelerate,
+            )
             _json(environment.inspect().to_dict())
             if args.timings:
                 print(