@devilsdev/rag-pipeline-utils 2.1.5 → 2.1.7

package/.github/workflows/auto-release-note.yml

@@ -0,0 +1,73 @@
+# .github/workflows/auto-release-note.yml
+# Version: 1.0.0
+# Description: Unified workflow to generate changelog + blog post from Git tag
+# Author: Ali Kahwaji
+
+name: ✫ Auto Release Note
+
+on:
+  push:
+    tags:
+      - 'v*'
+  workflow_dispatch:
+
+permissions:
+  contents: write
+
+jobs:
+  generate-note:
+    name: 🖍 Generate Blog + Changelog
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: ⬇️ Checkout code
+        uses: actions/checkout@v4
+
+      - name: 🔧 Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+
+      - name: 📦 Install dependencies
+        run: npm ci
+
+      - name: 📑 Generate release note from tag
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          VERSION=${GITHUB_REF#refs/tags/v}
+          echo "Generating blog + changelog for v$VERSION"
+
+          git fetch --tags --force
+
+          node scripts/generate-release-note.js v$VERSION
+
+      - name: 📄 Auto-commit blog + changelog
+        uses: stefanzweifel/git-auto-commit-action@v5
+        with:
+          commit_message: "docs(release): auto-publish blog and changelog"
+          file_pattern: "CHANGELOG.md docs-site/blog/*.md"
+          push_options: '--follow-tags'
+
+      - name: 🚀 Confirm complete
+        run: echo "Release blog + changelog committed and pushed."
+
+      - name: 📈 Emit Blog Badge Trigger
+        run: echo "::set-output name=blog::generated"
+
+      - name: 🌟 Trigger Badge (Optional)
+        if: always()
+        uses: peter-evans/create-or-update-comment@v4
+        with:
+          issue-number: 1
+          body: "Blog Post + Changelog updated for ${{ github.ref_name }} :rocket:"
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: 💬 Comment on PR (optional)
+        if: github.event.pull_request.number != ''
+        uses: peter-evans/create-or-update-comment@v4
+        with:
+            issue-number: ${{ github.event.pull_request.number }}
+            body: "📢 Blog + Changelog updated for ${{ github.ref_name }} 🎉"
+        

package/.github/workflows/ci.yml

@@ -1,5 +1,5 @@
 # .github/workflows/ci.yml
-# Version: 1.0.0
+# Version: 1.1.0
 # Description: Clean CI pipeline with lint, test, fixtures, coverage, and release
 # Author: Ali Kahwaji
 
@@ -8,6 +8,7 @@ name: CI & Release
 on:
   push:
     branches: [main]
+    tags: ['v*']
   pull_request:
     branches: [main]
 
@@ -30,7 +31,7 @@ jobs:
       - name: 📦 Install dependencies
         run: npm ci
 
-      - name: 🧹 Lint
+      - name: 🧹 Lint codebase
         run: npm run lint
 
       - name: ✅ Run tests with coverage
@@ -47,7 +48,8 @@ jobs:
 
       - name: 🚀 Semantic Release
         env:
-          GITHUB_TOKEN: ${{ secrets.GH_TOKEN }}
+          GH_TOKEN: ${{ secrets.GH_TOKEN }}            # ✅ Required by @semantic-release/github
+          GITHUB_TOKEN: ${{ secrets.GH_TOKEN }}        # ✅ Used by GitHub Actions
           NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
           NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
         run: npx semantic-release

package/.github/workflows/docs-ci.yml

@@ -1,9 +1,9 @@
 # .github/workflows/docs-ci.yml
-# Version: 1.1.0
-# Description: CI pipeline for linting, testing, and building docs
+# Version: 1.2.0
+# Description: CI pipeline for linting, testing, and building docs with improved caching and consistency
 # Author: Ali Kahwaji
 
-name: Docs CI
+name: 📘 Docs CI
 
 on:
   push:
@@ -12,19 +12,19 @@ on:
     branches: [main]
 
 jobs:
-  build:
+  docs-ci:
     runs-on: ubuntu-latest
 
     steps:
-      - name: ⬇️ Checkout repository
+      - name: ⬇️ Checkout code
         uses: actions/checkout@v4
 
       - name: 🟢 Setup Node.js
         uses: actions/setup-node@v4
         with:
-          node-version: '18'
+          node-version: 20
           cache: 'npm'
-          cache-dependency-path: 'package-lock.json'
+          cache-dependency-path: '**/package-lock.json'
 
       - name: 📦 Install dependencies
         run: npm ci
@@ -35,11 +35,11 @@ jobs:
       - name: 🛠 Build documentation
         run: npm run docs:build
 
-      - name: ✅ Run tests (optional)
+      - name: ✅ Run tests
         run: npm test
         if: ${{ always() }}
 
-      - name: 📦 Upload docs build (optional)
+      - name: 📦 Upload built docs (optional)
         uses: actions/upload-artifact@v4
         with:
           name: docusaurus-build

package/.github/workflows/docs-deploy.yml

@@ -1,6 +1,6 @@
 # .github/workflows/docs-deploy.yml
-# Version: 1.1.0
-# Description: Deploys Docusaurus docs site to GitHub Pages
+# Version: 1.2.0
+# Description: Deploys Docusaurus docs site to GitHub Pages with CNAME and post-release chaining
 # Author: Ali Kahwaji
 
 name: 📚 Deploy Docusaurus Docs
@@ -17,39 +17,48 @@ on:
       - 'package.json'
 
 permissions:
-  contents: write  # Required for GitHub Pages deployment
+  contents: write
 
 jobs:
   deploy:
-    name: Deploy to GitHub Pages
+    name: 🚀 Publish to GitHub Pages
     runs-on: ubuntu-latest
 
     steps:
-      - name: Checkout repository
+      - name: 📥 Checkout repository
         uses: actions/checkout@v4
+        with:
+          fetch-depth: 0  # ✅ Full git history for tag diff or changelog sync
 
-      - name: Setup Node.js
+      - name: 🧰 Setup Node.js
         uses: actions/setup-node@v4
         with:
-          node-version: '18'
+          node-version: 20
           cache: 'npm'
 
-      - name: Install dependencies
+      - name: 📦 Install dependencies
         run: npm ci
 
-      - name: Build docs
+      - name: 🛠 Git Identity
+        run: |
+          git config --global user.name "GitHub Actions"
+          git config --global user.email "github-actions@github.com"
+
+      - name: 🛠 Build docs
         run: npm run docs:build
 
-      - name: Configure Git user
+      - name: ✅ Auto-generate release blog + changelog (if not triggered by tag)
         run: |
-          git config --global user.name "GitHub Actions"
-          git config --global user.email "github-actions[bot]@users.noreply.github.com"
+          TAG=$(git describe --tags --abbrev=0)
+          node scripts/generate-release-note.js "$TAG" || echo "🔁 Skipped blog generation fallback"
+        if: success() && !startsWith(github.ref, 'refs/tags/')
 
-      - name: Deploy to GitHub Pages
+      - name: 🚀 Deploy to GitHub Pages
         uses: peaceiris/actions-gh-pages@v4
         with:
           github_token: ${{ secrets.GITHUB_TOKEN }}
           publish_dir: docs-site/build
           publish_branch: gh-pages
+          cname: docs.rag-utils.dev  # 🔧 CHANGE THIS if you use a custom domain
           user_name: github-actions[bot]
-          user_email: github-actions[bot]@users.noreply.github.com
+          user_email: 41898282+github-actions[bot]@users.noreply.github.com

package/.github/workflows/enforce-release-review.yml

@@ -1,33 +1,36 @@
 # .github/workflows/enforce-release-review.yml
-# Version: 1.0.1
-# Description: Prevents merge if changelog/blog updates not reviewed. Supports badge + manual trigger.
+# Version: 1.1.0
+# Description: Validates CHANGELOG.md and blog edits on PRs and tag pushes. Emits status badge.
 # Author: Ali Kahwaji
 
-name: 🛡 Release Review Enforcement
+name: 🛡 Release Review Passed
 
 on:
   pull_request:
     branches: [main]
-  workflow_dispatch:  # ✅ Manual trigger from Actions tab
+  push:
+    tags:
+      - 'v*.*.*'
+  workflow_dispatch:
 
 permissions:
   contents: read
   pull-requests: write
 
 jobs:
-  review-check:
-    name: Validate Changelog & Blog Updates
+  review:
+    name: 📝 Release Review Check
     runs-on: ubuntu-latest
 
     steps:
       - name: 📥 Checkout repo
         uses: actions/checkout@v4
 
-      - name: 🔍 Scan for changelog/blog edits
+      - name: 🔍 Scan for changelog or blog edits
         id: check
         run: |
           git fetch origin main --depth=1
-          CHANGED_FILES=$(git diff --name-only origin/main...HEAD)
+          CHANGED_FILES=$(git diff --name-only origin/main...HEAD || true)
 
           echo "Changed files:"
           echo "$CHANGED_FILES"
@@ -40,7 +43,7 @@ jobs:
             echo "result=fail" >> "$GITHUB_OUTPUT"
           fi
 
-      - name: 🚫 Fail if missing changelog or blog updates
+      - name: 🚫 Fail if missing changelog or blog
         if: steps.check.outputs.result == 'fail'
         run: |
           echo "Missing required changelog or blog post for release."

package/.github/workflows/generate-blog-post.yml

@@ -0,0 +1,44 @@
+# .github/workflows/generate-blog-post.yml
+# Version: 1.1.0
+# Description: Auto-generates blog posts from release tags using generate-release-note.js
+# Author: Ali Kahwaji
+
+name: "📝 Auto Generate Blog Post"
+
+on:
+  release:
+    types: [published]
+  push:
+    tags:
+      - 'v*.*.*'
+
+permissions:
+  contents: write
+
+jobs:
+  blog:
+    name: Generate Release Blog
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: ⬇️ Checkout code
+        uses: actions/checkout@v4
+
+      - name: 🛠 Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+
+      - name: 📦 Install dependencies
+        run: npm ci
+
+      - name: 📝 Generate blog post from tag
+        run: node scripts/generate-release-note.js ${{ github.ref_name }} <previous-tag>
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: 📋 Commit blog post
+        uses: stefanzweifel/git-auto-commit-action@v5
+        with:
+          commit_message: "docs(blog): auto-generate post for release ${{ github.ref_name }}"
+          file_pattern: "docs-site/blog/*.md"

package/.github/workflows/post-release-generate-blog.yml

@@ -0,0 +1,71 @@
+# .github/workflows/post-release-generate-blog.yml
+# Version: 2.5.2
+# Description: Auto-generates changelog + blog post from tag or GitHub release with dry-run safety and badge output
+# Author: Ali Kahwaji
+
+name: Auto Generate Blog + Changelog
+
+on:
+  release:
+    types: [published]
+  push:
+    tags:
+      - 'v*.*.*'
+  workflow_dispatch:
+    inputs:
+      dry_run:
+        description: 'Run generator in dry-run mode (no git push)'
+        required: false
+        default: 'false'
+
+permissions:
+  contents: write
+  issues: write
+  pull-requests: write
+
+jobs:
+  generate:
+    name: 📓 Generate Blog + Changelog
+    runs-on: ubuntu-latest
+    outputs:
+      blog_generated: ${{ steps.done.outputs.blog_generated }}
+
+    steps:
+      - name: 📥 Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: 🛠 Setup Git identity
+        run: |
+          git config --global user.name "GitHub Actions"
+          git config --global user.email "docs@autobot.local"
+
+      - name: 📦 Install dependencies
+        run: npm ci
+
+      - name: 🏷 Extract version and dry_run mode
+        id: context
+        run: |
+          TAG=${GITHUB_REF#refs/tags/}
+          echo "tag=${TAG}" >> $GITHUB_OUTPUT
+          echo "dry_run=${{ github.event.inputs.dry_run == 'true' && 'true' || 'false' }}" >> $GITHUB_OUTPUT
+
+      - name: 📝 Generate release note
+        id: note
+        run: |
+          echo "🚧 Running release note generator..."
+          node scripts/generate-release-note.js "${{ steps.context.outputs.tag }}"
+        env:
+          DRY_RUN: ${{ steps.context.outputs.dry_run }}
+
+      - name: 🔐 Commit blog & changelog
+        if: ${{ steps.context.outputs.dry_run != 'true' }}
+        uses: stefanzweifel/git-auto-commit-action@v5
+        with:
+          commit_message: "docs(release): blog + changelog for ${{ steps.context.outputs.tag }}"
+          file_pattern: "CHANGELOG.md docs-site/blog/*.md"
+
+      - name: ✅ Output badge result
+        id: done
+        run: echo "blog_generated=true" >> "$GITHUB_OUTPUT"

package/.github/workflows/verify-blog-badge.yml

@@ -0,0 +1,50 @@
+# .github/workflows/verify-blog-badge.yml
+# Version: 1.3.0
+# Description: Validates presence of blog generation badge + GitHub Action output
+# Author: Ali Kahwaji
+
+name: 🖍 Blog Badge Verification
+
+on:
+  workflow_dispatch:
+  workflow_run:
+    workflows: ["Auto Generate Blog + Changelog"]
+    types:
+      - completed
+
+jobs:
+  verify:
+    name: 🌟 Verify Blog Badge and Output
+    runs-on: ubuntu-latest
+    if: ${{ github.event.workflow_run.conclusion == 'success' }}
+
+    steps:
+      - name: ⬇️ Checkout repository
+        uses: actions/checkout@v4
+
+      - name: 🔍 Validate README badge reference
+        run: |
+          echo "Checking for badge reference in README.md..."
+          grep -q "post-release-generate-blog.yml/badge.svg" README.md || {
+            echo "❌ Missing badge for post-release-generate-blog.yml in README.md"
+            exit 1
+          }
+
+      - name: 🌐 Validate badge URL status
+        run: |
+          BADGE_URL="https://github.com/DevilsDev/rag-pipeline-utils/actions/workflows/post-release-generate-blog.yml/badge.svg?branch=main"
+          STATUS=$(curl -s -o /dev/null -w "%{http_code}" "$BADGE_URL")
+
+          echo "Badge response: $STATUS"
+          if [ "$STATUS" != "200" ]; then
+            echo "❌ Blog badge not reachable (HTTP $STATUS)"
+            exit 1
+          fi
+
+      - name: 🧾 Log assumed blog generation output (manual mapping)
+        run: |
+          echo "⚠️ Outputs from 'workflow_run' do not include job outputs."
+          echo "Assuming blog_generated=true based on successful workflow completion."
+
+      - name: ✅ Blog badge verified
+        run: echo "✅ Blog badge verified and present in README."

package/CHANGELOG.md

@@ -1,5 +1,28 @@
 # Changelog
 
+## [2.1.7](https://github.com/DevilsDev/rag-pipeline-utils/compare/v2.1.6...v2.1.7) (2025-04-25)
+
+
+### Bug Fixes
+
+* **ci:** patch blog release workflow with DRY_RUN and safer outputs ([18f1b7d](https://github.com/DevilsDev/rag-pipeline-utils/commit/18f1b7dd4019022d76de9097db1ff8cfd858d83e))
+
+<<<<<<< HEAD
+## 2.1.5 - 2025-04-22
+### Features
+- Synced roadmap labels + issues via CI
+- Added auto-close for Done roadmap entries
+
+### Fixes
+- ES module compatibility fixes for roadmap scripts
+- Improved test isolation and mocking for Octokit
+
+### DevOps
+- CI chain includes roadmap validation and label sync
+- CLI tools support changelog generation + blog linking
+
+
+=======
 ## [2.1.5](https://github.com/DevilsDev/rag-pipeline-utils/compare/v2.1.4...v2.1.5) (2025-04-22)
 
 
@@ -7,6 +30,7 @@
 
 * **scripts:** prevent null status crash in roadmap issue closer ([89d5a0b](https://github.com/DevilsDev/rag-pipeline-utils/commit/89d5a0bc4cac554975974558b97974297816f169))
 
+>>>>>>> 6475a97d362f7cd9779e1268f1c816764a7fd62c
 ## [2.1.4](https://github.com/DevilsDev/rag-pipeline-utils/compare/v2.1.3...v2.1.4) (2025-04-21)
 
 
@@ -95,3 +119,13 @@
 All notable changes to this project will be documented in this file.
 
 The format is based on [Semantic Versioning](https://semver.org/), and this project uses [semantic-release](https://github.com/semantic-release/semantic-release) for automated versioning and changelog generation.
+
+## v2.1.6
+
+- chore: remove legacy changelog workflow and finalize blog badge
+- ci(workflows): add blog badge verification workflow
+- ci(workflows): add blog badge verification workflow
+- ci(workflows): add blog badge verification workflow
+- docs(blog): add release post for v2.1.5
+
+---

package/README.md

@@ -11,6 +11,13 @@
 ![Release](https://img.shields.io/github/v/release/DevilsDev/rag-pipeline-utils?label=release)
 ![License](https://img.shields.io/github/license/devilsdev/rag-pipeline-utils)
 ![Release Review Passed](https://github.com/DevilsDev/rag-pipeline-utils/actions/workflows/enforce-release-review.yml/badge.svg?branch=main)
+[![Docs Deploy](https://github.com/DevilsDev/rag-pipeline-utils/actions/workflows/docs-deploy.yml/badge.svg)](https://github.com/DevilsDev/rag-pipeline-utils/actions/workflows/docs-deploy.yml)
+[![Docs CI](https://github.com/DevilsDev/rag-pipeline-utils/actions/workflows/docs-ci.yml/badge.svg)](https://github.com/DevilsDev/rag-pipeline-utils/actions/workflows/docs-ci.yml)
+[![Blog Generated](https://github.com/DevilsDev/rag-pipeline-utils/actions/workflows/post-release-generate-blog.yml/badge.svg?branch=main)](https://github.com/DevilsDev/rag-pipeline-utils/actions/workflows/post-release-generate-blog.yml)
+
+
+
+
 
 
 

package/docs-site/blog/2025-04-22-release-v2.1.5.md

@@ -0,0 +1,13 @@
+---
+slug: release-v2.1.5
+title: ✨ Version v2.1.5 Released
+authors: [ali]
+tags: [release, changelog]
+---
+
+RAG Pipeline Utils vv2.1.5 is now available on NPM!
+
+#### Highlights
+- 🚀 Auto-published blog from GitHub Release
+- 📦 Version bump: v2.1.5
+- 📘 See CHANGELOG.md for full details

package/docs-site/blog/2025-04-24-v2.1.6.md

@@ -0,0 +1,21 @@
+---
+slug: release-v2.1.6
+title: "🚀 Version v2.1.6 Released"
+authors: [ali]
+tags: [release, changelog]
+---
+
+RAG Pipeline Utils **v2.1.6** is now available on NPM!
+
+## 🔧 Changes
+
+- chore: remove legacy changelog workflow and finalize blog badge
+- ci(workflows): add blog badge verification workflow
+- ci(workflows): add blog badge verification workflow
+- ci(workflows): add blog badge verification workflow
+- docs(blog): add release post for v2.1.5
+
+## 🔗 Resources
+
+- GitHub Compare: [v2.1.5...v2.1.6](https://github.com/DevilsDev/rag-pipeline-utils/compare/v2.1.5...v2.1.6)
+- View full [CHANGELOG.md](../../CHANGELOG.md)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devilsdev/rag-pipeline-utils",
-  "version": "2.1.5",
+  "version": "2.1.7",
   "description": "A modular toolkit for building RAG (Retrieval-Augmented Generation) pipelines in Node.js",
   "main": "src/core/create-pipeline.js",
   "bin": {
@@ -28,9 +28,9 @@
     "docs:build": "docusaurus build docs-site",
     "docs:serve": "docusaurus serve docs-site",
     "docs:deploy": "docusaurus deploy docs-site",
-    "release:tag": "node scripts/tag-release.js",
     "roadmap:close": "node scripts/close-done-roadmap-issues.js",
-    "labels:sync": "node scripts/ensure-roadmap-labels.js"
+    "labels:sync": "node scripts/ensure-roadmap-labels.js",
+    "release:tag": "node scripts/generate-release-note.js v$(node -p \"require('./package.json').version\")"
   },
   "lint-staged": {
     "**/*.{js,ts}": [

package/scripts/generate-release-note.js

@@ -1,40 +1,110 @@
-// File: scripts/generate-release-note.js
+// scripts/generate-release-note.js
 /**
- * Version: 1.2.0
- * Description: Injects release metadata into markdown template
+ * Version: 2.3.0
+ * Description: Generate release blog + changelog section, auto-push to Git, fallback to safe defaults
  * Author: Ali Kahwaji
  */
 
-const fs = require('fs');
-const path = require('path');
-const { execSync } = require('child_process');
+import fs from 'fs';
+import path from 'path';
+import { execSync } from 'child_process';
+import { fileURLToPath } from 'url';
 
-const [,, version, previousTag] = process.argv;
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
 
-if (!version || !previousTag) {
-  console.error('Usage: node scripts/generate-release-note.js <version> <previousTag>');
+const [, , newVersionArg, previousVersionArg] = process.argv;
+
+if (!newVersionArg) {
+  console.error('❌ Usage: node scripts/generate-release-note.js <new-tag> <previous-tag?>');
+  process.exit(1);
+}
+
+const newVersion = newVersionArg.startsWith('v') ? newVersionArg : `v${newVersionArg}`;
+
+// 🔁 Fallback to previous git tag
+function resolvePreviousTag() {
+  try {
+    const tags = execSync('git tag --sort=-creatordate', { encoding: 'utf-8' })
+      .split('\n')
+      .filter(Boolean);
+    const idx = tags.indexOf(newVersion);
+    return tags[idx + 1] || tags[1] || null;
+  } catch {
+    return null;
+  }
+}
+
+const prevVersion = previousVersionArg || resolvePreviousTag();
+if (!prevVersion) {
+  console.error('❌ Could not resolve previous tag.');
   process.exit(1);
 }
 
-const templatePath = path.join(__dirname, '../.github/release-template.md');
-const outputPath = path.join(__dirname, `../docs-site/blog/${new Date().toISOString().split('T')[0]}-release-${version}.md`);
+// 📦 Get commits between versions
+function getCommits(from, to) {
+  try {
+    return execSync(`git log ${from}..${to} --pretty=format:"- %s"`, { encoding: 'utf-8' });
+  } catch (err) {
+    console.error('❌ Failed to fetch commits:', err.message);
+    process.exit(1);
+  }
+}
+
+function generateChangelogSection(commits) {
+  return `## ${newVersion}\n\n${commits}\n\n---\n`;
+}
 
-const template = fs.readFileSync(templatePath, 'utf-8');
+function generateBlogMarkdown(version, commits) {
+  const date = new Date().toISOString().slice(0, 10);
+  const slug = `release-${version}`;
+  return `---
+slug: ${slug}
+title: "🚀 Version ${version} Released"
+authors: [ali]
+tags: [release, changelog]
+---
 
-// Count contributors
-const contributors = execSync(`git shortlog -sne ${previousTag}..HEAD | wc -l`).toString().trim();
-// Count commits
-const commits = execSync(`git rev-list --count ${previousTag}..HEAD`).toString().trim();
-// ISO date
-const date = new Date().toISOString().split('T')[0];
+RAG Pipeline Utils **${version}** is now available on NPM!
 
-// Inject into template
-const filled = template
-  .replace(/{{VERSION}}/g, version)
-  .replace(/{{PREVIOUS_TAG}}/g, previousTag)
-  .replace(/{{DATE}}/g, date)
-  .replace(/{{CONTRIBUTORS}}/g, contributors)
-  .replace(/{{COMMITS}}/g, commits);
+## 🔧 Changes
+
+${commits}
+
+## 🔗 Resources
+
+- GitHub Compare: [${prevVersion}...${version}](https://github.com/DevilsDev/rag-pipeline-utils/compare/${prevVersion}...${version})
+- View full [CHANGELOG on GitHub](https://github.com/DevilsDev/rag-pipeline-utils/blob/main/CHANGELOG.md)
+`;
+}
+
+const commits = getCommits(prevVersion, newVersion);
+const blogContent = generateBlogMarkdown(newVersion, commits);
+const changelogSection = generateChangelogSection(commits);
+
+// 📍 Paths
+const today = new Date().toISOString().slice(0, 10);
+const blogPath = path.join(__dirname, `../docs-site/blog/${today}-${newVersion}.md`);
+const changelogPath = path.join(__dirname, '../CHANGELOG.md');
+
+// 📝 Write blog + changelog
+fs.writeFileSync(blogPath, blogContent, 'utf-8');
+fs.appendFileSync(changelogPath, `\n${changelogSection}`, 'utf-8');
+
+// 🔐 Commit and push
+try {
+  execSync('git config user.name "github-actions[bot]"');
+  execSync('git config user.email "41898282+github-actions[bot]@users.noreply.github.com"');
+  execSync('git add CHANGELOG.md docs-site/blog/*.md');
+  execSync(`git commit -m "docs(release): publish changelog and blog for ${newVersion}"`);
+  execSync('git push origin main');
+  console.log(`✅ Blog + changelog committed for ${newVersion}`);
+} catch (err) {
+  console.warn('⚠️ Git commit skipped (already committed or no changes).');
+}
 
-fs.writeFileSync(outputPath, filled);
-console.log(`✅ Generated release blog: ${outputPath}`);
+// 📦 Local preview
+console.log('\n📘 Blog Preview:\n');
+console.log(blogContent);
+console.log('\n📘 Changelog Section:\n');
+console.log(changelogSection);

package/scripts/get-previous-tag.js

@@ -0,0 +1,40 @@
+/**
+ * Version: 1.0.0
+ * Description: Helper to find the previous Git semver tag before a given tag
+ * Usage: node scripts/get-previous-tag.js v2.1.5
+ * Output: v2.1.4
+ * Author: Ali Kahwaji
+ */
+
+import { execSync } from 'child_process';
+
+const currentTag = process.argv[2];
+
+if (!currentTag) {
+  console.error('❌ Usage: node get-previous-tag.js <current-tag>');
+  process.exit(1);
+}
+
+try {
+  // Ensure full tag history
+  execSync('git fetch --tags --unshallow 2>/dev/null || git fetch --tags', { stdio: 'inherit' });
+
+  // List all tags sorted by version (most recent last), remove current tag
+  const tags = execSync('git tag --sort=version:refname', { encoding: 'utf-8' })
+    .split('\n')
+    .map(tag => tag.trim())
+    .filter(Boolean);
+
+  const idx = tags.indexOf(currentTag);
+
+  if (idx <= 0) {
+    console.error('⚠️ Could not find previous tag before', currentTag);
+    process.exit(1);
+  }
+
+  const previousTag = tags[idx - 1];
+  console.log(previousTag);
+} catch (err) {
+  console.error('❌ Failed to resolve previous tag:', err.message);
+  process.exit(1);
+}

package/.github/workflows/changelog-auto-commit.yml

@@ -1,37 +0,0 @@
-# Version: 1.0.0
-# Description: Auto-commits CHANGELOG updates generated by tag-release CLI
-# Author: Ali Kahwaji
-
-name: 📘 Sync Changelog from CLI Tags
-
-on:
-  push:
-    tags:
-      - 'v*'
-
-jobs:
-  commit-changelog:
-    runs-on: ubuntu-latest
-    steps:
-      - name: ⬇️ Checkout repo
-        uses: actions/checkout@v4
-
-      - name: 🧰 Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: 20
-
-      - name: 📦 Install
-        run: npm ci
-
-      - name: 📝 Append Changelog Entry
-        run: |
-          VERSION=${GITHUB_REF#refs/tags/v}
-          node scripts/tag-release.js $VERSION
-          cat scripts/.cache/v$VERSION.log >> CHANGELOG.md
-
-      - name: 🔐 Commit changelog
-        uses: stefanzweifel/git-auto-commit-action@v5
-        with:
-          commit_message: "docs(changelog): update for v${{ github.ref_name }}"
-          file_pattern: "CHANGELOG.md"