docs(img-forge): update img-forge.md — model lineup, community unlock, CLI reference

[stackbilt-admin]

What needs updating

File: src/content/docs/img-forge.md

1. Model lineup

Remove dall-e-3 (shut down May 12, 2026 — dead). Update OpenAI section to current lineup:

• gpt-image-1-mini — fast/budget, bills at ultra (10cr)
• gpt-image-1 — high-fidelity (deprecating Oct 23, 2026)
• gpt-image-1.5 — enhanced fidelity, bills at ultra (10cr)
• gpt-image-2 — highest quality OpenAI model, bills at ultra (10cr)

Gemini models (community-locked — document the gate, don't hide it):

• ultra tier → gemini-3.1-flash-image-preview
• ultra_plus tier → gemini-3-pro-image-preview

CF models (live now, no unlock required):

• draft → SDXL Lightning
• standard → FLUX Klein 4B
• premium → FLUX Dev

2. Community unlock section

Add a new section explaining the frontier model gate:

OpenAI and Gemini models are currently gated behind a community milestone. GET /v2/models returns unlock_status on each frontier model with live progress (display_current / display_goal), funded_basis: true (the real trigger is committed revenue, not just headcount), and an agent_hint that agents can surface to their operators.

Agents querying list_models via MCP will see the locked section and the hint automatically.

3. CLI reference

Add @img-forge/cli section with:

• Install: npm install -g @img-forge/cli (once published) / npx imgforge
• Commands: generate, models, jobs list, jobs get <id>
• Flags: --tier, --openai-model, --cf-model, --aspect-ratio, --seed, --output, --sync
• Auth: IMGFORGE_API_KEY env var or --key flag

4. MCP section

Verify generate_image tool description reflects current model lineup (dall-e-3 removed, four OpenAI models listed). Confirm list_models documents the two-section format (defaults + overrides) and the locked-model section.

5. Pricing / credits

Clarify credit math:

• draft = 1cr, standard = 2cr, premium = 5cr, ultra = 10cr, ultra_plus = 20cr
• OpenAI models all bill at ultra (10cr) regardless of model choice
• Agency subscription = $75/mo