lockmaster 0.0.1__tar.gz → 0.0.2__tar.gz

{lockmaster-0.0.1 → lockmaster-0.0.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lockmaster
-Version: 0.0.1
+Version: 0.0.2
 Summary: Lands AI-agent changes into main one at a time, without ever losing work.
 Author: Arpit Arya
 License-Expression: MIT
@@ -34,7 +34,7 @@ lockmaster puts the changes onto `main` one at a time — only the claimed files
 generated files rebuilt, your checks run — and cleans up after each. Like a
 canal lock-keeper: one boat through at a time, the water levels kept safe.
 
-> **Status: 0.0.1, pre-alpha.** 0.0.1 holds the name on PyPI. Claims, the
+> **Status: 0.0.2, pre-alpha.** On PyPI since 0.0.1 (2026-11-08). Claims, the
 > queue, landing, generated files, structural merges, the kit's hooks and
 > `install` are built and tested on scratch repositories; commands and files
 > may still change before 0.1.0. The design of
@@ -44,7 +44,7 @@ canal lock-keeper: one boat through at a time, the water levels kept safe.
 ## Install
 
 ```bash
-pip install lockmaster            # Python ≥ 3.9, no dependencies
+uv tool install lockmaster        # or pipx / pip; Python ≥ 3.9, no dependencies
 lockmaster install .              # the work-system kit into this repository, pinned
 ```
 

{lockmaster-0.0.1 → lockmaster-0.0.2}/README.md

@@ -10,7 +10,7 @@ lockmaster puts the changes onto `main` one at a time — only the claimed files
 generated files rebuilt, your checks run — and cleans up after each. Like a
 canal lock-keeper: one boat through at a time, the water levels kept safe.
 
-> **Status: 0.0.1, pre-alpha.** 0.0.1 holds the name on PyPI. Claims, the
+> **Status: 0.0.2, pre-alpha.** On PyPI since 0.0.1 (2026-11-08). Claims, the
 > queue, landing, generated files, structural merges, the kit's hooks and
 > `install` are built and tested on scratch repositories; commands and files
 > may still change before 0.1.0. The design of
@@ -20,7 +20,7 @@ canal lock-keeper: one boat through at a time, the water levels kept safe.
 ## Install
 
 ```bash
-pip install lockmaster            # Python ≥ 3.9, no dependencies
+uv tool install lockmaster        # or pipx / pip; Python ≥ 3.9, no dependencies
 lockmaster install .              # the work-system kit into this repository, pinned
 ```
 

{lockmaster-0.0.1 → lockmaster-0.0.2}/kit/claude/hooks/auto-land.py

@@ -17,14 +17,18 @@ Claude Code does.
                              background (the session is going away)
 
 lockmaster is found at `$LOCKMASTER_SRC`, in this repository's own `src/`
-(lockmaster itself), in a `lockmaster` checkout beside this repository, or as
-an installed package. Without it the hook does nothing.
+(lockmaster itself), as a package this interpreter imports, or in the
+environment of the `lockmaster` command on PATH (`uv tool install lockmaster`,
+pipx). A checkout beside the repository is never used: every other repository
+runs the published package (SR-ARCHITECTURE decision 17, W-16). Without it the
+hook does nothing.
 It never fails a session: every error is swallowed and the turn ends as usual.
 Python >= 3.9, standard library only.
 """
 import hashlib
 import json
 import os
+import shutil
 import subprocess
 import sys
 import time
@@ -57,11 +61,23 @@ def candidates():
     root = main_root(ROOT)
     if root is not None:
         yield root / "src"
-        yield root.parent / "lockmaster" / "src"
+
+
+def command_env():
+    """The site-packages holding the `lockmaster` command's own package: a `uv tool`
+    or pipx install lives in an environment this interpreter cannot import."""
+    exe = shutil.which("lockmaster")
+    if not exe:
+        return None
+    env = Path(exe).resolve().parent.parent
+    for site in sorted(env.glob("lib/python3*/site-packages")) + [env / "Lib" / "site-packages"]:
+        if (site / "lockmaster" / "land.py").is_file():
+            return str(site)
+    return None
 
 
 def find_src():
-    """The directory to put on sys.path, "" when lockmaster is installed, None when absent."""
+    """The directory to put on sys.path, "" when lockmaster is importable, None when absent."""
     for c in candidates():
         if (c / "lockmaster" / "land.py").is_file():
             return str(c)
@@ -69,7 +85,7 @@ def find_src():
         import lockmaster  # noqa: F401
         return ""
     except ImportError:
-        return None
+        return command_env()
 
 
 def load():
@@ -84,7 +100,9 @@ def load():
 
 
 def command(src):
-    return "PYTHONPATH={} python3 -m lockmaster".format(src) if src else "lockmaster"
+    if not src or src == command_env():
+        return "lockmaster"
+    return "PYTHONPATH={} python3 -m lockmaster".format(src)
 
 
 def detach(src, args, cwd):

{lockmaster-0.0.1 → lockmaster-0.0.2}/kit/claude/hooks/now-ledger.py

@@ -89,13 +89,31 @@ def read_now():
     return head.rstrip() + "\n", flight, res
 
 
+def command_env():
+    """The site-packages of the `lockmaster` command on PATH (`uv tool`, pipx)."""
+    import shutil
+    exe = shutil.which("lockmaster")
+    if not exe:
+        return None
+    env = Path(exe).resolve().parent.parent
+    for site in sorted(env.glob("lib/python3*/site-packages")) + [env / "Lib" / "site-packages"]:
+        if (site / "lockmaster" / "now.py").is_file():
+            return site
+    return None
+
+
 def renderer():
-    """lockmaster's NOW.md renderer (`lockmaster.now`) when it is importable —
-    installed, or this repository's own src/ — so NOW.md always equals
-    `lockmaster status --now` (SR-ARCHITECTURE decision 14, W-07)."""
-    for extra in (None, ROOT / "src"):
+    """lockmaster's NOW.md renderer (`lockmaster.now`) when it is reachable —
+    this repository's own src/, importable, or the `lockmaster` command's
+    environment — so NOW.md always equals `lockmaster status --now`
+    (SR-ARCHITECTURE decision 14, W-07)."""
+    for extra in (None, ROOT / "src", "command"):
+        if extra == "command":
+            extra = command_env()
+            if extra is None:
+                continue
         if extra is not None:
-            if not (extra / "lockmaster" / "now.py").is_file():
+            if not (Path(extra) / "lockmaster" / "now.py").is_file():
                 continue
             sys.path.insert(0, str(extra))
         try:

{lockmaster-0.0.1 → lockmaster-0.0.2}/kit/claude/skills/landing/SKILL.md

@@ -11,9 +11,11 @@ a session that can. **Do not ask the decider about commits, lock files,
 worktrees, `index.lock` or "Operation not permitted". Do not try another git
 command to get around a refusal.**
 
-`lockmaster` below means `lockmaster` if it is on the PATH, else
-`PYTHONPATH=<the lockmaster checkout>/src python3 -m lockmaster` (beside this
-repository, e.g. `../lockmaster/src`).
+`lockmaster` below is the published package's command: `uv tool install
+lockmaster` (or `pipx install lockmaster`) puts it on the PATH once per
+machine. A lockmaster checkout beside this repository is never used — this
+repository runs the release on PyPI. Not on the PATH → say so in one line
+and stop; do not run lockmaster from a checkout.
 
 ## Cowork, or any session editing main's checkout directly
 

{lockmaster-0.0.1 → lockmaster-0.0.2}/src/lockmaster/__init__.py

@@ -1,3 +1,3 @@
 """lockmaster — lands AI-agent changes into main one at a time (SR-ARCHITECTURE)."""
 
-__version__ = "0.0.1"
+__version__ = "0.0.2"

{lockmaster-0.0.1 → lockmaster-0.0.2}/src/lockmaster.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lockmaster
-Version: 0.0.1
+Version: 0.0.2
 Summary: Lands AI-agent changes into main one at a time, without ever losing work.
 Author: Arpit Arya
 License-Expression: MIT
@@ -34,7 +34,7 @@ lockmaster puts the changes onto `main` one at a time — only the claimed files
 generated files rebuilt, your checks run — and cleans up after each. Like a
 canal lock-keeper: one boat through at a time, the water levels kept safe.
 
-> **Status: 0.0.1, pre-alpha.** 0.0.1 holds the name on PyPI. Claims, the
+> **Status: 0.0.2, pre-alpha.** On PyPI since 0.0.1 (2026-11-08). Claims, the
 > queue, landing, generated files, structural merges, the kit's hooks and
 > `install` are built and tested on scratch repositories; commands and files
 > may still change before 0.1.0. The design of
@@ -44,7 +44,7 @@ canal lock-keeper: one boat through at a time, the water levels kept safe.
 ## Install
 
 ```bash
-pip install lockmaster            # Python ≥ 3.9, no dependencies
+uv tool install lockmaster        # or pipx / pip; Python ≥ 3.9, no dependencies
 lockmaster install .              # the work-system kit into this repository, pinned
 ```
 

{lockmaster-0.0.1 → lockmaster-0.0.2}/tests/test_kit_hooks.py

@@ -262,3 +262,51 @@ class KitNamesNoRepositoryRule(unittest.TestCase):
 
 if __name__ == "__main__":
     unittest.main()
+
+
+class HooksFindThePublishedPackage(Installed):
+    """W-16: a repository runs the published package. The hooks find lockmaster in
+    the `lockmaster` command's own environment (`uv tool`, pipx) and never in a
+    checkout beside the repository."""
+
+    PROBE = ("import importlib.util, sys\n"
+             "s = importlib.util.spec_from_file_location('h', sys.argv[1])\n"
+             "m = importlib.util.module_from_spec(s); s.loader.exec_module(m)\n"
+             "print(getattr(m, sys.argv[2])())\n")
+
+    def probe(self, hook, fn, path):
+        env = {k: v for k, v in os.environ.items() if k not in ("LOCKMASTER_SRC", "PYTHONPATH")}
+        env["PATH"] = path
+        r = subprocess.run([sys.executable, "-I", "-c", self.PROBE, str(self.root / ".claude" / "hooks" / hook), fn],
+                           capture_output=True, text=True, env=env, cwd=str(self.root))
+        self.assertEqual(r.returncode, 0, r.stderr)
+        return r.stdout.strip()
+
+    def tool_env(self):
+        env = self.root.parent / "tools" / "lockmaster"
+        site = env / "lib" / "python3.13" / "site-packages"
+        shutil.copytree(str(ROOT_SRC / "lockmaster"), str(site / "lockmaster"))
+        (env / "bin").mkdir(parents=True)
+        exe = env / "bin" / "lockmaster"
+        exe.write_text("#!/bin/sh\n")
+        exe.chmod(0o755)
+        return env / "bin", site
+
+    def test_auto_land_finds_the_commands_environment(self):
+        bindir, site = self.tool_env()
+        path = os.pathsep.join([str(bindir), os.path.dirname(shutil.which("git"))])
+        self.assertEqual(self.probe("auto-land.py", "find_src", path), str(site.resolve()))
+
+    def test_now_ledger_finds_the_commands_environment(self):
+        bindir, _ = self.tool_env()
+        path = os.pathsep.join([str(bindir), os.path.dirname(shutil.which("git"))])
+        self.assertNotEqual(self.probe("now-ledger.py", "renderer", path), "None")
+
+    def test_a_checkout_beside_the_repository_is_never_used(self):
+        beside = self.root.parent / "lockmaster" / "src"
+        shutil.copytree(str(ROOT_SRC / "lockmaster"), str(beside / "lockmaster"))
+        path = os.path.dirname(shutil.which("git"))
+        self.assertEqual(self.probe("auto-land.py", "find_src", path), "None")
+
+
+from support import SRC as ROOT_SRC  # noqa: E402