# Chore Forge

> 반복 잡무를 자연어로 설명하면 세 개의 GitHub Copilot 에이전트가 실행 가능한 파이썬 도구를 작성·검증해 영구 스킬로 등록합니다. 등록 후에는 모델 호출 없이 밀리초 단위로 재실행됩니다.

인증: 없음. 모든 엔드포인트가 자격 증명 없이 접근 가능합니다.

단조 가능 여부: 새 도구를 단조할 수 있습니다.

## 대표적인 사용 순서

1. GET /api/stats — 현재 상태 파악
2. GET /api/skills — 이미 등록된 스킬 확인 (데모 스킬 3개가 미리 심어져 있음)
3. POST /api/skills/{id}/run — 즉시 결과를 볼 수 있는 가장 빠른 경로 (~0.03초)
4. POST /api/forge — 전체 에이전트 파이프라인 관찰 (SSE, 60~200초 소요)
5. GET /api/runs — 방금 실행한 기록 확인
6. GET /api/forge/runs — 지난 단조의 단계·도구 호출·판정 기록 (단조를 돌리지 않고 확인)

## 엔드포인트

- `GET /healthz` — 서비스 상태와 저장소 백엔드
- `GET /api/stats` — 스킬 수, 실행 수, 절약 시간, 속도 배수
- `GET /api/forge/runs` — 단조 이력. stages, tool_calls(VerifierAgent 의 샌드박스 tool 호출 수), sandbox_attempts(2 이상이면 자가 수정 발생), verdict, auto_approved, elapsed_seconds
- `GET /api/skills` — 스킬 전체 목록 (코드 포함)
- `GET /api/skills/{id}` — 스킬 단건
- `POST /api/skills/{id}/run` — 실행 결과, 소요 시간, 누적 절약 시간
  - body: `{"input": "스킬에 넘길 텍스트", "source": "agent"}`
- `POST /api/forge` — text/event-stream — stage / delta / sandbox / draft / end 이벤트
  - body: `{"request": "자연어 잡무 설명", "manual_minutes": 15, "require_approval": false}`
  - 완주에 60~200초. 스트리밍을 지원하는 클라이언트로 호출하세요.
- `GET /api/runs?limit=50` — 최근 실행 기록
- `POST /api/skills/{id}/approve|reject` — 상태 변경
- `DELETE /api/skills/{id}` — 삭제

## 30초 안에 동작을 확인하는 방법

```bash
BASE=http://localhost:8080
SID=$(curl -s $BASE/api/skills | python3 -c "import sys,json;print(json.load(sys.stdin)['skills'][0]['id'])")
curl -s -X POST $BASE/api/skills/$SID/run \
  -H "Content-Type: application/json" \
  -d '{"input":"name,team,hours\nJiwoo,Platform,7.5\nMinsu,Data,6","source":"agent"}'
```

## 안전 모델

생성된 코드는 AST 허용목록 검사와 격리 서브프로세스(네트워크·파일시스템 차단, CPU 5초, 메모리 512MB, 12초 타임아웃)를 모두 통과해야만 등록됩니다. 샌드박스에 실패한 코드는 어떤 모드에서도 자동 등록되지 않습니다.

## 더 보기

- OpenAPI: /openapi.json
- 대화형 문서: /docs
- 구조화된 안내: /api/agent/guide