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] # 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("```") return "\n".join(lines)