pygittools 0.2.0__tar.gz → 0.2.2__tar.gz

{pygittools-0.2.0/pygittools.egg-info → pygittools-0.2.2}/PKG-INFO

@@ -1,12 +1,11 @@
 Metadata-Version: 2.4
 Name: pygittools
-Version: 0.2.0
+Version: 0.2.2
 Summary: Hooks and task storage in Git
 License-Expression: MIT
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: mcp>=1.28.0
 Requires-Dist: pygit2>=1.12.0
 Requires-Dist: uni-curses>=3.1.2
 Dynamic: license-file

{pygittools-0.2.0 → pygittools-0.2.2}/hook_samples/README.md

@@ -30,6 +30,24 @@ Environment variables:
 - `PYGITWEB_COMMIT_MSG_PATTERN` — message regex (default `^(\S+): (.+)`)
 - `PYGITWEB_REJECT_MERGE_COMMITS` — set to `1`/`true`/`yes` to reject merge commits
 
+## pre-receive.branch-permissions
+
+Enforce per-branch write permissions based on `auth.json` `oauth_permissions`. For each
+updated branch ref (`refs/heads/*`), the hook:
+
+- Builds a `project/branch` subject (e.g. `demo/main`, `demo/dev/alice.feature`).
+- If any `pgw.write_branch.{scope}` keys match that subject, requires a matching grant.
+- Otherwise, falls back to project write (`pgw.write.{project}`) for that project.
+
+When no usable configuration or context is available, the hook is a no-op and allows
+the push to proceed.
+
+Environment variables:
+
+- `PYGITWEB_PRINCIPAL` — principal identity string (email or username) to check grants for.
+- `PYGITWEB_PROJECT` — project path as known to pygitweb (e.g. `demo`, `team/app`).
+- `PYGITWEB_AUTH_CONFIG` — optional auth.json path (default: `~/.pygitweb/auth.json`).
+
 ## post-commit.push-remotes
 
 After each local commit, force-with-lease push the current branch to every configured

pygittools-0.2.2/hook_samples/pre-receive.branch-permissions

@@ -0,0 +1,69 @@
+#!/usr/bin/env -S uv run python
+
+from __future__ import annotations
+
+__VERSION__ = "1"
+
+import os
+import sys
+from pathlib import Path
+
+from pygittools.hooks import HookResult, RefUpdate, parse_ref_updates
+from pygitweb.auth_config import DEFAULT_AUTH_CONFIG_PATH, AuthConfig
+from pygitweb.permissions import PermissionsMap, has_branch_write_permission
+
+
+def _normalize_env(name: str) -> str | None:
+	value = os.environ.get(name)
+	if value is None:
+		return None
+	stripped = value.strip()
+	return stripped or None
+
+
+def _load_permissions() -> PermissionsMap | None:
+	config_path_env = _normalize_env("PYGITWEB_AUTH_CONFIG")
+	path = Path(config_path_env).expanduser() if config_path_env is not None else DEFAULT_AUTH_CONFIG_PATH
+	try:
+		text = path.read_text(encoding="utf-8")
+	except OSError:
+		return None
+	try:
+		config = AuthConfig.model_validate_json(text)
+	except Exception:
+		return None
+	return config.oauth_permissions
+
+
+def _check_updates(
+	principal: str,
+	project: str,
+	updates: list[RefUpdate],
+	permissions: PermissionsMap,
+) -> HookResult:
+	for _, _, ref_name in updates:
+		if has_branch_write_permission(permissions, principal, project, ref_name):
+			continue
+		sys.stderr.write(
+			f"Push rejected: {principal!r} lacks branch write permission for project {project!r} ref {ref_name!r}.\n",
+		)
+		return HookResult.FAILURE
+	return HookResult.SUCCESS
+
+
+def main() -> int:
+	principal = _normalize_env("PYGITWEB_PRINCIPAL")
+	project = _normalize_env("PYGITWEB_PROJECT")
+	if principal is None or project is None:
+		return int(HookResult.SUCCESS.value)
+	permissions = _load_permissions()
+	if permissions is None:
+		return int(HookResult.SUCCESS.value)
+	updates = parse_ref_updates(sys.stdin)
+	result = _check_updates(principal, project, updates, permissions)
+	return int(result.value)
+
+
+if __name__ == "__main__":
+	raise SystemExit(main())
+

{pygittools-0.2.0 → pygittools-0.2.2}/main.py

@@ -7,7 +7,8 @@ import sys
 from pathlib import Path
 
 import pygittools
-from pygittools.tags_sync import format_sync_result, sync_board_tags
+from pygittools.tags_sync import delete_task_remote, format_sync_result, sync_board_tags
+from pygittools.tasks import TASK_REF_PREFIX, delete_task_local
 from pygittools.tasks_query import open_repository, resolve_repo_location
 from pygittools.tui import run_tui
 
@@ -42,6 +43,16 @@ def build_parser() -> argparse.ArgumentParser:
 		default="Tasks",
 		help="Board name under refs/tags/boards/ (default: Tasks)",
 	)
+	delete_parser = tags_subparsers.add_parser("delete-task", help="Delete a task tag locally and on a remote")
+	delete_parser.add_argument(
+		"task",
+		help="Task ref or ID (for example refs/tags/tasks/alpha or alpha)",
+	)
+	delete_parser.add_argument(
+		"--remote",
+		default="origin",
+		help="Remote name to delete from (for example origin)",
+	)
 	return parser
 
 
@@ -57,6 +68,27 @@ def _run_tags_sync(repo_path: Path | None, remote: str, board: str) -> int:
 	return 0
 
 
+def _normalize_task_ref(task: str) -> str:
+	if task.startswith("refs/"):
+		return task
+	return f"{TASK_REF_PREFIX}{task}"
+
+
+def _run_task_delete(repo_path: Path | None, remote: str | None, task: str) -> int:
+	location = resolve_repo_location(repo_path=repo_path)
+	repo = open_repository(location)
+	task_ref = _normalize_task_ref(task)
+	delete_task_local(repo, task_ref)
+	if not remote:
+		return 0
+	try:
+		delete_task_remote(repo, remote, task_ref)
+	except (KeyError, RuntimeError, ValueError) as exc:
+		print(exc, file=sys.stderr)
+		return 1
+	return 0
+
+
 def main(argv: list[str] | None = None) -> int:
 	args_list = sys.argv[1:] if argv is None else argv
 	if not args_list:
@@ -67,6 +99,8 @@ def main(argv: list[str] | None = None) -> int:
 
 	if args.command == "tags" and args.tags_command == "sync":
 		return _run_tags_sync(args.repo, args.remote, args.board)
+	if args.command == "tags" and args.tags_command == "delete-task":
+		return _run_task_delete(args.repo, args.remote, args.task)
 
 	return run_tui(args.repo)
 

pygittools-0.2.2/mcp_server.py

@@ -0,0 +1,8 @@
+"""Compatibility shim for the MCP server.
+
+Use the dedicated ``pygittools-mcp`` package for the actual implementation.
+"""
+
+from __future__ import annotations
+
+from pygittools_mcp.mcp_server import *  # noqa: F401,F403

{pygittools-0.2.0 → pygittools-0.2.2/pygittools.egg-info}/PKG-INFO

@@ -1,12 +1,11 @@
 Metadata-Version: 2.4
 Name: pygittools
-Version: 0.2.0
+Version: 0.2.2
 Summary: Hooks and task storage in Git
 License-Expression: MIT
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: mcp>=1.28.0
 Requires-Dist: pygit2>=1.12.0
 Requires-Dist: uni-curses>=3.1.2
 Dynamic: license-file

{pygittools-0.2.0 → pygittools-0.2.2}/pygittools.egg-info/SOURCES.txt

@@ -47,38 +47,59 @@ tasks_test.py
 ./hook_samples/post-commit.push-remotes
 ./hook_samples/post-receive.notify
 ./hook_samples/pre-commit.ruff
+./hook_samples/pre-receive.branch-permissions
 ./hook_samples/pre-receive.protected-pattern
 ./tui/__init__.py
 ./tui/app.py
+./tui/app_test.py
 ./tui/branches.py
+./tui/branches_test.py
 ./tui/changes_list.py
+./tui/changes_list_test.py
+./tui/colors.json
 ./tui/commit_draft.py
 ./tui/commit_draft_test.py
+./tui/conftest.py
+./tui/coverage_gaps_test.py
 ./tui/draw.py
+./tui/draw_test.py
+./tui/git_colors.py
+./tui/git_colors_test.py
 ./tui/input_context.py
+./tui/input_context_test.py
 ./tui/log_list.py
 ./tui/log_list_test.py
+./tui/pages_test.py
 ./tui/project_label.py
 ./tui/projects.py
+./tui/projects_test.py
 ./tui/pygitweb_layout.py
+./tui/pygitweb_layout_test.py
 ./tui/repo.py
+./tui/repo_test.py
 ./tui/status_bar.py
+./tui/status_bar_test.py
 ./tui/tabs.py
 ./tui/tabs_test.py
+./tui/tasks_list.py
 ./tui/types.py
+./tui/ucurses.py
 ./tui/worktree.py
+./tui/worktree_test.py
 ./tui/pages/__init__.py
 ./tui/pages/branches.py
 ./tui/pages/help.py
 ./tui/pages/home.py
 ./tui/pages/no_repo.py
 ./tui/pages/projects.py
+./tui/pages/task_editor.py
 hook_samples/README.md
 hook_samples/commit-msg.pattern
 hook_samples/post-commit.notify
 hook_samples/post-commit.push-remotes
 hook_samples/post-receive.notify
 hook_samples/pre-commit.ruff
+hook_samples/pre-receive.branch-permissions
 hook_samples/pre-receive.protected-pattern
 pygittools.egg-info/PKG-INFO
 pygittools.egg-info/SOURCES.txt
@@ -88,26 +109,45 @@ pygittools.egg-info/requires.txt
 pygittools.egg-info/top_level.txt
 tui/__init__.py
 tui/app.py
+tui/app_test.py
 tui/branches.py
+tui/branches_test.py
 tui/changes_list.py
+tui/changes_list_test.py
+tui/colors.json
 tui/commit_draft.py
 tui/commit_draft_test.py
+tui/conftest.py
+tui/coverage_gaps_test.py
 tui/draw.py
+tui/draw_test.py
+tui/git_colors.py
+tui/git_colors_test.py
 tui/input_context.py
+tui/input_context_test.py
 tui/log_list.py
 tui/log_list_test.py
+tui/pages_test.py
 tui/project_label.py
 tui/projects.py
+tui/projects_test.py
 tui/pygitweb_layout.py
+tui/pygitweb_layout_test.py
 tui/repo.py
+tui/repo_test.py
 tui/status_bar.py
+tui/status_bar_test.py
 tui/tabs.py
 tui/tabs_test.py
+tui/tasks_list.py
 tui/types.py
+tui/ucurses.py
 tui/worktree.py
+tui/worktree_test.py
 tui/pages/__init__.py
 tui/pages/branches.py
 tui/pages/help.py
 tui/pages/home.py
 tui/pages/no_repo.py
-tui/pages/projects.py
+tui/pages/projects.py
+tui/pages/task_editor.py

{pygittools-0.2.0 → pygittools-0.2.2}/pygittools.egg-info/entry_points.txt

@@ -1,3 +1,2 @@
 [console_scripts]
 pgt = pygittools.main:main
-pygittools-mcp = pygittools.mcp_server:main

{pygittools-0.2.0 → pygittools-0.2.2}/pygittools.egg-info/requires.txt

@@ -1,3 +1,2 @@
-mcp>=1.28.0
 pygit2>=1.12.0
 uni-curses>=3.1.2

{pygittools-0.2.0 → pygittools-0.2.2}/pyproject.toml

@@ -4,21 +4,19 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "pygittools"
-version = "0.2.0"
+version = "0.2.2"
 description = "Hooks and task storage in Git"
 readme = "README.md"
 license = "MIT"
 license-files = ["LICENSE"]
 requires-python = ">=3.11"
 dependencies = [
-    "mcp>=1.28.0",
     "pygit2>=1.12.0",
     "uni-curses>=3.1.2",
 ]
 
 [project.scripts]
 pgt = "pygittools.main:main"
-pygittools-mcp = "pygittools.mcp_server:main"
 
 [tool.setuptools]
 packages = ["pygittools", "pygittools.tui", "pygittools.tui.pages"]
@@ -27,4 +25,4 @@ packages = ["pygittools", "pygittools.tui", "pygittools.tui.pages"]
 pygittools = "."
 
 [tool.setuptools.package-data]
-pygittools = ["hook_samples/**/*", "help.md"]
+pygittools = ["hook_samples/**/*", "help.md", "tui/colors.json"]

{pygittools-0.2.0 → pygittools-0.2.2}/tags_sync.py

@@ -325,6 +325,35 @@ def push_board_tags(
 	return tuple(pushed), True
 
 
+def delete_task_remote(
+	repo: Repository,
+	remote_name: str,
+	task_ref: str,
+	*,
+	git: str | None = None,
+) -> None:
+	if remote_name not in repo.remotes.names():
+		raise ValueError(f"remote {remote_name!r} not configured")
+
+	task_name = task_ref
+	if not task_name.startswith("refs/") and not task_name.startswith(TASK_REF_PREFIX):
+		task_name = f"{TASK_REF_PREFIX}{task_name}"
+
+	refspecs: list[str] = [f":{task_name}"]
+	task = get_task(repo, task_name)
+	if task is not None:
+		for oid_hex in getattr(task, "comments", []) or []:
+			try:
+				oid = Oid(hex=oid_hex) if isinstance(oid_hex, str) else oid_hex
+				comment = get_comment(repo, oid)
+			except (ValueError, KeyError, TypeError):
+				continue
+			refspecs.append(f":{comment.name}")
+
+	proc = _run_git(repo, "push", remote_name, *refspecs, git=git)
+	_require_git_ok(proc, f"delete {task_name}")
+
+
 def sync_board_tags(
 	repo: Repository,
 	remote_name: str,

{pygittools-0.2.0 → pygittools-0.2.2}/tasks.py

@@ -108,6 +108,7 @@ class Task:
 		priority: Priority | None = None,
 		assignee: str | None = None,
 		due_date: datetime | None = None,
+		tags: str = "",
 	):
 		if name is None:
 			name = f"{TASK_REF_PREFIX}{title.lower().replace(' ', '_')}"
@@ -124,6 +125,7 @@ class Task:
 		self.priority = priority
 		self.assignee = assignee
 		self.due_date = due_date
+		self.tags = tags
 		self.created_at = datetime.now()
 		self.comments: list[Oid | str] = []  # Comment OIDs
 		self.update_message()
@@ -180,6 +182,7 @@ def get_task(repo: Repository, ref: str) -> Task | None:
 		priority=priority,
 		assignee=j.get("assignee"),
 		due_date=_parse_dt(j.get("due_date")),
+		tags=j.get("tags", "") or "",
 	)
 	t.comments = j.get("comments", [])
 	t.created_at = _parse_dt(j.get("created_at")) or t.created_at
@@ -205,6 +208,7 @@ def get_task_by_oid(repo: Repository, oid: Oid) -> Task | None:
 		priority=priority,
 		assignee=j.get("assignee"),
 		due_date=_parse_dt(j.get("due_date")),
+		tags=j.get("tags", "") or "",
 	)
 	t.comments = j.get("comments", [])
 	t.created_at = _parse_dt(j.get("created_at")) or t.created_at
@@ -331,3 +335,53 @@ def get_board(repo: Repository, ref: str) -> Board | None:
 	b.created_at = _parse_dt(j.get("created_at")) or b.created_at
 	b.updated_at = _parse_dt(j.get("updated_at")) or b.updated_at
 	return b
+
+
+def delete_task_local(repo: Repository, task_ref: str) -> None:
+	try:
+		tag_obj = repo.revparse_single(task_ref)
+	except (KeyError, ValueError):
+		return
+	if not isinstance(tag_obj, Tag):
+		return
+	task = get_task(repo, task_ref)
+	task_name = tag_obj.name
+
+	for ref_name in list(repo.references):
+		if not ref_name.startswith(BOARD_REF_PREFIX):
+			continue
+		board = get_board(repo, ref_name)
+		if board is None:
+			continue
+		original = list(getattr(board, "tasks", []) or [])
+		filtered: list[Oid | str] = []
+		removed: list[str] = []
+		for entry in original:
+			try:
+				oid = Oid(hex=entry) if isinstance(entry, str) else entry
+				board_task = get_task_by_oid(repo, oid)
+			except (ValueError, KeyError, TypeError):
+				filtered.append(entry)
+				continue
+			if board_task is None or board_task.name != task_name:
+				filtered.append(entry)
+			else:
+				removed.append(str(oid))
+		if not removed:
+			continue
+		board.tasks = filtered
+		board.update_message()
+		board.write(repo)
+
+	if task is not None:
+		for oid_hex in getattr(task, "comments", []) or []:
+			try:
+				oid = Oid(hex=oid_hex) if isinstance(oid_hex, str) else oid_hex
+				comment = get_comment(repo, oid)
+			except (ValueError, KeyError, TypeError):
+				continue
+			if comment.name in repo.references:
+				repo.references.delete(comment.name)
+
+	if task_ref in repo.references:
+		repo.references.delete(task_ref)

{pygittools-0.2.0 → pygittools-0.2.2}/tasks_test.py

@@ -11,6 +11,7 @@ from pygittools.tasks import (
 	Board,
 	Comment,
 	Task,
+	delete_task_local,
 	get_board,
 	get_comment,
 	get_task,
@@ -201,3 +202,39 @@ def test_full_board_flow_survives_git_gc(repo: Repository, tmp_path: Path) -> No
 
 	contents = [get_comment(reopened, Oid(hex=str(c))).content for c in loaded_task.comments]
 	assert contents == ["first", "second"]
+
+
+def test_delete_task_local_removes_board_and_comment_refs(repo: Repository) -> None:
+	board = Board(_empty_tree(), BOARD_MAIN, TAGGER, description="Main")
+
+	task = Task(
+		_empty_tree(),
+		_task_ref("to-delete"),
+		TAGGER,
+		title="To Delete",
+		description="remove me",
+		status=Task.Status.TODO,
+	)
+	task_oid = task.write(repo)
+
+	comment = Comment(task_oid, "bob <bob@example.com>", content="bye")
+	comment_oid = comment.write(repo)
+
+	task.comments = [str(comment_oid)]
+	task.update_message()
+	task_oid = task.write(repo)
+
+	board.tasks = [str(task_oid)]
+	board.update_message()
+	board.write(repo)
+
+	comment_ref = get_comment(repo, comment_oid).name
+
+	delete_task_local(repo, _task_ref("to-delete"))
+
+	assert _task_ref("to-delete") not in repo.references
+	assert comment_ref not in repo.references
+
+	loaded_board = get_board(repo, BOARD_MAIN)
+	assert loaded_board is not None
+	assert loaded_board.tasks == []

{pygittools-0.2.0 → pygittools-0.2.2}/tui/app.py

@@ -4,7 +4,14 @@ from __future__ import annotations
 
 from pathlib import Path
 
-from unicurses import (  # type: ignore[import-untyped]
+from pygittools.tui.git_colors import init_tui_color_theme, status_bar_attr
+from pygittools.tui.pages.home import HomePage, home_page
+from pygittools.tui.pages.no_repo import NoRepoPage
+from pygittools.tui.repo import try_open_page_context
+from pygittools.tui.status_bar import content_height, draw_status_bar
+from pygittools.tui.tabs import init_tab_colors
+from pygittools.tui.types import Page, PageAction, PageContext, PageResult
+from pygittools.tui.ucurses import (  # type: ignore[import-untyped]
 	KEY_RESIZE,
 	cbreak,
 	clear,
@@ -18,13 +25,6 @@ from unicurses import (  # type: ignore[import-untyped]
 	refresh,
 )
 
-from pygittools.tui.pages.home import HomePage, home_page
-from pygittools.tui.pages.no_repo import NoRepoPage
-from pygittools.tui.repo import try_open_page_context
-from pygittools.tui.status_bar import content_height, draw_status_bar, init_status_bar
-from pygittools.tui.tabs import init_tab_colors
-from pygittools.tui.types import Page, PageAction, PageContext, PageResult
-
 
 def run_tui(repo_path: Path | None = None) -> int:
 	start = (repo_path or Path.cwd()).resolve()
@@ -38,7 +38,7 @@ def run_tui(repo_path: Path | None = None) -> int:
 		cbreak()
 		curs_set(0)
 		keypad(stdscr, True)
-		status_attr = init_status_bar()
+		init_tui_color_theme(ctx.repo if ctx is not None else None)
 		init_tab_colors()
 
 		if ctx is not None:
@@ -50,7 +50,7 @@ def run_tui(repo_path: Path | None = None) -> int:
 			clear()
 			page.draw(stdscr, content_height(height), width)
 			if height > 0:
-				draw_status_bar(height - 1, width, page.status_text(), status_attr)
+				draw_status_bar(height - 1, width, page.status_text(), status_bar_attr())
 			refresh()
 
 			try:
@@ -92,6 +92,8 @@ def _apply_result(
 		new_ctx = try_open_page_context(result.switch_repo)
 		if new_ctx is not None:
 			ctx = new_ctx
+			init_tui_color_theme(ctx.repo)
+			init_tab_colors()
 
 	match result.action:
 		case PageAction.REPLACE:

pygittools-0.2.2/tui/app_test.py

@@ -0,0 +1,119 @@
+from __future__ import annotations
+
+from pathlib import Path
+from unittest.mock import MagicMock, patch
+
+from pygit2 import Repository, init_repository
+
+from pygittools.tui.app import _apply_result, _persist_commit_draft, run_tui
+from pygittools.tui.pages.home import home_page
+from pygittools.tui.pages.no_repo import NoRepoPage
+from pygittools.tui.types import PageAction, PageContext, PageResult
+
+
+def test_persist_commit_draft_skips_without_context() -> None:
+	_persist_commit_draft([], None)
+
+
+def test_persist_commit_draft_from_home_page(page_ctx: PageContext) -> None:
+	page = home_page()
+	page.on_enter(page_ctx)
+	page.changes.set_commit_message("draft")
+	_persist_commit_draft([page], page_ctx)
+	from pygittools.tui.commit_draft import load_commit_draft
+
+	assert load_commit_draft(page_ctx.repo_path, page_ctx.repo) == "draft"
+
+
+def test_apply_result_replace(page_ctx: PageContext) -> None:
+	next_page = home_page()
+	stack = [NoRepoPage(Path("/tmp"))]
+	ctx, new_stack = _apply_result(
+		stack,
+		page_ctx,
+		PageResult(action=PageAction.REPLACE, next_page=next_page),
+	)
+	assert ctx is page_ctx
+	assert new_stack == [next_page]
+
+
+def test_apply_result_replace_without_page(page_ctx: PageContext) -> None:
+	stack = [home_page()]
+	ctx, new_stack = _apply_result(stack, page_ctx, PageResult(action=PageAction.REPLACE))
+	assert new_stack is stack
+
+
+def test_apply_result_push_and_pop(page_ctx: PageContext) -> None:
+	home = home_page()
+	home.on_enter(page_ctx)
+	stack = [home]
+	overlay = NoRepoPage(Path("/tmp"))
+	ctx, stack = _apply_result(stack, page_ctx, PageResult(action=PageAction.PUSH, next_page=overlay))
+	assert len(stack) == 2
+	ctx, stack = _apply_result(stack, page_ctx, PageResult(action=PageAction.POP))
+	assert len(stack) == 1
+
+
+def test_apply_result_pop_keeps_root(page_ctx: PageContext) -> None:
+	home = home_page()
+	ctx, stack = _apply_result([home], page_ctx, PageResult(action=PageAction.POP))
+	assert stack == [home]
+
+
+def test_apply_result_switch_repo(page_ctx: PageContext, tmp_path: Path) -> None:
+	repo_dir = tmp_path / "other"
+	repo_dir.mkdir()
+	init_repository(str(repo_dir), bare=False)
+	home = home_page()
+	home.on_enter(page_ctx)
+	ctx, stack = _apply_result(
+		[home],
+		page_ctx,
+		PageResult(action=PageAction.PUSH, switch_repo=repo_dir),
+	)
+	assert ctx is not None
+	assert stack[-1] is home
+
+
+def test_apply_result_switch_repo_reenters_page(page_ctx: PageContext, tmp_path: Path) -> None:
+	repo_dir = tmp_path / "other"
+	repo_dir.mkdir()
+	init_repository(str(repo_dir), bare=False)
+	home = home_page()
+	home.on_enter(page_ctx)
+	ctx, stack = _apply_result(
+		[home],
+		page_ctx,
+		PageResult(action=PageAction.NONE, switch_repo=repo_dir),
+	)
+	assert ctx is not None
+	assert stack[-1] is home
+
+
+def _run_tui_once(repo_dir: Path, keys: list[int]) -> int:
+	with patch("pygittools.tui.app.initscr") as initscr:
+		initscr.return_value = MagicMock()
+		with (
+			patch("pygittools.tui.app.getmaxyx", return_value=(24, 80)),
+			patch("pygittools.tui.app.getch", side_effect=keys),
+			patch("pygittools.tui.app.noecho"),
+			patch("pygittools.tui.app.cbreak"),
+			patch("pygittools.tui.app.curs_set"),
+			patch("pygittools.tui.app.keypad"),
+			patch("pygittools.tui.app.clear"),
+			patch("pygittools.tui.app.refresh"),
+			patch("pygittools.tui.app.endwin"),
+			patch("pygittools.tui.app.init_tui_color_theme"),
+			patch("pygittools.tui.app.init_tab_colors"),
+			patch("pygittools.tui.app.draw_status_bar"),
+			patch("pygittools.tui.app.status_bar_attr", return_value=0),
+		):
+			return run_tui(repo_dir)
+
+
+def test_run_tui_quits_on_q(committed_repo: Repository) -> None:
+	assert _run_tui_once(Path(committed_repo.workdir), [ord("q")]) == 0
+
+
+def test_run_tui_no_repo(tmp_path: Path) -> None:
+	assert _run_tui_once(tmp_path, [ord("q")]) == 0