refactor: contest module restructure phase1

.claude/skills/add-contest-table-provider/instructions.md

@@ -33,16 +33,16 @@ Step 0 (seed check) is already done. Confirm the following before touching code:
 > Skip when an existing ContestType already covers this contest family (e.g. `AOJ_JAG` for JAG Prelim).
 
 - [ ] Add to `prisma/schema.prisma` ContestType enum → `pnpm exec prisma generate`
-- [ ] Add to `ContestType` in `src/lib/types/contest.ts` (same position as schema)
+- [ ] Add to `ContestType` in `src/lib/contests/types/contest.ts` (same position as schema)
 - [ ] `pnpm check` — confirm error resolved
 
 ## Layer 3 — Contest utilities (TDD)
 
 ### Tests first
 
-- [ ] Add exports to `src/test/lib/utils/test_cases/contest_type.ts` and `contest_name_labels.ts`
-- [ ] Add 3 `describe` blocks to `src/test/lib/utils/contest.test.ts`: classify / priority / name label
-- [ ] `pnpm test:unit src/test/lib/utils/contest.test.ts` — **RED**
+- [ ] Add exports to `src/lib/contests/fixtures/contest_type.ts` and `contest_name_labels.ts`
+- [ ] Add 3 `describe` blocks to `src/lib/contests/utils/contest.test.ts`: classify / priority / name label
+- [ ] `pnpm test:unit src/lib/contests/utils/contest.test.ts` — **RED**
 
 ### Implement
 

docs/guides/architecture.md

@@ -158,6 +158,7 @@ src/lib/
 ├── clients/        # 外部 API クライアント（AtCoder Problems, AOJ）
 ├── components/     # 共通 UI コンポーネント（GradeLabel, TaskGradeList, TaskList, FormWrapper 等）
 ├── constants/      # アプリ定数
+├── contests/       # コンテスト分類・ラベル生成・優先度（types/, utils/, fixtures/）
 ├── server/         # サーバー専用の共有インフラ
 │   ├── database.ts # Prisma クライアント（14+ サービスが依存）
 │   ├── tasks/      # cache.ts など複数 feature 共有のサーバ処理

docs/guides/how-to-add-contest-table-provider.md

@@ -6,8 +6,8 @@
 
 ## 事前確認
 
-- [ ] `ContestType`（`src/lib/types/contest.ts`）— 既存で対応できるか？複数 contest_id を統一表示するなら複合型
-- [ ] `classifyContest()`（`src/lib/utils/contest.ts`）— 新 contest_id に正しい ContestType を返すか
+- [ ] `ContestType`（`src/lib/contests/types/contest.ts`）— 既存で対応できるか？複数 contest_id を統一表示するなら複合型
+- [ ] `classifyContest()`（`src/lib/contests/utils/contest.ts`）— 新 contest_id に正しい ContestType を返すか
 - [ ] `prisma/tasks.ts` にデータが存在するか（複合型は `prisma/contest_task_pairs.ts` も）
 - [ ] 実装パターン判定（後述4パターン）
 - [ ] JOI: 2026 年より `joi{YYYY}ho` → `joi{YYYY}sf`。regex は `(ho|sf)` 対応済み

prisma/seed.ts

@@ -24,7 +24,7 @@ import { hashPassword } from '../src/features/auth/server/password';
 import { getTaskGrade } from '../src/lib/types/task';
 import type { PlacementCreate } from '../src/features/workbooks/types/workbook_placement';
 
-import { classifyContest } from '../src/lib/utils/contest';
+import { classifyContest } from '../src/lib/contests/utils/contest';
 
 import { users, USER_PASSWORD_FOR_SEED } from './users';
 import { tasks } from './tasks';

src/features/tasks/types/contest-table/contest_table_provider.ts

@@ -1,4 +1,4 @@
-import type { ContestType } from '$lib/types/contest';
+import type { ContestType } from '$lib/contests/types/contest';
 import type { TaskResults, TaskResult } from '$lib/types/task';
 
 /**

src/features/tasks/utils/contest-table/abc_providers.test.ts

@@ -1,6 +1,6 @@
 import { describe, test, expect } from 'vitest';
 
-import { ContestType } from '$lib/types/contest';
+import { ContestType } from '$lib/contests/types/contest';
 import type { TaskResult, TaskResults } from '$lib/types/task';
 
 import {

src/features/tasks/utils/contest-table/abc_providers.ts

@@ -4,7 +4,7 @@ import {
 } from '$features/tasks/types/contest-table/contest_table_provider';
 import type { TaskResult } from '$lib/types/task';
 
-import { classifyContest, getContestNameLabel } from '$lib/utils/contest';
+import { classifyContest, getContestNameLabel } from '$lib/contests/utils/contest';
 
 import { ContestTableProviderBase, parseContestRound } from './contest_table_provider_base';
 

src/features/tasks/utils/contest-table/abs_provider.test.ts

@@ -1,6 +1,6 @@
 import { describe, test, expect } from 'vitest';
 
-import { ContestType } from '$lib/types/contest';
+import { ContestType } from '$lib/contests/types/contest';
 import type { TaskResults } from '$lib/types/task';
 
 import { ABSProvider } from './abs_provider';

src/features/tasks/utils/contest-table/abs_provider.ts

@@ -4,7 +4,7 @@ import {
 } from '$features/tasks/types/contest-table/contest_table_provider';
 import type { TaskResult } from '$lib/types/task';
 
-import { classifyContest } from '$lib/utils/contest';
+import { classifyContest } from '$lib/contests/utils/contest';
 
 import { ContestTableProviderBase } from './contest_table_provider_base';
 

src/features/tasks/utils/contest-table/acl_providers.test.ts

@@ -1,6 +1,6 @@
 import { describe, test, expect } from 'vitest';
 
-import { ContestType } from '$lib/types/contest';
+import { ContestType } from '$lib/contests/types/contest';
 import type { TaskResults } from '$lib/types/task';
 
 import { ACLPracticeProvider, ACLBeginnerProvider, ACLProvider } from './acl_providers';

src/features/tasks/utils/contest-table/acl_providers.ts

@@ -4,7 +4,7 @@ import {
 } from '$features/tasks/types/contest-table/contest_table_provider';
 import type { TaskResult } from '$lib/types/task';
 
-import { classifyContest } from '$lib/utils/contest';
+import { classifyContest } from '$lib/contests/utils/contest';
 
 import { ContestTableProviderBase } from './contest_table_provider_base';
 

src/features/tasks/utils/contest-table/agc_provider.test.ts

@@ -1,6 +1,6 @@
 import { describe, test, expect } from 'vitest';
 
-import { ContestType } from '$lib/types/contest';
+import { ContestType } from '$lib/contests/types/contest';
 import type { TaskResults } from '$lib/types/task';
 
 import { AGC001OnwardsProvider } from './agc_provider';

src/features/tasks/utils/contest-table/agc_provider.ts

@@ -1,7 +1,7 @@
 import { type ContestTableMetaData } from '$features/tasks/types/contest-table/contest_table_provider';
 import type { TaskResult } from '$lib/types/task';
 
-import { classifyContest, getContestNameLabel } from '$lib/utils/contest';
+import { classifyContest, getContestNameLabel } from '$lib/contests/utils/contest';
 
 import { ContestTableProviderBase, parseContestRound } from './contest_table_provider_base';
 

src/features/tasks/utils/contest-table/aoj_icpc_providers.test.ts

@@ -1,6 +1,6 @@
 import { describe, test, expect, beforeEach, afterEach } from 'vitest';
 
-import { ContestType } from '$lib/types/contest';
+import { ContestType } from '$lib/contests/types/contest';
 import type { TaskResults } from '$lib/types/task';
 
 import { AOJ_LABEL_OVERRIDES } from './aoj_labels';

src/features/tasks/utils/contest-table/aoj_icpc_providers.ts

@@ -1,4 +1,4 @@
-import { ContestType } from '$lib/types/contest';
+import { ContestType } from '$lib/contests/types/contest';
 import type { TaskResult, TaskResults } from '$lib/types/task';
 import {
   type ContestTableMetaData,

src/features/tasks/utils/contest-table/aoj_jag_providers.test.ts

@@ -1,6 +1,6 @@
 import { describe, test, expect } from 'vitest';
 
-import { ContestType } from '$lib/types/contest';
+import { ContestType } from '$lib/contests/types/contest';
 import type { TaskResults } from '$lib/types/task';
 
 import { JagPrelimProvider } from './aoj_jag_providers';

src/features/tasks/utils/contest-table/aoj_jag_providers.ts

@@ -1,4 +1,4 @@
-import { ContestType } from '$lib/types/contest';
+import { ContestType } from '$lib/contests/types/contest';
 import type { TaskResult, TaskResults } from '$lib/types/task';
 import {
   type ContestTableMetaData,

src/features/tasks/utils/contest-table/arc_providers.test.ts

@@ -1,6 +1,6 @@
 import { describe, test, expect } from 'vitest';
 
-import { ContestType } from '$lib/types/contest';
+import { ContestType } from '$lib/contests/types/contest';
 import type { TaskResult, TaskResults } from '$lib/types/task';
 
 import {

src/features/tasks/utils/contest-table/arc_providers.ts

@@ -4,7 +4,7 @@ import {
 } from '$features/tasks/types/contest-table/contest_table_provider';
 import type { TaskResult } from '$lib/types/task';
 
-import { classifyContest, getContestNameLabel } from '$lib/utils/contest';
+import { classifyContest, getContestNameLabel } from '$lib/contests/utils/contest';
 
 import { ContestTableProviderBase, parseContestRound } from './contest_table_provider_base';
 

src/features/tasks/utils/contest-table/awc_provider.test.ts

@@ -1,6 +1,6 @@
 import { describe, test, expect } from 'vitest';
 
-import { ContestType } from '$lib/types/contest';
+import { ContestType } from '$lib/contests/types/contest';
 import type { TaskResults } from '$lib/types/task';
 
 import { AWCRangeProvider, AWCSpecialContestProvider } from './awc_provider';

src/features/tasks/utils/contest-table/awc_provider.ts

@@ -2,10 +2,10 @@ import {
   type ContestTableMetaData,
   type ContestTableDisplayConfig,
 } from '$features/tasks/types/contest-table/contest_table_provider';
-import { ContestType } from '$lib/types/contest';
+import { ContestType } from '$lib/contests/types/contest';
 import type { TaskResult } from '$lib/types/task';
 
-import { classifyContest, getContestNameLabel } from '$lib/utils/contest';
+import { classifyContest, getContestNameLabel } from '$lib/contests/utils/contest';
 
 import { ContestTableProviderBase, parseContestRound } from './contest_table_provider_base';
 

src/features/tasks/utils/contest-table/axc_like_provider.test.ts

@@ -1,6 +1,6 @@
 import { describe, test, expect } from 'vitest';
 
-import { ContestType } from '$lib/types/contest';
+import { ContestType } from '$lib/contests/types/contest';
 import type { TaskResults } from '$lib/types/task';
 
 import { ABCLikeProvider } from './axc_like_provider';

src/features/tasks/utils/contest-table/axc_like_provider.ts

@@ -4,7 +4,7 @@ import {
 } from '$features/tasks/types/contest-table/contest_table_provider';
 import type { TaskResult } from '$lib/types/task';
 
-import { classifyContest } from '$lib/utils/contest';
+import { classifyContest } from '$lib/contests/utils/contest';
 
 import { ContestTableProviderBase } from './contest_table_provider_base';
 

src/features/tasks/utils/contest-table/contest_table_provider_base.test.ts

@@ -1,6 +1,6 @@
 import { describe, test, expect } from 'vitest';
 
-import { ContestType } from '$lib/types/contest';
+import { ContestType } from '$lib/contests/types/contest';
 
 import { ABSProvider } from './contest_table_provider';
 import { taskResultsForABS } from '$features/tasks/fixtures/contest-table/contest_table_provider';

src/features/tasks/utils/contest-table/contest_table_provider_base.ts

@@ -5,7 +5,7 @@ import {
   type ContestTableDisplayConfig,
   type ProviderKey,
 } from '$features/tasks/types/contest-table/contest_table_provider';
-import { ContestType } from '$lib/types/contest';
+import { ContestType } from '$lib/contests/types/contest';
 import type { TaskResults, TaskResult } from '$lib/types/task';
 
 import { getTaskTableHeaderName } from '$lib/utils/task';

src/features/tasks/utils/contest-table/contest_table_provider_group.test.ts

@@ -1,6 +1,6 @@
 import { describe, test, expect } from 'vitest';
 
-import { ContestType } from '$lib/types/contest';
+import { ContestType } from '$lib/contests/types/contest';
 
 import {
   ABSProvider,

src/features/tasks/utils/contest-table/contest_table_provider_group.ts

@@ -1,5 +1,5 @@
 import { type ContestTablesMetaData } from '$features/tasks/types/contest-table/contest_table_provider';
-import { ContestType } from '$lib/types/contest';
+import { ContestType } from '$lib/contests/types/contest';
 
 import { ContestTableProviderBase } from './contest_table_provider_base';
 

src/features/tasks/utils/contest-table/contest_table_provider_groups.test.ts

@@ -1,6 +1,6 @@
 import { describe, test, expect } from 'vitest';
 
-import { ContestType } from '$lib/types/contest';
+import { ContestType } from '$lib/contests/types/contest';
 
 import { TESSOKU_SECTIONS } from '$features/tasks/types/contest-table/contest_table_provider';
 

src/features/tasks/utils/contest-table/contest_table_provider_groups.ts

@@ -1,4 +1,4 @@
-import { ContestType } from '$lib/types/contest';
+import { ContestType } from '$lib/contests/types/contest';
 
 import { ABSProvider } from './abs_provider';
 import {

src/features/tasks/utils/contest-table/dp_providers.test.ts

@@ -1,6 +1,6 @@
 import { describe, test, expect } from 'vitest';
 
-import { ContestType } from '$lib/types/contest';
+import { ContestType } from '$lib/contests/types/contest';
 import type { TaskResults } from '$lib/types/task';
 
 import { EDPCProvider, TDPCProvider, NDPCProvider } from './dp_providers';

src/features/tasks/utils/contest-table/dp_providers.ts

@@ -4,7 +4,7 @@ import {
 } from '$features/tasks/types/contest-table/contest_table_provider';
 import type { TaskResult } from '$lib/types/task';
 
-import { classifyContest } from '$lib/utils/contest';
+import { classifyContest } from '$lib/contests/utils/contest';
 
 import { ContestTableProviderBase } from './contest_table_provider_base';
 

src/features/tasks/utils/contest-table/fps24_provider.test.ts

@@ -1,6 +1,6 @@
 import { describe, test, expect } from 'vitest';
 
-import { ContestType } from '$lib/types/contest';
+import { ContestType } from '$lib/contests/types/contest';
 import type { TaskResults } from '$lib/types/task';
 
 import { FPS24Provider } from './fps24_provider';

src/features/tasks/utils/contest-table/fps24_provider.ts

@@ -4,7 +4,7 @@ import {
 } from '$features/tasks/types/contest-table/contest_table_provider';
 import type { TaskResult } from '$lib/types/task';
 
-import { classifyContest } from '$lib/utils/contest';
+import { classifyContest } from '$lib/contests/utils/contest';
 
 import { ContestTableProviderBase } from './contest_table_provider_base';
 

src/features/tasks/utils/contest-table/joi_providers.test.ts

@@ -1,6 +1,6 @@
 import { describe, test, expect } from 'vitest';
 
-import { ContestType } from '$lib/types/contest';
+import { ContestType } from '$lib/contests/types/contest';
 import type { TaskResults } from '$lib/types/task';
 
 import {
@@ -81,7 +81,7 @@ describe('JOIFirstQualRoundProvider', () => {
   test('expects to handle invalid contest IDs gracefully', () => {
     const provider = new JOIFirstQualRoundProvider(ContestType.JOI);
 
-    expect(provider.getContestRoundLabel('invalid-id')).toBe('INVALID-ID'); // See: getContestNameLabel() in src/lib/utils/contest.ts
+    expect(provider.getContestRoundLabel('invalid-id')).toBe('INVALID-ID'); // See: getContestNameLabel() in src/lib/contests/utils/contest.ts
     expect(provider.getContestRoundLabel('joi2024yo1d')).toBe('2024d'); // 'd' doesn't match valid round (a|b|c)
   });
 

src/features/tasks/utils/contest-table/joi_providers.ts

@@ -4,10 +4,10 @@ import {
   JOI_SECOND_QUAL_ROUND_SECTIONS,
   JOI_FINAL_ROUND_SECTIONS,
 } from '$features/tasks/types/contest-table/contest_table_provider';
-import { ContestType } from '$lib/types/contest';
+import { ContestType } from '$lib/contests/types/contest';
 import type { TaskResult } from '$lib/types/task';
 
-import { classifyContest, getContestNameLabel } from '$lib/utils/contest';
+import { classifyContest, getContestNameLabel } from '$lib/contests/utils/contest';
 
 import { ContestTableProviderBase } from './contest_table_provider_base';
 

src/features/tasks/utils/contest-table/math_and_algorithm_provider.test.ts

@@ -1,6 +1,6 @@
 import { describe, test, expect } from 'vitest';
 
-import { ContestType } from '$lib/types/contest';
+import { ContestType } from '$lib/contests/types/contest';
 import type { TaskResults } from '$lib/types/task';
 
 import { MathAndAlgorithmProvider } from './math_and_algorithm_provider';

src/features/tasks/utils/contest-table/math_and_algorithm_provider.ts

@@ -4,7 +4,7 @@ import {
 } from '$features/tasks/types/contest-table/contest_table_provider';
 import type { TaskResult } from '$lib/types/task';
 
-import { classifyContest } from '$lib/utils/contest';
+import { classifyContest } from '$lib/contests/utils/contest';
 
 import { ContestTableProviderBase } from './contest_table_provider_base';
 

src/features/tasks/utils/contest-table/tessoku_book_providers.test.ts

@@ -1,6 +1,6 @@
 import { describe, test, expect } from 'vitest';
 
-import { ContestType } from '$lib/types/contest';
+import { ContestType } from '$lib/contests/types/contest';
 import type { TaskResults } from '$lib/types/task';
 
 import {

src/features/tasks/utils/contest-table/tessoku_book_providers.ts

@@ -3,10 +3,10 @@ import {
   type ContestTableDisplayConfig,
   TESSOKU_SECTIONS,
 } from '$features/tasks/types/contest-table/contest_table_provider';
-import { ContestType } from '$lib/types/contest';
+import { ContestType } from '$lib/contests/types/contest';
 import type { TaskResult } from '$lib/types/task';
 
-import { classifyContest } from '$lib/utils/contest';
+import { classifyContest } from '$lib/contests/utils/contest';
 
 import { ContestTableProviderBase } from './contest_table_provider_base';
 

src/features/tasks/utils/contest-table/typical90_provider.test.ts

@@ -1,6 +1,6 @@
 import { describe, test, expect } from 'vitest';
 
-import { ContestType } from '$lib/types/contest';
+import { ContestType } from '$lib/contests/types/contest';
 import type { TaskResults } from '$lib/types/task';
 
 import { Typical90Provider } from './typical90_provider';

src/features/tasks/utils/contest-table/typical90_provider.ts

@@ -4,7 +4,7 @@ import {
 } from '$features/tasks/types/contest-table/contest_table_provider';
 import type { TaskResult } from '$lib/types/task';
 
-import { classifyContest } from '$lib/utils/contest';
+import { classifyContest } from '$lib/contests/utils/contest';
 
 import { ContestTableProviderBase } from './contest_table_provider_base';
 

src/features/workbooks/components/detail/WorkBookTasksTable.svelte

@@ -14,7 +14,7 @@
   import GradeLabel from '$lib/components/GradeLabel.svelte';
   import ExternalLinkWrapper from '$lib/components/ExternalLinkWrapper.svelte';
 
-  import { addContestNameToTaskIndex } from '$lib/utils/contest';
+  import { addContestNameToTaskIndex } from '$lib/contests/utils/contest';
   import { getTaskUrl, removeTaskIndexFromTitle } from '$lib/utils/task';
 
   import type {

src/lib/clients/aizu_online_judge/clients.test.ts

@@ -11,7 +11,7 @@ import { Cache } from '$lib/clients/cache';
 
 import { AojCoursesApiClient, AojChallengesApiClient } from './clients';
 
-import type { ContestsForImport } from '$lib/types/contest';
+import type { ContestsForImport } from '$lib/contests/types/contest';
 import type { TasksForImport } from '$lib/types/task';
 import type { AOJCourseAPI, AOJChallengeContestAPI, AOJTaskAPIs } from './types';
 

src/lib/clients/aizu_online_judge/clients.ts

@@ -2,7 +2,7 @@ import { HttpRequestClient } from '$lib/clients/http_client';
 import { ContestTaskCache } from '$lib/clients/cache_strategy';
 import { getCachedOrFetchContests, getCachedOrFetchTasks } from '$lib/clients/contest_task_fetcher';
 
-import type { ContestsForImport } from '$lib/types/contest';
+import type { ContestsForImport } from '$lib/contests/types/contest';
 import type { TasksForImport } from '$lib/types/task';
 
 import type {