# Oe Hil And Billing Triage

> Debug common manager/HIL + billing/deposit regressions: tasks not appearing in the panel, approve/reject button failures, billing capture loops, and “deposit paid but workflow stuck”. Produces a targeted repro + test run and points to the likely faulty layer (frontend vs backend).

- Skill: `majiayu000/oe-hil-and-billing-triage` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/oe-hil-and-billing-triage`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/oe-hil-and-billing-triage/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/oe-hil-and-billing-triage

---


# oe-hil-and-billing-triage

## Fast signal: run the dedicated approve path tests

- `pytest backend/tests/agents/test_manager_approve_path.py -v`
- `pytest tests/specs/gatekeeping/test_hil_gates.py -v`

## If “Approve” fails (500 or missing attribute)

1. Confirm the handler symbol exists and is exported from the canonical step module.
2. Confirm any deprecated wrapper modules re-export the symbol used by `backend/workflow_email.py`.
3. Use `docs/guides/TEAM_GUIDE.md` (“HIL Approve Button Fails - Missing Export”) as the exact checklist.

## If HIL tasks don’t appear in the frontend “Manager Tasks” panel

1. Confirm the task payload uses the same `thread_id` as the frontend session id.
2. Confirm the frontend is not appending the API response directly into chat (bypassing task rendering).
3. Use `docs/guides/TEAM_GUIDE.md` (“HIL Task Not Appearing in Tasks Panel After Deposit Payment”) for known root causes and files:
   - `atelier-ai-frontend/app/page.tsx`
   - `backend/workflows/steps/step1_intake/trigger/step1_handler.py`

## If billing/deposit flow is stuck (accept → billing → deposit → HIL)

1. Re-test in UI with a fresh session (reset client / new email) to avoid stale session artifacts.
2. Verify the gate checks use fresh deposit status (reload from DB for deposit; in-memory for billing):
   - `backend/workflows/common/confirmation_gate.py`
3. Use `docs/guides/TEAM_GUIDE.md` (“Frontend Billing Capture Intermittent Failure”) for the suspected frontend/backend boundary issue and involved files:
   - `backend/api/routes/messages.py`
   - `backend/api/routes/events.py`