@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,130 @@
1
+ type JsonRecord = Record<string, unknown>;
2
+ type ContractContextFile = JsonRecord & {
3
+ kind?: unknown;
4
+ text?: unknown;
5
+ };
6
+ type IdentityEvidence = JsonRecord & {
7
+ remote_search?: unknown;
8
+ target?: unknown;
9
+ top_candidates?: unknown;
10
+ };
11
+ type IdentityActionItem = JsonRecord & {
12
+ code?: unknown;
13
+ dependency_type?: unknown;
14
+ dependency_id?: unknown;
15
+ dependency_version?: unknown;
16
+ target_dataset_type?: unknown;
17
+ target_dataset_id?: unknown;
18
+ target_dataset_version?: unknown;
19
+ dataset_type?: unknown;
20
+ dataset_id?: unknown;
21
+ dataset_version?: unknown;
22
+ relation?: unknown;
23
+ evidence?: IdentityEvidence;
24
+ };
25
+ type AuthoringPackage = JsonRecord & {
26
+ dataset_type?: unknown;
27
+ entity_id?: unknown;
28
+ version?: unknown;
29
+ action_items?: unknown;
30
+ contract_context_files?: unknown;
31
+ missing_context_files?: unknown;
32
+ full_context_ai_completion?: unknown;
33
+ fullContextAiCompletion?: unknown;
34
+ };
35
+ type PackageProof = {
36
+ entity: JsonRecord;
37
+ package_ref: string | null;
38
+ package_path: string | null;
39
+ package_sha256: string | null;
40
+ expected_sha256: string | null;
41
+ package: AuthoringPackage | null;
42
+ blockers: JsonRecord[];
43
+ live_package_ref?: string | null;
44
+ live_package_path?: string | null;
45
+ };
46
+ type AuthoringEntity = {
47
+ dataset_type: string;
48
+ entity_id: string;
49
+ version: string;
50
+ };
51
+ type IdentityTaskRow = JsonRecord & {
52
+ dataset_type: string;
53
+ dataset_id: string;
54
+ dataset_version: string;
55
+ relation: string;
56
+ action_item_code: string;
57
+ action_item_index: number;
58
+ authoring_package: string | null;
59
+ authoring_package_sha256: string | null;
60
+ authoring_entity: AuthoringEntity;
61
+ action_item: IdentityActionItem;
62
+ package: AuthoringPackage;
63
+ package_proof: PackageProof;
64
+ source_task_rows?: IdentityTaskRow[];
65
+ source_action_items?: JsonRecord[];
66
+ action_item_codes?: string[];
67
+ related_authoring_packages?: JsonRecord[];
68
+ source_action_item_count?: number;
69
+ };
70
+ type SharedContextBundle = JsonRecord & {
71
+ path: string;
72
+ sha256: string;
73
+ };
74
+ export type IdentityDecisionTaskOptions = Record<string, unknown> & {
75
+ help?: unknown;
76
+ curationGateReport?: unknown;
77
+ report?: unknown;
78
+ input?: unknown;
79
+ outDir?: unknown;
80
+ sharedContextCacheDir?: unknown;
81
+ contextCacheDir?: unknown;
82
+ rowsFile?: unknown;
83
+ };
84
+ export type IdentityDecisionTaskFactoryDependencies = {
85
+ includeExecutionCommands?: boolean;
86
+ asText: (value: unknown) => string;
87
+ datasetRowsFileStem: (datasetType: string) => string;
88
+ decisionAuthoringContext: (contextBundle: JsonRecord) => JsonRecord;
89
+ decisionTaskBuildStatus: (input: {
90
+ queueRows: IdentityTaskRow[];
91
+ blockers: JsonRecord[];
92
+ readyStatus: string;
93
+ emptyStatus: string;
94
+ }) => string;
95
+ decisionTaskContextFileSummary: (file: unknown) => JsonRecord;
96
+ dedupeDecisionTaskContextFiles: (files: ContractContextFile[]) => ContractContextFile[];
97
+ ensureArray: <T>(value: T | T[] | null | undefined) => T[];
98
+ fileExists: (filePath: string) => boolean;
99
+ hasQueueSelectionOptions: (options: IdentityDecisionTaskOptions) => boolean;
100
+ normalizedList: (value: unknown) => string[];
101
+ nowIso: () => string;
102
+ readJson: (filePath: string) => JsonRecord;
103
+ readText: (filePath: string) => string;
104
+ repoRelativePath: (filePath: string) => string;
105
+ repoRoot: string;
106
+ resolveRepoPath: (value: unknown) => string | null;
107
+ selectDecisionTaskQueueRows: (rows: IdentityTaskRow[], options: IdentityDecisionTaskOptions, codeForRow: (row: IdentityTaskRow) => string) => {
108
+ selected: Array<{
109
+ row: IdentityTaskRow;
110
+ index?: number;
111
+ }>;
112
+ selection: JsonRecord;
113
+ };
114
+ sha256Text: (text: string) => string;
115
+ shellQuote: (value: unknown) => string;
116
+ unique: <T>(values: T[]) => T[];
117
+ writeDecisionTaskSharedContextBundle: (input: {
118
+ outDir: string;
119
+ taskKind: string;
120
+ files: ContractContextFile[];
121
+ references: JsonRecord[];
122
+ cacheDir: string | null;
123
+ }) => SharedContextBundle;
124
+ writeJson: (filePath: string, value: unknown) => unknown;
125
+ writeJsonLines: (filePath: string, rows: unknown[]) => unknown;
126
+ };
127
+ export declare function createIdentityDecisionTaskCommands({ includeExecutionCommands, asText, datasetRowsFileStem, decisionAuthoringContext, decisionTaskBuildStatus, decisionTaskContextFileSummary, dedupeDecisionTaskContextFiles, ensureArray, fileExists, hasQueueSelectionOptions, normalizedList, nowIso, readJson, readText, repoRelativePath, repoRoot, resolveRepoPath, selectDecisionTaskQueueRows, sha256Text, shellQuote, unique, writeDecisionTaskSharedContextBundle, writeJson, writeJsonLines, }: IdentityDecisionTaskFactoryDependencies): {
128
+ runDatasetIdentityDecisionTaskBuild: (options: IdentityDecisionTaskOptions) => JsonRecord;
129
+ };
130
+ export {};
@@ -0,0 +1,494 @@
1
+ import fs from "node:fs";
2
+ import path from "node:path";
3
+ import process from "node:process";
4
+ export function createIdentityDecisionTaskCommands({ includeExecutionCommands = true, asText, datasetRowsFileStem, decisionAuthoringContext, decisionTaskBuildStatus, decisionTaskContextFileSummary, dedupeDecisionTaskContextFiles, ensureArray, fileExists, hasQueueSelectionOptions, normalizedList, nowIso, readJson, readText, repoRelativePath, repoRoot, resolveRepoPath, selectDecisionTaskQueueRows, sha256Text, shellQuote, unique, writeDecisionTaskSharedContextBundle, writeJson, writeJsonLines, }) {
5
+ const identityDecisionActionCodes = new Set([
6
+ "identity_preflight_manual_review",
7
+ "elementary_flow_identity_manual_review",
8
+ ]);
9
+ function curationGateEntities(report) {
10
+ return ensureArray((report.entities ?? report.processes ?? report.flows ?? report.items));
11
+ }
12
+ function readAuthoringPackageForIdentityTask(entity) {
13
+ const packageRef = asText(entity?.authoring_package ?? entity?.authoringPackage);
14
+ const packagePath = resolveRepoPath(packageRef);
15
+ const proof = {
16
+ entity,
17
+ package_ref: packageRef || null,
18
+ package_path: packagePath,
19
+ package_sha256: null,
20
+ expected_sha256: asText(entity?.authoring_package_sha256) || null,
21
+ package: null,
22
+ blockers: [],
23
+ };
24
+ if (!packageRef || !packagePath || !fileExists(packagePath)) {
25
+ proof.blockers.push({
26
+ code: "identity_decision_authoring_package_missing",
27
+ message: "Identity decision task requires a readable full-context authoring package.",
28
+ authoring_package: packageRef || null,
29
+ });
30
+ return proof;
31
+ }
32
+ const text = readText(packagePath);
33
+ proof.package_sha256 = sha256Text(text);
34
+ try {
35
+ proof.package = JSON.parse(text);
36
+ }
37
+ catch (error) {
38
+ proof.blockers.push({
39
+ code: "identity_decision_authoring_package_invalid",
40
+ message: error instanceof Error ? error.message : String(error),
41
+ authoring_package: packageRef,
42
+ });
43
+ return proof;
44
+ }
45
+ if (proof.expected_sha256 && proof.expected_sha256 !== proof.package_sha256) {
46
+ proof.blockers.push({
47
+ code: "identity_decision_authoring_package_hash_mismatch",
48
+ message: "Authoring package sha256 in the curation gate report no longer matches the package content.",
49
+ authoring_package: packageRef,
50
+ expected_sha256: proof.expected_sha256,
51
+ actual_sha256: proof.package_sha256,
52
+ });
53
+ }
54
+ return proof;
55
+ }
56
+ function snapshotAuthoringPackageProof(proof, snapshotDir) {
57
+ if (!proof?.package || proof.blockers.length > 0)
58
+ return proof;
59
+ fs.mkdirSync(snapshotDir, { recursive: true });
60
+ const parsed = path.parse(path.basename((proof.package_path || proof.package_ref)));
61
+ const snapshotPath = path.join(snapshotDir, `${parsed.name}.${proof.package_sha256}.snapshot${parsed.ext || ".json"}`);
62
+ if (!fileExists(snapshotPath)) {
63
+ fs.copyFileSync(proof.package_path, snapshotPath);
64
+ }
65
+ return {
66
+ ...proof,
67
+ live_package_ref: proof.package_ref,
68
+ live_package_path: proof.package_path,
69
+ package_ref: repoRelativePath(snapshotPath),
70
+ package_path: snapshotPath,
71
+ expected_sha256: proof.package_sha256,
72
+ };
73
+ }
74
+ function contractContextKindsForPackage(packagePayload) {
75
+ return new Set(ensureArray(packagePayload.contract_context_files)
76
+ .filter((file) => asText(file.kind) && asText(file.text))
77
+ .map((file) => asText(file.kind)));
78
+ }
79
+ function requiredIdentityContextKinds(packagePayload) {
80
+ const fullContext = (packagePayload.full_context_ai_completion ??
81
+ packagePayload.fullContextAiCompletion);
82
+ const required = normalizedList(fullContext?.required_context_kinds ?? fullContext?.requiredContextKinds);
83
+ return required.length > 0 ? required : ["schema", "methodology_yaml", "ruleset"];
84
+ }
85
+ function identityTaskPackageContextBlockers(proof) {
86
+ const blockers = [...proof.blockers];
87
+ const packagePayload = proof.package;
88
+ if (!packagePayload)
89
+ return blockers;
90
+ const availableKinds = contractContextKindsForPackage(packagePayload);
91
+ for (const missing of ensureArray(packagePayload.missing_context_files)) {
92
+ blockers.push({
93
+ code: "identity_decision_authoring_package_missing_context_file",
94
+ message: "Authoring package records missing context files and cannot be sent as a full-context identity decision task.",
95
+ authoring_package: proof.package_ref,
96
+ missing_context_file: missing,
97
+ });
98
+ }
99
+ for (const kind of requiredIdentityContextKinds(packagePayload)) {
100
+ if (!availableKinds.has(kind)) {
101
+ blockers.push({
102
+ code: "identity_decision_required_context_missing",
103
+ message: "Identity decision task must include the full schema/YAML/ruleset/category context from the authoring package before AI authoring.",
104
+ kind,
105
+ authoring_package: proof.package_ref,
106
+ });
107
+ }
108
+ }
109
+ return blockers;
110
+ }
111
+ function identityActionItemsFromPackage(proof) {
112
+ const packagePayload = proof.package ?? {};
113
+ return ensureArray(packagePayload.action_items)
114
+ .map((item, actionIndex) => ({ item, actionIndex }))
115
+ .filter(({ item }) => identityDecisionActionCodes.has(asText(item?.code)));
116
+ }
117
+ function identityDecisionTargetForAction(packagePayload, actionItem) {
118
+ const dependencyType = asText(actionItem?.dependency_type);
119
+ const dependencyId = asText(actionItem?.dependency_id);
120
+ const dependencyVersion = asText(actionItem?.dependency_version);
121
+ return {
122
+ dataset_type: dependencyType ||
123
+ asText(actionItem?.target_dataset_type) ||
124
+ asText(actionItem?.dataset_type) ||
125
+ asText(packagePayload?.dataset_type),
126
+ dataset_id: dependencyId ||
127
+ asText(actionItem?.target_dataset_id) ||
128
+ asText(actionItem?.dataset_id) ||
129
+ asText(packagePayload?.entity_id),
130
+ dataset_version: dependencyVersion ||
131
+ asText(actionItem?.target_dataset_version) ||
132
+ asText(actionItem?.dataset_version) ||
133
+ asText(packagePayload?.version) ||
134
+ "00.00.001",
135
+ };
136
+ }
137
+ function identityDecisionTaskRowsFromPackages(packageProofs) {
138
+ const rows = [];
139
+ for (const proof of packageProofs) {
140
+ const packagePayload = proof.package;
141
+ if (!packagePayload)
142
+ continue;
143
+ for (const { item, actionIndex } of identityActionItemsFromPackage(proof)) {
144
+ const target = identityDecisionTargetForAction(packagePayload, item);
145
+ rows.push({
146
+ dataset_type: target.dataset_type,
147
+ dataset_id: target.dataset_id,
148
+ dataset_version: target.dataset_version,
149
+ relation: asText(item?.relation) || "current",
150
+ action_item_code: asText(item?.code),
151
+ action_item_index: actionIndex,
152
+ authoring_package: proof.package_ref,
153
+ authoring_package_sha256: proof.package_sha256,
154
+ authoring_entity: {
155
+ dataset_type: asText(packagePayload.dataset_type),
156
+ entity_id: asText(packagePayload.entity_id),
157
+ version: asText(packagePayload.version),
158
+ },
159
+ action_item: item,
160
+ package: packagePayload,
161
+ package_proof: proof,
162
+ });
163
+ }
164
+ }
165
+ return rows;
166
+ }
167
+ function identityDecisionTaskRowKey(row) {
168
+ return JSON.stringify([
169
+ asText(row?.dataset_type).toLowerCase(),
170
+ asText(row?.dataset_id),
171
+ asText(row?.dataset_version) || "00.00.001",
172
+ ]);
173
+ }
174
+ function identityDecisionTaskSourceItem(row) {
175
+ return {
176
+ dataset_type: row.dataset_type,
177
+ dataset_id: row.dataset_id,
178
+ dataset_version: row.dataset_version || "00.00.001",
179
+ relation: row.relation,
180
+ action_item_code: row.action_item_code,
181
+ action_item_index: row.action_item_index,
182
+ authoring_package: row.authoring_package,
183
+ authoring_package_sha256: row.authoring_package_sha256,
184
+ authoring_entity: row.authoring_entity,
185
+ evidence: row.action_item?.evidence ?? null,
186
+ };
187
+ }
188
+ function identityDecisionTaskPackageRefs(rows) {
189
+ const byKey = new Map();
190
+ for (const row of ensureArray(rows)) {
191
+ const key = JSON.stringify([row.authoring_package, row.authoring_package_sha256]);
192
+ if (!byKey.has(key)) {
193
+ byKey.set(key, {
194
+ authoring_package: row.authoring_package,
195
+ authoring_package_sha256: row.authoring_package_sha256,
196
+ authoring_entity: row.authoring_entity,
197
+ });
198
+ }
199
+ }
200
+ return [...byKey.values()];
201
+ }
202
+ function identityDecisionTaskRawRows(row) {
203
+ return ensureArray(row.source_task_rows).length > 0 ? row.source_task_rows : ensureArray(row);
204
+ }
205
+ function identityDecisionTaskActionCodes(row) {
206
+ const rawRows = identityDecisionTaskRawRows(row);
207
+ return unique([
208
+ ...ensureArray(row?.action_item_codes),
209
+ row?.action_item_code,
210
+ ...rawRows.map((rawRow) => rawRow.action_item_code),
211
+ ].map(asText));
212
+ }
213
+ function primaryIdentityDecisionActionCode(codes) {
214
+ return codes.includes("elementary_flow_identity_manual_review")
215
+ ? "elementary_flow_identity_manual_review"
216
+ : codes[0] || "identity_preflight_manual_review";
217
+ }
218
+ function mergeIdentityDecisionTaskRows(rows) {
219
+ const byKey = new Map();
220
+ for (const row of rows) {
221
+ const key = identityDecisionTaskRowKey(row);
222
+ if (!byKey.has(key)) {
223
+ byKey.set(key, {
224
+ ...row,
225
+ dataset_version: row.dataset_version || "00.00.001",
226
+ source_task_rows: [],
227
+ source_action_items: [],
228
+ action_item_codes: [],
229
+ related_authoring_packages: [],
230
+ });
231
+ }
232
+ const merged = byKey.get(key);
233
+ const previousPrimaryCode = merged.action_item_code;
234
+ merged.source_task_rows.push(row);
235
+ merged.source_action_items.push(identityDecisionTaskSourceItem(row));
236
+ merged.action_item_codes = unique([...merged.action_item_codes, row.action_item_code]);
237
+ merged.related_authoring_packages = identityDecisionTaskPackageRefs(merged.source_task_rows);
238
+ merged.source_action_item_count = merged.source_action_items.length;
239
+ merged.action_item_code = primaryIdentityDecisionActionCode(merged.action_item_codes);
240
+ if (previousPrimaryCode !== merged.action_item_code &&
241
+ row.action_item_code === merged.action_item_code &&
242
+ merged.action_item !== row.action_item) {
243
+ merged.action_item = row.action_item;
244
+ merged.action_item_index = row.action_item_index;
245
+ merged.authoring_package = row.authoring_package;
246
+ merged.authoring_package_sha256 = row.authoring_package_sha256;
247
+ merged.authoring_entity = row.authoring_entity;
248
+ merged.package = row.package;
249
+ merged.package_proof = row.package_proof;
250
+ }
251
+ }
252
+ return [...byKey.values()];
253
+ }
254
+ function buildIdentityDecisionTemplateRows(taskRows, contextBundle = null) {
255
+ const authoringContext = contextBundle ? decisionAuthoringContext(contextBundle) : null;
256
+ return taskRows.map((row, index) => {
257
+ const actionCodes = identityDecisionTaskActionCodes(row);
258
+ const isElementaryDecision = actionCodes.includes("elementary_flow_identity_manual_review");
259
+ return {
260
+ dataset_type: row.dataset_type,
261
+ dataset_id: row.dataset_id,
262
+ dataset_version: row.dataset_version || "00.00.001",
263
+ decision_status: "completed",
264
+ identity_decision: isElementaryDecision
265
+ ? "__AI_SELECT_REUSE_EXISTING_REFERENCE_OR_BLOCK_UNRESOLVED__"
266
+ : "__AI_SELECT_REUSE_EXISTING_REFERENCE_CREATE_NEW_OR_BLOCK_UNRESOLVED__",
267
+ canonical: {
268
+ table: datasetRowsFileStem(row.dataset_type),
269
+ ref_object_id: "__AI_FILL_CANONICAL_REF_OBJECT_ID_IF_REUSE__",
270
+ version: "__AI_FILL_CANONICAL_VERSION_IF_REUSE__",
271
+ short_description: "__AI_FILL_CANONICAL_SHORT_DESCRIPTION_IF_REUSE__",
272
+ },
273
+ basis: "__AI_FILL_IDENTITY_DECISION_BASIS__",
274
+ used_context_kinds: ["__AI_FILL_USED_CONTEXT_KINDS__"],
275
+ closes_action_items: actionCodes,
276
+ authoring_package: row.authoring_package,
277
+ authoring_package_sha256: row.authoring_package_sha256,
278
+ ...(authoringContext ? { authoring_context: authoringContext } : {}),
279
+ evidence: {
280
+ source: "foundry_identity_decision_task",
281
+ task_row_index: index,
282
+ relation: row.relation,
283
+ action_item_code: row.action_item_code,
284
+ action_item_codes: actionCodes,
285
+ source_action_item_count: Number(row.source_action_item_count) || identityDecisionTaskRawRows(row).length,
286
+ source_action_items: ensureArray(row.source_action_items),
287
+ related_authoring_packages: ensureArray(row.related_authoring_packages),
288
+ identity_preflight: row.action_item?.evidence ?? null,
289
+ remote_search: row.action_item?.evidence?.remote_search ?? null,
290
+ target: row.action_item?.evidence?.target ?? null,
291
+ top_candidates: row.action_item?.evidence?.top_candidates ?? [],
292
+ authoring_entity: row.authoring_entity,
293
+ },
294
+ };
295
+ });
296
+ }
297
+ function runDatasetIdentityDecisionTaskBuild(options) {
298
+ if (options.help) {
299
+ return {
300
+ schema_version: 1,
301
+ status: "help",
302
+ command: "dataset-identity-decision-task-build",
303
+ usage: [
304
+ "node scripts/foundry.ts dataset-identity-decision-task-build --curation-gate-report <dataset-curation-gate-report.json> --out-dir <task-dir> [--shared-context-cache-dir <cache-dir>]",
305
+ ],
306
+ purpose: "Build an AI-facing identity decision task from Foundry curation gate authoring packages. AI decides reuse_existing_reference/create_new/block_unresolved; deterministic apply is handled by dataset-identity-decisions-apply.",
307
+ };
308
+ }
309
+ const curationGateReportPath = resolveRepoPath(options.curationGateReport || options.report || options.input);
310
+ if (!curationGateReportPath || !fileExists(curationGateReportPath)) {
311
+ throw new Error("--curation-gate-report is required and must point to dataset-curation-gate-report.json.");
312
+ }
313
+ const outDir = resolveRepoPath(options.outDir || ".foundry/workspaces/identity-decision-task");
314
+ const sharedContextCacheDir = resolveRepoPath(options.sharedContextCacheDir || options.contextCacheDir);
315
+ fs.mkdirSync(outDir, { recursive: true });
316
+ const snapshotDir = path.join(outDir, "authoring-package-snapshots");
317
+ const curationGateReport = readJson(curationGateReportPath);
318
+ const entities = curationGateEntities(curationGateReport);
319
+ const packageProofs = entities
320
+ .map(readAuthoringPackageForIdentityTask)
321
+ .filter((proof) => {
322
+ if (!proof.package)
323
+ return proof.blockers.length > 0;
324
+ return identityActionItemsFromPackage(proof).length > 0;
325
+ })
326
+ .map((proof) => snapshotAuthoringPackageProof(proof, snapshotDir));
327
+ const sourceTaskRows = identityDecisionTaskRowsFromPackages(packageProofs);
328
+ const uniqueTaskRows = mergeIdentityDecisionTaskRows(sourceTaskRows);
329
+ const selected = selectDecisionTaskQueueRows(sourceTaskRows, options, (row) => row.action_item_code);
330
+ const selectedSourceRows = hasQueueSelectionOptions(options)
331
+ ? selected.selected.map(({ row }) => row)
332
+ : sourceTaskRows;
333
+ const selectedRows = mergeIdentityDecisionTaskRows(selectedSourceRows);
334
+ const selectedRawRows = selectedRows.flatMap(identityDecisionTaskRawRows);
335
+ const selection = hasQueueSelectionOptions(options)
336
+ ? selected.selection
337
+ : {
338
+ source_queue_rows: sourceTaskRows.length,
339
+ matched_queue_rows: sourceTaskRows.length,
340
+ selected_queue_rows: sourceTaskRows.length,
341
+ source_queue_row_indices: sourceTaskRows.map((_, index) => index),
342
+ };
343
+ const taskPath = path.join(outDir, "identity-decision-task.json");
344
+ const templatePath = path.join(outDir, "identity-decisions.template.jsonl");
345
+ const decisionFile = path.join(outDir, "identity-decisions.jsonl");
346
+ const reportPath = path.join(outDir, "identity-decision-task-report.json");
347
+ const contractContext = {
348
+ files: selectedRawRows.flatMap((row) => ensureArray(row.package.contract_context_files)),
349
+ missing: selectedRawRows.flatMap((row) => ensureArray(row.package?.missing_context_files)),
350
+ };
351
+ const identityContextFiles = dedupeDecisionTaskContextFiles(contractContext.files);
352
+ const identityContextReferences = selectedRows.flatMap((row) => identityDecisionTaskRawRows(row).flatMap((rawRow) => ensureArray(rawRow.package.contract_context_files).map((file) => {
353
+ const summary = decisionTaskContextFileSummary(file);
354
+ return {
355
+ ...summary,
356
+ authoring_package: rawRow.authoring_package,
357
+ authoring_package_sha256: rawRow.authoring_package_sha256,
358
+ action_item_code: rawRow.action_item_code,
359
+ dataset_type: rawRow.dataset_type,
360
+ dataset_id: rawRow.dataset_id,
361
+ dataset_version: rawRow.dataset_version,
362
+ };
363
+ })));
364
+ const sharedContextBundle = writeDecisionTaskSharedContextBundle({
365
+ outDir,
366
+ taskKind: "identity_decision_authoring",
367
+ files: identityContextFiles,
368
+ references: identityContextReferences,
369
+ cacheDir: sharedContextCacheDir,
370
+ });
371
+ const contextBundleStablePayload = {
372
+ task_kind: "identity_decision_authoring",
373
+ source_curation_gate_report: repoRelativePath(curationGateReportPath),
374
+ task_rows: selectedRows.length,
375
+ source_identity_action_items: selectedSourceRows.length,
376
+ contract_context_files: identityContextFiles.map(decisionTaskContextFileSummary),
377
+ missing_context_files: contractContext.missing,
378
+ authoring_packages: selectedRawRows.map((row) => ({
379
+ authoring_package: row.authoring_package,
380
+ authoring_package_sha256: row.authoring_package_sha256,
381
+ action_item_code: row.action_item_code,
382
+ dataset_type: row.dataset_type,
383
+ dataset_id: row.dataset_id,
384
+ dataset_version: row.dataset_version,
385
+ })),
386
+ shared_context_bundle_sha256: sharedContextBundle.sha256,
387
+ };
388
+ const contextBundle = {
389
+ ...contextBundleStablePayload,
390
+ task: repoRelativePath(taskPath),
391
+ shared_context_bundle: sharedContextBundle,
392
+ hash_scope: "task_kind, source_curation_gate_report, task_rows, source_identity_action_items, contract_context_files, missing_context_files, authoring_packages, and shared_context_bundle_sha256; task path and generated_at_utc are excluded.",
393
+ sha256: sha256Text(JSON.stringify(contextBundleStablePayload)),
394
+ };
395
+ const templateRows = buildIdentityDecisionTemplateRows(selectedRows, contextBundle);
396
+ const blockers = [
397
+ ...packageProofs.flatMap(identityTaskPackageContextBlockers),
398
+ ...selectedRows
399
+ .filter((row) => !row.dataset_type || !row.dataset_id)
400
+ .map((row) => ({
401
+ code: "identity_decision_target_missing",
402
+ message: "Identity action item does not identify the flow/process target to decide.",
403
+ authoring_package: row.authoring_package,
404
+ action_item_code: row.action_item_code,
405
+ })),
406
+ ];
407
+ const datasetTypes = unique(selectedRows.map((row) => row.dataset_type));
408
+ const task = {
409
+ schema_version: 1,
410
+ generated_at_utc: nowIso(),
411
+ status: decisionTaskBuildStatus({
412
+ queueRows: selectedRows,
413
+ blockers,
414
+ readyStatus: "ready_for_ai_identity_decisions",
415
+ emptyStatus: "ready_no_identity_actions",
416
+ }),
417
+ task_kind: "identity_decision_authoring",
418
+ source_curation_gate_report: repoRelativePath(curationGateReportPath),
419
+ counts: {
420
+ curation_entities: entities.length,
421
+ identity_action_items: sourceTaskRows.length,
422
+ unique_identity_targets: uniqueTaskRows.length,
423
+ selected_identity_action_items: selectedSourceRows.length,
424
+ selected_unique_identity_targets: selectedRows.length,
425
+ deduplicated_identity_action_items: selectedSourceRows.length - selectedRows.length,
426
+ template_decisions: templateRows.length,
427
+ authoring_packages: unique(selectedRawRows.map((row) => row.authoring_package)).length,
428
+ dataset_types: datasetTypes.length,
429
+ blockers: blockers.length,
430
+ },
431
+ blockers,
432
+ dataset_types: datasetTypes,
433
+ selection,
434
+ identity_action_items: selectedRows.map((row) => ({
435
+ dataset_type: row.dataset_type,
436
+ dataset_id: row.dataset_id,
437
+ dataset_version: row.dataset_version,
438
+ relation: row.relation,
439
+ action_item_code: row.action_item_code,
440
+ authoring_package: row.authoring_package,
441
+ authoring_package_sha256: row.authoring_package_sha256,
442
+ action_item_codes: identityDecisionTaskActionCodes(row),
443
+ source_action_item_count: Number(row.source_action_item_count) || identityDecisionTaskRawRows(row).length,
444
+ source_action_items: ensureArray(row.source_action_items),
445
+ related_authoring_packages: ensureArray(row.related_authoring_packages),
446
+ evidence: row.action_item?.evidence ?? null,
447
+ })),
448
+ context_bundle: contextBundle,
449
+ shared_context_bundle: sharedContextBundle,
450
+ instructions: [
451
+ "Read shared_context_bundle once for full schema/YAML/ruleset/category/location text, then read each snapshotted full authoring package for source row, identity-preflight candidates, action items, and package-specific evidence.",
452
+ "Use the task-local authoring-package snapshot paths in decisions. Do not replace them with live curation-gate package paths, because finalize can regenerate live packages after decisions are applied.",
453
+ "For product/process identity_preflight_manual_review, choose reuse_existing_reference, create_new, or block_unresolved with evidence.",
454
+ "For elementary_flow_identity_manual_review, do not choose create_new. Choose reuse_existing_reference with canonical id/version, or block_unresolved with searched candidate evidence.",
455
+ "Every decision must include dataset_type, dataset_id, dataset_version, decision_status=completed, identity_decision, basis, used_context_kinds, structured evidence, closes_action_items, authoring_package, and authoring_package_sha256.",
456
+ "Do not write row JSON directly; run dataset-identity-decisions-apply after decisions are complete, then rerun validate/QA/curation/finalize on the applied rows.",
457
+ ],
458
+ files: {
459
+ task: repoRelativePath(taskPath),
460
+ template: repoRelativePath(templatePath),
461
+ expected_decisions: repoRelativePath(decisionFile),
462
+ report: repoRelativePath(reportPath),
463
+ shared_context_bundle: sharedContextBundle.path,
464
+ authoring_package_snapshots_dir: repoRelativePath(snapshotDir),
465
+ },
466
+ commands: {
467
+ apply_decisions: includeExecutionCommands
468
+ ? [
469
+ process.execPath,
470
+ path.join(repoRoot, "scripts", "foundry.ts"),
471
+ "dataset-identity-decisions-apply",
472
+ "--type",
473
+ datasetTypes.length === 1 ? datasetTypes[0] : "<flow-or-process>",
474
+ "--rows-file",
475
+ options.rowsFile || "<rows-file-containing-identity-targets>",
476
+ "--decisions",
477
+ decisionFile,
478
+ "--out-dir",
479
+ path.join(outDir, "apply"),
480
+ "--authoring-package-dir",
481
+ snapshotDir,
482
+ ]
483
+ .map(shellQuote)
484
+ .join(" ")
485
+ : null,
486
+ },
487
+ };
488
+ writeJsonLines(templatePath, templateRows);
489
+ writeJson(taskPath, task);
490
+ writeJson(reportPath, task);
491
+ return task;
492
+ }
493
+ return { runDatasetIdentityDecisionTaskBuild };
494
+ }