fix: 개념 삭제가 실제로 개념 경로로 나가게 한다

앞선 커밋은 게이트웨이를 고치지 못했다. 편집 스크립트가 중간에서 실패했는데
그 뒤 단계만 다시 돌리고 이 파일은 손대지 않은 채 넘어갔다. 배포된 번들에
옛 삼항이 그대로 남아 서버 로그에
`DELETE /api/v1/studio/questions/{id} 404` 가 계속 찍혔다.

타입 검사가 잡지 못한 이유는 메서드 매개변수가 TypeScript 에서 bivariant
이기 때문이다 — 구현이 종류를 `"CASE" | "REFERENCE" | "QUESTION"` 으로
좁게 적어도 넓은 포트 시그니처를 만족한 것으로 통과한다. 그래서 "타입
통과"를 보고 반영됐다고 판단한 것이 틀렸다.

계약에 주소가 있는지만 보던 가드도 이것을 놓쳤다. 게이트웨이를 실제로 불러
어떤 연산이 실행되는지 확인하는 가드를 더한다 — CONCEPT 을 deleteQuestion
으로 되돌리면 깨지는 것을 확인했다.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_011nAjrqNHGPNngN4aUbcyvJ
This commit is contained in:
DongHyeonka
2026-08-31 10:55:18 +09:00
co-authored by Claude Opus 5
parent dec86bd1f2
commit 6429aee74e
2 changed files with 54 additions and 8 deletions
@@ -120,17 +120,26 @@ export function createHttpManagementGateway(
archiveRelease: (id: string, expectedVersion: number) =>
run<ReleaseEditResponse>("archiveRelease", { id, expectedVersion }),
deleteDocument: async (
kind: "CASE" | "REFERENCE" | "QUESTION",
kind: DeletableDocumentKind,
id: string,
expectedVersion: number,
) => {
const operationId =
kind === "CASE"
? "deleteCaseDraft"
: kind === "REFERENCE"
? "deleteReferenceDraft"
: "deleteQuestion";
await run<void>(operationId, { id, expectedVersion });
/*
삼항으로 이어 붙이면 마지막 else 가 모르는 종류를 다 받아 간다 — 개념이 그렇게 질문
삭제로 떨어졌고, 「질문을 찾을 수 없습니다」가 났다. 표로 두면 종류가 늘 때 빠진
자리를 타입이 잡는다.
메서드 매개변수는 TypeScript 에서 bivariant 라, 이 자리에 좁은 종류를 적어도 넓은
포트 시그니처를 만족한 것으로 통과한다 — 그래서 타입 검사가 이 결함을 잡지 못했다.
아래 표가 `Record<DeletableDocumentKind, …>` 인 것이 실제로 종류를 강제하는 지점이다.
*/
const OPERATIONS: Record<DeletableDocumentKind, string> = {
CASE: "deleteCaseDraft",
REFERENCE: "deleteReferenceDraft",
QUESTION: "deleteQuestion",
CONCEPT: "deleteConceptDraft",
};
await run<void>(OPERATIONS[kind], { id, expectedVersion });
},
deleteDecision: async (projectId: string, decisionId: string, expectedVersion: number) => {
await run<void>("deleteProjectDecision", { id: projectId, decisionId, expectedVersion });
@@ -38,3 +38,40 @@ test("지울 수 있는 종류마다 자기 주소가 있고 서로 겹치지
paths.add(expected.path);
}
});
/**
* 앞의 검사는 계약에 주소가 있는지만 본다. 그것만으로는 부족했다 — 계약에 개념 삭제를 넣고도
* 게이트웨이는 여전히 삼항의 마지막 else 로 질문 삭제를 불렀고, 배포된 뒤에야 서버 로그의
* `DELETE /api/v1/studio/questions/{id} 404` 로 드러났다.
*
* <p>타입이 잡아 주지 못한 이유: 메서드 매개변수는 TypeScript 에서 bivariant 라, 구현이 종류를
* 좁게 적어도 넓은 포트 시그니처를 만족한 것으로 통과한다.
*
* <p>그래서 여기서는 게이트웨이를 실제로 불러 어떤 연산이 실행되는지 본다.
*/
test("게이트웨이가 종류마다 그 종류의 연산을 부른다", async () => {
const { createHttpManagementGateway } = await import(
"../../../src/features/tech-log/adapters/http/http-management-gateway.ts"
);
const called: string[] = [];
const gateway = createHttpManagementGateway({
operations: {
execute: (operationId: string) => {
called.push(operationId);
return Promise.resolve({ kind: "SUCCESS", value: undefined });
},
},
} as never);
for (const kind of ["CASE", "REFERENCE", "QUESTION", "CONCEPT"] as const) {
await gateway.deleteDocument(kind, "11111111-1111-4111-8111-111111111111", 1);
}
assert.deepEqual(called, [
"deleteCaseDraft",
"deleteReferenceDraft",
"deleteQuestion",
"deleteConceptDraft",
]);
});