@devilsdev/rag-pipeline-utils 2.1.4 → 2.1.7

package/.github/workflows/roadmap-sync.yml

@@ -0,0 +1,44 @@
+name: 🚀 Roadmap Sync (Labels + Issues)
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - '.github/roadmap-labels.yml'
+      - '.github/PROJECT_ROADMAP.md'
+      - 'scripts/create-roadmap-issues.js'
+      - 'scripts/ensure-roadmap-labels.js'
+
+  workflow_dispatch:
+
+permissions:
+  issues: write
+  contents: read
+
+jobs:
+  roadmap-sync:
+    name: 🔁 Sync Labels + Issues from Roadmap
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: 📥 Checkout repository
+        uses: actions/checkout@v4
+
+      - name: 🛠 Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: 'npm'
+
+      - name: 📦 Install dependencies
+        run: npm ci
+
+      - name: 🔖 Sync GitHub labels from roadmap-labels.yml
+        run: node scripts/ensure-roadmap-labels.js
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: 📝 Create or update roadmap issues
+        run: node scripts/create-roadmap-issues.js
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

package/.github/workflows/sync-roadmap.yml

@@ -0,0 +1,62 @@
+# .github/workflows/sync-roadmap.yml
+# Version: 2.1.0
+# Description: Unified workflow to sync roadmap issues, labels, and states
+# Author: Ali Kahwaji
+
+name: 🚀 Sync Roadmap to GitHub Issues
+
+on:
+  workflow_dispatch:
+  push:
+    branches: [main]
+    paths:
+      - '.github/PROJECT_ROADMAP.md'
+      - '.github/workflows/sync-roadmap.yml'
+      - 'scripts/**.js'
+
+permissions:
+  contents: write
+  issues: write
+
+jobs:
+  sync:
+    name: 📌 Roadmap Sync
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: ⬇️ Checkout
+        uses: actions/checkout@v4
+
+      - name: 🛠 Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+
+      - name: 📦 Install roadmap dependencies
+        run: npm install
+        env:
+          NODE_ENV: development
+
+      - name: 🔖 Ensure roadmap labels exist
+        run: node scripts/ensure-roadmap-labels.js
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          GITHUB_REPO: ${{ github.repository }}
+
+      - name: 🗂 Sync roadmap issues
+        run: node scripts/create-roadmap-issues.js
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          GITHUB_REPO: ${{ github.repository }}
+
+      - name: 🏷 Apply labels to roadmap issues
+        run: node scripts/label-roadmap-issues.js
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          GITHUB_REPO: ${{ github.repository }}
+
+      - name: ✅ Close completed issues
+        run: node scripts/close-done-roadmap-issues.js
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          GITHUB_REPO: ${{ github.repository }}

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,36 @@
 # 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)
+
+
+### Bug Fixes
+
+* **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)
 
 
@@ -88,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

@@ -10,6 +10,16 @@
 [![codecov](https://codecov.io/gh/DevilsDev/rag-pipeline-utils/branch/main/graph/badge.svg)](https://codecov.io/gh/DevilsDev/rag-pipeline-utils)
 ![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)
+
+
+
+
+
+
 
 ## Description
 
@@ -136,6 +146,36 @@ We welcome contributions via PRs, especially new mock providers, validation help
 
 
 
+## Contributors Guide
+
+For active maintainers and collaborators:
+
+- **Roadmap & Feature Planning**  
+  See [.github/PROJECT_ROADMAP.md](.github/PROJECT_ROADMAP.md) for the implementation phases, priorities, and tracking tags for all major developer-facing features.
+
+- **Milestone Tags**
+  | Tag         | Description                        |
+  |-------------|------------------------------------|
+  | `phase-1`   | Foundation – testing, CI, tutorials |
+  | `phase-2`   | Community, blog, discussions       |
+  | `phase-3`   | CLI, VS Code tools, theming        |
+  | `phase-4`   | i18n, integrations, case studies   |
+
+_Note: This file is not included in public documentation builds._
+
+
+## Manual Test Checklist
+
+For full validation of roadmap sync, changelog automation, CI/CD, and blog generation:
+
+➡️ [View Manual Test Checklist](scripts/manual-test-checklist.md)
+
+## Manual CI Rollout
+
+git commit --allow-empty -m "ci(test): trigger all CI workflows"
+git push origin main
+
+
 ## License
 
 This project is licensed under the **GNU GPL v3.0** License - see the [LICENSE](./LICENSE) file for details.

package/__tests__/scripts/ensure-roadmap-labels.test.js

@@ -0,0 +1,64 @@
+/**
+ * Version: 2.1.2
+ * Path: __tests__/scripts/ensure-roadmap-labels.test.js
+ * Description: Unit tests for roadmap label creation using ESM-compatible Jest syntax.
+ * Author: Ali Kahwaji
+ */
+
+import { jest } from '@jest/globals';
+
+jest.unstable_mockModule('octokit', () => ({
+  Octokit: jest.fn().mockImplementation(() => ({
+    rest: {
+      issues: {
+        listLabelsForRepo: mockListLabelsForRepo,
+        createLabel: mockCreateLabel
+      }
+    }
+  }))
+}));
+
+// ✅ Shared mocks outside import context
+const mockCreateLabel = jest.fn();
+const mockListLabelsForRepo = jest.fn();
+
+let ensureRoadmapLabels;
+let roadmapLabels;
+
+beforeAll(async () => {
+  const imported = await import('../../scripts/ensure-roadmap-labels.js');
+  ensureRoadmapLabels = imported.ensureRoadmapLabels;
+  roadmapLabels = imported.roadmapLabels;
+});
+
+beforeEach(() => {
+  mockCreateLabel.mockReset();
+  mockListLabelsForRepo.mockReset();
+});
+
+describe('ensureRoadmapLabels', () => {
+  it('creates all labels if none exist', async () => {
+    mockListLabelsForRepo.mockResolvedValue({ data: [] });
+
+    await ensureRoadmapLabels({ token: 'test-token', owner: 'ali', repo: 'rag-pipeline-utils' });
+
+    expect(mockCreateLabel).toHaveBeenCalledTimes(roadmapLabels.length);
+    for (const label of roadmapLabels) {
+      expect(mockCreateLabel).toHaveBeenCalledWith({
+        owner: 'ali',
+        repo: 'rag-pipeline-utils',
+        ...label
+      });
+    }
+  });
+
+  it('skips already existing labels', async () => {
+    const existing = [{ name: 'priority: high' }, { name: 'group: docs' }];
+    mockListLabelsForRepo.mockResolvedValue({ data: existing });
+
+    await ensureRoadmapLabels({ token: 'test-token', owner: 'ali', repo: 'rag-pipeline-utils' });
+
+    const expected = roadmapLabels.filter(l => !existing.some(e => e.name === l.name));
+    expect(mockCreateLabel).toHaveBeenCalledTimes(expected.length);
+  });
+});

package/docs-site/blog/2025-04-21-release-v2.1.4.md

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

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/docs-site/package.json

@@ -11,7 +11,10 @@
     "clear": "docusaurus clear",
     "serve": "docusaurus serve",
     "write-translations": "docusaurus write-translations",
-    "write-heading-ids": "docusaurus write-heading-ids"
+    "write-heading-ids": "docusaurus write-heading-ids",
+    "lint": "echo 'Lint skipped for docs-site'",
+    "test": "echo 'No tests in docs-site. Run from root.'",
+    "docs:build": "npm run --workspace ../ docs:build"
   },
   "dependencies": {
     "@docusaurus/core": "3.7.0",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devilsdev/rag-pipeline-utils",
-  "version": "2.1.4",
+  "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": {
@@ -27,7 +27,10 @@
     "docs:start": "docusaurus start docs-site",
     "docs:build": "docusaurus build docs-site",
     "docs:serve": "docusaurus serve docs-site",
-    "docs:deploy": "docusaurus deploy docs-site"
+    "docs:deploy": "docusaurus deploy docs-site",
+    "roadmap:close": "node scripts/close-done-roadmap-issues.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}": [
@@ -68,14 +71,6 @@
     "@semantic-release/github": "^9.2.6",
     "@semantic-release/npm": "^11.0.3",
     "@semantic-release/release-notes-generator": "^14.0.3",
-    "@storybook/addon-essentials": "^8.6.12",
-    "@storybook/addon-interactions": "^8.6.12",
-    "@storybook/addon-onboarding": "^8.6.12",
-    "@storybook/addon-webpack5-compiler-swc": "^3.0.0",
-    "@storybook/blocks": "^8.6.12",
-    "@storybook/react": "^8.6.12",
-    "@storybook/react-webpack5": "^8.6.12",
-    "@storybook/test": "^8.6.12",
     "@types/jest": "^29.5.14",
     "babel-jest": "^29.7.0",
     "codecov": "^3.8.2",
@@ -92,10 +87,10 @@
     "prop-types": "^15.8.1",
     "rimraf": "^6.0.1",
     "semantic-release": "^21.1.2",
-    "storybook": "^8.6.12",
     "ts-jest": "^29.3.2"
   },
   "dependencies": {
+    "@octokit/rest": "^21.1.1",
     "ajv": "^8.17.1",
     "axios": "^1.8.4",
     "chalk": "^5.4.1",
@@ -105,6 +100,7 @@
     "fast-glob": "^3.3.3",
     "framer-motion": "^12.7.4",
     "jsdom": "^26.1.0",
+    "octokit": "^4.1.3",
     "openai": "^4.93.0",
     "pino": "^9.6.0",
     "plaiceholder": "^3.0.0",

package/scripts/banner-injector.js

@@ -1,89 +1,102 @@
 /**
- * File: scripts/banner-injector.js
- * Description: Script to programmatically inject file-level banners into specified project files
- * Author: Ali Kahwaji
  * Version: 1.0.0
+ * Description: Syncs roadmap items from a structured Markdown file into GitHub Issues with labels and assignees.
+ * Author: Ali Kahwaji
  */
 
 import fs from 'fs';
 import path from 'path';
-import glob from 'glob';
+import { Octokit } from 'octokit';
+import dotenv from 'dotenv';
 
-const banners = {
-  '__tests__/unit/reranker/llm-reranker.test.js': `/**
- * File: __tests__/unit/reranker/llm-reranker.test.js
- * Description: Unit and integration tests with mocks for RAG pipeline
- * Author: Ali Kahwaji
- * Version: 1.0.4
- */\n\n`,
+dotenv.config();
 
-  '__tests__/unit/reranker/reranker.snapshot.test.js': `/**
- * File: __tests__/unit/reranker/reranker.snapshot.test.js
- * Description: Snapshot tests for LLM reranker
- * Author: Ali Kahwaji
- * Version: 1.0.4
- */\n\n`,
+/**
+ * GitHub Personal Access Token required via .env or CI secrets
+ * Ensure the token has 'repo' scope for private issue creation.
+ */
+const GITHUB_TOKEN = process.env.GITHUB_TOKEN;
+const GITHUB_REPO = process.env.GITHUB_REPO; // e.g. DevilsDev/rag-pipeline-utils
+const ROADMAP_PATH = path.resolve('.github/PROJECT_ROADMAP.md');
 
-  '__tests__/unit/core/plugin-registry.test.js': `/**
- * File: __tests__/unit/core/plugin-registry.test.js
- * Description: Unit and integration tests with mocks for RAG pipeline
- * Author: Ali Kahwaji
- * Version: 1.0.4
- */\n\n`,
+if (!GITHUB_TOKEN || !GITHUB_REPO) {
+  console.error('❌ GITHUB_TOKEN and GITHUB_REPO must be defined in environment.');
+  process.exit(1);
+}
 
-  '__tests__/integration/config/load-config.test.js': `/**
- * File: __tests__/integration/config/load-config.test.js
- * Description: Unit and integration tests with mocks for RAG pipeline
- * Author: Ali Kahwaji
- * Version: 1.0.4
- */\n\n`,
+const octokit = new Octokit({ auth: GITHUB_TOKEN });
 
-  '__tests__/integration/cli/config-flow.test.js': `/**
- * File: __tests__/integration/cli/config-flow.test.js
- * Description: Unit and integration tests with mocks for RAG pipeline
- * Author: Ali Kahwaji
- * Version: 1.0.4
- */\n\n`,
+/**
+ * Parse roadmap Markdown file into structured issue definitions
+ */
+function parseRoadmapMarkdown(markdown) {
+  const lines = markdown.split('\n');
+  const issues = [];
 
-  'src/mocks/pdf-loader.js': `/**
- * File: src/mocks/pdf-loader.js
- * Description: Unit and integration tests with mocks for RAG pipeline
- * Author: Ali Kahwaji
- * Version: 1.0.4
- */\n\n`,
+  for (const line of lines) {
+    if (line.startsWith('|')) {
+      const cells = line.split('|').map(c => c.trim());
 
-  'src/mocks/openai-embedder.js': `/**
- * File: src/mocks/openai-embedder.js
- * Description: Unit and integration tests with mocks for RAG pipeline
- * Author: Ali Kahwaji
- * Version: 1.0.4
- */\n\n`,
+      if (cells.length < 6 || cells[0] === 'Phase') continue;
 
-  'src/mocks/pinecone-retriever.js': `/**
- * File: src/mocks/pinecone-retriever.js
- * Description: Unit and integration tests with mocks for RAG pipeline
- * Author: Ali Kahwaji
- * Version: 1.0.4
- */\n\n`
-};
-
-Object.entries(banners).forEach(([filePath, banner]) => {
-  const resolvedPath = path.resolve(filePath);
+      const [, phase, priority, feature, group, tags] = cells;
 
-  if (!fs.existsSync(resolvedPath)) {
-    console.warn(`[SKIPPED] ${filePath} does not exist.`);
-    return;
+      issues.push({
+        title: `${phase.trim()}: ${feature.trim()}`,
+        body: `**Feature Group:** ${group}\n**Priority:** ${priority}`,
+        labels: [phase, priority, ...tags.split(',').map(tag => tag.trim())].filter(Boolean),
+      });
+    }
   }
 
-  const originalContent = fs.readFileSync(resolvedPath, 'utf-8');
+  return issues;
+}
+
+/**
+ * Create an issue in GitHub if it doesn't already exist
+ */
+async function createOrUpdateIssues(issues) {
+  const [owner, repo] = GITHUB_REPO.split('/');
+
+  const { data: existingIssues } = await octokit.rest.issues.listForRepo({
+    owner,
+    repo,
+    state: 'all',
+    per_page: 100,
+  });
 
-  // Skip if banner already present
-  if (originalContent.startsWith('/**')) {
-    console.log(`[SKIPPED] ${filePath} already contains a banner.`);
-    return;
+  for (const issue of issues) {
+    const exists = existingIssues.find(i => i.title === issue.title);
+    if (exists) {
+      console.log(`✅ Skipped (exists): ${issue.title}`);
+      continue;
+    }
+
+    await octokit.rest.issues.create({
+      owner,
+      repo,
+      title: issue.title,
+      body: issue.body,
+      labels: issue.labels,
+    });
+
+    console.log(`➕ Created: ${issue.title}`);
+  }
+}
+
+/**
+ * Entrypoint
+ */
+async function main() {
+  try {
+    const roadmap = fs.readFileSync(ROADMAP_PATH, 'utf-8');
+    const issues = parseRoadmapMarkdown(roadmap);
+    await createOrUpdateIssues(issues);
+    console.log(`🎯 Synced ${issues.length} roadmap issues.`);
+  } catch (err) {
+    console.error('🚨 Roadmap sync failed:', err.message);
+    process.exit(1);
   }
+}
 
-  const newContent = banner + originalContent;
-  fs.writeFileSync(resolvedPath, newContent, 'utf-8');
-  console.log(`[INJECTED] Banner added to ${filePath}`);
-});
+main();

package/scripts/close-done-roadmap-issues.js

@@ -0,0 +1,65 @@
+/**
+ * Version: 1.1.0
+ * Description: Closes GitHub issues marked as ✅ Done in the PROJECT_ROADMAP.md
+ * Author: Ali Kahwaji
+ */
+
+import fs from 'fs';
+import { Octokit } from 'octokit';
+
+const GITHUB_TOKEN = process.env.GITHUB_TOKEN;
+const OWNER = 'DevilsDev';
+const REPO = 'rag-pipeline-utils';
+const ROADMAP_PATH = '.github/PROJECT_ROADMAP.md';
+
+const octokit = new Octokit({ auth: GITHUB_TOKEN });
+
+async function closeDoneIssues() {
+  const content = fs.readFileSync(ROADMAP_PATH, 'utf-8');
+  const lines = content.split('\n').filter(line => line.startsWith('|'));
+  if (lines.length < 3) {
+    console.log('⚠️ No roadmap rows found to evaluate.');
+    return;
+  }
+
+  const rows = lines.slice(2); // Skip header and separator
+
+  const { data: issues } = await octokit.rest.issues.listForRepo({
+    owner: OWNER,
+    repo: REPO,
+    state: 'open',
+    per_page: 100
+  });
+
+  for (const row of rows) {
+    const cols = row.split('|').map(col => col.trim());
+    const [, , , title, , status] = cols;
+
+    const safeStatus = status?.toLowerCase?.();
+    if (!safeStatus || !safeStatus.includes('✅')) continue;
+
+    const match = issues.find(issue => issue.title.trim() === title.trim());
+    if (!match) continue;
+
+    await octokit.rest.issues.createComment({
+      owner: OWNER,
+      repo: REPO,
+      issue_number: match.number,
+      body: '✅ Automatically closed from roadmap sync.'
+    });
+
+    await octokit.rest.issues.update({
+      owner: OWNER,
+      repo: REPO,
+      issue_number: match.number,
+      state: 'closed'
+    });
+
+    console.log(`🔒 Closed: #${match.number} "${title}"`);
+  }
+}
+
+closeDoneIssues().catch(error => {
+  console.error('❌ Error closing roadmap issues:', error);
+  process.exit(1);
+});