sverklo 0.2.12 → 0.2.14

package/dist/src/server/tool-overrides.js

@@ -0,0 +1,102 @@
+// Runtime-overridable tool descriptions and enable/disable flags.
+//
+// Power users frequently want to repurpose sverklo tools without forking.
+// The two levers exposed here are:
+//
+//   1. Description overrides via `SVERKLO_TOOL_<NAME>_DESCRIPTION`
+//      Override the description text the agent sees for any tool. Useful
+//      for re-scoping `sverklo_remember` into an architecture-decision log,
+//      or for adding project-specific guidance the model will follow.
+//
+//   2. Disable-list via `SVERKLO_DISABLED_TOOLS`
+//      Comma-separated list of tool names to hide from the `tools/list`
+//      response. Useful when a project doesn't want memory tools exposed,
+//      or when a user wants to shrink the tool surface for a specific
+//      agent that gets overwhelmed by 20 options.
+//
+// Design notes:
+//
+//   - The env var is read once at process startup and cached. Restart the
+//     MCP server to pick up changes — this matches how agents already
+//     expect tool metadata to work (stable per session).
+//   - Description overrides are applied AFTER we copy the tool object, so
+//     the underlying tool definitions stay pristine and unit tests against
+//     them remain stable.
+//   - Name normalisation: SVERKLO_TOOL_SEARCH_DESCRIPTION and
+//     SVERKLO_TOOL_sverklo_search_DESCRIPTION both target `sverklo_search`.
+//     We strip the `sverklo_` prefix before matching, upper-case, and
+//     replace underscores with nothing. This keeps env var names short.
+//
+// Inspired by the Qdrant MCP server's `TOOL_*_DESCRIPTION` pattern.
+let cache = null;
+function normalizeEnvSuffix(name) {
+    // "sverklo_search" -> "SEARCH"
+    // "sverklo_review_diff" -> "REVIEW_DIFF"
+    // "search_code" (compat alias) -> "SEARCH_CODE"
+    const stripped = name.startsWith("sverklo_") ? name.slice("sverklo_".length) : name;
+    return stripped.toUpperCase();
+}
+function buildCache() {
+    const disabled = new Set();
+    const descriptions = new Map();
+    const disabledList = process.env.SVERKLO_DISABLED_TOOLS;
+    if (disabledList) {
+        for (const raw of disabledList.split(",")) {
+            const name = raw.trim();
+            if (name)
+                disabled.add(name);
+        }
+    }
+    // Description overrides. We scan process.env for any key starting with
+    // `SVERKLO_TOOL_` and ending in `_DESCRIPTION`. Everything between is the
+    // normalized tool-name suffix.
+    const prefix = "SVERKLO_TOOL_";
+    const suffix = "_DESCRIPTION";
+    for (const key of Object.keys(process.env)) {
+        if (!key.startsWith(prefix) || !key.endsWith(suffix))
+            continue;
+        const mid = key.slice(prefix.length, key.length - suffix.length);
+        if (!mid)
+            continue;
+        const value = process.env[key];
+        if (typeof value !== "string" || value.length === 0)
+            continue;
+        descriptions.set(mid, value);
+    }
+    return { disabled, descriptions };
+}
+function getCache() {
+    if (!cache)
+        cache = buildCache();
+    return cache;
+}
+/**
+ * Apply env-var overrides to a list of tool definitions. Returns a new
+ * array — never mutates the input. Tools whose names appear in
+ * `SVERKLO_DISABLED_TOOLS` are dropped entirely.
+ */
+export function applyToolOverrides(tools) {
+    const { disabled, descriptions } = getCache();
+    const out = [];
+    for (const tool of tools) {
+        if (disabled.has(tool.name))
+            continue;
+        const suffix = normalizeEnvSuffix(tool.name);
+        const override = descriptions.get(suffix);
+        if (override) {
+            out.push({ ...tool, description: override });
+        }
+        else {
+            out.push(tool);
+        }
+    }
+    return out;
+}
+/**
+ * Test-only: reset the cached env-var parse so unit tests can flip
+ * env vars mid-run and see the change.
+ */
+export function __resetToolOverrideCache() {
+    cache = null;
+}
+//# sourceMappingURL=tool-overrides.js.map

package/dist/src/server/tool-overrides.js.map

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

package/dist/src/server/tool-overrides.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/server/tool-overrides.test.js

@@ -0,0 +1,124 @@
+import { describe, it, expect, beforeEach } from "vitest";
+import { applyToolOverrides, __resetToolOverrideCache } from "./tool-overrides.js";
+// applyToolOverrides ships on every MCP session start and previously
+// had zero test coverage. These tests lock in the env-var override +
+// disable-list contract so a refactor can't silently change how tool
+// visibility or descriptions are controlled.
+const fixture = () => [
+    { name: "sverklo_search", description: "orig search", inputSchema: {} },
+    { name: "sverklo_refs", description: "orig refs", inputSchema: {} },
+    { name: "sverklo_forget", description: "orig forget", inputSchema: {} },
+    { name: "sverklo_remember", description: "orig remember", inputSchema: {} },
+];
+describe("applyToolOverrides — description overrides", () => {
+    beforeEach(() => {
+        // Strip any SVERKLO_TOOL_* env vars from a previous test.
+        for (const key of Object.keys(process.env)) {
+            if (key.startsWith("SVERKLO_TOOL_") || key === "SVERKLO_DISABLED_TOOLS") {
+                delete process.env[key];
+            }
+        }
+        __resetToolOverrideCache();
+    });
+    it("returns tools unchanged when no env vars are set", () => {
+        const result = applyToolOverrides(fixture());
+        expect(result).toHaveLength(4);
+        expect(result.find((t) => t.name === "sverklo_search")?.description).toBe("orig search");
+    });
+    it("overrides a tool description via SVERKLO_TOOL_<NAME>_DESCRIPTION", () => {
+        process.env.SVERKLO_TOOL_SEARCH_DESCRIPTION = "use only for architecture decisions";
+        __resetToolOverrideCache();
+        const result = applyToolOverrides(fixture());
+        expect(result.find((t) => t.name === "sverklo_search")?.description).toBe("use only for architecture decisions");
+        // Other tools unchanged
+        expect(result.find((t) => t.name === "sverklo_refs")?.description).toBe("orig refs");
+    });
+    it("strips sverklo_ prefix when matching env var suffix", () => {
+        // Both SEARCH and REVIEW_DIFF-style names should work.
+        process.env.SVERKLO_TOOL_REMEMBER_DESCRIPTION = "project decision log only";
+        __resetToolOverrideCache();
+        const result = applyToolOverrides(fixture());
+        expect(result.find((t) => t.name === "sverklo_remember")?.description).toBe("project decision log only");
+    });
+    it("handles multi-word tool names (underscore-separated)", () => {
+        const tools = [
+            { name: "sverklo_review_diff", description: "orig", inputSchema: {} },
+        ];
+        process.env.SVERKLO_TOOL_REVIEW_DIFF_DESCRIPTION = "strict review";
+        __resetToolOverrideCache();
+        const result = applyToolOverrides(tools);
+        expect(result[0].description).toBe("strict review");
+    });
+    it("never mutates the input array or its objects", () => {
+        const input = fixture();
+        const inputRef = input[0];
+        const inputDescription = inputRef.description;
+        process.env.SVERKLO_TOOL_SEARCH_DESCRIPTION = "mutated";
+        __resetToolOverrideCache();
+        applyToolOverrides(input);
+        // Source object must be unchanged — overrides return fresh objects.
+        expect(inputRef.description).toBe(inputDescription);
+    });
+    it("ignores empty-string overrides (treats as unset)", () => {
+        process.env.SVERKLO_TOOL_SEARCH_DESCRIPTION = "";
+        __resetToolOverrideCache();
+        const result = applyToolOverrides(fixture());
+        expect(result.find((t) => t.name === "sverklo_search")?.description).toBe("orig search");
+    });
+});
+describe("applyToolOverrides — disable list", () => {
+    beforeEach(() => {
+        for (const key of Object.keys(process.env)) {
+            if (key.startsWith("SVERKLO_TOOL_") || key === "SVERKLO_DISABLED_TOOLS") {
+                delete process.env[key];
+            }
+        }
+        __resetToolOverrideCache();
+    });
+    it("hides a single tool named in SVERKLO_DISABLED_TOOLS", () => {
+        process.env.SVERKLO_DISABLED_TOOLS = "sverklo_forget";
+        __resetToolOverrideCache();
+        const result = applyToolOverrides(fixture());
+        expect(result.map((t) => t.name)).not.toContain("sverklo_forget");
+        expect(result).toHaveLength(3);
+    });
+    it("hides multiple comma-separated tools", () => {
+        process.env.SVERKLO_DISABLED_TOOLS = "sverklo_forget,sverklo_remember";
+        __resetToolOverrideCache();
+        const result = applyToolOverrides(fixture());
+        expect(result.map((t) => t.name)).toEqual(["sverklo_search", "sverklo_refs"]);
+    });
+    it("trims whitespace in the disabled list", () => {
+        process.env.SVERKLO_DISABLED_TOOLS = " sverklo_forget , sverklo_remember ";
+        __resetToolOverrideCache();
+        const result = applyToolOverrides(fixture());
+        expect(result).toHaveLength(2);
+    });
+    it("ignores unknown tool names in the disabled list (no-op)", () => {
+        process.env.SVERKLO_DISABLED_TOOLS = "sverklo_nonexistent,sverklo_search";
+        __resetToolOverrideCache();
+        const result = applyToolOverrides(fixture());
+        expect(result).toHaveLength(3);
+        expect(result.map((t) => t.name)).not.toContain("sverklo_search");
+    });
+});
+describe("applyToolOverrides — combined overrides", () => {
+    beforeEach(() => {
+        for (const key of Object.keys(process.env)) {
+            if (key.startsWith("SVERKLO_TOOL_") || key === "SVERKLO_DISABLED_TOOLS") {
+                delete process.env[key];
+            }
+        }
+        __resetToolOverrideCache();
+    });
+    it("applies description overrides and disable list together", () => {
+        process.env.SVERKLO_TOOL_SEARCH_DESCRIPTION = "custom";
+        process.env.SVERKLO_DISABLED_TOOLS = "sverklo_forget";
+        __resetToolOverrideCache();
+        const result = applyToolOverrides(fixture());
+        expect(result).toHaveLength(3);
+        expect(result.find((t) => t.name === "sverklo_search")?.description).toBe("custom");
+        expect(result.find((t) => t.name === "sverklo_forget")).toBeUndefined();
+    });
+});
+//# sourceMappingURL=tool-overrides.test.js.map

package/dist/src/server/tool-overrides.test.js.map

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

package/dist/src/server/tools/context-budget.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/server/tools/context-budget.test.js

@@ -0,0 +1,150 @@
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { mkdtempSync, rmSync, writeFileSync, mkdirSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { Indexer } from "../../indexer/indexer.js";
+import { getProjectConfig } from "../../utils/config.js";
+import { handleContext } from "./context.js";
+// Tests for the sverklo_context --budget N repo-map mode (issue #8).
+// These lock in the deterministic-ordering contract (same index +
+// same budget = same output), the budget clamping behavior, and the
+// exclude filter. We build a tiny real project so the tests exercise
+// the actual PageRank + chunk iteration, not a mock.
+describe("handleContext (budget mode)", () => {
+    let tmpRoot;
+    let indexer;
+    beforeEach(async () => {
+        tmpRoot = mkdtempSync(join(tmpdir(), "sverklo-context-budget-"));
+        mkdirSync(join(tmpRoot, "src"), { recursive: true });
+        mkdirSync(join(tmpRoot, "test"), { recursive: true });
+        // Seed a few files with different sizes so PageRank has something
+        // to differentiate. The exact rankings don't matter — we only
+        // assert that output is stable and contains expected path markers.
+        writeFileSync(join(tmpRoot, "src", "core.ts"), [
+            "export function load() { return 1; }",
+            "export function save() { return 2; }",
+            "export function reset() { return 3; }",
+        ].join("\n"), "utf-8");
+        writeFileSync(join(tmpRoot, "src", "helpers.ts"), [
+            "import { load } from './core';",
+            "export function helper1() { return load(); }",
+            "export function helper2() { return load(); }",
+        ].join("\n"), "utf-8");
+        writeFileSync(join(tmpRoot, "test", "core.test.ts"), [
+            "export function runTests() { return 'all-green'; }",
+            "export function setupSuite() { return {}; }",
+        ].join("\n"), "utf-8");
+        const cfg = getProjectConfig(tmpRoot);
+        indexer = new Indexer(cfg);
+        await indexer.index();
+    });
+    afterEach(() => {
+        try {
+            indexer.close();
+        }
+        catch { }
+        try {
+            rmSync(tmpRoot, { recursive: true, force: true });
+        }
+        catch { }
+    });
+    it("returns a repo-map-shaped response when budget is set", async () => {
+        const out = await handleContext(indexer, { budget: 2000 });
+        expect(out).toContain("# Repo map");
+        expect(out).toContain("Budget: 2000 tokens");
+        expect(out).toContain("PageRank");
+    });
+    it("produces identical output for identical inputs (determinism contract)", async () => {
+        const a = await handleContext(indexer, { budget: 2000 });
+        const b = await handleContext(indexer, { budget: 2000 });
+        expect(a).toBe(b);
+    });
+    it("works without a task (pure PageRank ordering)", async () => {
+        const out = await handleContext(indexer, { budget: 2000 });
+        expect(out).not.toContain("centered on");
+        expect(out).toContain("PageRank");
+    });
+    it("accepts a task parameter and advertises the bias in the header", async () => {
+        const out = await handleContext(indexer, {
+            budget: 2000,
+            task: "understand loading logic",
+        });
+        expect(out).toContain("centered on: understand loading logic");
+        expect(out).toContain("task relevance");
+    });
+    it("respects the exclude filter", async () => {
+        const withTests = await handleContext(indexer, { budget: 4000, exclude: [] });
+        const withoutTests = await handleContext(indexer, {
+            budget: 4000,
+            exclude: ["test"],
+        });
+        // The test file should appear in the unfiltered version but not
+        // in the filtered one.
+        expect(withTests).toContain("core.test.ts");
+        expect(withoutTests).not.toContain("core.test.ts");
+    });
+    it("clamps budgets above the max and emits a warning line", async () => {
+        const out = await handleContext(indexer, { budget: 100_000 });
+        expect(out).toContain("clamped");
+        // The stated budget in the header should be the clamp ceiling,
+        // not the original request.
+        expect(out).toContain("32000");
+    });
+    it("rejects budgets below the minimum with a helpful message", async () => {
+        const out = await handleContext(indexer, { budget: 100 });
+        expect(out).toContain("Budget too small");
+        expect(out).toContain("Minimum");
+    });
+    it("scope filter restricts the map to matching paths", async () => {
+        const out = await handleContext(indexer, { budget: 2000, scope: "src/" });
+        expect(out).toContain("src/");
+        expect(out).not.toContain("test/core.test.ts");
+    });
+    it("reports a footer with rendered count and remaining-files hint", async () => {
+        const out = await handleContext(indexer, { budget: 2000 });
+        // "Rendered N of M files" footer is always present when the mode
+        // ran to completion.
+        expect(out).toMatch(/Rendered \d+ of \d+ files/);
+    });
+    it("falls back gracefully when task search fails internally", async () => {
+        // Even if search blows up, the map must still render in pure
+        // PageRank mode rather than returning an error. We can't easily
+        // force hybridSearch to throw here without monkey-patching, so
+        // we assert the contract indirectly: a task with zero meaningful
+        // matches should still produce a valid map.
+        const out = await handleContext(indexer, {
+            budget: 2000,
+            task: "zzzzz totally unrelated gibberish query",
+        });
+        expect(out).toContain("# Repo map");
+        expect(out).toMatch(/Rendered \d+ of \d+ files/);
+    });
+});
+// Separate suite: error / missing-task behavior when budget is NOT set.
+describe("handleContext (non-budget mode)", () => {
+    let tmpRoot;
+    let indexer;
+    beforeEach(async () => {
+        tmpRoot = mkdtempSync(join(tmpdir(), "sverklo-context-nobudget-"));
+        mkdirSync(join(tmpRoot, "src"), { recursive: true });
+        writeFileSync(join(tmpRoot, "src", "a.ts"), "export const a = 1;\n", "utf-8");
+        const cfg = getProjectConfig(tmpRoot);
+        indexer = new Indexer(cfg);
+        await indexer.index();
+    });
+    afterEach(() => {
+        try {
+            indexer.close();
+        }
+        catch { }
+        try {
+            rmSync(tmpRoot, { recursive: true, force: true });
+        }
+        catch { }
+    });
+    it("still requires a task when budget is not set", async () => {
+        const out = await handleContext(indexer, {});
+        expect(out).toContain("required");
+    });
+});
+//# sourceMappingURL=context-budget.test.js.map

package/dist/src/server/tools/context-budget.test.js.map

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

package/dist/src/server/tools/context.d.ts

@@ -18,8 +18,18 @@ export declare const contextTool: {
                 type: string;
                 description: string;
             };
+            budget: {
+                type: string;
+                description: string;
+            };
+            exclude: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
         };
-        required: string[];
     };
 };
 export declare function handleContext(indexer: Indexer, args: Record<string, unknown>): Promise<string>;