Skip to content

🤖 fix: publish npm package as @coder/shux - #3897

Merged
ammario merged 2 commits into
mainfrom
npm-package-0yr4
Aug 20, 2026
Merged

🤖 fix: publish npm package as @coder/shux#3897
ammario merged 2 commits into
mainfrom
npm-package-0yr4

Conversation

@ammar-agent

Copy link
Copy Markdown
Collaborator

Summary

Publish the canonical CLI package as @coder/shux while preserving the existing mux npm handle as a version-locked forwarding package. The @coder/shux package continues to install both shux and mux binaries, desktop artifacts remain named shux-*, and install/automation documentation now uses the scoped package spec.

Implementation

  • changes the root npm identity to @coder/shux with public scoped publishing
  • updates packages/mux-compat to depend on and execute the matching @coder/shux version
  • derives scoped tarball filenames from npm pack --json instead of assuming shux-*.tgz
  • adds an end-to-end smoke test that packs, installs, and executes the published mux forwarding package
  • keeps Electron executable, bundle, protocol, updater, and artifact compatibility names stable
  • updates release workflows, CI path filters, generated skill content, and user documentation
  • includes the Prettier normalization required for the existing README rename callout so make static-check remains green

Operator actions

Required once before automated npm publishing can succeed:

  1. An npm owner for the @coder scope must make an authenticated initial public publish of @coder/shux. Use a non-user-facing bootstrap version/dist-tag (for example, 0.0.0-bootstrap with the bootstrap tag) so neither latest nor next points at a placeholder.
  2. In the new @coder/shux package settings on npm, configure the GitHub Actions trusted publisher with:
    • Owner: coder
    • Repository: mux
    • Workflow: publish-npm.yml
    • Allowed action: npm publish
    • Environment: blank
  3. After trusted publishing is configured, rerun the desired Publish to NPM workflow (normally next for the first post-merge main build).

No operator action is required for the legacy mux handle: its existing publish path remains in place and will publish the forwarding package in lockstep. The unrelated unscoped shux package is not used by this change.

Validation

  • make static-check
  • make smoke-test
  • bun test src/common/compat/productIdentity.test.ts (8 tests)
  • canonical package tarball inspection (@coder/shux, both CLI binaries, public access)
  • legacy mux package pack/install/execute smoke test
  • independent read-only review of publishing, OIDC, artifact naming, and compatibility paths

Risks

The first automated publish is intentionally gated on the one-time npm bootstrap and trusted-publisher setup above. After that setup, package versions remain locked together, and CI exercises both the canonical tarball and the separately published mux forwarding package.


Generated with mux • Model: openai:gpt-5.6-sol • Thinking: xhigh • Cost: $11.36

Move the canonical npm package to the Coder scope while retaining the mux forwarding package and CLI alias.

---

_Generated with `mux` • Model: `openai:gpt-5.6-sol` • Thinking: `xhigh` • Cost: `$11.36`_

<!-- mux-attribution: model=openai:gpt-5.6-sol thinking=xhigh costs=11.36 -->
@mintlify

mintlify Bot commented Aug 20, 2026

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
Mux 🟢 Ready View Preview Aug 20, 2026, 4:43 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@ammar-agent

Copy link
Copy Markdown
Collaborator Author

@codex review

Please review the scoped npm publishing migration and legacy mux compatibility path.

@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: ea1ab098ea

ℹ️ 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 package.json
Update the no-install editor configuration and regenerated built-in documentation to invoke @coder/shux.

---

_Generated with `mux` • Model: `openai:gpt-5.6-sol` • Thinking: `xhigh` • Cost: `$14.36`_

<!-- mux-attribution: model=openai:gpt-5.6-sol thinking=xhigh costs=14.36 -->
@ammar-agent

Copy link
Copy Markdown
Collaborator Author

@codex review

Addressed the ACP no-install example by switching it to @coder/shux and regenerated the embedded built-in documentation. make static-check passes.

@chatgpt-codex-connector

Copy link
Copy Markdown

Codex Review: Didn't find any major issues. Nice work!

Reviewed commit: 53b3a2c6f9

ℹ️ 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".

@ammario
ammario merged commit 990f2ff into main Aug 20, 2026
20 of 21 checks passed
@ammario
ammario deleted the npm-package-0yr4 branch August 20, 2026 17:27
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.

2 participants