@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,449 @@
1
+ import { createHash, randomUUID } from "node:crypto";
2
+ import fs from "node:fs";
3
+ import path from "node:path";
4
+ import { withBatchRunLock } from "@tiangong-lca/cli/batch";
5
+ import { assertFoundryRuntimeContext, assertFoundryWorkspaceWrite, assertPendingFoundryTaskIntent, FoundryContextError, resolveFoundryOutput, } from "./foundry-runtime-context.js";
6
+ import { parseFoundryTaskStartSpec, taskStartSpecFingerprint, } from "./foundry-task-start-spec.js";
7
+ import { sha256Json } from "./identity-preflight-proof.js";
8
+ export const FOUNDRY_FACADE_REQUEST_INDEX_SCHEMA = "tiangong-foundry.facade-request-index.v1";
9
+ export const FOUNDRY_FACADE_TASK_POINTER_SCHEMA = "tiangong-foundry.facade-task-pointer.v1";
10
+ const shaPattern = /^[0-9a-f]{64}$/u;
11
+ const taskIdPattern = /^task-[0-9a-f]{64}-r\d{4}$/u;
12
+ const maxIndexBytes = 8 * 1024 * 1024;
13
+ const maxRevisions = 1_000;
14
+ function fail(code, message) {
15
+ throw new FoundryContextError(code, message);
16
+ }
17
+ function object(value) {
18
+ if (!value || typeof value !== "object" || Array.isArray(value))
19
+ fail("facade_request_invalid", "Facade request state must be a JSON object.");
20
+ return value;
21
+ }
22
+ function exact(value, keys) {
23
+ if (Object.keys(value).length !== keys.length || keys.some((key) => !Object.hasOwn(value, key)))
24
+ fail("facade_request_invalid", "Facade request state has missing or unsupported fields.");
25
+ }
26
+ function timestamp(value) {
27
+ return (typeof value === "string" &&
28
+ Number.isFinite(Date.parse(value)) &&
29
+ new Date(value).toISOString() === value);
30
+ }
31
+ function content(value) {
32
+ return Buffer.from(`${JSON.stringify(value, null, 2)}\n`);
33
+ }
34
+ function contentFact(value) {
35
+ const item = object(value);
36
+ exact(item, ["path", "bytes", "sha256"]);
37
+ if (typeof item.path !== "string" ||
38
+ !path.isAbsolute(item.path) ||
39
+ !Number.isSafeInteger(item.bytes) ||
40
+ Number(item.bytes) < 0 ||
41
+ typeof item.sha256 !== "string" ||
42
+ !shaPattern.test(item.sha256))
43
+ fail("facade_request_invalid", "Facade input facts require canonical path, bytes and hash.");
44
+ return { path: item.path, bytes: Number(item.bytes), sha256: item.sha256 };
45
+ }
46
+ function requestPath(context, requestSha256) {
47
+ if (!shaPattern.test(requestSha256))
48
+ fail("facade_request_invalid", "Facade request identity must be a SHA-256 digest.");
49
+ return resolveFoundryOutput(context, `facade-requests/${requestSha256}.json`, "state");
50
+ }
51
+ function taskPointerPath(context, taskId) {
52
+ if (!taskIdPattern.test(taskId))
53
+ fail("task_id_invalid", "Facade task id has an unsupported shape.");
54
+ return resolveFoundryOutput(context, `facade-tasks/${taskId}.json`, "state");
55
+ }
56
+ function readBounded(file, maxBytes = maxIndexBytes) {
57
+ let fd;
58
+ try {
59
+ fd = fs.openSync(file, fs.constants.O_RDONLY | fs.constants.O_NOFOLLOW);
60
+ }
61
+ catch {
62
+ return fail("facade_request_invalid", "Facade request state must be an existing regular file.");
63
+ }
64
+ try {
65
+ const before = fs.fstatSync(fd, { bigint: true });
66
+ if (!before.isFile() || before.size > BigInt(maxBytes))
67
+ fail("facade_request_invalid", "Facade request state must be a bounded regular file.");
68
+ const bytes = fs.readFileSync(fd);
69
+ const after = fs.fstatSync(fd, { bigint: true });
70
+ if (bytes.length > maxBytes ||
71
+ before.dev !== after.dev ||
72
+ before.ino !== after.ino ||
73
+ before.size !== after.size ||
74
+ before.mtimeNs !== after.mtimeNs ||
75
+ BigInt(bytes.length) !== after.size)
76
+ fail("facade_request_invalid", "Facade request state changed while it was read.");
77
+ return bytes;
78
+ }
79
+ finally {
80
+ fs.closeSync(fd);
81
+ }
82
+ }
83
+ function revision(value, expected) {
84
+ const item = object(value);
85
+ exact(item, [
86
+ "revision",
87
+ "task_id",
88
+ "predecessor_task_id",
89
+ "fingerprint_sha256",
90
+ "spec_source",
91
+ "spec",
92
+ "inputs",
93
+ "created_at_utc",
94
+ "record_sha256",
95
+ ]);
96
+ const { record_sha256: recorded, ...unsigned } = item;
97
+ if (item.revision !== expected ||
98
+ typeof item.task_id !== "string" ||
99
+ !taskIdPattern.test(item.task_id) ||
100
+ (item.predecessor_task_id !== null &&
101
+ (typeof item.predecessor_task_id !== "string" ||
102
+ !taskIdPattern.test(item.predecessor_task_id))) ||
103
+ typeof item.fingerprint_sha256 !== "string" ||
104
+ !shaPattern.test(item.fingerprint_sha256) ||
105
+ typeof recorded !== "string" ||
106
+ recorded !== sha256Json(unsigned) ||
107
+ !Array.isArray(item.inputs) ||
108
+ !item.inputs.length ||
109
+ !timestamp(item.created_at_utc))
110
+ fail("facade_request_invalid", "Facade revision sequence or content binding changed.");
111
+ const parsedSpec = parseFoundryTaskStartSpec(item.spec);
112
+ const inputs = item.inputs.map(contentFact);
113
+ if (taskStartSpecFingerprint(parsedSpec, inputs) !== item.fingerprint_sha256 ||
114
+ (expected === 1 ? item.predecessor_task_id !== null : item.predecessor_task_id === null))
115
+ fail("facade_request_invalid", "Facade revision fingerprint or predecessor is invalid.");
116
+ return Object.freeze({
117
+ revision: expected,
118
+ task_id: item.task_id,
119
+ predecessor_task_id: item.predecessor_task_id,
120
+ fingerprint_sha256: item.fingerprint_sha256,
121
+ spec_source: Object.freeze(contentFact(item.spec_source)),
122
+ spec: parsedSpec,
123
+ inputs: Object.freeze(inputs.map((fact) => Object.freeze(fact))),
124
+ created_at_utc: item.created_at_utc,
125
+ record_sha256: recorded,
126
+ });
127
+ }
128
+ function readRequest(context, requestSha256) {
129
+ const file = requestPath(context, requestSha256);
130
+ if (!fs.existsSync(file))
131
+ return { index: null, bytes: null };
132
+ const bytes = readBounded(file);
133
+ let raw;
134
+ try {
135
+ raw = object(JSON.parse(bytes.toString("utf8")));
136
+ }
137
+ catch (error) {
138
+ if (error instanceof FoundryContextError)
139
+ throw error;
140
+ return fail("facade_request_invalid", "Facade request state is incomplete JSON.");
141
+ }
142
+ exact(raw, [
143
+ "schema",
144
+ "workspace_id",
145
+ "request_id",
146
+ "request_sha256",
147
+ "revisions",
148
+ "index_sha256",
149
+ ]);
150
+ const { index_sha256: checksum, ...unsigned } = raw;
151
+ if (raw.schema !== FOUNDRY_FACADE_REQUEST_INDEX_SCHEMA ||
152
+ raw.workspace_id !== context.workspaceId ||
153
+ raw.request_sha256 !== requestSha256 ||
154
+ typeof raw.request_id !== "string" ||
155
+ !Array.isArray(raw.revisions) ||
156
+ !raw.revisions.length ||
157
+ raw.revisions.length > maxRevisions ||
158
+ checksum !== sha256Json(unsigned))
159
+ fail("facade_request_invalid", "Facade request index identity or checksum changed.");
160
+ const revisions = raw.revisions.map((item, index) => revision(item, index + 1));
161
+ for (let index = 0; index < revisions.length; index += 1) {
162
+ const entry = revisions[index];
163
+ const expectedTaskId = `task-${requestSha256}-r${String(index + 1).padStart(4, "0")}`;
164
+ if (entry.task_id !== expectedTaskId ||
165
+ entry.predecessor_task_id !== (revisions[index - 1]?.task_id ?? null))
166
+ fail("facade_request_invalid", "Facade task ids do not match revision ancestry.");
167
+ }
168
+ return {
169
+ index: Object.freeze({
170
+ schema: FOUNDRY_FACADE_REQUEST_INDEX_SCHEMA,
171
+ workspace_id: raw.workspace_id,
172
+ request_id: raw.request_id,
173
+ request_sha256: raw.request_sha256,
174
+ revisions: Object.freeze(revisions),
175
+ index_sha256: checksum,
176
+ }),
177
+ bytes,
178
+ };
179
+ }
180
+ function writeOnce(file, bytes) {
181
+ fs.mkdirSync(path.dirname(file), { recursive: true, mode: 0o700 });
182
+ if (fs.existsSync(file)) {
183
+ if (!readBounded(file).equals(bytes))
184
+ fail("facade_request_conflict", "Immutable facade state already has different bytes.");
185
+ return;
186
+ }
187
+ const temp = `${file}.${randomUUID()}.tmp`;
188
+ const fd = fs.openSync(temp, "wx", 0o600);
189
+ try {
190
+ fs.writeFileSync(fd, bytes);
191
+ fs.fsyncSync(fd);
192
+ }
193
+ finally {
194
+ fs.closeSync(fd);
195
+ }
196
+ try {
197
+ fs.linkSync(temp, file);
198
+ }
199
+ catch (error) {
200
+ if (error.code !== "EEXIST")
201
+ throw error;
202
+ if (!readBounded(file).equals(bytes))
203
+ fail("facade_request_conflict", "Concurrent facade state has different bytes.");
204
+ }
205
+ finally {
206
+ if (fs.existsSync(temp))
207
+ fs.unlinkSync(temp);
208
+ }
209
+ }
210
+ function replaceIndex(file, bytes, before) {
211
+ if (bytes.length > maxIndexBytes)
212
+ fail("facade_request_limit", "Facade request history exceeds its bounded store.");
213
+ fs.mkdirSync(path.dirname(file), { recursive: true, mode: 0o700 });
214
+ const temp = `${file}.${randomUUID()}.tmp`;
215
+ const fd = fs.openSync(temp, "wx", 0o600);
216
+ try {
217
+ fs.writeFileSync(fd, bytes);
218
+ fs.fsyncSync(fd);
219
+ }
220
+ finally {
221
+ fs.closeSync(fd);
222
+ }
223
+ try {
224
+ const current = fs.existsSync(file) ? readBounded(file) : null;
225
+ if ((current === null) !== (before === null) || (current && before && !current.equals(before)))
226
+ fail("facade_request_conflict", "Facade request index changed outside its lock.");
227
+ if (current)
228
+ fs.renameSync(temp, file);
229
+ else
230
+ fs.linkSync(temp, file);
231
+ }
232
+ finally {
233
+ if (fs.existsSync(temp))
234
+ fs.unlinkSync(temp);
235
+ }
236
+ }
237
+ function pointer(value, context) {
238
+ const item = object(value);
239
+ exact(item, [
240
+ "schema",
241
+ "workspace_id",
242
+ "task_id",
243
+ "request_sha256",
244
+ "revision",
245
+ "revision_sha256",
246
+ ]);
247
+ if (item.schema !== FOUNDRY_FACADE_TASK_POINTER_SCHEMA ||
248
+ item.workspace_id !== context.workspaceId ||
249
+ typeof item.task_id !== "string" ||
250
+ !taskIdPattern.test(item.task_id) ||
251
+ typeof item.request_sha256 !== "string" ||
252
+ !shaPattern.test(item.request_sha256) ||
253
+ !Number.isSafeInteger(item.revision) ||
254
+ Number(item.revision) < 1 ||
255
+ Number(item.revision) > maxRevisions ||
256
+ typeof item.revision_sha256 !== "string" ||
257
+ !shaPattern.test(item.revision_sha256))
258
+ fail("facade_task_pointer_invalid", "Facade task pointer is malformed.");
259
+ return item;
260
+ }
261
+ function requireUnattemptedPredecessors(context, predecessors) {
262
+ for (const predecessor of predecessors) {
263
+ const workspaces = path.join(context.controlRoot, "workspaces"), taskRoot = path.join(workspaces, predecessor.task_id), jobFile = path.join(taskRoot, "foundry-job.json");
264
+ try {
265
+ for (const directory of [context.controlRoot, workspaces, taskRoot]) {
266
+ const stat = fs.lstatSync(directory);
267
+ if (!stat.isDirectory() || stat.isSymbolicLink())
268
+ fail("facade_predecessor_history_invalid", "Predecessor task storage is missing or linked.");
269
+ }
270
+ const stat = fs.lstatSync(jobFile);
271
+ if (!stat.isFile() || stat.isSymbolicLink())
272
+ fail("facade_predecessor_history_invalid", "Predecessor job must remain a regular file.");
273
+ const jobBytes = readBounded(jobFile, 64 * 1024), job = object(JSON.parse(jobBytes.toString("utf8"))), publication = object(JSON.parse(readBounded(resolveFoundryOutput(context, `task-publications/${predecessor.task_id}.json`, "state"), 16 * 1024).toString("utf8")));
274
+ exact(publication, ["schema", "workspace_id", "task_id", "job_sha256"]);
275
+ if (job.schema !== "tiangong-foundry.job.v2" ||
276
+ job.workspace_id !== context.workspaceId ||
277
+ job.task_id !== predecessor.task_id ||
278
+ job.actor_id !== predecessor.spec.actor_id ||
279
+ job.request_id !== predecessor.spec.request_id ||
280
+ job.created_at_utc !== predecessor.created_at_utc ||
281
+ publication.schema !== "tiangong-foundry.task-publication.v1" ||
282
+ publication.workspace_id !== context.workspaceId ||
283
+ publication.task_id !== predecessor.task_id ||
284
+ publication.job_sha256 !== createHash("sha256").update(jobBytes).digest("hex"))
285
+ fail("facade_predecessor_history_invalid", "Predecessor publication and task identity differ.");
286
+ const attempts = path.join(taskRoot, "attempts");
287
+ let attemptStat;
288
+ try {
289
+ attemptStat = fs.lstatSync(attempts);
290
+ }
291
+ catch (error) {
292
+ if (error.code === "ENOENT")
293
+ continue;
294
+ throw error;
295
+ }
296
+ if (!attemptStat.isDirectory() || attemptStat.isSymbolicLink())
297
+ fail("facade_predecessor_history_invalid", "Predecessor attempts must remain a contained directory.");
298
+ const directory = fs.opendirSync(attempts);
299
+ try {
300
+ if (directory.readSync())
301
+ fail("facade_predecessor_readback_required", `Retained predecessor ${predecessor.task_id} has attempt evidence; use its original owner for status/readback before any revision can continue.`);
302
+ }
303
+ finally {
304
+ directory.closeSync();
305
+ }
306
+ }
307
+ catch (error) {
308
+ if (error instanceof FoundryContextError)
309
+ throw error;
310
+ fail("facade_predecessor_history_invalid", "Retained predecessor history is missing or invalid; restore or audit it before continuing.");
311
+ }
312
+ }
313
+ }
314
+ export async function registerFoundryFacadeTask(context, options) {
315
+ assertFoundryWorkspaceWrite(context);
316
+ if (!context.workspaceId || context.taskId)
317
+ fail("workspace_context_required", "Facade request registration requires one workspace context.");
318
+ const spec = parseFoundryTaskStartSpec(options.spec);
319
+ const fingerprint = taskStartSpecFingerprint(spec, options.inputs);
320
+ const requestSha256 = sha256Json({
321
+ workspace_id: context.workspaceId,
322
+ request_id: spec.request_id,
323
+ });
324
+ const lockPath = resolveFoundryOutput(context, `facade-request-locks/${requestSha256}.json`, "state");
325
+ return withBatchRunLock({
326
+ runPath: lockPath,
327
+ identity: {
328
+ schema: "tiangong-foundry.facade-request-lock.v1",
329
+ workspace_id: context.workspaceId,
330
+ request_sha256: requestSha256,
331
+ },
332
+ reason: "Foundry facade request revision",
333
+ }, () => {
334
+ const stored = readRequest(context, requestSha256);
335
+ if (stored.index && stored.index.request_id !== spec.request_id)
336
+ fail("facade_request_collision", "Facade request digest collides with another request id.");
337
+ const latest = stored.index?.revisions.at(-1) ?? null;
338
+ const revisionNumber = latest?.fingerprint_sha256 === fingerprint ? latest.revision : (latest?.revision ?? 0) + 1;
339
+ if (revisionNumber > maxRevisions)
340
+ fail("facade_request_limit", "Facade request has too many retained revisions.");
341
+ const taskId = `task-${requestSha256}-r${String(revisionNumber).padStart(4, "0")}`;
342
+ assertPendingFoundryTaskIntent(context, taskId, spec.request_id, spec.actor_id, fingerprint);
343
+ const predecessors = stored.index?.revisions.filter((entry) => entry.task_id !== taskId) ?? [];
344
+ requireUnattemptedPredecessors(context, predecessors);
345
+ let task;
346
+ try {
347
+ task = options.createOrLoad(taskId);
348
+ if (task.inputs_sha256 !== sha256Json(options.inputs))
349
+ throw new FoundryContextError("task_source_changed", "Registered task sources do not match this facade revision.");
350
+ }
351
+ catch (error) {
352
+ const taskStateExists = fs.existsSync(path.join(context.controlRoot, "workspaces", taskId)) ||
353
+ fs.existsSync(resolveFoundryOutput(context, `task-publications/${taskId}.json`, "state"));
354
+ if ((!latest || latest.fingerprint_sha256 !== fingerprint) &&
355
+ taskStateExists &&
356
+ error instanceof FoundryContextError &&
357
+ error.code.startsWith("task_"))
358
+ throw new FoundryContextError("facade_crash_recovery_conflict", `An interrupted start already registered ${taskId}; retry the original task-start spec to complete its request index before creating another revision.`);
359
+ throw error;
360
+ }
361
+ let selected = latest;
362
+ requireUnattemptedPredecessors(context, predecessors);
363
+ if (!latest || latest.fingerprint_sha256 !== fingerprint) {
364
+ const unsigned = {
365
+ revision: revisionNumber,
366
+ task_id: taskId,
367
+ predecessor_task_id: latest?.task_id ?? null,
368
+ fingerprint_sha256: fingerprint,
369
+ spec_source: { ...options.specSource },
370
+ spec,
371
+ inputs: options.inputs.map((fact) => ({ ...fact })),
372
+ created_at_utc: task.created_at_utc,
373
+ };
374
+ selected = revision({
375
+ ...unsigned,
376
+ record_sha256: sha256Json(unsigned),
377
+ }, revisionNumber);
378
+ const payload = {
379
+ schema: FOUNDRY_FACADE_REQUEST_INDEX_SCHEMA,
380
+ workspace_id: context.workspaceId,
381
+ request_id: spec.request_id,
382
+ request_sha256: requestSha256,
383
+ revisions: [...(stored.index?.revisions ?? []), selected],
384
+ };
385
+ replaceIndex(requestPath(context, requestSha256), content({ ...payload, index_sha256: sha256Json(payload) }), stored.bytes);
386
+ }
387
+ if (!selected)
388
+ return fail("facade_request_invalid", "Facade request has no task revision.");
389
+ const taskPointer = {
390
+ schema: FOUNDRY_FACADE_TASK_POINTER_SCHEMA,
391
+ workspace_id: context.workspaceId,
392
+ task_id: selected.task_id,
393
+ request_sha256: requestSha256,
394
+ revision: selected.revision,
395
+ revision_sha256: selected.record_sha256,
396
+ };
397
+ writeOnce(taskPointerPath(context, selected.task_id), content(taskPointer));
398
+ return Object.freeze({
399
+ request_sha256: requestSha256,
400
+ revision: selected.revision,
401
+ task_id: selected.task_id,
402
+ predecessor_task_id: selected.predecessor_task_id,
403
+ fingerprint_sha256: selected.fingerprint_sha256,
404
+ spec_source: selected.spec_source,
405
+ spec: selected.spec,
406
+ inputs: selected.inputs,
407
+ created_at_utc: selected.created_at_utc,
408
+ });
409
+ });
410
+ }
411
+ export function loadFoundryFacadeTaskRecord(context, taskId, actorId) {
412
+ assertFoundryRuntimeContext(context);
413
+ if (!context.workspaceId || context.taskId)
414
+ fail("workspace_context_required", "Facade task lookup requires one workspace context.");
415
+ const file = taskPointerPath(context, taskId);
416
+ if (!fs.existsSync(file))
417
+ fail("task_not_found", "No registered facade task matches this id.");
418
+ let taskPointer;
419
+ try {
420
+ taskPointer = pointer(JSON.parse(readBounded(file).toString("utf8")), context);
421
+ }
422
+ catch (error) {
423
+ if (error instanceof FoundryContextError)
424
+ throw error;
425
+ return fail("facade_task_pointer_invalid", "Facade task pointer is incomplete JSON.");
426
+ }
427
+ if (taskPointer.task_id !== taskId)
428
+ fail("facade_task_pointer_invalid", "Facade task pointer names another task.");
429
+ const request = readRequest(context, taskPointer.request_sha256).index;
430
+ const selected = request?.revisions[taskPointer.revision - 1];
431
+ if (!selected ||
432
+ selected.task_id !== taskId ||
433
+ selected.record_sha256 !== taskPointer.revision_sha256)
434
+ fail("facade_task_pointer_invalid", "Facade task pointer has no current request revision.");
435
+ if (selected.spec.actor_id !== actorId)
436
+ fail("task_actor_mismatch", "Current actor does not match the registered task intent.");
437
+ requireUnattemptedPredecessors(context, request.revisions.slice(0, taskPointer.revision - 1));
438
+ return Object.freeze({
439
+ request_sha256: taskPointer.request_sha256,
440
+ revision: selected.revision,
441
+ task_id: selected.task_id,
442
+ predecessor_task_id: selected.predecessor_task_id,
443
+ fingerprint_sha256: selected.fingerprint_sha256,
444
+ spec_source: selected.spec_source,
445
+ spec: selected.spec,
446
+ inputs: selected.inputs,
447
+ created_at_utc: selected.created_at_utc,
448
+ });
449
+ }
@@ -0,0 +1,21 @@
1
+ import { createFoundryIdentityOwners } from "./foundry-identity-owners.ts";
2
+ import { createCommitHandoffCommands } from "./finalize-owners/commit-handoff.ts";
3
+ import { createPostAuthoringFinalizeCommands } from "./finalize-owners/post-authoring.ts";
4
+ import { createPostWriteCloseoutCommands } from "./finalize-owners/post-write-closeout.ts";
5
+ import { type FoundryRuntimeContext } from "./foundry-runtime-context.ts";
6
+ import { type QualifiedFoundryRuntime } from "./foundry-runtime-qualification.ts";
7
+ interface FoundryFinalizeOwners {
8
+ finalize: ReturnType<typeof createPostAuthoringFinalizeCommands>;
9
+ handoff: ReturnType<typeof createCommitHandoffCommands>;
10
+ preflight: ReturnType<typeof createFoundryIdentityOwners>["preflight"];
11
+ closeout: ReturnType<typeof createPostWriteCloseoutCommands>;
12
+ invoke<T>(action: () => T): T;
13
+ }
14
+ /** Reuse finalization owners with fixed installed CLI and explicitly selected execution environments. */
15
+ export declare function createFoundryFinalizeOwners(context: FoundryRuntimeContext, qualified: QualifiedFoundryRuntime, temporary: string, execution: {
16
+ environment: NodeJS.ProcessEnv;
17
+ tidasExecutable: string;
18
+ receiptFile?: string;
19
+ datasetType?: string;
20
+ }): FoundryFinalizeOwners;
21
+ export {};
@@ -0,0 +1,203 @@
1
+ import { spawnSync } from "node:child_process";
2
+ import { parseScalar } from "./foundry-args.js";
3
+ import { createFoundryRuntimeUtils, resolveTiangongLcaCliRuntimeCommand, } from "./foundry-runtime-utils.js";
4
+ import { createTidasRowUtils } from "./tidas-row-utils.js";
5
+ import { bundleRowTypes } from "./bundle-row-types.js";
6
+ import { createDecisionTaskUtils } from "./decision-task-utils.js";
7
+ import { createFullContextProofUtils } from "./full-context-proof.js";
8
+ import { createTraceCoverageUtils } from "./trace-coverage.js";
9
+ import { createCanonicalSupportRewriteUtils } from "./canonical-support-rewrites.js";
10
+ import { createSourceSemanticUtils } from "./source-semantics.js";
11
+ import { createBundleSampleUtils } from "./bundle-sample-utils.js";
12
+ import { createIdentityReferenceRewriteUtils } from "./identity-reference-rewrite-utils.js";
13
+ import { createPostAuthoringFinalizeUtils } from "./post-authoring-finalize-utils.js";
14
+ import { createFoundryIdentityOwners } from "./foundry-identity-owners.js";
15
+ import { createCliWrapperCommands } from "./finalize-owners/cli-wrappers.js";
16
+ import { createCommitHandoffCommands } from "./finalize-owners/commit-handoff.js";
17
+ import { createPostAuthoringFinalizeCommands } from "./finalize-owners/post-authoring.js";
18
+ import { createPostWriteCloseoutCommands } from "./finalize-owners/post-write-closeout.js";
19
+ import { listImportProfiles, profileFor } from "./import-curation/profiles.js";
20
+ import { foundryTraceSummary } from "./import-curation/trace-summary.js";
21
+ import { runDatasetCurationCleanup } from "./import-curation/curation-cleanup.js";
22
+ import { runDatasetCurationGate } from "./import-curation/curation-gate.js";
23
+ import { runDatasetMutationManifest } from "./import-curation/mutation-manifest.js";
24
+ import { normalizeUtcDateTimeString } from "./import-curation/internal/prewrite-cleanup.js";
25
+ import { runTidasRowsValidation } from "./tidas-adapter.js";
26
+ import { ensureArray } from "./import-curation/internal/runtime-io.js";
27
+ import { datasetIdentity, unwrapDatasetPayload, } from "./import-curation/internal/dataset-payload.js";
28
+ import { workflowObject } from "./foundry-workflow-state.js";
29
+ import { runWorkflowLocalCliResult } from "./foundry-workflow-io.js";
30
+ import { createFoundryIsolatedChildEnvironment } from "./foundry-runtime-environment.js";
31
+ import { FoundryContextError } from "./foundry-runtime-context.js";
32
+ import { assertQualifiedFoundryRuntime, } from "./foundry-runtime-qualification.js";
33
+ function bind(factory, dependencies) {
34
+ return factory(dependencies);
35
+ }
36
+ /** Reuse finalization owners with fixed installed CLI and explicitly selected execution environments. */
37
+ export function createFoundryFinalizeOwners(context, qualified, temporary, execution) {
38
+ assertQualifiedFoundryRuntime(context, qualified);
39
+ const runtime = createFoundryRuntimeUtils({ parseScalar, repoRoot: context.assetRoot });
40
+ const rows = createTidasRowUtils({ ...runtime, bundleRowTypes });
41
+ const localEnvironment = createFoundryIsolatedChildEnvironment({ tempRoot: temporary });
42
+ const cli = resolveTiangongLcaCliRuntimeCommand({});
43
+ const base = {
44
+ ...runtime,
45
+ ...rows,
46
+ repoRoot: context.assetRoot,
47
+ ensureArray,
48
+ datasetIdentity: (row, type) => datasetIdentity(row, 0, type),
49
+ flowTypeOfDataSet: (row) => rows.flowTypeOfDataSet(unwrapDatasetPayload(row, "flow")),
50
+ flowClassificationSchemaType: (row) => rows.flowClassificationSchemaType(unwrapDatasetPayload(row, "flow")),
51
+ bundleClassificationPath: (row, type) => rows.bundleClassificationPath(unwrapDatasetPayload(row, type), type),
52
+ resolveTiangongLcaCliCommand: () => cli,
53
+ resolveTiangongLcaCliBin: () => cli.display,
54
+ resolveTiangongLcaCliCommandPrefix: () => [cli.command, ...cli.args],
55
+ };
56
+ const decisions = bind(createDecisionTaskUtils, base);
57
+ const proofs = bind(createFullContextProofUtils, { ...base, ...decisions, listImportProfiles });
58
+ const trace = bind(createTraceCoverageUtils, { ...base, foundryTraceSummary });
59
+ const canonical = bind(createCanonicalSupportRewriteUtils, base);
60
+ const source = bind(createSourceSemanticUtils, base);
61
+ const bundle = bind(createBundleSampleUtils, { ...base, ...source, normalizeUtcDateTimeString });
62
+ const identity = createFoundryIdentityOwners(context, qualified, "flow", {
63
+ environment: execution.environment,
64
+ cwd: temporary,
65
+ }).preflight;
66
+ const identityCommands = {
67
+ ...identity,
68
+ runDatasetIdentityPreflightRun: (options) => identity.runDatasetIdentityPreflightRun({
69
+ ...options,
70
+ type: execution.datasetType ?? options.type,
71
+ ...(execution.receiptFile ? { authReceipt: execution.receiptFile } : {}),
72
+ expectedProjectRef: context.accountIntent?.projectRef,
73
+ expectedUserId: context.accountIntent?.userId,
74
+ }),
75
+ };
76
+ const references = bind(createIdentityReferenceRewriteUtils, {
77
+ ...base,
78
+ ...canonical,
79
+ foundryTraceNamespace: "https://tiangong-lca.dev/foundry/import-curation/1",
80
+ identityPreflightCommands: identityCommands,
81
+ });
82
+ const cliWrappers = bind(createCliWrapperCommands, {
83
+ ...base,
84
+ executionEnvironment: localEnvironment,
85
+ executionCwd: temporary,
86
+ });
87
+ const finalizeUtils = bind(createPostAuthoringFinalizeUtils, {
88
+ ...base,
89
+ ...references,
90
+ cliWrapperCommands: cliWrappers,
91
+ identityPreflightCommands: identityCommands,
92
+ executionEnvironment: execution.environment,
93
+ readRowsFile: (file) => runtime.readRowsFile(file).map((row) => unwrapDatasetPayload(row, "")),
94
+ });
95
+ const handoff = bind(createCommitHandoffCommands, {
96
+ ...base,
97
+ ...proofs,
98
+ ...trace,
99
+ profileFor,
100
+ executionEnvironment: execution.environment,
101
+ });
102
+ const closeout = bind(createPostWriteCloseoutCommands, {
103
+ ...base,
104
+ ...proofs,
105
+ ...trace,
106
+ executionEnvironment: execution.environment,
107
+ writeCloseoutImportLedger: undefined,
108
+ readRowsFile: (file) => runtime.readRowsFile(file).map((row) => unwrapDatasetPayload(row, "")),
109
+ });
110
+ const runTiangongJsonStage = (stage, argv) => {
111
+ assertQualifiedFoundryRuntime(context, qualified);
112
+ const name = argv.slice(0, 2).join(" ");
113
+ const dryRun = [
114
+ "flow publish-version",
115
+ "process save-draft",
116
+ "lifecyclemodel save-draft",
117
+ "dataset save-draft",
118
+ ].includes(name) && argv.includes("--dry-run");
119
+ const remoteRead = name === "dataset verify-remote";
120
+ if (argv.some((arg) => /^--(?:commit|execute)(?:=|$)/u.test(arg)))
121
+ throw new FoundryContextError("finalize_write_forbidden", "Finalization cannot dispatch a remote mutation.");
122
+ if (!dryRun && !remoteRead) {
123
+ const result = runWorkflowLocalCliResult(context, qualified, temporary, argv);
124
+ return {
125
+ stage,
126
+ exit_code: result.exit,
127
+ report: result.report,
128
+ status: result.report.status,
129
+ command: cli.command,
130
+ args: [...cli.args, ...argv],
131
+ stderr: "",
132
+ };
133
+ }
134
+ if (!context.accountIntent)
135
+ throw new FoundryContextError("needs_auth", "Remote finalization checks require explicit task account intent.");
136
+ const result = spawnSync(cli.command, [...cli.args, ...argv], {
137
+ cwd: temporary,
138
+ env: execution.environment,
139
+ shell: false,
140
+ windowsHide: true,
141
+ encoding: "utf8",
142
+ timeout: 120_000,
143
+ maxBuffer: 16 * 1024 * 1024,
144
+ });
145
+ if (result.error || result.signal)
146
+ throw new FoundryContextError("finalize_cli_failed", "The qualified read-only finalization stage did not finish.");
147
+ let report;
148
+ try {
149
+ report = workflowObject(JSON.parse(result.stdout));
150
+ }
151
+ catch {
152
+ throw new FoundryContextError("finalize_cli_failed", "The qualified finalization stage returned no complete JSON report.");
153
+ }
154
+ return {
155
+ stage,
156
+ exit_code: result.status ?? 1,
157
+ report,
158
+ status: report.status,
159
+ command: cli.command,
160
+ args: [...cli.args, ...argv],
161
+ stderr: result.stderr,
162
+ };
163
+ };
164
+ const finalize = bind(createPostAuthoringFinalizeCommands, {
165
+ ...base,
166
+ ...canonical,
167
+ ...source,
168
+ ...bundle,
169
+ ...references,
170
+ ...proofs,
171
+ ...finalizeUtils,
172
+ ...handoff,
173
+ profileFor,
174
+ runDatasetCurationCleanup,
175
+ runDatasetMutationManifest,
176
+ runDatasetCurationGate: (request) => runDatasetCurationGate({
177
+ ...request,
178
+ requireIdentityPreflight: true,
179
+ }),
180
+ runTidasRowsValidation: (options) => runTidasRowsValidation({
181
+ repoRoot: context.assetRoot,
182
+ options: { ...options, tidasBin: execution.tidasExecutable },
183
+ environment: localEnvironment,
184
+ }),
185
+ runTiangongJsonStage,
186
+ writeFinalizeImportLedger: undefined,
187
+ });
188
+ return {
189
+ finalize,
190
+ handoff,
191
+ closeout,
192
+ preflight: identityCommands,
193
+ invoke(action) {
194
+ const previous = process.exitCode;
195
+ try {
196
+ return action();
197
+ }
198
+ finally {
199
+ process.exitCode = previous;
200
+ }
201
+ },
202
+ };
203
+ }