@gitsense/gsc-utils 0.2.34 → 0.2.36

package/src/AnalyzerUtils/schemaLoader.js

@@ -1,12 +1,12 @@
 /**
  * Component: AnalyzerUtils Schema Loader
- * Block-UUID: bf25c501-f9e1-4e5b-ad22-9ed24ba50787
- * Parent-UUID: 66208fdc-2c80-4264-8500-06d5f4db103a
- * Version: 1.4.1
+ * Block-UUID: 20ac37ba-6ff7-462e-9e08-3204df118b03
+ * Parent-UUID: bf25c501-f9e1-4e5b-ad22-9ed24ba50787
+ * Version: 1.5.0
  * Description: Provides utility functions for retrieving and deducing JSON schemas for analyzers.
  * Language: JavaScript
- * Created-at: 2025-11-23T05:40:43.016Z
- * Authors: Gemini 2.5 Flash (v1.0.0), Gemini 2.5 Pro (v1.1.0), Claude Haiku 4.5 (v1.2.0), Claude Haiku 4.5 (v1.3.0), Qwen 3 Coder 480B - Cerebras (v1.4.0), GLM-4.6 (v1.4.1)
+ * Created-at: 2026-02-15T06:21:20.089Z
+ * Authors: Gemini 2.5 Flash (v1.0.0), Gemini 2.5 Pro (v1.1.0), Claude Haiku 4.5 (v1.2.0), Claude Haiku 4.5 (v1.3.0), Qwen 3 Coder 480B - Cerebras (v1.4.0), GLM-4.6 (v1.4.1), GLM-4.7 (v1.5.0)
  */
 
 
@@ -27,35 +27,39 @@ const { preprocessJsonForValidation } = require('./jsonParser');
 function parseMetadataDefinitions(markdownContent) {
     const definitions = new Map();
     
-    // Match the "### Custom Metadata Definitions" section until the next code block or section
-    const sectionRegex = /### Custom Metadata Definitions\s*([\s\S]*?)(?=```|\n##|\n---)/;
-    const match = markdownContent.match(sectionRegex);
+    // Match both "### Fixed Metadata Definitions" and "### Custom Metadata Definitions" sections
+    const sectionHeaders = ['### Fixed Metadata Definitions', '### Custom Metadata Definitions'];
+    
+    for (const sectionHeader of sectionHeaders) {
+        const sectionRegex = new RegExp(`${sectionHeader}\\s*([\\s\\S]*?)(?=\`\`\\|\\n##|\\n---)`);
+        const match = markdownContent.match(sectionRegex);
 
-    if (!match || !match[1]) {
-        return definitions;
-    }
+        if (!match || !match[1]) {
+            continue;
+        }
 
-    const definitionBlock = match[1];
-    
-    // Regex to match both formats:
-    // Format 1: * `fieldName` (type): description
-    // Format 2: * fieldName (type): description
-    // Capture groups:
-    //   Group 1: backtick-wrapped field name (if present)
-    //   Group 2: non-backtick field name (if present)
-    //   Group 3: field type
-    //   Group 4: description
-    const lineRegex = /^\s*\*\s+(?:`([^`]+)`|([a-zA-Z0-9_-]+))\s+\(([^)]+)\):\s*(.+)/gm;
-
-    let lineMatch;
-    while ((lineMatch = lineRegex.exec(definitionBlock)) !== null) {
-        // Extract field name from either group 1 (backtick-wrapped) or group 2 (plain)
-        const fieldName = (lineMatch[1] || lineMatch[2]).trim();
-        const fieldType = lineMatch[3].trim();
-        const description = lineMatch[4].trim();
-
-        if (fieldName && fieldType && description) {
-            definitions.set(fieldName, { type: fieldType, description });
+        const definitionBlock = match[1];
+        
+        // Regex to match both formats:
+        // Format 1: * `fieldName` (type): description
+        // Format 2: * fieldName (type): description
+        // Capture groups:
+        //   Group 1: backtick-wrapped field name (if present)
+        //   Group 2: non-backtick field name (if present)
+        //   Group 3: field type
+        //   Group 4: description
+        const lineRegex = /^\s*\*\s+(?:`([^`]+)`|([a-zA-Z0-9_-]+))\s+\(([^)]+)\):\s*(.+)/gm;
+
+        let lineMatch;
+        while ((lineMatch = lineRegex.exec(definitionBlock)) !== null) {
+            // Extract field name from either group 1 (backtick-wrapped) or group 2 (plain)
+            const fieldName = (lineMatch[1] || lineMatch[2]).trim();
+            const fieldType = lineMatch[3].trim();
+            const description = lineMatch[4].trim();
+
+            if (fieldName && fieldType && description) {
+                definitions.set(fieldName, { type: fieldType, description });
+            }
         }
     }
 

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,
 };