fix(contracts): 짝 백엔드 pin과 drift 검사가 생성기 템플릿 사실도 대조한다
문제: create:feature --with-create가 백엔드 생성기 템플릿의 사실 넷을 프론트 문자열로 옮겼다. 경로 복수형(scripts/new-feature.sh), 이름 상한 100 (__Feature__.java.tmpl NAME_MAX_LENGTH), 오류 code <FEATURE>_INVALID· _NOT_FOUND(__Feature__ErrorCode·ControllerTest 템플릿), 201과 검사 순서 (Controller·Create__Feature__UseCase 템플릿)다. 그러나 pin (config/contracts/backend-contract-pin.json)과 check:backend-contract-drift는 docs/web/http-contract.md(1105/07-01 뒤로는 그 문서의 표 사본과 답 표)만 본다. 백엔드가 템플릿을 바꾸면 생성 기능이 다른 경로·상한·code를 써도 아무 신호가 없다. 고른 방법: pin의 backend.scaffoldSources에 백엔드 템플릿 파일 여섯과 각 파일에서 옮긴 사실, 옮긴 프론트 위치(파일과 이름)를 적는다. drift 검사는 1105/07-01의 사본·답 표 대조와 종료 코드(0 일치, 1 어긋남, 2 비교 못 함)를 그대로 두고, pin 뒤 HEAD에서 이 파일들도 diff한다. 바뀐 파일마다 다시 볼 프론트 위치를 failures에 더해 exit 1한다. pin 단위 테스트는 각 항목의 프론트 이름이 실제로 그 파일에 있는지 본다. drift 단위 테스트는 07-01의 가짜 백엔드 fixture에 생성기 템플릿 파일 하나를 더하고, 그 파일이 바뀐 경우(exit 1, 프론트 위치 출력)와 pin이 이름 붙이지 않은 파일만 바뀐 경우(exit 0, "1 scaffold sources unchanged")를 더한다. 07-01의 경우들은 그대로다. 계약 문서 4.1절과 생성기 머리 주석에 같은 내용을 적었다. 버린 대안: 백엔드가 생성기 사실을 JSON으로 내고 프론트가 읽기 — 두 repo를 바꿔야 한다(백엔드는 이번에 읽기만 한다). 위험·한계: drift 검사는 여전히 게이트 밖이고 형제 checkout이 있을 때만 돈다. 파일 단위 diff라 템플릿의 무관한 줄이 바뀌어도 알린다(사람이 다시 본다). pin의 commit(45d2a478)은 그대로다. 네 사실이 그 커밋과 같다는 대조는 리뷰(1105/16 영역)가 했고 이번에는 이름 상한만 다시 읽었다. 07-01과 같은 파일을 고쳐서 fix/r1105-contracts-core-sq 위에 다시 쌓았다. 검증: desktop batch에서 확인. node scripts/run-vitest.ts run tests/unit/backend-contract-drift.test.ts tests/unit/backend-contract-pin.test.ts corepack pnpm check:backend-contract-drift (desktop 형제 checkout 기준, 참고) Refs: 1105/16-02
This commit is contained in:
@@ -14,6 +14,12 @@
|
||||
* `--keyed` is for a backend create made KEYED with its IdempotencyExecutor
|
||||
* (its docs/manual/05-idempotency.md). Like the rest of the command, nothing
|
||||
* here imports a sample feature.
|
||||
*
|
||||
* 1105/16-02. The backend scaffold facts copied here (name limit, error
|
||||
* codes, 201 and the endpoints, the check order behind refusedBeforeWrite)
|
||||
* and the path rule in create-feature.ts are listed with their backend
|
||||
* files in config/contracts/backend-contract-pin.json `scaffoldSources`;
|
||||
* `check:backend-contract-drift` says when one of those files changes.
|
||||
*/
|
||||
|
||||
export type WriteSemantics = "NEVER" | "KEYED";
|
||||
|
||||
Reference in New Issue
Block a user