lean-runtime 2.7.0__tar.gz → 2.8.0__tar.gz

{lean_runtime-2.7.0 → lean_runtime-2.8.0}/CHANGELOG.md

@@ -2,6 +2,26 @@
 
 ## Unreleased
 
+## 2.8.0 - 2026-08-14
+
+- Cut repeated project-check latency with capability-probed Lean header snapshots;
+  `check --watch` rechecks on save, while `check --repeat` and `check --across`
+  absorb the common profile/matrix workflows without removing legacy aliases.
+- Suggest exact-workspace declarations after coded unknown-identifier diagnostics
+  using persisted `.ilean` indexes from the pinned dependency graph.
+- Make `init --mathlib-version VERSION` unambiguous, preserve common repository
+  scaffolding, optionally generate matching CI with `--ci`, and retain the old
+  `--mathlib` spelling as a validated compatibility alias.
+- Add `project scan/attach/detach/update`, `publish KIND`, `finalize KIND`, and
+  `copy save/open` namespaces while retaining existing command spellings for
+  automation.
+- Give environments and doctor human output plus `--json`, add `doctor --fix`,
+  fingerprinted storage accounting with `storage --verify`, cleanup nudges,
+  `clean --keep-last` retention, curated help, and generated Bash/Zsh/Fish
+  completions.
+- Report cumulative frame and byte counters while restoring sparse capsules, so
+  both terse and verbose cold-start output shows measurable forward progress.
+
 ## 2.7.0 - 2026-08-14
 
 - Keep newly initialized project roots narrow: the generated root imports its

{lean_runtime-2.7.0/lean_runtime.egg-info → lean_runtime-2.8.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lean-runtime
-Version: 2.7.0
+Version: 2.8.0
 Summary: Run Lean 4 proofs from Python or standalone files
 Author: Alejandro Radisic
 License-Expression: Apache-2.0
@@ -188,6 +188,7 @@ default, and exact dependencies are shared automatically:
 lean-runtime init MyProof
 cd MyProof
 lean-runtime check MyProof/Basic.lean
+lean-runtime check MyProof/Basic.lean --watch
 # Check every declared local library, in Lake dependency order:
 lean-runtime check
 lean-runtime build
@@ -196,7 +197,7 @@ lean-runtime build
 `init` also writes an `AGENTS.md` with the project build, checking, dependency,
 and shared-package rules for coding agents. Pass `--no-agents` to omit it; an
 existing `AGENTS.md` is never overwritten. Use `--core` for no Mathlib, or
-`--mathlib 4.33.0` to select a cataloged release. `lean-runtime update`
+`--mathlib-version 4.33.0` to select a cataloged release. `lean-runtime update`
 explicitly moves a project to the newest cataloged Mathlib after a preview.
 
 Running `lean-runtime init .` in an existing pinned Lake project adopts its

{lean_runtime-2.7.0 → lean_runtime-2.8.0}/README.md

@@ -152,6 +152,7 @@ default, and exact dependencies are shared automatically:
 lean-runtime init MyProof
 cd MyProof
 lean-runtime check MyProof/Basic.lean
+lean-runtime check MyProof/Basic.lean --watch
 # Check every declared local library, in Lake dependency order:
 lean-runtime check
 lean-runtime build
@@ -160,7 +161,7 @@ lean-runtime build
 `init` also writes an `AGENTS.md` with the project build, checking, dependency,
 and shared-package rules for coding agents. Pass `--no-agents` to omit it; an
 existing `AGENTS.md` is never overwritten. Use `--core` for no Mathlib, or
-`--mathlib 4.33.0` to select a cataloged release. `lean-runtime update`
+`--mathlib-version 4.33.0` to select a cataloged release. `lean-runtime update`
 explicitly moves a project to the newest cataloged Mathlib after a preview.
 
 Running `lean-runtime init .` in an existing pinned Lake project adopts its

{lean_runtime-2.7.0 → lean_runtime-2.8.0}/docs/cli.md

@@ -32,6 +32,19 @@ first-time download cannot expire the search. `--discovery-timeout` and
 
 All commands accept `--home PATH` before the subcommand to select a store.
 
+For project iteration, `check FILE --watch` rechecks on save with warm native
+import snapshots. `check FILE --repeat N` measures the same path, and
+`check FILE --across matrix.toml` checks exact contexts. The older `profile`
+and `matrix` commands remain compatibility aliases.
+
+`storage` reads a fingerprinted ledger after its first inventory, so large
+stores remain an instant-information command. `storage --verify` explicitly
+rebuilds that ledger and prints a progress line because it must walk the store.
+`doctor` is human-readable by default; `doctor --json` preserves automation and
+`doctor --fix` applies its safe stale-staging and private-Elan remedies.
+`clean --keep-last N` (or `LEAN_RUNTIME_CLEAN_KEEP_LAST`) retains the newest N
+otherwise eligible unnamed environments in addition to the age threshold.
+
 ## One-shot package workflow
 
 ```bash
@@ -61,9 +74,9 @@ lean-runtime check Main.lean \
 lean-runtime prepare environment.toml --output environment.lock.json
 lean-runtime open environment.lock.json --name research-stack
 lean-runtime --library ghcr.io/owner/lean-environments download environment.lock.json
-lean-runtime save-copy research-stack --output research-stack.lean-environment
-lean-runtime --home /tmp/fresh open-copy research-stack.lean-environment --name research-stack
-lean-runtime build-and-publish environment.lock.json --publish-to ghcr.io/owner/lean-environments
+lean-runtime copy save research-stack --output research-stack.lean-environment
+lean-runtime --home /tmp/fresh copy open research-stack.lean-environment --name research-stack
+lean-runtime publish environment environment.lock.json --publish-to ghcr.io/owner/lean-environments
 lean-runtime check research-stack Main.lean --json
 lean-runtime inspect research-stack --packages
 lean-runtime environments
@@ -79,9 +92,10 @@ lean-runtime clean --execute
 
 `clean` is a dry run unless `--execute` is supplied.
 
-`save-copy` creates a portable environment file. `open-copy` verifies its exact
+`copy save` creates a portable environment file. `copy open` verifies its exact
 identity, package Git trees, computer compatibility, and Lean probe before
-making the environment available. See [Portable copies and environment
+making the environment available. The former `save-copy` and `open-copy`
+spellings remain compatibility aliases. See [Portable copies and environment
 libraries](portable-copies.md) for its trust boundary.
 
 ## Slim toolchains

{lean_runtime-2.7.0 → lean_runtime-2.8.0}/docs/getting-started.md

@@ -21,17 +21,19 @@ shared exact dependencies:
 lean-runtime init MyProof
 cd MyProof
 lean-runtime check MyProof/Basic.lean
+lean-runtime check MyProof/Basic.lean --watch
 lean-runtime check
 lean-runtime build
 ```
 
 By default, `init` writes an `AGENTS.md` explaining the project workflow and
 shared-dependency safety rules to coding agents. Pass `--no-agents` to omit it.
-An existing file is preserved. The generated root imports only the project's
+An existing file is preserved. Pass `--ci` to generate a workflow that checks
+the same exact committed project graph. The generated root imports only the project's
 local `Basic` module; add the narrow Mathlib imports each implementation file
 needs rather than paying for the all-Mathlib umbrella on every root import.
 
-Use `--mathlib 4.33.0` to select that release explicitly, or `--core` for a
+Use `--mathlib-version 4.33.0` to select that release explicitly, or `--core` for a
 core-only library. The root project remains an ordinary mutable Lake project;
 its dependency sources and build artifacts are reused by other projects with
 the same exact graph.
@@ -81,6 +83,8 @@ lean-runtime scan ~/research
 ```
 
 `scan` only records exact local graphs as possible future zero-download seeds.
+The converged spelling is `lean-runtime project scan`; `project attach`,
+`project detach`, and `project update` group the other dependency-graph actions.
 Advanced bulk migration remains available through `attach`. See [Local Lake
 projects](local-projects.md) for detachment, storage estimates, and the complete
 safety model.

{lean_runtime-2.7.0 → lean_runtime-2.8.0}/docs/local-projects.md

@@ -46,6 +46,7 @@ each repository's `.lake/packages`. New projects can start in shared mode:
 lean-runtime init MyProof
 cd MyProof
 lean-runtime check MyProof/Basic.lean
+lean-runtime check MyProof/Basic.lean --watch
 lean-runtime check
 lean-runtime build
 ```
@@ -64,12 +65,19 @@ stays silent. Only root-project outputs enter this cache: locked dependencies
 continue to use the verified shared workspace, avoiding a second multi-gigabyte
 copy. `build` retains Lake's complete target semantics.
 
+Repeated file checks reuse Lean's native header snapshots, keyed by the exact
+toolchain, project identity, and import block. Body-only edits therefore avoid
+reloading the unchanged import environment. `--watch` is a thin save loop over
+the same ordinary check/result contract. Failed checks may add exact-graph
+identifier hints derived from pinned `.ilean` indexes; raw Lean streams remain
+unchanged.
+
 The generated files are a standard Lake project plus a small
 `lean-runtime.toml`. Root build outputs stay local; exact dependencies are
 shared. The generated root imports only its local `Basic` module, leaving
 implementation files free to select precise Mathlib modules. The newest stable
 cataloged Mathlib is selected by default. Select a
-release with `--mathlib 4.33.0`, or use `--core` for a core-only library.
+release with `--mathlib-version 4.33.0`, or use `--core` for a core-only library.
 `init` also creates an `AGENTS.md` describing the safe
 build and dependency workflow unless `--no-agents` is passed; it never
 overwrites an existing guide.