DongHyeonkaandClaude Opus 5
b3119952d5
Reference 머리말에 「이 기준을 쓰는 이유」와 같은 글이 나오고 있었다. Case 도 마찬가지로 바로 아래 「문제」와 같은 글을 두 번 말했다. 문서가 스스로 밝히는 한 줄 요약이 공개 응답에 없어서, 화면이 유형별 요약 (`problemSummary` / `scopeSummary`)을 대신 쓰고 있었다. Question 에는 이미 `summary` 가 있었으므로 셋이 같은 자리를 갖게 한다. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01XEHXspz4rv5pB5wiiSsVDu
72 lines
2.6 KiB
TypeScript
72 lines
2.6 KiB
TypeScript
import { strict as assert } from "node:assert";
|
|
import { test } from "vitest";
|
|
|
|
import type { components } from "../../../src/features/tech-log/contracts/public/generated.ts";
|
|
|
|
type ReferenceBody =
|
|
components["schemas"]["ReferenceDetailResponse"]["reference"];
|
|
|
|
/*
|
|
이 파일은 사고 하나에서 나왔다.
|
|
|
|
공개 Reference 화면이 통째로 비어 있었다. Studio 에서는 같은 글이 다 보였으므로 "공개 쪽만 안
|
|
나온다" 로 드러났다. 원인은 게이트웨이가 읽던 이름이 계약에 없는 것들이었다는 것이다 —
|
|
`purposeSummary`, `applyWhenMarkdown`, `exceptionsMarkdown`, `examplesMarkdown`. 전부 undefined 로
|
|
떨어졌고 타입 검사는 `as string` 단언 때문에 아무 말도 하지 않았다.
|
|
|
|
그래서 여기서 확인하는 것은 값이 아니라 **이름**이다. 계약이 그 칸을 갖고 있는가, 그리고 화면이
|
|
기대하는 모양인가.
|
|
*/
|
|
test("the public Reference contract keeps the fields the screen reads", () => {
|
|
const reference = {
|
|
title: "",
|
|
// 제목 바로 아래에 오는 것은 문서의 요약이다. scopeSummary 는 그 아래 "이 기준을 쓰는 이유"다.
|
|
summary: "",
|
|
scopeSummary: "",
|
|
appliesTo: [],
|
|
excludedScope: [],
|
|
rules: [{ title: "", body: "" }],
|
|
examples: [],
|
|
freshnessStatus: "CURRENT",
|
|
content: "",
|
|
contentFormat: "MARKDOWN",
|
|
contentFormatVersion: 1,
|
|
tags: [],
|
|
publishedAt: "",
|
|
updatedAt: "",
|
|
} satisfies ReferenceBody;
|
|
|
|
// 화면이 읽는 이름 그대로. 하나라도 계약에서 사라지면 위의 `satisfies` 가 먼저 깨진다.
|
|
assert.deepEqual(Object.keys(reference).sort(), [
|
|
"appliesTo",
|
|
"content",
|
|
"contentFormat",
|
|
"contentFormatVersion",
|
|
"examples",
|
|
"excludedScope",
|
|
"freshnessStatus",
|
|
"publishedAt",
|
|
"rules",
|
|
"scopeSummary",
|
|
"summary",
|
|
"tags",
|
|
"title",
|
|
"updatedAt",
|
|
]);
|
|
});
|
|
|
|
/*
|
|
Reference 의 본문은 `content` 마크다운이 아니라 규칙과 예시에 있다. Studio 의 편집기가 제목과
|
|
본문을 따로 받고 `body_markdown` 은 비워 두기 때문이다 — 그래서 `content` 를 잘라 규칙을 만들려
|
|
하면 언제나 빈 목록이 된다.
|
|
*/
|
|
test("a rule carries its own title and body, not a slice of markdown", () => {
|
|
const rule: NonNullable<ReferenceBody["rules"]>[number] = {
|
|
title: "Authorization Endpoint에는 client_secret을 보내지 않는다",
|
|
body: "이 요청은 브라우저의 full-page navigation으로 나간다.",
|
|
};
|
|
|
|
assert.equal(typeof rule.title, "string");
|
|
assert.equal(typeof rule.body, "string");
|
|
});
|