Development

.distignore

@@ -30,6 +30,7 @@ tailwind.config.js
 /.wordpress-org
 /.idea
 /src
+/patches
 /bin
 /tests
 /phpunit.xml

.github/workflows/create-buld-url.yml

@@ -25,6 +25,12 @@ jobs:
         run: composer install --no-dev --prefer-dist --no-progress --no-suggest
       - name: Install npm deps
         run: npm ci
+      - name: Bump the plugin version
+        run: |
+          CURRENT_VERSION=$(node -p -e "require('./package.json').version")
+          COMMIT_HASH=$(git rev-parse --short HEAD)
+          DEV_VERSION="${CURRENT_VERSION}-dev.${COMMIT_HASH}"
+          grunt version::${DEV_VERSION}
       - name: Build files
         run: npm run build
       - name: Create zip

.github/workflows/translations.yml

@@ -0,0 +1,48 @@
+name: Translations Diff
+
+on:
+  pull_request_review:
+  pull_request:
+    types: [opened, edited, synchronize, ready_for_review]
+    branches:
+      - development
+      - main
+
+jobs:
+  translation:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: write
+    steps:
+      - name: Checkout Base Branch
+        uses: actions/checkout@v4
+        with:
+          ref: ${{ github.base_ref }}
+          path: hyve-lite-base
+      - name: Setup node 22
+        uses: actions/setup-node@v6
+        with:
+          node-version: 22.x
+      - name: Checkout PR Branch (Head)
+        uses: actions/checkout@v4
+        with:
+          path: hyve-lite-head
+      - name: Build POT for PR Branch
+        run: |
+          chmod +x ./hyve-lite-head/bin/make-pot.sh
+          ./hyve-lite-head/bin/make-pot.sh ./hyve-lite-head ./hyve-lite-head/languages/hyve-lite.pot
+          ls ./hyve-lite-head/languages/
+      - name: Build POT for Base Branch
+        run: |
+          ./hyve-lite-head/bin/make-pot.sh ./hyve-lite-base ./hyve-lite-base/languages/hyve-lite.pot
+          ls ./hyve-lite-base/languages/
+      - name: Compare POT files
+        uses: Codeinwp/action-i18n-string-reviewer@main
+        with:
+          fail-on-changes: "false"
+          openrouter-key: ${{ secrets.OPEN_ROUTER_API_KEY }}
+          openrouter-model: "google/gemini-2.5-flash"
+          base-pot-file: "hyve-lite-base/languages/hyve-lite.pot"
+          target-pot-file: "hyve-lite-head/languages/hyve-lite.pot"
+          github-token: ${{ secrets.BOT_TOKEN }}

AGENTS.md

@@ -79,7 +79,7 @@ Plugin constants are defined in `hyve-lite.php`: `HYVE_LITE_BASEFILE`, `HYVE_LIT
 
 Four separate webpack entry points built with `@wordpress/scripts`:
 
-1. **src/backend/** — Admin dashboard React app using `@wordpress/element` and `@wordpress/data` for state management. Components in `components/`, page sections in `parts/`.
+1. **src/backend/** — Admin dashboard React app using `@wordpress/element` and `@wordpress/data` for state management. Four tab screens in `screens/` (Dashboard, KnowledgeBase, Messages, Settings), shared layout kit in `components/`, hooks in `data/`, URL routing in `router.js` (`?page=hyve&nav=<screen>&sub=<panel>&item=<id>`), shared store in `store.js`. Pro extends it through the `hyve.routes` / `hyve.slot` / `hyve.setup-steps` filters and the layout kit bridged at `window.hyveComponents.ui`.
 2. **src/frontend/** — Client-facing chat widget. Vanilla JS class (`App`) — no React. Manages chat state, threads, audio, and localStorage persistence.
 3. **src/block/** — Gutenberg block with two variations: inline and floating. Server-rendered via `render.php`.
 4. **src/addons/** — Post list table row actions for quick knowledge base add/remove.

Gruntfile.js

@@ -2,44 +2,36 @@
 /* jshint node:true */
 /* global require */
 
-module.exports = function( grunt ) {
+module.exports = function ( grunt ) {
 	grunt.loadNpmTasks( 'grunt-version' );
-	grunt.initConfig(
-		{
-			version: {
-				project: {
-					src: [
-						'package.json'
-					]
+	grunt.initConfig( {
+		version: {
+			project: {
+				src: [ 'package.json' ],
+			},
+			composer: {
+				src: [ 'composer.json' ],
+			},
+			metatag: {
+				options: {
+					prefix: 'Version:\\s*',
+					flags: '',
 				},
-				composer: {
-					src: [
-						'composer.json'
-					]
+				src: [ 'hyve-lite.php' ],
+			},
+			php: {
+				options: {
+					prefix: "HYVE_LITE_VERSION', '",
+					flags: '',
 				},
-				metatag: {
-					options: {
-						prefix: 'Version:\\s*',
-						flags: ''
-					},
-					src: [ 'hyve-lite.php' ]
+				src: [ 'hyve-lite.php' ],
+			},
+			readmetxt: {
+				options: {
+					prefix: 'Stable tag:\\s*',
 				},
-				php: {
-					options: {
-						prefix: 'HYVE_LITE_VERSION\', \'',
-						flags: ''
-					},
-					src: [ 'hyve-lite.php' ]
-				},
-				readmetxt: {
-					options: {
-						prefix: 'Stable tag:\\s*'
-					},
-					src: [
-						'readme.txt'
-					]
-				}
-			}
-		}
-	);
+				src: [ 'readme.txt' ],
+			},
+		},
+	} );
 };

bin/make-pot.sh

@@ -0,0 +1,47 @@
+#!/bin/bash
+
+# Script to generate POT file via Docker
+# Usage: ./bin/make-pot.sh [plugin-path] [destination-path]
+
+# Set defaults
+PLUGIN_PATH="${1:-.}"
+DESTINATION="${2:-.}"
+
+# Resolve absolute paths
+PLUGIN_PATH="$(cd "$PLUGIN_PATH" 2>/dev/null && pwd)" || {
+    echo "Error: Plugin path '$1' does not exist"
+    exit 1
+}
+
+DESTINATION="$(cd "$(dirname "$DESTINATION")" 2>/dev/null && pwd)/$(basename "$DESTINATION")" || {
+    echo "Error: Unable to resolve destination path"
+    exit 1
+}
+
+# Extract destination filename and directory
+DEST_DIR="$(dirname "$DESTINATION")"
+DEST_FILE="$(basename "$DESTINATION")"
+
+# Ensure destination directory exists
+mkdir -p "$DEST_DIR"
+
+echo "Generating POT file..."
+echo "Plugin Path: $PLUGIN_PATH"
+echo "Destination: $DESTINATION"
+echo ""
+
+# Run Docker container with wp-cli to generate POT
+docker run --user root --rm \
+    --volume "$PLUGIN_PATH:/var/www/html/plugin" \
+    wordpress:cli \
+    bash -c 'php -d memory_limit=512M "$(which wp)" --version --allow-root && wp i18n make-pot plugin ./plugin/languages/'"$DEST_FILE"' --include=inc,build,src --allow-root --domain=hyve-lite'
+
+# Check if the file was created inside the container
+if [ $? -eq 0 ]; then
+    echo ""
+    echo "✓ POT file successfully generated at: $DESTINATION"
+else
+    echo ""
+    echo "✗ Error generating POT file"
+    exit 1
+fi

bin/set-settings.php

@@ -8,22 +8,7 @@
 	'chat_enabled'         => false,
 	'welcome_message'      => 'Hello! How can I help you today?',
 	'default_message'      => 'Sorry, I\'m not able to help with that.',
-	'chat_model'           => 'gpt-4o-mini',
-	'temperature'          => 1,
-	'top_p'                => 1,
-	'moderation_threshold' => [
-		'sexual'                 => 80,
-		'hate'                   => 70,
-		'harassment'             => 70,
-		'self-harm'              => 50,
-		'sexual/minors'          => 50,
-		'hate/threatening'       => 60,
-		'violence/graphic'       => 80,
-		'self-harm/intent'       => 50,
-		'self-harm/instructions' => 50,
-		'harassment/threatening' => 60,
-		'violence'               => 70,
-	],
+	'chat_model'           => 'gpt-5.4-nano',
 ];
 
 update_option( 'hyve_settings', $settings );

composer.json

@@ -43,11 +43,20 @@
 		},
 		"allow-plugins": {
             "dealerdirect/phpcodesniffer-composer-installer": true,
-            "php-http/discovery": true
+            "php-http/discovery": true,
+            "cweagans/composer-patches": true
         }
 	},
+    "extra": {
+        "patches": {
+            "your1/qdrant": {
+                "Add #[\\ReturnTypeWillChange] to Response::offsetGet() for PHP 8.1+ compatibility": "patches/qdrant-response-returntypewillchange.patch"
+            }
+        }
+    },
     "require": {
         "codeinwp/themeisle-sdk": "^3.3",
+        "cweagans/composer-patches": "^1.7",
         "guttedgarden/tiktoken": "^1.2",
         "your1/qdrant": "^0.5.3"
     }