napkinstack 0.7.2__tar.gz → 0.7.3__tar.gz

{napkinstack-0.7.2 → napkinstack-0.7.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: napkinstack
-Version: 0.7.2
+Version: 0.7.3
 Summary: Engineering framework for several teams and their agents working in one repository: modules, contracts, guardrails in CI.
 License-Expression: MIT
 License-File: LICENSE
@@ -20,7 +20,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.7.2, published** on [PyPI](https://pypi.org/project/napkinstack/).
+> **Status: v0.7.3, 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).
 
@@ -84,8 +84,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.7.2" nstack init my-project
-uv tool install "napkinstack @ git+https://github.com/NapkinStack/engineering-os@v0.7.2"
+uvx --from "git+https://github.com/NapkinStack/engineering-os@v0.7.3" nstack init my-project
+uv tool install "napkinstack @ git+https://github.com/NapkinStack/engineering-os@v0.7.3"
 ```
 
 **Two channels, one published artefact.** The registry publishes: the PyPI artefact of a

{napkinstack-0.7.2 → napkinstack-0.7.3}/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.7.2, published** on [PyPI](https://pypi.org/project/napkinstack/).
+> **Status: v0.7.3, 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.7.2" nstack init my-project
-uv tool install "napkinstack @ git+https://github.com/NapkinStack/engineering-os@v0.7.2"
+uvx --from "git+https://github.com/NapkinStack/engineering-os@v0.7.3" nstack init my-project
+uv tool install "napkinstack @ git+https://github.com/NapkinStack/engineering-os@v0.7.3"
 ```
 
 **Two channels, one published artefact.** The registry publishes: the PyPI artefact of a

{napkinstack-0.7.2 → napkinstack-0.7.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "napkinstack"
-version = "0.7.2"
+version = "0.7.3"
 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.7.2 → napkinstack-0.7.3}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "napkinstack"
-version = "0.7.2"
+version = "0.7.3"
 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.7.2 → napkinstack-0.7.3}/src/napkinstack/cli.py

@@ -4,6 +4,7 @@ from __future__ import annotations
 
 import argparse
 import json
+import sys
 from pathlib import Path
 
 from napkinstack import assurance
@@ -148,7 +149,21 @@ JUDGES = {"manifests", "boundaries", "plan", "skills", "hygiene", "fitness", "do
           "pr-check", "compat", "landed"}  # the commands whose verdict depends on the framework's rules
 
 
+def _named_root(argv: list[str]) -> Path:
+    """The root a command line names, read before the line is parsed: a command this engine
+    does not know is refused by the parser, and the reason may be the engine's age (D90)."""
+    for index, word in enumerate(argv):
+        if word == "--root" and index + 1 < len(argv):
+            return Path(argv[index + 1])
+        if word.startswith("--root="):
+            return Path(word.removeprefix("--root="))
+    return Path(".")
+
+
 def main(argv: list[str] | None = None) -> int:
+    argv = sys.argv[1:] if argv is None else argv
+    if late := provenance.behind(_named_root(argv)):
+        print(late, file=sys.stderr, flush=True)
     args = build_parser().parse_args(argv)
     if args.command in JUDGES:
         print(provenance.judged_by(args.root), flush=True)

{napkinstack-0.7.2 → napkinstack-0.7.3}/src/napkinstack/provenance.py

@@ -68,3 +68,26 @@ def judged_by(root: Path) -> str:
     return (f"Judged by an UNPUBLISHED NapkinStack — {source}"
             + (f", project pinned to {unpublished}" if unpublished else on)
             + ": these rules are no published version.")
+
+
+def behind(root: Path) -> str | None:
+    """What a workstation is told when its engine is older than the project it runs in (D90).
+
+    A teammate's update, once merged, leaves every other workstation there: a command the
+    project's manual names answers "invalid choice", and a verdict comes from rules the project
+    has left. Said before anything else, on every command — the one that does not exist included.
+    An engine ahead of the project is not said: it is the state an update starts from."""
+    project = recorded(root)
+    if not project or not PUBLISHED.fullmatch(project):
+        return None
+    version, _ = engine()
+    try:
+        here = tuple(int(part) for part in version.split(".")[:3])
+    except ValueError:
+        return None
+    wanted = project.removeprefix("v")
+    if here >= tuple(int(part) for part in wanted.split(".")):
+        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')