contextpro-mcp 0.0.0-stage → 1.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (466) hide show
  1. package/CHANGELOG.md +416 -0
  2. package/INSTALL.md +128 -0
  3. package/INSTRUCTIONS.md +33 -0
  4. package/LICENSE +21 -0
  5. package/NOTICE +12 -0
  6. package/README.md +164 -2
  7. package/SECURITY.md +27 -0
  8. package/agent-guide.md +323 -0
  9. package/agent-instructions.md +1 -0
  10. package/build/core/agent-setup.d.ts +5 -0
  11. package/build/core/agent-setup.d.ts.map +1 -0
  12. package/build/core/agent-setup.js +94 -0
  13. package/build/core/agent-setup.js.map +1 -0
  14. package/build/core/artifacts.d.ts +64 -0
  15. package/build/core/artifacts.d.ts.map +1 -0
  16. package/build/core/artifacts.js +370 -0
  17. package/build/core/artifacts.js.map +1 -0
  18. package/build/core/bounded-source.d.ts +15 -0
  19. package/build/core/bounded-source.d.ts.map +1 -0
  20. package/build/core/bounded-source.js +78 -0
  21. package/build/core/bounded-source.js.map +1 -0
  22. package/build/core/changed-since.d.ts +20 -0
  23. package/build/core/changed-since.d.ts.map +1 -0
  24. package/build/core/changed-since.js +43 -0
  25. package/build/core/changed-since.js.map +1 -0
  26. package/build/core/chat-model.d.ts +8 -0
  27. package/build/core/chat-model.d.ts.map +1 -0
  28. package/build/core/chat-model.js +135 -0
  29. package/build/core/chat-model.js.map +1 -0
  30. package/build/core/clustering.d.ts +6 -0
  31. package/build/core/clustering.d.ts.map +1 -0
  32. package/build/core/clustering.js +201 -0
  33. package/build/core/clustering.js.map +1 -0
  34. package/build/core/context-metadata.d.ts +50 -0
  35. package/build/core/context-metadata.d.ts.map +1 -0
  36. package/build/core/context-metadata.js +118 -0
  37. package/build/core/context-metadata.js.map +1 -0
  38. package/build/core/data-dir.d.ts +5 -0
  39. package/build/core/data-dir.d.ts.map +1 -0
  40. package/build/core/data-dir.js +53 -0
  41. package/build/core/data-dir.js.map +1 -0
  42. package/build/core/db-native.d.ts +28 -0
  43. package/build/core/db-native.d.ts.map +1 -0
  44. package/build/core/db-native.js +120 -0
  45. package/build/core/db-native.js.map +1 -0
  46. package/build/core/db.d.ts +294 -0
  47. package/build/core/db.d.ts.map +1 -0
  48. package/build/core/db.js +1047 -0
  49. package/build/core/db.js.map +1 -0
  50. package/build/core/doctor.d.ts +13 -0
  51. package/build/core/doctor.d.ts.map +1 -0
  52. package/build/core/doctor.js +55 -0
  53. package/build/core/doctor.js.map +1 -0
  54. package/build/core/efficiency.d.ts +16 -0
  55. package/build/core/efficiency.d.ts.map +1 -0
  56. package/build/core/efficiency.js +170 -0
  57. package/build/core/efficiency.js.map +1 -0
  58. package/build/core/embedding-tracker.d.ts +25 -0
  59. package/build/core/embedding-tracker.d.ts.map +1 -0
  60. package/build/core/embedding-tracker.js +228 -0
  61. package/build/core/embedding-tracker.js.map +1 -0
  62. package/build/core/embeddings.d.ts +90 -0
  63. package/build/core/embeddings.d.ts.map +1 -0
  64. package/build/core/embeddings.js +693 -0
  65. package/build/core/embeddings.js.map +1 -0
  66. package/build/core/evidence-state.d.ts +42 -0
  67. package/build/core/evidence-state.d.ts.map +1 -0
  68. package/build/core/evidence-state.js +153 -0
  69. package/build/core/evidence-state.js.map +1 -0
  70. package/build/core/extractor-stamp.d.ts +10 -0
  71. package/build/core/extractor-stamp.d.ts.map +1 -0
  72. package/build/core/extractor-stamp.js +51 -0
  73. package/build/core/extractor-stamp.js.map +1 -0
  74. package/build/core/feature-brief-cache.d.ts +37 -0
  75. package/build/core/feature-brief-cache.d.ts.map +1 -0
  76. package/build/core/feature-brief-cache.js +100 -0
  77. package/build/core/feature-brief-cache.js.map +1 -0
  78. package/build/core/file-fingerprint.d.ts +15 -0
  79. package/build/core/file-fingerprint.d.ts.map +1 -0
  80. package/build/core/file-fingerprint.js +24 -0
  81. package/build/core/file-fingerprint.js.map +1 -0
  82. package/build/core/graph-analytics.d.ts +46 -0
  83. package/build/core/graph-analytics.d.ts.map +1 -0
  84. package/build/core/graph-analytics.js +371 -0
  85. package/build/core/graph-analytics.js.map +1 -0
  86. package/build/core/hub.d.ts +23 -0
  87. package/build/core/hub.d.ts.map +1 -0
  88. package/build/core/hub.js +123 -0
  89. package/build/core/hub.js.map +1 -0
  90. package/build/core/ignore-dirs.d.ts +7 -0
  91. package/build/core/ignore-dirs.d.ts.map +1 -0
  92. package/build/core/ignore-dirs.js +84 -0
  93. package/build/core/ignore-dirs.js.map +1 -0
  94. package/build/core/index-freshness.d.ts +15 -0
  95. package/build/core/index-freshness.d.ts.map +1 -0
  96. package/build/core/index-freshness.js +96 -0
  97. package/build/core/index-freshness.js.map +1 -0
  98. package/build/core/index-reconcile.d.ts +28 -0
  99. package/build/core/index-reconcile.d.ts.map +1 -0
  100. package/build/core/index-reconcile.js +129 -0
  101. package/build/core/index-reconcile.js.map +1 -0
  102. package/build/core/local-daemon.d.ts +5 -0
  103. package/build/core/local-daemon.d.ts.map +1 -0
  104. package/build/core/local-daemon.js +282 -0
  105. package/build/core/local-daemon.js.map +1 -0
  106. package/build/core/memory-graph.d.ts +68 -0
  107. package/build/core/memory-graph.d.ts.map +1 -0
  108. package/build/core/memory-graph.js +152 -0
  109. package/build/core/memory-graph.js.map +1 -0
  110. package/build/core/native-repair.d.ts +12 -0
  111. package/build/core/native-repair.d.ts.map +1 -0
  112. package/build/core/native-repair.js +167 -0
  113. package/build/core/native-repair.js.map +1 -0
  114. package/build/core/native-runtime.d.ts +12 -0
  115. package/build/core/native-runtime.d.ts.map +1 -0
  116. package/build/core/native-runtime.js +38 -0
  117. package/build/core/native-runtime.js.map +1 -0
  118. package/build/core/pagerank.d.ts +29 -0
  119. package/build/core/pagerank.d.ts.map +1 -0
  120. package/build/core/pagerank.js +90 -0
  121. package/build/core/pagerank.js.map +1 -0
  122. package/build/core/parser-process.d.ts +21 -0
  123. package/build/core/parser-process.d.ts.map +1 -0
  124. package/build/core/parser-process.js +103 -0
  125. package/build/core/parser-process.js.map +1 -0
  126. package/build/core/parser-worker.d.ts +2 -0
  127. package/build/core/parser-worker.d.ts.map +1 -0
  128. package/build/core/parser-worker.js +17 -0
  129. package/build/core/parser-worker.js.map +1 -0
  130. package/build/core/parser.d.ts +66 -0
  131. package/build/core/parser.d.ts.map +1 -0
  132. package/build/core/parser.js +750 -0
  133. package/build/core/parser.js.map +1 -0
  134. package/build/core/path-guard.d.ts +6 -0
  135. package/build/core/path-guard.d.ts.map +1 -0
  136. package/build/core/path-guard.js +55 -0
  137. package/build/core/path-guard.js.map +1 -0
  138. package/build/core/process-lifecycle.d.ts +30 -0
  139. package/build/core/process-lifecycle.d.ts.map +1 -0
  140. package/build/core/process-lifecycle.js +129 -0
  141. package/build/core/process-lifecycle.js.map +1 -0
  142. package/build/core/project-config.d.ts +83 -0
  143. package/build/core/project-config.d.ts.map +1 -0
  144. package/build/core/project-config.js +302 -0
  145. package/build/core/project-config.js.map +1 -0
  146. package/build/core/project-graph.d.ts +69 -0
  147. package/build/core/project-graph.d.ts.map +1 -0
  148. package/build/core/project-graph.js +874 -0
  149. package/build/core/project-graph.js.map +1 -0
  150. package/build/core/provider-config.d.ts +15 -0
  151. package/build/core/provider-config.d.ts.map +1 -0
  152. package/build/core/provider-config.js +67 -0
  153. package/build/core/provider-config.js.map +1 -0
  154. package/build/core/provider-usage.d.ts +21 -0
  155. package/build/core/provider-usage.d.ts.map +1 -0
  156. package/build/core/provider-usage.js +52 -0
  157. package/build/core/provider-usage.js.map +1 -0
  158. package/build/core/python-language-server.d.ts +23 -0
  159. package/build/core/python-language-server.d.ts.map +1 -0
  160. package/build/core/python-language-server.js +217 -0
  161. package/build/core/python-language-server.js.map +1 -0
  162. package/build/core/python-runtime-identity.d.ts +3 -0
  163. package/build/core/python-runtime-identity.d.ts.map +1 -0
  164. package/build/core/python-runtime-identity.js +53 -0
  165. package/build/core/python-runtime-identity.js.map +1 -0
  166. package/build/core/reconcile-scheduler.d.ts +20 -0
  167. package/build/core/reconcile-scheduler.d.ts.map +1 -0
  168. package/build/core/reconcile-scheduler.js +58 -0
  169. package/build/core/reconcile-scheduler.js.map +1 -0
  170. package/build/core/request-context.d.ts +7 -0
  171. package/build/core/request-context.d.ts.map +1 -0
  172. package/build/core/request-context.js +17 -0
  173. package/build/core/request-context.js.map +1 -0
  174. package/build/core/request-root.d.ts +19 -0
  175. package/build/core/request-root.d.ts.map +1 -0
  176. package/build/core/request-root.js +26 -0
  177. package/build/core/request-root.js.map +1 -0
  178. package/build/core/root-guard.d.ts +8 -0
  179. package/build/core/root-guard.d.ts.map +1 -0
  180. package/build/core/root-guard.js +53 -0
  181. package/build/core/root-guard.js.map +1 -0
  182. package/build/core/roots-detect.d.ts +17 -0
  183. package/build/core/roots-detect.d.ts.map +1 -0
  184. package/build/core/roots-detect.js +63 -0
  185. package/build/core/roots-detect.js.map +1 -0
  186. package/build/core/runtime-session.d.ts +5 -0
  187. package/build/core/runtime-session.d.ts.map +1 -0
  188. package/build/core/runtime-session.js +10 -0
  189. package/build/core/runtime-session.js.map +1 -0
  190. package/build/core/scip-index.d.ts +71 -0
  191. package/build/core/scip-index.d.ts.map +1 -0
  192. package/build/core/scip-index.js +343 -0
  193. package/build/core/scip-index.js.map +1 -0
  194. package/build/core/semantic-diff.d.ts +32 -0
  195. package/build/core/semantic-diff.d.ts.map +1 -0
  196. package/build/core/semantic-diff.js +259 -0
  197. package/build/core/semantic-diff.js.map +1 -0
  198. package/build/core/source-context.d.ts +3 -0
  199. package/build/core/source-context.d.ts.map +1 -0
  200. package/build/core/source-context.js +86 -0
  201. package/build/core/source-context.js.map +1 -0
  202. package/build/core/source-mask.d.ts +8 -0
  203. package/build/core/source-mask.d.ts.map +1 -0
  204. package/build/core/source-mask.js +156 -0
  205. package/build/core/source-mask.js.map +1 -0
  206. package/build/core/source-mutation.d.ts +16 -0
  207. package/build/core/source-mutation.d.ts.map +1 -0
  208. package/build/core/source-mutation.js +193 -0
  209. package/build/core/source-mutation.js.map +1 -0
  210. package/build/core/sql-schema.d.ts +59 -0
  211. package/build/core/sql-schema.d.ts.map +1 -0
  212. package/build/core/sql-schema.js +218 -0
  213. package/build/core/sql-schema.js.map +1 -0
  214. package/build/core/startup-health.d.ts +40 -0
  215. package/build/core/startup-health.d.ts.map +1 -0
  216. package/build/core/startup-health.js +132 -0
  217. package/build/core/startup-health.js.map +1 -0
  218. package/build/core/team-ledger.d.ts +60 -0
  219. package/build/core/team-ledger.d.ts.map +1 -0
  220. package/build/core/team-ledger.js +171 -0
  221. package/build/core/team-ledger.js.map +1 -0
  222. package/build/core/test-impact.d.ts +23 -0
  223. package/build/core/test-impact.d.ts.map +1 -0
  224. package/build/core/test-impact.js +131 -0
  225. package/build/core/test-impact.js.map +1 -0
  226. package/build/core/tool-metrics.d.ts +29 -0
  227. package/build/core/tool-metrics.d.ts.map +1 -0
  228. package/build/core/tool-metrics.js +74 -0
  229. package/build/core/tool-metrics.js.map +1 -0
  230. package/build/core/tool-profile.d.ts +12 -0
  231. package/build/core/tool-profile.d.ts.map +1 -0
  232. package/build/core/tool-profile.js +102 -0
  233. package/build/core/tool-profile.js.map +1 -0
  234. package/build/core/tool-trace.d.ts +8 -0
  235. package/build/core/tool-trace.d.ts.map +1 -0
  236. package/build/core/tool-trace.js +70 -0
  237. package/build/core/tool-trace.js.map +1 -0
  238. package/build/core/tree-sitter-runtime.d.ts +20 -0
  239. package/build/core/tree-sitter-runtime.d.ts.map +1 -0
  240. package/build/core/tree-sitter-runtime.js +324 -0
  241. package/build/core/tree-sitter-runtime.js.map +1 -0
  242. package/build/core/tree-sitter.d.ts +6 -0
  243. package/build/core/tree-sitter.d.ts.map +1 -0
  244. package/build/core/tree-sitter.js +24 -0
  245. package/build/core/tree-sitter.js.map +1 -0
  246. package/build/core/typescript-reference-process.d.ts +30 -0
  247. package/build/core/typescript-reference-process.d.ts.map +1 -0
  248. package/build/core/typescript-reference-process.js +124 -0
  249. package/build/core/typescript-reference-process.js.map +1 -0
  250. package/build/core/typescript-reference-worker.d.ts +2 -0
  251. package/build/core/typescript-reference-worker.d.ts.map +1 -0
  252. package/build/core/typescript-reference-worker.js +14 -0
  253. package/build/core/typescript-reference-worker.js.map +1 -0
  254. package/build/core/typescript-references.d.ts +71 -0
  255. package/build/core/typescript-references.d.ts.map +1 -0
  256. package/build/core/typescript-references.js +392 -0
  257. package/build/core/typescript-references.js.map +1 -0
  258. package/build/core/typescript-skeleton.d.ts +5 -0
  259. package/build/core/typescript-skeleton.d.ts.map +1 -0
  260. package/build/core/typescript-skeleton.js +49 -0
  261. package/build/core/typescript-skeleton.js.map +1 -0
  262. package/build/core/walker.d.ts +16 -0
  263. package/build/core/walker.d.ts.map +1 -0
  264. package/build/core/walker.js +152 -0
  265. package/build/core/walker.js.map +1 -0
  266. package/build/core/workspace-router.d.ts +28 -0
  267. package/build/core/workspace-router.d.ts.map +1 -0
  268. package/build/core/workspace-router.js +93 -0
  269. package/build/core/workspace-router.js.map +1 -0
  270. package/build/core/worktree-gc.d.ts +16 -0
  271. package/build/core/worktree-gc.d.ts.map +1 -0
  272. package/build/core/worktree-gc.js +69 -0
  273. package/build/core/worktree-gc.js.map +1 -0
  274. package/build/core/worktree-overlay.d.ts +22 -0
  275. package/build/core/worktree-overlay.d.ts.map +1 -0
  276. package/build/core/worktree-overlay.js +84 -0
  277. package/build/core/worktree-overlay.js.map +1 -0
  278. package/build/core/worktree-root-guard.d.ts +8 -0
  279. package/build/core/worktree-root-guard.d.ts.map +1 -0
  280. package/build/core/worktree-root-guard.js +82 -0
  281. package/build/core/worktree-root-guard.js.map +1 -0
  282. package/build/core/worktree-seed.d.ts +14 -0
  283. package/build/core/worktree-seed.d.ts.map +1 -0
  284. package/build/core/worktree-seed.js +98 -0
  285. package/build/core/worktree-seed.js.map +1 -0
  286. package/build/git/shadow.d.ts +40 -0
  287. package/build/git/shadow.d.ts.map +1 -0
  288. package/build/git/shadow.js +298 -0
  289. package/build/git/shadow.js.map +1 -0
  290. package/build/index.d.ts +3 -0
  291. package/build/index.d.ts.map +1 -0
  292. package/build/index.js +599 -0
  293. package/build/index.js.map +1 -0
  294. package/build/tools/agentic-context.d.ts +86 -0
  295. package/build/tools/agentic-context.d.ts.map +1 -0
  296. package/build/tools/agentic-context.js +1546 -0
  297. package/build/tools/agentic-context.js.map +1 -0
  298. package/build/tools/blast-radius.d.ts +24 -0
  299. package/build/tools/blast-radius.d.ts.map +1 -0
  300. package/build/tools/blast-radius.js +231 -0
  301. package/build/tools/blast-radius.js.map +1 -0
  302. package/build/tools/changed-since.d.ts +7 -0
  303. package/build/tools/changed-since.d.ts.map +1 -0
  304. package/build/tools/changed-since.js +68 -0
  305. package/build/tools/changed-since.js.map +1 -0
  306. package/build/tools/compiler-actions.d.ts +26 -0
  307. package/build/tools/compiler-actions.d.ts.map +1 -0
  308. package/build/tools/compiler-actions.js +121 -0
  309. package/build/tools/compiler-actions.js.map +1 -0
  310. package/build/tools/context-tree.d.ts +9 -0
  311. package/build/tools/context-tree.d.ts.map +1 -0
  312. package/build/tools/context-tree.js +131 -0
  313. package/build/tools/context-tree.js.map +1 -0
  314. package/build/tools/context.d.ts +37 -0
  315. package/build/tools/context.d.ts.map +1 -0
  316. package/build/tools/context.js +800 -0
  317. package/build/tools/context.js.map +1 -0
  318. package/build/tools/diff.d.ts +9 -0
  319. package/build/tools/diff.d.ts.map +1 -0
  320. package/build/tools/diff.js +176 -0
  321. package/build/tools/diff.js.map +1 -0
  322. package/build/tools/directory-prior.d.ts +16 -0
  323. package/build/tools/directory-prior.d.ts.map +1 -0
  324. package/build/tools/directory-prior.js +121 -0
  325. package/build/tools/directory-prior.js.map +1 -0
  326. package/build/tools/discovery-documents.d.ts +11 -0
  327. package/build/tools/discovery-documents.d.ts.map +1 -0
  328. package/build/tools/discovery-documents.js +71 -0
  329. package/build/tools/discovery-documents.js.map +1 -0
  330. package/build/tools/discovery-hints.d.ts +25 -0
  331. package/build/tools/discovery-hints.d.ts.map +1 -0
  332. package/build/tools/discovery-hints.js +329 -0
  333. package/build/tools/discovery-hints.js.map +1 -0
  334. package/build/tools/efficiency-report.d.ts +13 -0
  335. package/build/tools/efficiency-report.d.ts.map +1 -0
  336. package/build/tools/efficiency-report.js +78 -0
  337. package/build/tools/efficiency-report.js.map +1 -0
  338. package/build/tools/evidence-retrieval.d.ts +33 -0
  339. package/build/tools/evidence-retrieval.d.ts.map +1 -0
  340. package/build/tools/evidence-retrieval.js +200 -0
  341. package/build/tools/evidence-retrieval.js.map +1 -0
  342. package/build/tools/exact-references.d.ts +10 -0
  343. package/build/tools/exact-references.d.ts.map +1 -0
  344. package/build/tools/exact-references.js +349 -0
  345. package/build/tools/exact-references.js.map +1 -0
  346. package/build/tools/explain.d.ts +14 -0
  347. package/build/tools/explain.d.ts.map +1 -0
  348. package/build/tools/explain.js +370 -0
  349. package/build/tools/explain.js.map +1 -0
  350. package/build/tools/feature-brief.d.ts +7 -0
  351. package/build/tools/feature-brief.d.ts.map +1 -0
  352. package/build/tools/feature-brief.js +89 -0
  353. package/build/tools/feature-brief.js.map +1 -0
  354. package/build/tools/feature-hub.d.ts +15 -0
  355. package/build/tools/feature-hub.d.ts.map +1 -0
  356. package/build/tools/feature-hub.js +404 -0
  357. package/build/tools/feature-hub.js.map +1 -0
  358. package/build/tools/file-skeleton.d.ts +7 -0
  359. package/build/tools/file-skeleton.d.ts.map +1 -0
  360. package/build/tools/file-skeleton.js +190 -0
  361. package/build/tools/file-skeleton.js.map +1 -0
  362. package/build/tools/grep.d.ts +25 -0
  363. package/build/tools/grep.d.ts.map +1 -0
  364. package/build/tools/grep.js +341 -0
  365. package/build/tools/grep.js.map +1 -0
  366. package/build/tools/impact-delta.d.ts +7 -0
  367. package/build/tools/impact-delta.d.ts.map +1 -0
  368. package/build/tools/impact-delta.js +102 -0
  369. package/build/tools/impact-delta.js.map +1 -0
  370. package/build/tools/memory-tools.d.ts +69 -0
  371. package/build/tools/memory-tools.d.ts.map +1 -0
  372. package/build/tools/memory-tools.js +366 -0
  373. package/build/tools/memory-tools.js.map +1 -0
  374. package/build/tools/planning-helpers.d.ts +26 -0
  375. package/build/tools/planning-helpers.d.ts.map +1 -0
  376. package/build/tools/planning-helpers.js +269 -0
  377. package/build/tools/planning-helpers.js.map +1 -0
  378. package/build/tools/project-graph.d.ts +19 -0
  379. package/build/tools/project-graph.d.ts.map +1 -0
  380. package/build/tools/project-graph.js +259 -0
  381. package/build/tools/project-graph.js.map +1 -0
  382. package/build/tools/propose-commit.d.ts +9 -0
  383. package/build/tools/propose-commit.d.ts.map +1 -0
  384. package/build/tools/propose-commit.js +156 -0
  385. package/build/tools/propose-commit.js.map +1 -0
  386. package/build/tools/register-tools.d.ts +18 -0
  387. package/build/tools/register-tools.d.ts.map +1 -0
  388. package/build/tools/register-tools.js +1131 -0
  389. package/build/tools/register-tools.js.map +1 -0
  390. package/build/tools/reindex.d.ts +76 -0
  391. package/build/tools/reindex.d.ts.map +1 -0
  392. package/build/tools/reindex.js +871 -0
  393. package/build/tools/reindex.js.map +1 -0
  394. package/build/tools/related.d.ts +6 -0
  395. package/build/tools/related.d.ts.map +1 -0
  396. package/build/tools/related.js +143 -0
  397. package/build/tools/related.js.map +1 -0
  398. package/build/tools/repo-map.d.ts +59 -0
  399. package/build/tools/repo-map.d.ts.map +1 -0
  400. package/build/tools/repo-map.js +270 -0
  401. package/build/tools/repo-map.js.map +1 -0
  402. package/build/tools/resolve-symbol.d.ts +41 -0
  403. package/build/tools/resolve-symbol.d.ts.map +1 -0
  404. package/build/tools/resolve-symbol.js +250 -0
  405. package/build/tools/resolve-symbol.js.map +1 -0
  406. package/build/tools/retrieval-helpers.d.ts +35 -0
  407. package/build/tools/retrieval-helpers.d.ts.map +1 -0
  408. package/build/tools/retrieval-helpers.js +302 -0
  409. package/build/tools/retrieval-helpers.js.map +1 -0
  410. package/build/tools/scip-index.d.ts +12 -0
  411. package/build/tools/scip-index.d.ts.map +1 -0
  412. package/build/tools/scip-index.js +66 -0
  413. package/build/tools/scip-index.js.map +1 -0
  414. package/build/tools/scoped-discovery.d.ts +7 -0
  415. package/build/tools/scoped-discovery.d.ts.map +1 -0
  416. package/build/tools/scoped-discovery.js +89 -0
  417. package/build/tools/scoped-discovery.js.map +1 -0
  418. package/build/tools/search.d.ts +62 -0
  419. package/build/tools/search.d.ts.map +1 -0
  420. package/build/tools/search.js +419 -0
  421. package/build/tools/search.js.map +1 -0
  422. package/build/tools/semantic-diff.d.ts +7 -0
  423. package/build/tools/semantic-diff.d.ts.map +1 -0
  424. package/build/tools/semantic-diff.js +45 -0
  425. package/build/tools/semantic-diff.js.map +1 -0
  426. package/build/tools/semantic-identifiers.d.ts +51 -0
  427. package/build/tools/semantic-identifiers.d.ts.map +1 -0
  428. package/build/tools/semantic-identifiers.js +522 -0
  429. package/build/tools/semantic-identifiers.js.map +1 -0
  430. package/build/tools/semantic-navigate.d.ts +18 -0
  431. package/build/tools/semantic-navigate.d.ts.map +1 -0
  432. package/build/tools/semantic-navigate.js +413 -0
  433. package/build/tools/semantic-navigate.js.map +1 -0
  434. package/build/tools/semantic-search.d.ts +30 -0
  435. package/build/tools/semantic-search.d.ts.map +1 -0
  436. package/build/tools/semantic-search.js +466 -0
  437. package/build/tools/semantic-search.js.map +1 -0
  438. package/build/tools/sql-schema.d.ts +23 -0
  439. package/build/tools/sql-schema.d.ts.map +1 -0
  440. package/build/tools/sql-schema.js +155 -0
  441. package/build/tools/sql-schema.js.map +1 -0
  442. package/build/tools/static-analysis.d.ts +7 -0
  443. package/build/tools/static-analysis.d.ts.map +1 -0
  444. package/build/tools/static-analysis.js +331 -0
  445. package/build/tools/static-analysis.js.map +1 -0
  446. package/build/tools/status.d.ts +74 -0
  447. package/build/tools/status.d.ts.map +1 -0
  448. package/build/tools/status.js +227 -0
  449. package/build/tools/status.js.map +1 -0
  450. package/build/tools/symbolic-edit.d.ts +57 -0
  451. package/build/tools/symbolic-edit.d.ts.map +1 -0
  452. package/build/tools/symbolic-edit.js +500 -0
  453. package/build/tools/symbolic-edit.js.map +1 -0
  454. package/build/tools/test-impact.d.ts +7 -0
  455. package/build/tools/test-impact.d.ts.map +1 -0
  456. package/build/tools/test-impact.js +34 -0
  457. package/build/tools/test-impact.js.map +1 -0
  458. package/build/tools/test-map.d.ts +8 -0
  459. package/build/tools/test-map.d.ts.map +1 -0
  460. package/build/tools/test-map.js +75 -0
  461. package/build/tools/test-map.js.map +1 -0
  462. package/docs/README.md +26 -0
  463. package/docs/architecture.md +35 -0
  464. package/docs/configuration.md +178 -0
  465. package/docs/maintenance.md +77 -0
  466. package/package.json +80 -4
@@ -0,0 +1,121 @@
1
+ // Compiler edits are previewed as immutable artifacts, then hash-checked at application.
2
+ import { createHash } from "node:crypto";
3
+ import { realpath } from "node:fs/promises";
4
+ import { extname } from "node:path";
5
+ import { getDB } from "../core/db.js";
6
+ import { resolveProjectPath } from "../core/path-guard.js";
7
+ import { workspaceState } from "../core/evidence-state.js";
8
+ import { persistArtifact, readArtifact, buildArtifactId } from "../core/artifacts.js";
9
+ import { queryTypeScriptCompiler } from "../core/typescript-reference-process.js";
10
+ import { pythonOperation } from "../core/python-language-server.js";
11
+ import { captureSource, assertSourceUnchanged, publishSource, withSourceMutation } from "../core/source-mutation.js";
12
+ import { createRestorePoint } from "../git/shadow.js";
13
+ import { assertRenameName } from "./symbolic-edit.js";
14
+ import { invalidateSearchCache } from "./semantic-search.js";
15
+ import { invalidateIdentifierSearchCache } from "./semantic-identifiers.js";
16
+ const typescript = (file) => /\.(?:[cm]?[jt]s|[jt]sx)$/.test(file);
17
+ const digest = (value) => createHash("sha256").update(JSON.stringify(value)).digest("hex");
18
+ async function languageFiles(root, python) {
19
+ return (await getDB(root)).getAllFiles().filter(file => python ? file.path.endsWith(".py") : typescript(file.path))
20
+ .map(file => resolveProjectPath(root, file.path));
21
+ }
22
+ export async function compilerDiagnostics(options) {
23
+ const tsFiles = options.files.filter(typescript).map(file => resolveProjectPath(options.rootDir, file));
24
+ const pyFiles = options.files.filter(file => file.endsWith(".py")).map(file => resolveProjectPath(options.rootDir, file));
25
+ const unsupported = options.files.filter(file => !typescript(file) && !file.endsWith(".py"));
26
+ const results = [];
27
+ if (tsFiles.length)
28
+ results.push(await queryTypeScriptCompiler({ rootDir: options.rootDir, files: tsFiles, operation: "diagnostics" }));
29
+ if (pyFiles.length)
30
+ results.push(await pythonOperation({ rootDir: options.rootDir, files: pyFiles, operation: "diagnostics" }));
31
+ return { results, unsupported, execution: "compiler diagnostics only; tests were not executed" };
32
+ }
33
+ export async function previewRename(options) {
34
+ const root = await realpath(options.rootDir), file = resolveProjectPath(root, options.file);
35
+ const python = extname(file) === ".py";
36
+ if (!python && !typescript(file))
37
+ throw new Error("Compiler rename supports TS/JS and Python. Other languages retain the explicit textual rename tool.");
38
+ assertRenameName(options.newName, file);
39
+ const state = await workspaceState(root);
40
+ const input = { rootDir: root, files: await languageFiles(root, python), file, line: options.line, column: options.column, newName: options.newName, operation: "rename" };
41
+ const result = python ? await pythonOperation(input) : await queryTypeScriptCompiler(input);
42
+ const current = await workspaceState(root);
43
+ if (state.digest !== current.digest || state.revision !== current.revision)
44
+ throw new Error("Workspace changed during rename analysis; retry.");
45
+ const files = [];
46
+ const paths = [...new Set(result.edits?.map(edit => edit.file) ?? [])];
47
+ if (paths.length > 100 || (result.edits?.length ?? 0) > 5000)
48
+ throw new Error("Rename exceeds 100 files or 5,000 edits; narrow the operation.");
49
+ for (const path of paths) {
50
+ const snapshot = captureSource(root, path);
51
+ if (snapshot.content === null || !snapshot.hash)
52
+ throw new Error(`Missing rename source: ${path}`);
53
+ const before = state.files.find(item => item.file === path);
54
+ if (!before || before.hash !== snapshot.hash)
55
+ throw new Error(`Rename touches excluded or changed source: ${path}`);
56
+ const edits = result.edits.filter(edit => edit.file === path).sort((a, b) => b.start - a.start);
57
+ let next = snapshot.content, boundary = next.length;
58
+ for (const edit of edits) {
59
+ if (edit.start < 0 || edit.length < 0 || edit.start + edit.length > boundary)
60
+ throw new Error("Overlapping or invalid compiler edits.");
61
+ next = next.slice(0, edit.start) + edit.text + next.slice(edit.start + edit.length);
62
+ boundary = edit.start;
63
+ }
64
+ files.push({ file: path, hash: snapshot.hash, next, edits: edits.map(({ start, length, text }) => ({ start, length, text })) });
65
+ }
66
+ if (!files.length)
67
+ throw new Error("No compiler rename edits.");
68
+ const payload = { root, stateDigest: state.digest, revision: state.revision, engine: result.engine, warnings: result.warnings, files };
69
+ if (Buffer.byteLength(JSON.stringify(payload)) > 8 * 1024 * 1024)
70
+ throw new Error("Rename preview exceeds 8 MiB; narrow the operation.");
71
+ const artifact = await persistArtifact({ rootDir: root, kind: "rename_preview", key: digest(payload), payload, immutable: true });
72
+ const summary = { artifact, engine: result.engine, warnings: result.warnings, files: files.map(({ file, hash, edits }) => ({ file, hash, edits })) };
73
+ const text = JSON.stringify(summary);
74
+ const budget = (options.maxTokens ?? 4000) * 4;
75
+ if (Buffer.byteLength(text) <= budget)
76
+ return text;
77
+ const compact = { artifact: { id: artifact.id }, engine: result.engine, fileCount: files.length, files: [], omittedFileCount: files.length,
78
+ omitted: "Edit details and additional paths may exceed the response budget; inspect artifact_read before applying." };
79
+ for (const { file } of files) {
80
+ const next = { ...compact, files: [...compact.files, file], omittedFileCount: compact.omittedFileCount - 1 };
81
+ if (Buffer.byteLength(JSON.stringify(next)) > budget)
82
+ break;
83
+ Object.assign(compact, next);
84
+ }
85
+ return JSON.stringify(compact);
86
+ }
87
+ export async function applyRename(options) {
88
+ const root = await realpath(options.rootDir);
89
+ return withSourceMutation(root, async () => {
90
+ const artifact = await readArtifact(root, options.previewId);
91
+ if (!artifact || artifact.kind !== "rename_preview" || artifact.payload.root !== root
92
+ || artifact.id !== buildArtifactId("rename_preview", digest(artifact.payload)))
93
+ throw new Error("Invalid rename preview for this workspace.");
94
+ const state = await workspaceState(root);
95
+ if (state.digest !== artifact.payload.stateDigest || state.revision !== artifact.payload.revision)
96
+ throw new Error("Rename preview is stale; create a new preview.");
97
+ const staged = artifact.payload.files.map(file => ({ ...file, snapshot: captureSource(root, file.file) }));
98
+ for (const item of staged)
99
+ if (item.snapshot.hash !== item.hash)
100
+ throw new Error(`Rename source changed: ${item.file}`);
101
+ const restore = await createRestorePoint(root, staged.map(item => item.file), `Compiler rename ${artifact.id}`);
102
+ for (const item of staged)
103
+ assertSourceUnchanged(root, item.snapshot);
104
+ const completed = [];
105
+ try {
106
+ for (const item of staged) {
107
+ await publishSource(root, item.snapshot, item.next);
108
+ completed.push(item.file);
109
+ }
110
+ }
111
+ catch (error) {
112
+ throw new Error(`Rename stopped: ${error.message}. Updated: ${completed.join(", ") || "none"}. Restore point: ${restore.id}`);
113
+ }
114
+ finally {
115
+ invalidateSearchCache();
116
+ invalidateIdentifierSearchCache();
117
+ }
118
+ return { updated: completed, restorePoint: restore.id, engine: artifact.payload.engine, verification: "Run validate_scope and the recommended checks; applying edits does not prove correctness." };
119
+ });
120
+ }
121
+ //# sourceMappingURL=compiler-actions.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"compiler-actions.js","sourceRoot":"","sources":["../../src/tools/compiler-actions.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,9 @@
1
+ export interface ContextTreeOptions {
2
+ rootDir: string;
3
+ targetPath?: string;
4
+ depthLimit?: number;
5
+ includeSymbols?: boolean;
6
+ maxTokens?: number;
7
+ }
8
+ export declare function getContextTree(options: ContextTreeOptions): Promise<string>;
9
+ //# sourceMappingURL=context-tree.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"context-tree.d.ts","sourceRoot":"","sources":["../../src/tools/context-tree.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA2HD,wBAAsB,cAAc,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAwBjF"}
@@ -0,0 +1,131 @@
1
+ // Structural tree generator with file headers, symbols, and depth control
2
+ // Dynamic token-aware pruning: Level 0 (files only) to Level 2 (deep context)
3
+ import { walkDirectory } from "../core/walker.js";
4
+ import { analyzeFile, formatSymbol, isSupportedFile } from "../core/parser.js";
5
+ const CHARS_PER_TOKEN = 4;
6
+ function estimateTokens(text) {
7
+ return Math.ceil(text.length / CHARS_PER_TOKEN);
8
+ }
9
+ async function buildTree(entries, _rootDir, includeSymbols) {
10
+ const root = { name: ".", relativePath: ".", isDirectory: true, children: [] };
11
+ const dirMap = new Map();
12
+ dirMap.set(".", root);
13
+ const sortedEntries = entries.sort((a, b) => a.depth - b.depth || a.relativePath.localeCompare(b.relativePath));
14
+ for (const entry of sortedEntries) {
15
+ const parts = entry.relativePath.split("/");
16
+ const parentPath = parts.length > 1 ? parts.slice(0, -1).join("/") : ".";
17
+ let parent = dirMap.get(parentPath);
18
+ if (!parent) {
19
+ parent = root;
20
+ }
21
+ const node = {
22
+ name: parts[parts.length - 1],
23
+ relativePath: entry.relativePath,
24
+ isDirectory: entry.isDirectory,
25
+ children: [],
26
+ };
27
+ if (!entry.isDirectory && isSupportedFile(entry.path)) {
28
+ try {
29
+ const analysis = await analyzeFile(entry.path);
30
+ node.header = analysis.header || undefined;
31
+ if (includeSymbols && analysis.symbols.length > 0) {
32
+ node.symbols = analysis.symbols.map((s) => formatSymbol(s, 0)).join("\n");
33
+ }
34
+ }
35
+ catch { }
36
+ }
37
+ parent.children.push(node);
38
+ if (entry.isDirectory) {
39
+ dirMap.set(entry.relativePath, node);
40
+ }
41
+ }
42
+ return root;
43
+ }
44
+ function renderTree(node, indent = 0) {
45
+ let result = "";
46
+ const pad = " ".repeat(indent);
47
+ if (indent === 0) {
48
+ result = `${node.name}/\n`;
49
+ }
50
+ else if (node.isDirectory) {
51
+ result = `${pad}${node.name}/\n`;
52
+ }
53
+ else {
54
+ result = `${pad}${node.name}`;
55
+ if (node.header)
56
+ result += ` | ${node.header}`;
57
+ result += "\n";
58
+ if (node.symbols) {
59
+ for (const line of node.symbols.split("\n")) {
60
+ result += `${pad} ${line}\n`;
61
+ }
62
+ }
63
+ }
64
+ for (const child of node.children) {
65
+ result += renderTree(child, indent + 1);
66
+ }
67
+ return result;
68
+ }
69
+ function pruneSymbols(node) {
70
+ node.symbols = undefined;
71
+ for (const child of node.children)
72
+ pruneSymbols(child);
73
+ }
74
+ function pruneHeaders(node) {
75
+ node.header = undefined;
76
+ node.symbols = undefined;
77
+ for (const child of node.children)
78
+ pruneHeaders(child);
79
+ }
80
+ async function resolveTargetPathFuzzy(rootDir, targetPath) {
81
+ if (!targetPath)
82
+ return { resolved: undefined, note: null };
83
+ // First try the literal path. If walker returns at least one entry, accept.
84
+ const literalEntries = await walkDirectory({ rootDir, targetPath, depthLimit: 1 }).catch(() => []);
85
+ if (literalEntries.length > 0)
86
+ return { resolved: targetPath, note: null };
87
+ // Fuzzy: try common prefixes (src/, app/, lib/, packages/) and look for the trailing
88
+ // component as a directory under them.
89
+ const trimmed = targetPath.replace(/\/+$/, "");
90
+ const segment = trimmed.split("/").pop() ?? trimmed;
91
+ const candidates = [
92
+ `src/${trimmed}`,
93
+ `src/${segment}`,
94
+ `app/${trimmed}`,
95
+ `app/${segment}`,
96
+ `lib/${trimmed}`,
97
+ `lib/${segment}`,
98
+ `packages/${trimmed}`,
99
+ `packages/${segment}`,
100
+ ];
101
+ for (const candidate of candidates) {
102
+ const entries = await walkDirectory({ rootDir, targetPath: candidate, depthLimit: 1 }).catch(() => []);
103
+ if (entries.length > 0) {
104
+ return { resolved: candidate, note: `Fuzzy-resolved "${targetPath}" → "${candidate}". Pass the full project-relative path next time to skip this guess.` };
105
+ }
106
+ }
107
+ return { resolved: targetPath, note: `target_path "${targetPath}" did not match any indexed directory. Showing empty result. Tried: ${candidates.join(", ")}` };
108
+ }
109
+ export async function getContextTree(options) {
110
+ const { resolved, note } = await resolveTargetPathFuzzy(options.rootDir, options.targetPath);
111
+ const entries = await walkDirectory({
112
+ rootDir: options.rootDir,
113
+ targetPath: resolved,
114
+ depthLimit: options.depthLimit,
115
+ });
116
+ const includeSymbols = options.includeSymbols !== false;
117
+ const tree = await buildTree(entries, options.rootDir, includeSymbols);
118
+ const maxTokens = options.maxTokens ?? 20000;
119
+ const prefix = note ? `[${note}]\n\n` : "";
120
+ let rendered = renderTree(tree);
121
+ if (estimateTokens(rendered) <= maxTokens)
122
+ return prefix + rendered;
123
+ pruneSymbols(tree);
124
+ rendered = renderTree(tree);
125
+ if (estimateTokens(rendered) <= maxTokens)
126
+ return `${prefix}[Level 1: Headers only, symbols pruned to fit ${maxTokens} tokens]\n\n${rendered}`;
127
+ pruneHeaders(tree);
128
+ rendered = renderTree(tree);
129
+ return `${prefix}[Level 0: File names only, project too large for ${maxTokens} tokens]\n\n${rendered}`;
130
+ }
131
+ //# sourceMappingURL=context-tree.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"context-tree.js","sourceRoot":"","sources":["../../src/tools/context-tree.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,37 @@
1
+ import { retrieveEvidence } from "./evidence-retrieval.js";
2
+ export interface ContextTarget {
3
+ file: string;
4
+ symbol?: string;
5
+ start?: number;
6
+ end?: number;
7
+ }
8
+ export interface ContextOptions {
9
+ rootDir: string;
10
+ query?: string;
11
+ targets?: ContextTarget[];
12
+ maxTokens?: number;
13
+ previousContextId?: string;
14
+ intent?: "auto" | "lookup" | "change" | "debug" | "review" | "overview";
15
+ /** Internal evaluation override; the MCP surface uses configured defaults. */
16
+ retrievalPreset?: "balanced" | "keyword_only" | "semantic_only";
17
+ connected?: boolean;
18
+ retrieved?: Awaited<ReturnType<typeof retrieveEvidence>>;
19
+ }
20
+ export interface Excerpt {
21
+ file: string;
22
+ start: number;
23
+ end: number;
24
+ text: string;
25
+ }
26
+ export interface SourceEvidence {
27
+ text: string;
28
+ ranges: Excerpt[];
29
+ hashes: Record<string, string>;
30
+ notices: string[];
31
+ /** Delivery completeness, not a claim of exhaustive repository coverage. */
32
+ complete: boolean;
33
+ settings: string;
34
+ }
35
+ export declare function getContext(options: ContextOptions): Promise<string>;
36
+ export declare function collectSourceEvidence(options: ContextOptions): Promise<SourceEvidence>;
37
+ //# sourceMappingURL=context.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/tools/context.ts"],"names":[],"mappings":"AAkBA,OAAO,EAA6B,gBAAgB,EAA0B,MAAM,yBAAyB,CAAC;AAO9G,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AACD,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,aAAa,EAAE,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,UAAU,CAAC;IACxE,8EAA8E;IAC9E,eAAe,CAAC,EAAE,UAAU,GAAG,cAAc,GAAG,eAAe,CAAC;IAChE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC,CAAC;CAC1D;AACD,MAAM,WAAW,OAAO;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;CAAE;AACpF,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IACnF,4EAA4E;IAC5E,QAAQ,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;CACrC;AA0CD,wBAAsB,UAAU,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAKzE;AAED,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAgkB5F"}