@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
@@ -0,0 +1,110 @@
1
+ /** The Git storage a received folder result displaces. A repository that
2
+ * becomes a folder loses only its Git storage; its worktree members stay where
3
+ * they stand, each on its own channel. Apply never deletes a person's Git
4
+ * write.
5
+ *
6
+ * - The final guard stamps its root's content clock, then takes the
7
+ * storage's fingerprint (apply-fingerprint.ts) before its fresh repository
8
+ * observation proves the storage is O, so any Git write after that
9
+ * observation differs from the fingerprint.
10
+ * - The receipt binds that manifest before any effect. It is the only
11
+ * evidence of which storage is O.
12
+ * - The reveal moves the marker into control only while it is the manifest's
13
+ * own object.
14
+ * - Verify takes the displaced storage's fingerprint again before it judges
15
+ * anything else (keptStorageIsO). Unchanged storage is the O the cloud
16
+ * already holds and goes with the window's control tree at the durability
17
+ * point, once its member matches. Changed storage, and storage whose member
18
+ * answers anything else, is brought home (returnGitStorage): a person's
19
+ * Git write the durability point would otherwise destroy returns to its
20
+ * folder, the member stays owed, and Detect records it as the repository's
21
+ * newest result.
22
+ *
23
+ * A gitfile marker names storage outside the worktree. The rename moves only
24
+ * the marker, so the manifest also holds that storage's absolute address. */
25
+ import { readFileSync, renameSync } from "node:fs";
26
+ import { join } from "node:path";
27
+ import { clockBoundary, fingerprintClock, fingerprintTree } from "./apply-fingerprint.js";
28
+ import { moveWithoutReplacing } from "./apply-spelling.js";
29
+ import { flushDirectory } from "./flush.js";
30
+ import { gitStorageDirectory } from "./git-binding.js";
31
+ import { optionalLstat } from "./physical-path-witness.js";
32
+ import { physicalKey } from "./source-signature.js";
33
+ /** The displaced marker's name in its intent's control tree. */
34
+ export const DISPLACED_GIT = "displaced-git";
35
+ /** The manifest of `worktree`'s Git storage as it stands now, under `stamp`. */
36
+ export async function captureGitStorage(worktree, stamp, reads = {}) {
37
+ const markerPath = join(worktree, ".git");
38
+ const marker = optionalLstat(markerPath);
39
+ if (!marker)
40
+ throw new Error("Apply found no Git storage to displace");
41
+ const { directory } = gitStorageDirectory(worktree);
42
+ const storage = optionalLstat(directory);
43
+ if (!storage?.isDirectory())
44
+ throw new Error("Apply found no Git storage directory to displace");
45
+ const clock = fingerprintClock(stamp);
46
+ const taken = await fingerprintTree(directory, { clock: clockBoundary(clock), ...reads });
47
+ if ("differs" in taken)
48
+ return null;
49
+ return {
50
+ contract: "amalgm.apply-git-storage@2",
51
+ marker: { object: physicalKey(marker), gitfile: marker.isFile() ? readFileSync(markerPath, "utf8") : null },
52
+ storage: { path: directory, object: physicalKey(storage) },
53
+ clock, digest: taken.digest,
54
+ };
55
+ }
56
+ /** Whether `marker` is the manifest's own marker over exactly its storage. */
57
+ async function gitStorageUnchanged(marker, manifest, reads) {
58
+ // A manifest of another contract proves nothing.
59
+ if (manifest.contract !== "amalgm.apply-git-storage@2")
60
+ return false;
61
+ const stats = optionalLstat(marker);
62
+ if (!stats || physicalKey(stats) !== manifest.marker.object)
63
+ return false;
64
+ if (manifest.marker.gitfile !== null
65
+ && (!stats.isFile() || readFileSync(marker, "utf8") !== manifest.marker.gitfile))
66
+ return false;
67
+ const directory = manifest.marker.gitfile === null ? marker : manifest.storage.path;
68
+ const storage = optionalLstat(directory);
69
+ if (!storage?.isDirectory() || physicalKey(storage) !== manifest.storage.object)
70
+ return false;
71
+ const taken = await fingerprintTree(directory, { clock: clockBoundary(manifest.clock), ...reads });
72
+ return "digest" in taken && taken.digest === manifest.digest;
73
+ }
74
+ /** Moves the worktree's marker into control while it is the manifest's own
75
+ * object. Storage already displaced, or removed by a person, leaves nothing
76
+ * to move; any other marker is ground the bound read must judge first. */
77
+ export function displaceGitStorage(control, worktree, manifest) {
78
+ const marker = join(worktree, ".git");
79
+ if (optionalLstat(join(control, DISPLACED_GIT)))
80
+ return;
81
+ const stats = optionalLstat(marker);
82
+ if (!stats)
83
+ return;
84
+ if (physicalKey(stats) !== manifest.marker.object)
85
+ throw new Error("Git storage changed before Apply displaced it");
86
+ renameSync(marker, join(control, DISPLACED_GIT));
87
+ flushDirectory(control);
88
+ flushDirectory(worktree);
89
+ }
90
+ /** Whether the storage displaced into `control` is still the manifest's O.
91
+ * Storage that never left, because a person removed it first, has nothing to
92
+ * lose. */
93
+ export async function keptStorageIsO(control, manifest, reads = {}) {
94
+ const displaced = join(control, DISPLACED_GIT);
95
+ return !optionalLstat(displaced) || await gitStorageUnchanged(displaced, manifest, reads);
96
+ }
97
+ /** Returns storage displaced into `control` to `worktree`, durably. False
98
+ * when another `.git` stands there, so the caller keeps it rather than lets
99
+ * the durability point take it. */
100
+ export function returnGitStorage(control, worktree) {
101
+ const displaced = join(control, DISPLACED_GIT);
102
+ if (!optionalLstat(displaced))
103
+ return true;
104
+ if (!moveWithoutReplacing(displaced, join(worktree, ".git")))
105
+ return false;
106
+ flushDirectory(control);
107
+ flushDirectory(worktree);
108
+ return true;
109
+ }
110
+ //# sourceMappingURL=apply-git-storage.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"apply-git-storage.js","sourceRoot":"","sources":["../src/apply-git-storage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;6EAuB6E;AAC7E,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,eAAe,EAC9B,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAE3D,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD,gEAAgE;AAChE,MAAM,CAAC,MAAM,aAAa,GAAG,eAAe,CAAC;AAiB7C,gFAAgF;AAChF,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,QAAgB,EAAE,KAAmB,EAAE,QAAe,EAAE;IAE9F,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC;IACzC,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IACvE,MAAM,EAAE,SAAS,EAAE,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IACpD,MAAM,OAAO,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;IACzC,IAAI,CAAC,OAAO,EAAE,WAAW,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACjG,MAAM,KAAK,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;IACtC,MAAM,KAAK,GAAG,MAAM,eAAe,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,aAAa,CAAC,KAAK,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;IAC1F,IAAI,SAAS,IAAI,KAAK;QAAE,OAAO,IAAI,CAAC;IACpC,OAAO;QACL,QAAQ,EAAE,4BAA4B;QACtC,MAAM,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE;QAC3G,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,EAAE;QAC1D,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM;KAC5B,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,KAAK,UAAU,mBAAmB,CAAC,MAAc,EAAE,QAA4B,EAAE,KAAY;IAC3F,iDAAiD;IACjD,IAAI,QAAQ,CAAC,QAAQ,KAAK,4BAA4B;QAAE,OAAO,KAAK,CAAC;IACrE,MAAM,KAAK,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IACpC,IAAI,CAAC,KAAK,IAAI,WAAW,CAAC,KAAK,CAAC,KAAK,QAAQ,CAAC,MAAM,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAC1E,IAAI,QAAQ,CAAC,MAAM,CAAC,OAAO,KAAK,IAAI;WAC/B,CAAC,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IACjG,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC;IACpF,MAAM,OAAO,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;IACzC,IAAI,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,WAAW,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,OAAO,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAC9F,MAAM,KAAK,GAAG,MAAM,eAAe,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,aAAa,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;IACnG,OAAO,QAAQ,IAAI,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM,CAAC;AAC/D,CAAC;AAED;;0EAE0E;AAC1E,MAAM,UAAU,kBAAkB,CAAC,OAAe,EAAE,QAAgB,EAAE,QAA4B;IAChG,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACtC,IAAI,aAAa,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;QAAE,OAAO;IACxD,MAAM,KAAK,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IACpC,IAAI,CAAC,KAAK;QAAE,OAAO;IACnB,IAAI,WAAW,CAAC,KAAK,CAAC,KAAK,QAAQ,CAAC,MAAM,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IACpH,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC;IACjD,cAAc,CAAC,OAAO,CAAC,CAAC;IACxB,cAAc,CAAC,QAAQ,CAAC,CAAC;AAC3B,CAAC;AAED;;WAEW;AACX,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAAe,EAAE,QAA4B,EAAE,QAAe,EAAE;IACnG,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;IAC/C,OAAO,CAAC,aAAa,CAAC,SAAS,CAAC,IAAI,MAAM,mBAAmB,CAAC,SAAS,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;AAC5F,CAAC;AAED;;mCAEmC;AACnC,MAAM,UAAU,gBAAgB,CAAC,OAAe,EAAE,QAAgB;IAChE,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;IAC/C,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3C,IAAI,CAAC,oBAAoB,CAAC,SAAS,EAAE,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IAC3E,cAAc,CAAC,OAAO,CAAC,CAAC;IACxB,cAAc,CAAC,QAAQ,CAAC,CAAC;IACzB,OAAO,IAAI,CAAC;AACd,CAAC"}
@@ -0,0 +1,42 @@
1
+ import type { GroundRow } from "./ground-row.js";
2
+ /** One topmost remainder: where it stood, and its nearest shared container. */
3
+ export interface Remainder {
4
+ readonly owner: string;
5
+ readonly path: string;
6
+ }
7
+ /** The remainder rows whose parent is shared: each carries what lies beneath it. */
8
+ export declare function topmostRemainder(rows: readonly GroundRow[]): Remainder[];
9
+ /** Moves each remainder from the displaced container into its owner's keep,
10
+ * under this attempt, or a fresh sibling of it where a name is taken. A
11
+ * remainder no longer displaced was kept by an earlier run: its owner's keep
12
+ * is flushed again, once. */
13
+ export declare function keepRemainder(input: {
14
+ readonly root: string;
15
+ readonly attemptId: string;
16
+ readonly source: string;
17
+ readonly displaced: string;
18
+ readonly remainder: readonly Remainder[];
19
+ }): string[];
20
+ /** Moves `from` into its owner's keep as `name`, under this attempt or a
21
+ * fresh sibling of it where the name is taken, and names the directories
22
+ * owed a flush; none when nothing stands at `from`. */
23
+ export declare function keepAside(input: {
24
+ readonly root: string;
25
+ readonly attemptId: string;
26
+ readonly owner: string;
27
+ readonly from: string;
28
+ readonly name: string;
29
+ }): string[];
30
+ /** Returns each name kept for `owner` into `container`, its address in this
31
+ * root, wherever `free` holds, and names the directories owed a flush: every
32
+ * keep still standing with the container, so a return repeated after a crash
33
+ * flushes the moves an earlier run made. */
34
+ export declare function returnKept(input: {
35
+ readonly root: string;
36
+ readonly owner: string;
37
+ readonly container: string;
38
+ readonly free: (path: string) => boolean;
39
+ }): string[];
40
+ /** Takes each emptied keep of `owner` once its return's flush is done; a
41
+ * removal a crash loses leaves an empty keep the next return flushes again. */
42
+ export declare function vacateKept(root: string, owner: string): void;
@@ -0,0 +1,135 @@
1
+ /** Unshared ground belongs to its nearest shared container UUID.
2
+ *
3
+ * When that identity ceases to be materialized as a container (a Leave, or a
4
+ * leaf replacing it), its remainder is kept outside Detect's namespace,
5
+ * beneath the binding root's reserved local directory:
6
+ *
7
+ * <root>/.amalgm/kept/<owner UUID>/<attempt>/<name>
8
+ *
9
+ * Its member's Verify keeps it, and the member completes only once the keep
10
+ * is durable. Shared ground Apply set aside whose address a person took
11
+ * while the window held it is kept the same way, beneath the container's own
12
+ * UUID (keepAside), since no other home is free. A reveal that materializes
13
+ * the same identity as a container again in that root returns each kept name
14
+ * into its free address, durably and inside the ground its window owns; an
15
+ * occupied address keeps it. The end of that window wakes Detect over the
16
+ * container, which examines its root. Kept
17
+ * ground goes only with its owner's effective permanent deletion
18
+ * (unfinished: no permanent-delete record exists yet).
19
+ *
20
+ * Every move here refuses to replace what stands, so a step repeated after a
21
+ * crash finds its own earlier move done and only flushes it. */
22
+ import { readdirSync, rmdirSync } from "node:fs";
23
+ import { basename, dirname, join, relative } from "node:path";
24
+ import { LOCAL_DIR_NAME } from "@amalgm/core/identity";
25
+ import { moveWithoutReplacing, standing } from "./apply-spelling.js";
26
+ import { ensureDirBeneath } from "./filesystem.js";
27
+ const keptRoot = (root) => join(root, LOCAL_DIR_NAME, "kept");
28
+ const ownerKeep = (root, owner) => join(keptRoot(root), owner);
29
+ /** The remainder rows whose parent is shared: each carries what lies beneath it. */
30
+ export function topmostRemainder(rows) {
31
+ const held = new Set(rows.map(row => row.uuid));
32
+ return rows.flatMap(row => row.parentUUID !== null && !held.has(row.parentUUID)
33
+ ? [{ owner: row.parentUUID, path: row.absolutePath }] : []);
34
+ }
35
+ /** Moves each remainder from the displaced container into its owner's keep,
36
+ * under this attempt, or a fresh sibling of it where a name is taken. A
37
+ * remainder no longer displaced was kept by an earlier run: its owner's keep
38
+ * is flushed again, once. */
39
+ export function keepRemainder(input) {
40
+ const changed = new Set();
41
+ const replayed = new Set();
42
+ for (const { owner, path } of input.remainder) {
43
+ const from = join(input.displaced, relative(input.source, path));
44
+ const keep = ownerKeep(input.root, owner);
45
+ if (!standing(from)) {
46
+ if (!replayed.has(owner)) {
47
+ for (const attempt of attempts(keep, input.attemptId))
48
+ chainOf(input.root, join(keep, attempt), changed);
49
+ }
50
+ replayed.add(owner);
51
+ continue;
52
+ }
53
+ for (const directory of keepAside({ root: input.root, attemptId: input.attemptId, owner, from, name: basename(path) })) {
54
+ changed.add(directory);
55
+ }
56
+ }
57
+ return [...changed];
58
+ }
59
+ /** Moves `from` into its owner's keep as `name`, under this attempt or a
60
+ * fresh sibling of it where the name is taken, and names the directories
61
+ * owed a flush; none when nothing stands at `from`. */
62
+ export function keepAside(input) {
63
+ const keep = ownerKeep(input.root, input.owner);
64
+ for (let k = 0; standing(input.from); k += 1) {
65
+ const into = join(keep, k === 0 ? input.attemptId : `${input.attemptId}-${k}`);
66
+ ensureDirBeneath(input.root, into, 0o700);
67
+ if (!moveWithoutReplacing(input.from, join(into, input.name)))
68
+ continue;
69
+ const changed = new Set([dirname(input.from)]);
70
+ chainOf(input.root, into, changed);
71
+ return [...changed];
72
+ }
73
+ return [];
74
+ }
75
+ /** Adds every directory from `directory` up to, not including, `root`. */
76
+ function chainOf(root, directory, into) {
77
+ for (let at = directory; at !== root; at = dirname(at))
78
+ into.add(at);
79
+ }
80
+ /** Returns each name kept for `owner` into `container`, its address in this
81
+ * root, wherever `free` holds, and names the directories owed a flush: every
82
+ * keep still standing with the container, so a return repeated after a crash
83
+ * flushes the moves an earlier run made. */
84
+ export function returnKept(input) {
85
+ const keep = ownerKeep(input.root, input.owner);
86
+ const changed = [];
87
+ for (const attempt of names(keep)) {
88
+ const at = join(keep, attempt);
89
+ for (const name of names(at)) {
90
+ const to = join(input.container, name);
91
+ if (input.free(to))
92
+ moveWithoutReplacing(join(at, name), to);
93
+ }
94
+ changed.push(at);
95
+ }
96
+ return changed.length > 0 ? [...changed, input.container] : [];
97
+ }
98
+ /** Takes each emptied keep of `owner` once its return's flush is done; a
99
+ * removal a crash loses leaves an empty keep the next return flushes again. */
100
+ export function vacateKept(root, owner) {
101
+ const keep = ownerKeep(root, owner);
102
+ for (const attempt of names(keep))
103
+ vacate(join(keep, attempt));
104
+ vacate(keep);
105
+ }
106
+ /** This attempt's keep directories for one owner: its own, then each fresh
107
+ * sibling, in order, while they stand. */
108
+ function attempts(keep, attemptId) {
109
+ const found = [];
110
+ for (let k = 0; standing(join(keep, k === 0 ? attemptId : `${attemptId}-${k}`)); k += 1) {
111
+ found.push(k === 0 ? attemptId : `${attemptId}-${k}`);
112
+ }
113
+ return found;
114
+ }
115
+ function names(directory) {
116
+ try {
117
+ return readdirSync(directory);
118
+ }
119
+ catch (error) {
120
+ if (error.code === "ENOENT")
121
+ return [];
122
+ throw error;
123
+ }
124
+ }
125
+ /** Removes a keep directory only once nothing is left in it. */
126
+ function vacate(directory) {
127
+ try {
128
+ rmdirSync(directory);
129
+ }
130
+ catch (error) {
131
+ if (!["ENOTEMPTY", "EEXIST", "ENOENT"].includes(error.code ?? ""))
132
+ throw error;
133
+ }
134
+ }
135
+ //# sourceMappingURL=apply-kept.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"apply-kept.js","sourceRoot":"","sources":["../src/apply-kept.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,41 @@
1
+ /** Apply's local-work gate (Live's docs/entity-apply.md, law 3) over this
2
+ * computer's Outbox and Inbox: whether a local record on an entity's own
3
+ * channel is not ordered at or before an accepted target.
4
+ *
5
+ * Order is delivery position. A stamped receipt carries its own; a pending
6
+ * row takes the Inbox position of the same mutation when Receive already
7
+ * holds it, because Send's stamp can land after Receive; otherwise its
8
+ * position is unknown, so it is after every target. On one channel Send's
9
+ * rows are accepted in local order, so stamped positions rise with the
10
+ * channel's sequence: the channel's newest receipt alone says whether any
11
+ * receipt is after the target. Across channels a row that frees storage may
12
+ * be accepted ahead of an earlier one (Live send-freeing.ts), so the
13
+ * authority's highest receipt answers for them all.
14
+ *
15
+ * Most targets meet no local work at all, so one probe of the authority's
16
+ * pending rows and newest receipt answers them before any channel is read.
17
+ *
18
+ * A kept member's target is a result, not a position: the kept head's state
19
+ * or this computer's own newer result (own-results.ts). Local work follows
20
+ * it exactly when this computer's newest own result carries another one.
21
+ *
22
+ * Whether that work wins is the type's (Live's `localWorkWins`): it always
23
+ * does over a replaced type, and over a played one only when it hides the
24
+ * entity or makes it another type, so the gate answers the newest own
25
+ * result's type and status. Local work after a position is exactly an
26
+ * Outbox row `ownResults` reads at that position, so it always has one. */
27
+ import type { CloudEntityRecord, LocalWork } from "@amalgm/live";
28
+ import type Database from "better-sqlite3";
29
+ /** Whether a local record on the entity's channel is after `deliverySequence`. */
30
+ export declare function hasLocalWorkAfter(database: Database.Database, authorityId: string, entityId: string, deliverySequence: number): boolean;
31
+ /** This computer's newest own result when local work on the entity's
32
+ * channel is after `deliverySequence`, else null. */
33
+ export declare function localWorkAfter(database: Database.Database, authorityId: string, entityId: string, deliverySequence: number): LocalWork | null;
34
+ /** `hasLocalWorkAfterTarget` answering the newest own result, or null when
35
+ * no local work follows the target. The Apply store's port form. */
36
+ export declare function localWorkAfterTarget(database: Database.Database, authorityId: string, entityId: string, target: number | CloudEntityRecord): LocalWork | null;
37
+ /** The gate for the retained Inbox row at `globalSequence` on the entity's
38
+ * channel, or for a kept member's result: whether its newest own result not
39
+ * held at the kept head's watermark, the history floor, is another one. The
40
+ * Apply store's port form. */
41
+ export declare function hasLocalWorkAfterTarget(database: Database.Database, authorityId: string, entityId: string, target: number | CloudEntityRecord): boolean;
@@ -0,0 +1,72 @@
1
+ import { readDeliveryReceipt } from "./graph-heads.js";
2
+ import { ownResults } from "./own-results.js";
3
+ import { cachedStatement } from "./sqlite.js";
4
+ /** Whether a local record on the entity's channel is after `deliverySequence`. */
5
+ export function hasLocalWorkAfter(database, authorityId, entityId, deliverySequence) {
6
+ return anyWorkAfter(database, authorityId, deliverySequence)
7
+ && channelWorkAfter(database, authorityId, entityId, deliverySequence);
8
+ }
9
+ /** This computer's newest own result when local work on the entity's
10
+ * channel is after `deliverySequence`, else null. */
11
+ export function localWorkAfter(database, authorityId, entityId, deliverySequence) {
12
+ if (!hasLocalWorkAfter(database, authorityId, entityId, deliverySequence))
13
+ return null;
14
+ return ownResults(database, authorityId, deliverySequence, [entityId]).get(entityId) ?? null;
15
+ }
16
+ /** `hasLocalWorkAfterTarget` answering the newest own result, or null when
17
+ * no local work follows the target. The Apply store's port form. */
18
+ export function localWorkAfterTarget(database, authorityId, entityId, target) {
19
+ if (typeof target === "number")
20
+ return localWorkAfter(database, authorityId, entityId, retainedPosition(database, authorityId, entityId, target));
21
+ const floor = readDeliveryReceipt(database, authorityId)?.floor ?? 0;
22
+ const own = ownResults(database, authorityId, floor, [entityId]).get(entityId);
23
+ return own !== undefined && own.version !== target.version ? own : null;
24
+ }
25
+ /** The gate for the retained Inbox row at `globalSequence` on the entity's
26
+ * channel, or for a kept member's result: whether its newest own result not
27
+ * held at the kept head's watermark, the history floor, is another one. The
28
+ * Apply store's port form. */
29
+ export function hasLocalWorkAfterTarget(database, authorityId, entityId, target) {
30
+ if (typeof target !== "number") {
31
+ const floor = readDeliveryReceipt(database, authorityId)?.floor ?? 0;
32
+ const own = ownResults(database, authorityId, floor, [entityId]).get(entityId);
33
+ return own !== undefined && own.version !== target.version;
34
+ }
35
+ return hasLocalWorkAfter(database, authorityId, entityId, retainedPosition(database, authorityId, entityId, target));
36
+ }
37
+ function retainedPosition(database, authorityId, entityId, globalSequence) {
38
+ const deliverySequence = cachedStatement(database, `SELECT delivery_sequence FROM record_inbox
39
+ WHERE entity_id = ? AND global_sequence = ? AND authority_id = ?`).pluck()
40
+ .get(entityId, globalSequence, authorityId);
41
+ if (deliverySequence === undefined) {
42
+ throw new Error(`Apply local-work target ${entityId}@${globalSequence} is not retained`);
43
+ }
44
+ return deliverySequence;
45
+ }
46
+ /** Whether any local record on the authority may be after the target:
47
+ * a pending row, or a receipt delivered after it. */
48
+ function anyWorkAfter(database, authorityId, deliverySequence) {
49
+ return cachedStatement(database, `SELECT
50
+ EXISTS (SELECT 1 FROM record_outbox WHERE authority_id = ? AND status = 'pending')
51
+ OR COALESCE((SELECT delivery_sequence FROM record_outbox
52
+ WHERE authority_id = ? AND status = 'accepted'
53
+ ORDER BY delivery_sequence DESC LIMIT 1), 0) > ?`).pluck()
54
+ .get(authorityId, authorityId, deliverySequence) === 1;
55
+ }
56
+ const PENDING_AFTER = `SELECT EXISTS (SELECT 1 FROM record_outbox AS local
57
+ WHERE local.authority_id = ? AND local.entity_id = ? AND local.status = 'pending'
58
+ AND NOT EXISTS (SELECT 1 FROM record_inbox AS inbox
59
+ WHERE inbox.entity_id = local.entity_id AND inbox.mutation_id = local.mutation_id
60
+ AND inbox.authority_id = local.authority_id AND inbox.delivery_sequence <= ?))`;
61
+ const NEWEST_RECEIPT = `SELECT delivery_sequence FROM record_outbox
62
+ WHERE authority_id = ? AND entity_id = ? AND global_sequence IS NOT NULL
63
+ ORDER BY global_sequence DESC LIMIT 1`;
64
+ function channelWorkAfter(database, authorityId, entityId, deliverySequence) {
65
+ if (cachedStatement(database, PENDING_AFTER).pluck().get(authorityId, entityId, deliverySequence) === 1)
66
+ return true;
67
+ const newest = cachedStatement(database, NEWEST_RECEIPT).pluck().get(authorityId, entityId);
68
+ if (newest === null)
69
+ throw new Error(`entity ${entityId} has an accepted local row with no delivery position`);
70
+ return newest !== undefined && newest > deliverySequence;
71
+ }
72
+ //# sourceMappingURL=apply-local-work.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"apply-local-work.js","sourceRoot":"","sources":["../src/apply-local-work.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,116 @@
1
+ /**
2
+ * The drive's map of one root this computer serves on demand: Apply's door
3
+ * to it (Live drive/contracts.ts MapPort).
4
+ *
5
+ * Listed is the root's received state (received-state.ts) at the received
6
+ * prefix, the delivery cursor: the position a fetch lane pins (Live
7
+ * apply/lane.ts), so a touch places exactly the version the map lists, the
8
+ * newest this computer has received. Placed is a row stored in O, shown or
9
+ * hidden, and the map holds it where it stands on this computer, at the
10
+ * parent and name Detect or Apply last admitted: `ls` and `open` agree while
11
+ * Apply has not yet revealed an accepted move, and a person's new entity
12
+ * holds its slot beside what the map lists, so a listed namesake takes its
13
+ * derived name rather than hiding behind the person's. An entered folder's or
14
+ * workspace's version is the membership the map lists beneath it, at the
15
+ * place the map lists it: O's counts only the children this computer placed
16
+ * (detection/container-membership.ts), and the received one may name a place
17
+ * Apply has not yet moved it to. One never entered shows its record's, as
18
+ * nothing lists beneath it yet. An observed absence, a person's `rm -rf`
19
+ * (ground-store.ts), stands nowhere: its top reads as no O row, as the
20
+ * relations read it (ground-relations.ts), so the map lists it where the line
21
+ * does, else nowhere, and a name a person removed holds no slot once the line
22
+ * says so. Each row it hides is still this computer's, so the shelf says the
23
+ * ground is gone rather than the map listing it again. An entity with no O
24
+ * row stands first where this computer's own newest record of it stands
25
+ * while the received prefix does not hold that record yet: the removal, move
26
+ * or change of mode of a unit this computer never placed (Live
27
+ * drive/records.ts, held-removals.ts), or the removal of ground a person
28
+ * removed. The authority accepts this computer's records in their order, so
29
+ * that result is the next the line will say of it, and the map lists it so,
30
+ * under the parent that record names, from the moment it is recorded.
31
+ *
32
+ * The map holds what the drive has entered (MapPort.enter): the root, and
33
+ * each container's children whole once the drive first reads beneath it,
34
+ * read through H's pages for that one folder (registry-graph.ts). Each wake
35
+ * brings what it holds to the received prefix in the cost of what changed:
36
+ * every held entity the records accepted since its last position touch (a
37
+ * container one joins or leaves), each record that joins a container the
38
+ * drive entered, and the entities the wake names, those a window end or a
39
+ * Detect commit admitted (MapIndex, @amalgm/live/drive). A record that takes
40
+ * an entity into a container the drive never entered leaves it unread until
41
+ * the drive enters it. A new kept
42
+ * head, or a fold the heads let go, loads the root again, and enters again
43
+ * every container the drive had entered that still stands. The map holds its
44
+ * own HeldHeads over the computer's proven graphs, so its root's proven graph
45
+ * and fold stay resident while the drive is mounted: the rail's idle drops
46
+ * only the line's own, and the line's next read takes the graph the map still
47
+ * holds rather than proving it again. In memory: the rows of the folders the
48
+ * drive entered, beside the fold's results since H.
49
+ *
50
+ * A look at a reference, a stat of it or a listing of the folder it stands
51
+ * in, needs only its root's top (Live drive/contracts.ts Top), so it loads no
52
+ * map: `readDriveTop` reads the root's own record where its map would list
53
+ * it, the O row else the fold's, through H's pages for that one record. The
54
+ * fold folds the root only when a result since H reaches it. That record's
55
+ * version is not the membership a map lists, since a membership change is
56
+ * never a record. It need not be until the drive lists inside the root; from
57
+ * then the drive holds the root's map, and its top is the map's root
58
+ * (drive/mount.ts composeDrive).
59
+ */
60
+ import { type CloudEntityRecord } from "@amalgm/live";
61
+ import { type MapEntity, type MapPort } from "@amalgm/live/drive";
62
+ import type Database from "better-sqlite3";
63
+ import { HeldHeads, type ProvenGraphs } from "./received-state.js";
64
+ export interface ApplyMapOptions {
65
+ readonly database: Database.Database;
66
+ readonly authorityId: string;
67
+ readonly rootUUID: string;
68
+ /** This computer's proven kept heads: the map holds its root's for as long
69
+ * as it serves. */
70
+ readonly graphs: ProvenGraphs;
71
+ /** Hears each run that changed what the map lists: the entities it took
72
+ * and every container it touched, or null after a whole load. */
73
+ readonly onChange?: (touched: ReadonlySet<string> | null) => void;
74
+ }
75
+ export declare class ApplyMap {
76
+ #private;
77
+ readonly map: MapPort;
78
+ constructor(options: ApplyMapOptions);
79
+ get rootUUID(): string;
80
+ /** How many times the whole root was loaded again rather than advanced. */
81
+ get loads(): number;
82
+ /** The delivery position the map describes, null until it is loaded. */
83
+ get through(): number | null;
84
+ /** How many entities the map holds, any status. */
85
+ get size(): number;
86
+ /** The entity the map holds at `uuid`, any status. */
87
+ entity(uuid: string): MapEntity | undefined;
88
+ /** The record the map lists for an entity this computer never placed, at
89
+ * the version it lists it: the base its removal records Trash on. Null
90
+ * when the map does not hold the entity, or holds less than its record (a
91
+ * repository's package is not kept here), or this computer holds it: a
92
+ * placed unit's removal is its shelf's. */
93
+ listed(uuid: string): CloudEntityRecord | null;
94
+ /** Bring the map to the received prefix, taking `uuids` where they stand
95
+ * now. One run at a time; a wake during a run is answered by one more run
96
+ * after it, however many wakes arrive. Resolves when the run that saw this
97
+ * wake is done; rejects as that run did, leaving the map at its last
98
+ * position and every woken entity owed to the next run. */
99
+ refresh(uuids?: Iterable<string>): Promise<void>;
100
+ /** Forget the held fold; the next refresh loads the root again. */
101
+ drop(): void;
102
+ }
103
+ /** What a look at a root's top needs: its own record as its map would list
104
+ * it, and whether this computer holds it. */
105
+ export interface DriveTop {
106
+ readonly entity: MapEntity;
107
+ readonly placed: boolean;
108
+ }
109
+ /** The top of one root at the received prefix, read without its map. Null
110
+ * exactly when the root's map would hold nothing. */
111
+ export declare function readDriveTop(input: {
112
+ readonly database: Database.Database;
113
+ readonly authorityId: string;
114
+ readonly rootUUID: string;
115
+ readonly heads: HeldHeads;
116
+ }): Promise<DriveTop | null>;