"""pnpm 실행 — 한 곳 (계획 2026-09-27 L6 §2.6 · D-L6-13 · 검토 F8). `run_pnpm` 은 훅이 pnpm 을 부르는 **유일한** 진입점이다. 두 가지를 여기서 고정한다: - **프로세스 그룹째 죽이기.** `subprocess.run(timeout=)` 은 직계 pnpm 만 죽여 `tsx` 손자가 hub 세션 advisory lock 을 쥔 채 남는다. 새 세션(`start_new_session=True`)으로 띄우고 한도를 넘기면 `os.killpg`(SIGTERM → 유예 뒤 SIGKILL) 한 뒤 `TimeoutExpired` 를 낸다 — 연결이 닫혀 서버가 잠금을 푼다. - **허용 목록(리뷰 지적 2).** argv 는 `hub_leg.build_hub_argv` 가 만드는 모양 그대로여야 한다 — 고정 머리 `pnpm --silent --fail-if-no-match --filter @poc/eval-store hub ingest` 뒤에 알려진 적재 옵션(`--case`·`--expect-run`· `--repo`·`--mirror`·`--index` 값 하나씩, 확인 플래그)만. 다른 패키지·`exec`·다른 hub 하위 명령(파괴 명령 포함)·레거시 적재 옵션·두 번째 `hub` 는 모두 `ValueError` 다. 훅은 적재 하나만 부른다(D-M2-4 (b) · 계획 §0.4-6). - **실행부는 비공개**(`_run_group`, 리뷰 지적 3·6) — 허용 목록 없이 argv 를 돌리므로 이 모듈 밖에서 부르지 않는다 (`test_scaffold.py` 가 소스로 막는다). 시험은 그룹 kill 확인에만 쓴다. 테스트 tripwire(D-L6-13): `SE/tests/conftest.py` 가 이 모듈의 `run_pnpm` 을 "호출되면 `pytest.fail`" 로 바꾼다. 그러니 호출자는 반드시 **모듈 속성으로** 부른다 — `from solar_eval.hub_hook import proc; proc.run_pnpm(...)`. 함수를 이름으로 import 하면 패치를 비켜 간다(`test_scaffold.py` 가 소스 텍스트로 막는다). """ from __future__ import annotations import os import signal import subprocess from collections.abc import Mapping, Sequence from pathlib import Path from solar_eval.hub_hook.optin import CONFIRM_FLAG from solar_eval.hub_hook.types import HUB_PACKAGE_FILTER PNPM = "pnpm" #: 훅이 부를 수 있는 유일한 명령 머리 — pnpm 전역 옵션 + 적재 하나(§2.6 argv). ALLOWED_ARGV_HEAD = ( PNPM, "--silent", "--fail-if-no-match", "--filter", HUB_PACKAGE_FILTER, "hub", "ingest", ) # fmt: skip #: 머리 뒤에 올 수 있는 값 옵션(값 하나씩 — 값은 `-` 로 시작하지 않는다). ALLOWED_VALUE_OPTIONS = frozenset({"--case", "--expect-run", "--repo", "--mirror", "--index"}) #: 머리 뒤에 올 수 있는 플래그. ALLOWED_FLAGS = frozenset({CONFIRM_FLAG}) #: SIGTERM 뒤 SIGKILL 까지 기다리는 초. KILL_GRACE_SECONDS = 5.0 def run_pnpm( argv: Sequence[str], *, cwd: Path, env: Mapping[str, str] | None = None, timeout: float, ) -> subprocess.CompletedProcess[str]: """허용 목록을 통과한 pnpm argv 를 새 세션으로 돌린다. 한도 초과는 그룹째 죽이고 `TimeoutExpired`. `FileNotFoundError`(pnpm 없음)는 그대로 낸다 — 호출자(hub 다리)가 `pnpm_missing` 으로 바꾼다. """ check_pnpm_argv(argv) return _run_group(argv, cwd=cwd, env=env, timeout=timeout) def check_pnpm_argv(argv: Sequence[str]) -> None: """고정 머리 + 알려진 적재 옵션만인 argv 가 아니면 `ValueError`(문구에 값을 싣지 않는다).""" args = list(argv) head = len(ALLOWED_ARGV_HEAD) if tuple(args[:head]) != ALLOWED_ARGV_HEAD: raise ValueError("run_pnpm: argv must start with the fixed eval-store 'hub ingest' head") rest = args[head:] index = 0 while index < len(rest): token = rest[index] if token in ALLOWED_FLAGS: index += 1 continue if token not in ALLOWED_VALUE_OPTIONS: raise ValueError(f"run_pnpm: argument #{head + index} is not an allowed ingest option") value = rest[index + 1] if index + 1 < len(rest) else None if not value or value.startswith("-"): raise ValueError(f"run_pnpm: option {token} needs a value") index += 2 def _run_group( argv: Sequence[str], *, cwd: Path, env: Mapping[str, str] | None = None, timeout: float, ) -> subprocess.CompletedProcess[str]: """argv 를 새 프로세스 그룹으로 돌리고 출력을 모은다(허용 목록 없음 — `run_pnpm` 의 실행부, 모듈 밖에서 부르지 않는다).""" process = subprocess.Popen( list(argv), cwd=str(cwd), env=None if env is None else dict(env), stdout=subprocess.PIPE, stderr=subprocess.PIPE, text=True, start_new_session=True, ) try: stdout, stderr = process.communicate(timeout=timeout) except subprocess.TimeoutExpired: stdout, stderr = _kill_group(process) raise subprocess.TimeoutExpired(list(argv), timeout, stdout, stderr) from None except BaseException: # KeyboardInterrupt 등 — 손자가 잠금을 쥔 채 남지 않게 그룹을 정리하고 그대로 올린다. _kill_group(process) raise return subprocess.CompletedProcess(list(argv), process.returncode, stdout, stderr) def _kill_group(process: subprocess.Popen[str]) -> tuple[str, str]: """SIGTERM → 유예 → SIGKILL. 남은 출력을 돌려준다.""" _signal_group(process, signal.SIGTERM) try: return process.communicate(timeout=KILL_GRACE_SECONDS) except subprocess.TimeoutExpired: _signal_group(process, signal.SIGKILL) return process.communicate() def _signal_group(process: subprocess.Popen[str], sig: signal.Signals) -> None: try: os.killpg(process.pid, sig) except ProcessLookupError: # 이미 끝난 그룹 — 보낼 곳이 없다. return