Skip to content

docs: 벤더링 절차 — 엔진 SHA를 7자리로 #41

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
onetwothr1 merged 2 commits into from
Aug 3, 2026
Merged

docs: 벤더링 절차 — 엔진 SHA를 7자리로 #41

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
b6e17bc
docs: 벤더링 절차 — 엔진 SHA를 7자리로
onetwothr1 Aug 3, 2026
78bc403
Update docs/fig-extract-integration.md
onetwothr1 Aug 3, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 4 additions & 2 deletions docs/fig-extract-integration.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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=7 HEAD`로 **7자리 SHA**를 적어 둔다.
더티한 작업 트리를 복사하면 **어느 커밋에도 존재하지 않는 엔진이 벤더링되는데 두 파일 diff는
0건이라 아무 검사에도 안 걸린다** — 나중에 그 코드를 되짚을 방법이 없어진다.
3. `fig-extract.js`를 `src/core/`에 **그대로 복사** — v2.3.0부터 엔진 파일에 globalThis 노출이 포함되어
Expand All @@ -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이 더 긴 약칭을 요구하므로 그때 늘리면 된다.