koala73 Release Notes

Why

One country brief fans out into dozens of MCP reads. Charging each read against Pro's 50/day allowance exhausted it during panel acceptance testing. Admit one bounded country request for one daily unit and reuse loaded observations across topic changes, return navigation and repeated questions.

Scope

open_country_brief issues a user/country-bound, expiring admission; atomic Redis scripts enforce one charge and a 64-uncached-read ceiling. Country assessment, coverage and fixed section readers reuse that admission and ready results. Explicit refresh starts a new paid request; retries share a stable request ID.

The embedded panel coalesces reads, caches ready data and displays remaining allowance/reset time. A pending refresh preserves a newly typed country choice.

Share the existing numeric country mappings so trade-reader scope checks retain Comtrade overrides. Update generated discovery metadata and usage documentation.

Tradeoffs

Keep progressive readers instead of adding another server-side country bundle. Retain the published 50/250 numerical allowances provisionally: reader costs are measured, but provider invoices and real daily usage are unavailable. The measurement report records the evidence and calibration gap.

Blast Radius

Grouping applies to dedicated paid MCP allowances. API plans retain weighted billing; current entitlement checks, UTC reset, no-refund rules and burst protection remain. The existing 60-call/minute burst can still throttle an immediate full refresh. Receipts expire within ten minutes and cannot authorize another user, country or arbitrary tool.

Verification

Same controlled 43-call country workflow: 43 calculated daily units under the old rule → 1 measured unit. Repeated country/topic selections: zero additional calls; refresh: one unit. Deliberately failed sections remain retryable.

2,681 scoped MCP tests passed, including real Lua admission/read-ceiling execution, concurrent opens, boundary reuse, stable retry expiry, world-production scope, forged scope, entitlement revocation, API billing and HTTP 429 behavior.

Built opaque-iframe acceptance: all five Chromium tests passed, including the delayed-refresh race, downloads, navigation reuse and initial/refresh quota denial. Desktop/mobile screenshots show controlled fixtures, not live source acceptance.

API/browser type checks, Biome, architecture boundaries, premium-fetch/API contracts, rate-limit policies, generated product facts, Markdown and repository safety gates passed; all 537 sidecar tests passed.

Native ChatGPT acceptance, production freshness and cloud-dollar calibration remain post-deployment checks. This PR does not establish store readiness.

Summary by CodeRabbit

New Features

Pro and Pro Business country briefs now use dedicated daily request allowances. Opening a brief includes its section loads, and reopening the same country within five minutes reuses the request; refreshing starts a new request.

Country views display usage limits and reset information, and reuse ready data for up to five minutes. Each admission allows up to 64 uncached reads.

Updates

Standalone MCP calls on paid plans cost one unit each. API plans continue to use weighted billing against their shared daily API budget.