@gitsense/gsc-utils 0.2.5 → 0.2.6

package/dist/gsc-utils.cjs.js

@@ -11051,6 +11051,23 @@ var discovery = {
     getAnalyzers: getAnalyzers$2,
     readConfig: readConfig$1};
 
+/**
+ * Component: Analyzer Saver Utility
+ * Block-UUID: a373f4ba-89ce-465f-8624-24258c923e61
+ * Parent-UUID: N/A
+ * Version: 1.1.0
+ * Description: Utility function to save or update an analyzer configuration based on its ID and content.
+ * Language: JavaScript
+ * Created-at: 2025-07-12T04:12:33.454Z
+ * Authors: Gemini 2.5 Flash Thinking (v1.0.0), Gemini 2.5 Flash Thinking (v1.1.0)
+ */
+
+require$$0.promises;
+
+
+var saver = {
+    };
+
 /*
  * Component: AnalyzerUtils Schema Loader
  * Block-UUID: 0c1d2e3f-4a5b-6c7d-8e9f-0a1b2c3d4e5f
@@ -11414,6 +11431,7 @@ const { buildChatIdToPathMap: buildChatIdToPathMap$1 } = contextMapper;
 const { processLLMAnalysisResponse: processLLMAnalysisResponse$1 } = responseProcessor;
 const { validateLLMAnalysisData: validateLLMAnalysisData$1 } = dataValidator;
 const { getAnalyzers: getAnalyzers$1 } = discovery;
+const { saveConfiguration } = saver;
 const { getAnalyzerSchema: getAnalyzerSchema$1 } = schemaLoader;
 const { deleteAnalyzer: deleteAnalyzer$1 } = management;
 const { getAnalyzerInstructionsContent: getAnalyzerInstructionsContent$1 } = instructionLoader;
@@ -11426,6 +11444,7 @@ var AnalyzerUtils$1 = {
     getAnalyzerSchema: getAnalyzerSchema$1,
     deleteAnalyzer: deleteAnalyzer$1,
     getAnalyzerInstructionsContent: getAnalyzerInstructionsContent$1,
+    saveConfiguration,
 };
 
 /**
@@ -11648,7 +11667,7 @@ const CodeBlockUtils = CodeBlockUtils$4;
 const ContextUtils = ContextUtils$2;
 const MessageUtils = MessageUtils$3;
 const AnalysisBlockUtils = AnalysisBlockUtils$3;
-const AnalyzerUtils = AnalyzerUtils$1; // Updated import
+const AnalyzerUtils = AnalyzerUtils$1;
 const PatchUtils = PatchUtils$2;
 const GSToolBlockUtils = GSToolBlockUtils$3;
 const LLMUtils = LLMUtils$1;
@@ -11688,7 +11707,7 @@ const {
     validateOverviewMetadata,
 } = AnalysisBlockUtils;
 
-const { // Updated AnalyzerUtils destructuring
+const {
     buildChatIdToPathMap,
     processLLMAnalysisResponse,
     validateLLMAnalysisData,
@@ -11696,6 +11715,7 @@ const { // Updated AnalyzerUtils destructuring
     getAnalyzerSchema,
     deleteAnalyzer,
     getAnalyzerInstructionsContent,
+    saveAnalyzerConfiguration,
 } = AnalyzerUtils;
 
 const {

package/dist/gsc-utils.esm.js

@@ -11049,6 +11049,23 @@ var discovery = {
     getAnalyzers: getAnalyzers$2,
     readConfig: readConfig$1};
 
+/**
+ * Component: Analyzer Saver Utility
+ * Block-UUID: a373f4ba-89ce-465f-8624-24258c923e61
+ * Parent-UUID: N/A
+ * Version: 1.1.0
+ * Description: Utility function to save or update an analyzer configuration based on its ID and content.
+ * Language: JavaScript
+ * Created-at: 2025-07-12T04:12:33.454Z
+ * Authors: Gemini 2.5 Flash Thinking (v1.0.0), Gemini 2.5 Flash Thinking (v1.1.0)
+ */
+
+require$$0.promises;
+
+
+var saver = {
+    };
+
 /*
  * Component: AnalyzerUtils Schema Loader
  * Block-UUID: 0c1d2e3f-4a5b-6c7d-8e9f-0a1b2c3d4e5f
@@ -11412,6 +11429,7 @@ const { buildChatIdToPathMap: buildChatIdToPathMap$1 } = contextMapper;
 const { processLLMAnalysisResponse: processLLMAnalysisResponse$1 } = responseProcessor;
 const { validateLLMAnalysisData: validateLLMAnalysisData$1 } = dataValidator;
 const { getAnalyzers: getAnalyzers$1 } = discovery;
+const { saveConfiguration } = saver;
 const { getAnalyzerSchema: getAnalyzerSchema$1 } = schemaLoader;
 const { deleteAnalyzer: deleteAnalyzer$1 } = management;
 const { getAnalyzerInstructionsContent: getAnalyzerInstructionsContent$1 } = instructionLoader;
@@ -11424,6 +11442,7 @@ var AnalyzerUtils$1 = {
     getAnalyzerSchema: getAnalyzerSchema$1,
     deleteAnalyzer: deleteAnalyzer$1,
     getAnalyzerInstructionsContent: getAnalyzerInstructionsContent$1,
+    saveConfiguration,
 };
 
 /**
@@ -11646,7 +11665,7 @@ const CodeBlockUtils = CodeBlockUtils$4;
 const ContextUtils = ContextUtils$2;
 const MessageUtils = MessageUtils$3;
 const AnalysisBlockUtils = AnalysisBlockUtils$3;
-const AnalyzerUtils = AnalyzerUtils$1; // Updated import
+const AnalyzerUtils = AnalyzerUtils$1;
 const PatchUtils = PatchUtils$2;
 const GSToolBlockUtils = GSToolBlockUtils$3;
 const LLMUtils = LLMUtils$1;
@@ -11686,7 +11705,7 @@ const {
     validateOverviewMetadata,
 } = AnalysisBlockUtils;
 
-const { // Updated AnalyzerUtils destructuring
+const {
     buildChatIdToPathMap,
     processLLMAnalysisResponse,
     validateLLMAnalysisData,
@@ -11694,6 +11713,7 @@ const { // Updated AnalyzerUtils destructuring
     getAnalyzerSchema,
     deleteAnalyzer,
     getAnalyzerInstructionsContent,
+    saveAnalyzerConfiguration,
 } = AnalyzerUtils;
 
 const {

package/package.json

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

package/src/AnalyzerUtils/index.js

@@ -14,6 +14,7 @@ const { buildChatIdToPathMap } = require('./contextMapper');
 const { processLLMAnalysisResponse } = require('./responseProcessor');
 const { validateLLMAnalysisData } = require('./dataValidator');
 const { getAnalyzers } = require('./discovery');
+const { saveConfiguration } = require('./saver');
 const { getAnalyzerSchema } = require('./schemaLoader');
 const { deleteAnalyzer } = require('./management');
 const { getAnalyzerInstructionsContent } = require('./instructionLoader');
@@ -26,4 +27,5 @@ module.exports = {
     getAnalyzerSchema,
     deleteAnalyzer,
     getAnalyzerInstructionsContent,
+    saveConfiguration,
 };

package/src/AnalyzerUtils/saver.js

@@ -0,0 +1,133 @@
+/**
+ * Component: Analyzer Saver Utility
+ * Block-UUID: a373f4ba-89ce-465f-8624-24258c923e61
+ * Parent-UUID: N/A
+ * Version: 1.1.0
+ * Description: Utility function to save or update an analyzer configuration based on its ID and content.
+ * Language: JavaScript
+ * Created-at: 2025-07-12T04:12:33.454Z
+ * Authors: Gemini 2.5 Flash Thinking (v1.0.0), Gemini 2.5 Flash Thinking (v1.1.0)
+ */
+
+
+const fs = require('fs').promises;
+const path = require('path');
+
+/**
+ * Saves or updates an analyzer configuration.
+ *
+ * This function takes the analyzer ID and its full instructions content,
+ * parses the ID to determine the directory structure, creates directories
+ * if necessary, saves the instructions to '1.md'. Optionally, it can
+ * ensure config.json files exist with labels derived from directory names.
+ *
+ * @param {string} analyzeMessagesBasePath - The absolute or relative path to the 'messages/analyze' directory.
+ * @param {string} analyzerId - The unique ID of the analyzer (format: 'analyzer_name::content_type::instructions_type').
+ * @param {string} instructionsContent - The full content of the analyzer instructions message to be saved in '1.md'.
+ * @param {object} [options={}] - Optional configuration options.
+ * @param {boolean} [options.ensureConfigs=false] - If true, ensures config.json files exist in the analyzer, content, and instructions directories. Defaults to false.
+ * @returns {Promise<{success: boolean, message?: string}>} A promise that resolves with a result object.
+ */
+async function saveAnalyzerConfiguration(analyzeMessagesBasePath, analyzerId, instructionsContent, options = {}) {
+    const { ensureConfigs = false } = options;
+
+    // 1. Validate inputs
+    if (typeof analyzeMessagesBasePath !== 'string' || analyzeMessagesBasePath.trim() === '') {
+        return { success: false, message: 'analyzeMessagesBasePath is required.' };
+    }
+    if (typeof analyzerId !== 'string' || analyzerId.trim() === '') {
+        return { success: false, message: 'analyzerId is required.' };
+    }
+    if (typeof instructionsContent !== 'string' || instructionsContent.trim() === '') {
+        return { success: false, message: 'instructionsContent is required.' };
+    }
+
+    // 2. Parse analyzerId
+    const parts = analyzerId.split('::');
+    if (parts.length !== 3) {
+        return { success: false, message: `Invalid analyzerId format. Expected 'analyzer_name::content_type::instructions_type', but got '${analyzerId}'.` };
+    }
+    const [analyzerName, contentType, instructionsType] = parts;
+
+    // Helper to validate directory names based on README.md rules
+    const isValidDirName = (name) => {
+        // Cannot start with underscore, cannot contain dots, must be alphanumeric, dash, or underscore
+        return /^[a-zA-Z0-9_-]+$/.test(name) && !name.startsWith('_') && !name.includes('.');
+    };
+
+    if (!isValidDirName(analyzerName)) {
+        return { success: false, message: `Invalid analyzer name '${analyzerName}'. Names must be alphanumeric, dash, or underscore, cannot start with underscore, and cannot contain dots.` };
+    }
+    if (!isValidDirName(contentType)) {
+        return { success: false, message: `Invalid content type name '${contentType}'. Names must be alphanumeric, dash, or underscore, cannot start with underscore, and cannot contain dots.` };
+    }
+    if (!isValidDirName(instructionsType)) {
+        return { success: false, message: `Invalid instructions type name '${instructionsType}'. Names must be alphanumeric, dash, or underscore, cannot start with underscore, and cannot contain dots.` };
+    }
+
+    // 3. Construct directory paths
+    const analyzerDir = path.join(analyzeMessagesBasePath, analyzerName);
+    const contentDir = path.join(analyzerDir, contentType);
+    const instructionsDir = path.join(contentDir, instructionsType);
+    const instructionsFilePath = path.join(instructionsDir, '1.md');
+
+    try {
+        // 4. Create directories recursively
+        await fs.mkdir(instructionsDir, { recursive: true });
+
+        // 5. Save instructions content to 1.md
+        const finalContent = `; role: assistant\n\n\n${instructionsContent}`; 
+        await fs.writeFile(instructionsFilePath, finalContent, 'utf8');
+
+        // 6. Optionally create/Update config.json files
+        if (ensureConfigs) {
+            await ensureConfigJson(analyzerDir, analyzerName);
+            await ensureConfigJson(contentDir, contentType);
+            await ensureConfigJson(instructionsDir, instructionsType);
+        }
+
+        return { success: true, message: `Analyzer configuration '${analyzerId}' saved successfully.` };
+
+    } catch (error) {
+        console.error(`Error saving analyzer configuration '${analyzerId}':`, error);
+        return { success: false, message: `Failed to save analyzer configuration: ${error.message}` };
+    }
+}
+
+/**
+ * Ensures a config.json file exists in the given directory with a label.
+ * If the file exists, it reads it and adds the label if missing.
+ * If the file doesn't exist, it creates it with the label.
+ *
+ * @param {string} dirPath - The path to the directory.
+ * @param {string} label - The label to ensure is in the config.json.
+ */
+async function ensureConfigJson(dirPath, label) {
+    const configPath = path.join(dirPath, 'config.json');
+    let config = {};
+
+    try {
+        const fileContent = await fs.readFile(configPath, 'utf8');
+        config = JSON.parse(fileContent);
+    } catch (error) {
+        // If file doesn't exist or parsing fails, start with an empty config
+        if (error.code !== 'ENOENT') {
+            console.warn(`Failed to read or parse existing config.json in ${dirPath}: ${error.message}`);
+        }
+        config = {}; // Ensure config is an object even on error
+    }
+
+    // Add or update the label if it's missing or empty
+    if (!config.label || typeof config.label !== 'string' || config.label.trim() === '') {
+         // Capitalize the first letter for the label
+        config.label = label.charAt(0).toUpperCase() + label.slice(1);
+    }
+
+    // Write the updated config back to the file
+    await fs.writeFile(configPath, JSON.stringify(config, null, 4), 'utf8');
+}
+
+
+module.exports = {
+    saveAnalyzerConfiguration,
+};

package/src/GitSenseChatUtils.js

@@ -15,7 +15,7 @@ const CodeBlockUtils = require('./CodeBlockUtils');
 const ContextUtils = require('./ContextUtils');
 const MessageUtils = require('./MessageUtils');
 const AnalysisBlockUtils = require('./AnalysisBlockUtils');
-const AnalyzerUtils = require('./AnalyzerUtils'); // Updated import
+const AnalyzerUtils = require('./AnalyzerUtils');
 const PatchUtils = require('./PatchUtils');
 const GSToolBlockUtils = require('./GSToolBlockUtils');
 const LLMUtils = require('./LLMUtils');
@@ -55,7 +55,7 @@ const {
     validateOverviewMetadata,
 } = AnalysisBlockUtils;
 
-const { // Updated AnalyzerUtils destructuring
+const {
     buildChatIdToPathMap,
     processLLMAnalysisResponse,
     validateLLMAnalysisData,
@@ -63,6 +63,7 @@ const { // Updated AnalyzerUtils destructuring
     getAnalyzerSchema,
     deleteAnalyzer,
     getAnalyzerInstructionsContent,
+    saveAnalyzerConfiguration,
 } = AnalyzerUtils;
 
 const {