@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,38 @@
1
+ export function parseScalar(value) {
2
+ const text = String(value ?? "").trim();
3
+ if (text === "true")
4
+ return true;
5
+ if (text === "false")
6
+ return false;
7
+ if (/^-?\d+$/u.test(text))
8
+ return Number(text);
9
+ return text.replace(/^["']|["']$/gu, "");
10
+ }
11
+ export function parseArgs(argv) {
12
+ const options = { _: [] };
13
+ for (let index = 0; index < argv.length; index += 1) {
14
+ const arg = argv[index];
15
+ if (!arg.startsWith("--")) {
16
+ options._.push(arg);
17
+ continue;
18
+ }
19
+ const [rawKey, inlineValue] = arg.slice(2).split("=", 2);
20
+ const key = rawKey.replace(/-([a-z])/gu, (_, letter) => letter.toUpperCase());
21
+ const value = inlineValue ?? argv[index + 1];
22
+ if (inlineValue === undefined && value && !String(value).startsWith("--")) {
23
+ index += 1;
24
+ }
25
+ const parsed = inlineValue !== undefined || (value && !String(value).startsWith("--"))
26
+ ? parseScalar(value)
27
+ : true;
28
+ if (Object.hasOwn(options, key)) {
29
+ options[key] = Array.isArray(options[key])
30
+ ? [...options[key], parsed]
31
+ : [options[key], parsed];
32
+ }
33
+ else {
34
+ options[key] = parsed;
35
+ }
36
+ }
37
+ return options;
38
+ }
@@ -0,0 +1,17 @@
1
+ export interface FoundryPublicOAuthConfiguration {
2
+ apiBaseUrl?: string;
3
+ publishableKey?: string;
4
+ oauthClientId?: string;
5
+ oauthRedirectUri?: string;
6
+ }
7
+ export type FoundryAuthentication = {
8
+ mode: "oauth";
9
+ configuration?: FoundryPublicOAuthConfiguration;
10
+ } | {
11
+ mode: "headless";
12
+ accessToken: string;
13
+ apiBaseUrl: string;
14
+ publishableKey: string;
15
+ };
16
+ /** Explicit public configuration and process-only credentials; never inherit ambient auth. */
17
+ export declare function createFoundryAuthenticationEnvironment(authentication: FoundryAuthentication, sessionReference: string | null | undefined, systemEnvironment: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
@@ -0,0 +1,55 @@
1
+ import { FoundryContextError } from "./foundry-runtime-context.js";
2
+ import { requirePrivateOAuthSessionFile } from "./oauth-session-reference.js";
3
+ const systemKeys = [
4
+ "PATH",
5
+ "Path",
6
+ "PATHEXT",
7
+ "SystemRoot",
8
+ "SYSTEMROOT",
9
+ "WINDIR",
10
+ "ComSpec",
11
+ "COMSPEC",
12
+ "HOME",
13
+ "USERPROFILE",
14
+ "APPDATA",
15
+ "LOCALAPPDATA",
16
+ "XDG_CONFIG_HOME",
17
+ "TEMP",
18
+ "TMP",
19
+ "TMPDIR",
20
+ ];
21
+ /** Explicit public configuration and process-only credentials; never inherit ambient auth. */
22
+ export function createFoundryAuthenticationEnvironment(authentication, sessionReference, systemEnvironment) {
23
+ const account = { sessionReference };
24
+ const reject = (code, message) => {
25
+ throw new FoundryContextError(code, message);
26
+ };
27
+ const environment = {};
28
+ for (const key of systemKeys)
29
+ if (systemEnvironment[key] !== undefined)
30
+ environment[key] = systemEnvironment[key];
31
+ if (authentication.mode === "oauth") {
32
+ const config = authentication.configuration ?? {};
33
+ environment.TIANGONG_LCA_API_BASE_URL = config.apiBaseUrl ?? "";
34
+ environment.TIANGONG_LCA_SUPABASE_PUBLISHABLE_KEY = config.publishableKey ?? "";
35
+ environment.TIANGONG_LCA_OAUTH_CLIENT_ID = config.oauthClientId ?? "";
36
+ environment.TIANGONG_LCA_OAUTH_REDIRECT_URI = config.oauthRedirectUri ?? "";
37
+ environment.TIANGONG_LCA_AUTH_MODE = "oauth";
38
+ environment.TIANGONG_LCA_FORCE_REAUTH = "false";
39
+ environment.TIANGONG_LCA_DISABLE_SESSION_CACHE = "false";
40
+ if (account.sessionReference) {
41
+ requirePrivateOAuthSessionFile(account.sessionReference);
42
+ environment.TIANGONG_LCA_SESSION_FILE = account.sessionReference;
43
+ }
44
+ }
45
+ else {
46
+ if (!authentication.accessToken || !authentication.apiBaseUrl || !authentication.publishableKey)
47
+ reject("headless_target_required", "Headless mode requires the existing CLI explicit target and process-only actor token.");
48
+ environment.TIANGONG_LCA_AUTH_MODE = "access_token";
49
+ environment.TIANGONG_LCA_ACCESS_TOKEN = authentication.accessToken;
50
+ environment.TIANGONG_LCA_API_BASE_URL = authentication.apiBaseUrl;
51
+ environment.TIANGONG_LCA_SUPABASE_PUBLISHABLE_KEY = authentication.publishableKey;
52
+ environment.TIANGONG_LCA_DISABLE_SESSION_CACHE = "true";
53
+ }
54
+ return environment;
55
+ }
@@ -0,0 +1,31 @@
1
+ import { type FoundryInputFact, type FoundryRuntimeContext } from "./foundry-runtime-context.ts";
2
+ export declare const FOUNDRY_AUTHORIZATION_INPUT_SCHEMA: "tiangong-foundry.authorization-input.v1";
3
+ export interface FoundryAuthorizationInput {
4
+ schema: typeof FOUNDRY_AUTHORIZATION_INPUT_SCHEMA;
5
+ task_id: string;
6
+ actor_id: string;
7
+ finalization_sha256: string;
8
+ dataset_type: string;
9
+ input_kind: "current_rows" | "final_rows";
10
+ input_sha256: string;
11
+ expected_previous_sha256: string | null;
12
+ grant: {
13
+ file: string;
14
+ sha256: string;
15
+ };
16
+ evidence: readonly {
17
+ id: string;
18
+ kind: "user-decision" | "source-model";
19
+ file: string;
20
+ sha256: string;
21
+ }[];
22
+ }
23
+ export interface SelectedAuthorizationInput {
24
+ readonly spec: FoundryAuthorizationInput;
25
+ readonly descriptor: FoundryInputFact;
26
+ readonly grant: FoundryInputFact;
27
+ readonly evidence: readonly FoundryInputFact[];
28
+ }
29
+ export declare function parseFoundryAuthorizationInput(value: unknown): FoundryAuthorizationInput;
30
+ export declare function selectFoundryAuthorizationInput(context: FoundryRuntimeContext, file: string): SelectedAuthorizationInput;
31
+ export declare function assertSelectedAuthorizationInput(value: SelectedAuthorizationInput): void;
@@ -0,0 +1,151 @@
1
+ import fs from "node:fs";
2
+ import path from "node:path";
3
+ import { captureFoundryInput, FoundryContextError, } from "./foundry-runtime-context.js";
4
+ import { assertNotFoundrySessionFile, migrationCredentialPath } from "./foundry-private-path.js";
5
+ import { readSelectedSemanticBytes } from "./foundry-semantic-input.js";
6
+ import { workflowObject } from "./foundry-workflow-state.js";
7
+ export const FOUNDRY_AUTHORIZATION_INPUT_SCHEMA = "tiangong-foundry.authorization-input.v1";
8
+ const sha = /^[0-9a-f]{64}$/u;
9
+ const identifier = /^[a-zA-Z0-9][a-zA-Z0-9._:/-]{0,255}$/u;
10
+ const selections = new WeakSet();
11
+ function invalid(message) {
12
+ throw new FoundryContextError("task_authorization_input_invalid", message);
13
+ }
14
+ function exact(value, keys) {
15
+ if (Object.keys(value).length !== keys.length || keys.some((key) => !Object.hasOwn(value, key)))
16
+ invalid("Authorization input has missing or unsupported fields.");
17
+ }
18
+ function fileReference(value) {
19
+ if (typeof value.file !== "string" ||
20
+ !value.file ||
21
+ value.file.length > 4096 ||
22
+ /[\0\r\n]/u.test(value.file) ||
23
+ typeof value.sha256 !== "string" ||
24
+ !sha.test(value.sha256))
25
+ invalid("Authorization file reference is invalid.");
26
+ return { file: value.file, sha256: value.sha256 };
27
+ }
28
+ export function parseFoundryAuthorizationInput(value) {
29
+ const data = workflowObject(value);
30
+ exact(data, [
31
+ "schema",
32
+ "task_id",
33
+ "actor_id",
34
+ "finalization_sha256",
35
+ "dataset_type",
36
+ "input_kind",
37
+ "input_sha256",
38
+ "expected_previous_sha256",
39
+ "grant",
40
+ "evidence",
41
+ ]);
42
+ if (data.schema !== FOUNDRY_AUTHORIZATION_INPUT_SCHEMA ||
43
+ typeof data.task_id !== "string" ||
44
+ !/^task-[0-9a-f]{64}-r\d{4}$/u.test(data.task_id) ||
45
+ typeof data.actor_id !== "string" ||
46
+ !identifier.test(data.actor_id) ||
47
+ typeof data.finalization_sha256 !== "string" ||
48
+ !sha.test(data.finalization_sha256) ||
49
+ typeof data.input_sha256 !== "string" ||
50
+ !sha.test(data.input_sha256) ||
51
+ typeof data.dataset_type !== "string" ||
52
+ ![
53
+ "flow",
54
+ "process",
55
+ "contact",
56
+ "source",
57
+ "unitgroup",
58
+ "flowproperty",
59
+ "lifecyclemodel",
60
+ ].includes(data.dataset_type) ||
61
+ (data.input_kind !== "current_rows" && data.input_kind !== "final_rows") ||
62
+ (data.expected_previous_sha256 !== null &&
63
+ (typeof data.expected_previous_sha256 !== "string" ||
64
+ !sha.test(data.expected_previous_sha256))) ||
65
+ !Array.isArray(data.evidence) ||
66
+ !data.evidence.length ||
67
+ data.evidence.length > 100)
68
+ invalid("Authorization input must bind a current task, scope, finalization and explicit evidence.");
69
+ const grant = workflowObject(data.grant);
70
+ exact(grant, ["file", "sha256"]);
71
+ const evidence = data.evidence.map((raw) => {
72
+ const item = workflowObject(raw);
73
+ exact(item, ["id", "kind", "file", "sha256"]);
74
+ if (typeof item.id !== "string" ||
75
+ !identifier.test(item.id) ||
76
+ (item.kind !== "user-decision" && item.kind !== "source-model"))
77
+ invalid("Approval evidence identity or kind is invalid.");
78
+ return Object.freeze({ id: item.id, kind: item.kind, ...fileReference(item) });
79
+ });
80
+ if (new Set(evidence.map((item) => item.id)).size !== evidence.length ||
81
+ !evidence.some((item) => item.kind === "user-decision"))
82
+ invalid("Authorization needs unique evidence ids and explicit user-decision evidence.");
83
+ return Object.freeze({
84
+ schema: FOUNDRY_AUTHORIZATION_INPUT_SCHEMA,
85
+ task_id: data.task_id,
86
+ actor_id: data.actor_id,
87
+ finalization_sha256: data.finalization_sha256,
88
+ dataset_type: data.dataset_type,
89
+ input_kind: data.input_kind,
90
+ input_sha256: data.input_sha256,
91
+ expected_previous_sha256: data.expected_previous_sha256,
92
+ grant: Object.freeze(fileReference(grant)),
93
+ evidence: Object.freeze(evidence),
94
+ });
95
+ }
96
+ export function selectFoundryAuthorizationInput(context, file) {
97
+ let bytes = 0;
98
+ const select = (input) => {
99
+ if (!input || input.length > 4096 || /[\0\r\n]/u.test(input))
100
+ invalid("Authorization input path is invalid.");
101
+ const target = path.resolve(context.workspaceRoot, input);
102
+ if (migrationCredentialPath(path.relative(context.workspaceRoot, target)))
103
+ invalid("Credential paths cannot be approval evidence.");
104
+ assertNotFoundrySessionFile(target, context.accountIntent?.sessionReference);
105
+ const stat = fs.lstatSync(target);
106
+ if (!stat.isFile() || stat.isSymbolicLink() || stat.size > 8 * 1024 * 1024)
107
+ invalid("Approval input must be a bounded regular file.");
108
+ bytes += stat.size;
109
+ if (bytes > 64 * 1024 * 1024)
110
+ invalid("Approval input exceeds the 64 MiB batch limit.");
111
+ return Object.freeze(captureFoundryInput(target));
112
+ };
113
+ const descriptor = select(file);
114
+ let spec;
115
+ try {
116
+ spec = parseFoundryAuthorizationInput(JSON.parse(readSelectedSemanticBytes(descriptor).toString("utf8")));
117
+ }
118
+ catch {
119
+ invalid("Approval input must be a complete supported JSON descriptor.");
120
+ }
121
+ if (spec.task_id !== context.taskId || spec.actor_id !== context.actorId)
122
+ invalid("Approval task or actor differs from the current invocation.");
123
+ const selected = [spec.grant, ...spec.evidence].map((item) => {
124
+ const fact = select(item.file);
125
+ if (fact.sha256 !== item.sha256)
126
+ invalid("Approval bytes differ from the selected digest.");
127
+ readSelectedSemanticBytes(fact);
128
+ return fact;
129
+ });
130
+ try {
131
+ workflowObject(JSON.parse(readSelectedSemanticBytes(selected[0]).toString("utf8")));
132
+ }
133
+ catch {
134
+ invalid("The selected grant must be a complete JSON object.");
135
+ }
136
+ Object.freeze(spec.evidence);
137
+ const result = Object.freeze({
138
+ spec,
139
+ descriptor,
140
+ grant: selected[0],
141
+ evidence: Object.freeze(selected.slice(1)),
142
+ });
143
+ selections.add(result);
144
+ return result;
145
+ }
146
+ export function assertSelectedAuthorizationInput(value) {
147
+ if (!selections.has(value))
148
+ invalid("Approval input must be independently selected by the current host.");
149
+ for (const fact of [value.descriptor, value.grant, ...value.evidence])
150
+ readSelectedSemanticBytes(fact);
151
+ }
@@ -0,0 +1,32 @@
1
+ export type CommandCategory = "public" | "workflow-internal" | "cli-wrapper";
2
+ export type CommandKeyTest = {
3
+ kind: "command-smoke";
4
+ command: string;
5
+ } | {
6
+ kind: "golden-diff";
7
+ path: string;
8
+ } | {
9
+ kind: "node-test";
10
+ path: string;
11
+ assertion: string;
12
+ };
13
+ export type CommandWorkflowEntry = {
14
+ status: string;
15
+ entry_kind: string;
16
+ };
17
+ export type FoundryCommandMetadata = {
18
+ category: CommandCategory;
19
+ ownerModule: string;
20
+ ownerExport: string;
21
+ navigationPath: string[];
22
+ inputs: string[];
23
+ outputs: string[];
24
+ keyTests: CommandKeyTest[];
25
+ workflowEntry: CommandWorkflowEntry;
26
+ };
27
+ export declare const commandCategories: CommandCategory[];
28
+ export declare const commandMetadata: Record<string, FoundryCommandMetadata>;
29
+ export declare function commandMetadataEntries(): Array<FoundryCommandMetadata & {
30
+ command: string;
31
+ }>;
32
+ export declare function commandMetadataFor(command: string): FoundryCommandMetadata | null;