@monoes/monograph 1.5.6 → 1.5.7

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 (596) hide show
  1. package/README.md +25 -9
  2. package/dist/src/mcp-tools/impact.d.ts.map +1 -1
  3. package/dist/src/mcp-tools/impact.js +1 -10
  4. package/dist/src/mcp-tools/impact.js.map +1 -1
  5. package/dist/tsconfig.tsbuildinfo +1 -1
  6. package/package.json +12 -9
  7. package/.monomind/data/ranked-context.json +0 -5
  8. package/.monomind/loops/mastermind-review-1782162423447.json +0 -16
  9. package/.monomind/sessions/session-1777578175215.json +0 -15
  10. package/.monomind/sessions/session-1777823684507.json +0 -15
  11. package/.monomind/sessions/session-1777928944749.json +0 -15
  12. package/.monomind/sessions/session-1778052902210.json +0 -15
  13. package/.monomind/sessions/session-1778056744636.json +0 -15
  14. package/.monomind/sessions/session-1778061077599.json +0 -15
  15. package/.monomind/sessions/session-1778102154764.json +0 -15
  16. package/__tests__/analysis/shape-extractor.test.ts +0 -124
  17. package/__tests__/analysis/surprise-scorer.test.ts +0 -154
  18. package/__tests__/cache/extraction-cache.test.ts +0 -45
  19. package/__tests__/cli/ai-context.test.ts +0 -175
  20. package/__tests__/cli/augment.test.ts +0 -128
  21. package/__tests__/cli/doctor.test.ts +0 -125
  22. package/__tests__/cli/eval-server.test.ts +0 -89
  23. package/__tests__/cli/setup.test.ts +0 -178
  24. package/__tests__/cli/skill-gen.test.ts +0 -280
  25. package/__tests__/export/formats.test.ts +0 -82
  26. package/__tests__/fixtures/sample.c +0 -25
  27. package/__tests__/fixtures/sample.cpp +0 -32
  28. package/__tests__/fixtures/sample.dart +0 -34
  29. package/__tests__/fixtures/sample.kt +0 -30
  30. package/__tests__/fixtures/sample.php +0 -30
  31. package/__tests__/fixtures/sample.py +0 -11
  32. package/__tests__/fixtures/sample.rb +0 -26
  33. package/__tests__/fixtures/sample.swift +0 -42
  34. package/__tests__/fixtures/sample.ts +0 -17
  35. package/__tests__/fixtures/sample.vue +0 -40
  36. package/__tests__/groups/group-search.test.ts +0 -221
  37. package/__tests__/groups/group-sync.test.ts +0 -336
  38. package/__tests__/integration/build-atomicity.test.ts +0 -61
  39. package/__tests__/integration/call-attribution.test.ts +0 -116
  40. package/__tests__/integration/full-pipeline.test.ts +0 -64
  41. package/__tests__/integration/graph-report-freshness.test.ts +0 -53
  42. package/__tests__/integration/incremental-build.test.ts +0 -103
  43. package/__tests__/mcp-resources/resources.test.ts +0 -256
  44. package/__tests__/mcp-tools/api-impact.test.ts +0 -188
  45. package/__tests__/mcp-tools/context.test.ts +0 -130
  46. package/__tests__/mcp-tools/cypher.test.ts +0 -258
  47. package/__tests__/mcp-tools/detect-changes.test.ts +0 -114
  48. package/__tests__/mcp-tools/impact.test.ts +0 -133
  49. package/__tests__/mcp-tools/rename.test.ts +0 -117
  50. package/__tests__/mcp-tools/route-map.test.ts +0 -237
  51. package/__tests__/mcp-tools/shape-check.test.ts +0 -202
  52. package/__tests__/mcp-tools/tool-map.test.ts +0 -135
  53. package/__tests__/parsers/c.test.ts +0 -28
  54. package/__tests__/parsers/cpp.test.ts +0 -28
  55. package/__tests__/parsers/csharp.test.ts +0 -62
  56. package/__tests__/parsers/dart.test.ts +0 -28
  57. package/__tests__/parsers/kotlin.test.ts +0 -28
  58. package/__tests__/parsers/loader.test.ts +0 -14
  59. package/__tests__/parsers/php.test.ts +0 -28
  60. package/__tests__/parsers/python.test.ts +0 -32
  61. package/__tests__/parsers/ruby.test.ts +0 -33
  62. package/__tests__/parsers/swift.test.ts +0 -28
  63. package/__tests__/parsers/typescript.test.ts +0 -45
  64. package/__tests__/parsers/vue.test.ts +0 -28
  65. package/__tests__/pipeline/analysis.test.ts +0 -58
  66. package/__tests__/pipeline/phases/corpus-check.test.ts +0 -26
  67. package/__tests__/pipeline/phases/evidence.test.ts +0 -41
  68. package/__tests__/pipeline/phases/field-access.test.ts +0 -22
  69. package/__tests__/pipeline/phases/leiden.test.ts +0 -72
  70. package/__tests__/pipeline/phases/markdown.test.ts +0 -84
  71. package/__tests__/pipeline/phases/middleware-extractor.test.ts +0 -131
  72. package/__tests__/pipeline/phases/orm.test.ts +0 -379
  73. package/__tests__/pipeline/phases/processes.test.ts +0 -191
  74. package/__tests__/pipeline/phases/routes.test.ts +0 -195
  75. package/__tests__/pipeline/phases/scope-resolution.test.ts +0 -133
  76. package/__tests__/pipeline/phases/tools.test.ts +0 -161
  77. package/__tests__/pipeline/phases/variables.test.ts +0 -30
  78. package/__tests__/pipeline/phases/wildcard-synthesis.test.ts +0 -207
  79. package/__tests__/pipeline/phases.test.ts +0 -41
  80. package/__tests__/pipeline/runner.test.ts +0 -28
  81. package/__tests__/registry/repo-registry.test.ts +0 -127
  82. package/__tests__/reporting/graph-report.suggest.test.ts +0 -36
  83. package/__tests__/reporting/graph-report.test.ts +0 -165
  84. package/__tests__/search/ast-chunker.test.ts +0 -63
  85. package/__tests__/search/rrf.test.ts +0 -95
  86. package/__tests__/security/safe-fetch.test.ts +0 -41
  87. package/__tests__/security/sensitive-files.test.ts +0 -32
  88. package/__tests__/setup.ts +0 -1
  89. package/__tests__/skills/platform-skills.test.ts +0 -63
  90. package/__tests__/staleness/git-staleness.test.ts +0 -107
  91. package/__tests__/storage/db.test.ts +0 -37
  92. package/__tests__/storage/evidence-roundtrip.test.ts +0 -89
  93. package/__tests__/storage/stores.test.ts +0 -165
  94. package/__tests__/types.test.ts +0 -13
  95. package/__tests__/validation/extraction-validator.test.ts +0 -48
  96. package/__tests__/watch/watcher.test.ts +0 -31
  97. package/__tests__/web/analyze-api.test.ts +0 -66
  98. package/__tests__/web/api.test.ts +0 -210
  99. package/__tests__/web/mcp-http.test.ts +0 -67
  100. package/__tests__/web/react-ui.test.ts +0 -43
  101. package/__tests__/wiki/gist-publisher.test.ts +0 -66
  102. package/__tests__/wiki/providers.test.ts +0 -69
  103. package/__tests__/wiki/wiki-generator.test.ts +0 -260
  104. package/src/__tests__/analysis/benchmark.test.ts +0 -59
  105. package/src/__tests__/analysis/cluster-quality.test.ts +0 -106
  106. package/src/__tests__/analysis/corpus-health.test.ts +0 -33
  107. package/src/__tests__/analysis/dependency-health.test.ts +0 -105
  108. package/src/__tests__/analysis/file-classifier.test.ts +0 -50
  109. package/src/__tests__/analysis/node-similarity.test.ts +0 -81
  110. package/src/__tests__/cache/augment-cache.test.ts +0 -55
  111. package/src/__tests__/cli/check-update.test.ts +0 -42
  112. package/src/__tests__/cli/hooks-install.test.ts +0 -56
  113. package/src/__tests__/cli/hooks-marker.test.ts +0 -138
  114. package/src/__tests__/cli/hooks-status.test.ts +0 -42
  115. package/src/__tests__/export/adjacency-matrix.test.ts +0 -116
  116. package/src/__tests__/export/csv.test.ts +0 -39
  117. package/src/__tests__/export/dot.test.ts +0 -86
  118. package/src/__tests__/export/gexf.test.ts +0 -78
  119. package/src/__tests__/export/graphml.test.ts +0 -57
  120. package/src/__tests__/export/mermaid.test.ts +0 -89
  121. package/src/__tests__/graph/betweenness.test.ts +0 -89
  122. package/src/__tests__/graph/cycles.test.ts +0 -131
  123. package/src/__tests__/graph/dead-code.test.ts +0 -174
  124. package/src/__tests__/graph/dfs.test.ts +0 -62
  125. package/src/__tests__/graph/diff-summary.test.ts +0 -83
  126. package/src/__tests__/graph/edge-filter.test.ts +0 -129
  127. package/src/__tests__/graph/import-chain.test.ts +0 -111
  128. package/src/__tests__/graph/merge.test.ts +0 -151
  129. package/src/__tests__/graph/node-search.test.ts +0 -167
  130. package/src/__tests__/graph/normalize-id.test.ts +0 -102
  131. package/src/__tests__/graph/pagerank.test.ts +0 -96
  132. package/src/__tests__/graph/prune.test.ts +0 -110
  133. package/src/__tests__/graph/regex-search.test.ts +0 -166
  134. package/src/__tests__/graph/ripple-impact.test.ts +0 -73
  135. package/src/__tests__/graph/scc.test.ts +0 -85
  136. package/src/__tests__/graph/statistics.test.ts +0 -219
  137. package/src/__tests__/graph/subgraph.test.ts +0 -127
  138. package/src/__tests__/graph/topo-sort.test.ts +0 -110
  139. package/src/__tests__/graph/wcc.test.ts +0 -101
  140. package/src/__tests__/groups/grpc-extractor.test.ts +0 -47
  141. package/src/__tests__/groups/service-boundary.test.ts +0 -86
  142. package/src/__tests__/groups/topic-extractor.test.ts +0 -43
  143. package/src/__tests__/ingest/git-clone.test.ts +0 -128
  144. package/src/__tests__/ingest/query-memory.test.ts +0 -123
  145. package/src/__tests__/ingest/transcribe.test.ts +0 -58
  146. package/src/__tests__/ingest/url-ingest.test.ts +0 -48
  147. package/src/__tests__/mcp-resources/repo-context-resource.test.ts +0 -37
  148. package/src/__tests__/mcp-resources/repos-resource.test.ts +0 -71
  149. package/src/__tests__/mcp-resources/wiki-resource.test.ts +0 -52
  150. package/src/__tests__/mcp-tools/explain.test.ts +0 -46
  151. package/src/__tests__/mcp-tools/graph-query.test.ts +0 -45
  152. package/src/__tests__/mcp-tools/group-sync.test.ts +0 -8
  153. package/src/__tests__/mcp-tools/impact-filtering.test.ts +0 -48
  154. package/src/__tests__/mcp-tools/impact.risk.test.ts +0 -24
  155. package/src/__tests__/mcp-tools/list-repos.test.ts +0 -24
  156. package/src/__tests__/mcp-tools/neighbors.test.ts +0 -48
  157. package/src/__tests__/mcp-tools/query.test.ts +0 -42
  158. package/src/__tests__/parsers/language-parsers.test.ts +0 -52
  159. package/src/__tests__/parsers/named-bindings.test.ts +0 -73
  160. package/src/__tests__/pipeline/cluster-only.test.ts +0 -33
  161. package/src/__tests__/pipeline/phases/bridge-adapters/electron-ipc.test.ts +0 -87
  162. package/src/__tests__/pipeline/phases/bridge-adapters/tauri.test.ts +0 -116
  163. package/src/__tests__/pipeline/phases/bridge-adapters/wails.test.ts +0 -81
  164. package/src/__tests__/pipeline/phases/bridge-resolver.test.ts +0 -110
  165. package/src/__tests__/pipeline/phases/communities.cohesion.test.ts +0 -43
  166. package/src/__tests__/pipeline/phases/community-split.test.ts +0 -30
  167. package/src/__tests__/pipeline/phases/framework-detect.test.ts +0 -65
  168. package/src/__tests__/pipeline/phases/import-resolver.test.ts +0 -64
  169. package/src/__tests__/pipeline/phases/parse-arrow.test.ts +0 -33
  170. package/src/__tests__/pipeline/phases/parse-csharp.test.ts +0 -33
  171. package/src/__tests__/pipeline/phases/scan.monographignore.test.ts +0 -53
  172. package/src/__tests__/pipeline/phases/scan.negation.test.ts +0 -40
  173. package/src/__tests__/pipeline/phases/scope-resolution.go.test.ts +0 -34
  174. package/src/__tests__/pipeline/phases/scope-resolution.java.test.ts +0 -30
  175. package/src/__tests__/pipeline/phases/scope-resolution.rust.test.ts +0 -31
  176. package/src/__tests__/pipeline/phases/suggest-questions.test.ts +0 -46
  177. package/src/__tests__/pipeline/phases/surprises-scoring.test.ts +0 -46
  178. package/src/__tests__/pipeline/phases/variables-phase.test.ts +0 -78
  179. package/src/__tests__/pipeline/phases/wildcard-phase.test.ts +0 -99
  180. package/src/__tests__/pipeline/runner.parallel.test.ts +0 -78
  181. package/src/__tests__/reporting/graph-report-confidence.test.ts +0 -43
  182. package/src/__tests__/reporting/graph-report-gaps.test.ts +0 -41
  183. package/src/__tests__/scope-resolution/call-sites.test.ts +0 -89
  184. package/src/__tests__/scope-resolution/evidence-weights.test.ts +0 -49
  185. package/src/__tests__/search/diacritic.test.ts +0 -23
  186. package/src/__tests__/security/safe-fetch.test.ts +0 -125
  187. package/src/__tests__/skills/platform-skills.extra.test.ts +0 -36
  188. package/src/__tests__/web/api.clusters.test.ts +0 -65
  189. package/src/__tests__/web/api.file.test.ts +0 -44
  190. package/src/__tests__/web/api.grep.test.ts +0 -47
  191. package/src/__tests__/web/api.info.test.ts +0 -18
  192. package/src/__tests__/web/api.jobs.test.ts +0 -47
  193. package/src/__tests__/web/api.progress.test.ts +0 -25
  194. package/src/__tests__/web/api.stream.test.ts +0 -35
  195. package/src/__tests__/wiki/providers-reasoning.test.ts +0 -46
  196. package/src/__tests__/wiki/wiki-review-mode.test.ts +0 -22
  197. package/src/analysis/benchmark.ts +0 -132
  198. package/src/analysis/changed-files.ts +0 -73
  199. package/src/analysis/changed-workspaces.ts +0 -94
  200. package/src/analysis/churn-cache.ts +0 -179
  201. package/src/analysis/churn-trend.ts +0 -57
  202. package/src/analysis/churn.ts +0 -263
  203. package/src/analysis/cluster-quality.ts +0 -142
  204. package/src/analysis/combined.ts +0 -41
  205. package/src/analysis/corpus-health.ts +0 -41
  206. package/src/analysis/coverage-gaps.ts +0 -246
  207. package/src/analysis/dep-classification.ts +0 -167
  208. package/src/analysis/dependency-health.ts +0 -146
  209. package/src/analysis/duplicate-exports.ts +0 -110
  210. package/src/analysis/fallow-suppression.ts +0 -98
  211. package/src/analysis/feature-flags-config.ts +0 -47
  212. package/src/analysis/feature-flags.ts +0 -223
  213. package/src/analysis/file-classifier.ts +0 -87
  214. package/src/analysis/git-changed-files.ts +0 -62
  215. package/src/analysis/health-baseline.ts +0 -80
  216. package/src/analysis/issue-filters.ts +0 -56
  217. package/src/analysis/list.ts +0 -74
  218. package/src/analysis/node-similarity.ts +0 -115
  219. package/src/analysis/private-type-leaks.ts +0 -119
  220. package/src/analysis/progress.ts +0 -43
  221. package/src/analysis/project-state.ts +0 -95
  222. package/src/analysis/regression-config.ts +0 -36
  223. package/src/analysis/rule-overrides.ts +0 -81
  224. package/src/analysis/scripts.ts +0 -95
  225. package/src/analysis/shape-extractor.ts +0 -202
  226. package/src/analysis/since-duration.ts +0 -42
  227. package/src/analysis/suppression-context.ts +0 -95
  228. package/src/analysis/suppressions.ts +0 -80
  229. package/src/analysis/surprise-scorer.ts +0 -74
  230. package/src/analysis/targets.ts +0 -237
  231. package/src/analysis/unused-class-members.ts +0 -79
  232. package/src/analysis/workspace-filter.ts +0 -89
  233. package/src/analyze/boundary-analysis.ts +0 -129
  234. package/src/analyze/predicates/file.ts +0 -86
  235. package/src/analyze/predicates/import.ts +0 -90
  236. package/src/analyze/predicates/lifecycle.ts +0 -55
  237. package/src/analyze/unused-deps.ts +0 -70
  238. package/src/analyze/unused-exports.ts +0 -145
  239. package/src/analyze/unused-files.ts +0 -46
  240. package/src/api/production-override.ts +0 -63
  241. package/src/api/programmatic.ts +0 -118
  242. package/src/audit.ts +0 -234
  243. package/src/cache/augment-cache.ts +0 -63
  244. package/src/cache/extraction-cache.ts +0 -141
  245. package/src/check/filtering.ts +0 -78
  246. package/src/check/index.ts +0 -99
  247. package/src/check/output.ts +0 -79
  248. package/src/check/rules.ts +0 -61
  249. package/src/ci-template.ts +0 -84
  250. package/src/claude-cli.ts +0 -59
  251. package/src/cli/ai-context.ts +0 -193
  252. package/src/cli/augment.ts +0 -114
  253. package/src/cli/check-update.ts +0 -40
  254. package/src/cli/doctor.ts +0 -182
  255. package/src/cli/eval-server.ts +0 -126
  256. package/src/cli/hooks-install.ts +0 -202
  257. package/src/cli/setup.ts +0 -197
  258. package/src/cli/skill-gen.ts +0 -347
  259. package/src/commands/flags.ts +0 -72
  260. package/src/config/boundary-config.ts +0 -183
  261. package/src/config/cli-schema.ts +0 -81
  262. package/src/config/config-parsing.ts +0 -102
  263. package/src/config/duplicates-config.ts +0 -62
  264. package/src/config/external-plugin.ts +0 -77
  265. package/src/config/health-config.ts +0 -42
  266. package/src/config/ignore-exports-used-in-file.ts +0 -46
  267. package/src/config/migration-types.ts +0 -73
  268. package/src/config/output-format.ts +0 -24
  269. package/src/config/plugins/builtin.ts +0 -411
  270. package/src/config/plugins/registry.ts +0 -77
  271. package/src/config/plugins/types.ts +0 -14
  272. package/src/config/resolution.ts +0 -102
  273. package/src/config/rules.ts +0 -70
  274. package/src/config/schema-gen.ts +0 -115
  275. package/src/config/types.ts +0 -149
  276. package/src/config/used-class-members.ts +0 -53
  277. package/src/config/validate.ts +0 -108
  278. package/src/config/workspace.ts +0 -137
  279. package/src/coverage/cloud-client.ts +0 -111
  280. package/src/coverage/upload-inventory.ts +0 -84
  281. package/src/coverage/upload-source-maps.ts +0 -97
  282. package/src/discover/entry-points.ts +0 -51
  283. package/src/discover/infrastructure-entries.ts +0 -175
  284. package/src/duplicates/detect/concatenation.ts +0 -37
  285. package/src/duplicates/detect/extraction.ts +0 -107
  286. package/src/duplicates/detect/filtering.ts +0 -112
  287. package/src/duplicates/detect/lcp.ts +0 -27
  288. package/src/duplicates/detect/ranking.ts +0 -16
  289. package/src/duplicates/detect/statistics.ts +0 -69
  290. package/src/duplicates/detect/suffix-array.ts +0 -88
  291. package/src/duplicates/families.ts +0 -95
  292. package/src/duplicates/normalize.ts +0 -58
  293. package/src/duplicates/shingle-filter.ts +0 -37
  294. package/src/duplicates/token-types.ts +0 -62
  295. package/src/duplicates/tokenize/index.ts +0 -104
  296. package/src/error/fallow-error.ts +0 -94
  297. package/src/error.ts +0 -47
  298. package/src/export/adjacency-matrix.ts +0 -127
  299. package/src/export/analysis-json.ts +0 -87
  300. package/src/export/badge.ts +0 -105
  301. package/src/export/canvas.ts +0 -42
  302. package/src/export/codeclimate.ts +0 -201
  303. package/src/export/compact-health.ts +0 -119
  304. package/src/export/compact.ts +0 -83
  305. package/src/export/csv.ts +0 -33
  306. package/src/export/cypher.ts +0 -33
  307. package/src/export/dot.ts +0 -52
  308. package/src/export/gexf.ts +0 -59
  309. package/src/export/graphml.ts +0 -50
  310. package/src/export/html.ts +0 -548
  311. package/src/export/index.ts +0 -9
  312. package/src/export/json.ts +0 -36
  313. package/src/export/markdown.ts +0 -290
  314. package/src/export/mermaid.ts +0 -100
  315. package/src/export/obsidian.ts +0 -44
  316. package/src/export/sarif.ts +0 -245
  317. package/src/export/svg.ts +0 -68
  318. package/src/fix/deps.ts +0 -70
  319. package/src/fix/enum-members.ts +0 -103
  320. package/src/fix/export-surgery.ts +0 -197
  321. package/src/fix/exports.ts +0 -93
  322. package/src/fix/orchestrator.ts +0 -67
  323. package/src/graph/analyzer.ts +0 -69
  324. package/src/graph/author-analytics.ts +0 -217
  325. package/src/graph/baseline.ts +0 -432
  326. package/src/graph/clone-families.ts +0 -132
  327. package/src/graph/codeowners-extended.ts +0 -114
  328. package/src/graph/codeowners-gitlab.ts +0 -150
  329. package/src/graph/codeowners.ts +0 -217
  330. package/src/graph/complexity.ts +0 -200
  331. package/src/graph/cross-reference-findings.ts +0 -85
  332. package/src/graph/cross-reference.ts +0 -139
  333. package/src/graph/cycle-detection.ts +0 -311
  334. package/src/graph/cycles.ts +0 -222
  335. package/src/graph/dead-code.ts +0 -128
  336. package/src/graph/dependency-closure.ts +0 -126
  337. package/src/graph/dfs.ts +0 -118
  338. package/src/graph/diff.ts +0 -92
  339. package/src/graph/duplication-stats.ts +0 -79
  340. package/src/graph/edge-filter.ts +0 -117
  341. package/src/graph/explain.ts +0 -133
  342. package/src/graph/external-style-usage.ts +0 -81
  343. package/src/graph/health-score.ts +0 -179
  344. package/src/graph/hotspots.ts +0 -219
  345. package/src/graph/import-chain.ts +0 -148
  346. package/src/graph/loader.ts +0 -44
  347. package/src/graph/maintainability.ts +0 -156
  348. package/src/graph/merge.ts +0 -174
  349. package/src/graph/mirrored-dirs.ts +0 -202
  350. package/src/graph/narrowing.ts +0 -92
  351. package/src/graph/node-search.ts +0 -201
  352. package/src/graph/node-types.ts +0 -67
  353. package/src/graph/normalize-id.ts +0 -138
  354. package/src/graph/pagerank.ts +0 -165
  355. package/src/graph/prune.ts +0 -95
  356. package/src/graph/re-exports/propagate.ts +0 -95
  357. package/src/graph/reachability.ts +0 -99
  358. package/src/graph/regex-search.ts +0 -232
  359. package/src/graph/regression.ts +0 -199
  360. package/src/graph/resolve/discover-types.ts +0 -45
  361. package/src/graph/resolve/dynamic-imports.ts +0 -102
  362. package/src/graph/resolve/fallbacks.ts +0 -79
  363. package/src/graph/resolve/index.ts +0 -68
  364. package/src/graph/resolve/path-info.ts +0 -41
  365. package/src/graph/resolve/re-exports.ts +0 -14
  366. package/src/graph/resolve/react-native.ts +0 -27
  367. package/src/graph/resolve/require-imports.ts +0 -18
  368. package/src/graph/resolve/specifier.ts +0 -120
  369. package/src/graph/resolve/static-imports.ts +0 -14
  370. package/src/graph/resolve/types.ts +0 -108
  371. package/src/graph/resolve/upgrades.ts +0 -32
  372. package/src/graph/ripple-impact.ts +0 -131
  373. package/src/graph/risk-profile.ts +0 -179
  374. package/src/graph/statistics.ts +0 -165
  375. package/src/graph/stats.ts +0 -157
  376. package/src/graph/subgraph.ts +0 -162
  377. package/src/graph/topo-sort.ts +0 -171
  378. package/src/graph/wcc.ts +0 -187
  379. package/src/groups/contract-bridge.ts +0 -103
  380. package/src/groups/contract-registry.ts +0 -263
  381. package/src/groups/group-config.ts +0 -108
  382. package/src/groups/group-search.ts +0 -139
  383. package/src/groups/group-sync.ts +0 -82
  384. package/src/groups/grpc-extractor.ts +0 -64
  385. package/src/groups/service-boundary.ts +0 -119
  386. package/src/groups/topic-extractor.ts +0 -90
  387. package/src/health/analysis-counts-snapshot.ts +0 -57
  388. package/src/health/analysis-counts.ts +0 -70
  389. package/src/health/complexity-findings.ts +0 -115
  390. package/src/health/distribution-thresholds.ts +0 -54
  391. package/src/health/grouping.ts +0 -138
  392. package/src/health/health-grouping.ts +0 -86
  393. package/src/health/health-report-types.ts +0 -165
  394. package/src/health/health-report.ts +0 -81
  395. package/src/health/health-score.ts +0 -65
  396. package/src/health/hotspot-utils.ts +0 -55
  397. package/src/health/hotspots.ts +0 -104
  398. package/src/health/large-functions.ts +0 -34
  399. package/src/health/ownership-metrics.ts +0 -61
  400. package/src/health/ownership-risk.ts +0 -98
  401. package/src/health/ownership.ts +0 -174
  402. package/src/health/quality-gate.ts +0 -57
  403. package/src/health/risk-profile.ts +0 -39
  404. package/src/health/runtime-coverage-report.ts +0 -101
  405. package/src/health/runtime-coverage.ts +0 -71
  406. package/src/health/scores.ts +0 -72
  407. package/src/health/scoring-types.ts +0 -48
  408. package/src/health/target-thresholds.ts +0 -92
  409. package/src/health/target-types.ts +0 -54
  410. package/src/health/targets.ts +0 -151
  411. package/src/health/timings.ts +0 -86
  412. package/src/health/trend-types.ts +0 -57
  413. package/src/health/trends.ts +0 -86
  414. package/src/health/vital-signs-compute.ts +0 -108
  415. package/src/health/vital-signs-snapshot.ts +0 -72
  416. package/src/health/vital-signs.ts +0 -101
  417. package/src/index.ts +0 -111
  418. package/src/ingest/git-clone.ts +0 -246
  419. package/src/ingest/query-memory.ts +0 -132
  420. package/src/ingest/transcribe.ts +0 -254
  421. package/src/ingest/url-ingest.ts +0 -87
  422. package/src/init/agent-hooks.ts +0 -86
  423. package/src/init/git-hooks.ts +0 -71
  424. package/src/init/project-detection.ts +0 -105
  425. package/src/license/manager.ts +0 -120
  426. package/src/lsp/code-actions.ts +0 -127
  427. package/src/lsp/code-lens.ts +0 -56
  428. package/src/lsp/diagnostics-ext.ts +0 -150
  429. package/src/lsp/diagnostics-push.ts +0 -103
  430. package/src/lsp/diagnostics.ts +0 -98
  431. package/src/lsp/hover.ts +0 -64
  432. package/src/lsp/server.ts +0 -254
  433. package/src/mcp/params.ts +0 -201
  434. package/src/mcp/resources.ts +0 -124
  435. package/src/mcp/tool-builders.ts +0 -203
  436. package/src/mcp-resources/communities-resource.ts +0 -72
  437. package/src/mcp-resources/graph-resource.ts +0 -14
  438. package/src/mcp-resources/index.ts +0 -9
  439. package/src/mcp-resources/named-cluster-resource.ts +0 -35
  440. package/src/mcp-resources/named-process-resource.ts +0 -26
  441. package/src/mcp-resources/processes-resource.ts +0 -67
  442. package/src/mcp-resources/repo-context-resource.ts +0 -36
  443. package/src/mcp-resources/repos-resource.ts +0 -21
  444. package/src/mcp-resources/schema-resource.ts +0 -46
  445. package/src/mcp-resources/wiki-resource.ts +0 -23
  446. package/src/mcp-tools/api-impact.ts +0 -181
  447. package/src/mcp-tools/context.ts +0 -111
  448. package/src/mcp-tools/cypher.ts +0 -29
  449. package/src/mcp-tools/detect-changes.ts +0 -116
  450. package/src/mcp-tools/explain.ts +0 -65
  451. package/src/mcp-tools/graph-query.ts +0 -128
  452. package/src/mcp-tools/group-list.ts +0 -88
  453. package/src/mcp-tools/group-query.ts +0 -26
  454. package/src/mcp-tools/group-sync.ts +0 -32
  455. package/src/mcp-tools/impact.ts +0 -202
  456. package/src/mcp-tools/index.ts +0 -21
  457. package/src/mcp-tools/list-repos.ts +0 -38
  458. package/src/mcp-tools/neighbors.ts +0 -80
  459. package/src/mcp-tools/query.ts +0 -86
  460. package/src/mcp-tools/rename.ts +0 -118
  461. package/src/mcp-tools/route-map.ts +0 -98
  462. package/src/mcp-tools/serve.ts +0 -41
  463. package/src/mcp-tools/shape-check.ts +0 -182
  464. package/src/mcp-tools/staleness.ts +0 -13
  465. package/src/mcp-tools/tool-map.ts +0 -66
  466. package/src/mcp-tools/wiki-build.ts +0 -37
  467. package/src/mcp-tools/wiki.ts +0 -28
  468. package/src/migrate/jscpd.ts +0 -78
  469. package/src/migrate/jsonc-gen.ts +0 -38
  470. package/src/migrate/knip.ts +0 -126
  471. package/src/migrate/toml-gen.ts +0 -48
  472. package/src/parsers/c.ts +0 -31
  473. package/src/parsers/cpp.ts +0 -29
  474. package/src/parsers/csharp.ts +0 -43
  475. package/src/parsers/dart.ts +0 -39
  476. package/src/parsers/extractor.ts +0 -202
  477. package/src/parsers/go.ts +0 -27
  478. package/src/parsers/java.ts +0 -27
  479. package/src/parsers/kotlin.ts +0 -36
  480. package/src/parsers/language-config.ts +0 -28
  481. package/src/parsers/language-parsers.ts +0 -120
  482. package/src/parsers/loader.ts +0 -149
  483. package/src/parsers/named-bindings.ts +0 -63
  484. package/src/parsers/php.ts +0 -37
  485. package/src/parsers/python.ts +0 -26
  486. package/src/parsers/ruby.ts +0 -39
  487. package/src/parsers/rust.ts +0 -25
  488. package/src/parsers/swift.ts +0 -28
  489. package/src/parsers/typescript.ts +0 -41
  490. package/src/parsers/vue.ts +0 -79
  491. package/src/pipeline/cluster-only.ts +0 -64
  492. package/src/pipeline/effort.ts +0 -50
  493. package/src/pipeline/orchestrator.ts +0 -384
  494. package/src/pipeline/phases/boundary.ts +0 -151
  495. package/src/pipeline/phases/bridge-adapters/electron-ipc.ts +0 -91
  496. package/src/pipeline/phases/bridge-adapters/registry.ts +0 -14
  497. package/src/pipeline/phases/bridge-adapters/tauri.ts +0 -103
  498. package/src/pipeline/phases/bridge-adapters/types.ts +0 -31
  499. package/src/pipeline/phases/bridge-adapters/wails.ts +0 -33
  500. package/src/pipeline/phases/bridge-resolver.ts +0 -77
  501. package/src/pipeline/phases/call-site-extractors.ts +0 -177
  502. package/src/pipeline/phases/communities.ts +0 -183
  503. package/src/pipeline/phases/contextual-proximity.ts +0 -88
  504. package/src/pipeline/phases/cross-file.ts +0 -116
  505. package/src/pipeline/phases/docs-parse.ts +0 -307
  506. package/src/pipeline/phases/evidence.ts +0 -9
  507. package/src/pipeline/phases/field-access.ts +0 -49
  508. package/src/pipeline/phases/framework-detect.ts +0 -109
  509. package/src/pipeline/phases/god-nodes.ts +0 -163
  510. package/src/pipeline/phases/import-resolver.ts +0 -114
  511. package/src/pipeline/phases/leiden.ts +0 -77
  512. package/src/pipeline/phases/llm-extract.ts +0 -178
  513. package/src/pipeline/phases/markdown.ts +0 -121
  514. package/src/pipeline/phases/middleware-extractor.ts +0 -127
  515. package/src/pipeline/phases/module-resolution.ts +0 -294
  516. package/src/pipeline/phases/mro.ts +0 -56
  517. package/src/pipeline/phases/orm.ts +0 -503
  518. package/src/pipeline/phases/parse.ts +0 -222
  519. package/src/pipeline/phases/pdf-parse.ts +0 -133
  520. package/src/pipeline/phases/processes.ts +0 -249
  521. package/src/pipeline/phases/re-export-propagation.ts +0 -160
  522. package/src/pipeline/phases/reachability.ts +0 -156
  523. package/src/pipeline/phases/routes.ts +0 -350
  524. package/src/pipeline/phases/scan.ts +0 -133
  525. package/src/pipeline/phases/scope-resolution.ts +0 -442
  526. package/src/pipeline/phases/structure.ts +0 -68
  527. package/src/pipeline/phases/suggest.ts +0 -92
  528. package/src/pipeline/phases/surprises.ts +0 -83
  529. package/src/pipeline/phases/tools.ts +0 -180
  530. package/src/pipeline/phases/variables-phase.ts +0 -37
  531. package/src/pipeline/phases/variables.ts +0 -67
  532. package/src/pipeline/phases/wildcard-phase.ts +0 -50
  533. package/src/pipeline/phases/wildcard-synthesis.ts +0 -214
  534. package/src/pipeline/progress.ts +0 -58
  535. package/src/pipeline/runner.ts +0 -88
  536. package/src/pipeline/types.ts +0 -41
  537. package/src/query/cypher-parser.ts +0 -450
  538. package/src/registry/repo-registry.ts +0 -125
  539. package/src/regression/baseline-deltas.ts +0 -215
  540. package/src/regression/baseline.ts +0 -76
  541. package/src/regression/counts.ts +0 -87
  542. package/src/regression/outcome.ts +0 -78
  543. package/src/regression/tolerance.ts +0 -35
  544. package/src/report/attributed-duplication.ts +0 -112
  545. package/src/report/badge-svg.ts +0 -100
  546. package/src/report/cross-ref-human.ts +0 -50
  547. package/src/report/duplication-grouping.ts +0 -74
  548. package/src/report/grouping.ts +0 -137
  549. package/src/report/human-check.ts +0 -291
  550. package/src/report/human-dupes.ts +0 -142
  551. package/src/report/human-health.ts +0 -195
  552. package/src/report/human.ts +0 -120
  553. package/src/report/json-actions.ts +0 -91
  554. package/src/report/json-builders.ts +0 -70
  555. package/src/report/json-schema.ts +0 -75
  556. package/src/report/number-format.ts +0 -91
  557. package/src/report/output-grouped.ts +0 -102
  558. package/src/report/pipeline-perf.ts +0 -56
  559. package/src/report/trace-human.ts +0 -127
  560. package/src/reporting/graph-report.ts +0 -431
  561. package/src/results/fallow-results.ts +0 -152
  562. package/src/results/types.ts +0 -149
  563. package/src/scope-resolution/evidence-weights.ts +0 -41
  564. package/src/search/ast-chunker.ts +0 -206
  565. package/src/search/diacritic.ts +0 -7
  566. package/src/search/hybrid-query.ts +0 -65
  567. package/src/search/rrf.ts +0 -51
  568. package/src/security/safe-fetch.ts +0 -113
  569. package/src/security/sensitive-files.ts +0 -24
  570. package/src/skills/platform-skills.ts +0 -233
  571. package/src/staleness/git-staleness.ts +0 -66
  572. package/src/storage/db.ts +0 -110
  573. package/src/storage/edge-store.ts +0 -103
  574. package/src/storage/file-cache.ts +0 -78
  575. package/src/storage/fts-store.ts +0 -385
  576. package/src/storage/node-store.ts +0 -209
  577. package/src/storage/schema.ts +0 -171
  578. package/src/storage/suppressions.ts +0 -145
  579. package/src/storage/unlinked-refs.ts +0 -117
  580. package/src/types.ts +0 -197
  581. package/src/validation/extraction-validator.ts +0 -54
  582. package/src/watch/watcher.ts +0 -160
  583. package/src/web/analyze-api.ts +0 -146
  584. package/src/web/api.ts +0 -584
  585. package/src/web/async-jobs.ts +0 -109
  586. package/src/web/mcp-http.ts +0 -227
  587. package/src/web/react-ui.ts +0 -78
  588. package/src/web/server.ts +0 -90
  589. package/src/web/ui/index.html +0 -204
  590. package/src/wiki/gist-publisher.ts +0 -76
  591. package/src/wiki/prompt-builder.ts +0 -35
  592. package/src/wiki/providers.ts +0 -134
  593. package/src/wiki/wiki-generator.ts +0 -223
  594. package/src/wiki/wiki-store.ts +0 -49
  595. package/tsconfig.json +0 -11
  596. 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
- }