lean-lockstep 0.1.0__py3-none-any.whl

lean_lockstep-0.1.0.dist-info/METADATA

@@ -0,0 +1,218 @@
+Metadata-Version: 2.4
+Name: lean-lockstep
+Version: 0.1.0
+Summary: Coordinate several agents on a Lean 4 formalization: state derived from the compiled environment, locked statements, recorded claims and memory-guarded jobs
+Author: Gavin Litchfield
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/GLitchfield/lean-lockstep
+Project-URL: Repository, https://github.com/GLitchfield/lean-lockstep
+Project-URL: Issues, https://github.com/GLitchfield/lean-lockstep/issues
+Project-URL: Changelog, https://github.com/GLitchfield/lean-lockstep/blob/main/CHANGELOG.md
+Keywords: lean4,formalization,theorem-proving,blueprint,ai-agents,mcp
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Science/Research
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Mathematics
+Classifier: Topic :: Software Development :: Build Tools
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: mcp
+Requires-Dist: mcp<3,>=2; extra == "mcp"
+Provides-Extra: test
+Requires-Dist: pytest; extra == "test"
+Provides-Extra: research
+Requires-Dist: numpy; extra == "research"
+Dynamic: license-file
+
+# lean-lockstep
+
+A project harness for Lean 4 formalization work done by several agents at once: AI coding agents
+of any kind (anything that can run a shell command or call an MCP tool) and people. It keeps the
+state of the project (which statements are open, claimed, proved, and what depends on what)
+derived from the compiled Lean environment, and it records who is doing what, why, and with how
+much memory.
+
+- **State comes from Lean, not from a document.** Each open statement is a *node*: a theorem
+  with a `sorry` in its own blueprint module, tagged in its docstring. `lockstep extract` reads the
+  compiled environment and reports each node as open, claimed or closed (sorry-free with
+  allowlisted axioms). There is no hand-kept status file that can drift.
+- **Approved statements are locked.** `harness/statements.lock` records the type hash of every
+  approved statement. A proof that quietly weakens its statement shows up as a lock violation;
+  changing a statement takes `lockstep node restate`, which logs who approved it and why. This is the
+  failure mode that matters most when agents write the proofs.
+- **Agents coordinate through the harness.** Claims expire and carry the intent (`--why`); every
+  release records an outcome; `lockstep log` and `lockstep journal` keep the trail; long commands run as
+  recorded, memory-capped jobs that every agent can see.
+- **Audits scale.** The axiom audit is a per-module taint scan with a cache, which finishes on
+  projects where `#print axioms` does not.
+- **No client or model is assumed.** Every command has a CLI and an MCP tool. A git pre-commit
+  hook guards commits for everyone; optional Claude Code hooks add a session banner and a guard
+  against compute launched outside the harness.
+
+Status: experimental (0.1). Built and used in two research projects; expect rough edges outside
+them. Linux first.
+
+## Requirements
+
+- Python 3.11 or newer. The core has no dependencies; extras: `mcp` (MCP server), `test`
+  (pytest), `research` (NumPy for research-library probes).
+- Lean 4 through [elan](https://github.com/leanprover/elan), Lake, and git.
+- The memory guard runs each `lake` invocation in a capped `systemd-run --user` scope, so it
+  needs Linux with a systemd user session. Elsewhere set `[build] guard = false`.
+- `bwrap` (bubblewrap) for the sandboxed proof checks of the experimental automation layer.
+
+## Try it
+
+`examples/minimal` is a Lean-only Lake project (no Mathlib) with one core lemma and an empty
+blueprint. From a checkout of this repository:
+
+```console
+cd examples/minimal
+export LOCKSTEP_AGENT=me:demo            # every claim, job and log entry is recorded under this id
+../../bin/lockstep build core
+../../bin/lockstep extract               # writes harness/nodes.json, index.json, status.md
+../../bin/lockstep node add --name double_succ --ws A --kind formalization \
+  --type "(n : Nat) : (n + 1) + (n + 1) = 2 * n + 2" \
+  --description "Doubling a successor." --depends double --dangling-ok "example"
+../../bin/lockstep ready                 # Demo.double_succ is open and ready
+../../bin/lockstep claim double_succ --why "rewrite with Demo.double, then omega"
+# replace the `sorry` in DemoBlueprint/A/DoubleSucc.lean with `rw [double]; omega`
+../../bin/lockstep check double_succ     # sorry=False status=closed
+../../bin/lockstep close double_succ     # moves it into the core library, records the attempt
+../../bin/lockstep audit && ../../bin/lockstep journal
+```
+
+`tests/test_example_lifecycle.py` runs the same sequence whenever `lake` is installed. To start
+over, run `git checkout -- . && git clean -fdx .` in `examples/minimal`.
+
+## Installing
+
+The harness writes Lean files into the project (the extractor, node modules) and its lock hashes
+depend on the toolchain, so pin the version a project uses. Either:
+
+- **From PyPI**, which puts `lockstep` and `lockstep-mcp` on the `PATH`:
+  ```console
+  uv tool install "lean-lockstep[mcp]==0.1.0"     # or: pipx install "lean-lockstep[mcp]==0.1.0"
+  ```
+  Without PyPI access, install a tag from git instead:
+  `uv tool install "lean-lockstep[mcp] @ git+https://github.com/GLitchfield/lean-lockstep@v0.1.0"`.
+- **As a git submodule**, pinned by commit and upgraded by bumping the pin, which suits a project
+  that also develops the harness:
+  ```console
+  git submodule add https://github.com/GLitchfield/lean-lockstep tools/lockstep
+  uv venv tools/lockstep/.venv && uv pip install -e "tools/lockstep[mcp]"
+  ```
+  `tools/lockstep/bin/lockstep` and `tools/lockstep/bin/lockstep-mcp` prefer that virtualenv and
+  fall back to the system `python3`.
+
+The commands below write `lockstep`; with a submodule, that is `tools/lockstep/bin/lockstep`.
+
+## Adopting it in a project
+
+1. Give the Lake package two libraries: a core library (proved results only) and a blueprint
+   library whose root file imports every node module. `lockstep node add` maintains that root.
+2. Copy `examples/minimal/harness/` and edit `harness/config.toml`: namespaces, layers, build
+   targets, memory caps. Start `statements.lock` as `{}` and `allowlist.json` as `[]`.
+3. Ignore the harness state directory (`.lockstep/` with `[project] state_home = ".lockstep"`).
+4. Write the agent rules into the files your clients read (`AGENTS.md`, `CLAUDE.md`, ...) and
+   list them under `[rules]`; `lockstep rules` checks that they carry the same rule list (cheap enough
+   for CI). `examples/minimal/AGENTS.md` is a starting point. Tell each agent to export a stable
+   `LOCKSTEP_AGENT` (for example `<client>:<session id>`); claims and logs are recorded under it.
+5. Guard commits with the git hook, which works whoever commits:
+   ```console
+   printf '#!/bin/sh\nexec lockstep hook pre-commit\n' > .git/hooks/pre-commit && chmod +x .git/hooks/pre-commit
+   ```
+   It refuses a commit that fails `lockstep layers`, `lockstep extract --check` (generated files out of date
+   or a locked statement changed) or `lockstep audit --changed`.
+6. Register the MCP server with your client: command `lockstep-mcp` (or `tools/lockstep/bin/lockstep-mcp`), stdio,
+   no arguments. For example `.mcp.json`:
+   ```json
+   { "mcpServers": { "lockstep": { "command": "tools/lockstep/bin/lockstep-mcp", "args": [] } } }
+   ```
+7. Optionally, for Claude Code, add the session and shell hooks to `.claude/settings.json`:
+   ```json
+   { "hooks": {
+       "SessionStart": [{ "hooks": [{ "type": "command", "command": "tools/lockstep/bin/lockstep hook session-start" }] }],
+       "PreToolUse": [{ "matcher": "Bash", "hooks": [{ "type": "command", "command": "tools/lockstep/bin/lockstep hook pre-bash" }] }] } }
+   ```
+   `session-start` prints the session's agent id and `lockstep status --brief`. `pre-bash` blocks a
+   bare `nohup`/`systemd-run` (compute goes through `lockstep job run`) and runs the commit guard
+   before `git commit`/`git push`. Any client whose hooks pass the same JSON on stdin can use them.
+8. In CI, `python3 -m lockstep.lock BASE_LOCK HEAD_LOCK` (with `PYTHONPATH=tools/lockstep` for a submodule)
+   prints the log files a lock change must touch: `restatements.md` when an approved statement
+   changed or disappeared, `retired.md` for a refutation. New entries need none.
+9. Optionally, `tools/lockstep/systemd/install.sh` (from a checkout) installs a `lockstep-nightly-<project
+   id>` user timer (03:00) that runs the guarded core build, `lockstep extract --check` and `lockstep audit`.
+
+## Commands
+
+| Area | Commands |
+|---|---|
+| State | `status`, `ready`, `node show`, `search`, `extract`, `extract --check`, `doctor` |
+| Statements | `node add`, `node restate`, `node retire`, `lock refresh` (after a toolchain bump) |
+| Work | `claim`, `release`, `check`, `close`, `falsify` (conjecture nodes) |
+| Builds and jobs | `build core` / `blueprint` / `node`, `job run`, `job wait`, `job list`, `worker` |
+| Trail | `log`, `journal`, `note` (weekly summary) |
+| Integrity | `audit`, `layers`, `rules`, `hook pre-commit` |
+| Client hooks | `hook session-start`, `hook pre-bash` |
+
+Every command takes `--json`, and all but the hooks are also MCP tools. Node names may be
+dotted relative to the declaration namespace (`--name List.foo` declares `theorem List.foo` in
+it), and `--depends` lists the project declarations a node waits on (library lemmas belong in
+the description).
+
+### Experimental
+
+These work in the projects they came from but are less general; see
+[`docs/automation.md`](docs/automation.md):
+
+- **Automation layer**: durable `operation …` workflows run by `lockstep worker`, a results `inbox`,
+  `proof capture|check|prove`, `node finish`, `probe run|replay`, `context`.
+- **Research library**: `lib search|show|list` over a project catalog
+  (`harness/research/catalog.json`).
+- **Certificate layers**: `[layers]` rules for generated proof-module families, and
+  `storage share` for their compiled artifacts.
+
+## Things that cost hours to learn
+
+- **Never `import` the project modules at the top of a `lake env lean --run` script that also
+  calls `importModules` on them.** The script's own import maps the oleans; the second load
+  cannot mmap at the same addresses and reads them into anonymous memory instead (37 GB and a
+  cgroup OOM kill on a project with large certificate modules). The extractor template imports
+  only `Lean`; `main` imports the project.
+- **Never use `importAll := true`** for the extractor environment (30+ GB). A plain import
+  exposes every theorem value in `env.header.moduleData`.
+- **Never run bare `lake build` on big targets.** Lake 5 has no `-j`; two dozen parallel
+  compilers exhaust a 20 GB guard. `lockstep build` builds Lake's out-of-date list one module per
+  guarded invocation first.
+- **`#print axioms` does not finish on large generated proof families** (16 TB read in 3.5 h);
+  the extractor's module-order taint scan with a per-module cache is the audit path.
+- **A module-system core root (`module` header) cannot import plain files.** When the core root
+  uses it, nodes are written in module form from the start, so a proof elaborates against the
+  same imports before and after `lockstep close`.
+- **The elaborator moves parts of a proof into auxiliary declarations** (`foo._proof_1`), so a
+  dependency scan of a theorem's value alone reports the auxiliaries instead of the lemmas they
+  use. The extractor looks through a declaration's own auxiliaries.
+
+## Development
+
+```console
+uv venv .venv && uv pip install -e ".[test,mcp,research]"
+.venv/bin/python -m pytest
+```
+
+Releases follow semantic versioning (0.x: minor versions may break). Changes are listed in
+[`CHANGELOG.md`](CHANGELOG.md). To release, bump `__version__` in `lockstep/__init__.py`, add the
+changelog entry, and push a `vX.Y.Z` tag: `.github/workflows/release.yml` builds the sdist and
+wheel and publishes them to PyPI through trusted publishing.
+
+## License
+
+MIT; see [`LICENSE`](LICENSE).

lean_lockstep-0.1.0.dist-info/RECORD

@@ -0,0 +1,71 @@
+lean_lockstep-0.1.0.dist-info/licenses/LICENSE,sha256=FRI9ysgFGRFWTgdRUuJ7EryPx7thYVvmRICme89SwHo,1133
+lockstep/__init__.py,sha256=jnxyg-EVE_XpyYkgdpkgwerj1D2qImhto_QVByFS0L4,508
+lockstep/__main__.py,sha256=Odn24AAjrNqQllq6d-xtA79UrYAx0ulq-sa6FFhInVY,56
+lockstep/allowlist.py,sha256=g9YdlAlFEk8eBCJLzD3rBDFBd7dmt4owo5tsfhrJfEg,1309
+lockstep/artifact_cache.py,sha256=YKUxb9XPlyKMknoRKYh3Vknq-_68sa5d796149alrCE,21870
+lockstep/artifacts.py,sha256=2uA9vTelY4NbEfvhnYrPiTA0yBoRehsPaFWvJYKnWoE,8190
+lockstep/automation_schema.py,sha256=KcSqxDMPLcvHdhF28hB5qANLhlYURvB-MSZMzp3Zbtk,2007
+lockstep/build.py,sha256=sTJnA48apX0SLShqPCbgBpEDthgQe_4Jt6cDy9ODoTs,22999
+lockstep/bundles.py,sha256=_qAWfO2VYjYzOVy2faujecuWNj9e-vbXlKzSWL5PQC8,2093
+lockstep/cli.py,sha256=aZLpCAtREDTM9VOdjj8T92MgfTtkIYgsxqkTp2Ggfv4,6536
+lockstep/config.py,sha256=9E9TOo-UMYFeMMGnaNV-2zckCbjj9bQ6Jh8-kuZZhIY,18487
+lockstep/context.py,sha256=tLi8_DIwBpBANwcHRmVnWRexVsK899ZcvD10mTVmTps,816
+lockstep/delivery.py,sha256=9KKK3dfdcpjP1ydHvVuWnvyYZxh3z7J2SN6nsjqfqp0,2295
+lockstep/errors.py,sha256=m28f9pjQyUrn3gBmaxcMbR8H3jVmjohrgrwbFi1vOaI,597
+lockstep/finalize.py,sha256=u5NknUm_GClpifJbyDPzbqdA86NMcm6UPgos2RbLXQI,6256
+lockstep/gitutil.py,sha256=P4WbY8SlcgUAI1Oj1UeeOPs9AydAALCHU4H3sCzmKgs,3455
+lockstep/hooks.py,sha256=FUkc81wSslX78Jq4LnTV4bLfQLrUpSWa5tO6Ubfner8,6501
+lockstep/jobs.py,sha256=5alv4UCxo30jyQ1SKb6r2QNt0G4w2B8TQtAEAamG8Bw,17690
+lockstep/layers.py,sha256=IeodoeIuz5DbpKKoLPENnRQz7C5ktkQHcBMbQbnE8-0,7153
+lockstep/lean.py,sha256=Xm2_6-r_MknvM8ACnZ5XQ-WpzBSW4nMLtyqYQj7UIuk,4638
+lockstep/library.py,sha256=dWTz0BUKtym_CgUh6cDMpGgQBjoleVtkF0r4wTZa4Hs,7520
+lockstep/lock.py,sha256=MHFhI276l3_ykmUpFTucOQQc3Y2Z5G3lLwL4A_DhEZ8,2635
+lockstep/mcp_server.py,sha256=Pr98jBYxdQ7SCTKLXYChyYQF8d5e554NWDxvOesMkSk,3277
+lockstep/metrics.py,sha256=7HrVcjCGtrM_KbkfhVOVVPNfb47ALTIPAPctd5dZ69I,463
+lockstep/modules.py,sha256=xIJyovRvA1cQCVjxYa_oUjm9QVda-EodHSKnTr_N5w0,6685
+lockstep/nodes.py,sha256=-jT19FMYdAnF_-XMbFnlRL4u2dgqBBfRpl5EXxwqVas,19203
+lockstep/operations.py,sha256=W7BKc-iGQrOi4_eDq2maILmE1Le3F__p7I2rlyFY9qk,18253
+lockstep/output.py,sha256=TqYzKtCx8FLv_myo4NUEzz4C9N1OR9nEjci-uqF_rCQ,1393
+lockstep/probes.py,sha256=MtUHZJiAVBFBQqVxoUlGEWpzbx93n7dtSPRltC64tVA,3260
+lockstep/proofs.py,sha256=zyJVZJfJXmB7fAgqWdssrUtHPoh4HeqQwNNr8u2XpY8,13212
+lockstep/resources.py,sha256=9uaPqa7rQtL1Kid473-bCKfJpeRW4ThaUSMF51Lp2aM,4677
+lockstep/shadow_index.py,sha256=z626y8BNBIklAt7WFk7Ix-918-SfgFy67qRY8bVyukA,2723
+lockstep/spec.py,sha256=h124-0IVxX23Yjj60Cnm5RVsRLUDdhlF7Wjr8lPNGj4,918
+lockstep/stage_runner.py,sha256=Wu84Wu1JlELSxKuOiVw1IqGWpx9C8qQFjiNcQ8Op3As,1795
+lockstep/storage.py,sha256=Iz74tWn6Mv6C_FjtI4lTOYxL8mXsWjzFIYK8YCc64Z0,6905
+lockstep/store.py,sha256=MoXCDkKTTVGBFFg_ilEmPNK4DzmqPB9jZQWzqdL_9Xg,17071
+lockstep/tags.py,sha256=x7vzm4FCE_1XF8XVwtScoib4e6ozP7fCWs0TxsGf-Vo,2837
+lockstep/commands/__init__.py,sha256=ELPjq-vnW-KlU8JbmPGyoXlM3fHXJyp8dKIBYSLRT4g,403
+lockstep/commands/audit.py,sha256=WNS5CKFw3uAYz6XVMd55XSLCkvmScgODNAMfd2ITBRk,2269
+lockstep/commands/automation.py,sha256=yqWTo8id3FRBdUdEGyesbZjOqySk4hJUH-ITFEgN-dU,4913
+lockstep/commands/build.py,sha256=LTQXLlc8mqnPxolpZ-81Khzw5kpXJxfLIctaZF_3ESY,2699
+lockstep/commands/cache.py,sha256=4OXCGrL1TbGMBkCbHtDy4iBs_zTUl6PTlpgMmOHrX9w,2453
+lockstep/commands/check.py,sha256=jtrG9JoTWW08xTZix7-uRPuqGM5AjBS3PonHd28DXYo,4261
+lockstep/commands/claims.py,sha256=BLBN5wH_BKmstD6pX_aTzdEEyCQwKSGYk8B9z9k4JMA,3962
+lockstep/commands/close.py,sha256=VvulasoNJu5fafYdUei8gw5quSx3_5qyIQ0TV_LBgdk,10617
+lockstep/commands/doctor.py,sha256=TzmOxjXeEesbc4g9K2r71LL9bw137vwpR3UOh53qAk8,4902
+lockstep/commands/extract.py,sha256=TtXMzNyX8OxqfVkfcjFig-R1gwcFubI2_YRUVyaZChQ,8456
+lockstep/commands/falsify.py,sha256=wZDkDUiZIL3uwPSUDMbWAoOQAwaKxWA3JSaDKv61MQw,5557
+lockstep/commands/index.py,sha256=un_w696UgxQPBdauvzn_NDiBpdgZCaPZSD8DW0HN4_o,831
+lockstep/commands/jobs.py,sha256=tAOTY5mH1T1lCJHMZWf4tlhDnFyEy0IsFYJr_mAQlcQ,10797
+lockstep/commands/layers.py,sha256=_qBX2iRFdtDZ4Q7Kn-Gkfbe5k5BVl0FdsN_o3tArYog,2297
+lockstep/commands/library.py,sha256=Z2CiXTkoRvNIdzHNOqLDBZyw1Hx-0zFeIhPvuTQhZFg,2141
+lockstep/commands/lock.py,sha256=YNCSn2xCBAZZokSEJGp0cuD8kW0wl07-GVBvn8h2Zt8,2844
+lockstep/commands/log.py,sha256=1Z-55bfoNV7m1H4WWKBmS2rvuypTe7isKA6hGbi5JWw,6390
+lockstep/commands/node.py,sha256=DprWQUtnvomd2Sc3Si3IeDOxqPvTYxpoXHa4yhl4Z6I,21592
+lockstep/commands/note.py,sha256=6HO5P0e2i4JCiZCSaq6V2JdcCIqZeJrIvDTYgKxgEVg,4428
+lockstep/commands/probe.py,sha256=kAHB5ML5du41rpSjxQ4PpxZPEw5oND1zpSEq0jfKqmM,731
+lockstep/commands/proof.py,sha256=kgQh6AHd8_pjd2F461WmzzTaWpIa4HhgEjHLruVStGA,2506
+lockstep/commands/ready.py,sha256=S4NkDvKLBrWdCjvqMIM-JP_R-5rj9SzLRNMEzs-3L5w,1596
+lockstep/commands/rules.py,sha256=UpbPbINqRqK7fgIcSzbv_bkHHlwzCvDXhi6tzE71cug,2393
+lockstep/commands/search.py,sha256=1z1zp8eJDgfVLpEhaIp9256UzpdIWmuhkfTdPXAZPaQ,1818
+lockstep/commands/status.py,sha256=GOSNiqO7EKNkxLh2cN0Ifq-uHOx3SsnwY5JuaDXNSCs,7882
+lockstep/data/AuditCandidate.lean,sha256=V7aXWsYgsiQA3U2T0cqgJsjkkS_dR3M3hgMGd5latlo,730
+lockstep/data/CacheArtifacts.lean,sha256=hYOp3CJGrhMXagKagOEltwFrlcuF1CXW2iALJDJD_oA,1302
+lockstep/data/Extract.lean.tmpl,sha256=HB68q0ZKqXWY2VYpmLnMdlz6dt_NzEBoAT1lqSJnv3o,16183
+lockstep/data/node.lean.tmpl,sha256=Q_aIfa8-3BPqP1hvdWRMXybJMcgCbsgwL0_KMq3iwjY,140
+lean_lockstep-0.1.0.dist-info/METADATA,sha256=25D-YVzjDILAv801PfdvkpI55_rM1UqGFa6qllrjt3M,12357
+lean_lockstep-0.1.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+lean_lockstep-0.1.0.dist-info/entry_points.txt,sha256=vBNlVbHFrmlj8L6S_bUxPGfRK26ZmhBog90pMkSHkjw,87
+lean_lockstep-0.1.0.dist-info/top_level.txt,sha256=QNoTwkeoY08NJpMS_9r_I9v1_ILr-ubzRM-tL-GAiAM,9
+lean_lockstep-0.1.0.dist-info/RECORD,,

lean_lockstep-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

lean_lockstep-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+lockstep = lockstep.cli:main
+lockstep-mcp = lockstep.mcp_server:main

lean_lockstep-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 Gavin Litchfield
+Copyright (c) 2026 Matt Pocock (Wayfinder-derived portions)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

lean_lockstep-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+lockstep

lockstep/__init__.py

@@ -0,0 +1,17 @@
+"""lockstep: a blueprint harness whose project state is derived from the compiled Lean environment.
+
+Nothing in this package may name a project-specific module, theorem, or path;
+all of that comes from ``harness/config.toml`` in the project root.
+"""
+
+from pathlib import Path
+
+__version__ = "0.1.0"
+
+# Lean templates and drivers shipped with the package (package data, so a wheel install works)
+DATA = Path(__file__).resolve().parent / "data"
+
+EXIT_OK = 0
+EXIT_CHECK_FAILED = 1
+EXIT_USAGE = 2
+EXIT_LEAN = 3

lockstep/__main__.py

@@ -0,0 +1,3 @@
+from lockstep.cli import main
+
+raise SystemExit(main())

lockstep/allowlist.py

@@ -0,0 +1,40 @@
+"""Axiom allowlist: which non-standard axioms may reach which declarations."""
+
+from __future__ import annotations
+
+import fnmatch
+import json
+from pathlib import Path
+
+
+def read_allowlist(path: Path) -> list[dict]:
+    if not path.exists():
+        return []
+    data = json.loads(path.read_text() or "[]")
+    return data if isinstance(data, list) else []
+
+
+def write_allowlist(path: Path, entries: list[dict]) -> None:
+    path.write_text(json.dumps(entries, indent=2, ensure_ascii=False) + "\n")
+
+
+def uncovered(entries: list[dict], name: str, axioms: list[str], standard: list[str]) -> list[str]:
+    """Axioms of ``name`` (beyond the standard set) not covered by any allowlist entry."""
+    out = []
+    for ax in axioms:
+        if ax in standard:
+            continue
+        ok = False
+        for e in entries:
+            pat = str(e.get("axiom", ""))
+            # Lean 4.29 gives every `native_decide` its own auxiliary axiom
+            # (`<decl>._native.native_decide.ax_1_1`), so entries may be globs.
+            if pat != ax and not fnmatch.fnmatchcase(ax, pat):
+                continue
+            reaches = e.get("reaches", [])
+            if "*" in reaches or name in reaches:
+                ok = True
+                break
+        if not ok:
+            out.append(ax)
+    return out