@gitsense/gsc-utils 0.2.8 → 0.2.9

package/dist/gsc-utils.cjs.js

@@ -10455,26 +10455,108 @@ var CodeBlockUtils$4 = {
     removeLineNumbers: removeLineNumbers$1,
 };
 
-/**
+/*
  * Component: ContextUtils
  * Block-UUID: c199efe3-003c-4226-af3c-d460392a6569
  * Parent-UUID: N/A
- * Version: 1.0.0
- * Description: Provides utility functions for parsing context message sections to extract file details and code blocks.
+ * Version: 1.1.0
+ * Description: Provides utility functions for parsing context message sections to extract file details and code blocks, and for formatting content for LLM context.
  * Language: JavaScript
  * Created-at: 2025-05-09T01:36:20.107Z
- * Authors: Gemini 2.5 Flash Thinking (v1.0.0)
+ * Authors: Gemini 2.5 Flash Thinking (v1.0.0), Gemini 2.5 Flash (v1.1.0)
  */
 
 const CodeBlockUtils$3 = CodeBlockUtils$4;
 const MessageUtils$2 = MessageUtils$3;
 
+/**
+ * Formats bytes into human-readable string (KB, MB, GB)
+ * @param {number} bytes - Number of bytes
+ * @returns {string} Formatted size string
+ */
+function _formatBytes(bytes) {
+    if (typeof bytes !== 'number' || isNaN(bytes)) return '0 bytes';
+    if (bytes === 0) return '0 bytes';
+
+    const k = 1024;
+    const sizes = ['bytes', 'KB', 'MB', 'GB'];
+    const i = Math.floor(Math.log(bytes) / Math.log(k));
+
+    // Special case for bytes (no decimal)
+    if (i === 0) return `${bytes} ${sizes[i]}`;
+
+    const value = bytes / Math.pow(k, i);
+    // Show no decimal if whole number
+    const decimalPlaces = value % 1 === 0 ? 0 : 1;
+    return `${value.toFixed(decimalPlaces)} ${sizes[i]}`;
+}
+
+/**
+ * Creates a summary of items for human readers
+ * @param {Array} items - Array of loaded items
+ * @param {string} contentType - Content type
+ * @returns {string} Human-readable summary
+ */
+function _createContextSummary(items, contentType) {
+    if (items.length === 0) return '';
+
+    // Group by files and trees
+    const files = items.filter(item => item.metadata?.type === 'git-blob');
+    const trees = items.filter(item => item.metadata?.type === 'git-tree' || item.metadata?.type === 'git-ref');
+
+    // Calculate total size and tokens
+    const totalSize = items.reduce((sum, item) => sum + (item.size || 0), 0);
+    const totalTokens = items.reduce((sum, item) => sum + (item.tokenCount || 0), 0);
+
+    let summary = contentType === 'file content'
+        ? `\n**Summary:** ${items.length} file${items.length === 1 ? '' : 's'} (${_formatBytes(totalSize)}, ${totalTokens.toLocaleString()} tokens)\n\n`
+        : `\n**Summary:** ${files.length} file${files.length === 1 ? '' : 's'} - ${trees.length} tree${trees.length === 1 ? '' : 's'}\n\n`;
+
+    // Add brief description of first X files
+    const maxFiles = 10;
+    const displayItems = items.slice(0, maxFiles);
+    if (displayItems.length > 0) {
+        displayItems.forEach(item => {
+            if (item.tokenCount) {
+                summary += `- ${item.name} - ${_formatBytes(item.size)}, ${item.tokenCount.toLocaleString()} tokens\n`;
+            } else {
+                summary += `- ${item.name} - Not analyzed\n`;
+            }
+        });
+
+        // Add note if there are more files
+        if (items.length > maxFiles) {
+            summary += `- ... and ${items.length - maxFiles} more\n`;
+        }
+    }
+
+    return summary + "\n";
+}
+
+/**
+ * Escapes backticks in code blocks to prevent premature termination of LLM-generated code blocks.
+ * @param {string} content - The content string to escape.
+ * @returns {{escapedContent: string, escapedLineNums: Array<number>}} Object with escaped content and line numbers of escaped lines.
+ */
+function _escapeCodeBlocks(content) {
+    const escapedLineNums = [];
+    const escapedLines = content.replace(/\n$/, '').split('\n').map((line, i) => {
+        if (line.trimStart().startsWith('```')) {
+            line = '\\' + line.trimStart();
+            escapedLineNums.push(i + 1);
+        }
+        return line;
+    });
+    return { escapedContent: escapedLines.join('\n'), escapedLineNums };
+}
+
+
 /**
  * Parses context details from a context message section.
  * @param {string} sectionText - The text content of a single context section (starting from the file header).
  * @returns {Object|null} An object with file details (name, path, meta, content) or null if parsing fails.
  */
-function parseContextSection(sectionText) {
+function parseContextSection$1(sectionText) {
     const contextSection = {
         name: 'Unknown File',
         content: null,
@@ -10550,7 +10632,7 @@ function parseContextSection(sectionText) {
  * @returns {Array<Object>} An array of parsed context section objects.
  * @throws {Error} If the message content is not a valid context message.
  */
-function extractContextSections(messageContent) {
+function extractContextSections$1(messageContent) {
     // Use the utility function to validate the message type
     if (!MessageUtils$2.isContextMessage(messageContent)) {
         throw new Error("Invalid message type: Content is not a context message.");
@@ -10564,7 +10646,7 @@ function extractContextSections(messageContent) {
 
     // Process sections starting from the first potential path delimiter.
     for (let i = 0; i < sections.length; i++) {
-        const contextSection = parseContextSection(sections[i]);
+        const contextSection = parseContextSection$1(sections[i]);
 
         if (contextSection) {
             contextSections.push(contextSection);
@@ -10579,7 +10661,7 @@ function extractContextSections(messageContent) {
     return contextSections;
 }
 
-function extractContextItemsOverviewTableRows(messageContent) {
+function extractContextItemsOverviewTableRows$1(messageContent) {
     const lines = messageContent.trim().split('\n');
     const startIndex = lines.findIndex(line => line.startsWith('---Start of Overview Items---')) + 4;
 
@@ -10629,10 +10711,85 @@ function extractContextItemsOverviewTableRows(messageContent) {
     return rows;
 }
 
+/**
+ * Formats content for context based on content type.
+ * This function is adapted from the original `formatContentForContext` in `formatterUtils.js`.
+ *
+ * @param {Array<Object>} items - Array of loaded items, each with `chatId`, `name`, `content`, `meta`, `repo` (from chatsApi.getBlobDetailsByChatIds).
+ * @param {string} contentType - Type of content ('file content' or 'overview'). For batch analysis, always 'file content'.
+ * @param {string} contentOption - Option for the content type. For batch analysis, always 'imported'.
+ * @returns {string} Formatted text for context.
+ */
+function formatContextContent$1(items, contentType, contentOption) {
+    if (items.length === 0) {
+        return 'No content loaded';
+    }
+
+    let result = '';
+
+    // Header based on content type
+    if (contentType === 'overview') {
+        result += `## OVERVIEW - ${contentOption.toUpperCase()}\n`;
+    } else {
+        result += `## FILE CONTENT - ${contentOption.toUpperCase()}\n`;
+    }
+
+    // Summary of items
+    result += _createContextSummary(items, contentType);
+    result += "\n---Start of Context---\n\n";
+
+    items.forEach((item, index) => {
+        // Ensure item has necessary properties, especially meta and repo
+        const itemMeta = item.meta || {};
+        const itemRepo = item.repo || {};
+
+        result += "#### `"+item.name+"`\n";
+
+        const { escapedContent, escapedLineNums } = _escapeCodeBlocks(item.content);
+
+        // Always include metadata for batch analysis context
+        result +=
+            `- Repo: ${itemRepo.fullName || 'N/A'}\n`+
+            `- Path: ${itemMeta.path || 'N/A'}\n`;
+
+        // Size and Tokens are specific to 'file content'
+        if (contentType === 'file content') {
+            result += `- Size: ${_formatBytes(itemMeta.size)}\n`;
+            result += `- Tokens: ${itemMeta.tokens?.content?.estimate || 'N/A'}\n`;
+        } else {
+            const type = itemMeta.type || 'unknown';
+            result += `- Type: ${type === 'git-blob' ? 'file' : type === 'git-tree' || type === 'git-ref' ? 'directory' : type }\n`;
+            result += `- Tokens: ${itemMeta.tokens?.analysis?.[contentOption.toLowerCase()]?.estimate || 'N/A'}\n`;
+        }
+
+        result += `- Chat ID: ${item.chatId}\n`;
+
+        if (escapedLineNums.length) {
+            result += `- Escaped Lines: ${escapedLineNums.join(',')}\n`;
+        }
+
+        result += '\n';
+
+        // The original formatterUtils had a special summary handling.
+        // For batch analysis, we want the full file content.
+        // The `if (!escapedContent.includes('Component: New Analyzer Chat') && escapedContent.match(summary))`
+        // logic is specific to the frontend's overview builder and should not be applied here.
+        result += "```"+(itemMeta.highlight || '')+"\n"+escapedContent+"\n```";
+
+        if (index !== items.length - 1) {
+            result += '\n---End of Item---\n';
+        }
+    });
+
+    return result;
+}
+
+
 var ContextUtils$2 = {
-    parseContextSection,
-    extractContextSections,
-    extractContextItemsOverviewTableRows
+    parseContextSection: parseContextSection$1,
+    extractContextSections: extractContextSections$1,
+    extractContextItemsOverviewTableRows: extractContextItemsOverviewTableRows$1,
+    formatContextContent: formatContextContent$1, // Export the new method
 };
 
 /*
@@ -11849,11 +12006,11 @@ var EnvUtils$1 = {
  * Component: GitSenseChatUtils
  * Block-UUID: 5e8d1a9c-0b3f-4e1a-8c7d-9f0b2e1d3a4b
  * Parent-UUID: 7a9b1c8e-f1a4-4b2d-9e8f-6f7a0b1c2d3f
- * Version: 2.1.3
+ * Version: 2.1.4
  * Description: Interface class for GitSense Chat utilities providing a unified API for code block parsing (markdown), extraction, and patch operations. Integrates functionalities from CodeBlockUtils and PatchUtils modules, and now includes ConfigUtils and EnvUtils.
  * Language: JavaScript
  * Created-at: 2025-04-15T16:04:26.780Z
- * Authors: Claude 3.7 Sonnet (v1.0.0), Gemini 2.5 Pro (v2.0.0), Gemini 2.5 Pro (v2.1.0), Gemini 2.5 Pro (v2.1.1), Gemini 2.5 Flash (v2.1.2), Gemini 2.5 Flash (v2.1.3)
+ * Authors: Claude 3.7 Sonnet (v1.0.0), Gemini 2.5 Pro (v2.0.0), Gemini 2.5 Pro (v2.1.0), Gemini 2.5 Pro (v2.1.1), Gemini 2.5 Flash (v2.1.2), Gemini 2.5 Flash (v2.1.3), Gemini 2.5 Flash (v2.1.4)
  */
 
 const ChatUtils = ChatUtils$1;
@@ -11970,6 +12127,13 @@ const {
     getApiKey
 } = EnvUtils;
 
+const {
+    parseContextSection,
+    extractContextSections,
+    extractContextItemsOverviewTableRows,
+    formatContextContent,
+} = ContextUtils;
+
 
 /**
  * GitSenseChatUtils class provides a unified interface to code block and patch utilities.
@@ -12280,8 +12444,11 @@ var GitSenseChatUtils_1 = {
     loadEnv,
     getApiKey,
 
-    // Note: Internal helpers like findAllCodeFences, matchFencesAndExtractBlocks are
-    // typically not exported directly from the facade but are available via CodeBlockUtils object.
+    // Context Utils
+    parseContextSection,
+    extractContextSections,
+    extractContextItemsOverviewTableRows,
+    formatContextContent,
 };
 
 var GitSenseChatUtils$1 = /*@__PURE__*/getDefaultExportFromCjs(GitSenseChatUtils_1);

package/dist/gsc-utils.esm.js

@@ -10453,26 +10453,108 @@ var CodeBlockUtils$4 = {
     removeLineNumbers: removeLineNumbers$1,
 };
 
-/**
+/*
  * Component: ContextUtils
  * Block-UUID: c199efe3-003c-4226-af3c-d460392a6569
  * Parent-UUID: N/A
- * Version: 1.0.0
- * Description: Provides utility functions for parsing context message sections to extract file details and code blocks.
+ * Version: 1.1.0
+ * Description: Provides utility functions for parsing context message sections to extract file details and code blocks, and for formatting content for LLM context.
  * Language: JavaScript
  * Created-at: 2025-05-09T01:36:20.107Z
- * Authors: Gemini 2.5 Flash Thinking (v1.0.0)
+ * Authors: Gemini 2.5 Flash Thinking (v1.0.0), Gemini 2.5 Flash (v1.1.0)
  */
 
 const CodeBlockUtils$3 = CodeBlockUtils$4;
 const MessageUtils$2 = MessageUtils$3;
 
+/**
+ * Formats bytes into human-readable string (KB, MB, GB)
+ * @param {number} bytes - Number of bytes
+ * @returns {string} Formatted size string
+ */
+function _formatBytes(bytes) {
+    if (typeof bytes !== 'number' || isNaN(bytes)) return '0 bytes';
+    if (bytes === 0) return '0 bytes';
+
+    const k = 1024;
+    const sizes = ['bytes', 'KB', 'MB', 'GB'];
+    const i = Math.floor(Math.log(bytes) / Math.log(k));
+
+    // Special case for bytes (no decimal)
+    if (i === 0) return `${bytes} ${sizes[i]}`;
+
+    const value = bytes / Math.pow(k, i);
+    // Show no decimal if whole number
+    const decimalPlaces = value % 1 === 0 ? 0 : 1;
+    return `${value.toFixed(decimalPlaces)} ${sizes[i]}`;
+}
+
+/**
+ * Creates a summary of items for human readers
+ * @param {Array} items - Array of loaded items
+ * @param {string} contentType - Content type
+ * @returns {string} Human-readable summary
+ */
+function _createContextSummary(items, contentType) {
+    if (items.length === 0) return '';
+
+    // Group by files and trees
+    const files = items.filter(item => item.metadata?.type === 'git-blob');
+    const trees = items.filter(item => item.metadata?.type === 'git-tree' || item.metadata?.type === 'git-ref');
+
+    // Calculate total size and tokens
+    const totalSize = items.reduce((sum, item) => sum + (item.size || 0), 0);
+    const totalTokens = items.reduce((sum, item) => sum + (item.tokenCount || 0), 0);
+
+    let summary = contentType === 'file content'
+        ? `\n**Summary:** ${items.length} file${items.length === 1 ? '' : 's'} (${_formatBytes(totalSize)}, ${totalTokens.toLocaleString()} tokens)\n\n`
+        : `\n**Summary:** ${files.length} file${files.length === 1 ? '' : 's'} - ${trees.length} tree${trees.length === 1 ? '' : 's'}\n\n`;
+
+    // Add brief description of first X files
+    const maxFiles = 10;
+    const displayItems = items.slice(0, maxFiles);
+    if (displayItems.length > 0) {
+        displayItems.forEach(item => {
+            if (item.tokenCount) {
+                summary += `- ${item.name} - ${_formatBytes(item.size)}, ${item.tokenCount.toLocaleString()} tokens\n`;
+            } else {
+                summary += `- ${item.name} - Not analyzed\n`;
+            }
+        });
+
+        // Add note if there are more files
+        if (items.length > maxFiles) {
+            summary += `- ... and ${items.length - maxFiles} more\n`;
+        }
+    }
+
+    return summary + "\n";
+}
+
+/**
+ * Escapes backticks in code blocks to prevent premature termination of LLM-generated code blocks.
+ * @param {string} content - The content string to escape.
+ * @returns {{escapedContent: string, escapedLineNums: Array<number>}} Object with escaped content and line numbers of escaped lines.
+ */
+function _escapeCodeBlocks(content) {
+    const escapedLineNums = [];
+    const escapedLines = content.replace(/\n$/, '').split('\n').map((line, i) => {
+        if (line.trimStart().startsWith('```')) {
+            line = '\\' + line.trimStart();
+            escapedLineNums.push(i + 1);
+        }
+        return line;
+    });
+    return { escapedContent: escapedLines.join('\n'), escapedLineNums };
+}
+
+
 /**
  * Parses context details from a context message section.
  * @param {string} sectionText - The text content of a single context section (starting from the file header).
  * @returns {Object|null} An object with file details (name, path, meta, content) or null if parsing fails.
  */
-function parseContextSection(sectionText) {
+function parseContextSection$1(sectionText) {
     const contextSection = {
         name: 'Unknown File',
         content: null,
@@ -10548,7 +10630,7 @@ function parseContextSection(sectionText) {
  * @returns {Array<Object>} An array of parsed context section objects.
  * @throws {Error} If the message content is not a valid context message.
  */
-function extractContextSections(messageContent) {
+function extractContextSections$1(messageContent) {
     // Use the utility function to validate the message type
     if (!MessageUtils$2.isContextMessage(messageContent)) {
         throw new Error("Invalid message type: Content is not a context message.");
@@ -10562,7 +10644,7 @@ function extractContextSections(messageContent) {
 
     // Process sections starting from the first potential path delimiter.
     for (let i = 0; i < sections.length; i++) {
-        const contextSection = parseContextSection(sections[i]);
+        const contextSection = parseContextSection$1(sections[i]);
 
         if (contextSection) {
             contextSections.push(contextSection);
@@ -10577,7 +10659,7 @@ function extractContextSections(messageContent) {
     return contextSections;
 }
 
-function extractContextItemsOverviewTableRows(messageContent) {
+function extractContextItemsOverviewTableRows$1(messageContent) {
     const lines = messageContent.trim().split('\n');
     const startIndex = lines.findIndex(line => line.startsWith('---Start of Overview Items---')) + 4;
 
@@ -10627,10 +10709,85 @@ function extractContextItemsOverviewTableRows(messageContent) {
     return rows;
 }
 
+/**
+ * Formats content for context based on content type.
+ * This function is adapted from the original `formatContentForContext` in `formatterUtils.js`.
+ *
+ * @param {Array<Object>} items - Array of loaded items, each with `chatId`, `name`, `content`, `meta`, `repo` (from chatsApi.getBlobDetailsByChatIds).
+ * @param {string} contentType - Type of content ('file content' or 'overview'). For batch analysis, always 'file content'.
+ * @param {string} contentOption - Option for the content type. For batch analysis, always 'imported'.
+ * @returns {string} Formatted text for context.
+ */
+function formatContextContent$1(items, contentType, contentOption) {
+    if (items.length === 0) {
+        return 'No content loaded';
+    }
+
+    let result = '';
+
+    // Header based on content type
+    if (contentType === 'overview') {
+        result += `## OVERVIEW - ${contentOption.toUpperCase()}\n`;
+    } else {
+        result += `## FILE CONTENT - ${contentOption.toUpperCase()}\n`;
+    }
+
+    // Summary of items
+    result += _createContextSummary(items, contentType);
+    result += "\n---Start of Context---\n\n";
+
+    items.forEach((item, index) => {
+        // Ensure item has necessary properties, especially meta and repo
+        const itemMeta = item.meta || {};
+        const itemRepo = item.repo || {};
+
+        result += "#### `"+item.name+"`\n";
+
+        const { escapedContent, escapedLineNums } = _escapeCodeBlocks(item.content);
+
+        // Always include metadata for batch analysis context
+        result +=
+            `- Repo: ${itemRepo.fullName || 'N/A'}\n`+
+            `- Path: ${itemMeta.path || 'N/A'}\n`;
+
+        // Size and Tokens are specific to 'file content'
+        if (contentType === 'file content') {
+            result += `- Size: ${_formatBytes(itemMeta.size)}\n`;
+            result += `- Tokens: ${itemMeta.tokens?.content?.estimate || 'N/A'}\n`;
+        } else {
+            const type = itemMeta.type || 'unknown';
+            result += `- Type: ${type === 'git-blob' ? 'file' : type === 'git-tree' || type === 'git-ref' ? 'directory' : type }\n`;
+            result += `- Tokens: ${itemMeta.tokens?.analysis?.[contentOption.toLowerCase()]?.estimate || 'N/A'}\n`;
+        }
+
+        result += `- Chat ID: ${item.chatId}\n`;
+
+        if (escapedLineNums.length) {
+            result += `- Escaped Lines: ${escapedLineNums.join(',')}\n`;
+        }
+
+        result += '\n';
+
+        // The original formatterUtils had a special summary handling.
+        // For batch analysis, we want the full file content.
+        // The `if (!escapedContent.includes('Component: New Analyzer Chat') && escapedContent.match(summary))`
+        // logic is specific to the frontend's overview builder and should not be applied here.
+        result += "```"+(itemMeta.highlight || '')+"\n"+escapedContent+"\n```";
+
+        if (index !== items.length - 1) {
+            result += '\n---End of Item---\n';
+        }
+    });
+
+    return result;
+}
+
+
 var ContextUtils$2 = {
-    parseContextSection,
-    extractContextSections,
-    extractContextItemsOverviewTableRows
+    parseContextSection: parseContextSection$1,
+    extractContextSections: extractContextSections$1,
+    extractContextItemsOverviewTableRows: extractContextItemsOverviewTableRows$1,
+    formatContextContent: formatContextContent$1, // Export the new method
 };
 
 /*
@@ -11847,11 +12004,11 @@ var EnvUtils$1 = {
  * Component: GitSenseChatUtils
  * Block-UUID: 5e8d1a9c-0b3f-4e1a-8c7d-9f0b2e1d3a4b
  * Parent-UUID: 7a9b1c8e-f1a4-4b2d-9e8f-6f7a0b1c2d3f
- * Version: 2.1.3
+ * Version: 2.1.4
  * Description: Interface class for GitSense Chat utilities providing a unified API for code block parsing (markdown), extraction, and patch operations. Integrates functionalities from CodeBlockUtils and PatchUtils modules, and now includes ConfigUtils and EnvUtils.
  * Language: JavaScript
  * Created-at: 2025-04-15T16:04:26.780Z
- * Authors: Claude 3.7 Sonnet (v1.0.0), Gemini 2.5 Pro (v2.0.0), Gemini 2.5 Pro (v2.1.0), Gemini 2.5 Pro (v2.1.1), Gemini 2.5 Flash (v2.1.2), Gemini 2.5 Flash (v2.1.3)
+ * Authors: Claude 3.7 Sonnet (v1.0.0), Gemini 2.5 Pro (v2.0.0), Gemini 2.5 Pro (v2.1.0), Gemini 2.5 Pro (v2.1.1), Gemini 2.5 Flash (v2.1.2), Gemini 2.5 Flash (v2.1.3), Gemini 2.5 Flash (v2.1.4)
  */
 
 const ChatUtils = ChatUtils$1;
@@ -11968,6 +12125,13 @@ const {
     getApiKey
 } = EnvUtils;
 
+const {
+    parseContextSection,
+    extractContextSections,
+    extractContextItemsOverviewTableRows,
+    formatContextContent,
+} = ContextUtils;
+
 
 /**
  * GitSenseChatUtils class provides a unified interface to code block and patch utilities.
@@ -12278,8 +12442,11 @@ var GitSenseChatUtils_1 = {
     loadEnv,
     getApiKey,
 
-    // Note: Internal helpers like findAllCodeFences, matchFencesAndExtractBlocks are
-    // typically not exported directly from the facade but are available via CodeBlockUtils object.
+    // Context Utils
+    parseContextSection,
+    extractContextSections,
+    extractContextItemsOverviewTableRows,
+    formatContextContent,
 };
 
 var GitSenseChatUtils$1 = /*@__PURE__*/getDefaultExportFromCjs(GitSenseChatUtils_1);

package/package.json

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

package/src/ContextUtils.js

@@ -1,18 +1,100 @@
-/**
+/*
  * Component: ContextUtils
  * Block-UUID: c199efe3-003c-4226-af3c-d460392a6569
  * Parent-UUID: N/A
- * Version: 1.0.0
- * Description: Provides utility functions for parsing context message sections to extract file details and code blocks.
+ * Version: 1.1.0
+ * Description: Provides utility functions for parsing context message sections to extract file details and code blocks, and for formatting content for LLM context.
  * Language: JavaScript
  * Created-at: 2025-05-09T01:36:20.107Z
- * Authors: Gemini 2.5 Flash Thinking (v1.0.0)
+ * Authors: Gemini 2.5 Flash Thinking (v1.0.0), Gemini 2.5 Flash (v1.1.0)
  */
 
 
 const CodeBlockUtils = require('./CodeBlockUtils');
 const MessageUtils = require('./MessageUtils');
 
+/**
+ * Formats bytes into human-readable string (KB, MB, GB)
+ * @param {number} bytes - Number of bytes
+ * @returns {string} Formatted size string
+ */
+function _formatBytes(bytes) {
+    if (typeof bytes !== 'number' || isNaN(bytes)) return '0 bytes';
+    if (bytes === 0) return '0 bytes';
+
+    const k = 1024;
+    const sizes = ['bytes', 'KB', 'MB', 'GB'];
+    const i = Math.floor(Math.log(bytes) / Math.log(k));
+
+    // Special case for bytes (no decimal)
+    if (i === 0) return `${bytes} ${sizes[i]}`;
+
+    const value = bytes / Math.pow(k, i);
+    // Show no decimal if whole number
+    const decimalPlaces = value % 1 === 0 ? 0 : 1;
+    return `${value.toFixed(decimalPlaces)} ${sizes[i]}`;
+}
+
+/**
+ * Creates a summary of items for human readers
+ * @param {Array} items - Array of loaded items
+ * @param {string} contentType - Content type
+ * @returns {string} Human-readable summary
+ */
+function _createContextSummary(items, contentType) {
+    if (items.length === 0) return '';
+
+    // Group by files and trees
+    const files = items.filter(item => item.metadata?.type === 'git-blob');
+    const trees = items.filter(item => item.metadata?.type === 'git-tree' || item.metadata?.type === 'git-ref');
+
+    // Calculate total size and tokens
+    const totalSize = items.reduce((sum, item) => sum + (item.size || 0), 0);
+    const totalTokens = items.reduce((sum, item) => sum + (item.tokenCount || 0), 0);
+
+    let summary = contentType === 'file content'
+        ? `\n**Summary:** ${items.length} file${items.length === 1 ? '' : 's'} (${_formatBytes(totalSize)}, ${totalTokens.toLocaleString()} tokens)\n\n`
+        : `\n**Summary:** ${files.length} file${files.length === 1 ? '' : 's'} - ${trees.length} tree${trees.length === 1 ? '' : 's'}\n\n`;
+
+    // Add brief description of first X files
+    const maxFiles = 10;
+    const displayItems = items.slice(0, maxFiles);
+    if (displayItems.length > 0) {
+        displayItems.forEach(item => {
+            if (item.tokenCount) {
+                summary += `- ${item.name} - ${_formatBytes(item.size)}, ${item.tokenCount.toLocaleString()} tokens\n`;
+            } else {
+                summary += `- ${item.name} - Not analyzed\n`;
+            }
+        });
+
+        // Add note if there are more files
+        if (items.length > maxFiles) {
+            summary += `- ... and ${items.length - maxFiles} more\n`;
+        }
+    }
+
+    return summary + "\n";
+}
+
+/**
+ * Escapes backticks in code blocks to prevent premature termination of LLM-generated code blocks.
+ * @param {string} content - The content string to escape.
+ * @returns {{escapedContent: string, escapedLineNums: Array<number>}} Object with escaped content and line numbers of escaped lines.
+ */
+function _escapeCodeBlocks(content) {
+    const escapedLineNums = [];
+    const escapedLines = content.replace(/\n$/, '').split('\n').map((line, i) => {
+        if (line.trimStart().startsWith('```')) {
+            line = '\\' + line.trimStart();
+            escapedLineNums.push(i + 1);
+        }
+        return line;
+    });
+    return { escapedContent: escapedLines.join('\n'), escapedLineNums };
+}
+
+
 /**
  * Parses context details from a context message section.
  * @param {string} sectionText - The text content of a single context section (starting from the file header).
@@ -173,8 +255,84 @@ function extractContextItemsOverviewTableRows(messageContent) {
     return rows;
 }
 
+/**
+ * Formats content for context based on content type.
+ * This function is adapted from the original `formatContentForContext` in `formatterUtils.js`.
+ *
+ * @param {Array<Object>} items - Array of loaded items, each with `chatId`, `name`, `content`, `meta`, `repo` (from chatsApi.getBlobDetailsByChatIds).
+ * @param {string} contentType - Type of content ('file content' or 'overview'). For batch analysis, always 'file content'.
+ * @param {string} contentOption - Option for the content type. For batch analysis, always 'imported'.
+ * @returns {string} Formatted text for context.
+ */
+function formatContextContent(items, contentType, contentOption) {
+    if (items.length === 0) {
+        return 'No content loaded';
+    }
+
+    let result = '';
+
+    // Header based on content type
+    if (contentType === 'overview') {
+        const label = contentOption === "long" ? "comprehensive" : "short";
+        result += `## OVERVIEW - ${contentOption.toUpperCase()}\n`;
+    } else {
+        result += `## FILE CONTENT - ${contentOption.toUpperCase()}\n`;
+    }
+
+    // Summary of items
+    result += _createContextSummary(items, contentType);
+    result += "\n---Start of Context---\n\n";
+
+    items.forEach((item, index) => {
+        // Ensure item has necessary properties, especially meta and repo
+        const itemMeta = item.meta || {};
+        const itemRepo = item.repo || {};
+
+        result += "#### `"+item.name+"`\n";
+
+        const { escapedContent, escapedLineNums } = _escapeCodeBlocks(item.content);
+
+        // Always include metadata for batch analysis context
+        result +=
+            `- Repo: ${itemRepo.fullName || 'N/A'}\n`+
+            `- Path: ${itemMeta.path || 'N/A'}\n`;
+
+        // Size and Tokens are specific to 'file content'
+        if (contentType === 'file content') {
+            result += `- Size: ${_formatBytes(itemMeta.size)}\n`;
+            result += `- Tokens: ${itemMeta.tokens?.content?.estimate || 'N/A'}\n`;
+        } else {
+            const type = itemMeta.type || 'unknown';
+            result += `- Type: ${type === 'git-blob' ? 'file' : type === 'git-tree' || type === 'git-ref' ? 'directory' : type }\n`;
+            result += `- Tokens: ${itemMeta.tokens?.analysis?.[contentOption.toLowerCase()]?.estimate || 'N/A'}\n`;
+        }
+
+        result += `- Chat ID: ${item.chatId}\n`;
+
+        if (escapedLineNums.length) {
+            result += `- Escaped Lines: ${escapedLineNums.join(',')}\n`;
+        }
+
+        result += '\n';
+
+        // The original formatterUtils had a special summary handling.
+        // For batch analysis, we want the full file content.
+        // The `if (!escapedContent.includes('Component: New Analyzer Chat') && escapedContent.match(summary))`
+        // logic is specific to the frontend's overview builder and should not be applied here.
+        result += "```"+(itemMeta.highlight || '')+"\n"+escapedContent+"\n```";
+
+        if (index !== items.length - 1) {
+            result += '\n---End of Item---\n';
+        }
+    });
+
+    return result;
+}
+
+
 module.exports = {
     parseContextSection,
     extractContextSections,
-    extractContextItemsOverviewTableRows
+    extractContextItemsOverviewTableRows,
+    formatContextContent, // Export the new method
 };

package/src/GitSenseChatUtils.js

@@ -2,11 +2,11 @@
  * Component: GitSenseChatUtils
  * Block-UUID: 5e8d1a9c-0b3f-4e1a-8c7d-9f0b2e1d3a4b
  * Parent-UUID: 7a9b1c8e-f1a4-4b2d-9e8f-6f7a0b1c2d3f
- * Version: 2.1.3
+ * Version: 2.1.4
  * Description: Interface class for GitSense Chat utilities providing a unified API for code block parsing (markdown), extraction, and patch operations. Integrates functionalities from CodeBlockUtils and PatchUtils modules, and now includes ConfigUtils and EnvUtils.
  * Language: JavaScript
  * Created-at: 2025-04-15T16:04:26.780Z
- * Authors: Claude 3.7 Sonnet (v1.0.0), Gemini 2.5 Pro (v2.0.0), Gemini 2.5 Pro (v2.1.0), Gemini 2.5 Pro (v2.1.1), Gemini 2.5 Flash (v2.1.2), Gemini 2.5 Flash (v2.1.3)
+ * Authors: Claude 3.7 Sonnet (v1.0.0), Gemini 2.5 Pro (v2.0.0), Gemini 2.5 Pro (v2.1.0), Gemini 2.5 Pro (v2.1.1), Gemini 2.5 Flash (v2.1.2), Gemini 2.5 Flash (v2.1.3), Gemini 2.5 Flash (v2.1.4)
  */
 
 
@@ -124,6 +124,13 @@ const {
     getApiKey
 } = EnvUtils;
 
+const {
+    parseContextSection,
+    extractContextSections,
+    extractContextItemsOverviewTableRows,
+    formatContextContent,
+} = ContextUtils;
+
 
 /**
  * GitSenseChatUtils class provides a unified interface to code block and patch utilities.
@@ -434,6 +441,9 @@ module.exports = {
     loadEnv,
     getApiKey,
 
-    // Note: Internal helpers like findAllCodeFences, matchFencesAndExtractBlocks are
-    // typically not exported directly from the facade but are available via CodeBlockUtils object.
+    // Context Utils
+    parseContextSection,
+    extractContextSections,
+    extractContextItemsOverviewTableRows,
+    formatContextContent,
 };