@stackweld/core 0.2.0

package/dist/__tests__/compatibility-scorer.test.js

@@ -0,0 +1,226 @@
+import { describe, expect, it } from "vitest";
+import { scoreCompatibility, scoreStack } from "../engine/compatibility-scorer.js";
+// ─── Test fixtures ────────────────────────────────────
+function makeTech(overrides) {
+    return {
+        description: "",
+        website: "",
+        versions: [{ version: "1" }],
+        defaultVersion: "1",
+        requires: [],
+        incompatibleWith: [],
+        suggestedWith: [],
+        envVars: {},
+        configFiles: [],
+        lastVerified: "2026-03-22",
+        tags: [],
+        ...overrides,
+    };
+}
+const nodejs = makeTech({
+    id: "nodejs",
+    name: "Node.js",
+    category: "runtime",
+    defaultPort: 3000,
+    suggestedWith: ["typescript"],
+});
+const nextjs = makeTech({
+    id: "nextjs",
+    name: "Next.js",
+    category: "frontend",
+    defaultPort: 3000,
+    requires: ["nodejs", "react"],
+    incompatibleWith: ["nuxt", "sveltekit", "remix", "astro", "angular", "qwik", "solidjs"],
+    suggestedWith: ["typescript", "tailwindcss", "prisma"],
+});
+const nuxt = makeTech({
+    id: "nuxt",
+    name: "Nuxt",
+    category: "frontend",
+    defaultPort: 3000,
+    requires: ["nodejs"],
+    incompatibleWith: ["nextjs"],
+});
+const react = makeTech({
+    id: "react",
+    name: "React",
+    category: "frontend",
+    defaultPort: 3000,
+    requires: ["nodejs"],
+    suggestedWith: ["tailwindcss"],
+});
+const tailwindcss = makeTech({
+    id: "tailwindcss",
+    name: "Tailwind CSS",
+    category: "styling",
+    requires: ["nodejs"],
+    suggestedWith: ["react", "nextjs", "vue"],
+});
+const prisma = makeTech({
+    id: "prisma",
+    name: "Prisma ORM",
+    category: "orm",
+    requires: ["nodejs"],
+    incompatibleWith: ["typeorm", "drizzle", "mongoose"],
+    suggestedWith: ["postgresql", "nextjs", "typescript"],
+});
+const express = makeTech({
+    id: "express",
+    name: "Express",
+    category: "backend",
+    defaultPort: 3001,
+    requires: ["nodejs"],
+    incompatibleWith: ["nestjs", "hono", "fastify"],
+    suggestedWith: ["typescript", "postgresql"],
+});
+const fastify = makeTech({
+    id: "fastify",
+    name: "Fastify",
+    category: "backend",
+    defaultPort: 3001,
+    requires: ["nodejs"],
+    incompatibleWith: ["nestjs", "hono", "express"],
+    suggestedWith: ["typescript", "postgresql", "prisma"],
+});
+const postgresql = makeTech({
+    id: "postgresql",
+    name: "PostgreSQL",
+    category: "database",
+    defaultPort: 5432,
+    suggestedWith: ["prisma", "drizzle", "sqlalchemy"],
+});
+const redis = makeTech({
+    id: "redis",
+    name: "Redis",
+    category: "database",
+    defaultPort: 6379,
+});
+const typescript = makeTech({
+    id: "typescript",
+    name: "TypeScript",
+    category: "devops",
+    requires: [],
+});
+// ─── Tests ────────────────────────────────────────────
+describe("scoreCompatibility", () => {
+    it("scores nextjs + prisma high (suggested pairing, shared runtime, complementary)", () => {
+        const result = scoreCompatibility(nextjs, prisma);
+        // +25 suggested (nextjs suggests prisma OR prisma suggests nextjs)
+        // +15 shared runtime (both require nodejs)
+        // +10 complementary (frontend + orm)
+        expect(result.score).toBeGreaterThanOrEqual(75);
+        expect(["S", "A"]).toContain(result.grade);
+        expect(result.factors.some((f) => f.label === "Suggested pairing")).toBe(true);
+        expect(result.factors.some((f) => f.label === "Shared runtime")).toBe(true);
+        expect(result.factors.some((f) => f.label === "Complementary categories")).toBe(true);
+    });
+    it("scores nextjs + nuxt as 0 (incompatible)", () => {
+        const result = scoreCompatibility(nextjs, nuxt);
+        expect(result.score).toBe(0);
+        expect(result.grade).toBe("F");
+        expect(result.factors.some((f) => f.label === "Incompatible")).toBe(true);
+        expect(result.recommendation).toContain("Incompatible");
+    });
+    it("scores react + tailwindcss high (suggested, complementary)", () => {
+        const result = scoreCompatibility(react, tailwindcss);
+        // +25 suggested (both suggest each other)
+        // +15 shared runtime (both require nodejs)
+        // +10 complementary (frontend + styling)
+        expect(result.score).toBeGreaterThanOrEqual(75);
+        expect(["S", "A"]).toContain(result.grade);
+        expect(result.factors.some((f) => f.label === "Suggested pairing")).toBe(true);
+    });
+    it("scores express + fastify low (incompatible, same category, same runtime, same port)", () => {
+        const result = scoreCompatibility(express, fastify);
+        // -50 incompatible, -15 same category+runtime, -5 same port
+        expect(result.score).toBe(0); // clamped to 0
+        expect(result.grade).toBe("F");
+        expect(result.factors.some((f) => f.label === "Incompatible")).toBe(true);
+        expect(result.factors.some((f) => f.label === "Same category and runtime")).toBe(true);
+        expect(result.factors.some((f) => f.label === "Port conflict")).toBe(true);
+    });
+    it("scores postgresql + redis as neutral (both databases, different ports, no runtime overlap)", () => {
+        const result = scoreCompatibility(postgresql, redis);
+        // baseline 50, no shared runtime (neither requires a runtime), no suggested
+        // no incompatibility, no same runtime => no -15 penalty
+        expect(result.score).toBe(50);
+        expect(result.grade).toBe("C");
+    });
+    it("never exceeds 100", () => {
+        // Artificial case: two techs that suggest each other, share runtime, complementary
+        const techA = makeTech({
+            id: "superA",
+            name: "Super A",
+            category: "frontend",
+            requires: ["nodejs"],
+            suggestedWith: ["superB"],
+        });
+        const techB = makeTech({
+            id: "superB",
+            name: "Super B",
+            category: "backend",
+            requires: ["nodejs"],
+            suggestedWith: ["superA"],
+        });
+        const result = scoreCompatibility(techA, techB);
+        // 50 + 25 + 15 + 10 = 100
+        expect(result.score).toBeLessThanOrEqual(100);
+        expect(result.score).toBe(100);
+        expect(result.grade).toBe("S");
+    });
+    it("never goes below 0", () => {
+        const result = scoreCompatibility(express, fastify);
+        expect(result.score).toBeGreaterThanOrEqual(0);
+    });
+    it("returns correct grade boundaries", () => {
+        // S: 90-100 — test with a score of exactly 90
+        // We use nextjs + prisma which should give 50+25+15+10 = 100
+        const sResult = scoreCompatibility(nextjs, prisma);
+        expect(sResult.score).toBeGreaterThanOrEqual(90);
+        expect(sResult.grade).toBe("S");
+    });
+    it("includes a human-readable recommendation", () => {
+        const result = scoreCompatibility(nextjs, prisma);
+        expect(typeof result.recommendation).toBe("string");
+        expect(result.recommendation.length).toBeGreaterThan(0);
+    });
+});
+describe("scoreStack", () => {
+    it("returns perfect score for single technology", () => {
+        const result = scoreStack([nextjs]);
+        expect(result.overall).toBe(100);
+        expect(result.grade).toBe("S");
+        expect(result.pairs).toHaveLength(0);
+    });
+    it("scores a full stack with 5+ technologies", () => {
+        const stack = [nodejs, nextjs, prisma, postgresql, tailwindcss, typescript];
+        const result = scoreStack(stack);
+        // Should produce C(6,2) = 15 pairs
+        expect(result.pairs).toHaveLength(15);
+        // Overall should be the average of all pair scores
+        const expectedAvg = Math.round(result.pairs.reduce((s, p) => s + p.score, 0) / result.pairs.length);
+        expect(result.overall).toBe(expectedAvg);
+        // Should have a valid grade
+        expect(["S", "A", "B", "C", "D", "F"]).toContain(result.grade);
+    });
+    it("reflects bad pairings in overall score", () => {
+        // Include incompatible pair: nextjs + nuxt
+        const stack = [nodejs, nextjs, nuxt, postgresql];
+        const result = scoreStack(stack);
+        // The nextjs+nuxt pair should drag down the overall
+        const badPair = result.pairs.find((p) => (p.a === "nextjs" && p.b === "nuxt") || (p.a === "nuxt" && p.b === "nextjs"));
+        expect(badPair).toBeDefined();
+        expect(badPair?.score).toBe(0);
+        // Overall should be lower than a stack without incompatible techs
+        const goodStack = [nodejs, nextjs, postgresql];
+        const goodResult = scoreStack(goodStack);
+        expect(goodResult.overall).toBeGreaterThan(result.overall);
+    });
+    it("pair entries contain correct tech IDs", () => {
+        const result = scoreStack([express, postgresql]);
+        expect(result.pairs).toHaveLength(1);
+        expect(result.pairs[0].a).toBe("express");
+        expect(result.pairs[0].b).toBe("postgresql");
+    });
+});
+//# sourceMappingURL=compatibility-scorer.test.js.map

package/dist/__tests__/compatibility-scorer.test.js.map

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

package/dist/__tests__/rules-engine.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=rules-engine.test.d.ts.map

package/dist/__tests__/rules-engine.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules-engine.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/rules-engine.test.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,161 @@
+import { describe, expect, it } from "vitest";
+import { RulesEngine } from "../engine/rules-engine.js";
+const mockTechs = [
+    {
+        id: "nodejs",
+        name: "Node.js",
+        category: "runtime",
+        description: "",
+        website: "",
+        versions: [{ version: "22" }],
+        defaultVersion: "22",
+        defaultPort: 3000,
+        requires: [],
+        incompatibleWith: [],
+        suggestedWith: ["typescript"],
+        envVars: {},
+        configFiles: [],
+        lastVerified: "2026-03-22",
+        tags: [],
+    },
+    {
+        id: "nextjs",
+        name: "Next.js",
+        category: "frontend",
+        description: "",
+        website: "",
+        versions: [{ version: "15" }],
+        defaultVersion: "15",
+        defaultPort: 3000,
+        requires: ["nodejs", "react"],
+        incompatibleWith: ["nuxt"],
+        suggestedWith: ["typescript", "tailwindcss"],
+        envVars: {},
+        configFiles: [],
+        lastVerified: "2026-03-22",
+        tags: [],
+    },
+    {
+        id: "react",
+        name: "React",
+        category: "frontend",
+        description: "",
+        website: "",
+        versions: [{ version: "19" }],
+        defaultVersion: "19",
+        defaultPort: 3000,
+        requires: ["nodejs"],
+        incompatibleWith: [],
+        suggestedWith: [],
+        envVars: {},
+        configFiles: [],
+        lastVerified: "2026-03-22",
+        tags: [],
+    },
+    {
+        id: "nuxt",
+        name: "Nuxt",
+        category: "frontend",
+        description: "",
+        website: "",
+        versions: [{ version: "3" }],
+        defaultVersion: "3",
+        defaultPort: 3000,
+        requires: ["nodejs"],
+        incompatibleWith: ["nextjs"],
+        suggestedWith: [],
+        envVars: {},
+        configFiles: [],
+        lastVerified: "2026-03-22",
+        tags: [],
+    },
+    {
+        id: "postgresql",
+        name: "PostgreSQL",
+        category: "database",
+        description: "",
+        website: "",
+        versions: [{ version: "17" }],
+        defaultVersion: "17",
+        defaultPort: 5432,
+        requires: [],
+        incompatibleWith: [],
+        suggestedWith: [],
+        envVars: {},
+        configFiles: [],
+        lastVerified: "2026-03-22",
+        tags: [],
+    },
+    {
+        id: "typescript",
+        name: "TypeScript",
+        category: "devops",
+        description: "",
+        website: "",
+        versions: [{ version: "5" }],
+        defaultVersion: "5",
+        requires: [],
+        incompatibleWith: [],
+        suggestedWith: [],
+        envVars: {},
+        configFiles: [],
+        lastVerified: "2026-03-22",
+        tags: [],
+    },
+];
+describe("RulesEngine", () => {
+    const engine = new RulesEngine(mockTechs);
+    it("validates a simple valid stack", () => {
+        const selected = [
+            { technologyId: "nodejs", version: "22" },
+            { technologyId: "postgresql", version: "17" },
+        ];
+        const result = engine.validate(selected);
+        expect(result.valid).toBe(true);
+        expect(result.issues.filter((i) => i.severity === "error")).toHaveLength(0);
+    });
+    it("auto-resolves missing dependencies", () => {
+        const selected = [{ technologyId: "nextjs", version: "15" }];
+        const result = engine.validate(selected);
+        expect(result.resolvedDependencies).toContain("nodejs");
+        expect(result.resolvedDependencies).toContain("react");
+        expect(result.issues.some((i) => i.code === "AUTO_DEPENDENCY")).toBe(true);
+    });
+    it("detects incompatible technologies", () => {
+        const selected = [
+            { technologyId: "nodejs", version: "22" },
+            { technologyId: "nextjs", version: "15" },
+            { technologyId: "nuxt", version: "3" },
+        ];
+        const result = engine.validate(selected);
+        expect(result.valid).toBe(false);
+        expect(result.issues.some((i) => i.code === "INCOMPATIBLE")).toBe(true);
+    });
+    it("detects and resolves port conflicts", () => {
+        const selected = [
+            { technologyId: "nodejs", version: "22" },
+            { technologyId: "react", version: "19" },
+            { technologyId: "nextjs", version: "15" },
+        ];
+        const result = engine.validate(selected);
+        const ports = Object.values(result.portAssignments);
+        const uniquePorts = new Set(ports);
+        expect(ports.length).toBe(uniquePorts.size); // No duplicates
+    });
+    it("detects unknown technologies", () => {
+        const selected = [{ technologyId: "doesnotexist", version: "1" }];
+        const result = engine.validate(selected);
+        expect(result.valid).toBe(false);
+        expect(result.issues.some((i) => i.code === "UNKNOWN_TECHNOLOGY")).toBe(true);
+    });
+    it("returns suggestions for selected stack", () => {
+        const suggestions = engine.getSuggestions(["nodejs"]);
+        expect(suggestions.some((s) => s.id === "typescript")).toBe(true);
+    });
+    it("gets technologies by category", () => {
+        const frontends = engine.getByCategory("frontend");
+        expect(frontends.length).toBeGreaterThan(0);
+        expect(frontends.every((t) => t.category === "frontend")).toBe(true);
+    });
+});
+//# sourceMappingURL=rules-engine.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rules-engine.test.js","sourceRoot":"","sources":["../../src/__tests__/rules-engine.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAGxD,MAAM,SAAS,GAAiB;IAC9B;QACE,EAAE,EAAE,QAAQ;QACZ,IAAI,EAAE,SAAS;QACf,QAAQ,EAAE,SAAS;QACnB,WAAW,EAAE,EAAE;QACf,OAAO,EAAE,EAAE;QACX,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC7B,cAAc,EAAE,IAAI;QACpB,WAAW,EAAE,IAAI;QACjB,QAAQ,EAAE,EAAE;QACZ,gBAAgB,EAAE,EAAE;QACpB,aAAa,EAAE,CAAC,YAAY,CAAC;QAC7B,OAAO,EAAE,EAAE;QACX,WAAW,EAAE,EAAE;QACf,YAAY,EAAE,YAAY;QAC1B,IAAI,EAAE,EAAE;KACT;IACD;QACE,EAAE,EAAE,QAAQ;QACZ,IAAI,EAAE,SAAS;QACf,QAAQ,EAAE,UAAU;QACpB,WAAW,EAAE,EAAE;QACf,OAAO,EAAE,EAAE;QACX,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC7B,cAAc,EAAE,IAAI;QACpB,WAAW,EAAE,IAAI;QACjB,QAAQ,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC;QAC7B,gBAAgB,EAAE,CAAC,MAAM,CAAC;QAC1B,aAAa,EAAE,CAAC,YAAY,EAAE,aAAa,CAAC;QAC5C,OAAO,EAAE,EAAE;QACX,WAAW,EAAE,EAAE;QACf,YAAY,EAAE,YAAY;QAC1B,IAAI,EAAE,EAAE;KACT;IACD;QACE,EAAE,EAAE,OAAO;QACX,IAAI,EAAE,OAAO;QACb,QAAQ,EAAE,UAAU;QACpB,WAAW,EAAE,EAAE;QACf,OAAO,EAAE,EAAE;QACX,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC7B,cAAc,EAAE,IAAI;QACpB,WAAW,EAAE,IAAI;QACjB,QAAQ,EAAE,CAAC,QAAQ,CAAC;QACpB,gBAAgB,EAAE,EAAE;QACpB,aAAa,EAAE,EAAE;QACjB,OAAO,EAAE,EAAE;QACX,WAAW,EAAE,EAAE;QACf,YAAY,EAAE,YAAY;QAC1B,IAAI,EAAE,EAAE;KACT;IACD;QACE,EAAE,EAAE,MAAM;QACV,IAAI,EAAE,MAAM;QACZ,QAAQ,EAAE,UAAU;QACpB,WAAW,EAAE,EAAE;QACf,OAAO,EAAE,EAAE;QACX,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC;QAC5B,cAAc,EAAE,GAAG;QACnB,WAAW,EAAE,IAAI;QACjB,QAAQ,EAAE,CAAC,QAAQ,CAAC;QACpB,gBAAgB,EAAE,CAAC,QAAQ,CAAC;QAC5B,aAAa,EAAE,EAAE;QACjB,OAAO,EAAE,EAAE;QACX,WAAW,EAAE,EAAE;QACf,YAAY,EAAE,YAAY;QAC1B,IAAI,EAAE,EAAE;KACT;IACD;QACE,EAAE,EAAE,YAAY;QAChB,IAAI,EAAE,YAAY;QAClB,QAAQ,EAAE,UAAU;QACpB,WAAW,EAAE,EAAE;QACf,OAAO,EAAE,EAAE;QACX,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC7B,cAAc,EAAE,IAAI;QACpB,WAAW,EAAE,IAAI;QACjB,QAAQ,EAAE,EAAE;QACZ,gBAAgB,EAAE,EAAE;QACpB,aAAa,EAAE,EAAE;QACjB,OAAO,EAAE,EAAE;QACX,WAAW,EAAE,EAAE;QACf,YAAY,EAAE,YAAY;QAC1B,IAAI,EAAE,EAAE;KACT;IACD;QACE,EAAE,EAAE,YAAY;QAChB,IAAI,EAAE,YAAY;QAClB,QAAQ,EAAE,QAAQ;QAClB,WAAW,EAAE,EAAE;QACf,OAAO,EAAE,EAAE;QACX,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC;QAC5B,cAAc,EAAE,GAAG;QACnB,QAAQ,EAAE,EAAE;QACZ,gBAAgB,EAAE,EAAE;QACpB,aAAa,EAAE,EAAE;QACjB,OAAO,EAAE,EAAE;QACX,WAAW,EAAE,EAAE;QACf,YAAY,EAAE,YAAY;QAC1B,IAAI,EAAE,EAAE;KACT;CACF,CAAC;AAEF,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,SAAS,CAAC,CAAC;IAE1C,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,QAAQ,GAAsB;YAClC,EAAE,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE;YACzC,EAAE,YAAY,EAAE,YAAY,EAAE,OAAO,EAAE,IAAI,EAAE;SAC9C,CAAC;QACF,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACzC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAC9E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,MAAM,QAAQ,GAAsB,CAAC,EAAE,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAChF,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACzC,MAAM,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QACxD,MAAM,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QACvD,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,iBAAiB,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,QAAQ,GAAsB;YAClC,EAAE,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE;YACzC,EAAE,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE;YACzC,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE;SACvC,CAAC;QACF,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACzC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACjC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,QAAQ,GAAsB;YAClC,EAAE,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE;YACzC,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE;YACxC,EAAE,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE;SAC1C,CAAC;QACF,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACzC,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;QACpD,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;QACnC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,gBAAgB;IAC/D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,QAAQ,GAAsB,CAAC,EAAE,YAAY,EAAE,cAAc,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC;QACrF,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACzC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACjC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,oBAAoB,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,WAAW,GAAG,MAAM,CAAC,cAAc,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;QACtD,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,SAAS,GAAG,MAAM,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;QACnD,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;QAC5C,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/scaffold-orchestrator.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=scaffold-orchestrator.test.d.ts.map

package/dist/__tests__/scaffold-orchestrator.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold-orchestrator.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/scaffold-orchestrator.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/scaffold-orchestrator.test.js

@@ -0,0 +1,149 @@
+import { describe, expect, it } from "vitest";
+import { ScaffoldOrchestrator } from "../engine/scaffold-orchestrator.js";
+const mockTechs = [
+    {
+        id: "nodejs",
+        name: "Node.js",
+        category: "runtime",
+        description: "JavaScript runtime",
+        website: "https://nodejs.org",
+        versions: [{ version: "22" }],
+        defaultVersion: "22",
+        defaultPort: 3000,
+        requires: [],
+        incompatibleWith: [],
+        suggestedWith: [],
+        envVars: { NODE_ENV: "development", PORT: "3000" },
+        configFiles: ["package.json"],
+        lastVerified: "2026-03-22",
+        tags: ["nodejs"],
+    },
+    {
+        id: "postgresql",
+        name: "PostgreSQL",
+        category: "database",
+        description: "Relational database",
+        website: "https://postgresql.org",
+        versions: [{ version: "17" }],
+        defaultVersion: "17",
+        defaultPort: 5432,
+        requires: [],
+        incompatibleWith: [],
+        suggestedWith: [],
+        dockerImage: "postgres:17",
+        healthCheck: {
+            command: "pg_isready -U postgres",
+            interval: "5s",
+            timeout: "5s",
+            retries: 5,
+        },
+        envVars: {
+            POSTGRES_USER: "postgres",
+            POSTGRES_PASSWORD: "postgres",
+            POSTGRES_DB: "app",
+        },
+        configFiles: [],
+        lastVerified: "2026-03-22",
+        tags: ["postgresql"],
+    },
+    {
+        id: "redis",
+        name: "Redis",
+        category: "database",
+        description: "In-memory store",
+        website: "https://redis.io",
+        versions: [{ version: "7" }],
+        defaultVersion: "7",
+        defaultPort: 6379,
+        requires: [],
+        incompatibleWith: [],
+        suggestedWith: [],
+        dockerImage: "redis:7-alpine",
+        healthCheck: {
+            command: "redis-cli ping",
+            interval: "5s",
+            timeout: "5s",
+            retries: 5,
+        },
+        envVars: { REDIS_URL: "redis://localhost:6379/0" },
+        configFiles: [],
+        lastVerified: "2026-03-22",
+        tags: ["redis"],
+    },
+];
+const mockStack = {
+    id: "test-stack",
+    name: "Test Stack",
+    description: "A test stack",
+    profile: "standard",
+    technologies: [
+        { technologyId: "nodejs", version: "22", port: 3000 },
+        { technologyId: "postgresql", version: "17", port: 5432 },
+        { technologyId: "redis", version: "7", port: 6379 },
+    ],
+    createdAt: "2026-03-22T00:00:00Z",
+    updatedAt: "2026-03-22T00:00:00Z",
+    version: 1,
+    tags: ["test"],
+};
+describe("ScaffoldOrchestrator", () => {
+    const orchestrator = new ScaffoldOrchestrator(mockTechs);
+    it("generates all scaffold files", () => {
+        const output = orchestrator.generate(mockStack);
+        expect(output.dockerCompose).not.toBeNull();
+        expect(output.envExample).toBeTruthy();
+        expect(output.readme).toBeTruthy();
+        expect(output.gitignore).toBeTruthy();
+        expect(output.devcontainer).toBeTruthy();
+    });
+    it("generates docker-compose with correct services", () => {
+        const compose = orchestrator.generateDockerCompose(mockStack, mockTechs);
+        expect(compose).toContain("postgresql:");
+        expect(compose).toContain("image: postgres:17");
+        expect(compose).toContain("redis:");
+        expect(compose).toContain("image: redis:7-alpine");
+        expect(compose).toContain("5432:5432");
+        expect(compose).toContain("6379:6379");
+        expect(compose).toContain("pg_isready");
+        expect(compose).toContain("redis-cli ping");
+        expect(compose).toContain("volumes:");
+        // Should NOT include nodejs (no docker image)
+        expect(compose).not.toContain("nodejs:");
+    });
+    it("generates .env.example with all env vars", () => {
+        const env = orchestrator.generateEnvExample(mockStack, mockTechs);
+        expect(env).toContain("NODE_ENV=development");
+        expect(env).toContain("POSTGRES_USER=postgres");
+        expect(env).toContain("REDIS_URL=redis://localhost:6379/0");
+    });
+    it("generates README with stack table", () => {
+        const readme = orchestrator.generateReadme(mockStack, mockTechs);
+        expect(readme).toContain("# Test Stack");
+        expect(readme).toContain("Node.js");
+        expect(readme).toContain("PostgreSQL");
+        expect(readme).toContain("docker compose up");
+    });
+    it("generates .gitignore with relevant patterns", () => {
+        const gitignore = orchestrator.generateGitignore(mockTechs);
+        expect(gitignore).toContain("node_modules/");
+        expect(gitignore).toContain(".env");
+        expect(gitignore).toContain("*.db");
+    });
+    it("generates devcontainer.json", () => {
+        const devcontainer = JSON.parse(orchestrator.generateDevcontainer(mockStack, mockTechs));
+        expect(devcontainer.name).toBe("Test Stack");
+        expect(devcontainer.forwardPorts).toContain(3000);
+        expect(devcontainer.forwardPorts).toContain(5432);
+        expect(devcontainer.features).toHaveProperty("ghcr.io/devcontainers/features/node:1");
+        expect(devcontainer.features).toHaveProperty("ghcr.io/devcontainers/features/docker-in-docker:2");
+    });
+    it("returns null docker-compose when no docker services", () => {
+        const noDockerStack = {
+            ...mockStack,
+            technologies: [{ technologyId: "nodejs", version: "22", port: 3000 }],
+        };
+        const output = orchestrator.generate(noDockerStack);
+        expect(output.dockerCompose).toBeNull();
+    });
+});
+//# sourceMappingURL=scaffold-orchestrator.test.js.map

package/dist/__tests__/scaffold-orchestrator.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold-orchestrator.test.js","sourceRoot":"","sources":["../../src/__tests__/scaffold-orchestrator.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAG1E,MAAM,SAAS,GAAiB;IAC9B;QACE,EAAE,EAAE,QAAQ;QACZ,IAAI,EAAE,SAAS;QACf,QAAQ,EAAE,SAAS;QACnB,WAAW,EAAE,oBAAoB;QACjC,OAAO,EAAE,oBAAoB;QAC7B,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC7B,cAAc,EAAE,IAAI;QACpB,WAAW,EAAE,IAAI;QACjB,QAAQ,EAAE,EAAE;QACZ,gBAAgB,EAAE,EAAE;QACpB,aAAa,EAAE,EAAE;QACjB,OAAO,EAAE,EAAE,QAAQ,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE;QAClD,WAAW,EAAE,CAAC,cAAc,CAAC;QAC7B,YAAY,EAAE,YAAY;QAC1B,IAAI,EAAE,CAAC,QAAQ,CAAC;KACjB;IACD;QACE,EAAE,EAAE,YAAY;QAChB,IAAI,EAAE,YAAY;QAClB,QAAQ,EAAE,UAAU;QACpB,WAAW,EAAE,qBAAqB;QAClC,OAAO,EAAE,wBAAwB;QACjC,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC7B,cAAc,EAAE,IAAI;QACpB,WAAW,EAAE,IAAI;QACjB,QAAQ,EAAE,EAAE;QACZ,gBAAgB,EAAE,EAAE;QACpB,aAAa,EAAE,EAAE;QACjB,WAAW,EAAE,aAAa;QAC1B,WAAW,EAAE;YACX,OAAO,EAAE,wBAAwB;YACjC,QAAQ,EAAE,IAAI;YACd,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,CAAC;SACX;QACD,OAAO,EAAE;YACP,aAAa,EAAE,UAAU;YACzB,iBAAiB,EAAE,UAAU;YAC7B,WAAW,EAAE,KAAK;SACnB;QACD,WAAW,EAAE,EAAE;QACf,YAAY,EAAE,YAAY;QAC1B,IAAI,EAAE,CAAC,YAAY,CAAC;KACrB;IACD;QACE,EAAE,EAAE,OAAO;QACX,IAAI,EAAE,OAAO;QACb,QAAQ,EAAE,UAAU;QACpB,WAAW,EAAE,iBAAiB;QAC9B,OAAO,EAAE,kBAAkB;QAC3B,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC;QAC5B,cAAc,EAAE,GAAG;QACnB,WAAW,EAAE,IAAI;QACjB,QAAQ,EAAE,EAAE;QACZ,gBAAgB,EAAE,EAAE;QACpB,aAAa,EAAE,EAAE;QACjB,WAAW,EAAE,gBAAgB;QAC7B,WAAW,EAAE;YACX,OAAO,EAAE,gBAAgB;YACzB,QAAQ,EAAE,IAAI;YACd,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,CAAC;SACX;QACD,OAAO,EAAE,EAAE,SAAS,EAAE,0BAA0B,EAAE;QAClD,WAAW,EAAE,EAAE;QACf,YAAY,EAAE,YAAY;QAC1B,IAAI,EAAE,CAAC,OAAO,CAAC;KAChB;CACF,CAAC;AAEF,MAAM,SAAS,GAAoB;IACjC,EAAE,EAAE,YAAY;IAChB,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,cAAc;IAC3B,OAAO,EAAE,UAAU;IACnB,YAAY,EAAE;QACZ,EAAE,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE;QACrD,EAAE,YAAY,EAAE,YAAY,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE;QACzD,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE;KACpD;IACD,SAAS,EAAE,sBAAsB;IACjC,SAAS,EAAE,sBAAsB;IACjC,OAAO,EAAE,CAAC;IACV,IAAI,EAAE,CAAC,MAAM,CAAC;CACf,CAAC;AAEF,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;IACpC,MAAM,YAAY,GAAG,IAAI,oBAAoB,CAAC,SAAS,CAAC,CAAC;IAEzD,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QAChD,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;QAC5C,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,UAAU,EAAE,CAAC;QACvC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,CAAC;QACnC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,UAAU,EAAE,CAAC;QACtC,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,UAAU,EAAE,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,MAAM,OAAO,GAAG,YAAY,CAAC,qBAAqB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QACzE,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;QACzC,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAC;QAChD,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QACpC,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,uBAAuB,CAAC,CAAC;QACnD,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QACvC,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QACvC,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QACxC,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;QAC5C,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QACtC,8CAA8C;QAC9C,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,MAAM,GAAG,GAAG,YAAY,CAAC,kBAAkB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QAClE,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,sBAAsB,CAAC,CAAC;QAC9C,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,wBAAwB,CAAC,CAAC;QAChD,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,oCAAoC,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,MAAM,GAAG,YAAY,CAAC,cAAc,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QACjE,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;QACzC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QACpC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QACvC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,SAAS,GAAG,YAAY,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;QAC5D,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;QAC7C,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACpC,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,oBAAoB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC;QACzF,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC7C,MAAM,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAClD,MAAM,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAClD,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,cAAc,CAAC,uCAAuC,CAAC,CAAC;QACtF,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,cAAc,CAC1C,mDAAmD,CACpD,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC7D,MAAM,aAAa,GAAoB;YACrC,GAAG,SAAS;YACZ,YAAY,EAAE,CAAC,EAAE,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;SACtE,CAAC;QACF,MAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;QACpD,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC1C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/stack-engine.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=stack-engine.test.d.ts.map

package/dist/__tests__/stack-engine.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stack-engine.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/stack-engine.test.ts"],"names":[],"mappings":""}