@amalgm/shell 0.1.164-preview.36072132286 → 0.1.164-preview.36809057014

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 (475) hide show
  1. package/PURPOSE.md +642 -128
  2. package/README.md +10 -8
  3. package/dist/accepted-tail.d.ts +26 -0
  4. package/dist/accepted-tail.js +37 -0
  5. package/dist/accepted-tail.js.map +1 -0
  6. package/dist/agent-execution.d.ts +16 -1
  7. package/dist/agent-execution.js +13 -5
  8. package/dist/agent-execution.js.map +1 -1
  9. package/dist/apply-cleanup.d.ts +28 -0
  10. package/dist/apply-cleanup.js +166 -0
  11. package/dist/apply-cleanup.js.map +1 -0
  12. package/dist/apply-recovery.d.ts +47 -0
  13. package/dist/apply-recovery.js +99 -0
  14. package/dist/apply-recovery.js.map +1 -0
  15. package/dist/apply-rows.d.ts +72 -0
  16. package/dist/apply-rows.js +150 -0
  17. package/dist/apply-rows.js.map +1 -0
  18. package/dist/apply-saves.d.ts +85 -0
  19. package/dist/apply-saves.js +238 -0
  20. package/dist/apply-saves.js.map +1 -0
  21. package/dist/boot.js +2 -1
  22. package/dist/boot.js.map +1 -1
  23. package/dist/capture-work.d.ts +8 -0
  24. package/dist/capture-work.js +67 -0
  25. package/dist/capture-work.js.map +1 -0
  26. package/dist/cargo-group.d.ts +45 -0
  27. package/dist/cargo-group.js +88 -0
  28. package/dist/cargo-group.js.map +1 -0
  29. package/dist/channel-session.d.ts +4 -2
  30. package/dist/channel-session.js +4 -3
  31. package/dist/channel-session.js.map +1 -1
  32. package/dist/chat-composition.d.ts +2 -0
  33. package/dist/chat-composition.js +1 -0
  34. package/dist/chat-composition.js.map +1 -1
  35. package/dist/cli.js +20 -1
  36. package/dist/cli.js.map +1 -1
  37. package/dist/construct-apply-host.d.ts +4 -2
  38. package/dist/construct-apply-host.js +8 -3
  39. package/dist/construct-apply-host.js.map +1 -1
  40. package/dist/construct-door.js +1 -1
  41. package/dist/construct-door.js.map +1 -1
  42. package/dist/construct-ledger.d.ts +6 -1
  43. package/dist/construct-ledger.js +21 -33
  44. package/dist/construct-ledger.js.map +1 -1
  45. package/dist/content-cache-collection.d.ts +18 -0
  46. package/dist/content-cache-collection.js +99 -0
  47. package/dist/content-cache-collection.js.map +1 -0
  48. package/dist/content-cache-host.d.ts +83 -17
  49. package/dist/content-cache-host.js +335 -95
  50. package/dist/content-cache-host.js.map +1 -1
  51. package/dist/content-cache-namespace.d.ts +59 -0
  52. package/dist/content-cache-namespace.js +210 -0
  53. package/dist/content-cache-namespace.js.map +1 -0
  54. package/dist/content-cache-ownership.d.ts +13 -0
  55. package/dist/content-cache-ownership.js +75 -0
  56. package/dist/content-cache-ownership.js.map +1 -0
  57. package/dist/content-cache-retention.d.ts +23 -0
  58. package/dist/content-cache-retention.js +195 -0
  59. package/dist/content-cache-retention.js.map +1 -0
  60. package/dist/content-capture-pool.d.ts +287 -0
  61. package/dist/content-capture-pool.js +461 -0
  62. package/dist/content-capture-pool.js.map +1 -0
  63. package/dist/content-capture-worker.d.ts +8 -0
  64. package/dist/content-capture-worker.js +109 -0
  65. package/dist/content-capture-worker.js.map +1 -0
  66. package/dist/content-clock.d.ts +42 -0
  67. package/dist/content-clock.js +166 -0
  68. package/dist/content-clock.js.map +1 -0
  69. package/dist/content-direct.d.ts +2 -0
  70. package/dist/content-direct.js +12 -0
  71. package/dist/content-direct.js.map +1 -1
  72. package/dist/content-failure.d.ts +18 -0
  73. package/dist/content-failure.js +38 -0
  74. package/dist/content-failure.js.map +1 -0
  75. package/dist/content-stream-thread.d.ts +60 -0
  76. package/dist/content-stream-thread.js +95 -0
  77. package/dist/content-stream-thread.js.map +1 -0
  78. package/dist/content-stream-worker.d.ts +7 -0
  79. package/dist/content-stream-worker.js +52 -0
  80. package/dist/content-stream-worker.js.map +1 -0
  81. package/dist/declaration-absorption.d.ts +37 -0
  82. package/dist/declaration-absorption.js +119 -0
  83. package/dist/declaration-absorption.js.map +1 -0
  84. package/dist/declaration-chain.d.ts +36 -0
  85. package/dist/declaration-chain.js +96 -0
  86. package/dist/declaration-chain.js.map +1 -0
  87. package/dist/declaration-commit.d.ts +31 -0
  88. package/dist/declaration-commit.js +49 -0
  89. package/dist/declaration-commit.js.map +1 -0
  90. package/dist/declaration-hold.d.ts +22 -0
  91. package/dist/declaration-hold.js +24 -0
  92. package/dist/declaration-hold.js.map +1 -0
  93. package/dist/declaration-journal.d.ts +62 -0
  94. package/dist/declaration-journal.js +99 -0
  95. package/dist/declaration-journal.js.map +1 -0
  96. package/dist/declaration-save.d.ts +31 -0
  97. package/dist/declaration-save.js +134 -0
  98. package/dist/declaration-save.js.map +1 -0
  99. package/dist/detection/accepted-result.d.ts +19 -1
  100. package/dist/detection/accepted-result.js +36 -5
  101. package/dist/detection/accepted-result.js.map +1 -1
  102. package/dist/detection/admission-save.d.ts +55 -0
  103. package/dist/detection/admission-save.js +48 -0
  104. package/dist/detection/admission-save.js.map +1 -0
  105. package/dist/detection/admission-units.d.ts +66 -0
  106. package/dist/detection/admission-units.js +322 -0
  107. package/dist/detection/admission-units.js.map +1 -0
  108. package/dist/detection/alias-discovery.d.ts +12 -0
  109. package/dist/detection/alias-discovery.js +80 -0
  110. package/dist/detection/alias-discovery.js.map +1 -0
  111. package/dist/detection/alias-examination.d.ts +30 -0
  112. package/dist/detection/alias-examination.js +49 -0
  113. package/dist/detection/alias-examination.js.map +1 -0
  114. package/dist/detection/apply-ownership.d.ts +81 -0
  115. package/dist/detection/apply-ownership.js +232 -0
  116. package/dist/detection/apply-ownership.js.map +1 -0
  117. package/dist/detection/basis-advanced.d.ts +11 -0
  118. package/dist/detection/basis-advanced.js +26 -0
  119. package/dist/detection/basis-advanced.js.map +1 -0
  120. package/dist/detection/capture-outcome.d.ts +16 -0
  121. package/dist/detection/capture-outcome.js +92 -0
  122. package/dist/detection/capture-outcome.js.map +1 -0
  123. package/dist/detection/container-membership.d.ts +32 -0
  124. package/dist/detection/container-membership.js +49 -0
  125. package/dist/detection/container-membership.js.map +1 -0
  126. package/dist/detection/detect-cancelled.d.ts +6 -0
  127. package/dist/detection/detect-cancelled.js +10 -0
  128. package/dist/detection/detect-cancelled.js.map +1 -0
  129. package/dist/detection/directory-proof.d.ts +47 -0
  130. package/dist/detection/directory-proof.js +77 -0
  131. package/dist/detection/directory-proof.js.map +1 -0
  132. package/dist/detection/disposition-rows.d.ts +18 -0
  133. package/dist/detection/disposition-rows.js +29 -0
  134. package/dist/detection/disposition-rows.js.map +1 -0
  135. package/dist/detection/dispositions.d.ts +130 -0
  136. package/dist/detection/dispositions.js +248 -0
  137. package/dist/detection/dispositions.js.map +1 -0
  138. package/dist/detection/git-notice.d.ts +88 -0
  139. package/dist/detection/git-notice.js +444 -0
  140. package/dist/detection/git-notice.js.map +1 -0
  141. package/dist/detection/ground-proof.d.ts +130 -0
  142. package/dist/detection/ground-proof.js +274 -0
  143. package/dist/detection/ground-proof.js.map +1 -0
  144. package/dist/detection/ground-reader.d.ts +29 -0
  145. package/dist/detection/ground-reader.js +102 -0
  146. package/dist/detection/ground-reader.js.map +1 -0
  147. package/dist/detection/held-territory.d.ts +51 -0
  148. package/dist/detection/held-territory.js +205 -0
  149. package/dist/detection/held-territory.js.map +1 -0
  150. package/dist/detection/identity-discovery.d.ts +45 -0
  151. package/dist/detection/identity-discovery.js +287 -0
  152. package/dist/detection/identity-discovery.js.map +1 -0
  153. package/dist/detection/maintenance-sweep.d.ts +108 -0
  154. package/dist/detection/maintenance-sweep.js +325 -0
  155. package/dist/detection/maintenance-sweep.js.map +1 -0
  156. package/dist/detection/name-reach.d.ts +12 -0
  157. package/dist/detection/name-reach.js +28 -0
  158. package/dist/detection/name-reach.js.map +1 -0
  159. package/dist/detection/notebook-basis.d.ts +5 -7
  160. package/dist/detection/notebook-basis.js +6 -7
  161. package/dist/detection/notebook-basis.js.map +1 -1
  162. package/dist/detection/owed-selection.d.ts +51 -0
  163. package/dist/detection/owed-selection.js +169 -0
  164. package/dist/detection/owed-selection.js.map +1 -0
  165. package/dist/detection/portable.d.ts +34 -34
  166. package/dist/detection/portable.js +67 -93
  167. package/dist/detection/portable.js.map +1 -1
  168. package/dist/detection/reconciliation-coverage.d.ts +7 -0
  169. package/dist/detection/reconciliation-coverage.js +16 -0
  170. package/dist/detection/reconciliation-coverage.js.map +1 -0
  171. package/dist/detection/repository-publication.d.ts +20 -0
  172. package/dist/detection/repository-publication.js +79 -0
  173. package/dist/detection/repository-publication.js.map +1 -0
  174. package/dist/detection/repository-routes.d.ts +43 -0
  175. package/dist/detection/repository-routes.js +97 -0
  176. package/dist/detection/repository-routes.js.map +1 -0
  177. package/dist/detection/root-examination.d.ts +94 -0
  178. package/dist/detection/root-examination.js +523 -0
  179. package/dist/detection/root-examination.js.map +1 -0
  180. package/dist/detection/runtime.d.ts +131 -64
  181. package/dist/detection/runtime.js +808 -1103
  182. package/dist/detection/runtime.js.map +1 -1
  183. package/dist/detection/scoped-identity-port.d.ts +34 -0
  184. package/dist/detection/scoped-identity-port.js +81 -0
  185. package/dist/detection/scoped-identity-port.js.map +1 -0
  186. package/dist/detection/seal-law.d.ts +66 -0
  187. package/dist/detection/seal-law.js +116 -0
  188. package/dist/detection/seal-law.js.map +1 -0
  189. package/dist/detection/sharing-policy.d.ts +11 -0
  190. package/dist/detection/sharing-policy.js +32 -0
  191. package/dist/detection/sharing-policy.js.map +1 -0
  192. package/dist/detection/thread-database.d.ts +4 -0
  193. package/dist/detection/thread-database.js +30 -0
  194. package/dist/detection/thread-database.js.map +1 -0
  195. package/dist/detection/unreadable.d.ts +11 -0
  196. package/dist/detection/unreadable.js +9 -0
  197. package/dist/detection/unreadable.js.map +1 -0
  198. package/dist/detection/verified-content.d.ts +6 -0
  199. package/dist/detection/verified-content.js +12 -0
  200. package/dist/detection/verified-content.js.map +1 -0
  201. package/dist/detection/walk-law.d.ts +34 -0
  202. package/dist/detection/walk-law.js +55 -0
  203. package/dist/detection/walk-law.js.map +1 -0
  204. package/dist/development/fly-guest.js +2 -1
  205. package/dist/development/fly-guest.js.map +1 -1
  206. package/dist/entity-apply-host.d.ts +29 -13
  207. package/dist/entity-apply-host.js +1426 -461
  208. package/dist/entity-apply-host.js.map +1 -1
  209. package/dist/entity-apply-store.d.ts +77 -30
  210. package/dist/entity-apply-store.js +221 -516
  211. package/dist/entity-apply-store.js.map +1 -1
  212. package/dist/entity-record-observability.js +2 -0
  213. package/dist/entity-record-observability.js.map +1 -1
  214. package/dist/entity-record-saves.d.ts +20 -0
  215. package/dist/entity-record-saves.js +91 -0
  216. package/dist/entity-record-saves.js.map +1 -0
  217. package/dist/entity-record-store.d.ts +15 -7
  218. package/dist/entity-record-store.js +57 -117
  219. package/dist/entity-record-store.js.map +1 -1
  220. package/dist/files-register-host.d.ts +22 -3
  221. package/dist/files-register-host.js +70 -31
  222. package/dist/files-register-host.js.map +1 -1
  223. package/dist/filesystem.js +3 -2
  224. package/dist/filesystem.js.map +1 -1
  225. package/dist/git-binding.d.ts +65 -0
  226. package/dist/git-binding.js +220 -0
  227. package/dist/git-binding.js.map +1 -0
  228. package/dist/git-capture.d.ts +39 -0
  229. package/dist/git-capture.js +86 -0
  230. package/dist/git-capture.js.map +1 -0
  231. package/dist/git-card.d.ts +12 -0
  232. package/dist/git-card.js +123 -0
  233. package/dist/git-card.js.map +1 -0
  234. package/dist/git-checkpoint-construction.d.ts +41 -0
  235. package/dist/git-checkpoint-construction.js +96 -0
  236. package/dist/git-checkpoint-construction.js.map +1 -0
  237. package/dist/git-checkpoint-preparation.d.ts +37 -0
  238. package/dist/git-checkpoint-preparation.js +145 -0
  239. package/dist/git-checkpoint-preparation.js.map +1 -0
  240. package/dist/git-command.d.ts +61 -8
  241. package/dist/git-command.js +217 -63
  242. package/dist/git-command.js.map +1 -1
  243. package/dist/git-configuration.d.ts +40 -0
  244. package/dist/git-configuration.js +217 -0
  245. package/dist/git-configuration.js.map +1 -0
  246. package/dist/git-evidence.d.ts +61 -0
  247. package/dist/git-evidence.js +181 -0
  248. package/dist/git-evidence.js.map +1 -0
  249. package/dist/git-index-entries.d.ts +15 -0
  250. package/dist/git-index-entries.js +44 -0
  251. package/dist/git-index-entries.js.map +1 -0
  252. package/dist/git-index-format.d.ts +35 -0
  253. package/dist/git-index-format.js +293 -0
  254. package/dist/git-index-format.js.map +1 -0
  255. package/dist/git-index-witness.d.ts +33 -0
  256. package/dist/git-index-witness.js +69 -0
  257. package/dist/git-index-witness.js.map +1 -0
  258. package/dist/git-literal-host.d.ts +82 -0
  259. package/dist/git-literal-host.js +172 -0
  260. package/dist/git-literal-host.js.map +1 -0
  261. package/dist/git-literal-read.d.ts +88 -0
  262. package/dist/git-literal-read.js +170 -0
  263. package/dist/git-literal-read.js.map +1 -0
  264. package/dist/git-literal-replay.d.ts +33 -0
  265. package/dist/git-literal-replay.js +268 -0
  266. package/dist/git-literal-replay.js.map +1 -0
  267. package/dist/git-native-file.d.ts +42 -0
  268. package/dist/git-native-file.js +145 -0
  269. package/dist/git-native-file.js.map +1 -0
  270. package/dist/git-native-index.d.ts +21 -0
  271. package/dist/git-native-index.js +44 -0
  272. package/dist/git-native-index.js.map +1 -0
  273. package/dist/git-operation-host.d.ts +48 -0
  274. package/dist/git-operation-host.js +127 -0
  275. package/dist/git-operation-host.js.map +1 -0
  276. package/dist/git-private-index.d.ts +11 -0
  277. package/dist/git-private-index.js +42 -0
  278. package/dist/git-private-index.js.map +1 -0
  279. package/dist/git-private-repository.d.ts +4 -0
  280. package/dist/git-private-repository.js +69 -0
  281. package/dist/git-private-repository.js.map +1 -0
  282. package/dist/git-private-view.d.ts +39 -0
  283. package/dist/git-private-view.js +162 -0
  284. package/dist/git-private-view.js.map +1 -0
  285. package/dist/git-ref-store.d.ts +12 -0
  286. package/dist/git-ref-store.js +68 -0
  287. package/dist/git-ref-store.js.map +1 -0
  288. package/dist/git-registration-host.d.ts +20 -30
  289. package/dist/git-registration-host.js +86 -249
  290. package/dist/git-registration-host.js.map +1 -1
  291. package/dist/git-repository-host.d.ts +148 -22
  292. package/dist/git-repository-host.js +633 -650
  293. package/dist/git-repository-host.js.map +1 -1
  294. package/dist/git-worktree-host.d.ts +2 -0
  295. package/dist/git-worktree-host.js +16 -0
  296. package/dist/git-worktree-host.js.map +1 -0
  297. package/dist/graph-publication.d.ts +75 -0
  298. package/dist/graph-publication.js +203 -0
  299. package/dist/graph-publication.js.map +1 -0
  300. package/dist/ground-basis.d.ts +242 -0
  301. package/dist/ground-basis.js +1023 -0
  302. package/dist/ground-basis.js.map +1 -0
  303. package/dist/ground-checkpoint-worker.d.ts +1 -0
  304. package/dist/ground-checkpoint-worker.js +84 -0
  305. package/dist/ground-checkpoint-worker.js.map +1 -0
  306. package/dist/ground-checkpoints.d.ts +16 -0
  307. package/dist/ground-checkpoints.js +45 -0
  308. package/dist/ground-checkpoints.js.map +1 -0
  309. package/dist/ground-coordination.d.ts +107 -3
  310. package/dist/ground-coordination.js +249 -24
  311. package/dist/ground-coordination.js.map +1 -1
  312. package/dist/ground-database.d.ts +42 -0
  313. package/dist/ground-database.js +290 -0
  314. package/dist/ground-database.js.map +1 -0
  315. package/dist/ground-differences.d.ts +23 -0
  316. package/dist/ground-differences.js +47 -0
  317. package/dist/ground-differences.js.map +1 -0
  318. package/dist/ground-holders.d.ts +4 -0
  319. package/dist/ground-holders.js +15 -0
  320. package/dist/ground-holders.js.map +1 -0
  321. package/dist/ground-initialization-worker.d.ts +1 -0
  322. package/dist/ground-initialization-worker.js +20 -0
  323. package/dist/ground-initialization-worker.js.map +1 -0
  324. package/dist/ground-initialization.d.ts +35 -0
  325. package/dist/ground-initialization.js +102 -0
  326. package/dist/ground-initialization.js.map +1 -0
  327. package/dist/ground-install-saves.d.ts +63 -0
  328. package/dist/ground-install-saves.js +139 -0
  329. package/dist/ground-install-saves.js.map +1 -0
  330. package/dist/ground-inventory-schema.d.ts +18 -0
  331. package/dist/ground-inventory-schema.js +168 -0
  332. package/dist/ground-inventory-schema.js.map +1 -0
  333. package/dist/ground-profile.d.ts +7 -0
  334. package/dist/ground-profile.js +52 -0
  335. package/dist/ground-profile.js.map +1 -0
  336. package/dist/ground-root-index.d.ts +2 -1
  337. package/dist/ground-root-index.js +16 -14
  338. package/dist/ground-root-index.js.map +1 -1
  339. package/dist/ground-row.d.ts +62 -0
  340. package/dist/ground-row.js +70 -0
  341. package/dist/ground-row.js.map +1 -0
  342. package/dist/ground-save-ops.d.ts +44 -0
  343. package/dist/ground-save-ops.js +41 -0
  344. package/dist/ground-save-ops.js.map +1 -0
  345. package/dist/ground-saver-worker.d.ts +1 -0
  346. package/dist/ground-saver-worker.js +156 -0
  347. package/dist/ground-saver-worker.js.map +1 -0
  348. package/dist/ground-saver.d.ts +75 -0
  349. package/dist/ground-saver.js +216 -0
  350. package/dist/ground-saver.js.map +1 -0
  351. package/dist/ground-store.d.ts +84 -0
  352. package/dist/ground-store.js +473 -0
  353. package/dist/ground-store.js.map +1 -0
  354. package/dist/ground-territory.d.ts +130 -0
  355. package/dist/ground-territory.js +511 -0
  356. package/dist/ground-territory.js.map +1 -0
  357. package/dist/index.d.ts +1 -1
  358. package/dist/index.js.map +1 -1
  359. package/dist/installation/ownership.d.ts +0 -2
  360. package/dist/installation/ownership.js +3 -15
  361. package/dist/installation/ownership.js.map +1 -1
  362. package/dist/machine-host.d.ts +3 -2
  363. package/dist/machine-host.js +28 -16
  364. package/dist/machine-host.js.map +1 -1
  365. package/dist/materialized-graph.d.ts +7 -7
  366. package/dist/materialized-graph.js +11 -23
  367. package/dist/materialized-graph.js.map +1 -1
  368. package/dist/module-thread.d.ts +9 -0
  369. package/dist/module-thread.js +10 -0
  370. package/dist/module-thread.js.map +1 -0
  371. package/dist/native/fsevents-stream.node +0 -0
  372. package/dist/physical-path-witness.d.ts +64 -0
  373. package/dist/physical-path-witness.js +168 -0
  374. package/dist/physical-path-witness.js.map +1 -0
  375. package/dist/register-upload-fusion.d.ts +5 -4
  376. package/dist/register-upload-fusion.js +9 -6
  377. package/dist/register-upload-fusion.js.map +1 -1
  378. package/dist/registry-graph.d.ts +3 -2
  379. package/dist/registry-graph.js +9 -6
  380. package/dist/registry-graph.js.map +1 -1
  381. package/dist/registry-page-cache.d.ts +5 -2
  382. package/dist/registry-page-cache.js.map +1 -1
  383. package/dist/repository-identity-steps.d.ts +5 -0
  384. package/dist/repository-identity-steps.js +33 -0
  385. package/dist/repository-identity-steps.js.map +1 -0
  386. package/dist/runtime-node-flags.d.ts +10 -0
  387. package/dist/runtime-node-flags.js +11 -0
  388. package/dist/runtime-node-flags.js.map +1 -0
  389. package/dist/service/adapter.d.ts +1 -1
  390. package/dist/service/adapter.js +1 -1
  391. package/dist/service/adapter.js.map +1 -1
  392. package/dist/service/cli.js +16 -20
  393. package/dist/service/cli.js.map +1 -1
  394. package/dist/service/control.d.ts +2 -2
  395. package/dist/service/keepalive.d.ts +4 -11
  396. package/dist/service/keepalive.js +65 -118
  397. package/dist/service/keepalive.js.map +1 -1
  398. package/dist/service/policy.d.ts +36 -0
  399. package/dist/service/policy.js +25 -0
  400. package/dist/service/policy.js.map +1 -0
  401. package/dist/service/portable.d.ts +1 -1
  402. package/dist/service/portable.js +1 -1
  403. package/dist/service/portable.js.map +1 -1
  404. package/dist/service/recovery.d.ts +10 -9
  405. package/dist/service/recovery.js +29 -19
  406. package/dist/service/recovery.js.map +1 -1
  407. package/dist/service/windows-action.d.ts +5 -3
  408. package/dist/service/windows-action.js +6 -9
  409. package/dist/service/windows-action.js.map +1 -1
  410. package/dist/service/windows-task.js +5 -5
  411. package/dist/service/windows-task.js.map +1 -1
  412. package/dist/sharing-admission.d.ts +17 -0
  413. package/dist/sharing-admission.js +128 -0
  414. package/dist/sharing-admission.js.map +1 -0
  415. package/dist/snapshot-delivery-baseline.d.ts +12 -3
  416. package/dist/snapshot-delivery-baseline.js +41 -42
  417. package/dist/snapshot-delivery-baseline.js.map +1 -1
  418. package/dist/source-proof.d.ts +36 -0
  419. package/dist/source-proof.js +70 -0
  420. package/dist/source-proof.js.map +1 -0
  421. package/dist/source-signature.d.ts +56 -0
  422. package/dist/source-signature.js +56 -0
  423. package/dist/source-signature.js.map +1 -0
  424. package/dist/source-witness.d.ts +15 -0
  425. package/dist/source-witness.js +29 -0
  426. package/dist/source-witness.js.map +1 -0
  427. package/dist/sqlite-durability.d.ts +31 -0
  428. package/dist/sqlite-durability.js +28 -0
  429. package/dist/sqlite-durability.js.map +1 -0
  430. package/dist/sqlite.d.ts +8 -2
  431. package/dist/sqlite.js +27 -4
  432. package/dist/sqlite.js.map +1 -1
  433. package/dist/sync-address.d.ts +19 -0
  434. package/dist/sync-address.js +52 -0
  435. package/dist/sync-address.js.map +1 -0
  436. package/dist/sync-setting.d.ts +15 -0
  437. package/dist/sync-setting.js +13 -0
  438. package/dist/sync-setting.js.map +1 -1
  439. package/dist/turns.d.ts +42 -0
  440. package/dist/turns.js +112 -0
  441. package/dist/turns.js.map +1 -0
  442. package/dist/updates/bootstrap.d.ts +53 -7
  443. package/dist/updates/bootstrap.js +224 -137
  444. package/dist/updates/bootstrap.js.map +1 -1
  445. package/dist/updates/controller.d.ts +8 -0
  446. package/dist/updates/controller.js +27 -3
  447. package/dist/updates/controller.js.map +1 -1
  448. package/dist/updates/store.d.ts +3 -0
  449. package/dist/updates/store.js +12 -0
  450. package/dist/updates/store.js.map +1 -1
  451. package/dist/user-ground-host.d.ts +364 -69
  452. package/dist/user-ground-host.js +5231 -3366
  453. package/dist/user-ground-host.js.map +1 -1
  454. package/dist/watching/fsevents.d.ts +52 -1
  455. package/dist/watching/fsevents.js +60 -25
  456. package/dist/watching/fsevents.js.map +1 -1
  457. package/dist/watching/host.d.ts +129 -5
  458. package/dist/watching/host.js +433 -80
  459. package/dist/watching/host.js.map +1 -1
  460. package/dist/watching/index.d.ts +1 -1
  461. package/dist/wire-binary.d.ts +3 -2
  462. package/dist/wire-binary.js +10 -8
  463. package/dist/wire-binary.js.map +1 -1
  464. package/dist/wire-client.d.ts +3 -4
  465. package/dist/wire-client.js +18 -44
  466. package/dist/wire-client.js.map +1 -1
  467. package/dist/wire-outbox.d.ts +34 -0
  468. package/dist/wire-outbox.js +127 -0
  469. package/dist/wire-outbox.js.map +1 -0
  470. package/dist/workspace-host.d.ts +4 -0
  471. package/dist/workspace-host.js +12 -1
  472. package/dist/workspace-host.js.map +1 -1
  473. package/examinations/fixtures/private-wire-authority.js +133 -10
  474. package/npm-shrinkwrap.json +43 -56
  475. package/package.json +26 -13
@@ -0,0 +1,77 @@
1
+ const CONTAINERS = new Set(['workspace', 'folder', 'repo.git']);
2
+ /**
3
+ * A named path can reuse an indexed identity only while its directory chain
4
+ * still names the same indexed physical containers. This proof owns no
5
+ * identity decisions: a mismatch or an unindexed container asks the complete
6
+ * Live reconciliation to decide. Directory timestamps are intentionally
7
+ * irrelevant; sibling writes do not change the parent association. Each
8
+ * container is read physically again at admission; the rows it was matched
9
+ * against are facts of the admission basis.
10
+ */
11
+ export class NamedDirectoryProof {
12
+ #ports;
13
+ #observed = new Map();
14
+ /** Distinct containers this pass read; the commit's recheck is closure. */
15
+ metadataReads = 0;
16
+ constructor(ports) {
17
+ this.#ports = ports;
18
+ }
19
+ read(path) {
20
+ this.metadataReads += 1;
21
+ return this.#ports.read(path);
22
+ }
23
+ /**
24
+ * Prove the directory chain containing a named path, even when Watch
25
+ * supplies only a child or Git notice. The name itself is read once, by
26
+ * the caller that classifies it; a Git notice's repository is one of its
27
+ * containers.
28
+ */
29
+ named(path) {
30
+ const segments = path.split('/');
31
+ const marker = segments.indexOf('.git');
32
+ const last = marker < 0 ? segments.length - 1 : marker;
33
+ return this.directory(segments.slice(0, last).join('/')) !== undefined;
34
+ }
35
+ /** One indexed container, proved beneath its proved parent from the root
36
+ * down, so a chain costs one lookup per container however deep it runs.
37
+ * Each is read once per pass and retained for commit. */
38
+ directory(path) {
39
+ const proved = this.#observed.get(path);
40
+ if (proved)
41
+ return proved.base;
42
+ const segments = path === '' ? [] : path.split('/');
43
+ let at = '', parent = this.#prove(at, undefined);
44
+ for (const segment of segments) {
45
+ if (!parent)
46
+ return undefined;
47
+ at = at ? `${at}/${segment}` : segment;
48
+ parent = this.#prove(at, parent);
49
+ }
50
+ return parent;
51
+ }
52
+ #prove(path, parent) {
53
+ const previous = this.#observed.get(path);
54
+ if (previous)
55
+ return previous.base;
56
+ const base = this.#ports.lookup(path, parent);
57
+ if (!base || !CONTAINERS.has(base.type)
58
+ || (parent !== undefined && base.parentUUID !== parent.uuid))
59
+ return undefined;
60
+ const physical = this.read(path);
61
+ if (!physical
62
+ || base.physicalKey !== physical.physicalKey
63
+ || (base.type === 'repo.git') !== physical.repository)
64
+ return undefined;
65
+ this.#observed.set(path, { base, physical });
66
+ return base;
67
+ }
68
+ unchanged() {
69
+ for (const [path, { physical }] of this.#observed) {
70
+ const now = this.#ports.read(path);
71
+ if (!now || now.physicalKey !== physical.physicalKey || now.repository !== physical.repository)
72
+ return false;
73
+ }
74
+ return true;
75
+ }
76
+ }
77
+ //# sourceMappingURL=directory-proof.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"directory-proof.js","sourceRoot":"","sources":["../../src/detection/directory-proof.ts"],"names":[],"mappings":"AAqBA,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC;AAEhE;;;;;;;;GAQG;AACH,MAAM,OAAO,mBAAmB;IACrB,MAAM,CAA2B;IACjC,SAAS,GAAG,IAAI,GAAG,EAAsD,CAAC;IACnF,2EAA2E;IAC3E,aAAa,GAAG,CAAC,CAAC;IAElB,YAAY,KAA+B;QACzC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACtB,CAAC;IAEO,IAAI,CAAC,IAAY;QACvB,IAAI,CAAC,aAAa,IAAI,CAAC,CAAC;QACxB,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,IAAY;QAChB,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACjC,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACxC,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;QACvD,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,SAAS,CAAC;IACzE,CAAC;IAED;;6DAEyD;IACzD,SAAS,CAAC,IAAY;QACpB,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC,IAAI,CAAC;QAC/B,MAAM,QAAQ,GAAG,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACpD,IAAI,EAAE,GAAG,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;QACjD,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,IAAI,CAAC,MAAM;gBAAE,OAAO,SAAS,CAAC;YAC9B,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;YACvC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QACnC,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,CAAC,IAAY,EAAE,MAAuB;QAC1C,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAC,IAAI,CAAC;QACnC,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC9C,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;eAClC,CAAC,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,UAAU,KAAK,MAAM,CAAC,IAAI,CAAC;YAAE,OAAO,SAAS,CAAC;QACjF,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,CAAC,QAAQ;eACR,IAAI,CAAC,WAAW,KAAK,QAAQ,CAAC,WAAW;eACzC,CAAC,IAAI,CAAC,IAAI,KAAK,UAAU,CAAC,KAAK,QAAQ,CAAC,UAAU;YAAE,OAAO,SAAS,CAAC;QAC1E,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC7C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,SAAS;QACP,KAAK,MAAM,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YAClD,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACnC,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,WAAW,KAAK,QAAQ,CAAC,WAAW,IAAI,GAAG,CAAC,UAAU,KAAK,QAAQ,CAAC,UAAU;gBAAE,OAAO,KAAK,CAAC;QAC/G,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}
@@ -0,0 +1,18 @@
1
+ /** Detect's disposition rows, written only by the ground file's saver thread
2
+ * (ground-saver.ts): an admission's rows inside its own save, beside the
3
+ * O/B/Outbox writes they explain, and every other fact as a save of its own.
4
+ * The rows explain decisions; they grant nothing (dispositions.ts). */
5
+ import type Database from "better-sqlite3";
6
+ import type { DetectDispositionEvent } from "@amalgm/live";
7
+ export interface DispositionRow {
8
+ readonly sequence: number;
9
+ readonly rowBytes: number;
10
+ }
11
+ export declare function insertDisposition(database: Database.Database, event: DetectDispositionEvent): DispositionRow;
12
+ /** The facts, in order. */
13
+ export declare const saveDispositions: (database: Database.Database, events: readonly DetectDispositionEvent[]) => readonly DispositionRow[];
14
+ /** Bounded: terminal facts age out with the ready facts committed beside
15
+ * them. Returns the rows removed. */
16
+ export declare function pruneDispositions(database: Database.Database, { now }: {
17
+ readonly now: number;
18
+ }): number;
@@ -0,0 +1,29 @@
1
+ import { cachedStatement } from "../sqlite.js";
2
+ /** Initial retention: whichever limit expires first. */
3
+ const RETAINED_TERMINAL_FACTS = 10_000;
4
+ const RETAINED_MS = 24 * 60 * 60 * 1000;
5
+ const PRUNE_BATCH = 500;
6
+ const INSERT = `INSERT INTO detect_dispositions(event_id, incarnation, fact, collection_id, recorded_at, event_json)
7
+ VALUES (?, ?, ?, ?, ?, ?)`;
8
+ export function insertDisposition(database, event) {
9
+ const json = JSON.stringify(event);
10
+ const { lastInsertRowid } = cachedStatement(database, INSERT)
11
+ .run(event.eventId, event.incarnation, event.fact, event.collectionId, event.recordedAt, json);
12
+ return { sequence: Number(lastInsertRowid), rowBytes: Buffer.byteLength(json) };
13
+ }
14
+ /** The facts, in order. */
15
+ export const saveDispositions = (database, events) => events.map(event => insertDisposition(database, event));
16
+ /** Bounded: terminal facts age out with the ready facts committed beside
17
+ * them. Returns the rows removed. */
18
+ export function pruneDispositions(database, { now }) {
19
+ const byCount = cachedStatement(database, `SELECT sequence FROM detect_dispositions WHERE fact <> 'ready'
20
+ ORDER BY sequence DESC LIMIT 1 OFFSET ?`).get(RETAINED_TERMINAL_FACTS)?.sequence ?? 0;
21
+ const byAge = cachedStatement(database, "SELECT MAX(sequence) AS sequence FROM detect_dispositions WHERE recorded_at < ?")
22
+ .get(now - RETAINED_MS).sequence ?? 0;
23
+ const floor = Math.max(byCount, byAge);
24
+ if (floor === 0)
25
+ return 0;
26
+ return cachedStatement(database, `DELETE FROM detect_dispositions WHERE sequence IN (
27
+ SELECT sequence FROM detect_dispositions WHERE sequence <= ? ORDER BY sequence LIMIT ?)`).run(floor, PRUNE_BATCH).changes;
28
+ }
29
+ //# sourceMappingURL=disposition-rows.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"disposition-rows.js","sourceRoot":"","sources":["../../src/detection/disposition-rows.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,wDAAwD;AACxD,MAAM,uBAAuB,GAAG,MAAM,CAAC;AACvC,MAAM,WAAW,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AACxC,MAAM,WAAW,GAAG,GAAG,CAAC;AAIxB,MAAM,MAAM,GAAG;4BACa,CAAC;AAE7B,MAAM,UAAU,iBAAiB,CAAC,QAA2B,EAAE,KAA6B;IAC1F,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACnC,MAAM,EAAE,eAAe,EAAE,GAAG,eAAe,CAAC,QAAQ,EAAE,MAAM,CAAC;SAC1D,GAAG,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,YAAY,EAAE,KAAK,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IACjG,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,eAAe,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;AAClF,CAAC;AAED,2BAA2B;AAC3B,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,QAA2B,EAAE,MAAyC,EAA6B,EAAE,CACpI,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,iBAAiB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;AAE1D;qCACqC;AACrC,MAAM,UAAU,iBAAiB,CAAC,QAA2B,EAAE,EAAE,GAAG,EAA4B;IAC9F,MAAM,OAAO,GAAI,eAAe,CAAC,QAAQ,EAAE;4CACD,CAAC,CAAC,GAAG,CAAC,uBAAuB,CAAsC,EAAE,QAAQ,IAAI,CAAC,CAAC;IAC7H,MAAM,KAAK,GAAI,eAAe,CAAC,QAAQ,EAAE,iFAAiF,CAAC;SACxH,GAAG,CAAC,GAAG,GAAG,WAAW,CAAiC,CAAC,QAAQ,IAAI,CAAC,CAAC;IACxE,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACvC,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAC1B,OAAO,eAAe,CAAC,QAAQ,EAAE;8FAC2D,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,OAAO,CAAC;AAChI,CAAC"}
@@ -0,0 +1,130 @@
1
+ import { type DetectBasisDescriptor, type DetectCutoff, type DetectDisposition, type DetectDispositionCounts, type DetectDispositionEvent, type DetectDispositionFact, type DetectDispositionPhase, type DetectRetry } from "@amalgm/live";
2
+ import type { WatchObservation } from "../watching/host.js";
3
+ import { type ApplyOwnershipBlocker } from "./apply-ownership.js";
4
+ import type { DispositionRow } from "./disposition-rows.js";
5
+ export interface DetectDispositionDetail {
6
+ readonly disposition: DetectDisposition;
7
+ readonly retry: DetectRetry | null;
8
+ readonly phase?: DetectDispositionPhase;
9
+ readonly reason?: string;
10
+ readonly counts?: DetectDispositionCounts;
11
+ readonly owners?: readonly string[];
12
+ }
13
+ /** Monotonic marks of one admission attempt: its save was posted, began,
14
+ * finished its checks (null where it never got that far), and committed or
15
+ * rolled back. */
16
+ export interface AdmissionMarks {
17
+ readonly requested: number;
18
+ readonly began: number | null;
19
+ readonly checked: number | null;
20
+ readonly ended: number;
21
+ }
22
+ /** Where one admission attempt's time went. Delivered with its outcome, never
23
+ * persisted: the outcome row commits inside the save it would time. */
24
+ export interface AdmissionSpans {
25
+ /** Ready fact registered until the admission transaction was requested. */
26
+ readonly readyToAdmissionMs: number;
27
+ /** Posted until the save began: the saver's queue and lock. */
28
+ readonly lockWaitMs: number | null;
29
+ /** The in-transaction binding, crossing, basis and source checks. */
30
+ readonly prerequisiteChecksMs: number | null;
31
+ /** Checks passed until committed: projection, writes and commit. */
32
+ readonly writeCommitMs: number | null;
33
+ /** Body began until committed or rolled back: transaction body + commit. */
34
+ readonly bodyCommitMs: number | null;
35
+ /** Requested until committed or rolled back: total admission latency. */
36
+ readonly admissionLatencyMs: number;
37
+ readonly commitToDeliveryMs: number;
38
+ }
39
+ export interface DetectLedgerDelivery {
40
+ readonly event: DetectDispositionEvent;
41
+ /** False only for a ready fact delivered in process before its row exists. */
42
+ readonly durable: boolean;
43
+ readonly sequence: number | null;
44
+ readonly rowBytes: number;
45
+ readonly writeMs: number;
46
+ readonly spans: AdmissionSpans | null;
47
+ }
48
+ export interface DetectLedgerReport {
49
+ /** `undelivered` counts earlier committed facts whose delivery threw. */
50
+ delivered(delivery: DetectLedgerDelivery, undelivered: number): void;
51
+ /** The facts were not recorded; the ledger is incomplete for them. */
52
+ gap(error: unknown, events: readonly DetectDispositionEvent[]): void;
53
+ pruned(rows: number, durationMs: number): void;
54
+ }
55
+ export declare class DetectDispositionLedger {
56
+ #private;
57
+ readonly incarnation: string;
58
+ constructor(file: string, incarnation: string, report: DetectLedgerReport);
59
+ pass(job: number, pass: number, observations: readonly WatchObservation[]): DetectPass;
60
+ /** One save outside admission; delivery follows its commit. `delivered`
61
+ * facts commit first without a second delivery. `spans` times the
62
+ * admission a rejected outcome ends, at its delivery. */
63
+ persist(events: readonly DetectDispositionEvent[], spans?: (() => AdmissionSpans) | null, delivered?: readonly DetectDispositionEvent[]): void;
64
+ /** A committed fact stays committed: a failing sink degrades delivery,
65
+ * never the admission or pass that produced the fact. */
66
+ deliver(delivery: DetectLedgerDelivery): void;
67
+ }
68
+ /** One Detect pass's open Watch observations. The first fact for each wins;
69
+ * closing records whatever remains, so every exit accounts for all of them. */
70
+ export declare class DetectPass {
71
+ #private;
72
+ readonly ledger: DetectDispositionLedger;
73
+ readonly job: number;
74
+ readonly pass: number;
75
+ constructor(ledger: DetectDispositionLedger, job: number, pass: number, observations: readonly WatchObservation[]);
76
+ /** Registers collections for admission. Each ready fact is delivered now,
77
+ * in process; its row commits later, beside the collection's outcome. */
78
+ collections(specs: readonly {
79
+ readonly observations: readonly WatchObservation[];
80
+ readonly unit: string;
81
+ readonly basis: DetectBasisDescriptor;
82
+ }[]): ReadyCollection[];
83
+ event(fact: DetectDispositionFact, detail: DetectDispositionDetail | null, extra: {
84
+ readonly collectionId: string | null;
85
+ readonly unit: string | null;
86
+ readonly cutoffs: readonly DetectCutoff[];
87
+ readonly basis: DetectBasisDescriptor | null;
88
+ }): DetectDispositionEvent;
89
+ dispose(observations: readonly WatchObservation[], detail: DetectDispositionDetail): void;
90
+ close(detail: DetectDispositionDetail): void;
91
+ }
92
+ /** One registered collection's single admission attempt. */
93
+ export declare class ReadyCollection {
94
+ #private;
95
+ readonly pass: DetectPass;
96
+ readonly id: string;
97
+ readonly unit: string;
98
+ readonly cutoffs: readonly DetectCutoff[];
99
+ readonly basis: DetectBasisDescriptor;
100
+ /** When it was registered. */
101
+ readonly readyAt: number;
102
+ /** Its registration, keeping the collection's original time and basis. */
103
+ readonly ready: DetectDispositionEvent;
104
+ constructor(pass: DetectPass, id: string, unit: string, cutoffs: readonly DetectCutoff[], basis: DetectBasisDescriptor);
105
+ fact(fact: DetectDispositionFact, detail: DetectDispositionDetail | null): DetectDispositionEvent;
106
+ /** The ready fact and the admitted outcome, both for the admission's save
107
+ * to write beside its O/B/Outbox rows. */
108
+ admission(counts: DetectDispositionCounts): readonly [DetectDispositionEvent, DetectDispositionEvent];
109
+ /** After the admission's save committed, with the outcome's row. */
110
+ committed(marks: AdmissionMarks, row: DispositionRow): void;
111
+ /** After rollback, or before any admission began (no marks). Any row
112
+ * written inside the admission rolled back with it; the ready fact commits
113
+ * again here, beside the outcome. */
114
+ rejected(detail: DetectDispositionDetail, marks: AdmissionMarks | null): void;
115
+ }
116
+ export declare const ownerIds: (owners: readonly ApplyOwnershipBlocker[]) => readonly string[];
117
+ /** A rejected admission keeps its actual cause: a storage failure stays a
118
+ * fault, never a changed source. */
119
+ export declare function admissionRejection(error: unknown): DetectDispositionDetail;
120
+ /** Evidence moved after it was read: a basis, a source or a Git notice. The
121
+ * same read later answers again; nothing is wrong with the ground. */
122
+ export declare function invalidated(error: unknown): boolean;
123
+ /** What an error leaves on every observation its pass still held, with the
124
+ * re-examination the host actually schedules for it. A named pass is a
125
+ * narrowed complete proof: what it cannot conclude, a refusal or a fault,
126
+ * the complete lane examines, as it does a widened named proof. */
127
+ export declare function observationDisposition(error: unknown, lane: "named" | "complete"): DetectDispositionDetail;
128
+ /** A pass that returns with an observation still open broke the ledger's
129
+ * law; it is reported as a fault rather than assumed to have landed. */
130
+ export declare const UNDISPOSED: DetectDispositionDetail;
@@ -0,0 +1,248 @@
1
+ /** Detect's disposition ledger: Live's diagnostic vocabulary, kept in the
2
+ * machine-local identity database. Registering a collection writes nothing:
3
+ * its ready fact is delivered in process, not independently durable, and
4
+ * commits only with its outcome, inside the admission's save on success or
5
+ * as a save of its own on rejection. A runtime that ends before either
6
+ * leaves no row, and an absent row never means nothing ran. Every Watch
7
+ * observation a pass takes on also ends with one fact. Durable facts are
8
+ * delivered after the saver committed their rows (disposition-rows.ts).
9
+ *
10
+ * The ledger explains decisions; it grants nothing. Its writes never touch
11
+ * ground revisions, Watch, receipts or retries, and product work never
12
+ * recovers from it; nothing waits for them. A write it cannot make is
13
+ * reported as a gap. */
14
+ import { randomUUID } from "node:crypto";
15
+ import { isRefusal, } from "@amalgm/live";
16
+ import { CaptureSourceChangedError } from "../content-cache-host.js";
17
+ import { GroundBasisChangedError } from "../ground-basis.js";
18
+ import { save } from "../ground-saver.js";
19
+ import { ApplyAttributionDeferred } from "./apply-ownership.js";
20
+ import { DetectionBasisAdvancedError } from "./basis-advanced.js";
21
+ import { isDetectCancelled } from "./detect-cancelled.js";
22
+ import { GitNoticeChanged } from "./git-notice.js";
23
+ const PRUNE_EVERY = 64;
24
+ const REASON_LIMIT = 512;
25
+ const cutoffsOf = (observations) => observations.map(({ directory, suspicion }) => ({ directory, generation: suspicion.generation, scope: suspicion.paths === null ? "root" : "paths" }));
26
+ export class DetectDispositionLedger {
27
+ incarnation;
28
+ #file;
29
+ #report;
30
+ #persisted = 0;
31
+ #undelivered = 0;
32
+ constructor(file, incarnation, report) {
33
+ this.incarnation = incarnation;
34
+ this.#file = file;
35
+ this.#report = report;
36
+ }
37
+ pass(job, pass, observations) {
38
+ return new DetectPass(this, job, pass, observations);
39
+ }
40
+ /** One save outside admission; delivery follows its commit. `delivered`
41
+ * facts commit first without a second delivery. `spans` times the
42
+ * admission a rejected outcome ends, at its delivery. */
43
+ persist(events, spans = null, delivered = []) {
44
+ if (events.length === 0)
45
+ return;
46
+ const facts = [...delivered, ...events];
47
+ save(this.#file, "detect.dispositions", facts).then(({ value: rows, posted, ended }) => {
48
+ const writeMs = ended - posted;
49
+ for (const [at, row] of rows.slice(delivered.length).entries()) {
50
+ this.deliver({ event: events[at], ...row, durable: true, writeMs, spans: spans?.() ?? null });
51
+ }
52
+ }, error => this.#gap(error, facts));
53
+ if (++this.#persisted % PRUNE_EVERY === 0) {
54
+ save(this.#file, "detect.prune", { now: Date.now() }).then(({ value: rows, began, ended }) => {
55
+ try {
56
+ this.#report.pruned(rows, ended - began);
57
+ }
58
+ catch {
59
+ this.#undelivered++;
60
+ }
61
+ }, error => this.#gap(error, []));
62
+ }
63
+ }
64
+ /** A committed fact stays committed: a failing sink degrades delivery,
65
+ * never the admission or pass that produced the fact. */
66
+ deliver(delivery) {
67
+ try {
68
+ this.#report.delivered(delivery, this.#undelivered);
69
+ }
70
+ catch {
71
+ this.#undelivered++;
72
+ }
73
+ }
74
+ #gap(error, events) {
75
+ try {
76
+ this.#report.gap(error, events);
77
+ }
78
+ catch {
79
+ this.#undelivered++;
80
+ }
81
+ }
82
+ }
83
+ /** One Detect pass's open Watch observations. The first fact for each wins;
84
+ * closing records whatever remains, so every exit accounts for all of them. */
85
+ export class DetectPass {
86
+ ledger;
87
+ job;
88
+ pass;
89
+ #open;
90
+ #facts = [];
91
+ constructor(ledger, job, pass, observations) {
92
+ this.ledger = ledger;
93
+ this.job = job;
94
+ this.pass = pass;
95
+ this.#open = new Map(observations.map(observation => [observation.directory, observation]));
96
+ }
97
+ /** Registers collections for admission. Each ready fact is delivered now,
98
+ * in process; its row commits later, beside the collection's outcome. */
99
+ collections(specs) {
100
+ const collections = specs.map(({ observations, unit, basis }) => new ReadyCollection(this, randomUUID(), unit, cutoffsOf(observations), basis));
101
+ for (const { ready } of collections) {
102
+ this.ledger.deliver({ event: ready, durable: false, sequence: null,
103
+ rowBytes: Buffer.byteLength(JSON.stringify(ready)), writeMs: 0, spans: null });
104
+ }
105
+ return collections;
106
+ }
107
+ event(fact, detail, extra) {
108
+ return {
109
+ eventId: randomUUID(), incarnation: this.ledger.incarnation, job: this.job, pass: this.pass, fact,
110
+ collectionId: extra.collectionId, attempt: extra.collectionId === null ? null : 1, unit: extra.unit,
111
+ disposition: detail?.disposition ?? null, phase: detail?.phase ?? "collection", retry: detail?.retry ?? null,
112
+ reason: detail?.reason?.slice(0, REASON_LIMIT) ?? null, cutoffs: extra.cutoffs, counts: detail?.counts ?? null,
113
+ owners: detail?.owners ?? [], basis: extra.basis, recordedAt: Date.now(),
114
+ };
115
+ }
116
+ dispose(observations, detail) {
117
+ for (const { directory } of observations) {
118
+ const observation = this.#open.get(directory);
119
+ if (!observation)
120
+ continue;
121
+ this.#open.delete(directory);
122
+ this.#facts.push(this.event("observation", detail, { collectionId: null, unit: null, cutoffs: cutoffsOf([observation]), basis: null }));
123
+ }
124
+ }
125
+ close(detail) {
126
+ this.dispose([...this.#open.values()], detail);
127
+ this.ledger.persist(this.#facts.splice(0));
128
+ }
129
+ }
130
+ /** One registered collection's single admission attempt. */
131
+ export class ReadyCollection {
132
+ pass;
133
+ id;
134
+ unit;
135
+ cutoffs;
136
+ basis;
137
+ #admitted = null;
138
+ #settled = false;
139
+ /** When it was registered. */
140
+ readyAt = performance.now();
141
+ /** Its registration, keeping the collection's original time and basis. */
142
+ ready;
143
+ constructor(pass, id, unit, cutoffs, basis) {
144
+ this.pass = pass;
145
+ this.id = id;
146
+ this.unit = unit;
147
+ this.cutoffs = cutoffs;
148
+ this.basis = basis;
149
+ this.ready = this.fact("ready", null);
150
+ }
151
+ fact(fact, detail) {
152
+ return this.pass.event(fact, detail, { collectionId: this.id, unit: this.unit, cutoffs: this.cutoffs, basis: fact === "ready" ? this.basis : null });
153
+ }
154
+ #spans(marks) {
155
+ return {
156
+ readyToAdmissionMs: marks.requested - this.readyAt,
157
+ lockWaitMs: marks.began === null ? null : marks.began - marks.requested,
158
+ prerequisiteChecksMs: marks.began === null || marks.checked === null ? null : marks.checked - marks.began,
159
+ writeCommitMs: marks.checked === null ? null : marks.ended - marks.checked,
160
+ bodyCommitMs: marks.began === null ? null : marks.ended - marks.began,
161
+ admissionLatencyMs: marks.ended - marks.requested,
162
+ commitToDeliveryMs: performance.now() - marks.ended,
163
+ };
164
+ }
165
+ /** The ready fact and the admitted outcome, both for the admission's save
166
+ * to write beside its O/B/Outbox rows. */
167
+ admission(counts) {
168
+ this.#admitted = this.fact("outcome", {
169
+ disposition: counts.admitted > 0 ? "admitted" : "examined-no-change",
170
+ retry: "none", phase: "admission", counts,
171
+ });
172
+ return [this.ready, this.#admitted];
173
+ }
174
+ /** After the admission's save committed, with the outcome's row. */
175
+ committed(marks, row) {
176
+ if (this.#settled || !this.#admitted)
177
+ throw new Error("a collection commits exactly one admitted outcome");
178
+ this.#settled = true;
179
+ this.pass.ledger.deliver({ event: this.#admitted, durable: true, ...row, writeMs: 0, spans: this.#spans(marks) });
180
+ }
181
+ /** After rollback, or before any admission began (no marks). Any row
182
+ * written inside the admission rolled back with it; the ready fact commits
183
+ * again here, beside the outcome. */
184
+ rejected(detail, marks) {
185
+ if (this.#settled)
186
+ return;
187
+ this.#settled = true;
188
+ this.pass.ledger.persist([this.fact("outcome", detail)], marks === null ? null : () => this.#spans(marks), [this.ready]);
189
+ }
190
+ }
191
+ const errorChain = (error) => {
192
+ const chain = [];
193
+ for (let link = error; link instanceof Error && chain.length < 8; link = link.cause)
194
+ chain.push(link);
195
+ return chain;
196
+ };
197
+ const reasonOf = (error) => error instanceof Error ? error.message : String(error);
198
+ export const ownerIds = (owners) => [...new Set(owners.map(owner => owner.intent.entityId))];
199
+ /** A rejected admission keeps its actual cause: a storage failure stays a
200
+ * fault, never a changed source. */
201
+ export function admissionRejection(error) {
202
+ const reason = reasonOf(error);
203
+ const chain = errorChain(error);
204
+ const deferral = chain.find((link) => link instanceof ApplyAttributionDeferred);
205
+ if (deferral)
206
+ return { disposition: "deferred-to-owner", retry: null, phase: "admission", reason, owners: ownerIds(deferral.owners) };
207
+ if (chain.some(link => link instanceof GroundBasisChangedError || link instanceof DetectionBasisAdvancedError)) {
208
+ return { disposition: "invalidated", retry: null, phase: "admission-basis", reason };
209
+ }
210
+ if (chain.some(link => link instanceof CaptureSourceChangedError || link instanceof GitNoticeChanged)) {
211
+ return { disposition: "invalidated", retry: null, phase: "admission-source-close", reason };
212
+ }
213
+ if (isDetectCancelled(error))
214
+ return { disposition: "cancelled", retry: null, phase: "admission", reason };
215
+ if (isRefusal(error))
216
+ return { disposition: "refused", retry: null, phase: "admission", reason };
217
+ return { disposition: "faulted", retry: null, phase: "admission", reason };
218
+ }
219
+ /** Evidence moved after it was read: a basis, a source or a Git notice. The
220
+ * same read later answers again; nothing is wrong with the ground. */
221
+ export function invalidated(error) {
222
+ return errorChain(error).some(link => link instanceof DetectionBasisAdvancedError
223
+ || link instanceof GroundBasisChangedError || link instanceof CaptureSourceChangedError || link instanceof GitNoticeChanged);
224
+ }
225
+ /** What an error leaves on every observation its pass still held, with the
226
+ * re-examination the host actually schedules for it. A named pass is a
227
+ * narrowed complete proof: what it cannot conclude, a refusal or a fault,
228
+ * the complete lane examines, as it does a widened named proof. */
229
+ export function observationDisposition(error, lane) {
230
+ const reason = reasonOf(error);
231
+ const chain = errorChain(error);
232
+ const deferral = chain.find((link) => link instanceof ApplyAttributionDeferred);
233
+ if (deferral)
234
+ return { disposition: "deferred-to-owner", retry: "owner-release", reason, owners: ownerIds(deferral.owners) };
235
+ if (isDetectCancelled(error))
236
+ return { disposition: "cancelled", retry: "next-ring", reason };
237
+ if (invalidated(error))
238
+ return { disposition: "invalidated", retry: "timer", reason };
239
+ if (isRefusal(error))
240
+ return { disposition: "refused", retry: lane === "named" ? "complete-lane" : "next-ring", reason };
241
+ return { disposition: "faulted", retry: lane === "named" ? "complete-lane" : "timer", reason };
242
+ }
243
+ /** A pass that returns with an observation still open broke the ledger's
244
+ * law; it is reported as a fault rather than assumed to have landed. */
245
+ export const UNDISPOSED = Object.freeze({
246
+ disposition: "faulted", retry: "timer", reason: "Detect pass ended without a disposition",
247
+ });
248
+ //# sourceMappingURL=dispositions.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"dispositions.js","sourceRoot":"","sources":["../../src/detection/dispositions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;wBAYwB;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EACL,SAAS,GASV,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAE1C,OAAO,EAAE,wBAAwB,EAA8B,MAAM,sBAAsB,CAAC;AAC5F,OAAO,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEnD,MAAM,WAAW,GAAG,EAAE,CAAC;AACvB,MAAM,YAAY,GAAG,GAAG,CAAC;AAyDzB,MAAM,SAAS,GAAG,CAAC,YAAyC,EAA2B,EAAE,CACvF,YAAY,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,EAAE,CAC5C,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,CAAC,UAAU,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;AAE3G,MAAM,OAAO,uBAAuB;IAMC;IAL1B,KAAK,CAAS;IACd,OAAO,CAAqB;IACrC,UAAU,GAAG,CAAC,CAAC;IACf,YAAY,GAAG,CAAC,CAAC;IAEjB,YAAY,IAAY,EAAW,WAAmB,EAAE,MAA0B;QAA/C,gBAAW,GAAX,WAAW,CAAQ;QACpD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;IACxB,CAAC;IAED,IAAI,CAAC,GAAW,EAAE,IAAY,EAAE,YAAyC;QACvE,OAAO,IAAI,UAAU,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC;IACvD,CAAC;IAED;;6DAEyD;IACzD,OAAO,CAAC,MAAyC,EAAE,QAAuC,IAAI,EAC5F,YAA+C,EAAE;QACjD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAChC,MAAM,KAAK,GAAG,CAAC,GAAG,SAAS,EAAE,GAAG,MAAM,CAAC,CAAC;QACxC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,qBAAqB,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE;YACrF,MAAM,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC;YAC/B,KAAK,MAAM,CAAC,EAAE,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;gBAC/D,IAAI,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,EAAE,CAAE,EAAE,GAAG,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;YACjG,CAAC;QACH,CAAC,EAAE,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;QACrC,IAAI,EAAE,IAAI,CAAC,UAAU,GAAG,WAAW,KAAK,CAAC,EAAE,CAAC;YAC1C,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,cAAc,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE;gBAC3F,IAAI,CAAC;oBAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,GAAG,KAAK,CAAC,CAAC;gBAAC,CAAC;gBAAC,MAAM,CAAC;oBAAC,IAAI,CAAC,YAAY,EAAE,CAAC;gBAAC,CAAC;YAClF,CAAC,EAAE,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IAED;6DACyD;IACzD,OAAO,CAAC,QAA8B;QACpC,IAAI,CAAC;YAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC;YAAC,IAAI,CAAC,YAAY,EAAE,CAAC;QAAC,CAAC;IAC7F,CAAC;IAED,IAAI,CAAC,KAAc,EAAE,MAAyC;QAC5D,IAAI,CAAC;YAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC;YAAC,IAAI,CAAC,YAAY,EAAE,CAAC;QAAC,CAAC;IACzE,CAAC;CACF;AAED;+EAC+E;AAC/E,MAAM,OAAO,UAAU;IAKV;IACA;IACA;IANF,KAAK,CAAgC;IACrC,MAAM,GAA6B,EAAE,CAAC;IAE/C,YACW,MAA+B,EAC/B,GAAW,EACX,IAAY,EACrB,YAAyC;QAHhC,WAAM,GAAN,MAAM,CAAyB;QAC/B,QAAG,GAAH,GAAG,CAAQ;QACX,SAAI,GAAJ,IAAI,CAAQ;QAGrB,IAAI,CAAC,KAAK,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,WAAW,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;IAC9F,CAAC;IAED;6EACyE;IACzE,WAAW,CAAC,KAET;QACD,MAAM,WAAW,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,YAAY,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,CAC9D,IAAI,eAAe,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,SAAS,CAAC,YAAY,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;QACjF,KAAK,MAAM,EAAE,KAAK,EAAE,IAAI,WAAW,EAAE,CAAC;YACpC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI;gBAChE,QAAQ,EAAE,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACnF,CAAC;QACD,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,IAA2B,EAAE,MAAsC,EAAE,KAG1E;QACC,OAAO;YACL,OAAO,EAAE,UAAU,EAAE,EAAE,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI;YACjG,YAAY,EAAE,KAAK,CAAC,YAAY,EAAE,OAAO,EAAE,KAAK,CAAC,YAAY,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI;YACnG,WAAW,EAAE,MAAM,EAAE,WAAW,IAAI,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,IAAI;YAC5G,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC,IAAI,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,IAAI,IAAI;YAC9G,MAAM,EAAE,MAAM,EAAE,MAAM,IAAI,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE;SACzE,CAAC;IACJ,CAAC;IAED,OAAO,CAAC,YAAyC,EAAE,MAA+B;QAChF,KAAK,MAAM,EAAE,SAAS,EAAE,IAAI,YAAY,EAAE,CAAC;YACzC,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YAC9C,IAAI,CAAC,WAAW;gBAAE,SAAS;YAC3B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAC7B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,aAAa,EAAE,MAAM,EAC/C,EAAE,YAAY,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACzF,CAAC;IACH,CAAC;IAED,KAAK,CAAC,MAA+B;QACnC,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;QAC/C,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7C,CAAC;CACF;AAED,4DAA4D;AAC5D,MAAM,OAAO,eAAe;IASf;IACA;IACA;IACA;IACA;IAZX,SAAS,GAAkC,IAAI,CAAC;IAChD,QAAQ,GAAG,KAAK,CAAC;IACjB,8BAA8B;IACrB,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;IACrC,0EAA0E;IACjE,KAAK,CAAyB;IAEvC,YACW,IAAgB,EAChB,EAAU,EACV,IAAY,EACZ,OAAgC,EAChC,KAA4B;QAJ5B,SAAI,GAAJ,IAAI,CAAY;QAChB,OAAE,GAAF,EAAE,CAAQ;QACV,SAAI,GAAJ,IAAI,CAAQ;QACZ,YAAO,GAAP,OAAO,CAAyB;QAChC,UAAK,GAAL,KAAK,CAAuB;QAErC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACxC,CAAC;IAED,IAAI,CAAC,IAA2B,EAAE,MAAsC;QACtE,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,EACjC,EAAE,YAAY,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACpH,CAAC;IAED,MAAM,CAAC,KAAqB;QAC1B,OAAO;YACL,kBAAkB,EAAE,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,OAAO;YAClD,UAAU,EAAE,KAAK,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,SAAS;YACvE,oBAAoB,EAAE,KAAK,CAAC,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC,KAAK;YACzG,aAAa,EAAE,KAAK,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,OAAO;YAC1E,YAAY,EAAE,KAAK,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK;YACrE,kBAAkB,EAAE,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,SAAS;YACjD,kBAAkB,EAAE,WAAW,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,KAAK;SACpD,CAAC;IACJ,CAAC;IAED;8CAC0C;IAC1C,SAAS,CAAC,MAA+B;QACvC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE;YACpC,WAAW,EAAE,MAAM,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,oBAAoB;YACpE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM;SAC1C,CAAC,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IACtC,CAAC;IAED,oEAAoE;IACpE,SAAS,CAAC,KAAqB,EAAE,GAAmB;QAClD,IAAI,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;QAC3G,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,GAAG,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACpH,CAAC;IAED;;yCAEqC;IACrC,QAAQ,CAAC,MAA+B,EAAE,KAA4B;QACpE,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO;QAC1B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,EAAE,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EACvG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAClB,CAAC;CACF;AAED,MAAM,UAAU,GAAG,CAAC,KAAc,EAAa,EAAE;IAC/C,MAAM,KAAK,GAAc,EAAE,CAAC;IAC5B,KAAK,IAAI,IAAI,GAAY,KAAK,EAAE,IAAI,YAAY,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC,KAAK;QAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/G,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAU,EAAE,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAEpG,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,MAAwC,EAAqB,EAAE,CACtF,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;AAE3D;oCACoC;AACpC,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC/B,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IAChC,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAoC,EAAE,CAAC,IAAI,YAAY,wBAAwB,CAAC,CAAC;IAClH,IAAI,QAAQ;QAAE,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;IACtI,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,YAAY,uBAAuB,IAAI,IAAI,YAAY,2BAA2B,CAAC,EAAE,CAAC;QAC/G,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,iBAAiB,EAAE,MAAM,EAAE,CAAC;IACvF,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,YAAY,yBAAyB,IAAI,IAAI,YAAY,gBAAgB,CAAC,EAAE,CAAC;QACtG,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,wBAAwB,EAAE,MAAM,EAAE,CAAC;IAC9F,CAAC;IACD,IAAI,iBAAiB,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IAC3G,IAAI,SAAS,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IACjG,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;AAC7E,CAAC;AAED;sEACsE;AACtE,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,YAAY,2BAA2B;WAC5E,IAAI,YAAY,uBAAuB,IAAI,IAAI,YAAY,yBAAyB,IAAI,IAAI,YAAY,gBAAgB,CAAC,CAAC;AACjI,CAAC;AAED;;;mEAGmE;AACnE,MAAM,UAAU,sBAAsB,CAAC,KAAc,EAAE,IAA0B;IAC/E,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC/B,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IAChC,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAoC,EAAE,CAAC,IAAI,YAAY,wBAAwB,CAAC,CAAC;IAClH,IAAI,QAAQ;QAAE,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;IAC7H,IAAI,iBAAiB,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IAC9F,IAAI,WAAW,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IACtF,IAAI,SAAS,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,WAAW,EAAE,MAAM,EAAE,CAAC;IACzH,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;AACjG,CAAC;AAED;wEACwE;AACxE,MAAM,CAAC,MAAM,UAAU,GAA4B,MAAM,CAAC,MAAM,CAAC;IAC/D,WAAW,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,yCAAyC;CAC1F,CAAC,CAAC"}
@@ -0,0 +1,88 @@
1
+ import { type SourceProof } from "../source-proof.js";
2
+ /** One enrolled repository: identity and address. Its O row is read only
3
+ * when a notice consumes its binding. */
4
+ export interface GitNoticeMember {
5
+ readonly uuid: string;
6
+ readonly rootUUID: string;
7
+ readonly absolutePath: string;
8
+ }
9
+ /** The O fields a consumed binding is certified against. */
10
+ export interface GitNoticeRow {
11
+ readonly payloadVersion?: string | null;
12
+ readonly gitConfigurationObservation?: string | null;
13
+ readonly physicalKey?: string | null;
14
+ }
15
+ export type GitNoticeRoute =
16
+ /** Ordinary ground examined whole at `address`: the name itself, the
17
+ * checkout holding the Git storage it names when no bound checkout
18
+ * consumes that name, or the released checkout whose storage it names. */
19
+ {
20
+ readonly kind: "worktree";
21
+ readonly address: string;
22
+ }
23
+ /** One private checkout's own Git state. `whole` owes its complete
24
+ * examination; otherwise its named Git state answers. */
25
+ | {
26
+ readonly kind: "single";
27
+ readonly uuid: string;
28
+ readonly whole: boolean;
29
+ } | {
30
+ readonly kind: "reconcile";
31
+ readonly rootUUIDs: readonly string[];
32
+ };
33
+ export interface GitNoticeView {
34
+ route(path: string): GitNoticeRoute;
35
+ /** The repository whose own address this is, when its binding still stands
36
+ * over the same directory O holds and every consumer lies within it: that
37
+ * repository's complete examination observes the address, and re-reads the
38
+ * configuration O may no longer carry. Null leaves the address to `route`. */
39
+ own(path: string): string | null;
40
+ /** The ground an address owes once every name is routed: the outermost
41
+ * checkout Git does not bind that holds it, or the address itself. */
42
+ held(address: string): string;
43
+ /** Closes only the bindings this view's routes consumed. */
44
+ readonly proof: SourceProof;
45
+ /** Time this observation waited for bindings still being discovered. */
46
+ readonly discoveryWaitMs: number;
47
+ /** Time spent routing, consumed-binding checks included. */
48
+ routeMs(): number;
49
+ /** Time the consumed bindings' semantic closure took. */
50
+ semanticMs(): number;
51
+ }
52
+ export declare class GitNoticeChanged extends Error {
53
+ constructor(cause: unknown);
54
+ }
55
+ /** Only these bounded domains describe this checkout's Git state by name. An
56
+ * unknown or coalesced administrative container must be examined more widely:
57
+ * the whole repository when its storage is private, else by reconciliation. */
58
+ export declare function ordinaryGitDomain(path: string): boolean;
59
+ /** Storage Git keeps inside a checkout's storage for other checkouts:
60
+ * submodule and linked-worktree administrative directories. */
61
+ export declare function foreignGitDomain(path: string): boolean;
62
+ interface MetadataStat {
63
+ readonly nlink: number;
64
+ isDirectory(): boolean;
65
+ isFile(): boolean;
66
+ }
67
+ interface MetadataReader {
68
+ stat(path: string): MetadataStat | null;
69
+ names(path: string): readonly string[];
70
+ }
71
+ /** An exclusion witness for mutable Git state. Symlinks, multiply linked
72
+ * files and unknown ref storage make the consumer description incomplete.
73
+ * Git objects are immutable addresses; this never walks the object store. */
74
+ export declare function privateGitMetadata(directory: string, reader?: MetadataReader): boolean;
75
+ /** The maintained binding table. Binding is serial and coalesced: callers
76
+ * share one task per repository, and a refresh never overwrites a newer
77
+ * entry. A refresh caused by a moved witness rings its checkout, so the
78
+ * changed consumer is reconciled over its old and new footprint. */
79
+ export declare class GitNoticeBindings {
80
+ #private;
81
+ private readonly rebound;
82
+ constructor(rebound?: (checkout: string) => void);
83
+ /** Startup discovery: bind every member in the background, one at a time,
84
+ * so the first notice does not pay for every repository. */
85
+ discover(members: readonly GitNoticeMember[]): void;
86
+ observe(members: readonly GitNoticeMember[], rowOf: (uuid: string) => GitNoticeRow | undefined): Promise<GitNoticeView>;
87
+ }
88
+ export {};