refactor(stats): convert all Korean comments to English

Author: k1yt

packages/types/src/usage-stats.ts

@@ -2,21 +2,21 @@ import { z } from "zod"
 
 // ── Enums ──────────────────────────────────────────────────────────────────
 
-/** LLM API 호출의 최종 상태 */
+/** Final status of an LLM API call */
 export const UsageEventStatus = z.enum(["completed", "failed", "cancelled"])
 export type UsageEventStatus = z.infer<typeof UsageEventStatus>
 
-/** 토큰 사용량 값의 출처 */
+/** Source of a token usage value */
 export const UsageValueSource = z.enum(["provider", "estimated", "backfilled"])
 export type UsageValueSource = z.infer<typeof UsageValueSource>
 
-/** 토큰 중복 계산 여부 (예: cacheRead이 inputTokens에 포함되어 있는지) */
+/** Whether a token field is double-counted (e.g. cacheRead included in inputTokens) */
 export const InclusionRule = z.enum(["included", "excluded", "unknown"])
 export type InclusionRule = z.infer<typeof InclusionRule>
 
 // ── SourcedNumber ──────────────────────────────────────────────────────────
 
-/** 값과 그 출처를 함께 표현 */
+/** A numeric value paired with its source */
 export const SourcedNumber = z.object({
 	value: z.number(),
 	source: UsageValueSource,
@@ -26,11 +26,11 @@ export type SourcedNumber = z.infer<typeof SourcedNumber>
 // ── UsageEventV1 ────────────────────────────────────────────────────────────
 
 /**
- * 단일 LLM API 호출의 사용량 이벤트.
- * schemaVersion 1 — 향후 스키마 변경 시 버전을 올립니다.
+ * A usage event for a single LLM API call.
+ * schemaVersion 1 — bump when the schema changes.
  *
- * 보안: prompt 본문, response 본문, API key, workspace path는
- * 이 스키마에 절대 포함하지 않습니다.
+ * Security: prompt bodies, response bodies, API keys, and workspace paths
+ * must never be included in this schema.
  */
 export const UsageEventV1 = z.object({
 	schemaVersion: z.literal(1),
@@ -65,7 +65,7 @@ export type UsageEventV1 = z.infer<typeof UsageEventV1>
 
 // ── StatsQuery ──────────────────────────────────────────────────────────────
 
-/** 통계 조회 쿼리 */
+/** Statistics query */
 export const StatsQuery = z.object({
 	from: z.string().optional(), // ISO 8601
 	to: z.string().optional(),
@@ -78,7 +78,7 @@ export type StatsQuery = z.infer<typeof StatsQuery>
 
 // ── StatsBucket ──────────────────────────────────────────────────────────────
 
-/** 그룹화된 통계 버킷 */
+/** Grouped statistics bucket */
 export const StatsBucket = z.object({
 	key: z.record(z.string()),
 	events: z.number(),
@@ -98,7 +98,7 @@ export type StatsBucket = z.infer<typeof StatsBucket>
 
 // ── StatsSnapshot ────────────────────────────────────────────────────────────
 
-/** 통계 조회 결과 스냅샷 */
+/** Statistics query result snapshot */
 export const StatsSnapshot = z.object({
 	query: StatsQuery,
 	generatedAt: z.string(),

src/core/task/Task.ts

@@ -273,9 +273,9 @@ export class Task extends EventEmitter<TaskEvents> implements TaskLike {
 	private readonly globalStoragePath: string
 
 	/**
-	 * Usage 이벤트 기록기. API attempt의 terminal finalize에서만 호출된다.
-	 * store 초기화 실패 시 null이며, 이 경우 기록을 조용히 건너뛴다.
-	 * (아키텍처 보고서 섹션 5.5-5.8, rollback: writer를 optional service로 주입)
+	 * Usage event recorder. Called only at terminal finalize of API attempts.
+	 * Null if store initialization failed; in that case recording is silently skipped.
+	 * (Architecture report section 5.5-5.8, rollback: writer injected as optional service)
 	 */
 	private readonly usageRecorder: UsageRecorder | null = null
 

src/core/task/__tests__/Task.usage-stats.spec.ts

@@ -1,10 +1,10 @@
 // npx vitest core/task/__tests__/Task.usage-stats.spec.ts
 //
-// Commit 3 테스트: API attempt 최종 usage 계측 검증.
-// - chunk별 기록이 없고 terminal finalize에서만 기록
-// - completed/failed/cancelled partial usage 구분
-// - idempotency key가 동일 terminal path 중복 호출 차단
-// - store 오류가 기존 task 결과에 영향을 주지 않음
+// Commit 3 test: verify final usage recording for each API attempt.
+// - No per-chunk recording; only terminal finalize records events
+// - Distinguish completed/failed/cancelled partial usage
+// - Idempotency key blocks duplicate calls on the same terminal path
+// - Store errors do not affect existing task results
 
 import * as os from "os"
 import * as path from "path"