| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221 |
- """Git dashboard routes — the remote half of the desktop coding rail + review pane.
- The desktop runs these as Electron-local git; over a remote gateway that's the wrong
- filesystem, so they are mirrored here with the same auth gate + path hardening as
- /api/fs. Logic lives in ``hermes_cli.web_git``; these are thin executor-offloaded
- wrappers (git/gh can block).
- """
- import asyncio
- import shutil
- import time
- from functools import partial
- from pathlib import Path
- from typing import Optional
- from fastapi import APIRouter, HTTPException, Request
- from hermes_cli import web_git as _web_git
- from hermes_cli._subprocess_compat import bounded_probe_run
- from hermes_cli.web_deps import late
- from hermes_cli.web_server_files import _fs_path, _hosted_fs_path_allowed, _hosted_fs_read_guard
- from hermes_cli.web_models import (
- GitBranchSwitchBody,
- GitCommitBody,
- GitFileBody,
- GitPathBody,
- GitPrListBody,
- GitWorktreeAddBody,
- GitWorktreeRemoveBody,
- )
- router = APIRouter()
- # Late-bound so a test's monkeypatch on the owning module wins at call time.
- async def _git_op(fn, *args):
- """Run a (blocking) git op off the event loop; map a failed mutation to 400."""
- loop = asyncio.get_running_loop()
- try:
- return await loop.run_in_executor(None, fn, *args)
- except RuntimeError as exc:
- raise HTTPException(status_code=400, detail=str(exc) or "git operation failed")
- def _git_path(path: str) -> str:
- return str(_fs_path(path))
- @router.get("/api/git/status")
- async def git_status_route(path: str):
- return await _git_op(_web_git.repo_status, _git_path(path))
- # Cached `gh auth status` for the desktop composer's GitHub suggestion pill. GitHub
- # deliberately has NO MCP catalog entry (hosted MCP needs a per-host OAuth app; the
- # gh-CLI skills are the better integration), so the pill offers `/github-auth` —
- # only to users who aren't already authenticated.
- _GH_AUTH_TTL_S = 300.0
- _gh_auth_cache: Optional[tuple] = None # (monotonic_ts, payload)
- _gh_auth_probe_task: Optional[asyncio.Task] = None
- _gh_auth_probe_started = 0.0 # monotonic start of _gh_auth_probe_task
- def _probe_gh_auth() -> dict:
- gh = shutil.which("gh")
- if not gh:
- return {"available": False, "authenticated": False}
- try:
- # Exits 0 when at least one host is logged in; DEVNULL stdin guards against any prompt.
- proc = bounded_probe_run([gh, "auth", "status"], timeout=10)
- return {"available": True, "authenticated": bool(proc and proc.returncode == 0)}
- except Exception:
- return {"available": True, "authenticated": False}
- def _clear_gh_auth_probe_task(completed_task: asyncio.Task) -> None:
- """Release a completed shared probe even if all requesters disconnected."""
- global _gh_auth_probe_task
- if _gh_auth_probe_task is completed_task:
- _gh_auth_probe_task = None
- @router.get("/api/git/gh-auth")
- async def gh_auth_status_route(refresh: bool = False):
- """``{"available", "authenticated"}`` for the `gh` CLI; cached 5 min
- (``refresh=true`` bypasses so the pill withdraws right after a login)."""
- global _gh_auth_cache, _gh_auth_probe_task, _gh_auth_probe_started
- asked = time.monotonic()
- if not refresh and _gh_auth_cache and asked - _gh_auth_cache[0] < _GH_AUTH_TTL_S:
- return _gh_auth_cache[1]
- while True:
- if _gh_auth_probe_task is None or _gh_auth_probe_task.done():
- _gh_auth_probe_task = asyncio.create_task(asyncio.to_thread(_probe_gh_auth))
- _gh_auth_probe_started = time.monotonic()
- _gh_auth_probe_task.add_done_callback(_clear_gh_auth_probe_task)
- probe_task, started = _gh_auth_probe_task, _gh_auth_probe_started
- # Shield the shared probe: disconnecting one requester must not cancel the
- # probe that other refreshes/cache misses are awaiting.
- payload = await asyncio.shield(probe_task)
- # A refresh must not accept a probe that started before it was asked for (it may predate
- # `gh auth login`, and its answer would then be cached for the full TTL): wait that one out,
- # then start or join the next. Still only one `gh` runs at a time.
- if not refresh or started >= asked:
- break
- _gh_auth_cache = (time.monotonic(), payload)
- return payload
- @router.get("/api/git/worktrees")
- async def git_worktrees_route(path: str):
- return {"worktrees": await _git_op(_web_git.worktree_list, _git_path(path))}
- @router.get("/api/git/branches")
- async def git_branches_route(path: str):
- return {"branches": await _git_op(_web_git.branch_list, _git_path(path))}
- @router.get("/api/git/base-branches")
- async def git_base_branches_route(path: str):
- return {"branches": await _git_op(_web_git.base_branch_list, _git_path(path))}
- @router.get("/api/git/review/list")
- async def git_review_list_route(path: str, scope: str = "uncommitted", base: Optional[str] = None):
- return await _git_op(_web_git.review_list, _git_path(path), scope, base)
- @router.get("/api/git/review/diff")
- async def git_review_diff_route(
- path: str, file: str, request: Request,
- scope: str = "uncommitted", base: Optional[str] = None, staged: bool = False
- ):
- cwd = _git_path(path)
- target = _fs_path(file, cwd=cwd)
- _hosted_fs_read_guard(target, request)
- return {"diff": await _git_op(_web_git.review_diff, cwd, str(target), scope, base, staged)}
- @router.get("/api/git/file-diff")
- async def git_file_diff_route(path: str, file: str, request: Request):
- cwd = _git_path(path)
- target = _fs_path(file, cwd=cwd)
- _hosted_fs_read_guard(target, request)
- return {"diff": await _git_op(_web_git.file_diff_vs_head, cwd, str(target))}
- @router.get("/api/git/review/commit-context")
- async def git_commit_context_route(path: str, request: Request):
- cwd = _git_path(path)
- root = _hosted_fs_read_guard(Path(cwd), request)
- allowed = partial(_hosted_fs_path_allowed, root) if root is not None else None
- return await _git_op(_web_git.review_commit_context, cwd, allowed)
- @router.get("/api/git/review/rev-parse")
- async def git_rev_parse_route(path: str, ref: Optional[str] = None):
- return {"sha": await _git_op(_web_git.review_rev_parse, _git_path(path), ref)}
- @router.get("/api/git/review/ship-info")
- async def git_ship_info_route(path: str):
- return await _git_op(_web_git.review_ship_info, _git_path(path))
- @router.post("/api/git/review/pr-list")
- async def git_pr_list_route(body: GitPrListBody):
- return await _git_op(_web_git.review_pr_list, _git_path(body.path), body.branches, body.numbers)
- @router.post("/api/git/review/stage")
- async def git_stage_route(body: GitFileBody):
- return await _git_op(_web_git.review_stage, _git_path(body.path), body.file)
- @router.post("/api/git/review/unstage")
- async def git_unstage_route(body: GitFileBody):
- return await _git_op(_web_git.review_unstage, _git_path(body.path), body.file)
- @router.post("/api/git/review/revert")
- async def git_revert_route(body: GitFileBody):
- return await _git_op(_web_git.review_revert, _git_path(body.path), body.file)
- @router.post("/api/git/review/commit")
- async def git_commit_route(body: GitCommitBody):
- return await _git_op(_web_git.review_commit, _git_path(body.path), body.message, body.push)
- @router.post("/api/git/review/push")
- async def git_push_route(body: GitPathBody):
- return await _git_op(_web_git.review_push, _git_path(body.path))
- @router.post("/api/git/review/create-pr")
- async def git_create_pr_route(body: GitPathBody):
- return await _git_op(_web_git.review_create_pr, _git_path(body.path))
- @router.post("/api/git/worktree/add")
- async def git_worktree_add_route(body: GitWorktreeAddBody):
- options = {
- key: value
- for key, value in body.model_dump(include={"name", "branch", "base", "existingBranch"}).items()
- if value
- }
- return await _git_op(_web_git.worktree_add, _git_path(body.path), options)
- @router.post("/api/git/worktree/remove")
- async def git_worktree_remove_route(body: GitWorktreeRemoveBody):
- return await _git_op(
- _web_git.worktree_remove, _git_path(body.path), _git_path(body.worktreePath), body.force
- )
- @router.post("/api/git/branch/switch")
- async def git_branch_switch_route(body: GitBranchSwitchBody):
- return await _git_op(_web_git.branch_switch, _git_path(body.path), body.branch)
|