napkinstack 0.34.2__tar.gz → 0.34.4__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- {napkinstack-0.34.2 → napkinstack-0.34.4}/PKG-INFO +5 -5
- {napkinstack-0.34.2 → napkinstack-0.34.4}/README.md +4 -4
- {napkinstack-0.34.2 → napkinstack-0.34.4}/pyproject.toml +1 -1
- {napkinstack-0.34.2 → napkinstack-0.34.4}/pyproject.toml.orig +1 -1
- {napkinstack-0.34.2 → napkinstack-0.34.4}/src/napkinstack/hold.py +1 -1
- {napkinstack-0.34.2 → napkinstack-0.34.4}/src/napkinstack/pull_request.py +9 -3
- {napkinstack-0.34.2 → napkinstack-0.34.4}/LICENSE +0 -0
- {napkinstack-0.34.2 → napkinstack-0.34.4}/src/napkinstack/__init__.py +0 -0
- {napkinstack-0.34.2 → napkinstack-0.34.4}/src/napkinstack/__main__.py +0 -0
- {napkinstack-0.34.2 → napkinstack-0.34.4}/src/napkinstack/agent.py +0 -0
- {napkinstack-0.34.2 → napkinstack-0.34.4}/src/napkinstack/assurance.py +0 -0
- {napkinstack-0.34.2 → napkinstack-0.34.4}/src/napkinstack/attest.py +0 -0
- {napkinstack-0.34.2 → napkinstack-0.34.4}/src/napkinstack/board.py +0 -0
- {napkinstack-0.34.2 → napkinstack-0.34.4}/src/napkinstack/cli.py +0 -0
- {napkinstack-0.34.2 → napkinstack-0.34.4}/src/napkinstack/compat.py +0 -0
- {napkinstack-0.34.2 → napkinstack-0.34.4}/src/napkinstack/discovery.py +0 -0
- {napkinstack-0.34.2 → napkinstack-0.34.4}/src/napkinstack/doctor.py +0 -0
- {napkinstack-0.34.2 → napkinstack-0.34.4}/src/napkinstack/evidence.py +0 -0
- {napkinstack-0.34.2 → napkinstack-0.34.4}/src/napkinstack/fitness/__init__.py +0 -0
- {napkinstack-0.34.2 → napkinstack-0.34.4}/src/napkinstack/fitness/boundaries.py +0 -0
- {napkinstack-0.34.2 → napkinstack-0.34.4}/src/napkinstack/fitness/hygiene.py +0 -0
- {napkinstack-0.34.2 → napkinstack-0.34.4}/src/napkinstack/fitness/manifests.py +0 -0
- {napkinstack-0.34.2 → napkinstack-0.34.4}/src/napkinstack/fitness/plan.py +0 -0
- {napkinstack-0.34.2 → napkinstack-0.34.4}/src/napkinstack/fitness/pr_scope.py +0 -0
- {napkinstack-0.34.2 → napkinstack-0.34.4}/src/napkinstack/landed.py +0 -0
- {napkinstack-0.34.2 → napkinstack-0.34.4}/src/napkinstack/modules.py +0 -0
- {napkinstack-0.34.2 → napkinstack-0.34.4}/src/napkinstack/owners.py +0 -0
- {napkinstack-0.34.2 → napkinstack-0.34.4}/src/napkinstack/project.py +0 -0
- {napkinstack-0.34.2 → napkinstack-0.34.4}/src/napkinstack/provenance.py +0 -0
- {napkinstack-0.34.2 → napkinstack-0.34.4}/src/napkinstack/settings.py +0 -0
- {napkinstack-0.34.2 → napkinstack-0.34.4}/src/napkinstack/skills.py +0 -0
- {napkinstack-0.34.2 → napkinstack-0.34.4}/src/napkinstack/templates/contracts/AGENTS.md +0 -0
- {napkinstack-0.34.2 → napkinstack-0.34.4}/src/napkinstack/templates/contracts/MANIFEST.yaml +0 -0
- {napkinstack-0.34.2 → napkinstack-0.34.4}/src/napkinstack/templates/contracts/README.md +0 -0
- {napkinstack-0.34.2 → napkinstack-0.34.4}/src/napkinstack/templates/contracts/docs/runbook.md +0 -0
- {napkinstack-0.34.2 → napkinstack-0.34.4}/src/napkinstack/templates/contracts/tests/.gitkeep +0 -0
- {napkinstack-0.34.2 → napkinstack-0.34.4}/src/napkinstack/templates/module/AGENTS.md +0 -0
- {napkinstack-0.34.2 → napkinstack-0.34.4}/src/napkinstack/templates/module/MANIFEST.yaml +0 -0
- {napkinstack-0.34.2 → napkinstack-0.34.4}/src/napkinstack/templates/module/README.md +0 -0
- {napkinstack-0.34.2 → napkinstack-0.34.4}/src/napkinstack/templates/module/src/.gitkeep +0 -0
- {napkinstack-0.34.2 → napkinstack-0.34.4}/src/napkinstack/templates/module/tests/.gitkeep +0 -0
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: napkinstack
|
|
3
|
-
Version: 0.34.
|
|
3
|
+
Version: 0.34.4
|
|
4
4
|
Summary: Engineering framework for several teams and their agents working in one repository: modules, contracts, guardrails in CI.
|
|
5
5
|
License-Expression: MIT
|
|
6
6
|
License-File: LICENSE
|
|
@@ -22,7 +22,7 @@ modules, contracts, guardrails in CI. On the Django or Rails model, one command
|
|
|
22
22
|
the project, which then receives new versions on demand; no application stack is imposed.
|
|
23
23
|
Positioning and vocabulary: [`PRODUCT.md`](PRODUCT.md) §1.
|
|
24
24
|
|
|
25
|
-
> **Status: v0.34.
|
|
25
|
+
> **Status: v0.34.4, published** on [PyPI](https://pypi.org/project/napkinstack/).
|
|
26
26
|
> What each version changes, engine and project apart: [`CHANGELOG.md`](CHANGELOG.md).
|
|
27
27
|
> What is open: [`docs/governance/workstreams.md`](docs/governance/workstreams.md).
|
|
28
28
|
|
|
@@ -86,8 +86,8 @@ To try it without installing anything, or to install it from this repository ins
|
|
|
86
86
|
registry — always pinned to a release tag:
|
|
87
87
|
|
|
88
88
|
```bash
|
|
89
|
-
uvx --from "git+https://github.com/NapkinStack/engineering-os@v0.34.
|
|
90
|
-
uv tool install "napkinstack @ git+https://github.com/NapkinStack/engineering-os@v0.34.
|
|
89
|
+
uvx --from "git+https://github.com/NapkinStack/engineering-os@v0.34.4" nstack init my-project
|
|
90
|
+
uv tool install "napkinstack @ git+https://github.com/NapkinStack/engineering-os@v0.34.4"
|
|
91
91
|
```
|
|
92
92
|
|
|
93
93
|
**Two channels, one published artefact.** The registry publishes: the PyPI artefact of a
|
|
@@ -109,7 +109,7 @@ Each project then pins its version and changes it through `nstack update`.
|
|
|
109
109
|
| `nstack init <folder>` | Creates the project: skeleton, git repository, initial commit, the next steps for its forge (`--forge`, GitHub by default); each answer given as an option or asked (`--project-name`, `--github-repo` or `--repository`, `--owner-team` — on GitHub, never an organisation's name alone) |
|
|
110
110
|
| `nstack doctor` | Checks the workstation and, on GitHub, its settings, read-only; off GitHub says what it cannot verify; names a newer published version |
|
|
111
111
|
| `nstack settings [--apply]` | Prints the calls that would bring the GitHub settings to the checklist; with `--apply`, makes them under the person's own credential — `GH_TOKEN`, or else their `gh` login — once they confirm the plan at the keyboard, then reads the result back — never an agent's, never in CI |
|
|
112
|
-
| `nstack new-module <name> <owner> <criticality
|
|
112
|
+
| `nstack new-module <name> <owner> <criticality> [--user-facing]` | Creates a module, with no imposed stack |
|
|
113
113
|
| `nstack new-contract <name> [--owner <owner>]` | Creates a contract and, the first time, the module that holds them all |
|
|
114
114
|
| `nstack check`, `test`, `bootstrap`, `clean` `[module]`; `nstack run <module>` | Run the commands declared in the module's manifest |
|
|
115
115
|
| `nstack discover <idea-file>` | Starts a discovery for your agent: the idea kept, its document created |
|
|
@@ -5,7 +5,7 @@ modules, contracts, guardrails in CI. On the Django or Rails model, one command
|
|
|
5
5
|
the project, which then receives new versions on demand; no application stack is imposed.
|
|
6
6
|
Positioning and vocabulary: [`PRODUCT.md`](PRODUCT.md) §1.
|
|
7
7
|
|
|
8
|
-
> **Status: v0.34.
|
|
8
|
+
> **Status: v0.34.4, published** on [PyPI](https://pypi.org/project/napkinstack/).
|
|
9
9
|
> What each version changes, engine and project apart: [`CHANGELOG.md`](CHANGELOG.md).
|
|
10
10
|
> What is open: [`docs/governance/workstreams.md`](docs/governance/workstreams.md).
|
|
11
11
|
|
|
@@ -69,8 +69,8 @@ To try it without installing anything, or to install it from this repository ins
|
|
|
69
69
|
registry — always pinned to a release tag:
|
|
70
70
|
|
|
71
71
|
```bash
|
|
72
|
-
uvx --from "git+https://github.com/NapkinStack/engineering-os@v0.34.
|
|
73
|
-
uv tool install "napkinstack @ git+https://github.com/NapkinStack/engineering-os@v0.34.
|
|
72
|
+
uvx --from "git+https://github.com/NapkinStack/engineering-os@v0.34.4" nstack init my-project
|
|
73
|
+
uv tool install "napkinstack @ git+https://github.com/NapkinStack/engineering-os@v0.34.4"
|
|
74
74
|
```
|
|
75
75
|
|
|
76
76
|
**Two channels, one published artefact.** The registry publishes: the PyPI artefact of a
|
|
@@ -92,7 +92,7 @@ Each project then pins its version and changes it through `nstack update`.
|
|
|
92
92
|
| `nstack init <folder>` | Creates the project: skeleton, git repository, initial commit, the next steps for its forge (`--forge`, GitHub by default); each answer given as an option or asked (`--project-name`, `--github-repo` or `--repository`, `--owner-team` — on GitHub, never an organisation's name alone) |
|
|
93
93
|
| `nstack doctor` | Checks the workstation and, on GitHub, its settings, read-only; off GitHub says what it cannot verify; names a newer published version |
|
|
94
94
|
| `nstack settings [--apply]` | Prints the calls that would bring the GitHub settings to the checklist; with `--apply`, makes them under the person's own credential — `GH_TOKEN`, or else their `gh` login — once they confirm the plan at the keyboard, then reads the result back — never an agent's, never in CI |
|
|
95
|
-
| `nstack new-module <name> <owner> <criticality
|
|
95
|
+
| `nstack new-module <name> <owner> <criticality> [--user-facing]` | Creates a module, with no imposed stack |
|
|
96
96
|
| `nstack new-contract <name> [--owner <owner>]` | Creates a contract and, the first time, the module that holds them all |
|
|
97
97
|
| `nstack check`, `test`, `bootstrap`, `clean` `[module]`; `nstack run <module>` | Run the commands declared in the module's manifest |
|
|
98
98
|
| `nstack discover <idea-file>` | Starts a discovery for your agent: the idea kept, its document created |
|
|
@@ -478,7 +478,7 @@ def _show(root: Path, name: str | None, ident: str, title: str, person: str, bra
|
|
|
478
478
|
judgement: the hold is git's, and stands whatever the forge answers."""
|
|
479
479
|
forge = _forge(root, name)
|
|
480
480
|
if forge is None:
|
|
481
|
-
return unshown(root)
|
|
481
|
+
return f"{unshown(root)}; nstack plan shows who holds what" # on any forge: the hold is git's (D263)
|
|
482
482
|
said: list[str] = []
|
|
483
483
|
try:
|
|
484
484
|
if branch is None:
|
|
@@ -715,6 +715,10 @@ def recorded_rows(root: Path, fork: str, head: str) -> list[tuple[str, str, dict
|
|
|
715
715
|
return found
|
|
716
716
|
|
|
717
717
|
|
|
718
|
+
# A removal said (#485): `Removed: S3, S4 — <why>`, on a line of its own; with no reason it says nothing.
|
|
719
|
+
REMOVED = re.compile(r"^\s*Removed:\s*([^\s—–-][^—–]*?)\s+[—–-]\s+\S", re.MULTILINE)
|
|
720
|
+
|
|
721
|
+
|
|
718
722
|
def check_moved(body: str, recorded: list[tuple[str, str, dict]], fail: Fail, warn: Callable[[str], None],
|
|
719
723
|
same_files: Callable[[str, str], bool] = lambda one, other: False,
|
|
720
724
|
before_it: Callable[[str, str], bool] = lambda older, newer: False) -> None:
|
|
@@ -744,11 +748,13 @@ def check_moved(body: str, recorded: list[tuple[str, str, dict]], fail: Fail, wa
|
|
|
744
748
|
"evidence unchanged: nothing shows it was explored again.\n"
|
|
745
749
|
f" Action: the verifier explores it at the head and links that run's own evidence — or puts "
|
|
746
750
|
f"{before['commit'][:7]} back and confirms the head in the Confirmed column.")
|
|
747
|
-
|
|
751
|
+
said = {ident.strip() for found in REMOVED.finditer(body) for ident in found.group(1).split(",")}
|
|
752
|
+
gone = sorted({was["#"] for _, _, was in recorded
|
|
753
|
+
if was["#"] not in now and was["#"] not in said and was.get("result") in {"passed", "failed"}})
|
|
748
754
|
if gone:
|
|
749
755
|
warn(f"[T5] scenario(s) {', '.join(gone)} were in the sheet a record of this pull request read, and are "
|
|
750
|
-
"gone from it.\n Action:
|
|
751
|
-
"
|
|
756
|
+
"gone from it.\n Action: say why under the sheet — a line `Removed: <ids> — <why>` — for the "
|
|
757
|
+
"approver to judge; restore it from the description's history otherwise.")
|
|
752
758
|
|
|
753
759
|
|
|
754
760
|
def _pull_labels(root: Path, head: str) -> tuple[int, set[str]] | str | None:
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
{napkinstack-0.34.2 → napkinstack-0.34.4}/src/napkinstack/templates/contracts/docs/runbook.md
RENAMED
|
File without changes
|
{napkinstack-0.34.2 → napkinstack-0.34.4}/src/napkinstack/templates/contracts/tests/.gitkeep
RENAMED
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|