@gitsense/gsc-utils 0.2.21 → 0.2.24

package/src/ContextUtils.js

@@ -1,12 +1,12 @@
 /*
  * Component: ContextUtils
- * Block-UUID: c018b1f9-2291-4bc9-9c4b-ab53a5db745e
- * Parent-UUID: c199efe3-003c-4226-af3c-d460392a6569
- * Version: 1.2.0
+ * Block-UUID: a0b71292-b1cc-401a-8ce2-544a047b0fef
+ * Parent-UUID: c018b1f9-2291-4bc9-9c4b-ab53a5db745e
+ * Version: 1.3.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), Gemini 2.5 Flash (v1.1.0), Qwen 3 Coder 480B - Cerebras (v1.2.0)
+ * Authors: Gemini 2.5 Flash Thinking (v1.0.0), Gemini 2.5 Flash (v1.1.0), Qwen 3 Coder 480B - Cerebras (v1.2.0), Qwen 3 Coder 480B - Cerebras (v1.3.0)
  */
 
 
@@ -188,12 +188,26 @@ function extractContextSections(messageContent) {
     const [summary, items] = messageContent.split(/\n---Start of Context---\n\n/);
     const sections = items.split(/\n---End of Item---\n/);
 
+    // Determine the origin of the context based on the message header
+    let contextOrigin = 'unknown'; // Default value if not determinable
+    if (messageContent.includes("## FILE CONTENT - WORKING DIRECTORY")) {
+        contextOrigin = 'working-directory';
+    } else if (messageContent.includes("## FILE CONTENT - IMPORTED")) {
+        contextOrigin = 'imported';
+    } else if (messageContent.includes("## OVERVIEW - IMPORTED")) {
+         // Handle the overview case as well, though it uses 'file content' type
+         contextOrigin = 'imported';
+    }
+
     // Process sections starting from the first potential path delimiter.
     for (let i = 0; i < sections.length; i++) {
         const contextSection = parseContextSection(sections[i]);
 
         if (contextSection) {
             contextSections.push(contextSection);
+            // Attach the determined context origin to the section
+            // This provides information on how the context was introduced
+            contextSection.contextOrigin = contextOrigin;
         }
     }
 
@@ -214,6 +228,7 @@ function extractContextItemsOverviewTableRows(messageContent) {
         return null;
     }
 
+    // Map the column number to the type
     const col2Field = {
         1: 'chatId',
         2: 'type', // file, tree, etc.
@@ -339,4 +354,3 @@ module.exports = {
     extractContextItemsOverviewTableRows,
     formatContextContent,
 };
-

package/src/DateUtils.js

@@ -0,0 +1,113 @@
+/**
+ * Component: Date Utilities
+ * Block-UUID: fef3b0f4-8055-4690-9336-e68a9cc33a61
+ * Parent-UUID: 716e5ce9-84df-4f12-89e7-4a28e4a39a81
+ * Version: 1.0.0
+ * Description: Date formatting and manipulation utilities for GitSense Chat
+ * Language: JavaScript
+ * Created-at: 2025-10-11T23:26:20.815Z
+ * Authors: Claude-3.5-Sonnet (v1.0.0), Qwen 3 Coder 480B - Cerebras (v1.0.0)
+ */
+
+
+/**
+ * Ensures a date string has a timezone indicator
+ * @param {string} dateString - Date string in format "YYYY-MM-DD(T| )HH:mm:ss.SSS"
+ * @returns {string} Date string with 'Z' timezone indicator if not present
+ */
+function normalizeDateTime(dateString) {
+    return dateString.includes('Z') ? dateString : dateString + 'Z';
+}
+
+/**
+ * Calculates the time difference between now and a given date
+ * @param {string} dateString - Date string to compare against current time
+ * @returns {number} Difference in seconds
+ */
+function getTimeDifference(dateString) {
+    const now = new Date();
+    const date = new Date(normalizeDateTime(dateString));
+    return Math.floor((now - date) / 1000);
+}
+
+/**
+ * Formats a time difference in seconds to a human-readable string
+ * @param {number} diff - Time difference in seconds
+ * @returns {string} Formatted string (e.g., "5s ago", "2m ago", "3h ago", "2d ago")
+ */
+function formatTimeDifference(diff) {
+    if (diff < 60) {
+        return `${diff}s ago`;
+    } else if (diff < 3600) {
+        const minutes = Math.floor(diff / 60);
+        return `${minutes}m ago`;
+    } else if (diff < 86400) {
+        const hours = Math.floor(diff / 3600);
+        return `${hours}h ago`;
+    } else {
+        const days = Math.floor(diff / 86400);
+        return `${days}d ago`;
+    }
+}
+
+/**
+ * Formats a date string into a relative time string
+ * @param {string} dateString - Date string to format
+ * @returns {string} Formatted relative time string
+ */
+function formatAge(dateString) {
+    if (!dateString) {
+        return 'N/A';
+    }
+
+    try {
+        const diff = getTimeDifference(dateString);
+        return formatTimeDifference(diff);
+    } catch (error) {
+        console.error('Error formatting date:', error);
+        return 'Invalid date';
+    }
+}
+
+/**
+ * Validates a date string format
+ * @param {string} dateString - Date string to validate
+ * @returns {boolean} True if date string is valid
+ */
+function isValidDateString(dateString) {
+    if (!dateString) return false;
+    
+    const pattern = /^\d{4}-\d{2}-\d{2}(T| )\d{2}:\d{2}:\d{2}\.\d{3}Z?$/;
+    if (!pattern.test(dateString)) return false;
+
+    const date = new Date(normalizeDateTime(dateString));
+    return date instanceof Date && !isNaN(date);
+}
+
+/**
+ * Compares two date strings
+ * @param {string} dateA - First date string
+ * @param {string} dateB - Second date string
+ * @returns {number} -1 if dateA is earlier, 0 if equal, 1 if dateA is later
+ */
+function compareDates(dateA, dateB) {
+    if (!isValidDateString(dateA) || !isValidDateString(dateB)) {
+        throw new Error(`Invalid date string format. A: ${dateA} B: ${dateB})`);
+    }
+
+    const timeA = new Date(normalizeDateTime(dateA)).getTime();
+    const timeB = new Date(normalizeDateTime(dateB)).getTime();
+    
+    if (timeA < timeB) return -1;
+    if (timeA > timeB) return 1;
+    return 0;
+}
+
+module.exports = {
+    formatAge,
+    isValidDateString,
+    compareDates,
+    normalizeDateTime,
+    getTimeDifference,
+    formatTimeDifference
+};

package/src/FormatterUtils.js

@@ -0,0 +1,55 @@
+/**
+ * Component: Formatter Utilities
+ * Block-UUID: 9b1e07bf-e92c-43c1-9ac0-5dacdb7ae618
+ * Parent-UUID: 9c07d12f-5a05-4402-99d2-85d872d7b2f7
+ * Version: 1.0.0
+ * Description: Utility functions for formatting content in GitSense Chat
+ * Language: JavaScript
+ * Created-at: 2025-10-11T23:27:15.420Z
+ * Authors: Claude 3.7 Sonnet (v1.0.0), Claude 3.7 Sonnet (v1.1.0), Gemini 2.5 Flash Thinking (v1.2.0), Gemini 2.5 Flash Thinking (v1.3.0), Qwen 3 Coder 480B - Cerebras (v1.4.0), Qwen 3 Coder 480B - Cerebras (v1.5.0), Qwen 3 Coder 480B - Cerebras (v1.0.0)
+ */
+
+
+/**
+ * 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]}`;
+}
+
+/**
+ * Formats token count into human-readable string (k, m, b)
+ * @param {number} count - Number of tokens
+ * @returns {string} Formatted token string
+ */
+function formatTokens(count) {
+    if (typeof count !== 'number' || isNaN(count)) return '0';
+    if (count === 0) return '0';
+
+    if (count < 1000) return `${count}`;
+    if (count < 1000000) return `${(count/1000).toFixed(count >= 10000 ? 1 : 0)}k`;
+    if (count < 1000000000) return `${(count/1000000).toFixed(1)}m`;
+
+    // For billions
+    return `${(count/1000000000).toFixed(1)}b`;
+}
+
+module.exports = {
+    formatBytes,
+    formatTokens
+};

package/src/GitSenseChatUtils.js

@@ -1,12 +1,12 @@
 /*
  * Component: GitSenseChatUtils
- * Block-UUID: 5e8d1a9c-0b3f-4e1a-8c7d-9f0b2e1d3a4b
- * Parent-UUID: 7a9b1c8e-f1a4-4b2d-9e8f-6f7a0b1c2d3f
- * Version: 2.1.4
+ * Block-UUID: d7cdbb94-f335-4f85-bdc4-0dd3ae95127e
+ * Parent-UUID: 5e8d1a9c-0b3f-4e1a-8c7d-9f0b2e1d3a4b
+ * Version: 2.1.5
  * 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), Gemini 2.5 Flash (v2.1.4)
+ * 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), Qwen 3 Coder 480B - Cerebras (v2.1.5)
  */
 
 
@@ -20,9 +20,20 @@ const PatchUtils = require('./PatchUtils');
 const GSToolBlockUtils = require('./GSToolBlockUtils');
 const LLMUtils = require('./LLMUtils');
 const JsonUtils = require('./JsonUtils');
+const DateUtils = require('./DateUtils');
+const FormatterUtils = require('./FormatterUtils');
 const ConfigUtils = require('./ConfigUtils');
 const EnvUtils = require('./EnvUtils');
 
+const {
+    formatAge,
+    isValidDateString,
+    compareDates,
+    normalizeDateTime,
+    getTimeDifference,
+    formatTimeDifference
+} = DateUtils;
+
 const {
     estimateTokens
 } = LLMUtils;
@@ -124,6 +135,11 @@ const {
     getApiKey
 } = EnvUtils;
 
+const {
+    formatBytes,
+    formatTokens,
+} = FormatterUtils;
+
 const {
     parseContextSection,
     extractContextSections,
@@ -338,6 +354,12 @@ class GitSenseChatUtils {
 // Export the main class, the aggregated CodeBlockUtils, PatchUtils,
 // and individual functions for backward compatibility or direct use.
 module.exports = {
+    // New Utility Modules
+    DateUtils,
+    FormatterUtils,
+
+    // Date Utility Functions
+
     // Main class
     GitSenseChatUtils,
 
@@ -353,6 +375,9 @@ module.exports = {
     GSToolBlockUtils,
     JsonUtils,
     ConfigUtils,
+    DateUtils,
+    FormatterUtils,
+
     EnvUtils,
 
     // --- Individual Function Exports (sourced correctly) ---
@@ -427,6 +452,18 @@ module.exports = {
     // LLM Utils
     estimateTokens,
 
+    // Date Utils
+    formatAge,
+    isValidDateString,
+    compareDates,
+    normalizeDateTime,
+    getTimeDifference,
+    formatTimeDifference,
+
+    // Formatter Utils
+    formatBytes,
+    formatTokens,
+
     // GS Tool Block
     isToolBlock,
     parseToolBlock,

package/src/PatchUtils/patchProcessor.js

@@ -283,7 +283,9 @@ function createPatchFromCodeBlocks(CodeBlockUtils, sourceCodeBlockText, targetCo
     const targetContent = targetContentTemp.join('\n\n');
 
     // Get the number of lines in the header + two blank lines
-    const sourceHeaderLineCount = sourceHeaderText.split('\n').length;
+    // Note, before the code block header format was solidified, we use to include 'Updated-at' but no more so
+    // we need to filter it out from the source header
+    const sourceHeaderLineCount = sourceHeaderText.split('\n').filter(line => !line.includes('Updated-at')).length;
     const targetHeaderLineCount = targetHeaderText.split('\n').length;
 
     // To keep things simple we are going to require the source and target header line count to be the same.
@@ -291,7 +293,7 @@ function createPatchFromCodeBlocks(CodeBlockUtils, sourceCodeBlockText, targetCo
     if (sourceHeaderLineCount !== targetHeaderLineCount) {
         // Some LLMs will not generate a Parent-UUID for the first version so we won't make this
         // fatal if the sourceHeader does not have a Parent-UUID
-        if (sourceHeaderLineCount.includes('Parent-UUID')) {
+        if (sourceHeaderText.includes('Parent-UUID')) {
             throw new Error('Source and target header line count must be the same');
         }
     }