| 1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071 |
- """Forensic hints attached to an abandoned-delegation recovery event.
- When the owner process dies (OOM-kill, crash) before a background child records a
- terminal result, the recovery event used to carry only "outcome unknown" plus the
- transcript paths — the parent then had to open files to find out where the child
- got to. These helpers put the last lines of each live transcript and a one-line git
- snapshot of the owner's working directory INTO the event so the parent can decide
- whether to continue or re-dispatch without forensics. Everything here is best-effort
- and bounded: a missing file, a non-git cwd or a slow git never fails recovery.
- """
- from __future__ import annotations
- import os
- import subprocess
- from typing import Dict, Optional
- from hermes_cli._subprocess_compat import harden_git_argv, noninteractive_repo_git_env
- TAIL_LINES = 20
- TAIL_CHARS = 2_000
- _GIT_TIMEOUT_S = 5
- def transcript_tail(path: str, *, lines: int = TAIL_LINES, chars: int = TAIL_CHARS) -> Optional[str]:
- """Last ``lines`` lines (at most ``chars`` characters) of a live transcript; None when unreadable."""
- try:
- with open(path, "rb") as fh:
- fh.seek(0, os.SEEK_END)
- size = fh.tell()
- fh.seek(max(0, size - chars * 4)) # a few bytes per char of headroom; bounded read
- raw = fh.read().decode("utf-8", errors="replace")
- except OSError:
- return None
- tail = "\n".join(raw.splitlines()[-lines:]).strip()
- if len(tail) > chars:
- tail = "…" + tail[-chars:]
- return tail or None
- def transcript_tails(paths: dict[str, str]) -> dict[str, str]:
- return {index: tail for index, path in (paths or {}).items() if (tail := transcript_tail(path))}
- def git_state_hint(cwd: Optional[str]) -> Optional[str]:
- """``branch @ sha (N uncommitted file(s))`` for the owner's cwd; None when not a git checkout."""
- if not cwd or not os.path.isdir(cwd):
- return None
- # noninteractive_repo_git_env (GHSA-7x36-8jrh-v4pw): runs unattended in the owner's repo and
- # ``status`` refreshes the index, which executes a repo-configured ``core.fsmonitor`` and clean filters.
- env = noninteractive_repo_git_env(cwd)
- if env is None:
- return None
- def run(*args: str) -> Optional[str]:
- try:
- out = subprocess.run(["git", "-C", cwd, *harden_git_argv(args)], capture_output=True,
- text=True, encoding="utf-8", errors="replace",
- stdin=subprocess.DEVNULL, timeout=_GIT_TIMEOUT_S, env=env, check=False)
- except (OSError, subprocess.SubprocessError):
- return None
- return out.stdout if out.returncode == 0 else None
- head = run("log", "-1", "--format=%h %s")
- if head is None:
- return None
- branch = (run("rev-parse", "--abbrev-ref", "HEAD") or "?").strip()
- status = run("status", "--porcelain")
- dirty = len(status.splitlines()) if status is not None else "?"
- return f"{branch} @ {head.strip()} ({dirty} uncommitted file(s)) in {cwd}"
|