ai-prompt-guide-mcp 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 (887) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +271 -0
  3. package/dist/__tests__/config-loading.test.d.ts +5 -0
  4. package/dist/__tests__/config-loading.test.d.ts.map +1 -0
  5. package/dist/__tests__/config-loading.test.js +127 -0
  6. package/dist/__tests__/config-loading.test.js.map +1 -0
  7. package/dist/__tests__/config-logging.test.d.ts +5 -0
  8. package/dist/__tests__/config-logging.test.d.ts.map +1 -0
  9. package/dist/__tests__/config-logging.test.js +146 -0
  10. package/dist/__tests__/config-logging.test.js.map +1 -0
  11. package/dist/__tests__/config-path-resolution.test.d.ts +5 -0
  12. package/dist/__tests__/config-path-resolution.test.d.ts.map +1 -0
  13. package/dist/__tests__/config-path-resolution.test.js +88 -0
  14. package/dist/__tests__/config-path-resolution.test.js.map +1 -0
  15. package/dist/__tests__/config-path-validation.test.d.ts +6 -0
  16. package/dist/__tests__/config-path-validation.test.d.ts.map +1 -0
  17. package/dist/__tests__/config-path-validation.test.js +203 -0
  18. package/dist/__tests__/config-path-validation.test.js.map +1 -0
  19. package/dist/__tests__/config-precedence.test.d.ts +5 -0
  20. package/dist/__tests__/config-precedence.test.d.ts.map +1 -0
  21. package/dist/__tests__/config-precedence.test.js +200 -0
  22. package/dist/__tests__/config-precedence.test.js.map +1 -0
  23. package/dist/__tests__/config-types.test.d.ts +5 -0
  24. package/dist/__tests__/config-types.test.d.ts.map +1 -0
  25. package/dist/__tests__/config-types.test.js +189 -0
  26. package/dist/__tests__/config-types.test.js.map +1 -0
  27. package/dist/__tests__/config.test.d.ts +5 -0
  28. package/dist/__tests__/config.test.d.ts.map +1 -0
  29. package/dist/__tests__/config.test.js +229 -0
  30. package/dist/__tests__/config.test.js.map +1 -0
  31. package/dist/config.d.ts +87 -0
  32. package/dist/config.d.ts.map +1 -0
  33. package/dist/config.js +498 -0
  34. package/dist/config.js.map +1 -0
  35. package/dist/constants/defaults.d.ts +78 -0
  36. package/dist/constants/defaults.d.ts.map +1 -0
  37. package/dist/constants/defaults.js +78 -0
  38. package/dist/constants/defaults.js.map +1 -0
  39. package/dist/document-cache.d.ts +485 -0
  40. package/dist/document-cache.d.ts.map +1 -0
  41. package/dist/document-cache.hierarchical.test.d.ts +2 -0
  42. package/dist/document-cache.hierarchical.test.d.ts.map +1 -0
  43. package/dist/document-cache.hierarchical.test.js +243 -0
  44. package/dist/document-cache.hierarchical.test.js.map +1 -0
  45. package/dist/document-cache.js +965 -0
  46. package/dist/document-cache.js.map +1 -0
  47. package/dist/document-cache.test.d.ts +8 -0
  48. package/dist/document-cache.test.d.ts.map +1 -0
  49. package/dist/document-cache.test.js +624 -0
  50. package/dist/document-cache.test.js.map +1 -0
  51. package/dist/document-manager.d.ts +252 -0
  52. package/dist/document-manager.d.ts.map +1 -0
  53. package/dist/document-manager.js +760 -0
  54. package/dist/document-manager.js.map +1 -0
  55. package/dist/document-manager.race-condition.test.d.ts +8 -0
  56. package/dist/document-manager.race-condition.test.d.ts.map +1 -0
  57. package/dist/document-manager.race-condition.test.js +139 -0
  58. package/dist/document-manager.race-condition.test.js.map +1 -0
  59. package/dist/fingerprint-index.d.ts +177 -0
  60. package/dist/fingerprint-index.d.ts.map +1 -0
  61. package/dist/fingerprint-index.js +374 -0
  62. package/dist/fingerprint-index.js.map +1 -0
  63. package/dist/fingerprint-index.test.d.ts +15 -0
  64. package/dist/fingerprint-index.test.d.ts.map +1 -0
  65. package/dist/fingerprint-index.test.js +482 -0
  66. package/dist/fingerprint-index.test.js.map +1 -0
  67. package/dist/fsio.d.ts +76 -0
  68. package/dist/fsio.d.ts.map +1 -0
  69. package/dist/fsio.js +506 -0
  70. package/dist/fsio.js.map +1 -0
  71. package/dist/index.d.ts +6 -0
  72. package/dist/index.d.ts.map +1 -0
  73. package/dist/index.js +20 -0
  74. package/dist/index.js.map +1 -0
  75. package/dist/markdown-tools.test.d.ts +5 -0
  76. package/dist/markdown-tools.test.d.ts.map +1 -0
  77. package/dist/markdown-tools.test.js +200 -0
  78. package/dist/markdown-tools.test.js.map +1 -0
  79. package/dist/parse.d.ts +19 -0
  80. package/dist/parse.d.ts.map +1 -0
  81. package/dist/parse.js +144 -0
  82. package/dist/parse.js.map +1 -0
  83. package/dist/prompts/__tests__/prompt-loader.test.d.ts +5 -0
  84. package/dist/prompts/__tests__/prompt-loader.test.d.ts.map +1 -0
  85. package/dist/prompts/__tests__/prompt-loader.test.js +300 -0
  86. package/dist/prompts/__tests__/prompt-loader.test.js.map +1 -0
  87. package/dist/prompts/prompt-loader.d.ts +58 -0
  88. package/dist/prompts/prompt-loader.d.ts.map +1 -0
  89. package/dist/prompts/prompt-loader.js +215 -0
  90. package/dist/prompts/prompt-loader.js.map +1 -0
  91. package/dist/prompts/prompt-validator.d.ts +30 -0
  92. package/dist/prompts/prompt-validator.d.ts.map +1 -0
  93. package/dist/prompts/prompt-validator.js +65 -0
  94. package/dist/prompts/prompt-validator.js.map +1 -0
  95. package/dist/prompts/types.d.ts +46 -0
  96. package/dist/prompts/types.d.ts.map +1 -0
  97. package/dist/prompts/types.js +14 -0
  98. package/dist/prompts/types.js.map +1 -0
  99. package/dist/prompts/workflow-prompts.d.ts +42 -0
  100. package/dist/prompts/workflow-prompts.d.ts.map +1 -0
  101. package/dist/prompts/workflow-prompts.js +61 -0
  102. package/dist/prompts/workflow-prompts.js.map +1 -0
  103. package/dist/sections.d.ts +67 -0
  104. package/dist/sections.d.ts.map +1 -0
  105. package/dist/sections.hierarchical.test.d.ts +8 -0
  106. package/dist/sections.hierarchical.test.d.ts.map +1 -0
  107. package/dist/sections.hierarchical.test.js +397 -0
  108. package/dist/sections.hierarchical.test.js.map +1 -0
  109. package/dist/sections.js +1229 -0
  110. package/dist/sections.js.map +1 -0
  111. package/dist/server/default-dependencies.d.ts +134 -0
  112. package/dist/server/default-dependencies.d.ts.map +1 -0
  113. package/dist/server/default-dependencies.js +176 -0
  114. package/dist/server/default-dependencies.js.map +1 -0
  115. package/dist/server/dependencies.d.ts +161 -0
  116. package/dist/server/dependencies.d.ts.map +1 -0
  117. package/dist/server/dependencies.js +50 -0
  118. package/dist/server/dependencies.js.map +1 -0
  119. package/dist/server/index.d.ts +10 -0
  120. package/dist/server/index.d.ts.map +1 -0
  121. package/dist/server/index.js +9 -0
  122. package/dist/server/index.js.map +1 -0
  123. package/dist/server/middleware/error-handling.d.ts +52 -0
  124. package/dist/server/middleware/error-handling.d.ts.map +1 -0
  125. package/dist/server/middleware/error-handling.js +76 -0
  126. package/dist/server/middleware/error-handling.js.map +1 -0
  127. package/dist/server/middleware/index.d.ts +7 -0
  128. package/dist/server/middleware/index.d.ts.map +1 -0
  129. package/dist/server/middleware/index.js +7 -0
  130. package/dist/server/middleware/index.js.map +1 -0
  131. package/dist/server/middleware/logging.d.ts +29 -0
  132. package/dist/server/middleware/logging.d.ts.map +1 -0
  133. package/dist/server/middleware/logging.js +49 -0
  134. package/dist/server/middleware/logging.js.map +1 -0
  135. package/dist/server/middleware/session-management.d.ts +38 -0
  136. package/dist/server/middleware/session-management.d.ts.map +1 -0
  137. package/dist/server/middleware/session-management.js +66 -0
  138. package/dist/server/middleware/session-management.js.map +1 -0
  139. package/dist/server/request-handlers/index.d.ts +5 -0
  140. package/dist/server/request-handlers/index.d.ts.map +1 -0
  141. package/dist/server/request-handlers/index.js +5 -0
  142. package/dist/server/request-handlers/index.js.map +1 -0
  143. package/dist/server/request-handlers/prompt-handlers.d.ts +13 -0
  144. package/dist/server/request-handlers/prompt-handlers.d.ts.map +1 -0
  145. package/dist/server/request-handlers/prompt-handlers.js +80 -0
  146. package/dist/server/request-handlers/prompt-handlers.js.map +1 -0
  147. package/dist/server/request-handlers/tool-handlers.d.ts +11 -0
  148. package/dist/server/request-handlers/tool-handlers.d.ts.map +1 -0
  149. package/dist/server/request-handlers/tool-handlers.js +85 -0
  150. package/dist/server/request-handlers/tool-handlers.js.map +1 -0
  151. package/dist/server/server-factory.d.ts +68 -0
  152. package/dist/server/server-factory.d.ts.map +1 -0
  153. package/dist/server/server-factory.js +135 -0
  154. package/dist/server/server-factory.js.map +1 -0
  155. package/dist/server/transport/stdio-transport.d.ts +9 -0
  156. package/dist/server/transport/stdio-transport.d.ts.map +1 -0
  157. package/dist/server/transport/stdio-transport.js +11 -0
  158. package/dist/server/transport/stdio-transport.js.map +1 -0
  159. package/dist/session/index.d.ts +5 -0
  160. package/dist/session/index.d.ts.map +1 -0
  161. package/dist/session/index.js +7 -0
  162. package/dist/session/index.js.map +1 -0
  163. package/dist/session/session-store.d.ts +74 -0
  164. package/dist/session/session-store.d.ts.map +1 -0
  165. package/dist/session/session-store.js +150 -0
  166. package/dist/session/session-store.js.map +1 -0
  167. package/dist/session/types.d.ts +96 -0
  168. package/dist/session/types.d.ts.map +1 -0
  169. package/dist/session/types.js +9 -0
  170. package/dist/session/types.js.map +1 -0
  171. package/dist/shared/__tests__/addressing-system.batch-cache.test.d.ts +12 -0
  172. package/dist/shared/__tests__/addressing-system.batch-cache.test.d.ts.map +1 -0
  173. package/dist/shared/__tests__/addressing-system.batch-cache.test.js +306 -0
  174. package/dist/shared/__tests__/addressing-system.batch-cache.test.js.map +1 -0
  175. package/dist/shared/__tests__/addressing-system.hierarchical.test.d.ts +6 -0
  176. package/dist/shared/__tests__/addressing-system.hierarchical.test.d.ts.map +1 -0
  177. package/dist/shared/__tests__/addressing-system.hierarchical.test.js +205 -0
  178. package/dist/shared/__tests__/addressing-system.hierarchical.test.js.map +1 -0
  179. package/dist/shared/__tests__/addressing-system.lru.test.d.ts +6 -0
  180. package/dist/shared/__tests__/addressing-system.lru.test.d.ts.map +1 -0
  181. package/dist/shared/__tests__/addressing-system.lru.test.js +159 -0
  182. package/dist/shared/__tests__/addressing-system.lru.test.js.map +1 -0
  183. package/dist/shared/__tests__/addressing-system.relative-paths.test.d.ts +14 -0
  184. package/dist/shared/__tests__/addressing-system.relative-paths.test.d.ts.map +1 -0
  185. package/dist/shared/__tests__/addressing-system.relative-paths.test.js +249 -0
  186. package/dist/shared/__tests__/addressing-system.relative-paths.test.js.map +1 -0
  187. package/dist/shared/__tests__/document-analysis-enhanced.test.d.ts +9 -0
  188. package/dist/shared/__tests__/document-analysis-enhanced.test.d.ts.map +1 -0
  189. package/dist/shared/__tests__/document-analysis-enhanced.test.js +419 -0
  190. package/dist/shared/__tests__/document-analysis-enhanced.test.js.map +1 -0
  191. package/dist/shared/__tests__/document-analysis.test.d.ts +8 -0
  192. package/dist/shared/__tests__/document-analysis.test.d.ts.map +1 -0
  193. package/dist/shared/__tests__/document-analysis.test.js +904 -0
  194. package/dist/shared/__tests__/document-analysis.test.js.map +1 -0
  195. package/dist/shared/__tests__/keyword-utils-integration.test.d.ts +9 -0
  196. package/dist/shared/__tests__/keyword-utils-integration.test.d.ts.map +1 -0
  197. package/dist/shared/__tests__/keyword-utils-integration.test.js +317 -0
  198. package/dist/shared/__tests__/keyword-utils-integration.test.js.map +1 -0
  199. package/dist/shared/__tests__/link-utils.test.d.ts +5 -0
  200. package/dist/shared/__tests__/link-utils.test.d.ts.map +1 -0
  201. package/dist/shared/__tests__/link-utils.test.js +560 -0
  202. package/dist/shared/__tests__/link-utils.test.js.map +1 -0
  203. package/dist/shared/__tests__/link-validation.test.d.ts +5 -0
  204. package/dist/shared/__tests__/link-validation.test.d.ts.map +1 -0
  205. package/dist/shared/__tests__/link-validation.test.js +473 -0
  206. package/dist/shared/__tests__/link-validation.test.js.map +1 -0
  207. package/dist/shared/__tests__/reference-extractor.test.d.ts +8 -0
  208. package/dist/shared/__tests__/reference-extractor.test.d.ts.map +1 -0
  209. package/dist/shared/__tests__/reference-extractor.test.js +260 -0
  210. package/dist/shared/__tests__/reference-extractor.test.js.map +1 -0
  211. package/dist/shared/__tests__/reference-loader.test.d.ts +8 -0
  212. package/dist/shared/__tests__/reference-loader.test.d.ts.map +1 -0
  213. package/dist/shared/__tests__/reference-loader.test.js +622 -0
  214. package/dist/shared/__tests__/reference-loader.test.js.map +1 -0
  215. package/dist/shared/__tests__/section-operations.append.test.d.ts +8 -0
  216. package/dist/shared/__tests__/section-operations.append.test.d.ts.map +1 -0
  217. package/dist/shared/__tests__/section-operations.append.test.js +150 -0
  218. package/dist/shared/__tests__/section-operations.append.test.js.map +1 -0
  219. package/dist/shared/__tests__/section-operations.test.d.ts +7 -0
  220. package/dist/shared/__tests__/section-operations.test.d.ts.map +1 -0
  221. package/dist/shared/__tests__/section-operations.test.js +118 -0
  222. package/dist/shared/__tests__/section-operations.test.js.map +1 -0
  223. package/dist/shared/__tests__/slug-utils.test.d.ts +5 -0
  224. package/dist/shared/__tests__/slug-utils.test.d.ts.map +1 -0
  225. package/dist/shared/__tests__/slug-utils.test.js +542 -0
  226. package/dist/shared/__tests__/slug-utils.test.js.map +1 -0
  227. package/dist/shared/__tests__/task-operations.test.d.ts +9 -0
  228. package/dist/shared/__tests__/task-operations.test.d.ts.map +1 -0
  229. package/dist/shared/__tests__/task-operations.test.js +257 -0
  230. package/dist/shared/__tests__/task-operations.test.js.map +1 -0
  231. package/dist/shared/__tests__/task-validation.test.d.ts +6 -0
  232. package/dist/shared/__tests__/task-validation.test.d.ts.map +1 -0
  233. package/dist/shared/__tests__/task-validation.test.js +129 -0
  234. package/dist/shared/__tests__/task-validation.test.js.map +1 -0
  235. package/dist/shared/__tests__/task-view-utilities.test.d.ts +5 -0
  236. package/dist/shared/__tests__/task-view-utilities.test.d.ts.map +1 -0
  237. package/dist/shared/__tests__/task-view-utilities.test.js +312 -0
  238. package/dist/shared/__tests__/task-view-utilities.test.js.map +1 -0
  239. package/dist/shared/__tests__/tool-integration.array-validation.test.d.ts +7 -0
  240. package/dist/shared/__tests__/tool-integration.array-validation.test.d.ts.map +1 -0
  241. package/dist/shared/__tests__/tool-integration.array-validation.test.js +169 -0
  242. package/dist/shared/__tests__/tool-integration.array-validation.test.js.map +1 -0
  243. package/dist/shared/__tests__/tool-integration.hierarchical.test.d.ts +7 -0
  244. package/dist/shared/__tests__/tool-integration.hierarchical.test.d.ts.map +1 -0
  245. package/dist/shared/__tests__/tool-integration.hierarchical.test.js +204 -0
  246. package/dist/shared/__tests__/tool-integration.hierarchical.test.js.map +1 -0
  247. package/dist/shared/__tests__/workflow-prompt-utilities.test.d.ts +8 -0
  248. package/dist/shared/__tests__/workflow-prompt-utilities.test.d.ts.map +1 -0
  249. package/dist/shared/__tests__/workflow-prompt-utilities.test.js +722 -0
  250. package/dist/shared/__tests__/workflow-prompt-utilities.test.js.map +1 -0
  251. package/dist/shared/addressing-system.d.ts +799 -0
  252. package/dist/shared/addressing-system.d.ts.map +1 -0
  253. package/dist/shared/addressing-system.js +1074 -0
  254. package/dist/shared/addressing-system.js.map +1 -0
  255. package/dist/shared/document-analysis/__tests__/keyword-utils.test.d.ts +8 -0
  256. package/dist/shared/document-analysis/__tests__/keyword-utils.test.d.ts.map +1 -0
  257. package/dist/shared/document-analysis/__tests__/keyword-utils.test.js +601 -0
  258. package/dist/shared/document-analysis/__tests__/keyword-utils.test.js.map +1 -0
  259. package/dist/shared/document-analysis/index.d.ts +67 -0
  260. package/dist/shared/document-analysis/index.d.ts.map +1 -0
  261. package/dist/shared/document-analysis/index.js +166 -0
  262. package/dist/shared/document-analysis/index.js.map +1 -0
  263. package/dist/shared/document-analysis/keyword-utils.d.ts +405 -0
  264. package/dist/shared/document-analysis/keyword-utils.d.ts.map +1 -0
  265. package/dist/shared/document-analysis/keyword-utils.js +1147 -0
  266. package/dist/shared/document-analysis/keyword-utils.js.map +1 -0
  267. package/dist/shared/document-analysis/reference-validation.d.ts +27 -0
  268. package/dist/shared/document-analysis/reference-validation.d.ts.map +1 -0
  269. package/dist/shared/document-analysis/reference-validation.js +173 -0
  270. package/dist/shared/document-analysis/reference-validation.js.map +1 -0
  271. package/dist/shared/document-analysis/related-docs.d.ts +27 -0
  272. package/dist/shared/document-analysis/related-docs.d.ts.map +1 -0
  273. package/dist/shared/document-analysis/related-docs.js +459 -0
  274. package/dist/shared/document-analysis/related-docs.js.map +1 -0
  275. package/dist/shared/document-analysis/types.d.ts +89 -0
  276. package/dist/shared/document-analysis/types.d.ts.map +1 -0
  277. package/dist/shared/document-analysis/types.js +41 -0
  278. package/dist/shared/document-analysis/types.js.map +1 -0
  279. package/dist/shared/document-analysis.d.ts +15 -0
  280. package/dist/shared/document-analysis.d.ts.map +1 -0
  281. package/dist/shared/document-analysis.js +16 -0
  282. package/dist/shared/document-analysis.js.map +1 -0
  283. package/dist/shared/document-manager-factory.d.ts +32 -0
  284. package/dist/shared/document-manager-factory.d.ts.map +1 -0
  285. package/dist/shared/document-manager-factory.js +75 -0
  286. package/dist/shared/document-manager-factory.js.map +1 -0
  287. package/dist/shared/index.d.ts +5 -0
  288. package/dist/shared/index.d.ts.map +1 -0
  289. package/dist/shared/index.js +7 -0
  290. package/dist/shared/index.js.map +1 -0
  291. package/dist/shared/link-analysis.d.ts +84 -0
  292. package/dist/shared/link-analysis.d.ts.map +1 -0
  293. package/dist/shared/link-analysis.js +213 -0
  294. package/dist/shared/link-analysis.js.map +1 -0
  295. package/dist/shared/link-context.d.ts +23 -0
  296. package/dist/shared/link-context.d.ts.map +1 -0
  297. package/dist/shared/link-context.js +172 -0
  298. package/dist/shared/link-context.js.map +1 -0
  299. package/dist/shared/link-utils.d.ts +33 -0
  300. package/dist/shared/link-utils.d.ts.map +1 -0
  301. package/dist/shared/link-utils.js +301 -0
  302. package/dist/shared/link-utils.js.map +1 -0
  303. package/dist/shared/link-validation.d.ts +79 -0
  304. package/dist/shared/link-validation.d.ts.map +1 -0
  305. package/dist/shared/link-validation.js +340 -0
  306. package/dist/shared/link-validation.js.map +1 -0
  307. package/dist/shared/namespace-analysis.d.ts +10 -0
  308. package/dist/shared/namespace-analysis.d.ts.map +1 -0
  309. package/dist/shared/namespace-analysis.js +100 -0
  310. package/dist/shared/namespace-analysis.js.map +1 -0
  311. package/dist/shared/namespace-constants.d.ts +69 -0
  312. package/dist/shared/namespace-constants.d.ts.map +1 -0
  313. package/dist/shared/namespace-constants.js +97 -0
  314. package/dist/shared/namespace-constants.js.map +1 -0
  315. package/dist/shared/path-utilities.d.ts +13 -0
  316. package/dist/shared/path-utilities.d.ts.map +1 -0
  317. package/dist/shared/path-utilities.js +39 -0
  318. package/dist/shared/path-utilities.js.map +1 -0
  319. package/dist/shared/reference-extractor.d.ts +121 -0
  320. package/dist/shared/reference-extractor.d.ts.map +1 -0
  321. package/dist/shared/reference-extractor.js +195 -0
  322. package/dist/shared/reference-extractor.js.map +1 -0
  323. package/dist/shared/reference-loader.d.ts +163 -0
  324. package/dist/shared/reference-loader.d.ts.map +1 -0
  325. package/dist/shared/reference-loader.js +265 -0
  326. package/dist/shared/reference-loader.js.map +1 -0
  327. package/dist/shared/section-operations.d.ts +14 -0
  328. package/dist/shared/section-operations.d.ts.map +1 -0
  329. package/dist/shared/section-operations.js +115 -0
  330. package/dist/shared/section-operations.js.map +1 -0
  331. package/dist/shared/slug-utils.d.ts +109 -0
  332. package/dist/shared/slug-utils.d.ts.map +1 -0
  333. package/dist/shared/slug-utils.js +302 -0
  334. package/dist/shared/slug-utils.js.map +1 -0
  335. package/dist/shared/task-operations.d.ts +152 -0
  336. package/dist/shared/task-operations.d.ts.map +1 -0
  337. package/dist/shared/task-operations.js +416 -0
  338. package/dist/shared/task-operations.js.map +1 -0
  339. package/dist/shared/task-utilities.d.ts +63 -0
  340. package/dist/shared/task-utilities.d.ts.map +1 -0
  341. package/dist/shared/task-utilities.js +86 -0
  342. package/dist/shared/task-utilities.js.map +1 -0
  343. package/dist/shared/task-validation.d.ts +50 -0
  344. package/dist/shared/task-validation.d.ts.map +1 -0
  345. package/dist/shared/task-validation.js +97 -0
  346. package/dist/shared/task-validation.js.map +1 -0
  347. package/dist/shared/task-view-utilities.d.ts +109 -0
  348. package/dist/shared/task-view-utilities.d.ts.map +1 -0
  349. package/dist/shared/task-view-utilities.js +255 -0
  350. package/dist/shared/task-view-utilities.js.map +1 -0
  351. package/dist/shared/utilities.d.ts +14 -0
  352. package/dist/shared/utilities.d.ts.map +1 -0
  353. package/dist/shared/utilities.js +23 -0
  354. package/dist/shared/utilities.js.map +1 -0
  355. package/dist/shared/utilities.test.d.ts +5 -0
  356. package/dist/shared/utilities.test.d.ts.map +1 -0
  357. package/dist/shared/utilities.test.js +422 -0
  358. package/dist/shared/utilities.test.js.map +1 -0
  359. package/dist/shared/validation-utils.d.ts +57 -0
  360. package/dist/shared/validation-utils.d.ts.map +1 -0
  361. package/dist/shared/validation-utils.js +63 -0
  362. package/dist/shared/validation-utils.js.map +1 -0
  363. package/dist/shared/workflow-prompt-utilities.d.ts +64 -0
  364. package/dist/shared/workflow-prompt-utilities.d.ts.map +1 -0
  365. package/dist/shared/workflow-prompt-utilities.js +163 -0
  366. package/dist/shared/workflow-prompt-utilities.js.map +1 -0
  367. package/dist/slug.d.ts +9 -0
  368. package/dist/slug.d.ts.map +1 -0
  369. package/dist/slug.js +40 -0
  370. package/dist/slug.js.map +1 -0
  371. package/dist/template-loader.d.ts +6 -0
  372. package/dist/template-loader.d.ts.map +1 -0
  373. package/dist/template-loader.js +8 -0
  374. package/dist/template-loader.js.map +1 -0
  375. package/dist/tools/__tests__/create-document-self-reference.test.d.ts +2 -0
  376. package/dist/tools/__tests__/create-document-self-reference.test.d.ts.map +1 -0
  377. package/dist/tools/__tests__/create-document-self-reference.test.js +124 -0
  378. package/dist/tools/__tests__/create-document-self-reference.test.js.map +1 -0
  379. package/dist/tools/__tests__/create-document-workflow-regression.test.d.ts +16 -0
  380. package/dist/tools/__tests__/create-document-workflow-regression.test.d.ts.map +1 -0
  381. package/dist/tools/__tests__/create-document-workflow-regression.test.js +655 -0
  382. package/dist/tools/__tests__/create-document-workflow-regression.test.js.map +1 -0
  383. package/dist/tools/__tests__/create-document.test.d.ts +2 -0
  384. package/dist/tools/__tests__/create-document.test.d.ts.map +1 -0
  385. package/dist/tools/__tests__/create-document.test.js +255 -0
  386. package/dist/tools/__tests__/create-document.test.js.map +1 -0
  387. package/dist/tools/__tests__/delete-document.test.d.ts +7 -0
  388. package/dist/tools/__tests__/delete-document.test.d.ts.map +1 -0
  389. package/dist/tools/__tests__/delete-document.test.js +311 -0
  390. package/dist/tools/__tests__/delete-document.test.js.map +1 -0
  391. package/dist/tools/__tests__/edit-document.test.d.ts +2 -0
  392. package/dist/tools/__tests__/edit-document.test.d.ts.map +1 -0
  393. package/dist/tools/__tests__/edit-document.test.js +644 -0
  394. package/dist/tools/__tests__/edit-document.test.js.map +1 -0
  395. package/dist/tools/__tests__/error-scenarios.test.d.ts +5 -0
  396. package/dist/tools/__tests__/error-scenarios.test.d.ts.map +1 -0
  397. package/dist/tools/__tests__/error-scenarios.test.js +105 -0
  398. package/dist/tools/__tests__/error-scenarios.test.js.map +1 -0
  399. package/dist/tools/__tests__/mocks/document-manager.mock.d.ts +99 -0
  400. package/dist/tools/__tests__/mocks/document-manager.mock.d.ts.map +1 -0
  401. package/dist/tools/__tests__/mocks/document-manager.mock.js +457 -0
  402. package/dist/tools/__tests__/mocks/document-manager.mock.js.map +1 -0
  403. package/dist/tools/__tests__/mocks/filesystem.mock.d.ts +103 -0
  404. package/dist/tools/__tests__/mocks/filesystem.mock.d.ts.map +1 -0
  405. package/dist/tools/__tests__/mocks/filesystem.mock.js +247 -0
  406. package/dist/tools/__tests__/mocks/filesystem.mock.js.map +1 -0
  407. package/dist/tools/__tests__/move-document.test.d.ts +12 -0
  408. package/dist/tools/__tests__/move-document.test.d.ts.map +1 -0
  409. package/dist/tools/__tests__/move-document.test.js +214 -0
  410. package/dist/tools/__tests__/move-document.test.js.map +1 -0
  411. package/dist/tools/__tests__/move.test.d.ts +13 -0
  412. package/dist/tools/__tests__/move.test.d.ts.map +1 -0
  413. package/dist/tools/__tests__/move.test.js +939 -0
  414. package/dist/tools/__tests__/move.test.js.map +1 -0
  415. package/dist/tools/__tests__/section.integration.improved.test.d.ts +5 -0
  416. package/dist/tools/__tests__/section.integration.improved.test.d.ts.map +1 -0
  417. package/dist/tools/__tests__/section.integration.improved.test.js +199 -0
  418. package/dist/tools/__tests__/section.integration.improved.test.js.map +1 -0
  419. package/dist/tools/__tests__/section.integration.test.d.ts +5 -0
  420. package/dist/tools/__tests__/section.integration.test.d.ts.map +1 -0
  421. package/dist/tools/__tests__/section.integration.test.js +637 -0
  422. package/dist/tools/__tests__/section.integration.test.js.map +1 -0
  423. package/dist/tools/__tests__/setup/test-environment.d.ts +111 -0
  424. package/dist/tools/__tests__/setup/test-environment.d.ts.map +1 -0
  425. package/dist/tools/__tests__/setup/test-environment.js +322 -0
  426. package/dist/tools/__tests__/setup/test-environment.js.map +1 -0
  427. package/dist/tools/__tests__/suggestion-generator.test.d.ts +8 -0
  428. package/dist/tools/__tests__/suggestion-generator.test.d.ts.map +1 -0
  429. package/dist/tools/__tests__/suggestion-generator.test.js +508 -0
  430. package/dist/tools/__tests__/suggestion-generator.test.js.map +1 -0
  431. package/dist/tools/__tests__/task-consistency.test.d.ts +11 -0
  432. package/dist/tools/__tests__/task-consistency.test.d.ts.map +1 -0
  433. package/dist/tools/__tests__/task-consistency.test.js +93 -0
  434. package/dist/tools/__tests__/task-consistency.test.js.map +1 -0
  435. package/dist/tools/__tests__/task-status-parsing.test.d.ts +15 -0
  436. package/dist/tools/__tests__/task-status-parsing.test.d.ts.map +1 -0
  437. package/dist/tools/__tests__/task-status-parsing.test.js +126 -0
  438. package/dist/tools/__tests__/task-status-parsing.test.js.map +1 -0
  439. package/dist/tools/__tests__/view-section-boundary.test.d.ts +2 -0
  440. package/dist/tools/__tests__/view-section-boundary.test.d.ts.map +1 -0
  441. package/dist/tools/__tests__/view-section-boundary.test.js +132 -0
  442. package/dist/tools/__tests__/view-section-boundary.test.js.map +1 -0
  443. package/dist/tools/__tests__/write-operations-integration.test.d.ts +8 -0
  444. package/dist/tools/__tests__/write-operations-integration.test.d.ts.map +1 -0
  445. package/dist/tools/__tests__/write-operations-integration.test.js +136 -0
  446. package/dist/tools/__tests__/write-operations-integration.test.js.map +1 -0
  447. package/dist/tools/browse/content-analyzer.d.ts +27 -0
  448. package/dist/tools/browse/content-analyzer.d.ts.map +1 -0
  449. package/dist/tools/browse/content-analyzer.js +150 -0
  450. package/dist/tools/browse/content-analyzer.js.map +1 -0
  451. package/dist/tools/browse/dependency-analyzer.d.ts +63 -0
  452. package/dist/tools/browse/dependency-analyzer.d.ts.map +1 -0
  453. package/dist/tools/browse/dependency-analyzer.js +261 -0
  454. package/dist/tools/browse/dependency-analyzer.js.map +1 -0
  455. package/dist/tools/browse/folder-navigator.d.ts +35 -0
  456. package/dist/tools/browse/folder-navigator.d.ts.map +1 -0
  457. package/dist/tools/browse/folder-navigator.js +154 -0
  458. package/dist/tools/browse/folder-navigator.js.map +1 -0
  459. package/dist/tools/browse/index.d.ts +10 -0
  460. package/dist/tools/browse/index.d.ts.map +1 -0
  461. package/dist/tools/browse/index.js +14 -0
  462. package/dist/tools/browse/index.js.map +1 -0
  463. package/dist/tools/browse/relationship-classifier.d.ts +9 -0
  464. package/dist/tools/browse/relationship-classifier.d.ts.map +1 -0
  465. package/dist/tools/browse/relationship-classifier.js +38 -0
  466. package/dist/tools/browse/relationship-classifier.js.map +1 -0
  467. package/dist/tools/browse/search-engine.d.ts +69 -0
  468. package/dist/tools/browse/search-engine.d.ts.map +1 -0
  469. package/dist/tools/browse/search-engine.js +197 -0
  470. package/dist/tools/browse/search-engine.js.map +1 -0
  471. package/dist/tools/create/__tests__/file-creator.test.d.ts +6 -0
  472. package/dist/tools/create/__tests__/file-creator.test.d.ts.map +1 -0
  473. package/dist/tools/create/__tests__/file-creator.test.js +138 -0
  474. package/dist/tools/create/__tests__/file-creator.test.js.map +1 -0
  475. package/dist/tools/create/__tests__/template-processor.test.d.ts +6 -0
  476. package/dist/tools/create/__tests__/template-processor.test.d.ts.map +1 -0
  477. package/dist/tools/create/__tests__/template-processor.test.js +130 -0
  478. package/dist/tools/create/__tests__/template-processor.test.js.map +1 -0
  479. package/dist/tools/create/file-creator.d.ts +35 -0
  480. package/dist/tools/create/file-creator.d.ts.map +1 -0
  481. package/dist/tools/create/file-creator.js +103 -0
  482. package/dist/tools/create/file-creator.js.map +1 -0
  483. package/dist/tools/create/index.d.ts +6 -0
  484. package/dist/tools/create/index.d.ts.map +1 -0
  485. package/dist/tools/create/index.js +7 -0
  486. package/dist/tools/create/index.js.map +1 -0
  487. package/dist/tools/create/pipeline.d.ts +39 -0
  488. package/dist/tools/create/pipeline.d.ts.map +1 -0
  489. package/dist/tools/create/pipeline.js +112 -0
  490. package/dist/tools/create/pipeline.js.map +1 -0
  491. package/dist/tools/create/suggestion-generator.d.ts +47 -0
  492. package/dist/tools/create/suggestion-generator.d.ts.map +1 -0
  493. package/dist/tools/create/suggestion-generator.js +51 -0
  494. package/dist/tools/create/suggestion-generator.js.map +1 -0
  495. package/dist/tools/create/template-processor.d.ts +27 -0
  496. package/dist/tools/create/template-processor.d.ts.map +1 -0
  497. package/dist/tools/create/template-processor.js +74 -0
  498. package/dist/tools/create/template-processor.js.map +1 -0
  499. package/dist/tools/create/validation-processor.d.ts +48 -0
  500. package/dist/tools/create/validation-processor.d.ts.map +1 -0
  501. package/dist/tools/create/validation-processor.js +107 -0
  502. package/dist/tools/create/validation-processor.js.map +1 -0
  503. package/dist/tools/executor.d.ts +19 -0
  504. package/dist/tools/executor.d.ts.map +1 -0
  505. package/dist/tools/executor.js +53 -0
  506. package/dist/tools/executor.js.map +1 -0
  507. package/dist/tools/implementations/__tests__/browse-documents.test.d.ts +8 -0
  508. package/dist/tools/implementations/__tests__/browse-documents.test.d.ts.map +1 -0
  509. package/dist/tools/implementations/__tests__/browse-documents.test.js +319 -0
  510. package/dist/tools/implementations/__tests__/browse-documents.test.js.map +1 -0
  511. package/dist/tools/implementations/__tests__/complete-coordinator-task.test.d.ts +7 -0
  512. package/dist/tools/implementations/__tests__/complete-coordinator-task.test.d.ts.map +1 -0
  513. package/dist/tools/implementations/__tests__/complete-coordinator-task.test.js +440 -0
  514. package/dist/tools/implementations/__tests__/complete-coordinator-task.test.js.map +1 -0
  515. package/dist/tools/implementations/__tests__/complete-subagent-task.test.d.ts +14 -0
  516. package/dist/tools/implementations/__tests__/complete-subagent-task.test.d.ts.map +1 -0
  517. package/dist/tools/implementations/__tests__/complete-subagent-task.test.js +851 -0
  518. package/dist/tools/implementations/__tests__/complete-subagent-task.test.js.map +1 -0
  519. package/dist/tools/implementations/__tests__/complete-task-notes.test.d.ts +6 -0
  520. package/dist/tools/implementations/__tests__/complete-task-notes.test.d.ts.map +1 -0
  521. package/dist/tools/implementations/__tests__/complete-task-notes.test.js +157 -0
  522. package/dist/tools/implementations/__tests__/complete-task-notes.test.js.map +1 -0
  523. package/dist/tools/implementations/__tests__/complete-task.test.d.ts +14 -0
  524. package/dist/tools/implementations/__tests__/complete-task.test.d.ts.map +1 -0
  525. package/dist/tools/implementations/__tests__/complete-task.test.js +867 -0
  526. package/dist/tools/implementations/__tests__/complete-task.test.js.map +1 -0
  527. package/dist/tools/implementations/__tests__/continue-task.test.d.ts +11 -0
  528. package/dist/tools/implementations/__tests__/continue-task.test.d.ts.map +1 -0
  529. package/dist/tools/implementations/__tests__/continue-task.test.js +845 -0
  530. package/dist/tools/implementations/__tests__/continue-task.test.js.map +1 -0
  531. package/dist/tools/implementations/__tests__/coordinator-task.test.d.ts +7 -0
  532. package/dist/tools/implementations/__tests__/coordinator-task.test.d.ts.map +1 -0
  533. package/dist/tools/implementations/__tests__/coordinator-task.test.js +495 -0
  534. package/dist/tools/implementations/__tests__/coordinator-task.test.js.map +1 -0
  535. package/dist/tools/implementations/__tests__/get-guide.test.d.ts +8 -0
  536. package/dist/tools/implementations/__tests__/get-guide.test.d.ts.map +1 -0
  537. package/dist/tools/implementations/__tests__/get-guide.test.js +242 -0
  538. package/dist/tools/implementations/__tests__/get-guide.test.js.map +1 -0
  539. package/dist/tools/implementations/__tests__/get-workflow.test.d.ts +8 -0
  540. package/dist/tools/implementations/__tests__/get-workflow.test.d.ts.map +1 -0
  541. package/dist/tools/implementations/__tests__/get-workflow.test.js +232 -0
  542. package/dist/tools/implementations/__tests__/get-workflow.test.js.map +1 -0
  543. package/dist/tools/implementations/__tests__/search-documents.test.d.ts +8 -0
  544. package/dist/tools/implementations/__tests__/search-documents.test.d.ts.map +1 -0
  545. package/dist/tools/implementations/__tests__/search-documents.test.js +336 -0
  546. package/dist/tools/implementations/__tests__/search-documents.test.js.map +1 -0
  547. package/dist/tools/implementations/__tests__/start-coordinator-task.test.d.ts +7 -0
  548. package/dist/tools/implementations/__tests__/start-coordinator-task.test.d.ts.map +1 -0
  549. package/dist/tools/implementations/__tests__/start-coordinator-task.test.js +177 -0
  550. package/dist/tools/implementations/__tests__/start-coordinator-task.test.js.map +1 -0
  551. package/dist/tools/implementations/__tests__/start-subagent-task.test.d.ts +11 -0
  552. package/dist/tools/implementations/__tests__/start-subagent-task.test.d.ts.map +1 -0
  553. package/dist/tools/implementations/__tests__/start-subagent-task.test.js +846 -0
  554. package/dist/tools/implementations/__tests__/start-subagent-task.test.js.map +1 -0
  555. package/dist/tools/implementations/__tests__/start-task.test.d.ts +11 -0
  556. package/dist/tools/implementations/__tests__/start-task.test.d.ts.map +1 -0
  557. package/dist/tools/implementations/__tests__/start-task.test.js +828 -0
  558. package/dist/tools/implementations/__tests__/start-task.test.js.map +1 -0
  559. package/dist/tools/implementations/__tests__/subagent-task-batch-operations.test.d.ts +8 -0
  560. package/dist/tools/implementations/__tests__/subagent-task-batch-operations.test.d.ts.map +1 -0
  561. package/dist/tools/implementations/__tests__/subagent-task-batch-operations.test.js +199 -0
  562. package/dist/tools/implementations/__tests__/subagent-task-batch-operations.test.js.map +1 -0
  563. package/dist/tools/implementations/__tests__/subagent-task.test.d.ts +7 -0
  564. package/dist/tools/implementations/__tests__/subagent-task.test.d.ts.map +1 -0
  565. package/dist/tools/implementations/__tests__/subagent-task.test.js +720 -0
  566. package/dist/tools/implementations/__tests__/subagent-task.test.js.map +1 -0
  567. package/dist/tools/implementations/__tests__/task-batch-operations.test.d.ts +8 -0
  568. package/dist/tools/implementations/__tests__/task-batch-operations.test.d.ts.map +1 -0
  569. package/dist/tools/implementations/__tests__/task-batch-operations.test.js +200 -0
  570. package/dist/tools/implementations/__tests__/task-batch-operations.test.js.map +1 -0
  571. package/dist/tools/implementations/__tests__/task.test.d.ts +7 -0
  572. package/dist/tools/implementations/__tests__/task.test.d.ts.map +1 -0
  573. package/dist/tools/implementations/__tests__/task.test.js +578 -0
  574. package/dist/tools/implementations/__tests__/task.test.js.map +1 -0
  575. package/dist/tools/implementations/__tests__/view-coordinator-task.test.d.ts +13 -0
  576. package/dist/tools/implementations/__tests__/view-coordinator-task.test.d.ts.map +1 -0
  577. package/dist/tools/implementations/__tests__/view-coordinator-task.test.js +1404 -0
  578. package/dist/tools/implementations/__tests__/view-coordinator-task.test.js.map +1 -0
  579. package/dist/tools/implementations/__tests__/view-document.linked-context.test.d.ts +8 -0
  580. package/dist/tools/implementations/__tests__/view-document.linked-context.test.d.ts.map +1 -0
  581. package/dist/tools/implementations/__tests__/view-document.linked-context.test.js +235 -0
  582. package/dist/tools/implementations/__tests__/view-document.linked-context.test.js.map +1 -0
  583. package/dist/tools/implementations/__tests__/view-document.simplification.test.d.ts +9 -0
  584. package/dist/tools/implementations/__tests__/view-document.simplification.test.d.ts.map +1 -0
  585. package/dist/tools/implementations/__tests__/view-document.simplification.test.js +160 -0
  586. package/dist/tools/implementations/__tests__/view-document.simplification.test.js.map +1 -0
  587. package/dist/tools/implementations/__tests__/view-task.test.d.ts +12 -0
  588. package/dist/tools/implementations/__tests__/view-task.test.d.ts.map +1 -0
  589. package/dist/tools/implementations/__tests__/view-task.test.js +1158 -0
  590. package/dist/tools/implementations/__tests__/view-task.test.js.map +1 -0
  591. package/dist/tools/implementations/browse-documents.d.ts +36 -0
  592. package/dist/tools/implementations/browse-documents.d.ts.map +1 -0
  593. package/dist/tools/implementations/browse-documents.js +123 -0
  594. package/dist/tools/implementations/browse-documents.js.map +1 -0
  595. package/dist/tools/implementations/complete-coordinator-task.d.ts +53 -0
  596. package/dist/tools/implementations/complete-coordinator-task.d.ts.map +1 -0
  597. package/dist/tools/implementations/complete-coordinator-task.js +159 -0
  598. package/dist/tools/implementations/complete-coordinator-task.js.map +1 -0
  599. package/dist/tools/implementations/complete-subagent-task.d.ts +47 -0
  600. package/dist/tools/implementations/complete-subagent-task.d.ts.map +1 -0
  601. package/dist/tools/implementations/complete-subagent-task.js +141 -0
  602. package/dist/tools/implementations/complete-subagent-task.js.map +1 -0
  603. package/dist/tools/implementations/complete-task.d.ts +32 -0
  604. package/dist/tools/implementations/complete-task.d.ts.map +1 -0
  605. package/dist/tools/implementations/complete-task.hierarchical.test.d.ts +8 -0
  606. package/dist/tools/implementations/complete-task.hierarchical.test.d.ts.map +1 -0
  607. package/dist/tools/implementations/complete-task.hierarchical.test.js +363 -0
  608. package/dist/tools/implementations/complete-task.hierarchical.test.js.map +1 -0
  609. package/dist/tools/implementations/complete-task.js +122 -0
  610. package/dist/tools/implementations/complete-task.js.map +1 -0
  611. package/dist/tools/implementations/continue-task.d.ts +48 -0
  612. package/dist/tools/implementations/continue-task.d.ts.map +1 -0
  613. package/dist/tools/implementations/continue-task.js +167 -0
  614. package/dist/tools/implementations/continue-task.js.map +1 -0
  615. package/dist/tools/implementations/coordinator-task.d.ts +72 -0
  616. package/dist/tools/implementations/coordinator-task.d.ts.map +1 -0
  617. package/dist/tools/implementations/coordinator-task.js +169 -0
  618. package/dist/tools/implementations/coordinator-task.js.map +1 -0
  619. package/dist/tools/implementations/create-document.d.ts +12 -0
  620. package/dist/tools/implementations/create-document.d.ts.map +1 -0
  621. package/dist/tools/implementations/create-document.js +15 -0
  622. package/dist/tools/implementations/create-document.js.map +1 -0
  623. package/dist/tools/implementations/delete-document.d.ts +16 -0
  624. package/dist/tools/implementations/delete-document.d.ts.map +1 -0
  625. package/dist/tools/implementations/delete-document.js +70 -0
  626. package/dist/tools/implementations/delete-document.js.map +1 -0
  627. package/dist/tools/implementations/edit-document.d.ts +8 -0
  628. package/dist/tools/implementations/edit-document.d.ts.map +1 -0
  629. package/dist/tools/implementations/edit-document.js +118 -0
  630. package/dist/tools/implementations/edit-document.js.map +1 -0
  631. package/dist/tools/implementations/get-guide.d.ts +13 -0
  632. package/dist/tools/implementations/get-guide.d.ts.map +1 -0
  633. package/dist/tools/implementations/get-guide.js +64 -0
  634. package/dist/tools/implementations/get-guide.js.map +1 -0
  635. package/dist/tools/implementations/get-workflow.d.ts +12 -0
  636. package/dist/tools/implementations/get-workflow.d.ts.map +1 -0
  637. package/dist/tools/implementations/get-workflow.js +71 -0
  638. package/dist/tools/implementations/get-workflow.js.map +1 -0
  639. package/dist/tools/implementations/index.d.ts +24 -0
  640. package/dist/tools/implementations/index.d.ts.map +1 -0
  641. package/dist/tools/implementations/index.js +24 -0
  642. package/dist/tools/implementations/index.js.map +1 -0
  643. package/dist/tools/implementations/manage-document.d.ts +8 -0
  644. package/dist/tools/implementations/manage-document.d.ts.map +1 -0
  645. package/dist/tools/implementations/manage-document.js +180 -0
  646. package/dist/tools/implementations/manage-document.js.map +1 -0
  647. package/dist/tools/implementations/move-document.d.ts +12 -0
  648. package/dist/tools/implementations/move-document.d.ts.map +1 -0
  649. package/dist/tools/implementations/move-document.js +72 -0
  650. package/dist/tools/implementations/move-document.js.map +1 -0
  651. package/dist/tools/implementations/move.d.ts +24 -0
  652. package/dist/tools/implementations/move.d.ts.map +1 -0
  653. package/dist/tools/implementations/move.js +167 -0
  654. package/dist/tools/implementations/move.js.map +1 -0
  655. package/dist/tools/implementations/search-documents.d.ts +39 -0
  656. package/dist/tools/implementations/search-documents.d.ts.map +1 -0
  657. package/dist/tools/implementations/search-documents.js +246 -0
  658. package/dist/tools/implementations/search-documents.js.map +1 -0
  659. package/dist/tools/implementations/section.d.ts +42 -0
  660. package/dist/tools/implementations/section.d.ts.map +1 -0
  661. package/dist/tools/implementations/section.hierarchical.test.d.ts +8 -0
  662. package/dist/tools/implementations/section.hierarchical.test.d.ts.map +1 -0
  663. package/dist/tools/implementations/section.hierarchical.test.js +299 -0
  664. package/dist/tools/implementations/section.hierarchical.test.js.map +1 -0
  665. package/dist/tools/implementations/section.js +244 -0
  666. package/dist/tools/implementations/section.js.map +1 -0
  667. package/dist/tools/implementations/section.test.d.ts +5 -0
  668. package/dist/tools/implementations/section.test.d.ts.map +1 -0
  669. package/dist/tools/implementations/section.test.js +371 -0
  670. package/dist/tools/implementations/section.test.js.map +1 -0
  671. package/dist/tools/implementations/start-coordinator-task.d.ts +44 -0
  672. package/dist/tools/implementations/start-coordinator-task.d.ts.map +1 -0
  673. package/dist/tools/implementations/start-coordinator-task.js +125 -0
  674. package/dist/tools/implementations/start-coordinator-task.js.map +1 -0
  675. package/dist/tools/implementations/start-subagent-task.d.ts +53 -0
  676. package/dist/tools/implementations/start-subagent-task.d.ts.map +1 -0
  677. package/dist/tools/implementations/start-subagent-task.js +179 -0
  678. package/dist/tools/implementations/start-subagent-task.js.map +1 -0
  679. package/dist/tools/implementations/start-task.d.ts +48 -0
  680. package/dist/tools/implementations/start-task.d.ts.map +1 -0
  681. package/dist/tools/implementations/start-task.js +216 -0
  682. package/dist/tools/implementations/start-task.js.map +1 -0
  683. package/dist/tools/implementations/subagent-task.d.ts +98 -0
  684. package/dist/tools/implementations/subagent-task.d.ts.map +1 -0
  685. package/dist/tools/implementations/subagent-task.js +277 -0
  686. package/dist/tools/implementations/subagent-task.js.map +1 -0
  687. package/dist/tools/implementations/task.d.ts +97 -0
  688. package/dist/tools/implementations/task.d.ts.map +1 -0
  689. package/dist/tools/implementations/task.hierarchical.test.d.ts +8 -0
  690. package/dist/tools/implementations/task.hierarchical.test.d.ts.map +1 -0
  691. package/dist/tools/implementations/task.hierarchical.test.js +333 -0
  692. package/dist/tools/implementations/task.hierarchical.test.js.map +1 -0
  693. package/dist/tools/implementations/task.js +235 -0
  694. package/dist/tools/implementations/task.js.map +1 -0
  695. package/dist/tools/implementations/view-coordinator-task.d.ts +61 -0
  696. package/dist/tools/implementations/view-coordinator-task.d.ts.map +1 -0
  697. package/dist/tools/implementations/view-coordinator-task.js +295 -0
  698. package/dist/tools/implementations/view-coordinator-task.js.map +1 -0
  699. package/dist/tools/implementations/view-document.d.ts +84 -0
  700. package/dist/tools/implementations/view-document.d.ts.map +1 -0
  701. package/dist/tools/implementations/view-document.js +287 -0
  702. package/dist/tools/implementations/view-document.js.map +1 -0
  703. package/dist/tools/implementations/view-section.d.ts +28 -0
  704. package/dist/tools/implementations/view-section.d.ts.map +1 -0
  705. package/dist/tools/implementations/view-section.hierarchical.test.d.ts +8 -0
  706. package/dist/tools/implementations/view-section.hierarchical.test.d.ts.map +1 -0
  707. package/dist/tools/implementations/view-section.hierarchical.test.js +318 -0
  708. package/dist/tools/implementations/view-section.hierarchical.test.js.map +1 -0
  709. package/dist/tools/implementations/view-section.js +167 -0
  710. package/dist/tools/implementations/view-section.js.map +1 -0
  711. package/dist/tools/implementations/view-subagent-task.d.ts +46 -0
  712. package/dist/tools/implementations/view-subagent-task.d.ts.map +1 -0
  713. package/dist/tools/implementations/view-subagent-task.js +283 -0
  714. package/dist/tools/implementations/view-subagent-task.js.map +1 -0
  715. package/dist/tools/implementations/view-task.d.ts +43 -0
  716. package/dist/tools/implementations/view-task.d.ts.map +1 -0
  717. package/dist/tools/implementations/view-task.hierarchical.test.d.ts +8 -0
  718. package/dist/tools/implementations/view-task.hierarchical.test.d.ts.map +1 -0
  719. package/dist/tools/implementations/view-task.hierarchical.test.js +420 -0
  720. package/dist/tools/implementations/view-task.hierarchical.test.js.map +1 -0
  721. package/dist/tools/implementations/view-task.js +280 -0
  722. package/dist/tools/implementations/view-task.js.map +1 -0
  723. package/dist/tools/index.d.ts +6 -0
  724. package/dist/tools/index.d.ts.map +1 -0
  725. package/dist/tools/index.js +6 -0
  726. package/dist/tools/index.js.map +1 -0
  727. package/dist/tools/registry.d.ts +10 -0
  728. package/dist/tools/registry.d.ts.map +1 -0
  729. package/dist/tools/registry.js +132 -0
  730. package/dist/tools/registry.js.map +1 -0
  731. package/dist/tools/schemas/__tests__/get-guide-schemas.test.d.ts +8 -0
  732. package/dist/tools/schemas/__tests__/get-guide-schemas.test.d.ts.map +1 -0
  733. package/dist/tools/schemas/__tests__/get-guide-schemas.test.js +216 -0
  734. package/dist/tools/schemas/__tests__/get-guide-schemas.test.js.map +1 -0
  735. package/dist/tools/schemas/__tests__/get-workflow-schemas.test.d.ts +8 -0
  736. package/dist/tools/schemas/__tests__/get-workflow-schemas.test.d.ts.map +1 -0
  737. package/dist/tools/schemas/__tests__/get-workflow-schemas.test.js +229 -0
  738. package/dist/tools/schemas/__tests__/get-workflow-schemas.test.js.map +1 -0
  739. package/dist/tools/schemas/browse-documents-schemas.d.ts +47 -0
  740. package/dist/tools/schemas/browse-documents-schemas.d.ts.map +1 -0
  741. package/dist/tools/schemas/browse-documents-schemas.js +48 -0
  742. package/dist/tools/schemas/browse-documents-schemas.js.map +1 -0
  743. package/dist/tools/schemas/complete-coordinator-task-schemas.d.ts +41 -0
  744. package/dist/tools/schemas/complete-coordinator-task-schemas.d.ts.map +1 -0
  745. package/dist/tools/schemas/complete-coordinator-task-schemas.js +42 -0
  746. package/dist/tools/schemas/complete-coordinator-task-schemas.js.map +1 -0
  747. package/dist/tools/schemas/complete-subagent-task-schemas.d.ts +38 -0
  748. package/dist/tools/schemas/complete-subagent-task-schemas.d.ts.map +1 -0
  749. package/dist/tools/schemas/complete-subagent-task-schemas.js +41 -0
  750. package/dist/tools/schemas/complete-subagent-task-schemas.js.map +1 -0
  751. package/dist/tools/schemas/complete-task-schemas.d.ts +33 -0
  752. package/dist/tools/schemas/complete-task-schemas.d.ts.map +1 -0
  753. package/dist/tools/schemas/complete-task-schemas.js +36 -0
  754. package/dist/tools/schemas/complete-task-schemas.js.map +1 -0
  755. package/dist/tools/schemas/continue-task-schemas.d.ts +27 -0
  756. package/dist/tools/schemas/continue-task-schemas.d.ts.map +1 -0
  757. package/dist/tools/schemas/continue-task-schemas.js +28 -0
  758. package/dist/tools/schemas/continue-task-schemas.js.map +1 -0
  759. package/dist/tools/schemas/coordinator-task-schemas.d.ts +87 -0
  760. package/dist/tools/schemas/coordinator-task-schemas.d.ts.map +1 -0
  761. package/dist/tools/schemas/coordinator-task-schemas.js +80 -0
  762. package/dist/tools/schemas/coordinator-task-schemas.js.map +1 -0
  763. package/dist/tools/schemas/create-document-schemas.d.ts +61 -0
  764. package/dist/tools/schemas/create-document-schemas.d.ts.map +1 -0
  765. package/dist/tools/schemas/create-document-schemas.js +143 -0
  766. package/dist/tools/schemas/create-document-schemas.js.map +1 -0
  767. package/dist/tools/schemas/delete-document-schemas.d.ts +24 -0
  768. package/dist/tools/schemas/delete-document-schemas.d.ts.map +1 -0
  769. package/dist/tools/schemas/delete-document-schemas.js +25 -0
  770. package/dist/tools/schemas/delete-document-schemas.js.map +1 -0
  771. package/dist/tools/schemas/edit-document-schemas.d.ts +27 -0
  772. package/dist/tools/schemas/edit-document-schemas.d.ts.map +1 -0
  773. package/dist/tools/schemas/edit-document-schemas.js +28 -0
  774. package/dist/tools/schemas/edit-document-schemas.js.map +1 -0
  775. package/dist/tools/schemas/get-guide-schemas.d.ts +35 -0
  776. package/dist/tools/schemas/get-guide-schemas.d.ts.map +1 -0
  777. package/dist/tools/schemas/get-guide-schemas.js +66 -0
  778. package/dist/tools/schemas/get-guide-schemas.js.map +1 -0
  779. package/dist/tools/schemas/get-workflow-schemas.d.ts +35 -0
  780. package/dist/tools/schemas/get-workflow-schemas.d.ts.map +1 -0
  781. package/dist/tools/schemas/get-workflow-schemas.js +67 -0
  782. package/dist/tools/schemas/get-workflow-schemas.js.map +1 -0
  783. package/dist/tools/schemas/manage-document-schemas.d.ts +59 -0
  784. package/dist/tools/schemas/manage-document-schemas.d.ts.map +1 -0
  785. package/dist/tools/schemas/manage-document-schemas.js +83 -0
  786. package/dist/tools/schemas/manage-document-schemas.js.map +1 -0
  787. package/dist/tools/schemas/move-document-schemas.d.ts +25 -0
  788. package/dist/tools/schemas/move-document-schemas.d.ts.map +1 -0
  789. package/dist/tools/schemas/move-document-schemas.js +26 -0
  790. package/dist/tools/schemas/move-document-schemas.js.map +1 -0
  791. package/dist/tools/schemas/move-schemas.d.ts +43 -0
  792. package/dist/tools/schemas/move-schemas.d.ts.map +1 -0
  793. package/dist/tools/schemas/move-schemas.js +43 -0
  794. package/dist/tools/schemas/move-schemas.js.map +1 -0
  795. package/dist/tools/schemas/search-documents-schemas.d.ts +77 -0
  796. package/dist/tools/schemas/search-documents-schemas.d.ts.map +1 -0
  797. package/dist/tools/schemas/search-documents-schemas.js +78 -0
  798. package/dist/tools/schemas/search-documents-schemas.js.map +1 -0
  799. package/dist/tools/schemas/section-schemas.d.ts +361 -0
  800. package/dist/tools/schemas/section-schemas.d.ts.map +1 -0
  801. package/dist/tools/schemas/section-schemas.js +182 -0
  802. package/dist/tools/schemas/section-schemas.js.map +1 -0
  803. package/dist/tools/schemas/start-coordinator-task-schemas.d.ts +30 -0
  804. package/dist/tools/schemas/start-coordinator-task-schemas.d.ts.map +1 -0
  805. package/dist/tools/schemas/start-coordinator-task-schemas.js +31 -0
  806. package/dist/tools/schemas/start-coordinator-task-schemas.js.map +1 -0
  807. package/dist/tools/schemas/start-subagent-task-schemas.d.ts +29 -0
  808. package/dist/tools/schemas/start-subagent-task-schemas.d.ts.map +1 -0
  809. package/dist/tools/schemas/start-subagent-task-schemas.js +40 -0
  810. package/dist/tools/schemas/start-subagent-task-schemas.js.map +1 -0
  811. package/dist/tools/schemas/start-task-schemas.d.ts +23 -0
  812. package/dist/tools/schemas/start-task-schemas.d.ts.map +1 -0
  813. package/dist/tools/schemas/start-task-schemas.js +39 -0
  814. package/dist/tools/schemas/start-task-schemas.js.map +1 -0
  815. package/dist/tools/schemas/subagent-task-schemas.d.ts +93 -0
  816. package/dist/tools/schemas/subagent-task-schemas.d.ts.map +1 -0
  817. package/dist/tools/schemas/subagent-task-schemas.js +81 -0
  818. package/dist/tools/schemas/subagent-task-schemas.js.map +1 -0
  819. package/dist/tools/schemas/task-schemas.d.ts +88 -0
  820. package/dist/tools/schemas/task-schemas.d.ts.map +1 -0
  821. package/dist/tools/schemas/task-schemas.js +80 -0
  822. package/dist/tools/schemas/task-schemas.js.map +1 -0
  823. package/dist/tools/schemas/view-coordinator-task-schemas.d.ts +27 -0
  824. package/dist/tools/schemas/view-coordinator-task-schemas.d.ts.map +1 -0
  825. package/dist/tools/schemas/view-coordinator-task-schemas.js +46 -0
  826. package/dist/tools/schemas/view-coordinator-task-schemas.js.map +1 -0
  827. package/dist/tools/schemas/view-document-schemas.d.ts +152 -0
  828. package/dist/tools/schemas/view-document-schemas.d.ts.map +1 -0
  829. package/dist/tools/schemas/view-document-schemas.js +70 -0
  830. package/dist/tools/schemas/view-document-schemas.js.map +1 -0
  831. package/dist/tools/schemas/view-section-schemas.d.ts +31 -0
  832. package/dist/tools/schemas/view-section-schemas.d.ts.map +1 -0
  833. package/dist/tools/schemas/view-section-schemas.js +56 -0
  834. package/dist/tools/schemas/view-section-schemas.js.map +1 -0
  835. package/dist/tools/schemas/view-subagent-task-schemas.d.ts +31 -0
  836. package/dist/tools/schemas/view-subagent-task-schemas.d.ts.map +1 -0
  837. package/dist/tools/schemas/view-subagent-task-schemas.js +65 -0
  838. package/dist/tools/schemas/view-subagent-task-schemas.js.map +1 -0
  839. package/dist/tools/schemas/view-task-schemas.d.ts +31 -0
  840. package/dist/tools/schemas/view-task-schemas.d.ts.map +1 -0
  841. package/dist/tools/schemas/view-task-schemas.js +62 -0
  842. package/dist/tools/schemas/view-task-schemas.js.map +1 -0
  843. package/dist/tools/types.d.ts +98 -0
  844. package/dist/tools/types.d.ts.map +1 -0
  845. package/dist/tools/types.js +9 -0
  846. package/dist/tools/types.js.map +1 -0
  847. package/dist/tools-manager.d.ts +8 -0
  848. package/dist/tools-manager.d.ts.map +1 -0
  849. package/dist/tools-manager.js +9 -0
  850. package/dist/tools-manager.js.map +1 -0
  851. package/dist/types/core.d.ts +71 -0
  852. package/dist/types/core.d.ts.map +1 -0
  853. package/dist/types/core.js +5 -0
  854. package/dist/types/core.js.map +1 -0
  855. package/dist/types/index.d.ts +5 -0
  856. package/dist/types/index.d.ts.map +1 -0
  857. package/dist/types/index.js +5 -0
  858. package/dist/types/index.js.map +1 -0
  859. package/dist/types/linking.d.ts +97 -0
  860. package/dist/types/linking.d.ts.map +1 -0
  861. package/dist/types/linking.js +5 -0
  862. package/dist/types/linking.js.map +1 -0
  863. package/dist/utils/__tests__/path-handler.archive.test.d.ts +8 -0
  864. package/dist/utils/__tests__/path-handler.archive.test.d.ts.map +1 -0
  865. package/dist/utils/__tests__/path-handler.archive.test.js +163 -0
  866. package/dist/utils/__tests__/path-handler.archive.test.js.map +1 -0
  867. package/dist/utils/error-formatter.d.ts +32 -0
  868. package/dist/utils/error-formatter.d.ts.map +1 -0
  869. package/dist/utils/error-formatter.js +79 -0
  870. package/dist/utils/error-formatter.js.map +1 -0
  871. package/dist/utils/logger.d.ts +21 -0
  872. package/dist/utils/logger.d.ts.map +1 -0
  873. package/dist/utils/logger.js +154 -0
  874. package/dist/utils/logger.js.map +1 -0
  875. package/dist/utils/path-handler.d.ts +52 -0
  876. package/dist/utils/path-handler.d.ts.map +1 -0
  877. package/dist/utils/path-handler.js +129 -0
  878. package/dist/utils/path-handler.js.map +1 -0
  879. package/dist/utils/security-audit-logger.d.ts +64 -0
  880. package/dist/utils/security-audit-logger.d.ts.map +1 -0
  881. package/dist/utils/security-audit-logger.js +56 -0
  882. package/dist/utils/security-audit-logger.js.map +1 -0
  883. package/dist/utils/virtual-path-resolver.d.ts +126 -0
  884. package/dist/utils/virtual-path-resolver.d.ts.map +1 -0
  885. package/dist/utils/virtual-path-resolver.js +171 -0
  886. package/dist/utils/virtual-path-resolver.js.map +1 -0
  887. package/package.json +82 -0
@@ -0,0 +1,508 @@
1
+ /**
2
+ * Integration tests for Suggestion Generator (Stage 2.5)
3
+ *
4
+ * Tests the complete Smart Suggestions workflow including related document discovery,
5
+ * broken reference detection, and error handling scenarios.
6
+ */
7
+ import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
8
+ import { promises as fs } from 'node:fs';
9
+ import path from 'node:path';
10
+ import os from 'node:os';
11
+ import { processSuggestions } from '../create/suggestion-generator.js';
12
+ // Mock the utilities module
13
+ vi.mock('../../shared/utilities.js', () => ({
14
+ getDocumentManager: vi.fn(),
15
+ analyzeDocumentSuggestions: vi.fn(),
16
+ analyzeNamespacePatterns: vi.fn()
17
+ }));
18
+ import { getDocumentManager, analyzeDocumentSuggestions, analyzeNamespacePatterns } from '../../shared/utilities.js';
19
+ // Type the mocked functions
20
+ const mockGetDocumentManager = getDocumentManager;
21
+ const mockAnalyzeDocumentSuggestions = analyzeDocumentSuggestions;
22
+ const mockAnalyzeNamespacePatterns = analyzeNamespacePatterns;
23
+ // Helper function to create mock document manager
24
+ const createMockDocumentManager = () => {
25
+ return {
26
+ listDocuments: vi.fn(),
27
+ getDocument: vi.fn(),
28
+ getDocumentContent: vi.fn(),
29
+ getSectionContent: vi.fn(),
30
+ addDocument: vi.fn(),
31
+ updateDocument: vi.fn(),
32
+ deleteDocument: vi.fn(),
33
+ archiveDocument: vi.fn(),
34
+ createSection: vi.fn(),
35
+ updateSection: vi.fn(),
36
+ deleteSection: vi.fn(),
37
+ moveDocument: vi.fn(),
38
+ renameDocument: vi.fn()
39
+ };
40
+ };
41
+ // Helper function to create mock SmartSuggestions
42
+ const createMockSmartSuggestions = (overrides = {}) => ({
43
+ related_documents: [
44
+ {
45
+ path: '/api/auth.md',
46
+ title: 'Authentication API',
47
+ namespace: 'api',
48
+ reason: 'Related documentation in api',
49
+ relevance: 0.8
50
+ },
51
+ {
52
+ path: '/api/users.md',
53
+ title: 'User Management API',
54
+ namespace: 'api',
55
+ reason: 'Related documentation in api',
56
+ relevance: 0.6
57
+ }
58
+ ],
59
+ broken_references: [
60
+ {
61
+ reference: '@/missing/doc.md',
62
+ type: 'missing_document',
63
+ documentPath: '/missing/doc.md',
64
+ reason: 'Document not found: /missing/doc.md'
65
+ },
66
+ {
67
+ reference: '@/another/missing.md',
68
+ type: 'missing_document',
69
+ documentPath: '/another/missing.md',
70
+ reason: 'Document not found: /another/missing.md'
71
+ }
72
+ ],
73
+ ...overrides
74
+ });
75
+ // Helper function to create mock namespace patterns
76
+ const createMockNamespacePatterns = () => ({
77
+ common_sections: ['Overview', 'Getting Started', 'API Reference'],
78
+ frequent_links: ['/api/auth.md', '/guides/setup.md'],
79
+ typical_tasks: ['Setup authentication', 'Configure API endpoints']
80
+ });
81
+ describe('Suggestion Generator (Stage 2.5)', () => {
82
+ let mockManager;
83
+ let tempDir;
84
+ beforeEach(async () => {
85
+ // Create temporary directory for test files
86
+ tempDir = await fs.mkdtemp(path.join(os.tmpdir(), 'suggestion-generator-test-'));
87
+ // Configure MCP_WORKSPACE_PATH for fsio PathHandler to use temp directory
88
+ process.env['MCP_WORKSPACE_PATH'] = tempDir;
89
+ mockManager = createMockDocumentManager();
90
+ vi.clearAllMocks();
91
+ // Default successful mocks
92
+ mockGetDocumentManager.mockResolvedValue(mockManager);
93
+ mockAnalyzeDocumentSuggestions.mockResolvedValue(createMockSmartSuggestions());
94
+ mockAnalyzeNamespacePatterns.mockResolvedValue(createMockNamespacePatterns());
95
+ });
96
+ afterEach(async () => {
97
+ // Clean up temporary directory and all its contents
98
+ try {
99
+ await fs.rm(tempDir, { recursive: true, force: true });
100
+ }
101
+ catch {
102
+ // Ignore if directory doesn't exist
103
+ }
104
+ });
105
+ describe('processSuggestions', () => {
106
+ it('should return smart suggestions result with related documents', async () => {
107
+ const result = await processSuggestions('api/specs', 'User Authentication API', 'API for handling user login and session management');
108
+ expect(result.stage).toBe('smart_suggestions');
109
+ expect(result).toHaveProperty('suggestions');
110
+ expect(result).toHaveProperty('namespace_patterns');
111
+ expect(result).toHaveProperty('next_step');
112
+ expect(result).toHaveProperty('example');
113
+ // Verify the result has the expected structure
114
+ const smartResult = result;
115
+ expect(smartResult.suggestions.related_documents).toHaveLength(2);
116
+ expect(smartResult.suggestions.broken_references).toHaveLength(2);
117
+ expect(smartResult.namespace_patterns.common_sections).toContain('Overview');
118
+ // Verify example structure
119
+ expect(smartResult.example).toEqual({
120
+ namespace: 'api/specs',
121
+ title: 'User Authentication API',
122
+ overview: 'API for handling user login and session management',
123
+ create: true
124
+ });
125
+ expect(smartResult.next_step).toContain("create: true");
126
+ });
127
+ it('should include both related documents and broken references', async () => {
128
+ const mockSuggestions = createMockSmartSuggestions({
129
+ related_documents: [
130
+ {
131
+ path: '/api/auth.md',
132
+ title: 'Authentication Guide',
133
+ namespace: 'api',
134
+ reason: 'Shares authentication keywords',
135
+ relevance: 0.9
136
+ }
137
+ ],
138
+ broken_references: [
139
+ {
140
+ reference: '@/missing/reference.md',
141
+ type: 'missing_document',
142
+ documentPath: '/missing/reference.md',
143
+ reason: 'Document not found: /missing/reference.md'
144
+ }
145
+ ]
146
+ });
147
+ mockAnalyzeDocumentSuggestions.mockResolvedValue(mockSuggestions);
148
+ const result = await processSuggestions('api', 'JWT Authentication', 'JWT token-based authentication system');
149
+ const smartResult = result;
150
+ // Verify related documents
151
+ expect(smartResult.suggestions.related_documents).toHaveLength(1);
152
+ expect(smartResult.suggestions.related_documents[0]?.title).toBe('Authentication Guide');
153
+ expect(smartResult.suggestions.related_documents[0]?.relevance).toBe(0.9);
154
+ // Verify broken references
155
+ expect(smartResult.suggestions.broken_references).toHaveLength(1);
156
+ expect(smartResult.suggestions.broken_references[0]).toEqual(expect.objectContaining({
157
+ reference: '@/missing/reference.md',
158
+ type: 'missing_document',
159
+ documentPath: '/missing/reference.md',
160
+ reason: expect.stringContaining('Document not found')
161
+ }));
162
+ });
163
+ it('should handle empty suggestions gracefully', async () => {
164
+ const emptyMockSuggestions = createMockSmartSuggestions({
165
+ related_documents: [],
166
+ broken_references: []
167
+ });
168
+ mockAnalyzeDocumentSuggestions.mockResolvedValue(emptyMockSuggestions);
169
+ const result = await processSuggestions('new-namespace', 'First Document', 'Starting a new documentation namespace');
170
+ const smartResult = result;
171
+ expect(smartResult.suggestions.related_documents).toEqual([]);
172
+ expect(smartResult.suggestions.broken_references).toEqual([]);
173
+ expect(smartResult.stage).toBe('smart_suggestions');
174
+ });
175
+ it('should run suggestions and namespace analysis in parallel', async () => {
176
+ const startTime = Date.now();
177
+ // Add artificial delays to verify parallel execution
178
+ mockAnalyzeDocumentSuggestions.mockImplementation(async () => {
179
+ await new Promise(resolve => setTimeout(resolve, 50));
180
+ return createMockSmartSuggestions();
181
+ });
182
+ mockAnalyzeNamespacePatterns.mockImplementation(async () => {
183
+ await new Promise(resolve => setTimeout(resolve, 50));
184
+ return createMockNamespacePatterns();
185
+ });
186
+ await processSuggestions('api', 'Test', 'Test overview');
187
+ const duration = Date.now() - startTime;
188
+ // Should complete in less time than sequential execution (100ms vs 50ms)
189
+ expect(duration).toBeLessThan(100);
190
+ // Verify both functions were called
191
+ expect(mockAnalyzeDocumentSuggestions).toHaveBeenCalledWith(mockManager, 'api', 'Test', 'Test overview');
192
+ expect(mockAnalyzeNamespacePatterns).toHaveBeenCalledWith(mockManager, 'api');
193
+ });
194
+ it('should include namespace patterns in result', async () => {
195
+ const customNamespacePatterns = {
196
+ common_sections: ['Custom Section', 'Special Overview'],
197
+ frequent_links: ['/custom/path.md'],
198
+ typical_tasks: ['Custom task']
199
+ };
200
+ mockAnalyzeNamespacePatterns.mockResolvedValue(customNamespacePatterns);
201
+ const result = await processSuggestions('custom', 'Custom Document', 'Custom overview');
202
+ const smartResult = result;
203
+ expect(smartResult.namespace_patterns).toEqual(customNamespacePatterns);
204
+ });
205
+ });
206
+ describe('error handling', () => {
207
+ it('should return error result when document manager fails', async () => {
208
+ mockGetDocumentManager.mockRejectedValue(new Error('Document manager initialization failed'));
209
+ const result = await processSuggestions('api', 'Test Document', 'Test overview');
210
+ expect(result.stage).toBe('error_fallback');
211
+ const errorResult = result;
212
+ expect(errorResult.error).toBe('Failed to analyze suggestions');
213
+ expect(errorResult.details).toContain('Document manager initialization failed');
214
+ expect(errorResult.provided_parameters).toEqual({
215
+ namespace: 'api',
216
+ title: 'Test Document',
217
+ overview: 'Test overview'
218
+ });
219
+ });
220
+ it('should return error result when document suggestions analysis fails', async () => {
221
+ mockAnalyzeDocumentSuggestions.mockRejectedValue(new Error('Suggestions analysis failed'));
222
+ const result = await processSuggestions('api', 'Test Document', 'Test overview');
223
+ expect(result.stage).toBe('error_fallback');
224
+ const errorResult = result;
225
+ expect(errorResult.error).toBe('Failed to analyze suggestions');
226
+ expect(errorResult.details).toContain('Suggestions analysis failed');
227
+ });
228
+ it('should return error result when namespace patterns analysis fails', async () => {
229
+ mockAnalyzeNamespacePatterns.mockRejectedValue(new Error('Namespace analysis failed'));
230
+ const result = await processSuggestions('api', 'Test Document', 'Test overview');
231
+ expect(result.stage).toBe('error_fallback');
232
+ const errorResult = result;
233
+ expect(errorResult.details).toContain('Namespace analysis failed');
234
+ });
235
+ it('should provide helpful recovery steps in error result', async () => {
236
+ mockGetDocumentManager.mockRejectedValue(new Error('Connection failed'));
237
+ const result = await processSuggestions('api', 'Test Document', 'Test overview');
238
+ const errorResult = result;
239
+ expect(errorResult.help).toContain('You can still proceed with document creation');
240
+ expect(errorResult.recovery_steps).toContain("Call again with 'create: true' to skip suggestions and create the document");
241
+ expect(errorResult.recovery_steps).toContain('Check that the namespace, title, and overview are valid');
242
+ // Should provide a valid example for recovery
243
+ expect(errorResult.example).toEqual({
244
+ namespace: 'api',
245
+ title: 'Test Document',
246
+ overview: 'Test overview',
247
+ create: true
248
+ });
249
+ });
250
+ it('should handle non-Error thrown objects gracefully', async () => {
251
+ mockAnalyzeDocumentSuggestions.mockRejectedValue('String error');
252
+ const result = await processSuggestions('api', 'Test Document', 'Test overview');
253
+ const errorResult = result;
254
+ expect(errorResult.details).toBe('String error');
255
+ });
256
+ it('should preserve original parameters in error result', async () => {
257
+ mockGetDocumentManager.mockRejectedValue(new Error('Test error'));
258
+ const namespace = 'complex/nested/namespace';
259
+ const title = 'Complex Document Title';
260
+ const overview = 'Complex overview with special characters @#$%';
261
+ const result = await processSuggestions(namespace, title, overview);
262
+ const errorResult = result;
263
+ expect(errorResult.provided_parameters).toEqual({
264
+ namespace,
265
+ title,
266
+ overview
267
+ });
268
+ expect(errorResult.example).toEqual({
269
+ namespace,
270
+ title,
271
+ overview,
272
+ create: true
273
+ });
274
+ });
275
+ });
276
+ describe('integration scenarios', () => {
277
+ it('should handle real-world document analysis scenario', async () => {
278
+ // Simulate a realistic scenario with multiple related docs and some broken refs
279
+ const realisticSuggestions = createMockSmartSuggestions({
280
+ related_documents: [
281
+ {
282
+ path: '/api/auth/oauth.md',
283
+ title: 'OAuth 2.0 Implementation',
284
+ namespace: 'api/auth',
285
+ reason: 'Shares authentication and OAuth keywords',
286
+ relevance: 0.95
287
+ },
288
+ {
289
+ path: '/api/auth/jwt.md',
290
+ title: 'JWT Token Management',
291
+ namespace: 'api/auth',
292
+ reason: 'Related authentication documentation',
293
+ relevance: 0.87
294
+ },
295
+ {
296
+ path: '/guides/security.md',
297
+ title: 'Security Best Practices',
298
+ namespace: 'guides',
299
+ reason: 'Related security documentation',
300
+ relevance: 0.43
301
+ }
302
+ ],
303
+ broken_references: [
304
+ {
305
+ reference: '@/api/auth/deprecated-flow.md',
306
+ type: 'missing_document',
307
+ documentPath: '/api/auth/deprecated-flow.md',
308
+ reason: 'Document not found: /api/auth/deprecated-flow.md'
309
+ },
310
+ {
311
+ reference: '@/config/oauth-settings.md',
312
+ type: 'missing_document',
313
+ documentPath: '/config/oauth-settings.md',
314
+ reason: 'Document not found: /config/oauth-settings.md'
315
+ }
316
+ ]
317
+ });
318
+ const realisticNamespacePatterns = {
319
+ common_sections: ['Configuration', 'Examples', 'Troubleshooting'],
320
+ frequent_links: ['/api/auth/oauth.md', '/guides/security.md'],
321
+ typical_tasks: ['Setup OAuth flow', 'Configure JWT validation', 'Handle token refresh']
322
+ };
323
+ mockAnalyzeDocumentSuggestions.mockResolvedValue(realisticSuggestions);
324
+ mockAnalyzeNamespacePatterns.mockResolvedValue(realisticNamespacePatterns);
325
+ const result = await processSuggestions('api/auth', 'OAuth 2.0 Client Authentication', 'Implementation guide for OAuth 2.0 client authentication flow with JWT tokens');
326
+ const smartResult = result;
327
+ // Verify comprehensive suggestions
328
+ expect(smartResult.suggestions.related_documents).toHaveLength(3);
329
+ expect(smartResult.suggestions.broken_references).toHaveLength(2);
330
+ // Verify high-relevance docs are included
331
+ const oauthDoc = smartResult.suggestions.related_documents.find(doc => doc.path === '/api/auth/oauth.md');
332
+ expect(oauthDoc?.relevance).toBeGreaterThan(0.9);
333
+ // Verify namespace patterns are meaningful
334
+ expect(smartResult.namespace_patterns.typical_tasks).toContain('Setup OAuth flow');
335
+ });
336
+ it('should handle namespace with no existing documents', async () => {
337
+ const emptySuggestions = createMockSmartSuggestions({
338
+ related_documents: [],
339
+ broken_references: []
340
+ });
341
+ const emptyNamespacePatterns = {
342
+ common_sections: [],
343
+ frequent_links: [],
344
+ typical_tasks: []
345
+ };
346
+ mockAnalyzeDocumentSuggestions.mockResolvedValue(emptySuggestions);
347
+ mockAnalyzeNamespacePatterns.mockResolvedValue(emptyNamespacePatterns);
348
+ const result = await processSuggestions('brand-new-namespace', 'First Document Ever', 'Starting completely fresh documentation');
349
+ const smartResult = result;
350
+ expect(smartResult.suggestions.related_documents).toEqual([]);
351
+ expect(smartResult.suggestions.broken_references).toEqual([]);
352
+ expect(smartResult.namespace_patterns.common_sections).toEqual([]);
353
+ // Should still provide valid guidance
354
+ expect(smartResult.next_step).toContain("create: true");
355
+ });
356
+ it('should handle complex broken references scenario', async () => {
357
+ const complexBrokenRefs = createMockSmartSuggestions({
358
+ related_documents: [],
359
+ broken_references: [
360
+ {
361
+ reference: '@/api/v1/deprecated.md',
362
+ type: 'missing_document',
363
+ documentPath: '/api/v1/deprecated.md',
364
+ reason: 'Document not found: /api/v1/deprecated.md'
365
+ },
366
+ {
367
+ reference: '@/config/old-settings.md',
368
+ type: 'missing_document',
369
+ documentPath: '/config/old-settings.md',
370
+ reason: 'Document not found: /config/old-settings.md'
371
+ },
372
+ {
373
+ reference: '@/guides/outdated-tutorial.md',
374
+ type: 'missing_document',
375
+ documentPath: '/guides/outdated-tutorial.md',
376
+ reason: 'Document not found: /guides/outdated-tutorial.md'
377
+ },
378
+ {
379
+ reference: '@missing-entirely.md',
380
+ type: 'missing_document',
381
+ documentPath: '/missing-entirely.md',
382
+ reason: 'Document not found: /missing-entirely.md'
383
+ },
384
+ {
385
+ reference: '@/api/auth.md#nonexistent-section',
386
+ type: 'missing_section',
387
+ documentPath: '/api/auth.md',
388
+ sectionSlug: 'nonexistent-section',
389
+ reason: "Section 'nonexistent-section' not found in document /api/auth.md"
390
+ }
391
+ ]
392
+ });
393
+ mockAnalyzeDocumentSuggestions.mockResolvedValue(complexBrokenRefs);
394
+ const result = await processSuggestions('api', 'Migration Guide', 'Guide for migrating from old API to new. See @/api/v1/deprecated.md and @missing-entirely.md');
395
+ const smartResult = result;
396
+ expect(smartResult.suggestions.broken_references).toHaveLength(5);
397
+ // Check specific references by their text
398
+ const brokenRefTexts = smartResult.suggestions.broken_references.map(ref => ref.reference);
399
+ expect(brokenRefTexts).toContain('@/api/v1/deprecated.md');
400
+ expect(brokenRefTexts).toContain('@missing-entirely.md');
401
+ // Verify structure of section-specific broken reference
402
+ const sectionRef = smartResult.suggestions.broken_references.find(ref => ref.reference === '@/api/auth.md#nonexistent-section');
403
+ expect(sectionRef).toEqual(expect.objectContaining({
404
+ reference: '@/api/auth.md#nonexistent-section',
405
+ type: 'missing_section',
406
+ documentPath: '/api/auth.md',
407
+ sectionSlug: 'nonexistent-section',
408
+ reason: expect.stringContaining('Section \'nonexistent-section\' not found')
409
+ }));
410
+ });
411
+ it('should validate comprehensive BrokenReference structure integration', async () => {
412
+ // Test that the integration properly handles all BrokenReference types implemented in Stage 3
413
+ const comprehensiveBrokenRefs = createMockSmartSuggestions({
414
+ related_documents: [],
415
+ broken_references: [
416
+ // Missing document type
417
+ {
418
+ reference: '@/missing/document.md',
419
+ type: 'missing_document',
420
+ documentPath: '/missing/document.md',
421
+ reason: 'Document not found: /missing/document.md'
422
+ },
423
+ // Missing document with section
424
+ {
425
+ reference: '@/missing/document.md#section',
426
+ type: 'missing_document',
427
+ documentPath: '/missing/document.md',
428
+ sectionSlug: 'section',
429
+ reason: 'Document not found: /missing/document.md'
430
+ },
431
+ // Missing section type
432
+ {
433
+ reference: '@/existing/document.md#missing-section',
434
+ type: 'missing_section',
435
+ documentPath: '/existing/document.md',
436
+ sectionSlug: 'missing-section',
437
+ reason: "Section 'missing-section' not found in document /existing/document.md"
438
+ },
439
+ // Malformed type
440
+ {
441
+ reference: '@malformed-ref',
442
+ type: 'malformed',
443
+ reason: 'Failed to parse reference: Invalid reference format'
444
+ },
445
+ // Relative reference
446
+ {
447
+ reference: '@relative-doc',
448
+ type: 'missing_document',
449
+ documentPath: '/relative-doc.md',
450
+ reason: 'Document not found: /relative-doc.md'
451
+ }
452
+ ]
453
+ });
454
+ mockAnalyzeDocumentSuggestions.mockResolvedValue(comprehensiveBrokenRefs);
455
+ const result = await processSuggestions('api', 'Comprehensive Reference Test', 'Test all reference types: @/missing/document.md @/existing/document.md#missing-section @malformed-ref');
456
+ const smartResult = result;
457
+ // Verify comprehensive coverage
458
+ expect(smartResult.suggestions.broken_references).toHaveLength(5);
459
+ // Test missing_document type
460
+ const missingDocRefs = smartResult.suggestions.broken_references.filter(ref => ref.type === 'missing_document');
461
+ expect(missingDocRefs).toHaveLength(3);
462
+ for (const ref of missingDocRefs) {
463
+ expect(ref.documentPath).toBeDefined();
464
+ expect(ref.reason).toContain('Document not found');
465
+ }
466
+ // Test missing_section type
467
+ const missingSectionRefs = smartResult.suggestions.broken_references.filter(ref => ref.type === 'missing_section');
468
+ expect(missingSectionRefs).toHaveLength(1);
469
+ const missingSectionRef = missingSectionRefs[0];
470
+ expect(missingSectionRef?.documentPath).toBe('/existing/document.md');
471
+ expect(missingSectionRef?.sectionSlug).toBe('missing-section');
472
+ expect(missingSectionRef?.reason).toContain('Section \'missing-section\' not found');
473
+ // Test malformed type
474
+ const malformedRefs = smartResult.suggestions.broken_references.filter(ref => ref.type === 'malformed');
475
+ expect(malformedRefs).toHaveLength(1);
476
+ const malformedRef = malformedRefs[0];
477
+ expect(malformedRef?.reason).toContain('Failed to parse reference');
478
+ expect(malformedRef?.documentPath).toBeUndefined(); // Malformed refs may not have valid paths
479
+ // Verify all references have required fields
480
+ for (const ref of smartResult.suggestions.broken_references) {
481
+ expect(ref.reference).toBeDefined();
482
+ expect(ref.type).toBeOneOf(['missing_document', 'missing_section', 'malformed']);
483
+ expect(ref.reason).toBeDefined();
484
+ expect(typeof ref.reason).toBe('string');
485
+ expect(ref.reason.length).toBeGreaterThan(0);
486
+ }
487
+ });
488
+ });
489
+ describe('performance and concurrency', () => {
490
+ it('should handle concurrent suggestion analysis efficiently', async () => {
491
+ // Simulate multiple parallel calls
492
+ const promises = Array.from({ length: 5 }, (_, i) => processSuggestions(`namespace-${i}`, `Document ${i}`, `Overview for document ${i}`));
493
+ const results = await Promise.all(promises);
494
+ // All should complete successfully
495
+ expect(results).toHaveLength(5);
496
+ results.forEach((result, i) => {
497
+ expect(result.stage).toBe('smart_suggestions');
498
+ const smartResult = result;
499
+ expect(smartResult.example.namespace).toBe(`namespace-${i}`);
500
+ });
501
+ // Verify all manager calls were made
502
+ expect(mockGetDocumentManager).toHaveBeenCalledTimes(5);
503
+ expect(mockAnalyzeDocumentSuggestions).toHaveBeenCalledTimes(5);
504
+ expect(mockAnalyzeNamespacePatterns).toHaveBeenCalledTimes(5);
505
+ });
506
+ });
507
+ });
508
+ //# sourceMappingURL=suggestion-generator.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"suggestion-generator.test.js","sourceRoot":"","sources":["../../../src/tools/__tests__/suggestion-generator.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,11 @@
1
+ /**
2
+ * Regression test for BUG #4: view_task Cannot Find Tasks That Exist
3
+ *
4
+ * This test ensures that task section finding logic is consistent between
5
+ * the `task` tool and `view_task` tool.
6
+ *
7
+ * Issue: view_task used .includes('task') which matched "Completed Tasks"
8
+ * instead of the actual "Tasks" section, while task tool used exact matching.
9
+ */
10
+ export {};
11
+ //# sourceMappingURL=task-consistency.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"task-consistency.test.d.ts","sourceRoot":"","sources":["../../../src/tools/__tests__/task-consistency.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}
@@ -0,0 +1,93 @@
1
+ /**
2
+ * Regression test for BUG #4: view_task Cannot Find Tasks That Exist
3
+ *
4
+ * This test ensures that task section finding logic is consistent between
5
+ * the `task` tool and `view_task` tool.
6
+ *
7
+ * Issue: view_task used .includes('task') which matched "Completed Tasks"
8
+ * instead of the actual "Tasks" section, while task tool used exact matching.
9
+ */
10
+ import { describe, it, expect } from 'vitest';
11
+ describe('Task Section Finding Logic Consistency (BUG #4)', () => {
12
+ /**
13
+ * Test the core issue: task section finding logic
14
+ * This replicates the exact logic used in both tools
15
+ */
16
+ it('should find the same Tasks section using both task.ts and view-task.ts logic', () => {
17
+ // Mock document headings that replicate the structure causing the bug
18
+ const mockHeadings = [
19
+ { slug: 'overview', title: 'Overview', depth: 2 },
20
+ { slug: 'completed-tasks', title: 'Completed Tasks', depth: 2 },
21
+ { slug: 'task-plan-test-document', title: 'Task: Plan Test Document', depth: 3 },
22
+ { slug: 'blocked-tasks', title: 'Blocked Tasks', depth: 2 },
23
+ { slug: 'task-deploy-to-production', title: 'Task: Deploy to Production', depth: 3 },
24
+ { slug: 'tasks', title: 'Tasks', depth: 2 },
25
+ { slug: 'test-task-listing', title: 'Test Task Listing', depth: 3 },
26
+ { slug: 'test-task-creation', title: 'Test Task Creation', depth: 3 },
27
+ ];
28
+ // Logic from task.ts (correct)
29
+ const tasksSectionFromTaskTool = mockHeadings.find(h => h.slug === 'tasks' ||
30
+ h.title.toLowerCase() === 'tasks');
31
+ // Logic from view-task.ts BEFORE the fix (wrong)
32
+ const tasksSectionFromViewTaskToolOld = mockHeadings.find(h => h.slug === 'tasks' ||
33
+ h.title.toLowerCase().includes('task') ||
34
+ h.title.toLowerCase() === 'tasks');
35
+ // Logic from view-task.ts AFTER the fix (correct)
36
+ const tasksSectionFromViewTaskToolNew = mockHeadings.find(h => h.slug === 'tasks' ||
37
+ h.title.toLowerCase() === 'tasks');
38
+ // Verify the bug existed
39
+ expect(tasksSectionFromTaskTool?.slug).toBe('tasks');
40
+ expect(tasksSectionFromViewTaskToolOld?.slug).toBe('completed-tasks'); // Wrong!
41
+ // Verify the fix works
42
+ expect(tasksSectionFromViewTaskToolNew?.slug).toBe('tasks');
43
+ expect(tasksSectionFromTaskTool?.slug).toBe(tasksSectionFromViewTaskToolNew?.slug);
44
+ });
45
+ it('should prioritize exact "tasks" section over sections with "task" in the name', () => {
46
+ // Test various section orderings to ensure robustness
47
+ const scenarios = [
48
+ {
49
+ name: 'Tasks section after other task sections',
50
+ headings: [
51
+ { slug: 'completed-tasks', title: 'Completed Tasks', depth: 2 },
52
+ { slug: 'task-management', title: 'Task Management', depth: 2 },
53
+ { slug: 'tasks', title: 'Tasks', depth: 2 },
54
+ ]
55
+ },
56
+ {
57
+ name: 'Tasks section before other task sections',
58
+ headings: [
59
+ { slug: 'tasks', title: 'Tasks', depth: 2 },
60
+ { slug: 'completed-tasks', title: 'Completed Tasks', depth: 2 },
61
+ { slug: 'future-tasks', title: 'Future Tasks', depth: 2 },
62
+ ]
63
+ },
64
+ {
65
+ name: 'Tasks section in the middle',
66
+ headings: [
67
+ { slug: 'task-overview', title: 'Task Overview', depth: 2 },
68
+ { slug: 'tasks', title: 'Tasks', depth: 2 },
69
+ { slug: 'archived-tasks', title: 'Archived Tasks', depth: 2 },
70
+ ]
71
+ }
72
+ ];
73
+ scenarios.forEach(({ name, headings }) => {
74
+ // Logic from both tools should now be identical
75
+ const foundSection = headings.find(h => h.slug === 'tasks' ||
76
+ h.title.toLowerCase() === 'tasks');
77
+ expect(foundSection?.slug, `Failed scenario: ${name}`).toBe('tasks');
78
+ });
79
+ });
80
+ it('should not match partial task words', () => {
81
+ const mockHeadings = [
82
+ { slug: 'multitasking', title: 'Multitasking', depth: 2 },
83
+ { slug: 'task-force', title: 'Task Force', depth: 2 },
84
+ { slug: 'tasks', title: 'Tasks', depth: 2 },
85
+ ];
86
+ // Only exact match for "tasks" should work
87
+ const foundSection = mockHeadings.find(h => h.slug === 'tasks' ||
88
+ h.title.toLowerCase() === 'tasks');
89
+ expect(foundSection?.slug).toBe('tasks');
90
+ expect(foundSection?.title).toBe('Tasks');
91
+ });
92
+ });
93
+ //# sourceMappingURL=task-consistency.test.js.map