feat: implement vector store (qdrant) cluster ping action (#193)

## Description
<!-- Please add PR description (don't leave blank) - example: This PR
[adds/removes/fixes/replaces] the [feature/bug/etc] -->

This pull request introduces an automated health check for the Qdrant
vector store cluster to help keep it active and prevent deletion due to
inactivity. The main changes include adding a scheduled GitHub Actions
workflow to ping the cluster, implementing a new Node.js script for
connectivity and collection checks, and updating the `package.json`
scripts to support manual execution.

### Changes Made

- Created `dev/ping-qdrant-cluster.js`, a Node.js utility that checks
cluster connectivity and verifies the existence of the `dictionary`
collection, providing clear logging and error hints.
- Updated `package.json` to add a new `ping:qdrant` npm script for
running the cluster ping locally or in CI.
- Added `.github/workflows/ping-qdrant.yml` to schedule a weekly
workflow and allow manual runs for pinging the Qdrant cluster, ensuring
regular activity and easier testing.

## Related Issue
<!-- Please prefix the issue number with Fixes/Resolves - example: Fixes
#123 or Resolves #123 -->

Fixes #192 

## Screenshots/Screencasts
<!-- Please provide screenshots or video recording that demos your
changes (especially if it's a visual change) -->

NA

## Notes to Reviewer
<!-- Please state here if you added a new npm packages, or any extra
information that can help reviewer better review you changes -->

- Added new GitHub Actions workflow

Author: babblebey

.github/workflows/ping-qdrant.yml

@@ -0,0 +1,35 @@
+name: Ping Vector Store (Qdrant) Cluster
+
+on:
+  # Run weekly on Sundays at 2 AM UTC to keep the cluster active
+  schedule:
+    - cron: "0 2 * * 0"
+
+  # Allow manual triggering for testing
+  workflow_dispatch:
+
+jobs:
+  ping-cluster:
+    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: Ping Qdrant cluster
+        env:
+          QDRANT_URL: ${{ secrets.QDRANT_URL }}
+          QDRANT_API_KEY: ${{ secrets.QDRANT_API_KEY }}
+        run: npm run ping:qdrant
+
+      - name: Ping successful
+        run: echo "✅ Qdrant cluster ping completed successfully"

dev/ping-qdrant-cluster.js

@@ -0,0 +1,75 @@
+/**
+ * Vector Store (Qdrant) Cluster Ping Utility
+ *
+ * This script performs a lightweight health check on the Vector Store (Qdrant) cluster
+ * by checking the existence of the 'dictionary' collection.
+ * 
+ * This keeps the cluster active and prevents automatic deletion due to inactivity.
+ */
+const QDRANT_URL = process.env.QDRANT_URL;
+const QDRANT_API_KEY = process.env.QDRANT_API_KEY;
+const COLLECTION_NAME = "dictionary";
+
+console.log("🚀 Starting Vector Store (Qdrant) cluster ping...");
+console.log("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
+
+try {
+  console.log("🔍 Checking Vector Store (Qdrant) cluster connectivity...");
+  
+  // Test basic cluster connection
+  const healthResponse = await fetch(QDRANT_URL, {
+    headers: {
+      'api-key': QDRANT_API_KEY
+    }
+  });
+  
+  if (!healthResponse.ok) {
+    throw new Error(`Health check failed: ${healthResponse.status} ${healthResponse.statusText}`);
+  }
+  
+  console.log("✅ Cluster is accessible");
+  
+  // Check collections
+  const collectionsResponse = await fetch(`${QDRANT_URL}/collections`, {
+    headers: {
+      'api-key': QDRANT_API_KEY
+    }
+  });
+  
+  if (!collectionsResponse.ok) {
+    throw new Error(`Collections check failed: ${collectionsResponse.status} ${collectionsResponse.statusText}`);
+  }
+  
+  const collectionsData = await collectionsResponse.json();
+  const collections = collectionsData.result?.collections || [];
+  const collectionExists = collections.some(collection => collection.name === COLLECTION_NAME);
+  
+  if (collectionExists) {
+    console.log(`✅ SUCCESS: '${COLLECTION_NAME}' collection exists`);
+    console.log(`📊 Total collections: ${collections.length}`);
+    console.log(`🎯 Cluster ping completed successfully at ${new Date().toISOString()}`);
+    console.log("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
+    console.log("🎉 Cluster ping completed successfully!");
+    process.exit(0);
+  } else {
+    console.error(`❌ ERROR: '${COLLECTION_NAME}' collection not found`);
+    console.log(`📊 Available collections: ${collections.map(c => c.name).join(', ')}`);
+    console.log("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
+    console.error("💥 Cluster ping failed!");
+    process.exit(1);
+  }
+  
+} catch (error) {
+  console.error("❌ FAILED to ping Vector Store (Qdrant) cluster:");
+  console.error("Error details:", error.message);
+  
+  if (error.message.includes("401") || error.message.includes("Unauthorized")) {
+    console.error("💡 Hint: Check your QDRANT_API_KEY configuration");
+  } else if (error.message.includes("network") || error.message.includes("fetch")) {
+    console.error("💡 Hint: Check your QDRANT_URL and network connectivity");
+  }
+  
+  console.log("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
+  console.error("💥 Cluster ping failed!");
+  process.exit(1);
+}

package.json

@@ -17,7 +17,8 @@
     "test:watch": "vitest",
     "test:coverage": "vitest run --coverage",
     "setup": "node dev/setup.js",
-    "seed:jai": "node --env-file=.env dev/seed-vector-store.js"
+    "seed:jai": "node --env-file=.env dev/seed-vector-store.js",
+    "ping:qdrant": "node --env-file=.env dev/ping-qdrant-cluster.js"
   },
   "keywords": [],
   "author": "",