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
This commit is contained in:
DongHyeonka
2026-09-09 14:12:44 +09:00
co-authored by Claude Opus 5
parent 3374f286be
commit 3af9be9e09
45 changed files with 2195 additions and 65 deletions
@@ -28,7 +28,7 @@ test("계약이 보내는 지식 종류를 매퍼가 하나도 버리지 않는
const kinds = contractKnowledgeKinds();
assert.deepEqual(
[...kinds].sort(),
["CASE", "CONCEPT", "REFERENCE"],
["CASE", "CONCEPT", "REFERENCE", "SETUP"],
"계약이 보내는 종류가 바뀌었다 — 매퍼의 표도 함께 봐야 한다",
);
@@ -17,6 +17,7 @@ const EXPECTED: Record<DeletableDocumentKind, { operationId: string; path: strin
REFERENCE: { operationId: "deleteReferenceDraft", path: "/api/v1/studio/references/{id}" },
QUESTION: { operationId: "deleteQuestion", path: "/api/v1/studio/questions/{id}" },
CONCEPT: { operationId: "deleteConceptDraft", path: "/api/v1/studio/concepts/{id}" },
SETUP: { operationId: "deleteSetupDraft", path: "/api/v1/studio/setups/{id}" },
};
test("지울 수 있는 종류마다 자기 주소가 있고 서로 겹치지 않는다", () => {
@@ -18,6 +18,7 @@ const expectedRoutes = [
["TECH_LOG_CASE", "/cases/:slug", "PUBLIC", "TechLogSlugParams", "TechLogCaseStateSearch"],
["TECH_LOG_REFERENCE", "/references/:slug", "PUBLIC", "TechLogSlugParams", null],
["TECH_LOG_CONCEPT", "/concepts/:slug", "PUBLIC", "TechLogSlugParams", null],
["TECH_LOG_SETUP", "/setups/:slug", "PUBLIC", "TechLogSlugParams", null],
["TECH_LOG_QUESTION", "/questions/:slug", "PUBLIC", "TechLogSlugParams", null],
["TECH_LOG_TOPICS", "/topics", "PUBLIC", null, null],
["TECH_LOG_TOPIC", "/topics/:slug", "PUBLIC", "TechLogSlugParams", null],
@@ -62,6 +63,7 @@ const expectedTitles = {
TECH_LOG_EXPLORE_KIND: "유형별 탐색",
TECH_LOG_CASE: "Case",
TECH_LOG_CONCEPT: "개념",
TECH_LOG_SETUP: "환경 구성",
TECH_LOG_REFERENCE: "Reference",
TECH_LOG_QUESTION: "Open Question",
TECH_LOG_TOPICS: "주제",
@@ -96,7 +98,7 @@ const expectedTitles = {
} as const;
describe("TechLog route boundary contract", () => {
it("freezes the standalone 34-route inventory before runtime installation", () => {
it("freezes the standalone 35-route inventory before runtime installation", () => {
expect(
Object.values(TECH_LOG_ROUTE_REGISTRY).map((definition) => [
definition.routeId,
@@ -171,7 +173,7 @@ describe("TechLog route boundary contract", () => {
for (const locale of ["ko-KR", "en-US"] as const) {
const catalog: Readonly<Record<string, string>> =
TECH_LOG_MESSAGE_CATALOGS[locale];
expect(Object.keys(catalog)).toHaveLength(72);
expect(Object.keys(catalog)).toHaveLength(74);
for (const [routeId, title] of Object.entries(expectedTitles)) {
expect(catalog[`route.${routeId}.title`]).toBe(title);
expect(catalog[`route.${routeId}.navigation`]).toBe(title);
+3 -2
View File
@@ -202,8 +202,9 @@ describe("CI gate contract", () => {
// Alignment follow-up item 2 added the TechLog junit report.
// 주제 화면 셋(`/topics`, `/topics/:slug/:variant`, `/studio/topics/:id`)이 라우트마다
// 하나씩인 수동 접근성 증거를 셋 더했다.
expect(contract.gates.reduce((total, gate) => total + gate.evidenceArtifactIds.length, 0)).toBe(117);
expect(contract.artifacts).toHaveLength(138);
// 환경 구성(SETUP)이 `/setups/:slug` 로 하나를 더 더했다.
expect(contract.gates.reduce((total, gate) => total + gate.evidenceArtifactIds.length, 0)).toBe(118);
expect(contract.artifacts).toHaveLength(139);
expect(contract.stages).toHaveLength(5);
expect(contract.retention.classes).toHaveLength(5);
expect(index.gates.get("FE-GATE-015")?.commandIds).toHaveLength(2);
@@ -192,7 +192,7 @@ describe("selective Task 3 contract closure", () => {
expect(canonical.gates).toHaveLength(27);
expect(canonical.commands).toHaveLength(85);
expect(canonical.gates.reduce((sum, gate) => sum + gate.commandIds.length, 0)).toBe(97);
expect(canonical.artifacts).toHaveLength(138);
expect(canonical.artifacts).toHaveLength(139);
expect(canonical.stages).toHaveLength(5);
expect(canonical.retention.classes).toHaveLength(5);
@@ -33,6 +33,7 @@ describe("TechLog production serving contract", () => {
"^/releases$",
"^/releases/[^/]+$",
"^/search$",
"^/setups/[^/]+$",
"^/topics$",
"^/topics/[^/]+$",
"^/topics/[^/]+/[^/]+$",