@amalgm/shell 0.1.164-preview.41762776698 → 0.1.164-preview.44386772850

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (940) hide show
  1. package/PURPOSE.md +359 -235
  2. package/README.md +18 -0
  3. package/dist/accepted-fold.d.ts +51 -0
  4. package/dist/accepted-fold.js +106 -0
  5. package/dist/accepted-fold.js.map +1 -0
  6. package/dist/accepted-tail.d.ts +19 -9
  7. package/dist/accepted-tail.js +28 -11
  8. package/dist/accepted-tail.js.map +1 -1
  9. package/dist/accepted-view.d.ts +27 -0
  10. package/dist/accepted-view.js +8 -0
  11. package/dist/accepted-view.js.map +1 -0
  12. package/dist/apply-attempt-memory.d.ts +13 -0
  13. package/dist/apply-attempt-memory.js +26 -0
  14. package/dist/apply-attempt-memory.js.map +1 -0
  15. package/dist/apply-control.d.ts +85 -0
  16. package/dist/apply-control.js +131 -0
  17. package/dist/apply-control.js.map +1 -0
  18. package/dist/apply-displaced-tree.d.ts +63 -0
  19. package/dist/apply-displaced-tree.js +148 -0
  20. package/dist/apply-displaced-tree.js.map +1 -0
  21. package/dist/apply-durability.d.ts +33 -0
  22. package/dist/apply-durability.js +72 -0
  23. package/dist/apply-durability.js.map +1 -0
  24. package/dist/apply-enter-build.d.ts +91 -0
  25. package/dist/apply-enter-build.js +145 -0
  26. package/dist/apply-enter-build.js.map +1 -0
  27. package/dist/apply-enter-plan.d.ts +79 -0
  28. package/dist/apply-enter-plan.js +148 -0
  29. package/dist/apply-enter-plan.js.map +1 -0
  30. package/dist/apply-fingerprint.d.ts +39 -0
  31. package/dist/apply-fingerprint.js +84 -0
  32. package/dist/apply-fingerprint.js.map +1 -0
  33. package/dist/apply-git-held.d.ts +29 -0
  34. package/dist/apply-git-held.js +184 -0
  35. package/dist/apply-git-held.js.map +1 -0
  36. package/dist/apply-git-storage.d.ts +38 -0
  37. package/dist/apply-git-storage.js +110 -0
  38. package/dist/apply-git-storage.js.map +1 -0
  39. package/dist/apply-kept.d.ts +42 -0
  40. package/dist/apply-kept.js +135 -0
  41. package/dist/apply-kept.js.map +1 -0
  42. package/dist/apply-local-work.d.ts +41 -0
  43. package/dist/apply-local-work.js +72 -0
  44. package/dist/apply-local-work.js.map +1 -0
  45. package/dist/apply-map.d.ts +116 -0
  46. package/dist/apply-map.js +383 -0
  47. package/dist/apply-map.js.map +1 -0
  48. package/dist/apply-showing.d.ts +104 -0
  49. package/dist/apply-showing.js +236 -0
  50. package/dist/apply-showing.js.map +1 -0
  51. package/dist/apply-shown-again.d.ts +28 -0
  52. package/dist/apply-shown-again.js +81 -0
  53. package/dist/apply-shown-again.js.map +1 -0
  54. package/dist/apply-spelling.d.ts +35 -0
  55. package/dist/apply-spelling.js +79 -0
  56. package/dist/apply-spelling.js.map +1 -0
  57. package/dist/apply-trash-keep.d.ts +96 -0
  58. package/dist/apply-trash-keep.js +194 -0
  59. package/dist/apply-trash-keep.js.map +1 -0
  60. package/dist/apply-window-cargo.d.ts +54 -0
  61. package/dist/apply-window-cargo.js +219 -0
  62. package/dist/apply-window-cargo.js.map +1 -0
  63. package/dist/apply-window-ground.d.ts +130 -0
  64. package/dist/apply-window-ground.js +324 -0
  65. package/dist/apply-window-ground.js.map +1 -0
  66. package/dist/apply-window-host.d.ts +136 -0
  67. package/dist/apply-window-host.js +1842 -0
  68. package/dist/apply-window-host.js.map +1 -0
  69. package/dist/apply-window-lane.d.ts +30 -0
  70. package/dist/apply-window-lane.js +311 -0
  71. package/dist/apply-window-lane.js.map +1 -0
  72. package/dist/apply-window-line.d.ts +31 -0
  73. package/dist/apply-window-line.js +150 -0
  74. package/dist/apply-window-line.js.map +1 -0
  75. package/dist/apply-window-recovery.d.ts +5 -0
  76. package/dist/apply-window-recovery.js +72 -0
  77. package/dist/apply-window-recovery.js.map +1 -0
  78. package/dist/apply-window-reveal.d.ts +22 -0
  79. package/dist/apply-window-reveal.js +98 -0
  80. package/dist/apply-window-reveal.js.map +1 -0
  81. package/dist/apply-window-rows.d.ts +144 -0
  82. package/dist/apply-window-rows.js +178 -0
  83. package/dist/apply-window-rows.js.map +1 -0
  84. package/dist/apply-window-saves.d.ts +224 -0
  85. package/dist/apply-window-saves.js +674 -0
  86. package/dist/apply-window-saves.js.map +1 -0
  87. package/dist/apply-window-store.d.ts +126 -0
  88. package/dist/apply-window-store.js +312 -0
  89. package/dist/apply-window-store.js.map +1 -0
  90. package/dist/apply-window-verify.d.ts +65 -0
  91. package/dist/apply-window-verify.js +195 -0
  92. package/dist/apply-window-verify.js.map +1 -0
  93. package/dist/authority-binding.d.ts +1 -24
  94. package/dist/authority-binding.js +44 -9
  95. package/dist/authority-binding.js.map +1 -1
  96. package/dist/background-error.d.ts +4 -0
  97. package/dist/background-error.js +15 -0
  98. package/dist/background-error.js.map +1 -0
  99. package/dist/baseline-content.d.ts +12 -0
  100. package/dist/baseline-content.js +12 -0
  101. package/dist/baseline-content.js.map +1 -0
  102. package/dist/billing/cli.d.ts +18 -0
  103. package/dist/billing/cli.js +276 -0
  104. package/dist/billing/cli.js.map +1 -0
  105. package/dist/billing/mount.d.ts +12 -0
  106. package/dist/billing/mount.js +34 -0
  107. package/dist/billing/mount.js.map +1 -0
  108. package/dist/billing/tools.d.ts +57 -0
  109. package/dist/billing/tools.js +141 -0
  110. package/dist/billing/tools.js.map +1 -0
  111. package/dist/boot-identity.d.ts +1 -0
  112. package/dist/boot-identity.js +39 -0
  113. package/dist/boot-identity.js.map +1 -0
  114. package/dist/browser-host.d.ts +4 -3
  115. package/dist/browser-host.js +29 -14
  116. package/dist/browser-host.js.map +1 -1
  117. package/dist/captured-rows.d.ts +33 -0
  118. package/dist/captured-rows.js +45 -0
  119. package/dist/captured-rows.js.map +1 -0
  120. package/dist/cargo-group.d.ts +31 -17
  121. package/dist/cargo-group.js +78 -29
  122. package/dist/cargo-group.js.map +1 -1
  123. package/dist/cargo-journal.d.ts +45 -0
  124. package/dist/cargo-journal.js +130 -0
  125. package/dist/cargo-journal.js.map +1 -0
  126. package/dist/chat-composition.d.ts +4 -1
  127. package/dist/chat-composition.js +4 -1
  128. package/dist/chat-composition.js.map +1 -1
  129. package/dist/cli.d.ts +1 -0
  130. package/dist/cli.js +129 -55
  131. package/dist/cli.js.map +1 -1
  132. package/dist/construct-apply-host.d.ts +8 -7
  133. package/dist/construct-apply-host.js +20 -8
  134. package/dist/construct-apply-host.js.map +1 -1
  135. package/dist/construct-door.d.ts +2 -0
  136. package/dist/construct-door.js +4 -3
  137. package/dist/construct-door.js.map +1 -1
  138. package/dist/construct-ledger.d.ts +2 -0
  139. package/dist/construct-ledger.js +13 -1
  140. package/dist/construct-ledger.js.map +1 -1
  141. package/dist/content-cache-collection.d.ts +11 -4
  142. package/dist/content-cache-collection.js +74 -62
  143. package/dist/content-cache-collection.js.map +1 -1
  144. package/dist/content-cache-fences.d.ts +27 -0
  145. package/dist/content-cache-fences.js +116 -0
  146. package/dist/content-cache-fences.js.map +1 -0
  147. package/dist/content-cache-host.d.ts +163 -91
  148. package/dist/content-cache-host.js +531 -354
  149. package/dist/content-cache-host.js.map +1 -1
  150. package/dist/content-cache-index.d.ts +36 -7
  151. package/dist/content-cache-index.js +79 -32
  152. package/dist/content-cache-index.js.map +1 -1
  153. package/dist/content-cache-namespace.d.ts +28 -34
  154. package/dist/content-cache-namespace.js +85 -99
  155. package/dist/content-cache-namespace.js.map +1 -1
  156. package/dist/content-cache-partials.d.ts +37 -0
  157. package/dist/content-cache-partials.js +79 -0
  158. package/dist/content-cache-partials.js.map +1 -0
  159. package/dist/content-cache-retention.d.ts +27 -12
  160. package/dist/content-cache-retention.js +143 -132
  161. package/dist/content-cache-retention.js.map +1 -1
  162. package/dist/content-capture-pool.d.ts +70 -83
  163. package/dist/content-capture-pool.js +112 -82
  164. package/dist/content-capture-pool.js.map +1 -1
  165. package/dist/content-capture-worker.d.ts +3 -4
  166. package/dist/content-capture-worker.js +28 -35
  167. package/dist/content-capture-worker.js.map +1 -1
  168. package/dist/content-clock.d.ts +54 -28
  169. package/dist/content-clock.js +345 -102
  170. package/dist/content-clock.js.map +1 -1
  171. package/dist/content-direct.d.ts +0 -2
  172. package/dist/content-direct.js +53 -31
  173. package/dist/content-direct.js.map +1 -1
  174. package/dist/content-qualification.d.ts +72 -0
  175. package/dist/content-qualification.js +129 -0
  176. package/dist/content-qualification.js.map +1 -0
  177. package/dist/credentials-host.js +3 -2
  178. package/dist/credentials-host.js.map +1 -1
  179. package/dist/derived-relocation.d.ts +31 -0
  180. package/dist/derived-relocation.js +71 -0
  181. package/dist/derived-relocation.js.map +1 -0
  182. package/dist/detection/accepted-result.js +3 -3
  183. package/dist/detection/accepted-result.js.map +1 -1
  184. package/dist/detection/admission-save.d.ts +25 -14
  185. package/dist/detection/admission-save.js +34 -22
  186. package/dist/detection/admission-save.js.map +1 -1
  187. package/dist/detection/admission-units.d.ts +32 -20
  188. package/dist/detection/admission-units.js +230 -97
  189. package/dist/detection/admission-units.js.map +1 -1
  190. package/dist/detection/alias-examination.d.ts +5 -2
  191. package/dist/detection/alias-examination.js +15 -3
  192. package/dist/detection/alias-examination.js.map +1 -1
  193. package/dist/detection/apply-ownership.d.ts +70 -44
  194. package/dist/detection/apply-ownership.js +140 -132
  195. package/dist/detection/apply-ownership.js.map +1 -1
  196. package/dist/detection/basis-advanced.d.ts +4 -0
  197. package/dist/detection/basis-advanced.js +9 -0
  198. package/dist/detection/basis-advanced.js.map +1 -1
  199. package/dist/detection/cached-replay.d.ts +38 -0
  200. package/dist/detection/cached-replay.js +66 -0
  201. package/dist/detection/cached-replay.js.map +1 -0
  202. package/dist/detection/capture-outcome.js +33 -36
  203. package/dist/detection/capture-outcome.js.map +1 -1
  204. package/dist/detection/container-membership.d.ts +13 -25
  205. package/dist/detection/container-membership.js +24 -28
  206. package/dist/detection/container-membership.js.map +1 -1
  207. package/dist/detection/directory-proof.js +1 -1
  208. package/dist/detection/directory-proof.js.map +1 -1
  209. package/dist/detection/dispositions.d.ts +10 -33
  210. package/dist/detection/dispositions.js +27 -91
  211. package/dist/detection/dispositions.js.map +1 -1
  212. package/dist/detection/examinations.d.ts +33 -0
  213. package/dist/detection/examinations.js +50 -0
  214. package/dist/detection/examinations.js.map +1 -0
  215. package/dist/detection/ground-proof.d.ts +35 -11
  216. package/dist/detection/ground-proof.js +111 -52
  217. package/dist/detection/ground-proof.js.map +1 -1
  218. package/dist/detection/ground-reader.d.ts +10 -10
  219. package/dist/detection/ground-reader.js +19 -42
  220. package/dist/detection/ground-reader.js.map +1 -1
  221. package/dist/detection/identity-discovery.d.ts +1 -1
  222. package/dist/detection/identity-discovery.js +27 -35
  223. package/dist/detection/identity-discovery.js.map +1 -1
  224. package/dist/detection/maintenance-sweep.d.ts +5 -2
  225. package/dist/detection/maintenance-sweep.js +15 -5
  226. package/dist/detection/maintenance-sweep.js.map +1 -1
  227. package/dist/detection/notebook-basis.d.ts +6 -3
  228. package/dist/detection/notebook-basis.js +8 -5
  229. package/dist/detection/notebook-basis.js.map +1 -1
  230. package/dist/detection/owed-examinations.d.ts +22 -0
  231. package/dist/detection/owed-examinations.js +54 -0
  232. package/dist/detection/owed-examinations.js.map +1 -0
  233. package/dist/detection/owed-selection.d.ts +23 -20
  234. package/dist/detection/owed-selection.js +56 -43
  235. package/dist/detection/owed-selection.js.map +1 -1
  236. package/dist/detection/policy-owed.d.ts +17 -0
  237. package/dist/detection/policy-owed.js +33 -0
  238. package/dist/detection/policy-owed.js.map +1 -0
  239. package/dist/detection/repository-state.d.ts +44 -0
  240. package/dist/detection/repository-state.js +95 -0
  241. package/dist/detection/repository-state.js.map +1 -0
  242. package/dist/detection/reveal-save.d.ts +17 -0
  243. package/dist/detection/reveal-save.js +15 -0
  244. package/dist/detection/reveal-save.js.map +1 -0
  245. package/dist/detection/root-examination.d.ts +25 -13
  246. package/dist/detection/root-examination.js +273 -220
  247. package/dist/detection/root-examination.js.map +1 -1
  248. package/dist/detection/root-walk.d.ts +191 -0
  249. package/dist/detection/root-walk.js +1383 -0
  250. package/dist/detection/root-walk.js.map +1 -0
  251. package/dist/detection/runtime.d.ts +41 -53
  252. package/dist/detection/runtime.js +285 -345
  253. package/dist/detection/runtime.js.map +1 -1
  254. package/dist/detection/scope-frame.d.ts +82 -0
  255. package/dist/detection/scope-frame.js +183 -0
  256. package/dist/detection/scope-frame.js.map +1 -0
  257. package/dist/detection/scoped-identity-port.d.ts +11 -10
  258. package/dist/detection/scoped-identity-port.js +18 -25
  259. package/dist/detection/scoped-identity-port.js.map +1 -1
  260. package/dist/detection/sharing-policy.d.ts +14 -6
  261. package/dist/detection/sharing-policy.js +13 -7
  262. package/dist/detection/sharing-policy.js.map +1 -1
  263. package/dist/detection/spelled-lookup.d.ts +20 -0
  264. package/dist/detection/spelled-lookup.js +83 -0
  265. package/dist/detection/spelled-lookup.js.map +1 -0
  266. package/dist/detection/unread-content.d.ts +20 -0
  267. package/dist/detection/unread-content.js +33 -0
  268. package/dist/detection/unread-content.js.map +1 -0
  269. package/dist/detection/walk-law.d.ts +11 -21
  270. package/dist/detection/walk-law.js +14 -22
  271. package/dist/detection/walk-law.js.map +1 -1
  272. package/dist/detection/walked-roots.d.ts +17 -0
  273. package/dist/detection/walked-roots.js +27 -0
  274. package/dist/detection/walked-roots.js.map +1 -0
  275. package/dist/detection/withheld.d.ts +100 -0
  276. package/dist/detection/withheld.js +118 -0
  277. package/dist/detection/withheld.js.map +1 -0
  278. package/dist/development/profile.js +1 -1
  279. package/dist/development/profile.js.map +1 -1
  280. package/dist/drive/cloud-files/asks.d.ts +7 -0
  281. package/dist/drive/cloud-files/asks.js +181 -0
  282. package/dist/drive/cloud-files/asks.js.map +1 -0
  283. package/dist/drive/cloud-files/binding.d.ts +111 -0
  284. package/dist/drive/cloud-files/binding.js +31 -0
  285. package/dist/drive/cloud-files/binding.js.map +1 -0
  286. package/dist/drive/cloud-files/contents.d.ts +82 -0
  287. package/dist/drive/cloud-files/contents.js +204 -0
  288. package/dist/drive/cloud-files/contents.js.map +1 -0
  289. package/dist/drive/cloud-files/door.d.ts +11 -0
  290. package/dist/drive/cloud-files/door.js +118 -0
  291. package/dist/drive/cloud-files/door.js.map +1 -0
  292. package/dist/drive/cloud-files/paths.d.ts +42 -0
  293. package/dist/drive/cloud-files/paths.js +93 -0
  294. package/dist/drive/cloud-files/paths.js.map +1 -0
  295. package/dist/drive/cloud-files/populated.d.ts +15 -0
  296. package/dist/drive/cloud-files/populated.js +38 -0
  297. package/dist/drive/cloud-files/populated.js.map +1 -0
  298. package/dist/drive/cloud-files/reconcile.d.ts +17 -0
  299. package/dist/drive/cloud-files/reconcile.js +478 -0
  300. package/dist/drive/cloud-files/reconcile.js.map +1 -0
  301. package/dist/drive/cloud-files/sync-root.d.ts +34 -0
  302. package/dist/drive/cloud-files/sync-root.js +68 -0
  303. package/dist/drive/cloud-files/sync-root.js.map +1 -0
  304. package/dist/drive/cloud-files/turns.d.ts +9 -0
  305. package/dist/drive/cloud-files/turns.js +58 -0
  306. package/dist/drive/cloud-files/turns.js.map +1 -0
  307. package/dist/drive/cloud-files/writes.d.ts +27 -0
  308. package/dist/drive/cloud-files/writes.js +436 -0
  309. package/dist/drive/cloud-files/writes.js.map +1 -0
  310. package/dist/drive/computer.d.ts +19 -0
  311. package/dist/drive/computer.js +61 -0
  312. package/dist/drive/computer.js.map +1 -0
  313. package/dist/drive/fuse-opens.d.ts +32 -0
  314. package/dist/drive/fuse-opens.js +110 -0
  315. package/dist/drive/fuse-opens.js.map +1 -0
  316. package/dist/drive/fuse.d.ts +36 -0
  317. package/dist/drive/fuse.js +102 -0
  318. package/dist/drive/fuse.js.map +1 -0
  319. package/dist/drive/kept.d.ts +78 -0
  320. package/dist/drive/kept.js +263 -0
  321. package/dist/drive/kept.js.map +1 -0
  322. package/dist/drive/kernel.d.ts +17 -0
  323. package/dist/drive/kernel.js +36 -0
  324. package/dist/drive/kernel.js.map +1 -0
  325. package/dist/drive/layout.d.ts +18 -0
  326. package/dist/drive/layout.js +39 -0
  327. package/dist/drive/layout.js.map +1 -0
  328. package/dist/drive/mount.d.ts +107 -0
  329. package/dist/drive/mount.js +259 -0
  330. package/dist/drive/mount.js.map +1 -0
  331. package/dist/drive/mountpoint.d.ts +14 -0
  332. package/dist/drive/mountpoint.js +51 -0
  333. package/dist/drive/mountpoint.js.map +1 -0
  334. package/dist/drive/nfs/apple-double.d.ts +6 -0
  335. package/dist/drive/nfs/apple-double.js +140 -0
  336. package/dist/drive/nfs/apple-double.js.map +1 -0
  337. package/dist/drive/nfs/attributes.d.ts +64 -0
  338. package/dist/drive/nfs/attributes.js +97 -0
  339. package/dist/drive/nfs/attributes.js.map +1 -0
  340. package/dist/drive/nfs/handles.d.ts +44 -0
  341. package/dist/drive/nfs/handles.js +209 -0
  342. package/dist/drive/nfs/handles.js.map +1 -0
  343. package/dist/drive/nfs/mount3.d.ts +16 -0
  344. package/dist/drive/nfs/mount3.js +38 -0
  345. package/dist/drive/nfs/mount3.js.map +1 -0
  346. package/dist/drive/nfs/nfs3.d.ts +27 -0
  347. package/dist/drive/nfs/nfs3.js +516 -0
  348. package/dist/drive/nfs/nfs3.js.map +1 -0
  349. package/dist/drive/nfs/rpc.d.ts +66 -0
  350. package/dist/drive/nfs/rpc.js +122 -0
  351. package/dist/drive/nfs/rpc.js.map +1 -0
  352. package/dist/drive/nfs/server.d.ts +30 -0
  353. package/dist/drive/nfs/server.js +109 -0
  354. package/dist/drive/nfs/server.js.map +1 -0
  355. package/dist/drive/nfs/xdr.d.ts +44 -0
  356. package/dist/drive/nfs/xdr.js +111 -0
  357. package/dist/drive/nfs/xdr.js.map +1 -0
  358. package/dist/drive/nfs.d.ts +58 -0
  359. package/dist/drive/nfs.js +193 -0
  360. package/dist/drive/nfs.js.map +1 -0
  361. package/dist/drive/operations.d.ts +180 -0
  362. package/dist/drive/operations.js +358 -0
  363. package/dist/drive/operations.js.map +1 -0
  364. package/dist/drive/shelf.d.ts +9 -0
  365. package/dist/drive/shelf.js +41 -0
  366. package/dist/drive/shelf.js.map +1 -0
  367. package/dist/durability-barrier.d.ts +39 -11
  368. package/dist/durability-barrier.js +106 -41
  369. package/dist/durability-barrier.js.map +1 -1
  370. package/dist/entity-access-wire.d.ts +3 -2
  371. package/dist/entity-access-wire.js +9 -25
  372. package/dist/entity-access-wire.js.map +1 -1
  373. package/dist/entity-channel-holdings.d.ts +7 -7
  374. package/dist/entity-channel-holdings.js +49 -8
  375. package/dist/entity-channel-holdings.js.map +1 -1
  376. package/dist/entity-grant-watch.d.ts +9 -0
  377. package/dist/entity-grant-watch.js +29 -0
  378. package/dist/entity-grant-watch.js.map +1 -0
  379. package/dist/entity-record-observability.d.ts +1 -1
  380. package/dist/entity-record-observability.js +34 -29
  381. package/dist/entity-record-observability.js.map +1 -1
  382. package/dist/entity-record-saves.d.ts +34 -7
  383. package/dist/entity-record-saves.js +72 -20
  384. package/dist/entity-record-saves.js.map +1 -1
  385. package/dist/entity-record-store.d.ts +43 -15
  386. package/dist/entity-record-store.js +160 -55
  387. package/dist/entity-record-store.js.map +1 -1
  388. package/dist/error-facts.d.ts +24 -0
  389. package/dist/error-facts.js +35 -0
  390. package/dist/error-facts.js.map +1 -0
  391. package/dist/faults/drain.d.ts +27 -0
  392. package/dist/faults/drain.js +211 -0
  393. package/dist/faults/drain.js.map +1 -0
  394. package/dist/faults/queue.d.ts +46 -0
  395. package/dist/faults/queue.js +100 -0
  396. package/dist/faults/queue.js.map +1 -0
  397. package/dist/faults/show.d.ts +7 -0
  398. package/dist/faults/show.js +32 -0
  399. package/dist/faults/show.js.map +1 -0
  400. package/dist/files-mcp-host.d.ts +58 -0
  401. package/dist/files-mcp-host.js +63 -0
  402. package/dist/files-mcp-host.js.map +1 -0
  403. package/dist/files-observability.d.ts +5 -2
  404. package/dist/files-observability.js.map +1 -1
  405. package/dist/files-program/client.d.ts +136 -0
  406. package/dist/files-program/client.js +442 -0
  407. package/dist/files-program/client.js.map +1 -0
  408. package/dist/files-program/journeys.d.ts +15 -0
  409. package/dist/files-program/journeys.js +79 -0
  410. package/dist/files-program/journeys.js.map +1 -0
  411. package/dist/files-program/program.d.ts +1 -0
  412. package/dist/files-program/program.js +344 -0
  413. package/dist/files-program/program.js.map +1 -0
  414. package/dist/files-program/protocol.d.ts +180 -0
  415. package/dist/files-program/protocol.js +7 -0
  416. package/dist/files-program/protocol.js.map +1 -0
  417. package/dist/files-register-host.d.ts +18 -21
  418. package/dist/files-register-host.js +104 -94
  419. package/dist/files-register-host.js.map +1 -1
  420. package/dist/files-trace.d.ts +29 -9
  421. package/dist/files-trace.js +58 -14
  422. package/dist/files-trace.js.map +1 -1
  423. package/dist/filesystem.d.ts +27 -9
  424. package/dist/filesystem.js +94 -56
  425. package/dist/filesystem.js.map +1 -1
  426. package/dist/flush.d.ts +19 -0
  427. package/dist/flush.js +84 -0
  428. package/dist/flush.js.map +1 -0
  429. package/dist/gateway.js +5 -2
  430. package/dist/gateway.js.map +1 -1
  431. package/dist/git/ground-owners.d.ts +15 -0
  432. package/dist/git/ground-owners.js +67 -0
  433. package/dist/git/ground-owners.js.map +1 -0
  434. package/dist/git/held-package.d.ts +67 -0
  435. package/dist/git/held-package.js +95 -0
  436. package/dist/git/held-package.js.map +1 -0
  437. package/dist/git/home.d.ts +59 -0
  438. package/dist/git/home.js +132 -0
  439. package/dist/git/home.js.map +1 -0
  440. package/dist/git/marker.d.ts +21 -0
  441. package/dist/git/marker.js +30 -0
  442. package/dist/git/marker.js.map +1 -0
  443. package/dist/git/named-objects.d.ts +24 -0
  444. package/dist/git/named-objects.js +176 -0
  445. package/dist/git/named-objects.js.map +1 -0
  446. package/dist/git/objects.d.ts +30 -0
  447. package/dist/git/objects.js +88 -0
  448. package/dist/git/objects.js.map +1 -0
  449. package/dist/git/play.d.ts +30 -0
  450. package/dist/git/play.js +305 -0
  451. package/dist/git/play.js.map +1 -0
  452. package/dist/git/quarantine.d.ts +48 -0
  453. package/dist/git/quarantine.js +150 -0
  454. package/dist/git/quarantine.js.map +1 -0
  455. package/dist/git/rail.d.ts +206 -0
  456. package/dist/git/rail.js +885 -0
  457. package/dist/git/rail.js.map +1 -0
  458. package/dist/git/read-state.d.ts +49 -0
  459. package/dist/git/read-state.js +238 -0
  460. package/dist/git/read-state.js.map +1 -0
  461. package/dist/git/repository.d.ts +62 -0
  462. package/dist/git/repository.js +130 -0
  463. package/dist/git/repository.js.map +1 -0
  464. package/dist/git/write-files.d.ts +29 -0
  465. package/dist/git/write-files.js +215 -0
  466. package/dist/git/write-files.js.map +1 -0
  467. package/dist/git-binding.d.ts +37 -49
  468. package/dist/git-binding.js +262 -134
  469. package/dist/git-binding.js.map +1 -1
  470. package/dist/git-cat-file.d.ts +28 -0
  471. package/dist/git-cat-file.js +125 -0
  472. package/dist/git-cat-file.js.map +1 -0
  473. package/dist/git-command.d.ts +45 -10
  474. package/dist/git-command.js +197 -89
  475. package/dist/git-command.js.map +1 -1
  476. package/dist/git-index-entries.d.ts +10 -8
  477. package/dist/git-index-entries.js +21 -39
  478. package/dist/git-index-entries.js.map +1 -1
  479. package/dist/git-index-format.d.ts +35 -18
  480. package/dist/git-index-format.js +210 -53
  481. package/dist/git-index-format.js.map +1 -1
  482. package/dist/git-install-lines.d.ts +12 -0
  483. package/dist/git-install-lines.js +22 -0
  484. package/dist/git-install-lines.js.map +1 -0
  485. package/dist/git-launcher-process.d.ts +1 -0
  486. package/dist/git-launcher-process.js +81 -0
  487. package/dist/git-launcher-process.js.map +1 -0
  488. package/dist/git-launcher.d.ts +70 -0
  489. package/dist/git-launcher.js +178 -0
  490. package/dist/git-launcher.js.map +1 -0
  491. package/dist/graph-heads.d.ts +71 -0
  492. package/dist/graph-heads.js +90 -0
  493. package/dist/graph-heads.js.map +1 -0
  494. package/dist/ground-basis.d.ts +141 -105
  495. package/dist/ground-basis.js +367 -460
  496. package/dist/ground-basis.js.map +1 -1
  497. package/dist/ground-checkpoint-worker.js +26 -25
  498. package/dist/ground-checkpoint-worker.js.map +1 -1
  499. package/dist/ground-checkpoints.d.ts +1 -1
  500. package/dist/ground-checkpoints.js +6 -6
  501. package/dist/ground-contract.d.ts +11 -0
  502. package/dist/ground-contract.js +115 -0
  503. package/dist/ground-contract.js.map +1 -0
  504. package/dist/ground-coordination.d.ts +30 -20
  505. package/dist/ground-coordination.js +96 -51
  506. package/dist/ground-coordination.js.map +1 -1
  507. package/dist/ground-database.d.ts +11 -13
  508. package/dist/ground-database.js +283 -97
  509. package/dist/ground-database.js.map +1 -1
  510. package/dist/ground-differences.d.ts +19 -18
  511. package/dist/ground-differences.js +20 -42
  512. package/dist/ground-differences.js.map +1 -1
  513. package/dist/ground-initialization.d.ts +3 -0
  514. package/dist/ground-initialization.js.map +1 -1
  515. package/dist/ground-install-saves.d.ts +61 -20
  516. package/dist/ground-install-saves.js +56 -52
  517. package/dist/ground-install-saves.js.map +1 -1
  518. package/dist/ground-inventory-schema.d.ts +42 -2
  519. package/dist/ground-inventory-schema.js +244 -31
  520. package/dist/ground-inventory-schema.js.map +1 -1
  521. package/dist/ground-marks.d.ts +49 -0
  522. package/dist/ground-marks.js +105 -0
  523. package/dist/ground-marks.js.map +1 -0
  524. package/dist/ground-profile.d.ts +7 -0
  525. package/dist/ground-profile.js +85 -16
  526. package/dist/ground-profile.js.map +1 -1
  527. package/dist/ground-reads.d.ts +86 -0
  528. package/dist/ground-reads.js +256 -0
  529. package/dist/ground-reads.js.map +1 -0
  530. package/dist/ground-relations.d.ts +57 -0
  531. package/dist/ground-relations.js +206 -0
  532. package/dist/ground-relations.js.map +1 -0
  533. package/dist/ground-root-index.d.ts +3 -2
  534. package/dist/ground-root-index.js +4 -3
  535. package/dist/ground-root-index.js.map +1 -1
  536. package/dist/ground-row.d.ts +23 -7
  537. package/dist/ground-row.js +27 -11
  538. package/dist/ground-row.js.map +1 -1
  539. package/dist/ground-save-ops.d.ts +42 -26
  540. package/dist/ground-save-ops.js +46 -26
  541. package/dist/ground-save-ops.js.map +1 -1
  542. package/dist/ground-saver-worker.js +171 -44
  543. package/dist/ground-saver-worker.js.map +1 -1
  544. package/dist/ground-saver.d.ts +35 -7
  545. package/dist/ground-saver.js +52 -25
  546. package/dist/ground-saver.js.map +1 -1
  547. package/dist/ground-store.d.ts +51 -10
  548. package/dist/ground-store.js +439 -89
  549. package/dist/ground-store.js.map +1 -1
  550. package/dist/index.d.ts +2 -2
  551. package/dist/index.js +1 -1
  552. package/dist/index.js.map +1 -1
  553. package/dist/initial-publication.d.ts +42 -0
  554. package/dist/initial-publication.js +42 -0
  555. package/dist/initial-publication.js.map +1 -0
  556. package/dist/installation/environment.d.ts +4 -0
  557. package/dist/installation/environment.js +13 -0
  558. package/dist/installation/environment.js.map +1 -1
  559. package/dist/keychain/cli-io.d.ts +8 -0
  560. package/dist/keychain/cli-io.js +55 -0
  561. package/dist/keychain/cli-io.js.map +1 -0
  562. package/dist/keychain/cli.d.ts +12 -0
  563. package/dist/keychain/cli.js +48 -0
  564. package/dist/keychain/cli.js.map +1 -0
  565. package/dist/keychain/host.d.ts +28 -0
  566. package/dist/keychain/host.js +43 -0
  567. package/dist/keychain/host.js.map +1 -0
  568. package/dist/keychain/http-mount.d.ts +16 -0
  569. package/dist/keychain/http-mount.js +74 -0
  570. package/dist/keychain/http-mount.js.map +1 -0
  571. package/dist/keychain/key-wire.d.ts +12 -0
  572. package/dist/keychain/key-wire.js +45 -0
  573. package/dist/keychain/key-wire.js.map +1 -0
  574. package/dist/keychain/presence-mac.d.ts +8 -0
  575. package/dist/keychain/presence-mac.js +26 -0
  576. package/dist/keychain/presence-mac.js.map +1 -0
  577. package/dist/keychain/presence.d.ts +9 -0
  578. package/dist/keychain/presence.js +24 -0
  579. package/dist/keychain/presence.js.map +1 -0
  580. package/dist/keychain/rail.d.ts +19 -0
  581. package/dist/keychain/rail.js +20 -0
  582. package/dist/keychain/rail.js.map +1 -0
  583. package/dist/keychain/secret-apply.d.ts +22 -0
  584. package/dist/keychain/secret-apply.js +46 -0
  585. package/dist/keychain/secret-apply.js.map +1 -0
  586. package/dist/keychain/shelf-from-ledger.d.ts +15 -0
  587. package/dist/keychain/shelf-from-ledger.js +18 -0
  588. package/dist/keychain/shelf-from-ledger.js.map +1 -0
  589. package/dist/keychain/use-log.d.ts +7 -0
  590. package/dist/keychain/use-log.js +15 -0
  591. package/dist/keychain/use-log.js.map +1 -0
  592. package/dist/keychain/vault-file.d.ts +12 -0
  593. package/dist/keychain/vault-file.js +19 -0
  594. package/dist/keychain/vault-file.js.map +1 -0
  595. package/dist/line-judge.d.ts +39 -0
  596. package/dist/line-judge.js +177 -0
  597. package/dist/line-judge.js.map +1 -0
  598. package/dist/line-loops.d.ts +22 -0
  599. package/dist/line-loops.js +19 -0
  600. package/dist/line-loops.js.map +1 -0
  601. package/dist/link-target.d.ts +16 -0
  602. package/dist/link-target.js +81 -0
  603. package/dist/link-target.js.map +1 -0
  604. package/dist/loop-watch.d.ts +17 -0
  605. package/dist/loop-watch.js +44 -0
  606. package/dist/loop-watch.js.map +1 -0
  607. package/dist/machine-host.d.ts +93 -23
  608. package/dist/machine-host.js +344 -179
  609. package/dist/machine-host.js.map +1 -1
  610. package/dist/main.js +3 -1
  611. package/dist/main.js.map +1 -1
  612. package/dist/materialize-records.d.ts +98 -0
  613. package/dist/materialize-records.js +446 -0
  614. package/dist/materialize-records.js.map +1 -0
  615. package/dist/materialized-graph.d.ts +14 -21
  616. package/dist/materialized-graph.js +1 -135
  617. package/dist/materialized-graph.js.map +1 -1
  618. package/dist/mount.d.ts +13 -0
  619. package/dist/mount.js +33 -0
  620. package/dist/mount.js.map +1 -0
  621. package/dist/native/cloud-files.node +0 -0
  622. package/dist/native/fsevents-stream.node +0 -0
  623. package/dist/native/inotify.node +0 -0
  624. package/dist/native/windows-fs.node +0 -0
  625. package/dist/on-demand-roots.d.ts +31 -0
  626. package/dist/on-demand-roots.js +18 -0
  627. package/dist/on-demand-roots.js.map +1 -0
  628. package/dist/open-standing.d.ts +8 -0
  629. package/dist/open-standing.js +109 -0
  630. package/dist/open-standing.js.map +1 -0
  631. package/dist/own-results.d.ts +37 -0
  632. package/dist/own-results.js +98 -0
  633. package/dist/own-results.js.map +1 -0
  634. package/dist/package-pages.d.ts +41 -0
  635. package/dist/package-pages.js +76 -0
  636. package/dist/package-pages.js.map +1 -0
  637. package/dist/patient-flush.d.ts +24 -0
  638. package/dist/patient-flush.js +37 -0
  639. package/dist/patient-flush.js.map +1 -0
  640. package/dist/physical-path-witness.d.ts +2 -11
  641. package/dist/physical-path-witness.js +19 -43
  642. package/dist/physical-path-witness.js.map +1 -1
  643. package/dist/placement-owed.d.ts +28 -0
  644. package/dist/placement-owed.js +32 -0
  645. package/dist/placement-owed.js.map +1 -0
  646. package/dist/placement-tidy.d.ts +57 -0
  647. package/dist/placement-tidy.js +313 -0
  648. package/dist/placement-tidy.js.map +1 -0
  649. package/dist/platform-product-host.d.ts +12 -0
  650. package/dist/platform-product-host.js +23 -1
  651. package/dist/platform-product-host.js.map +1 -1
  652. package/dist/platform-tools.d.ts +1 -0
  653. package/dist/platform-tools.js +11 -1
  654. package/dist/platform-tools.js.map +1 -1
  655. package/dist/process-lifecycle.d.ts +7 -0
  656. package/dist/process-lifecycle.js +13 -0
  657. package/dist/process-lifecycle.js.map +1 -1
  658. package/dist/pty-host.d.ts +2 -0
  659. package/dist/pty-host.js +1 -0
  660. package/dist/pty-host.js.map +1 -1
  661. package/dist/received-state.d.ts +90 -0
  662. package/dist/received-state.js +167 -0
  663. package/dist/received-state.js.map +1 -0
  664. package/dist/reference-placement.d.ts +26 -0
  665. package/dist/reference-placement.js +121 -0
  666. package/dist/reference-placement.js.map +1 -0
  667. package/dist/registry-graph.d.ts +63 -55
  668. package/dist/registry-graph.js +291 -170
  669. package/dist/registry-graph.js.map +1 -1
  670. package/dist/registry-page-cache.d.ts +2 -4
  671. package/dist/registry-page-cache.js.map +1 -1
  672. package/dist/root-install.d.ts +72 -0
  673. package/dist/root-install.js +178 -0
  674. package/dist/root-install.js.map +1 -0
  675. package/dist/runtime-activity.d.ts +20 -0
  676. package/dist/runtime-activity.js +86 -0
  677. package/dist/runtime-activity.js.map +1 -0
  678. package/dist/runtime-argv.d.ts +8 -0
  679. package/dist/runtime-argv.js +37 -0
  680. package/dist/runtime-argv.js.map +1 -0
  681. package/dist/runtime-command-host.d.ts +9 -3
  682. package/dist/runtime-command-host.js +27 -7
  683. package/dist/runtime-command-host.js.map +1 -1
  684. package/dist/runtime-node-flags.d.ts +6 -6
  685. package/dist/runtime-node-flags.js +6 -6
  686. package/dist/runtime-wire-host.d.ts +4 -1
  687. package/dist/runtime-wire-host.js +11 -6
  688. package/dist/runtime-wire-host.js.map +1 -1
  689. package/dist/sha256.d.ts +1 -0
  690. package/dist/sha256.js +4 -0
  691. package/dist/sha256.js.map +1 -0
  692. package/dist/sharing-admission.d.ts +9 -4
  693. package/dist/sharing-admission.js +57 -98
  694. package/dist/sharing-admission.js.map +1 -1
  695. package/dist/sharing-host.d.ts +6 -11
  696. package/dist/sharing-host.js +6 -10
  697. package/dist/sharing-host.js.map +1 -1
  698. package/dist/snapshot-delivery-baseline.d.ts +23 -13
  699. package/dist/snapshot-delivery-baseline.js +37 -40
  700. package/dist/snapshot-delivery-baseline.js.map +1 -1
  701. package/dist/socket-marking.d.ts +9 -0
  702. package/dist/socket-marking.js +26 -0
  703. package/dist/socket-marking.js.map +1 -0
  704. package/dist/source-proof.d.ts +2 -15
  705. package/dist/source-proof.js +9 -4
  706. package/dist/source-proof.js.map +1 -1
  707. package/dist/source-signature.d.ts +122 -21
  708. package/dist/source-signature.js +139 -28
  709. package/dist/source-signature.js.map +1 -1
  710. package/dist/source-witness.d.ts +2 -8
  711. package/dist/source-witness.js +1 -14
  712. package/dist/source-witness.js.map +1 -1
  713. package/dist/sqlite-durability.d.ts +1 -0
  714. package/dist/sqlite-durability.js +2 -0
  715. package/dist/sqlite-durability.js.map +1 -1
  716. package/dist/sqlite.js +8 -8
  717. package/dist/sqlite.js.map +1 -1
  718. package/dist/sync-address.d.ts +0 -3
  719. package/dist/sync-address.js +1 -23
  720. package/dist/sync-address.js.map +1 -1
  721. package/dist/sync-cli.d.ts +6 -2
  722. package/dist/sync-cli.js +19 -4
  723. package/dist/sync-cli.js.map +1 -1
  724. package/dist/sync-setting.d.ts +16 -1
  725. package/dist/sync-setting.js +6 -0
  726. package/dist/sync-setting.js.map +1 -1
  727. package/dist/transfer-instrumentation.d.ts +3 -3
  728. package/dist/transfer-instrumentation.js +7 -5
  729. package/dist/transfer-instrumentation.js.map +1 -1
  730. package/dist/turns.d.ts +4 -2
  731. package/dist/turns.js +17 -15
  732. package/dist/turns.js.map +1 -1
  733. package/dist/updates/artifacts.d.ts +9 -4
  734. package/dist/updates/artifacts.js +132 -9
  735. package/dist/updates/artifacts.js.map +1 -1
  736. package/dist/updates/controller.js +4 -3
  737. package/dist/updates/controller.js.map +1 -1
  738. package/dist/updates/locked-packages.d.ts +4 -0
  739. package/dist/updates/locked-packages.js +26 -0
  740. package/dist/updates/locked-packages.js.map +1 -0
  741. package/dist/updates/store.d.ts +5 -4
  742. package/dist/updates/store.js +5 -4
  743. package/dist/updates/store.js.map +1 -1
  744. package/dist/user-ground-host.d.ts +534 -179
  745. package/dist/user-ground-host.js +3293 -5218
  746. package/dist/user-ground-host.js.map +1 -1
  747. package/dist/watching/fsevents.d.ts +22 -6
  748. package/dist/watching/fsevents.js +29 -7
  749. package/dist/watching/fsevents.js.map +1 -1
  750. package/dist/watching/git-storage.d.ts +22 -0
  751. package/dist/watching/git-storage.js +125 -0
  752. package/dist/watching/git-storage.js.map +1 -0
  753. package/dist/watching/host.d.ts +149 -23
  754. package/dist/watching/host.js +706 -206
  755. package/dist/watching/host.js.map +1 -1
  756. package/dist/watching/index.d.ts +3 -2
  757. package/dist/watching/index.js +2 -1
  758. package/dist/watching/index.js.map +1 -1
  759. package/dist/watching/inotify.d.ts +81 -0
  760. package/dist/watching/inotify.js +184 -0
  761. package/dist/watching/inotify.js.map +1 -0
  762. package/dist/windows-fs.d.ts +12 -0
  763. package/dist/windows-fs.js +19 -0
  764. package/dist/windows-fs.js.map +1 -0
  765. package/dist/windows-owner-only.d.ts +6 -0
  766. package/dist/windows-owner-only.js +84 -0
  767. package/dist/windows-owner-only.js.map +1 -0
  768. package/dist/wire-client.d.ts +13 -11
  769. package/dist/wire-client.js +51 -78
  770. package/dist/wire-client.js.map +1 -1
  771. package/dist/wire-join.d.ts +19 -0
  772. package/dist/wire-join.js +54 -0
  773. package/dist/wire-join.js.map +1 -0
  774. package/dist/wire-outbox.d.ts +3 -0
  775. package/dist/wire-outbox.js +6 -1
  776. package/dist/wire-outbox.js.map +1 -1
  777. package/dist/wire-request-scope.d.ts +2 -1
  778. package/dist/wire-request-scope.js +2 -1
  779. package/dist/wire-request-scope.js.map +1 -1
  780. package/dist/workspace-add-intent.d.ts +41 -0
  781. package/dist/workspace-add-intent.js +107 -0
  782. package/dist/workspace-add-intent.js.map +1 -0
  783. package/dist/workspace-add-staging.d.ts +78 -74
  784. package/dist/workspace-add-staging.js +131 -179
  785. package/dist/workspace-add-staging.js.map +1 -1
  786. package/dist/workspace-host.d.ts +17 -0
  787. package/dist/workspace-host.js +17 -21
  788. package/dist/workspace-host.js.map +1 -1
  789. package/examinations/fixtures/private-wire-authority.js +534 -499
  790. package/examinations/native-service.mjs +29 -4
  791. package/examinations/runtime-upgrade.native-test.mjs +16 -1
  792. package/npm-shrinkwrap.json +253 -464
  793. package/package.json +29 -33
  794. package/dist/apply-cleanup.d.ts +0 -28
  795. package/dist/apply-cleanup.js +0 -166
  796. package/dist/apply-cleanup.js.map +0 -1
  797. package/dist/apply-recovery.d.ts +0 -47
  798. package/dist/apply-recovery.js +0 -100
  799. package/dist/apply-recovery.js.map +0 -1
  800. package/dist/apply-rows.d.ts +0 -72
  801. package/dist/apply-rows.js +0 -150
  802. package/dist/apply-rows.js.map +0 -1
  803. package/dist/apply-saves.d.ts +0 -85
  804. package/dist/apply-saves.js +0 -238
  805. package/dist/apply-saves.js.map +0 -1
  806. package/dist/bounded-for-each.d.ts +0 -3
  807. package/dist/bounded-for-each.js +0 -26
  808. package/dist/bounded-for-each.js.map +0 -1
  809. package/dist/content-cache-ownership.d.ts +0 -13
  810. package/dist/content-cache-ownership.js +0 -75
  811. package/dist/content-cache-ownership.js.map +0 -1
  812. package/dist/content-stream-thread.d.ts +0 -60
  813. package/dist/content-stream-thread.js +0 -95
  814. package/dist/content-stream-thread.js.map +0 -1
  815. package/dist/content-stream-worker.d.ts +0 -7
  816. package/dist/content-stream-worker.js +0 -52
  817. package/dist/content-stream-worker.js.map +0 -1
  818. package/dist/declaration-absorption.d.ts +0 -37
  819. package/dist/declaration-absorption.js +0 -119
  820. package/dist/declaration-absorption.js.map +0 -1
  821. package/dist/declaration-chain.d.ts +0 -36
  822. package/dist/declaration-chain.js +0 -96
  823. package/dist/declaration-chain.js.map +0 -1
  824. package/dist/declaration-commit.d.ts +0 -31
  825. package/dist/declaration-commit.js +0 -49
  826. package/dist/declaration-commit.js.map +0 -1
  827. package/dist/declaration-hold.d.ts +0 -22
  828. package/dist/declaration-hold.js +0 -24
  829. package/dist/declaration-hold.js.map +0 -1
  830. package/dist/declaration-journal.d.ts +0 -62
  831. package/dist/declaration-journal.js +0 -99
  832. package/dist/declaration-journal.js.map +0 -1
  833. package/dist/declaration-save.d.ts +0 -31
  834. package/dist/declaration-save.js +0 -134
  835. package/dist/declaration-save.js.map +0 -1
  836. package/dist/detection/disposition-rows.d.ts +0 -18
  837. package/dist/detection/disposition-rows.js +0 -29
  838. package/dist/detection/disposition-rows.js.map +0 -1
  839. package/dist/detection/git-notice.d.ts +0 -88
  840. package/dist/detection/git-notice.js +0 -444
  841. package/dist/detection/git-notice.js.map +0 -1
  842. package/dist/detection/held-territory.d.ts +0 -51
  843. package/dist/detection/held-territory.js +0 -205
  844. package/dist/detection/held-territory.js.map +0 -1
  845. package/dist/detection/name-reach.d.ts +0 -12
  846. package/dist/detection/name-reach.js +0 -28
  847. package/dist/detection/name-reach.js.map +0 -1
  848. package/dist/detection/portable.d.ts +0 -66
  849. package/dist/detection/portable.js +0 -137
  850. package/dist/detection/portable.js.map +0 -1
  851. package/dist/detection/repository-publication.d.ts +0 -20
  852. package/dist/detection/repository-publication.js +0 -79
  853. package/dist/detection/repository-publication.js.map +0 -1
  854. package/dist/detection/repository-routes.d.ts +0 -43
  855. package/dist/detection/repository-routes.js +0 -98
  856. package/dist/detection/repository-routes.js.map +0 -1
  857. package/dist/detection/seal-law.d.ts +0 -66
  858. package/dist/detection/seal-law.js +0 -116
  859. package/dist/detection/seal-law.js.map +0 -1
  860. package/dist/detection/verified-content.d.ts +0 -6
  861. package/dist/detection/verified-content.js +0 -12
  862. package/dist/detection/verified-content.js.map +0 -1
  863. package/dist/entity-apply-host.d.ts +0 -80
  864. package/dist/entity-apply-host.js +0 -2316
  865. package/dist/entity-apply-host.js.map +0 -1
  866. package/dist/entity-apply-store.d.ts +0 -105
  867. package/dist/entity-apply-store.js +0 -290
  868. package/dist/entity-apply-store.js.map +0 -1
  869. package/dist/git-capture.d.ts +0 -36
  870. package/dist/git-capture.js +0 -91
  871. package/dist/git-capture.js.map +0 -1
  872. package/dist/git-card.d.ts +0 -17
  873. package/dist/git-card.js +0 -133
  874. package/dist/git-card.js.map +0 -1
  875. package/dist/git-checkpoint-construction.d.ts +0 -40
  876. package/dist/git-checkpoint-construction.js +0 -102
  877. package/dist/git-checkpoint-construction.js.map +0 -1
  878. package/dist/git-checkpoint-preparation.d.ts +0 -37
  879. package/dist/git-checkpoint-preparation.js +0 -145
  880. package/dist/git-checkpoint-preparation.js.map +0 -1
  881. package/dist/git-configuration.d.ts +0 -40
  882. package/dist/git-configuration.js +0 -217
  883. package/dist/git-configuration.js.map +0 -1
  884. package/dist/git-evidence.d.ts +0 -61
  885. package/dist/git-evidence.js +0 -181
  886. package/dist/git-evidence.js.map +0 -1
  887. package/dist/git-index-witness.d.ts +0 -33
  888. package/dist/git-index-witness.js +0 -69
  889. package/dist/git-index-witness.js.map +0 -1
  890. package/dist/git-literal-host.d.ts +0 -82
  891. package/dist/git-literal-host.js +0 -173
  892. package/dist/git-literal-host.js.map +0 -1
  893. package/dist/git-literal-read.d.ts +0 -88
  894. package/dist/git-literal-read.js +0 -170
  895. package/dist/git-literal-read.js.map +0 -1
  896. package/dist/git-literal-replay.d.ts +0 -33
  897. package/dist/git-literal-replay.js +0 -269
  898. package/dist/git-literal-replay.js.map +0 -1
  899. package/dist/git-native-file.d.ts +0 -42
  900. package/dist/git-native-file.js +0 -145
  901. package/dist/git-native-file.js.map +0 -1
  902. package/dist/git-native-index.d.ts +0 -21
  903. package/dist/git-native-index.js +0 -44
  904. package/dist/git-native-index.js.map +0 -1
  905. package/dist/git-operation-host.d.ts +0 -48
  906. package/dist/git-operation-host.js +0 -127
  907. package/dist/git-operation-host.js.map +0 -1
  908. package/dist/git-private-index.d.ts +0 -11
  909. package/dist/git-private-index.js +0 -42
  910. package/dist/git-private-index.js.map +0 -1
  911. package/dist/git-private-repository.d.ts +0 -4
  912. package/dist/git-private-repository.js +0 -69
  913. package/dist/git-private-repository.js.map +0 -1
  914. package/dist/git-private-view.d.ts +0 -57
  915. package/dist/git-private-view.js +0 -240
  916. package/dist/git-private-view.js.map +0 -1
  917. package/dist/git-ref-store.d.ts +0 -12
  918. package/dist/git-ref-store.js +0 -68
  919. package/dist/git-ref-store.js.map +0 -1
  920. package/dist/git-registration-host.d.ts +0 -38
  921. package/dist/git-registration-host.js +0 -96
  922. package/dist/git-registration-host.js.map +0 -1
  923. package/dist/git-repository-host.d.ts +0 -191
  924. package/dist/git-repository-host.js +0 -917
  925. package/dist/git-repository-host.js.map +0 -1
  926. package/dist/git-worktree-host.d.ts +0 -2
  927. package/dist/git-worktree-host.js +0 -16
  928. package/dist/git-worktree-host.js.map +0 -1
  929. package/dist/graph-publication.d.ts +0 -75
  930. package/dist/graph-publication.js +0 -203
  931. package/dist/graph-publication.js.map +0 -1
  932. package/dist/ground-territory.d.ts +0 -130
  933. package/dist/ground-territory.js +0 -511
  934. package/dist/ground-territory.js.map +0 -1
  935. package/dist/register-upload-fusion.d.ts +0 -84
  936. package/dist/register-upload-fusion.js +0 -172
  937. package/dist/register-upload-fusion.js.map +0 -1
  938. package/dist/repository-identity-steps.d.ts +0 -5
  939. package/dist/repository-identity-steps.js +0 -33
  940. package/dist/repository-identity-steps.js.map +0 -1
@@ -1,13 +1,24 @@
1
- import { createHash, randomUUID } from "node:crypto";
2
- import { constants, chmodSync, copyFileSync, createReadStream, createWriteStream, existsSync, mkdirSync, readFileSync, renameSync, rmSync, writeFileSync, } from "node:fs";
3
- import { chmod, mkdir } from "node:fs/promises";
4
- import { dirname } from "node:path";
5
- import { once } from "node:events";
6
- import { boundedForEach } from "./bounded-for-each.js";
1
+ import { randomUUID } from "node:crypto";
2
+ import { constants, chmodSync, createReadStream, createWriteStream, existsSync, mkdirSync, readFileSync, renameSync, rmSync, statSync, writeFileSync, } from "node:fs";
3
+ import { chmod, copyFile, rename, rm } from "node:fs/promises";
4
+ import { dirname, isAbsolute, join, relative, sep } from "node:path";
5
+ import { pipeline } from "node:stream/promises";
6
+ import { lockToCurrentUser } from "./windows-owner-only.js";
7
7
  export function ensurePrivateDir(directory) {
8
8
  mkdirSync(directory, { recursive: true, mode: 0o700 });
9
9
  chmodSync(directory, 0o700);
10
10
  }
11
+ /** A folder that holds secrets: only its user can open it or anything in it.
12
+ * POSIX says so with mode 0700; Windows ignores modes, so there the folder's
13
+ * access list is locked to the user, and everything inside inherits it. A
14
+ * Windows chmod only flips the read-only flag, and needs the very write right
15
+ * a stray deny withholds, so there the lock alone decides. */
16
+ export function ensureOwnerOnlyDir(directory) {
17
+ if (process.platform !== "win32")
18
+ return ensurePrivateDir(directory);
19
+ mkdirSync(directory, { recursive: true });
20
+ lockToCurrentUser(directory);
21
+ }
11
22
  /** User-visible directories: mode is not portable state. A fresh directory
12
23
  * gets 0755 — the same default a fresh mkdir gives the user — and an
13
24
  * existing directory keeps whatever mode the user chose. */
@@ -16,14 +27,45 @@ export function ensureUserDir(directory) {
16
27
  chmodSync(directory, 0o755);
17
28
  }
18
29
  }
19
- /** The batch form of ensureUserDir: the same mode law for a whole directory
20
- * skeleton, created ahead of the files it will hold and off the event loop. */
21
- export async function ensureUserDirs(directories, concurrency) {
22
- await boundedForEach(directories, concurrency, async (directory) => {
23
- if (await mkdir(directory, { recursive: true, mode: 0o755 }) !== undefined) {
24
- await chmod(directory, 0o755);
30
+ /** `mkdir -p` bounded by ground that already stands: it creates the missing
31
+ * directories strictly beneath `anchor`, each with `mode`, and never `anchor`
32
+ * or anything above it. Ground that vanished stays vanished, and the caller's
33
+ * write fails with ENOENT instead of re-creating it empty, which Detect would
34
+ * read as the person emptying it. Existing directories keep their mode. */
35
+ export function ensureDirBeneath(anchor, directory, mode) {
36
+ const within = relative(anchor, directory);
37
+ if (within === ".." || within.startsWith(`..${sep}`) || isAbsolute(within)) {
38
+ throw new Error(`${directory} does not lie beneath ${anchor}`);
39
+ }
40
+ /** Creates one level unless it already stands. */
41
+ const create = (path) => {
42
+ try {
43
+ mkdirSync(path, { mode });
44
+ }
45
+ catch (error) {
46
+ if (error.code === "EEXIST")
47
+ return;
48
+ throw error;
49
+ }
50
+ chmodSync(path, mode);
51
+ };
52
+ const make = (path) => {
53
+ if (path === anchor) {
54
+ if (!statSync(path).isDirectory())
55
+ throw Object.assign(new Error(`${anchor} is not a directory`), { code: "ENOTDIR" });
56
+ return;
57
+ }
58
+ try {
59
+ create(path);
25
60
  }
26
- });
61
+ catch (error) {
62
+ if (error.code !== "ENOENT")
63
+ throw error;
64
+ make(dirname(path));
65
+ create(path);
66
+ }
67
+ };
68
+ make(directory);
27
69
  }
28
70
  /** File helpers own the file, never the parent's mode: an absent parent is
29
71
  * created private, an existing one — private or user-visible — keeps its
@@ -33,9 +75,21 @@ function ensureParentDir(file) {
33
75
  if (!existsSync(parent))
34
76
  ensurePrivateDir(parent);
35
77
  }
78
+ /** A private name beside `file` for bytes renamed onto it. Its length is
79
+ * fixed, never derived from `file`'s own name, so every name a directory
80
+ * can hold, up to the filesystem's longest, can be written through it; Git's
81
+ * fixed `tmp_obj_*` names follow the same rule. */
82
+ function temporaryBeside(file, kind = "tmp") {
83
+ return join(dirname(file), `.amalgm-${randomUUID()}.${kind}`);
84
+ }
36
85
  export function atomicWrite(file, bytes, mode = 0o600) {
37
86
  ensureParentDir(file);
38
- const temporary = `${file}.${randomUUID()}.tmp`;
87
+ atomicWriteIn(file, bytes, mode);
88
+ }
89
+ /** atomicWrite into a directory that already stands: a vanished parent
90
+ * fails with ENOENT and is never re-created. */
91
+ export function atomicWriteIn(file, bytes, mode = 0o600) {
92
+ const temporary = temporaryBeside(file);
39
93
  try {
40
94
  writeFileSync(temporary, bytes, { mode, flag: "wx" });
41
95
  // The mode is set before publication: a published inode never changes.
@@ -46,51 +100,36 @@ export function atomicWrite(file, bytes, mode = 0o600) {
46
100
  rmSync(temporary, { force: true });
47
101
  }
48
102
  }
49
- export function atomicCopy(source, destination, mode = 0o600) {
50
- ensureParentDir(destination);
51
- const temporary = `${destination}.${randomUUID()}.tmp`;
103
+ /** Copy into a directory that already stands, published whole by rename: a
104
+ * vanished parent fails with ENOENT and is never re-created. Every step is
105
+ * libuv's, never the event loop's, so a copy of any size leaves the program
106
+ * answering. One call on every OS: the kernel clones the immutable cache
107
+ * bytes where the filesystem can (APFS, Btrfs, XFS, ReFS) and copies them
108
+ * where it cannot (ext4, ordinary NTFS). */
109
+ export async function atomicCopyIn(source, destination, mode = 0o600) {
110
+ const temporary = temporaryBeside(destination);
52
111
  try {
53
- // APFS, Btrfs, and other clone-capable filesystems materialize immutable
54
- // cache bytes as metadata work. Node falls back to a normal copy where a
55
- // clone is unavailable, including ordinary Windows filesystems.
56
- copyFileSync(source, temporary, constants.COPYFILE_FICLONE);
57
- chmodSync(temporary, mode);
58
- renameSync(temporary, destination);
112
+ await copyFile(source, temporary, constants.COPYFILE_FICLONE);
113
+ await chmod(temporary, mode);
114
+ await rename(temporary, destination);
59
115
  }
60
116
  finally {
61
- rmSync(temporary, { force: true });
117
+ await rm(temporary, { force: true });
62
118
  }
63
119
  }
64
- /** Assemble verified chunk files without holding the complete artifact in RAM. */
65
- export async function atomicAssemble(destination, sources) {
66
- ensureParentDir(destination);
67
- const temporary = `${destination}.${randomUUID()}.tmp`;
68
- const output = createWriteStream(temporary, { flags: "wx", mode: 0o600 });
69
- const hash = createHash("sha256");
70
- let bytes = 0;
71
- try {
72
- for (const source of sources) {
73
- for await (const chunk of createReadStream(source)) {
74
- const value = chunk;
75
- hash.update(value);
76
- bytes += value.byteLength;
77
- if (!output.write(value))
78
- await once(output, "drain");
79
- }
120
+ /** Copy `source` to a new private file at `destination`, piece by piece;
121
+ * `onBytes` hears each piece written. Anything already standing at
122
+ * `destination` is left alone and fails the copy (`EEXIST`); any other
123
+ * failure leaves whatever it wrote for its caller to remove. */
124
+ export async function copyToNewFile(source, destination, onBytes) {
125
+ // The pipeline hears both streams' errors, so each rejects this copy and
126
+ // none is left without a listener.
127
+ await pipeline(createReadStream(source), async function* (pieces) {
128
+ for await (const piece of pieces) {
129
+ yield piece;
130
+ onBytes?.(piece.byteLength);
80
131
  }
81
- output.end();
82
- await once(output, "close");
83
- chmodSync(temporary, 0o600);
84
- renameSync(temporary, destination);
85
- return { bytes, sha256: hash.digest("hex") };
86
- }
87
- catch (error) {
88
- output.destroy();
89
- throw error;
90
- }
91
- finally {
92
- rmSync(temporary, { force: true });
93
- }
132
+ }, createWriteStream(destination, { flags: "wx", mode: 0o600 }));
94
133
  }
95
134
  export function readJson(file) {
96
135
  try {
@@ -106,20 +145,19 @@ export function atomicJson(file, value) {
106
145
  /** Commit related JSON documents without ever leaving a split public/secret
107
146
  * pair. Existing files are restored if any rename fails. */
108
147
  export function atomicJsonSet(documents) {
109
- const transaction = randomUUID();
110
148
  const temporary = [];
111
149
  const backups = [];
112
150
  const written = [];
113
151
  try {
114
152
  for (const [file, value] of documents) {
115
- const temp = `${file}.${transaction}.tmp`;
153
+ const temp = temporaryBeside(file);
116
154
  ensurePrivateDir(dirname(file));
117
155
  writeFileSync(temp, `${JSON.stringify(value, null, 2)}\n`, { mode: 0o600, flag: "wx" });
118
156
  temporary.push(temp);
119
157
  }
120
158
  for (let index = 0; index < documents.length; index += 1) {
121
159
  const [file] = documents[index];
122
- const backup = `${file}.${transaction}.bak`;
160
+ const backup = temporaryBeside(file, "bak");
123
161
  if (existsSync(file)) {
124
162
  renameSync(file, backup);
125
163
  backups.push([file, backup]);
@@ -1 +1 @@
1
- {"version":3,"file":"filesystem.js","sourceRoot":"","sources":["../src/filesystem.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EACL,SAAS,EACT,SAAS,EACT,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,UAAU,EACV,SAAS,EACT,YAAY,EACZ,UAAU,EACV,MAAM,EACN,aAAa,GACd,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAEnC,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,MAAM,UAAU,gBAAgB,CAAC,SAAiB;IAChD,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACvD,SAAS,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;AAC9B,CAAC;AAED;;4DAE4D;AAC5D,MAAM,UAAU,aAAa,CAAC,SAAiB;IAC7C,IAAI,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,KAAK,SAAS,EAAE,CAAC;QACzE,SAAS,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IAC9B,CAAC;AACH,CAAC;AAED;+EAC+E;AAC/E,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,WAA8B,EAC9B,WAAmB;IAEnB,MAAM,cAAc,CAAC,WAAW,EAAE,WAAW,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE;QACjE,IAAI,MAAM,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,KAAK,SAAS,EAAE,CAAC;YAC3E,MAAM,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QAChC,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;WAEW;AACX,SAAS,eAAe,CAAC,IAAY;IACnC,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;QAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,KAA0B,EAAE,IAAI,GAAG,KAAK;IAChF,eAAe,CAAC,IAAI,CAAC,CAAC;IACtB,MAAM,SAAS,GAAG,GAAG,IAAI,IAAI,UAAU,EAAE,MAAM,CAAC;IAChD,IAAI,CAAC;QACH,aAAa,CAAC,SAAS,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACtD,uEAAuE;QACvE,SAAS,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAC3B,UAAU,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAC9B,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACrC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAAc,EAAE,WAAmB,EAAE,IAAI,GAAG,KAAK;IAC1E,eAAe,CAAC,WAAW,CAAC,CAAC;IAC7B,MAAM,SAAS,GAAG,GAAG,WAAW,IAAI,UAAU,EAAE,MAAM,CAAC;IACvD,IAAI,CAAC;QACH,yEAAyE;QACzE,yEAAyE;QACzE,gEAAgE;QAChE,YAAY,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,CAAC,gBAAgB,CAAC,CAAC;QAC5D,SAAS,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAC3B,UAAU,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IACrC,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACrC,CAAC;AACH,CAAC;AAED,kFAAkF;AAClF,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,WAAmB,EACnB,OAA0B;IAE1B,eAAe,CAAC,WAAW,CAAC,CAAC;IAC7B,MAAM,SAAS,GAAG,GAAG,WAAW,IAAI,UAAU,EAAE,MAAM,CAAC;IACvD,MAAM,MAAM,GAAG,iBAAiB,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC1E,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IAClC,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,CAAC;QACH,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAC;gBACnD,MAAM,KAAK,GAAG,KAAe,CAAC;gBAC9B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACnB,KAAK,IAAI,KAAK,CAAC,UAAU,CAAC;gBAC1B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC;oBAAE,MAAM,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YACxD,CAAC;QACH,CAAC;QACD,MAAM,CAAC,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC5B,SAAS,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QAC5B,UAAU,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;QACnC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;IAC/C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,OAAO,EAAE,CAAC;QACjB,MAAM,KAAK,CAAC;IACd,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACrC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,QAAQ,CAAI,IAAY;IACtC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAM,CAAC;IACrD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,KAAc;IACrD,WAAW,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;AAC3D,CAAC;AAED;4DAC4D;AAC5D,MAAM,UAAU,aAAa,CAAC,SAAkD;IAC9E,MAAM,WAAW,GAAG,UAAU,EAAE,CAAC;IACjC,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,MAAM,OAAO,GAAqC,EAAE,CAAC;IACrD,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,CAAC;QACH,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,SAAS,EAAE,CAAC;YACtC,MAAM,IAAI,GAAG,GAAG,IAAI,IAAI,WAAW,MAAM,CAAC;YAC1C,gBAAgB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;YAChC,aAAa,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YACxF,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvB,CAAC;QACD,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,SAAS,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;YACzD,MAAM,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,KAAK,CAA+B,CAAC;YAC9D,MAAM,MAAM,GAAG,GAAG,IAAI,IAAI,WAAW,MAAM,CAAC;YAC5C,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;gBACrB,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;gBACzB,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;YAC/B,CAAC;YACD,UAAU,CAAC,SAAS,CAAC,KAAK,CAAW,EAAE,IAAI,CAAC,CAAC;YAC7C,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YACvB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrB,CAAC;QACD,KAAK,MAAM,CAAC,EAAE,MAAM,CAAC,IAAI,OAAO;YAAE,MAAM,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACpE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,KAAK,MAAM,IAAI,IAAI,OAAO;YAAE,MAAM,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1D,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;YACpD,IAAI,UAAU,CAAC,MAAM,CAAC;gBAAE,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QACnD,CAAC;QACD,KAAK,MAAM,IAAI,IAAI,SAAS;YAAE,MAAM,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5D,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}
1
+ {"version":3,"file":"filesystem.js","sourceRoot":"","sources":["../src/filesystem.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,19 @@
1
+ import type { FileHandle } from "node:fs/promises";
2
+ /** Flushes an open handle in one of the process's flush slots. */
3
+ export declare function flushHandle(handle: FileHandle): Promise<void>;
4
+ /** A directory flush makes its entries' renames and removals durable.
5
+ * Windows carries directory entries through its file flush contract and
6
+ * opens no directory handles. A flush writes nothing, so this one opens the
7
+ * path as named: a link at its final name costs at most a flush elsewhere. */
8
+ export declare function flushDirectory(path: string): void;
9
+ /** Flushes every named file's bytes and directory's entries, many at once.
10
+ * A set names what a writer left: an object no longer there, or another
11
+ * kind of object standing in its place, owes nothing, since whatever
12
+ * removed or replaced it is a later write. Nothing is followed
13
+ * (openStanding): a link persists through the directory holding it. */
14
+ export declare function flushEach(files: Iterable<string>, directories: Iterable<string>): Promise<void>;
15
+ /** Flushes the file or directory standing at `path`, never what a link
16
+ * there names (openStanding). FlushFileBuffers needs a write handle, so a
17
+ * Windows file opens for writing; the open never blocks, so a FIFO standing
18
+ * there is refused rather than waited on. */
19
+ export declare function flushStanding(path: string, directory: boolean): Promise<void>;
package/dist/flush.js ADDED
@@ -0,0 +1,84 @@
1
+ /** The one flush: the operating system's own file flush, through Node. It
2
+ * returns once a file's written bytes, or a directory's entries, persist:
3
+ * fsync on Linux, FlushFileBuffers on Windows, and on macOS F_FULLFSYNC
4
+ * (libuv's fsync), which also empties the drive's cache, as SQLite's
5
+ * fullfsync does (src/sqlite-durability.ts).
6
+ *
7
+ * A write that must persist before another is flushed before the other is
8
+ * issued: write a temporary, flush it, rename it, flush its directory. There
9
+ * is no weaker flush and so no rule that picks one. A flush covers only what
10
+ * it names, so every file and directory whose writes must persist takes its
11
+ * own, and nothing waits for writes it never named.
12
+ *
13
+ * A flush blocks its thread until the drive answers; `FileHandle.sync` runs
14
+ * one off the event loop, in Node's thread pool. Behind a burst of unrelated
15
+ * writeback the drive can take seconds to answer, and the same pool serves
16
+ * every asynchronous open, stat and read, a placed file's included. So every
17
+ * flush through a handle takes one of this process's flush slots, half the
18
+ * pool: however long flushes wait, the other half stays free for reads. */
19
+ import { closeSync, constants, fsyncSync, openSync } from "node:fs";
20
+ import { createParallelGate, parallelForEach } from "@amalgm/live";
21
+ import { openStanding } from "./open-standing.js";
22
+ /** Node's thread pool: libuv's default four threads, or what the process
23
+ * was started with. */
24
+ const POOL = Number(process.env.UV_THREADPOOL_SIZE) || 4;
25
+ const slots = createParallelGate(Math.max(1, Math.floor(POOL / 2)));
26
+ /** Flushes an open handle in one of the process's flush slots. */
27
+ export function flushHandle(handle) {
28
+ return slots.run(() => handle.sync());
29
+ }
30
+ /** A directory flush makes its entries' renames and removals durable.
31
+ * Windows carries directory entries through its file flush contract and
32
+ * opens no directory handles. A flush writes nothing, so this one opens the
33
+ * path as named: a link at its final name costs at most a flush elsewhere. */
34
+ export function flushDirectory(path) {
35
+ if (process.platform === "win32")
36
+ return;
37
+ const fd = openSync(path, "r");
38
+ try {
39
+ fsyncSync(fd);
40
+ }
41
+ finally {
42
+ closeSync(fd);
43
+ }
44
+ }
45
+ /** Objects one set flush holds open at once. */
46
+ const SET_WIDTH = 16;
47
+ /** Flushes every named file's bytes and directory's entries, many at once.
48
+ * A set names what a writer left: an object no longer there, or another
49
+ * kind of object standing in its place, owes nothing, since whatever
50
+ * removed or replaced it is a later write. Nothing is followed
51
+ * (openStanding): a link persists through the directory holding it. */
52
+ export async function flushEach(files, directories) {
53
+ const owed = [...new Set(files)].map(path => ({ path, directory: false }));
54
+ if (process.platform !== "win32")
55
+ owed.push(...[...new Set(directories)].map(path => ({ path, directory: true })));
56
+ await parallelForEach(owed, SET_WIDTH, flushOwed);
57
+ }
58
+ /** Gone, or replaced by a link or by another kind of object. */
59
+ const GONE = new Set(["ENOENT", "ENOTDIR", "ELOOP", "EFTYPE"]);
60
+ async function flushOwed({ path, directory }) {
61
+ try {
62
+ await flushStanding(path, directory);
63
+ }
64
+ catch (error) {
65
+ if (GONE.has(error.code ?? ""))
66
+ return;
67
+ throw error;
68
+ }
69
+ }
70
+ /** Flushes the file or directory standing at `path`, never what a link
71
+ * there names (openStanding). FlushFileBuffers needs a write handle, so a
72
+ * Windows file opens for writing; the open never blocks, so a FIFO standing
73
+ * there is refused rather than waited on. */
74
+ export async function flushStanding(path, directory) {
75
+ const access = !directory && process.platform === "win32" ? constants.O_RDWR : constants.O_RDONLY;
76
+ const handle = await openStanding(path, access | (constants.O_NONBLOCK ?? 0), directory ? "directory" : "file");
77
+ try {
78
+ await flushHandle(handle);
79
+ }
80
+ finally {
81
+ await handle.close();
82
+ }
83
+ }
84
+ //# sourceMappingURL=flush.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"flush.js","sourceRoot":"","sources":["../src/flush.ts"],"names":[],"mappings":"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"}
package/dist/gateway.js CHANGED
@@ -107,11 +107,14 @@ export function createGateway(config = {}) {
107
107
  return;
108
108
  }
109
109
  res.writeHead(500, { ...cors, "Content-Type": "application/json" });
110
- // A traced journey that failed still owes the caller the ledger of
111
- // what it spent before failing; the stage evidence rides the error.
110
+ // A failed journey names the stage it was in, and a traced one
111
+ // still owes the caller the ledger of what it spent before
112
+ // failing; both ride the error.
113
+ const stage = error?.stage;
112
114
  const stages = error?.stages;
113
115
  res.end(JSON.stringify({
114
116
  error: error instanceof Error ? error.message : "internal error",
117
+ ...(typeof stage === "string" ? { stage } : {}),
115
118
  ...(Array.isArray(stages) ? { stages } : {}),
116
119
  }));
117
120
  }
@@ -1 +1 @@
1
- {"version":3,"file":"gateway.js","sourceRoot":"","sources":["../src/gateway.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"gateway.js","sourceRoot":"","sources":["../src/gateway.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,15 @@
1
+ import type Database from "better-sqlite3";
2
+ import type { GitOwners } from "./home.js";
3
+ export interface HeldRepository {
4
+ readonly uuid: string;
5
+ readonly absolutePath: string;
6
+ readonly transportVersion: string | null;
7
+ }
8
+ export interface WalkedRoot {
9
+ readonly root: string;
10
+ readonly repositories: () => readonly HeldRepository[];
11
+ }
12
+ /** The real path of where `path` stands or will stand: its nearest existing
13
+ * ancestor's real path, with the rest of its names; null when none stands. */
14
+ export declare function realPlace(path: string): Promise<string | null>;
15
+ export declare function groundGitOwners(database: Database.Database | null, walked?: WalkedRoot | null, storage?: string | null): GitOwners;
@@ -0,0 +1,67 @@
1
+ /** The repositories this machine's ground holds (home.ts), from its observed
2
+ * rows: each one's checkout and the transport version of its last state, and
3
+ * the roots of the ground they stand in. A Detect pass walking a root names
4
+ * it and the repositories it has observed but not yet stored, which come
5
+ * first; a cold one has no database yet. Apply names where this machine
6
+ * keeps self-held worktrees' storage (`storage`); Detect builds none. */
7
+ import { realpath } from "node:fs/promises";
8
+ import { basename, dirname, join, resolve, sep } from "node:path";
9
+ /** The real path of where `path` stands or will stand: its nearest existing
10
+ * ancestor's real path, with the rest of its names; null when none stands. */
11
+ export async function realPlace(path) {
12
+ for (let at = resolve(path), rest = [];;) {
13
+ const real = await realpath(at).catch(() => null);
14
+ if (real !== null)
15
+ return join(real, ...rest);
16
+ if (dirname(at) === at)
17
+ return null;
18
+ rest = [basename(at), ...rest];
19
+ at = dirname(at);
20
+ }
21
+ }
22
+ export function groundGitOwners(database, walked = null, storage = null) {
23
+ const all = database?.prepare(`SELECT uuid, absolute_path AS absolutePath, transport_version AS transportVersion
24
+ FROM entities WHERE type = 'repo.git' AND status = 'active'`);
25
+ const byUuid = database?.prepare(`SELECT uuid, absolute_path AS absolutePath, transport_version AS transportVersion
26
+ FROM entities WHERE uuid = ? AND type = 'repo.git' AND status = 'active' LIMIT 1`);
27
+ // Each root's own row is its binding.
28
+ const roots = database?.prepare(`SELECT e.absolute_path AS absolutePath FROM ground_roots g
29
+ CROSS JOIN entities e ON e.uuid = g.root_uuid AND e.root_uuid = g.root_uuid WHERE e.status = 'active'`);
30
+ const observed = () => walked?.repositories() ?? [];
31
+ const checkouts = async () => {
32
+ const found = new Map();
33
+ for (const held of [...observed(), ...all?.all() ?? []]) {
34
+ const real = await realpath(held.absolutePath).catch(() => null);
35
+ if (real !== null && !found.has(real))
36
+ found.set(real, held.uuid);
37
+ }
38
+ return found;
39
+ };
40
+ // A pass names its repositories once, however many of them ask.
41
+ let walkedCheckouts = null;
42
+ return {
43
+ storage,
44
+ async uuidAt(checkout) {
45
+ const held = walked ? await (walkedCheckouts ??= checkouts()) : await checkouts();
46
+ return held.get(checkout) ?? null;
47
+ },
48
+ async holding(uuid) {
49
+ const held = observed().find(repository => repository.uuid === uuid) ?? byUuid?.get(uuid);
50
+ return held ? { checkout: held.absolutePath, transportVersion: held.transportVersion } : null;
51
+ },
52
+ async ground(path) {
53
+ const real = await realPlace(path);
54
+ if (real === null)
55
+ return null;
56
+ let found = null;
57
+ for (const root of [...walked ? [walked.root] : [], ...(roots?.all() ?? [])
58
+ .map(row => row.absolutePath)]) {
59
+ const at = await realpath(root).catch(() => null);
60
+ if (at !== null && (real === at || real.startsWith(`${at}${sep}`)) && at.length > (found?.length ?? -1))
61
+ found = at;
62
+ }
63
+ return found && found.split(sep).join("/");
64
+ },
65
+ };
66
+ }
67
+ //# sourceMappingURL=ground-owners.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ground-owners.js","sourceRoot":"","sources":["../../src/git/ground-owners.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,67 @@
1
+ import { type CloudEntityRecord } from "@amalgm/live";
2
+ import { type GitNotebook } from "./rail.js";
3
+ /** A repository row's base: `none` when the row names no package, as a
4
+ * repository never shared has none; `lost` when the cache no longer holds the
5
+ * package it names, which is fetched back or else recovered, never read as
6
+ * `none`. */
7
+ export type RepositoryBase = {
8
+ readonly kind: "none";
9
+ } | {
10
+ readonly kind: "held";
11
+ readonly notebook: GitNotebook;
12
+ } | {
13
+ readonly kind: "lost";
14
+ readonly transportVersion: string;
15
+ };
16
+ export declare function repositoryBase(cacheDir: string, transportVersion: string | null): Promise<RepositoryBase>;
17
+ /** The notebook a row's base holds; null when it holds none. */
18
+ export declare const heldNotebook: (cacheDir: string, transportVersion: string | null) => Promise<GitNotebook | null>;
19
+ /** Whether this cache holds package `transportVersion`. One stat, no read.
20
+ * A record completes here only through its own package: an update is an
21
+ * event, so equal content may spare a rewrite, never the package the row
22
+ * names (docs/entity-apply.md in Live, "A row names only what it holds"). */
23
+ export declare const holdsPackage: (cacheDir: string, transportVersion: string | null | undefined) => transportVersion is string;
24
+ /** The package `shared`, the row sharing last stated, names when it states
25
+ * `stateId` and this cache holds it; else null. One stat, no read.
26
+ *
27
+ * An optimization, never a law, and only the sender's: a new reading of a
28
+ * state sharing already stated names that package, since a state ID covers
29
+ * every Git-directory file and so every object it names. The new record then
30
+ * names it as its own cargo. Without it the reading is packed again. */
31
+ export declare const carrierOf: (cacheDir: string, stateId: string, shared: Pick<CloudEntityRecord, "payloadVersion" | "transportVersion"> | null) => string | null;
32
+ /** The parent package `transportVersion` names when this cache holds it,
33
+ * else null. A package is thin against its parent, and a reader rebuilds
34
+ * what it leaves out by walking that chain, so a package travels with every
35
+ * ancestor the authority lacks, as `git push` sends every commit the remote
36
+ * lacks. An ancestor this cache does not hold is the authority's: the cache
37
+ * keeps every held ancestor of a package a row names
38
+ * (content-cache-retention.ts). */
39
+ export declare function cachedParent(cacheDir: string, transportVersion: string): Promise<string | null>;
40
+ /** The same, read from a package's bytes in hand, as Send's inline path
41
+ * holds a package the cache does not name yet (cargo-journal.ts). */
42
+ export declare function cachedParentOf(cacheDir: string, bytes: Uint8Array): string | null;
43
+ /** Brings package `transportVersion` of repository `entityId` back into the
44
+ * cache through the ordinary verified download. Only that package: a row
45
+ * names one event's package, and another package of equal content is not
46
+ * that event's. There is no answer "none": when the cloud holds it no more,
47
+ * the restore throws recover()'s `Recovering` (Live recover.ts), counted, and
48
+ * the repository is not done. An ongoing lane's restore never waits for the
49
+ * cloud: it throws `BaseFetching`, and the fetch rings `directory` when it
50
+ * lands. */
51
+ export type RestorePackage = (entityId: string, transportVersion: string, directory: string) => Promise<void>;
52
+ /** A repository whose lost base is still coming back from the cloud. It is
53
+ * left as it was, and only it: nothing of it is read, and its fetch, never a
54
+ * timer, rings it when it lands. */
55
+ export declare class BaseFetching extends Error {
56
+ constructor();
57
+ }
58
+ /** The base a repository's next change is read against, and the state its
59
+ * Apply joins: the notebook of the package its row names. A base the cache
60
+ * lost is not a base that never was: the row's own package is fetched back
61
+ * from the cloud before anything is compared, so a computer
62
+ * never states a difference from defaults it guessed. Null only when the row
63
+ * names no package; a package no one holds throws from `restore`. */
64
+ export declare function baseNotebook(cacheDir: string, directory: string, head: {
65
+ readonly uuid: string;
66
+ readonly transportVersion: string | null;
67
+ }, restore: RestorePackage): Promise<GitNotebook | null>;