docs/IMPLEMENTATION_PLAN.md

IMPLEMENTATION_PLAN.md — Bug Triage Build Plan

Deadline: April 7, 2026, 11:59 PM IST

---

Build Status

Component	File	Status
Typed models	models.py	Done
Bug dataset (15 reports)	data/bugs.json	Done
Task 1 grader	graders/task1_grader.py	Done
Task 2 grader	graders/task2_grader.py	Done
Task 3 grader	graders/task3_grader.py	Done
Environment	server/environment.py	Done
FastAPI server	server/app.py	Done
Client	client.py	Done
Baseline script	baseline.py	Done
Dockerfile	server/Dockerfile	Done
openenv.yaml	openenv.yaml	Done
requirements.txt	requirements.txt	Done
pyproject.toml	pyproject.toml	Done

---

Remaining: Test + Deploy

Step 1 — Install dependencies

cd /Users/anks/Desktop/Meta-Pytorch-Hackathon
pip install -r bug_triage_env/requirements.txt

Step 2 — Run server locally

uvicorn bug_triage_env.server.app:app --host 0.0.0.0 --port 8000 --reload

Step 3 — Verify all endpoints

curl http://localhost:8000/health
curl http://localhost:8000/tasks
curl -X POST http://localhost:8000/reset -H "Content-Type: application/json" -d '{"task_id":"task_1"}'

Step 4 — Run a full episode

# 1. Reset
EPISODE=$(curl -s -X POST http://localhost:8000/reset \
  -H "Content-Type: application/json" \
  -d '{"task_id":"task_1"}' | python3 -c "import sys,json; print(json.load(sys.stdin)['episode_id'])")

# 2. Step
curl -X POST http://localhost:8000/step \
  -H "Content-Type: application/json" \
  -d "{\"episode_id\":\"$EPISODE\",\"action\":{\"task_id\":\"task_1\",\"bug_type\":\"crash\"}}"

Step 5 — Docker build + test

cd bug_triage_env
docker build -f server/Dockerfile -t bug-triage-env .
docker run -d -p 8000:8000 --name bug-triage-env bug-triage-env
curl http://localhost:8000/health

Step 6 — Run baseline

export OPENAI_API_KEY="your-key"
python -m bug_triage_env.baseline --all-tasks --episodes 5

Step 7 — Deploy to HF Spaces

openenv push --repo-id <hf-username>/bug-triage-env

Step 8 — Submit

Paste HF Spaces URL before April 7, 11:59 PM IST.