soloforge 1.1.45 → 1.1.47

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 (608) hide show
  1. package/README.md +15 -3
  2. package/dist/context/adapters/shared/integration_guide.js +3 -1
  3. package/dist/context/adapters/shared/integration_guide.js.map +1 -1
  4. package/dist/context/contracts/lifecycle_knowledge_contract.d.ts.map +1 -1
  5. package/dist/context/contracts/lifecycle_knowledge_contract.js +2 -2
  6. package/dist/context/contracts/lifecycle_knowledge_contract.js.map +1 -1
  7. package/dist/core/gate_record_store.d.ts +11 -7
  8. package/dist/core/gate_record_store.d.ts.map +1 -1
  9. package/dist/core/gate_record_store.js +31 -17
  10. package/dist/core/gate_record_store.js.map +1 -1
  11. package/dist/core/observer.d.ts.map +1 -1
  12. package/dist/core/observer.js +7 -4
  13. package/dist/core/observer.js.map +1 -1
  14. package/dist/core/task_context/manager.d.ts +0 -8
  15. package/dist/core/task_context/manager.d.ts.map +1 -1
  16. package/dist/core/task_context/manager.js +1 -19
  17. package/dist/core/task_context/manager.js.map +1 -1
  18. package/dist/core/task_context/state_fact_classifier.d.ts +0 -8
  19. package/dist/core/task_context/state_fact_classifier.d.ts.map +1 -1
  20. package/dist/core/task_context/state_fact_classifier.js +0 -36
  21. package/dist/core/task_context/state_fact_classifier.js.map +1 -1
  22. package/dist/domain/asset_registry/derived_registry.d.ts.map +1 -1
  23. package/dist/domain/asset_registry/derived_registry.js +20 -5
  24. package/dist/domain/asset_registry/derived_registry.js.map +1 -1
  25. package/dist/domain/asset_registry/derived_types.d.ts +5 -1
  26. package/dist/domain/asset_registry/derived_types.d.ts.map +1 -1
  27. package/dist/domain/build/contract.d.ts.map +1 -1
  28. package/dist/domain/build/contract.js +3 -8
  29. package/dist/domain/build/contract.js.map +1 -1
  30. package/dist/domain/build/engine.d.ts +3 -2
  31. package/dist/domain/build/engine.d.ts.map +1 -1
  32. package/dist/domain/build/engine.js +5 -2
  33. package/dist/domain/build/engine.js.map +1 -1
  34. package/dist/domain/contracts/design_artifact_pack.d.ts +0 -1
  35. package/dist/domain/contracts/design_artifact_pack.d.ts.map +1 -1
  36. package/dist/domain/contracts/design_artifact_pack.js +1 -4
  37. package/dist/domain/contracts/design_artifact_pack.js.map +1 -1
  38. package/dist/domain/design/contract.d.ts.map +1 -1
  39. package/dist/domain/design/contract.js +2 -31
  40. package/dist/domain/design/contract.js.map +1 -1
  41. package/dist/domain/design/engine.d.ts +3 -2
  42. package/dist/domain/design/engine.d.ts.map +1 -1
  43. package/dist/domain/design/engine.js +5 -2
  44. package/dist/domain/design/engine.js.map +1 -1
  45. package/dist/domain/engine_helpers.d.ts +18 -2
  46. package/dist/domain/engine_helpers.d.ts.map +1 -1
  47. package/dist/domain/engine_helpers.js +87 -8
  48. package/dist/domain/engine_helpers.js.map +1 -1
  49. package/dist/domain/index.d.ts +1 -1
  50. package/dist/domain/index.d.ts.map +1 -1
  51. package/dist/domain/operate/contract.js +1 -1
  52. package/dist/domain/operate/contract.js.map +1 -1
  53. package/dist/domain/operate/engine.d.ts +3 -2
  54. package/dist/domain/operate/engine.d.ts.map +1 -1
  55. package/dist/domain/operate/engine.js +5 -2
  56. package/dist/domain/operate/engine.js.map +1 -1
  57. package/dist/domain/registry.d.ts +2 -2
  58. package/dist/domain/registry.d.ts.map +1 -1
  59. package/dist/domain/types.d.ts +1 -12
  60. package/dist/domain/types.d.ts.map +1 -1
  61. package/dist/domain/types.js +3 -0
  62. package/dist/domain/types.js.map +1 -1
  63. package/dist/domain/verify/engine.d.ts +3 -2
  64. package/dist/domain/verify/engine.d.ts.map +1 -1
  65. package/dist/domain/verify/engine.js +5 -2
  66. package/dist/domain/verify/engine.js.map +1 -1
  67. package/dist/gate/contracts/capability_registry.d.ts.map +1 -1
  68. package/dist/gate/contracts/capability_registry.js +0 -26
  69. package/dist/gate/contracts/capability_registry.js.map +1 -1
  70. package/dist/gate/contracts/control_plane_contract.d.ts +1 -1
  71. package/dist/gate/contracts/control_plane_contract.d.ts.map +1 -1
  72. package/dist/gate/contracts/control_plane_contract.js +1 -10
  73. package/dist/gate/contracts/control_plane_contract.js.map +1 -1
  74. package/dist/gate/contracts/tool_invocation_contract_registry.d.ts +1 -0
  75. package/dist/gate/contracts/tool_invocation_contract_registry.d.ts.map +1 -1
  76. package/dist/gate/contracts/tool_invocation_contract_registry.js +1 -1
  77. package/dist/gate/contracts/tool_invocation_contract_registry.js.map +1 -1
  78. package/dist/gate/executors/executors_artifact.d.ts.map +1 -1
  79. package/dist/gate/executors/executors_artifact.js +8 -5
  80. package/dist/gate/executors/executors_artifact.js.map +1 -1
  81. package/dist/gate/executors/executors_prerequisite.d.ts.map +1 -1
  82. package/dist/gate/executors/executors_prerequisite.js +26 -6
  83. package/dist/gate/executors/executors_prerequisite.js.map +1 -1
  84. package/dist/gate/executors/executors_regex_scan.js +2 -2
  85. package/dist/gate/executors/executors_regex_scan.js.map +1 -1
  86. package/dist/gate/executors/executors_trace.d.ts.map +1 -1
  87. package/dist/gate/executors/executors_trace.js +2 -0
  88. package/dist/gate/executors/executors_trace.js.map +1 -1
  89. package/dist/gate/gate_registry_bridge.d.ts +7 -6
  90. package/dist/gate/gate_registry_bridge.d.ts.map +1 -1
  91. package/dist/gate/gate_registry_bridge.js +51 -13
  92. package/dist/gate/gate_registry_bridge.js.map +1 -1
  93. package/dist/gate/index.d.ts +0 -2
  94. package/dist/gate/index.d.ts.map +1 -1
  95. package/dist/gate/index.js +0 -1
  96. package/dist/gate/index.js.map +1 -1
  97. package/dist/server/tools/index.d.ts.map +1 -1
  98. package/dist/server/tools/index.js +1 -3
  99. package/dist/server/tools/index.js.map +1 -1
  100. package/dist/server/tools/lazy_loaders.d.ts +0 -23
  101. package/dist/server/tools/lazy_loaders.d.ts.map +1 -1
  102. package/dist/server/tools/lazy_loaders.js +2 -33
  103. package/dist/server/tools/lazy_loaders.js.map +1 -1
  104. package/dist/server/tools/middleware.d.ts +2 -5
  105. package/dist/server/tools/middleware.d.ts.map +1 -1
  106. package/dist/server/tools/middleware.js +3 -33
  107. package/dist/server/tools/middleware.js.map +1 -1
  108. package/dist/server/tools/sf_doctor.d.ts +1 -0
  109. package/dist/server/tools/sf_doctor.d.ts.map +1 -1
  110. package/dist/server/tools/sf_doctor.js +15 -1
  111. package/dist/server/tools/sf_doctor.js.map +1 -1
  112. package/dist/server/tools/sf_gate.d.ts +1 -1
  113. package/dist/server/tools/sf_gate.js +2 -2
  114. package/dist/server/tools/sf_gate.js.map +1 -1
  115. package/dist/server/tools/sf_task.js +2 -7
  116. package/dist/server/tools/sf_task.js.map +1 -1
  117. package/dist/server/tools/sf_work.d.ts.map +1 -1
  118. package/dist/server/tools/sf_work.js +18 -6
  119. package/dist/server/tools/sf_work.js.map +1 -1
  120. package/dist/server/tools/types.d.ts +0 -2
  121. package/dist/server/tools/types.d.ts.map +1 -1
  122. package/dist/types/pipeline_types.d.ts +1 -9
  123. package/dist/types/pipeline_types.d.ts.map +1 -1
  124. package/dist/verify/audit/verifier.d.ts.map +1 -1
  125. package/dist/verify/audit/verifier.js +0 -33
  126. package/dist/verify/audit/verifier.js.map +1 -1
  127. package/dist/verify/index.d.ts +1 -4
  128. package/dist/verify/index.d.ts.map +1 -1
  129. package/dist/verify/index.js +0 -3
  130. package/dist/verify/index.js.map +1 -1
  131. package/dist/verify/types.d.ts +0 -21
  132. package/dist/verify/types.d.ts.map +1 -1
  133. package/package.json +2 -1
  134. package/templates/build/enforced.md +73 -0
  135. package/templates/build//344/270/223/351/241/271/345/256/236/347/216/260.md +75 -0
  136. package/templates/build//345/256/211/345/205/250/345/212/240/345/233/272.md +75 -0
  137. package/templates/build//346/265/213/350/257/225/344/274/230/345/205/210/347/274/226/347/240/201.md +50 -79
  138. package/templates/build//346/265/213/350/257/225/350/256/241/345/210/222.md +26 -24
  139. package/templates/build//347/274/226/347/240/201/347/272/252/345/276/213.md +75 -0
  140. package/templates/build//350/260/203/350/257/225/346/216/222/346/237/245.md +44 -75
  141. package/templates/build//351/207/215/346/236/204/346/226/271/346/263/225.md +68 -0
  142. package/templates/design/API/346/216/245/345/217/243/350/247/204/346/240/274/346/226/207/346/241/243.md +31 -28
  143. package/templates/design/enforced.md +47 -77
  144. package/templates/design//345/205/250/347/224/237/345/221/275/345/221/250/346/234/237/345/267/245/344/275/234/346/265/201/345/257/274/350/210/252.md +1 -0
  145. package/templates/design//345/205/274/345/256/271/346/200/247/344/270/216/350/277/201/347/247/273/350/257/204/344/274/260.md +71 -0
  146. package/templates/design//345/206/263/347/255/226/344/270/216/351/200/211/345/236/213.md +70 -0
  147. package/templates/design//345/210/207/347/211/207/350/247/204/345/210/222.md +49 -55
  148. package/templates/design//346/225/260/346/215/256/345/272/223/350/256/276/350/256/241/346/226/207/346/241/243.md +33 -47
  149. package/templates/design//346/236/266/346/236/204/350/256/276/350/256/241.md +41 -83
  150. package/templates/design//351/234/200/346/261/202/345/210/206/346/236/220.md +31 -59
  151. package/templates/operate/enforced.md +11 -0
  152. package/templates/operate//344/270/212/347/272/277/350/247/202/345/257/237.md +53 -32
  153. package/templates/operate//345/217/221/345/270/203/350/257/264/346/230/216.md +3 -0
  154. package/templates/operate//351/203/250/347/275/262/351/205/215/347/275/256.md +83 -0
  155. package/templates/shared/enforced.md +46 -5
  156. package/templates/shared//345/217/215/351/246/210/344/277/256/345/244/215/351/227/255/347/216/257.md +86 -0
  157. package/templates/shared//345/267/245/347/250/213/346/211/247/350/241/214/346/200/273/347/272/262.md +148 -0
  158. package/templates/shared//345/267/245/347/250/213/347/272/252/345/276/213.md +71 -0
  159. package/templates/shared//345/274/200/345/217/221/350/200/205/345/256/252/346/263/225.md +48 -43
  160. package/templates/shared//346/234/272/345/210/266/350/257/264/346/230/216.md +67 -0
  161. package/templates/shared//350/257/201/346/215/256/351/251/261/345/212/250/344/270/216/345/217/215/345/271/273/350/247/211.md +27 -17
  162. package/templates/shared//350/264/241/347/214/256/350/247/204/350/214/203.md +78 -0
  163. package/templates/verify/enforced.md +3 -0
  164. package/templates/verify//344/272/244/344/273/230/345/256/214/345/244/207/346/200/247/345/256/241/346/237/245.md +45 -87
  165. package/templates/verify//344/273/243/347/240/201/345/256/241/346/237/245/346/212/245/345/221/212.md +7 -0
  166. package/templates/verify//345/256/241/346/237/245/346/270/205/345/215/225.md +79 -0
  167. package/templates/verify//351/252/214/350/257/201/346/226/271/346/263/225.md +72 -0
  168. package/dist/context/engine/dependency_scanner.d.ts +0 -23
  169. package/dist/context/engine/dependency_scanner.d.ts.map +0 -1
  170. package/dist/context/engine/dependency_scanner.js +0 -309
  171. package/dist/context/engine/dependency_scanner.js.map +0 -1
  172. package/dist/context/engine/exploration.d.ts +0 -194
  173. package/dist/context/engine/exploration.d.ts.map +0 -1
  174. package/dist/context/engine/exploration.js +0 -712
  175. package/dist/context/engine/exploration.js.map +0 -1
  176. package/dist/context/knowledge/knowledge_acceptance_registry.d.ts +0 -42
  177. package/dist/context/knowledge/knowledge_acceptance_registry.d.ts.map +0 -1
  178. package/dist/context/knowledge/knowledge_acceptance_registry.js +0 -249
  179. package/dist/context/knowledge/knowledge_acceptance_registry.js.map +0 -1
  180. package/dist/context/knowledge/knowledge_scenario_registry.d.ts +0 -26
  181. package/dist/context/knowledge/knowledge_scenario_registry.d.ts.map +0 -1
  182. package/dist/context/knowledge/knowledge_scenario_registry.js +0 -267
  183. package/dist/context/knowledge/knowledge_scenario_registry.js.map +0 -1
  184. package/dist/context/knowledge/knowledge_sovereignty.d.ts +0 -65
  185. package/dist/context/knowledge/knowledge_sovereignty.d.ts.map +0 -1
  186. package/dist/context/knowledge/knowledge_sovereignty.js +0 -199
  187. package/dist/context/knowledge/knowledge_sovereignty.js.map +0 -1
  188. package/dist/context/team_awareness.d.ts +0 -42
  189. package/dist/context/team_awareness.d.ts.map +0 -1
  190. package/dist/context/team_awareness.js +0 -154
  191. package/dist/context/team_awareness.js.map +0 -1
  192. package/dist/context/templates/template_asset_visibility.d.ts +0 -116
  193. package/dist/context/templates/template_asset_visibility.d.ts.map +0 -1
  194. package/dist/context/templates/template_asset_visibility.js +0 -310
  195. package/dist/context/templates/template_asset_visibility.js.map +0 -1
  196. package/dist/gate/conflict_gate.d.ts +0 -53
  197. package/dist/gate/conflict_gate.d.ts.map +0 -1
  198. package/dist/gate/conflict_gate.js +0 -96
  199. package/dist/gate/conflict_gate.js.map +0 -1
  200. package/dist/gate/contracts/capability_action_advisor.d.ts +0 -34
  201. package/dist/gate/contracts/capability_action_advisor.d.ts.map +0 -1
  202. package/dist/gate/contracts/capability_action_advisor.js +0 -165
  203. package/dist/gate/contracts/capability_action_advisor.js.map +0 -1
  204. package/dist/gate/contracts/capability_state_store.d.ts +0 -121
  205. package/dist/gate/contracts/capability_state_store.d.ts.map +0 -1
  206. package/dist/gate/contracts/capability_state_store.js +0 -188
  207. package/dist/gate/contracts/capability_state_store.js.map +0 -1
  208. package/dist/gate/contracts/contract_guard.d.ts +0 -50
  209. package/dist/gate/contracts/contract_guard.d.ts.map +0 -1
  210. package/dist/gate/contracts/contract_guard.js +0 -611
  211. package/dist/gate/contracts/contract_guard.js.map +0 -1
  212. package/dist/gate/contracts/escape_report.d.ts +0 -103
  213. package/dist/gate/contracts/escape_report.d.ts.map +0 -1
  214. package/dist/gate/contracts/escape_report.js +0 -145
  215. package/dist/gate/contracts/escape_report.js.map +0 -1
  216. package/dist/gate/feasibility_checker.d.ts +0 -27
  217. package/dist/gate/feasibility_checker.d.ts.map +0 -1
  218. package/dist/gate/feasibility_checker.js +0 -114
  219. package/dist/gate/feasibility_checker.js.map +0 -1
  220. package/dist/gate/migration_guard.d.ts +0 -22
  221. package/dist/gate/migration_guard.d.ts.map +0 -1
  222. package/dist/gate/migration_guard.js +0 -277
  223. package/dist/gate/migration_guard.js.map +0 -1
  224. package/dist/gate/scope_lease.d.ts +0 -94
  225. package/dist/gate/scope_lease.d.ts.map +0 -1
  226. package/dist/gate/scope_lease.js +0 -180
  227. package/dist/gate/scope_lease.js.map +0 -1
  228. package/dist/git/git_deps.d.ts +0 -85
  229. package/dist/git/git_deps.d.ts.map +0 -1
  230. package/dist/git/git_deps.js +0 -22
  231. package/dist/git/git_deps.js.map +0 -1
  232. package/dist/git/operations.d.ts +0 -173
  233. package/dist/git/operations.d.ts.map +0 -1
  234. package/dist/git/operations.js +0 -350
  235. package/dist/git/operations.js.map +0 -1
  236. package/dist/server/tools/gate_engine.d.ts +0 -17
  237. package/dist/server/tools/gate_engine.d.ts.map +0 -1
  238. package/dist/server/tools/gate_engine.js +0 -17
  239. package/dist/server/tools/gate_engine.js.map +0 -1
  240. package/dist/server/tools/middleware/budget_check.d.ts +0 -35
  241. package/dist/server/tools/middleware/budget_check.d.ts.map +0 -1
  242. package/dist/server/tools/middleware/budget_check.js +0 -69
  243. package/dist/server/tools/middleware/budget_check.js.map +0 -1
  244. package/dist/shared/contracts/contract_registry/builtin_contracts_core.d.ts +0 -16
  245. package/dist/shared/contracts/contract_registry/builtin_contracts_core.d.ts.map +0 -1
  246. package/dist/shared/contracts/contract_registry/builtin_contracts_core.js +0 -306
  247. package/dist/shared/contracts/contract_registry/builtin_contracts_core.js.map +0 -1
  248. package/dist/shared/contracts/contract_registry/builtin_contracts_core_2.d.ts +0 -16
  249. package/dist/shared/contracts/contract_registry/builtin_contracts_core_2.d.ts.map +0 -1
  250. package/dist/shared/contracts/contract_registry/builtin_contracts_core_2.js +0 -304
  251. package/dist/shared/contracts/contract_registry/builtin_contracts_core_2.js.map +0 -1
  252. package/dist/shared/contracts/contract_registry/builtin_contracts_extended.d.ts +0 -16
  253. package/dist/shared/contracts/contract_registry/builtin_contracts_extended.d.ts.map +0 -1
  254. package/dist/shared/contracts/contract_registry/builtin_contracts_extended.js +0 -434
  255. package/dist/shared/contracts/contract_registry/builtin_contracts_extended.js.map +0 -1
  256. package/dist/shared/contracts/contract_registry/index.d.ts +0 -8
  257. package/dist/shared/contracts/contract_registry/index.d.ts.map +0 -1
  258. package/dist/shared/contracts/contract_registry/index.js +0 -7
  259. package/dist/shared/contracts/contract_registry/index.js.map +0 -1
  260. package/dist/shared/contracts/contract_registry/registry.d.ts +0 -62
  261. package/dist/shared/contracts/contract_registry/registry.d.ts.map +0 -1
  262. package/dist/shared/contracts/contract_registry/registry.js +0 -191
  263. package/dist/shared/contracts/contract_registry/registry.js.map +0 -1
  264. package/dist/shared/contracts/contract_registry/registry_internal.d.ts +0 -19
  265. package/dist/shared/contracts/contract_registry/registry_internal.d.ts.map +0 -1
  266. package/dist/shared/contracts/contract_registry/registry_internal.js +0 -54
  267. package/dist/shared/contracts/contract_registry/registry_internal.js.map +0 -1
  268. package/dist/shared/contracts/contract_registry/types.d.ts +0 -47
  269. package/dist/shared/contracts/contract_registry/types.d.ts.map +0 -1
  270. package/dist/shared/contracts/contract_registry/types.js +0 -5
  271. package/dist/shared/contracts/contract_registry/types.js.map +0 -1
  272. package/dist/shared/contracts/contract_registry/validation.d.ts +0 -25
  273. package/dist/shared/contracts/contract_registry/validation.d.ts.map +0 -1
  274. package/dist/shared/contracts/contract_registry/validation.js +0 -363
  275. package/dist/shared/contracts/contract_registry/validation.js.map +0 -1
  276. package/dist/shared/llm_gateway.d.ts +0 -186
  277. package/dist/shared/llm_gateway.d.ts.map +0 -1
  278. package/dist/shared/llm_gateway.js +0 -393
  279. package/dist/shared/llm_gateway.js.map +0 -1
  280. package/dist/verify/audit/audit_sampler.d.ts +0 -29
  281. package/dist/verify/audit/audit_sampler.d.ts.map +0 -1
  282. package/dist/verify/audit/audit_sampler.js +0 -42
  283. package/dist/verify/audit/audit_sampler.js.map +0 -1
  284. package/dist/verify/audit/debt_reporter.d.ts +0 -22
  285. package/dist/verify/audit/debt_reporter.d.ts.map +0 -1
  286. package/dist/verify/audit/debt_reporter.js +0 -107
  287. package/dist/verify/audit/debt_reporter.js.map +0 -1
  288. package/dist/verify/audit/debugger.d.ts +0 -25
  289. package/dist/verify/audit/debugger.d.ts.map +0 -1
  290. package/dist/verify/audit/debugger.js +0 -429
  291. package/dist/verify/audit/debugger.js.map +0 -1
  292. package/dist/verify/audit/degradation.d.ts +0 -62
  293. package/dist/verify/audit/degradation.d.ts.map +0 -1
  294. package/dist/verify/audit/degradation.js +0 -78
  295. package/dist/verify/audit/degradation.js.map +0 -1
  296. package/dist/verify/audit/developer_sovereignty.d.ts +0 -29
  297. package/dist/verify/audit/developer_sovereignty.d.ts.map +0 -1
  298. package/dist/verify/audit/developer_sovereignty.js +0 -137
  299. package/dist/verify/audit/developer_sovereignty.js.map +0 -1
  300. package/dist/verify/audit/failure_report.d.ts +0 -76
  301. package/dist/verify/audit/failure_report.d.ts.map +0 -1
  302. package/dist/verify/audit/failure_report.js +0 -145
  303. package/dist/verify/audit/failure_report.js.map +0 -1
  304. package/dist/verify/audit/governance_report.d.ts +0 -110
  305. package/dist/verify/audit/governance_report.d.ts.map +0 -1
  306. package/dist/verify/audit/governance_report.js +0 -194
  307. package/dist/verify/audit/governance_report.js.map +0 -1
  308. package/dist/verify/audit/mutation_audit.d.ts +0 -40
  309. package/dist/verify/audit/mutation_audit.d.ts.map +0 -1
  310. package/dist/verify/audit/mutation_audit.js +0 -154
  311. package/dist/verify/audit/mutation_audit.js.map +0 -1
  312. package/dist/verify/audit/risk_sampler.d.ts +0 -44
  313. package/dist/verify/audit/risk_sampler.d.ts.map +0 -1
  314. package/dist/verify/audit/risk_sampler.js +0 -80
  315. package/dist/verify/audit/risk_sampler.js.map +0 -1
  316. package/dist/verify/audit/runtime_safety.d.ts +0 -89
  317. package/dist/verify/audit/runtime_safety.d.ts.map +0 -1
  318. package/dist/verify/audit/runtime_safety.js +0 -209
  319. package/dist/verify/audit/runtime_safety.js.map +0 -1
  320. package/dist/verify/audit/semantic_evidence.d.ts +0 -36
  321. package/dist/verify/audit/semantic_evidence.d.ts.map +0 -1
  322. package/dist/verify/audit/semantic_evidence.js +0 -90
  323. package/dist/verify/audit/semantic_evidence.js.map +0 -1
  324. package/dist/verify/audit/test_generator.d.ts +0 -23
  325. package/dist/verify/audit/test_generator.d.ts.map +0 -1
  326. package/dist/verify/audit/test_generator.js +0 -278
  327. package/dist/verify/audit/test_generator.js.map +0 -1
  328. package/dist/verify/audit/test_quality.d.ts +0 -49
  329. package/dist/verify/audit/test_quality.d.ts.map +0 -1
  330. package/dist/verify/audit/test_quality.js +0 -684
  331. package/dist/verify/audit/test_quality.js.map +0 -1
  332. package/dist/verify/change_coordinator.d.ts +0 -45
  333. package/dist/verify/change_coordinator.d.ts.map +0 -1
  334. package/dist/verify/change_coordinator.js +0 -168
  335. package/dist/verify/change_coordinator.js.map +0 -1
  336. package/dist/verify/contracts/decision_contract.d.ts +0 -51
  337. package/dist/verify/contracts/decision_contract.d.ts.map +0 -1
  338. package/dist/verify/contracts/decision_contract.js +0 -70
  339. package/dist/verify/contracts/decision_contract.js.map +0 -1
  340. package/dist/verify/contracts/mechanism_contract_registry/contracts-audit.d.ts +0 -17
  341. package/dist/verify/contracts/mechanism_contract_registry/contracts-audit.d.ts.map +0 -1
  342. package/dist/verify/contracts/mechanism_contract_registry/contracts-audit.js +0 -428
  343. package/dist/verify/contracts/mechanism_contract_registry/contracts-audit.js.map +0 -1
  344. package/dist/verify/contracts/mechanism_contract_registry/contracts-governance.d.ts +0 -17
  345. package/dist/verify/contracts/mechanism_contract_registry/contracts-governance.d.ts.map +0 -1
  346. package/dist/verify/contracts/mechanism_contract_registry/contracts-governance.js +0 -429
  347. package/dist/verify/contracts/mechanism_contract_registry/contracts-governance.js.map +0 -1
  348. package/dist/verify/contracts/mechanism_contract_registry/contracts-pipeline.d.ts +0 -17
  349. package/dist/verify/contracts/mechanism_contract_registry/contracts-pipeline.d.ts.map +0 -1
  350. package/dist/verify/contracts/mechanism_contract_registry/contracts-pipeline.js +0 -194
  351. package/dist/verify/contracts/mechanism_contract_registry/contracts-pipeline.js.map +0 -1
  352. package/dist/verify/contracts/mechanism_contract_registry/contracts-platform.d.ts +0 -17
  353. package/dist/verify/contracts/mechanism_contract_registry/contracts-platform.d.ts.map +0 -1
  354. package/dist/verify/contracts/mechanism_contract_registry/contracts-platform.js +0 -365
  355. package/dist/verify/contracts/mechanism_contract_registry/contracts-platform.js.map +0 -1
  356. package/dist/verify/contracts/mechanism_contract_registry/index.d.ts +0 -19
  357. package/dist/verify/contracts/mechanism_contract_registry/index.d.ts.map +0 -1
  358. package/dist/verify/contracts/mechanism_contract_registry/index.js +0 -21
  359. package/dist/verify/contracts/mechanism_contract_registry/index.js.map +0 -1
  360. package/dist/verify/contracts/mechanism_contract_registry/types.d.ts +0 -33
  361. package/dist/verify/contracts/mechanism_contract_registry/types.d.ts.map +0 -1
  362. package/dist/verify/contracts/mechanism_contract_registry/types.js +0 -5
  363. package/dist/verify/contracts/mechanism_contract_registry/types.js.map +0 -1
  364. package/dist/verify/contracts/mechanism_contract_registry/validation.d.ts +0 -38
  365. package/dist/verify/contracts/mechanism_contract_registry/validation.d.ts.map +0 -1
  366. package/dist/verify/contracts/mechanism_contract_registry/validation.js +0 -136
  367. package/dist/verify/contracts/mechanism_contract_registry/validation.js.map +0 -1
  368. package/templates/build/Bug/345/210/206/346/236/220.md +0 -59
  369. package/templates/build/Git/346/223/215/344/275/234.md +0 -48
  370. package/templates/build/OOD/350/256/276/350/256/241/346/221/230/350/246/201.md +0 -46
  371. package/templates/build/React/346/216/245/345/217/243/351/233/206/346/210/220.md +0 -42
  372. package/templates/build/Schema/345/217/230/346/233/264/346/265/201/346/260/264/347/272/277.md +0 -52
  373. package/templates/build/TS/350/264/250/351/207/217/345/256/241/346/237/245.md +0 -78
  374. package/templates/build//344/270/212/346/270/270/344/272/244/345/217/211/351/252/214/350/257/201.md +0 -68
  375. package/templates/build//344/270/273/351/223/276/350/267/257/346/216/245/345/205/245/351/252/214/350/257/201.md +0 -56
  376. package/templates/build//344/273/243/347/240/201/351/227/250/347/246/201.md +0 -58
  377. package/templates/build//345/205/250/346/240/210/346/265/201/347/250/213/344/277/256/345/244/215.md +0 -48
  378. package/templates/build//345/210/207/347/211/207/346/211/247/350/241/214/347/272/252/345/276/213.md +0 -108
  379. package/templates/build//345/210/207/347/211/207/347/253/257/345/210/260/347/253/257/351/252/214/350/257/201.md +0 -221
  380. package/templates/build//345/212/237/350/203/275/345/274/200/345/217/221.md +0 -66
  381. package/templates/build//345/220/216/347/253/257/345/256/236/347/216/260.md +0 -39
  382. package/templates/build//345/220/216/347/253/257/345/256/236/347/216/260/345/267/245/347/250/213.md +0 -33
  383. package/templates/build//345/220/216/347/253/257/345/256/236/347/216/260/345/267/245/347/250/213/345/256/241/346/237/245.md +0 -70
  384. package/templates/build//345/220/216/347/253/257/346/216/245/345/217/243/345/256/236/347/216/260.md +0 -43
  385. package/templates/build//345/233/275/351/231/205/345/214/226.md +0 -45
  386. package/templates/build//345/256/211/345/205/250/345/212/240/345/233/272/346/265/201/346/260/264/347/272/277.md +0 -68
  387. package/templates/build//345/256/211/345/205/250/345/256/241/346/237/245.md +0 -154
  388. package/templates/build//345/256/211/345/205/250/345/256/241/350/256/241.md +0 -47
  389. package/templates/build//345/267/245/347/250/213/347/272/252/345/276/213.md +0 -56
  390. package/templates/build//346/200/247/350/203/275/345/210/206/346/236/220.md +0 -59
  391. package/templates/build//346/200/247/350/203/275/346/265/201/346/260/264/347/272/277.md +0 -53
  392. package/templates/build//346/216/245/345/217/243/351/233/206/346/210/220/346/265/201/346/260/264/347/272/277.md +0 -76
  393. package/templates/build//346/225/260/346/215/256/345/272/223/350/277/201/347/247/273.md +0 -63
  394. package/templates/build//346/226/260/350/200/201/351/200/273/350/276/221/346/257/224/345/257/271/346/227/245/345/277/227.md +0 -39
  395. package/templates/build//346/235/203/351/231/220/350/256/244/350/257/201.md +0 -49
  396. package/templates/build//346/265/213/350/257/225/350/264/250/351/207/217.md +0 -45
  397. package/templates/build//347/206/224/346/226/255/351/231/215/347/272/247.md +0 -49
  398. package/templates/build//347/212/266/346/200/201/346/265/201/350/275/254.md +0 -43
  399. package/templates/build//347/213/254/347/253/213/345/256/241/346/237/245.md +0 -45
  400. package/templates/build//347/272/246/346/235/237/345/256/236/347/216/260.md +0 -47
  401. package/templates/build//347/274/226/347/240/201/345/260/261/347/273/252/345/256/241/346/237/245.md +0 -60
  402. package/templates/build//347/274/226/347/240/201/350/201/232/345/220/210/346/243/200/346/237/245.md +0 -22
  403. package/templates/build//347/274/226/347/240/201/350/264/250/351/207/217.md +0 -46
  404. package/templates/build//347/274/226/347/240/201/351/230/266/346/256/265/346/211/247/350/241/214.md +0 -105
  405. package/templates/build//347/274/272/351/231/267/347/256/241/347/220/206.md +0 -47
  406. package/templates/build//350/200/246/345/220/210/346/243/200/346/265/213.md +0 -86
  407. package/templates/build//350/246/206/347/233/226/347/216/207/346/240/207/345/207/206.md +0 -40
  408. package/templates/build//350/264/250/351/207/217/345/256/241/346/237/245.md +0 -111
  409. package/templates/build//350/277/201/347/247/273/346/265/201/346/260/264/347/272/277.md +0 -52
  410. package/templates/build//351/200/232/347/224/250/350/264/250/351/207/217.md +0 -176
  411. package/templates/build//351/207/215/346/236/204/346/226/271/346/241/210.md +0 -61
  412. package/templates/build//351/207/215/346/236/204/346/265/201/346/260/264/347/272/277.md +0 -53
  413. package/templates/build//351/230/262/345/276/241/346/200/247/347/274/226/347/240/201.md +0 -94
  414. package/templates/build//351/233/206/346/210/220/351/252/214/350/257/201.md +0 -67
  415. package/templates/build//351/233/267/345/214/272/345/217/215/346/250/241/345/274/217.md +0 -135
  416. package/templates/build//351/252/214/346/224/266/346/240/207/345/207/206/345/256/241/346/237/245.md +0 -64
  417. package/templates/build//351/252/214/346/224/266/346/265/213/350/257/225/350/247/204/345/210/222.md +0 -75
  418. package/templates/design/API/350/256/276/350/256/241.md +0 -47
  419. package/templates/design/N/345/212/2401/346/237/245/350/257/242.md +0 -48
  420. package/templates/design/OOD/350/256/276/350/256/241.md +0 -72
  421. package/templates/design//344/270/200/350/207/264/346/200/247/346/240/241/351/252/214.md +0 -109
  422. package/templates/design//344/270/215/347/241/256/345/256/232/346/227/266/345/244/264/350/204/221/351/243/216/346/232/264.md +0 -105
  423. package/templates/design//344/273/273/345/212/241/346/213/206/350/247/243.md +0 -61
  424. package/templates/design//344/273/273/345/212/241/350/247/204/345/210/222.md +0 -84
  425. package/templates/design//344/274/232/350/257/235/346/201/242/345/244/215-procedures.md +0 -78
  426. package/templates/design//345/205/274/345/256/271/346/200/247/346/243/200/346/237/245.md +0 -89
  427. package/templates/design//345/210/207/347/211/207/350/256/241/345/210/222.md +0 -149
  428. package/templates/design//345/211/215/347/253/257/346/200/247/350/203/275.md +0 -49
  429. package/templates/design//345/216/206/345/217/262/351/201/227/347/225/231/351/233/267/345/214/272/346/270/205/345/215/225.md +0 -50
  430. package/templates/design//345/216/237/345/236/213/346/272/220/347/240/201/346/217/220/345/217/226.md +0 -78
  431. package/templates/design//345/216/237/345/236/213/350/257/264/346/230/216.md +0 -200
  432. package/templates/design//345/216/237/345/236/213/350/257/264/346/230/216/345/256/241/346/237/245.md +0 -81
  433. package/templates/design//345/220/221/345/220/216/345/205/274/345/256/271/346/200/247/345/220/210/350/247/204/346/212/245/345/221/212.md +0 -52
  434. package/templates/design//345/221/275/344/273/244/346/211/247/350/241/214-procedures.md +0 -45
  435. package/templates/design//345/221/275/344/273/244/350/267/257/347/224/261-procedures.md +0 -46
  436. package/templates/design//345/221/275/345/220/215.md +0 -49
  437. package/templates/design//345/242/236/351/207/217/350/276/271/347/225/214/347/225/214/345/256/232/346/226/207/346/241/243.md +0 -48
  438. package/templates/design//345/267/245/345/205/267/350/260/203/347/224/250-procedures.md +0 -41
  439. package/templates/design//345/271/266/345/217/221/346/216/247/345/210/266.md +0 -50
  440. package/templates/design//346/212/200/346/234/257/351/200/211/345/236/213.md +0 -33
  441. package/templates/design//346/216/245/345/217/243/345/257/271/346/216/245/346/226/271/346/241/210.md +0 -97
  442. package/templates/design//346/224/271/351/200/240/345/275/261/345/223/215/350/214/203/345/233/264/350/257/204/344/274/260.md +0 -56
  443. package/templates/design//346/225/260/346/215/256/345/272/223/345/217/230/346/233/264/346/226/271/346/241/210.md +0 -75
  444. package/templates/design//346/225/260/346/215/256/350/241/200/347/274/230/345/233/276.md +0 -49
  445. package/templates/design//346/227/240/351/232/234/347/242/215.md +0 -49
  446. package/templates/design//346/236/266/346/236/204/345/206/263/347/255/226/350/256/260/345/275/225.md +0 -53
  447. package/templates/design//346/236/266/346/236/204/345/256/241/346/237/245.md +0 -256
  448. package/templates/design//346/236/266/346/236/204/350/256/276/350/256/241-constraints.md +0 -177
  449. package/templates/design//346/236/266/346/236/204/350/256/276/350/256/241-procedures.md +0 -130
  450. package/templates/design//346/246/202/345/277/265/351/252/214/350/257/201/346/265/201/346/260/264/347/272/277.md +0 -47
  451. package/templates/design//346/272/220/347/240/201/345/216/237/345/236/213/344/272/244/344/273/230.md +0 -58
  452. package/templates/design//347/216/260/346/234/211/347/263/273/347/273/237/345/267/256/350/267/235/345/210/206/346/236/220.md +0 -114
  453. package/templates/design//347/237/245/350/257/206/347/273/264/346/212/244/346/265/201/346/260/264/347/272/277.md +0 -64
  454. package/templates/design//347/254/254/344/270/200/346/200/247/345/216/237/347/220/206/346/216/250/347/220/206.md +0 -182
  455. package/templates/design//347/264/247/346/200/245/345/233/236/346/273/232/346/211/213/345/206/214.md +0 -77
  456. package/templates/design//347/274/226/347/240/201/345/211/215/346/276/204/346/270/205.md +0 -85
  457. package/templates/design//350/200/201/347/263/273/347/273/237/345/210/207/347/211/207/350/247/204/345/210/222.md +0 -48
  458. package/templates/design//350/207/252/344/270/273/351/200/211/345/236/213.md +0 -57
  459. package/templates/design//350/256/276/350/256/241/344/270/200/350/207/264/346/200/247/351/252/214/346/224/266/346/212/245/345/221/212.md +0 -34
  460. package/templates/design//350/256/276/350/256/241/344/272/247/347/211/251/347/224/237/346/210/220/344/270/216/345/244/215/351/252/214.md +0 -60
  461. package/templates/design//350/256/276/350/256/241/350/201/232/345/220/210/346/243/200/346/237/245.md +0 -21
  462. package/templates/design//350/257/246/347/273/206/350/256/276/350/256/241-procedures.md +0 -123
  463. package/templates/design//350/257/246/347/273/206/350/256/276/350/256/241.md +0 -109
  464. package/templates/design//350/257/246/347/273/206/350/256/276/350/256/241/345/256/241/346/237/245.md +0 -88
  465. package/templates/design//350/260/203/350/257/225/346/226/271/346/263/225/350/256/272.md +0 -43
  466. package/templates/design//350/277/201/347/247/273/350/257/204/344/274/260.md +0 -67
  467. package/templates/design//351/232/224/347/246/273/351/200/202/351/205/215/345/231/250/346/226/271/346/241/210.md +0 -44
  468. package/templates/design//351/234/200/346/261/202/346/276/204/346/270/205.md +0 -65
  469. package/templates/design//351/234/200/346/261/202/350/264/250/351/207/217/345/256/241/346/237/245.md +0 -88
  470. package/templates/design//351/242/206/345/237/237/351/251/261/345/212/250/350/256/276/350/256/241.md +0 -43
  471. package/templates/operate//345/217/221/345/270/203/350/257/264/346/230/216/345/256/241/346/237/245.md +0 -60
  472. package/templates/operate//350/277/220/347/273/264/350/201/232/345/220/210/346/243/200/346/237/245.md +0 -22
  473. package/templates/operate//351/203/250/347/275/262/351/205/215/347/275/256/345/256/241/346/237/245.md +0 -59
  474. package/templates/shared/Diff/345/275/222/345/261/236/350/277/275/350/270/252.md +0 -55
  475. package/templates/shared/Java/350/264/250/351/207/217/351/227/250/347/246/201.md +0 -54
  476. package/templates/shared/LLM/351/242/204/347/256/227/347/275/221/345/205/263.md +0 -54
  477. package/templates/shared/OOD/344/270/216SOLID/350/256/276/350/256/241.md +0 -48
  478. package/templates/shared//344/272/247/347/211/251Schema/346/263/250/345/206/214/344/270/255/345/277/203.md +0 -57
  479. package/templates/shared//344/272/247/347/211/251/345/245/221/347/272/246.md +0 -44
  480. package/templates/shared//344/273/243/347/240/201/346/263/250/351/207/212/344/270/216/346/227/245/345/277/227/345/245/221/347/272/246.md +0 -116
  481. package/templates/shared//344/273/273/345/212/241/344/270/212/344/270/213/346/226/207/347/224/237/345/221/275/345/221/250/346/234/237.md +0 -45
  482. package/templates/shared//344/273/273/345/212/241/347/212/266/346/200/201/346/234/272.md +0 -55
  483. package/templates/shared//344/273/273/345/212/241/347/256/241/347/220/206/345/231/250.md +0 -55
  484. package/templates/shared//344/274/230/351/233/205/345/201/234/346/234/272.md +0 -43
  485. package/templates/shared//344/275/234/347/224/250/345/237/237/344/270/216/345/257/206/351/222/245/346/213/246/346/210/252.md +0 -54
  486. package/templates/shared//344/275/234/347/224/250/345/237/237/347/247/237/347/272/246.md +0 -55
  487. package/templates/shared//345/206/262/347/252/201/351/227/250/347/246/201.md +0 -55
  488. package/templates/shared//345/206/263/347/255/226/347/275/221/345/205/263.md +0 -61
  489. package/templates/shared//345/210/207/347/211/207/350/201/232/345/220/210/346/243/200/346/237/245.md +0 -72
  490. package/templates/shared//345/217/230/345/274/202/345/256/241/350/256/241.md +0 -58
  491. package/templates/shared//345/220/216/347/253/257/345/256/236/347/216/260/345/267/245/347/250/213/345/245/221/347/272/246.md +0 -40
  492. package/templates/shared//345/221/275/344/273/244/346/211/247/350/241/214.md +0 -48
  493. package/templates/shared//345/221/275/344/273/244/350/267/257/347/224/261.md +0 -45
  494. package/templates/shared//345/233/236/345/275/222/347/237/251/351/230/265.md +0 -54
  495. package/templates/shared//345/244/232/347/247/237/346/210/267.md +0 -49
  496. package/templates/shared//345/256/241/350/256/241/346/227/245/345/277/227.md +0 -46
  497. package/templates/shared//345/257/274/345/205/245/345/257/274/345/207/272.md +0 -51
  498. package/templates/shared//345/267/245/344/275/234/345/214/272/344/272/222/346/226/245/351/224/201.md +0 -52
  499. package/templates/shared//345/267/245/344/275/234/345/214/272/345/224/244/351/206/222.md +0 -54
  500. package/templates/shared//345/267/245/344/275/234/346/265/201/345/245/221/347/272/246.md +0 -42
  501. package/templates/shared//345/267/245/344/275/234/346/265/201/345/274/225/346/223/216.md +0 -50
  502. package/templates/shared//345/267/245/344/275/234/346/265/201/346/250/241/347/211/210/345/214/205.md +0 -34
  503. package/templates/shared//345/267/245/345/205/267/350/260/203/347/224/250.md +0 -48
  504. package/templates/shared//345/271/266/345/217/221/351/224/201.md +0 -57
  505. package/templates/shared//346/211/247/350/241/214/345/256/210/345/215/253/350/257/204/344/274/260.md +0 -47
  506. package/templates/shared//346/211/251/345/261/225/347/224/237/345/221/275/345/221/250/346/234/237.md +0 -34
  507. package/templates/shared//346/212/200/346/234/257/345/206/263/347/255/226/344/270/273/346/235/203.md +0 -50
  508. package/templates/shared//346/212/245/350/241/250/347/273/237/350/256/241.md +0 -50
  509. package/templates/shared//346/224/257/344/273/230.md +0 -51
  510. package/templates/shared//346/225/217/346/204/237/344/277/241/346/201/257/345/244/204/347/220/206.md +0 -77
  511. package/templates/shared//346/225/217/346/204/237/344/277/241/346/201/257/346/211/253/346/217/217.md +0 -53
  512. package/templates/shared//346/225/260/346/215/256/346/235/203/351/231/220.md +0 -47
  513. package/templates/shared//346/226/275/345/267/245/346/214/207/344/273/244/345/245/221/347/272/246.md +0 -69
  514. package/templates/shared//346/227/245/345/277/227/346/262/273/347/220/206.md +0 -31
  515. package/templates/shared//346/234/272/345/210/266/350/207/252/346/262/273/347/220/206.md +0 -31
  516. package/templates/shared//346/240/207/345/207/206/350/265/204/344/272/247/350/246/206/347/233/226.md +0 -50
  517. package/templates/shared//346/240/270/345/277/203/344/275/223/351/252/214/345/216/237/345/210/231.md +0 -38
  518. package/templates/shared//346/240/270/345/277/203/345/267/245/347/250/213/346/211/247/350/241/214/345/216/237/345/210/231.md +0 -154
  519. package/templates/shared//346/250/241/347/211/210Frontmatter.md +0 -125
  520. package/templates/shared//346/250/241/347/211/210/350/264/241/347/214/256/346/214/207/345/215/227.md +0 -282
  521. package/templates/shared//346/250/241/347/211/210/350/265/204/344/272/247/345/217/257/350/247/201/346/200/247.md +0 -48
  522. package/templates/shared//346/262/273/347/220/206/350/277/220/350/241/214/346/227/266/345/276/252/347/216/257.md +0 -56
  523. package/templates/shared//346/263/250/345/206/214/350/241/250/345/237/272/347/241/200/350/256/276/346/226/275.md +0 -49
  524. package/templates/shared//346/265/201/345/274/217/345/277/203/350/267/263.md +0 -64
  525. package/templates/shared//346/274/224/350/277/233/345/233/236/345/275/222/351/227/250/346/216/247.md +0 -50
  526. package/templates/shared//347/224/250/346/210/267/345/217/215/351/246/210/345/245/221/347/272/246.md +0 -86
  527. package/templates/shared//347/237/245/350/257/206/344/270/273/346/235/203.md +0 -66
  528. package/templates/shared//347/237/245/350/257/206/346/262/273/347/220/206.md +0 -31
  529. package/templates/shared//347/237/245/350/257/206/346/263/250/345/205/245/350/276/271/347/225/214.md +0 -47
  530. package/templates/shared//347/273/206/350/212/202/347/272/252/345/276/213.md +0 -54
  531. package/templates/shared//350/204/221/346/232/264/344/270/216/346/226/271/346/241/210/346/216/242/347/264/242.md +0 -51
  532. package/templates/shared//350/256/241/345/210/222/345/211/215/347/275/256/351/227/250.md +0 -47
  533. package/templates/shared//350/256/276/350/256/241/344/272/247/347/211/251/345/214/205.md +0 -58
  534. package/templates/shared//350/257/255/344/271/211/350/257/201/346/215/256.md +0 -55
  535. package/templates/shared//350/267/250/345/271/263/345/217/260/350/267/257/345/276/204/345/256/211/345/205/250.md +0 -41
  536. package/templates/shared//350/276/223/345/205/245/346/235/220/346/226/231/345/245/221/347/272/246.md +0 -50
  537. package/templates/shared//350/277/220/350/241/214/345/256/211/345/205/250/345/214/205.md +0 -58
  538. package/templates/shared//351/200/232/347/224/250/345/206/263/347/255/226/347/240/224/350/256/250.md +0 -62
  539. package/templates/shared//351/200/232/347/224/250/346/234/272/346/242/260/346/235/241/346/254/276.md +0 -47
  540. package/templates/shared//351/200/232/347/237/245.md +0 -50
  541. package/templates/shared//351/203/250/347/275/262/351/205/215/347/275/256.md +0 -14
  542. package/templates/shared//351/205/215/347/275/256/344/274/230/345/205/210/347/272/247.md +0 -67
  543. package/templates/shared//351/205/215/347/275/256/350/220/275/347/233/230/350/276/271/347/225/214.md +0 -32
  544. package/templates/shared//351/230/262/345/255/244/345/262/233/345/256/236/347/216/260.md +0 -51
  545. package/templates/shared//351/233/266/351/205/215/347/275/256/345/210/235/345/247/213/345/214/226.md +0 -57
  546. package/templates/shared//351/252/214/346/224/266/346/250/241/347/211/210/350/276/223/345/207/272/345/245/221/347/272/246.md +0 -71
  547. package/templates/shared//351/252/214/350/257/201/345/221/275/344/273/244/347/224/237/346/210/220.md +0 -55
  548. package/templates/shared//351/252/214/350/257/201/345/245/221/347/272/246.md +0 -48
  549. package/templates/verify/Docker/351/203/250/347/275/262.md +0 -46
  550. package/templates/verify/POC/347/273/223/350/256/272.md +0 -53
  551. package/templates/verify/React/345/210/227/350/241/250/350/241/250/346/240/274.md +0 -43
  552. package/templates/verify/React/347/212/266/346/200/201/347/256/241/347/220/206.md +0 -42
  553. package/templates/verify/React/347/273/204/344/273/266.md +0 -42
  554. package/templates/verify/React/350/241/250/345/215/225.md +0 -43
  555. package/templates/verify/React/350/267/257/347/224/261.md +0 -43
  556. package/templates/verify/SOLID/344/273/243/347/240/201/345/256/241/346/237/245.md +0 -74
  557. package/templates/verify/SOLID/350/256/276/350/256/241.md +0 -31
  558. package/templates/verify/Schema/345/205/274/345/256/271.md +0 -42
  559. package/templates/verify/Vue/347/212/266/346/200/201/347/256/241/347/220/206.md +0 -42
  560. package/templates/verify/Vue/347/273/204/344/273/266.md +0 -42
  561. package/templates/verify/Vue/350/267/257/347/224/261.md +0 -43
  562. package/templates/verify//344/270/212/346/270/270/350/256/276/350/256/241/344/272/244/345/217/211/351/252/214/350/257/201/345/256/241/346/237/245.md +0 -76
  563. package/templates/verify//344/270/273/351/223/276/350/267/257/346/216/245/345/205/245.md +0 -38
  564. package/templates/verify//344/272/213/344/273/266/351/251/261/345/212/250.md +0 -46
  565. package/templates/verify//344/272/213/345/212/241/346/250/241/345/274/217.md +0 -42
  566. package/templates/verify//344/273/243/347/240/201/345/217/257/347/273/264/346/212/244/346/200/247/344/270/216/345/217/257/350/247/202/346/265/213/346/200/247/345/256/241/346/237/245.md +0 -92
  567. package/templates/verify//344/273/243/347/240/201/346/263/250/351/207/212/344/270/216/346/227/245/345/277/227/351/252/214/346/224/266.md +0 -64
  568. package/templates/verify//344/274/232/350/257/235/346/201/242/345/244/215.md +0 -46
  569. package/templates/verify//345/206/263/347/255/226/345/256/214/346/225/264/346/200/247/345/256/241/346/237/245.md +0 -71
  570. package/templates/verify//345/210/206/351/241/265/346/237/245/350/257/242.md +0 -41
  571. package/templates/verify//345/211/215/347/253/257/351/241/265/351/235/242.md +0 -40
  572. package/templates/verify//345/216/206/345/217/262/346/225/260/346/215/256/346/270/205/346/264/227/350/204/232/346/234/254.md +0 -55
  573. package/templates/verify//345/217/221/345/270/203/345/220/216/345/256/241/346/237/245.md +0 -73
  574. package/templates/verify//345/220/216/347/253/257API.md +0 -39
  575. package/templates/verify//345/242/236/345/210/240/346/224/271/346/237/245.md +0 -45
  576. package/templates/verify//345/244/226/351/203/250/344/276/235/350/265/226.md +0 -43
  577. package/templates/verify//345/245/221/347/272/246/345/205/274/345/256/271.md +0 -42
  578. package/templates/verify//345/256/232/346/227/266/344/273/273/345/212/241.md +0 -39
  579. package/templates/verify//345/256/236/346/227/266/346/216/250/351/200/201.md +0 -48
  580. package/templates/verify//345/256/241/346/237/245/346/221/230/350/246/201.md +0 -58
  581. package/templates/verify//345/267/245/344/275/234/346/265/201.md +0 -38
  582. package/templates/verify//345/271/266/345/217/221/345/256/241/346/237/245.md +0 -132
  583. package/templates/verify//345/274/202/346/255/245/345/257/274/345/207/272.md +0 -41
  584. package/templates/verify//346/200/247/350/203/275/345/256/241/346/237/245.md +0 -110
  585. package/templates/verify//346/216/245/345/217/243/345/245/221/347/272/246.md +0 -44
  586. package/templates/verify//346/216/245/345/217/243/345/245/221/347/272/246/345/256/241/346/237/245.md +0 -131
  587. package/templates/verify//346/220/234/347/264/242/346/250/241/345/274/217.md +0 -47
  588. package/templates/verify//346/225/205/351/232/234/345/244/215/347/233/230.md +0 -67
  589. package/templates/verify//346/225/260/346/215/256/345/272/223/345/217/230/346/233/264.md +0 -37
  590. package/templates/verify//346/225/260/346/215/256/351/232/220/347/247/201.md +0 -46
  591. package/templates/verify//346/226/207/344/273/266/344/270/212/344/274/240.md +0 -45
  592. package/templates/verify//346/227/245/345/277/227.md +0 -45
  593. package/templates/verify//346/234/254/345/234/260/346/265/217/350/247/210/345/231/250/351/252/214/346/224/266.md +0 -94
  594. package/templates/verify//346/240/270/345/277/203/345/267/245/347/250/213/346/211/247/350/241/214.md +0 -65
  595. package/templates/verify//347/237/245/350/257/206/346/263/250/345/205/245.md +0 -38
  596. package/templates/verify//347/264/247/346/200/245/344/277/256/345/244/215/346/265/201/346/260/264/347/272/277.md +0 -76
  597. package/templates/verify//347/274/223/345/255/230/347/255/226/347/225/245.md +0 -45
  598. package/templates/verify//350/201/224/350/260/203/350/256/276/350/256/241/347/274/272/351/231/267/345/210/244/345/256/232.md +0 -67
  599. package/templates/verify//350/201/224/350/260/203/351/252/214/350/257/201.md +0 -87
  600. package/templates/verify//350/256/276/350/256/241/345/256/241/350/256/241.md +0 -184
  601. package/templates/verify//350/257/225/350/277/220/350/241/214/347/206/224/346/226/255.md +0 -74
  602. package/templates/verify//350/276/223/345/205/245/346/240/241/351/252/214.md +0 -44
  603. package/templates/verify//351/203/250/347/275/262/345/217/221/345/270/203.md +0 -101
  604. package/templates/verify//351/224/231/350/257/257/345/244/204/347/220/206.md +0 -46
  605. package/templates/verify//351/224/231/350/257/257/350/276/271/347/225/214.md +0 -38
  606. package/templates/verify//351/232/220/347/247/201/345/256/241/346/237/245.md +0 -37
  607. package/templates/verify//351/252/214/350/257/201.md +0 -38
  608. package/templates/verify//351/252/214/350/257/201/350/201/232/345/220/210/346/243/200/346/237/245.md +0 -22
@@ -1,58 +0,0 @@
1
- ---
2
- id: ka-artifact_template-审查摘要
3
- kind: artifact
4
- title: 审查摘要
5
- sync_policy: copy_to_project
6
- status: active
7
- extra:
8
- name: review-summary
9
- scope:
10
- - '*'
11
- products:
12
- - '*'
13
- lifecycle_status: active
14
- version: 1.2.0
15
- last_reviewed: '2026-06-04'
16
- type: artifact
17
- domain: verify
18
- stage: verify
19
- owner_mechanism: mc-verifier
20
- ---
21
-
22
- ## 摘要格式规范
23
-
24
- 每个白盒审查项必须生成压缩摘要,格式为:
25
- `[文件名:行号] 维度: 标题`
26
-
27
- 示例:
28
- ```text
29
- [llm_gateway.ts:156] security: Token 预算未检查
30
- [evolver.ts:42] quality: 知识提取逻辑缺失空值守卫
31
- ```
32
-
33
- ## 维度覆盖
34
- 维度覆盖: 安全✅ 性能✅ 并发✅ 架构✅ SOLID✅ 契约✅ 可维护性✅ 交付✅ 决策❌ 交叉验证✅
35
- AI 盲区维度: [列出未覆盖维度及建议补充方式]
36
-
37
- ## 汇报格式
38
-
39
- ```text
40
- 审查结果: X 项发现
41
- - 白盒 (可跳过): N 项 — [一句话汇总]
42
- - 灰盒 (需签署): N 项 — [逐项展示 + 抽检回溯摘要流]
43
- - 黑盒 (强制签署): N 项 — [逐项展示 + 等待 [Human-Audit: APPROVED]]
44
- ```
45
-
46
- ## 抽检哨兵规则
47
-
48
- - 每处理 10 个白盒项,强制随机升级 1 个为灰盒
49
- - 升级时自动渲染前置白盒摘要流(spot_check_backtrace)
50
- - 摘要流格式: 连续的白盒项摘要,供人类快速回溯
51
- - 人类审计时随机提问: 基于任务摘要生成是/否问题,校验审计真实性
52
-
53
- ## 回溯链路
54
-
55
- 1. 白盒项分类时自动缓存到 summaryCache(模块级 Map)
56
- 2. 抽检哨兵触发时从缓存渲染所有白盒摘要
57
- 3. renderSummaryBacktrace(taskId) 支持回溯任意历史任务
58
- 4. 回溯摘要附加到 CodeReviewResult.spot_check_backtrace
@@ -1,38 +0,0 @@
1
- ---
2
- id: ka-checklist-工作流验收清单
3
- kind: artifact
4
- title: 工作流
5
- sync_policy: copy_to_project
6
- status: active
7
- extra:
8
- name: workflow-acceptance
9
- type: artifact
10
- scope:
11
- - '*'
12
- products:
13
- - '*'
14
- lifecycle_status: active
15
- version: 1.1.0
16
- last_reviewed: '2026-06-01'
17
- domain: verify
18
- verification_layer: L2
19
- stage: verify
20
- owner_mechanism: mc-workflow-contract
21
- ---
22
-
23
- # 工作流验收清单
24
-
25
- ## 必检项
26
-
27
- - [ ] 工作流 ID 在 Workflow Contract Registry 中已注册
28
- - [ ] required_mechanisms 中的每个机制在 Mechanism Contract Registry 中存在
29
- - [ ] workflow scope 覆盖所有预期产出文件
30
- - [ ] read-only 工作流无 mutation 产出
31
- - [ ] 验证策略 (verification_strategy) 已声明
32
- - [ ] 交付门禁 (delivery_gate) 已声明
33
-
34
- ## 禁止项
35
-
36
- - [ ] 未注册的工作流 ID
37
- - [ ] 缺失 required_mechanisms
38
- - [ ] 读写权限不一致
@@ -1,132 +0,0 @@
1
- ---
2
- id: ka-review-rule-并发审查规则
3
- kind: guidance
4
- title: 并发审查
5
- triggers:
6
- - 并发
7
- - 线程
8
- - 锁
9
- - 异步
10
- - 线程安全
11
- sync_policy: copy_to_project
12
- status: active
13
- extra:
14
- name: concurrency-rules
15
- type: constraint
16
- scope:
17
- - backend
18
- products:
19
- - '*'
20
- lifecycle_status: active
21
- version: 1.2.0
22
- last_reviewed: '2026-06-04'
23
- domain: verify
24
- verification_layer: L2
25
- stage: verify
26
- owner_mechanism: mc-generic-review
27
- ---
28
-
29
- ## CON-01: 共享可变状态无并发保护
30
- languages: [java]
31
- pattern: /synchronized|ReentrantLock|AtomicInteger|volatile/
32
- severity: error
33
- check_type: deterministic
34
- scope: backend
35
- description: 涉及金额、库存、计数器的操作必须显式声明并发控制策略。若未使用任何并发控制原语,标记为需人工确认
36
- evidence_required:
37
- - "扫描结果:含共享可变状态的文件路径+行号"
38
- - "并发控制策略声明"
39
-
40
- ## CON-02: 分布式环境使用 JVM 级锁
41
- languages: [java]
42
- pattern: /synchronized\s*\(|ReentrantLock/
43
- severity: warning
44
- check_type: deterministic
45
- scope: backend
46
- description: 多实例部署场景下 synchronized/ReentrantLock 无法跨 JVM,必须使用分布式锁(Redis/Redisson)
47
- evidence_required:
48
- - "扫描结果:含 JVM 级锁的文件路径+行号"
49
- - "部署架构确认(单实例/多实例)"
50
-
51
- ## CON-03: 先查后改未用原子操作
52
- languages: [通用]
53
- pattern: /SELECT.*stock|SELECT.*count|SELECT.*amount.*WHERE/
54
- severity: warning
55
- check_type: deterministic
56
- scope: backend
57
- description: 库存/余额/计数器等场景禁止先 SELECT 再 UPDATE,必须使用原子操作(UPDATE SET x = x - 1 WHERE x >= 1)
58
- evidence_required:
59
- - "扫描结果:含先查后改模式的文件路径+行号"
60
-
61
- ## CON-04: @Transactional 同类内部调用
62
- languages: [java]
63
- pattern: /this\.|@Transactional/
64
- severity: warning
65
- check_type: deterministic
66
- scope: backend
67
- description: @Transactional 方法被同类内部 this.xxx() 调用时 AOP 代理失效,事务不生效
68
- evidence_required:
69
- - "扫描结果:含 this 调用事务方法的文件路径+行号"
70
-
71
- ## CON-05: 事务内执行外部调用
72
- languages: [java]
73
- pattern: /RestTemplate|FeignClient|HttpClient|WebClient/
74
- severity: info
75
- check_type: deterministic
76
- scope: backend
77
- description: 事务方法中执行外部 HTTP 调用会延长事务持有时间,建议移到事务外或使用 REQUIRES_NEW 隔离
78
- evidence_required:
79
- - "扫描结果:事务内外部调用的文件路径+行号"
80
-
81
- ## CON-06: SimpleDateFormat 非线程安全
82
- languages: [java]
83
- pattern: /SimpleDateFormat/
84
- severity: warning
85
- check_type: deterministic
86
- scope: backend
87
- description: SimpleDateFormat 非线程安全,多线程共享会导致日期解析错误,使用 DateTimeFormatter 或 ThreadLocal
88
- evidence_required:
89
- - "扫描结果:含 SimpleDateFormat 的文件路径+行号"
90
-
91
- ## CON-07: ThreadLocal 未清理导致内存泄漏
92
- languages: [java]
93
- pattern: /ThreadLocal\s*<|new\s+ThreadLocal/
94
- severity: warning
95
- check_type: deterministic
96
- scope: backend
97
- description: ThreadLocal 必须在请求结束时 remove(),否则线程池复用会导致内存泄漏和数据串线
98
- evidence_required:
99
- - "扫描结果:含 ThreadLocal 的文件路径+行号"
100
- - "remove() 调用确认"
101
-
102
- ## CON-08: 非线程安全的集合用作类成员变量
103
- languages: [java]
104
- pattern: /private\s+(?:static\s+)?(?:final\s+)?(?:HashMap|ArrayList|LinkedList|HashSet)\s*</
105
- severity: warning
106
- check_type: deterministic
107
- scope: backend
108
- description: 类级别的共享集合必须使用 ConcurrentHashMap/CopyOnWriteArrayList 等线程安全实现
109
- evidence_required:
110
- - "扫描结果:含非线程安全集合的文件路径+行号"
111
-
112
- ## CON-09: CompletableFuture 未处理异常
113
- languages: [java]
114
- pattern: /CompletableFuture.*(?:thenApply|thenAccept|thenCompose)\s*\(/
115
- severity: warning
116
- check_type: deterministic
117
- scope: backend
118
- description: CompletableFuture 链必须以 exceptionally() 或 handle() 结尾,防止异常被静默吞掉
119
- evidence_required:
120
- - "扫描结果:含 CompletableFuture 的文件路径+行号"
121
- - "异常处理链确认"
122
-
123
- ## CON-10: 线程池未正确配置拒绝策略
124
- languages: [java]
125
- pattern: /new\s+ThreadPoolExecutor\s*\(/
126
- severity: warning
127
- check_type: deterministic
128
- scope: backend
129
- description: 线程池必须显式配置拒绝策略(CallerRunsPolicy/自定义),禁止使用默认 AbortPolicy
130
- evidence_required:
131
- - "扫描结果:含线程池创建的文件路径+行号"
132
- - "拒绝策略配置确认"
@@ -1,41 +0,0 @@
1
- ---
2
- id: ka-pattern-async-export
3
- kind: knowledge
4
- title: 异步导出
5
- sync_policy: copy_to_project
6
- status: active
7
- extra:
8
- name: async-export
9
- scope:
10
- - backend
11
- products:
12
- - '*'
13
- lifecycle_status: active
14
- version: 1.1.0
15
- last_reviewed: '2026-06-01'
16
- type: knowledge
17
- domain: verify
18
- verification_layer: L2
19
- stage: verify
20
- owner_mechanism: mc-backend-pattern
21
- ---
22
-
23
- ## 决策规则
24
- - 超过 1000 条数据必须走异步导出,返回任务 ID
25
- - 异步导出任务必须有状态追踪(PENDING/PROCESSING/COMPLETED/FAILED)
26
- - 导出文件必须存储在对象存储,禁止堆积在本地磁盘
27
- - 导出文件必须设置过期时间(建议 24 小时),到期自动清理
28
- - 导出文件必须包含表头行,字段名对齐业务术语
29
- - 大数据量导出必须异步执行,通过 WebSocket/轮询通知完成状态
30
- - 导出数据量必须有上限(如单次 ≤ 100 万行),超限提示用户缩小范围
31
- - 导出过程必须有进度反馈(已完成 X/Y 条),提升用户体验
32
- - 导出失败必须通知用户并提供重试机制
33
-
34
- ## 验收项
35
- - [AC-01] 大数据量走异步导出返回任务 ID
36
- - [AC-02] 任务有状态追踪
37
- - [AC-03] 文件 24 小时内自动清理
38
- - [AC-04] 导出文件含表头行
39
- - [AC-05] 大导出异步执行并有通知
40
- - [AC-06] 导出文件有过期清理
41
- - [AC-07] 有进度反馈
@@ -1,110 +0,0 @@
1
- ---
2
- id: ka-review-rule-性能审查规则
3
- kind: guidance
4
- title: 性能审查
5
- triggers:
6
- - 性能
7
- - 慢查询
8
- - 缓存
9
- - N+1
10
- - 索引
11
- sync_policy: copy_to_project
12
- status: active
13
- extra:
14
- name: performance-rules
15
- type: constraint
16
- scope:
17
- - backend
18
- - frontend
19
- products:
20
- - '*'
21
- lifecycle_status: active
22
- version: 1.2.0
23
- last_reviewed: '2026-06-04'
24
- domain: verify
25
- verification_layer: L2
26
- stage: verify
27
- owner_mechanism: mc-generic-review
28
- ---
29
-
30
- ## PER-01: 循环内逐条数据库调用(N+1 问题)
31
- pattern: /(?:for|while)\s*\(.*\)[\s\S]*?\.(?:save|insert|update|delete|query|select|findBy)\s*\(/
32
- severity: error
33
- check_type: deterministic
34
- scope: backend
35
- description: 循环内禁止逐条数据库操作,必须使用批量 SQL 或 IN 查询
36
- evidence_required:
37
- - "扫描结果:含循环内数据库调用的文件路径+行号"
38
- - "修复确认:批量操作替换证据"
39
-
40
- ## PER-02: SELECT * 查询未指定字段
41
- pattern: /SELECT\s+\*\s+FROM/i
42
- severity: info
43
- check_type: deterministic
44
- scope: backend
45
- description: 查询应明确指定所需字段,避免传输不必要的数据
46
- evidence_required:
47
- - "扫描结果:含 SELECT * 的文件路径+行号"
48
-
49
- ## PER-03: 未使用分页的大列表查询
50
- pattern: /findAll\s*\(\s*\)|\.toList\(\)\s*;|find\s*\(\s*\{\s*\}\s*\)/
51
- severity: warning
52
- check_type: deterministic
53
- scope: backend
54
- description: 列表查询必须分页,禁止一次加载全量数据
55
- evidence_required:
56
- - "扫描结果:含未分页查询的文件路径+行号"
57
-
58
- ## PER-04: 大循环内创建对象或字符串拼接
59
- pattern: /(?:for|while)\s*\(.*\)[\s\S]*?new\s+(?:ArrayList|HashMap|StringBuilder)/
60
- severity: info
61
- check_type: deterministic
62
- scope: backend
63
- description: 大循环内避免重复创建对象,应提前初始化或使用对象池
64
- evidence_required:
65
- - "扫描结果:含循环内创建对象的文件路径+行号"
66
-
67
- ## PER-05: 前端组件不必要的重渲染
68
- pattern: /onClick=\{\(\).*=>|style=\{\{/
69
- severity: info
70
- check_type: deterministic
71
- scope: frontend
72
- description: 内联函数和对象作为 props 会导致子组件不必要的重渲染,应使用 useCallback/useMemo
73
- evidence_required:
74
- - "扫描结果:含内联函数/对象的文件路径+行号"
75
-
76
- ## PER-06: 未使用 useMemo/useCallback 的高开销计算
77
- pattern: /(?:\.sort|\.filter|\.map|\.reduce)\s*\(.*=>.*(?:\.sort|\.filter|\.map)/
78
- severity: info
79
- check_type: deterministic
80
- scope: frontend
81
- description: 链式数组操作或高开销计算应使用 useMemo 缓存结果,避免每次渲染重复计算
82
- evidence_required:
83
- - "扫描结果:含未缓存计算的文件路径+行号"
84
-
85
- ## PER-07: 未使用连接池的数据库连接
86
- pattern: /DriverManager\.getConnection/
87
- severity: warning
88
- check_type: deterministic
89
- scope: backend
90
- description: 禁止使用 DriverManager 直接创建连接,必须使用连接池(HikariCP/Druid)
91
- evidence_required:
92
- - "扫描结果:含 DriverManager 调用的文件路径+行号"
93
-
94
- ## PER-08: 大事务包含非必要操作
95
- pattern: /@Transactional[\s\S]*?(?:log\.|email|send|notify|http)/
96
- severity: warning
97
- check_type: deterministic
98
- scope: backend
99
- description: @Transactional 方法内禁止包含发送邮件、HTTP 调用、MQ 发送等非必要操作,避免长事务
100
- evidence_required:
101
- - "扫描结果:含大事务非必要操作的文件路径+行号"
102
-
103
- ## PER-09: 前端图片未压缩或懒加载
104
- pattern: /<img\s+src=/
105
- severity: info
106
- check_type: deterministic
107
- scope: frontend
108
- description: 图片资源必须使用压缩/懒加载/响应式加载,禁止原始大图直接展示
109
- evidence_required:
110
- - "扫描结果:含未优化图片的文件路径+行号"
@@ -1,44 +0,0 @@
1
- ---
2
- id: ka-pattern-interface-contract
3
- kind: knowledge
4
- title: 接口契约
5
- sync_policy: copy_to_project
6
- status: active
7
- extra:
8
- name: interface-contract
9
- scope:
10
- - backend
11
- products:
12
- - '*'
13
- lifecycle_status: active
14
- version: 1.1.0
15
- last_reviewed: '2026-06-01'
16
- type: knowledge
17
- domain: verify
18
- verification_layer: L2
19
- stage: verify
20
- owner_mechanism: mc-backend-pattern
21
- ---
22
-
23
- ## 决策规则
24
- - 每个接口必须有完整定义:路径、方法、认证、请求、响应、错误码
25
- - 页面交互与接口必须有映射表确保一一对应
26
- - 每个接口至少定义:校验失败、权限不足、业务异常、资源不存在四种错误
27
- - 所有枚举字段必须列出完整值集和含义,禁止无枚举定义的 type/status/flag 字段
28
- - 每个接口必须显式声明幂等性和认证属性
29
- - 接口契约中鉴权要求必须能回链到角色与权限模型
30
- - 接口文档必须与代码同步更新,禁止文档与实现不一致
31
- - 破坏性变更必须通过版本号隔离(如 /v1/ → /v2/),保证旧客户端兼容
32
- - 接口响应时间必须有 SLA 约定(如 P99 < 500ms),超时触发告警
33
- - 接口必须定义错误码体系(业务错误码 + HTTP 状态码),客户端可区分处理
34
- - 接口变更必须通知所有消费方,并给予充足的迁移时间
35
-
36
- ## 验收项
37
- - [AC-01] 接口文档包含完整定义(路径/方法/认证/请求/响应/错误)
38
- - [AC-02] 页面交互与接口有映射表
39
- - [AC-03] 枚举字段有完整值集定义
40
- - [AC-04] 接口声明了幂等性和认证属性
41
- - [AC-05] 文档与代码同步
42
- - [AC-06] 破坏性变更版本隔离
43
- - [AC-07] 有 SLA 约定和监控
44
- - [AC-08] 错误码体系完整
@@ -1,131 +0,0 @@
1
- ---
2
- id: ka-review-rule-接口契约审查规则
3
- kind: guidance
4
- title: 接口契约审查
5
- triggers:
6
- - 接口
7
- - 契约
8
- - API
9
- - 版本兼容
10
- sync_policy: copy_to_project
11
- status: active
12
- extra:
13
- name: api-contract-rules
14
- type: constraint
15
- scope:
16
- - backend
17
- products:
18
- - '*'
19
- lifecycle_status: active
20
- version: 1.2.0
21
- last_reviewed: '2026-06-04'
22
- domain: verify
23
- verification_layer: L2
24
- stage: verify
25
- owner_mechanism: mc-generic-review
26
- ---
27
-
28
- ## API-01: Controller 返回 Entity 而非 DTO
29
- languages: [java]
30
- pattern: /ResponseEntity<Entity>|ResponseEntity<\s*$/
31
- severity: warning
32
- check_type: deterministic
33
- scope: backend
34
- description: 禁止直接返回数据库 Entity,必须通过 DTO/VO 转换,防止敏感字段泄漏和结构耦合
35
- evidence_required:
36
- - "扫描结果:含直接返回 Entity 的 Controller 文件路径+行号"
37
- - "修复确认:DTO/VO 转换替换证据"
38
-
39
- ## API-02: 缺少 @Transactional 的写操作
40
- languages: [java]
41
- pattern: /@(PostMapping|PutMapping|DeleteMapping|PatchMapping)/
42
- severity: warning
43
- check_type: deterministic
44
- scope: backend
45
- description: 写操作 Service 方法必须标注 @Transactional(rollbackFor = Exception.class)
46
- evidence_required:
47
- - "扫描结果:含写操作但缺少 @Transactional 的方法文件路径+行号"
48
- - "修复确认:事务注解添加证据"
49
-
50
- ## API-03: 接口缺少权限注解
51
- languages: [java]
52
- pattern: /@(PostMapping|PutMapping|DeleteMapping)/
53
- severity: error
54
- check_type: deterministic
55
- scope: backend
56
- description: 写接口必须有 @PreAuthorize 或 @Secured 注解,禁止裸露写操作
57
- evidence_required:
58
- - "扫描结果:含裸露写操作(无权限注解)的接口文件路径+行号"
59
- - "修复确认:权限注解添加证据"
60
-
61
- ## API-04: 硬编码分页参数
62
- languages: [通用]
63
- pattern: /LIMIT\s+\d+|pageSize\s*=\s*\d{4,}/
64
- severity: warning
65
- check_type: deterministic
66
- scope: backend
67
- description: 分页参数禁止硬编码大数字,pageSize 上限不超过 100
68
- evidence_required:
69
- - "扫描结果:含硬编码分页参数的文件路径+行号"
70
- - "修复确认:参数化替换证据"
71
-
72
- ## API-05: 缺少参数校验注解
73
- languages: [java]
74
- pattern: /@RequestBody\s+\w+\s+\w+/
75
- severity: info
76
- check_type: deterministic
77
- scope: backend
78
- description: "@RequestBody 参数应搭配 @Valid 或 @Validated 注解触发校验"
79
- evidence_required:
80
- - "扫描结果:含未校验 @RequestBody 参数的接口文件路径+行号"
81
-
82
- ## API-06: 接口路径不符合 RESTful 规范
83
- languages: [java]
84
- pattern: /@(Get|Post|Put|Delete)Mapping.*(/get|/query|/add|/update|/delete|/list)/
85
- severity: info
86
- check_type: deterministic
87
- scope: backend
88
- description: 接口路径应使用资源名词 + HTTP 方法语义,避免 /getUser、/deleteOrder 等动词路径
89
- evidence_required:
90
- - "扫描结果:含非 RESTful 路径的接口文件路径+行号"
91
-
92
- ## API-07: 接口缺少统一响应包装
93
- languages: [java]
94
- pattern: /ResponseEntity<\s*(?!ApiResult|Result|R<)/
95
- severity: warning
96
- check_type: deterministic
97
- scope: backend
98
- description: 接口返回值必须使用统一响应包装(如 Result<T>),禁止直接返回裸数据或 ResponseEntity
99
- evidence_required:
100
- - "扫描结果:含未包装响应的接口文件路径+行号"
101
- - "修复确认:统一响应包装替换证据"
102
-
103
- ## API-08: 分页接口返回非标准结构
104
- languages: [java]
105
- pattern: /Page(?:Info|able)|PageRequest/
106
- severity: info
107
- check_type: deterministic
108
- scope: backend
109
- description: 分页接口必须返回标准结构(total、list、pageNum、pageSize),禁止自定义分页格式
110
- evidence_required:
111
- - "扫描结果:含非标准分页结构的接口文件路径+行号"
112
-
113
- ## API-09: 缺少接口版本号
114
- languages: [java]
115
- pattern: /@(?:Get|Post|Put|Delete)Mapping\s*\(\s*"\/(?!v\d)/
116
- severity: info
117
- check_type: deterministic
118
- scope: backend
119
- description: API 路径应包含版本号前缀(如 /api/v1/),便于后续接口演进和兼容
120
- evidence_required:
121
- - "扫描结果:含无版本号路径的接口文件路径+行号"
122
-
123
- ## API-10: 接口缺少 Swagger/OpenAPI 文档注解
124
- languages: [java]
125
- pattern: /@(?:Get|Post|Put|Delete)Mapping\s*\(/
126
- severity: info
127
- check_type: deterministic
128
- scope: backend
129
- description: 接口必须添加 @Operation/@Api 注解,保证 API 文档自动生成
130
- evidence_required:
131
- - "扫描结果:含缺少文档注解的接口文件路径+行号"
@@ -1,47 +0,0 @@
1
- ---
2
- id: ka-pattern-search-pattern
3
- kind: knowledge
4
- title: 搜索模式
5
- sync_policy: copy_to_project
6
- status: active
7
- extra:
8
- name: search-pattern
9
- scope:
10
- - backend
11
- - frontend
12
- products:
13
- - '*'
14
- lifecycle_status: active
15
- version: 1.1.0
16
- last_reviewed: '2026-06-01'
17
- type: knowledge
18
- domain: verify
19
- verification_layer: L2
20
- stage: verify
21
- owner_mechanism: mc-general-pattern
22
- ---
23
-
24
- ## 决策规则
25
- - 列表筛选条件超过 3 个必须封装为 SearchRequest 对象,禁止平铺查询参数
26
- - 动态查询必须使用 MyBatis 动态 SQL 或 JPA Specification,禁止字符串拼接 SQL
27
- - 模糊搜索(LIKE)必须考虑前缀匹配和索引利用,禁止全表扫描 `%keyword%`
28
- - 大数据量全文搜索必须使用 Elasticsearch,禁止数据库 LIKE 性能瓶颈
29
- - 搜索结果必须分页,禁止返回全量匹配结果
30
- - 搜索条件组合必须明确 AND/OR 语义,禁止歧义
31
- - 搜索接口响应时间目标 < 200ms,超过时必须优化(索引/缓存/ES)
32
- - 前端搜索框必须有防抖(建议 300ms),禁止每次按键触发请求
33
- - 搜索接口必须支持分页,禁止无限制返回结果
34
- - 搜索结果必须高亮关键词,提升用户定位效率
35
- - 搜索字段必须建立索引(Elasticsearch mapping 或数据库索引),禁止全表扫描
36
- - 搜索关键词必须做长度限制和特殊字符过滤,防止恶意查询
37
- - 搜索结果必须按相关度排序,支持用户自定义排序条件
38
-
39
- ## 验收项
40
- - [AC-01] 筛选条件封装为对象
41
- - [AC-02] 动态查询无 SQL 拼接
42
- - [AC-03] 搜索结果分页
43
- - [AC-04] 搜索接口响应 < 200ms
44
- - [AC-05] 前端搜索有防抖
45
- - [AC-06] 搜索接口分页
46
- - [AC-07] 关键词高亮
47
- - [AC-08] 搜索字段有索引
@@ -1,67 +0,0 @@
1
- ---
2
- id: ka-artifact_template-故障复盘模版
3
- kind: artifact
4
- title: 故障复盘
5
- sync_policy: copy_to_project
6
- status: active
7
- extra:
8
- name: incident-postmortem
9
- scope:
10
- - backend
11
- - frontend
12
- products:
13
- - '*'
14
- lifecycle_status: active
15
- version: 1.2.0
16
- last_reviewed: '2026-06-07'
17
- type: artifact
18
- domain: verify
19
- stage: verify
20
- owner_mechanism: mc-generic-artifact
21
- ---
22
-
23
- # 故障复盘报告
24
-
25
- ## 1. 故障概要
26
- - **发生时间**:
27
- - **持续时间**:
28
- - **影响范围**(用户数/业务量):
29
- - **严重程度**:P0/P1
30
- - **处理人**:
31
-
32
- ## 2. 时间线
33
- | 时间 | 事件 | 操作人 |
34
- |------|------|--------|
35
- | | 发现问题 | |
36
- | | 通知干系人 | |
37
- | | 执行止血 | |
38
- | | 定位根因 | |
39
- | | 部署修复 | |
40
- | | 确认恢复 | |
41
-
42
- ## 3. 根因分析
43
- - **直接原因**:
44
- - **深层原因**(5 Whys):
45
- 1. 为什么发生?
46
- 2. 为什么没被发现?
47
- 3. 为什么没被阻止?
48
- 4. 为什么监控没告警?
49
- 5. 系统性原因是什么?
50
-
51
- ## 4. 修复过程
52
- - 止血方案:
53
- - 最终修复:
54
- - 修复验证结果:
55
-
56
- ## 5. 暴露的监控盲区
57
- | 监控项 | 当前状态 | 改进方案 | 计划完成时间 |
58
- |--------|---------|---------|------------|
59
- | | | | |
60
-
61
- ## 6. 后续改进项
62
- | 编号 | 改进项 | 类型 | 责任人 | 计划时间 |
63
- |------|--------|------|--------|---------|
64
- | | 补监控 | 防复发 | | |
65
- | | 补测试 | 防复发 | | |
66
- | | 更新知识条目 | 流程 | | |
67
- | | 架构优化 | 根治 | | |