Expand description
running-process maintenance release-handles --path <PATH>.
Phase 1 of #228 (issue #230). The goal is to make
rm -rf <PATH> reliable on Windows even when a daemon process is
holding handles inside <PATH> — see soldr#710.
§Per-platform behaviour
- POSIX: no-op. Linux/macOS use delete-on-close semantics, so
rm -rfalways succeeds; the subcommand exits 0 with an informational message. - Windows: scaffold-only in Phase 1. The full handler depends on the manifest registry that ships in Phase 2 (#231). Until then the subcommand returns a successful “no manifests to scan yet” result so downstream callers (clud-pr, soldr cleanup) can start wiring the call site without changing their exit-code handling later.
§Why ship the POSIX no-op now?
Cross-platform tooling (soldr’s clud-pr workflow, CI helpers) can
call the subcommand unconditionally and get the right behaviour on
every host. Without the no-op surface, every caller would need its
own cfg(unix) short-circuit.
Structs§
- Release
Handles Authorization - Inputs used to authorize a future daemon-side
release-handlesrequest. - Release
Handles Outcome - Result of one
release-handlesinvocation.
Enums§
- Release
Handles Authorization Error - Errors emitted by
authorize_release_handles_request. - Release
Handles Error - Errors emitted by
run_release_handles.
Functions§
- authorize_
release_ handles_ request - Authorize a daemon-side
release-handlesrequest. - run_
release_ handles - Run the
release-handlessubcommand. Cross-platform entrypoint called byrunpm maintenance release-handles.