# Hunter Foreman — Cloudflare Public Release

This package is the complete public judge experience for Cloudflare Pages. It does not depend on localhost, Node, Docker, or the owner's PC.

## Deployment

Connect the repository to **Cloudflare Pages**.

- Framework preset: `None`
- Build command: leave blank
- Build output directory: `/`
- Root directory: `/`
- Production branch: `main`

Cloudflare Pages automatically discovers the `functions/` directory and serves:

- `POST /api/assistant` — Hunter submission assistant
- `POST /api/classify` — live demo request classification
- `GET /api/status` — deployment/provider readiness

## AI configuration after first deployment

In Cloudflare: **Workers & Pages → your Pages project → Settings → Variables and Secrets**

Add the secret:

- `FIREWORKS_API_KEY` — your Fireworks API key

Optional variables are already documented in `wrangler.toml`:

- `FIREWORKS_MODEL=accounts/fireworks/models/gpt-oss-120b`
- `AI_PROVIDER_ORDER=fireworks,workers-ai`

For a Cloudflare Workers AI fallback, add a **Workers AI binding** named `AI`, then redeploy.

The public site uses Fireworks through a Cloudflare Pages Function, keeping the credential server-side. If Fireworks is temporarily unavailable, the demo uses the explicitly labelled verified deterministic fallback. If the Workers AI binding is configured, it can serve as the second live provider.

## Judge experience

The deployed Pages site provides the polished hub, inline video, interactive demo, live classification, Hunter assistant, pitch deck, screenshots, GitHub proof and downloadable package. The implementation repository remains the proof/reproducibility layer.
