Files
tech-log-frontend/tests/features/tech-log/knowledge-list-kinds.test.ts
T
DongHyeonkaandClaude Opus 5 3af9be9e09 feat: 환경 구성(SETUP) 기록 종류를 더한다
다섯 종류는 전부 끝난 일을 남긴다. 없는 것은 읽는 사람이 자기 손으로 다시
하려면 무엇부터 하는가다. Case 의 environment 는 평문 한 칸이라 명령이
들어가지 않고, 같은 셋업을 쓰는 Case 가 넷이면 같은 문장이 네 벌 복제된다.

프로젝트는 필수, 주제는 선택으로 둔다. 주제 없는 셋업이 그 프로젝트의 공통
구성이고, 주제를 붙이면 그 주제의 구성이다 — 스키마를 나누지 않고 두 범위를
같은 종류로 받는다.

버전만 본문 밖에 둔다(pinnedVersions). 이 절차가 어느 버전 위에서 성립했는지는
그 기록의 유효 범위이고, 목록과 머리말이 본문을 열지 않고 보여 줘야 한다.
나머지 셋(실행 절차·구성 값·확인 방법)은 명령과 표를 담아야 하므로 본문이다.

이름은 SETUP 이다. ENVIRONMENT 가 영어로는 자연스럽지만 case_detail.environment
와 겹친다 — 이 저장소가 열네 번 밟은 실패가 「종류를 손으로 나열한 곳을
빠뜨린다」이고 그걸 찾는 수단이 grep 이다.

손으로 나열해 두었던 자리를 이번에 표로 바꿨다. publicPath 의 삼항 사슬은
마지막 else 가 「나머지 전부」여서 새 종류의 주소가 조용히 /questions/… 가
됐고, document-editor 의 칸 경로도 같은 모양이었다.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01PTnWufiY9ATv57egkKKVAV
2026-09-09 14:12:44 +09:00

52 lines
2.2 KiB
TypeScript

import assert from "node:assert/strict";
import { readFileSync } from "node:fs";
import { test } from "vitest";
import { knowledgeListItemToRecord } from "../../../src/features/tech-log/adapters/http/public-content-mapping.ts";
/**
* 지식 목록이 계약이 보내는 종류를 하나도 버리지 않는지 본다.
*
* <p>매퍼가 CASE 와 REFERENCE 만 알던 동안 개념은 `null` 로 버려졌다. 서버는 개념을 보내고
* 탐색 필터에는 「동작 원리」가 있는데 결과는 0건이었다 — 독자에게는 기록이 없는 것으로
* 보였고, 필터에 있는데 결과가 없으니 오해가 남았다.
*
* <p>기대 목록을 손으로 적지 않고 계약에서 읽는다. 종류가 늘면 여기서 먼저 멈춘다.
*/
const CONTRACT = readFileSync(
"src/features/tech-log/contracts/public/public-api.openapi.yaml",
"utf8",
);
function contractKnowledgeKinds(): string[] {
const block = /\n {4}KnowledgeListItem:[\s\S]*?(?=\n {4}[A-Z]\w+:)/u.exec(CONTRACT)?.[0] ?? "";
const typeBlock = /\n {8}type:\n {10}type: string\n {10}enum:\n((?: {10}- \w+\n)+)/u.exec(block);
return [...(typeBlock?.[1] ?? "").matchAll(/- (\w+)/gu)].map((match) => match[1]!);
}
test("계약이 보내는 지식 종류를 매퍼가 하나도 버리지 않는다", () => {
const kinds = contractKnowledgeKinds();
assert.deepEqual(
[...kinds].sort(),
["CASE", "CONCEPT", "REFERENCE", "SETUP"],
"계약이 보내는 종류가 바뀌었다 — 매퍼의 표도 함께 봐야 한다",
);
for (const type of kinds) {
const record = knowledgeListItemToRecord({
type,
title: "제목",
path: `/x/${type.toLowerCase()}`,
primarySummary: "요약",
publishedAt: "2026-01-01T00:00:00Z",
primaryTopic: { name: "주제", slug: "topic" },
primaryProject: { name: "프로젝트", slug: "project" },
});
assert.ok(record, `${type} 이 목록에서 버려진다`);
assert.equal(record.kind, type, `${type} 이 다른 종류로 읽힌다`);
// 맥락 줄이 이 두 값을 읽는다. 비면 「· 프로젝트」처럼 앞이 잘린 줄이 남는다.
assert.equal(record.topic, "주제");
assert.equal(record.projectTitle, "프로젝트");
}
});