GitHubivarvong

ply

main
ply5 git calls191 ms20 KiB3 cachedprotocol v2
179 lines10 KiBRaw
1{
2 "name": "ply",
3 "version": "0.2.0",
4 "description": "Zero-dependency git smart-HTTP client: blobless partial fetch, streamed single-file edit, thin delta push. OTLP spans built in.",
5 "type": "module",
6 "main": "dist/index.js",
7 "types": "dist/index.d.ts",
8 "exports": {
9 ".": {
10 "types": "./dist/index.d.ts",
11 "default": "./dist/index.js"
12 },
13 "./edit": {
14 "types": "./dist/edit.d.ts",
15 "default": "./dist/edit.js"
16 },
17 "./read": {
18 "types": "./dist/read.d.ts",
19 "default": "./dist/read.js"
20 },
21 "./log": {
22 "types": "./dist/log.d.ts",
23 "default": "./dist/log.js"
24 },
25 "./tree": {
26 "types": "./dist/tree.d.ts",
27 "default": "./dist/tree.js"
28 },
29 "./tree-node": {
30 "types": "./dist/tree-node.d.ts",
31 "default": "./dist/tree-node.js"
32 },
33 "./checkout": {
34 "types": "./dist/checkout.d.ts",
35 "default": "./dist/checkout.js"
36 },
37 "./checkout-node": {
38 "types": "./dist/checkout-node.d.ts",
39 "default": "./dist/checkout-node.js"
40 },
41 "./repo-node": {
42 "types": "./dist/repo-node.d.ts",
43 "default": "./dist/repo-node.js"
44 },
45 "./client": {
46 "types": "./dist/client.d.ts",
47 "default": "./dist/client.js"
48 },
49 "./transport": {
50 "types": "./dist/transport.d.ts",
51 "default": "./dist/transport.js"
52 },
53 "./fetch": {
54 "types": "./dist/fetch.d.ts",
55 "default": "./dist/fetch.js"
56 },
57 "./push": {
58 "types": "./dist/push.d.ts",
59 "default": "./dist/push.js"
60 },
61 "./packcache": {
62 "types": "./dist/packcache.d.ts",
63 "default": "./dist/packcache.js"
64 },
65 "./blobcache": {
66 "types": "./dist/blobcache.d.ts",
67 "default": "./dist/blobcache.js"
68 },
69 "./sign": {
70 "types": "./dist/sign.d.ts",
71 "default": "./dist/sign.js"
72 },
73 "./merge": {
74 "types": "./dist/merge.d.ts",
75 "default": "./dist/merge.js"
76 },
77 "./rebase": {
78 "types": "./dist/rebase.d.ts",
79 "default": "./dist/rebase.js"
80 },
81 "./otel": {
82 "types": "./dist/otel.d.ts",
83 "default": "./dist/otel.js"
84 },
85 "./probes": {
86 "types": "./dist/probes.d.ts",
87 "default": "./dist/probes.js"
88 }
89 },
90 "sideEffects": false,
91 "files": [
92 "dist"
93 ],
94 "engines": {
95 "node": ">=20"
96 },
97 "scripts": {
98 "build": "tsc -p tsconfig.json",
99 "prepare": "tsc -p tsconfig.json",
100 "check": "npm run typecheck && npm run lint && vitest run test/space/registry.test.js && node scripts/dist-check.mjs",
101 "check:dist": "node scripts/dist-check.mjs",
102 "check:pack": "node scripts/pack-check.mjs",
103 "typecheck": "tsc -p tsconfig.check.json && tsc -p tsconfig.isolated.json && node scripts/ts-ratchet.mjs && node scripts/absence-ratchet.mjs && node scripts/throw-ratchet.mjs",
104 "lint": "oxlint --type-aware --deny-warnings src && oxlint -c oxlint.loose.json src test scripts examples bench && node scripts/exhaustive.mjs && node scripts/regex-gate.mjs",
105 "test": "rm -rf .failsites && PLY_FAILSITES=.failsites NODE_OPTIONS=--import=$PWD/test/space/failsite-hook.mjs vitest run && PLY_FAILSITES=.failsites PLY_FAILSITES_GATE=1 vitest run test/space/failsites.test.js && npm run test:fuzz-pinned",
106 "test:fuzz-pinned": "node test/fuzz/pinned.mjs",
107 "test:fuzz-random": "node test/fuzz/pinned.mjs --random",
108 "test:props": "vitest run test/props.test.js",
109 "test:oracle": "vitest run test/oracle.test.js test/concurrency.test.js test/edges.test.js",
110 "test:adversarial": "vitest run test/adversarial.test.js",
111 "fuzz": "node --import ./test/ts-resolve.mjs test/fuzz/run.mjs",
112 "fuzz:hostile": "node --import ./test/ts-resolve.mjs test/fuzz/hostile.mjs",
113 "fuzz:long": "node --import ./test/ts-resolve.mjs test/fuzz/run.mjs --n 1000 && node --import ./test/ts-resolve.mjs test/fuzz/hostile.mjs --n 1000 && node --import ./test/ts-resolve.mjs test/fuzz/below-hash.mjs --n 400 --seed 1 && node --import ./test/ts-resolve.mjs test/fuzz/git-semantic.mjs --n 200 --seed 1 && node --import ./test/ts-resolve.mjs test/fuzz/liar.mjs --n 1000 && node --import ./test/ts-resolve.mjs test/fuzz/protocol.mjs --n 1000 && node --import ./test/ts-resolve.mjs test/fuzz/packgen.mjs --n 500 && node --import ./test/ts-resolve.mjs test/fuzz/codec.mjs --n 300000 && node --import ./test/ts-resolve.mjs test/fuzz/linemerge.mjs --n 20000 && node --import ./test/ts-resolve.mjs test/fuzz/linemerge.mjs --n 5000 --runs && node --import ./test/ts-resolve.mjs test/fuzz/diffscript.mjs --n 1000 && node --import ./test/ts-resolve.mjs test/fuzz/diffscript.mjs --n 200 --snake && node --import ./test/ts-resolve.mjs test/fuzz/diffscript.mjs --n 50 --huge",
114 "trace": "node --import ./test/ts-resolve.mjs test/trace.mjs",
115 "test:protocol": "vitest run test/protocol.test.js",
116 "fuzz:protocol": "node --import ./test/ts-resolve.mjs test/fuzz/protocol.mjs",
117 "test:git": "vitest run test/compliance.test.js test/parity.test.js test/push.test.js test/push-tree.test.js test/checkout-tree.test.js test/packcache.test.js test/blobcache.test.js",
118 "test:push-full": "PUSH_MATRIX=full vitest run test/push.test.js",
119 "test:space": "vitest run test/space/push-outcome.test.js test/space/push-outcome-boundary.plan.test.js test/space/push-outcome-boundary.0.test.js test/space/push-outcome-boundary.1.test.js test/space/push-outcome-boundary.2.test.js test/space/push-outcome-boundary.3.test.js test/space/fsck-tree.test.js test/space/advertisement.test.js test/space/pack-cut.test.js test/space/pkt-frame.test.js test/space/push-ng.test.js test/space/refname.test.js",
120 "test:pack-cut-full": "PACK_SPACE=full vitest run test/space/pack-cut.test.js",
121 "space:md": "node --import ./test/ts-resolve.mjs scripts/space-md.mjs --write",
122 "fuzz:packs": "node --import ./test/ts-resolve.mjs test/fuzz/packs.mjs",
123 "fuzz:linemerge": "node --import ./test/ts-resolve.mjs test/fuzz/linemerge.mjs",
124 "fuzz:diffscript": "node --import ./test/ts-resolve.mjs test/fuzz/diffscript.mjs",
125 "fuzz:attributes": "node --import ./test/ts-resolve.mjs test/fuzz/attributes.mjs",
126 "test:workerd": "vitest run test/workerd.test.js",
127 "test:read": "vitest run test/read.test.js test/log.test.js test/artifacts-compat.test.js",
128 "coverage": "rm -rf /tmp/ply-cov && NODE_V8_COVERAGE=/tmp/ply-cov vitest run test/props.test.js test/oracle.test.js test/concurrency.test.js test/edges.test.js test/adversarial.test.js test/compliance.test.js test/packcache.test.js test/pure.test.js test/sign.test.js test/merge.test.js test/linemerge.test.js test/rebase.test.js && NODE_V8_COVERAGE=/tmp/ply-cov node --import ./test/ts-resolve.mjs test/fuzz/run.mjs --n 60 --seed 11 && NODE_V8_COVERAGE=/tmp/ply-cov node --import ./test/ts-resolve.mjs test/fuzz/hostile.mjs --n 60 --seed 12 && NODE_V8_COVERAGE=/tmp/ply-cov node --import ./test/ts-resolve.mjs test/fuzz/protocol.mjs --n 80 --seed 32 && NODE_V8_COVERAGE=/tmp/ply-cov node --import ./test/ts-resolve.mjs test/fuzz/packs.mjs --n 30 --seed 5; NODE_V8_COVERAGE=/tmp/ply-cov node --import ./test/ts-resolve.mjs test/fuzz/linemerge.mjs --n 200 --runs && NODE_V8_COVERAGE=/tmp/ply-cov node --import ./test/ts-resolve.mjs test/fuzz/linemerge.mjs --n 200 --rediff undecided && NODE_V8_COVERAGE=/tmp/ply-cov node --import ./test/ts-resolve.mjs test/fuzz/diffscript.mjs --n 40 --snake && NODE_V8_COVERAGE=/tmp/ply-cov node --import ./test/ts-resolve.mjs test/fuzz/diffscript.mjs --n 3 --huge && NODE_V8_COVERAGE=/tmp/ply-cov node --import ./test/ts-resolve.mjs test/fuzz/attributes.mjs --n 40 && NODE_V8_COVERAGE=/tmp/ply-cov node --import ./test/ts-resolve.mjs test/fuzz/linemerge.mjs --n 200 --driver union && NODE_V8_COVERAGE=/tmp/ply-cov node --import ./test/ts-resolve.mjs test/fuzz/linemerge.mjs --n 50 --driver binary; node --import ./test/ts-resolve.mjs test/coverage.mjs /tmp/ply-cov --lines",
129 "live:prepare": "node --import ./test/ts-resolve.mjs test/live-prepare.mjs",
130 "fuzz:liar": "node --import ./test/ts-resolve.mjs test/fuzz/liar.mjs",
131 "fuzz:packgen": "node --import ./test/ts-resolve.mjs test/fuzz/packgen.mjs",
132 "fuzz:codec": "node --import ./test/ts-resolve.mjs test/fuzz/codec.mjs",
133 "calibrate": "node --import ./test/ts-resolve.mjs test/calibrate.mjs",
134 "bench": "node test/bench.mjs",
135 "bench:worker-mem": "npm run build && node bench/worker-mem/run.mjs",
136 "test:pure": "vitest run test/pure.test.js",
137 "test:spans": "vitest run test/span-contract.test.js",
138 "test:spans:update": "UPDATE_SPAN_CONTRACT=1 vitest run test/span-contract.test.js",
139 "test:bundle": "vitest run test/bundle.test.js",
140 "test:sign": "vitest run test/sign.test.js",
141 "test:merge": "vitest run test/merge.test.js test/rebase.test.js",
142 "test:fsck-space": "vitest run test/fsck-space.test.js",
143 "test:merge-long": "MERGE_CASES=200 vitest run test/merge.test.js",
144 "fuzz:below-hash": "node --import ./test/ts-resolve.mjs test/fuzz/below-hash.mjs",
145 "fuzz:git-semantic": "node --import ./test/ts-resolve.mjs test/fuzz/git-semantic.mjs",
146 "test:mutate": "node scripts/mutate.mjs",
147 "test:unit": "vitest run",
148 "test:spaces": "vitest run test/space/registry.test.js",
149 "spaces": "node --import ./test/ts-resolve.mjs scripts/spaces.mjs",
150 "coverage-matrix": "node --import ./test/ts-resolve.mjs scripts/coverage-matrix.mjs",
151 "probes": "node --import ./test/ts-resolve.mjs scripts/probes.mjs",
152 "sweep": "node --import ./test/ts-resolve.mjs test/sweep/run.mjs"
153 },
154 "license": "MIT",
155 "author": "Ivar Vong",
156 "repository": {
157 "type": "git",
158 "url": "git+https://github.com/ivarvong/ply.git"
159 },
160 "homepage": "https://github.com/ivarvong/ply#readme",
161 "bugs": {
162 "url": "https://github.com/ivarvong/ply/issues"
163 },
164 "devDependencies": {
165 "@babel/parser": "8.0.8",
166 "@cloudflare/workers-types": "5.20260916.1",
167 "@stryker-mutator/core": "10.1.1",
168 "@stryker-mutator/vitest-runner": "10.1.1",
169 "@types/node": "24.19.2",
170 "esbuild": "0.28.2",
171 "oxlint": "1.90.0",
172 "oxlint-tsgolint": "7.0.2005",
173 "types-node-20": "npm:@types/node@20.19.43",
174 "types-node-22": "npm:@types/node@22.20.5",
175 "typescript": "7.0.2",
176 "vitest": "5.0.5",
177 "workerd": "1.20261018.1"
178 }
Diagnostics5 git calls · 191 ms
CallStatusSizeTime0191 ms
discover200191 B2 ms
git.upload-pack discover
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=ls-refs
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 · 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=11990
git.response.cache=HIT
git.response.duration_ms=3
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 · 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=919
git.response.cache=HIT
git.response.duration_ms=3
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
fetch2002.5 KiB183 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=183
git.response.bytes=2530
git.response.cache=MISS
git.response.duration_ms=183
git.fetch.wants=114001d231494f6a579d155dea1963fe55db8ab9
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=2530
git.pkt.payload.max=2503
git.sideband.band1.bytes=2503
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
a5e0e954997ea140
Request
c23d17e3…
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