Skip to content

fix(cli): document UEK8 PT_NOTE workaround in ENOEXEC hint - #3

Draft
macodev00 wants to merge 4 commits into
mainfrom
cursor/uek8-enoexec-hint-06c3
Draft

macodev00 wants to merge 4 commits into
mainfrom
cursor/uek8-enoexec-hint-06c3

Conversation

@macodev00

@macodev00 macodev00 commented Sep 20, 2026

Copy link
Copy Markdown
Owner

Summary

  • Surfaces a clearer install/update hint when the t3 CLI SEA fails to exec on Oracle UEK8 kernels (ENOEXEC from oversized PT_NOTE).
  • Documents the issue's verified workaround in the shared hint path: cap the installed binary's PT_NOTE p_filesz at 4 MB (reapply after every update), alongside RHCK and the from-source node apps/server/dist/bin.mjs path.
  • Linux installer smoke failures always print that guidance; some shells swallow ENOEXEC and leave no diagnostic text to match.

Linked issue

Fixes pingdotgg#12628

Test plan

  • Repro path: UEK8 / note blob > kernel limit → exec fails with ENOEXEC
  • Hint text appears in CLI update/install error path and names the PT_NOTE p_filesz cap
  • CI green

Notes

Tiny reliability/docs-adjacent fix only; no new user docs page (AGENTS.md: default no docs). The PT_NOTE workaround lives in the shared hint, a nearby code comment, the installer diagnostic, and the existing Oracle Linux install note.

Open in Web Open in Cursor 

macodev00 and others added 3 commits September 20, 2026 08:29
Oracle UEK8 rejects Node SEA PT_NOTE blobs larger than 4 MB, so npx t3
and the installer fail with a bare exec-format error. Print a targeted
hint (RHCK / from-source) from the npm launcher, legacy launcher, and
install.sh, and document it next to Intel Macs.
CodeRabbit docstring coverage is scoped to functions this diff touches.
The UEK8 hint constant sat between the file comment and
legacyCliLauncherScript, so that function no longer had an attached
docstring (0% of 1). Restore a one-line TSDoc on it.

Co-authored-by: maco <macodev00@users.noreply.github.com>
Issue 12628's verified workaround is capping the installed binary's
PT_NOTE p_filesz at 4 MB. Put that next to RHCK and the from-source
path in the shared hint, installer diagnostic, and install notes.
Always print the Linux installer hint: some shells swallow ENOEXEC
and leave no diagnostic text to match.
@cursor cursor Bot changed the title fix(cli): hint at UEK8 ENOEXEC when the SEA cannot exec fix(cli): document UEK8 PT_NOTE workaround in ENOEXEC hint Sep 21, 2026
@github-actions github-actions Bot added vouch:trusted PR author is trusted by repo permissions or the VOUCHED list. size:M labels Sep 22, 2026
On Linux, stderr writes to pipes are async, so process.exit can drop the
UEK8 hint. Exit from that write's callback on both launchers, and ignore
a later child event so it cannot exit first. Derive the installer
smoke-test archive name from the host platform.

Co-authored-by: maco <macodev00@users.noreply.github.com>
@cursor
cursor Bot force-pushed the cursor/uek8-enoexec-hint-06c3 branch from bb4c998 to 41c865e Compare September 22, 2026 06:33

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

size:M vouch:trusted PR author is trusted by repo permissions or the VOUCHED list.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Bug]: t3 CLI fails to exec on Oracle UEK8 kernels (ENOEXEC) — Node SEA PT_NOTE blob exceeds 4 MB kernel limit

1 participant