fix(routing): table pricing with catalog fallback for off-table models, pooled latency bootstrap, fresh tier cache

[maxmad64bis]

⚠️ base-red inherited: #12732

Summary

Free models outside the price table were billed as premium, and tier labels couldn't see prices an operator had overridden in settings. This PR fixes both sides of that: routing now checks the free-model catalog (the list of providers with a documented free tier) before falling back to premium prices, and tier classification reads live database prices with a freshness check so it can't drift silently.

Say you run a free model that isn't one of the 21 hardcoded entries — before this change it inherited $5/$15 per million tokens and got pushed to the bottom of cost-aware routing. Now it resolves to $0 and routes as free. The change is additive: classifyTier sync still serves table values, and generateRoutingHints now awaits classifyTierAsync per target (live DB pricing via getPricingForModel, sync fallback if unreachable).

It also stops guessing 1500ms for every unknown model's latency (the pool's observed median is used instead, with a counter tracking how often the guess path fires), scores real per-candidate costs instead of zero, and computes budget caps against actual estimated tokens rather than a fixed 1000.

Related Issues

• Related to fix(pricing): DeepSeek V4 static defaults stale by 4 days, off by ~1.6-2.4x #10635 (owner asked for regression tests on pricing values so reverts get caught — every price path here has one)
• Related to fix(models): stop treating provider-supplied free flags as trusted without a documented free tier #12744 (that PR guards the catalog predicate; this one consumes it for pricing)

Validation

• Change type: routing
• Focused tests and category gates from the golden path
• npm run lint
• Reconciled with the current active release base; focused checks rerun afterward
• Production-code changes include a new or updated automated test in this PR

Tests Added Or Updated

• tests/unit/pricing-fallback.test.ts (new, 4 tests): catalog free off-table → $0, prefixed id normalization, paid off-table → 5.0/15.0 fallback, table hits untouched
• tests/unit/combo-bootstrap-latency.test.ts (new, 5 tests): median ignores corrupt entries, empty stats → undefined, counters, table-hit vs miss accounting, pure warn gate
• tests/unit/tier-pricing-cache.test.ts (new, 4 tests): async tier reflects DB writes incl. resetAllPricing, DB-down fallback equals sync, sync path untouched by DB
• tests/unit/virtualFactory-valuation.test.ts (new, 4 tests): reliability absent/null/0.2/errorRate, real table costs via helper
• tests/unit/auto-combo-budget.test.ts (new, 2 tests): default math byte-identical, 32k tokens enforce 32x tighter budget via assert.throws
• tests/unit/complexity-router.test.ts, tests/integration/manifest-routing.test.ts, open-sse/services/__tests__/manifestAdapter.test.ts: awaited for the new async tier lookups
• scripts/check/check-pricing-freshness.mjs (new): freshness check failing when providerCostData.ts is untouched for 90+ days — now wired into CI (package.json + gate runner): green, full run passes except a pre-existing check:file-size failure unrelated to this PR
• npm run test:combo:matrix: 11 failures identical before/after this change (pre-existing on base, verified via stash comparison)
• npm run lint: exit 2 on base and branch alike — pre-existing unused-var errors in combo.ts/manifestAdapter.ts/tierResolver.ts (none introduced here; full-suite count unchanged). Note: lint needed npm install es-abstract@1.23.9 --no-save --no-package-lock locally to start at all (loader bug, noted per repo conventions).
• No VPS round-trip needed: all changes are local pricing/scoring math covered by unit tests, no upstream behavior assumed.

Coverage Notes

• Touches open-sse/ only: every new branch is covered by the tests above (lookup order in getModelPricing: provider-specific table entry, shared pricing, generic table entry, free catalog, then the premium fallback; median + counters + warn gate, async tier + fallback counter, reliability/cost/budget in the virtual factory and engine).
• No coverage gate regression attributable to this PR: the only untested lines are the fail-open catch paths, exercised implicitly by the DB-down test.

Reviewer Notes

• Additive by design: classifyTier sync is untouched; getTargetTier stays sync; classifyTierAsync is migrated onto one real call-site (generateRoutingHints, awaited by its 3 consumers). If the async path ever misbehaves, the sync fallback returns byte-identical values.
• Known behavior change (intended): virtual candidate rankings shift now that costs are real — cost-saver mode actually discriminates. Worth a glance at the resolveVirtualCost helper (open-sse/services/providerCostData.ts).
• The DEFAULT_MODEL_P95_MS table still has 8 entries (21 in the pricing table — separate tables, separate concerns); unlisted models now bootstrap from the pool median instead of a flat 1500ms, and the freshness gate keeps the pricing table honest going forward.
• A provider-specific table entry still wins over a generic one (provider-cost-data.test.ts); the generic entry and the free catalog only apply after the shared pricing lookup. The snapshot reliability factor reuses reliabilityFactor from scoring.ts instead of a second copy of the formula.
• Snapshot reliability weight defaults to 0, so scoring only discriminates once mode packs carry it (fix(auto-combo): give every mode pack quality and reliability weights #12731).