@gitsense/gsc-utils 0.2.15 → 0.2.17

package/dist/gsc-utils.cjs.js

@@ -8684,13 +8684,13 @@ var PatchUtils$2 = {
 
 /**
  * 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)
  */
 
 /**
@@ -8780,14 +8780,75 @@ function parseToolBlock$1(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, processCodeBlocks, updateCodeBlockByIndex) {
+    if (typeof markdownContent !== 'string' || !toolName || !newToolData) {
+        throw new Error("Missing required parameters for replaceToolBlock.");
+    }
+
+    // We can't require them as this will create a circular dependency
+    if (!processCodeBlocks || !updateCodeBlockByIndex) {
+        throw new Error("Missing required dependencies processCodeBlocks and/or updateCodeBlockByIndex.");
+    }
+
+    // 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;
+}
+
 var GSToolBlockUtils$3 = {
     isToolBlock: isToolBlock$1,
     parseToolBlock: parseToolBlock$1,
-    formatToolBlock
+    formatToolBlock,
+    replaceToolBlock,
 };
 
 /*
@@ -11072,11 +11133,11 @@ var dataValidator = {
 };
 
 /*
- * Component: AnalyzerUtils Discovery
- * Block-UUID: 0b1c2d3e-4f5a-6b7c-8d9e-0f1a2b3c4d5f
+ * Component: AnalyzerUtils Instruction Loader
+ * Block-UUID: 0a1b2c3d-4e5f-6a7b-8c9d-0e1f2a3b4c5e
  * Parent-UUID: N/A
  * Version: 1.0.0
- * Description: Provides utility functions for discovering available analyzers.
+ * Description: Provides utility functions for loading raw analyzer instruction content.
  * Language: JavaScript
  * Created-at: 2025-08-28T23:48:00.000Z
  * Authors: Gemini 2.5 Flash (v1.0.0)
@@ -11085,6 +11146,67 @@ var dataValidator = {
 const fs$7 = require$$0.promises;
 const path$5 = require$$1;
 
+/**
+ * Retrieves the raw Markdown content of the analyzer's '1.md' instruction file.
+ *
+ * @param {string} analyzeMessagesBasePath - The absolute path to the base directory containing the analyzer message files (e.g., 'messages/analyze').
+ * @param {string} analyzerId - The unique ID of the analyzer (format: 'analyzer_name::content_type::instructions_type').
+ * @returns {Promise<string|null>} A promise that resolves with the full Markdown content of the '1.md' file, or null if not found/invalid.
+ */
+async function getAnalyzerInstructionsContent$3(analyzeMessagesBasePath, analyzerId) {
+    if (typeof analyzeMessagesBasePath !== 'string' || analyzeMessagesBasePath.trim() === '') {
+        console.error('Error: analyzeMessagesBasePath is required.');
+        return null;
+    }
+    if (typeof analyzerId !== 'string' || analyzerId.trim() === '') {
+        console.error('Error: analyzerId is required.');
+        return null;
+    }
+
+    const parts = analyzerId.split('::');
+    if (parts.length !== 3) {
+        console.error(`Error: Invalid analyzerId format. Expected 'analyzer_name::content_type::instructions_type', but got '${analyzerId}'.`);
+        return null;
+    }
+    const [analyzerName, contentType, instructionsType] = parts;
+
+    const instructionsFilePath = path$5.join(analyzeMessagesBasePath, analyzerName, contentType, instructionsType, '1.md');
+
+    try {
+        const fileContent = await fs$7.readFile(instructionsFilePath, 'utf8');
+        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}`);
+            return null;
+        } else {
+            console.error(`Error reading analyzer instructions file ${instructionsFilePath}: ${error.message}`);
+            throw error;
+        }
+    }
+}
+
+var instructionLoader = {
+    getAnalyzerInstructionsContent: getAnalyzerInstructionsContent$3
+};
+
+/*
+ * Component: AnalyzerUtils Discovery
+ * 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), Gemini 2.5 Flash (v1.1.0)
+ */
+
+const fs$6 = require$$0.promises;
+const path$4 = require$$1;
+const { getAnalyzerInstructionsContent: getAnalyzerInstructionsContent$2 } = instructionLoader;
+
 /**
  * Reads and parses the config.json file in a directory.
  * @param {string} dirPath - The path to the directory.
@@ -11092,9 +11214,9 @@ const path$5 = require$$1;
  *                                 or null if the file doesn't exist or is invalid.
  */
 async function readConfig$1(dirPath) {
-    const configPath = path$5.join(dirPath, 'config.json');
+    const configPath = path$4.join(dirPath, 'config.json');
     try {
-        const fileContent = await fs$7.readFile(configPath, 'utf8');
+        const fileContent = await fs$6.readFile(configPath, 'utf8');
         return JSON.parse(fileContent);
     } catch (error) {
         if (error.code !== 'ENOENT') {
@@ -11125,47 +11247,50 @@ 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$2(analyzeMessagesBasePath) {
+async function getAnalyzers$2(analyzeMessagesBasePath, options = {}) {
+    const { includeDescription = false } = options;
     const analyzers = [];
 
     try {
-        const analyzerEntries = await fs$7.readdir(analyzeMessagesBasePath, { withFileTypes: true });
+        const analyzerEntries = await fs$6.readdir(analyzeMessagesBasePath, { withFileTypes: true });
 
         for (const analyzerEntry of analyzerEntries) {
             if (analyzerEntry.isDirectory() && isValidDirName(analyzerEntry.name)) {
                 const analyzerName = analyzerEntry.name;
-                const analyzerPath = path$5.join(analyzeMessagesBasePath, analyzerName);
+                const analyzerPath = path$4.join(analyzeMessagesBasePath, analyzerName);
                 const analyzerConfig = await readConfig$1(analyzerPath);
                 const analyzerLabel = analyzerConfig?.label || analyzerName;
 
-                const contentEntries = await fs$7.readdir(analyzerPath, { withFileTypes: true });
+                const contentEntries = await fs$6.readdir(analyzerPath, { withFileTypes: true });
 
                 for (const contentEntry of contentEntries) {
                     if (contentEntry.isDirectory() && isValidDirName(contentEntry.name)) {
                         const contentType = contentEntry.name;
-                        const contentPath = path$5.join(analyzerPath, contentType);
+                        const contentPath = path$4.join(analyzerPath, contentType);
                         const contentConfig = await readConfig$1(contentPath);
                         const contentLabel = contentConfig?.label || contentType;
 
-                        const instructionsEntries = await fs$7.readdir(contentPath, { withFileTypes: true });
+                        const instructionsEntries = await fs$6.readdir(contentPath, { withFileTypes: true });
 
                         for (const instructionsEntry of instructionsEntries) {
                             if (instructionsEntry.isDirectory() && isValidDirName(instructionsEntry.name)) {
                                 const instructionsType = instructionsEntry.name;
-                                const instructionsPath = path$5.join(contentPath, instructionsType);
+                                const instructionsPath = path$4.join(contentPath, instructionsType);
                                 const instructionsConfig = await readConfig$1(instructionsPath);
                                 const instructionsLabel = instructionsConfig?.label || instructionsType;
 
                                 // Check for the existence of 1.md to confirm a valid analyzer configuration
-                                const instructionsFilePath = path$5.join(instructionsPath, '1.md');
+                                const instructionsFilePath = path$4.join(instructionsPath, '1.md');
                                 try {
-                                    await fs$7.access(instructionsFilePath); // Check if file exists and is accessible
+                                    await fs$6.access(instructionsFilePath); // Check if file exists and is accessible
 
                                     // If analyzerName starts with 'tutorial-', check its last modified time.
                                     if (analyzerName.startsWith('tutorial-')) {
-                                        const stats = await fs$7.stat(instructionsFilePath);
+                                        const stats = await fs$6.stat(instructionsFilePath);
                                         const lastModified = stats.mtime.getTime(); // Get timestamp in milliseconds
                                         const sixtyMinutesAgo = Date.now() - (60 * 60 * 1000); // Current time - 60 minutes in ms
 
@@ -11178,11 +11303,23 @@ async function getAnalyzers$2(analyzeMessagesBasePath) {
                                     const analyzerId = `${analyzerName}::${contentType}::${instructionsType}`;
                                     const analyzerFullLabel = `${analyzerLabel} (${contentLabel} - ${instructionsLabel})`;
 
+                                    let descriptionContent = null;
+                                    if (includeDescription) {
+                                        try {
+                                            descriptionContent = await getAnalyzerInstructionsContent$2(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') {
@@ -11219,8 +11356,8 @@ var discovery = {
  * Authors: Gemini 2.5 Flash Thinking (v1.0.0), Gemini 2.5 Flash Thinking (v1.1.0)
  */
 
-const fs$6 = require$$0.promises;
-const path$4 = require$$1;
+const fs$5 = require$$0.promises;
+const path$3 = require$$1;
 
 /**
  * Saves or updates an analyzer configuration.
@@ -11275,18 +11412,18 @@ async function saveConfiguration$1(analyzeMessagesBasePath, analyzerId, instruct
     }
 
     // 3. Construct directory paths
-    const analyzerDir = path$4.join(analyzeMessagesBasePath, analyzerName);
-    const contentDir = path$4.join(analyzerDir, contentType);
-    const instructionsDir = path$4.join(contentDir, instructionsType);
-    const instructionsFilePath = path$4.join(instructionsDir, '1.md');
+    const analyzerDir = path$3.join(analyzeMessagesBasePath, analyzerName);
+    const contentDir = path$3.join(analyzerDir, contentType);
+    const instructionsDir = path$3.join(contentDir, instructionsType);
+    const instructionsFilePath = path$3.join(instructionsDir, '1.md');
 
     try {
         // 4. Create directories recursively
-        await fs$6.mkdir(instructionsDir, { recursive: true });
+        await fs$5.mkdir(instructionsDir, { recursive: true });
 
         // 5. Save instructions content to 1.md
         const finalContent = `; role: assistant\n\n\n${instructionsContent}`; 
-        await fs$6.writeFile(instructionsFilePath, finalContent, 'utf8');
+        await fs$5.writeFile(instructionsFilePath, finalContent, 'utf8');
 
         // 6. Optionally create/Update config.json files
         if (ensureConfigs) {
@@ -11312,11 +11449,11 @@ async function saveConfiguration$1(analyzeMessagesBasePath, analyzerId, instruct
  * @param {string} label - The label to ensure is in the config.json.
  */
 async function ensureConfigJson(dirPath, label) {
-    const configPath = path$4.join(dirPath, 'config.json');
+    const configPath = path$3.join(dirPath, 'config.json');
     let config = {};
 
     try {
-        const fileContent = await fs$6.readFile(configPath, 'utf8');
+        const fileContent = await fs$5.readFile(configPath, 'utf8');
         config = JSON.parse(fileContent);
     } catch (error) {
         // If file doesn't exist or parsing fails, start with an empty config
@@ -11333,7 +11470,7 @@ async function ensureConfigJson(dirPath, label) {
     }
 
     // Write the updated config back to the file
-    await fs$6.writeFile(configPath, JSON.stringify(config, null, 4), 'utf8');
+    await fs$5.writeFile(configPath, JSON.stringify(config, null, 4), 'utf8');
 }
 
 
@@ -11352,8 +11489,8 @@ var saver = {
  * Authors: Gemini 2.5 Flash (v1.0.0)
  */
 
-const fs$5 = require$$0.promises;
-const path$3 = require$$1;
+const fs$4 = require$$0.promises;
+const path$2 = require$$1;
 const CodeBlockUtils$1 = CodeBlockUtils$4;
 
 /**
@@ -11439,10 +11576,10 @@ async function getAnalyzerSchema$2(analyzeMessagesBasePath, analyzerId) {
     }
     const [analyzerName, contentType, instructionsType] = parts;
 
-    const instructionsFilePath = path$3.join(analyzeMessagesBasePath, analyzerName, contentType, instructionsType, '1.md');
+    const instructionsFilePath = path$2.join(analyzeMessagesBasePath, analyzerName, contentType, instructionsType, '1.md');
 
     try {
-        const fileContent = await fs$5.readFile(instructionsFilePath, 'utf8');
+        const fileContent = await fs$4.readFile(instructionsFilePath, 'utf8');
         const { blocks } = CodeBlockUtils$1.extractCodeBlocks(fileContent, { silent: true });
         const jsonBlocks = blocks.filter(block => block.type === 'code' && block.language === 'json');
 
@@ -11513,8 +11650,8 @@ var schemaLoader = {
  * Authors: Gemini 2.5 Flash (v1.0.0)
  */
 
-const fs$4 = require$$0.promises;
-const path$2 = require$$1;
+const fs$3 = require$$0.promises;
+const path$1 = require$$1;
 const { readConfig } = discovery; // Import helper from discovery
 
 /**
@@ -11524,7 +11661,7 @@ const { readConfig } = discovery; // Import helper from discovery
  */
 async function isDirectoryEmpty(dirPath) {
     try {
-        const files = await fs$4.readdir(dirPath);
+        const files = await fs$3.readdir(dirPath);
         return files.length === 0 || (files.length === 1 && files[0] === 'config.json');
     } catch (error) {
         if (error.code === 'ENOENT') {
@@ -11555,10 +11692,10 @@ async function deleteAnalyzer$2(analyzeMessagesBasePath, analyzerId) {
     }
     const [analyzerName, contentType, instructionsType] = parts;
 
-    const analyzerDir = path$2.join(analyzeMessagesBasePath, analyzerName);
-    const contentDir = path$2.join(analyzerDir, contentType);
-    const instructionsDir = path$2.join(contentDir, instructionsType);
-    const instructionsFilePath = path$2.join(instructionsDir, '1.md');
+    const analyzerDir = path$1.join(analyzeMessagesBasePath, analyzerName);
+    const contentDir = path$1.join(analyzerDir, contentType);
+    const instructionsDir = path$1.join(contentDir, instructionsType);
+    const instructionsFilePath = path$1.join(instructionsDir, '1.md');
 
     try {
         // 1. Check for protection at all levels
@@ -11579,7 +11716,7 @@ async function deleteAnalyzer$2(analyzeMessagesBasePath, analyzerId) {
 
         // 2. Delete the 1.md file
         try {
-            await fs$4.unlink(instructionsFilePath);
+            await fs$3.unlink(instructionsFilePath);
         } catch (error) {
             if (error.code === 'ENOENT') {
                 return { success: false, message: `Analyzer instructions file not found: ${instructionsFilePath}. It may have already been deleted.` };
@@ -11593,7 +11730,7 @@ async function deleteAnalyzer$2(analyzeMessagesBasePath, analyzerId) {
         // Check and delete instructions directory
         if (await isDirectoryEmpty(instructionsDir)) {
             try {
-                await fs$4.rmdir(instructionsDir);
+                await fs$3.rmdir(instructionsDir);
                 deletedDirs.push(instructionsDir);
             } catch (error) {
                 console.warn(`Warning: Could not remove empty instructions directory ${instructionsDir}: ${error.message}`);
@@ -11603,7 +11740,7 @@ async function deleteAnalyzer$2(analyzeMessagesBasePath, analyzerId) {
         // Check and delete content directory
         if (await isDirectoryEmpty(contentDir)) {
             try {
-                await fs$4.rmdir(contentDir);
+                await fs$3.rmdir(contentDir);
                 deletedDirs.push(contentDir);
             } catch (error) {
                 console.warn(`Warning: Could not remove empty content directory ${contentDir}: ${error.message}`);
@@ -11613,7 +11750,7 @@ async function deleteAnalyzer$2(analyzeMessagesBasePath, analyzerId) {
         // Check and delete analyzer directory
         if (await isDirectoryEmpty(analyzerDir)) {
             try {
-                await fs$4.rmdir(analyzerDir);
+                await fs$3.rmdir(analyzerDir);
                 deletedDirs.push(analyzerDir);
             } catch (error) {
                 console.warn(`Warning: Could not remove empty analyzer directory ${analyzerDir}: ${error.message}`);
@@ -11631,69 +11768,9 @@ async function deleteAnalyzer$2(analyzeMessagesBasePath, analyzerId) {
 var management = {
     deleteAnalyzer: deleteAnalyzer$2};
 
-/*
- * Component: AnalyzerUtils Instruction Loader
- * Block-UUID: 0a1b2c3d-4e5f-6a7b-8c9d-0e1f2a3b4c5e
- * Parent-UUID: N/A
- * Version: 1.0.0
- * Description: Provides utility functions for loading raw analyzer instruction content.
- * Language: JavaScript
- * Created-at: 2025-08-28T23:48:00.000Z
- * Authors: Gemini 2.5 Flash (v1.0.0)
- */
-
-const fs$3 = require$$0.promises;
-const path$1 = require$$1;
-
-/**
- * Retrieves the raw Markdown content of the analyzer's '1.md' instruction file.
- *
- * @param {string} analyzeMessagesBasePath - The absolute path to the base directory containing the analyzer message files (e.g., 'messages/analyze').
- * @param {string} analyzerId - The unique ID of the analyzer (format: 'analyzer_name::content_type::instructions_type').
- * @returns {Promise<string|null>} A promise that resolves with the full Markdown content of the '1.md' file, or null if not found/invalid.
- */
-async function getAnalyzerInstructionsContent$2(analyzeMessagesBasePath, analyzerId) {
-    if (typeof analyzeMessagesBasePath !== 'string' || analyzeMessagesBasePath.trim() === '') {
-        console.error('Error: analyzeMessagesBasePath is required.');
-        return null;
-    }
-    if (typeof analyzerId !== 'string' || analyzerId.trim() === '') {
-        console.error('Error: analyzerId is required.');
-        return null;
-    }
-
-    const parts = analyzerId.split('::');
-    if (parts.length !== 3) {
-        console.error(`Error: Invalid analyzerId format. Expected 'analyzer_name::content_type::instructions_type', but got '${analyzerId}'.`);
-        return null;
-    }
-    const [analyzerName, contentType, instructionsType] = parts;
-
-    const instructionsFilePath = path$1.join(analyzeMessagesBasePath, analyzerName, contentType, instructionsType, '1.md');
-
-    try {
-        const fileContent = await fs$3.readFile(instructionsFilePath, 'utf8');
-        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}`);
-            return null;
-        } else {
-            console.error(`Error reading analyzer instructions file ${instructionsFilePath}: ${error.message}`);
-            throw error;
-        }
-    }
-}
-
-var instructionLoader = {
-    getAnalyzerInstructionsContent: getAnalyzerInstructionsContent$2
-};
-
 /*
  * 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/dist/gsc-utils.esm.js

@@ -8682,13 +8682,13 @@ var PatchUtils$2 = {
 
 /**
  * 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)
  */
 
 /**
@@ -8778,14 +8778,75 @@ function parseToolBlock$1(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, processCodeBlocks, updateCodeBlockByIndex) {
+    if (typeof markdownContent !== 'string' || !toolName || !newToolData) {
+        throw new Error("Missing required parameters for replaceToolBlock.");
+    }
+
+    // We can't require them as this will create a circular dependency
+    if (!processCodeBlocks || !updateCodeBlockByIndex) {
+        throw new Error("Missing required dependencies processCodeBlocks and/or updateCodeBlockByIndex.");
+    }
+
+    // 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;
+}
+
 var GSToolBlockUtils$3 = {
     isToolBlock: isToolBlock$1,
     parseToolBlock: parseToolBlock$1,
-    formatToolBlock
+    formatToolBlock,
+    replaceToolBlock,
 };
 
 /*
@@ -11070,11 +11131,11 @@ var dataValidator = {
 };
 
 /*
- * Component: AnalyzerUtils Discovery
- * Block-UUID: 0b1c2d3e-4f5a-6b7c-8d9e-0f1a2b3c4d5f
+ * Component: AnalyzerUtils Instruction Loader
+ * Block-UUID: 0a1b2c3d-4e5f-6a7b-8c9d-0e1f2a3b4c5e
  * Parent-UUID: N/A
  * Version: 1.0.0
- * Description: Provides utility functions for discovering available analyzers.
+ * Description: Provides utility functions for loading raw analyzer instruction content.
  * Language: JavaScript
  * Created-at: 2025-08-28T23:48:00.000Z
  * Authors: Gemini 2.5 Flash (v1.0.0)
@@ -11083,6 +11144,67 @@ var dataValidator = {
 const fs$7 = require$$0.promises;
 const path$5 = require$$1;
 
+/**
+ * Retrieves the raw Markdown content of the analyzer's '1.md' instruction file.
+ *
+ * @param {string} analyzeMessagesBasePath - The absolute path to the base directory containing the analyzer message files (e.g., 'messages/analyze').
+ * @param {string} analyzerId - The unique ID of the analyzer (format: 'analyzer_name::content_type::instructions_type').
+ * @returns {Promise<string|null>} A promise that resolves with the full Markdown content of the '1.md' file, or null if not found/invalid.
+ */
+async function getAnalyzerInstructionsContent$3(analyzeMessagesBasePath, analyzerId) {
+    if (typeof analyzeMessagesBasePath !== 'string' || analyzeMessagesBasePath.trim() === '') {
+        console.error('Error: analyzeMessagesBasePath is required.');
+        return null;
+    }
+    if (typeof analyzerId !== 'string' || analyzerId.trim() === '') {
+        console.error('Error: analyzerId is required.');
+        return null;
+    }
+
+    const parts = analyzerId.split('::');
+    if (parts.length !== 3) {
+        console.error(`Error: Invalid analyzerId format. Expected 'analyzer_name::content_type::instructions_type', but got '${analyzerId}'.`);
+        return null;
+    }
+    const [analyzerName, contentType, instructionsType] = parts;
+
+    const instructionsFilePath = path$5.join(analyzeMessagesBasePath, analyzerName, contentType, instructionsType, '1.md');
+
+    try {
+        const fileContent = await fs$7.readFile(instructionsFilePath, 'utf8');
+        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}`);
+            return null;
+        } else {
+            console.error(`Error reading analyzer instructions file ${instructionsFilePath}: ${error.message}`);
+            throw error;
+        }
+    }
+}
+
+var instructionLoader = {
+    getAnalyzerInstructionsContent: getAnalyzerInstructionsContent$3
+};
+
+/*
+ * Component: AnalyzerUtils Discovery
+ * 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), Gemini 2.5 Flash (v1.1.0)
+ */
+
+const fs$6 = require$$0.promises;
+const path$4 = require$$1;
+const { getAnalyzerInstructionsContent: getAnalyzerInstructionsContent$2 } = instructionLoader;
+
 /**
  * Reads and parses the config.json file in a directory.
  * @param {string} dirPath - The path to the directory.
@@ -11090,9 +11212,9 @@ const path$5 = require$$1;
  *                                 or null if the file doesn't exist or is invalid.
  */
 async function readConfig$1(dirPath) {
-    const configPath = path$5.join(dirPath, 'config.json');
+    const configPath = path$4.join(dirPath, 'config.json');
     try {
-        const fileContent = await fs$7.readFile(configPath, 'utf8');
+        const fileContent = await fs$6.readFile(configPath, 'utf8');
         return JSON.parse(fileContent);
     } catch (error) {
         if (error.code !== 'ENOENT') {
@@ -11123,47 +11245,50 @@ 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$2(analyzeMessagesBasePath) {
+async function getAnalyzers$2(analyzeMessagesBasePath, options = {}) {
+    const { includeDescription = false } = options;
     const analyzers = [];
 
     try {
-        const analyzerEntries = await fs$7.readdir(analyzeMessagesBasePath, { withFileTypes: true });
+        const analyzerEntries = await fs$6.readdir(analyzeMessagesBasePath, { withFileTypes: true });
 
         for (const analyzerEntry of analyzerEntries) {
             if (analyzerEntry.isDirectory() && isValidDirName(analyzerEntry.name)) {
                 const analyzerName = analyzerEntry.name;
-                const analyzerPath = path$5.join(analyzeMessagesBasePath, analyzerName);
+                const analyzerPath = path$4.join(analyzeMessagesBasePath, analyzerName);
                 const analyzerConfig = await readConfig$1(analyzerPath);
                 const analyzerLabel = analyzerConfig?.label || analyzerName;
 
-                const contentEntries = await fs$7.readdir(analyzerPath, { withFileTypes: true });
+                const contentEntries = await fs$6.readdir(analyzerPath, { withFileTypes: true });
 
                 for (const contentEntry of contentEntries) {
                     if (contentEntry.isDirectory() && isValidDirName(contentEntry.name)) {
                         const contentType = contentEntry.name;
-                        const contentPath = path$5.join(analyzerPath, contentType);
+                        const contentPath = path$4.join(analyzerPath, contentType);
                         const contentConfig = await readConfig$1(contentPath);
                         const contentLabel = contentConfig?.label || contentType;
 
-                        const instructionsEntries = await fs$7.readdir(contentPath, { withFileTypes: true });
+                        const instructionsEntries = await fs$6.readdir(contentPath, { withFileTypes: true });
 
                         for (const instructionsEntry of instructionsEntries) {
                             if (instructionsEntry.isDirectory() && isValidDirName(instructionsEntry.name)) {
                                 const instructionsType = instructionsEntry.name;
-                                const instructionsPath = path$5.join(contentPath, instructionsType);
+                                const instructionsPath = path$4.join(contentPath, instructionsType);
                                 const instructionsConfig = await readConfig$1(instructionsPath);
                                 const instructionsLabel = instructionsConfig?.label || instructionsType;
 
                                 // Check for the existence of 1.md to confirm a valid analyzer configuration
-                                const instructionsFilePath = path$5.join(instructionsPath, '1.md');
+                                const instructionsFilePath = path$4.join(instructionsPath, '1.md');
                                 try {
-                                    await fs$7.access(instructionsFilePath); // Check if file exists and is accessible
+                                    await fs$6.access(instructionsFilePath); // Check if file exists and is accessible
 
                                     // If analyzerName starts with 'tutorial-', check its last modified time.
                                     if (analyzerName.startsWith('tutorial-')) {
-                                        const stats = await fs$7.stat(instructionsFilePath);
+                                        const stats = await fs$6.stat(instructionsFilePath);
                                         const lastModified = stats.mtime.getTime(); // Get timestamp in milliseconds
                                         const sixtyMinutesAgo = Date.now() - (60 * 60 * 1000); // Current time - 60 minutes in ms
 
@@ -11176,11 +11301,23 @@ async function getAnalyzers$2(analyzeMessagesBasePath) {
                                     const analyzerId = `${analyzerName}::${contentType}::${instructionsType}`;
                                     const analyzerFullLabel = `${analyzerLabel} (${contentLabel} - ${instructionsLabel})`;
 
+                                    let descriptionContent = null;
+                                    if (includeDescription) {
+                                        try {
+                                            descriptionContent = await getAnalyzerInstructionsContent$2(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') {
@@ -11217,8 +11354,8 @@ var discovery = {
  * Authors: Gemini 2.5 Flash Thinking (v1.0.0), Gemini 2.5 Flash Thinking (v1.1.0)
  */
 
-const fs$6 = require$$0.promises;
-const path$4 = require$$1;
+const fs$5 = require$$0.promises;
+const path$3 = require$$1;
 
 /**
  * Saves or updates an analyzer configuration.
@@ -11273,18 +11410,18 @@ async function saveConfiguration$1(analyzeMessagesBasePath, analyzerId, instruct
     }
 
     // 3. Construct directory paths
-    const analyzerDir = path$4.join(analyzeMessagesBasePath, analyzerName);
-    const contentDir = path$4.join(analyzerDir, contentType);
-    const instructionsDir = path$4.join(contentDir, instructionsType);
-    const instructionsFilePath = path$4.join(instructionsDir, '1.md');
+    const analyzerDir = path$3.join(analyzeMessagesBasePath, analyzerName);
+    const contentDir = path$3.join(analyzerDir, contentType);
+    const instructionsDir = path$3.join(contentDir, instructionsType);
+    const instructionsFilePath = path$3.join(instructionsDir, '1.md');
 
     try {
         // 4. Create directories recursively
-        await fs$6.mkdir(instructionsDir, { recursive: true });
+        await fs$5.mkdir(instructionsDir, { recursive: true });
 
         // 5. Save instructions content to 1.md
         const finalContent = `; role: assistant\n\n\n${instructionsContent}`; 
-        await fs$6.writeFile(instructionsFilePath, finalContent, 'utf8');
+        await fs$5.writeFile(instructionsFilePath, finalContent, 'utf8');
 
         // 6. Optionally create/Update config.json files
         if (ensureConfigs) {
@@ -11310,11 +11447,11 @@ async function saveConfiguration$1(analyzeMessagesBasePath, analyzerId, instruct
  * @param {string} label - The label to ensure is in the config.json.
  */
 async function ensureConfigJson(dirPath, label) {
-    const configPath = path$4.join(dirPath, 'config.json');
+    const configPath = path$3.join(dirPath, 'config.json');
     let config = {};
 
     try {
-        const fileContent = await fs$6.readFile(configPath, 'utf8');
+        const fileContent = await fs$5.readFile(configPath, 'utf8');
         config = JSON.parse(fileContent);
     } catch (error) {
         // If file doesn't exist or parsing fails, start with an empty config
@@ -11331,7 +11468,7 @@ async function ensureConfigJson(dirPath, label) {
     }
 
     // Write the updated config back to the file
-    await fs$6.writeFile(configPath, JSON.stringify(config, null, 4), 'utf8');
+    await fs$5.writeFile(configPath, JSON.stringify(config, null, 4), 'utf8');
 }
 
 
@@ -11350,8 +11487,8 @@ var saver = {
  * Authors: Gemini 2.5 Flash (v1.0.0)
  */
 
-const fs$5 = require$$0.promises;
-const path$3 = require$$1;
+const fs$4 = require$$0.promises;
+const path$2 = require$$1;
 const CodeBlockUtils$1 = CodeBlockUtils$4;
 
 /**
@@ -11437,10 +11574,10 @@ async function getAnalyzerSchema$2(analyzeMessagesBasePath, analyzerId) {
     }
     const [analyzerName, contentType, instructionsType] = parts;
 
-    const instructionsFilePath = path$3.join(analyzeMessagesBasePath, analyzerName, contentType, instructionsType, '1.md');
+    const instructionsFilePath = path$2.join(analyzeMessagesBasePath, analyzerName, contentType, instructionsType, '1.md');
 
     try {
-        const fileContent = await fs$5.readFile(instructionsFilePath, 'utf8');
+        const fileContent = await fs$4.readFile(instructionsFilePath, 'utf8');
         const { blocks } = CodeBlockUtils$1.extractCodeBlocks(fileContent, { silent: true });
         const jsonBlocks = blocks.filter(block => block.type === 'code' && block.language === 'json');
 
@@ -11511,8 +11648,8 @@ var schemaLoader = {
  * Authors: Gemini 2.5 Flash (v1.0.0)
  */
 
-const fs$4 = require$$0.promises;
-const path$2 = require$$1;
+const fs$3 = require$$0.promises;
+const path$1 = require$$1;
 const { readConfig } = discovery; // Import helper from discovery
 
 /**
@@ -11522,7 +11659,7 @@ const { readConfig } = discovery; // Import helper from discovery
  */
 async function isDirectoryEmpty(dirPath) {
     try {
-        const files = await fs$4.readdir(dirPath);
+        const files = await fs$3.readdir(dirPath);
         return files.length === 0 || (files.length === 1 && files[0] === 'config.json');
     } catch (error) {
         if (error.code === 'ENOENT') {
@@ -11553,10 +11690,10 @@ async function deleteAnalyzer$2(analyzeMessagesBasePath, analyzerId) {
     }
     const [analyzerName, contentType, instructionsType] = parts;
 
-    const analyzerDir = path$2.join(analyzeMessagesBasePath, analyzerName);
-    const contentDir = path$2.join(analyzerDir, contentType);
-    const instructionsDir = path$2.join(contentDir, instructionsType);
-    const instructionsFilePath = path$2.join(instructionsDir, '1.md');
+    const analyzerDir = path$1.join(analyzeMessagesBasePath, analyzerName);
+    const contentDir = path$1.join(analyzerDir, contentType);
+    const instructionsDir = path$1.join(contentDir, instructionsType);
+    const instructionsFilePath = path$1.join(instructionsDir, '1.md');
 
     try {
         // 1. Check for protection at all levels
@@ -11577,7 +11714,7 @@ async function deleteAnalyzer$2(analyzeMessagesBasePath, analyzerId) {
 
         // 2. Delete the 1.md file
         try {
-            await fs$4.unlink(instructionsFilePath);
+            await fs$3.unlink(instructionsFilePath);
         } catch (error) {
             if (error.code === 'ENOENT') {
                 return { success: false, message: `Analyzer instructions file not found: ${instructionsFilePath}. It may have already been deleted.` };
@@ -11591,7 +11728,7 @@ async function deleteAnalyzer$2(analyzeMessagesBasePath, analyzerId) {
         // Check and delete instructions directory
         if (await isDirectoryEmpty(instructionsDir)) {
             try {
-                await fs$4.rmdir(instructionsDir);
+                await fs$3.rmdir(instructionsDir);
                 deletedDirs.push(instructionsDir);
             } catch (error) {
                 console.warn(`Warning: Could not remove empty instructions directory ${instructionsDir}: ${error.message}`);
@@ -11601,7 +11738,7 @@ async function deleteAnalyzer$2(analyzeMessagesBasePath, analyzerId) {
         // Check and delete content directory
         if (await isDirectoryEmpty(contentDir)) {
             try {
-                await fs$4.rmdir(contentDir);
+                await fs$3.rmdir(contentDir);
                 deletedDirs.push(contentDir);
             } catch (error) {
                 console.warn(`Warning: Could not remove empty content directory ${contentDir}: ${error.message}`);
@@ -11611,7 +11748,7 @@ async function deleteAnalyzer$2(analyzeMessagesBasePath, analyzerId) {
         // Check and delete analyzer directory
         if (await isDirectoryEmpty(analyzerDir)) {
             try {
-                await fs$4.rmdir(analyzerDir);
+                await fs$3.rmdir(analyzerDir);
                 deletedDirs.push(analyzerDir);
             } catch (error) {
                 console.warn(`Warning: Could not remove empty analyzer directory ${analyzerDir}: ${error.message}`);
@@ -11629,69 +11766,9 @@ async function deleteAnalyzer$2(analyzeMessagesBasePath, analyzerId) {
 var management = {
     deleteAnalyzer: deleteAnalyzer$2};
 
-/*
- * Component: AnalyzerUtils Instruction Loader
- * Block-UUID: 0a1b2c3d-4e5f-6a7b-8c9d-0e1f2a3b4c5e
- * Parent-UUID: N/A
- * Version: 1.0.0
- * Description: Provides utility functions for loading raw analyzer instruction content.
- * Language: JavaScript
- * Created-at: 2025-08-28T23:48:00.000Z
- * Authors: Gemini 2.5 Flash (v1.0.0)
- */
-
-const fs$3 = require$$0.promises;
-const path$1 = require$$1;
-
-/**
- * Retrieves the raw Markdown content of the analyzer's '1.md' instruction file.
- *
- * @param {string} analyzeMessagesBasePath - The absolute path to the base directory containing the analyzer message files (e.g., 'messages/analyze').
- * @param {string} analyzerId - The unique ID of the analyzer (format: 'analyzer_name::content_type::instructions_type').
- * @returns {Promise<string|null>} A promise that resolves with the full Markdown content of the '1.md' file, or null if not found/invalid.
- */
-async function getAnalyzerInstructionsContent$2(analyzeMessagesBasePath, analyzerId) {
-    if (typeof analyzeMessagesBasePath !== 'string' || analyzeMessagesBasePath.trim() === '') {
-        console.error('Error: analyzeMessagesBasePath is required.');
-        return null;
-    }
-    if (typeof analyzerId !== 'string' || analyzerId.trim() === '') {
-        console.error('Error: analyzerId is required.');
-        return null;
-    }
-
-    const parts = analyzerId.split('::');
-    if (parts.length !== 3) {
-        console.error(`Error: Invalid analyzerId format. Expected 'analyzer_name::content_type::instructions_type', but got '${analyzerId}'.`);
-        return null;
-    }
-    const [analyzerName, contentType, instructionsType] = parts;
-
-    const instructionsFilePath = path$1.join(analyzeMessagesBasePath, analyzerName, contentType, instructionsType, '1.md');
-
-    try {
-        const fileContent = await fs$3.readFile(instructionsFilePath, 'utf8');
-        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}`);
-            return null;
-        } else {
-            console.error(`Error reading analyzer instructions file ${instructionsFilePath}: ${error.message}`);
-            throw error;
-        }
-    }
-}
-
-var instructionLoader = {
-    getAnalyzerInstructionsContent: getAnalyzerInstructionsContent$2
-};
-
 /*
  * 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gitsense/gsc-utils",
-  "version": "0.2.15",
+  "version": "0.2.17",
   "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/GSToolBlockUtils.js

@@ -1,12 +1,12 @@
 /**
  * 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)
  */
 
 
@@ -97,12 +97,73 @@ 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, processCodeBlocks, updateCodeBlockByIndex) {
+    if (typeof markdownContent !== 'string' || !toolName || !newToolData) {
+        throw new Error("Missing required parameters for replaceToolBlock.");
+    }
+
+    // We can't require them as this will create a circular dependency
+    if (!processCodeBlocks || !updateCodeBlockByIndex) {
+        throw new Error("Missing required dependencies processCodeBlocks and/or updateCodeBlockByIndex.");
+    }
+
+    // 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,
 }