helium-rapid-prune

CLI that iteratively removes unused Helium Rapid DSL functions, single-unit .mez files, and .lang entries, driven by the same unused diagnostics as the Helium language server.

Maintainer npm user: ajgreyling (unscoped package).

Install

npm install -g helium-rapid-prune

Usage

With npx (no global install):

npx helium-rapid-prune /path/to/dsl-root
npx helium-rapid-prune /path/to/dsl-root --max-passes=25

With a project root (non-interactive):

helium-rapid-prune /path/to/dsl-root
helium-rapid-prune /path/to/dsl-root --max-passes=25

Without arguments (prompts for project root and max passes):

helium-rapid-prune

Default max passes is 5 when --max-passes is not provided.

Environment:

• PROJECT_ROOT — used as the DSL root when no positional argument is given (still runs non-interactively for the other options unless you only set this and want prompts; if both env and no argv positionals, env wins before prompts).

Behaviour

• Uses the path you pass (or enter at the prompt) as the Helium Rapid DSL root exactly as provided.
• It does not append dsl, app, or any other segment automatically.

Path examples by repository layout

If the Helium DSL files are directly in your repository root:

npx helium-rapid-prune /path/to/repo

If the Helium DSL files are in an app/ subfolder:

npx helium-rapid-prune /path/to/repo/app

If the Helium DSL files are in a dsl/ subfolder:

npx helium-rapid-prune /path/to/repo/dsl

Publishing (maintainers)

From this directory:

chmod +x publish.sh
./publish.sh

This builds helium-dsl-language-server, bundles it via bundleDependencies, bumps the version with an epoch build number, publishes to npm, then restores package.json version.

npm publish also runs prepack, which re-bundles the language server before pack.

Related tooling

• Language server (bundled by this CLI)
• MCP server
• Extension
• Build pipeline
• Repository overview

License

MIT