Artifactspublic-v0

ply

main
ply4 git calls634 ms39 KiB2 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));
Diagnostics4 git calls · 634 ms
CallStatusSizeTime0634 ms
discover200152 B3 ms
git.upload-pack discover
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=ls-refs
git.upstream.dur_ms=3
git.response.bytes=152
git.server.agent=gitty/1.0
git.server.object_format=sha1
git.server.caps=agent ls-refs fetch object-format
git.server.fetch=shallow filter sideband-all
git.protocol.version=2
git.pkt.frames=8
git.pkt.data=6
git.pkt.flush=2
git.pkt.delim=0
git.pkt.bytes=152
git.pkt.payload.max=34
ls-refs200145 B · hit3 ms
git.upload-pack ls-refs
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=ls-refs
git.upstream.dur_ms=3
git.response.bytes=145
git.response.cache=HIT
git.response.duration_ms=3
git.protocol.version=2
git.pkt.frames=3
git.pkt.data=2
git.pkt.flush=1
git.pkt.delim=0
git.pkt.bytes=145
git.pkt.payload.max=76
git.ls_refs.count=2
git.ls_refs.head=refs/heads/main
fetchblob:none · deepen 1020038 KiB · hit3 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=3
git.response.bytes=38434
git.response.cache=HIT
git.response.duration_ms=3
git.fetch.filter=blob:none
git.fetch.filter.requested=tree:0
git.fetch.filter.fallback=blob:none
git.fetch.filter.learned=false
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=6
git.pkt.data=4
git.pkt.flush=1
git.pkt.delim=1
git.pkt.bytes=38434
git.pkt.payload.max=38339
git.sideband.band1.bytes=38338
git.sideband.band2.bytes=0
git.sideband.band3.bytes=0
git.pack.objects=63
git.pack.bytes=38338
git.pack.ofs_delta=0
git.pack.ref_delta=8
git.pack.chain.max=8
git.pack.trailer=0bc36ab7adf82d3109177f11f1ea93f1ce071f77
git.pack.full=55
Open pack map
fetch2001.1 KiB628 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=628
git.response.bytes=1146
git.response.cache=MISS
git.response.duration_ms=628
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=3
git.pkt.data=2
git.pkt.flush=1
git.pkt.delim=0
git.pkt.bytes=1146
git.pkt.payload.max=1125
git.sideband.band1.bytes=1124
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://5ad2236b39de4c8bd8f6270ea63f3ea9.artifacts.cloudflare.net/git/public-v0/ply.git
Ref
refs/heads/main
Commit
19912563f540228593df0c489082e5e2508e21e4
cf-ray
a5e34978581a4652
Request
345a0aaa…
Protocol
v2 · sha1
Agent
gitty/1.0
Filter
advertised
Fetch
shallow filter sideband-all
Capabilities
agent ls-refs fetch object-format