v0.1.4

The quickstart imported requests and pip install nodemaven did not provide it. Reported by an outside developer reading 0.1.3 from PyPI on 2026-09-10 and reproduced the same day in a clean venv holding only nodemaven==0.1.3.

pip install nodemaven[requests]

An optional extra, not a dependency. requests is imported nowhere in src/ and stays that way: check.connect() writes its own CONNECT precisely so that no HTTP library is needed to read a status line, and an HTTP library discards the status line, the reason phrase and the headers that are the diagnosis on this gateway.

Worth knowing if you hit the same thing: an undeclared extra is not an error. pip answers yourpackage[nosuchthing] with a warning and installs without it, so a README can document an extra that does not exist and look fixed. A test now reads pyproject.toml and asserts every extra the documentation names is declared.

The README was split

984 lines, over half reference and measurement, so a reader arriving from PyPI met the API reference before the second example. Now a 499-line README plus:

• docs/api-reference.md - what every public name takes, returns and raises
• docs/validation.md - the five status codes a wrong value comes back as, the fold list, why a separator in a value is refused
• docs/observed-behavior.md - what the account API does that its own specification does not say

Nothing was deleted. The measurements moved at full length, because summarising a measurement turns it into an opinion.

Fixed: api.py's module docstring was wrong in 0.1.3

Its "What is still not measured" block claimed the write endpoints had never been called and the page-number base was unknown. Both were settled on 2026-09-09 and the findings sit in the method docstrings of the same file. Corrected in place with a note on how it happened: a module docstring reads as authoritative and was believed over the code it summarises.

No behaviour changed. Full detail in CHANGELOG.md.