Function ensure_github_pages

Scripts/Developer Base/Dead Man's Switch.py:3184–3212

Return the expected GitHub Pages URL and update README. GitHub often requires Pages to be enabled manually from repository Settings > Pages. If Pages already exists, this function best-effort updates it/enforces HTTPS without printing raw API errors.

(owner: str, branch: str = "")

    return generated

def ensure_github_pages(owner: str, branch: str = "") -> str:
    """Return the expected GitHub Pages URL and update README.
    GitHub often requires Pages to be enabled manually from repository Settings > Pages.
    If Pages already exists, this function best-effort updates it/enforces HTTPS without printing raw API errors.
    """
    ensure_repo_scope()
    branch = branch or current_branch() or get_default_branch(owner) or "main"
    pages_url = expected_pages_url(owner)

    rc, out = run_rc(["gh", "api", f"repos/{owner}/{REPO_NAME}/pages", "--jq", ".html_url"], capture=True)
    known = (out or "").strip() if rc == 0 else ""
    if known.startswith("http"):
        pages_url = known
        # Best-effort update existing Pages settings and enforce HTTPS. Ignore failures.
        run_rc([
            "gh", "api", "-X", "PUT", f"repos/{owner}/{REPO_NAME}/pages",
            "-f", f"source[branch]={branch}",
            "-f", "source[path]=/",
            "-F", "https_enforced=true"
        ], capture=True)
        print(f"[✓] GitHub Pages URL: {pages_url}")
    else:
        print("[!] GitHub Pages is not enabled yet or GitHub has not published it yet.")
        print("    Enable it manually in repository Settings > Pages.")
        print(f"    Expected website link after setup: {pages_url}")

    commit_readme_with_pages_url(owner, pages_url)
    print("    It can take a little time for GitHub Pages to finish publishing after a push.")
    return pages_url

def publish_static_website(enable_pages: bool = True) -> str:
    print("\n=== Build / Publish Emergency Website ===")