nodeengine 0.1.0__tar.gz → 0.1.1__tar.gz

{nodeengine-0.1.0 → nodeengine-0.1.1}/.claude-plugin/marketplace.json

@@ -10,7 +10,7 @@
     {
       "name": "node-engine",
       "description": "Make staleness fail a check instead of relying on someone remembering. Sets up hash-and-compare guards for summaries, translations, generated files and any fact restated in prose. Carries the discipline too: fix the class not the instance, and a new check is guilty until it has failed on demand.",
-      "version": "0.1.0",
+      "version": "0.1.1",
       "author": {
         "name": "Alexyodude",
         "email": "jihoonhotmail.com@gmail.com"
@@ -27,5 +27,5 @@
       ]
     }
   ],
-  "version": "0.1.0"
+  "version": "0.1.1"
 }

{nodeengine-0.1.0 → nodeengine-0.1.1}/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "node-engine",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Make staleness fail a check instead of relying on someone remembering. Hash-and-compare guards for derived facts, generated artefacts and translations.",
   "author": {
     "name": "Alexyodude",

{nodeengine-0.1.0 → nodeengine-0.1.1}/.gitignore

@@ -4,3 +4,4 @@ __pycache__/
 .build/
 dist/
 .playwright-mcp/
+.env

{nodeengine-0.1.0 → nodeengine-0.1.1}/CLAUDE.md

@@ -99,8 +99,11 @@ guard was built to catch. That is institutional knowledge, not slop.
 
 ## Publishing
 
+Three distribution channels, each needing its own push:
+
 ```
-git push -u origin main
+git push -u origin main                      # the curl one-liner reads main directly
+rm -rf dist && uv build && uv publish        # PyPI: uvx nodeengine
 /plugin marketplace add Alexyodude/NodeEngine
 /plugin install node-engine@node-engine
 ```
@@ -109,6 +112,15 @@ Bump the version in **all four places** together — `plugin.json`, twice in
 `marketplace.json`, `pyproject.toml` — or the install will resolve to something
 that does not exist. `check_claude_md.py` catches a missed one.
 
+**`rm -rf dist` is not tidiness.** `uv build` adds to that directory rather than
+replacing it, so a stale wheel from an earlier version gets uploaded alongside
+the new one. Publishing is also one-way: PyPI refuses a re-upload of any version
+number it has ever seen, deleted or not.
+
+`uv publish` needs a PyPI token — account-scoped for a first upload of a new
+name, project-scoped after that. Keep it in `.env` (gitignored) and pass it as
+`--token`, never as a committed file.
+
 ## Known gaps
 
 - ~~The one-line installer 404s until the repo is public.~~ **Closed 2026-08-31**
@@ -124,11 +136,13 @@ Stated plainly because this plugin is about not letting claims drift:
 - ~~The version is restated in three places and nothing checks it.~~ **Closed**
   — `tools/check_claude_md.py` fails if the manifests disagree. Proven by
   setting `plugin.json` to `0.2.0` and watching it fire.
-- **`nodeengine` is not on PyPI**, so the bare `uvx nodeengine` / `pipx run
-  nodeengine` does not resolve. What works without a publish is
-  `uvx --from git+https://github.com/Alexyodude/NodeEngine nodeengine`. The
-  name was free on PyPI as of 2026-08-31 — publishing would claim it and make
-  the two-word form real.
+- ~~`nodeengine` is not on PyPI.~~ **Closed 2026-08-31** — published 0.1.0
+  (`uv publish`); `uvx --refresh nodeengine` in a fresh repo wrote all three
+  scaffold files. **A publish is irreversible**: PyPI never allows re-uploading
+  a version number, even after a delete, so the next release must bump the
+  version in all four places first. Rebuild `dist/` before every publish —
+  the first build here predated `viewer.html` and would have shipped a
+  two-file installer described by a three-file README.
 - **The scaffold has no tests.** Its correctness is asserted by the reference
   docs, not demonstrated. `checkall.py --prove` prints how to break the checks
   it describes, but nothing runs them here.

{nodeengine-0.1.0 → nodeengine-0.1.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: nodeengine
-Version: 0.1.0
+Version: 0.1.1
 Summary: Install the NodeEngine staleness-guard scaffold into the current repo
 Project-URL: Homepage, https://github.com/Alexyodude/NodeEngine
 License: MIT
@@ -44,28 +44,34 @@ staleness is not caught by cleverness — it is **structurally unable to hide**.
 One line, in any repo:
 
 ```
-curl -sL https://raw.githubusercontent.com/Alexyodude/NodeEngine/main/install.py | python -
+uvx nodeengine
 ```
 
 That copies `stale.py`, `checkall.py` and `viewer.html` into `./tools/` and
-prints what to do next. No clone, no plugin, no dependencies. Add
-`--into scripts` or `--dry-run` after `python -` if you want them.
+prints what to do next. Add `--into scripts` or `--dry-run` if you want them.
+`pipx run nodeengine` is the same thing. Nothing is installed into your
+project: the installer runs in a throwaway environment, and what lands in
+`tools/` is three readable files you are meant to edit.
 
-If you have [uv](https://docs.astral.sh/uv/), the same installer runs as a
-packaged tool — same files land, same refusal to overwrite:
+Without [uv](https://docs.astral.sh/uv/) or [pipx](https://pipx.pypa.io/), any
+Python will do:
 
 ```
-uvx --from git+https://github.com/Alexyodude/NodeEngine nodeengine
+curl -fsSL https://raw.githubusercontent.com/Alexyodude/NodeEngine/main/install.py | python
 ```
 
-*It runs code fetched over the network, which is worth being deliberate about.
+*Both run code fetched over the network, which is worth being deliberate about.
 To read it first:*
 
 ```
-curl -sL https://raw.githubusercontent.com/Alexyodude/NodeEngine/main/install.py -o install.py
+curl -fsSL https://raw.githubusercontent.com/Alexyodude/NodeEngine/main/install.py -o install.py
 less install.py && python install.py
 ```
 
+*(`-f` is not decoration: without it, curl pipes an HTTP error page into your
+interpreter and you get a syntax error pointing at `<!DOCTYPE html>` instead of
+a readable failure.)*
+
 **As a Claude Code plugin**, if you also want the skill and the guided setup:
 
 ```

{nodeengine-0.1.0 → nodeengine-0.1.1}/README.md

@@ -34,28 +34,34 @@ staleness is not caught by cleverness — it is **structurally unable to hide**.
 One line, in any repo:
 
 ```
-curl -sL https://raw.githubusercontent.com/Alexyodude/NodeEngine/main/install.py | python -
+uvx nodeengine
 ```
 
 That copies `stale.py`, `checkall.py` and `viewer.html` into `./tools/` and
-prints what to do next. No clone, no plugin, no dependencies. Add
-`--into scripts` or `--dry-run` after `python -` if you want them.
+prints what to do next. Add `--into scripts` or `--dry-run` if you want them.
+`pipx run nodeengine` is the same thing. Nothing is installed into your
+project: the installer runs in a throwaway environment, and what lands in
+`tools/` is three readable files you are meant to edit.
 
-If you have [uv](https://docs.astral.sh/uv/), the same installer runs as a
-packaged tool — same files land, same refusal to overwrite:
+Without [uv](https://docs.astral.sh/uv/) or [pipx](https://pipx.pypa.io/), any
+Python will do:
 
 ```
-uvx --from git+https://github.com/Alexyodude/NodeEngine nodeengine
+curl -fsSL https://raw.githubusercontent.com/Alexyodude/NodeEngine/main/install.py | python
 ```
 
-*It runs code fetched over the network, which is worth being deliberate about.
+*Both run code fetched over the network, which is worth being deliberate about.
 To read it first:*
 
 ```
-curl -sL https://raw.githubusercontent.com/Alexyodude/NodeEngine/main/install.py -o install.py
+curl -fsSL https://raw.githubusercontent.com/Alexyodude/NodeEngine/main/install.py -o install.py
 less install.py && python install.py
 ```
 
+*(`-f` is not decoration: without it, curl pipes an HTTP error page into your
+interpreter and you get a syntax error pointing at `<!DOCTYPE html>` instead of
+a readable failure.)*
+
 **As a Claude Code plugin**, if you also want the skill and the guided setup:
 
 ```

{nodeengine-0.1.0 → nodeengine-0.1.1}/install.py

@@ -2,7 +2,13 @@
 
 One line, from anywhere:
 
-    curl -sL https://raw.githubusercontent.com/Alexyodude/NodeEngine/main/install.py | python -
+    uvx nodeengine          # or: pipx run nodeengine
+
+Without uv or pipx, any Python will do. `-f` matters: without it curl pipes an
+HTTP error page into the interpreter, and a 404 surfaces as a syntax error
+pointing at `<!DOCTYPE html>`:
+
+    curl -fsSL https://raw.githubusercontent.com/Alexyodude/NodeEngine/main/install.py | python
 
 Or, if you have the repo or the plugin:
 

{nodeengine-0.1.0 → nodeengine-0.1.1}/pyproject.toml

@@ -15,7 +15,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "nodeengine"
-version = "0.1.0"
+version = "0.1.1"
 description = "Install the NodeEngine staleness-guard scaffold into the current repo"
 readme = "README.md"
 requires-python = ">=3.9"