@towry/mcp 0.1.7 → 0.3.0

package/dist/checkpoints.test.js

@@ -0,0 +1,277 @@
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import * as fs from "node:fs";
+import * as path from "node:path";
+import * as os from "node:os";
+// Import internal functions for testing
+// We need to export them or test via the public API
+// For now, test the core logic via file operations
+const TEST_DIR = path.join(os.tmpdir(), "mcp-checkpoints-test");
+// Helper to create test checkpoint file
+function createTestCheckpointFile(branch, checkpoints) {
+    const dir = path.join(TEST_DIR, ".agents", "checkpoints");
+    fs.mkdirSync(dir, { recursive: true });
+    const safeBranch = branch.replace(/\//g, "_");
+    const filePath = path.join(dir, `${safeBranch}.jsonl`);
+    const lines = checkpoints.map((cp) => JSON.stringify(cp)).join("\n");
+    fs.writeFileSync(filePath, lines + "\n", "utf-8");
+    return filePath;
+}
+function readTestCheckpoints(branch) {
+    const dir = path.join(TEST_DIR, ".agents", "checkpoints");
+    const safeBranch = branch.replace(/\//g, "_");
+    const filePath = path.join(dir, `${safeBranch}.jsonl`);
+    if (!fs.existsSync(filePath))
+        return [];
+    const content = fs.readFileSync(filePath, "utf-8");
+    return content
+        .trim()
+        .split("\n")
+        .filter(Boolean)
+        .map((line) => JSON.parse(line));
+}
+// Recreate time filtering logic for testing
+function filterByTime(checkpoints, since, until) {
+    return checkpoints.filter((cp) => {
+        const ts = new Date(cp.timestamp);
+        if (since && ts < since)
+            return false;
+        if (until && ts > until)
+            return false;
+        return true;
+    });
+}
+function parseRelativeTime(alias) {
+    const aliases = {
+        today: () => {
+            const d = new Date();
+            d.setHours(0, 0, 0, 0);
+            return d;
+        },
+        yesterday: () => {
+            const d = new Date();
+            d.setDate(d.getDate() - 1);
+            d.setHours(0, 0, 0, 0);
+            return d;
+        },
+        last_1h: () => new Date(Date.now() - 60 * 60 * 1000),
+        last_24h: () => new Date(Date.now() - 24 * 60 * 60 * 1000),
+        last_7d: () => new Date(Date.now() - 7 * 24 * 60 * 60 * 1000),
+        last_30d: () => new Date(Date.now() - 30 * 24 * 60 * 60 * 1000),
+    };
+    const fn = aliases[alias.toLowerCase()];
+    return fn ? fn() : null;
+}
+function filterByQuery(checkpoints, query) {
+    const q = query.toLowerCase();
+    return checkpoints.filter((cp) => {
+        if (cp.task.toLowerCase().includes(q))
+            return true;
+        if (cp.summary.toLowerCase().includes(q))
+            return true;
+        if (cp.tags?.some((t) => t.toLowerCase().includes(q)))
+            return true;
+        if (cp.references?.some((r) => r.title.toLowerCase().includes(q) || r.ref.toLowerCase().includes(q))) {
+            return true;
+        }
+        return false;
+    });
+}
+describe("checkpoints", () => {
+    beforeEach(() => {
+        fs.rmSync(TEST_DIR, { recursive: true, force: true });
+        fs.mkdirSync(TEST_DIR, { recursive: true });
+    });
+    afterEach(() => {
+        fs.rmSync(TEST_DIR, { recursive: true, force: true });
+    });
+    describe("record checkpoint", () => {
+        it("writes checkpoint to branch-scoped JSONL file", () => {
+            const checkpoint = {
+                timestamp: new Date().toISOString(),
+                branch: "feature/test",
+                task: "implement feature",
+                summary: "Added new checkpoint tools",
+            };
+            createTestCheckpointFile("feature/test", [checkpoint]);
+            const records = readTestCheckpoints("feature/test");
+            expect(records).toHaveLength(1);
+            expect(records[0]).toMatchObject({
+                branch: "feature/test",
+                task: "implement feature",
+            });
+        });
+        it("appends multiple checkpoints to same file", () => {
+            const cp1 = { timestamp: "2026-03-12T10:00:00Z", branch: "main", task: "task 1", summary: "s1" };
+            const cp2 = { timestamp: "2026-03-12T11:00:00Z", branch: "main", task: "task 2", summary: "s2" };
+            createTestCheckpointFile("main", [cp1, cp2]);
+            const records = readTestCheckpoints("main");
+            expect(records).toHaveLength(2);
+        });
+    });
+    describe("branch file isolation", () => {
+        it("stores checkpoints in separate files per branch", () => {
+            const mainCp = { timestamp: "2026-03-12T10:00:00Z", branch: "main", task: "main task", summary: "s" };
+            const featureCp = {
+                timestamp: "2026-03-12T11:00:00Z",
+                branch: "feature/x",
+                task: "feature task",
+                summary: "s",
+            };
+            createTestCheckpointFile("main", [mainCp]);
+            createTestCheckpointFile("feature/x", [featureCp]);
+            expect(readTestCheckpoints("main")).toHaveLength(1);
+            expect(readTestCheckpoints("feature/x")).toHaveLength(1);
+        });
+        it("sanitizes branch names with slashes", () => {
+            const dir = path.join(TEST_DIR, ".agents", "checkpoints");
+            fs.mkdirSync(dir, { recursive: true });
+            const branch = "feature/awesome-thing";
+            const safeName = branch.replace(/\//g, "_");
+            const filePath = path.join(dir, `${safeName}.jsonl`);
+            fs.writeFileSync(filePath, '{"test": true}\n', "utf-8");
+            expect(fs.existsSync(filePath)).toBe(true);
+            expect(safeName).toBe("feature_awesome-thing");
+        });
+    });
+    describe("ISO time filtering", () => {
+        it("filters by since date", () => {
+            const checkpoints = [
+                { timestamp: "2026-03-10T10:00:00Z" },
+                { timestamp: "2026-03-12T10:00:00Z" },
+                { timestamp: "2026-03-14T10:00:00Z" },
+            ];
+            const since = new Date("2026-03-11T00:00:00Z");
+            const filtered = filterByTime(checkpoints, since, undefined);
+            expect(filtered).toHaveLength(2);
+        });
+        it("filters by until date", () => {
+            const checkpoints = [
+                { timestamp: "2026-03-10T10:00:00Z" },
+                { timestamp: "2026-03-12T10:00:00Z" },
+                { timestamp: "2026-03-14T10:00:00Z" },
+            ];
+            const until = new Date("2026-03-13T00:00:00Z");
+            const filtered = filterByTime(checkpoints, undefined, until);
+            expect(filtered).toHaveLength(2);
+        });
+        it("filters by date range", () => {
+            const checkpoints = [
+                { timestamp: "2026-03-10T10:00:00Z" },
+                { timestamp: "2026-03-12T10:00:00Z" },
+                { timestamp: "2026-03-14T10:00:00Z" },
+            ];
+            const since = new Date("2026-03-11T00:00:00Z");
+            const until = new Date("2026-03-13T00:00:00Z");
+            const filtered = filterByTime(checkpoints, since, until);
+            expect(filtered).toHaveLength(1);
+        });
+    });
+    describe("relativeTime alias filtering", () => {
+        it("parses 'today' as start of current day", () => {
+            const today = parseRelativeTime("today");
+            expect(today).not.toBeNull();
+            expect(today.getHours()).toBe(0);
+            expect(today.getMinutes()).toBe(0);
+            expect(today.getSeconds()).toBe(0);
+        });
+        it("parses 'yesterday' as start of previous day", () => {
+            const yesterday = parseRelativeTime("yesterday");
+            const today = parseRelativeTime("today");
+            expect(yesterday).not.toBeNull();
+            const diffMs = today.getTime() - yesterday.getTime();
+            expect(diffMs).toBe(24 * 60 * 60 * 1000);
+        });
+        it("parses 'last_1h' as 1 hour ago", () => {
+            const last1h = parseRelativeTime("last_1h");
+            expect(last1h).not.toBeNull();
+            const diffMs = Date.now() - last1h.getTime();
+            expect(diffMs).toBeGreaterThanOrEqual(60 * 60 * 1000 - 1000);
+            expect(diffMs).toBeLessThanOrEqual(60 * 60 * 1000 + 1000);
+        });
+        it("parses 'last_7d' as 7 days ago", () => {
+            const last7d = parseRelativeTime("last_7d");
+            expect(last7d).not.toBeNull();
+            const diffMs = Date.now() - last7d.getTime();
+            expect(diffMs).toBeGreaterThanOrEqual(7 * 24 * 60 * 60 * 1000 - 1000);
+        });
+        it("filters checkpoints using relative time", () => {
+            const now = new Date();
+            const oneHourAgo = new Date(now.getTime() - 30 * 60 * 1000); // 30 min ago
+            const twoHoursAgo = new Date(now.getTime() - 2 * 60 * 60 * 1000);
+            const checkpoints = [
+                { timestamp: twoHoursAgo.toISOString() },
+                { timestamp: oneHourAgo.toISOString() },
+            ];
+            const since = parseRelativeTime("last_1h");
+            const filtered = filterByTime(checkpoints, since, undefined);
+            expect(filtered).toHaveLength(1);
+        });
+    });
+    describe("keyword matching", () => {
+        it("matches query in task", () => {
+            const checkpoints = [
+                { task: "implement login", summary: "s1", tags: [] },
+                { task: "fix logout", summary: "s2", tags: [] },
+            ];
+            const filtered = filterByQuery(checkpoints, "login");
+            expect(filtered).toHaveLength(1);
+        });
+        it("matches query in summary", () => {
+            const checkpoints = [
+                { task: "t1", summary: "added authentication flow", tags: [] },
+                { task: "t2", summary: "fixed styling", tags: [] },
+            ];
+            const filtered = filterByQuery(checkpoints, "authentication");
+            expect(filtered).toHaveLength(1);
+        });
+        it("matches query in tags", () => {
+            const checkpoints = [
+                { task: "t1", summary: "s1", tags: ["mcp", "checkpoint"] },
+                { task: "t2", summary: "s2", tags: ["test"] },
+            ];
+            const filtered = filterByQuery(checkpoints, "mcp");
+            expect(filtered).toHaveLength(1);
+        });
+        it("matches query in references title", () => {
+            const checkpoints = [
+                {
+                    task: "t1",
+                    summary: "s1",
+                    references: [{ kind: "file", title: "MCP Server Docs", ref: "docs/mcp.md" }],
+                },
+                { task: "t2", summary: "s2" },
+            ];
+            const filtered = filterByQuery(checkpoints, "server");
+            expect(filtered).toHaveLength(1);
+        });
+        it("matches query in references ref", () => {
+            const checkpoints = [
+                {
+                    task: "t1",
+                    summary: "s1",
+                    references: [{ kind: "url", title: "API", ref: "https://example.com/api/auth" }],
+                },
+                { task: "t2", summary: "s2" },
+            ];
+            const filtered = filterByQuery(checkpoints, "auth");
+            expect(filtered).toHaveLength(1);
+        });
+        it("is case-insensitive", () => {
+            const checkpoints = [{ task: "Implement LOGIN", summary: "S", tags: [] }];
+            const filtered = filterByQuery(checkpoints, "login");
+            expect(filtered).toHaveLength(1);
+        });
+    });
+    describe("non-git directory fallback", () => {
+        it("uses 'default' branch name when not in git repo", () => {
+            // Non-git directory would return 'default' from getCurrentBranch
+            // We test that the file path is correctly generated
+            const branch = "default";
+            const filePath = path.join(TEST_DIR, ".agents", "checkpoints", `${branch}.jsonl`);
+            fs.mkdirSync(path.dirname(filePath), { recursive: true });
+            fs.writeFileSync(filePath, '{"test": true}\n', "utf-8");
+            expect(fs.existsSync(filePath)).toBe(true);
+        });
+    });
+});
+//# sourceMappingURL=checkpoints.test.js.map

package/dist/checkpoints.test.js.map

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

package/dist/checkpoints.validation.test.d.ts

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

package/dist/checkpoints.validation.test.d.ts.map

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

package/dist/checkpoints.validation.test.js

@@ -0,0 +1,28 @@
+import { describe, it, expect } from "vitest";
+import { countSentences, SummarySchema } from "./checkpoints.js";
+describe("checkpoints summary validation", () => {
+    describe("countSentences", () => {
+        it("counts punctuation-delimited sentences", () => {
+            expect(countSentences("First sentence. Second sentence!")).toBe(2);
+            expect(countSentences("One. Two? Three! Four.")).toBe(4);
+        });
+        it("treats text without terminal punctuation as one sentence", () => {
+            expect(countSentences("Single sentence without punctuation")).toBe(1);
+        });
+    });
+    describe("SummarySchema", () => {
+        it("accepts 2-4 sentences", () => {
+            expect(SummarySchema.safeParse("Did setup. Added tests.").success).toBe(true);
+            expect(SummarySchema.safeParse("A. B. C. D.").success).toBe(true);
+        });
+        it("rejects fewer than 2 sentences", () => {
+            const result = SummarySchema.safeParse("Only one sentence.");
+            expect(result.success).toBe(false);
+        });
+        it("rejects more than 4 sentences", () => {
+            const result = SummarySchema.safeParse("A. B. C. D. E.");
+            expect(result.success).toBe(false);
+        });
+    });
+});
+//# sourceMappingURL=checkpoints.validation.test.js.map

package/dist/checkpoints.validation.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoints.validation.test.js","sourceRoot":"","sources":["../src/checkpoints.validation.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjE,QAAQ,CAAC,gCAAgC,EAAE,GAAG,EAAE;IAC9C,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;QAC9B,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;YAChD,MAAM,CAAC,cAAc,CAAC,kCAAkC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACnE,MAAM,CAAC,cAAc,CAAC,wBAAwB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC3D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,0DAA0D,EAAE,GAAG,EAAE;YAClE,MAAM,CAAC,cAAc,CAAC,qCAAqC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACxE,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;QAC7B,EAAE,CAAC,uBAAuB,EAAE,GAAG,EAAE;YAC/B,MAAM,CAAC,aAAa,CAAC,SAAS,CAAC,yBAAyB,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC9E,MAAM,CAAC,aAAa,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;YACxC,MAAM,MAAM,GAAG,aAAa,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAC;YAC7D,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;YACvC,MAAM,MAAM,GAAG,aAAa,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;YACzD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/index.d.ts

@@ -1,16 +1,11 @@
 #!/usr/bin/env node
 /**
- * @towry/mcp - Knowledge Graph & Tmux MCP Server
+ * @towry/mcp - Grep MCP Server
  *
  * Provides tools for:
- * - Document management in a knowledge graph
- * - Tmux pane management and control
+ * - Fast grep-based code search
  *
- * Environment Variables:
- * - KG_API_URL: API base URL (default: http://localhost:8361)
- * - KG_API_KEY or KG_API_TOKEN: API authentication key
- *
- * Keywords: mcp, knowledge-graph, document-management, tmux, ai-tools, llm-server
+ * Keywords: mcp, grep, ai-tools, llm-server
  */
 export {};
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;GAYG"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;GAOG"}