lerna/lerna

Tests and CI were inspected, not executed, and this brief provides bounded onboarding evidence rather than exhaustive coverage. Begin with contributor guidance, but resolve drift against manifests and executable source. Keep implementation, argument builders, public wrappers, and build entrypoints consistent. Release and e2e commands have material filesystem, process, Git, and registry side effects.

• Read AGENTS.md, CLAUDE.md, and CONTRIBUTING.md first, then verify against root package.json: this commit pins Node 26.10.0 and npm 12.1.0, despite older versions appearing in CLAUDE.md.
  AGENTS.md#L3-13CLAUDE.md#L68-79CLAUDE.md#L129-135package.json#L10-15
• Start a command change in its libs implementation and command.ts builder, inspect the published wrapper, and preserve exports/additional entrypoints when changing the public module surface.
  libs/commands/run/src/command.ts#L8-29packages/lerna/src/commands/run/index.ts#L1-1packages/lerna/package.json#L88-98packages/lerna/project.json#L79-103
• Read shared Command, Project, and graph enrichment before changing discovery: explicit lerna package globs select packages from the Nx graph and do not redefine the underlying workspace graph.
  libs/core/src/lib/command/index.ts#L115-143libs/core/src/lib/project/index.ts#L337-353libs/core/src/lib/command/create-project-graph-with-packages.ts#L24-39
• Preserve ESM/CommonJS compatibility contracts: main exports a module.exports alias, selected command factories attach their classes, and package tests explicitly check synchronous require and ESM import behavior.
  packages/lerna/src/index.ts#L95-96libs/commands/version/src/index.ts#L956-962packages/lerna/src/esm-compat.spec.ts#L32-103
• For an authorized change, begin with the affected Nx test project; contributor guidance requires format, lint, unit, and integration checks and gates e2e behind other tests and build. None of these checks was executed in this investigation.
  CLAUDE.md#L9-38package.json#L16-26libs/commands/run/vitest.config.ts#L1-8
• Use the correct e2e target names from CONTRIBUTING.md and project configuration; modern task-runner e2e first prepares the local package, then runs a bash capture harness, while shared e2e defaults include retries.
  CONTRIBUTING.md#L143-181e2e/run/task-runner/src/run-tests.sh#L16-27vitest.shared.ts#L42-57
• The build script must run at the workspace root and performs removal, Nx builds, npm install, and package copying; local registry configuration can affect later lockfile resolutions, so these are not source-inspection commands.
  tools/scripts/build.sh#L6-28CONTRIBUTING.md#L129-137AGENTS.md#L19-23
• Follow Oxlint module-boundary configuration and Oxfmt's 110-column style, use Conventional Commit scopes, and keep real releases in the gated GitHub workflow rather than invoking production publish locally.
  .oxlintrc.json#L28-40.oxfmtrc.json#L1-5CLAUDE.md#L117-127CONTRIBUTING.md#L193-206