@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,136 @@
1
+ import { createHash } from "node:crypto";
2
+ import { FoundryContextError, captureFoundryInput, readFoundryInput, } from "./foundry-runtime-context.js";
3
+ import { verifyFoundryRuntimeIdentity, } from "./foundry-runtime-identity.js";
4
+ import { currentWorkflowState, workflowObject, } from "./foundry-workflow-state.js";
5
+ import { finalizeFoundryWorkflow } from "./foundry-workflow-finalize.js";
6
+ import { prepareDerivedFoundryTaskAuthorization, registerFoundryTaskAuthorization, loadFoundryTaskAuthorization, } from "./foundry-task-authorization.js";
7
+ import { recordFoundryWorkflowAuthorization } from "./foundry-workflow-authorization.js";
8
+ import { assertFoundryTaskInputLineage } from "./foundry-task-store.js";
9
+ import { readTaskBytes } from "./foundry-task-io.js";
10
+ import { deriveTaskAuthorizationGrant, validateTaskAuthorization } from "./task-authorization.js";
11
+ import { sha256Json } from "./identity-preflight-proof.js";
12
+ import { completedOwnerScopes } from "./foundry-owner-execution-store.js";
13
+ const digest = (bytes) => createHash("sha256").update(bytes).digest("hex");
14
+ function invalid(message) {
15
+ throw new FoundryContextError("authorization_continuation_invalid", message);
16
+ }
17
+ export async function continueFoundryPreparedApproval(context, qualified, entries, approval, authentication = { mode: "oauth" }) {
18
+ const state = currentWorkflowState(context, entries), finalization = state.finalization;
19
+ if (!finalization || approval.value.input_kind !== "current_rows")
20
+ invalid("Select current prepared-row approval evidence.");
21
+ const original = workflowObject(approval.value.input);
22
+ if (typeof original.path !== "string" ||
23
+ typeof original.sha256 !== "string" ||
24
+ typeof approval.value.dataset_type !== "string")
25
+ invalid("Prepared approval input is invalid.");
26
+ const inputFile = original.path, datasetType = approval.value.dataset_type;
27
+ const progress = completedOwnerScopes(context, entries);
28
+ const executionProgress = { sha256: progress.progressSha256, scopes: progress.completed };
29
+ readFoundryInput(context, inputFile);
30
+ if (finalization.value.approval_source_sha256 !== approval.entry.sha256) {
31
+ if (state.authorization?.entry.sha256 !== approval.entry.sha256)
32
+ invalid("Preparation approval is no longer active.");
33
+ return finalizeFoundryWorkflow(context, qualified, entries, authentication, {
34
+ sourceSha256: approval.entry.sha256,
35
+ authorizationSha256: String(approval.value.authorization_sha256),
36
+ datasetType,
37
+ inputFile,
38
+ }, executionProgress);
39
+ }
40
+ const scope = finalization.value.sets
41
+ .map(workflowObject)
42
+ .find((item) => item.type === datasetType);
43
+ if (!scope || typeof scope.final_rows !== "string")
44
+ return finalization.value;
45
+ const ready = scope.status === "ready_for_remote_write";
46
+ if (!ready) {
47
+ // Cleanup may change input bytes before support policy is reapplied. Only
48
+ // this permission blocker may advance; content and reference blockers stay pending.
49
+ const action = datasetType === "unitgroup"
50
+ ? "unitgroup_write"
51
+ : datasetType === "flowproperty"
52
+ ? "flowproperty_write"
53
+ : null;
54
+ const actions = approval.value.allowed_actions;
55
+ if (!action ||
56
+ !Array.isArray(actions) ||
57
+ !actions.includes(action) ||
58
+ !actions.includes("canonical_support_local_mint") ||
59
+ typeof scope.report !== "string")
60
+ return finalization.value;
61
+ const report = workflowObject(JSON.parse(readFoundryInput(context, scope.report).toString("utf8")));
62
+ if (!Array.isArray(report.blockers) ||
63
+ !report.blockers.length ||
64
+ report.blockers.some((raw) => workflowObject(raw).code !== "reference_only_support_type_write_blocked"))
65
+ return finalization.value;
66
+ }
67
+ const finalRows = scope.final_rows;
68
+ readFoundryInput(context, finalRows);
69
+ const identity = verifyFoundryRuntimeIdentity(context, authentication, process.env, qualified);
70
+ const pointer = digest(readTaskBytes(context, "authorization.json"));
71
+ const current = (index) => {
72
+ const now = currentWorkflowState(context, index);
73
+ if (now.finalization?.entry.sha256 !== finalization.entry.sha256)
74
+ invalid("Finalization changed during prepared-approval continuation.");
75
+ };
76
+ if (pointer === approval.value.pointer_sha256 &&
77
+ captureFoundryInput(finalRows).sha256 !== original.sha256) {
78
+ const derived = await prepareDerivedFoundryTaskAuthorization(context, qualified, identity, {
79
+ approvedInputFile: inputFile,
80
+ derivedInputFile: finalRows,
81
+ });
82
+ await registerFoundryTaskAuthorization(context, identity, {
83
+ inputFile: finalRows,
84
+ grant: derived.grant,
85
+ evidence: derived.evidence,
86
+ expectedPreviousSha256: derived.expected_previous_sha256,
87
+ validateCurrent: (_, index) => current(index),
88
+ }, qualified);
89
+ }
90
+ const authorization = await loadFoundryTaskAuthorization(context, identity, finalRows, qualified);
91
+ const ancestor = JSON.parse(readTaskBytes(context, `evidence/authorizations/${String(approval.value.authorization_sha256)}/grant.json`).toString("utf8"));
92
+ const validated = validateTaskAuthorization(ancestor, {
93
+ ...authorization.binding,
94
+ input_scope_sha256: original.sha256,
95
+ });
96
+ if (validated.status !== "authorized" ||
97
+ validated.authorization.authorization_sha256 !== approval.value.authorization_sha256)
98
+ invalid("Original approval no longer validates for this scope.");
99
+ const expectedSha = original.sha256 === authorization.binding.input_scope_sha256
100
+ ? validated.authorization.authorization_sha256
101
+ : sha256Json(deriveTaskAuthorizationGrant(validated.authorization, authorization.binding));
102
+ if (expectedSha !== authorization.authorization_sha256)
103
+ invalid("Active grant is not the approved scope's exact derivation.");
104
+ await assertFoundryTaskInputLineage(context, inputFile, finalRows);
105
+ if (!ready) {
106
+ // An unchanged bound input cannot make progress by repeating finalization.
107
+ if (finalization.value.approval_authorization_sha256 === authorization.authorization_sha256)
108
+ return finalization.value;
109
+ return finalizeFoundryWorkflow(context, qualified, entries, authentication, {
110
+ sourceSha256: approval.entry.sha256,
111
+ authorizationSha256: authorization.authorization_sha256,
112
+ datasetType,
113
+ inputFile: finalRows,
114
+ }, executionProgress);
115
+ }
116
+ const registration = {
117
+ authorization_sha256: authorization.authorization_sha256,
118
+ pointer_sha256: digest(readTaskBytes(context, "authorization.json")),
119
+ };
120
+ return recordFoundryWorkflowAuthorization(context, qualified, identity, authorization, authentication, {
121
+ inputFile: finalRows,
122
+ approvedInputFile: inputFile,
123
+ scope,
124
+ finalizationSha256: finalization.entry.sha256,
125
+ datasetType,
126
+ inputKind: "final_rows",
127
+ registration,
128
+ submissionSha256: String(approval.value.submission_sha256),
129
+ validateCurrent: current,
130
+ operationOptions: {
131
+ preparation_approval: approval.entry.sha256,
132
+ finalization: finalization.entry.sha256,
133
+ authorization: authorization.authorization_sha256,
134
+ },
135
+ });
136
+ }
@@ -0,0 +1,3 @@
1
+ import { type FoundryRuntimeContext } from "./foundry-runtime-context.ts";
2
+ import { type QualifiedFoundryRuntime } from "./foundry-runtime-qualification.ts";
3
+ export declare function assessFoundryWorkflowRows(context: FoundryRuntimeContext, qualified: QualifiedFoundryRuntime, rowsReport: string, contextReports: readonly string[], identityReport?: string): Promise<import("./foundry-task-types.ts").JsonRecord>;
@@ -0,0 +1,231 @@
1
+ import fs from "node:fs";
2
+ import path from "node:path";
3
+ import { FoundryContextError, readFoundryInput, resolveFoundryAsset, resolveFoundryOutput, captureFoundryInput, } from "./foundry-runtime-context.js";
4
+ import { assertQualifiedFoundryRuntime, } from "./foundry-runtime-qualification.js";
5
+ import { copyFoundryIsolatedExecutable } from "./foundry-runtime-environment.js";
6
+ import { createFoundryIsolatedChildEnvironment } from "./foundry-runtime-environment.js";
7
+ import { runFoundryTaskOperation } from "./foundry-task-store.js";
8
+ import { runTidasRowsValidation } from "./tidas-adapter.js";
9
+ import { runDatasetCurationGate } from "./import-curation/curation-gate.js";
10
+ import { runDatasetAuthoringTaskBuild } from "./import-curation/authoring-packages.js";
11
+ import { routeFoundryDecisionAction } from "./foundry-decision-routing.js";
12
+ import { prepareFoundryDecisionWork } from "./foundry-workflow-decisions.js";
13
+ import { createWorkflowStageDirectory, createWorkflowDirectory, registerWorkflowStageFiles, runWorkflowLocalCli, } from "./foundry-workflow-io.js";
14
+ function record(value) {
15
+ if (!value || typeof value !== "object" || Array.isArray(value))
16
+ throw new FoundryContextError("workflow_report_invalid", "Stage metadata must be an object.");
17
+ return value;
18
+ }
19
+ export function assessFoundryWorkflowRows(context, qualified, rowsReport, contextReports, identityReport) {
20
+ assertQualifiedFoundryRuntime(context, qualified);
21
+ resolveFoundryAsset(context, "specs/prewrite-content-policy.json");
22
+ resolveFoundryAsset(context, "specs/import-profiles.json");
23
+ return runFoundryTaskOperation(context, {
24
+ command: "dataset-workflow-assessment",
25
+ options: {
26
+ rows_report: rowsReport,
27
+ context_reports: contextReports,
28
+ identity_report: identityReport ?? null,
29
+ },
30
+ }, (operation) => {
31
+ for (const input of context.inputs)
32
+ readFoundryInput(context, input.path);
33
+ const rows = record(JSON.parse(readFoundryInput(context, rowsReport).toString("utf8")));
34
+ if (rows.schema !== "tiangong-foundry.rows-stage.v1" || !Array.isArray(rows.sets))
35
+ throw new FoundryContextError("workflow_rows_invalid", "Select the current registered row sets.");
36
+ const identity = identityReport
37
+ ? record(JSON.parse(readFoundryInput(context, identityReport).toString("utf8")))
38
+ : null;
39
+ if (identity &&
40
+ (identity.status !== "completed" ||
41
+ identity.rows_report !== rowsReport ||
42
+ !Array.isArray(identity.sets)))
43
+ throw new FoundryContextError("workflow_identity_invalid", "Identity preflight must bind these current rows.");
44
+ const contracts = new Map();
45
+ const retainedReports = (key) => {
46
+ const value = rows[key] ?? [];
47
+ if (!Array.isArray(value) || value.some((file) => typeof file !== "string"))
48
+ throw new FoundryContextError("workflow_rows_invalid", "Retained identity reports are invalid.");
49
+ return value.map((file) => {
50
+ readFoundryInput(context, file);
51
+ return String(file);
52
+ });
53
+ };
54
+ const identityApplyReports = retainedReports("identity_reports");
55
+ const identityRewriteReports = retainedReports("identity_rewrite_reports").map((file) => record(JSON.parse(readFoundryInput(context, file).toString("utf8"))));
56
+ for (const file of contextReports) {
57
+ const value = record(JSON.parse(readFoundryInput(context, file).toString("utf8")));
58
+ if (value.status !== "completed" || typeof value.type !== "string")
59
+ throw new FoundryContextError("workflow_context_invalid", "A contract pack is incomplete.");
60
+ contracts.set(value.type, record(value.files));
61
+ }
62
+ const output = createWorkflowStageDirectory(context, operation, "assessment");
63
+ fs.mkdirSync(resolveFoundryOutput(context, "tmp"), { recursive: true, mode: 0o700 });
64
+ const temporary = createWorkflowDirectory(context, path.join(context.tempRoot, "assessment-"));
65
+ try {
66
+ const executable = path.join(temporary, path.basename(qualified.tidas.executable_path));
67
+ copyFoundryIsolatedExecutable(qualified.tidas.executable_path, executable);
68
+ const actual = captureFoundryInput(executable), expected = qualified.tidas.expectation.executable;
69
+ if (actual.bytes !== expected.bytes || actual.sha256 !== expected.sha256)
70
+ throw new FoundryContextError("runtime_tidas_unqualified", "Selected native bytes changed.");
71
+ const environment = createFoundryIsolatedChildEnvironment({ tempRoot: temporary });
72
+ const selectedSets = rows.sets.map(record);
73
+ const processes = selectedSets.find((set) => set.type === "process");
74
+ let queueDir;
75
+ if (processes) {
76
+ if (typeof processes.file !== "string")
77
+ throw new FoundryContextError("workflow_rows_invalid", "Process rows are missing.");
78
+ queueDir = path.join(output, "queue");
79
+ const args = [
80
+ "dataset",
81
+ "curation-queue",
82
+ "build",
83
+ "--processes",
84
+ processes.file,
85
+ "--out-dir",
86
+ queueDir,
87
+ "--json",
88
+ ];
89
+ for (const set of selectedSets) {
90
+ if (typeof set.file !== "string")
91
+ throw new FoundryContextError("workflow_rows_invalid", "A row set file is missing.");
92
+ readFoundryInput(context, set.file);
93
+ if (set.type === "flow")
94
+ args.push("--flows", set.file);
95
+ else if (["contact", "source", "unitgroup", "flowproperty"].includes(String(set.type)))
96
+ args.push("--support", set.file);
97
+ }
98
+ runWorkflowLocalCli(context, qualified, temporary, args);
99
+ }
100
+ const assessed = [];
101
+ for (const candidate of rows.sets) {
102
+ const set = record(candidate);
103
+ if (typeof set.type !== "string" ||
104
+ typeof set.file !== "string" ||
105
+ !contracts.has(set.type))
106
+ throw new FoundryContextError("workflow_context_required", "Every row set needs its matching contract pack.");
107
+ readFoundryInput(context, set.file);
108
+ const contract = contracts.get(set.type);
109
+ const contractPath = (key) => {
110
+ const file = contract[key];
111
+ if (file === null || file === undefined)
112
+ return null;
113
+ if (typeof file !== "string")
114
+ throw new FoundryContextError("workflow_context_invalid", "Contract file reference is invalid.");
115
+ readFoundryInput(context, file);
116
+ return file;
117
+ };
118
+ const schema = runTidasRowsValidation({
119
+ repoRoot: context.assetRoot,
120
+ options: {
121
+ tidasBin: executable,
122
+ rowsFile: set.file,
123
+ type: set.type,
124
+ outDir: path.join(output, set.type, "schema"),
125
+ },
126
+ environment,
127
+ });
128
+ if (typeof schema.report_file !== "string")
129
+ throw new FoundryContextError("workflow_schema_failed", "Native validation returned no compatible report.");
130
+ const qaDir = path.join(output, set.type, "qa");
131
+ let qaReport;
132
+ if (["flow", "process", "lifecyclemodel"].includes(set.type)) {
133
+ const qa = runWorkflowLocalCli(context, qualified, temporary, [
134
+ "qa",
135
+ set.type,
136
+ "--rows-file",
137
+ set.file,
138
+ "--out-dir",
139
+ qaDir,
140
+ "--json",
141
+ ]);
142
+ const file = record(qa.files).report;
143
+ if (typeof file !== "string")
144
+ throw new FoundryContextError("workflow_qa_failed", "QA returned no report file.");
145
+ qaReport = file;
146
+ }
147
+ else {
148
+ qaReport = path.join(qaDir, "qa-not-required.json");
149
+ operation.writeJson(qaReport, {
150
+ status: "not_required_for_support_rows",
151
+ dataset_type: set.type,
152
+ });
153
+ }
154
+ const gateDir = path.join(output, set.type, "curation");
155
+ const rewrite = identityRewriteReports.findLast((report) => report.dataset_type === set.type);
156
+ const gate = runDatasetCurationGate({
157
+ repoRoot: context.assetRoot,
158
+ routeAction: routeFoundryDecisionAction,
159
+ requireIdentityPreflight: Boolean(identity),
160
+ options: {
161
+ type: set.type,
162
+ rowsFile: set.file,
163
+ schemaReport: schema.report_file,
164
+ qaReport,
165
+ outDir: gateDir,
166
+ includeExecutionCommands: false,
167
+ profile: operation.job.target_profile,
168
+ queueDir,
169
+ requireQueueContext: Boolean(queueDir) && ["flow", "process"].includes(set.type),
170
+ schemaFile: contractPath("schema"),
171
+ yamlFile: contractPath("methodology"),
172
+ rulesetFile: contractPath("ruleset"),
173
+ identityPreflightIndex: identity?.index,
174
+ identityDecisionApplyReport: identityApplyReports,
175
+ identityReferenceRewrites: rewrite?.rewrite_file,
176
+ identityReferenceRewriteStatus: rewrite?.status,
177
+ identityReferenceRewriteInputRows: rewrite?.rows_file,
178
+ identityReferenceRewriteOutputRows: rewrite?.output_rows_file,
179
+ },
180
+ });
181
+ const gateReport = path.join(gateDir, "dataset-curation-gate-report.json");
182
+ const decisionWork = prepareFoundryDecisionWork(context, qualified, temporary, {
183
+ type: set.type,
184
+ rows: set.file,
185
+ gateReport,
186
+ contract,
187
+ outDir: path.join(output, set.type, "decisions"),
188
+ });
189
+ const authoringDir = path.join(output, set.type, "authoring");
190
+ const authoring = runDatasetAuthoringTaskBuild({
191
+ repoRoot: context.assetRoot,
192
+ options: {
193
+ curationGateReport: gateReport,
194
+ outDir: authoringDir,
195
+ includeExecutionCommands: false,
196
+ },
197
+ });
198
+ assessed.push({
199
+ type: set.type,
200
+ rows: set.file,
201
+ schema_report: schema.report_file,
202
+ qa_report: qaReport,
203
+ curation_report: gateReport,
204
+ curation_status: gate.status,
205
+ curation_counts: gate.counts,
206
+ authoring_manifest: path.join(authoringDir, "authoring-task-manifest.json"),
207
+ authoring_status: authoring.status,
208
+ authoring_counts: authoring.counts,
209
+ decisions: decisionWork,
210
+ });
211
+ }
212
+ for (const input of context.inputs)
213
+ readFoundryInput(context, input.path);
214
+ assertQualifiedFoundryRuntime(context, qualified);
215
+ registerWorkflowStageFiles(context, operation, output);
216
+ const report = {
217
+ schema: "tiangong-foundry.assessment-stage.v1",
218
+ status: "completed",
219
+ owner_base: context.assetRoot,
220
+ rows_report: rowsReport,
221
+ identity_report: identityReport ?? null,
222
+ sets: assessed,
223
+ };
224
+ operation.writeJson(path.join(output, "foundry-assessment.json"), report);
225
+ return report;
226
+ }
227
+ finally {
228
+ fs.rmSync(temporary, { recursive: true, force: true });
229
+ }
230
+ });
231
+ }
@@ -0,0 +1,22 @@
1
+ import { type SelectedAuthorizationInput } from "./foundry-authorization-input.ts";
2
+ import { type FoundryRuntimeContext } from "./foundry-runtime-context.ts";
3
+ import { type QualifiedFoundryRuntime } from "./foundry-runtime-qualification.ts";
4
+ import { type FoundryAuthentication, type VerifiedFoundryIdentity } from "./foundry-runtime-identity.ts";
5
+ import type { ValidatedTaskAuthorization } from "./task-authorization.ts";
6
+ import type { ArtifactEntry } from "./foundry-task-types.ts";
7
+ export declare function authorizeFoundryWorkflow(context: FoundryRuntimeContext, qualified: QualifiedFoundryRuntime, entries: readonly ArtifactEntry[], selected: SelectedAuthorizationInput, authentication?: FoundryAuthentication): Promise<import("./foundry-task-types.ts").JsonRecord>;
8
+ export declare function recordFoundryWorkflowAuthorization(context: FoundryRuntimeContext, qualified: QualifiedFoundryRuntime, identity: VerifiedFoundryIdentity, authorization: ValidatedTaskAuthorization, authentication: FoundryAuthentication, request: {
9
+ inputFile: string;
10
+ approvedInputFile: string;
11
+ scope: Record<string, unknown>;
12
+ finalizationSha256: string;
13
+ datasetType: string;
14
+ inputKind: "current_rows" | "final_rows";
15
+ registration: {
16
+ authorization_sha256: string;
17
+ pointer_sha256: string;
18
+ };
19
+ submissionSha256: string;
20
+ operationOptions: Record<string, unknown>;
21
+ validateCurrent: (index: readonly ArtifactEntry[]) => void;
22
+ }): Promise<import("./foundry-task-types.ts").JsonRecord>;
@@ -0,0 +1,174 @@
1
+ import fs from "node:fs";
2
+ import path from "node:path";
3
+ import { randomUUID } from "node:crypto";
4
+ import { assertSelectedAuthorizationInput, } from "./foundry-authorization-input.js";
5
+ import { readSelectedSemanticBytes } from "./foundry-semantic-input.js";
6
+ import { FoundryContextError, readFoundryInput, captureFoundryInput, resolveFoundryOutput, } from "./foundry-runtime-context.js";
7
+ import { assertQualifiedFoundryRuntime, } from "./foundry-runtime-qualification.js";
8
+ import { currentWorkflowState, workflowObject } from "./foundry-workflow-state.js";
9
+ import { runFoundryTaskOperation } from "./foundry-task-store.js";
10
+ import { verifyFoundryRuntimeIdentity, } from "./foundry-runtime-identity.js";
11
+ import { registerFoundryTaskAuthorization, loadFoundryTaskAuthorization, } from "./foundry-task-authorization.js";
12
+ import { createFoundryAuthenticationEnvironment } from "./foundry-authentication-environment.js";
13
+ import { createFoundryFinalizeOwners } from "./foundry-finalize-owners.js";
14
+ import { createFoundryExecutionCapsule } from "./foundry-execution-admission.js";
15
+ import { registerWorkflowStageFiles } from "./foundry-workflow-io.js";
16
+ import { createFoundryCommandSpec, createFileArtifactFact } from "./foundry-command-spec.js";
17
+ import { parseFoundryCommandSpec } from "@tiangong-lca/cli/command-spec";
18
+ export async function authorizeFoundryWorkflow(context, qualified, entries, selected, authentication = { mode: "oauth" }) {
19
+ assertSelectedAuthorizationInput(selected);
20
+ assertQualifiedFoundryRuntime(context, qualified);
21
+ const state = currentWorkflowState(context, entries), spec = selected.spec;
22
+ const finalization = state.finalization;
23
+ if (state.authorization?.value.submission_sha256 === selected.descriptor.sha256)
24
+ return state.authorization.value;
25
+ if (!finalization || finalization.entry.sha256 !== spec.finalization_sha256)
26
+ throw new FoundryContextError("authorization_finalization_mismatch", "Approval must select the current finalization report.");
27
+ const scope = finalization.value.sets
28
+ .map(workflowObject)
29
+ .find((item) => item.type === spec.dataset_type);
30
+ if (!scope)
31
+ throw new FoundryContextError("authorization_scope_mismatch", "Approval dataset type is not in this finalization.");
32
+ const inputFile = spec.input_kind === "final_rows" ? scope.final_rows : scope.input_rows;
33
+ if (typeof inputFile !== "string" || captureFoundryInput(inputFile).sha256 !== spec.input_sha256)
34
+ throw new FoundryContextError("authorization_input_mismatch", "Approval input must match the exact current scope bytes.");
35
+ readFoundryInput(context, inputFile);
36
+ if (spec.input_kind === "final_rows" && scope.status !== "ready_for_remote_write")
37
+ throw new FoundryContextError("authorization_scope_not_ready", "Final-row approval requires a ready owner scope.");
38
+ const identity = verifyFoundryRuntimeIdentity(context, authentication, process.env, qualified);
39
+ const grant = JSON.parse(readSelectedSemanticBytes(selected.grant).toString("utf8"));
40
+ const current = (index) => {
41
+ assertSelectedAuthorizationInput(selected);
42
+ if (currentWorkflowState(context, index).finalization?.entry.sha256 !== finalization.entry.sha256)
43
+ throw new FoundryContextError("authorization_finalization_changed", "Finalization changed before approval activation.");
44
+ };
45
+ const registration = await registerFoundryTaskAuthorization(context, identity, {
46
+ inputFile,
47
+ grant,
48
+ evidence: spec.evidence.map((item, index) => ({
49
+ id: item.id,
50
+ kind: item.kind,
51
+ file: selected.evidence[index],
52
+ })),
53
+ expectedPreviousSha256: spec.expected_previous_sha256,
54
+ validateCurrent: (_, index) => current(index),
55
+ }, qualified);
56
+ const authorization = await loadFoundryTaskAuthorization(context, identity, inputFile, qualified);
57
+ return recordFoundryWorkflowAuthorization(context, qualified, identity, authorization, authentication, {
58
+ inputFile,
59
+ approvedInputFile: inputFile,
60
+ scope,
61
+ finalizationSha256: spec.finalization_sha256,
62
+ datasetType: spec.dataset_type,
63
+ inputKind: spec.input_kind,
64
+ registration,
65
+ submissionSha256: selected.descriptor.sha256,
66
+ validateCurrent: current,
67
+ operationOptions: {
68
+ submission: selected.descriptor,
69
+ grant: selected.grant,
70
+ evidence: selected.evidence,
71
+ finalization: spec.finalization_sha256,
72
+ authorization: registration.authorization_sha256,
73
+ },
74
+ });
75
+ }
76
+ export async function recordFoundryWorkflowAuthorization(context, qualified, identity, authorization, authentication, request) {
77
+ const { inputFile, scope, registration } = request;
78
+ const nonce = randomUUID(), output = resolveFoundryOutput(context, `outputs/authorization/${nonce}`);
79
+ const temporary = resolveFoundryOutput(context, `tmp/authorization-${nonce}`);
80
+ fs.mkdirSync(output, { recursive: true, mode: 0o700 });
81
+ fs.mkdirSync(temporary, { recursive: true, mode: 0o700 });
82
+ let capsule = null;
83
+ let handoff = null;
84
+ const environment = createFoundryAuthenticationEnvironment(authentication, context.accountIntent?.sessionReference, process.env);
85
+ environment.FOUNDRY_ACCOUNT_MODE = context.accountIntent?.accountMode ?? "ordinary";
86
+ try {
87
+ if (request.inputKind === "final_rows") {
88
+ environment.FOUNDRY_VERIFIED_PROJECT_REF = context.accountIntent.projectRef;
89
+ environment.FOUNDRY_VERIFIED_USER_ID = context.accountIntent.userId;
90
+ const owners = createFoundryFinalizeOwners(context, qualified, temporary, {
91
+ environment,
92
+ tidasExecutable: qualified.tidas.executable_path,
93
+ });
94
+ handoff = workflowObject(owners.handoff.runDatasetCommitHandoffPlan({
95
+ finalizeReport: scope.report,
96
+ rowsFile: inputFile,
97
+ mutationManifest: scope.mutation_manifest,
98
+ outDir: path.join(output, "handoff"),
99
+ targetUserId: context.accountIntent.userId,
100
+ accountMode: context.accountIntent?.accountMode ?? "ordinary",
101
+ taskAuthorization: authorization,
102
+ taskAuthorizationBinding: authorization.binding,
103
+ profile: authorization.binding.profile_id,
104
+ }));
105
+ const commands = workflowObject(handoff.commands);
106
+ for (const key of ["commit", "post_write_verify"]) {
107
+ if (!commands[key])
108
+ continue;
109
+ const command = parseFoundryCommandSpec(commands[key]);
110
+ commands[key] = createFoundryCommandSpec({
111
+ executable: command.executable,
112
+ argv: [...command.argv],
113
+ binding: {
114
+ artifacts: [
115
+ createFileArtifactFact({ role: "final_rows", path: inputFile, filePath: inputFile }),
116
+ ],
117
+ },
118
+ });
119
+ }
120
+ fs.writeFileSync(path.join(output, "handoff", "dataset-commit-handoff-plan.json"), JSON.stringify(handoff, null, 2) + "\n");
121
+ const command = commands.commit;
122
+ if (command) {
123
+ const requiredActions = authorization.allowed_actions.filter((action) => request.datasetType === "flow"
124
+ ? action === "elementary_flow_write" || action === "elementary_flow_create_new"
125
+ : ["unitgroup", "flowproperty"].includes(request.datasetType)
126
+ ? action === `${request.datasetType}_write` ||
127
+ action === "canonical_support_local_mint"
128
+ : false);
129
+ capsule = await createFoundryExecutionCapsule(context, qualified, identity, {
130
+ command: "dataset-commit-handoff-plan",
131
+ approvedInputFile: request.approvedInputFile,
132
+ finalRowsFile: inputFile,
133
+ commandSpec: command,
134
+ requiredActions,
135
+ requiredQaWaivers: authorization.qa_waivers
136
+ .filter((item) => item.dataset_type === request.datasetType)
137
+ .map((item) => item.code),
138
+ });
139
+ }
140
+ }
141
+ return await runFoundryTaskOperation(context, {
142
+ command: "dataset-workflow-authorization",
143
+ options: request.operationOptions,
144
+ validateCurrent: request.validateCurrent,
145
+ }, (operation) => {
146
+ registerWorkflowStageFiles(context, operation, output);
147
+ const result = {
148
+ schema: "tiangong-foundry.authorization-stage.v1",
149
+ status: capsule
150
+ ? "sealed"
151
+ : request.inputKind === "current_rows"
152
+ ? "authorized_current_rows"
153
+ : "handoff_blocked",
154
+ finalization_sha256: request.finalizationSha256,
155
+ dataset_type: request.datasetType,
156
+ input_kind: request.inputKind,
157
+ input: captureFoundryInput(inputFile),
158
+ authorization_sha256: registration.authorization_sha256,
159
+ pointer_sha256: registration.pointer_sha256,
160
+ expires_at_utc: authorization.expires_at_utc,
161
+ allowed_actions: [...authorization.allowed_actions],
162
+ capsule,
163
+ handoff,
164
+ submission_sha256: request.submissionSha256,
165
+ };
166
+ operation.writeJson(path.join(output, "foundry-authorization.json"), result);
167
+ return result;
168
+ });
169
+ }
170
+ finally {
171
+ delete environment.TIANGONG_LCA_ACCESS_TOKEN;
172
+ fs.rmSync(temporary, { recursive: true, force: true });
173
+ }
174
+ }
@@ -0,0 +1,3 @@
1
+ import { type FoundryRuntimeContext } from "./foundry-runtime-context.ts";
2
+ import { type QualifiedFoundryRuntime } from "./foundry-runtime-qualification.ts";
3
+ export declare function prepareFoundryWorkflowContext(context: FoundryRuntimeContext, qualified: QualifiedFoundryRuntime, selectedTypes: readonly string[]): Promise<import("./foundry-task-types.ts").JsonRecord>;