semantic-monorepo-tools

A library of helper functions to do SemVer2 compliant releases from Conventional Commits in monorepos.

Install

npm install @coveo/semantic-monorepo-tools

Why?

Before, one would use lerna version to make semantic releases in a monorepo, but lerna is dead.

The most predominant tools in the field, standard-version and semantic-release do not offer the level of flexibility that lerna did offer (e.g. it's hard to do semantic releases when packages do not share the same version and Changelog generation are sometimes tangled).

Because there are so many ways to do semantic releases in a monorepo, and that an opinionated way could result in releases that make less sense for the user of the published packages, semantic-monorepo-tools took the approach to leave the implementation process in the hand of the user, and instead focus on providing functions to 'get what you need' and 'do what you need to do' directly with JavaScript.

What?

semantic-monorepo-tools aims to take the functions of a single-package release flow such as standard-version and make them available as standalone building blocks. The goal is to make abstractions of the inner working of the tools (e.g. git, npm) behind simple pure (ish) functions.

Examples

semantic-monorepo-tools use itself for its release process, you can see the 'meat of it' here. It is also used for the release processes of several monorepos at Coveo, you can find implementations examples on some of our repository:

• coveo/cli
• coveo/plasma

2.6.8 (2025-06-23)

2.6.7 (2025-06-02)

2.6.6 (2025-05-27)

Bug Fixes

• deps: update all dependencies (#295) (39742ca)

2.6.5 (2025-05-20)

Bug Fixes

• deps: update all dependencies (#287) (a8cde52)
• deps: update all dependencies (#294) (aafc7cd)

2.6.4 (2025-01-06)

2.6.3 (2025-01-02)

2.6.2 (2024-12-16)

Bug Fixes

• deps: update all dependencies (#280) (0e003f6)

2.6.1 (2024-12-09)

2.6.0 (2024-12-03)

Features

• git: allow additional args on gitDiff and getSHA1FromRef (#277) (504db98)

2.5.9 (2024-12-02)

2.5.8 (2024-12-02)

2.5.7 (2024-11-25)

2.5.6 (2024-11-18)

2.5.5 (2024-11-18)

2.5.4 (2024-11-11)

2.5.3 (2024-11-04)

2.5.2 (2024-11-04)

2.5.1 (2024-11-01)

2.5.0 (2024-10-23)

Features

• npm: add fn to Update a package's tag in the npm registry to a specific version (#267) (6fbb84b)

2.4.61 (2024-10-21)

2.4.60 (2024-10-21)

2.4.59 (2024-10-18)

2.4.58 (2024-10-17)

2.4.57 (2024-10-17)

2.4.56 (2024-10-07)

2.4.55 (2024-09-25)

2.4.54 (2024-09-23)

2.4.53 (2024-09-18)

2.4.52 (2024-09-18)

2.4.51 (2024-09-09)

2.4.50 (2024-09-03)

2.4.49 (2024-08-27)

2.4.48 (2024-08-22)

2.4.47 (2024-08-20)

2.4.46 (2024-08-20)

2.4.45 (2024-08-05)

2.4.44 (2024-07-29)

2.4.43 (2024-07-22)

2.4.42 (2024-07-16)

2.4.41 (2024-07-15)

2.4.40 (2024-07-10)

2.4.39 (2024-07-08)

2.4.38 (2024-06-25)

2.4.37 (2024-06-17)

2.4.36 (2024-06-10)

2.4.35 (2024-06-06)

2.4.34 (2024-06-06)

Bug Fixes

• remove double quotes (#240) (863ee45)

2.4.33 (2024-05-31)

2.4.32 (2024-05-29)

2.4.31 (2024-05-06)

2.4.30 (2024-04-30)

2.4.29 (2024-04-29)

2.4.28 (2024-04-26)

2.4.27 (2024-04-25)

2.4.26 (2024-04-22)

2.4.25 (2024-04-15)

2.4.24 (2024-04-02)

2.4.23 (2024-03-28)

2.4.22 (2024-03-25)

2.4.21 (2024-03-18)

2.4.20 (2024-03-06)

2.4.19 (2024-03-05)

2.4.18 (2024-02-19)

2.4.17 (2024-02-12)

2.4.16 (2024-02-12)

2.4.15 (2024-02-05)

2.4.14 (2024-01-30)

2.4.13 (2024-01-29)

2.4.12 (2024-01-29)

2.4.11 (2024-01-08)

2.4.10 (2024-01-03)

2.4.9 (2023-12-29)

2.4.8 (2023-12-29)

2.4.7 (2023-12-29)

2.4.6 (2023-12-22)

2.4.5 (2023-12-12)

2.4.4 (2023-12-11)

2.4.3 (2023-12-05)

2.4.2 (2023-12-04)

2.4.1 (2023-11-29)

2.4.0 (2023-11-29)

Features

• add git diff command (#201) (551b98e)

2.3.4 (2023-11-24)

2.3.3 (2023-11-17)

Bug Fixes

• export gitReset (478792f)

2.3.2 (2023-11-14)

2.3.1 (2023-11-06)

2.3.0 (2023-11-06)

Features

• git reset (#198) (b5a8a6a)

2.2.3 (2023-10-30)

2.2.2 (2023-10-24)

2.2.1 (2023-10-16)

2.2.0 (2023-10-13)

Bug Fixes

• deps: update all dependencies (0cbe88c)

Features

• add support the registry option when publishing NPM packages (#189) (ebc6a55)

2.1.20 (2023-09-07)

2.1.19 (2023-09-06)

2.1.18 (2023-09-05)

2.1.17 (2023-08-28)

2.1.16 (2023-08-28)

2.1.15 (2023-08-24)

2.1.14 (2023-08-21)

2.1.13 (2023-08-14)

2.1.12 (2023-08-14)

2.1.11 (2023-08-07)

2.1.10 (2023-08-01)

2.1.9 (2023-07-24)

2.1.8 (2023-07-17)

Bug Fixes

• deps: update dependency semver to v7.5.2 [security] (d7e6630)

2.1.7 (2023-06-19)

2.1.6 (2023-06-12)

2.1.5 (2023-06-05)

2.1.4 (2023-05-31)

2.1.3 (2023-05-31)

2.1.2 (2023-05-01)

2.1.1 (2023-04-24)

2.1.0 (2023-04-21)

Features

• npm: add support for provenance (#156) (3620283)

2.0.1 (2023-04-13)

2.0.0 (2023-04-11)

• feat(git)!: add support for push-force (#149) (1322ca8), closes #149

BREAKING CHANGES

• Add front parameter to better reflect git doc and not break refspec spread param.

• ci: update usage

• apply review

• jsdoc

1.7.2 (2023-04-11)

1.7.1 (2023-04-04)

1.7.0 (2023-04-04)

Features

• git: allow force flag on gitSetRef (#148) (662f4ed)

1.6.2 (2023-04-03)

1.6.1 (2023-03-27)

1.6.0 (2023-03-27)

Features

• git: add git pull (#144) (75ea695)
• git: add support for ref tagging (#143) (b79b26a)

1.5.31 (2023-03-27)

1.5.30 (2023-03-23)

1.5.29 (2023-03-21)

1.5.28 (2023-03-20)

1.5.27 (2023-03-20)

1.5.26 (2023-03-14)

1.5.25 (2023-03-14)

Bug Fixes

• deps: update dependency tempfile to v5 (#133) (6f1eaae)

1.5.24 (2023-03-06)

1.5.23 (2023-03-06)

1.5.22 (2023-02-06)

1.5.21 (2023-01-31)

1.5.20 (2023-01-31)

1.5.19 (2023-01-24)

1.5.18 (2023-01-23)

1.5.17 (2023-01-17)

1.5.16 (2023-01-17)

1.5.15 (2023-01-16)

1.5.14 (2023-01-09)

1.5.13 (2023-01-09)

1.5.12 (2023-01-03)

1.5.11 (2023-01-03)

1.5.10 (2022-12-12)

1.5.9 (2022-12-12)

1.5.8 (2022-12-05)

1.5.7 (2022-12-05)

1.5.6 (2022-11-29)

Bug Fixes

• git: sanitize input (#115) (7de6c12)

1.5.5 (2022-11-21)

1.5.4 (2022-11-15)

1.5.3 (2022-11-11)

Bug Fixes

• npm: describeNpmTag, trim output (#111) (5d99669)

1.5.2 (2022-11-07)

Bug Fixes

• npm: export new func (#110) (b9f938d)

1.5.1 (2022-11-07)

1.5.0 (2022-11-07)

Features

• npm: add describeNpmTag function (#106) (17b4ba6)

1.4.1 (2022-11-07)

1.4.0 (2022-11-07)

Features

• version: augment conventional bump with a pre option (#105) (44b4774)

1.3.20 (2022-11-04)

1.3.19 (2022-10-31)

1.3.18 (2022-10-31)

1.3.17 (2022-10-24)

1.3.16 (2022-10-24)

1.3.15 (2022-10-18)

1.3.14 (2022-10-17)

1.3.13 (2022-10-14)

Bug Fixes

• git: properly decode emojis (#93) (760aafb)

1.3.12 (2022-10-11)

1.3.11 (2022-10-11)

1.3.10 (2022-10-03)

1.3.9 (2022-10-03)

1.3.8 (2022-09-27)

1.3.7 (2022-09-27)

1.3.6 (2022-09-19)

1.3.5 (2022-09-19)

1.3.4 (2022-09-12)

1.3.3 (2022-09-09)

1.3.2 (2022-09-06)

1.3.1 (2022-09-06)

1.3.0 (2022-08-31)

Features

• npm-version: support workspace update (#80) (751ed7f)

1.2.0 (2022-08-30)

Features

• npm: add tag flag support for npm publish (#79) (fe404dd)

1.1.13 (2022-08-29)

1.1.12 (2022-08-29)

1.1.11 (2022-08-22)

1.1.10 (2022-08-15)

1.1.9 (2022-08-15)

1.1.8 (2022-08-08)

1.1.7 (2022-08-08)

1.1.6 (2022-08-02)

1.1.5 (2022-08-02)

1.1.4 (2022-08-02)

1.1.3 (2022-08-01)

1.1.2 (2022-07-25)

1.1.1 (2022-07-25)

1.1.0 (2022-07-21)

Features

• pnpm: make filter optional for publish (#63) (4f052fb)

1.0.12 (2022-07-18)

1.0.11 (2022-07-18)

1.0.10 (2022-07-11)

1.0.9 (2022-07-11)

1.0.8 (2022-07-05)

1.0.7 (2022-07-05)

1.0.6 (2022-06-27)

1.0.5 (2022-06-27)

1.0.4 (2022-06-20)

1.0.3 (2022-06-20)

1.0.2 (2022-06-13)

1.0.1 (2022-06-13)

1.0.0 (2022-06-07)

• chore!: freeze specs to v1 (#49) (0fce790), closes #49

BREAKING CHANGES

• Freeze specifications for V1. Huzzah! p

0.7.0 (2022-06-07)

Features

• git: allow empty commits to be listed (#48) (9653e54)

0.6.0 (2022-06-06)

Features

• pnpm: remove support for pnpm6 (#45) (d5b4c6d)

0.5.4 (2022-06-06)

0.5.3 (2022-06-06)

0.5.2 (2022-06-06)

0.5.1 (2022-06-06)

0.5.0 (2022-06-04)

Features

• log outputs of subprocesses (#40) (83a0c90)

0.4.18 (2022-05-30)

0.4.17 (2022-05-30)

0.4.16 (2022-05-30)

0.4.15 (2022-05-25)

0.4.14 (2022-05-25)

0.4.13 (2022-05-25)

0.4.12 (2022-05-25)

0.4.11 (2022-05-24)

Reverts

• Revert "ci: remove ssh remote & deploy key (#32)" (0c91555), closes #32

0.4.1 (2022-05-24)

0.4.0 (2022-05-12)

Features

• pnpm: add support for pnpm 7 (#29) (85f65df)

0.3.7 (2022-04-11)

0.3.6 (2022-04-04)

0.3.5 (2022-04-04)

0.3.4 (2022-04-01)

Bug Fixes

• pnpm, publish: split parameter and value (#22) (67e7113)

0.3.3 (2022-04-01)

0.3.2 (2022-04-01)

0.3.1 (2022-04-01)

Bug Fixes

• pnpm, publish: return the spawned process (#15) (887b670), closes #16

0.3.0 (2022-04-01)

Features

• npm: add package-lock refresher (#13) (c05b700)

0.2.1 (2022-03-31)

0.2.0 (2022-03-30)

Bug Fixes

• git: narrow-down return types of get funcs (d65b9e3)

Features

• debug: added debug log when calling spawnSync (#12) (f7d91c5)