@stackweld/core 0.2.0

package/dist/__tests__/stack-engine.test.js

@@ -0,0 +1,278 @@
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import { closeDatabase, getDatabase } from "../db/database.js";
+import { RulesEngine } from "../engine/rules-engine.js";
+import { StackEngine } from "../engine/stack-engine.js";
+// Minimal technology fixtures for testing
+function makeTech(overrides) {
+    return {
+        category: "backend",
+        description: "Test technology",
+        website: "https://example.com",
+        versions: [{ version: "1.0.0" }],
+        defaultVersion: "1.0.0",
+        requires: [],
+        incompatibleWith: [],
+        suggestedWith: [],
+        envVars: {},
+        configFiles: [],
+        lastVerified: "2026-01-01",
+        tags: [],
+        ...overrides,
+    };
+}
+const fakeTechs = [
+    makeTech({ id: "nodejs", name: "Node.js", category: "runtime" }),
+    makeTech({ id: "express", name: "Express", category: "backend", requires: ["nodejs"] }),
+    makeTech({ id: "postgresql", name: "PostgreSQL", category: "database", defaultPort: 5432 }),
+    makeTech({ id: "redis", name: "Redis", category: "service", defaultPort: 6379 }),
+];
+let tmpDbPath;
+let engine;
+beforeEach(() => {
+    // Use a temp file for the database so tests are isolated
+    const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "stackweld-test-"));
+    tmpDbPath = path.join(tmpDir, "test.db");
+    // Initialize the database at the temp path
+    getDatabase(tmpDbPath);
+    const rules = new RulesEngine(fakeTechs);
+    engine = new StackEngine(rules);
+});
+afterEach(() => {
+    closeDatabase();
+    // Clean up temp file
+    if (tmpDbPath && fs.existsSync(tmpDbPath)) {
+        const dir = path.dirname(tmpDbPath);
+        fs.rmSync(dir, { recursive: true, force: true });
+    }
+});
+describe("StackEngine", () => {
+    describe("create()", () => {
+        it("creates a stack and persists it", () => {
+            const { stack, validation } = engine.create({
+                name: "test-stack",
+                technologies: [{ technologyId: "nodejs", version: "1.0.0" }],
+            });
+            expect(validation.valid).toBe(true);
+            expect(stack.name).toBe("test-stack");
+            expect(stack.id).toBeTruthy();
+            expect(stack.version).toBe(1);
+            // Verify it's actually persisted
+            const retrieved = engine.get(stack.id);
+            expect(retrieved).not.toBeNull();
+            expect(retrieved?.name).toBe("test-stack");
+        });
+        it("auto-resolves dependencies", () => {
+            const { stack, validation } = engine.create({
+                name: "express-stack",
+                technologies: [{ technologyId: "express", version: "1.0.0" }],
+            });
+            expect(validation.valid).toBe(true);
+            // express requires nodejs, which should be auto-resolved
+            expect(validation.resolvedDependencies).toContain("nodejs");
+            const techIds = stack.technologies.map((t) => t.technologyId);
+            expect(techIds).toContain("express");
+            expect(techIds).toContain("nodejs");
+        });
+        it("assigns ports to technologies with defaultPort", () => {
+            const { stack, validation } = engine.create({
+                name: "db-stack",
+                technologies: [
+                    { technologyId: "postgresql", version: "1.0.0" },
+                    { technologyId: "redis", version: "1.0.0" },
+                ],
+            });
+            expect(validation.valid).toBe(true);
+            expect(validation.portAssignments.postgresql).toBe(5432);
+            expect(validation.portAssignments.redis).toBe(6379);
+        });
+        it("sets default profile to standard", () => {
+            const { stack } = engine.create({
+                name: "default-profile",
+                technologies: [{ technologyId: "nodejs", version: "1.0.0" }],
+            });
+            expect(stack.profile).toBe("standard");
+        });
+        it("sets tags when provided", () => {
+            const { stack } = engine.create({
+                name: "tagged-stack",
+                technologies: [{ technologyId: "nodejs", version: "1.0.0" }],
+                tags: ["test", "dev"],
+            });
+            expect(stack.tags).toEqual(["test", "dev"]);
+        });
+    });
+    describe("list()", () => {
+        it("returns empty array when no stacks exist", () => {
+            const stacks = engine.list();
+            expect(stacks).toEqual([]);
+        });
+        it("returns saved stacks", () => {
+            engine.create({
+                name: "stack-a",
+                technologies: [{ technologyId: "nodejs", version: "1.0.0" }],
+            });
+            engine.create({
+                name: "stack-b",
+                technologies: [{ technologyId: "redis", version: "1.0.0" }],
+            });
+            const stacks = engine.list();
+            expect(stacks.length).toBe(2);
+            const names = stacks.map((s) => s.name);
+            expect(names).toContain("stack-a");
+            expect(names).toContain("stack-b");
+        });
+    });
+    describe("get()", () => {
+        it("returns correct stack by ID", () => {
+            const { stack: created } = engine.create({
+                name: "get-test",
+                description: "Testing get",
+                technologies: [{ technologyId: "nodejs", version: "1.0.0" }],
+            });
+            const retrieved = engine.get(created.id);
+            expect(retrieved).not.toBeNull();
+            expect(retrieved?.id).toBe(created.id);
+            expect(retrieved?.name).toBe("get-test");
+            expect(retrieved?.description).toBe("Testing get");
+        });
+        it("returns null for non-existent ID", () => {
+            const result = engine.get("non-existent-uuid");
+            expect(result).toBeNull();
+        });
+        it("includes technologies in the returned stack", () => {
+            const { stack: created } = engine.create({
+                name: "tech-check",
+                technologies: [
+                    { technologyId: "postgresql", version: "1.0.0" },
+                    { technologyId: "redis", version: "1.0.0" },
+                ],
+            });
+            const retrieved = engine.get(created.id);
+            expect(retrieved?.technologies.length).toBe(2);
+            const ids = retrieved?.technologies.map((t) => t.technologyId);
+            expect(ids).toContain("postgresql");
+            expect(ids).toContain("redis");
+        });
+    });
+    describe("delete()", () => {
+        it("removes a stack", () => {
+            const { stack } = engine.create({
+                name: "to-delete",
+                technologies: [{ technologyId: "nodejs", version: "1.0.0" }],
+            });
+            const deleted = engine.delete(stack.id);
+            expect(deleted).toBe(true);
+            const retrieved = engine.get(stack.id);
+            expect(retrieved).toBeNull();
+        });
+        it("returns false for non-existent stack", () => {
+            const deleted = engine.delete("non-existent-uuid");
+            expect(deleted).toBe(false);
+        });
+        it("does not affect other stacks", () => {
+            const { stack: a } = engine.create({
+                name: "keep-me",
+                technologies: [{ technologyId: "nodejs", version: "1.0.0" }],
+            });
+            const { stack: b } = engine.create({
+                name: "delete-me",
+                technologies: [{ technologyId: "redis", version: "1.0.0" }],
+            });
+            engine.delete(b.id);
+            expect(engine.get(a.id)).not.toBeNull();
+            expect(engine.get(b.id)).toBeNull();
+        });
+    });
+    describe("update()", () => {
+        it("modifies stack fields", () => {
+            const { stack } = engine.create({
+                name: "original",
+                description: "original desc",
+                technologies: [{ technologyId: "nodejs", version: "1.0.0" }],
+            });
+            const result = engine.update(stack.id, {
+                name: "updated-name",
+                description: "new desc",
+            });
+            expect(result).not.toBeNull();
+            expect(result?.stack.name).toBe("updated-name");
+            expect(result?.stack.description).toBe("new desc");
+        });
+        it("increments version number on update", () => {
+            const { stack } = engine.create({
+                name: "versioned",
+                technologies: [{ technologyId: "nodejs", version: "1.0.0" }],
+            });
+            expect(stack.version).toBe(1);
+            const result = engine.update(stack.id, { name: "versioned-v2" });
+            expect(result?.stack.version).toBe(2);
+            const result2 = engine.update(stack.id, { name: "versioned-v3" });
+            expect(result2?.stack.version).toBe(3);
+        });
+        it("returns null for non-existent stack", () => {
+            const result = engine.update("non-existent", { name: "nope" });
+            expect(result).toBeNull();
+        });
+        it("updates technologies", () => {
+            const { stack } = engine.create({
+                name: "tech-update",
+                technologies: [{ technologyId: "nodejs", version: "1.0.0" }],
+            });
+            const result = engine.update(stack.id, {
+                technologies: [
+                    { technologyId: "nodejs", version: "1.0.0" },
+                    { technologyId: "redis", version: "1.0.0" },
+                ],
+            });
+            const techIds = result?.stack.technologies.map((t) => t.technologyId);
+            expect(techIds).toContain("nodejs");
+            expect(techIds).toContain("redis");
+        });
+    });
+    describe("version management", () => {
+        it("saves a version snapshot on create", () => {
+            const { stack } = engine.create({
+                name: "versioned-stack",
+                technologies: [{ technologyId: "nodejs", version: "1.0.0" }],
+            });
+            const history = engine.getVersionHistory(stack.id);
+            expect(history.length).toBe(1);
+            expect(history[0].version).toBe(1);
+            expect(history[0].changelog).toBe("Initial creation");
+            expect(history[0].snapshot.name).toBe("versioned-stack");
+        });
+        it("saves a version snapshot on update", () => {
+            const { stack } = engine.create({
+                name: "multi-version",
+                technologies: [{ technologyId: "nodejs", version: "1.0.0" }],
+            });
+            engine.update(stack.id, { name: "multi-version-v2" });
+            const history = engine.getVersionHistory(stack.id);
+            expect(history.length).toBe(2);
+            // Ordered by version DESC
+            expect(history[0].version).toBe(2);
+            expect(history[1].version).toBe(1);
+        });
+        it("returns empty history for non-existent stack", () => {
+            const history = engine.getVersionHistory("non-existent");
+            expect(history).toEqual([]);
+        });
+        it("version snapshot contains full stack data", () => {
+            const { stack } = engine.create({
+                name: "snapshot-check",
+                description: "checking snapshots",
+                technologies: [{ technologyId: "postgresql", version: "1.0.0" }],
+                tags: ["prod"],
+            });
+            const history = engine.getVersionHistory(stack.id);
+            const snapshot = history[0].snapshot;
+            expect(snapshot.name).toBe("snapshot-check");
+            expect(snapshot.description).toBe("checking snapshots");
+            expect(snapshot.tags).toEqual(["prod"]);
+        });
+    });
+});
+//# sourceMappingURL=stack-engine.test.js.map

package/dist/__tests__/stack-engine.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stack-engine.test.js","sourceRoot":"","sources":["../../src/__tests__/stack-engine.test.ts"],"names":[],"mappings":"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"}

package/dist/db/database.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Database — SQLite persistence layer for stacks, projects, and versions.
+ * Uses better-sqlite3 for synchronous, reliable access.
+ */
+import Database from "better-sqlite3";
+export declare function getDatabase(dbPath?: string): Database.Database;
+export declare function closeDatabase(): void;
+export declare function getDefaultDbPath(): string;
+//# sourceMappingURL=database.d.ts.map

package/dist/db/database.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../src/db/database.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AA+EtC,wBAAgB,WAAW,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAa9D;AAED,wBAAgB,aAAa,IAAI,IAAI,CAKpC;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAGzC"}

package/dist/db/database.js

@@ -0,0 +1,106 @@
+/**
+ * Database — SQLite persistence layer for stacks, projects, and versions.
+ * Uses better-sqlite3 for synchronous, reliable access.
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+import Database from "better-sqlite3";
+const SCHEMA = `
+CREATE TABLE IF NOT EXISTS stacks (
+  id TEXT PRIMARY KEY,
+  name TEXT NOT NULL UNIQUE,
+  description TEXT NOT NULL DEFAULT '',
+  profile TEXT NOT NULL DEFAULT 'standard',
+  version INTEGER NOT NULL DEFAULT 1,
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  updated_at TEXT NOT NULL DEFAULT (datetime('now')),
+  tags TEXT NOT NULL DEFAULT '[]'
+);
+
+CREATE TABLE IF NOT EXISTS stack_technologies (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  stack_id TEXT NOT NULL REFERENCES stacks(id) ON DELETE CASCADE,
+  technology_id TEXT NOT NULL,
+  version TEXT NOT NULL,
+  port INTEGER,
+  config TEXT DEFAULT '{}',
+  UNIQUE(stack_id, technology_id)
+);
+
+CREATE TABLE IF NOT EXISTS stack_versions (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  stack_id TEXT NOT NULL REFERENCES stacks(id) ON DELETE CASCADE,
+  version INTEGER NOT NULL,
+  changelog TEXT NOT NULL DEFAULT '',
+  snapshot TEXT NOT NULL,
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  UNIQUE(stack_id, version)
+);
+
+CREATE TABLE IF NOT EXISTS project_instances (
+  id TEXT PRIMARY KEY,
+  stack_id TEXT NOT NULL REFERENCES stacks(id),
+  name TEXT NOT NULL,
+  path TEXT NOT NULL,
+  template_id TEXT,
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  last_opened_at TEXT
+);
+
+CREATE TABLE IF NOT EXISTS project_services (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  project_id TEXT NOT NULL REFERENCES project_instances(id) ON DELETE CASCADE,
+  service_name TEXT NOT NULL,
+  technology_id TEXT,
+  port INTEGER,
+  docker_container_id TEXT,
+  status TEXT DEFAULT 'not_started',
+  UNIQUE(project_id, service_name)
+);
+
+CREATE TABLE IF NOT EXISTS user_tech_notes (
+  tech_id TEXT PRIMARY KEY,
+  rating INTEGER CHECK(rating >= 1 AND rating <= 5),
+  notes TEXT DEFAULT '',
+  last_used_at TEXT
+);
+
+CREATE INDEX IF NOT EXISTS idx_stack_tech_stack ON stack_technologies(stack_id);
+CREATE INDEX IF NOT EXISTS idx_stack_versions_stack ON stack_versions(stack_id);
+CREATE INDEX IF NOT EXISTS idx_projects_stack ON project_instances(stack_id);
+CREATE INDEX IF NOT EXISTS idx_project_services_project ON project_services(project_id);
+
+CREATE TABLE IF NOT EXISTS custom_templates (
+  id TEXT PRIMARY KEY,
+  name TEXT NOT NULL UNIQUE,
+  description TEXT NOT NULL DEFAULT '',
+  profile TEXT NOT NULL DEFAULT 'standard',
+  technology_ids TEXT NOT NULL DEFAULT '[]',
+  created_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+`;
+let db = null;
+export function getDatabase(dbPath) {
+    if (db)
+        return db;
+    const resolvedPath = dbPath || getDefaultDbPath();
+    const dir = path.dirname(resolvedPath);
+    if (!fs.existsSync(dir))
+        fs.mkdirSync(dir, { recursive: true });
+    db = new Database(resolvedPath);
+    db.pragma("journal_mode = WAL");
+    db.pragma("foreign_keys = ON");
+    db.exec(SCHEMA);
+    return db;
+}
+export function closeDatabase() {
+    if (db) {
+        db.close();
+        db = null;
+    }
+}
+export function getDefaultDbPath() {
+    const home = process.env.HOME || process.env.USERPROFILE || ".";
+    return path.join(home, ".stackweld", "stackweld.db");
+}
+//# sourceMappingURL=database.js.map

package/dist/db/database.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.js","sourceRoot":"","sources":["../../src/db/database.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAEtC,MAAM,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyEd,CAAC;AAEF,IAAI,EAAE,GAA6B,IAAI,CAAC;AAExC,MAAM,UAAU,WAAW,CAAC,MAAe;IACzC,IAAI,EAAE;QAAE,OAAO,EAAE,CAAC;IAElB,MAAM,YAAY,GAAG,MAAM,IAAI,gBAAgB,EAAE,CAAC;IAClD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IACvC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEhE,EAAE,GAAG,IAAI,QAAQ,CAAC,YAAY,CAAC,CAAC;IAChC,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;IAChC,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAC/B,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAEhB,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,IAAI,EAAE,EAAE,CAAC;QACP,EAAE,CAAC,KAAK,EAAE,CAAC;QACX,EAAE,GAAG,IAAI,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,GAAG,CAAC;IAChE,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,YAAY,EAAE,cAAc,CAAC,CAAC;AACvD,CAAC"}

package/dist/db/index.d.ts

@@ -0,0 +1,2 @@
+export { closeDatabase, getDatabase, getDefaultDbPath } from "./database.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/db/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/db/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC"}

package/dist/db/index.js

@@ -0,0 +1,2 @@
+export { closeDatabase, getDatabase, getDefaultDbPath } from "./database.js";
+//# sourceMappingURL=index.js.map

package/dist/db/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/db/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC"}

package/dist/engine/compatibility-scorer.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Compatibility Scorer — Calculates a 0-100 score for technology combinations.
+ * Goes beyond binary compatible/incompatible to show nuanced pairing quality.
+ */
+import type { Technology } from "../types/index.js";
+export interface CompatibilityResult {
+  score: number;
+  grade: "S" | "A" | "B" | "C" | "D" | "F";
+  factors: CompatibilityFactor[];
+  recommendation: string;
+}
+export interface CompatibilityFactor {
+  label: string;
+  points: number;
+  description: string;
+}
+export interface StackScoreResult {
+  overall: number;
+  grade: string;
+  pairs: Array<{
+    a: string;
+    b: string;
+    score: number;
+  }>;
+}
+/**
+ * Score the compatibility between two technologies (0-100).
+ */
+export declare function scoreCompatibility(
+  techA: Technology,
+  techB: Technology,
+): CompatibilityResult;
+/**
+ * Score an entire stack by evaluating all unique pairs.
+ */
+export declare function scoreStack(technologies: Technology[]): StackScoreResult;
+//# sourceMappingURL=compatibility-scorer.d.ts.map

package/dist/engine/compatibility-scorer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compatibility-scorer.d.ts","sourceRoot":"","sources":["../../src/engine/compatibility-scorer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;IACzC,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,KAAK,CAAC;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACvD;AA2DD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,GAAG,mBAAmB,CAwG5F;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,YAAY,EAAE,UAAU,EAAE,GAAG,gBAAgB,CA0BvE"}

package/dist/engine/compatibility-scorer.js

@@ -0,0 +1,178 @@
+/**
+ * Compatibility Scorer — Calculates a 0-100 score for technology combinations.
+ * Goes beyond binary compatible/incompatible to show nuanced pairing quality.
+ */
+// ─── Complementary category pairs ─────────────────────
+const COMPLEMENTARY_PAIRS = new Set([
+    "frontend:backend",
+    "backend:frontend",
+    "database:orm",
+    "orm:database",
+    "frontend:styling",
+    "styling:frontend",
+    "frontend:orm",
+    "orm:frontend",
+    "backend:database",
+    "database:backend",
+    "runtime:frontend",
+    "frontend:runtime",
+    "runtime:backend",
+    "backend:runtime",
+    "backend:auth",
+    "auth:backend",
+    "frontend:auth",
+    "auth:frontend",
+]);
+// ─── Grade thresholds & recommendations ───────────────
+function getGrade(score) {
+    if (score >= 90)
+        return "S";
+    if (score >= 75)
+        return "A";
+    if (score >= 60)
+        return "B";
+    if (score >= 45)
+        return "C";
+    if (score >= 25)
+        return "D";
+    return "F";
+}
+const RECOMMENDATIONS = {
+    S: "Excellent combination — these technologies are designed to work together.",
+    A: "Strong pairing with good ecosystem support.",
+    B: "Compatible — works well with minor configuration needed.",
+    C: "Neutral — no known issues but limited synergy.",
+    D: "Weak pairing — consider alternatives.",
+    F: "Incompatible — these technologies conflict.",
+};
+// ─── Runtime detection ────────────────────────────────
+function getRuntime(tech) {
+    if (tech.category === "runtime")
+        return tech.id;
+    for (const req of tech.requires) {
+        if (["nodejs", "python", "go", "rust", "php", "bun", "deno"].includes(req)) {
+            return req;
+        }
+    }
+    return null;
+}
+// ─── Core scoring ─────────────────────────────────────
+/**
+ * Score the compatibility between two technologies (0-100).
+ */
+export function scoreCompatibility(techA, techB) {
+    const factors = [];
+    let score = 50; // neutral baseline
+    // +25 if suggested pairing (either direction)
+    const aSuggestsB = techA.suggestedWith.includes(techB.id);
+    const bSuggestsA = techB.suggestedWith.includes(techA.id);
+    if (aSuggestsB || bSuggestsA) {
+        factors.push({
+            label: "Suggested pairing",
+            points: 25,
+            description: aSuggestsB && bSuggestsA
+                ? `${techA.name} and ${techB.name} mutually recommend each other`
+                : aSuggestsB
+                    ? `${techA.name} suggests ${techB.name}`
+                    : `${techB.name} suggests ${techA.name}`,
+        });
+        score += 25;
+    }
+    // +15 if shared runtime
+    const runtimeA = getRuntime(techA);
+    const runtimeB = getRuntime(techB);
+    if (runtimeA && runtimeB && runtimeA === runtimeB && techA.id !== techB.id) {
+        const runtimeName = runtimeA === "nodejs" ? "Node.js" : runtimeA;
+        factors.push({
+            label: "Shared runtime",
+            points: 15,
+            description: `Both use ${runtimeName}`,
+        });
+        score += 15;
+    }
+    // +10 if complementary categories
+    const catPair = `${techA.category}:${techB.category}`;
+    if (COMPLEMENTARY_PAIRS.has(catPair)) {
+        factors.push({
+            label: "Complementary categories",
+            points: 10,
+            description: `${techA.category} + ${techB.category}`,
+        });
+        score += 10;
+    }
+    // -50 if incompatible (either direction) — applied after positives, then clamp
+    const aIncompatB = techA.incompatibleWith.includes(techB.id);
+    const bIncompatA = techB.incompatibleWith.includes(techA.id);
+    if (aIncompatB || bIncompatA) {
+        factors.push({
+            label: "Incompatible",
+            points: -50,
+            description: aIncompatB && bIncompatA
+                ? `${techA.name} and ${techB.name} are mutually incompatible`
+                : aIncompatB
+                    ? `${techA.name} lists ${techB.name} as incompatible`
+                    : `${techB.name} lists ${techA.name} as incompatible`,
+        });
+        score -= 50;
+    }
+    // -15 if same category AND same runtime (competing technologies)
+    if (techA.category === techB.category &&
+        techA.id !== techB.id &&
+        runtimeA &&
+        runtimeB &&
+        runtimeA === runtimeB) {
+        factors.push({
+            label: "Same category and runtime",
+            points: -15,
+            description: `Both are ${techA.category} technologies for ${runtimeA === "nodejs" ? "Node.js" : runtimeA}`,
+        });
+        score -= 15;
+    }
+    // -5 if same default port (minor conflict)
+    if (techA.defaultPort &&
+        techB.defaultPort &&
+        techA.defaultPort === techB.defaultPort &&
+        techA.id !== techB.id) {
+        factors.push({
+            label: "Port conflict",
+            points: -5,
+            description: `Both default to port ${techA.defaultPort}`,
+        });
+        score -= 5;
+    }
+    // Clamp
+    score = Math.max(0, Math.min(100, score));
+    const grade = getGrade(score);
+    return {
+        score,
+        grade,
+        factors,
+        recommendation: RECOMMENDATIONS[grade],
+    };
+}
+/**
+ * Score an entire stack by evaluating all unique pairs.
+ */
+export function scoreStack(technologies) {
+    if (technologies.length < 2) {
+        return { overall: 100, grade: "S", pairs: [] };
+    }
+    const pairs = [];
+    for (let i = 0; i < technologies.length; i++) {
+        for (let j = i + 1; j < technologies.length; j++) {
+            const result = scoreCompatibility(technologies[i], technologies[j]);
+            pairs.push({
+                a: technologies[i].id,
+                b: technologies[j].id,
+                score: result.score,
+            });
+        }
+    }
+    const overall = pairs.length > 0 ? Math.round(pairs.reduce((sum, p) => sum + p.score, 0) / pairs.length) : 100;
+    return {
+        overall,
+        grade: getGrade(overall),
+        pairs,
+    };
+}
+//# sourceMappingURL=compatibility-scorer.js.map