@monoes/monograph 1.5.6 → 1.5.8
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +31 -15
- package/dist/src/analysis/changed-files.d.ts +3 -0
- package/dist/src/analysis/changed-files.d.ts.map +1 -1
- package/dist/src/analysis/changed-files.js +11 -9
- package/dist/src/analysis/changed-files.js.map +1 -1
- package/dist/src/analysis/changed-workspaces.d.ts.map +1 -1
- package/dist/src/analysis/changed-workspaces.js +2 -9
- package/dist/src/analysis/changed-workspaces.js.map +1 -1
- package/dist/src/analysis/git-changed-files.d.ts +3 -0
- package/dist/src/analysis/git-changed-files.d.ts.map +1 -1
- package/dist/src/analysis/git-changed-files.js +17 -12
- package/dist/src/analysis/git-changed-files.js.map +1 -1
- package/dist/src/analysis/git-ref.d.ts +33 -0
- package/dist/src/analysis/git-ref.d.ts.map +1 -0
- package/dist/src/analysis/git-ref.js +54 -0
- package/dist/src/analysis/git-ref.js.map +1 -0
- package/dist/src/analyze/boundary-analysis.d.ts.map +1 -1
- package/dist/src/analyze/boundary-analysis.js +42 -42
- package/dist/src/analyze/boundary-analysis.js.map +1 -1
- package/dist/src/index.d.ts +1 -0
- package/dist/src/index.d.ts.map +1 -1
- package/dist/src/index.js +1 -0
- package/dist/src/index.js.map +1 -1
- package/dist/src/lsp/server.d.ts +1 -1
- package/dist/src/lsp/server.d.ts.map +1 -1
- package/dist/src/lsp/server.js +48 -13
- package/dist/src/lsp/server.js.map +1 -1
- package/dist/src/mcp-tools/api-impact.d.ts.map +1 -1
- package/dist/src/mcp-tools/api-impact.js +1 -16
- package/dist/src/mcp-tools/api-impact.js.map +1 -1
- package/dist/src/mcp-tools/context.d.ts.map +1 -1
- package/dist/src/mcp-tools/context.js +12 -23
- package/dist/src/mcp-tools/context.js.map +1 -1
- package/dist/src/mcp-tools/explain.d.ts.map +1 -1
- package/dist/src/mcp-tools/explain.js +15 -20
- package/dist/src/mcp-tools/explain.js.map +1 -1
- package/dist/src/mcp-tools/graph-query.d.ts.map +1 -1
- package/dist/src/mcp-tools/graph-query.js +10 -19
- package/dist/src/mcp-tools/graph-query.js.map +1 -1
- package/dist/src/mcp-tools/impact.d.ts.map +1 -1
- package/dist/src/mcp-tools/impact.js +38 -41
- package/dist/src/mcp-tools/impact.js.map +1 -1
- package/dist/src/mcp-tools/neighbors.d.ts.map +1 -1
- package/dist/src/mcp-tools/neighbors.js +4 -22
- package/dist/src/mcp-tools/neighbors.js.map +1 -1
- package/dist/src/mcp-tools/query.d.ts.map +1 -1
- package/dist/src/mcp-tools/query.js +14 -9
- package/dist/src/mcp-tools/query.js.map +1 -1
- package/dist/src/mcp-tools/rename.d.ts.map +1 -1
- package/dist/src/mcp-tools/rename.js +3 -20
- package/dist/src/mcp-tools/rename.js.map +1 -1
- package/dist/src/parsers/c.d.ts.map +1 -1
- package/dist/src/parsers/c.js +12 -0
- package/dist/src/parsers/c.js.map +1 -1
- package/dist/src/parsers/extractor.d.ts.map +1 -1
- package/dist/src/parsers/extractor.js +2 -1
- package/dist/src/parsers/extractor.js.map +1 -1
- package/dist/src/parsers/go.d.ts.map +1 -1
- package/dist/src/parsers/go.js +19 -1
- package/dist/src/parsers/go.js.map +1 -1
- package/dist/src/parsers/language-config.d.ts +4 -0
- package/dist/src/parsers/language-config.d.ts.map +1 -1
- package/dist/src/parsers/language-parsers.d.ts.map +1 -1
- package/dist/src/parsers/language-parsers.js +3 -1
- package/dist/src/parsers/language-parsers.js.map +1 -1
- package/dist/src/parsers/loader.d.ts +1 -0
- package/dist/src/parsers/loader.d.ts.map +1 -1
- package/dist/src/parsers/loader.js +161 -20
- package/dist/src/parsers/loader.js.map +1 -1
- package/dist/src/parsers/python.d.ts.map +1 -1
- package/dist/src/parsers/python.js +6 -0
- package/dist/src/parsers/python.js.map +1 -1
- package/dist/src/parsers/rust.d.ts.map +1 -1
- package/dist/src/parsers/rust.js +10 -0
- package/dist/src/parsers/rust.js.map +1 -1
- package/dist/src/pipeline/orchestrator.d.ts.map +1 -1
- package/dist/src/pipeline/orchestrator.js +17 -0
- package/dist/src/pipeline/orchestrator.js.map +1 -1
- package/dist/src/pipeline/phases/pdf-parse.d.ts.map +1 -1
- package/dist/src/pipeline/phases/pdf-parse.js +10 -11
- package/dist/src/pipeline/phases/pdf-parse.js.map +1 -1
- package/dist/src/storage/edge-store.d.ts +1 -0
- package/dist/src/storage/edge-store.d.ts.map +1 -1
- package/dist/src/storage/edge-store.js +5 -8
- package/dist/src/storage/edge-store.js.map +1 -1
- package/dist/src/storage/node-store.d.ts +1 -0
- package/dist/src/storage/node-store.d.ts.map +1 -1
- package/dist/src/storage/node-store.js +11 -12
- package/dist/src/storage/node-store.js.map +1 -1
- package/dist/src/storage/schema.d.ts.map +1 -1
- package/dist/src/storage/schema.js +6 -0
- package/dist/src/storage/schema.js.map +1 -1
- package/dist/src/storage/utils.d.ts +11 -0
- package/dist/src/storage/utils.d.ts.map +1 -0
- package/dist/src/storage/utils.js +24 -0
- package/dist/src/storage/utils.js.map +1 -0
- package/dist/tsconfig.tsbuildinfo +1 -1
- package/package.json +12 -9
- package/.monomind/data/ranked-context.json +0 -5
- package/.monomind/loops/mastermind-review-1782162423447.json +0 -16
- package/.monomind/sessions/session-1777578175215.json +0 -15
- package/.monomind/sessions/session-1777823684507.json +0 -15
- package/.monomind/sessions/session-1777928944749.json +0 -15
- package/.monomind/sessions/session-1778052902210.json +0 -15
- package/.monomind/sessions/session-1778056744636.json +0 -15
- package/.monomind/sessions/session-1778061077599.json +0 -15
- package/.monomind/sessions/session-1778102154764.json +0 -15
- package/__tests__/analysis/shape-extractor.test.ts +0 -124
- package/__tests__/analysis/surprise-scorer.test.ts +0 -154
- package/__tests__/cache/extraction-cache.test.ts +0 -45
- package/__tests__/cli/ai-context.test.ts +0 -175
- package/__tests__/cli/augment.test.ts +0 -128
- package/__tests__/cli/doctor.test.ts +0 -125
- package/__tests__/cli/eval-server.test.ts +0 -89
- package/__tests__/cli/setup.test.ts +0 -178
- package/__tests__/cli/skill-gen.test.ts +0 -280
- package/__tests__/export/formats.test.ts +0 -82
- package/__tests__/fixtures/sample.c +0 -25
- package/__tests__/fixtures/sample.cpp +0 -32
- package/__tests__/fixtures/sample.dart +0 -34
- package/__tests__/fixtures/sample.kt +0 -30
- package/__tests__/fixtures/sample.php +0 -30
- package/__tests__/fixtures/sample.py +0 -11
- package/__tests__/fixtures/sample.rb +0 -26
- package/__tests__/fixtures/sample.swift +0 -42
- package/__tests__/fixtures/sample.ts +0 -17
- package/__tests__/fixtures/sample.vue +0 -40
- package/__tests__/groups/group-search.test.ts +0 -221
- package/__tests__/groups/group-sync.test.ts +0 -336
- package/__tests__/integration/build-atomicity.test.ts +0 -61
- package/__tests__/integration/call-attribution.test.ts +0 -116
- package/__tests__/integration/full-pipeline.test.ts +0 -64
- package/__tests__/integration/graph-report-freshness.test.ts +0 -53
- package/__tests__/integration/incremental-build.test.ts +0 -103
- package/__tests__/mcp-resources/resources.test.ts +0 -256
- package/__tests__/mcp-tools/api-impact.test.ts +0 -188
- package/__tests__/mcp-tools/context.test.ts +0 -130
- package/__tests__/mcp-tools/cypher.test.ts +0 -258
- package/__tests__/mcp-tools/detect-changes.test.ts +0 -114
- package/__tests__/mcp-tools/impact.test.ts +0 -133
- package/__tests__/mcp-tools/rename.test.ts +0 -117
- package/__tests__/mcp-tools/route-map.test.ts +0 -237
- package/__tests__/mcp-tools/shape-check.test.ts +0 -202
- package/__tests__/mcp-tools/tool-map.test.ts +0 -135
- package/__tests__/parsers/c.test.ts +0 -28
- package/__tests__/parsers/cpp.test.ts +0 -28
- package/__tests__/parsers/csharp.test.ts +0 -62
- package/__tests__/parsers/dart.test.ts +0 -28
- package/__tests__/parsers/kotlin.test.ts +0 -28
- package/__tests__/parsers/loader.test.ts +0 -14
- package/__tests__/parsers/php.test.ts +0 -28
- package/__tests__/parsers/python.test.ts +0 -32
- package/__tests__/parsers/ruby.test.ts +0 -33
- package/__tests__/parsers/swift.test.ts +0 -28
- package/__tests__/parsers/typescript.test.ts +0 -45
- package/__tests__/parsers/vue.test.ts +0 -28
- package/__tests__/pipeline/analysis.test.ts +0 -58
- package/__tests__/pipeline/phases/corpus-check.test.ts +0 -26
- package/__tests__/pipeline/phases/evidence.test.ts +0 -41
- package/__tests__/pipeline/phases/field-access.test.ts +0 -22
- package/__tests__/pipeline/phases/leiden.test.ts +0 -72
- package/__tests__/pipeline/phases/markdown.test.ts +0 -84
- package/__tests__/pipeline/phases/middleware-extractor.test.ts +0 -131
- package/__tests__/pipeline/phases/orm.test.ts +0 -379
- package/__tests__/pipeline/phases/processes.test.ts +0 -191
- package/__tests__/pipeline/phases/routes.test.ts +0 -195
- package/__tests__/pipeline/phases/scope-resolution.test.ts +0 -133
- package/__tests__/pipeline/phases/tools.test.ts +0 -161
- package/__tests__/pipeline/phases/variables.test.ts +0 -30
- package/__tests__/pipeline/phases/wildcard-synthesis.test.ts +0 -207
- package/__tests__/pipeline/phases.test.ts +0 -41
- package/__tests__/pipeline/runner.test.ts +0 -28
- package/__tests__/registry/repo-registry.test.ts +0 -127
- package/__tests__/reporting/graph-report.suggest.test.ts +0 -36
- package/__tests__/reporting/graph-report.test.ts +0 -165
- package/__tests__/search/ast-chunker.test.ts +0 -63
- package/__tests__/search/rrf.test.ts +0 -95
- package/__tests__/security/safe-fetch.test.ts +0 -41
- package/__tests__/security/sensitive-files.test.ts +0 -32
- package/__tests__/setup.ts +0 -1
- package/__tests__/skills/platform-skills.test.ts +0 -63
- package/__tests__/staleness/git-staleness.test.ts +0 -107
- package/__tests__/storage/db.test.ts +0 -37
- package/__tests__/storage/evidence-roundtrip.test.ts +0 -89
- package/__tests__/storage/stores.test.ts +0 -165
- package/__tests__/types.test.ts +0 -13
- package/__tests__/validation/extraction-validator.test.ts +0 -48
- package/__tests__/watch/watcher.test.ts +0 -31
- package/__tests__/web/analyze-api.test.ts +0 -66
- package/__tests__/web/api.test.ts +0 -210
- package/__tests__/web/mcp-http.test.ts +0 -67
- package/__tests__/web/react-ui.test.ts +0 -43
- package/__tests__/wiki/gist-publisher.test.ts +0 -66
- package/__tests__/wiki/providers.test.ts +0 -69
- package/__tests__/wiki/wiki-generator.test.ts +0 -260
- package/dist/src/fix/deps.d.ts +0 -14
- package/dist/src/fix/deps.d.ts.map +0 -1
- package/dist/src/fix/deps.js +0 -47
- package/dist/src/fix/deps.js.map +0 -1
- package/dist/src/fix/enum-members.d.ts +0 -20
- package/dist/src/fix/enum-members.d.ts.map +0 -1
- package/dist/src/fix/enum-members.js +0 -95
- package/dist/src/fix/enum-members.js.map +0 -1
- package/dist/src/fix/export-surgery.d.ts +0 -14
- package/dist/src/fix/export-surgery.d.ts.map +0 -1
- package/dist/src/fix/export-surgery.js +0 -140
- package/dist/src/fix/export-surgery.js.map +0 -1
- package/dist/src/fix/exports.d.ts +0 -16
- package/dist/src/fix/exports.d.ts.map +0 -1
- package/dist/src/fix/exports.js +0 -65
- package/dist/src/fix/exports.js.map +0 -1
- package/dist/src/fix/orchestrator.d.ts +0 -28
- package/dist/src/fix/orchestrator.d.ts.map +0 -1
- package/dist/src/fix/orchestrator.js +0 -39
- package/dist/src/fix/orchestrator.js.map +0 -1
- package/src/__tests__/analysis/benchmark.test.ts +0 -59
- package/src/__tests__/analysis/cluster-quality.test.ts +0 -106
- package/src/__tests__/analysis/corpus-health.test.ts +0 -33
- package/src/__tests__/analysis/dependency-health.test.ts +0 -105
- package/src/__tests__/analysis/file-classifier.test.ts +0 -50
- package/src/__tests__/analysis/node-similarity.test.ts +0 -81
- package/src/__tests__/cache/augment-cache.test.ts +0 -55
- package/src/__tests__/cli/check-update.test.ts +0 -42
- package/src/__tests__/cli/hooks-install.test.ts +0 -56
- package/src/__tests__/cli/hooks-marker.test.ts +0 -138
- package/src/__tests__/cli/hooks-status.test.ts +0 -42
- package/src/__tests__/export/adjacency-matrix.test.ts +0 -116
- package/src/__tests__/export/csv.test.ts +0 -39
- package/src/__tests__/export/dot.test.ts +0 -86
- package/src/__tests__/export/gexf.test.ts +0 -78
- package/src/__tests__/export/graphml.test.ts +0 -57
- package/src/__tests__/export/mermaid.test.ts +0 -89
- package/src/__tests__/graph/betweenness.test.ts +0 -89
- package/src/__tests__/graph/cycles.test.ts +0 -131
- package/src/__tests__/graph/dead-code.test.ts +0 -174
- package/src/__tests__/graph/dfs.test.ts +0 -62
- package/src/__tests__/graph/diff-summary.test.ts +0 -83
- package/src/__tests__/graph/edge-filter.test.ts +0 -129
- package/src/__tests__/graph/import-chain.test.ts +0 -111
- package/src/__tests__/graph/merge.test.ts +0 -151
- package/src/__tests__/graph/node-search.test.ts +0 -167
- package/src/__tests__/graph/normalize-id.test.ts +0 -102
- package/src/__tests__/graph/pagerank.test.ts +0 -96
- package/src/__tests__/graph/prune.test.ts +0 -110
- package/src/__tests__/graph/regex-search.test.ts +0 -166
- package/src/__tests__/graph/ripple-impact.test.ts +0 -73
- package/src/__tests__/graph/scc.test.ts +0 -85
- package/src/__tests__/graph/statistics.test.ts +0 -219
- package/src/__tests__/graph/subgraph.test.ts +0 -127
- package/src/__tests__/graph/topo-sort.test.ts +0 -110
- package/src/__tests__/graph/wcc.test.ts +0 -101
- package/src/__tests__/groups/grpc-extractor.test.ts +0 -47
- package/src/__tests__/groups/service-boundary.test.ts +0 -86
- package/src/__tests__/groups/topic-extractor.test.ts +0 -43
- package/src/__tests__/ingest/git-clone.test.ts +0 -128
- package/src/__tests__/ingest/query-memory.test.ts +0 -123
- package/src/__tests__/ingest/transcribe.test.ts +0 -58
- package/src/__tests__/ingest/url-ingest.test.ts +0 -48
- package/src/__tests__/mcp-resources/repo-context-resource.test.ts +0 -37
- package/src/__tests__/mcp-resources/repos-resource.test.ts +0 -71
- package/src/__tests__/mcp-resources/wiki-resource.test.ts +0 -52
- package/src/__tests__/mcp-tools/explain.test.ts +0 -46
- package/src/__tests__/mcp-tools/graph-query.test.ts +0 -45
- package/src/__tests__/mcp-tools/group-sync.test.ts +0 -8
- package/src/__tests__/mcp-tools/impact-filtering.test.ts +0 -48
- package/src/__tests__/mcp-tools/impact.risk.test.ts +0 -24
- package/src/__tests__/mcp-tools/list-repos.test.ts +0 -24
- package/src/__tests__/mcp-tools/neighbors.test.ts +0 -48
- package/src/__tests__/mcp-tools/query.test.ts +0 -42
- package/src/__tests__/parsers/language-parsers.test.ts +0 -52
- package/src/__tests__/parsers/named-bindings.test.ts +0 -73
- package/src/__tests__/pipeline/cluster-only.test.ts +0 -33
- package/src/__tests__/pipeline/phases/bridge-adapters/electron-ipc.test.ts +0 -87
- package/src/__tests__/pipeline/phases/bridge-adapters/tauri.test.ts +0 -116
- package/src/__tests__/pipeline/phases/bridge-adapters/wails.test.ts +0 -81
- package/src/__tests__/pipeline/phases/bridge-resolver.test.ts +0 -110
- package/src/__tests__/pipeline/phases/communities.cohesion.test.ts +0 -43
- package/src/__tests__/pipeline/phases/community-split.test.ts +0 -30
- package/src/__tests__/pipeline/phases/framework-detect.test.ts +0 -65
- package/src/__tests__/pipeline/phases/import-resolver.test.ts +0 -64
- package/src/__tests__/pipeline/phases/parse-arrow.test.ts +0 -33
- package/src/__tests__/pipeline/phases/parse-csharp.test.ts +0 -33
- package/src/__tests__/pipeline/phases/scan.monographignore.test.ts +0 -53
- package/src/__tests__/pipeline/phases/scan.negation.test.ts +0 -40
- package/src/__tests__/pipeline/phases/scope-resolution.go.test.ts +0 -34
- package/src/__tests__/pipeline/phases/scope-resolution.java.test.ts +0 -30
- package/src/__tests__/pipeline/phases/scope-resolution.rust.test.ts +0 -31
- package/src/__tests__/pipeline/phases/suggest-questions.test.ts +0 -46
- package/src/__tests__/pipeline/phases/surprises-scoring.test.ts +0 -46
- package/src/__tests__/pipeline/phases/variables-phase.test.ts +0 -78
- package/src/__tests__/pipeline/phases/wildcard-phase.test.ts +0 -99
- package/src/__tests__/pipeline/runner.parallel.test.ts +0 -78
- package/src/__tests__/reporting/graph-report-confidence.test.ts +0 -43
- package/src/__tests__/reporting/graph-report-gaps.test.ts +0 -41
- package/src/__tests__/scope-resolution/call-sites.test.ts +0 -89
- package/src/__tests__/scope-resolution/evidence-weights.test.ts +0 -49
- package/src/__tests__/search/diacritic.test.ts +0 -23
- package/src/__tests__/security/safe-fetch.test.ts +0 -125
- package/src/__tests__/skills/platform-skills.extra.test.ts +0 -36
- package/src/__tests__/web/api.clusters.test.ts +0 -65
- package/src/__tests__/web/api.file.test.ts +0 -44
- package/src/__tests__/web/api.grep.test.ts +0 -47
- package/src/__tests__/web/api.info.test.ts +0 -18
- package/src/__tests__/web/api.jobs.test.ts +0 -47
- package/src/__tests__/web/api.progress.test.ts +0 -25
- package/src/__tests__/web/api.stream.test.ts +0 -35
- package/src/__tests__/wiki/providers-reasoning.test.ts +0 -46
- package/src/__tests__/wiki/wiki-review-mode.test.ts +0 -22
- package/src/analysis/benchmark.ts +0 -132
- package/src/analysis/changed-files.ts +0 -73
- package/src/analysis/changed-workspaces.ts +0 -94
- package/src/analysis/churn-cache.ts +0 -179
- package/src/analysis/churn-trend.ts +0 -57
- package/src/analysis/churn.ts +0 -263
- package/src/analysis/cluster-quality.ts +0 -142
- package/src/analysis/combined.ts +0 -41
- package/src/analysis/corpus-health.ts +0 -41
- package/src/analysis/coverage-gaps.ts +0 -246
- package/src/analysis/dep-classification.ts +0 -167
- package/src/analysis/dependency-health.ts +0 -146
- package/src/analysis/duplicate-exports.ts +0 -110
- package/src/analysis/fallow-suppression.ts +0 -98
- package/src/analysis/feature-flags-config.ts +0 -47
- package/src/analysis/feature-flags.ts +0 -223
- package/src/analysis/file-classifier.ts +0 -87
- package/src/analysis/git-changed-files.ts +0 -62
- package/src/analysis/health-baseline.ts +0 -80
- package/src/analysis/issue-filters.ts +0 -56
- package/src/analysis/list.ts +0 -74
- package/src/analysis/node-similarity.ts +0 -115
- package/src/analysis/private-type-leaks.ts +0 -119
- package/src/analysis/progress.ts +0 -43
- package/src/analysis/project-state.ts +0 -95
- package/src/analysis/regression-config.ts +0 -36
- package/src/analysis/rule-overrides.ts +0 -81
- package/src/analysis/scripts.ts +0 -95
- package/src/analysis/shape-extractor.ts +0 -202
- package/src/analysis/since-duration.ts +0 -42
- package/src/analysis/suppression-context.ts +0 -95
- package/src/analysis/suppressions.ts +0 -80
- package/src/analysis/surprise-scorer.ts +0 -74
- package/src/analysis/targets.ts +0 -237
- package/src/analysis/unused-class-members.ts +0 -79
- package/src/analysis/workspace-filter.ts +0 -89
- package/src/analyze/boundary-analysis.ts +0 -129
- package/src/analyze/predicates/file.ts +0 -86
- package/src/analyze/predicates/import.ts +0 -90
- package/src/analyze/predicates/lifecycle.ts +0 -55
- package/src/analyze/unused-deps.ts +0 -70
- package/src/analyze/unused-exports.ts +0 -145
- package/src/analyze/unused-files.ts +0 -46
- package/src/api/production-override.ts +0 -63
- package/src/api/programmatic.ts +0 -118
- package/src/audit.ts +0 -234
- package/src/cache/augment-cache.ts +0 -63
- package/src/cache/extraction-cache.ts +0 -141
- package/src/check/filtering.ts +0 -78
- package/src/check/index.ts +0 -99
- package/src/check/output.ts +0 -79
- package/src/check/rules.ts +0 -61
- package/src/ci-template.ts +0 -84
- package/src/claude-cli.ts +0 -59
- package/src/cli/ai-context.ts +0 -193
- package/src/cli/augment.ts +0 -114
- package/src/cli/check-update.ts +0 -40
- package/src/cli/doctor.ts +0 -182
- package/src/cli/eval-server.ts +0 -126
- package/src/cli/hooks-install.ts +0 -202
- package/src/cli/setup.ts +0 -197
- package/src/cli/skill-gen.ts +0 -347
- package/src/commands/flags.ts +0 -72
- package/src/config/boundary-config.ts +0 -183
- package/src/config/cli-schema.ts +0 -81
- package/src/config/config-parsing.ts +0 -102
- package/src/config/duplicates-config.ts +0 -62
- package/src/config/external-plugin.ts +0 -77
- package/src/config/health-config.ts +0 -42
- package/src/config/ignore-exports-used-in-file.ts +0 -46
- package/src/config/migration-types.ts +0 -73
- package/src/config/output-format.ts +0 -24
- package/src/config/plugins/builtin.ts +0 -411
- package/src/config/plugins/registry.ts +0 -77
- package/src/config/plugins/types.ts +0 -14
- package/src/config/resolution.ts +0 -102
- package/src/config/rules.ts +0 -70
- package/src/config/schema-gen.ts +0 -115
- package/src/config/types.ts +0 -149
- package/src/config/used-class-members.ts +0 -53
- package/src/config/validate.ts +0 -108
- package/src/config/workspace.ts +0 -137
- package/src/coverage/cloud-client.ts +0 -111
- package/src/coverage/upload-inventory.ts +0 -84
- package/src/coverage/upload-source-maps.ts +0 -97
- package/src/discover/entry-points.ts +0 -51
- package/src/discover/infrastructure-entries.ts +0 -175
- package/src/duplicates/detect/concatenation.ts +0 -37
- package/src/duplicates/detect/extraction.ts +0 -107
- package/src/duplicates/detect/filtering.ts +0 -112
- package/src/duplicates/detect/lcp.ts +0 -27
- package/src/duplicates/detect/ranking.ts +0 -16
- package/src/duplicates/detect/statistics.ts +0 -69
- package/src/duplicates/detect/suffix-array.ts +0 -88
- package/src/duplicates/families.ts +0 -95
- package/src/duplicates/normalize.ts +0 -58
- package/src/duplicates/shingle-filter.ts +0 -37
- package/src/duplicates/token-types.ts +0 -62
- package/src/duplicates/tokenize/index.ts +0 -104
- package/src/error/fallow-error.ts +0 -94
- package/src/error.ts +0 -47
- package/src/export/adjacency-matrix.ts +0 -127
- package/src/export/analysis-json.ts +0 -87
- package/src/export/badge.ts +0 -105
- package/src/export/canvas.ts +0 -42
- package/src/export/codeclimate.ts +0 -201
- package/src/export/compact-health.ts +0 -119
- package/src/export/compact.ts +0 -83
- package/src/export/csv.ts +0 -33
- package/src/export/cypher.ts +0 -33
- package/src/export/dot.ts +0 -52
- package/src/export/gexf.ts +0 -59
- package/src/export/graphml.ts +0 -50
- package/src/export/html.ts +0 -548
- package/src/export/index.ts +0 -9
- package/src/export/json.ts +0 -36
- package/src/export/markdown.ts +0 -290
- package/src/export/mermaid.ts +0 -100
- package/src/export/obsidian.ts +0 -44
- package/src/export/sarif.ts +0 -245
- package/src/export/svg.ts +0 -68
- package/src/fix/deps.ts +0 -70
- package/src/fix/enum-members.ts +0 -103
- package/src/fix/export-surgery.ts +0 -197
- package/src/fix/exports.ts +0 -93
- package/src/fix/orchestrator.ts +0 -67
- package/src/graph/analyzer.ts +0 -69
- package/src/graph/author-analytics.ts +0 -217
- package/src/graph/baseline.ts +0 -432
- package/src/graph/clone-families.ts +0 -132
- package/src/graph/codeowners-extended.ts +0 -114
- package/src/graph/codeowners-gitlab.ts +0 -150
- package/src/graph/codeowners.ts +0 -217
- package/src/graph/complexity.ts +0 -200
- package/src/graph/cross-reference-findings.ts +0 -85
- package/src/graph/cross-reference.ts +0 -139
- package/src/graph/cycle-detection.ts +0 -311
- package/src/graph/cycles.ts +0 -222
- package/src/graph/dead-code.ts +0 -128
- package/src/graph/dependency-closure.ts +0 -126
- package/src/graph/dfs.ts +0 -118
- package/src/graph/diff.ts +0 -92
- package/src/graph/duplication-stats.ts +0 -79
- package/src/graph/edge-filter.ts +0 -117
- package/src/graph/explain.ts +0 -133
- package/src/graph/external-style-usage.ts +0 -81
- package/src/graph/health-score.ts +0 -179
- package/src/graph/hotspots.ts +0 -219
- package/src/graph/import-chain.ts +0 -148
- package/src/graph/loader.ts +0 -44
- package/src/graph/maintainability.ts +0 -156
- package/src/graph/merge.ts +0 -174
- package/src/graph/mirrored-dirs.ts +0 -202
- package/src/graph/narrowing.ts +0 -92
- package/src/graph/node-search.ts +0 -201
- package/src/graph/node-types.ts +0 -67
- package/src/graph/normalize-id.ts +0 -138
- package/src/graph/pagerank.ts +0 -165
- package/src/graph/prune.ts +0 -95
- package/src/graph/re-exports/propagate.ts +0 -95
- package/src/graph/reachability.ts +0 -99
- package/src/graph/regex-search.ts +0 -232
- package/src/graph/regression.ts +0 -199
- package/src/graph/resolve/discover-types.ts +0 -45
- package/src/graph/resolve/dynamic-imports.ts +0 -102
- package/src/graph/resolve/fallbacks.ts +0 -79
- package/src/graph/resolve/index.ts +0 -68
- package/src/graph/resolve/path-info.ts +0 -41
- package/src/graph/resolve/re-exports.ts +0 -14
- package/src/graph/resolve/react-native.ts +0 -27
- package/src/graph/resolve/require-imports.ts +0 -18
- package/src/graph/resolve/specifier.ts +0 -120
- package/src/graph/resolve/static-imports.ts +0 -14
- package/src/graph/resolve/types.ts +0 -108
- package/src/graph/resolve/upgrades.ts +0 -32
- package/src/graph/ripple-impact.ts +0 -131
- package/src/graph/risk-profile.ts +0 -179
- package/src/graph/statistics.ts +0 -165
- package/src/graph/stats.ts +0 -157
- package/src/graph/subgraph.ts +0 -162
- package/src/graph/topo-sort.ts +0 -171
- package/src/graph/wcc.ts +0 -187
- package/src/groups/contract-bridge.ts +0 -103
- package/src/groups/contract-registry.ts +0 -263
- package/src/groups/group-config.ts +0 -108
- package/src/groups/group-search.ts +0 -139
- package/src/groups/group-sync.ts +0 -82
- package/src/groups/grpc-extractor.ts +0 -64
- package/src/groups/service-boundary.ts +0 -119
- package/src/groups/topic-extractor.ts +0 -90
- package/src/health/analysis-counts-snapshot.ts +0 -57
- package/src/health/analysis-counts.ts +0 -70
- package/src/health/complexity-findings.ts +0 -115
- package/src/health/distribution-thresholds.ts +0 -54
- package/src/health/grouping.ts +0 -138
- package/src/health/health-grouping.ts +0 -86
- package/src/health/health-report-types.ts +0 -165
- package/src/health/health-report.ts +0 -81
- package/src/health/health-score.ts +0 -65
- package/src/health/hotspot-utils.ts +0 -55
- package/src/health/hotspots.ts +0 -104
- package/src/health/large-functions.ts +0 -34
- package/src/health/ownership-metrics.ts +0 -61
- package/src/health/ownership-risk.ts +0 -98
- package/src/health/ownership.ts +0 -174
- package/src/health/quality-gate.ts +0 -57
- package/src/health/risk-profile.ts +0 -39
- package/src/health/runtime-coverage-report.ts +0 -101
- package/src/health/runtime-coverage.ts +0 -71
- package/src/health/scores.ts +0 -72
- package/src/health/scoring-types.ts +0 -48
- package/src/health/target-thresholds.ts +0 -92
- package/src/health/target-types.ts +0 -54
- package/src/health/targets.ts +0 -151
- package/src/health/timings.ts +0 -86
- package/src/health/trend-types.ts +0 -57
- package/src/health/trends.ts +0 -86
- package/src/health/vital-signs-compute.ts +0 -108
- package/src/health/vital-signs-snapshot.ts +0 -72
- package/src/health/vital-signs.ts +0 -101
- package/src/index.ts +0 -111
- package/src/ingest/git-clone.ts +0 -246
- package/src/ingest/query-memory.ts +0 -132
- package/src/ingest/transcribe.ts +0 -254
- package/src/ingest/url-ingest.ts +0 -87
- package/src/init/agent-hooks.ts +0 -86
- package/src/init/git-hooks.ts +0 -71
- package/src/init/project-detection.ts +0 -105
- package/src/license/manager.ts +0 -120
- package/src/lsp/code-actions.ts +0 -127
- package/src/lsp/code-lens.ts +0 -56
- package/src/lsp/diagnostics-ext.ts +0 -150
- package/src/lsp/diagnostics-push.ts +0 -103
- package/src/lsp/diagnostics.ts +0 -98
- package/src/lsp/hover.ts +0 -64
- package/src/lsp/server.ts +0 -254
- package/src/mcp/params.ts +0 -201
- package/src/mcp/resources.ts +0 -124
- package/src/mcp/tool-builders.ts +0 -203
- package/src/mcp-resources/communities-resource.ts +0 -72
- package/src/mcp-resources/graph-resource.ts +0 -14
- package/src/mcp-resources/index.ts +0 -9
- package/src/mcp-resources/named-cluster-resource.ts +0 -35
- package/src/mcp-resources/named-process-resource.ts +0 -26
- package/src/mcp-resources/processes-resource.ts +0 -67
- package/src/mcp-resources/repo-context-resource.ts +0 -36
- package/src/mcp-resources/repos-resource.ts +0 -21
- package/src/mcp-resources/schema-resource.ts +0 -46
- package/src/mcp-resources/wiki-resource.ts +0 -23
- package/src/mcp-tools/api-impact.ts +0 -181
- package/src/mcp-tools/context.ts +0 -111
- package/src/mcp-tools/cypher.ts +0 -29
- package/src/mcp-tools/detect-changes.ts +0 -116
- package/src/mcp-tools/explain.ts +0 -65
- package/src/mcp-tools/graph-query.ts +0 -128
- package/src/mcp-tools/group-list.ts +0 -88
- package/src/mcp-tools/group-query.ts +0 -26
- package/src/mcp-tools/group-sync.ts +0 -32
- package/src/mcp-tools/impact.ts +0 -202
- package/src/mcp-tools/index.ts +0 -21
- package/src/mcp-tools/list-repos.ts +0 -38
- package/src/mcp-tools/neighbors.ts +0 -80
- package/src/mcp-tools/query.ts +0 -86
- package/src/mcp-tools/rename.ts +0 -118
- package/src/mcp-tools/route-map.ts +0 -98
- package/src/mcp-tools/serve.ts +0 -41
- package/src/mcp-tools/shape-check.ts +0 -182
- package/src/mcp-tools/staleness.ts +0 -13
- package/src/mcp-tools/tool-map.ts +0 -66
- package/src/mcp-tools/wiki-build.ts +0 -37
- package/src/mcp-tools/wiki.ts +0 -28
- package/src/migrate/jscpd.ts +0 -78
- package/src/migrate/jsonc-gen.ts +0 -38
- package/src/migrate/knip.ts +0 -126
- package/src/migrate/toml-gen.ts +0 -48
- package/src/parsers/c.ts +0 -31
- package/src/parsers/cpp.ts +0 -29
- package/src/parsers/csharp.ts +0 -43
- package/src/parsers/dart.ts +0 -39
- package/src/parsers/extractor.ts +0 -202
- package/src/parsers/go.ts +0 -27
- package/src/parsers/java.ts +0 -27
- package/src/parsers/kotlin.ts +0 -36
- package/src/parsers/language-config.ts +0 -28
- package/src/parsers/language-parsers.ts +0 -120
- package/src/parsers/loader.ts +0 -149
- package/src/parsers/named-bindings.ts +0 -63
- package/src/parsers/php.ts +0 -37
- package/src/parsers/python.ts +0 -26
- package/src/parsers/ruby.ts +0 -39
- package/src/parsers/rust.ts +0 -25
- package/src/parsers/swift.ts +0 -28
- package/src/parsers/typescript.ts +0 -41
- package/src/parsers/vue.ts +0 -79
- package/src/pipeline/cluster-only.ts +0 -64
- package/src/pipeline/effort.ts +0 -50
- package/src/pipeline/orchestrator.ts +0 -384
- package/src/pipeline/phases/boundary.ts +0 -151
- package/src/pipeline/phases/bridge-adapters/electron-ipc.ts +0 -91
- package/src/pipeline/phases/bridge-adapters/registry.ts +0 -14
- package/src/pipeline/phases/bridge-adapters/tauri.ts +0 -103
- package/src/pipeline/phases/bridge-adapters/types.ts +0 -31
- package/src/pipeline/phases/bridge-adapters/wails.ts +0 -33
- package/src/pipeline/phases/bridge-resolver.ts +0 -77
- package/src/pipeline/phases/call-site-extractors.ts +0 -177
- package/src/pipeline/phases/communities.ts +0 -183
- package/src/pipeline/phases/contextual-proximity.ts +0 -88
- package/src/pipeline/phases/cross-file.ts +0 -116
- package/src/pipeline/phases/docs-parse.ts +0 -307
- package/src/pipeline/phases/evidence.ts +0 -9
- package/src/pipeline/phases/field-access.ts +0 -49
- package/src/pipeline/phases/framework-detect.ts +0 -109
- package/src/pipeline/phases/god-nodes.ts +0 -163
- package/src/pipeline/phases/import-resolver.ts +0 -114
- package/src/pipeline/phases/leiden.ts +0 -77
- package/src/pipeline/phases/llm-extract.ts +0 -178
- package/src/pipeline/phases/markdown.ts +0 -121
- package/src/pipeline/phases/middleware-extractor.ts +0 -127
- package/src/pipeline/phases/module-resolution.ts +0 -294
- package/src/pipeline/phases/mro.ts +0 -56
- package/src/pipeline/phases/orm.ts +0 -503
- package/src/pipeline/phases/parse.ts +0 -222
- package/src/pipeline/phases/pdf-parse.ts +0 -133
- package/src/pipeline/phases/processes.ts +0 -249
- package/src/pipeline/phases/re-export-propagation.ts +0 -160
- package/src/pipeline/phases/reachability.ts +0 -156
- package/src/pipeline/phases/routes.ts +0 -350
- package/src/pipeline/phases/scan.ts +0 -133
- package/src/pipeline/phases/scope-resolution.ts +0 -442
- package/src/pipeline/phases/structure.ts +0 -68
- package/src/pipeline/phases/suggest.ts +0 -92
- package/src/pipeline/phases/surprises.ts +0 -83
- package/src/pipeline/phases/tools.ts +0 -180
- package/src/pipeline/phases/variables-phase.ts +0 -37
- package/src/pipeline/phases/variables.ts +0 -67
- package/src/pipeline/phases/wildcard-phase.ts +0 -50
- package/src/pipeline/phases/wildcard-synthesis.ts +0 -214
- package/src/pipeline/progress.ts +0 -58
- package/src/pipeline/runner.ts +0 -88
- package/src/pipeline/types.ts +0 -41
- package/src/query/cypher-parser.ts +0 -450
- package/src/registry/repo-registry.ts +0 -125
- package/src/regression/baseline-deltas.ts +0 -215
- package/src/regression/baseline.ts +0 -76
- package/src/regression/counts.ts +0 -87
- package/src/regression/outcome.ts +0 -78
- package/src/regression/tolerance.ts +0 -35
- package/src/report/attributed-duplication.ts +0 -112
- package/src/report/badge-svg.ts +0 -100
- package/src/report/cross-ref-human.ts +0 -50
- package/src/report/duplication-grouping.ts +0 -74
- package/src/report/grouping.ts +0 -137
- package/src/report/human-check.ts +0 -291
- package/src/report/human-dupes.ts +0 -142
- package/src/report/human-health.ts +0 -195
- package/src/report/human.ts +0 -120
- package/src/report/json-actions.ts +0 -91
- package/src/report/json-builders.ts +0 -70
- package/src/report/json-schema.ts +0 -75
- package/src/report/number-format.ts +0 -91
- package/src/report/output-grouped.ts +0 -102
- package/src/report/pipeline-perf.ts +0 -56
- package/src/report/trace-human.ts +0 -127
- package/src/reporting/graph-report.ts +0 -431
- package/src/results/fallow-results.ts +0 -152
- package/src/results/types.ts +0 -149
- package/src/scope-resolution/evidence-weights.ts +0 -41
- package/src/search/ast-chunker.ts +0 -206
- package/src/search/diacritic.ts +0 -7
- package/src/search/hybrid-query.ts +0 -65
- package/src/search/rrf.ts +0 -51
- package/src/security/safe-fetch.ts +0 -113
- package/src/security/sensitive-files.ts +0 -24
- package/src/skills/platform-skills.ts +0 -233
- package/src/staleness/git-staleness.ts +0 -66
- package/src/storage/db.ts +0 -110
- package/src/storage/edge-store.ts +0 -103
- package/src/storage/file-cache.ts +0 -78
- package/src/storage/fts-store.ts +0 -385
- package/src/storage/node-store.ts +0 -209
- package/src/storage/schema.ts +0 -171
- package/src/storage/suppressions.ts +0 -145
- package/src/storage/unlinked-refs.ts +0 -117
- package/src/types.ts +0 -197
- package/src/validation/extraction-validator.ts +0 -54
- package/src/watch/watcher.ts +0 -160
- package/src/web/analyze-api.ts +0 -146
- package/src/web/api.ts +0 -584
- package/src/web/async-jobs.ts +0 -109
- package/src/web/mcp-http.ts +0 -227
- package/src/web/react-ui.ts +0 -78
- package/src/web/server.ts +0 -90
- package/src/web/ui/index.html +0 -204
- package/src/wiki/gist-publisher.ts +0 -76
- package/src/wiki/prompt-builder.ts +0 -35
- package/src/wiki/providers.ts +0 -134
- package/src/wiki/wiki-generator.ts +0 -223
- package/src/wiki/wiki-store.ts +0 -49
- package/tsconfig.json +0 -11
- 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
|
-
}
|
package/src/graph/statistics.ts
DELETED
|
@@ -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
|
-
}
|
package/src/graph/stats.ts
DELETED
|
@@ -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
|
-
}
|