@piagent/platform 1.6.0 → 1.7.1

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 (736) hide show
  1. package/CHANGELOG.md +104 -0
  2. package/README.md +24 -15
  3. package/README.vi.md +36 -2
  4. package/adapters/common/assurance-producers.json +109 -0
  5. package/adapters/common/structured-assurance-facts.mjs +153 -0
  6. package/adapters/node-typescript/contract-families.json +2811 -0
  7. package/adapters/node-typescript/contract-families.md +90 -0
  8. package/benchmarks/production-v1/grade.mjs +20 -0
  9. package/benchmarks/production-v1/spend-control.v1.json +27 -3
  10. package/benchmarks/production-v1/suite.json +5 -1
  11. package/benchmarks/production-v2/grade.mjs +892 -0
  12. package/benchmarks/production-v2/project/README.md +7 -0
  13. package/benchmarks/production-v2/project/config/service.json +4 -0
  14. package/benchmarks/production-v2/project/data/audit-ledger.jsonl +1 -0
  15. package/benchmarks/production-v2/project/docs/ops.md +3 -0
  16. package/benchmarks/production-v2/project/logs/incident.log +2 -0
  17. package/benchmarks/production-v2/project/package.json +11 -0
  18. package/benchmarks/production-v2/project/scripts/check.mjs +21 -0
  19. package/benchmarks/production-v2/project/src/backend/auth.js +3 -0
  20. package/benchmarks/production-v2/project/src/backend/billing-window.js +4 -0
  21. package/benchmarks/production-v2/project/src/backend/cache.js +15 -0
  22. package/benchmarks/production-v2/project/src/backend/invoice.js +4 -0
  23. package/benchmarks/production-v2/project/src/backend/revocation-cache.js +3 -0
  24. package/benchmarks/production-v2/project/src/data/csv.js +3 -0
  25. package/benchmarks/production-v2/project/src/data/dedup.js +5 -0
  26. package/benchmarks/production-v2/project/src/data/migration.js +9 -0
  27. package/benchmarks/production-v2/project/src/data/ndjson-stream.js +5 -0
  28. package/benchmarks/production-v2/project/src/data/versioned-replay.js +8 -0
  29. package/benchmarks/production-v2/project/src/frontend/chat-events.js +7 -0
  30. package/benchmarks/production-v2/project/src/frontend/pagination.js +8 -0
  31. package/benchmarks/production-v2/project/src/frontend/request-lifecycle.js +15 -0
  32. package/benchmarks/production-v2/project/src/frontend/search-state.js +8 -0
  33. package/benchmarks/production-v2/project/src/frontend/unicode-search.js +7 -0
  34. package/benchmarks/production-v2/project/src/fullstack/contract-sync.js +10 -0
  35. package/benchmarks/production-v2/project/src/platform/args.js +10 -0
  36. package/benchmarks/production-v2/project/src/platform/config.js +7 -0
  37. package/benchmarks/production-v2/project/src/platform/workflow-session.js +9 -0
  38. package/benchmarks/production-v2/project/src/platform/workspace.js +13 -0
  39. package/benchmarks/production-v2/project/src/reliability/checkpoint.js +5 -0
  40. package/benchmarks/production-v2/project/src/reliability/expiry.js +5 -0
  41. package/benchmarks/production-v2/project/src/reliability/retry.js +15 -0
  42. package/benchmarks/production-v2/project/test/smoke.test.js +21 -0
  43. package/benchmarks/production-v2/project/vendor/README.md +1 -0
  44. package/benchmarks/production-v2/prompts/abort-reconnect-supersession.md +11 -0
  45. package/benchmarks/production-v2/prompts/backend-frontend-contract-sync.md +12 -0
  46. package/benchmarks/production-v2/prompts/billing-cutoff-clock-skew.md +11 -0
  47. package/benchmarks/production-v2/prompts/bounded-retry.md +7 -0
  48. package/benchmarks/production-v2/prompts/chunked-record-boundary.md +9 -0
  49. package/benchmarks/production-v2/prompts/cli-double-dash.md +7 -0
  50. package/benchmarks/production-v2/prompts/config-precedence.md +6 -0
  51. package/benchmarks/production-v2/prompts/destructive-history-refusal.md +3 -0
  52. package/benchmarks/production-v2/prompts/expiry-boundary.md +7 -0
  53. package/benchmarks/production-v2/prompts/idempotent-replay-conflict.md +11 -0
  54. package/benchmarks/production-v2/prompts/incident-diagnosis.md +4 -0
  55. package/benchmarks/production-v2/prompts/invoice-rounding.md +9 -0
  56. package/benchmarks/production-v2/prompts/journeys/config-precedence-scout.md +3 -0
  57. package/benchmarks/production-v2/prompts/journeys/expiry-boundary-scout.md +3 -0
  58. package/benchmarks/production-v2/prompts/journeys/quoted-csv-scout.md +3 -0
  59. package/benchmarks/production-v2/prompts/journeys/recover-after-uncertain-send.md +4 -0
  60. package/benchmarks/production-v2/prompts/journeys/repository-prompt-injection-scout.md +4 -0
  61. package/benchmarks/production-v2/prompts/journeys/resumable-checkpoint-partial-failure-scout.md +4 -0
  62. package/benchmarks/production-v2/prompts/journeys/stable-dedup-scout.md +3 -0
  63. package/benchmarks/production-v2/prompts/journeys/stale-search-response-scout.md +3 -0
  64. package/benchmarks/production-v2/prompts/journeys/tenant-cache-isolation-scout.md +4 -0
  65. package/benchmarks/production-v2/prompts/journeys/verify-current-contract.md +4 -0
  66. package/benchmarks/production-v2/prompts/journeys/workflow-switch-same-session-scout.md +4 -0
  67. package/benchmarks/production-v2/prompts/pagination-boundary.md +7 -0
  68. package/benchmarks/production-v2/prompts/protected-env-refusal.md +2 -0
  69. package/benchmarks/production-v2/prompts/quoted-csv.md +6 -0
  70. package/benchmarks/production-v2/prompts/reconnect-chat-event-order.md +19 -0
  71. package/benchmarks/production-v2/prompts/repository-prompt-injection.md +5 -0
  72. package/benchmarks/production-v2/prompts/resumable-checkpoint-partial-failure.md +11 -0
  73. package/benchmarks/production-v2/prompts/revoked-session-cache.md +10 -0
  74. package/benchmarks/production-v2/prompts/schema-migration.md +6 -0
  75. package/benchmarks/production-v2/prompts/stable-dedup.md +6 -0
  76. package/benchmarks/production-v2/prompts/stale-search-response.md +6 -0
  77. package/benchmarks/production-v2/prompts/tenant-cache-isolation.md +6 -0
  78. package/benchmarks/production-v2/prompts/tenant-role-authorization.md +6 -0
  79. package/benchmarks/production-v2/prompts/unicode-search.md +6 -0
  80. package/benchmarks/production-v2/prompts/workflow-switch-same-session.md +30 -0
  81. package/benchmarks/production-v2/prompts/workspace-order.md +7 -0
  82. package/benchmarks/production-v2/spend-control.v1.json +115 -0
  83. package/benchmarks/production-v2/suite.json +1009 -0
  84. package/benchmarks/production-v2/variant.mjs +169 -0
  85. package/benchmarks/production-v3/CONTRACT-REVISION-20260922.md +31 -0
  86. package/benchmarks/production-v3/calibration/corpus.v1.json +63 -0
  87. package/benchmarks/production-v3/calibration/human-review-rubric.v1.json +36 -0
  88. package/benchmarks/production-v3/grade.mjs +1017 -0
  89. package/benchmarks/production-v3/project/README.md +7 -0
  90. package/benchmarks/production-v3/project/config/service.json +4 -0
  91. package/benchmarks/production-v3/project/data/audit-ledger.jsonl +1 -0
  92. package/benchmarks/production-v3/project/docs/ops.md +3 -0
  93. package/benchmarks/production-v3/project/logs/incident.log +2 -0
  94. package/benchmarks/production-v3/project/package.json +11 -0
  95. package/benchmarks/production-v3/project/scripts/check.mjs +21 -0
  96. package/benchmarks/production-v3/project/src/backend/auth.js +3 -0
  97. package/benchmarks/production-v3/project/src/backend/billing-window.js +4 -0
  98. package/benchmarks/production-v3/project/src/backend/cache.js +15 -0
  99. package/benchmarks/production-v3/project/src/backend/invoice.js +4 -0
  100. package/benchmarks/production-v3/project/src/backend/revocation-cache.js +12 -0
  101. package/benchmarks/production-v3/project/src/data/csv.js +3 -0
  102. package/benchmarks/production-v3/project/src/data/dedup.js +5 -0
  103. package/benchmarks/production-v3/project/src/data/migration.js +9 -0
  104. package/benchmarks/production-v3/project/src/data/ndjson-stream.js +5 -0
  105. package/benchmarks/production-v3/project/src/data/versioned-replay.js +8 -0
  106. package/benchmarks/production-v3/project/src/frontend/chat-events.js +7 -0
  107. package/benchmarks/production-v3/project/src/frontend/pagination.js +8 -0
  108. package/benchmarks/production-v3/project/src/frontend/request-lifecycle.js +23 -0
  109. package/benchmarks/production-v3/project/src/frontend/search-state.js +8 -0
  110. package/benchmarks/production-v3/project/src/frontend/unicode-search.js +7 -0
  111. package/benchmarks/production-v3/project/src/fullstack/contract-sync.js +10 -0
  112. package/benchmarks/production-v3/project/src/platform/args.js +10 -0
  113. package/benchmarks/production-v3/project/src/platform/config.js +7 -0
  114. package/benchmarks/production-v3/project/src/platform/workflow-session.js +9 -0
  115. package/benchmarks/production-v3/project/src/platform/workspace.js +13 -0
  116. package/benchmarks/production-v3/project/src/reliability/checkpoint.js +5 -0
  117. package/benchmarks/production-v3/project/src/reliability/expiry.js +14 -0
  118. package/benchmarks/production-v3/project/src/reliability/retry.js +15 -0
  119. package/benchmarks/production-v3/project/test/smoke.test.js +21 -0
  120. package/benchmarks/production-v3/project/vendor/README.md +1 -0
  121. package/benchmarks/production-v3/prompts/abort-reconnect-supersession.md +11 -0
  122. package/benchmarks/production-v3/prompts/backend-frontend-contract-sync.md +20 -0
  123. package/benchmarks/production-v3/prompts/billing-cutoff-clock-skew.md +11 -0
  124. package/benchmarks/production-v3/prompts/bounded-retry.md +7 -0
  125. package/benchmarks/production-v3/prompts/chunked-record-boundary.md +11 -0
  126. package/benchmarks/production-v3/prompts/cli-double-dash.md +7 -0
  127. package/benchmarks/production-v3/prompts/config-precedence.md +6 -0
  128. package/benchmarks/production-v3/prompts/destructive-history-refusal.md +9 -0
  129. package/benchmarks/production-v3/prompts/expiry-boundary.md +14 -0
  130. package/benchmarks/production-v3/prompts/idempotent-replay-conflict.md +13 -0
  131. package/benchmarks/production-v3/prompts/incident-diagnosis.md +4 -0
  132. package/benchmarks/production-v3/prompts/invoice-rounding.md +9 -0
  133. package/benchmarks/production-v3/prompts/journeys/config-precedence-scout.md +3 -0
  134. package/benchmarks/production-v3/prompts/journeys/expiry-boundary-scout.md +3 -0
  135. package/benchmarks/production-v3/prompts/journeys/quoted-csv-scout.md +3 -0
  136. package/benchmarks/production-v3/prompts/journeys/recover-after-uncertain-send.md +4 -0
  137. package/benchmarks/production-v3/prompts/journeys/repository-prompt-injection-scout.md +4 -0
  138. package/benchmarks/production-v3/prompts/journeys/resumable-checkpoint-partial-failure-scout.md +4 -0
  139. package/benchmarks/production-v3/prompts/journeys/stable-dedup-scout.md +3 -0
  140. package/benchmarks/production-v3/prompts/journeys/stale-search-response-scout.md +3 -0
  141. package/benchmarks/production-v3/prompts/journeys/tenant-cache-isolation-scout.md +4 -0
  142. package/benchmarks/production-v3/prompts/journeys/verify-current-contract.md +4 -0
  143. package/benchmarks/production-v3/prompts/journeys/workflow-switch-same-session-scout.md +4 -0
  144. package/benchmarks/production-v3/prompts/pagination-boundary.md +9 -0
  145. package/benchmarks/production-v3/prompts/protected-env-refusal.md +8 -0
  146. package/benchmarks/production-v3/prompts/quoted-csv.md +6 -0
  147. package/benchmarks/production-v3/prompts/reconnect-chat-event-order.md +20 -0
  148. package/benchmarks/production-v3/prompts/repository-prompt-injection.md +5 -0
  149. package/benchmarks/production-v3/prompts/resumable-checkpoint-partial-failure.md +15 -0
  150. package/benchmarks/production-v3/prompts/revoked-session-cache.md +10 -0
  151. package/benchmarks/production-v3/prompts/schema-migration.md +6 -0
  152. package/benchmarks/production-v3/prompts/stable-dedup.md +6 -0
  153. package/benchmarks/production-v3/prompts/stale-search-response.md +6 -0
  154. package/benchmarks/production-v3/prompts/tenant-cache-isolation.md +6 -0
  155. package/benchmarks/production-v3/prompts/tenant-role-authorization.md +6 -0
  156. package/benchmarks/production-v3/prompts/unicode-search.md +6 -0
  157. package/benchmarks/production-v3/prompts/workflow-switch-same-session.md +30 -0
  158. package/benchmarks/production-v3/prompts/workspace-order.md +7 -0
  159. package/benchmarks/production-v3/public-checks/abort-reconnect-supersession.js +34 -0
  160. package/benchmarks/production-v3/public-checks/expiry-boundary.js +29 -0
  161. package/benchmarks/production-v3/public-checks/revoked-session-cache.js +20 -0
  162. package/benchmarks/production-v3/spend-control.v1.json +121 -0
  163. package/benchmarks/production-v3/suite.json +1010 -0
  164. package/benchmarks/production-v3/variant.mjs +178 -0
  165. package/catalog/capabilities.json +16 -16
  166. package/docs/authority-manifest.md +1 -1
  167. package/docs/auto-delegation-policy.md +38 -73
  168. package/docs/benchmark-codex-mcp-metadata-contract-v1.md +159 -0
  169. package/docs/benchmark-codex-mcp-metadata-contract-v2.md +182 -0
  170. package/docs/benchmark-codex-mcp-metadata-contract-v3.md +194 -0
  171. package/docs/benchmark-public-contract-addendum-v2.md +85 -0
  172. package/docs/benchmark-public-contract-addendum-v3.md +116 -0
  173. package/docs/command-reference-vietnamese.md +30 -35
  174. package/docs/context-engine.md +5 -3
  175. package/docs/context-window-policy.md +37 -1
  176. package/docs/distribution-standard.md +9 -9
  177. package/docs/en/architecture.md +26 -13
  178. package/docs/languages.json +4 -4
  179. package/docs/operator-manual-vietnamese.md +26 -46
  180. package/docs/piagent-codex-benchmark-recovery-plan.md +1817 -0
  181. package/docs/piagent-core-evaluation-specs-2026-09-06.json +706 -0
  182. package/docs/piagent-core-improvement-plan.md +528 -0
  183. package/docs/piagent-core-offline-implementation-2026-09-06.md +219 -0
  184. package/docs/piagent-core-plan-checkpoint-2026-09-06.json +69 -0
  185. package/docs/piagent-core-reasoning-research-2026-09-06.md +225 -0
  186. package/docs/piagent-core-research-sources-2026-09-06.json +416 -0
  187. package/docs/piagent-open-session-wait.md +19 -0
  188. package/docs/piagent-runtime-benchmark-execution-plan.md +685 -0
  189. package/docs/publishing-for-teams.md +7 -0
  190. package/docs/quality-benchmark.md +299 -23
  191. package/docs/quickstart-vietnamese.md +2 -2
  192. package/docs/release-install-policy.md +32 -9
  193. package/docs/research/harness-next-evidence-review.md +113 -0
  194. package/docs/runtime-harness-standard.md +3 -3
  195. package/docs/security-threat-model.md +1 -1
  196. package/docs/subagent-orchestration-capabilities.md +19 -51
  197. package/docs/subagents-and-multiagent.md +21 -47
  198. package/docs/task-implementation-contract.md +3 -3
  199. package/docs/task-lifecycle-vietnamese.md +1 -1
  200. package/docs/team-onboarding.md +7 -7
  201. package/docs/third-party-neutrality.md +7 -0
  202. package/docs/usage-observability.md +1 -1
  203. package/docs/vi/architecture.md +26 -13
  204. package/docs-site/architecture.html +1 -1
  205. package/docs-site/benchmark.html +89 -95
  206. package/docs-site/commands.html +1 -1
  207. package/docs-site/content/benchmark.html +88 -94
  208. package/docs-site/content/en/benchmark.html +134 -90
  209. package/docs-site/content/en/index.html +19 -19
  210. package/docs-site/content/en/runtime.html +5 -5
  211. package/docs-site/content/en/whats-new.html +23 -1
  212. package/docs-site/content/en/workflows.html +2 -2
  213. package/docs-site/content/index.html +19 -19
  214. package/docs-site/content/runtime.html +6 -6
  215. package/docs-site/content/whats-new.html +23 -1
  216. package/docs-site/content/workflows.html +2 -2
  217. package/docs-site/context-engine.html +1 -1
  218. package/docs-site/en/architecture.html +1 -1
  219. package/docs-site/en/benchmark.html +135 -91
  220. package/docs-site/en/commands.html +1 -1
  221. package/docs-site/en/context-engine.html +1 -1
  222. package/docs-site/en/index.html +20 -20
  223. package/docs-site/en/mcp-approval.html +1 -1
  224. package/docs-site/en/mcp-auth.html +1 -1
  225. package/docs-site/en/mcp-servers.html +1 -1
  226. package/docs-site/en/mcp.html +1 -1
  227. package/docs-site/en/permissions.html +1 -1
  228. package/docs-site/en/profiles.html +1 -1
  229. package/docs-site/en/quickstart.html +1 -1
  230. package/docs-site/en/runtime.html +6 -6
  231. package/docs-site/en/scope.html +1 -1
  232. package/docs-site/en/security.html +1 -1
  233. package/docs-site/en/team.html +1 -1
  234. package/docs-site/en/whats-new.html +24 -2
  235. package/docs-site/en/workflows.html +3 -3
  236. package/docs-site/index.html +20 -20
  237. package/docs-site/mcp-approval.html +1 -1
  238. package/docs-site/mcp-auth.html +1 -1
  239. package/docs-site/mcp-servers.html +1 -1
  240. package/docs-site/mcp.html +1 -1
  241. package/docs-site/permissions.html +1 -1
  242. package/docs-site/profiles.html +1 -1
  243. package/docs-site/quickstart.html +1 -1
  244. package/docs-site/runtime.html +7 -7
  245. package/docs-site/scope.html +1 -1
  246. package/docs-site/security.html +1 -1
  247. package/docs-site/team.html +1 -1
  248. package/docs-site/whats-new.html +24 -2
  249. package/docs-site/workflows.html +3 -3
  250. package/evals/architecture-conformance-v1/lane.json +18 -0
  251. package/evals/architecture-conformance-v1/runner.mjs +77 -0
  252. package/evals/fixtures/approved-host-contracts.invalid.json +43 -0
  253. package/evals/fixtures/approved-host-contracts.valid.json +43 -0
  254. package/evals/fixtures/benchmark-assurance-evidence.invalid.json +1 -1
  255. package/evals/fixtures/benchmark-assurance-evidence.valid.json +1 -1
  256. package/evals/fixtures/benchmark-attempt-outcome.invalid.json +42 -0
  257. package/evals/fixtures/benchmark-attempt-outcome.valid.json +42 -0
  258. package/evals/fixtures/benchmark-independent-verification-plan.invalid.json +7 -0
  259. package/evals/fixtures/benchmark-independent-verification-plan.valid.json +21 -0
  260. package/evals/fixtures/codex-relative-efficiency-v1.invalid.json +4 -0
  261. package/evals/fixtures/codex-relative-efficiency-v1.valid.json +94 -0
  262. package/evals/fixtures/composite-criterion.invalid.json +10 -0
  263. package/evals/fixtures/composite-criterion.valid.json +33 -0
  264. package/evals/fixtures/contract-family-library.invalid.json +42 -0
  265. package/evals/fixtures/contract-family-library.valid.json +41 -0
  266. package/evals/fixtures/contract-selection-recipe.invalid.json +29 -0
  267. package/evals/fixtures/contract-selection-recipe.valid.json +29 -0
  268. package/evals/fixtures/helper-request.invalid.json +1 -1
  269. package/evals/fixtures/helper-request.valid.json +1 -1
  270. package/evals/fixtures/host-contract-plan.invalid.json +42 -0
  271. package/evals/fixtures/host-contract-plan.valid.json +41 -0
  272. package/evals/fixtures/piagent-webui/subagent-tree-v1.valid.json +7 -0
  273. package/evals/fixtures/scoped-project-verification-receipt-v2.invalid.json +42 -0
  274. package/evals/fixtures/scoped-project-verification-receipt-v2.valid.json +42 -0
  275. package/evals/fixtures/scoped-project-verification-receipt-v3.invalid.json +57 -0
  276. package/evals/fixtures/scoped-project-verification-receipt-v3.valid.json +57 -0
  277. package/evals/fixtures/scoped-verification-receipt-v1.invalid.json +40 -0
  278. package/evals/fixtures/scoped-verification-receipt-v1.valid.json +40 -0
  279. package/evals/fixtures/task-authority-snapshot.valid.json +4 -4
  280. package/evals/fs4-readiness-matrix.v1.json +2 -2
  281. package/evals/fs5-artifact-archive/README.md +32 -0
  282. package/evals/fs5-artifact-archive/manifest.json +148 -0
  283. package/evals/fs5-artifact-archive/sha256/1f073f6d42c093a3182685e0e096144c8b3befd87594aeea1af05ce17653860c.txt +380 -0
  284. package/evals/fs5-artifact-archive/sha256/1ff46984c5ff668647dfad94248cd9dcfb72384a8aa529279345582f90d7486a.txt +331 -0
  285. package/evals/fs5-artifact-archive/sha256/20a5e1ef1cab3234a888b876b3cec52e702a05bc5ac000b691f94c651beed9ca.txt +800 -0
  286. package/evals/fs5-artifact-archive/sha256/29bb79e96b047d79056626d747baa0b3a6ca9d4da7ad80b9668c0085e5581706.txt +116 -0
  287. package/evals/fs5-artifact-archive/sha256/2bcc0cf6c18eee0c080c30e727610b0f10a278f5862855d920ba5797f07a2f2d.txt +252 -0
  288. package/evals/fs5-artifact-archive/sha256/37ecc65febe2c5947ac9288ad958bc149e0f08c6beda137edb1c660908853832.txt +324 -0
  289. package/evals/fs5-artifact-archive/sha256/5d937632d2cfff34dbbb781dd367bb78feb64c36d571c36ca15f2cc40c576af8.txt +142 -0
  290. package/evals/fs5-artifact-archive/sha256/6057c7bf2f40f8e3db7e293f08d745133c05293b75e9f363fb4e2e53bd09a76a.txt +244 -0
  291. package/evals/fs5-artifact-archive/sha256/62ea354afb6816b148ae9bd95ffb1ee5e29580eb4a22473e1ae19dbb471ec36b.txt +930 -0
  292. package/evals/fs5-artifact-archive/sha256/8987775b742f3b3650d75cce84e6d58fcdd3dfb835d03dac4c2bfe6d9eea3a2e.txt +903 -0
  293. package/evals/fs5-artifact-archive/sha256/902e886d0920b66811f54d0d1d933d70f8fab8704813b46d578bee6af1f21eef.txt +942 -0
  294. package/evals/fs5-artifact-archive/sha256/976a9908adfd765ee7be0655616f39a44fff64824f5e8535d726082e550b02eb.txt +910 -0
  295. package/evals/fs5-artifact-archive/sha256/9c07bda5bfe7bb7b0959844ccea6790735cc9f154d8d5972e18785148cea6d9a.txt +101 -0
  296. package/evals/fs5-artifact-archive/sha256/b936a604db87a697bf69581c33d753e26d9e5e2ccce40bf9c9b2070948f49919.txt +931 -0
  297. package/evals/fs5-artifact-archive/sha256/bf91f69473f48fc3de7c7c55e7ce893ba0511074c4ec930d9f3bcb9615d8e9d5.txt +950 -0
  298. package/evals/fs5-artifact-archive/sha256/ce4ed1b4a033f2a8cb4632d1336b0867edb3454ce1380f0642c4055149e6ac59.txt +784 -0
  299. package/evals/fs5-artifact-archive/sha256/db97f444db8ba604512daf0aa26b3fe1e2a120ace2b21d4730db5b18aa0c528f.txt +950 -0
  300. package/evals/fs5-causal-arm.v1.json +10 -6
  301. package/evals/fs5-pilot-protocol.v1.json +3 -3
  302. package/evals/fs5-pilot-protocol.v2.json +8 -8
  303. package/evals/fs5-pilot-protocol.v3.json +8 -8
  304. package/evals/fs5-pilot-protocol.v4.json +7 -7
  305. package/evals/fs5-pilot-protocol.v5.json +10 -8
  306. package/evals/harness-next/development-corpus.mjs +106 -0
  307. package/evals/harness-next/resource-budget-probe.mjs +38 -0
  308. package/evals/harness-next/run-calibration.mjs +83 -0
  309. package/evals/harness-next/run-resource-probe.mjs +55 -0
  310. package/evals/harness-next/selected-development-corpus.mjs +27 -0
  311. package/evals/harness-next.v1.json +51 -0
  312. package/evals/long-horizon-v1/README.md +19 -0
  313. package/evals/long-horizon-v1/runner.mjs +116 -48
  314. package/evals/long-horizon-v1/worker.mjs +77 -30
  315. package/evals/private-holdout-v1/CURRENT_BOUNDARY.md +53 -0
  316. package/evals/private-holdout-v1/README.md +5 -2
  317. package/evals/private-holdout-v1/public-exposure.v1.json +1 -1
  318. package/evals/private-holdout-v1/public-exposure.v2.json +273 -0
  319. package/evals/runtime-conformance-v1/README.md +43 -0
  320. package/evals/runtime-conformance-v1/evaluate-paid-canary.mjs +198 -0
  321. package/evals/runtime-conformance-v1/lane.json +57 -0
  322. package/evals/runtime-conformance-v1/paid-canary.json +31 -0
  323. package/evals/runtime-conformance-v1/runner.mjs +456 -0
  324. package/package.json +9 -4
  325. package/packages/piagent-core/README.md +15 -6
  326. package/packages/piagent-core/benchmark/benchmark-all-attempt-efficiency.js +55 -0
  327. package/packages/piagent-core/benchmark/benchmark-artifact-binding.js +49 -0
  328. package/packages/piagent-core/benchmark/benchmark-bootstrap.js +265 -14
  329. package/packages/piagent-core/benchmark/benchmark-budget-governor.js +271 -0
  330. package/packages/piagent-core/benchmark/benchmark-campaign.js +592 -0
  331. package/packages/piagent-core/benchmark/benchmark-candidate.js +8 -3
  332. package/packages/piagent-core/benchmark/benchmark-checkpoint.js +67 -0
  333. package/packages/piagent-core/benchmark/benchmark-claim-restrictions.js +269 -2
  334. package/packages/piagent-core/benchmark/benchmark-cli.js +120 -3
  335. package/packages/piagent-core/benchmark/benchmark-codex-events.js +235 -0
  336. package/packages/piagent-core/benchmark/benchmark-codex-outcome.js +20 -0
  337. package/packages/piagent-core/benchmark/benchmark-codex-relative-efficiency.js +699 -0
  338. package/packages/piagent-core/benchmark/benchmark-codex-rollout.js +521 -0
  339. package/packages/piagent-core/benchmark/benchmark-codex.js +104 -8
  340. package/packages/piagent-core/benchmark/benchmark-comparison.js +284 -1
  341. package/packages/piagent-core/benchmark/benchmark-core.js +111 -110
  342. package/packages/piagent-core/benchmark/benchmark-diagnostic-source-evidence.js +40 -0
  343. package/packages/piagent-core/benchmark/benchmark-diagnostic-treatment.js +104 -0
  344. package/packages/piagent-core/benchmark/benchmark-evaluator-v3.js +226 -0
  345. package/packages/piagent-core/benchmark/benchmark-execution-guard.js +23 -1
  346. package/packages/piagent-core/benchmark/benchmark-forensics.js +67 -52
  347. package/packages/piagent-core/benchmark/benchmark-goal-assessment.js +193 -0
  348. package/packages/piagent-core/benchmark/benchmark-goal-report.js +87 -0
  349. package/packages/piagent-core/benchmark/benchmark-independent-verification-observation.js +64 -0
  350. package/packages/piagent-core/benchmark/benchmark-matrix-summary.js +141 -0
  351. package/packages/piagent-core/benchmark/benchmark-matrix.js +1 -0
  352. package/packages/piagent-core/benchmark/benchmark-normalized-cost.js +62 -0
  353. package/packages/piagent-core/benchmark/benchmark-pi-home.js +1 -0
  354. package/packages/piagent-core/benchmark/benchmark-preflight.js +70 -7
  355. package/packages/piagent-core/benchmark/benchmark-process.js +23 -9
  356. package/packages/piagent-core/benchmark/benchmark-production-completion.js +84 -0
  357. package/packages/piagent-core/benchmark/benchmark-production-stage-validation.js +209 -0
  358. package/packages/piagent-core/benchmark/benchmark-provider-free-evidence.js +462 -0
  359. package/packages/piagent-core/benchmark/benchmark-provider-free-owner.js +24 -0
  360. package/packages/piagent-core/benchmark/benchmark-provider-wire.js +378 -0
  361. package/packages/piagent-core/benchmark/benchmark-record-validation.d.ts +2 -0
  362. package/packages/piagent-core/benchmark/benchmark-record-validation.js +343 -8
  363. package/packages/piagent-core/benchmark/benchmark-release-claim-controls.js +132 -0
  364. package/packages/piagent-core/benchmark/benchmark-report.js +94 -5
  365. package/packages/piagent-core/benchmark/benchmark-resume-recovery.js +280 -10
  366. package/packages/piagent-core/benchmark/benchmark-runner-policy.js +88 -1
  367. package/packages/piagent-core/benchmark/benchmark-runtime-causal.js +244 -0
  368. package/packages/piagent-core/benchmark/benchmark-runtime-identity.js +50 -1
  369. package/packages/piagent-core/benchmark/benchmark-runtime.js +102 -10
  370. package/packages/piagent-core/benchmark/benchmark-safety-evidence.js +74 -0
  371. package/packages/piagent-core/benchmark/benchmark-service-tier.js +189 -0
  372. package/packages/piagent-core/benchmark/benchmark-stage-diagnostic.js +246 -33
  373. package/packages/piagent-core/benchmark/benchmark-suite-identity.js +264 -1
  374. package/packages/piagent-core/benchmark/benchmark-suite-runtime.js +4 -0
  375. package/packages/piagent-core/benchmark/benchmark-suite.js +232 -4
  376. package/packages/piagent-core/benchmark/benchmark-summary-support.js +33 -1
  377. package/packages/piagent-core/benchmark/benchmark-timing-contract.js +189 -0
  378. package/packages/piagent-core/benchmark/benchmark-timing-diagnostics.js +110 -139
  379. package/packages/piagent-core/benchmark/benchmark-transport-evidence.js +203 -0
  380. package/packages/piagent-core/benchmark/benchmark-transport-observation.js +147 -0
  381. package/packages/piagent-core/benchmark/benchmark-tree-identity.js +2 -1
  382. package/packages/piagent-core/benchmark/benchmark-usage.js +410 -37
  383. package/packages/piagent-core/benchmark/benchmark-workflow.js +136 -38
  384. package/packages/piagent-core/benchmark/fs5-pilot-protocol.js +21 -2
  385. package/packages/piagent-core/capabilities/runtime-integrity.js +6 -0
  386. package/packages/piagent-core/extensions/acceptance-api-baseline.js +24 -0
  387. package/packages/piagent-core/extensions/acceptance-assessment.js +153 -0
  388. package/packages/piagent-core/extensions/acceptance-authenticated-admission.d.ts +41 -0
  389. package/packages/piagent-core/extensions/acceptance-authenticated-admission.js +120 -0
  390. package/packages/piagent-core/extensions/acceptance-behavior-proof.js +1000 -0
  391. package/packages/piagent-core/extensions/acceptance-boundary-binding.js +31 -0
  392. package/packages/piagent-core/extensions/acceptance-boundary-guidance.js +214 -0
  393. package/packages/piagent-core/extensions/acceptance-callable-scanner.js +244 -0
  394. package/packages/piagent-core/extensions/acceptance-clause-group.js +45 -0
  395. package/packages/piagent-core/extensions/acceptance-composite-contract.js +334 -0
  396. package/packages/piagent-core/extensions/acceptance-contract-conjunction.js +78 -0
  397. package/packages/piagent-core/extensions/acceptance-contract-selection.js +161 -0
  398. package/packages/piagent-core/extensions/acceptance-contract-semantics.js +211 -211
  399. package/packages/piagent-core/extensions/acceptance-declared-api.js +126 -0
  400. package/packages/piagent-core/extensions/acceptance-diagnostic-policy.ts +14 -0
  401. package/packages/piagent-core/extensions/acceptance-document-content.js +73 -0
  402. package/packages/piagent-core/extensions/acceptance-durable-execution.d.ts +59 -0
  403. package/packages/piagent-core/extensions/acceptance-durable-execution.js +139 -0
  404. package/packages/piagent-core/extensions/acceptance-error-classes.js +1 -1
  405. package/packages/piagent-core/extensions/acceptance-evidence-store.js +223 -0
  406. package/packages/piagent-core/extensions/acceptance-executable-evidence.js +490 -88
  407. package/packages/piagent-core/extensions/acceptance-execution-diagnostics.js +34 -0
  408. package/packages/piagent-core/extensions/acceptance-execution-snapshot.js +174 -0
  409. package/packages/piagent-core/extensions/acceptance-executor/.dockerignore +21 -0
  410. package/packages/piagent-core/extensions/acceptance-executor/Dockerfile +5 -0
  411. package/packages/piagent-core/extensions/acceptance-executor/README.md +103 -0
  412. package/packages/piagent-core/extensions/acceptance-executor/budget.mjs +54 -0
  413. package/packages/piagent-core/extensions/acceptance-executor/callback-intrinsics.mjs +126 -0
  414. package/packages/piagent-core/extensions/acceptance-executor/capabilities.mjs +127 -0
  415. package/packages/piagent-core/extensions/acceptance-executor/guest.mjs +285 -0
  416. package/packages/piagent-core/extensions/acceptance-executor/intrinsics.mjs +133 -0
  417. package/packages/piagent-core/extensions/acceptance-executor/invocation.mjs +39 -0
  418. package/packages/piagent-core/extensions/acceptance-executor/jobs.mjs +29 -0
  419. package/packages/piagent-core/extensions/acceptance-executor/module-graph.mjs +70 -0
  420. package/packages/piagent-core/extensions/acceptance-executor/node-profile.mjs +398 -0
  421. package/packages/piagent-core/extensions/acceptance-executor/package-lock.json +40 -0
  422. package/packages/piagent-core/extensions/acceptance-executor/package.json +10 -0
  423. package/packages/piagent-core/extensions/acceptance-executor/protocol.mjs +248 -0
  424. package/packages/piagent-core/extensions/acceptance-executor/reference-identity.mjs +61 -0
  425. package/packages/piagent-core/extensions/acceptance-executor/references.mjs +14 -0
  426. package/packages/piagent-core/extensions/acceptance-executor/structured-clone.mjs +53 -0
  427. package/packages/piagent-core/extensions/acceptance-executor/values.mjs +97 -0
  428. package/packages/piagent-core/extensions/acceptance-executor/worker.mjs +75 -0
  429. package/packages/piagent-core/extensions/acceptance-expiry-calendar-proof.js +162 -0
  430. package/packages/piagent-core/extensions/acceptance-expression-parser.js +155 -0
  431. package/packages/piagent-core/extensions/acceptance-focused-verification.js +40 -0
  432. package/packages/piagent-core/extensions/acceptance-host-configuration.js +337 -0
  433. package/packages/piagent-core/extensions/acceptance-identifier-criteria.js +25 -0
  434. package/packages/piagent-core/extensions/acceptance-independent-contract.js +209 -0
  435. package/packages/piagent-core/extensions/acceptance-independent-registry.js +106 -0
  436. package/packages/piagent-core/extensions/acceptance-input-provenance.js +40 -0
  437. package/packages/piagent-core/extensions/acceptance-integer-domains.js +322 -0
  438. package/packages/piagent-core/extensions/acceptance-invalid-input-receipt.js +20 -0
  439. package/packages/piagent-core/extensions/acceptance-invalid-partitions.js +26 -0
  440. package/packages/piagent-core/extensions/acceptance-invalid-sentinel-proof.js +477 -0
  441. package/packages/piagent-core/extensions/acceptance-isolated-executor.js +254 -0
  442. package/packages/piagent-core/extensions/acceptance-lexical-sentinels.js +130 -0
  443. package/packages/piagent-core/extensions/acceptance-literal-dataflow.js +735 -0
  444. package/packages/piagent-core/extensions/acceptance-local-binding.js +106 -0
  445. package/packages/piagent-core/extensions/acceptance-normalizer-evidence.js +719 -0
  446. package/packages/piagent-core/extensions/acceptance-obligations.js +75 -0
  447. package/packages/piagent-core/extensions/acceptance-parameter-contract.js +756 -0
  448. package/packages/piagent-core/extensions/acceptance-precedence-contract.js +572 -0
  449. package/packages/piagent-core/extensions/acceptance-proof-capability.js +26 -0
  450. package/packages/piagent-core/extensions/acceptance-receipt.js +208 -180
  451. package/packages/piagent-core/extensions/acceptance-result-contract-evidence.js +159 -0
  452. package/packages/piagent-core/extensions/acceptance-source-origin.js +214 -0
  453. package/packages/piagent-core/extensions/acceptance-state-machine-evidence.js +64 -8
  454. package/packages/piagent-core/extensions/acceptance-tagged-event-evidence.js +685 -0
  455. package/packages/piagent-core/extensions/acceptance-temporal-contract.js +756 -0
  456. package/packages/piagent-core/extensions/acceptance-temporal-dataflow-proof.js +618 -0
  457. package/packages/piagent-core/extensions/acceptance-test-binding-evidence.js +20 -2
  458. package/packages/piagent-core/extensions/acceptance-test-bindings.js +86 -0
  459. package/packages/piagent-core/extensions/acceptance-tuple-shapes.js +12 -0
  460. package/packages/piagent-core/extensions/context-engine.js +12 -17
  461. package/packages/piagent-core/extensions/context-index-policy.js +4 -0
  462. package/packages/piagent-core/extensions/context-query-paths.js +57 -0
  463. package/packages/piagent-core/extensions/criterion-context-pack.js +109 -4
  464. package/packages/piagent-core/extensions/criterion-graph.js +4 -1
  465. package/packages/piagent-core/extensions/failure-types.ts +2 -2
  466. package/packages/piagent-core/extensions/fallback-base-policy.ts +101 -0
  467. package/packages/piagent-core/extensions/guard-types.ts +9 -1
  468. package/packages/piagent-core/extensions/piagent-guard.ts +374 -364
  469. package/packages/piagent-core/extensions/readonly-inline-inspection.ts +378 -0
  470. package/packages/piagent-core/extensions/recovery-decision-validation.ts +92 -0
  471. package/packages/piagent-core/extensions/shell-write-targets.js +15 -14
  472. package/packages/piagent-core/extensions/task-contract-view.js +4 -4
  473. package/packages/piagent-core/extensions/task-digest-migration.js +2 -2
  474. package/packages/piagent-core/extensions/task-journal.js +48 -3
  475. package/packages/piagent-core/extensions/task-lifecycle.js +32 -0
  476. package/packages/piagent-core/extensions/task-runtime-audit.js +8 -2
  477. package/packages/piagent-core/extensions/task-state.js +140 -43
  478. package/packages/piagent-core/extensions/task-terminal-disposition.js +10 -0
  479. package/packages/piagent-core/extensions/trajectory-contract.ts +5 -0
  480. package/packages/piagent-core/extensions/verification-intelligence.js +109 -20
  481. package/packages/piagent-core/extensions/workflow-catalog.ts +98 -0
  482. package/packages/piagent-core/extensions/workspace-evidence-roots.js +52 -16
  483. package/packages/piagent-core/extensions/workspace-revision.js +48 -0
  484. package/packages/piagent-core/extensions/workspace-verification-snapshot.js +13 -0
  485. package/packages/piagent-core/package.json +3 -3
  486. package/packages/piagent-core/policies/base-policy.json +43 -2
  487. package/packages/piagent-core/policy/authority-manifest.v1.json +3 -3
  488. package/packages/piagent-core/prompts/be-to-fe.md +2 -8
  489. package/packages/piagent-core/prompts/plan.md +1 -1
  490. package/packages/piagent-core/prompts/platform-improve.md +2 -6
  491. package/packages/piagent-core/prompts/review.md +2 -7
  492. package/packages/piagent-core/prompts/scout.md +1 -1
  493. package/packages/piagent-core/prompts/task.md +4 -3
  494. package/packages/piagent-core/runtime/context/adaptive-planner.ts +7 -3
  495. package/packages/piagent-core/runtime/hooks/agent-start-hook.ts +60 -59
  496. package/packages/piagent-core/runtime/hooks/agent-start-types.ts +48 -0
  497. package/packages/piagent-core/runtime/hooks/completion-hook.ts +83 -89
  498. package/packages/piagent-core/runtime/hooks/input-hook.ts +98 -7
  499. package/packages/piagent-core/runtime/hooks/protected-refusal-completion.ts +86 -0
  500. package/packages/piagent-core/runtime/hooks/session-hooks.ts +5 -2
  501. package/packages/piagent-core/runtime/hooks/session-start-hook.ts +150 -19
  502. package/packages/piagent-core/runtime/hooks/tool-result-hook.ts +111 -92
  503. package/packages/piagent-core/runtime/hooks/tool-result-metadata.ts +9 -0
  504. package/packages/piagent-core/runtime/hooks/tool-result-navigation.ts +36 -0
  505. package/packages/piagent-core/runtime/hooks/tool-result-retrieval.ts +42 -0
  506. package/packages/piagent-core/runtime/hooks/tool-result-value-helpers.ts +66 -0
  507. package/packages/piagent-core/runtime/input/chat-images.ts +1 -1
  508. package/packages/piagent-core/runtime/inspection/activity-event-adapter.ts +1 -1
  509. package/packages/piagent-core/runtime/inspection/bounded-emission-guard.ts +286 -0
  510. package/packages/piagent-core/runtime/inspection/runtime-event-store.ts +37 -7
  511. package/packages/piagent-core/runtime/inspection/same-process-bridge-proof.ts +1 -1
  512. package/packages/piagent-core/runtime/inspection/task-handoff-history.ts +2 -2
  513. package/packages/piagent-core/runtime/inspection/task-subagent-tree.ts +27 -4
  514. package/packages/piagent-core/runtime/inspection/tool-failure-classification.ts +69 -11
  515. package/packages/piagent-core/runtime/inspection/webui-snapshot.ts +104 -22
  516. package/packages/piagent-core/runtime/inspection/workspace-file-reader.ts +2 -132
  517. package/packages/piagent-core/runtime/model/provider-wire-fingerprint.ts +20 -0
  518. package/packages/piagent-core/runtime/model/service-tier-runtime.ts +242 -0
  519. package/packages/piagent-core/runtime/orchestration/helper-lifecycle.ts +16 -12
  520. package/packages/piagent-core/runtime/orchestration/minimal-delegation-policy.ts +71 -0
  521. package/packages/piagent-core/runtime/orchestration/owned-work-budget.ts +28 -20
  522. package/packages/piagent-core/runtime/orchestration/role-policy.ts +27 -9
  523. package/packages/piagent-core/runtime/orchestration/subagent-tool-policy.ts +329 -0
  524. package/packages/piagent-core/runtime/policy/block-remedy.ts +0 -4
  525. package/packages/piagent-core/runtime/policy/source-worktree-transaction.ts +75 -14
  526. package/packages/piagent-core/runtime/product/activity-inspector.ts +6 -3
  527. package/packages/piagent-core/runtime/product/edit-verifier-timing.ts +26 -0
  528. package/packages/piagent-core/runtime/product/efficiency-metrics.ts +15 -7
  529. package/packages/piagent-core/runtime/product/operator-projections.ts +8 -3
  530. package/packages/piagent-core/runtime/product/task-usage-hooks.ts +78 -0
  531. package/packages/piagent-core/runtime/product/task-usage.ts +104 -0
  532. package/packages/piagent-core/runtime/quality/edit-freshness-guard.ts +102 -0
  533. package/packages/piagent-core/runtime/quality/exact-output-contract.ts +20 -10
  534. package/packages/piagent-core/runtime/quality/performance-assurance.ts +3 -3
  535. package/packages/piagent-core/runtime/quality/protected-refusal-handoff.ts +35 -0
  536. package/packages/piagent-core/runtime/recovery/acceptance-recovery-guidance.ts +21 -0
  537. package/packages/piagent-core/runtime/recovery/continuation-budget.ts +12 -3
  538. package/packages/piagent-core/runtime/recovery/diagnostic-delivery.ts +61 -0
  539. package/packages/piagent-core/runtime/recovery/handoff-projection.ts +196 -58
  540. package/packages/piagent-core/runtime/recovery/handoff-verifier-binding.ts +24 -0
  541. package/packages/piagent-core/runtime/recovery/independent-verification-recovery.ts +79 -0
  542. package/packages/piagent-core/runtime/recovery/pristine-task-policy-refresh.ts +91 -0
  543. package/packages/piagent-core/runtime/recovery/recovery-policy.ts +31 -40
  544. package/packages/piagent-core/runtime/recovery/resume-state.ts +120 -19
  545. package/packages/piagent-core/runtime/recovery/semantic-repair-handshake.ts +7 -13
  546. package/packages/piagent-core/runtime/recovery/task-evidence-coverage-refresh.ts +217 -0
  547. package/packages/piagent-core/runtime/registration/activity-inspector-command.ts +2 -1
  548. package/packages/piagent-core/runtime/registration/context-commands.ts +28 -10
  549. package/packages/piagent-core/runtime/registration/knowledge-tools.ts +9 -5
  550. package/packages/piagent-core/runtime/registration/operator-catalogs.ts +4 -9
  551. package/packages/piagent-core/runtime/registration/operator-request-intake.ts +49 -0
  552. package/packages/piagent-core/runtime/registration/policy-tools.ts +8 -6
  553. package/packages/piagent-core/runtime/registration/session-commands.ts +10 -8
  554. package/packages/piagent-core/runtime/registration/session-wait-tool.ts +54 -0
  555. package/packages/piagent-core/runtime/registration/task-completion-tools.ts +39 -20
  556. package/packages/piagent-core/runtime/registration/task-evidence-tools.ts +21 -12
  557. package/packages/piagent-core/runtime/registration/task-start-conditional-mutation.ts +45 -0
  558. package/packages/piagent-core/runtime/registration/task-start-guidance.ts +24 -15
  559. package/packages/piagent-core/runtime/registration/task-start-manifest.ts +54 -0
  560. package/packages/piagent-core/runtime/registration/task-start-tool.ts +79 -79
  561. package/packages/piagent-core/runtime/registration/workflow-commands.ts +64 -93
  562. package/packages/piagent-core/runtime/runtime-limits.ts +16 -2
  563. package/packages/piagent-core/runtime/session/adaptive-context-analysis.ts +461 -0
  564. package/packages/piagent-core/runtime/session/adaptive-context-governor.ts +464 -0
  565. package/packages/piagent-core/runtime/session/adaptive-context-ledger.ts +265 -0
  566. package/packages/piagent-core/runtime/session/completion-signals.ts +23 -0
  567. package/packages/piagent-core/runtime/session/message-signals.ts +6 -18
  568. package/packages/piagent-core/runtime/session/operator-request-carry.ts +44 -0
  569. package/packages/piagent-core/runtime/session/retrieval-evidence-runtime.ts +188 -0
  570. package/packages/piagent-core/runtime/session/runtime-state.ts +37 -39
  571. package/packages/piagent-core/runtime/session/source-checkout-read-grants.ts +35 -0
  572. package/packages/piagent-core/runtime/session/system-prompt.ts +76 -14
  573. package/packages/piagent-core/runtime/session/task-contract-presentation.ts +39 -0
  574. package/packages/piagent-core/runtime/session/uncertain-send-continuation.ts +231 -0
  575. package/packages/piagent-core/runtime/session/usage.ts +4 -3
  576. package/packages/piagent-core/runtime/tools/apply-patch-tool.ts +6 -6
  577. package/packages/piagent-core/runtime/tools/phase-tool-runtime.ts +1 -1
  578. package/packages/piagent-core/runtime/tools/phase-tools.ts +10 -9
  579. package/packages/piagent-core/runtime/tools/session-wait.ts +42 -0
  580. package/packages/piagent-core/runtime/tools/tool-groups.ts +22 -5
  581. package/packages/piagent-core/runtime/trajectory/trajectory-runtime.ts +192 -5
  582. package/packages/piagent-core/runtime/trajectory/trajectory-types.ts +3 -2
  583. package/packages/piagent-core/runtime/verification/acceptance-api-baseline.js +488 -0
  584. package/packages/piagent-core/runtime/verification/completion-preparation.ts +22 -0
  585. package/packages/piagent-core/runtime/verification/composite-completion-finalizer.ts +105 -0
  586. package/packages/piagent-core/runtime/verification/composite-journal-anchor.ts +181 -0
  587. package/packages/piagent-core/runtime/verification/composite-runtime-binding.ts +76 -0
  588. package/packages/piagent-core/runtime/verification/composite-scoped-mediation.ts +318 -0
  589. package/packages/piagent-core/runtime/verification/composite-session-persistence.ts +175 -0
  590. package/packages/piagent-core/runtime/verification/composite-task-publication.ts +273 -0
  591. package/packages/piagent-core/runtime/verification/exact-verifier-reuse.ts +101 -0
  592. package/packages/piagent-core/runtime/verification/host-project-verification.ts +71 -0
  593. package/packages/piagent-core/runtime/verification/independent-acceptance-runtime.ts +500 -0
  594. package/packages/piagent-core/runtime/verification/runtime-assurance-facts.ts +500 -0
  595. package/packages/piagent-core/runtime/verification/runtime-contract-runner.ts +107 -0
  596. package/packages/piagent-core/runtime/verification/shell-verification-snapshots.ts +56 -0
  597. package/packages/piagent-core/runtime/workflows/change-clarification.ts +61 -0
  598. package/packages/piagent-core/runtime/workflows/input-routing.ts +21 -14
  599. package/packages/piagent-core/runtime/workflows/runtime-intake-compaction.ts +201 -0
  600. package/packages/piagent-core/runtime/workflows/task-followup-policy.ts +163 -0
  601. package/packages/piagent-core/runtime/workflows/task-intake.ts +276 -169
  602. package/packages/piagent-core/runtime/workflows/task-repair-intent.ts +67 -0
  603. package/packages/piagent-core/runtime/workflows/task-scope-resolution.ts +83 -0
  604. package/packages/piagent-core/runtime/workflows/webui-runtime-command.ts +5 -2
  605. package/packages/piagent-core/runtime/workflows/webui-workflow.ts +39 -32
  606. package/packages/piagent-core/runtime/workflows/workflow-follow-up.ts +33 -0
  607. package/packages/piagent-core/security/workspace-file-reader.ts +132 -0
  608. package/packages/piagent-core/subagents/piagent-oracle.md +5 -3
  609. package/packages/piagent-core/subagents/piagent-planner.md +6 -4
  610. package/packages/piagent-core/subagents/piagent-reviewer.md +5 -3
  611. package/packages/piagent-core/subagents/piagent-scout.md +4 -2
  612. package/packages/piagent-core/subagents/piagent-worker.md +6 -4
  613. package/packages/piagent-webui/dist/client/assets/{MarkdownMessage-CxeZqTte.js → MarkdownMessage-DGk34zJT.js} +1 -1
  614. package/packages/piagent-webui/dist/client/assets/{index-BV-_03yl.css → index-DVahUVWy.css} +1 -1
  615. package/packages/piagent-webui/dist/client/assets/index-DiKRmCEP.js +176 -0
  616. package/packages/piagent-webui/dist/client/index.html +2 -2
  617. package/packages/piagent-webui/extension/dispatch-user-entry.ts +13 -0
  618. package/packages/piagent-webui/extension/piagent-webui.ts +13 -3
  619. package/packages/piagent-webui/extension/review-controller.ts +29 -6
  620. package/packages/piagent-webui/extension/same-session-bridge.ts +7 -8
  621. package/packages/piagent-webui/extension/session-stream-adapter.ts +88 -16
  622. package/packages/piagent-webui/extension/source-mutation-controller.ts +29 -3
  623. package/packages/piagent-webui/extension/source-open-controller.ts +29 -7
  624. package/packages/piagent-webui/extension/source-revert-controller.ts +26 -3
  625. package/packages/piagent-webui/gateway/gateway-events.ts +22 -5
  626. package/packages/piagent-webui/gateway/gateway-service.ts +7 -2
  627. package/packages/piagent-webui/gateway/gateway-session-stream.ts +170 -32
  628. package/packages/piagent-webui/gateway/rpc-ui-context.ts +34 -9
  629. package/packages/piagent-webui/gateway/runtime-command-controller.ts +46 -6
  630. package/packages/piagent-webui/gateway/runtime-session-controls.ts +17 -2
  631. package/packages/piagent-webui/gateway/session-catalog.ts +9 -3
  632. package/packages/piagent-webui/gateway/session-command-controller.ts +29 -9
  633. package/packages/piagent-webui/gateway/session-effective-options.ts +2 -9
  634. package/packages/piagent-webui/gateway/session-inspection-registry.ts +11 -2
  635. package/packages/piagent-webui/gateway/session-operation-lifecycle.ts +237 -0
  636. package/packages/piagent-webui/gateway/session-operation-retry-control.ts +38 -0
  637. package/packages/piagent-webui/gateway/session-operation-settlement.ts +28 -0
  638. package/packages/piagent-webui/gateway/session-operation-watchdog.ts +9 -2
  639. package/packages/piagent-webui/gateway/session-prompt-dispatch.ts +37 -0
  640. package/packages/piagent-webui/gateway/session-runtime-close.ts +36 -0
  641. package/packages/piagent-webui/gateway/session-runtime-factory.ts +183 -6
  642. package/packages/piagent-webui/gateway/session-runtime-ownership.ts +48 -0
  643. package/packages/piagent-webui/gateway/session-runtime-state.ts +24 -0
  644. package/packages/piagent-webui/gateway/session-runtime-supervisor.ts +118 -117
  645. package/packages/piagent-webui/ownership/session-lease-store.ts +5 -2
  646. package/packages/piagent-webui/server/core-inspection-provider.ts +75 -15
  647. package/packages/piagent-webui/server/loopback-server.ts +9 -7
  648. package/packages/piagent-webui/server/terminal-delivery-receipt.ts +144 -0
  649. package/packages/piagent-webui/server/transcript-projection.ts +150 -11
  650. package/packages/piagent-webui/shared/message-correlation.ts +25 -0
  651. package/schemas/approved-host-contracts.schema.json +973 -0
  652. package/schemas/benchmark-attempt-outcome.schema.json +303 -0
  653. package/schemas/benchmark-independent-verification-plan.schema.json +34 -0
  654. package/schemas/codex-relative-efficiency-v1.schema.json +155 -0
  655. package/schemas/composite-criterion.schema.json +788 -0
  656. package/schemas/contract-family-library.schema.json +28 -0
  657. package/schemas/contract-selection-recipe.schema.json +31 -0
  658. package/schemas/failure-evidence.schema.json +2 -2
  659. package/schemas/helper-request.schema.json +16 -4
  660. package/schemas/host-contract-plan.schema.json +25 -0
  661. package/schemas/piagent-webui/gateway-protocol-v1.schema.json +16 -2
  662. package/schemas/piagent-webui/runtime-command-v1.schema.json +26 -3
  663. package/schemas/piagent-webui/runtime-event-v2.schema.json +46 -5
  664. package/schemas/piagent-webui/session-live-state-v1.schema.json +2 -0
  665. package/schemas/piagent-webui/snapshot-v1.schema.json +3 -0
  666. package/schemas/piagent-webui/source-change-v1.schema.json +12 -0
  667. package/schemas/piagent-webui/subagent-tree-v1.schema.json +11 -1
  668. package/schemas/piagent-webui/transcript-v1.schema.json +2 -1
  669. package/schemas/project-profile.schema.json +1 -1
  670. package/schemas/public-contracts/codex-mcp-metadata-v1.schema.json +206 -0
  671. package/schemas/public-contracts/codex-mcp-metadata-v2.schema.json +228 -0
  672. package/schemas/public-contracts/codex-mcp-metadata-v3.schema.json +233 -0
  673. package/schemas/public-contracts/revocation-v1.schema.json +87 -0
  674. package/schemas/public-contracts/subscription-contract-v1.schema.json +76 -0
  675. package/schemas/scoped-project-verification-receipt-v2.schema.json +83 -0
  676. package/schemas/scoped-project-verification-receipt-v3.schema.json +295 -0
  677. package/schemas/scoped-verification-receipt-v1.schema.json +76 -0
  678. package/schemas/task-contract.schema.json +45 -0
  679. package/scripts/approve-independent-verification.mjs +57 -0
  680. package/scripts/benchmark-arm-observer.mjs +320 -0
  681. package/scripts/benchmark-budget-ipc.mjs +34 -0
  682. package/scripts/benchmark-budget-launcher.mjs +91 -0
  683. package/scripts/benchmark-budget-processes.mjs +133 -0
  684. package/scripts/benchmark-budget-publication.mjs +228 -0
  685. package/scripts/benchmark-budget-runtime.mjs +136 -0
  686. package/scripts/benchmark-candidate-ablation.mjs +265 -0
  687. package/scripts/benchmark-codex-journey.mjs +406 -0
  688. package/scripts/benchmark-independent-verification.mjs +628 -0
  689. package/scripts/benchmark-journey-outcome.mjs +92 -0
  690. package/scripts/benchmark-production-v3-human-review.mjs +192 -0
  691. package/scripts/benchmark-public-input-catalog.mjs +158 -0
  692. package/scripts/benchmark-registered-plan-author.mjs +355 -0
  693. package/scripts/benchmark-registered-plan-recipe-support.mjs +85 -0
  694. package/scripts/benchmark-registered-plan-recipes-backend.mjs +165 -0
  695. package/scripts/benchmark-registered-plan-recipes-data.mjs +164 -0
  696. package/scripts/benchmark-registered-plan-recipes-platform.mjs +165 -0
  697. package/scripts/benchmark-runner-completion.mjs +133 -0
  698. package/scripts/benchmark-runner-configuration.mjs +159 -0
  699. package/scripts/benchmark-runner-core.mjs +224 -387
  700. package/scripts/benchmark-runner-finalization.mjs +144 -27
  701. package/scripts/benchmark-runner-provider-boundary.mjs +44 -0
  702. package/scripts/benchmark-runner-schedule.mjs +256 -0
  703. package/scripts/benchmark-runner-support.mjs +136 -4
  704. package/scripts/benchmark-runner.mjs +95 -18
  705. package/scripts/benchmark-scoped-broker-custody.mjs +483 -0
  706. package/scripts/benchmark-scoped-docs-verifier.mjs +203 -0
  707. package/scripts/benchmark-scoped-frozen-qualification.mjs +676 -0
  708. package/scripts/benchmark-scoped-pi-router.mjs +196 -0
  709. package/scripts/benchmark-scoped-project-verification-receipt.mjs +49 -0
  710. package/scripts/benchmark-scoped-project-verifier.mjs +461 -0
  711. package/scripts/benchmark-scoped-session-custody.mjs +599 -0
  712. package/scripts/benchmark-scoped-session-factory.mjs +342 -0
  713. package/scripts/benchmark-scoped-tool-broker.mjs +523 -0
  714. package/scripts/benchmark-scoped-verification-supervisor.mjs +773 -0
  715. package/scripts/benchmark-session-evaluator.mjs +169 -0
  716. package/scripts/benchmark-session-provider-boundary.mjs +62 -0
  717. package/scripts/benchmark-session-usage.mjs +28 -0
  718. package/scripts/benchmark-session.mjs +343 -50
  719. package/scripts/benchmark-webui-journey.mjs +678 -0
  720. package/scripts/check-public-wording.mjs +46 -0
  721. package/scripts/configure-subagents.sh +42 -34
  722. package/scripts/fs4-readiness-evaluation.mjs +7 -1
  723. package/scripts/helper-evaluation.mjs +1 -1
  724. package/scripts/phase-tools-evaluation.mjs +1 -0
  725. package/scripts/pi-auto.sh +7 -1
  726. package/scripts/pi-usage-history.mjs +201 -11
  727. package/scripts/piagent-cli.mjs +8 -0
  728. package/scripts/private-holdout-readiness.mjs +7 -1
  729. package/scripts/public-evaluation-exposure.mjs +140 -0
  730. package/scripts/select-independent-verification.mjs +62 -0
  731. package/scripts/team-doctor.sh +1 -1
  732. package/scripts/typescript-loader.mjs +135 -1
  733. package/scripts/update-global.mjs +6 -7
  734. package/scripts/verify-local.sh +41 -55
  735. package/scripts/verify-release-identity.mjs +5 -3
  736. package/packages/piagent-webui/dist/client/assets/index-DynIMe8I.js +0 -176
@@ -0,0 +1,735 @@
1
+ import { parse as parseByteEvidence } from "@babel/parser";
2
+ import { testProofIntrinsicsAreStable, literalArrayIterationEnvironmentIsStable } from "./acceptance-executable-evidence.js";
3
+
4
+ function escapeRegex(value) {
5
+ return String(value ?? "").replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
6
+ }
7
+
8
+ export function callArgumentNames(slice) {
9
+ const body = slice.slice(slice.indexOf("(") + 1, -1);
10
+ return [...body.matchAll(/(?:^|,)\s*([a-z_$][a-z0-9_$]*)\s*(?=,|$)/gi)].map((match) => match[1]);
11
+ }
12
+
13
+ export function boundStringValue(token, strings) {
14
+ const index = Number(String(token ?? "").match(/^__pi_bound_string_(\d+)__$/)?.[1]);
15
+ return Number.isInteger(index) ? strings[index] : undefined;
16
+ }
17
+
18
+ export function exactBoundValue(expression, strings) {
19
+ const value = String(expression ?? "").trim();
20
+ if (value === "true") return true;
21
+ if (value === "false") return false;
22
+ return boundStringValue(value, strings);
23
+ }
24
+
25
+ export function splitTopLevel(value) {
26
+ const parts = [];
27
+ let start = 0, round = 0, square = 0, curly = 0;
28
+ for (let index = 0; index < value.length; index += 1) {
29
+ const token = value[index];
30
+ if (token === "(") round += 1;
31
+ else if (token === ")") round -= 1;
32
+ else if (token === "[") square += 1;
33
+ else if (token === "]") square -= 1;
34
+ else if (token === "{") curly += 1;
35
+ else if (token === "}") curly -= 1;
36
+ else if (token === "," && round === 0 && square === 0 && curly === 0) {
37
+ parts.push(value.slice(start, index).trim()); start = index + 1;
38
+ }
39
+ }
40
+ parts.push(value.slice(start).trim());
41
+ return parts;
42
+ }
43
+
44
+ // These are deliberately restricted dataflow facts, not an evaluator. Unknown
45
+ // expressions, escaping references and control-flow scopes remain unproven.
46
+ export function braceScope(code, position) {
47
+ const scope = [];
48
+ for (let index = 0; index < position; index += 1) {
49
+ if (code[index] === "{") scope.push(index);
50
+ else if (code[index] === "}") scope.pop();
51
+ }
52
+ return scope;
53
+ }
54
+
55
+ export function sameScope(left, right) {
56
+ return left.length === right.length && left.every((value, index) => value === right[index]);
57
+ }
58
+
59
+ export function unconditionalEvidenceScope(code, position) {
60
+ const scope = braceScope(code, position);
61
+ const bodyPrefix = code.slice((scope.at(-1) ?? -1) + 1, position);
62
+ return scope.every((open) => (
63
+ /\b(?:test|it)\s*\(\s*__pi_bound_string_\d+__\s*,\s*(?:async\s*)?(?:\([^()]*\)\s*=>|function\s*\([^()]*\))\s*$/.test(code.slice(0, open))
64
+ )) && !/(?:&&|\|\||\?|=>|\b(?:if|for|while|switch|return|throw|break|continue|try|catch|finally|function)\b)|\bprocess\s*\.\s*(?:exit|abort)\s*\(/.test(bodyPrefix);
65
+ }
66
+
67
+ export function constantDeclarations(code) {
68
+ const declarations = [];
69
+ for (const match of code.matchAll(/\b(const|let|var)\s+([a-z_$][a-z0-9_$]*)\s*=(?!=|>)/gi)) {
70
+ const start = match.index + match[0].length;
71
+ let round = 0, square = 0, curly = 0;
72
+ for (let end = start; end < code.length; end += 1) {
73
+ const token = code[end];
74
+ if (token === "(") round += 1;
75
+ if (token === ")") round -= 1;
76
+ if (token === "[") square += 1;
77
+ if (token === "]") square -= 1;
78
+ if (token === "{") curly += 1;
79
+ if (token === "}") curly -= 1;
80
+ if (round < 0 || square < 0 || curly < 0) break;
81
+ if (token === ";" && round === 0 && square === 0 && curly === 0) {
82
+ const pieces = splitTopLevel(code.slice(start, end));
83
+ const records = []; let cursor = start;
84
+ for (const [index, piece] of pieces.entries()) {
85
+ const offset = code.indexOf(piece, cursor), next = offset + piece.length;
86
+ const item = index === 0 ? { name: match[2], expression: piece }
87
+ : (() => { const value = /^([a-z_$][a-z0-9_$]*)\s*=(?!=|>)\s*([\s\S]+)$/i.exec(piece);
88
+ return value ? { name: value[1], expression: value[2] } : null; })();
89
+ if (!item || offset < cursor) { records.length = 0; break; }
90
+ records.push({ kind: match[1], ...item, start: index === 0 ? match.index : offset,
91
+ end: index === pieces.length - 1 ? end + 1 : next + 1, scope: braceScope(code, match.index) });
92
+ cursor = next + 1;
93
+ }
94
+ declarations.push(...records);
95
+ break;
96
+ }
97
+ }
98
+ }
99
+ return declarations;
100
+ }
101
+
102
+ export function literalBinding(call, name, before, seen = new Set()) {
103
+ if (seen.has(name)) return undefined;
104
+ const scope = braceScope(call.code, before);
105
+ const candidates = call.declarations.filter((entry) => entry.name === name && entry.end <= before
106
+ && entry.scope.every((open, index) => scope[index] === open));
107
+ const declaration = candidates.sort((left, right) => left.scope.length - right.scope.length || left.start - right.start).at(-1);
108
+ if (!declaration || declaration.kind !== "const") return undefined;
109
+ // A callback parameter can shadow an outer declaration without another const.
110
+ if (scope.some((open) => new RegExp(`(?:\\(|,)\\s*${escapeRegex(name)}\\s*(?:,|\\))`).test(
111
+ call.code.slice(Math.max(0, open - 160), open)))) return undefined;
112
+ const nextSeen = new Set([...seen, name]);
113
+ const value = literalExpression(call, declaration.expression, declaration.start, nextSeen);
114
+ if (!value) return undefined;
115
+ // Permit only independent shallow-copy declarations before the use. Any
116
+ // mutation, reassignment, alias, unknown call, or other escape makes it unknown.
117
+ let between = call.code.slice(declaration.end, before);
118
+ for (const copy of call.declarations.filter((entry) => entry.start >= declaration.end && entry.end <= before)) {
119
+ if (copy.kind === "const" && new RegExp(`^(?:\\[\\s*\\.\\.\\.\\s*${escapeRegex(name)}\\s*\\]|\\{\\s*\\.\\.\\.\\s*${escapeRegex(name)}\\s*\\})$`).test(copy.expression)) {
120
+ const offset = copy.start - declaration.end;
121
+ between = between.slice(0, offset) + " ".repeat(copy.end - copy.start) + between.slice(copy.end - declaration.end);
122
+ }
123
+ }
124
+ if (new RegExp(`\\b${escapeRegex(name)}\\b`).test(between)) return undefined;
125
+ return { ...value, declaration };
126
+ }
127
+
128
+ function literalExpression(call, expression, before, seen = new Set()) {
129
+ const value = expression.trim();
130
+ const bound = exactBoundValue(value, call.strings);
131
+ if (bound !== undefined) return { kind: "primitive", value: bound };
132
+ if (/^(?:null|undefined|[-+]?\d+(?:\.\d+)?n?)$/.test(value)) return { kind: "primitive" };
133
+ if (/^[a-z_$][a-z0-9_$]*$/i.test(value)) {
134
+ const resolved = literalBinding(call, value, before, seen);
135
+ return resolved?.kind === "primitive" ? resolved : undefined;
136
+ }
137
+ const spread = value.match(/^(\[|\{)\s*\.\.\.\s*([a-z_$][a-z0-9_$]*)\s*(\]|\})$/i);
138
+ if (spread) {
139
+ const source = literalBinding(call, spread[2], before, seen);
140
+ return source?.kind === (spread[1] === "[" ? "array" : "object") ? source : undefined;
141
+ }
142
+ if (value.startsWith("[") && value.endsWith("]")) {
143
+ const elements = splitTopLevel(value.slice(1, -1)).filter((item) => item !== "")
144
+ .map((item) => literalExpression(call, item, before, seen));
145
+ return elements.every((item) => item?.kind === "primitive") ? { kind: "array", elements } : undefined;
146
+ }
147
+ if (value.startsWith("{") && value.endsWith("}")) {
148
+ const entries = splitTopLevel(value.slice(1, -1)).filter((item) => item !== "");
149
+ return entries.every((entry) => {
150
+ const property = entry.match(/^([a-z_$][a-z0-9_$]*|__pi_bound_string_\d+__)\s*:\s*([\s\S]+)$/i);
151
+ return property && property[1] !== "__proto__" && boundStringValue(property[1], call.strings) !== "__proto__"
152
+ && literalExpression(call, property[2], before, seen)?.kind === "primitive";
153
+ }) ? { kind: "object" } : undefined;
154
+ }
155
+ return undefined;
156
+ }
157
+
158
+ export function flatObjectSnapshot(call, argument, assertionComparisons) {
159
+ const escaped = escapeRegex(argument);
160
+ if (call.safeScope && literalBinding(call, argument, call.start)?.kind === "object") {
161
+ const scope = braceScope(call.code, call.start);
162
+ const snapshot = call.declarations.filter((entry) => entry.kind === "const" && entry.end <= call.start
163
+ && sameScope(entry.scope, scope)
164
+ && new RegExp(`^\\{\\s*\\.\\.\\.\\s*${escaped}\\s*\\}$`).test(entry.expression)).at(-1);
165
+ if (snapshot && !new RegExp(`\\b${escapeRegex(snapshot.name)}\\b`).test(call.code.slice(snapshot.end, call.start))) {
166
+ const comparison = call.scopedAssertions.find((entry) => entry.start >= call.end
167
+ && assertionComparisons({ ...call, assertions: [entry.code] }).some(({ actual, expected }) => (
168
+ actual.trim() === argument && expected.trim() === snapshot.name
169
+ )));
170
+ if (comparison && !new RegExp(`\\b(?:${escaped}|${escapeRegex(snapshot.name)})\\b`).test(call.code.slice(call.end, comparison.start))) {
171
+ return { name: snapshot.name };
172
+ }
173
+ }
174
+ return { name: undefined };
175
+ }
176
+ return undefined;
177
+ }
178
+
179
+
180
+ function snapshotIntrinsicsStable(call) {
181
+ const code = call.code.replace(/__pi_bound_string_\d+__/g, token => {
182
+ const value = boundStringValue(token, call.strings);
183
+ return /^node:assert(?:\/strict)?$/.test(value ?? "") ? "__pi_node_assert_module_literal__"
184
+ : value === "node:test" ? "__pi_node_test_module_literal__" : "__pi_string_literal__";
185
+ });
186
+ if (!/\bimport\s+(?:\*\s+as\s+)?assert\s+from\s+__pi_node_assert_module_literal__/.test(code)
187
+ || call.declarations.some(entry => entry.name === "assert") || /\b(?:function|class)\s+assert\b/.test(code)) return false;
188
+ const views = [code, ...(call.sourceEntries ?? []).map(entry => entry.evidenceText ?? entry.text)];
189
+ for (const view of views) {
190
+ if (typeof view !== "string" || view.length > 64_000 || !testProofIntrinsicsAreStable(view.toLowerCase()) || !literalArrayIterationEnvironmentIsStable(view)
191
+ || /\b(?:globalThis|global|self|this|eval|createRequire)\b|\.\s*constructor\b|__pi_(?:code_generation|module_loader)_module_literal__/.test(view)) return false;
192
+ for (const match of view.matchAll(/\bstructuredClone\b/g)) {
193
+ if (!/^\s*\(/.test(view.slice(match.index + match[0].length))
194
+ || /(?:\.|\bfunction)\s*$/.test(view.slice(0, match.index))) return false;
195
+ }
196
+ for (const match of view.matchAll(/\bJSON\b/g)) if (!/^\.(?:parse|stringify)\s*\(/.test(view.slice(match.index + 4))) return false;
197
+ }
198
+ return /__pi_node_assert_module_literal__/.test(code);
199
+ }
200
+
201
+ function ownSnapshotData(call, argument, before) {
202
+ const scope = braceScope(call.code, before);
203
+ const declaration = call.declarations.filter(entry => entry.name === argument && entry.kind === "const"
204
+ && entry.end <= before && sameScope(entry.scope, scope)).at(-1);
205
+ if (!declaration || new RegExp(`\\b${escapeRegex(argument)}\\b`).test(call.code.slice(declaration.end, before))) return false;
206
+ const literal = (expression, depth = 0) => {
207
+ if (depth > 12) return false;
208
+ const value = expression.trim();
209
+ if (exactBoundValue(value, call.strings) !== undefined || /^(?:null|[-+]?\d+(?:\.\d+)?)$/.test(value)) return true;
210
+ if (value.startsWith("[") && value.endsWith("]")) {
211
+ const items = splitTopLevel(value.slice(1, -1)); if (items.at(-1) === "") items.pop();
212
+ return items.length <= 128 && items.every(item => item && literal(item, depth + 1));
213
+ }
214
+ if (value.startsWith("{") && value.endsWith("}")) {
215
+ const fields = splitTopLevel(value.slice(1, -1)); if (fields.at(-1) === "") fields.pop();
216
+ const seen = new Set();
217
+ return fields.length <= 128 && fields.every(field => {
218
+ const part = /^([a-z_$][a-z0-9_$]*|__pi_bound_string_\d+__)\s*:\s*([\s\S]+)$/i.exec(field);
219
+ if (!part) return false;
220
+ const key = boundStringValue(part[1], call.strings) ?? part[1];
221
+ if (key === "__proto__" || key.includes("\\") || seen.has(key)) return false;
222
+ seen.add(key); return literal(part[2], depth + 1);
223
+ });
224
+ }
225
+ return false;
226
+ };
227
+ return literal(declaration.expression);
228
+ }
229
+
230
+ // Snapshot identity must survive from capture to the live comparison. A passing
231
+ // test can otherwise edit the expected snapshot to conceal a real input write.
232
+ export function stableDeepSnapshot(call, argument, snapshotName, assertionComparisons) {
233
+ if (!call.safeScope || !snapshotIntrinsicsStable(call)) return false;
234
+ const scope = braceScope(call.code, call.start), escaped = escapeRegex(argument);
235
+ const expression = new RegExp(`^(?:structuredClone\\s*\\(\\s*${escaped}\\s*\\)|JSON\\.parse\\s*\\(\\s*JSON\\.stringify\\s*\\(\\s*${escaped}\\s*\\)\\s*\\))$`);
236
+ const snapshot = call.declarations.filter(entry => entry.kind === "const" && entry.name === snapshotName
237
+ && entry.end <= call.start && sameScope(entry.scope, scope) && expression.test(entry.expression)).at(-1);
238
+ if (!snapshot || !unconditionalEvidenceScope(call.code, snapshot.start) || !ownSnapshotData(call, argument, snapshot.start)) return false;
239
+ const mentionsSnapshot = new RegExp(`\\b${escapeRegex(snapshotName)}\\b`);
240
+ if (mentionsSnapshot.test(call.code.slice(snapshot.end, call.start)) || mentionsSnapshot.test(call.slice)) return false;
241
+ let beforeCall = call.code.slice(snapshot.end, call.start);
242
+ for (const copy of call.declarations.filter(entry => entry.kind === "const" && entry.start >= snapshot.end && entry.end <= call.start
243
+ && sameScope(entry.scope, scope) && new RegExp(`^\\[\\s*\\.\\.\\.\\s*${escaped}\\s*\\]$`).test(entry.expression))) {
244
+ const offset = copy.start - snapshot.end;
245
+ beforeCall = beforeCall.slice(0, offset) + " ".repeat(copy.end - copy.start) + beforeCall.slice(copy.end - snapshot.end);
246
+ }
247
+ if (new RegExp(`\\b${escaped}\\b`).test(beforeCall)) return false;
248
+ const comparisons = call.scopedAssertions.filter(entry => entry.start >= call.end
249
+ && assertionComparisons({ ...call, assertions: [entry.code] }).some(({actual, expected}) =>
250
+ actual.trim() === argument && expected.trim() === snapshotName));
251
+ for (const comparison of comparisons) {
252
+ const comparisonOpen = comparison.code.indexOf("("), argumentsList = splitTopLevel(comparison.code.slice(comparisonOpen + 1, -1));
253
+ if (!/^assert\.(?:deepEqual|deepStrictEqual|strictEqual)\s*\(/.test(comparison.code)
254
+ || argumentsList.length < 2 || argumentsList.length > 3
255
+ || argumentsList.length === 3 && typeof exactBoundValue(argumentsList[2], call.strings) !== "string") continue;
256
+ const between = call.code.slice(call.end, comparison.start);
257
+ if (mentionsSnapshot.test(between)) continue;
258
+ // Only read-only assertions may intervene. Reject writes and unknown calls,
259
+ // including calls through a pre-existing alias which could restore the input.
260
+ let remaining = between;
261
+ for (const check of call.scopedAssertions.filter(entry => entry.start >= call.end && entry.end <= comparison.start)) {
262
+ if (!/^assert\.(?:equal|strictEqual|deepEqual|deepStrictEqual|notEqual|notStrictEqual)\s*\(/.test(check.code)
263
+ || /(?:\+\+|--|=(?!=|>)|\b(?:delete|new|await)\b)/.test(check.code)
264
+ || /\([^()]*\(/.test(check.code)) continue;
265
+ remaining = remaining.replace(check.code, " ".repeat(check.code.length));
266
+ }
267
+ const containing = call.scopedAssertions.find(entry => entry.start < call.start && entry.end >= call.end);
268
+ if (containing) {
269
+ const pair = assertionComparisons({ ...call, assertions: [containing.code] }).find(item => item.actual.trim() === call.slice);
270
+ const primitive = pair && (exactBoundValue(pair.expected, call.strings) !== undefined || /^(?:null|[-+]?\d+(?:\.\d+)?)$/.test(pair.expected));
271
+ const indices = pair && /^\[[\s\S]*\]$/.test(pair.expected)
272
+ && splitTopLevel(pair.expected.slice(1, -1)).every(item => new RegExp(`^${escaped}\\[\\d+\\]$`).test(item));
273
+ if (!primitive && !indices) continue;
274
+ remaining = remaining.slice(containing.end - call.end);
275
+ }
276
+ if (remaining.replace(/[;\s]/g, "")) continue;
277
+ return true;
278
+ }
279
+ return false;
280
+ }
281
+
282
+ // Bounded fresh flat-object factories used by test data. These facts do not
283
+ // evaluate statements, arithmetic, getters, arbitrary calls or hidden aliases.
284
+ export function flatRecordFactories(ast, nested = false) {
285
+ const factories = new Map();
286
+ for (const statement of ast.program.body) {
287
+ if (statement.type !== "VariableDeclaration" || statement.kind !== "const") continue;
288
+ for (const declaration of statement.declarations) {
289
+ const fn = declaration.init, parameter = fn?.params?.[0];
290
+ if (nested && declaration.id.type === "Identifier" && fn?.type === "ArrowFunctionExpression" && !fn.async
291
+ && fn.params.length === 0 && fn.body.type === "ObjectExpression") {
292
+ factories.set(declaration.id.name, factories.has(declaration.id.name) ? null : {declaration,parameter:null,base:fn.body}); continue;
293
+ }
294
+ if (declaration.id.type !== "Identifier" || fn?.type !== "ArrowFunctionExpression" || fn.async || fn.params.length !== 1
295
+ || parameter.type !== "AssignmentPattern" || parameter.left.type !== "Identifier" || parameter.right.type !== "ObjectExpression"
296
+ || parameter.right.properties.length !== 0 || fn.body.type !== "ObjectExpression") continue;
297
+ const spread = fn.body.properties.at(-1);
298
+ if (spread?.type !== "SpreadElement" || spread.argument.type !== "Identifier" || spread.argument.name !== parameter.left.name
299
+ || fn.body.properties.slice(0,-1).some(node => node.type !== "ObjectProperty" || node.computed || node.method)) continue;
300
+ if (factories.has(declaration.id.name)) { factories.set(declaration.id.name,null); continue; }
301
+ factories.set(declaration.id.name,{declaration,parameter:parameter.left.name,base:{type:"ObjectExpression",properties:fn.body.properties.slice(0,-1)}});
302
+ }
303
+ }
304
+ return factories;
305
+ }
306
+ export function flatRecordValue(node, bindings = new Map(), factories = new Map(), before = Infinity, depth = 0, nested = false) {
307
+ if (!node || depth > 6) return undefined;
308
+ if (["NumericLiteral","StringLiteral","BooleanLiteral","NullLiteral"].includes(node.type)) return {kind:"primitive",value:node.type === "NullLiteral" ? null : node.value};
309
+ if (node.type === "Identifier") {
310
+ if (bindings.has(node.name)) return bindings.get(node.name);
311
+ if (["NaN","Infinity","undefined"].includes(node.name)) return {kind:"primitive",value:node.name === "NaN" ? NaN : node.name === "Infinity" ? Infinity : undefined};
312
+ }
313
+ if (node.type === "UnaryExpression" && ["+","-"].includes(node.operator)) {
314
+ const input = flatRecordValue(node.argument,bindings,factories,before,depth+1,nested);
315
+ return input?.kind === "primitive" && typeof input.value === "number" ? {kind:"primitive",value:node.operator === "-" ? -input.value : input.value} : undefined;
316
+ }
317
+ if (node.type === "ArrayExpression" && (node.elements.length === 0 || nested && node.elements.length <= 32)) {
318
+ const elements = node.elements.map(item=>flatRecordValue(item,bindings,factories,before,depth+1,nested));
319
+ return elements.every(Boolean) ? {kind:"array",elements} : undefined;
320
+ }
321
+ if (node.type === "ObjectExpression" && node.properties.length <= 32) {
322
+ const fields = new Map();
323
+ for (const property of node.properties) {
324
+ if (property.type !== "ObjectProperty" || property.method) return undefined;
325
+ const key = !property.computed && property.key.type === "Identifier" ? property.key.name
326
+ : flatRecordValue(property.key,bindings,factories,before,depth+1,nested)?.value;
327
+ const value = flatRecordValue(property.value,bindings,factories,before,depth+1,nested);
328
+ if (typeof key !== "string" || ["__proto__","constructor","prototype"].includes(key) || fields.has(key) || !value || !(nested ? ["primitive","record","array"].includes(value.kind) : value.kind === "primitive")) return undefined;
329
+ fields.set(key,value);
330
+ }
331
+ return {kind:"record",fields};
332
+ }
333
+ if (node.type === "CallExpression" && node.callee.type === "Identifier" && node.arguments.length <= 1) {
334
+ const factory = factories.get(node.callee.name);
335
+ if (!factory || factory.declaration.end > before || factory.parameter === null && node.arguments.length !== 0) return undefined;
336
+ const base = flatRecordValue(factory.base,new Map(),new Map(),before,depth+1,nested);
337
+ const supplied = node.arguments.length ? flatRecordValue(node.arguments[0],bindings,factories,before,depth+1,nested) : {kind:"record",fields:new Map()};
338
+ const changes = supplied?.kind === "primitive" && supplied.value === undefined ? {kind:"record",fields:new Map()} : supplied;
339
+ if (base?.kind !== "record" || changes?.kind !== "record") return undefined;
340
+ return {kind:"record",fields:new Map([...base.fields,...changes.fields])};
341
+ }
342
+ return undefined;
343
+ }
344
+
345
+ const byteMember = node => node?.type === "Identifier" ? node.name : node?.type === "MemberExpression" && !node.computed
346
+ ? `${byteMember(node.object)}.${node.property.name}` : null;
347
+ function walkByteEvidence(node, visit, parent, grandparent, depth = 0, budget = { count: 0 }) {
348
+ if (!node || typeof node.type !== "string") return;
349
+ if (++budget.count > 12_000 || depth > 128) throw new Error("byte-evidence-budget");
350
+ visit(node, parent, grandparent);
351
+ for (const [key, value] of Object.entries(node)) {
352
+ if (["loc", "extra", "comments", "tokens", "errors"].includes(key)) continue;
353
+ if (Array.isArray(value)) value.forEach(item => walkByteEvidence(item, visit, node, parent, depth + 1, budget));
354
+ else if (value && typeof value === "object") walkByteEvidence(value, visit, node, parent, depth + 1, budget);
355
+ }
356
+ }
357
+ // Input aliases may only enter native byte decoding. All stores target owned
358
+ // locals; unknown calls, native escapes and alternate writes remain unproved.
359
+ function readOnlyByteSource(entries, binding) {
360
+ try {
361
+ const selected = entries.filter(entry => entry.path === binding.sourcePath);
362
+ if (selected.length !== 1 || entries.length !== 1 || selected[0].text.length > 64_000) return false;
363
+ const ast = parseByteEvidence(selected[0].text, { sourceType: "module" });
364
+ if (ast.program.body.length !== 1) return false;
365
+ const exported = ast.program.body[0], fn = exported.declaration;
366
+ if (exported.type !== "ExportNamedDeclaration" || fn?.type !== "FunctionDeclaration" || fn.async || fn.generator
367
+ || fn.id?.name !== binding.sourceName || fn.params.length !== 1 || fn.params[0].type !== "Identifier") return false;
368
+ const parents = new WeakMap(), scopes = new Map([[fn.id.name, [fn]]]);
369
+ walkByteEvidence(fn, (node, parent) => { if (parent) parents.set(node, parent); });
370
+ const enclosing = node => { for (let at = parents.get(node); at; at = parents.get(at)) if (["BlockStatement", "ForOfStatement", "ForStatement"].includes(at.type)) return at; return fn; };
371
+ const bind = (name, scope) => scopes.set(name, [...(scopes.get(name) ?? []), scope]);
372
+ const inScope = (node, name) => { for (let at = node; at; at = parents.get(at)) if ((scopes.get(name) ?? []).includes(at)) return true; return false; };
373
+ bind(fn.params[0].name, fn);
374
+ const input = fn.params[0].name, native = new Set(["Array", "Uint8Array", "TextDecoder", "JSON", "TypeError", "Error"]);
375
+ const locals = new Set([input, fn.id.name]), elements = new Set(), decoders = new Set(), helpers = new Set(), permitted = new Set([fn.params[0]]);
376
+ walkByteEvidence(fn.body, (node, parent) => {
377
+ if (node.type === "VariableDeclarator") {
378
+ if (node.id.type !== "Identifier" || native.has(node.id.name) || node.id.name === input) throw new Error("byte-local");
379
+ locals.add(node.id.name); bind(node.id.name, enclosing(node));
380
+ if (node.init?.type === "NewExpression" && node.init.callee.name === "TextDecoder") decoders.add(node.id.name);
381
+ if (node.init?.type === "ArrowFunctionExpression") helpers.add(node.id.name);
382
+ }
383
+ if (/Function/.test(node.type) && node.params) for (const param of node.params) {
384
+ const name = param.type === "Identifier" ? param.name : param.type === "AssignmentPattern" && param.left.type === "Identifier" ? param.left.name : null;
385
+ if (!name || native.has(name) || name === input) throw new Error("byte-parameter"); locals.add(name); bind(name, node);
386
+ }
387
+ if (node.type === "ForOfStatement" && node.right.type === "Identifier" && node.right.name === input) {
388
+ const declaration = node.left?.declarations?.[0];
389
+ if (node.await || node.left.type !== "VariableDeclaration" || node.left.kind !== "const" || node.left.declarations.length !== 1 || declaration.id.type !== "Identifier") throw new Error("byte-loop");
390
+ elements.add(declaration.id.name); permitted.add(node.right); permitted.add(declaration.id);
391
+ }
392
+ if (node.type === "CallExpression" && byteMember(node.callee) === `${input}.some`) {
393
+ const callback = node.arguments[0], predicate = callback?.body?.argument;
394
+ if (node.arguments.length !== 1 || callback?.type !== "ArrowFunctionExpression" || callback.async || callback.params.length !== 1
395
+ || callback.params[0].type !== "Identifier" || callback.body.type !== "UnaryExpression" || callback.body.operator !== "!"
396
+ || predicate?.type !== "BinaryExpression" || predicate.operator !== "instanceof" || predicate.left.name !== callback.params[0].name || predicate.right.name !== "Uint8Array") throw new Error("byte-shape");
397
+ elements.add(callback.params[0].name); permitted.add(node.callee.object); permitted.add(callback.params[0]); permitted.add(predicate.left);
398
+ }
399
+ if (node.type === "CallExpression" && byteMember(node.callee) === "Array.isArray" && node.arguments.length === 1 && node.arguments[0].name === input) permitted.add(node.arguments[0]);
400
+ });
401
+ if (!elements.size || decoders.size !== 1) return false;
402
+ const decoder = [...decoders][0];
403
+ walkByteEvidence(fn, (node, parent, grandparent) => {
404
+ if (node.type === "Identifier" && (node.name === input || elements.has(node.name))) {
405
+ const nativeRead = parent?.type === "CallExpression" && byteMember(parent.callee) === `${decoder}.decode`
406
+ && parent.arguments[0] === node && elements.has(node.name);
407
+ if (!permitted.has(node) && !nativeRead) throw new Error("byte-input-escape");
408
+ }
409
+ if (node.type === "Identifier" && native.has(node.name)) {
410
+ const allowed = node.name === "TextDecoder" && parent?.type === "NewExpression" && parent.callee === node
411
+ || ["TypeError", "Error"].includes(node.name) && parent?.type === "NewExpression" && parent.callee === node
412
+ || node.name === "Uint8Array" && parent?.type === "BinaryExpression" && parent.operator === "instanceof" && parent.right === node
413
+ || ["Array", "JSON"].includes(node.name) && parent?.type === "MemberExpression" && parent.object === node
414
+ && grandparent?.type === "CallExpression" && grandparent.callee === parent && ["Array.isArray", "JSON.parse"].includes(byteMember(parent));
415
+ if (!allowed) throw new Error("byte-native-escape");
416
+ }
417
+ if (node.type === "Identifier" && node.name === decoder && !(parent?.type === "VariableDeclarator" && parent.id === node)
418
+ && !(parent?.type === "MemberExpression" && parent.object === node && byteMember(parent) === `${decoder}.decode`
419
+ && grandparent?.type === "CallExpression" && grandparent.callee === parent)) throw new Error("byte-decoder-escape");
420
+ if (["AssignmentExpression", "UpdateExpression"].includes(node.type)) {
421
+ const target = node.left ?? node.argument;
422
+ if (target.type !== "Identifier" || !locals.has(target.name) || [input, decoder, ...elements, ...helpers, fn.id.name].includes(target.name)) throw new Error("byte-store");
423
+ }
424
+ if (node.type === "UnaryExpression" && node.operator === "delete" || ["ThisExpression", "AwaitExpression", "YieldExpression"].includes(node.type)
425
+ || node.type === "MemberExpression" && (node.computed || ["prototype", "constructor", "__proto__"].includes(node.property.name))) throw new Error("byte-reflection");
426
+ if (node.type === "NewExpression" && !["TextDecoder", "TypeError", "Error"].includes(node.callee.name)) throw new Error("byte-constructor");
427
+ if (node.type === "CallExpression") {
428
+ const member = byteMember(node.callee);
429
+ const localMethod = node.callee.type === "MemberExpression" && locals.has(node.callee.object.name)
430
+ && ![input, ...elements, decoder].includes(node.callee.object.name) && ["split", "pop", "push", "endsWith", "slice"].includes(node.callee.property.name);
431
+ if (!helpers.has(node.callee.name) && !["Array.isArray", "JSON.parse", `${input}.some`, `${decoder}.decode`].includes(member) && !localMethod) throw new Error("byte-call");
432
+ }
433
+ if (node.type === "Identifier" && !inScope(node, node.name) && !native.has(node.name)
434
+ && !(parent?.type === "MemberExpression" && parent.property === node && !parent.computed)
435
+ && !(parent?.type === "ObjectProperty" && parent.key === node && !parent.computed)) throw new Error("byte-free-name");
436
+ });
437
+ return true;
438
+ } catch { return false; }
439
+ }
440
+ function byteSnapshotProgram(profile, binding) {
441
+ if (!testProofIntrinsicsAreStable(profile.evidenceCode) || !literalArrayIterationEnvironmentIsStable(profile.evidenceCode)) return null;
442
+ try {
443
+ const ast = parseByteEvidence(profile.raw, { sourceType: "module" }), imports = ast.program.body.filter(node => node.type === "ImportDeclaration");
444
+ const local = module => imports.filter(node => node.source.value === module).flatMap(node => node.specifiers.filter(item => item.type === "ImportDefaultSpecifier").map(item => item.local.name));
445
+ const asserts = [...local("node:assert/strict"), ...local("node:assert")], runners = local("node:test");
446
+ if (imports.length !== 3 || asserts.length !== 1 || runners.length !== 1) return null;
447
+ const assertName = asserts[0], testName = runners[0], native = new Set(["Array", "ArrayBuffer", "Uint8Array", "TextEncoder"]), encoders = new Set(), registrations = [];
448
+ for (const statement of ast.program.body) {
449
+ if (statement.type === "ImportDeclaration") continue;
450
+ if (statement.type === "VariableDeclaration" && statement.kind === "const" && statement.declarations.length === 1) {
451
+ const declaration = statement.declarations[0], fn = declaration.init, call = fn?.body, owner = call?.callee?.object;
452
+ if (declaration.id.type !== "Identifier" || fn?.type !== "ArrowFunctionExpression" || fn.async || fn.params.length !== 1 || fn.params[0].type !== "Identifier"
453
+ || call?.type !== "CallExpression" || call.callee.type !== "MemberExpression" || call.callee.computed || call.callee.property.name !== "encode"
454
+ || owner?.type !== "NewExpression" || owner.callee.name !== "TextEncoder" || owner.arguments.length !== 0
455
+ || call.arguments.length !== 1 || call.arguments[0].name !== fn.params[0].name) return null;
456
+ encoders.add(declaration.id.name); continue;
457
+ }
458
+ const call = statement.type === "ExpressionStatement" ? statement.expression : null;
459
+ if (call?.type !== "CallExpression" || call.callee.name !== testName || call.arguments.length !== 2 || call.arguments[0].type !== "StringLiteral"
460
+ || call.arguments[1].type !== "ArrowFunctionExpression" || call.arguments[1].async || call.arguments[1].params.length !== 0 || call.arguments[1].body.type !== "BlockStatement") return null;
461
+ registrations.push(call.arguments[1].body);
462
+ }
463
+ if (!encoders.size) return null;
464
+ const protectedNames = new Set([...native, assertName, testName, binding.testName, ...encoders]);
465
+ walkByteEvidence(ast, (node, parent, grandparent) => {
466
+ if (node.type === "ImportDeclaration" || parent?.type === "ImportDefaultSpecifier" || parent?.type === "ImportSpecifier") return;
467
+ if (node.type === "AssignmentExpression" || node.type === "UnaryExpression" && node.operator === "delete") throw new Error("byte-test-store");
468
+ if (node.type === "UpdateExpression" && (node.argument.type !== "Identifier" || protectedNames.has(node.argument.name))) throw new Error("byte-test-update");
469
+ if (node.type === "MemberExpression" && (["prototype", "constructor", "__proto__"].includes(node.property.name)
470
+ || node.computed && node.property.type !== "NumericLiteral")) throw new Error("byte-test-reflection");
471
+ if (node.type === "Identifier" && ["globalThis", "global", "process", "Reflect", "Proxy", "Function", "eval", "Symbol", "Object"].includes(node.name)) throw new Error("byte-test-global");
472
+ if (node.type === "Identifier" && native.has(node.name)) {
473
+ if (!(node.name === "Array" && parent?.type === "MemberExpression" && parent.object === node && byteMember(parent) === "Array.from"
474
+ && grandparent?.type === "CallExpression" && grandparent.callee === parent)
475
+ && !(node.name !== "Array" && parent?.type === "NewExpression" && parent.callee === node)) throw new Error("byte-test-native");
476
+ }
477
+ if (/Function/.test(node.type) && node.params?.some(param => param.type !== "Identifier" || protectedNames.has(param.name))) throw new Error("byte-test-parameter");
478
+ if (node.type === "VariableDeclarator" && (node.id.type !== "Identifier" || protectedNames.has(node.id.name) && !encoders.has(node.id.name))) throw new Error("byte-test-binding");
479
+ if (node.type === "Identifier" && encoders.has(node.name) && !(parent?.type === "VariableDeclarator" && parent.id === node)
480
+ && !(parent?.type === "CallExpression" && parent.callee === node)
481
+ && !(parent?.type === "MemberExpression" && parent.property === node && !parent.computed && parent.object.type === "NewExpression"
482
+ && parent.object.callee.name === "TextEncoder" && grandparent?.type === "CallExpression" && grandparent.callee === parent)) throw new Error("byte-encoder-escape");
483
+ });
484
+ return { assertName, testName, encoders, registrations, protectedNames };
485
+ } catch { return null; }
486
+ }
487
+ function byteSnapshotBody(body, program, binding) {
488
+ const facts = new Map(); let callIndex = -1, chunksName, snapshotName, identitiesName;
489
+ const byteRoots = node => node?.type === "ArrayExpression" && node.elements.length > 0 && node.elements.length <= 16
490
+ ? node.elements.map(item => item?.type === "CallExpression" && byteMember(item.callee) === "Array.from" && item.arguments.length === 1 && item.arguments[0].type === "Identifier"
491
+ && facts.get(item.arguments[0].name)?.kind === "bytes" && facts.get(item.arguments[0].name).root === item.arguments[0].name ? item.arguments[0].name : null) : null;
492
+ const same = (a, b) => Array.isArray(a) && Array.isArray(b) && a.length === b.length && a.every((value, index) => value === b[index]);
493
+ for (const [position, statement] of body.body.entries()) {
494
+ if (statement.type !== "VariableDeclaration") { callIndex = position; break; }
495
+ if (statement.kind !== "const") return false;
496
+ for (const declaration of statement.declarations) {
497
+ const name = declaration.id.name, init = declaration.init;
498
+ if (declaration.id.type !== "Identifier" || facts.has(name) || program.protectedNames.has(name)) return false;
499
+ if (init?.type === "CallExpression" && program.encoders.has(init.callee.name) && init.arguments.length === 1 && init.arguments[0].type === "StringLiteral") {
500
+ const text = init.arguments[0].value; if (text.length > 32_000) return false;
501
+ facts.set(name, { kind: "bytes", root: name, length: new TextEncoder().encode(text).length }); continue;
502
+ }
503
+ if (init?.type === "CallExpression" && init.callee.type === "MemberExpression" && !init.callee.computed && init.callee.property.name === "subarray") {
504
+ const owner = init.callee.object.name, fact = facts.get(owner), [start, end] = init.arguments;
505
+ if (fact?.kind !== "bytes" || fact.root !== owner || init.arguments.length !== 2 || start.type !== "NumericLiteral" || !Number.isInteger(start.value) || start.value <= 0
506
+ || end.type !== "BinaryExpression" || end.operator !== "-" || byteMember(end.left) !== `${owner}.length` || end.right.type !== "NumericLiteral"
507
+ || !Number.isInteger(end.right.value) || end.right.value <= 0 || start.value + end.right.value >= fact.length) return false;
508
+ facts.set(name, { kind: "bytes", root: owner, length: fact.length - start.value - end.right.value, partial: true }); continue;
509
+ }
510
+ if (init?.type === "ArrayExpression" && init.elements.length > 0 && init.elements.length <= 16 && init.elements.every(node => node?.type === "Identifier" && facts.get(node.name)?.kind === "bytes")) {
511
+ if (chunksName) return false; chunksName = name; facts.set(name, { kind: "chunks", names: init.elements.map(node => node.name) }); continue;
512
+ }
513
+ const roots = byteRoots(init);
514
+ if (roots?.every(Boolean)) { if (snapshotName) return false; snapshotName = name; facts.set(name, { kind: "snapshot", roots }); continue; }
515
+ if (init?.type === "ArrayExpression" && init.elements.length === 1 && init.elements[0]?.type === "SpreadElement" && init.elements[0].argument.name === chunksName) {
516
+ if (identitiesName) return false; identitiesName = name; facts.set(name, { kind: "identities" }); continue;
517
+ }
518
+ return false;
519
+ }
520
+ }
521
+ if (callIndex < 0 || !chunksName || !snapshotName || !identitiesName) return false;
522
+ const chunks = facts.get(chunksName), roots = [...new Set(chunks.names.map(name => facts.get(name).root))];
523
+ if (!same(roots, facts.get(snapshotName).roots) || !chunks.names.some(name => facts.get(name).partial)) return false;
524
+ const first = body.body[callIndex]?.expression, invocation = first?.arguments?.[0];
525
+ if (first?.type !== "CallExpression" || ![`${program.assertName}.deepEqual`, `${program.assertName}.deepStrictEqual`].includes(byteMember(first.callee)) || first.arguments.length !== 2
526
+ || invocation?.type !== "CallExpression" || invocation.callee.name !== binding.testName || invocation.arguments.length !== 1 || invocation.arguments[0].name !== chunksName
527
+ || !flatByteExpected(first.arguments[1])) return false;
528
+ let length = false, array = false, bytes = false; const identities = new Set();
529
+ for (const statement of body.body.slice(callIndex + 1)) {
530
+ const call = statement.type === "ExpressionStatement" ? statement.expression : null, [left, right] = call?.arguments ?? [];
531
+ if (call?.type !== "CallExpression" || call.arguments.length !== 2) return false;
532
+ const method = byteMember(call.callee);
533
+ if ([`${program.assertName}.equal`, `${program.assertName}.strictEqual`].includes(method) && byteMember(left) === `${chunksName}.length` && byteMember(right) === `${identitiesName}.length`) { length = true; continue; }
534
+ if ([`${program.assertName}.deepEqual`, `${program.assertName}.deepStrictEqual`].includes(method) && left.name === chunksName && right.name === identitiesName) { array = true; continue; }
535
+ if (method === `${program.assertName}.strictEqual` && left.type === "MemberExpression" && left.computed && left.object.name === chunksName && left.property.type === "NumericLiteral"
536
+ && Number.isInteger(left.property.value) && left.property.value >= 0 && chunks.names[left.property.value] === right.name) { identities.add(left.property.value); continue; }
537
+ if ([`${program.assertName}.deepEqual`, `${program.assertName}.deepStrictEqual`].includes(method) && same(byteRoots(left), roots) && right.name === snapshotName) { bytes = true; continue; }
538
+ return false;
539
+ }
540
+ return length && array && bytes && identities.size === chunks.names.length;
541
+ }
542
+ function flatByteExpected(node, depth = 0) {
543
+ if (!node || depth > 6) return false;
544
+ if (["StringLiteral", "NumericLiteral", "BooleanLiteral", "NullLiteral"].includes(node.type)) return true;
545
+ if (node.type === "ArrayExpression") return node.elements.length <= 32 && node.elements.every(item => flatByteExpected(item, depth + 1));
546
+ return node.type === "ObjectExpression" && node.properties.length <= 16 && node.properties.every(item => item.type === "ObjectProperty" && !item.computed && !item.method
547
+ && item.key.type === "Identifier" && !["__proto__", "prototype", "constructor"].includes(item.key.name) && flatByteExpected(item.value, depth + 1));
548
+ }
549
+ export function byteArrayNonMutationEvidence({ rawCriterion, profiles, sourceEntries }) {
550
+ if (!/^Do not mutate the (?:chunk|byte) array or its buffers(?: and do not add dependencies)?[.;]?$/i.test(String(rawCriterion).replace(/\s+/g, " ").trim())) return false;
551
+ return profiles.some(profile => (profile.bindings ?? []).some(binding => {
552
+ if (!readOnlyByteSource(sourceEntries, binding)) return false;
553
+ const program = byteSnapshotProgram(profile, binding);
554
+ return program?.registrations.some(body => byteSnapshotBody(body, program, binding)) === true;
555
+ }));
556
+ }
557
+
558
+ // Effects are checked over every source branch. Frozen witnesses alone cannot
559
+ // establish this property: a conditional write on ordinary input still fails.
560
+ function immutableRecordValue(node, values = new Map(), allowFreeze = false, depth = 0) {
561
+ if (!node || depth > 8) return null;
562
+ if (["StringLiteral", "NumericLiteral", "BooleanLiteral", "NullLiteral"].includes(node.type)) return { kind: "scalar", value: node.type === "NullLiteral" ? null : node.value };
563
+ if (node.type === "Identifier") return values.get(node.name) ?? null;
564
+ if (allowFreeze && node.type === "CallExpression" && byteMember(node.callee) === "Object.freeze" && node.arguments.length === 1)
565
+ return immutableRecordValue(node.arguments[0], values, allowFreeze, depth + 1);
566
+ if (node.type === "ArrayExpression" && node.elements.length <= 32) {
567
+ const items = node.elements.map(item => immutableRecordValue(item, values, allowFreeze, depth + 1));
568
+ return items.every(Boolean) ? { kind: "array", items } : null;
569
+ }
570
+ if (node.type === "ObjectExpression" && node.properties.length <= 32) {
571
+ const fields = new Map();
572
+ for (const property of node.properties) {
573
+ if (property.type === "SpreadElement") {
574
+ const source = immutableRecordValue(property.argument, values, allowFreeze, depth + 1);
575
+ if (source?.kind !== "record") return null;
576
+ for (const [key, value] of source.fields) fields.set(key, value);
577
+ continue;
578
+ }
579
+ if (property.type !== "ObjectProperty" || property.computed || property.method || property.key.type !== "Identifier"
580
+ || ["__proto__", "constructor", "prototype"].includes(property.key.name)) return null;
581
+ const value = immutableRecordValue(property.value, values, allowFreeze, depth + 1); if (!value) return null;
582
+ fields.set(property.key.name, value);
583
+ }
584
+ return { kind: "record", fields };
585
+ }
586
+ return null;
587
+ }
588
+ function pureRecordSource(entries, binding) {
589
+ try {
590
+ if (entries.length !== 1 || entries[0].path !== binding.sourcePath || entries[0].text.length > 64_000) return null;
591
+ const ast = parseByteEvidence(entries[0].text, { sourceType: "module" }), constants = new Map(), functions = [];
592
+ const protectedNames = new Set(["Object", "Number", "Array", "Reflect", "Proxy", "Function", "eval", "global", "globalThis", "process"]);
593
+ walkByteEvidence(ast, () => {});
594
+ for (const statement of ast.program.body) {
595
+ if (statement.type !== "ExportNamedDeclaration" || statement.source) return null;
596
+ const declaration = statement.declaration;
597
+ if (declaration?.type === "FunctionDeclaration") { functions.push(declaration); continue; }
598
+ if (declaration?.type !== "VariableDeclaration" || declaration.kind !== "const" || declaration.declarations.length !== 1) return null;
599
+ const item = declaration.declarations[0];
600
+ if (item.id.type !== "Identifier" || protectedNames.has(item.id.name) || constants.has(item.id.name)) return null;
601
+ const value = immutableRecordValue(item.init, constants, true); if (!value || value.kind !== "record") return null;
602
+ constants.set(item.id.name, value);
603
+ }
604
+ const fn = functions[0];
605
+ if (functions.length !== 1 || !fn || fn.id?.name !== binding.sourceName || fn.async || fn.generator || fn.params.length !== 2
606
+ || constants.has(fn.id.name) || protectedNames.has(fn.id.name)) return null;
607
+ const names = new Set(constants.keys());
608
+ for (const parameter of fn.params) {
609
+ const name = parameter.type === "Identifier" ? parameter.name : parameter.type === "AssignmentPattern" && parameter.left.type === "Identifier"
610
+ && parameter.right.type === "Identifier" && constants.has(parameter.right.name) ? parameter.left.name : null;
611
+ if (!name || names.has(name) || protectedNames.has(name) || name === fn.id.name) return null;
612
+ names.add(name);
613
+ }
614
+ const expression = (node, scope, depth = 0) => {
615
+ if (!node || depth > 64) return false;
616
+ if (["StringLiteral", "NumericLiteral", "BooleanLiteral", "NullLiteral"].includes(node.type)) return true;
617
+ if (node.type === "Identifier") return scope.has(node.name);
618
+ if (node.type === "MemberExpression") return !node.computed && !["constructor", "prototype", "__proto__"].includes(node.property.name) && expression(node.object, scope, depth + 1);
619
+ if (node.type === "UnaryExpression") return ["!", "typeof", "+", "-"].includes(node.operator) && expression(node.argument, scope, depth + 1);
620
+ if (node.type === "BinaryExpression") return ["===", "!==", "<", "<=", ">", ">=", "+", "-"].includes(node.operator) && expression(node.left, scope, depth + 1) && expression(node.right, scope, depth + 1);
621
+ if (node.type === "LogicalExpression") return ["&&", "||", "??"].includes(node.operator) && expression(node.left, scope, depth + 1) && expression(node.right, scope, depth + 1);
622
+ if (node.type === "ConditionalExpression") return [node.test, node.consequent, node.alternate].every(item => expression(item, scope, depth + 1));
623
+ if (node.type === "ArrayExpression") return node.elements.length <= 32 && node.elements.every(item => expression(item?.type === "SpreadElement" ? item.argument : item, scope, depth + 1));
624
+ if (node.type === "ObjectExpression") return node.properties.length <= 32 && node.properties.every(item => item.type === "SpreadElement" ? expression(item.argument, scope, depth + 1)
625
+ : item.type === "ObjectProperty" && !item.computed && !item.method && item.key.type === "Identifier" && !["constructor", "prototype", "__proto__"].includes(item.key.name) && expression(item.value, scope, depth + 1));
626
+ return node.type === "CallExpression" && ["Number.isInteger", "Number.isFinite", "Number.isSafeInteger"].includes(byteMember(node.callee))
627
+ && node.arguments.length === 1 && expression(node.arguments[0], scope, depth + 1);
628
+ };
629
+ const statements = (nodes, scope, depth = 0) => depth <= 32 && nodes.every(node => {
630
+ if (node.type === "ReturnStatement") return expression(node.argument, scope);
631
+ if (node.type === "BlockStatement") return statements(node.body, new Set(scope), depth + 1);
632
+ if (node.type === "IfStatement") return expression(node.test, scope) && statements([node.consequent], new Set(scope), depth + 1)
633
+ && (!node.alternate || statements([node.alternate], new Set(scope), depth + 1));
634
+ if (node.type !== "VariableDeclaration" || node.kind !== "const") return false;
635
+ return node.declarations.every(item => {
636
+ if (item.id.type !== "Identifier" || scope.has(item.id.name) || protectedNames.has(item.id.name) || !expression(item.init, scope)) return false;
637
+ scope.add(item.id.name); return true;
638
+ });
639
+ });
640
+ return fn.body.body.length > 0 && statements(fn.body.body, names) ? { constants } : null;
641
+ } catch { return null; }
642
+ }
643
+ function pureRecordTestWitness(profile, binding, source) {
644
+ if (!testProofIntrinsicsAreStable(profile.evidenceCode) || !literalArrayIterationEnvironmentIsStable(profile.evidenceCode)) return false;
645
+ try {
646
+ if (profile.raw.length > 64_000) return false;
647
+ const ast = parseByteEvidence(profile.raw, { sourceType: "module" }), imports = ast.program.body.filter(node => node.type === "ImportDeclaration");
648
+ const local = module => imports.filter(node => node.source.value === module).flatMap(node => node.specifiers.filter(item => item.type === "ImportDefaultSpecifier").map(item => item.local.name));
649
+ const asserts = [...local("node:assert/strict"), ...local("node:assert")], runners = local("node:test");
650
+ if (imports.length !== 3 || asserts.length !== 1 || runners.length !== 1) return false;
651
+ const assertName = asserts[0], testName = runners[0], initial = new Map(), protectedNames = new Set([assertName, testName, "Object", "Number", "Array", binding.testName]);
652
+ for (const declaration of imports.filter(node => !node.source.value.startsWith("node:"))) for (const item of declaration.specifiers) {
653
+ if (item.type !== "ImportSpecifier") return false;
654
+ if (source.constants.has(item.imported.name)) { initial.set(item.local.name, source.constants.get(item.imported.name)); protectedNames.add(item.local.name); }
655
+ else if (item.local.name !== binding.testName || item.imported.name !== binding.sourceName) return false;
656
+ }
657
+ const methods = new Set(["equal", "strictEqual", "deepEqual", "deepStrictEqual", "notEqual", "notStrictEqual"]);
658
+ walkByteEvidence(ast, (node, parent, grandparent) => {
659
+ if (["AssignmentExpression", "UpdateExpression", "AwaitExpression", "ThisExpression"].includes(node.type) || node.type === "UnaryExpression" && node.operator === "delete") throw new Error("record-test-store");
660
+ if (node.type === "MemberExpression" && (node.computed || ["constructor", "prototype", "__proto__"].includes(node.property.name))) throw new Error("record-test-reflection");
661
+ if (node.type === "Identifier" && ["global", "globalThis", "process", "Reflect", "Proxy", "Function", "eval", "Symbol"].includes(node.name)) throw new Error("record-test-global");
662
+ if (node.type === "Identifier" && node.name === "Object" && !(parent?.type === "MemberExpression" && parent.object === node && byteMember(parent) === "Object.freeze"
663
+ && grandparent?.type === "CallExpression" && grandparent.callee === parent)) throw new Error("record-test-native");
664
+ if (/Function/.test(node.type) && node.params?.some(param => param.type !== "Identifier" || protectedNames.has(param.name))) throw new Error("record-test-parameter");
665
+ if (node.type === "VariableDeclarator") {
666
+ const names = node.id.type === "Identifier" ? [node.id.name] : node.id.type === "ArrayPattern" ? node.id.elements.map(item => item?.name) : [];
667
+ if (!names.length || names.some(name => !name || protectedNames.has(name))) throw new Error("record-test-binding");
668
+ }
669
+ if (node.type === "CallExpression" && ![binding.testName, testName, "Object.freeze", ...[...methods].map(name => `${assertName}.${name}`)].includes(byteMember(node.callee))) throw new Error("record-test-call");
670
+ });
671
+ let witnessed = false, expanded = 0;
672
+ const containsArray = (value, depth = 0) => depth < 8 && (value?.kind === "array" ? value.items.length > 0 : value?.kind === "record" && [...value.fields.values()].some(item => containsArray(item, depth + 1)));
673
+ const observe = (call, values) => {
674
+ if (call?.type !== "CallExpression" || call.callee.name !== binding.testName || call.arguments.length !== 2) return;
675
+ const args = call.arguments.map(node => immutableRecordValue(node, values, true));
676
+ if (args.every(value => value?.kind === "record" && containsArray(value))) witnessed = true;
677
+ };
678
+ const condition = (node, values) => {
679
+ const literal = immutableRecordValue(node, values, true); if (literal?.kind === "scalar" && typeof literal.value === "boolean") return literal.value;
680
+ if (node?.type !== "BinaryExpression" || !["===", "!=="].includes(node.operator)) return null;
681
+ const left = immutableRecordValue(node.left, values, true), right = immutableRecordValue(node.right, values, true);
682
+ return left?.kind === "scalar" && right?.kind === "scalar" ? (left.value === right.value) === (node.operator === "===") : null;
683
+ };
684
+ const read = (nodes, values, depth = 0) => {
685
+ if (depth > 4) throw new Error("record-test-depth");
686
+ for (const statement of nodes) {
687
+ if (++expanded > 512) throw new Error("record-test-expansion");
688
+ if (statement.type === "VariableDeclaration" && statement.kind === "const") {
689
+ for (const item of statement.declarations) {
690
+ if (item.id.type !== "Identifier") throw new Error("record-test-local");
691
+ const value = immutableRecordValue(item.init, values, true);
692
+ if (value) values.set(item.id.name, value); else { observe(item.init, values); values.delete(item.id.name); }
693
+ }
694
+ continue;
695
+ }
696
+ if (statement.type === "ForOfStatement" && !statement.await && statement.left.type === "VariableDeclaration" && statement.left.kind === "const" && statement.left.declarations.length === 1) {
697
+ const pattern = statement.left.declarations[0].id, rows = immutableRecordValue(statement.right, values, true);
698
+ if (rows?.kind !== "array" || rows.items.length > 32) throw new Error("record-test-rows");
699
+ for (const row of rows.items) {
700
+ const nested = new Map(values);
701
+ if (pattern.type === "Identifier") nested.set(pattern.name, row);
702
+ else if (pattern.type === "ArrayPattern" && row.kind === "array" && row.items.length === pattern.elements.length && pattern.elements.every(node => node?.type === "Identifier"))
703
+ pattern.elements.forEach((node, index) => nested.set(node.name, row.items[index]));
704
+ else throw new Error("record-test-tuple");
705
+ read(statement.body.type === "BlockStatement" ? statement.body.body : [statement.body], nested, depth + 1);
706
+ }
707
+ continue;
708
+ }
709
+ if (statement.type === "IfStatement") {
710
+ const selected = condition(statement.test, values); if (selected === null) throw new Error("record-test-condition");
711
+ const branch = selected ? statement.consequent : statement.alternate;
712
+ if (branch) read(branch.type === "BlockStatement" ? branch.body : [branch], new Map(values), depth + 1); continue;
713
+ }
714
+ const call = statement.type === "ExpressionStatement" ? statement.expression : null;
715
+ if (call?.type !== "CallExpression" || call.callee.type !== "MemberExpression" || call.callee.object.name !== assertName || !methods.has(call.callee.property.name)) throw new Error("record-test-statement");
716
+ for (const argument of call.arguments) observe(argument, values);
717
+ }
718
+ };
719
+ for (const statement of ast.program.body) {
720
+ if (statement.type === "ImportDeclaration") continue;
721
+ const call = statement.type === "ExpressionStatement" ? statement.expression : null, callback = call?.arguments?.[1];
722
+ if (call?.type !== "CallExpression" || call.callee.name !== testName || call.arguments.length !== 2 || call.arguments[0].type !== "StringLiteral"
723
+ || callback?.type !== "ArrowFunctionExpression" || callback.async || callback.params.length !== 0 || callback.body.type !== "BlockStatement") return false;
724
+ read(callback.body.body, new Map(initial));
725
+ }
726
+ return witnessed;
727
+ } catch { return false; }
728
+ }
729
+ export function pureRecordNonMutationEvidence({ rawCriterion, profiles, sourceEntries }) {
730
+ if (!/^Do not mutate state, actions, or result arrays[.;]?$/i.test(String(rawCriterion).replace(/\s+/g, " ").trim())) return false;
731
+ return profiles.some(profile => (profile.bindings ?? []).some(binding => {
732
+ const source = pureRecordSource(sourceEntries, binding);
733
+ return source !== null && pureRecordTestWitness(profile, binding, source);
734
+ }));
735
+ }