@probelabs/probe 0.6.0-rc64 → 0.6.0-rc66

package/build/agent/index.js

@@ -1843,7 +1843,20 @@ You are Probe, a specialized code intelligence assistant. Your objective is to a
     *   Probe Action 2: \`search\` query: \`import AND "pkg/errors"\`, path: \`"service/"\` (Check where a potential custom error package is used)
     *   (Analysis: Confirms \`pkg/errors\` is widely used.)
     *   Probe Action 3: \`query\` language: \`go\`, pattern: \`errors.Wrap($$$)\`, path: \`"service/"\` (Find structural usage of the custom wrapper)
-    *   (Response: Summarize error handling: Mention standard \`fmt.Errorf\` and the prevalent use of a custom \`errors.Wrap\` function from \`pkg/errors\`, providing examples from locations found by search/query like \`service/user/handler.go\`.)`;
+    *   (Response: Summarize error handling: Mention standard \`fmt.Errorf\` and the prevalent use of a custom \`errors.Wrap\` function from \`pkg/errors\`, providing examples from locations found by search/query like \`service/user/handler.go\`.)
+
+<mermaid-instructions>
+For GitHub-compatible mermaid diagrams, avoid single quotes and parentheses in node labels:
+
+**Rules:**
+- NO single quotes in any node labels: 'text' \u2192 "text" or text
+- NO parentheses in square brackets: [Text (detail)] \u2192 [Text - detail]
+- NO complex expressions in diamonds: {a && b} \u2192 {condition}
+
+**Examples:**
+- \u2705 [Load Config] ["Run command"] {Valid?}
+- \u274C [Load (config)] [Run 'command'] {isValid('x')}
+</mermaid-instructions>`;
   }
 });
 
@@ -2440,6 +2453,31 @@ async function validateMermaidDiagram(diagram) {
             detailedError: `Line "${line}" contains an unclosed bracket`
           };
         }
+        const nodeWithParens = line.match(/\[[^"\[\]]*\([^"\[\]]*\]/);
+        if (nodeWithParens) {
+          return {
+            isValid: false,
+            error: `Parentheses in node label on line ${i + 1} (GitHub incompatible)`,
+            detailedError: `Line "${line}" contains parentheses inside node label brackets. GitHub mermaid renderer fails with 'got PS' error. Use quotes or escape characters instead.`
+          };
+        }
+        const nodeWithQuotes = line.match(/\{[^{}]*'[^{}]*\}|\[[^[\]]*'[^[\]]*\]/);
+        if (nodeWithQuotes) {
+          return {
+            isValid: false,
+            error: `Single quotes in node label on line ${i + 1} (GitHub incompatible)`,
+            detailedError: `Line "${line}" contains single quotes inside node label. GitHub mermaid renderer fails with 'got PS' error. Use double quotes or escape characters instead.`
+          };
+        }
+        const diamondWithComplexContent = line.match(/\{[^"{}]*[()'"<>&][^"{}]*\}/);
+        const hasHtmlBreak = line.match(/\{[^{}]*<br\s*\/?>.*\}/);
+        if (diamondWithComplexContent && !line.match(/\{\"[^\"]*\"\}/) && !hasHtmlBreak) {
+          return {
+            isValid: false,
+            error: `Complex expression in diamond node on line ${i + 1} (GitHub incompatible)`,
+            detailedError: `Line "${line}" contains special characters in diamond node that may cause GitHub parsing errors. Use simpler text or escape characters.`
+          };
+        }
       }
       if (diagramType === "sequence") {
         if (line.includes("->>") && !line.includes(":")) {

package/build/agent/schemaUtils.js

@@ -327,14 +327,14 @@ export async function validateMermaidDiagram(diagram) {
       };
     }
 
-    // Basic syntax validation based on diagram type
+    // GitHub-compatible strict syntax validation
     const lines = trimmedDiagram.split('\n');
     
     for (let i = 0; i < lines.length; i++) {
       const line = lines[i].trim();
       if (!line) continue;
       
-      // Check for severely malformed syntax that would break parsing
+      // Check for GitHub-incompatible patterns that cause "got 'PS'" errors
       if (diagramType === 'flowchart') {
         // Check for unbalanced brackets in node labels
         const brackets = line.match(/\[[^\]]*$/); // Unclosed bracket
@@ -345,6 +345,40 @@ export async function validateMermaidDiagram(diagram) {
             detailedError: `Line "${line}" contains an unclosed bracket`
           };
         }
+        
+        // GitHub-strict: Check for parentheses inside node labels (causes PS token error)
+        // But allow parentheses inside double-quoted strings
+        const nodeWithParens = line.match(/\[[^"\[\]]*\([^"\[\]]*\]/);
+        if (nodeWithParens) {
+          return {
+            isValid: false,
+            error: `Parentheses in node label on line ${i + 1} (GitHub incompatible)`,
+            detailedError: `Line "${line}" contains parentheses inside node label brackets. GitHub mermaid renderer fails with 'got PS' error. Use quotes or escape characters instead.`
+          };
+        }
+        
+        // GitHub-strict: Check for single quotes inside node labels (causes PS token error)
+        const nodeWithQuotes = line.match(/\{[^{}]*'[^{}]*\}|\[[^[\]]*'[^[\]]*\]/);
+        if (nodeWithQuotes) {
+          return {
+            isValid: false,
+            error: `Single quotes in node label on line ${i + 1} (GitHub incompatible)`,
+            detailedError: `Line "${line}" contains single quotes inside node label. GitHub mermaid renderer fails with 'got PS' error. Use double quotes or escape characters instead.`
+          };
+        }
+        
+        // GitHub-strict: Check for complex expressions inside diamond nodes
+        // Allow double-quoted strings in diamond nodes, but catch problematic single quotes and complex expressions
+        // Allow HTML breaks (<br/>, <br>, etc.) but catch other problematic patterns
+        const diamondWithComplexContent = line.match(/\{[^"{}]*[()'"<>&][^"{}]*\}/);
+        const hasHtmlBreak = line.match(/\{[^{}]*<br\s*\/?>.*\}/);
+        if (diamondWithComplexContent && !line.match(/\{\"[^\"]*\"\}/) && !hasHtmlBreak) {
+          return {
+            isValid: false,
+            error: `Complex expression in diamond node on line ${i + 1} (GitHub incompatible)`,
+            detailedError: `Line "${line}" contains special characters in diamond node that may cause GitHub parsing errors. Use simpler text or escape characters.`
+          };
+        }
       }
       
       if (diagramType === 'sequence') {

package/build/tools/system-message.js

@@ -66,4 +66,17 @@ You are Probe, a specialized code intelligence assistant. Your objective is to a
     *   Probe Action 2: \`search\` query: \`import AND "pkg/errors"\`, path: \`"service/"\` (Check where a potential custom error package is used)
     *   (Analysis: Confirms \`pkg/errors\` is widely used.)
     *   Probe Action 3: \`query\` language: \`go\`, pattern: \`errors.Wrap($$$)\`, path: \`"service/"\` (Find structural usage of the custom wrapper)
-    *   (Response: Summarize error handling: Mention standard \`fmt.Errorf\` and the prevalent use of a custom \`errors.Wrap\` function from \`pkg/errors\`, providing examples from locations found by search/query like \`service/user/handler.go\`.)`
+    *   (Response: Summarize error handling: Mention standard \`fmt.Errorf\` and the prevalent use of a custom \`errors.Wrap\` function from \`pkg/errors\`, providing examples from locations found by search/query like \`service/user/handler.go\`.)
+
+<mermaid-instructions>
+For GitHub-compatible mermaid diagrams, avoid single quotes and parentheses in node labels:
+
+**Rules:**
+- NO single quotes in any node labels: 'text' → "text" or text
+- NO parentheses in square brackets: [Text (detail)] → [Text - detail]
+- NO complex expressions in diamonds: {a && b} → {condition}
+
+**Examples:**
+- ✅ [Load Config] ["Run command"] {Valid?}
+- ❌ [Load (config)] [Run 'command'] {isValid('x')}
+</mermaid-instructions>`

package/cjs/agent/ProbeAgent.cjs

@@ -1864,7 +1864,20 @@ You are Probe, a specialized code intelligence assistant. Your objective is to a
     *   Probe Action 2: \`search\` query: \`import AND "pkg/errors"\`, path: \`"service/"\` (Check where a potential custom error package is used)
     *   (Analysis: Confirms \`pkg/errors\` is widely used.)
     *   Probe Action 3: \`query\` language: \`go\`, pattern: \`errors.Wrap($$$)\`, path: \`"service/"\` (Find structural usage of the custom wrapper)
-    *   (Response: Summarize error handling: Mention standard \`fmt.Errorf\` and the prevalent use of a custom \`errors.Wrap\` function from \`pkg/errors\`, providing examples from locations found by search/query like \`service/user/handler.go\`.)`;
+    *   (Response: Summarize error handling: Mention standard \`fmt.Errorf\` and the prevalent use of a custom \`errors.Wrap\` function from \`pkg/errors\`, providing examples from locations found by search/query like \`service/user/handler.go\`.)
+
+<mermaid-instructions>
+For GitHub-compatible mermaid diagrams, avoid single quotes and parentheses in node labels:
+
+**Rules:**
+- NO single quotes in any node labels: 'text' \u2192 "text" or text
+- NO parentheses in square brackets: [Text (detail)] \u2192 [Text - detail]
+- NO complex expressions in diamonds: {a && b} \u2192 {condition}
+
+**Examples:**
+- \u2705 [Load Config] ["Run command"] {Valid?}
+- \u274C [Load (config)] [Run 'command'] {isValid('x')}
+</mermaid-instructions>`;
   }
 });
 
@@ -2427,6 +2440,31 @@ async function validateMermaidDiagram(diagram) {
             detailedError: `Line "${line}" contains an unclosed bracket`
           };
         }
+        const nodeWithParens = line.match(/\[[^"\[\]]*\([^"\[\]]*\]/);
+        if (nodeWithParens) {
+          return {
+            isValid: false,
+            error: `Parentheses in node label on line ${i + 1} (GitHub incompatible)`,
+            detailedError: `Line "${line}" contains parentheses inside node label brackets. GitHub mermaid renderer fails with 'got PS' error. Use quotes or escape characters instead.`
+          };
+        }
+        const nodeWithQuotes = line.match(/\{[^{}]*'[^{}]*\}|\[[^[\]]*'[^[\]]*\]/);
+        if (nodeWithQuotes) {
+          return {
+            isValid: false,
+            error: `Single quotes in node label on line ${i + 1} (GitHub incompatible)`,
+            detailedError: `Line "${line}" contains single quotes inside node label. GitHub mermaid renderer fails with 'got PS' error. Use double quotes or escape characters instead.`
+          };
+        }
+        const diamondWithComplexContent = line.match(/\{[^"{}]*[()'"<>&][^"{}]*\}/);
+        const hasHtmlBreak = line.match(/\{[^{}]*<br\s*\/?>.*\}/);
+        if (diamondWithComplexContent && !line.match(/\{\"[^\"]*\"\}/) && !hasHtmlBreak) {
+          return {
+            isValid: false,
+            error: `Complex expression in diamond node on line ${i + 1} (GitHub incompatible)`,
+            detailedError: `Line "${line}" contains special characters in diamond node that may cause GitHub parsing errors. Use simpler text or escape characters.`
+          };
+        }
       }
       if (diagramType === "sequence") {
         if (line.includes("->>") && !line.includes(":")) {

package/cjs/index.cjs

@@ -1633,7 +1633,20 @@ You are Probe, a specialized code intelligence assistant. Your objective is to a
     *   Probe Action 2: \`search\` query: \`import AND "pkg/errors"\`, path: \`"service/"\` (Check where a potential custom error package is used)
     *   (Analysis: Confirms \`pkg/errors\` is widely used.)
     *   Probe Action 3: \`query\` language: \`go\`, pattern: \`errors.Wrap($$$)\`, path: \`"service/"\` (Find structural usage of the custom wrapper)
-    *   (Response: Summarize error handling: Mention standard \`fmt.Errorf\` and the prevalent use of a custom \`errors.Wrap\` function from \`pkg/errors\`, providing examples from locations found by search/query like \`service/user/handler.go\`.)`;
+    *   (Response: Summarize error handling: Mention standard \`fmt.Errorf\` and the prevalent use of a custom \`errors.Wrap\` function from \`pkg/errors\`, providing examples from locations found by search/query like \`service/user/handler.go\`.)
+
+<mermaid-instructions>
+For GitHub-compatible mermaid diagrams, avoid single quotes and parentheses in node labels:
+
+**Rules:**
+- NO single quotes in any node labels: 'text' \u2192 "text" or text
+- NO parentheses in square brackets: [Text (detail)] \u2192 [Text - detail]
+- NO complex expressions in diamonds: {a && b} \u2192 {condition}
+
+**Examples:**
+- \u2705 [Load Config] ["Run command"] {Valid?}
+- \u274C [Load (config)] [Run 'command'] {isValid('x')}
+</mermaid-instructions>`;
   }
 });
 
@@ -2501,6 +2514,31 @@ async function validateMermaidDiagram(diagram) {
             detailedError: `Line "${line}" contains an unclosed bracket`
           };
         }
+        const nodeWithParens = line.match(/\[[^"\[\]]*\([^"\[\]]*\]/);
+        if (nodeWithParens) {
+          return {
+            isValid: false,
+            error: `Parentheses in node label on line ${i + 1} (GitHub incompatible)`,
+            detailedError: `Line "${line}" contains parentheses inside node label brackets. GitHub mermaid renderer fails with 'got PS' error. Use quotes or escape characters instead.`
+          };
+        }
+        const nodeWithQuotes = line.match(/\{[^{}]*'[^{}]*\}|\[[^[\]]*'[^[\]]*\]/);
+        if (nodeWithQuotes) {
+          return {
+            isValid: false,
+            error: `Single quotes in node label on line ${i + 1} (GitHub incompatible)`,
+            detailedError: `Line "${line}" contains single quotes inside node label. GitHub mermaid renderer fails with 'got PS' error. Use double quotes or escape characters instead.`
+          };
+        }
+        const diamondWithComplexContent = line.match(/\{[^"{}]*[()'"<>&][^"{}]*\}/);
+        const hasHtmlBreak = line.match(/\{[^{}]*<br\s*\/?>.*\}/);
+        if (diamondWithComplexContent && !line.match(/\{\"[^\"]*\"\}/) && !hasHtmlBreak) {
+          return {
+            isValid: false,
+            error: `Complex expression in diamond node on line ${i + 1} (GitHub incompatible)`,
+            detailedError: `Line "${line}" contains special characters in diamond node that may cause GitHub parsing errors. Use simpler text or escape characters.`
+          };
+        }
       }
       if (diagramType === "sequence") {
         if (line.includes("->>") && !line.includes(":")) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@probelabs/probe",
-  "version": "0.6.0-rc64",
+  "version": "0.6.0-rc66",
   "description": "Node.js wrapper for the probe code search tool",
   "main": "src/index.js",
   "module": "src/index.js",
@@ -31,7 +31,9 @@
     "bin/probe.exe",
     "bin/.gitkeep",
     "scripts/postinstall.js",
-    "build/**/*"
+    "build/**/*",
+    "MERMAID_SUPPORT_SUMMARY.md",
+    "GITHUB_MERMAID_COMPATIBILITY.md"
   ],
   "scripts": {
     "postinstall": "node scripts/postinstall.js",

package/scripts/postinstall.js

@@ -24,6 +24,18 @@ const binDir = path.resolve(__dirname, '..', 'bin');
  */
 async function main() {
 	try {
+		// Skip postinstall if binary already exists (for CI or development)
+		const isWindows = process.platform === 'win32';
+		const targetBinaryName = isWindows ? 'probe.exe' : 'probe-binary';
+		const targetBinaryPath = path.join(binDir, targetBinaryName);
+		
+		if (await fs.pathExists(targetBinaryPath)) {
+			if (process.env.DEBUG === '1' || process.env.VERBOSE === '1') {
+				console.log(`Probe binary already exists at ${targetBinaryPath}, skipping download`);
+			}
+			return;
+		}
+
 		// Create the bin directory if it doesn't exist
 		if (process.env.DEBUG === '1' || process.env.VERBOSE === '1') {
 			console.log(`Creating bin directory at: ${binDir}`);
@@ -109,9 +121,7 @@ You can download the binary from: https://github.com/probelabs/probe/releases
 			}
 
 			// Get the path to the target binary (preserve the Node.js wrapper script)
-			const isWindows = process.platform === 'win32';
-			const targetBinaryName = isWindows ? 'probe.exe' : 'probe-binary';
-			const targetBinaryPath = path.join(binDir, targetBinaryName);
+			// (variables already declared at the beginning of main function)
 
 			// Copy the downloaded binary to the correct location
 			if (binaryPath !== targetBinaryPath) {

package/src/agent/schemaUtils.js

@@ -327,14 +327,14 @@ export async function validateMermaidDiagram(diagram) {
       };
     }
 
-    // Basic syntax validation based on diagram type
+    // GitHub-compatible strict syntax validation
     const lines = trimmedDiagram.split('\n');
     
     for (let i = 0; i < lines.length; i++) {
       const line = lines[i].trim();
       if (!line) continue;
       
-      // Check for severely malformed syntax that would break parsing
+      // Check for GitHub-incompatible patterns that cause "got 'PS'" errors
       if (diagramType === 'flowchart') {
         // Check for unbalanced brackets in node labels
         const brackets = line.match(/\[[^\]]*$/); // Unclosed bracket
@@ -345,6 +345,40 @@ export async function validateMermaidDiagram(diagram) {
             detailedError: `Line "${line}" contains an unclosed bracket`
           };
         }
+        
+        // GitHub-strict: Check for parentheses inside node labels (causes PS token error)
+        // But allow parentheses inside double-quoted strings
+        const nodeWithParens = line.match(/\[[^"\[\]]*\([^"\[\]]*\]/);
+        if (nodeWithParens) {
+          return {
+            isValid: false,
+            error: `Parentheses in node label on line ${i + 1} (GitHub incompatible)`,
+            detailedError: `Line "${line}" contains parentheses inside node label brackets. GitHub mermaid renderer fails with 'got PS' error. Use quotes or escape characters instead.`
+          };
+        }
+        
+        // GitHub-strict: Check for single quotes inside node labels (causes PS token error)
+        const nodeWithQuotes = line.match(/\{[^{}]*'[^{}]*\}|\[[^[\]]*'[^[\]]*\]/);
+        if (nodeWithQuotes) {
+          return {
+            isValid: false,
+            error: `Single quotes in node label on line ${i + 1} (GitHub incompatible)`,
+            detailedError: `Line "${line}" contains single quotes inside node label. GitHub mermaid renderer fails with 'got PS' error. Use double quotes or escape characters instead.`
+          };
+        }
+        
+        // GitHub-strict: Check for complex expressions inside diamond nodes
+        // Allow double-quoted strings in diamond nodes, but catch problematic single quotes and complex expressions
+        // Allow HTML breaks (<br/>, <br>, etc.) but catch other problematic patterns
+        const diamondWithComplexContent = line.match(/\{[^"{}]*[()'"<>&][^"{}]*\}/);
+        const hasHtmlBreak = line.match(/\{[^{}]*<br\s*\/?>.*\}/);
+        if (diamondWithComplexContent && !line.match(/\{\"[^\"]*\"\}/) && !hasHtmlBreak) {
+          return {
+            isValid: false,
+            error: `Complex expression in diamond node on line ${i + 1} (GitHub incompatible)`,
+            detailedError: `Line "${line}" contains special characters in diamond node that may cause GitHub parsing errors. Use simpler text or escape characters.`
+          };
+        }
       }
       
       if (diagramType === 'sequence') {

package/src/tools/system-message.js

@@ -66,4 +66,17 @@ You are Probe, a specialized code intelligence assistant. Your objective is to a
     *   Probe Action 2: \`search\` query: \`import AND "pkg/errors"\`, path: \`"service/"\` (Check where a potential custom error package is used)
     *   (Analysis: Confirms \`pkg/errors\` is widely used.)
     *   Probe Action 3: \`query\` language: \`go\`, pattern: \`errors.Wrap($$$)\`, path: \`"service/"\` (Find structural usage of the custom wrapper)
-    *   (Response: Summarize error handling: Mention standard \`fmt.Errorf\` and the prevalent use of a custom \`errors.Wrap\` function from \`pkg/errors\`, providing examples from locations found by search/query like \`service/user/handler.go\`.)`
+    *   (Response: Summarize error handling: Mention standard \`fmt.Errorf\` and the prevalent use of a custom \`errors.Wrap\` function from \`pkg/errors\`, providing examples from locations found by search/query like \`service/user/handler.go\`.)
+
+<mermaid-instructions>
+For GitHub-compatible mermaid diagrams, avoid single quotes and parentheses in node labels:
+
+**Rules:**
+- NO single quotes in any node labels: 'text' → "text" or text
+- NO parentheses in square brackets: [Text (detail)] → [Text - detail]
+- NO complex expressions in diamonds: {a && b} → {condition}
+
+**Examples:**
+- ✅ [Load Config] ["Run command"] {Valid?}
+- ❌ [Load (config)] [Run 'command'] {isValid('x')}
+</mermaid-instructions>`