@underpostnet/underpost 2.97.5 → 2.98.1

package/src/api/document/document.service.js

@@ -31,6 +31,8 @@ const DocumentService = {
     const Document = DataBaseProvider.instance[`${options.host}${options.path}`].mongoose.models.Document;
     /** @type {import('../user/user.model.js').UserModel} */
     const User = DataBaseProvider.instance[`${options.host}${options.path}`].mongoose.models.User;
+    /** @type {import('../file/file.model.js').FileModel} */
+    const File = DataBaseProvider.instance[`${options.host}${options.path}`].mongoose.models.File;
 
     // High-query endpoint for typeahead search
     //
@@ -38,21 +40,8 @@ const DocumentService = {
     // - Unauthenticated users: CAN see public documents (isPublic=true) from publishers (admin/moderator)
     // - Authenticated users: CAN see public documents from publishers + ALL their own documents (public or private)
     // - No user can see private documents from other users
-    //
-    // Search Optimization Strategy:
-    // 1. Case-insensitive matching ($options: 'i') - maximizes matches across case variations
-    // 2. Multi-term search - splits "hello world" into ["hello", "world"] and matches ANY term
-    // 3. Multi-field search - searches BOTH title AND tags array
-    // 4. OR logic - ANY term matching ANY field counts as a match
-    // 5. Minimum length: 1 character - allows maximum user flexibility
-    //
-    // Example: Query "javascript tutorial"
-    //   - Matches documents with title "JavaScript Guide" (term 1, case-insensitive)
-    //   - Matches documents with tag "tutorial" (term 2, tag match)
-    //   - Matches documents with both terms in different fields
-    //
+    // - PANEL FILTER: Only documents with idPanel tag are returned (prevents out-of-panel context results)
     if (req.path.startsWith('/public/high') && req.query['q']) {
-      // Input validation
       const rawQuery = req.query['q'];
       if (!rawQuery || typeof rawQuery !== 'string') {
         throw new Error('Invalid search query');
@@ -68,6 +57,13 @@ const DocumentService = {
         throw new Error('Search query too long (max 100 characters)');
       }
 
+      // Get idPanel filter to prevent out-of-panel context results
+      const idPanel = req.query['idPanel'];
+      if (!idPanel || typeof idPanel !== 'string') {
+        logger.warn('Missing idPanel parameter for high-query search');
+        return { data: [] };
+      }
+
       const publisherUsers = await User.find({ $or: [{ role: 'admin' }, { role: 'moderator' }] });
 
       const token = getBearerToken(req);
@@ -97,15 +93,9 @@ const DocumentService = {
         const queryPayload = {
           isPublic: true,
           userId: { $in: publisherUsers.map((p) => p._id) },
+          tags: { $in: [idPanel] }, // Filter by idPanel to prevent out-of-panel context results (tags is array)
         };
 
-        logger.info('Special "public" search query', {
-          authenticated: !!user,
-          userId: user?._id?.toString(),
-          role: user?.role,
-          limit,
-        });
-
         const data = await Document.find(queryPayload)
           .sort({ createdAt: -1 })
           .limit(limit)
@@ -151,21 +141,7 @@ const DocumentService = {
         .map((term) => term.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')); // Escape each term for regex safety
 
       // Build query based on authentication status
-      // ============================================
-      // OPTIMIZED FOR MAXIMUM RESULTS:
-      // - Multi-term search: matches ANY term
-      // - Case-insensitive: $options: 'i' flag
-      // - Multi-field: searches title AND tags
-      // - Minimum match: ANY term in ANY field = result
-      //
-      // Example Query: "javascript react"
-      // Matches:
-      //   ✓ Document with title "JavaScript Tutorial" (term 1 in title)
-      //   ✓ Document with tag "react" (term 2 in tags)
-      //   ✓ Document with title "Learn React JS" (term 2 in title, case-insensitive)
-      //   ✓ Document with tags ["javascript", "tutorial"] (term 1 in tags)
-
-      // Build search conditions for maximum permissiveness
+      // and search conditions for maximum permissiveness
       const buildSearchConditions = () => {
         const conditions = [];
 
@@ -185,14 +161,11 @@ const DocumentService = {
         // Authenticated user can see:
         // 1. ALL their own documents (public AND private - no tag restriction)
         // 2. Public-tagged documents from publishers (admin/moderator only)
-        //
-        // MAXIMUM RESULTS STRATEGY:
-        // - Search by: ANY term matches title OR ANY tag
-        // - Case-insensitive matching
-        // - No minimum match threshold beyond 1 character
+
         const searchConditions = buildSearchConditions();
 
         queryPayload = {
+          tags: { $in: [idPanel] }, // Filter by idPanel to prevent out-of-panel context results (tags is array)
           $or: [
             {
               // Public documents from publishers (admin/moderator)
@@ -210,14 +183,11 @@ const DocumentService = {
         };
       } else {
         // Public/unauthenticated user: ONLY public-tagged documents from publishers (admin/moderator)
-        //
-        // MAXIMUM RESULTS STRATEGY for public users:
-        // - Search by: ANY term matches title OR ANY tag
-        // - Case-insensitive matching
-        // - Still respects security: only public docs from trusted publishers
+
         const searchConditions = buildSearchConditions();
 
         queryPayload = {
+          tags: { $in: [idPanel] }, // Filter by idPanel to prevent out-of-panel context results (tags is array)
           userId: { $in: publisherUsers.map((p) => p._id) },
           isPublic: true,
           $or: searchConditions, // ANY term in title OR tags
@@ -230,19 +200,6 @@ const DocumentService = {
         return { data: [] };
       }
 
-      // Security audit logging
-      logger.info('High-query search (OPTIMIZED FOR MAX RESULTS)', {
-        query: searchQuery.substring(0, 50), // Log only first 50 chars for privacy
-        terms: searchTerms.length, // Number of search terms
-        searchStrategy: 'multi-term OR matching, case-insensitive, title+tags',
-        authenticated: !!user,
-        userId: user?._id?.toString(),
-        role: user?.role,
-        limit,
-        publishersCount: publisherUsers.length,
-        timestamp: new Date().toISOString(),
-      });
-
       const data = await Document.find(queryPayload)
         .sort({ createdAt: -1 })
         .limit(limit)
@@ -265,10 +222,7 @@ const DocumentService = {
           }
         }
         // Remove role field from userId before sending to client (all users)
-        if (filteredDoc.userId && filteredDoc.userId.role) {
-          const { role, ...userWithoutRole } = filteredDoc.userId;
-          filteredDoc.userId = userWithoutRole;
-        }
+        delete filteredDoc.userId.role;
         return filteredDoc;
       });
 
@@ -372,18 +326,7 @@ const DocumentService = {
           };
         }
       }
-      // Security audit logging
-      logger.info('Public tag search', {
-        authenticated: !!user,
-        userId: user?._id?.toString(),
-        role: user?.role,
-        requestedTags,
-        hasPublicTag,
-        hasCidFilter: !!req.query.cid,
-        limit,
-        skip,
-        publishersCount: publisherUsers.length,
-      });
+
       // sort in descending (-1) order by length
       const sort = { createdAt: -1 };
 
@@ -417,9 +360,11 @@ const DocumentService = {
           if ((!docObj.isPublic || !isPublisher) && !isOwnDoc) userInfo = undefined;
           return {
             ...docObj,
-            role: undefined,
-            email: undefined,
-            userId: userInfo,
+            userId: {
+              ...userInfo,
+              role: undefined,
+              email: undefined,
+            },
             tags: DocumentDto.filterPublicTag(docObj.tags),
             totalCopyShareLinkCount: DocumentDto.getTotalCopyShareLinkCount(doc),
           };
@@ -430,32 +375,65 @@ const DocumentService = {
 
     switch (req.params.id) {
       default: {
-        const data = await Document.find({
+        // Simple pagination support for FileExplorer
+        const limit = req.query.limit ? parseInt(req.query.limit, 10) : 50;
+        const skip = req.query.skip ? parseInt(req.query.skip, 10) : 0;
+
+        // Search filter parameters
+        const searchTitle = req.query.searchTitle ? req.query.searchTitle.trim() : '';
+        const searchMdFile = req.query.searchMdFile ? req.query.searchMdFile.trim() : '';
+        const searchFile = req.query.searchFile ? req.query.searchFile.trim() : '';
+
+        const query = {
           userId: req.auth.user._id,
           ...(req.params.id ? { _id: req.params.id } : undefined),
-        })
+        };
+
+        // Filter by title
+        if (searchTitle) {
+          const searchRegex = searchTitle.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+          query.title = { $regex: searchRegex, $options: 'i' };
+        }
+
+        // Filter by markdown file name
+        if (searchMdFile) {
+          const searchRegex = searchMdFile.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+          const files = await File.find({ name: { $regex: searchRegex, $options: 'i' } }).select('_id');
+          query.mdFileId = { $in: files.map((f) => f._id) };
+        }
+
+        // Filter by generic file name
+        if (searchFile) {
+          const searchRegex = searchFile.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+          const files = await File.find({ name: { $regex: searchRegex, $options: 'i' } }).select('_id');
+          query.fileId = { $in: files.map((f) => f._id) };
+        }
+
+        // Get total count for pagination
+        const totalCount = await Document.countDocuments(query);
+
+        const data = await Document.find(query)
+          .sort({ createdAt: -1 })
+          .limit(limit)
+          .skip(skip)
           .populate(DocumentDto.populate.file())
           .populate(DocumentDto.populate.mdFile())
           .populate(DocumentDto.populate.user());
 
-        // Add totalCopyShareLinkCount to each document and filter 'public' from tags
-        return data.map((doc) => {
-          const docObj = doc.toObject ? doc.toObject() : doc;
-
-          // Remove role field from userId before sending to client
-          let userInfo = docObj.userId;
-          if (userInfo && userInfo.role) {
-            const { role, ...userWithoutRole } = userInfo;
-            userInfo = userWithoutRole;
-          }
-
-          return {
-            ...docObj,
-            userId: userInfo,
-            tags: DocumentDto.filterPublicTag(docObj.tags),
-            totalCopyShareLinkCount: DocumentDto.getTotalCopyShareLinkCount(doc),
-          };
-        });
+        return {
+          data,
+          pagination: {
+            totalCount,
+            limit,
+            skip,
+            hasMore: skip + data.length < totalCount,
+            search: {
+              title: searchTitle,
+              mdFile: searchMdFile,
+              file: searchFile,
+            },
+          },
+        };
       }
     }
   },
@@ -502,6 +480,18 @@ const DocumentService = {
           File,
         });
 
+        // Update file names if provided
+        if (req.body.mdFileName && document.mdFileId) {
+          await File.findByIdAndUpdate(document.mdFileId, { name: req.body.mdFileName });
+        }
+        if (req.body.fileName && document.fileId) {
+          await File.findByIdAndUpdate(document.fileId, { name: req.body.fileName });
+        }
+
+        // Remove file name fields from body as they are not part of Document schema
+        delete req.body.mdFileName;
+        delete req.body.fileName;
+
         // Extract 'public' from tags and set isPublic field on update
         const { isPublic, tags } = DocumentDto.extractPublicFromTags(req.body.tags);
         req.body.isPublic = isPublic;

package/src/cli/cluster.js

@@ -249,15 +249,11 @@ class UnderpostCluster {
         } else {
           // Kind cluster initialization (if not using kubeadm or k3s)
           logger.info('Initializing Kind cluster...');
-          if (options.full === true || options.dedicatedGpu === true) {
-            shellExec(`cd ${underpostRoot}/manifests && kind create cluster --config kind-config-cuda.yaml`);
-          } else {
-            shellExec(
-              `cd ${underpostRoot}/manifests && kind create cluster --config kind-config${
-                options?.dev === true ? '-dev' : ''
-              }.yaml`,
-            );
-          }
+          shellExec(
+            `cd ${underpostRoot}/manifests && kind create cluster --config kind-config${
+              options?.dev === true ? '-dev' : ''
+            }.yaml`,
+          );
           UnderpostCluster.API.chown('kind'); // Pass 'kind' to chown
         }
       } else if (options.worker === true) {

package/src/cli/repository.js

@@ -31,13 +31,13 @@ class UnderpostRepository {
     /**
      * Clones a Git repository from GitHub.
      * @param {string} [gitUri=`${process.env.GITHUB_USERNAME}/pwa-microservices-template`] - The URI of the GitHub repository (e.g., "username/repository").
-     * @param {object} [options={ bare: false, g8: false }] - Cloning options.
+     * @param {object} [options={ bare: false, G8: false }] - Cloning options.
      * @param {boolean} [options.bare=false] - If true, performs a bare clone.
      * @param {boolean} [options.g8=false] - If true, uses the .g8 extension.
      * @memberof UnderpostRepository
      */
-    clone(gitUri = `${process.env.GITHUB_USERNAME}/pwa-microservices-template`, options = { bare: false, g8: false }) {
-      const gExtension = options.g8 === true ? '.g8' : '.git';
+    clone(gitUri = `${process.env.GITHUB_USERNAME}/pwa-microservices-template`, options = { bare: false, G8: false }) {
+      const gExtension = options.G8 === true ? '.g8' : '.git';
       const repoName = gitUri.split('/').pop();
       if (fs.existsSync(`./${repoName}`)) fs.removeSync(`./${repoName}`);
       shellExec(
@@ -53,16 +53,16 @@ class UnderpostRepository {
      * Pulls updates from a GitHub repository.
      * @param {string} [repoPath='./'] - The local path to the repository.
      * @param {string} [gitUri=`${process.env.GITHUB_USERNAME}/pwa-microservices-template`] - The URI of the GitHub repository.
-     * @param {object} [options={ g8: false }] - Pulling options.
+     * @param {object} [options={ G8: false }] - Pulling options.
      * @param {boolean} [options.g8=false] - If true, uses the .g8 extension.
      * @memberof UnderpostRepository
      */
     pull(
       repoPath = './',
       gitUri = `${process.env.GITHUB_USERNAME}/pwa-microservices-template`,
-      options = { g8: false },
+      options = { G8: false },
     ) {
-      const gExtension = options.g8 === true ? '.g8' : '.git';
+      const gExtension = options.G8 === true ? '.g8' : '.git';
       shellExec(
         `cd ${repoPath} && git pull https://${
           process.env.GITHUB_TOKEN ? `${process.env.GITHUB_TOKEN}@` : ''
@@ -201,7 +201,7 @@ class UnderpostRepository {
      * Pushes commits to a remote GitHub repository.
      * @param {string} [repoPath='./'] - The local path to the repository.
      * @param {string} [gitUri=`${process.env.GITHUB_USERNAME}/pwa-microservices-template`] - The URI of the GitHub repository.
-     * @param {object} [options={ f: false, g8: false }] - Push options.
+     * @param {object} [options={ f: false, G8: false }] - Push options.
      * @param {boolean} [options.f=false] - If true, forces the push.
      * @param {boolean} [options.g8=false] - If true, uses the .g8 extension.
      * @memberof UnderpostRepository
@@ -209,9 +209,9 @@ class UnderpostRepository {
     push(
       repoPath = './',
       gitUri = `${process.env.GITHUB_USERNAME}/pwa-microservices-template`,
-      options = { f: false, g8: false },
+      options = { f: false, G8: false },
     ) {
-      const gExtension = options.g8 === true || options.G8 === true ? '.g8' : '.git';
+      const gExtension = options.G8 === true ? '.g8' : '.git';
       shellExec(
         `cd ${repoPath} && git push https://${process.env.GITHUB_TOKEN}@github.com/${gitUri}${gExtension}${
           options?.f === true ? ' --force' : ''

package/src/cli/run.js

@@ -146,111 +146,6 @@ class UnderpostRun {
    * @memberof UnderpostRun
    */
   static RUNNERS = {
-    /**
-     * @method spark-template
-     * @description Creates a new Spark template project using `sbt new` in `/home/dd/spark-template`, initializes a Git repository, and runs `replace_params.sh` and `build.sh`.
-     * @param {string} path - The input value, identifier, or path for the operation.
-     * @param {Object} options - The default underpost runner options for customizing workflow
-     * @memberof UnderpostRun
-     */
-    'spark-template': (path, options = UnderpostRun.DEFAULT_OPTION) => {
-      const dir = '/home/dd/spark-template';
-      shellExec(`sudo rm -rf ${dir}`);
-      shellCd('/home/dd');
-
-      // pbcopy(`cd /home/dd && sbt new ${process.env.GITHUB_USERNAME}/spark-template.g8`);
-      // await read({ prompt: 'Command copy to clipboard, press enter to continue.\n' });
-      shellExec(`cd /home/dd && sbt new ${process.env.GITHUB_USERNAME}/spark-template.g8 '--name=spark-template'`);
-
-      shellCd(dir);
-
-      shellExec(`git init && git add . && git commit -m "Base implementation"`);
-      shellExec(`chmod +x ./replace_params.sh`);
-      shellExec(`chmod +x ./build.sh`);
-
-      shellExec(`./replace_params.sh`);
-      shellExec(`./build.sh`);
-
-      shellCd('/home/dd/engine');
-    },
-    /**
-     * @method rmi
-     * @description Forces the removal of all local Podman images (`podman rmi $(podman images -qa) --force`).
-     * @param {string} path - The input value, identifier, or path for the operation.
-     * @param {Object} options - The default underpost runner options for customizing workflow
-     * @memberof UnderpostRun
-     */
-    rmi: (path, options = UnderpostRun.DEFAULT_OPTION) => {
-      shellExec(`podman rmi $(podman images -qa) --force`);
-    },
-    /**
-     * @method kill
-     * @description Kills processes listening on the specified port(s). If the `path` contains a `+`, it treats it as a range of ports to kill.
-     * @param {string} path - The input value, identifier, or path for the operation (used as the port number).
-     * @param {Object} options - The default underpost runner options for customizing workflow
-     * @memberof UnderpostRun
-     */
-    kill: (path = '', options = UnderpostRun.DEFAULT_OPTION) => {
-      if (options.pid) return shellExec(`sudo kill -9 ${options.pid}`);
-      for (const _path of path.split(',')) {
-        if (_path.split('+')[1]) {
-          let [port, sumPortOffSet] = _path.split('+');
-          port = parseInt(port);
-          sumPortOffSet = parseInt(sumPortOffSet);
-          for (const sumPort of range(0, sumPortOffSet))
-            shellExec(`sudo kill -9 $(lsof -t -i:${parseInt(port) + parseInt(sumPort)})`);
-        } else shellExec(`sudo kill -9 $(lsof -t -i:${_path})`);
-      }
-    },
-    /**
-     * @method secret
-     * @description Creates an Underpost secret named 'underpost' from a file, defaulting to `/home/dd/engine/engine-private/conf/dd-cron/.env.production` if no path is provided.
-     * @param {string} path - The input value, identifier, or path for the operation (used as the optional path to the secret file).
-     * @param {Object} options - The default underpost runner options for customizing workflow
-     * @memberof UnderpostRun
-     */
-    secret: (path, options = UnderpostRun.DEFAULT_OPTION) => {
-      shellExec(
-        `underpost secret underpost --create-from-file ${
-          path ? path : `/home/dd/engine/engine-private/conf/dd-cron/.env.production`
-        }`,
-      );
-    },
-    /**
-     * @method underpost-config
-     * @description Calls `UnderpostDeploy.API.configMap` to create a Kubernetes ConfigMap, defaulting to the 'production' environment.
-     * @param {string} path - The input value, identifier, or path for the operation (used as the optional configuration name/environment).
-     * @param {Object} options - The default underpost runner options for customizing workflow
-     * @memberof UnderpostRun
-     */
-    'underpost-config': (path = '', options = UnderpostRun.DEFAULT_OPTION) => {
-      UnderpostDeploy.API.configMap(path ? path : 'production', options.namespace);
-    },
-    /**
-     * @method gpu-env
-     * @description Sets up a dedicated GPU development environment cluster, resetting and then setting up the cluster with `--dedicated-gpu` and monitoring the pods.
-     * @param {string} path - The input value, identifier, or path for the operation.
-     * @param {Object} options - The default underpost runner options for customizing workflow
-     * @memberof UnderpostRun
-     */
-    'gpu-env': (path, options = UnderpostRun.DEFAULT_OPTION) => {
-      shellExec(
-        `node bin cluster --dev --reset && node bin cluster --dev --dedicated-gpu --kubeadm && kubectl get pods --all-namespaces -o wide -w`,
-      );
-    },
-    /**
-     * @method tf-gpu-test
-     * @description Deletes existing `tf-gpu-test-script` ConfigMap and `tf-gpu-test-pod`, and applies the test manifest from `manifests/deployment/tensorflow/tf-gpu-test.yaml`.
-     * @param {string} path - The input value, identifier, or path for the operation.
-     * @param {Object} options - The default underpost runner options for customizing workflow
-     * @memberof UnderpostRun
-     */
-    'tf-gpu-test': (path, options = UnderpostRun.DEFAULT_OPTION) => {
-      const { underpostRoot, namespace } = options;
-      shellExec(`kubectl delete configmap tf-gpu-test-script -n ${namespace} --ignore-not-found`);
-      shellExec(`kubectl delete pod tf-gpu-test-pod -n ${namespace} --ignore-not-found`);
-      shellExec(`kubectl apply -f ${underpostRoot}/manifests/deployment/tensorflow/tf-gpu-test.yaml -n ${namespace}`);
-    },
     /**
      * @method dev-cluster
      * @description Resets and deploys a full development cluster including MongoDB, Valkey, exposes services, and updates `/etc/hosts` for local access.
@@ -899,7 +794,7 @@ EOF
     'host-update': async (path, options = UnderpostRun.DEFAULT_OPTION) => {
       // const baseCommand = options.dev ? 'node bin' : 'underpost';
       shellExec(`chmod +x ${options.underpostRoot}/scripts/rocky-setup.sh`);
-      shellExec(`${options.underpostRoot}/scripts/rocky-setup.sh --yes${options.dev ? ' --install-dev' : ``}`);
+      shellExec(`${options.underpostRoot}/scripts/rocky-setup.sh${options.dev ? ' --install-dev' : ``}`);
     },
 
     /**
@@ -1600,6 +1495,113 @@ EOF
         ],
       });
     },
+
+    /**
+     * @method spark-template
+     * @description Creates a new Spark template project using `sbt new` in `/home/dd/spark-template`, initializes a Git repository, and runs `replace_params.sh` and `build.sh`.
+     * @param {string} path - The input value, identifier, or path for the operation.
+     * @param {Object} options - The default underpost runner options for customizing workflow
+     * @memberof UnderpostRun
+     */
+    'spark-template': (path, options = UnderpostRun.DEFAULT_OPTION) => {
+      const dir = '/home/dd/spark-template';
+      shellExec(`sudo rm -rf ${dir}`);
+      shellCd('/home/dd');
+
+      // pbcopy(`cd /home/dd && sbt new ${process.env.GITHUB_USERNAME}/spark-template.g8`);
+      // await read({ prompt: 'Command copy to clipboard, press enter to continue.\n' });
+      shellExec(`cd /home/dd && sbt new ${process.env.GITHUB_USERNAME}/spark-template.g8 '--name=spark-template'`);
+
+      shellCd(dir);
+
+      shellExec(`git init && git add . && git commit -m "Base implementation"`);
+      shellExec(`chmod +x ./replace_params.sh`);
+      shellExec(`chmod +x ./build.sh`);
+
+      shellExec(`./replace_params.sh`);
+      shellExec(`./build.sh`);
+
+      shellCd('/home/dd/engine');
+    },
+    /**
+     * @method rmi
+     * @description Forces the removal of all local Podman images (`podman rmi $(podman images -qa) --force`).
+     * @param {string} path - The input value, identifier, or path for the operation.
+     * @param {Object} options - The default underpost runner options for customizing workflow
+     * @memberof UnderpostRun
+     */
+    rmi: (path, options = UnderpostRun.DEFAULT_OPTION) => {
+      shellExec(`podman rmi $(podman images -qa) --force`);
+    },
+    /**
+     * @method kill
+     * @description Kills processes listening on the specified port(s). If the `path` contains a `+`, it treats it as a range of ports to kill.
+     * @param {string} path - The input value, identifier, or path for the operation (used as the port number).
+     * @param {Object} options - The default underpost runner options for customizing workflow
+     * @memberof UnderpostRun
+     */
+    kill: (path = '', options = UnderpostRun.DEFAULT_OPTION) => {
+      if (options.pid) return shellExec(`sudo kill -9 ${options.pid}`);
+      for (const _path of path.split(',')) {
+        if (_path.split('+')[1]) {
+          let [port, sumPortOffSet] = _path.split('+');
+          port = parseInt(port);
+          sumPortOffSet = parseInt(sumPortOffSet);
+          for (const sumPort of range(0, sumPortOffSet))
+            shellExec(`sudo kill -9 $(lsof -t -i:${parseInt(port) + parseInt(sumPort)})`);
+        } else shellExec(`sudo kill -9 $(lsof -t -i:${_path})`);
+      }
+    },
+    /**
+     * @method secret
+     * @description Creates an Underpost secret named 'underpost' from a file, defaulting to `/home/dd/engine/engine-private/conf/dd-cron/.env.production` if no path is provided.
+     * @param {string} path - The input value, identifier, or path for the operation (used as the optional path to the secret file).
+     * @param {Object} options - The default underpost runner options for customizing workflow
+     * @memberof UnderpostRun
+     */
+    secret: (path, options = UnderpostRun.DEFAULT_OPTION) => {
+      const secretPath = path ? path : `/home/dd/engine/engine-private/conf/dd-cron/.env.production`;
+      const command = options.dev
+        ? `node bin secret underpost --create-from-file ${secretPath}`
+        : `underpost secret underpost --create-from-file ${secretPath}`;
+      shellExec(command);
+    },
+    /**
+     * @method underpost-config
+     * @description Calls `UnderpostDeploy.API.configMap` to create a Kubernetes ConfigMap, defaulting to the 'production' environment.
+     * @param {string} path - The input value, identifier, or path for the operation (used as the optional configuration name/environment).
+     * @param {Object} options - The default underpost runner options for customizing workflow
+     * @memberof UnderpostRun
+     */
+    'underpost-config': (path = '', options = UnderpostRun.DEFAULT_OPTION) => {
+      UnderpostDeploy.API.configMap(path ? path : 'production', options.namespace);
+    },
+    /**
+     * @method gpu-env
+     * @description Sets up a dedicated GPU development environment cluster, resetting and then setting up the cluster with `--dedicated-gpu` and monitoring the pods.
+     * @param {string} path - The input value, identifier, or path for the operation.
+     * @param {Object} options - The default underpost runner options for customizing workflow
+     * @memberof UnderpostRun
+     */
+    'gpu-env': (path, options = UnderpostRun.DEFAULT_OPTION) => {
+      shellExec(
+        `node bin cluster --dev --reset && node bin cluster --dev --dedicated-gpu --kubeadm && kubectl get pods --all-namespaces -o wide -w`,
+      );
+    },
+    /**
+     * @method tf-gpu-test
+     * @description Deletes existing `tf-gpu-test-script` ConfigMap and `tf-gpu-test-pod`, and applies the test manifest from `manifests/deployment/tensorflow/tf-gpu-test.yaml`.
+     * @param {string} path - The input value, identifier, or path for the operation.
+     * @param {Object} options - The default underpost runner options for customizing workflow
+     * @memberof UnderpostRun
+     */
+    'tf-gpu-test': (path, options = UnderpostRun.DEFAULT_OPTION) => {
+      const { underpostRoot, namespace } = options;
+      shellExec(`kubectl delete configmap tf-gpu-test-script -n ${namespace} --ignore-not-found`);
+      shellExec(`kubectl delete pod tf-gpu-test-pod -n ${namespace} --ignore-not-found`);
+      shellExec(`kubectl apply -f ${underpostRoot}/manifests/deployment/tensorflow/tf-gpu-test.yaml -n ${namespace}`);
+    },
+
     /**
      * @method deploy-job
      * @description Creates and applies a custom Kubernetes Pod manifest (Job) for running arbitrary commands inside a container image (defaulting to a TensorFlow/NVIDIA image).

package/src/client/components/core/Auth.js

@@ -11,6 +11,7 @@ import { loggerFactory } from './Logger.js';
 import { LogIn } from './LogIn.js';
 import { LogOut } from './LogOut.js';
 import { NotificationManager } from './NotificationManager.js';
+import { SearchBox } from './SearchBox.js';
 import { Translate } from './Translate.js';
 import { s } from './VanillaJs.js';
 
@@ -267,6 +268,7 @@ class Auth {
     try {
       const result = await UserService.delete({ id: 'logout' });
       localStorage.removeItem('jwt');
+      SearchBox.RecentResults.clear();
       this.deleteToken();
       if (this.#refreshTimeout) {
         clearTimeout(this.#refreshTimeout);