relay-knowledge 1.0.1

Graph-database-based knowledge graph project.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40

"""Git/worktree boundary helpers for self-iteration."""

from __future__ import annotations

import subprocess
from pathlib import Path


class NonRetryableIterationError(RuntimeError):
    """Failure that cannot be fixed by starting another iteration."""


def current_head(workspace: Path) -> str:
    return git(workspace, ["rev-parse", "HEAD"], check=True).stdout.strip()


def ensure_clean_worktree(workspace: Path) -> None:
    status = git(workspace, ["status", "--short"], check=True).stdout.strip()
    if status:
        raise NonRetryableIterationError(
            "working tree is not clean; commit/stash changes or pass --use-current-candidate"
        )


def git(workspace: Path, args: list[str], check: bool) -> subprocess.CompletedProcess[str]:
    completed = subprocess.run(
        ["git", *args],
        cwd=workspace,
        text=True,
        capture_output=True,
        check=False,
    )
    if check and completed.returncode != 0:
        raise RuntimeError(completed.stderr.strip() or completed.stdout.strip())
    return completed


def git_lines(workspace: Path, args: list[str]) -> list[str]:
    output = git(workspace, args, check=True).stdout
    return [line for line in output.splitlines() if line]