From b6e17bc80ca15fbd1ae854ebe0fa9112a44184b2 Mon Sep 17 00:00:00 2001 From: onetwothr1 Date: Mon, 3 Aug 2026 22:06:36 +0900 Subject: [PATCH 1/2] =?UTF-8?q?docs:=20=EB=B2=A4=EB=8D=94=EB=A7=81=20?= =?UTF-8?q?=EC=A0=88=EC=B0=A8=20=E2=80=94=20=EC=97=94=EC=A7=84=20SHA?= =?UTF-8?q?=EB=A5=BC=207=EC=9E=90=EB=A6=AC=EB=A1=9C?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 전체 40자를 적을 필요가 없다. 추적에 필요한 것은 "어느 커밋을 복사했나"이고 이 저장소 규모에서 7자리면 충분히 유일하다 (충돌하면 git이 더 긴 약칭을 요구하므로 그때 늘리면 된다). 2단계의 rev-parse HEAD도 --short로 바꾼다. 엔진 repo 쪽 축약본(PLAYBOOKS.md §PB-5)도 같은 값으로 맞춘다 — 이번 v2.26.1 벤더링에서 그 축약본에 VENDORED_ENGINE_VERSION 갱신 · npm test · SHA 명시 세 단계가 빠져 있어 CI가 버전 핀 불일치를 잡았다. Co-Authored-By: Claude Opus 5 --- docs/fig-extract-integration.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/docs/fig-extract-integration.md b/docs/fig-extract-integration.md index 7c15310..8444537 100644 --- a/docs/fig-extract-integration.md +++ b/docs/fig-extract-integration.md @@ -227,7 +227,7 @@ const entries = seeds.map((seed) => 1. 엔진 전용 별도 repo에서 새 버전 검증 완료 후 (엔진 repo `docs/DEV.md` §버전 릴리스 절차) 2. **복사 전에 엔진 repo가 clean한지 확인** — `git -C <엔진repo> status --porcelain`이 비어 있어야 하고, - `git -C <엔진repo> rev-parse HEAD`로 SHA를 적어 둔다. + `git -C <엔진repo> rev-parse --short HEAD`로 **7자리 SHA**를 적어 둔다. 더티한 작업 트리를 복사하면 **어느 커밋에도 존재하지 않는 엔진이 벤더링되는데 두 파일 diff는 0건이라 아무 검사에도 안 걸린다** — 나중에 그 코드를 되짚을 방법이 없어진다. 3. `fig-extract.js`를 `src/core/`에 **그대로 복사** — v2.3.0부터 엔진 파일에 globalThis 노출이 포함되어 @@ -246,6 +246,8 @@ const entries = seeds.map((seed) => 7. `npm run typecheck && npm test && npm run build` 확인 후 그림·표 탭에서 샘플 PDF 1개 스모크 테스트 8. 커밋 메시지에 엔진 버전과 **2에서 적어 둔 엔진 SHA**를 명시 (예: `chore: bump fig-extract to v2.19.4` + 본문에 - `engine: onetwothr1/PDFViewer-Figure-Extract@<복사 시점 HEAD SHA>`). + `engine: onetwothr1/PDFViewer-Figure-Extract@1783140`). 엔진 repo는 알고리즘과 무관한 커밋(truth·docs)으로도 전진하므로 **버전 문자열만으로는 어느 커밋을 복사했는지 특정되지 않는다** — 같은 v2.19.4가 여러 SHA에 걸쳐 있다. + **7자리로 적는다** — 추적에 필요한 것은 "어느 커밋을 복사했나"이고 이 저장소 규모에서 + 7자리면 충분히 유일하다. 충돌하면 git이 더 긴 약칭을 요구하므로 그때 늘리면 된다. From 78bc403e222bfaea08c3047be74cb3fbf548bb4f Mon Sep 17 00:00:00 2001 From: Jinhyeong Kim <83393021+onetwothr1@users.noreply.github.com> Date: Mon, 3 Aug 2026 22:28:24 +0900 Subject: [PATCH 2/2] Update docs/fig-extract-integration.md Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com> --- docs/fig-extract-integration.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/fig-extract-integration.md b/docs/fig-extract-integration.md index 8444537..97be065 100644 --- a/docs/fig-extract-integration.md +++ b/docs/fig-extract-integration.md @@ -227,7 +227,7 @@ const entries = seeds.map((seed) => 1. 엔진 전용 별도 repo에서 새 버전 검증 완료 후 (엔진 repo `docs/DEV.md` §버전 릴리스 절차) 2. **복사 전에 엔진 repo가 clean한지 확인** — `git -C <엔진repo> status --porcelain`이 비어 있어야 하고, - `git -C <엔진repo> rev-parse --short HEAD`로 **7자리 SHA**를 적어 둔다. + `git -C <엔진repo> rev-parse --short=7 HEAD`로 **7자리 SHA**를 적어 둔다. 더티한 작업 트리를 복사하면 **어느 커밋에도 존재하지 않는 엔진이 벤더링되는데 두 파일 diff는 0건이라 아무 검사에도 안 걸린다** — 나중에 그 코드를 되짚을 방법이 없어진다. 3. `fig-extract.js`를 `src/core/`에 **그대로 복사** — v2.3.0부터 엔진 파일에 globalThis 노출이 포함되어