project-tiny-context-harness 0.8.11 → 0.8.13

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 (395) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +514 -472
  3. package/assets/README.md +803 -749
  4. package/assets/README.zh-CN.md +468 -431
  5. package/assets/agents/.gitkeep +1 -1
  6. package/assets/agents/AGENTS_CORE.md +22 -24
  7. package/assets/agents/long-task-implementation.toml +15 -0
  8. package/assets/context_templates/architecture.md +18 -18
  9. package/assets/context_templates/area.md +30 -30
  10. package/assets/context_templates/context.toml +24 -24
  11. package/assets/context_templates/deployment.md +35 -35
  12. package/assets/context_templates/global.md +56 -56
  13. package/assets/context_templates/product-surface-contract.md +70 -70
  14. package/assets/context_templates/screen-contract.md +189 -189
  15. package/assets/context_templates/verification.md +25 -25
  16. package/assets/github/.gitkeep +1 -1
  17. package/assets/github/harness.yml +39 -39
  18. package/assets/make/.gitkeep +1 -1
  19. package/assets/make/ty-context.mk +48 -48
  20. package/assets/skills/context_development_engineer/SKILL.md +72 -185
  21. package/assets/skills/context_full_project_export/SKILL.md +28 -28
  22. package/assets/skills/context_harness_upgrade/SKILL.md +60 -60
  23. package/assets/skills/context_product_plan/SKILL.md +35 -101
  24. package/assets/skills/context_surface_contract/SKILL.md +194 -191
  25. package/assets/skills/context_uiux_design/SKILL.md +49 -172
  26. package/assets/skills/design-resource-authoring/SKILL.md +54 -88
  27. package/assets/skills/design-resource-authoring/references/downstream-handoff.md +51 -163
  28. package/assets/skills/design-resource-authoring/references/formal-selected-web-app-handoff.md +96 -0
  29. package/assets/skills/design-resource-authoring/references/open-design-provider.md +140 -120
  30. package/assets/skills/design-resource-authoring/references/recovery-and-writeback.md +199 -0
  31. package/assets/skills/design-resource-authoring/references/resource-selection.md +158 -181
  32. package/assets/skills/design-system-authoring/SKILL.md +57 -57
  33. package/assets/skills/design-system-authoring/agents/openai.yaml +6 -6
  34. package/assets/skills/design-system-authoring/references/authority-adoption.md +48 -48
  35. package/assets/skills/design-system-authoring/references/open-design-design-system-provider.md +110 -110
  36. package/assets/skills/long-task-workflow/SKILL.md +71 -106
  37. package/assets/skills/long-task-workflow/agents/openai.yaml +1 -1
  38. package/assets/skills/long-task-workflow/references/authority-lifecycle.md +71 -69
  39. package/assets/skills/long-task-workflow/references/contract-authoring.md +110 -101
  40. package/assets/skills/long-task-workflow/references/evidence-design.md +99 -78
  41. package/assets/skills/long-task-workflow/references/source-authoring.md +90 -90
  42. package/assets/tools/validate_context.py +442 -442
  43. package/dist/commands/design-resource-recovery.d.ts +1 -0
  44. package/dist/commands/design-resource-recovery.js +152 -0
  45. package/dist/commands/design-resource.js +29 -3
  46. package/dist/commands/enable.js +2 -0
  47. package/dist/commands/index.js +2 -2
  48. package/dist/commands/long-task-revision.js +8 -7
  49. package/dist/commands/sync.js +2 -0
  50. package/dist/index.d.ts +3 -3
  51. package/dist/index.js +2 -0
  52. package/dist/lib/compact-authoring-support.d.ts +22 -0
  53. package/dist/lib/compact-authoring-support.js +143 -0
  54. package/dist/lib/compact-shared-structure-authoring.d.ts +5 -0
  55. package/dist/lib/compact-shared-structure-authoring.js +9 -0
  56. package/dist/lib/compact-shared-structure-types.d.ts +61 -0
  57. package/dist/lib/compact-shared-structure-types.js +1 -0
  58. package/dist/lib/compact-shared-structure-validation.d.ts +2 -0
  59. package/dist/lib/compact-shared-structure-validation.js +159 -0
  60. package/dist/lib/compact-shared-structures.d.ts +3 -0
  61. package/dist/lib/compact-shared-structures.js +204 -0
  62. package/dist/lib/design-resource-fact-enums.d.ts +4 -0
  63. package/dist/lib/design-resource-fact-enums.js +12 -0
  64. package/dist/lib/design-resource-fact-manifest-shape-evidence.js +2 -2
  65. package/dist/lib/design-resource-fact-policy.d.ts +2 -2
  66. package/dist/lib/design-resource-fact-types.d.ts +2 -2
  67. package/dist/lib/design-resource-handoff-bundle-draft.js +4 -2
  68. package/dist/lib/design-resource-handoff-input-types.d.ts +3 -0
  69. package/dist/lib/design-resource-handoff-parser.d.ts +2 -2
  70. package/dist/lib/design-resource-handoff-parser.js +2 -2
  71. package/dist/lib/design-resource-handoff-shape.d.ts +2 -0
  72. package/dist/lib/design-resource-handoff-shape.js +10 -0
  73. package/dist/lib/design-resource-handoff-snapshot.js +4 -0
  74. package/dist/lib/design-resource-handoff-validation.d.ts +4 -1
  75. package/dist/lib/design-resource-handoff-validation.js +11 -0
  76. package/dist/lib/design-resource-handoff-web-dependency-validation.d.ts +4 -2
  77. package/dist/lib/design-resource-reconciliation-codec.d.ts +2 -0
  78. package/dist/lib/design-resource-reconciliation-codec.js +174 -0
  79. package/dist/lib/design-resource-reconciliation-types.d.ts +62 -0
  80. package/dist/lib/design-resource-reconciliation-types.js +1 -0
  81. package/dist/lib/design-resource-reconciliation.d.ts +3 -0
  82. package/dist/lib/design-resource-reconciliation.js +224 -0
  83. package/dist/lib/design-resource-recovery-authority-policy.d.ts +8 -0
  84. package/dist/lib/design-resource-recovery-authority-policy.js +123 -0
  85. package/dist/lib/design-resource-recovery-catalog-resources.d.ts +6 -0
  86. package/dist/lib/design-resource-recovery-catalog-resources.js +121 -0
  87. package/dist/lib/design-resource-recovery-catalog-shape.d.ts +3 -0
  88. package/dist/lib/design-resource-recovery-catalog-shape.js +104 -0
  89. package/dist/lib/design-resource-recovery-catalog.d.ts +9 -0
  90. package/dist/lib/design-resource-recovery-catalog.js +103 -0
  91. package/dist/lib/design-resource-recovery-cleanup.d.ts +2 -0
  92. package/dist/lib/design-resource-recovery-cleanup.js +11 -0
  93. package/dist/lib/design-resource-recovery-codec-primitives.d.ts +19 -0
  94. package/dist/lib/design-resource-recovery-codec-primitives.js +92 -0
  95. package/dist/lib/design-resource-recovery-codec.d.ts +4 -0
  96. package/dist/lib/design-resource-recovery-codec.js +93 -0
  97. package/dist/lib/design-resource-recovery-current.d.ts +9 -0
  98. package/dist/lib/design-resource-recovery-current.js +41 -0
  99. package/dist/lib/design-resource-recovery-delta-policy.d.ts +5 -0
  100. package/dist/lib/design-resource-recovery-delta-policy.js +108 -0
  101. package/dist/lib/design-resource-recovery-files.d.ts +37 -0
  102. package/dist/lib/design-resource-recovery-files.js +204 -0
  103. package/dist/lib/design-resource-recovery-final-disposition-shape.d.ts +2 -0
  104. package/dist/lib/design-resource-recovery-final-disposition-shape.js +47 -0
  105. package/dist/lib/design-resource-recovery-patch-types.d.ts +54 -0
  106. package/dist/lib/design-resource-recovery-patch-types.js +1 -0
  107. package/dist/lib/design-resource-recovery-replay.d.ts +7 -0
  108. package/dist/lib/design-resource-recovery-replay.js +112 -0
  109. package/dist/lib/design-resource-recovery-repository-bindings.d.ts +9 -0
  110. package/dist/lib/design-resource-recovery-repository-bindings.js +49 -0
  111. package/dist/lib/design-resource-recovery-schema.d.ts +5 -0
  112. package/dist/lib/design-resource-recovery-schema.js +5 -0
  113. package/dist/lib/design-resource-recovery-shape.d.ts +10 -0
  114. package/dist/lib/design-resource-recovery-shape.js +184 -0
  115. package/dist/lib/design-resource-recovery-source-authority.d.ts +5 -0
  116. package/dist/lib/design-resource-recovery-source-authority.js +219 -0
  117. package/dist/lib/design-resource-recovery-text.d.ts +17 -0
  118. package/dist/lib/design-resource-recovery-text.js +186 -0
  119. package/dist/lib/design-resource-recovery-types.d.ts +197 -0
  120. package/dist/lib/design-resource-recovery-types.js +1 -0
  121. package/dist/lib/design-resource-recovery-writeback-policy.d.ts +5 -0
  122. package/dist/lib/design-resource-recovery-writeback-policy.js +326 -0
  123. package/dist/lib/design-resource-recovery-writeback-shape.d.ts +6 -0
  124. package/dist/lib/design-resource-recovery-writeback-shape.js +155 -0
  125. package/dist/lib/design-resource-recovery.d.ts +44 -0
  126. package/dist/lib/design-resource-recovery.js +216 -0
  127. package/dist/lib/design-resource-symbolic-applicability-authority.d.ts +7 -0
  128. package/dist/lib/design-resource-symbolic-applicability-authority.js +19 -0
  129. package/dist/lib/design-resource-symbolic-applicability-policy.d.ts +12 -0
  130. package/dist/lib/design-resource-symbolic-applicability-policy.js +79 -0
  131. package/dist/lib/design-resource-symbolic-applicability-profiles.d.ts +8 -0
  132. package/dist/lib/design-resource-symbolic-applicability-profiles.js +55 -0
  133. package/dist/lib/design-resource-symbolic-applicability-shape.d.ts +2 -0
  134. package/dist/lib/design-resource-symbolic-applicability-shape.js +76 -0
  135. package/dist/lib/design-resource-symbolic-applicability-validation.d.ts +7 -0
  136. package/dist/lib/design-resource-symbolic-applicability-validation.js +128 -0
  137. package/dist/lib/design-resource-symbolic-compilation.d.ts +3 -0
  138. package/dist/lib/design-resource-symbolic-compilation.js +13 -0
  139. package/dist/lib/design-resource-symbolic-denotation.d.ts +3 -0
  140. package/dist/lib/design-resource-symbolic-denotation.js +167 -0
  141. package/dist/lib/design-resource-symbolic-disposition-validation.d.ts +4 -0
  142. package/dist/lib/design-resource-symbolic-disposition-validation.js +28 -0
  143. package/dist/lib/design-resource-symbolic-fact-policy.d.ts +12 -0
  144. package/dist/lib/design-resource-symbolic-fact-policy.js +12 -0
  145. package/dist/lib/design-resource-symbolic-fact-shape.d.ts +3 -0
  146. package/dist/lib/design-resource-symbolic-fact-shape.js +138 -0
  147. package/dist/lib/design-resource-symbolic-fact-types.d.ts +213 -0
  148. package/dist/lib/design-resource-symbolic-fact-types.js +1 -0
  149. package/dist/lib/design-resource-symbolic-fact-validation.d.ts +3 -0
  150. package/dist/lib/design-resource-symbolic-fact-validation.js +86 -0
  151. package/dist/lib/design-resource-symbolic-indexes.d.ts +23 -0
  152. package/dist/lib/design-resource-symbolic-indexes.js +54 -0
  153. package/dist/lib/design-resource-symbolic-manifest-shape.d.ts +3 -0
  154. package/dist/lib/design-resource-symbolic-manifest-shape.js +155 -0
  155. package/dist/lib/design-resource-symbolic-manifest-validation.d.ts +6 -0
  156. package/dist/lib/design-resource-symbolic-manifest-validation.js +132 -0
  157. package/dist/lib/design-resource-symbolic-noninterference-artifact.d.ts +33 -0
  158. package/dist/lib/design-resource-symbolic-noninterference-artifact.js +110 -0
  159. package/dist/lib/design-resource-symbolic-noninterference-equivalence.d.ts +3 -0
  160. package/dist/lib/design-resource-symbolic-noninterference-equivalence.js +77 -0
  161. package/dist/lib/design-resource-symbolic-noninterference-recompute.d.ts +4 -0
  162. package/dist/lib/design-resource-symbolic-noninterference-recompute.js +146 -0
  163. package/dist/lib/design-resource-symbolic-noninterference-scope.d.ts +7 -0
  164. package/dist/lib/design-resource-symbolic-noninterference-scope.js +49 -0
  165. package/dist/lib/design-resource-symbolic-noninterference-shape.d.ts +2 -0
  166. package/dist/lib/design-resource-symbolic-noninterference-shape.js +152 -0
  167. package/dist/lib/design-resource-symbolic-noninterference-types.d.ts +103 -0
  168. package/dist/lib/design-resource-symbolic-noninterference-types.js +1 -0
  169. package/dist/lib/design-resource-symbolic-noninterference-validation.d.ts +5 -0
  170. package/dist/lib/design-resource-symbolic-noninterference-validation.js +62 -0
  171. package/dist/lib/design-resource-symbolic-oracle-fingerprint.d.ts +1 -0
  172. package/dist/lib/design-resource-symbolic-oracle-fingerprint.js +47 -0
  173. package/dist/lib/design-resource-symbolic-predicate-shape.d.ts +6 -0
  174. package/dist/lib/design-resource-symbolic-predicate-shape.js +123 -0
  175. package/dist/lib/design-resource-symbolic-production-closure.d.ts +4 -0
  176. package/dist/lib/design-resource-symbolic-production-closure.js +144 -0
  177. package/dist/lib/design-resource-symbolic-proof-authority-validation.d.ts +10 -0
  178. package/dist/lib/design-resource-symbolic-proof-authority-validation.js +68 -0
  179. package/dist/lib/design-resource-symbolic-proof-validation.d.ts +10 -0
  180. package/dist/lib/design-resource-symbolic-proof-validation.js +89 -0
  181. package/dist/lib/design-resource-symbolic-region-validation.d.ts +19 -0
  182. package/dist/lib/design-resource-symbolic-region-validation.js +146 -0
  183. package/dist/lib/design-resource-symbolic-resource-validation.d.ts +5 -0
  184. package/dist/lib/design-resource-symbolic-resource-validation.js +90 -0
  185. package/dist/lib/design-resource-symbolic-rule-shape.d.ts +27 -0
  186. package/dist/lib/design-resource-symbolic-rule-shape.js +158 -0
  187. package/dist/lib/design-resource-symbolic-safety-validation.d.ts +6 -0
  188. package/dist/lib/design-resource-symbolic-safety-validation.js +29 -0
  189. package/dist/lib/design-resource-symbolic-source-ir-evaluation.d.ts +19 -0
  190. package/dist/lib/design-resource-symbolic-source-ir-evaluation.js +74 -0
  191. package/dist/lib/design-resource-symbolic-source-ir-evidence.d.ts +44 -0
  192. package/dist/lib/design-resource-symbolic-source-ir-evidence.js +88 -0
  193. package/dist/lib/design-resource-symbolic-source-ir-oracle.d.ts +13 -0
  194. package/dist/lib/design-resource-symbolic-source-ir-oracle.js +96 -0
  195. package/dist/lib/design-resource-symbolic-source-ir-proof.d.ts +14 -0
  196. package/dist/lib/design-resource-symbolic-source-ir-proof.js +98 -0
  197. package/dist/lib/design-resource-symbolic-source-ir-shape.d.ts +2 -0
  198. package/dist/lib/design-resource-symbolic-source-ir-shape.js +38 -0
  199. package/dist/lib/design-resource-symbolic-source-ir-types.d.ts +17 -0
  200. package/dist/lib/design-resource-symbolic-source-ir-types.js +2 -0
  201. package/dist/lib/design-resource-symbolic-static-dependency-validation.d.ts +2 -0
  202. package/dist/lib/design-resource-symbolic-static-dependency-validation.js +83 -0
  203. package/dist/lib/design-resource-symbolic-structural-closure-validation.d.ts +6 -0
  204. package/dist/lib/design-resource-symbolic-structural-closure-validation.js +79 -0
  205. package/dist/lib/design-resource-symbolic-validation-support.d.ts +29 -0
  206. package/dist/lib/design-resource-symbolic-validation-support.js +111 -0
  207. package/dist/lib/design-resource-v1-capacity-header.d.ts +8 -0
  208. package/dist/lib/design-resource-v1-capacity-header.js +231 -0
  209. package/dist/lib/design-resource-v1-capacity.d.ts +5 -0
  210. package/dist/lib/design-resource-v1-capacity.js +45 -0
  211. package/dist/lib/init.js +1 -0
  212. package/dist/lib/long-task-acceptance-shape.js +8 -2
  213. package/dist/lib/long-task-activation-validation.js +13 -3
  214. package/dist/lib/long-task-admitted-observation-records.d.ts +25 -0
  215. package/dist/lib/long-task-admitted-observation-records.js +40 -0
  216. package/dist/lib/long-task-admitted-observation.d.ts +93 -0
  217. package/dist/lib/long-task-admitted-observation.js +201 -0
  218. package/dist/lib/long-task-artifacts.d.ts +1 -0
  219. package/dist/lib/long-task-artifacts.js +1 -0
  220. package/dist/lib/long-task-authority-material-diff.js +1 -0
  221. package/dist/lib/long-task-authority-policy.d.ts +5 -0
  222. package/dist/lib/long-task-authority-policy.js +5 -0
  223. package/dist/lib/long-task-authority-revision-details.js +3 -1
  224. package/dist/lib/long-task-authority.js +2 -1
  225. package/dist/lib/long-task-check-execution-policy.js +5 -0
  226. package/dist/lib/long-task-check-runner.d.ts +2 -2
  227. package/dist/lib/long-task-check-runner.js +440 -23
  228. package/dist/lib/long-task-claims.d.ts +18 -0
  229. package/dist/lib/long-task-claims.js +35 -0
  230. package/dist/lib/long-task-codex-agent-profile.d.ts +42 -0
  231. package/dist/lib/long-task-codex-agent-profile.js +276 -0
  232. package/dist/lib/long-task-compact-authoring-projections.d.ts +12 -0
  233. package/dist/lib/long-task-compact-authoring-projections.js +67 -0
  234. package/dist/lib/long-task-compact-authoring.d.ts +3 -0
  235. package/dist/lib/long-task-compact-authoring.js +173 -0
  236. package/dist/lib/long-task-compact-carrier.d.ts +7 -0
  237. package/dist/lib/long-task-compact-carrier.js +132 -0
  238. package/dist/lib/long-task-compact-parser.d.ts +14 -0
  239. package/dist/lib/long-task-compact-parser.js +123 -0
  240. package/dist/lib/long-task-compact-primitives.d.ts +22 -0
  241. package/dist/lib/long-task-compact-primitives.js +132 -0
  242. package/dist/lib/long-task-compact-projections.d.ts +4 -0
  243. package/dist/lib/long-task-compact-projections.js +153 -0
  244. package/dist/lib/long-task-compact-structure-targets.d.ts +2 -0
  245. package/dist/lib/long-task-compact-structure-targets.js +91 -0
  246. package/dist/lib/long-task-conformance-policy.js +3 -1
  247. package/dist/lib/long-task-counterfactual-claim-policy.d.ts +3 -4
  248. package/dist/lib/long-task-counterfactual-claim-policy.js +11 -3
  249. package/dist/lib/long-task-counterfactual-sandbox.d.ts +1 -1
  250. package/dist/lib/long-task-counterfactual-sandbox.js +8 -5
  251. package/dist/lib/long-task-counterfactual-types.d.ts +2 -0
  252. package/dist/lib/long-task-delivery-compiler.js +2 -0
  253. package/dist/lib/long-task-delivery-parser.d.ts +1 -0
  254. package/dist/lib/long-task-delivery-parser.js +38 -6
  255. package/dist/lib/long-task-design-resource-handoff.d.ts +2 -1
  256. package/dist/lib/long-task-design-resource-handoff.js +71 -11
  257. package/dist/lib/long-task-design-resource-method-binding.d.ts +8 -1
  258. package/dist/lib/long-task-design-resource-method-binding.js +150 -0
  259. package/dist/lib/long-task-evidence-capability-codec.js +256 -34
  260. package/dist/lib/long-task-evidence-capability-policy.d.ts +3 -2
  261. package/dist/lib/long-task-evidence-capability-policy.js +142 -8
  262. package/dist/lib/long-task-evidence-capability-runtime.d.ts +5 -2
  263. package/dist/lib/long-task-evidence-capability-runtime.js +420 -68
  264. package/dist/lib/long-task-evidence-capability-types.d.ts +70 -2
  265. package/dist/lib/long-task-evidence-sensitivity-policy.d.ts +9 -0
  266. package/dist/lib/long-task-evidence-sensitivity-policy.js +31 -1
  267. package/dist/lib/long-task-evidence-v2.d.ts +4 -4
  268. package/dist/lib/long-task-evidence-v2.js +322 -44
  269. package/dist/lib/long-task-exact-comparison.d.ts +16 -0
  270. package/dist/lib/long-task-exact-comparison.js +28 -0
  271. package/dist/lib/long-task-execution-observation.d.ts +24 -0
  272. package/dist/lib/long-task-execution-observation.js +332 -0
  273. package/dist/lib/long-task-explain-acceptance-link.d.ts +4 -0
  274. package/dist/lib/long-task-explain-acceptance-link.js +4 -0
  275. package/dist/lib/long-task-explain-claim-links.d.ts +2 -0
  276. package/dist/lib/long-task-explain-claim-links.js +2 -0
  277. package/dist/lib/long-task-explain-source-links.d.ts +6 -0
  278. package/dist/lib/long-task-final-v2.js +7 -4
  279. package/dist/lib/long-task-hook-install.d.ts +19 -2
  280. package/dist/lib/long-task-hook-install.js +288 -91
  281. package/dist/lib/long-task-json-pointer-observation.d.ts +59 -0
  282. package/dist/lib/long-task-json-pointer-observation.js +184 -0
  283. package/dist/lib/long-task-observation-artifact.d.ts +8 -0
  284. package/dist/lib/long-task-observation-artifact.js +58 -0
  285. package/dist/lib/long-task-observation-authority.d.ts +17 -0
  286. package/dist/lib/long-task-observation-authority.js +348 -0
  287. package/dist/lib/long-task-paths.js +1 -1
  288. package/dist/lib/long-task-playwright-capability-records.d.ts +2 -0
  289. package/dist/lib/long-task-playwright-capability-records.js +74 -2
  290. package/dist/lib/long-task-process-observation.d.ts +6 -0
  291. package/dist/lib/long-task-process-observation.js +117 -0
  292. package/dist/lib/long-task-process-runtime-closure.d.ts +13 -0
  293. package/dist/lib/long-task-process-runtime-closure.js +175 -0
  294. package/dist/lib/long-task-progress.js +2 -0
  295. package/dist/lib/long-task-protected-files.d.ts +1 -1
  296. package/dist/lib/long-task-protected-files.js +1 -30
  297. package/dist/lib/long-task-risk.js +8 -3
  298. package/dist/lib/long-task-root-shape.js +10 -1
  299. package/dist/lib/long-task-runner-environment.d.ts +1 -1
  300. package/dist/lib/long-task-runner-environment.js +4 -4
  301. package/dist/lib/long-task-runner-freeze.d.ts +4 -2
  302. package/dist/lib/long-task-runner-freeze.js +130 -28
  303. package/dist/lib/long-task-runtime-types.d.ts +111 -0
  304. package/dist/lib/long-task-scoped-binding.d.ts +13 -0
  305. package/dist/lib/long-task-scoped-binding.js +11 -0
  306. package/dist/lib/long-task-semantic-contract-types.d.ts +2 -1
  307. package/dist/lib/long-task-semantic-fact-binding-types.d.ts +8 -0
  308. package/dist/lib/long-task-semantic-fact-closure.js +4 -1
  309. package/dist/lib/long-task-semantic-fact-contract-closure.d.ts +1 -1
  310. package/dist/lib/long-task-semantic-fact-contract-closure.js +18 -6
  311. package/dist/lib/long-task-semantic-fact-contract-facts.d.ts +1 -1
  312. package/dist/lib/long-task-semantic-fact-contract-facts.js +4 -1
  313. package/dist/lib/long-task-semantic-fact-contract-proofs.d.ts +1 -1
  314. package/dist/lib/long-task-semantic-fact-contract-proofs.js +12 -3
  315. package/dist/lib/long-task-semantic-fact-evidence.d.ts +8 -4
  316. package/dist/lib/long-task-semantic-fact-evidence.js +103 -43
  317. package/dist/lib/long-task-semantic-fact-shape.js +17 -6
  318. package/dist/lib/long-task-shape-primitives.d.ts +1 -1
  319. package/dist/lib/long-task-shape-primitives.js +1 -0
  320. package/dist/lib/long-task-source-claim-validation.js +4 -1
  321. package/dist/lib/long-task-source-item-parser.d.ts +2 -2
  322. package/dist/lib/long-task-source-item-parser.js +20 -11
  323. package/dist/lib/long-task-source-target-continuity.d.ts +2 -2
  324. package/dist/lib/long-task-source-target-continuity.js +35 -2
  325. package/dist/lib/long-task-source-target-index.d.ts +3 -0
  326. package/dist/lib/long-task-source-target-index.js +19 -0
  327. package/dist/lib/long-task-stage-policy.js +10 -4
  328. package/dist/lib/long-task-static-observation-freeze.d.ts +83 -0
  329. package/dist/lib/long-task-static-observation-freeze.js +428 -0
  330. package/dist/lib/long-task-status-projection.js +5 -1
  331. package/dist/lib/long-task-target-policy.d.ts +1 -1
  332. package/dist/lib/long-task-target-policy.js +3 -0
  333. package/dist/lib/long-task-ui-design-policy.js +64 -4
  334. package/dist/lib/long-task-ui-surface-shape.js +195 -0
  335. package/dist/lib/long-task-ui-surface-types.d.ts +53 -0
  336. package/dist/lib/long-task-verifier-dependency-closure.js +7 -3
  337. package/dist/lib/long-task-verifier-v2.js +70 -9
  338. package/dist/lib/long-task-worker-selection.d.ts +2 -0
  339. package/dist/lib/long-task-worker-selection.js +7 -0
  340. package/dist/lib/long-task-workspace-scope.js +3 -1
  341. package/dist/lib/long-task-workspace.d.ts +1 -1
  342. package/dist/lib/long-task-workspace.js +12 -13
  343. package/dist/lib/migrations.js +58 -0
  344. package/dist/lib/profiles.js +0 -1
  345. package/dist/lib/repository-path-safety.d.ts +14 -0
  346. package/dist/lib/repository-path-safety.js +126 -0
  347. package/dist/lib/semantic-fact-compact-authoring.d.ts +2 -0
  348. package/dist/lib/semantic-fact-compact-authoring.js +160 -0
  349. package/dist/lib/semantic-fact-compact-capacity.d.ts +9 -0
  350. package/dist/lib/semantic-fact-compact-capacity.js +40 -0
  351. package/dist/lib/semantic-fact-compact-carrier.d.ts +16 -0
  352. package/dist/lib/semantic-fact-compact-carrier.js +146 -0
  353. package/dist/lib/semantic-fact-compact-parser.d.ts +17 -0
  354. package/dist/lib/semantic-fact-compact-parser.js +168 -0
  355. package/dist/lib/semantic-fact-compact-revision.d.ts +11 -0
  356. package/dist/lib/semantic-fact-compact-revision.js +64 -0
  357. package/dist/lib/semantic-fact-compact-support.d.ts +23 -0
  358. package/dist/lib/semantic-fact-compact-support.js +159 -0
  359. package/dist/lib/semantic-fact-policy-census.d.ts +1 -0
  360. package/dist/lib/semantic-fact-policy-census.js +43 -0
  361. package/dist/lib/semantic-fact-proof-shape.d.ts +1 -1
  362. package/dist/lib/semantic-fact-property-shape.d.ts +1 -1
  363. package/dist/lib/semantic-fact-source-parser.d.ts +5 -0
  364. package/dist/lib/semantic-fact-source-parser.js +47 -6
  365. package/dist/lib/structural-closure-cost.d.ts +79 -0
  366. package/dist/lib/structural-closure-cost.js +91 -0
  367. package/dist/lib/symbolic-denotation-dag-builder.d.ts +25 -0
  368. package/dist/lib/symbolic-denotation-dag-builder.js +176 -0
  369. package/dist/lib/symbolic-denotation-domain-validation.d.ts +3 -0
  370. package/dist/lib/symbolic-denotation-domain-validation.js +56 -0
  371. package/dist/lib/symbolic-denotation-engine.d.ts +32 -0
  372. package/dist/lib/symbolic-denotation-engine.js +140 -0
  373. package/dist/lib/symbolic-denotation-public.d.ts +11 -0
  374. package/dist/lib/symbolic-denotation-public.js +12 -0
  375. package/dist/lib/symbolic-denotation-runtime.d.ts +20 -0
  376. package/dist/lib/symbolic-denotation-runtime.js +90 -0
  377. package/dist/lib/symbolic-denotation-support.d.ts +11 -0
  378. package/dist/lib/symbolic-denotation-support.js +49 -0
  379. package/dist/lib/symbolic-denotation-types.d.ts +133 -0
  380. package/dist/lib/symbolic-denotation-types.js +18 -0
  381. package/dist/lib/symbolic-denotation-validation.d.ts +6 -0
  382. package/dist/lib/symbolic-denotation-validation.js +126 -0
  383. package/dist/lib/sync-engine.d.ts +1 -0
  384. package/dist/lib/sync-engine.js +4 -1
  385. package/dist/lib/upgrade.js +1 -0
  386. package/dist/long-task-hook.js +40 -1
  387. package/dist/public-types.d.ts +8 -0
  388. package/dist/public-types.js +1 -0
  389. package/dist/schemas/design-resource-symbolic-noninterference-artifact-v2.schema.json +289 -0
  390. package/dist/schemas/design-resource-symbolic-source-ir-v1.schema.json +130 -0
  391. package/dist/schemas/long-task-delivery-v2/long-task-delivery-v2.schema.json +435 -5
  392. package/migrations/README.md +92 -15
  393. package/package.json +2 -2
  394. package/source-mappings.yaml +28 -25
  395. package/assets/skills/source-plan-authoring/SKILL.md +0 -14
@@ -0,0 +1,132 @@
1
+ import { validateDesignResourceLocatedDigest } from "./design-resource-fact-locator-validation.js";
2
+ import { buildSymbolicApplicabilityIndex } from "./design-resource-symbolic-applicability-validation.js";
3
+ import { createDesignResourceSymbolicCompilationSession } from "./design-resource-symbolic-compilation.js";
4
+ import { validateSymbolicDispositions } from "./design-resource-symbolic-disposition-validation.js";
5
+ import { validateSymbolicCertificates, validateSymbolicObligations, } from "./design-resource-symbolic-proof-validation.js";
6
+ import { aggregateSymbolicCanonicalMetrics, validateSymbolicApplicabilityClosure, validateSymbolicPopulationAndQuantifier, validateSymbolicRegionWithinReachable, } from "./design-resource-symbolic-region-validation.js";
7
+ import { validateSymbolicInspectorAndResources, validateSymbolicPropertyCatalog, } from "./design-resource-symbolic-resource-validation.js";
8
+ import { validateSymbolicExactTargetCoverage, validateSymbolicReadinessClosure, } from "./design-resource-symbolic-safety-validation.js";
9
+ import { validateSymbolicCensusClosure, validateSymbolicSubjectPopulationClosure, } from "./design-resource-symbolic-structural-closure-validation.js";
10
+ import { buildSymbolicManifestIndexes, } from "./design-resource-symbolic-indexes.js";
11
+ import { designResourceSymbolicRuleKey, invalid, omitRuleIdentityFields, requireKnownRefs, stableJson, unique, } from "./design-resource-symbolic-validation-support.js";
12
+ export function validateDesignResourceSymbolicManifest(manifest, parsed, resources, contents) {
13
+ validateManifestIdentities(manifest);
14
+ validateSymbolicReadinessClosure(manifest);
15
+ const target = parsed.handoff.targets[0];
16
+ if (!manifest.subjects.length || !manifest.properties.length)
17
+ invalid("v2_subject_property_universe_required", target.key);
18
+ const compilation = createDesignResourceSymbolicCompilationSession(manifest);
19
+ const reachable = compilation.compile(manifest.reachable_region);
20
+ if (reachable.canonical_dag.root_ref === "terminal.false")
21
+ invalid("v2_reachable_region_empty", target.key);
22
+ validateSymbolicInspectorAndResources(manifest, target, resources, contents);
23
+ validateSymbolicPropertyCatalog(manifest.properties);
24
+ const indexes = buildSymbolicManifestIndexes(manifest, parsed);
25
+ validateSymbolicSubjectPopulationClosure(manifest, target, indexes, resources, contents, compilation);
26
+ const applicability = buildSymbolicApplicabilityIndex(manifest, indexes);
27
+ const ruleProjections = validateRules(manifest, target, indexes, resources, contents, compilation);
28
+ validateSymbolicCensusClosure(manifest, indexes);
29
+ validateSymbolicDispositions(manifest, target.key, indexes, compilation);
30
+ const certificateMetrics = validateSymbolicCertificates(manifest, ruleProjections, indexes, compilation, target, resources, contents);
31
+ validateSymbolicApplicabilityClosure(manifest, reachable, indexes, applicability, compilation);
32
+ validateSymbolicObligations(manifest, ruleProjections, indexes.properties, indexes.oracles, indexes.environments, target, resources, contents);
33
+ validateSymbolicExactTargetCoverage(target.interpretation, manifest, ruleProjections, reachable, compilation);
34
+ const dagMetrics = aggregateSymbolicCanonicalMetrics(ruleProjections);
35
+ return {
36
+ ruleProjections,
37
+ metrics: {
38
+ semantic_obligations: manifest.semantic_proof_obligations.length,
39
+ certificate_obligations: manifest.noninterference_certificates.length,
40
+ certificate_covered_omitted_axes: certificateMetrics.coveredOmittedAxes,
41
+ certificate_covered_dependency_edges: certificateMetrics.coveredDependencyEdges,
42
+ canonical_dag_nodes: dagMetrics.nodes,
43
+ canonical_partition_edges: dagMetrics.edges,
44
+ canonical_bytes: dagMetrics.bytes,
45
+ theoretical_ground_cardinality: reachable.theoretical_ground_cardinality,
46
+ },
47
+ };
48
+ }
49
+ function validateManifestIdentities(manifest) {
50
+ for (const [label, keys] of [
51
+ ["inspector_census", manifest.inspector.census.map((item) => item.key)],
52
+ ["axis_domain", manifest.axis_domains.map((item) => item.key)],
53
+ ["subject", manifest.subjects.map((item) => item.key)],
54
+ ["population", manifest.populations.map((item) => item.key)],
55
+ ["property", manifest.properties.map((item) => item.key)],
56
+ ["fact_rule", manifest.fact_rules.map((item) => item.key)],
57
+ [
58
+ "disposition_region",
59
+ manifest.disposition_regions.map((item) => item.key),
60
+ ],
61
+ [
62
+ "semantic_obligation",
63
+ manifest.semantic_proof_obligations.map((item) => item.key),
64
+ ],
65
+ ["dependency_edge", manifest.dependency_edges.map((item) => item.key)],
66
+ [
67
+ "certificate",
68
+ manifest.noninterference_certificates.map((item) => item.key),
69
+ ],
70
+ ["oracle", manifest.oracles.map((item) => item.key)],
71
+ ["environment", manifest.environments.map((item) => item.key)],
72
+ [
73
+ "acceptance_blocker",
74
+ manifest.acceptance_blockers.map((item) => item.key),
75
+ ],
76
+ ])
77
+ unique(keys, `v2_${label}_key_duplicate`);
78
+ }
79
+ function validateRules(manifest, target, indexes, resources, contents, compilation) {
80
+ const reachableRegionDigests = new Set();
81
+ return manifest.fact_rules.map((rule) => {
82
+ const compiled = compilation.compile(rule.region);
83
+ if (!reachableRegionDigests.has(compiled.canonical_sha256)) {
84
+ validateSymbolicRegionWithinReachable(rule.region, manifest.reachable_region, rule.key, compilation);
85
+ reachableRegionDigests.add(compiled.canonical_sha256);
86
+ }
87
+ const subject = indexes.subjects.get(rule.subject_or_relation_ref);
88
+ const property = indexes.properties.get(rule.property_ref);
89
+ if (!subject)
90
+ invalid("v2_rule_subject_unknown", rule.key);
91
+ if (!property)
92
+ invalid("v2_rule_property_unknown", rule.key);
93
+ if (rule.target_ref !== target.key)
94
+ invalid("v2_rule_target_mismatch", rule.key);
95
+ validateRuleAuthority(rule, subject.population_ref, property, indexes);
96
+ validateRuleValues(rule, compiled.canonical_sha256, new Set(target.resource_refs), resources, contents);
97
+ return { rule, compiled_region: compiled };
98
+ });
99
+ }
100
+ function validateRuleAuthority(rule, subjectPopulationRef, property, indexes) {
101
+ unique(rule.census_refs, `v2_rule_census_ref_duplicate:${rule.key}`);
102
+ unique(rule.source_item_refs, `v2_rule_source_item_ref_duplicate:${rule.key}`);
103
+ unique(rule.semantic_obligation_refs, `v2_rule_obligation_ref_duplicate:${rule.key}`);
104
+ validateSymbolicPopulationAndQuantifier(rule, subjectPopulationRef, indexes.populations);
105
+ requireKnownRefs(rule.census_refs, indexes.census, "v2_rule_census_unknown");
106
+ requireKnownRefs(rule.source_item_refs, indexes.sourceItems, "v2_rule_source_item_unknown");
107
+ requireKnownRefs(property.census_refs, indexes.census, "v2_property_census_unknown");
108
+ if (!property.census_refs.length)
109
+ invalid("v2_rule_property_census_required", rule.key);
110
+ const subject = indexes.subjects.get(rule.subject_or_relation_ref);
111
+ for (const ref of [...subject.census_refs, ...property.census_refs])
112
+ if (!rule.census_refs.includes(ref))
113
+ invalid("v2_rule_required_census_ref_missing", `${rule.key}:${ref}`);
114
+ for (const capability of property.inspector_capability_refs)
115
+ if (!indexes.inspectorCapabilities.has(capability))
116
+ invalid("v2_rule_inspector_capability_missing", `${rule.key}:${capability}`);
117
+ if (rule.value_kind !== property.value_kind)
118
+ invalid("v2_rule_value_kind_mismatch", rule.key);
119
+ }
120
+ function validateRuleValues(rule, regionSha256, targetResources, resources, contents) {
121
+ validateDesignResourceLocatedDigest(rule.expected, resources, contents, `rule.${rule.key}.expected`);
122
+ validateDesignResourceLocatedDigest(rule.lineage.resolved_value, resources, contents, `rule.${rule.key}.lineage.resolved_value`);
123
+ for (const located of [rule.expected, rule.lineage.resolved_value])
124
+ if (targetResources.size &&
125
+ !targetResources.has(located.locator.resource_ref))
126
+ invalid("v2_rule_resource_outside_target", `${rule.key}:${located.locator.resource_ref}`);
127
+ if (stableJson(rule.expected) !== stableJson(rule.lineage.resolved_value))
128
+ invalid("v2_rule_expected_lineage_mismatch", rule.key);
129
+ const expectedKey = designResourceSymbolicRuleKey(omitRuleIdentityFields(rule), regionSha256);
130
+ if (rule.key !== expectedKey)
131
+ invalid("v2_rule_identity_mismatch", `${rule.key}:${expectedKey}`);
132
+ }
@@ -0,0 +1,33 @@
1
+ import { Buffer } from "node:buffer";
2
+ import type { DesignResource } from "./design-resource-handoff-file-primitives.js";
3
+ import type { DesignResourceObservableRuleManifestV2, DesignResourceSymbolicHandoffTargetV2, DesignResourceSymbolicNoninterferenceArtifactV2, DesignResourceSymbolicNoninterferenceCertificateV2, DesignResourceSymbolicNoninterferenceFailureWitnessV1, DesignResourceSymbolicNoninterferenceProofV2 } from "./design-resource-symbolic-fact-types.js";
4
+ export declare const SYMBOLIC_NONINTERFERENCE_ORACLE_IDENTITY: "ty-context-symbolic-noninterference-oracle";
5
+ export declare const SYMBOLIC_NONINTERFERENCE_ORACLE_VERSION: "2.1.0";
6
+ export declare const SYMBOLIC_NONINTERFERENCE_ORACLE_IMPLEMENTATION_SHA256: string;
7
+ export interface SymbolicNoninterferenceArtifactBindingV1 {
8
+ static_dependency_nodes: DesignResourceSymbolicNoninterferenceProofV2["static_dependency_nodes"];
9
+ static_rule_roots: DesignResourceSymbolicNoninterferenceProofV2["static_rule_roots"];
10
+ equivalence_cases: DesignResourceSymbolicNoninterferenceProofV2["equivalence_cases"];
11
+ complete_domain_cardinality: string | null;
12
+ oracle_version: string;
13
+ oracle_implementation_sha256: string;
14
+ oracle_capability: string;
15
+ environment_sha256: string;
16
+ input_snapshot_sha256: string;
17
+ source_manifest_snapshot_sha256: string | null;
18
+ target_snapshot_sha256: string;
19
+ certificate_scope_sha256: string;
20
+ rule_scope_sha256: string;
21
+ omitted_axis_refs: string[];
22
+ method_result_sha256: string;
23
+ artifact_resource_ref: string;
24
+ artifact_path: string;
25
+ artifact_sha256: string;
26
+ failure_witness: DesignResourceSymbolicNoninterferenceFailureWitnessV1 | null;
27
+ }
28
+ export declare function createSymbolicNoninterferenceArtifactBinding(manifest: DesignResourceObservableRuleManifestV2, certificate: DesignResourceSymbolicNoninterferenceCertificateV2, proof: DesignResourceSymbolicNoninterferenceProofV2, target: DesignResourceSymbolicHandoffTargetV2, resources: ReadonlyMap<string, DesignResource>, contents: ReadonlyMap<string, Buffer>, artifactResourceRef: string, artifactPath: string): {
29
+ artifact: DesignResourceSymbolicNoninterferenceArtifactV2;
30
+ text: string;
31
+ binding: SymbolicNoninterferenceArtifactBindingV1;
32
+ };
33
+ export declare function validateSymbolicNoninterferenceArtifact(manifest: DesignResourceObservableRuleManifestV2, certificate: DesignResourceSymbolicNoninterferenceCertificateV2, proof: DesignResourceSymbolicNoninterferenceProofV2, target: DesignResourceSymbolicHandoffTargetV2, resources: ReadonlyMap<string, DesignResource>, contents: ReadonlyMap<string, Buffer>): void;
@@ -0,0 +1,110 @@
1
+ import { invalid, stableJson, } from "./design-resource-symbolic-validation-support.js";
2
+ import { recomputeSymbolicNoninterferenceArtifact } from "./design-resource-symbolic-noninterference-recompute.js";
3
+ import { fingerprintExecutableModuleClosure } from "./design-resource-symbolic-oracle-fingerprint.js";
4
+ import { canonicalJson, sha256Hex } from "./strict-codec.js";
5
+ export const SYMBOLIC_NONINTERFERENCE_ORACLE_IDENTITY = "ty-context-symbolic-noninterference-oracle";
6
+ export const SYMBOLIC_NONINTERFERENCE_ORACLE_VERSION = "2.1.0";
7
+ export const SYMBOLIC_NONINTERFERENCE_ORACLE_IMPLEMENTATION_SHA256 = fingerprintExecutableModuleClosure([
8
+ import.meta.url,
9
+ new URL("./design-resource-symbolic-noninterference-validation.js", import.meta.url).href,
10
+ new URL("./design-resource-symbolic-static-dependency-validation.js", import.meta.url).href,
11
+ new URL("./symbolic-denotation-engine.js", import.meta.url).href,
12
+ ]);
13
+ export function createSymbolicNoninterferenceArtifactBinding(manifest, certificate, proof, target, resources, contents, artifactResourceRef, artifactPath) {
14
+ const artifact = recomputeSymbolicNoninterferenceArtifact(manifest, certificate, proof, target, resources, contents);
15
+ const text = canonicalJson(artifact);
16
+ return {
17
+ artifact,
18
+ text,
19
+ binding: {
20
+ static_dependency_nodes: structuredClone(artifact.derived_result.static_dependency_nodes),
21
+ static_rule_roots: structuredClone(artifact.derived_result.static_rule_roots),
22
+ equivalence_cases: structuredClone(artifact.derived_result.equivalence_cases),
23
+ complete_domain_cardinality: artifact.derived_result.complete_domain_cardinality,
24
+ oracle_version: artifact.oracle_version,
25
+ oracle_implementation_sha256: artifact.oracle_implementation_sha256,
26
+ oracle_capability: artifact.oracle_capability,
27
+ environment_sha256: artifact.environment_sha256,
28
+ input_snapshot_sha256: artifact.input_snapshot_sha256,
29
+ source_manifest_snapshot_sha256: artifact.source_manifest_snapshot_sha256,
30
+ target_snapshot_sha256: artifact.target_snapshot_sha256,
31
+ certificate_scope_sha256: artifact.certificate_scope_sha256,
32
+ rule_scope_sha256: artifact.rule_scope_sha256,
33
+ omitted_axis_refs: [...artifact.omitted_axis_refs],
34
+ method_result_sha256: artifact.method_result_sha256,
35
+ artifact_resource_ref: artifactResourceRef,
36
+ artifact_path: artifactPath,
37
+ artifact_sha256: sha256Hex(text),
38
+ failure_witness: artifact.failure_witness
39
+ ? structuredClone(artifact.failure_witness)
40
+ : null,
41
+ },
42
+ };
43
+ }
44
+ export function validateSymbolicNoninterferenceArtifact(manifest, certificate, proof, target, resources, contents) {
45
+ const oracle = manifest.oracles.find((item) => item.key === proof.oracle_ref);
46
+ if (oracle?.identity !== SYMBOLIC_NONINTERFERENCE_ORACLE_IDENTITY ||
47
+ oracle.version !== SYMBOLIC_NONINTERFERENCE_ORACLE_VERSION ||
48
+ oracle.sha256 !== SYMBOLIC_NONINTERFERENCE_ORACLE_IMPLEMENTATION_SHA256)
49
+ invalid("v2_noninterference_package_oracle_identity_mismatch", proof.oracle_ref);
50
+ const expected = recomputeSymbolicNoninterferenceArtifact(manifest, certificate, proof, target, resources, contents);
51
+ const resource = resources.get(proof.artifact_resource_ref);
52
+ const bytes = contents.get(proof.artifact_resource_ref);
53
+ if (!resource ||
54
+ !bytes ||
55
+ resource.role !== "supporting" ||
56
+ resource.path !== proof.artifact_path ||
57
+ resource.sha256 !== proof.artifact_sha256 ||
58
+ sha256Hex(bytes) !== proof.artifact_sha256 ||
59
+ !target.resource_refs.includes(proof.artifact_resource_ref))
60
+ invalid("v2_noninterference_artifact_resource_mismatch", `${certificate.key}:${proof.side}:${proof.artifact_resource_ref}`);
61
+ const expectedText = canonicalJson(expected);
62
+ if (bytes.toString("utf8") !== expectedText)
63
+ invalid("v2_noninterference_artifact_current_input_mismatch", `${certificate.key}:${proof.side}`);
64
+ const binding = {
65
+ oracle_version: proof.oracle_version,
66
+ oracle_implementation_sha256: proof.oracle_implementation_sha256,
67
+ oracle_capability: proof.oracle_capability,
68
+ environment_sha256: proof.environment_sha256,
69
+ input_snapshot_sha256: proof.input_snapshot_sha256,
70
+ source_manifest_snapshot_sha256: proof.source_manifest_snapshot_sha256,
71
+ target_snapshot_sha256: proof.target_snapshot_sha256,
72
+ certificate_scope_sha256: proof.certificate_scope_sha256,
73
+ rule_scope_sha256: proof.rule_scope_sha256,
74
+ omitted_axis_refs: proof.omitted_axis_refs,
75
+ method_result_sha256: proof.method_result_sha256,
76
+ failure_witness: proof.failure_witness,
77
+ };
78
+ const expectedBinding = {
79
+ oracle_version: expected.oracle_version,
80
+ oracle_implementation_sha256: expected.oracle_implementation_sha256,
81
+ oracle_capability: expected.oracle_capability,
82
+ environment_sha256: expected.environment_sha256,
83
+ input_snapshot_sha256: expected.input_snapshot_sha256,
84
+ source_manifest_snapshot_sha256: expected.source_manifest_snapshot_sha256,
85
+ target_snapshot_sha256: expected.target_snapshot_sha256,
86
+ certificate_scope_sha256: expected.certificate_scope_sha256,
87
+ rule_scope_sha256: expected.rule_scope_sha256,
88
+ omitted_axis_refs: expected.omitted_axis_refs,
89
+ method_result_sha256: expected.method_result_sha256,
90
+ failure_witness: expected.failure_witness,
91
+ };
92
+ if (stableJson(binding) !== stableJson(expectedBinding))
93
+ invalid("v2_noninterference_artifact_binding_mismatch", `${certificate.key}:${proof.side}`);
94
+ if (proof.side === "source" &&
95
+ stableJson({
96
+ static_dependency_nodes: proof.static_dependency_nodes,
97
+ static_rule_roots: proof.static_rule_roots,
98
+ equivalence_cases: proof.equivalence_cases,
99
+ complete_domain_cardinality: proof.complete_domain_cardinality,
100
+ }) !==
101
+ stableJson({
102
+ static_dependency_nodes: expected.derived_result.static_dependency_nodes,
103
+ static_rule_roots: expected.derived_result.static_rule_roots,
104
+ equivalence_cases: expected.derived_result.equivalence_cases,
105
+ complete_domain_cardinality: expected.derived_result.complete_domain_cardinality,
106
+ }))
107
+ invalid("v2_source_noninterference_proof_cache_mismatch", `${certificate.key}:${proof.method}`);
108
+ if (expected.verdict !== "passed" || expected.failure_witness)
109
+ invalid("v2_noninterference_current_input_counterexample", stableJson(expected.failure_witness));
110
+ }
@@ -0,0 +1,3 @@
1
+ import type { DesignResourceSymbolicCompilationSession } from "./design-resource-symbolic-compilation.js";
2
+ import type { DesignResourceHandoffPreflightV2, DesignResourceObservableRuleManifestV2, DesignResourceSymbolicNoninterferenceCertificateV2, DesignResourceSymbolicNoninterferenceProofV2 } from "./design-resource-symbolic-fact-types.js";
3
+ export declare function validateSymbolicNoninterferenceEquivalence(proof: DesignResourceSymbolicNoninterferenceProofV2, manifest: DesignResourceObservableRuleManifestV2, certificate: DesignResourceSymbolicNoninterferenceCertificateV2, projections: DesignResourceHandoffPreflightV2["rule_projections"], compilation: DesignResourceSymbolicCompilationSession): void;
@@ -0,0 +1,77 @@
1
+ import { assertSameSet, invalid, unique, } from "./design-resource-symbolic-validation-support.js";
2
+ import { evaluateCanonicalSymbolicDenotation } from "./symbolic-denotation-engine.js";
3
+ const MAX_EXHAUSTIVE_DOMAIN_CARDINALITY = 100000n;
4
+ export function validateSymbolicNoninterferenceEquivalence(proof, manifest, certificate, projections, compilation) {
5
+ if (proof.static_dependency_nodes.length || proof.static_rule_roots.length)
6
+ invalid("v2_equivalence_static_graph_forbidden", certificate.key);
7
+ const caseRuleRefs = proof.equivalence_cases.flatMap((item) => item.fact_rule_refs);
8
+ unique(caseRuleRefs, `v2_equivalence_rule_ref_duplicate:${certificate.key}`);
9
+ assertSameSet(caseRuleRefs, certificate.fact_rule_refs, "v2_equivalence_rule_set_mismatch", certificate.key);
10
+ const projectionByRule = new Map(projections.map((projection) => [projection.rule.key, projection]));
11
+ const exhaustive = proof.method === "finite_complete_domain_exhaustive_equivalence";
12
+ const cardinality = BigInt(projections[0].compiled_region.theoretical_ground_cardinality);
13
+ validateDomainCardinality(proof, certificate.key, exhaustive, cardinality);
14
+ for (const proofCase of proof.equivalence_cases) {
15
+ if (!proofCase.fact_rule_refs.length)
16
+ invalid("v2_equivalence_case_rules_required", certificate.key);
17
+ const side = compilation.compile(proofCase.side_predicate);
18
+ const candidate = compilation.compile(proofCase.axis_erased_predicate);
19
+ for (const axisRef of certificate.omitted_axis_refs)
20
+ if (!candidate.omitted_axis_refs.includes(axisRef))
21
+ invalid("v2_equivalence_candidate_axis_not_erased", `${certificate.key}:${axisRef}`);
22
+ for (const ruleRef of proofCase.fact_rule_refs) {
23
+ const projection = projectionByRule.get(ruleRef);
24
+ if (!projection)
25
+ invalid("v2_equivalence_rule_unknown", `${certificate.key}:${ruleRef}`);
26
+ if (exhaustive)
27
+ assertExhaustivelyEquivalentChain(manifest.axis_domains, projection.compiled_region, side, candidate, `${certificate.key}:${ruleRef}`);
28
+ else
29
+ assertSymbolicallyEquivalent(projection.compiled_region, side, candidate, certificate.key, ruleRef);
30
+ }
31
+ }
32
+ }
33
+ function validateDomainCardinality(proof, certificateKey, exhaustive, cardinality) {
34
+ if (exhaustive) {
35
+ if (proof.complete_domain_cardinality !== cardinality.toString())
36
+ invalid("v2_exhaustive_domain_cardinality_mismatch", certificateKey);
37
+ if (cardinality > MAX_EXHAUSTIVE_DOMAIN_CARDINALITY)
38
+ invalid("v2_exhaustive_domain_capacity_exceeded", `${certificateKey}:${cardinality}`);
39
+ }
40
+ else if (proof.complete_domain_cardinality !== null)
41
+ invalid("v2_symbolic_equivalence_cardinality_forbidden", certificateKey);
42
+ }
43
+ function assertSymbolicallyEquivalent(rule, side, candidate, certificateKey, ruleRef) {
44
+ if (rule.canonical_sha256 !== side.canonical_sha256)
45
+ invalid("v2_side_predicate_rule_mismatch", `${certificateKey}:${ruleRef}`);
46
+ if (side.canonical_sha256 !== candidate.canonical_sha256)
47
+ invalid("v2_symbolic_equivalence_mismatch", `${certificateKey}:${ruleRef}`);
48
+ }
49
+ function assertExhaustivelyEquivalentChain(domains, rule, side, erased, label) {
50
+ forEachAssignment(domains, 0, {}, (assignment) => {
51
+ if (evaluateCanonicalSymbolicDenotation(rule.canonical_dag, assignment) !==
52
+ evaluateCanonicalSymbolicDenotation(side.canonical_dag, assignment) ||
53
+ evaluateCanonicalSymbolicDenotation(side.canonical_dag, assignment) !==
54
+ evaluateCanonicalSymbolicDenotation(erased.canonical_dag, assignment))
55
+ invalid("v2_exhaustive_equivalence_mismatch", label);
56
+ });
57
+ }
58
+ function forEachAssignment(domains, index, assignment, visit) {
59
+ if (index === domains.length) {
60
+ visit(assignment);
61
+ return;
62
+ }
63
+ const domain = domains[index];
64
+ if (domain.kind === "enum") {
65
+ for (const value of domain.values) {
66
+ assignment[domain.key] = value;
67
+ forEachAssignment(domains, index + 1, assignment, visit);
68
+ }
69
+ }
70
+ else {
71
+ for (let value = domain.minimum; value <= domain.maximum; value += 1) {
72
+ assignment[domain.key] = value;
73
+ forEachAssignment(domains, index + 1, assignment, visit);
74
+ }
75
+ }
76
+ delete assignment[domain.key];
77
+ }
@@ -0,0 +1,4 @@
1
+ import { Buffer } from "node:buffer";
2
+ import type { DesignResource } from "./design-resource-handoff-file-primitives.js";
3
+ import type { DesignResourceObservableRuleManifestV2, DesignResourceSymbolicHandoffTargetV2, DesignResourceSymbolicNoninterferenceArtifactV2, DesignResourceSymbolicNoninterferenceCertificateV2, DesignResourceSymbolicNoninterferenceProofV2 } from "./design-resource-symbolic-fact-types.js";
4
+ export declare function recomputeSymbolicNoninterferenceArtifact(manifest: DesignResourceObservableRuleManifestV2, certificate: DesignResourceSymbolicNoninterferenceCertificateV2, proof: DesignResourceSymbolicNoninterferenceProofV2, target: DesignResourceSymbolicHandoffTargetV2, resources: ReadonlyMap<string, DesignResource>, contents: ReadonlyMap<string, Buffer>): DesignResourceSymbolicNoninterferenceArtifactV2;
@@ -0,0 +1,146 @@
1
+ import { compareText, invalid, sha256, stableJson, } from "./design-resource-symbolic-validation-support.js";
2
+ import { sha256Hex } from "./strict-codec.js";
3
+ import { productionClosureFailure } from "./design-resource-symbolic-production-closure.js";
4
+ import { symbolicNoninterferenceCertificateScopeSha256, symbolicNoninterferenceArtifactResourceRefs, symbolicNoninterferenceProductionTargetSnapshot, symbolicNoninterferenceRuleScopeSha256, symbolicNoninterferenceSourceManifestSnapshot, } from "./design-resource-symbolic-noninterference-scope.js";
5
+ import { deriveCurrentSourceNoninterferenceEvidence } from "./design-resource-symbolic-source-ir-oracle.js";
6
+ export function recomputeSymbolicNoninterferenceArtifact(manifest, certificate, proof, target, resources, contents) {
7
+ const oracle = manifest.oracles.find((item) => item.key === proof.oracle_ref);
8
+ const environment = manifest.environments.find((item) => item.key === proof.environment_ref);
9
+ if (!oracle)
10
+ invalid("v2_noninterference_oracle_unknown", proof.oracle_ref);
11
+ if (!environment)
12
+ invalid("v2_noninterference_environment_unknown", proof.environment_ref);
13
+ const inputs = inputSnapshot(manifest, resources, contents);
14
+ const certificateScopeSha256 = symbolicNoninterferenceCertificateScopeSha256(certificate);
15
+ const ruleScopeSha256 = symbolicNoninterferenceRuleScopeSha256(manifest, certificate);
16
+ const oracleCapability = `symbolic_noninterference.${proof.side}.${proof.method}`;
17
+ const current = proof.side === "source"
18
+ ? deriveCurrentSourceNoninterferenceEvidence({
19
+ manifest,
20
+ certificate,
21
+ method: proof.method,
22
+ target,
23
+ resources,
24
+ contents,
25
+ })
26
+ : {
27
+ derived_result: productionDerivedResult(proof),
28
+ failure_witness: currentProductionDependencyFailure(manifest, certificate, proof, target, resources, contents),
29
+ };
30
+ const sourceManifestSnapshotSha256 = proof.side === "source"
31
+ ? sha256(stableJson(symbolicNoninterferenceSourceManifestSnapshot(manifest)))
32
+ : null;
33
+ const methodMaterial = {
34
+ method: proof.method,
35
+ oracle_capability: oracleCapability,
36
+ derived_result: current.derived_result,
37
+ current_dependency_result: current.failure_witness,
38
+ };
39
+ return {
40
+ schema_version: "design-resource-symbolic-noninterference-artifact-v2",
41
+ side: proof.side,
42
+ method: proof.method,
43
+ oracle_identity: oracle.identity,
44
+ oracle_version: oracle.version,
45
+ oracle_implementation_sha256: oracle.sha256 ?? "0".repeat(64),
46
+ oracle_capability: oracleCapability,
47
+ environment_sha256: sha256(stableJson(environment)),
48
+ input_resources: inputs.map((input) => ({
49
+ resource_ref: input.resource_ref,
50
+ path: input.path,
51
+ declared_sha256: input.declared_sha256,
52
+ current_sha256: input.current_sha256,
53
+ })),
54
+ input_snapshot_sha256: sha256(stableJson(inputs)),
55
+ source_manifest_snapshot_sha256: sourceManifestSnapshotSha256,
56
+ target_snapshot_sha256: proof.side === "source"
57
+ ? sourceSnapshot(sourceManifestSnapshotSha256, certificateScopeSha256, ruleScopeSha256, inputs)
58
+ : productionSnapshot(manifest, target, inputs),
59
+ certificate_scope_sha256: certificateScopeSha256,
60
+ rule_scope_sha256: ruleScopeSha256,
61
+ omitted_axis_refs: [...certificate.omitted_axis_refs].sort(compareText),
62
+ derived_result: current.derived_result,
63
+ method_result_sha256: sha256(stableJson(methodMaterial)),
64
+ verdict: current.failure_witness ? "failed" : "passed",
65
+ failure_witness: current.failure_witness,
66
+ };
67
+ }
68
+ function inputSnapshot(manifest, resources, contents) {
69
+ const artifactRefs = symbolicNoninterferenceArtifactResourceRefs(manifest);
70
+ return manifest.inspector.input_resources
71
+ .map((input) => {
72
+ if (artifactRefs.has(input.resource_ref))
73
+ invalid("v2_noninterference_artifact_self_reference", input.resource_ref);
74
+ const resource = resources.get(input.resource_ref);
75
+ const bytes = contents.get(input.resource_ref);
76
+ if (!resource ||
77
+ !bytes ||
78
+ resource.path !== input.path ||
79
+ resource.sha256 !== input.sha256)
80
+ invalid("v2_noninterference_input_resource_missing", input.resource_ref);
81
+ return {
82
+ resource_ref: input.resource_ref,
83
+ path: input.path,
84
+ declared_sha256: input.sha256,
85
+ current_sha256: sha256Hex(bytes),
86
+ };
87
+ })
88
+ .sort((left, right) => compareText(left.resource_ref, right.resource_ref));
89
+ }
90
+ function sourceSnapshot(sourceManifestSnapshotSha256, certificateScopeSha256, ruleScopeSha256, inputs) {
91
+ return sha256(stableJson({
92
+ source_manifest_snapshot_sha256: sourceManifestSnapshotSha256,
93
+ certificate_scope_sha256: certificateScopeSha256,
94
+ rule_scope_sha256: ruleScopeSha256,
95
+ inputs,
96
+ }));
97
+ }
98
+ function productionSnapshot(manifest, target, inputs) {
99
+ return sha256(stableJson({
100
+ target: symbolicNoninterferenceProductionTargetSnapshot(manifest, target),
101
+ inputs,
102
+ }));
103
+ }
104
+ function currentProductionDependencyFailure(manifest, certificate, proof, target, resources, contents) {
105
+ if (proof.dynamic_dependency_kinds.length ||
106
+ proof.external_device_refs.length)
107
+ return unsupportedWitness(certificate, `declared:${[
108
+ ...proof.dynamic_dependency_kinds,
109
+ ...proof.external_device_refs,
110
+ ].join(",")}`);
111
+ const inputRefs = manifest.inspector.input_resources.map((input) => input.resource_ref);
112
+ return productionClosureFailure({
113
+ ...target,
114
+ resource_refs: inputRefs,
115
+ source_profile: {
116
+ ...target.source_profile,
117
+ dependency_resource_refs: inputRefs.filter((ref) => ref !== target.source_profile.entry_resource_ref),
118
+ },
119
+ }, certificate, resources, contents);
120
+ }
121
+ function unsupportedWitness(certificate, detail) {
122
+ return {
123
+ kind: "unsupported_dependency",
124
+ side: "production",
125
+ certificate_scope_sha256: symbolicNoninterferenceCertificateScopeSha256(certificate),
126
+ axis_ref: null,
127
+ fact_rule_ref: null,
128
+ resource_ref: null,
129
+ path: null,
130
+ locator: null,
131
+ node_ref: null,
132
+ byte_offset: null,
133
+ assignment: null,
134
+ detail,
135
+ };
136
+ }
137
+ function productionDerivedResult(proof) {
138
+ return {
139
+ source_ir_resource_ref: null,
140
+ static_dependency_nodes: structuredClone(proof.static_dependency_nodes),
141
+ static_rule_roots: structuredClone(proof.static_rule_roots),
142
+ equivalence_cases: structuredClone(proof.equivalence_cases),
143
+ complete_domain_cardinality: proof.complete_domain_cardinality,
144
+ exhaustive_evaluation_sha256: null,
145
+ };
146
+ }
@@ -0,0 +1,7 @@
1
+ import type { DesignResourceObservableRuleManifestV2, DesignResourceSymbolicHandoffTargetV2, DesignResourceSymbolicNoninterferenceCertificateV2 } from "./design-resource-symbolic-fact-types.js";
2
+ export declare function symbolicNoninterferenceCertificateScope(certificate: DesignResourceSymbolicNoninterferenceCertificateV2): Record<string, unknown>;
3
+ export declare function symbolicNoninterferenceCertificateScopeSha256(certificate: DesignResourceSymbolicNoninterferenceCertificateV2): string;
4
+ export declare function symbolicNoninterferenceRuleScopeSha256(manifest: DesignResourceObservableRuleManifestV2, certificate: DesignResourceSymbolicNoninterferenceCertificateV2): string;
5
+ export declare function symbolicNoninterferenceSourceManifestSnapshot(manifest: DesignResourceObservableRuleManifestV2): Record<string, unknown>;
6
+ export declare function symbolicNoninterferenceArtifactResourceRefs(manifest: DesignResourceObservableRuleManifestV2): Set<string>;
7
+ export declare function symbolicNoninterferenceProductionTargetSnapshot(manifest: DesignResourceObservableRuleManifestV2, target: DesignResourceSymbolicHandoffTargetV2): Record<string, unknown>;
@@ -0,0 +1,49 @@
1
+ import { compareText, sha256, stableJson, } from "./design-resource-symbolic-validation-support.js";
2
+ export function symbolicNoninterferenceCertificateScope(certificate) {
3
+ const { key: _key, source_noninterference_proof: _sourceProof, production_noninterference_proof: _productionProof, ...scope } = certificate;
4
+ return {
5
+ ...scope,
6
+ fact_rule_refs: [...scope.fact_rule_refs].sort(compareText),
7
+ omitted_axis_refs: [...scope.omitted_axis_refs].sort(compareText),
8
+ dependency_edge_refs: [...scope.dependency_edge_refs].sort(compareText),
9
+ };
10
+ }
11
+ export function symbolicNoninterferenceCertificateScopeSha256(certificate) {
12
+ return sha256(stableJson(symbolicNoninterferenceCertificateScope(certificate)));
13
+ }
14
+ export function symbolicNoninterferenceRuleScopeSha256(manifest, certificate) {
15
+ const rules = new Map(manifest.fact_rules.map((rule) => [rule.key, rule]));
16
+ return sha256(stableJson([...certificate.fact_rule_refs].sort(compareText).map((ruleRef) => ({
17
+ rule_ref: ruleRef,
18
+ rule: rules.get(ruleRef) ?? null,
19
+ }))));
20
+ }
21
+ export function symbolicNoninterferenceSourceManifestSnapshot(manifest) {
22
+ return {
23
+ ...manifest,
24
+ noninterference_certificates: manifest.noninterference_certificates.map(symbolicNoninterferenceCertificateScope),
25
+ };
26
+ }
27
+ export function symbolicNoninterferenceArtifactResourceRefs(manifest) {
28
+ return new Set(manifest.noninterference_certificates.flatMap((certificate) => [
29
+ certificate.source_noninterference_proof,
30
+ certificate.production_noninterference_proof,
31
+ ]
32
+ .filter((proof) => proof != null)
33
+ .map((proof) => proof.artifact_resource_ref)));
34
+ }
35
+ export function symbolicNoninterferenceProductionTargetSnapshot(manifest, target) {
36
+ const artifacts = symbolicNoninterferenceArtifactResourceRefs(manifest);
37
+ const semanticInputs = new Set(manifest.inspector.input_resources.map((input) => input.resource_ref));
38
+ const keep = (ref) => semanticInputs.has(ref) && !artifacts.has(ref);
39
+ return {
40
+ ...target,
41
+ resource_refs: target.resource_refs.filter(keep).sort(compareText),
42
+ source_profile: {
43
+ ...target.source_profile,
44
+ dependency_resource_refs: target.source_profile.dependency_resource_refs
45
+ .filter(keep)
46
+ .sort(compareText),
47
+ },
48
+ };
49
+ }
@@ -0,0 +1,2 @@
1
+ import type { DesignResourceSymbolicNoninterferenceProofV2 } from "./design-resource-symbolic-fact-types.js";
2
+ export declare function parseSymbolicNoninterferenceProof(value: unknown, label: string): DesignResourceSymbolicNoninterferenceProofV2;