generate changelog for changes since last tag, quarterly

[sdetweil]

we create a release every quarter. our current manual changelog (as part of the PR) gets in the way during the quarter with PR's processed out of date order and creating conflicts.

SO, want to use git-cliff to create the changelog at release time

we create the tag ON the RELEASE... so promote from develop to master, update a couple files on master, tag master

update develop with new proposed release number (package.json)
start updates on develop again, til next release

no parms gives me all the way back to 2016 open of repo
--latest gives me all the changes IN the last tag.. not since
--tag v2.29.0 replicates --latest

sitting in the working directory on the develop branch,
git tag shows the list of tags, (giving the tag regex pattern doesn't help)
git log shows me the commits

what am I doing wrong?

[orhun]

Hello! 👋🏼

To generate a changelog for the specific part of the Git history, you can use ranges like so:

git cliff v2.29.0...main

See the other examples here: https://git-cliff.org/docs/usage/examples

That being said, I'm not sure if I understood your use case fully. Posting snippets from your Git history, git-cliff configuration and sharing what you want your changelog to look like would really help here :)

[sdetweil]

thanks.. was hoping not to specify range..

our master is master

but this fails either way
git cliff v2.29.0...main or master

git-cliff v2.29.0...main
 WARN  git_cliff > "cliff.toml" is not found, using the default configuration.
 ERROR git_cliff > Git error: `revspec 'main' not found; class=Reference (4); code=NotFound (-3)`
file:///usr/local/lib/node_modules/git-cliff/node_modules/execa/lib/error.js:60
		error = new Error(message);
		        ^

Error: Command failed with exit code 1: /usr/local/lib/node_modules/git-cliff/node_modules/git-cliff-linux-x64/bin/git-cliff v2.29.0...main
    at makeError (file:///usr/local/lib/node_modules/git-cliff/node_modules/execa/lib/error.js:60:11)
    at handlePromise (file:///usr/local/lib/node_modules/git-cliff/node_modules/execa/index.js:124:26)
    at process.processTicksAndRejections (node:internal/process/task_queues:95:5)
    at async run (file:///usr/local/lib/node_modules/git-cliff/lib/cli/cli.js:64:25) {
  shortMessage: 'Command failed with exit code 1: /usr/local/lib/node_modules/git-cliff/node_modules/git-cliff-linux-x64/bin/git-cliff v2.29.0...main',
  command: '/usr/local/lib/node_modules/git-cliff/node_modules/git-cliff-linux-x64/bin/git-cliff v2.29.0...main',
  escapedCommand: '"/usr/local/lib/node_modules/git-cliff/node_modules/git-cliff-linux-x64/bin/git-cliff" v2.29.0...main',
  exitCode: 1,
  signal: undefined,
  signalDescription: undefined,
  stdout: undefined,
  stderr: undefined,
  cwd: '/home/sam/MagicMirror.old',
  failed: true,
  timedOut: false,
  isCanceled: false,
  killed: false
}

Node.js v20.9.0

branch list

(base) sam@sams:~/MagicMirror.old$ git branch
  add_rev_proxy
* develop
  fix_positions
  fixcal
  fixcaldates3
  master
  updateconfig_sample
  withexec

log

git log 
commit 786eacf41ac68ee3e166400722ac1066e3fa83a0 (HEAD -> develop, origin/develop)
Author: sam detweiler <sdetweil@gmail.com>
Date:   Wed Dec 18 06:43:20 2024 -0600

    update config.js.sample about locale variable (#3655)
    
    add text to config.js.sample about usage of locale variable/property
    
    Co-authored-by: Veeck <github@veeck.de>

commit 5b3b40da661835c4c5ee4e8cbbd3121934827aab
Author: Kristjan ESPERANTO <35647502+KristjanESPERANTO@users.noreply.github.com>
Date:   Wed Dec 18 08:00:00 2024 +0100

    Use project URL in fallback config (#3656)

commit 5232f46d4458d20ef09193ec2351e0ddb562fbf1
Author: sam detweiler <sdetweil@gmail.com>
Date:   Sun Dec 8 14:23:53 2024 -0600

    fix #3267 again this time, dropped from big cal update (#3650)
    
    this change was dropped from #3267 by mistake

commit 39ab651319daadd72011ecc48cb2b8715e82b07e (fixcaldates3)
Author: sam detweiler <sdetweil@gmail.com>
Date:   Sun Dec 8 09:24:39 2024 -0600

    Show animations, fix export only on server side (#3649)
    
    fix #3644 so only on server side

existing changelog , prev release to now

## [2.30.0] - Unreleased (`develop` branch)

_This release is scheduled to be released on 2025-01-01._

### Added

- [core] Add wayland and windows start options to `package.json` (#3594)
- [docs] Add step for npm publishing in release process (#3595)
- [core] Add GitHub workflow to run spellcheck a few days before each release (#3623)
- [core] Add test flag to `index.html` to pass to module js for test mode detection (needed by #3630)
- [core] Add export on animation names (#3644)
- [compliments] Add support for refreshing remote compliments file, and test cases (#3630)
- [linter] Re-add `eslint-plugin-import`now that it supports ESLint v9 (#3586)
- [linter] Re-activate `eslint-plugin-package-json` to lint `package.json` (#3643)
- [linter] Add linting for markdown files (#3646)
- [calendar] Add ability to display end date for full date events, where end is not same day (showEnd=true) (#3650)
- [core] Add text to the config.js.sample file about the locale variable (#3654)

### Changed

- [core] Run code style checks in workflow only once (#3648)
- [core] Fix animations export #3644 only on server side (#3649)
- [core] Use project URL in fallback config.

### Removed

- [tests] Remove `node-pty` and `drivelist` from rebuilded test (#3575)
- [deps] Remove `@eslint/js` dependency. Already installed with `eslint` in deep (#3636)

### Updated

- [repo] Reactivate `stale.yaml` as GitHub action to mark issues as stale after 60 days and close them 7 days later (if no activity) (#3577, #3580, #3581)
- [core] Update electron dependency to v32 (test electron rebuild) and other dependencies too
- [tests] All test configs have been updated to allow full external access, allowing for easier debugging (especially when running as a container)
- [core] Run and test with node 23 (#3588)

### Fixed

- [updatenotification] Fix pm2 using detection when pm2 script is inside or outside MagicMirror root folder (#3576) (#3605) (#3626) (#3628)
- [core] Fix loading node_helper of modules: avoid black screen, display errors and continue loading with next module (#3578)
- [weather] Change default value for weatherEndpoint of provider openweathermap to "/onecall" (#3574)
- [tests] Fix electron tests with mock dates, the mock on server side was missing (#3597)
- [tests] Fix testcases with hard coded Date.now (#3597)
- [core] Fix missing `basePath` where `location.host` is used (#3613)
- [compliments] croner library changed filenames used in latest version (#3624)
- [linter] Fix ESLint ignore pattern which caused that default modules not to be linted (#3632)
- [calendar] Update to resolve issues #3098 #3144 #3351 #3422 #3443 #3467 #3537 related to timezone changes
- [calendar] Fix #3267 (styles array), also fixes event with both exdate AND recurrence(and testcase)
- [calendar] Fix showEndsOnlyWithDuration not working, #3598, applies ONLY to full day events
- [calendar] Fix showEnd for Full Day events (#3602)
- [tests] Suppress "module is not defined" in e2e tests (#3647)
- [calendar] Fix #3267 (styles array, really this time!)

## [2.29.0] - 2024-10-01