Variet Agent
c9068cdf1c
- fix: apscheduler 누락 의존성 설치 - fix(main): StreamHandler cp949 UnicodeEncodeError 수정 (UTF-8 강제) - fix: workspaces.json 경로 Certes→Variet-Worker 수정 - fix(gemini): MCP issues detected 노이즈 필터 추가 - fix(bot): on_command_error 핸들러 추가 (CommandNotFound 로그 오염 방지) - feat(vikunja): projects 커맨드 (전체 프로젝트 목록+태스크 통계) - feat(vikunja): report 커맨드 (태스크+git log+devlog 종합 현황) - docs(agent): Vikunja 도구 섹션 확장 (12개 커맨드+라벨 가이드) - docs: known-issues 2건 추가, devlog 세션 1 기록
329 lines
12 KiB
Python
329 lines
12 KiB
Python
"""Vikunja safe task updater — preserves existing fields when updating tasks.
|
|
|
|
Usage:
|
|
python vikunja_helper.py done 75 # Mark task #75 as done
|
|
python vikunja_helper.py done 71 77 78 # Mark multiple tasks done
|
|
python vikunja_helper.py undone 75 # Mark task #75 as not done
|
|
python vikunja_helper.py comment 75 "text" # Add comment to task #75
|
|
python vikunja_helper.py desc 75 "text" # Set description (appends if exists)
|
|
python vikunja_helper.py create "title" "desc" --labels Backend,Priority:High
|
|
python vikunja_helper.py create "title" "desc" --done --labels Frontend,Priority:Mid
|
|
python vikunja_helper.py label 75 Backend Priority:High # Add labels to task
|
|
python vikunja_helper.py list # List all tasks
|
|
python vikunja_helper.py list todo # List TODO only
|
|
python vikunja_helper.py list done # List DONE only
|
|
python vikunja_helper.py projects # List all Vikunja projects
|
|
python vikunja_helper.py report # Project status report (current)
|
|
python vikunja_helper.py report <project_id> # Project status report (specific)
|
|
"""
|
|
|
|
import sys
|
|
import json
|
|
import urllib.request
|
|
import urllib.error
|
|
import io
|
|
|
|
# Fix Windows console encoding (cp949 → utf-8)
|
|
if sys.stdout.encoding != "utf-8":
|
|
sys.stdout = io.TextIOWrapper(sys.stdout.buffer, encoding="utf-8", errors="replace")
|
|
|
|
# ============================================================
|
|
# ⚙️ CONFIGURATION — PROJECT_ID만 프로젝트별로 변경하세요
|
|
# ============================================================
|
|
API_BASE = "https://plan.variet.net/api/v1"
|
|
TOKEN = "tk_070f8e0b715e818bb7178c3815ed5389040eddca"
|
|
PROJECT_ID = 7 # Variet Agent 프로젝트
|
|
# ============================================================
|
|
|
|
HEADERS = {
|
|
"Authorization": f"Bearer {TOKEN}",
|
|
"Content-Type": "application/json",
|
|
}
|
|
|
|
# Label name → Vikunja label ID mapping
|
|
# Customize for your project's labels
|
|
LABEL_MAP = {
|
|
"Backend": 1, "Frontend": 2, "Engine": 3, "Infra": 4, "Test": 5,
|
|
"Priority:High": 6, "Priority:Mid": 7, "Priority:Low": 8,
|
|
"Agent": 17, "Tool": 18, "AI/LLM": 19,
|
|
}
|
|
|
|
|
|
def api_get(path: str):
|
|
req = urllib.request.Request(f"{API_BASE}{path}", headers=HEADERS)
|
|
with urllib.request.urlopen(req) as resp:
|
|
return json.loads(resp.read().decode("utf-8"))
|
|
|
|
|
|
def api_post(path: str, data: dict):
|
|
body = json.dumps(data).encode("utf-8")
|
|
req = urllib.request.Request(f"{API_BASE}{path}", data=body, headers=HEADERS, method="POST")
|
|
with urllib.request.urlopen(req) as resp:
|
|
return json.loads(resp.read().decode("utf-8"))
|
|
|
|
|
|
def api_put(path: str, data: dict):
|
|
body = json.dumps(data).encode("utf-8")
|
|
req = urllib.request.Request(f"{API_BASE}{path}", data=body, headers=HEADERS, method="PUT")
|
|
with urllib.request.urlopen(req) as resp:
|
|
return json.loads(resp.read().decode("utf-8"))
|
|
|
|
|
|
def get_task(task_id: int) -> dict:
|
|
return api_get(f"/tasks/{task_id}")
|
|
|
|
|
|
def safe_update_task(task_id: int, updates: dict) -> dict:
|
|
task = get_task(task_id)
|
|
safe_body = {
|
|
"title": task.get("title", ""),
|
|
"description": task.get("description", ""),
|
|
"priority": task.get("priority", 0),
|
|
"done": task.get("done", False),
|
|
}
|
|
safe_body.update(updates)
|
|
return api_post(f"/tasks/{task_id}", safe_body)
|
|
|
|
|
|
def mark_done(task_ids: list):
|
|
for tid in task_ids:
|
|
result = safe_update_task(tid, {"done": True})
|
|
title = result.get("title", "?")
|
|
print(f" ✅ #{tid} → done=True [{title}]")
|
|
|
|
|
|
def mark_undone(task_ids: list):
|
|
for tid in task_ids:
|
|
result = safe_update_task(tid, {"done": False})
|
|
title = result.get("title", "?")
|
|
print(f" ⬜ #{tid} → done=False [{title}]")
|
|
|
|
|
|
def add_comment(task_id: int, comment: str):
|
|
result = api_put(f"/tasks/{task_id}/comments", {"comment": comment})
|
|
print(f" 💬 #{task_id} comment added (id={result.get('id', '?')})")
|
|
|
|
|
|
def set_description(task_id: int, desc: str, append: bool = True):
|
|
task = get_task(task_id)
|
|
existing = task.get("description", "") or ""
|
|
if append and existing:
|
|
new_desc = existing.rstrip() + "\n\n" + desc
|
|
else:
|
|
new_desc = desc
|
|
result = safe_update_task(task_id, {"description": new_desc})
|
|
print(f" 📝 #{task_id} description updated [{result.get('title', '?')}]")
|
|
|
|
|
|
def list_tasks(filter_: str = "all"):
|
|
all_tasks = []
|
|
page = 1
|
|
while True:
|
|
batch = api_get(f"/projects/{PROJECT_ID}/tasks?per_page=50&page={page}")
|
|
if not batch:
|
|
break
|
|
all_tasks.extend(batch)
|
|
if len(batch) < 50:
|
|
break
|
|
page += 1
|
|
|
|
if filter_ == "todo":
|
|
all_tasks = [t for t in all_tasks if not t["done"]]
|
|
elif filter_ == "done":
|
|
all_tasks = [t for t in all_tasks if t["done"]]
|
|
|
|
all_tasks.sort(key=lambda t: t["id"])
|
|
for t in all_tasks:
|
|
status = "✅" if t["done"] else "⬜"
|
|
desc = (t.get("description") or "")[:50].replace("\n", " ")
|
|
labels = ", ".join(l["title"] for l in (t.get("labels") or []))
|
|
print(f" {status} #{t['id']:3d} {t['title'][:40]:<40} [{labels}] {desc}")
|
|
print(f"\n Total: {len(all_tasks)} tasks")
|
|
|
|
|
|
def add_labels(task_id: int, label_names: list):
|
|
for name in label_names:
|
|
label_id = LABEL_MAP.get(name)
|
|
if not label_id:
|
|
print(f" ⚠️ Unknown label '{name}'. Valid: {', '.join(LABEL_MAP.keys())}")
|
|
continue
|
|
try:
|
|
api_put(f"/tasks/{task_id}/labels", {"label_id": label_id})
|
|
print(f" 🏷️ #{task_id} + {name} (id={label_id})")
|
|
except Exception as e:
|
|
if "already" in str(e).lower() or "409" in str(e):
|
|
print(f" 🏷️ #{task_id} already has {name}")
|
|
else:
|
|
print(f" ⚠️ #{task_id} label {name} failed: {e}")
|
|
|
|
|
|
def create_task(title: str, description: str = "", done: bool = False, labels: list = None):
|
|
payload = {"title": title, "description": description}
|
|
result = api_put(f"/projects/{PROJECT_ID}/tasks", payload)
|
|
task_id = result["id"]
|
|
print(f" ✨ #{task_id} created: {result.get('title', '?')}")
|
|
|
|
if labels:
|
|
add_labels(task_id, labels)
|
|
|
|
if done:
|
|
result = safe_update_task(task_id, {"done": True})
|
|
print(f" ✅ #{task_id} → done=True")
|
|
|
|
return result
|
|
|
|
|
|
def list_projects():
|
|
"""Vikunja 전체 프로젝트 목록 + 태스크 통계."""
|
|
projects = api_get("/projects")
|
|
print("📂 프로젝트 목록:")
|
|
for p in projects:
|
|
pid = p["id"]
|
|
title = p["title"]
|
|
# 각 프로젝트의 태스크 수 조회
|
|
try:
|
|
tasks = api_get(f"/projects/{pid}/tasks?per_page=200")
|
|
todo = sum(1 for t in tasks if not t["done"])
|
|
done = sum(1 for t in tasks if t["done"])
|
|
print(f" #{pid:<3d} {title:<30s} TODO: {todo} DONE: {done}")
|
|
except Exception:
|
|
print(f" #{pid:<3d} {title:<30s} (조회 실패)")
|
|
print(f"\n Total: {len(projects)} projects")
|
|
|
|
|
|
def report(project_id: int = None):
|
|
"""프로젝트 종합 현황 보고 (태스크 + git log + devlog)."""
|
|
import subprocess
|
|
from pathlib import Path
|
|
from datetime import datetime, timedelta
|
|
|
|
pid = project_id or PROJECT_ID
|
|
|
|
# 1) 프로젝트 이름 조회
|
|
try:
|
|
projects = api_get("/projects")
|
|
proj_name = next((p["title"] for p in projects if p["id"] == pid), f"Project #{pid}")
|
|
except Exception:
|
|
proj_name = f"Project #{pid}"
|
|
|
|
print(f"=== 프로젝트 현황: {proj_name} (#{pid}) ===")
|
|
|
|
# 2) 태스크 현황
|
|
try:
|
|
tasks = api_get(f"/projects/{pid}/tasks?per_page=200")
|
|
todo_tasks = [t for t in tasks if not t["done"]]
|
|
done_tasks = [t for t in tasks if t["done"]]
|
|
total = len(tasks)
|
|
rate = f"{len(done_tasks)/total*100:.0f}%" if total else "N/A"
|
|
|
|
print(f"\n[태스크]")
|
|
print(f" TODO: {len(todo_tasks)}건 | DONE: {len(done_tasks)}건 | 완료율: {rate}")
|
|
|
|
if todo_tasks:
|
|
print(f" 미완료:")
|
|
for t in todo_tasks:
|
|
labels = ", ".join(l["title"] for l in (t.get("labels") or []))
|
|
label_str = f" [{labels}]" if labels else ""
|
|
desc = (t.get("description") or "")[:40].replace("\n", " ")
|
|
desc_str = f" {desc}" if desc else ""
|
|
print(f" ⬜ #{t['id']} {t['title'][:50]}{label_str}{desc_str}")
|
|
|
|
if done_tasks:
|
|
# 최근 완료 5건만 표시
|
|
recent_done = sorted(done_tasks, key=lambda t: t.get("done_at", ""), reverse=True)[:5]
|
|
print(f" 최근 완료 (최대 5건):")
|
|
for t in recent_done:
|
|
print(f" ✅ #{t['id']} {t['title'][:50]}")
|
|
except Exception as e:
|
|
print(f" 태스크 조회 실패: {e}")
|
|
|
|
# 3) Git log (현재 디렉토리 기준)
|
|
print(f"\n[최근 커밋 5건]")
|
|
try:
|
|
result = subprocess.run(
|
|
["git", "log", "--oneline", "-5"],
|
|
capture_output=True, timeout=10,
|
|
encoding="utf-8", errors="replace",
|
|
)
|
|
if result.returncode == 0 and result.stdout.strip():
|
|
for line in result.stdout.strip().splitlines():
|
|
print(f" {line}")
|
|
else:
|
|
print(" (git log 없음)")
|
|
except Exception:
|
|
print(" (git 실행 불가)")
|
|
|
|
# 4) Devlog (오늘/어제)
|
|
print(f"\n[Devlog]")
|
|
today = datetime.now().strftime("%Y-%m-%d")
|
|
yesterday = (datetime.now() - timedelta(days=1)).strftime("%Y-%m-%d")
|
|
|
|
devlog_found = False
|
|
for date_str in [today, yesterday]:
|
|
devlog_path = Path("docs/devlog") / f"{date_str}.md"
|
|
if devlog_path.exists():
|
|
content = devlog_path.read_text(encoding="utf-8").strip()
|
|
# 최대 500자
|
|
if len(content) > 500:
|
|
content = content[:500] + "\n ...(생략)"
|
|
print(f" [{date_str}]")
|
|
for line in content.splitlines():
|
|
print(f" {line}")
|
|
devlog_found = True
|
|
break
|
|
|
|
if not devlog_found:
|
|
print(" (최근 devlog 없음)")
|
|
|
|
|
|
def main():
|
|
if len(sys.argv) < 2:
|
|
print(__doc__)
|
|
return
|
|
|
|
cmd = sys.argv[1].lower()
|
|
|
|
if cmd == "done":
|
|
ids = [int(x) for x in sys.argv[2:]]
|
|
mark_done(ids)
|
|
elif cmd == "undone":
|
|
ids = [int(x) for x in sys.argv[2:]]
|
|
mark_undone(ids)
|
|
elif cmd == "comment":
|
|
add_comment(int(sys.argv[2]), sys.argv[3])
|
|
elif cmd == "desc":
|
|
set_description(int(sys.argv[2]), sys.argv[3])
|
|
elif cmd == "list":
|
|
f = sys.argv[2] if len(sys.argv) > 2 else "all"
|
|
list_tasks(f)
|
|
elif cmd == "label":
|
|
if len(sys.argv) < 4:
|
|
print("Usage: vikunja_helper.py label TASK_ID Label1 Label2 ...")
|
|
return
|
|
add_labels(int(sys.argv[2]), sys.argv[3:])
|
|
elif cmd == "create":
|
|
title = sys.argv[2] if len(sys.argv) > 2 else ""
|
|
desc = sys.argv[3] if len(sys.argv) > 3 and not sys.argv[3].startswith("--") else ""
|
|
is_done = "--done" in sys.argv
|
|
labels = None
|
|
for i, arg in enumerate(sys.argv):
|
|
if arg == "--labels" and i + 1 < len(sys.argv):
|
|
labels = sys.argv[i + 1].split(",")
|
|
break
|
|
if not title:
|
|
print("Error: title is required")
|
|
return
|
|
create_task(title, desc, done=is_done, labels=labels)
|
|
elif cmd == "projects":
|
|
list_projects()
|
|
elif cmd == "report":
|
|
pid = int(sys.argv[2]) if len(sys.argv) > 2 else None
|
|
report(pid)
|
|
else:
|
|
print(f"Unknown command: {cmd}")
|
|
print(__doc__)
|
|
|
|
|
|
if __name__ == "__main__":
|
|
main()
|