@devilsdev/rag-pipeline-utils 2.1.5 → 2.1.8

package/CHANGELOG.md

@@ -1,97 +0,0 @@
-# Changelog
-
-## [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))
-
-## [2.1.4](https://github.com/DevilsDev/rag-pipeline-utils/compare/v2.1.3...v2.1.4) (2025-04-21)
-
-
-### Bug Fixes
-
-* update CI and deployment workflows for docs build and GitHub Pages deployment ([11739ba](https://github.com/DevilsDev/rag-pipeline-utils/commit/11739ba222669e359232807e461bc84d68d913cb))
-* update CI and deployment workflows for docs build and GitHub Pages deployment ([8de276f](https://github.com/DevilsDev/rag-pipeline-utils/commit/8de276f8cb6c91a291322783dc944b0f4799974f))
-
-## [2.1.3](https://github.com/DevilsDev/rag-pipeline-utils/compare/v2.1.2...v2.1.3) (2025-04-21)
-
-
-### Bug Fixes
-
-* Refactor CI workflows for better separation of concerns ([ef2954b](https://github.com/DevilsDev/rag-pipeline-utils/commit/ef2954b9161a73367cafa04d29f2e56164e4b1c0))
-
-## [2.1.2](https://github.com/DevilsDev/rag-pipeline-utils/compare/v2.1.1...v2.1.2) (2025-04-21)
-
-
-### Bug Fixes
-
-* resolve build/test errors, update jest configuration, and ensure compatibility with ECMAScript modules ([e6259f9](https://github.com/DevilsDev/rag-pipeline-utils/commit/e6259f924f38da66f9fc9cb7c01a8d6665bf5cbd))
-
-## [2.1.1](https://github.com/DevilsDev/rag-pipeline-utils/compare/v2.1.0...v2.1.1) (2025-04-18)
-
-
-### Bug Fixes
-
-* **blog:** convert tags.yml to valid object format for Docusaurus v3 ([6a7a9bf](https://github.com/DevilsDev/rag-pipeline-utils/commit/6a7a9bfa3501d30529b21e36fa51ab47d151f7a3))
-* **blog:** convert tags.yml to valid object format for Docusaurus v3 ([fa2fff9](https://github.com/DevilsDev/rag-pipeline-utils/commit/fa2fff969dc242e66d92a80b4aa2ff8e07f9fd0f))
-
-## [2.1.0] - 2025-04-18 (2025-04-18)
-
-
-### Features
-
-* **docs-site:** add Storybook integration with BlogCard + LQIP image automation ([80965b8](https://github.com/DevilsDev/rag-pipeline-utils/commit/80965b8ef1d26372852ee0f39b56a73f337e0cea))
-
-## [2.0.1](https://github.com/DevilsDev/rag-pipeline-utils/compare/v2.0.0...v2.0.1) (2025-04-17)
-
-
-### Bug Fixes
-
-* add @docusaurus/preset-classic to enable CI builds ([ed5e771](https://github.com/DevilsDev/rag-pipeline-utils/commit/ed5e771f919face4693a6a7abfed4cf0fe1325ca))
-
-## [2.0.0] - 2025-04-17 (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 +0,0 @@
-# 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"]

package/Use-Cases.md

@@ -1,134 +0,0 @@
-# RAG Pipeline Utils — Developer-Focused Use Cases
-
-> Modular, composable, and CI-verified RAG orchestration for modern AI applications.
-
----
-
-##  Use Case 1: Pluggable Local RAG Stack for Prototyping
-
-**Problem:** Traditional RAG tools force tight vendor dependencies.
-
-**Solution:** Use mockable local plugin implementations to simulate loaders, embedders, retrievers, and LLMs.
-
-```bash
-npm install @devilsdev/rag-pipeline-utils
-```
-
-```js
-// cli.js or app.js
-import { PluginRegistry } from './src/core/plugin-registry.js';
-import { loadRagConfig } from './src/config/load-config.js';
-
-const config = loadRagConfig('.ragrc.json');
-const loader = PluginRegistry.getPlugin('loader', 'pdf');
-const docs = loader.load('./test.pdf');
-```
-
-**Benefits**
-- Local plugin mocks with expected method contracts
-- Reusable plugin templates (`pdf-loader.js`, `openai-embedder.js`)
-- Dev-first DX: debug, snapshot, iterate without cloud costs
-
----
-
-##  Use Case 2: Declarative CLI RAG Pipelines (CI-Ready)
-
-**Problem:** Hardcoded pipeline steps can't be validated or changed by non-engineers.
-
-**Solution:** Define `.ragrc.json` once and reuse across environments.
-
-```json
-{
-  "loader": { "pdf": "./src/mocks/pdf-loader.js" },
-  "embedder": { "openai": "./src/mocks/openai-embedder.js" },
-  "retriever": { "pinecone": "./src/mocks/pinecone-retriever.js" },
-  "llm": { "openai": "./src/mocks/openai-llm.js" },
-  "namespace": "docs-poc",
-  "pipeline": ["loader", "embedder", "retriever"]
-}
-```
-
-```bash
-node ./bin/cli.js ingest ./docs/whitepaper.pdf
-node ./bin/cli.js query "What’s the goal of this architecture?"
-```
-
-**Benefits**
-- Teams can standardize pipelines in source control
-- Tests fail fast if structure or mocks drift
-- Non-devs can operate pipelines via CLI
-
----
-
-## Use Case 3: Mock-First TDD for Plugin Development
-
-**Problem:** LLM, vector, and loader logic are often developed without tests.
-
-**Solution:** Define contract-compliant mocks and CI-validate their structure before connecting to APIs.
-
-```js
-export default class CustomEmbedder {
-  embed(docs) { return docs.map(...); }
-  embedQuery(q) { return [...]; }
-}
-```
-
-Run full contract verification:
-
-```bash
-npm run ci
-```
-
-**Benefits**
-- Every plugin is CI-verified for method presence
-- Shared contracts enforce required interfaces
-- Onboarding new devs? Just follow `pluginContracts.js`
-
----
-
-##  Use Case 4: Vendor-Neutral AI Data Pipelines
-
-**Problem:** Every RAG stack is locked to OpenAI + Pinecone + Langchain.
-
-**Solution:** Use this project to mix, match, or mock vector/LLM pairs:
-
-```js
-"retriever": { "localstore": "./src/plugins/local-retriever.js" },
-"llm": { "cohere": "./src/plugins/cohere-llm.js" }
-```
-
-**Benefits**
-- Run multiple RAG pipelines in parallel (A/B testing, evals)
-- Lower infra cost with offline/local plugin support
-- Integrate with tools outside Langchain ecosystem
-
----
-
-## 🛠 Use Case 5: Plugin Engineering with Guardrails
-
-**Problem:** Complex plugin systems break silently.
-
-**Solution:** This framework has:
-- Plugin method contract enforcement
-- CLI test runner (`scripts/ci-runner.js`)
-- Auto repair tool (`scripts/repair-fixtures.js`)
-
-**DX Boost**
-- One-line plugin repairs
-- Validated schema structure
-- Aligned to real-world developer workflows
-
----
-
-## Cross References
-
-- [README](./README.md) — Project overview, architecture, CLI and configuration details
-- [pluginContracts.js](./src/core/plugin-contracts.js) — Interface contracts for loader, embedder, retriever, LLM
-- [diagnostic-reporter.js](./src/utils/ci/diagnostic-reporter.js) — CI error helper
-- [repair-fixtures.js](./scripts/repair-fixtures.js) — Auto-regeneration of mocks
-
----
-
-## License
-
-Licensed under the **GPL-3.0 License** — see [LICENSE](./LICENSE) for full terms.

package/__tests__/fixtures/.ragrc.json

@@ -1,8 +0,0 @@
-{
-  "loader": { "pdf": "./src/mocks/pdf-loader.js" },
-  "embedder": { "openai": "./src/mocks/openai-embedder.js" },
-  "retriever": { "pinecone": "./src/mocks/pinecone-retriever.js" },
-  "llm": { "openai": "./src/mocks/openai-llm.js" },
-  "namespace": "cli-config-test",
-  "pipeline": ["loader", "embedder", "retriever"]
-}

package/__tests__/fixtures/invalid-ragrc.json

@@ -1,4 +0,0 @@
-{
-  "loader": "./src/mocks/pdf-loader.js",
-  "namespace": 12345
-}

package/__tests__/fixtures/sample-eval-dataset.json

@@ -1,15 +0,0 @@
-[
-    {
-      "prompt": "What is a vector database?",
-      "expected": "A vector database is a system optimized for storing and retrieving data represented as vectors, often used in similarity search."
-    },
-    {
-      "prompt": "Explain what chunking means in RAG.",
-      "expected": "Chunking is the process of splitting documents into smaller, manageable pieces for embedding and retrieval in a RAG pipeline."
-    },
-    {
-      "prompt": "What is the role of embedding in a RAG pipeline?",
-      "expected": "Embeddings convert text into numerical vector form so they can be compared in a vector database during retrieval."
-    }
-  ]
-  

package/__tests__/fixtures/sample.pdf

@@ -1 +0,0 @@
-%PDF-1.4\n%âãÏÓ\n1 0 obj\n<<>>\nendobj\nxref\n0 2\n0000000000 65535 f\n0000000010 00000 n\ntrailer\n<<>>\nstartxref\n9\n%%EOF

package/__tests__/fixtures/src/mocks/openai-embedder.js

@@ -1,16 +0,0 @@
-/**
- * Mock OpenAI Embedder Plugin
- * Implements: embedder.embed(docs), embedder.embedQuery(query)
- */
-export default class OpenAIEmbedder {
-  embed(documents) {
-    return documents.map(doc => ({
-      id: doc.id,
-      values: [0.1, 0.2, 0.3],
-    }));
-  }
-
-  embedQuery(query) {
-    return [0.1, 0.2, 0.3];
-  }
-}

package/__tests__/fixtures/src/mocks/openai-llm.js

@@ -1,9 +0,0 @@
-/**
- * Mock OpenAI LLM Plugin
- * Implements: llm.ask(prompt)
- */
-export default class OpenAILLM {
-  ask(prompt) {
-    return `Answer: Mocked response to "${prompt}"`;
-  }
-}

package/__tests__/fixtures/src/mocks/pdf-loader.js

@@ -1,17 +0,0 @@
-/**
- * Mock PDF Loader Plugin
- * Implements: loader.load(filePath)
- */
-export default class PdfLoader {
-  /**
-   * Loads a file and returns mock document chunks.
-   * @param {string} filePath
-   * @returns {Array<{ id: string, content: string }>}
-   */
-  load(filePath) {
-    return [
-      { id: 'doc1', content: `Loaded content from ${filePath}` },
-      { id: 'doc2', content: 'Second document content' },
-    ];
-  }
-}

package/__tests__/fixtures/src/mocks/pinecone-retriever.js

@@ -1,26 +0,0 @@
-/**
- * Mock Pinecone Retriever Plugin
- * Implements: retriever.store(vectors), retriever.search(queryVector)
- */
-export default class PineconeRetriever {
-  constructor() {
-    this._store = [];
-  }
-
-  /**
-   * Stores embedded vectors.
-   * @param {Array<{ id: string, values: number[] }>} vectors
-   */
-  store(vectors) {
-    this._store = vectors;
-  }
-
-  /**
-   * Searches mock memory and returns matching docs.
-   * @param {number[]} queryVector
-   * @returns {Array<{ id: string, score: number }>}
-   */
-  search(queryVector) {
-    return this._store.map(v => ({ id: v.id, score: 0.99 }));
-  }
-}

package/__tests__/fixtures/valid-ragrc.json

@@ -1,16 +0,0 @@
-{
-  "loader": {
-    "pdf": "./src/mocks/pdf-loader.js"
-  },
-  "embedder": {
-    "openai": "./src/mocks/openai-embedder.js"
-  },
-  "retriever": {
-    "pinecone": "./src/mocks/pinecone-retriever.js"
-  },
-  "llm": {
-    "openai": "./src/mocks/openai-llm.js"
-  },
-  "namespace": "cli-config-test",
-  "pipeline": ["loader", "embedder", "retriever"]
-}

package/__tests__/integration/cli/config-flow.test.js

@@ -1,98 +0,0 @@
-/**
- * Version: 1.1.0
- * Description: Final CLI config fallback integration test with fixture mock copying and validation
- * Author: Ali Kahwaji
- */
-
-import { execSync } from 'child_process';
-import {
-  mkdirSync,
-  rmSync,
-  writeFileSync,
-  copyFileSync,
-  existsSync,
-  readdirSync,
-  readFileSync
-} from 'fs';
-import { join, resolve } from 'path';
-import { fileURLToPath } from 'url';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = resolve(__filename, '..');
-
-const CLI_PATH = resolve('bin/cli.js');
-const TEMP_TEST_DIR = resolve('__tests__/__temp__/cli-config-fallback');
-const FIXTURE_CONFIG = join(TEMP_TEST_DIR, '.ragrc.json');
-const FIXTURE_PDF = resolve('__tests__/fixtures/sample.pdf');
-
-// Fixture sources
-const FIXTURE_SRC = resolve('__tests__/fixtures/src/mocks');
-const PDF_LOADER_SRC = join(FIXTURE_SRC, 'pdf-loader.js');
-const EMBEDDER_SRC = join(FIXTURE_SRC, 'openai-embedder.js');
-const RETRIEVER_SRC = join(FIXTURE_SRC, 'pinecone-retriever.js');
-const LLM_SRC = join(FIXTURE_SRC, 'openai-llm.js');
-
-const FIXTURE_CONFIG_OBJECT = {
-  loader: { pdf: './src/mocks/pdf-loader.js' },
-  embedder: { openai: './src/mocks/openai-embedder.js' },
-  retriever: { pinecone: './src/mocks/pinecone-retriever.js' },
-  llm: { openai: './src/mocks/openai-llm.js' },
-  namespace: 'cli-config-test',
-  pipeline: ['loader', 'embedder', 'retriever']
-};
-
-describe('CLI integration with .ragrc.json config fallback', () => {
-  beforeAll(() => {
-    rmSync(TEMP_TEST_DIR, { recursive: true, force: true });
-    mkdirSync(join(TEMP_TEST_DIR, 'src/mocks'), { recursive: true });
-
-    // Assert existence
-    [FIXTURE_PDF, PDF_LOADER_SRC, EMBEDDER_SRC, RETRIEVER_SRC, LLM_SRC].forEach(file => {
-      if (!existsSync(file)) throw new Error(`[FATAL] Missing required fixture: ${file}`);
-    });
-
-    // Copy fixture PDF
-    copyFileSync(FIXTURE_PDF, join(TEMP_TEST_DIR, 'sample.pdf'));
-
-    // Copy mock plugins into temp dir
-    copyFileSync(PDF_LOADER_SRC, join(TEMP_TEST_DIR, 'src/mocks/pdf-loader.js'));
-    copyFileSync(EMBEDDER_SRC, join(TEMP_TEST_DIR, 'src/mocks/openai-embedder.js'));
-    copyFileSync(RETRIEVER_SRC, join(TEMP_TEST_DIR, 'src/mocks/pinecone-retriever.js'));
-    copyFileSync(LLM_SRC, join(TEMP_TEST_DIR, 'src/mocks/openai-llm.js'));
-
-    // Write valid .ragrc.json
-    writeFileSync(FIXTURE_CONFIG, JSON.stringify(FIXTURE_CONFIG_OBJECT, null, 2));
-
-    console.debug('[DEBUG] .ragrc.json contents:\n', JSON.stringify(FIXTURE_CONFIG_OBJECT, null, 2));
-    console.debug('[SETUP] Temp dir:', TEMP_TEST_DIR);
-    console.debug('[SETUP] Contents:', readdirSync(TEMP_TEST_DIR));
-  });
-
-  afterAll(() => {
-    rmSync(TEMP_TEST_DIR, { recursive: true, force: true });
-  });
-
-  test('validates plugin sections contain resolvable names', () => {
-    const config = JSON.parse(readFileSync(FIXTURE_CONFIG, 'utf-8'));
-    ['loader', 'embedder', 'retriever', 'llm'].forEach(type => {
-      expect(typeof config[type]).toBe('object');
-      expect(Object.keys(config[type]).length).toBeGreaterThan(0);
-    });
-  });
-
-  test('executes CLI ingest using config fallback', () => {
-    const result = execSync(`node ${CLI_PATH} ingest sample.pdf`, {
-      cwd: TEMP_TEST_DIR,
-      encoding: 'utf-8'
-    });
-    expect(result).toMatch(/Ingestion complete/);
-  });
-
-  test('executes CLI query using config fallback', () => {
-    const result = execSync(`node ${CLI_PATH} query "What is this test about?"`, {
-      cwd: TEMP_TEST_DIR,
-      encoding: 'utf-8'
-    });
-    expect(result).toMatch(/Answer:/);
-  });
-});

package/__tests__/integration/config/load-config.test.js

@@ -1,67 +0,0 @@
-/**
- * Version: 1.1.1
- * Description: Integration tests for loading and validating .ragrc.json via loadRagConfig()
- * Author: Ali Kahwaji
- * File: __tests__/integration/config/load-config.test.js
- */
-
-import fs from 'fs';
-import { copyFileSync, mkdirSync, rmSync, existsSync } from 'fs';
-import { join, resolve } from 'path';
-import { fileURLToPath } from 'url';
-import { loadRagConfig } from '../../../src/config/load-config.js';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = resolve(__filename, '..');
-
-// Fixture paths
-const FIXTURE_DIR = resolve(__dirname, '../../fixtures');
-const VALID_FIXTURE = join(FIXTURE_DIR, 'valid-ragrc.json');
-const INVALID_FIXTURE = join(FIXTURE_DIR, 'invalid-ragrc.json');
-
-// Temp directory used during tests
-const TEMP_DIR = resolve('__tests__', '__temp__', 'load-config');
-const TEMP_CONFIG = join(TEMP_DIR, '.ragrc.json');
-
-// Ensure fixtures are available before copying
-function assertFixturesExist() {
-  const required = [VALID_FIXTURE, INVALID_FIXTURE];
-  required.forEach(file => {
-    if (!existsSync(file)) {
-      throw new Error(`❌ Required test fixture missing: ${file}`);
-    }
-  });
-}
-
-describe('loadRagConfig()', () => {
-  beforeAll(() => {
-    rmSync(TEMP_DIR, { recursive: true, force: true });
-    mkdirSync(TEMP_DIR, { recursive: true });
-
-    assertFixturesExist();
-  });
-
-  afterAll(() => {
-    rmSync(TEMP_DIR, { recursive: true, force: true });
-  });
-
-  test('loads a valid .ragrc.json config file successfully', () => {
-    copyFileSync(VALID_FIXTURE, TEMP_CONFIG);
-
-    const config = loadRagConfig(TEMP_CONFIG);
-    expect(config).toBeDefined();
-    expect(config.namespace).toBe('cli-config-test');
-    expect(config.loader?.pdf).toBe('./src/mocks/pdf-loader.js');
-    expect(config.pipeline).toEqual(expect.arrayContaining(['loader', 'embedder', 'retriever']));
-  });
-
-  test('throws validation error for invalid .ragrc.json config', () => {
-    copyFileSync(INVALID_FIXTURE, TEMP_CONFIG);
-    expect(() => loadRagConfig(TEMP_CONFIG)).toThrow(/Config validation failed/);
-  });
-
-  test('throws error if config file does not exist', () => {
-    const NON_EXISTENT = join(TEMP_DIR, 'missing.json');
-    expect(() => loadRagConfig(NON_EXISTENT)).toThrow(/Config file not found/);
-  });
-});

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

@@ -1,64 +0,0 @@
-/**
- * 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);
-  });
-});