Function clone_git_project

helpers/projects.py:116–159

Clone a git repository as a new A0 project. Token is used only for cloning via http header.

(name: str, git_url: str, git_token: str, data: BasicProjectData)

def clone_git_project(name: str, git_url: str, git_token: str, data: BasicProjectData):
    """Clone a git repository as a new A0 project. Token is used only for cloning via http header."""
    from helpers import git

    extended_data = _project_extended_data_for_save(data)
    mcp_servers = data.get("mcp_servers") if isinstance(data, dict) else None
    
    abs_path = files.create_dir_safe(
        files.get_abs_path(PROJECTS_PARENT_DIR, name), rename_format="{name}_{number}"
    )
    actual_name = files.basename(abs_path)
    
    try:
        # Clone with token via http.extraHeader (token never in URL or git config)
        git.clone_repo(git_url, abs_path, token=git_token)
        clean_url = git.strip_auth_from_url(git_url)
        
        # Check if cloned repo already has .a0proj
        meta_path = os.path.join(abs_path, PROJECT_META_DIR, PROJECT_HEADER_FILE)
        if os.path.exists(meta_path):
            # Merge: keep cloned content, override only user-specified fields
            cloned_header: BasicProjectData = dirty_json.parse(files.read_file(meta_path)) # type: ignore
            cloned_header["title"] = data.get("title") or cloned_header.get("title", "")
            cloned_header["color"] = data.get("color") or cloned_header.get("color", "")
            cloned_header["git_url"] = clean_url
            save_project_header(actual_name, cloned_header)
        else:
            # New project: create meta folders and save header
            create_project_meta_folders(actual_name)
            data = _normalizeBasicData(data)
            data["git_url"] = clean_url
            save_project_header(actual_name, data)

        if mcp_servers:
            save_project_mcp_servers(actual_name, mcp_servers)
        save_project_extended_data(actual_name, extended_data)
        
        return actual_name
    except Exception as e:
        try:
            files.delete_dir(abs_path)
        except Exception:
            pass
        raise e


def load_project_header(name: str):