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

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

@@ -2,6 +2,46 @@
 
 ## 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
+  check setups, so files such as `with space.lean` check correctly inside
+  acquired environments.
+- Report a hit `--timeout` as `timed out` with exit 2 instead of presenting
+  it as a Lean rejection with exit 1, and document the classification.
+- Say `--using` in the frontmatter conflict message instead of the removed
+  `--with` spelling.
+- Re-measure the README and landing-page example timings against this
+  machine's warm store and narrow the README hero import to
+  `Mathlib.Tactic.NormNum`.
+- Accept the `lean:vX.Y.Z` shorthand under the explicit `toolchain:` context
+  prefix instead of passing the raw string to Elan.
+- Exit 2 when a guided mutation (`new`, `adopt`, `update`, `publish`,
+  `project unshare`) needs confirmation but cannot prompt; interactive
+  declines still exit 0.
+- Rewrite staged scratch paths to the submitted file names in multi-file
+  check diagnostics, matching single-file output.
+- Render standalone `status` imports, candidates, and availability as
+  aligned text instead of Python reprs.
+- Hint at `lean-runtime check -` when a project-wide check finds no pinned
+  project and stdin is redirected, and document the stdin spelling.
+- Document that a project context applies to files inside the project root,
+  and list `replay` and `completion` in the README command summary.
+
 ## 4.1.0 - 2026-08-19
 
 ## 4.0.1 - 2026-08-18

{lean_runtime-4.1.0/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.0
+Version: 4.2.0
 Summary: Run Lean 4 proofs from Python or standalone files
 Author: Alejandro Radisic
 License-Expression: Apache-2.0
@@ -46,14 +46,14 @@ Give Lean Runtime an ordinary file:
 
 ```lean
 -- Main.lean
-import Mathlib
+import Mathlib.Tactic.NormNum
 
 example : 2 + 2 = 4 := by norm_num
 ```
 
 ```console
 $ lean-runtime check Main.lean
-✓ Main.lean accepted in 1.60s
+✓ Main.lean accepted in 2.60s
 ```
 
 No Lake project, dependency checkout, or toolchain setup required. Lean Runtime
@@ -123,7 +123,8 @@ lean-runtime check Main.lean --using ~/proofs/MyProject
 ```
 
 Typed `package:`, `lock:`, `env:`, `toolchain:`, and `project:` prefixes resolve
-rare ambiguities. Persistent store, registry, and trust policy belongs in
+rare ambiguities. A project context applies to files inside that project's
+root. Persistent store, registry, and trust policy belongs in
 environment configuration rather than everyday command lines.
 
 ## Commands
@@ -131,17 +132,19 @@ environment configuration rather than everyday command lines.
 The normal surface is deliberately small:
 
 ```text
-new NAME       create a project
-adopt [PATH]   share dependencies from existing project(s)
-check [PATH…]  check a project, directory, source file, or stdin
-watch FILE     re-check on save
-build [TARGET] build the current project
-update         preview and apply a safe project update
-publish        configure verified project publication
-status [PATH]  explain the selected project or environment
-verify SUBJECT verify an exact artifact
-doctor         diagnose and offer safe repairs
-clean          preview and reclaim unused storage
+new NAME         create a project
+adopt [PATH]     share dependencies from existing project(s)
+check [PATH…]    check a project, directory, source file, or stdin (-)
+watch FILE       re-check on save
+build [TARGET]   build the current project
+update           preview and apply a safe project update
+publish          configure verified project publication
+status [PATH]    explain the selected project or environment
+verify SUBJECT   verify an exact artifact
+doctor           diagnose and offer safe repairs
+clean            preview and reclaim unused storage
+replay CAPTURE   replay an execution capture
+completion SHELL generate shell completion
 ```
 
 Project commands use the current directory when no path is supplied. Guided

{lean_runtime-4.1.0 → lean_runtime-4.2.0}/README.md

@@ -10,14 +10,14 @@ Give Lean Runtime an ordinary file:
 
 ```lean
 -- Main.lean
-import Mathlib
+import Mathlib.Tactic.NormNum
 
 example : 2 + 2 = 4 := by norm_num
 ```
 
 ```console
 $ lean-runtime check Main.lean
-✓ Main.lean accepted in 1.60s
+✓ Main.lean accepted in 2.60s
 ```
 
 No Lake project, dependency checkout, or toolchain setup required. Lean Runtime
@@ -87,7 +87,8 @@ lean-runtime check Main.lean --using ~/proofs/MyProject
 ```
 
 Typed `package:`, `lock:`, `env:`, `toolchain:`, and `project:` prefixes resolve
-rare ambiguities. Persistent store, registry, and trust policy belongs in
+rare ambiguities. A project context applies to files inside that project's
+root. Persistent store, registry, and trust policy belongs in
 environment configuration rather than everyday command lines.
 
 ## Commands
@@ -95,17 +96,19 @@ environment configuration rather than everyday command lines.
 The normal surface is deliberately small:
 
 ```text
-new NAME       create a project
-adopt [PATH]   share dependencies from existing project(s)
-check [PATH…]  check a project, directory, source file, or stdin
-watch FILE     re-check on save
-build [TARGET] build the current project
-update         preview and apply a safe project update
-publish        configure verified project publication
-status [PATH]  explain the selected project or environment
-verify SUBJECT verify an exact artifact
-doctor         diagnose and offer safe repairs
-clean          preview and reclaim unused storage
+new NAME         create a project
+adopt [PATH]     share dependencies from existing project(s)
+check [PATH…]    check a project, directory, source file, or stdin (-)
+watch FILE       re-check on save
+build [TARGET]   build the current project
+update           preview and apply a safe project update
+publish          configure verified project publication
+status [PATH]    explain the selected project or environment
+verify SUBJECT   verify an exact artifact
+doctor           diagnose and offer safe repairs
+clean            preview and reclaim unused storage
+replay CAPTURE   replay an execution capture
+completion SHELL generate shell completion
 ```
 
 Project commands use the current directory when no path is supplied. Guided

{lean_runtime-4.1.0 → 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.0 → lean_runtime-4.2.0}/docs/reference/commands.md

@@ -44,8 +44,11 @@ lean-runtime check Main.lean --offline
 lean-runtime check Main.lean --json
 lean-runtime check Main.lean --timings
 lean-runtime check Main.lean --repeat 10
+lean-runtime check - --using leanprover/lean4:v4.33.0
 ```
 
+`-` reads Lean source from standard input and requires an explicit context.
+
 `--allow-source-build` permits standalone discovery to build an environment from source when no suitable acquired form is available.
 
 ## Build cache control
@@ -63,5 +66,5 @@ The default build may restore supported dependency artifacts before invoking Lak
 | --- | --- |
 | `0` | Lean accepted the source. |
 | `1` | Lean ran and rejected the source. |
-| `2` | Invocation, context, acquisition, or configuration failed. |
+| `2` | Invocation, context, acquisition, or configuration failed, or a resource limit such as `--timeout` was hit. |
 | `130` | Interrupted. |

{lean_runtime-4.1.0 → lean_runtime-4.2.0}/docs/tutorial.md

@@ -115,7 +115,7 @@ Offline mode does not acquire missing remote content. Missing requirements produ
 | --- | --- |
 | `0` | Lean accepted the source. |
 | `1` | Lean ran and rejected the source. |
-| `2` | Invocation, context, acquisition, or configuration failed. |
+| `2` | Invocation, context, acquisition, or configuration failed, or a resource limit such as `--timeout` was hit. |
 | `130` | The operation was interrupted. |
 
 Use `--json` for structured results and `--verbose` for the runtime event stream.

{lean_runtime-4.1.0 → lean_runtime-4.2.0}/docs/workflows/check-files.md

@@ -27,7 +27,15 @@ lean-runtime check Main.lean --using leanprover/lean4:v4.33.0
 lean-runtime check Main.lean --using ./some-project
 ```
 
-Package references resolve a published package release. Lock files identify an exact dependency graph. Toolchain references provide a core Lean context. Project paths use the project toolchain and manifest.
+Package references resolve a published package release. Lock files identify an exact dependency graph. Toolchain references provide a core Lean context. Project paths use the project toolchain and manifest; the file must live inside that project's root.
+
+## Check standard input
+
+Pass `-` as the input. Standard input carries no filename evidence, so an explicit context is required:
+
+```console
+echo 'example : True := trivial' | lean-runtime check - --using leanprover/lean4:v4.33.0
+```
 
 ## Put context in the file