mcp-ai-agent-guidelines 0.16.0 → 0.18.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 (355) hide show
  1. package/CHANGELOG.md +21 -0
  2. package/README.md +44 -27
  3. package/dist/cli/skill-hook-emitter.d.ts +39 -0
  4. package/dist/cli/skill-hook-emitter.d.ts.map +1 -0
  5. package/dist/cli/skill-hook-emitter.js +83 -0
  6. package/dist/cli/skill-hook-emitter.js.map +1 -0
  7. package/dist/cli.d.ts +18 -27
  8. package/dist/cli.d.ts.map +1 -1
  9. package/dist/cli.js +95 -507
  10. package/dist/cli.js.map +1 -1
  11. package/dist/config/orchestration-config.d.ts +4 -4
  12. package/dist/config/orchestration-config.d.ts.map +1 -1
  13. package/dist/config/orchestration-config.js +15 -34
  14. package/dist/config/orchestration-config.js.map +1 -1
  15. package/dist/contracts/runtime.d.ts +7 -101
  16. package/dist/contracts/runtime.d.ts.map +1 -1
  17. package/dist/index.d.ts +22 -1
  18. package/dist/index.d.ts.map +1 -1
  19. package/dist/index.js +62 -84
  20. package/dist/index.js.map +1 -1
  21. package/dist/memory/toon-interface.d.ts +19 -0
  22. package/dist/memory/toon-interface.d.ts.map +1 -1
  23. package/dist/memory/toon-interface.js +52 -21
  24. package/dist/memory/toon-interface.js.map +1 -1
  25. package/dist/runtime/integration.d.ts.map +1 -1
  26. package/dist/runtime/integration.js +3 -0
  27. package/dist/runtime/integration.js.map +1 -1
  28. package/dist/runtime/planning-gate.js +1 -1
  29. package/dist/runtime/planning-gate.js.map +1 -1
  30. package/dist/runtime/session-store-utils.d.ts +17 -3
  31. package/dist/runtime/session-store-utils.d.ts.map +1 -1
  32. package/dist/runtime/session-store-utils.js +36 -9
  33. package/dist/runtime/session-store-utils.js.map +1 -1
  34. package/dist/serena/client.d.ts +107 -0
  35. package/dist/serena/client.d.ts.map +1 -0
  36. package/dist/serena/client.js +181 -0
  37. package/dist/serena/client.js.map +1 -0
  38. package/dist/skills/debug/debug-assistant.d.ts.map +1 -1
  39. package/dist/skills/debug/debug-assistant.js +2 -0
  40. package/dist/skills/debug/debug-assistant.js.map +1 -1
  41. package/dist/skills/qm/qm-tunneling-breakthrough.d.ts.map +1 -1
  42. package/dist/skills/qm/qm-tunneling-breakthrough.js +4 -0
  43. package/dist/skills/qm/qm-tunneling-breakthrough.js.map +1 -1
  44. package/dist/skills/runtime/workspace-adapter.d.ts +8 -69
  45. package/dist/skills/runtime/workspace-adapter.d.ts.map +1 -1
  46. package/dist/skills/runtime/workspace-adapter.js +7 -176
  47. package/dist/skills/runtime/workspace-adapter.js.map +1 -1
  48. package/dist/skills/skill-registry.d.ts +6 -20
  49. package/dist/skills/skill-registry.d.ts.map +1 -1
  50. package/dist/skills/skill-registry.js +15 -37
  51. package/dist/skills/skill-registry.js.map +1 -1
  52. package/dist/snapshots/cache_io.js +1 -1
  53. package/dist/snapshots/cache_io.js.map +1 -1
  54. package/dist/snapshots/schemas.d.ts +2 -2
  55. package/dist/snapshots/symbol-change-tracker.d.ts +0 -14
  56. package/dist/snapshots/symbol-change-tracker.d.ts.map +1 -1
  57. package/dist/snapshots/symbol-change-tracker.js +3 -0
  58. package/dist/snapshots/symbol-change-tracker.js.map +1 -1
  59. package/dist/snapshots/toon_markdown.js +1 -1
  60. package/dist/snapshots/toon_markdown.js.map +1 -1
  61. package/dist/tests/architecture-contracts.test.js +5 -5
  62. package/dist/tests/architecture-contracts.test.js.map +1 -1
  63. package/dist/tests/cli/hooks.test.js +169 -1
  64. package/dist/tests/cli/hooks.test.js.map +1 -1
  65. package/dist/tests/cli/local-tool-sanity.test.d.ts +2 -0
  66. package/dist/tests/cli/local-tool-sanity.test.d.ts.map +1 -0
  67. package/dist/tests/cli/local-tool-sanity.test.js +40 -0
  68. package/dist/tests/cli/local-tool-sanity.test.js.map +1 -0
  69. package/dist/tests/cli/skill-hook-emitter.test.d.ts +2 -0
  70. package/dist/tests/cli/skill-hook-emitter.test.d.ts.map +1 -0
  71. package/dist/tests/cli/skill-hook-emitter.test.js +84 -0
  72. package/dist/tests/cli/skill-hook-emitter.test.js.map +1 -0
  73. package/dist/tests/config/orchestration-config-service.test.js +0 -19
  74. package/dist/tests/config/orchestration-config-service.test.js.map +1 -1
  75. package/dist/tests/config/orchestration-config.test.js +4 -5
  76. package/dist/tests/config/orchestration-config.test.js.map +1 -1
  77. package/dist/tests/contracts/runtime.test.js +1 -1
  78. package/dist/tests/contracts/runtime.test.js.map +1 -1
  79. package/dist/tests/index-main.test.d.ts +2 -0
  80. package/dist/tests/index-main.test.d.ts.map +1 -0
  81. package/dist/tests/index-main.test.js +64 -0
  82. package/dist/tests/index-main.test.js.map +1 -0
  83. package/dist/tests/index.test.js +185 -12
  84. package/dist/tests/index.test.js.map +1 -1
  85. package/dist/tests/infrastructure/graph-orchestration-extra.test.js +1 -1
  86. package/dist/tests/infrastructure/graph-orchestration-extra.test.js.map +1 -1
  87. package/dist/tests/mcp/sdk-compatibility-lane.test.js +19 -79
  88. package/dist/tests/mcp/sdk-compatibility-lane.test.js.map +1 -1
  89. package/dist/tests/mcp/tool-coverage-matrix.test.js +2 -22
  90. package/dist/tests/mcp/tool-coverage-matrix.test.js.map +1 -1
  91. package/dist/tests/memory/lsp-scan-bridge.test.js +2 -2
  92. package/dist/tests/memory/lsp-scan-bridge.test.js.map +1 -1
  93. package/dist/tests/memory/toon-interface.test.js +177 -4
  94. package/dist/tests/memory/toon-interface.test.js.map +1 -1
  95. package/dist/tests/models/model-profile.test.js +7 -7
  96. package/dist/tests/models/model-profile.test.js.map +1 -1
  97. package/dist/tests/models/model-router-extra.test.js.map +1 -1
  98. package/dist/tests/models/multi-model-executor-extra.test.js +2 -2
  99. package/dist/tests/models/multi-model-executor-extra.test.js.map +1 -1
  100. package/dist/tests/readme-installation.test.js +17 -6
  101. package/dist/tests/readme-installation.test.js.map +1 -1
  102. package/dist/tests/runtime/mcp-server.test.js +103 -66
  103. package/dist/tests/runtime/mcp-server.test.js.map +1 -1
  104. package/dist/tests/runtime/planning-gate.test.js +6 -6
  105. package/dist/tests/runtime/planning-gate.test.js.map +1 -1
  106. package/dist/tests/runtime/secure-session-store.test.js +115 -1
  107. package/dist/tests/runtime/secure-session-store.test.js.map +1 -1
  108. package/dist/tests/runtime/session-store-utils.test.js +75 -0
  109. package/dist/tests/runtime/session-store-utils.test.js.map +1 -1
  110. package/dist/tests/runtime/workspace-root.test.d.ts +2 -0
  111. package/dist/tests/runtime/workspace-root.test.d.ts.map +1 -0
  112. package/dist/tests/runtime/workspace-root.test.js +128 -0
  113. package/dist/tests/runtime/workspace-root.test.js.map +1 -0
  114. package/dist/tests/runtime-smoke.test.js +1 -22
  115. package/dist/tests/runtime-smoke.test.js.map +1 -1
  116. package/dist/tests/serena/client.test.d.ts +2 -0
  117. package/dist/tests/serena/client.test.d.ts.map +1 -0
  118. package/dist/tests/serena/client.test.js +283 -0
  119. package/dist/tests/serena/client.test.js.map +1 -0
  120. package/dist/tests/serena/e2e.test.d.ts +16 -0
  121. package/dist/tests/serena/e2e.test.d.ts.map +1 -0
  122. package/dist/tests/serena/e2e.test.js +167 -0
  123. package/dist/tests/serena/e2e.test.js.map +1 -0
  124. package/dist/tests/skills/qm/qm-uncertainty-tradeoff-extra.test.js.map +1 -1
  125. package/dist/tests/skills/test-helpers.d.ts +1 -7
  126. package/dist/tests/skills/test-helpers.d.ts.map +1 -1
  127. package/dist/tests/skills/test-helpers.js +0 -34
  128. package/dist/tests/skills/test-helpers.js.map +1 -1
  129. package/dist/tests/tools/model-discovery.test.js +8 -8
  130. package/dist/tests/tools/model-discovery.test.js.map +1 -1
  131. package/dist/tests/tools/tool-call-handler.test.js +21 -31
  132. package/dist/tests/tools/tool-call-handler.test.js.map +1 -1
  133. package/dist/tests/tools/visualization-tools-extra.test.js.map +1 -1
  134. package/dist/tests/tools/workspace-tools.test.js +6 -164
  135. package/dist/tests/tools/workspace-tools.test.js.map +1 -1
  136. package/dist/tests/validation/error-handling-extra.test.js.map +1 -1
  137. package/dist/tests/workflows/workflow-engine-enhanced.test.js +0 -1
  138. package/dist/tests/workflows/workflow-engine-enhanced.test.js.map +1 -1
  139. package/dist/tools/tool-call-handler.d.ts.map +1 -1
  140. package/dist/tools/tool-call-handler.js +166 -104
  141. package/dist/tools/tool-call-handler.js.map +1 -1
  142. package/dist/tools/workspace-tools.d.ts +1 -1
  143. package/dist/tools/workspace-tools.d.ts.map +1 -1
  144. package/dist/tools/workspace-tools.js +7 -167
  145. package/dist/tools/workspace-tools.js.map +1 -1
  146. package/dist/validation/core-schemas.d.ts +11 -11
  147. package/dist/visualization/glyph-registry.js +1 -1
  148. package/dist/visualization/glyph-registry.js.map +1 -1
  149. package/dist/workflows/mermaid-bridge.js +2 -2
  150. package/dist/workflows/mermaid-bridge.js.map +1 -1
  151. package/dist/workflows/workflow-engine.d.ts +0 -14
  152. package/dist/workflows/workflow-engine.d.ts.map +1 -1
  153. package/dist/workflows/workflow-engine.js +1 -57
  154. package/dist/workflows/workflow-engine.js.map +1 -1
  155. package/package.json +10 -11
  156. package/dist/cli/script-runner.d.ts +0 -35
  157. package/dist/cli/script-runner.d.ts.map +0 -1
  158. package/dist/cli/script-runner.js +0 -124
  159. package/dist/cli/script-runner.js.map +0 -1
  160. package/dist/memory/glyphs-layer.d.ts +0 -237
  161. package/dist/memory/glyphs-layer.d.ts.map +0 -1
  162. package/dist/memory/glyphs-layer.js +0 -300
  163. package/dist/memory/glyphs-layer.js.map +0 -1
  164. package/dist/models/model-orchestration-runner.d.ts +0 -25
  165. package/dist/models/model-orchestration-runner.d.ts.map +0 -1
  166. package/dist/models/model-orchestration-runner.js +0 -87
  167. package/dist/models/model-orchestration-runner.js.map +0 -1
  168. package/dist/onboarding/orchestration-editor.d.ts +0 -22
  169. package/dist/onboarding/orchestration-editor.d.ts.map +0 -1
  170. package/dist/onboarding/orchestration-editor.js +0 -322
  171. package/dist/onboarding/orchestration-editor.js.map +0 -1
  172. package/dist/onboarding/wizard.d.ts +0 -91
  173. package/dist/onboarding/wizard.d.ts.map +0 -1
  174. package/dist/onboarding/wizard.js +0 -591
  175. package/dist/onboarding/wizard.js.map +0 -1
  176. package/dist/presentation/cli-extensions.d.ts +0 -60
  177. package/dist/presentation/cli-extensions.d.ts.map +0 -1
  178. package/dist/presentation/cli-extensions.js +0 -873
  179. package/dist/presentation/cli-extensions.js.map +0 -1
  180. package/dist/presentation/documentation-integration.d.ts +0 -120
  181. package/dist/presentation/documentation-integration.d.ts.map +0 -1
  182. package/dist/presentation/documentation-integration.js +0 -648
  183. package/dist/presentation/documentation-integration.js.map +0 -1
  184. package/dist/presentation/index.d.ts +0 -5
  185. package/dist/presentation/index.d.ts.map +0 -1
  186. package/dist/presentation/index.js +0 -3
  187. package/dist/presentation/index.js.map +0 -1
  188. package/dist/runtime/session-bootstrap.d.ts +0 -43
  189. package/dist/runtime/session-bootstrap.d.ts.map +0 -1
  190. package/dist/runtime/session-bootstrap.js +0 -218
  191. package/dist/runtime/session-bootstrap.js.map +0 -1
  192. package/dist/runtime/session-codec.d.ts +0 -33
  193. package/dist/runtime/session-codec.d.ts.map +0 -1
  194. package/dist/runtime/session-codec.js +0 -108
  195. package/dist/runtime/session-codec.js.map +0 -1
  196. package/dist/runtime/session-manager.d.ts +0 -107
  197. package/dist/runtime/session-manager.d.ts.map +0 -1
  198. package/dist/runtime/session-manager.js +0 -273
  199. package/dist/runtime/session-manager.js.map +0 -1
  200. package/dist/runtime/session-store.d.ts +0 -13
  201. package/dist/runtime/session-store.d.ts.map +0 -1
  202. package/dist/runtime/session-store.js +0 -38
  203. package/dist/runtime/session-store.js.map +0 -1
  204. package/dist/runtime/toon-ecosystem-demo.d.ts +0 -55
  205. package/dist/runtime/toon-ecosystem-demo.d.ts.map +0 -1
  206. package/dist/runtime/toon-ecosystem-demo.js +0 -187
  207. package/dist/runtime/toon-ecosystem-demo.js.map +0 -1
  208. package/dist/tests/cli/cli-main.test.d.ts +0 -2
  209. package/dist/tests/cli/cli-main.test.d.ts.map +0 -1
  210. package/dist/tests/cli/cli-main.test.js +0 -51
  211. package/dist/tests/cli/cli-main.test.js.map +0 -1
  212. package/dist/tests/cli/cli.test.d.ts +0 -2
  213. package/dist/tests/cli/cli.test.d.ts.map +0 -1
  214. package/dist/tests/cli/cli.test.js +0 -194
  215. package/dist/tests/cli/cli.test.js.map +0 -1
  216. package/dist/tests/cli/onboard.test.d.ts +0 -2
  217. package/dist/tests/cli/onboard.test.d.ts.map +0 -1
  218. package/dist/tests/cli/onboard.test.js +0 -201
  219. package/dist/tests/cli/onboard.test.js.map +0 -1
  220. package/dist/tests/cli/script-runner.test.d.ts +0 -2
  221. package/dist/tests/cli/script-runner.test.d.ts.map +0 -1
  222. package/dist/tests/cli/script-runner.test.js +0 -51
  223. package/dist/tests/cli/script-runner.test.js.map +0 -1
  224. package/dist/tests/cli-script-runner.test.d.ts +0 -2
  225. package/dist/tests/cli-script-runner.test.d.ts.map +0 -1
  226. package/dist/tests/cli-script-runner.test.js +0 -83
  227. package/dist/tests/cli-script-runner.test.js.map +0 -1
  228. package/dist/tests/memory/glyphs-layer.test.d.ts +0 -5
  229. package/dist/tests/memory/glyphs-layer.test.d.ts.map +0 -1
  230. package/dist/tests/memory/glyphs-layer.test.js +0 -168
  231. package/dist/tests/memory/glyphs-layer.test.js.map +0 -1
  232. package/dist/tests/models/model-orchestration-runner.test.d.ts +0 -2
  233. package/dist/tests/models/model-orchestration-runner.test.d.ts.map +0 -1
  234. package/dist/tests/models/model-orchestration-runner.test.js +0 -100
  235. package/dist/tests/models/model-orchestration-runner.test.js.map +0 -1
  236. package/dist/tests/onboarding/orchestration-editor.test.d.ts +0 -2
  237. package/dist/tests/onboarding/orchestration-editor.test.d.ts.map +0 -1
  238. package/dist/tests/onboarding/orchestration-editor.test.js +0 -203
  239. package/dist/tests/onboarding/orchestration-editor.test.js.map +0 -1
  240. package/dist/tests/onboarding/wizard.test.d.ts +0 -2
  241. package/dist/tests/onboarding/wizard.test.d.ts.map +0 -1
  242. package/dist/tests/onboarding/wizard.test.js +0 -1210
  243. package/dist/tests/onboarding/wizard.test.js.map +0 -1
  244. package/dist/tests/presentation/cli-extensions.test.d.ts +0 -2
  245. package/dist/tests/presentation/cli-extensions.test.d.ts.map +0 -1
  246. package/dist/tests/presentation/cli-extensions.test.js +0 -639
  247. package/dist/tests/presentation/cli-extensions.test.js.map +0 -1
  248. package/dist/tests/presentation/documentation-integration.test.d.ts +0 -2
  249. package/dist/tests/presentation/documentation-integration.test.d.ts.map +0 -1
  250. package/dist/tests/presentation/documentation-integration.test.js +0 -468
  251. package/dist/tests/presentation/documentation-integration.test.js.map +0 -1
  252. package/dist/tests/presentation/index.test.d.ts +0 -2
  253. package/dist/tests/presentation/index.test.d.ts.map +0 -1
  254. package/dist/tests/presentation/index.test.js +0 -12
  255. package/dist/tests/presentation/index.test.js.map +0 -1
  256. package/dist/tests/runtime/session-bootstrap.test.d.ts +0 -2
  257. package/dist/tests/runtime/session-bootstrap.test.d.ts.map +0 -1
  258. package/dist/tests/runtime/session-bootstrap.test.js +0 -97
  259. package/dist/tests/runtime/session-bootstrap.test.js.map +0 -1
  260. package/dist/tests/runtime/session-codec.test.d.ts +0 -2
  261. package/dist/tests/runtime/session-codec.test.d.ts.map +0 -1
  262. package/dist/tests/runtime/session-codec.test.js +0 -160
  263. package/dist/tests/runtime/session-codec.test.js.map +0 -1
  264. package/dist/tests/runtime/session-manager.test.d.ts +0 -2
  265. package/dist/tests/runtime/session-manager.test.d.ts.map +0 -1
  266. package/dist/tests/runtime/session-manager.test.js +0 -213
  267. package/dist/tests/runtime/session-manager.test.js.map +0 -1
  268. package/dist/tests/runtime/session-read-seam.test.d.ts +0 -12
  269. package/dist/tests/runtime/session-read-seam.test.d.ts.map +0 -1
  270. package/dist/tests/runtime/session-read-seam.test.js +0 -140
  271. package/dist/tests/runtime/session-read-seam.test.js.map +0 -1
  272. package/dist/tests/runtime/session-store.test.d.ts +0 -2
  273. package/dist/tests/runtime/session-store.test.d.ts.map +0 -1
  274. package/dist/tests/runtime/session-store.test.js +0 -64
  275. package/dist/tests/runtime/session-store.test.js.map +0 -1
  276. package/dist/tests/runtime/skill-bridge.test.d.ts +0 -13
  277. package/dist/tests/runtime/skill-bridge.test.d.ts.map +0 -1
  278. package/dist/tests/runtime/skill-bridge.test.js +0 -243
  279. package/dist/tests/runtime/skill-bridge.test.js.map +0 -1
  280. package/dist/tests/runtime/toon-architecture-contracts.test.d.ts +0 -7
  281. package/dist/tests/runtime/toon-architecture-contracts.test.d.ts.map +0 -1
  282. package/dist/tests/runtime/toon-architecture-contracts.test.js +0 -86
  283. package/dist/tests/runtime/toon-architecture-contracts.test.js.map +0 -1
  284. package/dist/tests/runtime/toon-ecosystem-demo.test.d.ts +0 -2
  285. package/dist/tests/runtime/toon-ecosystem-demo.test.d.ts.map +0 -1
  286. package/dist/tests/runtime/toon-ecosystem-demo.test.js +0 -155
  287. package/dist/tests/runtime/toon-ecosystem-demo.test.js.map +0 -1
  288. package/dist/tests/simulations/session-1.test.d.ts +0 -2
  289. package/dist/tests/simulations/session-1.test.d.ts.map +0 -1
  290. package/dist/tests/simulations/session-1.test.js +0 -679
  291. package/dist/tests/simulations/session-1.test.js.map +0 -1
  292. package/dist/tests/simulations/workflow-persistence-resume.test.d.ts +0 -19
  293. package/dist/tests/simulations/workflow-persistence-resume.test.d.ts.map +0 -1
  294. package/dist/tests/simulations/workflow-persistence-resume.test.js +0 -156
  295. package/dist/tests/simulations/workflow-persistence-resume.test.js.map +0 -1
  296. package/dist/tests/skills/runtime/workspace-adapter-extra.test.d.ts +0 -2
  297. package/dist/tests/skills/runtime/workspace-adapter-extra.test.d.ts.map +0 -1
  298. package/dist/tests/skills/runtime/workspace-adapter-extra.test.js +0 -204
  299. package/dist/tests/skills/runtime/workspace-adapter-extra.test.js.map +0 -1
  300. package/dist/tests/skills/runtime/workspace-adapter.test.d.ts +0 -2
  301. package/dist/tests/skills/runtime/workspace-adapter.test.d.ts.map +0 -1
  302. package/dist/tests/skills/runtime/workspace-adapter.test.js +0 -109
  303. package/dist/tests/skills/runtime/workspace-adapter.test.js.map +0 -1
  304. package/dist/tests/tools/memory-tools.test.d.ts +0 -2
  305. package/dist/tests/tools/memory-tools.test.d.ts.map +0 -1
  306. package/dist/tests/tools/memory-tools.test.js +0 -175
  307. package/dist/tests/tools/memory-tools.test.js.map +0 -1
  308. package/dist/tests/tools/orchestration-tools.test.d.ts +0 -2
  309. package/dist/tests/tools/orchestration-tools.test.d.ts.map +0 -1
  310. package/dist/tests/tools/orchestration-tools.test.js +0 -89
  311. package/dist/tests/tools/orchestration-tools.test.js.map +0 -1
  312. package/dist/tests/tools/session-tools.test.d.ts +0 -2
  313. package/dist/tests/tools/session-tools.test.d.ts.map +0 -1
  314. package/dist/tests/tools/session-tools.test.js +0 -184
  315. package/dist/tests/tools/session-tools.test.js.map +0 -1
  316. package/dist/tests/tools/snapshot-tools.test.d.ts +0 -2
  317. package/dist/tests/tools/snapshot-tools.test.d.ts.map +0 -1
  318. package/dist/tests/tools/snapshot-tools.test.js +0 -192
  319. package/dist/tests/tools/snapshot-tools.test.js.map +0 -1
  320. package/dist/tests/tools/workspace-tools-extra.test.d.ts +0 -2
  321. package/dist/tests/tools/workspace-tools-extra.test.d.ts.map +0 -1
  322. package/dist/tests/tools/workspace-tools-extra.test.js +0 -66
  323. package/dist/tests/tools/workspace-tools-extra.test.js.map +0 -1
  324. package/dist/tests/workflows/workflow-checkpoint.test.d.ts +0 -6
  325. package/dist/tests/workflows/workflow-checkpoint.test.d.ts.map +0 -1
  326. package/dist/tests/workflows/workflow-checkpoint.test.js +0 -361
  327. package/dist/tests/workflows/workflow-checkpoint.test.js.map +0 -1
  328. package/dist/tests/workflows/workflow-engine-checkpointing.test.d.ts +0 -17
  329. package/dist/tests/workflows/workflow-engine-checkpointing.test.d.ts.map +0 -1
  330. package/dist/tests/workflows/workflow-engine-checkpointing.test.js +0 -312
  331. package/dist/tests/workflows/workflow-engine-checkpointing.test.js.map +0 -1
  332. package/dist/tools/memory-tools.d.ts +0 -14
  333. package/dist/tools/memory-tools.d.ts.map +0 -1
  334. package/dist/tools/memory-tools.js +0 -321
  335. package/dist/tools/memory-tools.js.map +0 -1
  336. package/dist/tools/orchestration-tools.d.ts +0 -6
  337. package/dist/tools/orchestration-tools.d.ts.map +0 -1
  338. package/dist/tools/orchestration-tools.js +0 -168
  339. package/dist/tools/orchestration-tools.js.map +0 -1
  340. package/dist/tools/session-tools.d.ts +0 -14
  341. package/dist/tools/session-tools.d.ts.map +0 -1
  342. package/dist/tools/session-tools.js +0 -347
  343. package/dist/tools/session-tools.js.map +0 -1
  344. package/dist/tools/snapshot-tools.d.ts +0 -14
  345. package/dist/tools/snapshot-tools.d.ts.map +0 -1
  346. package/dist/tools/snapshot-tools.js +0 -266
  347. package/dist/tools/snapshot-tools.js.map +0 -1
  348. package/dist/toon-demo.d.ts +0 -8
  349. package/dist/toon-demo.d.ts.map +0 -1
  350. package/dist/toon-demo.js +0 -21
  351. package/dist/toon-demo.js.map +0 -1
  352. package/dist/workflows/workflow-checkpoint.d.ts +0 -134
  353. package/dist/workflows/workflow-checkpoint.d.ts.map +0 -1
  354. package/dist/workflows/workflow-checkpoint.js +0 -200
  355. package/dist/workflows/workflow-checkpoint.js.map +0 -1
package/CHANGELOG.md CHANGED
@@ -8,6 +8,27 @@ and [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
8
8
 
9
9
  ## [Unreleased]
10
10
 
11
+ ## [0.18.0] - 2026-06-16
12
+
13
+ ### Changed
14
+ - remove toon (#1517)
15
+
16
+ ## [0.17.0] - 2026-05-05
17
+ ### Added
18
+ - implement workspace root anchoring for state storage and enhance ToonMemoryInterface
19
+ - **mcp**: implement startup onboarding memory handling and enhance tool result summarization
20
+ - **mcp**: allow workspace writes when uninitialized
21
+
22
+ ### Documentation
23
+ - **mcp**: document local write behavior for .mcp-ai-agent-guidelines
24
+
25
+ ### Fixed
26
+ - **pr**: address PR #1467 review feedback
27
+ - **mcp**: make all state artifact writes atomic
28
+ - **mcp**: use atomic writes for memory artifacts and snapshots
29
+
30
+ ### Changed
31
+ - **mcp**: improve workspace directory handling and cleanup in tests
11
32
  ## [0.16.0] - 2026-04-28
12
33
  ### Fixed
13
34
  - update tool references and enhance memory tool tests for better context handling
package/README.md CHANGED
@@ -57,8 +57,8 @@ npm install -g mcp-ai-agent-guidelines
57
57
  # MCP stdio server entrypoint
58
58
  mcp-ai-agent-guidelines
59
59
 
60
- # Interactive CLI
61
- mcp-cli info
60
+ # IDE hook + skill-file installer
61
+ mcp-cli --help
62
62
  ```
63
63
 
64
64
  ### Local install (monorepo / project dependency)
@@ -116,12 +116,19 @@ Add the server to your MCP host config. The entry-point is `dist/index.js` and c
116
116
 
117
117
  ### Claude Desktop (`~/Library/Application Support/Claude/claude_desktop_config.json`)
118
118
 
119
+ > [!IMPORTANT]
120
+ > Claude Desktop spawns the server with a different working directory than your project.
121
+ > Set `MCP_WORKSPACE_ROOT` to the absolute path of the project you want the server to write state into.
122
+
119
123
  ```json
120
124
  {
121
125
  "mcpServers": {
122
126
  "ai-agent-guidelines": {
123
127
  "command": "npx",
124
- "args": ["mcp-ai-agent-guidelines"]
128
+ "args": ["-y", "mcp-ai-agent-guidelines@latest"],
129
+ "env": {
130
+ "MCP_WORKSPACE_ROOT": "/absolute/path/to/your/project"
131
+ }
125
132
  }
126
133
  }
127
134
  }
@@ -135,7 +142,10 @@ Add the server to your MCP host config. The entry-point is `dist/index.js` and c
135
142
  "ai-agent-guidelines": {
136
143
  "type": "stdio",
137
144
  "command": "npx",
138
- "args": ["mcp-ai-agent-guidelines"]
145
+ "args": ["-y", "mcp-ai-agent-guidelines@latest"],
146
+ "env": {
147
+ "MCP_WORKSPACE_ROOT": "${workspaceFolder}"
148
+ }
139
149
  }
140
150
  }
141
151
  }
@@ -158,24 +168,19 @@ Add the server to your MCP host config. The entry-point is `dist/index.js` and c
158
168
 
159
169
  ## CLI Usage
160
170
 
161
- An interactive CLI wizard is included for standalone use outside an MCP host. The
162
- published package exposes two entrypoints:
171
+ The published package exposes two entrypoints:
163
172
 
164
- - `mcp-ai-agent-guidelines` — MCP stdio server entrypoint for editors and MCP hosts
165
- - `mcp-cli` — interactive CLI for onboarding, orchestration, and diagnostics
173
+ - `mcp-ai-agent-guidelines` — MCP stdio server entrypoint for editors and MCP hosts (the primary surface; an agent reaches all functionality through this)
174
+ - `mcp-cli` — a thin IDE-integration installer. It does not duplicate MCP server functionality; its only purpose is to wire up the hook scripts and per-IDE `SKILL.md` files that an agent itself cannot install.
166
175
 
167
176
  ```bash
168
- # Project onboarding
169
- mcp-cli onboard init
170
-
171
- # Re-open the orchestration editor
172
- mcp-cli orchestration edit
173
-
174
- # Quick re-entry for environment + model fleet only
175
- mcp-cli orchestration edit --quick
177
+ # Install SessionStart / PreToolUse hooks for an IDE
178
+ mcp-cli hooks setup --client vscode # or copilot-cli / claude-code
179
+ mcp-cli hooks print --client claude-code # preview without writing
176
180
 
177
- # Direct skill invocation
178
- mcp-cli --skill core-prompt-engineering --request "Write a system prompt for a coding assistant"
181
+ # Emit per-IDE skill files for every public instruction
182
+ mcp-cli onboard skills --target all # copilot + claude + codex
183
+ mcp-cli onboard skills --target claude --global # user-home install
179
184
  ```
180
185
 
181
186
  Instruction-tool input schema — the public instruction workflows share this shape:
@@ -192,10 +197,8 @@ Instruction-tool input schema — the public instruction workflows share this sh
192
197
 
193
198
  ## Configuration Files
194
199
 
195
- - `.mcp-ai-agent-guidelines/config/orchestration.toml` — primary orchestration authority (local, not tracked in git)
196
- - `src/config/orchestration-defaults.ts` — builtin bootstrap defaults used to auto-create the workspace config in advisory mode when `orchestration.toml` is absent
197
-
198
- First-time runs auto-create `orchestration.toml` from builtin advisory defaults, including semantic role placeholders so routing can proceed before model discovery. Run `mcp-cli onboard init` to customize the setup or `mcp-cli orchestration edit` to reopen the interactive editor.
200
+ - `.mcp-ai-agent-guidelines/config/orchestration.toml` — optional orchestration overrides. The MCP server **no longer auto-writes** this file; defaults come from `src/config/orchestration-defaults.ts` in memory. Write the file explicitly (via `mcp-cli` is no longer available — edit by hand, or persist via the `model-discover` MCP tool's save action) if you need to override the advisory defaults.
201
+ - `src/config/orchestration-defaults.ts` — builtin defaults used in memory whenever a workspace config is absent.
199
202
 
200
203
  ---
201
204
 
@@ -359,7 +362,21 @@ Published package note: the npm package ships `dist/`, `README.md`, and `LICENSE
359
362
  | `DISABLE_ADAPTIVE_ROUTING` | unset / `"false"` | Set to `true` to hide `routing-adapt` and block `adapt-*` skills; enabled by default (opt-out model) |
360
363
  | `ALLOW_INTENSIVE_SKILLS` | unset / `"false"` | Must be `true` to allow resource-intensive skills such as `bench-eval-suite`, `eval-prompt-bench`, `qm-path-integral-historian`, and `gr-spacetime-debt-metric` |
361
364
  | `ENABLE_PHYSICS_SKILLS` | unset / `"false"` | Required by input validation when physics skills are not otherwise authorized; physics skills also require conventional-evidence schema validation |
365
+ | `MCP_WORKSPACE_ROOT` | unset | Absolute path to the project directory the server should write state into (`.mcp-ai-agent-guidelines/`). Required when using `npx` via Claude Desktop, Cursor, or Windsurf — these clients do not preserve the terminal's working directory. VS Code supports `${workspaceFolder}`. |
362
366
  | `MCP_SLIM_MODE` | unset / `"false"` | Set to `true` to expose only the minimal surface: `task-bootstrap`, `meta-routing`, and `project-onboard` (useful for low-context agents) |
367
+ | `MCP_SERENA_COMMAND` | unset | Opt-in. When set, the server spawns Serena as a child MCP server over stdio and resolves Serena queries directly. When unset (default), the server emits structured **advisories** that the host model executes via its own Serena connection — recommended when the host (e.g. Claude Code) already runs Serena. |
368
+ | `MCP_SERENA_ARGS` | unset | Space-separated args passed to `MCP_SERENA_COMMAND`. Example: `--from git+https://github.com/oraios/serena serena-mcp-server`. |
369
+ | `MCP_SERENA_CWD` | unset | Working directory for the spawned Serena child. Defaults to the parent process cwd. |
370
+ | `MCP_LOCAL_MEMORY` | unset / `"false"` | Set to `true` to restore the legacy per-tool-call TOON memory artifact write+read flow (writes under `.mcp-ai-agent-guidelines/memory/`). Off by default — the Serena advisory footer is the recommended cross-session memory channel. |
371
+
372
+ ### Symbol & memory backend (Serena)
373
+
374
+ Tool responses can be enriched with Serena's LSP-backed symbol surface and per-project memories. Two modes:
375
+
376
+ - **Advisory mode (default)** — no setup. Tool responses append a `🧭 Serena enrichment available` footer that names the exact Serena tool (`mcp__serena__find_symbol`, `mcp__serena__list_memories`, etc.) and arguments the host model should call. Use this when your MCP host already loads Serena as a sibling server (e.g. Claude Code with Serena configured).
377
+ - **Child-spawn mode (opt-in)** — set `MCP_SERENA_COMMAND=uvx` and `MCP_SERENA_ARGS="--from git+https://github.com/oraios/serena serena start-mcp-server --project <your-project-path>"`. The server spawns Serena once on startup and resolves queries directly, embedding the data in the response footer. Pin `--project` explicitly because Serena's global registry won't auto-activate a fresh `cwd`. Use this mode when no host-level Serena is available. Verify the wiring with `npm run test:mcp:serena` (requires `MCP_SERENA_E2E=1` and `uvx` installed).
378
+
379
+ Both modes go through the same internal seam (`src/serena/client.ts`), so tool code paths are identical regardless of mode.
363
380
 
364
381
  ### Skill gates
365
382
 
@@ -416,15 +433,15 @@ Copy the following JSON to `~/.copilot/hooks/mcp-ai-agent-guidelines-hooks.json`
416
433
 
417
434
  ### Routing guidance
418
435
 
419
- The `.agent/rules/` directory contains IDE-readable routing tables:
436
+ The `.claude/rules/` directory contains IDE-readable routing tables:
420
437
 
421
- - `.agent/rules/default.md` — universal symptom → tool pipeline table and anti-patterns
422
- - `.agent/rules/copilot.md` — VS Code Copilot-specific quick reference and session-start checklist
438
+ - `.claude/rules/default.md` — universal symptom → tool pipeline table and anti-patterns
439
+ - `.claude/rules/copilot.md` — VS Code Copilot-specific quick reference and session-start checklist
423
440
 
424
- These files are automatically picked up by Copilot's custom instructions system and by Serena's hook integration layer.
441
+ These files are automatically picked up by Claude Code, Copilot's custom instructions system, and Serena's hook integration layer.
425
442
 
426
443
  > [!NOTE]
427
- > The published npm package does **not** include `.agent/rules/`. If you install from npm and want these routing rules, copy them from the GitHub repository into your workspace.
444
+ > The published npm package does **not** include `.claude/rules/`. If you install from npm and want these routing rules, copy them from the GitHub repository into your workspace.
428
445
 
429
446
  ---
430
447
 
@@ -0,0 +1,39 @@
1
+ /**
2
+ * Per-IDE skill-hook emitter.
3
+ *
4
+ * Writes one `SKILL.md` file per public instruction into a client-specific
5
+ * directory so target IDEs (Copilot, Claude Code, Codex) can auto-load them
6
+ * as skills. Extracted from the old `OnboardingWizard.emitSkillHooks` so the
7
+ * wizard (and the rest of the TOON-based onboarding stack) can be deleted
8
+ * without losing this IDE-integration surface.
9
+ *
10
+ * Layout:
11
+ *
12
+ * | Client | Local | Global |
13
+ * |----------|----------------------|------------------------------|
14
+ * | copilot | .github/skills/ | ~/.copilot/skills/ |
15
+ * | claude | .claude/skills/ | ~/.claude/skills/ |
16
+ * | codex | .agents/skills/ | ~/.agents/skills/ |
17
+ *
18
+ * "Local" = workspace-relative; "global" = under the user's home directory.
19
+ */
20
+ export type SkillHookClient = "copilot" | "claude" | "codex";
21
+ export declare const SKILL_HOOK_CLIENTS: readonly SkillHookClient[];
22
+ export interface EmitSkillHooksOptions {
23
+ /** When true, write to user-home paths instead of workspace-relative ones. */
24
+ global?: boolean;
25
+ /** Subset of clients to target. Defaults to all three. */
26
+ clients?: readonly SkillHookClient[];
27
+ /** Override the workspace root used for "local" writes (defaults to cwd). */
28
+ cwd?: string;
29
+ /** Override `homedir()` (test seam). */
30
+ home?: string;
31
+ /** Disable the per-client console summary (test seam). */
32
+ quiet?: boolean;
33
+ }
34
+ /**
35
+ * Emit one SKILL.md per public instruction into the requested clients'
36
+ * skill-hook directories. Returns the total file count.
37
+ */
38
+ export declare function emitSkillHooks(options?: EmitSkillHooksOptions): Promise<number>;
39
+ //# sourceMappingURL=skill-hook-emitter.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"skill-hook-emitter.d.ts","sourceRoot":"","sources":["../../src/cli/skill-hook-emitter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAQH,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE7D,eAAO,MAAM,kBAAkB,EAAE,SAAS,eAAe,EAIxD,CAAC;AAoBF,MAAM,WAAW,qBAAqB;IACrC,8EAA8E;IAC9E,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,2DAA2D;IAC3D,OAAO,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;IACrC,6EAA6E;IAC7E,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,KAAK,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAsB,cAAc,CACnC,OAAO,GAAE,qBAA0B,GACjC,OAAO,CAAC,MAAM,CAAC,CAiDjB"}
@@ -0,0 +1,83 @@
1
+ /**
2
+ * Per-IDE skill-hook emitter.
3
+ *
4
+ * Writes one `SKILL.md` file per public instruction into a client-specific
5
+ * directory so target IDEs (Copilot, Claude Code, Codex) can auto-load them
6
+ * as skills. Extracted from the old `OnboardingWizard.emitSkillHooks` so the
7
+ * wizard (and the rest of the TOON-based onboarding stack) can be deleted
8
+ * without losing this IDE-integration surface.
9
+ *
10
+ * Layout:
11
+ *
12
+ * | Client | Local | Global |
13
+ * |----------|----------------------|------------------------------|
14
+ * | copilot | .github/skills/ | ~/.copilot/skills/ |
15
+ * | claude | .claude/skills/ | ~/.claude/skills/ |
16
+ * | codex | .agents/skills/ | ~/.agents/skills/ |
17
+ *
18
+ * "Local" = workspace-relative; "global" = under the user's home directory.
19
+ */
20
+ import { mkdir, writeFile } from "node:fs/promises";
21
+ import { homedir } from "node:os";
22
+ import { join } from "node:path";
23
+ import chalk from "chalk";
24
+ import { INSTRUCTION_SPECS } from "../instructions/instruction-specs.js";
25
+ export const SKILL_HOOK_CLIENTS = [
26
+ "copilot",
27
+ "claude",
28
+ "codex",
29
+ ];
30
+ const SKILL_HOOK_DIRS = {
31
+ copilot: {
32
+ local: [".github", "skills"],
33
+ global: [".copilot", "skills"],
34
+ },
35
+ claude: {
36
+ local: [".claude", "skills"],
37
+ global: [".claude", "skills"],
38
+ },
39
+ codex: {
40
+ local: [".agents", "skills"],
41
+ global: [".agents", "skills"],
42
+ },
43
+ };
44
+ /**
45
+ * Emit one SKILL.md per public instruction into the requested clients'
46
+ * skill-hook directories. Returns the total file count.
47
+ */
48
+ export async function emitSkillHooks(options = {}) {
49
+ const { global = false, clients = SKILL_HOOK_CLIENTS, cwd = process.cwd(), home = homedir(), quiet = false, } = options;
50
+ const publicSpecs = INSTRUCTION_SPECS.filter((spec) => spec.public);
51
+ let written = 0;
52
+ for (const client of clients) {
53
+ const segments = global
54
+ ? SKILL_HOOK_DIRS[client].global
55
+ : SKILL_HOOK_DIRS[client].local;
56
+ const rootDir = join(global ? home : cwd, ...segments);
57
+ for (const spec of publicSpecs) {
58
+ const skillDir = join(rootDir, spec.toolName);
59
+ await mkdir(skillDir, { recursive: true });
60
+ const content = [
61
+ "---",
62
+ `name: "${spec.toolName}"`,
63
+ "description: |",
64
+ ...spec.description.split("\n").map((line) => ` ${line}`),
65
+ "---",
66
+ "",
67
+ `<!-- Generated by mcp-cli onboard skills${global ? " --global" : ""} --client ${client} -->`,
68
+ `<!-- Source: ${spec.sourcePath} -->`,
69
+ "",
70
+ ].join("\n");
71
+ await writeFile(join(skillDir, "SKILL.md"), content, "utf8");
72
+ written++;
73
+ }
74
+ if (!quiet) {
75
+ const destLabel = global
76
+ ? `~/${segments.join("/")}/ `
77
+ : `${segments.join("/")}/ `;
78
+ console.log(chalk.cyan(` 📁 [${client}] Skill hooks → ${destLabel}(${publicSpecs.length} files)`));
79
+ }
80
+ }
81
+ return written;
82
+ }
83
+ //# sourceMappingURL=skill-hook-emitter.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"skill-hook-emitter.js","sourceRoot":"","sources":["../../src/cli/skill-hook-emitter.ts"],"names":[],"mappings":"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"}
package/dist/cli.d.ts CHANGED
@@ -1,35 +1,26 @@
1
1
  /**
2
- * CLI foundation for MCP AI Agent Guidelines v2
3
- * Commander.js-based CLI tooling for configuration management and onboarding
4
- */
5
- import { ScriptRunner } from "./cli/script-runner.js";
6
- import { ToonMemoryInterface } from "./memory/toon-interface.js";
7
- import { ModelOrchestrationRunner } from "./models/model-orchestration-runner.js";
8
- import OnboardingWizard from "./onboarding/wizard.js";
9
- import { ReportingCliCommands } from "./presentation/cli-extensions.js";
10
- interface CliContext {
11
- memoryInterface: ToonMemoryInterface;
12
- onboardingWizard: OnboardingWizard;
13
- orchestrationRunner: ModelOrchestrationRunner;
14
- reportingCommands: ReportingCliCommands;
15
- scriptRunner: ScriptRunner;
16
- verbose: boolean;
17
- }
18
- /**
19
- * Main CLI application
2
+ * `mcp-cli` slim companion CLI for the MCP server.
3
+ *
4
+ * Scope is intentionally tiny: the MCP server (and Serena, via the 🧭
5
+ * enrichment footer it emits) covers everything an agent needs at runtime.
6
+ * What an agent **cannot** do is wire up IDE-side hooks and per-IDE skill
7
+ * files that's the only purpose this CLI still serves.
8
+ *
9
+ * Commands:
10
+ * - `hooks setup --client <vscode|copilot-cli|claude-code>` — install
11
+ * SessionStart / PreToolUse hook scripts so the IDE re-orients the
12
+ * agent on session boundaries and drift.
13
+ * - `hooks print --client <client>` — preview the hook JSON.
14
+ * - `hooks remind-session` / `hooks remind-drift` — invoked **by** the
15
+ * installed hook scripts at runtime; not user-facing.
16
+ * - `onboard skills [--global] [--target copilot|claude|codex|all]` —
17
+ * generate per-IDE `SKILL.md` hook files for every public instruction.
20
18
  */
21
19
  export declare class McpAgentCli {
22
20
  private program;
23
- private context;
24
- constructor(contextOverrides?: Partial<CliContext>);
25
- private setupCommands;
26
- private setupOnboardingCommands;
27
- private setupOrchestrationCommands;
21
+ constructor();
22
+ private setupOnboardCommands;
28
23
  private setupHooksCommands;
29
- private setupMemoryCommands;
30
- private setupStatusCommands;
31
- private setupReportingCommands;
32
- private setupDevCommands;
33
24
  run(args?: string[]): Promise<void>;
34
25
  }
35
26
  export default McpAgentCli;
package/dist/cli.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAWtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EACN,wBAAwB,EAExB,MAAM,wCAAwC,CAAC;AAChD,OAAO,gBAA0C,MAAM,wBAAwB,CAAC;AAChF,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAOxE,UAAU,UAAU;IACnB,eAAe,EAAE,mBAAmB,CAAC;IACrC,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,mBAAmB,EAAE,wBAAwB,CAAC;IAC9C,iBAAiB,EAAE,oBAAoB,CAAC;IACxC,YAAY,EAAE,YAAY,CAAC;IAC3B,OAAO,EAAE,OAAO,CAAC;CACjB;AAWD;;GAEG;AACH,qBAAa,WAAW;IACvB,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,OAAO,CAAa;gBAEhB,gBAAgB,GAAE,OAAO,CAAC,UAAU,CAAM;IActD,OAAO,CAAC,aAAa;IA+BrB,OAAO,CAAC,uBAAuB;IAgM/B,OAAO,CAAC,0BAA0B;IAyElC,OAAO,CAAC,kBAAkB;IAuM1B,OAAO,CAAC,mBAAmB;IAmJ3B,OAAO,CAAC,mBAAmB;IAgG3B,OAAO,CAAC,sBAAsB;IAK9B,OAAO,CAAC,gBAAgB;IA2ElB,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE;CAQzB;AAGD,eAAe,WAAW,CAAC"}
1
+ {"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAiFH,qBAAa,WAAW;IACvB,OAAO,CAAC,OAAO,CAAiB;;IAchC,OAAO,CAAC,oBAAoB;IA8C5B,OAAO,CAAC,kBAAkB;IA8HpB,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE;CAQzB;AAED,eAAe,WAAW,CAAC"}