@giwonn/claude-daily-review 0.2.3 → 0.3.0

package/docs/superpowers/specs/2026-03-28-no-build-refactor-design.md

@@ -0,0 +1,333 @@
+# No-Build 플러그인 구조 전환 설계 문서
+
+## 1. 개요
+
+TypeScript + tsup 빌드 구조를 제거하고, 순수 `.mjs` + JSDoc 기반으로 전환한다. Claude Code 플러그인 생태계 표준 패턴(빌드 없음, 직접 실행)을 따른다. marketplace.json의 SHA 업데이트를 CI에서 자동화한다.
+
+## 2. 목표
+
+- 빌드 단계 제거 (tsup, typescript 의존성 제거)
+- `.mjs` + JSDoc으로 타입 안전성 유지
+- dist/ 제거, 소스 파일을 직접 실행
+- superpowers 플러그인 패턴 준수 (run-hook.cmd polyglot wrapper)
+- marketplace.json SHA 자동 업데이트 CI 워크플로우
+
+## 3. 파일 구조
+
+### 제거 대상
+
+```
+src/                    ← 전체 제거
+dist/                   ← 전체 제거
+tests/                  ← 전체 제거
+tsconfig.json           ← 제거
+tsup.config.ts          ← 제거
+vitest.config.ts        ← 제거
+```
+
+### 새 구조
+
+```
+claude-daily-review/
+├── .claude-plugin/
+│   └── marketplace.json
+├── .github/
+│   └── workflows/
+│       ├── publish.yml              ← npm publish (기존)
+│       └── update-marketplace.yml   ← SHA 자동 업데이트 (신규)
+├── hooks/
+│   ├── hooks.json
+│   ├── run-hook.cmd                 ← Windows+Unix polyglot wrapper
+│   ├── session-start-check          ← bash 스크립트 (config 체크 + additionalContext)
+│   └── on-stop.mjs                  ← Node.js (raw log append)
+├── lib/
+│   ├── types.d.ts                   ← TypeScript 타입 정의 (JSDoc용)
+│   ├── config.mjs                   ← 설정 관리
+│   ├── storage.mjs                  ← StorageAdapter 인터페이스 구현 (local)
+│   ├── github-storage.mjs           ← GitHubStorageAdapter
+│   ├── github-auth.mjs              ← OAuth Device Flow
+│   └── periods.mjs                  ← 날짜/주기 유틸리티
+├── prompts/
+│   ├── session-end.md
+│   └── session-start.md
+├── skills/
+│   └── daily-review-setup.md
+├── package.json                     ← 최소화 (이름, 버전, type: module)
+├── README.md
+└── README.ko.md
+```
+
+## 4. 모듈별 변환
+
+### 4.1 lib/types.d.ts
+
+JSDoc에서 참조할 타입 정의. 런타임에는 사용되지 않음.
+
+```typescript
+export interface Profile {
+  company: string;
+  role: string;
+  team: string;
+  context: string;
+}
+
+export interface Periods {
+  daily: true;
+  weekly: boolean;
+  monthly: boolean;
+  quarterly: boolean;
+  yearly: boolean;
+}
+
+export interface LocalStorageConfig {
+  basePath: string;
+}
+
+export interface GitHubStorageConfig {
+  owner: string;
+  repo: string;
+  token: string;
+  basePath: string;
+}
+
+export interface StorageConfig {
+  type: "local" | "github";
+  local?: LocalStorageConfig;
+  github?: GitHubStorageConfig;
+}
+
+export interface Config {
+  storage: StorageConfig;
+  language: string;
+  periods: Periods;
+  profile: Profile;
+}
+
+export interface StorageAdapter {
+  read(path: string): Promise<string | null>;
+  write(path: string, content: string): Promise<void>;
+  append(path: string, content: string): Promise<void>;
+  exists(path: string): Promise<boolean>;
+  list(dir: string): Promise<string[]>;
+  mkdir(dir: string): Promise<void>;
+  isDirectory(path: string): Promise<boolean>;
+}
+
+export interface HookInput {
+  session_id: string;
+  transcript_path: string;
+  cwd: string;
+  hook_event_name: string;
+  [key: string]: unknown;
+}
+```
+
+### 4.2 lib/config.mjs
+
+기존 `src/core/config.ts`를 `.mjs` + JSDoc으로 변환.
+
+```javascript
+// @ts-check
+/** @typedef {import('./types.d.ts').Config} Config */
+
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'fs';
+import { dirname, join } from 'path';
+
+/** @returns {string} */
+export function getConfigPath() { ... }
+
+/** @returns {Config | null} */
+export function loadConfig() { ... }
+// ... 동일한 로직, JSDoc 타입 어노테이션만 추가
+```
+
+### 4.3 lib/storage.mjs
+
+`LocalStorageAdapter`를 클래스로 구현.
+
+```javascript
+// @ts-check
+/** @typedef {import('./types.d.ts').StorageAdapter} StorageAdapter */
+
+/** @implements {StorageAdapter} */
+export class LocalStorageAdapter { ... }
+```
+
+### 4.4 lib/github-storage.mjs
+
+`GitHubStorageAdapter`를 클래스로 구현. `fetch` 사용 (Node.js 내장).
+
+### 4.5 lib/github-auth.mjs
+
+OAuth Device Flow. `fetch` 사용.
+
+### 4.6 lib/periods.mjs
+
+날짜/주기 유틸리티. 순수 함수.
+
+### 4.7 hooks/on-stop.mjs
+
+```javascript
+#!/usr/bin/env node
+// stdin → raw log append
+import { loadConfig, createStorageAdapter } from '../lib/config.mjs';
+// ...
+```
+
+### 4.8 hooks/session-start-check
+
+```bash
+#!/usr/bin/env bash
+# superpowers 패턴: config 체크 → additionalContext 주입
+set -euo pipefail
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+PLUGIN_ROOT="$(cd "${SCRIPT_DIR}/.." && pwd)"
+
+# Node.js로 config 체크
+result=$(node -e "
+  import { loadConfig } from '${PLUGIN_ROOT}/lib/config.mjs';
+  const config = loadConfig();
+  if (!config) process.stdout.write('NEEDS_SETUP');
+" 2>/dev/null || echo "NEEDS_SETUP")
+
+if [ "$result" = "NEEDS_SETUP" ]; then
+  msg="<important-reminder>IN YOUR FIRST REPLY YOU MUST TELL THE USER: daily-review 플러그인이 아직 설정되지 않았습니다. /daily-review-setup 을 실행해주세요.</important-reminder>"
+  escaped=$(echo "$msg" | sed 's/\\/\\\\/g; s/"/\\"/g')
+  printf '{"hookSpecificOutput":{"hookEventName":"SessionStart","additionalContext":"%s"}}\n' "$escaped"
+fi
+
+exit 0
+```
+
+### 4.9 hooks/run-hook.cmd
+
+superpowers의 polyglot wrapper를 그대로 복사하여 Windows + Unix 모두 지원.
+
+## 5. hooks/hooks.json
+
+```json
+{
+  "hooks": {
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/on-stop.mjs\"",
+            "async": true,
+            "timeout": 10
+          }
+        ]
+      }
+    ],
+    "SessionEnd": [
+      {
+        "hooks": [
+          {
+            "type": "agent",
+            "prompt": "Follow the instructions in the file at ${CLAUDE_PLUGIN_ROOT}/prompts/session-end.md exactly. The CLAUDE_PLUGIN_DATA directory is: ${CLAUDE_PLUGIN_DATA}. The plugin root is: ${CLAUDE_PLUGIN_ROOT}",
+            "timeout": 120
+          }
+        ]
+      }
+    ],
+    "SessionStart": [
+      {
+        "matcher": "startup",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"${CLAUDE_PLUGIN_ROOT}/hooks/run-hook.cmd\" session-start-check",
+            "timeout": 5
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+## 6. package.json
+
+```json
+{
+  "name": "@giwonn/claude-daily-review",
+  "version": "0.3.0",
+  "type": "module",
+  "description": "Claude Code plugin that auto-captures conversations for daily review and career documentation",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/giwonn/claude-daily-review"
+  },
+  "license": "MIT"
+}
+```
+
+의존성 없음. devDependencies도 없음.
+
+## 7. marketplace.json SHA 자동 업데이트
+
+### 문제
+
+릴리즈마다 marketplace.json의 SHA를 수동으로 업데이트해야 함.
+
+### 해결: GitHub Actions 워크플로우
+
+release 생성 시:
+1. npm publish
+2. marketplace.json의 SHA를 릴리즈 태그의 커밋 SHA로 업데이트
+3. 자동 커밋 + push
+
+```yaml
+# .github/workflows/update-marketplace.yml
+name: Update Marketplace SHA
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  update-sha:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: master
+
+      - name: Update SHA in marketplace.json
+        run: |
+          SHA=$(git rev-parse HEAD)
+          sed -i "s/\"sha\": \"[a-f0-9]*\"/\"sha\": \"$SHA\"/" .claude-plugin/marketplace.json
+
+      - name: Commit and push
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git add .claude-plugin/marketplace.json
+          git commit -m "chore: update marketplace SHA to $SHA" || exit 0
+          git push
+```
+
+### 주의: 순환 방지
+
+marketplace.json 변경 커밋은 릴리즈 태그에 포함되지 않으므로, 다음 릴리즈에서 반영됨. 이는 의도된 동작 — 릴리즈 시점의 코드가 설치되고, SHA는 그 직후 업데이트됨.
+
+## 8. 스코프
+
+### 포함
+
+- TypeScript → .mjs + JSDoc 변환 (config, storage, github-storage, github-auth, periods)
+- Hook 스크립트 변환 (on-stop.mjs, session-start-check bash)
+- run-hook.cmd polyglot wrapper 추가
+- hooks.json 업데이트
+- package.json 최소화 (빌드 의존성 제거)
+- src/, dist/, tests/, tsconfig, tsup, vitest 제거
+- marketplace SHA 자동 업데이트 워크플로우
+- .gitignore 정리
+
+### 제외
+
+- 기능 변경 없음 — 동일한 동작, 다른 구조
+- 테스트 프레임워크 재구축 (플러그인은 수동 테스트가 표준)

package/docs/superpowers/specs/2026-03-28-storage-adapter-refactor-design.md

@@ -0,0 +1,365 @@
+# StorageAdapter 추상화 + GitHub 연동 설계 문서
+
+## 1. 개요
+
+기존 claude-daily-review 플러그인의 외부 저장소 의존성(fs)을 `StorageAdapter` 인터페이스로 추상화하고, GitHub를 저장소 백엔드로 추가한다. 사용자는 셋업 시 로컬 파일시스템 또는 GitHub 중 선택할 수 있다.
+
+## 2. 목표
+
+- 외부 저장소 의존성을 인터페이스로 추상화 (DIP)
+- GitHub Contents API 기반 저장소 어댑터 추가
+- GitHub OAuth Device Flow로 사용자 인증 (우리 OAuth App의 client_id 사용)
+- GitHub repo 자동 생성 또는 기존 repo 지정 지원
+- 기존 로컬 저장소 기능 유지
+- 기존 테스트 async 전환 및 유지
+
+## 3. StorageAdapter 인터페이스
+
+```typescript
+export interface StorageAdapter {
+  read(path: string): Promise<string | null>;
+  write(path: string, content: string): Promise<void>;
+  append(path: string, content: string): Promise<void>;
+  exists(path: string): Promise<boolean>;
+  list(dir: string): Promise<string[]>;
+  mkdir(dir: string): Promise<void>;
+  isDirectory(path: string): Promise<boolean>;
+}
+```
+
+모든 경로는 storage root 기준 상대 경로. 예: `daily/2026-03-28.md`, `.raw/sess-1/2026-03-28.jsonl`
+
+## 4. 구현체
+
+### 4.1 LocalStorageAdapter
+
+기존 fs 코드를 StorageAdapter 인터페이스로 감싼다.
+
+```typescript
+export class LocalStorageAdapter implements StorageAdapter {
+  constructor(private basePath: string) {}
+  // fs 함수들을 async wrapper로 구현
+}
+```
+
+| 메서드 | 구현 |
+|--------|------|
+| `read(path)` | `readFileSync(resolve(basePath, path))` — 파일 없으면 `null` 반환 |
+| `write(path, content)` | `mkdirSync` + `writeFileSync` |
+| `append(path, content)` | `mkdirSync` + `appendFileSync` |
+| `exists(path)` | `existsSync` |
+| `list(dir)` | `readdirSync` — 디렉토리 없으면 `[]` |
+| `mkdir(dir)` | `mkdirSync({ recursive: true })` |
+| `isDirectory(path)` | `statSync().isDirectory()` — 에러 시 `false` |
+
+### 4.2 GitHubStorageAdapter
+
+GitHub Contents API를 사용한다.
+
+```typescript
+export class GitHubStorageAdapter implements StorageAdapter {
+  constructor(private owner: string, private repo: string, private token: string, private basePath: string) {}
+}
+```
+
+| 메서드 | GitHub API |
+|--------|------------|
+| `read(path)` | `GET /repos/{owner}/{repo}/contents/{basePath}/{path}` — base64 디코드, 404면 `null` |
+| `write(path, content)` | `PUT /repos/{owner}/{repo}/contents/{basePath}/{path}` — 기존 파일이면 SHA 포함 |
+| `append(path, content)` | `read` → 기존 내용 + content → `write` (SHA 기반 업데이트) |
+| `exists(path)` | `GET` 후 200이면 `true`, 404면 `false` |
+| `list(dir)` | `GET /repos/{owner}/{repo}/contents/{basePath}/{dir}` — 배열 응답에서 name 추출 |
+| `mkdir(dir)` | no-op (GitHub는 디렉토리 개념 없음, 파일 생성 시 자동 생성) |
+| `isDirectory(path)` | `GET` 후 응답이 배열이면 `true` |
+
+### SHA 관리
+
+GitHub Contents API는 파일 업데이트 시 현재 SHA가 필요하다. GitHubStorageAdapter 내부에서:
+1. `write`/`append` 호출 시 먼저 `GET`으로 현재 SHA 취득
+2. SHA와 함께 `PUT` 요청
+3. 409 Conflict 발생 시 SHA 재취득 후 재시도 (최대 3회)
+
+### Rate Limit 고려
+
+- GitHub API: 인증된 요청 시간당 5,000회
+- Stop 훅은 async라 응답마다 1회 호출 — 하루 수백 회 수준으로 충분
+- 주기별 요약은 SessionStart에서 몇 회 호출 — 무시할 수준
+
+## 5. GitHub OAuth Device Flow
+
+### 흐름
+
+```
+1. POST https://github.com/login/device/code
+   Body: { client_id: "OUR_CLIENT_ID", scope: "repo" }
+   Response: { device_code, user_code, verification_uri, interval }
+
+2. 사용자에게 표시:
+   "https://github.com/login/device 에 접속해서 코드 ABCD-1234 를 입력하세요"
+
+3. Polling (interval 간격):
+   POST https://github.com/login/oauth/access_token
+   Body: { client_id, device_code, grant_type: "urn:ietf:params:oauth:grant-type:device_code" }
+
+   - "authorization_pending" → 계속 polling
+   - "slow_down" → interval 증가 후 계속
+   - 200 + access_token → 완료
+
+4. 토큰을 config에 저장
+```
+
+### client_id
+
+코드에 상수로 포함. OAuth App은 GitHub에 "claude-daily-review"로 등록.
+
+```typescript
+const GITHUB_CLIENT_ID = "Ov23li..."; // 실제 등록 후 값
+```
+
+참고: Device Flow는 public client이므로 client_secret 불필요.
+
+### Scope
+
+`repo` — private repo 접근 필요. public repo만 지원하려면 `public_repo`로 축소 가능하나, 사용자 편의를 위해 `repo` 사용.
+
+## 6. GitHub Repo 설정
+
+### 셋업 플로우
+
+```
+/daily-review-setup
+→ storage 선택: "local" / "github"
+
+[github 선택 시]
+→ OAuth Device Flow 인증
+→ "기존 repo를 사용할까요, 새로 만들까요?"
+  → 기존: repo 이름 입력 (owner/repo)
+  → 새로: repo 이름 입력 → POST /user/repos로 생성 (private)
+→ basePath 설정 (기본: "daily-review")
+→ 완료
+```
+
+### Repo 생성 API
+
+```
+POST /user/repos
+Body: {
+  name: "daily-review",
+  private: true,
+  description: "Auto-generated daily review by claude-daily-review"
+}
+```
+
+## 7. 설정 스키마 변경
+
+### 기존
+
+```json
+{
+  "vaultPath": "/path/to/vault",
+  "reviewFolder": "daily-review",
+  ...
+}
+```
+
+### 변경 후
+
+```json
+{
+  "storage": {
+    "type": "local",
+    "local": {
+      "basePath": "/path/to/vault/daily-review"
+    }
+  },
+  "language": "ko",
+  "periods": {
+    "daily": true,
+    "weekly": true,
+    "monthly": true,
+    "quarterly": true,
+    "yearly": false
+  },
+  "profile": {
+    "company": "ABC Corp",
+    "role": "프론트엔드 개발자",
+    "team": "결제플랫폼팀",
+    "context": "B2B SaaS 결제 시스템 개발 및 운영"
+  }
+}
+```
+
+또는 GitHub:
+
+```json
+{
+  "storage": {
+    "type": "github",
+    "github": {
+      "owner": "username",
+      "repo": "daily-review",
+      "token": "gho_xxx",
+      "basePath": "daily-review"
+    }
+  },
+  "language": "ko",
+  "periods": { ... },
+  "profile": { ... }
+}
+```
+
+`vaultPath`와 `reviewFolder`는 `storage.local.basePath`로 통합. 기존 config가 있으면 마이그레이션 지원.
+
+## 8. 변경 대상 모듈
+
+### 변경 필요
+
+| 모듈 | 변경 내용 |
+|------|-----------|
+| `src/core/storage.ts` | **신규.** StorageAdapter 인터페이스 정의 |
+| `src/core/local-storage.ts` | **신규.** LocalStorageAdapter 구현 |
+| `src/core/github-storage.ts` | **신규.** GitHubStorageAdapter 구현 |
+| `src/core/github-auth.ts` | **신규.** OAuth Device Flow 구현 |
+| `src/core/config.ts` | 설정 스키마 변경 + 어댑터 팩토리 함수 |
+| `src/core/vault.ts` | fs 직접 사용 → StorageAdapter 주입, async 전환 |
+| `src/core/raw-logger.ts` | fs 직접 사용 → StorageAdapter 주입, async 전환 |
+| `src/core/merge.ts` | fs 직접 사용 → StorageAdapter 주입, async 전환 |
+| `src/hooks/on-stop.ts` | adapter 생성 후 주입, async 전환 |
+| `prompts/session-end.md` | 에이전트가 storage type에 따라 다르게 동작하도록 안내 |
+| `prompts/session-start.md` | 동일 |
+| `skills/daily-review-setup.md` | storage 선택 + GitHub 인증 플로우 추가 |
+
+### 변경 없음
+
+| 모듈 | 이유 |
+|------|------|
+| `src/core/periods.ts` | 순수 계산, 외부 의존 없음 |
+| `hooks/hooks.json` | 훅 설정 자체는 동일 |
+
+## 9. async 전환
+
+StorageAdapter의 모든 메서드가 `Promise`를 반환하므로, 이를 사용하는 모든 함수가 async로 전환된다.
+
+### 영향 범위
+
+```typescript
+// Before (sync)
+export function appendRawLog(sessionDir: string, date: string, entry: HookInput): void
+
+// After (async)
+export async function appendRawLog(storage: StorageAdapter, sessionDir: string, date: string, entry: HookInput): Promise<void>
+```
+
+| 함수 | 변경 |
+|------|------|
+| `vault.ensureVaultDirectories(config)` | `ensureVaultDirectories(storage, config)` async |
+| `rawLogger.appendRawLog(dir, date, entry)` | `appendRawLog(storage, dir, date, entry)` async |
+| `merge.findUnprocessedSessions(dir)` | `findUnprocessedSessions(storage, dir)` async |
+| `merge.findPendingReviews(dir)` | `findPendingReviews(storage, dir)` async |
+| `merge.markSessionCompleted(dir)` | `markSessionCompleted(storage, dir)` async |
+| `merge.isSessionCompleted(dir)` | `isSessionCompleted(storage, dir)` async |
+| `merge.mergeReviewsIntoDaily(paths, daily)` | `mergeReviewsIntoDaily(storage, paths, daily)` async |
+| `onStop.handleStopHook(stdin)` | `handleStopHook(stdin)` async |
+
+vault의 경로 생성 함수들(getDailyPath 등)은 순수 문자열 연산이므로 변경 없음.
+
+## 10. 테스트 전략
+
+### LocalStorageAdapter 테스트
+
+기존 테스트를 async로 전환 + StorageAdapter를 통해 호출하도록 수정. 실질적 동작은 동일.
+
+### GitHubStorageAdapter 테스트
+
+GitHub API를 직접 호출하지 않고, HTTP 요청을 mock하여 테스트.
+
+```typescript
+// fetch를 mock하여 GitHub API 응답 시뮬레이션
+vi.spyOn(globalThis, "fetch").mockImplementation(...)
+```
+
+테스트 케이스:
+- read: 정상 응답 (base64 디코드), 404 → null
+- write: 새 파일 생성 (SHA 없음), 기존 파일 업데이트 (SHA 포함)
+- append: read + write 조합
+- exists: 200 → true, 404 → false
+- list: 배열 응답에서 name 추출
+- write 409 conflict → SHA 재취득 후 재시도
+
+### GitHub Auth 테스트
+
+Device Flow의 각 단계를 fetch mock으로 테스트:
+- device code 요청 성공
+- polling: authorization_pending → 재시도
+- polling: slow_down → interval 증가
+- polling: 성공 → 토큰 반환
+- polling: 타임아웃
+
+### 코어 모듈 테스트
+
+vault, raw-logger, merge 테스트는 StorageAdapter mock을 주입하여 테스트. 실제 fs 의존 없이 순수 로직만 검증.
+
+추가로 LocalStorageAdapter를 사용한 통합 테스트도 유지.
+
+## 11. 에이전트 프롬프트 변경
+
+SessionEnd/SessionStart 에이전트는 파일을 직접 Read/Write 도구로 조작한다. GitHub storage인 경우:
+- 에이전트가 config에서 storage type 확인
+- `type: "local"` → 기존대로 Read/Write 도구 사용
+- `type: "github"` → Bash 도구로 `node` 스크립트 호출하여 GitHub API 사용
+
+이를 위해 에이전트가 호출할 수 있는 CLI 유틸리티 스크립트를 추가:
+
+```bash
+# 파일 읽기
+node dist/cli/storage-read.js <path>
+
+# 파일 쓰기 (stdin으로 content)
+echo "content" | node dist/cli/storage-write.js <path>
+
+# 파일 목록
+node dist/cli/storage-list.js <dir>
+```
+
+이 스크립트들은 config에서 storage type을 읽고 적절한 어댑터를 사용한다.
+
+## 12. Config 마이그레이션
+
+기존 config 형식(`vaultPath` + `reviewFolder`)이 감지되면 자동 마이그레이션:
+
+```typescript
+function migrateConfig(old: OldConfig): Config {
+  return {
+    storage: {
+      type: "local",
+      local: {
+        basePath: join(old.vaultPath, old.reviewFolder),
+      },
+    },
+    language: old.language,
+    periods: old.periods,
+    profile: old.profile,
+  };
+}
+```
+
+## 13. 스코프
+
+### 이번 스코프
+
+- StorageAdapter 인터페이스 정의
+- LocalStorageAdapter 구현
+- GitHubStorageAdapter 구현
+- GitHub OAuth Device Flow 구현
+- 코어 모듈 리팩토링 (StorageAdapter 주입, async 전환)
+- 에이전트용 CLI 스크립트 (storage-read, storage-write, storage-list)
+- 설정 스키마 변경 + 마이그레이션
+- 셋업 스킬 업데이트 (storage 선택 + GitHub 인증)
+- 에이전트 프롬프트 업데이트
+- 테스트 전면 수정
+
+### 제외
+
+- GitHub App 서버 사이드 (불필요 — Device Flow는 serverless)
+- 실제 OAuth App 등록 (구현 후 별도 진행)
+- GitHub Pages 연동