Files
tech-log-frontend/scripts/archive-topics.ts
DongHyeonkaandClaude Opus 5 9b5ca09f30 chore: 주제를 보관으로 내리는 스크립트
리뷰와 무관하게, 제가 이전 세션에 DB 로 직접 넣은 주제 다섯이 기록 0개인 채로 공개돼
있었다 — 「A층 열 편을 직접 치는 순서」처럼 독자에게 아무것도 말하지 않는 이름이었고,
환경 구성을 별도 주제로 떼어 낸 것 자체가 틀렸다. 환경 구성은 조사 주제가 아니라 어떤
주제를 검증하기 위한 조건이므로 그 주제 안에 들어가야 한다.

지우지 않고 상태만 내린다. 기록이 붙어 있으면 거부하고, 그 판단을 스크립트 안의 목록이
아니라 서버에 물어 확인한다.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015c8cBFUaVr7KLVUx6ujz7D
2026-09-15 20:48:01 +09:00

145 lines
5.4 KiB
TypeScript

import { mkdir, readFile } from "node:fs/promises";
import path from "node:path";
import process from "node:process";
import { chromium, type APIRequestContext } from "@playwright/test";
/**
* 주제를 보관 상태로 내린다.
*
* <p>지우지 않는다. `status` 를 `ARCHIVED` 로 바꾸면 공개 목록에서 빠지고 되돌릴 수 있다 —
* 잘못 내린 것을 다시 올릴 방법이 없으면 이 작업 자체가 위험해진다.
*
* <p>기록이 붙어 있는 주제는 건드리지 않는다. 내려도 되는 것은 아직 아무 기록도 가리키지 않는
* 주제뿐이고, 그 판단을 손으로 적어 둔 목록에 맡기지 않고 서버에 물어 확인한다.
*
* 사용법:
* node scripts/archive-topics.ts --login
* node scripts/archive-topics.ts <slug> [slug...]
* node scripts/archive-topics.ts --dry-run <slug> [slug...]
*/
const BASE = "https://hyeonworks.com";
const SESSION_FILE = "artifacts/design-review/studio-session.json";
type TopicEdit = Readonly<Record<string, unknown>> & {
id?: string;
slug?: string;
name?: string;
version?: number;
status?: string;
};
async function login(): Promise<void> {
const browser = await chromium.launch({ headless: false });
const context = await browser.newContext({ viewport: { width: 1440, height: 900 } });
const page = await context.newPage();
await page.goto(`${BASE}/studio`);
process.stdout.write("열린 창에서 로그인하세요. Studio 화면이 뜨면 자동으로 저장합니다...\n");
try {
await page.waitForSelector('a[href="/studio/documents"]', { timeout: 300_000 });
await mkdir(path.dirname(SESSION_FILE), { recursive: true });
await context.storageState({ path: SESSION_FILE });
process.stdout.write(`세션 저장: ${SESSION_FILE}\n`);
} finally {
await browser.close();
}
}
async function json(request: APIRequestContext, url: string): Promise<unknown> {
const response = await request.get(url, { headers: { Accept: "application/json" } });
if (!response.ok()) throw new Error(`${url} → ${response.status()}`);
return (await response.json()) as unknown;
}
function envelopeData(value: unknown): unknown {
return typeof value === "object" && value !== null && "data" in value
? (value as { data: unknown }).data
: value;
}
async function main(): Promise<void> {
if (process.argv.includes("--login")) {
await login();
return;
}
const dryRun = process.argv.includes("--dry-run");
const slugs = process.argv.slice(2).filter((entry) => !entry.startsWith("--"));
if (slugs.length === 0) {
process.stderr.write("내릴 주제의 slug 를 적어 주세요.\n");
process.exitCode = 1;
return;
}
await readFile(SESSION_FILE, "utf8").catch(() => {
throw new Error(`세션이 없습니다(${SESSION_FILE}). --login 으로 먼저 로그인하세요.`);
});
const browser = await chromium.launch();
try {
const context = await browser.newContext({ storageState: SESSION_FILE });
const request = context.request;
/*
쓰기에는 CSRF 토큰이 필요하다. 세션 조회가 토큰과 그것을 실을 헤더 이름을 함께 준다 —
헤더 이름을 손으로 적어 두면 서버가 그 이름을 바꾸는 날 403 만 보고 이유를 알 수 없다.
*/
const session = envelopeData(await json(request, `${BASE}/api/v1/studio/session`)) as {
csrfToken: string;
csrfHeaderName: string;
};
const topics = envelopeData(await json(request, `${BASE}/api/v1/studio/topics`)) as TopicEdit[];
const publicTopics = envelopeData(
await json(request, `${BASE}/api/v1/public/topics`),
) as { items: ReadonlyArray<{ slug: string; recordCount: number }> };
const recordCounts = new Map(
publicTopics.items.map((topic) => [topic.slug, topic.recordCount]),
);
for (const slug of slugs) {
const topic = topics.find((candidate) => candidate.slug === slug);
if (!topic?.id) {
process.stdout.write(` ✗ ${slug} — 그런 주제가 없습니다\n`);
continue;
}
const count = recordCounts.get(slug) ?? 0;
if (count > 0) {
process.stdout.write(` ✗ ${slug} — 기록 ${count}개가 붙어 있어 내리지 않습니다\n`);
continue;
}
if (topic.status === "ARCHIVED") {
process.stdout.write(` · ${slug} — 이미 보관 상태입니다\n`);
continue;
}
if (dryRun) {
process.stdout.write(` (예행) ${slug} — ${topic.name} 을 보관으로 내립니다\n`);
continue;
}
/*
계약이 요구하는 필드(name/slug)를 그대로 돌려보내고 status 와 expectedVersion 만 얹는다.
빠뜨리면 서버가 그 값을 비운 것으로 읽는다.
*/
const response = await request.put(`${BASE}/api/v1/studio/topics/${topic.id}`, {
headers: {
"Content-Type": "application/json",
Accept: "application/json",
[session.csrfHeaderName]: session.csrfToken,
},
data: { ...topic, status: "ARCHIVED", expectedVersion: topic.version },
});
if (!response.ok()) {
process.stdout.write(` ✗ ${slug} — ${response.status()} ${await response.text()}\n`);
continue;
}
process.stdout.write(` ✓ ${slug} — ${topic.name} 을 보관으로 내렸습니다\n`);
}
} finally {
await browser.close();
}
}
await main();