From 9539fea16e0d8d07faf7edf50d480e0a80c4ccfc Mon Sep 17 00:00:00 2001 From: nsfisis Date: Tue, 11 Aug 2026 12:19:31 +0900 Subject: feat(signal): abort on SIGINT, SIGTERM and SIGHUP at checkpoints The SignalHandler port was a no-op stub, so all four of Composer's abort paths were dead code: nothing removed a half-created project, reverted composer.json, or cleaned up half-installed packages. Composer runs those handlers from pcntl callbacks, which a Rust signal handler cannot do -- it may touch nothing beyond atomics. SignalSubscription records the signal instead, and the abort runs from checkpoints on the normal call stack, where the clean-up can borrow the state it needs. That also resolves the closure-capture TODO(phase-c)s in RequireCommand and InstallationManager, and replaces exit_with_last_signal's exit(0) with the restore-and-re-raise Seld\Signal does. A subscription is live only inside the four abort regions, so elsewhere the signals keep their default disposition and kill the process at once. It is installed without SA_RESTART so a signal interrupts an interactive prompt rather than resuming the read. A signal reaches only the innermost subscription, reproducing SignalHandler's single-stack dispatch. Drop SignalRegistry, SignalableCommandInterface and the Application wiring for them: nothing in Composer reaches that path, and SignalHandler discards whatever they register. Signal handling from plugins and scripts is undefined behavior; see docs/dev/signals.md. Co-Authored-By: Claude Opus 5 (1M context) --- docs/known-incompatibilities.md | 10 ++++++++++ 1 file changed, 10 insertions(+) (limited to 'docs/known-incompatibilities.md') diff --git a/docs/known-incompatibilities.md b/docs/known-incompatibilities.md index daaa8bcd..97e4dad7 100644 --- a/docs/known-incompatibilities.md +++ b/docs/known-incompatibilities.md @@ -39,6 +39,16 @@ behavior is slightly different. See [docs/dev/xdebug.md](./dev/xdebug.md) for details. +## Signals + +Composer runs its abort handler almost immediately after the signal arrives. +Shirabe, however, runs it at the next checkpoint instead, so stopping `shirabe` +command by `Ctrl+C` may take more time than Composer. + +Signal handling in plugins and scripts is undefined behavior: it may or may not +work. See [docs/dev/signals.md](./dev/signals.md) for details. + + ## Plugins ### Reflection -- cgit v1.3.1-4-g156e