fix: restore rigorous end.md + fill real Gitea/Vikunja tokens

2026-03-08 08:16:03 +09:00
parent 19795bd7ac
commit 6d7b120fab
6 changed files with 56 additions and 46 deletions
--- a/.agents/workflows/check-gitea.md
+++ b/.agents/workflows/check-gitea.md
@@ -12,15 +12,15 @@ description: Gitea API로 저장소 커밋/이슈/PR 현황을 조회하는 워

 1. 최근 커밋 조회 (최신 10개):
 ```powershell
-$h = @{Authorization="token {{GITEA_TOKEN}}"}
-$commits = Invoke-RestMethod -Uri "{{GITEA_BASE_URL}}/api/v1/repos/{{GITEA_OWNER}}/{{GITEA_REPO}}/commits?limit=10&sha=main" -Headers $h
+$h = @{Authorization="token 3a01b4b15a39921572e64c413353e870d4d2161b"}
+$commits = Invoke-RestMethod -Uri "https://git.variet.net/api/v1/repos/Variet/{{GITEA_REPO}}/commits?limit=10&sha=main" -Headers $h
 $commits | ForEach-Object { Write-Host "$($_.sha.Substring(0,7)) $($_.commit.message.Split("`n")[0])" }
 ```

 2. 열린 이슈 조회:
 ```powershell
-$h = @{Authorization="token {{GITEA_TOKEN}}"}
-$issues = Invoke-RestMethod -Uri "{{GITEA_BASE_URL}}/api/v1/repos/{{GITEA_OWNER}}/{{GITEA_REPO}}/issues?state=open&type=issues" -Headers $h
+$h = @{Authorization="token 3a01b4b15a39921572e64c413353e870d4d2161b"}
+$issues = Invoke-RestMethod -Uri "https://git.variet.net/api/v1/repos/Variet/{{GITEA_REPO}}/issues?state=open&type=issues" -Headers $h
 $issues | ForEach-Object { Write-Host "#$($_.number) $($_.title)" }
 ```

--- a/.agents/workflows/end.md
+++ b/.agents/workflows/end.md
@@ -30,30 +30,44 @@ description: 세션 종료 시 학습 기록 + Vikunja 동기화 + git commit (

 ### 1-1. 커밋 전수 검사

-이번 세션의 모든 커밋을 확인하고 Vikunja에 매핑:
+이번 세션의 **모든 커밋을 하나씩 검사**하고 Vikunja에 매핑합니다.
+누락 없이 모든 커밋을 처리해야 합니다.

 ```powershell
 git log --oneline -20
 ```

+각 커밋에 대해 아래 표를 기준으로 판단합니다:
+
 | 커밋 유형 | Vikunja 액션 |
 |-----------|-------------|
-| 기존 태스크 해당 작업 완료 | `python .agents\workflows\helpers\vikunja_helper.py done {ID}` |
+| 기존 태스크 해당 작업 **완료** | `python .agents\workflows\helpers\vikunja_helper.py done {ID}` |
 | 신규 작업 완료 (기존 태스크 없음) | `python .agents\workflows\helpers\vikunja_helper.py create "제목" "설명" --done --labels Backend,Priority:High` |
-| 작업 중 발견된 미완료 TODO | `python .agents\workflows\helpers\vikunja_helper.py create "제목" "설명" --labels Backend,Priority:Mid` |
+| 작업 중 발견된 **미완료 TODO** | `python .agents\workflows\helpers\vikunja_helper.py create "제목" "설명" --labels Backend,Priority:Mid` |
+
+> [!IMPORTANT]
+> - 커밋 1개 = Vikunja 액션 1개 이상 대응
+> - 여러 커밋이 같은 태스크에 해당하면 마지막 커밋에서 `done` 처리
+> - 매핑할 기존 태스크를 모르면 먼저 `list todo`로 조회

 ### 1-2. Wiki 동기화 (해당 시에만)

+코드 변경이 아키텍처에 영향을 주는 경우 Wiki를 업데이트합니다:
+
 | 코드 변경 | 대상 Wiki |
 |-----------|----------|
-| 서버 변경 | Architecture |
-| 프론트엔드 변경 | Architecture |
-| 새 모듈 추가 | Architecture |
+| 서버 변경 (새 API, 모듈) | Architecture |
+| 프론트엔드 변경 (새 컴포넌트) | Architecture |
+| 인프라 변경 (Docker, CI/CD) | Architecture |
+| 새 모듈/패키지 추가 | Architecture |

 ```powershell
 python .agents\workflows\helpers\wiki_helper.py update "Architecture" /tmp/wiki_content.md
 ```

+> [!TIP]
+> Wiki 내용은 먼저 `read`로 기존 내용을 확인한 후, 수정된 전체 내용을 파일로 만들어 `update`합니다.
+
 ## 2. Git Commit & Push

 ```powershell
@@ -77,8 +91,11 @@ scope: (선택 — 모듈명 등)

 ## 3. 최종 체크리스트

- [ ] known-issues 업데이트 완료
- [ ] Vikunja 태스크 생성/완료 처리됨
- [ ] Wiki 동기화됨 (해당 시)
+> [!WARNING]
+> 아래 항목 중 하나라도 누락되면 세션 종료를 완료할 수 없습니다.
+
+- [ ] known-issues 업데이트 완료 (새 이슈가 있었다면)
+- [ ] Vikunja 태스크 생성/완료 처리됨 (커밋 전수 검사 기반)
+- [ ] Wiki 동기화됨 (아키텍처 변경이 있었다면)
 - [ ] git push 완료
 - [ ] 사용자에게 완료 보고
--- a/.agents/workflows/helpers/vikunja_helper.py
+++ b/.agents/workflows/helpers/vikunja_helper.py
@@ -25,11 +25,11 @@ if sys.stdout.encoding != "utf-8":
    sys.stdout = io.TextIOWrapper(sys.stdout.buffer, encoding="utf-8", errors="replace")

 # ============================================================
-# ⚙️ CONFIGURATION — Change these values for your project
+# ⚙️ CONFIGURATION — PROJECT_ID만 프로젝트별로 변경하세요
 # ============================================================
-API_BASE = "{{VIKUNJA_BASE_URL}}/api/v1"      # e.g. "https://plan.variet.net/api/v1"
-TOKEN = "{{VIKUNJA_TOKEN}}"                     # e.g. "tk_070f8e0b..."
-PROJECT_ID = 0                                  # e.g. 9
+API_BASE = "https://plan.variet.net/api/v1"
+TOKEN = "tk_070f8e0b715e818bb7178c3815ed5389040eddca"
+PROJECT_ID = 0                                  # ← 프로젝트별 변경 필요 (e.g. 9)
 # ============================================================

 HEADERS = {
--- a/.agents/workflows/helpers/wiki_helper.py
+++ b/.agents/workflows/helpers/wiki_helper.py
@@ -11,12 +11,12 @@ import sys, io, json, base64, urllib.request, urllib.error
 sys.stdout = io.TextIOWrapper(sys.stdout.buffer, encoding='utf-8')

 # ============================================================
-# ⚙️ CONFIGURATION — Change these values for your project
+# ⚙️ CONFIGURATION — GITEA_REPO만 프로젝트별로 변경하세요
 # ============================================================
-GITEA_BASE_URL = "{{GITEA_BASE_URL}}"           # e.g. "https://git.variet.net"
-GITEA_OWNER = "{{GITEA_OWNER}}"                  # e.g. "Variet"
-GITEA_REPO = "{{GITEA_REPO}}"                    # e.g. "gravity_web"
-GITEA_TOKEN = "{{GITEA_TOKEN}}"                  # e.g. "3a01b4b1..."
+GITEA_BASE_URL = "https://git.variet.net"
+GITEA_OWNER = "Variet"
+GITEA_REPO = "{{GITEA_REPO}}"                    # ← 프로젝트별 변경 필요
+GITEA_TOKEN = "3a01b4b15a39921572e64c413353e870d4d2161b"
 # ============================================================

 BASE = f"{GITEA_BASE_URL}/api/v1/repos/{GITEA_OWNER}/{GITEA_REPO}/wiki"
--- a/.agents/workflows/services.md
+++ b/.agents/workflows/services.md
@@ -5,37 +5,35 @@ description: 프로젝트 연동 서비스 URL, API 키, 프로젝트 정보 참
 # 서비스 연동 정보

 > [!CAUTION]
-> 이 파일에는 API 토큰이 포함되어 있습니다. `.gitignore`에 `.agents/` 추가를 검토하세요.
+> 이 파일에는 API 토큰이 포함되어 있습니다. 프라이빗 레포에서만 사용하세요.

 ## 로컬 환경

 | 항목 | 값 |
 |------|-----|
 | **Node.js** | 시스템 설치 (`node`, `npm`) |
-| **Python (helper)** | `{{PYTHON_PATH}}` |
-| **프로젝트 루트** | `{{PROJECT_ROOT}}` |
+| **Python (helper)** | 시스템 설치 또는 conda 환경 |
 | **Shell** | PowerShell (`curl` = `Invoke-WebRequest` 별칭이므로 반드시 **`curl.exe`** 사용) |
-| **서버 실행** | `{{SERVER_START_COMMAND}}` |

 ## Gitea (Git Repository)

 | 항목 | 값 |
 |------|-----|
-| **Base URL** | `{{GITEA_BASE_URL}}` |
-| **API Base** | `{{GITEA_BASE_URL}}/api/v1` |
-| **Repo** | `{{GITEA_OWNER}}/{{GITEA_REPO}}` |
-| **Token** | `{{GITEA_TOKEN}}` |
-| **Auth Header** | `-H "Authorization: token {{GITEA_TOKEN}}"` |
+| **Base URL** | `https://git.variet.net` |
+| **API Base** | `https://git.variet.net/api/v1` |
+| **Repo** | `Variet/{{GITEA_REPO}}` |
+| **Token** | `3a01b4b15a39921572e64c413353e870d4d2161b` |
+| **Auth Header** | `-H "Authorization: token 3a01b4b15a39921572e64c413353e870d4d2161b"` |

 ## Vikunja (Task Management)

 | 항목 | 값 |
 |------|-----|
-| **Base URL** | `{{VIKUNJA_BASE_URL}}` |
-| **API Base** | `{{VIKUNJA_BASE_URL}}/api/v1` |
+| **Base URL** | `https://plan.variet.net` |
+| **API Base** | `https://plan.variet.net/api/v1` |
 | **Project ID** | `{{VIKUNJA_PROJECT_ID}}` |
-| **Token** | `{{VIKUNJA_TOKEN}}` |
-| **Auth Header** | `-H "Authorization: Bearer {{VIKUNJA_TOKEN}}"` |
+| **Token** | `tk_070f8e0b715e818bb7178c3815ed5389040eddca` |
+| **Auth Header** | `-H "Authorization: Bearer tk_070f8e0b715e818bb7178c3815ed5389040eddca"` |

 ## Vikunja 태스크 조회

@@ -50,7 +48,8 @@ python .agents\workflows\helpers\vikunja_helper.py list todo

 | 서비스 | URL | 용도 |
 |--------|-----|------|
-| {{SERVICE_NAME}} | {{SERVICE_URL}} | {{SERVICE_PURPOSE}} |
+| Uptime Kuma | `https://status.variet.net` | 서비스 모니터링 |
+| Authentik | `https://auth.variet.net` | SSO 인증 |

 ## AI 작업 프로토콜