@agent-teams/document-authoring 0.0.0

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 (581) hide show
  1. package/CHANGELOG.md +5 -0
  2. package/LICENSE +201 -0
  3. package/README.md +11 -0
  4. package/dist/adapters/canonical-markdown.d.ts +14 -0
  5. package/dist/adapters/canonical-markdown.d.ts.map +1 -0
  6. package/dist/adapters/canonical-markdown.js +354 -0
  7. package/dist/adapters/canonical-markdown.js.map +1 -0
  8. package/dist/adapters/inbound/cli/document-command-renderer.d.ts +6 -0
  9. package/dist/adapters/inbound/cli/document-command-renderer.d.ts.map +1 -0
  10. package/dist/adapters/inbound/cli/document-command-renderer.js +123 -0
  11. package/dist/adapters/inbound/cli/document-command-renderer.js.map +1 -0
  12. package/dist/adapters/node/load-validated-document-authoring-profile-v2.d.ts +52 -0
  13. package/dist/adapters/node/load-validated-document-authoring-profile-v2.d.ts.map +1 -0
  14. package/dist/adapters/node/load-validated-document-authoring-profile-v2.js +103 -0
  15. package/dist/adapters/node/load-validated-document-authoring-profile-v2.js.map +1 -0
  16. package/dist/adapters/node/load-validated-document-authoring-profile.d.ts +33 -0
  17. package/dist/adapters/node/load-validated-document-authoring-profile.d.ts.map +1 -0
  18. package/dist/adapters/node/load-validated-document-authoring-profile.js +47 -0
  19. package/dist/adapters/node/load-validated-document-authoring-profile.js.map +1 -0
  20. package/dist/adapters/node/node-authoring-profile-reader-v2.d.ts +9 -0
  21. package/dist/adapters/node/node-authoring-profile-reader-v2.d.ts.map +1 -0
  22. package/dist/adapters/node/node-authoring-profile-reader-v2.js +42 -0
  23. package/dist/adapters/node/node-authoring-profile-reader-v2.js.map +1 -0
  24. package/dist/adapters/node/node-authoring-profile-reader.d.ts +9 -0
  25. package/dist/adapters/node/node-authoring-profile-reader.d.ts.map +1 -0
  26. package/dist/adapters/node/node-authoring-profile-reader.js +31 -0
  27. package/dist/adapters/node/node-authoring-profile-reader.js.map +1 -0
  28. package/dist/adapters/node/node-document-contract-validator.d.ts +7 -0
  29. package/dist/adapters/node/node-document-contract-validator.d.ts.map +1 -0
  30. package/dist/adapters/node/node-document-contract-validator.js +306 -0
  31. package/dist/adapters/node/node-document-contract-validator.js.map +1 -0
  32. package/dist/adapters/node/node-document-environment-inspector.d.ts +17 -0
  33. package/dist/adapters/node/node-document-environment-inspector.d.ts.map +1 -0
  34. package/dist/adapters/node/node-document-environment-inspector.js +49 -0
  35. package/dist/adapters/node/node-document-environment-inspector.js.map +1 -0
  36. package/dist/adapters/node/node-document-file-state.d.ts +21 -0
  37. package/dist/adapters/node/node-document-file-state.d.ts.map +1 -0
  38. package/dist/adapters/node/node-document-file-state.js +199 -0
  39. package/dist/adapters/node/node-document-file-state.js.map +1 -0
  40. package/dist/adapters/node/node-document-journal-store-faults.d.ts +36 -0
  41. package/dist/adapters/node/node-document-journal-store-faults.d.ts.map +1 -0
  42. package/dist/adapters/node/node-document-journal-store-faults.js +2 -0
  43. package/dist/adapters/node/node-document-journal-store-faults.js.map +1 -0
  44. package/dist/adapters/node/node-document-journal-store-private.d.ts +2 -0
  45. package/dist/adapters/node/node-document-journal-store-private.d.ts.map +1 -0
  46. package/dist/adapters/node/node-document-journal-store-private.js +2 -0
  47. package/dist/adapters/node/node-document-journal-store-private.js.map +1 -0
  48. package/dist/adapters/node/node-document-journal-store.d.ts +22 -0
  49. package/dist/adapters/node/node-document-journal-store.d.ts.map +1 -0
  50. package/dist/adapters/node/node-document-journal-store.js +235 -0
  51. package/dist/adapters/node/node-document-journal-store.js.map +1 -0
  52. package/dist/adapters/node/node-document-metadata-sidecar-reader.d.ts +9 -0
  53. package/dist/adapters/node/node-document-metadata-sidecar-reader.d.ts.map +1 -0
  54. package/dist/adapters/node/node-document-metadata-sidecar-reader.js +87 -0
  55. package/dist/adapters/node/node-document-metadata-sidecar-reader.js.map +1 -0
  56. package/dist/adapters/node/node-document-parent-materializer.d.ts +39 -0
  57. package/dist/adapters/node/node-document-parent-materializer.d.ts.map +1 -0
  58. package/dist/adapters/node/node-document-parent-materializer.js +269 -0
  59. package/dist/adapters/node/node-document-parent-materializer.js.map +1 -0
  60. package/dist/adapters/node/node-document-planning-profile-reader.d.ts +10 -0
  61. package/dist/adapters/node/node-document-planning-profile-reader.d.ts.map +1 -0
  62. package/dist/adapters/node/node-document-planning-profile-reader.js +85 -0
  63. package/dist/adapters/node/node-document-planning-profile-reader.js.map +1 -0
  64. package/dist/adapters/node/node-document-planning-state-reader.d.ts +11 -0
  65. package/dist/adapters/node/node-document-planning-state-reader.d.ts.map +1 -0
  66. package/dist/adapters/node/node-document-planning-state-reader.js +181 -0
  67. package/dist/adapters/node/node-document-planning-state-reader.js.map +1 -0
  68. package/dist/adapters/node/node-document-publisher-private.d.ts +2 -0
  69. package/dist/adapters/node/node-document-publisher-private.d.ts.map +1 -0
  70. package/dist/adapters/node/node-document-publisher-private.js +2 -0
  71. package/dist/adapters/node/node-document-publisher-private.js.map +1 -0
  72. package/dist/adapters/node/node-document-publisher.d.ts +54 -0
  73. package/dist/adapters/node/node-document-publisher.d.ts.map +1 -0
  74. package/dist/adapters/node/node-document-publisher.js +336 -0
  75. package/dist/adapters/node/node-document-publisher.js.map +1 -0
  76. package/dist/adapters/node/node-document-reachability-projector.d.ts +17 -0
  77. package/dist/adapters/node/node-document-reachability-projector.d.ts.map +1 -0
  78. package/dist/adapters/node/node-document-reachability-projector.js +43 -0
  79. package/dist/adapters/node/node-document-reachability-projector.js.map +1 -0
  80. package/dist/adapters/node/node-document-structure-verifier.d.ts +21 -0
  81. package/dist/adapters/node/node-document-structure-verifier.d.ts.map +1 -0
  82. package/dist/adapters/node/node-document-structure-verifier.js +80 -0
  83. package/dist/adapters/node/node-document-structure-verifier.js.map +1 -0
  84. package/dist/adapters/node/node-document-template-reader.d.ts +10 -0
  85. package/dist/adapters/node/node-document-template-reader.d.ts.map +1 -0
  86. package/dist/adapters/node/node-document-template-reader.js +32 -0
  87. package/dist/adapters/node/node-document-template-reader.js.map +1 -0
  88. package/dist/adapters/node/node-document-transaction-coordinator.d.ts +11 -0
  89. package/dist/adapters/node/node-document-transaction-coordinator.d.ts.map +1 -0
  90. package/dist/adapters/node/node-document-transaction-coordinator.js +60 -0
  91. package/dist/adapters/node/node-document-transaction-coordinator.js.map +1 -0
  92. package/dist/adapters/node/node-metadata-instance-validator.d.ts +9 -0
  93. package/dist/adapters/node/node-metadata-instance-validator.d.ts.map +1 -0
  94. package/dist/adapters/node/node-metadata-instance-validator.js +90 -0
  95. package/dist/adapters/node/node-metadata-instance-validator.js.map +1 -0
  96. package/dist/adapters/node/node-owner-membership-reader.d.ts +10 -0
  97. package/dist/adapters/node/node-owner-membership-reader.d.ts.map +1 -0
  98. package/dist/adapters/node/node-owner-membership-reader.js +62 -0
  99. package/dist/adapters/node/node-owner-membership-reader.js.map +1 -0
  100. package/dist/adapters/node/node-path-authority.d.ts +53 -0
  101. package/dist/adapters/node/node-path-authority.d.ts.map +1 -0
  102. package/dist/adapters/node/node-path-authority.js +186 -0
  103. package/dist/adapters/node/node-path-authority.js.map +1 -0
  104. package/dist/adapters/node/read-document-authority-file.d.ts +12 -0
  105. package/dist/adapters/node/read-document-authority-file.d.ts.map +1 -0
  106. package/dist/adapters/node/read-document-authority-file.js +78 -0
  107. package/dist/adapters/node/read-document-authority-file.js.map +1 -0
  108. package/dist/adapters/node/recapture-document-publication-paths.d.ts +17 -0
  109. package/dist/adapters/node/recapture-document-publication-paths.d.ts.map +1 -0
  110. package/dist/adapters/node/recapture-document-publication-paths.js +33 -0
  111. package/dist/adapters/node/recapture-document-publication-paths.js.map +1 -0
  112. package/dist/application/model/document-authoring-profile-description.d.ts +57 -0
  113. package/dist/application/model/document-authoring-profile-description.d.ts.map +1 -0
  114. package/dist/application/model/document-authoring-profile-description.js +2 -0
  115. package/dist/application/model/document-authoring-profile-description.js.map +1 -0
  116. package/dist/application/model/document-catalog.d.ts +88 -0
  117. package/dist/application/model/document-catalog.d.ts.map +1 -0
  118. package/dist/application/model/document-catalog.js +2 -0
  119. package/dist/application/model/document-catalog.js.map +1 -0
  120. package/dist/application/model/document-command.d.ts +69 -0
  121. package/dist/application/model/document-command.d.ts.map +1 -0
  122. package/dist/application/model/document-command.js +2 -0
  123. package/dist/application/model/document-command.js.map +1 -0
  124. package/dist/application/model/document-find.d.ts +22 -0
  125. package/dist/application/model/document-find.d.ts.map +1 -0
  126. package/dist/application/model/document-find.js +2 -0
  127. package/dist/application/model/document-find.js.map +1 -0
  128. package/dist/application/model/document-parent-materialization.d.ts +26 -0
  129. package/dist/application/model/document-parent-materialization.d.ts.map +1 -0
  130. package/dist/application/model/document-parent-materialization.js +2 -0
  131. package/dist/application/model/document-parent-materialization.js.map +1 -0
  132. package/dist/application/model/document-physical-identity.d.ts +10 -0
  133. package/dist/application/model/document-physical-identity.d.ts.map +1 -0
  134. package/dist/application/model/document-physical-identity.js +29 -0
  135. package/dist/application/model/document-physical-identity.js.map +1 -0
  136. package/dist/application/model/document-planning.d.ts +209 -0
  137. package/dist/application/model/document-planning.d.ts.map +1 -0
  138. package/dist/application/model/document-planning.js +2 -0
  139. package/dist/application/model/document-planning.js.map +1 -0
  140. package/dist/application/model/document-receipt.d.ts +101 -0
  141. package/dist/application/model/document-receipt.d.ts.map +1 -0
  142. package/dist/application/model/document-receipt.js +2 -0
  143. package/dist/application/model/document-receipt.js.map +1 -0
  144. package/dist/application/model/document-transaction-inspection.d.ts +66 -0
  145. package/dist/application/model/document-transaction-inspection.d.ts.map +1 -0
  146. package/dist/application/model/document-transaction-inspection.js +2 -0
  147. package/dist/application/model/document-transaction-inspection.js.map +1 -0
  148. package/dist/application/model/document-transaction.d.ts +169 -0
  149. package/dist/application/model/document-transaction.d.ts.map +1 -0
  150. package/dist/application/model/document-transaction.js +2 -0
  151. package/dist/application/model/document-transaction.js.map +1 -0
  152. package/dist/application/policies/assert-artifact-owner-allowed.d.ts +3 -0
  153. package/dist/application/policies/assert-artifact-owner-allowed.d.ts.map +1 -0
  154. package/dist/application/policies/assert-artifact-owner-allowed.js +8 -0
  155. package/dist/application/policies/assert-artifact-owner-allowed.js.map +1 -0
  156. package/dist/application/policies/assert-v2-planning-profile.d.ts +3 -0
  157. package/dist/application/policies/assert-v2-planning-profile.d.ts.map +1 -0
  158. package/dist/application/policies/assert-v2-planning-profile.js +7 -0
  159. package/dist/application/policies/assert-v2-planning-profile.js.map +1 -0
  160. package/dist/application/policies/authoring-profile-semantics.d.ts +42 -0
  161. package/dist/application/policies/authoring-profile-semantics.d.ts.map +1 -0
  162. package/dist/application/policies/authoring-profile-semantics.js +129 -0
  163. package/dist/application/policies/authoring-profile-semantics.js.map +1 -0
  164. package/dist/application/policies/classify-document-recovery.d.ts +81 -0
  165. package/dist/application/policies/classify-document-recovery.d.ts.map +1 -0
  166. package/dist/application/policies/classify-document-recovery.js +138 -0
  167. package/dist/application/policies/classify-document-recovery.js.map +1 -0
  168. package/dist/application/policies/document-authoring-semantic-digests.d.ts +31 -0
  169. package/dist/application/policies/document-authoring-semantic-digests.d.ts.map +1 -0
  170. package/dist/application/policies/document-authoring-semantic-digests.js +163 -0
  171. package/dist/application/policies/document-authoring-semantic-digests.js.map +1 -0
  172. package/dist/application/policies/document-catalog-authority-stability.d.ts +12 -0
  173. package/dist/application/policies/document-catalog-authority-stability.d.ts.map +1 -0
  174. package/dist/application/policies/document-catalog-authority-stability.js +16 -0
  175. package/dist/application/policies/document-catalog-authority-stability.js.map +1 -0
  176. package/dist/application/policies/document-catalog-diagnostics.d.ts +8 -0
  177. package/dist/application/policies/document-catalog-diagnostics.d.ts.map +1 -0
  178. package/dist/application/policies/document-catalog-diagnostics.js +44 -0
  179. package/dist/application/policies/document-catalog-diagnostics.js.map +1 -0
  180. package/dist/application/policies/document-catalog-fields.d.ts +18 -0
  181. package/dist/application/policies/document-catalog-fields.d.ts.map +1 -0
  182. package/dist/application/policies/document-catalog-fields.js +62 -0
  183. package/dist/application/policies/document-catalog-fields.js.map +1 -0
  184. package/dist/application/policies/document-catalog-sidecar.d.ts +10 -0
  185. package/dist/application/policies/document-catalog-sidecar.d.ts.map +1 -0
  186. package/dist/application/policies/document-catalog-sidecar.js +66 -0
  187. package/dist/application/policies/document-catalog-sidecar.js.map +1 -0
  188. package/dist/application/policies/document-command-consumer-root.d.ts +2 -0
  189. package/dist/application/policies/document-command-consumer-root.d.ts.map +1 -0
  190. package/dist/application/policies/document-command-consumer-root.js +15 -0
  191. package/dist/application/policies/document-command-consumer-root.js.map +1 -0
  192. package/dist/application/policies/document-command-projection.d.ts +20 -0
  193. package/dist/application/policies/document-command-projection.d.ts.map +1 -0
  194. package/dist/application/policies/document-command-projection.js +90 -0
  195. package/dist/application/policies/document-command-projection.js.map +1 -0
  196. package/dist/application/policies/document-contract-digests.d.ts +20 -0
  197. package/dist/application/policies/document-contract-digests.d.ts.map +1 -0
  198. package/dist/application/policies/document-contract-digests.js +329 -0
  199. package/dist/application/policies/document-contract-digests.js.map +1 -0
  200. package/dist/application/policies/document-logical-preimage.d.ts +14 -0
  201. package/dist/application/policies/document-logical-preimage.d.ts.map +1 -0
  202. package/dist/application/policies/document-logical-preimage.js +61 -0
  203. package/dist/application/policies/document-logical-preimage.js.map +1 -0
  204. package/dist/application/policies/document-planning-policy-error.d.ts +6 -0
  205. package/dist/application/policies/document-planning-policy-error.d.ts.map +1 -0
  206. package/dist/application/policies/document-planning-policy-error.js +9 -0
  207. package/dist/application/policies/document-planning-policy-error.js.map +1 -0
  208. package/dist/application/policies/document-receipt-policy.d.ts +5 -0
  209. package/dist/application/policies/document-receipt-policy.d.ts.map +1 -0
  210. package/dist/application/policies/document-receipt-policy.js +92 -0
  211. package/dist/application/policies/document-receipt-policy.js.map +1 -0
  212. package/dist/application/policies/document-repository-path.d.ts +3 -0
  213. package/dist/application/policies/document-repository-path.d.ts.map +1 -0
  214. package/dist/application/policies/document-repository-path.js +24 -0
  215. package/dist/application/policies/document-repository-path.js.map +1 -0
  216. package/dist/application/policies/document-temporary-path.d.ts +7 -0
  217. package/dist/application/policies/document-temporary-path.d.ts.map +1 -0
  218. package/dist/application/policies/document-temporary-path.js +34 -0
  219. package/dist/application/policies/document-temporary-path.js.map +1 -0
  220. package/dist/application/policies/document-transaction-digests.d.ts +5 -0
  221. package/dist/application/policies/document-transaction-digests.d.ts.map +1 -0
  222. package/dist/application/policies/document-transaction-digests.js +12 -0
  223. package/dist/application/policies/document-transaction-digests.js.map +1 -0
  224. package/dist/application/policies/document-transaction-envelope-body.d.ts +28 -0
  225. package/dist/application/policies/document-transaction-envelope-body.d.ts.map +1 -0
  226. package/dist/application/policies/document-transaction-envelope-body.js +140 -0
  227. package/dist/application/policies/document-transaction-envelope-body.js.map +1 -0
  228. package/dist/application/policies/document-transaction-envelope-policy.d.ts +4 -0
  229. package/dist/application/policies/document-transaction-envelope-policy.d.ts.map +1 -0
  230. package/dist/application/policies/document-transaction-envelope-policy.js +159 -0
  231. package/dist/application/policies/document-transaction-envelope-policy.js.map +1 -0
  232. package/dist/application/policies/inspect-catalog-document.d.ts +18 -0
  233. package/dist/application/policies/inspect-catalog-document.d.ts.map +1 -0
  234. package/dist/application/policies/inspect-catalog-document.js +126 -0
  235. package/dist/application/policies/inspect-catalog-document.js.map +1 -0
  236. package/dist/application/policies/normalize-document-intent.d.ts +3 -0
  237. package/dist/application/policies/normalize-document-intent.d.ts.map +1 -0
  238. package/dist/application/policies/normalize-document-intent.js +104 -0
  239. package/dist/application/policies/normalize-document-intent.js.map +1 -0
  240. package/dist/application/policies/project-catalog-metadata.d.ts +7 -0
  241. package/dist/application/policies/project-catalog-metadata.d.ts.map +1 -0
  242. package/dist/application/policies/project-catalog-metadata.js +165 -0
  243. package/dist/application/policies/project-catalog-metadata.js.map +1 -0
  244. package/dist/application/policies/project-document-reachability.d.ts +14 -0
  245. package/dist/application/policies/project-document-reachability.d.ts.map +1 -0
  246. package/dist/application/policies/project-document-reachability.js +57 -0
  247. package/dist/application/policies/project-document-reachability.js.map +1 -0
  248. package/dist/application/policies/project-similar-document-advice.d.ts +4 -0
  249. package/dist/application/policies/project-similar-document-advice.d.ts.map +1 -0
  250. package/dist/application/policies/project-similar-document-advice.js +17 -0
  251. package/dist/application/policies/project-similar-document-advice.js.map +1 -0
  252. package/dist/application/policies/resolve-document-authoring.d.ts +13 -0
  253. package/dist/application/policies/resolve-document-authoring.d.ts.map +1 -0
  254. package/dist/application/policies/resolve-document-authoring.js +154 -0
  255. package/dist/application/policies/resolve-document-authoring.js.map +1 -0
  256. package/dist/application/policies/same-document-catalog-snapshot.d.ts +3 -0
  257. package/dist/application/policies/same-document-catalog-snapshot.d.ts.map +1 -0
  258. package/dist/application/policies/same-document-catalog-snapshot.js +24 -0
  259. package/dist/application/policies/same-document-catalog-snapshot.js.map +1 -0
  260. package/dist/application/ports/authoring-profile-reader.d.ts +37 -0
  261. package/dist/application/ports/authoring-profile-reader.d.ts.map +1 -0
  262. package/dist/application/ports/authoring-profile-reader.js +2 -0
  263. package/dist/application/ports/authoring-profile-reader.js.map +1 -0
  264. package/dist/application/ports/canonical-document-renderer.d.ts +29 -0
  265. package/dist/application/ports/canonical-document-renderer.d.ts.map +1 -0
  266. package/dist/application/ports/canonical-document-renderer.js +2 -0
  267. package/dist/application/ports/canonical-document-renderer.js.map +1 -0
  268. package/dist/application/ports/document-authority-recompiler.d.ts +19 -0
  269. package/dist/application/ports/document-authority-recompiler.d.ts.map +1 -0
  270. package/dist/application/ports/document-authority-recompiler.js +2 -0
  271. package/dist/application/ports/document-authority-recompiler.js.map +1 -0
  272. package/dist/application/ports/document-contract-validator.d.ts +6 -0
  273. package/dist/application/ports/document-contract-validator.d.ts.map +1 -0
  274. package/dist/application/ports/document-contract-validator.js +2 -0
  275. package/dist/application/ports/document-contract-validator.js.map +1 -0
  276. package/dist/application/ports/document-environment-inspector.d.ts +12 -0
  277. package/dist/application/ports/document-environment-inspector.d.ts.map +1 -0
  278. package/dist/application/ports/document-environment-inspector.js +2 -0
  279. package/dist/application/ports/document-environment-inspector.js.map +1 -0
  280. package/dist/application/ports/document-file-state.d.ts +55 -0
  281. package/dist/application/ports/document-file-state.d.ts.map +1 -0
  282. package/dist/application/ports/document-file-state.js +2 -0
  283. package/dist/application/ports/document-file-state.js.map +1 -0
  284. package/dist/application/ports/document-journal-store.d.ts +31 -0
  285. package/dist/application/ports/document-journal-store.d.ts.map +1 -0
  286. package/dist/application/ports/document-journal-store.js +2 -0
  287. package/dist/application/ports/document-journal-store.js.map +1 -0
  288. package/dist/application/ports/document-metadata-sidecar-reader.d.ts +13 -0
  289. package/dist/application/ports/document-metadata-sidecar-reader.d.ts.map +1 -0
  290. package/dist/application/ports/document-metadata-sidecar-reader.js +2 -0
  291. package/dist/application/ports/document-metadata-sidecar-reader.js.map +1 -0
  292. package/dist/application/ports/document-parent-materializer.d.ts +24 -0
  293. package/dist/application/ports/document-parent-materializer.d.ts.map +1 -0
  294. package/dist/application/ports/document-parent-materializer.js +2 -0
  295. package/dist/application/ports/document-parent-materializer.js.map +1 -0
  296. package/dist/application/ports/document-planning-profile-reader.d.ts +9 -0
  297. package/dist/application/ports/document-planning-profile-reader.d.ts.map +1 -0
  298. package/dist/application/ports/document-planning-profile-reader.js +2 -0
  299. package/dist/application/ports/document-planning-profile-reader.js.map +1 -0
  300. package/dist/application/ports/document-planning-state-reader.d.ts +10 -0
  301. package/dist/application/ports/document-planning-state-reader.d.ts.map +1 -0
  302. package/dist/application/ports/document-planning-state-reader.js +2 -0
  303. package/dist/application/ports/document-planning-state-reader.js.map +1 -0
  304. package/dist/application/ports/document-publisher.d.ts +38 -0
  305. package/dist/application/ports/document-publisher.d.ts.map +1 -0
  306. package/dist/application/ports/document-publisher.js +2 -0
  307. package/dist/application/ports/document-publisher.js.map +1 -0
  308. package/dist/application/ports/document-reachability-projector.d.ts +13 -0
  309. package/dist/application/ports/document-reachability-projector.d.ts.map +1 -0
  310. package/dist/application/ports/document-reachability-projector.js +2 -0
  311. package/dist/application/ports/document-reachability-projector.js.map +1 -0
  312. package/dist/application/ports/document-structure-verifier.d.ts +17 -0
  313. package/dist/application/ports/document-structure-verifier.d.ts.map +1 -0
  314. package/dist/application/ports/document-structure-verifier.js +2 -0
  315. package/dist/application/ports/document-structure-verifier.js.map +1 -0
  316. package/dist/application/ports/document-template-reader.d.ts +9 -0
  317. package/dist/application/ports/document-template-reader.d.ts.map +1 -0
  318. package/dist/application/ports/document-template-reader.js +2 -0
  319. package/dist/application/ports/document-template-reader.js.map +1 -0
  320. package/dist/application/ports/document-transaction-coordinator.d.ts +21 -0
  321. package/dist/application/ports/document-transaction-coordinator.d.ts.map +1 -0
  322. package/dist/application/ports/document-transaction-coordinator.js +2 -0
  323. package/dist/application/ports/document-transaction-coordinator.js.map +1 -0
  324. package/dist/application/ports/documentation-catalog-reader-v2.d.ts +11 -0
  325. package/dist/application/ports/documentation-catalog-reader-v2.d.ts.map +1 -0
  326. package/dist/application/ports/documentation-catalog-reader-v2.js +2 -0
  327. package/dist/application/ports/documentation-catalog-reader-v2.js.map +1 -0
  328. package/dist/application/ports/documentation-catalog-reader.d.ts +11 -0
  329. package/dist/application/ports/documentation-catalog-reader.d.ts.map +1 -0
  330. package/dist/application/ports/documentation-catalog-reader.js +2 -0
  331. package/dist/application/ports/documentation-catalog-reader.js.map +1 -0
  332. package/dist/application/ports/documentation-search-catalog-reader-v2.d.ts +9 -0
  333. package/dist/application/ports/documentation-search-catalog-reader-v2.d.ts.map +1 -0
  334. package/dist/application/ports/documentation-search-catalog-reader-v2.js +2 -0
  335. package/dist/application/ports/documentation-search-catalog-reader-v2.js.map +1 -0
  336. package/dist/application/ports/documentation-search-catalog-reader.d.ts +10 -0
  337. package/dist/application/ports/documentation-search-catalog-reader.d.ts.map +1 -0
  338. package/dist/application/ports/documentation-search-catalog-reader.js +2 -0
  339. package/dist/application/ports/documentation-search-catalog-reader.js.map +1 -0
  340. package/dist/application/ports/metadata-instance-validator.d.ts +18 -0
  341. package/dist/application/ports/metadata-instance-validator.d.ts.map +1 -0
  342. package/dist/application/ports/metadata-instance-validator.js +2 -0
  343. package/dist/application/ports/metadata-instance-validator.js.map +1 -0
  344. package/dist/application/ports/owner-membership-reader.d.ts +14 -0
  345. package/dist/application/ports/owner-membership-reader.d.ts.map +1 -0
  346. package/dist/application/ports/owner-membership-reader.js +2 -0
  347. package/dist/application/ports/owner-membership-reader.js.map +1 -0
  348. package/dist/application/ports/similar-document-advisor.d.ts +17 -0
  349. package/dist/application/ports/similar-document-advisor.d.ts.map +1 -0
  350. package/dist/application/ports/similar-document-advisor.js +2 -0
  351. package/dist/application/ports/similar-document-advisor.js.map +1 -0
  352. package/dist/application/projections/document-catalog-projections.d.ts +3 -0
  353. package/dist/application/projections/document-catalog-projections.d.ts.map +1 -0
  354. package/dist/application/projections/document-catalog-projections.js +24 -0
  355. package/dist/application/projections/document-catalog-projections.js.map +1 -0
  356. package/dist/application/use-cases/apply-document-plan.d.ts +16 -0
  357. package/dist/application/use-cases/apply-document-plan.d.ts.map +1 -0
  358. package/dist/application/use-cases/apply-document-plan.js +311 -0
  359. package/dist/application/use-cases/apply-document-plan.js.map +1 -0
  360. package/dist/application/use-cases/apply-document-recovery-receipt.d.ts +14 -0
  361. package/dist/application/use-cases/apply-document-recovery-receipt.d.ts.map +1 -0
  362. package/dist/application/use-cases/apply-document-recovery-receipt.js +17 -0
  363. package/dist/application/use-cases/apply-document-recovery-receipt.js.map +1 -0
  364. package/dist/application/use-cases/build-documentation-catalog.d.ts +41 -0
  365. package/dist/application/use-cases/build-documentation-catalog.d.ts.map +1 -0
  366. package/dist/application/use-cases/build-documentation-catalog.js +259 -0
  367. package/dist/application/use-cases/build-documentation-catalog.js.map +1 -0
  368. package/dist/application/use-cases/compile-document-plan.d.ts +6 -0
  369. package/dist/application/use-cases/compile-document-plan.d.ts.map +1 -0
  370. package/dist/application/use-cases/compile-document-plan.js +200 -0
  371. package/dist/application/use-cases/compile-document-plan.js.map +1 -0
  372. package/dist/application/use-cases/document-journal-reconciliation.d.ts +18 -0
  373. package/dist/application/use-cases/document-journal-reconciliation.d.ts.map +1 -0
  374. package/dist/application/use-cases/document-journal-reconciliation.js +90 -0
  375. package/dist/application/use-cases/document-journal-reconciliation.js.map +1 -0
  376. package/dist/application/use-cases/document-parent-materialization-continuation.d.ts +3 -0
  377. package/dist/application/use-cases/document-parent-materialization-continuation.d.ts.map +1 -0
  378. package/dist/application/use-cases/document-parent-materialization-continuation.js +79 -0
  379. package/dist/application/use-cases/document-parent-materialization-continuation.js.map +1 -0
  380. package/dist/application/use-cases/document-transaction-continuation.d.ts +64 -0
  381. package/dist/application/use-cases/document-transaction-continuation.d.ts.map +1 -0
  382. package/dist/application/use-cases/document-transaction-continuation.js +283 -0
  383. package/dist/application/use-cases/document-transaction-continuation.js.map +1 -0
  384. package/dist/application/use-cases/document-transaction-error.d.ts +5 -0
  385. package/dist/application/use-cases/document-transaction-error.d.ts.map +1 -0
  386. package/dist/application/use-cases/document-transaction-error.js +9 -0
  387. package/dist/application/use-cases/document-transaction-error.js.map +1 -0
  388. package/dist/application/use-cases/document-transaction-execution.d.ts +9 -0
  389. package/dist/application/use-cases/document-transaction-execution.d.ts.map +1 -0
  390. package/dist/application/use-cases/document-transaction-execution.js +40 -0
  391. package/dist/application/use-cases/document-transaction-execution.js.map +1 -0
  392. package/dist/application/use-cases/document-transaction-receipts.d.ts +21 -0
  393. package/dist/application/use-cases/document-transaction-receipts.d.ts.map +1 -0
  394. package/dist/application/use-cases/document-transaction-receipts.js +180 -0
  395. package/dist/application/use-cases/document-transaction-receipts.js.map +1 -0
  396. package/dist/application/use-cases/find-documents.d.ts +20 -0
  397. package/dist/application/use-cases/find-documents.d.ts.map +1 -0
  398. package/dist/application/use-cases/find-documents.js +114 -0
  399. package/dist/application/use-cases/find-documents.js.map +1 -0
  400. package/dist/application/use-cases/load-v2-profile-description.d.ts +20 -0
  401. package/dist/application/use-cases/load-v2-profile-description.d.ts.map +1 -0
  402. package/dist/application/use-cases/load-v2-profile-description.js +14 -0
  403. package/dist/application/use-cases/load-v2-profile-description.js.map +1 -0
  404. package/dist/application/use-cases/plan-documentation-document.d.ts +74 -0
  405. package/dist/application/use-cases/plan-documentation-document.d.ts.map +1 -0
  406. package/dist/application/use-cases/plan-documentation-document.js +273 -0
  407. package/dist/application/use-cases/plan-documentation-document.js.map +1 -0
  408. package/dist/application/use-cases/recapture-directory-receipt-evidence.d.ts +8 -0
  409. package/dist/application/use-cases/recapture-directory-receipt-evidence.d.ts.map +1 -0
  410. package/dist/application/use-cases/recapture-directory-receipt-evidence.js +32 -0
  411. package/dist/application/use-cases/recapture-directory-receipt-evidence.js.map +1 -0
  412. package/dist/application/use-cases/recover-document-transaction.d.ts +10 -0
  413. package/dist/application/use-cases/recover-document-transaction.d.ts.map +1 -0
  414. package/dist/application/use-cases/recover-document-transaction.js +361 -0
  415. package/dist/application/use-cases/recover-document-transaction.js.map +1 -0
  416. package/dist/application/use-cases/run-document-doctor.d.ts +18 -0
  417. package/dist/application/use-cases/run-document-doctor.d.ts.map +1 -0
  418. package/dist/application/use-cases/run-document-doctor.js +171 -0
  419. package/dist/application/use-cases/run-document-doctor.js.map +1 -0
  420. package/dist/application/use-cases/run-document-new.d.ts +30 -0
  421. package/dist/application/use-cases/run-document-new.d.ts.map +1 -0
  422. package/dist/application/use-cases/run-document-new.js +221 -0
  423. package/dist/application/use-cases/run-document-new.js.map +1 -0
  424. package/dist/application/use-cases/run-document-recover.d.ts +21 -0
  425. package/dist/application/use-cases/run-document-recover.d.ts.map +1 -0
  426. package/dist/application/use-cases/run-document-recover.js +126 -0
  427. package/dist/application/use-cases/run-document-recover.js.map +1 -0
  428. package/dist/binary-string-comparator.d.ts +3 -0
  429. package/dist/binary-string-comparator.d.ts.map +1 -0
  430. package/dist/binary-string-comparator.js +12 -0
  431. package/dist/binary-string-comparator.js.map +1 -0
  432. package/dist/cancellation.d.ts +2 -0
  433. package/dist/cancellation.d.ts.map +1 -0
  434. package/dist/cancellation.js +12 -0
  435. package/dist/cancellation.js.map +1 -0
  436. package/dist/canonical-json.d.ts +3 -0
  437. package/dist/canonical-json.d.ts.map +1 -0
  438. package/dist/canonical-json.js +2 -0
  439. package/dist/canonical-json.js.map +1 -0
  440. package/dist/capability-runtime.d.ts +12 -0
  441. package/dist/capability-runtime.d.ts.map +1 -0
  442. package/dist/capability-runtime.js +10 -0
  443. package/dist/capability-runtime.js.map +1 -0
  444. package/dist/composition/describe-document-authoring-profile-v2.d.ts +14 -0
  445. package/dist/composition/describe-document-authoring-profile-v2.d.ts.map +1 -0
  446. package/dist/composition/describe-document-authoring-profile-v2.js +220 -0
  447. package/dist/composition/describe-document-authoring-profile-v2.js.map +1 -0
  448. package/dist/composition/inspect-document-authoring-environment-v1.d.ts +7 -0
  449. package/dist/composition/inspect-document-authoring-environment-v1.d.ts.map +1 -0
  450. package/dist/composition/inspect-document-authoring-environment-v1.js +10 -0
  451. package/dist/composition/inspect-document-authoring-environment-v1.js.map +1 -0
  452. package/dist/composition/inspect-document-transaction.d.ts +4 -0
  453. package/dist/composition/inspect-document-transaction.d.ts.map +1 -0
  454. package/dist/composition/inspect-document-transaction.js +179 -0
  455. package/dist/composition/inspect-document-transaction.js.map +1 -0
  456. package/dist/composition/node-document-authority-recompiler.d.ts +11 -0
  457. package/dist/composition/node-document-authority-recompiler.d.ts.map +1 -0
  458. package/dist/composition/node-document-authority-recompiler.js +81 -0
  459. package/dist/composition/node-document-authority-recompiler.js.map +1 -0
  460. package/dist/composition/node-document-planning.d.ts +7 -0
  461. package/dist/composition/node-document-planning.d.ts.map +1 -0
  462. package/dist/composition/node-document-planning.js +99 -0
  463. package/dist/composition/node-document-planning.js.map +1 -0
  464. package/dist/composition/node-document-writing-private.d.ts +15 -0
  465. package/dist/composition/node-document-writing-private.d.ts.map +1 -0
  466. package/dist/composition/node-document-writing-private.js +54 -0
  467. package/dist/composition/node-document-writing-private.js.map +1 -0
  468. package/dist/composition/node-document-writing.d.ts +8 -0
  469. package/dist/composition/node-document-writing.d.ts.map +1 -0
  470. package/dist/composition/node-document-writing.js +10 -0
  471. package/dist/composition/node-document-writing.js.map +1 -0
  472. package/dist/document-catalog-error.d.ts +6 -0
  473. package/dist/document-catalog-error.d.ts.map +1 -0
  474. package/dist/document-catalog-error.js +9 -0
  475. package/dist/document-catalog-error.js.map +1 -0
  476. package/dist/document-planning-error.d.ts +6 -0
  477. package/dist/document-planning-error.d.ts.map +1 -0
  478. package/dist/document-planning-error.js +9 -0
  479. package/dist/document-planning-error.js.map +1 -0
  480. package/dist/documentation-observation/adapters/outbound/filesystem/filesystem-markdown-document-reader.d.ts +14 -0
  481. package/dist/documentation-observation/adapters/outbound/filesystem/filesystem-markdown-document-reader.d.ts.map +1 -0
  482. package/dist/documentation-observation/adapters/outbound/filesystem/filesystem-markdown-document-reader.js +108 -0
  483. package/dist/documentation-observation/adapters/outbound/filesystem/filesystem-markdown-document-reader.js.map +1 -0
  484. package/dist/documentation-observation/adapters/outbound/filesystem/filesystem-markdown-filesystem.d.ts +14 -0
  485. package/dist/documentation-observation/adapters/outbound/filesystem/filesystem-markdown-filesystem.d.ts.map +1 -0
  486. package/dist/documentation-observation/adapters/outbound/filesystem/filesystem-markdown-filesystem.js +61 -0
  487. package/dist/documentation-observation/adapters/outbound/filesystem/filesystem-markdown-filesystem.js.map +1 -0
  488. package/dist/documentation-observation/adapters/outbound/filesystem/filesystem-markdown-paths.d.ts +8 -0
  489. package/dist/documentation-observation/adapters/outbound/filesystem/filesystem-markdown-paths.d.ts.map +1 -0
  490. package/dist/documentation-observation/adapters/outbound/filesystem/filesystem-markdown-paths.js +44 -0
  491. package/dist/documentation-observation/adapters/outbound/filesystem/filesystem-markdown-paths.js.map +1 -0
  492. package/dist/documentation-observation/adapters/outbound/filesystem/filesystem-markdown-reference-resolver.d.ts +6 -0
  493. package/dist/documentation-observation/adapters/outbound/filesystem/filesystem-markdown-reference-resolver.d.ts.map +1 -0
  494. package/dist/documentation-observation/adapters/outbound/filesystem/filesystem-markdown-reference-resolver.js +160 -0
  495. package/dist/documentation-observation/adapters/outbound/filesystem/filesystem-markdown-reference-resolver.js.map +1 -0
  496. package/dist/documentation-observation/adapters/outbound/filesystem/filesystem-markdown-repository.d.ts +8 -0
  497. package/dist/documentation-observation/adapters/outbound/filesystem/filesystem-markdown-repository.d.ts.map +1 -0
  498. package/dist/documentation-observation/adapters/outbound/filesystem/filesystem-markdown-repository.js +13 -0
  499. package/dist/documentation-observation/adapters/outbound/filesystem/filesystem-markdown-repository.js.map +1 -0
  500. package/dist/documentation-observation/adapters/outbound/filesystem/filesystem-markdown-tree-observer.d.ts +6 -0
  501. package/dist/documentation-observation/adapters/outbound/filesystem/filesystem-markdown-tree-observer.d.ts.map +1 -0
  502. package/dist/documentation-observation/adapters/outbound/filesystem/filesystem-markdown-tree-observer.js +260 -0
  503. package/dist/documentation-observation/adapters/outbound/filesystem/filesystem-markdown-tree-observer.js.map +1 -0
  504. package/dist/documentation-observation/adapters/outbound/filesystem/markdown-document-parser.d.ts +3 -0
  505. package/dist/documentation-observation/adapters/outbound/filesystem/markdown-document-parser.d.ts.map +1 -0
  506. package/dist/documentation-observation/adapters/outbound/filesystem/markdown-document-parser.js +260 -0
  507. package/dist/documentation-observation/adapters/outbound/filesystem/markdown-document-parser.js.map +1 -0
  508. package/dist/documentation-observation/adapters/outbound/filesystem/markdown-reference-target.d.ts +15 -0
  509. package/dist/documentation-observation/adapters/outbound/filesystem/markdown-reference-target.d.ts.map +1 -0
  510. package/dist/documentation-observation/adapters/outbound/filesystem/markdown-reference-target.js +59 -0
  511. package/dist/documentation-observation/adapters/outbound/filesystem/markdown-reference-target.js.map +1 -0
  512. package/dist/documentation-observation/application/model/markdown-document.d.ts +69 -0
  513. package/dist/documentation-observation/application/model/markdown-document.d.ts.map +1 -0
  514. package/dist/documentation-observation/application/model/markdown-document.js +10 -0
  515. package/dist/documentation-observation/application/model/markdown-document.js.map +1 -0
  516. package/dist/documentation-observation/application/ports/markdown-repository.d.ts +18 -0
  517. package/dist/documentation-observation/application/ports/markdown-repository.d.ts.map +1 -0
  518. package/dist/documentation-observation/application/ports/markdown-repository.js +2 -0
  519. package/dist/documentation-observation/application/ports/markdown-repository.js.map +1 -0
  520. package/dist/errors.d.ts +6 -0
  521. package/dist/errors.d.ts.map +1 -0
  522. package/dist/errors.js +9 -0
  523. package/dist/errors.js.map +1 -0
  524. package/dist/filesystem-path-safety.d.ts +11 -0
  525. package/dist/filesystem-path-safety.d.ts.map +1 -0
  526. package/dist/filesystem-path-safety.js +122 -0
  527. package/dist/filesystem-path-safety.js.map +1 -0
  528. package/dist/find-command.d.ts +28 -0
  529. package/dist/find-command.d.ts.map +1 -0
  530. package/dist/find-command.js +146 -0
  531. package/dist/find-command.js.map +1 -0
  532. package/dist/index.d.ts +64 -0
  533. package/dist/index.d.ts.map +1 -0
  534. package/dist/index.js +95 -0
  535. package/dist/index.js.map +1 -0
  536. package/dist/installed-artifact-identity.d.ts +2 -0
  537. package/dist/installed-artifact-identity.d.ts.map +1 -0
  538. package/dist/installed-artifact-identity.js +13 -0
  539. package/dist/installed-artifact-identity.js.map +1 -0
  540. package/dist/observation.d.ts +4 -0
  541. package/dist/observation.d.ts.map +1 -0
  542. package/dist/observation.js +3 -0
  543. package/dist/observation.js.map +1 -0
  544. package/dist/package-version.d.ts +2 -0
  545. package/dist/package-version.d.ts.map +1 -0
  546. package/dist/package-version.js +10 -0
  547. package/dist/package-version.js.map +1 -0
  548. package/dist/qualification/index.d.ts +27 -0
  549. package/dist/qualification/index.d.ts.map +1 -0
  550. package/dist/qualification/index.js +144 -0
  551. package/dist/qualification/index.js.map +1 -0
  552. package/dist/schema-catalog.d.ts +4 -0
  553. package/dist/schema-catalog.d.ts.map +1 -0
  554. package/dist/schema-catalog.js +70 -0
  555. package/dist/schema-catalog.js.map +1 -0
  556. package/dist/state-contract.d.ts +3 -0
  557. package/dist/state-contract.d.ts.map +1 -0
  558. package/dist/state-contract.js +4 -0
  559. package/dist/state-contract.js.map +1 -0
  560. package/dist/strict-json.d.ts +2 -0
  561. package/dist/strict-json.d.ts.map +1 -0
  562. package/dist/strict-json.js +2 -0
  563. package/dist/strict-json.js.map +1 -0
  564. package/dist/strict-yaml.d.ts +3 -0
  565. package/dist/strict-yaml.d.ts.map +1 -0
  566. package/dist/strict-yaml.js +37 -0
  567. package/dist/strict-yaml.js.map +1 -0
  568. package/package.json +66 -0
  569. package/schemas/document-authoring-profile/v1.schema.json +265 -0
  570. package/schemas/document-authoring-profile/v2.schema.json +168 -0
  571. package/schemas/document-authoring-profile/v3.schema.json +200 -0
  572. package/schemas/document-command-envelope/v1.schema.json +161 -0
  573. package/schemas/document-command-envelope/v2.schema.json +205 -0
  574. package/schemas/document-intent/v1.schema.json +102 -0
  575. package/schemas/document-parent-materialization/v2.schema.json +65 -0
  576. package/schemas/document-plan/v1.schema.json +162 -0
  577. package/schemas/document-plan/v2.schema.json +85 -0
  578. package/schemas/document-receipt/v1.schema.json +141 -0
  579. package/schemas/document-receipt/v2.schema.json +108 -0
  580. package/schemas/foundation-transaction-envelope/v3.schema.json +169 -0
  581. package/schemas/foundation-transaction-envelope/v4.schema.json +164 -0
@@ -0,0 +1,269 @@
1
+ import { lstat, mkdir, readdir, realpath } from "node:fs/promises";
2
+ import { join } from "node:path";
3
+ import { createAndBindNodeDirectory, syncDirectoryStrictly } from "@agent-teams/repository-mutation/node";
4
+ import { assertNonzeroDocumentPhysicalIdentity } from "../../application/model/document-physical-identity.js";
5
+ import { isDocumentRepositoryPath } from "../../application/policies/document-repository-path.js";
6
+ import { captureNodeRepositoryDirectoryAuthority, captureNodeRepositoryPathAuthority, captureNodeRepositoryRootAuthority, sameNodePathAncestry, sameNodePathIdentity } from "./node-path-authority.js";
7
+ const nodeOperations = {
8
+ lstat: (path) => lstat(path, { bigint: true }),
9
+ async mkdir(path, options) {
10
+ await mkdir(path, options);
11
+ },
12
+ readdir,
13
+ realpath,
14
+ syncDirectory: syncDirectoryStrictly
15
+ };
16
+ function isMissing(error) {
17
+ return error instanceof Error && "code" in error &&
18
+ ["ENOENT", "ENOTDIR"].includes(error.code ?? "");
19
+ }
20
+ function documentIdentity(identity) {
21
+ const result = {
22
+ adapter: "node-filesystem",
23
+ version: 1,
24
+ birthtimeNs: identity.birthtimeNs.toString(10),
25
+ dev: identity.dev.toString(10),
26
+ ino: identity.ino.toString(10)
27
+ };
28
+ assertNonzeroDocumentPhysicalIdentity(result);
29
+ return Object.freeze(result);
30
+ }
31
+ function portableIdentity(identity) {
32
+ assertNonzeroDocumentPhysicalIdentity(identity);
33
+ return {
34
+ birthtimeNs: BigInt(identity.birthtimeNs),
35
+ dev: BigInt(identity.dev),
36
+ ino: BigInt(identity.ino)
37
+ };
38
+ }
39
+ function assertClosedPlan(plan) {
40
+ if (plan.policy !==
41
+ "create-missing-real-directories" ||
42
+ (plan.deepestExistingDirectory !== "." &&
43
+ !isDocumentRepositoryPath(plan.deepestExistingDirectory)) ||
44
+ (plan.finalParent !== "." && !isDocumentRepositoryPath(plan.finalParent))) {
45
+ throw new TypeError("Document parent materialization Plan is invalid.");
46
+ }
47
+ const expected = [];
48
+ let current = plan.deepestExistingDirectory;
49
+ const anchorSegments = current === "." ? [] : current.split("/");
50
+ const finalSegments = plan.finalParent === "." ? [] : plan.finalParent.split("/");
51
+ if (anchorSegments.length > finalSegments.length ||
52
+ anchorSegments.some((segment, index) => segment !== finalSegments[index])) {
53
+ throw new TypeError("Materialization anchor is not an ancestor of the final parent.");
54
+ }
55
+ for (const segment of finalSegments.slice(anchorSegments.length)) {
56
+ current = current === "." ? segment : `${current}/${segment}`;
57
+ expected.push(current);
58
+ }
59
+ if (expected.length !== plan.missingDirectories.length ||
60
+ expected.some((path, index) => path !== plan.missingDirectories[index])) {
61
+ throw new TypeError("Materialization missing directories are not one exact parent chain.");
62
+ }
63
+ }
64
+ export async function planDocumentParentMaterializationV2(request) {
65
+ request.signal?.throwIfAborted();
66
+ if (!isDocumentRepositoryPath(request.destination)) {
67
+ throw new TypeError("Document destination is not a portable repository path.");
68
+ }
69
+ await captureNodeRepositoryRootAuthority(request.consumerRoot, nodeOperations);
70
+ const parentSegments = request.destination.split("/").slice(0, -1);
71
+ let deepestExistingDirectory = ".";
72
+ let firstMissing = parentSegments.length;
73
+ for (let index = 0; index < parentSegments.length; index += 1) {
74
+ request.signal?.throwIfAborted();
75
+ const repositoryPath = parentSegments.slice(0, index + 1).join("/");
76
+ try {
77
+ await captureNodeRepositoryDirectoryAuthority({
78
+ consumerRoot: request.consumerRoot,
79
+ operations: nodeOperations,
80
+ repositoryPath
81
+ });
82
+ }
83
+ catch (error) {
84
+ if (isMissing(error)) {
85
+ firstMissing = index;
86
+ break;
87
+ }
88
+ throw error;
89
+ }
90
+ deepestExistingDirectory = repositoryPath;
91
+ }
92
+ const missingDirectories = Object.freeze(parentSegments.slice(firstMissing).map((_segment, offset) => parentSegments.slice(0, firstMissing + offset + 1).join("/")));
93
+ const finalParent = parentSegments.length === 0 ? "." : parentSegments.join("/");
94
+ const plan = Object.freeze({
95
+ deepestExistingDirectory,
96
+ finalParent,
97
+ missingDirectories,
98
+ policy: "create-missing-real-directories"
99
+ });
100
+ assertClosedPlan(plan);
101
+ return plan;
102
+ }
103
+ export class NodeDocumentParentMaterializerV2 {
104
+ #operations;
105
+ constructor(overrides = {}) {
106
+ this.#operations = { ...nodeOperations, ...overrides };
107
+ }
108
+ async begin(request) {
109
+ assertClosedPlan(request.plan);
110
+ const anchor = await captureNodeRepositoryDirectoryAuthority({
111
+ consumerRoot: request.consumerRoot,
112
+ operations: this.#operations,
113
+ repositoryPath: request.plan.deepestExistingDirectory
114
+ });
115
+ return Object.freeze({
116
+ anchorIdentity: documentIdentity(anchor.directoryIdentity),
117
+ createdDirectories: Object.freeze([]),
118
+ plan: request.plan,
119
+ schemaVersion: 2
120
+ });
121
+ }
122
+ async inspect(request) {
123
+ const { journal } = request;
124
+ assertClosedPlan(journal.plan);
125
+ assertNonzeroDocumentPhysicalIdentity(journal.anchorIdentity);
126
+ if (journal.createdDirectories.length > journal.plan.missingDirectories.length ||
127
+ journal.createdDirectories.some((entry, index) => entry.path !== journal.plan.missingDirectories[index])) {
128
+ throw new TypeError("Created directory evidence must be an exact Plan prefix.");
129
+ }
130
+ const createdByPath = new Map(journal.createdDirectories.map((entry) => [entry.path, entry]));
131
+ let anchor;
132
+ try {
133
+ anchor = await captureNodeRepositoryDirectoryAuthority({
134
+ consumerRoot: request.consumerRoot,
135
+ operations: this.#operations,
136
+ repositoryPath: journal.plan.deepestExistingDirectory
137
+ });
138
+ }
139
+ catch {
140
+ return { path: journal.plan.deepestExistingDirectory, reason: "anchor-changed", state: "manual-recovery-required" };
141
+ }
142
+ if (!sameNodePathIdentity(anchor.directoryIdentity, portableIdentity(journal.anchorIdentity))) {
143
+ return { path: journal.plan.deepestExistingDirectory, reason: "anchor-changed", state: "manual-recovery-required" };
144
+ }
145
+ for (const path of journal.plan.missingDirectories) {
146
+ const expected = createdByPath.get(path);
147
+ let captured;
148
+ try {
149
+ captured = await captureNodeRepositoryDirectoryAuthority({
150
+ consumerRoot: request.consumerRoot,
151
+ operations: this.#operations,
152
+ repositoryPath: path
153
+ });
154
+ }
155
+ catch (error) {
156
+ if (isMissing(error)) {
157
+ if (expected !== undefined) {
158
+ return { path, reason: "created-directory-changed", state: "manual-recovery-required" };
159
+ }
160
+ return { nextDirectory: path, state: "current" };
161
+ }
162
+ if (expected !== undefined) {
163
+ return { path, reason: "created-directory-changed", state: "manual-recovery-required" };
164
+ }
165
+ return {
166
+ path,
167
+ reason: error instanceof Error &&
168
+ /portable name collision/u.test(error.message)
169
+ ? "portable-name-collision"
170
+ : "unbound-directory-exists",
171
+ state: "manual-recovery-required"
172
+ };
173
+ }
174
+ if (expected === undefined) {
175
+ return { path, reason: "unbound-directory-exists", state: "manual-recovery-required" };
176
+ }
177
+ if (!sameNodePathIdentity(captured.directoryIdentity, portableIdentity(expected.identity))) {
178
+ return { path, reason: "created-directory-changed", state: "manual-recovery-required" };
179
+ }
180
+ }
181
+ return { state: "current" };
182
+ }
183
+ async createNext(request) {
184
+ request.signal?.throwIfAborted();
185
+ const inspection = await this.inspect(request);
186
+ if (inspection.state !== "current") {
187
+ throw new Error(`Document parent materialization requires manual recovery: ${inspection.reason}.`);
188
+ }
189
+ if (inspection.nextDirectory === undefined) {
190
+ return undefined;
191
+ }
192
+ const path = inspection.nextDirectory;
193
+ const targetAuthority = await captureNodeRepositoryPathAuthority({
194
+ consumerRoot: request.consumerRoot,
195
+ operations: this.#operations,
196
+ repositoryPath: path
197
+ });
198
+ const basename = path.split("/").at(-1);
199
+ request.signal?.throwIfAborted();
200
+ const absolute = join(targetAuthority.parent, basename);
201
+ await this.#operations.mkdir(absolute, { mode: 0o755 });
202
+ const firstObservedAfterMkdir = await this.#operations.lstat(absolute);
203
+ // No cancellation observation after mkdir: the returned identity must be
204
+ // durably journaled by the caller before another directory is created.
205
+ const createdIdentity = portableIdentity(documentIdentity(firstObservedAfterMkdir));
206
+ const captured = await captureNodeRepositoryDirectoryAuthority({
207
+ consumerRoot: request.consumerRoot,
208
+ operations: this.#operations,
209
+ repositoryPath: path
210
+ });
211
+ if (!sameNodePathIdentity(createdIdentity, captured.directoryIdentity) ||
212
+ !sameNodePathAncestry(targetAuthority.ancestry, captured.ancestry.slice(0, -1))) {
213
+ throw new Error("Created document directory changed before its identity could be bound. Manual recovery is required.");
214
+ }
215
+ await this.#operations.syncDirectory(targetAuthority.parent);
216
+ const finalCapture = await captureNodeRepositoryDirectoryAuthority({
217
+ consumerRoot: request.consumerRoot,
218
+ operations: this.#operations,
219
+ repositoryPath: path
220
+ });
221
+ if (!sameNodePathIdentity(createdIdentity, finalCapture.directoryIdentity) ||
222
+ !sameNodePathAncestry(captured.ancestry, finalCapture.ancestry)) {
223
+ throw new Error("Created document directory changed before its durable identity binding. Manual recovery is required.");
224
+ }
225
+ return Object.freeze({ path, identity: documentIdentity(createdIdentity) });
226
+ }
227
+ async createAndBindOne(request) {
228
+ const operations = this.#operations;
229
+ await createAndBindNodeDirectory({
230
+ ambiguousError: (error) => new Error(`Document directory creation is ambiguous and requires manual recovery: ${request.path}.`, { cause: error }),
231
+ bind: request.bindCreatedDirectory,
232
+ async captureParent() {
233
+ const target = await captureNodeRepositoryPathAuthority({
234
+ consumerRoot: request.consumerRoot,
235
+ operations,
236
+ repositoryPath: request.path
237
+ });
238
+ if (!sameNodePathIdentity(target.parentIdentity, portableIdentity(request.expectedParentIdentity))) {
239
+ throw new Error("Document materialization parent identity changed.");
240
+ }
241
+ return target;
242
+ },
243
+ async createAndObserve(target, markCreated) {
244
+ await operations.mkdir(target.destinationPath, { mode: 0o755 });
245
+ markCreated();
246
+ return portableIdentity(documentIdentity(await operations.lstat(target.destinationPath)));
247
+ },
248
+ async recapture(target, observed) {
249
+ const captured = await captureNodeRepositoryDirectoryAuthority({
250
+ consumerRoot: request.consumerRoot,
251
+ operations,
252
+ repositoryPath: request.path
253
+ });
254
+ if (!sameNodePathIdentity(observed, captured.directoryIdentity) ||
255
+ !sameNodePathAncestry(target.ancestry, captured.ancestry.slice(0, -1))) {
256
+ throw new Error("Created directory or its ancestry changed before binding.");
257
+ }
258
+ return Object.freeze({
259
+ identity: documentIdentity(captured.directoryIdentity),
260
+ path: request.path
261
+ });
262
+ },
263
+ async syncParent(target) {
264
+ await operations.syncDirectory(target.parent);
265
+ }
266
+ });
267
+ }
268
+ }
269
+ //# sourceMappingURL=node-document-parent-materializer.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"node-document-parent-materializer.js","sourceRoot":"","sources":["../../../src/adapters/node/node-document-parent-materializer.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,10 @@
1
+ import type { DocumentPlanningProfileSnapshot } from "../../application/model/document-planning.js";
2
+ import type { DocumentPlanningProfileReader } from "../../application/ports/document-planning-profile-reader.js";
3
+ export declare class NodeDocumentPlanningProfileReader implements DocumentPlanningProfileReader {
4
+ read(request: {
5
+ readonly consumerRoot: string;
6
+ readonly path: string;
7
+ readonly signal?: AbortSignal;
8
+ }): Promise<DocumentPlanningProfileSnapshot>;
9
+ }
10
+ //# sourceMappingURL=node-document-planning-profile-reader.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"node-document-planning-profile-reader.d.ts","sourceRoot":"","sources":["../../../src/adapters/node/node-document-planning-profile-reader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAKV,+BAA+B,EAChC,MAAM,8CAA8C,CAAC;AACtD,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,6DAA6D,CAAC;AAyEjH,qBAAa,iCACb,YAAW,6BAA6B;IAChC,IAAI,CAAC,OAAO,EAAE;QAClB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;KAC/B,GAAG,OAAO,CAAC,+BAA+B,CAAC,CAwC3C;CACF"}
@@ -0,0 +1,85 @@
1
+ import { DocumentCatalogError } from "../../document-catalog-error.js";
2
+ import { DocumentPlanningError } from "../../document-planning-error.js";
3
+ import { InvalidDocumentAuthoringProfileError } from "./load-validated-document-authoring-profile.js";
4
+ import { loadValidatedDocumentAuthoringProfileV2, resolvedArtifactOwnerIds, resolvedProfileMetadataSidecar } from "./load-validated-document-authoring-profile-v2.js";
5
+ function freezeIdentity(identity) {
6
+ return identity.format === "qualified"
7
+ ? Object.freeze({
8
+ ...identity,
9
+ grammar: Object.freeze({
10
+ ...identity.grammar,
11
+ prefixSegments: Object.freeze([...identity.grammar.prefixSegments])
12
+ })
13
+ })
14
+ : Object.freeze({ ...identity });
15
+ }
16
+ function freezePlacement(placement) {
17
+ return placement.kind === "explicit"
18
+ ? Object.freeze({
19
+ ...placement,
20
+ allowedRoots: Object.freeze([...placement.allowedRoots]),
21
+ requiredSegmentsInOrder: Object.freeze([
22
+ ...placement.requiredSegmentsInOrder
23
+ ])
24
+ })
25
+ : Object.freeze({ ...placement });
26
+ }
27
+ function freezeArtifactType(artifactType, profile) {
28
+ const allowedOwnerIds = resolvedArtifactOwnerIds(profile, artifactType);
29
+ return Object.freeze({
30
+ ...artifactType,
31
+ ...(allowedOwnerIds === undefined
32
+ ? {}
33
+ : { allowedOwnerIds: Object.freeze([...allowedOwnerIds]) }),
34
+ heading: Object.freeze({ ...artifactType.heading }),
35
+ identity: freezeIdentity(artifactType.identity),
36
+ placement: freezePlacement(artifactType.placement),
37
+ reachability: Object.freeze({
38
+ ...(artifactType.reachability ?? { kind: "not-required" })
39
+ }),
40
+ template: Object.freeze({ ...artifactType.template })
41
+ });
42
+ }
43
+ function freezeCollection(collection) {
44
+ return collection.kind === "frontmatter-readme"
45
+ ? Object.freeze({ ...collection, roots: Object.freeze([...collection.roots]) })
46
+ : Object.freeze({ ...collection });
47
+ }
48
+ function invalidProfile(error) {
49
+ throw new DocumentPlanningError("DOCUMENT_PLANNING_INPUT_INVALID", `Document authoring profile is invalid: ${error.message}`, { cause: error });
50
+ }
51
+ export class NodeDocumentPlanningProfileReader {
52
+ async read(request) {
53
+ try {
54
+ const { evidence, profile } = await loadValidatedDocumentAuthoringProfileV2(request);
55
+ const metadataSidecar = resolvedProfileMetadataSidecar(profile);
56
+ return Object.freeze({
57
+ artifactTypes: Object.freeze(profile.authoring.artifactTypes.map((artifactType) => freezeArtifactType(artifactType, profile))),
58
+ collections: Object.freeze(profile.catalog.collections.map(freezeCollection)),
59
+ evidence,
60
+ excludedPrefixes: Object.freeze([
61
+ ...(profile.catalog.excludedPrefixes ?? [])
62
+ ]),
63
+ metadataSchemaPath: profile.catalog.metadataSchemaPath,
64
+ ...(metadataSidecar === undefined
65
+ ? {}
66
+ : { metadataSidecar: Object.freeze({ ...metadataSidecar }) }),
67
+ ownerCatalog: Object.freeze({ ...profile.catalog.ownerCatalog }),
68
+ projectId: profile.projectId,
69
+ schemaVersion: profile.schemaVersion
70
+ });
71
+ }
72
+ catch (error) {
73
+ if (error instanceof InvalidDocumentAuthoringProfileError) {
74
+ invalidProfile(error);
75
+ }
76
+ if (error instanceof DocumentCatalogError) {
77
+ throw new DocumentPlanningError(error.code === "DOCUMENT_CATALOG_INPUT_INVALID"
78
+ ? "DOCUMENT_PLANNING_INPUT_INVALID"
79
+ : "DOCUMENT_PLANNING_AUTHORITY_UNAVAILABLE", `Document authoring profile cannot be loaded: ${error.message}`, { cause: error });
80
+ }
81
+ throw error;
82
+ }
83
+ }
84
+ }
85
+ //# sourceMappingURL=node-document-planning-profile-reader.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"node-document-planning-profile-reader.js","sourceRoot":"","sources":["../../../src/adapters/node/node-document-planning-profile-reader.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,11 @@
1
+ import type { DocumentPlanningStateSnapshot } from "../../application/model/document-planning.js";
2
+ import type { DocumentPlanningStateReader } from "../../application/ports/document-planning-state-reader.js";
3
+ export declare class NodeDocumentPlanningStateReader implements DocumentPlanningStateReader {
4
+ observe(request: {
5
+ readonly consumerRoot: string;
6
+ readonly destination: string;
7
+ readonly parentPolicy?: "create-missing-real-directories";
8
+ readonly signal?: AbortSignal;
9
+ }): Promise<DocumentPlanningStateSnapshot>;
10
+ }
11
+ //# sourceMappingURL=node-document-planning-state-reader.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"node-document-planning-state-reader.d.ts","sourceRoot":"","sources":["../../../src/adapters/node/node-document-planning-state-reader.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,8CAA8C,CAAC;AAClG,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,2DAA2D,CAAC;AA+I7G,qBAAa,+BACb,YAAW,2BAA2B;IAC9B,OAAO,CAAC,OAAO,EAAE;QACrB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,YAAY,CAAC,EAAE,iCAAiC,CAAC;QAC1D,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;KAC/B,GAAG,OAAO,CAAC,6BAA6B,CAAC,CA2EzC;CACF"}
@@ -0,0 +1,181 @@
1
+ import { lstat, readdir, realpath } from "node:fs/promises";
2
+ import { isAbsolute, join, relative, resolve, sep } from "node:path";
3
+ import { assertNotCancelled } from "../../cancellation.js";
4
+ import { ContainedFileReadError, readContainedRegularFile } from "../../filesystem-path-safety.js";
5
+ import { documentRepositoryParentPath, isDocumentRepositoryPath } from "../../application/policies/document-repository-path.js";
6
+ import { DocumentPlanningError } from "../../document-planning-error.js";
7
+ import { planDocumentParentMaterializationV2 } from "./node-document-parent-materializer.js";
8
+ const MAX_EXISTING_DESTINATION_BYTES = 1024 * 1024;
9
+ function hasCode(error, code) {
10
+ return error instanceof Error && "code" in error &&
11
+ error.code === code;
12
+ }
13
+ function isMissing(error) {
14
+ return hasCode(error, "ENOENT") || hasCode(error, "ENOTDIR");
15
+ }
16
+ function contained(root, candidate) {
17
+ const relation = relative(root, candidate);
18
+ return relation === "" ||
19
+ (!isAbsolute(relation) && relation !== ".." && !relation.startsWith(`..${sep}`));
20
+ }
21
+ function portableNameIdentity(name) {
22
+ return name.normalize("NFC").replace(/[A-Z]/gu, (character) => character.toLowerCase());
23
+ }
24
+ async function hasPortableNameCollision(parent, requestedName) {
25
+ const requestedIdentity = portableNameIdentity(requestedName);
26
+ const entries = await readdir(parent);
27
+ return entries.some((entry) => entry !== requestedName && portableNameIdentity(entry) === requestedIdentity);
28
+ }
29
+ function parentUnavailable(message, cause) {
30
+ throw new DocumentPlanningError("DOCUMENT_PLANNING_PARENT_UNAVAILABLE", message, cause === undefined ? undefined : { cause });
31
+ }
32
+ function observationUnavailable(message, cause) {
33
+ throw new DocumentPlanningError("DOCUMENT_PLANNING_AUTHORITY_UNAVAILABLE", message, cause === undefined ? undefined : { cause });
34
+ }
35
+ async function observeRegularDestination(input) {
36
+ try {
37
+ const bytes = await readContainedRegularFile({
38
+ candidate: input.candidate,
39
+ maxBytes: MAX_EXISTING_DESTINATION_BYTES,
40
+ root: input.root
41
+ });
42
+ return Object.freeze({
43
+ bytes: new Uint8Array(bytes),
44
+ state: "regular-file"
45
+ });
46
+ }
47
+ catch (error) {
48
+ if (error instanceof ContainedFileReadError &&
49
+ (error.failure === "invalid" || error.failure === "symlink")) {
50
+ return Object.freeze({ kind: "special-file", state: "conflict" });
51
+ }
52
+ if (error instanceof ContainedFileReadError) {
53
+ observationUnavailable(`Document destination changed or became unavailable: ${input.destination}.`, error);
54
+ }
55
+ throw error;
56
+ }
57
+ }
58
+ async function observeRealParent(input) {
59
+ const lexicalRoot = resolve(input.consumerRoot);
60
+ let root;
61
+ try {
62
+ const rootMetadata = await lstat(lexicalRoot);
63
+ if (rootMetadata.isSymbolicLink() || !rootMetadata.isDirectory()) {
64
+ parentUnavailable("Document repository root must be a real directory.");
65
+ }
66
+ root = await realpath(lexicalRoot);
67
+ }
68
+ catch (error) {
69
+ if (error instanceof DocumentPlanningError) {
70
+ throw error;
71
+ }
72
+ parentUnavailable("Document repository root is unavailable.", error);
73
+ }
74
+ let current = root;
75
+ const parentSegments = input.destination.split("/").slice(0, -1);
76
+ for (const segment of parentSegments) {
77
+ assertNotCancelled(input.signal);
78
+ try {
79
+ if (await hasPortableNameCollision(current, segment)) {
80
+ parentUnavailable(`Document destination parent has a portable name collision: ${segment}.`);
81
+ }
82
+ const next = join(current, segment);
83
+ const metadata = await lstat(next);
84
+ if (metadata.isSymbolicLink() || !metadata.isDirectory()) {
85
+ parentUnavailable(`Document destination parent ancestry must contain only real directories: ${segment}.`);
86
+ }
87
+ const canonical = await realpath(next);
88
+ if (!contained(root, canonical)) {
89
+ parentUnavailable("Document destination parent escapes the repository.");
90
+ }
91
+ current = canonical;
92
+ }
93
+ catch (error) {
94
+ if (error instanceof DocumentPlanningError) {
95
+ throw error;
96
+ }
97
+ if (isMissing(error)) {
98
+ parentUnavailable("Document destination parent must already exist.", error);
99
+ }
100
+ parentUnavailable("Document destination parent cannot be observed safely.", error);
101
+ }
102
+ }
103
+ return { parent: current, root };
104
+ }
105
+ export class NodeDocumentPlanningStateReader {
106
+ async observe(request) {
107
+ assertNotCancelled(request.signal);
108
+ if (!isDocumentRepositoryPath(request.destination)) {
109
+ throw new DocumentPlanningError("DOCUMENT_PLANNING_INPUT_INVALID", "Document destination must use the portable repository-relative path grammar.");
110
+ }
111
+ const parentMaterialization = request.parentPolicy === undefined
112
+ ? undefined
113
+ : await planDocumentParentMaterializationV2(request);
114
+ if (parentMaterialization !== undefined &&
115
+ parentMaterialization.missingDirectories.length > 0) {
116
+ return Object.freeze({
117
+ destination: Object.freeze({ state: "absent" }),
118
+ expectedParent: Object.freeze({
119
+ ancestry: "real-directories",
120
+ path: documentRepositoryParentPath(request.destination),
121
+ state: "directory"
122
+ }),
123
+ parentMaterialization
124
+ });
125
+ }
126
+ const { parent, root } = await observeRealParent(request);
127
+ assertNotCancelled(request.signal);
128
+ const basename = request.destination.split("/").at(-1) ?? "";
129
+ let destination;
130
+ try {
131
+ if (await hasPortableNameCollision(parent, basename)) {
132
+ destination = Object.freeze({
133
+ kind: "portable-name-collision",
134
+ state: "conflict"
135
+ });
136
+ }
137
+ else {
138
+ const candidate = join(parent, basename);
139
+ const metadata = await lstat(candidate).catch((error) => {
140
+ if (isMissing(error)) {
141
+ return null;
142
+ }
143
+ throw error;
144
+ });
145
+ if (metadata === null) {
146
+ destination = Object.freeze({ state: "absent" });
147
+ }
148
+ else if (metadata.isSymbolicLink() || !metadata.isFile()) {
149
+ destination = Object.freeze({
150
+ kind: metadata.isDirectory() ? "directory" : "special-file",
151
+ state: "conflict"
152
+ });
153
+ }
154
+ else {
155
+ destination = await observeRegularDestination({
156
+ candidate,
157
+ destination: request.destination,
158
+ root
159
+ });
160
+ }
161
+ }
162
+ }
163
+ catch (error) {
164
+ if (error instanceof DocumentPlanningError) {
165
+ throw error;
166
+ }
167
+ observationUnavailable(`Document destination cannot be observed safely: ${request.destination}.`, error);
168
+ }
169
+ assertNotCancelled(request.signal);
170
+ return Object.freeze({
171
+ destination,
172
+ expectedParent: Object.freeze({
173
+ ancestry: "real-directories",
174
+ path: documentRepositoryParentPath(request.destination),
175
+ state: "directory"
176
+ }),
177
+ ...(parentMaterialization === undefined ? {} : { parentMaterialization })
178
+ });
179
+ }
180
+ }
181
+ //# sourceMappingURL=node-document-planning-state-reader.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"node-document-planning-state-reader.js","sourceRoot":"","sources":["../../../src/adapters/node/node-document-planning-state-reader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAErE,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACzB,MAAM,iCAAiC,CAAC;AAGzC,OAAO,EACL,4BAA4B,EAC5B,wBAAwB,EACzB,MAAM,wDAAwD,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,EAAE,mCAAmC,EAAE,MAAM,wCAAwC,CAAC;AAE7F,MAAM,8BAA8B,GAAG,IAAI,GAAG,IAAI,CAAC;AAEnD,SAAS,OAAO,CAAC,KAAc,EAAE,IAAY;IAC3C,OAAO,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK;QAC7C,KAA+B,CAAC,IAAI,KAAK,IAAI,CAAC;AACnD,CAAC;AAED,SAAS,SAAS,CAAC,KAAc;IAC/B,OAAO,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,OAAO,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;AAC/D,CAAC;AAED,SAAS,SAAS,CAAC,IAAY,EAAE,SAAiB;IAChD,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAC3C,OAAO,QAAQ,KAAK,EAAE;QACpB,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,QAAQ,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC,CAAC;AACrF,CAAC;AAED,SAAS,oBAAoB,CAAC,IAAY;IACxC,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,SAAS,EAAE,EAAE,CAC5D,SAAS,CAAC,WAAW,EAAE,CAAC,CAAC;AAC7B,CAAC;AAED,KAAK,UAAU,wBAAwB,CACrC,MAAc,EACd,aAAqB;IAErB,MAAM,iBAAiB,GAAG,oBAAoB,CAAC,aAAa,CAAC,CAAC;IAC9D,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IACtC,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAC5B,KAAK,KAAK,aAAa,IAAI,oBAAoB,CAAC,KAAK,CAAC,KAAK,iBAAiB,CAC7E,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,OAAe,EAAE,KAAe;IACzD,MAAM,IAAI,qBAAqB,CAC7B,sCAAsC,EACtC,OAAO,EACP,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAC5C,CAAC;AACJ,CAAC;AAED,SAAS,sBAAsB,CAAC,OAAe,EAAE,KAAe;IAC9D,MAAM,IAAI,qBAAqB,CAC7B,yCAAyC,EACzC,OAAO,EACP,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAC5C,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,yBAAyB,CAAC,KAIxC;IACC,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,wBAAwB,CAAC;YAC3C,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,QAAQ,EAAE,8BAA8B;YACxC,IAAI,EAAE,KAAK,CAAC,IAAI;SACjB,CAAC,CAAC;QACH,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,KAAK,EAAE,IAAI,UAAU,CAAC,KAAK,CAAC;YAC5B,KAAK,EAAE,cAAc;SACtB,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IACE,KAAK,YAAY,sBAAsB;YACvC,CAAC,KAAK,CAAC,OAAO,KAAK,SAAS,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS,CAAC,EAC5D,CAAC;YACD,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;QACpE,CAAC;QACD,IAAI,KAAK,YAAY,sBAAsB,EAAE,CAAC;YAC5C,sBAAsB,CACpB,uDAAuD,KAAK,CAAC,WAAW,GAAG,EAC3E,KAAK,CACN,CAAC;QACJ,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,KAAK,UAAU,iBAAiB,CAAC,KAIhC;IACC,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IAChD,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACH,MAAM,YAAY,GAAG,MAAM,KAAK,CAAC,WAAW,CAAC,CAAC;QAC9C,IAAI,YAAY,CAAC,cAAc,EAAE,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE,EAAE,CAAC;YACjE,iBAAiB,CAAC,oDAAoD,CAAC,CAAC;QAC1E,CAAC;QACD,IAAI,GAAG,MAAM,QAAQ,CAAC,WAAW,CAAC,CAAC;IACrC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,qBAAqB,EAAE,CAAC;YAC3C,MAAM,KAAK,CAAC;QACd,CAAC;QACD,iBAAiB,CAAC,0CAA0C,EAAE,KAAK,CAAC,CAAC;IACvE,CAAC;IACD,IAAI,OAAO,GAAG,IAAI,CAAC;IACnB,MAAM,cAAc,GAAG,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACjE,KAAK,MAAM,OAAO,IAAI,cAAc,EAAE,CAAC;QACrC,kBAAkB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACjC,IAAI,CAAC;YACH,IAAI,MAAM,wBAAwB,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC;gBACrD,iBAAiB,CACf,8DAA8D,OAAO,GAAG,CACzE,CAAC;YACJ,CAAC;YACD,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YACpC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;YACnC,IAAI,QAAQ,CAAC,cAAc,EAAE,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,EAAE,CAAC;gBACzD,iBAAiB,CACf,4EAA4E,OAAO,GAAG,CACvF,CAAC;YACJ,CAAC;YACD,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC;YACvC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,CAAC;gBAChC,iBAAiB,CAAC,qDAAqD,CAAC,CAAC;YAC3E,CAAC;YACD,OAAO,GAAG,SAAS,CAAC;QACtB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,qBAAqB,EAAE,CAAC;gBAC3C,MAAM,KAAK,CAAC;YACd,CAAC;YACD,IAAI,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;gBACrB,iBAAiB,CAAC,iDAAiD,EAAE,KAAK,CAAC,CAAC;YAC9E,CAAC;YACD,iBAAiB,CAAC,wDAAwD,EAAE,KAAK,CAAC,CAAC;QACrF,CAAC;IACH,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AACnC,CAAC;AAED,MAAM,OAAO,+BAA+B;IAE1C,KAAK,CAAC,OAAO,CAAC,OAKb;QACC,kBAAkB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACnC,IAAI,CAAC,wBAAwB,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;YACnD,MAAM,IAAI,qBAAqB,CAC7B,iCAAiC,EACjC,8EAA8E,CAC/E,CAAC;QACJ,CAAC;QACD,MAAM,qBAAqB,GAAG,OAAO,CAAC,YAAY,KAAK,SAAS;YAC9D,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,MAAM,mCAAmC,CAAC,OAAO,CAAC,CAAC;QACvD,IAAI,qBAAqB,KAAK,SAAS;YACrC,qBAAqB,CAAC,kBAAkB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtD,OAAO,MAAM,CAAC,MAAM,CAAC;gBACnB,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,QAAiB,EAAE,CAAC;gBACxD,cAAc,EAAE,MAAM,CAAC,MAAM,CAAC;oBAC5B,QAAQ,EAAE,kBAA2B;oBACrC,IAAI,EAAE,4BAA4B,CAAC,OAAO,CAAC,WAAW,CAAC;oBACvD,KAAK,EAAE,WAAoB;iBAC5B,CAAC;gBACF,qBAAqB;aACtB,CAAC,CAAC;QACL,CAAC;QACD,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,iBAAiB,CAAC,OAAO,CAAC,CAAC;QAC1D,kBAAkB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACnC,MAAM,QAAQ,GAAG,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC7D,IAAI,WAAyD,CAAC;QAC9D,IAAI,CAAC;YACH,IAAI,MAAM,wBAAwB,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC;gBACrD,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC;oBAC1B,IAAI,EAAE,yBAAyB;oBAC/B,KAAK,EAAE,UAAU;iBAClB,CAAC,CAAC;YACL,CAAC;iBAAM,CAAC;gBACN,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;gBACzC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;oBAC/D,IAAI,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;wBACrB,OAAO,IAAI,CAAC;oBACd,CAAC;oBACD,MAAM,KAAK,CAAC;gBACd,CAAC,CAAC,CAAC;gBACH,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;oBACtB,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;gBACnD,CAAC;qBAAM,IAAI,QAAQ,CAAC,cAAc,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;oBAC3D,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC;wBAC1B,IAAI,EAAE,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,cAAc;wBAC3D,KAAK,EAAE,UAAU;qBAClB,CAAC,CAAC;gBACL,CAAC;qBAAM,CAAC;oBACN,WAAW,GAAG,MAAM,yBAAyB,CAAC;wBAC5C,SAAS;wBACT,WAAW,EAAE,OAAO,CAAC,WAAW;wBAChC,IAAI;qBACL,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,qBAAqB,EAAE,CAAC;gBAC3C,MAAM,KAAK,CAAC;YACd,CAAC;YACD,sBAAsB,CACpB,mDAAmD,OAAO,CAAC,WAAW,GAAG,EACzE,KAAK,CACN,CAAC;QACJ,CAAC;QACD,kBAAkB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACnC,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,WAAW;YACX,cAAc,EAAE,MAAM,CAAC,MAAM,CAAC;gBAC5B,QAAQ,EAAE,kBAAkB;gBAC5B,IAAI,EAAE,4BAA4B,CAAC,OAAO,CAAC,WAAW,CAAC;gBACvD,KAAK,EAAE,WAAW;aACnB,CAAC;YACF,GAAG,CAAC,qBAAqB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,qBAAqB,EAAE,CAAC;SAC1E,CAAC,CAAC;IACL,CAAC;CACF"}
@@ -0,0 +1,2 @@
1
+ export { NodeDocumentPublisher } from "./node-document-publisher.js";
2
+ //# sourceMappingURL=node-document-publisher-private.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"node-document-publisher-private.d.ts","sourceRoot":"","sources":["../../../src/adapters/node/node-document-publisher-private.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACtB,MAAM,8BAA8B,CAAC"}
@@ -0,0 +1,2 @@
1
+ export { NodeDocumentPublisher } from "./node-document-publisher.js";
2
+ //# sourceMappingURL=node-document-publisher-private.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"node-document-publisher-private.js","sourceRoot":"","sources":["../../../src/adapters/node/node-document-publisher-private.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACtB,MAAM,8BAA8B,CAAC"}