utils/docgen.py

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}  

## Preview