cli-nodetools

cli-nodetools is a Node.js CLI scaffold for project tooling workflows.

Package:

@fredlackey/cli-nodetools

Bin:

• nodetools

Goal

The initial scope is a single bump command for version bump workflows against packages that already exist in the configured npm registry.

Install

For local development from source:

npm install
node src/bin/nodetools.js --help

After global installation:

nodetools --help

Command Surface

Top-level commands:

nodetools bump [path] --major|--minor|--build [value] [--update [dir]] [--skip-install] [--publish]

bump options:

• [path] optional folder containing package.json; defaults to the current folder.
• --major [value] bumps the major version. Without a value, uses the next published major version and resets minor/build to 0.
• --minor [value] bumps the minor version for the package's current major version. Without a value, uses the next published minor version and resets build to 0.
• --build [value] bumps the build/patch version for the package's current major and minor version. Without a value, uses the next published build version.
• --update [dir] updates package references to the bumped package under dir; defaults to the current folder when no dir is provided.
• --skip-install skips the default npm install in packages changed by --update.
• --publish runs npm install and npm publish after updating package.json.

Example:

nodetools bump --minor
nodetools bump --build 42
nodetools bump ../my-package --build
nodetools bump ../my-package --build --update ../workspace
nodetools bump ../my-package --build --update ../workspace --skip-install
nodetools bump ../my-package --minor --publish

Implementation notes:

• bump requires exactly one of --major, --minor, or --build.
• The target folder must contain a readable and writable package.json.
• The package must already be published in the configured npm registry.
• The command checks published versions before writing a new version.
• --update scans recursively for package.json files, skips node_modules, updates dependencies/devDependencies/peerDependencies/optionalDependencies that reference the bumped package, and runs npm install in each changed package unless --skip-install is supplied.