@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,132 @@
1
+ import fs from "node:fs";
2
+ import path from "node:path";
3
+ export function nowIso() {
4
+ return new Date().toISOString();
5
+ }
6
+ export function ensureArray(value) {
7
+ if (Array.isArray(value))
8
+ return value;
9
+ if (value === undefined || value === null)
10
+ return [];
11
+ return [value];
12
+ }
13
+ export function readText(filePath) {
14
+ return fs.readFileSync(filePath, "utf8");
15
+ }
16
+ export function writeText(filePath, text) {
17
+ fs.mkdirSync(path.dirname(filePath), { recursive: true });
18
+ fs.writeFileSync(filePath, text);
19
+ }
20
+ // Stream rows to a JSONL file one line at a time. Equivalent output to
21
+ // writeText(filePath, jsonLines(rows)), but never materializes the whole file
22
+ // as a single JS string — mega-scopes (thousands of large mutation items) can
23
+ // exceed V8's max string length (RangeError: Invalid string length) when the
24
+ // rows are JSON.stringify-joined in memory.
25
+ export function writeJsonLines(filePath, rows) {
26
+ fs.mkdirSync(path.dirname(filePath), { recursive: true });
27
+ const fd = fs.openSync(filePath, "w");
28
+ try {
29
+ for (const row of ensureArray(rows)) {
30
+ fs.writeSync(fd, `${JSON.stringify(row)}\n`);
31
+ }
32
+ }
33
+ finally {
34
+ fs.closeSync(fd);
35
+ }
36
+ }
37
+ export function readJson(filePath) {
38
+ return JSON.parse(readText(filePath));
39
+ }
40
+ export function readJsonIfExists(filePath) {
41
+ return fileExists(filePath) ? readJson(filePath) : null;
42
+ }
43
+ export function writeJson(filePath, data) {
44
+ writeText(filePath, `${JSON.stringify(data, null, 2)}\n`);
45
+ }
46
+ export function fileExists(filePath) {
47
+ return Boolean(filePath && fs.existsSync(filePath) && fs.statSync(filePath).isFile());
48
+ }
49
+ export function directoryExists(filePath) {
50
+ return Boolean(filePath && fs.existsSync(filePath) && fs.statSync(filePath).isDirectory());
51
+ }
52
+ export function resolveRepoPath(repoRoot, filePath) {
53
+ if (!filePath)
54
+ return null;
55
+ return path.isAbsolute(filePath) ? filePath : path.join(repoRoot, filePath);
56
+ }
57
+ export function repoRelativePath(repoRoot, filePath) {
58
+ return path.relative(repoRoot, filePath).split(path.sep).join(path.posix.sep);
59
+ }
60
+ export function normalizedArtifactPath(repoRoot, value) {
61
+ const text = asText(value);
62
+ if (!text)
63
+ return null;
64
+ return path.resolve(resolveRepoPath(repoRoot, text));
65
+ }
66
+ export function sameArtifactPath(repoRoot, left, right) {
67
+ const resolvedLeft = normalizedArtifactPath(repoRoot, left);
68
+ const resolvedRight = normalizedArtifactPath(repoRoot, right);
69
+ return Boolean(resolvedLeft && resolvedRight && resolvedLeft === resolvedRight);
70
+ }
71
+ export function repoRelativeArtifactPath(repoRoot, value) {
72
+ const resolved = normalizedArtifactPath(repoRoot, value);
73
+ return resolved ? repoRelativePath(repoRoot, resolved) : null;
74
+ }
75
+ export function readJsonOrJsonl(filePath, reader) {
76
+ const text = (reader ?? readText)(filePath).trim();
77
+ if (!text)
78
+ return [];
79
+ if (filePath.endsWith(".jsonl")) {
80
+ return text
81
+ .split(/\r?\n/u)
82
+ .filter(Boolean)
83
+ .map((line) => JSON.parse(line));
84
+ }
85
+ return reader ? JSON.parse(text) : readJson(filePath);
86
+ }
87
+ export function readRows(filePath, reader) {
88
+ const parsed = readJsonOrJsonl(filePath, reader);
89
+ if (Array.isArray(parsed))
90
+ return parsed;
91
+ const record = parsed && typeof parsed === "object" ? parsed : undefined;
92
+ if (Array.isArray(record?.rows))
93
+ return record.rows;
94
+ if (Array.isArray(record?.processes))
95
+ return record.processes;
96
+ if (Array.isArray(record?.flows))
97
+ return record.flows;
98
+ if (Array.isArray(record?.lifecyclemodels))
99
+ return record.lifecyclemodels;
100
+ return [parsed];
101
+ }
102
+ export function optionList(value) {
103
+ if (Array.isArray(value))
104
+ return value.flatMap((item) => optionList(item));
105
+ if (value === undefined || value === null || value === "")
106
+ return [];
107
+ return String(value)
108
+ .split(",")
109
+ .map((item) => item.trim())
110
+ .filter(Boolean);
111
+ }
112
+ export function jsonLines(rows) {
113
+ return rows.map((row) => JSON.stringify(row)).join("\n") + (rows.length ? "\n" : "");
114
+ }
115
+ export function unique(values) {
116
+ return [...new Set(ensureArray(values).filter(Boolean))];
117
+ }
118
+ export function sanitizeFileName(value) {
119
+ return (String(value ?? "missing")
120
+ .replace(/[^A-Za-z0-9._-]+/gu, "_")
121
+ .replace(/^_+|_+$/gu, "") || "missing");
122
+ }
123
+ export function asText(value) {
124
+ if (value === undefined || value === null)
125
+ return "";
126
+ if (typeof value === "string")
127
+ return value.trim();
128
+ if (typeof value === "number" || typeof value === "boolean") {
129
+ return String(value);
130
+ }
131
+ return "";
132
+ }
@@ -0,0 +1,53 @@
1
+ export type CollectedTraceEntry = {
2
+ path: string;
3
+ entry: unknown;
4
+ };
5
+ export type CompactFoundryTraceEntry = {
6
+ dataset_type: string;
7
+ entity_id: unknown;
8
+ version: unknown;
9
+ row_index: number;
10
+ trace_kind: string;
11
+ path: string | null;
12
+ status: string | null;
13
+ action_item_code: string | null;
14
+ reference_id: string | null;
15
+ reference_version: string | null;
16
+ blocked_path: string | null;
17
+ reason: string | null;
18
+ next_action: string | null;
19
+ evidence: unknown;
20
+ trace_sha256: string;
21
+ };
22
+ export declare function traceSummaryCount(value: unknown): number;
23
+ export declare function collectCommonOtherTraceEntries(value: unknown, traceKey: string, basePath?: string): CollectedTraceEntry[];
24
+ export declare function compactFoundryTraceEntry({ datasetType, identity, rowIndex, traceKind, trace, }: {
25
+ datasetType: string;
26
+ identity: {
27
+ id: unknown;
28
+ version: unknown;
29
+ };
30
+ rowIndex: number;
31
+ traceKind: string;
32
+ trace: CollectedTraceEntry | {
33
+ path?: string | null;
34
+ entry?: unknown;
35
+ };
36
+ }): CompactFoundryTraceEntry;
37
+ export declare function foundryTraceSummary({ datasetType, identity, row, rowIndex, }: {
38
+ datasetType: string;
39
+ identity: {
40
+ id: unknown;
41
+ version: unknown;
42
+ };
43
+ row: unknown;
44
+ rowIndex: number;
45
+ }): {
46
+ import_trace_summary_count: number;
47
+ unresolved_trace_count: number;
48
+ unresolved_exchange_trace_count: number;
49
+ source_exchange_completeness_count: number;
50
+ unresolved_traces: CompactFoundryTraceEntry[];
51
+ unresolved_exchange_traces: CompactFoundryTraceEntry[];
52
+ source_exchange_completeness: CompactFoundryTraceEntry[];
53
+ };
@@ -0,0 +1,114 @@
1
+ import { sha256Text } from "./hash-utils.js";
2
+ import { asText, ensureArray } from "./runtime-io.js";
3
+ export function traceSummaryCount(value) {
4
+ let count = 0;
5
+ const visit = (node) => {
6
+ if (!node || typeof node !== "object")
7
+ return;
8
+ if (Array.isArray(node)) {
9
+ for (const item of node)
10
+ visit(item);
11
+ return;
12
+ }
13
+ const record = node;
14
+ const other = record["common:other"];
15
+ if (other && typeof other === "object" && !Array.isArray(other)) {
16
+ count += ensureArray(other["tiangongfoundry:importTraceSummary"]).length;
17
+ }
18
+ for (const child of Object.values(record))
19
+ visit(child);
20
+ };
21
+ visit(value);
22
+ return count;
23
+ }
24
+ export function collectCommonOtherTraceEntries(value, traceKey, basePath = "$") {
25
+ const entries = [];
26
+ const visit = (node, currentPath) => {
27
+ if (!node || typeof node !== "object")
28
+ return;
29
+ if (Array.isArray(node)) {
30
+ node.forEach((item, index) => visit(item, `${currentPath}[${index}]`));
31
+ return;
32
+ }
33
+ const record = node;
34
+ const other = record["common:other"];
35
+ if (other && typeof other === "object" && !Array.isArray(other)) {
36
+ const traceValue = other[traceKey];
37
+ if (traceValue !== undefined) {
38
+ ensureArray(traceValue).forEach((entry, index) => {
39
+ entries.push({
40
+ path: `${currentPath}.common:other.${traceKey}${Array.isArray(traceValue) ? `[${index}]` : ""}`,
41
+ entry,
42
+ });
43
+ });
44
+ }
45
+ }
46
+ Object.entries(record).forEach(([key, child]) => {
47
+ if (key === "common:other")
48
+ return;
49
+ visit(child, `${currentPath}.${key}`);
50
+ });
51
+ };
52
+ visit(value, basePath);
53
+ return entries;
54
+ }
55
+ // part-08.mjs
56
+ export function compactFoundryTraceEntry({ datasetType, identity, rowIndex, traceKind, trace, }) {
57
+ const entry = trace?.entry && typeof trace.entry === "object" && !Array.isArray(trace.entry)
58
+ ? trace.entry
59
+ : { value: trace?.entry ?? null };
60
+ return {
61
+ dataset_type: datasetType,
62
+ entity_id: identity.id,
63
+ version: identity.version,
64
+ row_index: rowIndex,
65
+ trace_kind: traceKind,
66
+ path: trace?.path ?? null,
67
+ status: asText(entry.status ?? entry.decision_status ?? entry.decisionStatus) || null,
68
+ action_item_code: asText(entry.action_item_code ?? entry.actionItemCode ?? entry.code) || null,
69
+ reference_id: asText(entry.reference_id ?? entry.referenceId ?? entry.ref_object_id ?? entry.refObjectId) ||
70
+ null,
71
+ reference_version: asText(entry.reference_version ?? entry.referenceVersion ?? entry.ref_version ?? entry.refVersion) || null,
72
+ blocked_path: asText(entry.blocked_path ??
73
+ entry.blockedPath ??
74
+ entry.field_path ??
75
+ entry.fieldPath ??
76
+ entry.path) || null,
77
+ reason: asText(entry.reason ?? entry.deferred_reason ?? entry.deferredReason) || null,
78
+ next_action: asText(entry.next_action ?? entry.nextAction ?? entry.follow_up ?? entry.followUp) || null,
79
+ evidence: entry.evidence ?? entry.source_evidence ?? entry.sourceEvidence ?? entry.trace ?? null,
80
+ trace_sha256: sha256Text(JSON.stringify(entry)),
81
+ };
82
+ }
83
+ export function foundryTraceSummary({ datasetType, identity, row, rowIndex, }) {
84
+ const unresolved = collectCommonOtherTraceEntries(row, "tiangongfoundry:unresolvedTrace").map((trace) => compactFoundryTraceEntry({
85
+ datasetType,
86
+ identity,
87
+ rowIndex,
88
+ traceKind: "unresolved_trace",
89
+ trace,
90
+ }));
91
+ const sourceExchangeCompleteness = collectCommonOtherTraceEntries(row, "tiangongfoundry:sourceExchangeCompleteness").map((trace) => compactFoundryTraceEntry({
92
+ datasetType,
93
+ identity,
94
+ rowIndex,
95
+ traceKind: "source_exchange_completeness",
96
+ trace,
97
+ }));
98
+ const unresolvedExchange = collectCommonOtherTraceEntries(row, "tiangongfoundry:unresolvedExchangeTrace").map((trace) => compactFoundryTraceEntry({
99
+ datasetType,
100
+ identity,
101
+ rowIndex,
102
+ traceKind: "unresolved_exchange_trace",
103
+ trace,
104
+ }));
105
+ return {
106
+ import_trace_summary_count: traceSummaryCount(row),
107
+ unresolved_trace_count: unresolved.length,
108
+ unresolved_exchange_trace_count: unresolvedExchange.length,
109
+ source_exchange_completeness_count: sourceExchangeCompleteness.length,
110
+ unresolved_traces: unresolved,
111
+ unresolved_exchange_traces: unresolvedExchange,
112
+ source_exchange_completeness: sourceExchangeCompleteness,
113
+ };
114
+ }
@@ -0,0 +1,141 @@
1
+ import { type DatasetType } from "./dataset-types.ts";
2
+ interface JsonRecord {
3
+ [key: string]: unknown;
4
+ }
5
+ interface FullContextBlockerOptions {
6
+ repoRoot: string;
7
+ packagePayload: unknown;
8
+ actionItems: unknown;
9
+ packagePath?: string | null;
10
+ }
11
+ interface TaskReadinessOptions {
12
+ repoRoot: string;
13
+ task: unknown;
14
+ }
15
+ interface AuthoringBuildOptions extends JsonRecord {
16
+ includeExecutionCommands?: boolean;
17
+ patchFile?: string;
18
+ patch?: string;
19
+ patchedRows?: string;
20
+ out?: string;
21
+ applyDir?: string;
22
+ }
23
+ interface BuildAuthoringTaskOptions {
24
+ repoRoot: string;
25
+ packagePath: string;
26
+ outDir: string;
27
+ options?: AuthoringBuildOptions;
28
+ }
29
+ interface AuthoringEntity extends JsonRecord {
30
+ dataset_type: DatasetType;
31
+ entity_id: string;
32
+ version: string;
33
+ profile: string | null;
34
+ }
35
+ interface AuthoringContext extends JsonRecord {
36
+ source_rows_file: string | null;
37
+ authoring_package_sha256: string;
38
+ profile_context_files: JsonRecord[];
39
+ contract_context_files: JsonRecord[];
40
+ full_context_ai_completion: unknown;
41
+ missing_context_files: unknown[];
42
+ curation_queue_status: unknown;
43
+ shared_context_bundle?: SharedContextBundleRef;
44
+ }
45
+ interface AuthoringFiles extends JsonRecord {
46
+ authoring_package: string;
47
+ task_json: string;
48
+ task_markdown: string;
49
+ patch_template: string;
50
+ output_patch_file: string;
51
+ patched_rows: string;
52
+ apply_dir: string;
53
+ }
54
+ interface AuthoringCommands extends JsonRecord {
55
+ apply_patch: string | null;
56
+ validate_after_apply: string | null;
57
+ }
58
+ interface AuthoringActionItem extends JsonRecord {
59
+ index: number;
60
+ code: string;
61
+ path: string | null;
62
+ json_pointer: string;
63
+ message: string | null;
64
+ instruction: string | null;
65
+ allowed_resolution_modes: string[];
66
+ evidence: unknown;
67
+ }
68
+ interface AuthoringTask extends JsonRecord {
69
+ status: string;
70
+ entity: AuthoringEntity;
71
+ context: AuthoringContext;
72
+ action_items: AuthoringActionItem[];
73
+ decision_only_action_items: AuthoringActionItem[];
74
+ blockers: JsonRecord[];
75
+ files: AuthoringFiles;
76
+ commands: AuthoringCommands;
77
+ }
78
+ interface SharedContextOptions extends JsonRecord {
79
+ includeExecutionCommands?: boolean;
80
+ sharedContextCacheDir?: string | null;
81
+ }
82
+ interface SharedContextBundleRef extends JsonRecord {
83
+ path: string;
84
+ sha256: string;
85
+ counts: SharedContextCounts;
86
+ cache: JsonRecord;
87
+ instruction: string;
88
+ }
89
+ interface SharedContextCounts extends JsonRecord {
90
+ tasks: number;
91
+ authoring_packages: number;
92
+ files: number;
93
+ references: number;
94
+ duplicate_references: number;
95
+ unique_context_bytes: number;
96
+ referenced_context_bytes: number;
97
+ duplicate_context_bytes_avoided: number;
98
+ }
99
+ interface SharedContextBundle extends JsonRecord {
100
+ sha256: string;
101
+ counts: SharedContextCounts;
102
+ }
103
+ interface SharedContextBuildResult {
104
+ path: string;
105
+ bundle: SharedContextBundle;
106
+ cache: JsonRecord;
107
+ }
108
+ interface EvidenceOperationOptions {
109
+ operation: unknown;
110
+ task: unknown;
111
+ }
112
+ export declare function authoringPackageFullContextReadinessBlockers({ repoRoot, packagePayload, actionItems, packagePath, }: FullContextBlockerOptions): JsonRecord[];
113
+ export declare function authoringTaskFullContextReadinessBlockers({ repoRoot, task, }: TaskReadinessOptions): JsonRecord[];
114
+ export declare function shellQuote(value: unknown): string;
115
+ export declare function renderAuthoringTaskMarkdown(task: AuthoringTask): string;
116
+ export declare function buildDatasetAuthoringTaskFromPackage({ repoRoot, packagePath, outDir, options, }: BuildAuthoringTaskOptions): AuthoringTask;
117
+ export declare function shouldBuildAuthoringTaskFromEntity(entity: unknown, includeReady: boolean): boolean;
118
+ export declare function authoringPackageEntriesFromGate(repoRoot: string, reportPath: string, includeReady: boolean): JsonRecord[];
119
+ export declare function buildSharedAuthoringContextBundle(repoRoot: string, outDir: string, tasks: AuthoringTask[], source: unknown, options?: SharedContextOptions): SharedContextBuildResult;
120
+ export declare function attachSharedContextBundleToTask(task: AuthoringTask, sharedContextBundle: SharedContextBundleRef): AuthoringTask;
121
+ export declare function rewriteAuthoringTaskFile(repoRoot: string, task: AuthoringTask): void;
122
+ export declare function writeAuthoringTaskBatchManifest(repoRoot: string, outDir: string, tasks: AuthoringTask[], source: unknown, options?: SharedContextOptions): JsonRecord;
123
+ export declare function patchSetOperations(value: unknown): JsonRecord[] | null;
124
+ export declare function patchPayloadPatchSets(rawPatch: unknown): unknown[];
125
+ export declare function patchSetDatasetId(patchSet: unknown): string;
126
+ export declare function patchSetDatasetVersion(patchSet: unknown): string;
127
+ export declare function patchSetAuthoringPackage(patchSet: unknown): string;
128
+ export declare function operationHasEvidence(operation: unknown): boolean;
129
+ export declare function taskRequiresFullContextEvidence(task: unknown): boolean;
130
+ export declare function evidenceEntries(value: unknown): unknown[];
131
+ export declare function firstNonEmptyEvidenceValue(entry: unknown, keys: readonly string[]): string;
132
+ export declare const evidenceSourceKeys: string[];
133
+ export declare const evidenceTraceKeys: string[];
134
+ export declare function operationFullContextEvidenceBlockers({ operation, task, }: EvidenceOperationOptions): JsonRecord[];
135
+ export declare function operationResolution(operation: unknown): JsonRecord | null;
136
+ export declare function operationResolutionMode(operation: unknown): string;
137
+ export declare function operationUsedContextKinds(operation: unknown): string[];
138
+ export declare function taskRequiredContextKinds(task: unknown): string[];
139
+ export declare function operationTouchesCommonOther(operation: unknown): boolean;
140
+ export declare function hasNonEmptyTraceEvidence(value: unknown): boolean;
141
+ export {};