zx-bulk-release 1.0.0

package/.github/workflows/ci.yml

@@ -0,0 +1,120 @@
+# This is a Github Workflow that runs tests on any push or pull request.
+# If the tests pass and this is a push to the master branch it also runs Semantic Release.
+name: CI
+on: [push, pull_request]
+jobs:
+  init:
+    name: init
+    runs-on: ubuntu-20.04
+    outputs:
+      skip: ${{ steps.ci-skip-step.outputs.ci-skip }}
+      skip-not: ${{ steps.ci-skip-step.outputs.ci-skip-not }}
+    steps:
+      - uses: actions/checkout@v3
+      - id: ci-skip-step
+        uses: mstachniuk/ci-skip@v1
+
+  test_push:
+    name: Test on push
+    needs: init
+    if: ${{ needs.init.outputs.skip == 'false' && github.event_name == 'push' }}
+    runs-on: ubuntu-20.04
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v3
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v3
+        with:
+          node-version: 18
+
+      - name: Install deps
+        run: yarn install
+
+      - name: Run tests
+        timeout-minutes: 2
+        run: yarn test
+
+  test_pr:
+    if: ${{ needs.init.outputs.skip == 'false' && github.event_name == 'pull_request' }}
+    needs: init
+    name: Test PR (Node v${{ matrix.node-version }}, OS ${{ matrix.os }})
+    strategy:
+      matrix:
+        os: [ ubuntu-20.04 ]
+        node-version: [ 16, 18 ]
+
+    runs-on: ${{ matrix.os }}
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v3
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v3
+        with:
+          node-version: ${{ matrix.node-version }}
+
+      - name: Install deps
+        run: yarn install
+
+      - name: Run tests
+        timeout-minutes: 2
+        run: yarn test
+
+  release:
+    name: Release
+    # https://github.community/t/trigger-job-on-tag-push-only/18076
+    if: github.event_name == 'push' && github.ref == 'refs/heads/master'
+    needs: test_push
+    runs-on: ubuntu-20.04
+    permissions:
+      checks: read
+      statuses: write
+      contents: write
+      packages: write
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v3
+        with:
+          fetch-depth: 0
+          ref: master
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v3
+        with:
+          node-version: 18
+
+      - name: Install deps
+        run: yarn install
+
+      - name: Create .npmrc
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+          VERDACCIO_TOKEN: ${{ secrets.VERDACCIO_TOKEN }}
+        run: |
+          echo "//registry.npmjs.org/:_authToken=${NPM_TOKEN}" >> .npmrc
+          echo "//npm.pkg.github.com/:_authToken=${GITHUB_TOKEN}" >> .npmrc
+
+      - name: Run tests
+        timeout-minutes: 2
+        run: yarn test
+
+      - name: Docs
+        run: yarn docs
+
+#      - name: Codeclimate
+#        uses: paambaati/codeclimate-action@v3.0.0
+#        env:
+#          CC_TEST_REPORTER_ID: ${{ secrets.CC_TEST_REPORTER_ID }}
+#        with:
+#          coverageLocations: |
+#            ${{github.workspace}}/coverage/*.lcov:lcov
+
+      - name: Release
+        env:
+          VERBOSE: ${{ secrets.VERBOSE }}
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          GIT_COMMITTER_NAME: ${{ secrets.GIT_COMMITTER_NAME }}
+          GIT_COMMITTER_EMAIL: ${{ secrets.GIT_COMMITTER_EMAIL }}
+        run: npm_config_yes=true npx zx-semrel

package/.github/workflows/codeql-analysis.yml

@@ -0,0 +1,70 @@
+# For most projects, this workflow file will not need changing; you simply need
+# to commit it to your repository.
+#
+# You may wish to alter this file to override the set of languages analyzed,
+# or to provide custom queries or build logic.
+#
+# ******** NOTE ********
+# We have attempted to detect the languages in your repository. Please check
+# the `language` matrix defined below to confirm you have the correct set of
+# supported CodeQL languages.
+#
+name: "CodeQL"
+
+on:
+  push:
+    branches: [ master ]
+  pull_request:
+    # The branches below must be a subset of the branches above
+    branches: [ master ]
+  schedule:
+    - cron: '26 11 * * 4'
+
+jobs:
+  analyze:
+    name: Analyze
+    runs-on: ubuntu-latest
+    permissions:
+      actions: read
+      contents: read
+      security-events: write
+
+    strategy:
+      fail-fast: false
+      matrix:
+        language: [ 'javascript' ]
+        # CodeQL supports [ 'cpp', 'csharp', 'go', 'java', 'javascript', 'python', 'ruby' ]
+        # Learn more about CodeQL language support at https://git.io/codeql-language-support
+
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v3
+
+    # Initializes the CodeQL tools for scanning.
+    - name: Initialize CodeQL
+      uses: github/codeql-action/init@v2
+      with:
+        languages: ${{ matrix.language }}
+        # If you wish to specify custom queries, you can do so here or in a config file.
+        # By default, queries listed here will override any specified in a config file.
+        # Prefix the list here with "+" to use these queries and those in the config file.
+        # queries: ./path/to/local/query, your-org/your-repo/queries@main
+
+    # Autobuild attempts to build any compiled languages  (C/C++, C#, or Java).
+    # If this step fails, then you should remove it and run the build manually (see below)
+    - name: Autobuild
+      uses: github/codeql-action/autobuild@v2
+
+    # ℹ️ Command-line programs to run using the OS shell.
+    # 📚 https://git.io/JvXDl
+
+    # ✏️ If the Autobuild fails above, remove it and uncomment the following three lines
+    #    and modify them (or add more) to build your code if your project
+    #    uses a compiled language
+
+    #- run: |
+    #   make bootstrap
+    #   make release
+
+    - name: Perform CodeQL Analysis
+      uses: github/codeql-action/analyze@v2

package/CHANGELOG.md

@@ -0,0 +1,17 @@
+## [1.0.0](https://github.com/semrel-extra/zx-bulk-release/compare/undefined...v1.0.0) (2022-06-17)
+
+### Features
+* feat: handle `workspace:` prefix ([d916069](https://github.com/semrel-extra/zx-bulk-release/commit/d9160696d5beefaf4c11ad27ffdb3675e9125273))
+* feat: add artifact push ([4852e90](https://github.com/semrel-extra/zx-bulk-release/commit/4852e903f7515a13516eae7a8c44e2458113b382))
+* feat: add tag on publish ([dc9af36](https://github.com/semrel-extra/zx-bulk-release/commit/dc9af3634bed102912ef98e3e98fabbc6f1966b7))
+* feat: add metabranch api ([b4c9562](https://github.com/semrel-extra/zx-bulk-release/commit/b4c95622cf5aa3aecf5853a1a266933c2dcddf14))
+* feat: add deps updater ([21e7fa6](https://github.com/semrel-extra/zx-bulk-release/commit/21e7fa60f49910aa65940007e2ba2c05f0b305e9))
+* feat: add tag parser/formatter ([1cee4e6](https://github.com/semrel-extra/zx-bulk-release/commit/1cee4e6f3680711a5eb079f0695c794297f0900f))
+* feat: add pkg commits extractor ([5c4dde2](https://github.com/semrel-extra/zx-bulk-release/commit/5c4dde206123f55f75c15b65d992e61e2ee73204))
+
+### Fixes & improvements
+* refactor: separate publish utils ([48d756b](https://github.com/semrel-extra/zx-bulk-release/commit/48d756badf57012b7ae97ae8f4bd4ccbc0dd473d))
+* docs: add refs ([c937fce](https://github.com/semrel-extra/zx-bulk-release/commit/c937fce4472f68c5d8e92e8970a15fca017dc656))
+* docs: add basic description ([bb4d0f4](https://github.com/semrel-extra/zx-bulk-release/commit/bb4d0f4e33cfae78868400e8bf17f488d5d4a2de))
+
+

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2022 semrel-extra
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,38 @@
+# zx-bulk-release
+> [zx](https://github.com/google/zx)-based alternative for [multi-semantic-release](https://github.com/dhoulb/multi-semantic-release)
+
+## Usage
+```shell
+GH_TOKEN=foo NPM_TOKEN=bar npx zx-bulk-release [opts]
+```
+
+or just copy-paste, tweak a bit and run with [zx-extra](https://github.com/qiwi/zx-extra):
+```shell
+GH_TOKEN=foo NPM_TOKEN=bar zx-extra zx-bulk-release.mjs
+```
+
+## Roadmap
+* [x] [Semantic commits](https://www.conventionalcommits.org/en/v1.0.0/#specification) trigger releases.
+* [x] Predictable [toposort](https://githib.com/semrel-extra/topo)-driven flow.
+* [x] No blocking (no release commits).
+* [ ] Changelogs, docs, bundles go to: release assets and/or meta branch.
+* [ ] No extra builds. Required deps are fetched from registry / meta branch / release assets.
+
+## Tags
+[Lerna](https://github.com/lerna/lerna) tags (like `@pkg/name@v1.0.0-beta.0`) are suitable for monorepos, but they don’t follow [semver spec](https://semver.org/). Therefore, we propose another contract: 
+```js
+'2022.6.13-optional-org.pkg-name.v1.0.0-beta.1+sha.1-f0'
+// date    name                  version             format                              
+```
+Note, [npm-package-name charset](https://www.npmjs.com/package/validate-npm-package-name) is wider than [semver](https://semver.org/spec/v2.0.0.html#spec-item-4), so we need a pinch of [base64url magic](https://stackoverflow.com/questions/55389211/string-based-data-encoding-base64-vs-base64url).
+
+## References
+* [semrel-extra/zx-semrel](https://github.com/semrel-extra/zx-semrel)
+* [dhoulb/multi-semantic-release](https://github.com/dhoulb/multi-semantic-release)
+* [semantic-release/semantic-release](https://github.com/semantic-release/semantic-release)
+* [tophat/monodeploy](https://github.com/tophat/monodeploy)
+* [conventional-changelog/releaser-tools](https://github.com/conventional-changelog/releaser-tools)
+* [pmowrer/semantic-release-monorepo](https://github.com/pmowrer/semantic-release-monorepo)
+
+## License 
+[MIT](./LICENSE)

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "zx-bulk-release",
+  "version": "1.0.0",
+  "description": "zx-based alternative for multi-semantic-release",
+  "exports": "./src/main/js/index.js",
+  "type": "module",
+  "scripts": {
+    "test": "NPM_REGISTRY='http://localhost:4873' NPM_TOKEN='mRv6eIuiaggXGb9ZDFCtBA==' c8 uvu ./src/test -i fixtures -i utils && c8 report -r lcov",
+    "docs": "mkdir -p docs && cp ./README.md ./docs/README.md"
+  },
+  "dependencies": {
+    "@semrel-extra/topo": "^1.4.1",
+    "git-glob-cp": "^1.5.1",
+    "zx-extra": "^1.7.0"
+  },
+  "devDependencies": {
+    "c8": "^7.11.3",
+    "uvu": "^0.5.3",
+    "verdaccio": "^5.13.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/semrel-extra/zx-bulk-release.git"
+  },
+  "author": "Anton Golub <antongolub@antongolub.com>",
+  "license": "MIT"
+}

package/src/main/js/analyzer.js

@@ -0,0 +1,65 @@
+import {ctx, semver} from 'zx-extra'
+
+const releaseSeverityOrder = ['major', 'minor', 'patch']
+const semanticRules = [
+  {group: 'Features', releaseType: 'minor', prefixes: ['feat']},
+  {group: 'Fixes & improvements', releaseType: 'patch', prefixes: ['fix', 'perf', 'refactor', 'docs']},
+  {group: 'BREAKING CHANGES', releaseType: 'major', keywords: ['BREAKING CHANGE', 'BREAKING CHANGES']},
+]
+
+export const getPkgCommits = async (cwd, since) => ctx(async ($) => {
+  $.cwd = cwd
+
+  const range = since ? `${since}..HEAD` : 'HEAD'
+
+  return (await $.raw`git log ${range} --format=+++%s__%b__%h__%H -- .`)
+    .toString()
+    .split('+++')
+    .filter(Boolean)
+    .map(msg => {
+      const [subj, body, short, hash] = msg.split('__').map(raw => raw.trim())
+      return {subj, body, short, hash}
+    })
+})
+
+export const getSemanticChanges = async (cwd, since) => {
+  const commits = await getPkgCommits(cwd, since)
+  const semanticChanges = commits
+    .reduce((acc, {subj, body, short, hash}) => {
+    semanticRules.forEach(({group, releaseType, prefixes, keywords}) => {
+      const prefixMatcher = prefixes && new RegExp(`^(${prefixes.join('|')})(\\(\\w+\\))?:\\s.+$`)
+      const keywordsMatcher = keywords && new RegExp(`(${keywords.join('|')}):\\s(.+)`)
+      const change = subj.match(prefixMatcher)?.[0] || body.match(keywordsMatcher)?.[2]
+
+      if (change) {
+        acc.push({
+          group,
+          releaseType,
+          change,
+          subj,
+          body,
+          short,
+          hash
+        })
+      }
+    })
+    return acc
+  }, [])
+
+  return semanticChanges
+}
+
+export const getNextReleaseType = (changes) => releaseSeverityOrder.find(type => changes.find(({releaseType}) => type === releaseType))
+
+export const getNextVersion = (changes, prevVersion) => {
+  if (!prevVersion) return '1.0.0'
+
+  const releaseType = getNextReleaseType(changes)
+
+  return semver.inc(prevVersion, releaseType)
+}
+
+export const resolvePkgVersion = (changes, prevVersion) =>
+  changes.length > 0
+    ? getNextVersion(changes, prevVersion)
+    : prevVersion || null

package/src/main/js/cli.js

@@ -0,0 +1,3 @@
+import {run} from './index.js'
+
+run()

package/src/main/js/deps.js

@@ -0,0 +1,46 @@
+import {semver} from 'zx-extra'
+
+export const depScopes = ['dependencies', 'devDependencies', 'peerDependencies', 'optionalDependencies']
+
+export const updateDeps = async (pkg, packages) => {
+  const {manifest} = pkg
+  const changes = []
+
+  for (let scope of depScopes) {
+    const deps = manifest[scope]
+    if (!deps) continue
+
+    for (let [name, version] of Object.entries(deps)) {
+      const next = resolveVersion(version, packages[name]?.version, pkg.latest.manifest?.[scope]?.[name])
+      if (!next) continue
+
+      deps[name] = next
+
+      changes.push({
+        group: 'Dependencies',
+        releaseType: 'patch',
+        change: 'perf',
+        subj: `perf: ${name} updated to ${next}`,
+      })
+    }
+  }
+
+  return changes
+}
+
+export const resolveVersion = (decl, actual, prev) => {
+  if (!decl) return null
+
+  // https://yarnpkg.com/features/workspaces
+  if (decl.startsWith('workspace:')) {
+    const [, range, caret] = /^workspace:(([\^~*])?.*)$/.exec(decl)
+
+    decl = caret === range
+      ? caret === '*' ? actual : caret + actual
+      : range
+  }
+
+  if (!semver.satisfies(actual, decl)) return actual === prev ? null : actual
+
+  return decl === prev ? null : decl
+}

package/src/main/js/index.js

@@ -0,0 +1,35 @@
+import {fs} from 'zx-extra'
+import {updateDeps} from './deps.js'
+import {getSemanticChanges, resolvePkgVersion} from './analyzer.js'
+import { topo } from '@semrel-extra/topo'
+
+import {publish, getLatest} from './publish.js'
+import {formatTag} from './tag.js'
+
+export {parseTag, formatTag, getTags} from './tag.js'
+
+export { topo }
+
+export const run = async ({cwd = process.cwd(), env = process.env} = {}) => {
+  const {packages, queue} = await topo({cwd})
+
+  for (let name of queue) {
+    const pkg = packages[name]
+    pkg.latest = await getLatest(cwd, name)
+
+    const semanticChanges = await getSemanticChanges(pkg.absPath, pkg.latest.tag?.ref)
+    const depsChanges = await updateDeps(pkg, packages)
+    const changes = [...semanticChanges, ...depsChanges]
+
+    pkg.version = resolvePkgVersion(changes, pkg.latest.tag?.version || pkg.manifest.version)
+    pkg.manifest.version = pkg.version
+
+    if (changes.length === 0) continue
+
+    console.log(`semantic changes of '${name}'`, changes)
+
+    await fs.writeJson(pkg.manifestPath, pkg.manifest, {spaces: 2})
+
+    await publish(pkg, env)
+  }
+}

package/src/main/js/publish.js

@@ -0,0 +1,89 @@
+import {formatTag, getLatestTag} from './tag.js'
+import {tempy, ctx, fs, path, $} from 'zx-extra'
+import {copydir} from 'git-glob-cp'
+
+const branches = {}
+
+export const fetch = async ({cwd: _cwd, branch, origin: _origin}) => ctx(async ($) => {
+  let cwd = branches[branch]
+  if (cwd) return cwd
+
+  $.cwd = _cwd
+  const origin = _origin || (await $`git remote get-url origin`).toString().trim()
+
+  cwd = tempy.temporaryDirectory()
+  $.cwd = cwd
+  try {
+    await $`git clone --single-branch --branch ${branch} --depth 1 ${origin} .`
+  } catch {
+    await $`git init .`
+    await $`git remote add origin ${origin}`
+  }
+
+  branches[branch] = cwd
+
+  return cwd
+})
+
+export const push = async ({cwd, from, to, branch, origin, msg, ignoreFiles}) => ctx(async ($) => {
+  const _cwd = await fetch({cwd, branch, origin})
+  await copydir({baseFrom: cwd, from, baseTo: _cwd, to})
+
+  $.cwd = _cwd
+
+  await $`git config user.name ${$.env.GIT_COMMITTER_NAME || 'Semrel Extra Bot'}`
+  await $`git config user.email ${$.env.GIT_COMMITTER_EMAIL || 'semrel-extra-bot@hotmail.com'}`
+  await $`git add .`
+  await $`git commit -m ${msg}`
+  await $.raw`git push origin HEAD:refs/heads/${branch}`
+})
+
+export const publish = async (pkg, env) => ctx(async ($) => {
+  const {name, version, files} = pkg.manifest
+  const cwd = pkg.absPath
+  $.cwd = cwd
+  $.env = env
+
+  const tag = formatTag({name, version})
+  const from = files ? [...files, 'package.json'] : ['!node_modules', '*']
+  const to = getArtifactPath(tag)
+
+  console.log(`push release tag ${tag}`)
+  await $`git config user.name ${$.env.GIT_COMMITTER_NAME || 'Semrel Extra Bot'}`
+  await $`git config user.email ${$.env.GIT_COMMITTER_EMAIL || 'semrel-extra-bot@hotmail.com'}`
+  await $`git tag -m ${tag} ${tag}`
+  await $`git push origin ${tag}`
+
+  console.log('push artifact to branch `meta`')
+  await push({cwd, from, to, branch: 'meta', msg: `chore: publish artifact ${name} ${version}`, ignoreFiles: '.npmignore'})
+
+  const registry = env.NPM_REGISTRY || 'https://registry.npmjs.org'
+  const npmrc = path.resolve(cwd, '.npmrc')
+  console.log(`publish npm package to ${registry}`)
+
+  await $.raw`echo ${registry.replace(/https?:/, '')}/:_authToken=${$.env.NPM_TOKEN} >> ${npmrc}`
+  await $`npm publish --no-git-tag-version --registry=${registry} --userconfig ${npmrc} --no-workspaces`
+})
+
+export const getArtifactPath = (tag) => tag.toLowerCase().replace(/[^a-z0-9-]/g, '-')
+
+export const getLatestManifest = async (cwd, tag) => {
+  if (!tag) return null
+
+  try {
+    const meta = await fetch({cwd, branch: 'meta'})
+    return await fs.readJson(path.resolve(meta, getArtifactPath(tag), 'package.json'))
+  } catch {}
+
+  return null
+}
+
+export const getLatest = async (cwd, name) => {
+  const tag = await getLatestTag(cwd, name)
+  const manifest = await getLatestManifest(cwd, tag?.ref)
+
+  return {
+    tag,
+    manifest
+  }
+}

package/src/main/js/tag.js

@@ -0,0 +1,89 @@
+// Semantic tags
+
+import {ctx, semver} from 'zx-extra'
+import {Buffer} from 'buffer'
+
+const f0 = {
+  parse(tag) {
+    if (!tag.endsWith('-f0')) return null
+
+    const pattern = /^(\d{4}\.(?:[1-9]|1[012])\.(?:0[1-9]|[12]\d|30|31))-((?:[a-z0-9-]+\.)?[a-z0-9-]+)\.(v?\d+\.\d+\.\d+.*)-f0$/
+    const matched = pattern.exec(tag)
+    const [, _date, _name, version] = matched || []
+
+    if (!semver.valid(version)) return null
+
+    const date = parseDateTag(_date)
+    const name = _name.includes('.') ? `@${_name.replace('.', '/')}` : _name
+
+    return {date, name, version, format: 'f0', ref: tag}
+  },
+  format({name, date = new Date(), version}) {
+    if (!/^(@?[a-z0-9-]+\/)?[a-z0-9-]+$/.test(name) || !semver.valid(version)) return null
+
+    const d = formatDateTag(date)
+    const n = name.replace('@', '').replace('/', '.')
+
+    return `${d}-${n}.${version}-f0`
+  }
+}
+
+const f1 = {
+  parse(tag) {
+    if (!tag.endsWith('-f1')) return null
+
+    const pattern = /^(\d{4}\.(?:[1-9]|1[012])\.(?:0[1-9]|[12]\d|30|31))-[a-z0-9-]+\.(v?\d+\.\d+\.\d+.*)\.([^.]+)-f1$/
+    const matched = pattern.exec(tag)
+    const [, _date, version, b64] = matched || []
+
+    if (!semver.valid(version)) return null
+
+    const date = parseDateTag(_date)
+    const name = Buffer.from(b64, 'base64url').toString('utf8')
+
+    return {date, name, version, format: 'f1', ref: tag}
+  },
+  format({name, date = new Date(), version}) {
+    if (!semver.valid(version)) return null
+
+    const b64 = Buffer.from(name).toString('base64url')
+    const d = formatDateTag(date)
+    const n = name.replace(/[^a-z0-9-]/ig, '')
+
+    return `${d}-${n}.${version}.${b64}-f1`
+  }
+}
+
+// TODO
+// const variants = [f0, f1]
+// export const parseTag = (tag) => {
+//   for (const variant of variants) {
+//     const parsed = variant.parse(tag)
+//     if (parsed) return parsed
+//   }
+//
+//   return null
+// }
+
+export const parseTag = (tag) => f0.parse(tag) || f1.parse(tag) || null
+
+export const formatTag = (tag) => f0.format(tag) || f1.format(tag) || null
+
+export const getTags = (cwd) => ctx(async ($) => {
+  $.cwd = cwd
+
+  return (await $`git tag -l --sort=-v:refname`).toString()
+    .split('\n')
+    .map(tag => parseTag(tag.trim()))
+    .filter(Boolean)
+})
+
+export const getLatestTag = async (cwd, name) =>
+  (await getTags(cwd)).find(tag => tag.name === name) || null
+
+export const getLatestTaggedVersion = async (cwd, name) =>
+  (await getLatestTag(cwd, name))?.version || null
+
+export const formatDateTag = (date = new Date()) => `${date.getUTCFullYear()}.${date.getUTCMonth() + 1}.${date.getUTCDate()}`
+
+export const parseDateTag = (date) => new Date(date.replaceAll('.', '-')+'Z')

package/src/test/fixtures/regular-monorepo/.editorconfig

@@ -0,0 +1,10 @@
+root = true
+
+[*]
+end_of_line = lf
+insert_final_newline = true
+
+[*.{js,json,yml}]
+charset = utf-8
+indent_style = space
+indent_size = 2