/ 2분 / AGENTS · TOOLING · PYTHON

남의 설정을 안 지우고 내 규칙만 갈아끼우기

에이전트 규칙을 여러 대상에 배포할 때, 파일 전체를 덮으면 개인 설정이 죽는다. 마커 사이만 바꾸면 된다.

멱등 재실행 재작성 0건 · 테스트 6/6

에이전트 규칙을 한 곳에서 관리하고 여러 대상에 뿌리려는 순간 문제가 생긴다. 대상 파일에는 이미 그 자리의 개인 설정이 들어 있다. 배포한다고 파일을 통째로 덮으면 그게 날아간다.

해법은 오래된 것이다. 파일 전체를 소유하지 말고, 마커 사이만 소유한다.

# 내가 직접 쓴 규칙 — 배포가 안 건드림

<!-- managed:core-rules:begin -->
... 여기만 교체된다 ...
<!-- managed:core-rules:end -->

# 이것도 안 건드림

세 가지만 지키면 된다

첫째, 멱등. 두 번 돌려도 같아야 한다. 소스와 블록 내용이 같으면 파일을 아예 안 쓴다. “이미 최신”이라고만 말한다. 이게 없으면 배포 스크립트를 돌릴 때마다 파일 mtime이 바뀌고, git이 매번 변경으로 잡고, 결국 사람이 스크립트를 안 돌리게 된다.

둘째, 마커가 깨졌으면 멈춘다. begin이 두 개거나, end가 없거나, end가 begin보다 앞에 있으면 — 추측해서 고치지 않는다. 종료 코드를 따로 주고 사람에게 넘긴다.

여기서 추측하면 최악이다. begin이 두 개일 때 “첫 번째부터 마지막 end까지”로 잡으면 그 사이의 개인 설정을 통째로 먹는다. 정확히 이 도구가 막으려던 사고다.

if len(begins) != 1 or len(ends) != 1:
    print(f"ABORT: malformed markers — "
          f"begin={len(begins)}, end={len(ends)}. Fix manually.",
          file=sys.stderr)
    sys.exit(2)

셋째, 제거도 같은 규칙으로. 블록을 걷어낼 때 파일을 지우지 않는다. 블록만 빼고 나머지는 그대로 둔다.

실제로 겪은 것

윈도우에서 한 번 넘어졌다. 출력 문자열에 em dash(—)를 썼는데 콘솔 코드페이지가 CP949라 이렇게 터졌다.

UnicodeEncodeError: 'cp949' codec can't encode character
'—' in position 158: illegal multibyte sequence

파일 입출력은 전부 encoding="utf-8"로 명시해뒀는데, stdout은 빠뜨렸다. 파일만 챙기고 콘솔을 안 챙긴 것이다.

sys.stdout.reconfigure(encoding="utf-8", errors="replace")
sys.stderr.reconfigure(encoding="utf-8", errors="replace")

웃긴 건 이게 “성공했습니다” 메시지를 찍다가 죽었다는 점이다. 실제 배포는 이미 끝난 뒤였다. 성공 경로가 실패 경로보다 늦게 발견되는 종류의 버그다.

검증

시나리오 여섯 개로 확인했다.

시나리오기대결과
블록 없는 파일에 신규 삽입끝에 추가, 기존 내용 보존PASS
같은 소스로 재실행파일 미변경PASS
소스 변경 후 배포블록만 교체PASS
드리프트 검사다르면 exit 1PASS
제거블록만 삭제, 나머지 보존PASS
begin 2개 · end 1개exit 2, 파일 미변경PASS

마지막 줄이 제일 중요하다. 실패해야 할 때 제대로 실패하는지를 안 재보면, 나머지 다섯 개가 통과해도 이 도구는 신뢰할 수 없다.

안 한 것

블록을 여러 개 두는 건 지원하되, 블록끼리 겹치는 경우는 검사하지 않는다. managed:a:begin 안에 managed:b:begin을 넣는 상황은 만들 이유가 없어서 막지도 허용하지도 않고 그냥 놔뒀다. 필요해지면 그때 붙인다.