mcpx exec: ERR_NO_TYPESCRIPT under Alpine's nodejs (musl) build

Finding (from #1987 tier-2 container work, task 3283, 2026-10-30)

mcpx exec under Alpine's nodejs build fails immediately:

$ docker run --rm mcpx-tier2-node exec 'console.log("hi")'
node:internal/util:237
    throw new ERR_NO_TYPESCRIPT();
    ^

Repro: static mcpx (CGO_ENABLED=0) copied into alpine:3.21 with apk add nodejs, MCPX_SCRIPT_RUNTIME=node. The same exec smoke passes in the same alpine image with bun's musl build, and in gcr.io/distroless/cc with deno — so the daemon, the static binary and the exec plumbing are fine; specifically mcpx's node invocation (TypeScript handling — node is asked to strip/run TS in a mode Alpine's node build does not provide) is what breaks.

Why it matters

Alpine + apk add nodejs is the lightest documented way to give a minimal image an exec surface (#1987 tier 2). Today that combination is broken at the first script, with a raw node stack instead of an mcpx-level diagnosis.

Acceptance

mcpx exec works under Alpine's nodejs (musl) build, OR mcpx detects the unsupported node mode up front and fails with its own actionable message (which runtime/mode is missing, what to use instead).
A tier-2 CI leg alpine-node-exec is added to pkgs/mcpx/scripts/tier2-containers.sh + the mcpx tier-2 containers workflow asserting it (the leg is deliberately absent today; see docs/container.md §4).

Intake review

Fleet monitor intake pass (2026-10-30 run). Labels normalised this pass: status/needs-triage, effort/s, meta/enriched (kind/bug, priority/normal, app/mcpx were already present). The body's existing ## Acceptance section is retained as the acceptance criteria (no duplicate section appended).

Still live: no merged PR since filing touches mcpx's node invocation / TypeScript handling; the failure is cleanly isolated by the filer's own controls (same image + bun musl build passes; distroless + deno passes), so this is a node-mode detection problem, not a daemon or exec-plumbing problem.

Notes / risks: the acceptance deliberately allows two outcomes — make it work, or detect-and-diagnose up front. The detect path is the safer first slice: an mcpx-level error naming the missing node mode beats a raw ERR_NO_TYPESCRIPT stack for every minimal-image user, and it unblocks the tier-2 leg either way.

Suggested approach: probe the node's type-stripping capability once at runtime selection (cache the verdict with the runtime record), fail with the actionable message when absent, and add the alpine-node-exec tier-2 leg asserting whichever behaviour lands.

agent-note:v1
state: triaged (coverage pass)
Coverage pass 2026-11-03: reviewed in the fleet-wide per-issue pass (drift / overlap / already-handled / stale / blockers / ordering). Verdict: still live; queued in repo-health-code-pilot as triage at priority 40 (priority/normal). If this is already handled at current main, the triage closes it with evidence; if it needs splitting, the triage files the split.
Found via: coverage pass 2026-11-03

🤖 Agent note · picked up

Agent: queue worker (repo-worker-code), lane c8b9355e-319a-4640-8096-7ad19480d151
Session / ID: task 8649
Found via: queue claim
Task: small_fix for issue mcpx exec: ERR_NO_TYPESCRIPT under Alpine's nodejs (musl) build #2699; resuming the canonical PR path only. Freshly verified issue mcpx exec: ERR_NO_TYPESCRIPT under Alpine's nodejs (musl) build #2699 OPEN; PR fix(mcpx): diagnose unsupported Node TypeScript mode #5205 OPEN, author and assignee dezren39 (Drew). No files touched.
Next: park task 8649 for 30 minutes naming PR fix(mcpx): diagnose unsupported Node TypeScript mode #5205; do not build a competing PR.
Links: mcpx exec: ERR_NO_TYPESCRIPT under Alpine's nodejs (musl) build #2699 · fix(mcpx): diagnose unsupported Node TypeScript mode #5205

🤖 Agent note · parked

Agent: queue worker (repo-worker-code), lane c8b9355e-319a-4640-8096-7ad19480d151
Session / ID: task 8649
State: after fresh verification, PR fix(mcpx): diagnose unsupported Node TypeScript mode #5205 is OPEN and Drew-owned (author/assignee dezren39). A follow-up checkpoint was rejected because task 8649 was no longer claimed by this worker; fresh queue listing reports it as parked. No files or competing PR were created. This lane did not issue a park command, so the existing queue park/resume condition was left unchanged.
Resume condition: proceed only when Drew releases ownership or PR fix(mcpx): diagnose unsupported Node TypeScript mode #5205 closes/merges; keep the canonical PR path.
Links: mcpx exec: ERR_NO_TYPESCRIPT under Alpine's nodejs (musl) build #2699 · fix(mcpx): diagnose unsupported Node TypeScript mode #5205

🤖 Agent note · handed off

Agent: queue worker (repo-worker-code), lane code-p
Session / ID: task 8649
Found via: queue claim
Task: Handing off small_fix of issue mcpx exec: ERR_NO_TYPESCRIPT under Alpine's nodejs (musl) build #2699 to the opencode claimant per §1b — execution lane assigned opencode.
Expectation: claimant launches the bound opencode session for task 8649; task 8649 is parked 1200s in the meantime.
Links: issue mcpx exec: ERR_NO_TYPESCRIPT under Alpine's nodejs (musl) build #2699

🤖 Agent note · handed off

Agent: repo-worker-code-o (lane code-o)
Task: task 8649 (small_fix, issue mcpx exec: ERR_NO_TYPESCRIPT under Alpine's nodejs (musl) build #2699 — mcpx exec under Alpine nodejs) — execution-lane assignment is opencode (§1b); handed off to the claimant.
Next: claimant session implements the node TypeScript-support probe / mcpx-level diagnosis and the alpine-node-exec tier-2 leg per the packet.

Agent note — handed off (task 8649)

Lane code-c claimed task 8649 (small_fix, issue mcpx exec: ERR_NO_TYPESCRIPT under Alpine's nodejs (musl) build #2699) at 2026-11-08T02:02Z; execution-lane assignment returned assigned_lane=opencode.
Checkpointed handed_off; claimant launches the bound opencode session. This lane does not work the task directly.
Resume context from the packet: PR fix(mcpx): diagnose unsupported Node TypeScript mode #5205 is the canonical PR and was recorded as Drew-authored — do not create a competing PR; resume only via PR fix(mcpx): diagnose unsupported Node TypeScript mode #5205 if it is still open.

Navigation Menu

Repository navigation

mcpx exec: ERR_NO_TYPESCRIPT under Alpine's nodejs (musl) build #2699

Finding (from #1987 tier-2 container work, task 3283, 2026-10-30)

Why it matters

Acceptance

Intake review

62 remaining items

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

mcpx exec: ERR_NO_TYPESCRIPT under Alpine's nodejs (musl) build #2699

Description

Finding (from #1987 tier-2 container work, task 3283, 2026-10-30)

Why it matters

Acceptance

Activity

dezren39 commented on Oct 30, 2026

Intake review

developing-today commented on Nov 3, 2026

62 remaining items

dezren39 commented on Nov 8, 2026

dezren39 commented on Nov 8, 2026

dezren39 commented on Nov 8, 2026

developing-today commented on Nov 8, 2026

dezren39 commented on Nov 8, 2026

Metadata

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Issue actions