Fix Hellenistic Seer billing when chart context is missing

[cursor]

What changed

• Hellenistic Ask the Seer no longer debit PAYG credits (or consume the free tool-seer instance) when the chart payload is missing.
• The shared tool Seer gate now accepts missingContextError and returns 400 before rate-limit and consumeBillingAction.
• Added a unit test that a real question with no Hellenistic chart returns 400 and does not call billing.

Why this change is safe

• Root cause: enforceToolSeerGate billed first; /api/hellenistic/ask-seer then 400’d for missing hellenisticContext.
• Trigger: Signed-in PAYG user opens Ask the Hellenistic Seer before a reading exists (the tab is shown even without a chart; starter chips send immediately), submits a real question. UI already mapped that 400 to “Generate your Hellenistic chart first…” after the debit.
• Scope is the gate plus the Hellenistic Seer route. Vedic/Western remain open PR Fix Seer billing when natal chart context is missing #64. Complementary to Fix Seer billing for empty questions #59 (empty-question debit) and Fix Seer billing when natal chart context is missing #64 (natal missing-chart debit), not a duplicate.
• Auth still runs first (401 before missing-context 400).

Verification

• pnpm exec eslint on touched files (0 errors)
• pnpm test — 69 suites / 382 tests passed
• pnpm run security passed
• Playwright smoke not required (API billing gate only; no UI/routing change)

Regression prevention

• tests/unit/enforceToolSeerGate.test.ts — missing Hellenistic chart context → 400 and consumeBillingAction not called; valid questions still bill; injection blocks still skip debit.
• Existing empty-question pass-through behavior in the gate is unchanged (still covered by open Fix Seer billing for empty questions #59).

Release checklist (solo-friendly)

• CI is green
• Ready to merge to main
• Post-merge: ask Hellenistic Seer before generating a chart — should 400 with no credit change

  

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
future-seer	Ready	Preview	Sep 1, 2026 11:13am UTC