hex-audit 0.6.3 → 0.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (746) hide show
  1. package/CLAUDE.md +137 -77
  2. package/DEMO.md +41 -105
  3. package/README.md +205 -353
  4. package/dashboard/.next/BUILD_ID +1 -1
  5. package/dashboard/.next/app-build-manifest.json +65 -99
  6. package/dashboard/.next/app-path-routes-manifest.json +1 -1
  7. package/dashboard/.next/build-manifest.json +14 -14
  8. package/dashboard/.next/next-minimal-server.js.nft.json +1 -1
  9. package/dashboard/.next/next-server.js.nft.json +1 -1
  10. package/dashboard/.next/prerender-manifest.js +1 -1
  11. package/dashboard/.next/prerender-manifest.json +1 -1
  12. package/dashboard/.next/react-loadable-manifest.json +540 -119
  13. package/dashboard/.next/routes-manifest.json +1 -1
  14. package/dashboard/.next/server/app/_not-found/page.js +1 -1
  15. package/dashboard/.next/server/app/_not-found/page.js.nft.json +1 -1
  16. package/dashboard/.next/server/app/_not-found/page_client-reference-manifest.js +1 -1
  17. package/dashboard/.next/server/app/api/code/route.js +1 -1
  18. package/dashboard/.next/server/app/api/code/route.js.nft.json +1 -1
  19. package/dashboard/.next/server/app/api/comments/route.js +1 -0
  20. package/dashboard/.next/server/app/api/comments/route.js.nft.json +1 -0
  21. package/dashboard/.next/server/app/api/diagrams/[name]/export/route.js +1 -0
  22. package/dashboard/.next/server/app/api/diagrams/[name]/export/route.js.nft.json +1 -0
  23. package/dashboard/.next/server/app/api/diagrams/[name]/resolve/route.js +1 -0
  24. package/dashboard/.next/server/app/api/diagrams/[name]/resolve/route.js.nft.json +1 -0
  25. package/dashboard/.next/server/app/api/diagrams/[name]/route.js +1 -0
  26. package/dashboard/.next/server/app/api/diagrams/[name]/route.js.nft.json +1 -0
  27. package/dashboard/.next/server/app/api/figures/[name]/route.js +1 -0
  28. package/dashboard/.next/server/app/api/figures/[name]/route.js.nft.json +1 -0
  29. package/dashboard/.next/server/app/api/focus/route.js +1 -0
  30. package/dashboard/.next/server/app/api/focus/route.js.nft.json +1 -0
  31. package/dashboard/.next/server/app/api/github-status/route.js +1 -1
  32. package/dashboard/.next/server/app/api/invariants/[id]/route.js +1 -0
  33. package/dashboard/.next/server/app/api/invariants/[id]/route.js.nft.json +1 -0
  34. package/dashboard/.next/server/app/api/issues/[id]/revert-auto/route.js +1 -0
  35. package/dashboard/.next/server/app/api/issues/[id]/revert-auto/route.js.nft.json +1 -0
  36. package/dashboard/.next/server/app/api/nav/route.js +1 -0
  37. package/dashboard/.next/server/app/api/nav/route.js.nft.json +1 -0
  38. package/dashboard/.next/server/app/api/notes/done/route.js +1 -1
  39. package/dashboard/.next/server/app/api/notes/done/route.js.nft.json +1 -1
  40. package/dashboard/.next/server/app/api/notes/lead/route.js +1 -1
  41. package/dashboard/.next/server/app/api/notes/lead/route.js.nft.json +1 -1
  42. package/dashboard/.next/server/app/api/notes/question/route.js +1 -1
  43. package/dashboard/.next/server/app/api/notes/question/route.js.nft.json +1 -1
  44. package/dashboard/.next/server/app/api/notes/record/route.js +3 -3
  45. package/dashboard/.next/server/app/api/notes/route.js +2 -2
  46. package/dashboard/.next/server/app/api/palette/route.js +1 -0
  47. package/dashboard/.next/server/app/api/palette/route.js.nft.json +1 -0
  48. package/dashboard/.next/server/app/api/progress/route.js +1 -1
  49. package/dashboard/.next/server/app/api/progress/route.js.nft.json +1 -1
  50. package/dashboard/.next/server/app/api/watch/route.js +2 -2
  51. package/dashboard/.next/server/app/api/watch/route.js.nft.json +1 -1
  52. package/dashboard/.next/server/app/api/xref/route.js +1 -0
  53. package/dashboard/.next/server/app/changes/page.js +1 -0
  54. package/dashboard/.next/server/app/{access → changes}/page.js.nft.json +1 -1
  55. package/dashboard/.next/server/app/changes/page_client-reference-manifest.js +1 -0
  56. package/dashboard/.next/server/app/excalidraw-assets/[...path]/route.js +1 -0
  57. package/dashboard/.next/server/app/issues/page.js +5 -28
  58. package/dashboard/.next/server/app/issues/page.js.nft.json +1 -1
  59. package/dashboard/.next/server/app/issues/page_client-reference-manifest.js +1 -1
  60. package/dashboard/.next/server/app/model/page.js +1 -0
  61. package/dashboard/.next/server/app/{calls → model}/page.js.nft.json +1 -1
  62. package/dashboard/.next/server/app/model/page_client-reference-manifest.js +1 -0
  63. package/dashboard/.next/server/app/page.js +1 -20
  64. package/dashboard/.next/server/app/page.js.nft.json +1 -1
  65. package/dashboard/.next/server/app/page_client-reference-manifest.js +1 -1
  66. package/dashboard/.next/server/app/report/page.js +1 -1
  67. package/dashboard/.next/server/app/report/page.js.nft.json +1 -1
  68. package/dashboard/.next/server/app/report/page_client-reference-manifest.js +1 -1
  69. package/dashboard/.next/server/app/review/page.js +1 -0
  70. package/dashboard/.next/server/app/{conformance → review}/page.js.nft.json +1 -1
  71. package/dashboard/.next/server/app/review/page_client-reference-manifest.js +1 -0
  72. package/dashboard/.next/server/app-paths-manifest.json +20 -16
  73. package/dashboard/.next/server/chunks/310.js +4 -0
  74. package/dashboard/.next/server/chunks/370.js +1 -0
  75. package/dashboard/.next/server/chunks/42.js +1 -1
  76. package/dashboard/.next/server/chunks/624.js +14 -0
  77. package/dashboard/.next/server/chunks/645.js +1 -1
  78. package/dashboard/.next/server/chunks/649.js +1 -1
  79. package/dashboard/.next/server/chunks/653.js +1 -0
  80. package/dashboard/.next/server/functions-config-manifest.json +1 -1
  81. package/dashboard/.next/server/middleware-build-manifest.js +1 -1
  82. package/dashboard/.next/server/middleware-react-loadable-manifest.js +1 -1
  83. package/dashboard/.next/server/next-font-manifest.js +1 -1
  84. package/dashboard/.next/server/next-font-manifest.json +1 -1
  85. package/dashboard/.next/server/pages/500.html +1 -1
  86. package/dashboard/.next/server/pages/_error.js +1 -1
  87. package/dashboard/.next/server/pages-manifest.json +1 -1
  88. package/dashboard/.next/server/server-reference-manifest.js +1 -1
  89. package/dashboard/.next/server/server-reference-manifest.json +1 -1
  90. package/dashboard/.next/static/bGV1ry1vvIbM5b506eVBR/_buildManifest.js +1 -0
  91. package/dashboard/.next/static/chunks/0bbe10ee.8e7ffa06d2170dfe.js +84 -0
  92. package/dashboard/.next/static/chunks/{1.8868c4d131111be7.js → 1.a666047ea18866fb.js} +2 -2
  93. package/dashboard/.next/static/chunks/1015.39008440ab15e196.js +226 -0
  94. package/dashboard/.next/static/chunks/1026.0ef689a305302427.js +1 -0
  95. package/dashboard/.next/static/chunks/1151.497fa63c5b9eba52.js +1 -0
  96. package/dashboard/.next/static/chunks/1164.34eb76767ebea46f.js +8 -0
  97. package/dashboard/.next/static/chunks/119.a9a79633900a235f.js +5 -0
  98. package/dashboard/.next/static/chunks/1199.f30cbfa151e56076.js +148 -0
  99. package/dashboard/.next/static/chunks/1291.6c486c9b1d4b1b3a.js +1 -0
  100. package/dashboard/.next/static/chunks/1375.64c20f1064a38a10.js +43 -0
  101. package/dashboard/.next/static/chunks/139.4691848fc5a46253.js +10 -0
  102. package/dashboard/.next/static/chunks/145.1bf74fecdb4022e3.js +11 -0
  103. package/dashboard/.next/static/chunks/1517.8e7075f78e22b3a0.js +8 -0
  104. package/dashboard/.next/static/chunks/165.6f174060a0ce2db4.js +6 -0
  105. package/dashboard/.next/static/chunks/1741.5c370b7702d2eb40.js +8 -0
  106. package/dashboard/.next/static/chunks/1799.8dc56017eede704e.js +9 -0
  107. package/dashboard/.next/static/chunks/1e36816c.5748c83adc8a6bd6.js +108 -0
  108. package/dashboard/.next/static/chunks/20154aaa.e87f69fe10483f8b.js +1 -0
  109. package/dashboard/.next/static/chunks/2061.eab75b3c1dfa068a.js +1 -0
  110. package/dashboard/.next/static/chunks/2077.5603adeb156c7d10.js +1 -0
  111. package/dashboard/.next/static/chunks/2148.3ce718f62d1b2f7c.js +10 -0
  112. package/dashboard/.next/static/chunks/2166.9f6592b9399eadd8.js +215 -0
  113. package/dashboard/.next/static/chunks/217-1d5b680ffd10e3f9.js +1 -0
  114. package/dashboard/.next/static/chunks/2208.fb884379aa3ae968.js +1 -0
  115. package/dashboard/.next/static/chunks/2276.112c7855333fca5f.js +6 -0
  116. package/dashboard/.next/static/chunks/{2291.85a70cb0c228157b.js → 2291.584b42ccad079b99.js} +1 -1
  117. package/dashboard/.next/static/chunks/2325.7decd077edfb81d9.js +24 -0
  118. package/dashboard/.next/static/chunks/2374-8c6f137938f8518a.js +1 -0
  119. package/dashboard/.next/static/chunks/{2383.62c035a052272594.js → 2383.ca81f980ce6528a4.js} +1 -1
  120. package/dashboard/.next/static/chunks/2445.18a86507d2996b95.js +1 -0
  121. package/dashboard/.next/static/chunks/2694.7dfa5fef28851903.js +1 -0
  122. package/dashboard/.next/static/chunks/2712.15dd8577973baf22.js +10 -0
  123. package/dashboard/.next/static/chunks/275.38af87389c1d33d7.js +34 -0
  124. package/dashboard/.next/static/chunks/2759.533dec5317e0a1d1.js +1 -0
  125. package/dashboard/.next/static/chunks/2781.fba46046dbf2693b.js +93 -0
  126. package/dashboard/.next/static/chunks/2805.35b4cd8a94978aaf.js +1 -0
  127. package/dashboard/.next/static/chunks/2812.62b213bef580b69a.js +1 -0
  128. package/dashboard/.next/static/chunks/{2879.51436986f93981d9.js → 2879.74d65e33e60505ee.js} +1 -1
  129. package/dashboard/.next/static/chunks/2895.bb57cacb7aaf42a1.js +9 -0
  130. package/dashboard/.next/static/chunks/2972.e5a9251b538dcf19.js +9 -0
  131. package/dashboard/.next/static/chunks/3205-fd963acf2fdfd080.js +2 -0
  132. package/dashboard/.next/static/chunks/3206.8d9a10db2b04b93f.js +1 -0
  133. package/dashboard/.next/static/chunks/3236.eac9855778a54518.js +1 -0
  134. package/dashboard/.next/static/chunks/3480.853a445a3784642a.js +1 -0
  135. package/dashboard/.next/static/chunks/3485.36766504793b7237.js +9 -0
  136. package/dashboard/.next/static/chunks/3626.c5dacee11c8fbc4d.js +64 -0
  137. package/dashboard/.next/static/chunks/3725.de9376dc994735d4.js +9 -0
  138. package/dashboard/.next/static/chunks/3774.1df377928e8387f7.js +9 -0
  139. package/dashboard/.next/static/chunks/3865.5e6d2d501380e03b.js +90 -0
  140. package/dashboard/.next/static/chunks/3887.073cece834a4eae2.js +1 -0
  141. package/dashboard/.next/static/chunks/3924-f1f85ccc7d59d7ab.js +1 -0
  142. package/dashboard/.next/static/chunks/3948.74201b9f0672234d.js +287 -0
  143. package/dashboard/.next/static/chunks/3963.39d72b3875dfe2e9.js +13 -0
  144. package/dashboard/.next/static/chunks/4013.73884b23bfaebdde.js +11 -0
  145. package/dashboard/.next/static/chunks/4117.278aff1fa23fd36e.js +6 -0
  146. package/dashboard/.next/static/chunks/4210.cc8594110017c579.js +11 -0
  147. package/dashboard/.next/static/chunks/4282.28485875540886cc.js +7 -0
  148. package/dashboard/.next/static/chunks/4318.a2f469a88d88f6d0.js +8 -0
  149. package/dashboard/.next/static/chunks/4363.8999a6e727c48003.js +1 -0
  150. package/dashboard/.next/static/chunks/4641.e03d118fffebd580.js +5 -0
  151. package/dashboard/.next/static/chunks/4728.e69372b5e5b61b8d.js +24 -0
  152. package/dashboard/.next/static/chunks/4787.821a6ad2816cdc60.js +23 -0
  153. package/dashboard/.next/static/chunks/483.a910dab7734a1074.js +8 -0
  154. package/dashboard/.next/static/chunks/4926.76693f542e9cc062.js +6 -0
  155. package/dashboard/.next/static/chunks/4938.03f6d04dabf38745.js +10 -0
  156. package/dashboard/.next/static/chunks/5060.47402abc10273699.js +1 -0
  157. package/dashboard/.next/static/chunks/5112.0757c2b0c285e62e.js +1 -0
  158. package/dashboard/.next/static/chunks/5199.c83ea7efb0eec705.js +11 -0
  159. package/dashboard/.next/static/chunks/5284.334c7c0587d5d47a.js +1 -0
  160. package/dashboard/.next/static/chunks/530.849957a8907eb288.js +1 -0
  161. package/dashboard/.next/static/chunks/5424.4e8ca0711a32bccf.js +7 -0
  162. package/dashboard/.next/static/chunks/55.a593a78be9714679.js +1 -0
  163. package/dashboard/.next/static/chunks/5535.6cd0bd8d368d8902.js +4 -0
  164. package/dashboard/.next/static/chunks/5626.7d4e93d7acbeffc9.js +10 -0
  165. package/dashboard/.next/static/chunks/5715.e16b1230cc4b4652.js +115 -0
  166. package/dashboard/.next/static/chunks/5775.a0d7c1b1e89b9a93.js +9 -0
  167. package/dashboard/.next/static/chunks/6014.641a2c53ba506241.js +104 -0
  168. package/dashboard/.next/static/chunks/6024.f099c15f75aa6722.js +79 -0
  169. package/dashboard/.next/static/chunks/{6052.033a6f1013c666eb.js → 6052.3001318955e5b36c.js} +2 -2
  170. package/dashboard/.next/static/chunks/6118.266956b3333b1d7a.js +9 -0
  171. package/dashboard/.next/static/chunks/6121.a2e6d93720b1205e.js +77 -0
  172. package/dashboard/.next/static/chunks/6177.a01cf0a03734cf09.js +1 -0
  173. package/dashboard/.next/static/chunks/618f8807-fbb1466bc29c17c6.js +1 -0
  174. package/dashboard/.next/static/chunks/6434.f560693253fea8de.js +1 -0
  175. package/dashboard/.next/static/chunks/6468.976d89ba133185f1.js +77 -0
  176. package/dashboard/.next/static/chunks/6540.6f3c4f2c6877ed89.js +1 -0
  177. package/dashboard/.next/static/chunks/6549.e3c4c1766cff1449.js +1 -0
  178. package/dashboard/.next/static/chunks/6853.d3ad43614e8ca0ab.js +1 -0
  179. package/dashboard/.next/static/chunks/690f35d0.ab57e02a04c7e9e0.js +119 -0
  180. package/dashboard/.next/static/chunks/6951.02a3a158d02158c9.js +5 -0
  181. package/dashboard/.next/static/chunks/6970.013f24568c87d918.js +11 -0
  182. package/dashboard/.next/static/chunks/7013.39d41e82b37be63b.js +9 -0
  183. package/dashboard/.next/static/chunks/{7020.831e16e26d91abc1.js → 7020.b718b1b9cea36e60.js} +2 -2
  184. package/dashboard/.next/static/chunks/7107.1c5412197912b8ed.js +8 -0
  185. package/dashboard/.next/static/chunks/7498-7cf464d8af69cd0a.js +1 -0
  186. package/dashboard/.next/static/chunks/7508.dd60e2d06d149f5f.js +9 -0
  187. package/dashboard/.next/static/chunks/7524.0fde4c61553d1491.js +3 -0
  188. package/dashboard/.next/static/chunks/7802.f0134c792fccd382.js +80 -0
  189. package/dashboard/.next/static/chunks/7834-47f318a04a05688f.js +1 -0
  190. package/dashboard/.next/static/chunks/{7a04ac15.1c6cea694301806c.js → 7a04ac15.e49de94ece135900.js} +1 -1
  191. package/dashboard/.next/static/chunks/8216.1138ec313908a708.js +5 -0
  192. package/dashboard/.next/static/chunks/{8233babc.780b8e272eda298f.js → 8233babc.09872dcb3ff44064.js} +1 -1
  193. package/dashboard/.next/static/chunks/8317.d0b3eddef4cae0d5.js +1 -0
  194. package/dashboard/.next/static/chunks/838.2b2aa006519ba44c.js +10 -0
  195. package/dashboard/.next/static/chunks/8398.924fd8f4c83417c0.js +7 -0
  196. package/dashboard/.next/static/chunks/8428b36f.8ac4e67061c01307.js +34 -0
  197. package/dashboard/.next/static/chunks/8514.85ccbbea8ab21d04.js +5 -0
  198. package/dashboard/.next/static/chunks/8538.5f7ebe76c4b63162.js +1 -0
  199. package/dashboard/.next/static/chunks/8645.98a43217d406500e.js +1 -0
  200. package/dashboard/.next/static/chunks/8687.9406baa8b5601fd0.js +1 -0
  201. package/dashboard/.next/static/chunks/8721.47346e2cb6412376.js +10 -0
  202. package/dashboard/.next/static/chunks/8770.4f544bd1a6f03a62.js +8 -0
  203. package/dashboard/.next/static/chunks/8812.3d96fd54dba566f8.js +9 -0
  204. package/dashboard/.next/static/chunks/8962.d22aa67a97970dd8.js +1 -0
  205. package/dashboard/.next/static/chunks/8986.b327224b83f4399a.js +5 -0
  206. package/dashboard/.next/static/chunks/9173.a7160f7d0b685fa7.js +1 -0
  207. package/dashboard/.next/static/chunks/9178.998a8c49996de8e4.js +1 -0
  208. package/dashboard/.next/static/chunks/9271.5f66c19a8ee1ff36.js +10 -0
  209. package/dashboard/.next/static/chunks/9282.f8d01442bab4c0da.js +2 -0
  210. package/dashboard/.next/static/chunks/9366.0ec24a0791b9b00f.js +1 -0
  211. package/dashboard/.next/static/chunks/9466.a914ce0de7d3bb84.js +1 -0
  212. package/dashboard/.next/static/chunks/9660.b1c8deae2c449d14.js +1 -0
  213. package/dashboard/.next/static/chunks/9707.5cd7d2ee933a4af5.js +6 -0
  214. package/dashboard/.next/static/chunks/9716.15fffc0b0038601d.js +4 -0
  215. package/dashboard/.next/static/chunks/{9717.6cf5c8c89403b651.js → 9717.bba51b78ebd8fd29.js} +1 -1
  216. package/dashboard/.next/static/chunks/9720.d63a0696776bcc60.js +1 -0
  217. package/dashboard/.next/static/chunks/9791.e3b3f5a367f63c8a.js +1 -0
  218. package/dashboard/.next/static/chunks/9811.2993c4cbd28e8d1b.js +1 -0
  219. package/dashboard/.next/static/chunks/9820.8c1efad5260e8137.js +1 -0
  220. package/dashboard/.next/static/chunks/985.50150e9eaa4bde33.js +39 -0
  221. package/dashboard/.next/static/chunks/997.56901b86e1b8a87b.js +8 -0
  222. package/dashboard/.next/static/chunks/app/_not-found/page-5ff5d54b6fd6f17e.js +1 -0
  223. package/dashboard/.next/static/chunks/app/changes/page-f8a860034221cad4.js +1 -0
  224. package/dashboard/.next/static/chunks/app/issues/page-da4da93188c414a6.js +1 -0
  225. package/dashboard/.next/static/chunks/app/layout-27a9da4610423c1e.js +1 -0
  226. package/dashboard/.next/static/chunks/app/model/page-9680e22fdd6ddb81.js +1 -0
  227. package/dashboard/.next/static/chunks/app/page-0e67750d99fb2836.js +1 -0
  228. package/dashboard/.next/static/chunks/app/report/page-b56b1db9b9dcf2b6.js +1 -0
  229. package/dashboard/.next/static/chunks/app/review/page-3ef69f0e0badd333.js +1 -0
  230. package/dashboard/.next/static/chunks/{b7167ec1.7afbab6f609e3326.js → b7167ec1.708a3d61698ca2e6.js} +1 -1
  231. package/dashboard/.next/static/chunks/c75e29e3.d91220f782934d80.js +1 -0
  232. package/dashboard/.next/static/chunks/c7ea4e13.3073a2f551aa5ac8.js +1 -0
  233. package/dashboard/.next/static/chunks/framework-a117d81bf1b91f9a.js +33 -0
  234. package/dashboard/.next/static/chunks/main-9c95a7ffedc7afb4.js +1 -0
  235. package/dashboard/.next/static/chunks/main-app-5662c64b50ba40d1.js +1 -0
  236. package/dashboard/.next/static/chunks/pages/_app-308fef0bf9b328f2.js +1 -0
  237. package/dashboard/.next/static/chunks/pages/_error-c91b5eabd7ac9382.js +1 -0
  238. package/dashboard/.next/static/chunks/webpack-6da70e4f9fcf1799.js +1 -0
  239. package/dashboard/.next/static/css/ceafd91ca8dd753d.css +3 -0
  240. package/dashboard/.next/static/css/e4aad1f9c715b79a.css +1 -0
  241. package/dashboard/.next/static/media/39f449c8730c2295-s.woff2 +0 -0
  242. package/dashboard/.next/static/media/86f65e8637cc94e3-s.woff2 +0 -0
  243. package/dashboard/.next/static/media/8760c4774489e4ba-s.p.woff2 +0 -0
  244. package/dashboard/.next/static/media/9fabb9c65b63d798-s.woff2 +0 -0
  245. package/dashboard/.next/static/media/Assistant-Bold.c8f39f24.woff2 +0 -0
  246. package/dashboard/.next/static/media/Assistant-Medium.1e75d8e6.woff2 +0 -0
  247. package/dashboard/.next/static/media/Assistant-Regular.7acbabb8.woff2 +0 -0
  248. package/dashboard/.next/static/media/Assistant-SemiBold.167acbf8.woff2 +0 -0
  249. package/dashboard/.next/static/media/a1f87af3f44fadbb-s.woff2 +0 -0
  250. package/dashboard/.next/static/media/f9e1dbe9676d9bb6-s.woff2 +0 -0
  251. package/dashboard/app/api/code/route.ts +26 -20
  252. package/dashboard/app/api/comments/route.ts +158 -0
  253. package/dashboard/app/api/diagrams/[name]/export/route.ts +26 -0
  254. package/dashboard/app/api/diagrams/[name]/resolve/route.ts +25 -0
  255. package/dashboard/app/api/diagrams/[name]/route.ts +37 -0
  256. package/dashboard/app/api/figures/[name]/route.ts +15 -0
  257. package/dashboard/app/api/focus/route.ts +35 -0
  258. package/dashboard/app/api/invariants/[id]/route.ts +35 -0
  259. package/dashboard/app/api/issues/[id]/revert-auto/route.ts +18 -0
  260. package/dashboard/app/api/nav/route.ts +120 -0
  261. package/dashboard/app/api/palette/route.ts +68 -0
  262. package/dashboard/app/api/progress/route.ts +54 -23
  263. package/dashboard/app/api/xref/route.ts +30 -0
  264. package/dashboard/app/changes/ChangesClient.tsx +838 -0
  265. package/dashboard/app/changes/page.tsx +44 -0
  266. package/dashboard/app/excalidraw-assets/[...path]/route.ts +56 -0
  267. package/dashboard/app/globals.css +231 -77
  268. package/dashboard/app/issues/BoardClient.tsx +817 -0
  269. package/dashboard/app/issues/page.tsx +27 -272
  270. package/dashboard/app/layout.tsx +37 -10
  271. package/dashboard/app/model/ModelClient.tsx +1303 -0
  272. package/dashboard/app/model/page.tsx +98 -0
  273. package/dashboard/app/page.tsx +195 -239
  274. package/dashboard/app/report/ReportClient.tsx +147 -74
  275. package/dashboard/app/report/page.tsx +25 -14
  276. package/dashboard/app/review/ReviewClient.tsx +1180 -0
  277. package/dashboard/app/review/page.tsx +93 -0
  278. package/dashboard/components/AutoRefresh.tsx +22 -19
  279. package/dashboard/components/CodeComments.tsx +303 -0
  280. package/dashboard/components/CodeNav.tsx +523 -0
  281. package/dashboard/components/CodeReference.tsx +92 -99
  282. package/dashboard/components/CodeViewer.tsx +526 -0
  283. package/dashboard/components/CommandPalette.tsx +141 -66
  284. package/dashboard/components/DiagramCanvas.tsx +275 -0
  285. package/dashboard/components/DianeNote.tsx +244 -0
  286. package/dashboard/components/LiveStatus.tsx +30 -68
  287. package/dashboard/components/MarkdownRenderer.tsx +34 -32
  288. package/dashboard/components/RecordButton.tsx +132 -0
  289. package/dashboard/components/ui/Button.tsx +39 -0
  290. package/dashboard/components/ui/Chip.tsx +37 -0
  291. package/dashboard/components/ui/EmptyState.tsx +31 -0
  292. package/dashboard/components/ui/Icons.tsx +126 -0
  293. package/dashboard/components/ui/Inspector.tsx +122 -0
  294. package/dashboard/components/ui/Kbd.tsx +15 -0
  295. package/dashboard/components/ui/ListRow.tsx +92 -0
  296. package/dashboard/components/ui/LocalTime.tsx +14 -0
  297. package/dashboard/components/ui/ProgressRing.tsx +54 -0
  298. package/dashboard/components/ui/ResizeHandle.tsx +93 -0
  299. package/dashboard/components/ui/RiskMeter.tsx +27 -0
  300. package/dashboard/components/ui/SearchField.tsx +55 -0
  301. package/dashboard/components/ui/SegmentedControl.tsx +71 -0
  302. package/dashboard/components/ui/SeverityDot.tsx +57 -0
  303. package/dashboard/components/ui/Sidebar.tsx +236 -0
  304. package/dashboard/components/ui/SplitView.tsx +122 -0
  305. package/dashboard/components/ui/StateGlyph.tsx +66 -0
  306. package/dashboard/components/ui/Toast.tsx +91 -0
  307. package/dashboard/lib/api.ts +17 -0
  308. package/dashboard/lib/cn.ts +4 -0
  309. package/dashboard/lib/data.ts +2 -21
  310. package/dashboard/lib/finding-markdown.ts +1 -1
  311. package/dashboard/lib/focus.ts +42 -0
  312. package/dashboard/lib/hotkeys.ts +41 -0
  313. package/dashboard/lib/inline-markdown.test.ts +11 -0
  314. package/dashboard/lib/live.ts +32 -0
  315. package/dashboard/lib/pane-width.ts +36 -0
  316. package/dashboard/lib/server/board.ts +229 -0
  317. package/dashboard/lib/server/diagrams.ts +191 -0
  318. package/dashboard/lib/server/safe-path.ts +28 -0
  319. package/dashboard/lib/server/workspace.ts +113 -0
  320. package/dashboard/lib/server/xref.ts +42 -0
  321. package/dashboard/lib/solidity.test.ts +37 -0
  322. package/dashboard/lib/solidity.ts +191 -0
  323. package/dashboard/lib/source.ts +28 -0
  324. package/dashboard/lib/types.ts +164 -0
  325. package/dashboard/lib/url.ts +18 -0
  326. package/dashboard/lib/watcher.ts +31 -22
  327. package/dashboard/tailwind.config.ts +6 -3
  328. package/dist/analysis/code-model.d.ts +113 -0
  329. package/dist/analysis/code-model.d.ts.map +1 -0
  330. package/dist/analysis/code-model.js +532 -0
  331. package/dist/analysis/code-model.js.map +1 -0
  332. package/dist/analysis/diff.d.ts +75 -0
  333. package/dist/analysis/diff.d.ts.map +1 -0
  334. package/dist/analysis/diff.js +787 -0
  335. package/dist/analysis/diff.js.map +1 -0
  336. package/dist/commands/analyze.d.ts.map +1 -1
  337. package/dist/commands/analyze.js +25 -40
  338. package/dist/commands/analyze.js.map +1 -1
  339. package/dist/commands/claude.d.ts.map +1 -1
  340. package/dist/commands/claude.js +5 -0
  341. package/dist/commands/claude.js.map +1 -1
  342. package/dist/commands/dashboard.d.ts.map +1 -1
  343. package/dist/commands/dashboard.js +10 -2
  344. package/dist/commands/dashboard.js.map +1 -1
  345. package/dist/commands/diagram.d.ts +3 -0
  346. package/dist/commands/diagram.d.ts.map +1 -0
  347. package/dist/commands/diagram.js +71 -0
  348. package/dist/commands/diagram.js.map +1 -0
  349. package/dist/commands/diff.d.ts +25 -0
  350. package/dist/commands/diff.d.ts.map +1 -0
  351. package/dist/commands/diff.js +257 -0
  352. package/dist/commands/diff.js.map +1 -0
  353. package/dist/commands/doctor.d.ts.map +1 -1
  354. package/dist/commands/doctor.js +5 -18
  355. package/dist/commands/doctor.js.map +1 -1
  356. package/dist/commands/facts.d.ts +23 -0
  357. package/dist/commands/facts.d.ts.map +1 -0
  358. package/dist/commands/facts.js +121 -0
  359. package/dist/commands/facts.js.map +1 -0
  360. package/dist/commands/fix-review.d.ts +9 -0
  361. package/dist/commands/fix-review.d.ts.map +1 -0
  362. package/dist/commands/fix-review.js +367 -0
  363. package/dist/commands/fix-review.js.map +1 -0
  364. package/dist/commands/init.d.ts.map +1 -1
  365. package/dist/commands/init.js +106 -42
  366. package/dist/commands/init.js.map +1 -1
  367. package/dist/commands/issue.d.ts.map +1 -1
  368. package/dist/commands/issue.js +154 -5
  369. package/dist/commands/issue.js.map +1 -1
  370. package/dist/commands/mcp.d.ts +3 -0
  371. package/dist/commands/mcp.d.ts.map +1 -0
  372. package/dist/commands/mcp.js +11 -0
  373. package/dist/commands/mcp.js.map +1 -0
  374. package/dist/commands/model.d.ts +4 -0
  375. package/dist/commands/model.d.ts.map +1 -0
  376. package/dist/commands/model.js +275 -0
  377. package/dist/commands/model.js.map +1 -0
  378. package/dist/commands/note.d.ts.map +1 -1
  379. package/dist/commands/note.js +61 -3
  380. package/dist/commands/note.js.map +1 -1
  381. package/dist/commands/review.d.ts +4 -0
  382. package/dist/commands/review.d.ts.map +1 -0
  383. package/dist/commands/review.js +164 -0
  384. package/dist/commands/review.js.map +1 -0
  385. package/dist/core/comments.d.ts +59 -0
  386. package/dist/core/comments.d.ts.map +1 -0
  387. package/dist/core/comments.js +263 -0
  388. package/dist/core/comments.js.map +1 -0
  389. package/dist/core/config.d.ts +9 -0
  390. package/dist/core/config.d.ts.map +1 -1
  391. package/dist/core/config.js +18 -1
  392. package/dist/core/config.js.map +1 -1
  393. package/dist/core/dedup.d.ts +56 -0
  394. package/dist/core/dedup.d.ts.map +1 -0
  395. package/dist/core/dedup.js +208 -0
  396. package/dist/core/dedup.js.map +1 -0
  397. package/dist/core/errors.d.ts +1 -1
  398. package/dist/core/errors.d.ts.map +1 -1
  399. package/dist/core/errors.js +16 -15
  400. package/dist/core/errors.js.map +1 -1
  401. package/dist/core/external-tools.d.ts +0 -14
  402. package/dist/core/external-tools.d.ts.map +1 -1
  403. package/dist/core/external-tools.js +2 -52
  404. package/dist/core/external-tools.js.map +1 -1
  405. package/dist/core/fix-review.d.ts +54 -0
  406. package/dist/core/fix-review.d.ts.map +1 -0
  407. package/dist/core/fix-review.js +98 -0
  408. package/dist/core/fix-review.js.map +1 -0
  409. package/dist/core/fuzz-sync.d.ts +93 -0
  410. package/dist/core/fuzz-sync.d.ts.map +1 -0
  411. package/dist/core/fuzz-sync.js +516 -0
  412. package/dist/core/fuzz-sync.js.map +1 -0
  413. package/dist/core/git.d.ts +31 -0
  414. package/dist/core/git.d.ts.map +1 -0
  415. package/dist/core/git.js +157 -0
  416. package/dist/core/git.js.map +1 -0
  417. package/dist/core/issues.d.ts +35 -2
  418. package/dist/core/issues.d.ts.map +1 -1
  419. package/dist/core/issues.js +201 -30
  420. package/dist/core/issues.js.map +1 -1
  421. package/dist/core/mcp-config.d.ts +12 -0
  422. package/dist/core/mcp-config.d.ts.map +1 -0
  423. package/dist/core/mcp-config.js +29 -0
  424. package/dist/core/mcp-config.js.map +1 -0
  425. package/dist/core/model.d.ts +38 -0
  426. package/dist/core/model.d.ts.map +1 -0
  427. package/dist/core/model.js +160 -0
  428. package/dist/core/model.js.map +1 -0
  429. package/dist/core/notes.d.ts +27 -1
  430. package/dist/core/notes.d.ts.map +1 -1
  431. package/dist/core/notes.js +47 -5
  432. package/dist/core/notes.js.map +1 -1
  433. package/dist/core/review.d.ts +47 -0
  434. package/dist/core/review.d.ts.map +1 -1
  435. package/dist/core/review.js +177 -1
  436. package/dist/core/review.js.map +1 -1
  437. package/dist/core/rules.d.ts +12 -0
  438. package/dist/core/rules.d.ts.map +1 -0
  439. package/dist/core/rules.js +66 -0
  440. package/dist/core/rules.js.map +1 -0
  441. package/dist/core/schema.d.ts +5458 -2189
  442. package/dist/core/schema.d.ts.map +1 -1
  443. package/dist/core/schema.js +605 -114
  444. package/dist/core/schema.js.map +1 -1
  445. package/dist/core/scope.d.ts +8 -0
  446. package/dist/core/scope.d.ts.map +1 -0
  447. package/dist/core/scope.js +18 -0
  448. package/dist/core/scope.js.map +1 -0
  449. package/dist/core/skills.d.ts +10 -4
  450. package/dist/core/skills.d.ts.map +1 -1
  451. package/dist/core/skills.js +100 -37
  452. package/dist/core/skills.js.map +1 -1
  453. package/dist/diagrams/build.d.ts +18 -0
  454. package/dist/diagrams/build.d.ts.map +1 -0
  455. package/dist/diagrams/build.js +135 -0
  456. package/dist/diagrams/build.js.map +1 -0
  457. package/dist/diagrams/excalidraw.d.ts +27 -0
  458. package/dist/diagrams/excalidraw.d.ts.map +1 -0
  459. package/dist/diagrams/excalidraw.js +219 -0
  460. package/dist/diagrams/excalidraw.js.map +1 -0
  461. package/dist/diagrams/layout.d.ts +48 -0
  462. package/dist/diagrams/layout.d.ts.map +1 -0
  463. package/dist/diagrams/layout.js +686 -0
  464. package/dist/diagrams/layout.js.map +1 -0
  465. package/dist/facts/build.d.ts +23 -0
  466. package/dist/facts/build.d.ts.map +1 -0
  467. package/dist/facts/build.js +112 -0
  468. package/dist/facts/build.js.map +1 -0
  469. package/dist/facts/extract.d.ts +53 -0
  470. package/dist/facts/extract.d.ts.map +1 -0
  471. package/dist/facts/extract.js +635 -0
  472. package/dist/facts/extract.js.map +1 -0
  473. package/dist/facts/fallback.d.ts +7 -0
  474. package/dist/facts/fallback.d.ts.map +1 -0
  475. package/dist/facts/fallback.js +156 -0
  476. package/dist/facts/fallback.js.map +1 -0
  477. package/dist/facts/implementations.d.ts +29 -0
  478. package/dist/facts/implementations.d.ts.map +1 -0
  479. package/dist/facts/implementations.js +43 -0
  480. package/dist/facts/implementations.js.map +1 -0
  481. package/dist/facts/query.d.ts +35 -0
  482. package/dist/facts/query.d.ts.map +1 -0
  483. package/dist/facts/query.js +157 -0
  484. package/dist/facts/query.js.map +1 -0
  485. package/dist/facts/xref.d.ts +53 -0
  486. package/dist/facts/xref.d.ts.map +1 -0
  487. package/dist/facts/xref.js +282 -0
  488. package/dist/facts/xref.js.map +1 -0
  489. package/dist/index.js +16 -16
  490. package/dist/index.js.map +1 -1
  491. package/dist/mcp/server.d.ts +3 -0
  492. package/dist/mcp/server.d.ts.map +1 -0
  493. package/dist/mcp/server.js +400 -0
  494. package/dist/mcp/server.js.map +1 -0
  495. package/dist/skills/ai-audit/LICENSE +21 -0
  496. package/dist/skills/ai-audit/SKILL.md +486 -0
  497. package/dist/skills/ai-audit/UPSTREAM.md +51 -0
  498. package/dist/skills/ai-audit/references/agent-prompts.md +133 -0
  499. package/dist/skills/ai-audit/references/assemble.sh +357 -0
  500. package/dist/skills/ai-audit/references/dedup-and-assembly.md +420 -0
  501. package/dist/skills/ai-audit/references/hacking-agents/access-control-agent.md +27 -0
  502. package/dist/skills/ai-audit/references/hacking-agents/asymmetry-agent.md +77 -0
  503. package/dist/skills/ai-audit/references/hacking-agents/boundary-agent.md +79 -0
  504. package/dist/skills/ai-audit/references/hacking-agents/economic-security-agent.md +35 -0
  505. package/dist/skills/ai-audit/references/hacking-agents/execution-trace-agent.md +33 -0
  506. package/dist/skills/ai-audit/references/hacking-agents/first-principles-agent.md +36 -0
  507. package/dist/skills/ai-audit/references/hacking-agents/flow-gap-agent.md +49 -0
  508. package/dist/skills/ai-audit/references/hacking-agents/invariant-agent.md +44 -0
  509. package/dist/skills/ai-audit/references/hacking-agents/math-precision-agent.md +48 -0
  510. package/dist/skills/ai-audit/references/hacking-agents/numerical-gap-agent.md +46 -0
  511. package/dist/skills/ai-audit/references/hacking-agents/periphery-agent.md +27 -0
  512. package/dist/skills/ai-audit/references/hacking-agents/shared-rules.md +61 -0
  513. package/dist/skills/ai-audit/references/hacking-agents/trust-gap-agent.md +40 -0
  514. package/dist/skills/ai-audit/references/hex-board.md +211 -0
  515. package/dist/skills/ai-audit/references/hex-export.sh +71 -0
  516. package/dist/skills/ai-audit/references/judging.md +75 -0
  517. package/dist/skills/ai-audit/references/report-formatting.md +385 -0
  518. package/dist/skills/ai-audit/references/report-language.md +151 -0
  519. package/dist/skills/ai-audit/references/senior-auditor-sop.md +63 -0
  520. package/dist/skills/diane.md +26 -12
  521. package/dist/skills/fix-review.md +58 -0
  522. package/dist/skills/fuzz/LICENSE +21 -0
  523. package/dist/skills/fuzz/SKILL.md +655 -0
  524. package/dist/skills/fuzz/UPSTREAM.md +119 -0
  525. package/dist/skills/fuzz/agents/implementers/global-property-implementer.md +81 -0
  526. package/dist/skills/fuzz/agents/implementers/specific-property-implementer.md +121 -0
  527. package/dist/skills/fuzz/agents/invariant-discovery/adversarial-profit-maximizer.md +123 -0
  528. package/dist/skills/fuzz/agents/invariant-discovery/conservation-auditor.md +92 -0
  529. package/dist/skills/fuzz/agents/invariant-discovery/protocol-type-specialist.md +173 -0
  530. package/dist/skills/fuzz/agents/invariant-discovery/roundtrip-rounding-analyst.md +164 -0
  531. package/dist/skills/fuzz/agents/invariant-discovery/state-transition-mapper.md +92 -0
  532. package/dist/skills/fuzz/agents/invariant-discovery/synthesizer.md +261 -0
  533. package/dist/skills/fuzz/agents/protocol-analyzer.md +80 -0
  534. package/dist/skills/fuzz/agents/report-writer.md +135 -0
  535. package/dist/skills/fuzz/references/handler-patterns.md +222 -0
  536. package/dist/skills/fuzz/references/hex-invariants.md +102 -0
  537. package/dist/skills/fuzz/references/property-generation.md +149 -0
  538. package/dist/skills/fuzz/references/selection-policy.md +49 -0
  539. package/dist/skills/fuzz/references/setup-playbook.md +92 -0
  540. package/dist/skills/fuzz/references/template-map.md +121 -0
  541. package/dist/skills/fuzz/scripts/ensure_foundry.sh +125 -0
  542. package/dist/skills/fuzz/scripts/estimate_cost.js +157 -0
  543. package/dist/skills/fuzz/scripts/extract_abis.js +303 -0
  544. package/dist/skills/fuzz/scripts/fizz_sync.js +692 -0
  545. package/dist/skills/fuzz/scripts/generate_handlers.js +370 -0
  546. package/dist/skills/fuzz/scripts/generate_suite.js +254 -0
  547. package/dist/skills/fuzz/scripts/lib/log-viewer.js +332 -0
  548. package/dist/skills/fuzz/scripts/run_echidna.js +192 -0
  549. package/dist/skills/fuzz/scripts/run_medusa.js +329 -0
  550. package/dist/skills/fuzz/scripts/select_functions.js +637 -0
  551. package/dist/skills/fuzz/scripts/setup_fuzz_profile.sh +142 -0
  552. package/dist/skills/fuzz/templates/Actor.sol +63 -0
  553. package/dist/skills/fuzz/templates/Base.sol +121 -0
  554. package/dist/skills/fuzz/templates/FoundryTester.sol +29 -0
  555. package/dist/skills/fuzz/templates/FuzzTester.sol +11 -0
  556. package/dist/skills/fuzz/templates/Properties.sol +17 -0
  557. package/dist/skills/fuzz/templates/README.md +56 -0
  558. package/dist/skills/fuzz/templates/Snapshots.sol +26 -0
  559. package/dist/skills/fuzz/templates/echidna.yaml +18 -0
  560. package/dist/skills/fuzz/templates/handlers/Handlers.sol +13 -0
  561. package/dist/skills/fuzz/templates/medusa.json +93 -0
  562. package/dist/skills/fuzz/templates/utils/Clamp.sol +223 -0
  563. package/dist/skills/fuzz/templates/utils/DecimalPrinter.sol +63 -0
  564. package/dist/skills/fuzz/templates/utils/Deployer.sol +17 -0
  565. package/dist/skills/fuzz/templates/utils/EnumerableSet.sol +206 -0
  566. package/dist/skills/fuzz/templates/utils/Hevm.sol +62 -0
  567. package/dist/skills/fuzz/templates/utils/Logger.sol +619 -0
  568. package/dist/skills/fuzz/templates/utils/Math.sol +52 -0
  569. package/dist/skills/fuzz/templates/utils/MockERC20.sol +279 -0
  570. package/dist/skills/fuzz/templates/utils/PropertiesAsserts.sol +238 -0
  571. package/dist/skills/fuzz/templates/utils/StringUtils.sol +85 -0
  572. package/dist/skills/fuzz-convert/SKILL.md +249 -0
  573. package/dist/skills/fuzz-sync/SKILL.md +342 -0
  574. package/dist/skills/generate-poc.md +8 -26
  575. package/dist/skills/generate-report.md +24 -8
  576. package/dist/skills/ingest-aa-report.md +11 -30
  577. package/dist/skills/init-audit/SKILL.md +155 -0
  578. package/dist/skills/init-audit/references/agents/conformance-checker.md +36 -0
  579. package/dist/skills/init-audit/references/agents/contract-reader.md +59 -0
  580. package/dist/skills/init-audit/references/agents/diagram-composer.md +48 -0
  581. package/dist/skills/init-audit/references/agents/docs-extractor.md +26 -0
  582. package/dist/skills/init-audit/references/agents/prior-audit.md +32 -0
  583. package/dist/skills/init-audit/references/agents/regression-checker.md +28 -0
  584. package/dist/skills/init-audit/references/agents/skeptic.md +31 -0
  585. package/dist/skills/init-audit/references/agents/standards-checker.md +39 -0
  586. package/dist/skills/init-audit/references/agents/synthesizer.md +50 -0
  587. package/dist/skills/prevalidate.md +62 -0
  588. package/dist/skills/sync-issues.md +11 -25
  589. package/dist/skills/validate-all-findings.md +3 -3
  590. package/dist/skills/validate-finding.md +33 -28
  591. package/dist/skills/write-finding.md +6 -5
  592. package/dist/types/index.d.ts +22 -12
  593. package/dist/types/index.d.ts.map +1 -1
  594. package/package.json +6 -4
  595. package/dashboard/.next/server/app/_not-found.html +0 -1
  596. package/dashboard/.next/server/app/_not-found.meta +0 -6
  597. package/dashboard/.next/server/app/_not-found.rsc +0 -12
  598. package/dashboard/.next/server/app/access/page.js +0 -1
  599. package/dashboard/.next/server/app/access/page_client-reference-manifest.js +0 -1
  600. package/dashboard/.next/server/app/api/flows/route.js +0 -1
  601. package/dashboard/.next/server/app/api/mermaid/route.js +0 -1
  602. package/dashboard/.next/server/app/calls/page.js +0 -1
  603. package/dashboard/.next/server/app/calls/page_client-reference-manifest.js +0 -1
  604. package/dashboard/.next/server/app/conformance/page.js +0 -1
  605. package/dashboard/.next/server/app/conformance/page_client-reference-manifest.js +0 -1
  606. package/dashboard/.next/server/app/diagram/page.js +0 -1
  607. package/dashboard/.next/server/app/diagram/page.js.nft.json +0 -1
  608. package/dashboard/.next/server/app/diagram/page_client-reference-manifest.js +0 -1
  609. package/dashboard/.next/server/app/diagram.html +0 -1
  610. package/dashboard/.next/server/app/diagram.meta +0 -5
  611. package/dashboard/.next/server/app/diagram.rsc +0 -10
  612. package/dashboard/.next/server/app/flows/page.js +0 -1
  613. package/dashboard/.next/server/app/flows/page.js.nft.json +0 -1
  614. package/dashboard/.next/server/app/flows/page_client-reference-manifest.js +0 -1
  615. package/dashboard/.next/server/app/flows.html +0 -1
  616. package/dashboard/.next/server/app/flows.meta +0 -5
  617. package/dashboard/.next/server/app/flows.rsc +0 -10
  618. package/dashboard/.next/server/app/functions/page.js +0 -1
  619. package/dashboard/.next/server/app/functions/page.js.nft.json +0 -1
  620. package/dashboard/.next/server/app/functions/page_client-reference-manifest.js +0 -1
  621. package/dashboard/.next/server/app/notes/page.js +0 -22
  622. package/dashboard/.next/server/app/notes/page.js.nft.json +0 -1
  623. package/dashboard/.next/server/app/notes/page_client-reference-manifest.js +0 -1
  624. package/dashboard/.next/server/app/progress/page.js +0 -1
  625. package/dashboard/.next/server/app/progress/page.js.nft.json +0 -1
  626. package/dashboard/.next/server/app/progress/page_client-reference-manifest.js +0 -1
  627. package/dashboard/.next/server/app/stats/page.js +0 -1
  628. package/dashboard/.next/server/app/stats/page.js.nft.json +0 -1
  629. package/dashboard/.next/server/app/stats/page_client-reference-manifest.js +0 -1
  630. package/dashboard/.next/server/chunks/44.js +0 -1
  631. package/dashboard/.next/server/chunks/530.js +0 -1
  632. package/dashboard/.next/server/chunks/622.js +0 -3
  633. package/dashboard/.next/server/chunks/665.js +0 -13
  634. package/dashboard/.next/server/pages/404.html +0 -1
  635. package/dashboard/.next/static/AyrRAwu4mazjp8iX4Yjbb/_buildManifest.js +0 -1
  636. package/dashboard/.next/static/chunks/1015.3ab89142e5f44120.js +0 -226
  637. package/dashboard/.next/static/chunks/1151.b6ef5c786e587ed7.js +0 -1
  638. package/dashboard/.next/static/chunks/1199.a072929dbec89965.js +0 -148
  639. package/dashboard/.next/static/chunks/1375.d4d2f7fc9c9c2ff1.js +0 -43
  640. package/dashboard/.next/static/chunks/1799.83206776abbbf1fc.js +0 -9
  641. package/dashboard/.next/static/chunks/20154aaa.ccc347c04ab5ad4a.js +0 -1
  642. package/dashboard/.next/static/chunks/2077.7011a570c87aa7b1.js +0 -1
  643. package/dashboard/.next/static/chunks/2166.cc0fabeb2e89b840.js +0 -215
  644. package/dashboard/.next/static/chunks/2325.2c55cb9a6282ae3f.js +0 -24
  645. package/dashboard/.next/static/chunks/2694.92bbe252063e4786.js +0 -1
  646. package/dashboard/.next/static/chunks/275.0d761aa0e5b030b8.js +0 -34
  647. package/dashboard/.next/static/chunks/2781.8536b644a480aede.js +0 -93
  648. package/dashboard/.next/static/chunks/2805.a8d71d2f92bb6ba9.js +0 -1
  649. package/dashboard/.next/static/chunks/3017.e55781da9dd32d37.js +0 -1
  650. package/dashboard/.next/static/chunks/3205-728c260fbb4f89c6.js +0 -2
  651. package/dashboard/.next/static/chunks/3236.dff44fa7961d9d5e.js +0 -1
  652. package/dashboard/.next/static/chunks/3480.9451396ad7ee7613.js +0 -1
  653. package/dashboard/.next/static/chunks/3626.ba1cf848a9f2e93d.js +0 -64
  654. package/dashboard/.next/static/chunks/3865.a432a7910a2f5281.js +0 -90
  655. package/dashboard/.next/static/chunks/3887.c22cbfa3f095826c.js +0 -1
  656. package/dashboard/.next/static/chunks/3924-4a05057b5450abe1.js +0 -1
  657. package/dashboard/.next/static/chunks/3948.fe3c7d758568d98b.js +0 -287
  658. package/dashboard/.next/static/chunks/4728.07d87640a3e7dd0d.js +0 -24
  659. package/dashboard/.next/static/chunks/4787.4e5f6a0e0e40a583.js +0 -23
  660. package/dashboard/.next/static/chunks/5060.baca226af35ed016.js +0 -1
  661. package/dashboard/.next/static/chunks/5284.f949ac90c95ff143.js +0 -1
  662. package/dashboard/.next/static/chunks/5715.1524bcc9591e180b.js +0 -115
  663. package/dashboard/.next/static/chunks/6014.700ae4969b64d728.js +0 -104
  664. package/dashboard/.next/static/chunks/6024.4d23707c65514679.js +0 -79
  665. package/dashboard/.next/static/chunks/6177.e5c84cfc4c0dea51.js +0 -1
  666. package/dashboard/.next/static/chunks/618f8807-547c5614e1318888.js +0 -1
  667. package/dashboard/.next/static/chunks/6434.9481771c33195d29.js +0 -1
  668. package/dashboard/.next/static/chunks/6468.f4a3e8fa6accc6da.js +0 -77
  669. package/dashboard/.next/static/chunks/6540.86f367d7390738d4.js +0 -1
  670. package/dashboard/.next/static/chunks/6549.4d0d472df96429a5.js +0 -1
  671. package/dashboard/.next/static/chunks/690f35d0.3e40ca0930e4bbdb.js +0 -119
  672. package/dashboard/.next/static/chunks/7397-f6f4dddc7a20bfc1.js +0 -1
  673. package/dashboard/.next/static/chunks/7498-ea83cb9e30ec5491.js +0 -1
  674. package/dashboard/.next/static/chunks/7802.89aec9ee11680850.js +0 -80
  675. package/dashboard/.next/static/chunks/7973.8b526f589aca5d84.js +0 -79
  676. package/dashboard/.next/static/chunks/8216.1bead812eb126c35.js +0 -5
  677. package/dashboard/.next/static/chunks/8452-e616b5f43bceb95f.js +0 -13
  678. package/dashboard/.next/static/chunks/8645.a5ca76f11edc9633.js +0 -1
  679. package/dashboard/.next/static/chunks/8928-60c623ee89d2e6ad.js +0 -1
  680. package/dashboard/.next/static/chunks/9173.2486ffca31131ec5.js +0 -1
  681. package/dashboard/.next/static/chunks/9178.469341860bf8caec.js +0 -1
  682. package/dashboard/.next/static/chunks/9466.e904660d38c03eea.js +0 -1
  683. package/dashboard/.next/static/chunks/9660.84a85811380c5f33.js +0 -1
  684. package/dashboard/.next/static/chunks/9720.67d4d0d15a96d691.js +0 -1
  685. package/dashboard/.next/static/chunks/9811.65e1d080c2d256af.js +0 -1
  686. package/dashboard/.next/static/chunks/app/_not-found/page-548ab392d0e890d1.js +0 -1
  687. package/dashboard/.next/static/chunks/app/access/page-3668562e7464eb5d.js +0 -1
  688. package/dashboard/.next/static/chunks/app/calls/page-d07f5b8664cc8303.js +0 -1
  689. package/dashboard/.next/static/chunks/app/conformance/page-2fede1d7b5f9265d.js +0 -1
  690. package/dashboard/.next/static/chunks/app/diagram/page-b228444265546495.js +0 -1
  691. package/dashboard/.next/static/chunks/app/flows/page-fa67783d8cd79cab.js +0 -1
  692. package/dashboard/.next/static/chunks/app/functions/page-686f0296639133a3.js +0 -1
  693. package/dashboard/.next/static/chunks/app/issues/page-98a298e1c1045c91.js +0 -1
  694. package/dashboard/.next/static/chunks/app/layout-49f2496c7637d931.js +0 -1
  695. package/dashboard/.next/static/chunks/app/notes/page-17af94c67ba79c00.js +0 -1
  696. package/dashboard/.next/static/chunks/app/page-24bac51dfe007c66.js +0 -1
  697. package/dashboard/.next/static/chunks/app/progress/page-427fb18da3afb061.js +0 -1
  698. package/dashboard/.next/static/chunks/app/report/page-796f2f4a8a5ac8f7.js +0 -1
  699. package/dashboard/.next/static/chunks/app/stats/page-db81f600a086f252.js +0 -1
  700. package/dashboard/.next/static/chunks/c7ea4e13.5effeeba6618bdb7.js +0 -1
  701. package/dashboard/.next/static/chunks/framework-cf6f5bdca6ba0184.js +0 -33
  702. package/dashboard/.next/static/chunks/main-63ff429eab01f5bf.js +0 -1
  703. package/dashboard/.next/static/chunks/main-app-9d2f6b8a47133e9b.js +0 -1
  704. package/dashboard/.next/static/chunks/pages/_app-6ad2b50514c24ab4.js +0 -1
  705. package/dashboard/.next/static/chunks/pages/_error-d5eb11c5c4626811.js +0 -1
  706. package/dashboard/.next/static/chunks/webpack-08869f2b18792e51.js +0 -1
  707. package/dashboard/.next/static/css/4a38d8f6f6b7a68f.css +0 -3
  708. package/dashboard/.next/static/media/438aa629764e75f3-s.woff2 +0 -0
  709. package/dashboard/.next/static/media/4c9affa5bc8f420e-s.p.woff2 +0 -0
  710. package/dashboard/.next/static/media/51251f8b9793cdb3-s.woff2 +0 -0
  711. package/dashboard/.next/static/media/875ae681bfde4580-s.woff2 +0 -0
  712. package/dashboard/.next/static/media/cc978ac5ee68c2b6-s.woff2 +0 -0
  713. package/dashboard/.next/static/media/e857b654a2caa584-s.woff2 +0 -0
  714. package/dashboard/app/access/AccessClient.tsx +0 -402
  715. package/dashboard/app/access/ReadOnlyFunctions.tsx +0 -114
  716. package/dashboard/app/access/page.tsx +0 -125
  717. package/dashboard/app/api/flows/route.ts +0 -32
  718. package/dashboard/app/api/mermaid/route.ts +0 -25
  719. package/dashboard/app/calls/CallsClient.tsx +0 -170
  720. package/dashboard/app/calls/page.tsx +0 -57
  721. package/dashboard/app/conformance/ConformanceTable.tsx +0 -214
  722. package/dashboard/app/conformance/page.tsx +0 -186
  723. package/dashboard/app/diagram/page.tsx +0 -65
  724. package/dashboard/app/flows/page.tsx +0 -102
  725. package/dashboard/app/functions/FunctionsClient.tsx +0 -167
  726. package/dashboard/app/functions/page.tsx +0 -178
  727. package/dashboard/app/issues/IssuesBoardClient.tsx +0 -803
  728. package/dashboard/app/notes/NotesClient.tsx +0 -701
  729. package/dashboard/app/notes/page.tsx +0 -47
  730. package/dashboard/app/progress/ProgressClient.tsx +0 -354
  731. package/dashboard/app/progress/page.tsx +0 -127
  732. package/dashboard/app/stats/StatsClient.tsx +0 -452
  733. package/dashboard/app/stats/page.tsx +0 -50
  734. package/dashboard/components/ConfidenceBadge.tsx +0 -53
  735. package/dashboard/components/DashboardLayout.tsx +0 -485
  736. package/dashboard/components/FilterableTable.tsx +0 -293
  737. package/dashboard/components/MermaidViewer.tsx +0 -267
  738. package/dashboard/components/NotYetGenerated.tsx +0 -32
  739. package/dashboard/components/SeverityBadge.tsx +0 -28
  740. package/dashboard/components/SignalBars.tsx +0 -27
  741. package/dashboard/components/SortableTable.tsx +0 -122
  742. package/dashboard/lib/conformance-tokens.ts +0 -49
  743. package/dist/skills/init-audit.md +0 -284
  744. /package/dashboard/.next/server/app/api/{flows → xref}/route.js.nft.json +0 -0
  745. /package/dashboard/.next/server/app/{api/mermaid → excalidraw-assets/[...path]}/route.js.nft.json +0 -0
  746. /package/dashboard/.next/static/{AyrRAwu4mazjp8iX4Yjbb → bGV1ry1vvIbM5b506eVBR}/_ssgManifest.js +0 -0
@@ -0,0 +1,370 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * generate_handlers.js
4
+ *
5
+ * Reads entry-point-selection.json and generates handler files with
6
+ * pre-populated function signatures (clamped + unclamped) for each
7
+ * selected contract. Replaces the empty stubs that generate_suite.js
8
+ * creates so the LLM only needs to fill in body logic — not discover
9
+ * signatures, types, or naming conventions.
10
+ *
11
+ * Usage:
12
+ * node generate_handlers.js <PROJECT_ROOT> [options]
13
+ *
14
+ * Options:
15
+ * --suite-dir <dir> Suite directory (default: test/fizz)
16
+ * --meta-dir <dir> Metadata directory (default: .hex/fuzz/fizz_data)
17
+ * --selection <path> Entry-point selection file
18
+ * --force Overwrite handlers that already contain user edits
19
+ */
20
+
21
+ const fs = require('fs');
22
+ const path = require('path');
23
+
24
+ // ――――――――――――――――――――――――― Argument parsing ―――――――――――――――――――――――――
25
+
26
+ const args = process.argv.slice(2);
27
+ if (args.length === 0 || args[0] === '--help') {
28
+ console.log(
29
+ 'Usage: node generate_handlers.js <PROJECT_ROOT> ' +
30
+ '[--suite-dir <dir>] [--meta-dir <dir>] [--selection <path>] [--force]'
31
+ );
32
+ process.exit(0);
33
+ }
34
+
35
+ const projectRoot = path.resolve(args[0]);
36
+ let suiteRelDir = path.join('test', 'fizz');
37
+ let metaRelDir = '.hex/fuzz/fizz_data'; // Hex: was 'fizz_data'
38
+ let selectionPath = '';
39
+ let force = false;
40
+
41
+ for (let i = 1; i < args.length; i++) {
42
+ if (args[i] === '--suite-dir' && args[i + 1]) { suiteRelDir = args[++i]; }
43
+ else if (args[i] === '--meta-dir' && args[i + 1]) { metaRelDir = args[++i]; }
44
+ else if (args[i] === '--selection' && args[i + 1]) { selectionPath = path.resolve(args[++i]); }
45
+ else if (args[i] === '--force') { force = true; }
46
+ }
47
+
48
+ const suiteDir = path.join(projectRoot, suiteRelDir);
49
+ const metaDir = path.join(projectRoot, metaRelDir);
50
+ if (!selectionPath) {
51
+ selectionPath = path.join(metaDir, 'entry-point-selection.json');
52
+ }
53
+
54
+ // ――――――――――――――――――――――――― Type mapping ―――――――――――――――――――――――――
55
+
56
+ /**
57
+ * Reference-type keywords that require a `memory` data-location qualifier
58
+ * when used as function parameters in Solidity ≥0.5.
59
+ */
60
+ const MEMORY_TYPES = new Set(['bytes', 'string']);
61
+
62
+ /**
63
+ * Convert a contracts.json input descriptor to a Solidity parameter string.
64
+ *
65
+ * contracts.json stores:
66
+ * type – simplified ABI type ('array', 'contract', 'enum', or the raw type)
67
+ * internalType – Solidity-level type without 'struct '/'contract '/'enum ' prefix
68
+ * name – parameter name (may be empty)
69
+ */
70
+ function toSolidityParam(input, index) {
71
+ const name = input.name || `_arg${index}`;
72
+ const { type, internalType } = input;
73
+
74
+ // Contracts are address at the ABI level
75
+ if (type === 'contract') return `address ${name}`;
76
+
77
+ // Enums encode as uint8 at the ABI level
78
+ if (type === 'enum') return `uint8 ${name}`;
79
+
80
+ // Arrays — internalType has the real Solidity type (e.g. "uint256[]")
81
+ if (type === 'array') return `${internalType} memory ${name}`;
82
+
83
+ // Tuples (structs) — internalType has the struct path (e.g. "MyLib.MyStruct")
84
+ if (type === 'tuple') return `${internalType} memory ${name}`;
85
+
86
+ // Reference types that need 'memory'
87
+ if (MEMORY_TYPES.has(type)) return `${type} memory ${name}`;
88
+
89
+ // Value types — pass through (uint256, int128, address, bool, bytes32, …)
90
+ return `${type} ${name}`;
91
+ }
92
+
93
+ /**
94
+ * Return just the name portion of a parameter for use in call arguments.
95
+ */
96
+ function paramName(input, index) {
97
+ return input.name || `_arg${index}`;
98
+ }
99
+
100
+ // ――――――――――――――――――――――――― Helper utilities ―――――――――――――――――――――――――
101
+
102
+ /** Lowercase the first character of a string. */
103
+ function lcFirst(s) {
104
+ if (!s) return s;
105
+ return s.charAt(0).toLowerCase() + s.slice(1);
106
+ }
107
+
108
+ // ――――――――――――――――――――――――― Stub detection ―――――――――――――――――――――――――
109
+
110
+ /**
111
+ * Return true if the file looks like an unmodified stub from generate_suite.js:
112
+ * it has no function definitions between the Clamped / Unclamped markers.
113
+ */
114
+ function isStubHandler(filePath) {
115
+ if (!fs.existsSync(filePath)) return true; // treat missing as writable
116
+ const content = fs.readFileSync(filePath, 'utf8');
117
+ // Strip single-line comments to avoid matching "function" inside comments
118
+ const stripped = content.replace(/\/\/.*$/gm, '');
119
+ // If there are no `function ` keywords the file is still a bare stub
120
+ return !/\bfunction\s+\w+/.test(stripped);
121
+ }
122
+
123
+ // ――――――――――――――――――――――――― Handler generation ―――――――――――――――――――――――――
124
+
125
+ /**
126
+ * Build a complete handler Solidity file for a single contract from the
127
+ * entry-point-selection data.
128
+ */
129
+ const ADDRESS_TYPES = new Set(['address', 'contract']);
130
+
131
+ /**
132
+ * Build the dispatcher parameter list and a per-function arg-mapping for secondary functions.
133
+ *
134
+ * Strategy: numeric/bool/enum/other value types share a pool of uint256 slots; address/contract
135
+ * types share a separate pool of address slots. For each function the max pool usage across all
136
+ * secondary functions determines the total slot count. Slots are ordered: uint256 slots first,
137
+ * then address slots (matching the handler-patterns.md example).
138
+ *
139
+ * Returns:
140
+ * { paramStr, slotCount, funcArgExprs }
141
+ * - paramStr — Solidity parameter string for the dispatcher (after `uint8 selector, `)
142
+ * - slotCount — total number of generic args (uint256 + address)
143
+ * - funcArgExprs(func) — function that returns the call-argument expression array for a given func
144
+ */
145
+ function buildDispatcherSignature(secondaryFuncs) {
146
+ let maxUint256 = 0;
147
+ let maxAddress = 0;
148
+
149
+ // Count max slots of each kind needed by any single secondary function
150
+ for (const func of secondaryFuncs) {
151
+ let u = 0, a = 0;
152
+ for (const inp of func.inputs) {
153
+ if (ADDRESS_TYPES.has(inp.type)) a++;
154
+ else u++;
155
+ }
156
+ if (u > maxUint256) maxUint256 = u;
157
+ if (a > maxAddress) maxAddress = a;
158
+ }
159
+
160
+ // Build param list: arg0..argN-1 are uint256, argN..argM are address
161
+ const params = [];
162
+ for (let i = 0; i < maxUint256; i++) params.push(`uint256 arg${i}`);
163
+ for (let i = 0; i < maxAddress; i++) params.push(`address arg${maxUint256 + i}`);
164
+ const paramStr = params.join(', ');
165
+
166
+ function funcArgExprs(func) {
167
+ let uIdx = 0, aIdx = 0;
168
+ return func.inputs.map(inp => {
169
+ if (ADDRESS_TYPES.has(inp.type)) {
170
+ return `arg${maxUint256 + aIdx++}`;
171
+ }
172
+ const slot = `arg${uIdx++}`;
173
+ if (inp.type === 'bool') return `${slot} > 0`;
174
+ if (inp.type === 'enum') return `uint8(${slot})`;
175
+ if (/^uint\d+$/.test(inp.type) && inp.type !== 'uint256') return `${inp.type}(${slot})`;
176
+ return slot;
177
+ });
178
+ }
179
+
180
+ return { paramStr, funcArgExprs };
181
+ }
182
+
183
+ function buildHandler(contract) {
184
+ const contractName = contract.name;
185
+ const instanceName = lcFirst(contractName);
186
+ const functions = contract.functions || [];
187
+
188
+ const primaryFuncs = functions.filter(f => f.tier !== 'secondary');
189
+ const secondaryFuncs = functions.filter(f => f.tier === 'secondary');
190
+
191
+ const clampedLines = [];
192
+ const unclampedLines = [];
193
+
194
+ for (const func of primaryFuncs) {
195
+ const prefix = `${instanceName}_${func.name}`;
196
+ const isPayable = func.stateMutability === 'payable';
197
+
198
+ // --- Build parameter strings ---
199
+ const paramDecls = func.inputs.map((inp, i) => toSolidityParam(inp, i));
200
+ const paramNames = func.inputs.map((inp, i) => paramName(inp, i));
201
+ const paramStr = paramDecls.join(', ');
202
+ const argStr = paramNames.join(', ');
203
+
204
+ // --- Unclamped function ---
205
+ const payableKw = isPayable ? ' payable' : '';
206
+ const callValue = isPayable ? `{value: msg.value}` : '';
207
+ const callHint = `${instanceName}.${func.name}${callValue}(${argStr})`;
208
+
209
+ unclampedLines.push(
210
+ ` function ${prefix}(${paramStr}) public${payableKw} asActor {`,
211
+ ` // TODO: wire call — ${callHint};`,
212
+ ` }`,
213
+ '',
214
+ );
215
+
216
+ // --- Clamped function ---
217
+ const clampedParamStr = isPayable && func.inputs.length === 0
218
+ ? 'uint256 ethAmount'
219
+ : paramStr;
220
+
221
+ const forwardArgs = isPayable && func.inputs.length === 0
222
+ ? ''
223
+ : argStr;
224
+
225
+ clampedLines.push(
226
+ ` function ${prefix}_clamped(${clampedParamStr}) public {`,
227
+ );
228
+
229
+ // Add per-type clamping hints
230
+ for (const inp of func.inputs) {
231
+ const name = inp.name || `_arg${func.inputs.indexOf(inp)}`;
232
+ if (inp.type === 'uint256' || inp.type === 'uint128' || inp.type === 'uint64' || inp.type === 'uint32' || inp.type === 'uint8') {
233
+ clampedLines.push(` // TODO: clamp ${name} — e.g. ${name} = clampBetween(${name}, min, max);`);
234
+ } else if (inp.type === 'address') {
235
+ clampedLines.push(` // TODO: clamp ${name} — e.g. ${name} = toActor(${name});`);
236
+ }
237
+ }
238
+
239
+ if (isPayable && func.inputs.length === 0) {
240
+ clampedLines.push(
241
+ ` // TODO: clamp ethAmount and forward with value`,
242
+ ` ${prefix}();`,
243
+ );
244
+ } else {
245
+ clampedLines.push(
246
+ ` ${prefix}(${forwardArgs});`,
247
+ );
248
+ }
249
+
250
+ clampedLines.push(` }`, '');
251
+ }
252
+
253
+ // --- Secondary functions: individual unclamped stubs + dispatcher ---
254
+ if (secondaryFuncs.length > 0) {
255
+ const { paramStr: dispParamStr, funcArgExprs } = buildDispatcherSignature(secondaryFuncs);
256
+
257
+ // Individual unclamped stubs for secondary functions (internal, prefixed with _)
258
+ for (const func of secondaryFuncs) {
259
+ const prefix = `_${instanceName}_${func.name}`;
260
+ const isPayable = func.stateMutability === 'payable';
261
+ const paramDecls = func.inputs.map((inp, i) => toSolidityParam(inp, i));
262
+ const paramNames = func.inputs.map((inp, i) => paramName(inp, i));
263
+ const funcParamStr = paramDecls.join(', ');
264
+ const argStr = paramNames.join(', ');
265
+ const payableKw = isPayable ? ' payable' : '';
266
+ const callValue = isPayable ? `{value: msg.value}` : '';
267
+ const callHint = `${instanceName}.${func.name}${callValue}(${argStr})`;
268
+
269
+ unclampedLines.push(
270
+ ` function ${prefix}(${funcParamStr}) internal${payableKw} {`,
271
+ ` // TODO: wire call — ${callHint};`,
272
+ ` }`,
273
+ '',
274
+ );
275
+ }
276
+
277
+ // Dispatcher function — last in the clamped section
278
+ const dispatcherFullParams = dispParamStr ? `uint8 selector, ${dispParamStr}` : `uint8 selector`;
279
+ const n = secondaryFuncs.length;
280
+
281
+ clampedLines.push(
282
+ ` function ${instanceName}_secondary(${dispatcherFullParams}) public {`,
283
+ ` selector = uint8(selector % ${n});`,
284
+ );
285
+
286
+ secondaryFuncs.forEach((func, idx) => {
287
+ const prefix = `_${instanceName}_${func.name}`;
288
+ const args = funcArgExprs(func);
289
+ const callExpr = `${prefix}(${args.join(', ')})`;
290
+ if (idx === 0) {
291
+ clampedLines.push(` if (selector == 0) ${callExpr};`);
292
+ } else if (idx === n - 1) {
293
+ clampedLines.push(` else ${callExpr};`);
294
+ } else {
295
+ clampedLines.push(` else if (selector == ${idx}) ${callExpr};`);
296
+ }
297
+ });
298
+
299
+ clampedLines.push(` }`, '');
300
+ }
301
+
302
+ // Remove trailing blank line from each section
303
+ if (clampedLines.length && clampedLines[clampedLines.length - 1] === '') clampedLines.pop();
304
+ if (unclampedLines.length && unclampedLines[unclampedLines.length - 1] === '') unclampedLines.pop();
305
+
306
+ return `// SPDX-License-Identifier: MIT
307
+ pragma solidity >=0.6.2 <0.9.0;
308
+
309
+ import "../Base.sol";
310
+ import {Properties} from "../Properties.sol";
311
+
312
+ /// @notice Handles the interaction with ${contractName}
313
+ abstract contract ${contractName}Handler is Properties {
314
+
315
+ // ――――――――――――――――――――――――― Clamped ――――――――――――――――――――――――――
316
+
317
+ ${clampedLines.join('\n')}
318
+
319
+ // ―――――――――――――――――――――――― Unclamped ―――――――――――――――――――――――――
320
+
321
+ ${unclampedLines.join('\n')}
322
+ }
323
+ `;
324
+ }
325
+
326
+ // ――――――――――――――――――――――――――――― Main ――――――――――――――――――――――――――――――
327
+
328
+ function main() {
329
+ if (!fs.existsSync(selectionPath)) {
330
+ console.error(`Selection file not found: ${selectionPath}`);
331
+ console.error('Run select_functions.js first.');
332
+ process.exit(1);
333
+ }
334
+
335
+ const selection = JSON.parse(fs.readFileSync(selectionPath, 'utf8'));
336
+ if (!Array.isArray(selection) || selection.length === 0) {
337
+ console.error('No contracts in selection file.');
338
+ process.exit(1);
339
+ }
340
+
341
+ const handlersDir = path.join(suiteDir, 'handlers');
342
+ fs.mkdirSync(handlersDir, { recursive: true });
343
+
344
+ let written = 0;
345
+ let skipped = 0;
346
+
347
+ for (const contract of selection) {
348
+ if (!contract || !contract.name || !Array.isArray(contract.functions) || contract.functions.length === 0) {
349
+ continue;
350
+ }
351
+
352
+ const handlerPath = path.join(handlersDir, `${contract.name}Handler.sol`);
353
+ const relPath = path.relative(projectRoot, handlerPath);
354
+
355
+ if (!force && fs.existsSync(handlerPath) && !isStubHandler(handlerPath)) {
356
+ console.log(` [skip] ${relPath} (contains edits — use --force to overwrite)`);
357
+ skipped++;
358
+ continue;
359
+ }
360
+
361
+ const content = buildHandler(contract);
362
+ fs.writeFileSync(handlerPath, content);
363
+ console.log(` [wrote] ${relPath} (${contract.functions.length} functions)`);
364
+ written++;
365
+ }
366
+
367
+ console.log(`\nDone: ${written} handler(s) written, ${skipped} skipped.`);
368
+ }
369
+
370
+ main();
@@ -0,0 +1,254 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * generate_suite.js
4
+ *
5
+ * Copies the full template scaffold and fuzzer config into the target
6
+ * project's fuzzing directory, including static utility helpers such as
7
+ * MockERC20. The copied files are then modified by the LLM in later
8
+ * steps with full protocol context.
9
+ *
10
+ * Usage:
11
+ * node generate_suite.js <PROJECT_ROOT> [--suite-dir <path>] [--meta-dir <path>] [--templates <path>] [--selection <path>]
12
+ *
13
+ * Defaults:
14
+ * --suite-dir test/fizz (relative to project root)
15
+ * --meta-dir .hex/fuzz/fizz_data (relative to project root)
16
+ * --fuzzing-dir deprecated alias for --suite-dir
17
+ * --templates <script_dir>/../templates
18
+ * --selection <meta-dir>/entry-point-selection.json
19
+ */
20
+
21
+ const fs = require('fs');
22
+ const path = require('path');
23
+
24
+ // ――――――――――――――――――――――――― Argument parsing ―――――――――――――――――――――――――
25
+
26
+ const args = process.argv.slice(2);
27
+ if (args.length === 0 || args[0] === '--help') {
28
+ console.log('Usage: node generate_suite.js <PROJECT_ROOT> [--suite-dir <dir>] [--meta-dir <dir>] [--templates <dir>] [--selection <path>]');
29
+ process.exit(0);
30
+ }
31
+
32
+ const projectRoot = path.resolve(args[0]);
33
+ const scriptDir = __dirname;
34
+ let suiteRelDir = path.join('test', 'fizz');
35
+ let metaRelDir = '.hex/fuzz/fizz_data'; // Hex: was 'fizz_data'
36
+ let templatesDir = path.join(scriptDir, '..', 'templates');
37
+ let selectionPath = '';
38
+
39
+ for (let i = 1; i < args.length; i++) {
40
+ if (args[i] === '--suite-dir' && args[i + 1]) { suiteRelDir = args[++i]; }
41
+ else if (args[i] === '--meta-dir' && args[i + 1]) { metaRelDir = args[++i]; }
42
+ else if (args[i] === '--fuzzing-dir' && args[i + 1]) { suiteRelDir = args[++i]; }
43
+ else if (args[i] === '--templates' && args[i + 1]) { templatesDir = path.resolve(args[++i]); }
44
+ else if (args[i] === '--selection' && args[i + 1]) { selectionPath = path.resolve(args[++i]); }
45
+ }
46
+
47
+ const suiteDir = path.join(projectRoot, suiteRelDir);
48
+ const metaDir = path.join(projectRoot, metaRelDir);
49
+ if (!selectionPath) {
50
+ selectionPath = path.join(metaDir, 'entry-point-selection.json');
51
+ }
52
+
53
+ // ――――――――――――――――――――――――― Template copying ―――――――――――――――――――――――――
54
+
55
+ /**
56
+ * Recursively copy template files from src to dst, skipping existing files.
57
+ * This includes static utility helpers such as utils/MockERC20.sol.
58
+ */
59
+ function copyTemplates(src, dst, isRoot = false) {
60
+ const copied = [];
61
+ if (!fs.existsSync(dst)) {
62
+ fs.mkdirSync(dst, { recursive: true });
63
+ }
64
+
65
+ for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
66
+ const srcPath = path.join(src, entry.name);
67
+ const dstPath = path.join(dst, entry.name);
68
+ const relativeSrcPath = path.relative(templatesDir, srcPath);
69
+
70
+ // Skip config files at root level — handled separately
71
+ if (isRoot && (entry.name === 'echidna.yaml' || entry.name === 'medusa.json')) continue;
72
+ if (relativeSrcPath === path.join('handlers', 'Handlers.sol')) continue;
73
+
74
+ if (entry.isDirectory()) {
75
+ copied.push(...copyTemplates(srcPath, dstPath));
76
+ } else if (entry.isFile()) {
77
+ if (fs.existsSync(dstPath)) {
78
+ console.log(` [exists] ${path.relative(projectRoot, dstPath)}`);
79
+ } else {
80
+ // 'fizz_data' is the placeholder the templates use, not the default meta dir (Hex).
81
+ const needsSubstitution = metaRelDir !== 'fizz_data' && entry.name === 'README.md';
82
+ if (needsSubstitution) {
83
+ const content = fs.readFileSync(srcPath, 'utf8').replaceAll('fizz_data', metaRelDir);
84
+ fs.writeFileSync(dstPath, content);
85
+ } else {
86
+ fs.copyFileSync(srcPath, dstPath);
87
+ }
88
+ copied.push(dstPath);
89
+ console.log(` [new] ${path.relative(projectRoot, dstPath)}`);
90
+ }
91
+ }
92
+ }
93
+ return copied;
94
+ }
95
+
96
+ // ――――――――――――――――――――― Config file placement ―――――――――――――――――――――――
97
+
98
+ function copyRootConfigs() {
99
+ for (const filename of ['echidna.yaml', 'medusa.json']) {
100
+ const src = path.join(templatesDir, filename);
101
+ const dst = path.join(projectRoot, filename);
102
+ if (!fs.existsSync(src)) continue;
103
+
104
+ if (fs.existsSync(dst)) {
105
+ console.log(` [exists] ${path.relative(projectRoot, dst)}`);
106
+ } else {
107
+ let content = fs.readFileSync(src, 'utf8');
108
+ // 'fizz_data' is the placeholder the templates use (Hex: the default meta dir is .hex/fuzz/fizz_data).
109
+ if (metaRelDir !== 'fizz_data') {
110
+ content = content.replaceAll('fizz_data', metaRelDir);
111
+ }
112
+ fs.writeFileSync(dst, content);
113
+ console.log(` [new] ${path.relative(projectRoot, dst)}`);
114
+ }
115
+ }
116
+ }
117
+
118
+ // ――――――――――――――――――――― Selection-driven handler generation ――――――――――――――――――
119
+
120
+ function readSelectedContracts() {
121
+ if (!fs.existsSync(selectionPath)) {
122
+ console.error(`Selection file not found: ${selectionPath}`);
123
+ console.error('Run select_functions.js first.');
124
+ process.exit(1);
125
+ }
126
+
127
+ const selection = JSON.parse(fs.readFileSync(selectionPath, 'utf8'));
128
+ if (!Array.isArray(selection)) {
129
+ console.error(`Invalid selection file: ${selectionPath}`);
130
+ console.error('Expected a JSON array of selected contracts.');
131
+ process.exit(1);
132
+ }
133
+
134
+ const uniqueContracts = [];
135
+ const seen = new Set();
136
+
137
+ for (const contract of selection) {
138
+ if (!contract || typeof contract.name !== 'string' || contract.name.length === 0) continue;
139
+ if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(contract.name)) {
140
+ console.warn(` [skip] Invalid Solidity identifier: "${contract.name}"`);
141
+ continue;
142
+ }
143
+ if (seen.has(contract.name)) continue;
144
+ seen.add(contract.name);
145
+ uniqueContracts.push(contract.name);
146
+ }
147
+
148
+ if (uniqueContracts.length === 0) {
149
+ console.error(`No selected contracts found in: ${selectionPath}`);
150
+ process.exit(1);
151
+ }
152
+
153
+ return uniqueContracts;
154
+ }
155
+
156
+ function buildHandlerTemplate(contractName) {
157
+ return `// SPDX-License-Identifier: MIT
158
+ pragma solidity >=0.6.2 <0.9.0;
159
+
160
+ import "../Base.sol";
161
+ import {Properties} from "../Properties.sol";
162
+
163
+ /// @notice Handles the interaction with ${contractName}
164
+ abstract contract ${contractName}Handler is Properties {
165
+
166
+ // ――――――――――――――――――――――――― Clamped ――――――――――――――――――――――――――
167
+
168
+ // ―――――――――――――――――――――――― Unclamped ―――――――――――――――――――――――――
169
+ }
170
+ `;
171
+ }
172
+
173
+ function buildHandlersAggregator(contractNames) {
174
+ const imports = contractNames
175
+ .map((contractName) => `import {${contractName}Handler} from "./${contractName}Handler.sol";`)
176
+ .join('\n');
177
+ const inheritance = contractNames
178
+ .map((contractName, index) => ` ${contractName}Handler${index < contractNames.length - 1 ? ',' : ''}`)
179
+ .join('\n');
180
+
181
+ return `// SPDX-License-Identifier: MIT
182
+ pragma solidity >=0.6.2 <0.9.0;
183
+
184
+ import "../Base.sol";
185
+ ${imports}
186
+
187
+ /// @notice Inherits from all the handlers to expose all entry points in a single contract.
188
+ /// Manages environment changes (e.g. current actor, current token, mocks setup, etc.).
189
+ abstract contract Handlers is
190
+ ${inheritance}
191
+ {
192
+ function setCurrentActor(uint256 entropy) public {
193
+ actor = actors[entropy % actors.length];
194
+ }
195
+ }
196
+ `;
197
+ }
198
+
199
+ function writeGeneratedHandlers(contractNames) {
200
+ const handlersDir = path.join(suiteDir, 'handlers');
201
+ fs.mkdirSync(handlersDir, { recursive: true });
202
+
203
+ for (const contractName of contractNames) {
204
+ const handlerPath = path.join(handlersDir, `${contractName}Handler.sol`);
205
+ if (fs.existsSync(handlerPath)) {
206
+ console.log(` [exists] ${path.relative(projectRoot, handlerPath)}`);
207
+ continue;
208
+ }
209
+
210
+ fs.writeFileSync(handlerPath, buildHandlerTemplate(contractName));
211
+ console.log(` [new] ${path.relative(projectRoot, handlerPath)}`);
212
+ }
213
+ }
214
+
215
+ function writeHandlersAggregator(contractNames) {
216
+ const handlersPath = path.join(suiteDir, 'handlers', 'Handlers.sol');
217
+ const generatedContent = buildHandlersAggregator(contractNames);
218
+
219
+ if (fs.existsSync(handlersPath)) {
220
+ console.log(` [exists] ${path.relative(projectRoot, handlersPath)}`);
221
+ return;
222
+ }
223
+
224
+ fs.writeFileSync(handlersPath, generatedContent);
225
+ console.log(` [new] ${path.relative(projectRoot, handlersPath)}`);
226
+ }
227
+
228
+ // ――――――――――――――――――――――――――――― Main ――――――――――――――――――――――――――――――
229
+
230
+ function main() {
231
+ if (!fs.existsSync(templatesDir)) {
232
+ console.error(`Templates directory not found: ${templatesDir}`);
233
+ process.exit(1);
234
+ }
235
+
236
+ const selectedContracts = readSelectedContracts();
237
+
238
+ console.log('Copying template scaffold...');
239
+ const copied = copyTemplates(templatesDir, suiteDir, true);
240
+
241
+ console.log('\nCopying config files...');
242
+ copyRootConfigs();
243
+
244
+ console.log('\nGenerating handler stubs...');
245
+ writeGeneratedHandlers(selectedContracts);
246
+ writeHandlersAggregator(selectedContracts);
247
+
248
+ console.log('\nScaffold complete.');
249
+ console.log(` new files: ${copied.length}`);
250
+ console.log('\nNext: the LLM modifies the copied scaffold in later steps');
251
+ console.log('to wire setup, generate handlers, and add invariants.');
252
+ }
253
+
254
+ main();