GitHubivarvong

ply

main
ply6 git calls140 ms21 KiB4 cachedprotocol v2
72 lines2.9 KiBRaw
1// What ply writes on `x-ply-pack-cache`, and the only reading of that header that decides a retry.
2// The span keeps the raw header (an unknown value is observable). A retry treats only HIT as a hit:
3// MISS, BUST, a missing header, and anything a cache may add later (EXPIRED) are not.
4import { assertNever } from './result.js';
6/** `''` is a response the cache did not stamp. */
7export type PackCacheStatus = 'HIT' | 'MISS' | 'BUST' | '';
8type CacheRead = { readonly tag: 'known'; readonly status: PackCacheStatus } | { readonly tag: 'other' };
10export function cacheHeader(status: PackCacheStatus): PackCacheStatus {
11 switch (status) {
12 case 'HIT':
13 case 'MISS':
14 case 'BUST':
15 case '':
16 return status;
17 }
18 // Stryker disable next-line ConditionalExpression: unreachable, the compiler's exhaustiveness check
19 return assertNever(status);
22function readCacheStatus(raw: unknown): CacheRead {
23 switch (raw) {
24 case 'HIT':
25 case 'MISS':
26 case 'BUST':
27 case '':
28 return { tag: 'known', status: raw };
29 default:
30 return { tag: 'other' };
31 }
34function knownHit(status: PackCacheStatus): boolean {
35 switch (status) {
36 case 'HIT': return true;
37 case 'MISS':
38 case 'BUST':
39 case '':
40 return false;
41 }
42 // Stryker disable next-line ConditionalExpression: unreachable, the compiler's exhaustiveness check
43 return assertNever(status);
46// Unknown is not a hit, same as a comparison against HIT (a hostile or newer cache header must not bust-retry).
47export function isCacheHit(raw: unknown): boolean {
48 const read = readCacheStatus(raw);
49 switch (read.tag) {
50 case 'other': return false;
51 case 'known': return knownHit(read.status);
52 }
53 // Stryker disable next-line ConditionalExpression: unreachable, the compiler's exhaustiveness check
54 return assertNever(read);
57// Own `cacheStatus` on a thrown value. A missing object or field is the unstamped header, not a hit.
58export function thrownCacheStatus(error: unknown): unknown {
59 if (typeof error !== 'object' || error === null || !Object.hasOwn(error, 'cacheStatus')) return '';
60 return Reflect.get(error, 'cacheStatus');
63// True only for an answer the client's parse refused (pack_corrupt, protocol, remote_error) that was served from a
64// cache HIT: the one case fetch retries once, past the cache. The store is untrusted, so the stored bytes are the
65// suspect (a flipped pack byte, an ERR, a cut, an empty body, a wrong pack trailer). A limit, a timeout, an abort or a
66// transport failure says nothing about the stored bytes and is not retried.
67export function corruptCacheHit(error: unknown): boolean {
68 if (typeof error !== 'object' || error === null || !Object.hasOwn(error, 'code')) return false;
69 const code: unknown = Reflect.get(error, 'code');
70 if (code !== 'pack_corrupt' && code !== 'protocol' && code !== 'remote_error') return false;
71 return isCacheHit(thrownCacheStatus(error));
Diagnostics6 git calls · 140 ms
CallStatusSizeTime0140 ms
discover200191 B2 ms
git.upload-pack discover
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=2
git.response.bytes=191
git.server.agent=git/github-9922ec520325-Linux
git.server.object_format=sha1
git.server.caps=agent ls-refs fetch server-option object-format
git.server.fetch=shallow wait-for-done filter
git.protocol.version=2
git.pkt.frames=9
git.pkt.data=7
git.pkt.flush=2
git.pkt.delim=0
git.pkt.bytes=191
git.pkt.payload.max=36
ls-refs20012 KiB · hit2 ms
git.upload-pack ls-refs
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=ls-refs
git.upstream.dur_ms=2
git.response.bytes=11990
git.response.cache=HIT
git.response.duration_ms=2
git.protocol.version=2
git.pkt.frames=152
git.pkt.data=151
git.pkt.flush=1
git.pkt.delim=0
git.pkt.bytes=11990
git.pkt.payload.max=122
git.ls_refs.count=151
git.ls_refs.head=refs/heads/main
fetchtree:0 · deepen 102004.2 KiB · hit2 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=2
git.response.bytes=4347
git.response.cache=HIT
git.response.duration_ms=2
git.fetch.filter=tree:0
git.fetch.wants=19912563f540228593df0c489082e5e2508e21e4
git.fetch.haves.count=0
git.fetch.deepen=10
git.fetch.thin_pack=false
git.fetch.ofs_delta=true
git.protocol.version=2
git.pkt.frames=7
git.pkt.data=5
git.pkt.flush=1
git.pkt.delim=1
git.pkt.bytes=4347
git.pkt.payload.max=4247
git.sideband.band1.bytes=4247
git.sideband.band2.bytes=0
git.sideband.band3.bytes=0
git.pack.objects=10
git.pack.bytes=4247
git.pack.ofs_delta=0
git.pack.ref_delta=0
git.pack.chain.max=0
git.pack.trailer=a6caf8e129bea82c9bae4cbc7c130c9205add400
git.pack.full=10
Open pack map
fetchtree:0200919 B · hit2 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=2
git.response.bytes=919
git.response.cache=HIT
git.response.duration_ms=2
git.fetch.filter=tree:0
git.fetch.wants=800d30ba8923860bfc460ca884b7f9ba22083588
git.fetch.haves.count=0
git.fetch.deepen=0
git.fetch.thin_pack=false
git.fetch.ofs_delta=true
git.protocol.version=2
git.pkt.frames=4
git.pkt.data=3
git.pkt.flush=1
git.pkt.delim=0
git.pkt.bytes=919
git.pkt.payload.max=892
git.sideband.band1.bytes=892
git.sideband.band2.bytes=0
git.sideband.band3.bytes=0
git.pack.objects=1
git.pack.bytes=892
git.pack.trailer=5323b9266eea5ded637285d1c5320699f12be76e
Open pack map
fetchtree:02002.4 KiB · hit2 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=132
git.response.bytes=2507
git.response.cache=HIT
git.response.duration_ms=2
git.fetch.filter=tree:0
git.fetch.wants=8f720d29ff85ce682ffdad9c393b04a3834c3203
git.fetch.haves.count=0
git.fetch.deepen=0
git.fetch.thin_pack=false
git.fetch.ofs_delta=true
git.protocol.version=2
git.pkt.frames=4
git.pkt.data=3
git.pkt.flush=1
git.pkt.delim=0
git.pkt.bytes=2507
git.pkt.payload.max=2480
git.sideband.band1.bytes=2480
git.sideband.band2.bytes=0
git.sideband.band3.bytes=0
git.pack.objects=1
git.pack.bytes=2480
git.pack.trailer=723b6bf1d4d6021fe5eb940c622b9ff00ee4a381
Open pack map
fetch2001.1 KiB132 ms
git.upload-pack fetch
http.response.status_code=200
git.response.bytes=1155
git.response.cache=MISS
git.response.duration_ms=132
git.fetch.wants=07a920bbeef66ad195d8bc959f7fc1057400c72d
git.fetch.haves.count=0
git.fetch.deepen=0
git.fetch.thin_pack=false
git.fetch.ofs_delta=true
git.protocol.version=2
git.pkt.frames=4
git.pkt.data=3
git.pkt.flush=1
git.pkt.delim=0
git.pkt.bytes=1155
git.pkt.payload.max=1128
git.sideband.band1.bytes=1128
git.sideband.band2.bytes=0
git.sideband.band3.bytes=0

Each row is one HTTP round trip ply made to the git server for this page, on one timeline. discover asks what the server speaks, ls-refs lists branch tips, fetch brings objects by id. A hit was served by Workers Cache. Tap a row for its wire details.

Remote
https://github.com/ivarvong/ply
Ref
refs/heads/main
Commit
19912563f540228593df0c489082e5e2508e21e4
cf-ray
a5e13c431c9b1293
Request
60190663…
Protocol
v2 · sha1
Agent
git/github-9922ec520325-Linux
Filter
advertised
Fetch
shallow wait-for-done filter
Capabilities
agent ls-refs fetch server-option object-format