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,301 @@
1
+ using System;
2
+ using System.Collections.Generic;
3
+ using System.Diagnostics;
4
+ using System.IO;
5
+ using System.Runtime.InteropServices;
6
+ using System.Text;
7
+ using System.Threading;
8
+ using System.Threading.Tasks;
9
+ using Microsoft.Win32.SafeHandles;
10
+
11
+ public static partial class FormalProcessSupervisor
12
+ {
13
+ private static Task<long> CaptureAsync(IntPtr readHandle, string targetPath, CaptureState state)
14
+ {
15
+ return Task.Run(() => Capture(readHandle, targetPath, state));
16
+ }
17
+
18
+ private static long Capture(IntPtr readHandle, string targetPath, CaptureState state)
19
+ {
20
+ long retained = 0;
21
+ using (SafeFileHandle safe = new SafeFileHandle(readHandle, true))
22
+ using (FileStream input = new FileStream(safe, FileAccess.Read, 65536, false))
23
+ using (FileStream output = new FileStream(targetPath, FileMode.CreateNew, FileAccess.Write, FileShare.Read, 65536, false))
24
+ {
25
+ byte[] buffer = new byte[65536];
26
+ while (true)
27
+ {
28
+ int count = input.Read(buffer, 0, buffer.Length);
29
+ if (count == 0) break;
30
+ long before = Interlocked.Add(ref state.CombinedBytes, count) - count;
31
+ int allowed = before >= state.Limit ? 0 : (int)Math.Min(count, state.Limit - before);
32
+ if (allowed > 0)
33
+ {
34
+ output.Write(buffer, 0, allowed);
35
+ retained += allowed;
36
+ }
37
+ if (allowed != count && Interlocked.Exchange(ref state.Overflow, 1) == 0)
38
+ TerminateJobObject(state.Job, 0xE0000002);
39
+ }
40
+ output.Flush(true);
41
+ }
42
+ return retained;
43
+ }
44
+
45
+ private static JOBOBJECT_BASIC_ACCOUNTING_INFORMATION QueryAccounting(IntPtr job)
46
+ {
47
+ JOBOBJECT_BASIC_ACCOUNTING_INFORMATION information;
48
+ Check(QueryInformationJobObject(
49
+ job,
50
+ JobObjectBasicAccountingInformation,
51
+ out information,
52
+ (uint)Marshal.SizeOf<JOBOBJECT_BASIC_ACCOUNTING_INFORMATION>(),
53
+ IntPtr.Zero),
54
+ "query_job_accounting");
55
+ return information;
56
+ }
57
+
58
+ private static IntPtr BuildEnvironmentBlock(string[] entries)
59
+ {
60
+ SortedDictionary<string, string> values = new SortedDictionary<string, string>(StringComparer.OrdinalIgnoreCase);
61
+ foreach (string entry in entries)
62
+ {
63
+ if (entry == null) throw new ArgumentException("formal_process_supervisor_environment");
64
+ int separator = entry.IndexOf('=');
65
+ if (separator <= 0 || entry.IndexOf('\0') >= 0)
66
+ throw new ArgumentException("formal_process_supervisor_environment");
67
+ string key = entry.Substring(0, separator);
68
+ string value = entry.Substring(separator + 1);
69
+ if (key.IndexOf('=') >= 0 || key.IndexOf('\r') >= 0 || key.IndexOf('\n') >= 0 || value.IndexOf('\r') >= 0 || value.IndexOf('\n') >= 0)
70
+ throw new ArgumentException("formal_process_supervisor_environment");
71
+ values[key] = value;
72
+ }
73
+ StringBuilder block = new StringBuilder();
74
+ foreach (KeyValuePair<string, string> item in values)
75
+ block.Append(item.Key).Append('=').Append(item.Value).Append('\0');
76
+ block.Append('\0');
77
+ byte[] bytes = Encoding.Unicode.GetBytes(block.ToString());
78
+ IntPtr pointer = Marshal.AllocHGlobal(bytes.Length);
79
+ Marshal.Copy(bytes, 0, pointer, bytes.Length);
80
+ return pointer;
81
+ }
82
+
83
+ private static string BuildCommandLine(string executable, string[] argv)
84
+ {
85
+ StringBuilder result = new StringBuilder(QuoteWindowsArgument(executable));
86
+ foreach (string argument in argv)
87
+ {
88
+ if (argument == null)
89
+ throw new ArgumentException("formal_process_supervisor_argv");
90
+ result.Append(' ').Append(QuoteWindowsArgument(argument));
91
+ }
92
+ return result.ToString();
93
+ }
94
+
95
+ private static string QuoteWindowsArgument(string value)
96
+ {
97
+ if (value.Length > 0 && value.IndexOfAny(new[] { ' ', '\t', '\n', '\v', '"' }) < 0)
98
+ return value;
99
+ StringBuilder result = new StringBuilder("\"");
100
+ int slashes = 0;
101
+ foreach (char character in value)
102
+ {
103
+ if (character == '\\') { slashes++; continue; }
104
+ if (character == '"')
105
+ {
106
+ result.Append('\\', slashes * 2 + 1).Append('"');
107
+ slashes = 0;
108
+ continue;
109
+ }
110
+ result.Append('\\', slashes).Append(character);
111
+ slashes = 0;
112
+ }
113
+ result.Append('\\', slashes * 2).Append('"');
114
+ return result.ToString();
115
+ }
116
+
117
+ private static long TicksToNanoseconds(long ticks)
118
+ {
119
+ return checked((long)((decimal)ticks * 1000000000m / Stopwatch.Frequency));
120
+ }
121
+
122
+ private static void Check(bool value, string operation)
123
+ {
124
+ if (!value) ThrowLastError(operation);
125
+ }
126
+
127
+ private static void CheckHandle(IntPtr value, string operation)
128
+ {
129
+ if (value == IntPtr.Zero || value == new IntPtr(-1)) ThrowLastError(operation);
130
+ }
131
+
132
+ private static void ThrowLastError(string operation)
133
+ {
134
+ throw new System.ComponentModel.Win32Exception(Marshal.GetLastWin32Error(), "formal_process_supervisor_" + operation);
135
+ }
136
+
137
+ public static void AssertUniqueJsonObjectKeys(string json)
138
+ {
139
+ if (json == null) throw new FormatException("formal_process_supervisor_request_json");
140
+ int index = 0;
141
+ ParseJsonValue(json, ref index);
142
+ SkipJsonWhitespace(json, ref index);
143
+ if (index != json.Length)
144
+ throw new FormatException("formal_process_supervisor_request_json");
145
+ }
146
+
147
+ private static void ParseJsonValue(string json, ref int index)
148
+ {
149
+ SkipJsonWhitespace(json, ref index);
150
+ if (index >= json.Length)
151
+ throw new FormatException("formal_process_supervisor_request_json");
152
+ char token = json[index];
153
+ if (token == '{') { ParseJsonObject(json, ref index); return; }
154
+ if (token == '[') { ParseJsonArray(json, ref index); return; }
155
+ if (token == '"') { ParseJsonString(json, ref index); return; }
156
+ if (token == 't') { ConsumeJsonLiteral(json, ref index, "true"); return; }
157
+ if (token == 'f') { ConsumeJsonLiteral(json, ref index, "false"); return; }
158
+ if (token == 'n') { ConsumeJsonLiteral(json, ref index, "null"); return; }
159
+ ParseJsonNumber(json, ref index);
160
+ }
161
+
162
+ private static void ParseJsonObject(string json, ref int index)
163
+ {
164
+ index++;
165
+ HashSet<string> keys = new HashSet<string>(StringComparer.Ordinal);
166
+ SkipJsonWhitespace(json, ref index);
167
+ if (ConsumeJsonCharacter(json, ref index, '}')) return;
168
+ while (true)
169
+ {
170
+ SkipJsonWhitespace(json, ref index);
171
+ string key = ParseJsonString(json, ref index);
172
+ if (!keys.Add(key))
173
+ throw new InvalidOperationException("formal_process_supervisor_request_duplicate_field:" + key);
174
+ SkipJsonWhitespace(json, ref index);
175
+ RequireJsonCharacter(json, ref index, ':');
176
+ ParseJsonValue(json, ref index);
177
+ SkipJsonWhitespace(json, ref index);
178
+ if (ConsumeJsonCharacter(json, ref index, '}')) return;
179
+ RequireJsonCharacter(json, ref index, ',');
180
+ }
181
+ }
182
+
183
+ private static void ParseJsonArray(string json, ref int index)
184
+ {
185
+ index++;
186
+ SkipJsonWhitespace(json, ref index);
187
+ if (ConsumeJsonCharacter(json, ref index, ']')) return;
188
+ while (true)
189
+ {
190
+ ParseJsonValue(json, ref index);
191
+ SkipJsonWhitespace(json, ref index);
192
+ if (ConsumeJsonCharacter(json, ref index, ']')) return;
193
+ RequireJsonCharacter(json, ref index, ',');
194
+ }
195
+ }
196
+
197
+ private static string ParseJsonString(string json, ref int index)
198
+ {
199
+ RequireJsonCharacter(json, ref index, '"');
200
+ StringBuilder value = new StringBuilder();
201
+ while (index < json.Length)
202
+ {
203
+ char character = json[index++];
204
+ if (character == '"') return value.ToString();
205
+ if (character < 0x20)
206
+ throw new FormatException("formal_process_supervisor_request_json");
207
+ if (character != '\\') { value.Append(character); continue; }
208
+ if (index >= json.Length)
209
+ throw new FormatException("formal_process_supervisor_request_json");
210
+ char escaped = json[index++];
211
+ if (escaped == '"' || escaped == '\\' || escaped == '/') value.Append(escaped);
212
+ else if (escaped == 'b') value.Append('\b');
213
+ else if (escaped == 'f') value.Append('\f');
214
+ else if (escaped == 'n') value.Append('\n');
215
+ else if (escaped == 'r') value.Append('\r');
216
+ else if (escaped == 't') value.Append('\t');
217
+ else if (escaped == 'u') value.Append(ParseJsonUnicodeEscape(json, ref index));
218
+ else throw new FormatException("formal_process_supervisor_request_json");
219
+ }
220
+ throw new FormatException("formal_process_supervisor_request_json");
221
+ }
222
+
223
+ private static char ParseJsonUnicodeEscape(string json, ref int index)
224
+ {
225
+ if (index + 4 > json.Length)
226
+ throw new FormatException("formal_process_supervisor_request_json");
227
+ int value = 0;
228
+ for (int offset = 0; offset < 4; offset++)
229
+ {
230
+ char digit = json[index++];
231
+ int part = digit >= '0' && digit <= '9' ? digit - '0'
232
+ : digit >= 'a' && digit <= 'f' ? digit - 'a' + 10
233
+ : digit >= 'A' && digit <= 'F' ? digit - 'A' + 10
234
+ : -1;
235
+ if (part < 0)
236
+ throw new FormatException("formal_process_supervisor_request_json");
237
+ value = value * 16 + part;
238
+ }
239
+ return (char)value;
240
+ }
241
+
242
+ private static void ParseJsonNumber(string json, ref int index)
243
+ {
244
+ int start = index;
245
+ if (ConsumeJsonCharacter(json, ref index, '-')) { }
246
+ if (index >= json.Length)
247
+ throw new FormatException("formal_process_supervisor_request_json");
248
+ if (json[index] == '0') index++;
249
+ else
250
+ {
251
+ if (json[index] < '1' || json[index] > '9')
252
+ throw new FormatException("formal_process_supervisor_request_json");
253
+ while (index < json.Length && json[index] >= '0' && json[index] <= '9') index++;
254
+ }
255
+ if (ConsumeJsonCharacter(json, ref index, '.'))
256
+ {
257
+ int fraction = index;
258
+ while (index < json.Length && json[index] >= '0' && json[index] <= '9') index++;
259
+ if (fraction == index)
260
+ throw new FormatException("formal_process_supervisor_request_json");
261
+ }
262
+ if (index < json.Length && (json[index] == 'e' || json[index] == 'E'))
263
+ {
264
+ index++;
265
+ if (index < json.Length && (json[index] == '+' || json[index] == '-')) index++;
266
+ int exponent = index;
267
+ while (index < json.Length && json[index] >= '0' && json[index] <= '9') index++;
268
+ if (exponent == index)
269
+ throw new FormatException("formal_process_supervisor_request_json");
270
+ }
271
+ if (start == index)
272
+ throw new FormatException("formal_process_supervisor_request_json");
273
+ }
274
+
275
+ private static void ConsumeJsonLiteral(string json, ref int index, string literal)
276
+ {
277
+ if (index + literal.Length > json.Length ||
278
+ String.CompareOrdinal(json, index, literal, 0, literal.Length) != 0)
279
+ throw new FormatException("formal_process_supervisor_request_json");
280
+ index += literal.Length;
281
+ }
282
+
283
+ private static void SkipJsonWhitespace(string json, ref int index)
284
+ {
285
+ while (index < json.Length &&
286
+ (json[index] == ' ' || json[index] == '\t' || json[index] == '\r' || json[index] == '\n')) index++;
287
+ }
288
+
289
+ private static bool ConsumeJsonCharacter(string json, ref int index, char expected)
290
+ {
291
+ if (index >= json.Length || json[index] != expected) return false;
292
+ index++;
293
+ return true;
294
+ }
295
+
296
+ private static void RequireJsonCharacter(string json, ref int index, char expected)
297
+ {
298
+ if (!ConsumeJsonCharacter(json, ref index, expected))
299
+ throw new FormatException("formal_process_supervisor_request_json");
300
+ }
301
+ }
@@ -0,0 +1,197 @@
1
+ using System;
2
+ using System.Diagnostics;
3
+ using System.IO;
4
+ using System.Runtime.InteropServices;
5
+ using System.Text;
6
+ using System.Threading;
7
+ using System.Threading.Tasks;
8
+
9
+ public static partial class FormalProcessSupervisor
10
+ {
11
+ public static FormalProcessSupervisorResult Run(
12
+ string requestId,
13
+ string executable,
14
+ string[] argv,
15
+ string cwd,
16
+ string stdoutPath,
17
+ string stderrPath,
18
+ int timeoutMilliseconds,
19
+ long combinedOutputLimit,
20
+ string[] environment)
21
+ {
22
+ if (String.IsNullOrWhiteSpace(requestId) || String.IsNullOrWhiteSpace(executable))
23
+ throw new ArgumentException("formal_process_supervisor_request");
24
+ if (argv == null || environment == null || timeoutMilliseconds <= 0 || combinedOutputLimit <= 0)
25
+ throw new ArgumentException("formal_process_supervisor_limits");
26
+ if (File.Exists(stdoutPath) || File.Exists(stderrPath))
27
+ throw new IOException("formal_process_supervisor_log_preexisting");
28
+
29
+ IntPtr job = IntPtr.Zero;
30
+ IntPtr stdoutRead = IntPtr.Zero;
31
+ IntPtr stdoutWrite = IntPtr.Zero;
32
+ IntPtr stderrRead = IntPtr.Zero;
33
+ IntPtr stderrWrite = IntPtr.Zero;
34
+ IntPtr stdinRead = IntPtr.Zero;
35
+ IntPtr stdinWrite = IntPtr.Zero;
36
+ IntPtr environmentBlock = IntPtr.Zero;
37
+ PROCESS_INFORMATION process = new PROCESS_INFORMATION();
38
+ CaptureState captureState = null;
39
+ Task<long> stdoutTask = null;
40
+ Task<long> stderrTask = null;
41
+ bool timedOut = false;
42
+ long startedUnixMs = 0;
43
+ long startedTicks = 0;
44
+ try
45
+ {
46
+ job = CreateJobObject(IntPtr.Zero, null);
47
+ CheckHandle(job, "create_job");
48
+ JOBOBJECT_EXTENDED_LIMIT_INFORMATION limits = new JOBOBJECT_EXTENDED_LIMIT_INFORMATION();
49
+ limits.BasicLimitInformation.LimitFlags = JOB_OBJECT_LIMIT_KILL_ON_JOB_CLOSE;
50
+ Check(SetInformationJobObject(
51
+ job,
52
+ JobObjectExtendedLimitInformation,
53
+ ref limits,
54
+ (uint)Marshal.SizeOf<JOBOBJECT_EXTENDED_LIMIT_INFORMATION>()),
55
+ "set_job_limits");
56
+
57
+ SECURITY_ATTRIBUTES pipeAttributes = new SECURITY_ATTRIBUTES();
58
+ pipeAttributes.nLength = Marshal.SizeOf<SECURITY_ATTRIBUTES>();
59
+ pipeAttributes.bInheritHandle = true;
60
+ Check(CreatePipe(out stdoutRead, out stdoutWrite, ref pipeAttributes, 0), "stdout_pipe");
61
+ Check(CreatePipe(out stderrRead, out stderrWrite, ref pipeAttributes, 0), "stderr_pipe");
62
+ Check(CreatePipe(out stdinRead, out stdinWrite, ref pipeAttributes, 0), "stdin_pipe");
63
+ Check(SetHandleInformation(stdoutRead, HANDLE_FLAG_INHERIT, 0), "stdout_parent_handle");
64
+ Check(SetHandleInformation(stderrRead, HANDLE_FLAG_INHERIT, 0), "stderr_parent_handle");
65
+ Check(SetHandleInformation(stdinWrite, HANDLE_FLAG_INHERIT, 0), "stdin_parent_handle");
66
+
67
+ STARTUPINFO startup = new STARTUPINFO();
68
+ startup.cb = Marshal.SizeOf<STARTUPINFO>();
69
+ startup.dwFlags = STARTF_USESTDHANDLES;
70
+ startup.hStdInput = stdinRead;
71
+ startup.hStdOutput = stdoutWrite;
72
+ startup.hStdError = stderrWrite;
73
+ environmentBlock = BuildEnvironmentBlock(environment);
74
+ StringBuilder commandLine = new StringBuilder(BuildCommandLine(executable, argv));
75
+ Check(CreateProcessW(
76
+ executable,
77
+ commandLine,
78
+ IntPtr.Zero,
79
+ IntPtr.Zero,
80
+ true,
81
+ CREATE_SUSPENDED | CREATE_NO_WINDOW | CREATE_UNICODE_ENVIRONMENT,
82
+ environmentBlock,
83
+ cwd,
84
+ ref startup,
85
+ out process),
86
+ "create_process");
87
+ Check(AssignProcessToJobObject(job, process.hProcess), "assign_process_to_job");
88
+
89
+ CloseHandle(stdoutWrite); stdoutWrite = IntPtr.Zero;
90
+ CloseHandle(stderrWrite); stderrWrite = IntPtr.Zero;
91
+ CloseHandle(stdinRead); stdinRead = IntPtr.Zero;
92
+ CloseHandle(stdinWrite); stdinWrite = IntPtr.Zero;
93
+
94
+ captureState = new CaptureState { CombinedBytes = 0, Overflow = 0, Limit = combinedOutputLimit, Job = job };
95
+ stdoutTask = CaptureAsync(stdoutRead, stdoutPath, captureState);
96
+ stdoutRead = IntPtr.Zero;
97
+ stderrTask = CaptureAsync(stderrRead, stderrPath, captureState);
98
+ stderrRead = IntPtr.Zero;
99
+
100
+ startedUnixMs = DateTimeOffset.UtcNow.ToUnixTimeMilliseconds();
101
+ startedTicks = Stopwatch.GetTimestamp();
102
+ if (ResumeThread(process.hThread) == UInt32.MaxValue)
103
+ ThrowLastError("resume_process");
104
+ CloseHandle(process.hThread); process.hThread = IntPtr.Zero;
105
+
106
+ Stopwatch elapsed = Stopwatch.StartNew();
107
+ JOBOBJECT_BASIC_ACCOUNTING_INFORMATION accounting;
108
+ while (true)
109
+ {
110
+ accounting = QueryAccounting(job);
111
+ if (accounting.ActiveProcesses == 0) break;
112
+ if (Volatile.Read(ref captureState.Overflow) != 0)
113
+ {
114
+ TerminateJobObject(job, 0xE0000002);
115
+ }
116
+ else if (elapsed.ElapsedMilliseconds > timeoutMilliseconds)
117
+ {
118
+ timedOut = true;
119
+ TerminateJobObject(job, 0xE0000001);
120
+ }
121
+ if (timedOut || Volatile.Read(ref captureState.Overflow) != 0)
122
+ {
123
+ Stopwatch cleanup = Stopwatch.StartNew();
124
+ while (QueryAccounting(job).ActiveProcesses != 0 && cleanup.ElapsedMilliseconds <= CleanupWaitMilliseconds)
125
+ Thread.Sleep(10);
126
+ break;
127
+ }
128
+ Thread.Sleep(10);
129
+ }
130
+
131
+ accounting = QueryAccounting(job);
132
+ if (accounting.ActiveProcesses != 0)
133
+ throw new InvalidOperationException("formal_process_supervisor_descendants_alive");
134
+ Task.WaitAll(stdoutTask, stderrTask);
135
+ long completedTicks = Stopwatch.GetTimestamp();
136
+ long completedUnixMs = DateTimeOffset.UtcNow.ToUnixTimeMilliseconds();
137
+ uint rawExitCode;
138
+ Check(GetExitCodeProcess(process.hProcess, out rawExitCode), "process_exit_code");
139
+ if (rawExitCode == STILL_ACTIVE)
140
+ throw new InvalidOperationException("formal_process_supervisor_root_alive");
141
+ return new FormalProcessSupervisorResult
142
+ {
143
+ RequestId = requestId,
144
+ ProcessId = checked((int)process.dwProcessId),
145
+ ExitCode = unchecked((int)rawExitCode),
146
+ TimedOut = timedOut,
147
+ OutputOverflow = Volatile.Read(ref captureState.Overflow) != 0,
148
+ DescendantsCleaned = accounting.ActiveProcesses == 0,
149
+ StdoutBytes = stdoutTask.Result,
150
+ StderrBytes = stderrTask.Result,
151
+ StartedUnixMs = startedUnixMs,
152
+ CompletedUnixMs = completedUnixMs,
153
+ MonotonicStartedNs = TicksToNanoseconds(startedTicks).ToString(),
154
+ MonotonicCompletedNs = TicksToNanoseconds(completedTicks).ToString(),
155
+ MonotonicClockId = "windows-stopwatch-qpc-v1",
156
+ WallClockId = "unix-epoch-ms-v1",
157
+ UserCpu100Ns = accounting.TotalUserTime,
158
+ KernelCpu100Ns = accounting.TotalKernelTime,
159
+ TotalCpu100Ns = checked(accounting.TotalUserTime + accounting.TotalKernelTime),
160
+ TotalProcesses = accounting.TotalProcesses,
161
+ ActiveProcessesAtResult = accounting.ActiveProcesses,
162
+ TotalTerminatedProcesses = accounting.TotalTerminatedProcesses,
163
+ AccountingSourceKind = "windows-job-object-accounting-v1",
164
+ Error = null,
165
+ };
166
+ }
167
+ catch
168
+ {
169
+ if (job != IntPtr.Zero) TerminateJobObject(job, 0xE0000003);
170
+ if (process.hProcess != IntPtr.Zero)
171
+ {
172
+ TerminateProcess(process.hProcess, 0xE0000003);
173
+ WaitForSingleObject(process.hProcess, CleanupWaitMilliseconds);
174
+ }
175
+ try
176
+ {
177
+ if (stdoutTask != null) stdoutTask.Wait(CleanupWaitMilliseconds);
178
+ if (stderrTask != null) stderrTask.Wait(CleanupWaitMilliseconds);
179
+ }
180
+ catch { }
181
+ throw;
182
+ }
183
+ finally
184
+ {
185
+ if (process.hThread != IntPtr.Zero) CloseHandle(process.hThread);
186
+ if (process.hProcess != IntPtr.Zero) CloseHandle(process.hProcess);
187
+ if (stdoutRead != IntPtr.Zero) CloseHandle(stdoutRead);
188
+ if (stdoutWrite != IntPtr.Zero) CloseHandle(stdoutWrite);
189
+ if (stderrRead != IntPtr.Zero) CloseHandle(stderrRead);
190
+ if (stderrWrite != IntPtr.Zero) CloseHandle(stderrWrite);
191
+ if (stdinRead != IntPtr.Zero) CloseHandle(stdinRead);
192
+ if (stdinWrite != IntPtr.Zero) CloseHandle(stdinWrite);
193
+ if (environmentBlock != IntPtr.Zero) Marshal.FreeHGlobal(environmentBlock);
194
+ if (job != IntPtr.Zero) CloseHandle(job);
195
+ }
196
+ }
197
+ }