project-tiny-context-harness 0.8.16 → 0.11.0

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 (535) hide show
  1. package/README.md +119 -41
  2. package/assets/README.md +184 -55
  3. package/assets/README.zh-CN.md +114 -40
  4. package/assets/agents/AGENTS_CORE.md +2 -2
  5. package/assets/context_templates/context.toml +6 -1
  6. package/assets/context_templates/screen-contract.md +16 -0
  7. package/assets/runtime/windows-job-supervisor/formal_process_supervisor_native_helpers.cs +301 -0
  8. package/assets/runtime/windows-job-supervisor/formal_process_supervisor_native_run.cs +197 -0
  9. package/assets/runtime/windows-job-supervisor/formal_process_supervisor_native_types.cs +215 -0
  10. package/assets/runtime/windows-job-supervisor/windows_job_process_supervisor.ps1 +117 -0
  11. package/assets/skills/context_development_engineer/SKILL.md +16 -30
  12. package/assets/skills/context_development_engineer/references/engineering-design-reasoning.md +93 -0
  13. package/assets/skills/context_surface_contract/SKILL.md +13 -2
  14. package/assets/skills/context_uiux_design/SKILL.md +7 -3
  15. package/assets/skills/context_uiux_design/references/task-uiux-analysis.md +82 -0
  16. package/assets/skills/design-resource-authoring/SKILL.md +18 -9
  17. package/assets/skills/design-resource-authoring/references/authority-delta-assessment.md +52 -0
  18. package/assets/skills/design-resource-authoring/references/downstream-handoff.md +22 -6
  19. package/assets/skills/design-resource-authoring/references/formal-selected-web-app-handoff.md +26 -8
  20. package/assets/skills/design-resource-authoring/references/implementation-feasibility.md +111 -0
  21. package/assets/skills/design-resource-authoring/references/open-design-provider.md +45 -7
  22. package/assets/skills/design-resource-authoring/references/recovery-and-writeback.md +7 -1
  23. package/assets/skills/design-resource-authoring/references/resource-selection.md +115 -3
  24. package/assets/skills/design-system-authoring/SKILL.md +23 -17
  25. package/assets/skills/design-system-authoring/references/authority-adoption.md +19 -9
  26. package/assets/skills/design-system-authoring/references/open-design-design-system-provider.md +4 -0
  27. package/assets/skills/long-task-workflow/SKILL.md +6 -6
  28. package/assets/skills/long-task-workflow/references/authority-lifecycle.md +10 -4
  29. package/assets/skills/long-task-workflow/references/contract-authoring.md +5 -5
  30. package/assets/skills/long-task-workflow/references/evidence-design.md +14 -3
  31. package/assets/skills/long-task-workflow/references/source-authoring.md +11 -8
  32. package/assets/tools/context_rules.json +53 -0
  33. package/assets/tools/validate_context.py +302 -77
  34. package/dist/cli.js +2 -1
  35. package/dist/commands/context-create.d.ts +1 -0
  36. package/dist/commands/context-create.js +90 -0
  37. package/dist/commands/context-inspect.d.ts +1 -0
  38. package/dist/commands/context-inspect.js +98 -0
  39. package/dist/commands/context-move.d.ts +1 -0
  40. package/dist/commands/context-move.js +78 -0
  41. package/dist/commands/context-register.d.ts +1 -0
  42. package/dist/commands/context-register.js +110 -0
  43. package/dist/commands/context-transaction.d.ts +1 -0
  44. package/dist/commands/context-transaction.js +84 -0
  45. package/dist/commands/context.d.ts +1 -0
  46. package/dist/commands/context.js +36 -0
  47. package/dist/commands/design-authority-delta.d.ts +1 -0
  48. package/dist/commands/design-authority-delta.js +53 -0
  49. package/dist/commands/design-authority.d.ts +1 -0
  50. package/dist/commands/design-authority.js +104 -0
  51. package/dist/commands/design-resource.js +17 -3
  52. package/dist/commands/doctor.d.ts +1 -1
  53. package/dist/commands/doctor.js +61 -3
  54. package/dist/commands/index.js +19 -2
  55. package/dist/commands/long-task-authoring.js +20 -2
  56. package/dist/commands/long-task-workdir.d.ts +2 -0
  57. package/dist/commands/long-task-workdir.js +23 -0
  58. package/dist/commands/long-task.js +75 -6
  59. package/dist/commands/route.d.ts +15 -0
  60. package/dist/commands/route.js +142 -0
  61. package/dist/index.d.ts +3 -13
  62. package/dist/index.js +3 -12
  63. package/dist/lib/cli-exit.d.ts +14 -0
  64. package/dist/lib/cli-exit.js +19 -0
  65. package/dist/lib/context-catalog/catalog-default-footprint.d.ts +3 -0
  66. package/dist/lib/context-catalog/catalog-default-footprint.js +53 -0
  67. package/dist/lib/context-catalog/catalog-diagnostics.d.ts +9 -0
  68. package/dist/lib/context-catalog/catalog-diagnostics.js +34 -0
  69. package/dist/lib/context-catalog/catalog-discovery.d.ts +7 -0
  70. package/dist/lib/context-catalog/catalog-discovery.js +81 -0
  71. package/dist/lib/context-catalog/catalog-load.d.ts +8 -0
  72. package/dist/lib/context-catalog/catalog-load.js +187 -0
  73. package/dist/lib/context-catalog/catalog-path-validation.d.ts +7 -0
  74. package/dist/lib/context-catalog/catalog-path-validation.js +62 -0
  75. package/dist/lib/context-catalog/catalog-paths.d.ts +11 -0
  76. package/dist/lib/context-catalog/catalog-paths.js +41 -0
  77. package/dist/lib/context-catalog/catalog-portable-contract.d.ts +15 -0
  78. package/dist/lib/context-catalog/catalog-portable-contract.js +68 -0
  79. package/dist/lib/context-catalog/catalog-staged-path-safety.d.ts +1 -0
  80. package/dist/lib/context-catalog/catalog-staged-path-safety.js +36 -0
  81. package/dist/lib/context-catalog/catalog-types.d.ts +40 -0
  82. package/dist/lib/context-catalog/catalog-types.js +1 -0
  83. package/dist/lib/context-catalog/catalog-validation.d.ts +9 -0
  84. package/dist/lib/context-catalog/catalog-validation.js +148 -0
  85. package/dist/lib/context-create/context-create-path.d.ts +2 -0
  86. package/dist/lib/context-create/context-create-path.js +30 -0
  87. package/dist/lib/context-create/context-create-template.d.ts +2 -0
  88. package/dist/lib/context-create/context-create-template.js +95 -0
  89. package/dist/lib/context-create/context-create-types.d.ts +28 -0
  90. package/dist/lib/context-create/context-create-types.js +1 -0
  91. package/dist/lib/context-create/context-create-write.d.ts +1 -0
  92. package/dist/lib/context-create/context-create-write.js +85 -0
  93. package/dist/lib/context-create/context-create.d.ts +2 -0
  94. package/dist/lib/context-create/context-create.js +84 -0
  95. package/dist/lib/context-default-footprint.d.ts +2 -3
  96. package/dist/lib/context-default-footprint.js +49 -57
  97. package/dist/lib/context-doctor/context-doctor-types.d.ts +16 -0
  98. package/dist/lib/context-doctor/context-doctor-types.js +15 -0
  99. package/dist/lib/context-doctor/context-doctor.d.ts +2 -0
  100. package/dist/lib/context-doctor/context-doctor.js +130 -0
  101. package/dist/lib/context-graph-snapshot.d.ts +5 -0
  102. package/dist/lib/context-graph-snapshot.js +46 -25
  103. package/dist/lib/context-inspect/context-inspect-projection.d.ts +9 -0
  104. package/dist/lib/context-inspect/context-inspect-projection.js +49 -0
  105. package/dist/lib/context-inspect/context-inspect-render.d.ts +2 -0
  106. package/dist/lib/context-inspect/context-inspect-render.js +29 -0
  107. package/dist/lib/context-inspect/context-inspect-types.d.ts +43 -0
  108. package/dist/lib/context-inspect/context-inspect-types.js +1 -0
  109. package/dist/lib/context-inspect/context-inspect.d.ts +2 -0
  110. package/dist/lib/context-inspect/context-inspect.js +104 -0
  111. package/dist/lib/context-manifest-schema.d.ts +1 -1
  112. package/dist/lib/context-manifest-schema.js +4 -20
  113. package/dist/lib/context-markdown/context-markdown-analysis.d.ts +15 -0
  114. package/dist/lib/context-markdown/context-markdown-analysis.js +245 -0
  115. package/dist/lib/context-markdown/context-markdown-extract.d.ts +7 -0
  116. package/dist/lib/context-markdown/context-markdown-extract.js +114 -0
  117. package/dist/lib/context-markdown/context-markdown-types.d.ts +57 -0
  118. package/dist/lib/context-markdown/context-markdown-types.js +1 -0
  119. package/dist/lib/context-move/context-move-input.d.ts +8 -0
  120. package/dist/lib/context-move/context-move-input.js +17 -0
  121. package/dist/lib/context-move/context-move-literal-scan.d.ts +20 -0
  122. package/dist/lib/context-move/context-move-literal-scan.js +213 -0
  123. package/dist/lib/context-move/context-move-live-validation.d.ts +3 -0
  124. package/dist/lib/context-move/context-move-live-validation.js +56 -0
  125. package/dist/lib/context-move/context-move-markdown-plan.d.ts +22 -0
  126. package/dist/lib/context-move/context-move-markdown-plan.js +39 -0
  127. package/dist/lib/context-move/context-move-projection.d.ts +3 -0
  128. package/dist/lib/context-move/context-move-projection.js +11 -0
  129. package/dist/lib/context-move/context-move-reference-validation.d.ts +11 -0
  130. package/dist/lib/context-move/context-move-reference-validation.js +64 -0
  131. package/dist/lib/context-move/context-move-render.d.ts +2 -0
  132. package/dist/lib/context-move/context-move-render.js +24 -0
  133. package/dist/lib/context-move/context-move-support.d.ts +10 -0
  134. package/dist/lib/context-move/context-move-support.js +88 -0
  135. package/dist/lib/context-move/context-move-transaction-plan.d.ts +24 -0
  136. package/dist/lib/context-move/context-move-transaction-plan.js +108 -0
  137. package/dist/lib/context-move/context-move-types.d.ts +74 -0
  138. package/dist/lib/context-move/context-move-types.js +1 -0
  139. package/dist/lib/context-move/context-move.d.ts +8 -0
  140. package/dist/lib/context-move/context-move.js +180 -0
  141. package/dist/lib/context-mutation/manifest-lossless-patch.d.ts +28 -0
  142. package/dist/lib/context-mutation/manifest-lossless-patch.js +208 -0
  143. package/dist/lib/context-mutation/markdown-link-patch.d.ts +34 -0
  144. package/dist/lib/context-mutation/markdown-link-patch.js +143 -0
  145. package/dist/lib/context-mutation/markdown-link-spans.d.ts +10 -0
  146. package/dist/lib/context-mutation/markdown-link-spans.js +179 -0
  147. package/dist/lib/context-mutation/mutation-cas.d.ts +13 -0
  148. package/dist/lib/context-mutation/mutation-cas.js +365 -0
  149. package/dist/lib/context-mutation/mutation-command-support.d.ts +12 -0
  150. package/dist/lib/context-mutation/mutation-command-support.js +57 -0
  151. package/dist/lib/context-mutation/mutation-commit.d.ts +12 -0
  152. package/dist/lib/context-mutation/mutation-commit.js +89 -0
  153. package/dist/lib/context-mutation/mutation-directories.d.ts +5 -0
  154. package/dist/lib/context-mutation/mutation-directories.js +56 -0
  155. package/dist/lib/context-mutation/mutation-file-state.d.ts +14 -0
  156. package/dist/lib/context-mutation/mutation-file-state.js +137 -0
  157. package/dist/lib/context-mutation/mutation-journal-file-validation.d.ts +1 -0
  158. package/dist/lib/context-mutation/mutation-journal-file-validation.js +106 -0
  159. package/dist/lib/context-mutation/mutation-journal-io.d.ts +5 -0
  160. package/dist/lib/context-mutation/mutation-journal-io.js +55 -0
  161. package/dist/lib/context-mutation/mutation-journal-storage.d.ts +18 -0
  162. package/dist/lib/context-mutation/mutation-journal-storage.js +283 -0
  163. package/dist/lib/context-mutation/mutation-journal-validation-support.d.ts +16 -0
  164. package/dist/lib/context-mutation/mutation-journal-validation-support.js +140 -0
  165. package/dist/lib/context-mutation/mutation-journal-validation.d.ts +3 -0
  166. package/dist/lib/context-mutation/mutation-journal-validation.js +177 -0
  167. package/dist/lib/context-mutation/mutation-journal.d.ts +8 -0
  168. package/dist/lib/context-mutation/mutation-journal.js +111 -0
  169. package/dist/lib/context-mutation/mutation-live-validation.d.ts +3 -0
  170. package/dist/lib/context-mutation/mutation-live-validation.js +51 -0
  171. package/dist/lib/context-mutation/mutation-long-task-guard.d.ts +6 -0
  172. package/dist/lib/context-mutation/mutation-long-task-guard.js +57 -0
  173. package/dist/lib/context-mutation/mutation-recovery.d.ts +4 -0
  174. package/dist/lib/context-mutation/mutation-recovery.js +189 -0
  175. package/dist/lib/context-mutation/mutation-staged-fs.d.ts +5 -0
  176. package/dist/lib/context-mutation/mutation-staged-fs.js +56 -0
  177. package/dist/lib/context-mutation/mutation-types.d.ts +103 -0
  178. package/dist/lib/context-mutation/mutation-types.js +1 -0
  179. package/dist/lib/context-register/context-register-input.d.ts +11 -0
  180. package/dist/lib/context-register/context-register-input.js +43 -0
  181. package/dist/lib/context-register/context-register-render.d.ts +2 -0
  182. package/dist/lib/context-register/context-register-render.js +21 -0
  183. package/dist/lib/context-register/context-register-support.d.ts +6 -0
  184. package/dist/lib/context-register/context-register-support.js +46 -0
  185. package/dist/lib/context-register/context-register-types.d.ts +46 -0
  186. package/dist/lib/context-register/context-register-types.js +1 -0
  187. package/dist/lib/context-register/context-register.d.ts +8 -0
  188. package/dist/lib/context-register/context-register.js +155 -0
  189. package/dist/lib/context-router/context-route-budget.d.ts +15 -0
  190. package/dist/lib/context-router/context-route-budget.js +14 -0
  191. package/dist/lib/context-router/context-route-candidates.d.ts +15 -0
  192. package/dist/lib/context-router/context-route-candidates.js +112 -0
  193. package/dist/lib/context-router/context-route-order.d.ts +6 -0
  194. package/dist/lib/context-router/context-route-order.js +53 -0
  195. package/dist/lib/context-router/context-route-paths.d.ts +16 -0
  196. package/dist/lib/context-router/context-route-paths.js +109 -0
  197. package/dist/lib/context-router/context-route-render.d.ts +2 -0
  198. package/dist/lib/context-router/context-route-render.js +32 -0
  199. package/dist/lib/context-router/context-route-scan.d.ts +18 -0
  200. package/dist/lib/context-router/context-route-scan.js +156 -0
  201. package/dist/lib/context-router/context-route-selection.d.ts +16 -0
  202. package/dist/lib/context-router/context-route-selection.js +72 -0
  203. package/dist/lib/context-router/context-route-terms.d.ts +13 -0
  204. package/dist/lib/context-router/context-route-terms.js +202 -0
  205. package/dist/lib/context-router/context-route-types.d.ts +101 -0
  206. package/dist/lib/context-router/context-route-types.js +1 -0
  207. package/dist/lib/context-router/context-route.d.ts +2 -0
  208. package/dist/lib/context-router/context-route.js +127 -0
  209. package/dist/lib/context-units-migration.d.ts +13 -0
  210. package/dist/lib/context-units-migration.js +217 -0
  211. package/dist/lib/design-authority-binding.d.ts +7 -0
  212. package/dist/lib/design-authority-binding.js +96 -0
  213. package/dist/lib/design-authority-closure.d.ts +3 -0
  214. package/dist/lib/design-authority-closure.js +201 -0
  215. package/dist/lib/design-authority-delta-codec-primitives.d.ts +10 -0
  216. package/dist/lib/design-authority-delta-codec-primitives.js +58 -0
  217. package/dist/lib/design-authority-delta-codec.d.ts +2 -0
  218. package/dist/lib/design-authority-delta-codec.js +193 -0
  219. package/dist/lib/design-authority-delta-types.d.ts +65 -0
  220. package/dist/lib/design-authority-delta-types.js +6 -0
  221. package/dist/lib/design-authority-delta-validation.d.ts +2 -0
  222. package/dist/lib/design-authority-delta-validation.js +16 -0
  223. package/dist/lib/design-authority-digest.d.ts +8 -0
  224. package/dist/lib/design-authority-digest.js +36 -0
  225. package/dist/lib/design-authority-files.d.ts +9 -0
  226. package/dist/lib/design-authority-files.js +62 -0
  227. package/dist/lib/design-authority-format.d.ts +2 -0
  228. package/dist/lib/design-authority-format.js +93 -0
  229. package/dist/lib/design-authority-links.d.ts +10 -0
  230. package/dist/lib/design-authority-links.js +137 -0
  231. package/dist/lib/design-authority-manifest.d.ts +4 -0
  232. package/dist/lib/design-authority-manifest.js +144 -0
  233. package/dist/lib/design-authority-tokens.d.ts +9 -0
  234. package/dist/lib/design-authority-tokens.js +45 -0
  235. package/dist/lib/design-authority-types.d.ts +80 -0
  236. package/dist/lib/design-authority-types.js +23 -0
  237. package/dist/lib/design-md-tool-adapter.d.ts +9 -0
  238. package/dist/lib/design-md-tool-adapter.js +152 -0
  239. package/dist/lib/design-md-tool-normalization.d.ts +7 -0
  240. package/dist/lib/design-md-tool-normalization.js +78 -0
  241. package/dist/lib/design-md-tool-types.d.ts +99 -0
  242. package/dist/lib/design-md-tool-types.js +8 -0
  243. package/dist/lib/design-resource-handoff-bundle.js +5 -0
  244. package/dist/lib/design-resource-handoff-input-types.d.ts +1 -1
  245. package/dist/lib/design-resource-handoff-manifest-projection.js +4 -0
  246. package/dist/lib/design-resource-handoff-set-integrity.js +1 -0
  247. package/dist/lib/design-resource-handoff-shape.js +18 -2
  248. package/dist/lib/design-resource-handoff-types.d.ts +8 -0
  249. package/dist/lib/design-resource-handoff-validation.js +24 -0
  250. package/dist/lib/design-resource-implementation-feasibility-model.d.ts +35 -0
  251. package/dist/lib/design-resource-implementation-feasibility-model.js +62 -0
  252. package/dist/lib/design-resource-implementation-feasibility-shape-sections.d.ts +43 -0
  253. package/dist/lib/design-resource-implementation-feasibility-shape-sections.js +142 -0
  254. package/dist/lib/design-resource-implementation-feasibility-shape.d.ts +4 -0
  255. package/dist/lib/design-resource-implementation-feasibility-shape.js +154 -0
  256. package/dist/lib/design-resource-implementation-feasibility-source-decision-projection.d.ts +24 -0
  257. package/dist/lib/design-resource-implementation-feasibility-source-decision-projection.js +106 -0
  258. package/dist/lib/design-resource-implementation-feasibility-source-decision.d.ts +21 -0
  259. package/dist/lib/design-resource-implementation-feasibility-source-decision.js +75 -0
  260. package/dist/lib/design-resource-implementation-feasibility-types.d.ts +135 -0
  261. package/dist/lib/design-resource-implementation-feasibility-types.js +37 -0
  262. package/dist/lib/design-resource-implementation-feasibility-validation-cells.d.ts +5 -0
  263. package/dist/lib/design-resource-implementation-feasibility-validation-cells.js +125 -0
  264. package/dist/lib/design-resource-implementation-feasibility-validation-document.d.ts +4 -0
  265. package/dist/lib/design-resource-implementation-feasibility-validation-document.js +167 -0
  266. package/dist/lib/design-resource-implementation-feasibility-validation-facts.d.ts +3 -0
  267. package/dist/lib/design-resource-implementation-feasibility-validation-facts.js +76 -0
  268. package/dist/lib/design-resource-implementation-feasibility-validation-realizations.d.ts +8 -0
  269. package/dist/lib/design-resource-implementation-feasibility-validation-realizations.js +76 -0
  270. package/dist/lib/design-resource-implementation-feasibility-validation-support.d.ts +10 -0
  271. package/dist/lib/design-resource-implementation-feasibility-validation-support.js +75 -0
  272. package/dist/lib/design-resource-implementation-feasibility-validation.d.ts +3 -0
  273. package/dist/lib/design-resource-implementation-feasibility-validation.js +138 -0
  274. package/dist/lib/design-resource-recovery-current.js +22 -0
  275. package/dist/lib/design-resource-recovery-shape.js +64 -7
  276. package/dist/lib/design-resource-recovery-types.d.ts +4 -1
  277. package/dist/lib/design-resource-symbolic-fact-shape.js +9 -1
  278. package/dist/lib/design-resource-symbolic-fact-types.d.ts +8 -0
  279. package/dist/lib/design-resource-symbolic-fact-validation.js +25 -0
  280. package/dist/lib/doctor.d.ts +2 -1
  281. package/dist/lib/doctor.js +29 -1
  282. package/dist/lib/fs.js +1 -1
  283. package/dist/lib/long-task-acceptance-reachability-claims.d.ts +2 -0
  284. package/dist/lib/long-task-acceptance-reachability-claims.js +279 -0
  285. package/dist/lib/long-task-acceptance-reachability-design.d.ts +2 -0
  286. package/dist/lib/long-task-acceptance-reachability-design.js +96 -0
  287. package/dist/lib/long-task-acceptance-reachability-external.d.ts +9 -0
  288. package/dist/lib/long-task-acceptance-reachability-external.js +123 -0
  289. package/dist/lib/long-task-acceptance-reachability-helpers.d.ts +64 -0
  290. package/dist/lib/long-task-acceptance-reachability-helpers.js +473 -0
  291. package/dist/lib/long-task-acceptance-reachability-semantic.d.ts +2 -0
  292. package/dist/lib/long-task-acceptance-reachability-semantic.js +122 -0
  293. package/dist/lib/long-task-acceptance-reachability-types.d.ts +91 -0
  294. package/dist/lib/long-task-acceptance-reachability-types.js +1 -0
  295. package/dist/lib/long-task-acceptance-reachability.d.ts +4 -0
  296. package/dist/lib/long-task-acceptance-reachability.js +115 -0
  297. package/dist/lib/long-task-activation-validation.d.ts +6 -0
  298. package/dist/lib/long-task-activation-validation.js +96 -23
  299. package/dist/lib/long-task-active-authority-lock-context.d.ts +4 -0
  300. package/dist/lib/long-task-active-authority-lock-context.js +29 -0
  301. package/dist/lib/long-task-applicability-identity.d.ts +25 -0
  302. package/dist/lib/long-task-applicability-identity.js +60 -0
  303. package/dist/lib/long-task-authoring-preflight-diagnostics.js +8 -0
  304. package/dist/lib/long-task-authoring-preflight-types.d.ts +2 -0
  305. package/dist/lib/long-task-authoring-preflight-types.js +9 -0
  306. package/dist/lib/long-task-authoring-preflight.js +18 -2
  307. package/dist/lib/long-task-authority-material-diff.js +4 -0
  308. package/dist/lib/long-task-authority-materials.js +19 -0
  309. package/dist/lib/long-task-authority-policy.d.ts +3 -0
  310. package/dist/lib/long-task-authority-policy.js +3 -0
  311. package/dist/lib/long-task-authority-revision-details.js +2 -1
  312. package/dist/lib/long-task-authority-types.d.ts +2 -0
  313. package/dist/lib/long-task-authority.js +2 -0
  314. package/dist/lib/long-task-check-runner.js +3 -296
  315. package/dist/lib/long-task-check-shape.js +6 -1
  316. package/dist/lib/long-task-claim-definitions.js +1 -3
  317. package/dist/lib/long-task-claim-semantic-proof-floor.d.ts +3 -0
  318. package/dist/lib/long-task-claim-semantic-proof-floor.js +78 -0
  319. package/dist/lib/long-task-claims.d.ts +0 -18
  320. package/dist/lib/long-task-claims.js +15 -14
  321. package/dist/lib/long-task-command-process.d.ts +9 -0
  322. package/dist/lib/long-task-command-process.js +178 -0
  323. package/dist/lib/long-task-compact-authoring.js +3 -0
  324. package/dist/lib/long-task-compact-projections.js +10 -0
  325. package/dist/lib/long-task-complete-delivery-evidence-types.d.ts +38 -0
  326. package/dist/lib/long-task-complete-delivery-evidence-types.js +1 -0
  327. package/dist/lib/long-task-completion-types.d.ts +109 -0
  328. package/dist/lib/long-task-completion-types.js +1 -0
  329. package/dist/lib/long-task-conformance-policy.d.ts +2 -1
  330. package/dist/lib/long-task-conformance-policy.js +11 -4
  331. package/dist/lib/long-task-context-authority-topology.js +6 -4
  332. package/dist/lib/long-task-contract-types.d.ts +52 -1
  333. package/dist/lib/long-task-counterfactual-sandbox.d.ts +7 -1
  334. package/dist/lib/long-task-counterfactual-sandbox.js +86 -6
  335. package/dist/lib/long-task-delivery-compiler-preflight.d.ts +24 -0
  336. package/dist/lib/long-task-delivery-compiler-preflight.js +32 -0
  337. package/dist/lib/long-task-delivery-compiler.d.ts +1 -0
  338. package/dist/lib/long-task-delivery-compiler.js +59 -44
  339. package/dist/lib/long-task-delivery-parser.d.ts +3 -0
  340. package/dist/lib/long-task-delivery-parser.js +26 -8
  341. package/dist/lib/long-task-delivery-types.d.ts +2 -0
  342. package/dist/lib/long-task-delivery-types.js +2 -0
  343. package/dist/lib/long-task-delivery-validation.d.ts +11 -3
  344. package/dist/lib/long-task-delivery-validation.js +23 -8
  345. package/dist/lib/long-task-design-feasibility-binding-owners.d.ts +6 -0
  346. package/dist/lib/long-task-design-feasibility-binding-owners.js +52 -0
  347. package/dist/lib/long-task-design-feasibility-binding.d.ts +14 -0
  348. package/dist/lib/long-task-design-feasibility-binding.js +114 -0
  349. package/dist/lib/long-task-design-feasibility-source-closure.d.ts +11 -0
  350. package/dist/lib/long-task-design-feasibility-source-closure.js +87 -0
  351. package/dist/lib/long-task-design-obligation.d.ts +50 -0
  352. package/dist/lib/long-task-design-obligation.js +99 -0
  353. package/dist/lib/long-task-design-resource-handoff.d.ts +5 -3
  354. package/dist/lib/long-task-design-resource-handoff.js +64 -4
  355. package/dist/lib/long-task-design-resource-method-binding.js +20 -2
  356. package/dist/lib/long-task-effective-external-takeover.d.ts +15 -0
  357. package/dist/lib/long-task-effective-external-takeover.js +109 -0
  358. package/dist/lib/long-task-effective-external-ui-takeover.d.ts +5 -0
  359. package/dist/lib/long-task-effective-external-ui-takeover.js +117 -0
  360. package/dist/lib/long-task-evidence-capability-codec.js +91 -0
  361. package/dist/lib/long-task-evidence-capability-runtime.js +62 -14
  362. package/dist/lib/long-task-evidence-capability-types.d.ts +3 -2
  363. package/dist/lib/long-task-evidence-v2.d.ts +6 -1
  364. package/dist/lib/long-task-evidence-v2.js +253 -170
  365. package/dist/lib/long-task-execution-observation.d.ts +7 -0
  366. package/dist/lib/long-task-execution-observation.js +21 -4
  367. package/dist/lib/long-task-expected-authority.d.ts +4 -0
  368. package/dist/lib/long-task-expected-authority.js +126 -0
  369. package/dist/lib/long-task-external-confirmation-artifacts.d.ts +9 -0
  370. package/dist/lib/long-task-external-confirmation-artifacts.js +138 -0
  371. package/dist/lib/long-task-external-confirmation-attestation.d.ts +20 -0
  372. package/dist/lib/long-task-external-confirmation-attestation.js +115 -0
  373. package/dist/lib/long-task-external-confirmation-challenge.d.ts +23 -0
  374. package/dist/lib/long-task-external-confirmation-challenge.js +164 -0
  375. package/dist/lib/long-task-external-confirmation-context.d.ts +14 -0
  376. package/dist/lib/long-task-external-confirmation-context.js +53 -0
  377. package/dist/lib/long-task-external-confirmation-evaluation.d.ts +11 -0
  378. package/dist/lib/long-task-external-confirmation-evaluation.js +454 -0
  379. package/dist/lib/long-task-external-confirmation-expected.d.ts +8 -0
  380. package/dist/lib/long-task-external-confirmation-expected.js +200 -0
  381. package/dist/lib/long-task-external-confirmation-identity.d.ts +10 -0
  382. package/dist/lib/long-task-external-confirmation-identity.js +77 -0
  383. package/dist/lib/long-task-external-confirmation-plan.d.ts +25 -0
  384. package/dist/lib/long-task-external-confirmation-plan.js +148 -0
  385. package/dist/lib/long-task-external-confirmation-preparation.d.ts +4 -0
  386. package/dist/lib/long-task-external-confirmation-preparation.js +100 -0
  387. package/dist/lib/long-task-external-confirmation-shape.d.ts +8 -0
  388. package/dist/lib/long-task-external-confirmation-shape.js +387 -0
  389. package/dist/lib/long-task-external-confirmation-state.d.ts +10 -0
  390. package/dist/lib/long-task-external-confirmation-state.js +109 -0
  391. package/dist/lib/long-task-external-confirmation-types.d.ts +195 -0
  392. package/dist/lib/long-task-external-confirmation-types.js +1 -0
  393. package/dist/lib/long-task-final-integrity.d.ts +2 -0
  394. package/dist/lib/long-task-final-integrity.js +21 -10
  395. package/dist/lib/long-task-final-v2.d.ts +7 -2
  396. package/dist/lib/long-task-final-v2.js +179 -55
  397. package/dist/lib/long-task-finalization-identity.d.ts +27 -0
  398. package/dist/lib/long-task-finalization-identity.js +58 -0
  399. package/dist/lib/long-task-finding-context.d.ts +1 -1
  400. package/dist/lib/long-task-finding-context.js +139 -13
  401. package/dist/lib/long-task-freshness.d.ts +27 -0
  402. package/dist/lib/long-task-freshness.js +129 -6
  403. package/dist/lib/long-task-git.js +3 -3
  404. package/dist/lib/long-task-material-input-closure.d.ts +3 -0
  405. package/dist/lib/long-task-material-input-closure.js +92 -0
  406. package/dist/lib/long-task-obligation-authority-resolution.d.ts +12 -0
  407. package/dist/lib/long-task-obligation-authority-resolution.js +57 -0
  408. package/dist/lib/long-task-obligation-semantic-identity.d.ts +16 -0
  409. package/dist/lib/long-task-obligation-semantic-identity.js +116 -0
  410. package/dist/lib/long-task-observation-authority.d.ts +11 -0
  411. package/dist/lib/long-task-observation-authority.js +137 -6
  412. package/dist/lib/long-task-process-table.d.ts +9 -0
  413. package/dist/lib/long-task-process-table.js +87 -0
  414. package/dist/lib/long-task-process-tree.d.ts +8 -0
  415. package/dist/lib/long-task-process-tree.js +108 -0
  416. package/dist/lib/long-task-proof-adequacy.d.ts +12 -0
  417. package/dist/lib/long-task-proof-adequacy.js +57 -0
  418. package/dist/lib/long-task-proof-capability-floor.d.ts +6 -0
  419. package/dist/lib/long-task-proof-capability-floor.js +137 -0
  420. package/dist/lib/long-task-protected-files.d.ts +1 -1
  421. package/dist/lib/long-task-protected-files.js +1 -1
  422. package/dist/lib/long-task-repair-frontier-checks.d.ts +8 -0
  423. package/dist/lib/long-task-repair-frontier-checks.js +93 -0
  424. package/dist/lib/long-task-repair-frontier-groups.d.ts +2 -0
  425. package/dist/lib/long-task-repair-frontier-groups.js +64 -0
  426. package/dist/lib/long-task-repair-frontier-utils.d.ts +6 -0
  427. package/dist/lib/long-task-repair-frontier-utils.js +27 -0
  428. package/dist/lib/long-task-repair-frontier.d.ts +14 -0
  429. package/dist/lib/long-task-repair-frontier.js +132 -0
  430. package/dist/lib/long-task-risk.d.ts +3 -2
  431. package/dist/lib/long-task-risk.js +73 -24
  432. package/dist/lib/long-task-root-shape.js +148 -8
  433. package/dist/lib/long-task-runner-freeze.d.ts +2 -1
  434. package/dist/lib/long-task-runner-freeze.js +23 -8
  435. package/dist/lib/long-task-runtime-types.d.ts +34 -40
  436. package/dist/lib/long-task-semantic-assurance-policy.js +2 -11
  437. package/dist/lib/long-task-semantic-contract-types.d.ts +2 -1
  438. package/dist/lib/long-task-semantic-drift-migration.js +48 -2
  439. package/dist/lib/long-task-semantic-fact-binding-types.d.ts +20 -0
  440. package/dist/lib/long-task-semantic-fact-closure.d.ts +5 -1
  441. package/dist/lib/long-task-semantic-fact-closure.js +33 -5
  442. package/dist/lib/long-task-semantic-fact-contract-closure.js +176 -1
  443. package/dist/lib/long-task-semantic-fact-contract-proofs.js +18 -1
  444. package/dist/lib/long-task-semantic-fact-input-closure.d.ts +16 -2
  445. package/dist/lib/long-task-semantic-fact-input-closure.js +138 -15
  446. package/dist/lib/long-task-semantic-fact-provenance-closure.js +1 -1
  447. package/dist/lib/long-task-semantic-fact-shape.d.ts +2 -1
  448. package/dist/lib/long-task-semantic-fact-shape.js +35 -1
  449. package/dist/lib/long-task-semantic-proof-adequacy.d.ts +2 -0
  450. package/dist/lib/long-task-semantic-proof-adequacy.js +19 -0
  451. package/dist/lib/long-task-semantic-proof-profile.d.ts +5 -0
  452. package/dist/lib/long-task-semantic-proof-profile.js +187 -0
  453. package/dist/lib/long-task-shape-primitives.d.ts +1 -1
  454. package/dist/lib/long-task-shape-primitives.js +5 -0
  455. package/dist/lib/long-task-source-anchors.d.ts +10 -0
  456. package/dist/lib/long-task-source-anchors.js +102 -0
  457. package/dist/lib/long-task-source-authority-types.d.ts +46 -0
  458. package/dist/lib/long-task-source-claim-validation.js +36 -0
  459. package/dist/lib/long-task-source-conservation-facts.d.ts +8 -0
  460. package/dist/lib/long-task-source-conservation-facts.js +57 -0
  461. package/dist/lib/long-task-source-conservation-types.d.ts +34 -0
  462. package/dist/lib/long-task-source-conservation-types.js +1 -0
  463. package/dist/lib/long-task-source-conservation.d.ts +7 -0
  464. package/dist/lib/long-task-source-conservation.js +110 -0
  465. package/dist/lib/long-task-source-fragments.d.ts +6 -0
  466. package/dist/lib/long-task-source-fragments.js +219 -0
  467. package/dist/lib/long-task-source-projection-resolution.d.ts +5 -0
  468. package/dist/lib/long-task-source-projection-resolution.js +57 -0
  469. package/dist/lib/long-task-source-projection-validation.d.ts +17 -0
  470. package/dist/lib/long-task-source-projection-validation.js +154 -0
  471. package/dist/lib/long-task-source-shape.js +14 -6
  472. package/dist/lib/long-task-source-supersession.d.ts +5 -0
  473. package/dist/lib/long-task-source-supersession.js +138 -0
  474. package/dist/lib/long-task-stage-policy.d.ts +7 -2
  475. package/dist/lib/long-task-stage-policy.js +67 -23
  476. package/dist/lib/long-task-state.d.ts +18 -4
  477. package/dist/lib/long-task-state.js +319 -33
  478. package/dist/lib/long-task-static-observation-freeze.js +4 -3
  479. package/dist/lib/long-task-status-projection.d.ts +3 -1
  480. package/dist/lib/long-task-status-projection.js +44 -13
  481. package/dist/lib/long-task-status-v2.d.ts +10 -6
  482. package/dist/lib/long-task-status-v2.js +70 -58
  483. package/dist/lib/long-task-target-policy.d.ts +8 -3
  484. package/dist/lib/long-task-target-policy.js +40 -9
  485. package/dist/lib/long-task-terminal-finalization.d.ts +12 -0
  486. package/dist/lib/long-task-terminal-finalization.js +190 -0
  487. package/dist/lib/long-task-ui-design-policy.js +15 -4
  488. package/dist/lib/long-task-ui-surface-policy.d.ts +2 -1
  489. package/dist/lib/long-task-ui-surface-policy.js +7 -4
  490. package/dist/lib/long-task-ui-surface-validation.d.ts +3 -1
  491. package/dist/lib/long-task-ui-surface-validation.js +2 -2
  492. package/dist/lib/long-task-verifier-counterfactuals.d.ts +11 -0
  493. package/dist/lib/long-task-verifier-counterfactuals.js +96 -0
  494. package/dist/lib/long-task-verifier-execution.d.ts +9 -0
  495. package/dist/lib/long-task-verifier-execution.js +67 -0
  496. package/dist/lib/long-task-verifier-identity.js +16 -5
  497. package/dist/lib/long-task-verifier-v2.js +52 -65
  498. package/dist/lib/long-task-windows-job-supervisor-helper.d.ts +1 -0
  499. package/dist/lib/long-task-windows-job-supervisor-helper.js +104 -0
  500. package/dist/lib/long-task-windows-job-supervisor-protocol.d.ts +28 -0
  501. package/dist/lib/long-task-windows-job-supervisor-protocol.js +124 -0
  502. package/dist/lib/long-task-windows-job-supervisor-result.d.ts +11 -0
  503. package/dist/lib/long-task-windows-job-supervisor-result.js +152 -0
  504. package/dist/lib/long-task-windows-job-supervisor.d.ts +2 -0
  505. package/dist/lib/long-task-windows-job-supervisor.js +126 -0
  506. package/dist/lib/long-task-workspace-scope.d.ts +1 -0
  507. package/dist/lib/long-task-workspace-scope.js +4 -1
  508. package/dist/lib/long-task-workspace.d.ts +1 -0
  509. package/dist/lib/long-task-workspace.js +10 -0
  510. package/dist/lib/migrations.js +43 -2
  511. package/dist/lib/repository-path-safety.d.ts +3 -0
  512. package/dist/lib/repository-path-safety.js +39 -3
  513. package/dist/lib/semantic-fact-input-shape.d.ts +7 -2
  514. package/dist/lib/semantic-fact-input-shape.js +25 -1
  515. package/dist/lib/semantic-fact-inventory-types.d.ts +8 -2
  516. package/dist/lib/semantic-fact-policy-census.d.ts +1 -1
  517. package/dist/lib/semantic-fact-policy-census.js +5 -2
  518. package/dist/lib/semantic-fact-policy.d.ts +1 -1
  519. package/dist/lib/semantic-fact-policy.js +2 -2
  520. package/dist/lib/semantic-fact-proof-shape.d.ts +1 -1
  521. package/dist/lib/semantic-fact-property-shape.d.ts +1 -1
  522. package/dist/lib/validators.d.ts +3 -0
  523. package/dist/lib/validators.js +45 -157
  524. package/dist/public-api-core.d.ts +12 -0
  525. package/dist/public-api-core.js +12 -0
  526. package/dist/public-api-long-task.d.ts +10 -0
  527. package/dist/public-api-long-task.js +10 -0
  528. package/dist/public-types.d.ts +6 -1
  529. package/dist/schemas/design-authority-delta-assessment-v1.schema.json +191 -0
  530. package/dist/schemas/long-task-delivery-v2/long-task-delivery-v2.schema.json +166 -2
  531. package/dist/schemas/long-task-external-confirmation-record-v1.schema.json +155 -0
  532. package/dist/schemas/long-task-external-confirmation-record-v2.schema.json +209 -0
  533. package/migrations/README.md +99 -0
  534. package/package.json +7 -5
  535. package/source-mappings.yaml +18 -0
@@ -0,0 +1,109 @@
1
+ import { claimObligationRef, sameSet, } from "./long-task-acceptance-reachability-helpers.js";
2
+ export function effectiveBlockingExternalRows(reachability) {
3
+ return (reachability?.effective_external_routes ?? []).filter((row) => row.authority === "external_confirmation" &&
4
+ row.status === "external_fulfillable" &&
5
+ row.completion_role === "blocking" &&
6
+ row.acceptance_effect === "required");
7
+ }
8
+ function effectivePopulationRows(outcomeKey, reachability) {
9
+ return effectiveBlockingExternalRows(reachability).filter((row) => row.outcome_key === outcomeKey &&
10
+ row.proof_surface === "population_coverage" &&
11
+ row.method === "population_set_equality" &&
12
+ row.fact_ref !== null &&
13
+ row.proof_ref !== null &&
14
+ row.source_obligation_ref === row.proof_ref &&
15
+ row.required_evidence_capabilities.includes("semantic_fact") &&
16
+ row.required_evidence_capabilities.includes("population_coverage"));
17
+ }
18
+ function requiredExternalPopulationProofs(outcome, localClaimRef) {
19
+ return outcome.semantic_fact_bindings.facts
20
+ .filter((binding) => binding.claim_ref === localClaimRef)
21
+ .flatMap((factBinding) => outcome.semantic_fact_bindings.proofs
22
+ .filter((proofBinding) => proofBinding.fact_ref === factBinding.fact_ref &&
23
+ proofBinding.authority === "external_confirmation" &&
24
+ proofBinding.method === "population_set_equality" &&
25
+ proofBinding.proof_surface === "population_coverage")
26
+ .map((proofBinding) => ({
27
+ factBinding,
28
+ proofBinding,
29
+ confirmationRef: proofBinding.authority === "external_confirmation"
30
+ ? proofBinding.confirmation_ref
31
+ : null,
32
+ })));
33
+ }
34
+ function populationProofRequirementEffectivelyBlocked(outcome, requirement, rows) {
35
+ const { factBinding, proofBinding, confirmationRef } = requirement;
36
+ const profile = outcome.applicability.find((candidate) => candidate.key === factBinding.applicability_ref);
37
+ if (!profile)
38
+ return false;
39
+ return (rows.filter((row) => row.claim_ref === `${outcome.key}.${factBinding.claim_ref}` &&
40
+ row.local_claim_ref === factBinding.claim_ref &&
41
+ row.applicability_ref === factBinding.applicability_ref &&
42
+ row.target_ref === profile.target_ref &&
43
+ row.fact_ref === factBinding.fact_ref &&
44
+ row.proof_ref === proofBinding.proof_ref &&
45
+ row.source_obligation_ref === proofBinding.proof_ref &&
46
+ row.method === proofBinding.method &&
47
+ row.proof_surface === proofBinding.proof_surface &&
48
+ row.confirmation_ref === confirmationRef &&
49
+ sameSet(row.required_evidence_capabilities, proofBinding.evidence_capabilities)).length === 1);
50
+ }
51
+ function populationClaimFullyEffectivelyExternallyBlocked(outcome, localClaimRef, rows) {
52
+ const requirements = requiredExternalPopulationProofs(outcome, localClaimRef);
53
+ return (requirements.length > 0 &&
54
+ requirements.every((requirement) => populationProofRequirementEffectivelyBlocked(outcome, requirement, rows)));
55
+ }
56
+ export function outcomePopulationSemanticProofFullyEffectivelyExternallyBlocked(outcome, reachability) {
57
+ const population = outcome.acceptance.population;
58
+ if (!population?.claims.length)
59
+ return false;
60
+ const rows = effectivePopulationRows(outcome.key, reachability);
61
+ return population.claims.every((localClaimRef) => populationClaimFullyEffectivelyExternallyBlocked(outcome, localClaimRef, rows));
62
+ }
63
+ function effectiveBlockingResultRows(reachability, outcomeKey) {
64
+ const claimRef = `${outcomeKey}.result`;
65
+ return effectiveBlockingExternalRows(reachability).filter((row) => {
66
+ const ordinaryObligationRef = claimObligationRef(claimRef, row.applicability_ref, row.proof_surface);
67
+ return (row.outcome_key === outcomeKey &&
68
+ row.claim_ref === claimRef &&
69
+ row.local_claim_ref === "result" &&
70
+ row.fact_ref === null &&
71
+ row.proof_ref === null &&
72
+ row.source_obligation_ref === ordinaryObligationRef);
73
+ });
74
+ }
75
+ export function resultApplicabilityEffectivelyExternallyBlocked(reachability, outcomeKey, applicabilityRef, targetRef) {
76
+ const rows = effectiveBlockingResultRows(reachability, outcomeKey).filter((row) => row.applicability_ref === applicabilityRef &&
77
+ row.target_ref === targetRef);
78
+ return rows.length === 1;
79
+ }
80
+ export function resultApplicabilityProfiles(outcome, options = {}) {
81
+ const profiles = new Map(outcome.applicability.map((profile) => [profile.key, profile]));
82
+ return outcome.product.result_applicability_refs
83
+ .map((ref) => profiles.get(ref))
84
+ .filter((profile) => Boolean(profile))
85
+ .filter((profile) => (options.target_ref === undefined ||
86
+ profile.target_ref === options.target_ref) &&
87
+ (options.journey_role === undefined ||
88
+ profile.journey_role === options.journey_role));
89
+ }
90
+ export function outcomeResultScopeFullyEffectivelyExternallyBlocked(outcome, reachability, options = {}) {
91
+ const profiles = resultApplicabilityProfiles(outcome, options);
92
+ if (!profiles.length)
93
+ return false;
94
+ const requiredRefs = new Set(profiles.map((profile) => profile.key));
95
+ const rows = effectiveBlockingResultRows(reachability, outcome.key).filter((row) => requiredRefs.has(row.applicability_ref));
96
+ return (rows.length === profiles.length &&
97
+ profiles.every((profile) => rows.filter((row) => row.applicability_ref === profile.key &&
98
+ row.target_ref === profile.target_ref).length === 1));
99
+ }
100
+ export function outcomeResultFullyEffectivelyExternallyBlocked(outcome, reachability) {
101
+ if (resultApplicabilityProfiles(outcome).length !==
102
+ outcome.product.result_applicability_refs.length)
103
+ return false;
104
+ return outcomeResultScopeFullyEffectivelyExternallyBlocked(outcome, reachability);
105
+ }
106
+ export function allOutcomeResultsFullyEffectivelyExternallyBlocked(contract, reachability) {
107
+ return (contract.outcomes.length > 0 &&
108
+ contract.outcomes.every((outcome) => outcomeResultFullyEffectivelyExternallyBlocked(outcome, reachability)));
109
+ }
@@ -0,0 +1,5 @@
1
+ import type { DeliveryContractV2 } from "./long-task-delivery-types.js";
2
+ import type { AcceptanceReachabilityV1 } from "./long-task-acceptance-reachability-types.js";
3
+ type DeliveryOutcomeV2 = DeliveryContractV2["outcomes"][number];
4
+ export declare function outcomeUiProofFullyEffectivelyExternallyBlocked(contract: DeliveryContractV2, outcome: DeliveryOutcomeV2, reachability: AcceptanceReachabilityV1 | null | undefined): boolean;
5
+ export {};
@@ -0,0 +1,117 @@
1
+ import { controlFieldFacts } from "./long-task-control-fields.js";
2
+ import { designFactObligationDescriptors } from "./long-task-design-obligation.js";
3
+ import { effectiveBlockingExternalRows } from "./long-task-effective-external-takeover.js";
4
+ function designObligationEffectivelyBlocked(descriptor, rows) {
5
+ return (rows.filter((row) => row.source_obligation_ref === descriptor.source_obligation_ref &&
6
+ row.claim_ref === descriptor.claim_ref &&
7
+ row.local_claim_ref === descriptor.local_claim_ref &&
8
+ row.applicability_ref === descriptor.applicability_ref &&
9
+ row.proof_surface === descriptor.proof_surface &&
10
+ row.fact_ref === descriptor.fact_ref &&
11
+ row.proof_ref === descriptor.source_obligation_ref).length === 1);
12
+ }
13
+ function claimApplicabilityKey(localClaimRef, applicabilityRef) {
14
+ return `${localClaimRef}\0${applicabilityRef}`;
15
+ }
16
+ function controlClaimApplicabilities(outcome) {
17
+ const entries = new Set();
18
+ for (const control of outcome.product.controls)
19
+ for (const fact of controlFieldFacts(control))
20
+ for (const applicabilityRef of fact.applicability_refs)
21
+ entries.add(claimApplicabilityKey(`control.${control.key}.${fact.claim_field}`, applicabilityRef));
22
+ return entries;
23
+ }
24
+ function designTargetAssertionRefs(target) {
25
+ return new Set([
26
+ target.conformance_assertion_ref,
27
+ ...target.verification_method_bindings.map((binding) => binding.assertion_ref),
28
+ ...(target.symbolic_method_bindings ?? []).map((binding) => binding.assertion_ref),
29
+ ...(target.symbolic_certificate_binding
30
+ ? [target.symbolic_certificate_binding.assertion_ref]
31
+ : []),
32
+ ]);
33
+ }
34
+ function addDesignAssertionClaimApplicabilities(entries, check, assertionRefs) {
35
+ for (const assertion of [
36
+ ...check.positive_assertions,
37
+ ...check.negative_assertions,
38
+ ])
39
+ if (assertionRefs.has(assertion.key) &&
40
+ assertion.claims.length === 1 &&
41
+ assertion.applicability_ref)
42
+ entries.add(claimApplicabilityKey(assertion.claims[0], assertion.applicability_ref));
43
+ }
44
+ function allUiClaimApplicabilities(outcome) {
45
+ const entries = controlClaimApplicabilities(outcome);
46
+ for (const surface of outcome.product.surface_bindings)
47
+ for (const target of surface.design_targets) {
48
+ const check = outcome.acceptance.checks.find((candidate) => candidate.key === target.conformance_check_ref);
49
+ if (!check)
50
+ return null;
51
+ addDesignAssertionClaimApplicabilities(entries, check, designTargetAssertionRefs(target));
52
+ }
53
+ return entries;
54
+ }
55
+ function matchingCoordinates(outcome, localClaimRef, applicabilityRef, targetRef) {
56
+ return outcome.acceptance.checks.flatMap((check) => [...check.positive_assertions, ...check.negative_assertions]
57
+ .filter((assertion) => assertionMatchesClaimApplicability(assertion, localClaimRef, applicabilityRef))
58
+ .map(() => ({
59
+ local_claim_ref: localClaimRef,
60
+ applicability_ref: applicabilityRef,
61
+ target_ref: targetRef,
62
+ proof_surface: check.proof_surface,
63
+ })));
64
+ }
65
+ function assertionMatchesClaimApplicability(assertion, localClaimRef, applicabilityRef) {
66
+ return (assertion.claims.length === 1 &&
67
+ assertion.claims[0] === localClaimRef &&
68
+ assertion.applicability_ref === applicabilityRef);
69
+ }
70
+ function coordinateKey(coordinate) {
71
+ return [
72
+ coordinate.local_claim_ref,
73
+ coordinate.applicability_ref,
74
+ coordinate.target_ref,
75
+ coordinate.proof_surface,
76
+ ].join("\0");
77
+ }
78
+ function uiClaimCoordinates(outcome) {
79
+ const entries = allUiClaimApplicabilities(outcome);
80
+ if (!entries)
81
+ return null;
82
+ const profiles = new Map(outcome.applicability.map((profile) => [profile.key, profile]));
83
+ const coordinates = new Map();
84
+ for (const entry of entries) {
85
+ const [localClaimRef, applicabilityRef] = entry.split("\0");
86
+ const profile = profiles.get(applicabilityRef);
87
+ if (!profile)
88
+ return null;
89
+ const matching = matchingCoordinates(outcome, localClaimRef, applicabilityRef, profile.target_ref);
90
+ if (!matching.length)
91
+ return null;
92
+ for (const coordinate of matching)
93
+ coordinates.set(coordinateKey(coordinate), coordinate);
94
+ }
95
+ return coordinates;
96
+ }
97
+ function ordinaryUiCoordinateEffectivelyBlocked(outcomeKey, coordinate, rows) {
98
+ return (rows.filter((row) => row.claim_ref === `${outcomeKey}.${coordinate.local_claim_ref}` &&
99
+ row.local_claim_ref === coordinate.local_claim_ref &&
100
+ row.applicability_ref === coordinate.applicability_ref &&
101
+ row.target_ref === coordinate.target_ref &&
102
+ row.proof_surface === coordinate.proof_surface &&
103
+ row.fact_ref === null &&
104
+ row.proof_ref === null).length === 1);
105
+ }
106
+ export function outcomeUiProofFullyEffectivelyExternallyBlocked(contract, outcome, reachability) {
107
+ const rows = effectiveBlockingExternalRows(reachability).filter((row) => row.outcome_key === outcome.key);
108
+ const designObligations = designFactObligationDescriptors(contract).filter((descriptor) => descriptor.outcome_key === outcome.key);
109
+ if (!designObligations.every((descriptor) => designObligationEffectivelyBlocked(descriptor, rows)))
110
+ return false;
111
+ const coordinates = uiClaimCoordinates(outcome);
112
+ if (!coordinates)
113
+ return false;
114
+ if (!designObligations.length && !coordinates.size)
115
+ return false;
116
+ return [...coordinates.values()].every((coordinate) => ordinaryUiCoordinateEffectivelyBlocked(outcome.key, coordinate, rows));
117
+ }
@@ -12,6 +12,9 @@ function decodeRecord(value, index) {
12
12
  const assertionKey = key(row.assertion_key, `${label}.assertion_key`);
13
13
  const capability = nonEmpty(row.capability, `${label}.capability`);
14
14
  const base = { assertion_key: assertionKey };
15
+ const completeDelivery = decodeCompleteDeliveryEvidenceRecord(row, label, base, capability);
16
+ if (completeDelivery)
17
+ return completeDelivery;
15
18
  switch (capability) {
16
19
  case "interaction_trace":
17
20
  exact(row, label, [
@@ -196,6 +199,94 @@ function decodeRecord(value, index) {
196
199
  throw invalidRecord(`${label}.capability_unsupported:${capability}`);
197
200
  }
198
201
  }
202
+ function decodeCompleteDeliveryEvidenceRecord(row, label, base, capability) {
203
+ switch (capability) {
204
+ case "actual_provenance":
205
+ exact(row, label, [
206
+ "assertion_key",
207
+ "capability",
208
+ "source_kind",
209
+ "source_ref",
210
+ "actual_sha256",
211
+ ]);
212
+ return {
213
+ ...base,
214
+ capability,
215
+ source_kind: literal(row.source_kind, ["product_runtime", "observer_runtime", "durable_store"], `${label}.source_kind`),
216
+ source_ref: nonEmpty(row.source_ref, `${label}.source_ref`),
217
+ actual_sha256: sha(row.actual_sha256, `${label}.actual_sha256`),
218
+ };
219
+ case "distinct_identity":
220
+ return decodeDistinctIdentityEvidence(row, label, base);
221
+ case "data_state":
222
+ exact(row, label, [
223
+ "assertion_key",
224
+ "capability",
225
+ "state_ref",
226
+ "state_sha256",
227
+ "read_session_id",
228
+ ]);
229
+ return {
230
+ ...base,
231
+ capability,
232
+ state_ref: nonEmpty(row.state_ref, `${label}.state_ref`),
233
+ state_sha256: sha(row.state_sha256, `${label}.state_sha256`),
234
+ read_session_id: nonEmpty(row.read_session_id, `${label}.read_session_id`),
235
+ };
236
+ case "population_coverage":
237
+ return decodePopulationCoverageEvidence(row, label, base);
238
+ case "recovery":
239
+ exact(row, label, [
240
+ "assertion_key",
241
+ "capability",
242
+ "failure_session_id",
243
+ "recovery_session_id",
244
+ "recovered_state_sha256",
245
+ ]);
246
+ return {
247
+ ...base,
248
+ capability,
249
+ failure_session_id: nonEmpty(row.failure_session_id, `${label}.failure_session_id`),
250
+ recovery_session_id: nonEmpty(row.recovery_session_id, `${label}.recovery_session_id`),
251
+ recovered_state_sha256: sha(row.recovered_state_sha256, `${label}.recovered_state_sha256`),
252
+ };
253
+ default:
254
+ return null;
255
+ }
256
+ }
257
+ function decodeDistinctIdentityEvidence(row, label, base) {
258
+ exact(row, label, ["assertion_key", "capability", "identities"]);
259
+ const identities = array(row.identities, `${label}.identities`).map((item, identityIndex) => {
260
+ const identityLabel = `${label}.identities[${identityIndex}]`;
261
+ const identity = record(item, identityLabel);
262
+ exact(identity, identityLabel, ["identity_ref", "data_state_sha256"]);
263
+ return {
264
+ identity_ref: nonEmpty(identity.identity_ref, `${identityLabel}.identity_ref`),
265
+ data_state_sha256: sha(identity.data_state_sha256, `${identityLabel}.data_state_sha256`),
266
+ };
267
+ });
268
+ return { ...base, capability: "distinct_identity", identities };
269
+ }
270
+ function decodePopulationCoverageEvidence(row, label, base) {
271
+ exact(row, label, [
272
+ "assertion_key",
273
+ "capability",
274
+ "universe_sha256",
275
+ "observed_sha256",
276
+ "excluded_sha256",
277
+ "set_equality",
278
+ ]);
279
+ if (row.set_equality !== true)
280
+ throw invalidRecord(`${label}.set_equality`);
281
+ return {
282
+ ...base,
283
+ capability: "population_coverage",
284
+ universe_sha256: sha(row.universe_sha256, `${label}.universe_sha256`),
285
+ observed_sha256: sha(row.observed_sha256, `${label}.observed_sha256`),
286
+ excluded_sha256: sha(row.excluded_sha256, `${label}.excluded_sha256`),
287
+ set_equality: true,
288
+ };
289
+ }
199
290
  function decodeGroundDesignMethodEvidence(row, label, base) {
200
291
  exact(row, label, [
201
292
  "assertion_key",
@@ -10,28 +10,28 @@ export function validateRuntimeEvidenceRecord(check, record, artifactHashes, adm
10
10
  case "interaction_trace":
11
11
  return validateInteractionTrace(check, record, hostAttestation);
12
12
  case "state_delta":
13
- if (record.before_sha256 === record.after_sha256)
14
- return "state_unchanged";
15
- if (!record.changed_fields.length)
16
- return "changed_fields_empty";
17
- return null;
13
+ return validateStateDelta(record);
18
14
  case "cross_surface_consistency":
19
15
  return validateCrossSurfaceConsistency(check, record);
20
16
  case "durable_readback":
21
- if (record.write_session_id === record.read_session_id)
22
- return "independent_session_required";
23
- if (record.written_sha256 !== record.read_sha256)
24
- return "readback_mismatch";
25
- return null;
17
+ return validateDurableReadback(record);
26
18
  case "boundary_invocation":
27
19
  case "external_side_effect":
28
20
  return validateObserverEvidence(check, record.observer_target_ref);
21
+ case "actual_provenance":
22
+ return validateActualProvenance(check, record);
23
+ case "distinct_identity":
24
+ return validateDistinctIdentity(record);
25
+ case "data_state":
26
+ return validateDataState(record);
27
+ case "population_coverage":
28
+ return validatePopulationCoverage(record);
29
29
  case "failure_injection":
30
- return record.failure_observed ? null : "failure_not_observed";
30
+ return validateFailureInjection(record);
31
+ case "recovery":
32
+ return validateRecovery(record);
31
33
  case "visual_render":
32
- return artifactHashes[record.artifact_path] === record.artifact_sha256
33
- ? null
34
- : "artifact_hash_mismatch";
34
+ return validateVisualRender(record, artifactHashes);
35
35
  case "design_conformance":
36
36
  return validateDesignConformance(check, record, artifactHashes);
37
37
  case "design_method":
@@ -46,6 +46,54 @@ export function validateRuntimeEvidenceRecord(check, record, artifactHashes, adm
46
46
  return validateInputVariation(record);
47
47
  }
48
48
  }
49
+ function validateStateDelta(record) {
50
+ if (record.before_sha256 === record.after_sha256)
51
+ return "state_unchanged";
52
+ return record.changed_fields.length ? null : "changed_fields_empty";
53
+ }
54
+ function validateDurableReadback(record) {
55
+ if (record.write_session_id === record.read_session_id)
56
+ return "independent_session_required";
57
+ return record.written_sha256 === record.read_sha256
58
+ ? null
59
+ : "readback_mismatch";
60
+ }
61
+ function validateActualProvenance(check, record) {
62
+ return record.source_kind === "observer_runtime" &&
63
+ check.execution_target_definition.role !== "observer"
64
+ ? "observer_provenance_target_required"
65
+ : null;
66
+ }
67
+ function validateDistinctIdentity(record) {
68
+ if (record.identities.length < 2)
69
+ return "two_identities_required";
70
+ if (new Set(record.identities.map((item) => item.identity_ref)).size !==
71
+ record.identities.length)
72
+ return "identity_duplicate";
73
+ return new Set(record.identities.map((item) => item.data_state_sha256)).size <
74
+ 2
75
+ ? "independent_data_states_required"
76
+ : null;
77
+ }
78
+ function validateDataState(record) {
79
+ return record.read_session_id.trim() ? null : "read_session_required";
80
+ }
81
+ function validatePopulationCoverage(record) {
82
+ return record.set_equality ? null : "set_equality_required";
83
+ }
84
+ function validateFailureInjection(record) {
85
+ return record.failure_observed ? null : "failure_not_observed";
86
+ }
87
+ function validateRecovery(record) {
88
+ return record.failure_session_id === record.recovery_session_id
89
+ ? "independent_recovery_session_required"
90
+ : null;
91
+ }
92
+ function validateVisualRender(record, artifactHashes) {
93
+ return artifactHashes[record.artifact_path] === record.artifact_sha256
94
+ ? null
95
+ : "artifact_hash_mismatch";
96
+ }
49
97
  function validateAdmittedObservationRecord(check, record, admitted) {
50
98
  if (record.capability === "semantic_fact" &&
51
99
  record.observer_results.length > 0)
@@ -2,6 +2,8 @@ import type { EvidenceCapabilityV2 } from "./long-task-semantic-contract-types.j
2
2
  import type { DesignResourceVerificationMethod } from "./design-resource-handoff-types.js";
3
3
  import type { DesignResourceComparator, DesignResourceLocatedDigestV1 } from "./design-resource-fact-manifest-types.js";
4
4
  import type { SemanticFactEnvironmentV1, SemanticFactLocatedValueV1, SemanticFactOracleV1 } from "./semantic-fact-types.js";
5
+ import type { ActualProvenanceEvidenceV2, DataStateEvidenceV2, DistinctIdentityEvidenceV2, PopulationCoverageEvidenceV2, RecoveryEvidenceV2 } from "./long-task-complete-delivery-evidence-types.js";
6
+ export type { ActualProvenanceEvidenceV2, DataStateEvidenceV2, DistinctIdentityEvidenceV2, PopulationCoverageEvidenceV2, RecoveryEvidenceV2, } from "./long-task-complete-delivery-evidence-types.js";
5
7
  interface EvidenceRecordBaseV2 {
6
8
  assertion_key: string;
7
9
  capability: EvidenceCapabilityV2;
@@ -272,5 +274,4 @@ export interface InputVariationEvidenceV2 extends EvidenceRecordBaseV2 {
272
274
  }>;
273
275
  failure_case_observed: boolean;
274
276
  }
275
- export type EvidenceCapabilityRecordV2 = InteractionTraceEvidenceV2 | StateDeltaEvidenceV2 | CrossSurfaceConsistencyEvidenceV2 | DurableReadbackEvidenceV2 | BoundaryInvocationEvidenceV2 | ExternalSideEffectEvidenceV2 | FailureInjectionEvidenceV2 | VisualRenderEvidenceV2 | DesignConformanceEvidenceV2 | DesignMethodEvidenceV2 | DesignSymbolicCertificateEvidenceV2 | SemanticFactEvidenceV2 | TargetRuntimeEvidenceV2 | InputVariationEvidenceV2;
276
- export {};
277
+ export type EvidenceCapabilityRecordV2 = InteractionTraceEvidenceV2 | StateDeltaEvidenceV2 | CrossSurfaceConsistencyEvidenceV2 | DurableReadbackEvidenceV2 | BoundaryInvocationEvidenceV2 | ActualProvenanceEvidenceV2 | ExternalSideEffectEvidenceV2 | DistinctIdentityEvidenceV2 | DataStateEvidenceV2 | PopulationCoverageEvidenceV2 | FailureInjectionEvidenceV2 | RecoveryEvidenceV2 | VisualRenderEvidenceV2 | DesignConformanceEvidenceV2 | DesignMethodEvidenceV2 | DesignSymbolicCertificateEvidenceV2 | SemanticFactEvidenceV2 | TargetRuntimeEvidenceV2 | InputVariationEvidenceV2;
@@ -1,5 +1,10 @@
1
- import type { CheckExecutionResultV2, CompiledCheckV2, CompiledDeliveryContractV2, CompiledOutcomeV2, LongTaskFindingV2, RawCommandExecutionV2, WorkspaceManifestV2 } from "./long-task-delivery-types.js";
1
+ import type { CheckExecutionResultV2, CompiledCheckV2, CompiledDeliveryContractV2, CompiledOutcomeV2, CounterfactualControlV2, GlobalCounterfactualControlV2, LongTaskFindingV2, RawCommandExecutionV2, WorkspaceManifestV2 } from "./long-task-delivery-types.js";
2
2
  export declare function evaluateCheckEvidence(check: CompiledCheckV2, raw: RawCommandExecutionV2, snapshotRoot: string, outcome?: CompiledOutcomeV2, observationAuthorityPaths?: readonly string[]): Promise<CheckExecutionResultV2>;
3
3
  export declare function evaluateOutcomeCounterfactuals(outcome: CompiledOutcomeV2, snapshotRoot: string, manifest?: WorkspaceManifestV2, protectedAuthorityPaths?: readonly string[], baselineResults?: readonly CheckExecutionResultV2[], baselineExecutions?: ReadonlyMap<string, RawCommandExecutionV2>, executionUniverse?: readonly CompiledCheckV2[]): Promise<LongTaskFindingV2[]>;
4
4
  export declare function evaluateGlobalCounterfactuals(compiled: CompiledDeliveryContractV2, snapshotRoot: string, selectedCheckKeys?: ReadonlySet<string>, manifest?: WorkspaceManifestV2, baselineResults?: readonly CheckExecutionResultV2[], baselineExecutions?: ReadonlyMap<string, RawCommandExecutionV2>, executionUniverse?: readonly CompiledCheckV2[]): Promise<LongTaskFindingV2[]>;
5
+ export declare function counterfactualExecutionMayOverlap(input: {
6
+ check: CompiledCheckV2;
7
+ control: CounterfactualControlV2 | GlobalCounterfactualControlV2;
8
+ protected_authority_paths?: readonly string[];
9
+ }): boolean;
5
10
  export declare function isValidCounterfactualCheckResult(result: CheckExecutionResultV2, expectedAssertionFailures: string[], allowedFanoutAssertions?: string[]): boolean;