@cleocode/mcp-server 0.86.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 (374) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +306 -0
  3. package/dist/domains/index.d.ts +16 -0
  4. package/dist/domains/index.d.ts.map +1 -0
  5. package/dist/domains/index.js +16 -0
  6. package/dist/domains/index.js.map +1 -0
  7. package/dist/domains/lifecycle.d.ts +147 -0
  8. package/dist/domains/lifecycle.d.ts.map +1 -0
  9. package/dist/domains/lifecycle.js +452 -0
  10. package/dist/domains/lifecycle.js.map +1 -0
  11. package/dist/domains/orchestrate.d.ts +133 -0
  12. package/dist/domains/orchestrate.d.ts.map +1 -0
  13. package/dist/domains/orchestrate.js +465 -0
  14. package/dist/domains/orchestrate.js.map +1 -0
  15. package/dist/domains/release.d.ts +109 -0
  16. package/dist/domains/release.d.ts.map +1 -0
  17. package/dist/domains/release.js +400 -0
  18. package/dist/domains/release.js.map +1 -0
  19. package/dist/domains/research.d.ts +139 -0
  20. package/dist/domains/research.d.ts.map +1 -0
  21. package/dist/domains/research.js +606 -0
  22. package/dist/domains/research.js.map +1 -0
  23. package/dist/domains/session.d.ts +129 -0
  24. package/dist/domains/session.d.ts.map +1 -0
  25. package/dist/domains/session.js +433 -0
  26. package/dist/domains/session.js.map +1 -0
  27. package/dist/domains/system.d.ts +92 -0
  28. package/dist/domains/system.d.ts.map +1 -0
  29. package/dist/domains/system.js +473 -0
  30. package/dist/domains/system.js.map +1 -0
  31. package/dist/domains/tasks.d.ts +180 -0
  32. package/dist/domains/tasks.d.ts.map +1 -0
  33. package/dist/domains/tasks.js +704 -0
  34. package/dist/domains/tasks.js.map +1 -0
  35. package/dist/domains/validate.d.ts +150 -0
  36. package/dist/domains/validate.d.ts.map +1 -0
  37. package/dist/domains/validate.js +568 -0
  38. package/dist/domains/validate.js.map +1 -0
  39. package/dist/gateways/mutate.d.ts +100 -0
  40. package/dist/gateways/mutate.d.ts.map +1 -0
  41. package/dist/gateways/mutate.js +937 -0
  42. package/dist/gateways/mutate.js.map +1 -0
  43. package/dist/gateways/query.d.ts +91 -0
  44. package/dist/gateways/query.d.ts.map +1 -0
  45. package/dist/gateways/query.js +245 -0
  46. package/dist/gateways/query.js.map +1 -0
  47. package/dist/index.d.ts +21 -0
  48. package/dist/index.d.ts.map +1 -0
  49. package/dist/index.js +299 -0
  50. package/dist/index.js.map +1 -0
  51. package/dist/lib/audit.d.ts +118 -0
  52. package/dist/lib/audit.d.ts.map +1 -0
  53. package/dist/lib/audit.js +311 -0
  54. package/dist/lib/audit.js.map +1 -0
  55. package/dist/lib/background-jobs.d.ts +86 -0
  56. package/dist/lib/background-jobs.d.ts.map +1 -0
  57. package/dist/lib/background-jobs.js +183 -0
  58. package/dist/lib/background-jobs.js.map +1 -0
  59. package/dist/lib/cache.d.ts +78 -0
  60. package/dist/lib/cache.d.ts.map +1 -0
  61. package/dist/lib/cache.js +204 -0
  62. package/dist/lib/cache.js.map +1 -0
  63. package/dist/lib/command-builder.d.ts +52 -0
  64. package/dist/lib/command-builder.d.ts.map +1 -0
  65. package/dist/lib/command-builder.js +280 -0
  66. package/dist/lib/command-builder.js.map +1 -0
  67. package/dist/lib/config.d.ts +42 -0
  68. package/dist/lib/config.d.ts.map +1 -0
  69. package/dist/lib/config.js +248 -0
  70. package/dist/lib/config.js.map +1 -0
  71. package/dist/lib/defaults.d.ts +115 -0
  72. package/dist/lib/defaults.d.ts.map +1 -0
  73. package/dist/lib/defaults.js +61 -0
  74. package/dist/lib/defaults.js.map +1 -0
  75. package/dist/lib/error-handler.d.ts +101 -0
  76. package/dist/lib/error-handler.d.ts.map +1 -0
  77. package/dist/lib/error-handler.js +277 -0
  78. package/dist/lib/error-handler.js.map +1 -0
  79. package/dist/lib/executor.d.ts +110 -0
  80. package/dist/lib/executor.d.ts.map +1 -0
  81. package/dist/lib/executor.js +362 -0
  82. package/dist/lib/executor.js.map +1 -0
  83. package/dist/lib/exit-codes.d.ts +190 -0
  84. package/dist/lib/exit-codes.d.ts.map +1 -0
  85. package/dist/lib/exit-codes.js +1027 -0
  86. package/dist/lib/exit-codes.js.map +1 -0
  87. package/dist/lib/formatter.d.ts +196 -0
  88. package/dist/lib/formatter.d.ts.map +1 -0
  89. package/dist/lib/formatter.js +260 -0
  90. package/dist/lib/formatter.js.map +1 -0
  91. package/dist/lib/gate-validators.d.ts +103 -0
  92. package/dist/lib/gate-validators.d.ts.map +1 -0
  93. package/dist/lib/gate-validators.js +689 -0
  94. package/dist/lib/gate-validators.js.map +1 -0
  95. package/dist/lib/manifest-parser.d.ts +61 -0
  96. package/dist/lib/manifest-parser.d.ts.map +1 -0
  97. package/dist/lib/manifest-parser.js +338 -0
  98. package/dist/lib/manifest-parser.js.map +1 -0
  99. package/dist/lib/manifest.d.ts +177 -0
  100. package/dist/lib/manifest.d.ts.map +1 -0
  101. package/dist/lib/manifest.js +301 -0
  102. package/dist/lib/manifest.js.map +1 -0
  103. package/dist/lib/protocol-enforcement.d.ts +105 -0
  104. package/dist/lib/protocol-enforcement.d.ts.map +1 -0
  105. package/dist/lib/protocol-enforcement.js +331 -0
  106. package/dist/lib/protocol-enforcement.js.map +1 -0
  107. package/dist/lib/protocol-rules.d.ts +55 -0
  108. package/dist/lib/protocol-rules.d.ts.map +1 -0
  109. package/dist/lib/protocol-rules.js +760 -0
  110. package/dist/lib/protocol-rules.js.map +1 -0
  111. package/dist/lib/rate-limiter.d.ts +110 -0
  112. package/dist/lib/rate-limiter.d.ts.map +1 -0
  113. package/dist/lib/rate-limiter.js +208 -0
  114. package/dist/lib/rate-limiter.js.map +1 -0
  115. package/dist/lib/router.d.ts +126 -0
  116. package/dist/lib/router.d.ts.map +1 -0
  117. package/dist/lib/router.js +276 -0
  118. package/dist/lib/router.js.map +1 -0
  119. package/dist/lib/schema.d.ts +55 -0
  120. package/dist/lib/schema.d.ts.map +1 -0
  121. package/dist/lib/schema.js +70 -0
  122. package/dist/lib/schema.js.map +1 -0
  123. package/dist/lib/security.d.ts +156 -0
  124. package/dist/lib/security.d.ts.map +1 -0
  125. package/dist/lib/security.js +347 -0
  126. package/dist/lib/security.js.map +1 -0
  127. package/dist/lib/verification-gates.d.ts +287 -0
  128. package/dist/lib/verification-gates.d.ts.map +1 -0
  129. package/dist/lib/verification-gates.js +548 -0
  130. package/dist/lib/verification-gates.js.map +1 -0
  131. package/dist/types/domain.d.ts +29 -0
  132. package/dist/types/domain.d.ts.map +1 -0
  133. package/dist/types/domain.js +7 -0
  134. package/dist/types/domain.js.map +1 -0
  135. package/dist/types/error.d.ts +101 -0
  136. package/dist/types/error.d.ts.map +1 -0
  137. package/dist/types/error.js +61 -0
  138. package/dist/types/error.js.map +1 -0
  139. package/dist/types/gateway.d.ts +78 -0
  140. package/dist/types/gateway.d.ts.map +1 -0
  141. package/dist/types/gateway.js +7 -0
  142. package/dist/types/gateway.js.map +1 -0
  143. package/dist/types/index.d.ts +21 -0
  144. package/dist/types/index.d.ts.map +1 -0
  145. package/dist/types/index.js +11 -0
  146. package/dist/types/index.js.map +1 -0
  147. package/dist/types/operations/lifecycle.d.ts +140 -0
  148. package/dist/types/operations/lifecycle.d.ts.map +1 -0
  149. package/dist/types/operations/lifecycle.js +8 -0
  150. package/dist/types/operations/lifecycle.js.map +1 -0
  151. package/dist/types/operations/orchestrate.d.ts +140 -0
  152. package/dist/types/operations/orchestrate.d.ts.map +1 -0
  153. package/dist/types/operations/orchestrate.js +8 -0
  154. package/dist/types/operations/orchestrate.js.map +1 -0
  155. package/dist/types/operations/release.d.ts +97 -0
  156. package/dist/types/operations/release.d.ts.map +1 -0
  157. package/dist/types/operations/release.js +7 -0
  158. package/dist/types/operations/release.js.map +1 -0
  159. package/dist/types/operations/research.d.ts +122 -0
  160. package/dist/types/operations/research.d.ts.map +1 -0
  161. package/dist/types/operations/research.js +8 -0
  162. package/dist/types/operations/research.js.map +1 -0
  163. package/dist/types/operations/session.d.ts +108 -0
  164. package/dist/types/operations/session.d.ts.map +1 -0
  165. package/dist/types/operations/session.js +8 -0
  166. package/dist/types/operations/session.js.map +1 -0
  167. package/dist/types/operations/system.d.ts +147 -0
  168. package/dist/types/operations/system.d.ts.map +1 -0
  169. package/dist/types/operations/system.js +8 -0
  170. package/dist/types/operations/system.js.map +1 -0
  171. package/dist/types/operations/tasks.d.ts +186 -0
  172. package/dist/types/operations/tasks.d.ts.map +1 -0
  173. package/dist/types/operations/tasks.js +8 -0
  174. package/dist/types/operations/tasks.js.map +1 -0
  175. package/dist/types/operations/validate.d.ts +170 -0
  176. package/dist/types/operations/validate.d.ts.map +1 -0
  177. package/dist/types/operations/validate.js +8 -0
  178. package/dist/types/operations/validate.js.map +1 -0
  179. package/package.json +67 -0
  180. package/schemas/IMPLEMENTATION-SUMMARY.md +250 -0
  181. package/schemas/README.md +284 -0
  182. package/schemas/common/error.schema.json +54 -0
  183. package/schemas/common/meta.schema.json +39 -0
  184. package/schemas/common/pagination.schema.json +32 -0
  185. package/schemas/index.json +159 -0
  186. package/schemas/requests/lifecycle/check.schema.json +20 -0
  187. package/schemas/requests/lifecycle/gate.fail.schema.json +25 -0
  188. package/schemas/requests/lifecycle/gate.pass.schema.json +28 -0
  189. package/schemas/requests/lifecycle/gates.schema.json +15 -0
  190. package/schemas/requests/lifecycle/history.schema.json +15 -0
  191. package/schemas/requests/lifecycle/prerequisites.schema.json +15 -0
  192. package/schemas/requests/lifecycle/progress.schema.json +29 -0
  193. package/schemas/requests/lifecycle/reset.schema.json +25 -0
  194. package/schemas/requests/lifecycle/skip.schema.json +25 -0
  195. package/schemas/requests/lifecycle/status.schema.json +23 -0
  196. package/schemas/requests/orchestrate/analyze.schema.json +15 -0
  197. package/schemas/requests/orchestrate/context.schema.json +13 -0
  198. package/schemas/requests/orchestrate/next.schema.json +15 -0
  199. package/schemas/requests/orchestrate/parallel.end.schema.json +20 -0
  200. package/schemas/requests/orchestrate/parallel.start.schema.json +20 -0
  201. package/schemas/requests/orchestrate/ready.schema.json +15 -0
  202. package/schemas/requests/orchestrate/skill.list.schema.json +13 -0
  203. package/schemas/requests/orchestrate/spawn.schema.json +25 -0
  204. package/schemas/requests/orchestrate/startup.schema.json +15 -0
  205. package/schemas/requests/orchestrate/status.schema.json +15 -0
  206. package/schemas/requests/orchestrate/validate.schema.json +15 -0
  207. package/schemas/requests/orchestrate/waves.schema.json +15 -0
  208. package/schemas/requests/release/changelog.schema.json +23 -0
  209. package/schemas/requests/release/commit.schema.json +22 -0
  210. package/schemas/requests/release/gates.run.schema.json +17 -0
  211. package/schemas/requests/release/prepare.schema.json +20 -0
  212. package/schemas/requests/release/push.schema.json +20 -0
  213. package/schemas/requests/release/rollback.schema.json +20 -0
  214. package/schemas/requests/release/tag.schema.json +19 -0
  215. package/schemas/requests/research/inject.schema.json +24 -0
  216. package/schemas/requests/research/link.schema.json +25 -0
  217. package/schemas/requests/research/list.schema.json +19 -0
  218. package/schemas/requests/research/manifest.append.schema.json +20 -0
  219. package/schemas/requests/research/manifest.archive.schema.json +19 -0
  220. package/schemas/requests/research/manifest.read.schema.json +21 -0
  221. package/schemas/requests/research/pending.schema.json +14 -0
  222. package/schemas/requests/research/query.schema.json +21 -0
  223. package/schemas/requests/research/show.schema.json +14 -0
  224. package/schemas/requests/research/stats.schema.json +14 -0
  225. package/schemas/requests/session/end.schema.json +13 -0
  226. package/schemas/requests/session/focus.clear.schema.json +7 -0
  227. package/schemas/requests/session/focus.get.schema.json +7 -0
  228. package/schemas/requests/session/focus.set.schema.json +15 -0
  229. package/schemas/requests/session/gc.schema.json +14 -0
  230. package/schemas/requests/session/history.schema.json +16 -0
  231. package/schemas/requests/session/list.schema.json +13 -0
  232. package/schemas/requests/session/resume.schema.json +14 -0
  233. package/schemas/requests/session/show.schema.json +14 -0
  234. package/schemas/requests/session/start.schema.json +23 -0
  235. package/schemas/requests/session/status.schema.json +7 -0
  236. package/schemas/requests/session/suspend.schema.json +13 -0
  237. package/schemas/requests/system/backup.schema.json +19 -0
  238. package/schemas/requests/system/cleanup.schema.json +20 -0
  239. package/schemas/requests/system/config.get.schema.json +14 -0
  240. package/schemas/requests/system/config.set.schema.json +24 -0
  241. package/schemas/requests/system/context.schema.json +7 -0
  242. package/schemas/requests/system/doctor.schema.json +7 -0
  243. package/schemas/requests/system/init.schema.json +18 -0
  244. package/schemas/requests/system/migrate.schema.json +19 -0
  245. package/schemas/requests/system/restore.schema.json +14 -0
  246. package/schemas/requests/system/stats.schema.json +7 -0
  247. package/schemas/requests/system/sync.schema.json +15 -0
  248. package/schemas/requests/system/version.schema.json +7 -0
  249. package/schemas/requests/tasks/analyze.schema.json +14 -0
  250. package/schemas/requests/tasks/archive.schema.json +19 -0
  251. package/schemas/requests/tasks/blockers.schema.json +15 -0
  252. package/schemas/requests/tasks/complete.schema.json +24 -0
  253. package/schemas/requests/tasks/create.schema.json +48 -0
  254. package/schemas/requests/tasks/delete.schema.json +20 -0
  255. package/schemas/requests/tasks/deps.schema.json +21 -0
  256. package/schemas/requests/tasks/exists.schema.json +15 -0
  257. package/schemas/requests/tasks/find.schema.json +22 -0
  258. package/schemas/requests/tasks/get.schema.json +15 -0
  259. package/schemas/requests/tasks/list.schema.json +26 -0
  260. package/schemas/requests/tasks/next.schema.json +21 -0
  261. package/schemas/requests/tasks/promote.schema.json +15 -0
  262. package/schemas/requests/tasks/reopen.schema.json +15 -0
  263. package/schemas/requests/tasks/reorder.schema.json +20 -0
  264. package/schemas/requests/tasks/reparent.schema.json +20 -0
  265. package/schemas/requests/tasks/tree.schema.json +21 -0
  266. package/schemas/requests/tasks/unarchive.schema.json +15 -0
  267. package/schemas/requests/tasks/update.schema.json +41 -0
  268. package/schemas/requests/validate/compliance.record.schema.json +20 -0
  269. package/schemas/requests/validate/compliance.summary.schema.json +18 -0
  270. package/schemas/requests/validate/compliance.violations.schema.json +19 -0
  271. package/schemas/requests/validate/manifest.schema.json +23 -0
  272. package/schemas/requests/validate/output.schema.json +19 -0
  273. package/schemas/requests/validate/protocol.schema.json +20 -0
  274. package/schemas/requests/validate/schema.schema.json +19 -0
  275. package/schemas/requests/validate/task.schema.json +21 -0
  276. package/schemas/requests/validate/test.coverage.schema.json +14 -0
  277. package/schemas/requests/validate/test.run.schema.json +22 -0
  278. package/schemas/requests/validate/test.status.schema.json +14 -0
  279. package/schemas/responses/common-error.schema.json +20 -0
  280. package/schemas/responses/common-success.schema.json +21 -0
  281. package/schemas/responses/lifecycle/check.schema.json +18 -0
  282. package/schemas/responses/lifecycle/gate.fail.schema.json +18 -0
  283. package/schemas/responses/lifecycle/gate.pass.schema.json +18 -0
  284. package/schemas/responses/lifecycle/gates.schema.json +18 -0
  285. package/schemas/responses/lifecycle/history.schema.json +18 -0
  286. package/schemas/responses/lifecycle/prerequisites.schema.json +18 -0
  287. package/schemas/responses/lifecycle/progress.schema.json +18 -0
  288. package/schemas/responses/lifecycle/reset.schema.json +18 -0
  289. package/schemas/responses/lifecycle/skip.schema.json +18 -0
  290. package/schemas/responses/lifecycle/status.schema.json +18 -0
  291. package/schemas/responses/orchestrate/analyze.schema.json +18 -0
  292. package/schemas/responses/orchestrate/context.schema.json +18 -0
  293. package/schemas/responses/orchestrate/next.schema.json +18 -0
  294. package/schemas/responses/orchestrate/parallel.end.schema.json +18 -0
  295. package/schemas/responses/orchestrate/parallel.start.schema.json +18 -0
  296. package/schemas/responses/orchestrate/ready.schema.json +18 -0
  297. package/schemas/responses/orchestrate/skill.list.schema.json +18 -0
  298. package/schemas/responses/orchestrate/spawn.schema.json +18 -0
  299. package/schemas/responses/orchestrate/startup.schema.json +18 -0
  300. package/schemas/responses/orchestrate/status.schema.json +18 -0
  301. package/schemas/responses/orchestrate/validate.schema.json +18 -0
  302. package/schemas/responses/orchestrate/waves.schema.json +18 -0
  303. package/schemas/responses/release/changelog.schema.json +18 -0
  304. package/schemas/responses/release/commit.schema.json +18 -0
  305. package/schemas/responses/release/gates.run.schema.json +18 -0
  306. package/schemas/responses/release/prepare.schema.json +18 -0
  307. package/schemas/responses/release/push.schema.json +18 -0
  308. package/schemas/responses/release/rollback.schema.json +18 -0
  309. package/schemas/responses/release/tag.schema.json +18 -0
  310. package/schemas/responses/research/inject.schema.json +18 -0
  311. package/schemas/responses/research/link.schema.json +18 -0
  312. package/schemas/responses/research/list.schema.json +18 -0
  313. package/schemas/responses/research/manifest.append.schema.json +18 -0
  314. package/schemas/responses/research/manifest.archive.schema.json +18 -0
  315. package/schemas/responses/research/manifest.read.schema.json +18 -0
  316. package/schemas/responses/research/pending.schema.json +18 -0
  317. package/schemas/responses/research/query.schema.json +18 -0
  318. package/schemas/responses/research/show.schema.json +18 -0
  319. package/schemas/responses/research/stats.schema.json +18 -0
  320. package/schemas/responses/session/end.schema.json +18 -0
  321. package/schemas/responses/session/focus.clear.schema.json +18 -0
  322. package/schemas/responses/session/focus.get.schema.json +18 -0
  323. package/schemas/responses/session/focus.set.schema.json +18 -0
  324. package/schemas/responses/session/gc.schema.json +18 -0
  325. package/schemas/responses/session/history.schema.json +18 -0
  326. package/schemas/responses/session/list.schema.json +18 -0
  327. package/schemas/responses/session/resume.schema.json +18 -0
  328. package/schemas/responses/session/show.schema.json +18 -0
  329. package/schemas/responses/session/start.schema.json +18 -0
  330. package/schemas/responses/session/status.schema.json +18 -0
  331. package/schemas/responses/session/suspend.schema.json +18 -0
  332. package/schemas/responses/system/backup.schema.json +18 -0
  333. package/schemas/responses/system/cleanup.schema.json +18 -0
  334. package/schemas/responses/system/config.get.schema.json +18 -0
  335. package/schemas/responses/system/config.set.schema.json +18 -0
  336. package/schemas/responses/system/context.schema.json +18 -0
  337. package/schemas/responses/system/doctor.schema.json +18 -0
  338. package/schemas/responses/system/init.schema.json +18 -0
  339. package/schemas/responses/system/migrate.schema.json +18 -0
  340. package/schemas/responses/system/restore.schema.json +18 -0
  341. package/schemas/responses/system/stats.schema.json +18 -0
  342. package/schemas/responses/system/sync.schema.json +18 -0
  343. package/schemas/responses/system/version.schema.json +18 -0
  344. package/schemas/responses/tasks/analyze.schema.json +18 -0
  345. package/schemas/responses/tasks/archive.schema.json +18 -0
  346. package/schemas/responses/tasks/blockers.schema.json +18 -0
  347. package/schemas/responses/tasks/complete.schema.json +18 -0
  348. package/schemas/responses/tasks/create.schema.json +18 -0
  349. package/schemas/responses/tasks/delete.schema.json +18 -0
  350. package/schemas/responses/tasks/deps.schema.json +18 -0
  351. package/schemas/responses/tasks/exists.schema.json +18 -0
  352. package/schemas/responses/tasks/find.schema.json +18 -0
  353. package/schemas/responses/tasks/get.schema.json +87 -0
  354. package/schemas/responses/tasks/list.schema.json +18 -0
  355. package/schemas/responses/tasks/next.schema.json +18 -0
  356. package/schemas/responses/tasks/promote.schema.json +18 -0
  357. package/schemas/responses/tasks/reopen.schema.json +18 -0
  358. package/schemas/responses/tasks/reorder.schema.json +18 -0
  359. package/schemas/responses/tasks/reparent.schema.json +18 -0
  360. package/schemas/responses/tasks/tree.schema.json +18 -0
  361. package/schemas/responses/tasks/unarchive.schema.json +18 -0
  362. package/schemas/responses/tasks/update.schema.json +18 -0
  363. package/schemas/responses/validate/compliance.record.schema.json +18 -0
  364. package/schemas/responses/validate/compliance.summary.schema.json +18 -0
  365. package/schemas/responses/validate/compliance.violations.schema.json +18 -0
  366. package/schemas/responses/validate/manifest.schema.json +18 -0
  367. package/schemas/responses/validate/output.schema.json +18 -0
  368. package/schemas/responses/validate/protocol.schema.json +18 -0
  369. package/schemas/responses/validate/schema.schema.json +18 -0
  370. package/schemas/responses/validate/task.schema.json +18 -0
  371. package/schemas/responses/validate/test.coverage.schema.json +18 -0
  372. package/schemas/responses/validate/test.run.schema.json +18 -0
  373. package/schemas/responses/validate/test.status.schema.json +18 -0
  374. package/server.json +53 -0
@@ -0,0 +1,760 @@
1
+ /**
2
+ * Protocol Rule Definitions for CLEO MCP Server
3
+ *
4
+ * @task T2918
5
+ * @epic T2908
6
+ *
7
+ * Defines validation rules for all 7 RCSD-IVTR protocols.
8
+ *
9
+ * Reference: lib/protocol-validation.sh, protocols/*.md
10
+ */
11
+ /**
12
+ * Helper: Check if field exists and is non-empty
13
+ */
14
+ function hasField(obj, field) {
15
+ const value = obj[field];
16
+ return value !== null && value !== undefined && value !== '';
17
+ }
18
+ /**
19
+ * Helper: Check array field length
20
+ */
21
+ function arrayLengthInRange(obj, field, min, max) {
22
+ const value = obj[field];
23
+ if (!Array.isArray(value)) {
24
+ return false;
25
+ }
26
+ return value.length >= min && value.length <= max;
27
+ }
28
+ /**
29
+ * Helper: Check enum value
30
+ */
31
+ function hasEnumValue(obj, field, values) {
32
+ const value = obj[field];
33
+ return typeof value === 'string' && values.includes(value);
34
+ }
35
+ /**
36
+ * Research Protocol Rules (RSCH-*)
37
+ */
38
+ const RESEARCH_RULES = [
39
+ {
40
+ id: 'RSCH-001',
41
+ level: 'MUST',
42
+ message: 'Research task must not modify code',
43
+ fix: 'Revert code changes, research is read-only',
44
+ validate: (entry, data) => {
45
+ return !data?.hasCodeChanges;
46
+ },
47
+ },
48
+ {
49
+ id: 'RSCH-002',
50
+ level: 'SHOULD',
51
+ message: 'Should document sources',
52
+ fix: 'Add sources array to manifest',
53
+ validate: (entry) => {
54
+ return hasField(entry, 'sources');
55
+ },
56
+ },
57
+ {
58
+ id: 'RSCH-003',
59
+ level: 'MUST',
60
+ message: 'Must link research to task via linked_tasks',
61
+ fix: 'Add linked_tasks array referencing the task and epic IDs',
62
+ validate: (entry) => {
63
+ const linkedTasks = entry.linked_tasks;
64
+ return Array.isArray(linkedTasks) && linkedTasks.length > 0;
65
+ },
66
+ },
67
+ {
68
+ id: 'RSCH-004',
69
+ level: 'MUST',
70
+ message: 'Must append entry to MANIFEST.jsonl',
71
+ fix: 'Append manifest entry with correct format',
72
+ validate: (entry) => {
73
+ return hasField(entry, 'id') && hasField(entry, 'file') && hasField(entry, 'date');
74
+ },
75
+ },
76
+ {
77
+ id: 'RSCH-005',
78
+ level: 'MUST',
79
+ message: 'Must write output file with required structure (title, summary, content)',
80
+ fix: 'Ensure output file contains title, summary, and content sections',
81
+ validate: (entry) => {
82
+ return hasField(entry, 'file') && hasField(entry, 'title') && hasField(entry, 'status');
83
+ },
84
+ },
85
+ {
86
+ id: 'RSCH-006',
87
+ level: 'MUST',
88
+ message: 'Must include 3-7 key findings',
89
+ fix: 'Add/remove findings in manifest entry',
90
+ validate: (entry) => {
91
+ return arrayLengthInRange(entry, 'key_findings', 3, 7);
92
+ },
93
+ },
94
+ {
95
+ id: 'RSCH-007',
96
+ level: 'MUST',
97
+ message: 'Must set agent_type: research',
98
+ fix: 'Update manifest entry agent_type field',
99
+ validate: (entry) => {
100
+ return hasEnumValue(entry, 'agent_type', ['research']);
101
+ },
102
+ },
103
+ ];
104
+ /**
105
+ * Consensus Protocol Rules (CONS-*)
106
+ */
107
+ const CONSENSUS_RULES = [
108
+ {
109
+ id: 'CONS-001',
110
+ level: 'MUST',
111
+ message: 'Must have voting matrix with ≥2 options',
112
+ fix: 'Add more options to voting matrix',
113
+ validate: (entry, data) => {
114
+ const votingMatrix = data?.votingMatrix;
115
+ if (!votingMatrix)
116
+ return false;
117
+ const options = votingMatrix.options;
118
+ return Array.isArray(options) && options.length >= 2;
119
+ },
120
+ },
121
+ {
122
+ id: 'CONS-002',
123
+ level: 'MUST',
124
+ message: 'Must include rationale for each voting option',
125
+ fix: 'Add rationale string to each option in voting matrix',
126
+ validate: (entry, data) => {
127
+ const votingMatrix = data?.votingMatrix;
128
+ if (!votingMatrix)
129
+ return false;
130
+ const options = votingMatrix.options;
131
+ if (!Array.isArray(options))
132
+ return false;
133
+ return options.every((opt) => typeof opt.rationale === 'string' && opt.rationale.length > 0);
134
+ },
135
+ },
136
+ {
137
+ id: 'CONS-003',
138
+ level: 'MUST',
139
+ message: 'Must include confidence scores (0.0-1.0)',
140
+ fix: 'Fix confidence values in voting matrix',
141
+ validate: (entry, data) => {
142
+ const votingMatrix = data?.votingMatrix;
143
+ if (!votingMatrix)
144
+ return false;
145
+ const options = votingMatrix.options;
146
+ if (!Array.isArray(options))
147
+ return false;
148
+ return options.every((opt) => {
149
+ const conf = opt.confidence;
150
+ return typeof conf === 'number' && conf >= 0.0 && conf <= 1.0;
151
+ });
152
+ },
153
+ },
154
+ {
155
+ id: 'CONS-004',
156
+ level: 'MUST',
157
+ message: 'Must meet threshold (50% required)',
158
+ fix: 'Increase confidence or add more supporting rationale',
159
+ validate: (entry, data) => {
160
+ const votingMatrix = data?.votingMatrix;
161
+ if (!votingMatrix)
162
+ return false;
163
+ const options = votingMatrix.options;
164
+ if (!Array.isArray(options))
165
+ return false;
166
+ const maxConfidence = Math.max(...options.map((o) => o.confidence || 0));
167
+ return maxConfidence >= 0.5;
168
+ },
169
+ },
170
+ {
171
+ id: 'CONS-005',
172
+ level: 'SHOULD',
173
+ message: 'Should record dissenting opinions',
174
+ fix: 'Add dissent field to voting matrix for minority options',
175
+ validate: (entry, data) => {
176
+ const votingMatrix = data?.votingMatrix;
177
+ if (!votingMatrix)
178
+ return true; // Optional: SHOULD level
179
+ return hasField(votingMatrix, 'dissent') ||
180
+ hasField(votingMatrix, 'notes');
181
+ },
182
+ },
183
+ {
184
+ id: 'CONS-006',
185
+ level: 'MUST',
186
+ message: 'Must escalate to HITL when threshold not reached',
187
+ fix: 'Set needs_followup with HITL escalation when no option meets threshold',
188
+ validate: (entry, data) => {
189
+ const votingMatrix = data?.votingMatrix;
190
+ if (!votingMatrix)
191
+ return false;
192
+ const options = votingMatrix.options;
193
+ if (!Array.isArray(options))
194
+ return false;
195
+ const maxConfidence = Math.max(...options.map((o) => o.confidence || 0));
196
+ // If threshold met, rule passes (no escalation needed)
197
+ if (maxConfidence >= 0.5)
198
+ return true;
199
+ // If threshold not met, must have escalation flag
200
+ const needsFollowup = entry.needs_followup;
201
+ return Array.isArray(needsFollowup) && needsFollowup.length > 0;
202
+ },
203
+ },
204
+ {
205
+ id: 'CONS-007',
206
+ level: 'MUST',
207
+ message: 'Must set agent_type: analysis',
208
+ fix: 'Update manifest entry agent_type field',
209
+ validate: (entry) => {
210
+ return hasEnumValue(entry, 'agent_type', ['analysis']);
211
+ },
212
+ },
213
+ ];
214
+ /**
215
+ * Specification Protocol Rules (SPEC-*)
216
+ */
217
+ const SPECIFICATION_RULES = [
218
+ {
219
+ id: 'SPEC-001',
220
+ level: 'MUST',
221
+ message: 'Must include RFC 2119 keywords',
222
+ fix: 'Add MUST/SHOULD/MAY requirements to specification',
223
+ validate: (entry, data) => {
224
+ const fileContent = data?.fileContent;
225
+ if (!fileContent)
226
+ return false;
227
+ return /\b(MUST|SHOULD|MAY|MUST NOT|SHOULD NOT|MAY NOT)\b/.test(fileContent);
228
+ },
229
+ },
230
+ {
231
+ id: 'SPEC-002',
232
+ level: 'MUST',
233
+ message: 'Must have version field',
234
+ fix: 'Add version field to manifest entry',
235
+ validate: (entry) => {
236
+ return hasField(entry, 'version');
237
+ },
238
+ },
239
+ {
240
+ id: 'SPEC-003',
241
+ level: 'SHOULD',
242
+ message: 'Should include authority/scope section',
243
+ fix: 'Add authority section defining specification scope',
244
+ validate: (entry, data) => {
245
+ const fileContent = data?.fileContent;
246
+ if (!fileContent)
247
+ return true; // Optional
248
+ return /\b(authority|scope)\b/i.test(fileContent);
249
+ },
250
+ },
251
+ {
252
+ id: 'SPEC-004',
253
+ level: 'SHOULD',
254
+ message: 'Should include conformance criteria',
255
+ fix: 'Add conformance section defining how to verify compliance',
256
+ validate: (entry, data) => {
257
+ const fileContent = data?.fileContent;
258
+ if (!fileContent)
259
+ return true; // SHOULD level, pass when no content
260
+ return /\b(conformance|compliance|verification)\b/i.test(fileContent);
261
+ },
262
+ },
263
+ {
264
+ id: 'SPEC-005',
265
+ level: 'SHOULD',
266
+ message: 'Should include change log section',
267
+ fix: 'Add change log tracking version history',
268
+ validate: (entry, data) => {
269
+ const fileContent = data?.fileContent;
270
+ if (!fileContent)
271
+ return true; // SHOULD level
272
+ return /\b(change\s*log|revision\s*history|version\s*history)\b/i.test(fileContent);
273
+ },
274
+ },
275
+ {
276
+ id: 'SPEC-006',
277
+ level: 'SHOULD',
278
+ message: 'Should include references section',
279
+ fix: 'Add references to related specifications and documents',
280
+ validate: (entry, data) => {
281
+ const fileContent = data?.fileContent;
282
+ if (!fileContent)
283
+ return true; // SHOULD level
284
+ return /\b(references|see also|related)\b/i.test(fileContent);
285
+ },
286
+ },
287
+ {
288
+ id: 'SPEC-007',
289
+ level: 'MUST',
290
+ message: 'Must set agent_type: specification',
291
+ fix: 'Update manifest entry agent_type field',
292
+ validate: (entry) => {
293
+ return hasEnumValue(entry, 'agent_type', ['specification']);
294
+ },
295
+ },
296
+ ];
297
+ /**
298
+ * Decomposition Protocol Rules (DCMP-*)
299
+ */
300
+ const DECOMPOSITION_RULES = [
301
+ {
302
+ id: 'DCMP-001',
303
+ level: 'MUST',
304
+ message: 'Must follow MECE principle (mutually exclusive, collectively exhaustive)',
305
+ fix: 'Ensure tasks do not overlap and cover all requirements',
306
+ validate: (entry, data) => {
307
+ // Check for duplicate task titles in sibling list (overlap detection)
308
+ const siblingTitles = data?.siblingTitles;
309
+ if (!siblingTitles)
310
+ return true; // No sibling data available, pass
311
+ const uniqueTitles = new Set(siblingTitles.map((t) => t.toLowerCase().trim()));
312
+ return uniqueTitles.size === siblingTitles.length;
313
+ },
314
+ },
315
+ {
316
+ id: 'DCMP-002',
317
+ level: 'MUST',
318
+ message: 'Must map dependencies (no cycles allowed)',
319
+ fix: 'Add depends field to tasks and verify no circular references',
320
+ validate: (entry, data) => {
321
+ const hasCycles = data?.hasCycles;
322
+ return hasCycles !== true; // Pass if no cycle data or no cycles
323
+ },
324
+ },
325
+ {
326
+ id: 'DCMP-003',
327
+ level: 'MUST',
328
+ message: 'Must respect max depth 3 (epic→task→subtask)',
329
+ fix: 'Flatten hierarchy to max 3 levels',
330
+ validate: (entry, data) => {
331
+ const depth = data?.hierarchyDepth;
332
+ return depth === undefined || depth <= 3;
333
+ },
334
+ },
335
+ {
336
+ id: 'DCMP-004',
337
+ level: 'MUST',
338
+ message: 'Must verify atomicity for leaf tasks',
339
+ fix: 'Ensure leaf tasks are atomic and independently completable',
340
+ validate: (entry, data) => {
341
+ const isLeaf = data?.isLeafTask;
342
+ if (!isLeaf)
343
+ return true; // Not a leaf task, pass
344
+ // Leaf tasks must have a clear description
345
+ return hasField(entry, 'description') &&
346
+ typeof entry.description === 'string' &&
347
+ entry.description.length >= 10;
348
+ },
349
+ },
350
+ {
351
+ id: 'DCMP-005',
352
+ level: 'MUST',
353
+ message: 'Must not include time estimates',
354
+ fix: 'Remove time estimates, use relative sizing',
355
+ validate: (entry) => {
356
+ const title = entry.title;
357
+ const description = entry.description;
358
+ const text = `${title} ${description}`;
359
+ return !/\b\d+\s*(hour|day|week|minute|hr|min)s?\b/i.test(text);
360
+ },
361
+ },
362
+ {
363
+ id: 'DCMP-006',
364
+ level: 'MUST',
365
+ message: 'Must enforce max 7 siblings per parent',
366
+ fix: 'Break epic into smaller sub-epics or reduce task count',
367
+ validate: (entry, data) => {
368
+ const siblingCount = data?.siblingCount;
369
+ return siblingCount === undefined || siblingCount <= 7;
370
+ },
371
+ },
372
+ {
373
+ id: 'DCMP-007',
374
+ level: 'MUST',
375
+ message: 'Must set agent_type: specification',
376
+ fix: 'Update manifest entry agent_type field',
377
+ validate: (entry) => {
378
+ return hasEnumValue(entry, 'agent_type', ['specification']);
379
+ },
380
+ },
381
+ ];
382
+ /**
383
+ * Implementation Protocol Rules (IMPL-*)
384
+ */
385
+ const IMPLEMENTATION_RULES = [
386
+ {
387
+ id: 'IMPL-003',
388
+ level: 'MUST',
389
+ message: 'Must include @task provenance tags',
390
+ fix: 'Add @task T#### comment above new functions',
391
+ validate: (entry, data) => {
392
+ const hasNewFunctions = data?.hasNewFunctions;
393
+ const hasProvenanceTags = data?.hasProvenanceTags;
394
+ // If no new functions, rule passes
395
+ if (!hasNewFunctions)
396
+ return true;
397
+ // If new functions exist, must have provenance tags
398
+ return hasProvenanceTags === true;
399
+ },
400
+ },
401
+ {
402
+ id: 'IMPL-004',
403
+ level: 'SHOULD',
404
+ message: 'Should pass all tests after implementation',
405
+ fix: 'Run test suite and fix failing tests before completion',
406
+ validate: (entry, data) => {
407
+ const testsPassed = data?.testsPassed;
408
+ if (testsPassed === undefined)
409
+ return true; // SHOULD level, pass when no data
410
+ return testsPassed === true;
411
+ },
412
+ },
413
+ {
414
+ id: 'IMPL-005',
415
+ level: 'MUST',
416
+ message: 'Must use atomic file operations for all writes',
417
+ fix: 'Use temp file → validate → backup → rename pattern for writes',
418
+ validate: (entry, data) => {
419
+ const usesAtomicOps = data?.usesAtomicOperations;
420
+ if (usesAtomicOps === undefined)
421
+ return true; // No data available, pass
422
+ return usesAtomicOps === true;
423
+ },
424
+ },
425
+ {
426
+ id: 'IMPL-006',
427
+ level: 'SHOULD',
428
+ message: 'Should follow project code style',
429
+ fix: 'Run linter and fix style violations',
430
+ validate: (entry, data) => {
431
+ const lintPassed = data?.lintPassed;
432
+ if (lintPassed === undefined)
433
+ return true; // SHOULD level, pass when no data
434
+ return lintPassed === true;
435
+ },
436
+ },
437
+ {
438
+ id: 'IMPL-007',
439
+ level: 'MUST',
440
+ message: 'Must set agent_type: implementation',
441
+ fix: 'Update manifest entry agent_type field',
442
+ validate: (entry) => {
443
+ return hasEnumValue(entry, 'agent_type', ['implementation']);
444
+ },
445
+ },
446
+ ];
447
+ /**
448
+ * Contribution Protocol Rules (CONT-*)
449
+ */
450
+ const CONTRIBUTION_RULES = [
451
+ {
452
+ id: 'CONT-001',
453
+ level: 'MUST',
454
+ message: 'Must follow commit message conventions (<type>: <summary>)',
455
+ fix: 'Use commit format: feat|fix|docs|test|refactor|chore: summary',
456
+ validate: (entry, data) => {
457
+ const commitMessage = data?.commitMessage;
458
+ if (!commitMessage)
459
+ return true; // No commit data available, pass
460
+ return /^(feat|fix|docs|test|refactor|chore)(\(.+\))?:\s/.test(commitMessage);
461
+ },
462
+ },
463
+ {
464
+ id: 'CONT-002',
465
+ level: 'MUST',
466
+ message: 'Must include provenance tags (@task/@session)',
467
+ fix: 'Add @task and @session tags to code',
468
+ validate: (entry, data) => {
469
+ const hasNewFunctions = data?.hasNewFunctions;
470
+ const hasProvenanceTags = data?.hasProvenanceTags;
471
+ if (!hasNewFunctions)
472
+ return true;
473
+ return hasProvenanceTags === true;
474
+ },
475
+ },
476
+ {
477
+ id: 'CONT-003',
478
+ level: 'MUST',
479
+ message: 'Must pass validation gates before merge',
480
+ fix: 'Run cleo --validate and fix all violations before merging',
481
+ validate: (entry, data) => {
482
+ const validationPassed = data?.validationPassed;
483
+ if (validationPassed === undefined)
484
+ return true; // No data, pass
485
+ return validationPassed === true;
486
+ },
487
+ },
488
+ {
489
+ id: 'CONT-005',
490
+ level: 'SHOULD',
491
+ message: 'Should flag conflicts with other sessions',
492
+ fix: 'Check for conflicting sessions: cleo session list --active',
493
+ validate: (entry, data) => {
494
+ const hasConflicts = data?.hasConflicts;
495
+ if (hasConflicts === undefined)
496
+ return true; // SHOULD level, pass when no data
497
+ return hasConflicts === false;
498
+ },
499
+ },
500
+ {
501
+ id: 'CONT-007',
502
+ level: 'MUST',
503
+ message: 'Must set agent_type: implementation',
504
+ fix: 'Update manifest entry agent_type field',
505
+ validate: (entry) => {
506
+ return hasEnumValue(entry, 'agent_type', ['implementation']);
507
+ },
508
+ },
509
+ ];
510
+ /**
511
+ * Release Protocol Rules (RLSE-*)
512
+ */
513
+ const RELEASE_RULES = [
514
+ {
515
+ id: 'RLSE-001',
516
+ level: 'MUST',
517
+ message: 'Must follow semver (major.minor.patch)',
518
+ fix: 'Use format X.Y.Z (e.g., 0.74.5)',
519
+ validate: (entry, data) => {
520
+ const version = data?.version;
521
+ if (!version)
522
+ return false;
523
+ return /^\d+\.\d+\.\d+$/.test(version);
524
+ },
525
+ },
526
+ {
527
+ id: 'RLSE-002',
528
+ level: 'MUST',
529
+ message: 'Must have changelog entry',
530
+ fix: 'Add entry to CHANGELOG.md',
531
+ validate: (entry, data) => {
532
+ const changelogEntry = data?.changelogEntry;
533
+ return !!changelogEntry;
534
+ },
535
+ },
536
+ {
537
+ id: 'RLSE-003',
538
+ level: 'SHOULD',
539
+ message: 'Should pass all tests before release',
540
+ fix: 'Run test suite: ./tests/run-all-tests.sh',
541
+ validate: (entry, data) => {
542
+ const testsPassed = data?.testsPassed;
543
+ if (testsPassed === undefined)
544
+ return true; // SHOULD level, pass when no data
545
+ return testsPassed === true;
546
+ },
547
+ },
548
+ {
549
+ id: 'RLSE-004',
550
+ level: 'MUST',
551
+ message: 'Must have git tag matching version',
552
+ fix: 'Create git tag: git tag v{version}',
553
+ validate: (entry, data) => {
554
+ const gitTag = data?.gitTag;
555
+ const version = data?.version;
556
+ if (!gitTag || !version)
557
+ return true; // No git data available, pass
558
+ // Tag should match version (with or without 'v' prefix)
559
+ return gitTag === version || gitTag === `v${version}`;
560
+ },
561
+ },
562
+ {
563
+ id: 'RLSE-005',
564
+ level: 'MUST',
565
+ message: 'Must have consistent version across VERSION file, README, and package.json',
566
+ fix: 'Run dev/validate-version.sh to check version consistency',
567
+ validate: (entry, data) => {
568
+ const versionConsistent = data?.versionConsistent;
569
+ if (versionConsistent === undefined)
570
+ return true; // No data available, pass
571
+ return versionConsistent === true;
572
+ },
573
+ },
574
+ {
575
+ id: 'RLSE-006',
576
+ level: 'SHOULD',
577
+ message: 'Should include rollback plan',
578
+ fix: 'Document rollback procedure in release notes',
579
+ validate: (entry, data) => {
580
+ const hasRollbackPlan = data?.hasRollbackPlan;
581
+ if (hasRollbackPlan === undefined)
582
+ return true; // SHOULD level, pass when no data
583
+ return hasRollbackPlan === true;
584
+ },
585
+ },
586
+ {
587
+ id: 'RLSE-007',
588
+ level: 'MUST',
589
+ message: 'Must set agent_type: documentation or release',
590
+ fix: 'Set agent_type appropriately',
591
+ validate: (entry) => {
592
+ return hasEnumValue(entry, 'agent_type', ['documentation', 'release']);
593
+ },
594
+ },
595
+ ];
596
+ /**
597
+ * Validation Protocol Rules (VALID-*)
598
+ */
599
+ const VALIDATION_RULES = [
600
+ {
601
+ id: 'VALID-001',
602
+ level: 'MUST',
603
+ message: 'Must verify output matches spec',
604
+ fix: 'Add validation_result field with pass/fail',
605
+ validate: (entry) => {
606
+ return hasField(entry, 'validation_result');
607
+ },
608
+ },
609
+ {
610
+ id: 'VALID-002',
611
+ level: 'MUST',
612
+ message: 'Must execute test suite during validation',
613
+ fix: 'Run test suite and record results in manifest',
614
+ validate: (entry, data) => {
615
+ const testResults = data?.testResults;
616
+ if (!testResults)
617
+ return true; // No test data, pass (tests may not apply)
618
+ return hasField(testResults, 'pass_rate');
619
+ },
620
+ },
621
+ {
622
+ id: 'VALID-003',
623
+ level: 'MUST',
624
+ message: 'Must check protocol compliance',
625
+ fix: 'Set status to complete/partial/blocked',
626
+ validate: (entry) => {
627
+ return hasEnumValue(entry, 'status', ['complete', 'partial', 'blocked']);
628
+ },
629
+ },
630
+ {
631
+ id: 'VALID-004',
632
+ level: 'SHOULD',
633
+ message: 'Should generate validation report',
634
+ fix: 'Add key_findings array with validation details',
635
+ validate: (entry) => {
636
+ return hasField(entry, 'key_findings');
637
+ },
638
+ },
639
+ {
640
+ id: 'VALID-005',
641
+ level: 'SHOULD',
642
+ message: 'Should classify violation severity (error/warning)',
643
+ fix: 'Include severity classification in validation results',
644
+ validate: (entry, data) => {
645
+ const violations = data?.violations;
646
+ if (!violations || violations.length === 0)
647
+ return true; // No violations, pass
648
+ return violations.every((v) => v.severity === 'error' || v.severity === 'warning');
649
+ },
650
+ },
651
+ {
652
+ id: 'VALID-006',
653
+ level: 'MUST',
654
+ message: 'Must set agent_type: validation',
655
+ fix: 'Set agent_type to validation',
656
+ validate: (entry) => {
657
+ return hasEnumValue(entry, 'agent_type', ['validation']);
658
+ },
659
+ },
660
+ ];
661
+ /**
662
+ * Testing Protocol Rules (TEST-*)
663
+ */
664
+ const TESTING_RULES = [
665
+ {
666
+ id: 'TEST-001',
667
+ level: 'MUST',
668
+ message: 'Must use configured test framework',
669
+ fix: 'Use project test framework (BATS for shell, Jest for TS)',
670
+ validate: (entry, data) => {
671
+ const testFramework = data?.testFramework;
672
+ if (!testFramework)
673
+ return true; // No framework specified, pass
674
+ const validFrameworks = ['bats', 'jest', 'vitest', 'mocha', 'pytest'];
675
+ return validFrameworks.includes(testFramework.toLowerCase());
676
+ },
677
+ },
678
+ {
679
+ id: 'TEST-002',
680
+ level: 'SHOULD',
681
+ message: 'Should follow test file naming conventions',
682
+ fix: 'Name test files: feature-name.bats or feature-name.test.ts',
683
+ validate: (entry, data) => {
684
+ const testFiles = data?.testFiles;
685
+ if (!testFiles || testFiles.length === 0)
686
+ return true; // SHOULD level, pass
687
+ return testFiles.every((f) => /\.(test|spec)\.(ts|js|tsx|jsx)$/.test(f) || /\.bats$/.test(f));
688
+ },
689
+ },
690
+ {
691
+ id: 'TEST-003',
692
+ level: 'SHOULD',
693
+ message: 'Should meet coverage thresholds',
694
+ fix: 'Increase test coverage to meet project thresholds',
695
+ validate: (entry, data) => {
696
+ const coveragePercent = data?.coveragePercent;
697
+ if (coveragePercent === undefined)
698
+ return true; // SHOULD level, pass when no data
699
+ return coveragePercent >= 80; // Default threshold
700
+ },
701
+ },
702
+ {
703
+ id: 'TEST-004',
704
+ level: 'MUST',
705
+ message: 'Must achieve 100% pass rate',
706
+ fix: 'Fix failing tests before completion',
707
+ validate: (entry, data) => {
708
+ const testResults = data?.testResults;
709
+ if (!testResults)
710
+ return false;
711
+ const passRate = testResults.pass_rate;
712
+ return passRate === 1.0 || passRate === 1;
713
+ },
714
+ },
715
+ {
716
+ id: 'TEST-005',
717
+ level: 'MUST',
718
+ message: 'Must cover all MUST requirements from specification',
719
+ fix: 'Add tests for each MUST requirement in the spec',
720
+ validate: (entry, data) => {
721
+ const mustRequirementsCovered = data?.mustRequirementsCovered;
722
+ if (mustRequirementsCovered === undefined)
723
+ return true; // No data, pass
724
+ return mustRequirementsCovered === true;
725
+ },
726
+ },
727
+ {
728
+ id: 'TEST-006',
729
+ level: 'MUST',
730
+ message: 'Must include test summary in manifest',
731
+ fix: 'Add key_findings array with test results',
732
+ validate: (entry) => {
733
+ return hasField(entry, 'key_findings');
734
+ },
735
+ },
736
+ {
737
+ id: 'TEST-007',
738
+ level: 'MUST',
739
+ message: 'Must set agent_type: testing',
740
+ fix: 'Set agent_type to testing',
741
+ validate: (entry) => {
742
+ return hasEnumValue(entry, 'agent_type', ['testing']);
743
+ },
744
+ },
745
+ ];
746
+ /**
747
+ * Protocol rule registry
748
+ */
749
+ export const PROTOCOL_RULES = {
750
+ research: RESEARCH_RULES,
751
+ consensus: CONSENSUS_RULES,
752
+ specification: SPECIFICATION_RULES,
753
+ decomposition: DECOMPOSITION_RULES,
754
+ implementation: IMPLEMENTATION_RULES,
755
+ contribution: CONTRIBUTION_RULES,
756
+ release: RELEASE_RULES,
757
+ validation: VALIDATION_RULES,
758
+ testing: TESTING_RULES,
759
+ };
760
+ //# sourceMappingURL=protocol-rules.js.map