@gitsense/gsc-utils 0.2.30 → 0.2.31

package/dist/gsc-utils.cjs.js

@@ -1125,7 +1125,7 @@ var headerUtils = {
  * @param {string} text - The input text
  * @returns {Object} Object containing arrays of opening and closing fence positions: { openingPositions: Array, closingPositions: Array }
  */
-function findAllCodeFences$4(text) {
+function findAllCodeFences$5(text) {
     const openingPositions = [];
     const closingPositions = [];
 
@@ -1359,7 +1359,7 @@ function findCodeBlockByUUID$2(messageText, blockUUID) {
 }
 
 var blockExtractor = {
-    findAllCodeFences: findAllCodeFences$4,
+    findAllCodeFences: findAllCodeFences$5,
     matchFencesAndExtractBlocks: matchFencesAndExtractBlocks$4,
     extractCodeBlocksWithUUIDs: extractCodeBlocksWithUUIDs$1,
     findCodeBlockByUUID: findCodeBlockByUUID$2
@@ -1542,13 +1542,13 @@ var versionUtils = {
 
 /**
  * Component: PatchUtils Constants
- * Block-UUID: c6747054-2c8b-461f-910d-0fd725d9a350
- * Parent-UUID: 32adc00e-7509-4219-8e40-6c1319371db9
- * Version: 2.1.0
- * Description: Contains shared constants and regular expressions used by the enhanced patch utilities.
+ * Block-UUID: 83ba7eaa-36b3-41f3-bd07-130c0266301e
+ * Parent-UUID: c6747054-2c8b-461f-910d-0fd725d9a350
+ * Version: 2.2.0
+ * Description: Contains shared constants and regular expressions used by the enhanced patch utilities. Updated required metadata fields to include Component, Language, and Created-at.
  * Language: JavaScript
  * Created-at: 2025-05-14T16:55:00.000Z
- * Authors: Gemini 2.5 Flash Thinking (v1.0.0), Claude 3.7 Sonnet (v2.0.0), Qwen 3 Coder 480B - Cerebras (v2.1.0)
+ * Authors: Gemini 2.5 Flash Thinking (v1.0.0), Claude 3.7 Sonnet (v2.0.0), Qwen 3 Coder 480B - Cerebras (v2.1.0), GLM-4.7 (v2.2.0)
  */
 
 // Traditional patch markers
@@ -1578,13 +1578,13 @@ var constants$2 = {
 
 /**
  * Component: PatchUtils Parser
- * Block-UUID: ce634df9-ff99-482a-a261-56ab34a2546e
- * Parent-UUID: fcc85ec1-0146-40bf-a937-6f7928258cbf
- * Version: 1.2.0
- * Description: Handles parsing, validation, extraction, and detection of traditional unified diff patches and abbreviated patches. Extracts metadata and raw diff content.
+* Block-UUID: 334a0473-da2d-4859-b8a5-f867e3d88a28
+ * Parent-UUID: ce634df9-ff99-482a-a261-56ab34a2546e
+ * Version: 1.3.0
+ * Description: Handles parsing, validation, extraction, and detection of traditional unified diff patches and abbreviated patches. Extracts metadata and raw diff content. Updated validation to require Component and Language.
  * Language: JavaScript
  * Created-at: 2025-04-18T02:59:04.322Z
- * Authors: Gemini 2.5 Pro (v1.0.0), Gemini 2.5 Pro (v1.1.0), Qwen 3 Coder 480B - Cerebras (v1.2.0)
+ * Authors: Gemini 2.5 Pro (v1.0.0), Gemini 2.5 Pro (v1.1.0), Qwen 3 Coder 480B - Cerebras (v1.2.0), GLM-4.7 (v1.3.0)
  */
 
 const { isValidVersion } = versionUtils; // Assuming SharedUtils is one level up
@@ -1689,13 +1689,17 @@ function extractPatchMetadata$1(patchText) {
  */
 function validatePatchMetadata$1(metadata) {
     const errors = [];
+    // Updated to include Component and Language
     const requiredFields = [
+        'Component',
         'Source-Block-UUID',
         'Target-Block-UUID',
         'Source-Version',
         'Target-Version',
         'Description',
-        'Authors'
+        'Language',
+        'Authors',
+        'Created-at'
     ];
 
     for (const field of requiredFields) {
@@ -6677,13 +6681,13 @@ function escapeHTML(s) {
 
 /**
  * Component: PatchUtils Processor
- * Block-UUID: 96ec8bca-9fc3-441b-b81f-6fefc840c626
- * Parent-UUID: 9e5b8ae2-e978-4a20-b1dd-c044d9a5277f
- * Version: 1.3.0
- * Description: Handles applying, creating, and converting patches. Applies traditional unified diffs, cleaning line number prefixes from diff content before using jsdiff.
+ * Block-UUID: 58698895-c540-4be0-94b0-53dfcd0e1235
+ * Parent-UUID: 96ec8bca-9fc3-441b-b81f-6fefc840c626
+ * Version: 1.4.0
+ * Description: Handles applying, creating, and converting patches. Applies traditional unified diffs, cleaning line number prefixes from diff content before using jsdiff. Updated patch metadata formatting to include Component, Language, and Created-at.
  * Language: JavaScript
  * Created-at: 2025-07-20T17:24:16.836Z
- * Authors: Gemini 2.5 Pro (v1.0.0), Gemini 2.5 Pro (v1.1.0), Claude 3.7 Sonnet (v1.2.0), Gemini 2.5 Flash (v1.2.0), Gemini 2.5 Flash Thinking (v1.3.0)
+ * Authors: Gemini 2.5 Pro (v1.0.0), Gemini 2.5 Pro (v1.1.0), Claude 3.7 Sonnet (v1.2.0), Gemini 2.5 Flash (v1.2.0), Gemini 2.5 Flash Thinking (v1.3.0), GLM-4.7 (v1.4.0)
  */
 
 const parser$1 = patchParser;
@@ -6978,9 +6982,9 @@ function createPatchFromCodeBlocks(CodeBlockUtils, sourceCodeBlockText, targetCo
     // 4. Assemble Final Patch
     const formattedMetadata = _formatPatchMetadata(patchMetadata);
     const formatted = `${formattedMetadata}\n\n\n`+
-                      `# --- PATCH START MARKER ---\n`+
-                      `${adjustedDiffPatch}\n`+
-                      `# --- PATCH END MARKER ---`;
+        `# --- PATCH START MARKER ---\n`+
+        `${adjustedDiffPatch}\n`+
+        `# --- PATCH END MARKER ---`;
 
     return {
         formatted,
@@ -6997,12 +7001,18 @@ function createPatchFromCodeBlocks(CodeBlockUtils, sourceCodeBlockText, targetCo
  * @private
  */
 function _formatPatchMetadata(metadata) {
-    // --- Function body from original PatchUtils._formatPatchMetadata ---
-    // --- (Copied Verbatim) ---
     const lines = ['# Patch Metadata'];
+    // Updated order to match system prompt requirements
     const metadataOrder = [
-        'Source-Block-UUID', 'Target-Block-UUID', 'Source-Version', 'Target-Version',
-        'Description', 'Authors'
+        'Component',
+        'Source-Block-UUID',
+        'Target-Block-UUID',
+        'Source-Version',
+        'Target-Version',
+        'Description',
+        'Language',
+        'Created-at',
+        'Authors'
     ];
 
     // Add ordered metadata
@@ -7020,7 +7030,6 @@ function _formatPatchMetadata(metadata) {
     }
 
     return lines.join('\n');
-    // --- End of Function Body ---
 }
 
 var patchProcessor = {
@@ -8097,13 +8106,13 @@ var diagnosticReporter$1 = {
 
 /**
  * Component: PatchUtils Patch Extractor
- * Block-UUID: ad8cda91-244b-4f47-9847-d6c0d93424fc
- * Parent-UUID: N/A
- * Version: 1.0.0
- * Description: Extracts individual hunks from a patch and cleans line numbers from content.
+ * Block-UUID: d937fa30-196e-4221-9508-717f509f43d4
+ * Parent-UUID: ad8cda91-244b-4f47-9847-d6c0d93424fc
+ * Version: 1.1.0
+ * Description: Extracts individual hunks from a patch and cleans line numbers from content. Updated reconstructPatch to format metadata in the specific order required by the system prompt.
  * Language: JavaScript
  * Created-at: 2025-05-14T16:50:00.000Z
- * Authors: Claude 3.7 Sonnet (v1.0.0)
+ * Authors: Claude 3.7 Sonnet (v1.0.0), GLM-4.7 (v1.1.0)
  */
 
 const { removeLineNumbers: removeLineNumbers$4 } = lineNumberFormatter;
@@ -8243,11 +8252,33 @@ function extractAndCleanHunks$1(patchText) {
  * @returns {string} Reconstructed patch
  */
 function reconstructPatch$1(metadata, hunks) {
-    // Format metadata
+    // Format metadata in the specific order required by the system prompt
     let result = '# Patch Metadata\n';
+    
+    const metadataOrder = [
+        'Component',
+        'Source-Block-UUID',
+        'Target-Block-UUID',
+        'Source-Version',
+        'Target-Version',
+        'Description',
+        'Language',
+        'Created-at',
+        'Authors'
+    ];
+
+    // Add ordered metadata
+    metadataOrder.forEach(key => {
+        if (metadata[key]) {
+            result += `# ${key}: ${metadata[key]}\n`;
+        }
+    });
 
+    // Add any other metadata not in the preferred order
     for (const [key, value] of Object.entries(metadata)) {
-        result += `# ${key}: ${value}\n`;
+        if (!metadataOrder.includes(key)) {
+            result += `# ${key}: ${value}\n`;
+        }
     }
 
     // Add patch markers and hunks
@@ -9442,7 +9473,7 @@ var JsonUtils$2 = {
  * Authors: Gemini 2.5 Pro (v1.0.0), Gemini 2.5 Pro (v1.1.0), Gemini 2.5 Pro (v1.2.0), Gemini 2.5 Flash Thinking (v1.3.0), Gemini 2.5 Flash Thinking (v1.4.0), Qwen 3 Coder 480B - Cerebras (v1.5.0)
  */
 
-const { findAllCodeFences: findAllCodeFences$3, matchFencesAndExtractBlocks: matchFencesAndExtractBlocks$3 } = blockExtractor;
+const { findAllCodeFences: findAllCodeFences$4, matchFencesAndExtractBlocks: matchFencesAndExtractBlocks$3 } = blockExtractor;
 const { parseHeader: parseHeader$2 } = headerUtils;
 const { validateUUID: validateUUID$2 } = uuidUtils;
 const AnalysisBlockUtils$2 = AnalysisBlockUtils$3;
@@ -9797,7 +9828,7 @@ function processCodeBlocks$5(text, options = { silent: false, validatePatches: f
     }
 
     // Step 1: Find all fence positions
-    const { openingPositions, closingPositions } = findAllCodeFences$3(text);
+    const { openingPositions, closingPositions } = findAllCodeFences$4(text);
 
     // Step 2: Match fences to get potential block boundaries
     const { completeBlocks, incompleteBlocks, warnings: extractorWarnings } = matchFencesAndExtractBlocks$3(
@@ -10429,6 +10460,146 @@ Plain text block.
 // (Removed the check `if (typeof module !== 'undefined' && module.exports)` as it's standard in Node)
 var markerRemover = { removeCodeBlockMarkers: removeCodeBlockMarkers$2 };
 
+/**
+ * Component: CodeBlockUtils Traceable Code Parser
+ * Block-UUID: 8a4b2c1d-9e6f-4a3b-8c7d-1e2f3a4b5c6d
+ * Parent-UUID: N/A
+ * Version: 1.0.0
+ * Description: Parses the `Traceable Code` metadata lines preceding code blocks to extract pre-generated UUIDs and version flags for backend validation.
+ * Language: JavaScript
+ * Created-at: 2026-01-26T17:50:00.000Z
+ * Authors: GLM-4.7 (v1.0.0)
+ */
+
+const { findAllCodeFences: findAllCodeFences$3 } = blockExtractor;
+
+/**
+ * Parses `Traceable Code` metadata lines for all code blocks found in a message.
+ * It scans the text for code blocks and looks for the specific traceable header
+ * immediately preceding each block.
+ *
+ * @param {string} messageText - The full message text containing code blocks.
+ * @param {Object} [options] - Optional configuration.
+ * @param {boolean} [options.silent=true] - If false, logs warnings to console.
+ * @returns {TraceableCodeParseResult[]} An array of results, where each index
+ *                                         corresponds to a code block found in the message.
+ */
+function parseTraceableCodeHeaders$2(messageText, options = { silent: true }) {
+    if (typeof messageText !== 'string') {
+        if (!options.silent) {
+            console.warn('parseTraceableCodeHeaders: messageText must be a string.');
+        }
+        return [];
+    }
+
+    // Step 1: Find all code fence positions
+    const { openingPositions } = findAllCodeFences$3(messageText);
+    const results = [];
+
+    // Step 2: Iterate through each code block to find its preceding traceable line
+    openingPositions.forEach((fence, index) => {
+        const textBeforeFence = messageText.substring(0, fence.position);
+        const lines = textBeforeFence.split('\n');
+
+        let foundLine = null;
+        let searchLimit = 10; // Look back up to 10 lines to find the header
+        
+        // Iterate backwards from the fence
+        for (let i = lines.length - 1; i >= 0 && searchLimit > 0; i--) {
+            const line = lines[i].trim();
+
+            // Skip file path lines (e.g., `path/to/file.js`)
+            if (line.startsWith('`') && line.endsWith('`')) {
+                continue;
+            }
+            
+            // Skip empty lines
+            if (line === '') {
+                continue;
+            }
+
+            // Check for the traceable code marker
+            if (line.includes('**Traceable Code:**')) {
+                foundLine = line;
+                break;
+            }
+        }
+
+        if (foundLine) {
+            const parsedData = parseTraceableLine(foundLine);
+            results.push({
+                blockIndex: index,
+                found: true,
+                rawLine: foundLine,
+                data: parsedData.data,
+                errors: parsedData.errors
+            });
+        } else {
+            results.push({
+                blockIndex: index,
+                found: false,
+                rawLine: null,
+                data: null,
+                errors: []
+            });
+        }
+    });
+
+    return results;
+}
+
+/**
+ * Internal helper to parse a single traceable code line.
+ * @param {string} line - The raw line containing the traceable code metadata.
+ * @returns {Object} { data: Object, errors: Array }
+ */
+function parseTraceableLine(line) {
+    // Helper to extract value for a specific key
+    // Handles keys like **Key:** value, ignoring HTML entities like  
+    const extract = (key) => {
+        // Regex matches **Key:** followed by any characters until the next ** or end of line
+        // We strip HTML entities and extra whitespace from the result
+        const regex = new RegExp(`\\*\\*${key}:\\*\\*\\s*([^*]+)`, 'i');
+        const match = line.match(regex);
+        if (match) {
+            return match[1].trim().replace(/ /g, '').trim();
+        }
+        return null;
+    };
+
+    const isTraceableStr = extract('Traceable Code');
+    const isNewVersionStr = extract('New Version');
+    const currentParentUUID = extract('Current Parent-UUID');
+    const newParentUUID = extract('New Parent-UUID');
+    const newBlockUUID = extract('New Block-UUID');
+
+    const errors = [];
+    
+    // Basic validation of extracted values
+    if (!isTraceableStr || !['Yes', 'No'].includes(isTraceableStr)) {
+        errors.push({ type: 'invalid_value', message: 'Invalid or missing Traceable Code value (expected Yes/No).' });
+    }
+    
+    if (!isNewVersionStr || !['Yes', 'No', 'N/A'].includes(isNewVersionStr)) {
+        errors.push({ type: 'invalid_value', message: 'Invalid or missing New Version value (expected Yes/No/N/A).' });
+    }
+
+    return {
+        data: {
+            isTraceable: isTraceableStr === 'Yes',
+            isNewVersion: isNewVersionStr === 'Yes',
+            currentParentUUID: currentParentUUID,
+            newParentUUID: newParentUUID,
+            newBlockUUID: newBlockUUID
+        },
+        errors: errors
+    };
+}
+
+var traceableCodeParser = {
+    parseTraceableCodeHeaders: parseTraceableCodeHeaders$2
+};
+
 /**
  * Component: CodeBlockUtils Update Code Block
  * Block-UUID: 6a7b8c9d-0e1f-42a3-b4c5-d6e7f8a9b0c1
@@ -10801,13 +10972,13 @@ var lineageTracer = {
 
 /**
  * Component: CodeBlockUtils Index
- * Block-UUID: 98684aa5-d597-41b6-a7fd-cc16482aafdc
- * Parent-UUID: 7e9d3f8a-1b2c-4d5e-8f9a-0123456789ab
- * Version: 1.5.0
+ * Block-UUID: bf718ee3-fdb2-4fd1-85b8-418b24291179
+ * Parent-UUID: 98684aa5-d597-41b6-a7fd-cc16482aafdc
+ * Version: 1.6.0
  * Description: Aggregates and exports all utilities related to code block processing from the CodeBlockUtils module. Serves as the main entry point for this module.
  * Language: JavaScript
- * Created-at: 2025-04-15T16:02:20.217Z
- * Authors: Gemini 2.5 Pro (v1.0.0), Gemini 2.5 Pro (v1.1.0), Claude 3.7 Sonnet (v1.2.0), Gemini 2.5 Pro (v1.3.0), Gemini 2.5 Flash Thinking (v1.4.0), Qwen 3 Coder 480B - Cerebras (v1.5.0)
+ * Created-at: 2026-01-26T17:51:57.427Z
+ * Authors: Gemini 2.5 Pro (v1.0.0), Gemini 2.5 Pro (v1.1.0), Claude 3.7 Sonnet (v1.2.0), Gemini 2.5 Pro (v1.3.0), Gemini 2.5 Flash Thinking (v1.4.0), Qwen 3 Coder 480B - Cerebras (v1.5.0), GLM-4.7 (v1.6.0)
  */
 
 // Import from individual utility files
@@ -10821,6 +10992,7 @@ const { detectCodeBlockRelationships: detectCodeBlockRelationships$1, detectInco
 const { extractContinuationInfo: extractContinuationInfo$1, generateContinuationPrompt: generateContinuationPrompt$1 } = continuationUtils;
 const { parseCodeBlocks: parseCommentDelimitedBlocks$1 } = headerParser;
 const { removeCodeBlockMarkers: removeCodeBlockMarkers$1 } = markerRemover;
+const { parseTraceableCodeHeaders: parseTraceableCodeHeaders$1 } = traceableCodeParser;
 const { updateCodeBlockByIndex: updateCodeBlockByIndex$1, updateCodeBlockByUUID, updateCodeBlock, updateCodeBlockInMessage, deleteCodeBlockByIndex: deleteCodeBlockByIndex$1 } = updateCodeBlock_1;
 const { formatWithLineNumbers: formatWithLineNumbers$1, formatBlockWithLineNumbers: formatBlockWithLineNumbers$1, formatBlocksWithLineNumbers: formatBlocksWithLineNumbers$1, removeLineNumbers: removeLineNumbers$1 } = lineNumberFormatter;
 const { getLineage: getLineage$1 } = lineageTracer;
@@ -10868,6 +11040,9 @@ var CodeBlockUtils$7 = {
     // Marker Removal
     removeCodeBlockMarkers: removeCodeBlockMarkers$1,
 
+    // Traceable Code Parsing
+    parseTraceableCodeHeaders: parseTraceableCodeHeaders$1,
+
     // Code Block Updating Utilities
     updateCodeBlockByIndex: updateCodeBlockByIndex$1,
     updateCodeBlockByUUID,
@@ -26287,6 +26462,7 @@ const {
     updateCodeBlockByIndex,
     deleteCodeBlockByIndex,
     getLineage,
+    parseTraceableCodeHeaders,
 } = CodeBlockUtils;
 
 const {
@@ -26644,6 +26820,7 @@ var GitSenseChatUtils_1 = {
     formatBlockWithLineNumbers,
     formatBlocksWithLineNumbers,
     removeLineNumbers,
+    parseTraceableCodeHeaders,
 
     // Other Utilities (from CodeBlockUtils)
     removeCodeBlockMarkers,

package/dist/gsc-utils.esm.js

@@ -1123,7 +1123,7 @@ var headerUtils = {
  * @param {string} text - The input text
  * @returns {Object} Object containing arrays of opening and closing fence positions: { openingPositions: Array, closingPositions: Array }
  */
-function findAllCodeFences$4(text) {
+function findAllCodeFences$5(text) {
     const openingPositions = [];
     const closingPositions = [];
 
@@ -1357,7 +1357,7 @@ function findCodeBlockByUUID$2(messageText, blockUUID) {
 }
 
 var blockExtractor = {
-    findAllCodeFences: findAllCodeFences$4,
+    findAllCodeFences: findAllCodeFences$5,
     matchFencesAndExtractBlocks: matchFencesAndExtractBlocks$4,
     extractCodeBlocksWithUUIDs: extractCodeBlocksWithUUIDs$1,
     findCodeBlockByUUID: findCodeBlockByUUID$2
@@ -1540,13 +1540,13 @@ var versionUtils = {
 
 /**
  * Component: PatchUtils Constants
- * Block-UUID: c6747054-2c8b-461f-910d-0fd725d9a350
- * Parent-UUID: 32adc00e-7509-4219-8e40-6c1319371db9
- * Version: 2.1.0
- * Description: Contains shared constants and regular expressions used by the enhanced patch utilities.
+ * Block-UUID: 83ba7eaa-36b3-41f3-bd07-130c0266301e
+ * Parent-UUID: c6747054-2c8b-461f-910d-0fd725d9a350
+ * Version: 2.2.0
+ * Description: Contains shared constants and regular expressions used by the enhanced patch utilities. Updated required metadata fields to include Component, Language, and Created-at.
  * Language: JavaScript
  * Created-at: 2025-05-14T16:55:00.000Z
- * Authors: Gemini 2.5 Flash Thinking (v1.0.0), Claude 3.7 Sonnet (v2.0.0), Qwen 3 Coder 480B - Cerebras (v2.1.0)
+ * Authors: Gemini 2.5 Flash Thinking (v1.0.0), Claude 3.7 Sonnet (v2.0.0), Qwen 3 Coder 480B - Cerebras (v2.1.0), GLM-4.7 (v2.2.0)
  */
 
 // Traditional patch markers
@@ -1576,13 +1576,13 @@ var constants$2 = {
 
 /**
  * Component: PatchUtils Parser
- * Block-UUID: ce634df9-ff99-482a-a261-56ab34a2546e
- * Parent-UUID: fcc85ec1-0146-40bf-a937-6f7928258cbf
- * Version: 1.2.0
- * Description: Handles parsing, validation, extraction, and detection of traditional unified diff patches and abbreviated patches. Extracts metadata and raw diff content.
+* Block-UUID: 334a0473-da2d-4859-b8a5-f867e3d88a28
+ * Parent-UUID: ce634df9-ff99-482a-a261-56ab34a2546e
+ * Version: 1.3.0
+ * Description: Handles parsing, validation, extraction, and detection of traditional unified diff patches and abbreviated patches. Extracts metadata and raw diff content. Updated validation to require Component and Language.
  * Language: JavaScript
  * Created-at: 2025-04-18T02:59:04.322Z
- * Authors: Gemini 2.5 Pro (v1.0.0), Gemini 2.5 Pro (v1.1.0), Qwen 3 Coder 480B - Cerebras (v1.2.0)
+ * Authors: Gemini 2.5 Pro (v1.0.0), Gemini 2.5 Pro (v1.1.0), Qwen 3 Coder 480B - Cerebras (v1.2.0), GLM-4.7 (v1.3.0)
  */
 
 const { isValidVersion } = versionUtils; // Assuming SharedUtils is one level up
@@ -1687,13 +1687,17 @@ function extractPatchMetadata$1(patchText) {
  */
 function validatePatchMetadata$1(metadata) {
     const errors = [];
+    // Updated to include Component and Language
     const requiredFields = [
+        'Component',
         'Source-Block-UUID',
         'Target-Block-UUID',
         'Source-Version',
         'Target-Version',
         'Description',
-        'Authors'
+        'Language',
+        'Authors',
+        'Created-at'
     ];
 
     for (const field of requiredFields) {
@@ -6675,13 +6679,13 @@ function escapeHTML(s) {
 
 /**
  * Component: PatchUtils Processor
- * Block-UUID: 96ec8bca-9fc3-441b-b81f-6fefc840c626
- * Parent-UUID: 9e5b8ae2-e978-4a20-b1dd-c044d9a5277f
- * Version: 1.3.0
- * Description: Handles applying, creating, and converting patches. Applies traditional unified diffs, cleaning line number prefixes from diff content before using jsdiff.
+ * Block-UUID: 58698895-c540-4be0-94b0-53dfcd0e1235
+ * Parent-UUID: 96ec8bca-9fc3-441b-b81f-6fefc840c626
+ * Version: 1.4.0
+ * Description: Handles applying, creating, and converting patches. Applies traditional unified diffs, cleaning line number prefixes from diff content before using jsdiff. Updated patch metadata formatting to include Component, Language, and Created-at.
  * Language: JavaScript
  * Created-at: 2025-07-20T17:24:16.836Z
- * Authors: Gemini 2.5 Pro (v1.0.0), Gemini 2.5 Pro (v1.1.0), Claude 3.7 Sonnet (v1.2.0), Gemini 2.5 Flash (v1.2.0), Gemini 2.5 Flash Thinking (v1.3.0)
+ * Authors: Gemini 2.5 Pro (v1.0.0), Gemini 2.5 Pro (v1.1.0), Claude 3.7 Sonnet (v1.2.0), Gemini 2.5 Flash (v1.2.0), Gemini 2.5 Flash Thinking (v1.3.0), GLM-4.7 (v1.4.0)
  */
 
 const parser$1 = patchParser;
@@ -6976,9 +6980,9 @@ function createPatchFromCodeBlocks(CodeBlockUtils, sourceCodeBlockText, targetCo
     // 4. Assemble Final Patch
     const formattedMetadata = _formatPatchMetadata(patchMetadata);
     const formatted = `${formattedMetadata}\n\n\n`+
-                      `# --- PATCH START MARKER ---\n`+
-                      `${adjustedDiffPatch}\n`+
-                      `# --- PATCH END MARKER ---`;
+        `# --- PATCH START MARKER ---\n`+
+        `${adjustedDiffPatch}\n`+
+        `# --- PATCH END MARKER ---`;
 
     return {
         formatted,
@@ -6995,12 +6999,18 @@ function createPatchFromCodeBlocks(CodeBlockUtils, sourceCodeBlockText, targetCo
  * @private
  */
 function _formatPatchMetadata(metadata) {
-    // --- Function body from original PatchUtils._formatPatchMetadata ---
-    // --- (Copied Verbatim) ---
     const lines = ['# Patch Metadata'];
+    // Updated order to match system prompt requirements
     const metadataOrder = [
-        'Source-Block-UUID', 'Target-Block-UUID', 'Source-Version', 'Target-Version',
-        'Description', 'Authors'
+        'Component',
+        'Source-Block-UUID',
+        'Target-Block-UUID',
+        'Source-Version',
+        'Target-Version',
+        'Description',
+        'Language',
+        'Created-at',
+        'Authors'
     ];
 
     // Add ordered metadata
@@ -7018,7 +7028,6 @@ function _formatPatchMetadata(metadata) {
     }
 
     return lines.join('\n');
-    // --- End of Function Body ---
 }
 
 var patchProcessor = {
@@ -8095,13 +8104,13 @@ var diagnosticReporter$1 = {
 
 /**
  * Component: PatchUtils Patch Extractor
- * Block-UUID: ad8cda91-244b-4f47-9847-d6c0d93424fc
- * Parent-UUID: N/A
- * Version: 1.0.0
- * Description: Extracts individual hunks from a patch and cleans line numbers from content.
+ * Block-UUID: d937fa30-196e-4221-9508-717f509f43d4
+ * Parent-UUID: ad8cda91-244b-4f47-9847-d6c0d93424fc
+ * Version: 1.1.0
+ * Description: Extracts individual hunks from a patch and cleans line numbers from content. Updated reconstructPatch to format metadata in the specific order required by the system prompt.
  * Language: JavaScript
  * Created-at: 2025-05-14T16:50:00.000Z
- * Authors: Claude 3.7 Sonnet (v1.0.0)
+ * Authors: Claude 3.7 Sonnet (v1.0.0), GLM-4.7 (v1.1.0)
  */
 
 const { removeLineNumbers: removeLineNumbers$4 } = lineNumberFormatter;
@@ -8241,11 +8250,33 @@ function extractAndCleanHunks$1(patchText) {
  * @returns {string} Reconstructed patch
  */
 function reconstructPatch$1(metadata, hunks) {
-    // Format metadata
+    // Format metadata in the specific order required by the system prompt
     let result = '# Patch Metadata\n';
+    
+    const metadataOrder = [
+        'Component',
+        'Source-Block-UUID',
+        'Target-Block-UUID',
+        'Source-Version',
+        'Target-Version',
+        'Description',
+        'Language',
+        'Created-at',
+        'Authors'
+    ];
+
+    // Add ordered metadata
+    metadataOrder.forEach(key => {
+        if (metadata[key]) {
+            result += `# ${key}: ${metadata[key]}\n`;
+        }
+    });
 
+    // Add any other metadata not in the preferred order
     for (const [key, value] of Object.entries(metadata)) {
-        result += `# ${key}: ${value}\n`;
+        if (!metadataOrder.includes(key)) {
+            result += `# ${key}: ${value}\n`;
+        }
     }
 
     // Add patch markers and hunks
@@ -9440,7 +9471,7 @@ var JsonUtils$2 = {
  * Authors: Gemini 2.5 Pro (v1.0.0), Gemini 2.5 Pro (v1.1.0), Gemini 2.5 Pro (v1.2.0), Gemini 2.5 Flash Thinking (v1.3.0), Gemini 2.5 Flash Thinking (v1.4.0), Qwen 3 Coder 480B - Cerebras (v1.5.0)
  */
 
-const { findAllCodeFences: findAllCodeFences$3, matchFencesAndExtractBlocks: matchFencesAndExtractBlocks$3 } = blockExtractor;
+const { findAllCodeFences: findAllCodeFences$4, matchFencesAndExtractBlocks: matchFencesAndExtractBlocks$3 } = blockExtractor;
 const { parseHeader: parseHeader$2 } = headerUtils;
 const { validateUUID: validateUUID$2 } = uuidUtils;
 const AnalysisBlockUtils$2 = AnalysisBlockUtils$3;
@@ -9795,7 +9826,7 @@ function processCodeBlocks$5(text, options = { silent: false, validatePatches: f
     }
 
     // Step 1: Find all fence positions
-    const { openingPositions, closingPositions } = findAllCodeFences$3(text);
+    const { openingPositions, closingPositions } = findAllCodeFences$4(text);
 
     // Step 2: Match fences to get potential block boundaries
     const { completeBlocks, incompleteBlocks, warnings: extractorWarnings } = matchFencesAndExtractBlocks$3(
@@ -10427,6 +10458,146 @@ Plain text block.
 // (Removed the check `if (typeof module !== 'undefined' && module.exports)` as it's standard in Node)
 var markerRemover = { removeCodeBlockMarkers: removeCodeBlockMarkers$2 };
 
+/**
+ * Component: CodeBlockUtils Traceable Code Parser
+ * Block-UUID: 8a4b2c1d-9e6f-4a3b-8c7d-1e2f3a4b5c6d
+ * Parent-UUID: N/A
+ * Version: 1.0.0
+ * Description: Parses the `Traceable Code` metadata lines preceding code blocks to extract pre-generated UUIDs and version flags for backend validation.
+ * Language: JavaScript
+ * Created-at: 2026-01-26T17:50:00.000Z
+ * Authors: GLM-4.7 (v1.0.0)
+ */
+
+const { findAllCodeFences: findAllCodeFences$3 } = blockExtractor;
+
+/**
+ * Parses `Traceable Code` metadata lines for all code blocks found in a message.
+ * It scans the text for code blocks and looks for the specific traceable header
+ * immediately preceding each block.
+ *
+ * @param {string} messageText - The full message text containing code blocks.
+ * @param {Object} [options] - Optional configuration.
+ * @param {boolean} [options.silent=true] - If false, logs warnings to console.
+ * @returns {TraceableCodeParseResult[]} An array of results, where each index
+ *                                         corresponds to a code block found in the message.
+ */
+function parseTraceableCodeHeaders$2(messageText, options = { silent: true }) {
+    if (typeof messageText !== 'string') {
+        if (!options.silent) {
+            console.warn('parseTraceableCodeHeaders: messageText must be a string.');
+        }
+        return [];
+    }
+
+    // Step 1: Find all code fence positions
+    const { openingPositions } = findAllCodeFences$3(messageText);
+    const results = [];
+
+    // Step 2: Iterate through each code block to find its preceding traceable line
+    openingPositions.forEach((fence, index) => {
+        const textBeforeFence = messageText.substring(0, fence.position);
+        const lines = textBeforeFence.split('\n');
+
+        let foundLine = null;
+        let searchLimit = 10; // Look back up to 10 lines to find the header
+        
+        // Iterate backwards from the fence
+        for (let i = lines.length - 1; i >= 0 && searchLimit > 0; i--) {
+            const line = lines[i].trim();
+
+            // Skip file path lines (e.g., `path/to/file.js`)
+            if (line.startsWith('`') && line.endsWith('`')) {
+                continue;
+            }
+            
+            // Skip empty lines
+            if (line === '') {
+                continue;
+            }
+
+            // Check for the traceable code marker
+            if (line.includes('**Traceable Code:**')) {
+                foundLine = line;
+                break;
+            }
+        }
+
+        if (foundLine) {
+            const parsedData = parseTraceableLine(foundLine);
+            results.push({
+                blockIndex: index,
+                found: true,
+                rawLine: foundLine,
+                data: parsedData.data,
+                errors: parsedData.errors
+            });
+        } else {
+            results.push({
+                blockIndex: index,
+                found: false,
+                rawLine: null,
+                data: null,
+                errors: []
+            });
+        }
+    });
+
+    return results;
+}
+
+/**
+ * Internal helper to parse a single traceable code line.
+ * @param {string} line - The raw line containing the traceable code metadata.
+ * @returns {Object} { data: Object, errors: Array }
+ */
+function parseTraceableLine(line) {
+    // Helper to extract value for a specific key
+    // Handles keys like **Key:** value, ignoring HTML entities like  
+    const extract = (key) => {
+        // Regex matches **Key:** followed by any characters until the next ** or end of line
+        // We strip HTML entities and extra whitespace from the result
+        const regex = new RegExp(`\\*\\*${key}:\\*\\*\\s*([^*]+)`, 'i');
+        const match = line.match(regex);
+        if (match) {
+            return match[1].trim().replace(/ /g, '').trim();
+        }
+        return null;
+    };
+
+    const isTraceableStr = extract('Traceable Code');
+    const isNewVersionStr = extract('New Version');
+    const currentParentUUID = extract('Current Parent-UUID');
+    const newParentUUID = extract('New Parent-UUID');
+    const newBlockUUID = extract('New Block-UUID');
+
+    const errors = [];
+    
+    // Basic validation of extracted values
+    if (!isTraceableStr || !['Yes', 'No'].includes(isTraceableStr)) {
+        errors.push({ type: 'invalid_value', message: 'Invalid or missing Traceable Code value (expected Yes/No).' });
+    }
+    
+    if (!isNewVersionStr || !['Yes', 'No', 'N/A'].includes(isNewVersionStr)) {
+        errors.push({ type: 'invalid_value', message: 'Invalid or missing New Version value (expected Yes/No/N/A).' });
+    }
+
+    return {
+        data: {
+            isTraceable: isTraceableStr === 'Yes',
+            isNewVersion: isNewVersionStr === 'Yes',
+            currentParentUUID: currentParentUUID,
+            newParentUUID: newParentUUID,
+            newBlockUUID: newBlockUUID
+        },
+        errors: errors
+    };
+}
+
+var traceableCodeParser = {
+    parseTraceableCodeHeaders: parseTraceableCodeHeaders$2
+};
+
 /**
  * Component: CodeBlockUtils Update Code Block
  * Block-UUID: 6a7b8c9d-0e1f-42a3-b4c5-d6e7f8a9b0c1
@@ -10799,13 +10970,13 @@ var lineageTracer = {
 
 /**
  * Component: CodeBlockUtils Index
- * Block-UUID: 98684aa5-d597-41b6-a7fd-cc16482aafdc
- * Parent-UUID: 7e9d3f8a-1b2c-4d5e-8f9a-0123456789ab
- * Version: 1.5.0
+ * Block-UUID: bf718ee3-fdb2-4fd1-85b8-418b24291179
+ * Parent-UUID: 98684aa5-d597-41b6-a7fd-cc16482aafdc
+ * Version: 1.6.0
  * Description: Aggregates and exports all utilities related to code block processing from the CodeBlockUtils module. Serves as the main entry point for this module.
  * Language: JavaScript
- * Created-at: 2025-04-15T16:02:20.217Z
- * Authors: Gemini 2.5 Pro (v1.0.0), Gemini 2.5 Pro (v1.1.0), Claude 3.7 Sonnet (v1.2.0), Gemini 2.5 Pro (v1.3.0), Gemini 2.5 Flash Thinking (v1.4.0), Qwen 3 Coder 480B - Cerebras (v1.5.0)
+ * Created-at: 2026-01-26T17:51:57.427Z
+ * Authors: Gemini 2.5 Pro (v1.0.0), Gemini 2.5 Pro (v1.1.0), Claude 3.7 Sonnet (v1.2.0), Gemini 2.5 Pro (v1.3.0), Gemini 2.5 Flash Thinking (v1.4.0), Qwen 3 Coder 480B - Cerebras (v1.5.0), GLM-4.7 (v1.6.0)
  */
 
 // Import from individual utility files
@@ -10819,6 +10990,7 @@ const { detectCodeBlockRelationships: detectCodeBlockRelationships$1, detectInco
 const { extractContinuationInfo: extractContinuationInfo$1, generateContinuationPrompt: generateContinuationPrompt$1 } = continuationUtils;
 const { parseCodeBlocks: parseCommentDelimitedBlocks$1 } = headerParser;
 const { removeCodeBlockMarkers: removeCodeBlockMarkers$1 } = markerRemover;
+const { parseTraceableCodeHeaders: parseTraceableCodeHeaders$1 } = traceableCodeParser;
 const { updateCodeBlockByIndex: updateCodeBlockByIndex$1, updateCodeBlockByUUID, updateCodeBlock, updateCodeBlockInMessage, deleteCodeBlockByIndex: deleteCodeBlockByIndex$1 } = updateCodeBlock_1;
 const { formatWithLineNumbers: formatWithLineNumbers$1, formatBlockWithLineNumbers: formatBlockWithLineNumbers$1, formatBlocksWithLineNumbers: formatBlocksWithLineNumbers$1, removeLineNumbers: removeLineNumbers$1 } = lineNumberFormatter;
 const { getLineage: getLineage$1 } = lineageTracer;
@@ -10866,6 +11038,9 @@ var CodeBlockUtils$7 = {
     // Marker Removal
     removeCodeBlockMarkers: removeCodeBlockMarkers$1,
 
+    // Traceable Code Parsing
+    parseTraceableCodeHeaders: parseTraceableCodeHeaders$1,
+
     // Code Block Updating Utilities
     updateCodeBlockByIndex: updateCodeBlockByIndex$1,
     updateCodeBlockByUUID,
@@ -26285,6 +26460,7 @@ const {
     updateCodeBlockByIndex,
     deleteCodeBlockByIndex,
     getLineage,
+    parseTraceableCodeHeaders,
 } = CodeBlockUtils;
 
 const {
@@ -26642,6 +26818,7 @@ var GitSenseChatUtils_1 = {
     formatBlockWithLineNumbers,
     formatBlocksWithLineNumbers,
     removeLineNumbers,
+    parseTraceableCodeHeaders,
 
     // Other Utilities (from CodeBlockUtils)
     removeCodeBlockMarkers,

package/package.json

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

package/src/CodeBlockUtils/index.js

@@ -1,12 +1,12 @@
 /**
  * Component: CodeBlockUtils Index
- * Block-UUID: 98684aa5-d597-41b6-a7fd-cc16482aafdc
- * Parent-UUID: 7e9d3f8a-1b2c-4d5e-8f9a-0123456789ab
- * Version: 1.5.0
+ * Block-UUID: bf718ee3-fdb2-4fd1-85b8-418b24291179
+ * Parent-UUID: 98684aa5-d597-41b6-a7fd-cc16482aafdc
+ * Version: 1.6.0
  * Description: Aggregates and exports all utilities related to code block processing from the CodeBlockUtils module. Serves as the main entry point for this module.
  * Language: JavaScript
- * Created-at: 2025-04-15T16:02:20.217Z
- * Authors: Gemini 2.5 Pro (v1.0.0), Gemini 2.5 Pro (v1.1.0), Claude 3.7 Sonnet (v1.2.0), Gemini 2.5 Pro (v1.3.0), Gemini 2.5 Flash Thinking (v1.4.0), Qwen 3 Coder 480B - Cerebras (v1.5.0)
+ * Created-at: 2026-01-26T17:51:57.427Z
+ * Authors: Gemini 2.5 Pro (v1.0.0), Gemini 2.5 Pro (v1.1.0), Claude 3.7 Sonnet (v1.2.0), Gemini 2.5 Pro (v1.3.0), Gemini 2.5 Flash Thinking (v1.4.0), Qwen 3 Coder 480B - Cerebras (v1.5.0), GLM-4.7 (v1.6.0)
  */
 
 
@@ -21,6 +21,7 @@ const { detectCodeBlockRelationships, detectIncompleteCodeBlock, extractFilePath
 const { extractContinuationInfo, generateContinuationPrompt } = require('./continuationUtils');
 const { parseCodeBlocks: parseCommentDelimitedBlocks } = require('./headerParser');
 const { removeCodeBlockMarkers } = require('./markerRemover');
+const { parseTraceableCodeHeaders } = require('./traceableCodeParser');
 const { updateCodeBlockByIndex, updateCodeBlockByUUID, updateCodeBlock, updateCodeBlockInMessage, deleteCodeBlockByIndex } = require('./updateCodeBlock');
 const { formatWithLineNumbers, formatBlockWithLineNumbers, formatBlocksWithLineNumbers, removeLineNumbers } = require('./lineNumberFormatter');
 const { getLineage } = require('./lineageTracer');
@@ -68,6 +69,9 @@ module.exports = {
     // Marker Removal
     removeCodeBlockMarkers,
 
+    // Traceable Code Parsing
+    parseTraceableCodeHeaders,
+
     // Code Block Updating Utilities
     updateCodeBlockByIndex,
     updateCodeBlockByUUID,

package/src/CodeBlockUtils/traceableCodeParser.js

@@ -0,0 +1,140 @@
+/**
+ * Component: CodeBlockUtils Traceable Code Parser
+ * Block-UUID: 8a4b2c1d-9e6f-4a3b-8c7d-1e2f3a4b5c6d
+ * Parent-UUID: N/A
+ * Version: 1.0.0
+ * Description: Parses the `Traceable Code` metadata lines preceding code blocks to extract pre-generated UUIDs and version flags for backend validation.
+ * Language: JavaScript
+ * Created-at: 2026-01-26T17:50:00.000Z
+ * Authors: GLM-4.7 (v1.0.0)
+ */
+
+
+const { findAllCodeFences } = require('./blockExtractor');
+
+/**
+ * Parses `Traceable Code` metadata lines for all code blocks found in a message.
+ * It scans the text for code blocks and looks for the specific traceable header
+ * immediately preceding each block.
+ *
+ * @param {string} messageText - The full message text containing code blocks.
+ * @param {Object} [options] - Optional configuration.
+ * @param {boolean} [options.silent=true] - If false, logs warnings to console.
+ * @returns {TraceableCodeParseResult[]} An array of results, where each index
+ *                                         corresponds to a code block found in the message.
+ */
+function parseTraceableCodeHeaders(messageText, options = { silent: true }) {
+    if (typeof messageText !== 'string') {
+        if (!options.silent) {
+            console.warn('parseTraceableCodeHeaders: messageText must be a string.');
+        }
+        return [];
+    }
+
+    // Step 1: Find all code fence positions
+    const { openingPositions } = findAllCodeFences(messageText);
+    const results = [];
+
+    // Step 2: Iterate through each code block to find its preceding traceable line
+    openingPositions.forEach((fence, index) => {
+        const textBeforeFence = messageText.substring(0, fence.position);
+        const lines = textBeforeFence.split('\n');
+
+        let foundLine = null;
+        let searchLimit = 10; // Look back up to 10 lines to find the header
+        
+        // Iterate backwards from the fence
+        for (let i = lines.length - 1; i >= 0 && searchLimit > 0; i--) {
+            const line = lines[i].trim();
+
+            // Skip file path lines (e.g., `path/to/file.js`)
+            if (line.startsWith('`') && line.endsWith('`')) {
+                continue;
+            }
+            
+            // Skip empty lines
+            if (line === '') {
+                continue;
+            }
+
+            // Check for the traceable code marker
+            if (line.includes('**Traceable Code:**')) {
+                foundLine = line;
+                break;
+            }
+        }
+
+        if (foundLine) {
+            const parsedData = parseTraceableLine(foundLine);
+            results.push({
+                blockIndex: index,
+                found: true,
+                rawLine: foundLine,
+                data: parsedData.data,
+                errors: parsedData.errors
+            });
+        } else {
+            results.push({
+                blockIndex: index,
+                found: false,
+                rawLine: null,
+                data: null,
+                errors: []
+            });
+        }
+    });
+
+    return results;
+}
+
+/**
+ * Internal helper to parse a single traceable code line.
+ * @param {string} line - The raw line containing the traceable code metadata.
+ * @returns {Object} { data: Object, errors: Array }
+ */
+function parseTraceableLine(line) {
+    // Helper to extract value for a specific key
+    // Handles keys like **Key:** value, ignoring HTML entities like  
+    const extract = (key) => {
+        // Regex matches **Key:** followed by any characters until the next ** or end of line
+        // We strip HTML entities and extra whitespace from the result
+        const regex = new RegExp(`\\*\\*${key}:\\*\\*\\s*([^*]+)`, 'i');
+        const match = line.match(regex);
+        if (match) {
+            return match[1].trim().replace(/ /g, '').trim();
+        }
+        return null;
+    };
+
+    const isTraceableStr = extract('Traceable Code');
+    const isNewVersionStr = extract('New Version');
+    const currentParentUUID = extract('Current Parent-UUID');
+    const newParentUUID = extract('New Parent-UUID');
+    const newBlockUUID = extract('New Block-UUID');
+
+    const errors = [];
+    
+    // Basic validation of extracted values
+    if (!isTraceableStr || !['Yes', 'No'].includes(isTraceableStr)) {
+        errors.push({ type: 'invalid_value', message: 'Invalid or missing Traceable Code value (expected Yes/No).' });
+    }
+    
+    if (!isNewVersionStr || !['Yes', 'No', 'N/A'].includes(isNewVersionStr)) {
+        errors.push({ type: 'invalid_value', message: 'Invalid or missing New Version value (expected Yes/No/N/A).' });
+    }
+
+    return {
+        data: {
+            isTraceable: isTraceableStr === 'Yes',
+            isNewVersion: isNewVersionStr === 'Yes',
+            currentParentUUID: currentParentUUID,
+            newParentUUID: newParentUUID,
+            newBlockUUID: newBlockUUID
+        },
+        errors: errors
+    };
+}
+
+module.exports = {
+    parseTraceableCodeHeaders
+};

package/src/GitSenseChatUtils.js

@@ -118,6 +118,7 @@ const {
     updateCodeBlockByIndex,
     deleteCodeBlockByIndex,
     getLineage,
+    parseTraceableCodeHeaders,
 } = CodeBlockUtils;
 
 const {
@@ -475,6 +476,7 @@ module.exports = {
     formatBlockWithLineNumbers,
     formatBlocksWithLineNumbers,
     removeLineNumbers,
+    parseTraceableCodeHeaders,
 
     // Other Utilities (from CodeBlockUtils)
     removeCodeBlockMarkers,

package/src/PatchUtils/constants.js

@@ -1,12 +1,12 @@
 /**
  * Component: PatchUtils Constants
- * Block-UUID: c6747054-2c8b-461f-910d-0fd725d9a350
- * Parent-UUID: 32adc00e-7509-4219-8e40-6c1319371db9
- * Version: 2.1.0
- * Description: Contains shared constants and regular expressions used by the enhanced patch utilities.
+ * Block-UUID: 83ba7eaa-36b3-41f3-bd07-130c0266301e
+ * Parent-UUID: c6747054-2c8b-461f-910d-0fd725d9a350
+ * Version: 2.2.0
+ * Description: Contains shared constants and regular expressions used by the enhanced patch utilities. Updated required metadata fields to include Component, Language, and Created-at.
  * Language: JavaScript
  * Created-at: 2025-05-14T16:55:00.000Z
- * Authors: Gemini 2.5 Flash Thinking (v1.0.0), Claude 3.7 Sonnet (v2.0.0), Qwen 3 Coder 480B - Cerebras (v2.1.0)
+ * Authors: Gemini 2.5 Flash Thinking (v1.0.0), Claude 3.7 Sonnet (v2.0.0), Qwen 3 Coder 480B - Cerebras (v2.1.0), GLM-4.7 (v2.2.0)
  */
 
 
@@ -46,12 +46,16 @@ const ABBREVIATED_PATCH_END_MARKER = '# --- ABBREVIATED PATCH END MARKER ---';
 const PATCH_METADATA_HEADER = '# Patch Metadata';
 
 // Required metadata fields
+// Updated to match the latest system prompt requirements
 const REQUIRED_METADATA_FIELDS = [
+    'Component',
     'Source-Block-UUID',
     'Target-Block-UUID',
     'Source-Version',
     'Target-Version',
     'Description',
+    'Language',
+    'Created-at',
     'Authors'
 ];
 

package/src/PatchUtils/patchExtractor.js

@@ -1,12 +1,12 @@
 /**
  * Component: PatchUtils Patch Extractor
- * Block-UUID: ad8cda91-244b-4f47-9847-d6c0d93424fc
- * Parent-UUID: N/A
- * Version: 1.0.0
- * Description: Extracts individual hunks from a patch and cleans line numbers from content.
+ * Block-UUID: d937fa30-196e-4221-9508-717f509f43d4
+ * Parent-UUID: ad8cda91-244b-4f47-9847-d6c0d93424fc
+ * Version: 1.1.0
+ * Description: Extracts individual hunks from a patch and cleans line numbers from content. Updated reconstructPatch to format metadata in the specific order required by the system prompt.
  * Language: JavaScript
  * Created-at: 2025-05-14T16:50:00.000Z
- * Authors: Claude 3.7 Sonnet (v1.0.0)
+ * Authors: Claude 3.7 Sonnet (v1.0.0), GLM-4.7 (v1.1.0)
  */
 
 
@@ -147,11 +147,33 @@ function extractAndCleanHunks(patchText) {
  * @returns {string} Reconstructed patch
  */
 function reconstructPatch(metadata, hunks) {
-    // Format metadata
+    // Format metadata in the specific order required by the system prompt
     let result = '# Patch Metadata\n';
+    
+    const metadataOrder = [
+        'Component',
+        'Source-Block-UUID',
+        'Target-Block-UUID',
+        'Source-Version',
+        'Target-Version',
+        'Description',
+        'Language',
+        'Created-at',
+        'Authors'
+    ];
+
+    // Add ordered metadata
+    metadataOrder.forEach(key => {
+        if (metadata[key]) {
+            result += `# ${key}: ${metadata[key]}\n`;
+        }
+    });
 
+    // Add any other metadata not in the preferred order
     for (const [key, value] of Object.entries(metadata)) {
-        result += `# ${key}: ${value}\n`;
+        if (!metadataOrder.includes(key)) {
+            result += `# ${key}: ${value}\n`;
+        }
     }
 
     // Add patch markers and hunks

package/src/PatchUtils/patchParser.js

@@ -1,12 +1,12 @@
 /**
  * Component: PatchUtils Parser
- * Block-UUID: ce634df9-ff99-482a-a261-56ab34a2546e
- * Parent-UUID: fcc85ec1-0146-40bf-a937-6f7928258cbf
- * Version: 1.2.0
- * Description: Handles parsing, validation, extraction, and detection of traditional unified diff patches and abbreviated patches. Extracts metadata and raw diff content.
+* Block-UUID: 334a0473-da2d-4859-b8a5-f867e3d88a28
+ * Parent-UUID: ce634df9-ff99-482a-a261-56ab34a2546e
+ * Version: 1.3.0
+ * Description: Handles parsing, validation, extraction, and detection of traditional unified diff patches and abbreviated patches. Extracts metadata and raw diff content. Updated validation to require Component and Language.
  * Language: JavaScript
  * Created-at: 2025-04-18T02:59:04.322Z
- * Authors: Gemini 2.5 Pro (v1.0.0), Gemini 2.5 Pro (v1.1.0), Qwen 3 Coder 480B - Cerebras (v1.2.0)
+ * Authors: Gemini 2.5 Pro (v1.0.0), Gemini 2.5 Pro (v1.1.0), Qwen 3 Coder 480B - Cerebras (v1.2.0), GLM-4.7 (v1.3.0)
  */
 
 
@@ -117,13 +117,17 @@ function extractPatchMetadata(patchText) {
  */
 function validatePatchMetadata(metadata) {
     const errors = [];
+    // Updated to include Component and Language
     const requiredFields = [
+        'Component',
         'Source-Block-UUID',
         'Target-Block-UUID',
         'Source-Version',
         'Target-Version',
         'Description',
-        'Authors'
+        'Language',
+        'Authors',
+        'Created-at'
     ];
 
     for (const field of requiredFields) {

package/src/PatchUtils/patchProcessor.js

@@ -1,12 +1,12 @@
 /**
  * Component: PatchUtils Processor
- * Block-UUID: 96ec8bca-9fc3-441b-b81f-6fefc840c626
- * Parent-UUID: 9e5b8ae2-e978-4a20-b1dd-c044d9a5277f
- * Version: 1.3.0
- * Description: Handles applying, creating, and converting patches. Applies traditional unified diffs, cleaning line number prefixes from diff content before using jsdiff.
+ * Block-UUID: 58698895-c540-4be0-94b0-53dfcd0e1235
+ * Parent-UUID: 96ec8bca-9fc3-441b-b81f-6fefc840c626
+ * Version: 1.4.0
+ * Description: Handles applying, creating, and converting patches. Applies traditional unified diffs, cleaning line number prefixes from diff content before using jsdiff. Updated patch metadata formatting to include Component, Language, and Created-at.
  * Language: JavaScript
  * Created-at: 2025-07-20T17:24:16.836Z
- * Authors: Gemini 2.5 Pro (v1.0.0), Gemini 2.5 Pro (v1.1.0), Claude 3.7 Sonnet (v1.2.0), Gemini 2.5 Flash (v1.2.0), Gemini 2.5 Flash Thinking (v1.3.0)
+ * Authors: Gemini 2.5 Pro (v1.0.0), Gemini 2.5 Pro (v1.1.0), Claude 3.7 Sonnet (v1.2.0), Gemini 2.5 Flash (v1.2.0), Gemini 2.5 Flash Thinking (v1.3.0), GLM-4.7 (v1.4.0)
  */
 
 
@@ -345,9 +345,9 @@ function createPatchFromCodeBlocks(CodeBlockUtils, sourceCodeBlockText, targetCo
     // 4. Assemble Final Patch
     const formattedMetadata = _formatPatchMetadata(patchMetadata);
     const formatted = `${formattedMetadata}\n\n\n`+
-                      `# --- PATCH START MARKER ---\n`+
-                      `${adjustedDiffPatch}\n`+
-                      `# --- PATCH END MARKER ---`;
+        `# --- PATCH START MARKER ---\n`+
+        `${adjustedDiffPatch}\n`+
+        `# --- PATCH END MARKER ---`;
 
     return {
         formatted,
@@ -364,12 +364,18 @@ function createPatchFromCodeBlocks(CodeBlockUtils, sourceCodeBlockText, targetCo
  * @private
  */
 function _formatPatchMetadata(metadata) {
-    // --- Function body from original PatchUtils._formatPatchMetadata ---
-    // --- (Copied Verbatim) ---
     const lines = ['# Patch Metadata'];
+    // Updated order to match system prompt requirements
     const metadataOrder = [
-        'Source-Block-UUID', 'Target-Block-UUID', 'Source-Version', 'Target-Version',
-        'Description', 'Authors'
+        'Component',
+        'Source-Block-UUID',
+        'Target-Block-UUID',
+        'Source-Version',
+        'Target-Version',
+        'Description',
+        'Language',
+        'Created-at',
+        'Authors'
     ];
 
     // Add ordered metadata
@@ -387,7 +393,6 @@ function _formatPatchMetadata(metadata) {
     }
 
     return lines.join('\n');
-    // --- End of Function Body ---
 }
 
 module.exports = {
@@ -395,5 +400,3 @@ module.exports = {
     createPatch,
     createPatchFromCodeBlocks,
 };
-
-