@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,525 @@
1
+ import { spawnSync } from "node:child_process";
2
+ import { createHash, randomUUID } from "node:crypto";
3
+ import fs from "node:fs";
4
+ import path from "node:path";
5
+ import process from "node:process";
6
+ export const TIDAS_OPERATION_REPORT_SCHEMA = "tidas.operation-report.v1";
7
+ export const TIDAS_IMPORT_REPORT_SCHEMA = "tidas.import-execution-report.v1";
8
+ export const TIDAS_VALIDATION_SUMMARY_SCHEMA = "tidas.validation-summary.v1";
9
+ export const TIDAS_VALIDATION_DESCRIBE_SCHEMA = "tidas.validation-describe.v1";
10
+ export const TIDAS_VALIDATION_BATCH_FINAL_SCHEMA = "tidas.validation-final-event.v1";
11
+ export const TIDAS_SUPPORTED_VERSION_LINES = Object.freeze(["0.2", "0.3"]);
12
+ const EXIT_CODES = new Map([
13
+ ["success", 0],
14
+ ["data-issues", 2],
15
+ ["usage", 64],
16
+ ["unavailable", 69],
17
+ ["internal", 70],
18
+ ["io", 74],
19
+ ["cancelled", 130],
20
+ ]);
21
+ const ROOT_CATEGORY = new Map([
22
+ ["contactDataSet", { category: "contacts", informationKey: "contactInformation" }],
23
+ [
24
+ "flowPropertyDataSet",
25
+ { category: "flowproperties", informationKey: "flowPropertiesInformation" },
26
+ ],
27
+ ["flowDataSet", { category: "flows", informationKey: "flowInformation" }],
28
+ ["LCIAMethodDataSet", { category: "lciamethods", informationKey: "LCIAMethodInformation" }],
29
+ [
30
+ "lifeCycleModelDataSet",
31
+ { category: "lifecyclemodels", informationKey: "lifeCycleModelInformation" },
32
+ ],
33
+ ["processDataSet", { category: "processes", informationKey: "processInformation" }],
34
+ ["sourceDataSet", { category: "sources", informationKey: "sourceInformation" }],
35
+ ["unitGroupDataSet", { category: "unitgroups", informationKey: "unitGroupInformation" }],
36
+ ]);
37
+ function record(value) {
38
+ return value && typeof value === "object" && !Array.isArray(value) ? value : null;
39
+ }
40
+ function parseJsonOutput(result, label) {
41
+ try {
42
+ return JSON.parse(result.stdout || "{}");
43
+ }
44
+ catch {
45
+ throw new Error([
46
+ `${label} did not emit JSON.`,
47
+ result.stdout ? `stdout:\n${result.stdout}` : "",
48
+ result.stderr ? `stderr:\n${result.stderr}` : "",
49
+ ]
50
+ .filter(Boolean)
51
+ .join("\n"));
52
+ }
53
+ }
54
+ function assertOperationReport(report, command, exitCode) {
55
+ const expectedExitCode = EXIT_CODES.get(String(report.exit_class ?? ""));
56
+ if (report?.schema_version !== TIDAS_OPERATION_REPORT_SCHEMA ||
57
+ report?.command !== command ||
58
+ !["succeeded", "completed-with-issues", "failed", "cancelled"].includes(String(report.status ?? "")) ||
59
+ !["complete", "partial", "not-started"].includes(String(report.completeness ?? "")) ||
60
+ expectedExitCode === undefined ||
61
+ !Array.isArray(report?.diagnostics) ||
62
+ !Array.isArray(report?.artifacts) ||
63
+ !Array.isArray(report?.next_actions)) {
64
+ throw new Error(`tidas_operation_report_invalid:${command}`);
65
+ }
66
+ if (exitCode !== expectedExitCode) {
67
+ throw new Error(`tidas_exit_contract_mismatch:${command}:exit=${exitCode}:class=${report.exit_class}`);
68
+ }
69
+ return report;
70
+ }
71
+ function assertCompatibleVersion(report) {
72
+ const version = String(report?.summary?.binary_version ?? "");
73
+ const match = /^(\d+)\.(\d+)\.(\d+)(?:[-+][0-9A-Za-z.-]+)?$/u.exec(version);
74
+ if (!match)
75
+ throw new Error(`tidas_version_invalid:${version || "missing"}`);
76
+ if (!TIDAS_SUPPORTED_VERSION_LINES.includes(`${match[1]}.${match[2]}`)) {
77
+ throw new Error(`tidas_version_unsupported:${version}:required=${TIDAS_SUPPORTED_VERSION_LINES.map((line) => `${line}.x`).join("|")}`);
78
+ }
79
+ return version;
80
+ }
81
+ export function resolveTidasInvocation(options = {}, env = process.env) {
82
+ const explicit = String(options.tidasBin ?? options.tidasExecutable ?? "").trim();
83
+ const environment = String(env.TIDAS_BIN ?? "").trim();
84
+ const executable = explicit || environment || "tidas";
85
+ const config = String(options.tidasConfig ?? options.config ?? env.TIDAS_CONFIG ?? "").trim();
86
+ return {
87
+ executable,
88
+ executable_source: explicit ? "option" : environment ? "TIDAS_BIN" : "PATH",
89
+ config: config || null,
90
+ config_source: options.tidasConfig || options.config ? "option" : config ? "TIDAS_CONFIG" : "none",
91
+ };
92
+ }
93
+ export function resolveTidasProcessCommand(executable) {
94
+ if (/\.(?:[cm]?[jt]s)$/iu.test(executable)) {
95
+ return {
96
+ command: process.execPath,
97
+ prefixArgs: [executable],
98
+ };
99
+ }
100
+ return {
101
+ command: executable,
102
+ prefixArgs: [],
103
+ };
104
+ }
105
+ function globalArgs(invocation, options = {}, environment = process.env) {
106
+ const args = ["--format", "json", "--progress", "never"];
107
+ if (invocation.config)
108
+ args.push("--config", invocation.config);
109
+ const memoryBudgetMib = options.memoryBudgetMib ?? environment.TIDAS_MEMORY_BUDGET_MIB;
110
+ const queueCapacity = options.queueCapacity ?? environment.TIDAS_QUEUE_CAPACITY;
111
+ if (String(memoryBudgetMib ?? "").trim()) {
112
+ args.push("--memory-budget-mib", String(memoryBudgetMib).trim());
113
+ }
114
+ if (String(queueCapacity ?? "").trim()) {
115
+ args.push("--queue-capacity", String(queueCapacity).trim());
116
+ }
117
+ return args;
118
+ }
119
+ function portableRelativePath(repoRoot, filePath) {
120
+ return path.relative(repoRoot, filePath).split(path.sep).join(path.posix.sep);
121
+ }
122
+ function runProcess(invocation, args, cwd, maxBuffer = 512 * 1024 * 1024, environment = process.env) {
123
+ const processCommand = resolveTidasProcessCommand(invocation.executable);
124
+ const result = spawnSync(processCommand.command, [...processCommand.prefixArgs, ...args], {
125
+ cwd,
126
+ env: environment,
127
+ encoding: "utf8",
128
+ maxBuffer,
129
+ });
130
+ if (result.error)
131
+ throw result.error;
132
+ return result;
133
+ }
134
+ export function runTidasHandshake({ repoRoot, options = {}, environment = process.env, }) {
135
+ const invocation = resolveTidasInvocation(options, environment);
136
+ const args = ["version", ...globalArgs(invocation, options, environment)];
137
+ const result = runProcess(invocation, args, repoRoot, undefined, environment);
138
+ const exitCode = typeof result.status === "number" ? result.status : 70;
139
+ const report = assertOperationReport(parseJsonOutput(result, "tidas version"), "version", exitCode);
140
+ const binaryVersion = assertCompatibleVersion(report);
141
+ if (report.summary?.operation_report_schema !== TIDAS_OPERATION_REPORT_SCHEMA) {
142
+ throw new Error("tidas_version_handshake_operation_schema_mismatch");
143
+ }
144
+ const describeArgs = ["validate", "--describe", ...globalArgs(invocation, options, environment)];
145
+ const describeResult = runProcess(invocation, describeArgs, repoRoot, undefined, environment);
146
+ const describeExitCode = typeof describeResult.status === "number" ? describeResult.status : 70;
147
+ const describeReport = assertOperationReport(parseJsonOutput(describeResult, "tidas validate --describe"), "validate", describeExitCode);
148
+ const validationDescribe = record(describeReport?.summary?.validation_describe);
149
+ if (validationDescribe?.schema_version !== TIDAS_VALIDATION_DESCRIBE_SCHEMA ||
150
+ !validationDescribe.protocols?.includes("document-validation-batch.v1") ||
151
+ !validationDescribe.event_schema_versions?.includes(TIDAS_VALIDATION_BATCH_FINAL_SCHEMA) ||
152
+ !/^[0-9a-f]{64}$/u.test(String(validationDescribe.asset_fingerprint ?? ""))) {
153
+ throw new Error("tidas_validation_describe_handshake_invalid");
154
+ }
155
+ return {
156
+ invocation,
157
+ args,
158
+ describe_args: describeArgs,
159
+ exit_code: exitCode,
160
+ stderr: result.stderr || "",
161
+ validation_describe_stderr: describeResult.stderr || "",
162
+ binary_version: binaryVersion,
163
+ report,
164
+ validation_describe: validationDescribe,
165
+ validation_describe_report: describeReport,
166
+ };
167
+ }
168
+ function runTidasOperation({ repoRoot, command, commandArgs, options = {}, environment = process.env, }) {
169
+ const handshake = runTidasHandshake({ repoRoot, options, environment });
170
+ const args = [command, ...commandArgs, ...globalArgs(handshake.invocation, options, environment)];
171
+ const result = runProcess(handshake.invocation, args, repoRoot, undefined, environment);
172
+ const exitCode = typeof result.status === "number" ? result.status : 70;
173
+ const report = assertOperationReport(parseJsonOutput(result, `tidas ${command}`), command, exitCode);
174
+ return {
175
+ command,
176
+ executable: handshake.invocation.executable,
177
+ executable_source: handshake.invocation.executable_source,
178
+ config_source: handshake.invocation.config_source,
179
+ args,
180
+ exit_code: exitCode,
181
+ stderr: result.stderr || "",
182
+ binary_version: handshake.binary_version,
183
+ handshake: handshake.report,
184
+ validation_describe: handshake.validation_describe,
185
+ validation_describe_report: handshake.validation_describe_report,
186
+ report,
187
+ };
188
+ }
189
+ export function runTidasImport({ repoRoot, options = {}, environment = process.env, }) {
190
+ const input = path.resolve(repoRoot, String(options.input ?? options.source ?? ""));
191
+ const output = path.resolve(repoRoot, String(options.output ?? options.outDir ?? ""));
192
+ if (!options.input && !options.source)
193
+ throw new Error("--input is required.");
194
+ if (!options.output && !options.outDir)
195
+ throw new Error("--output is required.");
196
+ const args = [input, "--output", output];
197
+ if (options.fromFormat)
198
+ args.push("--from-format", String(options.fromFormat));
199
+ if (options.target)
200
+ args.push("--target", String(options.target));
201
+ if (options.writeMapping === true || options.writeMapping === "true")
202
+ args.push("--write-mapping");
203
+ if (options.noProcessBundles === true || options.noProcessBundles === "true") {
204
+ args.push("--no-process-bundles");
205
+ }
206
+ if (options.failOnWarning === true || options.failOnWarning === "true") {
207
+ args.push("--fail-on-warning");
208
+ }
209
+ if (options.maxEntryMib)
210
+ args.push("--max-entry-mib", String(options.maxEntryMib));
211
+ const operation = runTidasOperation({
212
+ repoRoot,
213
+ command: "import",
214
+ commandArgs: args,
215
+ options,
216
+ environment,
217
+ });
218
+ const importReport = record(operation.report?.summary?.import);
219
+ if (importReport && importReport.schema_version !== TIDAS_IMPORT_REPORT_SCHEMA) {
220
+ throw new Error("tidas_import_report_invalid");
221
+ }
222
+ if (operation.exit_code === 0 && !importReport) {
223
+ throw new Error("tidas_import_report_missing");
224
+ }
225
+ return operation;
226
+ }
227
+ export function runTidasPackageValidation({ repoRoot, options = {}, environment = process.env, }) {
228
+ const input = path.resolve(repoRoot, String(options.input ?? ""));
229
+ if (!options.input)
230
+ throw new Error("--input is required.");
231
+ const args = [input, "--input-format", String(options.inputFormat ?? "tidas-json")];
232
+ if (options.issues)
233
+ args.push("--issues", path.resolve(repoRoot, String(options.issues)));
234
+ const operation = runTidasOperation({
235
+ repoRoot,
236
+ command: "validate",
237
+ commandArgs: args,
238
+ options,
239
+ environment,
240
+ });
241
+ const summary = record(operation.report?.summary?.validation);
242
+ if (summary && summary.schema_version !== TIDAS_VALIDATION_SUMMARY_SCHEMA) {
243
+ throw new Error("tidas_validation_summary_invalid");
244
+ }
245
+ if ([0, 2].includes(operation.exit_code) && !summary) {
246
+ throw new Error("tidas_validation_summary_missing");
247
+ }
248
+ if (summary?.asset_fingerprint &&
249
+ summary.asset_fingerprint !== operation.validation_describe.asset_fingerprint) {
250
+ throw new Error("tidas_validation_asset_fingerprint_mismatch");
251
+ }
252
+ return operation;
253
+ }
254
+ function readRows(filePath) {
255
+ const text = fs.readFileSync(filePath, "utf8");
256
+ if (filePath.toLowerCase().endsWith(".jsonl")) {
257
+ return text
258
+ .split(/\r?\n/u)
259
+ .filter((line) => line.trim())
260
+ .map((line) => JSON.parse(line));
261
+ }
262
+ const value = JSON.parse(text);
263
+ if (Array.isArray(value))
264
+ return value;
265
+ if (Array.isArray(value?.rows))
266
+ return value.rows;
267
+ return [value];
268
+ }
269
+ function payloadForRow(row) {
270
+ for (const key of [
271
+ "payload",
272
+ "contact",
273
+ "flowproperty",
274
+ "flow",
275
+ "lciamethod",
276
+ "lifecyclemodel",
277
+ "process",
278
+ "source",
279
+ "unitgroup",
280
+ "json_ordered",
281
+ "jsonOrdered",
282
+ "json",
283
+ ]) {
284
+ const payload = record(row[key]);
285
+ if (payload)
286
+ return payload;
287
+ }
288
+ return row;
289
+ }
290
+ function documentCategory(payload) {
291
+ for (const [rootKey, config] of ROOT_CATEGORY) {
292
+ if (record(payload?.[rootKey]))
293
+ return { rootKey, ...config };
294
+ }
295
+ throw new Error("tidas_row_category_unknown");
296
+ }
297
+ function firstText(value) {
298
+ if (typeof value === "string")
299
+ return value.trim();
300
+ if (Array.isArray(value)) {
301
+ for (const item of value) {
302
+ const text = firstText(item);
303
+ if (text)
304
+ return text;
305
+ }
306
+ }
307
+ const valueRecord = record(value);
308
+ if (valueRecord)
309
+ return firstText(valueRecord["#text"]);
310
+ return "";
311
+ }
312
+ function identityForPayload(payload, rootKey, informationKey) {
313
+ const root = record(payload[rootKey]) ?? {};
314
+ const informationRecord = record(root[informationKey]);
315
+ const information = record(informationRecord?.dataSetInformation) ?? record(root.dataSetInformation) ?? {};
316
+ const id = firstText(information?.["common:UUID"]) || null;
317
+ const administrative = record(root.administrativeInformation);
318
+ const publication = record(administrative?.publicationAndOwnership);
319
+ const version = firstText(publication?.["common:dataSetVersion"]) || null;
320
+ return { id, version };
321
+ }
322
+ function sha256(bytes) {
323
+ return createHash("sha256").update(bytes).digest("hex");
324
+ }
325
+ function writeJson(filePath, value) {
326
+ fs.mkdirSync(path.dirname(filePath), { recursive: true });
327
+ fs.writeFileSync(filePath, `${JSON.stringify(value, null, 2)}\n`);
328
+ }
329
+ function writeJsonl(filePath, values) {
330
+ fs.mkdirSync(path.dirname(filePath), { recursive: true });
331
+ fs.writeFileSync(filePath, values.map((value) => JSON.stringify(value)).join("\n") + (values.length ? "\n" : ""));
332
+ }
333
+ function replaceDirectoryAtomically(staging, output) {
334
+ const parent = path.dirname(output);
335
+ fs.mkdirSync(parent, { recursive: true });
336
+ const backup = `${output}.rollback-${process.pid}`;
337
+ const hadOutput = fs.existsSync(output);
338
+ if (fs.existsSync(backup))
339
+ fs.rmSync(backup, { recursive: true, force: true });
340
+ try {
341
+ if (hadOutput)
342
+ fs.renameSync(output, backup);
343
+ fs.renameSync(staging, output);
344
+ if (hadOutput)
345
+ fs.rmSync(backup, { recursive: true, force: true });
346
+ }
347
+ catch (error) {
348
+ if (fs.existsSync(output) && !hadOutput)
349
+ fs.rmSync(output, { recursive: true, force: true });
350
+ if (hadOutput && fs.existsSync(backup) && !fs.existsSync(output)) {
351
+ fs.renameSync(backup, output);
352
+ }
353
+ throw error;
354
+ }
355
+ }
356
+ export function runTidasRowsValidation({ repoRoot, options = {}, environment = process.env, }) {
357
+ const rowsFile = path.resolve(repoRoot, String(options.rowsFile ?? options.input ?? ""));
358
+ const outDir = path.resolve(repoRoot, String(options.outDir ?? ""));
359
+ if (!options.rowsFile && !options.input)
360
+ throw new Error("--rows-file is required.");
361
+ if (!options.outDir)
362
+ throw new Error("--out-dir is required.");
363
+ const rows = readRows(rowsFile);
364
+ fs.mkdirSync(path.dirname(outDir), { recursive: true });
365
+ const staging = path.join(path.dirname(outDir), `.tidas-validate-stage-${randomUUID()}`);
366
+ // Keep staging beside the output for atomic rename; Windows mkdtemp rejects deep prefixes.
367
+ fs.mkdirSync(staging, { mode: 0o700 });
368
+ try {
369
+ const inputRoot = path.join(staging, "input");
370
+ const manifest = [];
371
+ for (const [ordinal, row] of rows.entries()) {
372
+ const payload = payloadForRow(row);
373
+ const { rootKey, category, informationKey } = documentCategory(payload);
374
+ const identity = identityForPayload(payload, rootKey, informationKey);
375
+ const token = (identity.id || String(ordinal)).replace(/[^A-Za-z0-9_.-]/gu, "_");
376
+ const relativePath = `${category}/${String(ordinal).padStart(8, "0")}-${token}.json`;
377
+ const bytes = Buffer.from(`${JSON.stringify(payload)}\n`);
378
+ const documentPath = path.join(inputRoot, relativePath);
379
+ fs.mkdirSync(path.dirname(documentPath), { recursive: true });
380
+ fs.writeFileSync(documentPath, bytes);
381
+ manifest.push({
382
+ document_key: `${category}:${identity.id || ordinal}:${identity.version || "unknown"}`,
383
+ category,
384
+ relative_path: relativePath,
385
+ content_sha256: sha256(bytes),
386
+ identity: {
387
+ dataset_type: category,
388
+ dataset_id: identity.id,
389
+ dataset_version: identity.version,
390
+ },
391
+ });
392
+ }
393
+ const manifestPath = path.join(staging, "input-manifest.jsonl");
394
+ const eventsPath = path.join(staging, "validation-events.jsonl");
395
+ writeJsonl(manifestPath, manifest);
396
+ const operation = runTidasOperation({
397
+ repoRoot,
398
+ command: "validate",
399
+ commandArgs: [
400
+ inputRoot,
401
+ "--protocol",
402
+ "document-validation-batch.v1",
403
+ "--input-manifest",
404
+ manifestPath,
405
+ "--events",
406
+ eventsPath,
407
+ ],
408
+ options,
409
+ environment,
410
+ });
411
+ if (operation.exit_code !== 0 && operation.exit_code !== 2)
412
+ return operation;
413
+ const finalEvent = record(operation.report?.summary?.validation_batch_final);
414
+ if (!finalEvent ||
415
+ finalEvent.schema_version !== TIDAS_VALIDATION_BATCH_FINAL_SCHEMA ||
416
+ finalEvent.completed !== true) {
417
+ throw new Error("tidas_validation_batch_final_invalid");
418
+ }
419
+ const finalFingerprints = record(finalEvent.fingerprints);
420
+ if (finalFingerprints?.asset_fingerprint !== operation.validation_describe.asset_fingerprint) {
421
+ throw new Error("tidas_validation_asset_fingerprint_mismatch");
422
+ }
423
+ const events = fs
424
+ .readFileSync(eventsPath, "utf8")
425
+ .split(/\r?\n/u)
426
+ .filter((line) => line.trim())
427
+ .map((line) => JSON.parse(line));
428
+ const issuesByOrdinal = new Map();
429
+ for (const event of events) {
430
+ if (event.type !== "issue")
431
+ continue;
432
+ const ordinal = Number(event.document_ordinal);
433
+ if (!Number.isSafeInteger(ordinal) || ordinal < 0 || ordinal >= rows.length)
434
+ throw new Error("tidas_validation_issue_ordinal_invalid");
435
+ if (!issuesByOrdinal.has(ordinal))
436
+ issuesByOrdinal.set(ordinal, []);
437
+ const nativeIssue = record(event.issue);
438
+ if (!nativeIssue)
439
+ throw new Error("tidas_validation_issue_invalid");
440
+ const location = typeof nativeIssue.location === "string" ? nativeIssue.location : null;
441
+ const payload = payloadForRow(rows[ordinal]);
442
+ const wrapper = payload === rows[ordinal]
443
+ ? null
444
+ : Object.entries(rows[ordinal]).find(([, value]) => value === payload)?.[0];
445
+ const pointer = location === null
446
+ ? null
447
+ : location === "" || location.startsWith("/")
448
+ ? location
449
+ : `/${location}`;
450
+ issuesByOrdinal.get(ordinal).push({
451
+ ...nativeIssue,
452
+ code: nativeIssue.code ?? nativeIssue.issue_code,
453
+ path: nativeIssue.path ??
454
+ (pointer === null ? null : `${wrapper ? `/${wrapper}` : ""}${pointer}`),
455
+ });
456
+ }
457
+ const invalidOrdinals = new Set(events
458
+ .filter((event) => event.type === "issue" && record(event.issue)?.severity === "error")
459
+ .map((event) => Number(event.document_ordinal)));
460
+ const validRows = rows.filter((_, ordinal) => !invalidOrdinals.has(ordinal));
461
+ const invalidRows = rows.filter((_, ordinal) => invalidOrdinals.has(ordinal));
462
+ const reportPath = path.join(staging, "outputs", "validation-report.json");
463
+ const validRowsPath = path.join(staging, "outputs", "valid-rows.jsonl");
464
+ const invalidRowsPath = path.join(staging, "outputs", "invalid-rows.jsonl");
465
+ const operationReportPath = path.join(staging, "tidas-operation-report.json");
466
+ const compatibilityReport = {
467
+ schema_version: 2,
468
+ status: "completed",
469
+ input_path: portableRelativePath(repoRoot, rowsFile),
470
+ requested_type: String(options.type ?? options.datasetType ?? "auto"),
471
+ dataset_type: String(options.type ?? options.datasetType ?? "auto"),
472
+ engine: "tidas",
473
+ binary_version: operation.binary_version,
474
+ rows: manifest.map((entry, ordinal) => ({
475
+ index: ordinal,
476
+ id: entry.identity.dataset_id,
477
+ version: entry.identity.dataset_version,
478
+ type: String(options.type ?? options.datasetType ?? entry.category),
479
+ status: invalidOrdinals.has(ordinal) ? "invalid" : "valid",
480
+ issues: issuesByOrdinal.get(ordinal) ?? [],
481
+ })),
482
+ counts: {
483
+ total: rows.length,
484
+ valid: validRows.length,
485
+ invalid: invalidRows.length,
486
+ issues: Number(record(finalEvent.summary)?.issue_count ?? 0),
487
+ blockers: invalidRows.length,
488
+ },
489
+ rust_contract: {
490
+ operation_report_schema: TIDAS_OPERATION_REPORT_SCHEMA,
491
+ batch_final_schema: TIDAS_VALIDATION_BATCH_FINAL_SCHEMA,
492
+ protocol: finalEvent.protocol,
493
+ profile: finalEvent.profile,
494
+ logical_issue_stream_sha256: finalEvent.logical_issue_stream_sha256,
495
+ asset_fingerprint: finalFingerprints?.asset_fingerprint ?? null,
496
+ validation_describe_schema: TIDAS_VALIDATION_DESCRIBE_SCHEMA,
497
+ },
498
+ files: {
499
+ report: portableRelativePath(repoRoot, path.join(outDir, "outputs", "validation-report.json")),
500
+ valid_rows: portableRelativePath(repoRoot, path.join(outDir, "outputs", "valid-rows.jsonl")),
501
+ invalid_rows: portableRelativePath(repoRoot, path.join(outDir, "outputs", "invalid-rows.jsonl")),
502
+ events: portableRelativePath(repoRoot, path.join(outDir, "validation-events.jsonl")),
503
+ manifest: portableRelativePath(repoRoot, path.join(outDir, "input-manifest.jsonl")),
504
+ operation_report: portableRelativePath(repoRoot, path.join(outDir, "tidas-operation-report.json")),
505
+ },
506
+ };
507
+ writeJson(reportPath, compatibilityReport);
508
+ writeJsonl(validRowsPath, validRows);
509
+ writeJsonl(invalidRowsPath, invalidRows);
510
+ writeJson(operationReportPath, operation.report);
511
+ replaceDirectoryAtomically(staging, outDir);
512
+ return {
513
+ ...operation,
514
+ exit_code: invalidRows.length === 0 ? 0 : 2,
515
+ report: compatibilityReport,
516
+ report_file: path.join(outDir, "outputs", "validation-report.json"),
517
+ rust_report: operation.report,
518
+ rust_exit_code: operation.exit_code,
519
+ };
520
+ }
521
+ finally {
522
+ if (fs.existsSync(staging))
523
+ fs.rmSync(staging, { recursive: true, force: true });
524
+ }
525
+ }
@@ -0,0 +1,8 @@
1
+ export declare const TIDAS_LANGUAGE_CODES: string[];
2
+ export declare const TIDAS_LANGUAGE_CODE_SET: Set<string>;
3
+ export type TidasLanguageOptions = {
4
+ fallback?: unknown;
5
+ field?: unknown;
6
+ };
7
+ export declare function normalizeTidasLanguageCode(language: unknown, options?: TidasLanguageOptions): string;
8
+ export declare function tidasLanguageForText(text: unknown, fallback?: unknown): string;