@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,180 @@
1
+ import { type FoundryRuntimeContext } from "./lib/foundry-runtime-context.ts";
2
+ import type { FoundryTaskOptions } from "./lib/foundry-task-types.ts";
3
+ import { type FoundryAuthentication, type VerifiedFoundryIdentity } from "./lib/foundry-runtime-identity.ts";
4
+ import { type QualifiedFoundryRuntime } from "./lib/foundry-runtime-qualification.ts";
5
+ import { type PrepareDerivedFoundryTaskAuthorizationOptions, type TaskApprovalEvidence } from "./lib/foundry-task-authorization.ts";
6
+ import { type CreateFoundryExecutionCapsuleOptions, type FoundryExecutionAdmission, type RehydrateFoundryExecutionAdmissionOptions } from "./lib/foundry-execution-admission.ts";
7
+ import type { SelectedSemanticInput } from "./lib/foundry-semantic-input.ts";
8
+ import type { ArtifactEntry } from "./lib/foundry-task-types.ts";
9
+ export interface FoundryCleanupRequest {
10
+ input: string;
11
+ type: string;
12
+ outputDirectory?: string;
13
+ sourceInput?: string;
14
+ profileId?: string;
15
+ }
16
+ /** Application boundary for user workspaces. Repository maintenance stays outside it. */
17
+ export declare function createFoundryRuntime(context: FoundryRuntimeContext, qualification?: QualifiedFoundryRuntime): Readonly<{
18
+ context: FoundryRuntimeContext;
19
+ qualification: QualifiedFoundryRuntime | null;
20
+ importPackage: (input: string) => Promise<import("./lib/foundry-task-types.ts").JsonRecord>;
21
+ prepareContext: (types: readonly string[]) => Promise<import("./lib/foundry-task-types.ts").JsonRecord>;
22
+ materializeRows: (sources: readonly string[]) => Promise<import("./lib/foundry-task-types.ts").JsonRecord>;
23
+ assessRows: (rows: string, contracts: readonly string[], identityReport?: string) => Promise<import("./lib/foundry-task-types.ts").JsonRecord>;
24
+ applySemantic: (entries: readonly ArtifactEntry[], submission: SelectedSemanticInput) => Promise<import("./lib/foundry-task-types.ts").JsonRecord>;
25
+ initializeWorkspace: () => {
26
+ workspace_id: string;
27
+ status: "created" | "existing";
28
+ };
29
+ startTask: (options?: FoundryTaskOptions) => import("./lib/foundry-task-types.ts").LoadedTask;
30
+ inspectTask: () => Promise<Readonly<{
31
+ job: Readonly<{
32
+ schema: "tiangong-foundry.job.v2";
33
+ workspace_id: string;
34
+ task_id: string;
35
+ actor_id: string;
36
+ request_id: string;
37
+ lane: import("./lib/foundry-task-types.ts").Lane;
38
+ target_profile: string;
39
+ target_entities: string[];
40
+ source_manifest: import("./lib/foundry-task-types.ts").FileReference;
41
+ profile_lock: import("./lib/foundry-task-types.ts").FileReference;
42
+ seed_manifest: import("./lib/foundry-task-types.ts").FileReference | null;
43
+ runtime_identity: import("./lib/foundry-task-types.ts").TaskRuntimeIdentity;
44
+ write_policy: {
45
+ mode: "dry-run";
46
+ remote_state_code: 0;
47
+ };
48
+ created_at_utc: string;
49
+ }>;
50
+ job_sha256: string;
51
+ sources: readonly Readonly<{
52
+ path: string;
53
+ bytes: number;
54
+ sha256: string;
55
+ }>[];
56
+ artifacts: readonly Readonly<{
57
+ bytes: number;
58
+ sha256: string;
59
+ path: string;
60
+ schema: "tiangong-foundry.artifact-index.v2";
61
+ sequence: number;
62
+ previous_sha256: string | null;
63
+ operation_id: string;
64
+ command: string;
65
+ input_scope_sha256: string;
66
+ receipt: import("./lib/foundry-task-types.ts").FileReference;
67
+ record_sha256: string;
68
+ }>[];
69
+ authorization_present: boolean;
70
+ attempts_present: boolean;
71
+ }>>;
72
+ verifyIdentity: (authentication?: FoundryAuthentication) => VerifiedFoundryIdentity;
73
+ registerAuthorization: (identity: VerifiedFoundryIdentity, options: {
74
+ inputFile: string;
75
+ grant: unknown;
76
+ evidence: readonly TaskApprovalEvidence[];
77
+ expectedPreviousSha256?: string | null;
78
+ }) => Promise<{
79
+ authorization_sha256: string;
80
+ pointer_sha256: string;
81
+ }>;
82
+ loadAuthorization: (identity: VerifiedFoundryIdentity, inputFile: string) => Promise<import("./lib/task-authorization.ts").ValidatedTaskAuthorization>;
83
+ prepareDerivedAuthorization: (identity: VerifiedFoundryIdentity, options: PrepareDerivedFoundryTaskAuthorizationOptions) => Promise<Readonly<{
84
+ grant: Readonly<{
85
+ schema: "tiangong-foundry.task-authorization.v1";
86
+ binding: Readonly<{
87
+ workspace_id: string;
88
+ task_id: string;
89
+ actor_id: string;
90
+ project_ref: string;
91
+ user_id: string;
92
+ profile_id: string;
93
+ profile_sha256: string;
94
+ input_scope_sha256: string;
95
+ }>;
96
+ issued_at_utc: string;
97
+ expires_at_utc: string;
98
+ remote_state_code: 0;
99
+ allowed_actions: readonly ("canonical_support_local_mint" | "elementary_flow_create_new" | "elementary_flow_write" | "flowproperty_write" | "unitgroup_write")[];
100
+ qa_waivers: readonly Readonly<{
101
+ dataset_type: "process";
102
+ code: "process_material_balance_deviation";
103
+ evidence_ids: readonly string[];
104
+ }>[];
105
+ evidence: readonly Readonly<{
106
+ id: string;
107
+ kind: "user-decision" | "source-model";
108
+ reference: string;
109
+ sha256: string;
110
+ }>[];
111
+ }>;
112
+ evidence: readonly Readonly<{
113
+ id: string;
114
+ kind: "source-model" | "user-decision";
115
+ file: import("./lib/foundry-runtime-context-types.ts").FoundryInputFact;
116
+ }>[];
117
+ expected_previous_sha256: string;
118
+ derivation: Readonly<{
119
+ path: string;
120
+ bytes: number;
121
+ sha256: string;
122
+ }>;
123
+ }>>;
124
+ createExecutionCapsule: (identity: VerifiedFoundryIdentity, options: CreateFoundryExecutionCapsuleOptions) => Promise<Readonly<{
125
+ capsule: Readonly<import("./lib/foundry-execution-context-format.ts").ExecutionCapsule>;
126
+ capsule_file: string;
127
+ capsule_sha256: string;
128
+ }>>;
129
+ rehydrateExecution: (identity: VerifiedFoundryIdentity, options: RehydrateFoundryExecutionAdmissionOptions) => Promise<FoundryExecutionAdmission>;
130
+ admitExecution: (identity: VerifiedFoundryIdentity, admission: FoundryExecutionAdmission) => Promise<import("@tiangong-lca/cli/command-spec").FoundryCommandSpec>;
131
+ profiles: () => import("./lib/import-curation/internal/profiles-config.ts").ImportProfilesList;
132
+ describe: () => {
133
+ platform: string;
134
+ runtime: {
135
+ package: string;
136
+ version: string;
137
+ entry_sha256: string;
138
+ };
139
+ workspace: {
140
+ id: string | null;
141
+ initialized: boolean;
142
+ };
143
+ task: {
144
+ id: string | null;
145
+ actor: string | null;
146
+ };
147
+ qualification: {
148
+ status: string;
149
+ identity: Readonly<{
150
+ schema: "tiangong-foundry.runtime-qualification.v1";
151
+ qualification_sha256: string;
152
+ cli: Readonly<{
153
+ package_version: string;
154
+ platform: "darwin-arm64" | "linux-arm64" | "linux-x64" | "win32-x64";
155
+ content_sha256: string;
156
+ node_version: string;
157
+ node_sha256: string;
158
+ }>;
159
+ tidas: Readonly<{
160
+ binary_version: string;
161
+ executable: Readonly<import("./lib/foundry-runtime-qualification.ts").ContentFact>;
162
+ asset_fingerprint: string;
163
+ protocols: readonly string[];
164
+ event_schema_versions: readonly string[];
165
+ }>;
166
+ }>;
167
+ } | {
168
+ status: string;
169
+ identity: null;
170
+ };
171
+ command_policy: {
172
+ total: number;
173
+ public_operations: readonly ["workspace.init", "doctor", "task.start", "task.status", "task.resume", "workspace.migrate"];
174
+ public_facade: ("acceptance-check" | "capabilities-list" | "dataset-authoring-patch-collect" | "dataset-authoring-plan" | "dataset-authoring-task-build" | "dataset-bafu-authoring-patches-autofill" | "dataset-bafu-batch-import-run" | "dataset-bafu-identity-decisions-autofill" | "dataset-bafu-leaf-classification-category-map-project" | "dataset-bafu-leaf-classification-tasks-prepare" | "dataset-bafu-process-scope-e2e" | "dataset-bafu-universe-coverage-report" | "dataset-bundle-sample-rows" | "dataset-canonical-support-mappings-autofill" | "dataset-classification-decision-task-build" | "dataset-classification-decisions-apply" | "dataset-commit-handoff-plan" | "dataset-curation-cleanup" | "dataset-curation-gate" | "dataset-curation-queue-build" | "dataset-identity-decision-task-build" | "dataset-identity-decisions-apply" | "dataset-identity-preflight-index-merge" | "dataset-identity-preflight-query-audit" | "dataset-identity-preflight-requests-build" | "dataset-identity-preflight-run" | "dataset-identity-reference-rewrites-apply" | "dataset-import-completion-report" | "dataset-import-ledger-report" | "dataset-incremental-change-set-compose" | "dataset-library-authoring-plan" | "dataset-library-classification-decisions-project" | "dataset-library-decisions-apply" | "dataset-library-identity-decisions-from-preflight" | "dataset-library-index-build" | "dataset-location-decision-task-build" | "dataset-location-decisions-apply" | "dataset-location-decisions-suggest" | "dataset-mutation-manifest" | "dataset-patch-apply" | "dataset-post-authoring-finalize" | "dataset-post-write-closeout" | "dataset-process-scope-run" | "dataset-support-cache-refresh" | "dataset-tidas-import" | "dataset-tidas-validate" | "dataset-topology-convergence-compose" | "dataset-uslci-batch-import-run" | "dataset-worldsteel-batch-import-run" | "doctor" | "env-check" | "execution-capsule-admit" | "init" | "profiles-list" | "route-task" | "storage-check" | "surface-audit" | "task-complete" | "tasks-check" | "tasks-list" | "tidas-handshake" | "workflow-check" | "workspace-map")[];
175
+ internal_only: number;
176
+ excluded: ("acceptance-check" | "capabilities-list" | "dataset-authoring-patch-collect" | "dataset-authoring-plan" | "dataset-authoring-task-build" | "dataset-bafu-authoring-patches-autofill" | "dataset-bafu-batch-import-run" | "dataset-bafu-identity-decisions-autofill" | "dataset-bafu-leaf-classification-category-map-project" | "dataset-bafu-leaf-classification-tasks-prepare" | "dataset-bafu-process-scope-e2e" | "dataset-bafu-universe-coverage-report" | "dataset-bundle-sample-rows" | "dataset-canonical-support-mappings-autofill" | "dataset-classification-decision-task-build" | "dataset-classification-decisions-apply" | "dataset-commit-handoff-plan" | "dataset-curation-cleanup" | "dataset-curation-gate" | "dataset-curation-queue-build" | "dataset-identity-decision-task-build" | "dataset-identity-decisions-apply" | "dataset-identity-preflight-index-merge" | "dataset-identity-preflight-query-audit" | "dataset-identity-preflight-requests-build" | "dataset-identity-preflight-run" | "dataset-identity-reference-rewrites-apply" | "dataset-import-completion-report" | "dataset-import-ledger-report" | "dataset-incremental-change-set-compose" | "dataset-library-authoring-plan" | "dataset-library-classification-decisions-project" | "dataset-library-decisions-apply" | "dataset-library-identity-decisions-from-preflight" | "dataset-library-index-build" | "dataset-location-decision-task-build" | "dataset-location-decisions-apply" | "dataset-location-decisions-suggest" | "dataset-mutation-manifest" | "dataset-patch-apply" | "dataset-post-authoring-finalize" | "dataset-post-write-closeout" | "dataset-process-scope-run" | "dataset-support-cache-refresh" | "dataset-tidas-import" | "dataset-tidas-validate" | "dataset-topology-convergence-compose" | "dataset-uslci-batch-import-run" | "dataset-worldsteel-batch-import-run" | "doctor" | "env-check" | "execution-capsule-admit" | "init" | "profiles-list" | "route-task" | "storage-check" | "surface-audit" | "task-complete" | "tasks-check" | "tasks-list" | "tidas-handshake" | "workflow-check" | "workspace-map")[];
177
+ };
178
+ };
179
+ cleanup(request: FoundryCleanupRequest): Promise<import("./lib/foundry-task-types.ts").JsonRecord>;
180
+ }>;
@@ -0,0 +1,190 @@
1
+ import fs from "node:fs";
2
+ import path from "node:path";
3
+ import { assertFoundryRuntimeContext, assertFoundryWorkspaceWrite, FoundryContextError, initializeFoundryWorkspace, readFoundryInput, resolveFoundryOutput, resolveFoundryInputPath, resolveFoundryAsset, } from "./lib/foundry-runtime-context.js";
4
+ import { runFoundryTaskOperation, withFoundryTaskMetadata } from "./lib/foundry-task-store.js";
5
+ import { bindAccountIntent, createTask, loadTask } from "./lib/foundry-task-registration.js";
6
+ import { assertVerifiedFoundryIdentity, verifyFoundryRuntimeIdentity, } from "./lib/foundry-runtime-identity.js";
7
+ import { assertQualifiedFoundryRuntime, foundryRuntimeQualificationIdentity, } from "./lib/foundry-runtime-qualification.js";
8
+ import { loadFoundryTaskAuthorization, prepareDerivedFoundryTaskAuthorization, registerFoundryTaskAuthorization, } from "./lib/foundry-task-authorization.js";
9
+ import { assertFoundryExecutionAdmission, createFoundryExecutionCapsule, rehydrateFoundryExecutionAdmission, } from "./lib/foundry-execution-admission.js";
10
+ import { foundryRuntimeCommandPolicies } from "./lib/foundry-runtime-command-policy.js";
11
+ import { foundryPublicOperations } from "./lib/foundry-operation-result.js";
12
+ import { listImportProfiles } from "./lib/import-curation/profiles.js";
13
+ import { runDatasetCurationCleanup } from "./lib/import-curation/curation-cleanup.js";
14
+ import { readRows } from "./lib/import-curation/internal/runtime-io.js";
15
+ import { importFoundryWorkflowPackage } from "./lib/foundry-workflow-import.js";
16
+ import { prepareFoundryWorkflowContext } from "./lib/foundry-workflow-context.js";
17
+ import { materializeFoundryWorkflowRows } from "./lib/foundry-workflow-rows.js";
18
+ import { assessFoundryWorkflowRows } from "./lib/foundry-workflow-assessment.js";
19
+ import { applyFoundrySemanticInput } from "./lib/foundry-workflow-semantic.js";
20
+ /** Application boundary for user workspaces. Repository maintenance stays outside it. */
21
+ export function createFoundryRuntime(context, qualification) {
22
+ assertFoundryRuntimeContext(context);
23
+ if (qualification)
24
+ assertQualifiedFoundryRuntime(context, qualification);
25
+ const requireQualification = () => {
26
+ if (!qualification)
27
+ throw new FoundryContextError("runtime_qualification_required", "This operation requires an exact CLI and TIDAS runtime qualification.");
28
+ assertQualifiedFoundryRuntime(context, qualification);
29
+ return qualification;
30
+ };
31
+ return Object.freeze({
32
+ context,
33
+ qualification: qualification ?? null,
34
+ importPackage: (input) => importFoundryWorkflowPackage(context, requireQualification(), resolveFoundryInputPath(context, input)),
35
+ prepareContext: (types) => prepareFoundryWorkflowContext(context, requireQualification(), types),
36
+ materializeRows: (sources) => materializeFoundryWorkflowRows(context, sources),
37
+ assessRows: (rows, contracts, identityReport) => assessFoundryWorkflowRows(context, requireQualification(), rows, contracts, identityReport),
38
+ applySemantic: (entries, submission) => applyFoundrySemanticInput(context, requireQualification(), entries, submission),
39
+ initializeWorkspace: () => initializeFoundryWorkspace(context),
40
+ startTask: (options = {}) => {
41
+ assertFoundryWorkspaceWrite(context);
42
+ const task = context.taskRoot && fs.existsSync(context.taskRoot)
43
+ ? loadTask(context, options)
44
+ : createTask(context, options);
45
+ bindAccountIntent(context);
46
+ return task;
47
+ },
48
+ inspectTask: () => withFoundryTaskMetadata(context, (task, index) => {
49
+ const attempts = path.join(context.taskRoot, "attempts");
50
+ let attemptsPresent = false;
51
+ if (fs.existsSync(attempts)) {
52
+ const stat = fs.lstatSync(attempts);
53
+ if (!stat.isDirectory() || stat.isSymbolicLink())
54
+ throw new FoundryContextError("task_attempt_state_invalid", "Task attempt state must remain a contained directory.");
55
+ attemptsPresent = fs.readdirSync(attempts).length > 0;
56
+ }
57
+ const authorization = path.join(context.taskRoot, "authorization.json");
58
+ let authorizationPresent = false;
59
+ if (fs.existsSync(authorization)) {
60
+ const stat = fs.lstatSync(authorization);
61
+ if (!stat.isFile() || stat.isSymbolicLink())
62
+ throw new FoundryContextError("task_authorization_state_invalid", "Task authorization state must remain a contained regular file.");
63
+ authorizationPresent = true;
64
+ }
65
+ return Object.freeze({
66
+ job: Object.freeze({ ...task.job }),
67
+ job_sha256: task.jobSha256,
68
+ sources: Object.freeze(task.sources.map((source) => Object.freeze({ ...source }))),
69
+ artifacts: Object.freeze(index.map((entry) => Object.freeze({ ...entry }))),
70
+ authorization_present: authorizationPresent,
71
+ attempts_present: attemptsPresent,
72
+ });
73
+ }, {
74
+ verifyCommands: [
75
+ "dataset-import-completion-report",
76
+ "dataset-workflow-execution-prepare",
77
+ "dataset-workflow-execution-consume",
78
+ "dataset-workflow-execution-result",
79
+ "dataset-workflow-execution-observation",
80
+ "dataset-workflow-reference-verify",
81
+ ],
82
+ }),
83
+ verifyIdentity: (authentication) => verifyFoundryRuntimeIdentity(context, authentication, process.env, qualification),
84
+ registerAuthorization: (identity, options) => {
85
+ if (qualification)
86
+ assertVerifiedFoundryIdentity(context, identity, qualification);
87
+ return registerFoundryTaskAuthorization(context, identity, options, qualification);
88
+ },
89
+ loadAuthorization: (identity, inputFile) => {
90
+ if (qualification)
91
+ assertVerifiedFoundryIdentity(context, identity, qualification);
92
+ return loadFoundryTaskAuthorization(context, identity, inputFile, qualification);
93
+ },
94
+ prepareDerivedAuthorization: (identity, options) => {
95
+ const current = requireQualification();
96
+ assertVerifiedFoundryIdentity(context, identity, current);
97
+ return prepareDerivedFoundryTaskAuthorization(context, current, identity, options);
98
+ },
99
+ createExecutionCapsule: (identity, options) => {
100
+ const current = requireQualification();
101
+ assertVerifiedFoundryIdentity(context, identity, current);
102
+ return createFoundryExecutionCapsule(context, current, identity, options);
103
+ },
104
+ rehydrateExecution: (identity, options) => {
105
+ const current = requireQualification();
106
+ assertVerifiedFoundryIdentity(context, identity, current);
107
+ return rehydrateFoundryExecutionAdmission(context, current, identity, options);
108
+ },
109
+ admitExecution: (identity, admission) => {
110
+ const current = requireQualification();
111
+ assertVerifiedFoundryIdentity(context, identity, current);
112
+ return assertFoundryExecutionAdmission(context, current, identity, admission);
113
+ },
114
+ profiles: () => {
115
+ resolveFoundryAsset(context, "specs/import-profiles.json");
116
+ return listImportProfiles({ repoRoot: context.assetRoot });
117
+ },
118
+ describe: () => ({
119
+ platform: context.platform,
120
+ runtime: {
121
+ package: context.runtime.packageName,
122
+ version: context.runtime.packageVersion,
123
+ entry_sha256: context.runtime.entrySha256,
124
+ },
125
+ workspace: { id: context.workspaceId, initialized: context.workspaceId !== null },
126
+ task: { id: context.taskId, actor: context.actorId },
127
+ qualification: qualification
128
+ ? { status: "ready", identity: foundryRuntimeQualificationIdentity(context, qualification) }
129
+ : { status: "required", identity: null },
130
+ command_policy: {
131
+ total: foundryRuntimeCommandPolicies.length,
132
+ public_operations: foundryPublicOperations,
133
+ public_facade: foundryRuntimeCommandPolicies
134
+ .filter((policy) => policy.distribution === "public-facade")
135
+ .map((policy) => policy.command),
136
+ internal_only: foundryRuntimeCommandPolicies.filter((policy) => policy.distribution === "internal-only").length,
137
+ excluded: foundryRuntimeCommandPolicies
138
+ .filter((policy) => policy.distribution === "excluded")
139
+ .map((policy) => policy.command),
140
+ },
141
+ }),
142
+ async cleanup(request) {
143
+ const input = resolveFoundryInputPath(context, request.input);
144
+ const sourceInput = request.sourceInput
145
+ ? resolveFoundryInputPath(context, request.sourceInput)
146
+ : undefined;
147
+ const outDir = resolveFoundryOutput(context, request.outputDirectory ?? "outputs/cleanup");
148
+ return runFoundryTaskOperation(context, {
149
+ command: "dataset-curation-cleanup",
150
+ options: {
151
+ type: request.type,
152
+ source_input: sourceInput ?? null,
153
+ output_directory: path.relative(context.taskRoot, outDir).split(path.sep).join("/"),
154
+ },
155
+ task: { profileId: request.profileId, targetEntities: [request.type] },
156
+ }, (operation) => {
157
+ readFoundryInput(context, input);
158
+ if (sourceInput)
159
+ readFoundryInput(context, sourceInput);
160
+ return runDatasetCurationCleanup({
161
+ repoRoot: context.workspaceRoot,
162
+ options: { type: request.type, rowsFile: input, sourceRowsFile: sourceInput, outDir },
163
+ io: {
164
+ nowIso: operation.nowIso,
165
+ fileExists(file) {
166
+ if (!file)
167
+ return false;
168
+ const value = String(file);
169
+ if (!context.inputs.some((fact) => fact.path === value))
170
+ resolveFoundryOutput(context, value);
171
+ return fs.existsSync(value) && fs.lstatSync(value).isFile();
172
+ },
173
+ readRows(file) {
174
+ return readRows(file, (selected) => readFoundryInput(context, selected).toString("utf8"));
175
+ },
176
+ writeText(file, content) {
177
+ const bytes = typeof content === "string"
178
+ ? content
179
+ : Buffer.from(content.buffer, content.byteOffset, content.byteLength);
180
+ operation.writeText(file, bytes);
181
+ },
182
+ writeJson(file, value) {
183
+ operation.writeJson(file, value);
184
+ },
185
+ },
186
+ });
187
+ });
188
+ },
189
+ });
190
+ }
@@ -0,0 +1,27 @@
1
+ import { type BatchAttemptedResumeItem, type BatchEvent, type BatchItemContract } from "@tiangong-lca/cli/batch";
2
+ import type { ScopeResumeContract } from "./scope-resume-contract.ts";
3
+ type JsonRecord = Record<string, unknown>;
4
+ export interface ScopeAttemptLedgerAdapter {
5
+ nowIso: () => string;
6
+ readJsonLines: (filePath: string) => JsonRecord[];
7
+ appendJsonLine: (filePath: string, row: JsonRecord) => void;
8
+ writeJsonLines: (filePath: string, rows: readonly JsonRecord[]) => void;
9
+ }
10
+ export interface ScopeAttemptLedgerPaths {
11
+ state: string;
12
+ events: string;
13
+ }
14
+ export interface ScopeAttemptEventInput {
15
+ event: BatchEvent;
16
+ itemContract: BatchItemContract | null;
17
+ scopeResumeContract?: ScopeResumeContract | null;
18
+ }
19
+ export declare function createScopeAttemptLedgerService({ paths, adapter, }: {
20
+ paths: ScopeAttemptLedgerPaths;
21
+ adapter: ScopeAttemptLedgerAdapter;
22
+ }): Readonly<{
23
+ loadResumeItems: (selectedIds: ReadonlySet<string>) => BatchAttemptedResumeItem[];
24
+ record: (input: ScopeAttemptEventInput) => void;
25
+ compact: () => void;
26
+ }>;
27
+ export {};
@@ -0,0 +1,85 @@
1
+ import { parseBatchItemContract, } from "@tiangong-lca/cli/batch";
2
+ function positiveAttempts(value) {
3
+ const attempts = Number(value);
4
+ return Number.isSafeInteger(attempts) && attempts > 0 ? attempts : null;
5
+ }
6
+ function parseState(row) {
7
+ try {
8
+ const itemContract = parseBatchItemContract(row.item_contract);
9
+ const attempts = positiveAttempts(row.attempts);
10
+ if (attempts === null)
11
+ return null;
12
+ return {
13
+ itemContract,
14
+ attempts,
15
+ scopeResumeContract: row.scope_resume_contract ?? null,
16
+ };
17
+ }
18
+ catch {
19
+ return null;
20
+ }
21
+ }
22
+ function reduceAttemptState(rows) {
23
+ const states = new Map();
24
+ for (const row of rows) {
25
+ const type = String(row.type ?? "");
26
+ const itemId = String(row.item_id ?? "");
27
+ if (!itemId) {
28
+ const state = parseState(row);
29
+ if (state)
30
+ states.set(state.itemContract.item_id, state);
31
+ continue;
32
+ }
33
+ if (["attempt_succeeded", "recovery_succeeded", "item_resumed"].includes(type)) {
34
+ states.delete(itemId);
35
+ continue;
36
+ }
37
+ if (type !== "attempt_started")
38
+ continue;
39
+ const state = parseState({
40
+ item_contract: row.item_contract,
41
+ attempts: row.attempt,
42
+ scope_resume_contract: row.scope_resume_contract,
43
+ });
44
+ if (state)
45
+ states.set(itemId, state);
46
+ }
47
+ return states;
48
+ }
49
+ export function createScopeAttemptLedgerService({ paths, adapter, }) {
50
+ function currentStates() {
51
+ return reduceAttemptState([
52
+ ...adapter.readJsonLines(paths.state),
53
+ ...adapter.readJsonLines(paths.events),
54
+ ]);
55
+ }
56
+ function loadResumeItems(selectedIds) {
57
+ return [...currentStates().values()]
58
+ .filter((state) => selectedIds.has(state.itemContract.item_id))
59
+ .map((state) => ({ ...state.itemContract, state: "attempted", attempts: state.attempts }));
60
+ }
61
+ function recordEvent(input) {
62
+ adapter.appendJsonLine(paths.events, {
63
+ schema_version: 1,
64
+ generated_at_utc: adapter.nowIso(),
65
+ ...input.event,
66
+ item_contract: input.itemContract,
67
+ scope_resume_contract: input.scopeResumeContract ?? null,
68
+ });
69
+ }
70
+ function compact() {
71
+ const rows = [...currentStates().values()]
72
+ .sort((left, right) => left.itemContract.item_id.localeCompare(right.itemContract.item_id))
73
+ .map((state) => ({
74
+ schema_version: 1,
75
+ generated_at_utc: adapter.nowIso(),
76
+ state: "attempted",
77
+ item_contract: state.itemContract,
78
+ attempts: state.attempts,
79
+ scope_resume_contract: state.scopeResumeContract,
80
+ }));
81
+ adapter.writeJsonLines(paths.state, rows);
82
+ adapter.writeJsonLines(paths.events, []);
83
+ }
84
+ return Object.freeze({ loadResumeItems, record: recordEvent, compact });
85
+ }
@@ -0,0 +1,38 @@
1
+ import { type BatchJsonObject, type BatchJsonValue } from "@tiangong-lca/cli/batch";
2
+ export declare const SCOPE_RESUME_CONTRACT_SCHEMA: "tiangong-foundry.scope-resume-contract.v1";
3
+ export declare const BAFU_SCOPE_STAGE_POLICY: "tiangong-foundry.bafu-scope-stage-policy.v1";
4
+ export interface ScopeResumeContract extends BatchJsonObject {
5
+ schema: typeof SCOPE_RESUME_CONTRACT_SCHEMA;
6
+ identity_key: string;
7
+ content_sha256: string;
8
+ policy_sha256: string;
9
+ executable_sha256: string;
10
+ sha256: string;
11
+ }
12
+ export interface CreateScopeResumeContractInput {
13
+ identityKey: string;
14
+ content: BatchJsonValue;
15
+ policy: BatchJsonValue;
16
+ executable: BatchJsonValue;
17
+ }
18
+ export interface BafuScopeResumeContext {
19
+ command: string;
20
+ profile: string;
21
+ targetUserId: string;
22
+ stateCode: number;
23
+ commit: boolean;
24
+ parallel: number;
25
+ requireLeafClassification: boolean;
26
+ selectionOrder: string;
27
+ applyResolutionRewrites: boolean;
28
+ familySignatures: boolean;
29
+ mintUnmatchedFpUgSupport: boolean;
30
+ cliPackage: string;
31
+ sourceContent?: BatchJsonValue;
32
+ stagePolicy?: string;
33
+ }
34
+ type JsonRecord = Record<string, unknown>;
35
+ export declare function createScopeResumeContract({ identityKey, content, policy, executable, }: CreateScopeResumeContractInput): ScopeResumeContract;
36
+ export declare function createBafuScopeResumeContract(scope: JsonRecord, context: BafuScopeResumeContext): ScopeResumeContract;
37
+ export declare function scopeResumeMismatchReason(value: unknown, expected: ScopeResumeContract): string | null;
38
+ export {};
@@ -0,0 +1,90 @@
1
+ import { sha256BatchJson, } from "@tiangong-lca/cli/batch";
2
+ export const SCOPE_RESUME_CONTRACT_SCHEMA = "tiangong-foundry.scope-resume-contract.v1";
3
+ export const BAFU_SCOPE_STAGE_POLICY = "tiangong-foundry.bafu-scope-stage-policy.v1";
4
+ function jsonRecord(value) {
5
+ return value && typeof value === "object" && !Array.isArray(value) ? value : {};
6
+ }
7
+ function batchJson(value) {
8
+ const text = JSON.stringify(value);
9
+ if (text === undefined)
10
+ throw new TypeError("Resume contract input must be JSON serializable.");
11
+ return JSON.parse(text);
12
+ }
13
+ function contractAuthority(contract) {
14
+ return {
15
+ schema: contract.schema,
16
+ identity_key: contract.identity_key,
17
+ content_sha256: contract.content_sha256,
18
+ policy_sha256: contract.policy_sha256,
19
+ executable_sha256: contract.executable_sha256,
20
+ };
21
+ }
22
+ function scopeContent(scope) {
23
+ const content = { ...scope };
24
+ delete content.commit_command;
25
+ delete content.verify_command;
26
+ const handoff = jsonRecord(content.commit_handoff);
27
+ if (Object.keys(handoff).length > 0) {
28
+ content.commit_handoff = { ...handoff };
29
+ delete jsonRecord(content.commit_handoff).commit_command;
30
+ delete jsonRecord(content.commit_handoff).verify_command;
31
+ }
32
+ return content;
33
+ }
34
+ export function createScopeResumeContract({ identityKey, content, policy, executable, }) {
35
+ const authority = {
36
+ schema: SCOPE_RESUME_CONTRACT_SCHEMA,
37
+ identity_key: identityKey,
38
+ content_sha256: sha256BatchJson(content),
39
+ policy_sha256: sha256BatchJson(policy),
40
+ executable_sha256: sha256BatchJson(executable),
41
+ };
42
+ return { ...authority, sha256: sha256BatchJson(contractAuthority(authority)) };
43
+ }
44
+ export function createBafuScopeResumeContract(scope, context) {
45
+ const processId = String(scope.process_id ?? scope.id ?? "").trim();
46
+ const processVersion = String(scope.process_version ?? scope.version ?? "00.00.001").trim();
47
+ const commitSpec = jsonRecord(scope.commit_command ?? jsonRecord(scope.commit_handoff).commit_command);
48
+ const verifySpec = jsonRecord(scope.verify_command ?? jsonRecord(scope.commit_handoff).verify_command);
49
+ const commandSpecs = batchJson({ commit: commitSpec, verify: verifySpec });
50
+ return createScopeResumeContract({
51
+ identityKey: `${processId}@${processVersion || "00.00.001"}`,
52
+ content: batchJson({ scope: scopeContent(scope), source: context.sourceContent ?? null }),
53
+ policy: batchJson({
54
+ command: context.command,
55
+ profile: context.profile,
56
+ target_user_id: context.targetUserId,
57
+ state_code: context.stateCode,
58
+ commit: context.commit,
59
+ parallel: context.parallel,
60
+ require_leaf_classification: context.requireLeafClassification,
61
+ selection_order: context.selectionOrder,
62
+ apply_resolution_rewrites: context.applyResolutionRewrites,
63
+ family_signatures: context.familySignatures,
64
+ mint_unmatched_fp_ug_support: context.mintUnmatchedFpUgSupport,
65
+ }),
66
+ executable: batchJson({
67
+ cli_package: context.cliPackage,
68
+ stage_policy: context.stagePolicy ?? BAFU_SCOPE_STAGE_POLICY,
69
+ command_specs_sha256: Object.keys(commitSpec).length + Object.keys(verifySpec).length > 0
70
+ ? sha256BatchJson(commandSpecs)
71
+ : null,
72
+ }),
73
+ });
74
+ }
75
+ export function scopeResumeMismatchReason(value, expected) {
76
+ const actual = jsonRecord(value);
77
+ if (actual.schema !== SCOPE_RESUME_CONTRACT_SCHEMA)
78
+ return "legacy_resume_contract_missing";
79
+ if (actual.identity_key !== expected.identity_key)
80
+ return "resume_identity_drift";
81
+ if (actual.content_sha256 !== expected.content_sha256)
82
+ return "resume_content_drift";
83
+ if (actual.policy_sha256 !== expected.policy_sha256)
84
+ return "resume_policy_drift";
85
+ if (actual.executable_sha256 !== expected.executable_sha256)
86
+ return "resume_executable_drift";
87
+ if (actual.sha256 !== expected.sha256)
88
+ return "resume_contract_drift";
89
+ return null;
90
+ }
@@ -0,0 +1,44 @@
1
+ export type BundleRowTypeConfig = {
2
+ plural: string;
3
+ rootKey: string;
4
+ informationKey: string;
5
+ };
6
+ export declare const bundleRowTypes: {
7
+ contact: {
8
+ plural: string;
9
+ rootKey: string;
10
+ informationKey: string;
11
+ };
12
+ source: {
13
+ plural: string;
14
+ rootKey: string;
15
+ informationKey: string;
16
+ };
17
+ unitgroup: {
18
+ plural: string;
19
+ rootKey: string;
20
+ informationKey: string;
21
+ };
22
+ flowproperty: {
23
+ plural: string;
24
+ rootKey: string;
25
+ informationKey: string;
26
+ };
27
+ flow: {
28
+ plural: string;
29
+ rootKey: string;
30
+ informationKey: string;
31
+ };
32
+ process: {
33
+ plural: string;
34
+ rootKey: string;
35
+ informationKey: string;
36
+ };
37
+ lifecyclemodel: {
38
+ plural: string;
39
+ rootKey: string;
40
+ informationKey: string;
41
+ };
42
+ };
43
+ export type BundleRowType = keyof typeof bundleRowTypes;
44
+ export declare const bundleRowTypeOrder: BundleRowType[];