@mcptoolshop/venvkit 0.2.5 → 1.0.0

package/dist/scanEnvPaths.test.js

@@ -0,0 +1,250 @@
+// scanEnvPaths.test.ts
+// Unit tests for environment path discovery
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import * as os from "node:os";
+import { scanEnvPaths } from "./scanEnvPaths.js";
+describe("scanEnvPaths", () => {
+    let tempDir;
+    beforeEach(async () => {
+        tempDir = await fs.mkdtemp(path.join(os.tmpdir(), "venvkit-scan-test-"));
+    });
+    afterEach(async () => {
+        await fs.rm(tempDir, { recursive: true, force: true });
+    });
+    // Helper to create a mock venv structure
+    async function createMockVenv(venvPath) {
+        await fs.mkdir(venvPath, { recursive: true });
+        await fs.writeFile(path.join(venvPath, "pyvenv.cfg"), "home = C:\\Python311\nversion = 3.11.5\n");
+        const binDir = os.platform() === "win32" ? "Scripts" : "bin";
+        const pyExe = os.platform() === "win32" ? "python.exe" : "python";
+        await fs.mkdir(path.join(venvPath, binDir), { recursive: true });
+        await fs.writeFile(path.join(venvPath, binDir, pyExe), "fake python");
+        return path.join(venvPath, binDir, pyExe);
+    }
+    describe("finding Python venvs", () => {
+        it("finds venv with pyvenv.cfg", async () => {
+            const venvPath = path.join(tempDir, "project", ".venv");
+            await createMockVenv(venvPath);
+            const result = await scanEnvPaths({
+                roots: [path.join(tempDir, "project")],
+                maxDepth: 3,
+                includeUserHomeCache: false,
+            });
+            expect(result.pythonPaths.length).toBeGreaterThanOrEqual(1);
+            expect(result.meta.foundVenvs).toBeGreaterThanOrEqual(1);
+        });
+        it("finds multiple venvs in project tree", async () => {
+            await createMockVenv(path.join(tempDir, "project1", ".venv"));
+            await createMockVenv(path.join(tempDir, "project2", "venv"));
+            await createMockVenv(path.join(tempDir, "project3", "env"));
+            const result = await scanEnvPaths({
+                roots: [tempDir],
+                maxDepth: 3,
+                includeUserHomeCache: false,
+            });
+            expect(result.meta.foundVenvs).toBeGreaterThanOrEqual(3);
+        });
+        it("finds venv in standard project locations", async () => {
+            // Test standard venv folder names: .venv, venv, env
+            const projectRoot = path.join(tempDir, "myproject");
+            await fs.mkdir(projectRoot, { recursive: true });
+            const venvPath = path.join(projectRoot, ".venv");
+            await createMockVenv(venvPath);
+            const result = await scanEnvPaths({
+                roots: [projectRoot],
+                maxDepth: 3,
+                includeUserHomeCache: false,
+            });
+            expect(result.pythonPaths.some(p => p.includes(".venv"))).toBe(true);
+        });
+    });
+    describe("scan options", () => {
+        it("respects maxDepth limit", async () => {
+            // Create venv at depth 2
+            await createMockVenv(path.join(tempDir, "level1", ".venv"));
+            // Create venv at depth 4 (should not be found with maxDepth=2)
+            await createMockVenv(path.join(tempDir, "level1", "level2", "level3", ".venv"));
+            const result = await scanEnvPaths({
+                roots: [tempDir],
+                maxDepth: 2,
+                includeUserHomeCache: false,
+            });
+            // Should find shallow venv but not deeply nested one
+            const foundPaths = result.pythonPaths.filter(p => p.includes(tempDir));
+            expect(foundPaths.length).toBe(1);
+        });
+        it("ignores hidden directories by default", async () => {
+            await createMockVenv(path.join(tempDir, ".hidden", "venv"));
+            await createMockVenv(path.join(tempDir, "visible", "venv"));
+            const result = await scanEnvPaths({
+                roots: [tempDir],
+                maxDepth: 3,
+                includeHidden: false,
+                includeUserHomeCache: false,
+            });
+            const foundPaths = result.pythonPaths.filter(p => p.includes(tempDir));
+            expect(foundPaths.some(p => p.includes(".hidden"))).toBe(false);
+            expect(foundPaths.some(p => p.includes("visible"))).toBe(true);
+        });
+        it("includes hidden directories when flag is set", async () => {
+            await createMockVenv(path.join(tempDir, ".hidden", "venv"));
+            const result = await scanEnvPaths({
+                roots: [tempDir],
+                maxDepth: 3,
+                includeHidden: true,
+                includeUserHomeCache: false,
+            });
+            const foundPaths = result.pythonPaths.filter(p => p.includes(tempDir));
+            expect(foundPaths.some(p => p.includes(".hidden"))).toBe(true);
+        });
+        it("deduplicates paths by default", async () => {
+            const venvPath = path.join(tempDir, "project", ".venv");
+            await createMockVenv(venvPath);
+            // Scan same root twice
+            const result = await scanEnvPaths({
+                roots: [path.join(tempDir, "project"), path.join(tempDir, "project")],
+                maxDepth: 3,
+                dedupe: true,
+                includeUserHomeCache: false,
+            });
+            const foundPaths = result.pythonPaths.filter(p => p.includes(tempDir));
+            // Should only have one entry despite scanning same location twice
+            expect(new Set(foundPaths).size).toBe(foundPaths.length);
+        });
+    });
+    describe("handling edge cases", () => {
+        it("handles empty directory", async () => {
+            const emptyDir = path.join(tempDir, "empty");
+            await fs.mkdir(emptyDir, { recursive: true });
+            const result = await scanEnvPaths({
+                roots: [emptyDir],
+                maxDepth: 3,
+                includeUserHomeCache: false,
+            });
+            const foundInTemp = result.pythonPaths.filter(p => p.includes(tempDir));
+            expect(foundInTemp.length).toBe(0);
+        });
+        it("handles permission errors gracefully", async () => {
+            // This test might behave differently on Windows vs POSIX
+            // The key is that it doesn't throw
+            const result = await scanEnvPaths({
+                roots: ["/nonexistent/path/that/should/not/exist"],
+                maxDepth: 3,
+                includeUserHomeCache: false,
+            });
+            expect(result).toBeDefined();
+            expect(result.pythonPaths).toBeDefined();
+        });
+        it("skips node_modules directory", async () => {
+            // Create a venv inside node_modules (should be skipped)
+            await createMockVenv(path.join(tempDir, "node_modules", "some-pkg", ".venv"));
+            await createMockVenv(path.join(tempDir, "src", ".venv"));
+            const result = await scanEnvPaths({
+                roots: [tempDir],
+                maxDepth: 5,
+                includeUserHomeCache: false,
+            });
+            const foundPaths = result.pythonPaths.filter(p => p.includes(tempDir));
+            expect(foundPaths.some(p => p.includes("node_modules"))).toBe(false);
+            expect(foundPaths.some(p => p.includes("src"))).toBe(true);
+        });
+        it("skips .git directory", async () => {
+            await createMockVenv(path.join(tempDir, ".git", "hooks", ".venv"));
+            await createMockVenv(path.join(tempDir, "app", ".venv"));
+            const result = await scanEnvPaths({
+                roots: [tempDir],
+                maxDepth: 5,
+                includeHidden: true, // Even with hidden enabled, .git should be skipped
+                includeUserHomeCache: false,
+            });
+            const foundPaths = result.pythonPaths.filter(p => p.includes(tempDir));
+            expect(foundPaths.some(p => p.includes(".git"))).toBe(false);
+        });
+        it("handles venv without python executable", async () => {
+            // Create pyvenv.cfg but no python executable
+            const venvPath = path.join(tempDir, "broken-venv");
+            await fs.mkdir(venvPath, { recursive: true });
+            await fs.writeFile(path.join(venvPath, "pyvenv.cfg"), "home = C:\\Python311\n");
+            // Deliberately don't create Scripts/python.exe
+            const result = await scanEnvPaths({
+                roots: [tempDir],
+                maxDepth: 3,
+                includeUserHomeCache: false,
+            });
+            // Should not crash, and should not find the broken venv
+            const foundBroken = result.pythonPaths.filter(p => p.includes("broken-venv"));
+            expect(foundBroken.length).toBe(0);
+        });
+    });
+    describe("meta information", () => {
+        it("reports scanned roots in meta", async () => {
+            const root1 = path.join(tempDir, "root1");
+            const root2 = path.join(tempDir, "root2");
+            await fs.mkdir(root1, { recursive: true });
+            await fs.mkdir(root2, { recursive: true });
+            const result = await scanEnvPaths({
+                roots: [root1, root2],
+                maxDepth: 3,
+                includeUserHomeCache: false,
+            });
+            expect(result.meta.scannedRoots).toContain(root1);
+            expect(result.meta.scannedRoots).toContain(root2);
+            expect(result.meta.maxDepth).toBe(3);
+        });
+        it("counts venvs and bases separately", async () => {
+            await createMockVenv(path.join(tempDir, "venv1"));
+            await createMockVenv(path.join(tempDir, "venv2"));
+            const result = await scanEnvPaths({
+                roots: [tempDir],
+                maxDepth: 3,
+                includeUserHomeCache: false,
+            });
+            expect(result.meta.foundVenvs).toBeGreaterThanOrEqual(2);
+            expect(typeof result.meta.foundBases).toBe("number");
+        });
+    });
+    describe("nested environment handling", () => {
+        it("detects venv and does not descend further", async () => {
+            // Create a venv with a nested venv inside (unusual but possible)
+            const outerVenv = path.join(tempDir, "outer-venv");
+            await createMockVenv(outerVenv);
+            // Create another venv inside (should not be found because we stop at outer venv)
+            const innerVenv = path.join(outerVenv, "nested", "inner-venv");
+            await createMockVenv(innerVenv);
+            const result = await scanEnvPaths({
+                roots: [tempDir],
+                maxDepth: 10,
+                includeUserHomeCache: false,
+            });
+            const foundPaths = result.pythonPaths.filter(p => p.includes(tempDir));
+            const foundOuter = foundPaths.filter(p => p.includes("outer-venv") && !p.includes("inner-venv"));
+            const foundInner = foundPaths.filter(p => p.includes("inner-venv"));
+            // Should find outer venv
+            expect(foundOuter.length).toBe(1);
+            // Should NOT find inner venv (scan stops at venv boundary)
+            expect(foundInner.length).toBe(0);
+        });
+    });
+    describe("large directory trees", () => {
+        it("handles directory with many subdirectories", async () => {
+            // Create many directories to test performance doesn't degrade badly
+            for (let i = 0; i < 20; i++) {
+                await fs.mkdir(path.join(tempDir, `dir${i}`), { recursive: true });
+            }
+            await createMockVenv(path.join(tempDir, "dir10", ".venv"));
+            const start = Date.now();
+            const result = await scanEnvPaths({
+                roots: [tempDir],
+                maxDepth: 3,
+                includeUserHomeCache: false,
+            });
+            const elapsed = Date.now() - start;
+            expect(result.meta.foundVenvs).toBeGreaterThanOrEqual(1);
+            // Should complete in reasonable time (less than 5 seconds)
+            expect(elapsed).toBeLessThan(5000);
+        });
+    });
+});
+//# sourceMappingURL=scanEnvPaths.test.js.map

package/dist/scanEnvPaths.test.js.map

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

package/dist/taskCluster.d.ts

@@ -0,0 +1,62 @@
+import type { RunLogEventV1 } from "./runLog.js";
+export type TaskSignature = {
+    sigId: string;
+    name: string;
+    command: string;
+    requirementsKey: string;
+};
+export type TaskCluster = {
+    sig: TaskSignature;
+    runs: number;
+    ok: number;
+    fail: number;
+    successRate: number;
+    lastAt: string;
+    dominantFailure?: string;
+    failureCounts: Record<string, number>;
+    envCounts: Record<string, number>;
+    envFailCounts: Record<string, number>;
+    envOkCounts: Record<string, number>;
+};
+/**
+ * Extract a stable signature from a run event.
+ * Runs with the same signature are clustered together.
+ */
+export declare function signatureForRun(run: RunLogEventV1): TaskSignature;
+/**
+ * Cluster runs by task signature.
+ * Returns clusters sorted by run count (descending).
+ */
+export declare function clusterRuns(runs: RunLogEventV1[]): TaskCluster[];
+/**
+ * Determine if a task cluster is flaky.
+ * Flaky = both succeeds and fails, with success rate not extreme.
+ */
+export declare function isFlaky(cluster: TaskCluster): boolean;
+/**
+ * Determine if a task cluster is env-dependent flaky.
+ * This means it succeeds on some envs and fails on others.
+ */
+export declare function isEnvDependentFlaky(cluster: TaskCluster): boolean;
+/**
+ * Get the envs where this task fails most.
+ */
+export declare function getFailingEnvs(cluster: TaskCluster, limit?: number): Array<{
+    pythonPath: string;
+    failCount: number;
+    totalCount: number;
+    failRate: number;
+}>;
+/**
+ * Get summary statistics for a set of clusters.
+ */
+export declare function summarizeClusters(clusters: TaskCluster[]): {
+    totalTasks: number;
+    totalRuns: number;
+    totalOk: number;
+    totalFail: number;
+    overallSuccessRate: number;
+    flakyCount: number;
+    envDependentFlakyCount: number;
+};
+//# sourceMappingURL=taskCluster.d.ts.map

package/dist/taskCluster.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"taskCluster.d.ts","sourceRoot":"","sources":["../taskCluster.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,GAAG,EAAE,aAAa,CAAC;IAEnB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IAEf,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEtC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrC,CAAC;AA6BF;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,aAAa,GAAG,aAAa,CAMjE;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,aAAa,EAAE,GAAG,WAAW,EAAE,CAuDhE;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAKrD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAejE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,WAAW,EACpB,KAAK,SAAI,GACR,KAAK,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAUxF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG;IAC1D,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,sBAAsB,EAAE,MAAM,CAAC;CAChC,CAwBA"}

package/dist/taskCluster.js

@@ -0,0 +1,180 @@
+// taskCluster.ts
+//
+// Cluster task runs by signature for aggregated visualization.
+// Instead of 500 task nodes, you get one node per task signature, with:
+// - run count
+// - success rate
+// - last run timestamp
+// - dominant failure code
+// - top envs it routes to
+//
+// Also provides flake detection: a task is flaky if it fails on some envs
+// but succeeds on others (or alternates over time).
+import { createHash } from "node:crypto";
+function sha16(s) {
+    return createHash("sha256").update(s).digest("hex").slice(0, 16);
+}
+function normCmd(cmd) {
+    return cmd.trim().replace(/\s+/g, " ").toLowerCase();
+}
+function normReq(req) {
+    if (!req)
+        return "";
+    const pkgs = (req.packages ?? [])
+        .map((p) => p.toLowerCase())
+        .sort()
+        .join(",");
+    const feats = (req.features ?? [])
+        .map((f) => f.toLowerCase())
+        .sort()
+        .join(",");
+    const tags = (req.tags ?? [])
+        .map((t) => t.toLowerCase())
+        .sort()
+        .join(",");
+    const py = (req.python ?? "").toLowerCase();
+    const x64 = req.requireX64 ? "x64" : "";
+    return `py=${py}|pkgs=${pkgs}|feat=${feats}|tags=${tags}|${x64}`;
+}
+/**
+ * Extract a stable signature from a run event.
+ * Runs with the same signature are clustered together.
+ */
+export function signatureForRun(run) {
+    const command = normCmd(run.task.command);
+    const requirementsKey = normReq(run.task.requirements);
+    const base = `${run.task.name}|${command}|${requirementsKey}`;
+    const sigId = `task_${sha16(base)}`;
+    return { sigId, name: run.task.name, command, requirementsKey };
+}
+/**
+ * Cluster runs by task signature.
+ * Returns clusters sorted by run count (descending).
+ */
+export function clusterRuns(runs) {
+    const map = new Map();
+    for (const r of runs) {
+        const sig = signatureForRun(r);
+        const key = sig.sigId;
+        let c = map.get(key);
+        if (!c) {
+            c = {
+                sig,
+                runs: 0,
+                ok: 0,
+                fail: 0,
+                successRate: 0,
+                lastAt: r.at,
+                failureCounts: {},
+                envCounts: {},
+                envFailCounts: {},
+                envOkCounts: {},
+            };
+            map.set(key, c);
+        }
+        c.runs += 1;
+        if (r.outcome.ok)
+            c.ok += 1;
+        else
+            c.fail += 1;
+        if (r.at > c.lastAt)
+            c.lastAt = r.at;
+        const py = r.selected.pythonPath;
+        c.envCounts[py] = (c.envCounts[py] ?? 0) + 1;
+        if (r.outcome.ok) {
+            c.envOkCounts[py] = (c.envOkCounts[py] ?? 0) + 1;
+        }
+        else {
+            const code = r.doctor?.dominantIssue ?? r.outcome.errorClass ?? "RUN_FAILED";
+            c.failureCounts[code] = (c.failureCounts[code] ?? 0) + 1;
+            c.envFailCounts[py] = (c.envFailCounts[py] ?? 0) + 1;
+        }
+    }
+    // Compute derived fields
+    for (const c of map.values()) {
+        c.successRate = c.runs ? c.ok / c.runs : 0;
+        // Find dominant failure code
+        let best = null;
+        for (const [code, count] of Object.entries(c.failureCounts)) {
+            if (!best || count > best.count)
+                best = { code, count };
+        }
+        if (best)
+            c.dominantFailure = best.code;
+    }
+    return [...map.values()].sort((a, b) => b.runs - a.runs);
+}
+/**
+ * Determine if a task cluster is flaky.
+ * Flaky = both succeeds and fails, with success rate not extreme.
+ */
+export function isFlaky(cluster) {
+    // Needs both successes and failures
+    if (cluster.ok === 0 || cluster.fail === 0)
+        return false;
+    // Success rate between 20% and 95% indicates inconsistent behavior
+    return cluster.successRate > 0.2 && cluster.successRate < 0.95;
+}
+/**
+ * Determine if a task cluster is env-dependent flaky.
+ * This means it succeeds on some envs and fails on others.
+ */
+export function isEnvDependentFlaky(cluster) {
+    const envs = Object.keys(cluster.envCounts);
+    if (envs.length < 2)
+        return false;
+    let hasSuccessEnv = false;
+    let hasFailEnv = false;
+    for (const py of envs) {
+        const ok = cluster.envOkCounts[py] ?? 0;
+        const fail = cluster.envFailCounts[py] ?? 0;
+        if (ok > 0 && fail === 0)
+            hasSuccessEnv = true;
+        if (fail > 0 && ok === 0)
+            hasFailEnv = true;
+    }
+    return hasSuccessEnv && hasFailEnv;
+}
+/**
+ * Get the envs where this task fails most.
+ */
+export function getFailingEnvs(cluster, limit = 3) {
+    return Object.entries(cluster.envFailCounts)
+        .map(([py, failCount]) => ({
+        pythonPath: py,
+        failCount,
+        totalCount: cluster.envCounts[py] ?? failCount,
+        failRate: failCount / (cluster.envCounts[py] ?? failCount),
+    }))
+        .sort((a, b) => b.failCount - a.failCount)
+        .slice(0, limit);
+}
+/**
+ * Get summary statistics for a set of clusters.
+ */
+export function summarizeClusters(clusters) {
+    let totalRuns = 0;
+    let totalOk = 0;
+    let totalFail = 0;
+    let flakyCount = 0;
+    let envDependentFlakyCount = 0;
+    for (const c of clusters) {
+        totalRuns += c.runs;
+        totalOk += c.ok;
+        totalFail += c.fail;
+        if (isFlaky(c))
+            flakyCount++;
+        if (isEnvDependentFlaky(c))
+            envDependentFlakyCount++;
+    }
+    return {
+        totalTasks: clusters.length,
+        totalRuns,
+        totalOk,
+        totalFail,
+        overallSuccessRate: totalRuns ? totalOk / totalRuns : 0,
+        flakyCount,
+        envDependentFlakyCount,
+    };
+}
+//# sourceMappingURL=taskCluster.js.map

package/dist/taskCluster.js.map

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

package/dist/taskCluster.test.d.ts

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

package/dist/taskCluster.test.d.ts.map

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