@devilsdev/rag-pipeline-utils 1.0.0 → 2.0.0

package/.codecov.yml

@@ -0,0 +1,21 @@
+# .codecov.yml
+
+codecov:
+  notify:
+    after_n_builds: 1
+
+coverage:
+  status:
+    project:
+      default:
+        target: 90%
+        threshold: 5%
+    patch:
+      default:
+        target: 90%
+        threshold: 5%
+
+comment:
+  layout: "reach, diff, flags, files"
+  behavior: default
+  require_changes: false

package/.dockerignore

@@ -1,14 +1,14 @@
-# Ignore test files, fixtures, and local config
-__tests__/
-coverage/
-.env
-.env.*
-node_modules/
-.dockerignore
-.git
-.gitignore
-.vscode
-*.log
-*.md
-/public/
-/docs-site/
+# Ignore test files, fixtures, and local config
+__tests__/
+coverage/
+.env
+.env.*
+node_modules/
+.dockerignore
+.git
+.gitignore
+.vscode
+*.log
+*.md
+/public/
+/docs-site/

package/.eslintignore

@@ -0,0 +1,5 @@
+node_modules
+docs-site
+public
+dist
+coverage

package/.eslintrc.json

@@ -0,0 +1,21 @@
+{
+    "env": {
+      "es2022": true,
+      "node": true,
+      "jest": true
+    },
+    "extends": [
+      "eslint:recommended"
+    ],
+    "parserOptions": {
+      "ecmaVersion": "latest",
+      "sourceType": "module"
+    },
+    "rules": {
+      "no-unused-vars": "warn",
+      "no-console": "off",
+      "semi": ["error", "always"],
+      "quotes": ["error", "single"]
+    }
+  }
+  

package/.github/workflows/ci.yml

@@ -1,42 +1,64 @@
-# .github/workflows/ci.yml
-# Version: 0.1.0
-# Description: GitHub Actions CI pipeline for lint, test, and coverage
-# Author: Ali Kahwaji
-
-name: CI
-
-on:
-  push:
-    branches: [main]
-  pull_request:
-    branches: [main]
-
-jobs:
-  build:
-    runs-on: ubuntu-latest
-
-    steps:
-      - name: 🧾 Checkout repository
-        uses: actions/checkout@v3
-
-      - name: 🟢 Setup Node.js
-        uses: actions/setup-node@v3
-        with:
-          node-version: 18
-
-      - name: 📦 Install dependencies
-        run: npm ci
-
-      - name: 🧹 Lint code
-        run: npm run lint
-
-      - name: 🧪 Run tests
-        run: npm test
-
-      - name: 📈 Upload coverage to Codecov
-        uses: codecov/codecov-action@v3
-        with:
-          token: ${{ secrets.CODECOV_TOKEN }}
-          files: ./coverage/lcov.info
-          flags: unit
-          name: codecov-report
+# .github/workflows/ci.yml
+# Version: 0.1.0
+# Description: GitHub Actions CI pipeline for lint, test, and coverage
+# Author: Ali Kahwaji
+
+name: CI & Release
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+    branches:
+      - main
+
+jobs:
+  build-test-release:
+    name: Lint, Test, and Release
+    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
+          cache: 'npm'
+          registry-url: 'https://registry.npmjs.org/'
+
+      - name: 📦 Install dependencies
+        run: npm ci
+
+      - name: 🧹 Lint
+        run: npm run lint
+
+      - name: ✅ Run tests with coverage
+        run: npm test
+
+      - name: 🚀 Semantic Release
+        env:
+          GITHUB_TOKEN: ${{ secrets.GH_TOKEN }}
+          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }} # 👈 critical for npm publi
+        run: npx semantic-release
+
+      - name: 🧪 Run Tests with Coverage
+        run: npm test
+
+      - name: Validate Fixtures
+        run: npm run validate-fixtures
+      
+      - name: Lint code
+        run: npm run lint
+      
+      
+      - name: 📊 Upload coverage to Codecov
+        uses: codecov/codecov-action@v5
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+          slug: DevilsDev/rag-pipeline-utils
+
+      

package/.husky/pre-commit

@@ -0,0 +1,5 @@
+#!/usr/bin/env sh
+. "$(dirname -- "$0")/_/husky.sh"
+
+npm run validate-fixtures && npm run lint
+npx lint-staged

package/CHANGELOG.md

@@ -0,0 +1,46 @@
+# Changelog
+
+# [2.0.0](https://github.com/DevilsDev/rag-pipeline-utils/compare/v1.0.1...v2.0.0) (2025-04-17)
+
+
+### Bug Fixes
+
+* **ci:** correct .ragrc.json plugin paths and CLI test cwd to resolve plugin loading in CI ([911c23b](https://github.com/DevilsDev/rag-pipeline-utils/commit/911c23b1d3ddb9e2d938b37f4422a5d81995e97f))
+* **ci:** resolve plugin path error in .ragrc.json for GitHub Actions compatibility ([affc739](https://github.com/DevilsDev/rag-pipeline-utils/commit/affc739d5c4ff2070b1a1ca0ccf3f9137d6cee5a))
+* **ci:** resolve plugin path failures in .ragrc.json during CLI integration tests ([04b977b](https://github.com/DevilsDev/rag-pipeline-utils/commit/04b977b3b745fa3d3ab47c84b2aeee3285896068))
+* **cli:** correct path to load-plugin-config.js after moving to /src/config ([f743498](https://github.com/DevilsDev/rag-pipeline-utils/commit/f743498ec32e03151eda9ba7fe5886bda8da792f))
+* **config:** use default export when importing plugin registry ([ef8dce1](https://github.com/DevilsDev/rag-pipeline-utils/commit/ef8dce12bfab62bc9faec764198b98c0c356472e))
+* **test:** ensure .ragrc.json copied to project root for CLI fallback in CI ([31bd2b8](https://github.com/DevilsDev/rag-pipeline-utils/commit/31bd2b844279fb0404056d9929e5f28f9127eb12))
+* **tests:** define __dirname manually for ESM compatibility in CLI integration test ([18b8dad](https://github.com/DevilsDev/rag-pipeline-utils/commit/18b8dadabb852243dda2b78de048c71106a759fc))
+
+
+### Features
+
+* **ci:** integrate full fixture validation, schema contracts, and CLI test flow ([2b57fe9](https://github.com/DevilsDev/rag-pipeline-utils/commit/2b57fe90e64a806815c1f66f5e2a745780270ce6))
+* **cli:** dynamic plugin registration with config fallback and middleware injection ([cc24b7e](https://github.com/DevilsDev/rag-pipeline-utils/commit/cc24b7e74d0a2630eb1c6d2def69b370329dcc2b))
+* **plugins:** enable dynamic plugin registration from JSON config ([d81d6d7](https://github.com/DevilsDev/rag-pipeline-utils/commit/d81d6d7d5f2d21b5a46b379b530c162ba9c30398))
+* **testing:** integrate full fixture and validation setup for CLI + reranker ([ab96037](https://github.com/DevilsDev/rag-pipeline-utils/commit/ab9603765594e7718e2688b80797e1f5e8afe86f))
+
+
+### BREAKING CHANGES
+
+* **cli:**  now requires named options for middleware injection; existing usage must be updated.
+
+## [1.0.2] - 2025-04-15
+### Fixed
+- Corrected plugin path resolution in `.ragrc.json` fixture for CI compatibility.
+- Resolved `ERR_MODULE_NOT_FOUND` during CLI integration tests in GitHub Actions.
+- Ensured consistent module resolution across environments (Windows, Linux, CI).
+
+
+## [1.0.1](https://github.com/DevilsDev/rag-pipeline-utils/compare/v1.0.0...v1.0.1) (2025-04-14)
+
+
+### Bug Fixes
+
+* **ci:** initialize release pipeline and scaffold changelog ([179b486](https://github.com/DevilsDev/rag-pipeline-utils/commit/179b486effb0751b8735a9f849825eb63930ad01))
+* **tests:** add missing sample PDF fixture and pre-test setup script ([de8e2b2](https://github.com/DevilsDev/rag-pipeline-utils/commit/de8e2b2c19034b521fc5ae1cdebbe3884a2fd15f))
+
+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.

package/Dockerfile

@@ -1,22 +1,22 @@
-# Version: 0.1.0
-# Path: /Dockerfile
-# Description: Minimal Docker image for rag-pipeline CLI
-# Author: Ali Kahwaji
-
-FROM node:18-slim
-
-# Create app directory
-WORKDIR /app
-
-# Copy package files and install deps
-COPY package*.json ./
-RUN npm ci --omit=dev
-
-# Copy application source
-COPY . .
-
-# Set default entrypoint
-ENTRYPOINT ["node", "./bin/cli.js"]
-
-# Default help
-CMD ["--help"]
+# Version: 0.1.0
+# Path: /Dockerfile
+# Description: Minimal Docker image for rag-pipeline CLI
+# Author: Ali Kahwaji
+
+FROM node:18-slim
+
+# Create app directory
+WORKDIR /app
+
+# Copy package files and install deps
+COPY package*.json ./
+RUN npm ci --omit=dev
+
+# Copy application source
+COPY . .
+
+# Set default entrypoint
+ENTRYPOINT ["node", "./bin/cli.js"]
+
+# Default help
+CMD ["--help"]