Update utils/docgen.py

utils/docgen.py

@@ -2,13 +2,26 @@ import hashlib
 
 def generate_doc(name: str, path: str, content: str) -> str:
     """Generate basic README-style documentation for a script."""
+
     sha1 = hashlib.sha1(content.encode()).hexdigest()
     usage = "bash " + name if name.endswith(".sh") else f"python {name}"
     preview = content[:300]
 
-    return f"""# {name}
-
-**Path:** `{path}`  
-**SHA1:** `{sha1}`  
+    # Build output line by line to avoid triple-quote issues
+    lines = []
+    lines.append(f"# {name}")
+    lines.append("")
+    lines.append(f"**Path:** `{path}`  ")
+    lines.append(f"**SHA1:** `{sha1}`  ")
+    lines.append("")
+    lines.append("## Usage")
+    lines.append("```")
+    lines.append(usage)
+    lines.append("```")
+    lines.append("")
+    lines.append("## Preview (first 300 chars)")
+    lines.append("```")
+    lines.append(preview)
+    lines.append("```")
 
-## Usage
+    return "\n".join(lines)