test(contracts): 조립기·선언 검증의 쓰기 API 규칙 5개를 고정한다 (07-06)
문제 조립기와 선언 검증의 쓰기 API 규칙 5개는 지워도 관련 테스트가 모두 통과한다(리뷰 변이 MX1·MX2·MX5·MX6·MX9). - MX1 읽기 operation의 command descriptor 금지 (external-contract-runtime.ts). 실행기는 쓰기 여부를 메서드가 아니라 commandEffect !== null로 정하므로 GET이 쓰기로 처리되는 것을 막는 유일한 경계다. - MX9 KEYED 쓰기의 복구 descriptor 필수 - MX6 NEVER 재시도와 재시도 예산 1 이상의 모순 거부 - MX5 V2 KEYED_COMMAND의 idempotencyKeyPolicy REQUIRED 정합 (api-operations.ts) - MX2 mapper 레지스트리 키 = mapperId (boundary-mapper.ts) 조립기는 여러 번 다시 쓰인 파일이라 규칙 줄이 빠져도 CI가 모른다. 고른 방법 규칙마다 그 규칙만 어긴 행 하나로 실패 사례를 둔다. 오류 메시지는 기능 작성자가 쓰기 API 규칙을 배우는 통로라 reason 문자열을 그대로 단언한다. 정상 대조군은 기존 사례(TEST_CONTRACT_CONTRIBUTION 조립, command() 정의, 키가 맞는 mapper 등록)를 쓰거나 같은 테스트 안에 둔다. 코드 변경은 없다. 버린 대안 - 메시지 대신 ContractContributionError 종류만 단언: 다른 규칙이 먼저 실패해도 통과해서 변이를 놓칠 수 있다. 위험·한계 - 메시지 문구를 바꾸면 테스트도 바꿔야 한다. 의도한 결합이다. - MX6은 실행기(http-retry-lifecycle)가 한 번 더 막는다. 이 테스트는 조립 단계의 안내 메시지를 지킨다. 검증 - RED: 변이 5개를 하나씩 넣고 바꾼 3파일을 돌렸다. 이 커밋 전 테스트로는 5개 모두 살아남음(26/26 통과). 새 테스트로는 5개 모두 죽음, 각 변이마다 해당 사례 1건만 실패(30/31). - GREEN: 변이 없이 31/31 통과. - 회귀: tsc test rc=0, 바꾼 파일 eslint rc=0. Refs: docs/reviews/2026-11-01-maturity-review/07-contracts.md
This commit is contained in:
@@ -57,6 +57,15 @@ describe("REST operation v2 registry", () => {
|
||||
}),
|
||||
).toThrow("Incoherent REST replay contract");
|
||||
});
|
||||
|
||||
// 07-06 (MX5). A KEYED command without a required idempotency key would be
|
||||
// resent with no key to bind the retry to.
|
||||
it("rejects a KEYED_COMMAND whose idempotency key is not required", () => {
|
||||
expect(() =>
|
||||
defineRestOperation({ ...command(), idempotencyKeyPolicy: "NONE" }),
|
||||
).toThrow("Incoherent REST replay contract: CREATE_RESOURCE");
|
||||
expect(defineRestOperation(command()).idempotencyKeyPolicy).toBe("REQUIRED");
|
||||
});
|
||||
});
|
||||
|
||||
function command(): RestOperationV2 {
|
||||
|
||||
@@ -35,6 +35,26 @@ describe("platform DTO mapper boundary", () => {
|
||||
).toThrow("duplicate boundary mapper");
|
||||
});
|
||||
|
||||
// 07-06 (MX2). V2 rows look mappers up by `mapperId`; a registry key that
|
||||
// differs would install a mapper no operation can reach.
|
||||
it("rejects a registry key that is not the mapper's own id", () => {
|
||||
const mapper = {
|
||||
mapperId: "ResourceMapper",
|
||||
mapperVersion: 1,
|
||||
inputSchemaId: "ResourcePayload",
|
||||
outputContractId: "Resource",
|
||||
owner: "test",
|
||||
maxOutputItems: 1,
|
||||
map: (input: unknown) => mappingSuccess(input),
|
||||
};
|
||||
expect(() =>
|
||||
composeBoundaryMapperRegistry([{ OtherMapper: mapper }]),
|
||||
).toThrow("Invalid or duplicate boundary mapper: OtherMapper");
|
||||
expect(
|
||||
Object.keys(composeBoundaryMapperRegistry([{ ResourceMapper: mapper }])),
|
||||
).toEqual(["ResourceMapper"]);
|
||||
});
|
||||
|
||||
it("adapts a boundary result to the canonical mapping result (D-15)", () => {
|
||||
expect(toContractMappingResult(mappingSuccess(1))).toEqual({
|
||||
ok: true,
|
||||
|
||||
@@ -86,6 +86,57 @@ describe("external contract contribution composition", () => {
|
||||
});
|
||||
});
|
||||
|
||||
// 07-06 (MX1, MX9, MX6). The write-API rules the composer teaches through its
|
||||
// error messages. TEST_CONTRACT_CONTRIBUTION composing in the first block is
|
||||
// the valid control.
|
||||
describe("write operation rules", () => {
|
||||
const [listRow, , createRow] = TEST_CONTRACT_CONTRIBUTION.http as readonly [
|
||||
InstalledContractContribution["http"][number],
|
||||
InstalledContractContribution["http"][number],
|
||||
InstalledContractContribution["http"][number],
|
||||
];
|
||||
|
||||
function reasonFor(row: object): string {
|
||||
return captureContributionError(() =>
|
||||
composeContractContributions([
|
||||
contribution("write-rule", [
|
||||
row as InstalledContractContribution["http"][number],
|
||||
]),
|
||||
]),
|
||||
).reason;
|
||||
}
|
||||
|
||||
// The executor decides "write" by `commandEffect !== null`, not by method,
|
||||
// so this rule is the only thing keeping a GET from running as a command.
|
||||
it("rejects command descriptors on a read operation", () => {
|
||||
expect(
|
||||
reasonFor({
|
||||
...listRow,
|
||||
contract: { ...listRow.contract, commandEffect: createRow.contract.commandEffect },
|
||||
}),
|
||||
).toBe("test-feature/TEST_LIST_ENTITIES: read operations carry no command descriptors");
|
||||
});
|
||||
|
||||
it("requires a recovery descriptor on a KEYED command", () => {
|
||||
expect(
|
||||
reasonFor({
|
||||
...createRow,
|
||||
contract: { ...createRow.contract, commandRecovery: null },
|
||||
}),
|
||||
).toBe("test-feature/TEST_CREATE_ENTITY: KEYED commands require a recovery descriptor");
|
||||
});
|
||||
|
||||
it("rejects a retry budget on a NEVER-retry operation", () => {
|
||||
expect(
|
||||
reasonFor({
|
||||
...createRow,
|
||||
contract: { ...createRow.contract, retrySemantics: "NEVER" },
|
||||
frontend: { ...createRow.frontend, retryBudget: 1 },
|
||||
}),
|
||||
).toBe("test-feature/TEST_CREATE_ENTITY: retry budget contradicts NEVER retry semantics");
|
||||
});
|
||||
});
|
||||
|
||||
// The sample feature's own cases (its fixture composes, a second one does not)
|
||||
// live in tests/features so they leave with the sample.
|
||||
describe("template fixture provenance (07-04, §4.8)", () => {
|
||||
|
||||
Reference in New Issue
Block a user