@gitsense/gsc-utils 0.2.35 → 0.2.36

package/dist/gsc-utils.cjs.js

@@ -9964,7 +9964,7 @@ function fixTextCodeBlocks$2(text) {
                     const [fieldPart, valuePart] = line.split(':').map(p => p.trim());
 
                     // Skip if N/A or contains unexpected characters
-                    if (valuePart === 'N/A' || valuePart.match(/\(/)) {
+                    if (valuePart === 'N/A' || !valuePart.match(/\w-/)) {
                         return line;
                     }
                     // Validate UUID
@@ -11003,7 +11003,7 @@ const { formatWithLineNumbers: formatWithLineNumbers$1, formatBlockWithLineNumbe
 const { getLineage: getLineage$1 } = lineageTracer;
 
 // Export all imported items
-var CodeBlockUtils$7 = {
+var CodeBlockUtils$8 = {
     // Constants
     COMMENT_STYLES: COMMENT_STYLES$1,
 
@@ -11063,6 +11063,302 @@ var CodeBlockUtils$7 = {
     removeLineNumbers: removeLineNumbers$1,
 };
 
+/**
+ * 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$1(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$1(dateString) {
+    const now = new Date();
+    const date = new Date(normalizeDateTime$1(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$1(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$1(dateString) {
+    if (!dateString) {
+        return 'N/A';
+    }
+
+    try {
+        const diff = getTimeDifference$1(dateString);
+        return formatTimeDifference$1(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$1(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$1(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$1(dateA, dateB) {
+    if (!isValidDateString$1(dateA) || !isValidDateString$1(dateB)) {
+        throw new Error(`Invalid date string format. A: ${dateA} B: ${dateB})`);
+    }
+
+    const timeA = new Date(normalizeDateTime$1(dateA)).getTime();
+    const timeB = new Date(normalizeDateTime$1(dateB)).getTime();
+    
+    if (timeA < timeB) return -1;
+    if (timeA > timeB) return 1;
+    return 0;
+}
+
+var DateUtils$1 = {
+    formatAge: formatAge$1,
+    isValidDateString: isValidDateString$1,
+    compareDates: compareDates$1,
+    normalizeDateTime: normalizeDateTime$1,
+    getTimeDifference: getTimeDifference$1,
+    formatTimeDifference: formatTimeDifference$1
+};
+
+/**
+ * Component: CLI Contract Utilities
+ * Block-UUID: a57b72a0-0d95-44a2-8f3f-ab6ee84b3197
+ * Parent-UUID: 9050e244-793a-4dc6-8571-b96f38927f69
+ * Version: 1.1.0
+ * Description: Utilities for parsing GitSense Chat CLI contract messages and determining save modes for code blocks.
+ * Language: JavaScript
+ * Created-at: 2026-02-27T02:26:15.078Z
+ * Authors: GLM-4.7 (v1.0.0), GLM-4.7 (v1.1.0)
+ */
+
+const CodeBlockUtils$7 = CodeBlockUtils$8;
+
+/**
+ * Parses a contract message object to extract the contract data.
+ * Handles cases where data might be in 'content' (as JSON string) or 'metadata'.
+ * 
+ * @param {Object} message - The chat message object.
+ * @returns {Object|null} The parsed contract data object or null if invalid.
+ */
+function parseContractMessage(message) {
+    if (!message) {
+        return null;
+    }
+
+    // We expect the message type to be 'gsc-cli-contract'
+    if (message.type !== 'gsc-cli-contract') {
+        return null;
+    }
+
+    const content = message.message || '';
+    const lines = content.split('\n');
+    
+    const contractData = {};
+    let inTable = false;
+    let foundHeader = false;
+
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i].trim();
+
+        // Check for the CLI Contract header
+        if (line.startsWith('### CLI Contract')) {
+            foundHeader = true;
+            continue;
+        }
+
+        // If we haven't found the header yet, keep looking
+        if (!foundHeader) {
+            continue;
+        }
+
+        // Check for table separator (e.g., | :--- | :--- |)
+        if (line.includes('---')) {
+            inTable = true;
+            continue;
+        }
+
+        // Parse table rows
+        if (inTable && line.startsWith('|')) {
+            // Remove leading/trailing pipes and split by pipe
+            const parts = line.substring(1, line.length - 1).split('|').map(p => p.trim());
+            
+            if (parts.length >= 2) {
+                const key = parts[0].replace(/\*\*/g, '').toLowerCase(); // Remove bold markdown and normalize
+                const value = parts[1];
+
+                if (key === 'uuid') contractData.uuid = value;
+                else if (key === 'expires at') contractData.expiresAt = value;
+                else if (key === 'status') contractData.status = value;
+                else if (key === 'description') contractData.description = value;
+            }
+        }
+    }
+
+    return contractData;
+}
+
+/**
+ * Checks if a message is a contract message.
+ * 
+ * @param {Object} message - The chat message object.
+ * @returns {boolean} True if the message is a contract message.
+ */
+function isContractMessage(message) {
+    return message && message.type === 'gsc-cli-contract';
+}
+
+/**
+ * Determines if a contract is currently active based on its expiration time.
+ * 
+ * @param {Object} contractData - The contract data object (must contain expiresAt).
+ * @returns {boolean} True if the contract is active, false otherwise.
+ */
+function isContractActive(contractData) {
+    if (!contractData || !contractData.expiresAt) {
+        return false;
+    }
+
+    const now = Date.now();
+    const expiresAt = new Date(contractData.expiresAt).getTime();
+
+    return now < expiresAt;
+}
+
+/**
+ * Determines the save mode (update vs new-file) based on the code content.
+ * Parses the code block header to check for a Parent-UUID.
+ * 
+ * @param {string} rawCodeContent - The full content of the code block (including header).
+ * @returns {Object} An object { mode: 'update'|'new-file', metadata: Object }.
+ */
+function determineSaveMode(rawCodeContent) {
+    const { blocks } = CodeBlockUtils$7.processCodeBlocks(rawCodeContent, { silent: true });
+    
+    if (!blocks || blocks.length === 0) {
+        return { mode: 'unknown', metadata: null };
+    }
+
+    const block = blocks[0];
+    const header = block.header || {};
+    const parentUUID = header['Parent-UUID'];
+
+    let mode = 'new-file';
+
+    // If Parent-UUID exists and is not N/A, it's an update
+    if (parentUUID && parentUUID !== 'N/A') {
+        mode = 'update';
+    }
+
+    return {
+        mode,
+        metadata: {
+            blockUUID: header['Block-UUID'],
+            parentUUID: parentUUID,
+            language: block.language
+        }
+    };
+}
+
+/**
+ * Extracts key metadata from a code block content.
+ * 
+ * @param {string} rawCodeContent - The full content of the code block.
+ * @returns {Object|null} Metadata object or null if parsing fails.
+ */
+function extractCodeMetadata(rawCodeContent) {
+    const result = determineSaveMode(rawCodeContent);
+    return result.metadata;
+}
+
+/**
+ * Formats the remaining time until expiration.
+ * 
+ * @param {string|Date} expiresAt - The expiration timestamp.
+ * @returns {string} Formatted string (e.g., "45m", "2h", "1d").
+ */
+function formatTimeRemaining(expiresAt) {
+    const now = Date.now();
+    const expiry = new Date(expiresAt).getTime();
+    const diffMs = expiry - now;
+
+    if (diffMs <= 0) return 'Expired';
+
+    const diffMins = Math.floor(diffMs / 60000);
+    
+    if (diffMins < 60) return `${diffMins}m`;
+    
+    const diffHours = Math.floor(diffMins / 60);
+    if (diffHours < 24) return `${diffHours}h`;
+    
+    const diffDays = Math.floor(diffHours / 24);
+    return `${diffDays}d`;
+}
+
+var CLIContractUtils$1 = {
+    parseContractMessage,
+    isContractMessage,
+    isContractActive,
+    determineSaveMode,
+    extractCodeMetadata,
+    formatTimeRemaining
+};
+
 /*
  * Component: ContextUtils
  * Block-UUID: 534c348d-a11f-4de6-ad15-f33068d51fb8
@@ -11074,7 +11370,7 @@ var CodeBlockUtils$7 = {
  * 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), Qwen 3 Coder 480B - Cerebras (v1.4.0)
  */
 
-const CodeBlockUtils$6 = CodeBlockUtils$7;
+const CodeBlockUtils$6 = CodeBlockUtils$8;
 const MessageUtils$2 = MessageUtils$3;
 
 /**
@@ -11534,7 +11830,7 @@ var constants = {
  * Authors: Gemini 2.5 Flash (v1.0.0)
  */
 
-const CodeBlockUtils$5 = CodeBlockUtils$7;
+const CodeBlockUtils$5 = CodeBlockUtils$8;
 const GSToolBlockUtils$1 = GSToolBlockUtils$3;
 const JsonUtils$1 = JsonUtils$2;
 const { ANALYZE_HEADER_PREFIX } = constants;
@@ -11844,7 +12140,7 @@ const fs$7 = require$$0.promises;
 const path$5 = require$$1;
 const { getAnalyzerInstructionsContent: getAnalyzerInstructionsContent$2 } = instructionLoader;
 const { preprocessJsonForValidation: preprocessJsonForValidation$4 } = jsonParser;
-const CodeBlockUtils$4 = CodeBlockUtils$7;
+const CodeBlockUtils$4 = CodeBlockUtils$8;
 
 /**
  * Reads and parses the config.json file in a directory.
@@ -12151,7 +12447,7 @@ var saver = {
 
 const fs$5 = require$$0.promises;
 const path$3 = require$$1;
-const CodeBlockUtils$3 = CodeBlockUtils$7;
+const CodeBlockUtils$3 = CodeBlockUtils$8;
 const { preprocessJsonForValidation: preprocessJsonForValidation$3 } = jsonParser;
 
 /**
@@ -12629,7 +12925,7 @@ var defaultPromptLoader = {
 
 const fs$2 = require$$0.promises;
 const path = require$$1;
-const CodeBlockUtils$2 = CodeBlockUtils$7;
+const CodeBlockUtils$2 = CodeBlockUtils$8;
 const { preprocessJsonForValidation: preprocessJsonForValidation$2 } = jsonParser;
 const { isValidDirName: isValidDirName$1 } = discovery;
 const { readConfig } = discovery;
@@ -12815,7 +13111,7 @@ var updater = {
  */
 
 require$$0.promises;
-const CodeBlockUtils$1 = CodeBlockUtils$7;
+const CodeBlockUtils$1 = CodeBlockUtils$8;
 const { preprocessJsonForValidation: preprocessJsonForValidation$1 } = jsonParser;
 const { isValidDirName } = discovery;
 const { saveConfiguration: saveConfiguration$1 } = saver;
@@ -13022,119 +13318,6 @@ var LLMUtils$1 = {
     estimateTokens: estimateTokens$1,
 };
 
-/**
- * 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$1(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$1(dateString) {
-    const now = new Date();
-    const date = new Date(normalizeDateTime$1(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$1(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$1(dateString) {
-    if (!dateString) {
-        return 'N/A';
-    }
-
-    try {
-        const diff = getTimeDifference$1(dateString);
-        return formatTimeDifference$1(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$1(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$1(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$1(dateA, dateB) {
-    if (!isValidDateString$1(dateA) || !isValidDateString$1(dateB)) {
-        throw new Error(`Invalid date string format. A: ${dateA} B: ${dateB})`);
-    }
-
-    const timeA = new Date(normalizeDateTime$1(dateA)).getTime();
-    const timeB = new Date(normalizeDateTime$1(dateB)).getTime();
-    
-    if (timeA < timeB) return -1;
-    if (timeA > timeB) return 1;
-    return 0;
-}
-
-var DateUtils$1 = {
-    formatAge: formatAge$1,
-    isValidDateString: isValidDateString$1,
-    compareDates: compareDates$1,
-    normalizeDateTime: normalizeDateTime$1,
-    getTimeDifference: getTimeDifference$1,
-    formatTimeDifference: formatTimeDifference$1
-};
-
 /**
  * Component: Formatter Utilities
  * Block-UUID: 8512c809-87b0-4f90-af9d-b3dca204c4de
@@ -13345,6 +13528,9 @@ const h$1 = {
     createArticle: (params) => {
         return createElement("article", params);
     },
+    createBlockquote: (params) => {
+        return createElement("blockquote", params);
+    },
     createBr: () => {
         return createElement("br");
     },
@@ -26377,15 +26563,16 @@ var CompactChatUtils$1 = {
  * Component: GitSenseChatUtils
  * Block-UUID: c1b6c4d3-7959-4eb6-8022-6cd7aa59240d
  * Parent-UUID: 1793b3a8-4881-4306-bfdf-673eef503679
- * Version: 2.7.0
- * 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, EnvUtils, ObjectUtils, MetaRawResultUtils, and CompactChatUtils.
+ * Version: 2.8.0
+ * 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, EnvUtils, ObjectUtils, MetaRawResultUtils, CompactChatUtils, and CLIContractUtils.
  * Language: JavaScript
  * Created-at: 2025-10-17T17:13:04.663Z
- * 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), Qwen 3 Coder 480B - Cerebras (v2.2.0), Qwen 3 Coder 480B - Cerebras (v2.2.1), Claude Haiku 4.5 (v2.3.0), Qwen 3 Coder 480B - Cerebras (v2.4.0), Qwen 3 Coder 480B - Cerebras (v2.5.0), GLM-4.6 (v2.6.0), GLM-4.6 (v2.7.0)
+ * 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), Qwen 3 Coder 480B - Cerebras (v2.2.0), Qwen 3 Coder 480B - Cerebras (v2.2.1), Claude Haiku 4.5 (v2.3.0), Qwen 3 Coder 480B - Cerebras (v2.4.0), Qwen 3 Coder 480B - Cerebras (v2.5.0), GLM-4.6 (v2.6.0), GLM-4.6 (v2.7.0), GLM-4.7 (v2.8.0)
  */
 
 const ChatUtils = ChatUtils$2;
-const CodeBlockUtils = CodeBlockUtils$7;
+const CLIContractUtils = CLIContractUtils$1;
+const CodeBlockUtils = CodeBlockUtils$8;
 const ContextUtils = ContextUtils$2;
 const MessageUtils = MessageUtils$3;
 const AnalysisBlockUtils = AnalysisBlockUtils$3;
@@ -26801,6 +26988,7 @@ var GitSenseChatUtils_1 = {
     GSToolBlockUtils,
     JsonUtils,
     ConfigUtils,
+    CLIContractUtils,
     DateUtils,
     LanguageNameUtils,
     FormatterUtils,
@@ -26951,6 +27139,14 @@ var GitSenseChatUtils_1 = {
     parseTableRow,
     parseSize,
     parseTokens,
+
+    // Contract Utilities (from CLIContractUtils)
+    parseContractMessage: CLIContractUtils.parseContractMessage,
+    isContractMessage: CLIContractUtils.isContractMessage,
+    isContractActive: CLIContractUtils.isContractActive,
+    determineSaveMode: CLIContractUtils.determineSaveMode,
+    extractCodeMetadata: CLIContractUtils.extractCodeMetadata,
+    formatTimeRemaining: CLIContractUtils.formatTimeRemaining,
 };
 
 var GitSenseChatUtils$1 = /*@__PURE__*/getDefaultExportFromCjs(GitSenseChatUtils_1);

package/dist/gsc-utils.esm.js

@@ -9962,7 +9962,7 @@ function fixTextCodeBlocks$2(text) {
                     const [fieldPart, valuePart] = line.split(':').map(p => p.trim());
 
                     // Skip if N/A or contains unexpected characters
-                    if (valuePart === 'N/A' || valuePart.match(/\(/)) {
+                    if (valuePart === 'N/A' || !valuePart.match(/\w-/)) {
                         return line;
                     }
                     // Validate UUID
@@ -11001,7 +11001,7 @@ const { formatWithLineNumbers: formatWithLineNumbers$1, formatBlockWithLineNumbe
 const { getLineage: getLineage$1 } = lineageTracer;
 
 // Export all imported items
-var CodeBlockUtils$7 = {
+var CodeBlockUtils$8 = {
     // Constants
     COMMENT_STYLES: COMMENT_STYLES$1,
 
@@ -11061,6 +11061,302 @@ var CodeBlockUtils$7 = {
     removeLineNumbers: removeLineNumbers$1,
 };
 
+/**
+ * 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$1(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$1(dateString) {
+    const now = new Date();
+    const date = new Date(normalizeDateTime$1(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$1(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$1(dateString) {
+    if (!dateString) {
+        return 'N/A';
+    }
+
+    try {
+        const diff = getTimeDifference$1(dateString);
+        return formatTimeDifference$1(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$1(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$1(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$1(dateA, dateB) {
+    if (!isValidDateString$1(dateA) || !isValidDateString$1(dateB)) {
+        throw new Error(`Invalid date string format. A: ${dateA} B: ${dateB})`);
+    }
+
+    const timeA = new Date(normalizeDateTime$1(dateA)).getTime();
+    const timeB = new Date(normalizeDateTime$1(dateB)).getTime();
+    
+    if (timeA < timeB) return -1;
+    if (timeA > timeB) return 1;
+    return 0;
+}
+
+var DateUtils$1 = {
+    formatAge: formatAge$1,
+    isValidDateString: isValidDateString$1,
+    compareDates: compareDates$1,
+    normalizeDateTime: normalizeDateTime$1,
+    getTimeDifference: getTimeDifference$1,
+    formatTimeDifference: formatTimeDifference$1
+};
+
+/**
+ * Component: CLI Contract Utilities
+ * Block-UUID: a57b72a0-0d95-44a2-8f3f-ab6ee84b3197
+ * Parent-UUID: 9050e244-793a-4dc6-8571-b96f38927f69
+ * Version: 1.1.0
+ * Description: Utilities for parsing GitSense Chat CLI contract messages and determining save modes for code blocks.
+ * Language: JavaScript
+ * Created-at: 2026-02-27T02:26:15.078Z
+ * Authors: GLM-4.7 (v1.0.0), GLM-4.7 (v1.1.0)
+ */
+
+const CodeBlockUtils$7 = CodeBlockUtils$8;
+
+/**
+ * Parses a contract message object to extract the contract data.
+ * Handles cases where data might be in 'content' (as JSON string) or 'metadata'.
+ * 
+ * @param {Object} message - The chat message object.
+ * @returns {Object|null} The parsed contract data object or null if invalid.
+ */
+function parseContractMessage(message) {
+    if (!message) {
+        return null;
+    }
+
+    // We expect the message type to be 'gsc-cli-contract'
+    if (message.type !== 'gsc-cli-contract') {
+        return null;
+    }
+
+    const content = message.message || '';
+    const lines = content.split('\n');
+    
+    const contractData = {};
+    let inTable = false;
+    let foundHeader = false;
+
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i].trim();
+
+        // Check for the CLI Contract header
+        if (line.startsWith('### CLI Contract')) {
+            foundHeader = true;
+            continue;
+        }
+
+        // If we haven't found the header yet, keep looking
+        if (!foundHeader) {
+            continue;
+        }
+
+        // Check for table separator (e.g., | :--- | :--- |)
+        if (line.includes('---')) {
+            inTable = true;
+            continue;
+        }
+
+        // Parse table rows
+        if (inTable && line.startsWith('|')) {
+            // Remove leading/trailing pipes and split by pipe
+            const parts = line.substring(1, line.length - 1).split('|').map(p => p.trim());
+            
+            if (parts.length >= 2) {
+                const key = parts[0].replace(/\*\*/g, '').toLowerCase(); // Remove bold markdown and normalize
+                const value = parts[1];
+
+                if (key === 'uuid') contractData.uuid = value;
+                else if (key === 'expires at') contractData.expiresAt = value;
+                else if (key === 'status') contractData.status = value;
+                else if (key === 'description') contractData.description = value;
+            }
+        }
+    }
+
+    return contractData;
+}
+
+/**
+ * Checks if a message is a contract message.
+ * 
+ * @param {Object} message - The chat message object.
+ * @returns {boolean} True if the message is a contract message.
+ */
+function isContractMessage(message) {
+    return message && message.type === 'gsc-cli-contract';
+}
+
+/**
+ * Determines if a contract is currently active based on its expiration time.
+ * 
+ * @param {Object} contractData - The contract data object (must contain expiresAt).
+ * @returns {boolean} True if the contract is active, false otherwise.
+ */
+function isContractActive(contractData) {
+    if (!contractData || !contractData.expiresAt) {
+        return false;
+    }
+
+    const now = Date.now();
+    const expiresAt = new Date(contractData.expiresAt).getTime();
+
+    return now < expiresAt;
+}
+
+/**
+ * Determines the save mode (update vs new-file) based on the code content.
+ * Parses the code block header to check for a Parent-UUID.
+ * 
+ * @param {string} rawCodeContent - The full content of the code block (including header).
+ * @returns {Object} An object { mode: 'update'|'new-file', metadata: Object }.
+ */
+function determineSaveMode(rawCodeContent) {
+    const { blocks } = CodeBlockUtils$7.processCodeBlocks(rawCodeContent, { silent: true });
+    
+    if (!blocks || blocks.length === 0) {
+        return { mode: 'unknown', metadata: null };
+    }
+
+    const block = blocks[0];
+    const header = block.header || {};
+    const parentUUID = header['Parent-UUID'];
+
+    let mode = 'new-file';
+
+    // If Parent-UUID exists and is not N/A, it's an update
+    if (parentUUID && parentUUID !== 'N/A') {
+        mode = 'update';
+    }
+
+    return {
+        mode,
+        metadata: {
+            blockUUID: header['Block-UUID'],
+            parentUUID: parentUUID,
+            language: block.language
+        }
+    };
+}
+
+/**
+ * Extracts key metadata from a code block content.
+ * 
+ * @param {string} rawCodeContent - The full content of the code block.
+ * @returns {Object|null} Metadata object or null if parsing fails.
+ */
+function extractCodeMetadata(rawCodeContent) {
+    const result = determineSaveMode(rawCodeContent);
+    return result.metadata;
+}
+
+/**
+ * Formats the remaining time until expiration.
+ * 
+ * @param {string|Date} expiresAt - The expiration timestamp.
+ * @returns {string} Formatted string (e.g., "45m", "2h", "1d").
+ */
+function formatTimeRemaining(expiresAt) {
+    const now = Date.now();
+    const expiry = new Date(expiresAt).getTime();
+    const diffMs = expiry - now;
+
+    if (diffMs <= 0) return 'Expired';
+
+    const diffMins = Math.floor(diffMs / 60000);
+    
+    if (diffMins < 60) return `${diffMins}m`;
+    
+    const diffHours = Math.floor(diffMins / 60);
+    if (diffHours < 24) return `${diffHours}h`;
+    
+    const diffDays = Math.floor(diffHours / 24);
+    return `${diffDays}d`;
+}
+
+var CLIContractUtils$1 = {
+    parseContractMessage,
+    isContractMessage,
+    isContractActive,
+    determineSaveMode,
+    extractCodeMetadata,
+    formatTimeRemaining
+};
+
 /*
  * Component: ContextUtils
  * Block-UUID: 534c348d-a11f-4de6-ad15-f33068d51fb8
@@ -11072,7 +11368,7 @@ var CodeBlockUtils$7 = {
  * 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), Qwen 3 Coder 480B - Cerebras (v1.4.0)
  */
 
-const CodeBlockUtils$6 = CodeBlockUtils$7;
+const CodeBlockUtils$6 = CodeBlockUtils$8;
 const MessageUtils$2 = MessageUtils$3;
 
 /**
@@ -11532,7 +11828,7 @@ var constants = {
  * Authors: Gemini 2.5 Flash (v1.0.0)
  */
 
-const CodeBlockUtils$5 = CodeBlockUtils$7;
+const CodeBlockUtils$5 = CodeBlockUtils$8;
 const GSToolBlockUtils$1 = GSToolBlockUtils$3;
 const JsonUtils$1 = JsonUtils$2;
 const { ANALYZE_HEADER_PREFIX } = constants;
@@ -11842,7 +12138,7 @@ const fs$7 = require$$0.promises;
 const path$5 = require$$1;
 const { getAnalyzerInstructionsContent: getAnalyzerInstructionsContent$2 } = instructionLoader;
 const { preprocessJsonForValidation: preprocessJsonForValidation$4 } = jsonParser;
-const CodeBlockUtils$4 = CodeBlockUtils$7;
+const CodeBlockUtils$4 = CodeBlockUtils$8;
 
 /**
  * Reads and parses the config.json file in a directory.
@@ -12149,7 +12445,7 @@ var saver = {
 
 const fs$5 = require$$0.promises;
 const path$3 = require$$1;
-const CodeBlockUtils$3 = CodeBlockUtils$7;
+const CodeBlockUtils$3 = CodeBlockUtils$8;
 const { preprocessJsonForValidation: preprocessJsonForValidation$3 } = jsonParser;
 
 /**
@@ -12627,7 +12923,7 @@ var defaultPromptLoader = {
 
 const fs$2 = require$$0.promises;
 const path = require$$1;
-const CodeBlockUtils$2 = CodeBlockUtils$7;
+const CodeBlockUtils$2 = CodeBlockUtils$8;
 const { preprocessJsonForValidation: preprocessJsonForValidation$2 } = jsonParser;
 const { isValidDirName: isValidDirName$1 } = discovery;
 const { readConfig } = discovery;
@@ -12813,7 +13109,7 @@ var updater = {
  */
 
 require$$0.promises;
-const CodeBlockUtils$1 = CodeBlockUtils$7;
+const CodeBlockUtils$1 = CodeBlockUtils$8;
 const { preprocessJsonForValidation: preprocessJsonForValidation$1 } = jsonParser;
 const { isValidDirName } = discovery;
 const { saveConfiguration: saveConfiguration$1 } = saver;
@@ -13020,119 +13316,6 @@ var LLMUtils$1 = {
     estimateTokens: estimateTokens$1,
 };
 
-/**
- * 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$1(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$1(dateString) {
-    const now = new Date();
-    const date = new Date(normalizeDateTime$1(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$1(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$1(dateString) {
-    if (!dateString) {
-        return 'N/A';
-    }
-
-    try {
-        const diff = getTimeDifference$1(dateString);
-        return formatTimeDifference$1(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$1(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$1(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$1(dateA, dateB) {
-    if (!isValidDateString$1(dateA) || !isValidDateString$1(dateB)) {
-        throw new Error(`Invalid date string format. A: ${dateA} B: ${dateB})`);
-    }
-
-    const timeA = new Date(normalizeDateTime$1(dateA)).getTime();
-    const timeB = new Date(normalizeDateTime$1(dateB)).getTime();
-    
-    if (timeA < timeB) return -1;
-    if (timeA > timeB) return 1;
-    return 0;
-}
-
-var DateUtils$1 = {
-    formatAge: formatAge$1,
-    isValidDateString: isValidDateString$1,
-    compareDates: compareDates$1,
-    normalizeDateTime: normalizeDateTime$1,
-    getTimeDifference: getTimeDifference$1,
-    formatTimeDifference: formatTimeDifference$1
-};
-
 /**
  * Component: Formatter Utilities
  * Block-UUID: 8512c809-87b0-4f90-af9d-b3dca204c4de
@@ -13343,6 +13526,9 @@ const h$1 = {
     createArticle: (params) => {
         return createElement("article", params);
     },
+    createBlockquote: (params) => {
+        return createElement("blockquote", params);
+    },
     createBr: () => {
         return createElement("br");
     },
@@ -26375,15 +26561,16 @@ var CompactChatUtils$1 = {
  * Component: GitSenseChatUtils
  * Block-UUID: c1b6c4d3-7959-4eb6-8022-6cd7aa59240d
  * Parent-UUID: 1793b3a8-4881-4306-bfdf-673eef503679
- * Version: 2.7.0
- * 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, EnvUtils, ObjectUtils, MetaRawResultUtils, and CompactChatUtils.
+ * Version: 2.8.0
+ * 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, EnvUtils, ObjectUtils, MetaRawResultUtils, CompactChatUtils, and CLIContractUtils.
  * Language: JavaScript
  * Created-at: 2025-10-17T17:13:04.663Z
- * 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), Qwen 3 Coder 480B - Cerebras (v2.2.0), Qwen 3 Coder 480B - Cerebras (v2.2.1), Claude Haiku 4.5 (v2.3.0), Qwen 3 Coder 480B - Cerebras (v2.4.0), Qwen 3 Coder 480B - Cerebras (v2.5.0), GLM-4.6 (v2.6.0), GLM-4.6 (v2.7.0)
+ * 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), Qwen 3 Coder 480B - Cerebras (v2.2.0), Qwen 3 Coder 480B - Cerebras (v2.2.1), Claude Haiku 4.5 (v2.3.0), Qwen 3 Coder 480B - Cerebras (v2.4.0), Qwen 3 Coder 480B - Cerebras (v2.5.0), GLM-4.6 (v2.6.0), GLM-4.6 (v2.7.0), GLM-4.7 (v2.8.0)
  */
 
 const ChatUtils = ChatUtils$2;
-const CodeBlockUtils = CodeBlockUtils$7;
+const CLIContractUtils = CLIContractUtils$1;
+const CodeBlockUtils = CodeBlockUtils$8;
 const ContextUtils = ContextUtils$2;
 const MessageUtils = MessageUtils$3;
 const AnalysisBlockUtils = AnalysisBlockUtils$3;
@@ -26799,6 +26986,7 @@ var GitSenseChatUtils_1 = {
     GSToolBlockUtils,
     JsonUtils,
     ConfigUtils,
+    CLIContractUtils,
     DateUtils,
     LanguageNameUtils,
     FormatterUtils,
@@ -26949,6 +27137,14 @@ var GitSenseChatUtils_1 = {
     parseTableRow,
     parseSize,
     parseTokens,
+
+    // Contract Utilities (from CLIContractUtils)
+    parseContractMessage: CLIContractUtils.parseContractMessage,
+    isContractMessage: CLIContractUtils.isContractMessage,
+    isContractActive: CLIContractUtils.isContractActive,
+    determineSaveMode: CLIContractUtils.determineSaveMode,
+    extractCodeMetadata: CLIContractUtils.extractCodeMetadata,
+    formatTimeRemaining: CLIContractUtils.formatTimeRemaining,
 };
 
 var GitSenseChatUtils$1 = /*@__PURE__*/getDefaultExportFromCjs(GitSenseChatUtils_1);

package/package.json

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

package/src/CLIContractUtils.js

@@ -0,0 +1,184 @@
+/**
+ * Component: CLI Contract Utilities
+ * Block-UUID: a57b72a0-0d95-44a2-8f3f-ab6ee84b3197
+ * Parent-UUID: 9050e244-793a-4dc6-8571-b96f38927f69
+ * Version: 1.1.0
+ * Description: Utilities for parsing GitSense Chat CLI contract messages and determining save modes for code blocks.
+ * Language: JavaScript
+ * Created-at: 2026-02-27T02:26:15.078Z
+ * Authors: GLM-4.7 (v1.0.0), GLM-4.7 (v1.1.0)
+ */
+
+
+const CodeBlockUtils = require('./CodeBlockUtils');
+const DateUtils = require('./DateUtils');
+
+/**
+ * Parses a contract message object to extract the contract data.
+ * Handles cases where data might be in 'content' (as JSON string) or 'metadata'.
+ * 
+ * @param {Object} message - The chat message object.
+ * @returns {Object|null} The parsed contract data object or null if invalid.
+ */
+function parseContractMessage(message) {
+    if (!message) {
+        return null;
+    }
+
+    // We expect the message type to be 'gsc-cli-contract'
+    if (message.type !== 'gsc-cli-contract') {
+        return null;
+    }
+
+    const content = message.message || '';
+    const lines = content.split('\n');
+    
+    const contractData = {};
+    let inTable = false;
+    let foundHeader = false;
+
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i].trim();
+
+        // Check for the CLI Contract header
+        if (line.startsWith('### CLI Contract')) {
+            foundHeader = true;
+            continue;
+        }
+
+        // If we haven't found the header yet, keep looking
+        if (!foundHeader) {
+            continue;
+        }
+
+        // Check for table separator (e.g., | :--- | :--- |)
+        if (line.includes('---')) {
+            inTable = true;
+            continue;
+        }
+
+        // Parse table rows
+        if (inTable && line.startsWith('|')) {
+            // Remove leading/trailing pipes and split by pipe
+            const parts = line.substring(1, line.length - 1).split('|').map(p => p.trim());
+            
+            if (parts.length >= 2) {
+                const key = parts[0].replace(/\*\*/g, '').toLowerCase(); // Remove bold markdown and normalize
+                const value = parts[1];
+
+                if (key === 'uuid') contractData.uuid = value;
+                else if (key === 'expires at') contractData.expiresAt = value;
+                else if (key === 'status') contractData.status = value;
+                else if (key === 'description') contractData.description = value;
+            }
+        }
+    }
+
+    return contractData;
+}
+
+/**
+ * Checks if a message is a contract message.
+ * 
+ * @param {Object} message - The chat message object.
+ * @returns {boolean} True if the message is a contract message.
+ */
+function isContractMessage(message) {
+    return message && message.type === 'gsc-cli-contract';
+}
+
+/**
+ * Determines if a contract is currently active based on its expiration time.
+ * 
+ * @param {Object} contractData - The contract data object (must contain expiresAt).
+ * @returns {boolean} True if the contract is active, false otherwise.
+ */
+function isContractActive(contractData) {
+    if (!contractData || !contractData.expiresAt) {
+        return false;
+    }
+
+    const now = Date.now();
+    const expiresAt = new Date(contractData.expiresAt).getTime();
+
+    return now < expiresAt;
+}
+
+/**
+ * Determines the save mode (update vs new-file) based on the code content.
+ * Parses the code block header to check for a Parent-UUID.
+ * 
+ * @param {string} rawCodeContent - The full content of the code block (including header).
+ * @returns {Object} An object { mode: 'update'|'new-file', metadata: Object }.
+ */
+function determineSaveMode(rawCodeContent) {
+    const { blocks } = CodeBlockUtils.processCodeBlocks(rawCodeContent, { silent: true });
+    
+    if (!blocks || blocks.length === 0) {
+        return { mode: 'unknown', metadata: null };
+    }
+
+    const block = blocks[0];
+    const header = block.header || {};
+    const parentUUID = header['Parent-UUID'];
+
+    let mode = 'new-file';
+
+    // If Parent-UUID exists and is not N/A, it's an update
+    if (parentUUID && parentUUID !== 'N/A') {
+        mode = 'update';
+    }
+
+    return {
+        mode,
+        metadata: {
+            blockUUID: header['Block-UUID'],
+            parentUUID: parentUUID,
+            language: block.language
+        }
+    };
+}
+
+/**
+ * Extracts key metadata from a code block content.
+ * 
+ * @param {string} rawCodeContent - The full content of the code block.
+ * @returns {Object|null} Metadata object or null if parsing fails.
+ */
+function extractCodeMetadata(rawCodeContent) {
+    const result = determineSaveMode(rawCodeContent);
+    return result.metadata;
+}
+
+/**
+ * Formats the remaining time until expiration.
+ * 
+ * @param {string|Date} expiresAt - The expiration timestamp.
+ * @returns {string} Formatted string (e.g., "45m", "2h", "1d").
+ */
+function formatTimeRemaining(expiresAt) {
+    const now = Date.now();
+    const expiry = new Date(expiresAt).getTime();
+    const diffMs = expiry - now;
+
+    if (diffMs <= 0) return 'Expired';
+
+    const diffMins = Math.floor(diffMs / 60000);
+    
+    if (diffMins < 60) return `${diffMins}m`;
+    
+    const diffHours = Math.floor(diffMins / 60);
+    if (diffHours < 24) return `${diffHours}h`;
+    
+    const diffDays = Math.floor(diffHours / 24);
+    return `${diffDays}d`;
+}
+
+module.exports = {
+    parseContractMessage,
+    isContractMessage,
+    isContractActive,
+    determineSaveMode,
+    extractCodeMetadata,
+    formatTimeRemaining
+};

package/src/CodeBlockUtils/blockProcessor.js

@@ -502,7 +502,7 @@ function fixTextCodeBlocks(text) {
                     const [fieldPart, valuePart] = line.split(':').map(p => p.trim());
 
                     // Skip if N/A or contains unexpected characters
-                    if (valuePart === 'N/A' || valuePart.match(/\(/)) {
+                    if (valuePart === 'N/A' || !valuePart.match(/\w-/)) {
                         return line;
                     }
                     // Validate UUID

package/src/DomUtils.js

@@ -154,6 +154,9 @@ const h = {
     createArticle: (params) => {
         return createElement("article", params);
     },
+    createBlockquote: (params) => {
+        return createElement("blockquote", params);
+    },
     createBr: () => {
         return createElement("br");
     },

package/src/GitSenseChatUtils.js

@@ -2,15 +2,16 @@
  * Component: GitSenseChatUtils
  * Block-UUID: c1b6c4d3-7959-4eb6-8022-6cd7aa59240d
  * Parent-UUID: 1793b3a8-4881-4306-bfdf-673eef503679
- * Version: 2.7.0
- * 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, EnvUtils, ObjectUtils, MetaRawResultUtils, and CompactChatUtils.
+ * Version: 2.8.0
+ * 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, EnvUtils, ObjectUtils, MetaRawResultUtils, CompactChatUtils, and CLIContractUtils.
  * Language: JavaScript
  * Created-at: 2025-10-17T17:13:04.663Z
- * 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), Qwen 3 Coder 480B - Cerebras (v2.2.0), Qwen 3 Coder 480B - Cerebras (v2.2.1), Claude Haiku 4.5 (v2.3.0), Qwen 3 Coder 480B - Cerebras (v2.4.0), Qwen 3 Coder 480B - Cerebras (v2.5.0), GLM-4.6 (v2.6.0), GLM-4.6 (v2.7.0)
+ * 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), Qwen 3 Coder 480B - Cerebras (v2.2.0), Qwen 3 Coder 480B - Cerebras (v2.2.1), Claude Haiku 4.5 (v2.3.0), Qwen 3 Coder 480B - Cerebras (v2.4.0), Qwen 3 Coder 480B - Cerebras (v2.5.0), GLM-4.6 (v2.6.0), GLM-4.6 (v2.7.0), GLM-4.7 (v2.8.0)
  */
 
 
 const ChatUtils = require('./ChatUtils');
+const CLIContractUtils = require('./CLIContractUtils');
 const CodeBlockUtils = require('./CodeBlockUtils');
 const ContextUtils = require('./ContextUtils');
 const MessageUtils = require('./MessageUtils');
@@ -427,6 +428,7 @@ module.exports = {
     GSToolBlockUtils,
     JsonUtils,
     ConfigUtils,
+    CLIContractUtils,
     DateUtils,
     LanguageNameUtils,
     FormatterUtils,
@@ -577,4 +579,12 @@ module.exports = {
     parseTableRow,
     parseSize,
     parseTokens,
+
+    // Contract Utilities (from CLIContractUtils)
+    parseContractMessage: CLIContractUtils.parseContractMessage,
+    isContractMessage: CLIContractUtils.isContractMessage,
+    isContractActive: CLIContractUtils.isContractActive,
+    determineSaveMode: CLIContractUtils.determineSaveMode,
+    extractCodeMetadata: CLIContractUtils.extractCodeMetadata,
+    formatTimeRemaining: CLIContractUtils.formatTimeRemaining,
 };