@gitsense/gsc-utils 0.2.14 → 0.2.16

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gitsense/gsc-utils",
-  "version": "0.2.14",
+  "version": "0.2.16",
   "description": "Utilities for GitSense Chat (GSC)",
   "main": "dist/gsc-utils.cjs.js",
   "module": "dist/gsc-utils.esm.js",

package/src/AnalyzerUtils/defaultPromptLoader.js

@@ -1,6 +1,6 @@
 /*
  * Component: AnalyzerUtils Default Prompt Loader
- * Block-UUID: 0b1c2d3e-4f5a-6b7c-8d9e-0f1a2b3c4d5f
+ * Block-UUID: be863744-6461-4b94-97ce-b1d177e9e881
  * Parent-UUID: N/A
  * Version: 1.0.0
  * Description: Provides utility functions for loading shared, default prompt components (system and start messages).

package/src/AnalyzerUtils/discovery.js

@@ -1,17 +1,18 @@
 /*
  * Component: AnalyzerUtils Discovery
- * Block-UUID: 0b1c2d3e-4f5a-6b7c-8d9e-0f1a2b3c4d5f
- * Parent-UUID: N/A
- * Version: 1.0.0
+ * Block-UUID: a87a86c4-69fc-4cbb-80a8-857f56122395
+ * Parent-UUID: 0b1c2d3e-4f5a-6b7c-8d9e-0f1a2b3c4d5f
+ * Version: 1.1.0
  * Description: Provides utility functions for discovering available analyzers.
  * Language: JavaScript
  * Created-at: 2025-08-28T23:48:00.000Z
- * Authors: Gemini 2.5 Flash (v1.0.0)
+ * Authors: Gemini 2.5 Flash (v1.0.0), Gemini 2.5 Flash (v1.1.0)
  */
 
 
 const fs = require('fs').promises;
 const path = require('path');
+const { getAnalyzerInstructionsContent } = require('./instructionLoader');
 
 /**
  * Reads and parses the config.json file in a directory.
@@ -53,9 +54,12 @@ function isValidDirName(name) {
  * An analyzer is considered valid if a '1.md' file exists in the instructions directory.
  *
  * @param {string} analyzeMessagesBasePath - The absolute or relative path to the base directory containing the analyzer message files (e.g., 'messages/analyze').
- * @returns {Promise<Array<{id: string, label: string}>>} A promise that resolves to an array of analyzer objects.
+ * @param {object} [options={}] - Optional configuration.
+ * @param {boolean} [options.includeDescription=false] - Whether to include the description of the analyzer.
+ * @returns {Promise<Array<{id: string, label: string, name: string, protected: boolean, description?: string}>>} A promise that resolves to an array of analyzer objects.
  */
-async function getAnalyzers(analyzeMessagesBasePath) {
+async function getAnalyzers(analyzeMessagesBasePath, options = {}) {
+    const { includeDescription = false } = options;
     const analyzers = [];
 
     try {
@@ -106,11 +110,23 @@ async function getAnalyzers(analyzeMessagesBasePath) {
                                     const analyzerId = `${analyzerName}::${contentType}::${instructionsType}`;
                                     const analyzerFullLabel = `${analyzerLabel} (${contentLabel} - ${instructionsLabel})`;
 
+                                    let descriptionContent = null;
+                                    if (includeDescription) {
+                                        try {
+                                            descriptionContent = await getAnalyzerInstructionsContent(analyzeMessagesBasePath, analyzerId);
+                                        } catch (descError) {
+                                            console.warn(`Warning: Could not load description for ${analyzerId}: ${descError.message}`);
+                                            descriptionContent = null;
+                                        }
+                                    }
+
                                     analyzers.push({
                                         id: analyzerId,
                                         label: analyzerFullLabel,
-                                        protected: analyzerConfig?.protected || false
-                                    });
+                                        name: analyzerName,
+                                        protected: analyzerConfig?.protected || false,
+                                        ...(descriptionContent && { description: descriptionContent })
+                                     });
                                 } catch (error) {
                                     // If 1.md doesn't exist, this is not a complete analyzer configuration, skip.
                                     if (error.code !== 'ENOENT') {

package/src/AnalyzerUtils/instructionLoader.js

@@ -41,7 +41,9 @@ async function getAnalyzerInstructionsContent(analyzeMessagesBasePath, analyzerI
 
     try {
         const fileContent = await fs.readFile(instructionsFilePath, 'utf8');
-        return fileContent;
+        const parts = fileContent.split('\n\n\n');
+        parts.shift();
+        return parts.join('\n\n\n');
     } catch (error) {
         if (error.code === 'ENOENT') {
             console.warn(`Analyzer instructions file not found: ${instructionsFilePath}`);

package/src/GSToolBlockUtils.js

@@ -1,15 +1,18 @@
 /**
  * Component: GitSense Tool Block Utilities
- * Block-UUID: 72db6a5f-3b09-49e8-8f39-d4e3d37b510a
- * Parent-UUID: N/A
- * Version: 1.0.0
- * Description: Provides utility functions for identifying and parsing GitSense Chat Tool Blocks.
+ * Block-UUID: 8e1f7b4e-7e30-48b4-a7fc-643bf647661f
+ * Parent-UUID: 72db6a5f-3b09-49e8-8f39-d4e3d37b510a
+ * Version: 1.1.0
+ * Description: Provides utility functions for identifying and parsing GitSense Chat Tool Blocks, and now for replacing them within markdown.
  * Language: JavaScript
- * Created-at: 2025-04-27T01:29:53.576Z
- * Authors: Gemini 2.5 Pro (v1.0.0)
+ * Created-at: 2025-09-12T17:23:34.779Z
+ * Authors: Gemini 2.5 Pro (v1.0.0), Gemini 2.5 Flash (v1.1.0)
  */
 
 
+const { updateCodeBlockByIndex } = require('./CodeBlockUtils/updateCodeBlock');
+const { processCodeBlocks } = require('./CodeBlockUtils/blockProcessor');
+
 /**
  * Checks if a given code block content represents a GitSense Chat Tool Block.
  * It verifies if the first non-empty line starts with "# GitSense Chat Tool".
@@ -97,12 +100,68 @@ function parseToolBlock(content) {
     }
 }
 
+/**
+ * Formats tool data into a GitSense Chat Tool Block string.
+ *
+ * @param {object} toolData - The tool data object to format.
+ * @returns {string} The formatted GitSense Chat Tool Block string.
+ */
 function formatToolBlock(toolData) {
     return `# GitSense Chat Tool\n\n${JSON.stringify(toolData, null, 2)}`;
 }
 
+/**
+ * Replaces a specific GitSense Chat Tool Block within a markdown string with updated tool data.
+ * This function leverages CodeBlockUtils for robust parsing and updating.
+ *
+ * @param {string} markdownContent - The original markdown string containing code blocks.
+ * @param {string} toolName - The 'tool' property value of the target GitSense Chat Tool Block to replace.
+ * @param {Object} newToolData - The new tool data object to insert into the block.
+ * @returns {string} The markdown content with the specified tool block updated.
+ * @throws {Error} If the target tool block is not found or if CodeBlockUtils encounters an error.
+ */
+function replaceToolBlock(markdownContent, toolName, newToolData) {
+    if (typeof markdownContent !== 'string' || !toolName || !newToolData) {
+        throw new Error("Missing required parameters for replaceToolBlock.");
+    }
+
+    // 1. Process the markdown content to find all code blocks
+    const { blocks, warnings } = processCodeBlocks(markdownContent, { silent: true });
+
+    let targetBlockIndex = -1;
+
+    // 2. Iterate through the processed blocks to find the target GitSense Chat Tool Block
+    for (let i = 0; i < blocks.length; i++) {
+        const block = blocks[i];
+        if (block.type === 'gs-tool' && block.toolData && block.toolData.tool === toolName) {
+            targetBlockIndex = i;
+            break; // Found the first matching tool block
+        }
+    }
+
+    if (targetBlockIndex === -1) {
+        console.warn(`replaceToolBlock: No GitSense Chat Tool Block with name "${toolName}" found to replace.`);
+        return markdownContent; // Return original content if no replacement occurred
+    }
+
+    // 3. Format the new tool data into the content that goes *inside* the fences
+    const newContentBetweenFences = formatToolBlock(newToolData);
+
+    // 4. Use CodeBlockUtils.updateCodeBlockByIndex to perform the replacement
+    // The language for GitSense Tool Blocks is always 'txt'
+    const updatedMarkdown = updateCodeBlockByIndex(
+        markdownContent,
+        targetBlockIndex,
+        newContentBetweenFences,
+        'txt'
+    );
+
+    return updatedMarkdown;
+}
+
 module.exports = {
     isToolBlock,
     parseToolBlock,
-    formatToolBlock
+    formatToolBlock,
+    replaceToolBlock,
 }