docs(impl): harden rework evidence cleanup

2026-10-02 05:05:54 +00:00
parent 01fb58ad08
commit b8a4add040
1 changed files with 3 additions and 2 deletions
@@ -1,7 +1,7 @@
 ---
 name: gitea-issue-rework
 description: Gitea PR 검토 지적을 계약에 맞춰 재작업하고 검증한다.
-version: 0.2.1
+version: 0.2.2
 author: genichin, Hermes Agent
 license: MIT
 platforms: [linux]
@@ -193,6 +193,7 @@ Reviewer가 rework head를 새 snapshot으로 다시 검토해야 하며 이 com

 1. Repository가 선언한 formatter, lint, type check, build, targeted, integration과 relevant full suite를 실행한다.
 2. Runtime·protocol·browser criterion은 가능한 가장 실제에 가까운 경로로 실행한다. 하위 수준 대체 evidence를 동등하다고 주장하지 않는다.
+   재작업 diff가 문서 파일에만 한정되고 기존 browser evidence가 결합된 source, test와 evidence path가 reviewed head부터 final head까지 byte-identical이며 ancestry를 검증한 경우에만 browser를 다시 실행하지 않고 기존 evidence를 재사용할 수 있다. 변경 경로가 겹치거나 동일성을 증명할 수 없으면 재사용하지 않는다.
 3. Base-to-worktree와 reviewed-head-to-worktree diff를 모두 읽고 모든 changed file을 finding matrix와 acceptance matrix에 대응한다.
 4. 범위 밖 refactor, debug artifact, generated drift, credential, 운영 데이터, test-only bypass와 예상하지 못한 삭제를 제거한다.
 5. Security-sensitive 변경은 `delegate_task`로 bounded reviewer에게 exact worktree, reviewed head, contract subset, finding matrix와 file allowlist를 제공해 독립 검토한다. Gitea write, Git cleanup, commit과 push는 금지한다.
@@ -230,7 +231,7 @@ Reviewer가 rework head를 새 snapshot으로 다시 검토해야 하며 이 com
 ### 8. 종료와 다음 review handoff

 1. 임시 server, browser context, fixture workspace와 credential helper를 정리하고 부재를 확인한다.
-2. 현재 실행이 획득한 lock만 역순으로 해제하고 repository lock과 Issue lock의 non-blocking 획득·해제를 확인한다.
+2. 현재 실행이 시작한 lock holder는 lock FD를 상속한 자식 process까지 함께 종료한다. Shell PID 종료만으로 해제를 판정하지 않으며, 현재 실행이 획득한 lock을 역순으로 해제한 뒤 repository lock과 Issue lock을 각각 non-blocking으로 실제 재획득·해제한 경우에만 cleanup 완료로 판정한다.
 3. Finding matrix, final diff, 검증 기록, remote head와 CI/status를 다시 대조한다.
 4. 모든 item이 `resolved`여도 reviewer의 새 head 검토 전에는 구현 승인 완료가 아니라 `재작업 전달 및 comment handoff 완료, 재검토 대기`로 보고한다.
 5. 후속 review가 새 head에 `REQUEST_CHANGES`를 남기면 그 review를 새 immutable snapshot으로 하는 별도 재작업 iteration을 시작한다. 이전 review snapshot이나 matrix를 새 head에 그대로 재사용하지 않는다.