Workspace Package Installer

A CLI helper that installs a curated list of packages either into a workspace or globally, providing a clear summary of what was installed.

Capabilities

Installs workspace dependencies

• Given package entries with target versions and an existing or empty workspace directory, installs them locally so they appear under dependencies in the manifest and on disk. @test

Installs dev-only dependencies

• Packages flagged as development-only are installed locally and recorded under devDependencies without affecting production entries. @test

Installs global tools

• With a global-install option enabled, installs provided packages globally, reports them as global in the summary, and leaves the workspace manifest unchanged. @test

Dry-run summary

• When run in dry-run mode, no installation occurs and the response lists the installation actions that would be performed. @test

Implementation

@generates

API

/**
 * Installs packages locally or globally based on provided options.
 * @param {Object} options
 * @param {string} options.cwd - Workspace directory to use for local installs.
 * @param {Array<{ name: string, version?: string, dev?: boolean }>} options.packages - Packages to install.
 * @param {boolean} [options.global=false] - Whether to install the packages globally.
 * @param {boolean} [options.dryRun=false] - Whether to skip installation and report intended actions.
 * @returns {Promise<{ installed: Array<{ name: string, target: 'local' | 'global', dev?: boolean, version?: string }>, actions: string[] }>}
 */
async function installPackages(options) {}

module.exports = { installPackages };

Dependencies { .dependencies }

npm CLI { .dependency }

Performs the local and global package installations required by the helper.