lechnerio-git-hooks 1.2.0 → 1.3.1

package/README.md

@@ -32,7 +32,11 @@ On install, the package automatically:
 | ------------- | -------------------------------------------------------------------------------------------- |
 | `pre-commit`  | Runs lint-staged (eslint --fix + prettier)                                                   |
 | `commit-msg`  | Enforces conventional commits via commitlint                                                 |
-| `post-commit` | Interactive version bump (subtle/patch/minor/major), changelog generation, push/merge prompt |
+| `post-commit` | Interactive version bump (subtle/patch/minor/major), changelog generation with optional skip flag, push/merge prompt |
+
+## 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.
 
 ## Peer dependencies (auto-installed)
 
@@ -55,6 +59,9 @@ For non-interactive usage (CI, scripts):
 | -------------- | --------------------------------------------------------------- |
 | `VERSION_BUMP` | `1` = subtle, `2` = patch, `3` = minor, `4` = major, `0` = skip |
 | `POST_ACTION`  | `1` = push, `2` = merge to main, `0` = skip                     |
+| `CHANGELOG_ADD` | `1` = keep commit in changelog, `0` = mark it skipped (asked when version bump is skipped) |
+| `GITHOOKS_GEMINI_API_KEY` | Gemini API key for AI release summaries; unset = feature disabled                 |
+| `GITHOOKS_GEMINI_MODEL` | Optional Gemini model for summaries, defaults to `gemini-flash-latest`                 |
 
 ## Update
 

package/hooks/post-commit

@@ -76,13 +76,51 @@ bump_and_amend() {
     git add package.json
     git commit --amend --no-edit
     git tag -f -a "v${new_ver}" -m "v${new_ver}"
-    node scripts/generate-changelog.mjs 2>/dev/null
+    local summarize_flag=""
+    if [ "$label" = "Minor" ] || [ "$label" = "Major" ]; then
+        summarize_flag="--summarize"
+        echo -e "${CYAN}🤖 Generating AI summary...${NC}"
+    fi
+    node scripts/generate-changelog.mjs $summarize_flag
     git add data/changelog.json
     git commit --amend --no-edit --no-verify
     git tag -f -a "v${new_ver}" -m "v${new_ver}"
     echo -e "${GREEN}✅ $label version bumped to ${new_ver}${NC}"
 }
 
+prompt_changelog_skip() {
+    local choice
+    if [ -n "$CHANGELOG_ADD" ]; then
+        choice="$CHANGELOG_ADD"
+    elif exec < /dev/tty 2>/dev/null; then
+        echo -e "${CYAN}🔄 Changelog${NC}"
+        echo
+        echo -e "${CYAN}Should we add this message to the changelog?${NC}"
+        echo
+        echo -e "1) Yes ${YELLOW}(default)${NC}"
+        echo -e "${GRAY}0) No - Skip Changelog${NC}"
+        echo
+        echo -n "Select option (Enter for Default or 0 to skip): "
+        read -r choice
+        choice=${choice:-1}
+    else
+        choice=1
+    fi
+    echo
+
+    if [ "$choice" = "0" ]; then
+        if [ "$DRY_RUN" = "true" ]; then
+            echo -e "${YELLOW}[DRY RUN] Would mark commit as skipped in changelog${NC}"
+        else
+            node scripts/generate-changelog.mjs --skip-last 2>/dev/null
+            git add data/changelog.json
+            git commit --amend --no-edit --no-verify
+            echo -e "${CYAN}📋 Commit marked as skipped in changelog${NC}"
+            echo
+        fi
+    fi
+}
+
 do_push() {
     echo -e "${YELLOW}✈️  Pushing to GitHub...${NC}"
     if [ "$DRY_RUN" = "true" ]; then
@@ -277,7 +315,7 @@ case $version_choice in
     3)
         echo -e "${YELLOW}📦 Bumping minor version...${NC}"
         if [ "$DRY_RUN" = "true" ]; then
-            echo -e "${YELLOW}[DRY RUN] Would bump to ${minor_ver}${NC}"
+            echo -e "${YELLOW}[DRY RUN] Would bump to ${minor_ver} and generate AI summary${NC}"
         else
             bump_and_amend "$minor_ver" "Minor"
         fi
@@ -285,12 +323,13 @@ case $version_choice in
     4)
         echo -e "${YELLOW}📦 Bumping major version...${NC}"
         if [ "$DRY_RUN" = "true" ]; then
-            echo -e "${YELLOW}[DRY RUN] Would bump to ${major_ver}${NC}"
+            echo -e "${YELLOW}[DRY RUN] Would bump to ${major_ver} and generate AI summary${NC}"
         else
             bump_and_amend "$major_ver" "Major"
         fi
         ;;
     0)
+        prompt_changelog_skip
         echo -e "${YELLOW}⏭️  Skipping version bump${NC}"
         ;;
     *)

package/package.json

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

package/scripts/generate-changelog.mjs

@@ -1,8 +1,21 @@
 import { execSync } from "child_process"
-import { writeFileSync, mkdirSync } from "fs"
+import { writeFileSync, mkdirSync, readFileSync, existsSync } from "fs"
 
 const run = (cmd) => execSync(cmd, { encoding: "utf-8", shell: "bash" }).trim()
 
+const loadEnvKey = (name) => {
+  if (process.env[name]) return process.env[name]
+  try {
+    const line = readFileSync(".env", "utf-8")
+      .split("\n")
+      .map((l) => l.trim())
+      .find((l) => l.startsWith(`${name}=`))
+    return line ? line.slice(name.length + 1).trim().replace(/^["']|["']$/g, "") : null
+  } catch {
+    return null
+  }
+}
+
 try {
   run("git --version")
   run("git rev-parse --git-dir")
@@ -17,12 +30,38 @@ if (tags.length === 0) {
   process.exit(0)
 }
 
+const skipFlags = new Map()
+const summaries = new Map()
+if (existsSync("data/changelog.json")) {
+  try {
+    const existing = JSON.parse(readFileSync("data/changelog.json", "utf-8"))
+    for (const entry of existing) {
+      const summaryEn = entry.summary_en ?? entry.summary
+      const summaryGer = entry.summary_ger
+      if (typeof summaryEn === "string" || typeof summaryGer === "string") {
+        const saved = {}
+        if (typeof summaryEn === "string") saved.summary_en = summaryEn
+        if (typeof summaryGer === "string") saved.summary_ger = summaryGer
+        summaries.set(entry.version, saved)
+      }
+      for (const commit of entry.commits ?? []) {
+        skipFlags.set(commit.message, commit.skip === true)
+      }
+    }
+  } catch {}
+}
+
+if (process.argv.includes("--skip-last")) {
+  const lastSubject = run('git log -1 --format="%s"')
+  skipFlags.set(lastSubject, true)
+}
+
 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 }))
+  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 })
@@ -38,7 +77,7 @@ for (let i = 0; i < tags.length; i++) {
   const raw = run(`git log --format="%s" ${range}`)
 
   const commits = raw
-    ? [...new Set(raw.split("\n").filter(Boolean))].map((message) => ({ message }))
+    ? [...new Set(raw.split("\n").filter(Boolean))].map((message) => ({ message, skip: skipFlags.get(message) ?? false }))
     : []
 
   changelog.push({
@@ -54,10 +93,11 @@ const baseVersion = (v) => v.replace(/[a-z]+$/i, "")
 const grouped = []
 for (const entry of changelog) {
   const base = baseVersion(entry.version)
-  const existing = grouped.find((g) => g.version === base && g.tag !== null)
+  const existing = grouped.find((g) => g.version === base)
   if (existing) {
     existing.commits.push(...entry.commits)
     if (entry.date < existing.date) existing.date = entry.date
+    if (entry.tag && (!existing.tag || entry.tag.replace(/^v/, "") === base)) existing.tag = entry.tag
   } else {
     grouped.push({ ...entry, version: base })
   }
@@ -72,6 +112,59 @@ for (const entry of grouped) {
   })
 }
 
+for (const entry of grouped) {
+  const saved = summaries.get(entry.version)
+  if (saved) {
+    if (saved.summary_en && !entry.summary_en) entry.summary_en = saved.summary_en
+    if (saved.summary_ger && !entry.summary_ger) entry.summary_ger = saved.summary_ger
+  }
+}
+
+if (process.argv.includes("--summarize")) {
+  const apiKey = loadEnvKey("GITHOOKS_GEMINI_API_KEY")
+  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 messages = target.commits.filter((c) => !c.skip).map((c) => c.message)
+      if (messages.length === 0) {
+        console.warn("no commits to summarize")
+      } else {
+        const model = loadEnvKey("GITHOOKS_GEMINI_MODEL") ?? "gemini-flash-latest"
+        const prompt = `Summarize these commit messages into a short user-facing release summary for version ${target.version}. Write 1-3 plain sentences per language, no markdown, no bullet points, no preamble. Return a JSON object with exactly two string keys: "summary_en" (English) and "summary_ger" (German).\n\n${messages.join("\n")}`
+        for (let attempt = 1; attempt <= 2; attempt++) {
+          try {
+            const res = await fetch(`https://generativelanguage.googleapis.com/v1beta/models/${model}:generateContent`, {
+              method: "POST",
+              headers: { "Content-Type": "application/json", "x-goog-api-key": apiKey },
+              body: JSON.stringify({
+                contents: [{ parts: [{ text: prompt }] }],
+                generationConfig: { responseMimeType: "application/json", thinkingConfig: { thinkingBudget: 0 } },
+              }),
+              signal: AbortSignal.timeout(60000),
+            })
+            if (!res.ok) throw new Error(`gemini api returned ${res.status}`)
+            const data = await res.json()
+            const text = data.candidates?.[0]?.content?.parts?.[0]?.text?.trim()
+            if (!text) throw new Error("empty summary response")
+            const parsed = JSON.parse(text)
+            if (typeof parsed.summary_en !== "string" || typeof parsed.summary_ger !== "string") {
+              throw new Error("unexpected summary response shape")
+            }
+            target.summary_en = parsed.summary_en.trim()
+            target.summary_ger = parsed.summary_ger.trim()
+            console.log(`ai summary generated for ${target.version}`)
+            break
+          } catch (err) {
+            if (attempt === 2) console.warn(`ai summary failed: ${err.message}`)
+          }
+        }
+      }
+    }
+  }
+}
+
 mkdirSync("data", { recursive: true })
 writeFileSync("data/changelog.json", JSON.stringify(grouped, null, 2))
 console.log(`changelog generated: ${grouped.length} versions`)