@stacksfinder/mcp-server 1.0.0

package/dist/data/index.js

@@ -0,0 +1,203 @@
+import { createRequire } from 'module';
+import { findSimilar } from '../utils/errors.js';
+const require = createRequire(import.meta.url);
+// Load JSON data at module initialization
+const techScoresData = require('./technology_scores.json');
+const compatibilityData = require('./compatibility_matrix.json');
+/**
+ * Data version - update when syncing from source.
+ */
+export const DATA_VERSION = '2025.12.30';
+/**
+ * Score dimensions.
+ */
+export const SCORE_DIMENSIONS = ['perf', 'dx', 'ecosystem', 'maintain', 'cost', 'compliance'];
+/**
+ * Human-readable dimension names.
+ */
+export const DIMENSION_LABELS = {
+    perf: 'Performance',
+    dx: 'Developer Experience',
+    ecosystem: 'Ecosystem',
+    maintain: 'Maintainability',
+    cost: 'Cost Efficiency',
+    compliance: 'Compliance'
+};
+/**
+ * Technology categories.
+ */
+export const CATEGORIES = [
+    'frontend',
+    'backend',
+    'meta-framework',
+    'database',
+    'orm',
+    'auth',
+    'hosting',
+    'payments'
+];
+/**
+ * Score contexts.
+ */
+export const CONTEXTS = ['default', 'mvp', 'enterprise'];
+/**
+ * Get all technology IDs.
+ */
+export function getAllTechIds() {
+    return Object.keys(techScoresData.technologies);
+}
+/**
+ * Get a technology by ID.
+ */
+export function getTechnology(id) {
+    return techScoresData.technologies[id] || null;
+}
+/**
+ * Get all technologies.
+ */
+export function getAllTechnologies() {
+    return Object.values(techScoresData.technologies);
+}
+/**
+ * Get technologies by category.
+ */
+export function getTechnologiesByCategory(category) {
+    return getAllTechnologies().filter((tech) => tech.category === category);
+}
+/**
+ * Get technologies grouped by category.
+ */
+export function getTechnologiesGroupedByCategory() {
+    const grouped = {
+        frontend: [],
+        backend: [],
+        'meta-framework': [],
+        database: [],
+        orm: [],
+        auth: [],
+        hosting: [],
+        payments: []
+    };
+    for (const tech of getAllTechnologies()) {
+        if (tech.category in grouped) {
+            grouped[tech.category].push(tech);
+        }
+    }
+    return grouped;
+}
+/**
+ * Get scores for a technology in a specific context.
+ */
+export function getScores(techId, context = 'default') {
+    const tech = getTechnology(techId);
+    if (!tech)
+        return null;
+    return tech.scores[context] || tech.scores.default;
+}
+/**
+ * Calculate overall score (average of all dimensions).
+ */
+export function calculateOverallScore(scores) {
+    const sum = SCORE_DIMENSIONS.reduce((acc, dim) => acc + scores[dim], 0);
+    return Math.round(sum / SCORE_DIMENSIONS.length);
+}
+/**
+ * Get letter grade from score.
+ */
+export function scoreToGrade(score) {
+    if (score >= 97)
+        return 'A+';
+    if (score >= 93)
+        return 'A';
+    if (score >= 90)
+        return 'A-';
+    if (score >= 87)
+        return 'B+';
+    if (score >= 83)
+        return 'B';
+    if (score >= 80)
+        return 'B-';
+    if (score >= 77)
+        return 'C+';
+    if (score >= 73)
+        return 'C';
+    if (score >= 70)
+        return 'C-';
+    if (score >= 67)
+        return 'D+';
+    if (score >= 63)
+        return 'D';
+    if (score >= 60)
+        return 'D-';
+    return 'F';
+}
+/**
+ * Get compatibility score between two technologies.
+ * Returns 50 (neutral) if no direct compatibility is defined.
+ */
+export function getCompatibility(techA, techB) {
+    // Same tech is always compatible
+    if (techA === techB)
+        return 100;
+    // Check both directions
+    const scoreAB = compatibilityData.matrix[techA]?.[techB];
+    const scoreBA = compatibilityData.matrix[techB]?.[techA];
+    // Return defined score, preferring A→B
+    if (scoreAB !== undefined)
+        return scoreAB;
+    if (scoreBA !== undefined)
+        return scoreBA;
+    // Default to neutral
+    return 50;
+}
+/**
+ * Get compatibility verdict.
+ */
+export function getCompatibilityVerdict(score) {
+    if (score === 0)
+        return 'Incompatible';
+    if (score < 50)
+        return 'Poor';
+    if (score < 80)
+        return 'Acceptable';
+    if (score < 95)
+        return 'Good';
+    return 'Excellent';
+}
+/**
+ * Find compatible technologies for a given tech.
+ * Returns sorted by compatibility score (descending).
+ */
+export function findCompatibleTechs(techId, limit = 8) {
+    const allIds = getAllTechIds().filter((id) => id !== techId);
+    return allIds
+        .map((id) => ({
+        id,
+        score: getCompatibility(techId, id)
+    }))
+        .filter((item) => item.score > 50) // Only include acceptable+ compatibility
+        .sort((a, b) => b.score - a.score)
+        .slice(0, limit);
+}
+/**
+ * Find similar technology IDs using Levenshtein distance.
+ */
+export function findSimilarTechIds(input, limit = 3) {
+    return findSimilar(input, getAllTechIds(), limit);
+}
+/**
+ * Check if a technology ID exists.
+ */
+export function techExists(id) {
+    return id in techScoresData.technologies;
+}
+/**
+ * Get source data version from JSON files.
+ */
+export function getSourceDataVersion() {
+    return {
+        scores: techScoresData.$version,
+        compatibility: compatibilityData.$version
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/data/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/data/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAE/C,0CAA0C;AAC1C,MAAM,cAAc,GAAG,OAAO,CAAC,0BAA0B,CAAmB,CAAC;AAC7E,MAAM,iBAAiB,GAAG,OAAO,CAAC,6BAA6B,CAAsB,CAAC;AAEtF;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,YAAY,CAAC;AAEzC;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,EAAE,YAAY,CAAU,CAAC;AAGvG;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAmC;IAC/D,IAAI,EAAE,aAAa;IACnB,EAAE,EAAE,sBAAsB;IAC1B,SAAS,EAAE,WAAW;IACtB,QAAQ,EAAE,iBAAiB;IAC3B,IAAI,EAAE,iBAAiB;IACvB,UAAU,EAAE,YAAY;CACxB,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACzB,UAAU;IACV,SAAS;IACT,gBAAgB;IAChB,UAAU;IACV,KAAK;IACL,MAAM;IACN,SAAS;IACT,UAAU;CACD,CAAC;AAGX;;GAEG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,SAAS,EAAE,KAAK,EAAE,YAAY,CAAU,CAAC;AA4ClE;;GAEG;AACH,MAAM,UAAU,aAAa;IAC5B,OAAO,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC;AACjD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,EAAU;IACvC,OAAO,cAAc,CAAC,YAAY,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC;AAChD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB;IACjC,OAAO,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC;AACnD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB,CAAC,QAAkB;IAC3D,OAAO,kBAAkB,EAAE,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;AAC1E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gCAAgC;IAC/C,MAAM,OAAO,GAAiC;QAC7C,QAAQ,EAAE,EAAE;QACZ,OAAO,EAAE,EAAE;QACX,gBAAgB,EAAE,EAAE;QACpB,QAAQ,EAAE,EAAE;QACZ,GAAG,EAAE,EAAE;QACP,IAAI,EAAE,EAAE;QACR,OAAO,EAAE,EAAE;QACX,QAAQ,EAAE,EAAE;KACZ,CAAC;IAEF,KAAK,MAAM,IAAI,IAAI,kBAAkB,EAAE,EAAE,CAAC;QACzC,IAAI,IAAI,CAAC,QAAQ,IAAI,OAAO,EAAE,CAAC;YAC9B,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnC,CAAC;IACF,CAAC;IAED,OAAO,OAAO,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,MAAc,EAAE,UAAmB,SAAS;IACrE,MAAM,IAAI,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IACnC,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;AACpD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAc;IACnD,MAAM,GAAG,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IACxE,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;AAClD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,KAAa;IACzC,IAAI,KAAK,IAAI,EAAE;QAAE,OAAO,IAAI,CAAC;IAC7B,IAAI,KAAK,IAAI,EAAE;QAAE,OAAO,GAAG,CAAC;IAC5B,IAAI,KAAK,IAAI,EAAE;QAAE,OAAO,IAAI,CAAC;IAC7B,IAAI,KAAK,IAAI,EAAE;QAAE,OAAO,IAAI,CAAC;IAC7B,IAAI,KAAK,IAAI,EAAE;QAAE,OAAO,GAAG,CAAC;IAC5B,IAAI,KAAK,IAAI,EAAE;QAAE,OAAO,IAAI,CAAC;IAC7B,IAAI,KAAK,IAAI,EAAE;QAAE,OAAO,IAAI,CAAC;IAC7B,IAAI,KAAK,IAAI,EAAE;QAAE,OAAO,GAAG,CAAC;IAC5B,IAAI,KAAK,IAAI,EAAE;QAAE,OAAO,IAAI,CAAC;IAC7B,IAAI,KAAK,IAAI,EAAE;QAAE,OAAO,IAAI,CAAC;IAC7B,IAAI,KAAK,IAAI,EAAE;QAAE,OAAO,GAAG,CAAC;IAC5B,IAAI,KAAK,IAAI,EAAE;QAAE,OAAO,IAAI,CAAC;IAC7B,OAAO,GAAG,CAAC;AACZ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAa,EAAE,KAAa;IAC5D,iCAAiC;IACjC,IAAI,KAAK,KAAK,KAAK;QAAE,OAAO,GAAG,CAAC;IAEhC,wBAAwB;IACxB,MAAM,OAAO,GAAG,iBAAiB,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;IACzD,MAAM,OAAO,GAAG,iBAAiB,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;IAEzD,uCAAuC;IACvC,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,OAAO,CAAC;IAC1C,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,OAAO,CAAC;IAE1C,qBAAqB;IACrB,OAAO,EAAE,CAAC;AACX,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,KAAa;IACpD,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,cAAc,CAAC;IACvC,IAAI,KAAK,GAAG,EAAE;QAAE,OAAO,MAAM,CAAC;IAC9B,IAAI,KAAK,GAAG,EAAE;QAAE,OAAO,YAAY,CAAC;IACpC,IAAI,KAAK,GAAG,EAAE;QAAE,OAAO,MAAM,CAAC;IAC9B,OAAO,WAAW,CAAC;AACpB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAc,EAAE,KAAK,GAAG,CAAC;IAC5D,MAAM,MAAM,GAAG,aAAa,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC;IAE7D,OAAO,MAAM;SACX,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QACb,EAAE;QACF,KAAK,EAAE,gBAAgB,CAAC,MAAM,EAAE,EAAE,CAAC;KACnC,CAAC,CAAC;SACF,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC,yCAAyC;SAC3E,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;SACjC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAa,EAAE,KAAK,GAAG,CAAC;IAC1D,OAAO,WAAW,CAAC,KAAK,EAAE,aAAa,EAAE,EAAE,KAAK,CAAC,CAAC;AACnD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,EAAU;IACpC,OAAO,EAAE,IAAI,cAAc,CAAC,YAAY,CAAC;AAC1C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB;IACnC,OAAO;QACN,MAAM,EAAE,cAAc,CAAC,QAAQ;QAC/B,aAAa,EAAE,iBAAiB,CAAC,QAAQ;KACzC,CAAC;AACH,CAAC"}