Files
pipelines/docs/notes/password-command.md
T

25 lines
1.5 KiB
Markdown

# Password command
Added checkout entry point `./password` with twice-entered hidden input and an
8-character minimum. It uses the existing installation's recorded password file,
explicit PIPELINES_WEB_AUTH_FILE, or default private file for partial installs.
Password arguments are not accepted, and non-TTY use is refused before prompting.
The helper validates file ownership, regular-file type, permissions and auth JSON;
stages on the destination filesystem, fsyncs content and atomically replaces the
file. Concurrent helper updates serialize on the parent directory lock, and an
external change detected during staging is not overwritten. Cookie secret and
unknown metadata remain unchanged, preserving existing sessions. No service,
background task, provider credential or ntfy account is modified.
Runtime use requires the updated proxy's per-request auth reload, implemented in
the browser-discovery/relay lane. Merely updating a checkout does not replace an
already-running installed proxy. The helper does not kill a proxy: the existing
supervisor would treat that as a fatal service exit.
Verification: 11 focused tests passed, covering custom/default/partial-install
paths, private ownership boundaries, old-file preservation on errors, same-device
atomic replacement, external-write refusal, prompt retry/privacy and non-TTY
refusal. Wrapper help, shell syntax, Python compilation and diff checks passed.
No operator password or running service was changed during testing.