@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,290 +0,0 @@
1
- import { relative } from 'path';
2
- import type { MonographDb } from '../storage/db.js';
3
-
4
- export interface MarkdownReportOptions {
5
- groupByOwner?: boolean;
6
- repoRoot?: string;
7
- title?: string;
8
- }
9
-
10
- function relPath(filePath: string, repoRoot?: string): string {
11
- if (!repoRoot) return filePath;
12
- return relative(repoRoot, filePath);
13
- }
14
-
15
- function backtick(p: string): string {
16
- return `\`${p}\``;
17
- }
18
-
19
- interface FileRow {
20
- name: string;
21
- file_path: string;
22
- owner?: string | null;
23
- line?: number;
24
- in_degree?: number;
25
- }
26
-
27
- interface DupeRow {
28
- src_path: string;
29
- target_path: string;
30
- owner?: string | null;
31
- }
32
-
33
- interface ViolationRow {
34
- file_path: string;
35
- line: number;
36
- rule: string;
37
- owner?: string | null;
38
- }
39
-
40
- function getOwner(row: { owner?: string | null }): string {
41
- return row.owner?.trim() || 'Unowned';
42
- }
43
-
44
- function groupBy<T>(items: T[], keyFn: (item: T) => string): Map<string, T[]> {
45
- const map = new Map<string, T[]>();
46
- for (const item of items) {
47
- const k = keyFn(item);
48
- if (!map.has(k)) map.set(k, []);
49
- map.get(k)!.push(item);
50
- }
51
- return map;
52
- }
53
-
54
- /**
55
- * Generate a human-readable Markdown report from the monograph graph DB.
56
- */
57
- export function exportMarkdown(db: MonographDb, options?: MarkdownReportOptions): string {
58
- const { groupByOwner = false, repoRoot, title = 'Monograph Report' } = options ?? {};
59
- const sections: string[] = [];
60
-
61
- sections.push(`## ${title}`);
62
- sections.push('');
63
-
64
- // ── Health Score ───────────────────────────────────────────────────────────
65
- const healthRow = db.prepare(`
66
- SELECT json_extract(properties, '$.healthScore') AS score,
67
- json_extract(properties, '$.healthGrade') AS grade
68
- FROM nodes
69
- WHERE json_extract(properties, '$.healthScore') IS NOT NULL
70
- LIMIT 1
71
- `).get() as { score: number; grade: string } | undefined;
72
-
73
- if (healthRow) {
74
- sections.push('### Health Score');
75
- sections.push('');
76
- const gradeStr = healthRow.grade ? ` (Grade: **${healthRow.grade}**)` : '';
77
- sections.push(`Score: **${healthRow.score}**${gradeStr}`);
78
- sections.push('');
79
- }
80
-
81
- // ── Unreachable files ──────────────────────────────────────────────────────
82
- const unreachable = db.prepare(`
83
- SELECT name, file_path,
84
- json_extract(properties, '$.owner') AS owner
85
- FROM nodes
86
- WHERE label = 'File'
87
- AND (
88
- json_extract(properties, '$.reachabilityRole') = 'unreachable'
89
- OR properties LIKE '%"unreachable"%'
90
- )
91
- AND file_path IS NOT NULL
92
- ORDER BY file_path
93
- `).all() as FileRow[];
94
-
95
- if (unreachable.length > 0) {
96
- if (groupByOwner) {
97
- const byOwner = groupBy(unreachable, getOwner);
98
- for (const [owner, rows] of byOwner) {
99
- sections.push(`### Unreachable Files — ${owner} (${rows.length})`);
100
- sections.push('');
101
- for (const row of rows) {
102
- sections.push(`- ${backtick(relPath(row.file_path, repoRoot))}`);
103
- }
104
- sections.push('');
105
- }
106
- } else {
107
- sections.push(`### Unreachable Files (${unreachable.length})`);
108
- sections.push('');
109
- for (const row of unreachable) {
110
- sections.push(`- ${backtick(relPath(row.file_path, repoRoot))}`);
111
- }
112
- sections.push('');
113
- }
114
- }
115
-
116
- // ── God nodes ──────────────────────────────────────────────────────────────
117
- const totalNodes = (db.prepare(`SELECT COUNT(*) as c FROM nodes WHERE label = 'File'`).get() as { c: number }).c;
118
- const top10pct = Math.max(1, Math.floor(totalNodes * 0.1));
119
- const godNodes = db.prepare(`
120
- SELECT n.name, n.file_path,
121
- COALESCE(n.start_line, 1) AS line,
122
- json_extract(n.properties, '$.owner') AS owner,
123
- COUNT(e.id) AS in_degree
124
- FROM nodes n
125
- LEFT JOIN edges e ON e.target_id = n.id
126
- WHERE n.file_path IS NOT NULL AND n.label = 'File'
127
- GROUP BY n.id
128
- ORDER BY in_degree DESC
129
- LIMIT ?
130
- `).all(top10pct) as FileRow[];
131
-
132
- const filteredGodNodes = godNodes.filter(r => (r.in_degree ?? 0) > 0);
133
- if (filteredGodNodes.length > 0) {
134
- if (groupByOwner) {
135
- const byOwner = groupBy(filteredGodNodes, getOwner);
136
- for (const [owner, rows] of byOwner) {
137
- sections.push(`### God Nodes — ${owner} (${rows.length})`);
138
- sections.push('');
139
- sections.push('| File | Fan-in |');
140
- sections.push('|------|--------|');
141
- for (const row of rows) {
142
- sections.push(`| ${backtick(relPath(row.file_path, repoRoot))} | ${row.in_degree} |`);
143
- }
144
- sections.push('');
145
- }
146
- } else {
147
- sections.push(`### God Nodes (${filteredGodNodes.length})`);
148
- sections.push('');
149
- sections.push('| File | Fan-in |');
150
- sections.push('|------|--------|');
151
- for (const row of filteredGodNodes) {
152
- sections.push(`| ${backtick(relPath(row.file_path, repoRoot))} | ${row.in_degree} |`);
153
- }
154
- sections.push('');
155
- }
156
- }
157
-
158
- // ── Duplicate files ────────────────────────────────────────────────────────
159
- const dupes = db.prepare(`
160
- SELECT n1.file_path AS src_path,
161
- n2.file_path AS target_path,
162
- json_extract(n1.properties, '$.owner') AS owner
163
- FROM edges e
164
- JOIN nodes n1 ON n1.id = e.source_id
165
- JOIN nodes n2 ON n2.id = e.target_id
166
- WHERE e.relation = 'STRUCTURALLY_SIMILAR'
167
- AND n1.file_path IS NOT NULL AND n2.file_path IS NOT NULL
168
- ORDER BY n1.file_path
169
- `).all() as DupeRow[];
170
-
171
- if (dupes.length > 0) {
172
- if (groupByOwner) {
173
- const byOwner = groupBy(dupes, getOwner);
174
- for (const [owner, rows] of byOwner) {
175
- sections.push(`### Duplicate Files — ${owner} (${rows.length})`);
176
- sections.push('');
177
- for (const row of rows) {
178
- sections.push(`- ${backtick(relPath(row.src_path, repoRoot))} ↔ ${backtick(relPath(row.target_path, repoRoot))}`);
179
- }
180
- sections.push('');
181
- }
182
- } else {
183
- sections.push(`### Duplicate Files (${dupes.length})`);
184
- sections.push('');
185
- for (const row of dupes) {
186
- sections.push(`- ${backtick(relPath(row.src_path, repoRoot))} ↔ ${backtick(relPath(row.target_path, repoRoot))}`);
187
- }
188
- sections.push('');
189
- }
190
- }
191
-
192
- // ── Boundary violations ───────────────────────────────────────────────────
193
- const violations = db.prepare(`
194
- SELECT file_path, COALESCE(start_line, 1) AS line,
195
- json_extract(properties, '$.boundaryViolation') AS rule,
196
- json_extract(properties, '$.owner') AS owner
197
- FROM nodes
198
- WHERE file_path IS NOT NULL
199
- AND json_extract(properties, '$.boundaryViolation') IS NOT NULL
200
- ORDER BY file_path
201
- `).all() as ViolationRow[];
202
-
203
- if (violations.length > 0) {
204
- if (groupByOwner) {
205
- const byOwner = groupBy(violations, getOwner);
206
- for (const [owner, rows] of byOwner) {
207
- sections.push(`### Boundary Violations — ${owner} (${rows.length})`);
208
- sections.push('');
209
- for (const row of rows) {
210
- sections.push(`- ${backtick(relPath(row.file_path, repoRoot))}:${row.line} — ${row.rule}`);
211
- }
212
- sections.push('');
213
- }
214
- } else {
215
- sections.push(`### Boundary Violations (${violations.length})`);
216
- sections.push('');
217
- for (const row of violations) {
218
- sections.push(`- ${backtick(relPath(row.file_path, repoRoot))}:${row.line} — ${row.rule}`);
219
- }
220
- sections.push('');
221
- }
222
- }
223
-
224
- // ── Suggestions (top 3 from DB if available) ──────────────────────────────
225
- let suggestionRows: { suggestion: string }[] = [];
226
- try {
227
- suggestionRows = db.prepare(`
228
- SELECT json_extract(properties, '$.suggestion') AS suggestion
229
- FROM nodes
230
- WHERE json_extract(properties, '$.suggestion') IS NOT NULL
231
- LIMIT 3
232
- `).all() as { suggestion: string }[];
233
- } catch {
234
- // table or column not present — skip
235
- }
236
-
237
- if (suggestionRows.length > 0) {
238
- sections.push('### Suggestions');
239
- sections.push('');
240
- for (const row of suggestionRows) {
241
- sections.push(`- ${row.suggestion}`);
242
- }
243
- sections.push('');
244
- }
245
-
246
- return sections.join('\n');
247
- }
248
-
249
- // ── Round 10: health + duplication Markdown exports ───────────────────────────
250
-
251
- export interface MarkdownHealthFinding {
252
- filePath: string;
253
- functionName: string;
254
- startLine: number;
255
- cyclomatic: number;
256
- cognitive: number;
257
- crapScore: number;
258
- severity: string;
259
- }
260
-
261
- export interface MarkdownDuplicationGroup {
262
- groupId: number;
263
- instances: Array<{ filePath: string; startLine: number; endLine: number }>;
264
- duplicatedLines: number;
265
- }
266
-
267
- export function exportHealthMarkdown(findings: MarkdownHealthFinding[], title = 'Health Report'): string {
268
- const lines = [`# ${title}`, '', `Found ${findings.length} complex function(s).`, ''];
269
- if (findings.length === 0) return lines.join('\n');
270
- lines.push('| File | Function | Line | Cyclomatic | Cognitive | CRAP | Severity |');
271
- lines.push('|------|----------|------|------------|-----------|------|----------|');
272
- for (const f of findings) {
273
- const file = f.filePath.split('/').slice(-2).join('/');
274
- lines.push(`| ${file} | \`${f.functionName}\` | ${f.startLine} | ${f.cyclomatic} | ${f.cognitive} | ${f.crapScore.toFixed(1)} | ${f.severity} |`);
275
- }
276
- return lines.join('\n');
277
- }
278
-
279
- export function exportDuplicationMarkdown(groups: MarkdownDuplicationGroup[], title = 'Duplication Report'): string {
280
- const lines = [`# ${title}`, '', `Found ${groups.length} clone group(s).`, ''];
281
- for (const g of groups) {
282
- lines.push(`## Group ${g.groupId} — ${g.duplicatedLines} lines`);
283
- for (const inst of g.instances) {
284
- const file = inst.filePath.split('/').slice(-2).join('/');
285
- lines.push(`- \`${file}\` lines ${inst.startLine}–${inst.endLine}`);
286
- }
287
- lines.push('');
288
- }
289
- return lines.join('\n');
290
- }
@@ -1,100 +0,0 @@
1
- import type { MonographNode, MonographEdge } from '../types.js';
2
-
3
- const MAX_NODES = 200;
4
-
5
- /**
6
- * Sanitize a string for use as a Mermaid node label (inside quotes).
7
- * Strips characters that break Mermaid syntax.
8
- */
9
- function sanitizeLabel(s: string): string {
10
- return s
11
- .replace(/["<>&{}()[\]|]/g, '')
12
- .substring(0, 40)
13
- .trim();
14
- }
15
-
16
- /**
17
- * Make a Mermaid-safe node id from an arbitrary string.
18
- */
19
- function safeId(id: string): string {
20
- return id.replace(/[^a-zA-Z0-9_]/g, '_');
21
- }
22
-
23
- /**
24
- * Converts a knowledge graph to Mermaid flowchart syntax.
25
- *
26
- * - Nodes are grouped into subgraphs by communityId when present.
27
- * - Edges use `-->` for EXTRACTED confidence and `-.->` for INFERRED/AMBIGUOUS.
28
- * - Edge labels show the relation type.
29
- * - Diagram is capped at 200 nodes to avoid extremely large output.
30
- */
31
- export function toMermaid(nodes: MonographNode[], edges: MonographEdge[]): string {
32
- const capped = nodes.slice(0, MAX_NODES);
33
- const cappedIds = new Set(capped.map(n => n.id));
34
-
35
- const lines: string[] = ['graph TD'];
36
-
37
- // Group by community
38
- const communities = new Map<number | undefined, MonographNode[]>();
39
- for (const n of capped) {
40
- const key = n.communityId;
41
- const group = communities.get(key) ?? [];
42
- group.push(n);
43
- communities.set(key, group);
44
- }
45
-
46
- const hasCommunities = communities.has(undefined)
47
- ? communities.size > 1
48
- : communities.size > 0;
49
-
50
- if (hasCommunities && !communities.has(undefined)) {
51
- // All nodes have communityId — use subgraphs
52
- for (const [communityId, members] of communities) {
53
- lines.push(` subgraph community_${communityId}["Community ${communityId}"]`);
54
- for (const n of members) {
55
- const nid = safeId(n.id);
56
- const label = sanitizeLabel(n.name);
57
- lines.push(` ${nid}["${label}<br/>${n.label}"]`);
58
- }
59
- lines.push(' end');
60
- }
61
- } else if (hasCommunities) {
62
- // Mix of nodes with and without communityId
63
- // Emit subgraphs for communities, then ungrouped
64
- for (const [communityId, members] of communities) {
65
- if (communityId === undefined) continue;
66
- lines.push(` subgraph community_${communityId}["Community ${communityId}"]`);
67
- for (const n of members) {
68
- const nid = safeId(n.id);
69
- const label = sanitizeLabel(n.name);
70
- lines.push(` ${nid}["${label}<br/>${n.label}"]`);
71
- }
72
- lines.push(' end');
73
- }
74
- // ungrouped nodes
75
- for (const n of communities.get(undefined) ?? []) {
76
- const nid = safeId(n.id);
77
- const label = sanitizeLabel(n.name);
78
- lines.push(` ${nid}["${label}<br/>${n.label}"]`);
79
- }
80
- } else {
81
- // No communities — flat layout
82
- for (const n of capped) {
83
- const nid = safeId(n.id);
84
- const label = sanitizeLabel(n.name);
85
- lines.push(` ${nid}["${label}<br/>${n.label}"]`);
86
- }
87
- }
88
-
89
- // Edges — only between nodes in the capped set
90
- for (const e of edges) {
91
- if (!cappedIds.has(e.sourceId) || !cappedIds.has(e.targetId)) continue;
92
- const src = safeId(e.sourceId);
93
- const tgt = safeId(e.targetId);
94
- const arrow = e.confidence === 'EXTRACTED' ? '-->' : '-..->';
95
- const label = sanitizeLabel(e.relation);
96
- lines.push(` ${src} ${arrow}|${label}| ${tgt}`);
97
- }
98
-
99
- return lines.join('\n');
100
- }
@@ -1,44 +0,0 @@
1
- import type { MonographNode, MonographEdge } from '../types.js';
2
- import { join } from 'path';
3
- import { writeFileSync, mkdirSync } from 'fs';
4
-
5
- export function toObsidian(nodes: MonographNode[], edges: MonographEdge[], outputDir: string): void {
6
- mkdirSync(outputDir, { recursive: true });
7
-
8
- const adjOut = new Map<string, string[]>();
9
- for (const e of edges) {
10
- const targets = adjOut.get(e.sourceId) ?? [];
11
- targets.push(e.targetId);
12
- adjOut.set(e.sourceId, targets);
13
- }
14
-
15
- const nodeMap = new Map(nodes.map(n => [n.id, n]));
16
-
17
- for (const node of nodes) {
18
- const links = (adjOut.get(node.id) ?? [])
19
- .map(tid => nodeMap.get(tid)?.name)
20
- .filter(Boolean)
21
- .map(name => `- [[${name}]]`)
22
- .join('\n');
23
-
24
- const content = `---
25
- label: ${node.label}
26
- file: ${node.filePath ?? ''}
27
- exported: ${node.isExported}
28
- community: ${node.communityId ?? 'none'}
29
- ---
30
-
31
- # ${node.name}
32
-
33
- **Type:** ${node.label}
34
- **Language:** ${node.language ?? 'unknown'}
35
-
36
- ## Outgoing links
37
-
38
- ${links || '_none_'}
39
- `;
40
-
41
- const filename = node.name.replace(/[<>:"/\\|?*]/g, '_');
42
- writeFileSync(join(outputDir, `${filename}.md`), content);
43
- }
44
- }
@@ -1,245 +0,0 @@
1
- import type Database from 'better-sqlite3';
2
- import { createHash } from 'crypto';
3
- import { readFileSync } from 'fs';
4
- import { relative, dirname, join } from 'path';
5
- import { fileURLToPath } from 'url';
6
-
7
- const __dirname = dirname(fileURLToPath(import.meta.url));
8
- const PKG_VERSION = (() => {
9
- try {
10
- return JSON.parse(readFileSync(join(__dirname, '..', '..', 'package.json'), 'utf8')).version ?? '0.0.0';
11
- } catch { return '0.0.0'; }
12
- })();
13
-
14
- export interface SarifRule {
15
- id: string;
16
- name: string;
17
- shortDescription: { text: string };
18
- fullDescription: { text: string };
19
- helpUri?: string;
20
- }
21
-
22
- export interface SarifResult {
23
- ruleId: string;
24
- level: 'error' | 'warning' | 'note';
25
- message: { text: string };
26
- locations: Array<{
27
- physicalLocation: {
28
- artifactLocation: { uri: string };
29
- region?: { startLine: number };
30
- };
31
- }>;
32
- fingerprints?: { 'monograph/v1': string };
33
- }
34
-
35
- export interface SarifDocument {
36
- $schema: string;
37
- version: '2.1.0';
38
- runs: [{
39
- tool: { driver: { name: string; version: string; rules: SarifRule[] } };
40
- results: SarifResult[];
41
- }];
42
- }
43
-
44
- const SARIF_RULES: SarifRule[] = [
45
- {
46
- id: 'monograph/god-node',
47
- name: 'GodNode',
48
- shortDescription: { text: 'High-centrality node (god node) exceeds fan-in threshold' },
49
- fullDescription: { text: 'A file or module has an unusually high number of incoming dependencies, making it a central point of coupling. Consider splitting this module into smaller, more focused units.' },
50
- helpUri: 'https://github.com/monoes/monomind/blob/main/docs/rules/god-node.md',
51
- },
52
- {
53
- id: 'monograph/unreachable-file',
54
- name: 'UnreachableFile',
55
- shortDescription: { text: 'File node unreachable from any entry point' },
56
- fullDescription: { text: 'A file is not reachable from any known entry point. It may be dead code that can be safely removed.' },
57
- helpUri: 'https://github.com/monoes/monomind/blob/main/docs/rules/unreachable-file.md',
58
- },
59
- {
60
- id: 'monograph/circular-import',
61
- name: 'CircularImport',
62
- shortDescription: { text: 'Circular import detected' },
63
- fullDescription: { text: 'A circular import chain was detected between files. Circular imports can cause initialization order issues and make the codebase harder to understand.' },
64
- helpUri: 'https://github.com/monoes/monomind/blob/main/docs/rules/circular-import.md',
65
- },
66
- {
67
- id: 'monograph/bridge-node',
68
- name: 'BridgeNode',
69
- shortDescription: { text: 'Bridge node — high cross-community coupling' },
70
- fullDescription: { text: 'A file acts as a bridge between multiple community clusters, creating high cross-community coupling. This may indicate architectural boundaries are not being respected.' },
71
- helpUri: 'https://github.com/monoes/monomind/blob/main/docs/rules/bridge-node.md',
72
- },
73
- {
74
- id: 'monograph/hotspot',
75
- name: 'Hotspot',
76
- shortDescription: { text: 'File is both frequently changed and highly connected' },
77
- fullDescription: { text: 'A file is both a churn hotspot (frequently modified) and highly connected in the dependency graph. Changes here have wide blast radius and high risk of regression.' },
78
- helpUri: 'https://github.com/monoes/monomind/blob/main/docs/rules/hotspot.md',
79
- },
80
- ];
81
-
82
- // Map ruleId to SARIF level
83
- const RULE_LEVELS: Record<string, 'error' | 'warning' | 'note'> = {
84
- 'monograph/god-node': 'warning',
85
- 'monograph/unreachable-file': 'note',
86
- 'monograph/circular-import': 'error',
87
- 'monograph/bridge-node': 'warning',
88
- 'monograph/hotspot': 'warning',
89
- };
90
-
91
- function fingerprint(ruleId: string, filePath: string): string {
92
- return createHash('sha256').update(`${ruleId}:${filePath}`).digest('hex');
93
- }
94
-
95
- function toFileUri(repoRoot: string, filePath: string): string {
96
- const rel = relative(repoRoot, filePath);
97
- return `file:///${rel.replace(/\\/g, '/')}`;
98
- }
99
-
100
- function makeResult(
101
- ruleId: string,
102
- message: string,
103
- filePath: string,
104
- startLine: number | null | undefined,
105
- repoRoot: string,
106
- ): SarifResult {
107
- const result: SarifResult = {
108
- ruleId,
109
- level: RULE_LEVELS[ruleId] ?? 'warning',
110
- message: { text: message },
111
- locations: [
112
- {
113
- physicalLocation: {
114
- artifactLocation: { uri: toFileUri(repoRoot, filePath) },
115
- ...(startLine != null ? { region: { startLine } } : {}),
116
- },
117
- },
118
- ],
119
- fingerprints: { 'monograph/v1': fingerprint(ruleId, filePath) },
120
- };
121
- return result;
122
- }
123
-
124
- export function exportSarif(db: Database.Database, repoRoot: string): SarifDocument {
125
- const results: SarifResult[] = [];
126
-
127
- // ── God nodes (top 10% by fan-in) ────────────────────────────────────────────
128
- const totalNodes = (db.prepare(`SELECT COUNT(*) as c FROM nodes WHERE label = 'File'`).get() as { c: number }).c;
129
- const top10pct = Math.max(1, Math.floor(totalNodes * 0.1));
130
- const godNodes = db.prepare(`
131
- SELECT n.id, n.name, n.file_path, n.start_line,
132
- COUNT(e.id) AS in_degree
133
- FROM nodes n
134
- LEFT JOIN edges e ON e.target_id = n.id
135
- WHERE n.file_path IS NOT NULL AND n.label = 'File'
136
- GROUP BY n.id
137
- ORDER BY in_degree DESC
138
- LIMIT ?
139
- `).all(top10pct) as { id: string; name: string; file_path: string; start_line: number | null; in_degree: number }[];
140
-
141
- for (const row of godNodes) {
142
- if (row.in_degree === 0) continue;
143
- results.push(makeResult(
144
- 'monograph/god-node',
145
- `God node: "${row.name}" has ${row.in_degree} incoming dependencies (fan-in).`,
146
- row.file_path,
147
- row.start_line,
148
- repoRoot,
149
- ));
150
- }
151
-
152
- // ── Unreachable files ─────────────────────────────────────────────────────────
153
- const unreachable = db.prepare(`
154
- SELECT id, name, file_path FROM nodes
155
- WHERE label = 'File'
156
- AND (
157
- json_extract(properties, '$.reachabilityRole') = 'unreachable'
158
- OR properties LIKE '%"unreachable"%'
159
- )
160
- AND file_path IS NOT NULL
161
- `).all() as { id: string; name: string; file_path: string }[];
162
-
163
- for (const row of unreachable) {
164
- results.push(makeResult(
165
- 'monograph/unreachable-file',
166
- `Unreachable file: "${row.name}" is not reachable from any entry point.`,
167
- row.file_path,
168
- null,
169
- repoRoot,
170
- ));
171
- }
172
-
173
- // ── Hotspots (churnScore > 0.5) ───────────────────────────────────────────────
174
- const hotspots = db.prepare(`
175
- SELECT id, name, file_path, start_line
176
- FROM nodes
177
- WHERE file_path IS NOT NULL
178
- AND json_extract(properties, '$.churnScore') > 0.5
179
- `).all() as { id: string; name: string; file_path: string; start_line: number | null }[];
180
-
181
- for (const row of hotspots) {
182
- results.push(makeResult(
183
- 'monograph/hotspot',
184
- `Hotspot: "${row.name}" has high churn score (>0.5) and is highly connected.`,
185
- row.file_path,
186
- row.start_line,
187
- repoRoot,
188
- ));
189
- }
190
-
191
- return {
192
- $schema: 'https://raw.githubusercontent.com/oasis-tcs/sarif-spec/master/Schemata/sarif-schema-2.1.0.json',
193
- version: '2.1.0',
194
- runs: [
195
- {
196
- tool: {
197
- driver: {
198
- name: 'monograph',
199
- version: '1.1.0',
200
- rules: SARIF_RULES,
201
- },
202
- },
203
- results,
204
- },
205
- ],
206
- };
207
- }
208
-
209
- // ── Round 10: health SARIF export ─────────────────────────────────────────────
210
-
211
- export interface SarifHealthFinding {
212
- filePath: string;
213
- functionName: string;
214
- startLine: number;
215
- endLine: number;
216
- ruleId: string;
217
- message: string;
218
- severity: 'error' | 'warning' | 'note';
219
- }
220
-
221
- export function exportHealthSarif(findings: SarifHealthFinding[], root?: string): SarifDocument {
222
- const rules: SarifRule[] = [
223
- { id: 'complexity/cyclomatic', name: 'High Cyclomatic Complexity', shortDescription: { text: 'Function exceeds cyclomatic complexity threshold' }, fullDescription: { text: 'Cyclomatic complexity indicates the number of linearly independent paths through a function.' } },
224
- { id: 'complexity/cognitive', name: 'High Cognitive Complexity', shortDescription: { text: 'Function exceeds cognitive complexity threshold' }, fullDescription: { text: 'Cognitive complexity measures how difficult a function is to understand.' } },
225
- { id: 'complexity/crap', name: 'High CRAP Score', shortDescription: { text: 'Function has a high CRAP score due to complexity and low coverage' }, fullDescription: { text: 'CRAP = cyclomatic^2 * (1 - coverage/100)^3 + cyclomatic' } },
226
- ];
227
-
228
- const results: SarifResult[] = findings.map(f => ({
229
- ruleId: f.ruleId,
230
- message: { text: f.message },
231
- level: f.severity === 'error' ? 'error' : f.severity === 'warning' ? 'warning' : 'note',
232
- locations: [{
233
- physicalLocation: {
234
- artifactLocation: { uri: root ? f.filePath.replace(root, '').replace(/^\//, '') : f.filePath },
235
- region: { startLine: f.startLine, endLine: f.endLine },
236
- },
237
- }],
238
- }));
239
-
240
- return {
241
- $schema: 'https://raw.githubusercontent.com/oasis-tcs/sarif-spec/master/Schemata/sarif-schema-2.1.0.json',
242
- version: '2.1.0',
243
- runs: [{ tool: { driver: { name: 'monograph-health', version: PKG_VERSION, rules } }, results }],
244
- };
245
- }