Skip to content

fix: tighten operator-facing diagnostics - #22

Merged
ausimian merged 2 commits into
release/1.0.0from
issue/20-diagnostics
Aug 24, 2026
Merged

fix: tighten operator-facing diagnostics#22
ausimian merged 2 commits into
release/1.0.0from
issue/20-diagnostics

Conversation

@ausimian

Copy link
Copy Markdown
Owner

Summary

  • correct and simplify CLI, relup, startup, and release-state diagnostics
  • preserve actionable versions, paths, commands, and recovery guidance
  • validate restart markers safely, quarantine malformed OTP marker evidence, and preserve valid space-bearing release versions
  • align README and RELEASE notes with the shipped behavior

Validation

  • mix precommit
  • 320 tests, 0 failures

Review

Claude Code adversarial review ran for the configured five-round maximum. All findings were addressed. The final round found four additional issues; those fixes landed after the review cap, so no sixth review was run. The exact squashed history passed mix precommit afterward.

Closes #20

Correct the RELEASES help and simplify relup and startup messages.
Keep versions, paths, commands, and recovery steps while removing OTP
protocol detail.

Closes #20
Co-Authored-By: Codex GPT-5 <noreply@openai.com>
@ausimian

Copy link
Copy Markdown
Owner Author

@codex review

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: c7a37d3020

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread priv/env.sh.eex Outdated
Both display guards matched `[[:space:]]` beside `[[:cntrl:]]`, so a
version carrying the space the parser deliberately preserves - OTP
builds its marker as `EVsn ++ " " ++ Vsn`, and the split keeps the
remainder exactly, because Mix permits spaces in versions - was
reported as `<non-empty line containing whitespace or control bytes>`.

That is the case where naming the release matters most. The pair can
fail to settle for a reason with nothing to do with the version at all
(mismatched markers, a version directory with no `env.sh`), and the
label was then the only thing telling the operator which releases to
go and inspect. It withheld exactly that.

Match `[[:cntrl:]]` alone. Every whitespace byte that is genuinely
unsafe to print - tab, newline, carriage return, vertical tab, form
feed - is also a control byte, so nothing that had to be withheld
stops being withheld.

The new test covers both display branches, since both carried the same
guard, and asserts the versions appear verbatim rather than that some
label is absent.

Claude-Session: https://claude.ai/code/session_01RotroiBdbidiCRX3KqE3Dy

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@ausimian

Copy link
Copy Markdown
Owner Author

@codex review

@chatgpt-codex-connector

Copy link
Copy Markdown

Codex Review: Didn't find any major issues. Bravo.

Reviewed commit: 053c93aac7

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

@ausimian
ausimian merged commit 3430351 into release/1.0.0 Aug 24, 2026
13 checks passed
@ausimian
ausimian deleted the issue/20-diagnostics branch August 24, 2026 11:56
@ausimian
ausimian restored the issue/20-diagnostics branch August 24, 2026 11:57
@ausimian
ausimian deleted the issue/20-diagnostics branch August 24, 2026 11:58
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant