fix: verify launchd server startup after install - #58
Closed
git-ksk wants to merge 1 commit into
Closed
Conversation
git-ksk
force-pushed
the
fix/launchd-startup-acceptance
branch
from
August 25, 2026 13:29
c5e7ea7 to
4443190
Compare
git-ksk
force-pushed
the
fix/launchd-startup-acceptance
branch
from
August 25, 2026 13:32
4443190 to
acb3566
Compare
Contributor
Author
|
Closing temporarily for a final pre-PR repository-guideline review. The branch is preserved; this will only be reopened after the final scope/style/test review is complete. |
Contributor
Author
|
Superseded by #63. The fork branch was amended after the contribution-guideline audit, and GitHub does not allow reopening this PR after that force-push. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
launchctl bootstrapsuccess as server startup success.server.error.log.Reproduction
A temporary LaunchAgent whose program exits immediately with status 78 reproduces the false positive:
launchctl bootstrapreturns 0, whilelaunchctl printshortly afterward reportsstate = not runningandlast exit code = 78: EX_CONFIG.A signal-terminated job is reported separately by launchd as
last terminating signal = Terminated: 15, so startup acceptance needs to handle both forms.Root cause
installpreviously checked only the return code fromlaunchctl bootstrap. Bootstrap confirms that launchd accepted the job definition; it does not guarantee that the server process remained alive or reached its listen endpoint.Validation
7 passed326 passedEX_CONFIG 78andSIGTERM 15com.macos-mcp.serverLaunchAgent was not modified during failure-path acceptancegit diff --check: cleanruff check .: 461 findings vs 462 onupstream/main(no new findings)ruff format --check .: same 26 pre-existing unformatted files asupstream/main; the new test file is formattedNon-changes