@tiangong-lca/foundry 0.1.2

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 (323) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +532 -0
  3. package/docs/architecture.md +450 -0
  4. package/docs/foundry-task-contracts.md +147 -0
  5. package/docs/import-profiles/bafu/constraints.md +343 -0
  6. package/docs/import-profiles/bafu/leaf-process-classification-authoring.md +153 -0
  7. package/docs/import-profiles/bafu/profile.md +183 -0
  8. package/docs/import-profiles/uslci/constraints.md +29 -0
  9. package/docs/import-profiles/uslci/profile.md +43 -0
  10. package/docs/import-profiles/worldsteel/constraints.md +77 -0
  11. package/docs/import-profiles/worldsteel/import-coverage.md +93 -0
  12. package/docs/import-profiles/worldsteel/import-plan.md +375 -0
  13. package/docs/import-profiles/worldsteel/profile.md +78 -0
  14. package/docs/package-distribution-contract.md +287 -0
  15. package/docs/public-runtime-contract.md +218 -0
  16. package/docs/runtime-context-contract.md +138 -0
  17. package/docs/safety-policy.md +164 -0
  18. package/docs/task-authorization-contract.md +131 -0
  19. package/docs/uslci-import-runbook.md +336 -0
  20. package/docs/workspace-migration-contract.md +127 -0
  21. package/package-dist/assets/foundry-package-descriptor.json +1661 -0
  22. package/package-dist/scripts/foundry-facade.d.ts +78 -0
  23. package/package-dist/scripts/foundry-facade.js +1317 -0
  24. package/package-dist/scripts/foundry-runtime.d.ts +180 -0
  25. package/package-dist/scripts/foundry-runtime.js +190 -0
  26. package/package-dist/scripts/lib/batch-orchestration/scope-attempt-ledger.d.ts +27 -0
  27. package/package-dist/scripts/lib/batch-orchestration/scope-attempt-ledger.js +85 -0
  28. package/package-dist/scripts/lib/batch-orchestration/scope-resume-contract.d.ts +38 -0
  29. package/package-dist/scripts/lib/batch-orchestration/scope-resume-contract.js +90 -0
  30. package/package-dist/scripts/lib/bundle-row-types.d.ts +44 -0
  31. package/package-dist/scripts/lib/bundle-row-types.js +46 -0
  32. package/package-dist/scripts/lib/bundle-sample-utils.d.ts +183 -0
  33. package/package-dist/scripts/lib/bundle-sample-utils.js +526 -0
  34. package/package-dist/scripts/lib/bundle-source-context.d.ts +31 -0
  35. package/package-dist/scripts/lib/bundle-source-context.js +142 -0
  36. package/package-dist/scripts/lib/canonical-description.d.ts +12 -0
  37. package/package-dist/scripts/lib/canonical-description.js +72 -0
  38. package/package-dist/scripts/lib/canonical-support-rewrites.d.ts +127 -0
  39. package/package-dist/scripts/lib/canonical-support-rewrites.js +527 -0
  40. package/package-dist/scripts/lib/decision-owners/classification.d.ts +245 -0
  41. package/package-dist/scripts/lib/decision-owners/classification.js +754 -0
  42. package/package-dist/scripts/lib/decision-owners/identity-preflight.d.ts +333 -0
  43. package/package-dist/scripts/lib/decision-owners/identity-preflight.js +1353 -0
  44. package/package-dist/scripts/lib/decision-owners/identity-task.d.ts +130 -0
  45. package/package-dist/scripts/lib/decision-owners/identity-task.js +494 -0
  46. package/package-dist/scripts/lib/decision-owners/identity.d.ts +74 -0
  47. package/package-dist/scripts/lib/decision-owners/identity.js +443 -0
  48. package/package-dist/scripts/lib/decision-owners/location.d.ts +239 -0
  49. package/package-dist/scripts/lib/decision-owners/location.js +704 -0
  50. package/package-dist/scripts/lib/decision-task-utils.d.ts +484 -0
  51. package/package-dist/scripts/lib/decision-task-utils.js +735 -0
  52. package/package-dist/scripts/lib/finalize-owners/cli-wrappers.d.ts +52 -0
  53. package/package-dist/scripts/lib/finalize-owners/cli-wrappers.js +146 -0
  54. package/package-dist/scripts/lib/finalize-owners/commit-handoff.d.ts +79 -0
  55. package/package-dist/scripts/lib/finalize-owners/commit-handoff.js +515 -0
  56. package/package-dist/scripts/lib/finalize-owners/post-authoring.d.ts +234 -0
  57. package/package-dist/scripts/lib/finalize-owners/post-authoring.js +1720 -0
  58. package/package-dist/scripts/lib/finalize-owners/post-write-closeout.d.ts +140 -0
  59. package/package-dist/scripts/lib/finalize-owners/post-write-closeout.js +656 -0
  60. package/package-dist/scripts/lib/foundry-args.d.ts +7 -0
  61. package/package-dist/scripts/lib/foundry-args.js +38 -0
  62. package/package-dist/scripts/lib/foundry-authentication-environment.d.ts +17 -0
  63. package/package-dist/scripts/lib/foundry-authentication-environment.js +55 -0
  64. package/package-dist/scripts/lib/foundry-authorization-input.d.ts +31 -0
  65. package/package-dist/scripts/lib/foundry-authorization-input.js +151 -0
  66. package/package-dist/scripts/lib/foundry-command-metadata.d.ts +32 -0
  67. package/package-dist/scripts/lib/foundry-command-metadata.js +1012 -0
  68. package/package-dist/scripts/lib/foundry-command-registry.d.ts +34 -0
  69. package/package-dist/scripts/lib/foundry-command-registry.js +241 -0
  70. package/package-dist/scripts/lib/foundry-command-spec.d.ts +1 -0
  71. package/package-dist/scripts/lib/foundry-command-spec.js +1 -0
  72. package/package-dist/scripts/lib/foundry-decision-owners.d.ts +17 -0
  73. package/package-dist/scripts/lib/foundry-decision-owners.js +68 -0
  74. package/package-dist/scripts/lib/foundry-decision-routing.d.ts +3 -0
  75. package/package-dist/scripts/lib/foundry-decision-routing.js +38 -0
  76. package/package-dist/scripts/lib/foundry-execution-admission.d.ts +33 -0
  77. package/package-dist/scripts/lib/foundry-execution-admission.js +225 -0
  78. package/package-dist/scripts/lib/foundry-execution-attempt.d.ts +11 -0
  79. package/package-dist/scripts/lib/foundry-execution-attempt.js +33 -0
  80. package/package-dist/scripts/lib/foundry-execution-context-format.d.ts +18 -0
  81. package/package-dist/scripts/lib/foundry-execution-context-format.js +83 -0
  82. package/package-dist/scripts/lib/foundry-facade-store.d.ts +25 -0
  83. package/package-dist/scripts/lib/foundry-facade-store.js +449 -0
  84. package/package-dist/scripts/lib/foundry-finalize-owners.d.ts +21 -0
  85. package/package-dist/scripts/lib/foundry-finalize-owners.js +203 -0
  86. package/package-dist/scripts/lib/foundry-identity-owners.d.ts +13 -0
  87. package/package-dist/scripts/lib/foundry-identity-owners.js +58 -0
  88. package/package-dist/scripts/lib/foundry-managed-host.d.ts +7 -0
  89. package/package-dist/scripts/lib/foundry-managed-host.js +173 -0
  90. package/package-dist/scripts/lib/foundry-migration-adoption-plan.d.ts +39 -0
  91. package/package-dist/scripts/lib/foundry-migration-adoption-plan.js +467 -0
  92. package/package-dist/scripts/lib/foundry-migration-adoption.d.ts +31 -0
  93. package/package-dist/scripts/lib/foundry-migration-adoption.js +187 -0
  94. package/package-dist/scripts/lib/foundry-migration-authority.d.ts +42 -0
  95. package/package-dist/scripts/lib/foundry-migration-authority.js +280 -0
  96. package/package-dist/scripts/lib/foundry-migration-inventory.d.ts +31 -0
  97. package/package-dist/scripts/lib/foundry-migration-inventory.js +148 -0
  98. package/package-dist/scripts/lib/foundry-migration-plan.d.ts +48 -0
  99. package/package-dist/scripts/lib/foundry-migration-plan.js +234 -0
  100. package/package-dist/scripts/lib/foundry-migration-replay.d.ts +3 -0
  101. package/package-dist/scripts/lib/foundry-migration-replay.js +134 -0
  102. package/package-dist/scripts/lib/foundry-migration-stage.d.ts +15 -0
  103. package/package-dist/scripts/lib/foundry-migration-stage.js +152 -0
  104. package/package-dist/scripts/lib/foundry-migration-transfer-io.d.ts +13 -0
  105. package/package-dist/scripts/lib/foundry-migration-transfer-io.js +226 -0
  106. package/package-dist/scripts/lib/foundry-migration-transfer.d.ts +36 -0
  107. package/package-dist/scripts/lib/foundry-migration-transfer.js +350 -0
  108. package/package-dist/scripts/lib/foundry-operation-result.d.ts +71 -0
  109. package/package-dist/scripts/lib/foundry-operation-result.js +264 -0
  110. package/package-dist/scripts/lib/foundry-owner-execution-store.d.ts +319 -0
  111. package/package-dist/scripts/lib/foundry-owner-execution-store.js +293 -0
  112. package/package-dist/scripts/lib/foundry-owner-readback.d.ts +22 -0
  113. package/package-dist/scripts/lib/foundry-owner-readback.js +189 -0
  114. package/package-dist/scripts/lib/foundry-owner-trace-acceptance.d.ts +15 -0
  115. package/package-dist/scripts/lib/foundry-owner-trace-acceptance.js +68 -0
  116. package/package-dist/scripts/lib/foundry-package-contract.d.ts +56 -0
  117. package/package-dist/scripts/lib/foundry-package-contract.js +392 -0
  118. package/package-dist/scripts/lib/foundry-private-path.d.ts +2 -0
  119. package/package-dist/scripts/lib/foundry-private-path.js +20 -0
  120. package/package-dist/scripts/lib/foundry-runtime-cache.d.ts +3 -0
  121. package/package-dist/scripts/lib/foundry-runtime-cache.js +25 -0
  122. package/package-dist/scripts/lib/foundry-runtime-command-policy.d.ts +20 -0
  123. package/package-dist/scripts/lib/foundry-runtime-command-policy.js +173 -0
  124. package/package-dist/scripts/lib/foundry-runtime-context-types.d.ts +59 -0
  125. package/package-dist/scripts/lib/foundry-runtime-context-types.js +1 -0
  126. package/package-dist/scripts/lib/foundry-runtime-context.d.ts +27 -0
  127. package/package-dist/scripts/lib/foundry-runtime-context.js +668 -0
  128. package/package-dist/scripts/lib/foundry-runtime-environment.d.ts +9 -0
  129. package/package-dist/scripts/lib/foundry-runtime-environment.js +90 -0
  130. package/package-dist/scripts/lib/foundry-runtime-error.d.ts +4 -0
  131. package/package-dist/scripts/lib/foundry-runtime-error.js +8 -0
  132. package/package-dist/scripts/lib/foundry-runtime-identity.d.ts +18 -0
  133. package/package-dist/scripts/lib/foundry-runtime-identity.js +127 -0
  134. package/package-dist/scripts/lib/foundry-runtime-paths.d.ts +16 -0
  135. package/package-dist/scripts/lib/foundry-runtime-paths.js +159 -0
  136. package/package-dist/scripts/lib/foundry-runtime-qualification.d.ts +66 -0
  137. package/package-dist/scripts/lib/foundry-runtime-qualification.js +223 -0
  138. package/package-dist/scripts/lib/foundry-runtime-selection-record.d.ts +16 -0
  139. package/package-dist/scripts/lib/foundry-runtime-selection-record.js +32 -0
  140. package/package-dist/scripts/lib/foundry-runtime-selection.d.ts +14 -0
  141. package/package-dist/scripts/lib/foundry-runtime-selection.js +123 -0
  142. package/package-dist/scripts/lib/foundry-runtime-utils.d.ts +178 -0
  143. package/package-dist/scripts/lib/foundry-runtime-utils.js +603 -0
  144. package/package-dist/scripts/lib/foundry-semantic-input.d.ts +30 -0
  145. package/package-dist/scripts/lib/foundry-semantic-input.js +132 -0
  146. package/package-dist/scripts/lib/foundry-task-authorization.d.ts +68 -0
  147. package/package-dist/scripts/lib/foundry-task-authorization.js +350 -0
  148. package/package-dist/scripts/lib/foundry-task-io.d.ts +18 -0
  149. package/package-dist/scripts/lib/foundry-task-io.js +92 -0
  150. package/package-dist/scripts/lib/foundry-task-registration.d.ts +6 -0
  151. package/package-dist/scripts/lib/foundry-task-registration.js +384 -0
  152. package/package-dist/scripts/lib/foundry-task-start-spec.d.ts +34 -0
  153. package/package-dist/scripts/lib/foundry-task-start-spec.js +161 -0
  154. package/package-dist/scripts/lib/foundry-task-store.d.ts +18 -0
  155. package/package-dist/scripts/lib/foundry-task-store.js +466 -0
  156. package/package-dist/scripts/lib/foundry-task-types.d.ts +99 -0
  157. package/package-dist/scripts/lib/foundry-task-types.js +1 -0
  158. package/package-dist/scripts/lib/foundry-workflow-approval-continuation.d.ts +6 -0
  159. package/package-dist/scripts/lib/foundry-workflow-approval-continuation.js +136 -0
  160. package/package-dist/scripts/lib/foundry-workflow-assessment.d.ts +3 -0
  161. package/package-dist/scripts/lib/foundry-workflow-assessment.js +231 -0
  162. package/package-dist/scripts/lib/foundry-workflow-authorization.d.ts +22 -0
  163. package/package-dist/scripts/lib/foundry-workflow-authorization.js +174 -0
  164. package/package-dist/scripts/lib/foundry-workflow-context.d.ts +3 -0
  165. package/package-dist/scripts/lib/foundry-workflow-context.js +99 -0
  166. package/package-dist/scripts/lib/foundry-workflow-decisions.d.ts +18 -0
  167. package/package-dist/scripts/lib/foundry-workflow-decisions.js +123 -0
  168. package/package-dist/scripts/lib/foundry-workflow-execution.d.ts +8 -0
  169. package/package-dist/scripts/lib/foundry-workflow-execution.js +248 -0
  170. package/package-dist/scripts/lib/foundry-workflow-finalize.d.ts +13 -0
  171. package/package-dist/scripts/lib/foundry-workflow-finalize.js +264 -0
  172. package/package-dist/scripts/lib/foundry-workflow-identity-apply.d.ts +14 -0
  173. package/package-dist/scripts/lib/foundry-workflow-identity-apply.js +159 -0
  174. package/package-dist/scripts/lib/foundry-workflow-identity.d.ts +6 -0
  175. package/package-dist/scripts/lib/foundry-workflow-identity.js +153 -0
  176. package/package-dist/scripts/lib/foundry-workflow-import.d.ts +4 -0
  177. package/package-dist/scripts/lib/foundry-workflow-import.js +70 -0
  178. package/package-dist/scripts/lib/foundry-workflow-io.d.ts +11 -0
  179. package/package-dist/scripts/lib/foundry-workflow-io.js +77 -0
  180. package/package-dist/scripts/lib/foundry-workflow-reference-verify.d.ts +41 -0
  181. package/package-dist/scripts/lib/foundry-workflow-reference-verify.js +266 -0
  182. package/package-dist/scripts/lib/foundry-workflow-rows.d.ts +2 -0
  183. package/package-dist/scripts/lib/foundry-workflow-rows.js +47 -0
  184. package/package-dist/scripts/lib/foundry-workflow-semantic.d.ts +5 -0
  185. package/package-dist/scripts/lib/foundry-workflow-semantic.js +367 -0
  186. package/package-dist/scripts/lib/foundry-workflow-state.d.ts +37 -0
  187. package/package-dist/scripts/lib/foundry-workflow-state.js +158 -0
  188. package/package-dist/scripts/lib/full-context-proof.d.ts +51 -0
  189. package/package-dist/scripts/lib/full-context-proof.js +932 -0
  190. package/package-dist/scripts/lib/identity-preflight-artifacts.d.ts +184 -0
  191. package/package-dist/scripts/lib/identity-preflight-artifacts.js +573 -0
  192. package/package-dist/scripts/lib/identity-preflight-proof.d.ts +117 -0
  193. package/package-dist/scripts/lib/identity-preflight-proof.js +341 -0
  194. package/package-dist/scripts/lib/identity-reference-rewrite-utils.d.ts +147 -0
  195. package/package-dist/scripts/lib/identity-reference-rewrite-utils.js +817 -0
  196. package/package-dist/scripts/lib/import-curation/authoring-packages.d.ts +28 -0
  197. package/package-dist/scripts/lib/import-curation/authoring-packages.js +92 -0
  198. package/package-dist/scripts/lib/import-curation/curation-cleanup.d.ts +32 -0
  199. package/package-dist/scripts/lib/import-curation/curation-cleanup.js +203 -0
  200. package/package-dist/scripts/lib/import-curation/curation-gate.d.ts +47 -0
  201. package/package-dist/scripts/lib/import-curation/curation-gate.js +528 -0
  202. package/package-dist/scripts/lib/import-curation/internal/artifact-inputs.d.ts +24 -0
  203. package/package-dist/scripts/lib/import-curation/internal/artifact-inputs.js +152 -0
  204. package/package-dist/scripts/lib/import-curation/internal/authoring-patch-workflow.d.ts +3 -0
  205. package/package-dist/scripts/lib/import-curation/internal/authoring-patch-workflow.js +3 -0
  206. package/package-dist/scripts/lib/import-curation/internal/authoring-task-workflow.d.ts +1 -0
  207. package/package-dist/scripts/lib/import-curation/internal/authoring-task-workflow.js +1 -0
  208. package/package-dist/scripts/lib/import-curation/internal/context-inputs.d.ts +56 -0
  209. package/package-dist/scripts/lib/import-curation/internal/context-inputs.js +206 -0
  210. package/package-dist/scripts/lib/import-curation/internal/curation-gate-workflow.d.ts +14 -0
  211. package/package-dist/scripts/lib/import-curation/internal/curation-gate-workflow.js +14 -0
  212. package/package-dist/scripts/lib/import-curation/internal/dataset-payload.d.ts +70 -0
  213. package/package-dist/scripts/lib/import-curation/internal/dataset-payload.js +141 -0
  214. package/package-dist/scripts/lib/import-curation/internal/dataset-types.d.ts +25 -0
  215. package/package-dist/scripts/lib/import-curation/internal/dataset-types.js +45 -0
  216. package/package-dist/scripts/lib/import-curation/internal/full-context-proof.d.ts +129 -0
  217. package/package-dist/scripts/lib/import-curation/internal/full-context-proof.js +552 -0
  218. package/package-dist/scripts/lib/import-curation/internal/hash-utils.d.ts +2 -0
  219. package/package-dist/scripts/lib/import-curation/internal/hash-utils.js +10 -0
  220. package/package-dist/scripts/lib/import-curation/internal/mutation-manifest-workflow.d.ts +15 -0
  221. package/package-dist/scripts/lib/import-curation/internal/mutation-manifest-workflow.js +15 -0
  222. package/package-dist/scripts/lib/import-curation/internal/prewrite-cleanup.d.ts +31 -0
  223. package/package-dist/scripts/lib/import-curation/internal/prewrite-cleanup.js +467 -0
  224. package/package-dist/scripts/lib/import-curation/internal/profiles-config.d.ts +47 -0
  225. package/package-dist/scripts/lib/import-curation/internal/profiles-config.js +88 -0
  226. package/package-dist/scripts/lib/import-curation/internal/runtime-io.d.ts +23 -0
  227. package/package-dist/scripts/lib/import-curation/internal/runtime-io.js +132 -0
  228. package/package-dist/scripts/lib/import-curation/internal/trace-summary.d.ts +53 -0
  229. package/package-dist/scripts/lib/import-curation/internal/trace-summary.js +114 -0
  230. package/package-dist/scripts/lib/import-curation/internal/workflow-authoring-tasks.d.ts +141 -0
  231. package/package-dist/scripts/lib/import-curation/internal/workflow-authoring-tasks.js +854 -0
  232. package/package-dist/scripts/lib/import-curation/internal/workflow-decision-apply-context.d.ts +20 -0
  233. package/package-dist/scripts/lib/import-curation/internal/workflow-decision-apply-context.js +46 -0
  234. package/package-dist/scripts/lib/import-curation/internal/workflow-decision-full-context.d.ts +110 -0
  235. package/package-dist/scripts/lib/import-curation/internal/workflow-decision-full-context.js +782 -0
  236. package/package-dist/scripts/lib/import-curation/internal/workflow-dry-run-context.d.ts +24 -0
  237. package/package-dist/scripts/lib/import-curation/internal/workflow-dry-run-context.js +191 -0
  238. package/package-dist/scripts/lib/import-curation/internal/workflow-evidence-scope.d.ts +80 -0
  239. package/package-dist/scripts/lib/import-curation/internal/workflow-evidence-scope.js +359 -0
  240. package/package-dist/scripts/lib/import-curation/internal/workflow-identity-decision-context.d.ts +146 -0
  241. package/package-dist/scripts/lib/import-curation/internal/workflow-identity-decision-context.js +381 -0
  242. package/package-dist/scripts/lib/import-curation/internal/workflow-identity-preflight.d.ts +223 -0
  243. package/package-dist/scripts/lib/import-curation/internal/workflow-identity-preflight.js +1079 -0
  244. package/package-dist/scripts/lib/import-curation/internal/workflow-patch-collect.d.ts +41 -0
  245. package/package-dist/scripts/lib/import-curation/internal/workflow-patch-collect.js +412 -0
  246. package/package-dist/scripts/lib/import-curation/internal/workflow-patch-evidence-context.d.ts +117 -0
  247. package/package-dist/scripts/lib/import-curation/internal/workflow-patch-evidence-context.js +278 -0
  248. package/package-dist/scripts/lib/import-curation/internal/workflow-patch-evidence.d.ts +59 -0
  249. package/package-dist/scripts/lib/import-curation/internal/workflow-patch-evidence.js +593 -0
  250. package/package-dist/scripts/lib/import-curation/internal/workflow-queue-context.d.ts +58 -0
  251. package/package-dist/scripts/lib/import-curation/internal/workflow-queue-context.js +263 -0
  252. package/package-dist/scripts/lib/import-curation/internal/workflow-reference-closure.d.ts +177 -0
  253. package/package-dist/scripts/lib/import-curation/internal/workflow-reference-closure.js +812 -0
  254. package/package-dist/scripts/lib/import-curation/internal/workflow-row-transform-context.d.ts +159 -0
  255. package/package-dist/scripts/lib/import-curation/internal/workflow-row-transform-context.js +466 -0
  256. package/package-dist/scripts/lib/import-curation/internal/workflow-semantic-actions.d.ts +152 -0
  257. package/package-dist/scripts/lib/import-curation/internal/workflow-semantic-actions.js +1377 -0
  258. package/package-dist/scripts/lib/import-curation/internal/workflow-source-reference-context.d.ts +38 -0
  259. package/package-dist/scripts/lib/import-curation/internal/workflow-source-reference-context.js +116 -0
  260. package/package-dist/scripts/lib/import-curation/mutation-manifest.d.ts +51 -0
  261. package/package-dist/scripts/lib/import-curation/mutation-manifest.js +542 -0
  262. package/package-dist/scripts/lib/import-curation/patch-collect.d.ts +18 -0
  263. package/package-dist/scripts/lib/import-curation/patch-collect.js +172 -0
  264. package/package-dist/scripts/lib/import-curation/profiles.d.ts +1 -0
  265. package/package-dist/scripts/lib/import-curation/profiles.js +1 -0
  266. package/package-dist/scripts/lib/import-curation/trace-summary.d.ts +1 -0
  267. package/package-dist/scripts/lib/import-curation/trace-summary.js +1 -0
  268. package/package-dist/scripts/lib/oauth-session-reference.d.ts +1 -0
  269. package/package-dist/scripts/lib/oauth-session-reference.js +20 -0
  270. package/package-dist/scripts/lib/post-authoring-finalize-utils.d.ts +95 -0
  271. package/package-dist/scripts/lib/post-authoring-finalize-utils.js +548 -0
  272. package/package-dist/scripts/lib/post-write-root-proof.d.ts +44 -0
  273. package/package-dist/scripts/lib/post-write-root-proof.js +169 -0
  274. package/package-dist/scripts/lib/reference-description-text.d.ts +2 -0
  275. package/package-dist/scripts/lib/reference-description-text.js +12 -0
  276. package/package-dist/scripts/lib/remote-verification-accepted-diff.d.ts +42 -0
  277. package/package-dist/scripts/lib/remote-verification-accepted-diff.js +424 -0
  278. package/package-dist/scripts/lib/same-identity-commit-recovery.d.ts +8 -0
  279. package/package-dist/scripts/lib/same-identity-commit-recovery.js +52 -0
  280. package/package-dist/scripts/lib/source-semantics.d.ts +255 -0
  281. package/package-dist/scripts/lib/source-semantics.js +888 -0
  282. package/package-dist/scripts/lib/stage-contract.d.ts +36 -0
  283. package/package-dist/scripts/lib/stage-contract.js +25 -0
  284. package/package-dist/scripts/lib/task-authorization.d.ts +84 -0
  285. package/package-dist/scripts/lib/task-authorization.js +210 -0
  286. package/package-dist/scripts/lib/tidas-adapter.d.ts +113 -0
  287. package/package-dist/scripts/lib/tidas-adapter.js +525 -0
  288. package/package-dist/scripts/lib/tidas-language-utils.d.ts +8 -0
  289. package/package-dist/scripts/lib/tidas-language-utils.js +206 -0
  290. package/package-dist/scripts/lib/tidas-row-utils.d.ts +70 -0
  291. package/package-dist/scripts/lib/tidas-row-utils.js +225 -0
  292. package/package-dist/scripts/lib/trace-coverage.d.ts +53 -0
  293. package/package-dist/scripts/lib/trace-coverage.js +178 -0
  294. package/package-dist/scripts/package-entry.d.ts +2 -0
  295. package/package-dist/scripts/package-entry.js +4 -0
  296. package/package-dist/scripts/public-api.d.ts +80 -0
  297. package/package-dist/scripts/public-api.js +28 -0
  298. package/package-dist/scripts/runtime-entry.d.ts +23 -0
  299. package/package-dist/scripts/runtime-entry.js +424 -0
  300. package/package.json +93 -0
  301. package/specs/canonical-support/flow-properties-unit-groups.json +2692 -0
  302. package/specs/import-profiles.json +118 -0
  303. package/specs/prewrite-content-policy.json +105 -0
  304. package/specs/schemas/authorization-derivation.schema.json +34 -0
  305. package/specs/schemas/execution-context.schema.json +68 -0
  306. package/specs/schemas/foundry-authorization-input.schema.json +120 -0
  307. package/specs/schemas/foundry-facade-request-index.schema.json +78 -0
  308. package/specs/schemas/foundry-managed-runtime.schema.json +122 -0
  309. package/specs/schemas/foundry-migration-activation.schema.json +213 -0
  310. package/specs/schemas/foundry-migration-adoption-plan.schema.json +548 -0
  311. package/specs/schemas/foundry-migration-transfer-receipt.schema.json +93 -0
  312. package/specs/schemas/foundry-operation-result.schema.json +147 -0
  313. package/specs/schemas/foundry-package-descriptor.schema.json +134 -0
  314. package/specs/schemas/foundry-runtime-selection.schema.json +59 -0
  315. package/specs/schemas/foundry-semantic-input.schema.json +36 -0
  316. package/specs/schemas/foundry-task-start.schema.json +123 -0
  317. package/specs/schemas/foundry-workspace-migration-pending.schema.json +17 -0
  318. package/specs/schemas/foundry-workspace-migration-plan.schema.json +59 -0
  319. package/specs/schemas/foundry-workspace-migration-transfer-plan.schema.json +357 -0
  320. package/specs/schemas/foundry-workspace-v2.schema.json +70 -0
  321. package/specs/schemas/runtime-qualification.schema.json +63 -0
  322. package/specs/schemas/task-authorization.schema.json +154 -0
  323. package/specs/schemas/tidas-runtime-expectation.schema.json +54 -0
@@ -0,0 +1,159 @@
1
+ interface JsonRecord {
2
+ [key: string]: unknown;
3
+ }
4
+ interface ArtifactEnvelope {
5
+ path?: unknown;
6
+ value?: unknown;
7
+ }
8
+ interface TransformContextLike {
9
+ kind?: unknown;
10
+ status?: unknown;
11
+ inputRowsFile?: string | null;
12
+ outputRowsFile?: string | null;
13
+ inputRows?: string[];
14
+ outputRows?: string[];
15
+ inputPayloadSha256ByIdentity?: Map<string, string>;
16
+ outputPayloadSha256ByIdentity?: Map<string, string>;
17
+ }
18
+ export interface RowsFileTransformContext extends TransformContextLike {
19
+ kind: unknown;
20
+ artifact: ArtifactEnvelope;
21
+ status: string;
22
+ counts: JsonRecord;
23
+ sourceExchangeCompletenessProofs: unknown[];
24
+ inputRowsFile: string | null;
25
+ outputRowsFile: string | null;
26
+ inputRowsFileRelative: string | null;
27
+ outputRowsFileRelative: string | null;
28
+ reportPathRelative: string;
29
+ inputPayloadSha256ByIdentity: Map<string, string>;
30
+ outputPayloadSha256ByIdentity: Map<string, string>;
31
+ }
32
+ export interface UnresolvedExchangeExternalizationContext extends TransformContextLike {
33
+ artifact: ArtifactEnvelope;
34
+ status: string;
35
+ inputRowsFile: string | null;
36
+ outputRowsFile: string | null;
37
+ tracesFile: string | null;
38
+ inputRowsFileRelative: string | null;
39
+ outputRowsFileRelative: string | null;
40
+ tracesFileRelative: string | null;
41
+ reportPathRelative: string;
42
+ externalizedExchanges: number;
43
+ affectedRows: number;
44
+ traces: unknown[];
45
+ affectedKeys: Set<string>;
46
+ externalizedExchangeCountByIdentity: Map<string, number>;
47
+ inputPayloadSha256ByIdentity: Map<string, string>;
48
+ outputPayloadSha256ByIdentity: Map<string, string>;
49
+ }
50
+ export interface CanonicalSupportRewriteContext extends TransformContextLike {
51
+ artifact: ArtifactEnvelope;
52
+ status: string;
53
+ counts: JsonRecord;
54
+ inputRowsFile: string | null;
55
+ outputRowsFile: string | null;
56
+ deferredRowsFile: string | null;
57
+ inputPayloadSha256ByIdentity: Map<string, string>;
58
+ outputPayloadSha256ByIdentity: Map<string, string>;
59
+ inputRowsFileRelative: string | null;
60
+ outputRowsFileRelative: string | null;
61
+ deferredRowsFileRelative: string | null;
62
+ reportPathRelative: string;
63
+ blockersFileRelative: string | null;
64
+ rewritesFileRelative: string | null;
65
+ blockerRows: unknown[];
66
+ blockers: unknown[];
67
+ deferredBlockers: unknown[];
68
+ rewrites: unknown[];
69
+ }
70
+ export interface RowsFileTransformEntry extends JsonRecord {
71
+ kind?: unknown;
72
+ inputRowsFile: string;
73
+ outputRowsFile: string;
74
+ inputPayloadSha256ByIdentity?: Map<string, string>;
75
+ outputPayloadSha256ByIdentity?: Map<string, string>;
76
+ }
77
+ interface UnresolvedChainOptions {
78
+ repoRoot: string;
79
+ upstreamFile: unknown;
80
+ finalFile: unknown;
81
+ unresolvedExchangeExternalizationContext: TransformContextLike | null | undefined;
82
+ }
83
+ interface ExpectedRowsOptions {
84
+ repoRoot: string;
85
+ rowsFile: unknown;
86
+ cleanupArtifact: ArtifactEnvelope | null | undefined;
87
+ }
88
+ interface DeterministicTransformContexts {
89
+ patchApplyContext?: TransformContextLike | null;
90
+ classificationDecisionApplyContext?: TransformContextLike | null;
91
+ locationDecisionApplyContext?: TransformContextLike | null;
92
+ identityDecisionApplyContext?: TransformContextLike | null;
93
+ identityReferenceRewriteContext?: TransformContextLike | null;
94
+ unresolvedExchangeExternalizationContext?: TransformContextLike | null;
95
+ sourceContactRewriteContext?: TransformContextLike | null;
96
+ canonicalSupportRewriteContext?: TransformContextLike | null;
97
+ cleanupContext?: TransformContextLike | null;
98
+ }
99
+ interface TransformReachabilityOptions {
100
+ repoRoot: string;
101
+ startFiles: unknown;
102
+ expectedRowsFile: unknown;
103
+ transforms: RowsFileTransformEntry[];
104
+ }
105
+ interface DecisionTransformReachabilityOptions extends DeterministicTransformContexts {
106
+ repoRoot: string;
107
+ context: TransformContextLike | null | undefined;
108
+ expectedRowsFile: unknown;
109
+ }
110
+ interface IdentityChainOptions {
111
+ repoRoot: string;
112
+ patchOut: unknown;
113
+ cleanupInput: unknown;
114
+ identityReferenceRewriteContext?: TransformContextLike | null;
115
+ }
116
+ interface UnresolvedPatchChainOptions {
117
+ repoRoot: string;
118
+ patchOut: unknown;
119
+ cleanupInput: unknown;
120
+ unresolvedExchangeExternalizationContext?: TransformContextLike | null;
121
+ }
122
+ interface CombinedPatchChainOptions extends IdentityChainOptions {
123
+ unresolvedExchangeExternalizationContext?: TransformContextLike | null;
124
+ }
125
+ export declare function readUnresolvedExchangeExternalizationContext(repoRoot: string, artifact: ArtifactEnvelope | null | undefined): UnresolvedExchangeExternalizationContext | null;
126
+ export declare function readCanonicalSupportRewriteContext(repoRoot: string, artifact: ArtifactEnvelope | null | undefined): CanonicalSupportRewriteContext | null;
127
+ export declare function readRowsFileTransformContext(repoRoot: string, artifact: ArtifactEnvelope | null | undefined, kind: unknown): RowsFileTransformContext | null;
128
+ export declare function readSourceContactRewriteContext(repoRoot: string, artifact: ArtifactEnvelope | null | undefined): RowsFileTransformContext | null;
129
+ export declare function readCleanupTransformContext(repoRoot: string, artifact: ArtifactEnvelope | null | undefined): RowsFileTransformContext | null;
130
+ export declare function unresolvedExchangeExternalizationRowsForIdentity(context: UnresolvedExchangeExternalizationContext | null | undefined, identity: {
131
+ id?: unknown;
132
+ version?: unknown;
133
+ } | null | undefined): unknown[];
134
+ export declare function rowsFileChainsThroughUnresolvedExchangeExternalization({ repoRoot, upstreamFile, finalFile, unresolvedExchangeExternalizationContext, }: UnresolvedChainOptions): boolean;
135
+ export declare function cleanupInputRowsFile(repoRoot: string, cleanupArtifact: ArtifactEnvelope | null | undefined): string | null;
136
+ export declare function decisionApplyExpectedRowsFile({ repoRoot, rowsFile, cleanupArtifact, }: ExpectedRowsOptions): unknown;
137
+ export declare function decisionApplyOutputRowsMatch(repoRoot: string, context: TransformContextLike | null | undefined, expectedRowsFile: unknown): boolean;
138
+ export declare function decisionApplyInputRowsMatch(repoRoot: string, context: TransformContextLike | null | undefined, expectedRowsFile: unknown): boolean;
139
+ export declare function rowsFileTransformEntriesFromDecisionApply(context: TransformContextLike | null | undefined, kind: unknown): RowsFileTransformEntry[];
140
+ export declare function rowsFileTransformEntriesFromPatchApply(context: TransformContextLike | null | undefined): RowsFileTransformEntry[];
141
+ export declare function rowsFileTransformEntryFromIdentityReferenceRewrite(context: TransformContextLike | null | undefined): RowsFileTransformEntry[];
142
+ export declare function rowsFileTransformEntryFromUnresolvedExchangeExternalization(context: TransformContextLike | null | undefined): RowsFileTransformEntry[];
143
+ export declare function rowsFileTransformEntryFromCanonicalSupportRewrite(context: TransformContextLike | null | undefined): RowsFileTransformEntry[];
144
+ export declare function rowsFileTransformEntryFromRowsFileContext(context: TransformContextLike | null | undefined, kind: unknown): RowsFileTransformEntry[];
145
+ export declare function deterministicRowsFileTransformEntries({ patchApplyContext, classificationDecisionApplyContext, locationDecisionApplyContext, identityDecisionApplyContext, identityReferenceRewriteContext, unresolvedExchangeExternalizationContext, sourceContactRewriteContext, canonicalSupportRewriteContext, cleanupContext, }: DeterministicTransformContexts): RowsFileTransformEntry[];
146
+ export declare function sameRowsArtifact(repoRoot: string, left: unknown, right: unknown): boolean;
147
+ export declare function rowsFileReachableThroughTransformChain({ repoRoot, startFiles, expectedRowsFile, transforms, }: TransformReachabilityOptions): boolean;
148
+ export declare function decisionApplyOutputRowsReachableThroughDeterministicTransforms({ repoRoot, context, expectedRowsFile, patchApplyContext, classificationDecisionApplyContext, locationDecisionApplyContext, identityDecisionApplyContext, identityReferenceRewriteContext, unresolvedExchangeExternalizationContext, sourceContactRewriteContext, canonicalSupportRewriteContext, cleanupContext, }: DecisionTransformReachabilityOptions): boolean;
149
+ export declare function decisionApplyOutputRowsChainThroughPatch(repoRoot: string, context: TransformContextLike | null | undefined, patchApplyContext: TransformContextLike | null | undefined, expectedRowsFile: unknown): boolean;
150
+ export declare function patchApplyOutputChainsThroughIdentityRewrite({ repoRoot, patchOut, cleanupInput, identityReferenceRewriteContext, }: IdentityChainOptions): boolean;
151
+ export declare function patchApplyOutputChainsThroughUnresolvedExchangeExternalization({ repoRoot, patchOut, cleanupInput, unresolvedExchangeExternalizationContext, }: UnresolvedPatchChainOptions): boolean;
152
+ export declare function patchApplyOutputChainsThroughIdentityRewriteAndUnresolvedExchangeExternalization({ repoRoot, patchOut, cleanupInput, identityReferenceRewriteContext, unresolvedExchangeExternalizationContext, }: CombinedPatchChainOptions): boolean;
153
+ export declare function decisionApplyOutputRowsChainThroughPatchAndIdentityRewrite(repoRoot: string, context: TransformContextLike | null | undefined, patchApplyContext: TransformContextLike | null | undefined, identityReferenceRewriteContext: TransformContextLike | null | undefined, expectedRowsFile: unknown): boolean;
154
+ export declare function decisionApplyOutputRowsChainThroughIdentityRewrite(repoRoot: string, context: TransformContextLike | null | undefined, identityReferenceRewriteContext: TransformContextLike | null | undefined, expectedRowsFile: unknown): boolean;
155
+ export declare function decisionApplyOutputRowsChainThroughIdentityRewriteAndUnresolvedExchangeExternalization(repoRoot: string, context: TransformContextLike | null | undefined, identityReferenceRewriteContext: TransformContextLike | null | undefined, unresolvedExchangeExternalizationContext: TransformContextLike | null | undefined, expectedRowsFile: unknown): boolean;
156
+ export declare function decisionApplyOutputRowsChainThroughClassification(repoRoot: string, context: TransformContextLike | null | undefined, classificationDecisionApplyContext: TransformContextLike | null | undefined, expectedRowsFile: unknown): boolean;
157
+ export declare function decisionApplyOutputRowsChainThroughClassificationAndIdentityRewrite(repoRoot: string, context: TransformContextLike | null | undefined, classificationDecisionApplyContext: TransformContextLike | null | undefined, identityReferenceRewriteContext: TransformContextLike | null | undefined, expectedRowsFile: unknown): boolean;
158
+ export declare function decisionApplyOutputRowsChainThroughClassificationIdentityRewriteAndUnresolvedExchangeExternalization(repoRoot: string, context: TransformContextLike | null | undefined, classificationDecisionApplyContext: TransformContextLike | null | undefined, identityReferenceRewriteContext: TransformContextLike | null | undefined, unresolvedExchangeExternalizationContext: TransformContextLike | null | undefined, expectedRowsFile: unknown): boolean;
159
+ export {};
@@ -0,0 +1,466 @@
1
+ import { readJsonLinesIfExists } from "./artifact-inputs.js";
2
+ import { datasetIdentity, identityFreshnessIdentityKey } from "./dataset-payload.js";
3
+ import { payloadSha256ByIdentityForRows } from "./full-context-proof.js";
4
+ import { sha256Json, sha256Text } from "./hash-utils.js";
5
+ import { asText, ensureArray, fileExists, normalizedArtifactPath, readText, repoRelativeArtifactPath, repoRelativePath, resolveRepoPath, sameArtifactPath, } from "./runtime-io.js";
6
+ import { readRowsIfExists } from "./workflow-patch-collect.js";
7
+ export function readUnresolvedExchangeExternalizationContext(repoRoot, artifact) {
8
+ if (!artifact)
9
+ return null;
10
+ const report = (artifact.value ?? {});
11
+ const files = report.files;
12
+ const counts = report.counts;
13
+ const inputRowsFile = resolveRepoPath(repoRoot, (report.input_rows_file ?? report.inputRowsFile ?? files?.input_rows ?? files?.inputRows));
14
+ const outputRowsFile = resolveRepoPath(repoRoot, (report.output_rows_file ??
15
+ report.outputRowsFile ??
16
+ files?.output_rows ??
17
+ files?.outputRows));
18
+ const tracesFile = resolveRepoPath(repoRoot, (report.traces_file ?? report.tracesFile ?? files?.traces ?? files?.unresolved_exchanges));
19
+ const traces = readJsonLinesIfExists(tracesFile);
20
+ const affectedKeys = new Set();
21
+ const externalizedExchangeCountByIdentity = new Map();
22
+ for (const trace of traces) {
23
+ const traceRecord = trace;
24
+ const id = asText(traceRecord?.dataset_id ?? traceRecord?.entity_id);
25
+ const version = asText(traceRecord?.dataset_version ?? traceRecord?.version) || "00.00.001";
26
+ if (!id)
27
+ continue;
28
+ const key = `process:${id}@@${version}`;
29
+ affectedKeys.add(key);
30
+ externalizedExchangeCountByIdentity.set(key, (externalizedExchangeCountByIdentity.get(key) ?? 0) + 1);
31
+ }
32
+ const outputPayloadSha256ByIdentity = new Map();
33
+ if (outputRowsFile && fileExists(outputRowsFile)) {
34
+ readRowsIfExists(outputRowsFile).forEach((row, index) => {
35
+ const identity = datasetIdentity(row, index, "process");
36
+ const key = identityFreshnessIdentityKey({
37
+ datasetType: "process",
38
+ identity,
39
+ });
40
+ if (key) {
41
+ outputPayloadSha256ByIdentity.set(key, sha256Json(identity.payload));
42
+ }
43
+ });
44
+ }
45
+ return {
46
+ artifact,
47
+ status: asText(report.status),
48
+ inputRowsFile,
49
+ outputRowsFile,
50
+ tracesFile,
51
+ inputRowsFileRelative: repoRelativeArtifactPath(repoRoot, inputRowsFile),
52
+ outputRowsFileRelative: repoRelativeArtifactPath(repoRoot, outputRowsFile),
53
+ tracesFileRelative: repoRelativeArtifactPath(repoRoot, tracesFile),
54
+ reportPathRelative: repoRelativePath(repoRoot, artifact.path),
55
+ externalizedExchanges: Number(counts?.externalized_exchanges ?? 0) || 0,
56
+ affectedRows: Number(counts?.affected_rows ?? 0) || 0,
57
+ traces,
58
+ affectedKeys,
59
+ externalizedExchangeCountByIdentity,
60
+ inputPayloadSha256ByIdentity: payloadSha256ByIdentityForRows(repoRoot, inputRowsFile ? [inputRowsFile] : [], "process"),
61
+ outputPayloadSha256ByIdentity,
62
+ };
63
+ }
64
+ export function readCanonicalSupportRewriteContext(repoRoot, artifact) {
65
+ if (!artifact)
66
+ return null;
67
+ const report = (artifact.value ?? {});
68
+ const files = report.files;
69
+ const inputRowsFile = resolveRepoPath(repoRoot, (report.rows_file ??
70
+ report.rowsFile ??
71
+ report.input_rows_file ??
72
+ report.inputRowsFile ??
73
+ files?.input_rows ??
74
+ files?.inputRows));
75
+ const outputRowsFile = resolveRepoPath(repoRoot, (report.output_rows_file ??
76
+ report.outputRowsFile ??
77
+ files?.output_rows ??
78
+ files?.outputRows));
79
+ const blockersFile = resolveRepoPath(repoRoot, (files?.canonical_support_blockers ?? files?.blockers ?? report.blockers_file));
80
+ const deferredRowsFile = resolveRepoPath(repoRoot, (files?.deferred_rows ??
81
+ files?.deferredRows ??
82
+ report.deferred_rows_file ??
83
+ report.deferredRowsFile));
84
+ const rewritesFile = resolveRepoPath(repoRoot, (files?.canonical_support_rewrites ?? files?.rewrites ?? report.rewrites_file));
85
+ const blockerRows = readJsonLinesIfExists(blockersFile);
86
+ const hardBlockers = Array.isArray(report.blockers)
87
+ ? report.blockers
88
+ : String(report.status) === "blocked"
89
+ ? blockerRows
90
+ : [];
91
+ const deferredBlockers = Array.isArray(report.deferred_blockers)
92
+ ? report.deferred_blockers
93
+ : String(report.status) === "completed_with_deferred_rows"
94
+ ? blockerRows
95
+ : [];
96
+ return {
97
+ artifact,
98
+ status: asText(report.status),
99
+ counts: report.counts && typeof report.counts === "object" ? report.counts : {},
100
+ inputRowsFile,
101
+ outputRowsFile,
102
+ deferredRowsFile,
103
+ inputPayloadSha256ByIdentity: payloadSha256ByIdentityForRows(repoRoot, inputRowsFile ? [inputRowsFile] : []),
104
+ outputPayloadSha256ByIdentity: payloadSha256ByIdentityForRows(repoRoot, outputRowsFile ? [outputRowsFile] : []),
105
+ inputRowsFileRelative: repoRelativeArtifactPath(repoRoot, inputRowsFile),
106
+ outputRowsFileRelative: repoRelativeArtifactPath(repoRoot, outputRowsFile),
107
+ deferredRowsFileRelative: repoRelativeArtifactPath(repoRoot, deferredRowsFile),
108
+ reportPathRelative: repoRelativePath(repoRoot, artifact.path),
109
+ blockersFileRelative: repoRelativeArtifactPath(repoRoot, blockersFile),
110
+ rewritesFileRelative: repoRelativeArtifactPath(repoRoot, rewritesFile),
111
+ blockerRows,
112
+ blockers: hardBlockers,
113
+ deferredBlockers,
114
+ rewrites: readJsonLinesIfExists(rewritesFile),
115
+ };
116
+ }
117
+ export function readRowsFileTransformContext(repoRoot, artifact, kind) {
118
+ if (!artifact)
119
+ return null;
120
+ const report = (artifact.value ?? {});
121
+ const files = report.files;
122
+ const proofs = report.proofs;
123
+ const inputRowsFile = resolveRepoPath(repoRoot, (report.rows_file ??
124
+ report.rowsFile ??
125
+ report.input_rows_file ??
126
+ report.inputRowsFile ??
127
+ report.input_path ??
128
+ report.inputPath ??
129
+ files?.input_rows ??
130
+ files?.inputRows ??
131
+ files?.input));
132
+ const outputRowsFile = resolveRepoPath(repoRoot, (report.output_rows_file ??
133
+ report.outputRowsFile ??
134
+ report.out_path ??
135
+ report.outPath ??
136
+ files?.output_rows ??
137
+ files?.outputRows ??
138
+ files?.cleaned_rows ??
139
+ files?.cleanedRows ??
140
+ files?.output));
141
+ return {
142
+ kind,
143
+ artifact,
144
+ status: asText(report.status),
145
+ counts: report.counts && typeof report.counts === "object" ? report.counts : {},
146
+ sourceExchangeCompletenessProofs: ensureArray(report.source_exchange_completeness_proofs ?? proofs?.source_exchange_completeness),
147
+ inputRowsFile,
148
+ outputRowsFile,
149
+ inputRowsFileRelative: repoRelativeArtifactPath(repoRoot, inputRowsFile),
150
+ outputRowsFileRelative: repoRelativeArtifactPath(repoRoot, outputRowsFile),
151
+ reportPathRelative: repoRelativePath(repoRoot, artifact.path),
152
+ inputPayloadSha256ByIdentity: payloadSha256ByIdentityForRows(repoRoot, inputRowsFile ? [inputRowsFile] : []),
153
+ outputPayloadSha256ByIdentity: payloadSha256ByIdentityForRows(repoRoot, outputRowsFile ? [outputRowsFile] : []),
154
+ };
155
+ }
156
+ export function readSourceContactRewriteContext(repoRoot, artifact) {
157
+ return readRowsFileTransformContext(repoRoot, artifact, "source_contact_rewrite");
158
+ }
159
+ export function readCleanupTransformContext(repoRoot, artifact) {
160
+ return readRowsFileTransformContext(repoRoot, artifact, "curation_cleanup");
161
+ }
162
+ export function unresolvedExchangeExternalizationRowsForIdentity(context, identity) {
163
+ if (!context || !identity?.id)
164
+ return [];
165
+ const key = `process:${identity.id}@@${identity.version || "00.00.001"}`;
166
+ return context.traces.filter((trace) => {
167
+ const traceRecord = trace;
168
+ const id = asText(traceRecord?.dataset_id ?? traceRecord?.entity_id);
169
+ const version = asText(traceRecord?.dataset_version ?? traceRecord?.version) || "00.00.001";
170
+ return key === `process:${id}@@${version}`;
171
+ });
172
+ }
173
+ export function rowsFileChainsThroughUnresolvedExchangeExternalization({ repoRoot, upstreamFile, finalFile, unresolvedExchangeExternalizationContext, }) {
174
+ return Boolean(upstreamFile &&
175
+ finalFile &&
176
+ unresolvedExchangeExternalizationContext?.status === "completed" &&
177
+ unresolvedExchangeExternalizationContext.inputRowsFile &&
178
+ unresolvedExchangeExternalizationContext.outputRowsFile &&
179
+ sameArtifactPath(repoRoot, upstreamFile, unresolvedExchangeExternalizationContext.inputRowsFile) &&
180
+ sameArtifactPath(repoRoot, unresolvedExchangeExternalizationContext.outputRowsFile, finalFile));
181
+ }
182
+ export function cleanupInputRowsFile(repoRoot, cleanupArtifact) {
183
+ const value = cleanupArtifact?.value;
184
+ const inputRows = value?.rows_file ?? value?.rowsFile ?? value?.input_path ?? value?.inputPath;
185
+ return inputRows ? resolveRepoPath(repoRoot, inputRows) : null;
186
+ }
187
+ export function decisionApplyExpectedRowsFile({ repoRoot, rowsFile, cleanupArtifact, }) {
188
+ return cleanupArtifact ? cleanupInputRowsFile(repoRoot, cleanupArtifact) : rowsFile;
189
+ }
190
+ export function decisionApplyOutputRowsMatch(repoRoot, context, expectedRowsFile) {
191
+ return Boolean(expectedRowsFile &&
192
+ context?.outputRows?.some((filePath) => sameRowsArtifact(repoRoot, filePath, expectedRowsFile)));
193
+ }
194
+ export function decisionApplyInputRowsMatch(repoRoot, context, expectedRowsFile) {
195
+ return Boolean(expectedRowsFile &&
196
+ context?.inputRows?.some((filePath) => sameRowsArtifact(repoRoot, filePath, expectedRowsFile)));
197
+ }
198
+ export function rowsFileTransformEntriesFromDecisionApply(context, kind) {
199
+ const entries = [];
200
+ if (!context?.inputRows?.length || !context?.outputRows?.length)
201
+ return entries;
202
+ if (context.status && context.status !== "completed")
203
+ return entries;
204
+ for (const inputRowsFile of context.inputRows) {
205
+ for (const outputRowsFile of context.outputRows) {
206
+ entries.push({
207
+ kind,
208
+ inputRowsFile,
209
+ outputRowsFile,
210
+ inputPayloadSha256ByIdentity: context.inputPayloadSha256ByIdentity,
211
+ outputPayloadSha256ByIdentity: context.outputPayloadSha256ByIdentity,
212
+ });
213
+ }
214
+ }
215
+ return entries;
216
+ }
217
+ export function rowsFileTransformEntriesFromPatchApply(context) {
218
+ if (!context?.inputRowsFile || !context?.outputRows?.length)
219
+ return [];
220
+ return context.outputRows.map((outputRowsFile) => ({
221
+ kind: "patch_apply",
222
+ inputRowsFile: context.inputRowsFile,
223
+ outputRowsFile,
224
+ inputPayloadSha256ByIdentity: context.inputPayloadSha256ByIdentity,
225
+ outputPayloadSha256ByIdentity: context.outputPayloadSha256ByIdentity,
226
+ }));
227
+ }
228
+ export function rowsFileTransformEntryFromIdentityReferenceRewrite(context) {
229
+ if (!context?.inputRowsFile || !context?.outputRowsFile)
230
+ return [];
231
+ return [
232
+ {
233
+ kind: "identity_reference_rewrite",
234
+ inputRowsFile: context.inputRowsFile,
235
+ outputRowsFile: context.outputRowsFile,
236
+ inputPayloadSha256ByIdentity: context.inputPayloadSha256ByIdentity,
237
+ outputPayloadSha256ByIdentity: context.outputPayloadSha256ByIdentity,
238
+ },
239
+ ];
240
+ }
241
+ export function rowsFileTransformEntryFromUnresolvedExchangeExternalization(context) {
242
+ if (context?.status !== "completed" || !context.inputRowsFile || !context.outputRowsFile) {
243
+ return [];
244
+ }
245
+ return [
246
+ {
247
+ kind: "unresolved_exchange_externalization",
248
+ inputRowsFile: context.inputRowsFile,
249
+ outputRowsFile: context.outputRowsFile,
250
+ inputPayloadSha256ByIdentity: context.inputPayloadSha256ByIdentity,
251
+ outputPayloadSha256ByIdentity: context.outputPayloadSha256ByIdentity,
252
+ },
253
+ ];
254
+ }
255
+ export function rowsFileTransformEntryFromCanonicalSupportRewrite(context) {
256
+ if (!context?.inputRowsFile || !context?.outputRowsFile)
257
+ return [];
258
+ const status = asText(context.status);
259
+ if (status &&
260
+ !["completed", "completed_no_rewrites", "completed_with_deferred_rows", "blocked"].includes(status)) {
261
+ return [];
262
+ }
263
+ return [
264
+ {
265
+ kind: "canonical_support_rewrite",
266
+ inputRowsFile: context.inputRowsFile,
267
+ outputRowsFile: context.outputRowsFile,
268
+ inputPayloadSha256ByIdentity: context.inputPayloadSha256ByIdentity,
269
+ outputPayloadSha256ByIdentity: context.outputPayloadSha256ByIdentity,
270
+ },
271
+ ];
272
+ }
273
+ export function rowsFileTransformEntryFromRowsFileContext(context, kind) {
274
+ if (!context?.inputRowsFile || !context?.outputRowsFile)
275
+ return [];
276
+ const status = asText(context.status);
277
+ if (status &&
278
+ ![
279
+ "completed",
280
+ "completed_no_rewrites",
281
+ "completed_with_deferred_rows",
282
+ "ready",
283
+ "ready_with_profile_waivers",
284
+ ].includes(status)) {
285
+ return [];
286
+ }
287
+ return [
288
+ {
289
+ kind: kind || context.kind || "rows_file_transform",
290
+ inputRowsFile: context.inputRowsFile,
291
+ outputRowsFile: context.outputRowsFile,
292
+ inputPayloadSha256ByIdentity: context.inputPayloadSha256ByIdentity,
293
+ outputPayloadSha256ByIdentity: context.outputPayloadSha256ByIdentity,
294
+ },
295
+ ];
296
+ }
297
+ export function deterministicRowsFileTransformEntries({ patchApplyContext, classificationDecisionApplyContext, locationDecisionApplyContext, identityDecisionApplyContext, identityReferenceRewriteContext, unresolvedExchangeExternalizationContext, sourceContactRewriteContext, canonicalSupportRewriteContext, cleanupContext, }) {
298
+ return [
299
+ ...rowsFileTransformEntriesFromPatchApply(patchApplyContext),
300
+ ...rowsFileTransformEntriesFromDecisionApply(classificationDecisionApplyContext, "classification_decision_apply"),
301
+ ...rowsFileTransformEntriesFromDecisionApply(locationDecisionApplyContext, "location_decision_apply"),
302
+ ...rowsFileTransformEntriesFromDecisionApply(identityDecisionApplyContext, "identity_decision_apply"),
303
+ ...rowsFileTransformEntryFromIdentityReferenceRewrite(identityReferenceRewriteContext),
304
+ ...rowsFileTransformEntryFromUnresolvedExchangeExternalization(unresolvedExchangeExternalizationContext),
305
+ ...rowsFileTransformEntryFromRowsFileContext(sourceContactRewriteContext, "source_contact_rewrite"),
306
+ ...rowsFileTransformEntryFromCanonicalSupportRewrite(canonicalSupportRewriteContext),
307
+ ...rowsFileTransformEntryFromRowsFileContext(cleanupContext, "curation_cleanup"),
308
+ ].filter((entry) => entry.inputRowsFile && entry.outputRowsFile);
309
+ }
310
+ export function sameRowsArtifact(repoRoot, left, right) {
311
+ if (sameArtifactPath(repoRoot, left, right))
312
+ return true;
313
+ const resolvedLeft = normalizedArtifactPath(repoRoot, left);
314
+ const resolvedRight = normalizedArtifactPath(repoRoot, right);
315
+ if (!resolvedLeft || !resolvedRight || !fileExists(resolvedLeft) || !fileExists(resolvedRight)) {
316
+ return false;
317
+ }
318
+ try {
319
+ return sha256Text(readText(resolvedLeft)) === sha256Text(readText(resolvedRight));
320
+ }
321
+ catch {
322
+ return false;
323
+ }
324
+ }
325
+ export function rowsFileReachableThroughTransformChain({ repoRoot, startFiles, expectedRowsFile, transforms, }) {
326
+ if (!expectedRowsFile)
327
+ return false;
328
+ const reachable = [];
329
+ const addReachable = (filePath) => {
330
+ if (!filePath)
331
+ return false;
332
+ if (reachable.some((existing) => sameRowsArtifact(repoRoot, existing, filePath))) {
333
+ return false;
334
+ }
335
+ reachable.push(filePath);
336
+ return true;
337
+ };
338
+ for (const filePath of ensureArray(startFiles))
339
+ addReachable(filePath);
340
+ if (reachable.some((filePath) => sameRowsArtifact(repoRoot, filePath, expectedRowsFile))) {
341
+ return true;
342
+ }
343
+ for (let pass = 0; pass <= transforms.length; pass += 1) {
344
+ let changed = false;
345
+ for (const transform of transforms) {
346
+ const inputReachable = reachable.some((filePath) => sameRowsArtifact(repoRoot, filePath, transform.inputRowsFile));
347
+ if (inputReachable) {
348
+ changed = addReachable(transform.outputRowsFile) || changed;
349
+ }
350
+ }
351
+ if (reachable.some((filePath) => sameRowsArtifact(repoRoot, filePath, expectedRowsFile))) {
352
+ return true;
353
+ }
354
+ if (!changed)
355
+ break;
356
+ }
357
+ return false;
358
+ }
359
+ export function decisionApplyOutputRowsReachableThroughDeterministicTransforms({ repoRoot, context, expectedRowsFile, patchApplyContext, classificationDecisionApplyContext, locationDecisionApplyContext, identityDecisionApplyContext, identityReferenceRewriteContext, unresolvedExchangeExternalizationContext, sourceContactRewriteContext, canonicalSupportRewriteContext, cleanupContext, }) {
360
+ return rowsFileReachableThroughTransformChain({
361
+ repoRoot,
362
+ startFiles: context?.outputRows ?? [],
363
+ expectedRowsFile,
364
+ transforms: deterministicRowsFileTransformEntries({
365
+ patchApplyContext,
366
+ classificationDecisionApplyContext,
367
+ locationDecisionApplyContext,
368
+ identityDecisionApplyContext,
369
+ identityReferenceRewriteContext,
370
+ unresolvedExchangeExternalizationContext,
371
+ sourceContactRewriteContext,
372
+ canonicalSupportRewriteContext,
373
+ cleanupContext,
374
+ }),
375
+ });
376
+ }
377
+ export function decisionApplyOutputRowsChainThroughPatch(repoRoot, context, patchApplyContext, expectedRowsFile) {
378
+ return Boolean(expectedRowsFile &&
379
+ patchApplyContext?.inputRowsFile &&
380
+ decisionApplyOutputRowsMatch(repoRoot, context, patchApplyContext.inputRowsFile) &&
381
+ patchApplyContext.outputRows?.some((filePath) => sameArtifactPath(repoRoot, filePath, expectedRowsFile)));
382
+ }
383
+ export function patchApplyOutputChainsThroughIdentityRewrite({ repoRoot, patchOut, cleanupInput, identityReferenceRewriteContext, }) {
384
+ return Boolean(patchOut &&
385
+ cleanupInput &&
386
+ identityReferenceRewriteContext?.inputRowsFile &&
387
+ identityReferenceRewriteContext?.outputRowsFile &&
388
+ sameArtifactPath(repoRoot, patchOut, identityReferenceRewriteContext.inputRowsFile) &&
389
+ sameArtifactPath(repoRoot, identityReferenceRewriteContext.outputRowsFile, cleanupInput));
390
+ }
391
+ export function patchApplyOutputChainsThroughUnresolvedExchangeExternalization({ repoRoot, patchOut, cleanupInput, unresolvedExchangeExternalizationContext, }) {
392
+ return rowsFileChainsThroughUnresolvedExchangeExternalization({
393
+ repoRoot,
394
+ upstreamFile: patchOut,
395
+ finalFile: cleanupInput,
396
+ unresolvedExchangeExternalizationContext,
397
+ });
398
+ }
399
+ export function patchApplyOutputChainsThroughIdentityRewriteAndUnresolvedExchangeExternalization({ repoRoot, patchOut, cleanupInput, identityReferenceRewriteContext, unresolvedExchangeExternalizationContext, }) {
400
+ return Boolean(patchApplyOutputChainsThroughIdentityRewrite({
401
+ repoRoot,
402
+ patchOut,
403
+ cleanupInput: unresolvedExchangeExternalizationContext?.inputRowsFile,
404
+ identityReferenceRewriteContext,
405
+ }) &&
406
+ rowsFileChainsThroughUnresolvedExchangeExternalization({
407
+ repoRoot,
408
+ upstreamFile: identityReferenceRewriteContext?.outputRowsFile,
409
+ finalFile: cleanupInput,
410
+ unresolvedExchangeExternalizationContext,
411
+ }));
412
+ }
413
+ export function decisionApplyOutputRowsChainThroughPatchAndIdentityRewrite(repoRoot, context, patchApplyContext, identityReferenceRewriteContext, expectedRowsFile) {
414
+ return Boolean(expectedRowsFile &&
415
+ patchApplyContext?.inputRowsFile &&
416
+ identityReferenceRewriteContext?.inputRowsFile &&
417
+ identityReferenceRewriteContext?.outputRowsFile &&
418
+ decisionApplyOutputRowsMatch(repoRoot, context, patchApplyContext.inputRowsFile) &&
419
+ patchApplyContext.outputRows?.some((filePath) => sameArtifactPath(repoRoot, filePath, identityReferenceRewriteContext.inputRowsFile)) &&
420
+ sameArtifactPath(repoRoot, identityReferenceRewriteContext.outputRowsFile, expectedRowsFile));
421
+ }
422
+ export function decisionApplyOutputRowsChainThroughIdentityRewrite(repoRoot, context, identityReferenceRewriteContext, expectedRowsFile) {
423
+ return Boolean(expectedRowsFile &&
424
+ identityReferenceRewriteContext?.inputRowsFile &&
425
+ identityReferenceRewriteContext?.outputRowsFile &&
426
+ decisionApplyOutputRowsMatch(repoRoot, context, identityReferenceRewriteContext.inputRowsFile) &&
427
+ sameArtifactPath(repoRoot, identityReferenceRewriteContext.outputRowsFile, expectedRowsFile));
428
+ }
429
+ export function decisionApplyOutputRowsChainThroughIdentityRewriteAndUnresolvedExchangeExternalization(repoRoot, context, identityReferenceRewriteContext, unresolvedExchangeExternalizationContext, expectedRowsFile) {
430
+ return Boolean(expectedRowsFile &&
431
+ identityReferenceRewriteContext?.inputRowsFile &&
432
+ identityReferenceRewriteContext?.outputRowsFile &&
433
+ unresolvedExchangeExternalizationContext?.inputRowsFile &&
434
+ decisionApplyOutputRowsMatch(repoRoot, context, identityReferenceRewriteContext.inputRowsFile) &&
435
+ sameArtifactPath(repoRoot, identityReferenceRewriteContext.outputRowsFile, unresolvedExchangeExternalizationContext.inputRowsFile) &&
436
+ rowsFileChainsThroughUnresolvedExchangeExternalization({
437
+ repoRoot,
438
+ upstreamFile: unresolvedExchangeExternalizationContext.inputRowsFile,
439
+ finalFile: expectedRowsFile,
440
+ unresolvedExchangeExternalizationContext,
441
+ }));
442
+ }
443
+ export function decisionApplyOutputRowsChainThroughClassification(repoRoot, context, classificationDecisionApplyContext, expectedRowsFile) {
444
+ return Boolean(expectedRowsFile &&
445
+ classificationDecisionApplyContext?.inputRows?.some((filePath) => decisionApplyOutputRowsMatch(repoRoot, context, filePath)) &&
446
+ decisionApplyOutputRowsMatch(repoRoot, classificationDecisionApplyContext, expectedRowsFile));
447
+ }
448
+ export function decisionApplyOutputRowsChainThroughClassificationAndIdentityRewrite(repoRoot, context, classificationDecisionApplyContext, identityReferenceRewriteContext, expectedRowsFile) {
449
+ return Boolean(expectedRowsFile &&
450
+ identityReferenceRewriteContext?.inputRowsFile &&
451
+ identityReferenceRewriteContext?.outputRowsFile &&
452
+ classificationDecisionApplyContext?.outputRows?.some((filePath) => sameArtifactPath(repoRoot, filePath, identityReferenceRewriteContext.inputRowsFile)) &&
453
+ decisionApplyOutputRowsChainThroughClassification(repoRoot, context, classificationDecisionApplyContext, identityReferenceRewriteContext.inputRowsFile) &&
454
+ sameArtifactPath(repoRoot, identityReferenceRewriteContext.outputRowsFile, expectedRowsFile));
455
+ }
456
+ export function decisionApplyOutputRowsChainThroughClassificationIdentityRewriteAndUnresolvedExchangeExternalization(repoRoot, context, classificationDecisionApplyContext, identityReferenceRewriteContext, unresolvedExchangeExternalizationContext, expectedRowsFile) {
457
+ return Boolean(expectedRowsFile &&
458
+ unresolvedExchangeExternalizationContext?.inputRowsFile &&
459
+ decisionApplyOutputRowsChainThroughClassificationAndIdentityRewrite(repoRoot, context, classificationDecisionApplyContext, identityReferenceRewriteContext, unresolvedExchangeExternalizationContext.inputRowsFile) &&
460
+ rowsFileChainsThroughUnresolvedExchangeExternalization({
461
+ repoRoot,
462
+ upstreamFile: unresolvedExchangeExternalizationContext.inputRowsFile,
463
+ finalFile: expectedRowsFile,
464
+ unresolvedExchangeExternalizationContext,
465
+ }));
466
+ }