lechnerio-git-hooks 1.3.1 → 1.3.2

package/README.md

@@ -34,9 +34,13 @@ On install, the package automatically:
 | `commit-msg`  | Enforces conventional commits via commitlint                                                 |
 | `post-commit` | Interactive version bump (subtle/patch/minor/major), changelog generation with optional skip flag, push/merge prompt |
 
+## Changelog versioning model
+
+Commits belong to the version that was current while they were made. A Minor or Major bump closes the running version — all work since the previous bump stays under it, including the commit that triggered the bump — and opens the new version with a `Version Upgrade to <version>` marker entry. Future commits then accumulate under the new version.
+
 ## AI release summaries
 
-On Minor and Major version bumps, the `post-commit` hook sends the version's non-skipped commit messages to the Gemini API and stores the result as `summary_en` and `summary_ger` fields (English and German) on the version entry in `data/changelog.json`. This requires `GITHOOKS_GEMINI_API_KEY` in the project's `.env` file or environment; without it the summary step is skipped silently.
+On Minor and Major version bumps, the `post-commit` hook sends the non-skipped commit messages of the version being closed to the Gemini API and stores the result as `summary_en` and `summary_ger` fields (English and German) on that version entry in `data/changelog.json`. This requires `GITHOOKS_GEMINI_API_KEY` in the project's `.env` file or environment; without it the summary step is skipped silently. Run `node scripts/generate-changelog.mjs --summarize-version <version>` to generate the summary for any version by hand (accepts the version with or without the `v` prefix, subtle suffixes are normalized). Summaries are only generated when `summary_en` or `summary_ger` is missing on the entry — to regenerate one, delete both fields from `data/changelog.json` first.
 
 ## Peer dependencies (auto-installed)
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lechnerio-git-hooks",
-  "version": "1.3.1",
+  "version": "1.3.2",
   "description": "Shared git hooks for lechnerio projects",
   "type": "module",
   "scripts": {

package/scripts/generate-changelog.mjs

@@ -58,23 +58,13 @@ if (process.argv.includes("--skip-last")) {
 
 const changelog = []
 
-const currentVersion = tags[0].replace(/^v/, "")
-const unreleasedRaw = run(`git log --format="%s" ${tags[0]}..HEAD`)
-if (unreleasedRaw) {
-  const commits = [...new Set(unreleasedRaw.split("\n").filter(Boolean))].map((message) => ({ message, skip: skipFlags.get(message) ?? false }))
-  if (commits.length > 0) {
-    const date = run(`git log --format=%ai HEAD -1`).split(" ")[0]
-    changelog.push({ version: currentVersion, tag: null, date, commits })
-  }
-}
-
 for (let i = 0; i < tags.length; i++) {
   const tag = tags[i]
+  const upper = i === 0 ? "HEAD" : tags[i - 1]
+  const eraRaw = run(`git log --format="%s" ${tag}..${upper}`)
+  const initialRaw = i === tags.length - 1 ? run(`git log --format="%s" ${tag}`) : ""
+  const raw = [eraRaw, initialRaw].filter(Boolean).join("\n")
   const date = run(`git log --format=%ai ${tag} -1`).split(" ")[0]
-  const prevTag = tags[i + 1]
-
-  const range = prevTag ? `${prevTag}..${tag}` : tag
-  const raw = run(`git log --format="%s" ${range}`)
 
   const commits = raw
     ? [...new Set(raw.split("\n").filter(Boolean))].map((message) => ({ message, skip: skipFlags.get(message) ?? false }))
@@ -112,6 +102,14 @@ for (const entry of grouped) {
   })
 }
 
+for (let i = 0; i < grouped.length - 1; i++) {
+  const entry = grouped[i]
+  const marker = `Version Upgrade to ${entry.version}`
+  if (!entry.commits.some((c) => c.message === marker)) {
+    entry.commits.push({ message: marker, skip: skipFlags.get(marker) ?? false })
+  }
+}
+
 for (const entry of grouped) {
   const saved = summaries.get(entry.version)
   if (saved) {
@@ -120,13 +118,22 @@ for (const entry of grouped) {
   }
 }
 
-if (process.argv.includes("--summarize")) {
+const svIndex = process.argv.indexOf("--summarize-version")
+const requestedVersion = svIndex === -1 ? null : process.argv[svIndex + 1] ?? null
+
+if (process.argv.includes("--summarize") || svIndex !== -1) {
   const apiKey = loadEnvKey("GITHOOKS_GEMINI_API_KEY")
-  if (!apiKey) {
+  if (svIndex !== -1 && !requestedVersion) {
+    console.warn("--summarize-version requires a version argument")
+  } else if (!apiKey) {
     console.warn("GITHOOKS_GEMINI_API_KEY not set, skipping AI summary")
   } else {
-    const target = grouped.find((e) => e.version === baseVersion(tags[0].replace(/^v/, "")))
-    if (target && !(target.summary_en && target.summary_ger)) {
+    const closedTag = tags.length > 1 ? tags[1] : tags[0]
+    const targetVersion = requestedVersion ? baseVersion(requestedVersion.replace(/^v/, "")) : baseVersion(closedTag.replace(/^v/, ""))
+    const target = grouped.find((e) => e.version === targetVersion)
+    if (!target) {
+      console.warn(`version ${targetVersion} not found in changelog`)
+    } else if (!(target.summary_en && target.summary_ger)) {
       const messages = target.commits.filter((c) => !c.skip).map((c) => c.message)
       if (messages.length === 0) {
         console.warn("no commits to summarize")