RELEASING.md

Release Checklist — Virtual Foreman

Pre-production state right now. The following items remain — all can be completed in less than an hour.

✅ Done

• Backend (FastAPI) is live on Hugging Face Space.
• Frontend (Next.js) is live on Vercel.
• All major routes wired end-to-end:
  • GET /health, GET /, GET /supabase/health
  • POST /projects, GET /projects, GET /projects/{id}, DELETE /projects/{id}
  • POST /work/infer, POST /work/blueprint
  • GET /documents/templates, POST /documents/render
  • GET /inference/history
• CORS constrained to the live Vercel deploy (virt-foreman.vercel.app) plus subdomains and localhost.
• X-Request-ID middleware on every response.
• HF Space secret recipes documented in backend/README.md.
• Legacy OpenRouter fields retained but ignored; primary NVIDIA integrate chain (DeepSeek V4 Flash + fallbacks) is active.
• Vision path uses Llama-3.2-Vision-11B → 90B → Phi-4-multimodal.
• PDF render pipeline (pypdfium2 + Pillow) renders first page to PNG before VLM call, capped at 1536 px on longest edge.
• Stub fallbacks for inference exhaustion — UI never dead-ends.
• Pytest suite covers schemas + Supabase column mapping (7 tests).
• All commits authored dirboll@gmail.com (Vercel bot-check OK).

🟡 Manual steps remaining (~ 30 minutes)

1. Apply the Supabase delta schema

   • Open https://supabase.com/dashboard/project/hjkubelrluueugdjsqyn/sql/new
   • Paste contents of backend/supabase/schema.sql
   • Click Run → confirm inference_history appears in the table editor.

2. Verify secrets on the HF Space

   • https://huggingface.co/spaces/Dirbol/VirtForemanBackend/settings/secrets
   • SUPABASE_URL ✅
   • SUPABASE_SECRET_KEY (or SUPABASE_KEY) ✅
   • LLM_API_KEY (= NVIDIA integrate API key) ✅
   • Optional: HF_TOKEN for monitoring

3. Vercel one-time connect (skipped in Termux)

   • Vercel dashboard → "Add New Project" → "Import Git Repository"
   • Pick dirboll-commits/VirtForeman
   • Root directory: repo root (already Next.js-shaped)
   • Env vars in Vercel project settings:
     • NEXT_PUBLIC_API_URL=https://dirbol-virtforemanbackend.hf.space
     • NEXT_PUBLIC_APP_NAME=Virtual Foreman

4. Health checks

   • curl https://dirbol-virtforemanbackend.hf.space/health → 200
   • curl https://dirbol-virtforemanbackend.hf.space/supabase/health → {configured:true, reachable:true, rows_in_projects_sample:1}
   • curl https://virt-foreman.vercel.app/ → 200, home page renders

5. End-to-end smoke (manual, in browser)

   • Create project → /work, /blueprint, /documents chained actions.
   • Verify each inference shows up under /history.
   • Verify document download opens in Word / LibreOffice.

6. Run the regression suite

   pip install -r requirements-dev.txt
   pytest tests/test_schemas.py tests/test_supabase_mapping.py -v
   

   Expected output: 7 passed.

7. Production hardening (optional)

   • Rate-limit per IP on /work/infer and /work/blueprint.
   • Auth layer (Supabase Auth widgets or OIDC for the frontend).
   • Email verification before document download.

📋 Deployment commands cheat-sheet

# Backend → HF Space
git push hf <branch>:main

# Frontend → Vercel (Vercel auto-deploys on push to origin/main)
git push origin <branch>:refs/heads/main --force

Both must succeed for a clean release. Roll back via Vercel "Promote previous deployment" / HF revert.

🔁 Logs

• HF Space runtime: https://huggingface.co/spaces/Dirbol/VirtForemanBackend → "Logs" tab → "Container" stream.
• Vercel: project → "Logs" tab.
• Local sanity: pytest tests/ -v.