Move pkgs/env.txt lockfile to conda-meta/initial-state.explicit.txt to preserve it

constructor/nsis/main.nsi.tmpl

@@ -1382,6 +1382,8 @@ Section "Install"
     # A conda-meta\history file is required for a valid conda prefix
     SetOutPath "{{ env.conda_meta }}"
     File "{{ env.history_abspath }}"
+    # We also place a copy of the env.txt file here, as a lockfile
+    File /oname=initial-state.lockfile.txt "{{ env.env_txt_abspath }}"
 
     # Set channels
     System::Call 'kernel32::SetEnvironmentVariable(t,t)i("CONDA_CHANNELS", "{{ channels }}").r0'

constructor/osx/run_installation.sh

@@ -60,6 +60,8 @@ fi
 
 # Move the prepackaged history file into place
 mv "$PREFIX/pkgs/conda-meta/history" "$PREFIX/conda-meta/history"
+# Place a copy of the input lockfile in conda-meta for future, potential restoring
+cp "$PREFIX/pkgs/env.txt" "$PREFIX/conda-meta/initial-state.lockfile.txt"
 rm -f "$PREFIX/env.txt"
 
 # Same, but for the extra environments
@@ -102,7 +104,8 @@ for env_pkgs in "${PREFIX}"/pkgs/envs/*/; do
     "$CONDA_EXEC" install --offline --file "${env_pkgs}env.txt" -yp "$PREFIX/envs/$env_name" $env_shortcuts {{ no_rcs_arg }} || exit 1
     # Move the prepackaged history file into place
     mv "${env_pkgs}/conda-meta/history" "$PREFIX/envs/$env_name/conda-meta/history"
-    rm -f "${env_pkgs}env.txt"
+    # Move the input lockfile in conda-meta for future, potential restoring
+    mv "${env_pkgs}env.txt" "$PREFIX/envs/$env_name/conda-meta/initial-state.lockfile.txt"
 done
 
 # Cleanup!

constructor/shar.py

@@ -170,13 +170,20 @@ def create(info, verbose=False):
         pre_t.add(record_file_src, record_file_dest)
     pre_t.addfile(tarinfo=tarfile.TarInfo("conda-meta/history"))
     post_t.add(join(tmp_dir, "conda-meta", "history"), "conda-meta/history")
+    # Place a copy of the lockfile in conda-meta for future, potential restoring
+    post_t.add(join(tmp_dir, "env.txt"), "conda-meta/initial-state.lockfile.txt")
 
     for env_name in info.get("_extra_envs_info", {}):
         pre_t.addfile(tarinfo=tarfile.TarInfo(f"envs/{env_name}/conda-meta/history"))
         post_t.add(
             join(tmp_dir, "envs", env_name, "conda-meta", "history"),
             f"envs/{env_name}/conda-meta/history",
         )
+        # Place a copy of the lockfile in conda-meta for future, potential restoring
+        post_t.add(
+            join(tmp_dir, "envs", env_name, "env.txt"),
+            f"envs/{env_name}/conda-meta/initial-state.lockfile.txt",
+        )
 
     extra_files = copy_extra_files(info.get("extra_files", []), tmp_dir)
     for path in extra_files:

constructor/winexe.py

@@ -83,9 +83,8 @@ def setup_envs_commands(info, dir_path):
             "prefix": r"$INSTDIR",
             "env_txt": r"$INSTDIR\pkgs\env.txt",  # env.txt as seen by the running installer
             "env_txt_dir": r"$INSTDIR\pkgs",  # env.txt location in the installer filesystem
-            "env_txt_abspath": join(
-                dir_path, "env.txt"
-            ),  # env.txt path while building the installer
+            # env.txt path while building the installer
+            "env_txt_abspath": join(dir_path, "env.txt"),
             "conda_meta": r"$INSTDIR\conda-meta",
             "history_abspath": join(dir_path, "conda-meta", "history"),
             "final_channels": get_final_channels(info),

news/1059-lockfiles

@@ -0,0 +1,19 @@
+### Enhancements
+
+* Ship `conda-meta/initial-state.lockfile.txt` as a copy of the lockfile that provisions the initial state of each environment. (#1052 via #1059)
+
+### Bug fixes
+
+* <news item>
+
+### Deprecations
+
+* <news item>
+
+### Docs
+
+* <news item>
+
+### Other
+
+* <news item>

tests/test_examples.py

@@ -465,7 +465,17 @@ def test_example_extra_pages_win(tmp_path, request, extra_pages, monkeypatch):
 def test_example_extra_envs(tmp_path, request):
     input_path = _example_path("extra_envs")
     for installer, install_dir in create_installer(input_path, tmp_path):
-        _run_installer(input_path, installer, install_dir, request=request)
+        _run_installer(input_path, installer, install_dir, request=request, uninstall=False)
+        assert (
+            "@EXPLICIT" in (install_dir / "conda-meta" / "initial-state.lockfile.txt").read_text()
+        )
+        for env in install_dir.glob("envs/*/conda-meta/"):
+            envtxt / "initial-state.lockfile.txt"
+            assert envtxt.exists()
+            assert "@EXPLICIT" in envtxt.read_text()
+
+        if sys.platform.startswith("win"):
+            _run_uninstaller_exe(install_dir=install_dir)
 
 
 def test_example_extra_files(tmp_path, request):