Commit graph

2 commits

Author SHA1 Message Date
9fa826c5ff docs(port): name the download sites without linking them
The public-surface gate refuses any tracked file carrying a URL with a
path outside .example, and 21d7f5a shipped two: the python.org Windows
downloads page and the Git for Windows download. Both are now named as
bare domains for the tester to search for, which the scanner allows and
which does not rot when a vendor moves a page.

The gate found this and I did not, for a reason worth recording: 21d7f5a
was verified while the file was still UNTRACKED, and that scan reads
`git ls-files`. The suite was genuinely green -- of a tree that did not
yet contain the file. Verify after `git add`, not before, whenever a gate
is scoped to tracked files.

Also states the rule in the operator section, so the links are not
restored as a courtesy later.

Verify: .venv/bin/python -m pytest tests/ -> 223 passed, exit 0, with the
file tracked. Scanner denominator 113 files / 609427 bytes, 0 findings;
the byte count moved with the edit, so the file is inside the scan.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-06 07:21:07 +02:00
21d7f5a675 docs(port): turn the Windows probe list into a tester checklist
The two adopters are the Windows measurement, and the probe list in
docs/cross-platform-port.md was written for someone fluent in a terminal.
This is the same seven questions in a form a private person can follow
top to bottom: one step per line, the exact command, the expected output
written out, and a four-part report form so a divergence arrives as the
command, the whole message and the Windows version rather than "it did
not work".

Every expected output here was measured rather than recalled: the
ls-remote hash, the guard's reported version, the bootstrap and launcher
refusal texts. The Windows-side claims that could not be measured from
this Mac -- setx persistence, the Microsoft Store execution alias, py.exe
absence on a Store install -- are cited from Microsoft's own docs, and
where the exact string was only attested secondhand the checklist asks
the tester to report what they actually saw.

Carries one blocker in an operator-only section: bootstrap.py installs
with --group <repo root>/pyproject.toml:dev, and pyproject.toml is not in
package_plugin.py's INCLUDE tuple, so the bootstrap cannot succeed in an
installed copy on any platform. The O4 gate then refuses to serve, which
would answer measurement 2 -- the critical one -- "no" for a reason that
has nothing to do with Windows. The fix is outside this order's fence;
the checklist names the pre-fix error text so a tester stops instead of
reporting a spoiled result.

Verify: .venv/bin/python -m pytest tests/ -> 223 passed, exit 0.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-06 07:17:31 +02:00