Skip to content

docs: update §2A codesign hook snippet to the fail-loud form#53

Merged
rianjs merged 1 commit into
mainfrom
docs/codesign-hook-fail-loud
Jun 4, 2026
Merged

docs: update §2A codesign hook snippet to the fail-loud form#53
rianjs merged 1 commit into
mainfrom
docs/codesign-hook-fail-loud

Conversation

@rianjs

@rianjs rianjs commented Jun 4, 2026

Copy link
Copy Markdown
Contributor

The canonical distribution.md §2A snippet still showed the original simple hook, but all six family CLIs (cfl/jtk/gro/nrq/cr/slck) ship the hardened fail-loud form. This aligns the doc with what's actually deployed:

  • CODESIGN_DARWIN_SCRIPT unset → skip (local build / opt-out).
  • set but missing or non-executable → error and fail the build, rather than silently shipping an unsigned binary in a release that intended to sign.

Snippet + surrounding prose updated; docs only.

The canonical §2A snippet showed the original simple hook, but all six
family CLIs ship the hardened fail-loud form. Match the doc to reality:
CODESIGN_DARWIN_SCRIPT unset → skip (local/opt-out); set but missing or
non-executable → error and fail the build instead of silently shipping
an unsigned binary. Also clarify the surrounding prose to spell out the
three cases.
@rianjs

rianjs commented Jun 4, 2026

Copy link
Copy Markdown
Contributor Author

Codex architect review (continuity session from the signing initiative)

The §2A snippet now matches the shipped convention, and the prose correctly distinguishes unset env from broken configured env. No contradiction with the self-gated signing/check-signature model.

STATUS: blockers=0 majors=0 minors=0 nits=0

@rianjs rianjs merged commit 9da78c1 into main Jun 4, 2026
4 checks passed
@rianjs rianjs deleted the docs/codesign-hook-fail-loud branch June 4, 2026 10:26
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