@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,754 @@
1
+ import fs from "node:fs";
2
+ import path from "node:path";
3
+ import process from "node:process";
4
+ function recordArray(value) {
5
+ return Array.isArray(value)
6
+ ? value.filter((item) => Boolean(item) && typeof item === "object" && !Array.isArray(item))
7
+ : [];
8
+ }
9
+ export function createClassificationDecisionCommands({ includeExecutionCommands = true, asText, buildClassificationDecisionTaskContextFiles, buildClassificationTaskProvenanceContext, buildDecisionTaskContextBundle, classificationDecisionCode, classificationDecisionSchemaType, classificationDecisionTargetKey, classificationDecisionUsedContextKinds, classificationQueueInputRows, classificationQueueOutputRows, classificationQueueRowType, classificationQueueSchemaType, classificationQueueTargetKey, compactStageReport, datasetIdentity, decisionAuthoringContext, decisionCompletionStatus, decisionContextBundleSha256, decisionTaskBuildStatus, decisionTaskChunkLabel, decisionTaskContextBlockers, decisionTaskContextBundleHashes, decisionTaskContextFileSummary, decisionTaskInputRowsOverride, decisionTaskProofList, decisionTaskReportPayload, fileExists, hasQueueSelectionOptions, hasUnresolvedAiPlaceholder, nowIso, readDecisionTaskProofs, readJsonOrJsonLines, repoRelativeMaybe, repoRelativePath, repoRoot, resolveRepoPath, rewriteDecisionTaskQueueRowsForChunk, runTiangongJsonStage, selectDecisionTaskQueueRows, shellQuote, unique, writeJson, writeJsonLines, }) {
10
+ function classificationTaskQueueKey(row) {
11
+ return [
12
+ asText(row?.dataset_id),
13
+ asText(row?.dataset_version),
14
+ asText(row?.dataset_type),
15
+ classificationQueueSchemaType(row),
16
+ ].join("::");
17
+ }
18
+ function classificationTaskRowTypeForQueueRow(row) {
19
+ const schemaType = classificationQueueSchemaType(row);
20
+ if (schemaType === "flow-product" || schemaType === "flow-elementary") {
21
+ return "flow";
22
+ }
23
+ return classificationQueueRowType(row) || asText(row?.dataset_type);
24
+ }
25
+ function classificationTaskInputRowIdentity(row, queueRow, index) {
26
+ const rowType = classificationTaskRowTypeForQueueRow(queueRow);
27
+ const identity = datasetIdentity(row, rowType);
28
+ return {
29
+ index,
30
+ row_type: rowType,
31
+ dataset_id: identity.id,
32
+ dataset_version: identity.version,
33
+ };
34
+ }
35
+ function buildClassificationTaskInputRowLookup(queueRows) {
36
+ const byInput = new Map();
37
+ for (const queueRow of queueRows) {
38
+ const inputRows = classificationQueueInputRows(queueRow);
39
+ if (!inputRows)
40
+ continue;
41
+ const resolved = resolveRepoPath(inputRows);
42
+ if (!resolved || !fileExists(resolved))
43
+ continue;
44
+ if (!byInput.has(resolved)) {
45
+ byInput.set(resolved, readJsonOrJsonLines(resolved));
46
+ }
47
+ }
48
+ const lookup = new Map();
49
+ for (const [inputFile, rows] of byInput.entries()) {
50
+ for (const queueRow of queueRows) {
51
+ if (resolveRepoPath(classificationQueueInputRows(queueRow)) !== inputFile) {
52
+ continue;
53
+ }
54
+ for (const [index, row] of rows.entries()) {
55
+ const identity = classificationTaskInputRowIdentity(row, queueRow, index);
56
+ if (identity.dataset_id === asText(queueRow.dataset_id) &&
57
+ identity.dataset_version === asText(queueRow.dataset_version)) {
58
+ lookup.set(classificationTaskQueueKey(queueRow), {
59
+ ...identity,
60
+ input_rows: repoRelativePath(inputFile),
61
+ payload: row,
62
+ });
63
+ break;
64
+ }
65
+ }
66
+ }
67
+ }
68
+ return lookup;
69
+ }
70
+ function classificationTaskEvidenceForQueueRow(row, index, rowLookup) {
71
+ const inputRow = rowLookup.get(classificationTaskQueueKey(row)) ?? null;
72
+ return {
73
+ source: "classification-authoring-queue",
74
+ queue_row_index: index,
75
+ current_classification: row.current_classification ?? null,
76
+ source_classification: row.source_classification ?? null,
77
+ authoring_context: row.authoring_context ?? null,
78
+ source_file: row.source_file ?? null,
79
+ input_rows: classificationQueueInputRows(row) || null,
80
+ output_rows: classificationQueueOutputRows(row) || null,
81
+ input_row_index: inputRow?.index ?? null,
82
+ input_row_identity: inputRow
83
+ ? {
84
+ dataset_id: inputRow.dataset_id,
85
+ dataset_version: inputRow.dataset_version,
86
+ row_type: inputRow.row_type,
87
+ }
88
+ : null,
89
+ input_row_payload: inputRow?.payload ?? null,
90
+ };
91
+ }
92
+ function buildClassificationDecisionTemplateRows(queueRows, rowLookup = new Map(), contextBundle = null) {
93
+ const authoringContext = contextBundle ? decisionAuthoringContext(contextBundle) : null;
94
+ return queueRows.map((row, index) => ({
95
+ dataset_id: row.dataset_id,
96
+ dataset_version: row.dataset_version,
97
+ category_type: classificationQueueSchemaType(row),
98
+ decision_status: "completed",
99
+ code: "__AI_SELECT_TIDAS_CLASSIFICATION_CODE__",
100
+ basis: "__AI_FILL_CLASSIFICATION_DECISION_BASIS__",
101
+ used_context_kinds: ["__AI_FILL_USED_CONTEXT_KINDS__"],
102
+ ...(authoringContext ? { authoring_context: authoringContext } : {}),
103
+ evidence: classificationTaskEvidenceForQueueRow(row, index, rowLookup),
104
+ }));
105
+ }
106
+ function runDatasetClassificationDecisionTaskBuild(options) {
107
+ if (options.help) {
108
+ return {
109
+ schema_version: 1,
110
+ status: "help",
111
+ command: "dataset-classification-decision-task-build",
112
+ usage: [
113
+ "node scripts/foundry.ts dataset-classification-decision-task-build --classification-queue <classification-authoring-queue.jsonl> --rows-file <current-rows.jsonl> --schema-file <schema.json> --yaml-file <methodology.yaml> --ruleset-file <runtime-ruleset.json> --classification-schema <tidas_*_category.json> --location-schema <tidas_locations_category.json> --out-dir <task-dir> [--shared-context-cache-dir <cache-dir>]",
114
+ ],
115
+ purpose: "Build an AI-facing classification decision task from Foundry classification queue rows. AI fills TIDAS category codes; deterministic apply is handled by dataset-classification-decisions-apply.",
116
+ };
117
+ }
118
+ const queuePath = resolveRepoPath(options.classificationQueue || options.queue || options.input);
119
+ if (!queuePath || !fileExists(queuePath)) {
120
+ throw new Error("--classification-queue is required and must point to classification-authoring-queue.jsonl.");
121
+ }
122
+ const outDir = resolveRepoPath(options.outDir || ".foundry/workspaces/classification-decision-task");
123
+ const sharedContextCacheDir = resolveRepoPath(options.sharedContextCacheDir || options.contextCacheDir);
124
+ fs.mkdirSync(outDir, { recursive: true });
125
+ const sourceQueueRows = readJsonOrJsonLines(queuePath);
126
+ const useSelection = hasQueueSelectionOptions(options);
127
+ const inputRowsOverride = decisionTaskInputRowsOverride(options);
128
+ const shouldDeriveQueue = useSelection || Boolean(inputRowsOverride);
129
+ let queueRows = sourceQueueRows;
130
+ let taskQueuePath = queuePath;
131
+ let selection = {
132
+ source_queue_rows: sourceQueueRows.length,
133
+ matched_queue_rows: sourceQueueRows.length,
134
+ selected_queue_rows: sourceQueueRows.length,
135
+ source_queue_row_indices: sourceQueueRows.map((_, index) => index),
136
+ };
137
+ if (shouldDeriveQueue) {
138
+ const selected = useSelection
139
+ ? selectDecisionTaskQueueRows(sourceQueueRows, options, classificationQueueSchemaType)
140
+ : {
141
+ selection,
142
+ selected: sourceQueueRows.map((row, sourceIndex) => ({
143
+ row,
144
+ sourceIndex,
145
+ })),
146
+ };
147
+ selection = {
148
+ ...selected.selection,
149
+ input_rows_override: inputRowsOverride ? repoRelativePath(inputRowsOverride) : null,
150
+ };
151
+ const chunkLabel = decisionTaskChunkLabel(options, selection, inputRowsOverride ? "classification-current-rows" : "classification-chunk");
152
+ queueRows = rewriteDecisionTaskQueueRowsForChunk({
153
+ selected: selected.selected,
154
+ sourceQueuePath: queuePath,
155
+ outDir,
156
+ chunkLabel,
157
+ workflowKey: "classification_workflow",
158
+ outputSuffix: "classified",
159
+ inputRowsForRow: classificationQueueInputRows,
160
+ inputRowsOverride,
161
+ });
162
+ selection.chunk_label = chunkLabel;
163
+ taskQueuePath = path.join(outDir, `classification-authoring-queue.${chunkLabel}.jsonl`);
164
+ writeJsonLines(taskQueuePath, queueRows);
165
+ }
166
+ const rowLookup = buildClassificationTaskInputRowLookup(queueRows);
167
+ const templatePath = path.join(outDir, "classification-decisions.template.jsonl");
168
+ const taskPath = path.join(outDir, "classification-decision-task.json");
169
+ const reportPath = path.join(outDir, "classification-decision-task-report.json");
170
+ const decisionFile = path.join(outDir, "classification-decisions.jsonl");
171
+ const contractContext = buildClassificationDecisionTaskContextFiles(options);
172
+ const provenanceContext = buildClassificationTaskProvenanceContext(queuePath);
173
+ const attachedInputRows = [...rowLookup.values()];
174
+ const contextBundle = buildDecisionTaskContextBundle({
175
+ taskKind: "classification_decision_authoring",
176
+ taskPath,
177
+ outDir,
178
+ sharedContextCacheDir,
179
+ queuePath: taskQueuePath,
180
+ queueRows,
181
+ contractContext,
182
+ provenanceContext,
183
+ attachedInputRows,
184
+ });
185
+ const templateRows = buildClassificationDecisionTemplateRows(queueRows, rowLookup, contextBundle);
186
+ const queueRowsWithAttachedInput = templateRows.filter((row) => row.evidence?.input_row_payload).length;
187
+ const blockers = decisionTaskContextBlockers({
188
+ kind: "classification",
189
+ queueRows,
190
+ contractContext,
191
+ requiredContextKinds: [
192
+ "schema",
193
+ "methodology_yaml",
194
+ "ruleset",
195
+ "classification_schema",
196
+ "location_schema",
197
+ ],
198
+ attachedInputRowCount: queueRowsWithAttachedInput,
199
+ });
200
+ const contextFiles = contractContext.files.map((file) => file.path);
201
+ const schemaTypes = unique(queueRows.map(classificationQueueSchemaType));
202
+ const rowTypes = unique(queueRows.map(classificationQueueRowType));
203
+ const task = {
204
+ schema_version: 1,
205
+ generated_at_utc: nowIso(),
206
+ status: decisionTaskBuildStatus({
207
+ queueRows,
208
+ blockers,
209
+ readyStatus: "ready_for_ai_classification_decisions",
210
+ emptyStatus: "ready_no_classification_actions",
211
+ }),
212
+ task_kind: "classification_decision_authoring",
213
+ classification_queue: repoRelativePath(taskQueuePath),
214
+ counts: {
215
+ queue_rows: queueRows.length,
216
+ template_decisions: templateRows.length,
217
+ schema_types: schemaTypes.length,
218
+ row_types: rowTypes.length,
219
+ contract_context_files: contractContext.files.length,
220
+ missing_context_files: contractContext.missing.length,
221
+ attached_input_rows: queueRowsWithAttachedInput,
222
+ unique_attached_input_rows: attachedInputRows.length,
223
+ missing_input_row_payloads: queueRows.length - queueRowsWithAttachedInput,
224
+ provenance_context_files: [
225
+ provenanceContext.source_semantics.file,
226
+ provenanceContext.process_source_references.file,
227
+ provenanceContext.source_reference_rewrites.file,
228
+ ].filter(Boolean).length,
229
+ blockers: blockers.length,
230
+ },
231
+ blockers,
232
+ schema_types: schemaTypes,
233
+ row_types: rowTypes,
234
+ selection,
235
+ source_classification_queue: shouldDeriveQueue ? repoRelativePath(queuePath) : null,
236
+ classification_queue_rows: queueRows,
237
+ attached_input_rows: attachedInputRows,
238
+ provenance_context: provenanceContext,
239
+ context_bundle: contextBundle,
240
+ shared_context_bundle: contextBundle.shared_context_bundle,
241
+ context_files: contextFiles,
242
+ contract_context_files: contractContext.files.map(decisionTaskContextFileSummary),
243
+ missing_context_files: contractContext.missing,
244
+ instructions: [
245
+ "Read shared_context_bundle once for full Foundry/SDK schema, methodology YAML, runtime ruleset, classification/location schema text, then use this task's queue rows, attached payloads, provenance, and source trace before choosing codes.",
246
+ "Replace each template code with a valid TIDAS leaf code for category_type; keep source classification as evidence, not target classification.",
247
+ "Every decision must include dataset_id, dataset_version, category_type, code, basis, used_context_kinds, and structured evidence.",
248
+ "Do not write row JSON directly; run dataset-classification-decisions-apply after decisions are complete.",
249
+ ],
250
+ files: {
251
+ task: repoRelativePath(taskPath),
252
+ template: repoRelativePath(templatePath),
253
+ expected_decisions: repoRelativePath(decisionFile),
254
+ report: repoRelativePath(reportPath),
255
+ shared_context_bundle: contextBundle.shared_context_bundle.path,
256
+ },
257
+ commands: {
258
+ apply_decisions: includeExecutionCommands
259
+ ? [
260
+ process.execPath,
261
+ path.join(repoRoot, "scripts", "foundry.ts"),
262
+ "dataset-classification-decisions-apply",
263
+ "--classification-queue",
264
+ taskQueuePath,
265
+ "--decisions",
266
+ decisionFile,
267
+ "--decision-task",
268
+ taskPath,
269
+ "--out-dir",
270
+ path.join(outDir, "apply"),
271
+ ]
272
+ .map(shellQuote)
273
+ .join(" ")
274
+ : null,
275
+ },
276
+ };
277
+ writeJsonLines(templatePath, templateRows);
278
+ writeJson(taskPath, task);
279
+ writeJson(reportPath, task);
280
+ return task;
281
+ }
282
+ function validateClassificationDecisionsForQueue(queueRows, decisions, { decisionTaskProof = null, decisionKind = "classification", } = {}) {
283
+ const blockers = [];
284
+ const decisionTaskProofs = decisionTaskProofList(decisionTaskProof);
285
+ for (const proof of decisionTaskProofs) {
286
+ blockers.push(...proof.blockers);
287
+ }
288
+ const contextBundleHashes = decisionTaskContextBundleHashes(decisionTaskProofs);
289
+ const queueByKey = new Map(queueRows.map((row) => [classificationQueueTargetKey(row), row]));
290
+ const decisionsByKey = new Map();
291
+ for (const [index, decision] of decisions.entries()) {
292
+ const schemaType = classificationDecisionSchemaType(decision);
293
+ const key = classificationDecisionTargetKey(decision);
294
+ if (hasUnresolvedAiPlaceholder(decision)) {
295
+ blockers.push({
296
+ code: "classification_decision_template_incomplete",
297
+ message: "Classification decision still contains an AI placeholder.",
298
+ decision_index: index,
299
+ });
300
+ continue;
301
+ }
302
+ if (decisionCompletionStatus(decision) !== "completed") {
303
+ blockers.push({
304
+ code: `${decisionKind}_decision_status_not_completed`,
305
+ message: "Classification decision must declare decision_status=completed before deterministic apply.",
306
+ decision_index: index,
307
+ decision_status: decisionCompletionStatus(decision) || null,
308
+ });
309
+ }
310
+ if (!schemaType) {
311
+ blockers.push({
312
+ code: "classification_decision_schema_type_missing",
313
+ message: "Classification decision must include category_type.",
314
+ decision_index: index,
315
+ });
316
+ continue;
317
+ }
318
+ if (!classificationDecisionCode(decision)) {
319
+ blockers.push({
320
+ code: "classification_decision_code_missing",
321
+ message: "Classification decision must include a TIDAS category code.",
322
+ decision_index: index,
323
+ });
324
+ }
325
+ if (!asText(decision.basis)) {
326
+ blockers.push({
327
+ code: "classification_decision_basis_missing",
328
+ message: "Classification decision must include basis.",
329
+ decision_index: index,
330
+ });
331
+ }
332
+ if (!decision.evidence || typeof decision.evidence !== "object") {
333
+ blockers.push({
334
+ code: "classification_decision_evidence_missing",
335
+ message: "Classification decision must include structured evidence.",
336
+ decision_index: index,
337
+ });
338
+ }
339
+ if (classificationDecisionUsedContextKinds(decision).length === 0) {
340
+ blockers.push({
341
+ code: "classification_decision_used_context_missing",
342
+ message: "Classification decision must include used_context_kinds so full-context AI evidence is auditable.",
343
+ decision_index: index,
344
+ });
345
+ }
346
+ if (contextBundleHashes.length > 0) {
347
+ const decisionBundleHash = decisionContextBundleSha256(decision);
348
+ if (!decisionBundleHash) {
349
+ blockers.push({
350
+ code: `${decisionKind}_decision_context_bundle_missing`,
351
+ message: "Decision must include authoring_context.context_bundle_sha256 from the AI decision task template.",
352
+ decision_index: index,
353
+ decision_tasks: decisionTaskProofs.map((proof) => proof.path),
354
+ });
355
+ }
356
+ else if (!contextBundleHashes.includes(decisionBundleHash)) {
357
+ blockers.push({
358
+ code: `${decisionKind}_decision_context_bundle_mismatch`,
359
+ message: "Decision authoring context hash does not match the AI decision task context bundle.",
360
+ decision_index: index,
361
+ expected_context_bundle_sha256: contextBundleHashes.length === 1 ? contextBundleHashes[0] : null,
362
+ expected_context_bundle_sha256_any_of: contextBundleHashes,
363
+ actual_context_bundle_sha256: decisionBundleHash,
364
+ decision_tasks: decisionTaskProofs.map((proof) => proof.path),
365
+ });
366
+ }
367
+ }
368
+ if (!queueByKey.has(key)) {
369
+ blockers.push({
370
+ code: "classification_decision_not_in_queue",
371
+ message: "Classification decision does not match a queued dataset_id/version/category_type.",
372
+ decision_index: index,
373
+ decision_key: key,
374
+ });
375
+ continue;
376
+ }
377
+ if (decisionsByKey.has(key)) {
378
+ blockers.push({
379
+ code: "classification_decision_duplicate",
380
+ message: "More than one decision targets the same queue row.",
381
+ decision_index: index,
382
+ decision_key: key,
383
+ });
384
+ continue;
385
+ }
386
+ decisionsByKey.set(key, { ...decision, category_type: schemaType });
387
+ }
388
+ for (const row of queueRows) {
389
+ const key = classificationQueueTargetKey(row);
390
+ if (!decisionsByKey.has(key)) {
391
+ blockers.push({
392
+ code: "classification_queue_item_unclosed",
393
+ message: "Every classification queue row must be closed by one decision.",
394
+ dataset_type: row.dataset_type,
395
+ dataset_id: row.dataset_id,
396
+ dataset_version: row.dataset_version,
397
+ schema_type: classificationQueueSchemaType(row),
398
+ });
399
+ }
400
+ }
401
+ return { blockers, decisionsByKey };
402
+ }
403
+ function libraryClassificationDecisionCode(row) {
404
+ return asText(row?.selected_code ?? row?.selectedCode ?? classificationDecisionCode(row));
405
+ }
406
+ function libraryClassificationDecisionKey(row) {
407
+ const schemaType = classificationDecisionSchemaType(row);
408
+ const datasetId = asText(row?.dataset_id ?? row?.datasetId ?? row?.id ?? row?.uuid);
409
+ const version = asText(row?.dataset_version ?? row?.datasetVersion ?? row?.version);
410
+ return `${schemaType}::${datasetId}::${version}`;
411
+ }
412
+ function classificationDecisionIsTooBroad(queueRow, decision, code) {
413
+ const schemaType = classificationQueueSchemaType(queueRow);
414
+ if (!["process", "flow-product"].includes(schemaType))
415
+ return false;
416
+ const level = asText(decision?.classification_decision_level ?? decision?.classificationDecisionLevel);
417
+ if (level === "broad_section")
418
+ return true;
419
+ if (schemaType === "process")
420
+ return /^[A-Z]$/u.test(code) || /^\d{1,3}$/u.test(code);
421
+ return /^\d{1,3}$/u.test(code);
422
+ }
423
+ function decisionTaskAuthoringContext(task, taskPath) {
424
+ const contextBundle = task?.context_bundle ?? task?.contextBundle;
425
+ const contractFiles = recordArray(contextBundle?.contract_context_files);
426
+ return {
427
+ task: contextBundle?.task ?? repoRelativePath(taskPath),
428
+ context_bundle_sha256: asText(contextBundle?.sha256),
429
+ required_context_kinds: unique(contractFiles.map((file) => asText(file?.kind)).filter(Boolean)),
430
+ context_files: contractFiles.map((file) => ({
431
+ kind: asText(file?.kind) || "context",
432
+ path: asText(file?.path) || null,
433
+ sha256: asText(file?.sha256) || null,
434
+ })),
435
+ };
436
+ }
437
+ function runDatasetLibraryClassificationDecisionsProject(options) {
438
+ if (options.help) {
439
+ return {
440
+ schema_version: 1,
441
+ status: "help",
442
+ command: "dataset-library-classification-decisions-project",
443
+ usage: [
444
+ "node scripts/foundry.ts dataset-library-classification-decisions-project --classification-queue <classification-authoring-queue.jsonl> --library-decisions <run-dir>/decisions/classification-decisions.jsonl --decision-task <classification-decision-task.json> --out-dir <projection-dir>",
445
+ ],
446
+ purpose: "Project library-level semantic classification decisions into a scope-local decision file bound to an exact classification decision task before deterministic apply.",
447
+ };
448
+ }
449
+ const queuePath = resolveRepoPath(options.classificationQueue || options.queue);
450
+ const decisionsDir = resolveRepoPath(options.decisionsDir || options.libraryDecisionsDir);
451
+ const libraryDecisionsPath = resolveRepoPath(options.libraryDecisions ||
452
+ options.libraryDecisionFile ||
453
+ options.decisions ||
454
+ (decisionsDir ? path.join(decisionsDir, "classification-decisions.jsonl") : null));
455
+ const decisionTaskPath = resolveRepoPath(options.decisionTask || options.classificationDecisionTask || options.task);
456
+ if (!queuePath || !fileExists(queuePath)) {
457
+ throw new Error("--classification-queue is required and must point to classification-authoring-queue.jsonl.");
458
+ }
459
+ if (!libraryDecisionsPath || !fileExists(libraryDecisionsPath)) {
460
+ throw new Error("--library-decisions or --decisions-dir is required and must point to classification-decisions.jsonl.");
461
+ }
462
+ if (!decisionTaskPath || !fileExists(decisionTaskPath)) {
463
+ throw new Error("--decision-task is required so projected decisions can bind to the exact full-context task bundle.");
464
+ }
465
+ const outDir = resolveRepoPath(options.outDir || ".foundry/workspaces/library-classification-decisions-project");
466
+ const queueRows = readJsonOrJsonLines(queuePath);
467
+ const libraryRows = readJsonOrJsonLines(libraryDecisionsPath);
468
+ const decisionTask = readJsonOrJsonLines(decisionTaskPath);
469
+ const taskPayload = Array.isArray(decisionTask) ? decisionTask[0] : decisionTask;
470
+ const authoringContext = decisionTaskAuthoringContext(taskPayload, decisionTaskPath);
471
+ const requiredContextKinds = unique([
472
+ ...authoringContext.required_context_kinds,
473
+ "schema",
474
+ "methodology_yaml",
475
+ "ruleset",
476
+ "classification_schema",
477
+ "location_schema",
478
+ ]);
479
+ const libraryByKey = new Map(libraryRows.map((row) => [libraryClassificationDecisionKey(row), row]));
480
+ const projected = [];
481
+ const manualReview = [];
482
+ for (const [index, queueRow] of queueRows.entries()) {
483
+ const key = classificationQueueTargetKey(queueRow);
484
+ const decision = libraryByKey.get(key);
485
+ const code = libraryClassificationDecisionCode(decision);
486
+ if (!decision ||
487
+ decisionCompletionStatus(decision) !== "completed" ||
488
+ !code ||
489
+ hasUnresolvedAiPlaceholder(decision)) {
490
+ manualReview.push({
491
+ schema_version: 1,
492
+ status: "manual_review",
493
+ reason: decision
494
+ ? "library_classification_decision_incomplete"
495
+ : "library_classification_decision_missing",
496
+ queue_row_index: index,
497
+ decision_key: key,
498
+ dataset_type: queueRow.dataset_type ?? null,
499
+ dataset_id: queueRow.dataset_id ?? null,
500
+ dataset_version: queueRow.dataset_version ?? null,
501
+ category_type: classificationQueueSchemaType(queueRow) || null,
502
+ required_human_action: "Provide a completed library-level classification decision, then rerun this projection and deterministic classification apply.",
503
+ });
504
+ continue;
505
+ }
506
+ if (classificationDecisionIsTooBroad(queueRow, decision, code)) {
507
+ manualReview.push({
508
+ schema_version: 1,
509
+ status: "manual_review",
510
+ reason: "library_classification_decision_not_leaf",
511
+ queue_row_index: index,
512
+ decision_key: key,
513
+ dataset_type: queueRow.dataset_type ?? null,
514
+ dataset_id: queueRow.dataset_id ?? null,
515
+ dataset_version: queueRow.dataset_version ?? null,
516
+ category_type: classificationQueueSchemaType(queueRow) || null,
517
+ selected_code: code,
518
+ required_human_action: "Replace the broad classification with a full TIDAS leaf code selected through dataset classification children/path, then rerun this projection and deterministic classification apply.",
519
+ });
520
+ continue;
521
+ }
522
+ const usedContextKinds = unique([
523
+ ...requiredContextKinds,
524
+ ...classificationDecisionUsedContextKinds(decision),
525
+ ]);
526
+ projected.push({
527
+ schema_version: 1,
528
+ dataset_id: queueRow.dataset_id,
529
+ dataset_version: queueRow.dataset_version,
530
+ category_type: classificationQueueSchemaType(queueRow),
531
+ decision_status: "completed",
532
+ code,
533
+ basis: asText(decision.basis) ||
534
+ "Projected from completed library-level classification decision.",
535
+ authoring_context: authoringContext,
536
+ used_context_kinds: usedContextKinds,
537
+ evidence: {
538
+ source: "library-classification-decisions-project",
539
+ projection: "library_decision_to_scope_classification_queue",
540
+ used_context_kinds: usedContextKinds,
541
+ queue: {
542
+ row_index: index,
543
+ dataset_type: queueRow.dataset_type ?? null,
544
+ dataset_id: queueRow.dataset_id ?? null,
545
+ dataset_version: queueRow.dataset_version ?? null,
546
+ category_type: classificationQueueSchemaType(queueRow) || null,
547
+ current_classification: queueRow.current_classification ?? null,
548
+ source_classification: queueRow.source_classification ?? null,
549
+ authoring_context: queueRow.authoring_context ?? null,
550
+ source_file: queueRow.source_file ?? null,
551
+ foundry_selection: queueRow.foundry_selection ?? null,
552
+ },
553
+ library_decision: {
554
+ decision_key: key,
555
+ selected_code: code,
556
+ basis: decision.basis ?? null,
557
+ confidence: decision.confidence ?? null,
558
+ source_name: decision.source_name ?? null,
559
+ converted_classification_reference: decision.converted_classification_reference ?? null,
560
+ converted_classification_reference_policy: decision.converted_classification_reference_policy ?? null,
561
+ classification_decision_level: decision.classification_decision_level ?? null,
562
+ rule_hits: decision.rule_hits ?? null,
563
+ },
564
+ },
565
+ });
566
+ }
567
+ const decisionsPath = path.join(outDir, "classification-decisions.jsonl");
568
+ const manualReviewPath = path.join(outDir, "classification-decisions.manual-review.jsonl");
569
+ const reportPath = path.join(outDir, "dataset-library-classification-decisions-project-report.json");
570
+ writeJsonLines(decisionsPath, projected);
571
+ writeJsonLines(manualReviewPath, manualReview);
572
+ const report = {
573
+ schema_version: 1,
574
+ generated_at_utc: nowIso(),
575
+ status: manualReview.length > 0 ? "blocked" : "completed",
576
+ command: "dataset-library-classification-decisions-project",
577
+ classification_queue: repoRelativePath(queuePath),
578
+ library_decisions: repoRelativePath(libraryDecisionsPath),
579
+ decision_task: repoRelativePath(decisionTaskPath),
580
+ counts: {
581
+ queue_rows: queueRows.length,
582
+ library_decisions: libraryRows.length,
583
+ projected_decisions: projected.length,
584
+ manual_review: manualReview.length,
585
+ blockers: manualReview.length,
586
+ },
587
+ policy: {
588
+ classification_ai_decision_boundary: "The library decision contains the semantic choice. This projection only binds it to a scope-local full-context decision task before deterministic CLI classification apply.",
589
+ tidas_tools_classification_policy: "weak_hint_only",
590
+ },
591
+ blockers: manualReview.map((row) => ({
592
+ code: row.reason,
593
+ message: row.required_human_action,
594
+ dataset_id: row.dataset_id,
595
+ dataset_version: row.dataset_version,
596
+ category_type: row.category_type,
597
+ })),
598
+ files: {
599
+ report: repoRelativePath(reportPath),
600
+ decisions: repoRelativePath(decisionsPath),
601
+ manual_review: repoRelativePath(manualReviewPath),
602
+ },
603
+ };
604
+ writeJson(reportPath, report);
605
+ return report;
606
+ }
607
+ function outputRowsForClassificationGroup(rows, outDir, inputRows, options) {
608
+ if (options.out && rows.length > 0)
609
+ return resolveRepoPath(options.out);
610
+ const outputRows = unique(rows.map(classificationQueueOutputRows)).filter(Boolean);
611
+ if (outputRows.length === 1)
612
+ return resolveRepoPath(outputRows[0]);
613
+ const inputBase = path.basename(inputRows).replace(/\.(jsonl|json)$/iu, "");
614
+ return path.join(outDir, "rows", `${inputBase}.classified.jsonl`);
615
+ }
616
+ function runDatasetClassificationDecisionsApply(options) {
617
+ if (options.help) {
618
+ return {
619
+ schema_version: 1,
620
+ status: "help",
621
+ command: "dataset-classification-decisions-apply",
622
+ wraps: "tiangong-lca dataset classification apply",
623
+ usage: [
624
+ "node scripts/foundry.ts dataset-classification-decisions-apply --classification-queue <classification-authoring-queue.jsonl> --decisions <classification-decisions.jsonl> --decision-task <classification-decision-task.json> --out-dir <apply-dir>",
625
+ ],
626
+ purpose: "Validate AI-authored classification decisions against the Foundry queue and AI context task, then call the CLI classification apply command for each required schema type and row file.",
627
+ };
628
+ }
629
+ const queuePath = resolveRepoPath(options.classificationQueue || options.queue);
630
+ const decisionsPath = resolveRepoPath(options.decisions || options.decisionFile || options.input);
631
+ if (!queuePath || !fileExists(queuePath)) {
632
+ throw new Error("--classification-queue is required and must point to classification-authoring-queue.jsonl.");
633
+ }
634
+ if (!decisionsPath || !fileExists(decisionsPath)) {
635
+ throw new Error("--decisions is required and must point to JSON/JSONL decisions.");
636
+ }
637
+ const outDir = resolveRepoPath(options.outDir || ".foundry/workspaces/classification-decisions-apply");
638
+ const reportPath = path.join(outDir, "classification-decisions-apply-report.json");
639
+ const queueRows = readJsonOrJsonLines(queuePath);
640
+ const decisions = readJsonOrJsonLines(decisionsPath);
641
+ const decisionTaskProofs = readDecisionTaskProofs(options, "classification", queuePath);
642
+ const decisionTaskProof = decisionTaskProofs.length === 1 ? decisionTaskProofs[0] : null;
643
+ const { blockers, decisionsByKey } = validateClassificationDecisionsForQueue(queueRows, decisions, { decisionTaskProof: decisionTaskProofs, decisionKind: "classification" });
644
+ const stages = [];
645
+ const inputRowsFiles = [];
646
+ const outputRows = [];
647
+ if (blockers.length === 0 && queueRows.length > 0) {
648
+ const queueRowsByInput = new Map();
649
+ for (const row of queueRows) {
650
+ const inputRows = resolveRepoPath(options.rowsFile || options.inputRows || classificationQueueInputRows(row));
651
+ if (!inputRows || !fileExists(inputRows)) {
652
+ blockers.push({
653
+ code: "classification_input_rows_missing",
654
+ message: "Queued classification workflow input rows file is missing.",
655
+ dataset_id: row.dataset_id,
656
+ schema_type: classificationQueueSchemaType(row),
657
+ input_rows: classificationQueueInputRows(row),
658
+ });
659
+ continue;
660
+ }
661
+ const key = repoRelativePath(inputRows);
662
+ const group = queueRowsByInput.get(key) ?? {
663
+ inputRows,
664
+ rows: [],
665
+ };
666
+ group.rows.push(row);
667
+ queueRowsByInput.set(key, group);
668
+ }
669
+ for (const group of queueRowsByInput.values()) {
670
+ const finalOutputRows = outputRowsForClassificationGroup(group.rows, outDir, group.inputRows, options);
671
+ inputRowsFiles.push(repoRelativePath(group.inputRows));
672
+ const schemaTypes = unique(group.rows.map(classificationQueueSchemaType));
673
+ let currentInput = group.inputRows;
674
+ for (const [index, schemaType] of schemaTypes.entries()) {
675
+ const groupRowsForSchema = group.rows.filter((row) => classificationQueueSchemaType(row) === schemaType);
676
+ const groupDecisions = groupRowsForSchema.map((row) => decisionsByKey.get(classificationQueueTargetKey(row)));
677
+ const decisionFile = path.join(outDir, "decisions", `${schemaType}-classification-decisions.jsonl`);
678
+ const isLast = index === schemaTypes.length - 1;
679
+ const stageOutputRows = isLast
680
+ ? finalOutputRows
681
+ : path.join(outDir, "intermediate", `${path.basename(group.inputRows).replace(/\.(jsonl|json)$/iu, "")}.${schemaType}.jsonl`);
682
+ fs.mkdirSync(path.dirname(decisionFile), { recursive: true });
683
+ fs.mkdirSync(path.dirname(stageOutputRows), { recursive: true });
684
+ writeJsonLines(decisionFile, groupDecisions);
685
+ const stage = runTiangongJsonStage(`classification_apply_${schemaType}`, [
686
+ "dataset",
687
+ "classification",
688
+ "apply",
689
+ "--input",
690
+ currentInput,
691
+ "--decisions",
692
+ decisionFile,
693
+ "--out",
694
+ stageOutputRows,
695
+ "--type",
696
+ schemaType,
697
+ "--out-dir",
698
+ path.join(outDir, "classification", schemaType),
699
+ "--json",
700
+ ]);
701
+ stage.report_file = resolveRepoPath(stage.report?.files?.report);
702
+ stages.push(stage);
703
+ if (stage.exit_code !== 0) {
704
+ const stageSummary = compactStageReport(stage);
705
+ blockers.push({
706
+ code: "classification_apply_stage_failed",
707
+ message: `CLI classification apply failed for ${schemaType}.`,
708
+ schema_type: schemaType,
709
+ exit_code: stage.exit_code,
710
+ report_file: repoRelativeMaybe(stage.report_file),
711
+ stage: stageSummary,
712
+ stderr: stageSummary.stderr || "",
713
+ });
714
+ break;
715
+ }
716
+ currentInput = stageOutputRows;
717
+ }
718
+ outputRows.push(repoRelativePath(finalOutputRows));
719
+ }
720
+ }
721
+ const report = {
722
+ schema_version: 1,
723
+ generated_at_utc: nowIso(),
724
+ status: blockers.length > 0 ? "blocked" : "completed",
725
+ command: "dataset-classification-decisions-apply",
726
+ classification_queue: repoRelativePath(queuePath),
727
+ decisions_file: repoRelativePath(decisionsPath),
728
+ decision_task: decisionTaskReportPayload(decisionTaskProof),
729
+ decision_tasks: decisionTaskProofs.map(decisionTaskReportPayload),
730
+ counts: {
731
+ queue_rows: queueRows.length,
732
+ decisions: decisions.length,
733
+ stages: stages.length,
734
+ applied: stages.reduce((total, stage) => total + Number(stage.report?.counts?.applied ?? 0), 0),
735
+ blockers: blockers.length,
736
+ },
737
+ blockers,
738
+ stages: stages.map(compactStageReport),
739
+ files: {
740
+ report: repoRelativePath(reportPath),
741
+ input_rows: unique(inputRowsFiles),
742
+ output_rows: outputRows,
743
+ },
744
+ };
745
+ fs.mkdirSync(outDir, { recursive: true });
746
+ writeJson(reportPath, report);
747
+ return report;
748
+ }
749
+ return {
750
+ runDatasetClassificationDecisionTaskBuild,
751
+ runDatasetClassificationDecisionsApply,
752
+ runDatasetLibraryClassificationDecisionsProject,
753
+ };
754
+ }