@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,527 @@
1
+ import fs from "node:fs";
2
+ import path from "node:path";
3
+ export function createCanonicalSupportRewriteUtils({ asText, booleanOption, cloneJson, datasetIdentity, datasetRowsFileStem, ensureArray, fileExists, multiLang, nowIso, pathExpression, readJson, readRowsFile, repoRelativeMaybe, repoRelativePath, resolveRepoPath, writeJson, writeJsonLines, }) {
4
+ const defaultCanonicalSupportCacheFile = "specs/canonical-support/flow-properties-unit-groups.json";
5
+ function supportText(value) {
6
+ if (value === undefined || value === null)
7
+ return "";
8
+ if (typeof value === "string" || typeof value === "number")
9
+ return String(value).trim();
10
+ if (Array.isArray(value)) {
11
+ return value.map(supportText).filter(Boolean).join(" | ");
12
+ }
13
+ if (typeof value === "object") {
14
+ const record = value;
15
+ if (typeof record["#text"] === "string")
16
+ return record["#text"].trim();
17
+ return Object.values(record).map(supportText).filter(Boolean).join(" | ");
18
+ }
19
+ return "";
20
+ }
21
+ function normalizeSupportKey(value) {
22
+ return String(value ?? "")
23
+ .trim()
24
+ .toLowerCase()
25
+ .replace(/\u00b2/gu, "2")
26
+ .replace(/\u00b3/gu, "3")
27
+ .replace(/\u00b5/gu, "u")
28
+ .replace(/[\u00b7\u2219]/gu, "*")
29
+ .replace(/\s+/gu, "")
30
+ .replace(/\./gu, "");
31
+ }
32
+ // Resolve the scale factor that converts an amount in `unit` into the canonical
33
+ // Flow Property's reference unit (e.g. kWh -> MJ = 3.6, t*km -> kg*km = 1000).
34
+ // The factor lives in the mapping's source_unit_scales (authoritative, sourced
35
+ // from the canonical UnitGroup mean values); 1 means no conversion is needed.
36
+ function resolveAmountScale(mapping, unit, normalizedUnit) {
37
+ const scales = mapping?.source_unit_scales;
38
+ if (!scales || typeof scales !== "object")
39
+ return null;
40
+ const scaleRecord = scales;
41
+ if (Object.hasOwn(scaleRecord, unit))
42
+ return Number(scaleRecord[unit]);
43
+ if (Object.hasOwn(scaleRecord, normalizedUnit))
44
+ return Number(scaleRecord[normalizedUnit]);
45
+ for (const [key, value] of Object.entries(scaleRecord)) {
46
+ if (normalizeSupportKey(key) === normalizedUnit)
47
+ return Number(value);
48
+ }
49
+ return null;
50
+ }
51
+ function canonicalSupportCachePath(options = {}) {
52
+ return resolveRepoPath(options.canonicalSupportCache ||
53
+ options.supportCache ||
54
+ options.cacheFile ||
55
+ defaultCanonicalSupportCacheFile);
56
+ }
57
+ function flowPropertyReferenceText(reference) {
58
+ return supportText(reference?.["common:shortDescription"] ?? reference?.shortDescription ?? reference?.name);
59
+ }
60
+ function unitFromFlowPropertyReference(reference) {
61
+ const text = flowPropertyReferenceText(reference);
62
+ const match = text.match(/^amount\s+in\s+(.+)$/iu);
63
+ return match ? match[1].trim() : text;
64
+ }
65
+ function buildCanonicalSupportIndex(cache) {
66
+ const flowPropertyById = new Map();
67
+ for (const value of ensureArray(cache?.flow_properties)) {
68
+ const row = value;
69
+ const id = asText(row?.id);
70
+ if (id)
71
+ flowPropertyById.set(id, row);
72
+ }
73
+ const unitGroupById = new Map();
74
+ for (const value of ensureArray(cache?.unit_groups)) {
75
+ const row = value;
76
+ const id = asText(row?.id);
77
+ if (id)
78
+ unitGroupById.set(id, row);
79
+ }
80
+ const flowPropertyMappingByUnit = new Map();
81
+ for (const value of ensureArray(cache?.flow_property_mappings)) {
82
+ const mapping = value;
83
+ const canonicalId = asText(mapping?.canonical_flow_property_id);
84
+ for (const unit of ensureArray(mapping?.source_units)) {
85
+ const key = normalizeSupportKey(unit);
86
+ if (key)
87
+ flowPropertyMappingByUnit.set(key, { ...mapping, canonicalId });
88
+ }
89
+ }
90
+ return { flowPropertyById, flowPropertyMappingByUnit, unitGroupById };
91
+ }
92
+ function loadCanonicalSupportCache(options = {}) {
93
+ const cachePath = canonicalSupportCachePath(options);
94
+ if (!cachePath || !fileExists(cachePath)) {
95
+ return { cache: null, cachePath, index: buildCanonicalSupportIndex(null) };
96
+ }
97
+ const cache = readJson(cachePath);
98
+ return { cache, cachePath, index: buildCanonicalSupportIndex(cache) };
99
+ }
100
+ function canonicalFlowPropertyReference(entry, language = "en") {
101
+ const id = asText(entry?.id);
102
+ const version = asText(entry?.version);
103
+ const rawShortDescription = supportText(entry?.reference_short_description) ||
104
+ supportText(entry?.short_description) ||
105
+ supportText(entry?.name) ||
106
+ id;
107
+ const shortDescription = rawShortDescription.split("|")[0].trim() || id;
108
+ return {
109
+ "@type": "flow property data set",
110
+ "@refObjectId": id,
111
+ "@version": version,
112
+ "@uri": `../flowproperties/${id}.json`,
113
+ "common:shortDescription": multiLang(shortDescription, language),
114
+ };
115
+ }
116
+ function canonicalFlowPropertyUnitGroupProof(entry, cacheContext) {
117
+ const referenceUnitGroup = (entry?.reference_unit_group ?? {});
118
+ const unitGroupId = asText(referenceUnitGroup.id ??
119
+ referenceUnitGroup.ref_object_id ??
120
+ referenceUnitGroup["@refObjectId"]);
121
+ const unitGroup = unitGroupId ? cacheContext.index.unitGroupById.get(unitGroupId) : null;
122
+ const unitGroupVersion = asText(referenceUnitGroup.version ?? referenceUnitGroup["@version"]) ||
123
+ asText(unitGroup?.version) ||
124
+ null;
125
+ const shortDescription = supportText(referenceUnitGroup.short_description) ||
126
+ supportText(referenceUnitGroup["common:shortDescription"]) ||
127
+ supportText(unitGroup?.short_description) ||
128
+ supportText(unitGroup?.name) ||
129
+ null;
130
+ return {
131
+ proven: Boolean(unitGroupId && unitGroup),
132
+ ref_object_id: unitGroupId || null,
133
+ version: unitGroupVersion,
134
+ short_description: shortDescription,
135
+ };
136
+ }
137
+ function rewriteCanonicalFlowPropertyReferences(value, { cacheContext, datasetType, sourceFile, stats, rewriteRows, blockers, scalingRequirements = [], blockOnUnscaled = false, datasetIdentityCache, rowIndex = null, language = "en", pathSegments = [], allowAccountLocalSupportAndElementary = false, }) {
138
+ if (!value || typeof value !== "object")
139
+ return;
140
+ if (Array.isArray(value)) {
141
+ value.forEach((item, index) => rewriteCanonicalFlowPropertyReferences(item, {
142
+ cacheContext,
143
+ datasetType,
144
+ sourceFile,
145
+ stats,
146
+ rewriteRows,
147
+ blockers,
148
+ scalingRequirements,
149
+ blockOnUnscaled,
150
+ datasetIdentityCache,
151
+ rowIndex,
152
+ language,
153
+ pathSegments: [...pathSegments, index],
154
+ allowAccountLocalSupportAndElementary,
155
+ }));
156
+ return;
157
+ }
158
+ const record = value;
159
+ for (const [key, child] of Object.entries(record)) {
160
+ const childPath = [...pathSegments, key];
161
+ if (key === "referenceToFlowPropertyDataSet" &&
162
+ child &&
163
+ typeof child === "object" &&
164
+ !Array.isArray(child)) {
165
+ const reference = child;
166
+ const originalId = asText(reference["@refObjectId"]);
167
+ const originalVersion = asText(reference["@version"]);
168
+ const unit = unitFromFlowPropertyReference(reference);
169
+ const normalizedUnit = normalizeSupportKey(unit);
170
+ const alreadyCanonical = originalId && cacheContext.index.flowPropertyById.has(originalId);
171
+ const mapping = cacheContext.index.flowPropertyMappingByUnit.get(normalizedUnit);
172
+ const canonical = mapping
173
+ ? cacheContext.index.flowPropertyById.get(mapping.canonicalId)
174
+ : null;
175
+ const provenCanonical = alreadyCanonical
176
+ ? cacheContext.index.flowPropertyById.get(originalId)
177
+ : canonical;
178
+ const unitGroupProof = provenCanonical
179
+ ? canonicalFlowPropertyUnitGroupProof(provenCanonical, cacheContext)
180
+ : null;
181
+ if (provenCanonical && !unitGroupProof?.proven) {
182
+ // Override: when the BAFU profile may mint account-local support, do not block on
183
+ // an unproven canonical Unit Group; leave the source flow-property reference as-is
184
+ // so it is written as a My Data (state_code=0) FP/UG keeping its source unit.
185
+ if (!allowAccountLocalSupportAndElementary) {
186
+ blockers.push({
187
+ code: "canonical_flow_property_unit_group_unproven",
188
+ message: "The selected canonical Flow Property must prove its Reference Unit Group through the local canonical support cache. Foundry must not create account-local Unit Group support rows.",
189
+ dataset_type: datasetType,
190
+ dataset_id: datasetIdentityCache?.id ?? null,
191
+ dataset_version: datasetIdentityCache?.version ?? null,
192
+ row_index: rowIndex,
193
+ source_file: repoRelativeMaybe(sourceFile),
194
+ path: pathExpression(childPath),
195
+ source_unit: unit || null,
196
+ original_ref_object_id: originalId || null,
197
+ canonical_flow_property_id: asText(provenCanonical.id) || null,
198
+ canonical_reference_unit_group_id: unitGroupProof?.ref_object_id ?? null,
199
+ required_resolution: "Refresh specs/canonical-support/flow-properties-unit-groups.json from the database or select a canonical Flow Property whose Reference Unit Group is present in that cache.",
200
+ });
201
+ }
202
+ continue;
203
+ }
204
+ // Account-local override: a flow that ALREADY references the canonical FP
205
+ // UUID but at a stale version (e.g. a BAFU source flow referencing the Time
206
+ // FP @00.00.001 while the written My Data FP is @01.00.000) must be bumped to
207
+ // the cached canonical version. Otherwise every downstream remote-verify layer
208
+ // (reference closure, precommit verify, post-write readback) reports the
209
+ // reference as `version_outdated` and blocks the scope. The support-cache rewrite
210
+ // normally only swaps non-canonical UUIDs, so it would leave the stale version
211
+ // untouched; here we repoint the existing canonical reference to its latest
212
+ // proven version. Account-local minted FP/UG keep their source unit, so no scale
213
+ // conversion applies to this version bump.
214
+ if (allowAccountLocalSupportAndElementary && alreadyCanonical && provenCanonical) {
215
+ const cachedVersion = asText(provenCanonical.version);
216
+ if (cachedVersion && cachedVersion !== originalVersion) {
217
+ const next = canonicalFlowPropertyReference(provenCanonical, language);
218
+ record[key] = next;
219
+ stats.canonical_flow_property_reference_rewrites =
220
+ Number(stats.canonical_flow_property_reference_rewrites ?? 0) + 1;
221
+ stats.canonical_unit_group_reference_proofs =
222
+ Number(stats.canonical_unit_group_reference_proofs ?? 0) + 1;
223
+ rewriteRows.push({
224
+ relation: "flow_property_reference_version_bump_to_canonical_support",
225
+ dataset_type: datasetType,
226
+ dataset_id: datasetIdentityCache?.id ?? null,
227
+ dataset_version: datasetIdentityCache?.version ?? null,
228
+ row_index: rowIndex,
229
+ source_file: repoRelativeMaybe(sourceFile),
230
+ path: pathExpression(childPath),
231
+ source_unit: unit || null,
232
+ canonical_reference_unit: mapping?.canonical_reference_unit ?? null,
233
+ amount_scale_to_canonical_reference: 1,
234
+ amount_scaling_required: false,
235
+ original: {
236
+ ref_object_id: originalId || null,
237
+ version: originalVersion || null,
238
+ short_description: flowPropertyReferenceText(reference) || null,
239
+ },
240
+ canonical: {
241
+ ref_object_id: next["@refObjectId"],
242
+ version: next["@version"],
243
+ short_description: next["common:shortDescription"]["#text"],
244
+ },
245
+ canonical_reference_unit_group: unitGroupProof,
246
+ mapping_reason: "Account-local canonical Flow Property version bump to the latest written My Data version.",
247
+ });
248
+ }
249
+ continue;
250
+ }
251
+ if (!alreadyCanonical && mapping && canonical) {
252
+ const next = canonicalFlowPropertyReference(canonical, language);
253
+ record[key] = next;
254
+ stats.canonical_flow_property_reference_rewrites =
255
+ Number(stats.canonical_flow_property_reference_rewrites ?? 0) + 1;
256
+ stats.canonical_unit_group_reference_proofs =
257
+ Number(stats.canonical_unit_group_reference_proofs ?? 0) + 1;
258
+ // The source unit may differ in scale from the canonical reference unit
259
+ // (e.g. kWh->MJ = 3.6, t*km->kg*km = 1000). The rewrite only swaps the FP
260
+ // pointer; exchange amounts are NOT converted here, so any scale != 1 must
261
+ // be surfaced (and optionally block) rather than silently shipped. The
262
+ // documented profile policy requires explicit scaling, not silent magic.
263
+ const amountScale = resolveAmountScale(mapping, unit, normalizedUnit);
264
+ const scaleResolved = amountScale !== null && Number.isFinite(amountScale);
265
+ const needsScaling = scaleResolved && amountScale !== 1;
266
+ const scaleInvalid = !scaleResolved || amountScale <= 0;
267
+ rewriteRows.push({
268
+ relation: "flow_property_reference_to_canonical_support",
269
+ dataset_type: datasetType,
270
+ dataset_id: datasetIdentityCache?.id ?? null,
271
+ dataset_version: datasetIdentityCache?.version ?? null,
272
+ row_index: rowIndex,
273
+ source_file: repoRelativeMaybe(sourceFile),
274
+ path: pathExpression(childPath),
275
+ source_unit: unit,
276
+ canonical_reference_unit: mapping.canonical_reference_unit ?? null,
277
+ amount_scale_to_canonical_reference: scaleResolved ? amountScale : null,
278
+ amount_scaling_required: needsScaling,
279
+ original: {
280
+ ref_object_id: originalId || null,
281
+ version: originalVersion || null,
282
+ short_description: flowPropertyReferenceText(reference) || null,
283
+ },
284
+ canonical: {
285
+ ref_object_id: next["@refObjectId"],
286
+ version: next["@version"],
287
+ short_description: next["common:shortDescription"]["#text"],
288
+ },
289
+ canonical_reference_unit_group: unitGroupProof,
290
+ mapping_reason: mapping.reason ?? null,
291
+ legacy_support_note: mapping.legacy_support_note ?? null,
292
+ });
293
+ if (blockOnUnscaled && scaleInvalid) {
294
+ stats.amount_scaling_unresolved = Number(stats.amount_scaling_unresolved ?? 0) + 1;
295
+ const unresolvedRequirement = {
296
+ dataset_type: datasetType,
297
+ dataset_id: datasetIdentityCache?.id ?? null,
298
+ dataset_version: datasetIdentityCache?.version ?? null,
299
+ row_index: rowIndex,
300
+ source_file: repoRelativeMaybe(sourceFile),
301
+ path: pathExpression(childPath),
302
+ source_unit: unit,
303
+ canonical_reference_unit: mapping.canonical_reference_unit ?? null,
304
+ amount_scale_to_canonical_reference: null,
305
+ configured_amount_scale_to_canonical_reference: scaleResolved ? amountScale : null,
306
+ scale_resolution_status: "unresolved_scale",
307
+ note: "The canonical mapping does not provide a finite positive amount scale for this source unit. The reference may be rewritten for evidence, but the scope must remain blocked because no physically valid conversion factor is proven.",
308
+ };
309
+ scalingRequirements.push(unresolvedRequirement);
310
+ blockers.push({
311
+ code: "canonical_support_amount_scale_unresolved",
312
+ message: "Canonical Flow Property mapping is missing a finite positive amount scale for the source unit; block before write because the rewritten reference cannot prove physical quantity equivalence.",
313
+ ...unresolvedRequirement,
314
+ required_resolution: "Add a finite positive source_unit_scales value backed by the canonical Unit Group conversion, refresh the support cache, and rerun with --block-on-unscaled-canonical-support.",
315
+ });
316
+ }
317
+ else if (needsScaling) {
318
+ stats.amount_scaling_required_rewrites =
319
+ Number(stats.amount_scaling_required_rewrites ?? 0) + 1;
320
+ const requirement = {
321
+ dataset_type: datasetType,
322
+ dataset_id: datasetIdentityCache?.id ?? null,
323
+ dataset_version: datasetIdentityCache?.version ?? null,
324
+ row_index: rowIndex,
325
+ source_file: repoRelativeMaybe(sourceFile),
326
+ path: pathExpression(childPath),
327
+ source_unit: unit,
328
+ canonical_reference_unit: mapping.canonical_reference_unit ?? null,
329
+ amount_scale_to_canonical_reference: amountScale,
330
+ note: "Exchange amounts referencing this flow must be multiplied by amount_scale_to_canonical_reference to stay physically correct against the canonical reference unit; canonical-support rewrite does not convert amounts.",
331
+ };
332
+ scalingRequirements.push(requirement);
333
+ if (blockOnUnscaled) {
334
+ stats.amount_scaling_blocked = Number(stats.amount_scaling_blocked ?? 0) + 1;
335
+ blockers.push({
336
+ code: "canonical_support_amount_scaling_required",
337
+ message: "Source unit differs in scale from the canonical reference unit; exchange amounts must be explicitly scaled before remote write. Rewriting the flow property reference without scaling amounts causes an order-of-magnitude error.",
338
+ ...requirement,
339
+ required_resolution: "Apply amount_scale_to_canonical_reference to affected exchange amounts (explicit scaling decision per profile policy), then re-run; or choose a canonical Flow Property whose reference unit matches the source unit (scale 1).",
340
+ });
341
+ }
342
+ }
343
+ }
344
+ else if (!alreadyCanonical &&
345
+ mapping?.pending_canonical_support &&
346
+ !allowAccountLocalSupportAndElementary) {
347
+ blockers.push({
348
+ code: "canonical_support_pending_upstream",
349
+ message: "Source unit maps to a canonical Flow Property that does not yet exist in the public library; import must stay blocked until upstream creates and publishes it.",
350
+ dataset_type: datasetType,
351
+ dataset_id: datasetIdentityCache?.id ?? null,
352
+ dataset_version: datasetIdentityCache?.version ?? null,
353
+ row_index: rowIndex,
354
+ source_file: repoRelativeMaybe(sourceFile),
355
+ path: pathExpression(childPath),
356
+ source_unit: unit || null,
357
+ canonical_reference_unit: mapping.canonical_reference_unit ?? null,
358
+ amount_scale_to_canonical_reference: resolveAmountScale(mapping, unit, normalizedUnit),
359
+ mapping_reason: mapping.reason ?? null,
360
+ pending_upstream_note: mapping.pending_upstream_note ?? null,
361
+ required_resolution: "Create the public canonical Flow Property + Unit Group (state_code=100) upstream, refresh the support cache, set canonical_flow_property_id on this mapping, then re-run.",
362
+ });
363
+ }
364
+ else if (!alreadyCanonical && !allowAccountLocalSupportAndElementary) {
365
+ blockers.push({
366
+ code: "canonical_flow_property_reference_unresolved",
367
+ message: "Flow property references must point to an existing canonical database row; Foundry must not write account-local flowproperty/unitgroup support rows.",
368
+ dataset_type: datasetType,
369
+ dataset_id: datasetIdentityCache?.id ?? null,
370
+ dataset_version: datasetIdentityCache?.version ?? null,
371
+ row_index: rowIndex,
372
+ source_file: repoRelativeMaybe(sourceFile),
373
+ path: pathExpression(childPath),
374
+ source_unit: unit || null,
375
+ original_ref_object_id: originalId || null,
376
+ original_version: originalVersion || null,
377
+ required_resolution: "Add or select a public canonical flow property mapping in the support cache, or block the import until the platform has the required canonical support row.",
378
+ });
379
+ }
380
+ continue;
381
+ }
382
+ rewriteCanonicalFlowPropertyReferences(child, {
383
+ cacheContext,
384
+ datasetType,
385
+ sourceFile,
386
+ stats,
387
+ rewriteRows,
388
+ blockers,
389
+ scalingRequirements,
390
+ blockOnUnscaled,
391
+ datasetIdentityCache,
392
+ rowIndex,
393
+ language,
394
+ pathSegments: childPath,
395
+ allowAccountLocalSupportAndElementary,
396
+ });
397
+ }
398
+ }
399
+ function applyCanonicalSupportRewrites({ datasetType, rowsFile, outFile = null, outDir = null, options = {}, }) {
400
+ const resolvedOutDir = outDir || path.join(path.dirname(rowsFile), "canonical-support-rewrites");
401
+ const resolvedOutFile = outFile ||
402
+ path.join(resolvedOutDir, `${datasetRowsFileStem(datasetType)}.canonical-support-rewritten.jsonl`);
403
+ fs.mkdirSync(resolvedOutDir, { recursive: true });
404
+ const cacheContext = loadCanonicalSupportCache(options);
405
+ const rows = readRowsFile(rowsFile);
406
+ const stats = {
407
+ canonical_flow_property_reference_rewrites: 0,
408
+ canonical_unit_group_reference_proofs: 0,
409
+ amount_scaling_required_rewrites: 0,
410
+ amount_scaling_blocked: 0,
411
+ amount_scaling_unresolved: 0,
412
+ };
413
+ const rewriteRows = [];
414
+ const blockers = [];
415
+ const scalingRequirements = [];
416
+ const blockOnUnscaled = booleanOption(options.blockOnUnscaledCanonicalSupport || options.blockUnscaledCanonicalSupport);
417
+ const allowAccountLocalSupportAndElementary = booleanOption(options.prepareAccountLocalSupportCandidates);
418
+ const outputRows = rows.map((row, rowIndex) => {
419
+ const next = cloneJson(row);
420
+ rewriteCanonicalFlowPropertyReferences(next, {
421
+ cacheContext,
422
+ datasetType,
423
+ sourceFile: rowsFile,
424
+ stats,
425
+ rewriteRows,
426
+ blockers,
427
+ scalingRequirements,
428
+ blockOnUnscaled,
429
+ datasetIdentityCache: datasetIdentity(next, datasetType),
430
+ rowIndex,
431
+ language: asText(options.language || options.lang || "en") || "en",
432
+ allowAccountLocalSupportAndElementary,
433
+ });
434
+ return next;
435
+ });
436
+ const deferBlockedRows = datasetType === "flow" &&
437
+ blockers.length > 0 &&
438
+ booleanOption(options.deferBlockedCanonicalSupportRows ||
439
+ options.deferCanonicalSupportBlockedRows ||
440
+ options.deferBlockedSupportRows);
441
+ const blockedRowIndexes = new Set(blockers
442
+ .map((blocker) => Number(blocker.row_index))
443
+ .filter((rowIndex) => Number.isInteger(rowIndex) && rowIndex >= 0));
444
+ const writeOutputRows = deferBlockedRows
445
+ ? outputRows.filter((_, rowIndex) => !blockedRowIndexes.has(rowIndex))
446
+ : outputRows;
447
+ const deferredRows = deferBlockedRows
448
+ ? outputRows.filter((_, rowIndex) => blockedRowIndexes.has(rowIndex))
449
+ : [];
450
+ const rewritesFile = path.join(resolvedOutDir, "canonical-support-rewrites.jsonl");
451
+ const blockersFile = path.join(resolvedOutDir, "canonical-support-blockers.jsonl");
452
+ const scalingFile = path.join(resolvedOutDir, "canonical-support-amount-scaling.jsonl");
453
+ const reportFile = path.join(resolvedOutDir, "canonical-support-rewrite-report.json");
454
+ const deferredRowsFile = path.join(resolvedOutDir, `${datasetRowsFileStem(datasetType)}.canonical-support-deferred.jsonl`);
455
+ writeJsonLines(resolvedOutFile, writeOutputRows);
456
+ writeJsonLines(deferredRowsFile, deferredRows);
457
+ writeJsonLines(rewritesFile, rewriteRows);
458
+ writeJsonLines(blockersFile, blockers);
459
+ writeJsonLines(scalingFile, scalingRequirements);
460
+ const hardBlockers = deferBlockedRows ? [] : blockers;
461
+ const report = {
462
+ schema_version: 1,
463
+ generated_at_utc: nowIso(),
464
+ command: "dataset-canonical-support-rewrites-apply",
465
+ stage: "canonical_support_rewrites",
466
+ status: deferBlockedRows
467
+ ? "completed_with_deferred_rows"
468
+ : blockers.length > 0
469
+ ? "blocked"
470
+ : rewriteRows.length > 0
471
+ ? "completed"
472
+ : "completed_no_rewrites",
473
+ dataset_type: datasetType,
474
+ remote_write_mode: "read-only",
475
+ rows_file: repoRelativePath(rowsFile),
476
+ output_rows_file: repoRelativePath(resolvedOutFile),
477
+ policy: allowAccountLocalSupportAndElementary
478
+ ? {
479
+ public_canonical_first: "Flow Properties and Unit Groups must reuse defensible public canonical rows when available.",
480
+ account_local_support_rows: "Prepare local FP/UG candidates for a canonical gap, targeting same-owner state_code=0 only. This preparation option grants no write permission; current task authorization must admit each action before a guarded owner-draft CLI plan, audit and readback.",
481
+ rewrite_command_boundary: "This rewrite command does not mint or publish support rows and must not place account-local candidates in the public canonical cache or generic support writer.",
482
+ }
483
+ : {
484
+ reference_only_support: "Flow Properties and Unit Groups are reference-only support data for Foundry imports. Finalize must rewrite converted package-local flow property references to existing canonical database rows, or block before dry-run/remote write planning.",
485
+ no_account_local_support_rows: "Foundry must not create account-local My Data rows for flowproperties or unitgroups.",
486
+ },
487
+ counts: {
488
+ input_rows: rows.length,
489
+ output_rows: writeOutputRows.length,
490
+ deferred_rows: deferredRows.length,
491
+ canonical_flow_property_reference_rewrites: stats.canonical_flow_property_reference_rewrites,
492
+ canonical_unit_group_reference_proofs: stats.canonical_unit_group_reference_proofs,
493
+ amount_scaling_required_rewrites: stats.amount_scaling_required_rewrites,
494
+ amount_scaling_blocked: stats.amount_scaling_blocked,
495
+ ...(stats.amount_scaling_unresolved > 0
496
+ ? { amount_scaling_unresolved: stats.amount_scaling_unresolved }
497
+ : {}),
498
+ blockers: hardBlockers.length,
499
+ deferred_blockers: deferBlockedRows ? blockers.length : 0,
500
+ },
501
+ amount_scaling_policy: {
502
+ rewrite_does_not_convert_amounts: "Canonical support rewrite only repoints referenceToFlowPropertyDataSet; it never converts exchange amounts. When source_unit scale to the canonical reference unit is not 1, downstream exchange amounts must be scaled explicitly (profile policy: explicit scaling in canonical support mapping, not silent).",
503
+ block_flag: "Pass --block-on-unscaled-canonical-support to convert scale!=1 rewrites into hard blockers.",
504
+ },
505
+ amount_scaling_requirements: scalingRequirements,
506
+ files: {
507
+ report: repoRelativePath(reportFile),
508
+ output_rows: repoRelativePath(resolvedOutFile),
509
+ deferred_rows: deferredRows.length > 0 ? repoRelativePath(deferredRowsFile) : null,
510
+ canonical_support_rewrites: repoRelativePath(rewritesFile),
511
+ canonical_support_blockers: repoRelativePath(blockersFile),
512
+ canonical_support_amount_scaling: scalingRequirements.length > 0 ? repoRelativePath(scalingFile) : null,
513
+ canonical_support_cache: repoRelativeMaybe(cacheContext.cachePath),
514
+ },
515
+ blockers: hardBlockers,
516
+ deferred_blockers: deferBlockedRows ? blockers : [],
517
+ };
518
+ writeJson(reportFile, report);
519
+ return report;
520
+ }
521
+ return {
522
+ applyCanonicalSupportRewrites,
523
+ loadCanonicalSupportCache,
524
+ rewriteCanonicalFlowPropertyReferences,
525
+ supportText,
526
+ };
527
+ }