You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Observability: first-class 'why is this route not fast-pathing' signal #721
User-agreed valuable during the #695 shell-fast-path work, never filed. A route can silently miss the FULL fast path (handlers re-run per HIT) or shelling entirely for reasons invisible without source-diving: handlerLiveHoles (which push disqualified it and why — nested thenable, pending at putShell, handler-invoked loader), capture refusals (identity guard, Set-Cookie once #713 lands, no loading() boundary), backoff state. Proposal: a debug header variant (e.g. x-rango-shell: HIT;handlers=live;cause=nested-push@ShellHandles) gated on INTERNAL_RANGO_DEBUG, plus a once-per-key dev log naming the disqualifying push/site. Refs: #695 notes ('observability follow-up'), the eligibility taxonomy in shell-capture.ts.
Partial-nav bypass reasons: x-rango-ppr-replay including handler-live-holes (src/rsc/rsc-rendering.ts, src/testing/shell-status.ts).
Document GETs still expose only x-rango-shell: HIT|MISS. A cause= suffix on that header is unscheduled. Reopen if operators still cannot debug a MISS without source-diving.
Activity
ivogt commentedon Aug 30, 2026
Enough of the "why is this not fast-pathing" signal landed that this is no longer a silent gap.
ShellCaptureDebugEventinsrc/rsc/shell-capture.ts).x-rango-ppr-replayincludinghandler-live-holes(src/rsc/rsc-rendering.ts,src/testing/shell-status.ts).x-rango-shell: HIT|MISS. Acause=suffix on that header is unscheduled. Reopen if operators still cannot debug a MISS without source-diving.