@4da/mcp-server 4.2.1 → 4.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (78) hide show
  1. package/dist/http-transport.d.ts.map +1 -1
  2. package/dist/http-transport.js +5 -1
  3. package/dist/http-transport.js.map +1 -1
  4. package/dist/index.d.ts +3 -3
  5. package/dist/index.js +9 -8
  6. package/dist/index.js.map +1 -1
  7. package/dist/live/crates-registry.d.ts +18 -0
  8. package/dist/live/crates-registry.d.ts.map +1 -0
  9. package/dist/live/crates-registry.js +133 -0
  10. package/dist/live/crates-registry.js.map +1 -0
  11. package/dist/live/go-registry.d.ts +19 -0
  12. package/dist/live/go-registry.d.ts.map +1 -0
  13. package/dist/live/go-registry.js +127 -0
  14. package/dist/live/go-registry.js.map +1 -0
  15. package/dist/live/http-utils.d.ts +3 -0
  16. package/dist/live/http-utils.d.ts.map +1 -0
  17. package/dist/live/http-utils.js +20 -0
  18. package/dist/live/http-utils.js.map +1 -0
  19. package/dist/live/index.d.ts +7 -2
  20. package/dist/live/index.d.ts.map +1 -1
  21. package/dist/live/index.js +71 -0
  22. package/dist/live/index.js.map +1 -1
  23. package/dist/live/npm-registry.d.ts +19 -0
  24. package/dist/live/npm-registry.d.ts.map +1 -0
  25. package/dist/live/npm-registry.js +132 -0
  26. package/dist/live/npm-registry.js.map +1 -0
  27. package/dist/live/osv-scanner.d.ts.map +1 -1
  28. package/dist/live/osv-scanner.js +1 -10
  29. package/dist/live/osv-scanner.js.map +1 -1
  30. package/dist/live/pypi-registry.d.ts +18 -0
  31. package/dist/live/pypi-registry.d.ts.map +1 -0
  32. package/dist/live/pypi-registry.js +142 -0
  33. package/dist/live/pypi-registry.js.map +1 -0
  34. package/dist/live/rate-limiter.d.ts +12 -0
  35. package/dist/live/rate-limiter.d.ts.map +1 -1
  36. package/dist/live/rate-limiter.js +4 -0
  37. package/dist/live/rate-limiter.js.map +1 -1
  38. package/dist/live/semver-utils.d.ts +5 -0
  39. package/dist/live/semver-utils.d.ts.map +1 -0
  40. package/dist/live/semver-utils.js +28 -0
  41. package/dist/live/semver-utils.js.map +1 -0
  42. package/dist/live/types.d.ts +41 -0
  43. package/dist/live/types.d.ts.map +1 -1
  44. package/dist/schema-registry.d.ts +2 -1
  45. package/dist/schema-registry.d.ts.map +1 -1
  46. package/dist/schema-registry.js +61 -2
  47. package/dist/schema-registry.js.map +1 -1
  48. package/dist/schemas/dependency-health.json +27 -0
  49. package/dist/schemas/ecosystem-pulse.json +17 -0
  50. package/dist/schemas/upgrade-planner.json +22 -0
  51. package/dist/tool-dispatch.d.ts.map +1 -1
  52. package/dist/tool-dispatch.js +4 -1
  53. package/dist/tool-dispatch.js.map +1 -1
  54. package/dist/tools/dependency-health.d.ts +45 -0
  55. package/dist/tools/dependency-health.d.ts.map +1 -0
  56. package/dist/tools/dependency-health.js +152 -0
  57. package/dist/tools/dependency-health.js.map +1 -0
  58. package/dist/tools/ecosystem-pulse.d.ts +48 -0
  59. package/dist/tools/ecosystem-pulse.d.ts.map +1 -0
  60. package/dist/tools/ecosystem-pulse.js +60 -0
  61. package/dist/tools/ecosystem-pulse.js.map +1 -0
  62. package/dist/tools/get-context.d.ts +8 -1
  63. package/dist/tools/get-context.d.ts.map +1 -1
  64. package/dist/tools/get-context.js +18 -1
  65. package/dist/tools/get-context.js.map +1 -1
  66. package/dist/tools/index.d.ts +3 -0
  67. package/dist/tools/index.d.ts.map +1 -1
  68. package/dist/tools/index.js +3 -0
  69. package/dist/tools/index.js.map +1 -1
  70. package/dist/tools/upgrade-planner.d.ts +59 -0
  71. package/dist/tools/upgrade-planner.d.ts.map +1 -0
  72. package/dist/tools/upgrade-planner.js +167 -0
  73. package/dist/tools/upgrade-planner.js.map +1 -0
  74. package/dist/tools/what-should-i-know.d.ts +7 -0
  75. package/dist/tools/what-should-i-know.d.ts.map +1 -1
  76. package/dist/tools/what-should-i-know.js +24 -0
  77. package/dist/tools/what-should-i-know.js.map +1 -1
  78. package/package.json +2 -2
@@ -0,0 +1,152 @@
1
+ // SPDX-License-Identifier: FSL-1.1-Apache-2.0
2
+ /**
3
+ * dependency_health tool
4
+ *
5
+ * Assesses health of project dependencies by checking version freshness,
6
+ * deprecation status, and known vulnerabilities across npm, crates.io,
7
+ * PyPI, and Go ecosystems. Zero config — auto-detects from lock files.
8
+ */
9
+ export const dependencyHealthTool = {
10
+ name: "dependency_health",
11
+ description: "Assess health of project dependencies — version freshness, deprecation status, known CVEs. Auto-detects stack from lock files. Covers npm, Rust, Python, and Go.",
12
+ inputSchema: {
13
+ type: "object",
14
+ properties: {
15
+ include_dev: {
16
+ type: "boolean",
17
+ description: "Include devDependencies. Default: false",
18
+ },
19
+ ecosystem_filter: {
20
+ type: "string",
21
+ enum: ["npm", "crates.io", "PyPI", "Go"],
22
+ description: "Only show deps from this ecosystem. Default: all detected.",
23
+ },
24
+ sort_by: {
25
+ type: "string",
26
+ enum: ["risk", "name", "outdated"],
27
+ description: "Sort order. 'risk' prioritizes vulnerable+deprecated+outdated. Default: risk",
28
+ },
29
+ limit: {
30
+ type: "number",
31
+ description: "Max dependencies to return. Default: 50",
32
+ },
33
+ },
34
+ },
35
+ };
36
+ export async function executeDependencyHealth(_db, params, liveIntel) {
37
+ const start = Date.now();
38
+ if (!liveIntel || !liveIntel.isInitialized()) {
39
+ return {
40
+ scannedAt: new Date().toISOString(),
41
+ projectPath: process.cwd(),
42
+ ecosystemsScanned: [],
43
+ totalDeps: 0,
44
+ outdatedCount: 0,
45
+ deprecatedCount: 0,
46
+ vulnerableCount: 0,
47
+ healthScore: 0,
48
+ dependencies: [],
49
+ vulnerabilitySummary: null,
50
+ summary: "Live intelligence not initialized. No project manifests detected.",
51
+ scanDurationMs: Date.now() - start,
52
+ cached: false,
53
+ };
54
+ }
55
+ // Get resolved deps
56
+ const includeDev = params.include_dev ?? false;
57
+ let deps = liveIntel.getResolvedDeps();
58
+ if (!includeDev) {
59
+ deps = deps.filter((d) => !d.isDev);
60
+ }
61
+ if (params.ecosystem_filter) {
62
+ deps = deps.filter((d) => d.ecosystem === params.ecosystem_filter);
63
+ }
64
+ const ecosystems = [...new Set(deps.map((d) => d.ecosystem))];
65
+ // Fetch registry health for all deps
66
+ const registryData = await liveIntel.fetchRegistryHealth(deps);
67
+ // Merge vulnerability data
68
+ const vulnResult = liveIntel.getVulnerabilities();
69
+ const vulnMap = new Map();
70
+ if (vulnResult) {
71
+ for (const v of vulnResult.vulnerabilities) {
72
+ vulnMap.set(v.package, (vulnMap.get(v.package) || 0) + 1);
73
+ }
74
+ }
75
+ // Compute stats
76
+ let outdated = 0;
77
+ let deprecated = 0;
78
+ let vulnerable = 0;
79
+ for (const dep of registryData) {
80
+ if (dep.versionsBehind && dep.versionsBehind.label !== "up-to-date")
81
+ outdated++;
82
+ if (dep.deprecated)
83
+ deprecated++;
84
+ if (vulnMap.has(dep.name))
85
+ vulnerable++;
86
+ }
87
+ // Sort
88
+ const sortBy = params.sort_by ?? "risk";
89
+ const sorted = [...registryData].sort((a, b) => {
90
+ if (sortBy === "name")
91
+ return a.name.localeCompare(b.name);
92
+ if (sortBy === "outdated") {
93
+ const aD = a.versionsBehind ? a.versionsBehind.major * 100 + a.versionsBehind.minor * 10 + a.versionsBehind.patch : 0;
94
+ const bD = b.versionsBehind ? b.versionsBehind.major * 100 + b.versionsBehind.minor * 10 + b.versionsBehind.patch : 0;
95
+ return bD - aD;
96
+ }
97
+ // risk: vulnerable > deprecated > major outdated > minor > patch > current
98
+ const riskScore = (dep) => {
99
+ let score = 0;
100
+ if (vulnMap.has(dep.name))
101
+ score += 1000;
102
+ if (dep.deprecated)
103
+ score += 500;
104
+ if (dep.versionsBehind) {
105
+ score += dep.versionsBehind.major * 100 + dep.versionsBehind.minor * 10 + dep.versionsBehind.patch;
106
+ }
107
+ return score;
108
+ };
109
+ return riskScore(b) - riskScore(a);
110
+ });
111
+ const limit = params.limit ?? 50;
112
+ const limited = sorted.slice(0, limit);
113
+ // Health score: 100 = perfect, 0 = everything is on fire
114
+ const total = registryData.length || 1;
115
+ const vulnPenalty = Math.min(vulnerable * 15, 50);
116
+ const deprecatedPenalty = Math.min(deprecated * 10, 30);
117
+ const outdatedPenalty = Math.min(outdated * 2, 40);
118
+ const healthScore = Math.max(0, 100 - vulnPenalty - deprecatedPenalty - outdatedPenalty);
119
+ const vulnSummary = vulnResult ? {
120
+ critical: vulnResult.bySeverity.critical,
121
+ high: vulnResult.bySeverity.high,
122
+ medium: vulnResult.bySeverity.medium,
123
+ low: vulnResult.bySeverity.low,
124
+ } : null;
125
+ // Summary
126
+ const parts = [];
127
+ parts.push(`${total} dependenc${total !== 1 ? "ies" : "y"} scanned`);
128
+ if (vulnerable > 0)
129
+ parts.push(`${vulnerable} vulnerable`);
130
+ if (deprecated > 0)
131
+ parts.push(`${deprecated} deprecated`);
132
+ if (outdated > 0)
133
+ parts.push(`${outdated} outdated`);
134
+ if (vulnerable === 0 && deprecated === 0 && outdated === 0)
135
+ parts.push("all healthy");
136
+ return {
137
+ scannedAt: new Date().toISOString(),
138
+ projectPath: process.cwd(),
139
+ ecosystemsScanned: ecosystems,
140
+ totalDeps: total,
141
+ outdatedCount: outdated,
142
+ deprecatedCount: deprecated,
143
+ vulnerableCount: vulnerable,
144
+ healthScore,
145
+ dependencies: limited,
146
+ vulnerabilitySummary: vulnSummary,
147
+ summary: `Health: ${healthScore}/100. ${parts.join(", ")}.`,
148
+ scanDurationMs: Date.now() - start,
149
+ cached: false,
150
+ };
151
+ }
152
+ //# sourceMappingURL=dependency-health.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"dependency-health.js","sourceRoot":"","sources":["../../src/tools/dependency-health.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,48 @@
1
+ /**
2
+ * ecosystem_pulse tool
3
+ *
4
+ * Surfaces live ecosystem news relevant to the user's tech stack.
5
+ * Data is already fetched on server startup from Hacker News via Algolia API.
6
+ * This tool makes it queryable.
7
+ */
8
+ import type { FourDADatabase } from "../db.js";
9
+ import type { LiveIntelligence } from "../live/index.js";
10
+ export interface EcosystemPulseParams {
11
+ min_points?: number;
12
+ limit?: number;
13
+ }
14
+ interface EcosystemPulseResult {
15
+ headlines: Array<{
16
+ title: string;
17
+ url: string | null;
18
+ points: number;
19
+ comments: number;
20
+ published: string;
21
+ relevance_score: number;
22
+ relevance_reason: string;
23
+ hn_discussion: string;
24
+ }>;
25
+ total: number;
26
+ source: string;
27
+ note: string;
28
+ }
29
+ export declare const ecosystemPulseTool: {
30
+ name: string;
31
+ description: string;
32
+ inputSchema: {
33
+ type: "object";
34
+ properties: {
35
+ min_points: {
36
+ type: string;
37
+ description: string;
38
+ };
39
+ limit: {
40
+ type: string;
41
+ description: string;
42
+ };
43
+ };
44
+ };
45
+ };
46
+ export declare function executeEcosystemPulse(_db: FourDADatabase, params: EcosystemPulseParams, liveIntel: LiveIntelligence | null): EcosystemPulseResult;
47
+ export {};
48
+ //# sourceMappingURL=ecosystem-pulse.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ecosystem-pulse.d.ts","sourceRoot":"","sources":["../../src/tools/ecosystem-pulse.ts"],"names":[],"mappings":"AACA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEzD,MAAM,WAAW,oBAAoB;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,oBAAoB;IAC5B,SAAS,EAAE,KAAK,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,eAAe,EAAE,MAAM,CAAC;QACxB,gBAAgB,EAAE,MAAM,CAAC;QACzB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC,CAAC;IACH,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;CAiB9B,CAAC;AAEF,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,cAAc,EACnB,MAAM,EAAE,oBAAoB,EAC5B,SAAS,EAAE,gBAAgB,GAAG,IAAI,GACjC,oBAAoB,CAoCtB"}
@@ -0,0 +1,60 @@
1
+ // SPDX-License-Identifier: FSL-1.1-Apache-2.0
2
+ /**
3
+ * ecosystem_pulse tool
4
+ *
5
+ * Surfaces live ecosystem news relevant to the user's tech stack.
6
+ * Data is already fetched on server startup from Hacker News via Algolia API.
7
+ * This tool makes it queryable.
8
+ */
9
+ export const ecosystemPulseTool = {
10
+ name: "ecosystem_pulse",
11
+ description: "Live ecosystem news relevant to your tech stack. Surfaces trending Hacker News discussions filtered by your detected technologies. Updated on server startup.",
12
+ inputSchema: {
13
+ type: "object",
14
+ properties: {
15
+ min_points: {
16
+ type: "number",
17
+ description: "Minimum HN points to include. Default: 0",
18
+ },
19
+ limit: {
20
+ type: "number",
21
+ description: "Maximum headlines to return. Default: 15",
22
+ },
23
+ },
24
+ },
25
+ };
26
+ export function executeEcosystemPulse(_db, params, liveIntel) {
27
+ if (!liveIntel) {
28
+ return {
29
+ headlines: [],
30
+ total: 0,
31
+ source: "hacker_news",
32
+ note: "Live intelligence not available. Set FOURDA_OFFLINE=false and restart.",
33
+ };
34
+ }
35
+ const headlines = liveIntel.getHeadlines();
36
+ const minPoints = params.min_points ?? 0;
37
+ const limit = params.limit ?? 15;
38
+ const filtered = headlines
39
+ .filter((h) => h.points >= minPoints)
40
+ .slice(0, limit)
41
+ .map((h) => ({
42
+ title: h.title,
43
+ url: h.url,
44
+ points: h.points,
45
+ comments: h.comments,
46
+ published: h.published,
47
+ relevance_score: h.relevanceScore,
48
+ relevance_reason: h.relevanceReason,
49
+ hn_discussion: `https://news.ycombinator.com/item?id=${h.id}`,
50
+ }));
51
+ return {
52
+ headlines: filtered,
53
+ total: filtered.length,
54
+ source: "hacker_news",
55
+ note: filtered.length === 0
56
+ ? "No relevant headlines found for your tech stack. Headlines are filtered by detected technologies."
57
+ : `${filtered.length} headline${filtered.length !== 1 ? "s" : ""} relevant to your tech stack.`,
58
+ };
59
+ }
60
+ //# sourceMappingURL=ecosystem-pulse.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ecosystem-pulse.js","sourceRoot":"","sources":["../../src/tools/ecosystem-pulse.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C;;;;;;GAMG;AA0BH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,IAAI,EAAE,iBAAiB;IACvB,WAAW,EACT,+JAA+J;IACjK,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,0CAA0C;aACxD;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,0CAA0C;aACxD;SACF;KACF;CACF,CAAC;AAEF,MAAM,UAAU,qBAAqB,CACnC,GAAmB,EACnB,MAA4B,EAC5B,SAAkC;IAElC,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO;YACL,SAAS,EAAE,EAAE;YACb,KAAK,EAAE,CAAC;YACR,MAAM,EAAE,aAAa;YACrB,IAAI,EAAE,wEAAwE;SAC/E,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,SAAS,CAAC,YAAY,EAAE,CAAC;IAC3C,MAAM,SAAS,GAAG,MAAM,CAAC,UAAU,IAAI,CAAC,CAAC;IACzC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;IAEjC,MAAM,QAAQ,GAAG,SAAS;SACvB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,IAAI,SAAS,CAAC;SACpC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC;SACf,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACX,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,GAAG,EAAE,CAAC,CAAC,GAAG;QACV,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,SAAS,EAAE,CAAC,CAAC,SAAS;QACtB,eAAe,EAAE,CAAC,CAAC,cAAc;QACjC,gBAAgB,EAAE,CAAC,CAAC,eAAe;QACnC,aAAa,EAAE,wCAAwC,CAAC,CAAC,EAAE,EAAE;KAC9D,CAAC,CAAC,CAAC;IAEN,OAAO;QACL,SAAS,EAAE,QAAQ;QACnB,KAAK,EAAE,QAAQ,CAAC,MAAM;QACtB,MAAM,EAAE,aAAa;QACrB,IAAI,EAAE,QAAQ,CAAC,MAAM,KAAK,CAAC;YACzB,CAAC,CAAC,mGAAmG;YACrG,CAAC,CAAC,GAAG,QAAQ,CAAC,MAAM,YAAY,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,+BAA+B;KAClG,CAAC;AACJ,CAAC"}
@@ -30,5 +30,12 @@ export declare const getContextTool: {
30
30
  /**
31
31
  * Execute the get_context tool
32
32
  */
33
- export declare function executeGetContext(db: FourDADatabase, params: GetContextParams): UserContext;
33
+ export declare function executeGetContext(db: FourDADatabase, params: GetContextParams): UserContext & {
34
+ resolved_dependencies?: Array<{
35
+ name: string;
36
+ version: string | null;
37
+ ecosystem: string;
38
+ isDev: boolean;
39
+ }>;
40
+ };
34
41
  //# sourceMappingURL=get-context.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"get-context.d.ts","sourceRoot":"","sources":["../../src/tools/get-context.ts"],"names":[],"mappings":"AACA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEjE;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;CA2B1B,CAAC;AAEF;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,cAAc,EAClB,MAAM,EAAE,gBAAgB,GACvB,WAAW,CAKb"}
1
+ {"version":3,"file":"get-context.d.ts","sourceRoot":"","sources":["../../src/tools/get-context.ts"],"names":[],"mappings":"AACA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAGjE;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;CA2B1B,CAAC;AAEF;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,cAAc,EAClB,MAAM,EAAE,gBAAgB,GACvB,WAAW,GAAG;IAAE,qBAAqB,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC,CAAA;CAAE,CAuB9H"}
@@ -4,6 +4,7 @@
4
4
  *
5
5
  * Get the user's context (what 4DA knows about them).
6
6
  */
7
+ import { getLiveIntelligence } from "../live-singleton.js";
7
8
  /**
8
9
  * Tool definition for MCP registration
9
10
  */
@@ -39,6 +40,22 @@ Use this to understand what the user is working on and interested in.`,
39
40
  export function executeGetContext(db, params) {
40
41
  const includeAce = params.include_ace ?? true;
41
42
  const includeLearned = params.include_learned ?? true;
42
- return db.getUserContext(includeAce, includeLearned);
43
+ const context = db.getUserContext(includeAce, includeLearned);
44
+ const liveIntel = getLiveIntelligence();
45
+ if (liveIntel) {
46
+ const deps = liveIntel.getResolvedDeps();
47
+ if (deps.length > 0) {
48
+ return {
49
+ ...context,
50
+ resolved_dependencies: deps.map((d) => ({
51
+ name: d.name,
52
+ version: d.version,
53
+ ecosystem: d.ecosystem,
54
+ isDev: d.isDev,
55
+ })),
56
+ };
57
+ }
58
+ }
59
+ return context;
43
60
  }
44
61
  //# sourceMappingURL=get-context.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"get-context.js","sourceRoot":"","sources":["../../src/tools/get-context.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C;;;;GAIG;AAKH;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,IAAI,EAAE,aAAa;IACnB,WAAW,EAAE;;;;;;;sEAOuD;IACpE,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,WAAW,EAAE;gBACX,IAAI,EAAE,SAAS;gBACf,WAAW,EACT,4EAA4E;gBAC9E,OAAO,EAAE,IAAI;aACd;YACD,eAAe,EAAE;gBACf,IAAI,EAAE,SAAS;gBACf,WAAW,EACT,4EAA4E;gBAC9E,OAAO,EAAE,IAAI;aACd;SACF;KACF;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,EAAkB,EAClB,MAAwB;IAExB,MAAM,UAAU,GAAG,MAAM,CAAC,WAAW,IAAI,IAAI,CAAC;IAC9C,MAAM,cAAc,GAAG,MAAM,CAAC,eAAe,IAAI,IAAI,CAAC;IAEtD,OAAO,EAAE,CAAC,cAAc,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;AACvD,CAAC"}
1
+ {"version":3,"file":"get-context.js","sourceRoot":"","sources":["../../src/tools/get-context.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C;;;;GAIG;AAIH,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE3D;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,IAAI,EAAE,aAAa;IACnB,WAAW,EAAE;;;;;;;sEAOuD;IACpE,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,WAAW,EAAE;gBACX,IAAI,EAAE,SAAS;gBACf,WAAW,EACT,4EAA4E;gBAC9E,OAAO,EAAE,IAAI;aACd;YACD,eAAe,EAAE;gBACf,IAAI,EAAE,SAAS;gBACf,WAAW,EACT,4EAA4E;gBAC9E,OAAO,EAAE,IAAI;aACd;SACF;KACF;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,EAAkB,EAClB,MAAwB;IAExB,MAAM,UAAU,GAAG,MAAM,CAAC,WAAW,IAAI,IAAI,CAAC;IAC9C,MAAM,cAAc,GAAG,MAAM,CAAC,eAAe,IAAI,IAAI,CAAC;IAEtD,MAAM,OAAO,GAAG,EAAE,CAAC,cAAc,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;IAE9D,MAAM,SAAS,GAAG,mBAAmB,EAAE,CAAC;IACxC,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,IAAI,GAAG,SAAS,CAAC,eAAe,EAAE,CAAC;QACzC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpB,OAAO;gBACL,GAAG,OAAO;gBACV,qBAAqB,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBACtC,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,OAAO,EAAE,CAAC,CAAC,OAAO;oBAClB,SAAS,EAAE,CAAC,CAAC,SAAS;oBACtB,KAAK,EAAE,CAAC,CAAC,KAAK;iBACf,CAAC,CAAC;aACJ,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}
@@ -47,4 +47,7 @@ export { whatShouldIKnowTool, executeWhatShouldIKnow, } from "./what-should-i-kn
47
47
  export { trustSummaryTool, executeTrustSummary, } from "./trust-summary.js";
48
48
  export { preemptionFeedTool, executePreemptionFeed, } from "./preemption-feed.js";
49
49
  export { vulnerabilityScanTool, executeVulnerabilityScan, } from "./vulnerability-scan.js";
50
+ export { ecosystemPulseTool, executeEcosystemPulse, } from "./ecosystem-pulse.js";
51
+ export { dependencyHealthTool, executeDependencyHealth, } from "./dependency-health.js";
52
+ export { upgradePlannerTool, executeUpgradePlanner, } from "./upgrade-planner.js";
50
53
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"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"}
@@ -60,4 +60,7 @@ export { trustSummaryTool, executeTrustSummary, } from "./trust-summary.js";
60
60
  export { preemptionFeedTool, executePreemptionFeed, } from "./preemption-feed.js";
61
61
  // Live Intelligence Tools
62
62
  export { vulnerabilityScanTool, executeVulnerabilityScan, } from "./vulnerability-scan.js";
63
+ export { ecosystemPulseTool, executeEcosystemPulse, } from "./ecosystem-pulse.js";
64
+ export { dependencyHealthTool, executeDependencyHealth, } from "./dependency-health.js";
65
+ export { upgradePlannerTool, executeUpgradePlanner, } from "./upgrade-planner.js";
63
66
  //# sourceMappingURL=index.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,59 @@
1
+ /**
2
+ * upgrade_planner tool
3
+ *
4
+ * Ranked upgrade recommendations for project dependencies.
5
+ * Combines version freshness, vulnerability data, and deprecation status
6
+ * to produce a prioritized upgrade plan.
7
+ */
8
+ import type { FourDADatabase } from "../db.js";
9
+ import type { LiveIntelligence } from "../live/index.js";
10
+ export interface UpgradePlannerParams {
11
+ include_dev?: boolean;
12
+ max_recommendations?: number;
13
+ risk_threshold?: "all" | "low" | "medium" | "high" | "critical";
14
+ }
15
+ interface UpgradeRecommendation {
16
+ package: string;
17
+ ecosystem: string;
18
+ currentVersion: string | null;
19
+ targetVersion: string | null;
20
+ upgradeType: "patch" | "minor" | "major" | "unknown";
21
+ risk: "low" | "medium" | "high" | "critical";
22
+ reasons: string[];
23
+ breaking: boolean;
24
+ isDev: boolean;
25
+ }
26
+ interface UpgradePlanResult {
27
+ generatedAt: string;
28
+ projectPath: string;
29
+ totalDeps: number;
30
+ recommendations: UpgradeRecommendation[];
31
+ summary: string;
32
+ quickWins: number;
33
+ breakingChanges: number;
34
+ }
35
+ export declare const upgradePlannerTool: {
36
+ name: string;
37
+ description: string;
38
+ inputSchema: {
39
+ type: "object";
40
+ properties: {
41
+ include_dev: {
42
+ type: string;
43
+ description: string;
44
+ };
45
+ max_recommendations: {
46
+ type: string;
47
+ description: string;
48
+ };
49
+ risk_threshold: {
50
+ type: string;
51
+ enum: string[];
52
+ description: string;
53
+ };
54
+ };
55
+ };
56
+ };
57
+ export declare function executeUpgradePlanner(_db: FourDADatabase, params: UpgradePlannerParams, liveIntel: LiveIntelligence | null): Promise<UpgradePlanResult>;
58
+ export {};
59
+ //# sourceMappingURL=upgrade-planner.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"upgrade-planner.d.ts","sourceRoot":"","sources":["../../src/tools/upgrade-planner.ts"],"names":[],"mappings":"AACA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEzD,MAAM,WAAW,oBAAoB;IACnC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,cAAc,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;CACjE;AAED,UAAU,qBAAqB;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,WAAW,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,SAAS,CAAC;IACrD,IAAI,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;IAC7C,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,UAAU,iBAAiB;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,qBAAqB,EAAE,CAAC;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;CAsB9B,CAAC;AAEF,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,cAAc,EACnB,MAAM,EAAE,oBAAoB,EAC5B,SAAS,EAAE,gBAAgB,GAAG,IAAI,GACjC,OAAO,CAAC,iBAAiB,CAAC,CA0I5B"}
@@ -0,0 +1,167 @@
1
+ // SPDX-License-Identifier: FSL-1.1-Apache-2.0
2
+ /**
3
+ * upgrade_planner tool
4
+ *
5
+ * Ranked upgrade recommendations for project dependencies.
6
+ * Combines version freshness, vulnerability data, and deprecation status
7
+ * to produce a prioritized upgrade plan.
8
+ */
9
+ export const upgradePlannerTool = {
10
+ name: "upgrade_planner",
11
+ description: "Ranked upgrade recommendations for dependencies. Prioritizes by vulnerability severity, deprecation, and version distance. Shows quick wins (patch/minor) vs breaking changes (major).",
12
+ inputSchema: {
13
+ type: "object",
14
+ properties: {
15
+ include_dev: {
16
+ type: "boolean",
17
+ description: "Include devDependencies. Default: false",
18
+ },
19
+ max_recommendations: {
20
+ type: "number",
21
+ description: "Max recommendations to return. Default: 20",
22
+ },
23
+ risk_threshold: {
24
+ type: "string",
25
+ enum: ["all", "low", "medium", "high", "critical"],
26
+ description: "Only show upgrades at or above this risk level. Default: all",
27
+ },
28
+ },
29
+ },
30
+ };
31
+ export async function executeUpgradePlanner(_db, params, liveIntel) {
32
+ if (!liveIntel || !liveIntel.isInitialized()) {
33
+ return {
34
+ generatedAt: new Date().toISOString(),
35
+ projectPath: process.cwd(),
36
+ totalDeps: 0,
37
+ recommendations: [],
38
+ summary: "No project detected. Run from a directory with package.json, Cargo.toml, pyproject.toml, or go.mod.",
39
+ quickWins: 0,
40
+ breakingChanges: 0,
41
+ };
42
+ }
43
+ const includeDev = params.include_dev ?? false;
44
+ let deps = liveIntel.getResolvedDeps();
45
+ if (!includeDev)
46
+ deps = deps.filter((d) => !d.isDev);
47
+ // Fetch registry data
48
+ const registryData = await liveIntel.fetchRegistryHealth(deps);
49
+ // Get vulnerability data
50
+ const vulnResult = liveIntel.getVulnerabilities();
51
+ const vulnsByPackage = new Map();
52
+ if (vulnResult) {
53
+ for (const v of vulnResult.vulnerabilities) {
54
+ if (!vulnsByPackage.has(v.package))
55
+ vulnsByPackage.set(v.package, []);
56
+ vulnsByPackage.get(v.package).push({
57
+ severity: v.severity,
58
+ vulnId: v.vulnId,
59
+ summary: v.summary,
60
+ fixedVersion: v.fixedVersion,
61
+ });
62
+ }
63
+ }
64
+ // Build recommendations
65
+ const recommendations = [];
66
+ for (const dep of registryData) {
67
+ const reasons = [];
68
+ let risk = "low";
69
+ let targetVersion = dep.latestStableVersion || dep.latestVersion;
70
+ // Check vulnerabilities
71
+ const vulns = vulnsByPackage.get(dep.name);
72
+ if (vulns && vulns.length > 0) {
73
+ const hasCritical = vulns.some((v) => v.severity === "critical");
74
+ const hasHigh = vulns.some((v) => v.severity === "high");
75
+ if (hasCritical)
76
+ risk = "critical";
77
+ else if (hasHigh)
78
+ risk = "high";
79
+ else
80
+ risk = "medium";
81
+ reasons.push(`${vulns.length} known CVE${vulns.length !== 1 ? "s" : ""} (${vulns.map((v) => v.vulnId).join(", ")})`);
82
+ // Use fixed version as target if available
83
+ const fixedVersions = vulns.map((v) => v.fixedVersion).filter(Boolean);
84
+ if (fixedVersions.length > 0 && !targetVersion) {
85
+ targetVersion = fixedVersions[0];
86
+ }
87
+ }
88
+ // Check deprecation
89
+ if (dep.deprecated) {
90
+ if (risk === "low")
91
+ risk = "high";
92
+ reasons.push(dep.deprecationMessage ? `Deprecated: ${dep.deprecationMessage}` : "Package is deprecated");
93
+ }
94
+ // Check version distance
95
+ if (dep.versionsBehind) {
96
+ const d = dep.versionsBehind;
97
+ if (d.label === "major") {
98
+ reasons.push(`${d.major} major version${d.major !== 1 ? "s" : ""} behind`);
99
+ if (risk === "low")
100
+ risk = "medium";
101
+ }
102
+ else if (d.label === "minor") {
103
+ reasons.push(`${d.minor} minor version${d.minor !== 1 ? "s" : ""} behind`);
104
+ }
105
+ else if (d.label === "patch") {
106
+ reasons.push(`${d.patch} patch${d.patch !== 1 ? "es" : ""} behind`);
107
+ }
108
+ }
109
+ // Skip if no upgrade needed
110
+ if (reasons.length === 0)
111
+ continue;
112
+ if (dep.versionsBehind?.label === "up-to-date" && !dep.deprecated && !vulns)
113
+ continue;
114
+ const label = dep.versionsBehind?.label;
115
+ const upgradeType = !label || label === "up-to-date" ? "patch" : label;
116
+ recommendations.push({
117
+ package: dep.name,
118
+ ecosystem: dep.ecosystem,
119
+ currentVersion: dep.currentVersion,
120
+ targetVersion,
121
+ upgradeType,
122
+ risk,
123
+ reasons,
124
+ breaking: dep.versionsBehind?.label === "major",
125
+ isDev: dep.isDev,
126
+ });
127
+ }
128
+ // Filter by risk threshold
129
+ const riskLevels = { low: 0, medium: 1, high: 2, critical: 3 };
130
+ const threshold = params.risk_threshold ?? "all";
131
+ const filtered = threshold === "all"
132
+ ? recommendations
133
+ : recommendations.filter((r) => riskLevels[r.risk] >= riskLevels[threshold]);
134
+ // Sort: critical > high > medium > low, then by breaking (non-breaking first for quick wins)
135
+ filtered.sort((a, b) => {
136
+ const riskDiff = riskLevels[b.risk] - riskLevels[a.risk];
137
+ if (riskDiff !== 0)
138
+ return riskDiff;
139
+ if (a.breaking !== b.breaking)
140
+ return a.breaking ? 1 : -1;
141
+ return 0;
142
+ });
143
+ const maxRecs = params.max_recommendations ?? 20;
144
+ const limited = filtered.slice(0, maxRecs);
145
+ const quickWins = limited.filter((r) => !r.breaking).length;
146
+ const breakingChanges = limited.filter((r) => r.breaking).length;
147
+ // Summary
148
+ const parts = [];
149
+ parts.push(`${limited.length} upgrade${limited.length !== 1 ? "s" : ""} recommended`);
150
+ if (quickWins > 0)
151
+ parts.push(`${quickWins} quick win${quickWins !== 1 ? "s" : ""} (patch/minor)`);
152
+ if (breakingChanges > 0)
153
+ parts.push(`${breakingChanges} breaking change${breakingChanges !== 1 ? "s" : ""} (major)`);
154
+ const criticalCount = limited.filter((r) => r.risk === "critical").length;
155
+ if (criticalCount > 0)
156
+ parts.push(`${criticalCount} critical`);
157
+ return {
158
+ generatedAt: new Date().toISOString(),
159
+ projectPath: process.cwd(),
160
+ totalDeps: deps.length,
161
+ recommendations: limited,
162
+ summary: parts.join(". ") + ".",
163
+ quickWins,
164
+ breakingChanges,
165
+ };
166
+ }
167
+ //# sourceMappingURL=upgrade-planner.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"upgrade-planner.js","sourceRoot":"","sources":["../../src/tools/upgrade-planner.ts"],"names":[],"mappings":"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"}