napkinstack 0.19.0__tar.gz → 0.19.2__tar.gz

{napkinstack-0.19.0 → napkinstack-0.19.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: napkinstack
-Version: 0.19.0
+Version: 0.19.2
 Summary: Engineering framework for several teams and their agents working in one repository: modules, contracts, guardrails in CI.
 License-Expression: MIT
 License-File: LICENSE
@@ -21,7 +21,7 @@ modules, contracts, guardrails in CI. On the Django or Rails model, one command
 the project, which then receives new versions on demand; no application stack is imposed.
 Positioning and vocabulary: [`PRODUCT.md`](PRODUCT.md) §1.
 
-> **Status: v0.19.0, published** on [PyPI](https://pypi.org/project/napkinstack/).
+> **Status: v0.19.2, published** on [PyPI](https://pypi.org/project/napkinstack/).
 > What each version changes, engine and project apart: [`CHANGELOG.md`](CHANGELOG.md).
 > What is open: [`docs/governance/workstreams.md`](docs/governance/workstreams.md).
 
@@ -85,8 +85,8 @@ To try it without installing anything, or to install it from this repository ins
 registry — always pinned to a release tag:
 
 ```bash
-uvx --from "git+https://github.com/NapkinStack/engineering-os@v0.19.0" nstack init my-project
-uv tool install "napkinstack @ git+https://github.com/NapkinStack/engineering-os@v0.19.0"
+uvx --from "git+https://github.com/NapkinStack/engineering-os@v0.19.2" nstack init my-project
+uv tool install "napkinstack @ git+https://github.com/NapkinStack/engineering-os@v0.19.2"
 ```
 
 **Two channels, one published artefact.** The registry publishes: the PyPI artefact of a

{napkinstack-0.19.0 → napkinstack-0.19.2}/README.md

@@ -5,7 +5,7 @@ modules, contracts, guardrails in CI. On the Django or Rails model, one command
 the project, which then receives new versions on demand; no application stack is imposed.
 Positioning and vocabulary: [`PRODUCT.md`](PRODUCT.md) §1.
 
-> **Status: v0.19.0, published** on [PyPI](https://pypi.org/project/napkinstack/).
+> **Status: v0.19.2, published** on [PyPI](https://pypi.org/project/napkinstack/).
 > What each version changes, engine and project apart: [`CHANGELOG.md`](CHANGELOG.md).
 > What is open: [`docs/governance/workstreams.md`](docs/governance/workstreams.md).
 
@@ -69,8 +69,8 @@ To try it without installing anything, or to install it from this repository ins
 registry — always pinned to a release tag:
 
 ```bash
-uvx --from "git+https://github.com/NapkinStack/engineering-os@v0.19.0" nstack init my-project
-uv tool install "napkinstack @ git+https://github.com/NapkinStack/engineering-os@v0.19.0"
+uvx --from "git+https://github.com/NapkinStack/engineering-os@v0.19.2" nstack init my-project
+uv tool install "napkinstack @ git+https://github.com/NapkinStack/engineering-os@v0.19.2"
 ```
 
 **Two channels, one published artefact.** The registry publishes: the PyPI artefact of a

{napkinstack-0.19.0 → napkinstack-0.19.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "napkinstack"
-version = "0.19.0"
+version = "0.19.2"
 description = "Engineering framework for several teams and their agents working in one repository: modules, contracts, guardrails in CI."
 requires-python = ">=3.12"
 license = "MIT"

{napkinstack-0.19.0 → napkinstack-0.19.2}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "napkinstack"
-version = "0.19.0"
+version = "0.19.2"
 description = "Engineering framework for several teams and their agents working in one repository: modules, contracts, guardrails in CI."
 requires-python = ">=3.12"
 license = "MIT"

{napkinstack-0.19.0 → napkinstack-0.19.2}/src/napkinstack/doctor.py

@@ -405,9 +405,23 @@ def _kept_for_a_human(root: Path, shown: str, text: str) -> tuple[str, str]:
     if name in UNREAD_OWNERSHIP or name == "none":
         return OK, ("No forge reads it here: who approves what is for people to read, and nothing refuses "
                     "an agent's approval of the rest.")
+    agents = _agent_identities(root)
+    if len(agents) < 2:
+        return OK, (f"The history shows {len(agents) or 'no'} agent identit{'y' if len(agents) == 1 else 'ies'}"
+                    + (f" ({agents[0]})" if agents else "") + ": an agent never approves what its own identity "
+                    "pushed, so until another contributor's agent works under an identity of its own, every "
+                    "change waits for a human, as on approval human.")
     return OK, ""
 
 
+def _agent_identities(root: Path) -> list[str]:
+    """The bot identities the recent history's commits name, as GitHub's noreply addresses say them."""
+    shown = subprocess.run(["git", "log", "-n", "500", "--format=%ae%n%ce"], cwd=root, capture_output=True, text=True)
+    found = [address.lower() for address in shown.stdout.split()
+             if address.lower().endswith("[bot]@users.noreply.github.com")]
+    return list(dict.fromkeys(found))
+
+
 def _forge(path: str) -> dict | None:
     """JSON of a public repository's page on the forge, read without a token; None when it does
     not answer."""
@@ -440,7 +454,7 @@ def _left_behind(answers: dict) -> str | None:
 def _workstation(root: Path, answers: dict) -> list[tuple[str, str, str, str]]:
     commit = str(answers.get("_commit") or "")
     project = commit.removeprefix("v")
-    install = (f'uv tool install "napkinstack=={project}" --with-executables-from pre-commit'
+    install = (f'uv tool install "napkinstack=={project}" --refresh-package napkinstack --with-executables-from pre-commit'
                if PUBLISHED.fullmatch(commit) else "bash .nstack/install-engine.sh")
     results = []
 
@@ -563,7 +577,7 @@ def _newer(answers: dict) -> None:
     print(f"  NEWER VERSION  v{latest} is published; the project is on {commit} — information, not a gap\n"
           f"                 What it changes: {release_notes(str(answers.get('_src_path') or ''), commit, f'v{latest}')}\n"
           f"                 To take it, at a cycle's boundary: uv tool install \"napkinstack=={latest}\" "
-          "--with-executables-from pre-commit, then nstack update")
+          "--refresh-package napkinstack --with-executables-from pre-commit, then nstack update")
 
 
 def _private(client: GitHub) -> bool:

{napkinstack-0.19.0 → napkinstack-0.19.2}/src/napkinstack/project.py

@@ -85,7 +85,7 @@ def _explain(exc: Exception, command: str, where: Path, source: str, ref: str) -
         # version is not moved by `uv tool upgrade`, which is what a reader tries first.
         return (f"FAIL [{command}] Target version {match[2]} older than the project version ({match[1]}): "
                 f"no going back.\n{action}move this workstation forward first — "
-                'uv tool install "napkinstack@latest" --with-executables-from pre-commit — '
+                'uv tool install "napkinstack@latest" --refresh-package napkinstack --with-executables-from pre-commit — '
                 f"or pin the version you want, {match[1]} or newer.")
     if text.startswith("Updating is only supported in git-tracked subprojects"):
         return (f"FAIL [{command}] {where} is not a git repository: the merge relies on "

{napkinstack-0.19.0 → napkinstack-0.19.2}/src/napkinstack/provenance.py

@@ -135,4 +135,4 @@ def behind(root: Path) -> str | None:
         return None
     return (f"This workstation runs nstack {version}; the project is on {project}. A command it names "
             "may not exist here, and a verdict given here is not CI's.\n"
-            f'      Action: uv tool install "napkinstack=={wanted}" --with-executables-from pre-commit')
+            f'      Action: uv tool install "napkinstack=={wanted}" --refresh-package napkinstack --with-executables-from pre-commit')