@oorabona/release-it-preset 0.11.0 → 0.12.0

package/README.md

@@ -661,6 +661,7 @@ Customize behavior with environment variables:
 ### Changelog
 - `CHANGELOG_FILE` - Changelog file path (default: `CHANGELOG.md`)
 - `GIT_CHANGELOG_PATH` - Optional. When set to a repository-relative path (e.g. `packages/tar-xz`), restrict changelog generation to commits touching that path. Useful for monorepo per-package CHANGELOG files. Empty / unset = repository-wide (default).
+- `GIT_CHANGELOG_SINCE` - Optional. Override the `since` baseline for changelog generation (any git ref: SHA, tag, branch). When set, bypasses both the per-package release-commit detection and the `git describe --tags` fallback. Useful for monorepo workspaces with non-standard release commit patterns. Empty / unset = use auto-detection.
 
 ### Git
 - `GIT_COMMIT_MESSAGE` - Commit message template (default: `release: bump v${version}`)

package/dist/scripts/populate-unreleased-changelog.js

@@ -167,20 +167,67 @@ export function parseCommitsWithMultiplePrefixes(gitOutput, repoUrl) {
     return sections.length > 0 ? sections.join('\n').trim() : 'No changes yet.';
 }
 /**
- * Main function to populate changelog with dependency injection
+ * Resolve the `since` baseline for changelog generation.
+ *
+ * Priority:
+ * 1. GIT_CHANGELOG_SINCE env var (any git ref — trust the user)
+ * 2. Per-package detection via `chore(<pkg>): release v` commit when GIT_CHANGELOG_PATH is set
+ * 3. Fallback: `git describe --tags --abbrev=0`
  */
-export function populateChangelog(deps) {
-    const changelogPath = deps.getEnv('CHANGELOG_FILE') || 'CHANGELOG.md';
-    deps.log('📝 Populating [Unreleased] section...');
-    let latestTag;
+export function resolveSinceBaseline(deps) {
+    // 1. Explicit override wins
+    const sinceOverride = deps.getEnv('GIT_CHANGELOG_SINCE');
+    if (sinceOverride && sinceOverride.trim()) {
+        deps.log(`ℹ️  Using GIT_CHANGELOG_SINCE override: ${sinceOverride.trim()}`);
+        return sinceOverride.trim();
+    }
+    // 2. Per-package detection: only when running scoped to a subdir
+    const path = deps.getEnv('GIT_CHANGELOG_PATH');
+    if (path && path.trim()) {
+        let pkgName = '';
+        try {
+            const pkgJsonRaw = deps.readFileSync('package.json', 'utf8');
+            const pkgNameFull = JSON.parse(pkgJsonRaw).name;
+            if (pkgNameFull) {
+                pkgName = pkgNameFull.startsWith('@')
+                    ? (pkgNameFull.split('/').pop() ?? '')
+                    : pkgNameFull;
+            }
+        }
+        catch {
+            // package.json missing or unreadable — skip per-package detection
+        }
+        if (pkgName) {
+            try {
+                const sha = deps.execSync(`git log --grep="^chore(${pkgName}): release v" -n 1 --pretty=format:"%H"`, { encoding: 'utf8' }).trim();
+                if (sha) {
+                    deps.log(`ℹ️  Per-package baseline (chore(${pkgName}): release …): ${sha.substring(0, 7)}`);
+                    return sha;
+                }
+            }
+            catch {
+                // fall through to tag fallback
+            }
+        }
+    }
+    // 3. Fallback: existing git describe behavior
     try {
-        latestTag = deps.execSync('git describe --tags --abbrev=0 2>/dev/null', { encoding: 'utf8' }).trim();
-        deps.log(`ℹ️  Latest tag: ${latestTag}`);
+        const tag = deps.execSync('git describe --tags --abbrev=0 2>/dev/null', { encoding: 'utf8' }).trim();
+        deps.log(`ℹ️  Latest tag: ${tag}`);
+        return tag;
     }
     catch {
         deps.log('ℹ️  No tags found, using all commits');
-        latestTag = '';
+        return '';
     }
+}
+/**
+ * Main function to populate changelog with dependency injection
+ */
+export function populateChangelog(deps) {
+    const changelogPath = deps.getEnv('CHANGELOG_FILE') || 'CHANGELOG.md';
+    deps.log('📝 Populating [Unreleased] section...');
+    const since = resolveSinceBaseline(deps);
     const gitChangelogPath = deps.getEnv('GIT_CHANGELOG_PATH');
     let pathFilter = '';
     if (gitChangelogPath !== undefined && gitChangelogPath !== '') {
@@ -192,8 +239,8 @@ export function populateChangelog(deps) {
         }
         pathFilter = ` -- ${gitChangelogPath}`;
     }
-    const gitLogCommand = latestTag
-        ? `git log --pretty=format:"%H|%B|||END|||" ${latestTag}..HEAD${pathFilter}`
+    const gitLogCommand = since
+        ? `git log --pretty=format:"%H|%B|||END|||" ${since}..HEAD${pathFilter}`
         : `git log --pretty=format:"%H|%B|||END|||"${pathFilter}`;
     let gitOutput;
     try {

package/dist/types/populate-unreleased-changelog.d.ts

@@ -50,6 +50,15 @@ export declare function normalizeCommitType(type: string): string | false;
  * Parse git log output and extract all conventional commit parts
  */
 export declare function parseCommitsWithMultiplePrefixes(gitOutput: string, repoUrl: string): string;
+/**
+ * Resolve the `since` baseline for changelog generation.
+ *
+ * Priority:
+ * 1. GIT_CHANGELOG_SINCE env var (any git ref — trust the user)
+ * 2. Per-package detection via `chore(<pkg>): release v` commit when GIT_CHANGELOG_PATH is set
+ * 3. Fallback: `git describe --tags --abbrev=0`
+ */
+export declare function resolveSinceBaseline(deps: PopulateChangelogDeps): string;
 /**
  * Main function to populate changelog with dependency injection
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oorabona/release-it-preset",
-  "version": "0.11.0",
+  "version": "0.12.0",
   "description": "Shared release-it configuration and scripts for the organisation",
   "type": "module",
   "keywords": [