@dragonflymcp/plugin 1.0.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 (666) hide show
  1. package/.claude-plugin/plugin.json +26 -0
  2. package/LICENSE +21 -0
  3. package/README.md +126 -0
  4. package/dist/core/annotations.d.ts +71 -0
  5. package/dist/core/annotations.d.ts.map +1 -0
  6. package/dist/core/annotations.js +61 -0
  7. package/dist/core/annotations.js.map +1 -0
  8. package/dist/core/config.d.ts +66 -0
  9. package/dist/core/config.d.ts.map +1 -0
  10. package/dist/core/config.js +131 -0
  11. package/dist/core/config.js.map +1 -0
  12. package/dist/core/dispatcher.d.ts +77 -0
  13. package/dist/core/dispatcher.d.ts.map +1 -0
  14. package/dist/core/dispatcher.js +132 -0
  15. package/dist/core/dispatcher.js.map +1 -0
  16. package/dist/core/server.d.ts +24 -0
  17. package/dist/core/server.d.ts.map +1 -0
  18. package/dist/core/server.js +41 -0
  19. package/dist/core/server.js.map +1 -0
  20. package/dist/core/store.d.ts +91 -0
  21. package/dist/core/store.d.ts.map +1 -0
  22. package/dist/core/store.js +157 -0
  23. package/dist/core/store.js.map +1 -0
  24. package/dist/core/types.d.ts +128 -0
  25. package/dist/core/types.d.ts.map +1 -0
  26. package/dist/core/types.js +5 -0
  27. package/dist/core/types.js.map +1 -0
  28. package/dist/index.d.ts +22 -0
  29. package/dist/index.d.ts.map +1 -0
  30. package/dist/index.js +81 -0
  31. package/dist/index.js.map +1 -0
  32. package/dist/test-utils/store-harness.d.ts +41 -0
  33. package/dist/test-utils/store-harness.d.ts.map +1 -0
  34. package/dist/test-utils/store-harness.js +61 -0
  35. package/dist/test-utils/store-harness.js.map +1 -0
  36. package/dist/tools/analytics/aggregators.d.ts +18 -0
  37. package/dist/tools/analytics/aggregators.d.ts.map +1 -0
  38. package/dist/tools/analytics/aggregators.js +260 -0
  39. package/dist/tools/analytics/aggregators.js.map +1 -0
  40. package/dist/tools/analytics/aggregators.test.d.ts +2 -0
  41. package/dist/tools/analytics/aggregators.test.d.ts.map +1 -0
  42. package/dist/tools/analytics/aggregators.test.js +177 -0
  43. package/dist/tools/analytics/aggregators.test.js.map +1 -0
  44. package/dist/tools/analytics/drift.d.ts +15 -0
  45. package/dist/tools/analytics/drift.d.ts.map +1 -0
  46. package/dist/tools/analytics/drift.js +135 -0
  47. package/dist/tools/analytics/drift.js.map +1 -0
  48. package/dist/tools/analytics/drift.test.d.ts +2 -0
  49. package/dist/tools/analytics/drift.test.d.ts.map +1 -0
  50. package/dist/tools/analytics/drift.test.js +99 -0
  51. package/dist/tools/analytics/drift.test.js.map +1 -0
  52. package/dist/tools/analytics/index.d.ts +10 -0
  53. package/dist/tools/analytics/index.d.ts.map +1 -0
  54. package/dist/tools/analytics/index.js +192 -0
  55. package/dist/tools/analytics/index.js.map +1 -0
  56. package/dist/tools/analytics/learner.d.ts +29 -0
  57. package/dist/tools/analytics/learner.d.ts.map +1 -0
  58. package/dist/tools/analytics/learner.js +135 -0
  59. package/dist/tools/analytics/learner.js.map +1 -0
  60. package/dist/tools/analytics/learner.test.d.ts +2 -0
  61. package/dist/tools/analytics/learner.test.d.ts.map +1 -0
  62. package/dist/tools/analytics/learner.test.js +118 -0
  63. package/dist/tools/analytics/learner.test.js.map +1 -0
  64. package/dist/tools/analytics/observe.d.ts +22 -0
  65. package/dist/tools/analytics/observe.d.ts.map +1 -0
  66. package/dist/tools/analytics/observe.js +143 -0
  67. package/dist/tools/analytics/observe.js.map +1 -0
  68. package/dist/tools/analytics/observe.test.d.ts +2 -0
  69. package/dist/tools/analytics/observe.test.d.ts.map +1 -0
  70. package/dist/tools/analytics/observe.test.js +95 -0
  71. package/dist/tools/analytics/observe.test.js.map +1 -0
  72. package/dist/tools/analytics/store.d.ts +29 -0
  73. package/dist/tools/analytics/store.d.ts.map +1 -0
  74. package/dist/tools/analytics/store.js +192 -0
  75. package/dist/tools/analytics/store.js.map +1 -0
  76. package/dist/tools/analytics/types.d.ts +290 -0
  77. package/dist/tools/analytics/types.d.ts.map +1 -0
  78. package/dist/tools/analytics/types.js +7 -0
  79. package/dist/tools/analytics/types.js.map +1 -0
  80. package/dist/tools/ast/index.d.ts +8 -0
  81. package/dist/tools/ast/index.d.ts.map +1 -0
  82. package/dist/tools/ast/index.js +242 -0
  83. package/dist/tools/ast/index.js.map +1 -0
  84. package/dist/tools/ast/indexer.d.ts +41 -0
  85. package/dist/tools/ast/indexer.d.ts.map +1 -0
  86. package/dist/tools/ast/indexer.js +617 -0
  87. package/dist/tools/ast/indexer.js.map +1 -0
  88. package/dist/tools/ast/store.d.ts +87 -0
  89. package/dist/tools/ast/store.d.ts.map +1 -0
  90. package/dist/tools/ast/store.js +280 -0
  91. package/dist/tools/ast/store.js.map +1 -0
  92. package/dist/tools/ast/store.test.d.ts +6 -0
  93. package/dist/tools/ast/store.test.d.ts.map +1 -0
  94. package/dist/tools/ast/store.test.js +257 -0
  95. package/dist/tools/ast/store.test.js.map +1 -0
  96. package/dist/tools/bridge/bridge.d.ts +37 -0
  97. package/dist/tools/bridge/bridge.d.ts.map +1 -0
  98. package/dist/tools/bridge/bridge.js +82 -0
  99. package/dist/tools/bridge/bridge.js.map +1 -0
  100. package/dist/tools/bridge/bridge.test.d.ts +2 -0
  101. package/dist/tools/bridge/bridge.test.d.ts.map +1 -0
  102. package/dist/tools/bridge/bridge.test.js +119 -0
  103. package/dist/tools/bridge/bridge.test.js.map +1 -0
  104. package/dist/tools/bridge/index.d.ts +8 -0
  105. package/dist/tools/bridge/index.d.ts.map +1 -0
  106. package/dist/tools/bridge/index.js +153 -0
  107. package/dist/tools/bridge/index.js.map +1 -0
  108. package/dist/tools/bridge/store.d.ts +45 -0
  109. package/dist/tools/bridge/store.d.ts.map +1 -0
  110. package/dist/tools/bridge/store.js +307 -0
  111. package/dist/tools/bridge/store.js.map +1 -0
  112. package/dist/tools/bridge/store.test.d.ts +2 -0
  113. package/dist/tools/bridge/store.test.d.ts.map +1 -0
  114. package/dist/tools/bridge/store.test.js +180 -0
  115. package/dist/tools/bridge/store.test.js.map +1 -0
  116. package/dist/tools/bridge/types.d.ts +44 -0
  117. package/dist/tools/bridge/types.d.ts.map +1 -0
  118. package/dist/tools/bridge/types.js +6 -0
  119. package/dist/tools/bridge/types.js.map +1 -0
  120. package/dist/tools/evolve/algorithm.d.ts +33 -0
  121. package/dist/tools/evolve/algorithm.d.ts.map +1 -0
  122. package/dist/tools/evolve/algorithm.js +64 -0
  123. package/dist/tools/evolve/algorithm.js.map +1 -0
  124. package/dist/tools/evolve/algorithm.test.d.ts +6 -0
  125. package/dist/tools/evolve/algorithm.test.d.ts.map +1 -0
  126. package/dist/tools/evolve/algorithm.test.js +138 -0
  127. package/dist/tools/evolve/algorithm.test.js.map +1 -0
  128. package/dist/tools/evolve/index.d.ts +11 -0
  129. package/dist/tools/evolve/index.d.ts.map +1 -0
  130. package/dist/tools/evolve/index.js +300 -0
  131. package/dist/tools/evolve/index.js.map +1 -0
  132. package/dist/tools/evolve/store.d.ts +27 -0
  133. package/dist/tools/evolve/store.d.ts.map +1 -0
  134. package/dist/tools/evolve/store.js +147 -0
  135. package/dist/tools/evolve/store.js.map +1 -0
  136. package/dist/tools/evolve/store.test.d.ts +6 -0
  137. package/dist/tools/evolve/store.test.d.ts.map +1 -0
  138. package/dist/tools/evolve/store.test.js +162 -0
  139. package/dist/tools/evolve/store.test.js.map +1 -0
  140. package/dist/tools/evolve/types.d.ts +38 -0
  141. package/dist/tools/evolve/types.d.ts.map +1 -0
  142. package/dist/tools/evolve/types.js +6 -0
  143. package/dist/tools/evolve/types.js.map +1 -0
  144. package/dist/tools/framework/content-loader.d.ts +45 -0
  145. package/dist/tools/framework/content-loader.d.ts.map +1 -0
  146. package/dist/tools/framework/content-loader.js +258 -0
  147. package/dist/tools/framework/content-loader.js.map +1 -0
  148. package/dist/tools/framework/content-loader.test.d.ts +5 -0
  149. package/dist/tools/framework/content-loader.test.d.ts.map +1 -0
  150. package/dist/tools/framework/content-loader.test.js +262 -0
  151. package/dist/tools/framework/content-loader.test.js.map +1 -0
  152. package/dist/tools/framework/index.d.ts +30 -0
  153. package/dist/tools/framework/index.d.ts.map +1 -0
  154. package/dist/tools/framework/index.js +517 -0
  155. package/dist/tools/framework/index.js.map +1 -0
  156. package/dist/tools/framework/session.d.ts +85 -0
  157. package/dist/tools/framework/session.d.ts.map +1 -0
  158. package/dist/tools/framework/session.js +311 -0
  159. package/dist/tools/framework/session.js.map +1 -0
  160. package/dist/tools/framework/session.test.d.ts +5 -0
  161. package/dist/tools/framework/session.test.d.ts.map +1 -0
  162. package/dist/tools/framework/session.test.js +291 -0
  163. package/dist/tools/framework/session.test.js.map +1 -0
  164. package/dist/tools/framework/sync-evaluator.d.ts +41 -0
  165. package/dist/tools/framework/sync-evaluator.d.ts.map +1 -0
  166. package/dist/tools/framework/sync-evaluator.js +298 -0
  167. package/dist/tools/framework/sync-evaluator.js.map +1 -0
  168. package/dist/tools/framework/sync-evaluator.test.d.ts +5 -0
  169. package/dist/tools/framework/sync-evaluator.test.d.ts.map +1 -0
  170. package/dist/tools/framework/sync-evaluator.test.js +288 -0
  171. package/dist/tools/framework/sync-evaluator.test.js.map +1 -0
  172. package/dist/tools/framework/types.d.ts +279 -0
  173. package/dist/tools/framework/types.d.ts.map +1 -0
  174. package/dist/tools/framework/types.js +6 -0
  175. package/dist/tools/framework/types.js.map +1 -0
  176. package/dist/tools/framework/workflow-intelligence.d.ts +55 -0
  177. package/dist/tools/framework/workflow-intelligence.d.ts.map +1 -0
  178. package/dist/tools/framework/workflow-intelligence.js +199 -0
  179. package/dist/tools/framework/workflow-intelligence.js.map +1 -0
  180. package/dist/tools/framework/workflow-intelligence.test.d.ts +6 -0
  181. package/dist/tools/framework/workflow-intelligence.test.d.ts.map +1 -0
  182. package/dist/tools/framework/workflow-intelligence.test.js +257 -0
  183. package/dist/tools/framework/workflow-intelligence.test.js.map +1 -0
  184. package/dist/tools/framework/workflow-planner.d.ts +10 -0
  185. package/dist/tools/framework/workflow-planner.d.ts.map +1 -0
  186. package/dist/tools/framework/workflow-planner.js +214 -0
  187. package/dist/tools/framework/workflow-planner.js.map +1 -0
  188. package/dist/tools/framework/workflow-planner.test.d.ts +5 -0
  189. package/dist/tools/framework/workflow-planner.test.d.ts.map +1 -0
  190. package/dist/tools/framework/workflow-planner.test.js +137 -0
  191. package/dist/tools/framework/workflow-planner.test.js.map +1 -0
  192. package/dist/tools/knowledge/bridge.d.ts +34 -0
  193. package/dist/tools/knowledge/bridge.d.ts.map +1 -0
  194. package/dist/tools/knowledge/bridge.js +249 -0
  195. package/dist/tools/knowledge/bridge.js.map +1 -0
  196. package/dist/tools/knowledge/bridge.test.d.ts +5 -0
  197. package/dist/tools/knowledge/bridge.test.d.ts.map +1 -0
  198. package/dist/tools/knowledge/bridge.test.js +221 -0
  199. package/dist/tools/knowledge/bridge.test.js.map +1 -0
  200. package/dist/tools/knowledge/extractor.d.ts +22 -0
  201. package/dist/tools/knowledge/extractor.d.ts.map +1 -0
  202. package/dist/tools/knowledge/extractor.js +154 -0
  203. package/dist/tools/knowledge/extractor.js.map +1 -0
  204. package/dist/tools/knowledge/index.d.ts +12 -0
  205. package/dist/tools/knowledge/index.d.ts.map +1 -0
  206. package/dist/tools/knowledge/index.js +505 -0
  207. package/dist/tools/knowledge/index.js.map +1 -0
  208. package/dist/tools/knowledge/retrieval.d.ts +28 -0
  209. package/dist/tools/knowledge/retrieval.d.ts.map +1 -0
  210. package/dist/tools/knowledge/retrieval.js +164 -0
  211. package/dist/tools/knowledge/retrieval.js.map +1 -0
  212. package/dist/tools/knowledge/store.d.ts +96 -0
  213. package/dist/tools/knowledge/store.d.ts.map +1 -0
  214. package/dist/tools/knowledge/store.js +562 -0
  215. package/dist/tools/knowledge/store.js.map +1 -0
  216. package/dist/tools/knowledge/store.test.d.ts +6 -0
  217. package/dist/tools/knowledge/store.test.d.ts.map +1 -0
  218. package/dist/tools/knowledge/store.test.js +385 -0
  219. package/dist/tools/knowledge/store.test.js.map +1 -0
  220. package/dist/tools/knowledge/types.d.ts +168 -0
  221. package/dist/tools/knowledge/types.d.ts.map +1 -0
  222. package/dist/tools/knowledge/types.js +6 -0
  223. package/dist/tools/knowledge/types.js.map +1 -0
  224. package/dist/tools/memory/evolution.d.ts +31 -0
  225. package/dist/tools/memory/evolution.d.ts.map +1 -0
  226. package/dist/tools/memory/evolution.js +130 -0
  227. package/dist/tools/memory/evolution.js.map +1 -0
  228. package/dist/tools/memory/index.d.ts +11 -0
  229. package/dist/tools/memory/index.d.ts.map +1 -0
  230. package/dist/tools/memory/index.js +239 -0
  231. package/dist/tools/memory/index.js.map +1 -0
  232. package/dist/tools/memory/store.d.ts +75 -0
  233. package/dist/tools/memory/store.d.ts.map +1 -0
  234. package/dist/tools/memory/store.js +398 -0
  235. package/dist/tools/memory/store.js.map +1 -0
  236. package/dist/tools/memory/store.test.d.ts +6 -0
  237. package/dist/tools/memory/store.test.d.ts.map +1 -0
  238. package/dist/tools/memory/store.test.js +429 -0
  239. package/dist/tools/memory/store.test.js.map +1 -0
  240. package/dist/tools/memory/types.d.ts +171 -0
  241. package/dist/tools/memory/types.d.ts.map +1 -0
  242. package/dist/tools/memory/types.js +6 -0
  243. package/dist/tools/memory/types.js.map +1 -0
  244. package/dist/tools/pipeline/composer.d.ts +29 -0
  245. package/dist/tools/pipeline/composer.d.ts.map +1 -0
  246. package/dist/tools/pipeline/composer.js +225 -0
  247. package/dist/tools/pipeline/composer.js.map +1 -0
  248. package/dist/tools/pipeline/composer.test.d.ts +2 -0
  249. package/dist/tools/pipeline/composer.test.d.ts.map +1 -0
  250. package/dist/tools/pipeline/composer.test.js +162 -0
  251. package/dist/tools/pipeline/composer.test.js.map +1 -0
  252. package/dist/tools/pipeline/index.d.ts +8 -0
  253. package/dist/tools/pipeline/index.d.ts.map +1 -0
  254. package/dist/tools/pipeline/index.js +102 -0
  255. package/dist/tools/pipeline/index.js.map +1 -0
  256. package/dist/tools/pipeline/planner.d.ts +10 -0
  257. package/dist/tools/pipeline/planner.d.ts.map +1 -0
  258. package/dist/tools/pipeline/planner.js +147 -0
  259. package/dist/tools/pipeline/planner.js.map +1 -0
  260. package/dist/tools/pipeline/planner.test.d.ts +2 -0
  261. package/dist/tools/pipeline/planner.test.d.ts.map +1 -0
  262. package/dist/tools/pipeline/planner.test.js +96 -0
  263. package/dist/tools/pipeline/planner.test.js.map +1 -0
  264. package/dist/tools/pipeline/preconditions.d.ts +14 -0
  265. package/dist/tools/pipeline/preconditions.d.ts.map +1 -0
  266. package/dist/tools/pipeline/preconditions.js +65 -0
  267. package/dist/tools/pipeline/preconditions.js.map +1 -0
  268. package/dist/tools/pipeline/preconditions.test.d.ts +2 -0
  269. package/dist/tools/pipeline/preconditions.test.d.ts.map +1 -0
  270. package/dist/tools/pipeline/preconditions.test.js +74 -0
  271. package/dist/tools/pipeline/preconditions.test.js.map +1 -0
  272. package/dist/tools/pipeline/types.d.ts +105 -0
  273. package/dist/tools/pipeline/types.d.ts.map +1 -0
  274. package/dist/tools/pipeline/types.js +6 -0
  275. package/dist/tools/pipeline/types.js.map +1 -0
  276. package/dist/tools/repair/index.d.ts +8 -0
  277. package/dist/tools/repair/index.d.ts.map +1 -0
  278. package/dist/tools/repair/index.js +384 -0
  279. package/dist/tools/repair/index.js.map +1 -0
  280. package/dist/tools/repair/repairer.d.ts +67 -0
  281. package/dist/tools/repair/repairer.d.ts.map +1 -0
  282. package/dist/tools/repair/repairer.js +257 -0
  283. package/dist/tools/repair/repairer.js.map +1 -0
  284. package/dist/tools/repair/repairer.test.d.ts +6 -0
  285. package/dist/tools/repair/repairer.test.d.ts.map +1 -0
  286. package/dist/tools/repair/repairer.test.js +159 -0
  287. package/dist/tools/repair/repairer.test.js.map +1 -0
  288. package/dist/tools/semantic/chunker.d.ts +23 -0
  289. package/dist/tools/semantic/chunker.d.ts.map +1 -0
  290. package/dist/tools/semantic/chunker.js +244 -0
  291. package/dist/tools/semantic/chunker.js.map +1 -0
  292. package/dist/tools/semantic/embedder.d.ts +16 -0
  293. package/dist/tools/semantic/embedder.d.ts.map +1 -0
  294. package/dist/tools/semantic/embedder.js +88 -0
  295. package/dist/tools/semantic/embedder.js.map +1 -0
  296. package/dist/tools/semantic/index.d.ts +8 -0
  297. package/dist/tools/semantic/index.d.ts.map +1 -0
  298. package/dist/tools/semantic/index.js +144 -0
  299. package/dist/tools/semantic/index.js.map +1 -0
  300. package/dist/tools/semantic/store.d.ts +31 -0
  301. package/dist/tools/semantic/store.d.ts.map +1 -0
  302. package/dist/tools/semantic/store.js +168 -0
  303. package/dist/tools/semantic/store.js.map +1 -0
  304. package/dist/tools/semantic/store.test.d.ts +6 -0
  305. package/dist/tools/semantic/store.test.d.ts.map +1 -0
  306. package/dist/tools/semantic/store.test.js +240 -0
  307. package/dist/tools/semantic/store.test.js.map +1 -0
  308. package/dist/tools/spec/generator.d.ts +32 -0
  309. package/dist/tools/spec/generator.d.ts.map +1 -0
  310. package/dist/tools/spec/generator.js +278 -0
  311. package/dist/tools/spec/generator.js.map +1 -0
  312. package/dist/tools/spec/generator.test.d.ts +6 -0
  313. package/dist/tools/spec/generator.test.d.ts.map +1 -0
  314. package/dist/tools/spec/generator.test.js +208 -0
  315. package/dist/tools/spec/generator.test.js.map +1 -0
  316. package/dist/tools/spec/index.d.ts +11 -0
  317. package/dist/tools/spec/index.d.ts.map +1 -0
  318. package/dist/tools/spec/index.js +426 -0
  319. package/dist/tools/spec/index.js.map +1 -0
  320. package/dist/tools/spec/store.d.ts +24 -0
  321. package/dist/tools/spec/store.d.ts.map +1 -0
  322. package/dist/tools/spec/store.js +104 -0
  323. package/dist/tools/spec/store.js.map +1 -0
  324. package/dist/tools/spec/store.test.d.ts +6 -0
  325. package/dist/tools/spec/store.test.d.ts.map +1 -0
  326. package/dist/tools/spec/store.test.js +173 -0
  327. package/dist/tools/spec/store.test.js.map +1 -0
  328. package/dist/tools/spec/types.d.ts +61 -0
  329. package/dist/tools/spec/types.d.ts.map +1 -0
  330. package/dist/tools/spec/types.js +6 -0
  331. package/dist/tools/spec/types.js.map +1 -0
  332. package/dist/tools/state/index.d.ts +11 -0
  333. package/dist/tools/state/index.d.ts.map +1 -0
  334. package/dist/tools/state/index.js +386 -0
  335. package/dist/tools/state/index.js.map +1 -0
  336. package/dist/tools/state/migrate.d.ts +39 -0
  337. package/dist/tools/state/migrate.d.ts.map +1 -0
  338. package/dist/tools/state/migrate.js +242 -0
  339. package/dist/tools/state/migrate.js.map +1 -0
  340. package/dist/tools/state/migrate.test.d.ts +2 -0
  341. package/dist/tools/state/migrate.test.d.ts.map +1 -0
  342. package/dist/tools/state/migrate.test.js +265 -0
  343. package/dist/tools/state/migrate.test.js.map +1 -0
  344. package/dist/tools/state/store.d.ts +107 -0
  345. package/dist/tools/state/store.d.ts.map +1 -0
  346. package/dist/tools/state/store.js +365 -0
  347. package/dist/tools/state/store.js.map +1 -0
  348. package/dist/tools/state/store.test.d.ts +5 -0
  349. package/dist/tools/state/store.test.d.ts.map +1 -0
  350. package/dist/tools/state/store.test.js +293 -0
  351. package/dist/tools/state/store.test.js.map +1 -0
  352. package/dist/tools/state/types.d.ts +90 -0
  353. package/dist/tools/state/types.d.ts.map +1 -0
  354. package/dist/tools/state/types.js +6 -0
  355. package/dist/tools/state/types.js.map +1 -0
  356. package/dist/tools/testing/analyzer.d.ts +44 -0
  357. package/dist/tools/testing/analyzer.d.ts.map +1 -0
  358. package/dist/tools/testing/analyzer.js +280 -0
  359. package/dist/tools/testing/analyzer.js.map +1 -0
  360. package/dist/tools/testing/generator.d.ts +57 -0
  361. package/dist/tools/testing/generator.d.ts.map +1 -0
  362. package/dist/tools/testing/generator.js +478 -0
  363. package/dist/tools/testing/generator.js.map +1 -0
  364. package/dist/tools/testing/generator.test.d.ts +6 -0
  365. package/dist/tools/testing/generator.test.d.ts.map +1 -0
  366. package/dist/tools/testing/generator.test.js +285 -0
  367. package/dist/tools/testing/generator.test.js.map +1 -0
  368. package/dist/tools/testing/index.d.ts +8 -0
  369. package/dist/tools/testing/index.d.ts.map +1 -0
  370. package/dist/tools/testing/index.js +373 -0
  371. package/dist/tools/testing/index.js.map +1 -0
  372. package/dist/utils/embedder.d.ts +7 -0
  373. package/dist/utils/embedder.d.ts.map +1 -0
  374. package/dist/utils/embedder.js +13 -0
  375. package/dist/utils/embedder.js.map +1 -0
  376. package/dist/utils/execution.d.ts +68 -0
  377. package/dist/utils/execution.d.ts.map +1 -0
  378. package/dist/utils/execution.js +467 -0
  379. package/dist/utils/execution.js.map +1 -0
  380. package/dist/utils/graph.d.ts +26 -0
  381. package/dist/utils/graph.d.ts.map +1 -0
  382. package/dist/utils/graph.js +32 -0
  383. package/dist/utils/graph.js.map +1 -0
  384. package/dist/utils/guards.d.ts +32 -0
  385. package/dist/utils/guards.d.ts.map +1 -0
  386. package/dist/utils/guards.js +40 -0
  387. package/dist/utils/guards.js.map +1 -0
  388. package/dist/utils/ids.d.ts +5 -0
  389. package/dist/utils/ids.d.ts.map +1 -0
  390. package/dist/utils/ids.js +7 -0
  391. package/dist/utils/ids.js.map +1 -0
  392. package/dist/utils/languages.d.ts +34 -0
  393. package/dist/utils/languages.d.ts.map +1 -0
  394. package/dist/utils/languages.js +153 -0
  395. package/dist/utils/languages.js.map +1 -0
  396. package/dist/utils/lazy.d.ts +17 -0
  397. package/dist/utils/lazy.d.ts.map +1 -0
  398. package/dist/utils/lazy.js +35 -0
  399. package/dist/utils/lazy.js.map +1 -0
  400. package/dist/utils/project.d.ts +41 -0
  401. package/dist/utils/project.d.ts.map +1 -0
  402. package/dist/utils/project.js +82 -0
  403. package/dist/utils/project.js.map +1 -0
  404. package/dist/utils/responses.d.ts +27 -0
  405. package/dist/utils/responses.d.ts.map +1 -0
  406. package/dist/utils/responses.js +72 -0
  407. package/dist/utils/responses.js.map +1 -0
  408. package/dist/utils/vectors.d.ts +33 -0
  409. package/dist/utils/vectors.d.ts.map +1 -0
  410. package/dist/utils/vectors.js +80 -0
  411. package/dist/utils/vectors.js.map +1 -0
  412. package/dist/utils/vectors.test.d.ts +6 -0
  413. package/dist/utils/vectors.test.d.ts.map +1 -0
  414. package/dist/utils/vectors.test.js +96 -0
  415. package/dist/utils/vectors.test.js.map +1 -0
  416. package/package.json +69 -0
  417. package/scripts/init.js +142 -0
  418. package/templates/CLAUDE.md.template +96 -0
  419. package/templates/agents/architecture-concept.md +237 -0
  420. package/templates/agents/checkpoint-concept.md +218 -0
  421. package/templates/agents/code-analysis-concept.md +171 -0
  422. package/templates/agents/compete-control.md +44 -0
  423. package/templates/agents/compete-evaluator.md +87 -0
  424. package/templates/agents/compete-treatment.md +55 -0
  425. package/templates/agents/context-concept.md +254 -0
  426. package/templates/agents/debate-advocate.md +127 -0
  427. package/templates/agents/debate-critic.md +119 -0
  428. package/templates/agents/debate-synthesis.md +160 -0
  429. package/templates/agents/documentation-concept.md +294 -0
  430. package/templates/agents/implementation-concept.md +165 -0
  431. package/templates/agents/quality-concept.md +299 -0
  432. package/templates/agents/research-concept.md +169 -0
  433. package/templates/agents/security-concept.md +255 -0
  434. package/templates/agents/story-concept.md +207 -0
  435. package/templates/agents/verification-concept.md +456 -0
  436. package/templates/agents/version-concept.md +163 -0
  437. package/templates/anchors/directory.anchor.yaml.template +53 -0
  438. package/templates/anchors/rules.anchor.yaml.template +70 -0
  439. package/templates/anchors/safety.anchor.yaml.template +96 -0
  440. package/templates/claude-md-managed.template +105 -0
  441. package/templates/commands/cache.md.template +439 -0
  442. package/templates/commands/checkpoint.md.template +121 -0
  443. package/templates/commands/classify.md.template +138 -0
  444. package/templates/commands/compete.md.template +90 -0
  445. package/templates/commands/costs.md.template +111 -0
  446. package/templates/commands/estimate.md.template +196 -0
  447. package/templates/commands/explore.md.template +186 -0
  448. package/templates/commands/feature.md.template +216 -0
  449. package/templates/commands/forget.md.template +104 -0
  450. package/templates/commands/global-recall.md.template +250 -0
  451. package/templates/commands/global-remember.md.template +187 -0
  452. package/templates/commands/health.md.template +107 -0
  453. package/templates/commands/help.md.template +253 -0
  454. package/templates/commands/observe.md.template +211 -0
  455. package/templates/commands/pr-review.md.template +164 -0
  456. package/templates/commands/predict-cost.md.template +251 -0
  457. package/templates/commands/profile.md.template +142 -0
  458. package/templates/commands/reasoning.md.template +228 -0
  459. package/templates/commands/recall.md.template +197 -0
  460. package/templates/commands/remember.md.template +148 -0
  461. package/templates/commands/replay.md.template +449 -0
  462. package/templates/commands/restore.md.template +87 -0
  463. package/templates/commands/retrospective.md.template +47 -0
  464. package/templates/commands/slo.md.template +286 -0
  465. package/templates/commands/spec.md.template +164 -0
  466. package/templates/commands/status.md.template +53 -0
  467. package/templates/commands/sync.md.template +321 -0
  468. package/templates/commands/task.md.template +86 -0
  469. package/templates/commands/trace.md.template +86 -0
  470. package/templates/commands/visualize.md.template +216 -0
  471. package/templates/commands/workflow.md.template +375 -0
  472. package/templates/concepts/README.md +329 -0
  473. package/templates/concepts/architecture.md.template +74 -0
  474. package/templates/concepts/code-analysis.md.template +186 -0
  475. package/templates/concepts/context-compactor.md.template +393 -0
  476. package/templates/concepts/context.md.template +62 -0
  477. package/templates/concepts/documentation.md.template +452 -0
  478. package/templates/concepts/estimator.md.template +214 -0
  479. package/templates/concepts/exploration.md.template +257 -0
  480. package/templates/concepts/global-memory.md.template +222 -0
  481. package/templates/concepts/implementation.md.template +62 -0
  482. package/templates/concepts/pr-review.md.template +277 -0
  483. package/templates/concepts/project-profile.md.template +358 -0
  484. package/templates/concepts/quality.md.template +63 -0
  485. package/templates/concepts/react-fallback.md.template +286 -0
  486. package/templates/concepts/research.md.template +221 -0
  487. package/templates/concepts/retrospective.md.template +93 -0
  488. package/templates/concepts/security.md.template +442 -0
  489. package/templates/concepts/slo.md.template +274 -0
  490. package/templates/concepts/spec.md.template +71 -0
  491. package/templates/concepts/story.md.template +50 -0
  492. package/templates/concepts/tool-router.md.template +289 -0
  493. package/templates/concepts/verification-synthesizer.md.template +279 -0
  494. package/templates/concepts/version.md.template +61 -0
  495. package/templates/config.yaml.template +347 -0
  496. package/templates/examples/README.md +77 -0
  497. package/templates/examples/architecture/api-design.yaml.template +286 -0
  498. package/templates/examples/architecture/oauth-authentication.yaml.template +305 -0
  499. package/templates/health/status.yaml.template +120 -0
  500. package/templates/hooks/concept-complete.sh.template +45 -0
  501. package/templates/hooks/lib/common.sh.template +160 -0
  502. package/templates/hooks/post-commit.sh.template +37 -0
  503. package/templates/hooks/post-concept-action.template +39 -0
  504. package/templates/hooks/post-tool-structure-check.sh.template +138 -0
  505. package/templates/hooks/post-tool-use.sh.template +51 -0
  506. package/templates/hooks/pre-compact.sh.template +48 -0
  507. package/templates/hooks/pre-tool-grounding.template +148 -0
  508. package/templates/hooks/session-exit-checkpoint.sh.template +35 -0
  509. package/templates/hooks/session-start.sh.template +67 -0
  510. package/templates/hooks/statusline.sh.template +148 -0
  511. package/templates/hooks/stop.sh.template +45 -0
  512. package/templates/hooks/subagent-stop.sh.template +40 -0
  513. package/templates/hooks/sync-blocked.sh.template +45 -0
  514. package/templates/hooks/timeout.sh.template +48 -0
  515. package/templates/hooks/user-prompt-submit.sh.template +68 -0
  516. package/templates/koan/README.md +58 -0
  517. package/templates/memory/index.yaml.template +48 -0
  518. package/templates/memory/procedural/debugging.yaml.template +24 -0
  519. package/templates/memory/procedural/workflows.yaml.template +22 -0
  520. package/templates/memory/semantic/architecture.yaml.template +21 -0
  521. package/templates/memory/semantic/conventions.yaml.template +18 -0
  522. package/templates/memory/semantic/patterns.yaml.template +21 -0
  523. package/templates/memory/semantic/preferences.yaml.template +18 -0
  524. package/templates/prompts/architecture.yaml.template +349 -0
  525. package/templates/prompts/context.yaml.template +384 -0
  526. package/templates/prompts/implementation.yaml.template +365 -0
  527. package/templates/prompts/planning.yaml.template +303 -0
  528. package/templates/prompts/quality.yaml.template +345 -0
  529. package/templates/prompts/retrospective.yaml.template +231 -0
  530. package/templates/prompts/slo.yaml.template +360 -0
  531. package/templates/prompts/story.yaml.template +236 -0
  532. package/templates/prompts/tree-of-thoughts.yaml.template +299 -0
  533. package/templates/prompts/verification.yaml.template +286 -0
  534. package/templates/prompts/version.yaml.template +279 -0
  535. package/templates/schemas/agent-schema.json +98 -0
  536. package/templates/schemas/architecture.schema.json +69 -0
  537. package/templates/schemas/config-schema.json +165 -0
  538. package/templates/schemas/implementation.schema.json +75 -0
  539. package/templates/schemas/planning.schema.json +243 -0
  540. package/templates/schemas/provenance.schema.json +111 -0
  541. package/templates/schemas/retrospective.schema.json +174 -0
  542. package/templates/schemas/review.schema.json +284 -0
  543. package/templates/schemas/slo.schema.json +443 -0
  544. package/templates/schemas/story.schema.json +68 -0
  545. package/templates/schemas/sync-schema.json +196 -0
  546. package/templates/schemas/task.schema.json +127 -0
  547. package/templates/schemas/tree-of-thoughts.schema.json +175 -0
  548. package/templates/schemas/verification.schema.json +106 -0
  549. package/templates/settings.full.json.template +135 -0
  550. package/templates/settings.minimal.json.template +68 -0
  551. package/templates/settings.standard.json.template +135 -0
  552. package/templates/skills/acceptance-criteria-generation.md.template +330 -0
  553. package/templates/skills/accessibility-checking.md.template +341 -0
  554. package/templates/skills/api-design-patterns.md.template +395 -0
  555. package/templates/skills/batch-processing.md.template +605 -0
  556. package/templates/skills/branch-strategy.md.template +362 -0
  557. package/templates/skills/changelog-generation.md.template +403 -0
  558. package/templates/skills/code-coverage-analysis.md.template +362 -0
  559. package/templates/skills/code-style-enforcement.md.template +294 -0
  560. package/templates/skills/code-template-patterns.md.template +419 -0
  561. package/templates/skills/concept-development.md.template +159 -0
  562. package/templates/skills/context-prioritization.md.template +306 -0
  563. package/templates/skills/cost-optimization.md.template +482 -0
  564. package/templates/skills/cross-project-knowledge.md.template +316 -0
  565. package/templates/skills/dependency-impact-analysis.md.template +263 -0
  566. package/templates/skills/documentation-generation.md.template +409 -0
  567. package/templates/skills/effort-estimation.md.template +350 -0
  568. package/templates/skills/error-classification.md.template +709 -0
  569. package/templates/skills/error-messages.md.template +339 -0
  570. package/templates/skills/ide-diagnostics.md.template +480 -0
  571. package/templates/skills/incremental-loading.md.template +574 -0
  572. package/templates/skills/output-caching.md.template +524 -0
  573. package/templates/skills/performance-estimation.md.template +325 -0
  574. package/templates/skills/performance-testing-patterns.md.template +341 -0
  575. package/templates/skills/phase2-optimizations-summary.md.template +458 -0
  576. package/templates/skills/progressive-disclosure-pattern.md.template +190 -0
  577. package/templates/skills/project-structure.md.template +372 -0
  578. package/templates/skills/provenance-analysis.md.template +609 -0
  579. package/templates/skills/react-executor.md.template +366 -0
  580. package/templates/skills/refactoring-patterns.md.template +422 -0
  581. package/templates/skills/release-management.md.template +373 -0
  582. package/templates/skills/requirement-prioritization.md.template +357 -0
  583. package/templates/skills/schema-validation.md.template +321 -0
  584. package/templates/skills/security-design-patterns.md.template +692 -0
  585. package/templates/skills/security-vulnerability-scanning.md.template +663 -0
  586. package/templates/skills/semantic-memory.md.template +266 -0
  587. package/templates/skills/semantic-versioning.md.template +371 -0
  588. package/templates/skills/smart-retry.md.template +676 -0
  589. package/templates/skills/smart-summarization.md.template +358 -0
  590. package/templates/skills/story-decomposition.md.template +278 -0
  591. package/templates/skills/synchronization-patterns.md.template +303 -0
  592. package/templates/skills/test-generation-strategy.md.template +247 -0
  593. package/templates/skills/workflow-replay.md.template +478 -0
  594. package/templates/skills/wysiwid-principles.md.template +364 -0
  595. package/templates/skills-manifest.yaml.template +526 -0
  596. package/templates/stubs/agents/architecture-concept.md +20 -0
  597. package/templates/stubs/agents/checkpoint-concept.md +19 -0
  598. package/templates/stubs/agents/code-analysis-concept.md +36 -0
  599. package/templates/stubs/agents/context-concept.md +37 -0
  600. package/templates/stubs/agents/debate-advocate.md +12 -0
  601. package/templates/stubs/agents/debate-critic.md +12 -0
  602. package/templates/stubs/agents/debate-synthesis.md +12 -0
  603. package/templates/stubs/agents/documentation-concept.md +39 -0
  604. package/templates/stubs/agents/implementation-concept.md +41 -0
  605. package/templates/stubs/agents/quality-concept.md +41 -0
  606. package/templates/stubs/agents/research-concept.md +35 -0
  607. package/templates/stubs/agents/security-concept.md +40 -0
  608. package/templates/stubs/agents/spec-concept.md +35 -0
  609. package/templates/stubs/agents/story-concept.md +36 -0
  610. package/templates/stubs/agents/verification-concept.md +39 -0
  611. package/templates/stubs/agents/version-concept.md +37 -0
  612. package/templates/stubs/commands/cache.md.template +2 -0
  613. package/templates/stubs/commands/checkpoint.md.template +2 -0
  614. package/templates/stubs/commands/classify.md.template +2 -0
  615. package/templates/stubs/commands/compete.md.template +2 -0
  616. package/templates/stubs/commands/costs.md.template +2 -0
  617. package/templates/stubs/commands/estimate.md.template +2 -0
  618. package/templates/stubs/commands/explore.md.template +2 -0
  619. package/templates/stubs/commands/feature.md.template +2 -0
  620. package/templates/stubs/commands/forget.md.template +2 -0
  621. package/templates/stubs/commands/global-recall.md.template +2 -0
  622. package/templates/stubs/commands/global-remember.md.template +2 -0
  623. package/templates/stubs/commands/health.md.template +2 -0
  624. package/templates/stubs/commands/help.md.template +2 -0
  625. package/templates/stubs/commands/observe.md.template +2 -0
  626. package/templates/stubs/commands/pr-review.md.template +2 -0
  627. package/templates/stubs/commands/predict-cost.md.template +2 -0
  628. package/templates/stubs/commands/profile.md.template +2 -0
  629. package/templates/stubs/commands/reasoning.md.template +2 -0
  630. package/templates/stubs/commands/recall.md.template +2 -0
  631. package/templates/stubs/commands/remember.md.template +2 -0
  632. package/templates/stubs/commands/replay.md.template +2 -0
  633. package/templates/stubs/commands/restore.md.template +2 -0
  634. package/templates/stubs/commands/retrospective.md.template +2 -0
  635. package/templates/stubs/commands/slo.md.template +2 -0
  636. package/templates/stubs/commands/spec.md.template +2 -0
  637. package/templates/stubs/commands/sync.md.template +2 -0
  638. package/templates/stubs/commands/task.md.template +2 -0
  639. package/templates/stubs/commands/trace.md.template +2 -0
  640. package/templates/stubs/commands/visualize.md.template +2 -0
  641. package/templates/stubs/commands/workflow.md.template +2 -0
  642. package/templates/synchronizations/archive/adaptive-learning.yaml.template +595 -0
  643. package/templates/synchronizations/archive/code-understanding-flow.yaml.template +533 -0
  644. package/templates/synchronizations/archive/collaboration-flow.yaml.template +521 -0
  645. package/templates/synchronizations/archive/context-folding.yaml.template +353 -0
  646. package/templates/synchronizations/archive/dead-letter-queue.yaml.template +530 -0
  647. package/templates/synchronizations/archive/documentation-flow.yaml.template +560 -0
  648. package/templates/synchronizations/archive/error-recovery-flow.yaml.template +1031 -0
  649. package/templates/synchronizations/archive/execution-loop.yaml.template +336 -0
  650. package/templates/synchronizations/archive/exploration-flow.yaml.template +369 -0
  651. package/templates/synchronizations/archive/feature-development.yaml.template +2145 -0
  652. package/templates/synchronizations/archive/learning-loop.yaml.template +657 -0
  653. package/templates/synchronizations/archive/multi-verify.yaml.template +346 -0
  654. package/templates/synchronizations/archive/planning-flow.yaml.template +312 -0
  655. package/templates/synchronizations/archive/retrospective-flow.yaml.template +277 -0
  656. package/templates/synchronizations/archive/security-flow.yaml.template +477 -0
  657. package/templates/synchronizations/archive/slo-monitoring.yaml.template +209 -0
  658. package/templates/synchronizations/archive/task-routing.yaml.template +489 -0
  659. package/templates/synchronizations/archive/test-driven.yaml.template +291 -0
  660. package/templates/synchronizations/archive/tool-routing.yaml.template +326 -0
  661. package/templates/synchronizations/archive/verification-flow.yaml.template +407 -0
  662. package/templates/synchronizations/error-policy.yaml.template +188 -0
  663. package/templates/synchronizations/main.sync.template +319 -0
  664. package/templates/synchronizations/slo-registry.yaml.template +229 -0
  665. package/templates/tasks/task.yaml.template +67 -0
  666. package/templates/zen-profile.yaml.template +14 -0
package/templates/agents/version-concept.md ADDED
@@ -0,0 +1,163 @@
1
+ ---
2
+ name: version-concept
3
+ type: workflow
4
+ execution: task-tool
5
+ model: sonnet
6
+ color: orange
7
+ description: Version Concept - Manages git operations (branches, commits, tags) using Sonnet for intelligent version control
8
+ tools: "*"
9
+
10
+ # Enhanced Metadata (Phase 3)
11
+ cost_per_action: 0.003
12
+ optimization_level: "baseline"
13
+ expected_context_tokens: 500
14
+ expected_duration_seconds: 5
15
+
16
+ # Component-Scoped Hooks
17
+ hooks:
18
+ Stop:
19
+ - type: command
20
+ command: "bash .claude/hooks/concept-complete.sh version"
21
+
22
+ # Skills (Phase 7)
23
+ skills:
24
+ # P1 - Core
25
+ - changelog-generation # Conventional commit parsing, Keep a Changelog format
26
+ # P2 - Enhancement
27
+ - semantic-versioning # Version bump determination, breaking change detection
28
+ # P3 - Additional
29
+ - release-management # Release planning, deployment strategies, rollback
30
+ # Existing Skills
31
+ - provenance-analysis
32
+ ---
33
+
34
+ # 🏷️ Version Concept
35
+
36
+ ## Actions
37
+
38
+ ### branch(story_id)
39
+
40
+ Creates a feature branch for the story.
41
+
42
+ **Inputs**:
43
+ - `story_id`: Reference to the story being versioned
44
+
45
+ **Process**:
46
+ 1. Read story title
47
+ 2. Generate branch name (feature/story-id-slug)
48
+ 3. Create branch from main
49
+ 4. Return branch info to parent workflow
50
+
51
+ ### commit(impl_id, quality_review_id, quality_test_id)
52
+
53
+ Commits implementation with provenance.
54
+
55
+ **Inputs**:
56
+ - `impl_id`: Reference to implementation
57
+ - `quality_review_id`: Reference to quality review
58
+ - `quality_test_id`: Reference to quality tests
59
+
60
+ **Process**:
61
+ 1. Read implementation file list
62
+ 2. Stage all changed files
63
+ 3. Generate conventional commit message
64
+ 4. Include provenance (story, arch, impl, quality)
65
+ 5. Commit with signature
66
+ 6. Return commit info to parent workflow
67
+
68
+ **Output Format** (YAML with Progressive Disclosure):
69
+
70
+ ```yaml
71
+ # === SUMMARY (first 5 lines - quick scanning) ===
72
+ version_id: "version-001"
73
+ status: "committed"
74
+ branch_name: "feature/story-001-oauth-auth"
75
+ summary: "feat: add OAuth2 authentication with Google provider"
76
+
77
+ # === FULL DETAILS (load only if needed) ===
78
+ details:
79
+ story_id: "story-001"
80
+ impl_id: "impl-001"
81
+
82
+ branch:
83
+ name: "feature/story-001-oauth-auth"
84
+ created_from: "main"
85
+ commit_count: 1
86
+
87
+ commit:
88
+ sha: "a1b2c3d"
89
+ message: |
90
+ feat: add OAuth2 authentication with Google provider
91
+
92
+ Implements OAuth2 flow using passport.js with Google provider.
93
+ Users can now sign in with Google accounts.
94
+
95
+ Provenance:
96
+ - Story: story-001
97
+ - Architecture: arch-001
98
+ - Implementation: impl-001
99
+ - Review: review-001 (approved)
100
+ - Tests: test-001 (12/12 passing, 94% coverage)
101
+
102
+ 🤖 Generated with Claude Code + Zen WYSIWID Architecture
103
+ Co-Authored-By: Claude <noreply@anthropic.com>
104
+
105
+ files_committed:
106
+ - "src/controllers/auth.controller.ts"
107
+ - "src/services/user.service.ts"
108
+ - "src/config/passport.ts"
109
+ - "src/routes/index.ts"
110
+ - ".env.example"
111
+
112
+ metadata:
113
+ created_at: "2025-11-11T10:45:00Z"
114
+ concept: "version"
115
+ model: "sonnet"
116
+ cost: 0.003
117
+ ```
118
+
119
+ ## Conventional Commits
120
+
121
+ All commits follow conventional commit format:
122
+
123
+ ```
124
+ <type>(<scope>): <description>
125
+
126
+ <body>
127
+
128
+ Provenance:
129
+ - Story: story-id
130
+ - Architecture: arch-id
131
+ - Implementation: impl-id
132
+ - Review: review-id (status)
133
+ - Tests: test-id (results)
134
+
135
+ 🤖 Generated with Claude Code + Zen WYSIWID Architecture
136
+ Co-Authored-By: Claude <noreply@anthropic.com>
137
+ ```
138
+
139
+ **Types**: feat, fix, docs, style, refactor, test, chore
140
+
141
+ ## Never Do This
142
+
143
+ - ❌ Call other concepts directly
144
+ - ❌ Push to remote (manual step)
145
+ - ❌ Force push
146
+ - ❌ Commit without provenance
147
+ - ❌ Skip conventional format
148
+
149
+ ## Always Do This
150
+
151
+ - ✅ Use Sonnet model exclusively
152
+ - ✅ Create feature branches
153
+ - ✅ Use conventional commit format
154
+ - ✅ Include complete provenance
155
+ - ✅ Return structured results to parent workflow
156
+ - ✅ Track git operations in metadata
157
+
158
+ ---
159
+
160
+ **Model Assignment**: Sonnet
161
+ **Cost Tier**: Low ($0.003)
162
+ **Purpose**: Automated git operations
163
+ **Integration**: Triggered by quality, completes workflow
package/templates/anchors/directory.anchor.yaml.template ADDED
@@ -0,0 +1,53 @@
1
+ # Zen Directory Context Anchor
2
+ # Tracks current working context to prevent path confusion after compaction
3
+ #
4
+ # IMMUTABLE: Updated by hooks, read by Claude for grounding
5
+ # This file helps Claude verify it's operating in the expected location
6
+
7
+ anchor_id: "anchor-directory"
8
+ type: "directory"
9
+ immutable: true
10
+ created_at: "${TIMESTAMP}"
11
+ last_updated: "${TIMESTAMP}"
12
+
13
+ # Current working context
14
+ working_directory: "${PROJECT_ROOT}"
15
+ project_name: "${PROJECT_NAME}"
16
+
17
+ # Git context
18
+ git:
19
+ repository: "${PROJECT_ROOT}"
20
+ branch: "main"
21
+ status: "unknown"
22
+ last_commit: null
23
+
24
+ # Active session info
25
+ session:
26
+ started_at: "${TIMESTAMP}"
27
+ last_verified: "${TIMESTAMP}"
28
+
29
+ # Files being actively modified this session
30
+ active_files: []
31
+ # Example:
32
+ # - path: "src/auth.ts"
33
+ # action: "modifying"
34
+ # since: "2025-12-05T10:00:00Z"
35
+
36
+ # Recent commands executed (last 10)
37
+ recent_commands: []
38
+ # Example:
39
+ # - command: "npm test"
40
+ # timestamp: "2025-12-05T10:05:00Z"
41
+ # status: "success"
42
+
43
+ # Verification checklist - Claude should confirm these
44
+ verification:
45
+ directory_exists: true
46
+ git_repo: true
47
+ koan_initialized: true
48
+
49
+ # Recovery instructions
50
+ recovery:
51
+ if_directory_wrong: "Run 'pwd' to verify current directory, then update this file"
52
+ if_git_detached: "Run 'git status' to check branch state"
53
+ if_files_missing: "Check recent_commands for what might have changed"
package/templates/anchors/rules.anchor.yaml.template ADDED
@@ -0,0 +1,70 @@
1
+ # Zen Immutable Rules Anchor
2
+ # This file is re-injected into context to prevent primacy decay
3
+ #
4
+ # IMMUTABLE: Contents survive context compression
5
+ # Claude should read this file when uncertain about project rules
6
+
7
+ anchor_id: "anchor-rules"
8
+ type: "rules"
9
+ immutable: true
10
+ created_at: "${TIMESTAMP}"
11
+ last_updated: "${TIMESTAMP}"
12
+
13
+ # Core safety rules - NEVER violate these
14
+ safety_rules:
15
+ - id: "safety-001"
16
+ text: "Never run rm -rf without explicit user confirmation"
17
+ priority: critical
18
+
19
+ - id: "safety-002"
20
+ text: "Never run git reset --hard without explicit user confirmation"
21
+ priority: critical
22
+
23
+ - id: "safety-003"
24
+ text: "Verify current working directory before file operations"
25
+ priority: critical
26
+
27
+ - id: "safety-004"
28
+ text: "Never execute database DROP or TRUNCATE without explicit confirmation"
29
+ priority: critical
30
+
31
+ # Workflow rules - follow these for consistency
32
+ workflow_rules:
33
+ - id: "workflow-001"
34
+ text: "Create git commits only when explicitly requested by user"
35
+ priority: high
36
+
37
+ - id: "workflow-002"
38
+ text: "Run tests before committing code changes"
39
+ priority: high
40
+
41
+ - id: "workflow-003"
42
+ text: "Use the WYSIWID pattern - behavior should be visible in configuration"
43
+ priority: medium
44
+
45
+ # Project-specific rules - customize per project
46
+ #
47
+ # ADD YOUR CORE PRINCIPLES HERE. These rules:
48
+ # - Survive context compression (injected by pre-compact hook)
49
+ # - Are re-read at session start
50
+ # - Guide Claude's behavior throughout the project
51
+ #
52
+ # Use /remember to store general knowledge. Use this file for
53
+ # non-negotiable principles that must persist across all sessions.
54
+ #
55
+ project_rules: []
56
+ # Example:
57
+ # - id: "project-001"
58
+ # text: "All work MUST use /feature or /workflow commands"
59
+ # priority: critical
60
+ #
61
+ # - id: "project-002"
62
+ # text: "Refactor until DRY"
63
+ # priority: high
64
+
65
+ # When to re-read this file
66
+ triggers:
67
+ - "After context compression"
68
+ - "Before destructive operations"
69
+ - "When uncertain about project conventions"
70
+ - "At session start"
package/templates/anchors/safety.anchor.yaml.template ADDED
@@ -0,0 +1,96 @@
1
+ # Zen Safety Constraints Anchor
2
+ # Defines safety boundaries that must never be crossed
3
+ #
4
+ # IMMUTABLE: These constraints are non-negotiable
5
+ # Claude should check this before any potentially destructive operation
6
+
7
+ anchor_id: "anchor-safety"
8
+ type: "safety"
9
+ immutable: true
10
+ created_at: "${TIMESTAMP}"
11
+ last_updated: "${TIMESTAMP}"
12
+
13
+ # Operations that are ALWAYS blocked
14
+ blocked_operations:
15
+ filesystem:
16
+ - pattern: "rm -rf /"
17
+ reason: "Would delete entire filesystem"
18
+ - pattern: "rm -rf ~"
19
+ reason: "Would delete user home directory"
20
+ - pattern: "rm -rf $HOME"
21
+ reason: "Would delete user home directory"
22
+ - pattern: "> /dev/sd*"
23
+ reason: "Would overwrite disk device"
24
+ - pattern: "mkfs.*"
25
+ reason: "Would format disk"
26
+ - pattern: "dd if=*"
27
+ reason: "Raw disk write - extremely dangerous"
28
+
29
+ git:
30
+ - pattern: "git push --force origin main"
31
+ reason: "Would overwrite shared main branch history"
32
+ - pattern: "git push --force origin master"
33
+ reason: "Would overwrite shared master branch history"
34
+
35
+ database:
36
+ - pattern: "DROP DATABASE production"
37
+ reason: "Would destroy production database"
38
+
39
+ # Operations that require explicit user confirmation
40
+ requires_confirmation:
41
+ filesystem:
42
+ - pattern: "rm -rf"
43
+ prompt: "This will recursively delete files. Are you sure?"
44
+ - pattern: "rm -r"
45
+ prompt: "This will recursively delete files. Are you sure?"
46
+
47
+ git:
48
+ - pattern: "git reset --hard"
49
+ prompt: "This will discard uncommitted changes. Are you sure?"
50
+ - pattern: "git clean -fd"
51
+ prompt: "This will delete untracked files. Are you sure?"
52
+ - pattern: "git checkout -- ."
53
+ prompt: "This will discard all local changes. Are you sure?"
54
+ - pattern: "git branch -D"
55
+ prompt: "This will force-delete a branch. Are you sure?"
56
+ - pattern: "--force"
57
+ prompt: "Force operations can cause data loss. Are you sure?"
58
+
59
+ database:
60
+ - pattern: "DROP TABLE"
61
+ prompt: "This will permanently delete a table. Are you sure?"
62
+ - pattern: "TRUNCATE"
63
+ prompt: "This will delete all data in the table. Are you sure?"
64
+ - pattern: "DELETE FROM .* WHERE 1"
65
+ prompt: "This will delete all rows. Are you sure?"
66
+
67
+ # Safety checks to perform before operations
68
+ pre_operation_checks:
69
+ - check: "verify_working_directory"
70
+ description: "Confirm we're in the expected project directory"
71
+ when: "Before any file modification"
72
+
73
+ - check: "verify_git_branch"
74
+ description: "Confirm we're on the expected branch"
75
+ when: "Before any git operation"
76
+
77
+ - check: "verify_no_uncommitted_changes"
78
+ description: "Check for uncommitted work that could be lost"
79
+ when: "Before git reset, checkout, or clean"
80
+
81
+ - check: "read_health_status"
82
+ description: "Check if context has been compressed"
83
+ when: "Before any destructive operation"
84
+
85
+ # What to do when safety is uncertain
86
+ uncertainty_protocol:
87
+ steps:
88
+ - "Read koan/health/status.yaml to check context state"
89
+ - "Read koan/anchors/directory.anchor.yaml to verify location"
90
+ - "Run 'pwd' and 'git status' to ground understanding"
91
+ - "Ask user to confirm understanding before proceeding"
92
+
93
+ phrases_to_use:
94
+ - "Let me verify the current state before proceeding..."
95
+ - "I notice context may have been compressed. Let me confirm..."
96
+ - "Before this destructive operation, I want to verify..."
package/templates/claude-md-managed.template ADDED
@@ -0,0 +1,105 @@
1
+ <!-- zen:managed:start - DO NOT EDIT (regenerated by .zen/install.sh) -->
2
+
3
+ ## How to Work on This Project
4
+
5
+ **These are standing orders, not suggestions. Follow them without being prompted.**
6
+
7
+ ### Before Writing Code
8
+
9
+ 1. **Index the codebase** (`index_project`) on affected packages. Then use `get_call_graph`, `find_references`, and `find_implementations` to understand call chains, blast radius, and interface contracts before changing anything.
10
+ 2. **Check existing specs** (`zen_spec_list`, `zen_spec_get`). If a spec covers the area you're modifying, use its contracts to validate your implementation. If no spec exists for a significant module, create one with `zen_spec_save`.
11
+ 3. **Search for patterns** (`semantic_search`, `find_similar_code`). Find related implementations already in the codebase. If semantic search returns nothing, run `embed_project` first. Don't reinvent what exists.
12
+ 4. **Read before writing**. Use `get_symbol_info` with `includeBody: true` to inspect specific symbols. Never propose changes to code you haven't read.
13
+
14
+ ### While Writing Code
15
+
16
+ Apply these patterns in every module, on the first pass — not as a second-pass optimization:
17
+
18
+ - **Cache clients and connections**: Any SDK client, DB handle, or connection created in a hot path must be cached and reused. Never create-and-close per call.
19
+ - **Bound all collections**: Every map or list that grows with user data must have a cleanup/eviction path. If an entry is created on add, it must be deleted on remove.
20
+ - **Pre-allocate**: When the capacity is known or estimable, pre-allocate collections.
21
+ - **Conditional writes**: Don't write to DB/store when the value hasn't changed. Compare before writing.
22
+ - **Limit input**: All external input (HTTP bodies, webhook payloads) must be size-limited.
23
+ - **Thread parsed data**: If a value is parsed/deserialized, pass it through the call chain. Never re-parse.
24
+ - **No duplication**: If logic exists in a helper, call it. Don't inline a copy.
25
+
26
+ ### After Writing Code
27
+
28
+ 1. **Build and test** before declaring anything complete.
29
+ 2. **Save a checkpoint** (`zen_checkpoint_save`) after completing significant milestones — not just when asked.
30
+ 3. **Update memory** (`memory_store`) if you learned something stable about the project (architecture, gotchas, patterns).
31
+
32
+ ### Testing & Quality (use these tools — don't rely on manual test writing alone)
33
+
34
+ - **Generate tests first** (`generate_unit_tests`, `suggest_tests`). Before writing tests manually, use these tools to get a baseline, then refine.
35
+ - **Run tests through the tool** (`run_tests`). Use this instead of raw shell commands — it provides structured pass/fail/skip counts and failure details.
36
+ - **Check coverage** (`analyze_coverage`, `find_untested_files`). After tests pass, verify coverage. Don't declare done until untested paths are addressed.
37
+ - **Auto-repair on failure** (`run_tests_with_repair`, `self_debug`, `iterative_refine`). When tests fail, use repair tools to diagnose and fix — they track what worked for similar errors.
38
+
39
+ ### Knowledge Graph (build understanding as you work)
40
+
41
+ - **Bridge AST into KG** (`kg_ingest_ast`) after `index_project`. This creates entities for every symbol, file, and module with structural relations (calls, contains, defined_in). Use `scope` to limit to a subtree.
42
+ - **Ingest from text** (`kg_ingest`) when exploring prose, docs, or unfamiliar code. Extracts entities and relations via pattern matching.
43
+ - **Query relationships** (`kg_query`, `kg_traverse`) to understand how components connect before making cross-cutting changes. Use `kg_query` for natural language, `kg_traverse` for graph walking.
44
+ - **Build the graph incrementally** (`kg_entity`, `kg_relate`). Add architectural relationships not captured by auto-extraction: which tools use which stores, which configs guard which modules, which tests cover which functions.
45
+ - **Detect communities** (`kg_community` with action `detect`) after populating the graph. Connected components reveal actual module boundaries and coupling.
46
+
47
+ ### Agent Evolution (optimize agent prompts and workflow topologies)
48
+
49
+ - **Parse agent prompts** (`agent_parse`) to decompose markdown agent files into structured genomes (frontmatter + sections).
50
+ - **Mutate agents** (`agent_mutate`) to test variations: ablate sections, change models, add/remove skills, replace content.
51
+ - **Compare variants** (`agent_compare`) with Welch's t-test and Cohen's d effect size to determine if differences are statistically significant.
52
+ - **Browse benchmarks** (`agent_benchmark`) to list built-in evaluation tasks organized by agent type, category, and difficulty.
53
+ - **Evolve with MAP-Elites** (`agent_evolve_start`, `agent_evolve_step`) for quality-diversity optimization across cost/quality trade-offs.
54
+ - **Reassemble** (`agent_assemble`) modified genomes back to deployable markdown.
55
+ - **Classify task complexity** (`topology_classify`) to route tasks to appropriately-sized topologies. Supports feedback for accuracy improvement.
56
+ - **Evolve topologies** (`topology_evolve`) with NEAT-inspired co-evolution — discovers optimal multi-agent workflow structures via MAP-Elites.
57
+ - **Select topologies** (`topology_select`) to pick the best evolved topology for a given complexity level.
58
+ - **Ablation analysis** (`topology_ablation`) to measure which topology sections contribute most to fitness.
59
+ - **Skill impact analysis** (`topology_skills`) to evaluate which agent skills improve workflow performance.
60
+ - **Execute workflows** (`topology_execute_start`, `topology_execute_node`) — the MCP server acts as a passive message bus, tracking DAG execution state and routing outputs between agents.
61
+
62
+ ### For Features and Multi-Step Work
63
+
64
+ Use zen workflow tools to structure work:
65
+ - `zen_start_workflow` for new features — plans steps and assigns models
66
+ - `zen_advance_workflow` to move through phases
67
+ - `zen_get_concept` to load phase-specific instructions (story, architecture, implementation, quality)
68
+ - `zen_story_save` / `zen_story_get` to capture and retrieve requirements
69
+ - `zen_spec_save` / `zen_spec_generate` to define contracts and generate code from specs
70
+
71
+ Don't skip phases. The story phase catches requirement gaps. The architecture phase catches design issues. The quality phase catches bugs. Each phase exists because skipping it has cost rework.
72
+
73
+ ### What This Means in Practice
74
+
75
+ If the user says "add feature X", the response is NOT to start writing code. It is:
76
+ 1. Index the codebase (`index_project`, `embed_project`)
77
+ 2. Search for related patterns (`semantic_search`, `find_symbol`, `find_similar_code`)
78
+ 3. Understand the call graph (`get_call_graph`, `find_references`, `find_implementations`)
79
+ 4. Check/create specs (`zen_spec_list`, `zen_spec_save`)
80
+ 5. Plan the approach, then implement — applying the code quality standards above on the first pass
81
+
82
+ The tools were built for you. Use them.
83
+
84
+ ## After Auto-Compact
85
+
86
+ After context compression (auto-compact), always:
87
+ - Read `CLAUDE.md` to restore project context
88
+ - Run `zen_checkpoint_restore` with `latest: true` to reload pending work
89
+ - Use `memory_recall` to retrieve relevant project knowledge
90
+
91
+ ## Critical: .zen/ is Read-Only
92
+
93
+ The `.zen/` directory is a **read-only git submodule**. NEVER edit, create, or delete files in `.zen/`.
94
+
95
+ ## Available Commands
96
+
97
+ - `/feature "description"` - Start a new feature workflow
98
+ - `/workflow "description"` - Full automatic workflow
99
+ - `/health` - Check context health status
100
+ - `/checkpoint` - Save session state
101
+ - `/restore` - Restore from checkpoint
102
+ - `/remember "fact"` - Store in semantic memory
103
+ - `/recall query` - Retrieve memories
104
+
105
+ <!-- zen:managed:end -->