Distillation

Date: Sep 10, 2026

• 🔴 (09:33) User stated apiRequestToRegion always sends JSON and explicitly sets it.
• 🔴 (09:33) User stated the last request attempt always returns "done" or "throw".
• 🔴 (09:33) User stated throwOnError is always false because errors are handled directly.
• 🔴 (09:33) User stated certain endpoints are always on the control silo, including OAuth, user accounts, and regions.
• 🔴 [enforced-workflow] (09:33) User directed that package.json must always be checked for the latest scripts; commands must run from packages/cli or from the repository root via pnpm --filter sentry run <script>.
• 🟡 (09:33) packages/cli/src/lib/sentry-client.ts defines MAX_BACKOFF_MS = 10_000; its request behavior documents automatic retries for transient HTTP errors 408, 429, and 5xx.
• 🟡 (09:33) packages/cli/src/lib/sentry-client.ts uses getAuthenticatedFetch() for the configured fetch client, and its control-silo request helper is intended for OAuth, user-account, and region endpoints.
• 🟡 (09:33) packages/cli/AGENTS.md directs CLI route definitions to import buildRouteMap from ../../lib/route-map.js, never directly from @stricli/core, because the wrapper auto-injects standard subcommand aliases according to present route keys.
• 🟡 (09:33) packages/cli/AGENTS.md requires every paginated list command to use shared cursor-stack infrastructure supporting bidirectional pagination: -c next and -c prev.
• 🟡 (09:33) packages/cli/AGENTS.md requires timestamp sorting to use "date" rather than "time"; sort types should be exported by the API layer (example: SpanSortValue from api/traces.ts) and imported by commands, matching issue list, trace list, and span list.
• 🟡 (09:33) packages/cli/AGENTS.md error-class mapping: omitted required user values use ContextError (example: no org/project); supplied but unresolved values use ResolutionError (example: project 'cli' not found); malformed user input uses ValidationError (example: invalid hex ID format).
• 🟡 (09:33) packages/cli/AGENTS.md shows property-test convention using fcAssert(property(validInputArb, (input) => { const encoded = encode(input); const decoded = decode(encoded); expect(decoded).toEqual(input); }), { numRuns: DEFAULT_NUM_RUNS }).
• 🟡 (09:33) packages/cli/AGENTS.md shows isolated-test-DB convention: call const cleanup = createIsolatedDbContext();, execute test work in try, and call cleanup() in finally to prevent test interference.