@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,614 @@
1
+ /**
2
+ * CodeMap - Main orchestrator class.
3
+ *
4
+ * Ties together FileSystemGraph, FileSystemIO, Scanner, PluginRegistry, and QueryEngine
5
+ * into a single cohesive API. This is the entry point for all CodeMap consumers.
6
+ *
7
+ * Architecture:
8
+ * - Single entry point for all operations
9
+ * - Dependency injection via FileSystemProvider
10
+ * - Plugin-based extensibility
11
+ * - Event-driven lifecycle hooks
12
+ * - Zero Egentica coupling
13
+ *
14
+ * @codemap.domain.name CodeMap Core API
15
+ * @codemap.usage Initialize CodeMap instances and configure root path and file system provider
16
+ * @codemap.usage Register or unregister plugins for language parsing and feature extensions
17
+ * @codemap.usage Access query engine, filesystem gateway, or target resolver APIs
18
+ * @codemap.usage Hook into lifecycle events (scan, file operations) for custom behavior
19
+ * @codemap.usage Change core CodeMap architecture or orchestration logic
20
+ * @codemap.policy This is the ONLY public API. All other classes are internal implementation.
21
+ * @codemap.policy FileSystemProvider defaults to Node.js filesystem — consumers can override if needed.
22
+ *
23
+ * @example Basic Usage
24
+ * ```typescript
25
+ * import { CodeMap, NodeFsProvider } from '@egentica/codemap';
26
+ *
27
+ * // Initialize
28
+ * const codemap = new CodeMap({
29
+ * rootPath: '/project',
30
+ * provider: new NodeFsProvider()
31
+ * });
32
+ *
33
+ * // Register plugins
34
+ * codemap.registerPlugin(new TypeScriptParser());
35
+ * codemap.registerPlugin(new TimeWarpPlugin());
36
+ *
37
+ * // Scan project
38
+ * await codemap.scan();
39
+ *
40
+ * // Query
41
+ * const results = codemap.query.search({ query: 'auth login' });
42
+ * ```
43
+ *
44
+ * @example Event Hooks
45
+ * ```typescript
46
+ * // Hook into file writes
47
+ * codemap.on('file:write:before', async (payload) => {
48
+ * console.log('About to write:', payload.path);
49
+ * });
50
+ *
51
+ * // Hook into scan events
52
+ * codemap.on('scan:file', async (payload) => {
53
+ * console.log('Scanned:', payload.file.relativePath);
54
+ * });
55
+ * ```
56
+ */
57
+ import type { FileSystemProvider } from '../types/contracts/FileSystemProvider';
58
+ import type { Plugin, CodeMapHost, EventHandler } from '../types/contracts/Plugin';
59
+ import type { CodeMapEvent } from '../types/events';
60
+ import type { FileEntry } from '../types/core';
61
+ import { FileSystemGraph } from './FileSystemGraph';
62
+ import { FileSystemIO } from './FileSystemIO';
63
+ import { TargetResolver } from './TargetResolver';
64
+ import { PluginRegistry } from './PluginRegistry';
65
+ import { ParserRegistry } from './ParserRegistry';
66
+ import { QueryEngine } from './QueryEngine';
67
+ import { HelpRegistry } from './HelpRegistry';
68
+ import { GroupStore } from './GroupStore';
69
+ import { SessionTransactionLog } from './SessionTransactionLog';
70
+ import { ChecklistStore } from './ChecklistStore';
71
+ import { BackupManager } from './BackupManager';
72
+ import { AnnotationStore } from './AnnotationStore';
73
+ import { LabelStore } from './LabelStore';
74
+ import { DisplayFilter } from './DisplayFilter';
75
+ /**
76
+ * Configuration for CodeMap initialization.
77
+ */
78
+ export interface CodeMapConfig {
79
+ /**
80
+ * Root path of the project.
81
+ * All file operations are scoped to this path.
82
+ */
83
+ rootPath: string;
84
+ /**
85
+ * File system provider implementation.
86
+ * Defaults to Node.js filesystem (defaultFsProvider) if not provided.
87
+ */
88
+ provider?: FileSystemProvider;
89
+ /**
90
+ * Optional: Patterns to ignore during scan.
91
+ * Defaults to common ignore patterns (node_modules, .git, etc.).
92
+ */
93
+ ignorePatterns?: string[];
94
+ /**
95
+ * Optional: Bypass hardcoded directory name ignores.
96
+ * When true, allows scanning node_modules, dist, build, etc.
97
+ * Default: false (hardcoded ignores are active).
98
+ */
99
+ bypassHardcodedIgnoreList?: boolean;
100
+ }
101
+ /**
102
+ * CodeMap orchestrator.
103
+ * Main entry point for all CodeMap operations.
104
+ */
105
+ export declare class CodeMap implements CodeMapHost {
106
+ /**
107
+ * Root path of the project.
108
+ */
109
+ readonly rootPath: string;
110
+ /**
111
+ * Knowledge graph access.
112
+ *
113
+ * Direct read-only access to the file system graph.
114
+ * Contains all files, symbols, and dependencies.
115
+ *
116
+ * @example
117
+ * ```typescript
118
+ * const file = codemap.graph.getFile('src/auth/login.ts');
119
+ * const allFiles = codemap.graph.getAllFiles();
120
+ * ```
121
+ */
122
+ readonly graph: FileSystemGraph;
123
+ /**
124
+ * Internal event bus.
125
+ */
126
+ private eventBus;
127
+ /**
128
+ * Target resolver (central path/symbol formatting).
129
+ */
130
+ private targetResolver;
131
+ /**
132
+ * File system gateway (emits lifecycle events).
133
+ */
134
+ private fsGateway;
135
+ /**
136
+ * Scanner (walks directory tree).
137
+ */
138
+ private scanner;
139
+ /**
140
+ * Plugin registry for managing plugin lifecycle.
141
+ */
142
+ pluginRegistry: PluginRegistry;
143
+ /**
144
+ * Parser registry for bundled language parsers.
145
+ */
146
+ private parserRegistry;
147
+ /**
148
+ * Help registry (core + plugin help topics).
149
+ */
150
+ private _helpRegistry;
151
+ /**
152
+ * Backup manager (hybrid backup system for persistent storage).
153
+ */
154
+ private _backupManager;
155
+ /**
156
+ * Display filter (hint and annotation suppression).
157
+ */
158
+ private _displayFilter;
159
+ /**
160
+ * Group store (persistent code organization).
161
+ */
162
+ private _groupStore;
163
+ /**
164
+ * Annotation store (persistent metadata storage).
165
+ */
166
+ private _annotationStore;
167
+ /**
168
+ * Label store (persistent label system).
169
+ */
170
+ private _labelStore;
171
+ /**
172
+ * Session transaction log (semi-persistent session tracking).
173
+ */
174
+ private _sessionLog;
175
+ /**
176
+ * Checklist store (persistent workflow guidance).
177
+ */
178
+ private _checklistStore;
179
+ /**
180
+ * Query engine (search and traversal).
181
+ */
182
+ private queryEngine;
183
+ /**
184
+ * File system provider (always defined after construction).
185
+ */
186
+ private provider;
187
+ /**
188
+ * Full config loaded from .codemap/config.json.
189
+ */
190
+ private _config;
191
+ /**
192
+ * Track whether parsers have been auto-loaded.
193
+ */
194
+ private _parsersLoaded;
195
+ constructor(config: CodeMapConfig);
196
+ /**
197
+ * Setup automatic transaction tracking for session logging.
198
+ *
199
+ * Hooks into lifecycle events to automatically track:
200
+ * - File operations (create, update, delete, rename)
201
+ * - Group operations (add, notate)
202
+ * - Annotation operations (add)
203
+ *
204
+ * All tracked operations are logged to .codemap/session-transactions.json
205
+ * until session close (codemap_close).
206
+ */
207
+ private setupSessionTracking;
208
+ /**
209
+ * Load config from .codemap/config.json.
210
+ * Called during initialization, stores config for tool access.
211
+ */
212
+ private loadConfig;
213
+ /**
214
+ * Register a plugin.
215
+ *
216
+ * Plugins hook into lifecycle events and extend CodeMap functionality.
217
+ * Examples: language parsers, TimeWarp, custom enrichments.
218
+ *
219
+ * @param plugin - Plugin to register
220
+ */
221
+ registerPlugin(plugin: Plugin): Promise<void>;
222
+ /**
223
+ * Unregister a plugin by name.
224
+ *
225
+ * @param name - Plugin name
226
+ * @returns True if plugin was unregistered
227
+ */
228
+ unregisterPlugin(name: string): Promise<boolean>;
229
+ /**
230
+ * Execute full project scan.
231
+ *
232
+ * Walks directory tree, emits events, populates graph.
233
+ * Automatically loads bundled parsers on first scan.
234
+ * Plugins hook into scan:file events to extract symbols.
235
+ *
236
+ * @returns Scan statistics
237
+ */
238
+ scan(): Promise<{
239
+ filesScanned: number;
240
+ directoriesScanned: number;
241
+ durationMs: number;
242
+ }>;
243
+ /**
244
+ * Query engine access.
245
+ *
246
+ * Provides search, traversal, and discovery methods.
247
+ *
248
+ * @example
249
+ * ```typescript
250
+ * const results = codemap.query.search({ query: 'auth' });
251
+ * const importers = codemap.query.findImporters('src/auth.ts');
252
+ * ```
253
+ */
254
+ get query(): QueryEngine;
255
+ /**
256
+ * File system gateway access.
257
+ *
258
+ * All file operations go through this gateway.
259
+ * Emits lifecycle events (file:write:before, file:write:after, etc.).
260
+ *
261
+ * @example
262
+ * ```typescript
263
+ * const content = await codemap.fs.read('src/index.ts');
264
+ * await codemap.fs.write('src/new.ts', 'export const x = 1;');
265
+ * ```
266
+ */
267
+ get fs(): {
268
+ read(path: string): Promise<string>;
269
+ write(path: string, content: string): Promise<void>;
270
+ exists(path: string): Promise<boolean>;
271
+ };
272
+ /**
273
+ * I/O gateway access.
274
+ *
275
+ * Provides full filesystem operations with lifecycle event emission.
276
+ * Storage-agnostic: works with any FileSystemProvider (Node.js fs, database, memory, S3, etc.).
277
+ *
278
+ * All write operations (write, remove, rename, mkdir) emit lifecycle events
279
+ * that plugins hook into (TimeWarp, graph updates, logging, etc.).
280
+ *
281
+ * @example
282
+ * ```typescript
283
+ * // Read operations
284
+ * const entries = await codemap.io.readdir(dirPath);
285
+ * const stats = await codemap.io.stat(filePath);
286
+ * const content = await codemap.io.read(filePath);
287
+ *
288
+ * // Write operations (emit events)
289
+ * await codemap.io.write(path, content); // Emits file:write:before/after
290
+ * await codemap.io.remove(path); // Emits file:delete
291
+ * await codemap.io.rename(oldPath, newPath); // Emits file:rename
292
+ * await codemap.io.mkdir(dirPath); // Creates directory
293
+ * await codemap.io.append(path, text); // Appends to file
294
+ * ```
295
+ */
296
+ get io(): FileSystemIO;
297
+ /**
298
+ * Target resolver access.
299
+ *
300
+ * Central resolution and formatting for all paths/symbols.
301
+ * Use this to convert between absolute paths and relative paths.
302
+ *
303
+ * @example
304
+ * ```typescript
305
+ * const resolved = codemap.resolver.resolve('src/main/index.ts');
306
+ * const relativePath = resolved.relativePath; // "src/main/index.ts"
307
+ * ```
308
+ */
309
+ get resolver(): TargetResolver;
310
+ /**
311
+ * Label store access.
312
+ *
313
+ * Manage labels for organizing and categorizing code entities.
314
+ *
315
+ * @example
316
+ * ```typescript
317
+ * const labels = await codemap.labels.list();
318
+ * await codemap.labels.assign('my-label', ['src/auth/login.ts']);
319
+ * ```
320
+ */
321
+ get labels(): LabelStore;
322
+ /**
323
+ * Group store access.
324
+ *
325
+ * Manage code groups for organizing related files and symbols.
326
+ *
327
+ * @example
328
+ * ```typescript
329
+ * const groups = await codemap.groups.list();
330
+ * const group = await codemap.groups.get('auth-system');
331
+ * ```
332
+ */
333
+ get groups(): GroupStore;
334
+ /**
335
+ * Session transaction log access.
336
+ *
337
+ * Track changes and operations during a session.
338
+ *
339
+ * @example
340
+ * ```typescript
341
+ * const history = await codemap.sessions.list();
342
+ * const session = await codemap.sessions.get(sessionId);
343
+ * ```
344
+ */
345
+ get sessions(): SessionTransactionLog;
346
+ /**
347
+ * Annotation store access.
348
+ *
349
+ * Manage code annotations for documentation and metadata.
350
+ *
351
+ * @example
352
+ * ```typescript
353
+ * await codemap.annotations.add('src/auth.ts', {
354
+ * key: 'domain.name',
355
+ * value: 'Authentication System'
356
+ * });
357
+ * ```
358
+ */
359
+ get annotations(): AnnotationStore;
360
+ /**
361
+ * Register a lifecycle event handler.
362
+ *
363
+ * Implements CodeMapHost interface for plugins.
364
+ *
365
+ * @param event - Event name
366
+ * @param handler - Event handler
367
+ */
368
+ on(event: CodeMapEvent, handler: EventHandler): void;
369
+ /**
370
+ * Remove event handler.
371
+ *
372
+ * @param event - Event name
373
+ * @param handler - Handler to remove
374
+ */
375
+ off<T = unknown>(event: CodeMapEvent, handler?: EventHandler<T>): void;
376
+ /**
377
+ * Add a symbol to the graph.
378
+ *
379
+ * Implements CodeMapHost interface for plugins.
380
+ * Used by language parsers to enrich the graph.
381
+ *
382
+ * @param symbol - Symbol metadata
383
+ */
384
+ addSymbol(symbol: {
385
+ kind: string;
386
+ name: string;
387
+ line: number;
388
+ file: FileEntry;
389
+ }): void;
390
+ /**
391
+ * Add a dependency edge to the graph.
392
+ *
393
+ * Implements CodeMapHost interface for plugins.
394
+ * Used by parsers to track import relationships.
395
+ *
396
+ * @param from - Source file (relative path)
397
+ * @param to - Target file (relative path)
398
+ */
399
+ addDependency(from: string, to: string): void;
400
+ /**
401
+ * Get plugin-specific configuration from .codemap/config.json.
402
+ * Returns undefined if plugin config not present.
403
+ *
404
+ * @param pluginName - Name of the plugin (should match Plugin.name)
405
+ * @returns Plugin configuration object or undefined
406
+ */
407
+ getPluginConfig(pluginName: string): Record<string, unknown> | undefined;
408
+ /**
409
+ * Set plugin metadata on a file.
410
+ * Emits 'metadata:set' event for tracking.
411
+ *
412
+ * @param path - File path (relative or absolute)
413
+ * @param key - Metadata key (namespace: pluginName.fieldName)
414
+ * @param value - Metadata value (must be JSON-serializable)
415
+ */
416
+ setMetadata(path: string, key: string, value: unknown): void;
417
+ /**
418
+ * Get plugin metadata from a file.
419
+ * Emits 'metadata:get' event for tracking.
420
+ *
421
+ * @param path - File path (relative or absolute)
422
+ * @param key - Metadata key (namespace: pluginName.fieldName)
423
+ * @returns Metadata value or undefined if not found
424
+ */
425
+ getMetadata(path: string, key: string): unknown;
426
+ /**
427
+ * Get a file entry from the graph (read-only).
428
+ * Delegates to FileSystemGraph for consistent access.
429
+ *
430
+ * @param path - File path (relative or absolute)
431
+ * @returns File entry or undefined if not found
432
+ */
433
+ getFile(path: string): FileEntry | undefined;
434
+ /**
435
+ * Query the graph with advanced filters (read-only).
436
+ * Delegates to QueryEngine for consistent search behavior.
437
+ *
438
+ * @param options - Search options
439
+ * @returns Search results sorted by relevance
440
+ */
441
+ queryGraph(options: {
442
+ query: string;
443
+ mode?: 'text' | 'symbol' | 'hybrid';
444
+ maxResults?: number;
445
+ }): Array<{
446
+ file: FileEntry;
447
+ relevance: number;
448
+ reasons: string[];
449
+ }>;
450
+ /**
451
+ * Get all files that import or are imported by a given file.
452
+ * Traverses the dependency graph recursively.
453
+ *
454
+ * @param path - File path (relative or absolute)
455
+ * @param direction - 'imports' (what it imports) or 'importers' (what imports it)
456
+ * @param maxDepth - Maximum traversal depth (default: 3)
457
+ * @returns Array of file entries in dependency chain
458
+ */
459
+ traverseDependencies(path: string, direction: 'imports' | 'importers', maxDepth?: number): FileEntry[];
460
+ /**
461
+ * Get graph statistics.
462
+ *
463
+ * @returns File/directory/symbol counts
464
+ */
465
+ getStats(): {
466
+ files: number;
467
+ directories: number;
468
+ symbols: number;
469
+ dependencies: number;
470
+ };
471
+ /**
472
+ * Get file entry by relative path.
473
+ * Returns file metadata including symbols if available.
474
+ /**
475
+ * Get registered plugins.
476
+ *
477
+ * @returns Array of plugin names
478
+ */
479
+ getPlugins(): string[];
480
+ /**
481
+ * Get plugin info (name, version, registration time).
482
+ * \n * @returns Array of plugin metadata
483
+ */
484
+ getPluginInfo(): Array<{
485
+ name: string;
486
+ version: string;
487
+ registeredAt: number;
488
+ }>;
489
+ /**
490
+ * Get help registry.
491
+ *
492
+ * Provides access to the help topic registry for both core and plugin help content.
493
+ * Plugins can register their own help topics via this registry.
494
+ *
495
+ * @returns HelpRegistry instance
496
+ */
497
+ get helpRegistry(): HelpRegistry;
498
+ /**
499
+ * Get group store.
500
+ *
501
+ * Provides access to the persistent group storage for organizing code.
502
+ * Groups persist in .codemap/groups.json and survive reboots.
503
+ *
504
+ * @returns GroupStore instance
505
+ */
506
+ get groupStore(): GroupStore;
507
+ /**
508
+ * Get annotation store.
509
+ *
510
+ * Provides access to the annotation metadata storage system.
511
+ * Annotations persist in .codemap/annotations.json.
512
+ *
513
+ * @returns AnnotationStore instance
514
+ */
515
+ get annotationStore(): AnnotationStore;
516
+ /**
517
+ * Get label store.
518
+ *
519
+ * Provides access to the persistent label system for organizing code.
520
+ * Labels persist in .codemap/labels.json and survive reboots.
521
+ *
522
+ * @returns LabelStore instance
523
+ */
524
+ get labelStore(): LabelStore;
525
+ /**
526
+ * Get backup manager.
527
+ *
528
+ * Provides access to the backup system for persistent storage files.
529
+ * Manages daily and turn-based backups with configurable retention.
530
+ *
531
+ * @returns BackupManager instance
532
+ */
533
+ get backupManager(): BackupManager;
534
+ /**
535
+ * Get display filter.
536
+ *
537
+ * Provides access to the hint and annotation suppression system.
538
+ * Reduces context pollution by tracking and suppressing repetitive content.
539
+ *
540
+ * @returns DisplayFilter instance
541
+ */
542
+ get displayFilter(): DisplayFilter;
543
+ /**
544
+ * Get session transaction log.
545
+ *
546
+ * Provides access to the semi-persistent session tracking system.
547
+ * Transactions persist in .codemap/session-transactions.json until session close.
548
+ *
549
+ * @returns SessionTransactionLog instance
550
+ */
551
+ get sessionLog(): SessionTransactionLog;
552
+ /**
553
+ * Get checklist store.
554
+ *
555
+ * Provides access to the persistent checklist system for workflow guidance.
556
+ * Checklists persist in .codemap/checklists.json (version controlled).
557
+ *
558
+ * @returns ChecklistStore instance
559
+ */
560
+ get checklistStore(): ChecklistStore;
561
+ /**
562
+ * Get config.
563
+ *
564
+ * Provides access to the full config loaded from .codemap/config.json.
565
+ * Config is loaded asynchronously during initialization.
566
+ *
567
+ * @returns Config object
568
+ */
569
+ get config(): Record<string, any>;
570
+ /**
571
+ * Set the parser registry.
572
+ * Called by the MCP server after creating ParserRegistry.
573
+ *
574
+ * @param registry - Parser registry instance
575
+ */
576
+ setParserRegistry(registry: ParserRegistry): void;
577
+ /**
578
+ * Get loaded language parsers.
579
+ *
580
+ * @returns Array of parser metadata (name, version, extensions)
581
+ */
582
+ getLoadedParsers(): Array<{
583
+ name: string;
584
+ version: string;
585
+ extensions: string[];
586
+ }>;
587
+ /**
588
+ * Get a language parser that can handle the given file.
589
+ * Used for annotation manipulation and other parser-specific operations.
590
+ *
591
+ * @param filePath - File path to find parser for
592
+ * @returns LanguageParser instance or undefined
593
+ */
594
+ getParserForFile(filePath: string): any | undefined;
595
+ /**
596
+ * Collect orient contributions from all registered plugins.
597
+ * Emits `orient:contribute` event and gathers markdown sections from plugins.
598
+ *
599
+ * @returns Array of plugin contributions sorted by priority (high to low)
600
+ */
601
+ collectOrientContributions(): Promise<Array<{
602
+ title: string;
603
+ markdown: string;
604
+ priority: number;
605
+ }>>;
606
+ /**
607
+ * Cleanup and shutdown.
608
+ *
609
+ * Unregisters all plugins, clears event handlers.
610
+ * Call this before disposing of CodeMap instance.
611
+ */
612
+ dispose(): Promise<void>;
613
+ }
614
+ //# sourceMappingURL=CodeMap.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"CodeMap.d.ts","sourceRoot":"","sources":["../../src/core/CodeMap.ts"],"names":[],"mappings":"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"}