@gitsense/gsc-utils 0.2.0 → 0.2.2

package/dist/gsc-utils.esm.js

@@ -450,7 +450,7 @@ function parseAnalyzeMessage(messageContent) {
     return { id: uniqueAnalyzerId, analyzer, content, instructions };
 }
 
-var MessageUtils$2 = {
+var MessageUtils$3 = {
     deleteMessagesByIds: deleteMessagesByIds$1,
     getChatTemplateMessages: getChatTemplateMessages$1,
     getMessagesBeforeId: getMessagesBeforeId$2,
@@ -476,7 +476,7 @@ var MessageUtils$2 = {
  * Authors: Gemini 2.5 Pro (v1.0.0), Gemini 2.5 Pro (v1.1.0), Gemini 2.5 Flash Thinking (v1.2.0), Gemini 2.5 Flash Thinking (v1.2.1), Gemini 2.5 Flash Thinking (v1.3.0)
  */
 
-const { getMessagesBeforeId: getMessagesBeforeId$1 } = MessageUtils$2;
+const { getMessagesBeforeId: getMessagesBeforeId$1 } = MessageUtils$3;
 
 /**
  * Internal helper function to determine if a chat session matches a specific pattern.
@@ -528,13 +528,21 @@ function isNewAnalyzerChat(chat, model) {
 /**
  * Determines if the current chat session appears to be an "Analyze" session.
  * @param {object} chat - The chat object.
- * @param {string} model - Optional model.
  * @returns {boolean} True if the chat matches the Overview Builder pattern, false otherwise.
  */
-function isAnalyzeChat(chat, model) {
+function isAnalyzeChat(chat) {
     return chat.type === 'analyze';
 }
 
+/**
+ * Determines if the current chat session appears to be an "Analyze Builder" session.
+ * @param {object} chat - The chat object.
+ * @returns {boolean} True if the chat matches the Overview Builder pattern, false otherwise.
+ */
+function isAnalyzeBuilderChat(chat) {
+    return chat.type === 'analyze-builder';
+}
+
 /**
  * Determines if the current chat session appears to be an "Ask" session.
  * @param {object} chat - The chat object.
@@ -586,6 +594,7 @@ var ChatUtils$1 = {
     isAskChat,
     isNewAnalyzerChat,
     isAnalyzeChat,
+    isAnalyzeBuilderChat,
     isPlanChat,
     isCodeChat,
     getChatMessages: getChatMessages$1
@@ -647,7 +656,7 @@ const COMMENT_STYLES$3 = {
     'vbscript': { type: 'apostrophe' }
 };
 
-var constants$1 = {
+var constants$2 = {
     COMMENT_STYLES: COMMENT_STYLES$3
 };
 
@@ -827,7 +836,7 @@ var lineNumberFormatter = {
  */
 
 // Dependencies from other modules within CodeBlockUtils
-const { COMMENT_STYLES: COMMENT_STYLES$2 } = constants$1;
+const { COMMENT_STYLES: COMMENT_STYLES$2 } = constants$2;
 const { removeLineNumbers: removeLineNumbers$9 } = lineNumberFormatter; // Assuming this utility exists
 const { validateUUID: validateUUID$3 } = uuidUtils; // Assuming uuidUtils.js is in the same directory
 
@@ -1449,7 +1458,7 @@ function validateAnalysisMetadata(metadata) {
 }
 
 
-var AnalysisBlockUtils$2 = { 
+var AnalysisBlockUtils$3 = { 
     isAnalysisBlock,
     getAnalysisBlockType,
     parseOverviewMetadata: parseOverviewMetadata$1,
@@ -1782,7 +1791,7 @@ const CONTENT_LINE_REGEX$5 = /^([ +-])\s*[-+]*(\d+):\s?(.*)$/;
 // Captures: 1: old_start, 2: old_count (optional), 3: new_start, 4: new_count (optional)
 const HUNK_HEADER_REGEX$4 = /^@@ -(\d+)(?:,(\d+))? \+(\d+)(?:,(\d+))? @@/;
 
-var constants = {
+var constants$1 = {
     CONTENT_LINE_REGEX: CONTENT_LINE_REGEX$5,
     HUNK_HEADER_REGEX: HUNK_HEADER_REGEX$4,
 };
@@ -1799,7 +1808,7 @@ var constants = {
  */
 
 const { removeLineNumbers: removeLineNumbers$8 } = lineNumberFormatter; // Assuming this utility exists
-const { CONTENT_LINE_REGEX: CONTENT_LINE_REGEX$4, HUNK_HEADER_REGEX: HUNK_HEADER_REGEX$3 } = constants;
+const { CONTENT_LINE_REGEX: CONTENT_LINE_REGEX$4, HUNK_HEADER_REGEX: HUNK_HEADER_REGEX$3 } = constants$1;
 
 
 /**
@@ -1964,7 +1973,7 @@ var formatAndAddLineNumbers_1 = {
  */
 
 const { removeLineNumbers: removeLineNumbers$7 } = lineNumberFormatter; // Assuming this utility exists
-const { CONTENT_LINE_REGEX: CONTENT_LINE_REGEX$3 } = constants;
+const { CONTENT_LINE_REGEX: CONTENT_LINE_REGEX$3 } = constants$1;
 const { formatAndAddLineNumbers: formatAndAddLineNumbers$1 } = formatAndAddLineNumbers_1; // Import the helper
 
 
@@ -2217,7 +2226,7 @@ var verifyAndCorrectLineNumbers_1 = {
  * Authors: Gemini 2.5 Flash Thinking (v1.0.0)
  */
 
-const { CONTENT_LINE_REGEX: CONTENT_LINE_REGEX$2, HUNK_HEADER_REGEX: HUNK_HEADER_REGEX$2 } = constants;
+const { CONTENT_LINE_REGEX: CONTENT_LINE_REGEX$2, HUNK_HEADER_REGEX: HUNK_HEADER_REGEX$2 } = constants$1;
 
 
 /**
@@ -2416,7 +2425,7 @@ var verifyAndCorrectHunkHeaders_1 = {
  * Authors: Gemini 2.5 Flash Thinking (v1.0.0)
  */
 
-const { CONTENT_LINE_REGEX: CONTENT_LINE_REGEX$1, HUNK_HEADER_REGEX: HUNK_HEADER_REGEX$1 } = constants;
+const { CONTENT_LINE_REGEX: CONTENT_LINE_REGEX$1, HUNK_HEADER_REGEX: HUNK_HEADER_REGEX$1 } = constants$1;
 
 
 /**
@@ -2819,7 +2828,7 @@ var detectAndFixRedundantChanges_1 = {
  * Authors: Gemini 2.5 Flash Thinking (v1.0.0)
  */
 
-const { CONTENT_LINE_REGEX, HUNK_HEADER_REGEX } = constants;
+const { CONTENT_LINE_REGEX, HUNK_HEADER_REGEX } = constants$1;
 
 
 /**
@@ -8773,7 +8782,7 @@ function formatToolBlock(toolData) {
     return `# GitSense Chat Tool\n\n${JSON.stringify(toolData, null, 2)}`;
 }
 
-var GSToolBlockUtils$2 = {
+var GSToolBlockUtils$3 = {
     isToolBlock: isToolBlock$1,
     parseToolBlock: parseToolBlock$1,
     formatToolBlock
@@ -9067,7 +9076,7 @@ function detectJsonComments$2(jsonString) {
     return comments;
 }
 
-var JsonUtils$1 = {
+var JsonUtils$2 = {
     detectJsonComments: detectJsonComments$2
 };
 
@@ -9085,12 +9094,12 @@ var JsonUtils$1 = {
 const { findAllCodeFences: findAllCodeFences$3, matchFencesAndExtractBlocks: matchFencesAndExtractBlocks$3 } = blockExtractor;
 const { parseHeader: parseHeader$2 } = headerUtils;
 const { validateUUID: validateUUID$2, generateUUID: generateUUID$2 } = uuidUtils;
-const AnalysisBlockUtils$1 = AnalysisBlockUtils$2;
+const AnalysisBlockUtils$2 = AnalysisBlockUtils$3;
 const PatchUtils$1 = PatchUtils$2;
-const GSToolBlockUtils$1 = GSToolBlockUtils$2;
+const GSToolBlockUtils$2 = GSToolBlockUtils$3;
 const { extractContinuationInfo: extractContinuationInfo$2 } = continuationUtils;
 const { removeLineNumbers: removeLineNumbers$2 } = lineNumberFormatter;
-const { detectJsonComments: detectJsonComments$1 } = JsonUtils$1;
+const { detectJsonComments: detectJsonComments$1 } = JsonUtils$2;
 
 /**
  * Processes a single block's content (internal helper)
@@ -9111,12 +9120,12 @@ function processBlockContent(content, language, position, incomplete, options =
     let codeText = content; // Default to all content being code
 
     // Check if this is a GitSense Tool Block *first*
-    if (GSToolBlockUtils$1.isToolBlock(content)) {
+    if (GSToolBlockUtils$2.isToolBlock(content)) {
         let ignoreDueToComments = false;
         let toolData = null;
         let toolParseError = null;
         try {
-            toolData = GSToolBlockUtils$1.parseToolBlock(content);
+            toolData = GSToolBlockUtils$2.parseToolBlock(content);
         } catch (error) {
             // When chatting about the tool block, the LLM may add
             // add comments in it so let's test for this
@@ -9150,14 +9159,14 @@ function processBlockContent(content, language, position, incomplete, options =
     }
 
     // Check if this is an analysis block *next*
-    if (AnalysisBlockUtils$1.isAnalysisBlock(content)) {
-        const analysisType = AnalysisBlockUtils$1.getAnalysisBlockType(content);
-        const analysisMetadata = AnalysisBlockUtils$1.parseOverviewMetadata(content);
+    if (AnalysisBlockUtils$2.isAnalysisBlock(content)) {
+        const analysisType = AnalysisBlockUtils$2.getAnalysisBlockType(content);
+        const analysisMetadata = AnalysisBlockUtils$2.parseOverviewMetadata(content);
 
         // Validate the metadata if it was successfully parsed
         let validationResult = { isValid: false, errors: ['Failed to parse analysis metadata'] };
         if (analysisMetadata) {
-            validationResult = AnalysisBlockUtils$1.validateAnalysisMetadata(analysisMetadata);
+            validationResult = AnalysisBlockUtils$2.validateAnalysisMetadata(analysisMetadata);
 
             if (!validationResult.isValid) {
                 warnings.push({
@@ -10374,7 +10383,7 @@ var updateCodeBlock_1 = {
  */
 
 // Import from individual utility files
-const { COMMENT_STYLES: COMMENT_STYLES$1 } = constants$1;
+const { COMMENT_STYLES: COMMENT_STYLES$1 } = constants$2;
 const { generateUUID: generateUUID$1, validateUUID: validateUUID$1 } = uuidUtils;
 const { isValidISOTimestamp: isValidISOTimestamp$1, parseHeader: parseHeader$1, getHeaderLineCount } = headerUtils;
 const { findAllCodeFences: findAllCodeFences$1, matchFencesAndExtractBlocks: matchFencesAndExtractBlocks$1, extractCodeBlocksWithUUIDs, findCodeBlockByUUID } = blockExtractor;
@@ -10388,7 +10397,7 @@ const { updateCodeBlockByIndex: updateCodeBlockByIndex$1, updateCodeBlockByUUID,
 const { formatWithLineNumbers: formatWithLineNumbers$1, formatBlockWithLineNumbers: formatBlockWithLineNumbers$1, formatBlocksWithLineNumbers: formatBlocksWithLineNumbers$1, removeLineNumbers: removeLineNumbers$1 } = lineNumberFormatter;
 
 // Export all imported items
-var CodeBlockUtils$2 = {
+var CodeBlockUtils$3 = {
     // Constants
     COMMENT_STYLES: COMMENT_STYLES$1,
 
@@ -10455,8 +10464,8 @@ var CodeBlockUtils$2 = {
  * Authors: Gemini 2.5 Flash Thinking (v1.0.0)
  */
 
-const CodeBlockUtils$1 = CodeBlockUtils$2;
-const MessageUtils$1 = MessageUtils$2;
+const CodeBlockUtils$2 = CodeBlockUtils$3;
+const MessageUtils$2 = MessageUtils$3;
 
 /**
  * Parses context details from a context message section.
@@ -10512,7 +10521,7 @@ function parseContextSection(sectionText) {
         }
     });
 
-    const { blocks, warnings } = CodeBlockUtils$1.extractCodeBlocks(sectionText, { silent: true });
+    const { blocks, warnings } = CodeBlockUtils$2.extractCodeBlocks(sectionText, { silent: true });
     const codeBlocks = blocks.filter(block => block.type === 'code');
 
     if (codeBlocks.length === 0) {
@@ -10541,7 +10550,7 @@ function parseContextSection(sectionText) {
  */
 function extractContextSections(messageContent) {
     // Use the utility function to validate the message type
-    if (!MessageUtils$1.isContextMessage(messageContent)) {
+    if (!MessageUtils$2.isContextMessage(messageContent)) {
         throw new Error("Invalid message type: Content is not a context message.");
     }
 
@@ -10618,12 +10627,312 @@ function extractContextItemsOverviewTableRows(messageContent) {
     return rows;
 }
 
-var ContextUtils$1 = {
+var ContextUtils$2 = {
     parseContextSection,
     extractContextSections,
     extractContextItemsOverviewTableRows
 };
 
+/*
+ * Component: AnalyzerUtils Context Mapper
+ * Block-UUID: 1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d
+ * Parent-UUID: N/A
+ * Version: 1.0.0
+ * Description: Provides utility functions for building a map of chat IDs to file paths from chat context messages.
+ * Language: JavaScript
+ * Created-at: 2025-08-28T15:56:40.319Z
+ * Authors: Gemini 2.5 Flash (v1.0.0)
+ */
+
+const MessageUtils$1  = MessageUtils$3;
+const ContextUtils$1  = ContextUtils$2;
+
+/**
+ * Builds a map of chat IDs to file paths from the context messages within a chat.
+ * This is crucial for validating that the LLM-generated analysis metadata refers to actual files in context.
+ *
+ * @param {Array<Object>} allMessages - An array of all message objects in the chat.
+ * @returns {Map<number, string>} A Map where keys are chat IDs (numbers) and values are file paths (strings).
+ */
+function buildChatIdToPathMap$1(allMessages) {
+    const chatIdToPathMap = new Map();
+
+    for (const msg of allMessages) {
+        const content = msg.message;
+        if (MessageUtils$1.isContextMessage(content)) {
+            try {
+                const contextSections = ContextUtils$1.extractContextSections(content);
+
+                for (const section of contextSections) {
+                    const chatId = section['chat id'];
+                    const path = section.path;
+
+                    if (chatId && path) {
+                        chatIdToPathMap.set(chatId, path);
+                    }
+                }
+            } catch (error) {
+                console.warn("AnalyzerUtils/contextMapper: Error parsing context message for map building:", error);
+                // Continue processing other messages
+            }
+        }
+    }
+    return chatIdToPathMap;
+}
+
+var contextMapper = {
+    buildChatIdToPathMap: buildChatIdToPathMap$1
+};
+
+/*
+ * Component: AnalyzerUtils Constants
+ * Block-UUID: 01b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d
+ * Parent-UUID: N/A
+ * Version: 1.0.0
+ * Description: Defines constants specific to the AnalyzerUtils module.
+ * Language: JavaScript
+ * Created-at: 2025-08-28T15:56:40.319Z
+ * Authors: Gemini 2.5 Flash (v1.0.0)
+ */
+
+const ANALYZE_HEADER_PREFIX$1 = '# GitSense Chat Analysis';
+
+var constants = {
+    ANALYZE_HEADER_PREFIX: ANALYZE_HEADER_PREFIX$1
+};
+
+/*
+ * Component: AnalyzerUtils Response Processor
+ * Block-UUID: 2a3b4c5d-6e7f-4a8b-9c0d-1e2f3a4b5c6d
+ * Parent-UUID: N/A
+ * Version: 1.0.0
+ * Description: Extracts and performs initial validation of analysis and metadata code blocks from raw LLM message content.
+ * Language: JavaScript
+ * Created-at: 2025-08-28T15:56:40.319Z
+ * Authors: Gemini 2.5 Flash (v1.0.0)
+ */
+
+const CodeBlockUtils$1 = CodeBlockUtils$3;
+const GSToolBlockUtils$1 = GSToolBlockUtils$3;
+const JsonUtils$1 = JsonUtils$2;
+const { ANALYZE_HEADER_PREFIX } = constants;
+
+/**
+ * Extracts code blocks from the message content, identifies analysis and metadata blocks,
+ * and performs initial validation (block type, metadata presence, JSON format).
+ * This function is adapted from the original `blockProcessing.js` in `gsc-conversation-view`.
+ *
+ * @param {string} messageContent - The full content of the message.
+ * @param {boolean} stoppedStreaming - Flag indicating if the message streaming has stopped.
+ * @returns {{analysisBlocks: Array<Object>, analysisMetadataBlocks: Array<Object|null>, error: string|null}}
+ *          An object containing the extracted blocks and any processing error.
+ */
+function processLLMAnalysisResponse$1(messageContent, stoppedStreaming) {
+    const silent = { silent: true };
+    const { blocks, warnings } = CodeBlockUtils$1.extractCodeBlocks(messageContent, silent);
+
+    const analysisBlocks = [];
+    const analysisMetadataBlocks = [];
+    let error = null;
+
+    for (let i = 0; i < blocks.length; i += 2) {
+        const analysisBlock = blocks[i];
+
+        // Make sure this is an analysis block by checking its content
+        if (!analysisBlock.content.trimStart().startsWith(ANALYZE_HEADER_PREFIX)) {
+            // Also check if it's a GitSense Tool Block, which should be ignored by this analyzer
+            if (GSToolBlockUtils$1.isToolBlock(analysisBlock.content)) {
+                // If it's a tool block, it's not an analysis block, so skip it and don't treat as error
+                // Adjust index to skip this block and its potential "metadata" if it was paired
+                if (blocks[i+1] && blocks[i+1].language === 'json') {
+                    i += 1; // Skip the next block too if it's a JSON block (likely tool config)
+                }
+                continue;
+            }
+
+            if (stoppedStreaming) {
+                error = `Analysis block #${i} does not start with the "${ANALYZE_HEADER_PREFIX}" header.`;
+            }
+            // If we are still streaming, we may not have enough information to tell what type
+            // of block this is, so stop looking
+            break;
+        }
+
+        // Add the analysis block (Markdown overview)
+        analysisBlocks.push(analysisBlock);
+
+        // Make sure there is an analysis metadata block (JSON)
+        const analysisMetadataBlock = blocks[i + 1];
+
+        if (!analysisMetadataBlock) {
+            if (stoppedStreaming) {
+                error = `No analysis metadata found for analysis block (index ${i}).`;
+            } else {
+                // Add a null metadata block to let use know we are still streaming
+                analysisMetadataBlocks.push(null);
+            }
+            break;
+        }
+
+        // We found a code block but we don't know if it is valid or not
+        // 1. First make sure the code block is a JSON type
+        // 2. Try to parse the JSON
+        if (analysisMetadataBlock.language !== 'json') {
+            if (stoppedStreaming) {
+                error = `Analysis metadata block for "${analysisBlock.overviewMetadata?.Path || 'Unknown Path'}" has invalid language "${analysisMetadataBlock.language}". Expected "json".`;
+            } else {
+                // Add a null metadata block to let use know we are still streaming
+                analysisMetadataBlocks.push(null);
+            }
+            break;
+        }
+
+        try {
+            // Check for comments within JSON, which would make it invalid for direct parsing
+            const comments = JsonUtils$1.detectJsonComments(analysisMetadataBlock.content);
+            if (comments.length > 0) {
+                error = `The analysis metadata block for "${analysisBlock.overviewMetadata?.Path || 'Unknown Path'}" contains comments, which makes it invalid JSON.`;
+                if (stoppedStreaming || blocks[i + 2]) { // If streaming stopped or not the last block
+                    break;
+                } else {
+                    analysisMetadataBlocks.push(null); // Add null to keep arrays aligned
+                    return { analysisBlocks, analysisMetadataBlocks, error: null };
+                }
+            }
+
+            JSON.parse(analysisMetadataBlock.content.trim());
+            analysisMetadataBlocks.push(analysisMetadataBlock);
+        } catch (err) {
+            const path = analysisBlock.overviewMetadata?.Path || 'Unknown Path';
+            error = `The analysis metadata block for "${path}" contains an invalid JSON: ${err.message}`;
+
+            // If streaming has stopped or if this is not the last block, set error and break.
+            // Remember to increment by two since every second block is the meta block.
+            if (stoppedStreaming || blocks[i + 2]) {
+                break;
+            } else {
+                // Do nothing since the error is most certaintly due to the fact that we are still
+                // streaming the JSON
+                analysisMetadataBlocks.push(null); // Add null to keep arrays aligned
+                return { analysisBlocks, analysisMetadataBlocks, error: null };
+            }
+        }
+    }
+
+    // If streaming stopped and no overview blocks were found, set an error
+    if (stoppedStreaming && analysisBlocks.length === 0) {
+        error = 'Analysis stopped without producing any data.';
+    }
+
+    return { analysisBlocks, analysisMetadataBlocks, error };
+}
+
+var responseProcessor = {
+    processLLMAnalysisResponse: processLLMAnalysisResponse$1
+};
+
+/*
+ * Component: AnalyzerUtils Data Validator
+ * Block-UUID: 1317cc51-fca0-49b7-9e4b-b3e1a06ab93f
+ * Parent-UUID: N/A
+ * Version: 1.0.0
+ * Description: Validates extracted analysis data against chat context and expected schema.
+ * Language: JavaScript
+ * Created-at: 2025-08-28T15:56:40.319Z
+ * Authors: Gemini 2.5 Flash (v1.0.0)
+ */
+
+const AnalysisBlockUtils$1 = AnalysisBlockUtils$3;
+
+/**
+ * Validates the extracted analysis blocks and their metadata.
+ * Checks for valid chat IDs/paths and uses AnalysisBlockUtils for further metadata validation.
+ * This function is adapted from the original `analysisValidation.js` in `gsc-conversation-view`.
+ *
+ * @param {Array<Object>} analysisBlocks - Array of extracted analysis code blocks (Markdown overviews).
+ * @param {Array<Object|null>} analysisMetadataBlocks - Array of extracted analysis metadata blocks (JSON).
+ * @param {Map<number, string>} chatIdToPathMap - Map of chat IDs to file paths from context messages.
+ * @returns {{validAnalysisData: Array<Object>, invalidAnalysisBlocks: Array<string|Object>}}
+ *          An object containing arrays of valid analysis data and invalid analysis blocks.
+ */
+function validateLLMAnalysisData$1(analysisBlocks, analysisMetadataBlocks, chatIdToPathMap) {
+    const validAnalysisData = []; // Store data for the "Save All" button
+    const invalidAnalysisBlocks = []; // Store invalid analysis blocks
+
+    analysisBlocks.forEach((block, index) => {
+        // Ensure metadata is parsed from the block's content for initial checks
+        const overviewMetadata = AnalysisBlockUtils$1.parseOverviewMetadata(block.content);
+        const metadataBlock = analysisMetadataBlocks[index];
+        const isDone = metadataBlock ? true : false; // Check if metadata block was successfully processed
+
+        // Skip if metadata block is missing (still streaming or error)
+        if (!overviewMetadata || !isDone) {
+            // If metadata block is missing but streaming stopped, it's an error handled in responseProcessor
+            // If overviewMetadata is missing, it's an error handled in responseProcessor
+            return;
+        }
+
+        const chatId = overviewMetadata['Chat ID'];
+        const path = overviewMetadata['Path'];
+
+        // Is this a valid chat id and path id? Some LLMs will actually hallucinate this
+        if (!chatId || !path || !chatIdToPathMap.has(chatId)) {
+            invalidAnalysisBlocks.push(`<li>#${chatId || 'N/A'} => ${path || 'N/A'} (Invalid Chat ID or Path)</li>`);
+            return;
+        }
+
+        // Perform detailed metadata validation using AnalysisBlockUtils
+        const validation = AnalysisBlockUtils$1.validateAnalysisMetadata(overviewMetadata);
+
+        if (validation.isValid) {
+            // Prepare data for API call (map keys if necessary)
+            const analysisData = {
+                chatId: overviewMetadata['Chat ID'],
+                // The original analyzeHandler used 'Message ID', 'Repository', 'Summarized At', 'Analyze At',
+                // 'Summary', 'Key Functionality', 'Keywords' from overviewMetadata.
+                // For batch processing, we primarily need chatId, content, and the full JSON metadata.
+                // The other fields can be derived from the full JSON metadata if needed.
+                path: overviewMetadata['Path'],
+                content: block.content, // The full Markdown overview
+                type: AnalysisBlockUtils$1.getAnalysisBlockType(block.content), // e.g., 'tiny-overview::file-content::default'
+                // We know metadataBlock.content is a valid JSON from responseProcessor
+                metadata: JSON.parse(metadataBlock.content) // The full JSON metadata object
+            };
+            validAnalysisData.push(analysisData); // Add to list for saving
+        } else {
+            // Add invalid analysis block with validation details
+            invalidAnalysisBlocks.push({ block, validation });
+        }
+    });
+
+    return { validAnalysisData, invalidAnalysisBlocks };
+}
+
+var dataValidator = {
+    validateLLMAnalysisData: validateLLMAnalysisData$1
+};
+
+/*
+ * Component: AnalyzerUtils Index
+ * Block-UUID: b403b6a1-230b-4247-8cd6-2a3d068f4bbf
+ * Parent-UUID: N/A
+ * Version: 1.0.0
+ * Description: Aggregates and exports all utility functions from the AnalyzerUtils module.
+ * Language: JavaScript
+ * Created-at: 2025-08-28T15:56:40.319Z
+ * Authors: Gemini 2.5 Flash (v1.0.0)
+ */
+
+const { buildChatIdToPathMap } = contextMapper;
+const { processLLMAnalysisResponse } = responseProcessor;
+const { validateLLMAnalysisData } = dataValidator;
+
+var AnalyzerUtils$1 = {
+    buildChatIdToPathMap,
+    processLLMAnalysisResponse,
+    validateLLMAnalysisData
+};
+
 /**
  * Component: LLMUtils
  * Block-UUID: a3106054-42f1-474f-96f3-182d66eb19a0
@@ -10667,14 +10976,15 @@ var LLMUtils$1 = {
  */
 
 const ChatUtils = ChatUtils$1;
-const CodeBlockUtils = CodeBlockUtils$2;
-const ContextUtils = ContextUtils$1;
-const MessageUtils = MessageUtils$2;
-const AnalysisBlockUtils = AnalysisBlockUtils$2;
+const CodeBlockUtils = CodeBlockUtils$3;
+const ContextUtils = ContextUtils$2;
+const MessageUtils = MessageUtils$3;
+const AnalysisBlockUtils = AnalysisBlockUtils$3;
+const AnalyzerUtils = AnalyzerUtils$1;
 const PatchUtils = PatchUtils$2;
-const GSToolBlockUtils = GSToolBlockUtils$2;
+const GSToolBlockUtils = GSToolBlockUtils$3;
 const LLMUtils = LLMUtils$1;
-const JsonUtils = JsonUtils$1;
+const JsonUtils = JsonUtils$2;
 
 const {
     estimateTokens
@@ -11016,6 +11326,11 @@ var GitSenseChatUtils_1 = {
     parseOverviewMetadata,
     validateOverviewMetadata,
 
+    // Analyzer Utilities
+    buildChatIdToPathMap: AnalyzerUtils.buildChatIdToPathMap,
+    processLLMAnalysisResponse: AnalyzerUtils.processLLMAnalysisResponse,
+    validateLLMAnalysisData: AnalyzerUtils.validateLLMAnalysisData,
+
     // ChatUtils
     getChatMessages, 
 

package/package.json

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

package/src/AnalyzerUtils/constants.js

@@ -0,0 +1,17 @@
+/*
+ * Component: AnalyzerUtils Constants
+ * Block-UUID: 01b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d
+ * Parent-UUID: N/A
+ * Version: 1.0.0
+ * Description: Defines constants specific to the AnalyzerUtils module.
+ * Language: JavaScript
+ * Created-at: 2025-08-28T15:56:40.319Z
+ * Authors: Gemini 2.5 Flash (v1.0.0)
+ */
+
+
+const ANALYZE_HEADER_PREFIX = '# GitSense Chat Analysis';
+
+module.exports = {
+    ANALYZE_HEADER_PREFIX
+};

package/src/AnalyzerUtils/contextMapper.js

@@ -0,0 +1,51 @@
+/*
+ * Component: AnalyzerUtils Context Mapper
+ * Block-UUID: 1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d
+ * Parent-UUID: N/A
+ * Version: 1.0.0
+ * Description: Provides utility functions for building a map of chat IDs to file paths from chat context messages.
+ * Language: JavaScript
+ * Created-at: 2025-08-28T15:56:40.319Z
+ * Authors: Gemini 2.5 Flash (v1.0.0)
+ */
+
+
+const MessageUtils  = require('../MessageUtils');
+const ContextUtils  = require('../ContextUtils');
+
+/**
+ * Builds a map of chat IDs to file paths from the context messages within a chat.
+ * This is crucial for validating that the LLM-generated analysis metadata refers to actual files in context.
+ *
+ * @param {Array<Object>} allMessages - An array of all message objects in the chat.
+ * @returns {Map<number, string>} A Map where keys are chat IDs (numbers) and values are file paths (strings).
+ */
+function buildChatIdToPathMap(allMessages) {
+    const chatIdToPathMap = new Map();
+
+    for (const msg of allMessages) {
+        const content = msg.message;
+        if (MessageUtils.isContextMessage(content)) {
+            try {
+                const contextSections = ContextUtils.extractContextSections(content);
+
+                for (const section of contextSections) {
+                    const chatId = section['chat id'];
+                    const path = section.path;
+
+                    if (chatId && path) {
+                        chatIdToPathMap.set(chatId, path);
+                    }
+                }
+            } catch (error) {
+                console.warn("AnalyzerUtils/contextMapper: Error parsing context message for map building:", error);
+                // Continue processing other messages
+            }
+        }
+    }
+    return chatIdToPathMap;
+}
+
+module.exports = {
+    buildChatIdToPathMap
+};