@egentica/codemap 0.1.5

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 (527) hide show
  1. package/LICENSE.md +165 -0
  2. package/README.md +479 -0
  3. package/dist/adapters/EgenticaMcpAdapter.d.ts +128 -0
  4. package/dist/adapters/EgenticaMcpAdapter.d.ts.map +1 -0
  5. package/dist/adapters/EgenticaMcpAdapter.js +218 -0
  6. package/dist/adapters/EgenticaMcpAdapter.js.map +1 -0
  7. package/dist/assist/AssistEngine.d.ts +107 -0
  8. package/dist/assist/AssistEngine.d.ts.map +1 -0
  9. package/dist/assist/AssistEngine.js +188 -0
  10. package/dist/assist/AssistEngine.js.map +1 -0
  11. package/dist/assist/AssistScorer.d.ts +91 -0
  12. package/dist/assist/AssistScorer.d.ts.map +1 -0
  13. package/dist/assist/AssistScorer.js +254 -0
  14. package/dist/assist/AssistScorer.js.map +1 -0
  15. package/dist/assist/PatternAggregator.d.ts +116 -0
  16. package/dist/assist/PatternAggregator.d.ts.map +1 -0
  17. package/dist/assist/PatternAggregator.js +311 -0
  18. package/dist/assist/PatternAggregator.js.map +1 -0
  19. package/dist/assist/RelevanceScorer.d.ts +104 -0
  20. package/dist/assist/RelevanceScorer.d.ts.map +1 -0
  21. package/dist/assist/RelevanceScorer.js +240 -0
  22. package/dist/assist/RelevanceScorer.js.map +1 -0
  23. package/dist/assist/index.d.ts +6 -0
  24. package/dist/assist/index.d.ts.map +1 -0
  25. package/dist/assist/index.js +9 -0
  26. package/dist/assist/index.js.map +1 -0
  27. package/dist/core/AnnotationStore.d.ts +101 -0
  28. package/dist/core/AnnotationStore.d.ts.map +1 -0
  29. package/dist/core/AnnotationStore.js +236 -0
  30. package/dist/core/AnnotationStore.js.map +1 -0
  31. package/dist/core/BackupManager.d.ts +92 -0
  32. package/dist/core/BackupManager.d.ts.map +1 -0
  33. package/dist/core/BackupManager.js +311 -0
  34. package/dist/core/BackupManager.js.map +1 -0
  35. package/dist/core/ChecklistStore.d.ts +66 -0
  36. package/dist/core/ChecklistStore.d.ts.map +1 -0
  37. package/dist/core/ChecklistStore.js +199 -0
  38. package/dist/core/ChecklistStore.js.map +1 -0
  39. package/dist/core/CodeMap.d.ts +614 -0
  40. package/dist/core/CodeMap.d.ts.map +1 -0
  41. package/dist/core/CodeMap.js +880 -0
  42. package/dist/core/CodeMap.js.map +1 -0
  43. package/dist/core/DisplayFilter.d.ts +83 -0
  44. package/dist/core/DisplayFilter.d.ts.map +1 -0
  45. package/dist/core/DisplayFilter.js +228 -0
  46. package/dist/core/DisplayFilter.js.map +1 -0
  47. package/dist/core/EventBus.d.ts +114 -0
  48. package/dist/core/EventBus.d.ts.map +1 -0
  49. package/dist/core/EventBus.js +192 -0
  50. package/dist/core/EventBus.js.map +1 -0
  51. package/dist/core/ExperienceStore.d.ts +170 -0
  52. package/dist/core/ExperienceStore.d.ts.map +1 -0
  53. package/dist/core/ExperienceStore.js +292 -0
  54. package/dist/core/ExperienceStore.js.map +1 -0
  55. package/dist/core/ExperienceTracker.d.ts +110 -0
  56. package/dist/core/ExperienceTracker.d.ts.map +1 -0
  57. package/dist/core/ExperienceTracker.js +291 -0
  58. package/dist/core/ExperienceTracker.js.map +1 -0
  59. package/dist/core/FileSystemGraph.d.ts +157 -0
  60. package/dist/core/FileSystemGraph.d.ts.map +1 -0
  61. package/dist/core/FileSystemGraph.js +316 -0
  62. package/dist/core/FileSystemGraph.js.map +1 -0
  63. package/dist/core/FileSystemIO.d.ts +222 -0
  64. package/dist/core/FileSystemIO.d.ts.map +1 -0
  65. package/dist/core/FileSystemIO.js +403 -0
  66. package/dist/core/FileSystemIO.js.map +1 -0
  67. package/dist/core/FuzzyMatcher.d.ts +51 -0
  68. package/dist/core/FuzzyMatcher.d.ts.map +1 -0
  69. package/dist/core/FuzzyMatcher.js +280 -0
  70. package/dist/core/FuzzyMatcher.js.map +1 -0
  71. package/dist/core/GroupStore.d.ts +114 -0
  72. package/dist/core/GroupStore.d.ts.map +1 -0
  73. package/dist/core/GroupStore.js +246 -0
  74. package/dist/core/GroupStore.js.map +1 -0
  75. package/dist/core/HelpRegistry.d.ts +116 -0
  76. package/dist/core/HelpRegistry.d.ts.map +1 -0
  77. package/dist/core/HelpRegistry.js +160 -0
  78. package/dist/core/HelpRegistry.js.map +1 -0
  79. package/dist/core/HintRegistry.d.ts +49 -0
  80. package/dist/core/HintRegistry.d.ts.map +1 -0
  81. package/dist/core/HintRegistry.js +81 -0
  82. package/dist/core/HintRegistry.js.map +1 -0
  83. package/dist/core/LabelStore.d.ts +88 -0
  84. package/dist/core/LabelStore.d.ts.map +1 -0
  85. package/dist/core/LabelStore.js +520 -0
  86. package/dist/core/LabelStore.js.map +1 -0
  87. package/dist/core/LineRangeWriter.d.ts +63 -0
  88. package/dist/core/LineRangeWriter.d.ts.map +1 -0
  89. package/dist/core/LineRangeWriter.js +179 -0
  90. package/dist/core/LineRangeWriter.js.map +1 -0
  91. package/dist/core/ParserRegistry.d.ts +70 -0
  92. package/dist/core/ParserRegistry.d.ts.map +1 -0
  93. package/dist/core/ParserRegistry.js +109 -0
  94. package/dist/core/ParserRegistry.js.map +1 -0
  95. package/dist/core/PluginRegistry.d.ts +120 -0
  96. package/dist/core/PluginRegistry.d.ts.map +1 -0
  97. package/dist/core/PluginRegistry.js +230 -0
  98. package/dist/core/PluginRegistry.js.map +1 -0
  99. package/dist/core/QueryEngine.d.ts +134 -0
  100. package/dist/core/QueryEngine.d.ts.map +1 -0
  101. package/dist/core/QueryEngine.js +211 -0
  102. package/dist/core/QueryEngine.js.map +1 -0
  103. package/dist/core/Scanner.d.ts +84 -0
  104. package/dist/core/Scanner.d.ts.map +1 -0
  105. package/dist/core/Scanner.js +184 -0
  106. package/dist/core/Scanner.js.map +1 -0
  107. package/dist/core/SessionTransactionLog.d.ts +138 -0
  108. package/dist/core/SessionTransactionLog.d.ts.map +1 -0
  109. package/dist/core/SessionTransactionLog.js +397 -0
  110. package/dist/core/SessionTransactionLog.js.map +1 -0
  111. package/dist/core/TargetParser.d.ts +85 -0
  112. package/dist/core/TargetParser.d.ts.map +1 -0
  113. package/dist/core/TargetParser.js +167 -0
  114. package/dist/core/TargetParser.js.map +1 -0
  115. package/dist/core/TargetResolver.d.ts +115 -0
  116. package/dist/core/TargetResolver.d.ts.map +1 -0
  117. package/dist/core/TargetResolver.js +237 -0
  118. package/dist/core/TargetResolver.js.map +1 -0
  119. package/dist/core/WriteSafetyGuard.d.ts +101 -0
  120. package/dist/core/WriteSafetyGuard.d.ts.map +1 -0
  121. package/dist/core/WriteSafetyGuard.js +265 -0
  122. package/dist/core/WriteSafetyGuard.js.map +1 -0
  123. package/dist/core/index.d.ts +38 -0
  124. package/dist/core/index.d.ts.map +1 -0
  125. package/dist/core/index.js +51 -0
  126. package/dist/core/index.js.map +1 -0
  127. package/dist/core/query/DependencyTraversal.d.ts +23 -0
  128. package/dist/core/query/DependencyTraversal.d.ts.map +1 -0
  129. package/dist/core/query/DependencyTraversal.js +55 -0
  130. package/dist/core/query/DependencyTraversal.js.map +1 -0
  131. package/dist/core/query/ResultProcessor.d.ts +20 -0
  132. package/dist/core/query/ResultProcessor.d.ts.map +1 -0
  133. package/dist/core/query/ResultProcessor.js +99 -0
  134. package/dist/core/query/ResultProcessor.js.map +1 -0
  135. package/dist/core/query/SymbolSearchEngine.d.ts +20 -0
  136. package/dist/core/query/SymbolSearchEngine.d.ts.map +1 -0
  137. package/dist/core/query/SymbolSearchEngine.js +109 -0
  138. package/dist/core/query/SymbolSearchEngine.js.map +1 -0
  139. package/dist/core/query/TextSearchEngine.d.ts +23 -0
  140. package/dist/core/query/TextSearchEngine.d.ts.map +1 -0
  141. package/dist/core/query/TextSearchEngine.js +69 -0
  142. package/dist/core/query/TextSearchEngine.js.map +1 -0
  143. package/dist/core/query/index.d.ts +11 -0
  144. package/dist/core/query/index.d.ts.map +1 -0
  145. package/dist/core/query/index.js +18 -0
  146. package/dist/core/query/index.js.map +1 -0
  147. package/dist/core/scan/DependencyResolver.d.ts +26 -0
  148. package/dist/core/scan/DependencyResolver.d.ts.map +1 -0
  149. package/dist/core/scan/DependencyResolver.js +81 -0
  150. package/dist/core/scan/DependencyResolver.js.map +1 -0
  151. package/dist/core/scan/DirectoryWalker.d.ts +39 -0
  152. package/dist/core/scan/DirectoryWalker.d.ts.map +1 -0
  153. package/dist/core/scan/DirectoryWalker.js +136 -0
  154. package/dist/core/scan/DirectoryWalker.js.map +1 -0
  155. package/dist/core/scan/IgnorePatternMatcher.d.ts +32 -0
  156. package/dist/core/scan/IgnorePatternMatcher.d.ts.map +1 -0
  157. package/dist/core/scan/IgnorePatternMatcher.js +120 -0
  158. package/dist/core/scan/IgnorePatternMatcher.js.map +1 -0
  159. package/dist/core/scan/index.d.ts +10 -0
  160. package/dist/core/scan/index.d.ts.map +1 -0
  161. package/dist/core/scan/index.js +16 -0
  162. package/dist/core/scan/index.js.map +1 -0
  163. package/dist/core/utils/packageDiscovery.d.ts +24 -0
  164. package/dist/core/utils/packageDiscovery.d.ts.map +1 -0
  165. package/dist/core/utils/packageDiscovery.js +37 -0
  166. package/dist/core/utils/packageDiscovery.js.map +1 -0
  167. package/dist/index.d.ts +18 -0
  168. package/dist/index.d.ts.map +1 -0
  169. package/dist/index.js +37 -0
  170. package/dist/index.js.map +1 -0
  171. package/dist/mcp/operations/annotations.d.ts +9 -0
  172. package/dist/mcp/operations/annotations.d.ts.map +1 -0
  173. package/dist/mcp/operations/annotations.js +66 -0
  174. package/dist/mcp/operations/annotations.js.map +1 -0
  175. package/dist/mcp/operations/files.d.ts +13 -0
  176. package/dist/mcp/operations/files.d.ts.map +1 -0
  177. package/dist/mcp/operations/files.js +173 -0
  178. package/dist/mcp/operations/files.js.map +1 -0
  179. package/dist/mcp/operations/graph.d.ts +10 -0
  180. package/dist/mcp/operations/graph.d.ts.map +1 -0
  181. package/dist/mcp/operations/graph.js +69 -0
  182. package/dist/mcp/operations/graph.js.map +1 -0
  183. package/dist/mcp/operations/groups.d.ts +55 -0
  184. package/dist/mcp/operations/groups.d.ts.map +1 -0
  185. package/dist/mcp/operations/groups.js +233 -0
  186. package/dist/mcp/operations/groups.js.map +1 -0
  187. package/dist/mcp/operations/help.d.ts +36 -0
  188. package/dist/mcp/operations/help.d.ts.map +1 -0
  189. package/dist/mcp/operations/help.js +322 -0
  190. package/dist/mcp/operations/help.js.map +1 -0
  191. package/dist/mcp/operations/session.d.ts +13 -0
  192. package/dist/mcp/operations/session.d.ts.map +1 -0
  193. package/dist/mcp/operations/session.js +169 -0
  194. package/dist/mcp/operations/session.js.map +1 -0
  195. package/dist/mcp/operations/writes.d.ts +14 -0
  196. package/dist/mcp/operations/writes.d.ts.map +1 -0
  197. package/dist/mcp/operations/writes.js +287 -0
  198. package/dist/mcp/operations/writes.js.map +1 -0
  199. package/dist/mcp/registry/ToolRegistry.d.ts +54 -0
  200. package/dist/mcp/registry/ToolRegistry.d.ts.map +1 -0
  201. package/dist/mcp/registry/ToolRegistry.js +219 -0
  202. package/dist/mcp/registry/ToolRegistry.js.map +1 -0
  203. package/dist/mcp/registry/context-guard.d.ts +13 -0
  204. package/dist/mcp/registry/context-guard.d.ts.map +1 -0
  205. package/dist/mcp/registry/context-guard.js +19 -0
  206. package/dist/mcp/registry/context-guard.js.map +1 -0
  207. package/dist/mcp/registry/schemas.d.ts +221 -0
  208. package/dist/mcp/registry/schemas.d.ts.map +1 -0
  209. package/dist/mcp/registry/schemas.js +217 -0
  210. package/dist/mcp/registry/schemas.js.map +1 -0
  211. package/dist/mcp/registry/types.d.ts +50 -0
  212. package/dist/mcp/registry/types.d.ts.map +1 -0
  213. package/dist/mcp/registry/types.js +5 -0
  214. package/dist/mcp/registry/types.js.map +1 -0
  215. package/dist/mcp/server.d.ts +35 -0
  216. package/dist/mcp/server.d.ts.map +1 -0
  217. package/dist/mcp/server.js +264 -0
  218. package/dist/mcp/server.js.map +1 -0
  219. package/dist/mcp/tools/annotations/add.tool.d.ts +10 -0
  220. package/dist/mcp/tools/annotations/add.tool.d.ts.map +1 -0
  221. package/dist/mcp/tools/annotations/add.tool.js +88 -0
  222. package/dist/mcp/tools/annotations/add.tool.js.map +1 -0
  223. package/dist/mcp/tools/annotations/edit.tool.d.ts +10 -0
  224. package/dist/mcp/tools/annotations/edit.tool.d.ts.map +1 -0
  225. package/dist/mcp/tools/annotations/edit.tool.js +92 -0
  226. package/dist/mcp/tools/annotations/edit.tool.js.map +1 -0
  227. package/dist/mcp/tools/annotations/remove.tool.d.ts +9 -0
  228. package/dist/mcp/tools/annotations/remove.tool.d.ts.map +1 -0
  229. package/dist/mcp/tools/annotations/remove.tool.js +87 -0
  230. package/dist/mcp/tools/annotations/remove.tool.js.map +1 -0
  231. package/dist/mcp/tools/annotations/search-annotations.tool.d.ts +11 -0
  232. package/dist/mcp/tools/annotations/search-annotations.tool.d.ts.map +1 -0
  233. package/dist/mcp/tools/annotations/search-annotations.tool.js +91 -0
  234. package/dist/mcp/tools/annotations/search-annotations.tool.js.map +1 -0
  235. package/dist/mcp/tools/backup/list.tool.d.ts +16 -0
  236. package/dist/mcp/tools/backup/list.tool.d.ts.map +1 -0
  237. package/dist/mcp/tools/backup/list.tool.js +48 -0
  238. package/dist/mcp/tools/backup/list.tool.js.map +1 -0
  239. package/dist/mcp/tools/backup/restore.tool.d.ts +15 -0
  240. package/dist/mcp/tools/backup/restore.tool.d.ts.map +1 -0
  241. package/dist/mcp/tools/backup/restore.tool.js +138 -0
  242. package/dist/mcp/tools/backup/restore.tool.js.map +1 -0
  243. package/dist/mcp/tools/checklist/add.tool.d.ts +17 -0
  244. package/dist/mcp/tools/checklist/add.tool.d.ts.map +1 -0
  245. package/dist/mcp/tools/checklist/add.tool.js +53 -0
  246. package/dist/mcp/tools/checklist/add.tool.js.map +1 -0
  247. package/dist/mcp/tools/checklist/list.tool.d.ts +11 -0
  248. package/dist/mcp/tools/checklist/list.tool.d.ts.map +1 -0
  249. package/dist/mcp/tools/checklist/list.tool.js +53 -0
  250. package/dist/mcp/tools/checklist/list.tool.js.map +1 -0
  251. package/dist/mcp/tools/checklist/remove.tool.d.ts +9 -0
  252. package/dist/mcp/tools/checklist/remove.tool.d.ts.map +1 -0
  253. package/dist/mcp/tools/checklist/remove.tool.js +63 -0
  254. package/dist/mcp/tools/checklist/remove.tool.js.map +1 -0
  255. package/dist/mcp/tools/graph/get-dependencies.tool.d.ts +8 -0
  256. package/dist/mcp/tools/graph/get-dependencies.tool.d.ts.map +1 -0
  257. package/dist/mcp/tools/graph/get-dependencies.tool.js +58 -0
  258. package/dist/mcp/tools/graph/get-dependencies.tool.js.map +1 -0
  259. package/dist/mcp/tools/graph/get-related.tool.d.ts +9 -0
  260. package/dist/mcp/tools/graph/get-related.tool.d.ts.map +1 -0
  261. package/dist/mcp/tools/graph/get-related.tool.js +63 -0
  262. package/dist/mcp/tools/graph/get-related.tool.js.map +1 -0
  263. package/dist/mcp/tools/graph/impact-analysis.tool.d.ts +9 -0
  264. package/dist/mcp/tools/graph/impact-analysis.tool.d.ts.map +1 -0
  265. package/dist/mcp/tools/graph/impact-analysis.tool.js +61 -0
  266. package/dist/mcp/tools/graph/impact-analysis.tool.js.map +1 -0
  267. package/dist/mcp/tools/graph/traverse.tool.d.ts +13 -0
  268. package/dist/mcp/tools/graph/traverse.tool.d.ts.map +1 -0
  269. package/dist/mcp/tools/graph/traverse.tool.js +59 -0
  270. package/dist/mcp/tools/graph/traverse.tool.js.map +1 -0
  271. package/dist/mcp/tools/groups/add.tool.d.ts +10 -0
  272. package/dist/mcp/tools/groups/add.tool.d.ts.map +1 -0
  273. package/dist/mcp/tools/groups/add.tool.js +85 -0
  274. package/dist/mcp/tools/groups/add.tool.js.map +1 -0
  275. package/dist/mcp/tools/groups/notate.tool.d.ts +11 -0
  276. package/dist/mcp/tools/groups/notate.tool.d.ts.map +1 -0
  277. package/dist/mcp/tools/groups/notate.tool.js +86 -0
  278. package/dist/mcp/tools/groups/notate.tool.js.map +1 -0
  279. package/dist/mcp/tools/groups/search.tool.d.ts +8 -0
  280. package/dist/mcp/tools/groups/search.tool.d.ts.map +1 -0
  281. package/dist/mcp/tools/groups/search.tool.js +81 -0
  282. package/dist/mcp/tools/groups/search.tool.js.map +1 -0
  283. package/dist/mcp/tools/io/append.tool.d.ts +10 -0
  284. package/dist/mcp/tools/io/append.tool.d.ts.map +1 -0
  285. package/dist/mcp/tools/io/append.tool.js +103 -0
  286. package/dist/mcp/tools/io/append.tool.js.map +1 -0
  287. package/dist/mcp/tools/io/create.tool.d.ts +11 -0
  288. package/dist/mcp/tools/io/create.tool.d.ts.map +1 -0
  289. package/dist/mcp/tools/io/create.tool.js +119 -0
  290. package/dist/mcp/tools/io/create.tool.js.map +1 -0
  291. package/dist/mcp/tools/io/delete.tool.d.ts +9 -0
  292. package/dist/mcp/tools/io/delete.tool.d.ts.map +1 -0
  293. package/dist/mcp/tools/io/delete.tool.js +129 -0
  294. package/dist/mcp/tools/io/delete.tool.js.map +1 -0
  295. package/dist/mcp/tools/io/get-annotations.tool.d.ts +10 -0
  296. package/dist/mcp/tools/io/get-annotations.tool.d.ts.map +1 -0
  297. package/dist/mcp/tools/io/get-annotations.tool.js +97 -0
  298. package/dist/mcp/tools/io/get-annotations.tool.js.map +1 -0
  299. package/dist/mcp/tools/io/get-symbols.tool.d.ts +9 -0
  300. package/dist/mcp/tools/io/get-symbols.tool.d.ts.map +1 -0
  301. package/dist/mcp/tools/io/get-symbols.tool.js +63 -0
  302. package/dist/mcp/tools/io/get-symbols.tool.js.map +1 -0
  303. package/dist/mcp/tools/io/list.tool.d.ts +8 -0
  304. package/dist/mcp/tools/io/list.tool.d.ts.map +1 -0
  305. package/dist/mcp/tools/io/list.tool.js +68 -0
  306. package/dist/mcp/tools/io/list.tool.js.map +1 -0
  307. package/dist/mcp/tools/io/peek.tool.d.ts +11 -0
  308. package/dist/mcp/tools/io/peek.tool.d.ts.map +1 -0
  309. package/dist/mcp/tools/io/peek.tool.js +74 -0
  310. package/dist/mcp/tools/io/peek.tool.js.map +1 -0
  311. package/dist/mcp/tools/io/read-multiple.tool.d.ts +9 -0
  312. package/dist/mcp/tools/io/read-multiple.tool.d.ts.map +1 -0
  313. package/dist/mcp/tools/io/read-multiple.tool.js +72 -0
  314. package/dist/mcp/tools/io/read-multiple.tool.js.map +1 -0
  315. package/dist/mcp/tools/io/read.tool.d.ts +13 -0
  316. package/dist/mcp/tools/io/read.tool.d.ts.map +1 -0
  317. package/dist/mcp/tools/io/read.tool.js +132 -0
  318. package/dist/mcp/tools/io/read.tool.js.map +1 -0
  319. package/dist/mcp/tools/io/rename.tool.d.ts +9 -0
  320. package/dist/mcp/tools/io/rename.tool.d.ts.map +1 -0
  321. package/dist/mcp/tools/io/rename.tool.js +101 -0
  322. package/dist/mcp/tools/io/rename.tool.js.map +1 -0
  323. package/dist/mcp/tools/io/replace-many.tool.d.ts +10 -0
  324. package/dist/mcp/tools/io/replace-many.tool.d.ts.map +1 -0
  325. package/dist/mcp/tools/io/replace-many.tool.js +114 -0
  326. package/dist/mcp/tools/io/replace-many.tool.js.map +1 -0
  327. package/dist/mcp/tools/io/replace-text.tool.d.ts +12 -0
  328. package/dist/mcp/tools/io/replace-text.tool.d.ts.map +1 -0
  329. package/dist/mcp/tools/io/replace-text.tool.js +213 -0
  330. package/dist/mcp/tools/io/replace-text.tool.js.map +1 -0
  331. package/dist/mcp/tools/io/write.tool.d.ts +10 -0
  332. package/dist/mcp/tools/io/write.tool.d.ts.map +1 -0
  333. package/dist/mcp/tools/io/write.tool.js +103 -0
  334. package/dist/mcp/tools/io/write.tool.js.map +1 -0
  335. package/dist/mcp/tools/labels/assign.tool.d.ts +16 -0
  336. package/dist/mcp/tools/labels/assign.tool.d.ts.map +1 -0
  337. package/dist/mcp/tools/labels/assign.tool.js +52 -0
  338. package/dist/mcp/tools/labels/assign.tool.js.map +1 -0
  339. package/dist/mcp/tools/labels/create.tool.d.ts +12 -0
  340. package/dist/mcp/tools/labels/create.tool.d.ts.map +1 -0
  341. package/dist/mcp/tools/labels/create.tool.js +51 -0
  342. package/dist/mcp/tools/labels/create.tool.js.map +1 -0
  343. package/dist/mcp/tools/labels/delete.tool.d.ts +9 -0
  344. package/dist/mcp/tools/labels/delete.tool.d.ts.map +1 -0
  345. package/dist/mcp/tools/labels/delete.tool.js +48 -0
  346. package/dist/mcp/tools/labels/delete.tool.js.map +1 -0
  347. package/dist/mcp/tools/labels/edit.tool.d.ts +13 -0
  348. package/dist/mcp/tools/labels/edit.tool.d.ts.map +1 -0
  349. package/dist/mcp/tools/labels/edit.tool.js +58 -0
  350. package/dist/mcp/tools/labels/edit.tool.js.map +1 -0
  351. package/dist/mcp/tools/labels/list.tool.d.ts +11 -0
  352. package/dist/mcp/tools/labels/list.tool.d.ts.map +1 -0
  353. package/dist/mcp/tools/labels/list.tool.js +47 -0
  354. package/dist/mcp/tools/labels/list.tool.js.map +1 -0
  355. package/dist/mcp/tools/labels/migrate.tool.d.ts +10 -0
  356. package/dist/mcp/tools/labels/migrate.tool.d.ts.map +1 -0
  357. package/dist/mcp/tools/labels/migrate.tool.js +50 -0
  358. package/dist/mcp/tools/labels/migrate.tool.js.map +1 -0
  359. package/dist/mcp/tools/labels/search.tool.d.ts +16 -0
  360. package/dist/mcp/tools/labels/search.tool.d.ts.map +1 -0
  361. package/dist/mcp/tools/labels/search.tool.js +55 -0
  362. package/dist/mcp/tools/labels/search.tool.js.map +1 -0
  363. package/dist/mcp/tools/labels/unassign.tool.d.ts +9 -0
  364. package/dist/mcp/tools/labels/unassign.tool.d.ts.map +1 -0
  365. package/dist/mcp/tools/labels/unassign.tool.js +49 -0
  366. package/dist/mcp/tools/labels/unassign.tool.js.map +1 -0
  367. package/dist/mcp/tools/search/find-by-name.tool.d.ts +8 -0
  368. package/dist/mcp/tools/search/find-by-name.tool.d.ts.map +1 -0
  369. package/dist/mcp/tools/search/find-by-name.tool.js +57 -0
  370. package/dist/mcp/tools/search/find-by-name.tool.js.map +1 -0
  371. package/dist/mcp/tools/search/find-relevant.tool.d.ts +9 -0
  372. package/dist/mcp/tools/search/find-relevant.tool.d.ts.map +1 -0
  373. package/dist/mcp/tools/search/find-relevant.tool.js +71 -0
  374. package/dist/mcp/tools/search/find-relevant.tool.js.map +1 -0
  375. package/dist/mcp/tools/search/scan.tool.d.ts +8 -0
  376. package/dist/mcp/tools/search/scan.tool.d.ts.map +1 -0
  377. package/dist/mcp/tools/search/scan.tool.js +103 -0
  378. package/dist/mcp/tools/search/scan.tool.js.map +1 -0
  379. package/dist/mcp/tools/search/search-elements.tool.d.ts +11 -0
  380. package/dist/mcp/tools/search/search-elements.tool.d.ts.map +1 -0
  381. package/dist/mcp/tools/search/search-elements.tool.js +71 -0
  382. package/dist/mcp/tools/search/search-elements.tool.js.map +1 -0
  383. package/dist/mcp/tools/search/search-in-files.tool.d.ts +14 -0
  384. package/dist/mcp/tools/search/search-in-files.tool.d.ts.map +1 -0
  385. package/dist/mcp/tools/search/search-in-files.tool.js +204 -0
  386. package/dist/mcp/tools/search/search-in-files.tool.js.map +1 -0
  387. package/dist/mcp/tools/search/search.tool.d.ts +25 -0
  388. package/dist/mcp/tools/search/search.tool.d.ts.map +1 -0
  389. package/dist/mcp/tools/search/search.tool.js +109 -0
  390. package/dist/mcp/tools/search/search.tool.js.map +1 -0
  391. package/dist/mcp/tools/session/audit.tool.d.ts +6 -0
  392. package/dist/mcp/tools/session/audit.tool.d.ts.map +1 -0
  393. package/dist/mcp/tools/session/audit.tool.js +64 -0
  394. package/dist/mcp/tools/session/audit.tool.js.map +1 -0
  395. package/dist/mcp/tools/session/close.tool.d.ts +11 -0
  396. package/dist/mcp/tools/session/close.tool.d.ts.map +1 -0
  397. package/dist/mcp/tools/session/close.tool.js +79 -0
  398. package/dist/mcp/tools/session/close.tool.js.map +1 -0
  399. package/dist/mcp/tools/session/execute-shell.tool.d.ts +11 -0
  400. package/dist/mcp/tools/session/execute-shell.tool.d.ts.map +1 -0
  401. package/dist/mcp/tools/session/execute-shell.tool.js +87 -0
  402. package/dist/mcp/tools/session/execute-shell.tool.js.map +1 -0
  403. package/dist/mcp/tools/session/help.tool.d.ts +8 -0
  404. package/dist/mcp/tools/session/help.tool.d.ts.map +1 -0
  405. package/dist/mcp/tools/session/help.tool.js +84 -0
  406. package/dist/mcp/tools/session/help.tool.js.map +1 -0
  407. package/dist/mcp/tools/session/list.tool.d.ts +9 -0
  408. package/dist/mcp/tools/session/list.tool.d.ts.map +1 -0
  409. package/dist/mcp/tools/session/list.tool.js +49 -0
  410. package/dist/mcp/tools/session/list.tool.js.map +1 -0
  411. package/dist/mcp/tools/session/next-session.tool.d.ts +8 -0
  412. package/dist/mcp/tools/session/next-session.tool.d.ts.map +1 -0
  413. package/dist/mcp/tools/session/next-session.tool.js +87 -0
  414. package/dist/mcp/tools/session/next-session.tool.js.map +1 -0
  415. package/dist/mcp/tools/session/orient.tool.d.ts +11 -0
  416. package/dist/mcp/tools/session/orient.tool.d.ts.map +1 -0
  417. package/dist/mcp/tools/session/orient.tool.js +239 -0
  418. package/dist/mcp/tools/session/orient.tool.js.map +1 -0
  419. package/dist/mcp/tools/session/read.tool.d.ts +8 -0
  420. package/dist/mcp/tools/session/read.tool.d.ts.map +1 -0
  421. package/dist/mcp/tools/session/read.tool.js +63 -0
  422. package/dist/mcp/tools/session/read.tool.js.map +1 -0
  423. package/dist/mcp/tools/session/reindex.tool.d.ts +6 -0
  424. package/dist/mcp/tools/session/reindex.tool.d.ts.map +1 -0
  425. package/dist/mcp/tools/session/reindex.tool.js +59 -0
  426. package/dist/mcp/tools/session/reindex.tool.js.map +1 -0
  427. package/dist/mcp/tools/session/start.tool.d.ts +8 -0
  428. package/dist/mcp/tools/session/start.tool.d.ts.map +1 -0
  429. package/dist/mcp/tools/session/start.tool.js +170 -0
  430. package/dist/mcp/tools/session/start.tool.js.map +1 -0
  431. package/dist/mcp/tools/session/stats.tool.d.ts +6 -0
  432. package/dist/mcp/tools/session/stats.tool.d.ts.map +1 -0
  433. package/dist/mcp/tools/session/stats.tool.js +46 -0
  434. package/dist/mcp/tools/session/stats.tool.js.map +1 -0
  435. package/dist/plugins/parser-typescript/index.d.ts +80 -0
  436. package/dist/plugins/parser-typescript/index.d.ts.map +1 -0
  437. package/dist/plugins/parser-typescript/index.js +467 -0
  438. package/dist/plugins/parser-typescript/index.js.map +1 -0
  439. package/dist/plugins/parser-vue/index.d.ts +20 -0
  440. package/dist/plugins/parser-vue/index.d.ts.map +1 -0
  441. package/dist/plugins/parser-vue/index.js +88 -0
  442. package/dist/plugins/parser-vue/index.js.map +1 -0
  443. package/dist/plugins/parser-vue/script-parser.d.ts +18 -0
  444. package/dist/plugins/parser-vue/script-parser.d.ts.map +1 -0
  445. package/dist/plugins/parser-vue/script-parser.js +100 -0
  446. package/dist/plugins/parser-vue/script-parser.js.map +1 -0
  447. package/dist/plugins/parser-vue/template-parser.d.ts +14 -0
  448. package/dist/plugins/parser-vue/template-parser.d.ts.map +1 -0
  449. package/dist/plugins/parser-vue/template-parser.js +95 -0
  450. package/dist/plugins/parser-vue/template-parser.js.map +1 -0
  451. package/dist/query/SymbolSearch.d.ts +56 -0
  452. package/dist/query/SymbolSearch.d.ts.map +1 -0
  453. package/dist/query/SymbolSearch.js +132 -0
  454. package/dist/query/SymbolSearch.js.map +1 -0
  455. package/dist/query/TextSearch.d.ts +47 -0
  456. package/dist/query/TextSearch.d.ts.map +1 -0
  457. package/dist/query/TextSearch.js +110 -0
  458. package/dist/query/TextSearch.js.map +1 -0
  459. package/dist/storage/NodeFsProvider.d.ts +148 -0
  460. package/dist/storage/NodeFsProvider.d.ts.map +1 -0
  461. package/dist/storage/NodeFsProvider.js +264 -0
  462. package/dist/storage/NodeFsProvider.js.map +1 -0
  463. package/dist/types/annotation.d.ts +79 -0
  464. package/dist/types/annotation.d.ts.map +1 -0
  465. package/dist/types/annotation.js +10 -0
  466. package/dist/types/annotation.js.map +1 -0
  467. package/dist/types/assist.d.ts +147 -0
  468. package/dist/types/assist.d.ts.map +1 -0
  469. package/dist/types/assist.js +12 -0
  470. package/dist/types/assist.js.map +1 -0
  471. package/dist/types/contracts/FileSystemProvider.d.ts +24 -0
  472. package/dist/types/contracts/FileSystemProvider.d.ts.map +1 -0
  473. package/dist/types/contracts/FileSystemProvider.js +9 -0
  474. package/dist/types/contracts/FileSystemProvider.js.map +1 -0
  475. package/dist/types/contracts/LanguageParser.d.ts +146 -0
  476. package/dist/types/contracts/LanguageParser.d.ts.map +1 -0
  477. package/dist/types/contracts/LanguageParser.js +43 -0
  478. package/dist/types/contracts/LanguageParser.js.map +1 -0
  479. package/dist/types/contracts/Plugin.d.ts +226 -0
  480. package/dist/types/contracts/Plugin.d.ts.map +1 -0
  481. package/dist/types/contracts/Plugin.js +21 -0
  482. package/dist/types/contracts/Plugin.js.map +1 -0
  483. package/dist/types/contracts/index.d.ts +10 -0
  484. package/dist/types/contracts/index.d.ts.map +1 -0
  485. package/dist/types/contracts/index.js +26 -0
  486. package/dist/types/contracts/index.js.map +1 -0
  487. package/dist/types/core.d.ts +170 -0
  488. package/dist/types/core.d.ts.map +1 -0
  489. package/dist/types/core.js +10 -0
  490. package/dist/types/core.js.map +1 -0
  491. package/dist/types/events.d.ts +29 -0
  492. package/dist/types/events.d.ts.map +1 -0
  493. package/dist/types/events.js +18 -0
  494. package/dist/types/events.js.map +1 -0
  495. package/dist/types/experience.d.ts +153 -0
  496. package/dist/types/experience.d.ts.map +1 -0
  497. package/dist/types/experience.js +9 -0
  498. package/dist/types/experience.js.map +1 -0
  499. package/dist/types/graph.d.ts +35 -0
  500. package/dist/types/graph.d.ts.map +1 -0
  501. package/dist/types/graph.js +8 -0
  502. package/dist/types/graph.js.map +1 -0
  503. package/dist/types/index.d.ts +17 -0
  504. package/dist/types/index.d.ts.map +1 -0
  505. package/dist/types/index.js +33 -0
  506. package/dist/types/index.js.map +1 -0
  507. package/dist/types/label.d.ts +150 -0
  508. package/dist/types/label.d.ts.map +1 -0
  509. package/dist/types/label.js +9 -0
  510. package/dist/types/label.js.map +1 -0
  511. package/dist/types/query.d.ts +104 -0
  512. package/dist/types/query.d.ts.map +1 -0
  513. package/dist/types/query.js +11 -0
  514. package/dist/types/query.js.map +1 -0
  515. package/dist/types/response.d.ts +133 -0
  516. package/dist/types/response.d.ts.map +1 -0
  517. package/dist/types/response.js +60 -0
  518. package/dist/types/response.js.map +1 -0
  519. package/dist/types/target.d.ts +68 -0
  520. package/dist/types/target.d.ts.map +1 -0
  521. package/dist/types/target.js +11 -0
  522. package/dist/types/target.js.map +1 -0
  523. package/dist/utils/version.d.ts +9 -0
  524. package/dist/utils/version.d.ts.map +1 -0
  525. package/dist/utils/version.js +30 -0
  526. package/dist/utils/version.js.map +1 -0
  527. package/package.json +53 -0
@@ -0,0 +1,322 @@
1
+ "use strict";
2
+ /**
3
+ * Help system for CodeMap - provides contextual documentation for agents.
4
+ *
5
+ * This tool reads markdown help files from the HelpRegistry and returns
6
+ * formatted help content to guide agents in using CodeMap effectively.
7
+ *
8
+ * Supports both core help topics and plugin-registered topics.
9
+ */
10
+ var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
11
+ if (k2 === undefined) k2 = k;
12
+ var desc = Object.getOwnPropertyDescriptor(m, k);
13
+ if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
14
+ desc = { enumerable: true, get: function() { return m[k]; } };
15
+ }
16
+ Object.defineProperty(o, k2, desc);
17
+ }) : (function(o, m, k, k2) {
18
+ if (k2 === undefined) k2 = k;
19
+ o[k2] = m[k];
20
+ }));
21
+ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
22
+ Object.defineProperty(o, "default", { enumerable: true, value: v });
23
+ }) : function(o, v) {
24
+ o["default"] = v;
25
+ });
26
+ var __importStar = (this && this.__importStar) || (function () {
27
+ var ownKeys = function(o) {
28
+ ownKeys = Object.getOwnPropertyNames || function (o) {
29
+ var ar = [];
30
+ for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
31
+ return ar;
32
+ };
33
+ return ownKeys(o);
34
+ };
35
+ return function (mod) {
36
+ if (mod && mod.__esModule) return mod;
37
+ var result = {};
38
+ if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
39
+ __setModuleDefault(result, mod);
40
+ return result;
41
+ };
42
+ })();
43
+ Object.defineProperty(exports, "__esModule", { value: true });
44
+ exports.registerCoreHelpTopics = registerCoreHelpTopics;
45
+ exports.getHelp = getHelp;
46
+ const fs = __importStar(require("fs/promises"));
47
+ const path = __importStar(require("path"));
48
+ // ── Core Help Topics ─────────────────────────────────────────────────────────
49
+ /**
50
+ * Register core help topics with the HelpRegistry.
51
+ * Called during CodeMap initialization to register built-in help content.
52
+ *
53
+ * @param registry - HelpRegistry instance
54
+ * @param docsPath - Optional custom path to docs/help directory
55
+ */
56
+ async function registerCoreHelpTopics(registry, docsPath) {
57
+ const helpDir = docsPath || path.join(__dirname, '../../../docs/help');
58
+ const coreTopics = [
59
+ {
60
+ id: 'getting-started',
61
+ title: 'Getting Started with CodeMap',
62
+ description: 'Introduction to CodeMap, first steps, core concepts, and basic workflows.',
63
+ tags: ['core', 'beginner', 'setup']
64
+ },
65
+ {
66
+ id: 'tool-reference',
67
+ title: 'Complete Tool Reference',
68
+ description: 'Comprehensive reference for all 52 CodeMap tools organized by category.',
69
+ tags: ['core', 'reference', 'tools', 'commands']
70
+ },
71
+ {
72
+ id: 'search-patterns',
73
+ title: 'Search Patterns',
74
+ description: 'Complete guide to searching code effectively with different search modes.',
75
+ tags: ['core', 'search', 'query']
76
+ },
77
+ {
78
+ id: 'file-operations',
79
+ title: 'File Operations',
80
+ description: 'Reading and editing files with CodeMap, including best practices.',
81
+ tags: ['core', 'files', 'editing']
82
+ },
83
+ {
84
+ id: 'dependencies',
85
+ title: 'Dependency Analysis',
86
+ description: 'Understanding and analyzing code dependencies and import relationships.',
87
+ tags: ['core', 'graph', 'dependencies']
88
+ },
89
+ {
90
+ id: 'annotations',
91
+ title: 'Annotations Guide',
92
+ description: 'Using @codemap annotations for metadata and documentation.',
93
+ tags: ['core', 'annotations', 'metadata']
94
+ },
95
+ {
96
+ id: 'best-practices',
97
+ title: 'Best Practices',
98
+ description: 'Recommended patterns and workflows for using CodeMap effectively.',
99
+ tags: ['core', 'workflow', 'tips']
100
+ },
101
+ {
102
+ id: 'groups',
103
+ title: 'Code Groups',
104
+ description: 'Organizing code with persistent groups - categorize files, directories, and symbols.',
105
+ tags: ['core', 'groups', 'organization']
106
+ },
107
+ {
108
+ id: 'session-tracking',
109
+ title: 'Session Tracking',
110
+ description: 'Session tracking system - automatically track file operations, manage checklists, and maintain session continuity.',
111
+ tags: ['core', 'session', 'workflow', 'tracking']
112
+ },
113
+ {
114
+ id: 'checklist-management',
115
+ title: 'Checklist Management',
116
+ description: 'Managing workflow checklists at session start and close boundaries.',
117
+ tags: ['core', 'checklist', 'workflow', 'session']
118
+ },
119
+ {
120
+ id: 'enhanced-read',
121
+ title: 'Enhanced File Reading',
122
+ description: 'Advanced file reading with pagination, group context, and dependency information.',
123
+ tags: ['core', 'files', 'reading', 'context']
124
+ },
125
+ {
126
+ id: 'labels',
127
+ title: 'Labels System',
128
+ description: 'Visual tagging system for files, directories, and symbols with emoji + name format.',
129
+ tags: ['core', 'labels', 'tagging', 'organization']
130
+ },
131
+ {
132
+ id: 'backups',
133
+ title: 'Backup System',
134
+ description: 'Hybrid backup strategy for persistent storage files - daily and turn-based backups with restore capability.',
135
+ tags: ['core', 'backup', 'restore', 'recovery']
136
+ },
137
+ // Tool category topics
138
+ {
139
+ id: 'search-tools',
140
+ title: 'Search Tools',
141
+ description: 'Complete reference for 6 search and discovery tools: search, search-in-files, search-annotations, search-elements, find-by-name, find-relevant.',
142
+ tags: ['tools', 'search', 'discovery', 'reference']
143
+ },
144
+ {
145
+ id: 'groups-tools',
146
+ title: 'Code Groups Tools',
147
+ description: 'Complete reference for 3 code grouping tools: group-add, group-notate, group-search.',
148
+ tags: ['tools', 'groups', 'organization', 'reference']
149
+ },
150
+ {
151
+ id: 'graph-tools',
152
+ title: 'Graph & Dependencies Tools',
153
+ description: 'Complete reference for 4 dependency analysis tools: get-dependencies, get-related, impact-analysis, traverse.',
154
+ tags: ['tools', 'graph', 'dependencies', 'reference']
155
+ },
156
+ {
157
+ id: 'annotations-tools',
158
+ title: 'Annotations Tools',
159
+ description: 'Complete reference for 4 annotation tools: add-annotation, edit-annotation, remove-annotation, search-annotations.',
160
+ tags: ['tools', 'annotations', 'metadata', 'reference']
161
+ },
162
+ {
163
+ id: 'backup-tools',
164
+ title: 'Backup & Restore Tools',
165
+ description: 'Complete reference for 2 backup tools: backup-list, backup-restore.',
166
+ tags: ['tools', 'backup', 'restore', 'reference']
167
+ },
168
+ {
169
+ id: 'checklist-tools',
170
+ title: 'Workflow Checklists Tools',
171
+ description: 'Complete reference for 3 checklist tools: checklist-list, checklist-add-item, checklist-remove-item.',
172
+ tags: ['tools', 'checklist', 'workflow', 'reference']
173
+ },
174
+ {
175
+ id: 'labels-tools',
176
+ title: 'Labels Tools',
177
+ description: 'Complete reference for 8 label tagging tools: label-create, label-list, label-edit, label-delete, label-assign, label-unassign, label-migrate, label-search.',
178
+ tags: ['tools', 'labels', 'tagging', 'reference']
179
+ },
180
+ {
181
+ id: 'session-tools',
182
+ title: 'Session Management Tools',
183
+ description: 'Complete reference for 11 session tools: orient, session-start, session-list, session-read, close, next-session, execute-shell, scan, reindex, stats, help, audit.',
184
+ tags: ['tools', 'session', 'workflow', 'reference']
185
+ },
186
+ {
187
+ id: 'io-tools',
188
+ title: 'File Operations Tools',
189
+ description: 'Complete reference for 13 file I/O tools: read-file, read-multiple, write, create, append, replace-text, replace-many, delete, rename, list, get-symbols, get-annotations, peek.',
190
+ tags: ['tools', 'io', 'files', 'reference']
191
+ }
192
+ ];
193
+ for (const topic of coreTopics) {
194
+ const filePath = path.join(helpDir, `${topic.id}.md`);
195
+ registry.registerTopic({
196
+ id: topic.id,
197
+ title: topic.title,
198
+ source: 'core',
199
+ filePath,
200
+ description: topic.description,
201
+ tags: topic.tags
202
+ });
203
+ }
204
+ }
205
+ // ── Envelope helpers ─────────────────────────────────────────────────────────
206
+ function okEnvelope(data) {
207
+ return { success: true, data };
208
+ }
209
+ function errorEnvelope(error) {
210
+ return { success: false, error };
211
+ }
212
+ /**
213
+ * Get help documentation for a specific topic.
214
+ *
215
+ * @param topic - Help topic to lookup (empty string or 'index' for list of topics)
216
+ * @param registry - HelpRegistry instance
217
+ * @returns Help content as markdown
218
+ */
219
+ async function getHelp(topic, registry) {
220
+ // Empty topic or 'index' - show list of all topics
221
+ if (!topic || topic === 'index' || topic === '') {
222
+ const allTopics = registry.getAllTopicMetadata();
223
+ // Group topics by source
224
+ const coreTopics = allTopics.filter(t => t.source === 'core');
225
+ const pluginTopics = allTopics.filter(t => t.source !== 'core');
226
+ // Build index content dynamically
227
+ let indexContent = '# CodeMap Help Topics\n\n';
228
+ if (coreTopics.length > 0) {
229
+ indexContent += '## Core Topics\n\n';
230
+ for (const topic of coreTopics) {
231
+ indexContent += `### ${topic.id}\n`;
232
+ indexContent += `**${topic.title}**\n\n`;
233
+ if (topic.description) {
234
+ indexContent += `${topic.description}\n\n`;
235
+ }
236
+ if (topic.tags && topic.tags.length > 0) {
237
+ indexContent += `*Tags: ${topic.tags.join(', ')}*\n\n`;
238
+ }
239
+ }
240
+ }
241
+ if (pluginTopics.length > 0) {
242
+ indexContent += '## Plugin Topics\n\n';
243
+ for (const topic of pluginTopics) {
244
+ indexContent += `### ${topic.id}\n`;
245
+ indexContent += `**${topic.title}** *(from ${topic.source})*\n\n`;
246
+ if (topic.description) {
247
+ indexContent += `${topic.description}\n\n`;
248
+ }
249
+ if (topic.tags && topic.tags.length > 0) {
250
+ indexContent += `*Tags: ${topic.tags.join(', ')}*\n\n`;
251
+ }
252
+ }
253
+ }
254
+ indexContent += '\n## How to Use Help\n\n';
255
+ indexContent += '### View a specific topic:\n';
256
+ indexContent += '```\n';
257
+ indexContent += 'codemap_help(topic: "search-patterns")\n';
258
+ indexContent += '```\n\n';
259
+ indexContent += '### List all topics:\n';
260
+ indexContent += '```\n';
261
+ indexContent += 'codemap_help(topic: "")\n';
262
+ indexContent += '```\n\n';
263
+ return okEnvelope({
264
+ topic: 'index',
265
+ content: indexContent,
266
+ availableTopics: registry.getAllTopicIds(),
267
+ topicCount: {
268
+ total: allTopics.length,
269
+ core: coreTopics.length,
270
+ plugin: pluginTopics.length
271
+ }
272
+ });
273
+ }
274
+ // Check if topic exists
275
+ if (!registry.hasTopic(topic)) {
276
+ const availableTopics = registry.getAllTopicIds();
277
+ return errorEnvelope({
278
+ code: 'TOPIC_NOT_FOUND',
279
+ message: `Help topic "${topic}" not found. Available topics: ${availableTopics.join(', ')}`,
280
+ availableTopics,
281
+ requestedTopic: topic,
282
+ suggestion: 'Use codemap_help() or codemap_help(topic: "index") to see all available topics'
283
+ });
284
+ }
285
+ // Load the requested help topic
286
+ const helpTopic = registry.getTopic(topic);
287
+ let content;
288
+ try {
289
+ if (helpTopic.filePath) {
290
+ // Load from file
291
+ content = await fs.readFile(helpTopic.filePath, 'utf-8');
292
+ }
293
+ else if (helpTopic.content) {
294
+ // Use inline content
295
+ content = helpTopic.content;
296
+ }
297
+ else {
298
+ // This should never happen due to validation in registerTopic
299
+ return errorEnvelope({
300
+ code: 'INVALID_TOPIC',
301
+ message: `Help topic "${topic}" has neither filePath nor content`
302
+ });
303
+ }
304
+ return okEnvelope({
305
+ topic,
306
+ title: helpTopic.title,
307
+ source: helpTopic.source,
308
+ tags: helpTopic.tags,
309
+ content,
310
+ availableTopics: registry.getAllTopicIds()
311
+ });
312
+ }
313
+ catch (error) {
314
+ return errorEnvelope({
315
+ code: 'HELP_FILE_NOT_FOUND',
316
+ message: `Help file for topic "${topic}" could not be loaded`,
317
+ filePath: helpTopic.filePath,
318
+ error: error instanceof Error ? error.message : String(error)
319
+ });
320
+ }
321
+ }
322
+ //# sourceMappingURL=help.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"help.js","sourceRoot":"","sources":["../../../src/mcp/operations/help.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,13 @@
1
+ import type { CodeMap } from '../../core/CodeMap';
2
+ interface OperationContext {
3
+ codemap: CodeMap;
4
+ rootPath: string;
5
+ }
6
+ type OperationHandler = (args: Record<string, unknown>, ctx: OperationContext) => Promise<unknown>;
7
+ export declare const closeSession: OperationHandler;
8
+ export declare const reindex: OperationHandler;
9
+ export declare const audit: OperationHandler;
10
+ export declare const executeShell: OperationHandler;
11
+ export declare const nextSession: OperationHandler;
12
+ export {};
13
+ //# sourceMappingURL=session.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../src/mcp/operations/session.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAQlD,UAAU,gBAAgB;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,KAAK,gBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,gBAAgB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAcnG,eAAO,MAAM,YAAY,EAAE,gBAgB1B,CAAC;AAIF,eAAO,MAAM,OAAO,EAAE,gBAuBrB,CAAC;AAIF,eAAO,MAAM,KAAK,EAAE,gBA4BnB,CAAC;AAIF,eAAO,MAAM,YAAY,EAAE,gBAuB1B,CAAC;AAIF,eAAO,MAAM,WAAW,EAAE,gBAkBzB,CAAC"}
@@ -0,0 +1,169 @@
1
+ "use strict";
2
+ // operations/session.ts
3
+ // Session operations: close_session, reindex, audit, execute_shell, next_session
4
+ // Follows Prime's operation handler pattern with okEnvelope/errorEnvelope
5
+ var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
6
+ if (k2 === undefined) k2 = k;
7
+ var desc = Object.getOwnPropertyDescriptor(m, k);
8
+ if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
9
+ desc = { enumerable: true, get: function() { return m[k]; } };
10
+ }
11
+ Object.defineProperty(o, k2, desc);
12
+ }) : (function(o, m, k, k2) {
13
+ if (k2 === undefined) k2 = k;
14
+ o[k2] = m[k];
15
+ }));
16
+ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
17
+ Object.defineProperty(o, "default", { enumerable: true, value: v });
18
+ }) : function(o, v) {
19
+ o["default"] = v;
20
+ });
21
+ var __importStar = (this && this.__importStar) || (function () {
22
+ var ownKeys = function(o) {
23
+ ownKeys = Object.getOwnPropertyNames || function (o) {
24
+ var ar = [];
25
+ for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
26
+ return ar;
27
+ };
28
+ return ownKeys(o);
29
+ };
30
+ return function (mod) {
31
+ if (mod && mod.__esModule) return mod;
32
+ var result = {};
33
+ if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
34
+ __setModuleDefault(result, mod);
35
+ return result;
36
+ };
37
+ })();
38
+ Object.defineProperty(exports, "__esModule", { value: true });
39
+ exports.nextSession = exports.executeShell = exports.audit = exports.reindex = exports.closeSession = void 0;
40
+ const child_process_1 = require("child_process");
41
+ const util_1 = require("util");
42
+ const nodefs = __importStar(require("fs/promises"));
43
+ const path = __importStar(require("path"));
44
+ const execAsync = (0, util_1.promisify)(child_process_1.exec);
45
+ // ── Envelope helpers ─────────────────────────────────────────────────────────
46
+ function okEnvelope(data) {
47
+ return { success: true, data };
48
+ }
49
+ function errorEnvelope(code, message) {
50
+ return { success: false, error: { code, message } };
51
+ }
52
+ // ── close_session ────────────────────────────────────────────────────────────
53
+ const closeSession = async (_args, ctx) => {
54
+ try {
55
+ // Get stats from CodeMap (not QueryEngine)
56
+ const stats = ctx.codemap.getStats();
57
+ return okEnvelope({
58
+ message: 'Session closed',
59
+ stats: {
60
+ files: stats.files,
61
+ symbols: stats.symbols,
62
+ dependencies: stats.dependencies,
63
+ },
64
+ });
65
+ }
66
+ catch (err) {
67
+ return errorEnvelope('CLOSE_ERROR', err instanceof Error ? err.message : String(err));
68
+ }
69
+ };
70
+ exports.closeSession = closeSession;
71
+ // ── reindex ──────────────────────────────────────────────────────────────────
72
+ const reindex = async (_args, ctx) => {
73
+ try {
74
+ // Get stats before scan
75
+ const before = ctx.codemap.getStats();
76
+ // Use public scan() method
77
+ await ctx.codemap.scan();
78
+ // Get stats after scan
79
+ const after = ctx.codemap.getStats();
80
+ return okEnvelope({
81
+ message: 'Reindex complete',
82
+ before: { files: before.files, symbols: before.symbols },
83
+ after: { files: after.files, symbols: after.symbols },
84
+ changes: {
85
+ files: after.files - before.files,
86
+ symbols: after.symbols - before.symbols,
87
+ },
88
+ });
89
+ }
90
+ catch (err) {
91
+ return errorEnvelope('REINDEX_ERROR', err instanceof Error ? err.message : String(err));
92
+ }
93
+ };
94
+ exports.reindex = reindex;
95
+ // ── audit ────────────────────────────────────────────────────────────────────
96
+ const audit = async (_args, ctx) => {
97
+ try {
98
+ // Placeholder: would check architecture violations using annotations
99
+ const allFiles = ctx.codemap.query['graph'].getAllFiles();
100
+ const violations = [];
101
+ for (const file of allFiles) {
102
+ const annotations = file.categorizedAnnotations || [];
103
+ // Audit logic would go here
104
+ // For now, just report files with policy annotations
105
+ if (annotations.length > 0) {
106
+ const resolved = await ctx.codemap.resolver.resolve(file.relativePath);
107
+ violations.push({
108
+ file: resolved.relativePath,
109
+ message: `${annotations.length} annotations found`,
110
+ });
111
+ }
112
+ }
113
+ return okEnvelope({
114
+ violations,
115
+ violationCount: violations.length,
116
+ clean: violations.length === 0,
117
+ });
118
+ }
119
+ catch (err) {
120
+ return errorEnvelope('AUDIT_ERROR', err instanceof Error ? err.message : String(err));
121
+ }
122
+ };
123
+ exports.audit = audit;
124
+ // ── execute_shell ────────────────────────────────────────────────────────────
125
+ const executeShell = async (args, ctx) => {
126
+ const cmd = args.cmd ? String(args.cmd) : '';
127
+ if (!cmd)
128
+ return errorEnvelope('MISSING_ARGS', 'cmd is required');
129
+ const timeout = args.timeout ? Number(args.timeout) : 30000;
130
+ const cwd = args.cwd ? String(args.cwd) : ctx.rootPath;
131
+ try {
132
+ const { stdout, stderr } = await execAsync(cmd, { cwd, timeout });
133
+ return okEnvelope({
134
+ stdout,
135
+ stderr,
136
+ exitCode: 0,
137
+ });
138
+ }
139
+ catch (err) {
140
+ return okEnvelope({
141
+ stdout: err.stdout || '',
142
+ stderr: err.stderr || '',
143
+ exitCode: err.code || 1,
144
+ error: err.message,
145
+ });
146
+ }
147
+ };
148
+ exports.executeShell = executeShell;
149
+ // ── next_session ─────────────────────────────────────────────────────────────
150
+ const nextSession = async (args, ctx) => {
151
+ const text = args.text ? String(args.text) : '';
152
+ if (!text)
153
+ return errorEnvelope('MISSING_ARGS', 'text is required');
154
+ try {
155
+ const sessionDir = path.join(ctx.rootPath, '.codemap', 'sessions');
156
+ await nodefs.mkdir(sessionDir, { recursive: true });
157
+ const nextSessionPath = path.join(sessionDir, 'NEXT_SESSION.md');
158
+ await nodefs.writeFile(nextSessionPath, text, 'utf-8');
159
+ return okEnvelope({
160
+ written: nextSessionPath,
161
+ bytes: text.length,
162
+ });
163
+ }
164
+ catch (err) {
165
+ return errorEnvelope('FS_ERROR', err instanceof Error ? err.message : String(err));
166
+ }
167
+ };
168
+ exports.nextSession = nextSession;
169
+ //# sourceMappingURL=session.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"session.js","sourceRoot":"","sources":["../../../src/mcp/operations/session.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,14 @@
1
+ import type { CodeMap } from '../../core/CodeMap';
2
+ interface OperationContext {
3
+ codemap: CodeMap;
4
+ rootPath: string;
5
+ }
6
+ type OperationHandler = (args: Record<string, unknown>, ctx: OperationContext) => Promise<unknown>;
7
+ export declare const createFile: OperationHandler;
8
+ export declare const appendFile: OperationHandler;
9
+ export declare const replaceText: OperationHandler;
10
+ export declare const replaceMany: OperationHandler;
11
+ export declare const deleteFile: OperationHandler;
12
+ export declare const renameFile: OperationHandler;
13
+ export {};
14
+ //# sourceMappingURL=writes.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"writes.d.ts","sourceRoot":"","sources":["../../../src/mcp/operations/writes.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAIlD,UAAU,gBAAgB;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,KAAK,gBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,gBAAgB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAgCnG,eAAO,MAAM,UAAU,EAAE,gBA4BxB,CAAC;AAIF,eAAO,MAAM,UAAU,EAAE,gBAsBxB,CAAC;AAIF,eAAO,MAAM,WAAW,EAAE,gBA+GzB,CAAC;AAIF,eAAO,MAAM,WAAW,EAAE,gBAkCzB,CAAC;AAIF,eAAO,MAAM,UAAU,EAAE,gBAcxB,CAAC;AAIF,eAAO,MAAM,UAAU,EAAE,gBAqBxB,CAAC"}