@monoes/monograph 1.5.6 → 1.5.8

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 (708) hide show
  1. package/README.md +31 -15
  2. package/dist/src/analysis/changed-files.d.ts +3 -0
  3. package/dist/src/analysis/changed-files.d.ts.map +1 -1
  4. package/dist/src/analysis/changed-files.js +11 -9
  5. package/dist/src/analysis/changed-files.js.map +1 -1
  6. package/dist/src/analysis/changed-workspaces.d.ts.map +1 -1
  7. package/dist/src/analysis/changed-workspaces.js +2 -9
  8. package/dist/src/analysis/changed-workspaces.js.map +1 -1
  9. package/dist/src/analysis/git-changed-files.d.ts +3 -0
  10. package/dist/src/analysis/git-changed-files.d.ts.map +1 -1
  11. package/dist/src/analysis/git-changed-files.js +17 -12
  12. package/dist/src/analysis/git-changed-files.js.map +1 -1
  13. package/dist/src/analysis/git-ref.d.ts +33 -0
  14. package/dist/src/analysis/git-ref.d.ts.map +1 -0
  15. package/dist/src/analysis/git-ref.js +54 -0
  16. package/dist/src/analysis/git-ref.js.map +1 -0
  17. package/dist/src/analyze/boundary-analysis.d.ts.map +1 -1
  18. package/dist/src/analyze/boundary-analysis.js +42 -42
  19. package/dist/src/analyze/boundary-analysis.js.map +1 -1
  20. package/dist/src/index.d.ts +1 -0
  21. package/dist/src/index.d.ts.map +1 -1
  22. package/dist/src/index.js +1 -0
  23. package/dist/src/index.js.map +1 -1
  24. package/dist/src/lsp/server.d.ts +1 -1
  25. package/dist/src/lsp/server.d.ts.map +1 -1
  26. package/dist/src/lsp/server.js +48 -13
  27. package/dist/src/lsp/server.js.map +1 -1
  28. package/dist/src/mcp-tools/api-impact.d.ts.map +1 -1
  29. package/dist/src/mcp-tools/api-impact.js +1 -16
  30. package/dist/src/mcp-tools/api-impact.js.map +1 -1
  31. package/dist/src/mcp-tools/context.d.ts.map +1 -1
  32. package/dist/src/mcp-tools/context.js +12 -23
  33. package/dist/src/mcp-tools/context.js.map +1 -1
  34. package/dist/src/mcp-tools/explain.d.ts.map +1 -1
  35. package/dist/src/mcp-tools/explain.js +15 -20
  36. package/dist/src/mcp-tools/explain.js.map +1 -1
  37. package/dist/src/mcp-tools/graph-query.d.ts.map +1 -1
  38. package/dist/src/mcp-tools/graph-query.js +10 -19
  39. package/dist/src/mcp-tools/graph-query.js.map +1 -1
  40. package/dist/src/mcp-tools/impact.d.ts.map +1 -1
  41. package/dist/src/mcp-tools/impact.js +38 -41
  42. package/dist/src/mcp-tools/impact.js.map +1 -1
  43. package/dist/src/mcp-tools/neighbors.d.ts.map +1 -1
  44. package/dist/src/mcp-tools/neighbors.js +4 -22
  45. package/dist/src/mcp-tools/neighbors.js.map +1 -1
  46. package/dist/src/mcp-tools/query.d.ts.map +1 -1
  47. package/dist/src/mcp-tools/query.js +14 -9
  48. package/dist/src/mcp-tools/query.js.map +1 -1
  49. package/dist/src/mcp-tools/rename.d.ts.map +1 -1
  50. package/dist/src/mcp-tools/rename.js +3 -20
  51. package/dist/src/mcp-tools/rename.js.map +1 -1
  52. package/dist/src/parsers/c.d.ts.map +1 -1
  53. package/dist/src/parsers/c.js +12 -0
  54. package/dist/src/parsers/c.js.map +1 -1
  55. package/dist/src/parsers/extractor.d.ts.map +1 -1
  56. package/dist/src/parsers/extractor.js +2 -1
  57. package/dist/src/parsers/extractor.js.map +1 -1
  58. package/dist/src/parsers/go.d.ts.map +1 -1
  59. package/dist/src/parsers/go.js +19 -1
  60. package/dist/src/parsers/go.js.map +1 -1
  61. package/dist/src/parsers/language-config.d.ts +4 -0
  62. package/dist/src/parsers/language-config.d.ts.map +1 -1
  63. package/dist/src/parsers/language-parsers.d.ts.map +1 -1
  64. package/dist/src/parsers/language-parsers.js +3 -1
  65. package/dist/src/parsers/language-parsers.js.map +1 -1
  66. package/dist/src/parsers/loader.d.ts +1 -0
  67. package/dist/src/parsers/loader.d.ts.map +1 -1
  68. package/dist/src/parsers/loader.js +161 -20
  69. package/dist/src/parsers/loader.js.map +1 -1
  70. package/dist/src/parsers/python.d.ts.map +1 -1
  71. package/dist/src/parsers/python.js +6 -0
  72. package/dist/src/parsers/python.js.map +1 -1
  73. package/dist/src/parsers/rust.d.ts.map +1 -1
  74. package/dist/src/parsers/rust.js +10 -0
  75. package/dist/src/parsers/rust.js.map +1 -1
  76. package/dist/src/pipeline/orchestrator.d.ts.map +1 -1
  77. package/dist/src/pipeline/orchestrator.js +17 -0
  78. package/dist/src/pipeline/orchestrator.js.map +1 -1
  79. package/dist/src/pipeline/phases/pdf-parse.d.ts.map +1 -1
  80. package/dist/src/pipeline/phases/pdf-parse.js +10 -11
  81. package/dist/src/pipeline/phases/pdf-parse.js.map +1 -1
  82. package/dist/src/storage/edge-store.d.ts +1 -0
  83. package/dist/src/storage/edge-store.d.ts.map +1 -1
  84. package/dist/src/storage/edge-store.js +5 -8
  85. package/dist/src/storage/edge-store.js.map +1 -1
  86. package/dist/src/storage/node-store.d.ts +1 -0
  87. package/dist/src/storage/node-store.d.ts.map +1 -1
  88. package/dist/src/storage/node-store.js +11 -12
  89. package/dist/src/storage/node-store.js.map +1 -1
  90. package/dist/src/storage/schema.d.ts.map +1 -1
  91. package/dist/src/storage/schema.js +6 -0
  92. package/dist/src/storage/schema.js.map +1 -1
  93. package/dist/src/storage/utils.d.ts +11 -0
  94. package/dist/src/storage/utils.d.ts.map +1 -0
  95. package/dist/src/storage/utils.js +24 -0
  96. package/dist/src/storage/utils.js.map +1 -0
  97. package/dist/tsconfig.tsbuildinfo +1 -1
  98. package/package.json +12 -9
  99. package/.monomind/data/ranked-context.json +0 -5
  100. package/.monomind/loops/mastermind-review-1782162423447.json +0 -16
  101. package/.monomind/sessions/session-1777578175215.json +0 -15
  102. package/.monomind/sessions/session-1777823684507.json +0 -15
  103. package/.monomind/sessions/session-1777928944749.json +0 -15
  104. package/.monomind/sessions/session-1778052902210.json +0 -15
  105. package/.monomind/sessions/session-1778056744636.json +0 -15
  106. package/.monomind/sessions/session-1778061077599.json +0 -15
  107. package/.monomind/sessions/session-1778102154764.json +0 -15
  108. package/__tests__/analysis/shape-extractor.test.ts +0 -124
  109. package/__tests__/analysis/surprise-scorer.test.ts +0 -154
  110. package/__tests__/cache/extraction-cache.test.ts +0 -45
  111. package/__tests__/cli/ai-context.test.ts +0 -175
  112. package/__tests__/cli/augment.test.ts +0 -128
  113. package/__tests__/cli/doctor.test.ts +0 -125
  114. package/__tests__/cli/eval-server.test.ts +0 -89
  115. package/__tests__/cli/setup.test.ts +0 -178
  116. package/__tests__/cli/skill-gen.test.ts +0 -280
  117. package/__tests__/export/formats.test.ts +0 -82
  118. package/__tests__/fixtures/sample.c +0 -25
  119. package/__tests__/fixtures/sample.cpp +0 -32
  120. package/__tests__/fixtures/sample.dart +0 -34
  121. package/__tests__/fixtures/sample.kt +0 -30
  122. package/__tests__/fixtures/sample.php +0 -30
  123. package/__tests__/fixtures/sample.py +0 -11
  124. package/__tests__/fixtures/sample.rb +0 -26
  125. package/__tests__/fixtures/sample.swift +0 -42
  126. package/__tests__/fixtures/sample.ts +0 -17
  127. package/__tests__/fixtures/sample.vue +0 -40
  128. package/__tests__/groups/group-search.test.ts +0 -221
  129. package/__tests__/groups/group-sync.test.ts +0 -336
  130. package/__tests__/integration/build-atomicity.test.ts +0 -61
  131. package/__tests__/integration/call-attribution.test.ts +0 -116
  132. package/__tests__/integration/full-pipeline.test.ts +0 -64
  133. package/__tests__/integration/graph-report-freshness.test.ts +0 -53
  134. package/__tests__/integration/incremental-build.test.ts +0 -103
  135. package/__tests__/mcp-resources/resources.test.ts +0 -256
  136. package/__tests__/mcp-tools/api-impact.test.ts +0 -188
  137. package/__tests__/mcp-tools/context.test.ts +0 -130
  138. package/__tests__/mcp-tools/cypher.test.ts +0 -258
  139. package/__tests__/mcp-tools/detect-changes.test.ts +0 -114
  140. package/__tests__/mcp-tools/impact.test.ts +0 -133
  141. package/__tests__/mcp-tools/rename.test.ts +0 -117
  142. package/__tests__/mcp-tools/route-map.test.ts +0 -237
  143. package/__tests__/mcp-tools/shape-check.test.ts +0 -202
  144. package/__tests__/mcp-tools/tool-map.test.ts +0 -135
  145. package/__tests__/parsers/c.test.ts +0 -28
  146. package/__tests__/parsers/cpp.test.ts +0 -28
  147. package/__tests__/parsers/csharp.test.ts +0 -62
  148. package/__tests__/parsers/dart.test.ts +0 -28
  149. package/__tests__/parsers/kotlin.test.ts +0 -28
  150. package/__tests__/parsers/loader.test.ts +0 -14
  151. package/__tests__/parsers/php.test.ts +0 -28
  152. package/__tests__/parsers/python.test.ts +0 -32
  153. package/__tests__/parsers/ruby.test.ts +0 -33
  154. package/__tests__/parsers/swift.test.ts +0 -28
  155. package/__tests__/parsers/typescript.test.ts +0 -45
  156. package/__tests__/parsers/vue.test.ts +0 -28
  157. package/__tests__/pipeline/analysis.test.ts +0 -58
  158. package/__tests__/pipeline/phases/corpus-check.test.ts +0 -26
  159. package/__tests__/pipeline/phases/evidence.test.ts +0 -41
  160. package/__tests__/pipeline/phases/field-access.test.ts +0 -22
  161. package/__tests__/pipeline/phases/leiden.test.ts +0 -72
  162. package/__tests__/pipeline/phases/markdown.test.ts +0 -84
  163. package/__tests__/pipeline/phases/middleware-extractor.test.ts +0 -131
  164. package/__tests__/pipeline/phases/orm.test.ts +0 -379
  165. package/__tests__/pipeline/phases/processes.test.ts +0 -191
  166. package/__tests__/pipeline/phases/routes.test.ts +0 -195
  167. package/__tests__/pipeline/phases/scope-resolution.test.ts +0 -133
  168. package/__tests__/pipeline/phases/tools.test.ts +0 -161
  169. package/__tests__/pipeline/phases/variables.test.ts +0 -30
  170. package/__tests__/pipeline/phases/wildcard-synthesis.test.ts +0 -207
  171. package/__tests__/pipeline/phases.test.ts +0 -41
  172. package/__tests__/pipeline/runner.test.ts +0 -28
  173. package/__tests__/registry/repo-registry.test.ts +0 -127
  174. package/__tests__/reporting/graph-report.suggest.test.ts +0 -36
  175. package/__tests__/reporting/graph-report.test.ts +0 -165
  176. package/__tests__/search/ast-chunker.test.ts +0 -63
  177. package/__tests__/search/rrf.test.ts +0 -95
  178. package/__tests__/security/safe-fetch.test.ts +0 -41
  179. package/__tests__/security/sensitive-files.test.ts +0 -32
  180. package/__tests__/setup.ts +0 -1
  181. package/__tests__/skills/platform-skills.test.ts +0 -63
  182. package/__tests__/staleness/git-staleness.test.ts +0 -107
  183. package/__tests__/storage/db.test.ts +0 -37
  184. package/__tests__/storage/evidence-roundtrip.test.ts +0 -89
  185. package/__tests__/storage/stores.test.ts +0 -165
  186. package/__tests__/types.test.ts +0 -13
  187. package/__tests__/validation/extraction-validator.test.ts +0 -48
  188. package/__tests__/watch/watcher.test.ts +0 -31
  189. package/__tests__/web/analyze-api.test.ts +0 -66
  190. package/__tests__/web/api.test.ts +0 -210
  191. package/__tests__/web/mcp-http.test.ts +0 -67
  192. package/__tests__/web/react-ui.test.ts +0 -43
  193. package/__tests__/wiki/gist-publisher.test.ts +0 -66
  194. package/__tests__/wiki/providers.test.ts +0 -69
  195. package/__tests__/wiki/wiki-generator.test.ts +0 -260
  196. package/dist/src/fix/deps.d.ts +0 -14
  197. package/dist/src/fix/deps.d.ts.map +0 -1
  198. package/dist/src/fix/deps.js +0 -47
  199. package/dist/src/fix/deps.js.map +0 -1
  200. package/dist/src/fix/enum-members.d.ts +0 -20
  201. package/dist/src/fix/enum-members.d.ts.map +0 -1
  202. package/dist/src/fix/enum-members.js +0 -95
  203. package/dist/src/fix/enum-members.js.map +0 -1
  204. package/dist/src/fix/export-surgery.d.ts +0 -14
  205. package/dist/src/fix/export-surgery.d.ts.map +0 -1
  206. package/dist/src/fix/export-surgery.js +0 -140
  207. package/dist/src/fix/export-surgery.js.map +0 -1
  208. package/dist/src/fix/exports.d.ts +0 -16
  209. package/dist/src/fix/exports.d.ts.map +0 -1
  210. package/dist/src/fix/exports.js +0 -65
  211. package/dist/src/fix/exports.js.map +0 -1
  212. package/dist/src/fix/orchestrator.d.ts +0 -28
  213. package/dist/src/fix/orchestrator.d.ts.map +0 -1
  214. package/dist/src/fix/orchestrator.js +0 -39
  215. package/dist/src/fix/orchestrator.js.map +0 -1
  216. package/src/__tests__/analysis/benchmark.test.ts +0 -59
  217. package/src/__tests__/analysis/cluster-quality.test.ts +0 -106
  218. package/src/__tests__/analysis/corpus-health.test.ts +0 -33
  219. package/src/__tests__/analysis/dependency-health.test.ts +0 -105
  220. package/src/__tests__/analysis/file-classifier.test.ts +0 -50
  221. package/src/__tests__/analysis/node-similarity.test.ts +0 -81
  222. package/src/__tests__/cache/augment-cache.test.ts +0 -55
  223. package/src/__tests__/cli/check-update.test.ts +0 -42
  224. package/src/__tests__/cli/hooks-install.test.ts +0 -56
  225. package/src/__tests__/cli/hooks-marker.test.ts +0 -138
  226. package/src/__tests__/cli/hooks-status.test.ts +0 -42
  227. package/src/__tests__/export/adjacency-matrix.test.ts +0 -116
  228. package/src/__tests__/export/csv.test.ts +0 -39
  229. package/src/__tests__/export/dot.test.ts +0 -86
  230. package/src/__tests__/export/gexf.test.ts +0 -78
  231. package/src/__tests__/export/graphml.test.ts +0 -57
  232. package/src/__tests__/export/mermaid.test.ts +0 -89
  233. package/src/__tests__/graph/betweenness.test.ts +0 -89
  234. package/src/__tests__/graph/cycles.test.ts +0 -131
  235. package/src/__tests__/graph/dead-code.test.ts +0 -174
  236. package/src/__tests__/graph/dfs.test.ts +0 -62
  237. package/src/__tests__/graph/diff-summary.test.ts +0 -83
  238. package/src/__tests__/graph/edge-filter.test.ts +0 -129
  239. package/src/__tests__/graph/import-chain.test.ts +0 -111
  240. package/src/__tests__/graph/merge.test.ts +0 -151
  241. package/src/__tests__/graph/node-search.test.ts +0 -167
  242. package/src/__tests__/graph/normalize-id.test.ts +0 -102
  243. package/src/__tests__/graph/pagerank.test.ts +0 -96
  244. package/src/__tests__/graph/prune.test.ts +0 -110
  245. package/src/__tests__/graph/regex-search.test.ts +0 -166
  246. package/src/__tests__/graph/ripple-impact.test.ts +0 -73
  247. package/src/__tests__/graph/scc.test.ts +0 -85
  248. package/src/__tests__/graph/statistics.test.ts +0 -219
  249. package/src/__tests__/graph/subgraph.test.ts +0 -127
  250. package/src/__tests__/graph/topo-sort.test.ts +0 -110
  251. package/src/__tests__/graph/wcc.test.ts +0 -101
  252. package/src/__tests__/groups/grpc-extractor.test.ts +0 -47
  253. package/src/__tests__/groups/service-boundary.test.ts +0 -86
  254. package/src/__tests__/groups/topic-extractor.test.ts +0 -43
  255. package/src/__tests__/ingest/git-clone.test.ts +0 -128
  256. package/src/__tests__/ingest/query-memory.test.ts +0 -123
  257. package/src/__tests__/ingest/transcribe.test.ts +0 -58
  258. package/src/__tests__/ingest/url-ingest.test.ts +0 -48
  259. package/src/__tests__/mcp-resources/repo-context-resource.test.ts +0 -37
  260. package/src/__tests__/mcp-resources/repos-resource.test.ts +0 -71
  261. package/src/__tests__/mcp-resources/wiki-resource.test.ts +0 -52
  262. package/src/__tests__/mcp-tools/explain.test.ts +0 -46
  263. package/src/__tests__/mcp-tools/graph-query.test.ts +0 -45
  264. package/src/__tests__/mcp-tools/group-sync.test.ts +0 -8
  265. package/src/__tests__/mcp-tools/impact-filtering.test.ts +0 -48
  266. package/src/__tests__/mcp-tools/impact.risk.test.ts +0 -24
  267. package/src/__tests__/mcp-tools/list-repos.test.ts +0 -24
  268. package/src/__tests__/mcp-tools/neighbors.test.ts +0 -48
  269. package/src/__tests__/mcp-tools/query.test.ts +0 -42
  270. package/src/__tests__/parsers/language-parsers.test.ts +0 -52
  271. package/src/__tests__/parsers/named-bindings.test.ts +0 -73
  272. package/src/__tests__/pipeline/cluster-only.test.ts +0 -33
  273. package/src/__tests__/pipeline/phases/bridge-adapters/electron-ipc.test.ts +0 -87
  274. package/src/__tests__/pipeline/phases/bridge-adapters/tauri.test.ts +0 -116
  275. package/src/__tests__/pipeline/phases/bridge-adapters/wails.test.ts +0 -81
  276. package/src/__tests__/pipeline/phases/bridge-resolver.test.ts +0 -110
  277. package/src/__tests__/pipeline/phases/communities.cohesion.test.ts +0 -43
  278. package/src/__tests__/pipeline/phases/community-split.test.ts +0 -30
  279. package/src/__tests__/pipeline/phases/framework-detect.test.ts +0 -65
  280. package/src/__tests__/pipeline/phases/import-resolver.test.ts +0 -64
  281. package/src/__tests__/pipeline/phases/parse-arrow.test.ts +0 -33
  282. package/src/__tests__/pipeline/phases/parse-csharp.test.ts +0 -33
  283. package/src/__tests__/pipeline/phases/scan.monographignore.test.ts +0 -53
  284. package/src/__tests__/pipeline/phases/scan.negation.test.ts +0 -40
  285. package/src/__tests__/pipeline/phases/scope-resolution.go.test.ts +0 -34
  286. package/src/__tests__/pipeline/phases/scope-resolution.java.test.ts +0 -30
  287. package/src/__tests__/pipeline/phases/scope-resolution.rust.test.ts +0 -31
  288. package/src/__tests__/pipeline/phases/suggest-questions.test.ts +0 -46
  289. package/src/__tests__/pipeline/phases/surprises-scoring.test.ts +0 -46
  290. package/src/__tests__/pipeline/phases/variables-phase.test.ts +0 -78
  291. package/src/__tests__/pipeline/phases/wildcard-phase.test.ts +0 -99
  292. package/src/__tests__/pipeline/runner.parallel.test.ts +0 -78
  293. package/src/__tests__/reporting/graph-report-confidence.test.ts +0 -43
  294. package/src/__tests__/reporting/graph-report-gaps.test.ts +0 -41
  295. package/src/__tests__/scope-resolution/call-sites.test.ts +0 -89
  296. package/src/__tests__/scope-resolution/evidence-weights.test.ts +0 -49
  297. package/src/__tests__/search/diacritic.test.ts +0 -23
  298. package/src/__tests__/security/safe-fetch.test.ts +0 -125
  299. package/src/__tests__/skills/platform-skills.extra.test.ts +0 -36
  300. package/src/__tests__/web/api.clusters.test.ts +0 -65
  301. package/src/__tests__/web/api.file.test.ts +0 -44
  302. package/src/__tests__/web/api.grep.test.ts +0 -47
  303. package/src/__tests__/web/api.info.test.ts +0 -18
  304. package/src/__tests__/web/api.jobs.test.ts +0 -47
  305. package/src/__tests__/web/api.progress.test.ts +0 -25
  306. package/src/__tests__/web/api.stream.test.ts +0 -35
  307. package/src/__tests__/wiki/providers-reasoning.test.ts +0 -46
  308. package/src/__tests__/wiki/wiki-review-mode.test.ts +0 -22
  309. package/src/analysis/benchmark.ts +0 -132
  310. package/src/analysis/changed-files.ts +0 -73
  311. package/src/analysis/changed-workspaces.ts +0 -94
  312. package/src/analysis/churn-cache.ts +0 -179
  313. package/src/analysis/churn-trend.ts +0 -57
  314. package/src/analysis/churn.ts +0 -263
  315. package/src/analysis/cluster-quality.ts +0 -142
  316. package/src/analysis/combined.ts +0 -41
  317. package/src/analysis/corpus-health.ts +0 -41
  318. package/src/analysis/coverage-gaps.ts +0 -246
  319. package/src/analysis/dep-classification.ts +0 -167
  320. package/src/analysis/dependency-health.ts +0 -146
  321. package/src/analysis/duplicate-exports.ts +0 -110
  322. package/src/analysis/fallow-suppression.ts +0 -98
  323. package/src/analysis/feature-flags-config.ts +0 -47
  324. package/src/analysis/feature-flags.ts +0 -223
  325. package/src/analysis/file-classifier.ts +0 -87
  326. package/src/analysis/git-changed-files.ts +0 -62
  327. package/src/analysis/health-baseline.ts +0 -80
  328. package/src/analysis/issue-filters.ts +0 -56
  329. package/src/analysis/list.ts +0 -74
  330. package/src/analysis/node-similarity.ts +0 -115
  331. package/src/analysis/private-type-leaks.ts +0 -119
  332. package/src/analysis/progress.ts +0 -43
  333. package/src/analysis/project-state.ts +0 -95
  334. package/src/analysis/regression-config.ts +0 -36
  335. package/src/analysis/rule-overrides.ts +0 -81
  336. package/src/analysis/scripts.ts +0 -95
  337. package/src/analysis/shape-extractor.ts +0 -202
  338. package/src/analysis/since-duration.ts +0 -42
  339. package/src/analysis/suppression-context.ts +0 -95
  340. package/src/analysis/suppressions.ts +0 -80
  341. package/src/analysis/surprise-scorer.ts +0 -74
  342. package/src/analysis/targets.ts +0 -237
  343. package/src/analysis/unused-class-members.ts +0 -79
  344. package/src/analysis/workspace-filter.ts +0 -89
  345. package/src/analyze/boundary-analysis.ts +0 -129
  346. package/src/analyze/predicates/file.ts +0 -86
  347. package/src/analyze/predicates/import.ts +0 -90
  348. package/src/analyze/predicates/lifecycle.ts +0 -55
  349. package/src/analyze/unused-deps.ts +0 -70
  350. package/src/analyze/unused-exports.ts +0 -145
  351. package/src/analyze/unused-files.ts +0 -46
  352. package/src/api/production-override.ts +0 -63
  353. package/src/api/programmatic.ts +0 -118
  354. package/src/audit.ts +0 -234
  355. package/src/cache/augment-cache.ts +0 -63
  356. package/src/cache/extraction-cache.ts +0 -141
  357. package/src/check/filtering.ts +0 -78
  358. package/src/check/index.ts +0 -99
  359. package/src/check/output.ts +0 -79
  360. package/src/check/rules.ts +0 -61
  361. package/src/ci-template.ts +0 -84
  362. package/src/claude-cli.ts +0 -59
  363. package/src/cli/ai-context.ts +0 -193
  364. package/src/cli/augment.ts +0 -114
  365. package/src/cli/check-update.ts +0 -40
  366. package/src/cli/doctor.ts +0 -182
  367. package/src/cli/eval-server.ts +0 -126
  368. package/src/cli/hooks-install.ts +0 -202
  369. package/src/cli/setup.ts +0 -197
  370. package/src/cli/skill-gen.ts +0 -347
  371. package/src/commands/flags.ts +0 -72
  372. package/src/config/boundary-config.ts +0 -183
  373. package/src/config/cli-schema.ts +0 -81
  374. package/src/config/config-parsing.ts +0 -102
  375. package/src/config/duplicates-config.ts +0 -62
  376. package/src/config/external-plugin.ts +0 -77
  377. package/src/config/health-config.ts +0 -42
  378. package/src/config/ignore-exports-used-in-file.ts +0 -46
  379. package/src/config/migration-types.ts +0 -73
  380. package/src/config/output-format.ts +0 -24
  381. package/src/config/plugins/builtin.ts +0 -411
  382. package/src/config/plugins/registry.ts +0 -77
  383. package/src/config/plugins/types.ts +0 -14
  384. package/src/config/resolution.ts +0 -102
  385. package/src/config/rules.ts +0 -70
  386. package/src/config/schema-gen.ts +0 -115
  387. package/src/config/types.ts +0 -149
  388. package/src/config/used-class-members.ts +0 -53
  389. package/src/config/validate.ts +0 -108
  390. package/src/config/workspace.ts +0 -137
  391. package/src/coverage/cloud-client.ts +0 -111
  392. package/src/coverage/upload-inventory.ts +0 -84
  393. package/src/coverage/upload-source-maps.ts +0 -97
  394. package/src/discover/entry-points.ts +0 -51
  395. package/src/discover/infrastructure-entries.ts +0 -175
  396. package/src/duplicates/detect/concatenation.ts +0 -37
  397. package/src/duplicates/detect/extraction.ts +0 -107
  398. package/src/duplicates/detect/filtering.ts +0 -112
  399. package/src/duplicates/detect/lcp.ts +0 -27
  400. package/src/duplicates/detect/ranking.ts +0 -16
  401. package/src/duplicates/detect/statistics.ts +0 -69
  402. package/src/duplicates/detect/suffix-array.ts +0 -88
  403. package/src/duplicates/families.ts +0 -95
  404. package/src/duplicates/normalize.ts +0 -58
  405. package/src/duplicates/shingle-filter.ts +0 -37
  406. package/src/duplicates/token-types.ts +0 -62
  407. package/src/duplicates/tokenize/index.ts +0 -104
  408. package/src/error/fallow-error.ts +0 -94
  409. package/src/error.ts +0 -47
  410. package/src/export/adjacency-matrix.ts +0 -127
  411. package/src/export/analysis-json.ts +0 -87
  412. package/src/export/badge.ts +0 -105
  413. package/src/export/canvas.ts +0 -42
  414. package/src/export/codeclimate.ts +0 -201
  415. package/src/export/compact-health.ts +0 -119
  416. package/src/export/compact.ts +0 -83
  417. package/src/export/csv.ts +0 -33
  418. package/src/export/cypher.ts +0 -33
  419. package/src/export/dot.ts +0 -52
  420. package/src/export/gexf.ts +0 -59
  421. package/src/export/graphml.ts +0 -50
  422. package/src/export/html.ts +0 -548
  423. package/src/export/index.ts +0 -9
  424. package/src/export/json.ts +0 -36
  425. package/src/export/markdown.ts +0 -290
  426. package/src/export/mermaid.ts +0 -100
  427. package/src/export/obsidian.ts +0 -44
  428. package/src/export/sarif.ts +0 -245
  429. package/src/export/svg.ts +0 -68
  430. package/src/fix/deps.ts +0 -70
  431. package/src/fix/enum-members.ts +0 -103
  432. package/src/fix/export-surgery.ts +0 -197
  433. package/src/fix/exports.ts +0 -93
  434. package/src/fix/orchestrator.ts +0 -67
  435. package/src/graph/analyzer.ts +0 -69
  436. package/src/graph/author-analytics.ts +0 -217
  437. package/src/graph/baseline.ts +0 -432
  438. package/src/graph/clone-families.ts +0 -132
  439. package/src/graph/codeowners-extended.ts +0 -114
  440. package/src/graph/codeowners-gitlab.ts +0 -150
  441. package/src/graph/codeowners.ts +0 -217
  442. package/src/graph/complexity.ts +0 -200
  443. package/src/graph/cross-reference-findings.ts +0 -85
  444. package/src/graph/cross-reference.ts +0 -139
  445. package/src/graph/cycle-detection.ts +0 -311
  446. package/src/graph/cycles.ts +0 -222
  447. package/src/graph/dead-code.ts +0 -128
  448. package/src/graph/dependency-closure.ts +0 -126
  449. package/src/graph/dfs.ts +0 -118
  450. package/src/graph/diff.ts +0 -92
  451. package/src/graph/duplication-stats.ts +0 -79
  452. package/src/graph/edge-filter.ts +0 -117
  453. package/src/graph/explain.ts +0 -133
  454. package/src/graph/external-style-usage.ts +0 -81
  455. package/src/graph/health-score.ts +0 -179
  456. package/src/graph/hotspots.ts +0 -219
  457. package/src/graph/import-chain.ts +0 -148
  458. package/src/graph/loader.ts +0 -44
  459. package/src/graph/maintainability.ts +0 -156
  460. package/src/graph/merge.ts +0 -174
  461. package/src/graph/mirrored-dirs.ts +0 -202
  462. package/src/graph/narrowing.ts +0 -92
  463. package/src/graph/node-search.ts +0 -201
  464. package/src/graph/node-types.ts +0 -67
  465. package/src/graph/normalize-id.ts +0 -138
  466. package/src/graph/pagerank.ts +0 -165
  467. package/src/graph/prune.ts +0 -95
  468. package/src/graph/re-exports/propagate.ts +0 -95
  469. package/src/graph/reachability.ts +0 -99
  470. package/src/graph/regex-search.ts +0 -232
  471. package/src/graph/regression.ts +0 -199
  472. package/src/graph/resolve/discover-types.ts +0 -45
  473. package/src/graph/resolve/dynamic-imports.ts +0 -102
  474. package/src/graph/resolve/fallbacks.ts +0 -79
  475. package/src/graph/resolve/index.ts +0 -68
  476. package/src/graph/resolve/path-info.ts +0 -41
  477. package/src/graph/resolve/re-exports.ts +0 -14
  478. package/src/graph/resolve/react-native.ts +0 -27
  479. package/src/graph/resolve/require-imports.ts +0 -18
  480. package/src/graph/resolve/specifier.ts +0 -120
  481. package/src/graph/resolve/static-imports.ts +0 -14
  482. package/src/graph/resolve/types.ts +0 -108
  483. package/src/graph/resolve/upgrades.ts +0 -32
  484. package/src/graph/ripple-impact.ts +0 -131
  485. package/src/graph/risk-profile.ts +0 -179
  486. package/src/graph/statistics.ts +0 -165
  487. package/src/graph/stats.ts +0 -157
  488. package/src/graph/subgraph.ts +0 -162
  489. package/src/graph/topo-sort.ts +0 -171
  490. package/src/graph/wcc.ts +0 -187
  491. package/src/groups/contract-bridge.ts +0 -103
  492. package/src/groups/contract-registry.ts +0 -263
  493. package/src/groups/group-config.ts +0 -108
  494. package/src/groups/group-search.ts +0 -139
  495. package/src/groups/group-sync.ts +0 -82
  496. package/src/groups/grpc-extractor.ts +0 -64
  497. package/src/groups/service-boundary.ts +0 -119
  498. package/src/groups/topic-extractor.ts +0 -90
  499. package/src/health/analysis-counts-snapshot.ts +0 -57
  500. package/src/health/analysis-counts.ts +0 -70
  501. package/src/health/complexity-findings.ts +0 -115
  502. package/src/health/distribution-thresholds.ts +0 -54
  503. package/src/health/grouping.ts +0 -138
  504. package/src/health/health-grouping.ts +0 -86
  505. package/src/health/health-report-types.ts +0 -165
  506. package/src/health/health-report.ts +0 -81
  507. package/src/health/health-score.ts +0 -65
  508. package/src/health/hotspot-utils.ts +0 -55
  509. package/src/health/hotspots.ts +0 -104
  510. package/src/health/large-functions.ts +0 -34
  511. package/src/health/ownership-metrics.ts +0 -61
  512. package/src/health/ownership-risk.ts +0 -98
  513. package/src/health/ownership.ts +0 -174
  514. package/src/health/quality-gate.ts +0 -57
  515. package/src/health/risk-profile.ts +0 -39
  516. package/src/health/runtime-coverage-report.ts +0 -101
  517. package/src/health/runtime-coverage.ts +0 -71
  518. package/src/health/scores.ts +0 -72
  519. package/src/health/scoring-types.ts +0 -48
  520. package/src/health/target-thresholds.ts +0 -92
  521. package/src/health/target-types.ts +0 -54
  522. package/src/health/targets.ts +0 -151
  523. package/src/health/timings.ts +0 -86
  524. package/src/health/trend-types.ts +0 -57
  525. package/src/health/trends.ts +0 -86
  526. package/src/health/vital-signs-compute.ts +0 -108
  527. package/src/health/vital-signs-snapshot.ts +0 -72
  528. package/src/health/vital-signs.ts +0 -101
  529. package/src/index.ts +0 -111
  530. package/src/ingest/git-clone.ts +0 -246
  531. package/src/ingest/query-memory.ts +0 -132
  532. package/src/ingest/transcribe.ts +0 -254
  533. package/src/ingest/url-ingest.ts +0 -87
  534. package/src/init/agent-hooks.ts +0 -86
  535. package/src/init/git-hooks.ts +0 -71
  536. package/src/init/project-detection.ts +0 -105
  537. package/src/license/manager.ts +0 -120
  538. package/src/lsp/code-actions.ts +0 -127
  539. package/src/lsp/code-lens.ts +0 -56
  540. package/src/lsp/diagnostics-ext.ts +0 -150
  541. package/src/lsp/diagnostics-push.ts +0 -103
  542. package/src/lsp/diagnostics.ts +0 -98
  543. package/src/lsp/hover.ts +0 -64
  544. package/src/lsp/server.ts +0 -254
  545. package/src/mcp/params.ts +0 -201
  546. package/src/mcp/resources.ts +0 -124
  547. package/src/mcp/tool-builders.ts +0 -203
  548. package/src/mcp-resources/communities-resource.ts +0 -72
  549. package/src/mcp-resources/graph-resource.ts +0 -14
  550. package/src/mcp-resources/index.ts +0 -9
  551. package/src/mcp-resources/named-cluster-resource.ts +0 -35
  552. package/src/mcp-resources/named-process-resource.ts +0 -26
  553. package/src/mcp-resources/processes-resource.ts +0 -67
  554. package/src/mcp-resources/repo-context-resource.ts +0 -36
  555. package/src/mcp-resources/repos-resource.ts +0 -21
  556. package/src/mcp-resources/schema-resource.ts +0 -46
  557. package/src/mcp-resources/wiki-resource.ts +0 -23
  558. package/src/mcp-tools/api-impact.ts +0 -181
  559. package/src/mcp-tools/context.ts +0 -111
  560. package/src/mcp-tools/cypher.ts +0 -29
  561. package/src/mcp-tools/detect-changes.ts +0 -116
  562. package/src/mcp-tools/explain.ts +0 -65
  563. package/src/mcp-tools/graph-query.ts +0 -128
  564. package/src/mcp-tools/group-list.ts +0 -88
  565. package/src/mcp-tools/group-query.ts +0 -26
  566. package/src/mcp-tools/group-sync.ts +0 -32
  567. package/src/mcp-tools/impact.ts +0 -202
  568. package/src/mcp-tools/index.ts +0 -21
  569. package/src/mcp-tools/list-repos.ts +0 -38
  570. package/src/mcp-tools/neighbors.ts +0 -80
  571. package/src/mcp-tools/query.ts +0 -86
  572. package/src/mcp-tools/rename.ts +0 -118
  573. package/src/mcp-tools/route-map.ts +0 -98
  574. package/src/mcp-tools/serve.ts +0 -41
  575. package/src/mcp-tools/shape-check.ts +0 -182
  576. package/src/mcp-tools/staleness.ts +0 -13
  577. package/src/mcp-tools/tool-map.ts +0 -66
  578. package/src/mcp-tools/wiki-build.ts +0 -37
  579. package/src/mcp-tools/wiki.ts +0 -28
  580. package/src/migrate/jscpd.ts +0 -78
  581. package/src/migrate/jsonc-gen.ts +0 -38
  582. package/src/migrate/knip.ts +0 -126
  583. package/src/migrate/toml-gen.ts +0 -48
  584. package/src/parsers/c.ts +0 -31
  585. package/src/parsers/cpp.ts +0 -29
  586. package/src/parsers/csharp.ts +0 -43
  587. package/src/parsers/dart.ts +0 -39
  588. package/src/parsers/extractor.ts +0 -202
  589. package/src/parsers/go.ts +0 -27
  590. package/src/parsers/java.ts +0 -27
  591. package/src/parsers/kotlin.ts +0 -36
  592. package/src/parsers/language-config.ts +0 -28
  593. package/src/parsers/language-parsers.ts +0 -120
  594. package/src/parsers/loader.ts +0 -149
  595. package/src/parsers/named-bindings.ts +0 -63
  596. package/src/parsers/php.ts +0 -37
  597. package/src/parsers/python.ts +0 -26
  598. package/src/parsers/ruby.ts +0 -39
  599. package/src/parsers/rust.ts +0 -25
  600. package/src/parsers/swift.ts +0 -28
  601. package/src/parsers/typescript.ts +0 -41
  602. package/src/parsers/vue.ts +0 -79
  603. package/src/pipeline/cluster-only.ts +0 -64
  604. package/src/pipeline/effort.ts +0 -50
  605. package/src/pipeline/orchestrator.ts +0 -384
  606. package/src/pipeline/phases/boundary.ts +0 -151
  607. package/src/pipeline/phases/bridge-adapters/electron-ipc.ts +0 -91
  608. package/src/pipeline/phases/bridge-adapters/registry.ts +0 -14
  609. package/src/pipeline/phases/bridge-adapters/tauri.ts +0 -103
  610. package/src/pipeline/phases/bridge-adapters/types.ts +0 -31
  611. package/src/pipeline/phases/bridge-adapters/wails.ts +0 -33
  612. package/src/pipeline/phases/bridge-resolver.ts +0 -77
  613. package/src/pipeline/phases/call-site-extractors.ts +0 -177
  614. package/src/pipeline/phases/communities.ts +0 -183
  615. package/src/pipeline/phases/contextual-proximity.ts +0 -88
  616. package/src/pipeline/phases/cross-file.ts +0 -116
  617. package/src/pipeline/phases/docs-parse.ts +0 -307
  618. package/src/pipeline/phases/evidence.ts +0 -9
  619. package/src/pipeline/phases/field-access.ts +0 -49
  620. package/src/pipeline/phases/framework-detect.ts +0 -109
  621. package/src/pipeline/phases/god-nodes.ts +0 -163
  622. package/src/pipeline/phases/import-resolver.ts +0 -114
  623. package/src/pipeline/phases/leiden.ts +0 -77
  624. package/src/pipeline/phases/llm-extract.ts +0 -178
  625. package/src/pipeline/phases/markdown.ts +0 -121
  626. package/src/pipeline/phases/middleware-extractor.ts +0 -127
  627. package/src/pipeline/phases/module-resolution.ts +0 -294
  628. package/src/pipeline/phases/mro.ts +0 -56
  629. package/src/pipeline/phases/orm.ts +0 -503
  630. package/src/pipeline/phases/parse.ts +0 -222
  631. package/src/pipeline/phases/pdf-parse.ts +0 -133
  632. package/src/pipeline/phases/processes.ts +0 -249
  633. package/src/pipeline/phases/re-export-propagation.ts +0 -160
  634. package/src/pipeline/phases/reachability.ts +0 -156
  635. package/src/pipeline/phases/routes.ts +0 -350
  636. package/src/pipeline/phases/scan.ts +0 -133
  637. package/src/pipeline/phases/scope-resolution.ts +0 -442
  638. package/src/pipeline/phases/structure.ts +0 -68
  639. package/src/pipeline/phases/suggest.ts +0 -92
  640. package/src/pipeline/phases/surprises.ts +0 -83
  641. package/src/pipeline/phases/tools.ts +0 -180
  642. package/src/pipeline/phases/variables-phase.ts +0 -37
  643. package/src/pipeline/phases/variables.ts +0 -67
  644. package/src/pipeline/phases/wildcard-phase.ts +0 -50
  645. package/src/pipeline/phases/wildcard-synthesis.ts +0 -214
  646. package/src/pipeline/progress.ts +0 -58
  647. package/src/pipeline/runner.ts +0 -88
  648. package/src/pipeline/types.ts +0 -41
  649. package/src/query/cypher-parser.ts +0 -450
  650. package/src/registry/repo-registry.ts +0 -125
  651. package/src/regression/baseline-deltas.ts +0 -215
  652. package/src/regression/baseline.ts +0 -76
  653. package/src/regression/counts.ts +0 -87
  654. package/src/regression/outcome.ts +0 -78
  655. package/src/regression/tolerance.ts +0 -35
  656. package/src/report/attributed-duplication.ts +0 -112
  657. package/src/report/badge-svg.ts +0 -100
  658. package/src/report/cross-ref-human.ts +0 -50
  659. package/src/report/duplication-grouping.ts +0 -74
  660. package/src/report/grouping.ts +0 -137
  661. package/src/report/human-check.ts +0 -291
  662. package/src/report/human-dupes.ts +0 -142
  663. package/src/report/human-health.ts +0 -195
  664. package/src/report/human.ts +0 -120
  665. package/src/report/json-actions.ts +0 -91
  666. package/src/report/json-builders.ts +0 -70
  667. package/src/report/json-schema.ts +0 -75
  668. package/src/report/number-format.ts +0 -91
  669. package/src/report/output-grouped.ts +0 -102
  670. package/src/report/pipeline-perf.ts +0 -56
  671. package/src/report/trace-human.ts +0 -127
  672. package/src/reporting/graph-report.ts +0 -431
  673. package/src/results/fallow-results.ts +0 -152
  674. package/src/results/types.ts +0 -149
  675. package/src/scope-resolution/evidence-weights.ts +0 -41
  676. package/src/search/ast-chunker.ts +0 -206
  677. package/src/search/diacritic.ts +0 -7
  678. package/src/search/hybrid-query.ts +0 -65
  679. package/src/search/rrf.ts +0 -51
  680. package/src/security/safe-fetch.ts +0 -113
  681. package/src/security/sensitive-files.ts +0 -24
  682. package/src/skills/platform-skills.ts +0 -233
  683. package/src/staleness/git-staleness.ts +0 -66
  684. package/src/storage/db.ts +0 -110
  685. package/src/storage/edge-store.ts +0 -103
  686. package/src/storage/file-cache.ts +0 -78
  687. package/src/storage/fts-store.ts +0 -385
  688. package/src/storage/node-store.ts +0 -209
  689. package/src/storage/schema.ts +0 -171
  690. package/src/storage/suppressions.ts +0 -145
  691. package/src/storage/unlinked-refs.ts +0 -117
  692. package/src/types.ts +0 -197
  693. package/src/validation/extraction-validator.ts +0 -54
  694. package/src/watch/watcher.ts +0 -160
  695. package/src/web/analyze-api.ts +0 -146
  696. package/src/web/api.ts +0 -584
  697. package/src/web/async-jobs.ts +0 -109
  698. package/src/web/mcp-http.ts +0 -227
  699. package/src/web/react-ui.ts +0 -78
  700. package/src/web/server.ts +0 -90
  701. package/src/web/ui/index.html +0 -204
  702. package/src/wiki/gist-publisher.ts +0 -76
  703. package/src/wiki/prompt-builder.ts +0 -35
  704. package/src/wiki/providers.ts +0 -134
  705. package/src/wiki/wiki-generator.ts +0 -223
  706. package/src/wiki/wiki-store.ts +0 -49
  707. package/tsconfig.json +0 -11
  708. package/vitest.config.ts +0 -20
@@ -1,131 +0,0 @@
1
- /**
2
- * Ripple / cascade impact analysis.
3
- *
4
- * Given a starting node, perform a multi-hop BFS through *directed* edges and
5
- * compute how far a change can propagate. Each depth level is assigned a
6
- * decaying weight so that direct dependents (depth 1) contribute more to the
7
- * totalScore than transitive dependents.
8
- *
9
- * Default decay factor: 0.5 per hop (configurable).
10
- */
11
-
12
- export interface RippleEdge {
13
- sourceId: string;
14
- targetId: string;
15
- }
16
-
17
- export interface RippleResult {
18
- /** Nodes reachable at each depth, starting at depth 1 (direct neighbors). */
19
- byDepth: Record<number, string[]>;
20
- /** Weighted sum: Σ(count_at_depth * decay^depth). */
21
- totalScore: number;
22
- }
23
-
24
- /**
25
- * Build a directed outgoing adjacency map from an edge list.
26
- *
27
- * Callers that run rippleImpact for multiple starting nodes on the same edge set
28
- * should build once and pass the map directly to `rippleImpactFromMap`.
29
- */
30
- export function buildOutgoingMap(edges: RippleEdge[]): Map<string, string[]> {
31
- const outgoing = new Map<string, string[]>();
32
- for (const { sourceId, targetId } of edges) {
33
- if (!outgoing.has(sourceId)) outgoing.set(sourceId, []);
34
- outgoing.get(sourceId)!.push(targetId);
35
- }
36
- return outgoing;
37
- }
38
-
39
- /**
40
- * Compute the ripple impact of changing `startNodeId` using a pre-built
41
- * outgoing adjacency map.
42
- *
43
- * Use this variant when querying multiple start nodes on the same edge set —
44
- * build the map once with `buildOutgoingMap` and reuse it across calls.
45
- *
46
- * @param startNodeId The node whose change we are propagating.
47
- * @param outgoing Pre-built directed adjacency map (source → targets).
48
- * @param maxDepth Maximum BFS depth (default 3).
49
- * @param decayFactor Weight multiplier per depth level (default 0.5).
50
- */
51
- export function rippleImpactFromMap(
52
- startNodeId: string,
53
- outgoing: Map<string, string[]>,
54
- maxDepth = 3,
55
- decayFactor = 0.5,
56
- ): RippleResult {
57
- if (!outgoing.has(startNodeId)) {
58
- return { byDepth: {}, totalScore: 0 };
59
- }
60
-
61
- const visited = new Set<string>([startNodeId]);
62
- const byDepth: Record<number, string[]> = {};
63
- let frontier = [startNodeId];
64
- let totalScore = 0;
65
-
66
- for (let depth = 1; depth <= maxDepth; depth++) {
67
- const nextFrontier: string[] = [];
68
- for (const node of frontier) {
69
- for (const neighbor of outgoing.get(node) ?? []) {
70
- if (!visited.has(neighbor)) {
71
- visited.add(neighbor);
72
- nextFrontier.push(neighbor);
73
- }
74
- }
75
- }
76
- if (nextFrontier.length === 0) break;
77
- byDepth[depth] = nextFrontier;
78
- totalScore += nextFrontier.length * Math.pow(decayFactor, depth);
79
- frontier = nextFrontier;
80
- }
81
-
82
- return { byDepth, totalScore };
83
- }
84
-
85
- /**
86
- * Compute the ripple impact of changing `startNodeId`.
87
- *
88
- * Builds the adjacency map from `edges` on each call. For repeated queries
89
- * over the same edge set, prefer `buildOutgoingMap` + `rippleImpactFromMap`.
90
- *
91
- * @param startNodeId The node whose change we are propagating.
92
- * @param edges Directed edges in the graph.
93
- * @param maxDepth Maximum BFS depth (default 3).
94
- * @param decayFactor Weight multiplier per depth level (default 0.5).
95
- */
96
- export function rippleImpact(
97
- startNodeId: string,
98
- edges: RippleEdge[],
99
- maxDepth = 3,
100
- decayFactor = 0.5,
101
- ): RippleResult {
102
- return rippleImpactFromMap(startNodeId, buildOutgoingMap(edges), maxDepth, decayFactor);
103
- }
104
-
105
- /**
106
- * Format ripple impact results as structured text for LLM consumption.
107
- */
108
- export function formatRippleImpact(
109
- startNodeId: string,
110
- result: RippleResult,
111
- nodeLabels?: Map<string, string>,
112
- ): string {
113
- const depths = Object.keys(result.byDepth).map(Number).sort((a, b) => a - b);
114
- if (depths.length === 0) {
115
- return `No ripple impact found for: ${startNodeId} (isolated or leaf node)`;
116
- }
117
-
118
- const lines: string[] = [
119
- `Ripple impact of changing: ${startNodeId}`,
120
- ` Total score: ${result.totalScore.toFixed(3)} (weighted cascade depth)`,
121
- ];
122
- for (const depth of depths) {
123
- const nodes = result.byDepth[depth]!;
124
- lines.push(` Depth ${depth} (${nodes.length} node${nodes.length === 1 ? '' : 's'}):`);
125
- for (const id of nodes) {
126
- const label = nodeLabels?.get(id);
127
- lines.push(` - ${id}${label ? ` [${label}]` : ''}`);
128
- }
129
- }
130
- return lines.join('\n');
131
- }
@@ -1,179 +0,0 @@
1
- import type { MonographDb } from '../storage/db.js';
2
-
3
- export interface SizeBin {
4
- label: string; // e.g. '1-10 lines'
5
- min: number;
6
- max: number;
7
- count: number;
8
- percentage: number;
9
- }
10
-
11
- export interface RiskProfileReport {
12
- functionSizeDistribution: SizeBin[];
13
- paramCountDistribution: SizeBin[];
14
- riskSummary: {
15
- largeFunction: number; // LOC > 100
16
- longParamList: number; // params > 5
17
- highRisk: number; // BOTH large AND long param list
18
- };
19
- p50loc: number;
20
- p90loc: number;
21
- p95loc: number;
22
- }
23
-
24
- interface FunctionNode {
25
- start_line: number | null;
26
- end_line: number | null;
27
- properties: string | null;
28
- }
29
-
30
- const LOC_BINS: Array<{ label: string; min: number; max: number }> = [
31
- { label: '1-10 lines', min: 1, max: 10 },
32
- { label: '11-25 lines', min: 11, max: 25 },
33
- { label: '26-50 lines', min: 26, max: 50 },
34
- { label: '51-100 lines', min: 51, max: 100 },
35
- { label: '101-250 lines',min: 101, max: 250 },
36
- { label: '250+ lines', min: 251, max: Infinity },
37
- ];
38
-
39
- const PARAM_BINS: Array<{ label: string; min: number; max: number }> = [
40
- { label: '0-2 params', min: 0, max: 2 },
41
- { label: '3-5 params', min: 3, max: 5 },
42
- { label: '6-8 params', min: 6, max: 8 },
43
- { label: '9+ params', min: 9, max: Infinity },
44
- ];
45
-
46
- function percentile(sorted: number[], p: number): number {
47
- if (sorted.length === 0) return 0;
48
- const idx = Math.floor(sorted.length * p);
49
- return sorted[Math.min(idx, sorted.length - 1)];
50
- }
51
-
52
- export function computeRiskProfile(db: MonographDb): RiskProfileReport {
53
- // Push paramCount extraction to SQL with json_extract to avoid per-row JSON.parse
54
- const rows = db.prepare(`
55
- SELECT
56
- start_line,
57
- end_line,
58
- CAST(json_extract(properties, '$.paramCount') AS INTEGER) AS param_count
59
- FROM nodes
60
- WHERE label IN ('Function', 'Method')
61
- AND start_line IS NOT NULL
62
- AND end_line IS NOT NULL
63
- `).all() as { start_line: number; end_line: number; param_count: number | null }[];
64
-
65
- // ── Single-pass: compute LOC, assign to bins, accumulate risk summary ─────
66
- const locBinCounts = new Array<number>(LOC_BINS.length).fill(0);
67
- const paramBinCounts = new Array<number>(PARAM_BINS.length).fill(0);
68
- const sortedLocs: number[] = [];
69
- let largeFunction = 0;
70
- let longParamList = 0;
71
- let highRisk = 0;
72
-
73
- for (const row of rows) {
74
- const loc = row.end_line - row.start_line + 1;
75
- if (loc < 1) continue;
76
-
77
- sortedLocs.push(loc);
78
-
79
- // Assign to LOC bin in O(bins) rather than O(N×bins) via filter
80
- for (let i = 0; i < LOC_BINS.length; i++) {
81
- const bin = LOC_BINS[i];
82
- if (loc >= bin.min && loc <= bin.max) {
83
- locBinCounts[i]++;
84
- break;
85
- }
86
- }
87
-
88
- const pc = row.param_count ?? 0;
89
- for (let i = 0; i < PARAM_BINS.length; i++) {
90
- const bin = PARAM_BINS[i];
91
- if (pc >= bin.min && pc <= bin.max) {
92
- paramBinCounts[i]++;
93
- break;
94
- }
95
- }
96
-
97
- const large = loc > 100;
98
- const longParam = pc > 5;
99
- if (large) largeFunction++;
100
- if (longParam) longParamList++;
101
- if (large && longParam) highRisk++;
102
- }
103
-
104
- const total = sortedLocs.length;
105
-
106
- // ── Build bin result arrays ───────────────────────────────────────────────
107
- const functionSizeDistribution: SizeBin[] = LOC_BINS.map((bin, i) => ({
108
- label: bin.label,
109
- min: bin.min,
110
- max: bin.max === Infinity ? 999999 : bin.max,
111
- count: locBinCounts[i],
112
- percentage: total > 0 ? Math.round((locBinCounts[i] / total) * 1000) / 10 : 0,
113
- }));
114
-
115
- const paramCountDistribution: SizeBin[] = PARAM_BINS.map((bin, i) => ({
116
- label: bin.label,
117
- min: bin.min,
118
- max: bin.max === Infinity ? 999999 : bin.max,
119
- count: paramBinCounts[i],
120
- percentage: total > 0 ? Math.round((paramBinCounts[i] / total) * 1000) / 10 : 0,
121
- }));
122
-
123
- // ── Percentiles ────────────────────────────────────────────────────────────
124
- sortedLocs.sort((a, b) => a - b);
125
- const p50loc = percentile(sortedLocs, 0.50);
126
- const p90loc = percentile(sortedLocs, 0.90);
127
- const p95loc = percentile(sortedLocs, 0.95);
128
-
129
- return {
130
- functionSizeDistribution,
131
- paramCountDistribution,
132
- riskSummary: { largeFunction, longParamList, highRisk },
133
- p50loc,
134
- p90loc,
135
- p95loc,
136
- };
137
- }
138
-
139
- /**
140
- * Format a RiskProfileReport as structured text with distribution tables for LLM navigation.
141
- *
142
- * @param report - RiskProfileReport from computeRiskProfile()
143
- * @returns structured text suitable for LLM consumption
144
- */
145
- export function formatRiskProfile(report: RiskProfileReport): string {
146
- const { functionSizeDistribution, paramCountDistribution, riskSummary, p50loc, p90loc, p95loc } = report;
147
-
148
- const total = functionSizeDistribution.reduce((s, b) => s + b.count, 0);
149
- if (total === 0) {
150
- return 'risk_profile: no Function/Method nodes with line info found\n';
151
- }
152
-
153
- const lines: string[] = [
154
- `risk_profile: ${total} functions analysed`,
155
- ` p50_loc: ${p50loc} p90_loc: ${p90loc} p95_loc: ${p95loc}`,
156
- ` large_functions(loc>100): ${riskSummary.largeFunction} long_param_list(params>5): ${riskSummary.longParamList} high_risk(both): ${riskSummary.highRisk}`,
157
- '',
158
- 'function_size_distribution:',
159
- ];
160
-
161
- for (const bin of functionSizeDistribution) {
162
- const bar = '#'.repeat(Math.round(bin.percentage / 5)); // 1 char per 5%
163
- lines.push(` ${bin.label.padEnd(15)} ${String(bin.count).padStart(5)} (${String(bin.percentage).padStart(5)}%) ${bar}`);
164
- }
165
-
166
- lines.push('');
167
- lines.push('param_count_distribution:');
168
- for (const bin of paramCountDistribution) {
169
- const bar = '#'.repeat(Math.round(bin.percentage / 5));
170
- lines.push(` ${bin.label.padEnd(15)} ${String(bin.count).padStart(5)} (${String(bin.percentage).padStart(5)}%) ${bar}`);
171
- }
172
-
173
- if (riskSummary.highRisk > 0) {
174
- lines.push('');
175
- lines.push(`high_risk_note: ${riskSummary.highRisk} function(s) have both loc>100 AND params>5 — prime refactor candidates`);
176
- }
177
-
178
- return lines.join('\n');
179
- }
@@ -1,165 +0,0 @@
1
- import { bfsFromNode } from 'graphology-traversal/bfs.js';
2
- import type Graph from 'graphology';
3
- import { loadGraphFromDb } from './loader.js';
4
- import type { MonographDb } from '../storage/db.js';
5
-
6
- // ---------------------------------------------------------------------------
7
- // Module-level graph cache — avoids reloading the full graph on every call
8
- // when multiple statistics functions are invoked in the same request cycle.
9
- // TTL: 5 seconds; keyed by DB file path (better-sqlite3 exposes .name).
10
- // ---------------------------------------------------------------------------
11
- const GRAPH_CACHE_TTL_MS = 5_000;
12
-
13
- interface GraphCacheEntry {
14
- graph: Graph;
15
- expiresAt: number;
16
- }
17
-
18
- const _graphCache = new Map<string, GraphCacheEntry>();
19
-
20
- function getGraph(db: MonographDb): Graph {
21
- const key = (db as unknown as { name: string }).name ?? '__default__';
22
- const now = Date.now();
23
- const cached = _graphCache.get(key);
24
- if (cached && now < cached.expiresAt) return cached.graph;
25
- const graph = loadGraphFromDb(db);
26
- _graphCache.set(key, { graph, expiresAt: now + GRAPH_CACHE_TTL_MS });
27
- return graph;
28
- }
29
-
30
- /**
31
- * Graph density: ratio of actual edges to maximum possible directed edges.
32
- * For a directed graph with n nodes: max = n * (n - 1).
33
- * Ignores self-loops.
34
- */
35
- export function graphDensity(db: MonographDb): number {
36
- const graph = getGraph(db);
37
- const n = graph.order;
38
- if (n < 2) return 0;
39
- const maxEdges = n * (n - 1);
40
- // Use simple directed edge count (deduplicate multi-edges for density)
41
- const seen = new Set<string>();
42
- graph.forEachEdge((_, _attr, src, tgt) => {
43
- if (src !== tgt) seen.add(`${src}→${tgt}`);
44
- });
45
- return seen.size / maxEdges;
46
- }
47
-
48
- /**
49
- * Average local clustering coefficient across all nodes.
50
- * For a directed graph, the local clustering coefficient of node v is:
51
- * (triangles through v) / (directed_pairs through v)
52
- * where directed_pairs = k_in * k_out - mutual_pairs
53
- * We use the undirected approximation: treat edges as undirected, count triangles.
54
- */
55
- export function clusteringCoefficient(db: MonographDb): number {
56
- const graph = getGraph(db);
57
- if (graph.order === 0) return 0;
58
-
59
- // Build undirected adjacency sets
60
- const neighbors = new Map<string, Set<string>>();
61
- graph.forEachNode(node => neighbors.set(node, new Set()));
62
- graph.forEachEdge((_, _attr, src, tgt) => {
63
- if (src !== tgt) {
64
- neighbors.get(src)!.add(tgt);
65
- neighbors.get(tgt)!.add(src);
66
- }
67
- });
68
-
69
- let totalCoeff = 0;
70
- let countWithNeighbors = 0;
71
-
72
- // Cap per-node neighbor scan to avoid O(k²) explosion on hub nodes
73
- const MAX_K = 200;
74
- for (const [node, nbrs] of neighbors) {
75
- const k = nbrs.size;
76
- if (k < 2) continue;
77
-
78
- let triangles = 0;
79
- const nbList = k <= MAX_K ? [...nbrs] : [...nbrs].slice(0, MAX_K);
80
- const effectiveK = nbList.length;
81
- for (let i = 0; i < effectiveK; i++) {
82
- for (let j = i + 1; j < effectiveK; j++) {
83
- if (neighbors.get(nbList[i])?.has(nbList[j])) {
84
- triangles++;
85
- }
86
- }
87
- }
88
-
89
- const possible = (effectiveK * (effectiveK - 1)) / 2;
90
- totalCoeff += triangles / possible;
91
- countWithNeighbors++;
92
- }
93
-
94
- if (countWithNeighbors === 0) return 0;
95
- return totalCoeff / countWithNeighbors;
96
- }
97
-
98
- // ---------------------------------------------------------------------------
99
- // Shared BFS result for path-length metrics
100
- // ---------------------------------------------------------------------------
101
-
102
- export interface PathStats {
103
- /** Average shortest path length across all reachable pairs (i ≠ j). */
104
- averagePathLength: number;
105
- /** Maximum shortest path length (diameter) across all reachable pairs. */
106
- diameter: number;
107
- }
108
-
109
- /**
110
- * Compute both average path length and graph diameter via BFS.
111
- * For graphs > 500 nodes, uses deterministic sampling (every Nth node)
112
- * to keep runtime practical — O(sample * E) instead of O(N * E).
113
- */
114
- export function pathStats(db: MonographDb): PathStats {
115
- const graph = getGraph(db);
116
- const nodes = graph.nodes();
117
- if (nodes.length < 2) return { averagePathLength: 0, diameter: 0 };
118
-
119
- // Sample sources for large graphs — stride ensures even coverage
120
- const MAX_SOURCES = 500;
121
- const stride = nodes.length <= MAX_SOURCES ? 1 : Math.ceil(nodes.length / MAX_SOURCES);
122
- const sources: string[] = [];
123
- for (let i = 0; i < nodes.length && sources.length < MAX_SOURCES; i += stride) {
124
- sources.push(nodes[i]);
125
- }
126
-
127
- let totalLength = 0;
128
- let reachablePairs = 0;
129
- let maxDist = 0;
130
-
131
- for (const source of sources) {
132
- bfsFromNode(graph, source, (node, _attr, depth) => {
133
- if (node !== source && depth > 0) {
134
- totalLength += depth;
135
- reachablePairs++;
136
- if (depth > maxDist) maxDist = depth;
137
- }
138
- });
139
- }
140
-
141
- return {
142
- averagePathLength: reachablePairs === 0 ? 0 : totalLength / reachablePairs,
143
- diameter: maxDist,
144
- };
145
- }
146
-
147
- /**
148
- * Average shortest path length across all reachable node pairs (i, j) where i ≠ j.
149
- * Computed using BFS from each node. Unreachable pairs are excluded from the average.
150
- *
151
- * @deprecated Prefer `pathStats(db).averagePathLength` to share BFS with `graphDiameter`.
152
- */
153
- export function averagePathLength(db: MonographDb): number {
154
- return pathStats(db).averagePathLength;
155
- }
156
-
157
- /**
158
- * Graph diameter: the maximum shortest path length across all reachable node pairs.
159
- * Returns 0 for empty or single-node graphs.
160
- *
161
- * @deprecated Prefer `pathStats(db).diameter` to share BFS with `averagePathLength`.
162
- */
163
- export function graphDiameter(db: MonographDb): number {
164
- return pathStats(db).diameter;
165
- }
@@ -1,157 +0,0 @@
1
- import type Database from 'better-sqlite3';
2
-
3
- // Per-DB prepared statement cache to avoid re-parsing SQL on repeated calls
4
- const stmtCache = new WeakMap<Database.Database, Map<string, Database.Statement>>();
5
-
6
- function stmt(db: Database.Database, sql: string): Database.Statement {
7
- let dbCache = stmtCache.get(db);
8
- if (!dbCache) { dbCache = new Map(); stmtCache.set(db, dbCache); }
9
- let s = dbCache.get(sql);
10
- if (!s) { s = db.prepare(sql); dbCache.set(sql, s); }
11
- return s;
12
- }
13
-
14
- /** Binary search: returns index of first element > value in a sorted ascending array. */
15
- function upperBound(sorted: number[], value: number): number {
16
- let lo = 0, hi = sorted.length;
17
- while (lo < hi) {
18
- const mid = (lo + hi) >>> 1;
19
- if (sorted[mid] <= value) lo = mid + 1;
20
- else hi = mid;
21
- }
22
- return lo;
23
- }
24
-
25
- export type RiskBin = 'low' | 'medium' | 'high' | 'critical';
26
-
27
- export interface RiskProfile {
28
- low: number;
29
- medium: number;
30
- high: number;
31
- critical: number;
32
- lowPct: number;
33
- mediumPct: number;
34
- highPct: number;
35
- criticalPct: number;
36
- }
37
-
38
- export interface CouplingProfile {
39
- p50FanIn: number;
40
- p75FanIn: number;
41
- p90FanIn: number;
42
- p95FanIn: number;
43
- couplingHighPct: number;
44
- fanInProfile: RiskProfile;
45
- fanOutProfile: RiskProfile;
46
- totalFiles: number;
47
- }
48
-
49
- export interface GraphStatsSummary {
50
- nodeCount: number;
51
- edgeCount: number;
52
- communityCount: number;
53
- fileCount: number;
54
- couplingProfile: CouplingProfile;
55
- }
56
-
57
- function percentile(sorted: number[], p: number): number {
58
- if (sorted.length === 0) return 0;
59
- const idx = Math.floor((p / 100) * sorted.length);
60
- return sorted[Math.min(idx, sorted.length - 1)];
61
- }
62
-
63
- function buildRiskProfile(values: number[]): RiskProfile {
64
- const total = values.length;
65
- let low = 0, medium = 0, high = 0, critical = 0;
66
- for (const v of values) {
67
- if (v < 5) low++;
68
- else if (v <= 15) medium++;
69
- else if (v <= 30) high++;
70
- else critical++;
71
- }
72
- const pct = (n: number) => total > 0 ? Math.round((n / total) * 100) : 0;
73
- return {
74
- low,
75
- medium,
76
- high,
77
- critical,
78
- lowPct: pct(low),
79
- mediumPct: pct(medium),
80
- highPct: pct(high),
81
- criticalPct: pct(critical),
82
- };
83
- }
84
-
85
- /**
86
- * Compute full coupling profile from SQLite.
87
- */
88
- export function computeCouplingProfile(db: Database.Database): CouplingProfile {
89
- const fanInRows = stmt(db, 'SELECT target_id, COUNT(*) as c FROM edges GROUP BY target_id')
90
- .all() as { target_id: string; c: number }[];
91
-
92
- const fanOutRows = stmt(db, 'SELECT source_id, COUNT(*) as c FROM edges GROUP BY source_id')
93
- .all() as { source_id: string; c: number }[];
94
-
95
- const totalFiles = (stmt(db, "SELECT COUNT(*) as n FROM nodes WHERE label = 'File'")
96
- .get() as { n: number }).n;
97
-
98
- const fanInValues = fanInRows.map(r => r.c).sort((a, b) => a - b);
99
- const fanOutValues = fanOutRows.map(r => r.c).sort((a, b) => a - b);
100
-
101
- const p95FanIn = percentile(fanInValues, 95);
102
- // Use binary search instead of O(N) filter to count elements above p95 threshold
103
- const couplingHighCount = fanInValues.length - upperBound(fanInValues, p95FanIn);
104
- const couplingHighPct = fanInValues.length > 0
105
- ? Math.round((couplingHighCount / fanInValues.length) * 100)
106
- : 0;
107
-
108
- return {
109
- p50FanIn: percentile(fanInValues, 50),
110
- p75FanIn: percentile(fanInValues, 75),
111
- p90FanIn: percentile(fanInValues, 90),
112
- p95FanIn,
113
- couplingHighPct,
114
- fanInProfile: buildRiskProfile(fanInValues),
115
- fanOutProfile: buildRiskProfile(fanOutValues),
116
- totalFiles,
117
- };
118
- }
119
-
120
- /**
121
- * Quick stats summary (extends existing stats from monograph_stats MCP tool).
122
- */
123
- export function computeGraphStats(db: Database.Database): GraphStatsSummary {
124
- const nodeCount = (stmt(db, 'SELECT COUNT(*) as n FROM nodes').get() as { n: number }).n;
125
- const edgeCount = (stmt(db, 'SELECT COUNT(*) as n FROM edges').get() as { n: number }).n;
126
- const communityCount = (stmt(db,
127
- "SELECT COUNT(DISTINCT community_id) as n FROM nodes WHERE community_id IS NOT NULL"
128
- ).get() as { n: number }).n;
129
- const fileCount = (stmt(db, "SELECT COUNT(*) as n FROM nodes WHERE label = 'File'")
130
- .get() as { n: number }).n;
131
-
132
- const couplingProfile = computeCouplingProfile(db);
133
-
134
- return {
135
- nodeCount,
136
- edgeCount,
137
- communityCount,
138
- fileCount,
139
- couplingProfile,
140
- };
141
- }
142
-
143
- /** Format a GraphStatsSummary as structured text for LLM consumption. */
144
- export function formatGraphStats(s: GraphStatsSummary): string {
145
- const cp = s.couplingProfile;
146
- const totalEntities = cp.fanInProfile.low + cp.fanInProfile.medium + cp.fanInProfile.high + cp.fanInProfile.critical;
147
- const lines: string[] = [
148
- `Graph Stats`,
149
- ` Nodes: ${s.nodeCount} Edges: ${s.edgeCount} Communities: ${s.communityCount} Files: ${s.fileCount}`,
150
- `Coupling Profile (${totalEntities} entities, ${cp.totalFiles} files)`,
151
- ` Fan-in p50/p75/p90/p95: ${cp.p50FanIn}/${cp.p75FanIn}/${cp.p90FanIn}/${cp.p95FanIn}`,
152
- ` High-coupling (>p95): ${cp.couplingHighPct}%`,
153
- `Fan-in Risk: low=${cp.fanInProfile.low}(${cp.fanInProfile.lowPct}%) med=${cp.fanInProfile.medium}(${cp.fanInProfile.mediumPct}%) high=${cp.fanInProfile.high}(${cp.fanInProfile.highPct}%) crit=${cp.fanInProfile.critical}(${cp.fanInProfile.criticalPct}%)`,
154
- `Fan-out Risk: low=${cp.fanOutProfile.low}(${cp.fanOutProfile.lowPct}%) med=${cp.fanOutProfile.medium}(${cp.fanOutProfile.mediumPct}%) high=${cp.fanOutProfile.high}(${cp.fanOutProfile.highPct}%) crit=${cp.fanOutProfile.critical}(${cp.fanOutProfile.criticalPct}%)`,
155
- ];
156
- return lines.join('\n');
157
- }