feat: mb stack

[Dodecahedr0x]

Summary

Closes #1399. Creates the mb-stack command to start the base+ER+PER in a single command.

Breaking Changes

• None

Summary by CodeRabbit

• New Features

  • Added an mb-stack command to launch a local MagicBlock ephemeral rollup stack in one step.
  • Automatically starts components in order (validator → ephemeral validator → query service), waits for health/readiness, and prints HTTP/WS endpoints.
  • Supports extra CLI args passthrough, environment-variable port overrides, optional skipping of the local base, and coordinated shutdown on interrupt/failure.

• Documentation

  • Added a new package README covering npx usage, command/flags behavior, environment-variable configuration, and guidance for resetting the local ledger when needed.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro

Run ID: 2b3e2921-267d-4940-a161-b803b3d34c7f

📥 Commits

Reviewing files that changed from the base of the PR and between cb4ca89 and 46bce3a.

📒 Files selected for processing (1)

• .github/packages/npm-package/mbStack.ts

---

📝 Walkthrough

Walkthrough

This PR adds a new mb-stack CLI for the npm package that starts the local base validator, ephemeral-validator, and query-filtering-service from one command. The TypeScript entrypoint configures ports and remotes, supervises the three processes, checks health before advancing startup, forwards extra arguments, and handles shutdown on signals or child failure. The package manifest exposes the new binary, and the README documents usage and runtime options.

Assessment against linked issues

Objective	Addressed	Explanation
Launch all local nodes in a single command [#1399]	✅
Reduce manual multi-terminal startup and argument setup [#1399]	✅

Suggested reviewers: GabrielePicco

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch dode/full-setup-script

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[coderabbitai]

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In @.github/packages/npm-package/README.md:
- Around line 22-26: The README example fence is missing a language tag, which
triggers markdownlint MD040. Update the fenced block in the README example to
use a language identifier such as bash while keeping the existing diagram
content unchanged.

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

• Push a commit to this branch (recommended)
• Create a new PR with the fixes

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro

Run ID: 8d82116f-12cf-45b4-a9b4-1d50c2c7625e

📥 Commits

Reviewing files that changed from the base of the PR and between 63927e4 and 9969357.

📒 Files selected for processing (3)

• .github/packages/npm-package/README.md
• .github/packages/npm-package/mbStack.ts
• .github/packages/npm-package/package.json

[jonasXchen]

Yeahh finally we can make the set up so much easier! Thank you Julien!